From 9ff6a34edaecda2a36d0e157c582ed0bf35caa76 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Thu, 3 May 2012 14:30:40 +0200 Subject: [PATCH 0001/3075] Pushing uncommitted footprint --- contribute/bug-reporting-guide.md | 4 ++ contribute/git-guide.md | 4 ++ contribute/index.md | 70 +++++++++++++++++++++++++++++++ contribute/partest-guide.md | 4 ++ contribute/workflow.md | 4 ++ 5 files changed, 86 insertions(+) create mode 100644 contribute/bug-reporting-guide.md create mode 100644 contribute/git-guide.md create mode 100644 contribute/index.md create mode 100644 contribute/partest-guide.md create mode 100644 contribute/workflow.md diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md new file mode 100644 index 0000000000..33640bcd47 --- /dev/null +++ b/contribute/bug-reporting-guide.md @@ -0,0 +1,4 @@ +--- +layout: page +title: Bug Reporting +--- \ No newline at end of file diff --git a/contribute/git-guide.md b/contribute/git-guide.md new file mode 100644 index 0000000000..a66fb33190 --- /dev/null +++ b/contribute/git-guide.md @@ -0,0 +1,4 @@ +--- +layout: page +title: Using git +--- \ No newline at end of file diff --git a/contribute/index.md b/contribute/index.md new file mode 100644 index 0000000000..b11a73bcbf --- /dev/null +++ b/contribute/index.md @@ -0,0 +1,70 @@ +--- +layout: page +title: Contribute +--- + +- This page should contain the introduction as mentioned in the Scala Doc team google document +- Subpages or subsections for contributing for each project (i.e. how to find tickets/features to work on) +- Building and contributing code (contributor's workflow) + - link to a proper git etiquette page + - link to CLA + - how to run and use partest + - compiler page (links to compiler-related docs i.e. reflection/macros/compiler-plugin guides, links to compiler internal videos, and useful info from wiki) (or should this go on docs.scala-lang?) +- Link to how to make a bug report + +The Scala programming langauge is an open source project from École +Polytechnique Fédérale de Lausanne (EPFL) in Switzerland. The source of the +compiler and libraries is hosted on [github](http://github.com/scala/scala). + +Some aspects of the language are easier to contribute to than others-- the +compiler, for example, is arguably the most difficult part of the Scala +project to successfully submit patches to. + +If you're interested in joining our community and contributing to the project, +start simple-- often Scaladoc (Scala's javadoc-like tool, Example: [Scala +Standard Library API](www.scala-lang.org/api/current/index.html#package)) is +the best place to get started. + + + EPFL Typesafe Stack + _______________ ___________ + | | | | + | stdlib | | Akka | + | compiler | | Play! | + | scaladoc | | SBT | + | documentation | | .... | + |_______________| |___________| + + +## Testing + +Partest how-tos. + +### Lukas's new build machine + +Link, needs repo name and github username and builds/tests for you. + +## Community tickets + +- for scaladoc +- for the stdlib +- for the compiler +- for the doc site + +## Process + +"gitting stuff done" document. + +Where to ask questions. How-tos to mailing list, discussion pertaining to a +specific ticket on the issue tracker. + +## CLA + +## FAQ + +### OSX + +### Linux + +### Windows + diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md new file mode 100644 index 0000000000..1b3c098cca --- /dev/null +++ b/contribute/partest-guide.md @@ -0,0 +1,4 @@ +--- +layout: page +title: Running the Test Suite +--- \ No newline at end of file diff --git a/contribute/workflow.md b/contribute/workflow.md new file mode 100644 index 0000000000..89c71102a9 --- /dev/null +++ b/contribute/workflow.md @@ -0,0 +1,4 @@ +--- +layout: page +title: Contributor's Workflow +--- \ No newline at end of file From fc99948bd01ccad7310366e17a16d3a75b4a3c94 Mon Sep 17 00:00:00 2001 From: ingoem Date: Thu, 27 Sep 2012 11:45:57 +0200 Subject: [PATCH 0002/3075] Some work on the contribute section --- contribute/git-guide.md | 76 ++++++++++++++++++++++++++++++++++++++++- contribute/index.md | 61 +++++++++++++++++++++++++++++---- 2 files changed, 130 insertions(+), 7 deletions(-) diff --git a/contribute/git-guide.md b/contribute/git-guide.md index a66fb33190..2e173ec7ec 100644 --- a/contribute/git-guide.md +++ b/contribute/git-guide.md @@ -1,4 +1,78 @@ --- layout: page title: Using git ---- \ No newline at end of file +--- + +This is a step-by-step guide on how to use [git](http://git-scm.com/) and [github](http://github.com/) if you want to contribute to the Scala project. If you are new to git, make yourself familiar first. We recommend the [Git Pro]()http://git-scm.com/book/en/) online book. + +### Signup + +First create an account on [github](http://github.com/). You can also use your existing account, of course. + +### Fork + +Now, go to [https://github.com/scala/scala]() and click the "Fork" button at the top of the page. + +![image](images/fork.png) + +If everything went okay, you will be redirected to your own fork at `https://github.com/username/scala`, where `username` is your github user name. Make sure you read [http://help.github.com/fork-a-repo/](), which covers some of the things that will follow below. + +### Clone + +Clone your repository. Run the following on the command line: + + $ git clone https://github.com/username/scala + +This will create a local directory called `scala`, which contains a clone of the remote repository. + +### Branch + +Before you start making changes, always create your own branch. Never work on the `master` branch. Think of a name that describes the changes you plan on doing. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: bug fixes and new features. + + - For bug fixes, use `issue/NNNN` for bug NNNN from the [Scala issue tracker](https://issues.scala-lang.org/). + - For a new feature use `topic/XXX` for feature XXX. + +Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaldoc-diagrams` instead of just `topic/diagrams`. + +For your initial contribution, try work on something manageable (TODO: link to the subproject overview page). + +Now, it's time to create your branch. Run the following on the command line + + $ git checkout -b topic/XXX + +If you are new to git and branching, please read the [Branching Chapter](http://git-scm.com/book/en/Git-Branching) in the Git Pro book. + +### Change + +Now, you are ready to make changes ot the code base. The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. + +TODO: refer to other development stuff, partest and so on. + +### Sync and Rebase + +Before you can submit your patch, make sure that your commit structure is clean. We won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so your commits are against the latest revision of `master`. + +Occassionally, you also want to sync with `master` so you don't fall behind too much. Otherwise, creating a clean pull request can become a lot of work. It is often a good idea to use `git rebase` instead of `git merge` to stay on top of `master` and keep a linear commit structure (TODO: do we actually REQUIRE this???). Read more about this approach [here](http://git-scm.com/book/en/Git-Branching-Rebasing). + +### Push + +For now, you might have committed your changes only locally (or maybe you have pushed your changes already to your fork on github because you want others to see it). Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. First, make sure you have pushed all of your local changes to your fork on github. + + $ git push username + # This pushes all of your local branches to your fork on github. + +Again, `username` stands for your github user name. + +### Submit pull request + +Now it's time to send your changes to the Scala project for review. To do so, you ask for your changes to be pulled into the main repository by submitting a pull request. Go to your own Scala project page at `https://github.com/username/scala` and switch to the branch that contains your changes. + +![image](images/switchbranch.png) + +Then click on the "Pull Request" button at the top. + +![image](images/pullrequest.png) + +The github help page at [http://help.github.com/send-pull-requests/]() covers sending pull requests in more detail. Make sure you submit your request against the right branch. Strictly follow our [Pull Request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy). + +A pull request is rarely accepted right away, so don't be depressed if the reviewer of your pull request will reject it or asks you to make additional changes before your request can be eventually accepted into the main repository. diff --git a/contribute/index.md b/contribute/index.md index b11a73bcbf..9f90154c85 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -26,6 +26,14 @@ Standard Library API](www.scala-lang.org/api/current/index.html#package)) is the best place to get started. +## Overview of the Scala Ecosystem + +TODO: I feel this section belongs somewhere else and should be linked here. + +[Scala Project](http://scala-lang.org) + +[Typesafe Stack](http://typesafe.com/stack) + EPFL Typesafe Stack _______________ ___________ | | | | @@ -34,21 +42,42 @@ the best place to get started. | scaladoc | | SBT | | documentation | | .... | |_______________| |___________| + + + +## Basic Workflow + +The Scala project, including the compiler, standard library and Scaladoc is hosted on [https://github.com/scala/scala](). As usual on github, developers work in personal forks that are merged into the main repository via pull request after having successfully completed a review process. As a contributor, your basic workflow is as follows: + + 1. [Fork](https://help.github.com/articles/fork-a-repo) the [Scala Project](https://github.com/scala/scala) + - Create a [topic branch](http://git-scm.com/book/en/Git-Branching-Branching-Workflows#Topic-Branches) + - Fix a [bug](https://issues.scala-lang.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=labels+%3D+community), implement a feature + - Push your changes to your fork on github + - Submit [pull request](https://help.github.com/articles/using-pull-requests) + - Work with a reviewer on [getting your request merged](https://github.com/scala/scala/wiki/Pull-Request-Policy) + - Celebrate! +Read our [Git Commit Guide](git-guide.html) for details. + +## Building + +The Scala compiler and libraries are built using Ant. Read the [README](https://github.com/scala/scala/blob/master/README.rst) on how to build, test and create a distribution. ## Testing -Partest how-tos. +We maintain an extensive test suite that is run via our parallel testing tool `partest`. Read our [Partest Guide](partest-guide.html) for details. ### Lukas's new build machine Link, needs repo name and github username and builds/tests for you. -## Community tickets +## What to work on -- for scaladoc -- for the stdlib -- for the compiler +If you want to become a contributor but you don't know what to work on, here are a few ideas. Generally, it is a good idea to start with fixing bugs! To get some idea, head over to our [Scala issue tracker](https://issues.scala-lang.org/) and search for some unresolved bugs assigned to the community or click [here](https://issues.scala-lang.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=labels+%3D+community) for a direct link. Here is a breakdown into different subprojects: + + - [Scaladoc](https://issues.scala-lang.org/secure/IssueNavigator!executeAdvanced.jspa?jqlQuery=labels+%3D+scaladoc+and+labels+%3D+community&runQuery=true&clear=true) +- [Standard Library](https://issues.scala-lang.org/secure/IssueNavigator!executeAdvanced.jspa?jqlQuery=labels+%3D+community+and+labels+%3D+library&runQuery=true&clear=true) +- [Compiler](https://issues.scala-lang.org/secure/IssueNavigator!executeAdvanced.jspa?jqlQuery=labels+%3D+community+and+labels+%3D+compiler&runQuery=true&clear=true) - for the doc site ## Process @@ -58,8 +87,28 @@ Link, needs repo name and github username and builds/tests for you. Where to ask questions. How-tos to mailing list, discussion pertaining to a specific ticket on the issue tracker. -## CLA +## Contributor's License Agreement + +Before we can accept your pull request you have to sign our Contributor's License Agreement (CLA). + +TODO: Heather + +## Compiler Internals + +The files below are recordings of code walk-through sessions by Martin Odersky about the Scala compiler internals. Some of the information is somewhat outdated, but the clips are still a good introduction to some parts of the compiler architecture. + - [Scala Internals 2008-10-29 (Symbols 1)](http://www.scala-lang.org/sites/default/files/martin_ordersky_scala_internals_2008-10-29.avi) + + Handling of Symbols in the Scala compiler: some details on the symtab subdir, Symbols, Definitions, StdNames, Types (Lazy Types). + + - [Scala Internals 2008-11-05 (Symbols 2)](http://www.scala-lang.org/sites/default/files/martin_ordersky_scala_internals_2008-11-05.avi) + + Handling of Symbols part deux: more information on Symbols, Flags, Definitions. + + - [Scala Internals 2009-03-04 (Types)](http://www.scala-lang.org/sites/default/files/martin_ordersky_scala_internals_2009-03-04.avi) + + A detailed explanation about how types are represented and manipulated within the Scala compiler: data structures, manipulations of types, coding conventions (audio is not perfect, but intelligible). + ## FAQ ### OSX From 02337f4add685cbe0155d8e7e0f12ea29e536aaa Mon Sep 17 00:00:00 2001 From: ingoem Date: Thu, 27 Sep 2012 16:42:23 +0200 Subject: [PATCH 0003/3075] Add partest guide --- contribute/partest-guide.md | 64 ++++++++++++++++++++++++++++++++++++- 1 file changed, 63 insertions(+), 1 deletion(-) diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md index 1b3c098cca..e681c569fe 100644 --- a/contribute/partest-guide.md +++ b/contribute/partest-guide.md @@ -1,4 +1,66 @@ --- layout: page title: Running the Test Suite ---- \ No newline at end of file +--- + +Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go the scala project folder from your local checkout and run it via `ant` or standalone as follows. + +## Using ant + +The test suite can be run by using ant from the command line: + + $ ant test.suite + +## Standalone + +There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use + + ./test/partest --show-diff --show-log --failed + +You can get a summary of the usage by running partest without arguments. + +* Most commonly you want to invoke partest with an option that tells it which part of the tests to run. For example `--all`, `--pos`, `--neg` or `--run`. +* You can test individual files by specifying individual test files (`.scala` files) as options. Several files can be tested if they are from the same category, e.g., `pos`. +* You can enable output of log and diff using the `-show-log` and `-show-diff` options. +* If you get into real trouble, and want to find out what partest does, you can run it with option `--verbose`. This info is useful as part of bug reports. +* Set custom path from where to load classes: `-classpath ` and `-buildpath `. +* You can use the `SCALAC_OPTS` environment variable to pass command line options to the compiler. +* You can use the `JAVA_OPTS` environment variable to pass command line options to the runner (e.g., for `run/jvm` tests). +* The launch scripts run partest as follows: + + scala -cp scala.tools.partest.nest.NestRunner + + Partest classes from a `quick` build, e.g., can be found in `./build/quick/classes/partest/`. + + Partest will tell you where it loads compiler/library classes from by adding the `partest.debug` property: + + scala -Dpartest.debug=true -cp scala.tools.partest.nest.NestRunner + + + +## ScalaCheck tests + +Tests that depend on [ScalaCheck](https://github.com/rickynils/scalacheck) can be added under folder `./test/files/scalacheck`. A sample test: + + import org.scalacheck._ + import Prop._ + + object Test { + val prop_ConcatLists = property{ (l1: ListInt, l2: ListInt) => + l1.size + l2.size == (l1 ::: l2).size + } + + val tests = List(("prop_ConcatLists", prop_ConcatLists)) + } + +## Troubleshooting + +### Windows + +Some tests might fail because line endings in the `.check` files and the produced results do not match. In that case, set either + + git config core.autocrlf false + +or + + git config core.autocrlf input \ No newline at end of file From 9ea42c156a8025f1a5d436d390586eca4422a33e Mon Sep 17 00:00:00 2001 From: Eugene Burmako Date: Fri, 1 Mar 2013 16:41:26 +0100 Subject: [PATCH 0004/3075] first 1.5 steps of the hacker guide --- contribute/01-post.png | Bin 0 -> 172693 bytes contribute/03-fork.png | Bin 0 -> 46172 bytes contribute/hacker-guide.md | 106 +++++++++++++++++++++++++++++++++++++ 3 files changed, 106 insertions(+) create mode 100644 contribute/01-post.png create mode 100644 contribute/03-fork.png create mode 100644 contribute/hacker-guide.md diff --git a/contribute/01-post.png b/contribute/01-post.png new file mode 100644 index 0000000000000000000000000000000000000000..cef3dcaa46d8d4206f3b601ff7157c127d7eb55a GIT binary patch literal 172693 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 V{he5NlyEMeCkpEFC9+1o{{!U6U)2Br literal 0 HcmV?d00001 diff --git a/contribute/03-fork.png b/contribute/03-fork.png new file mode 100644 index 0000000000000000000000000000000000000000..abf86df0199e4d59dc27bbf4d0c2e93d976f1a66 GIT binary patch literal 46172 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 Date: Fri, 1 Mar 2013 18:26:56 +0100 Subject: [PATCH 0005/3075] "Contribute" landing page and sketches for two pages: - bug reporting - documentation contributions --- contribute/bug-reporting-guide.md | 53 ++++++++++++++++- contribute/documentation.md | 29 ++++++++++ contribute/index.md | 94 +++++++++++++++++++++++-------- contribute/scala-fame.md | 9 +++ 4 files changed, 162 insertions(+), 23 deletions(-) create mode 100644 contribute/documentation.md create mode 100644 contribute/scala-fame.md diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 33640bcd47..a60fb15b07 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -1,4 +1,55 @@ --- layout: page title: Bug Reporting ---- \ No newline at end of file +--- + +# Reporting bugs to the Scala project + +The Scala project tracker is located at: + +> [http://issues.scala-lang.org](http://issues.scala-lang.org) + + + diff --git a/contribute/documentation.md b/contribute/documentation.md new file mode 100644 index 0000000000..05b2455a5f --- /dev/null +++ b/contribute/documentation.md @@ -0,0 +1,29 @@ +--- +layout: page +title: Documentation Contributions +--- +# Contributing documentation to the Scala project + +TODO + + diff --git a/contribute/index.md b/contribute/index.md index 9f90154c85..a92c5f37cc 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -2,8 +2,66 @@ layout: page title: Contribute --- +# Contributing to the Scala project + +The Scala programming langauge is an open source project with a very +diverse community, where people from all over the world contribute their work, +with everyone benefitting from friendly help and advice, and +kindly helping others in return. So why not join the Scala community and help +everyone make things better? + +The following are typical questions you might ask when first contributing to Scala. +If you have other questions not addressed here, feel free to ask on the [scala-internals mailing list](http://groups.google.com/group/scala-internals). + +
+ +### I found something that doesn't work as expected. How to file a bug report? + +[The reporting bugs page](bug-reporting-guide.html) describes the steps to take when you find something that doesn't work +as expected. Filing in a good bug report increases the chances the ticket is fixed quickly. + +
+ +### Why contribute a patch to Scala? + +Just to name a few common reasons: + - contributing a patch is the best way to make sure your desired changes will be available in the next Scala version + - Scala is written in Scala, so going through the source code and patching it will improve your Scala-fu + - last but not least, you will make it into the [Scala Contribuitor Hall of Fame](scala-fame.html). + +
+ +### I'd like to start hacking the Scala project, how to find something to work on? + +Depending on your skillset, you may want to contribute documentation and/or code. Documentation has always been very +appreciated work in the Scala community, as most code contributions tend to be quite scarce in explanations of how +things work and how everyone else is supposed to use them. To contribute documentation, have a look at the +[documentation page](documentation.html). + +The main Scala project consists of the standard Scala library, the Scala reflection and macros library, +the Scala compiler and the Scaladoc tool. This means there's plenty to choose from when deciding what to work on. +Typically the scaladoc tool provides a low entry point for new committers, so it is a good first step into contributing. + +On the Scala bug tracker you will find many bugs that are [marked as good starting points to contributing ("community" bugs)](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12111) or [that are not currently assigned](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12112) and that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. + +
+ +### I have this idea that I'd like to add to Scala, how do I start? + +The first step to making a change is to discuss it with the community at large, to make sure everyone agrees on the idea +and on the implementation plan. Starting point ("community") bugs are usually uncontroversial, so you can jump right +ahead to hacking the scala source tree and filing a pull request. For larger changes it is best to announce the change +on the [scala-internals](http://groups.google.com/group/scala-internals) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list. + +Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against +the Scala project source tree. The [hacker guide](hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. + +
+ + \ No newline at end of file diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md new file mode 100644 index 0000000000..75317be820 --- /dev/null +++ b/contribute/scala-fame.md @@ -0,0 +1,9 @@ +--- +layout: page +title: Scala Contribuitor Hall of Fame +--- +# Scala Hall of Fame + +A big thank you to everyone who contributed to: + - [the Scala library and compiler](https://github.com/scala/scala/contributors) + - [the Scala documentation website](https://github.com/scala/scala.github.com/contributors) \ No newline at end of file From b09e5f106986a3fafdd42d5ad0ae0f61982b58a5 Mon Sep 17 00:00:00 2001 From: Eugene Burmako Date: Fri, 1 Mar 2013 18:29:10 +0100 Subject: [PATCH 0006/3075] 1.5 more sections --- contribute/02-post.png | Bin 0 -> 114529 bytes contribute/hacker-guide.md | 153 ++++++++++++++++++++++++++++++++----- 2 files changed, 135 insertions(+), 18 deletions(-) create mode 100644 contribute/02-post.png diff --git a/contribute/02-post.png b/contribute/02-post.png new file mode 100644 index 0000000000000000000000000000000000000000..533ac99538d153d433129e59513a708d02fcc429 GIT binary patch literal 114529 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 Date: Fri, 1 Mar 2013 19:57:46 +0100 Subject: [PATCH 0007/3075] tentative fin --- contribute/04-submit.png | Bin 0 -> 166407 bytes contribute/05-review.png | Bin 0 -> 29682 bytes contribute/hacker-guide.md | 116 ++++++++++++++++++++++++++++++++++++- 3 files changed, 114 insertions(+), 2 deletions(-) create mode 100644 contribute/04-submit.png create mode 100644 contribute/05-review.png diff --git a/contribute/04-submit.png b/contribute/04-submit.png new file mode 100644 index 0000000000000000000000000000000000000000..80acc36cf93e380c7257203ba879ef1636c82641 GIT binary patch literal 166407 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

f?AQ{Dupipdlg;C}}=T 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

5V-fPj1J=6v-5Ui*9vLJ^IReprT1O{yZE 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 z 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 BSkM3f literal 0 HcmV?d00001 diff --git a/contribute/05-review.png b/contribute/05-review.png new file mode 100644 index 0000000000000000000000000000000000000000..330cb519ac2c6945b9e480262568025fe49b7c1f GIT binary patch literal 29682 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 literal 0 HcmV?d00001 diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 298ac6a307..9805ad8795 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -136,8 +136,6 @@ with your hardware). [exec] Resolving [943cd5c8802b2a3a64a010efb86ec19bac142e40/lib/ant/ant-contrib.jar] ... - ... - ... pack.bin: [mkdir] Created dir: /Users/xeno_by/Projects/scala/build/pack/bin @@ -188,6 +186,7 @@ reproducible by throwing together a simple test and feeding it into the Scala di } 17:27 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scalac Test.scala 17:28 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test + 1%n1 ### Implement ### @@ -219,5 +218,118 @@ exclusively as a folklore. However the situation is steadily improving. Here are * [scala-internals](http://groups.google.com/group/scala-internals), a mailing list which hosts discussions about the core internal design and implementation of the Scala system. +### Interlude ### + +To fix [the bug I'm interested in](https://issues.scala-lang.org/browse/SI-6725) I've tracked the `StringContext.f` interpolator +down to a macro implemented in `MacroImplementations.scala`. There I noticed that the interpolator only processes conversions, +but not tokens like `%n`. Looks like an easy fix. + + 18:44 ~/Projects/scala/sandbox (ticket/6725)$ git diff + diff --git a/src/compiler/scala/tools/reflect/MacroImplementations.scala b/src/compiler/scala/tools/ + index 002a3fce82..4e8f02084d 100644 + --- a/src/compiler/scala/tools/reflect/MacroImplementations.scala + +++ b/src/compiler/scala/tools/reflect/MacroImplementations.scala + @@ -117,7 +117,8 @@ abstract class MacroImplementations { + if (!strIsEmpty) { + val len = str.length + while (idx < len) { + - if (str(idx) == '%') { + + def notPercentN = str(idx) != '%' || (idx + 1 < len && str(idx + 1) != 'n') + + if (str(idx) == '%' && notPercentN) { + bldr append (str substring (start, idx)) append "%%" + start = idx + 1 + } + +After I applied the fix and running `ant`, my simple test case in `sandbox/Test.scala` started working! + + 18:51 ~/Projects/scala/sandbox (ticket/6725)$ cd .. + 18:51 ~/Projects/scala (ticket/6725)$ ant + Buildfile: /Users/xeno_by/Projects/scala/build.xml + + ... + + quick.comp: + [scalacfork] Compiling 1 file to /Users/xeno_by/Projects/scala/build/quick/classes/compiler + [propertyfile] Updating property file: /Users/xeno_by/Projects/scala/build/quick/classes/compiler/compiler.properties + [stopwatch] [quick.comp.timer: 6.588 sec] + + ... + + BUILD SUCCESSFUL + Total time: 18 seconds + + 18:51 ~/Projects/scala (ticket/6725)$ cd sandbox + 18:51 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scalac Test.scala + 18:51 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test + 1 + 1 + ### Verify ### +Now to make sure that my fix doesn't break anything I need to run the test suite using the `partest` tool we wrote to test Scala. +Read up [the partest guide](/contribute/partest-guide.html) to learn the details about partest, but in a nutshell you can either +run `ant test` to go through the entire test suite (30+ minutes) or use wildcards to limit the tests to something manageable: + + 18:52 ~/Projects/scala/sandbox (ticket/6725)$ cd ../test + 18:56 ~/Projects/scala/test (ticket/6725)$ partest files/run/*interpol* + Testing individual files + testing: [...]/files/run/interpolationArgs.scala [ OK ] + testing: [...]/files/run/interpolationMultiline1.scala [ OK ] + testing: [...]/files/run/interpolationMultiline2.scala [ OK ] + testing: [...]/files/run/sm-interpolator.scala [ OK ] + testing: [...]/files/run/interpolation.scala [ OK ] + testing: [...]/files/run/stringinterpolation_macro-run.scala [ OK ] + All of 6 tests were successful (elapsed time: 00:00:08) + +### 4. Publish ### + +After development is finished, it's time to publish the code and submit your patch for discussion and potential inclusion into Scala. +In a nutshell this involves: 1) making sure that your code and commit messages are of high quality, 2) clicking a few buttons in the +Github interface, 3) assigning one or more reviewers which will look through your pull request. Now all that in more details. + +### Commit ### + +The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. +There are two things you should know here: + +1) Commit messages are frequently the only way to communicate with the authors of the code written a few years ago. Therefore, we give them +big importance. Be creative and eloquent - the more context your provide about the change you've introduced, the bigger the probability that +some future maintainer will understand you right. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) +for more information about the desired style of your commits. + +2) Clean history is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. +For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, +you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so your commits are against +the latest revision of `master`. + +Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on Github. + + 19:22 ~/Projects/scala/test (ticket/6725)$ git add ../src/compiler/scala/tools/reflect/MacroImplementations.scala + 19:22 ~/Projects/scala/test (ticket/6725)$ git commit + [ticket/6725 3c3098693b] SI-6725 `f` interpolator now supports %n tokens + 1 file changed, 2 insertions(+), 1 deletion(-) + 19:34 ~/Projects/scala/test (ticket/6725)$ git push origin ticket/6725 + Username for 'https://github.com': xeno-by + Password for 'https://xeno-by@github.com': + Counting objects: 15, done. + Delta compression using up to 8 threads. + Compressing objects: 100% (8/8), done. + Writing objects: 100% (8/8), 1.00 KiB, done. + Total 8 (delta 5), reused 0 (delta 0) + To https://github.com/xeno-by/scala + * [new branch] ticket/6725 -> ticket/6725 + +### Submit ### + +This part is very easy and enjoyable. Navigate to your branch in Github (for me it was `https://github.com/xeno-by/scala/tree/ticket/6725`) +and click the pull request button to submit your patch as a pull request to Scala. If you've never submitted patches to Scala, you will +need to sign the contributor license agreement, which [can be done online](http://typesafe.com/contribute/cla/scala) within a few minutes. + +![Submit a pull request](/contribute/04-submit.png) + +### Discuss ### + +After the pull request has been submitted, you need to pick a reviewer (probably, the person you've contacted in the beginning of your +workflow) and be ready to elaborate and adjust your patch if necessary. I picked Martin, because we had such a nice chat on the mailing list: + +![Assign the reviewer](/contribute/05-review.png) From a541a62b5602dcd4aea855867ad3f03b7c1d65d3 Mon Sep 17 00:00:00 2001 From: Eugene Burmako Date: Fri, 1 Mar 2013 20:18:15 +0100 Subject: [PATCH 0008/3075] polishing the hacker guide --- contribute/hacker-guide.md | 62 ++++++++++++++++++++------------------ 1 file changed, 33 insertions(+), 29 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 9805ad8795..f5a4f8724e 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -10,12 +10,15 @@ to a nightly and, ultimately, to a production release of Scala incorporating you influence a programming language of your choice is amazing, and I'm excited to demonstrate that it's easier than one might think. +### The running example ### + I like string interpolation a lot. Doing debug prints with interpolators introduced in Scala 2.10.0 is so enjoyable that I often wonder how we ever lived without that feature. However there's an annoying issue which I occasionally stumble upon: the formatting string interpolator `f` [does not support](https://issues.scala-lang.org/browse/SI-6725) new line tokens `%n`. I could go the mailing list, ask to fix this bug and then indefinitely wait for the fix. Or I could instead patch Scala myself and get the fix in a subsequent release (nightly builds get produced, well, every -night, minor releases are pumped every few months and major releases happen once a year). Let's get to work! +night, minor releases are pumped every few months and major releases happen once a year). The latter option sounds cool, so let's see +how it works! ### 1. Connect ### @@ -47,7 +50,7 @@ list of people (Github usernames and real-life names) and their specialties: documentation: @heathermiller (Heather Miller) cps: @TiarkRompf (Tiark Rompf) -Martin is the one who submitted the string interpolation proposal and implemented this language features for Scala 2.10.0. +Martin is the one who submitted the string interpolation proposal and implemented this language feature for Scala 2.10.0. (TODO: how to choose a mailing list) Therefore now I'm going to [the scala-user mailing list](http://groups.google.com/group/scala-user) and will post a topic about my issue. Note that I put Martin in the cc list of the email. If I didn't do that, he would probably miss it in a bunch @@ -57,19 +60,19 @@ of emails, which get posted to scala-user every day. ![Response from Martin](/contribute/02-post.png) -Now when I have an approval of the feature's author, it makes sense to start doing something. +Now when I have the approval of the feature's author, I'll get to work! ### 2. Set up ### -Hacking Scala begins with creating a branch for your work item. In our workflow we use [Git](http://git-scm.com/) -and [GitHub](http://github.com/). This section of the guide provides a short walkthrough on how to use them. -If you are new to Git, it might make sense to familiarize with it first. We recommend the [Git Pro](http://git-scm.com/book/en/) +Hacking Scala begins with creating a branch for your work item. To develop Scala we use [Git](http://git-scm.com/) +and [GitHub](http://github.com/). This section of the guide provides a short walkthrough, but if you are new to Git, +it probably makes sense to familiarize with Git first. We recommend the [Git Pro](http://git-scm.com/book/en/) online book. ### Fork ### Log into [GitHub](http://github.com/), go to [https://github.com/scala/scala](https://github.com/scala/scala) and click the `Fork` -button at the top of the page. This will create your own copy of our repository that will serve as a scratchpad for your experiments. +button at the top of the page. This will create your own copy of our repository that will serve as a scratchpad for your hackings. If you're new to Git, don't be afraid of messing it up - there is no way you can corrupt our repository. ![Fork scala/scala](/contribute/03-fork.png) @@ -113,13 +116,13 @@ The next step after cloning your fork is setting up your machine to build Scala. [https://github.com/scala/scala/blob/master/README.rst](https://github.com/scala/scala/blob/master/README.rst), but here's the summary: * It is recommended to use Java `1.6` (not `1.7` or `1.8`, because they might cause occasional glitches). -* The build tool we use is `ant`. -* The build script runs the `pull-binary-libs.sh` script to download bootstrap libs. This requires `bash` and `curl`. -* The majority of our team works on Linux and OS X. +* The build tool is `ant`. +* The build runs the `pull-binary-libs.sh` script to download bootstrap libs. This requires `bash` and `curl`. +* The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. * Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter them. -In a nutshell, build Scala is as easy as running `ant` in the root of your clone. Be prepared to wait for a while - a full rebuild -takes 7+ minutes depending on your machine. Incremental builds are usually within 30-90 seconds range (again, your mileage might vary +In a nutshell, building Scala is as easy as running `ant` in the root of your clone. Be prepared to wait for a while - a full rebuild +takes 8+ minutes depending on your machine. Incremental builds are usually within 30-120 seconds range (again, your mileage might vary with your hardware). 16:50 ~/Projects/scala (ticket/6725)$ ant @@ -149,7 +152,7 @@ with your hardware). ### IDE ### -There's no single editor of choice to work with Scala sources, as there are trade-offs imposed by each available option. +There's no single editor of choice for working with Scala sources, as there are trade-offs associated with each available tool. Both Eclipse and Intellij IDEA have Scala plugins, which are known to work with our codebase. Here are [instructions for Eclipse](https://github.com/scala/scala/blob/master/src/eclipse/README.md) and @@ -158,7 +161,7 @@ navigation, refactoring and error reporting functionality as well as integrated of occasional sluggishness. On the other hand, lightweight editors such as Emacs, Sublime or jEdit provide unparalleled scriptability and performance, while -lacking semantic services and debugging. To address this shortcoming, one can integrate with ENSIME, +lacking semantic services and debugging. To address this shortcoming, they can integrate with ENSIME, a helper program, which hosts a resident Scala compiler providing some of the features implemented in traditional IDEs. However despite having significantly matured over the last year, its support for our particular codebase is still far from being great. @@ -168,12 +171,13 @@ Therefore it's hard to recommend a particular tool here, and your choice should ### 3. Hack ### When hacking on your topic of choice, you'll be modifying Scala, compiling it and testing it on relevant input files. -Typically you would want to first make sure that your changes work on a few small example and afterwards verify that nothing break -by running the comprehensive test suite. +Typically you would want to first make sure that your changes work on a small example and afterwards verify that nothing break +by running a comprehensive test suite. I'm going to start by creating a `sandbox` directory (this particular name doesn't bear any special meaning - it's just a tribute to -my first days in Scala team), which will hold a single test file and its compilation results. First I make sure that the bug is indeed -reproducible by throwing together a simple test and feeding it into the Scala distribution assembled by ant in `build/pack/bin`. +my first days in Scala team), which will hold a single test file and its compilation results. First I make sure that +[the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by throwing together a simple test and feeding it +into the Scala distribution assembled by ant in `build/pack/bin`. 17:25 ~/Projects/scala (ticket/6725)$ mkdir sandbox 17:26 ~/Projects/scala (ticket/6725)$ cd sandbox @@ -186,7 +190,7 @@ reproducible by throwing together a simple test and feeding it into the Scala di } 17:27 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scalac Test.scala 17:28 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test - 1%n1 + 1%n1 // %n should've been replaced by a newline here ### Implement ### @@ -198,17 +202,17 @@ Here are also some tips & tricks that have proven useful in Scala development: try doing `ant clean build`. Due to the way how Scala compiles traits, if a trait changes, then it's sometimes not enough to recompile just that trait, but it might also be necessary to recompile its users. Ant is not smart enough to do that, which might lead to very strange errors. Full rebuilds fix the problem. Fortunately that's rarely necessary, because full rebuilds take significant time. -* Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. There are quite a few - people in our team, who do `ant quick.comp` instead of `ant` and then create custom scripts to launch Scala from `build/quick/classes`. +* Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, + some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts to launch Scala from `build/quick/classes`. * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious - to some, I'd like to explicitly mention that it's useful to print stack traces to understand the flow of execution. + to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. -Docs. Right, the docs. The documentation about internal workings of the compiler is scarce, and a lot of knowledge gets passed -exclusively as a folklore. However the situation is steadily improving. Here are the resources that might help: +Docs. Right, the docs. The documentation about internal workings of the compiler is scarce, and most of the knowledge is passed around +in the form of folklore. However the situation is steadily improving. Here are the resources that might help: * [Compiler internals videos by Martin Odersky](TODO) are quite dated, but still very useful. In this three-video - series Martin explains inner working of the part of the compiler, which has recently become Scala reflection API. + series Martin explains inner workings of the part of the compiler, which has recently become Scala reflection API. * [Reflection and Compilers by Martin Odersky](http://channel9.msdn.com/Events/Lang-NEXT/Lang-NEXT-2012/Reflection-and-Compilers), a talk at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the reflection API. * [Reflection documentation](http://docs.scala-lang.org/overviews/reflection/overview.html) describes fundamental data structures that @@ -262,7 +266,7 @@ After I applied the fix and running `ant`, my simple test case in `sandbox/Test. 18:51 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scalac Test.scala 18:51 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test 1 - 1 + 1 // no longer getting the %n here - it got transformed into a newline ### Verify ### @@ -293,13 +297,13 @@ The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git onlin There are two things you should know here: 1) Commit messages are frequently the only way to communicate with the authors of the code written a few years ago. Therefore, we give them -big importance. Be creative and eloquent - the more context your provide about the change you've introduced, the bigger the probability that -some future maintainer will understand you right. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) +big importance. Be creative and eloquent - the more context your provide for the change you've introduced, the bigger the probability that +some future maintainer will get you right. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) for more information about the desired style of your commits. 2) Clean history is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, -you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so your commits are against +you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on Github. From edc6f1520130fe52496f48109bf2fd2a1eb4fdb3 Mon Sep 17 00:00:00 2001 From: Eugene Burmako Date: Fri, 1 Mar 2013 20:19:06 +0100 Subject: [PATCH 0009/3075] removes the git guide - it's been subsumed by the hacker's guide --- contribute/git-guide.md | 78 ----------------------------------------- 1 file changed, 78 deletions(-) delete mode 100644 contribute/git-guide.md diff --git a/contribute/git-guide.md b/contribute/git-guide.md deleted file mode 100644 index 2e173ec7ec..0000000000 --- a/contribute/git-guide.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -layout: page -title: Using git ---- - -This is a step-by-step guide on how to use [git](http://git-scm.com/) and [github](http://github.com/) if you want to contribute to the Scala project. If you are new to git, make yourself familiar first. We recommend the [Git Pro]()http://git-scm.com/book/en/) online book. - -### Signup - -First create an account on [github](http://github.com/). You can also use your existing account, of course. - -### Fork - -Now, go to [https://github.com/scala/scala]() and click the "Fork" button at the top of the page. - -![image](images/fork.png) - -If everything went okay, you will be redirected to your own fork at `https://github.com/username/scala`, where `username` is your github user name. Make sure you read [http://help.github.com/fork-a-repo/](), which covers some of the things that will follow below. - -### Clone - -Clone your repository. Run the following on the command line: - - $ git clone https://github.com/username/scala - -This will create a local directory called `scala`, which contains a clone of the remote repository. - -### Branch - -Before you start making changes, always create your own branch. Never work on the `master` branch. Think of a name that describes the changes you plan on doing. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: bug fixes and new features. - - - For bug fixes, use `issue/NNNN` for bug NNNN from the [Scala issue tracker](https://issues.scala-lang.org/). - - For a new feature use `topic/XXX` for feature XXX. - -Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaldoc-diagrams` instead of just `topic/diagrams`. - -For your initial contribution, try work on something manageable (TODO: link to the subproject overview page). - -Now, it's time to create your branch. Run the following on the command line - - $ git checkout -b topic/XXX - -If you are new to git and branching, please read the [Branching Chapter](http://git-scm.com/book/en/Git-Branching) in the Git Pro book. - -### Change - -Now, you are ready to make changes ot the code base. The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. - -TODO: refer to other development stuff, partest and so on. - -### Sync and Rebase - -Before you can submit your patch, make sure that your commit structure is clean. We won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so your commits are against the latest revision of `master`. - -Occassionally, you also want to sync with `master` so you don't fall behind too much. Otherwise, creating a clean pull request can become a lot of work. It is often a good idea to use `git rebase` instead of `git merge` to stay on top of `master` and keep a linear commit structure (TODO: do we actually REQUIRE this???). Read more about this approach [here](http://git-scm.com/book/en/Git-Branching-Rebasing). - -### Push - -For now, you might have committed your changes only locally (or maybe you have pushed your changes already to your fork on github because you want others to see it). Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. First, make sure you have pushed all of your local changes to your fork on github. - - $ git push username - # This pushes all of your local branches to your fork on github. - -Again, `username` stands for your github user name. - -### Submit pull request - -Now it's time to send your changes to the Scala project for review. To do so, you ask for your changes to be pulled into the main repository by submitting a pull request. Go to your own Scala project page at `https://github.com/username/scala` and switch to the branch that contains your changes. - -![image](images/switchbranch.png) - -Then click on the "Pull Request" button at the top. - -![image](images/pullrequest.png) - -The github help page at [http://help.github.com/send-pull-requests/]() covers sending pull requests in more detail. Make sure you submit your request against the right branch. Strictly follow our [Pull Request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy). - -A pull request is rarely accepted right away, so don't be depressed if the reviewer of your pull request will reject it or asks you to make additional changes before your request can be eventually accepted into the main repository. From ca55cb4757fa02c89bdd469ca4a66a0b2476b5a1 Mon Sep 17 00:00:00 2001 From: Eugene Burmako Date: Fri, 1 Mar 2013 20:20:17 +0100 Subject: [PATCH 0010/3075] removes the workflow page - it's been subsumed by the hacker's guide --- contribute/workflow.md | 4 ---- 1 file changed, 4 deletions(-) delete mode 100644 contribute/workflow.md diff --git a/contribute/workflow.md b/contribute/workflow.md deleted file mode 100644 index 89c71102a9..0000000000 --- a/contribute/workflow.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -layout: page -title: Contributor's Workflow ---- \ No newline at end of file From de59612fefb92a5e76c50594070e5d1cb297387e Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Sun, 3 Mar 2013 14:06:49 +0100 Subject: [PATCH 0011/3075] Fixing issues with images, formatting fixups, moving maintainers list into an include for future reuse --- contribute/01-post.png | Bin 172693 -> 0 bytes contribute/02-post.png | Bin 114529 -> 0 bytes contribute/03-fork.png | Bin 46172 -> 0 bytes contribute/04-submit.png | Bin 166407 -> 0 bytes contribute/05-review.png | Bin 29682 -> 0 bytes contribute/hacker-guide.md | 32 ++++++++------------------------ 6 files changed, 8 insertions(+), 24 deletions(-) delete mode 100644 contribute/01-post.png delete mode 100644 contribute/02-post.png delete mode 100644 contribute/03-fork.png delete mode 100644 contribute/04-submit.png delete mode 100644 contribute/05-review.png diff --git a/contribute/01-post.png b/contribute/01-post.png deleted file mode 100644 index cef3dcaa46d8d4206f3b601ff7157c127d7eb55a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 172693 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 V{he5NlyEMeCkpEFC9+1o{{!U6U)2Br diff --git a/contribute/02-post.png b/contribute/02-post.png deleted file mode 100644 index 533ac99538d153d433129e59513a708d02fcc429..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 114529 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

f?AQ{Dupipdlg;C}}=T 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

5V-fPj1J=6v-5Ui*9vLJ^IReprT1O{yZE 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 z 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 BSkM3f diff --git a/contribute/05-review.png b/contribute/05-review.png deleted file mode 100644 index 330cb519ac2c6945b9e480262568025fe49b7c1f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 29682 zcmcG!V{~TCwlJFR*tYFF9ox2TCmq|iZQHhO+jhrx^7XsVxo7Y5-TU{hF=`d2=cu`= z)~pJXlM#i5!h!+<0)iD66H)*I`uVp2*+GE)edD=G_X7dJpqL8^%83gK63E%xn3!7{ z0|AM_R;ik*DUM-fE5`GQ2|x<*Nt{Y25^1}`<`Upq29l8E4I)5LJ=K@?YRDn}z^*6A z-`4)U2UQ%ZEI(-S^Oy2d5BB1#za<`! z7>T9Kp6NXUArA!5@?gTaJrDunla%R^7-T1yfixxz!amhc=nz|EKgD3%ja)Laas1yX zKooPWT4@MC?(m0eZCr$n1G)T`5oN*uUis3K^*8c_&{Ztn>g zLR%1f9~B?M?oUhvUlf8LTfVUUe!LJE)oZaSe9_=0{xE7rmP>JH^T-P1XM|^1;{5H* z{e9U390XvVp&^!^v-o#&1n?h_RZx6Sp{!cy&;8stwrcOa`@S9f*2Gqq+)>=bu52oV z7Z#kB8#ZijT4uKsq1M5!VU{59&*HDk2RZbhej~qt`w@e*v$R{bPU60HM5W+Jz+(kR z`HiS8L7jm(BeHs@4Ml53dWWM8rPZ*V6MF~jqFna`f=8j^_AC*=8YqD7`T%30Jw3+a zU()oJe)?0kKjmvvKne#~Zdu{&0^}pU^@ZV3DQ69_7K6PqV)j~X9a6Q)H{qWH-GbSN z)m!Omheie>-}kp|;W7!{z0kgSury;iQZG0A>IwtMZE@1r{nyxSX@7jD&9gJq$t4av z1$7kZ!DJBcMd1!O*EYC-3~o!B0l5xfZ7L!z2VHBaKm%EW-h7iZbF<|A^tJfeyGIW6 zYsc$EN@rjP=qgE+)74)6Di)4hhorTjqQ6G~90Leh50Y^oDAN!8=7%2vijXfxEJX1D zGtJMmU;FBMcxo_r{Df-2EWQl2s24z-eR#F_O#Z~XAZ);N{&2Rin?ImtL3Mm}Zr~n> zAq4nOA&}?zVGtPy!R+|75CJ3zkfQmqLL``oL`Xu>lY+@aL1Od@!Iq-G<8Ee?^x^O%&7mqe%L>`JNsLHKZzuWbqij-9-T2I)Pz*YznAIlVxC`(1CoB$UmGw|IO z@enOV)-Z}@gx{ECDCMFCi|0R75I4D$$V`O{uNoUcOjUS!`K+QH_%~shVBTsnI6Urv4gl zpJLCeob{Xkv2a*!p){hbXt8T?VXI$t(>$RTnSM2R7zQqR`FV4w}e)jRDr9~k+)njt<<6#BR8W2P}nK**7-~W z6CThamJ6tBesNz(2NxnkcT4?7kU>5a=JdUEn=<<26;#Qi`07%$WZ^L!5 zbn$orf9iRaeUW`8ym5ok0OJQR1w4X{z_i1r1?vPG3_J#pz~(eGt#)6)I8(l(bgYQY zPz;J$H*S?~mF}$evn{)Z*>&A=BbSF&h?kGKC#WRoC<-ow72ivpOW9;lX0)Y;O|qnC zF?-lp>*LvUZ+6aoqy;sDju6e{Pw!WgZq08nOw`Zcm7}hWFHvp%Zcq+k{(WggTTj>0 zZ4|K1wh?N@vf&s_7-fe|jH$?e985d4yuz~5JpI(Cw!C^%CppX#?ZrOrs5Rf(bTA$L z{`9xhof^Cts|&3GWOx=cp#zC0@@qWRn#8irxL(mD# zW!TS1!QS((`fz3w!kV-N5R{-0H$QQIVs+TH`+l=>-vOHKZ_u}(G_$zBXeuDP$D!Xc zs;NZu2k|{(Vz6djV7|GyOEyNVMjU@Mbf$DhX$=Z#=XC>}09pa9k&a2d)lz>Ye^;0jT@k$m@Z}Y@6~9kvlQImj z(kbq-oU0e*1^re^nHfzv+EKfz^E`+04008Iml#RPQ1PbSMc1Neq^6<#&>Ey}ziIfK zDdL5%l+a%4UUz#;Wt(@tOg!xm~MwsrXv%ugYl-YuVbw>+H&# z@2ochcN4veCResoHubUlENa$hX|H{gj4BkVWBh$mrjfF~uI=8TvXbX?*M7C7=;Cq# zxw_D};(Yz&uHv=FQ!Cqj{aQ2DqqBqG-1F#r?$-rA1*d{zfJbGyZoru50(f)?>)fk>V20vG-cFV`@8Z?ww(Z!Ff?|lK zsKZI%v|&mYAg2|{_GnUhdMRRsO#8eO&*Sqrs*Dwd^_4YeYrOUGkMq^#7iYv({1w`! zVuz}|?zQ(3zKYKxbtbAPJ_whY2gc{kH1T!;dQ1bp&y~hg;8)>c+1|psDcnr7Be;_b zSI%AMdC-HfkL*{@A0L&@Mo+gJKu*uPJF2GO{hC0lKO-;)nO?}EU+H;( zoE$$?2n4y-%A(-{fbzz6=MD#Yd$GNMD5iis<6vPPZ16B%6hLRTT7b;Pu-X$4e=~56 z*eH_DzCPs(55A9_@Lq@Nsj8}9`2GD&fV34;cK`xHBmJlR5LY0%0RsAwW3Hs;s3tAN zVQ6DTr*C9qU`*#~W&0N!2#Cv-<8RZ-*ioOr)ymS^fy0%X=wBEdf7|~I1BeLzh2m(z zO{69*M<8fpZ%n{UM^DEgO`xk@O!OhxH-<8(df%w0e{6Bnzj2#T^&21gcZLA6Y;j3?8xH7e~bJNQuTk6(zCO&{3q#ufc~453-FH#|6$U9`RiY!e;vjH#Rd2u z=kq`b%==jY0r3He3-K$t{5W*WQk@#JRP zNj5tpYp%f0&0UG!Bwy+usz0kiv>^Wm9;uuuB*-%6fUqs;{{{MmWQ$7aLhujHe?b0F z{!oo8FWJ>%`ZtSzfh)w?4F7M|vXHIeO5C6)`ECE3iN7}DONwtt-CR$k7R0~#+=#~V z{e6;5+QXGl?UbbD{HQ1>_{7B_wT#QlEjJVYt@cZSxUYngm>2{R5m7FbvM&Y1F%G3j z54bVmuba~kG zI+|=@hl-X;u2HDW01ZcrvV7-v!lrx2f9fqt;8$PIP=GGSo14uSRIb3e+U>>JY_$=b zo15#du50$kfZ+BGgo>t8PF`L<>$M^n0~Ix>TDyaYi>s4Ixzt}UDuLe|pUbs&+p0of zRr-H9wuc>3ZYC@$s!FR!fxC}Fp{S_H^`dTMw$sglgp?FBD6e^$lFm*3heo?&nY{1Y z^R-PQ)6fd3;Q2g85}5^i75CZMSt`2&*);dFRsn?io&~WLm9N9`WM9|wc0@ETXL>tD z%=#{8pBXMjgEu53WYSNPPGqlsjw8;wmSal5)V=Tk)CtJJoy*ZR6P=^hYk1W`_^)m= zwY^Ne&D-buNM7=_hMmgKgQo({XbVP}zoYN1Z(dSGVeWhZV6d(h%55u=M8dwcwZF7H zE}KFlA{hCcJ{PLBIR#y3bNQWwnQziC(;#3Whn7@zttt&33H!m8SBQ>d@RNk8(w&-C z?PAx-S&xpCiUZcsqxY9tocHruWsK>3W~^aUzeG=vGi3}XaeeS0*~W@_o_FT*3qJQz zIB(_HO6uPl1<%-rWVleK%O;PmrwwuNMIG=?;&q&zo8daB?2hK~FwxM^(gmngI1noM zI7vc9p^;ahmL`kn@7234R_JWcVjs-WEH;{Hv6z1wl_n)6Mc5;S=I;~T6T_sO{?P;v zp~6d|X%4U|e2iSN{$H`+{f(5%BP2Y&($J$2mrtSOW>C5Eh>Dm*@rK&<_@wzVvh(dX zIXNkzAQ%kO$Njt+fJiKYK{`IIx!_bKsJ%x`tuzr~DBY91WZU;&vG`wc=BFD561}bd zBN-@5BjWz+FMdKhOpUl_X4d|{X-hE}T;p+GcdxZ}FpqLC~AZT^AA$mdqF zgo9z`V-*aa*{HjJjUQztz2+v}bUwXyNTNjqqfed<+ueAp>Xq)h{Gd)`t^HG%J(z;L zB=;c9a29X#7H}UTO+f{iVlkI~3DsuDOT%&Ut`uKh2VAiglavSVyuU2m$~P^AC@Rw^ zgfzrlgnLWWblyRc$!1&P^t4r`Bqy7YX=yl}HcDSVLn4zAu(M;5XWIHxaxzqp;AsY( zITDKlOM#Zd*Ofos1)T?)hB*0`6<+w=YBH zO>f5$yCYb)m;SDpifJun#gHSTYR}D)Ma>KQMgu%$VF^sD^~N!ptvUGL=gU>YEn;a% z!P(bS>CBAk_+Af)U~o8UrsUQ|&kiG%JC3D5czczt z&aSi#C)8e1s4@#!?*qh{s4H+a#!sF_HFf>w8iqcuferiXdrgzsH4n@xY|<7N@G-V3 zTAZE9Yxhar!%!vWQJ;H=)8Q8XR>mr1#onX4|Nl=B{~z{NL(cpSxqn<4R;}B!ttApD zNAYce3<2tsR3)%$DpPB{oTGf|RMi4-9r2XUS<=xvGPmj` z&PMHZzJ%VU-#NM--+9lzj_xVnS()D$zwMqA2w6q%H1vjj&LQr+ahR;}i&mLKl!eAM z(7lQNI~jR5x$+NsC$UHBzh5nzBW3TZSX6NdeQvQ_x@$T;W5S4rt{2jFxvo=*uEq-h zs8y<)up3RG1G?fy*BH1Y8r&>P>uKq_8EQj^@H^8B5*z<0vGYU<>rqWO< zS$aVw)IyPvQ>ry8iTug z1~S~tVVCPFD2-e6Yk5^-yt-C>uX1I{RqaJJdR1e5VSH!2px7d%NBVd52kn5cvBOJt zEs9Eq(&=wdW}}a}k(>lGEp`s^qT^29H#QEm%Mv7E{L{$*a5+4jAQ9Mpc`d3OZX*0Cj7n9Y+l@~q^d#W{W8W8rzCQKD%Uj;={8N;-)X z8UU86Uo!R1AQ%F7OaVgoT*nZ& zSIvF3Z-~Kaof$SUJ|Xo{@p-UhxeA8*JE^^1%V_cm6by`jl^h#XxX2qkIs`242w|~T zZ?4b~0Y#1wDrrP$Jo@0RlKZ7Rpg$e1<)Q5eXXI_D#d|PaF{)a-}Cs zWJ_(#xm8WevGc{ulv0x7N;+;vk9-s=EEJugp)I_1ldEAJjDVsIm3v@0_+z zqmf-U6K}!G**6c3gU@%yt&!+X^`M+EUUl~6J=XCYtGpkChSzYDS>Lb>69R~}KHw(P z;KMMSc(B9)6_iX(*1Y6wX)`~81LSlPBd(KahQg&g5J^-@pbVX$5O^)>BC1Al z5Mh+>QzfI?h3&y%FlT`g`B4!f3L!-(@3fXbRClxVDw>7_hRP6Ngp zBNfxQub*jrJT#?Q-T$t>3pRP5Jt@u@X&Wc>XEFAYIUuf|`i(xBZC#L`e-UoZVUwkqAM>@=6rrg@8v&vCZFo z+utC&n`93Yl6N;ts?c>ND};kWfn)K6vm9;Q8mu;vqqcdpU(4W6*8{_}oCpYL(VGuj zFOJTH(>UB1(pW;dLfLiRPO#u#7lyi@lYd^73V#a_<%9LFQ4bd^o{=+~&yzS_uA?R# zah0t#n5xp~t5~J9|=Fb$zuNSj8x2sTKG9evGRppr zbR$OPW+=zv1r_y268XomGzJmTg$x+kh^ZXTwFXI8(W z@fz*bl=S*h$L(aEfSb%@#+FN@4=}9CeBnHLwdP+!BF9rEEHBP2%<*7Lh}=QJ>1BqEn8i!M~%Lo*Ept0yZ^)1XHS)k%2D}c zPP%+GDG(5fKtKal5d0|Ekt{t})+Gh^d|WP*Tj}2k_vouOcDGP>^S;F9 z<;n|@YK!NoxuW5N#RBL+75E~+0^A#mJlu*-T+*Lfq5>2{oE z;ubS~G&eVAw%%A~he8~QnzQm)27LC5f>yTN+b2n+%&}Q#B^Ze_-H@0SpbIAc%iq{- zCMBpBy$fp14*?S|@SzfCF7t?=5_l2ek*L&@T}^0}tfk)~2m-+y3t|L+D%USR6H$d0 zZJjLYwRq%_PWb=;UWkYY@M(W0r-Deh@p@H47|Y~Mk>DXZI-mZQ<^R6QRB zhHlF~BQ_3hvX})+ZkcAfOMM@AsbYh zpQIvYRgsh(2YEi+EVlLPOG!D_hr<5xw5f?N)B;B$Gu)`sLw^^Wpgo6}5iF;0eUtx^lzRuPd3Z3w(;vDDjwY#{RhDUXR zP*t#fmk~;PyJqET}{>r6&yNZbF&3x(mAEKnH7za1988@3iU+O z9$^xak$|bRHuLKN2l&S&)S*|fT*R6hK}ZDT+x`j7Gu!%wgUw^C?tFhs2@^?N)N9}g}uq_~#F$hDE*-oE}!u3t`^Fw*%KFNoB(rx>FOY)`Wj0S@4jHLfzyFM54NaO|>nchpK)G(SbzZK( zE96F6T2DgaWzMWE_CpWTQ42sfKEp4P>{+GZS%Wn=OsF80S42d-0G^oC8x%ASG$keK zEzfQMLPo`~*ehp8aOuyL7Z(?VG)Jn22jI~{otIUfYN#Zq#tKCnaRQ$2pQWG!D;j!T z?Rd`Zvp}G=SY!|}(;)pO*u$m3uSj+gU_54{toJJBP9{T6X8qmP8HDD#flEfVk;@ld zz#tgHV+RP5*dILew`B6G4H%D{aHQ)?cBNvyE#C!h}xNyfcMocNLY>7u7C{|#b+;#%2ANRAkmeP?Oe@lh{}}ozgB#=# zBPri;kb;}pxZ&y~b*9BjJB%&zD6d{@7N&Al=VXgAs?wVS?WCcw_o_n5T2`b?n8FUV}1odTq@QC55g>Gc^jo7l~2s^F` zH{dH1=K7h}A-`D3x$bxo!%4Q~zfDPtKoUMEyED~)Ao~dpZA#PYT_zgSEoisK>@yr> z8Y7Zw7n-tOXFm_{i#M@?zB>e3ZdFO;zNF=9am7Nj9*<`o#cMs-?w~KVVC;Olv2uL~ zsIgn{nX=_|#%IZ96Z6tYf7tF+E!Jheh%A#$?MN zU|>bB`HAVD4ijcu`3or`FkgNzOL_8qa~cj=Y_>xWXE~6yHz%~@^y5srK63{)S;xeG zX3!r@44KW90fw{ak<>L+_XA{23E5Z>2V{AG$>FhmW9zx3JWjX+p*`#TzR_qop8Hzs ze)d?AZhs$21`e{Y+!Ta7AS*U>(j=nljj7(>4qXJT=4gfEA|SYinTz3yiO93IS1&2~Bk%Rkm>a(W8jLPiny zEn(sPQ++nw@XqtRG&K&W>fU4#C@tHwRBJ{9QZ5Dx!LRvi5|c+aGs4Ngo(Pt$HlmiN z+Vk?&rfE=&1D2oT{k3pnJ$^Owqd1QXGS)CbRB5#EV+=~vnS+o29GJ})mK2(}C##o_ zw{+xyp2`@Es89CmIt!Vt)u(Z`L7!0N$4qCkh!%mx&aEs3dWSP2WDwC|AU+I|JZ`;+ z1f~$7Fes3$`|kbWRz^AC2YeK&%eX*wkcqv`k!xtHj zOf$LB!^XdMpd!8WQ$i&@>M$jHBobPks1%x-5KC3sPQ|Aak}1&87u83SNoXwhaf@x_ zgtZ2eg+>($SN)umM-+iODgqUg-twKy6ri*TU#87S)3)}UYrbQTryo3F)YWh(#48sH z3IR!X78w#UI2m4gkh>;#@w{XTzTs^fxko$TxT1RuhJ4-_4m zu-7q6L_0Fned7li?b~^GE;LAAEUG2IM0G>~2=EIa2v9D_Ei zjHFHywtAtC99I5wER7)?4z#FO)BX0F$$Y+0CK-4C4)*)JriUfrd^S(8LM-aoZ4lBp|t*opg$y>X+Ob9iM)K`VHB-g1f z*&NSsMplA*snLJwOoPG=Pf1{*LKeew9smn5CtIibsqBw-|DJ}bq}2AK{OPdd zw6b4f(>;ie-xVI&Tm16j<6?LnOv>hc$R2#Ho}v{5SBLsC!w5JyrtbMk)H8@`3MUfV zsqgwo(dHK*KmMjHL`3L`ebsS7S9UUHhLjjw)16Axqpeow2G#!bC%7v{dU$cBXE@M~ z7=dQOFM>BGI)DM+`D|U>nO1~|mooz?mbC`~#iVf0NA?4^%n#RYY|ui^jsh0I`^9>g z7<>>69c-}tUb9=4mSMN?m{MTuiP4?)PHCO-K!E3S@x##^%@3H9MenU~4Z~}=t@Y2J ziC;GBqOK1)JGtr`*{!?v)O9{v3S75?_hxe(m|hz~2fa@NH^?>ZDEB4E-gUjty)P5h z{a=rgw~Gni!U_}1Y;}^1lbi6=?=3d{ zkuj$Fr>Ts#M@_1Rm+|bbyJP6H#gBq!3whY<%$i|aLy)Hn4bc4o6SrHHF}C-H`1`{d z@CzMB+e@x@dmeLD%1p)5Zm6;|S^*i=?J&~B;q;dU@O8#D6q)mg9ALtZO;CZn^R^^R z(IBelUjJ0jEB!f-FWij-+hEaB8j1)=(Q}5fqAiIkiz!Br#7Ky9d3SuUOvzgU8c85* ze2E2>TV<}7UGRu#8z63&XQPu-q9r)wf@)wT7Z$E^nYM`F={{_kuLG{Ko}6!Hggem?WM$)ud! z_X}qX-daqacY8Df^s)pkosmWa3XbbR*_m#HU4!;ip zp~m}?=^5nIPy*CM9C&ek_N3u|VhIBf?=F!nB_^2M!86cNcRE-WtGv&}1b>2W9-_27 z=g4s8ZhwgPE1Y=c@E~5nc4OdrcOU^UI1$6+I~wiOT0n*M)Jr|JD$IMEeBJ3U4K*)v^21|{Ah#B*6PL;yvdr#}a?M0@}@^bj01s%w0WIynW z8<9#vCp)oWtIxj6c?v$YrTZs5j~ynMW3o$zg1W%OPK0^}yxz%i(~IRX(dI*nkHO^4 z!68`%UwvoU#kwQ(F+e*iu?`rK2(3nEV7k{BJ)0VhMjZ`#leET*IN=cWl$J*rd}C1m zY177z;sAkaeR!ORkKP@gcR{LI+Q1({NzX5Z`76N6zceiat+&x>n3hZO$3H7aHhkP<&djECvWGEuH%fQ85$>c zIBAvQPOhb+x%BF+O1w{9wV3XnuLu3{lMNT%mR7MB!F>L#>Qo-%>7tKE@oE&^!JFhO z*T}P72k))6xYwyI>WbvlA=_RLV%yq&y12gdTpNC$8O9N)WcdrY{hDAqMq1DN^q8xh zklS>BZGsrx3Ml!q<88iJ4|tMJ4_lHnVVB1##Xw04)eNF3OM$vpU|(}Rp2BR^ zPytaefVvsv)fH6uRy-oTH4;)j+$(6&L6~?}O?CWaSNk6Lc}V&&SlA=Q=V|+c$L)YO zwZjOPqY=%*A*fYL%m!@SUO#&>=e}Fp@4mVnl=#h&@5%es`4Si2;JG`_3@baTMaKu3 zl3cp?g)xNKWyYlQX)~cde->SSpYx$=@}xn<$Z%e}r9d*nWVQVbd-MB7(rm6CROVt$ zrIO9j=B71g@r0*1Q!o-KiA)rShGD{OPbr^`Tnqxqij}no0=NBXFqS845L6)Lo@<8T zovnI`i-;=qOcwy1=E0>HTNfU5-#cSwxtc~thqb@0sAk~VfE}tF$vF~m%44ujtwR5* zI-W$Yq7=5Ik5_T_RjE`cmJtpGOkK)aG*-G7V+u6Ui?ooTu85{K-0r9fTu!OrNk=9F1#F7DR(Sop2PrxTr+m!-7KV2qDAsYUFsmy|tK-{tHwEeTUAX>vw^W z`ktG1g4|`TlZ>QnLj(6h1-K?>&ZmN$TqGT^$o|oY_2A&fHi9qL=J%aaBwj2LfN@Q1 zqp^>mi0&Q9r`t15eLMQZ>I}|SXrz*!>IuQ%acQ1iQNj?uD4U07yC|uokYQ4#hH>i5@6C-OJykXlQu?8bl zYBp#bgQ_RPgbM|nLKqcY3!tU%CMpIK(ox~mS#j!zX3jC$pr6#*TYlJ~iexe4ZLK#U zOlTl#G+u}8aSP|gvmXWm)s@CYj5gU1F75Fgzc3`1Mso8cmEx=+%+_hj!dxxHMIo*! z;g*t_ADMSmLusTD>C(9b2iYy7oGXdvrL`Q@0$0B6fqV8iXDmi|FAp*3_}BT2pxJpr z^v3#eBa(Zi5br$FqJI*w5rD+)^HyLtmM;~>8*Ty0DHO`N=$FsiW0i2o@yUD~QB)1* zUvB>v8C6q=W4Z$tpyWO@kj21Dg zr|GUhFJ;33sFcv~k{UZ@0`t8h$o~ zLH#^}iALjIhwg;2y|sysfkFSq;V?p*&& z|ACE#8RdN-TA(hh7?>2Uo5h>BW5U7S1@=|*Pc1n&$6iPIt zjh9weKP1~v8SoamPul2k3Nw>AKno8YhR~7HDKAHsP4s0PG9g4Elf{5oADMq(^!qK; zhL()>3!&cmT6|15joZzgOZu#nT|AC8xdbpqESJbn|0srVr@SjoMtxEhD1*chgsH*L z@2CbpoGSSh-byxx*Ap0yaQk`}i8_z$H_ni08bUo1YdVSL&rs)KP=tO_>M*6~D8WXdXAi+pYJ=(=hKuv=4F;QB2%z z#Idv#R!!WE_;TI&IbR}EZ1kFI~jh9{tGp+{hR z>A;A~@50pt_`XGcvl}L0NcT*3E z;@Q0HMd;}GFf5)#g(~d?<8;6xbIN%8S2uGZ|LX+G*%}kkbIZ*{JUg3`UJ4*R$hf~o zjYgeI--B-lPoYHa0iPaD72GFi$f5Y);6W;IRB~qxJrZ3~K4jn#!I)MzaZuR7M6U>k z4U@E6UHTBTK}n08N{F5^`KU}x9<4y=l?q`EWx)&)jWT+3KKhR6FeNzG${6nti9-HDa3J2l zF=+jc91FE5IBMUwt8H|8Gp6xD%h3`m`16h-gM7I!xIUe^-Uro zxK8Xtr{xMwU2-Q_WN7>~($D0p1m*XH?n!0(aR*g+VpUd;m;!aj-zzU#?q@}R^PyH7 z&7(+F@ha3js|Wl0y)!eJF57Nut+s!^Wq4XO?aRVp^^CLbzq`q&`lLVuTUy{$gGz;I z#0C#F1JX#`8t(Kh_>ZD+2(d=)*zphAJ#s{m?Xn|dSrbLA-;mv%&wL%gU4*n6gaYO| zy==5TQz8%uEv|U!KJh%@ObXI293f#Q8DuM8HyUHM=vtCf-{O*?{<{==Fdy2Zw zk5$-Qm7Iu35apl=8^c<8%_iWPkDX=zaz!+3>nQQ#wapFt}?I)KUj^l#^qI z?oTGN0OLsz!v(8|3!HhjD!0z1cPGGpVg82BbC5%opXzsdHb;I5 z_Wfx^ylp-X62P{@In^T1Xt0wqClA_XYCXizkn%rPYZ*|-y1)zraoS>?Yi?ueH;X56V-K(h>kk@ z$QLp^U&f(Vq7V{vGyzA{u@Y$;6H`!+h@z?w>zdxNoh?hl7`QuP!*Pw{GP~hC~a+?s1u(;==Ltr zO3@#Ztr&{?5Q4$>V!)=7K>KLu=ZbhI`Z^Tl!#}RB}J81d6 zq}1I*9x^!^9>Mcot~4s@FI`I2_Q$t}Ls){`StF|z8u0fDlxDMKnZmv0T%#MBayCs9 z*W;q1Nm$IdvK43W;GY7axbClVrBKK?rj{*{2*|Vz#t31;y=G4;&}ErlxD>z(=AL%k z?7EfWVRi;{h+6JI6xDY}&dnTR~{Z;{-N>qb=4cFoZ z%>DPSuV3f#ncbkY1roP;osbM4NBj4&DEL7FuP|`8hcfopk*H`&wCO8FHQXUm>9}9QaX&KW{H9W9n>G zA@DBKi5L#;usX}uY#3%B^kty9mVFZ{AoEk}w+|E;2gy7T_r5%y zHgMh-%V@ZoECPSlA5&SZ5Zkkzn2C%M6!{UksYpj>$>FMw-LLO>Ox86muk;;)5%iDn zwJ~5SH-9-o-|osE+v|o42kE9GIDydX52-avc+v^8uh;*<_Ix}5Ys8ve*j(_GKTueR zzT})M(>HVs1q@uU-_N;jQh*#69VEEu_O{jgrRgi%(7QRQ(5dcu5URDhaj09a7)1v{#gTD^|oK!2H?3l~lE%=S1f^@pR3F98q)&Fxtv07U3^bN_6EH zuJowUIVE9*o`Kab?T;x?Y~Gm3VgZe?Pd8Y6fwpbFFf)(cfkZBz>AREOF$_=bwCOrU z@%&sv>3rFjbbZTt#^BfjiyHFs$p~y1tm6`m<~?O%`UyD|KZta+*VkmMVKi42mD(pc z6lYIh;>Cpd?e^5;`uR!@6V;lmeKULiynp8q92P7`A|Vmi>EvcT38dalji~7AxloPa zuA&%uv4M!c^9@gfe(qZ0R}$X;PSM^R53g*BFA$q4=CME8;8(%}hK?f3UI!Qqf=Cn5 zza1A^A9pChVv+5OYS{`Kv+0ZwRRIW;z2G=ud2mnTZEHH)2}&~C#XiV z7WahnZw=KczKD`R`M6~qos*r_In_ai-8EB`m(UP5$8H5g9ruKNcRk`+cU_7^cARpc zbhE3Uaw~{m)7JH7%@!4@yT2?jv+h5teus?UxrrqU1kAQQ+p#&Qr7k8vJ~z&B*u@pp z@VSBoJtsAvAdB9k>|~pC_vEtC`LscjzQl)c@6f4wwAD0n?~Es`T!077F&X;s+eJI` zqD2&yIb8Q)kas8H_q>MFB!uC|t66SjQH+GZ@W{|etw~0 zEYq@Z_Pak}5_l`!MX~;f{GA#~SA}%*bhu)>W}I>$tE%PKvi*e+!`-R$!Qz0J9P58h zhZo^0pDLnl3;Hxx-F1@v!TR$sh(Q%c0nqA6gcaJKN`69YH%&=b#%IA!SFC#8y!H06(shcmS5Jq0~)ZeIwb`LrV{J4xtW8F5D zJB`%kZESz@MpQZ}sd>-m(1B6%E+r6MsI!LB>+;oL)WJDd{k zg*_YdswGffXFVl&#KrSnN2N~yH&*`B1D+M?ZH|!3*AvJg0_>HvJ$#t~8)FLUqJg%! zI})M5vP|C)>`eDJf-6wFZ6+Pz!upVLf|P~^21b~4Vl-6sNh+Bi`T0b~{=2+x14zc9 z$uW~OcA;nsCd6xA^CX1RFM>x$CKIr7mT=>Tly$HBgIT%+kEjXKkr#ir=h&RO%}@@a z)@_^r+{mv-)Ad_@0bxq2D*U)}&fZPc2F$B;0oc`1C;S}a_R(kgrnSbTcK+^ue-4fr zB~X|)CeD8IZI>S|L2e|^jDXx?t};FR%@*8XHvUEk4Y1Ge@Y9fJUyuPgR>(Lw^viHFX8sr>}cwMHM(61?h>M zlp%@Y`jmm1J#-wUxbFRuD@V-*f1dzvoII+|=<%FiO9FHog_R~K*=88{T$+{bSbaFw zMt?}o>u!D&4iIh248|Atfs@}KcjXD+gb&v7pS2*ENM=fD*jCVq^?>krE{YJ((1naO z){>u|FwO+aC=!yb*zBnW@xDje#i4tqE7|mPYom*G11LG0lai5*3Tk-J9Azq4YavT4+j?+XtNN0UsY!57~WIQ*JI<|UoZ%3}Zsk9}$qy1Lbe z4RJLb{-5H$GAgd6YcmiC5;V9Iw2?q?x1b@xy>Up;;4Xmx!KH&V1Z|*$1$PK84Z$@u zE=_QEhv|FY-0ywAS@UCN&8#&)di6S0wRi2>RlQH0I{SILgN_yN!2KC_aw7->`y_io zJoT~9zSakSMv-FnDgCXj6qs8wxiFcFmuHZEf5_T=vv&@mx-OtU`O>3*3};8sK{j1= zA)bKhc~b(%%Zs~>%5N{x>rMSBvE8a0rT}iA2e*RhSg@a)Qa8?th=r$nXamE*OH%%e zpMRd1UF3V{S6GPkWJtb^%kE23t1anFTbS9LEyYkx5^`S1wALBFeOAu+Xy=t_QORSA z*lR0_@wMi1b&aSiUOKk>#$EilAb+13t2Q^syg=hNl#gS19$J?4g}L%mL2cV8wzjra za?|~T3;xN6XehKwWon6{U&PO|wRH!#CIl)hx&ZoNvjCybYs-QGx(Ix2NcQd9LBiEF zr-JtxRj?6&e$6^T>)p?CB~hUqA44Abb2<0IUi|R-wgU8UHgyzd9Fu?#UJW>uWqm2g zd}r?RQGjk%T=JUS3d|#5A9FR$S2J2y!8ZHV7mhbB?w>fpGfbTG&3OjAz4-e}7eb$XqX-C4V1=mm<&mdK70kGPIuQq{LyFZN(~5bMu(Rks^g&eJxCg zBw15L+G*QfZMn7xVxFnqV11if^_f|0^EZK5KX}jV@Mjua+}3m$FEUcTc-lL0giqcE zos~0XI=FkLN@ec+3Fz4JPQQnaK9@3S0!dEVy-FN#tCJ3%cp%u%dhQ+8#Aqh}oYZaKZ}0Z@`e8FiJp z%hZ_Po(ONYDEp$HuPEQC?woOwQL1x`+yBN2gRn4JE%56P@GqrVFJp3_34n!T3iaYD z$1QR)v&wmg>bs~~xgNTX3pkkyo4p;tsq2O(m?wsbjC3))FnX4<=g*Mv^uo2fFN{$b z8@#PHI(Y97^iZPYY}r-^qQn(n{SGL9JJ3wWj;$X#7)!#7p(z7+28)!`bywnk1`F}V z$+*~@&xG_gDwwUo1cK9TKQmsr1#p5Jrtp3%C(QlQD zmG3AWZ=kE;+>pi@ip%x%ykoXx`rT*N2dc(RhDm@CZ*9$9i`#gsqUOTh{+u4@?~|9s z@DkbWvb%8%<}5Pz(x&!G2vwh*boqW}{A6L!X-a`9E+&V8hz*k>N9pBRM4(O-F*G^10e1-jlKYu>6}K-3HbMV z-m_o1D%fHDKYX<@;d>I;AuUog6n6Rb)qP6^pOqZEt5WRL=()dNerdBUnD3qm z$J1F)ed;9QH094OYoagP0kF!-WLFLu0Ebuc;!m7D<2fxZRL?@y5=x~mv7C7PM&mFx zhd8~>^z(t17h*TkYbBvFf4T%x37Ld+amz%myZee%w3DH8e4;ms;*WHHQ`pR>!SW0|u`a59+lJEE(Ll{$AsF zs0S$GRlZ7{6K>mTfr*a@9Ju6*2PMy;&V21`cU@$?@(DLB8Ej!x1SsVMv3=n+;j;}* zBxEl`NBmgM>&hIONvJ#4qs;~D47X&7A9awBh4s5O(q~Pv_Uf|ag$05op}$OtE5s2L z%FWi@uSnt}s95f3qT7svFP40sK6eFd_~_kI^hV=Te5`$El@Lf`RnNG5fZa#j?G;G;ubmnrnu*rQjZKHW?j>>IFL8&}qy`Zdm`+u5&YX`c$(VRt2z^q;{2 z%c|d;C-U`(Qu7w1Z$!uhLFiVax$#fed0rc#=M03k>QfyfCFsO6tBNPPo*WiyeJeba z>mQEc8y4>3JkuybxKe}Z1?4cF4A~pjJHkrq7uh#3eM$&{R`$@>$2bJE*RK`N(v~xv z1=P@sD%Zt&v*LA_th1PEZ0wT?l|<~?p>i|#27HhNiCpIotf zLltmiyWR&GD175JoBrC+BLz%hmj-v5>D)cxh^cL%?f#xvO~eB>Hy$8fj55t^d*x%n z@!{9A;+Q-5OkA;T;4R6%K8!2yK*EM5>5Sm~02s%6;Ju#I6S*p_`Ll1c}XW5&AROU4LYuRW86ue%Xz0wHQQ=tm#~C<(yS6RJKY>> zIO?G~I-O7(@Pu3CC&su{V1@=TXy@A0{@DMqGpI@CQp;HCUIN$7-_+|qxV{RhMf`Fv z?W`T=^RdbXM_0R7`J-mH2tSEtR(3>{xQyq=QWVcyi3TO>t*+$Bh})<3zut23{v{{7 z!mq2J?^9~q6=I8in#^arHX_4GK?>l~@F8YiSBxCNml7YO@t+ZKl>}=f6z6Co^j1t$ zcN(49EwgGRKbK&s4t)5=kqC4w*aA5+qcl3_c8HHp@^Unv0SAolb$W^4|7M~B7fVsF zXN*^L8kX1I!U2I(Cl{l5tQ7W5HQc{Fiz?f|VV&vIyrv>xds@r;l8?J=V&dz>VeX|D zr5I({@UBSFL%knSyV`W?W10%ZI12=uWCl!lQ&x={oQhM|hFgcg9Rs46+QEK^a-^2J zh|Mk<)JL&%DL(9HurjTbidAWSC$Hd@=CCuy4vj zE)oxU^L@q0xdYv*-UONI?4#tjNcufUXCV8TuIc-zy>UpUvw+Ni>zl?BaDB?izVpn` z3HW#$f5^_;voqOUrQ)2|57;+-vS%CW7G)n?n=&(@47zgvIhb;y;*O=_gnHnuH)>bO zorYHPSJhyalNv{cmJv}&%V3tS@43Gpa3uqgX14eKyk@+5V{QU_gBXrx&s|*r&XQQl z(iJXfVA1zWl_)*ky*jVy6oCnJ%nt0@=2?%_7my6Im0{K8^NN-Jk+1sSmLESEOqq9Q z3g>nkPfFog*I084u7~HakRyBAi%ymj<}mr!z_#>H&aQIaPfcSNT&eoB_7f+Ip90NG zE1?WJM8PDf@XsE0N)EOFBn0v8Q-$2!b_CYCWp5nJRfLFvk+JLYt&5(ClL!mFYU@*d z+pWVXn2A)u>6m(ciF@X3`5H;pR4I0F-4NaZhpDa2-!Ms4wUg4yKd?v+$#Rn6tONX! zxHsM>BR5qA?ssDv4bYAyW!bGCxA<)z4cDM>c2*=#QqA%I7jm-G(4}TDt)Ql~veV$i zdk-J<@(*A$(i#`rdT6y42^Q7=7g&@vO8}4|0D=pwTy<(t>JYQ-D_9hkdW2W>XY@z1 z3!HVZI&rmZIZEVpATtG8hCsKwGAmz4L?;C&6;pFxo)zq|NCm#CgZGg&m-~ygN*L>j zn;y0v?=AU1LK3?%5B+;97xvQB857-I% z0msttNLCp~7Pq(Qm1n@YyYZ2K$4!6zNp-;{R$E_^9D%PT7taA|OB1Ms*g>9ENgC;VLs zdA%Eu1ovs-DsyJ4tplP_qvSD|Ri{6q-M+Z<8*bHc_Om*hF$TA=Bu1j}!E1n)vcgWb zZE3WG>A*)=RKc33f8bhFfwQOoiwhEttmL_)J1|F9=gd*jQ`?#^u$A}SM3|i^^a=i;||J=j);e`ma+n(Qv(niR+DhJd36xhl zIhB0surTi$mbHF!Q*qr<%hvCrx>D=AY zL8|uW(F|Q1&xDxVqtcWii>+AIB~$#(y(X{6WDlC8J#qmTxth+QwT{yT2a! zkyIz{H@z+PwaG^Lwcn!EIP#d zCh1(s7Glv)0%?}mkW8YKS3XHiNlS|wN*AJvrof+5PR{hDc_&2eb#A-*a{x{{H0y4# z0A|D2F}E*y*B@eQpN$^dku@ToY;aQQVD6*Rp{!Sq<&@W3g9LHc4yGL(U$`g#8hG+)|2UWm~J-ty1}T$+~{HEKq`^`EsZNDX-zj!U(k zh(b|r%t2@3e{OJl(e_XpJktG?yZI5VdHZ7_iiYR`N_~ugua{?i<*Vmnj`gIeJH_R# zlyK9)mZL~bSSh7C4c{%BmZ&s8iw})ie}7h)S}V8}aTB$7yK4(8euLau^AQ&B+C}ZT z))tV|b6u6)8ei=+6glkjx6Zr#j)Pvu(G?uY0X_O2Bx0rNV&><%4MM)^=o$wNWe=IQv(z9u&zkng14l@|}F4*%(<=jn{{zxF!~r zSMKgL)W`ZBqZ3P8i+%^NH{31nh7%CsD5WbfGE=m`8qd6M-}Iy7Hi2Natb9jYQGngE zd}PY1O6-Cy0Z_nrZ6!(3H?7>+lU5+l_`a>=R^m>t1#h;16CU8vf3oanB1jzPBqf}yCZ9O9Bd@kj-F)W}=oN{<+Zj4}m_;_=kgZw-R?I-ra;?>_V zR#QKkIOf2ehS42JVxWhJp_@3ox9U#Ukydgl1ClN!G(#$V+6LbK;X&-~(a+d}X+w1MA#CM7dH(Qzz1bQa1KAc(`pCHeNkuL4QPo{y?%doL?+m!!Do}V1eE?s}Yw+aOMz3V=BA^U;GCrdlQTMta zsrv?(gpCc0nz!aVM8)exmEb3HGPM1Q=KKz!XC5ll9OA4fso3ltwS#;j+E#k4^1iP6 z;nyt&KmJ;BE zmREj?Sx8E6s)Ri-ZRarVzi?MzYsy12=;KIiOO6h+zt2yQE7nm7^3cl5ue-I&-6)U2 zruE|BEsHg}9djG_ZxPP44Xw~#U2UeqJjC)n2MHUhrc5?TG0;$NZ`(i$r*}$F*38t&X`ifl_|?-odU{~ zS5Tm*kq|MM*!v6e-FhS|EDP)nFEi$GUY7R1SnyI(QYsYxFwy_DpEL#UO2&fS(w&}F zWhw~69*<6v`mfh$V&@Ittnk0RF)h_nlc;rtXHE6t`PGb12?EPOq#sk_{!QcK%zU_$ zD6KMb%ieUZy+bMP{jvu{=M+b}yf4fyajF;<87VW7uQHUAaT?;gnG-&m_l9i3f}JM{ zl9cp$&gmlKu3KCbdeRISx0$ZUsT3U3$i#+ISZA0Ya&-I3>z8tle7B&d6Rp#lVUPrK zj%zhgIW>=sGL;-})KdK?;R=!ssTYU}CS~Jbr1d%6gn}4&d7mL6B;RX)>c@ZW2oWuB z+83=R{#j!jnZt03j8dtxLI#ewr_mNyj399fRW|EXgndRv#$V?*%ioL3zI)Q!An9kG zU!2c5rRT|TI9$yBr}L4cc6;5f5sx?qMw7lc>?TrM9^@P8PB9IL6tJKA%G}cW@g_}H zxY50rS+eu{(ihz{A5O7{+mj(jQ3SV1^Yktf9rvTwpl&t62zj&P0ErU>ddmy(e9S}A z0)Z&_tjvZpM7|0+WzA$NMo(tTguJEkUS=iXJ}cMc&>?x{*!kaWagJe9FH&-`Ri$Y{ zMl*HW9DE`$t!S8*Z4S7fk~q0R+lHJU1efqVeJO>|>c~wL0dwMR!{z+%D&L+IjT$3U zi5d<&pK1U#qdv7ia?=h*7@F7KPx1cGLv}9ttDB=lfOt@bGJ#i@hHY-B;{6*FvpkC~ zC}AN%<-8^C_b*!QT`{sED_hd4fuVwE$P#p z5sOZQJ{z<-0@V_C5E?8e955SNDKPm25=B(1>u#pUTvEsX6B0!dSd-n@@!!35=%&<; z+ycvSwcWZ_Yn8XYeI3$KCig3OF&>eKU#k1#wD8n!U@6q?-+WVl1(Hb}RPY3aWw4O-Nq91iwsB|Xx%<%X)FWM7yMy6@E*?`Q* z$!9saxzx;|FipRH0kj~+ocr2$d%=x=#@+6uk6H$r9GUj+Ea<@fOFccFbnTQ*L|aUZqBLk-tyhOqFp zD{DDc#-W+Uf04$rJRH~(v3FB7$U}K9$Wt1gpXMvdLqra2ek-OCHFAG}nG1y;&G(*Y zaP@0{s?Pz}U>*!wcjPVbXi3?X=DKA zCuIrfnwYF;cWMuLY5n6!BnjH5VkMeYlXcg4jhODv4z(3>+3<_!!;j^BJoPHNC&Ml) zSfsN#Gj;0ueUcmB8RL#s#=5A2NKrS6n$4ck$h?x03%LCTlDrHx^YHCtR3d(9Kl+~E z-h|m>g@RZ=4xO$o>U;siOiSIG)3BNXL$IVL>X*GUK#XWd?;~h*5;U4Wv^HHK*2Q_3 zdj9o?j?$dOlKyWm(iy9&izL5BrN^iMd^Y?uE-KpD>Mmj{GU8PIx!3;VSZDpi%Hg~M zuB14?Doiq_y;6d_pVdrk-X=z%4DqFKIe9iu2a``KCsVlT$}lZ+?a@rcl}T6npR+J=q5?SNd=+SO*JMX?{OO~s5>wnTk?FIT zu`#b=^i6(Oj{vy16kH4%0rJmvz%&~C%27`>*zwO%EV+7r$G^vXns~r~{hT_fG;kU{xKfH5r9 z@a4)kQtzV)CnWEVp0hLsY4ZbdZh~rWRjnBAUQ`w8?Ztj%!&)C(RklJK$AQJydYZhe zE$=f^>y=$GNN;Se+@1*!l}cjMaza6?bU=@w5q}lY_4y7c6L!>q7{Ol-30#QY!#E+3 zlUL!CIFY=j8y0oI@x9m!4|!xNVkYml%z-a>Ybw)qFt zV`Uh-(i^J2hX1;6-4py3;w`6#*4CH-gFq101|%*uy`Sf*MQv1^i};OoYfz3Qx7^ZG zx^BclirMx={qiCe7wjABlAQW04jhpc@Ax3N9PN59Uc+V-Q&wdef(rQznn3v|Ngw~uNRNtQK%Uu>SFiV3YAQMBU{^*k@! zq^E5$$!p%Tf+k^ z`!{uGAP!c;8^7KP$m2~z?Pih??iR9g@c`BYN`>5)Zd7Gdf#_v{w+=qjrkg&SQ3BQ) z?vI|tHsRE(ijx(@wPDq_I7?1B{=j%~?IFE?Z+y8NM|KD=ka|_!K+ajPCYM~@+4-u% zZ{eBI$wkW1dC6LXv$oSj+WpoT6pSy)X(b;VcKx;m`G?(EcJw--vGw`;B$8CdelxoSMa{exD@CDvF!r|%!L1g3`C-+M^- z7VyhzOnH7VdLZeE4M2HeiCVd({$sgT+P{R;I+?b!#>-Tw!Lq!O4D|N;Xn$5VX(_0?LVEt8pK24UQ2 zA;-svrW}=>b8`3bzRd+5ie6l)$1||Cs&3#XGy}UA?2i)SKs~1yCY@drv>0hL;VJhg zA+SecUt@H2p>HgW~ zU4B$<*ZCG_-Zl;g-1TzaF4Z!|K9iSKyDrPrXYlR&T*Wz%!q>jcsE;`jc%52^HD{jj^x^u}{F@|Zctx;&m-q%Z}*fTFY| zfJrn=9o#qor`kA~j|rKsW~DnS1$Cw6xg8#4a)g>b@}wr_i2qz$v;`nZG<0qNI5*W< z%s+nU*kYw|BJM!UV|Q=dqrF4*T98C>Y8Aok3daHG^+*b@eh#vkVWKn;dqePy?b>#c zw)x>+l&QO(sF5aIOEEKozLHZHEiBs)Lex(C_2IsL`mEv~=#M>HuSyKz z7dh|vmHRfZA@E;&=R?K#zc*=FT-<1#a{c@a8d6xq59xx4$>#kXpXuv6>dJdGD4^}p z&|Lm<-Q0nKnE~x9#O!L?4L9t4`Nv2xE~#Ifpp_)U?jPeug@@*Q#_=RDg%L5}ODECw z^>J=C%&So5&Cw!0mOCg&Sf4D%!xbZjc<{_nFxR$6lL<$H2&%ft90h|^n%|L@TwdGH zORfm=M-a4e87$>851|#6S4e+&)%-d?e_z@)oMn@#2*bn=pQhqzB3)}|(hI{w^r^Qu zSb>2O#8Mxc9}xzpcP%)f%)5{UZ>o=osJq+YV`IyH_}m-cT!?&K2{Q;&aM!Pq_NCsJ zm49yg^=GJrK~drw4AH4c?0}XAA&6G7pR(9H7AMw4doDlgv!Ihg&!T{bMzZ0&KWS+* z!#~v>irA&2UBJO_YeHFA@_lORe=lOil@U!x>XZDt6ZszlwRGaq`Bhr#{#S(5lreW= zo>1`yM$NWBbjaW}QJI+6SHPF|N_KPT1tu=M0p4eCZfjiGf<2>LSz!`x0 zj8J~}-ReK|#%*3m?%_$Eee+c&l>!HDNP9ar=P>$W!@j4HyK*2g2`RmH3BcgS(`@Z} zPsx_m-myxF-}(1U`_gcGaQR5jsqI4-k%`W9y%YV$$4zYD?wjfhQtt!b0ZyF7ve#8T9Eb>Gz#V1`ja>$h2|t)~onNONr#thmOf64XAfF zDQnu!izcB+Q+*yy$^kC%BYWVFL1y(aE7FP~ZVn8pTL@4=$zNLMr24$ON> z;1yPPrApiEO-$(Kzp8M=rLF|%_Y94MwiJyXE?9YL0`cALnfu?l%i>T7JRy+Z4guwp z50Itd_PQ7s0fEVK1}H-RkRZ3yy+Spa=%ULlZBt_Gf<+MjuBAU(p@mFR>ft}Wzv|)N zRUILM(9Q&yehn?+zN6_1H;$B*_rHByDt6Z6VU5$?cF;t1@D9{dfwB;bkJplH^XpYF zL1jByu1@;!llw&OjsCJqY>nK`Zi_S#!x1^4d#ywp%;>UM8`u@;mesWdUx;pwnDYMJ z*oP>Qppb0+mj9nQsgwVUh+-rr8sYU>hiqLuTqY>KvIa(l!p+#4F}}04(C`D$wDEzue+$s zvhMPN*J4isiG9Uxx=6!KIUGp=OnZ4aS8Jh?zz1!vnsTf1=9Ia=*Tx|Yza(VEh0PyK zWxw7bKHZ!_CzNrgNLlYIlllH_tg@Mg(y~2U6&C?|90Wqpw{4C%F_Y8qifcI!}E=$KD;J!kvHGb2#c6~)zSM85^3=rMgQ22AWqPcF$K;7-=%Q!%%?Fo3QiE?< zh6CMM(mS^3_->hpZC>RbL0+W2H=OJS)6I#pS6dnP**UXCKvm7=dGK3PsnT`(5WDN{@p-`EAT#&_U;G{ z+9@j!FzCeqZSzUIIr}Zt3JoZQN4G8Ip$n4Fg=^O?{dl#Q>M7WyzE$IuDo|KD(5w2| zL81ld`>`MB@}cZo-|PNXwP_}NcL>ajK>m$Z82<$f5-XlH9!sw3#o(SZK!;J3Y<^5zg6<7}{cWG8lv518f%cM!b1(n`fk zN2{_aSE@{HcNiQFRLdM4xC?~$Ho*Zh^m#7xQdo~VreMIHQ8oL zaMOJ~R(p>ruQp!qgzakQLyaW|?RJ+~-3t%CDBKHt_wQrb-!+0d82Z&ZcPN7E`*<)w z=Q~L%{ z?r}MLI;5aXz#iPX<(nzR_dUS=ihWiKbtrlqm}2l=i%}^YGE=@dB9)ykcu?W%j{qiEu>^T6NEvqYy6EO23y+c1&fr@_b3f5F1ZsU`5w2VNZ_s1+bW-uFJy{9BM zy=CKh_;R5O^%2BRs7Jl}me9H%UC*Qg{CZ0wu;Pgy7T_P)o6#l-OSwElr{X%%s{k3> zPdiwJG!3lA=kC-O<5{!UTPnD4nt*aMg>WJl!K71g!ya*GpXrkw4q#>pTd{v!zdV|t zF6VAov3{d`-}atm6+^g9d7)|m?!7O08=2P7E$#18T1h2|ZM>K|o!c%(6W+7tR**mD|w)N6n(L1(gr!k+aD5O8=o%b*YNxyB*7O%C`;csPlU3pgkFi52` z%hy9@=!iOe$54|nVm`+nM50EdTvpAbnz0QLFLPjrn@4z@%GSd216q>nu7BReo z!ixERZRhOd#x2&oIIccx#@?Y>iuYE+<)aDbG+g=SOo3FFUby~%;1^H8i&jUhev=kU zwX;SS=hli3+GX$5Zhcz(BkSbvC7b-m@8L&NM<^br^Nxw)p9kVb793YgK74AeRM262 zh~UQjYyLeLq`!PWijC_Wnw;<^NY&pBxpS3axt4|i^h~f`#S}zD!Z5P+1kr9(ZcD0o z_kdQyPVYejC9sPlB&%iOh?GZp(b?DQyKbJ~PpeDdka(RU&0<$J4x%N&zOksc#g+}} z1yI|b!~xZES@+CydQ0bFAGm=1#p4UM6ySGihEZHSFqThcQcH-K8Xb1Q_qFcQ~nWB;A;pfT9JtNM8j`< zrFLNLE&6z?_eD{?D`Bo=wqJ)Wq4c95{K!W#+p?~V4Ka<+mo1z8j~t~)kv$=$EgpNc z|MmU%1wo<0CwiS&()UQ2zl(ytK9XS%>tIK&iNAg*^y;yXWWH0r=>IDe{$0d_60D6A zqVq>wI-3%CEdWgV+pfRWBTXZJQv65!le7Tx+O7r={YMn_epJ8mvw99ILd0LVKa|`Cit&0~-rq~bQO3@Nb#~o*V%ST`NuZBUQgonw1 zheYMPq_->~K%#F}jaM)WjVu3vWX)Uhf9o>LMYL$675O&oOcMSnwPR@ioFQPomi@xw{|FEvXHG?51n|d2lOf2NrrqcDko&U| d(lBr7V!E%h(NC9T{`%LQ*Yc`zNXF*i{{hx|4`=`Y diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index f5a4f8724e..52bb75dd37 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -31,24 +31,7 @@ about things you want to implement. People proficient is certain areas of Scala by simply posting a message. But the most efficient way to connect is to cc your message to one of the go-to persons in your area. Here's the list of people (Github usernames and real-life names) and their specialties: - library: @phaller (Philipp Haller), @axel22 (Aleksandar Prokopec -- concurrent & collection) - specialisation: @axel22 (Aleksander Prokopec), @vladureche (Vlad Ureche), @dragos (Iulian Dragos) - named / default args, annotations, plugins: @lrytz (Lukas Rytz) - macros, reflection, manifests, type tags: @xeno-by (Eugene Burmako), @cvogt (Christopher Vogt) - type checker, inference: @odersky (Martin Odersky), @adriaanm (Adriaan Moors) - language specification, string interpolation, value classes: @odersky (Martin Odersky) - new pattern matcher, implicit search: @adriaanm (Adriaan Moors) - partest, Continuations Plugin: @phaller (Philipp Haller) - error handling, lazy vals: @hubertp (Hubert Plociniczak) - backend: @magarciaEPFL (Miguel Garcia), @gkossakowski (Grzegorz Kossakowski), @dragos (Iulian Dragos) - repl, compiler performance: @paulp (Paul Phillips) - swing: @ingoem (Ingo Maier) - scaladoc: @vladureche (Vlad Ureche) - optimizer: @vladureche (Vlad Ureche), @magarciaEPFL (Miguel Garcia) - build: @jsuereth (Josh Suereth) - random compiler bugs: @lrytz, @adriaanm, @hubertp - documentation: @heathermiller (Heather Miller) - cps: @TiarkRompf (Tiark Rompf) +{% include maintainers.html %} Martin is the one who submitted the string interpolation proposal and implemented this language feature for Scala 2.10.0. (TODO: how to choose a mailing list) @@ -56,9 +39,9 @@ Therefore now I'm going to [the scala-user mailing list](http://groups.google.co about my issue. Note that I put Martin in the cc list of the email. If I didn't do that, he would probably miss it in a bunch of emails, which get posted to scala-user every day. -![Posting to scala-user](/contribute/01-post.png) - -![Response from Martin](/contribute/02-post.png) +

Posting to scala-user
+
+
Response from Martin
Now when I have the approval of the feature's author, I'll get to work! @@ -75,7 +58,7 @@ Log into [GitHub](http://github.com/), go to [https://github.com/scala/scala](ht button at the top of the page. This will create your own copy of our repository that will serve as a scratchpad for your hackings. If you're new to Git, don't be afraid of messing it up - there is no way you can corrupt our repository. -![Fork scala/scala](/contribute/03-fork.png) +
Fork scala/scala
### Clone ### @@ -329,11 +312,12 @@ This part is very easy and enjoyable. Navigate to your branch in Github (for me and click the pull request button to submit your patch as a pull request to Scala. If you've never submitted patches to Scala, you will need to sign the contributor license agreement, which [can be done online](http://typesafe.com/contribute/cla/scala) within a few minutes. -![Submit a pull request](/contribute/04-submit.png) +
Submit a pull request
### Discuss ### After the pull request has been submitted, you need to pick a reviewer (probably, the person you've contacted in the beginning of your workflow) and be ready to elaborate and adjust your patch if necessary. I picked Martin, because we had such a nice chat on the mailing list: -![Assign the reviewer](/contribute/05-review.png) +
SAssign the reviewer
+ From 42987ddbaa2ad4e53ca1f2a05cbcf961040b881b Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Sun, 3 Mar 2013 14:49:30 +0100 Subject: [PATCH 0012/3075] Fixes to the wording in the hacker guide. Just trying to clean up and fill in holes in the hacker guide. Review @xeno_by --- contribute/hacker-guide.md | 47 +++++++++++++++++++------------------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 52bb75dd37..db7b64a820 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -5,45 +5,46 @@ title: Scala hacker guide **Eugene Burmako** -This guide is intended to help you get from an idea of fixing a bug or implementing a new feature -to a nightly and, ultimately, to a production release of Scala incorporating your idea. Being able to -influence a programming language of your choice is amazing, and I'm excited to demonstrate that it's easier -than one might think. +This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea. + +This guide covers the entire process, from the conception of your idea or bugfix to the point where it is merged into Scala. Throughout, we will use a running example of an idea or bugfix one might wish to contribute. ### The running example ### -I like string interpolation a lot. Doing debug prints with interpolators introduced in Scala 2.10.0 -is so enjoyable that I often wonder how we ever lived without that feature. However there's an annoying issue -which I occasionally stumble upon: the formatting string interpolator `f` [does not support](https://issues.scala-lang.org/browse/SI-6725) -new line tokens `%n`. I could go the mailing list, ask to fix this bug and then indefinitely -wait for the fix. Or I could instead patch Scala myself and get the fix in a subsequent release (nightly builds get produced, well, every -night, minor releases are pumped every few months and major releases happen once a year). The latter option sounds cool, so let's see -how it works! +Let's say that you particularly enjoy the new string interpolation language feature introduced in Scala 2.10.0, and you use it quite heavily. + +Though, there's an annoying issue +which you occasionally stumble upon: the formatting string interpolator `f` [does not support](https://issues.scala-lang.org/browse/SI-6725) +new line tokens `%n`. + +One approach would be to go the mailing list, request that the bug be fixed, and then to wait indefinitely for the fix arrive. Another approach would be to instead patch Scala oneself, and to submit the fix to the Scala repository in hopes that it might make it into a subsequent release. + +**_Of note_**: There are several types of releases/builds. Nightly builds are produced every night at a fixed time. Minor releases happen once every few months. Major releases typically happen once per year. ### 1. Connect ### -Sometimes it's appealing to hack alone and not to have to interact with humans, but in the context of such a big project like Scala -this might not be the very best idea. Our community has people who spent years accumulating knowledge about Scala. They might provide -unique insights and, what's even better, direct assistance in their areas. +Sometimes it's appealing to hack alone and not to have to interact with others out of fear, or out of comfort. However, in the context a big project such as Scala, +this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide +unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. -Typically bug fixes and especially new features beging with posting to one of [our mailing lists](TODO) to find out how people feel +Typically bug fixes new features start out as an idea or an experiment posted on one of our mailing lists [our mailing lists]({{ site.baseurl }}/community/index.html#mailing_lists) to find out how people feel about things you want to implement. People proficient is certain areas of Scala usually monitor mailing lists, so you'll often get some help -by simply posting a message. But the most efficient way to connect is to cc your message to one of the go-to persons in your area. Here's the -list of people (Github usernames and real-life names) and their specialties: +by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. + +This is the list of language features/libraries along with their maintainers's full names and github usernames: {% include maintainers.html %} -Martin is the one who submitted the string interpolation proposal and implemented this language feature for Scala 2.10.0. -(TODO: how to choose a mailing list) -Therefore now I'm going to [the scala-user mailing list](http://groups.google.com/group/scala-user) and will post a topic -about my issue. Note that I put Martin in the cc list of the email. If I didn't do that, he would probably miss it in a bunch -of emails, which get posted to scala-user every day. +Since Martin is the person who submitted the string interpolation Scala Improvement Proposal and implemented this language feature for Scala 2.10.0, he might be interested in learning of new bugfixes to that feature. + +As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the scala-internals mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, +in this example, we post to the [the scala-user mailing list](http://groups.google.com/group/scala-user)about our issue.
Posting to scala-user

Response from Martin
-Now when I have the approval of the feature's author, I'll get to work! +Now that we have the approval of the feature's author, we can get to work! ### 2. Set up ### From 2ce31f91a6ec123bd020250ab5987b1894775881 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Sun, 3 Mar 2013 19:22:57 +0100 Subject: [PATCH 0013/3075] Continuing to tweak the hacker guide, and to add info where needed. Review @xeno_by --- contribute/hacker-guide.md | 100 +++++++++++++++++++++---------------- 1 file changed, 57 insertions(+), 43 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index db7b64a820..4f8ca20604 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -9,7 +9,7 @@ This guide is intended to help you get from an idea of fixing a bug or implement This guide covers the entire process, from the conception of your idea or bugfix to the point where it is merged into Scala. Throughout, we will use a running example of an idea or bugfix one might wish to contribute. -### The running example ### +## The Running Example Let's say that you particularly enjoy the new string interpolation language feature introduced in Scala 2.10.0, and you use it quite heavily. @@ -21,7 +21,7 @@ One approach would be to go the mailing list, request that the bug be fixed, and **_Of note_**: There are several types of releases/builds. Nightly builds are produced every night at a fixed time. Minor releases happen once every few months. Major releases typically happen once per year. -### 1. Connect ### +## 1. Connect Sometimes it's appealing to hack alone and not to have to interact with others out of fear, or out of comfort. However, in the context a big project such as Scala, this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide @@ -46,26 +46,27 @@ in this example, we post to the [the scala-user mailing list](http://groups.goog Now that we have the approval of the feature's author, we can get to work! -### 2. Set up ### +## 2. Set up Hacking Scala begins with creating a branch for your work item. To develop Scala we use [Git](http://git-scm.com/) and [GitHub](http://github.com/). This section of the guide provides a short walkthrough, but if you are new to Git, -it probably makes sense to familiarize with Git first. We recommend the [Git Pro](http://git-scm.com/book/en/) +it probably makes sense to familiarize yourself with Git first. We recommend the [Git Pro](http://git-scm.com/book/en/) online book. -### Fork ### +### Fork Log into [GitHub](http://github.com/), go to [https://github.com/scala/scala](https://github.com/scala/scala) and click the `Fork` -button at the top of the page. This will create your own copy of our repository that will serve as a scratchpad for your hackings. -If you're new to Git, don't be afraid of messing it up - there is no way you can corrupt our repository. +button in the top right corner of the page. This will create your own copy of our repository that will serve as a scratchpad for your work. + +If you're new to Git, don't be afraid of messing up-- there is no way you can corrupt our repository.
Fork scala/scala
-### Clone ### +### Clone If everything went okay, you will be redirected to your own fork at `https://github.com/username/scala`, where `username` is your github user name. You might find it helpful to read [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/), -which covers some of the things that will follow below. Then clone your repository by running something like the following on the command line: +which covers some of the things that will follow below. Then, _clone_ your repository (_i.e._ pull a copy from github to your local machine) by running the following on the command line: 16:35 ~/Projects$ git clone https://github.com/xeno-by/scala Cloning into 'scala'... @@ -76,25 +77,25 @@ which covers some of the things that will follow below. Then clone your reposito Resolving deltas: 100% (182155/182155), done. This will create a local directory called `scala`, which contains a clone of your own copy of our repository. The changes that you make -in this directory can be propagated back to your copy and, ultimately, pushed into Scala. +in this directory can be propagated back to your copy hosted on github and, ultimately, pushed into Scala when your patch is ready. -### Branch ### +### Branch Before you start making changes, always create your own branch. Never work on the `master` branch. Think of a name that describes -the changes you plan on doing. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: +the changes you plan on making. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: bug fixes and new features. * For bug fixes, use `issue/NNNN` for bug NNNN from the [Scala issue tracker](https://issues.scala-lang.org/). -* For new feature use `topic/XXX` for feature XXX. Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaladoc-diagrams` instead of just `topic/diagrams`. +* For new feature use `topic/XXX` for feature XXX. Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaladoc-diagrams` instead of just `topic/diagrams` would be a good branch name. -Since I'm going to fix an existing bug [SI-6725](https://issues.scala-lang.org/browse/SI-6725), I'll create a branch named `ticket/6725`. +Since in our example, we're going to fix an existing bug [SI-6725](https://issues.scala-lang.org/browse/SI-6725), we'll create a branch named `ticket/6725`. 16:39 ~/Projects/scala (master)$ git checkout -b ticket/6725 Switched to a new branch 'ticket/6725' If you are new to Git and branching, read the [Branching Chapter](http://git-scm.com/book/en/Git-Branching) in the Git Pro book. -### Build ### +### Build The next step after cloning your fork is setting up your machine to build Scala. The definitive guide on building Scala is located at [https://github.com/scala/scala/blob/master/README.rst](https://github.com/scala/scala/blob/master/README.rst), but here's the summary: @@ -103,10 +104,10 @@ The next step after cloning your fork is setting up your machine to build Scala. * The build tool is `ant`. * The build runs the `pull-binary-libs.sh` script to download bootstrap libs. This requires `bash` and `curl`. * The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. -* Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter them. +* Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. -In a nutshell, building Scala is as easy as running `ant` in the root of your clone. Be prepared to wait for a while - a full rebuild -takes 8+ minutes depending on your machine. Incremental builds are usually within 30-120 seconds range (again, your mileage might vary +Building Scala is as easy as running `ant` in the root of your cloned repository. Be prepared to wait for a while-- a full "clean" build +takes 8+ minutes depending on your machine (and up to 30 minutes on older machines with less memory). Incremental builds are usually within 30-120 seconds range (again, your mileage might vary with your hardware). 16:50 ~/Projects/scala (ticket/6725)$ ant @@ -134,34 +135,30 @@ with your hardware). BUILD SUCCESSFUL Total time: 9 minutes 41 seconds -### IDE ### +### IDE There's no single editor of choice for working with Scala sources, as there are trade-offs associated with each available tool. -Both Eclipse and Intellij IDEA have Scala plugins, which are known to work with our codebase. Here are +Both Eclipse and IntelliJ IDEA have Scala plugins, which are known to work with our codebase. Here are [instructions for Eclipse](https://github.com/scala/scala/blob/master/src/eclipse/README.md) and [instructions for Intellij](https://github.com/scala/scala/blob/master/src/intellij/README). Both of those Scala plugins provide -navigation, refactoring and error reporting functionality as well as integrated debugging. Unfortunately this comes at a cost -of occasional sluggishness. +navigation, refactoring and error reporting functionality as well as integrated debugging. -On the other hand, lightweight editors such as Emacs, Sublime or jEdit provide unparalleled scriptability and performance, while +There also exist lighter-weight editors such as Emacs, Sublime or jEdit which provide unparalleled are faster and much less memory/compute-intensive to run, while lacking semantic services and debugging. To address this shortcoming, they can integrate with ENSIME, a helper program, which hosts a resident Scala compiler providing some of the features implemented in traditional IDEs. However despite -having significantly matured over the last year, its support for our particular codebase is still far from being great. +having significantly matured over the last year, support for our particular code base is still being improved, and is not as mature as for Eclipse and IntelliJ. -We know of both novices and experienced Scala hackers who've been effective with using both IDEs and lightweight editors. -Therefore it's hard to recommend a particular tool here, and your choice should boil down to your personal preferences. +Due to the immense variability in personal preference between IDE/editor experience, it's difficult to recommend a particular tool, and your choice should boil down to your personal preferences. -### 3. Hack ### +## 3. Hack When hacking on your topic of choice, you'll be modifying Scala, compiling it and testing it on relevant input files. Typically you would want to first make sure that your changes work on a small example and afterwards verify that nothing break by running a comprehensive test suite. -I'm going to start by creating a `sandbox` directory (this particular name doesn't bear any special meaning - it's just a tribute to -my first days in Scala team), which will hold a single test file and its compilation results. First I make sure that -[the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by throwing together a simple test and feeding it -into the Scala distribution assembled by ant in `build/pack/bin`. +We'll start by creating a `sandbox` directory (this particular name doesn't bear any special meaning), which will hold a single test file and its compilation results. First, let's make sure that +[the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by putting together a simple test and compiling and running it with the Scala compiler that we built using `ant`. The Scala compiler that we just built is located in `build/pack/bin`. 17:25 ~/Projects/scala (ticket/6725)$ mkdir sandbox 17:26 ~/Projects/scala (ticket/6725)$ cd sandbox @@ -176,36 +173,53 @@ into the Scala distribution assembled by ant in `build/pack/bin`. 17:28 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test 1%n1 // %n should've been replaced by a newline here -### Implement ### +### Implement -There's not much to be said about this step, which is bread & butter software development. +Now, implement your bugfix or new feature! Here are also some tips & tricks that have proven useful in Scala development: -* If after introducing changes or updating your clone, you're getting `AbstractMethodError` or other linkage exceptions, +* If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, try doing `ant clean build`. Due to the way how Scala compiles traits, if a trait changes, then it's sometimes not enough to recompile - just that trait, but it might also be necessary to recompile its users. Ant is not smart enough to do that, which might lead to - very strange errors. Full rebuilds fix the problem. Fortunately that's rarely necessary, because full rebuilds take significant time. + just that trait, but it might also be necessary to recompile its users. The `ant` tool is not smart enough to do that, which might lead to + very strange errors. Full rebuilds fix the problem. Fortunately that's rarely necessary, because full rebuilds take a lot of time-- the same 8-30 minutes as mentioned above. * Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts to launch Scala from `build/quick/classes`. * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. -Docs. Right, the docs. The documentation about internal workings of the compiler is scarce, and most of the knowledge is passed around -in the form of folklore. However the situation is steadily improving. Here are the resources that might help: +### Documentation + +There are several areas that one could contribute to-- there is the Scala library, the Scala compiler, and other tools such as Scaladoc. Each area has varying amounts of documentation. + +##### The Scala Library + +Contributing to the Scala standard library is about the same as working on one of your own libraries. Beyond the Scala collections hierarchy, there are no complex internals or architectures to have to worry about. Just make sure that you code in a "don't-repeat-yourself" (DRY) style, obeying the "boy scout principle" (i.e. make sure you've left something cleaner than you found it.) + +If documentation is necessary for some trait/class/object/method/etc in the Scala standard library, typically maintainers will include inline comments describing their design decisions or rationale for implementing things the way they have, if it is not straightforward. + +If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections](http://docs.scala-lang.org/overviews/core/architecture-of-scala-collections.html), as well as a larger more general [Scala collections Guide](http://docs.scala-lang.org/overviews/core/collections.html) covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide](http://docs.scala-lang.org/overviews/core/parallel-collections.html). (TODO double check these links!) + +##### The Scala Compiler + +Documentation about the internal workings of the Scala compiler is scarce, and most of the knowledge is passed around by email (scala-internals mailing list), ticket, or word of mouth. However the situation is steadily improving. Here are the resources that might help: * [Compiler internals videos by Martin Odersky](TODO) are quite dated, but still very useful. In this three-video - series Martin explains inner workings of the part of the compiler, which has recently become Scala reflection API. + series Martin explains the general architecture of the compiler, and the basics of the front-end, which has recently become Scala reflection API. +* [Reflection documentation](http://docs.scala-lang.org/overviews/reflection/overview.html) describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that + are used to represent Scala programs and operations defined on then. Since much of the compiler has been factored out and made accessible via the Reflection API, all of the fundamentals needed for reflection are the same for the compiler. * [Reflection and Compilers by Martin Odersky](http://channel9.msdn.com/Events/Lang-NEXT/Lang-NEXT-2012/Reflection-and-Compilers), a talk - at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the reflection API. -* [Reflection documentation](http://docs.scala-lang.org/overviews/reflection/overview.html) describes fundamental data structures that - are used to represent Scala programs and operations defined on then. + at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the architecture of the reflection API. * [Scala compiler corner](http://lampwww.epfl.ch/~magarcia/ScalaCompilerCornerReloaded/) contains extensive documentation about - most of the post-typer phases in the Scala compiler. + most of the post-typer phases (i.e. the backend) in the Scala compiler. * [scala-internals](http://groups.google.com/group/scala-internals), a mailing list which hosts discussions about the core internal design and implementation of the Scala system. +##### Other Projects + +Tools like Scaladoc also welcome contributions. Unfortunately these smaller projects have less developer documentation. In these cases, the best thing to do is to directly explore the code base (which often contains documentation as inline comments) or to write to the appropriate maintainers for pointers. + ### Interlude ### To fix [the bug I'm interested in](https://issues.scala-lang.org/browse/SI-6725) I've tracked the `StringContext.f` interpolator From 023f0b01cdca944b429348820aeed9de4766521b Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Mon, 4 Mar 2013 23:36:44 -0500 Subject: [PATCH 0014/3075] Final tweaks to the hacker guide. Mostly wording --- contribute/hacker-guide.md | 45 +++++++++++++++++++------------------- 1 file changed, 22 insertions(+), 23 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 4f8ca20604..bd7ac60e71 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -182,7 +182,7 @@ Here are also some tips & tricks that have proven useful in Scala development: * If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, try doing `ant clean build`. Due to the way how Scala compiles traits, if a trait changes, then it's sometimes not enough to recompile just that trait, but it might also be necessary to recompile its users. The `ant` tool is not smart enough to do that, which might lead to - very strange errors. Full rebuilds fix the problem. Fortunately that's rarely necessary, because full rebuilds take a lot of time-- the same 8-30 minutes as mentioned above. + very strange errors. Full-rebuilds fix the problem. Fortunately that's rarely necessary, because full-rebuilds take a lot of time-- the same 8-30 minutes as mentioned above. * Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts to launch Scala from `build/quick/classes`. * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how @@ -220,10 +220,10 @@ Documentation about the internal workings of the Scala compiler is scarce, and m Tools like Scaladoc also welcome contributions. Unfortunately these smaller projects have less developer documentation. In these cases, the best thing to do is to directly explore the code base (which often contains documentation as inline comments) or to write to the appropriate maintainers for pointers. -### Interlude ### +### Interlude -To fix [the bug I'm interested in](https://issues.scala-lang.org/browse/SI-6725) I've tracked the `StringContext.f` interpolator -down to a macro implemented in `MacroImplementations.scala`. There I noticed that the interpolator only processes conversions, +To fix [the bug we're interested in](https://issues.scala-lang.org/browse/SI-6725). Let's say we've tracked the `StringContext.f` interpolator +down to a macro implemented in `MacroImplementations.scala`, and there we notice that the interpolator only processes conversions, but not tokens like `%n`. Looks like an easy fix. 18:44 ~/Projects/scala/sandbox (ticket/6725)$ git diff @@ -242,7 +242,7 @@ but not tokens like `%n`. Looks like an easy fix. start = idx + 1 } -After I applied the fix and running `ant`, my simple test case in `sandbox/Test.scala` started working! +After applying the fix and running `ant`, our simple test case in `sandbox/Test.scala` started working! 18:51 ~/Projects/scala/sandbox (ticket/6725)$ cd .. 18:51 ~/Projects/scala (ticket/6725)$ ant @@ -266,7 +266,7 @@ After I applied the fix and running `ant`, my simple test case in `sandbox/Test. 1 1 // no longer getting the %n here - it got transformed into a newline -### Verify ### +### Verify Now to make sure that my fix doesn't break anything I need to run the test suite using the `partest` tool we wrote to test Scala. Read up [the partest guide](/contribute/partest-guide.html) to learn the details about partest, but in a nutshell you can either @@ -283,26 +283,25 @@ run `ant test` to go through the entire test suite (30+ minutes) or use wildcard testing: [...]/files/run/stringinterpolation_macro-run.scala [ OK ] All of 6 tests were successful (elapsed time: 00:00:08) -### 4. Publish ### +## 4. Publish After development is finished, it's time to publish the code and submit your patch for discussion and potential inclusion into Scala. -In a nutshell this involves: 1) making sure that your code and commit messages are of high quality, 2) clicking a few buttons in the -Github interface, 3) assigning one or more reviewers which will look through your pull request. Now all that in more details. +In a nutshell, this involves: -### Commit ### + 1. making sure that your code and commit messages are of high quality, + 2. clicking a few buttons in the Github interface, + 3. assigning one or more reviewers which will look through your pull request. + + Let's go into each of these points in more detail. + +### Commit The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. There are two things you should know here: -1) Commit messages are frequently the only way to communicate with the authors of the code written a few years ago. Therefore, we give them -big importance. Be creative and eloquent - the more context your provide for the change you've introduced, the bigger the probability that -some future maintainer will get you right. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) -for more information about the desired style of your commits. + 1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) for more information about the desired style of your commits. -2) Clean history is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. -For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, -you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against -the latest revision of `master`. + 2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on Github. @@ -321,18 +320,18 @@ Once you are satisfied with your work, synced with `master` and cleaned up your To https://github.com/xeno-by/scala * [new branch] ticket/6725 -> ticket/6725 -### Submit ### +### Submit -This part is very easy and enjoyable. Navigate to your branch in Github (for me it was `https://github.com/xeno-by/scala/tree/ticket/6725`) +Now, we must simply submit our proposed patch. Navigate to your branch in Github (for me it was `https://github.com/xeno-by/scala/tree/ticket/6725`) and click the pull request button to submit your patch as a pull request to Scala. If you've never submitted patches to Scala, you will need to sign the contributor license agreement, which [can be done online](http://typesafe.com/contribute/cla/scala) within a few minutes.
Submit a pull request
-### Discuss ### +### Discuss -After the pull request has been submitted, you need to pick a reviewer (probably, the person you've contacted in the beginning of your -workflow) and be ready to elaborate and adjust your patch if necessary. I picked Martin, because we had such a nice chat on the mailing list: +After the pull request has been submitted, you need to pick a reviewer (usually the person you've contacted in the beginning of your +workflow) and be ready to elaborate and adjust your patch if necessary. In this example, we picked Martin, because we had such a nice chat on the mailing list:
SAssign the reviewer
From 36ce3092e825d72b9b2af3b68b2f78dfd7c04b3f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 7 Mar 2013 11:54:07 +0100 Subject: [PATCH 0015/3075] Fixed a build error Maruku did not like that big HTML comment, for some reason. --- contribute/bug-reporting-guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index a60fb15b07..345dc03034 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -10,7 +10,7 @@ The Scala project tracker is located at: > [http://issues.scala-lang.org](http://issues.scala-lang.org) - +{% endcomment %} From 3a415b797a650cfd06f80b1d771822651fed0866 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 7 Mar 2013 18:27:20 +0100 Subject: [PATCH 0016/3075] First shot at a 'community tickets' feed fetched from JIRA. --- contribute/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/contribute/index.md b/contribute/index.md index a92c5f37cc..14a4117631 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -44,6 +44,8 @@ Typically the scaladoc tool provides a low entry point for new committers, so it On the Scala bug tracker you will find many bugs that are [marked as good starting points to contributing ("community" bugs)](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12111) or [that are not currently assigned](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12112) and that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. +
+
### I have this idea that I'd like to add to Scala, how do I start? From af5a53cac3e5dc217f2c73f662a95374833ab6e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Fri, 8 Mar 2013 11:14:27 +0100 Subject: [PATCH 0017/3075] Added a dynamic pager in the community tickets feed. --- contribute/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/contribute/index.md b/contribute/index.md index 14a4117631..05696f5165 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -44,7 +44,8 @@ Typically the scaladoc tool provides a low entry point for new committers, so it On the Scala bug tracker you will find many bugs that are [marked as good starting points to contributing ("community" bugs)](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12111) or [that are not currently assigned](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12112) and that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. -
+{% comment %} Keep the space in the @@ -40,11 +32,10 @@ title: Contributing guide ### Why contribute a patch to Scala? Just to name a few common reasons: - - contributing a patch is the best way to make sure your desired changes will be available in the next Scala version - - Scala is written in Scala, so going through the source code and patching it will improve your Scala-fu - - last but not least, you will make it into the [Scala Contributor Hall of Fame](scala-fame.html). -
+* contributing a patch is the best way to make sure your desired changes will be available in the next Scala version +* Scala is written in Scala, so going through the source code and patching it will improve your Scala-fu +* last but not least, you will make it into the [Scala Contributor Hall of Fame](scala-fame.html). The main Scala project consists of the standard Scala library, the Scala reflection and macros library, the Scala compiler and the Scaladoc tool. This means there's plenty to choose from when deciding what to work on. @@ -57,100 +48,37 @@ If you are interested in contributing code, we ask you to sign the which allows us to ensure that all code submitted to the project is unencumbered by copyrights or patents. -
- -### I have this idea that I'd like to add to Scala, how do I start? - -The first step to making a change is to discuss it with the community at large, to make sure everyone agrees on the idea -and on the implementation plan. Starting point ("community") bugs are usually uncontroversial, so you can jump right -ahead to hacking the scala source tree and filing a pull request. For larger changes it is best to announce the change -on the [scala-internals](http://groups.google.com/group/scala-internals) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list. - -Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against -the Scala project source tree. The [hacker guide](hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. - - diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 08f5d40c09..ecdbd2fc27 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -30,7 +30,7 @@ Typically bug fixes and new features start out as an idea or an experiment poste about things you want to implement. People proficient in certain areas of Scala usually monitor mailing lists, so you'll often get some help by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. -This is the list of language features/libraries along with their maintainers's full names and GitHub usernames: +This is the list of language features/libraries along with their maintainer's full names and GitHub usernames: {% include maintainers.html %} @@ -182,7 +182,7 @@ Here are also some tips & tricks that have proven useful in Scala development: just that trait, but it might also be necessary to recompile its users. The `ant` tool is not smart enough to do that, which might lead to very strange errors. Full-rebuilds fix the problem. Fortunately that's rarely necessary, because full-rebuilds take a lot of time-- the same 8-30 minutes as mentioned above. * Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, - some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts ([here](https://github.com/adriaanm/binfu/blob/master/scafu.sh) are some examples to get you strarted) to launch Scala from `build/quick/classes`. + some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts ([here](https://github.com/adriaanm/binfu/blob/master/scafu.sh) are some examples to get you started) to launch Scala from `build/quick/classes`. * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use `showRaw` to get the `AST` representation. @@ -415,6 +415,6 @@ workflow) and be ready to elaborate and adjust your patch if necessary. In this ## Merge -After your reviewer is happy with your code (usually signalled by a LGTM — “Looks good to me”), your job is done. +After your reviewer is happy with your code (usually signaled by a LGTM — “Looks good to me”), your job is done. Note that there can be a gap between a successful review and the merge, because not every reviewer has merge rights. In that case, someone else from the team will pick up your pull request and merge it. So don't be confused if your reviewer says “LGTM”, but your code doesn't get merged immediately. diff --git a/contribute/index.md b/contribute/index.md index 338ff06a06..433c579620 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -11,21 +11,56 @@ everyone make things better? ## How to help? -### Reporting bugs +That depends on what you want to contribute. Below are some getting started resources for different contribution domains. Please read all of the documentation and follow all the links from the topic pages below before attempting to contribute, as many of the questions you have will already be answered. -See our [bug reporting guide](./bug-reporting-guide.html) to learn -how to efficiently report a bug. +### Contribute -### Help with the documentation +Coordination of contribution efforts takes place on the +[scala-internals Google group](./scala-internals.html). -An easy but very important way to contribute to Scala is to -[help with the guide/tutorial-style documentation on docs.scala-lang.org](http://docs.scala-lang.org/contribute.html). -If you want to [contribute to Scala standard library API documentation](./scala-standard-library-api-documentation.html), the -process is slightly different, since API documentation lives within Scala standard library source code. +
+
+
+

Documentation

+

Activator templates, +Scaladoc (API), +docs.scala-lang.org and +scala-lang.org.

+
+
+

Bug Fixes

+

Issues with the tools, core libraries and compiler. Also you can help us by reporting bugs

+
+
-### Compiler and other tools +
+
+

Tools

+

Enhance the Scala tooling ecosystem with features for build tools, IDE plug-ins and other related tools.

+
+
+

Core Libraries

+

Update and expand the capabilities of the core (and associated) Scala libraries.

+
+
+ +
+
+

Compiler/Language

+

Larger language features and compiler enhancements including language specification and SIPs.

+
+
+

Contributor Hall of Fame

+

Get your props, and find your place in the leader-board.

+
+
+
-More info in our [contributing guide](./guide.html). + +### Reporting bugs + +See our [bug reporting guide](./bug-reporting-guide.html) to learn +how to efficiently report a bug. ### Community Tickets @@ -35,33 +70,33 @@ various contributor activities:
-

Documentation

+

Documentation

Help augment or correct the documentation.

-

Core Libraries

+

Core Libraries

Community bugs and enhancements on the core libs.

-

Tools

+

Tools

Help with the Scala tool chain.

-

Compiler

+

Compiler

Ready for a challenge? Here's the compiler bugs.

-

Bugs

+

Bugs

All bugs marked with the label community.

-

All Issues

+

All Issues

Bugs + Enhancements marked with the label community.

diff --git a/contribute/scala-internals.md b/contribute/scala-internals.md new file mode 100644 index 0000000000..fa7faa9dc3 --- /dev/null +++ b/contribute/scala-internals.md @@ -0,0 +1,45 @@ +--- +layout: page +title: Scala Internals Mailing List +--- + +## scala-internals + +The [scala-internals mailing list](https://groups.google.com/d/forum/scala-internals) is where technical and logistical discussions concerning bugs, bug fixes, documentation, improvements, new features and other contributor related topics occur. + +### Coordinating on scala-internals + +Prior to commencing on contribution work for the Scala project, even for documentation and bugfixing, it is recommended (but not required) that you make a post on scala-internals announcing your intention. It's a great time to invite any help, advice or ask any questions you might have. It's also a great place to meet peers, one of whom will probably be reviewing your contribution at some point. + +To help subscribers on the scala-internals list to sort through the postings, we request that the following topic labels are applied when you start a new post please: + +| Label | Topics | +|-----------|-------------------------------------------------------| +| [docs] | Documentation, e.g. docs.scala-lang.org, API (scaladoc), etc. | +| [issues] | Bug reporting/fixing | +| [tools] | Tools including sbt, IDE plugins, testing, scaladoc generator, etc. | +| [libs] | Core libraries, extension libraries | +| [compiler] | Scala compiler discussions/features/issues | +| [admin] | Administrative/coordination topics | + +So, to talk about this list (an admin activity primarily) one might use: + +`[admin] more suggested labels for topic differentiation.` + +as a title, which then shows up on the mailing lists as + +`[scala-internals] [admin] more suggested labels for topic differentiation.` + +### Why It's a Good Idea + +While it is optional to announce your intentions/work items on scala-internals before starting, it is recommended and a smart thing to do for a number of reasons: + +* To attempt to cut down on duplicate effort (i.e. to avoid two people working on the same bug at the same time without coordinating effort). +* Related to the above: to allow the compiler team and core committers to warn of or smooth over potential merge conflicts between separate bugs that might affect the same code. +* Potentially someone has already thought about or even worked on that issue or a related one, and has valuable insight that might save you time (including warnings about what you might find and may want to avoid - dead ends that have already been explored). +* You might find a group of impassioned individuals want to volunteer to help you, since you got there first with your post it's up to you to decide if you want help or not. +* Posting could start a dialog with a potential reviewer, smoothing the latter, merge stages of the issue. +* There are a lot of nice people waiting to talk to you on scala-internals, you might be surprised how valuable and pleasant you find the experience of talking to them. + +If all of this has not convinced you then, please, go ahead and work on contributions anyway. It *is* less important to post to scala-internals first for small, self contained bugs than it is for larger issues or features, and not having posted first will not be a reason for your PR to be rejected, it just might be a rougher review/merge process than if you had posted first. It's your choice. + diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index 519c85a030..14eb55845c 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -72,7 +72,7 @@ component so that they show up in the correct issue filters. ### Required Reading -Please familiarize yourself with **all** of the following before contributing +Please familiarize yourself with the following before contributing new API documentation to save time, effort, mistakes and repetition. * [Forking the Repo](./hacker-guide.html#2_set_up) - follow the setup steps through @@ -86,7 +86,7 @@ new API documentation to save time, effort, mistakes and repetition. companions, browsing package object documentation, searching, token searches and so on. * Prior to commit, be sure to read - [A note about git commit messages](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html). + [A note about git commit messages](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) and the [Scala Project & Developer Guidelines](https://github.com/scala/scala/blob/2.11.x/CONTRIBUTING.md). * Also read the Scala [Pull Request Policy](https://github.com/scala/scala/wiki/Pull-Request-Policy). Some of this document will clearly not apply (like the sections on providing tests, however see below for some special requirements for documentation). Do still read @@ -95,7 +95,7 @@ new API documentation to save time, effort, mistakes and repetition. cleanly. Remember that the title of the pull request will become the commit message when merged. **Also**, be sure to assign one or more reviewers to the PR, list of reviewers is at the bottom of this document, but the quick version is to add - `Review by @dickwall` **in the pull request comments**. + `Review by @heathermiller` or `Review by @dickwall` **in the pull request comments**. ### Extra Requirements for Scaladoc Documentation Commits diff --git a/contribute/tools.md b/contribute/tools.md new file mode 100644 index 0000000000..4378d6f568 --- /dev/null +++ b/contribute/tools.md @@ -0,0 +1,8 @@ +--- +layout: page +title: Tool Contributions +--- +## Under Construction + +If you would like to help complete this document, welcome, and please head over and read [Documentation Contributions](./documentation.html#the-scala-language-site), +and let us know on the [scala-internals](https://groups.google.com/forum/#!forum/scala-internals) forum (suggested post title: `[docs] Tool Contributions`) so that we can get you hooked up with the right people. \ No newline at end of file From 0083e203436a2f64c8d50029b93cda39bba5c125 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 10 Feb 2015 12:01:59 -0800 Subject: [PATCH 0061/3075] Alter when documentation/bug fix scala-internals postings are recommended. --- contribute/scala-internals.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/scala-internals.md b/contribute/scala-internals.md index fa7faa9dc3..5bd97ed8a8 100644 --- a/contribute/scala-internals.md +++ b/contribute/scala-internals.md @@ -9,7 +9,7 @@ The [scala-internals mailing list](https://groups.google.com/d/forum/scala-inter ### Coordinating on scala-internals -Prior to commencing on contribution work for the Scala project, even for documentation and bugfixing, it is recommended (but not required) that you make a post on scala-internals announcing your intention. It's a great time to invite any help, advice or ask any questions you might have. It's also a great place to meet peers, one of whom will probably be reviewing your contribution at some point. +Prior to commencing on contribution work on larger changes to the Scala project, it is recommended (but not required) that you make a post on scala-internals announcing your intention. It's a great time to invite any help, advice or ask any questions you might have. It's also a great place to meet peers, one of whom will probably be reviewing your contribution at some point. For smaller bug fixes or documentation changes where the risk of effort duplication is minimal, you can skip this post. To help subscribers on the scala-internals list to sort through the postings, we request that the following topic labels are applied when you start a new post please: From d7c254b48255eda00420e38d1273e46e88213bc3 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 10 Feb 2015 13:50:21 -0800 Subject: [PATCH 0062/3075] Correct scala-internals link and remove missing resource links. --- contribute/guide.md | 18 +----------------- 1 file changed, 1 insertion(+), 17 deletions(-) diff --git a/contribute/guide.md b/contribute/guide.md index 809c6558d5..90f16082d6 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -54,7 +54,7 @@ This is the impatient developer's checklist for the steps to submit a bug-fix pu 1. [Select a bug to fix from JIRA](https://issues.scala-lang.org/issues/?filter=12111), or if you found the bug yourself and want to fix it, [create a JIRA issue](./bug-reporting-guide.html) (but please [make sure it's not a duplicate](./bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). -2. Optional ([but recommended](./scala-internals#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](./scala-internals.html). After all, don't you want to work on a team with +2. Optional ([but recommended](./scala-internals.html#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](./scala-internals.html). After all, don't you want to work on a team with [these friendly people](./hacker-guide.html#connect) - it's one of the perks of contributing. 3. [Fork the Scala repository](./hacker-guide.html#fork) and clone your fork (if you haven't already). 4. [Create a feature branch](./hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. @@ -78,19 +78,3 @@ on the [scala-internals](http://groups.google.com/group/scala-internals) mailing Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against the Scala project source tree. The [hacker guide](hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. -### Further Reading for Larger Changes - -The files below are recordings of code walk-through sessions by Martin Odersky about the Scala compiler internals. Some of the information is somewhat outdated, but the clips are still a good introduction to some parts of the compiler architecture. - - - [Scala Internals 2008-10-29 (Symbols 1)](http://www.scala-lang.org/sites/default/files/martin_ordersky_scala_internals_2008-10-29.avi) - - Handling of Symbols in the Scala compiler: some details on the symtab subdir, Symbols, Definitions, StdNames, Types (Lazy Types). - - - [Scala Internals 2008-11-05 (Symbols 2)](http://www.scala-lang.org/sites/default/files/martin_ordersky_scala_internals_2008-11-05.avi) - - Handling of Symbols part deux: more information on Symbols, Flags, Definitions. - - - [Scala Internals 2009-03-04 (Types)](http://www.scala-lang.org/sites/default/files/martin_ordersky_scala_internals_2009-03-04.avi) - - A detailed explanation about how types are represented and manipulated within the Scala compiler: data structures, manipulations of types, coding conventions (audio is not perfect, but intelligible). - From a4fb06f631262af3f87b6efd14d5078ac992c761 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 16 Feb 2015 09:55:48 +0100 Subject: [PATCH 0063/3075] Add scala-fame data --- .../_posts/2015-02-01-scala-fame-2015-01.md | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2015-02-01-scala-fame-2015-01.md diff --git a/contribute/scala-fame-data/_posts/2015-02-01-scala-fame-2015-01.md b/contribute/scala-fame-data/_posts/2015-02-01-scala-fame-2015-01.md new file mode 100644 index 0000000000..4af6e3d778 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2015-02-01-scala-fame-2015-01.md @@ -0,0 +1,56 @@ +--- +layout: famearchive +title: Contributors of January 2015 +fame-year: 2015 +fame-month: 1 +fame-month-str: January +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 + commits: 10 + linesAdded: 222 + linesDeleted: 26 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 + commits: 4 + linesAdded: 819 + linesDeleted: 636 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 + commits: 4 + linesAdded: 470 + linesDeleted: 152 + rank: 1 + newContributor: false + - category: Community + authors: + - username: kanielc + gravatar: https://avatars1.githubusercontent.com/u/1334074?v=3&s=60 + commits: 2 + linesAdded: 58 + linesDeleted: 2 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 + commits: 2 + linesAdded: 35 + linesDeleted: 41 + rank: 1 + newContributor: false + - username: dickwall + gravatar: https://avatars2.githubusercontent.com/u/56453?v=3&s=60 + commits: 1 + linesAdded: 74 + linesDeleted: 0 + rank: 2 + newContributor: false +--- From db78065ef0defcd7b863409625974509c687ba3a Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 17 Feb 2015 11:50:40 -0800 Subject: [PATCH 0064/3075] Re-org and simplify contribution section pages. * Removed hall of fame links (as the feature is being removed) * Temporarily disabled tools page link until we work out what to do for tools * Shuffled documentation contrib order to emphasize scaladoc over activator --- contribute/documentation.md | 16 ++++++++-------- contribute/guide.md | 2 +- contribute/index.md | 32 +++++++++++++------------------- 3 files changed, 22 insertions(+), 28 deletions(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index da20b9360d..cb2f7a46fb 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -6,9 +6,9 @@ title: Documentation Contributions There are several ways you can help out with the improvement of Scala documentation. These include: +* API Documentation in Scaladoc * Code examples and tutorials in activator templates. * The Scala Wiki -* API Documentation in Scaladoc * Guides, Overviews, Tutorials, Cheat Sheets and more on the docs.scala-lang.org site * Updating Documents on the Main Scala Language Site (this one) @@ -18,13 +18,6 @@ Please read this page, and the pages linked from this one, fully before contribu Thanks -### Examples/Tutorials in Activator Templates - -[Typesafe Activator](https://typesafe.com/community/core-tools/activator-and-sbt) -is a tool based on SBT, with a UI mode that is ideal for code based tutorials, overviews and walk-throughs. To contribute an example in activator, you can fork an existing template, edit it, add a tutorial, upload it to github and then submit the github project into the template repository. It's the fastest way to produce a working code example with tutorial. - -Please see [Contributing an Activator Template](https://typesafe.com/activator/template/contribute) for more details. - ### API Documentation (Scaladoc) The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: @@ -36,6 +29,13 @@ Please *follow the issue submission process closely* to help prevent duplicate i [submit new Scaladoc](./scala-standard-library-api-documentation.html) without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on scala-internals so that people know what you are doing. +### Examples/Tutorials in Activator Templates + +[Typesafe Activator](https://typesafe.com/community/core-tools/activator-and-sbt) +is a tool based on SBT, with a UI mode that is ideal for code based tutorials, overviews and walk-throughs. To contribute an example in activator, you can fork an existing template, edit it, add a tutorial, upload it to github and then submit the github project into the template repository. It's the fastest way to produce a working code example with tutorial. + +Please see [Contributing an Activator Template](https://typesafe.com/activator/template/contribute) for more details. + ### The Scala Wiki The [Scala wiki](https://wiki.scala-lang.org/) could be a useful resource, but tends to get out of date quickly. It is perhaps best viewed as a place for information to temporarily live while it is constructed and refined, but with an aim to putting the material into the [docs.scala-lang.org](http://docs.scala-lang.org) site eventually (see the next section). Nonetheless, it is a fast way to add some public documentation. diff --git a/contribute/guide.md b/contribute/guide.md index 90f16082d6..bf323c39e5 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -65,7 +65,7 @@ This is the impatient developer's checklist for the steps to submit a bug-fix pu https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) 9. [Submit a pull request](./hacker-guide.html#submit) following the [Scala project pull-request guidelines](http://docs.scala-lang.org/scala/pull-request-policy.html). 10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](./hacker-guide.html#review). -11. [Bask in the glow of a job well done](./scala-fame.html). +11. Celebrate! Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide](./hacker-guide.html) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). diff --git a/contribute/index.md b/contribute/index.md index 433c579620..405a675ea6 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -13,6 +13,11 @@ everyone make things better? That depends on what you want to contribute. Below are some getting started resources for different contribution domains. Please read all of the documentation and follow all the links from the topic pages below before attempting to contribute, as many of the questions you have will already be answered. +### Reporting bugs + +See our [bug reporting guide](./bug-reporting-guide.html) to learn +how to efficiently report a bug. + ### Contribute Coordination of contribution efforts takes place on the @@ -22,8 +27,7 @@ Coordination of contribution efforts takes place on the

Documentation

-

Activator templates, -Scaladoc (API), +

Scaladoc (API), Activator templates, docs.scala-lang.org and scala-lang.org.

@@ -35,33 +39,23 @@ Coordination of contribution efforts takes place on the
-

Tools

-

Enhance the Scala tooling ecosystem with features for build tools, IDE plug-ins and other related tools.

-
-

Core Libraries

Update and expand the capabilities of the core (and associated) Scala libraries.

-
- -
-

Compiler/Language

+

Compiler/Language

Larger language features and compiler enhancements including language specification and SIPs.

-
-

Contributor Hall of Fame

-

Get your props, and find your place in the leader-board.

+ +
- -### Reporting bugs - -See our [bug reporting guide](./bug-reporting-guide.html) to learn -how to efficiently report a bug. - ### Community Tickets The following links provide starting points for From 090c9de45ab7a8c810469853699292aafe0ca865 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 17 Feb 2015 13:19:18 -0800 Subject: [PATCH 0065/3075] Remove wiki info, use scala-lang.org. --- contribute/documentation.md | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index cb2f7a46fb..81ebba7b3f 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -8,9 +8,8 @@ There are several ways you can help out with the improvement of Scala documentat * API Documentation in Scaladoc * Code examples and tutorials in activator templates. -* The Scala Wiki * Guides, Overviews, Tutorials, Cheat Sheets and more on the docs.scala-lang.org site -* Updating Documents on the Main Scala Language Site (this one) +* Updating scala-lang.org Please read this page, and the pages linked from this one, fully before contributing documentation. Many of the questions you have will be answered in these resources. If you have a question that isn't answered, feel free to ask on the [scala-internals Google group](https://groups.google.com/forum/#!forum/scala-internals) and then, please, submit a pull request with updated documentation reflecting that answer. @@ -36,12 +35,6 @@ is a tool based on SBT, with a UI mode that is ideal for code based tutorials, o Please see [Contributing an Activator Template](https://typesafe.com/activator/template/contribute) for more details. -### The Scala Wiki - -The [Scala wiki](https://wiki.scala-lang.org/) could be a useful resource, but tends to get out of date quickly. It is perhaps best viewed as a place for information to temporarily live while it is constructed and refined, but with an aim to putting the material into the [docs.scala-lang.org](http://docs.scala-lang.org) site eventually (see the next section). Nonetheless, it is a fast way to add some public documentation. - -The wiki is self documenting, so make sure to take a look at the [home page](https://wiki.scala-lang.org/) to get started. Please consider contributions to [docs.scala-lang.org](docs.scala-lang.org) for more enduring documentation, even though it is more work to get through the review process for the main doc site. - ### The Main Scala Documentation Site [docs.scala-lang.org](https://wiki.scala-lang.org/) houses the primary source of written, non-API documentation for Scala. It's a github project that you can fork and submit pull requests from. It includes: @@ -59,7 +52,7 @@ and more Please read [contributing to the docs.scala-lang.org site](http://docs.scala-lang.org/contribute.html) through before embarking on changes. The site uses the [Jekyll](http://jekyllrb.com/) markdown engine so you will need to follow the instructions to get that running as well. -### The Scala Language Site +### Updating scala-lang.org Additional high-level documentation (including documentation on contributing to Scala and related projects) is provided on the main From e172523885936286894c661fc450ff3378135dd5 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Wed, 18 Feb 2015 14:46:54 -0800 Subject: [PATCH 0066/3075] Add IDEs and Build Tools page * IDEs and Build Tools page consists of links out to important scala projects * Restored link to above page, and renamed to IDEs and Build Tools * Added a missing link into the documentation.md page --- contribute/documentation.md | 2 +- contribute/index.md | 12 ++-- contribute/tools.md | 123 ++++++++++++++++++++++++++++++++++-- 3 files changed, 126 insertions(+), 11 deletions(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index 81ebba7b3f..c4704eee0b 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -60,5 +60,5 @@ to Scala and related projects) is provided on the main [scala-lang github project](https://github.com/scala/scala-lang) which may be forked to create pull requests. Please read both the -[docs.scala-lang.org contribution](http://docs.scala-lang.org/contribute.html) document and the scala-lang.org github README file before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. +[docs.scala-lang.org contribution](http://docs.scala-lang.org/contribute.html) document and the [scala-lang.org github README](https://github.com/dickwall/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. diff --git a/contribute/index.md b/contribute/index.md index 405a675ea6..2d98744a6f 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -43,17 +43,17 @@ Coordination of contribution efforts takes place on the

Update and expand the capabilities of the core (and associated) Scala libraries.

-

Compiler/Language

-

Larger language features and compiler enhancements including language specification and SIPs.

+

IDE and Build Tools

+

Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects.

- ### Community Tickets diff --git a/contribute/tools.md b/contribute/tools.md index 4378d6f568..53b097a696 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -1,8 +1,123 @@ --- layout: page -title: Tool Contributions +title: IDE and Build Tool Contributions --- -## Under Construction +## Contributing to IDE and Build Tools -If you would like to help complete this document, welcome, and please head over and read [Documentation Contributions](./documentation.html#the-scala-language-site), -and let us know on the [scala-internals](https://groups.google.com/forum/#!forum/scala-internals) forum (suggested post title: `[docs] Tool Contributions`) so that we can get you hooked up with the right people. \ No newline at end of file +The links below are to a number of Scala build and IDE related projects that are important in the larger Scala space, and which welcome contributions. + +Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](./hacker-guide.html) and [Bug-fixing](guide.html) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. + +Typically, issues for these projects will be reported and kept in the github project issue tracker for that project rather than in the Scala project JIRA. +Many of these projects have a gitter channel (usually listed in the README or CONTRIBUTING documents) which is a great place to discuss proposed work before commencing. + +### Broken Links? + +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating-scala-langorg) to fix it. + +### Projects + +
+
+
+

Scala IDE

 +

The Eclipse Scala IDE project.

+

Home | +Issues | +ReadMe | +Contributing

+
+
+ +

sbt

 +

Interactive build tool.

+

Home | +Issues | +ReadMe | +Contributing

+
+
+ +
+
+ +

Scaladoc Tool

 +

(Contribute through scala/scala)

+

Home | +Issues | +ReadMe | +Contributing

+
+
+

DBuild

 +

Multi-project build tool.

+

Home | +Issues | +ReadMe | +Contributing

+
+
+ +
+
+

Ensime

 +

Scala Support for Text Editors

+

Home | +Issues | +ReadMe | +Contributing

+
+
+ +

Abide

 +

Lint tooling for Scala

+

Home | +Issues | +ReadMe | +Contributing

+
+
+ +
+
+ +

Partest

 +

Scala Compiler/Library Testing

+

Home | +Issues | +ReadMe

+
+
+

Scoverage

 +

Scala code coverage tool

+

Home | +Issues | +ReadMe | +Contributing

+
+
+
+ +### Projects in Particular Need + +The following projects are important to the Scala community but are particularly in need of contributors to continue their development. + +
+
+
+ +

Scalap

 +

Scala Decoder (part of scala/scala)

+Issues | +ReadMe | +Contributing

+
+
+

Scalariform

 +

Scala code formatter

+

Home | +Issues | +ReadMe

+
+
+
From 391caec69a325cdac6c1531a717bc21cc001605d Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 10 Mar 2015 10:16:07 -0700 Subject: [PATCH 0067/3075] Respond to review comments - correct link, reorder projects * Re-order the projects in approximate order of importance * Corrected scala docs link to correct github project --- contribute/documentation.md | 2 +- contribute/tools.md | 60 ++++++++++++++++++++----------------- 2 files changed, 33 insertions(+), 29 deletions(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index c4704eee0b..c0de56d9b1 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -60,5 +60,5 @@ to Scala and related projects) is provided on the main [scala-lang github project](https://github.com/scala/scala-lang) which may be forked to create pull requests. Please read both the -[docs.scala-lang.org contribution](http://docs.scala-lang.org/contribute.html) document and the [scala-lang.org github README](https://github.com/dickwall/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. +[docs.scala-lang.org contribution](http://docs.scala-lang.org/contribute.html) document and the [scala-lang.org github README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. diff --git a/contribute/tools.md b/contribute/tools.md index 53b097a696..dab8244d0f 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -11,6 +11,10 @@ Since these tools are in separate projects, they may (and likely will) have thei Typically, issues for these projects will be reported and kept in the github project issue tracker for that project rather than in the Scala project JIRA. Many of these projects have a gitter channel (usually listed in the README or CONTRIBUTING documents) which is a great place to discuss proposed work before commencing. +There are some projects in this section that are in +[particular need](#projects-in-particular-need) so please check those out +if you would like to help revive them. + ### Broken Links? Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating-scala-langorg) to fix it. @@ -20,14 +24,6 @@ Stuff changes. Found a broken link or something that needs updating on this page
-

Scala IDE

 -

The Eclipse Scala IDE project.

-

Home | -Issues | -ReadMe | -Contributing

-
-

sbt

Interactive build tool.

@@ -36,9 +32,6 @@ Stuff changes. Found a broken link or something that needs updating on this page ReadMe | Contributing

-
- -

Scaladoc Tool

 @@ -48,6 +41,17 @@ Stuff changes. Found a broken link or something that needs updating on this page ReadMe | Contributing

+
+ +
+
+

Scala IDE

 +

The Eclipse Scala IDE project.

+

Home | +Issues | +ReadMe | +Contributing

+

DBuild

Multi-project build tool.

@@ -60,6 +64,14 @@ Stuff changes. Found a broken link or something that needs updating on this page
+ +

Partest

 +

Scala Compiler/Library Testing

+

Home | +Issues | +ReadMe

+
+

Ensime

Scala Support for Text Editors

Home | @@ -67,27 +79,10 @@ Stuff changes. Found a broken link or something that needs updating on this page ReadMe | Contributing

-
- -

Abide

 -

Lint tooling for Scala

-

Home | -Issues | -ReadMe | -Contributing

-
- -

Partest

 -

Scala Compiler/Library Testing

-

Home | -Issues | -ReadMe

-
-

Scoverage

Scala code coverage tool

Home | @@ -95,6 +90,15 @@ Stuff changes. Found a broken link or something that needs updating on this page ReadMe | Contributing

+
+ +

Abide

 +

Lint tooling for Scala

+

Home | +Issues | +ReadMe | +Contributing

+
From 78759cd80f9a25baef7d9b437b829a8ac66261c4 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Wed, 11 Mar 2015 09:44:19 -0700 Subject: [PATCH 0068/3075] Tweak the all community bugs link * No longer sort by component - sort by votes instead. --- contribute/guide.md | 2 +- contribute/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/guide.md b/contribute/guide.md index bf323c39e5..8c07448ba7 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -52,7 +52,7 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [github branch](https://github.com/scala/scala) -1. [Select a bug to fix from JIRA](https://issues.scala-lang.org/issues/?filter=12111), or if you found the bug yourself and want to fix it, [create a JIRA issue](./bug-reporting-guide.html) (but please +1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](./bug-reporting-guide.html) (but please [make sure it's not a duplicate](./bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). 2. Optional ([but recommended](./scala-internals.html#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](./scala-internals.html). After all, don't you want to work on a team with [these friendly people](./hacker-guide.html#connect) - it's one of the perks of contributing. diff --git a/contribute/index.md b/contribute/index.md index 2d98744a6f..0a37b87a73 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -90,7 +90,7 @@ various contributor activities:

All bugs marked with the label community.

-

All Issues

+

All Issues

Bugs + Enhancements marked with the label community.

From 84da163c3d36575459983b9d2d59fba25dfbea10 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 17 Mar 2015 13:28:27 -0700 Subject: [PATCH 0069/3075] Add fix me links and core lib page. * Add a fix this page link under contents list * Create a simple landing page for core libs - direct to docs.scala.lang --- contribute/corelibs.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/contribute/corelibs.md b/contribute/corelibs.md index 1429ec87ff..6e1abbb0d7 100644 --- a/contribute/corelibs.md +++ b/contribute/corelibs.md @@ -2,7 +2,20 @@ layout: page title: Core Library Contributions --- -## Under Construction +## Core Library Contributions -If you would like to help complete this document, welcome, and please head over and read [Documentation Contributions](./documentation.html#the-scala-language-site), -and let us know on the [scala-internals](https://groups.google.com/forum/#!forum/scala-internals) forum (suggested post title: `[docs] Core Library Contributions`) so that we can get you hooked up with the right people. \ No newline at end of file +There are several options for contributing to Scala's core libraries. You can: + +* Help with [Documentation](./scala-standard-library-api-documentation.html). +* [Report Bugs or Issues](./bug-reporting-guide.html) against the core libraries. +* [Fix Bugs or Issues](./guide.html) against the + [reported library bugs/issues](https://issues.scala-lang.org/issues/?filter=13001). +* Contribute significant new functionality or a new API by submitting + a Scala Library Improvement Process (SLIP) Document. + +### Submitting a SLIP + +For significant new functionality or a whole new API to be considered for +inclusion in the core Scala distribution, you will be asked to submit a SLIP (Scala Library Improvement Process) document. + +Please see [instructions for submitting a new SLIP](http://docs.scala-lang.org/sips/slip-submission.html) and familiarize yourself with the [SIP/SLIP](http://docs.scala-lang.org/sips/) section of the Scala documentation site. Also please pay particular attention to the [pre-requisites](http://docs.scala-lang.org/sips/slip-submission.html) before submitting a SLIP. From 66c5272ca07370c7c6448a30c24da2c66455dcd0 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 17 Mar 2015 13:54:39 -0700 Subject: [PATCH 0070/3075] Add a missing paragraph opener on tools.md --- contribute/tools.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/contribute/tools.md b/contribute/tools.md index dab8244d0f..023c638082 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -112,7 +112,7 @@ The following projects are important to the Scala community but are particularly

Scalap

Scala Decoder (part of scala/scala)

-Issues | +

Issues | ReadMe | Contributing

@@ -125,3 +125,5 @@ The following projects are important to the Scala community but are particularly + + \ No newline at end of file From cde252c3e88bdb803f48c4bf30e33c8ffe6da1de Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 17 Mar 2015 14:50:34 -0700 Subject: [PATCH 0071/3075] Fix intra-page links for main markdown engine. * Local jekyll uses - but main site uses _ for intra-page anchors --- contribute/guide.md | 8 ++++---- contribute/index.md | 2 +- contribute/tools.md | 4 ++-- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/contribute/guide.md b/contribute/guide.md index 8c07448ba7..04fe50ae5b 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -17,7 +17,7 @@ title: Contributing guide
-

Community issues

+

Community issues

Get cracking on some easy to approach issues.

@@ -52,9 +52,9 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [github branch](https://github.com/scala/scala) -1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](./bug-reporting-guide.html) (but please -[make sure it's not a duplicate](./bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). -2. Optional ([but recommended](./scala-internals.html#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](./scala-internals.html). After all, don't you want to work on a team with +1. [Select a bug to fix from JIRA](/contribute/index.html#community_tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](./bug-reporting-guide.html) (but please +[make sure it's not a duplicate](./bug-reporting-guide.html#reporting_confirmed_bugs_is_a_sin)). +2. Optional ([but recommended](./scala-internals.html#why_its_a_good_idea)), announce your intention to work on the bug on [scala-internals](./scala-internals.html). After all, don't you want to work on a team with [these friendly people](./hacker-guide.html#connect) - it's one of the perks of contributing. 3. [Fork the Scala repository](./hacker-guide.html#fork) and clone your fork (if you haven't already). 4. [Create a feature branch](./hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. diff --git a/contribute/index.md b/contribute/index.md index 0a37b87a73..a272a8b98d 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -50,7 +50,7 @@ Coordination of contribution efforts takes place on the
-

Compiler/Language

+

Compiler/Language

Larger language features and compiler enhancements including language specification and SIPs.

diff --git a/contribute/tools.md b/contribute/tools.md index 023c638082..92207f4da2 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -12,12 +12,12 @@ Typically, issues for these projects will be reported and kept in the github pro Many of these projects have a gitter channel (usually listed in the README or CONTRIBUTING documents) which is a great place to discuss proposed work before commencing. There are some projects in this section that are in -[particular need](#projects-in-particular-need) so please check those out +[particular need](#projects_in_particular_need) so please check those out if you would like to help revive them. ### Broken Links? -Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating-scala-langorg) to fix it. +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating_scala_langorg) to fix it. ### Projects From 70673bb169853d0caf796d63e4aa3030238f1ba1 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 17 Mar 2015 15:01:50 -0700 Subject: [PATCH 0072/3075] Remove extra _ in fix-page link. --- contribute/tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/tools.md b/contribute/tools.md index 92207f4da2..1757ae1005 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -17,7 +17,7 @@ if you would like to help revive them. ### Broken Links? -Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating_scala_langorg) to fix it. +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating_scalalangorg) to fix it. ### Projects From fa3402a41320cbfb6c0ba3c3f4970e8633e5b596 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 17 Mar 2015 15:20:28 -0700 Subject: [PATCH 0073/3075] Fix documentation page intra-link. --- contribute/documentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index c0de56d9b1..d7597d8884 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -21,7 +21,7 @@ Thanks The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: -* [Log issues for missing scaladoc documentation](./scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - +* [Log issues for missing scaladoc documentation](./scala-standard-library-api-documentation.html#contribute_api_documentation_bug_reports) - Please *follow the issue submission process closely* to help prevent duplicate issues being created. * [Claim Scaladoc Issues and Provide Documentation](./scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. * You can also just From fc02b4d49bcc4d85f59fa0f1d1df913b2e102521 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Mon, 23 Mar 2015 15:22:16 -0700 Subject: [PATCH 0074/3075] Add contribute PR review page to /contribute * Pull request reviewing was overlooked in recent contribute changes --- contribute/codereviews.md | 60 +++++++++++++++++++++++++++++++++++++++ contribute/index.md | 12 ++++++-- 2 files changed, 69 insertions(+), 3 deletions(-) create mode 100644 contribute/codereviews.md diff --git a/contribute/codereviews.md b/contribute/codereviews.md new file mode 100644 index 0000000000..87ab392f1c --- /dev/null +++ b/contribute/codereviews.md @@ -0,0 +1,60 @@ +--- +layout: page +title: Code Review Contributions +--- +## Code Review Contributions + +In addition to [bug fixing](./guide.html), you can help us review +[waiting pull requests](#pull_requests_awaiting_comment). This is also a good (and recommended) way to get to know the feel of +the bug-fixing and submissions process before jumping in (lurk for a while, +reading pull requests from others and maybe commenting on them). + +### Etiquette + +[Code of Conduct Reminder](http://docs.scala-lang.org/conduct.html) + +There are many coding approaches and styles. Asserting that yours is the only correct one is not likely to lead to a smooth interaction with others. Code review is where programmers (often volunteers) surrender up their efforts for public scrutiny. + +Code reviewing is a great way to both learn and mentor, and *all* comments made during pull request reviews should bear those two aims in mind. + +Assuming the pull request has been made following the guidelines laid out in the rest of the contributor documentation (e.g. for Scala bug fixes, the PR is against an open issue, and has adhered to the guidelines for code changes and submitting the PR), then the comments for the pull request are *not* the correct place to discuss on whether this PR is even needed or other broad, negative assertions. + +The comments are for looking for potential problems in the code, suggesting improvements, looking for items that might have been missed by the submitter and so on. If you feel it necessary to discuss whether the issue should even be addressed, that should be carried out ([in a professional manner](http://docs.scala-lang.org/conduct.html)) on the comments for that Issue rather than the PR. General discussions should likewise be directed to forums like [scala-debate](https://groups.google.com/d/forum/scala-debate), [scala-user](https://groups.google.com/d/forum/scala-user), [scala-language](https://groups.google.com/d/forum/scala-language) or [scala-internals](https://groups.google.com/d/forum/scala-internals). + +Conversely if you are receiving a review, consider that the advice is being given to make you, and Scala, better rather than as a negative critique. Assume the best, rather than the worst. + +### Review Guidelines + +* Keep comments on-topic, concise and precise. +* Attach comments to particular lines or regions they pertain to whenever possible. +* Short code examples are often more descriptive than prose. +* If (and only if) you have thoroughly reviewed the PR and thought through all angles, and you want to accept it, LGTM (Looks Good To Me) is the preferred acceptance response. If there are already LGTMs on the PR, consider whether you are adding anything or just being "me too". +* Above all, remember that the people you are reviewing might be reviewing your PRs one day too :-). + +## Pull Requests Awaiting Comment + +
+
+
+

scala/scala

+

Scala bug fixes and changes in the language, core libs and included tools.

+
+
+

scala/github.scala.com

+

Scala documentation site.

+
+
+ +
+
+

scala/scala-lang

+

The Scala language web site.

+
+
+

All Scala Github Projects

+

For other PRs, follow the scala project from here.

+
+
+
+ +Also note that the [Tools contributions](./tools.html) page has more projects that will generate pull requests. \ No newline at end of file diff --git a/contribute/index.md b/contribute/index.md index a272a8b98d..fd94af5de2 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -39,16 +39,22 @@ Coordination of contribution efforts takes place on the
+

Code Reviews

+

Review pull requests against scala/scala, +scala/scala-lang, +scala/scala.github.com and others.

+
+

Core Libraries

Update and expand the capabilities of the core (and associated) Scala libraries.

+
+ +

IDE and Build Tools

Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects.

-
- -

Compiler/Language

Larger language features and compiler enhancements including language specification and SIPs.

From 77cd3f5f78cb9ed89311ff2f5a811b6e25cf52c1 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 24 Mar 2015 14:07:31 -0700 Subject: [PATCH 0075/3075] Incorporate comments, reduce wordiness * Cut etiquette section * Include Code of Conduct link in Review Guidelines section * Change wording aroung LGTM and additional reviews --- contribute/codereviews.md | 30 +++++++++++------------------- 1 file changed, 11 insertions(+), 19 deletions(-) diff --git a/contribute/codereviews.md b/contribute/codereviews.md index 87ab392f1c..949cb11300 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -5,31 +5,23 @@ title: Code Review Contributions ## Code Review Contributions In addition to [bug fixing](./guide.html), you can help us review -[waiting pull requests](#pull_requests_awaiting_comment). This is also a good (and recommended) way to get to know the feel of -the bug-fixing and submissions process before jumping in (lurk for a while, -reading pull requests from others and maybe commenting on them). +[waiting pull requests](#pull_requests_awaiting_comment). +This is also a good (and recommended) way to get to know the feel of +the bug-fixing and submissions process before jumping in with your +own pull requests. -### Etiquette - -[Code of Conduct Reminder](http://docs.scala-lang.org/conduct.html) - -There are many coding approaches and styles. Asserting that yours is the only correct one is not likely to lead to a smooth interaction with others. Code review is where programmers (often volunteers) surrender up their efforts for public scrutiny. - -Code reviewing is a great way to both learn and mentor, and *all* comments made during pull request reviews should bear those two aims in mind. - -Assuming the pull request has been made following the guidelines laid out in the rest of the contributor documentation (e.g. for Scala bug fixes, the PR is against an open issue, and has adhered to the guidelines for code changes and submitting the PR), then the comments for the pull request are *not* the correct place to discuss on whether this PR is even needed or other broad, negative assertions. - -The comments are for looking for potential problems in the code, suggesting improvements, looking for items that might have been missed by the submitter and so on. If you feel it necessary to discuss whether the issue should even be addressed, that should be carried out ([in a professional manner](http://docs.scala-lang.org/conduct.html)) on the comments for that Issue rather than the PR. General discussions should likewise be directed to forums like [scala-debate](https://groups.google.com/d/forum/scala-debate), [scala-user](https://groups.google.com/d/forum/scala-user), [scala-language](https://groups.google.com/d/forum/scala-language) or [scala-internals](https://groups.google.com/d/forum/scala-internals). - -Conversely if you are receiving a review, consider that the advice is being given to make you, and Scala, better rather than as a negative critique. Assume the best, rather than the worst. ### Review Guidelines +[Code of Conduct Reminder](http://docs.scala-lang.org/conduct.html) + * Keep comments on-topic, concise and precise. * Attach comments to particular lines or regions they pertain to whenever possible. * Short code examples are often more descriptive than prose. -* If (and only if) you have thoroughly reviewed the PR and thought through all angles, and you want to accept it, LGTM (Looks Good To Me) is the preferred acceptance response. If there are already LGTMs on the PR, consider whether you are adding anything or just being "me too". -* Above all, remember that the people you are reviewing might be reviewing your PRs one day too :-). +* If you have thoroughly reviewed the PR and thought through all angles, LGTM (Looks Good To Me) is the preferred acceptance response. +* Additional reviews should try to offer additional insights: "I also thought about it from this angle and it still looks good.." +* Above all, remember that the people you are reviewing might be reviewing your PRs one day too. +* If you are receiving the review, consider that the advice is being given to make you, and Scala, better rather than as a negative critique. Assume the best, rather than the worst. ## Pull Requests Awaiting Comment @@ -57,4 +49,4 @@ Conversely if you are receiving a review, consider that the advice is being give
-Also note that the [Tools contributions](./tools.html) page has more projects that will generate pull requests. \ No newline at end of file +Also note that the [Tools contributions](./tools.html) page has more projects that will generate pull requests. From 3c9d4cd4b8587642f5d0b59f7a4ae7100d799904 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Tue, 14 Apr 2015 11:43:49 +0200 Subject: [PATCH 0076/3075] Add scala-fame data --- .../_posts/2015-03-01-scala-fame-2015-02.md | 70 ++++++++++++++ .../_posts/2015-04-01-scala-fame-2015-03.md | 91 +++++++++++++++++++ 2 files changed, 161 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2015-03-01-scala-fame-2015-02.md create mode 100644 contribute/scala-fame-data/_posts/2015-04-01-scala-fame-2015-03.md diff --git a/contribute/scala-fame-data/_posts/2015-03-01-scala-fame-2015-02.md b/contribute/scala-fame-data/_posts/2015-03-01-scala-fame-2015-02.md new file mode 100644 index 0000000000..3fe846623b --- /dev/null +++ b/contribute/scala-fame-data/_posts/2015-03-01-scala-fame-2015-02.md @@ -0,0 +1,70 @@ +--- +layout: famearchive +title: Contributors of February 2015 +fame-year: 2015 +fame-month: 2 +fame-month-str: February +fame-categories: + - category: Typesafe + authors: + - username: adriaanm + gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 + commits: 15 + linesAdded: 1199 + linesDeleted: 588 + rank: 1 + newContributor: false + - username: retronym + gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 + commits: 13 + linesAdded: 557 + linesDeleted: 64 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 + commits: 10 + linesAdded: 1629 + linesDeleted: 276 + rank: 1 + newContributor: false + - username: xeno-by + gravatar: https://avatars0.githubusercontent.com/u/609152?v=3&s=60 + commits: 2 + linesAdded: 108 + linesDeleted: 15 + rank: 2 + newContributor: false + - username: axel22 + gravatar: https://avatars0.githubusercontent.com/u/151774?v=3&s=60 + commits: 1 + linesAdded: 61 + linesDeleted: 0 + rank: 3 + newContributor: false + - category: Community + authors: + - username: Ichoran + gravatar: https://avatars2.githubusercontent.com/u/2298644?v=3&s=60 + commits: 3 + linesAdded: 62 + linesDeleted: 25 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 + commits: 2 + linesAdded: 121 + linesDeleted: 30 + rank: 2 + newContributor: false + - username: milessabin + gravatar: https://avatars1.githubusercontent.com/u/131183?v=3&s=60 + commits: 1 + linesAdded: 123 + linesDeleted: 37 + rank: 3 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2015-04-01-scala-fame-2015-03.md b/contribute/scala-fame-data/_posts/2015-04-01-scala-fame-2015-03.md new file mode 100644 index 0000000000..62e7ea2f58 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2015-04-01-scala-fame-2015-03.md @@ -0,0 +1,91 @@ +--- +layout: famearchive +title: Contributors of March 2015 +fame-year: 2015 +fame-month: 3 +fame-month-str: March +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 + commits: 9 + linesAdded: 553 + linesDeleted: 27 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 + commits: 6 + linesAdded: 12 + linesDeleted: 72 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 + commits: 18 + linesAdded: 2857 + linesDeleted: 916 + rank: 1 + newContributor: false + - username: xeno-by + gravatar: https://avatars0.githubusercontent.com/u/609152?v=3&s=60 + commits: 1 + linesAdded: 7 + linesDeleted: 5 + rank: 2 + newContributor: false + - category: Community + authors: + - username: gourlaysama + gravatar: https://avatars3.githubusercontent.com/u/733438?v=3&s=60 + commits: 4 + linesAdded: 132 + linesDeleted: 22 + rank: 1 + newContributor: false + - username: gbasler + gravatar: https://avatars0.githubusercontent.com/u/273035?v=3&s=60 + commits: 3 + linesAdded: 1986 + linesDeleted: 111 + rank: 2 + newContributor: false + - username: kzys + gravatar: https://avatars3.githubusercontent.com/u/19111?v=3&s=60 + commits: 2 + linesAdded: 37 + linesDeleted: 18 + rank: 3 + newContributor: false + - username: som-snytt + gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 + commits: 2 + linesAdded: 91 + linesDeleted: 7 + rank: 3 + newContributor: false + - username: sschaef + gravatar: https://avatars3.githubusercontent.com/u/488530?v=3&s=60 + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 4 + newContributor: false + - username: khernyo + gravatar: https://avatars2.githubusercontent.com/u/447532?v=3&s=60 + commits: 1 + linesAdded: 27 + linesDeleted: 8 + rank: 4 + newContributor: false + - username: soc + gravatar: https://avatars1.githubusercontent.com/u/42493?v=3&s=60 + commits: 1 + linesAdded: 7 + linesDeleted: 7 + rank: 4 + newContributor: false +--- From 4bada26848285509763810ee5f2895123ced406c Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Mon, 20 Apr 2015 16:41:40 -0700 Subject: [PATCH 0077/3075] Fix transposition of github.scala.com. --- contribute/codereviews.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/codereviews.md b/contribute/codereviews.md index 949cb11300..8f86815eec 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -32,7 +32,7 @@ own pull requests.

Scala bug fixes and changes in the language, core libs and included tools.

-

scala/github.scala.com

+

scala/scala.github.com

Scala documentation site.

From 57b4392ae555e8d21edbd82e566813d30d38a6d2 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 13 Jul 2015 18:45:33 -0400 Subject: [PATCH 0078/3075] phase out old GitHub wiki pages https://github.com/scala/scala/wiki is going away --- contribute/hacker-guide.md | 2 +- contribute/scala-standard-library-api-documentation.md | 3 +-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index ecdbd2fc27..3f84feee81 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -378,7 +378,7 @@ Let's go into each of these points in more detail. The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. There are two things you should know here: -1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) for more information about the desired style of your commits. +1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policies](https://github.com/scala/scala/blob/2.11.x/CONTRIBUTING.md) for more information about the desired style of your commits. 2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on GitHub. diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index 14eb55845c..bc57a163df 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -87,8 +87,7 @@ new API documentation to save time, effort, mistakes and repetition. and so on. * Prior to commit, be sure to read [A note about git commit messages](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) and the [Scala Project & Developer Guidelines](https://github.com/scala/scala/blob/2.11.x/CONTRIBUTING.md). -* Also read the Scala [Pull Request Policy](https://github.com/scala/scala/wiki/Pull-Request-Policy). - Some of this document will clearly not apply (like the sections on providing tests, + Some of this latter document will clearly not apply (like the sections on providing tests, however see below for some special requirements for documentation). Do still read the whole document though, and pay close attention to the title and commit message formats, noting *present tense*, *length limits* and that it must merge From 6a53d0605cb30cff874843aac7ce9a82855c783a Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Sat, 18 Jul 2015 14:03:43 -0400 Subject: [PATCH 0079/3075] hacker's guide: replace out-of-date reviewer list with link --- contribute/hacker-guide.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 3f84feee81..e8aa8f0db4 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -30,11 +30,9 @@ Typically bug fixes and new features start out as an idea or an experiment poste about things you want to implement. People proficient in certain areas of Scala usually monitor mailing lists, so you'll often get some help by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. -This is the list of language features/libraries along with their maintainer's full names and GitHub usernames: +A list of language features/libraries along with their maintainer's full names and GitHub usernames is [in the Scala repo README](https://github.com/scala/scala#get-in-touch). -{% include maintainers.html %} - -Since Martin is the person who submitted the string interpolation Scala Improvement Proposal and implemented this language feature for Scala 2.10.0, he might be interested in learning of new bugfixes to that feature. +In our running example, since Martin is the person who submitted the string interpolation Scala Improvement Proposal and implemented this language feature for Scala 2.10.0, he might be interested in learning of new bugfixes to that feature. As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the scala-internals mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, in this example, we post to the [the scala-user mailing list](http://groups.google.com/group/scala-user) about our issue. From 23f62743fffe21945f8c6cb454b2925b59fc960c Mon Sep 17 00:00:00 2001 From: Jason Zaugg Date: Wed, 30 Sep 2015 13:18:35 +1000 Subject: [PATCH 0080/3075] SI-9495 Add note about configuring Ant for HTTP proxies --- contribute/hacker-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index e8aa8f0db4..3a01b6a676 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -99,7 +99,7 @@ If you are new to Git and branching, read the [Branching Chapter](http://git-scm The next step after cloning your fork is setting up your machine to build Scala. * It is recommended to use Java `1.6` (not `1.7` or `1.8`, because they might cause occasional glitches). -* The build tool is `ant`. +* The build tool is `ant`. If you are behind a HTTP proxy, include [`ANT_ARGS=-autoproxy`]( https://ant.apache.org/manual/proxy.html) in your environment. * The build runs the `pull-binary-libs.sh` script to download bootstrap libs. This requires `bash` and `curl`. * The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. * Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. From 4d8f053757a0feee1ac3d1b8e7bcb0f174b30203 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 30 Sep 2015 08:53:16 -0400 Subject: [PATCH 0081/3075] fix slightly malformed Markdown --- contribute/hacker-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 3a01b6a676..54e62c1a0e 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -99,7 +99,7 @@ If you are new to Git and branching, read the [Branching Chapter](http://git-scm The next step after cloning your fork is setting up your machine to build Scala. * It is recommended to use Java `1.6` (not `1.7` or `1.8`, because they might cause occasional glitches). -* The build tool is `ant`. If you are behind a HTTP proxy, include [`ANT_ARGS=-autoproxy`]( https://ant.apache.org/manual/proxy.html) in your environment. +* The build tool is `ant`. If you are behind a HTTP proxy, include [`ANT_ARGS=-autoproxy`](https://ant.apache.org/manual/proxy.html) in your environment. * The build runs the `pull-binary-libs.sh` script to download bootstrap libs. This requires `bash` and `curl`. * The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. * Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. From 50b14af581b26cce03f972a2d00a384d2f81ab08 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 6 Oct 2015 18:35:13 -0400 Subject: [PATCH 0082/3075] SI-9501 add prominent links to relevant docs in main Scala repo the text of the guide already links to the same documents at appropriate places in the narrative, but I also think it's worth having the same links right up front --- contribute/hacker-guide.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 54e62c1a0e..fb79d8166d 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -8,6 +8,8 @@ This guide is intended to help you get from an idea of fixing a bug or implement This guide covers the entire process, from the conception of your idea or bugfix to the point where it is merged into Scala. Throughout, we will use a running example of an idea or bugfix one might wish to contribute. +Other good starting points for first-time contributors include the [Scala README](https://github.com/scala/scala#get-in-touch) and [contributor's guidelines](https://github.com/scala/scala/blob/2.11.x/CONTRIBUTING.md). + ## The Running Example Let's say that you particularly enjoy the new string interpolation language feature introduced in Scala 2.10.0, and you use it quite heavily. From 0feb67ace760707b19b2c91a5f3afea1a9045ea7 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 6 Nov 2015 15:30:38 -0500 Subject: [PATCH 0083/3075] fix typo --- contribute/scala-fame.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md index 81bb76ee3a..f30784c13f 100644 --- a/contribute/scala-fame.md +++ b/contribute/scala-fame.md @@ -1,6 +1,6 @@ --- layout: page-full-width -title: Scala Contribuitor Hall of Fame +title: Scala Contributor Hall of Fame --- A big thank you to everyone who contributed to: From c80d07050db560e6aafadc659f9ca4d0b42ef3d2 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 6 Nov 2015 16:01:22 -0500 Subject: [PATCH 0084/3075] October 2015 hall of fame --- .../_posts/2015-11-01-scala-fame-2015-10.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2015-11-01-scala-fame-2015-10.md diff --git a/contribute/scala-fame-data/_posts/2015-11-01-scala-fame-2015-10.md b/contribute/scala-fame-data/_posts/2015-11-01-scala-fame-2015-10.md new file mode 100644 index 0000000000..41698296db --- /dev/null +++ b/contribute/scala-fame-data/_posts/2015-11-01-scala-fame-2015-10.md @@ -0,0 +1,42 @@ +--- +layout: famearchive +title: Contributors of October 2015 +fame-year: 2015 +fame-month: 10 +fame-month-str: October +fame-categories: + - category: Typesafe + authors: + - username: SethTisue + gravatar: https://avatars.githubusercontent.com/u/161079?v=3 + commits: 9 + linesAdded: 80 + linesDeleted: 55 + rank: 1 + newContributor: false + - category: EPFL + authors: + - username: sjrd + gravatar: https://avatars.githubusercontent.com/u/535934?v=3 + commits: 1 + linesAdded: 1 + linesDeleted: 4 + rank: 1 + newContributor: false + - category: Community + authors: + - username: performantdata + gravatar: https://avatars.githubusercontent.com/u/6363453?v=3 + commits: 6 + linesAdded: 97 + linesDeleted: 50 + rank: 1 + newContributor: true + - username: janekdb + gravatar: https://avatars.githubusercontent.com/u/1123855?v=3 + commits: 1 + linesAdded: 86 + linesDeleted: 71 + rank: 2 + newContributor: false +--- From 761af814fe12baff772dcf47cb03c7943105d65d Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 6 Nov 2015 16:14:14 -0500 Subject: [PATCH 0085/3075] tweak Hall of Fame page * clarify what the stats show * link to the GitHub Pulse page, which is actually a lot better --- contribute/scala-fame.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md index f30784c13f..ffaf0980d7 100644 --- a/contribute/scala-fame.md +++ b/contribute/scala-fame.md @@ -3,10 +3,17 @@ layout: page-full-width title: Scala Contributor Hall of Fame --- -A big thank you to everyone who contributed to: +A big thank you to everyone who has contributed over the years to: - [the Scala library and compiler](https://github.com/scala/scala/contributors) - [the Scala documentation website](https://github.com/scala/scala.github.com/contributors) +What follows are the commit totals, to the 2.11.x branch of the scala/scala repo only, +for last month. (For a commit to be counted, it must have been both committed and merged +in the same month.) + +For more a detailed view of recent activity, see the repo's +[GitHub Pulse page](https://github.com/scala/scala/pulse/monthly). + {% for data in site.categories.scala-fame-data limit:1 %} {% assign famedata = data %} {% include render-scala-fame.html %} From 7a039ae25b191ce5733491062cf2f37d27192a9f Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 10 Nov 2015 15:16:42 -0500 Subject: [PATCH 0086/3075] tiny fix --- contribute/scala-fame.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md index ffaf0980d7..0352e6e7c7 100644 --- a/contribute/scala-fame.md +++ b/contribute/scala-fame.md @@ -11,7 +11,7 @@ What follows are the commit totals, to the 2.11.x branch of the scala/scala repo for last month. (For a commit to be counted, it must have been both committed and merged in the same month.) -For more a detailed view of recent activity, see the repo's +For a more detailed view of recent activity, see the repo's [GitHub Pulse page](https://github.com/scala/scala/pulse/monthly). {% for data in site.categories.scala-fame-data limit:1 %} From 749a690e43b43d9ff0aac267647eab842cd55045 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 4 Dec 2015 12:46:47 -0500 Subject: [PATCH 0087/3075] hall of fame: 2.12.x is default branch now --- contribute/scala-fame.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md index 0352e6e7c7..2be9e7d69d 100644 --- a/contribute/scala-fame.md +++ b/contribute/scala-fame.md @@ -7,7 +7,7 @@ A big thank you to everyone who has contributed over the years to: - [the Scala library and compiler](https://github.com/scala/scala/contributors) - [the Scala documentation website](https://github.com/scala/scala.github.com/contributors) -What follows are the commit totals, to the 2.11.x branch of the scala/scala repo only, +What follows are the commit totals, to the 2.12.x branch of the scala/scala repo only, for last month. (For a commit to be counted, it must have been both committed and merged in the same month.) From f0fb46ca9be30fc365b875d5ab2c9f171a55041b Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 4 Dec 2015 12:46:53 -0500 Subject: [PATCH 0088/3075] November 2015 contributors hall of fame --- .../_posts/2015-12-01-scala-fame-2015-11.md | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2015-12-01-scala-fame-2015-11.md diff --git a/contribute/scala-fame-data/_posts/2015-12-01-scala-fame-2015-11.md b/contribute/scala-fame-data/_posts/2015-12-01-scala-fame-2015-11.md new file mode 100644 index 0000000000..8f9b7ff3b1 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2015-12-01-scala-fame-2015-11.md @@ -0,0 +1,63 @@ +--- +layout: famearchive +title: Contributors of November 2015 +fame-year: 2015 +fame-month: 11 +fame-month-str: November +fame-categories: + - category: Typesafe + authors: + - username: szeiger + gravatar: https://avatars.githubusercontent.com/u/54262?v=3 + commits: 5 + linesAdded: 427 + linesDeleted: 116 + rank: 1 + newContributor: false + - username: SethTisue + gravatar: https://avatars.githubusercontent.com/u/161079?v=3 + commits: 3 + linesAdded: 21 + linesDeleted: 21 + rank: 2 + newContributor: false + - username: retronym + gravatar: https://avatars.githubusercontent.com/u/65551?v=3 + commits: 3 + linesAdded: 44 + linesDeleted: 28 + rank: 2 + newContributor: false + - username: adriaanm + gravatar: https://avatars.githubusercontent.com/u/91083?v=3 + commits: 2 + linesAdded: 22 + linesDeleted: 25 + rank: 3 + newContributor: false + - username: lrytz + gravatar: https://avatars.githubusercontent.com/u/119636?v=3 + commits: 1 + linesAdded: 7 + linesDeleted: 18 + rank: 4 + newContributor: false + - category: EPFL + authors: + - category: Community + authors: + - username: janekdb + gravatar: https://avatars.githubusercontent.com/u/1123855?v=3 + commits: 6 + linesAdded: 76 + linesDeleted: 63 + rank: 1 + newContributor: false + - username: soc + gravatar: https://avatars.githubusercontent.com/u/42493?v=3 + commits: 2 + linesAdded: 14 + linesDeleted: 19 + rank: 2 + newContributor: false +--- From f928c829f2e0dad88a7f0cfaabfd2d4ce87d8da5 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Thu, 17 Dec 2015 15:35:33 -0500 Subject: [PATCH 0089/3075] fix bad Markdown our Markdown processor needs a blank line before the start of a bullet list --- contribute/scala-fame.md | 1 + 1 file changed, 1 insertion(+) diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md index 2be9e7d69d..4b6591004a 100644 --- a/contribute/scala-fame.md +++ b/contribute/scala-fame.md @@ -4,6 +4,7 @@ title: Scala Contributor Hall of Fame --- A big thank you to everyone who has contributed over the years to: + - [the Scala library and compiler](https://github.com/scala/scala/contributors) - [the Scala documentation website](https://github.com/scala/scala.github.com/contributors) From 719edc3d277d67b41aef833f4edf568b47ae90d8 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Thu, 17 Dec 2015 18:43:23 -0500 Subject: [PATCH 0090/3075] add text about community libraries, Scala community build --- contribute/index.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/contribute/index.md b/contribute/index.md index fd94af5de2..c03405e489 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -101,3 +101,31 @@ various contributor activities: + +### Tools and Libraries + +The Scala ecosystem includes a great many diverse open-source projects +with their own maintainers and community of contributors. Helping out +one of these projects is another way to help Scala. Consider lending +on a hand on a project you're already using. Or, to find out about +other projects, see the +[Libraries and Tools section](../community/index.html#community-libraries-and-tools) +on our Community page. + +### Scala Community Build + +The Scala community build enables us to build and test a corpus of +Scala open source projects together, using Typesafe's +[dbuild](https://github.com/typesafehub/dbuild) tool +(which leverages [sbt](http://www.scala-sbt.org)). + +The main goal is to guard against regressions in new versions of Scala +(language, standard library, and modules). It's also a service to the +open source community, providing early notice of issues and +incompatibilities. + +If you're the maintainer -- or just an interested user! -- of an +open-source Scala library or tool, please visit the +[community build documentation](https://github.com/scala/community-builds/wiki) +for guidelines on what projects are suitable for the community build +and how projects can be added. From eeee725f7c666a969e823f128dd6893a34a3d0d8 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Thu, 17 Dec 2015 18:56:12 -0500 Subject: [PATCH 0091/3075] Code of Conduct page, relocated from docs site with updated links, and addition of link to site footer --- contribute/codereviews.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/codereviews.md b/contribute/codereviews.md index 8f86815eec..1b9a881b0c 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -13,7 +13,7 @@ own pull requests. ### Review Guidelines -[Code of Conduct Reminder](http://docs.scala-lang.org/conduct.html) +[Code of Conduct reminder](../conduct.html) * Keep comments on-topic, concise and precise. * Attach comments to particular lines or regions they pertain to whenever possible. From cc3d461d8fe51112d5d5b6b721f078025469a795 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 18 Dec 2015 07:48:57 -0500 Subject: [PATCH 0092/3075] tweak wording of community build section based on Heather's feedback --- contribute/index.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/contribute/index.md b/contribute/index.md index c03405e489..137838aba4 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -114,15 +114,14 @@ on our Community page. ### Scala Community Build -The Scala community build enables us to build and test a corpus of -Scala open source projects together, using Typesafe's -[dbuild](https://github.com/typesafehub/dbuild) tool -(which leverages [sbt](http://www.scala-sbt.org)). - -The main goal is to guard against regressions in new versions of Scala -(language, standard library, and modules). It's also a service to the -open source community, providing early notice of issues and -incompatibilities. +The Scala community build enables the Scala compiler team +to build and test a corpus of +Scala open source projects +against development versions of the Scala compiler and standard +library in order to discover regressions prior to releases. +The build uses Typesafe's +[dbuild](https://github.com/typesafehub/dbuild) tool, +which leverages [sbt](http://www.scala-sbt.org). If you're the maintainer -- or just an interested user! -- of an open-source Scala library or tool, please visit the From 856fc9cb2f903ad3353ed49e15d15e70de01e07f Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 4 Jan 2016 17:27:39 -0500 Subject: [PATCH 0093/3075] retire the Scala Contributor Hall of Fame https://api.github.com/repos/scala/scala/stats/contributors wasn't giving us good information to base this on, because it only gives you the top 100 contributors by number of all-time commits so e.g. Felix Mulder's great Scaladoc contribution for December wasn't even showing up in the data, since it was just one commit. one of the main purposes of this page was supposed to be recognizing new contributors, but the 100-contributor limit prevents that. the result was embarrassingly empty pages (which we usually forgot to even update anyway) if people are interested in all-time stats, they can visit https://github.com/scala/scala/graphs/contributors , and if people want to see recent activity, they can visit https://github.com/scala/scala/pulse --- contribute/guide.md | 2 +- .../_posts/2013-02-01-scala-fame-2013-01.md | 175 ---------------- .../_posts/2013-03-01-scala-fame-2013-02.md | 189 ------------------ .../_posts/2013-04-01-scala-fame-2013-03.md | 147 -------------- .../_posts/2013-05-01-scala-fame-2013-04.md | 126 ------------ .../_posts/2013-06-01-scala-fame-2013-05.md | 105 ---------- .../_posts/2013-07-01-scala-fame-2013-06.md | 126 ------------ .../_posts/2013-08-01-scala-fame-2013-07.md | 119 ----------- .../_posts/2013-09-01-scala-fame-2013-08.md | 98 --------- .../_posts/2013-10-01-scala-fame-2013-09.md | 105 ---------- .../_posts/2013-11-01-scala-fame-2013-10.md | 105 ---------- .../_posts/2013-12-01-scala-fame-2013-11.md | 126 ------------ .../_posts/2014-01-01-scala-fame-2013-12.md | 147 -------------- .../_posts/2014-02-01-scala-fame-2014-01.md | 147 -------------- .../_posts/2014-03-01-scala-fame-2014-02.md | 133 ------------ .../_posts/2014-04-01-scala-fame-2014-03.md | 112 ----------- .../_posts/2014-05-01-scala-fame-2014-04.md | 91 --------- .../_posts/2014-06-01-scala-fame-2014-05.md | 112 ----------- .../_posts/2014-07-01-scala-fame-2014-06.md | 98 --------- .../_posts/2014-08-01-scala-fame-2014-07.md | 98 --------- .../_posts/2014-09-01-scala-fame-2014-08.md | 70 ------- .../_posts/2014-10-01-scala-fame-2014-09.md | 84 -------- .../_posts/2014-11-01-scala-fame-2014-10.md | 63 ------ .../_posts/2014-12-01-scala-fame-2014-11.md | 112 ----------- .../_posts/2015-01-01-scala-fame-2014-12.md | 70 ------- .../_posts/2015-02-01-scala-fame-2015-01.md | 56 ------ .../_posts/2015-03-01-scala-fame-2015-02.md | 70 ------- .../_posts/2015-04-01-scala-fame-2015-03.md | 91 --------- .../_posts/2015-11-01-scala-fame-2015-10.md | 42 ---- .../_posts/2015-12-01-scala-fame-2015-11.md | 63 ------ contribute/scala-fame.md | 21 -- 31 files changed, 1 insertion(+), 3102 deletions(-) delete mode 100644 contribute/scala-fame-data/_posts/2013-02-01-scala-fame-2013-01.md delete mode 100644 contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md delete mode 100644 contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md delete mode 100644 contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md delete mode 100644 contribute/scala-fame-data/_posts/2013-06-01-scala-fame-2013-05.md delete mode 100644 contribute/scala-fame-data/_posts/2013-07-01-scala-fame-2013-06.md delete mode 100644 contribute/scala-fame-data/_posts/2013-08-01-scala-fame-2013-07.md delete mode 100644 contribute/scala-fame-data/_posts/2013-09-01-scala-fame-2013-08.md delete mode 100644 contribute/scala-fame-data/_posts/2013-10-01-scala-fame-2013-09.md delete mode 100644 contribute/scala-fame-data/_posts/2013-11-01-scala-fame-2013-10.md delete mode 100644 contribute/scala-fame-data/_posts/2013-12-01-scala-fame-2013-11.md delete mode 100644 contribute/scala-fame-data/_posts/2014-01-01-scala-fame-2013-12.md delete mode 100644 contribute/scala-fame-data/_posts/2014-02-01-scala-fame-2014-01.md delete mode 100644 contribute/scala-fame-data/_posts/2014-03-01-scala-fame-2014-02.md delete mode 100644 contribute/scala-fame-data/_posts/2014-04-01-scala-fame-2014-03.md delete mode 100644 contribute/scala-fame-data/_posts/2014-05-01-scala-fame-2014-04.md delete mode 100644 contribute/scala-fame-data/_posts/2014-06-01-scala-fame-2014-05.md delete mode 100644 contribute/scala-fame-data/_posts/2014-07-01-scala-fame-2014-06.md delete mode 100644 contribute/scala-fame-data/_posts/2014-08-01-scala-fame-2014-07.md delete mode 100644 contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md delete mode 100644 contribute/scala-fame-data/_posts/2014-10-01-scala-fame-2014-09.md delete mode 100644 contribute/scala-fame-data/_posts/2014-11-01-scala-fame-2014-10.md delete mode 100644 contribute/scala-fame-data/_posts/2014-12-01-scala-fame-2014-11.md delete mode 100644 contribute/scala-fame-data/_posts/2015-01-01-scala-fame-2014-12.md delete mode 100644 contribute/scala-fame-data/_posts/2015-02-01-scala-fame-2015-01.md delete mode 100644 contribute/scala-fame-data/_posts/2015-03-01-scala-fame-2015-02.md delete mode 100644 contribute/scala-fame-data/_posts/2015-04-01-scala-fame-2015-03.md delete mode 100644 contribute/scala-fame-data/_posts/2015-11-01-scala-fame-2015-10.md delete mode 100644 contribute/scala-fame-data/_posts/2015-12-01-scala-fame-2015-11.md delete mode 100644 contribute/scala-fame.md diff --git a/contribute/guide.md b/contribute/guide.md index 04fe50ae5b..148ceb7570 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -35,7 +35,7 @@ Just to name a few common reasons: * contributing a patch is the best way to make sure your desired changes will be available in the next Scala version * Scala is written in Scala, so going through the source code and patching it will improve your Scala-fu -* last but not least, you will make it into the [Scala Contributor Hall of Fame](scala-fame.html). +* last but not least, it only takes a few accepted commits to make it into the [Scala Contributor Hall of Fame](https://github.com/scala/scala/contributors). The main Scala project consists of the standard Scala library, the Scala reflection and macros library, the Scala compiler and the Scaladoc tool. This means there's plenty to choose from when deciding what to work on. diff --git a/contribute/scala-fame-data/_posts/2013-02-01-scala-fame-2013-01.md b/contribute/scala-fame-data/_posts/2013-02-01-scala-fame-2013-01.md deleted file mode 100644 index 68e990a7b7..0000000000 --- a/contribute/scala-fame-data/_posts/2013-02-01-scala-fame-2013-01.md +++ /dev/null @@ -1,175 +0,0 @@ ---- -layout: famearchive -title: Contributors of January 2013 -fame-year: 2013 -fame-month: 1 -fame-month-str: January -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 67 - linesAdded: 7112 - linesDeleted: 3063 - rank: 1 - newContributor: false - - username: paulp - gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 - commits: 37 - linesAdded: 1812 - linesDeleted: 1158 - rank: 2 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 22 - linesAdded: 1397 - linesDeleted: 561 - rank: 3 - newContributor: false - - username: JamesIry - gravatar: https://avatars0.githubusercontent.com/u/478012?v=2&s=60 - commits: 20 - linesAdded: 1156 - linesDeleted: 208 - rank: 4 - newContributor: false - - username: gkossakowski - gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 - commits: 5 - linesAdded: 422 - linesDeleted: 9 - rank: 5 - newContributor: false - - username: viktorklang - gravatar: https://avatars0.githubusercontent.com/u/10871?v=2&s=60 - commits: 2 - linesAdded: 187 - linesDeleted: 12 - rank: 6 - newContributor: false - - username: phaller - gravatar: https://avatars0.githubusercontent.com/u/289943?v=2&s=60 - commits: 2 - linesAdded: 21 - linesDeleted: 42 - rank: 6 - newContributor: false - - username: dragos - gravatar: https://avatars2.githubusercontent.com/u/133742?v=2&s=60 - commits: 1 - linesAdded: 6 - linesDeleted: 26 - rank: 7 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 28 - linesAdded: 8416 - linesDeleted: 2758 - rank: 1 - newContributor: false - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 8 - linesAdded: 1189 - linesDeleted: 418 - rank: 2 - newContributor: false - - username: heathermiller - gravatar: https://avatars0.githubusercontent.com/u/687163?v=2&s=60 - commits: 2 - linesAdded: 100 - linesDeleted: 15 - rank: 3 - newContributor: false - - username: namin - gravatar: https://avatars2.githubusercontent.com/u/6441?v=2&s=60 - commits: 1 - linesAdded: 23 - linesDeleted: 4 - rank: 4 - newContributor: false - - username: vjovanov - gravatar: https://avatars3.githubusercontent.com/u/352820?v=2&s=60 - commits: 1 - linesAdded: 38 - linesDeleted: 2 - rank: 4 - newContributor: false - - category: Community - authors: - - username: soc - gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 - commits: 13 - linesAdded: 886 - linesDeleted: 3152 - rank: 1 - newContributor: false - - username: kzys - gravatar: https://avatars2.githubusercontent.com/u/19111?v=2&s=60 - commits: 7 - linesAdded: 79 - linesDeleted: 40 - rank: 2 - newContributor: false - - username: danielhopkins - gravatar: https://avatars3.githubusercontent.com/u/91909?v=2&s=60 - commits: 2 - linesAdded: 146 - linesDeleted: 146 - rank: 3 - newContributor: true - - username: ViniciusMiana - gravatar: https://avatars1.githubusercontent.com/u/2053546?v=2&s=60 - commits: 2 - linesAdded: 47 - linesDeleted: 8 - rank: 3 - newContributor: false - - username: Blaisorblade - gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 - commits: 2 - linesAdded: 53 - linesDeleted: 6 - rank: 3 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 2 - linesAdded: 236 - linesDeleted: 183 - rank: 3 - newContributor: false - - username: eed3si9n - gravatar: https://avatars1.githubusercontent.com/u/184683?v=2&s=60 - commits: 1 - linesAdded: 35 - linesDeleted: 2 - rank: 4 - newContributor: false - - username: mt2309 - gravatar: https://avatars2.githubusercontent.com/u/816245?v=2&s=60 - commits: 1 - linesAdded: 24 - linesDeleted: 0 - rank: 4 - newContributor: false - - username: puffnfresh - gravatar: https://avatars1.githubusercontent.com/u/37715?v=2&s=60 - commits: 1 - linesAdded: 39 - linesDeleted: 3 - rank: 4 - newContributor: false - - username: khernyo - gravatar: https://avatars3.githubusercontent.com/u/447532?v=2&s=60 - commits: 1 - linesAdded: 2 - linesDeleted: 3 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md b/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md deleted file mode 100644 index 376563abce..0000000000 --- a/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md +++ /dev/null @@ -1,189 +0,0 @@ ---- -layout: famearchive -title: Contributors of February 2013 -fame-year: 2013 -fame-month: 2 -fame-month-str: February -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 38 - linesAdded: 2578 - linesDeleted: 2114 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 31 - linesAdded: 7110 - linesDeleted: 9889 - rank: 2 - newContributor: false - - username: JamesIry - gravatar: https://secure.gravatar.com/avatar/72b1a6b08fd8bb3068bd281974461c3e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 23 - linesAdded: 1673 - linesDeleted: 740 - rank: 3 - newContributor: false - - username: paulp - gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 10 - linesAdded: 1466 - linesDeleted: 1097 - rank: 4 - newContributor: false - - username: viktorklang - gravatar: https://secure.gravatar.com/avatar/4f674b2e79f1663864ff78e07ce4c8a8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 3 - linesAdded: 84 - linesDeleted: 53 - rank: 5 - newContributor: false - - username: gkossakowski - gravatar: https://secure.gravatar.com/avatar/e608c8cb27858cc5aaf7d0c1e57958d7?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 4 - linesDeleted: 1 - rank: 6 - newContributor: false - - username: huitseeker - gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 26 - linesDeleted: 0 - rank: 7 - newContributor: false - - username: rkuhn - gravatar: https://secure.gravatar.com/avatar/262b1ab25e66b1e15a48fa3f68703aad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 3 - linesDeleted: 2 - rank: 7 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 36 - linesAdded: 3379 - linesDeleted: 1635 - rank: 1 - newContributor: false - - username: lrytz - gravatar: https://secure.gravatar.com/avatar/d807dd5133a6fc14c821178e53c34091?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 3 - linesAdded: 213 - linesDeleted: 31 - rank: 2 - newContributor: false - - username: heathermiller - gravatar: https://secure.gravatar.com/avatar/54d0b6494927c0040b96ed327202e8dc?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 2 - linesDeleted: 1333 - rank: 3 - newContributor: false - - username: VladUreche - gravatar: https://secure.gravatar.com/avatar/5658ed1cea041577df360fd663c570fa?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 86 - linesDeleted: 32 - rank: 3 - newContributor: false - - username: hubertp - gravatar: https://secure.gravatar.com/avatar/e0dec64f93778e5c689c3873078a406f?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 297 - linesDeleted: 100 - rank: 3 - newContributor: false - - username: axel22 - gravatar: https://secure.gravatar.com/avatar/e9bdb4fada7e635fffb5e6f26e70cd1d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 9 - linesDeleted: 106 - rank: 4 - newContributor: false - - category: Community - authors: - - username: vigdorchik - gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 4 - linesAdded: 471 - linesDeleted: 410 - rank: 1 - newContributor: false - - username: vy - gravatar: https://secure.gravatar.com/avatar/bb8d759cf4230bcaa238fac0018af80c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 21 - linesDeleted: 21 - rank: 2 - newContributor: true - - username: u-abramchuk - gravatar: https://secure.gravatar.com/avatar/c70eb13a60582914b51966fdc1a18536?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 47 - linesDeleted: 13 - rank: 2 - newContributor: true - - username: jozic - gravatar: https://secure.gravatar.com/avatar/41fbba6d48e543a7dfa8c231b2d0286d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 8 - linesDeleted: 8 - rank: 3 - newContributor: true - - username: rnix - gravatar: https://secure.gravatar.com/avatar/0dcbf348a28f2295164c53a40d48a958?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 3 - newContributor: true - - username: mergeconflict - gravatar: https://secure.gravatar.com/avatar/9a58682929b182af7b01f0180e072fcd?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 22 - linesDeleted: 15 - rank: 3 - newContributor: false - - username: mt2309 - gravatar: https://secure.gravatar.com/avatar/f70e1d36b9c1b9290d31e810fa1502f3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 3 - linesDeleted: 0 - rank: 3 - newContributor: false - - username: ViniciusMiana - gravatar: https://secure.gravatar.com/avatar/e05e828a92458c4075b498c7d2957ddd?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 16 - linesDeleted: 0 - rank: 3 - newContributor: false - - username: Blaisorblade - gravatar: https://secure.gravatar.com/avatar/a3a676c96a88feb813010e67af012ca0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 0 - linesDeleted: 3 - rank: 3 - newContributor: false - - username: khernyo - gravatar: https://secure.gravatar.com/avatar/0e0d750a49edb4b16e8ec83816ea356e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 25 - linesDeleted: 1 - rank: 3 - newContributor: false - - username: som-snytt - gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 3 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md b/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md deleted file mode 100644 index 0feb88618a..0000000000 --- a/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md +++ /dev/null @@ -1,147 +0,0 @@ ---- -layout: famearchive -title: Contributors of March 2013 -fame-year: 2013 -fame-month: 3 -fame-month-str: March -fame-categories: - - category: Typesafe - authors: - - username: paulp - gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 51 - linesAdded: 38101 - linesDeleted: 37753 - rank: 1 - newContributor: false - - username: retronym - gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 46 - linesAdded: 4908 - linesDeleted: 3092 - rank: 2 - newContributor: false - - username: adriaanm - gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 27 - linesAdded: 2675 - linesDeleted: 5043 - rank: 3 - newContributor: false - - username: JamesIry - gravatar: https://secure.gravatar.com/avatar/72b1a6b08fd8bb3068bd281974461c3e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 7 - linesAdded: 1218 - linesDeleted: 171 - rank: 4 - newContributor: false - - username: dragos - gravatar: https://secure.gravatar.com/avatar/fbd384e9626d28d1648f023a5e22672f?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 169 - linesDeleted: 2 - rank: 5 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 11 - linesAdded: 295 - linesDeleted: 129 - rank: 1 - newContributor: false - - username: magarciaEPFL - gravatar: https://secure.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 6 - linesAdded: 89 - linesDeleted: 44 - rank: 2 - newContributor: false - - category: Community - authors: - - username: vigdorchik - gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 9 - linesAdded: 714 - linesDeleted: 619 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 7 - linesAdded: 2103 - linesDeleted: 2068 - rank: 2 - newContributor: false - - username: soc - gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 6 - linesAdded: 166 - linesDeleted: 96 - rank: 3 - newContributor: false - - username: kzys - gravatar: https://secure.gravatar.com/avatar/7828b45f8396aa361d85cead01fd99ca?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 5 - linesAdded: 129 - linesDeleted: 41 - rank: 4 - newContributor: false - - username: Blaisorblade - gravatar: https://secure.gravatar.com/avatar/a3a676c96a88feb813010e67af012ca0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 3 - linesAdded: 72 - linesDeleted: 20 - rank: 5 - newContributor: false - - username: starblood - gravatar: https://secure.gravatar.com/avatar/bd3514b960213c6a7ff5fd3186675429?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 6 - newContributor: true - - username: srinivasreddy - gravatar: https://secure.gravatar.com/avatar/1f542afb3240b82fdf08632bf6cd5384?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 6 - newContributor: true - - username: mesagie - gravatar: https://secure.gravatar.com/avatar/6e7dc465ed74b5250147168a0178d91c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 4 - linesDeleted: 5 - rank: 6 - newContributor: true - - username: mergeconflict - gravatar: https://secure.gravatar.com/avatar/9a58682929b182af7b01f0180e072fcd?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 22 - linesDeleted: 15 - rank: 6 - newContributor: false - - username: sschaef - gravatar: https://secure.gravatar.com/avatar/dd80aab570fdb5f37e62de5422f44ed4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 13 - linesDeleted: 0 - rank: 6 - newContributor: false - - username: ihji - gravatar: https://secure.gravatar.com/avatar/866a258f0c9fa9529aa47ebd96fe599c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 33 - linesDeleted: 6 - rank: 6 - newContributor: false - - username: chuvoks - gravatar: https://secure.gravatar.com/avatar/415869059046602f37803890bd992fc0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 45 - linesDeleted: 24 - rank: 6 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md b/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md deleted file mode 100644 index e2cd419e9b..0000000000 --- a/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md +++ /dev/null @@ -1,126 +0,0 @@ ---- -layout: famearchive -title: Contributors of April 2013 -fame-year: 2013 -fame-month: 4 -fame-month-str: April -fame-categories: - - category: Typesafe - authors: - - username: paulp - gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 38 - linesAdded: 3745 - linesDeleted: 2973 - rank: 1 - newContributor: false - - username: retronym - gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 37 - linesAdded: 1309 - linesDeleted: 777 - rank: 2 - newContributor: false - - username: huitseeker - gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 3 - linesAdded: 16 - linesDeleted: 24 - rank: 3 - newContributor: false - - username: adriaanm - gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 35 - linesDeleted: 82 - rank: 4 - newContributor: false - - category: EPFL - authors: - - username: magarciaEPFL - gravatar: https://secure.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 11 - linesAdded: 238 - linesDeleted: 204 - rank: 1 - newContributor: false - - username: xeno-by - gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 4 - linesAdded: 208 - linesDeleted: 121 - rank: 2 - newContributor: false - - username: namin - gravatar: https://secure.gravatar.com/avatar/f2adf4eb83e1221b519d23bf0bdc98d2?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 6 - linesDeleted: 11 - rank: 3 - newContributor: false - - username: heathermiller - gravatar: https://secure.gravatar.com/avatar/54d0b6494927c0040b96ed327202e8dc?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 3 - newContributor: false - - username: hubertp - gravatar: https://secure.gravatar.com/avatar/e0dec64f93778e5c689c3873078a406f?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 54 - linesDeleted: 46 - rank: 3 - newContributor: false - - category: Community - authors: - - username: som-snytt - gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 16 - linesAdded: 2561 - linesDeleted: 1150 - rank: 1 - newContributor: false - - username: vigdorchik - gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 9 - linesAdded: 235 - linesDeleted: 321 - rank: 2 - newContributor: false - - username: soc - gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 4 - linesAdded: 38 - linesDeleted: 26 - rank: 3 - newContributor: false - - username: ihji - gravatar: https://secure.gravatar.com/avatar/866a258f0c9fa9529aa47ebd96fe599c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 13 - linesDeleted: 2 - rank: 4 - newContributor: false - - username: bjornregnell - gravatar: https://secure.gravatar.com/avatar/b1d20c98b0eeb72829523144b9174ca2?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 3 - linesDeleted: 2 - rank: 5 - newContributor: true - - username: aldenml - gravatar: https://secure.gravatar.com/avatar/bbf061bd484515c156f662a65820c226?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 4 - linesDeleted: 4 - rank: 5 - newContributor: true - - username: eed3si9n - gravatar: https://secure.gravatar.com/avatar/8f41595db400be30176f6f04630c2842?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 304 - linesDeleted: 6 - rank: 5 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-06-01-scala-fame-2013-05.md b/contribute/scala-fame-data/_posts/2013-06-01-scala-fame-2013-05.md deleted file mode 100644 index 2829d6a4aa..0000000000 --- a/contribute/scala-fame-data/_posts/2013-06-01-scala-fame-2013-05.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -layout: famearchive -title: Contributors of May 2013 -fame-year: 2013 -fame-month: 5 -fame-month-str: May -fame-categories: - - category: Typesafe - authors: - - username: paulp - gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 54 - linesAdded: 3465 - linesDeleted: 2035 - rank: 1 - newContributor: false - - username: retronym - gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 13 - linesAdded: 525 - linesDeleted: 66 - rank: 2 - newContributor: false - - username: adriaanm - gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 5 - linesAdded: 245 - linesDeleted: 81 - rank: 3 - newContributor: false - - username: viktorklang - gravatar: https://secure.gravatar.com/avatar/4f674b2e79f1663864ff78e07ce4c8a8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 51 - linesDeleted: 32 - rank: 4 - newContributor: false - - username: phaller - gravatar: https://secure.gravatar.com/avatar/3b84657fdb075382e3781310ca8a9a70?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 1965 - linesDeleted: 1086 - rank: 5 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 19 - linesAdded: 742 - linesDeleted: 468 - rank: 1 - newContributor: false - - username: magarciaEPFL - gravatar: https://secure.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 11 - linesAdded: 1214 - linesDeleted: 1069 - rank: 2 - newContributor: false - - username: heathermiller - gravatar: https://secure.gravatar.com/avatar/54d0b6494927c0040b96ed327202e8dc?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 10 - linesDeleted: 7 - rank: 3 - newContributor: false - - category: Community - authors: - - username: soc - gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 12 - linesAdded: 254 - linesDeleted: 1135 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 6 - linesAdded: 454 - linesDeleted: 403 - rank: 2 - newContributor: false - - username: vigdorchik - gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 42 - linesDeleted: 32 - rank: 3 - newContributor: false - - username: dcsobral - gravatar: https://secure.gravatar.com/avatar/6d43da5df0e52fc31c55e6a227bb23f4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 6 - linesDeleted: 2 - rank: 4 - newContributor: false - - username: kzys - gravatar: https://secure.gravatar.com/avatar/7828b45f8396aa361d85cead01fd99ca?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 25 - linesDeleted: 9 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-07-01-scala-fame-2013-06.md b/contribute/scala-fame-data/_posts/2013-07-01-scala-fame-2013-06.md deleted file mode 100644 index e2fa22bf84..0000000000 --- a/contribute/scala-fame-data/_posts/2013-07-01-scala-fame-2013-06.md +++ /dev/null @@ -1,126 +0,0 @@ ---- -layout: famearchive -title: Contributors of June 2013 -fame-year: 2013 -fame-month: 6 -fame-month-str: June -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 18 - linesAdded: 3583 - linesDeleted: 60 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 13 - linesAdded: 12207 - linesDeleted: 11500 - rank: 2 - newContributor: false - - username: paulp - gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 6 - linesAdded: 264 - linesDeleted: 1625 - rank: 3 - newContributor: false - - username: gkossakowski - gravatar: https://secure.gravatar.com/avatar/e608c8cb27858cc5aaf7d0c1e57958d7?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 3 - linesAdded: 296 - linesDeleted: 176 - rank: 4 - newContributor: false - - username: viktorklang - gravatar: https://secure.gravatar.com/avatar/4f674b2e79f1663864ff78e07ce4c8a8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 197 - linesDeleted: 546 - rank: 5 - newContributor: false - - username: huitseeker - gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 32 - linesDeleted: 1 - rank: 6 - newContributor: false - - category: EPFL - authors: - - username: magarciaEPFL - gravatar: https://secure.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 5 - linesAdded: 29 - linesDeleted: 27 - rank: 1 - newContributor: false - - username: VladUreche - gravatar: https://secure.gravatar.com/avatar/5658ed1cea041577df360fd663c570fa?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 4 - linesAdded: 383 - linesDeleted: 68 - rank: 2 - newContributor: false - - username: xeno-by - gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 57 - linesDeleted: 15 - rank: 3 - newContributor: false - - category: Community - authors: - - username: soc - gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 12 - linesAdded: 1071 - linesDeleted: 1200 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 5 - linesAdded: 273 - linesDeleted: 44 - rank: 2 - newContributor: false - - username: lexspoon - gravatar: https://secure.gravatar.com/avatar/d00741a2082647573efc2c15022ad15c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 5 - linesAdded: 90 - linesDeleted: 29 - rank: 2 - newContributor: false - - username: jedesah - gravatar: https://secure.gravatar.com/avatar/188a972e1c0a6d678a59bd6bce46da9a?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 3 - linesAdded: 23 - linesDeleted: 2 - rank: 3 - newContributor: false - - username: yllan - gravatar: https://secure.gravatar.com/avatar/ad23f5809b32c9dade553f80d6d7b2b9?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 124 - linesDeleted: 4 - rank: 4 - newContributor: true - - username: jannic - gravatar: https://secure.gravatar.com/avatar/c85c7cbcc9d464e178ba751449f893c7?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 9 - linesDeleted: 0 - rank: 5 - newContributor: false - - username: xuwei-k - gravatar: https://secure.gravatar.com/avatar/18d8b1bf73827b2a15e2bd3e75b4b34a?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 2 - linesDeleted: 2 - rank: 5 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-08-01-scala-fame-2013-07.md b/contribute/scala-fame-data/_posts/2013-08-01-scala-fame-2013-07.md deleted file mode 100644 index b6670c42ce..0000000000 --- a/contribute/scala-fame-data/_posts/2013-08-01-scala-fame-2013-07.md +++ /dev/null @@ -1,119 +0,0 @@ ---- -layout: famearchive -title: Contributors of July 2013 -fame-year: 2013 -fame-month: 7 -fame-month-str: July -fame-categories: - - category: Typesafe - authors: - - username: gkossakowski - gravatar: https://0.gravatar.com/avatar/e608c8cb27858cc5aaf7d0c1e57958d7?d=https%3A%2F%2Fidenticons.github.com%2F8196e8d0f9ee7dfdfc7e11dbbfa30d77.png&s=60 - commits: 11 - linesAdded: 522 - linesDeleted: 311 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://0.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?d=https%3A%2F%2Fidenticons.github.com%2Ff0d91e20ef53ace520f6ccbf8402319f.png&s=60 - commits: 9 - linesAdded: 1068 - linesDeleted: 11436 - rank: 2 - newContributor: false - - username: retronym - gravatar: https://0.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?d=https%3A%2F%2Fidenticons.github.com%2F75e4dffe50001cf8b96d3beecbe181be.png&s=60 - commits: 8 - linesAdded: 416 - linesDeleted: 134 - rank: 3 - newContributor: false - - username: paulp - gravatar: https://identicons.github.com/bf65417dcecc7f2b0006e1f5793b7143.png - commits: 2 - linesAdded: 46 - linesDeleted: 27 - rank: 4 - newContributor: false - - category: EPFL - authors: - - username: magarciaEPFL - gravatar: https://2.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?d=https%3A%2F%2Fidenticons.github.com%2F8b7440eff98d923640c99b5535429144.png&s=60 - commits: 12 - linesAdded: 1208 - linesDeleted: 1069 - rank: 1 - newContributor: false - - username: xeno-by - gravatar: https://2.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?d=https%3A%2F%2Fidenticons.github.com%2F6a5b1b05e953818962474e94b67d1cc2.png&s=60 - commits: 8 - linesAdded: 321 - linesDeleted: 95 - rank: 2 - newContributor: false - - username: VladUreche - gravatar: https://2.gravatar.com/avatar/5658ed1cea041577df360fd663c570fa?d=https%3A%2F%2Fidenticons.github.com%2Fa1ef2fed16f85a1af890467a80c30226.png&s=60 - commits: 2 - linesAdded: 104 - linesDeleted: 2 - rank: 3 - newContributor: false - - username: cvogt - gravatar: https://1.gravatar.com/avatar/669fb4eab529fba02f390051ddf3c8d3?d=https%3A%2F%2Fidenticons.github.com%2F78d9e7d7c73ac19ca8da9805762e5bb0.png&s=60 - commits: 1 - linesAdded: 19 - linesDeleted: 0 - rank: 4 - newContributor: false - - category: Community - authors: - - username: soc - gravatar: https://0.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?d=https%3A%2F%2Fidenticons.github.com%2F29f7ac3adbe1d3500c9404388aedcbfd.png&s=60 - commits: 19 - linesAdded: 2818 - linesDeleted: 4377 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://2.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?d=https%3A%2F%2Fidenticons.github.com%2Fd292a902ebb73981efd65c9ef416046b.png&s=60 - commits: 16 - linesAdded: 1049 - linesDeleted: 553 - rank: 2 - newContributor: false - - username: densh - gravatar: https://0.gravatar.com/avatar/5ed274e115ec061d062d9c32a539cdc9?d=https%3A%2F%2Fidenticons.github.com%2Fcd3e73ab183ea35424f0bf59101a74e4.png&s=60 - commits: 9 - linesAdded: 2632 - linesDeleted: 178 - rank: 3 - newContributor: false - - username: folone - gravatar: https://2.gravatar.com/avatar/50e7e3f60b3507383d2b327857b66a62?d=https%3A%2F%2Fidenticons.github.com%2F6c2bcbccd23191b40f4932e2b8450681.png&s=60 - commits: 3 - linesAdded: 106 - linesDeleted: 261 - rank: 4 - newContributor: false - - username: xuwei-k - gravatar: https://2.gravatar.com/avatar/18d8b1bf73827b2a15e2bd3e75b4b34a?d=https%3A%2F%2Fidenticons.github.com%2Fdab0069935d770e6285411ed1f4398b9.png&s=60 - commits: 3 - linesAdded: 5 - linesDeleted: 5 - rank: 4 - newContributor: false - - username: gourlaysama - gravatar: https://2.gravatar.com/avatar/8acf3c87222f89b18786c8db60eb365d?d=https%3A%2F%2Fidenticons.github.com%2F76004d7b1fac3a2b262caa5e6bdf15c9.png&s=60 - commits: 2 - linesAdded: 67 - linesDeleted: 3 - rank: 5 - newContributor: false - - username: ScrapCodes - gravatar: https://0.gravatar.com/avatar/e9813bbbab2caa993bf7e2b2d60de894?d=https%3A%2F%2Fidenticons.github.com%2F38c660c74f82a216b75167debab770ed.png&s=60 - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 6 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-09-01-scala-fame-2013-08.md b/contribute/scala-fame-data/_posts/2013-09-01-scala-fame-2013-08.md deleted file mode 100644 index c876e815d1..0000000000 --- a/contribute/scala-fame-data/_posts/2013-09-01-scala-fame-2013-08.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -layout: famearchive -title: Contributors of August 2013 -fame-year: 2013 -fame-month: 8 -fame-month-str: August -fame-categories: - - category: Typesafe - authors: - - username: paulp - gravatar: https://identicons.github.com/bf65417dcecc7f2b0006e1f5793b7143.png - commits: 50 - linesAdded: 3703 - linesDeleted: 2269 - rank: 1 - newContributor: false - - username: retronym - gravatar: https://0.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?d=https%3A%2F%2Fidenticons.github.com%2F75e4dffe50001cf8b96d3beecbe181be.png&s=60 - commits: 30 - linesAdded: 990 - linesDeleted: 167 - rank: 2 - newContributor: false - - username: adriaanm - gravatar: https://0.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?d=https%3A%2F%2Fidenticons.github.com%2Ff0d91e20ef53ace520f6ccbf8402319f.png&s=60 - commits: 6 - linesAdded: 224 - linesDeleted: 11001 - rank: 3 - newContributor: false - - username: huitseeker - gravatar: https://0.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?d=https%3A%2F%2Fidenticons.github.com%2F0777acff7c9ab34562699e4e1d05affb.png&s=60 - commits: 2 - linesAdded: 6 - linesDeleted: 6 - rank: 4 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://2.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?d=https%3A%2F%2Fidenticons.github.com%2F6a5b1b05e953818962474e94b67d1cc2.png&s=60 - commits: 9 - linesAdded: 579 - linesDeleted: 419 - rank: 1 - newContributor: false - - username: magarciaEPFL - gravatar: https://2.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?d=https%3A%2F%2Fidenticons.github.com%2F8b7440eff98d923640c99b5535429144.png&s=60 - commits: 4 - linesAdded: 319 - linesDeleted: 105 - rank: 2 - newContributor: false - - category: Community - authors: - - username: densh - gravatar: https://0.gravatar.com/avatar/5ed274e115ec061d062d9c32a539cdc9?d=https%3A%2F%2Fidenticons.github.com%2Fcd3e73ab183ea35424f0bf59101a74e4.png&s=60 - commits: 19 - linesAdded: 687 - linesDeleted: 322 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://2.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?d=https%3A%2F%2Fidenticons.github.com%2Fd292a902ebb73981efd65c9ef416046b.png&s=60 - commits: 12 - linesAdded: 455 - linesDeleted: 91 - rank: 2 - newContributor: false - - username: soc - gravatar: https://0.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?d=https%3A%2F%2Fidenticons.github.com%2F29f7ac3adbe1d3500c9404388aedcbfd.png&s=60 - commits: 4 - linesAdded: 64 - linesDeleted: 27 - rank: 3 - newContributor: false - - username: gourlaysama - gravatar: https://2.gravatar.com/avatar/8acf3c87222f89b18786c8db60eb365d?d=https%3A%2F%2Fidenticons.github.com%2F76004d7b1fac3a2b262caa5e6bdf15c9.png&s=60 - commits: 2 - linesAdded: 50 - linesDeleted: 9 - rank: 4 - newContributor: false - - username: ScrapCodes - gravatar: https://0.gravatar.com/avatar/e9813bbbab2caa993bf7e2b2d60de894?d=https%3A%2F%2Fidenticons.github.com%2F38c660c74f82a216b75167debab770ed.png&s=60 - commits: 1 - linesAdded: 3 - linesDeleted: 0 - rank: 5 - newContributor: false - - username: folone - gravatar: https://2.gravatar.com/avatar/50e7e3f60b3507383d2b327857b66a62?d=https%3A%2F%2Fidenticons.github.com%2F6c2bcbccd23191b40f4932e2b8450681.png&s=60 - commits: 1 - linesAdded: 55 - linesDeleted: 7 - rank: 5 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-10-01-scala-fame-2013-09.md b/contribute/scala-fame-data/_posts/2013-10-01-scala-fame-2013-09.md deleted file mode 100644 index 23fa456fc0..0000000000 --- a/contribute/scala-fame-data/_posts/2013-10-01-scala-fame-2013-09.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -layout: famearchive -title: Contributors of September 2013 -fame-year: 2013 -fame-month: 9 -fame-month-str: September -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://2.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?d=https%3A%2F%2Fidenticons.github.com%2F75e4dffe50001cf8b96d3beecbe181be.png&s=60 - commits: 42 - linesAdded: 1459 - linesDeleted: 476 - rank: 1 - newContributor: false - - username: paulp - gravatar: https://identicons.github.com/bf65417dcecc7f2b0006e1f5793b7143.png - commits: 25 - linesAdded: 6603 - linesDeleted: 7419 - rank: 2 - newContributor: false - - username: huitseeker - gravatar: https://1.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?d=https%3A%2F%2Fidenticons.github.com%2F0777acff7c9ab34562699e4e1d05affb.png&s=60 - commits: 7 - linesAdded: 520 - linesDeleted: 536 - rank: 3 - newContributor: false - - username: gkossakowski - gravatar: https://0.gravatar.com/avatar/e608c8cb27858cc5aaf7d0c1e57958d7?d=https%3A%2F%2Fidenticons.github.com%2F8196e8d0f9ee7dfdfc7e11dbbfa30d77.png&s=60 - commits: 2 - linesAdded: 1443 - linesDeleted: 44 - rank: 4 - newContributor: false - - username: dragos - gravatar: https://2.gravatar.com/avatar/fbd384e9626d28d1648f023a5e22672f?d=https%3A%2F%2Fidenticons.github.com%2F6b660454242c937e501b88fd136132f8.png&s=60 - commits: 2 - linesAdded: 95 - linesDeleted: 13 - rank: 4 - newContributor: false - - username: jsuereth - gravatar: https://1.gravatar.com/avatar/5ed293320c06809a24812f56861201ad?d=https%3A%2F%2Fidenticons.github.com%2F11a5b5ef81cff76a0a1f3d042f635df3.png&s=60 - commits: 1 - linesAdded: 18 - linesDeleted: 37 - rank: 5 - newContributor: false - - username: adriaanm - gravatar: https://0.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?d=https%3A%2F%2Fidenticons.github.com%2Ff0d91e20ef53ace520f6ccbf8402319f.png&s=60 - commits: 1 - linesAdded: 5 - linesDeleted: 5 - rank: 5 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://1.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?d=https%3A%2F%2Fidenticons.github.com%2F6a5b1b05e953818962474e94b67d1cc2.png&s=60 - commits: 5 - linesAdded: 434 - linesDeleted: 153 - rank: 1 - newContributor: false - - username: sjrd - gravatar: https://1.gravatar.com/avatar/bc554c7355c8476dd63375b314b1bd97?d=https%3A%2F%2Fidenticons.github.com%2F7f7549008d59643d2ce9846ce0364947.png&s=60 - commits: 4 - linesAdded: 30 - linesDeleted: 9 - rank: 2 - newContributor: true - - category: Community - authors: - - username: densh - gravatar: https://1.gravatar.com/avatar/5ed274e115ec061d062d9c32a539cdc9?d=https%3A%2F%2Fidenticons.github.com%2Fcd3e73ab183ea35424f0bf59101a74e4.png&s=60 - commits: 20 - linesAdded: 1415 - linesDeleted: 594 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://1.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?d=https%3A%2F%2Fidenticons.github.com%2Fd292a902ebb73981efd65c9ef416046b.png&s=60 - commits: 11 - linesAdded: 367 - linesDeleted: 106 - rank: 2 - newContributor: false - - username: Ichoran - gravatar: https://0.gravatar.com/avatar/3698349ad0b898d398a6573f4d1f867a?d=https%3A%2F%2Fidenticons.github.com%2Ffc12483537f3df99d480423de674e099.png&s=60 - commits: 3 - linesAdded: 75 - linesDeleted: 27 - rank: 3 - newContributor: true - - username: sschaef - gravatar: https://0.gravatar.com/avatar/dd80aab570fdb5f37e62de5422f44ed4?d=https%3A%2F%2Fidenticons.github.com%2Fb5a662bc30d97b377338f5dfb2b4cc66.png&s=60 - commits: 3 - linesAdded: 84 - linesDeleted: 139 - rank: 3 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-11-01-scala-fame-2013-10.md b/contribute/scala-fame-data/_posts/2013-11-01-scala-fame-2013-10.md deleted file mode 100644 index 557955d60c..0000000000 --- a/contribute/scala-fame-data/_posts/2013-11-01-scala-fame-2013-10.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -layout: famearchive -title: Contributors of October 2013 -fame-year: 2013 -fame-month: 10 -fame-month-str: October -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 52 - linesAdded: 1917 - linesDeleted: 1778 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 18 - linesAdded: 1648 - linesDeleted: 1591 - rank: 2 - newContributor: false - - username: paulp - gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 - commits: 9 - linesAdded: 871 - linesDeleted: 1346 - rank: 3 - newContributor: false - - username: huitseeker - gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 - commits: 1 - linesAdded: 3 - linesDeleted: 0 - rank: 4 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 9 - linesAdded: 398 - linesDeleted: 2260 - rank: 1 - newContributor: false - - username: axel22 - gravatar: https://avatars1.githubusercontent.com/u/151774?v=2&s=60 - commits: 1 - linesAdded: 201 - linesDeleted: 74 - rank: 2 - newContributor: false - - category: Community - authors: - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 18 - linesAdded: 766 - linesDeleted: 422 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 4 - linesAdded: 114 - linesDeleted: 58 - rank: 2 - newContributor: false - - username: etaty - gravatar: https://avatars3.githubusercontent.com/u/461170?v=2&s=60 - commits: 2 - linesAdded: 2 - linesDeleted: 2 - rank: 3 - newContributor: false - - username: dotta - gravatar: https://avatars2.githubusercontent.com/u/703748?v=2&s=60 - commits: 2 - linesAdded: 68 - linesDeleted: 6 - rank: 3 - newContributor: false - - username: qerub - gravatar: https://avatars2.githubusercontent.com/u/636?v=2&s=60 - commits: 1 - linesAdded: 8 - linesDeleted: 0 - rank: 4 - newContributor: false - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 1 - linesAdded: 31 - linesDeleted: 1 - rank: 4 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 1 - linesAdded: 215 - linesDeleted: 25 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2013-12-01-scala-fame-2013-11.md b/contribute/scala-fame-data/_posts/2013-12-01-scala-fame-2013-11.md deleted file mode 100644 index 7fba955998..0000000000 --- a/contribute/scala-fame-data/_posts/2013-12-01-scala-fame-2013-11.md +++ /dev/null @@ -1,126 +0,0 @@ ---- -layout: famearchive -title: Contributors of November 2013 -fame-year: 2013 -fame-month: 11 -fame-month-str: November -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 44 - linesAdded: 1814 - linesDeleted: 1372 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 20 - linesAdded: 1945 - linesDeleted: 1463 - rank: 2 - newContributor: false - - username: paulp - gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 - commits: 4 - linesAdded: 62 - linesDeleted: 659 - rank: 3 - newContributor: false - - username: huitseeker - gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 - commits: 2 - linesAdded: 137 - linesDeleted: 87 - rank: 4 - newContributor: false - - username: phaller - gravatar: https://avatars0.githubusercontent.com/u/289943?v=2&s=60 - commits: 1 - linesAdded: 105 - linesDeleted: 101 - rank: 5 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 5 - linesAdded: 82 - linesDeleted: 12 - rank: 1 - newContributor: false - - username: heathermiller - gravatar: https://avatars0.githubusercontent.com/u/687163?v=2&s=60 - commits: 1 - linesAdded: 8 - linesDeleted: 5 - rank: 2 - newContributor: false - - category: Community - authors: - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 10 - linesAdded: 1089 - linesDeleted: 884 - rank: 1 - newContributor: false - - username: skyluc - gravatar: https://avatars3.githubusercontent.com/u/1098830?v=2&s=60 - commits: 6 - linesAdded: 1911 - linesDeleted: 53 - rank: 2 - newContributor: false - - username: dotta - gravatar: https://avatars2.githubusercontent.com/u/703748?v=2&s=60 - commits: 6 - linesAdded: 64 - linesDeleted: 47 - rank: 2 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 6 - linesAdded: 499 - linesDeleted: 197 - rank: 2 - newContributor: false - - username: soc - gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 - commits: 5 - linesAdded: 280 - linesDeleted: 97 - rank: 3 - newContributor: false - - username: sschaef - gravatar: https://avatars2.githubusercontent.com/u/488530?v=2&s=60 - commits: 4 - linesAdded: 182 - linesDeleted: 12 - rank: 4 - newContributor: false - - username: xuwei-k - gravatar: https://avatars3.githubusercontent.com/u/389787?v=2&s=60 - commits: 2 - linesAdded: 3 - linesDeleted: 3 - rank: 5 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 2 - linesAdded: 1179 - linesDeleted: 0 - rank: 5 - newContributor: false - - username: Blaisorblade - gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 - commits: 1 - linesAdded: 3 - linesDeleted: 3 - rank: 6 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-01-01-scala-fame-2013-12.md b/contribute/scala-fame-data/_posts/2014-01-01-scala-fame-2013-12.md deleted file mode 100644 index 80c4139b10..0000000000 --- a/contribute/scala-fame-data/_posts/2014-01-01-scala-fame-2013-12.md +++ /dev/null @@ -1,147 +0,0 @@ ---- -layout: famearchive -title: Contributors of December 2013 -fame-year: 2013 -fame-month: 12 -fame-month-str: December -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 28 - linesAdded: 901 - linesDeleted: 215 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 21 - linesAdded: 1386 - linesDeleted: 16746 - rank: 2 - newContributor: false - - username: paulp - gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 - commits: 9 - linesAdded: 899 - linesDeleted: 409 - rank: 3 - newContributor: false - - username: huitseeker - gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 - commits: 3 - linesAdded: 45 - linesDeleted: 38 - rank: 4 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 30 - linesAdded: 2170 - linesDeleted: 984 - rank: 1 - newContributor: false - - username: magarciaEPFL - gravatar: https://avatars2.githubusercontent.com/u/1249748?v=2&s=60 - commits: 5 - linesAdded: 47 - linesDeleted: 17 - rank: 2 - newContributor: false - - category: Community - authors: - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 20 - linesAdded: 1604 - linesDeleted: 703 - rank: 1 - newContributor: false - - username: soc - gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 - commits: 11 - linesAdded: 728 - linesDeleted: 606 - rank: 2 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 8 - linesAdded: 1490 - linesDeleted: 286 - rank: 3 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 6 - linesAdded: 382 - linesDeleted: 224 - rank: 4 - newContributor: false - - username: dotta - gravatar: https://avatars2.githubusercontent.com/u/703748?v=2&s=60 - commits: 5 - linesAdded: 265 - linesDeleted: 13 - rank: 5 - newContributor: false - - username: VladimirNik - gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 - commits: 2 - linesAdded: 7 - linesDeleted: 8 - rank: 6 - newContributor: false - - username: rklaehn - gravatar: https://avatars0.githubusercontent.com/u/248257?v=2&s=60 - commits: 2 - linesAdded: 2 - linesDeleted: 83 - rank: 6 - newContributor: false - - username: qerub - gravatar: https://avatars2.githubusercontent.com/u/636?v=2&s=60 - commits: 1 - linesAdded: 10 - linesDeleted: 11 - rank: 7 - newContributor: false - - username: jrudolph - gravatar: https://avatars1.githubusercontent.com/u/9868?v=2&s=60 - commits: 1 - linesAdded: 4 - linesDeleted: 4 - rank: 7 - newContributor: false - - username: skyluc - gravatar: https://avatars3.githubusercontent.com/u/1098830?v=2&s=60 - commits: 1 - linesAdded: 112 - linesDeleted: 54 - rank: 7 - newContributor: false - - username: non - gravatar: https://avatars3.githubusercontent.com/u/218045?v=2&s=60 - commits: 1 - linesAdded: 19 - linesDeleted: 8 - rank: 7 - newContributor: false - - username: xuwei-k - gravatar: https://avatars3.githubusercontent.com/u/389787?v=2&s=60 - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 7 - newContributor: false - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 1 - linesAdded: 136 - linesDeleted: 55 - rank: 7 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-02-01-scala-fame-2014-01.md b/contribute/scala-fame-data/_posts/2014-02-01-scala-fame-2014-01.md deleted file mode 100644 index ab8e808036..0000000000 --- a/contribute/scala-fame-data/_posts/2014-02-01-scala-fame-2014-01.md +++ /dev/null @@ -1,147 +0,0 @@ ---- -layout: famearchive -title: Contributors of January 2014 -fame-year: 2014 -fame-month: 1 -fame-month-str: January -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 37 - linesAdded: 2000 - linesDeleted: 2487 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 8 - linesAdded: 311 - linesDeleted: 175 - rank: 2 - newContributor: false - - username: gkossakowski - gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 - commits: 3 - linesAdded: 15 - linesDeleted: 5 - rank: 3 - newContributor: false - - username: huitseeker - gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 - commits: 2 - linesAdded: 81 - linesDeleted: 79 - rank: 4 - newContributor: false - - username: paulp - gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 - commits: 2 - linesAdded: 7 - linesDeleted: 5 - rank: 4 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 75 - linesAdded: 8908 - linesDeleted: 6023 - rank: 1 - newContributor: false - - category: Community - authors: - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 16 - linesAdded: 722 - linesDeleted: 295 - rank: 1 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 10 - linesAdded: 315 - linesDeleted: 103 - rank: 2 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 9 - linesAdded: 646 - linesDeleted: 201 - rank: 3 - newContributor: false - - username: VladimirNik - gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 - commits: 7 - linesAdded: 1729 - linesDeleted: 350 - rank: 4 - newContributor: false - - username: rklaehn - gravatar: https://avatars0.githubusercontent.com/u/248257?v=2&s=60 - commits: 6 - linesAdded: 1288 - linesDeleted: 39 - rank: 5 - newContributor: false - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 3 - linesAdded: 37 - linesDeleted: 7 - rank: 6 - newContributor: false - - username: cunei - gravatar: https://avatars2.githubusercontent.com/u/686260?v=2&s=60 - commits: 2 - linesAdded: 42 - linesDeleted: 12 - rank: 7 - newContributor: false - - username: Blaisorblade - gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 - commits: 2 - linesAdded: 51 - linesDeleted: 33 - rank: 7 - newContributor: false - - username: havocp - gravatar: https://avatars2.githubusercontent.com/u/218689?v=2&s=60 - commits: 1 - linesAdded: 38 - linesDeleted: 2 - rank: 8 - newContributor: false - - username: clhodapp - gravatar: https://avatars0.githubusercontent.com/u/108633?v=2&s=60 - commits: 1 - linesAdded: 22 - linesDeleted: 0 - rank: 8 - newContributor: false - - username: rjolly - gravatar: https://avatars3.githubusercontent.com/u/128610?v=2&s=60 - commits: 1 - linesAdded: 45 - linesDeleted: 38 - rank: 8 - newContributor: false - - username: xuwei-k - gravatar: https://avatars3.githubusercontent.com/u/389787?v=2&s=60 - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 8 - newContributor: false - - username: dotta - gravatar: https://avatars2.githubusercontent.com/u/703748?v=2&s=60 - commits: 1 - linesAdded: 67 - linesDeleted: 67 - rank: 8 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-03-01-scala-fame-2014-02.md b/contribute/scala-fame-data/_posts/2014-03-01-scala-fame-2014-02.md deleted file mode 100644 index 065ab45d13..0000000000 --- a/contribute/scala-fame-data/_posts/2014-03-01-scala-fame-2014-02.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -layout: famearchive -title: Contributors of February 2014 -fame-year: 2014 -fame-month: 2 -fame-month-str: February -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 47 - linesAdded: 1533 - linesDeleted: 1032 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 25 - linesAdded: 1043 - linesDeleted: 491 - rank: 2 - newContributor: false - - username: gkossakowski - gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 - commits: 4 - linesAdded: 1867 - linesDeleted: 1747 - rank: 3 - newContributor: false - - username: paulp - gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 - commits: 3 - linesAdded: 427 - linesDeleted: 15 - rank: 4 - newContributor: false - - username: dragos - gravatar: https://avatars2.githubusercontent.com/u/133742?v=2&s=60 - commits: 1 - linesAdded: 12 - linesDeleted: 3 - rank: 5 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 47 - linesAdded: 3989 - linesDeleted: 1545 - rank: 1 - newContributor: false - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 1 - linesAdded: 18 - linesDeleted: 13 - rank: 2 - newContributor: false - - category: Community - authors: - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 23 - linesAdded: 1166 - linesDeleted: 515 - rank: 1 - newContributor: false - - username: VladimirNik - gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 - commits: 10 - linesAdded: 2647 - linesDeleted: 2416 - rank: 2 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 9 - linesAdded: 662 - linesDeleted: 339 - rank: 3 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 8 - linesAdded: 277 - linesDeleted: 75 - rank: 4 - newContributor: false - - username: pavelpavlov - gravatar: https://avatars0.githubusercontent.com/u/1330451?v=2&s=60 - commits: 3 - linesAdded: 44 - linesDeleted: 54 - rank: 5 - newContributor: false - - username: Blaisorblade - gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 - commits: 3 - linesAdded: 6 - linesDeleted: 5 - rank: 5 - newContributor: false - - username: soc - gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 - commits: 3 - linesAdded: 476 - linesDeleted: 338 - rank: 5 - newContributor: false - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 2 - linesAdded: 7 - linesDeleted: 7 - rank: 6 - newContributor: false - - username: greenrd - gravatar: https://avatars1.githubusercontent.com/u/164965?v=2&s=60 - commits: 1 - linesAdded: 2 - linesDeleted: 3 - rank: 7 - newContributor: false - - username: clhodapp - gravatar: https://avatars0.githubusercontent.com/u/108633?v=2&s=60 - commits: 1 - linesAdded: 228 - linesDeleted: 0 - rank: 7 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-04-01-scala-fame-2014-03.md b/contribute/scala-fame-data/_posts/2014-04-01-scala-fame-2014-03.md deleted file mode 100644 index 954a870612..0000000000 --- a/contribute/scala-fame-data/_posts/2014-04-01-scala-fame-2014-03.md +++ /dev/null @@ -1,112 +0,0 @@ ---- -layout: famearchive -title: Contributors of March 2014 -fame-year: 2014 -fame-month: 3 -fame-month-str: March -fame-categories: - - category: Typesafe - authors: - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 79 - linesAdded: 24547 - linesDeleted: 24999 - rank: 1 - newContributor: false - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 21 - linesAdded: 622 - linesDeleted: 101 - rank: 2 - newContributor: false - - username: gkossakowski - gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 - commits: 3 - linesAdded: 236 - linesDeleted: 6 - rank: 3 - newContributor: false - - username: huitseeker - gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 - commits: 2 - linesAdded: 4 - linesDeleted: 2 - rank: 4 - newContributor: false - - username: szeiger - gravatar: https://avatars3.githubusercontent.com/u/54262?v=2&s=60 - commits: 1 - linesAdded: 8 - linesDeleted: 1 - rank: 5 - newContributor: false - - username: viktorklang - gravatar: https://avatars0.githubusercontent.com/u/10871?v=2&s=60 - commits: 1 - linesAdded: 7 - linesDeleted: 2 - rank: 5 - newContributor: false - - username: paulp - gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 - commits: 1 - linesAdded: 20 - linesDeleted: 3 - rank: 5 - newContributor: false - - category: EPFL - authors: - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 10 - linesAdded: 379 - linesDeleted: 76 - rank: 1 - newContributor: false - - category: Community - authors: - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 13 - linesAdded: 589 - linesDeleted: 115 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 4 - linesAdded: 31 - linesDeleted: 23 - rank: 2 - newContributor: false - - username: VladimirNik - gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 - commits: 2 - linesAdded: 1778 - linesDeleted: 1441 - rank: 3 - newContributor: false - - username: mkubala - gravatar: https://avatars0.githubusercontent.com/u/328844?v=2&s=60 - commits: 1 - linesAdded: 247 - linesDeleted: 53 - rank: 4 - newContributor: false - - username: puffnfresh - gravatar: https://avatars1.githubusercontent.com/u/37715?v=2&s=60 - commits: 1 - linesAdded: 0 - linesDeleted: 1 - rank: 4 - newContributor: false - - username: iainmcgin - gravatar: https://avatars0.githubusercontent.com/u/309153?v=2&s=60 - commits: 1 - linesAdded: 20 - linesDeleted: 19 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-05-01-scala-fame-2014-04.md b/contribute/scala-fame-data/_posts/2014-05-01-scala-fame-2014-04.md deleted file mode 100644 index 66c6819f17..0000000000 --- a/contribute/scala-fame-data/_posts/2014-05-01-scala-fame-2014-04.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -layout: famearchive -title: Contributors of April 2014 -fame-year: 2014 -fame-month: 4 -fame-month-str: April -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 9 - linesAdded: 177 - linesDeleted: 34 - rank: 1 - newContributor: false - - username: huitseeker - gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 - commits: 1 - linesAdded: 16 - linesDeleted: 1 - rank: 2 - newContributor: false - - username: gkossakowski - gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 - commits: 1 - linesAdded: 10 - linesDeleted: 3 - rank: 2 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 1 - linesAdded: 34 - linesDeleted: 2 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 2 - linesAdded: 202 - linesDeleted: 75 - rank: 1 - newContributor: false - - username: VladUreche - gravatar: https://avatars0.githubusercontent.com/u/428706?v=2&s=60 - commits: 1 - linesAdded: 24 - linesDeleted: 3 - rank: 2 - newContributor: false - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 1 - linesAdded: 12 - linesDeleted: 1 - rank: 2 - newContributor: false - - category: Community - authors: - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 3 - linesAdded: 51 - linesDeleted: 5 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 2 - linesAdded: 110 - linesDeleted: 51 - rank: 2 - newContributor: false - - username: lefou - gravatar: https://avatars2.githubusercontent.com/u/1321393?v=2&s=60 - commits: 1 - linesAdded: 45 - linesDeleted: 8 - rank: 3 - newContributor: false - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 1 - linesAdded: 4 - linesDeleted: 5 - rank: 3 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-06-01-scala-fame-2014-05.md b/contribute/scala-fame-data/_posts/2014-06-01-scala-fame-2014-05.md deleted file mode 100644 index f9191afb17..0000000000 --- a/contribute/scala-fame-data/_posts/2014-06-01-scala-fame-2014-05.md +++ /dev/null @@ -1,112 +0,0 @@ ---- -layout: famearchive -title: Contributors of May 2014 -fame-year: 2014 -fame-month: 5 -fame-month-str: May -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 32 - linesAdded: 951 - linesDeleted: 136 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 9 - linesAdded: 21 - linesDeleted: 70 - rank: 2 - newContributor: false - - username: gkossakowski - gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 - commits: 3 - linesAdded: 13 - linesDeleted: 18 - rank: 3 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 23 - linesAdded: 6048 - linesDeleted: 2325 - rank: 1 - newContributor: false - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 3 - linesAdded: 93 - linesDeleted: 3 - rank: 2 - newContributor: false - - category: Community - authors: - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 12 - linesAdded: 442 - linesDeleted: 238 - rank: 1 - newContributor: false - - username: lefou - gravatar: https://avatars2.githubusercontent.com/u/1321393?v=2&s=60 - commits: 3 - linesAdded: 14 - linesDeleted: 24 - rank: 2 - newContributor: false - - username: tvierling - gravatar: https://avatars3.githubusercontent.com/u/397857?v=2&s=60 - commits: 2 - linesAdded: 35 - linesDeleted: 11 - rank: 3 - newContributor: true - - username: clhodapp - gravatar: https://avatars0.githubusercontent.com/u/108633?v=2&s=60 - commits: 2 - linesAdded: 98 - linesDeleted: 51 - rank: 3 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 2 - linesAdded: 55 - linesDeleted: 16 - rank: 3 - newContributor: false - - username: mkubala - gravatar: https://avatars0.githubusercontent.com/u/328844?v=2&s=60 - commits: 1 - linesAdded: 1 - linesDeleted: 0 - rank: 4 - newContributor: false - - username: jedesah - gravatar: https://avatars1.githubusercontent.com/u/1780116?v=2&s=60 - commits: 1 - linesAdded: 23 - linesDeleted: 1 - rank: 4 - newContributor: false - - username: VladimirNik - gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 - commits: 1 - linesAdded: 78 - linesDeleted: 40 - rank: 4 - newContributor: false - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 1 - linesAdded: 14 - linesDeleted: 0 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-07-01-scala-fame-2014-06.md b/contribute/scala-fame-data/_posts/2014-07-01-scala-fame-2014-06.md deleted file mode 100644 index 5f051d08a7..0000000000 --- a/contribute/scala-fame-data/_posts/2014-07-01-scala-fame-2014-06.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -layout: famearchive -title: Contributors of June 2014 -fame-year: 2014 -fame-month: 6 -fame-month-str: June -fame-categories: - - category: Typesafe - authors: - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 14 - linesAdded: 873 - linesDeleted: 661 - rank: 1 - newContributor: false - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 8 - linesAdded: 166 - linesDeleted: 126 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 16 - linesAdded: 1865 - linesDeleted: 437 - rank: 1 - newContributor: false - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 4 - linesAdded: 164 - linesDeleted: 44 - rank: 2 - newContributor: false - - username: odersky - gravatar: https://avatars2.githubusercontent.com/u/795990?v=2&s=60 - commits: 1 - linesAdded: 36 - linesDeleted: 10 - rank: 3 - newContributor: false - - category: Community - authors: - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 7 - linesAdded: 275 - linesDeleted: 57 - rank: 1 - newContributor: false - - username: jxcoder - gravatar: https://avatars1.githubusercontent.com/u/1075547?v=2&s=60 - commits: 4 - linesAdded: 41 - linesDeleted: 19 - rank: 2 - newContributor: true - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 2 - linesAdded: 20 - linesDeleted: 6 - rank: 3 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 2 - linesAdded: 146 - linesDeleted: 41 - rank: 3 - newContributor: false - - username: jrudolph - gravatar: https://avatars1.githubusercontent.com/u/9868?v=2&s=60 - commits: 1 - linesAdded: 97 - linesDeleted: 4 - rank: 4 - newContributor: false - - username: Blaisorblade - gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 - commits: 1 - linesAdded: 6 - linesDeleted: 1 - rank: 4 - newContributor: false - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 1 - linesAdded: 17 - linesDeleted: 5 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-08-01-scala-fame-2014-07.md b/contribute/scala-fame-data/_posts/2014-08-01-scala-fame-2014-07.md deleted file mode 100644 index c57474778d..0000000000 --- a/contribute/scala-fame-data/_posts/2014-08-01-scala-fame-2014-07.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -layout: famearchive -title: Contributors of July 2014 -fame-year: 2014 -fame-month: 7 -fame-month-str: July -fame-categories: - - category: Typesafe - authors: - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 31 - linesAdded: 775 - linesDeleted: 712 - rank: 1 - newContributor: false - - username: phaller - gravatar: https://avatars0.githubusercontent.com/u/289943?v=2&s=60 - commits: 3 - linesAdded: 161 - linesDeleted: 49 - rank: 2 - newContributor: false - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 1 - linesAdded: 35 - linesDeleted: 34 - rank: 3 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 4 - linesAdded: 84 - linesDeleted: 29 - rank: 1 - newContributor: false - - category: Community - authors: - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 11 - linesAdded: 330 - linesDeleted: 226 - rank: 1 - newContributor: false - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 5 - linesAdded: 217 - linesDeleted: 94 - rank: 2 - newContributor: false - - username: dhgarrette - gravatar: https://avatars2.githubusercontent.com/u/484190?v=2&s=60 - commits: 2 - linesAdded: 1 - linesDeleted: 3 - rank: 3 - newContributor: true - - username: pocket7878 - gravatar: https://avatars1.githubusercontent.com/u/236528?v=2&s=60 - commits: 2 - linesAdded: 21 - linesDeleted: 13 - rank: 3 - newContributor: true - - username: dgruntz - gravatar: https://avatars3.githubusercontent.com/u/1516800?v=2&s=60 - commits: 2 - linesAdded: 4 - linesDeleted: 4 - rank: 3 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 1 - linesAdded: 26 - linesDeleted: 9 - rank: 4 - newContributor: false - - username: kzys - gravatar: https://avatars2.githubusercontent.com/u/19111?v=2&s=60 - commits: 1 - linesAdded: 19 - linesDeleted: 0 - rank: 4 - newContributor: false - - username: densh - gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 - commits: 1 - linesAdded: 3 - linesDeleted: 1 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md b/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md deleted file mode 100644 index afef86d3be..0000000000 --- a/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -layout: famearchive -title: Contributors of August 2014 -fame-year: 2014 -fame-month: 8 -fame-month-str: August -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 3 - linesAdded: 57 - linesDeleted: 4 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 2 - linesAdded: 57 - linesDeleted: 42 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 21 - linesAdded: 3764 - linesDeleted: 2122 - rank: 1 - newContributor: false - - category: Community - authors: - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 10 - linesAdded: 171 - linesDeleted: 7680 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 10 - linesAdded: 917 - linesDeleted: 543 - rank: 1 - newContributor: false - - username: gbasler - gravatar: https://avatars1.githubusercontent.com/u/273035?v=2&s=60 - commits: 1 - linesAdded: 14 - linesDeleted: 22 - rank: 2 - newContributor: false - - username: dgruntz - gravatar: https://avatars3.githubusercontent.com/u/1516800?v=2&s=60 - commits: 1 - linesAdded: 18 - linesDeleted: 18 - rank: 2 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 1 - linesAdded: 26 - linesDeleted: 27 - rank: 2 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-10-01-scala-fame-2014-09.md b/contribute/scala-fame-data/_posts/2014-10-01-scala-fame-2014-09.md deleted file mode 100644 index ee67016186..0000000000 --- a/contribute/scala-fame-data/_posts/2014-10-01-scala-fame-2014-09.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -layout: famearchive -title: Contributors of September 2014 -fame-year: 2014 -fame-month: 9 -fame-month-str: September -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 12 - linesAdded: 182 - linesDeleted: 23 - rank: 1 - newContributor: false - - username: dragos - gravatar: https://avatars2.githubusercontent.com/u/133742?v=2&s=60 - commits: 1 - linesAdded: 169 - linesDeleted: 169 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 6 - linesAdded: 262 - linesDeleted: 85 - rank: 1 - newContributor: false - - username: xeno-by - gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 - commits: 3 - linesAdded: 1272 - linesDeleted: 1240 - rank: 2 - newContributor: false - - category: Community - authors: - - username: gourlaysama - gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 - commits: 9 - linesAdded: 1782 - linesDeleted: 1227 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 - commits: 4 - linesAdded: 305 - linesDeleted: 125 - rank: 2 - newContributor: false - - username: puffnfresh - gravatar: https://avatars1.githubusercontent.com/u/37715?v=2&s=60 - commits: 3 - linesAdded: 42 - linesDeleted: 7 - rank: 3 - newContributor: false - - username: Ichoran - gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 - commits: 2 - linesAdded: 12 - linesDeleted: 1 - rank: 4 - newContributor: false - - username: gbasler - gravatar: https://avatars1.githubusercontent.com/u/273035?v=2&s=60 - commits: 1 - linesAdded: 115 - linesDeleted: 41 - rank: 5 - newContributor: false - - username: soc - gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 - commits: 1 - linesAdded: 4 - linesDeleted: 1 - rank: 5 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-11-01-scala-fame-2014-10.md b/contribute/scala-fame-data/_posts/2014-11-01-scala-fame-2014-10.md deleted file mode 100644 index 0c957577fb..0000000000 --- a/contribute/scala-fame-data/_posts/2014-11-01-scala-fame-2014-10.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -layout: famearchive -title: Contributors of October 2014 -fame-year: 2014 -fame-month: 10 -fame-month-str: October -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 - commits: 11 - linesAdded: 414 - linesDeleted: 51 - rank: 1 - newContributor: false - - username: gkossakowski - gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 - commits: 2 - linesAdded: 2 - linesDeleted: 2 - rank: 2 - newContributor: false - - username: adriaanm - gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 - commits: 2 - linesAdded: 54 - linesDeleted: 18 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 - commits: 4 - linesAdded: 146 - linesDeleted: 171 - rank: 1 - newContributor: false - - category: Community - authors: - - username: roberthoedicke - gravatar: https://avatars0.githubusercontent.com/u/9093826?v=2&s=60 - commits: 9 - linesAdded: 15 - linesDeleted: 15 - rank: 1 - newContributor: true - - username: puffnfresh - gravatar: https://avatars1.githubusercontent.com/u/37715?v=2&s=60 - commits: 1 - linesAdded: 19 - linesDeleted: 10 - rank: 2 - newContributor: false - - username: Blaisorblade - gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 - commits: 1 - linesAdded: 0 - linesDeleted: 93 - rank: 2 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2014-12-01-scala-fame-2014-11.md b/contribute/scala-fame-data/_posts/2014-12-01-scala-fame-2014-11.md deleted file mode 100644 index 3c95eb2521..0000000000 --- a/contribute/scala-fame-data/_posts/2014-12-01-scala-fame-2014-11.md +++ /dev/null @@ -1,112 +0,0 @@ ---- -layout: famearchive -title: Contributors of November 2014 -fame-year: 2014 -fame-month: 11 -fame-month-str: November -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 - commits: 24 - linesAdded: 650 - linesDeleted: 90 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 - commits: 3 - linesAdded: 208 - linesDeleted: 54 - rank: 2 - newContributor: false - - username: phaller - gravatar: https://avatars1.githubusercontent.com/u/289943?v=3&s=60 - commits: 1 - linesAdded: 10 - linesDeleted: 8 - rank: 3 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 - commits: 6 - linesAdded: 782 - linesDeleted: 32 - rank: 1 - newContributor: false - - username: heathermiller - gravatar: https://avatars1.githubusercontent.com/u/687163?v=3&s=60 - commits: 2 - linesAdded: 64 - linesDeleted: 66 - rank: 2 - newContributor: false - - category: Community - authors: - - username: gourlaysama - gravatar: https://avatars3.githubusercontent.com/u/733438?v=3&s=60 - commits: 7 - linesAdded: 245 - linesDeleted: 83 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 - commits: 3 - linesAdded: 53 - linesDeleted: 53 - rank: 2 - newContributor: false - - username: advancedxy - gravatar: https://avatars1.githubusercontent.com/u/807537?v=3&s=60 - commits: 2 - linesAdded: 2 - linesDeleted: 2 - rank: 3 - newContributor: true - - username: kanielc - gravatar: https://avatars1.githubusercontent.com/u/1334074?v=3&s=60 - commits: 2 - linesAdded: 3 - linesDeleted: 3 - rank: 3 - newContributor: true - - username: gdickinson - gravatar: https://avatars3.githubusercontent.com/u/1130928?v=3&s=60 - commits: 2 - linesAdded: 0 - linesDeleted: 380 - rank: 3 - newContributor: true - - username: Ichoran - gravatar: https://avatars2.githubusercontent.com/u/2298644?v=3&s=60 - commits: 2 - linesAdded: 35 - linesDeleted: 18 - rank: 3 - newContributor: false - - username: ruippeixotog - gravatar: https://avatars1.githubusercontent.com/u/613493?v=3&s=60 - commits: 1 - linesAdded: 81 - linesDeleted: 8 - rank: 4 - newContributor: false - - username: mpociecha - gravatar: https://avatars0.githubusercontent.com/u/6143494?v=3&s=60 - commits: 1 - linesAdded: 5 - linesDeleted: 2 - rank: 4 - newContributor: false - - username: soc - gravatar: https://avatars1.githubusercontent.com/u/42493?v=3&s=60 - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2015-01-01-scala-fame-2014-12.md b/contribute/scala-fame-data/_posts/2015-01-01-scala-fame-2014-12.md deleted file mode 100644 index c11348b33a..0000000000 --- a/contribute/scala-fame-data/_posts/2015-01-01-scala-fame-2014-12.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -layout: famearchive -title: Contributors of December 2014 -fame-year: 2014 -fame-month: 12 -fame-month-str: December -fame-categories: - - category: Typesafe - authors: - - username: adriaanm - gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 - commits: 2 - linesAdded: 962 - linesDeleted: 290 - rank: 1 - newContributor: false - - username: retronym - gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 - commits: 1 - linesAdded: 5 - linesDeleted: 1 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 - commits: 4 - linesAdded: 61 - linesDeleted: 50 - rank: 1 - newContributor: false - - category: Community - authors: - - username: gbasler - gravatar: https://avatars0.githubusercontent.com/u/273035?v=3&s=60 - commits: 2 - linesAdded: 567 - linesDeleted: 1 - rank: 1 - newContributor: false - - username: kanielc - gravatar: https://avatars1.githubusercontent.com/u/1334074?v=3&s=60 - commits: 1 - linesAdded: 43 - linesDeleted: 6 - rank: 2 - newContributor: false - - username: xuwei-k - gravatar: https://avatars2.githubusercontent.com/u/389787?v=3&s=60 - commits: 1 - linesAdded: 2 - linesDeleted: 2 - rank: 2 - newContributor: false - - username: gourlaysama - gravatar: https://avatars3.githubusercontent.com/u/733438?v=3&s=60 - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 2 - newContributor: false - - username: som-snytt - gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 - commits: 1 - linesAdded: 44 - linesDeleted: 3 - rank: 2 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2015-02-01-scala-fame-2015-01.md b/contribute/scala-fame-data/_posts/2015-02-01-scala-fame-2015-01.md deleted file mode 100644 index 4af6e3d778..0000000000 --- a/contribute/scala-fame-data/_posts/2015-02-01-scala-fame-2015-01.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -layout: famearchive -title: Contributors of January 2015 -fame-year: 2015 -fame-month: 1 -fame-month-str: January -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 - commits: 10 - linesAdded: 222 - linesDeleted: 26 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 - commits: 4 - linesAdded: 819 - linesDeleted: 636 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 - commits: 4 - linesAdded: 470 - linesDeleted: 152 - rank: 1 - newContributor: false - - category: Community - authors: - - username: kanielc - gravatar: https://avatars1.githubusercontent.com/u/1334074?v=3&s=60 - commits: 2 - linesAdded: 58 - linesDeleted: 2 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 - commits: 2 - linesAdded: 35 - linesDeleted: 41 - rank: 1 - newContributor: false - - username: dickwall - gravatar: https://avatars2.githubusercontent.com/u/56453?v=3&s=60 - commits: 1 - linesAdded: 74 - linesDeleted: 0 - rank: 2 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2015-03-01-scala-fame-2015-02.md b/contribute/scala-fame-data/_posts/2015-03-01-scala-fame-2015-02.md deleted file mode 100644 index 3fe846623b..0000000000 --- a/contribute/scala-fame-data/_posts/2015-03-01-scala-fame-2015-02.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -layout: famearchive -title: Contributors of February 2015 -fame-year: 2015 -fame-month: 2 -fame-month-str: February -fame-categories: - - category: Typesafe - authors: - - username: adriaanm - gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 - commits: 15 - linesAdded: 1199 - linesDeleted: 588 - rank: 1 - newContributor: false - - username: retronym - gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 - commits: 13 - linesAdded: 557 - linesDeleted: 64 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 - commits: 10 - linesAdded: 1629 - linesDeleted: 276 - rank: 1 - newContributor: false - - username: xeno-by - gravatar: https://avatars0.githubusercontent.com/u/609152?v=3&s=60 - commits: 2 - linesAdded: 108 - linesDeleted: 15 - rank: 2 - newContributor: false - - username: axel22 - gravatar: https://avatars0.githubusercontent.com/u/151774?v=3&s=60 - commits: 1 - linesAdded: 61 - linesDeleted: 0 - rank: 3 - newContributor: false - - category: Community - authors: - - username: Ichoran - gravatar: https://avatars2.githubusercontent.com/u/2298644?v=3&s=60 - commits: 3 - linesAdded: 62 - linesDeleted: 25 - rank: 1 - newContributor: false - - username: som-snytt - gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 - commits: 2 - linesAdded: 121 - linesDeleted: 30 - rank: 2 - newContributor: false - - username: milessabin - gravatar: https://avatars1.githubusercontent.com/u/131183?v=3&s=60 - commits: 1 - linesAdded: 123 - linesDeleted: 37 - rank: 3 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2015-04-01-scala-fame-2015-03.md b/contribute/scala-fame-data/_posts/2015-04-01-scala-fame-2015-03.md deleted file mode 100644 index 62e7ea2f58..0000000000 --- a/contribute/scala-fame-data/_posts/2015-04-01-scala-fame-2015-03.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -layout: famearchive -title: Contributors of March 2015 -fame-year: 2015 -fame-month: 3 -fame-month-str: March -fame-categories: - - category: Typesafe - authors: - - username: retronym - gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 - commits: 9 - linesAdded: 553 - linesDeleted: 27 - rank: 1 - newContributor: false - - username: adriaanm - gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 - commits: 6 - linesAdded: 12 - linesDeleted: 72 - rank: 2 - newContributor: false - - category: EPFL - authors: - - username: lrytz - gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 - commits: 18 - linesAdded: 2857 - linesDeleted: 916 - rank: 1 - newContributor: false - - username: xeno-by - gravatar: https://avatars0.githubusercontent.com/u/609152?v=3&s=60 - commits: 1 - linesAdded: 7 - linesDeleted: 5 - rank: 2 - newContributor: false - - category: Community - authors: - - username: gourlaysama - gravatar: https://avatars3.githubusercontent.com/u/733438?v=3&s=60 - commits: 4 - linesAdded: 132 - linesDeleted: 22 - rank: 1 - newContributor: false - - username: gbasler - gravatar: https://avatars0.githubusercontent.com/u/273035?v=3&s=60 - commits: 3 - linesAdded: 1986 - linesDeleted: 111 - rank: 2 - newContributor: false - - username: kzys - gravatar: https://avatars3.githubusercontent.com/u/19111?v=3&s=60 - commits: 2 - linesAdded: 37 - linesDeleted: 18 - rank: 3 - newContributor: false - - username: som-snytt - gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 - commits: 2 - linesAdded: 91 - linesDeleted: 7 - rank: 3 - newContributor: false - - username: sschaef - gravatar: https://avatars3.githubusercontent.com/u/488530?v=3&s=60 - commits: 1 - linesAdded: 1 - linesDeleted: 1 - rank: 4 - newContributor: false - - username: khernyo - gravatar: https://avatars2.githubusercontent.com/u/447532?v=3&s=60 - commits: 1 - linesAdded: 27 - linesDeleted: 8 - rank: 4 - newContributor: false - - username: soc - gravatar: https://avatars1.githubusercontent.com/u/42493?v=3&s=60 - commits: 1 - linesAdded: 7 - linesDeleted: 7 - rank: 4 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2015-11-01-scala-fame-2015-10.md b/contribute/scala-fame-data/_posts/2015-11-01-scala-fame-2015-10.md deleted file mode 100644 index 41698296db..0000000000 --- a/contribute/scala-fame-data/_posts/2015-11-01-scala-fame-2015-10.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -layout: famearchive -title: Contributors of October 2015 -fame-year: 2015 -fame-month: 10 -fame-month-str: October -fame-categories: - - category: Typesafe - authors: - - username: SethTisue - gravatar: https://avatars.githubusercontent.com/u/161079?v=3 - commits: 9 - linesAdded: 80 - linesDeleted: 55 - rank: 1 - newContributor: false - - category: EPFL - authors: - - username: sjrd - gravatar: https://avatars.githubusercontent.com/u/535934?v=3 - commits: 1 - linesAdded: 1 - linesDeleted: 4 - rank: 1 - newContributor: false - - category: Community - authors: - - username: performantdata - gravatar: https://avatars.githubusercontent.com/u/6363453?v=3 - commits: 6 - linesAdded: 97 - linesDeleted: 50 - rank: 1 - newContributor: true - - username: janekdb - gravatar: https://avatars.githubusercontent.com/u/1123855?v=3 - commits: 1 - linesAdded: 86 - linesDeleted: 71 - rank: 2 - newContributor: false ---- diff --git a/contribute/scala-fame-data/_posts/2015-12-01-scala-fame-2015-11.md b/contribute/scala-fame-data/_posts/2015-12-01-scala-fame-2015-11.md deleted file mode 100644 index 8f9b7ff3b1..0000000000 --- a/contribute/scala-fame-data/_posts/2015-12-01-scala-fame-2015-11.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -layout: famearchive -title: Contributors of November 2015 -fame-year: 2015 -fame-month: 11 -fame-month-str: November -fame-categories: - - category: Typesafe - authors: - - username: szeiger - gravatar: https://avatars.githubusercontent.com/u/54262?v=3 - commits: 5 - linesAdded: 427 - linesDeleted: 116 - rank: 1 - newContributor: false - - username: SethTisue - gravatar: https://avatars.githubusercontent.com/u/161079?v=3 - commits: 3 - linesAdded: 21 - linesDeleted: 21 - rank: 2 - newContributor: false - - username: retronym - gravatar: https://avatars.githubusercontent.com/u/65551?v=3 - commits: 3 - linesAdded: 44 - linesDeleted: 28 - rank: 2 - newContributor: false - - username: adriaanm - gravatar: https://avatars.githubusercontent.com/u/91083?v=3 - commits: 2 - linesAdded: 22 - linesDeleted: 25 - rank: 3 - newContributor: false - - username: lrytz - gravatar: https://avatars.githubusercontent.com/u/119636?v=3 - commits: 1 - linesAdded: 7 - linesDeleted: 18 - rank: 4 - newContributor: false - - category: EPFL - authors: - - category: Community - authors: - - username: janekdb - gravatar: https://avatars.githubusercontent.com/u/1123855?v=3 - commits: 6 - linesAdded: 76 - linesDeleted: 63 - rank: 1 - newContributor: false - - username: soc - gravatar: https://avatars.githubusercontent.com/u/42493?v=3 - commits: 2 - linesAdded: 14 - linesDeleted: 19 - rank: 2 - newContributor: false ---- diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md deleted file mode 100644 index 4b6591004a..0000000000 --- a/contribute/scala-fame.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -layout: page-full-width -title: Scala Contributor Hall of Fame ---- - -A big thank you to everyone who has contributed over the years to: - - - [the Scala library and compiler](https://github.com/scala/scala/contributors) - - [the Scala documentation website](https://github.com/scala/scala.github.com/contributors) - -What follows are the commit totals, to the 2.12.x branch of the scala/scala repo only, -for last month. (For a commit to be counted, it must have been both committed and merged -in the same month.) - -For a more detailed view of recent activity, see the repo's -[GitHub Pulse page](https://github.com/scala/scala/pulse/monthly). - -{% for data in site.categories.scala-fame-data limit:1 %} - {% assign famedata = data %} - {% include render-scala-fame.html %} -{% endfor %} From 76fa6b98681ed1603718b99c6c20ec003b11025b Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 24 Feb 2016 16:48:19 -0500 Subject: [PATCH 0094/3075] Typesafe -> Lightbend in a bunch of places --- contribute/documentation.md | 4 ++-- contribute/guide.md | 2 +- contribute/hacker-guide.md | 2 +- contribute/index.md | 4 ++-- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index d7597d8884..6b5c81a0fc 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -30,10 +30,10 @@ without creating an issue, but please look to see if there is an issue already s ### Examples/Tutorials in Activator Templates -[Typesafe Activator](https://typesafe.com/community/core-tools/activator-and-sbt) +[Lightbend Activator](https://www.lightbend.com/community/core-tools/activator-and-sbt) is a tool based on SBT, with a UI mode that is ideal for code based tutorials, overviews and walk-throughs. To contribute an example in activator, you can fork an existing template, edit it, add a tutorial, upload it to github and then submit the github project into the template repository. It's the fastest way to produce a working code example with tutorial. -Please see [Contributing an Activator Template](https://typesafe.com/activator/template/contribute) for more details. +Please see [Contributing an Activator Template](https://www.lightbend.com/activator/template/contribute) for more details. ### The Main Scala Documentation Site diff --git a/contribute/guide.md b/contribute/guide.md index 148ceb7570..b92bd2fe89 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -44,7 +44,7 @@ Typically the scaladoc tool provides a low entry point for new committers, so it On the Scala bug tracker you will find many bugs that are [marked as good starting points to contributing ("community" bugs)](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12111) or [that are not currently assigned](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12112) and that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. If you are interested in contributing code, we ask you to sign the -[Scala Contributor License Agreement](http://typesafe.com/contribute/cla/scala), +[Scala Contributor License Agreement](http://www.lightbend.com/contribute/cla/scala), which allows us to ensure that all code submitted to the project is unencumbered by copyrights or patents. diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index fb79d8166d..47ebafe634 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -402,7 +402,7 @@ Once you are satisfied with your work, synced with `master` and cleaned up your Now, we must simply submit our proposed patch. Navigate to your branch in GitHub (for me it was `https://github.com/xeno-by/scala/tree/ticket/6725`) and click the pull request button to submit your patch as a pull request to Scala. If you've never submitted patches to Scala, you will -need to sign the contributor license agreement, which [can be done online](http://typesafe.com/contribute/cla/scala) within a few minutes. +need to sign the contributor license agreement, which [can be done online](http://www.lightbend.com/contribute/cla/scala) within a few minutes. Submit a pull request diff --git a/contribute/index.md b/contribute/index.md index 137838aba4..925e83248e 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -27,7 +27,7 @@ Coordination of contribution efforts takes place on the

Documentation

-

Scaladoc (API), Activator templates, +

Scaladoc (API), Activator templates, docs.scala-lang.org and scala-lang.org.

@@ -119,7 +119,7 @@ to build and test a corpus of Scala open source projects against development versions of the Scala compiler and standard library in order to discover regressions prior to releases. -The build uses Typesafe's +The build uses Lightbend's [dbuild](https://github.com/typesafehub/dbuild) tool, which leverages [sbt](http://www.scala-sbt.org). From 55dfcf608ea8e8fd8a648ffa99ee9ccf45ae0486 Mon Sep 17 00:00:00 2001 From: Chase Long Date: Mon, 6 Jun 2016 21:12:56 -0500 Subject: [PATCH 0095/3075] Replace references to ant with corresponding sbt references --- contribute/hacker-guide.md | 105 ++++++++++--------------------------- 1 file changed, 29 insertions(+), 76 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 47ebafe634..dab991eba5 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -100,47 +100,25 @@ If you are new to Git and branching, read the [Branching Chapter](http://git-scm The next step after cloning your fork is setting up your machine to build Scala. -* It is recommended to use Java `1.6` (not `1.7` or `1.8`, because they might cause occasional glitches). -* The build tool is `ant`. If you are behind a HTTP proxy, include [`ANT_ARGS=-autoproxy`](https://ant.apache.org/manual/proxy.html) in your environment. -* The build runs the `pull-binary-libs.sh` script to download bootstrap libs. This requires `bash` and `curl`. -* The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. -* Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. +You need the following tools: -Building Scala is as easy as running `ant` in the root of your cloned repository. Be prepared to wait for a while-- a full "clean" build -takes 8+ minutes depending on your machine (and up to 30 minutes on older machines with less memory). Incremental builds are usually within 30-120 seconds range (again, your mileage might vary -with your hardware). - - 16:50 ~/Projects/scala (ticket/6725)$ ant - Buildfile: /Users/xeno_by/Projects/scala/build.xml - - strap.clean: - - pack.clean: - - init.jars.check: - - init.jars: - [echo] Updating bootstrap libs. (To do this by hand, run ./pull-binary-libs.sh) - [exec] Resolving [943cd5c8802b2a3a64a010efb86ec19bac142e40/lib/ant/ant-contrib.jar] - - ... - - pack.bin: - [mkdir] Created dir: /Users/xeno_by/Projects/scala/build/pack/bin +* A Java SDK. The baseline version is 6 for 2.11.x and 8 for 2.12.x. It's possible to use a later SDK for local development, but the continuous integration builds will verify against the baseline version. +* `sbt`, an interactive build tool commonly used in Scala projects. Acquiring sbt manually is not necessary -- the recommended approach is to download the [sbt-extras runner script](https://github.com/paulp/sbt-extras/blob/master/sbt) and use it in place of `sbt`. The script will download and run the correct version of sbt when run from the Scala repository's root directory. +* `curl` -- the build uses `curl` in the `pull-binary-libs.sh` script to download bootstrap libs. - pack.done: +The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. - build: - - BUILD SUCCESSFUL - Total time: 9 minutes 41 seconds +Building Scala is as easy as running `sbt dist/mkPack` in the root of your cloned repository. Be prepared to wait for a while -- a full "clean" build +takes 8+ minutes depending on your machine (and up to 30 minutes on older machines with less memory). Incremental builds are usually within 30-120 seconds range (again, your mileage might vary +with your hardware). ### IDE There's no single editor of choice for working with Scala sources, as there are trade-offs associated with each available tool. Both Eclipse and IntelliJ IDEA have Scala plugins, which are known to work with our codebase. -Both of those Scala plugins provide navigation, refactoring and error reporting functionality as well as integrated debugging. +Both of those Scala plugins provide navigation, refactoring, error reporting functionality, and integrated debugging. +See [the Scala README](https://github.com/scala/scala#ide-setup) for instructions on using Eclipse and IntelliJ IDEA with the Scala repository. There also exist lighter-weight editors such as Emacs, Sublime or jEdit which are faster and much less memory/compute-intensive to run, while lacking semantic services and debugging. To address this shortcoming, they can integrate with ENSIME, @@ -155,8 +133,8 @@ When hacking on your topic of choice, you'll be modifying Scala, compiling it an Typically you would want to first make sure that your changes work on a small example and afterwards verify that nothing break by running a comprehensive test suite. -We'll start by creating a `sandbox` directory (this particular name doesn't bear any special meaning), which will hold a single test file and its compilation results. First, let's make sure that -[the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by putting together a simple test and compiling and running it with the Scala compiler that we built using `ant`. The Scala compiler that we just built is located in `build/pack/bin`. +We'll start by creating a `sandbox` directory (`./sandbox is listed in the .gitignore of the Scala repository), which will hold a single test file and its compilation results. First, let's make sure that +[the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by putting together a simple test and compiling and running it with the Scala compiler that we built using `sbt`. The Scala compiler that we just built is located in `build/pack/bin`. 17:25 ~/Projects/scala (ticket/6725)$ mkdir sandbox 17:26 ~/Projects/scala (ticket/6725)$ cd sandbox @@ -178,31 +156,24 @@ Now, implement your bugfix or new feature! Here are also some tips & tricks that have proven useful in Scala development: * If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, - try doing `ant clean build`. Due to the way how Scala compiles traits, if a trait changes, then it's sometimes not enough to recompile - just that trait, but it might also be necessary to recompile its users. The `ant` tool is not smart enough to do that, which might lead to - very strange errors. Full-rebuilds fix the problem. Fortunately that's rarely necessary, because full-rebuilds take a lot of time-- the same 8-30 minutes as mentioned above. + try doing `sbt clean`. Due to the way Scala compiles traits, if a trait changes, then it's sometimes not enough to recompile + just that trait; it might also be necessary to recompile its users. The `sbt` tool is not smart enough to do that, which might lead to + very strange errors. Full rebuilds fix the problem. Fortunately that's rarely necessary, because full rebuilds take a lot of time -- the same 8-30 minutes as mentioned above. * Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, - some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts ([here](https://github.com/adriaanm/binfu/blob/master/scafu.sh) are some examples to get you started) to launch Scala from `build/quick/classes`. + some people in our team do `sbt compile` instead of `sbt dist/mkPack` and then create custom scripts using `sbt/mkBin` to launch Scala from `./build/quick/bin`. Also see [the Scala README](https://github.com/scala/scala#incremental-compilation) for tips on speeding up compile times. * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious - to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use `showRaw` to get the `AST` representation. -* You can publish your newly-built scala version locally to use it from sbt. Here's how: + to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use the Scala `showRaw` to get the `AST` representation. +* You can publish your newly-built scala version locally using `sbt publishLocal` to use it from `sbt`. Here's how: - $ ant publish-local-opt -Dmaven.version.suffix="-test" + $ sbt publishLocal // This may take a while + ... $ sbt - [info] Set current project to test (in build file:/Users/georgii/workspace/test/) - > set resolvers += Resolver.mavenLocal - [info] Defining *:resolvers - [info] The new value will be used by *:externalResolvers - [info] Reapplying settings... - [info] Set current project to test (in build file:/Users/georgii/workspace/test/) - > ++2.12.0-test - [info] Setting version to 2.12.0-test - [info] Set current project to test (in build file:/Users/georgii/workspace/test/) + ... > console [info] Starting scala interpreter... - [info] - Welcome to Scala version 2.12.0-20140623-155543-8bdacad317 (Java HotSpot(TM) 64-Bit Server VM, Java 1.7.0_51). + [info] + Welcome to Scala version 2.10.6 (OpenJDK 64-Bit Server VM, Java 1.8.0_91). Type in expressions to have them evaluated. Type :help for more information. @@ -212,7 +183,7 @@ Here are also some tips & tricks that have proven useful in Scala development: ### Documentation -There are several areas that one could contribute to-- there is the Scala library, the Scala compiler, and other tools such as Scaladoc. Each area has varying amounts of documentation. +There are several areas that one could contribute to -- there is the Scala library, the Scala compiler, and other tools such as Scaladoc. Each area has varying amounts of documentation. ##### The Scala Library @@ -263,22 +234,12 @@ but not tokens like `%n`. Looks like an easy fix. start = idx + 1 } -After applying the fix and running `ant`, our simple test case in `sandbox/Test.scala` started working! +After applying the fix and running `sbt compile`, our simple test case in `sandbox/Test.scala` started working! 18:51 ~/Projects/scala/sandbox (ticket/6725)$ cd .. - 18:51 ~/Projects/scala (ticket/6725)$ ant - Buildfile: /Users/xeno_by/Projects/scala/build.xml - + 18:51 ~/Projects/scala (ticket/6725)$ sbt compile ... - - quick.comp: - [scalacfork] Compiling 1 file to /Users/xeno_by/Projects/scala/build/quick/classes/compiler - [propertyfile] Updating property file: /Users/xeno_by/Projects/scala/build/quick/classes/compiler/compiler.properties - [stopwatch] [quick.comp.timer: 6.588 sec] - - ... - - BUILD SUCCESSFUL + [success] Total time: 18 s, completed Jun 6, 2016 9:03:02 PM Total time: 18 seconds 18:51 ~/Projects/scala (ticket/6725)$ cd sandbox @@ -332,15 +293,7 @@ Here are some more testing tips: [mima] } [mima] - BUILD FAILED - /localhome/jenkins/c/workspace/pr-scala-test/scala/build.xml:1530: The following error occurred while executing this line: - /localhome/jenkins/c/workspace/pr-scala-test/scala/build-ant-macros.xml:791: The following error occurred while executing this line: - /localhome/jenkins/c/workspace/pr-scala-test/scala/build-ant-macros.xml:773: Java returned: 2 - - Total time: 6 minutes 46 seconds - Build step 'Execute shell' marked build as failure - Archiving artifacts - Notifying upstream projects of job completion + ... Finished: FAILURE This means your change is backward or forward binary incompatible with the specified version (the check is performed by the [migration manager](https://github.com/typesafehub/migration-manager)). The error message is actually saying what you need to add to `bincompat-backward.whitelist.conf` or `bincompat-forward.whitelist.conf` to make the error go away. If you are getting this on an internal/experimental api, it should be safe to add suggested sections to the config. Otherwise, you might want to target a newer version of scala for this change. @@ -349,7 +302,7 @@ This means your change is backward or forward binary incompatible with the speci Now to make sure that my fix doesn't break anything I need to run the test suite using the `partest` tool we wrote to test Scala. Read up [the partest guide](partest-guide.html) to learn the details about partest, but in a nutshell you can either -run `ant test` to go through the entire test suite (30+ minutes) or use wildcards to limit the tests to something manageable: +run `sbt test` to go through the entire test suite (30+ minutes) or use wildcards to limit the tests to something manageable: 18:52 ~/Projects/scala/sandbox (ticket/6725)$ cd ../test 18:56 ~/Projects/scala/test (ticket/6725)$ partest files/run/*interpol* From 5532eb46c8ccd199485ee7dff88d97ec06f9e30d Mon Sep 17 00:00:00 2001 From: Chase Long Date: Tue, 7 Jun 2016 21:37:25 -0500 Subject: [PATCH 0096/3075] Changes per PR feedback --- contribute/hacker-guide.md | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index dab991eba5..09eb50a8a3 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -106,10 +106,10 @@ You need the following tools: * `sbt`, an interactive build tool commonly used in Scala projects. Acquiring sbt manually is not necessary -- the recommended approach is to download the [sbt-extras runner script](https://github.com/paulp/sbt-extras/blob/master/sbt) and use it in place of `sbt`. The script will download and run the correct version of sbt when run from the Scala repository's root directory. * `curl` -- the build uses `curl` in the `pull-binary-libs.sh` script to download bootstrap libs. -The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. +OS X and Linux builds should work. Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. Building Scala is as easy as running `sbt dist/mkPack` in the root of your cloned repository. Be prepared to wait for a while -- a full "clean" build -takes 8+ minutes depending on your machine (and up to 30 minutes on older machines with less memory). Incremental builds are usually within 30-120 seconds range (again, your mileage might vary +takes 5+ minutes depending on your machine (longer on older machines with less memory). Incremental builds are usually within 20-120 seconds range (again, your mileage might vary with your hardware). ### IDE @@ -155,12 +155,8 @@ Now, implement your bugfix or new feature! Here are also some tips & tricks that have proven useful in Scala development: -* If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, - try doing `sbt clean`. Due to the way Scala compiles traits, if a trait changes, then it's sometimes not enough to recompile - just that trait; it might also be necessary to recompile its users. The `sbt` tool is not smart enough to do that, which might lead to - very strange errors. Full rebuilds fix the problem. Fortunately that's rarely necessary, because full rebuilds take a lot of time -- the same 8-30 minutes as mentioned above. -* Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, - some people in our team do `sbt compile` instead of `sbt dist/mkPack` and then create custom scripts using `sbt/mkBin` to launch Scala from `./build/quick/bin`. Also see [the Scala README](https://github.com/scala/scala#incremental-compilation) for tips on speeding up compile times. +* Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, some people in our team do `sbt compile` instead of `sbt dist/mkPack` and then create custom scripts using `sbt/mkBin` to launch Scala from `./build/quick/bin/`. Also see [the Scala README](https://github.com/scala/scala#incremental-compilation) for tips on speeding up compile times. +* If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, try doing `sbt clean` and building again. * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use the Scala `showRaw` to get the `AST` representation. @@ -300,9 +296,9 @@ This means your change is backward or forward binary incompatible with the speci ### Verify -Now to make sure that my fix doesn't break anything I need to run the test suite using the `partest` tool we wrote to test Scala. -Read up [the partest guide](partest-guide.html) to learn the details about partest, but in a nutshell you can either -run `sbt test` to go through the entire test suite (30+ minutes) or use wildcards to limit the tests to something manageable: +Now to make sure that my fix doesn't break anything I need to run the test suite. The Scala test suite uses [JUnit](http://junit.org/junit4/) and [partest](partest-guide.html), a tool we wrote for testing Scala. +Run `sbt test` and `sbt partest` to run all of the JUnit and partest tests, respectively. +`partest` (not `sbt partest`) also allows you to run a subset of the tests using wildcards: 18:52 ~/Projects/scala/sandbox (ticket/6725)$ cd ../test 18:56 ~/Projects/scala/test (ticket/6725)$ partest files/run/*interpol* From 1ea529f4b4c2372c17561398ca1927a004daf7d7 Mon Sep 17 00:00:00 2001 From: Chase Long Date: Mon, 13 Jun 2016 20:11:59 -0500 Subject: [PATCH 0097/3075] Correct misleading instructions for publishing a local Scala version --- contribute/hacker-guide.md | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 09eb50a8a3..3426f37f82 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -160,20 +160,26 @@ Here are also some tips & tricks that have proven useful in Scala development: * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use the Scala `showRaw` to get the `AST` representation. -* You can publish your newly-built scala version locally using `sbt publishLocal` to use it from `sbt`. Here's how: +* You can publish your newly-built scala version locally using `sbt publishLocal`. Then, you can invoke a REPL using your version: $ sbt publishLocal // This may take a while ... $ sbt ... - > console - [info] Starting scala interpreter... - [info] - Welcome to Scala version 2.10.6 (OpenJDK 64-Bit Server VM, Java 1.8.0_91). - Type in expressions to have them evaluated. - Type :help for more information. - - scala> + > scala + [info] Running scala.tools.nsc.MainGenericRunner -usejavacp + Welcome to Scala 2.12.0-20160613-195040-cd85531 (OpenJDK 64-Bit Server VM, Java 1.8.0_91). + Type in expressions for evaluation. Or try :help. + + scala> + +Alternatively, you can invoke a REPL using the bash script in `./build/quick/bin/`: + + $ ./build/quick/bin/scala + Welcome to Scala 2.12.0-20160613-195040-cd85531 (OpenJDK 64-Bit Server VM, Java 1.8.0_91). + Type in expressions for evaluation. Or try :help. + + scala> * Adding a macro to the `Predef` object is a pretty involved task. Due to bootstrapping, you cannot just throw a macro into it. For this reason, the process is more involved. You might want to follow the way `StringContext.f` itself is added. In short, you need to define your macro under `src/compiler/scala/tools/reflect/` and provide no implementation in `Predef` (`def fn = macro ???`). Now you have to set up the wiring. Add the name of your macro to `src/reflect/scala/reflect/internal/StdNames.scala`, add the needed links to it to `src/reflect/scala/reflect/internal/Definitions.scala`, and finally specify the bindings in `src/compiler/scala/tools/reflect/FastTrack.scala`. [Here's](https://github.com/folone/scala/commit/59536ea833ca16c985339727baed5d70e577b0fe) an example of adding a macro. From 2a94e25b660c8eed80c3e412933d61a2a7eb1835 Mon Sep 17 00:00:00 2001 From: Alex Xandra Albert Sim Date: Wed, 14 Sep 2016 16:27:15 +0700 Subject: [PATCH 0098/3075] Update Ensime's contributing and readme page The current "readme" and "contributing" links on Ensime gives us a standard Github 404 page. This commit updates the links to valid URLs. --- contribute/tools.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/contribute/tools.md b/contribute/tools.md index 1757ae1005..494d2e54cf 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -76,8 +76,8 @@ Stuff changes. Found a broken link or something that needs updating on this page

Scala Support for Text Editors

Home | Issues | -ReadMe | -Contributing

+ReadMe | +Contributing

@@ -126,4 +126,4 @@ The following projects are important to the Scala community but are particularly - \ No newline at end of file + From a41edfc053abb0e97d951e9fdd462ebec99135e8 Mon Sep 17 00:00:00 2001 From: Adriaan Moors Date: Wed, 26 Oct 2016 10:54:45 -0700 Subject: [PATCH 0099/3075] Implement some review feedback, some polish of my own Reworks #438 --- contribute/hacker-guide.md | 54 ++++++++++++++++++++------------------ 1 file changed, 28 insertions(+), 26 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 3426f37f82..09532edecd 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -108,9 +108,9 @@ You need the following tools: OS X and Linux builds should work. Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. -Building Scala is as easy as running `sbt dist/mkPack` in the root of your cloned repository. Be prepared to wait for a while -- a full "clean" build -takes 5+ minutes depending on your machine (longer on older machines with less memory). Incremental builds are usually within 20-120 seconds range (again, your mileage might vary -with your hardware). +Building Scala is as easy as running `sbt dist/mkPack` in the root of your cloned repository. In general, it's much more efficient to enter the `sbt` shell once and run the various tasks from there, instead of running each task by launching `sbt some-task` on your command prompt. + +Be prepared to wait for a while -- a full "clean" build takes 5+ minutes depending on your machine (longer on older machines with less memory). On a recent laptop, incremental builds usually complete within 10-30 seconds. ### IDE @@ -155,31 +155,33 @@ Now, implement your bugfix or new feature! Here are also some tips & tricks that have proven useful in Scala development: -* Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, some people in our team do `sbt compile` instead of `sbt dist/mkPack` and then create custom scripts using `sbt/mkBin` to launch Scala from `./build/quick/bin/`. Also see [the Scala README](https://github.com/scala/scala#incremental-compilation) for tips on speeding up compile times. -* If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, try doing `sbt clean` and building again. +* After building your working copy with the `compile` sbt task, there's no need to leave the comfort of your sbt shell to try it out: the REPL is available as the `scala` task, and you can also run the compiler using the `scalac` task. If you prefer to run the REPL outside sbt, you can generate the scripts in `build/quick/bin` using the `dist/mkQuick` task. +* The sbt workflow is also great for debugging, as you can simply create a remote debugging session in your favorite IDE, and then activate the JVM options for the next time you run the `scala` or `scalac` tasks using: + +``` +> set javaOptions in compiler := List("-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8002") +> scalac test.scala +[info] Running scala.tools.nsc.Main -usejavacp test.scala +Listening for transport dt_socket at address: 8002 +``` + +* Also see [the Scala README](https://github.com/scala/scala#incremental-compilation) for tips on speeding up compile times. +* If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, try the `clean` task and building again. * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious - to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use the Scala `showRaw` to get the `AST` representation. -* You can publish your newly-built scala version locally using `sbt publishLocal`. Then, you can invoke a REPL using your version: - - $ sbt publishLocal // This may take a while - ... - $ sbt - ... - > scala - [info] Running scala.tools.nsc.MainGenericRunner -usejavacp - Welcome to Scala 2.12.0-20160613-195040-cd85531 (OpenJDK 64-Bit Server VM, Java 1.8.0_91). - Type in expressions for evaluation. Or try :help. - - scala> - -Alternatively, you can invoke a REPL using the bash script in `./build/quick/bin/`: - - $ ./build/quick/bin/scala - Welcome to Scala 2.12.0-20160613-195040-cd85531 (OpenJDK 64-Bit Server VM, Java 1.8.0_91). - Type in expressions for evaluation. Or try :help. - - scala> + to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use `showRaw` to get the `AST` representation. +* You can publish your newly-built scala version locally using the `publishLocal` task in sbt. +* It's convenient to enable the following local settings to speed up your workflow (put these in `local.sbt` in your working copy): +``` +// skip docs for local publishing +publishArtifact in (Compile, packageDoc) in ThisBuild := false +// set version based on current sha, so that you can easily consume this build from another sbt project +baseVersionSuffix := s"local-${Process("tools/get-scala-commit-sha").lines.head.substring(0, 7)}" +// show more logging during a partest run +testOptions in IntegrationTest in LocalProject("test") ++= Seq(Tests.Argument("--show-log"), Tests.Argument("--show-diff")) +// if incremental compilation is compiling too much (should be fine under sbt 0.13.13) +// antStyle := true +``` * Adding a macro to the `Predef` object is a pretty involved task. Due to bootstrapping, you cannot just throw a macro into it. For this reason, the process is more involved. You might want to follow the way `StringContext.f` itself is added. In short, you need to define your macro under `src/compiler/scala/tools/reflect/` and provide no implementation in `Predef` (`def fn = macro ???`). Now you have to set up the wiring. Add the name of your macro to `src/reflect/scala/reflect/internal/StdNames.scala`, add the needed links to it to `src/reflect/scala/reflect/internal/Definitions.scala`, and finally specify the bindings in `src/compiler/scala/tools/reflect/FastTrack.scala`. [Here's](https://github.com/folone/scala/commit/59536ea833ca16c985339727baed5d70e577b0fe) an example of adding a macro. From 6a5ddf970a857b71779f8e023147ac299f2b0d8d Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 8 Nov 2016 14:11:21 -0800 Subject: [PATCH 0100/3075] fix Github -> GitHub --- contribute/codereviews.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/codereviews.md b/contribute/codereviews.md index 1b9a881b0c..a2df66bd10 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -43,7 +43,7 @@ own pull requests.

The Scala language web site.

-

All Scala Github Projects

+

All Scala GitHub Projects

For other PRs, follow the scala project from here.

From 78590ba20a3272880bd47994e5a31c7cbae24f01 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 15 Nov 2016 15:27:38 -0800 Subject: [PATCH 0101/3075] recommend sbt, not Activator and remove all mention of Activator from the site (well, except from some old release announcements) --- contribute/documentation.md | 8 -------- contribute/index.md | 2 +- 2 files changed, 1 insertion(+), 9 deletions(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index 6b5c81a0fc..b499571154 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -7,7 +7,6 @@ title: Documentation Contributions There are several ways you can help out with the improvement of Scala documentation. These include: * API Documentation in Scaladoc -* Code examples and tutorials in activator templates. * Guides, Overviews, Tutorials, Cheat Sheets and more on the docs.scala-lang.org site * Updating scala-lang.org @@ -28,13 +27,6 @@ Please *follow the issue submission process closely* to help prevent duplicate i [submit new Scaladoc](./scala-standard-library-api-documentation.html) without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on scala-internals so that people know what you are doing. -### Examples/Tutorials in Activator Templates - -[Lightbend Activator](https://www.lightbend.com/community/core-tools/activator-and-sbt) -is a tool based on SBT, with a UI mode that is ideal for code based tutorials, overviews and walk-throughs. To contribute an example in activator, you can fork an existing template, edit it, add a tutorial, upload it to github and then submit the github project into the template repository. It's the fastest way to produce a working code example with tutorial. - -Please see [Contributing an Activator Template](https://www.lightbend.com/activator/template/contribute) for more details. - ### The Main Scala Documentation Site [docs.scala-lang.org](https://wiki.scala-lang.org/) houses the primary source of written, non-API documentation for Scala. It's a github project that you can fork and submit pull requests from. It includes: diff --git a/contribute/index.md b/contribute/index.md index 925e83248e..0a1e2fbaef 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -27,7 +27,7 @@ Coordination of contribution efforts takes place on the

Documentation

-

Scaladoc (API), Activator templates, +

Scaladoc (API), docs.scala-lang.org and scala-lang.org.

From 891183e26da4c3f9ccbea5b5bb888aa40e682469 Mon Sep 17 00:00:00 2001 From: Jarrod Brockman Date: Wed, 16 Nov 2016 14:05:22 +0100 Subject: [PATCH 0102/3075] fix a lot of broken links --- contribute/codereviews.md | 2 +- contribute/documentation.md | 3 +-- contribute/guide.md | 9 ++++----- contribute/hacker-guide.md | 2 +- contribute/index.md | 2 +- contribute/scala-standard-library-api-documentation.md | 2 +- 6 files changed, 9 insertions(+), 11 deletions(-) diff --git a/contribute/codereviews.md b/contribute/codereviews.md index a2df66bd10..d0d9a111c3 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -5,7 +5,7 @@ title: Code Review Contributions ## Code Review Contributions In addition to [bug fixing](./guide.html), you can help us review -[waiting pull requests](#pull_requests_awaiting_comment). +[waiting pull requests](#pull-requests-awaiting-comment). This is also a good (and recommended) way to get to know the feel of the bug-fixing and submissions process before jumping in with your own pull requests. diff --git a/contribute/documentation.md b/contribute/documentation.md index 6b5c81a0fc..27aab024d2 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -21,7 +21,7 @@ Thanks The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: -* [Log issues for missing scaladoc documentation](./scala-standard-library-api-documentation.html#contribute_api_documentation_bug_reports) - +* [Log issues for missing scaladoc documentation](./scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - Please *follow the issue submission process closely* to help prevent duplicate issues being created. * [Claim Scaladoc Issues and Provide Documentation](./scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. * You can also just @@ -61,4 +61,3 @@ to Scala and related projects) is provided on the main Please read both the [docs.scala-lang.org contribution](http://docs.scala-lang.org/contribute.html) document and the [scala-lang.org github README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. - diff --git a/contribute/guide.md b/contribute/guide.md index b92bd2fe89..02b560b7fc 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -17,7 +17,7 @@ title: Contributing guide
-

Community issues

+

Community issues

Get cracking on some easy to approach issues.

@@ -52,9 +52,9 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [github branch](https://github.com/scala/scala) -1. [Select a bug to fix from JIRA](/contribute/index.html#community_tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](./bug-reporting-guide.html) (but please -[make sure it's not a duplicate](./bug-reporting-guide.html#reporting_confirmed_bugs_is_a_sin)). -2. Optional ([but recommended](./scala-internals.html#why_its_a_good_idea)), announce your intention to work on the bug on [scala-internals](./scala-internals.html). After all, don't you want to work on a team with +1. [Select a bug to fix from JIRA](/contribute/index.html#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](./bug-reporting-guide.html) (but please +[make sure it's not a duplicate](./bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). +2. Optional ([but recommended](./scala-internals.html#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](./scala-internals.html). After all, don't you want to work on a team with [these friendly people](./hacker-guide.html#connect) - it's one of the perks of contributing. 3. [Fork the Scala repository](./hacker-guide.html#fork) and clone your fork (if you haven't already). 4. [Create a feature branch](./hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. @@ -77,4 +77,3 @@ on the [scala-internals](http://groups.google.com/group/scala-internals) mailing Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against the Scala project source tree. The [hacker guide](hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. - diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 09532edecd..897c97b1a2 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -28,7 +28,7 @@ Sometimes it's appealing to hack alone and not to have to interact with others o this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. -Typically bug fixes and new features start out as an idea or an experiment posted on one of [our mailing lists]({{ site.baseurl }}/community/index.html#mailing_lists) to find out how people feel +Typically bug fixes and new features start out as an idea or an experiment posted on one of [our mailing lists]({{ site.baseurl }}/community/index.html#mailing-lists) to find out how people feel about things you want to implement. People proficient in certain areas of Scala usually monitor mailing lists, so you'll often get some help by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. diff --git a/contribute/index.md b/contribute/index.md index 925e83248e..2fdf75fc71 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -56,7 +56,7 @@ Coordination of contribution efforts takes place on the

Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects.

-

Compiler/Language

+

Compiler/Language

Larger language features and compiler enhancements including language specification and SIPs.

diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index bc57a163df..37e84bd76e 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -75,7 +75,7 @@ component so that they show up in the correct issue filters. Please familiarize yourself with the following before contributing new API documentation to save time, effort, mistakes and repetition. -* [Forking the Repo](./hacker-guide.html#2_set_up) - follow the setup steps through +* [Forking the Repo](./hacker-guide.html#set-up) - follow the setup steps through the Branch section. If providing new documentation related to an existing JIRA issue, use `issue/NNNN` or `ticket/NNNN` as the guide states. If providing API documentation with no associated JIRA issue, use `scaladoc/xxxx` instead. From ffe3a69da6552a2a9a56da52b92d97665fb46863 Mon Sep 17 00:00:00 2001 From: Jarrod Brockman Date: Thu, 17 Nov 2016 08:52:08 +0100 Subject: [PATCH 0103/3075] fix blank alt tags --- contribute/tools.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/contribute/tools.md b/contribute/tools.md index 494d2e54cf..877297636c 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -24,7 +24,7 @@ Stuff changes. Found a broken link or something that needs updating on this page
- +sbt logo

sbt

Interactive build tool.

Home | @@ -33,7 +33,7 @@ Stuff changes. Found a broken link or something that needs updating on this page Contributing

- +scala logo

Scaladoc Tool

(Contribute through scala/scala)

Home | @@ -45,7 +45,7 @@ Stuff changes. Found a broken link or something that needs updating on this page

-

Scala IDE

 +scala IDE logo

Scala IDE

The Eclipse Scala IDE project.

Home | Issues | @@ -53,7 +53,7 @@ Stuff changes. Found a broken link or something that needs updating on this page Contributing

-

DBuild

 +dbuild logo

DBuild

Multi-project build tool.

Home | Issues | @@ -64,7 +64,7 @@ Stuff changes. Found a broken link or something that needs updating on this page

- +scala logo

Partest

Scala Compiler/Library Testing

Home | @@ -72,7 +72,7 @@ Stuff changes. Found a broken link or something that needs updating on this page ReadMe

-

Ensime

 +ensime logo

Ensime

Scala Support for Text Editors

Home | Issues | @@ -83,7 +83,7 @@ Stuff changes. Found a broken link or something that needs updating on this page

-

Scoverage

 +scoverage logo

Scoverage

Scala code coverage tool

Home | Issues | @@ -91,7 +91,7 @@ Stuff changes. Found a broken link or something that needs updating on this page Contributing

- +scala logo

Abide

Lint tooling for Scala

Home | @@ -109,7 +109,7 @@ The following projects are important to the Scala community but are particularly

- +scala logo

Scalap

Scala Decoder (part of scala/scala)

Issues | @@ -117,7 +117,7 @@ The following projects are important to the Scala community but are particularly Contributing

-

Scalariform

 +white line

Scalariform

Scala code formatter

Home | Issues | From c46edc10b100bb44c25a54356e12b708b6975153 Mon Sep 17 00:00:00 2001 From: "Aaron S. Hawley" Date: Sat, 19 Nov 2016 09:55:19 -0500 Subject: [PATCH 0104/3075] Fix formatting problems in hacker guide --- contribute/hacker-guide.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 897c97b1a2..db4e06e037 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -133,7 +133,7 @@ When hacking on your topic of choice, you'll be modifying Scala, compiling it an Typically you would want to first make sure that your changes work on a small example and afterwards verify that nothing break by running a comprehensive test suite. -We'll start by creating a `sandbox` directory (`./sandbox is listed in the .gitignore of the Scala repository), which will hold a single test file and its compilation results. First, let's make sure that +We'll start by creating a `sandbox` directory (`./sandbox` is listed in the .gitignore of the Scala repository), which will hold a single test file and its compilation results. First, let's make sure that [the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by putting together a simple test and compiling and running it with the Scala compiler that we built using `sbt`. The Scala compiler that we just built is located in `build/pack/bin`. 17:25 ~/Projects/scala (ticket/6725)$ mkdir sandbox @@ -172,6 +172,7 @@ Listening for transport dt_socket at address: 8002 to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use `showRaw` to get the `AST` representation. * You can publish your newly-built scala version locally using the `publishLocal` task in sbt. * It's convenient to enable the following local settings to speed up your workflow (put these in `local.sbt` in your working copy): + ``` // skip docs for local publishing publishArtifact in (Compile, packageDoc) in ThisBuild := false From c27f49c1cd951c31f7d3f2bf9b07f5d362acb967 Mon Sep 17 00:00:00 2001 From: Jarrod Brockman Date: Sun, 20 Nov 2016 09:47:02 +0100 Subject: [PATCH 0105/3075] fix miscellaneous links --- contribute/tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/tools.md b/contribute/tools.md index 877297636c..008a1425a1 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -12,12 +12,12 @@ Typically, issues for these projects will be reported and kept in the github pro Many of these projects have a gitter channel (usually listed in the README or CONTRIBUTING documents) which is a great place to discuss proposed work before commencing. There are some projects in this section that are in -[particular need](#projects_in_particular_need) so please check those out +[particular need](#projects-in-particular-need) so please check those out if you would like to help revive them. ### Broken Links? -Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating_scalalangorg) to fix it. +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating-scala-langorg) to fix it. ### Projects From f2b3a20ec9486c615eed8146248a9c23e450adef Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 7 Dec 2016 12:47:28 -0800 Subject: [PATCH 0106/3075] 2.11 -> 2.12 in some more places --- contribute/hacker-guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index db4e06e037..8d7903fbea 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -8,7 +8,7 @@ This guide is intended to help you get from an idea of fixing a bug or implement This guide covers the entire process, from the conception of your idea or bugfix to the point where it is merged into Scala. Throughout, we will use a running example of an idea or bugfix one might wish to contribute. -Other good starting points for first-time contributors include the [Scala README](https://github.com/scala/scala#get-in-touch) and [contributor's guidelines](https://github.com/scala/scala/blob/2.11.x/CONTRIBUTING.md). +Other good starting points for first-time contributors include the [Scala README](https://github.com/scala/scala#get-in-touch) and [contributor's guidelines](https://github.com/scala/scala/blob/2.12.x/CONTRIBUTING.md). ## The Running Example @@ -336,7 +336,7 @@ Let's go into each of these points in more detail. The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. There are two things you should know here: -1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policies](https://github.com/scala/scala/blob/2.11.x/CONTRIBUTING.md) for more information about the desired style of your commits. +1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policies](https://github.com/scala/scala/blob/2.12.x/CONTRIBUTING.md) for more information about the desired style of your commits. 2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on GitHub. From 1a258055bd0966a517c50f8113516e53f2393ad9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20de=20Sil=C3=B3niz=20Sandino?= Date: Wed, 8 Feb 2017 13:11:11 +0100 Subject: [PATCH 0107/3075] First migration of content pages to new content layout - First migration to using pretty permalinks --- contribute/bug-reporting-guide.md | 4 ++- contribute/codereviews.md | 10 ++++--- contribute/corelibs.md | 10 ++++--- contribute/documentation.md | 10 ++++--- contribute/guide.md | 30 ++++++++++--------- contribute/hacker-guide.md | 4 ++- contribute/index.md | 22 +++++++------- contribute/partest-guide.md | 4 ++- contribute/scala-internals.md | 4 ++- ...cala-standard-library-api-documentation.md | 4 ++- contribute/tools.md | 12 ++++---- 11 files changed, 68 insertions(+), 46 deletions(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 960f40b704..f4c8282a78 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -1,6 +1,8 @@ --- -layout: page title: Bug Reporting +layout: inner-page-no-masthead +permalink: /contribute/bug-reporting-guide/ +includeTOC: true --- The Scala project tracker is located at [http://issues.scala-lang.org](http://issues.scala-lang.org). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. diff --git a/contribute/codereviews.md b/contribute/codereviews.md index d0d9a111c3..9239fa8c14 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -1,10 +1,12 @@ --- -layout: page title: Code Review Contributions +layout: inner-page-no-masthead +permalink: /contribute/codereviews/ +includeTOC: true --- ## Code Review Contributions -In addition to [bug fixing](./guide.html), you can help us review +In addition to [bug fixing](/contribute/guide/), you can help us review [waiting pull requests](#pull-requests-awaiting-comment). This is also a good (and recommended) way to get to know the feel of the bug-fixing and submissions process before jumping in with your @@ -13,7 +15,7 @@ own pull requests. ### Review Guidelines -[Code of Conduct reminder](../conduct.html) +[Code of Conduct reminder](/conduct/) * Keep comments on-topic, concise and precise. * Attach comments to particular lines or regions they pertain to whenever possible. @@ -49,4 +51,4 @@ own pull requests.

-Also note that the [Tools contributions](./tools.html) page has more projects that will generate pull requests. +Also note that the [Tools contributions](/contribute/tools/) page has more projects that will generate pull requests. diff --git a/contribute/corelibs.md b/contribute/corelibs.md index 6e1abbb0d7..1f34d150b0 100644 --- a/contribute/corelibs.md +++ b/contribute/corelibs.md @@ -1,14 +1,16 @@ --- -layout: page title: Core Library Contributions +layout: inner-page-no-masthead +permalink: /contribute/corelibs/ +includeTOC: true --- ## Core Library Contributions There are several options for contributing to Scala's core libraries. You can: -* Help with [Documentation](./scala-standard-library-api-documentation.html). -* [Report Bugs or Issues](./bug-reporting-guide.html) against the core libraries. -* [Fix Bugs or Issues](./guide.html) against the +* Help with [Documentation](/contribute/scala-standard-library-api-documentation/). +* [Report Bugs or Issues](/contribute/bug-reporting-guide/) against the core libraries. +* [Fix Bugs or Issues](/contribute/guide/) against the [reported library bugs/issues](https://issues.scala-lang.org/issues/?filter=13001). * Contribute significant new functionality or a new API by submitting a Scala Library Improvement Process (SLIP) Document. diff --git a/contribute/documentation.md b/contribute/documentation.md index 7657cbf699..2746fa77dc 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -1,6 +1,8 @@ --- -layout: page title: Documentation Contributions +layout: inner-page-no-masthead +permalink: /contribute/documentation/ +includeTOC: true --- ## Contributing Documentation to the Scala project @@ -20,11 +22,11 @@ Thanks The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: -* [Log issues for missing scaladoc documentation](./scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - +* [Log issues for missing scaladoc documentation](/contribute/scala-standard-library-api-documentation/#contribute-api-documentation-bug-reports) - Please *follow the issue submission process closely* to help prevent duplicate issues being created. -* [Claim Scaladoc Issues and Provide Documentation](./scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. +* [Claim Scaladoc Issues and Provide Documentation](/contribute/scala-standard-library-api-documentation/) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. * You can also just -[submit new Scaladoc](./scala-standard-library-api-documentation.html) +[submit new Scaladoc](/contribute/scala-standard-library-api-documentation/) without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on scala-internals so that people know what you are doing. ### The Main Scala Documentation Site diff --git a/contribute/guide.md b/contribute/guide.md index 02b560b7fc..afd3572c53 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -1,6 +1,8 @@ --- -layout: page title: Contributing guide +layout: inner-page-no-masthead +permalink: /contribute/guide/ +includeTOC: true ---
@@ -10,7 +12,7 @@ title: Contributing guide

Get a peek into the inners of the Scala compiler.

-

Report an issue

+

Report an issue

File a bug report or a feature request.

@@ -21,7 +23,7 @@ title: Contributing guide

Get cracking on some easy to approach issues.

-

Hacker's guide

+

Hacker's guide

Learn to write good code and improve your chances of contributing to the Scala galaxy.

@@ -52,19 +54,19 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [github branch](https://github.com/scala/scala) -1. [Select a bug to fix from JIRA](/contribute/index.html#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](./bug-reporting-guide.html) (but please -[make sure it's not a duplicate](./bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). -2. Optional ([but recommended](./scala-internals.html#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](./scala-internals.html). After all, don't you want to work on a team with -[these friendly people](./hacker-guide.html#connect) - it's one of the perks of contributing. -3. [Fork the Scala repository](./hacker-guide.html#fork) and clone your fork (if you haven't already). -4. [Create a feature branch](./hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. -5. [Fix the bug, or implement the new small feature](./hacker-guide.html#implement), include new tests (yes, for bug fixes too). -6. [Test, rinse](./hacker-guide.html#test) and [test some more](./partest-guide.html) until [all the tests pass](./hacker-guide.html#verify). -7. [Commit your changes](./hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. +1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](/contribute/bug-reporting-guide/) (but please +[make sure it's not a duplicate](/contribute/bug-reporting-guide/#reporting-confirmed-bugs-is-a-sin)). +2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](/contribute/scala-internals/). After all, don't you want to work on a team with +[these friendly people](/contribute/hacker-guide/#connect) - it's one of the perks of contributing. +3. [Fork the Scala repository](/contribute/hacker-guide/#fork) and clone your fork (if you haven't already). +4. [Create a feature branch](/contribute/hacker-guide/#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. +5. [Fix the bug, or implement the new small feature](/contribute/hacker-guide/#implement), include new tests (yes, for bug fixes too). +6. [Test, rinse](/contribute/hacker-guide/#test) and [test some more](/contribute/partest-guide/) until [all the tests pass](/contribute/hacker-guide/#verify). +7. [Commit your changes](/contribute/hacker-guide#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. 8. If necessary [re-write git history](http://git-scm.com/book/en/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) 9. [Submit a pull request](./hacker-guide.html#submit) following the [Scala project pull-request guidelines](http://docs.scala-lang.org/scala/pull-request-policy.html). -10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](./hacker-guide.html#review). +10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/contribute/hacker-guide/#review). 11. Celebrate! Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide](./hacker-guide.html) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). @@ -76,4 +78,4 @@ and on the implementation plan. Announce the change on the [scala-internals](http://groups.google.com/group/scala-internals) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list and if a SIP is required, that will be discussed on the mailing list. Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against -the Scala project source tree. The [hacker guide](hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. +the Scala project source tree. The [hacker guide](/contribute/hacker-guide/) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 8d7903fbea..ebdad9652b 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -1,7 +1,9 @@ --- -layout: page title: Scala hacker guide by: Eugene Burmako +layout: inner-page-no-masthead +permalink: /contribute/hacker-guide/ +includeTOC: true ---
This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea. diff --git a/contribute/index.md b/contribute/index.md index 1a2f7c7c5b..dcc78e8149 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -1,6 +1,8 @@ --- -layout: page title: Contribute +layout: inner-page-no-masthead +permalink: /contribute/ +includeTOC: true --- The Scala programming language is an open source project with a very @@ -26,37 +28,37 @@ Coordination of contribution efforts takes place on the
-

Documentation

-

Scaladoc (API), +

Documentation

+

Scaladoc (API), docs.scala-lang.org and scala-lang.org.

-

Bug Fixes

-

Issues with the tools, core libraries and compiler. Also you can help us by reporting bugs

+

Bug Fixes

+

Issues with the tools, core libraries and compiler. Also you can help us by reporting bugs

-

Code Reviews

+

Code Reviews

Review pull requests against scala/scala, scala/scala-lang, scala/scala.github.com and others.

-

Core Libraries

+

Core Libraries

Update and expand the capabilities of the core (and associated) Scala libraries.

-

IDE and Build Tools

+

IDE and Build Tools

Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects.

-

Compiler/Language

+

Compiler/Language

Larger language features and compiler enhancements including language specification and SIPs.

@@ -109,7 +111,7 @@ with their own maintainers and community of contributors. Helping out one of these projects is another way to help Scala. Consider lending on a hand on a project you're already using. Or, to find out about other projects, see the -[Libraries and Tools section](../community/index.html#community-libraries-and-tools) +[Libraries and Tools section](../community/#community-libraries-and-tools) on our Community page. ### Scala Community Build diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md index e681c569fe..be37d6fc12 100644 --- a/contribute/partest-guide.md +++ b/contribute/partest-guide.md @@ -1,6 +1,8 @@ --- -layout: page title: Running the Test Suite +layout: inner-page-no-masthead +permalink: /contribute/partest-guide/ +includeTOC: true --- Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go the scala project folder from your local checkout and run it via `ant` or standalone as follows. diff --git a/contribute/scala-internals.md b/contribute/scala-internals.md index 5bd97ed8a8..831f2cc864 100644 --- a/contribute/scala-internals.md +++ b/contribute/scala-internals.md @@ -1,6 +1,8 @@ --- -layout: page title: Scala Internals Mailing List +layout: inner-page-no-masthead +permalink: /contribute/scala-internals/ +includeTOC: true --- ## scala-internals diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index 37e84bd76e..68df995375 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -1,6 +1,8 @@ --- -layout: page title: Contribute to API Documentation +layout: inner-page-no-masthead +permalink: /contribute/scala-standard-library-api-documentation/ +includeTOC: true --- This page is specific to API documentation contributions – that is, API diff --git a/contribute/tools.md b/contribute/tools.md index 008a1425a1..876ce88c1c 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -1,12 +1,14 @@ --- -layout: page title: IDE and Build Tool Contributions +layout: inner-page-no-masthead +permalink: /contribute/tools/ +includeTOC: true --- ## Contributing to IDE and Build Tools The links below are to a number of Scala build and IDE related projects that are important in the larger Scala space, and which welcome contributions. -Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](./hacker-guide.html) and [Bug-fixing](guide.html) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. +Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](/contribute/hacker-guide/) and [Bug-fixing](/contribute/guide/) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. Typically, issues for these projects will be reported and kept in the github project issue tracker for that project rather than in the Scala project JIRA. Many of these projects have a gitter channel (usually listed in the README or CONTRIBUTING documents) which is a great place to discuss proposed work before commencing. @@ -17,7 +19,7 @@ if you would like to help revive them. ### Broken Links? -Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](./documentation.html#updating-scala-langorg) to fix it. +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/contribute/documentation/#updating-scala-langorg) to fix it. ### Projects @@ -39,7 +41,7 @@ Stuff changes. Found a broken link or something that needs updating on this page

Home | Issues | ReadMe | -Contributing

+Contributing

@@ -114,7 +116,7 @@ The following projects are important to the Scala community but are particularly

Scala Decoder (part of scala/scala)

Issues | ReadMe | -Contributing

+Contributing

white line

Scalariform

 From b58955fa85531e7be82639d5d6acf44b779f0f17 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20de=20Sil=C3=B3niz=20Sandino?= Date: Wed, 8 Feb 2017 17:25:34 +0100 Subject: [PATCH 0108/3075] Short items list for the contribute subpages --- _contribute_resources/1-documentation.md | 6 + _contribute_resources/2-bug-fixes.md | 6 + _contribute_resources/3-code-reviews.md | 8 + _contribute_resources/4-core-libraries.md | 6 + .../5-ide-and-build-tools.md | 6 + _contribute_resources/6-compiler-language.md | 6 + contribute/index.md | 74 +------ contribute/tools.md | 187 ++++++++---------- 8 files changed, 126 insertions(+), 173 deletions(-) create mode 100644 _contribute_resources/1-documentation.md create mode 100644 _contribute_resources/2-bug-fixes.md create mode 100644 _contribute_resources/3-code-reviews.md create mode 100644 _contribute_resources/4-core-libraries.md create mode 100644 _contribute_resources/5-ide-and-build-tools.md create mode 100644 _contribute_resources/6-compiler-language.md diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md new file mode 100644 index 0000000000..27739dee6a --- /dev/null +++ b/_contribute_resources/1-documentation.md @@ -0,0 +1,6 @@ +--- +title: Documentation +link: /contribute/documentation/ +icon: fa fa-file-text +--- +[Scaladoc (API)](/contribute/scala-standard-library-api-documentation/),[docs.scala-lang.org](http://docs.scala-lang.org/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). \ No newline at end of file diff --git a/_contribute_resources/2-bug-fixes.md b/_contribute_resources/2-bug-fixes.md new file mode 100644 index 0000000000..d10adb7908 --- /dev/null +++ b/_contribute_resources/2-bug-fixes.md @@ -0,0 +1,6 @@ +--- +title: Bug fixes +link: /contribute/guide/ +icon: fa fa-pencil +--- +Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/contribute/bug-reporting-guide/). \ No newline at end of file diff --git a/_contribute_resources/3-code-reviews.md b/_contribute_resources/3-code-reviews.md new file mode 100644 index 0000000000..2ab235993b --- /dev/null +++ b/_contribute_resources/3-code-reviews.md @@ -0,0 +1,8 @@ +--- +title: Code Reviews +link: /contribute/codereviews/ +icon: fa fa-eye +--- +Review pull requests against [scala/scala](https://github.com/scala/scala/pulls), +[scala/scala-lang](https://github.com/scala/scala-lang/pulls), +[scala/scala.github.com](https://github.com/scala/scala.github.com/pulls)and others. \ No newline at end of file diff --git a/_contribute_resources/4-core-libraries.md b/_contribute_resources/4-core-libraries.md new file mode 100644 index 0000000000..7ad75c5752 --- /dev/null +++ b/_contribute_resources/4-core-libraries.md @@ -0,0 +1,6 @@ +--- +title: Core Libraries +link: /contribute/corelibs/ +icon: fa fa-clipboard +--- +Update and expand the capabilities of the core (and associated) Scala libraries. \ No newline at end of file diff --git a/_contribute_resources/5-ide-and-build-tools.md b/_contribute_resources/5-ide-and-build-tools.md new file mode 100644 index 0000000000..4b8bd2ed52 --- /dev/null +++ b/_contribute_resources/5-ide-and-build-tools.md @@ -0,0 +1,6 @@ +--- +title: IDE and Build Tools +link: /contribute/tools/ +icon: fa fa-terminal +--- +Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects. \ No newline at end of file diff --git a/_contribute_resources/6-compiler-language.md b/_contribute_resources/6-compiler-language.md new file mode 100644 index 0000000000..0c4eaa1325 --- /dev/null +++ b/_contribute_resources/6-compiler-language.md @@ -0,0 +1,6 @@ +--- +title: Compiler/Language +link: /contribute/guide/#larger-changes-new-features +icon: fa fa-gears +--- +Larger language features and compiler enhancements including language specification and SIPs. \ No newline at end of file diff --git a/contribute/index.md b/contribute/index.md index dcc78e8149..e843ef2f02 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -25,84 +25,14 @@ how to efficiently report a bug. Coordination of contribution efforts takes place on the [scala-internals Google group](./scala-internals.html). -
-
-
-

Documentation

-

Scaladoc (API), -docs.scala-lang.org and -scala-lang.org.

-
-
-

Bug Fixes

-

Issues with the tools, core libraries and compiler. Also you can help us by reporting bugs

-
-
- -
-
-

Code Reviews

-

Review pull requests against scala/scala, -scala/scala-lang, -scala/scala.github.com and others.

-
-
-

Core Libraries

-

Update and expand the capabilities of the core (and associated) Scala libraries.

-
-
- -
-
-

IDE and Build Tools

-

Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects.

-
-
-

Compiler/Language

-

Larger language features and compiler enhancements including language specification and SIPs.

-
-
-
+{% include column-list-of-items.html collection=site.contribute_resources %} ### Community Tickets The following links provide starting points for various contributor activities: -
-
-
-

Documentation

-

Help augment or correct the documentation.

-
-
-

Core Libraries

-

Community bugs and enhancements on the core libs.

-
-
- -
-
-

Tools

-

Help with the Scala tool chain.

-
-
-

Compiler

-

Ready for a challenge? Here's the compiler bugs.

-
-
- -
-
-

Bugs

-

All bugs marked with the label community.

-
-
-

All Issues

-

Bugs + Enhancements marked with the label community.

-
-
-
+{% include column-list-of-items.html collection=site.contribute_community_tickets %} ### Tools and Libraries diff --git a/contribute/tools.md b/contribute/tools.md index 876ce88c1c..420579913e 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -3,6 +3,90 @@ title: IDE and Build Tool Contributions layout: inner-page-no-masthead permalink: /contribute/tools/ includeTOC: true + +# Projects list: +projects: + - title: sbt + description: Interactive build tool. + icon: http://www.scala-sbt.org/assets/typesafe_sbt_svg.svg + link: https://github.com/sbt/sbt + homeLink: http://www.scala-sbt.org/ + issuesLink: https://github.com/sbt/sbt#issues-and-pull-requests + readmeLink: https://github.com/sbt/sbt/blob/0.13/README.md + contributingLink: https://github.com/sbt/sbt/blob/0.13/CONTRIBUTING.md + - title: Scaladoc Tool + description: (Contribute through scala/scala) + icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 + link: https://github.com/scala/scala + homeLink: http://www.scala-lang.org/api + issuesLink: https://issues.scala-lang.org/issues/?jql=status%20%3D%20Open%20AND%20component%20%3D%20%22Scaladoc%20Tool%22 + readmeLink: https://github.com/scala/scala#welcome + contributingLink: http://scala-lang.org/contribute/guide.html + - title: Scala IDE + description: Interactive build tool. + icon: https://avatars2.githubusercontent.com/u/1026788?v=3&s=200 + link: https://github.com/scala-ide/scala-ide + homeLink: http://scala-ide.org/ + issuesLink: http://scala-ide-portfolio.assembla.com/spaces/scala-ide/support/tickets + readmeLink: https://github.com/scala-ide/scala-ide/blob/master/README.md + contributingLink: https://github.com/scala-ide/scala-ide/blob/master/CONTRIBUTING.md + - title: DBuild + description: Multi-project build tool. + icon: https://avatars3.githubusercontent.com/u/784923?v=3&s=200 + link: https://github.com/typesafehub/dbuild + homeLink: http://typesafehub.github.io/dbuild + issuesLink: https://github.com/typesafehub/dbuild/issues + readmeLink: https://github.com/typesafehub/dbuild/blob/master/README.md + contributingLink: https://github.com/typesafehub/dbuild/blob/master/README.md#get-involved + - title: Partest + description: Scala Compiler/Library Testing + icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 + link: https://github.com/scala/scala-partest + homeLink: http://docs.scala-lang.org/tutorials/partest-guide.html + issuesLink: https://github.com/scala/scala-partest/issues + readmeLink: https://github.com/scala/scala-partest/blob/master/README.md + contributingLink: + - title: Ensime + description: Scala Support for Text Editors + icon: https://avatars0.githubusercontent.com/u/5089042?v=3&s=200 + link: https://github.com/ensime/ensime-server + homeLink: http://ensime.github.io/ + issuesLink: https://github.com/ensime/ensime-server/issues + readmeLink: https://github.com/ensime/ensime-server/blob/2.0/README.md + contributingLink: https://ensime.github.io/contributing/ + - title: Scoverage + description: Scala code coverage tool + icon: https://avatars1.githubusercontent.com/u/5998302?v=3&s=200 + link: https://github.com/scoverage/scalac-scoverage-plugin + homeLink: http://scoverage.org/ + issuesLink: https://github.com/scoverage/scalac-scoverage-plugin/issues + readmeLink: https://github.com/scoverage/scalac-scoverage-plugin/blob/master/README.md + contributingLink: https://groups.google.com/forum/#!forum/scala-code-coverage-tool + - title: Abide + description: Lint tooling for Scala + icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 + link: https://github.com/scala/scala-abide + homeLink: https://github.com/scala/scala-abide#abide--lint-tooling-for-scala + issuesLink: https://github.com/scala/scala-abide/issues + readmeLink: https://github.com/scala/scala-abide/blob/master/README.md + contributingLink: https://github.com/scala/scala-abide#extending-abide + +projectsInNeed: + - title: Scalap + description: Scala Decoder (part of scala/scala) + icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 + link: https://github.com/scala/scala + homeLink: + issuesLink: https://issues.scala-lang.org/issues/?jql=status%20%3D%20Open%20AND%20text%20~%20%22scalap%22 + readmeLink: https://github.com/scala/scala#welcome + contributingLink: https://github.com/sbt/sbt/blob/0.13/CONTRIBUTING.md + - title: Scaladoc Tool + description: (Contribute through scala/scala) + icon: /resources/img/white-line.png + link: https://github.com/mdr/scalariform + homeLink: https://github.com/mdr/scalariform/wiki/Command-line-tool + issuesLink: https://github.com/mdr/scalariform/issues + readmeLink: https://github.com/mdr/scalariform/blob/master/README.rst --- ## Contributing to IDE and Build Tools @@ -23,109 +107,10 @@ Stuff changes. Found a broken link or something that needs updating on this page ### Projects -
-
-
-sbt logo -

sbt

 -

Interactive build tool.

-

Home | -Issues | -ReadMe | -Contributing

-
-
-scala logo -

Scaladoc Tool

 -

(Contribute through scala/scala)

-

Home | -Issues | -ReadMe | -Contributing

-
-
- -
-
-scala IDE logo

Scala IDE

 -

The Eclipse Scala IDE project.

-

Home | -Issues | -ReadMe | -Contributing

-
-
-dbuild logo

DBuild

 -

Multi-project build tool.

-

Home | -Issues | -ReadMe | -Contributing

-
-
- -
-
-scala logo -

Partest

 -

Scala Compiler/Library Testing

-

Home | -Issues | -ReadMe

-
-
-ensime logo

Ensime

 -

Scala Support for Text Editors

-

Home | -Issues | -ReadMe | -Contributing

-
-
- -
-
-scoverage logo

Scoverage

 -

Scala code coverage tool

-

Home | -Issues | -ReadMe | -Contributing

-
-
-scala logo -

Abide

 -

Lint tooling for Scala

-

Home | -Issues | -ReadMe | -Contributing

-
-
-
+{% include contributions-projects-list.html collection=page.projects %} ### Projects in Particular Need The following projects are important to the Scala community but are particularly in need of contributors to continue their development. -
-
-
-scala logo -

Scalap

 -

Scala Decoder (part of scala/scala)

-

Issues | -ReadMe | -Contributing

-
-
-white line

Scalariform

 -

Scala code formatter

-

Home | -Issues | -ReadMe

-
-
-
- - +{% include contributions-projects-list.html collection=page.projectsInNeed %} \ No newline at end of file From 0aa2f7f9660ea580cc661899ece1f99106f99c4f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20de=20Sil=C3=B3niz=20Sandino?= Date: Thu, 9 Feb 2017 12:10:38 +0100 Subject: [PATCH 0109/3075] Adding code of conduct --- contribute/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/contribute/index.md b/contribute/index.md index e843ef2f02..f0c52986b8 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -17,13 +17,13 @@ That depends on what you want to contribute. Below are some getting started reso ### Reporting bugs -See our [bug reporting guide](./bug-reporting-guide.html) to learn +See our [bug reporting guide](/contribute/bug-reporting-guide/) to learn how to efficiently report a bug. ### Contribute Coordination of contribution efforts takes place on the -[scala-internals Google group](./scala-internals.html). +[scala-internals Google group](/contribute/scala-internals/). {% include column-list-of-items.html collection=site.contribute_resources %} @@ -41,7 +41,7 @@ with their own maintainers and community of contributors. Helping out one of these projects is another way to help Scala. Consider lending on a hand on a project you're already using. Or, to find out about other projects, see the -[Libraries and Tools section](../community/#community-libraries-and-tools) +[Libraries and Tools section](/community/#community-libraries-and-tools) on our Community page. ### Scala Community Build From 32684bae5d915d7bcf7ce69c860c2930c5f89d6b Mon Sep 17 00:00:00 2001 From: Janek Bogucki Date: Tue, 20 Jun 2017 10:19:33 +0100 Subject: [PATCH 0110/3075] Update bug reporting links --- contribute/bug-reporting-guide.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 960f40b704..13a7553c88 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -3,7 +3,7 @@ layout: page title: Bug Reporting --- -The Scala project tracker is located at [http://issues.scala-lang.org](http://issues.scala-lang.org). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. +The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. ## Is it a Bug? @@ -43,12 +43,12 @@ If you have a code snippet that is resulting in bytecode which you believe is be 5. If you want to file an improvement in the issue tracker please discuss it first on one of the mailing lists. They offer much bigger audience than issue tracker. The latter is not suitable for long discussions. -* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/files/archive/spec/2.11/). If in doubt, you may always ask on the [scala-internals mailing list](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) or [stackoveflow](http://stackoverflow.com/questions/tagged/scala). +* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/files/archive/spec/2.12/). If in doubt, you may always ask on the [Community Category](https://contributors.scala-lang.org/c/community) or [Stack Overflow](https://stackoverflow.com/questions/tagged/scala). -In general, if you find yourself stuck on any of these steps, asking on one of the following Scala mailing lists can be helpful: +In general, if you find yourself stuck on any of these steps, asking on [Scala Contributors](https://contributors.scala-lang.org/) can be helpful: - - For unexpected behavior use [scala-language](https://groups.google.com/forum/?fromgroups#!forum/scala-language), or [scala-user](https://groups.google.com/forum/?fromgroups#!forum/scala-user) mailing lists. - - For compiler bugs use the [scala-internals](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) mailing list. + - For unexpected behavior use the [Community Category](https://contributors.scala-lang.org/c/community). + - For compiler bugs use the [Compiler Category](https://contributors.scala-lang.org/c/compiler). * Examples of exceptions reported by the compiler which usually are not bugs: 1. `StackOverflowError` is typically not a bug unless the stacktrace involves the internal packages of the compiler (like `scala.tools.nsc...`). Try to increase the Java stack size (`-Xss`), in most of the cases it helps. @@ -84,4 +84,4 @@ In the description of your issue, be as detailed as you can. Bug reports which h 2. The expected output. 3. The actual output, including the stacktrace. 4. Related discussion on the mailing lists, if applicable. - 4. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. + 5. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. From 7390eec1410fbd55523e919450ef8dda1ffa6c87 Mon Sep 17 00:00:00 2001 From: Janek Bogucki Date: Thu, 22 Jun 2017 10:21:22 +0100 Subject: [PATCH 0111/3075] Add scalacheck tips and note removal of partest --- contribute/hacker-guide.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 8d7903fbea..a8e9d2e14c 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -264,11 +264,13 @@ Adding tests to the test suite is as easy as moving them to the appropriate dire * Code which should not compile needs to go into the [“neg” directory](https://github.com/scala/scala/tree/2.12.x/test/files/neg). * Code which should compile and get executed by the test suite needs to go into the [“run” directory](https://github.com/scala/scala/tree/2.12.x/test/files/run) and have a corresponding `.check` file with the expected output. You will get test failures if the content of a `.check` file is different from what the test produces while running. If the change in the output is an expected product of your work, you might not want to change the `.check` file by hand. To make partest change the `.check` file, run it with a `--update-check` flag, like so `./test/partest --update-check path/to/test.scala`. For more information on partest, please refer to its [documentation](http://docs.scala-lang.org/tutorials/partest-guide.html). * Everything that can be unit-tested should go to ["junit" directory](https://github.com/scala/scala/tree/2.12.x/test/junit) -* Property-based tests go to the ["scalacheck" directory](https://github.com/scala/scala/tree/2.12.x/test/files/scalacheck) +* Property-based tests go to the ["scalacheck" directory](https://github.com/scala/scala/tree/2.12.x/test/scalacheck) Here are some more testing tips: -* If you have several tests, and want a tool for only running tests that conform to some regular expression, you can use `partest-ack` in the `tools` directory: `./tools/partest-ack "dottype"` +* If you have several tests, and want a tool for only running tests that conform to some regular expression, you can use `partest-ack` in the `tools` directory: `./tools/partest-ack "dottype"`. `partest-ack` was removed in 2.12. +* If you want to run all scalacheck tests from sbt use `scalacheck/testOnly` +* To run scalacheck tests by name when in sbt use `scalacheck/testOnly ... `, for example `scalacheck/testOnly scala.tools.nsc.scaladoc.HtmlFactoryTest` * If your tests fail in the following way: test.bc: @@ -320,6 +322,8 @@ Run `sbt test` and `sbt partest` to run all of the JUnit and partest tests, resp testing: [...]/files/run/stringinterpolation_macro-run.scala [ OK ] All of 6 tests were successful (elapsed time: 00:00:08) +`partest` was removed in 2.12. + ## 4. Publish After development is finished, it's time to publish the code and submit your patch for discussion and potential inclusion into Scala. From c8305a9b4e7279273842e2701bfdb649a872ab88 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Thu, 13 Jul 2017 17:23:15 +0200 Subject: [PATCH 0112/3075] Get rid of some of the permalinks that are breaking everything --- contribute/bug-reporting-guide.md | 2 +- contribute/codereviews.md | 8 ++--- contribute/corelibs.md | 6 ++-- contribute/documentation.md | 20 ++++++------- contribute/guide.md | 6 ++-- contribute/hacker-guide.md | 4 +-- contribute/index.md | 4 +-- contribute/partest-guide.md | 30 +++++++++---------- contribute/scala-internals.md | 5 ++-- ...cala-standard-library-api-documentation.md | 2 +- contribute/tools.md | 10 +++---- 11 files changed, 48 insertions(+), 49 deletions(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 33b61807c2..05569ff8e4 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -1,7 +1,7 @@ --- title: Bug Reporting layout: inner-page-no-masthead -permalink: /contribute/bug-reporting-guide/ +# permalink: /contribute/bug-reporting-guide/ includeTOC: true --- diff --git a/contribute/codereviews.md b/contribute/codereviews.md index 9239fa8c14..2c56b4ed37 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -1,18 +1,18 @@ --- title: Code Review Contributions layout: inner-page-no-masthead -permalink: /contribute/codereviews/ +# permalink: /contribute/codereviews/ includeTOC: true --- ## Code Review Contributions -In addition to [bug fixing](/contribute/guide/), you can help us review -[waiting pull requests](#pull-requests-awaiting-comment). +In addition to [bug fixing](/contribute/guide/), you can help us review +[waiting pull requests](#pull-requests-awaiting-comment). This is also a good (and recommended) way to get to know the feel of the bug-fixing and submissions process before jumping in with your own pull requests. - + ### Review Guidelines [Code of Conduct reminder](/conduct/) diff --git a/contribute/corelibs.md b/contribute/corelibs.md index 1f34d150b0..fd69ae196e 100644 --- a/contribute/corelibs.md +++ b/contribute/corelibs.md @@ -1,7 +1,7 @@ --- title: Core Library Contributions layout: inner-page-no-masthead -permalink: /contribute/corelibs/ +# permalink: /contribute/corelibs/ includeTOC: true --- ## Core Library Contributions @@ -10,14 +10,14 @@ There are several options for contributing to Scala's core libraries. You can: * Help with [Documentation](/contribute/scala-standard-library-api-documentation/). * [Report Bugs or Issues](/contribute/bug-reporting-guide/) against the core libraries. -* [Fix Bugs or Issues](/contribute/guide/) against the +* [Fix Bugs or Issues](/contribute/guide/) against the [reported library bugs/issues](https://issues.scala-lang.org/issues/?filter=13001). * Contribute significant new functionality or a new API by submitting a Scala Library Improvement Process (SLIP) Document. ### Submitting a SLIP -For significant new functionality or a whole new API to be considered for +For significant new functionality or a whole new API to be considered for inclusion in the core Scala distribution, you will be asked to submit a SLIP (Scala Library Improvement Process) document. Please see [instructions for submitting a new SLIP](http://docs.scala-lang.org/sips/slip-submission.html) and familiarize yourself with the [SIP/SLIP](http://docs.scala-lang.org/sips/) section of the Scala documentation site. Also please pay particular attention to the [pre-requisites](http://docs.scala-lang.org/sips/slip-submission.html) before submitting a SLIP. diff --git a/contribute/documentation.md b/contribute/documentation.md index 2746fa77dc..8930a3c32c 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -1,7 +1,7 @@ --- title: Documentation Contributions layout: inner-page-no-masthead -permalink: /contribute/documentation/ +# permalink: /contribute/documentation/ includeTOC: true --- ## Contributing Documentation to the Scala project @@ -14,7 +14,7 @@ There are several ways you can help out with the improvement of Scala documentat Please read this page, and the pages linked from this one, fully before contributing documentation. Many of the questions you have will be answered in these resources. If you have a question that isn't answered, feel free to ask on the [scala-internals Google group](https://groups.google.com/forum/#!forum/scala-internals) and then, please, submit a pull request with updated documentation reflecting that answer. -**General requirements** for documentation submissions include spell-checking all written language, ensuring code samples compile and run correctly, correct grammar, and clean formatting/layout of the documentation. +**General requirements** for documentation submissions include spell-checking all written language, ensuring code samples compile and run correctly, correct grammar, and clean formatting/layout of the documentation. Thanks @@ -22,12 +22,12 @@ Thanks The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: -* [Log issues for missing scaladoc documentation](/contribute/scala-standard-library-api-documentation/#contribute-api-documentation-bug-reports) - +* [Log issues for missing scaladoc documentation](/contribute/scala-standard-library-api-documentation/#contribute-api-documentation-bug-reports) - Please *follow the issue submission process closely* to help prevent duplicate issues being created. * [Claim Scaladoc Issues and Provide Documentation](/contribute/scala-standard-library-api-documentation/) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. -* You can also just -[submit new Scaladoc](/contribute/scala-standard-library-api-documentation/) -without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on scala-internals so that people know what you are doing. +* You can also just +[submit new Scaladoc](/contribute/scala-standard-library-api-documentation/) +without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on scala-internals so that people know what you are doing. ### The Main Scala Documentation Site @@ -43,15 +43,15 @@ without creating an issue, but please look to see if there is an issue already s * SIP (Scala Improvement Process) Proposals and more -Please read [contributing to the docs.scala-lang.org site](http://docs.scala-lang.org/contribute.html) through before embarking on changes. The site uses +Please read [contributing to the docs.scala-lang.org site](http://docs.scala-lang.org/contribute.html) through before embarking on changes. The site uses the [Jekyll](http://jekyllrb.com/) markdown engine so you will need to follow the instructions to get that running as well. ### Updating scala-lang.org Additional high-level documentation (including documentation on contributing -to Scala and related projects) is provided on the main -[Scala Language site](http://scala-lang.org), and is also kept in the -[scala-lang github project](https://github.com/scala/scala-lang) which may be forked to create pull requests. +to Scala and related projects) is provided on the main +[Scala Language site](http://scala-lang.org), and is also kept in the +[scala-lang github project](https://github.com/scala/scala-lang) which may be forked to create pull requests. Please read both the [docs.scala-lang.org contribution](http://docs.scala-lang.org/contribute.html) document and the [scala-lang.org github README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. diff --git a/contribute/guide.md b/contribute/guide.md index afd3572c53..9edb289e06 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -1,7 +1,7 @@ --- title: Contributing guide layout: inner-page-no-masthead -permalink: /contribute/guide/ +# permalink: /contribute/guide/ includeTOC: true --- @@ -54,9 +54,9 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [github branch](https://github.com/scala/scala) -1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](/contribute/bug-reporting-guide/) (but please +1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](/contribute/bug-reporting-guide/) (but please [make sure it's not a duplicate](/contribute/bug-reporting-guide/#reporting-confirmed-bugs-is-a-sin)). -2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](/contribute/scala-internals/). After all, don't you want to work on a team with +2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](/contribute/scala-internals/). After all, don't you want to work on a team with [these friendly people](/contribute/hacker-guide/#connect) - it's one of the perks of contributing. 3. [Fork the Scala repository](/contribute/hacker-guide/#fork) and clone your fork (if you haven't already). 4. [Create a feature branch](/contribute/hacker-guide/#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index abfe59b2da..31602a0909 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -2,7 +2,7 @@ title: Scala hacker guide by: Eugene Burmako layout: inner-page-no-masthead -permalink: /contribute/hacker-guide/ +# permalink: /contribute/hacker-guide/ includeTOC: true ---
@@ -54,7 +54,7 @@ it probably makes sense to familiarize yourself with Git first. We recommend * the [Git Pro](http://git-scm.com/book/en/) online book. * the help page on [Forking a Git Repository](https://help.github.com/articles/fork-a-repo). -* this great training tool [LearnGitBranching](http://pcottle.github.io/learnGitBranching/). One hour hands-on training helps more than 1000 hours reading. +* this great training tool [LearnGitBranching](http://pcottle.github.io/learnGitBranching/). One hour hands-on training helps more than 1000 hours reading. ### Fork diff --git a/contribute/index.md b/contribute/index.md index f0c52986b8..3dac16ead4 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -1,7 +1,7 @@ --- title: Contribute layout: inner-page-no-masthead -permalink: /contribute/ +# permalink: /contribute/ includeTOC: true --- @@ -22,7 +22,7 @@ how to efficiently report a bug. ### Contribute -Coordination of contribution efforts takes place on the +Coordination of contribution efforts takes place on the [scala-internals Google group](/contribute/scala-internals/). {% include column-list-of-items.html collection=site.contribute_resources %} diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md index be37d6fc12..ce4f84ecf1 100644 --- a/contribute/partest-guide.md +++ b/contribute/partest-guide.md @@ -1,7 +1,7 @@ --- title: Running the Test Suite layout: inner-page-no-masthead -permalink: /contribute/partest-guide/ +# permalink: /contribute/partest-guide/ includeTOC: true --- @@ -14,11 +14,11 @@ The test suite can be run by using ant from the command line: $ ant test.suite ## Standalone - -There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use - + +There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use + ./test/partest --show-diff --show-log --failed - + You can get a summary of the usage by running partest without arguments. * Most commonly you want to invoke partest with an option that tells it which part of the tests to run. For example `--all`, `--pos`, `--neg` or `--run`. @@ -29,13 +29,13 @@ You can get a summary of the usage by running partest without arguments. * You can use the `SCALAC_OPTS` environment variable to pass command line options to the compiler. * You can use the `JAVA_OPTS` environment variable to pass command line options to the runner (e.g., for `run/jvm` tests). * The launch scripts run partest as follows: - + scala -cp scala.tools.partest.nest.NestRunner - + Partest classes from a `quick` build, e.g., can be found in `./build/quick/classes/partest/`. - + Partest will tell you where it loads compiler/library classes from by adding the `partest.debug` property: - + scala -Dpartest.debug=true -cp scala.tools.partest.nest.NestRunner @@ -46,10 +46,10 @@ Tests that depend on [ScalaCheck](https://github.com/rickynils/scalacheck) can b import org.scalacheck._ import Prop._ - + object Test { val prop_ConcatLists = property{ (l1: ListInt, l2: ListInt) => - l1.size + l2.size == (l1 ::: l2).size + l1.size + l2.size == (l1 ::: l2).size } val tests = List(("prop_ConcatLists", prop_ConcatLists)) @@ -59,10 +59,10 @@ Tests that depend on [ScalaCheck](https://github.com/rickynils/scalacheck) can b ### Windows -Some tests might fail because line endings in the `.check` files and the produced results do not match. In that case, set either +Some tests might fail because line endings in the `.check` files and the produced results do not match. In that case, set either - git config core.autocrlf false + git config core.autocrlf false -or +or - git config core.autocrlf input \ No newline at end of file + git config core.autocrlf input diff --git a/contribute/scala-internals.md b/contribute/scala-internals.md index 831f2cc864..e6fde53a81 100644 --- a/contribute/scala-internals.md +++ b/contribute/scala-internals.md @@ -7,11 +7,11 @@ includeTOC: true ## scala-internals -The [scala-internals mailing list](https://groups.google.com/d/forum/scala-internals) is where technical and logistical discussions concerning bugs, bug fixes, documentation, improvements, new features and other contributor related topics occur. +The [scala-internals mailing list](https://groups.google.com/d/forum/scala-internals) is where technical and logistical discussions concerning bugs, bug fixes, documentation, improvements, new features and other contributor related topics occur. ### Coordinating on scala-internals -Prior to commencing on contribution work on larger changes to the Scala project, it is recommended (but not required) that you make a post on scala-internals announcing your intention. It's a great time to invite any help, advice or ask any questions you might have. It's also a great place to meet peers, one of whom will probably be reviewing your contribution at some point. For smaller bug fixes or documentation changes where the risk of effort duplication is minimal, you can skip this post. +Prior to commencing on contribution work on larger changes to the Scala project, it is recommended (but not required) that you make a post on scala-internals announcing your intention. It's a great time to invite any help, advice or ask any questions you might have. It's also a great place to meet peers, one of whom will probably be reviewing your contribution at some point. For smaller bug fixes or documentation changes where the risk of effort duplication is minimal, you can skip this post. To help subscribers on the scala-internals list to sort through the postings, we request that the following topic labels are applied when you start a new post please: @@ -44,4 +44,3 @@ While it is optional to announce your intentions/work items on scala-internals b * There are a lot of nice people waiting to talk to you on scala-internals, you might be surprised how valuable and pleasant you find the experience of talking to them. If all of this has not convinced you then, please, go ahead and work on contributions anyway. It *is* less important to post to scala-internals first for small, self contained bugs than it is for larger issues or features, and not having posted first will not be a reason for your PR to be rejected, it just might be a rougher review/merge process than if you had posted first. It's your choice. - diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index 68df995375..c64a176cde 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -1,7 +1,7 @@ --- title: Contribute to API Documentation layout: inner-page-no-masthead -permalink: /contribute/scala-standard-library-api-documentation/ +# permalink: /contribute/scala-standard-library-api-documentation/ includeTOC: true --- diff --git a/contribute/tools.md b/contribute/tools.md index 420579913e..de96e19fa5 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -1,7 +1,7 @@ --- title: IDE and Build Tool Contributions layout: inner-page-no-masthead -permalink: /contribute/tools/ +# permalink: /contribute/tools/ includeTOC: true # Projects list: @@ -45,7 +45,7 @@ projects: homeLink: http://docs.scala-lang.org/tutorials/partest-guide.html issuesLink: https://github.com/scala/scala-partest/issues readmeLink: https://github.com/scala/scala-partest/blob/master/README.md - contributingLink: + contributingLink: - title: Ensime description: Scala Support for Text Editors icon: https://avatars0.githubusercontent.com/u/5089042?v=3&s=200 @@ -76,7 +76,7 @@ projectsInNeed: description: Scala Decoder (part of scala/scala) icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 link: https://github.com/scala/scala - homeLink: + homeLink: issuesLink: https://issues.scala-lang.org/issues/?jql=status%20%3D%20Open%20AND%20text%20~%20%22scalap%22 readmeLink: https://github.com/scala/scala#welcome contributingLink: https://github.com/sbt/sbt/blob/0.13/CONTRIBUTING.md @@ -103,7 +103,7 @@ if you would like to help revive them. ### Broken Links? -Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/contribute/documentation/#updating-scala-langorg) to fix it. +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/contribute/documentation/#updating-scala-langorg) to fix it. ### Projects @@ -113,4 +113,4 @@ Stuff changes. Found a broken link or something that needs updating on this page The following projects are important to the Scala community but are particularly in need of contributors to continue their development. -{% include contributions-projects-list.html collection=page.projectsInNeed %} \ No newline at end of file +{% include contributions-projects-list.html collection=page.projectsInNeed %} From fbca9ca0b3ef20fbb657aa132f88f85b097607b4 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Fri, 14 Jul 2017 17:02:30 +0200 Subject: [PATCH 0113/3075] Bug reporting guide link fixes --- _contribute_resources/2-bug-fixes.md | 2 +- contribute/corelibs.md | 2 +- contribute/guide.md | 6 +++--- contribute/index.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_contribute_resources/2-bug-fixes.md b/_contribute_resources/2-bug-fixes.md index d10adb7908..8661ab9614 100644 --- a/_contribute_resources/2-bug-fixes.md +++ b/_contribute_resources/2-bug-fixes.md @@ -3,4 +3,4 @@ title: Bug fixes link: /contribute/guide/ icon: fa fa-pencil --- -Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/contribute/bug-reporting-guide/). \ No newline at end of file +Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/contribute/bug-reporting-guide.html). diff --git a/contribute/corelibs.md b/contribute/corelibs.md index fd69ae196e..c06a741915 100644 --- a/contribute/corelibs.md +++ b/contribute/corelibs.md @@ -9,7 +9,7 @@ includeTOC: true There are several options for contributing to Scala's core libraries. You can: * Help with [Documentation](/contribute/scala-standard-library-api-documentation/). -* [Report Bugs or Issues](/contribute/bug-reporting-guide/) against the core libraries. +* [Report Bugs or Issues](/contribute/bug-reporting-guide.html) against the core libraries. * [Fix Bugs or Issues](/contribute/guide/) against the [reported library bugs/issues](https://issues.scala-lang.org/issues/?filter=13001). * Contribute significant new functionality or a new API by submitting diff --git a/contribute/guide.md b/contribute/guide.md index 9edb289e06..bda4fa9ff3 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -12,7 +12,7 @@ includeTOC: true

Get a peek into the inners of the Scala compiler.

-

Report an issue

+

Report an issue

File a bug report or a feature request.

@@ -54,8 +54,8 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [github branch](https://github.com/scala/scala) -1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](/contribute/bug-reporting-guide/) (but please -[make sure it's not a duplicate](/contribute/bug-reporting-guide/#reporting-confirmed-bugs-is-a-sin)). +1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](/contribute/bug-reporting-guide.html) (but please +[make sure it's not a duplicate](/contribute/bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). 2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](/contribute/scala-internals/). After all, don't you want to work on a team with [these friendly people](/contribute/hacker-guide/#connect) - it's one of the perks of contributing. 3. [Fork the Scala repository](/contribute/hacker-guide/#fork) and clone your fork (if you haven't already). diff --git a/contribute/index.md b/contribute/index.md index 3dac16ead4..55563f8ac0 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -17,7 +17,7 @@ That depends on what you want to contribute. Below are some getting started reso ### Reporting bugs -See our [bug reporting guide](/contribute/bug-reporting-guide/) to learn +See our [bug reporting guide](/contribute/bug-reporting-guide.html) to learn how to efficiently report a bug. ### Contribute From e2f7c0712662e555f53f7c77cee608b5aadee722 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Fri, 14 Jul 2017 17:06:56 +0200 Subject: [PATCH 0114/3075] Removing some mentions of scala-internals --- contribute/documentation.md | 4 ++-- contribute/guide.md | 6 +++--- contribute/hacker-guide.md | 6 +++--- contribute/index.md | 4 ++-- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index 8930a3c32c..0111c5c15d 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -12,7 +12,7 @@ There are several ways you can help out with the improvement of Scala documentat * Guides, Overviews, Tutorials, Cheat Sheets and more on the docs.scala-lang.org site * Updating scala-lang.org -Please read this page, and the pages linked from this one, fully before contributing documentation. Many of the questions you have will be answered in these resources. If you have a question that isn't answered, feel free to ask on the [scala-internals Google group](https://groups.google.com/forum/#!forum/scala-internals) and then, please, submit a pull request with updated documentation reflecting that answer. +Please read this page, and the pages linked from this one, fully before contributing documentation. Many of the questions you have will be answered in these resources. If you have a question that isn't answered, feel free to ask on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and then, please, submit a pull request with updated documentation reflecting that answer. **General requirements** for documentation submissions include spell-checking all written language, ensuring code samples compile and run correctly, correct grammar, and clean formatting/layout of the documentation. @@ -27,7 +27,7 @@ Please *follow the issue submission process closely* to help prevent duplicate i * [Claim Scaladoc Issues and Provide Documentation](/contribute/scala-standard-library-api-documentation/) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. * You can also just [submit new Scaladoc](/contribute/scala-standard-library-api-documentation/) -without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on scala-internals so that people know what you are doing. +without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on [Scala Contributors](https://contributors.scala-lang.org/) so that people know what you are doing. ### The Main Scala Documentation Site diff --git a/contribute/guide.md b/contribute/guide.md index bda4fa9ff3..a824e2297f 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -8,7 +8,7 @@ includeTOC: true
-

Scala Internals

+

Scala Contributors

Get a peek into the inners of the Scala compiler.

@@ -56,7 +56,7 @@ This is the impatient developer's checklist for the steps to submit a bug-fix pu 1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](/contribute/bug-reporting-guide.html) (but please [make sure it's not a duplicate](/contribute/bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). -2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [scala-internals](/contribute/scala-internals/). After all, don't you want to work on a team with +2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with [these friendly people](/contribute/hacker-guide/#connect) - it's one of the perks of contributing. 3. [Fork the Scala repository](/contribute/hacker-guide/#fork) and clone your fork (if you haven't already). 4. [Create a feature branch](/contribute/hacker-guide/#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. @@ -75,7 +75,7 @@ Need more information or a little more hand-holding for the first one? We got yo For larger, more ambitious changes (e.g. new language features), the first step to making a change is to discuss it with the community at large, to make sure everyone agrees on the idea and on the implementation plan. Announce the change -on the [scala-internals](http://groups.google.com/group/scala-internals) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list and if a SIP is required, that will be discussed on the mailing list. +on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list and if a SIP is required, that will be discussed on the mailing list. Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against the Scala project source tree. The [hacker guide](/contribute/hacker-guide/) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 31602a0909..a10fbb70eb 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -38,7 +38,7 @@ A list of language features/libraries along with their maintainer's full names a In our running example, since Martin is the person who submitted the string interpolation Scala Improvement Proposal and implemented this language feature for Scala 2.10.0, he might be interested in learning of new bugfixes to that feature. -As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the scala-internals mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, +As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the [Scala Contributors](https://contributors.scala-lang.org/) mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, in this example, we post to the [the scala-user mailing list](http://groups.google.com/group/scala-user) about our issue. Posting to scala-user @@ -202,7 +202,7 @@ If you intend on contributing to Scala collections, please make sure you're fami ##### The Scala Compiler -Documentation about the internal workings of the Scala compiler is scarce, and most of the knowledge is passed around by email (scala-internals mailing list), ticket, or word of mouth. However the situation is steadily improving. Here are the resources that might help: +Documentation about the internal workings of the Scala compiler is scarce, and most of the knowledge is passed around by email ([Scala Contributors](https://contributors.scala-lang.org/) mailing list), ticket, or word of mouth. However the situation is steadily improving. Here are the resources that might help: * [Compiler internals videos by Martin Odersky](http://www.scala-lang.org/old/node/598.html) are quite dated, but still very useful. In this three-video series Martin explains the general architecture of the compiler, and the basics of the front-end, which has recently become Scala reflection API. @@ -212,7 +212,7 @@ Documentation about the internal workings of the Scala compiler is scarce, and m at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the architecture of the reflection API. * [Scala compiler corner](http://lampwww.epfl.ch/~magarcia/ScalaCompilerCornerReloaded/) contains extensive documentation about most of the post-typer phases (i.e. the backend) in the Scala compiler. -* [scala-internals](http://groups.google.com/group/scala-internals), a mailing list which hosts discussions about the core +* [Scala Contributors](https://contributors.scala-lang.org/), a mailing list which hosts discussions about the core internal design and implementation of the Scala system. ##### Other Projects diff --git a/contribute/index.md b/contribute/index.md index 55563f8ac0..f56a91c163 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -22,8 +22,8 @@ how to efficiently report a bug. ### Contribute -Coordination of contribution efforts takes place on the -[scala-internals Google group](/contribute/scala-internals/). +Coordination of contribution efforts takes place on +[Scala Contributors](https://contributors.scala-lang.org/). {% include column-list-of-items.html collection=site.contribute_resources %} From 5c3fbae7f06170f21acc05a37f278cacc84bdb8d Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Fri, 14 Jul 2017 17:08:59 +0200 Subject: [PATCH 0115/3075] Missing whitespace --- _contribute_resources/1-documentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md index 27739dee6a..0d9c198ffd 100644 --- a/_contribute_resources/1-documentation.md +++ b/_contribute_resources/1-documentation.md @@ -3,4 +3,4 @@ title: Documentation link: /contribute/documentation/ icon: fa fa-file-text --- -[Scaladoc (API)](/contribute/scala-standard-library-api-documentation/),[docs.scala-lang.org](http://docs.scala-lang.org/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). \ No newline at end of file +[Scaladoc (API)](/contribute/scala-standard-library-api-documentation/), [docs.scala-lang.org](http://docs.scala-lang.org/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). From d1d0f26798c64d560e8795343b49db234c7b0969 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 19 Jul 2017 11:29:38 -0400 Subject: [PATCH 0116/3075] fix or remove links to wiki the wiki has been mercifully taken offline --- contribute/documentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index 0111c5c15d..a329f67369 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -31,7 +31,7 @@ without creating an issue, but please look to see if there is an issue already s ### The Main Scala Documentation Site -[docs.scala-lang.org](https://wiki.scala-lang.org/) houses the primary source of written, non-API documentation for Scala. It's a github project that you can fork and submit pull requests from. It includes: +[docs.scala-lang.org](https://docs.scala-lang.org/) houses the primary source of written, non-API documentation for Scala. It's a github project that you can fork and submit pull requests from. It includes: * Overviews * Tutorials From 81a9902665dd90bd0b7e4b971e9f358a2bb492ab Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Thu, 10 Aug 2017 12:29:30 -0700 Subject: [PATCH 0117/3075] scala.github.com -> docs.scala-lang --- _contribute_resources/3-code-reviews.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_contribute_resources/3-code-reviews.md b/_contribute_resources/3-code-reviews.md index 2ab235993b..ffdd6d2672 100644 --- a/_contribute_resources/3-code-reviews.md +++ b/_contribute_resources/3-code-reviews.md @@ -5,4 +5,4 @@ icon: fa fa-eye --- Review pull requests against [scala/scala](https://github.com/scala/scala/pulls), [scala/scala-lang](https://github.com/scala/scala-lang/pulls), -[scala/scala.github.com](https://github.com/scala/scala.github.com/pulls)and others. \ No newline at end of file +[scala/docs.scala-lang](https://github.com/scala/docs.scala-lang/pulls)and others. From 287b50a18d6d5cd3f07e6c9de8c7df7fe7a0da0b Mon Sep 17 00:00:00 2001 From: Jimin Hsieh Date: Thu, 17 Aug 2017 21:11:58 +0800 Subject: [PATCH 0118/3075] Fix broken links of https://scala-lang.org/contribute/#contribute. --- _contribute_resources/1-documentation.md | 4 ++-- _contribute_resources/2-bug-fixes.md | 2 +- _contribute_resources/3-code-reviews.md | 2 +- _contribute_resources/4-core-libraries.md | 4 ++-- _contribute_resources/5-ide-and-build-tools.md | 4 ++-- _contribute_resources/6-compiler-language.md | 4 ++-- 6 files changed, 10 insertions(+), 10 deletions(-) diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md index 0d9c198ffd..54f18c938c 100644 --- a/_contribute_resources/1-documentation.md +++ b/_contribute_resources/1-documentation.md @@ -1,6 +1,6 @@ --- title: Documentation -link: /contribute/documentation/ +link: /contribute/documentation.html icon: fa fa-file-text --- -[Scaladoc (API)](/contribute/scala-standard-library-api-documentation/), [docs.scala-lang.org](http://docs.scala-lang.org/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). +[Scaladoc (API)](/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](http://docs.scala-lang.org/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). diff --git a/_contribute_resources/2-bug-fixes.md b/_contribute_resources/2-bug-fixes.md index 8661ab9614..cca6269e06 100644 --- a/_contribute_resources/2-bug-fixes.md +++ b/_contribute_resources/2-bug-fixes.md @@ -1,6 +1,6 @@ --- title: Bug fixes -link: /contribute/guide/ +link: /contribute/guide.html icon: fa fa-pencil --- Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/contribute/bug-reporting-guide.html). diff --git a/_contribute_resources/3-code-reviews.md b/_contribute_resources/3-code-reviews.md index ffdd6d2672..3de87cd929 100644 --- a/_contribute_resources/3-code-reviews.md +++ b/_contribute_resources/3-code-reviews.md @@ -1,6 +1,6 @@ --- title: Code Reviews -link: /contribute/codereviews/ +link: /contribute/codereviews.html icon: fa fa-eye --- Review pull requests against [scala/scala](https://github.com/scala/scala/pulls), diff --git a/_contribute_resources/4-core-libraries.md b/_contribute_resources/4-core-libraries.md index 7ad75c5752..06f1018479 100644 --- a/_contribute_resources/4-core-libraries.md +++ b/_contribute_resources/4-core-libraries.md @@ -1,6 +1,6 @@ --- title: Core Libraries -link: /contribute/corelibs/ +link: /contribute/corelibs.html icon: fa fa-clipboard --- -Update and expand the capabilities of the core (and associated) Scala libraries. \ No newline at end of file +Update and expand the capabilities of the core (and associated) Scala libraries. diff --git a/_contribute_resources/5-ide-and-build-tools.md b/_contribute_resources/5-ide-and-build-tools.md index 4b8bd2ed52..7202f0d953 100644 --- a/_contribute_resources/5-ide-and-build-tools.md +++ b/_contribute_resources/5-ide-and-build-tools.md @@ -1,6 +1,6 @@ --- title: IDE and Build Tools -link: /contribute/tools/ +link: /contribute/tools.html icon: fa fa-terminal --- -Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects. \ No newline at end of file +Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects. diff --git a/_contribute_resources/6-compiler-language.md b/_contribute_resources/6-compiler-language.md index 0c4eaa1325..fcfea35d5a 100644 --- a/_contribute_resources/6-compiler-language.md +++ b/_contribute_resources/6-compiler-language.md @@ -1,6 +1,6 @@ --- title: Compiler/Language -link: /contribute/guide/#larger-changes-new-features +link: /contribute/guide.html#larger-changes-new-features icon: fa fa-gears --- -Larger language features and compiler enhancements including language specification and SIPs. \ No newline at end of file +Larger language features and compiler enhancements including language specification and SIPs. From 18f49fc7d95e020cb39e4c2130299fe5b45b41a6 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Thu, 17 Aug 2017 17:33:08 +0200 Subject: [PATCH 0119/3075] More link fixes --- contribute/codereviews.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/codereviews.md b/contribute/codereviews.md index 2c56b4ed37..ab321fd2ca 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -15,7 +15,7 @@ own pull requests. ### Review Guidelines -[Code of Conduct reminder](/conduct/) +[Code of Conduct reminder]({{ site.baseurl }}/conduct.html) * Keep comments on-topic, concise and precise. * Attach comments to particular lines or regions they pertain to whenever possible. From aaf513b07215bffa7bd36d76d37922d2655a7767 Mon Sep 17 00:00:00 2001 From: Janek Bogucki Date: Wed, 6 Sep 2017 11:17:58 +0100 Subject: [PATCH 0120/3075] Extend partest guide with sbt and mention batch script removals --- contribute/partest-guide.md | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md index ce4f84ecf1..dccee46a1c 100644 --- a/contribute/partest-guide.md +++ b/contribute/partest-guide.md @@ -5,17 +5,37 @@ layout: inner-page-no-masthead includeTOC: true --- -Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go the scala project folder from your local checkout and run it via `ant` or standalone as follows. +Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go to the scala project folder from your local checkout and run it via `sbt`, `ant` or standalone as follows. + +## Using sbt + +The test suite can be run from the sbt console with: + + > partest + +You can get a summary of the usage by running `partest --help`. + +If you would like to run particular tests pass the test paths as arguments + + > partest test/files/pos/bounds.scala test/scaladoc/run/diagrams-base.scala + +To run only the Scaladoc tests use `--srcpath` with the location of the tests + + > partest --srcpath scaladoc ## Using ant +Please note support for ant was removed on the 2.12 branch. + The test suite can be run by using ant from the command line: $ ant test.suite ## Standalone -There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use +Please note the standalone scripts mentioned below were removed in 2.12.2. sbt is the perferred way to run the test suite. + +There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use ./test/partest --show-diff --show-log --failed From 48e43e80173efa233cb422e6e1a888c79c74a12e Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 6 Sep 2017 16:23:34 -0700 Subject: [PATCH 0121/3075] fix typo --- contribute/partest-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md index dccee46a1c..e7e10621e1 100644 --- a/contribute/partest-guide.md +++ b/contribute/partest-guide.md @@ -33,7 +33,7 @@ The test suite can be run by using ant from the command line: ## Standalone -Please note the standalone scripts mentioned below were removed in 2.12.2. sbt is the perferred way to run the test suite. +Please note the standalone scripts mentioned below were removed in 2.12.2. sbt is the preferred way to run the test suite. There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use From 6f2ca77dae73a6b1ccbedc639c5aed31940c8107 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Wed, 15 Nov 2017 10:59:10 +0100 Subject: [PATCH 0122/3075] Fix links to Hacker guide --- contribute/guide.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/contribute/guide.md b/contribute/guide.md index a824e2297f..ae69f50fd2 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -23,7 +23,7 @@ includeTOC: true

Get cracking on some easy to approach issues.

-

Hacker's guide

+

Hacker guide

Learn to write good code and improve your chances of contributing to the Scala galaxy.

@@ -57,16 +57,16 @@ This is the impatient developer's checklist for the steps to submit a bug-fix pu 1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](/contribute/bug-reporting-guide.html) (but please [make sure it's not a duplicate](/contribute/bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). 2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with -[these friendly people](/contribute/hacker-guide/#connect) - it's one of the perks of contributing. -3. [Fork the Scala repository](/contribute/hacker-guide/#fork) and clone your fork (if you haven't already). -4. [Create a feature branch](/contribute/hacker-guide/#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. -5. [Fix the bug, or implement the new small feature](/contribute/hacker-guide/#implement), include new tests (yes, for bug fixes too). -6. [Test, rinse](/contribute/hacker-guide/#test) and [test some more](/contribute/partest-guide/) until [all the tests pass](/contribute/hacker-guide/#verify). -7. [Commit your changes](/contribute/hacker-guide#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. +[these friendly people](/contribute/hacker-guide.html#1-connect) - it's one of the perks of contributing. +3. [Fork the Scala repository](/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). +4. [Create a feature branch](/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. +5. [Fix the bug, or implement the new small feature](/contribute/hacker-guide.html#implement), include new tests (yes, for bug fixes too). +6. [Test, rinse](/contribute/hacker-guide.html#test) and [test some more](/contribute/partest-guide/) until [all the tests pass](/contribute/hacker-guide.html#verify). +7. [Commit your changes](/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. 8. If necessary [re-write git history](http://git-scm.com/book/en/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) 9. [Submit a pull request](./hacker-guide.html#submit) following the [Scala project pull-request guidelines](http://docs.scala-lang.org/scala/pull-request-policy.html). -10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/contribute/hacker-guide/#review). +10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/contribute/hacker-guide.html#review). 11. Celebrate! Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide](./hacker-guide.html) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). @@ -78,4 +78,4 @@ and on the implementation plan. Announce the change on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list and if a SIP is required, that will be discussed on the mailing list. Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against -the Scala project source tree. The [hacker guide](/contribute/hacker-guide/) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. +the Scala project source tree. The [hacker guide](/contribute/hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. From 3db9bb55a2f392f80f5bdb54c7811f948ade5b33 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:04:51 +0100 Subject: [PATCH 0123/3075] Add missing space --- _contribute_resources/3-code-reviews.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_contribute_resources/3-code-reviews.md b/_contribute_resources/3-code-reviews.md index 3de87cd929..2fc057eb0d 100644 --- a/_contribute_resources/3-code-reviews.md +++ b/_contribute_resources/3-code-reviews.md @@ -5,4 +5,4 @@ icon: fa fa-eye --- Review pull requests against [scala/scala](https://github.com/scala/scala/pulls), [scala/scala-lang](https://github.com/scala/scala-lang/pulls), -[scala/docs.scala-lang](https://github.com/scala/docs.scala-lang/pulls)and others. +[scala/docs.scala-lang](https://github.com/scala/docs.scala-lang/pulls) and others. From 725800ebd3d4e2b71407ea2017428853ce2b96a2 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:11:47 +0100 Subject: [PATCH 0124/3075] Fix links --- contribute/corelibs.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/corelibs.md b/contribute/corelibs.md index c06a741915..aeb19e89af 100644 --- a/contribute/corelibs.md +++ b/contribute/corelibs.md @@ -8,9 +8,9 @@ includeTOC: true There are several options for contributing to Scala's core libraries. You can: -* Help with [Documentation](/contribute/scala-standard-library-api-documentation/). +* Help with [Documentation](/contribute/documentation.html). * [Report Bugs or Issues](/contribute/bug-reporting-guide.html) against the core libraries. -* [Fix Bugs or Issues](/contribute/guide/) against the +* [Fix Bugs or Issues](/contribute/guide.html) against the [reported library bugs/issues](https://issues.scala-lang.org/issues/?filter=13001). * Contribute significant new functionality or a new API by submitting a Scala Library Improvement Process (SLIP) Document. From 56abdcb1b0912957fc4e9f5c92018fbed73c04cb Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:12:47 +0100 Subject: [PATCH 0125/3075] Link to GitHub instead of JIRA --- contribute/corelibs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/corelibs.md b/contribute/corelibs.md index aeb19e89af..e1f10cb790 100644 --- a/contribute/corelibs.md +++ b/contribute/corelibs.md @@ -11,7 +11,7 @@ There are several options for contributing to Scala's core libraries. You can: * Help with [Documentation](/contribute/documentation.html). * [Report Bugs or Issues](/contribute/bug-reporting-guide.html) against the core libraries. * [Fix Bugs or Issues](/contribute/guide.html) against the - [reported library bugs/issues](https://issues.scala-lang.org/issues/?filter=13001). + [reported library bugs/issues](https://github.com/scala/bug). * Contribute significant new functionality or a new API by submitting a Scala Library Improvement Process (SLIP) Document. From 46fc7ea2c1117a6fc9ea612e4cf53d92f802aa5d Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:19:43 +0100 Subject: [PATCH 0126/3075] Reword and link to GitHub instead of JIRA --- contribute/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/guide.md b/contribute/guide.md index ae69f50fd2..1b530a1769 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -43,7 +43,7 @@ The main Scala project consists of the standard Scala library, the Scala reflect the Scala compiler and the Scaladoc tool. This means there's plenty to choose from when deciding what to work on. Typically the scaladoc tool provides a low entry point for new committers, so it is a good first step into contributing. -On the Scala bug tracker you will find many bugs that are [marked as good starting points to contributing ("community" bugs)](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12111) or [that are not currently assigned](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12112) and that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. +On the [Scala bug tracker](https://github.com/scala/bug) you will find the bugs that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. If you are interested in contributing code, we ask you to sign the [Scala Contributor License Agreement](http://www.lightbend.com/contribute/cla/scala), From 381b641dfb1a00ef2da9d646078cc4e8a85e4501 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:20:28 +0100 Subject: [PATCH 0127/3075] Link to GitHub instead of JIRA --- contribute/scala-standard-library-api-documentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index c64a176cde..6467cea947 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -42,7 +42,7 @@ and identify missing, incorrect or inadequate documentation. A good place to sta package objects for important packages (these often get overlooked for documentation and are a good place for API overviews). -If you find an issue, please log it in the [Scala issue tracker](https://issues.scala-lang.org) +If you find an issue, please log it in the [Scala bug tracker](https://github.com/scala/bug) **after making sure it is not already logged as an issue**. To help with disambiguation, please use the following format for issue title: From 74ce0815244088f76cab5e1f3d9cab4e4248a59d Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:39:58 +0100 Subject: [PATCH 0128/3075] Fix ironically broken link --- contribute/tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/tools.md b/contribute/tools.md index de96e19fa5..599cbf381e 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -103,7 +103,7 @@ if you would like to help revive them. ### Broken Links? -Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/contribute/documentation/#updating-scala-langorg) to fix it. +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/contribute/documentation.html#updating-scala-langorg) to fix it. ### Projects From 832e674c2c10dcf1f1341d50dbcc549e917662f6 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:41:15 +0100 Subject: [PATCH 0129/3075] Link to GitHub instead of JIRA --- contribute/tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/tools.md b/contribute/tools.md index 599cbf381e..8337c10935 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -19,7 +19,7 @@ projects: icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 link: https://github.com/scala/scala homeLink: http://www.scala-lang.org/api - issuesLink: https://issues.scala-lang.org/issues/?jql=status%20%3D%20Open%20AND%20component%20%3D%20%22Scaladoc%20Tool%22 + issuesLink: https://github.com/scala/bug/labels/scaladoc readmeLink: https://github.com/scala/scala#welcome contributingLink: http://scala-lang.org/contribute/guide.html - title: Scala IDE From e4f39bf320ae3e8ee2fda6a3e91b94644ae239da Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:42:23 +0100 Subject: [PATCH 0130/3075] Fix Scalariform section --- contribute/tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/tools.md b/contribute/tools.md index 8337c10935..feb11afa8f 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -80,8 +80,8 @@ projectsInNeed: issuesLink: https://issues.scala-lang.org/issues/?jql=status%20%3D%20Open%20AND%20text%20~%20%22scalap%22 readmeLink: https://github.com/scala/scala#welcome contributingLink: https://github.com/sbt/sbt/blob/0.13/CONTRIBUTING.md - - title: Scaladoc Tool - description: (Contribute through scala/scala) + - title: Scalariform + description: Scala source code formatter icon: /resources/img/white-line.png link: https://github.com/mdr/scalariform homeLink: https://github.com/mdr/scalariform/wiki/Command-line-tool From 4a9c5f05ca7161756ae3b7f1be520908caa53910 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:46:12 +0100 Subject: [PATCH 0131/3075] Remove Scalap --- contribute/tools.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/contribute/tools.md b/contribute/tools.md index feb11afa8f..a1e2ef78e2 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -72,14 +72,6 @@ projects: contributingLink: https://github.com/scala/scala-abide#extending-abide projectsInNeed: - - title: Scalap - description: Scala Decoder (part of scala/scala) - icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 - link: https://github.com/scala/scala - homeLink: - issuesLink: https://issues.scala-lang.org/issues/?jql=status%20%3D%20Open%20AND%20text%20~%20%22scalap%22 - readmeLink: https://github.com/scala/scala#welcome - contributingLink: https://github.com/sbt/sbt/blob/0.13/CONTRIBUTING.md - title: Scalariform description: Scala source code formatter icon: /resources/img/white-line.png From 0dc0f0dab8532365fd069f7f3984d66976562635 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sat, 27 Jan 2018 21:52:55 +0100 Subject: [PATCH 0132/3075] Link to GitHub instead of JIRA --- contribute/hacker-guide.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index a10fbb70eb..4200df478c 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -17,7 +17,7 @@ Other good starting points for first-time contributors include the [Scala README Let's say that you particularly enjoy the new string interpolation language feature introduced in Scala 2.10.0, and you use it quite heavily. Though, there's an annoying issue -which you occasionally stumble upon: the formatting string interpolator `f` [does not support](https://issues.scala-lang.org/browse/SI-6725) +which you occasionally stumble upon: the formatting string interpolator `f` [does not support](https://github.com/scala/bug/issues/6725) new line tokens `%n`. One approach would be to go the mailing list, request that the bug be fixed, and then to wait indefinitely for the fix arrive. Another approach would be to instead patch Scala oneself, and to submit the fix to the Scala repository in hopes that it might make it into a subsequent release. @@ -88,10 +88,10 @@ Before you start making changes, always create your own branch. Never work on th the changes you plan on making. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: bug fixes and new features. -* For bug fixes, use `issue/NNNN` or `ticket/NNNN` for bug NNNN from the [Scala issue tracker](https://issues.scala-lang.org/). +* For bug fixes, use `issue/NNNN` or `ticket/NNNN` for bug NNNN from the [Scala bug tracker](https://github.com/scala/bug). * For new feature use `topic/XXX` for feature XXX. Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaladoc-diagrams` instead of just `topic/diagrams` would be a good branch name. -Since in our example, we're going to fix an existing bug [SI-6725](https://issues.scala-lang.org/browse/SI-6725), we'll create a branch named `ticket/6725`. +Since in our example, we're going to fix an existing bug [6725](https://github.com/scala/bug/issues/6725), we'll create a branch named `ticket/6725`. 16:39 ~/Projects/scala (master)$ git checkout -b ticket/6725 Switched to a new branch 'ticket/6725' @@ -108,7 +108,7 @@ You need the following tools: * `sbt`, an interactive build tool commonly used in Scala projects. Acquiring sbt manually is not necessary -- the recommended approach is to download the [sbt-extras runner script](https://github.com/paulp/sbt-extras/blob/master/sbt) and use it in place of `sbt`. The script will download and run the correct version of sbt when run from the Scala repository's root directory. * `curl` -- the build uses `curl` in the `pull-binary-libs.sh` script to download bootstrap libs. -OS X and Linux builds should work. Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. +OS X and Linux builds should work. Windows is supported, but it might have issues. Please report to the [Scala bug tracker](https://github.com/scala/bug) if you encounter any. Building Scala is as easy as running `sbt dist/mkPack` in the root of your cloned repository. In general, it's much more efficient to enter the `sbt` shell once and run the various tasks from there, instead of running each task by launching `sbt some-task` on your command prompt. @@ -136,7 +136,7 @@ Typically you would want to first make sure that your changes work on a small ex by running a comprehensive test suite. We'll start by creating a `sandbox` directory (`./sandbox` is listed in the .gitignore of the Scala repository), which will hold a single test file and its compilation results. First, let's make sure that -[the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by putting together a simple test and compiling and running it with the Scala compiler that we built using `sbt`. The Scala compiler that we just built is located in `build/pack/bin`. +[the bug](https://github.com/scala/bug/issues/6725) is indeed reproducible by putting together a simple test and compiling and running it with the Scala compiler that we built using `sbt`. The Scala compiler that we just built is located in `build/pack/bin`. 17:25 ~/Projects/scala (ticket/6725)$ mkdir sandbox 17:26 ~/Projects/scala (ticket/6725)$ cd sandbox @@ -221,7 +221,7 @@ Tools like Scaladoc also welcome contributions. Unfortunately these smaller proj ### Interlude -To fix [the bug we're interested in](https://issues.scala-lang.org/browse/SI-6725) we've tracked the `StringContext.f` interpolator +To fix [the bug we're interested in](https://github.com/scala/bug/issues/6725) we've tracked the `StringContext.f` interpolator down to a macro implemented in `MacroImplementations.scala` There we notice that the interpolator only processes conversions, but not tokens like `%n`. Looks like an easy fix. From 5ad09fd1367de5fc65748ded6df8c003c636ee84 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sun, 28 Jan 2018 00:11:41 +0100 Subject: [PATCH 0133/3075] Remove link to 'Actors Migration Kit' --- contribute/bug-reporting-guide.md | 1 - 1 file changed, 1 deletion(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 05569ff8e4..71cb5e7ad8 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -21,7 +21,6 @@ If your issue is related to any of the following external projects, make sure to - [Akka](http://doc.akka.io/docs/akka/current/project/issue-tracking.html) - [Play!](http://github.com/playframework/Play20/issues) - [Slick](http://github.com/slick/slick/issues) - - [Actors Migration Kit](http://github.com/scala/actors-migration/issues?state=open) - [Scala IDE](https://scala-ide-portfolio.assembla.com/spaces/scala-ide/support/tickets) - [sbt](https://github.com/sbt/sbt/issues) From 1b4d548cbcfe92a861d226c07164006e8afb44fe Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sun, 28 Jan 2018 00:16:53 +0100 Subject: [PATCH 0134/3075] Replace references to 'JIRA' with 'GitHub' --- contribute/guide.md | 4 ++-- contribute/scala-standard-library-api-documentation.md | 6 +++--- contribute/tools.md | 2 +- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/contribute/guide.md b/contribute/guide.md index 1b530a1769..c2949683ae 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -54,12 +54,12 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [github branch](https://github.com/scala/scala) -1. [Select a bug to fix from JIRA](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a JIRA issue](/contribute/bug-reporting-guide.html) (but please +1. [Select a bug to fix from GitHub](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a GitHub issue](/contribute/bug-reporting-guide.html) (but please [make sure it's not a duplicate](/contribute/bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). 2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with [these friendly people](/contribute/hacker-guide.html#1-connect) - it's one of the perks of contributing. 3. [Fork the Scala repository](/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). -4. [Create a feature branch](/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. +4. [Create a feature branch](/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the GitHub issue number. 5. [Fix the bug, or implement the new small feature](/contribute/hacker-guide.html#implement), include new tests (yes, for bug fixes too). 6. [Test, rinse](/contribute/hacker-guide.html#test) and [test some more](/contribute/partest-guide/) until [all the tests pass](/contribute/hacker-guide.html#verify). 7. [Commit your changes](/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index 6467cea947..cae67a5db0 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -22,7 +22,7 @@ contribution steps and guidelines. Thank you.* Since API documentation is located in Scala source code files, the process for contributing API documentation is similar to that of contributing bug-fixes -to the Scala code base, but without the requirement that there be an issue filed on JIRA +to the Scala code base, but without the requirement that there be an issue filed on GitHub first. When forking/branching, just use a `scaladoc/xxxx` branch name, where xxxx is a descriptive, but short branch name (e.g. `scaladoc/future-object`). However, if an issue *does* exist, please use `issue/NNNN`, where NNNN is the ticket number, @@ -78,9 +78,9 @@ Please familiarize yourself with the following before contributing new API documentation to save time, effort, mistakes and repetition. * [Forking the Repo](./hacker-guide.html#set-up) - follow the setup steps through - the Branch section. If providing new documentation related to an existing JIRA issue, use `issue/NNNN` + the Branch section. If providing new documentation related to an existing GitHub issue, use `issue/NNNN` or `ticket/NNNN` as the guide states. If providing API documentation with no associated - JIRA issue, use `scaladoc/xxxx` instead. + GitHub issue, use `scaladoc/xxxx` instead. * [Scaladoc for library authors](http://docs.scala-lang.org/overviews/scaladoc/for-library-authors.html) covers the use of scaladoc tags, markdown and other features. * [Scaladoc's interface](http://docs.scala-lang.org/overviews/scaladoc/interface.html) diff --git a/contribute/tools.md b/contribute/tools.md index a1e2ef78e2..19f953785f 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -86,7 +86,7 @@ The links below are to a number of Scala build and IDE related projects that are Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](/contribute/hacker-guide/) and [Bug-fixing](/contribute/guide/) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. -Typically, issues for these projects will be reported and kept in the github project issue tracker for that project rather than in the Scala project JIRA. +Typically, issues for these projects will be reported and kept in the GitHub project issue tracker for that project rather than in the Scala bug tracker. Many of these projects have a gitter channel (usually listed in the README or CONTRIBUTING documents) which is a great place to discuss proposed work before commencing. There are some projects in this section that are in From 76665323a75257fc23570b416e1dd102824b5e1d Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sun, 28 Jan 2018 00:30:03 +0100 Subject: [PATCH 0135/3075] Remove 'Community Tickets' section almost completely --- contribute/index.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/contribute/index.md b/contribute/index.md index f56a91c163..f8d71a1f69 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -29,10 +29,8 @@ Coordination of contribution efforts takes place on ### Community Tickets -The following links provide starting points for -various contributor activities: - -{% include column-list-of-items.html collection=site.contribute_community_tickets %} +All issues can be found in the [Scala bug tracker](https://github.com/scala/bug). Most issues are labeled +to make it easier to find issues you are interested in. ### Tools and Libraries From 0dda54719465b83ce5267a663ca5e31927c51486 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sun, 28 Jan 2018 11:48:36 +0100 Subject: [PATCH 0136/3075] Fix links to Mailing Lists --- contribute/hacker-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index a10fbb70eb..c6ce1c7eea 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -30,7 +30,7 @@ Sometimes it's appealing to hack alone and not to have to interact with others o this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. -Typically bug fixes and new features start out as an idea or an experiment posted on one of [our mailing lists]({{ site.baseurl }}/community/index.html#mailing-lists) to find out how people feel +Typically bug fixes and new features start out as an idea or an experiment posted on one of [our mailing lists]({{ site.baseurl }}/community/index.html#forums--mailing-lists) to find out how people feel about things you want to implement. People proficient in certain areas of Scala usually monitor mailing lists, so you'll often get some help by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. From 2f7d9fbed9fbb41c9489d5cb22c148e4f16155d1 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sun, 28 Jan 2018 12:43:49 +0100 Subject: [PATCH 0137/3075] Fix broken links --- contribute/codereviews.md | 4 ++-- contribute/guide.md | 2 +- contribute/scala-standard-library-api-documentation.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/contribute/codereviews.md b/contribute/codereviews.md index ab321fd2ca..6e0a2592b6 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -6,7 +6,7 @@ includeTOC: true --- ## Code Review Contributions -In addition to [bug fixing](/contribute/guide/), you can help us review +In addition to [bug fixing](/contribute/guide.html), you can help us review [waiting pull requests](#pull-requests-awaiting-comment). This is also a good (and recommended) way to get to know the feel of the bug-fixing and submissions process before jumping in with your @@ -51,4 +51,4 @@ own pull requests.
-Also note that the [Tools contributions](/contribute/tools/) page has more projects that will generate pull requests. +Also note that the [Tools contributions](/contribute/tools.html) page has more projects that will generate pull requests. diff --git a/contribute/guide.md b/contribute/guide.md index ae69f50fd2..1f1a014a1b 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -61,7 +61,7 @@ This is the impatient developer's checklist for the steps to submit a bug-fix pu 3. [Fork the Scala repository](/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). 4. [Create a feature branch](/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the JIRA issue number. 5. [Fix the bug, or implement the new small feature](/contribute/hacker-guide.html#implement), include new tests (yes, for bug fixes too). -6. [Test, rinse](/contribute/hacker-guide.html#test) and [test some more](/contribute/partest-guide/) until [all the tests pass](/contribute/hacker-guide.html#verify). +6. [Test, rinse](/contribute/hacker-guide.html#test) and [test some more](/contribute/partest-guide.html) until [all the tests pass](/contribute/hacker-guide.html#verify). 7. [Commit your changes](/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. 8. If necessary [re-write git history](http://git-scm.com/book/en/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index c64a176cde..d7c69ef099 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -77,7 +77,7 @@ component so that they show up in the correct issue filters. Please familiarize yourself with the following before contributing new API documentation to save time, effort, mistakes and repetition. -* [Forking the Repo](./hacker-guide.html#set-up) - follow the setup steps through +* [Forking the Repo](./hacker-guide.html#2-set-up) - follow the setup steps through the Branch section. If providing new documentation related to an existing JIRA issue, use `issue/NNNN` or `ticket/NNNN` as the guide states. If providing API documentation with no associated JIRA issue, use `scaladoc/xxxx` instead. From f00b6f35c233152a7d5d3abea317d45369779a96 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sun, 28 Jan 2018 13:26:28 +0100 Subject: [PATCH 0138/3075] Update links for ENSIME --- contribute/tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/tools.md b/contribute/tools.md index de96e19fa5..99bc353663 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -52,8 +52,8 @@ projects: link: https://github.com/ensime/ensime-server homeLink: http://ensime.github.io/ issuesLink: https://github.com/ensime/ensime-server/issues - readmeLink: https://github.com/ensime/ensime-server/blob/2.0/README.md - contributingLink: https://ensime.github.io/contributing/ + readmeLink: http://ensime.github.io/ + contributingLink: http://ensime.github.io/server/contributing/ - title: Scoverage description: Scala code coverage tool icon: https://avatars1.githubusercontent.com/u/5998302?v=3&s=200 From 5d99628ed6021cadecb44b96154134f4b3196795 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sun, 28 Jan 2018 16:26:24 +0100 Subject: [PATCH 0139/3075] Remove link to not-existing page --- contribute/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/guide.md b/contribute/guide.md index 1f1a014a1b..73b21ec22b 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -65,7 +65,7 @@ This is the impatient developer's checklist for the steps to submit a bug-fix pu 7. [Commit your changes](/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. 8. If necessary [re-write git history](http://git-scm.com/book/en/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) -9. [Submit a pull request](./hacker-guide.html#submit) following the [Scala project pull-request guidelines](http://docs.scala-lang.org/scala/pull-request-policy.html). +9. [Submit a pull request](./hacker-guide.html#submit). 10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/contribute/hacker-guide.html#review). 11. Celebrate! From d13b13bd0cb4d050f5bada2b510d12b4b326701b Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Sun, 28 Jan 2018 17:42:37 +0100 Subject: [PATCH 0140/3075] Update DBuild links --- contribute/tools.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/contribute/tools.md b/contribute/tools.md index 99bc353663..571005612a 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -33,11 +33,11 @@ projects: - title: DBuild description: Multi-project build tool. icon: https://avatars3.githubusercontent.com/u/784923?v=3&s=200 - link: https://github.com/typesafehub/dbuild - homeLink: http://typesafehub.github.io/dbuild - issuesLink: https://github.com/typesafehub/dbuild/issues - readmeLink: https://github.com/typesafehub/dbuild/blob/master/README.md - contributingLink: https://github.com/typesafehub/dbuild/blob/master/README.md#get-involved + link: https://github.com/lightbend/dbuild + homeLink: http://lightbend.github.io/dbuild + issuesLink: https://github.com/lightbend/dbuild/issues + readmeLink: https://github.com/lightbend/dbuild/blob/master/README.md + contributingLink: https://github.com/lightbend/dbuild/blob/master/README.md#get-involved - title: Partest description: Scala Compiler/Library Testing icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 From df0a9ab333fd0fa892f7ccf6e28fe28cc68a7f72 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Wed, 14 Feb 2018 20:24:48 +0100 Subject: [PATCH 0141/3075] Update broken/outdated links --- contribute/tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/tools.md b/contribute/tools.md index 4ae371d64e..0a3bd6e80e 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -44,7 +44,7 @@ projects: link: https://github.com/scala/scala-partest homeLink: http://docs.scala-lang.org/tutorials/partest-guide.html issuesLink: https://github.com/scala/scala-partest/issues - readmeLink: https://github.com/scala/scala-partest/blob/master/README.md + readmeLink: https://github.com/scala/scala-partest/blob/1.1.x/README.md contributingLink: - title: Ensime description: Scala Support for Text Editors @@ -84,7 +84,7 @@ projectsInNeed: The links below are to a number of Scala build and IDE related projects that are important in the larger Scala space, and which welcome contributions. -Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](/contribute/hacker-guide/) and [Bug-fixing](/contribute/guide/) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. +Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](/contribute/hacker-guide.html) and [Bug-fixing](/contribute/guide.html) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. Typically, issues for these projects will be reported and kept in the GitHub project issue tracker for that project rather than in the Scala bug tracker. Many of these projects have a gitter channel (usually listed in the README or CONTRIBUTING documents) which is a great place to discuss proposed work before commencing. From d0fc35c74940a14777bf68d393159ebfe56e1ed0 Mon Sep 17 00:00:00 2001 From: Olivier Blanvillain Date: Fri, 16 Feb 2018 10:59:33 +0100 Subject: [PATCH 0142/3075] s/username/user-name/ to please htmlproofer --- contribute/hacker-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index d63ad12cf4..78af87bbcd 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -67,7 +67,7 @@ If you're new to Git, don't be afraid of messing up-- there is no way you can co ### Clone -If everything went okay, you will be redirected to your own fork at `https://github.com/username/scala`, where `username` +If everything went okay, you will be redirected to your own fork at `https://github.com/user-name/scala`, where `username` is your github user name. You might find it helpful to read [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/), which covers some of the things that will follow below. Then, _clone_ your repository (i.e. pull a copy from GitHub to your local machine) by running the following on the command line: From 084649625b4db03be95dcceef418f470bedaabff Mon Sep 17 00:00:00 2001 From: Olivier Blanvillain Date: Fri, 16 Feb 2018 12:00:21 +0100 Subject: [PATCH 0143/3075] Fix contribute link --- contribute/documentation.md | 6 +++--- contribute/scala-standard-library-api-documentation.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/contribute/documentation.md b/contribute/documentation.md index a329f67369..40f7ad9c6e 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -22,11 +22,11 @@ Thanks The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: -* [Log issues for missing scaladoc documentation](/contribute/scala-standard-library-api-documentation/#contribute-api-documentation-bug-reports) - +* [Log issues for missing scaladoc documentation](/contribute/scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - Please *follow the issue submission process closely* to help prevent duplicate issues being created. -* [Claim Scaladoc Issues and Provide Documentation](/contribute/scala-standard-library-api-documentation/) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. +* [Claim Scaladoc Issues and Provide Documentation](/contribute/scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. * You can also just -[submit new Scaladoc](/contribute/scala-standard-library-api-documentation/) +[submit new Scaladoc](/contribute/scala-standard-library-api-documentation.html) without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on [Scala Contributors](https://contributors.scala-lang.org/) so that people know what you are doing. ### The Main Scala Documentation Site diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index f05df8663b..33ee4ad558 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -1,7 +1,7 @@ --- title: Contribute to API Documentation layout: inner-page-no-masthead -# permalink: /contribute/scala-standard-library-api-documentation/ +# permalink: /contribute/scala-standard-library-api-documentation.html includeTOC: true --- From ddd3d65b225ec930238e2dbd245b397b52a78006 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 9 Jul 2018 14:29:27 -0700 Subject: [PATCH 0144/3075] tiny formatting fix --- _overviews/plugins/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/plugins/index.md b/_overviews/plugins/index.md index 16a44644ba..3b11e43164 100644 --- a/_overviews/plugins/index.md +++ b/_overviews/plugins/index.md @@ -5,7 +5,7 @@ title: Scala Compiler Plugins discourse: true --- -**Lex Spoon (2008)** +**Lex Spoon (2008)** **Seth Tisue (2018)** ## Introduction From 0b0edeec96045239414999ab7bd1cb362c85e49a Mon Sep 17 00:00:00 2001 From: Roman Filonenko Date: Thu, 12 Jul 2018 14:35:06 +0200 Subject: [PATCH 0145/3075] add implicit keyword to the Modifiers section #1075 --- _style/declarations.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_style/declarations.md b/_style/declarations.md index f039b56595..ca6c389d5c 100644 --- a/_style/declarations.md +++ b/_style/declarations.md @@ -116,8 +116,9 @@ applicable): 1. Annotations, *each on their own line* 2. Override modifier (`override`) 3. Access modifier (`protected`, `private`) -4. Final modifier (`final`) -5. `def` +4. Implicit modifier (`implicit`) +5. Final modifier (`final`) +6. `def` From 163b725ce841fa624d1b697d14ad33e6c47c210b Mon Sep 17 00:00:00 2001 From: Jatin Gupta Date: Sun, 15 Jul 2018 22:35:34 -0700 Subject: [PATCH 0146/3075] Update documentation since deprecation now takes two arguments --- _tour/annotations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/annotations.md b/_tour/annotations.md index 32220d90a6..f88ba840cc 100644 --- a/_tour/annotations.md +++ b/_tour/annotations.md @@ -16,7 +16,7 @@ redirect_from: "/tutorials/tour/annotations.html" Annotations associate meta-information with definitions. For example, the annotation `@deprecated` before a method causes the compiler to print a warning if the method is used. ``` object DeprecationDemo extends App { - @deprecated + @deprecated("deprecation message e.g. - this method will be removed", "next release in which method will be deprecated e.g. ExampleLib 2.0") def hello = "hola" hello From 0e3e8669c6e9612bd849a07c6ed5193c7acb39dc Mon Sep 17 00:00:00 2001 From: Jatin Gupta Date: Mon, 16 Jul 2018 10:20:21 -0700 Subject: [PATCH 0147/3075] Keep character count under 60 --- _tour/annotations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/annotations.md b/_tour/annotations.md index f88ba840cc..b486d7b806 100644 --- a/_tour/annotations.md +++ b/_tour/annotations.md @@ -16,7 +16,7 @@ redirect_from: "/tutorials/tour/annotations.html" Annotations associate meta-information with definitions. For example, the annotation `@deprecated` before a method causes the compiler to print a warning if the method is used. ``` object DeprecationDemo extends App { - @deprecated("deprecation message e.g. - this method will be removed", "next release in which method will be deprecated e.g. ExampleLib 2.0") + @deprecated("deprecation message", "release # which deprecates method") def hello = "hola" hello From 5a6710b8a56b85ccf7b6e95e054dfbe1ec988fd8 Mon Sep 17 00:00:00 2001 From: Philippus Date: Wed, 18 Jul 2018 18:48:21 +0200 Subject: [PATCH 0148/3075] Use jQuery from CDN, fall back to local if needed, closes #1074 --- _includes/footer.html | 3 ++- scripts/jquery-3.1.1.min.js | 4 ++++ 2 files changed, 6 insertions(+), 1 deletion(-) create mode 100644 scripts/jquery-3.1.1.min.js diff --git a/_includes/footer.html b/_includes/footer.html index 7171b3c1f5..6fba4fd292 100644 --- a/_includes/footer.html +++ b/_includes/footer.html @@ -21,7 +21,8 @@ - + + diff --git a/scripts/jquery-3.1.1.min.js b/scripts/jquery-3.1.1.min.js new file mode 100644 index 0000000000..4c5be4c0fb --- /dev/null +++ b/scripts/jquery-3.1.1.min.js @@ -0,0 +1,4 @@ +/*! jQuery v3.1.1 | (c) jQuery Foundation | jquery.org/license */ +!function(a,b){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=a.document?b(a,!0):function(a){if(!a.document)throw new Error("jQuery requires a window with a document");return b(a)}:b(a)}("undefined"!=typeof window?window:this,function(a,b){"use strict";var c=[],d=a.document,e=Object.getPrototypeOf,f=c.slice,g=c.concat,h=c.push,i=c.indexOf,j={},k=j.toString,l=j.hasOwnProperty,m=l.toString,n=m.call(Object),o={};function p(a,b){b=b||d;var c=b.createElement("script");c.text=a,b.head.appendChild(c).parentNode.removeChild(c)}var q="3.1.1",r=function(a,b){return new r.fn.init(a,b)},s=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,t=/^-ms-/,u=/-([a-z])/g,v=function(a,b){return b.toUpperCase()};r.fn=r.prototype={jquery:q,constructor:r,length:0,toArray:function(){return f.call(this)},get:function(a){return null==a?f.call(this):a<0?this[a+this.length]:this[a]},pushStack:function(a){var b=r.merge(this.constructor(),a);return b.prevObject=this,b},each:function(a){return r.each(this,a)},map:function(a){return this.pushStack(r.map(this,function(b,c){return a.call(b,c,b)}))},slice:function(){return this.pushStack(f.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(a){var b=this.length,c=+a+(a<0?b:0);return this.pushStack(c>=0&&c0&&b-1 in a)}var x=function(a){var b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u="sizzle"+1*new Date,v=a.document,w=0,x=0,y=ha(),z=ha(),A=ha(),B=function(a,b){return a===b&&(l=!0),0},C={}.hasOwnProperty,D=[],E=D.pop,F=D.push,G=D.push,H=D.slice,I=function(a,b){for(var c=0,d=a.length;c+~]|"+K+")"+K+"*"),S=new RegExp("="+K+"*([^\\]'\"]*?)"+K+"*\\]","g"),T=new RegExp(N),U=new RegExp("^"+L+"$"),V={ID:new RegExp("^#("+L+")"),CLASS:new RegExp("^\\.("+L+")"),TAG:new RegExp("^("+L+"|[*])"),ATTR:new RegExp("^"+M),PSEUDO:new RegExp("^"+N),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+K+"*(even|odd|(([+-]|)(\\d*)n|)"+K+"*(?:([+-]|)"+K+"*(\\d+)|))"+K+"*\\)|)","i"),bool:new RegExp("^(?:"+J+")$","i"),needsContext:new RegExp("^"+K+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+K+"*((?:-\\d)?\\d*)"+K+"*\\)|)(?=[^-]|$)","i")},W=/^(?:input|select|textarea|button)$/i,X=/^h\d$/i,Y=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,$=/[+~]/,_=new RegExp("\\\\([\\da-f]{1,6}"+K+"?|("+K+")|.)","ig"),aa=function(a,b,c){var d="0x"+b-65536;return d!==d||c?b:d<0?String.fromCharCode(d+65536):String.fromCharCode(d>>10|55296,1023&d|56320)},ba=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ca=function(a,b){return b?"\0"===a?"\ufffd":a.slice(0,-1)+"\\"+a.charCodeAt(a.length-1).toString(16)+" ":"\\"+a},da=function(){m()},ea=ta(function(a){return a.disabled===!0&&("form"in a||"label"in a)},{dir:"parentNode",next:"legend"});try{G.apply(D=H.call(v.childNodes),v.childNodes),D[v.childNodes.length].nodeType}catch(fa){G={apply:D.length?function(a,b){F.apply(a,H.call(b))}:function(a,b){var c=a.length,d=0;while(a[c++]=b[d++]);a.length=c-1}}}function ga(a,b,d,e){var f,h,j,k,l,o,r,s=b&&b.ownerDocument,w=b?b.nodeType:9;if(d=d||[],"string"!=typeof a||!a||1!==w&&9!==w&&11!==w)return d;if(!e&&((b?b.ownerDocument||b:v)!==n&&m(b),b=b||n,p)){if(11!==w&&(l=Z.exec(a)))if(f=l[1]){if(9===w){if(!(j=b.getElementById(f)))return d;if(j.id===f)return d.push(j),d}else if(s&&(j=s.getElementById(f))&&t(b,j)&&j.id===f)return d.push(j),d}else{if(l[2])return G.apply(d,b.getElementsByTagName(a)),d;if((f=l[3])&&c.getElementsByClassName&&b.getElementsByClassName)return G.apply(d,b.getElementsByClassName(f)),d}if(c.qsa&&!A[a+" "]&&(!q||!q.test(a))){if(1!==w)s=b,r=a;else if("object"!==b.nodeName.toLowerCase()){(k=b.getAttribute("id"))?k=k.replace(ba,ca):b.setAttribute("id",k=u),o=g(a),h=o.length;while(h--)o[h]="#"+k+" "+sa(o[h]);r=o.join(","),s=$.test(a)&&qa(b.parentNode)||b}if(r)try{return G.apply(d,s.querySelectorAll(r)),d}catch(x){}finally{k===u&&b.removeAttribute("id")}}}return i(a.replace(P,"$1"),b,d,e)}function ha(){var a=[];function b(c,e){return a.push(c+" ")>d.cacheLength&&delete b[a.shift()],b[c+" "]=e}return b}function ia(a){return a[u]=!0,a}function ja(a){var b=n.createElement("fieldset");try{return!!a(b)}catch(c){return!1}finally{b.parentNode&&b.parentNode.removeChild(b),b=null}}function ka(a,b){var c=a.split("|"),e=c.length;while(e--)d.attrHandle[c[e]]=b}function la(a,b){var c=b&&a,d=c&&1===a.nodeType&&1===b.nodeType&&a.sourceIndex-b.sourceIndex;if(d)return d;if(c)while(c=c.nextSibling)if(c===b)return-1;return a?1:-1}function ma(a){return function(b){var c=b.nodeName.toLowerCase();return"input"===c&&b.type===a}}function na(a){return function(b){var c=b.nodeName.toLowerCase();return("input"===c||"button"===c)&&b.type===a}}function oa(a){return function(b){return"form"in b?b.parentNode&&b.disabled===!1?"label"in b?"label"in b.parentNode?b.parentNode.disabled===a:b.disabled===a:b.isDisabled===a||b.isDisabled!==!a&&ea(b)===a:b.disabled===a:"label"in b&&b.disabled===a}}function pa(a){return ia(function(b){return b=+b,ia(function(c,d){var e,f=a([],c.length,b),g=f.length;while(g--)c[e=f[g]]&&(c[e]=!(d[e]=c[e]))})})}function qa(a){return a&&"undefined"!=typeof a.getElementsByTagName&&a}c=ga.support={},f=ga.isXML=function(a){var b=a&&(a.ownerDocument||a).documentElement;return!!b&&"HTML"!==b.nodeName},m=ga.setDocument=function(a){var b,e,g=a?a.ownerDocument||a:v;return g!==n&&9===g.nodeType&&g.documentElement?(n=g,o=n.documentElement,p=!f(n),v!==n&&(e=n.defaultView)&&e.top!==e&&(e.addEventListener?e.addEventListener("unload",da,!1):e.attachEvent&&e.attachEvent("onunload",da)),c.attributes=ja(function(a){return a.className="i",!a.getAttribute("className")}),c.getElementsByTagName=ja(function(a){return a.appendChild(n.createComment("")),!a.getElementsByTagName("*").length}),c.getElementsByClassName=Y.test(n.getElementsByClassName),c.getById=ja(function(a){return o.appendChild(a).id=u,!n.getElementsByName||!n.getElementsByName(u).length}),c.getById?(d.filter.ID=function(a){var b=a.replace(_,aa);return function(a){return a.getAttribute("id")===b}},d.find.ID=function(a,b){if("undefined"!=typeof b.getElementById&&p){var c=b.getElementById(a);return c?[c]:[]}}):(d.filter.ID=function(a){var b=a.replace(_,aa);return function(a){var c="undefined"!=typeof a.getAttributeNode&&a.getAttributeNode("id");return c&&c.value===b}},d.find.ID=function(a,b){if("undefined"!=typeof b.getElementById&&p){var c,d,e,f=b.getElementById(a);if(f){if(c=f.getAttributeNode("id"),c&&c.value===a)return[f];e=b.getElementsByName(a),d=0;while(f=e[d++])if(c=f.getAttributeNode("id"),c&&c.value===a)return[f]}return[]}}),d.find.TAG=c.getElementsByTagName?function(a,b){return"undefined"!=typeof b.getElementsByTagName?b.getElementsByTagName(a):c.qsa?b.querySelectorAll(a):void 0}:function(a,b){var c,d=[],e=0,f=b.getElementsByTagName(a);if("*"===a){while(c=f[e++])1===c.nodeType&&d.push(c);return d}return f},d.find.CLASS=c.getElementsByClassName&&function(a,b){if("undefined"!=typeof b.getElementsByClassName&&p)return b.getElementsByClassName(a)},r=[],q=[],(c.qsa=Y.test(n.querySelectorAll))&&(ja(function(a){o.appendChild(a).innerHTML="",a.querySelectorAll("[msallowcapture^='']").length&&q.push("[*^$]="+K+"*(?:''|\"\")"),a.querySelectorAll("[selected]").length||q.push("\\["+K+"*(?:value|"+J+")"),a.querySelectorAll("[id~="+u+"-]").length||q.push("~="),a.querySelectorAll(":checked").length||q.push(":checked"),a.querySelectorAll("a#"+u+"+*").length||q.push(".#.+[+~]")}),ja(function(a){a.innerHTML="";var b=n.createElement("input");b.setAttribute("type","hidden"),a.appendChild(b).setAttribute("name","D"),a.querySelectorAll("[name=d]").length&&q.push("name"+K+"*[*^$|!~]?="),2!==a.querySelectorAll(":enabled").length&&q.push(":enabled",":disabled"),o.appendChild(a).disabled=!0,2!==a.querySelectorAll(":disabled").length&&q.push(":enabled",":disabled"),a.querySelectorAll("*,:x"),q.push(",.*:")})),(c.matchesSelector=Y.test(s=o.matches||o.webkitMatchesSelector||o.mozMatchesSelector||o.oMatchesSelector||o.msMatchesSelector))&&ja(function(a){c.disconnectedMatch=s.call(a,"*"),s.call(a,"[s!='']:x"),r.push("!=",N)}),q=q.length&&new RegExp(q.join("|")),r=r.length&&new RegExp(r.join("|")),b=Y.test(o.compareDocumentPosition),t=b||Y.test(o.contains)?function(a,b){var c=9===a.nodeType?a.documentElement:a,d=b&&b.parentNode;return a===d||!(!d||1!==d.nodeType||!(c.contains?c.contains(d):a.compareDocumentPosition&&16&a.compareDocumentPosition(d)))}:function(a,b){if(b)while(b=b.parentNode)if(b===a)return!0;return!1},B=b?function(a,b){if(a===b)return l=!0,0;var d=!a.compareDocumentPosition-!b.compareDocumentPosition;return d?d:(d=(a.ownerDocument||a)===(b.ownerDocument||b)?a.compareDocumentPosition(b):1,1&d||!c.sortDetached&&b.compareDocumentPosition(a)===d?a===n||a.ownerDocument===v&&t(v,a)?-1:b===n||b.ownerDocument===v&&t(v,b)?1:k?I(k,a)-I(k,b):0:4&d?-1:1)}:function(a,b){if(a===b)return l=!0,0;var c,d=0,e=a.parentNode,f=b.parentNode,g=[a],h=[b];if(!e||!f)return a===n?-1:b===n?1:e?-1:f?1:k?I(k,a)-I(k,b):0;if(e===f)return la(a,b);c=a;while(c=c.parentNode)g.unshift(c);c=b;while(c=c.parentNode)h.unshift(c);while(g[d]===h[d])d++;return d?la(g[d],h[d]):g[d]===v?-1:h[d]===v?1:0},n):n},ga.matches=function(a,b){return ga(a,null,null,b)},ga.matchesSelector=function(a,b){if((a.ownerDocument||a)!==n&&m(a),b=b.replace(S,"='$1']"),c.matchesSelector&&p&&!A[b+" "]&&(!r||!r.test(b))&&(!q||!q.test(b)))try{var d=s.call(a,b);if(d||c.disconnectedMatch||a.document&&11!==a.document.nodeType)return d}catch(e){}return ga(b,n,null,[a]).length>0},ga.contains=function(a,b){return(a.ownerDocument||a)!==n&&m(a),t(a,b)},ga.attr=function(a,b){(a.ownerDocument||a)!==n&&m(a);var e=d.attrHandle[b.toLowerCase()],f=e&&C.call(d.attrHandle,b.toLowerCase())?e(a,b,!p):void 0;return void 0!==f?f:c.attributes||!p?a.getAttribute(b):(f=a.getAttributeNode(b))&&f.specified?f.value:null},ga.escape=function(a){return(a+"").replace(ba,ca)},ga.error=function(a){throw new Error("Syntax error, unrecognized expression: "+a)},ga.uniqueSort=function(a){var b,d=[],e=0,f=0;if(l=!c.detectDuplicates,k=!c.sortStable&&a.slice(0),a.sort(B),l){while(b=a[f++])b===a[f]&&(e=d.push(f));while(e--)a.splice(d[e],1)}return k=null,a},e=ga.getText=function(a){var b,c="",d=0,f=a.nodeType;if(f){if(1===f||9===f||11===f){if("string"==typeof a.textContent)return a.textContent;for(a=a.firstChild;a;a=a.nextSibling)c+=e(a)}else if(3===f||4===f)return a.nodeValue}else while(b=a[d++])c+=e(b);return c},d=ga.selectors={cacheLength:50,createPseudo:ia,match:V,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(a){return a[1]=a[1].replace(_,aa),a[3]=(a[3]||a[4]||a[5]||"").replace(_,aa),"~="===a[2]&&(a[3]=" "+a[3]+" "),a.slice(0,4)},CHILD:function(a){return a[1]=a[1].toLowerCase(),"nth"===a[1].slice(0,3)?(a[3]||ga.error(a[0]),a[4]=+(a[4]?a[5]+(a[6]||1):2*("even"===a[3]||"odd"===a[3])),a[5]=+(a[7]+a[8]||"odd"===a[3])):a[3]&&ga.error(a[0]),a},PSEUDO:function(a){var b,c=!a[6]&&a[2];return V.CHILD.test(a[0])?null:(a[3]?a[2]=a[4]||a[5]||"":c&&T.test(c)&&(b=g(c,!0))&&(b=c.indexOf(")",c.length-b)-c.length)&&(a[0]=a[0].slice(0,b),a[2]=c.slice(0,b)),a.slice(0,3))}},filter:{TAG:function(a){var b=a.replace(_,aa).toLowerCase();return"*"===a?function(){return!0}:function(a){return a.nodeName&&a.nodeName.toLowerCase()===b}},CLASS:function(a){var b=y[a+" "];return b||(b=new RegExp("(^|"+K+")"+a+"("+K+"|$)"))&&y(a,function(a){return b.test("string"==typeof a.className&&a.className||"undefined"!=typeof a.getAttribute&&a.getAttribute("class")||"")})},ATTR:function(a,b,c){return function(d){var e=ga.attr(d,a);return null==e?"!="===b:!b||(e+="","="===b?e===c:"!="===b?e!==c:"^="===b?c&&0===e.indexOf(c):"*="===b?c&&e.indexOf(c)>-1:"$="===b?c&&e.slice(-c.length)===c:"~="===b?(" "+e.replace(O," ")+" ").indexOf(c)>-1:"|="===b&&(e===c||e.slice(0,c.length+1)===c+"-"))}},CHILD:function(a,b,c,d,e){var f="nth"!==a.slice(0,3),g="last"!==a.slice(-4),h="of-type"===b;return 1===d&&0===e?function(a){return!!a.parentNode}:function(b,c,i){var j,k,l,m,n,o,p=f!==g?"nextSibling":"previousSibling",q=b.parentNode,r=h&&b.nodeName.toLowerCase(),s=!i&&!h,t=!1;if(q){if(f){while(p){m=b;while(m=m[p])if(h?m.nodeName.toLowerCase()===r:1===m.nodeType)return!1;o=p="only"===a&&!o&&"nextSibling"}return!0}if(o=[g?q.firstChild:q.lastChild],g&&s){m=q,l=m[u]||(m[u]={}),k=l[m.uniqueID]||(l[m.uniqueID]={}),j=k[a]||[],n=j[0]===w&&j[1],t=n&&j[2],m=n&&q.childNodes[n];while(m=++n&&m&&m[p]||(t=n=0)||o.pop())if(1===m.nodeType&&++t&&m===b){k[a]=[w,n,t];break}}else if(s&&(m=b,l=m[u]||(m[u]={}),k=l[m.uniqueID]||(l[m.uniqueID]={}),j=k[a]||[],n=j[0]===w&&j[1],t=n),t===!1)while(m=++n&&m&&m[p]||(t=n=0)||o.pop())if((h?m.nodeName.toLowerCase()===r:1===m.nodeType)&&++t&&(s&&(l=m[u]||(m[u]={}),k=l[m.uniqueID]||(l[m.uniqueID]={}),k[a]=[w,t]),m===b))break;return t-=e,t===d||t%d===0&&t/d>=0}}},PSEUDO:function(a,b){var c,e=d.pseudos[a]||d.setFilters[a.toLowerCase()]||ga.error("unsupported pseudo: "+a);return e[u]?e(b):e.length>1?(c=[a,a,"",b],d.setFilters.hasOwnProperty(a.toLowerCase())?ia(function(a,c){var d,f=e(a,b),g=f.length;while(g--)d=I(a,f[g]),a[d]=!(c[d]=f[g])}):function(a){return e(a,0,c)}):e}},pseudos:{not:ia(function(a){var b=[],c=[],d=h(a.replace(P,"$1"));return d[u]?ia(function(a,b,c,e){var f,g=d(a,null,e,[]),h=a.length;while(h--)(f=g[h])&&(a[h]=!(b[h]=f))}):function(a,e,f){return b[0]=a,d(b,null,f,c),b[0]=null,!c.pop()}}),has:ia(function(a){return function(b){return ga(a,b).length>0}}),contains:ia(function(a){return a=a.replace(_,aa),function(b){return(b.textContent||b.innerText||e(b)).indexOf(a)>-1}}),lang:ia(function(a){return U.test(a||"")||ga.error("unsupported lang: "+a),a=a.replace(_,aa).toLowerCase(),function(b){var c;do if(c=p?b.lang:b.getAttribute("xml:lang")||b.getAttribute("lang"))return c=c.toLowerCase(),c===a||0===c.indexOf(a+"-");while((b=b.parentNode)&&1===b.nodeType);return!1}}),target:function(b){var c=a.location&&a.location.hash;return c&&c.slice(1)===b.id},root:function(a){return a===o},focus:function(a){return a===n.activeElement&&(!n.hasFocus||n.hasFocus())&&!!(a.type||a.href||~a.tabIndex)},enabled:oa(!1),disabled:oa(!0),checked:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&!!a.checked||"option"===b&&!!a.selected},selected:function(a){return a.parentNode&&a.parentNode.selectedIndex,a.selected===!0},empty:function(a){for(a=a.firstChild;a;a=a.nextSibling)if(a.nodeType<6)return!1;return!0},parent:function(a){return!d.pseudos.empty(a)},header:function(a){return X.test(a.nodeName)},input:function(a){return W.test(a.nodeName)},button:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&"button"===a.type||"button"===b},text:function(a){var b;return"input"===a.nodeName.toLowerCase()&&"text"===a.type&&(null==(b=a.getAttribute("type"))||"text"===b.toLowerCase())},first:pa(function(){return[0]}),last:pa(function(a,b){return[b-1]}),eq:pa(function(a,b,c){return[c<0?c+b:c]}),even:pa(function(a,b){for(var c=0;c=0;)a.push(d);return a}),gt:pa(function(a,b,c){for(var d=c<0?c+b:c;++d1?function(b,c,d){var e=a.length;while(e--)if(!a[e](b,c,d))return!1;return!0}:a[0]}function va(a,b,c){for(var d=0,e=b.length;d-1&&(f[j]=!(g[j]=l))}}else r=wa(r===g?r.splice(o,r.length):r),e?e(null,g,r,i):G.apply(g,r)})}function ya(a){for(var b,c,e,f=a.length,g=d.relative[a[0].type],h=g||d.relative[" "],i=g?1:0,k=ta(function(a){return a===b},h,!0),l=ta(function(a){return I(b,a)>-1},h,!0),m=[function(a,c,d){var e=!g&&(d||c!==j)||((b=c).nodeType?k(a,c,d):l(a,c,d));return b=null,e}];i1&&ua(m),i>1&&sa(a.slice(0,i-1).concat({value:" "===a[i-2].type?"*":""})).replace(P,"$1"),c,i0,e=a.length>0,f=function(f,g,h,i,k){var l,o,q,r=0,s="0",t=f&&[],u=[],v=j,x=f||e&&d.find.TAG("*",k),y=w+=null==v?1:Math.random()||.1,z=x.length;for(k&&(j=g===n||g||k);s!==z&&null!=(l=x[s]);s++){if(e&&l){o=0,g||l.ownerDocument===n||(m(l),h=!p);while(q=a[o++])if(q(l,g||n,h)){i.push(l);break}k&&(w=y)}c&&((l=!q&&l)&&r--,f&&t.push(l))}if(r+=s,c&&s!==r){o=0;while(q=b[o++])q(t,u,g,h);if(f){if(r>0)while(s--)t[s]||u[s]||(u[s]=E.call(i));u=wa(u)}G.apply(i,u),k&&!f&&u.length>0&&r+b.length>1&&ga.uniqueSort(i)}return k&&(w=y,j=v),t};return c?ia(f):f}return h=ga.compile=function(a,b){var c,d=[],e=[],f=A[a+" "];if(!f){b||(b=g(a)),c=b.length;while(c--)f=ya(b[c]),f[u]?d.push(f):e.push(f);f=A(a,za(e,d)),f.selector=a}return f},i=ga.select=function(a,b,c,e){var f,i,j,k,l,m="function"==typeof a&&a,n=!e&&g(a=m.selector||a);if(c=c||[],1===n.length){if(i=n[0]=n[0].slice(0),i.length>2&&"ID"===(j=i[0]).type&&9===b.nodeType&&p&&d.relative[i[1].type]){if(b=(d.find.ID(j.matches[0].replace(_,aa),b)||[])[0],!b)return c;m&&(b=b.parentNode),a=a.slice(i.shift().value.length)}f=V.needsContext.test(a)?0:i.length;while(f--){if(j=i[f],d.relative[k=j.type])break;if((l=d.find[k])&&(e=l(j.matches[0].replace(_,aa),$.test(i[0].type)&&qa(b.parentNode)||b))){if(i.splice(f,1),a=e.length&&sa(i),!a)return G.apply(c,e),c;break}}}return(m||h(a,n))(e,b,!p,c,!b||$.test(a)&&qa(b.parentNode)||b),c},c.sortStable=u.split("").sort(B).join("")===u,c.detectDuplicates=!!l,m(),c.sortDetached=ja(function(a){return 1&a.compareDocumentPosition(n.createElement("fieldset"))}),ja(function(a){return a.innerHTML="","#"===a.firstChild.getAttribute("href")})||ka("type|href|height|width",function(a,b,c){if(!c)return a.getAttribute(b,"type"===b.toLowerCase()?1:2)}),c.attributes&&ja(function(a){return a.innerHTML="",a.firstChild.setAttribute("value",""),""===a.firstChild.getAttribute("value")})||ka("value",function(a,b,c){if(!c&&"input"===a.nodeName.toLowerCase())return a.defaultValue}),ja(function(a){return null==a.getAttribute("disabled")})||ka(J,function(a,b,c){var d;if(!c)return a[b]===!0?b.toLowerCase():(d=a.getAttributeNode(b))&&d.specified?d.value:null}),ga}(a);r.find=x,r.expr=x.selectors,r.expr[":"]=r.expr.pseudos,r.uniqueSort=r.unique=x.uniqueSort,r.text=x.getText,r.isXMLDoc=x.isXML,r.contains=x.contains,r.escapeSelector=x.escape;var y=function(a,b,c){var d=[],e=void 0!==c;while((a=a[b])&&9!==a.nodeType)if(1===a.nodeType){if(e&&r(a).is(c))break;d.push(a)}return d},z=function(a,b){for(var c=[];a;a=a.nextSibling)1===a.nodeType&&a!==b&&c.push(a);return c},A=r.expr.match.needsContext,B=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i,C=/^.[^:#\[\.,]*$/;function D(a,b,c){return r.isFunction(b)?r.grep(a,function(a,d){return!!b.call(a,d,a)!==c}):b.nodeType?r.grep(a,function(a){return a===b!==c}):"string"!=typeof b?r.grep(a,function(a){return i.call(b,a)>-1!==c}):C.test(b)?r.filter(b,a,c):(b=r.filter(b,a),r.grep(a,function(a){return i.call(b,a)>-1!==c&&1===a.nodeType}))}r.filter=function(a,b,c){var d=b[0];return c&&(a=":not("+a+")"),1===b.length&&1===d.nodeType?r.find.matchesSelector(d,a)?[d]:[]:r.find.matches(a,r.grep(b,function(a){return 1===a.nodeType}))},r.fn.extend({find:function(a){var b,c,d=this.length,e=this;if("string"!=typeof a)return this.pushStack(r(a).filter(function(){for(b=0;b1?r.uniqueSort(c):c},filter:function(a){return this.pushStack(D(this,a||[],!1))},not:function(a){return this.pushStack(D(this,a||[],!0))},is:function(a){return!!D(this,"string"==typeof a&&A.test(a)?r(a):a||[],!1).length}});var E,F=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/,G=r.fn.init=function(a,b,c){var e,f;if(!a)return this;if(c=c||E,"string"==typeof a){if(e="<"===a[0]&&">"===a[a.length-1]&&a.length>=3?[null,a,null]:F.exec(a),!e||!e[1]&&b)return!b||b.jquery?(b||c).find(a):this.constructor(b).find(a);if(e[1]){if(b=b instanceof r?b[0]:b,r.merge(this,r.parseHTML(e[1],b&&b.nodeType?b.ownerDocument||b:d,!0)),B.test(e[1])&&r.isPlainObject(b))for(e in b)r.isFunction(this[e])?this[e](b[e]):this.attr(e,b[e]);return this}return f=d.getElementById(e[2]),f&&(this[0]=f,this.length=1),this}return a.nodeType?(this[0]=a,this.length=1,this):r.isFunction(a)?void 0!==c.ready?c.ready(a):a(r):r.makeArray(a,this)};G.prototype=r.fn,E=r(d);var H=/^(?:parents|prev(?:Until|All))/,I={children:!0,contents:!0,next:!0,prev:!0};r.fn.extend({has:function(a){var b=r(a,this),c=b.length;return this.filter(function(){for(var a=0;a-1:1===c.nodeType&&r.find.matchesSelector(c,a))){f.push(c);break}return this.pushStack(f.length>1?r.uniqueSort(f):f)},index:function(a){return a?"string"==typeof a?i.call(r(a),this[0]):i.call(this,a.jquery?a[0]:a):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(a,b){return this.pushStack(r.uniqueSort(r.merge(this.get(),r(a,b))))},addBack:function(a){return this.add(null==a?this.prevObject:this.prevObject.filter(a))}});function J(a,b){while((a=a[b])&&1!==a.nodeType);return a}r.each({parent:function(a){var b=a.parentNode;return b&&11!==b.nodeType?b:null},parents:function(a){return y(a,"parentNode")},parentsUntil:function(a,b,c){return y(a,"parentNode",c)},next:function(a){return J(a,"nextSibling")},prev:function(a){return J(a,"previousSibling")},nextAll:function(a){return y(a,"nextSibling")},prevAll:function(a){return y(a,"previousSibling")},nextUntil:function(a,b,c){return y(a,"nextSibling",c)},prevUntil:function(a,b,c){return y(a,"previousSibling",c)},siblings:function(a){return z((a.parentNode||{}).firstChild,a)},children:function(a){return z(a.firstChild)},contents:function(a){return a.contentDocument||r.merge([],a.childNodes)}},function(a,b){r.fn[a]=function(c,d){var e=r.map(this,b,c);return"Until"!==a.slice(-5)&&(d=c),d&&"string"==typeof d&&(e=r.filter(d,e)),this.length>1&&(I[a]||r.uniqueSort(e),H.test(a)&&e.reverse()),this.pushStack(e)}});var K=/[^\x20\t\r\n\f]+/g;function L(a){var b={};return r.each(a.match(K)||[],function(a,c){b[c]=!0}),b}r.Callbacks=function(a){a="string"==typeof a?L(a):r.extend({},a);var b,c,d,e,f=[],g=[],h=-1,i=function(){for(e=a.once,d=b=!0;g.length;h=-1){c=g.shift();while(++h-1)f.splice(c,1),c<=h&&h--}),this},has:function(a){return a?r.inArray(a,f)>-1:f.length>0},empty:function(){return f&&(f=[]),this},disable:function(){return e=g=[],f=c="",this},disabled:function(){return!f},lock:function(){return e=g=[],c||b||(f=c=""),this},locked:function(){return!!e},fireWith:function(a,c){return e||(c=c||[],c=[a,c.slice?c.slice():c],g.push(c),b||i()),this},fire:function(){return j.fireWith(this,arguments),this},fired:function(){return!!d}};return j};function M(a){return a}function N(a){throw a}function O(a,b,c){var d;try{a&&r.isFunction(d=a.promise)?d.call(a).done(b).fail(c):a&&r.isFunction(d=a.then)?d.call(a,b,c):b.call(void 0,a)}catch(a){c.call(void 0,a)}}r.extend({Deferred:function(b){var c=[["notify","progress",r.Callbacks("memory"),r.Callbacks("memory"),2],["resolve","done",r.Callbacks("once memory"),r.Callbacks("once memory"),0,"resolved"],["reject","fail",r.Callbacks("once memory"),r.Callbacks("once memory"),1,"rejected"]],d="pending",e={state:function(){return d},always:function(){return f.done(arguments).fail(arguments),this},"catch":function(a){return e.then(null,a)},pipe:function(){var a=arguments;return r.Deferred(function(b){r.each(c,function(c,d){var e=r.isFunction(a[d[4]])&&a[d[4]];f[d[1]](function(){var a=e&&e.apply(this,arguments);a&&r.isFunction(a.promise)?a.promise().progress(b.notify).done(b.resolve).fail(b.reject):b[d[0]+"With"](this,e?[a]:arguments)})}),a=null}).promise()},then:function(b,d,e){var f=0;function g(b,c,d,e){return function(){var h=this,i=arguments,j=function(){var a,j;if(!(b=f&&(d!==N&&(h=void 0,i=[a]),c.rejectWith(h,i))}};b?k():(r.Deferred.getStackHook&&(k.stackTrace=r.Deferred.getStackHook()),a.setTimeout(k))}}return r.Deferred(function(a){c[0][3].add(g(0,a,r.isFunction(e)?e:M,a.notifyWith)),c[1][3].add(g(0,a,r.isFunction(b)?b:M)),c[2][3].add(g(0,a,r.isFunction(d)?d:N))}).promise()},promise:function(a){return null!=a?r.extend(a,e):e}},f={};return r.each(c,function(a,b){var g=b[2],h=b[5];e[b[1]]=g.add,h&&g.add(function(){d=h},c[3-a][2].disable,c[0][2].lock),g.add(b[3].fire),f[b[0]]=function(){return f[b[0]+"With"](this===f?void 0:this,arguments),this},f[b[0]+"With"]=g.fireWith}),e.promise(f),b&&b.call(f,f),f},when:function(a){var b=arguments.length,c=b,d=Array(c),e=f.call(arguments),g=r.Deferred(),h=function(a){return function(c){d[a]=this,e[a]=arguments.length>1?f.call(arguments):c,--b||g.resolveWith(d,e)}};if(b<=1&&(O(a,g.done(h(c)).resolve,g.reject),"pending"===g.state()||r.isFunction(e[c]&&e[c].then)))return g.then();while(c--)O(e[c],h(c),g.reject);return g.promise()}});var P=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;r.Deferred.exceptionHook=function(b,c){a.console&&a.console.warn&&b&&P.test(b.name)&&a.console.warn("jQuery.Deferred exception: "+b.message,b.stack,c)},r.readyException=function(b){a.setTimeout(function(){throw b})};var Q=r.Deferred();r.fn.ready=function(a){return Q.then(a)["catch"](function(a){r.readyException(a)}),this},r.extend({isReady:!1,readyWait:1,holdReady:function(a){a?r.readyWait++:r.ready(!0)},ready:function(a){(a===!0?--r.readyWait:r.isReady)||(r.isReady=!0,a!==!0&&--r.readyWait>0||Q.resolveWith(d,[r]))}}),r.ready.then=Q.then;function R(){d.removeEventListener("DOMContentLoaded",R), +a.removeEventListener("load",R),r.ready()}"complete"===d.readyState||"loading"!==d.readyState&&!d.documentElement.doScroll?a.setTimeout(r.ready):(d.addEventListener("DOMContentLoaded",R),a.addEventListener("load",R));var S=function(a,b,c,d,e,f,g){var h=0,i=a.length,j=null==c;if("object"===r.type(c)){e=!0;for(h in c)S(a,b,h,c[h],!0,f,g)}else if(void 0!==d&&(e=!0,r.isFunction(d)||(g=!0),j&&(g?(b.call(a,d),b=null):(j=b,b=function(a,b,c){return j.call(r(a),c)})),b))for(;h1,null,!0)},removeData:function(a){return this.each(function(){W.remove(this,a)})}}),r.extend({queue:function(a,b,c){var d;if(a)return b=(b||"fx")+"queue",d=V.get(a,b),c&&(!d||r.isArray(c)?d=V.access(a,b,r.makeArray(c)):d.push(c)),d||[]},dequeue:function(a,b){b=b||"fx";var c=r.queue(a,b),d=c.length,e=c.shift(),f=r._queueHooks(a,b),g=function(){r.dequeue(a,b)};"inprogress"===e&&(e=c.shift(),d--),e&&("fx"===b&&c.unshift("inprogress"),delete f.stop,e.call(a,g,f)),!d&&f&&f.empty.fire()},_queueHooks:function(a,b){var c=b+"queueHooks";return V.get(a,c)||V.access(a,c,{empty:r.Callbacks("once memory").add(function(){V.remove(a,[b+"queue",c])})})}}),r.fn.extend({queue:function(a,b){var c=2;return"string"!=typeof a&&(b=a,a="fx",c--),arguments.length\x20\t\r\n\f]+)/i,ka=/^$|\/(?:java|ecma)script/i,la={option:[1,""],thead:[1,"","
"],col:[2,"","
"],tr:[2,"","
"],td:[3,"","
"],_default:[0,"",""]};la.optgroup=la.option,la.tbody=la.tfoot=la.colgroup=la.caption=la.thead,la.th=la.td;function ma(a,b){var c;return c="undefined"!=typeof a.getElementsByTagName?a.getElementsByTagName(b||"*"):"undefined"!=typeof a.querySelectorAll?a.querySelectorAll(b||"*"):[],void 0===b||b&&r.nodeName(a,b)?r.merge([a],c):c}function na(a,b){for(var c=0,d=a.length;c-1)e&&e.push(f);else if(j=r.contains(f.ownerDocument,f),g=ma(l.appendChild(f),"script"),j&&na(g),c){k=0;while(f=g[k++])ka.test(f.type||"")&&c.push(f)}return l}!function(){var a=d.createDocumentFragment(),b=a.appendChild(d.createElement("div")),c=d.createElement("input");c.setAttribute("type","radio"),c.setAttribute("checked","checked"),c.setAttribute("name","t"),b.appendChild(c),o.checkClone=b.cloneNode(!0).cloneNode(!0).lastChild.checked,b.innerHTML="",o.noCloneChecked=!!b.cloneNode(!0).lastChild.defaultValue}();var qa=d.documentElement,ra=/^key/,sa=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,ta=/^([^.]*)(?:\.(.+)|)/;function ua(){return!0}function va(){return!1}function wa(){try{return d.activeElement}catch(a){}}function xa(a,b,c,d,e,f){var g,h;if("object"==typeof b){"string"!=typeof c&&(d=d||c,c=void 0);for(h in b)xa(a,h,c,d,b[h],f);return a}if(null==d&&null==e?(e=c,d=c=void 0):null==e&&("string"==typeof c?(e=d,d=void 0):(e=d,d=c,c=void 0)),e===!1)e=va;else if(!e)return a;return 1===f&&(g=e,e=function(a){return r().off(a),g.apply(this,arguments)},e.guid=g.guid||(g.guid=r.guid++)),a.each(function(){r.event.add(this,b,e,d,c)})}r.event={global:{},add:function(a,b,c,d,e){var f,g,h,i,j,k,l,m,n,o,p,q=V.get(a);if(q){c.handler&&(f=c,c=f.handler,e=f.selector),e&&r.find.matchesSelector(qa,e),c.guid||(c.guid=r.guid++),(i=q.events)||(i=q.events={}),(g=q.handle)||(g=q.handle=function(b){return"undefined"!=typeof r&&r.event.triggered!==b.type?r.event.dispatch.apply(a,arguments):void 0}),b=(b||"").match(K)||[""],j=b.length;while(j--)h=ta.exec(b[j])||[],n=p=h[1],o=(h[2]||"").split(".").sort(),n&&(l=r.event.special[n]||{},n=(e?l.delegateType:l.bindType)||n,l=r.event.special[n]||{},k=r.extend({type:n,origType:p,data:d,handler:c,guid:c.guid,selector:e,needsContext:e&&r.expr.match.needsContext.test(e),namespace:o.join(".")},f),(m=i[n])||(m=i[n]=[],m.delegateCount=0,l.setup&&l.setup.call(a,d,o,g)!==!1||a.addEventListener&&a.addEventListener(n,g)),l.add&&(l.add.call(a,k),k.handler.guid||(k.handler.guid=c.guid)),e?m.splice(m.delegateCount++,0,k):m.push(k),r.event.global[n]=!0)}},remove:function(a,b,c,d,e){var f,g,h,i,j,k,l,m,n,o,p,q=V.hasData(a)&&V.get(a);if(q&&(i=q.events)){b=(b||"").match(K)||[""],j=b.length;while(j--)if(h=ta.exec(b[j])||[],n=p=h[1],o=(h[2]||"").split(".").sort(),n){l=r.event.special[n]||{},n=(d?l.delegateType:l.bindType)||n,m=i[n]||[],h=h[2]&&new RegExp("(^|\\.)"+o.join("\\.(?:.*\\.|)")+"(\\.|$)"),g=f=m.length;while(f--)k=m[f],!e&&p!==k.origType||c&&c.guid!==k.guid||h&&!h.test(k.namespace)||d&&d!==k.selector&&("**"!==d||!k.selector)||(m.splice(f,1),k.selector&&m.delegateCount--,l.remove&&l.remove.call(a,k));g&&!m.length&&(l.teardown&&l.teardown.call(a,o,q.handle)!==!1||r.removeEvent(a,n,q.handle),delete i[n])}else for(n in i)r.event.remove(a,n+b[j],c,d,!0);r.isEmptyObject(i)&&V.remove(a,"handle events")}},dispatch:function(a){var b=r.event.fix(a),c,d,e,f,g,h,i=new Array(arguments.length),j=(V.get(this,"events")||{})[b.type]||[],k=r.event.special[b.type]||{};for(i[0]=b,c=1;c=1))for(;j!==this;j=j.parentNode||this)if(1===j.nodeType&&("click"!==a.type||j.disabled!==!0)){for(f=[],g={},c=0;c-1:r.find(e,this,null,[j]).length),g[e]&&f.push(d);f.length&&h.push({elem:j,handlers:f})}return j=this,i\x20\t\r\n\f]*)[^>]*)\/>/gi,za=/\s*$/g;function Da(a,b){return r.nodeName(a,"table")&&r.nodeName(11!==b.nodeType?b:b.firstChild,"tr")?a.getElementsByTagName("tbody")[0]||a:a}function Ea(a){return a.type=(null!==a.getAttribute("type"))+"/"+a.type,a}function Fa(a){var b=Ba.exec(a.type);return b?a.type=b[1]:a.removeAttribute("type"),a}function Ga(a,b){var c,d,e,f,g,h,i,j;if(1===b.nodeType){if(V.hasData(a)&&(f=V.access(a),g=V.set(b,f),j=f.events)){delete g.handle,g.events={};for(e in j)for(c=0,d=j[e].length;c1&&"string"==typeof q&&!o.checkClone&&Aa.test(q))return a.each(function(e){var f=a.eq(e);s&&(b[0]=q.call(this,e,f.html())),Ia(f,b,c,d)});if(m&&(e=pa(b,a[0].ownerDocument,!1,a,d),f=e.firstChild,1===e.childNodes.length&&(e=f),f||d)){for(h=r.map(ma(e,"script"),Ea),i=h.length;l")},clone:function(a,b,c){var d,e,f,g,h=a.cloneNode(!0),i=r.contains(a.ownerDocument,a);if(!(o.noCloneChecked||1!==a.nodeType&&11!==a.nodeType||r.isXMLDoc(a)))for(g=ma(h),f=ma(a),d=0,e=f.length;d0&&na(g,!i&&ma(a,"script")),h},cleanData:function(a){for(var b,c,d,e=r.event.special,f=0;void 0!==(c=a[f]);f++)if(T(c)){if(b=c[V.expando]){if(b.events)for(d in b.events)e[d]?r.event.remove(c,d):r.removeEvent(c,d,b.handle);c[V.expando]=void 0}c[W.expando]&&(c[W.expando]=void 0)}}}),r.fn.extend({detach:function(a){return Ja(this,a,!0)},remove:function(a){return Ja(this,a)},text:function(a){return S(this,function(a){return void 0===a?r.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=a)})},null,a,arguments.length)},append:function(){return Ia(this,arguments,function(a){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var b=Da(this,a);b.appendChild(a)}})},prepend:function(){return Ia(this,arguments,function(a){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var b=Da(this,a);b.insertBefore(a,b.firstChild)}})},before:function(){return Ia(this,arguments,function(a){this.parentNode&&this.parentNode.insertBefore(a,this)})},after:function(){return Ia(this,arguments,function(a){this.parentNode&&this.parentNode.insertBefore(a,this.nextSibling)})},empty:function(){for(var a,b=0;null!=(a=this[b]);b++)1===a.nodeType&&(r.cleanData(ma(a,!1)),a.textContent="");return this},clone:function(a,b){return a=null!=a&&a,b=null==b?a:b,this.map(function(){return r.clone(this,a,b)})},html:function(a){return S(this,function(a){var b=this[0]||{},c=0,d=this.length;if(void 0===a&&1===b.nodeType)return b.innerHTML;if("string"==typeof a&&!za.test(a)&&!la[(ja.exec(a)||["",""])[1].toLowerCase()]){a=r.htmlPrefilter(a);try{for(;c1)}});function Ya(a,b,c,d,e){return new Ya.prototype.init(a,b,c,d,e)}r.Tween=Ya,Ya.prototype={constructor:Ya,init:function(a,b,c,d,e,f){this.elem=a,this.prop=c,this.easing=e||r.easing._default,this.options=b,this.start=this.now=this.cur(),this.end=d,this.unit=f||(r.cssNumber[c]?"":"px")},cur:function(){var a=Ya.propHooks[this.prop];return a&&a.get?a.get(this):Ya.propHooks._default.get(this)},run:function(a){var b,c=Ya.propHooks[this.prop];return this.options.duration?this.pos=b=r.easing[this.easing](a,this.options.duration*a,0,1,this.options.duration):this.pos=b=a,this.now=(this.end-this.start)*b+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),c&&c.set?c.set(this):Ya.propHooks._default.set(this),this}},Ya.prototype.init.prototype=Ya.prototype,Ya.propHooks={_default:{get:function(a){var b;return 1!==a.elem.nodeType||null!=a.elem[a.prop]&&null==a.elem.style[a.prop]?a.elem[a.prop]:(b=r.css(a.elem,a.prop,""),b&&"auto"!==b?b:0)},set:function(a){r.fx.step[a.prop]?r.fx.step[a.prop](a):1!==a.elem.nodeType||null==a.elem.style[r.cssProps[a.prop]]&&!r.cssHooks[a.prop]?a.elem[a.prop]=a.now:r.style(a.elem,a.prop,a.now+a.unit)}}},Ya.propHooks.scrollTop=Ya.propHooks.scrollLeft={set:function(a){a.elem.nodeType&&a.elem.parentNode&&(a.elem[a.prop]=a.now)}},r.easing={linear:function(a){return a},swing:function(a){return.5-Math.cos(a*Math.PI)/2},_default:"swing"},r.fx=Ya.prototype.init,r.fx.step={};var Za,$a,_a=/^(?:toggle|show|hide)$/,ab=/queueHooks$/;function bb(){$a&&(a.requestAnimationFrame(bb),r.fx.tick())}function cb(){return a.setTimeout(function(){Za=void 0}),Za=r.now()}function db(a,b){var c,d=0,e={height:a};for(b=b?1:0;d<4;d+=2-b)c=ba[d],e["margin"+c]=e["padding"+c]=a;return b&&(e.opacity=e.width=a),e}function eb(a,b,c){for(var d,e=(hb.tweeners[b]||[]).concat(hb.tweeners["*"]),f=0,g=e.length;f1)},removeAttr:function(a){return this.each(function(){r.removeAttr(this,a)})}}),r.extend({attr:function(a,b,c){var d,e,f=a.nodeType;if(3!==f&&8!==f&&2!==f)return"undefined"==typeof a.getAttribute?r.prop(a,b,c):(1===f&&r.isXMLDoc(a)||(e=r.attrHooks[b.toLowerCase()]||(r.expr.match.bool.test(b)?ib:void 0)), +void 0!==c?null===c?void r.removeAttr(a,b):e&&"set"in e&&void 0!==(d=e.set(a,c,b))?d:(a.setAttribute(b,c+""),c):e&&"get"in e&&null!==(d=e.get(a,b))?d:(d=r.find.attr(a,b),null==d?void 0:d))},attrHooks:{type:{set:function(a,b){if(!o.radioValue&&"radio"===b&&r.nodeName(a,"input")){var c=a.value;return a.setAttribute("type",b),c&&(a.value=c),b}}}},removeAttr:function(a,b){var c,d=0,e=b&&b.match(K);if(e&&1===a.nodeType)while(c=e[d++])a.removeAttribute(c)}}),ib={set:function(a,b,c){return b===!1?r.removeAttr(a,c):a.setAttribute(c,c),c}},r.each(r.expr.match.bool.source.match(/\w+/g),function(a,b){var c=jb[b]||r.find.attr;jb[b]=function(a,b,d){var e,f,g=b.toLowerCase();return d||(f=jb[g],jb[g]=e,e=null!=c(a,b,d)?g:null,jb[g]=f),e}});var kb=/^(?:input|select|textarea|button)$/i,lb=/^(?:a|area)$/i;r.fn.extend({prop:function(a,b){return S(this,r.prop,a,b,arguments.length>1)},removeProp:function(a){return this.each(function(){delete this[r.propFix[a]||a]})}}),r.extend({prop:function(a,b,c){var d,e,f=a.nodeType;if(3!==f&&8!==f&&2!==f)return 1===f&&r.isXMLDoc(a)||(b=r.propFix[b]||b,e=r.propHooks[b]),void 0!==c?e&&"set"in e&&void 0!==(d=e.set(a,c,b))?d:a[b]=c:e&&"get"in e&&null!==(d=e.get(a,b))?d:a[b]},propHooks:{tabIndex:{get:function(a){var b=r.find.attr(a,"tabindex");return b?parseInt(b,10):kb.test(a.nodeName)||lb.test(a.nodeName)&&a.href?0:-1}}},propFix:{"for":"htmlFor","class":"className"}}),o.optSelected||(r.propHooks.selected={get:function(a){var b=a.parentNode;return b&&b.parentNode&&b.parentNode.selectedIndex,null},set:function(a){var b=a.parentNode;b&&(b.selectedIndex,b.parentNode&&b.parentNode.selectedIndex)}}),r.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){r.propFix[this.toLowerCase()]=this});function mb(a){var b=a.match(K)||[];return b.join(" ")}function nb(a){return a.getAttribute&&a.getAttribute("class")||""}r.fn.extend({addClass:function(a){var b,c,d,e,f,g,h,i=0;if(r.isFunction(a))return this.each(function(b){r(this).addClass(a.call(this,b,nb(this)))});if("string"==typeof a&&a){b=a.match(K)||[];while(c=this[i++])if(e=nb(c),d=1===c.nodeType&&" "+mb(e)+" "){g=0;while(f=b[g++])d.indexOf(" "+f+" ")<0&&(d+=f+" ");h=mb(d),e!==h&&c.setAttribute("class",h)}}return this},removeClass:function(a){var b,c,d,e,f,g,h,i=0;if(r.isFunction(a))return this.each(function(b){r(this).removeClass(a.call(this,b,nb(this)))});if(!arguments.length)return this.attr("class","");if("string"==typeof a&&a){b=a.match(K)||[];while(c=this[i++])if(e=nb(c),d=1===c.nodeType&&" "+mb(e)+" "){g=0;while(f=b[g++])while(d.indexOf(" "+f+" ")>-1)d=d.replace(" "+f+" "," ");h=mb(d),e!==h&&c.setAttribute("class",h)}}return this},toggleClass:function(a,b){var c=typeof a;return"boolean"==typeof b&&"string"===c?b?this.addClass(a):this.removeClass(a):r.isFunction(a)?this.each(function(c){r(this).toggleClass(a.call(this,c,nb(this),b),b)}):this.each(function(){var b,d,e,f;if("string"===c){d=0,e=r(this),f=a.match(K)||[];while(b=f[d++])e.hasClass(b)?e.removeClass(b):e.addClass(b)}else void 0!==a&&"boolean"!==c||(b=nb(this),b&&V.set(this,"__className__",b),this.setAttribute&&this.setAttribute("class",b||a===!1?"":V.get(this,"__className__")||""))})},hasClass:function(a){var b,c,d=0;b=" "+a+" ";while(c=this[d++])if(1===c.nodeType&&(" "+mb(nb(c))+" ").indexOf(b)>-1)return!0;return!1}});var ob=/\r/g;r.fn.extend({val:function(a){var b,c,d,e=this[0];{if(arguments.length)return d=r.isFunction(a),this.each(function(c){var e;1===this.nodeType&&(e=d?a.call(this,c,r(this).val()):a,null==e?e="":"number"==typeof e?e+="":r.isArray(e)&&(e=r.map(e,function(a){return null==a?"":a+""})),b=r.valHooks[this.type]||r.valHooks[this.nodeName.toLowerCase()],b&&"set"in b&&void 0!==b.set(this,e,"value")||(this.value=e))});if(e)return b=r.valHooks[e.type]||r.valHooks[e.nodeName.toLowerCase()],b&&"get"in b&&void 0!==(c=b.get(e,"value"))?c:(c=e.value,"string"==typeof c?c.replace(ob,""):null==c?"":c)}}}),r.extend({valHooks:{option:{get:function(a){var b=r.find.attr(a,"value");return null!=b?b:mb(r.text(a))}},select:{get:function(a){var b,c,d,e=a.options,f=a.selectedIndex,g="select-one"===a.type,h=g?null:[],i=g?f+1:e.length;for(d=f<0?i:g?f:0;d-1)&&(c=!0);return c||(a.selectedIndex=-1),f}}}}),r.each(["radio","checkbox"],function(){r.valHooks[this]={set:function(a,b){if(r.isArray(b))return a.checked=r.inArray(r(a).val(),b)>-1}},o.checkOn||(r.valHooks[this].get=function(a){return null===a.getAttribute("value")?"on":a.value})});var pb=/^(?:focusinfocus|focusoutblur)$/;r.extend(r.event,{trigger:function(b,c,e,f){var g,h,i,j,k,m,n,o=[e||d],p=l.call(b,"type")?b.type:b,q=l.call(b,"namespace")?b.namespace.split("."):[];if(h=i=e=e||d,3!==e.nodeType&&8!==e.nodeType&&!pb.test(p+r.event.triggered)&&(p.indexOf(".")>-1&&(q=p.split("."),p=q.shift(),q.sort()),k=p.indexOf(":")<0&&"on"+p,b=b[r.expando]?b:new r.Event(p,"object"==typeof b&&b),b.isTrigger=f?2:3,b.namespace=q.join("."),b.rnamespace=b.namespace?new RegExp("(^|\\.)"+q.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,b.result=void 0,b.target||(b.target=e),c=null==c?[b]:r.makeArray(c,[b]),n=r.event.special[p]||{},f||!n.trigger||n.trigger.apply(e,c)!==!1)){if(!f&&!n.noBubble&&!r.isWindow(e)){for(j=n.delegateType||p,pb.test(j+p)||(h=h.parentNode);h;h=h.parentNode)o.push(h),i=h;i===(e.ownerDocument||d)&&o.push(i.defaultView||i.parentWindow||a)}g=0;while((h=o[g++])&&!b.isPropagationStopped())b.type=g>1?j:n.bindType||p,m=(V.get(h,"events")||{})[b.type]&&V.get(h,"handle"),m&&m.apply(h,c),m=k&&h[k],m&&m.apply&&T(h)&&(b.result=m.apply(h,c),b.result===!1&&b.preventDefault());return b.type=p,f||b.isDefaultPrevented()||n._default&&n._default.apply(o.pop(),c)!==!1||!T(e)||k&&r.isFunction(e[p])&&!r.isWindow(e)&&(i=e[k],i&&(e[k]=null),r.event.triggered=p,e[p](),r.event.triggered=void 0,i&&(e[k]=i)),b.result}},simulate:function(a,b,c){var d=r.extend(new r.Event,c,{type:a,isSimulated:!0});r.event.trigger(d,null,b)}}),r.fn.extend({trigger:function(a,b){return this.each(function(){r.event.trigger(a,b,this)})},triggerHandler:function(a,b){var c=this[0];if(c)return r.event.trigger(a,b,c,!0)}}),r.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(a,b){r.fn[b]=function(a,c){return arguments.length>0?this.on(b,null,a,c):this.trigger(b)}}),r.fn.extend({hover:function(a,b){return this.mouseenter(a).mouseleave(b||a)}}),o.focusin="onfocusin"in a,o.focusin||r.each({focus:"focusin",blur:"focusout"},function(a,b){var c=function(a){r.event.simulate(b,a.target,r.event.fix(a))};r.event.special[b]={setup:function(){var d=this.ownerDocument||this,e=V.access(d,b);e||d.addEventListener(a,c,!0),V.access(d,b,(e||0)+1)},teardown:function(){var d=this.ownerDocument||this,e=V.access(d,b)-1;e?V.access(d,b,e):(d.removeEventListener(a,c,!0),V.remove(d,b))}}});var qb=a.location,rb=r.now(),sb=/\?/;r.parseXML=function(b){var c;if(!b||"string"!=typeof b)return null;try{c=(new a.DOMParser).parseFromString(b,"text/xml")}catch(d){c=void 0}return c&&!c.getElementsByTagName("parsererror").length||r.error("Invalid XML: "+b),c};var tb=/\[\]$/,ub=/\r?\n/g,vb=/^(?:submit|button|image|reset|file)$/i,wb=/^(?:input|select|textarea|keygen)/i;function xb(a,b,c,d){var e;if(r.isArray(b))r.each(b,function(b,e){c||tb.test(a)?d(a,e):xb(a+"["+("object"==typeof e&&null!=e?b:"")+"]",e,c,d)});else if(c||"object"!==r.type(b))d(a,b);else for(e in b)xb(a+"["+e+"]",b[e],c,d)}r.param=function(a,b){var c,d=[],e=function(a,b){var c=r.isFunction(b)?b():b;d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(null==c?"":c)};if(r.isArray(a)||a.jquery&&!r.isPlainObject(a))r.each(a,function(){e(this.name,this.value)});else for(c in a)xb(c,a[c],b,e);return d.join("&")},r.fn.extend({serialize:function(){return r.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var a=r.prop(this,"elements");return a?r.makeArray(a):this}).filter(function(){var a=this.type;return this.name&&!r(this).is(":disabled")&&wb.test(this.nodeName)&&!vb.test(a)&&(this.checked||!ia.test(a))}).map(function(a,b){var c=r(this).val();return null==c?null:r.isArray(c)?r.map(c,function(a){return{name:b.name,value:a.replace(ub,"\r\n")}}):{name:b.name,value:c.replace(ub,"\r\n")}}).get()}});var yb=/%20/g,zb=/#.*$/,Ab=/([?&])_=[^&]*/,Bb=/^(.*?):[ \t]*([^\r\n]*)$/gm,Cb=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,Db=/^(?:GET|HEAD)$/,Eb=/^\/\//,Fb={},Gb={},Hb="*/".concat("*"),Ib=d.createElement("a");Ib.href=qb.href;function Jb(a){return function(b,c){"string"!=typeof b&&(c=b,b="*");var d,e=0,f=b.toLowerCase().match(K)||[];if(r.isFunction(c))while(d=f[e++])"+"===d[0]?(d=d.slice(1)||"*",(a[d]=a[d]||[]).unshift(c)):(a[d]=a[d]||[]).push(c)}}function Kb(a,b,c,d){var e={},f=a===Gb;function g(h){var i;return e[h]=!0,r.each(a[h]||[],function(a,h){var j=h(b,c,d);return"string"!=typeof j||f||e[j]?f?!(i=j):void 0:(b.dataTypes.unshift(j),g(j),!1)}),i}return g(b.dataTypes[0])||!e["*"]&&g("*")}function Lb(a,b){var c,d,e=r.ajaxSettings.flatOptions||{};for(c in b)void 0!==b[c]&&((e[c]?a:d||(d={}))[c]=b[c]);return d&&r.extend(!0,a,d),a}function Mb(a,b,c){var d,e,f,g,h=a.contents,i=a.dataTypes;while("*"===i[0])i.shift(),void 0===d&&(d=a.mimeType||b.getResponseHeader("Content-Type"));if(d)for(e in h)if(h[e]&&h[e].test(d)){i.unshift(e);break}if(i[0]in c)f=i[0];else{for(e in c){if(!i[0]||a.converters[e+" "+i[0]]){f=e;break}g||(g=e)}f=f||g}if(f)return f!==i[0]&&i.unshift(f),c[f]}function Nb(a,b,c,d){var e,f,g,h,i,j={},k=a.dataTypes.slice();if(k[1])for(g in a.converters)j[g.toLowerCase()]=a.converters[g];f=k.shift();while(f)if(a.responseFields[f]&&(c[a.responseFields[f]]=b),!i&&d&&a.dataFilter&&(b=a.dataFilter(b,a.dataType)),i=f,f=k.shift())if("*"===f)f=i;else if("*"!==i&&i!==f){if(g=j[i+" "+f]||j["* "+f],!g)for(e in j)if(h=e.split(" "),h[1]===f&&(g=j[i+" "+h[0]]||j["* "+h[0]])){g===!0?g=j[e]:j[e]!==!0&&(f=h[0],k.unshift(h[1]));break}if(g!==!0)if(g&&a["throws"])b=g(b);else try{b=g(b)}catch(l){return{state:"parsererror",error:g?l:"No conversion from "+i+" to "+f}}}return{state:"success",data:b}}r.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:qb.href,type:"GET",isLocal:Cb.test(qb.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Hb,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":r.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(a,b){return b?Lb(Lb(a,r.ajaxSettings),b):Lb(r.ajaxSettings,a)},ajaxPrefilter:Jb(Fb),ajaxTransport:Jb(Gb),ajax:function(b,c){"object"==typeof b&&(c=b,b=void 0),c=c||{};var e,f,g,h,i,j,k,l,m,n,o=r.ajaxSetup({},c),p=o.context||o,q=o.context&&(p.nodeType||p.jquery)?r(p):r.event,s=r.Deferred(),t=r.Callbacks("once memory"),u=o.statusCode||{},v={},w={},x="canceled",y={readyState:0,getResponseHeader:function(a){var b;if(k){if(!h){h={};while(b=Bb.exec(g))h[b[1].toLowerCase()]=b[2]}b=h[a.toLowerCase()]}return null==b?null:b},getAllResponseHeaders:function(){return k?g:null},setRequestHeader:function(a,b){return null==k&&(a=w[a.toLowerCase()]=w[a.toLowerCase()]||a,v[a]=b),this},overrideMimeType:function(a){return null==k&&(o.mimeType=a),this},statusCode:function(a){var b;if(a)if(k)y.always(a[y.status]);else for(b in a)u[b]=[u[b],a[b]];return this},abort:function(a){var b=a||x;return e&&e.abort(b),A(0,b),this}};if(s.promise(y),o.url=((b||o.url||qb.href)+"").replace(Eb,qb.protocol+"//"),o.type=c.method||c.type||o.method||o.type,o.dataTypes=(o.dataType||"*").toLowerCase().match(K)||[""],null==o.crossDomain){j=d.createElement("a");try{j.href=o.url,j.href=j.href,o.crossDomain=Ib.protocol+"//"+Ib.host!=j.protocol+"//"+j.host}catch(z){o.crossDomain=!0}}if(o.data&&o.processData&&"string"!=typeof o.data&&(o.data=r.param(o.data,o.traditional)),Kb(Fb,o,c,y),k)return y;l=r.event&&o.global,l&&0===r.active++&&r.event.trigger("ajaxStart"),o.type=o.type.toUpperCase(),o.hasContent=!Db.test(o.type),f=o.url.replace(zb,""),o.hasContent?o.data&&o.processData&&0===(o.contentType||"").indexOf("application/x-www-form-urlencoded")&&(o.data=o.data.replace(yb,"+")):(n=o.url.slice(f.length),o.data&&(f+=(sb.test(f)?"&":"?")+o.data,delete o.data),o.cache===!1&&(f=f.replace(Ab,"$1"),n=(sb.test(f)?"&":"?")+"_="+rb++ +n),o.url=f+n),o.ifModified&&(r.lastModified[f]&&y.setRequestHeader("If-Modified-Since",r.lastModified[f]),r.etag[f]&&y.setRequestHeader("If-None-Match",r.etag[f])),(o.data&&o.hasContent&&o.contentType!==!1||c.contentType)&&y.setRequestHeader("Content-Type",o.contentType),y.setRequestHeader("Accept",o.dataTypes[0]&&o.accepts[o.dataTypes[0]]?o.accepts[o.dataTypes[0]]+("*"!==o.dataTypes[0]?", "+Hb+"; q=0.01":""):o.accepts["*"]);for(m in o.headers)y.setRequestHeader(m,o.headers[m]);if(o.beforeSend&&(o.beforeSend.call(p,y,o)===!1||k))return y.abort();if(x="abort",t.add(o.complete),y.done(o.success),y.fail(o.error),e=Kb(Gb,o,c,y)){if(y.readyState=1,l&&q.trigger("ajaxSend",[y,o]),k)return y;o.async&&o.timeout>0&&(i=a.setTimeout(function(){y.abort("timeout")},o.timeout));try{k=!1,e.send(v,A)}catch(z){if(k)throw z;A(-1,z)}}else A(-1,"No Transport");function A(b,c,d,h){var j,m,n,v,w,x=c;k||(k=!0,i&&a.clearTimeout(i),e=void 0,g=h||"",y.readyState=b>0?4:0,j=b>=200&&b<300||304===b,d&&(v=Mb(o,y,d)),v=Nb(o,v,y,j),j?(o.ifModified&&(w=y.getResponseHeader("Last-Modified"),w&&(r.lastModified[f]=w),w=y.getResponseHeader("etag"),w&&(r.etag[f]=w)),204===b||"HEAD"===o.type?x="nocontent":304===b?x="notmodified":(x=v.state,m=v.data,n=v.error,j=!n)):(n=x,!b&&x||(x="error",b<0&&(b=0))),y.status=b,y.statusText=(c||x)+"",j?s.resolveWith(p,[m,x,y]):s.rejectWith(p,[y,x,n]),y.statusCode(u),u=void 0,l&&q.trigger(j?"ajaxSuccess":"ajaxError",[y,o,j?m:n]),t.fireWith(p,[y,x]),l&&(q.trigger("ajaxComplete",[y,o]),--r.active||r.event.trigger("ajaxStop")))}return y},getJSON:function(a,b,c){return r.get(a,b,c,"json")},getScript:function(a,b){return r.get(a,void 0,b,"script")}}),r.each(["get","post"],function(a,b){r[b]=function(a,c,d,e){return r.isFunction(c)&&(e=e||d,d=c,c=void 0),r.ajax(r.extend({url:a,type:b,dataType:e,data:c,success:d},r.isPlainObject(a)&&a))}}),r._evalUrl=function(a){return r.ajax({url:a,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,"throws":!0})},r.fn.extend({wrapAll:function(a){var b;return this[0]&&(r.isFunction(a)&&(a=a.call(this[0])),b=r(a,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstElementChild)a=a.firstElementChild;return a}).append(this)),this},wrapInner:function(a){return r.isFunction(a)?this.each(function(b){r(this).wrapInner(a.call(this,b))}):this.each(function(){var b=r(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var b=r.isFunction(a);return this.each(function(c){r(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(a){return this.parent(a).not("body").each(function(){r(this).replaceWith(this.childNodes)}),this}}),r.expr.pseudos.hidden=function(a){return!r.expr.pseudos.visible(a)},r.expr.pseudos.visible=function(a){return!!(a.offsetWidth||a.offsetHeight||a.getClientRects().length)},r.ajaxSettings.xhr=function(){try{return new a.XMLHttpRequest}catch(b){}};var Ob={0:200,1223:204},Pb=r.ajaxSettings.xhr();o.cors=!!Pb&&"withCredentials"in Pb,o.ajax=Pb=!!Pb,r.ajaxTransport(function(b){var c,d;if(o.cors||Pb&&!b.crossDomain)return{send:function(e,f){var g,h=b.xhr();if(h.open(b.type,b.url,b.async,b.username,b.password),b.xhrFields)for(g in b.xhrFields)h[g]=b.xhrFields[g];b.mimeType&&h.overrideMimeType&&h.overrideMimeType(b.mimeType),b.crossDomain||e["X-Requested-With"]||(e["X-Requested-With"]="XMLHttpRequest");for(g in e)h.setRequestHeader(g,e[g]);c=function(a){return function(){c&&(c=d=h.onload=h.onerror=h.onabort=h.onreadystatechange=null,"abort"===a?h.abort():"error"===a?"number"!=typeof h.status?f(0,"error"):f(h.status,h.statusText):f(Ob[h.status]||h.status,h.statusText,"text"!==(h.responseType||"text")||"string"!=typeof h.responseText?{binary:h.response}:{text:h.responseText},h.getAllResponseHeaders()))}},h.onload=c(),d=h.onerror=c("error"),void 0!==h.onabort?h.onabort=d:h.onreadystatechange=function(){4===h.readyState&&a.setTimeout(function(){c&&d()})},c=c("abort");try{h.send(b.hasContent&&b.data||null)}catch(i){if(c)throw i}},abort:function(){c&&c()}}}),r.ajaxPrefilter(function(a){a.crossDomain&&(a.contents.script=!1)}),r.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(a){return r.globalEval(a),a}}}),r.ajaxPrefilter("script",function(a){void 0===a.cache&&(a.cache=!1),a.crossDomain&&(a.type="GET")}),r.ajaxTransport("script",function(a){if(a.crossDomain){var b,c;return{send:function(e,f){b=r(" - diff --git a/_sass/layout/toc.scss b/_sass/layout/toc.scss index c4d9556079..7ac4716277 100644 --- a/_sass/layout/toc.scss +++ b/_sass/layout/toc.scss @@ -3,6 +3,14 @@ //------------------------------------------------ .sidebar-toc-wrapper { + position: -webkit-sticky; + position: sticky; + top: 0; + + @include bp(large) { + position: relative; + } + @include bp(medium) { display: none; } diff --git a/resources/js/functions.js b/resources/js/functions.js index ff9d0f7676..9e9fd92070 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -304,27 +304,9 @@ $(document).ready(function() { autoId: true, numerate: false }); - toggleStickyToc(); } }); -$(window).resize(function() { - toggleStickyToc(); -}); - -var toggleStickyToc = function() { - if ($("#sidebar-toc").length) { - if ($(window).width() <= 992) { - $(".sidebar-toc-wrapper").unstick(); - } else { - $(".sidebar-toc-wrapper").sticky({ - topSpacing: 0, - bottomSpacing: 500 - }); - } - } -} - // Language dropdown function DropDown(el) { this.dd = el; diff --git a/resources/js/vendor/jquery.sticky.js b/resources/js/vendor/jquery.sticky.js deleted file mode 100644 index f50486f357..0000000000 --- a/resources/js/vendor/jquery.sticky.js +++ /dev/null @@ -1,287 +0,0 @@ -// Sticky Plugin v1.0.4 for jQuery -// ============= -// Author: Anthony Garand -// Improvements by German M. Bravo (Kronuz) and Ruud Kamphuis (ruudk) -// Improvements by Leonardo C. Daronco (daronco) -// Created: 02/14/2011 -// Date: 07/20/2015 -// Website: http://stickyjs.com/ -// Description: Makes an element on the page stick on the screen as you scroll -// It will only set the 'top' and 'position' of your element, you -// might need to adjust the width in some cases. - -(function (factory) { - if (typeof define === 'function' && define.amd) { - // AMD. Register as an anonymous module. - define(['jquery'], factory); - } else if (typeof module === 'object' && module.exports) { - // Node/CommonJS - module.exports = factory(require('jquery')); - } else { - // Browser globals - factory(jQuery); - } -}(function ($) { - var slice = Array.prototype.slice; // save ref to original slice() - var splice = Array.prototype.splice; // save ref to original slice() - - var defaults = { - topSpacing: 0, - bottomSpacing: 0, - className: 'is-sticky', - wrapperClassName: 'sticky-wrapper', - center: false, - getWidthFrom: '', - widthFromWrapper: true, // works only when .getWidthFrom is empty - responsiveWidth: false, - zIndex: 'auto' - }, - $window = $(window), - $document = $(document), - sticked = [], - windowHeight = $window.height(), - scroller = function() { - var scrollTop = $window.scrollTop(), - documentHeight = $document.height(), - dwh = documentHeight - windowHeight, - extra = (scrollTop > dwh) ? dwh - scrollTop : 0; - - for (var i = 0, l = sticked.length; i < l; i++) { - var s = sticked[i], - elementTop = s.stickyWrapper.offset().top, - etse = elementTop - s.topSpacing - extra; - - //update height in case of dynamic content - s.stickyWrapper.css('height', s.stickyElement.outerHeight()); - - if (scrollTop <= etse) { - if (s.currentTop !== null) { - s.stickyElement - .css({ - 'width': '', - 'position': '', - 'top': '', - 'z-index': '' - }); - s.stickyElement.parent().removeClass(s.className); - s.stickyElement.trigger('sticky-end', [s]); - s.currentTop = null; - } - } - else { - var newTop = documentHeight - s.stickyElement.outerHeight() - - s.topSpacing - s.bottomSpacing - scrollTop - extra; - if (newTop < 0) { - newTop = newTop + s.topSpacing; - } else { - newTop = s.topSpacing; - } - if (s.currentTop !== newTop) { - var newWidth; - if (s.getWidthFrom) { - newWidth = $(s.getWidthFrom).width() || null; - } else if (s.widthFromWrapper) { - newWidth = s.stickyWrapper.width(); - } - if (newWidth == null) { - newWidth = s.stickyElement.width(); - } - s.stickyElement - .css('width', newWidth) - .css('position', 'fixed') - .css('top', newTop) - .css('z-index', s.zIndex); - - s.stickyElement.parent().addClass(s.className); - - if (s.currentTop === null) { - s.stickyElement.trigger('sticky-start', [s]); - } else { - // sticky is started but it have to be repositioned - s.stickyElement.trigger('sticky-update', [s]); - } - - if (s.currentTop === s.topSpacing && s.currentTop > newTop || s.currentTop === null && newTop < s.topSpacing) { - // just reached bottom || just started to stick but bottom is already reached - s.stickyElement.trigger('sticky-bottom-reached', [s]); - } else if(s.currentTop !== null && newTop === s.topSpacing && s.currentTop < newTop) { - // sticky is started && sticked at topSpacing && overflowing from top just finished - s.stickyElement.trigger('sticky-bottom-unreached', [s]); - } - - s.currentTop = newTop; - } - - // Check if sticky has reached end of container and stop sticking - var stickyWrapperContainer = s.stickyWrapper.parent(); - var unstick = (s.stickyElement.offset().top + s.stickyElement.outerHeight() >= stickyWrapperContainer.offset().top + stickyWrapperContainer.outerHeight()) && (s.stickyElement.offset().top <= s.topSpacing); - - if( unstick ) { - s.stickyElement - .css('position', 'absolute') - .css('top', '') - .css('bottom', 0) - .css('z-index', ''); - } else { - s.stickyElement - .css('position', 'fixed') - .css('top', newTop) - .css('bottom', '') - .css('z-index', s.zIndex); - } - } - } - }, - resizer = function() { - windowHeight = $window.height(); - - for (var i = 0, l = sticked.length; i < l; i++) { - var s = sticked[i]; - var newWidth = null; - if (s.getWidthFrom) { - if (s.responsiveWidth) { - newWidth = $(s.getWidthFrom).width(); - } - } else if(s.widthFromWrapper) { - newWidth = s.stickyWrapper.width(); - } - if (newWidth != null) { - s.stickyElement.css('width', newWidth); - } - } - }, - methods = { - init: function(options) { - return this.each(function() { - var o = $.extend({}, defaults, options); - var stickyElement = $(this); - - var stickyId = stickyElement.attr('id'); - var wrapperId = stickyId ? stickyId + '-' + defaults.wrapperClassName : defaults.wrapperClassName; - var wrapper = $('
') - .attr('id', wrapperId) - .addClass(o.wrapperClassName); - - stickyElement.wrapAll(function() { - if ($(this).parent("#" + wrapperId).length == 0) { - return wrapper; - } -}); - - var stickyWrapper = stickyElement.parent(); - - if (o.center) { - stickyWrapper.css({width:stickyElement.outerWidth(),marginLeft:"auto",marginRight:"auto"}); - } - - if (stickyElement.css("float") === "right") { - stickyElement.css({"float":"none"}).parent().css({"float":"right"}); - } - - o.stickyElement = stickyElement; - o.stickyWrapper = stickyWrapper; - o.currentTop = null; - - sticked.push(o); - - methods.setWrapperHeight(this); - methods.setupChangeListeners(this); - }); - }, - - setWrapperHeight: function(stickyElement) { - var element = $(stickyElement); - var stickyWrapper = element.parent(); - if (stickyWrapper) { - stickyWrapper.css('height', element.outerHeight()); - } - }, - - setupChangeListeners: function(stickyElement) { - if (window.MutationObserver) { - var mutationObserver = new window.MutationObserver(function(mutations) { - if (mutations[0].addedNodes.length || mutations[0].removedNodes.length) { - methods.setWrapperHeight(stickyElement); - } - }); - mutationObserver.observe(stickyElement, {subtree: true, childList: true}); - } else { - if (window.addEventListener) { - stickyElement.addEventListener('DOMNodeInserted', function() { - methods.setWrapperHeight(stickyElement); - }, false); - stickyElement.addEventListener('DOMNodeRemoved', function() { - methods.setWrapperHeight(stickyElement); - }, false); - } else if (window.attachEvent) { - stickyElement.attachEvent('onDOMNodeInserted', function() { - methods.setWrapperHeight(stickyElement); - }); - stickyElement.attachEvent('onDOMNodeRemoved', function() { - methods.setWrapperHeight(stickyElement); - }); - } - } - }, - update: scroller, - unstick: function(options) { - return this.each(function() { - var that = this; - var unstickyElement = $(that); - - var removeIdx = -1; - var i = sticked.length; - while (i-- > 0) { - if (sticked[i].stickyElement.get(0) === that) { - splice.call(sticked,i,1); - removeIdx = i; - } - } - if(removeIdx !== -1) { - unstickyElement.unwrap(); - unstickyElement - .css({ - 'width': '', - 'position': '', - 'top': '', - 'float': '', - 'z-index': '' - }) - ; - } - }); - } - }; - - // should be more efficient than using $window.scroll(scroller) and $window.resize(resizer): - if (window.addEventListener) { - window.addEventListener('scroll', scroller, false); - window.addEventListener('resize', resizer, false); - } else if (window.attachEvent) { - window.attachEvent('onscroll', scroller); - window.attachEvent('onresize', resizer); - } - - $.fn.sticky = function(method) { - if (methods[method]) { - return methods[method].apply(this, slice.call(arguments, 1)); - } else if (typeof method === 'object' || !method ) { - return methods.init.apply( this, arguments ); - } else { - $.error('Method ' + method + ' does not exist on jQuery.sticky'); - } - }; - - $.fn.unstick = function(method) { - if (methods[method]) { - return methods[method].apply(this, slice.call(arguments, 1)); - } else if (typeof method === 'object' || !method ) { - return methods.unstick.apply( this, arguments ); - } else { - $.error('Method ' + method + ' does not exist on jQuery.sticky'); - } - }; - $(function() { - setTimeout(scroller, 0); - }); -})); From 022d3a49b9e677a60e5cefed38365dc667e4cb28 Mon Sep 17 00:00:00 2001 From: Sam Zaydel Date: Mon, 18 Mar 2019 07:03:59 -0700 Subject: [PATCH 0439/3075] Extra 'not' in sentence in Trait Traversable --- _overviews/FAQ/collections.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/FAQ/collections.md b/_overviews/FAQ/collections.md index 65f9f3d5a1..b044191727 100644 --- a/_overviews/FAQ/collections.md +++ b/_overviews/FAQ/collections.md @@ -171,8 +171,8 @@ Traversible objects can be finite or infinite. An example of an infinite traversable object is the stream of natural numbers `Stream.from(0)`. The method `hasDefiniteSize` indicates whether a collection is possibly infinite. If `hasDefiniteSize` returns true, the collection is certainly finite. If it -returns false, the collection has not been not fully elaborated yet, so it -might be infinite or finite. +returns false, the collection has not been fully elaborated yet, so it might +be infinite or finite. This class defines methods which can be efficiently implemented in terms of `foreach` (over 40 of them). From 152516a1b3198f810fee43622040a7d1b444b5eb Mon Sep 17 00:00:00 2001 From: Xztty Date: Thu, 21 Mar 2019 14:14:01 +0800 Subject: [PATCH 0440/3075] replace JavaConversions to JavaConverters from scala 2.12.0 the JavaConversions is marked as deprecated class. And it's recommended to use JavaConverters --- ...ersions-between-java-and-scala-collections.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/_zh-cn/overviews/collections/conversions-between-java-and-scala-collections.md b/_zh-cn/overviews/collections/conversions-between-java-and-scala-collections.md index af302dd49f..9b8e44daf0 100644 --- a/_zh-cn/overviews/collections/conversions-between-java-and-scala-collections.md +++ b/_zh-cn/overviews/collections/conversions-between-java-and-scala-collections.md @@ -25,20 +25,20 @@ language: zh-cn mutable.Map <=> java.util.Map mutable.ConcurrentMap <=> java.util.concurrent.ConcurrentMap -使用这些转换很简单，只需从JavaConversions对象中import它们即可。 +使用这些转换很简单，只需从JavaConverters对象中import它们即可。 - scala> import collection.JavaConversions._ - import collection.Java.Conversions._ + scala> import collection.JavaConverters._ + import collection.JavaConverters._ -import之后，就可以在Scala容器和与之对应的Java容器之间进行隐式转换了 +import之后，通过扩展方法 asScala 和 asJava 就可以在Scala容器和与之对应的Java容器之间进行隐式转换了 scala> import collection.mutable._ import collection.mutable._ - scala> val jul: java.util.List[Int] = ArrayBuffer(1, 2, 3) + scala> val jul: java.util.List[Int] = ArrayBuffer(1, 2, 3).asJava jul: java.util.List[Int] = [1, 2, 3] - scala> val buf: Seq[Int] = jul + scala> val buf: Seq[Int] = jul.asScala buf: scala.collection.mutable.Seq[Int] = ArrayBuffer(1, 2, 3) - scala> val m: java.util.Map[String, Int] = HashMap("abc" -> 1, "hello" -> 2) + scala> val m: java.util.Map[String, Int] = HashMap("abc" -> 1, "hello" -> 2).asJava m: java.util.Map[String, Int] = {hello=2, abc=1} 在Scala内部，这些转换是通过一系列“包装”对象完成的，这些对象会将相应的方法调用转发至底层的容器对象。所以容器不会在Java和Scala之间拷贝来拷贝去。一个值得注意的特性是，如果你将一个Java容器转换成其对应的Scala容器，然后再将其转换回同样的Java容器，最终得到的是一个和一开始完全相同的容器对象（译注：这里的相同意味着这两个对象实际上是指向同一片内存区域的引用，容器转换过程中没有任何的拷贝发生）。 @@ -52,7 +52,7 @@ import之后，就可以在Scala容器和与之对应的Java容器之间进行 因为Java并未区分可变容器不可变容器类型，所以，虽然能将`scala.immutable.List`转换成`java.util.List`，但所有的修改操作都会抛出“UnsupportedOperationException”。参见下例： - scala> jul = List(1, 2, 3) + scala> jul = List(1, 2, 3).asJava jul: java.util.List[Int] = [1, 2, 3] scala> jul.add(7) java.lang.UnsupportedOperationException From 06464d4f919912051141a055c3ba5ece6c7bf99f Mon Sep 17 00:00:00 2001 From: salim7 Date: Tue, 26 Mar 2019 10:49:15 +0100 Subject: [PATCH 0441/3075] Fixed Typo --- .../parallel-collections/conversions.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/_overviews/parallel-collections/conversions.md b/_overviews/parallel-collections/conversions.md index 9997c5539a..f4d42d446c 100644 --- a/_overviews/parallel-collections/conversions.md +++ b/_overviews/parallel-collections/conversions.md @@ -66,16 +66,16 @@ into a `ParX` collection. Here is a summary of all conversion methods: -| Method | Return Type | -| -------------- | -------------- | -| `toArray` | `Array` | -| `toList` | `List` | -| `toIndexedSeq` | `IndexedSeq` | -| `toStream` | `Stream` | -| `toIterator` | `Iterator` | -| `toBuffer` | `Buffer` | -| `toTraversable`| `GenTraverable`| -| `toIterable` | `ParIterable` | -| `toSeq` | `ParSeq` | -| `toSet` | `ParSet` | -| `toMap` | `ParMap` | +| Method | Return Type | +| -------------- | --------------- | +| `toArray` | `Array` | +| `toList` | `List` | +| `toIndexedSeq` | `IndexedSeq` | +| `toStream` | `Stream` | +| `toIterator` | `Iterator` | +| `toBuffer` | `Buffer` | +| `toTraversable`| `GenTraversable`| +| `toIterable` | `ParIterable` | +| `toSeq` | `ParSeq` | +| `toSet` | `ParSet` | +| `toMap` | `ParMap` | From 6420a94d859c84fdabc3f2b95aab5b73de6d8a49 Mon Sep 17 00:00:00 2001 From: Long Sun Date: Tue, 26 Mar 2019 14:20:49 +0800 Subject: [PATCH 0442/3075] Fix typo --- _zh-cn/tour/basics.md | 2 +- _zh-cn/tour/classes.md | 2 +- _zh-cn/tour/unified-types.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_zh-cn/tour/basics.md b/_zh-cn/tour/basics.md index b63a482e41..82ac4a3f27 100644 --- a/_zh-cn/tour/basics.md +++ b/_zh-cn/tour/basics.md @@ -25,7 +25,7 @@ previous-page: tour-of-scala 这是一种简单的、零设置的方法来实践Scala的代码片段。 -这篇文档中的大部分代码示例与 ScalaFiddle 进行了集成，可以通过点击 “Run” 按钮即来直接运行 Scale 代码。 +这篇文档中的大部分代码示例与 ScalaFiddle 进行了集成，可以通过点击 “Run” 按钮即来直接运行 Scala 代码。 ## 表达式 diff --git a/_zh-cn/tour/classes.md b/_zh-cn/tour/classes.md index 1f6026a3aa..e916677681 100644 --- a/_zh-cn/tour/classes.md +++ b/_zh-cn/tour/classes.md @@ -95,7 +95,7 @@ point1.y = 101 // prints the warning ``` 在这个版本的`Point`类中，数据存在私有变量`_x`和`_y`中。`def x`和`def y`方法用于访问私有数据。`def x_=`和`def y_=`是为了验证和给`_x`和`_y`赋值。注意下对于setter方法的特殊语法：这个方法在getter方法的后面加上`_=`，后面跟着参数。 -主构造方法中带有`val`和`var`的参数时公有的。然而由于`val`是不可变的，所以不能像下面这样去使用。 +主构造方法中带有`val`和`var`的参数是公有的。然而由于`val`是不可变的，所以不能像下面这样去使用。 ``` class Point(val x: Int, val y: Int) val point = new Point(1, 2) diff --git a/_zh-cn/tour/unified-types.md b/_zh-cn/tour/unified-types.md index 4ddd6d01ac..d5bacaa87d 100644 --- a/_zh-cn/tour/unified-types.md +++ b/_zh-cn/tour/unified-types.md @@ -42,7 +42,7 @@ val list: List[Any] = List( list.foreach(element => println(element)) ``` -这里定义了一个类型`List`的变量`list`。这个列表里由多种类型进行初始化，但是它们都是`scala.Any`的实例，所以可以把它们加入到列表中。 +这里定义了一个类型`List`的变量`list`。这个列表里由多种类型进行初始化，但是它们都是`scala.Any`的实例，所以可以把它们加入到列表中。 下面是程序的输出： From 7166149b60df844d95da092ccb18c78a08b39552 Mon Sep 17 00:00:00 2001 From: Salim D Date: Tue, 26 Mar 2019 12:25:59 +0100 Subject: [PATCH 0443/3075] Fixed Typo in Japanese Translation --- .../parallel-collections/conversions.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/_ja/overviews/parallel-collections/conversions.md b/_ja/overviews/parallel-collections/conversions.md index 73345f4fd9..636f6885b4 100644 --- a/_ja/overviews/parallel-collections/conversions.md +++ b/_ja/overviews/parallel-collections/conversions.md @@ -47,16 +47,16 @@ language: ja 以下の表に全ての変換をまとめる: -| メソッド | 戻り値の型 | -| -------------- | -------------- | -| `toArray` | `Array` | -| `toList` | `List` | -| `toIndexedSeq` | `IndexedSeq` | -| `toStream` | `Stream` | -| `toIterator` | `Iterator` | -| `toBuffer` | `Buffer` | -| `toTraversable`| `GenTraverable`| -| `toIterable` | `ParIterable` | -| `toSeq` | `ParSeq` | -| `toSet` | `ParSet` | -| `toMap` | `ParMap` | +| メソッド | 戻り値の型 | +| -------------- | --------------- | +| `toArray` | `Array` | +| `toList` | `List` | +| `toIndexedSeq` | `IndexedSeq` | +| `toStream` | `Stream` | +| `toIterator` | `Iterator` | +| `toBuffer` | `Buffer` | +| `toTraversable`| `GenTraversable`| +| `toIterable` | `ParIterable` | +| `toSeq` | `ParSeq` | +| `toSet` | `ParSet` | +| `toMap` | `ParMap` | From e56e2f3c57e2d8552ea1b0804f7480d48aecd6b5 Mon Sep 17 00:00:00 2001 From: Salim D Date: Tue, 26 Mar 2019 12:27:00 +0100 Subject: [PATCH 0444/3075] Fixed Typo in Chinese Translation --- _zh-cn/overviews/parallel-collections/conversions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/parallel-collections/conversions.md b/_zh-cn/overviews/parallel-collections/conversions.md index 788ca55630..6f13fd3491 100644 --- a/_zh-cn/overviews/parallel-collections/conversions.md +++ b/_zh-cn/overviews/parallel-collections/conversions.md @@ -46,7 +46,7 @@ language: zh-cn |toStream | Stream | |toIterator | Iterator | |toBuffer | Buffer | -|toTraversable | GenTraverable | +|toTraversable | GenTraversable | |toIterable | ParIterable | |toSeq | ParSeq | |toSet | ParSet | From 86fe85797f87dbf547487d6236d1ead6e2c97abb Mon Sep 17 00:00:00 2001 From: Salim D Date: Tue, 26 Mar 2019 12:27:56 +0100 Subject: [PATCH 0445/3075] Fixed Typo in Spanish Translation --- .../parallel-collections/conversions.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/_es/overviews/parallel-collections/conversions.md b/_es/overviews/parallel-collections/conversions.md index 8461a2f9aa..ec836d0338 100644 --- a/_es/overviews/parallel-collections/conversions.md +++ b/_es/overviews/parallel-collections/conversions.md @@ -61,16 +61,16 @@ en una colección `ParX` A continuación se muestra un resumen de todos los métodos de conversión: -| método | Tipo de Retorno| -| -------------- | -------------- | -| `toArray` | `Array` | -| `toList` | `List` | -| `toIndexedSeq` | `IndexedSeq` | -| `toStream` | `Stream` | -| `toIterator` | `Iterator` | -| `toBuffer` | `Buffer` | -| `toTraversable`| `GenTraverable`| -| `toIterable` | `ParIterable` | -| `toSeq` | `ParSeq` | -| `toSet` | `ParSet` | -| `toMap` | `ParMap` | +| método | Tipo de Retorno | +| -------------- | --------------- | +| `toArray` | `Array` | +| `toList` | `List` | +| `toIndexedSeq` | `IndexedSeq` | +| `toStream` | `Stream` | +| `toIterator` | `Iterator` | +| `toBuffer` | `Buffer` | +| `toTraversable`| `GenTraversable`| +| `toIterable` | `ParIterable` | +| `toSeq` | `ParSeq` | +| `toSet` | `ParSet` | +| `toMap` | `ParMap` | From 2f5d77fb3657919a3aa0bc7b04e7ee00b3a49d19 Mon Sep 17 00:00:00 2001 From: Salim D Date: Tue, 26 Mar 2019 12:29:18 +0100 Subject: [PATCH 0446/3075] Fixed Typo in Russian Translation --- .../parallel-collections/conversions.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/_ru/overviews/parallel-collections/conversions.md b/_ru/overviews/parallel-collections/conversions.md index 8579774ec9..114f2d8986 100644 --- a/_ru/overviews/parallel-collections/conversions.md +++ b/_ru/overviews/parallel-collections/conversions.md @@ -38,16 +38,16 @@ num: 3 Ниже приведена сводная таблица всех методов преобразования: -| Метод | Тип возвращаемого значения | -| -------------- | -------------------------- | -| `toArray` | `Array` | -| `toList` | `List` | -| `toIndexedSeq` | `IndexedSeq` | -| `toStream` | `Stream` | -| `toIterator` | `Iterator` | -| `toBuffer` | `Buffer` | -| `toTraversable`| `GenTraverable` | -| `toIterable` | `ParIterable` | -| `toSeq` | `ParSeq` | -| `toSet` | `ParSet` | -| `toMap` | `ParMap` | +| Метод | Тип возвращаемого значения | +| -------------- | --------------------------- | +| `toArray` | `Array` | +| `toList` | `List` | +| `toIndexedSeq` | `IndexedSeq` | +| `toStream` | `Stream` | +| `toIterator` | `Iterator` | +| `toBuffer` | `Buffer` | +| `toTraversable`| `GenTraversable` | +| `toIterable` | `ParIterable` | +| `toSeq` | `ParSeq` | +| `toSet` | `ParSet` | +| `toMap` | `ParMap` | From 16d636c1509d374a328c58518c282ba04fb52c63 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 8 Apr 2019 08:36:19 +0000 Subject: [PATCH 0447/3075] add RC1 Scaladoc --- api/all.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/api/all.md b/api/all.md index d629074504..50c5bea6bc 100644 --- a/api/all.md +++ b/api/all.md @@ -5,6 +5,7 @@ includeTOC: true --- ## Latest releases + * Scala 2.12.8 * [Library API](https://www.scala-lang.org/api/2.12.8/) * [Compiler API](https://www.scala-lang.org/api/2.12.8/scala-compiler/scala/) @@ -25,6 +26,13 @@ includeTOC: true * [Continuations API](https://www.scala-lang.org/files/archive/api/2.11.12/scala-continuations-library/#scala.util.continuations.package) * [Scala 2.10.7](https://www.scala-lang.org/api/2.10.7/) +## Prereleases + +* Scala 2.13.0-RC1 + * [Library API](https://www.scala-lang.org/api/2.13.0-RC1/) + * [Compiler API](https://www.scala-lang.org/api/2.13.0-RC1/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.0-RC1/scala-reflect/scala/reflect/) + ## Nightly builds * Scala 2.13.x From 151a87ec0d501fe70702cd1193597e8ac5fa1232 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 9 Apr 2019 13:38:35 +0200 Subject: [PATCH 0448/3075] Adapt architecture of collections to latest 2.13 changes --- .../architecture-of-scala-213-collections.md | 33 ++-- .../core/custom-collection-operations.md | 2 +- _overviews/core/custom-collections.md | 166 ++++++++++-------- 3 files changed, 105 insertions(+), 96 deletions(-) diff --git a/_overviews/core/architecture-of-scala-213-collections.md b/_overviews/core/architecture-of-scala-213-collections.md index 5144b83f45..557c8c0258 100644 --- a/_overviews/core/architecture-of-scala-213-collections.md +++ b/_overviews/core/architecture-of-scala-213-collections.md @@ -280,13 +280,13 @@ implementations of `filter` and `map`: trait IterableOps[+A, +CC[_], +C] { def filter(pred: A => Boolean): C = - fromSpecificIterable(new View.Filter(this, pred)) + fromSpecific(new View.Filter(this, pred)) def map[B](f: A => B): CC[B] = - fromIterable(new View.Map(this, f)) + from(new View.Map(this, f)) - protected def fromSpecificIterable(coll: Iterable[A]): C - protected def fromIterable[E](it: Iterable[E]): CC[E] + protected def fromSpecific(coll: IterableOnce[A]): C + protected def from[E](it: IterableOnce[E]): CC[E] } ~~~ @@ -294,25 +294,25 @@ Let’s detail the implementation of `filter`, step by step: - the instantiation of `View.Filter` creates a (non-strict) `View` that filters the elements of the underlying collection ; -- the call to `fromSpecificIterable` turns the `View` into a concrete - collection `C`. The implementation of `fromSpecificIterable` is left to +- the call to `fromSpecific` turns the `View` into a concrete + collection `C`. The implementation of `fromSpecific` is left to concrete collections: they can decide to evaluate in a strict or non-strict way the elements resulting from the operation. The implementation of `map` is similar, excepted that instead of using -`fromSpecificIterable` it uses `fromIterable` which takes as parameter an +`fromSpecific` it uses `from` which takes as parameter an iterable whose element type `E` is arbitrary. -Actually, `fromIterable` is not abstract in `IterableOps`: it delegates to an -`iterableFactory` member (which is abstract): +Actually, the `from` operation is not defined directly in `IterableOps` but is accessed via +an (abstract) `iterableFactory` member: ~~~ scala trait IterableOps[+A, +CC[_], +C] { - protected def fromIterable[E](it: Iterable[E]): CC[E] = - iterableFactory.from(it) - def iterableFactory: IterableFactory[CC] + + def map[B](f: A => B): CC[B] = + iterableFactory.from(new View.Map(this, f)) } ~~~ @@ -336,12 +336,9 @@ trait MapOps[K, +V, +CC[_, _], +C] extends IterableOps[(K, V), Iterable, C] { def map[K2, V2](f: ((K, V)) => (K2, V2)): CC[K2, V2] = - mapFromIterable(new View.Map(this, f)) - - // Similar to fromIterable, but returns a Map collection type - protected def mapFromIterable[K2, V2](it: Iterable[(K2, V2)]): CC[K2, V2] = - mapFactory.from(it) + mapFactory.from(new View.Map(this, f)) + // Similar to iterableFactory, but for Map collection types def mapFactory: MapFactory[CC] } @@ -387,7 +384,7 @@ type of elements. The following code shows the relevant parts of `IterableOps` a ~~~ scala trait IterableOps[+A, +CC[_], +C] { def iterableFactory: IterableFactory[CC] - protected def fromSpecificIterable(coll: Iterable[A]): C + protected def fromSpecific(coll: IterableOnce[A]): C protected def newSpecificBuilder: Builder[A, C] } diff --git a/_overviews/core/custom-collection-operations.md b/_overviews/core/custom-collection-operations.md index 29b3e9dd77..87b2f863ae 100644 --- a/_overviews/core/custom-collection-operations.md +++ b/_overviews/core/custom-collection-operations.md @@ -279,7 +279,7 @@ trait BuildFrom[-From, -A, +C] { /** @return a collection of type `C` containing the same elements * (of type `A`) as the source collection `it`. */ - def fromSpecificIterable(from: From)(it: Iterable[A]): C + def fromSpecific(from: From)(it: IterableOnce[A]): C /** @return a Builder for the collection type `C`, containing * elements of type `A`. diff --git a/_overviews/core/custom-collections.md b/_overviews/core/custom-collections.md index b73685ee68..d673110cea 100644 --- a/_overviews/core/custom-collections.md +++ b/_overviews/core/custom-collections.md @@ -72,6 +72,8 @@ class Capped1[A] private (val capacity: Int, val length: Int, offset: Int, elems elem } } + + override def className = "Capped1" } ~~~ @@ -101,6 +103,9 @@ to implement `iterator` to make the generic collection operations (such as `foldLeft`, `count`, etc.) work on `Capped` collections. Here we implement it by using indexed access. +Last, we override `className` to return the name of the collection, +“Capped1”. This name is used by the `toString` operation. + Here are some interactions with the `Capped1` collection: ~~~ scala @@ -165,7 +170,11 @@ class Capped2[A] private (val capacity: Int, val length: Int, offset: Int, elems def iterator: Iterator[A] = // as before + override def className = "Capped2" override val iterableFactory: IterableFactory[Capped2] = new Capped2Factory(capacity) + override protected def fromSpecific(coll: IterableOnce[A]): Capped2[A] = iterableFactory.from(coll) + override protected def newSpecificBuilder: mutable.Builder[A, Capped2[A]] = iterableFactory.newBuilder + override def empty: Capped2[A] = iterableFactory.empty } @@ -199,14 +208,22 @@ type of methods like `map`, `flatMap` or `concat` is defined by the second type parameter passed to class `IterableOps`, i.e., in class `Capped2`, it is `Capped2` itself. -To construct a `Capped2`, the `fromSpecificIterable` and -`newSpecificBuilder` implementations inherited from `immutable.Iterable` -delegate to the `iterableFactory` member, which is overridden here to -return an instance of `Capped2Factory`. This class -provides convenient factory methods to build collections. Eventually, -these methods delegate to `empty`, which builds an empty `Capped2` -instance, and `newBuilder`, which uses the `appended` operation -to grow a `Capped2` collection. +Operations returning `Capped2[A]` collections are implemented in `IterableOps` +in terms of the `fromSpecific` and `newSpecificBuilder` operations. The +`immutable.Iterable[A]` parent class implements the `fromSpecific` and +`newSpecificBuilder` such that they only return `immutable.Iterable[A]` +collections instead of the expected `Capped2[A]` collections. Consequently, +we override the `fromSpecific` and `newSpecificBuilder` operations to +make them return a `Capped2[A]` collection. Another inherited operation +returning a too general type is `empty`. We override it to return a +`Capped2[A]` collection too. All these overrides simply forward to the +collection factory referred to by the `iterableFactory` member, whose value +is an instance of class `Capped2Factory`. + +The `Capped2Factory` class provides convenient factory methods to build +collections. Eventually, these methods delegate to the `empty` operation, +which builds an empty `Capped2` instance, and `newBuilder`, which uses the +`appended` operation to grow a `Capped2` collection. With the refined implementation of the [`Capped2` class](#second-version-of-capped-class), the transformation operations work now as expected, and the @@ -233,9 +250,15 @@ res4: Capped2[Int] = Capped2(2, 3, 4, 5) ~~~ This implementation now behaves correctly, but we can still improve -a few things. Since our collection is strict, we can take advantage -of the better performance offered by -strict implementations of transformation operations. +a few things: + +- since our collection is strict, we can take advantage + of the better performance offered by + strict implementations of transformation operations, +- since our `fromSpecific`, `newSpecificBuilder` and `empty` + operation just forward to the `iterableFactory` member, + we can use the `IterableFactoryDefaults` trait that provides + such implementations. ### Final version of `Capped` class ### @@ -245,6 +268,7 @@ import scala.collection._ final class Capped[A] private (val capacity: Int, val length: Int, offset: Int, elems: Array[Any]) extends immutable.Iterable[A] with IterableOps[A, Capped, Capped[A]] + with IterableFactoryDefaults[A, Capped] with StrictOptimizedIterableOps[A, Capped, Capped[A]] { self => def this(capacity: Int) = @@ -277,6 +301,8 @@ final class Capped[A] private (val capacity: Int, val length: Int, offset: Int, override def knownSize: Int = length + override def className = "Capped" + override val iterableFactory: IterableFactory[Capped] = new CappedFactory(capacity) } @@ -303,6 +329,9 @@ That is it. The final [`Capped` class](#final-version-of-capped-class): - extends the `StrictOptimizedIterableOps` trait, which overrides all transformation operations to take advantage of strict builders, +- extends the `IterableFactoryDefaults` trait, which overrides the + `fromSpecific`, `newSpecificBuilder` and `empty` operations to forward + to the `iterableFactory`, - overrides a few operations for performance: the `view` now uses indexed access, and the `iterator` delegates to the view. The `knownSize` operation is also overridden because the size is always @@ -371,10 +400,12 @@ representation. Base.fromInt(groups(idx / N) >> (idx % N * S) & M) } - override protected def fromSpecificIterable(coll: Iterable[Base]): RNA1 = - fromSeq(coll.toSeq) + override protected def fromSpecific(coll: IterableOnce[Base]): RNA1 = + fromSeq(coll.iterator.toSeq) override protected def newSpecificBuilder: mutable.Builder[Base, RNA1] = iterableFactory.newBuilder[Base].mapResult(fromSeq) + override def empty: RNA1 = fromSeq(Seq.empty) + override def className = "RNA1" } object RNA1 { @@ -422,7 +453,7 @@ abstract methods: We also override the following members used by transformation operations such as `filter` and `take`: -- `fromSpecificIterable`, implemented by the `fromSeq` method of the `RNA1` +- `fromSpecific`, implemented by the `fromSeq` method of the `RNA1` companion object, - `newSpecificBuilder`, implemented by using the default `IndexedSeq` builder and transforming its result into an `RNA1` with the `mapResult` method. @@ -554,26 +585,28 @@ this is why we always get a `Vector` as a result. import RNA2._ def apply(idx: Int): Base = // as before - override protected def fromSpecificIterable(coll: Iterable[Base]): RNA2 = // as before + override protected def fromSpecific(coll: IterableOnce[Base]): RNA2 = // as before override protected def newSpecificBuilder: mutable.Builder[Base, RNA2] = // as before // Overloading of `appended`, `prepended`, `appendedAll`, // `prependedAll`, `map`, `flatMap` and `concat` to return an `RNA2` // when possible + def concat(suffix: IterableOnce[Base]): RNA2 = + fromSpecific(iterator ++ suffix.iterator) + // symbolic alias for `concat` + @inline final def ++ (suffix: IterableOnce[Base]): RNA2 = concat(suffix) def appended(base: Base): RNA2 = - fromSpecificIterable(new View.Append(this, base)) - def appendedAll(suffix: Iterable[Base]): RNA2 = - fromSpecificIterable(new View.Concat(this, suffix)) + fromSpecific(new View.Append(this, base)) + def appendedAll(suffix: IterableOnce[Base]): RNA2 = + concat(suffix) def prepended(base: Base): RNA2 = - fromSpecificIterable(new View.Prepend(base, this)) - def prependedAll(prefix: Iterable[Base]): RNA2 = - fromSpecificIterable(new View.Concat(prefix, this)) + fromSpecific(new View.Prepend(base, this)) + def prependedAll(prefix: IterableOnce[Base]): RNA2 = + fromSpecific(prefix.iterator ++ iterator) def map(f: Base => Base): RNA2 = - fromSpecificIterable(new View.Map(this, f)) + fromSpecific(new View.Map(this, f)) def flatMap(f: Base => IterableOnce[Base]): RNA2 = - fromSpecificIterable(new View.FlatMap(this, f)) - def concat(suffix: Iterable[Base]): RNA2 = - fromSpecificIterable(new View.Concat(this, suffix)) + fromSpecific(new View.FlatMap(this, f)) } To address this shortcoming, you need to overload the methods that @@ -581,7 +614,7 @@ return an `IndexedSeq[B]` for the case where `B` is known to be `Base`, to return an `RNA2` instead. Compared to [class `RNA1`](#first-version-of-rna-strands-class) -we added overloads for methods `appended`, `appendedAll`, `prepended`, +we added overloads for methods `concat`, `appended`, `appendedAll`, `prepended`, `prependedAll`, `map` and `flatMap`. This implementation now behaves correctly, but we can still improve a few things. Since our @@ -622,43 +655,31 @@ final class RNA private ( Base.fromInt(groups(idx / N) >> (idx % N * S) & M) } - // Mandatory implementation of `fromSpecificIterable` and - // `newSpecificBuilder`, from `IterableOps` - override protected def fromSpecificIterable(coll: Iterable[Base]): RNA = + // Mandatory overrides of `fromSpecific`, `newSpecificBuilder`, + // and `empty`, from `IterableOps` + override protected def fromSpecific(coll: IterableOnce[Base]): RNA = RNA.fromSpecific(coll) override protected def newSpecificBuilder: mutable.Builder[Base, RNA] = RNA.newBuilder + override def empty: RNA = RNA.empty // Overloading of `appended`, `prepended`, `appendedAll`, `prependedAll`, // `map`, `flatMap` and `concat` to return an `RNA` when possible + def concat(suffix: IterableOnce[Base]): RNA = + strictOptimizedConcat(suffix, newSpecificBuilder) + @inline final def ++ (suffix: IterableOnce[Base]): RNA = concat(suffix) def appended(base: Base): RNA = (newSpecificBuilder ++= this += base).result() def appendedAll(suffix: Iterable[Base]): RNA = - (newSpecificBuilder ++= this ++= suffix).result() + strictOptimizedConcat(suffix, newSpecificBuilder) def prepended(base: Base): RNA = (newSpecificBuilder += base ++= this).result() def prependedAll(prefix: Iterable[Base]): RNA = (newSpecificBuilder ++= prefix ++= this).result() - def map(f: Base => Base): RNA = { - var b = newSpecificBuilder - for (base <- this) { - b += f(base) - } - b.result() - } - def flatMap(f: Base => IterableOnce[Base]): RNA = { - var b = newSpecificBuilder - for (base <- this) { - b ++= f(base) - } - b.result() - } - def concat(suffix: IterableOnce[Base]): RNA = { - val b = newSpecificBuilder - b ++= this - b ++= suffix - b.result() - } + def map(f: Base => Base): RNA = + strictOptimizedMap(newSpecificBuilder, f) + def flatMap(f: Base => IterableOnce[Base]): RNA = + strictOptimizedFlatMap(newSpecificBuilder, f) // Optional re-implementation of iterator, // to make it more efficient. @@ -673,6 +694,7 @@ final class RNA private ( } } + override def className = "RNA" } object RNA extends SpecificIterableFactory[Base, RNA] { @@ -706,12 +728,13 @@ The final [`RNA` class](#final-version-of-rna-strands-class): - extends the `StrictOptimizedSeqOps` trait, which overrides all transformation operations to take advantage of strict builders, -- uses a strict mode for overloads of transformation operations that return - an `RNA`, +- uses utility operations provided by the `StrictOptimizedSeqOps` trait such as + `strictOptimizedConcat` to implement overload of transformation operations that + return an `RNA` collection, - has a companion object that extends `SpecificIterableFactory[Base, RNA]`, which makes it possible to use it as a parameter of a `to` call (to convert any collection of bases to an `RNA`, e.g. `List(U, A, G, C).to(RNA)`), -- moves the `newSpecificBuilder` and `fromSpecificIterable` implementations +- moves the `newSpecificBuilder` and `fromSpecific` implementations to the companion object. The discussion so far centered on the minimal amount of definitions @@ -826,35 +849,23 @@ class PrefixMap[A] } // Overloading of transformation methods that should return a PrefixMap - def map[B](f: ((String, A)) => (String, B)): PrefixMap[B] = { - val b = PrefixMap.newBuilder[B] - for (kv <- this) { - b += f(kv) - } - b.result() - } - def flatMap[B](f: ((String, A)) => IterableOnce[(String, B)]): PrefixMap[B] = { - val b = PrefixMap.newBuilder[B] - for (kv <- this) { - b ++= f(kv) - } - b.result() - } + def map[B](f: ((String, A)) => (String, B)): PrefixMap[B] = + strictOptimizedMap(PrefixMap.newBuilder, f) + def flatMap[B](f: ((String, A)) => IterableOnce[(String, B)]): PrefixMap[B] = + strictOptimizedFlatMap(PrefixMap.newBuilder, f) // Override `concat` and `empty` methods to refine their return type - override def concat[B >: A](suffix: Iterable[(String, B)]): PrefixMap[B] = { - val b = PrefixMap.newBuilder[B] - b ++= this - b ++= suffix - b.result() - } + override def concat[B >: A](suffix: IterableOnce[(String, B)]): PrefixMap[B] = + strictOptimizedConcat(suffix, PrefixMap.newBuilder) override def empty: PrefixMap[A] = new PrefixMap // Members declared in scala.collection.mutable.Clearable - def clear(): Unit = suffixes = immutable.Map.empty + override def clear(): Unit = suffixes = immutable.Map.empty // Members declared in scala.collection.IterableOps - override protected def fromSpecificIterable(coll: Iterable[(String, A)]): PrefixMap[A] = PrefixMap.from(coll) + override protected def fromSpecific(coll: IterableOnce[(String, A)]): PrefixMap[A] = PrefixMap.from(coll) override protected def newSpecificBuilder: mutable.Builder[(String, A), PrefixMap[A]] = PrefixMap.newBuilder + + override def className = "PrefixMap" } object PrefixMap { @@ -871,6 +882,8 @@ object PrefixMap { def newBuilder[A]: mutable.Builder[(String, A), PrefixMap[A]] = new mutable.GrowableBuilder[(String, A), PrefixMap[A]](empty) + import scala.language.implicitConversions + implicit def toFactory[A](self: this.type): Factory[(String, A), PrefixMap[A]] = new Factory[(String, A), PrefixMap[A]] { def fromSpecific(it: IterableOnce[(String, A)]): PrefixMap[A] = self.from(it) @@ -953,8 +966,7 @@ exactly one element `x`, if the option value is `Some(x)`. However, in all these cases, to build the right kind of collection you need to start with an empty collection of that kind. This is -provided by the `empty` method, which is the last method defined in -`PrefixMap`. This method simply returns a fresh `PrefixMap`. +provided by the `empty` method, which simply returns a fresh `PrefixMap`. We'll now turn to the companion object `PrefixMap`. In fact it is not strictly necessary to define this companion object, as class `PrefixMap` From e6c3ab621a841d3ec0d2f96fa7ced062c5a8563d Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 9 Apr 2019 13:40:10 +0200 Subject: [PATCH 0449/3075] Credit book Programming in Scala --- _overviews/core/architecture-of-scala-213-collections.md | 7 +++++++ _overviews/core/custom-collections.md | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/_overviews/core/architecture-of-scala-213-collections.md b/_overviews/core/architecture-of-scala-213-collections.md index 557c8c0258..ad4fede7b7 100644 --- a/_overviews/core/architecture-of-scala-213-collections.md +++ b/_overviews/core/architecture-of-scala-213-collections.md @@ -425,3 +425,10 @@ This document explains that: You now have all the required knowledge to implement [custom collection types]({{ site.baseurl }}/overviews/core/custom-collections.html). + +### Acknowledgement ### + +This page contains material adapted from the book +[Programming in Scala](http://www.artima.com/shop/programming_in_scala) by +Odersky, Spoon and Venners. We thank Artima for graciously agreeing to its +publication. diff --git a/_overviews/core/custom-collections.md b/_overviews/core/custom-collections.md index d673110cea..65941555ce 100644 --- a/_overviews/core/custom-collections.md +++ b/_overviews/core/custom-collections.md @@ -1010,7 +1010,7 @@ methods without having to reimplement them all over again. ### Acknowledgement ### -These pages contain material adapted from the 2nd edition of +This page contains material adapted from the book [Programming in Scala](http://www.artima.com/shop/programming_in_scala) by Odersky, Spoon and Venners. We thank Artima for graciously agreeing to its publication. From cfa0b2f9be2286f4c1c9bff29649819d8a275883 Mon Sep 17 00:00:00 2001 From: matko-CT Date: Wed, 10 Apr 2019 11:02:19 +0200 Subject: [PATCH 0450/3075] typo underly to underlie --- _overviews/collections/concrete-immutable-collection-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections/concrete-immutable-collection-classes.md b/_overviews/collections/concrete-immutable-collection-classes.md index 78ca9d0857..64bfb62655 100644 --- a/_overviews/collections/concrete-immutable-collection-classes.md +++ b/_overviews/collections/concrete-immutable-collection-classes.md @@ -152,7 +152,7 @@ Ranges are represented in constant space, because they can be defined by just th Hash tries are a standard way to implement immutable sets and maps efficiently. They are supported by class [immutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/HashMap.html). Their representation is similar to vectors in that they are also trees where every node has 32 elements or 32 subtrees. But the selection of these keys is now done based on hash code. For instance, to find a given key in a map, one first takes the hash code of the key. Then, the lowest 5 bits of the hash code are used to select the first subtree, followed by the next 5 bits and so on. The selection stops once all elements stored in a node have hash codes that differ from each other in the bits that are selected up to this level. -Hash tries strike a nice balance between reasonably fast lookups and reasonably efficient functional insertions (`+`) and deletions (`-`). That's why they underly Scala's default implementations of immutable maps and sets. In fact, Scala has a further optimization for immutable sets and maps that contain less than five elements. Sets and maps with one to four elements are stored as single objects that just contain the elements (or key/value pairs in the case of a map) as fields. The empty immutable set and the empty immutable map is in each case a single object - there's no need to duplicate storage for those because an empty immutable set or map will always stay empty. +Hash tries strike a nice balance between reasonably fast lookups and reasonably efficient functional insertions (`+`) and deletions (`-`). That's why they underlie Scala's default implementations of immutable maps and sets. In fact, Scala has a further optimization for immutable sets and maps that contain less than five elements. Sets and maps with one to four elements are stored as single objects that just contain the elements (or key/value pairs in the case of a map) as fields. The empty immutable set and the empty immutable map is in each case a single object - there's no need to duplicate storage for those because an empty immutable set or map will always stay empty. ## Red-Black Trees From 905395328bfe249feaef59f74950dc462af448f1 Mon Sep 17 00:00:00 2001 From: fmc Date: Wed, 10 Apr 2019 16:36:45 -0400 Subject: [PATCH 0451/3075] [chore] Fix some spelling and grammar errors --- _overviews/macros/typeproviders.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/macros/typeproviders.md b/_overviews/macros/typeproviders.md index db886a9c4b..f6fb1615b3 100644 --- a/_overviews/macros/typeproviders.md +++ b/_overviews/macros/typeproviders.md @@ -35,7 +35,7 @@ concrete examples. Slides and accompanying code can be found at [https://github. ## Introduction Type providers are a strongly-typed type-bridging mechanism, which enables information-rich programming in F# 3.0. -A type provider is a compile-time facility, which is capable of generating definitions and their implementations +A type provider is a compile-time facility which is capable of generating definitions and their implementations based on static parameters describing datasources. Type providers can operate in two modes: non-erased and erased. The former is similar to textual code generation in the sense that every generated type becomes bytecode, while in the latter case generated types only manifest themselves during type checking, but before bytecode generation @@ -70,7 +70,7 @@ takes a connection string and generates a module that encapsulates the given dat new Db {} } -It is true that noone outside the macro expansion block would be able to refer to the `Coffee` class directly, +It is true that no one outside the macro expansion block would be able to refer to the `Coffee` class directly, however if we inspect the type of `db`, we will find something fascinating. scala> val db = h2db("jdbc:h2:coffees.h2.db") From 1077b0ac26a89b64deaa6121ff30869933c7da84 Mon Sep 17 00:00:00 2001 From: Kshitij Date: Sun, 14 Apr 2019 18:16:19 +0530 Subject: [PATCH 0452/3075] Fix reverseSort to first sort and then reverse --- _overviews/FAQ/finding-implicits.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/FAQ/finding-implicits.md b/_overviews/FAQ/finding-implicits.md index c12d7b2748..015216f28c 100644 --- a/_overviews/FAQ/finding-implicits.md +++ b/_overviews/FAQ/finding-implicits.md @@ -124,7 +124,7 @@ Context bounds are more useful when you just need to _pass_ them to other methods that use them. For example, the method `sorted` on `Seq` needs an implicit `Ordering`. To create a method `reverseSort`, one could write: - def reverseSort[T : Ordering](seq: Seq[T]) = seq.reverse.sorted + def reverseSort[T : Ordering](seq: Seq[T]) = seq.sorted.reverse Because `Ordering[T]` was implicitly passed to `reverseSort`, it can then pass it implicitly to `sorted`. From 6307ea383f3122ce8faccd65434b60d38598885c Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 16 Apr 2019 13:56:53 -0700 Subject: [PATCH 0453/3075] JDK 12 is out --- _overviews/jdk-compatibility/overview.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 477a039c86..b776a87a6b 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -56,9 +56,9 @@ To help with testing on JDK 11, see [scala/scala-dev#559](https://github.com/sca ## JDK 12 compatibility notes -As of February 2019, JDK 12 is not in full release, but early-access builds are available. Note that even the final JDK 12 release will not be an LTS release, so the remarks above about non-LTS releases apply. +JDK 12 was released in March 2019. But it is not an LTS release, so the remarks above about non-LTS releases apply. -Scala has not yet been extensively tested on JDK 12. +Scala has not been extensively tested on JDK 12. However, the Scala 2.12 community build is [up and running](https://scala-ci.typesafe.com/view/scala-2.12.x/job/scala-2.12.x-jdk12-integrate-community-build/) on an early-access JDK 12 build, and most projects are green. @@ -67,7 +67,7 @@ Two significant known issues with Scala 2.12.8 on JDK 12 are: * the `-release` flag doesn't work ([scala/bug#11403](https://github.com/scala/bug/issues/11403)) * the optimizer doesn't work ([scala/bug#11372](https://github.com/scala/bug/issues/11372)) -Both issues have already been fixed. The fixes will be included in [Scala 2.12.9](https://github.com/scala/scala/milestone/77). A release date for 2.12.9 has not been set. In the meantime, consider using a [Scala nightly build](https://stackoverflow.com/questions/40622878/how-do-i-tell-sbt-to-use-a-nightly-build-of-scala-2-12-or-2-13) to test the fixes. +Both issues have already been fixed. The fixes will be included in [Scala 2.12.9](https://github.com/scala/scala/milestone/77). 2.12.9 is tentatively planned for release in June 2019. In the meantime, consider using a [Scala nightly build](https://stackoverflow.com/questions/40622878/how-do-i-tell-sbt-to-use-a-nightly-build-of-scala-2-12-or-2-13) to test the fixes. In other respects, so far it appears that 12 is similar to 11 with respect to Scala compatibility. From ff6580c6247ee091b4805335a67480f2153c3bec Mon Sep 17 00:00:00 2001 From: Bert Kellerman Date: Thu, 18 Apr 2019 08:49:07 -0700 Subject: [PATCH 0454/3075] Update pattern-matching.md --- _tour/pattern-matching.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index 5a6d4969c4..b5f9e37d46 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -65,8 +65,8 @@ case class VoiceRecording(contactName: String, link: String) extends Notificatio ``` def showNotification(notification: Notification): String = { notification match { - case Email(email, title, _) => - s"You got an email from $email with title: $title" + case Email(sender, title, _) => + s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" case VoiceRecording(name, link) => @@ -80,7 +80,7 @@ println(showNotification(someSms)) // prints You got an SMS from 12345! Message println(showNotification(someVoiceRecording)) // you received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123 ``` -The function `showNotification` takes as a parameter the abstract type `Notification` and matches on the type of `Notification` (i.e. it figures out whether it's an `Email`, `SMS`, or `VoiceRecording`). In the `case Email(email, title, _)` the fields `email` and `title` are used in the return value but the `body` field is ignored with `_`. +The function `showNotification` takes as a parameter the abstract type `Notification` and matches on the type of `Notification` (i.e. it figures out whether it's an `Email`, `SMS`, or `VoiceRecording`). In the `case Email(sender, title, _)` the fields `sender` and `title` are used in the return value but the `body` field is ignored with `_`. ## Pattern guards Pattern guards are simply boolean expressions which are used to make cases more specific. Just add `if ` after the pattern. @@ -88,7 +88,7 @@ Pattern guards are simply boolean expressions which are used to make cases more def showImportantNotification(notification: Notification, importantPeopleInfo: Seq[String]): String = { notification match { - case Email(email, _, _) if importantPeopleInfo.contains(email) => + case Email(sender, _, _) if importantPeopleInfo.contains(sender) => "You got an email from special someone!" case SMS(number, _) if importantPeopleInfo.contains(number) => "You got an SMS from special someone!" @@ -110,7 +110,7 @@ println(showImportantNotification(importantEmail, importantPeopleInfo)) println(showImportantNotification(importantSms, importantPeopleInfo)) ``` -In the `case Email(email, _, _) if importantPeopleInfo.contains(email)`, the pattern is matched only if the `email` is in the list of important people. +In the `case Email(sender, _, _) if importantPeopleInfo.contains(sender)`, the pattern is matched only if the `sender` is in the list of important people. ## Matching on type only You can match on the type like so: From 03df61186b2d78c3fa26cb6482c9f024030593da Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 22 Apr 2019 19:54:50 -0700 Subject: [PATCH 0455/3075] standardize CoC let's only have the text in one place --- CODE_OF_CONDUCT.md | 81 +++------------------------------------------- 1 file changed, 5 insertions(+), 76 deletions(-) diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 948de8e719..0511f2126d 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -1,78 +1,7 @@ -## Scala Code of Conduct +all repositories in these organizations: -We are committed to providing a friendly, safe and welcoming environment for -all, regardless of level of experience, gender, gender identity and expression, -sexual orientation, disability, personal appearance, body size, race, ethnicity, -age, religion, nationality, or other such characteristics. +* [scala](https://github.com/scala) +* [scalacenter](https://github.com/scalacenter) +* [lampepfl](https://github.com/lampepfl) -### Our Standards - -**Whether you’re a regular contributor or a newcomer, we care about making this community a welcoming and safe place for you and we’ve got your back.** - -As a member of the community, you agree to the following: - -**Encouraged:** - -- Be kind and courteous. -- Respect differences of opinion and remember that every design or implementation choice carries a trade-off and numerous costs. There is seldom a single right answer. -- Remember that everyone was new to Scala at some point. We want to encourage newcomers to join our community and learn the Scala language and ecosystem. Assume competence. -- Show empathy towards other community members. - -**Discouraged:** - -- Keep unstructured critique to a minimum. We encourage sharing ideas and perspectives, so please ensure that your feedback is constructive and relevant. If you have solid ideas you want to experiment with, make a fork and see how it works. -- Avoid aggressive and micro-aggressive behavior, such as unconstructive criticism, providing corrections that do not improve the conversation (sometimes referred to as "well actually"s), repeatedly interrupting or talking over someone else, feigning surprise at someone’s lack of knowledge or awareness about a topic, or subtle prejudice (for example, comments like “That’s so easy my grandmother could do it.”). For more examples of this kind of behavior, [see the Recurse Center's user manual](https://www.recurse.com/manual#sec-environment). -- We will exclude you from interaction if you insult, demean or harass anyone. The term “Harassment” includes “Unacceptable Behavior” described in the [Citizen Code of Conduct](http://citizencodeofconduct.org/). **In particular, we don’t tolerate behavior that excludes people in socially marginalized groups.** -- Private harassment is also unacceptable. No matter who you are, if you feel you have been or are being harassed or made uncomfortable by a community member's behavior, please contact one of the [moderators](https://contributors.scala-lang.org/about) or any member of the [Scala Center](http://scala.epfl.ch/) immediately. -- Likewise any spamming, trolling, flaming, baiting or other attention-stealing behaviour is not welcome. - -### Moderation - -These are the policies for upholding our community’s standards of conduct. If -you feel that a thread needs moderation, please contact anyone on the -[moderation team](https://contributors.scala-lang.org/about), or any employee of -the [Scala Center](https://scala.epfl.ch/). - -- Remarks that violate the above code of conduct, including hateful, hurtful, oppressive, or exclusionary remarks, are not allowed. (Cursing is allowed, but never targeting another user, and never in a hateful manner.) -- Moderators will warn users who make remarks inconsistent with the above code of conduct. -- If the warning is unheeded, the user will be “kicked,” i.e., kicked out of the communication channel to cool off. -- If the user comes back and continues to make trouble, they will be banned, i.e., indefinitely excluded. -- Moderators may choose at their discretion to un-ban the user if it was a first offense and they if they make suitable amends with the offended party. -- If you think a ban is unjustified, please take it up with that moderator, or with a different moderator, in private. Complaints about bans in-channel are not allowed. -- Moderators are held to a higher standard than other community members. If a moderator acts inappropriately, they should expect less leeway than others. - -In the Scala community we strive to go the extra step to look out for each -other. Don’t just aim to be technically unimpeachable; try to be your best self. -In particular, avoid exacerbating offensive or sensitive issues, particularly if -they’re off-topic; this all too often leads to unnecessary fights, hurt -feelings, and damaged trust; worse, it can drive people away from the community -entirely. - -If someone takes issue with something you said or did, resist the urge to be -defensive. Rather, stop the offending behavior, apologize, and be sensitive -thereafter. Even if you feel you were misinterpreted or unfairly accused, -chances are good there was something you could’ve communicated better — remember -that it’s your responsibility to make your fellow Scala developers comfortable. -We are all here first and foremost because we want to talk about cool -technology, and everyone wants to get along in doing so. People are generally -eager to assume good intent and forgive. - -### Domain - -The enforcement policies listed above apply to all official Scala channels: -mailing lists, GitHub repositories and Gitter channels under scala and -scalacenter, Discourse, and Scala Center venues and hackathons. For other -projects adopting the Scala Code of Conduct, please contact the maintainers of -those projects for enforcement. If you wish to use this code of conduct for your -own project, consider explicitly mentioning your moderation policy or making a -copy with your own moderation policy so as to avoid confusion. - -### Credits - -Adapted from and/or inspired by multiple successful Codes of Conduct, including: - -* [Rust Code of Conduct](https://www.rust-lang.org/en-US/conduct.html) -* [The Node.js Policy on Trolling](http://blog.izs.me/post/30036893703/policy-on-trolling) -* [The Contributor Covenant v1.4.0](http://contributor-covenant.org/version/1/4/) -* [The Recurse Center's User Manual](https://www.recurse.com/manual#sec-environment) -* [The 18F Code of Conduct](https://18f.gsa.gov/code-of-conduct/) \ No newline at end of file +are covered by the Scala Code of Conduct: https://scala-lang.org/conduct/ From e1156e6a824aa59a127e02b12ad09705b069a43e Mon Sep 17 00:00:00 2001 From: Lukas Rytz Date: Fri, 26 Apr 2019 11:23:17 +0200 Subject: [PATCH 0456/3075] Copy the strawman FAQ to collections-migration-213 --- _data/overviews.yml | 5 + _overviews/core/collections-migration-213.md | 330 +++++++++++++++++++ 2 files changed, 335 insertions(+) create mode 100644 _overviews/core/collections-migration-213.md diff --git a/_data/overviews.yml b/_data/overviews.yml index 8318194013..0b5470023e 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -82,6 +82,11 @@ url: "collections-2.13/creating-collections-from-scratch.html" - title: Conversions Between Java and Scala Collections url: "collections-2.13/conversions-between-java-and-scala-collections.html" + - title: Migrating a Project to Scala 2.13's Collections + icon: sitemap + url: "core/collections-migration-213.html" + description: "This page describes the main changes for collection users that migrate to Scala + 2.13 and shows how to cross-build projects with Scala 2.11 / 2.12 and 2.13." - title: The Architecture of Scala 2.13’s Collections icon: sitemap url: "core/architecture-of-scala-213-collections.html" diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md new file mode 100644 index 0000000000..64ad70dc07 --- /dev/null +++ b/_overviews/core/collections-migration-213.md @@ -0,0 +1,330 @@ +--- +layout: singlepage-overview +title: Migrating a Project to Scala 2.13's Collections +permalink: /overviews/core/:title.html +--- + +This document describes the main changes for collection users that migrate to Scala 2.13 and shows +how to cross-build projects with Scala 2.11 / 2.12 and 2.13. + +For an in-depth overview of the Scala 2.13 collections library, see the [collections guide]({{ site.baseurl }}/overviews/collections-2.13/introduction.html). The implementation details of the 2.13 collections are explained in the document [the architecture of Scala collections]({{ site.baseurl }}/overviews/core/architecture-of-scala-213-collections.html). + +## What are the major changes? + +See the list at the top of the [2.13.0-M4 release notes](https://github.com/scala/scala/releases/tag/v2.13.0-M4). + +## What are the breaking changes? + +The following table summarizes the breaking changes: + +| Description | Old Code | New Code | Automatic Migration Rule | +| ----------- | -------- | -------- | ------------------------ | +| Method `to[C[_]]` has been removed (it might be reintroduced but deprecated, though) | `xs.to[List]` | `xs.to(List)` | `NewCollections`, `CrossCompat` | +| `mutable.Map` no longer have an `updated` method | `mutable.Map(1 -> 2).updated(1, 3)` | `mutable.Map(1 -> 2).clone() += 1 -> 3` | `NewCollections`, `CrossCompat` | +| `mapValues` and `filterKeys` now return a `MapView` instead of a `Map` | `kvs.mapValues(f)` | `kvs.mapValues(f).toMap` | `RoughlyMapValues` | +| `Iterable` no longer has a `sameElements` operation | `xs1.sameElements(xs2)` | `xs1.iterator.sameElements(xs2)` | `NewCollections`, `CrossCompat` | +| `collection.breakOut` no longer exists | `val xs: List[Int] = ys.map(f)(collection.breakOut)` | `val xs = ys.iterator.map(f).to(List)` | `NewCollections` | +| `zip` on `Map[K, V]` now returns an `Iterable` | `map.zip(iterable)` | `map.zip(iterable).toMap` | `Experimental` | +| `ArrayBuilder.make` does not accept parens anymore | `ArrayBuilder.make[Int]()` | `ArrayBuilder.make[Int]` | `NewCollections`, `CrossCompat` | + +The “Automatic Migration Rule” column gives the name of the migration rule that can be used to automatically update old code to the new expected form. See https://github.com/scala/scala-collection-compat/ for more +details on how to use it. + +Some classes have been removed, made private or have no equivalent in the new design: + +- `ArrayStack`, +- `mutable.FlatHashTable`, +- `mutable.HashTable`, +- `History`, +- `Immutable`, +- `IndexedSeqOptimized`, +- `LazyBuilder`, +- `mutable.LinearSeq`, +- `LinkedEntry`, +- `MapBuilder`, +- `Mutable`, +- `MutableList`, +- `Publisher`, +- `ResizableArray`, +- `RevertibleHistory`, +- `SeqForwarder`, +- `SetBuilder`, +- `Sizing`, +- `SliceInterval`, +- `StackBuilder`, +- `StreamView`, +- `Subscriber`, +- `Undoable`, +- `WrappedArrayBuilder`. + +Other notable changes are: + + - `Iterable.partition` invokes `iterator` twice on non-strict collections and assumes it gets two iterators over the same elements. Strict subclasses override `partition` do perform only a single traversal + - `scala.Seq[+A]` is now `scala.collection.immutable.Seq[A]` (this also affects varargs methods). + - Equality between collections is not anymore defined at the level of `Iterable`. It is defined separately in the `Set`, `Seq` and `Map` branches. Another consequence is that `Iterable` does not anymore have a `canEqual` method. + - The new collections makes more use of overloading. You can find more information about the motivation + behind this choice [here](http://scala-lang.org/blog/2017/05/30/tribulations-canbuildfrom.html). For instance, `Map.map` is overloaded: + + scala> Map(1 -> "a").map + def map[B](f: ((Int, String)) => B): scala.collection.immutable.Iterable[B] + def map[K2, V2](f: ((Int, String)) => (K2, V2)): scala.collection.immutable.Map[K2,V2] + + Type inference has been improved so that `Map(1 -> "a").map(x => (x._1 + 1, x._2))` works, the compiler can infer the parameter type for the function literal. However, using a method reference in 2.13.0-M4 (improvement are on the way for 2.13.0) does not work, and an explicit eta-expansion is necessary: + + scala> def f(t: (Int, String)) = (t._1 + 1, t._2) + scala> Map(1 -> "a").map(f) + ^ + error: missing argument list for method f + Unapplied methods are only converted to functions when a function type is expected. + You can make this conversion explicit by writing `f _` or `f(_)` instead of `f`. + scala> Map(1 -> "a").map(f _) + res10: scala.collection.immutable.Map[Int,String] = ChampHashMap(2 -> a) + - `View`s have been completely redesigned and we expect their usage to have a more predictable evaluation model. + You can read more about the new design [here](http://scala-lang.org/blog/2017/11/28/view-based-collections.html). + - `mutable.ArraySeq` (which wraps an `Array[AnyRef]` in 2.12, meaning that primitives were boxed in the array) can now wrap boxed and unboxed arrays. `mutable.ArraySeq` in 2.13 is in fact equivalent to `WrappedArray` in 2.12, there are specialized subclasses for primitive arrays. Note that a `mutable.ArraySeq` can be used either way for primitive arrays (TODO: document how). `WrappedArray` is deprecated. + - There is no “default” `Factory` (previously known as `[A, C] => CanBuildFrom[Nothing, A, C]`): use `Factory[A, Vector[A]]` explicitly instead. + +## Breaking changes with old syntax still supported + +The following table lists the changes that continue to work with a deprecation warning. + +| Description | Old Code | New Code | Automatic Migration Rule | +| ----------- | -------- | -------- | ------------------------ | +| `collection.Set/Map` no longer have `+` and `-` operations | `xs + 1 - 2` | `xs ++ Set(1) -- Set(2)` | `Experimental` | +| `collection.Map` no longer have `--` operation | `map -- keys` | `map.to(immutable.Map) -- keys` | | +| `immutable.Set/Map`: the `+` operation no longer has an overload accepting multiple values | `Set(1) + (2, 3)` | `Set(1) + 2 + 3` | `NewCollections`, `CrossCompat` | +| `mutable.Set/Map` no longer have a `+` operation | `mutable.Set(1) + 2` | `mutable.Set(1).clone() += 2` | `NewCollections`, `CrossCompat` | +| `SortedSet`: the `to`, `until` and `from` methods are now called `rangeTo`, `rangeUntil` and `rangeFrom`, respectively | `xs.until(42)` | `xs.rangeUntil(42)` | | +| `Traversable` and `TraversableOnce` are replaced with `Iterable` and `IterableOnce`, respectively | `def f(xs: Traversable[Int]): Unit` | `def f(xs: Iterable[Int]): Unit` | `NewCollections`, `CrossCompat` | +| `Stream` is replaced with `LazyList` | `Stream.from(1)` | `LazyList.from(1)` | `RoughlyStreamToLazyList` | +| `Seq#union` is replaced with `concat` | `xs.union(ys)` | `xs.concat(ys)` | | +| `Stream#append` is replaced with `lazyAppendAll` | `xs.append(ys)` | `xs.lazyAppendedAll(ys)` | `NewCollections`, `CrossCompat` | +| `IterableOnce#toIterator` is replaced with `IterableOnce#iterator` | `xs.toIterator` | `xs.iterator` | `NewCollections`, `CrossCompat` | +| `copyToBuffer` has been deprecated | `xs.copyToBuffer(buffer)` | `buffer ++= xs` | `NewCollections`, `CrossCompat` | +| `TupleNZipped` has been replaced with `LazyZipN` | `(xs, ys).zipped` | `xs.lazyZip(ys)` | `NewCollections` | +| `retain` has been renamed to `filterInPlace` | `xs.retain(f)` | `xs.filterInPlace(f.tupled)` | `NewCollections` | +| `:/` and `/:` operators have been deprecated | `(xs :\ y)(f)` | `xs.foldRight(y)(f)` | `NewCollections`, `CrossCompat` | +| `companion` operation has been renamed to `iterableFactory` | `xs.companion` | `xs.iterableFactory` | | + +## Deprecated things in 2.12 that have been removed in 2.13 + +- `collection.convert.JavaConversions`. Use `collection.convert.JavaConverters` instead ; +- `collection.mutable.MutableList` (was not deprecated in 2.12 but was considered to be an implementation detail for implementing other collections). Use an `ArrayDeque` instead, or a `List` and a `var` ; +- `collection.immutable.Stack`. Use a `List` instead ; +- `StackProxy`, `MapProxy`, `SetProxy`, `SeqProxy`, etc. No replacement ; +- `SynchronizedMap`, `SynchronizedBuffer`, etc. Use `java.util.concurrent` instead ; + +## Are there new collection types? + +`scala.collection.immutable.ArraySeq` is an immutable sequence backed by an array. It is used to pass varargs parameters. + +The [`scala-collection-contrib`](https://github.com/scala/scala-collection-contrib) module provides decorators enriching the collections with new operations. You can +think of this artifact as an incubator: if we get evidence that these operations should be part of the core, +we might eventually move them. + +The following collections are provided: + +- `MultiSet` (both mutable and immutable) +- `SortedMultiSet` (both mutable and immutable) +- `MultiDict` (both mutable and immutable) +- `SortedMultiDict` (both mutable and immutable) + +## Are there new operations on collections? + +The following new partitioning operations are available: + +~~~ scala +def groupMap[K, B](key: A => K)(f: A => B): Map[K, CC[B]] // (Where `CC` can be `List`, for instance) +def groupMapReduce[K, B](key: A => K)(f: A => B)(g: (B, B) => B): Map[K, B] +~~~ + +`groupMap` is equivalent to `groupBy(key).mapValues(_.map(f))`. + +`groupMapReduce` is equivalent to `groupBy(key).mapValues(_.map(f).reduce(g))`. + +Mutable collections now have transformation operations that modify the collection in place: + +~~~ scala +def mapInPlace(f: A => A): this.type +def flatMapInPlace(f: A => IterableOnce[A]): this.type +def filterInPlace(p: A => Boolean): this.type +def patchInPlace(from: Int, patch: scala.collection.Seq[A], replaced: Int): this.type +~~~ + +Another new operation is `distinctBy`: + +~~~ scala +def distinctBy[B](f: A => B): C // (Where `C` can be `List[Int]`, for instance) +~~~ + +Last, additional operations are provided by the `scala-collection-contrib` module. You can +think of this artifact as an incubator: if we get evidence that these operations should be part of the core, +we might eventually move them. + +The new operations are provided via an implicit enrichment. You need to add the following import to make them +available: + +~~~ scala +import strawman.collection.decorators._ +~~~ + +The following operations are provided: + +- `Seq` + - `intersperse` +- `Map` + - `zipByKey` / `join` / `zipByKeyWith` + - `mergeByKey` / `fullOuterJoin` / `mergeByKeyWith` / `leftOuterJoin` / `rightOuterJoin` + +## Are there new implementations of existing collection types (changes in performance characteristics)? + +The default `Set` and `Map` are backed by a `ChampHashSet` and a `ChampHashMap`, respectively. The performance characteristics are the same but the +operation implementations are faster. These data structures also have a lower memory footprint. + +`mutable.Queue` and `mutable.Stack` now use `mutable.ArrayDeque`. This data structure supports constant time index access, and amortized constant time +insert and remove operations. + +## How do I cross-build my project against Scala 2.12 and Scala 2.13? + +Most usages of collections are compatible and can cross-compile 2.12 and 2.13 (at the cost of some warnings, sometimes). + +If you cannot get your code to cross-compile, there are various solutions: + - You can maintain a separate branch with the changes for 2.13 and publish releases for 2.13 from this branch. + - You can put source files that don't cross-compile in separate directories and configure sbt to assemble the sources according to the Scala version (see also the examples below): + + // Adds a `src/main/scala-2.13+` source directory for Scala 2.13 and newer + // and a `src/main/scala-2.13-` source directory for Scala version older than 2.13 + unmanagedSourceDirectories in Compile += { + val sourceDir = (sourceDirectory in Compile).value + CrossVersion.partialVersion(scalaVersion.value) match { + case Some((2, n)) if n >= 13 => sourceDir / "scala-2.13+" + case _ => sourceDir / "scala-2.13-" + } + } + + - You can use the [`scala-collection-compat`](https://github.com/scala/scala-collection-compat) library, which makes some of 2.13's APIs available to 2.11 and 2.12. This solution does not always work, for example if your library implements custom collection types. + +Note that the `scala-collection-compat` library has not fully stabilized yet. We expect that new, binary incompatible versions of this library will be published (for 2.11, 2.12) until Scala 2.13 is getting close to its final state. Therefore you might want to avoid adding a dependency on that library to your 2.11 / 2.12 artifacts for the time being. + +Examples of libraries that cross-compile with separate source directories: + - https://github.com/scala/scala-parser-combinators/pull/152 + - https://github.com/scala/scala-xml/pull/222 + - Some other examples are listed here: https://github.com/scala/community-builds/issues/710 + +# Collection Implementers + +## `CanBuildFrom` no longer exists - what were its uses and how can they be replaced? + +`CanBuildFrom` was used to: + - generically implement transformation operations whose return type could + vary according to the type of collection elements (ie mapping a `Char` to a `Char` in a `String` + returns a `String`, but mapping a `Char` to an `Int` returns a `IndexedSeq[Int]`), + - abstract over the arity of collection type constructors (ie `List[_]` vs `Map[_, _]`), + - abstract over implicit parameters required to perform a transformation operations (ie mapping an `A` to a `B` in `SortedSet[A]` + requires an implicit `Ordering[B]` to return a `SortedSet[B]`), + - provide type-driven builders to implement generic transformation methods (eg `Future.traverse`). + +The first three points are now handled using overloading. This means that `Map[K, V]` has two overloads of `map`, +one that takes a `(K, V) => (K', V')` mapping function and returns a `Map[K', V']`, and one that takes a +`(K, V) => A` mapping function and returns an `Iterable[A]`. + +You can find more information about the design [here](http://scala-lang.org/blog/2017/05/30/tribulations-canbuildfrom.html). + +To address the last point, there is a `BuildFrom` typeclass that works exactly like the former `CanBuildFrom`. See the next section +for examples of use. + +## How can I write generic extension methods? + +Depending on the level of desired genericity, several solutions can apply, with different complexity. + +### Write an operation that can consume any collection + +Take an `IterableOnce[A]` as parameter, or an `Iterable[A]` if you need more than one +traversals: + +~~~ scala +implicit class SumByOperation[A](coll: IterableOnce[A]) { + def sumBy[B](f: A => B)(implicit num: Numeric[B]): B = { + val it = coll.iterator + var result = f(it.next()) + while (it.hasNext()) { + result = num.plus(result, it.next()) + } + result + } +} +~~~ + +### Write an operation that returns another collection + +Use `BuildFrom`: + +~~~ scala +def optionSequence[CC[X] <: Iterable[X], A, To](xs: CC[Option[A]])(implicit bf: BuildFrom[CC[Option[A]], A, To]): Option[To] = + xs.foldLeft[Option[Builder[A, To]]](Some(bf.newBuilder(xs))) { + case (Some(builder), Some(a)) => Some(builder += a) + case _ => None + }.map(_.result()) +~~~ + +The `optionSequence` operation can be used on any collection (but not on an `Array` or a `String`): + +~~~ +scala> optionSequence(List[Option[Int]](Some(1), Some(2), Some(3))) +res1: Option[List[Int]] = Some(List(1, 2, 3)) + +scala> optionSequence(Set[Option[(Int, String)]](Some(1 -> "foo"), Some(2 -> "bar")))(TreeMap) // Force the result type +res4: Option[scala.collection.immutable.TreeMap[Int,String]] = Some(TreeMap(1 -> foo, 2 -> bar)) +~~~ + +### Write an operation that can also be applied to a `View`, an `Array` or `String` + +For more advanced cases, or if your operation should also work with `Array`s, `String`s and `View`s, +the pattern given in the previous section is not enough. + +The [`scala-collection-contrib`](https://github.com/scala/scala-collection-contrib) module +provides a more advanced machinery that handles that: + +~~~ scala +class IntersperseOperation[C, S <: HasSeqOps[C]](coll: C)(implicit val seq: S) { + def intersperse[B >: seq.A, That](sep: B)(implicit bf: BuildFrom[C, B, That]): That = + bf.fromSpecificIterable(coll)(new View.Intersperse(seq(coll), sep)) // (Assume that there is a `View.Intersperse` implemented somewhere) +} + +implicit def IntersperseOperation[C](coll: C)(implicit seq: HasSeqOps[C]): SeqDecorator[C, seq.type] = + new IntersperseOperation(coll)(seq) +~~~ + +This pattern makes the `intersperse` operation available to any `Seq` _like_ type (eg. a `SeqView`, an `Array` or a `String`). + +## How do I integrate my collection in the new design? + +See the [online documentation](https://docs.scala-lang.org/overviews/core/custom-collections.html) + +The API of the template traits has changed: +- they used to be suffixed by “Like” (e.g. `SeqLike`), whereas they are now suffixed by “Ops” (e.g. `SeqOps`), +- they used to abstract over the collection type of transformation operations, they now abstract over both + the collection type and the collection type constructor: `SeqLike[+A, +Repr]` has been replaced with + `SeqOps[+A, +CC[_], +C]`. + +## Which methods should I overload to support the “same result type” principle? + +You want to add overloads to specialize a transformation operations such that they return a more specific result. Examples are: +- `map`, on `StringOps`, when the mapping function returns a `Char`, should return a `String` (instead of an `IndexedSeq`), +- `map`, on `Map`, when the mapping function returns a pair, should return a `Map` (instead of an `Iterable`), +- `map`, on `SortedSet`, when an implicit `Ordering` is available for the resulting element type, should return a +`SortedSet` (instead of a `Set`). + +The following table lists transformation operations that might return a too wide type. You might want to overload +these operations to return a more specific type. + + Collection | Operations +---------------|-------------- +`Iterable` | `map`, `flatMap`, `collect`, `scanLeft`, `scanRight`, `groupMap`, `concat`, `zip`, `zipWithIndex`, `zipAll`, `unzip` +`Seq` | `prepended`, `appended`, `prependedAll`, `appendedAll`, `padTo`, `patch` +`immutable.Seq`| `updated` +`SortedSet` | `map`, `flatMap`, `collect`, `zip` +`Map` | `map`, `flatMap`, `collect`, `concat` +`immutable.Map`| `updated`, `transform` +`SortedMap` | `map`, `flatMap`, `collect`, `concat` +`immutable.SortedMap` | `updated` From fb973a8c3c8dd25f2eaf29151a5c6a34b7bbb6c9 Mon Sep 17 00:00:00 2001 From: Lukas Rytz Date: Fri, 26 Apr 2019 11:26:07 +0200 Subject: [PATCH 0457/3075] minor typos --- _overviews/core/collections-migration-213.md | 52 ++++++++++---------- 1 file changed, 26 insertions(+), 26 deletions(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 64ad70dc07..0e130c677a 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -27,35 +27,35 @@ The following table summarizes the breaking changes: | `zip` on `Map[K, V]` now returns an `Iterable` | `map.zip(iterable)` | `map.zip(iterable).toMap` | `Experimental` | | `ArrayBuilder.make` does not accept parens anymore | `ArrayBuilder.make[Int]()` | `ArrayBuilder.make[Int]` | `NewCollections`, `CrossCompat` | -The “Automatic Migration Rule” column gives the name of the migration rule that can be used to automatically update old code to the new expected form. See https://github.com/scala/scala-collection-compat/ for more +The “Automatic Migration Rule” column gives the name of the migration rule that can be used to automatically update old code to the new expected form. See [scala-collection-compat](https://github.com/scala/scala-collection-compat) for more details on how to use it. Some classes have been removed, made private or have no equivalent in the new design: -- `ArrayStack`, -- `mutable.FlatHashTable`, -- `mutable.HashTable`, -- `History`, -- `Immutable`, -- `IndexedSeqOptimized`, -- `LazyBuilder`, -- `mutable.LinearSeq`, -- `LinkedEntry`, -- `MapBuilder`, -- `Mutable`, -- `MutableList`, -- `Publisher`, -- `ResizableArray`, -- `RevertibleHistory`, -- `SeqForwarder`, -- `SetBuilder`, -- `Sizing`, -- `SliceInterval`, -- `StackBuilder`, -- `StreamView`, -- `Subscriber`, -- `Undoable`, -- `WrappedArrayBuilder`. +- `ArrayStack` +- `mutable.FlatHashTable` +- `mutable.HashTable` +- `History` +- `Immutable` +- `IndexedSeqOptimized` +- `LazyBuilder` +- `mutable.LinearSeq` +- `LinkedEntry` +- `MapBuilder` +- `Mutable` +- `MutableList` +- `Publisher` +- `ResizableArray` +- `RevertibleHistory` +- `SeqForwarder` +- `SetBuilder` +- `Sizing` +- `SliceInterval` +- `StackBuilder` +- `StreamView` +- `Subscriber` +- `Undoable` +- `WrappedArrayBuilder` Other notable changes are: @@ -299,7 +299,7 @@ This pattern makes the `intersperse` operation available to any `Seq` _like_ typ ## How do I integrate my collection in the new design? -See the [online documentation](https://docs.scala-lang.org/overviews/core/custom-collections.html) +See the [online documentation]({{ site.baseurl }}/overviews/core/custom-collections.html) The API of the template traits has changed: - they used to be suffixed by “Like” (e.g. `SeqLike`), whereas they are now suffixed by “Ops” (e.g. `SeqOps`), From a68cd1b802acf5c1df0f7e9b5cbb78d0223c9ef4 Mon Sep 17 00:00:00 2001 From: Lukas Rytz Date: Mon, 29 Apr 2019 11:59:00 +0200 Subject: [PATCH 0458/3075] review feedback --- _overviews/core/collections-migration-213.md | 188 +++++-------------- 1 file changed, 44 insertions(+), 144 deletions(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 0e130c677a..10bcb21dbf 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -9,26 +9,39 @@ how to cross-build projects with Scala 2.11 / 2.12 and 2.13. For an in-depth overview of the Scala 2.13 collections library, see the [collections guide]({{ site.baseurl }}/overviews/collections-2.13/introduction.html). The implementation details of the 2.13 collections are explained in the document [the architecture of Scala collections]({{ site.baseurl }}/overviews/core/architecture-of-scala-213-collections.html). -## What are the major changes? - -See the list at the top of the [2.13.0-M4 release notes](https://github.com/scala/scala/releases/tag/v2.13.0-M4). +The most important changes in the Scala 2.13 collections library are: + - Transformation methods no longer have an implicit `CanBuildFrom` parameter. This makes the library easier to understand (in source code, Scaladoc, and IDE code completion). It also makes compiling user code more efficient. + - The type hierarchy is simplified. `Traversable` no longer exists, only `Iterable`. + - The `to[Collection]` method was replaced by the `to(Collection)` method. + - Views have been vastly simplified and work reliably now. They no longer extend their corresponding collection type, for example, an `IndexedSeqView` no longer extends `IndexedSeq`. + - `collection.breakOut` no longer exists, use `.view` and `.to(Collection)` instead. + - Immutable hash sets and hash maps have a new implementation (`ChampHashSet` and `ChampHashMap`, based on the ["CHAMP" encoding](https://michael.steindorfer.name/publications/oopsla15.pdf)). + - New collection types: + - `immutable.ArraySeq` is an effectively immutable sequence that wraps an array + - `immutable.LazyList` is a linked list that is lazy in its state, i.e., whether it's empty or non-empty. This allows creating a `LazyList` without evaluating the `head` element. `immutable.Stream`, which has a strict `head` and a lazy `tail`, is deprecated. + - Deprecated collections were removed (`MutableList`, `immutable.Stack`, others) + - Parallel collections are now in a separate hierarchy in a [separate module](https://github.com/scala/scala-parallel-collections). + - The `scala.jdk.StreamConverters` object provides extension methods to create (sequential or parallel) Java 8 streams for Scala collections. + - `scala.Seq` is now an alias for `scala.collection.immutable.Seq` (no longer `scala.collection.Seq`). Note that this also changes the type of Scala varargs methods. + +## Tools for migrating and cross-building + +The [scala-collection-compat](https://github.com/scala/scala-collection-compat) is a library released for 2.11, 2.12 and 2.13 that provides some of the new APIs from Scala 2.13 for the older versions. This simplifies cross-building projects. + +The module also provides [migratrion rules](https://github.com/scala/scala-collection-compat#migration-tool) for [scalafix](https://scalacenter.github.io/scalafix/docs/users/installation.html) that can update a project's source code to work with the 2.13 collections library. ## What are the breaking changes? -The following table summarizes the breaking changes: +The following table summarizes the breaking changes. The "Automatic Migration Rule" column gives the name of the migration rule that can be used to automatically update old code to the new expected form. | Description | Old Code | New Code | Automatic Migration Rule | | ----------- | -------- | -------- | ------------------------ | -| Method `to[C[_]]` has been removed (it might be reintroduced but deprecated, though) | `xs.to[List]` | `xs.to(List)` | `NewCollections`, `CrossCompat` | -| `mutable.Map` no longer have an `updated` method | `mutable.Map(1 -> 2).updated(1, 3)` | `mutable.Map(1 -> 2).clone() += 1 -> 3` | `NewCollections`, `CrossCompat` | +| Method `to[C[_]]` has been removed (it might be reintroduced but deprecated, though) | `xs.to[List]` | `xs.to(List)` | `Collection213Upgrade`, `Collections213CrossCompat` | | `mapValues` and `filterKeys` now return a `MapView` instead of a `Map` | `kvs.mapValues(f)` | `kvs.mapValues(f).toMap` | `RoughlyMapValues` | -| `Iterable` no longer has a `sameElements` operation | `xs1.sameElements(xs2)` | `xs1.iterator.sameElements(xs2)` | `NewCollections`, `CrossCompat` | -| `collection.breakOut` no longer exists | `val xs: List[Int] = ys.map(f)(collection.breakOut)` | `val xs = ys.iterator.map(f).to(List)` | `NewCollections` | -| `zip` on `Map[K, V]` now returns an `Iterable` | `map.zip(iterable)` | `map.zip(iterable).toMap` | `Experimental` | -| `ArrayBuilder.make` does not accept parens anymore | `ArrayBuilder.make[Int]()` | `ArrayBuilder.make[Int]` | `NewCollections`, `CrossCompat` | - -The “Automatic Migration Rule” column gives the name of the migration rule that can be used to automatically update old code to the new expected form. See [scala-collection-compat](https://github.com/scala/scala-collection-compat) for more -details on how to use it. +| `Iterable` no longer has a `sameElements` operation | `xs1.sameElements(xs2)` | `xs1.iterator.sameElements(xs2)` | `Collection213Upgrade`, `Collections213CrossCompat` | +| `collection.breakOut` no longer exists | `val xs: List[Int] = ys.map(f)(collection.breakOut)` | `val xs = ys.iterator.map(f).to(List)` | `Collection213Upgrade` | +| `zip` on `Map[K, V]` now returns an `Iterable` | `map.zip(iterable)` | `map.zip(iterable).toMap` | `Collection213Experimental` | +| `ArrayBuilder.make` does not accept parens anymore | `ArrayBuilder.make[Int]()` | `ArrayBuilder.make[Int]` | `Collection213Upgrade`, `Collections213CrossCompat` | Some classes have been removed, made private or have no equivalent in the new design: @@ -82,7 +95,7 @@ Other notable changes are: - `View`s have been completely redesigned and we expect their usage to have a more predictable evaluation model. You can read more about the new design [here](http://scala-lang.org/blog/2017/11/28/view-based-collections.html). - `mutable.ArraySeq` (which wraps an `Array[AnyRef]` in 2.12, meaning that primitives were boxed in the array) can now wrap boxed and unboxed arrays. `mutable.ArraySeq` in 2.13 is in fact equivalent to `WrappedArray` in 2.12, there are specialized subclasses for primitive arrays. Note that a `mutable.ArraySeq` can be used either way for primitive arrays (TODO: document how). `WrappedArray` is deprecated. - - There is no “default” `Factory` (previously known as `[A, C] => CanBuildFrom[Nothing, A, C]`): use `Factory[A, Vector[A]]` explicitly instead. + - There is no "default" `Factory` (previously known as `[A, C] => CanBuildFrom[Nothing, A, C]`): use `Factory[A, Vector[A]]` explicitly instead. ## Breaking changes with old syntax still supported @@ -90,20 +103,21 @@ The following table lists the changes that continue to work with a deprecation w | Description | Old Code | New Code | Automatic Migration Rule | | ----------- | -------- | -------- | ------------------------ | -| `collection.Set/Map` no longer have `+` and `-` operations | `xs + 1 - 2` | `xs ++ Set(1) -- Set(2)` | `Experimental` | +| `collection.Set/Map` no longer have `+` and `-` operations | `xs + 1 - 2` | `xs ++ Set(1) -- Set(2)` | `Collection213Experimental` | | `collection.Map` no longer have `--` operation | `map -- keys` | `map.to(immutable.Map) -- keys` | | -| `immutable.Set/Map`: the `+` operation no longer has an overload accepting multiple values | `Set(1) + (2, 3)` | `Set(1) + 2 + 3` | `NewCollections`, `CrossCompat` | -| `mutable.Set/Map` no longer have a `+` operation | `mutable.Set(1) + 2` | `mutable.Set(1).clone() += 2` | `NewCollections`, `CrossCompat` | +| `immutable.Set/Map`: the `+` operation no longer has an overload accepting multiple values | `Set(1) + (2, 3)` | `Set(1) + 2 + 3` | `Collection213Upgrade`, `Collections213CrossCompat` | +| `mutable.Map` no longer have an `updated` method | `mutable.Map(1 -> 2).updated(1, 3)` | `mutable.Map(1 -> 2).clone() += 1 -> 3` | `Collection213Upgrade`, `Collections213CrossCompat` | +| `mutable.Set/Map` no longer have a `+` operation | `mutable.Set(1) + 2` | `mutable.Set(1).clone() += 2` | `Collection213Upgrade`, `Collections213CrossCompat` | | `SortedSet`: the `to`, `until` and `from` methods are now called `rangeTo`, `rangeUntil` and `rangeFrom`, respectively | `xs.until(42)` | `xs.rangeUntil(42)` | | -| `Traversable` and `TraversableOnce` are replaced with `Iterable` and `IterableOnce`, respectively | `def f(xs: Traversable[Int]): Unit` | `def f(xs: Iterable[Int]): Unit` | `NewCollections`, `CrossCompat` | -| `Stream` is replaced with `LazyList` | `Stream.from(1)` | `LazyList.from(1)` | `RoughlyStreamToLazyList` | +| `Traversable` and `TraversableOnce` are replaced with `Iterable` and `IterableOnce`, respectively | `def f(xs: Traversable[Int]): Unit` | `def f(xs: Iterable[Int]): Unit` | `Collection213Upgrade`, `Collections213CrossCompat` | +| `Stream` is replaced with `LazyList` | `Stream.from(1)` | `LazyList.from(1)` | `Collection213Roughly` | | `Seq#union` is replaced with `concat` | `xs.union(ys)` | `xs.concat(ys)` | | -| `Stream#append` is replaced with `lazyAppendAll` | `xs.append(ys)` | `xs.lazyAppendedAll(ys)` | `NewCollections`, `CrossCompat` | -| `IterableOnce#toIterator` is replaced with `IterableOnce#iterator` | `xs.toIterator` | `xs.iterator` | `NewCollections`, `CrossCompat` | -| `copyToBuffer` has been deprecated | `xs.copyToBuffer(buffer)` | `buffer ++= xs` | `NewCollections`, `CrossCompat` | -| `TupleNZipped` has been replaced with `LazyZipN` | `(xs, ys).zipped` | `xs.lazyZip(ys)` | `NewCollections` | -| `retain` has been renamed to `filterInPlace` | `xs.retain(f)` | `xs.filterInPlace(f.tupled)` | `NewCollections` | -| `:/` and `/:` operators have been deprecated | `(xs :\ y)(f)` | `xs.foldRight(y)(f)` | `NewCollections`, `CrossCompat` | +| `Stream#append` is replaced with `lazyAppendAll` | `xs.append(ys)` | `xs.lazyAppendedAll(ys)` | `Collection213Upgrade`, `Collections213CrossCompat` | +| `IterableOnce#toIterator` is replaced with `IterableOnce#iterator` | `xs.toIterator` | `xs.iterator` | `Collection213Upgrade`, `Collections213CrossCompat` | +| `copyToBuffer` has been deprecated | `xs.copyToBuffer(buffer)` | `buffer ++= xs` | `Collection213Upgrade`, `Collections213CrossCompat` | +| `TupleNZipped` has been replaced with `LazyZipN` | `(xs, ys).zipped` | `xs.lazyZip(ys)` | `Collection213Upgrade` | +| `retain` has been renamed to `filterInPlace` | `xs.retain(f)` | `xs.filterInPlace(f.tupled)` | `Collection213Upgrade` | +| `:/` and `/:` operators have been deprecated | `(xs :\ y)(f)` | `xs.foldRight(y)(f)` | `Collection213Upgrade`, `Collections213CrossCompat` | | `companion` operation has been renamed to `iterableFactory` | `xs.companion` | `xs.iterableFactory` | | ## Deprecated things in 2.12 that have been removed in 2.13 @@ -189,6 +203,7 @@ insert and remove operations. Most usages of collections are compatible and can cross-compile 2.12 and 2.13 (at the cost of some warnings, sometimes). If you cannot get your code to cross-compile, there are various solutions: + - You can use the [`scala-collection-compat`](https://github.com/scala/scala-collection-compat) library, which makes some of 2.13's APIs available to 2.11 and 2.12. This solution does not always work, for example if your library implements custom collection types. - You can maintain a separate branch with the changes for 2.13 and publish releases for 2.13 from this branch. - You can put source files that don't cross-compile in separate directories and configure sbt to assemble the sources according to the Scala version (see also the examples below): @@ -202,10 +217,6 @@ If you cannot get your code to cross-compile, there are various solutions: } } - - You can use the [`scala-collection-compat`](https://github.com/scala/scala-collection-compat) library, which makes some of 2.13's APIs available to 2.11 and 2.12. This solution does not always work, for example if your library implements custom collection types. - -Note that the `scala-collection-compat` library has not fully stabilized yet. We expect that new, binary incompatible versions of this library will be published (for 2.11, 2.12) until Scala 2.13 is getting close to its final state. Therefore you might want to avoid adding a dependency on that library to your 2.11 / 2.12 artifacts for the time being. - Examples of libraries that cross-compile with separate source directories: - https://github.com/scala/scala-parser-combinators/pull/152 - https://github.com/scala/scala-xml/pull/222 @@ -213,118 +224,7 @@ Examples of libraries that cross-compile with separate source directories: # Collection Implementers -## `CanBuildFrom` no longer exists - what were its uses and how can they be replaced? - -`CanBuildFrom` was used to: - - generically implement transformation operations whose return type could - vary according to the type of collection elements (ie mapping a `Char` to a `Char` in a `String` - returns a `String`, but mapping a `Char` to an `Int` returns a `IndexedSeq[Int]`), - - abstract over the arity of collection type constructors (ie `List[_]` vs `Map[_, _]`), - - abstract over implicit parameters required to perform a transformation operations (ie mapping an `A` to a `B` in `SortedSet[A]` - requires an implicit `Ordering[B]` to return a `SortedSet[B]`), - - provide type-driven builders to implement generic transformation methods (eg `Future.traverse`). - -The first three points are now handled using overloading. This means that `Map[K, V]` has two overloads of `map`, -one that takes a `(K, V) => (K', V')` mapping function and returns a `Map[K', V']`, and one that takes a -`(K, V) => A` mapping function and returns an `Iterable[A]`. - -You can find more information about the design [here](http://scala-lang.org/blog/2017/05/30/tribulations-canbuildfrom.html). - -To address the last point, there is a `BuildFrom` typeclass that works exactly like the former `CanBuildFrom`. See the next section -for examples of use. - -## How can I write generic extension methods? - -Depending on the level of desired genericity, several solutions can apply, with different complexity. - -### Write an operation that can consume any collection - -Take an `IterableOnce[A]` as parameter, or an `Iterable[A]` if you need more than one -traversals: - -~~~ scala -implicit class SumByOperation[A](coll: IterableOnce[A]) { - def sumBy[B](f: A => B)(implicit num: Numeric[B]): B = { - val it = coll.iterator - var result = f(it.next()) - while (it.hasNext()) { - result = num.plus(result, it.next()) - } - result - } -} -~~~ - -### Write an operation that returns another collection - -Use `BuildFrom`: - -~~~ scala -def optionSequence[CC[X] <: Iterable[X], A, To](xs: CC[Option[A]])(implicit bf: BuildFrom[CC[Option[A]], A, To]): Option[To] = - xs.foldLeft[Option[Builder[A, To]]](Some(bf.newBuilder(xs))) { - case (Some(builder), Some(a)) => Some(builder += a) - case _ => None - }.map(_.result()) -~~~ - -The `optionSequence` operation can be used on any collection (but not on an `Array` or a `String`): - -~~~ -scala> optionSequence(List[Option[Int]](Some(1), Some(2), Some(3))) -res1: Option[List[Int]] = Some(List(1, 2, 3)) - -scala> optionSequence(Set[Option[(Int, String)]](Some(1 -> "foo"), Some(2 -> "bar")))(TreeMap) // Force the result type -res4: Option[scala.collection.immutable.TreeMap[Int,String]] = Some(TreeMap(1 -> foo, 2 -> bar)) -~~~ - -### Write an operation that can also be applied to a `View`, an `Array` or `String` - -For more advanced cases, or if your operation should also work with `Array`s, `String`s and `View`s, -the pattern given in the previous section is not enough. - -The [`scala-collection-contrib`](https://github.com/scala/scala-collection-contrib) module -provides a more advanced machinery that handles that: - -~~~ scala -class IntersperseOperation[C, S <: HasSeqOps[C]](coll: C)(implicit val seq: S) { - def intersperse[B >: seq.A, That](sep: B)(implicit bf: BuildFrom[C, B, That]): That = - bf.fromSpecificIterable(coll)(new View.Intersperse(seq(coll), sep)) // (Assume that there is a `View.Intersperse` implemented somewhere) -} - -implicit def IntersperseOperation[C](coll: C)(implicit seq: HasSeqOps[C]): SeqDecorator[C, seq.type] = - new IntersperseOperation(coll)(seq) -~~~ - -This pattern makes the `intersperse` operation available to any `Seq` _like_ type (eg. a `SeqView`, an `Array` or a `String`). - -## How do I integrate my collection in the new design? - -See the [online documentation]({{ site.baseurl }}/overviews/core/custom-collections.html) - -The API of the template traits has changed: -- they used to be suffixed by “Like” (e.g. `SeqLike`), whereas they are now suffixed by “Ops” (e.g. `SeqOps`), -- they used to abstract over the collection type of transformation operations, they now abstract over both - the collection type and the collection type constructor: `SeqLike[+A, +Repr]` has been replaced with - `SeqOps[+A, +CC[_], +C]`. - -## Which methods should I overload to support the “same result type” principle? - -You want to add overloads to specialize a transformation operations such that they return a more specific result. Examples are: -- `map`, on `StringOps`, when the mapping function returns a `Char`, should return a `String` (instead of an `IndexedSeq`), -- `map`, on `Map`, when the mapping function returns a pair, should return a `Map` (instead of an `Iterable`), -- `map`, on `SortedSet`, when an implicit `Ordering` is available for the resulting element type, should return a -`SortedSet` (instead of a `Set`). - -The following table lists transformation operations that might return a too wide type. You might want to overload -these operations to return a more specific type. - - Collection | Operations ----------------|-------------- -`Iterable` | `map`, `flatMap`, `collect`, `scanLeft`, `scanRight`, `groupMap`, `concat`, `zip`, `zipWithIndex`, `zipAll`, `unzip` -`Seq` | `prepended`, `appended`, `prependedAll`, `appendedAll`, `padTo`, `patch` -`immutable.Seq`| `updated` -`SortedSet` | `map`, `flatMap`, `collect`, `zip` -`Map` | `map`, `flatMap`, `collect`, `concat` -`immutable.Map`| `updated`, `transform` -`SortedMap` | `map`, `flatMap`, `collect`, `concat` -`immutable.SortedMap` | `updated` +To learn about differences when implementing custom collection types or operations, see the following documents: + - [The architecture of Scala collections]({{ site.baseurl }}/overviews/core/architecture-of-scala-213-collections.html) + - [Implementing custom collections]({{ site.baseurl }}/overviews/core/custom-collections.html) + - [Adding custom collection operations]({{ site.baseurl }}/overviews/core/custom-collection-operations.html) \ No newline at end of file From a0fd98a7a236e213261d411daf010ed0cbdb43a3 Mon Sep 17 00:00:00 2001 From: Lukas Rytz Date: Mon, 29 Apr 2019 12:02:37 +0200 Subject: [PATCH 0459/3075] review feedback --- _overviews/core/collections-migration-213.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 10bcb21dbf..10f9d75e52 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -165,10 +165,11 @@ def filterInPlace(p: A => Boolean): this.type def patchInPlace(from: Int, patch: scala.collection.Seq[A], replaced: Int): this.type ~~~ -Another new operation is `distinctBy`: +Other new operations are `distinctBy` and `partitionMap` ~~~ scala -def distinctBy[B](f: A => B): C // (Where `C` can be `List[Int]`, for instance) +def distinctBy[B](f: A => B): C // `C` can be `List[Int]`, for instance +def partitionMap[A1, A2](f: A => Either[A1, A2]): (CC[A1], CC[A2]) // `CC` can be `List`, for instance ~~~ Last, additional operations are provided by the `scala-collection-contrib` module. You can From ba9ba4ad39cf0ebe08a8ab3e6e472ce93a6b488b Mon Sep 17 00:00:00 2001 From: Lukas Rytz Date: Mon, 29 Apr 2019 14:11:19 +0200 Subject: [PATCH 0460/3075] allow scrolling tables --- _overviews/core/collections-migration-213.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 10f9d75e52..f58bad8e9f 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -34,6 +34,8 @@ The module also provides [migratrion rules](https://github.com/scala/scala-colle The following table summarizes the breaking changes. The "Automatic Migration Rule" column gives the name of the migration rule that can be used to automatically update old code to the new expected form. +
+ | Description | Old Code | New Code | Automatic Migration Rule | | ----------- | -------- | -------- | ------------------------ | | Method `to[C[_]]` has been removed (it might be reintroduced but deprecated, though) | `xs.to[List]` | `xs.to(List)` | `Collection213Upgrade`, `Collections213CrossCompat` | @@ -43,6 +45,8 @@ The following table summarizes the breaking changes. The "Automatic Migration Ru | `zip` on `Map[K, V]` now returns an `Iterable` | `map.zip(iterable)` | `map.zip(iterable).toMap` | `Collection213Experimental` | | `ArrayBuilder.make` does not accept parens anymore | `ArrayBuilder.make[Int]()` | `ArrayBuilder.make[Int]` | `Collection213Upgrade`, `Collections213CrossCompat` | +
+ Some classes have been removed, made private or have no equivalent in the new design: - `ArrayStack` @@ -101,6 +105,8 @@ Other notable changes are: The following table lists the changes that continue to work with a deprecation warning. +
+ | Description | Old Code | New Code | Automatic Migration Rule | | ----------- | -------- | -------- | ------------------------ | | `collection.Set/Map` no longer have `+` and `-` operations | `xs + 1 - 2` | `xs ++ Set(1) -- Set(2)` | `Collection213Experimental` | @@ -119,7 +125,9 @@ The following table lists the changes that continue to work with a deprecation w | `retain` has been renamed to `filterInPlace` | `xs.retain(f)` | `xs.filterInPlace(f.tupled)` | `Collection213Upgrade` | | `:/` and `/:` operators have been deprecated | `(xs :\ y)(f)` | `xs.foldRight(y)(f)` | `Collection213Upgrade`, `Collections213CrossCompat` | | `companion` operation has been renamed to `iterableFactory` | `xs.companion` | `xs.iterableFactory` | | - + +
+ ## Deprecated things in 2.12 that have been removed in 2.13 - `collection.convert.JavaConversions`. Use `collection.convert.JavaConverters` instead ; From db7c58b57daf28e874b4fe01c0b2df3168aa875c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Tue, 30 Apr 2019 18:09:44 +0200 Subject: [PATCH 0461/3075] Fix the sentence that says how SIP committee members are elected. This is not a change of the actual process. We've always done it that way (or least as far as I've been in the committee). --- _sips/sip-submission.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_sips/sip-submission.md b/_sips/sip-submission.md index b40800b5d0..c30a4ae96c 100644 --- a/_sips/sip-submission.md +++ b/_sips/sip-submission.md @@ -190,8 +190,9 @@ Committee members should be either individuals responsible for a specific part of the Scala codebase, committers or contributors of the Scala compiler. Exceptionally, members may also be important representatives of the community with a high technical knowledge to understand the implications of every proposal -and participate into the discussions. The members are elected by the Process -Lead based on their expertise and implication in the community. +and participate into the discussions. New members are elected by existing +members of the SIP Committee, based on their expertise and involvement in the +community. The current committee members are: From ff6a56bab84958abc40fc5fb6cd86efb57e2f147 Mon Sep 17 00:00:00 2001 From: Gabriel Claramunt Date: Wed, 1 May 2019 12:57:26 -0300 Subject: [PATCH 0462/3075] Update basics.md --- _es/tour/basics.md | 288 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 288 insertions(+) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index bd86428a9b..78464b51d1 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -7,3 +7,291 @@ discourse: false partof: scala-tour language: es --- + +# Scala básico + + +## Expresiones + +En Scala todo es una expresión (cada sentencia "devuelve" un valor). + +```scala +1 + 1 +``` + +Se puede ver el resultado de evaluar expresiones usando println. + +```scala +println(1) // 1 +println(1 + 1) // 2 +println("Hello!") // Hello! +println("Hello," + " world!") // Hello, world! +``` + +## Valores + +Se puede nombrar el resultado de expresiones con la palabra clave *val*. + +```scala +val x = 1 + 1 +println(x) // 2 +``` + +Los resultados con nombre, como x en el ejemplo, son llamados *valores*. Referenciar un valor no lo vuelve a computar. + +Los valores no pueden ser reasignados. + +```scala +x = 3 // This does not compile. +``` + +Los tipos de los valores pueden ser inferidos, pero tambien se pueden anotar explicitamente de la siguiente forma: + +```scala +val x: Int = 1 + 1 +``` + +Noten como la declaración de tipo Int va después del identificador. + +## Variables + +Las variables son como los valores, excepto que no es posible re-asignarlos. Las variables se definen con la palabra clave *var*. + +```scala +var x = 1 + 1 +x = 3 // This compiles because "x" is declared with the "var" keyword. +println(x * x) // 9 +``` + +Igual que con los valores, si queremos se puede especificar el tipo: + +```scala +var x: Int = 1 + 1 +``` + +## Bloques + +Se pueden combinar expresiones rodeándolas con { y } . A esto le llamamos un *bloque*. + +El resultado de la ultima expresión del bloque es también el resultado total del bloque. + +```scala +println({ + val x = 1 + 1 + x + 1 +}) // 3 +``` + +## Funciones + +Las funciones son expresiones que reciben parámetros. + +Se pueden definir funciones anónimas, por ejemplo, una que retorne x + 1 para x entero: + +```scala +(x: Int) => x + 1 +``` + +A la izquierda de => esta la lista de parámetros. A la derecha esta el cuerpo de la función + +También podemos asignarle un nombre a la función. + +```scala +val addOne = (x: Int) => x + 1 +println(addOne(1)) // 2 +``` + +Las funciones pueden tomar muchos parámetros. + +```scala +val add = (x: Int, y: Int) => x + y +println(add(1, 2)) // 3 +``` + +O ninguno. + +```scala +val getTheAnswer = () => 42 +println(getTheAnswer()) // 42 +``` + + +## Métodos + +Los métodos se parecen y se comportan de forma muy similar a las funciones, pero hay un par de diferencias clave entre ellos. +Los métodos se definen con la palabra clave *def*, seguida por un nombre, una lista de parámetros, un tipo de retorno (opcional pero recomendado), y el cuerpo del método. + +```scala +def add(x: Int, y: Int): Int = x + y +println(add(1, 2)) // 3 +``` + +Notar como el tipo de retorno es declarado después de la lista de parámetros y con dos puntos. + +Los métodos pueden tener mutiles listas de parámetros. + +```scala +def addThenMultiply(x: Int, y: Int)(multiplier: Int): Int = (x + y) * multiplier +println(addThenMultiply(1, 2)(3)) // 9 +``` + +O ninguna. + +```scala +def name: String = System.getProperty("user.name") +println("Hello, " + name + "!") +``` + +Hay otras diferencias, pero para simplificar, podemos pensar que son similares a las funciones. + +Los métodos también pueden tener expresiones de varias lineas. + +```scala +def getSquareString(input: Double): String = { + val square = input * input + square.toString +} +``` + +La ultima expresión en el cuerpo del método es el valor de retorno del mismo. +(Scala tiene la palabra clave *return* pero no se usa y no hace lo que uds. piensan que hace) + +## Clases + +Se puede definir clases con la palabra clave *class* seguida del nombre y los parámetros del constructor. + +```scala +class Greeter(prefix: String, suffix: String) { + def greet(name: String): Unit = + println(prefix + name + suffix) +} +``` + +El tipo de retorno del método greet es Unit, que dice que no hay nada significativo que retornar. Se usa de forma similar al void de Java y C (con la diferencia de que como toda expresión en Scala debe retornar un valor, existe un valor singleton para el tipo Unit que se escribe `()` y no lleva información ) + +Puedes crear una instancia de una clase con la palabra clave *new*. + +```scala +val greeter = new Greeter("Hello, ", "!") +greeter.greet("Scala developer") // Hello, Scala developer! +``` + +Mas adelante, cubriremos las clases en profundidad. + +## Case Classes + +Scala tiene un tipo especial de clases llamadas "case" classes. Por defecto, las case classes son inmutables y son comparadas por valor. +Las case classes se definen usando las palabras clave *case class*. + +```scala +case class Point(x: Int, y: Int) +``` + +Se pueden instanciar sin necesidad de usar la palabra clave new. + +```scala +val point = Point(1, 2) +val anotherPoint = Point(1, 2) +val yetAnotherPoint = Point(2, 2) +``` + +Y son comparadas por valor. + +```scala +if (point == anotherPoint) { + println(point + " and " + anotherPoint + " are the same.") +} else { + println(point + " and " + anotherPoint + " are different.") +} // Point(1,2) and Point(1,2) are the same. + +if (point == yetAnotherPoint) { + println(point + " and " + yetAnotherPoint + " are the same.") +} else { + println(point + " and " + yetAnotherPoint + " are different.") +} // Point(1,2) and Point(2,2) are different. +``` + +Hay mucho mas sobre las case classes que queremos presentar, y estamos convencidos de que te vas a enamorar de ellas. Las cubriremos en profundidad mas adelante. + +## Objetos + +Los objetos son instancias de una sola clase de su propia definición. Puedes pensar en ellos como singleton de sus propias clases + +Puedes definir objectos con la palabra clave *object*. + +```scala +object IdFactory { + private var counter = 0 + def create(): Int = { + counter += 1 + counter + } +} +``` + +Para acceder al objeto, lo referencias por su nombre. + +```scala +val newId: Int = IdFactory.create() +println(newId) // 1 +val newerId: Int = IdFactory.create() +println(newerId) // 2 +``` + +Mas adelante, cubriremos los objetos en profundidad. + +## Traits + +Los traits son tipos que contienen campos y métodos. Se pueden combinar múltiples traits. + +Los traits se definen con la palabra clave *trait*. + +```scala +trait Greeter { + def greet(name: String): Unit +} +``` + +Los traits pueden también tener implementación por defecto. + +```scala +trait Greeter { + def greet(name: String): Unit = + println("Hello, " + name + "!") +} +``` + +También puedes extender traits con la palabra clave *extends* y sobrescribir una implementación con la palabra clave *override* . + +```scala +class DefaultGreeter extends Greeter + +class CustomizableGreeter(prefix: String, postfix: String) extends Greeter { + override def greet(name: String): Unit = { + println(prefix + name + postfix) + } +} + +val greeter = new DefaultGreeter() +greeter.greet("Scala developer") // Hello, Scala developer! + +val customGreeter = new CustomizableGreeter("How are you, ", "?") +customGreeter.greet("Scala developer") // How are you, Scala developer? +``` + +Aquí, DefaultGreeter extiende un solo trait, pero puede extender múltiples traits. + +Mas adelante, cubriremos los traits en profundidad. + +## Metodo principal (Main Method) + +El metodo principal (main) es el punto de entrada de un programa. La maquina virtual de java (JVM) requiere que el método principal sea llamado `main` y que tome un solo argumento: un arrray de Strings. + +Usando un objeto, puedes definir el método principal de la siguiente forma: + +```scala +object Main { + def main(args: Array[String]): Unit = + println("Hello, Scala developer!") +} +``` From bf99da257277f91cd6ba36954558c359d16594a4 Mon Sep 17 00:00:00 2001 From: Dale Wijnand <344610+dwijnand@users.noreply.github.com> Date: Thu, 2 May 2019 07:53:05 +0100 Subject: [PATCH 0463/3075] Linkify the Oracle LTS support URL --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index b776a87a6b..117e52b90b 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -27,7 +27,7 @@ This table shows the first Scala release in each series that works with each JVM We recommend using Java 8 for *compiling* Scala code. Since the JVM is backward compatible, it is usually safe to use a newer JVM to *run* your code compiled by the Scala compiler for older JVM versions. There are notable exceptions with experimental/unsafe features, and the introduction of the module system in Java 9. The Scala compiler does usually need updates to run properly on newer versions of the JVM, so make sure to use the appropriate JVM when compiling your code. -We try to provide experimental support for running the Scala compiler on LTS versions of Java ("Long Term Support"; see http://www.oracle.com/technetwork/java/eol-135779.html), and to the extent possible will include the current LTS Java version in our CI matrix and the community build. We will not, a priori, consider non-LTS Java versions. Compiler bugs related to Java versions other than the supported one (Java 8), will be scheduled with lower priority, and will not be considered release blockers. Lightbend does offer commercial support for faster resolution of issues like this. +We try to provide experimental support for running the Scala compiler on LTS versions of Java ("Long Term Support"; see ), and to the extent possible will include the current LTS Java version in our CI matrix and the community build. We will not, a priori, consider non-LTS Java versions. Compiler bugs related to Java versions other than the supported one (Java 8), will be scheduled with lower priority, and will not be considered release blockers. Lightbend does offer commercial support for faster resolution of issues like this. Scala code compiled on Java 8 should run without problems in later JVMs, and we will give higher priority to bugs that break this property. For example, in the 2.13.x series we intend to provide support for JPMS module access checks, to allow ensuring your code won't incur `LinkageErrors` due to module access violations. From 9263c69c11ed51379e47b277db50901a8bdca563 Mon Sep 17 00:00:00 2001 From: Gabriel Claramunt Date: Sat, 4 May 2019 14:36:31 -0300 Subject: [PATCH 0464/3075] fix formatting and scalafiddle --- _es/tour/basics.md | 138 +++++++++++++++++++++++++++------------------ 1 file changed, 83 insertions(+), 55 deletions(-) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index 78464b51d1..24819b1d86 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -6,58 +6,77 @@ discourse: false partof: scala-tour language: es + +num: 2 +next-page: unified-types +previous-page: tour-of-scala --- -# Scala básico +En esta página, cubriremos lo básico de Scala. + +## Probando Scala en el navegador + +Puedes ejecutar Scala en tu navegador con ScalaFiddle. + +1. Ve a [https://scalafiddle.io](https://scalafiddle.io). +2. Pega `println("Hello, world!")` en el panel izquierdo. +3. Presiona el botón de "Run". El resultado aparece en el panel de la derecha. +Esta es una forma simple y con cero configuración de experimentar con piezas de código en Scala. + +Many of the code examples in this documentation are also integrated with ScalaFiddle, so you +can directly experiment with them simply by clicking the Run-button. +Muchos de los ejemplos de código en esta documentación están integrados también con ScalaFiddle, para que puedas experimentar directamente con ellos simplemente presionando el botón de "Run". ## Expresiones En Scala todo es una expresión (cada sentencia "devuelve" un valor). -```scala +```tut 1 + 1 ``` -Se puede ver el resultado de evaluar expresiones usando println. +Se puede ver el resultado de evaluar expresiones usando `println`. -```scala +{% scalafiddle %} +```tut println(1) // 1 println(1 + 1) // 2 println("Hello!") // Hello! println("Hello," + " world!") // Hello, world! ``` +{% endscalafiddle %} ## Valores -Se puede nombrar el resultado de expresiones con la palabra clave *val*. +Se puede nombrar el resultado de expresiones con la palabra clave `val`. -```scala +```tut val x = 1 + 1 println(x) // 2 ``` -Los resultados con nombre, como x en el ejemplo, son llamados *valores*. Referenciar un valor no lo vuelve a computar. +Los resultados con nombre, como `x` en el ejemplo, son llamados valores. Referenciar un valor no lo vuelve a computar. Los valores no pueden ser reasignados. -```scala +```tut:fail x = 3 // This does not compile. ``` -Los tipos de los valores pueden ser inferidos, pero tambien se pueden anotar explicitamente de la siguiente forma: +Los tipos de los valores pueden ser inferidos, pero también se pueden anotar explicitamente de la siguiente forma: -```scala +```tut val x: Int = 1 + 1 ``` -Noten como la declaración de tipo Int va después del identificador. +Noten como la declaración de tipo `Int` va después del identificador `x`. También necesitas un `:`. ## Variables -Las variables son como los valores, excepto que no es posible re-asignarlos. Las variables se definen con la palabra clave *var*. +Las variables son como los valores, excepto que no es posible re-asignarlos. Las variables se definen con la palabra clave `var`. -```scala +```tut var x = 1 + 1 x = 3 // This compiles because "x" is declared with the "var" keyword. println(x * x) // 9 @@ -65,17 +84,17 @@ println(x * x) // 9 Igual que con los valores, si queremos se puede especificar el tipo: -```scala +```tut var x: Int = 1 + 1 ``` ## Bloques -Se pueden combinar expresiones rodeándolas con { y } . A esto le llamamos un *bloque*. +Se pueden combinar expresiones rodeándolas con `{}` . A esto le llamamos un bloque. El resultado de la ultima expresión del bloque es también el resultado total del bloque. -```scala +```tut println({ val x = 1 + 1 x + 1 @@ -88,7 +107,7 @@ Las funciones son expresiones que reciben parámetros. Se pueden definir funciones anónimas, por ejemplo, una que retorne x + 1 para x entero: -```scala +```tut (x: Int) => x + 1 ``` @@ -96,48 +115,56 @@ A la izquierda de => esta la lista de parámetros. A la derecha esta el cuerpo d También podemos asignarle un nombre a la función. -```scala +{% scalafiddle %} +```tut val addOne = (x: Int) => x + 1 println(addOne(1)) // 2 ``` +{% endscalafiddle %} Las funciones pueden tomar muchos parámetros. -```scala +{% scalafiddle %} +```tut val add = (x: Int, y: Int) => x + y println(add(1, 2)) // 3 ``` +{% endscalafiddle %} O ninguno. -```scala +```tut val getTheAnswer = () => 42 println(getTheAnswer()) // 42 ``` - ## Métodos Los métodos se parecen y se comportan de forma muy similar a las funciones, pero hay un par de diferencias clave entre ellos. -Los métodos se definen con la palabra clave *def*, seguida por un nombre, una lista de parámetros, un tipo de retorno (opcional pero recomendado), y el cuerpo del método. -```scala +Los métodos se definen con la palabra clave `def`, seguida por un nombre, una lista de parámetros, un tipo de retorno, y el cuerpo del método. + +{% scalafiddle %} +```tut def add(x: Int, y: Int): Int = x + y println(add(1, 2)) // 3 ``` +{% endscalafiddle %} -Notar como el tipo de retorno es declarado después de la lista de parámetros y con dos puntos. +Notar como el tipo de retorno es declarado _después_ de la lista de parámetros y con dos puntos `: Int`. Los métodos pueden tener mutiles listas de parámetros. -```scala +{% scalafiddle %} +```tut def addThenMultiply(x: Int, y: Int)(multiplier: Int): Int = (x + y) * multiplier println(addThenMultiply(1, 2)(3)) // 9 ``` +{% endscalafiddle %} -O ninguna. +O ninguna lista de parametros. -```scala +```tut def name: String = System.getProperty("user.name") println("Hello, " + name + "!") ``` @@ -146,7 +173,7 @@ Hay otras diferencias, pero para simplificar, podemos pensar que son similares a Los métodos también pueden tener expresiones de varias lineas. -```scala +```tut def getSquareString(input: Double): String = { val square = input * input square.toString @@ -154,42 +181,42 @@ def getSquareString(input: Double): String = { ``` La ultima expresión en el cuerpo del método es el valor de retorno del mismo. -(Scala tiene la palabra clave *return* pero no se usa y no hace lo que uds. piensan que hace) +(Scala tiene la palabra clave `return` pero raramente se usa) ## Clases -Se puede definir clases con la palabra clave *class* seguida del nombre y los parámetros del constructor. +Se puede definir clases con la palabra clave `class` seguida del nombre y los parámetros del constructor. -```scala +```tut class Greeter(prefix: String, suffix: String) { def greet(name: String): Unit = println(prefix + name + suffix) } ``` -El tipo de retorno del método greet es Unit, que dice que no hay nada significativo que retornar. Se usa de forma similar al void de Java y C (con la diferencia de que como toda expresión en Scala debe retornar un valor, existe un valor singleton para el tipo Unit que se escribe `()` y no lleva información ) +El tipo de retorno del método `greet` es `Unit`, que dice que no hay nada significativo que retornar. Se usa de forma similar al `void` de Java y C (Con la diferencia de que como toda expresión en Scala debe retornar un valor, existe un valor singleton para el tipo Unit que se escribe () y no lleva información ) Puedes crear una instancia de una clase con la palabra clave *new*. -```scala +```tut val greeter = new Greeter("Hello, ", "!") greeter.greet("Scala developer") // Hello, Scala developer! ``` -Mas adelante, cubriremos las clases en profundidad. +Cubriremos las clases en profundidad [mas adelante](classes.html). ## Case Classes Scala tiene un tipo especial de clases llamadas "case" classes. Por defecto, las case classes son inmutables y son comparadas por valor. -Las case classes se definen usando las palabras clave *case class*. +Las case classes se definen usando las palabras clave `case class`. -```scala +```tut case class Point(x: Int, y: Int) ``` -Se pueden instanciar sin necesidad de usar la palabra clave new. +Se pueden instanciar sin necesidad de usar la palabra clave `new`. -```scala +```tut val point = Point(1, 2) val anotherPoint = Point(1, 2) val yetAnotherPoint = Point(2, 2) @@ -197,7 +224,7 @@ val yetAnotherPoint = Point(2, 2) Y son comparadas por valor. -```scala +```tut if (point == anotherPoint) { println(point + " and " + anotherPoint + " are the same.") } else { @@ -211,15 +238,15 @@ if (point == yetAnotherPoint) { } // Point(1,2) and Point(2,2) are different. ``` -Hay mucho mas sobre las case classes que queremos presentar, y estamos convencidos de que te vas a enamorar de ellas. Las cubriremos en profundidad mas adelante. +Hay mucho mas sobre las case classes que queremos presentar, y estamos convencidos de que te vas a enamorar de ellas. Las cubriremos en profundidad [mas adelante](case-classes.html). ## Objetos Los objetos son instancias de una sola clase de su propia definición. Puedes pensar en ellos como singleton de sus propias clases -Puedes definir objectos con la palabra clave *object*. +Puedes definir objectos con la palabra clave `object`. -```scala +```tut object IdFactory { private var counter = 0 def create(): Int = { @@ -231,22 +258,22 @@ object IdFactory { Para acceder al objeto, lo referencias por su nombre. -```scala +```tut val newId: Int = IdFactory.create() println(newId) // 1 val newerId: Int = IdFactory.create() println(newerId) // 2 ``` -Mas adelante, cubriremos los objetos en profundidad. +Cubriremos los objetos en profundidad [mas adelante](singleton-objects.html). ## Traits Los traits son tipos que contienen campos y métodos. Se pueden combinar múltiples traits. -Los traits se definen con la palabra clave *trait*. +Los traits se definen con la palabra clave `trait`. -```scala +```tut trait Greeter { def greet(name: String): Unit } @@ -254,16 +281,16 @@ trait Greeter { Los traits pueden también tener implementación por defecto. -```scala +{% scalafiddle %} +```tut trait Greeter { def greet(name: String): Unit = println("Hello, " + name + "!") } -``` -También puedes extender traits con la palabra clave *extends* y sobrescribir una implementación con la palabra clave *override* . +También puedes extender traits con la palabra clave `extends` y sobrescribir una implementación con la palabra clave `override` . -```scala +```tut class DefaultGreeter extends Greeter class CustomizableGreeter(prefix: String, postfix: String) extends Greeter { @@ -278,18 +305,19 @@ greeter.greet("Scala developer") // Hello, Scala developer! val customGreeter = new CustomizableGreeter("How are you, ", "?") customGreeter.greet("Scala developer") // How are you, Scala developer? ``` +{% endscalafiddle %} -Aquí, DefaultGreeter extiende un solo trait, pero puede extender múltiples traits. +Aquí, `DefaultGreeter` extiende un solo trait, pero puede extender múltiples traits. -Mas adelante, cubriremos los traits en profundidad. +Cubriremos los traits en profundidad [mas adelante](traits.html). -## Metodo principal (Main Method) +## Método principal (Main Method) -El metodo principal (main) es el punto de entrada de un programa. La maquina virtual de java (JVM) requiere que el método principal sea llamado `main` y que tome un solo argumento: un arrray de Strings. +El método principal (main) es el punto de entrada de un programa. La maquina virtual de java (JVM) requiere que el método principal sea llamado `main` y que tome un solo argumento: un arrray de Strings. Usando un objeto, puedes definir el método principal de la siguiente forma: -```scala +```tut object Main { def main(args: Array[String]): Unit = println("Hello, Scala developer!") From 0ff8f50cacaf22ceaca3102251d035689f5e54ac Mon Sep 17 00:00:00 2001 From: Gabriel Claramunt Date: Sat, 4 May 2019 23:14:13 -0300 Subject: [PATCH 0465/3075] add missing closing quotes --- _es/tour/basics.md | 1 + 1 file changed, 1 insertion(+) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index 24819b1d86..2b613c7bec 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -287,6 +287,7 @@ trait Greeter { def greet(name: String): Unit = println("Hello, " + name + "!") } +``` También puedes extender traits con la palabra clave `extends` y sobrescribir una implementación con la palabra clave `override` . From 16c153cc515aa141f37e39305c01aefd961e6089 Mon Sep 17 00:00:00 2001 From: "Diego E. Alonso Blas" Date: Sun, 5 May 2019 23:59:11 -0300 Subject: [PATCH 0466/3075] Apply suggestions from code review Co-Authored-By: gclaramunt --- _es/tour/basics.md | 50 +++++++++++++++++++++++----------------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index 2b613c7bec..c8f45e7c5a 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -19,14 +19,14 @@ En esta página, cubriremos lo básico de Scala. Puedes ejecutar Scala en tu navegador con ScalaFiddle. 1. Ve a [https://scalafiddle.io](https://scalafiddle.io). -2. Pega `println("Hello, world!")` en el panel izquierdo. -3. Presiona el botón de "Run". El resultado aparece en el panel de la derecha. +2. Escribe `println("Hello, world!")` en el panel a la izquierda. +3. Presiona el botón "Run". En el panel de la derecha aparecerá el resultado. -Esta es una forma simple y con cero configuración de experimentar con piezas de código en Scala. +Así, de manera fácil y sin preparación, puedes probar fragmentos de código Scala. Many of the code examples in this documentation are also integrated with ScalaFiddle, so you can directly experiment with them simply by clicking the Run-button. -Muchos de los ejemplos de código en esta documentación están integrados también con ScalaFiddle, para que puedas experimentar directamente con ellos simplemente presionando el botón de "Run". +Muchos ejemplos de código en esta documentación están integrados con ScalaFiddle, y así puedes probarlos directamente solo con pulsar el botón "Run". ## Expresiones @@ -49,7 +49,7 @@ println("Hello," + " world!") // Hello, world! ## Valores -Se puede nombrar el resultado de expresiones con la palabra clave `val`. +Se puede dar un nombre al resultado de una expresión usando la palabra reservada `val`. ```tut val x = 1 + 1 @@ -74,7 +74,7 @@ Noten como la declaración de tipo `Int` va después del identificador `x`. Tamb ## Variables -Las variables son como los valores, excepto que no es posible re-asignarlos. Las variables se definen con la palabra clave `var`. +Una variable es como un valor, excepto que a una variable se le puede re-asignar un valor después de declararla. Una variable se declara con la palabra reservada `var`. ```tut var x = 1 + 1 @@ -82,7 +82,7 @@ x = 3 // This compiles because "x" is declared with the "var" keyword. println(x * x) // 9 ``` -Igual que con los valores, si queremos se puede especificar el tipo: +Como con los valores, si se quiere se puede especificar el tipo de una variable mutable: ```tut var x: Int = 1 + 1 @@ -103,7 +103,7 @@ println({ ## Funciones -Las funciones son expresiones que reciben parámetros. +Una función es una expresión que acepta parámetros. Se pueden definir funciones anónimas, por ejemplo, una que retorne x + 1 para x entero: @@ -111,7 +111,7 @@ Se pueden definir funciones anónimas, por ejemplo, una que retorne x + 1 para x (x: Int) => x + 1 ``` -A la izquierda de => esta la lista de parámetros. A la derecha esta el cuerpo de la función +La lista de parámetros de la función está a la izquierda de la flecha `=>`, y a su derecha está el cuerpo de la función. También podemos asignarle un nombre a la función. @@ -140,9 +140,9 @@ println(getTheAnswer()) // 42 ## Métodos -Los métodos se parecen y se comportan de forma muy similar a las funciones, pero hay un par de diferencias clave entre ellos. +Los métodos se parecen y comportan casi como a las funciones, pero se diferencian en dos aspectos clave: -Los métodos se definen con la palabra clave `def`, seguida por un nombre, una lista de parámetros, un tipo de retorno, y el cuerpo del método. +Un método se define con la palabra reservada `def`, seguida por el nombre del método, la lista de parámetros, el tipo de valores que el método devuelve, y el cuerpo del método. {% scalafiddle %} ```tut @@ -151,9 +151,9 @@ println(add(1, 2)) // 3 ``` {% endscalafiddle %} -Notar como el tipo de retorno es declarado _después_ de la lista de parámetros y con dos puntos `: Int`. +Observe que el tipo de retorno se declara _después_ de la lista de parámetros, y separado con dos puntos, e.g. `: Int`. -Los métodos pueden tener mutiles listas de parámetros. +Un método puede tener varias listas de parámetros {% scalafiddle %} ```tut @@ -181,11 +181,11 @@ def getSquareString(input: Double): String = { ``` La ultima expresión en el cuerpo del método es el valor de retorno del mismo. -(Scala tiene la palabra clave `return` pero raramente se usa) +(Scala tiene una palabra reservada `return`, pero se usa raramente, y no se aconseja usarla) ## Clases -Se puede definir clases con la palabra clave `class` seguida del nombre y los parámetros del constructor. +Una clase se define con la palabra reservada `class`, seguida del nombre, y la lista de parámetros del constructor. ```tut class Greeter(prefix: String, suffix: String) { @@ -194,27 +194,27 @@ class Greeter(prefix: String, suffix: String) { } ``` -El tipo de retorno del método `greet` es `Unit`, que dice que no hay nada significativo que retornar. Se usa de forma similar al `void` de Java y C (Con la diferencia de que como toda expresión en Scala debe retornar un valor, existe un valor singleton para el tipo Unit que se escribe () y no lleva información ) +El método `greet` tiene un tipo de retorno `Unit`, que indica que el método no tiene nada significativo que devolver. Esto es similar al tipo `void` en C, C++, o Java. La diferencia con estos lenguajes es que, dado que en Scala toda expresión debe devuelvor un valor, se usa un tipo `Unit`, con un solo valor, que se escribe `()` y no lleva información. -Puedes crear una instancia de una clase con la palabra clave *new*. +Se puede crear una instancia de una clase con la palabra reservada *new*. ```tut val greeter = new Greeter("Hello, ", "!") greeter.greet("Scala developer") // Hello, Scala developer! ``` -Cubriremos las clases en profundidad [mas adelante](classes.html). +Las clases se tratan en profundidad [mas adelante](classes.html). ## Case Classes -Scala tiene un tipo especial de clases llamadas "case" classes. Por defecto, las case classes son inmutables y son comparadas por valor. -Las case classes se definen usando las palabras clave `case class`. +Hay un tipo especial de clases en Scala, las llamadas "case" classes. Por defecto, las instancias de una case class son inmutables, y se comparan con otras solo por los valores que contienen en cada campo. +Una case class se define con las palabras reservadas `case class`: ```tut case class Point(x: Int, y: Int) ``` -Se pueden instanciar sin necesidad de usar la palabra clave `new`. +Se puede crear una instancia de una `case class`, sin usar la palabra reservada `new`. ```tut val point = Point(1, 2) @@ -238,7 +238,7 @@ if (point == yetAnotherPoint) { } // Point(1,2) and Point(2,2) are different. ``` -Hay mucho mas sobre las case classes que queremos presentar, y estamos convencidos de que te vas a enamorar de ellas. Las cubriremos en profundidad [mas adelante](case-classes.html). +Hay mucho mas sobre las case classes que queremos presentar, y estamos convencidos de que te vas a enamorar de ellas. Se tratan con más detalle [mas adelante](case-classes.html). ## Objetos @@ -271,7 +271,7 @@ Cubriremos los objetos en profundidad [mas adelante](singleton-objects.html). Los traits son tipos que contienen campos y métodos. Se pueden combinar múltiples traits. -Los traits se definen con la palabra clave `trait`. +Un trait se define usando la palabra reservada `trait`. ```tut trait Greeter { @@ -310,11 +310,11 @@ customGreeter.greet("Scala developer") // How are you, Scala developer? Aquí, `DefaultGreeter` extiende un solo trait, pero puede extender múltiples traits. -Cubriremos los traits en profundidad [mas adelante](traits.html). +Los `traits` se tratan con detalle [en otra página](traits.html). ## Método principal (Main Method) -El método principal (main) es el punto de entrada de un programa. La maquina virtual de java (JVM) requiere que el método principal sea llamado `main` y que tome un solo argumento: un arrray de Strings. +El método principal (main) es el punto donde comienza la ejecución de un programa en Scala. La máquina virtual de java (_Java Virtual Machine_ or JVM) requiere, para ejecutar un código Scala, que éste tenga un método principal llamado `main` cuyo único parámetro sea un arrray de Strings. Usando un objeto, puedes definir el método principal de la siguiente forma: From 6de4ca5c19c03f0d597798b58a6efe86fdb5c376 Mon Sep 17 00:00:00 2001 From: Gabriel Claramunt Date: Mon, 6 May 2019 00:07:54 -0300 Subject: [PATCH 0467/3075] review comments --- _es/tour/basics.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index c8f45e7c5a..4147f63df1 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -24,13 +24,11 @@ Puedes ejecutar Scala en tu navegador con ScalaFiddle. Así, de manera fácil y sin preparación, puedes probar fragmentos de código Scala. -Many of the code examples in this documentation are also integrated with ScalaFiddle, so you -can directly experiment with them simply by clicking the Run-button. Muchos ejemplos de código en esta documentación están integrados con ScalaFiddle, y así puedes probarlos directamente solo con pulsar el botón "Run". ## Expresiones -En Scala todo es una expresión (cada sentencia "devuelve" un valor). +Las expresiones son sentencias computables. ```tut 1 + 1 @@ -105,7 +103,7 @@ println({ Una función es una expresión que acepta parámetros. -Se pueden definir funciones anónimas, por ejemplo, una que retorne x + 1 para x entero: +Una función se puede declarar anónima, sin nombre. Por ejemplo, ésta es una función que acepta un número entero `x`, y devuelve el resultado de incrementarlo `x+1`: ```tut (x: Int) => x + 1 @@ -244,7 +242,7 @@ Hay mucho mas sobre las case classes que queremos presentar, y estamos convencid Los objetos son instancias de una sola clase de su propia definición. Puedes pensar en ellos como singleton de sus propias clases -Puedes definir objectos con la palabra clave `object`. +Un objeto se define usando la palabra reservada `object`. ```tut object IdFactory { From 0e2289195e42a1fbaa136d6bcf010510e360a485 Mon Sep 17 00:00:00 2001 From: Ignasi Marimon-Clos Date: Mon, 6 May 2019 11:08:38 -0300 Subject: [PATCH 0468/3075] Apply suggestions from code review Co-Authored-By: gclaramunt --- _es/tour/basics.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index 4147f63df1..c8155a77f8 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -12,7 +12,7 @@ next-page: unified-types previous-page: tour-of-scala --- -En esta página, cubriremos lo básico de Scala. +En esta página, practicaremos conceptos básicos de Scala. ## Probando Scala en el navegador @@ -59,10 +59,10 @@ Los resultados con nombre, como `x` en el ejemplo, son llamados valores. Referen Los valores no pueden ser reasignados. ```tut:fail -x = 3 // This does not compile. +x = 3 // Producirá un error de compilación. ``` -Los tipos de los valores pueden ser inferidos, pero también se pueden anotar explicitamente de la siguiente forma: +Los tipos de los valores pueden ser inferidos, pero también se pueden anotar explícitamente de la siguiente forma: ```tut val x: Int = 1 + 1 @@ -90,7 +90,7 @@ var x: Int = 1 + 1 Se pueden combinar expresiones rodeándolas con `{}` . A esto le llamamos un bloque. -El resultado de la ultima expresión del bloque es también el resultado total del bloque. +El resultado de la última expresión del bloque es también el resultado total del bloque. ```tut println({ @@ -120,7 +120,7 @@ println(addOne(1)) // 2 ``` {% endscalafiddle %} -Las funciones pueden tomar muchos parámetros. +Las funciones pueden tomar varios parámetros. {% scalafiddle %} ```tut @@ -149,9 +149,9 @@ println(add(1, 2)) // 3 ``` {% endscalafiddle %} -Observe que el tipo de retorno se declara _después_ de la lista de parámetros, y separado con dos puntos, e.g. `: Int`. +Observe que el tipo de retorno se declara _después_ de la lista de parámetros, y separado con dos puntos, p.ej. `: Int`. -Un método puede tener varias listas de parámetros +Un método puede tener varias listas de parámetros. {% scalafiddle %} ```tut @@ -179,7 +179,7 @@ def getSquareString(input: Double): String = { ``` La ultima expresión en el cuerpo del método es el valor de retorno del mismo. -(Scala tiene una palabra reservada `return`, pero se usa raramente, y no se aconseja usarla) +(Scala tiene una palabra reservada `return`, pero se usa raramente y no se aconseja usarla) ## Clases @@ -192,7 +192,7 @@ class Greeter(prefix: String, suffix: String) { } ``` -El método `greet` tiene un tipo de retorno `Unit`, que indica que el método no tiene nada significativo que devolver. Esto es similar al tipo `void` en C, C++, o Java. La diferencia con estos lenguajes es que, dado que en Scala toda expresión debe devuelvor un valor, se usa un tipo `Unit`, con un solo valor, que se escribe `()` y no lleva información. +El método `greet` tiene un tipo de retorno `Unit`, que indica que el método no tiene nada significativo que devolver. Esto es similar al tipo `void` en C, C++, o Java. La diferencia con estos lenguajes es que en Scala toda expresión debe devolver un valor. Se usa un tipo `Unit` que tiene con un solo valor que se escribe `()` y no lleva información. Se puede crear una instancia de una clase con la palabra reservada *new*. @@ -201,7 +201,7 @@ val greeter = new Greeter("Hello, ", "!") greeter.greet("Scala developer") // Hello, Scala developer! ``` -Las clases se tratan en profundidad [mas adelante](classes.html). +Las clases se tratan en profundidad [más adelante](classes.html). ## Case Classes @@ -236,11 +236,11 @@ if (point == yetAnotherPoint) { } // Point(1,2) and Point(2,2) are different. ``` -Hay mucho mas sobre las case classes que queremos presentar, y estamos convencidos de que te vas a enamorar de ellas. Se tratan con más detalle [mas adelante](case-classes.html). +Hay mucho más sobre las case classes que queremos presentar, y estamos convencidos de que te vas a enamorar de ellas. Se tratan con más detalle [mas adelante](case-classes.html). ## Objetos -Los objetos son instancias de una sola clase de su propia definición. Puedes pensar en ellos como singleton de sus propias clases +Los objetos son instancias de una sola clase de su propia definición. Puedes pensar en ellos como _singleton_ de sus propias clases. Un objeto se define usando la palabra reservada `object`. @@ -263,7 +263,7 @@ val newerId: Int = IdFactory.create() println(newerId) // 2 ``` -Cubriremos los objetos en profundidad [mas adelante](singleton-objects.html). +Cubriremos los objetos en profundidad [más adelante](singleton-objects.html). ## Traits @@ -287,7 +287,7 @@ trait Greeter { } ``` -También puedes extender traits con la palabra clave `extends` y sobrescribir una implementación con la palabra clave `override` . +También puedes extender traits con la palabra clave `extends` y sobrescribir una implementación con la palabra clave `override`. ```tut class DefaultGreeter extends Greeter From d17ca9078857b64ecb9f0e7479ddc9389bb8f1bc Mon Sep 17 00:00:00 2001 From: Gabriel Claramunt Date: Mon, 6 May 2019 13:46:57 -0300 Subject: [PATCH 0469/3075] Apply suggestions from code review Co-Authored-By: gclaramunt --- _es/tour/basics.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index c8155a77f8..d472a60ddf 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -62,7 +62,7 @@ Los valores no pueden ser reasignados. x = 3 // Producirá un error de compilación. ``` -Los tipos de los valores pueden ser inferidos, pero también se pueden anotar explícitamente de la siguiente forma: +Scala es capaz de inferir el tipo de un valor. Aun asi, también se puede indicar el tipo usando una anotación: ```tut val x: Int = 1 + 1 @@ -103,7 +103,7 @@ println({ Una función es una expresión que acepta parámetros. -Una función se puede declarar anónima, sin nombre. Por ejemplo, ésta es una función que acepta un número entero `x`, y devuelve el resultado de incrementarlo `x+1`: +Una función se puede declarar anónima, sin nombre. Por ejemplo, ésta es una función que acepta un número entero `x`, y devuelve el resultado de incrementarlo: ```tut (x: Int) => x + 1 @@ -192,7 +192,7 @@ class Greeter(prefix: String, suffix: String) { } ``` -El método `greet` tiene un tipo de retorno `Unit`, que indica que el método no tiene nada significativo que devolver. Esto es similar al tipo `void` en C, C++, o Java. La diferencia con estos lenguajes es que en Scala toda expresión debe devolver un valor. Se usa un tipo `Unit` que tiene con un solo valor que se escribe `()` y no lleva información. +El método `greet` tiene un tipo de retorno `Unit`, que indica que el método no tiene nada significativo que devolver. Esto es similar al tipo `void` en C, C++, o Java. La diferencia con estos lenguajes es que en Scala toda expresión debe devolver un valor. Por ello, se usa un tipo `Unit` que tiene con un solo valor que se escribe `()` y no lleva información. Se puede crear una instancia de una clase con la palabra reservada *new*. @@ -277,7 +277,7 @@ trait Greeter { } ``` -Los traits pueden también tener implementación por defecto. +Un `trait` también puede definit un método, o un valor, con una implementación por defecto. {% scalafiddle %} ```tut @@ -287,7 +287,7 @@ trait Greeter { } ``` -También puedes extender traits con la palabra clave `extends` y sobrescribir una implementación con la palabra clave `override`. +Un `trait` también puede extender otros traits, usando la palabra clave `extends`. Asimismo, en un `trait` se puede redefinir la implementación de un método heredado, usando la palabra reservada `override`. ```tut class DefaultGreeter extends Greeter From e70979eafa06e361b5353b6f91898c3fc80e1e72 Mon Sep 17 00:00:00 2001 From: Gabriel Claramunt Date: Mon, 6 May 2019 15:27:47 -0300 Subject: [PATCH 0470/3075] spellcheck --- _es/tour/basics.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index d472a60ddf..80977f061b 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -59,16 +59,16 @@ Los resultados con nombre, como `x` en el ejemplo, son llamados valores. Referen Los valores no pueden ser reasignados. ```tut:fail -x = 3 // Producirá un error de compilación. +x = 3 // This does not compile. ``` -Scala es capaz de inferir el tipo de un valor. Aun asi, también se puede indicar el tipo usando una anotación: +Scala es capaz de inferir el tipo de un valor. Aun así, también se puede indicar el tipo usando una anotación: ```tut val x: Int = 1 + 1 ``` -Noten como la declaración de tipo `Int` va después del identificador `x`. También necesitas un `:`. +Nótese que la anotación del tipo `Int` sigue al identificador `x` de la variable, separado por dos puntos `:`. ## Variables @@ -160,7 +160,7 @@ println(addThenMultiply(1, 2)(3)) // 9 ``` {% endscalafiddle %} -O ninguna lista de parametros. +O ninguna lista de parámetros. ```tut def name: String = System.getProperty("user.name") @@ -277,7 +277,7 @@ trait Greeter { } ``` -Un `trait` también puede definit un método, o un valor, con una implementación por defecto. +Un `trait` también puede definir un método, o un valor, con una implementación por defecto. {% scalafiddle %} ```tut From 9fd83799523ca0a3e56dbb8e2fef9f6076c9f858 Mon Sep 17 00:00:00 2001 From: Gabriel Claramunt Date: Tue, 7 May 2019 19:25:08 -0300 Subject: [PATCH 0471/3075] change next page link to target basics (#1325) --- _es/tour/tour-of-scala.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_es/tour/tour-of-scala.md b/_es/tour/tour-of-scala.md index 445b894c8d..14ef79cebc 100644 --- a/_es/tour/tour-of-scala.md +++ b/_es/tour/tour-of-scala.md @@ -9,7 +9,8 @@ partof: scala-tour num: 1 language: es -next-page: abstract-type-members +next-page: basics + --- Scala es un lenguaje de programación moderno multi-paradigma diseñado para expresar patrones de programación comunes de una forma concisa, elegante, y de tipado seguro. Integra fácilmente características de lenguajes orientados a objetos y funcionales. From 2d8f8e533e48b462680cf1e398d547721ed7c80f Mon Sep 17 00:00:00 2001 From: Eugene Yokota Date: Fri, 10 May 2019 16:01:10 -0400 Subject: [PATCH 0472/3075] Add guidance on how to migrate scala.Seq --- _overviews/core/collections-migration-213.md | 28 ++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index f58bad8e9f..7b8aed0c6f 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -10,6 +10,7 @@ how to cross-build projects with Scala 2.11 / 2.12 and 2.13. For an in-depth overview of the Scala 2.13 collections library, see the [collections guide]({{ site.baseurl }}/overviews/collections-2.13/introduction.html). The implementation details of the 2.13 collections are explained in the document [the architecture of Scala collections]({{ site.baseurl }}/overviews/core/architecture-of-scala-213-collections.html). The most important changes in the Scala 2.13 collections library are: + - `scala.Seq[+A]` is now an alias for `scala.collection.immutable.Seq[A]` (instead of `scala.collection.Seq[A]`). Note that this also changes the type of Scala varargs methods. - Transformation methods no longer have an implicit `CanBuildFrom` parameter. This makes the library easier to understand (in source code, Scaladoc, and IDE code completion). It also makes compiling user code more efficient. - The type hierarchy is simplified. `Traversable` no longer exists, only `Iterable`. - The `to[Collection]` method was replaced by the `to(Collection)` method. @@ -22,7 +23,6 @@ The most important changes in the Scala 2.13 collections library are: - Deprecated collections were removed (`MutableList`, `immutable.Stack`, others) - Parallel collections are now in a separate hierarchy in a [separate module](https://github.com/scala/scala-parallel-collections). - The `scala.jdk.StreamConverters` object provides extension methods to create (sequential or parallel) Java 8 streams for Scala collections. - - `scala.Seq` is now an alias for `scala.collection.immutable.Seq` (no longer `scala.collection.Seq`). Note that this also changes the type of Scala varargs methods. ## Tools for migrating and cross-building @@ -30,6 +30,31 @@ The [scala-collection-compat](https://github.com/scala/scala-collection-compat) The module also provides [migratrion rules](https://github.com/scala/scala-collection-compat#migration-tool) for [scalafix](https://scalacenter.github.io/scalafix/docs/users/installation.html) that can update a project's source code to work with the 2.13 collections library. +## scala.Seq migration + +In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A]`, instead of `scala.collection.Seq[A]`. This change requires some planning depending on how your code is going to be used. + +If you're making an application, and simply migrating Scala 2.12 code base to 2.13, it might be ok to keep using `scala.Seq` in your code. + +If you're making a library intended to be used by other programmers, then using `scala.Seq` or vararg is going to be a breaking change in the API semantics. For example, if there was a function `def orderFood(order: Seq[Order]): Seq[Food]`, previously the library user would have been able to pass in an array of `Order`, but it won't work for 2.13. + +- if you cross build with Scala 2.12 and want to maintain the API semantics for 2.13 version of your library, or +- if your library users frequently uses mutable collections such as `Array` + +you can import `scala.collection.Seq` ("CSeq") explicitly in your code. + +~~~ scala +import scala.collection.Seq +~~~ + +In the future when your API is able to break the source compatibility, it might also make sense to migrate towards the `scala.collection.immutable.Seq` ("ISeq") for both Scala 2.12 and Scala 2.13. + +~~~ scala +import scala.collection.immutable.Seq +~~~ + +Note that in Scala 2.13 the sequence passed into a vararg as `orderFood(xs: _*)` must also be immutable. This is because the sequence passed into a vararg must conform to`scala.Seq` acoording to [Specification](https://www.scala-lang.org/files/archive/spec/2.12/06-expressions.html#function-applications). Thus if your API exposes varargs, it will be an unavoidable breaking change. This might affect Java interoperability. + ## What are the breaking changes? The following table summarizes the breaking changes. The "Automatic Migration Rule" column gives the name of the migration rule that can be used to automatically update old code to the new expected form. @@ -77,7 +102,6 @@ Some classes have been removed, made private or have no equivalent in the new de Other notable changes are: - `Iterable.partition` invokes `iterator` twice on non-strict collections and assumes it gets two iterators over the same elements. Strict subclasses override `partition` do perform only a single traversal - - `scala.Seq[+A]` is now `scala.collection.immutable.Seq[A]` (this also affects varargs methods). - Equality between collections is not anymore defined at the level of `Iterable`. It is defined separately in the `Set`, `Seq` and `Map` branches. Another consequence is that `Iterable` does not anymore have a `canEqual` method. - The new collections makes more use of overloading. You can find more information about the motivation behind this choice [here](http://scala-lang.org/blog/2017/05/30/tribulations-canbuildfrom.html). For instance, `Map.map` is overloaded: From 8178166fd0c7b3e6e7b5dfb025b76c469279aba1 Mon Sep 17 00:00:00 2001 From: eugene yokota Date: Fri, 10 May 2019 17:28:00 -0400 Subject: [PATCH 0473/3075] Update _overviews/core/collections-migration-213.md Co-Authored-By: Dale Wijnand <344610+dwijnand@users.noreply.github.com> --- _overviews/core/collections-migration-213.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 7b8aed0c6f..e04c036d61 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -53,7 +53,7 @@ In the future when your API is able to break the source compatibility, it might import scala.collection.immutable.Seq ~~~ -Note that in Scala 2.13 the sequence passed into a vararg as `orderFood(xs: _*)` must also be immutable. This is because the sequence passed into a vararg must conform to`scala.Seq` acoording to [Specification](https://www.scala-lang.org/files/archive/spec/2.12/06-expressions.html#function-applications). Thus if your API exposes varargs, it will be an unavoidable breaking change. This might affect Java interoperability. +Note that in Scala 2.13 the sequence passed into as a varargs as `orderFood(xs: _*)` must also be immutable. This is because the sequence passed in as a varargs must conform to `scala.Seq` according to [SLS 6.6](https://www.scala-lang.org/files/archive/spec/2.12/06-expressions.html#function-applications). Thus, if your API exposes varargs it will be an unavoidable breaking change. This might affect Java interoperability. ## What are the breaking changes? @@ -260,4 +260,4 @@ Examples of libraries that cross-compile with separate source directories: To learn about differences when implementing custom collection types or operations, see the following documents: - [The architecture of Scala collections]({{ site.baseurl }}/overviews/core/architecture-of-scala-213-collections.html) - [Implementing custom collections]({{ site.baseurl }}/overviews/core/custom-collections.html) - - [Adding custom collection operations]({{ site.baseurl }}/overviews/core/custom-collection-operations.html) \ No newline at end of file + - [Adding custom collection operations]({{ site.baseurl }}/overviews/core/custom-collection-operations.html) From 54b38f7ee2ac71384741e7b2318eaa0f4f09d186 Mon Sep 17 00:00:00 2001 From: eugene yokota Date: Fri, 10 May 2019 17:32:25 -0400 Subject: [PATCH 0474/3075] Update _overviews/core/collections-migration-213.md Co-Authored-By: Dale Wijnand <344610+dwijnand@users.noreply.github.com> --- _overviews/core/collections-migration-213.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index e04c036d61..ac2be9d9d3 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -34,7 +34,7 @@ The module also provides [migratrion rules](https://github.com/scala/scala-colle In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A]`, instead of `scala.collection.Seq[A]`. This change requires some planning depending on how your code is going to be used. -If you're making an application, and simply migrating Scala 2.12 code base to 2.13, it might be ok to keep using `scala.Seq` in your code. +If you're making an application, and simply migrating a Scala 2.12 code base to 2.13, it might be ok to keep using `scala.Seq` in your code. If you're making a library intended to be used by other programmers, then using `scala.Seq` or vararg is going to be a breaking change in the API semantics. For example, if there was a function `def orderFood(order: Seq[Order]): Seq[Food]`, previously the library user would have been able to pass in an array of `Order`, but it won't work for 2.13. From 6c566237690ef8948d619fea97ab91e96cbc18fc Mon Sep 17 00:00:00 2001 From: eugene yokota Date: Fri, 10 May 2019 17:32:39 -0400 Subject: [PATCH 0475/3075] Update _overviews/core/collections-migration-213.md Co-Authored-By: Dale Wijnand <344610+dwijnand@users.noreply.github.com> --- _overviews/core/collections-migration-213.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index ac2be9d9d3..7b4a59f124 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -36,7 +36,7 @@ In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A] If you're making an application, and simply migrating a Scala 2.12 code base to 2.13, it might be ok to keep using `scala.Seq` in your code. -If you're making a library intended to be used by other programmers, then using `scala.Seq` or vararg is going to be a breaking change in the API semantics. For example, if there was a function `def orderFood(order: Seq[Order]): Seq[Food]`, previously the library user would have been able to pass in an array of `Order`, but it won't work for 2.13. +If you're making a library intended to be used by other programmers, then using `scala.Seq` or varargs is going to be a breaking change in the API semantics. For example, if there was a function `def orderFood(order: Seq[Order]): Seq[Food]`, previously the library user would have been able to pass in an array of `Order`, but it won't work for 2.13. - if you cross build with Scala 2.12 and want to maintain the API semantics for 2.13 version of your library, or - if your library users frequently uses mutable collections such as `Array` From 66fb063a96e63630e709257e807219d53a6d5ef1 Mon Sep 17 00:00:00 2001 From: "Aaron S. Hawley" Date: Thu, 16 May 2019 22:52:32 -0400 Subject: [PATCH 0476/3075] Add redirect for partest-guide (#1329) https://github.com/scala/scala-partest --- _overviews/tutorials/partest-guide.md | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 _overviews/tutorials/partest-guide.md diff --git a/_overviews/tutorials/partest-guide.md b/_overviews/tutorials/partest-guide.md new file mode 100644 index 0000000000..36fa8c74c7 --- /dev/null +++ b/_overviews/tutorials/partest-guide.md @@ -0,0 +1,6 @@ +--- +layout: inner-page-no-masthead +sitemap: false +permalink: /tutorials/partest-guide.html +redirect_to: https://github.com/scala/scala-partest +--- From 017fef76e43a45fcd01d42f5a6558c0b48e23f31 Mon Sep 17 00:00:00 2001 From: Suyash Date: Sat, 18 May 2019 08:44:57 +0400 Subject: [PATCH 0477/3075] Update getting-started-with-scala-in-intellij.md updating doc for adding scala framework support addition which was missing earlier --- .../getting-started-with-scala-in-intellij.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started-intellij-track/getting-started-with-scala-in-intellij.md b/getting-started-intellij-track/getting-started-with-scala-in-intellij.md index f6cd28b50a..b6517c06bd 100644 --- a/getting-started-intellij-track/getting-started-with-scala-in-intellij.md +++ b/getting-started-intellij-track/getting-started-with-scala-in-intellij.md @@ -36,7 +36,7 @@ take a few minutes but subsequent projects can use the same SDK. ## Writing code 1. On the **Project** pane on the left, right-click `src` and select -**New** => **Scala class**. +**New** => **Scala class**. If you don't see **Scala class**, right-click on **HelloWorld** and click on **Add Framework Support...**, select **Scala** and proceed. If you see **Error: library is not specified**, you can either click donload button, or select the library path manually. 1. Name the class `Hello` and change the **Kind** to `object`. 1. Change the code in the class to the following: From 8025fe3685a7a66c8f329c4ffa746fbc880ad0f0 Mon Sep 17 00:00:00 2001 From: Suyash Date: Sun, 19 May 2019 11:56:00 +0400 Subject: [PATCH 0478/3075] Update getting-started-with-scala-in-intellij.md Fixing typo. --- .../getting-started-with-scala-in-intellij.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started-intellij-track/getting-started-with-scala-in-intellij.md b/getting-started-intellij-track/getting-started-with-scala-in-intellij.md index b6517c06bd..730f2e7f36 100644 --- a/getting-started-intellij-track/getting-started-with-scala-in-intellij.md +++ b/getting-started-intellij-track/getting-started-with-scala-in-intellij.md @@ -36,7 +36,7 @@ take a few minutes but subsequent projects can use the same SDK. ## Writing code 1. On the **Project** pane on the left, right-click `src` and select -**New** => **Scala class**. If you don't see **Scala class**, right-click on **HelloWorld** and click on **Add Framework Support...**, select **Scala** and proceed. If you see **Error: library is not specified**, you can either click donload button, or select the library path manually. +**New** => **Scala class**. If you don't see **Scala class**, right-click on **HelloWorld** and click on **Add Framework Support...**, select **Scala** and proceed. If you see **Error: library is not specified**, you can either click download button, or select the library path manually. 1. Name the class `Hello` and change the **Kind** to `object`. 1. Change the code in the class to the following: From 9afd159f5556ad9a772e8a264e000d30d910c168 Mon Sep 17 00:00:00 2001 From: Akhtyam Sakaev <3930435+asakaev@users.noreply.github.com> Date: Sat, 18 May 2019 01:38:15 +0300 Subject: [PATCH 0479/3075] refine pattern-matching.md --- _tour/pattern-matching.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index b5f9e37d46..20ca742c70 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -28,19 +28,19 @@ x match { case 0 => "zero" case 1 => "one" case 2 => "two" - case _ => "many" + case _ => "other" } ``` -The `val x` above is a random integer between 0 and 10. `x` becomes the left operand of the `match` operator and on the right is an expression with four cases. The last case `_` is a "catch all" case for any number greater than 2. Cases are also called _alternatives_. +The `val x` above is a random integer between 0 and 10. `x` becomes the left operand of the `match` operator and on the right is an expression with four cases. The last case `_` is a "catch all" case for any other possible `Int` values. Cases are also called _alternatives_. Match expressions have a value. ```tut def matchTest(x: Int): String = x match { case 1 => "one" case 2 => "two" - case _ => "many" + case _ => "other" } -matchTest(3) // many +matchTest(3) // other matchTest(1) // one ``` This match expression has a type String because all of the cases return String. Therefore, the function `matchTest` returns a String. From 2b4de2d746a2ffb8547298897d585c94b711f508 Mon Sep 17 00:00:00 2001 From: Eugene Yokota Date: Mon, 20 May 2019 18:17:11 -0400 Subject: [PATCH 0480/3075] reflect review comments --- _overviews/core/collections-migration-213.md | 66 ++++++++++++++++++-- 1 file changed, 60 insertions(+), 6 deletions(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 7b4a59f124..f877849115 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -32,29 +32,83 @@ The module also provides [migratrion rules](https://github.com/scala/scala-colle ## scala.Seq migration -In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A]`, instead of `scala.collection.Seq[A]`. This change requires some planning depending on how your code is going to be used. - -If you're making an application, and simply migrating a Scala 2.12 code base to 2.13, it might be ok to keep using `scala.Seq` in your code. +In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A]` ("ISeq"), instead of `scala.collection.Seq[A]` ("CSeq"). This change requires some planning depending on how your code is going to be used. If you're making a library intended to be used by other programmers, then using `scala.Seq` or varargs is going to be a breaking change in the API semantics. For example, if there was a function `def orderFood(order: Seq[Order]): Seq[Food]`, previously the library user would have been able to pass in an array of `Order`, but it won't work for 2.13. - if you cross build with Scala 2.12 and want to maintain the API semantics for 2.13 version of your library, or - if your library users frequently uses mutable collections such as `Array` -you can import `scala.collection.Seq` ("CSeq") explicitly in your code. +you can import collection Seq explicitly in your code. ~~~ scala import scala.collection.Seq + +object FoodToGo { + def orderFood(order: Seq[Order]): Seq[Food] +} +~~~ + +Note that this might still break the source compatibility if `scala.Seq` (or just `Seq`) appears in the source code. + +~~~ scala +val food: Seq[Food] = FoodToGo.orderFood(order) // won't compile ~~~ -In the future when your API is able to break the source compatibility, it might also make sense to migrate towards the `scala.collection.immutable.Seq` ("ISeq") for both Scala 2.12 and Scala 2.13. +Since `Seq`, an alias for ISeq in 2.13, is narrower than CSeq, the above code will no longer compile. One workaround would be to ask your users to add `toSeq`, which returns ISeq. ~~~ scala -import scala.collection.immutable.Seq +val food: Seq[Food] = FoodToGo.orderFood(order).toSeq // add .toSeq ~~~ +Another workaround might be to accept CSeq, but return ISeq. + +~~~ scala +import scala.collection.{ Seq => CSeq } +import scala.collection.immutable.{ Seq => ISeq } + +object FoodToGo { + def orderFood(order: CSeq[Order]): ISeq[Food] +} +~~~ + +In the future when your API is able to break the source compatibility, it might also make sense to migrate towards ISeq for both Scala 2.12 and Scala 2.13. + +~~~ scala +import scala.collection.immutable.{ Seq => ISeq } + +object FoodToGo { + def orderFood(order: ISeq[Order]): ISeq[Food] +} +~~~ + +Similarly, if you're making an end-user application, unifying to CSeq might be the easier and safer initial path especially for a larger and complex code base. Switching to ISeq will be a more advanced refactoring. + Note that in Scala 2.13 the sequence passed into as a varargs as `orderFood(xs: _*)` must also be immutable. This is because the sequence passed in as a varargs must conform to `scala.Seq` according to [SLS 6.6](https://www.scala-lang.org/files/archive/spec/2.12/06-expressions.html#function-applications). Thus, if your API exposes varargs it will be an unavoidable breaking change. This might affect Java interoperability. +### Masking scala.Seq + +To use the compiler to bad the use of plain `Seq`, you can declare your own `Seq` to mask `scala.Seq`. + +~~~ scala +package example + +import scala.annotation.compileTimeOnly + +/** + * In Scala 2.13, scala.Seq moved from scala.collection.Seq to scala.collection.immutable.Seq. + * In this code base, we'll require you to name ISeq or CSeq. + * + * import scala.collection.{ Seq => CSeq } + * import scala.collection.immutable.{ Seq => ISeq } + * + * This Seq trait is a dummy type to prevent the use of `Seq`. + */ +@compileTimeOnly("Use ISeq or CSeq") private[example] trait Seq[A1, F1[A2], A3] +~~~ + +This might be useful during the transition period where you have to remember to import CSeq. + ## What are the breaking changes? The following table summarizes the breaking changes. The "Automatic Migration Rule" column gives the name of the migration rule that can be used to automatically update old code to the new expected form. From cc9b455f6d43d30aa67220e33dc598b381ad3f07 Mon Sep 17 00:00:00 2001 From: Eugene Yokota Date: Mon, 20 May 2019 18:23:35 -0400 Subject: [PATCH 0481/3075] scala.IndexedSeq too --- _overviews/core/collections-migration-213.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index f877849115..730ddb34b9 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -11,6 +11,7 @@ For an in-depth overview of the Scala 2.13 collections library, see the [collect The most important changes in the Scala 2.13 collections library are: - `scala.Seq[+A]` is now an alias for `scala.collection.immutable.Seq[A]` (instead of `scala.collection.Seq[A]`). Note that this also changes the type of Scala varargs methods. + - `scala.IndexedSeq[+A]` is now an alias for `scala.collection.immutable.IndexedSeq[A]` (instead of `scala.collection.IndexedSeq[A]`). - Transformation methods no longer have an implicit `CanBuildFrom` parameter. This makes the library easier to understand (in source code, Scaladoc, and IDE code completion). It also makes compiling user code more efficient. - The type hierarchy is simplified. `Traversable` no longer exists, only `Iterable`. - The `to[Collection]` method was replaced by the `to(Collection)` method. @@ -30,11 +31,11 @@ The [scala-collection-compat](https://github.com/scala/scala-collection-compat) The module also provides [migratrion rules](https://github.com/scala/scala-collection-compat#migration-tool) for [scalafix](https://scalacenter.github.io/scalafix/docs/users/installation.html) that can update a project's source code to work with the 2.13 collections library. -## scala.Seq migration +## scala.Seq and scala.IndexedSeq migration -In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A]` ("ISeq"), instead of `scala.collection.Seq[A]` ("CSeq"). This change requires some planning depending on how your code is going to be used. +In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A]` ("ISeq"), instead of `scala.collection.Seq[A]` ("CSeq"). Similarly, `scala.IndexedSeq[+A]` is an alias for `scala.collection.immutable.IndexedSeq[A]`. These changes require some planning depending on how your code is going to be used. -If you're making a library intended to be used by other programmers, then using `scala.Seq` or varargs is going to be a breaking change in the API semantics. For example, if there was a function `def orderFood(order: Seq[Order]): Seq[Food]`, previously the library user would have been able to pass in an array of `Order`, but it won't work for 2.13. +If you're making a library intended to be used by other programmers, then using `scala.Seq`, `scala.IndexedSeq`, or vararg is going to be a breaking change in the API semantics. For example, if there was a function `def orderFood(order: Seq[Order]): Seq[Food]`, previously the library user would have been able to pass in an array of `Order`, but it won't work for 2.13. - if you cross build with Scala 2.12 and want to maintain the API semantics for 2.13 version of your library, or - if your library users frequently uses mutable collections such as `Array` @@ -105,6 +106,17 @@ import scala.annotation.compileTimeOnly * This Seq trait is a dummy type to prevent the use of `Seq`. */ @compileTimeOnly("Use ISeq or CSeq") private[example] trait Seq[A1, F1[A2], A3] + +/** + * In Scala 2.13, scala.IndexedSeq moved from scala.collection.IndexedSeq to scala.collection.immutable.IndexedSeq. + * In this code base, we'll require you to name ISeq or CSeq. + * + * import scala.collection.{ IndexedSeq => CIndexedSeq } + * import scala.collection.immutable.{ IndexedSeq => IIndexedSeq } + * + * This IndexedSeq trait is a dummy type to prevent the use of `IndexedSeq`. + */ +@compileTimeOnly("Use IIndexedSeq or CIndexedSeq") private[example] trait IndexedSeq[A1, F1[A2], A3] ~~~ This might be useful during the transition period where you have to remember to import CSeq. From a0a7b9babd80592fe1ae8d01e190f6ddabe0fe11 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 20 May 2019 19:36:39 -0700 Subject: [PATCH 0482/3075] RC2 is here --- api/all.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/api/all.md b/api/all.md index 50c5bea6bc..d2caf5f5a7 100644 --- a/api/all.md +++ b/api/all.md @@ -28,10 +28,10 @@ includeTOC: true ## Prereleases -* Scala 2.13.0-RC1 - * [Library API](https://www.scala-lang.org/api/2.13.0-RC1/) - * [Compiler API](https://www.scala-lang.org/api/2.13.0-RC1/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.13.0-RC1/scala-reflect/scala/reflect/) +* Scala 2.13.0-RC2 + * [Library API](https://www.scala-lang.org/api/2.13.0-RC2/) + * [Compiler API](https://www.scala-lang.org/api/2.13.0-RC2/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.0-RC2/scala-reflect/scala/reflect/) ## Nightly builds From e498da2ff78db946b41270999cb327177c150356 Mon Sep 17 00:00:00 2001 From: Noah Rosamilia Date: Tue, 21 May 2019 10:22:10 -0400 Subject: [PATCH 0483/3075] Fix typo in implicit-parameters.md --- _tour/implicit-parameters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/implicit-parameters.md b/_tour/implicit-parameters.md index 43befb04e7..5f2c181491 100644 --- a/_tour/implicit-parameters.md +++ b/_tour/implicit-parameters.md @@ -56,7 +56,7 @@ object ImplicitTest { To show how implicit parameters work, we first define monoids `stringMonoid` and `intMonoid` for strings and integers, respectively. The `implicit` keyword indicates that the corresponding object can be used implicitly. -The method `sum` takes a `List[A]` and returns an `A`, which takes the initial `A` from `unit`, and combines each next `A` in the list to that with the `add` method. Making the parameter `m` implicit here means we only have to provide the `xs` parameter when we call the method if Scala can find a an implict `Monoid[A]` to use for the implicit `m` parameter. +The method `sum` takes a `List[A]` and returns an `A`, which takes the initial `A` from `unit`, and combines each next `A` in the list to that with the `add` method. Making the parameter `m` implicit here means we only have to provide the `xs` parameter when we call the method if Scala can find an implict `Monoid[A]` to use for the implicit `m` parameter. In our `main` method we call `sum` twice, and only provide the `xs` parameter. Scala will now look for an implicit in the scope mentioned above. The first call to `sum` passes a `List[Int]` for `xs`, which means that `A` is `Int`. The implicit parameter list with `m` is left out, so Scala will look for an implicit of type `Monoid[Int]`. The first lookup rule reads From 182cc3f73799e5537404593b20f43aa81340334c Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Tue, 21 May 2019 21:03:08 +0200 Subject: [PATCH 0484/3075] Fix typo --- _tour/implicit-parameters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/implicit-parameters.md b/_tour/implicit-parameters.md index 5f2c181491..aeb43361b4 100644 --- a/_tour/implicit-parameters.md +++ b/_tour/implicit-parameters.md @@ -56,7 +56,7 @@ object ImplicitTest { To show how implicit parameters work, we first define monoids `stringMonoid` and `intMonoid` for strings and integers, respectively. The `implicit` keyword indicates that the corresponding object can be used implicitly. -The method `sum` takes a `List[A]` and returns an `A`, which takes the initial `A` from `unit`, and combines each next `A` in the list to that with the `add` method. Making the parameter `m` implicit here means we only have to provide the `xs` parameter when we call the method if Scala can find an implict `Monoid[A]` to use for the implicit `m` parameter. +The method `sum` takes a `List[A]` and returns an `A`, which takes the initial `A` from `unit`, and combines each next `A` in the list to that with the `add` method. Making the parameter `m` implicit here means we only have to provide the `xs` parameter when we call the method if Scala can find an implicit `Monoid[A]` to use for the implicit `m` parameter. In our `main` method we call `sum` twice, and only provide the `xs` parameter. Scala will now look for an implicit in the scope mentioned above. The first call to `sum` passes a `List[Int]` for `xs`, which means that `A` is `Int`. The implicit parameter list with `m` is left out, so Scala will look for an implicit of type `Monoid[Int]`. The first lookup rule reads From 83173abf49f8dc02217c25b8564c0ce609ff0f74 Mon Sep 17 00:00:00 2001 From: Dale Wijnand Date: Tue, 21 May 2019 09:55:08 +0100 Subject: [PATCH 0485/3075] Tweak Seq migration guide --- _overviews/core/collections-migration-213.md | 117 +++++++++++++------ 1 file changed, 81 insertions(+), 36 deletions(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 730ddb34b9..71b9cbf815 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -31,65 +31,106 @@ The [scala-collection-compat](https://github.com/scala/scala-collection-compat) The module also provides [migratrion rules](https://github.com/scala/scala-collection-compat#migration-tool) for [scalafix](https://scalacenter.github.io/scalafix/docs/users/installation.html) that can update a project's source code to work with the 2.13 collections library. -## scala.Seq and scala.IndexedSeq migration +## scala.Seq, varargs and scala.IndexedSeq migration -In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A]` ("ISeq"), instead of `scala.collection.Seq[A]` ("CSeq"). Similarly, `scala.IndexedSeq[+A]` is an alias for `scala.collection.immutable.IndexedSeq[A]`. These changes require some planning depending on how your code is going to be used. +In Scala 2.13 `scala.Seq[+A]` is an alias for `scala.collection.immutable.Seq[A]`, instead of `scala.collection.Seq[A]`, and `scala.IndexedSeq[+A]` is an alias for `scala.collection.immutable.IndexedSeq[A]`. These changes require some planning depending on how your code is going to be used. -If you're making a library intended to be used by other programmers, then using `scala.Seq`, `scala.IndexedSeq`, or vararg is going to be a breaking change in the API semantics. For example, if there was a function `def orderFood(order: Seq[Order]): Seq[Food]`, previously the library user would have been able to pass in an array of `Order`, but it won't work for 2.13. +The change in definition of `scala.Seq` also has the effect of making the type of varargs parameters immutable sequences, due to [SLS 6.6][], so in +a method such as `orderFood(xs: _*)` the varargs parameter `xs` must be an immutable sequence. -- if you cross build with Scala 2.12 and want to maintain the API semantics for 2.13 version of your library, or -- if your library users frequently uses mutable collections such as `Array` +[SLS 6.6]: https://www.scala-lang.org/files/archive/spec/2.12/06-expressions.html#function-applications -you can import collection Seq explicitly in your code. +Therefore any method signature in Scala 2.13 which includes `scala.Seq`, varargs, or `scala.IndexedSeq` is going +to have a breaking change in API semantics (as the immutable sequence types require more — immutability — than the +not-immutable types). For example, users of a method like `def orderFood(order: Seq[Order]): Seq[Food]` would +previously have been able to pass in an `ArrayBuffer` of `Order`, but cannot in 2.13. + +### Migrating varargs + +The change for varargs is unavoidable, as you cannot change the type used at definition site. The options +available for migrating the usage sites are the following: + +- change the value to already be an immutable sequence, which allows for direct varargs usage: `xs: _*`, +- change the value to be an immutable sequence on the fly by calling `.toSeq`: `xs.toSeq: _*`, which will only + copy data if the sequence wasn't already immutable +- use `scala.collection.immutable.ArraySeq.unsafeWrapArray` to wrap your array and avoid copying, but see its + scaladoc + +### Option 1: migrate back to scala.collection.Seq + +The first, in some ways simplest, migration strategy for all non-varargs usages of `scala.Seq` is to replace +them with `scala.collection.Seq` (and require users to call `.toSeq` or `unsafeWrapArray` when passing such +sequences to varargs methods). + +We recommend using `import scala.collection`/`import scala.collection.immutable` and +`collection.Seq`/`immutable.Seq`. + +We recommend against using `import scala.collection.Seq`, which shadows the automatically imported `scala.Seq`, +because even if it's a oneline change it causes name confusion. For code generation or macros the safest option +is using the fully-qualified `_root_.scala.collection.Seq`. + +As an example, the migration would look something like this: ~~~ scala -import scala.collection.Seq +import scala.collection object FoodToGo { - def orderFood(order: Seq[Order]): Seq[Food] + def orderFood(order: collection.Seq[Order]): collection.Seq[Food] } ~~~ -Note that this might still break the source compatibility if `scala.Seq` (or just `Seq`) appears in the source code. +However users of this code in Scala 2.13 would also have to migrate, as the result type is source-incompatible +with any `scala.Seq` (or just `Seq`) usage in their code: ~~~ scala val food: Seq[Food] = FoodToGo.orderFood(order) // won't compile ~~~ -Since `Seq`, an alias for ISeq in 2.13, is narrower than CSeq, the above code will no longer compile. One workaround would be to ask your users to add `toSeq`, which returns ISeq. +The simplest workaround is to ask your users to call `.toSeq` on the result which will return an immutable Seq, +and only copy data if the sequence wasn't immutable: ~~~ scala val food: Seq[Food] = FoodToGo.orderFood(order).toSeq // add .toSeq ~~~ -Another workaround might be to accept CSeq, but return ISeq. +### Option 2: use scala.collection.Seq for parameters and scala.collection.immutable.Seq for result types + +The second, intermediate, migration strategy would be to change all methods to accept not-immutable Seq but +return immutable Seq, following the [robustness principle][] (also known as "Postel's law"): + +[robustness principle]: https://en.wikipedia.org/wiki/Robustness_principle ~~~ scala -import scala.collection.{ Seq => CSeq } -import scala.collection.immutable.{ Seq => ISeq } +import scala.collection +import scala.collection.immutable object FoodToGo { - def orderFood(order: CSeq[Order]): ISeq[Food] + def orderFood(order: collection.Seq[Order]): immutable.Seq[Food] } ~~~ -In the future when your API is able to break the source compatibility, it might also make sense to migrate towards ISeq for both Scala 2.12 and Scala 2.13. +### Option 3: use immutable sequences + +The third migration strategy is to change your API to use immutable sequences for both parameter and result +types. When cross-building your library for Scala 2.12 and 2.13 this could either mean: + +- continuing to use `scala.Seq` which means it stays source and binary-compatible in 2.12, but would have to + have immutable sequence semantics (but that might already be the case). +- switch to explicitly using immutable Seq in both Scala 2.12 and 2.13, which means breaking source, binary and + (possibly) semantic compatibility in 2.12: ~~~ scala -import scala.collection.immutable.{ Seq => ISeq } +import scala.collection.immutable object FoodToGo { - def orderFood(order: ISeq[Order]): ISeq[Food] + def orderFood(order: immutable.Seq[Order]): immutable.Seq[Food] } ~~~ -Similarly, if you're making an end-user application, unifying to CSeq might be the easier and safer initial path especially for a larger and complex code base. Switching to ISeq will be a more advanced refactoring. - -Note that in Scala 2.13 the sequence passed into as a varargs as `orderFood(xs: _*)` must also be immutable. This is because the sequence passed in as a varargs must conform to `scala.Seq` according to [SLS 6.6](https://www.scala-lang.org/files/archive/spec/2.12/06-expressions.html#function-applications). Thus, if your API exposes varargs it will be an unavoidable breaking change. This might affect Java interoperability. - -### Masking scala.Seq +### Shadowing scala.Seq and scala.IndexedSeq -To use the compiler to bad the use of plain `Seq`, you can declare your own `Seq` to mask `scala.Seq`. +You maybe be interested in entirely banning plain `Seq` usage. You can use the compiler to do so by declaring +your own package-level (and package private) `Seq` type which will mask `scala.Seq`. ~~~ scala package example @@ -97,29 +138,33 @@ package example import scala.annotation.compileTimeOnly /** - * In Scala 2.13, scala.Seq moved from scala.collection.Seq to scala.collection.immutable.Seq. - * In this code base, we'll require you to name ISeq or CSeq. + * In Scala 2.13, `scala.Seq` changed from aliasing `scala.collection.Seq` to aliasing + * `scala.collection.immutable.Seq`. In this code base usage of unqualified `Seq` is banned: use + * `immutable.Seq` or `collection.Seq` instead. * - * import scala.collection.{ Seq => CSeq } - * import scala.collection.immutable.{ Seq => ISeq } + * import scala.collection + * import scala.collection.immutable * - * This Seq trait is a dummy type to prevent the use of `Seq`. + * This `Seq` trait is a dummy type to prevent the use of `Seq`. */ -@compileTimeOnly("Use ISeq or CSeq") private[example] trait Seq[A1, F1[A2], A3] +@compileTimeOnly("Use immutable.Seq or collection.Seq") +private[example] trait Seq[A1] /** - * In Scala 2.13, scala.IndexedSeq moved from scala.collection.IndexedSeq to scala.collection.immutable.IndexedSeq. - * In this code base, we'll require you to name ISeq or CSeq. + * In Scala 2.13, `scala.IndexedSeq` changed from aliasing `scala.collection.IndexedSeq` to aliasing + * `scala.collection.immutable.IndexedSeq`. In this code base usage of unqualified `IndexedSeq` is + * banned: use `immutable.IndexedSeq` or `collection.IndexedSeq`. * - * import scala.collection.{ IndexedSeq => CIndexedSeq } - * import scala.collection.immutable.{ IndexedSeq => IIndexedSeq } + * import scala.collection + * import scala.collection.immutable * - * This IndexedSeq trait is a dummy type to prevent the use of `IndexedSeq`. + * This `IndexedSeq` trait is a dummy type to prevent the use of `IndexedSeq`. */ -@compileTimeOnly("Use IIndexedSeq or CIndexedSeq") private[example] trait IndexedSeq[A1, F1[A2], A3] +@compileTimeOnly("Use immutable.IndexedSeq or collection.IndexedSeq") +private[example] trait IndexedSeq[A1] ~~~ -This might be useful during the transition period where you have to remember to import CSeq. +This might be useful during the migration to catch usages of unqualified `Seq` and `IndexedSeq`. ## What are the breaking changes? From a527db979319fd7689897661d5443ca81514c280 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" Date: Thu, 23 May 2019 11:33:21 +0000 Subject: [PATCH 0486/3075] Bump nokogiri from 1.8.4 to 1.8.5 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.8.4 to 1.8.5. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/master/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.8.4...v1.8.5) --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 4157511c7d..de18a3160a 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -61,7 +61,7 @@ GEM mercenary (0.3.6) mini_portile2 (2.3.0) minitest (5.11.3) - nokogiri (1.8.4) + nokogiri (1.8.5) mini_portile2 (~> 2.3.0) parallel (1.12.1) pathutil (0.16.1) From 3b4357de9f9569257d793330cbf5b49d9caea9e0 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" Date: Thu, 23 May 2019 11:33:47 +0000 Subject: [PATCH 0487/3075] Bump jekyll from 3.8.3 to 3.8.5 Bumps [jekyll](https://github.com/jekyll/jekyll) from 3.8.3 to 3.8.5. - [Release notes](https://github.com/jekyll/jekyll/releases) - [Changelog](https://github.com/jekyll/jekyll/blob/master/History.markdown) - [Commits](https://github.com/jekyll/jekyll/compare/v3.8.3...v3.8.5) --- Gemfile.lock | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 4157511c7d..16afcdf020 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -6,18 +6,18 @@ GEM i18n (>= 0.7, < 2) minitest (~> 5.1) tzinfo (~> 1.1) - addressable (2.5.2) + addressable (2.6.0) public_suffix (>= 2.0.2, < 4.0) colorator (1.1.0) colorize (0.8.1) - concurrent-ruby (1.0.5) + concurrent-ruby (1.1.5) em-websocket (0.5.1) eventmachine (>= 0.12.9) http_parser.rb (~> 0.6.0) ethon (0.11.0) ffi (>= 1.3.0) eventmachine (1.2.7) - ffi (1.9.25) + ffi (1.11.1) forwardable-extended (2.6.0) html-proofer (3.9.1) activesupport (>= 4.2, < 6.0) @@ -31,7 +31,7 @@ GEM http_parser.rb (0.6.0) i18n (0.9.5) concurrent-ruby (~> 1.0) - jekyll (3.8.3) + jekyll (3.8.5) addressable (~> 2.4) colorator (~> 1.0) em-websocket (~> 0.5) @@ -50,10 +50,10 @@ GEM sass (~> 3.4) jekyll-scalafiddle (1.0.1) jekyll (~> 3.0) - jekyll-watch (2.0.0) + jekyll-watch (2.2.1) listen (~> 3.0) kramdown (1.17.0) - liquid (4.0.0) + liquid (4.0.3) listen (3.1.5) rb-fsevent (~> 0.9, >= 0.9.4) rb-inotify (~> 0.9, >= 0.9.7) @@ -64,16 +64,16 @@ GEM nokogiri (1.8.4) mini_portile2 (~> 2.3.0) parallel (1.12.1) - pathutil (0.16.1) + pathutil (0.16.2) forwardable-extended (~> 2.6) - public_suffix (3.0.2) + public_suffix (3.0.3) rb-fsevent (0.10.3) - rb-inotify (0.9.10) - ffi (>= 0.5.0, < 2) - rouge (3.1.1) + rb-inotify (0.10.0) + ffi (~> 1.0) + rouge (3.3.0) ruby_dep (1.5.0) - safe_yaml (1.0.4) - sass (3.5.7) + safe_yaml (1.0.5) + sass (3.7.4) sass-listen (~> 4.0.0) sass-listen (4.0.0) rb-fsevent (~> 0.9, >= 0.9.4) From debd78f1d8d123c3b9da4c89027638728fbc42c2 Mon Sep 17 00:00:00 2001 From: Filipe Regadas Date: Mon, 27 May 2019 18:29:35 -0400 Subject: [PATCH 0488/3075] Fix invalid universe import --- _overviews/quasiquotes/lifting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/quasiquotes/lifting.md b/_overviews/quasiquotes/lifting.md index 2c6126a789..c28082b716 100644 --- a/_overviews/quasiquotes/lifting.md +++ b/_overviews/quasiquotes/lifting.md @@ -49,7 +49,7 @@ To define tree representation for your own data type just provide an implicit in package points - import scala.universe._ + import scala.reflect.runtime.universe._ case class Point(x: Int, y: Int) object Point { From 5e5b22979ca2a1c431588c79f6cc73267858b655 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Thu, 30 May 2019 17:14:15 +0800 Subject: [PATCH 0489/3075] Fix Chinese Simple(zh_CN) version of issue#1339, which is refining pattern matching. --- _zh-cn/tour/pattern-matching.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_zh-cn/tour/pattern-matching.md b/_zh-cn/tour/pattern-matching.md index 8f03480ac6..c9727b304d 100644 --- a/_zh-cn/tour/pattern-matching.md +++ b/_zh-cn/tour/pattern-matching.md @@ -28,19 +28,19 @@ x match { case 0 => "zero" case 1 => "one" case 2 => "two" - case _ => "many" + case _ => "other" } ``` -上述代码中的`val x`是一个0到10之间的随机整数，将它放在`match`运算符的左侧对其进行模式匹配，`match`的右侧是包含4条`case`的表达式，其中最后一个`case _`表示匹配其余所有情况，在这里即是`x`大于2的情况。 +上述代码中的`val x`是一个0到10之间的随机整数，将它放在`match`运算符的左侧对其进行模式匹配，`match`的右侧是包含4条`case`的表达式，其中最后一个`case _`表示匹配其余所有情况，在这里就是其他可能的整型值。 `match`表达式具有一个结果值 ```tut def matchTest(x: Int): String = x match { case 1 => "one" case 2 => "two" - case _ => "many" + case _ => "other" } -matchTest(3) // many +matchTest(3) // other matchTest(1) // one ``` 这个`match`表达式是String类型的，因为所有的情况（case）均返回String，所以`matchTest`函数的返回值是String类型。 From 099fe2fcd30d42e296cf504ee5687582755f9bf0 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Fri, 31 May 2019 12:46:00 +0800 Subject: [PATCH 0490/3075] Fix Chinese Simple(zh_CN) version of issue#1339, based on commit https://github.com/scala/docs.scala-lang/commit/ff6580c6247ee091b4805335a67480f2153c3bec. --- _zh-cn/tour/pattern-matching.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_zh-cn/tour/pattern-matching.md b/_zh-cn/tour/pattern-matching.md index c9727b304d..7ea9fec48e 100644 --- a/_zh-cn/tour/pattern-matching.md +++ b/_zh-cn/tour/pattern-matching.md @@ -66,8 +66,8 @@ case class VoiceRecording(contactName: String, link: String) extends Notificatio ``` def showNotification(notification: Notification): String = { notification match { - case Email(email, title, _) => - s"You got an email from $email with title: $title" + case Email(sender, title, _) => + s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" case VoiceRecording(name, link) => @@ -81,7 +81,7 @@ println(showNotification(someSms)) // prints You got an SMS from 12345! Message println(showNotification(someVoiceRecording)) // you received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123 ``` -`showNotification`函数接受一个抽象类`Notification`对象作为输入参数，然后匹配其具体类型。（也就是判断它是一个`Email`，`SMS`，还是`VoiceRecording`）。在`case Email(email, title, _)`中，对象的`email`和`title`属性在返回值中被使用，而`body`属性则被忽略，故使用`_`代替。 +`showNotification`函数接受一个抽象类`Notification`对象作为输入参数，然后匹配其具体类型。（也就是判断它是一个`Email`，`SMS`，还是`VoiceRecording`）。在`case Email(sender, title, _)`中，对象的`sender`和`title`属性在返回值中被使用，而`body`属性则被忽略，故使用`_`代替。 ## 模式守卫（Pattern gaurds） 为了让匹配更加具体，可以使用模式守卫，也就是在模式后面加上`if `。 @@ -89,7 +89,7 @@ println(showNotification(someVoiceRecording)) // you received a Voice Recording def showImportantNotification(notification: Notification, importantPeopleInfo: Seq[String]): String = { notification match { - case Email(email, _, _) if importantPeopleInfo.contains(email) => + case Email(sender, _, _) if importantPeopleInfo.contains(sender) => "You got an email from special someone!" case SMS(number, _) if importantPeopleInfo.contains(number) => "You got an SMS from special someone!" @@ -111,7 +111,7 @@ println(showImportantNotification(importantEmail, importantPeopleInfo)) println(showImportantNotification(importantSms, importantPeopleInfo)) ``` -在`case Email(email, _, _) if importantPeopleInfo.contains(email)`中，除了要求`notification`是`Email`类型外，还需要`email`在重要人物列表`importantPeopleInfo`中，才会匹配到该模式。 +在`case Email(sender, _, _) if importantPeopleInfo.contains(sender)`中，除了要求`notification`是`Email`类型外，还需要`sender`在重要人物列表`importantPeopleInfo`中，才会匹配到该模式。 ## 仅匹配类型 From 1c7b5b6f9f7e7fea1b26206759215dd1a7491862 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 31 May 2019 22:01:55 +0200 Subject: [PATCH 0491/3075] hello Scala 2.13.0-RC3 --- api/all.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/api/all.md b/api/all.md index d2caf5f5a7..77ecd28618 100644 --- a/api/all.md +++ b/api/all.md @@ -28,10 +28,10 @@ includeTOC: true ## Prereleases -* Scala 2.13.0-RC2 - * [Library API](https://www.scala-lang.org/api/2.13.0-RC2/) - * [Compiler API](https://www.scala-lang.org/api/2.13.0-RC2/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.13.0-RC2/scala-reflect/scala/reflect/) +* Scala 2.13.0-RC3 + * [Library API](https://www.scala-lang.org/api/2.13.0-RC3/) + * [Compiler API](https://www.scala-lang.org/api/2.13.0-RC3/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.0-RC3/scala-reflect/scala/reflect/) ## Nightly builds From 0e3b437e0a73d31900a8c702ac28e6454cde63e2 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Sun, 2 Jun 2019 11:16:32 +0800 Subject: [PATCH 0492/3075] Fix Chinese Simple(zh_CN) version of issue#1339, based on commit https://github.com/scala/docs.scala-lang/commit/55ed64e205d80298f59a6724bd7c44a26ec6e0e7 (Fix: should extend NotUniversal trait) --- _zh-cn/overviews/core/value-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/core/value-classes.md b/_zh-cn/overviews/core/value-classes.md index 85014abdb8..b731b9da0e 100644 --- a/_zh-cn/overviews/core/value-classes.md +++ b/_zh-cn/overviews/core/value-classes.md @@ -226,7 +226,7 @@ value class不能将惰性val或val作为成员，也不能有嵌套类、trait value类不能继承non-universal trait，并且其本身不能被继承： trait NotUniversal - class Value(val x: Int) extends AnyVal with notUniversal + class Value(val x: Int) extends AnyVal with NotUniversal class Extend(x: Int) extends Value(x) Extend.scala:2: error: illegal inheritance; superclass AnyVal From 749a5dce75eb7a794e5eb075b6b4c36b435f9dd6 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Sun, 2 Jun 2019 12:05:38 +0800 Subject: [PATCH 0493/3075] Fix Chinese Simple(zh_CN) version of issue#1339, based on the latest commit of English originals. --- ...ions-between-java-and-scala-collections.md | 35 +++++++++++-------- 1 file changed, 20 insertions(+), 15 deletions(-) diff --git a/_zh-cn/overviews/collections/conversions-between-java-and-scala-collections.md b/_zh-cn/overviews/collections/conversions-between-java-and-scala-collections.md index 9b8e44daf0..341dce3d87 100644 --- a/_zh-cn/overviews/collections/conversions-between-java-and-scala-collections.md +++ b/_zh-cn/overviews/collections/conversions-between-java-and-scala-collections.md @@ -16,14 +16,15 @@ language: zh-cn 某些时候，你需要将一种容器类型转换成另外一种类型。例如，你可能想要像访问Scala容器一样访问某个Java容器，或者你可能想将一个Scala容器像Java容器一样传递给某个Java方法。在Scala中，这是很容易的，因为Scala提供了大量的方法来隐式转换所有主要的Java和Scala容器类型。其中提供了如下的双向类型转换： - Iterator <=> java.util.Iterator - Iterator <=> java.util.Enumeration - Iterable <=> java.lang.Iterable - Iterable <=> java.util.Collection - mutable.Buffer <=> java.util.List - mutable.Set <=> java.util.Set - mutable.Map <=> java.util.Map - mutable.ConcurrentMap <=> java.util.concurrent.ConcurrentMap + + Iterator <=> java.util.Iterator + Iterator <=> java.util.Enumeration + Iterable <=> java.lang.Iterable + Iterable <=> java.util.Collection + mutable.Buffer <=> java.util.List + mutable.Set <=> java.util.Set + mutable.Map <=> java.util.Map + mutable.ConcurrentMap <=> java.util.concurrent.ConcurrentMap 使用这些转换很简单，只需从JavaConverters对象中import它们即可。 @@ -34,26 +35,30 @@ import之后，通过扩展方法 asScala 和 asJava 就可以在Scala容器和 scala> import collection.mutable._ import collection.mutable._ + scala> val jul: java.util.List[Int] = ArrayBuffer(1, 2, 3).asJava jul: java.util.List[Int] = [1, 2, 3] + scala> val buf: Seq[Int] = jul.asScala buf: scala.collection.mutable.Seq[Int] = ArrayBuffer(1, 2, 3) + scala> val m: java.util.Map[String, Int] = HashMap("abc" -> 1, "hello" -> 2).asJava - m: java.util.Map[String, Int] = {hello=2, abc=1} + m: java.util.Map[String,Int] = {abc=1, hello=2} 在Scala内部，这些转换是通过一系列“包装”对象完成的，这些对象会将相应的方法调用转发至底层的容器对象。所以容器不会在Java和Scala之间拷贝来拷贝去。一个值得注意的特性是，如果你将一个Java容器转换成其对应的Scala容器，然后再将其转换回同样的Java容器，最终得到的是一个和一开始完全相同的容器对象（译注：这里的相同意味着这两个对象实际上是指向同一片内存区域的引用，容器转换过程中没有任何的拷贝发生）。 还有一些Scala容器类型可以转换成对应的Java类型，但是并没有将相应的Java类型转换成Scala类型的能力，它们是： - Seq => java.util.List - mutable.Seq => java.util.List - Set => java.util.Set - Map => java.util.Map + Seq => java.util.List + mutable.Seq => java.util.List + Set => java.util.Set + Map => java.util.Map 因为Java并未区分可变容器不可变容器类型，所以，虽然能将`scala.immutable.List`转换成`java.util.List`，但所有的修改操作都会抛出“UnsupportedOperationException”。参见下例： - scala> jul = List(1, 2, 3).asJava + scala> val jul = List(1, 2, 3).asJava jul: java.util.List[Int] = [1, 2, 3] + scala> jul.add(7) java.lang.UnsupportedOperationException - at java.util.AbstractList.add(AbstractList.java:131) + at java.util.AbstractList.add(AbstractList.java:148) From 2893df074cdf8372a0591cde341fe58c2d1414c8 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Sun, 2 Jun 2019 12:09:13 +0800 Subject: [PATCH 0494/3075] Typo in _overviews/collections/conversions-between-java-and-scala-collections.md . --- .../conversions-between-java-and-scala-collections.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections/conversions-between-java-and-scala-collections.md b/_overviews/collections/conversions-between-java-and-scala-collections.md index fb184cfac2..c476d4369c 100644 --- a/_overviews/collections/conversions-between-java-and-scala-collections.md +++ b/_overviews/collections/conversions-between-java-and-scala-collections.md @@ -46,7 +46,7 @@ This enables conversions between Scala collections and their corresponding Java scala> val m: java.util.Map[String, Int] = HashMap("abc" -> 1, "hello" -> 2).asJava m: java.util.Map[String,Int] = {abc=1, hello=2} -Internally, these conversion work by setting up a "wrapper" object that forwards all operations to the underlying collection object. So collections are never copied when converting between Java and Scala. An interesting property is that if you do a round-trip conversion from, say a Java type to its corresponding Scala type, and back to the same Java type, you end up with the identical collection object you have started with. +Internally, these conversions work by setting up a "wrapper" object that forwards all operations to the underlying collection object. So collections are never copied when converting between Java and Scala. An interesting property is that if you do a round-trip conversion from, say a Java type to its corresponding Scala type, and back to the same Java type, you end up with the identical collection object you have started with. Certain other Scala collections can also be converted to Java, but do not have a conversion back to the original Scala type: From 4f7da4a9fa605139d8dcefc69fd011e5dd9c25ab Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Mon, 3 Jun 2019 10:32:39 +0800 Subject: [PATCH 0495/3075] Fix the contents layout of _zh-cn/overviews/collections/seqs.md . --- _zh-cn/overviews/collections/seqs.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_zh-cn/overviews/collections/seqs.md b/_zh-cn/overviews/collections/seqs.md index c9640efd99..adee18c33f 100644 --- a/_zh-cn/overviews/collections/seqs.md +++ b/_zh-cn/overviews/collections/seqs.md @@ -27,7 +27,7 @@ language: zh-cn 如果一个序列是可变的，它提供了另一种更新序列中的元素的，但有副作用的update方法，Scala中常有这样的语法，如seq(idx) = elem。它只是seq.update(idx, elem)的简写，所以update 提供了方便的赋值语法。应注意update 和updated之间的差异。update 再原来基础上更改序列中的元素，并且仅适用于可变序列。而updated 适用于所有的序列，它总是返回一个新序列，而不会修改原序列。 -## Seq类的操作 +### Seq类的操作 | WHAT IT IS | WHAT IT DOES | |------------------ | -------------------| @@ -79,13 +79,13 @@ language: zh-cn 常用线性序列有 `scala.collection.immutable.List`和`scala.collection.immutable.Stream`。常用索引序列有 `scala.Array scala.collection.mutable.ArrayBuffer`。Vector 类提供一个在索引访问和线性访问之间有趣的折中。它同时具有高效的恒定时间的索引开销，和恒定时间的线性访问开销。正因为如此，对于混合访问模式，vector是一个很好的基础。后面将详细介绍vector。 -## 缓冲器 +### 缓冲器 Buffers是可变序列一个重要的种类。它们不仅允许更新现有的元素，而且允许元素的插入、移除和在buffer尾部高效地添加新元素。buffer 支持的主要新方法有：用于在尾部添加元素的 `+=` 和 `++=`；用于在前方添加元素的`+=: `和` ++=:` ；用于插入元素的 `insert`和`insertAll`；以及用于删除元素的` remove` 和 `-=`。如下表所示。 ListBuffer和ArrayBuffer是常用的buffer实现 。顾名思义，ListBuffer依赖列表（List），支持高效地将它的元素转换成列表。而ArrayBuffer依赖数组（Array），能快速地转换成数组。 -## Buffer类的操作 +#### Buffer类的操作 | WHAT IT IS | WHAT IT DOES | |--------------------- | -----------------------| From 1a3243214af43a3fe9a1c07b073b6a35b3b43941 Mon Sep 17 00:00:00 2001 From: Alexander Ronsse-Tucherov Date: Tue, 4 Jun 2019 17:40:55 -0700 Subject: [PATCH 0496/3075] Change "seemless" to "seamless" --- _overviews/tutorials/scala-for-java-programmers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index ada65a08f7..3ed8305c2a 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -99,7 +99,7 @@ French-speaking part of Switzerland use the same conventions.) Java's class libraries define powerful utility classes, such as `Date` and `DateFormat`. Since Scala interoperates -seemlessly with Java, there is no need to implement equivalent +seamlessly with Java, there is no need to implement equivalent classes in the Scala class library--we can simply import the classes of the corresponding Java packages: From 7b31ea8f5a8a44678761080566a557009b0d8c36 Mon Sep 17 00:00:00 2001 From: Changlin Li Date: Wed, 5 Jun 2019 21:05:27 -0400 Subject: [PATCH 0497/3075] Fix buggy Regex definition The original Regex definition doesn't fully match the `background-image` value. --- _tour/regular-expression-patterns.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_tour/regular-expression-patterns.md b/_tour/regular-expression-patterns.md index ec07f9f368..2e0670879e 100644 --- a/_tour/regular-expression-patterns.md +++ b/_tour/regular-expression-patterns.md @@ -35,7 +35,7 @@ You can also search for groups of regular expressions using parentheses. ```tut import scala.util.matching.Regex -val keyValPattern: Regex = "([0-9a-zA-Z-#() ]+): ([0-9a-zA-Z-#() ]+)".r +val keyValPattern: Regex = "([0-9a-zA-Z- ]+): ([0-9a-zA-Z-#()/. ]+)".r val input: String = """background-color: #A03300; @@ -53,7 +53,7 @@ for (patternMatch <- keyValPattern.findAllMatchIn(input)) Here we parse out the keys and values of a String. Each match has a group of sub-matches. Here is the output: ``` key: background-color value: #A03300 -key: background-image value: url(img +key: background-image value: url(img/header100.png) key: background-position value: top center key: background-repeat value: repeat-x key: background-size value: 2160px 108px From b3bd621d8e8ddda1b726aa8c473186dd996447ed Mon Sep 17 00:00:00 2001 From: cclaudiu81 Date: Fri, 7 Jun 2019 00:30:42 +0300 Subject: [PATCH 0498/3075] Update higher-order-functions.md enhanced doc on methods that take fns as args --- _tour/higher-order-functions.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_tour/higher-order-functions.md b/_tour/higher-order-functions.md index efc8d37db2..d6d1681894 100644 --- a/_tour/higher-order-functions.md +++ b/_tour/higher-order-functions.md @@ -60,6 +60,8 @@ case class WeeklyWeatherForecast(temperatures: Seq[Double]) { ``` Here the method `convertCtoF` is passed to `forecastInFahrenheit`. This is possible because the compiler coerces `convertCtoF` to the function `x => convertCtoF(x)` (note: `x` will be a generated name which is guaranteed to be unique within its scope). + +In a pure Object Oriented world a good practice is to avoid exposing methods that are parameterized with functions that might escape the internal state of the objects. Leaking internal state might break the invariants of the object itself. ## Functions that accept functions One reason to use higher-order functions is to reduce redundant code. Let's say you wanted some methods that could raise someone's salaries by various factors. Without creating a higher-order function, From 6fefeb9bb018ff59592638d0ce2c8967845c39ca Mon Sep 17 00:00:00 2001 From: Red Liu Date: Sat, 8 Jun 2019 11:03:27 +0800 Subject: [PATCH 0499/3075] Fix translations of class for zh-cn --- _zh-cn/tour/classes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_zh-cn/tour/classes.md b/_zh-cn/tour/classes.md index e916677681..4e7ee73bc9 100644 --- a/_zh-cn/tour/classes.md +++ b/_zh-cn/tour/classes.md @@ -19,7 +19,7 @@ prerequisite-knowledge: no-return-keyword, type-declaration-syntax, string-inter Scala中的类是用于创建对象的蓝图，其中包含了方法、常量、变量、类型、对象、特质、类，这些统称为成员。类型、对象和特质将在后面的文章中介绍。 ## 类定义 -一个最简的类的定义就是关键字`class`+标识符，类名必须是大写。 +一个最简的类的定义就是关键字`class`+标识符，类名首字母应大写。 ```tut class User @@ -69,7 +69,7 @@ println(point2.y) // prints 2 这样的做法在实践中有利于使得表达明确无误。 ## 私有成员和Getter/Setter语法 -成员默认是公有（`public`）的。使用`private`访问修饰符可以在函数外部隐藏它们。 +成员默认是公有（`public`）的。使用`private`访问修饰符可以在类外部隐藏它们。 ```tut class Point { private var _x = 0 From d7d2d9b5d3893e50c87c14565dec66f8fb7e8a51 Mon Sep 17 00:00:00 2001 From: "Aaron S. Hawley" Date: Sun, 9 Jun 2019 11:19:51 -0400 Subject: [PATCH 0500/3075] Remove feedback section from Scalameta post Gitter link is a 404 not found --- _sips/sips/2016-09-09-inline-meta.md | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/_sips/sips/2016-09-09-inline-meta.md b/_sips/sips/2016-09-09-inline-meta.md index 803d6dfc05..3aae1b3fed 100644 --- a/_sips/sips/2016-09-09-inline-meta.md +++ b/_sips/sips/2016-09-09-inline-meta.md @@ -26,9 +26,6 @@ We did our best to extensively evaluate the design space and comprehensively doc As a result, this is going to be a very long read. If you're just interested in getting a quick idea of the proposal, you can read just the ["Intuition"][Intuition] section. -If you have any questions, feedback or ideas regarding this document, use the link provided -in the ["Feedback"][FeedbackSection] section to join the public discussion. - ## Motivation Def macros and macro annotations have become an integral @@ -71,7 +68,6 @@ and coming up with a lightweight declaration syntax. In this document, we presen * [Out of scope](#out-of-scope) * [Conclusion](#conclusion) * [Credits](#credits) - * [Feedback](#feedback) ## Intuition @@ -983,12 +979,6 @@ Tamer Mohammed Abdul-Radi, David Dudson, Takeshi D. Itoh, Oleksandr Olgashko and The prototype of IntelliJ integration was developed by Mikhail Mutcianko. -## Feedback - -In order to centralize the discussion, post your feedback and ideas to [http://gitter.im/scalameta/sips][FeedbackWebsite]. -Once we submit this document as a full-fledged SIP, we will update this section to include the official discussion forum -mandated by the SIP process. - ## References 1. [Prototype of scalac integration][PrototypeScalac] @@ -1019,8 +1009,6 @@ mandated by the SIP process. [AnonymousTypeProviders]: http://docs.scala-lang.org/overviews/macros/typeproviders.html#anonymous-type-providers [ExtractorMacros]: https://docs.scala-lang.org/overviews/macros/extractors.html [AnnotationsTypecheck]: https://github.com/scalamacros/paradise/issues/75 -[FeedbackSection]: #feedback -[FeedbackWebsite]: http://gitter.im/scalameta/sips [AppendixInteraction]: https://gist.github.com/xeno-by/e26a904051a171e4bc8b9096630220a7 [AppendixExpansion]: https://gist.github.com/xeno-by/5dde62aedcc23afc85ecf4d795ac67c2 [AppendixMeta]: https://gist.github.com/xeno-by/9741ce7532cb30368b3753521bbfce4e From dbab980783ce676f59f616ad815e237ec417d12e Mon Sep 17 00:00:00 2001 From: "Aaron S. Hawley" Date: Fri, 7 Jun 2019 08:50:51 -0400 Subject: [PATCH 0501/3075] Add generating Scaladoc --- _overviews/scaladoc/generate.md | 55 +++++++++++++++++++++++++++++++++ _overviews/scaladoc/overview.md | 5 +-- 2 files changed, 58 insertions(+), 2 deletions(-) create mode 100644 _overviews/scaladoc/generate.md diff --git a/_overviews/scaladoc/generate.md b/_overviews/scaladoc/generate.md new file mode 100644 index 0000000000..a57e4cb0cb --- /dev/null +++ b/_overviews/scaladoc/generate.md @@ -0,0 +1,55 @@ +--- +layout: multipage-overview +title: Generating Scaladoc + +discourse: true + +partof: scaladoc +overview-name: Scaladoc + +num: 4 + +permalink: /overviews/scaladoc/:title.html +--- + +There are two ways to generate API documentation in HTML from your Scala code. Those options are: + +* use sbt to do it, +* use the scaladoc command-line tool. + +## Using sbt + +The easiest and most commonly used way to generate API documentation from your Scala code is with the build tool [sbt](https://www.scala-sbt.org). + +From the sbt console, run Scaladoc by simply running the `doc` task: + + > doc + [info] Main Scala API documentation to target/scala-2.12/api... + [info] model contains 1 documentable templates + [info] Main Scala API documentation successful. + [success] Total time: 20 s + +The HTML documentation will show up in the respective `target/` directory (or directories for builds with multiple projects) that sbt prints to the console output. + +For more information on using sbt on your system, see the [download instructions](https://www.scala-lang.org/download/) for [getting started with Scala and sbt on the command line]({{site.baseurl}}/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html). + +For additional information about configuring Scaladoc in sbt, see the [Generate API documentation](https://www.scala-sbt.org/1.x/docs/Howto-Scaladoc.html) section of the sbt reference manual. + +## Using scaladoc command + +If you use Scala commands directly to start a console with `scala` or compile with `scalac`, then you should have a `scaladoc` command-line utility, as well. This is a more advanced and less commonly used method of generating Scaladoc. + + $ scaladoc src/main/scala/App.scala + model contains 1 documentable templates + +This will put the HTML in the current directory. This is probably not what you want. It's preferable to output to a subdirectory. To specify a different target directory, use the `-d` commmand-line option: + + $ scaladoc -d build/ src/main/scala/App.scala + +For more information on the `scaladoc` command and what other command-line options it supports, see the [scaladoc man page](https://www.scala-lang.org/files/archive/nightly/docs/manual/html/scaladoc.html). + +This command is harder to operate with more complex projects containing both multiple Scala source files and library dependencies. This is why using sbt (see above) is easier and better suited for generating Scaladoc. + +The Scaladoc command exists because it precedied the development of sbt, but also because it is useful to the Scala development team with studying bug reports for Scaladoc. + +More information on directly using the Scala commands, like `scaladoc`, is discussed at [your first lines of Scala](https://www.scala-lang.org/documentation/your-first-lines-of-scala.html). diff --git a/_overviews/scaladoc/overview.md b/_overviews/scaladoc/overview.md index efe893b729..b31aea8ef5 100644 --- a/_overviews/scaladoc/overview.md +++ b/_overviews/scaladoc/overview.md @@ -17,10 +17,11 @@ system that lives in the comments of Scala source code and which generates documentation related to the code structure within which it is written. It is based on other comment based documentation systems like Javadoc. -There are two flavors of Scaladoc documentation: +There are three aspects of Scaladoc documentation: - **[Using the Scaladoc interface]({{ site.baseurl }}/overviews/scaladoc/interface.html)** – how to navigate and use generated Scaladoc documentation to learn more about a library. - - **[Generating documentation for your library with Scaladoc]({{ site.baseurl }}/overviews/scaladoc/for-library-authors.html)** – how to use Scaladoc to generate documentation for your library. + - **[Scaladoc for Library Authors]({{ site.baseurl }}/overviews/scaladoc/for-library-authors.html)** – how to add Scaladoc comments to generate documentation for your library. + - **[Generating documentation for your library with Scaladoc]({{ site.baseurl }}/overviews/scaladoc/generate.html)** – how to use Scaladoc to generate documentation for your library. ### Contributing to Scaladoc From 7b46f87893a3267a6eac82fec10ae38526996ea6 Mon Sep 17 00:00:00 2001 From: "Aaron S. Hawley" Date: Sun, 9 Jun 2019 08:55:24 -0400 Subject: [PATCH 0502/3075] Fix typos and spellings on Scaladoc page --- _overviews/scaladoc/generate.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scaladoc/generate.md b/_overviews/scaladoc/generate.md index a57e4cb0cb..d50b19c5b7 100644 --- a/_overviews/scaladoc/generate.md +++ b/_overviews/scaladoc/generate.md @@ -42,7 +42,7 @@ If you use Scala commands directly to start a console with `scala` or compile wi $ scaladoc src/main/scala/App.scala model contains 1 documentable templates -This will put the HTML in the current directory. This is probably not what you want. It's preferable to output to a subdirectory. To specify a different target directory, use the `-d` commmand-line option: +This will put the HTML in the current directory. This is probably not what you want. It's preferable to output to a subdirectory. To specify a different target directory, use the `-d` command-line option: $ scaladoc -d build/ src/main/scala/App.scala @@ -50,6 +50,6 @@ For more information on the `scaladoc` command and what other command-line optio This command is harder to operate with more complex projects containing both multiple Scala source files and library dependencies. This is why using sbt (see above) is easier and better suited for generating Scaladoc. -The Scaladoc command exists because it precedied the development of sbt, but also because it is useful to the Scala development team with studying bug reports for Scaladoc. +The Scaladoc command exists because it preceded the development of sbt, but also because it is useful to the Scala development team with studying bug reports for Scaladoc. More information on directly using the Scala commands, like `scaladoc`, is discussed at [your first lines of Scala](https://www.scala-lang.org/documentation/your-first-lines-of-scala.html). From af88f6563bbe4db334c8c7077bfca0146a8c5b14 Mon Sep 17 00:00:00 2001 From: Dale Wijnand Date: Sun, 9 Jun 2019 08:59:36 -0400 Subject: [PATCH 0503/3075] Avoid confusion about sbt on Scaladoc page --- _overviews/scaladoc/generate.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scaladoc/generate.md b/_overviews/scaladoc/generate.md index d50b19c5b7..4c26f39a08 100644 --- a/_overviews/scaladoc/generate.md +++ b/_overviews/scaladoc/generate.md @@ -21,7 +21,7 @@ There are two ways to generate API documentation in HTML from your Scala code. The easiest and most commonly used way to generate API documentation from your Scala code is with the build tool [sbt](https://www.scala-sbt.org). -From the sbt console, run Scaladoc by simply running the `doc` task: +In the sbt shell, generate Scaladoc by running `doc`: > doc [info] Main Scala API documentation to target/scala-2.12/api... From dbbd5f0db67db746d0356b3d8caec835d7cc6fe7 Mon Sep 17 00:00:00 2001 From: Akhtyam Sakaev Date: Mon, 10 Jun 2019 03:36:03 +0300 Subject: [PATCH 0504/3075] Fix typo --- _includes/footer.html | 2 +- _overviews/FAQ/collections.md | 6 +++--- _overviews/FAQ/context-bounds.md | 2 +- _overviews/FAQ/finding-implicits.md | 2 +- _overviews/FAQ/finding-symbols.md | 2 +- .../collections/migrating-from-scala-27.md | 2 +- .../core/architecture-of-scala-collections.md | 4 ++-- .../binary-compatibility-of-scala-releases.md | 4 ++-- _overviews/core/collections-migration-213.md | 2 +- _overviews/core/futures.md | 6 +++--- _overviews/core/implicit-classes.md | 4 ++-- _overviews/macros/blackbox-whitebox.md | 2 +- _overviews/macros/changelog211.md | 4 ++-- .../parallel-collections/architecture.md | 6 +++--- _overviews/quasiquotes/definition-details.md | 8 +++---- _overviews/quasiquotes/expression-details.md | 2 +- _overviews/quasiquotes/intro.md | 4 ++-- _overviews/quasiquotes/terminology.md | 2 +- _overviews/quasiquotes/type-details.md | 4 ++-- ...inary-compatibility-for-library-authors.md | 10 ++++----- .../2016-09-20-sip-20th-september-minutes.md | 4 ++-- _sips/minutes/2016-11-29-sip-minutes.md | 2 +- _sips/minutes/2017-02-14-sip-minutes.md | 4 ++-- _sips/minutes/2017-05-08-sip-minutes.md | 4 ++-- _sips/minutes/2018-05-18-sip-minutes.md | 6 +++--- _sips/minutes/2018-08-30-sip-minutes.md | 6 +++--- _sips/sip-tutorial.md | 4 ++-- .../2010-01-22-named-and-default-arguments.md | 20 +++++++++--------- _sips/sips/2010-01-22-scala-2-8-arrays.md | 10 ++++----- _sips/sips/2011-10-13-uncluttering-control.md | 2 +- _sips/sips/2012-01-21-futures-promises.md | 8 +++---- ...-05-31-improved-lazy-val-initialization.md | 6 +++--- _sips/sips/2014-06-27-42.type.md | 4 ++-- _sips/sips/2016-01-11-static-members.md | 6 +++--- ...07-priority-based-infix-type-precedence.md | 2 +- _sips/sips/2017-09-20-opaque-types.md | 4 ++-- .../2018-07-31-interpolation-quote-escape.md | 8 +++---- _tour/automatic-closures.md | 2 +- _tour/traits.md | 2 +- contribute.md | 2 +- ...g-a-scala-project-with-intellij-and-sbt.md | 12 +++++------ ...ting-scala-with-sbt-on-the-command-line.md | 6 +++--- ...les-in-scala-impressions-and-statistics.md | 2 +- ...png => forward_backward_compatibility.png} | Bin 44 files changed, 102 insertions(+), 102 deletions(-) rename resources/images/library-author-guide/{fowards_backwards_compatibility.png => forward_backward_compatibility.png} (100%) diff --git a/_includes/footer.html b/_includes/footer.html index 6d233e5c8e..eb43f821b8 100644 --- a/_includes/footer.html +++ b/_includes/footer.html @@ -53,7 +53,7 @@ - + {% if page.layout == "sips"%} diff --git a/_overviews/FAQ/collections.md b/_overviews/FAQ/collections.md index b044191727..d78a2340a9 100644 --- a/_overviews/FAQ/collections.md +++ b/_overviews/FAQ/collections.md @@ -167,7 +167,7 @@ The operation is meant to traverse all elements of the collection, and apply the given operation f to each element. The application is done for its side effect only; in fact any function result of f is discarded by foreach. -Traversible objects can be finite or infinite. An example of an infinite +Traversable objects can be finite or infinite. An example of an infinite traversable object is the stream of natural numbers `Stream.from(0)`. The method `hasDefiniteSize` indicates whether a collection is possibly infinite. If `hasDefiniteSize` returns true, the collection is certainly finite. If it @@ -250,7 +250,7 @@ it. Also available are some traits with further refinements, such as * `LinearSeq` -- A trait for linear sequences, with efficient time for `isEmpty`, `head` and `tail`. * `immutable.LinearSeq` - * `immutable.List` -- An immutable, singlely-linked, list implementation. + * `immutable.List` -- An immutable, singly-linked, list implementation. * `immutable.Stream` -- A lazy-list. Its elements are only computed on-demand, but memoized (kept in memory) afterwards. It can be theoretically infinite. * `mutable.LinearSeq` * `mutable.DoublyLinkedList` -- A list with mutable `prev`, `head` (`elem`) and `tail` (`next`). @@ -343,7 +343,7 @@ it. Also available are some traits with further refinements, such as This was done to achieve maximum code reuse. The concrete *generic* implementation for classes with a certain structure (a traversable, a map, etc) is done in the Like classes. The classes intended for general consumption, -then, override selected methods that can be optmized. +then, override selected methods that can be optimized. * What the companion methods are for (e.g. List.companion)? diff --git a/_overviews/FAQ/context-bounds.md b/_overviews/FAQ/context-bounds.md index fa0beaaaa6..ad79c2990d 100644 --- a/_overviews/FAQ/context-bounds.md +++ b/_overviews/FAQ/context-bounds.md @@ -40,7 +40,7 @@ Another very common example in the library is a bit more complex: def f[A : Ordering](a: A, b: A) = implicitly[Ordering[A]].compare(a, b) -Here, `implicitly` is used to retrive the implicit value we want, one of type +Here, `implicitly` is used to retrieve the implicit value we want, one of type `Ordering[A]`, which class defines the method `compare(a: A, b: A): Int`. We'll see another way of doing this below. diff --git a/_overviews/FAQ/finding-implicits.md b/_overviews/FAQ/finding-implicits.md index 015216f28c..69a1c4a49e 100644 --- a/_overviews/FAQ/finding-implicits.md +++ b/_overviews/FAQ/finding-implicits.md @@ -219,7 +219,7 @@ by a `t` that is not implicit, so no implicit `T` is in scope. The invocation of `f` was enabled by importing from `Y.X.`. But it is not convenient to require an import to access implicit values -providied by a package. +provided by a package. If an implicit value is not found in lexical scope, implicit search continues in implicit scope. diff --git a/_overviews/FAQ/finding-symbols.md b/_overviews/FAQ/finding-symbols.md index 0512856737..aca08ae12f 100644 --- a/_overviews/FAQ/finding-symbols.md +++ b/_overviews/FAQ/finding-symbols.md @@ -160,7 +160,7 @@ object of type that is receiving the method. For example, consider `"a" -> 1`. W to look for an implicit which works on `"a"`, and so it can take `String`, one of its supertypes (`AnyRef` or `Any`) or a type parameter. In this case, we find `implicit final class ArrowAssoc[A](private val self: A)` which makes this implicit -avaialable on all types. +available on all types. Other implicit conversions may be visible in your scope depending on imports, extended types or self-type annotations. See [Finding implicits](finding-implicits.html) for details. diff --git a/_overviews/collections/migrating-from-scala-27.md b/_overviews/collections/migrating-from-scala-27.md index c2c2bd9935..87f557ca4f 100644 --- a/_overviews/collections/migrating-from-scala-27.md +++ b/_overviews/collections/migrating-from-scala-27.md @@ -41,7 +41,7 @@ Generally, the old functionality of Scala 2.7 collections has been left in place There are two parts of the old libraries which have been replaced wholesale, and for which deprecation warnings were not feasible. -1. The previous `scala.collection.jcl` package is gone. This package tried to mimick some of the Java collection library design in Scala, but in doing so broke many symmetries. Most people who wanted Java collections bypassed `jcl` and used `java.util` directly. Scala 2.8 offers automatic conversion mechanisms between both collection libraries in the [JavaConversions]({{ site.baseurl }}/overviews/collections/conversions-between-java-and-scala-collections.html) object which replaces the `jcl` package. +1. The previous `scala.collection.jcl` package is gone. This package tried to mimic some of the Java collection library design in Scala, but in doing so broke many symmetries. Most people who wanted Java collections bypassed `jcl` and used `java.util` directly. Scala 2.8 offers automatic conversion mechanisms between both collection libraries in the [JavaConversions]({{ site.baseurl }}/overviews/collections/conversions-between-java-and-scala-collections.html) object which replaces the `jcl` package. 2. Projections have been generalized and cleaned up and are now available as views. It seems that projections were used rarely, so not much code should be affected by this change. So, if your code uses either `jcl` or projections there might be some minor rewriting to do. diff --git a/_overviews/core/architecture-of-scala-collections.md b/_overviews/core/architecture-of-scala-collections.md index 5cb894f1e9..3a2dcf6fb4 100644 --- a/_overviews/core/architecture-of-scala-collections.md +++ b/_overviews/core/architecture-of-scala-collections.md @@ -907,7 +907,7 @@ return with `None`. The combined selection over an option value `opt` is elegantly expressed using `opt.flatMap(x => f(x))`. When applied to an optional value that is `None`, it returns `None`. Otherwise `opt` is `Some(x)` and the function `f` is applied to the encapsulated value `x`, -yielding a new option, which is returned by the flatmap. +yielding a new option, which is returned by the flatMap. The next two methods to implement for a mutable map are `+=` and `-=`. In the implementation of `PrefixMap`, these are defined in terms of two @@ -948,7 +948,7 @@ using the map's `+=` method. For immutable maps, the non-destructive element addition method `+` is used instead of method `+=`. Sets work in the same way. -However, in all these cases, to build the right kind of colletion +However, in all these cases, to build the right kind of collection you need to start with an empty collection of that kind. This is provided by the `empty` method, which is the last method defined in `PrefixMap`. This method simply returns a fresh `PrefixMap`. diff --git a/_overviews/core/binary-compatibility-of-scala-releases.md b/_overviews/core/binary-compatibility-of-scala-releases.md index c12db85230..749a31f6cc 100644 --- a/_overviews/core/binary-compatibility-of-scala-releases.md +++ b/_overviews/core/binary-compatibility-of-scala-releases.md @@ -11,8 +11,8 @@ When two versions of Scala are binary compatible, it is safe to compile your pro We check binary compatibility automatically with [MiMa](https://github.com/lightbend/migration-manager). We strive to maintain a similar invariant for the `behavior` (as opposed to just linkage) of the standard library, but this is not checked mechanically (Scala is not a proof assistant so this is out of reach for its type system). -#### Forwards and Back -We distinguish forwards and backwards compatibility (think of these as properties of a sequence of versions, not of an individual version). Maintaining backwards compatibility means code compiled on an older version will link with code compiled with newer ones. Forwards compatibility allows you to compile on new versions and run on older ones. +#### Forward and Back +We distinguish forward and backward compatibility (think of these as properties of a sequence of versions, not of an individual version). Maintaining backwards compatibility means code compiled on an older version will link with code compiled with newer ones. Forward compatibility allows you to compile on new versions and run on older ones. Thus, backwards compatibility precludes the removal of (non-private) methods, as older versions could call them, not knowing they would be removed, whereas forwards compatibility disallows adding new (non-private) methods, because newer programs may come to depend on them, which would prevent them from running on older versions (private methods are exempted here as well, as their definition and call sites must be in the same compilation unit). diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 71b9cbf815..f2b33ae434 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -29,7 +29,7 @@ The most important changes in the Scala 2.13 collections library are: The [scala-collection-compat](https://github.com/scala/scala-collection-compat) is a library released for 2.11, 2.12 and 2.13 that provides some of the new APIs from Scala 2.13 for the older versions. This simplifies cross-building projects. -The module also provides [migratrion rules](https://github.com/scala/scala-collection-compat#migration-tool) for [scalafix](https://scalacenter.github.io/scalafix/docs/users/installation.html) that can update a project's source code to work with the 2.13 collections library. +The module also provides [migration rules](https://github.com/scala/scala-collection-compat#migration-tool) for [scalafix](https://scalacenter.github.io/scalafix/docs/users/installation.html) that can update a project's source code to work with the 2.13 collections library. ## scala.Seq, varargs and scala.IndexedSeq migration diff --git a/_overviews/core/futures.md b/_overviews/core/futures.md index c753fca53d..a0eea92daf 100644 --- a/_overviews/core/futures.md +++ b/_overviews/core/futures.md @@ -665,16 +665,16 @@ multiple `andThen` calls are ordered, as in the following example which stores the recent posts from a social network to a mutable set and then renders all the posts to the screen: - val allposts = mutable.Set[String]() + val allPosts = mutable.Set[String]() Future { session.getRecentPosts } andThen { - case Success(posts) => allposts ++= posts + case Success(posts) => allPosts ++= posts } andThen { case _ => clearAll() - for (post <- allposts) render(post) + for (post <- allPosts) render(post) } In summary, the combinators on futures are purely functional. diff --git a/_overviews/core/implicit-classes.md b/_overviews/core/implicit-classes.md index 9b3d819d87..501724cdb4 100644 --- a/_overviews/core/implicit-classes.md +++ b/_overviews/core/implicit-classes.md @@ -72,8 +72,8 @@ Implicit classes have the following restrictions: implicit class RichDate(date: java.util.Date) // OK! - implicit class Indexer[T](collecton: Seq[T], index: Int) // BAD! - implicit class Indexer[T](collecton: Seq[T])(implicit index: Index) // OK! + implicit class Indexer[T](collection: Seq[T], index: Int) // BAD! + implicit class Indexer[T](collection: Seq[T])(implicit index: Index) // OK! While it's possible to create an implicit class with more than one non-implicit argument, such classes diff --git a/_overviews/macros/blackbox-whitebox.md b/_overviews/macros/blackbox-whitebox.md index aade9367f2..f243e4ac74 100644 --- a/_overviews/macros/blackbox-whitebox.md +++ b/_overviews/macros/blackbox-whitebox.md @@ -29,7 +29,7 @@ In fact, macros became an important part of our ecosystem so quickly that just a Macro flavors are plentiful, so we decided to carefully examine them to figure out which ones should be put in the standard. This entails answering a few important questions. Why are macros working so well? Why do people use them? Our hypothesis is that this happens because the hard to comprehend notion of metaprogramming expressed in def macros piggybacks on the familiar concept of a typed method call. Thanks to that, the code that users write can absorb more meaning without becoming bloated or losing -compehensibility. +comprehensibility. ## Blackbox and whitebox macros diff --git a/_overviews/macros/changelog211.md b/_overviews/macros/changelog211.md index 0b91acfb4c..c4753e56ea 100644 --- a/_overviews/macros/changelog211.md +++ b/_overviews/macros/changelog211.md @@ -60,7 +60,7 @@ Quasiquotes is the single most impressive upgrade for reflection and macros in S 16) **[knownDirectSubclasses is deemed to be officially broken](https://issues.scala-lang.org/browse/SI-7046)**. A lot of users who tried to traverse sealed hierarchies of classes have noticed that `ClassSymbol.knownDirectSubclasses` only works if invocations of their macros come after the definitions of those hierarchies in Scala's compilation order. For instance, if a sealed hierarchy is defined in the bottom of a source file, and a macro application is written in the top of the file, then knownDirectSubclasses will return an empty list. This is an issue that is deeply rooted in Scala's internal architecture, and we can't provide a fix for it in the near future. -17) **showCode**. Along with `Tree.toString` that prints Scala-ish source code and `showRaw(tree)` that prints internal structures of trees, we now have `showCode` that prints compileable Scala source code corresponding to the provided tree, courtesy of Vladimir Nikolaev, who's done an amazing work of bringing this to life. We plan to eventually replace `Tree.toString` with `showCode`, but in Scala 2.11.0 these are two different methods. +17) **showCode**. Along with `Tree.toString` that prints Scala-ish source code and `showRaw(tree)` that prints internal structures of trees, we now have `showCode` that prints compilable Scala source code corresponding to the provided tree, courtesy of Vladimir Nikolaev, who's done an amazing work of bringing this to life. We plan to eventually replace `Tree.toString` with `showCode`, but in Scala 2.11.0 these are two different methods. 18) **[It is now possible to typecheck in type and pattern modes](https://issues.scala-lang.org/browse/SI-6814)**. A very convenient `Context.typeCheck` and `ToolBox.typeCheck` functionality of Scala 2.10.x had a significant inconvenience - it only worked for expressions, and typechecking something as a type or as a pattern required building dummy expressions. Now `typeCheck` has the mode parameter that take case of that difficulty. @@ -170,7 +170,7 @@ Quasiquotes is the single most impressive upgrade for reflection and macros in S // provides a source compatibility stub // in Scala 2.10.x, it will make `import compat._` compile just fine, // even though `c.universe` doesn't have `compat` - // in Scala 2.11.0, it will be ignored, becase `import c.universe._` + // in Scala 2.11.0, it will be ignored, because `import c.universe._` // brings its own `compat` in scope and that one takes precedence private object HasCompat { val compat = ??? }; import HasCompat._ diff --git a/_overviews/parallel-collections/architecture.md b/_overviews/parallel-collections/architecture.md index d5173e915f..487c6deac9 100644 --- a/_overviews/parallel-collections/architecture.md +++ b/_overviews/parallel-collections/architecture.md @@ -37,7 +37,7 @@ terms of two core abstractions-- `Splitter`s and `Combiner`s. ### Splitters The job of a `Splitter`, as its name suggests, is to split a parallel -collection into a non-trival partition of its elements. The basic idea is to +collection into a non-trivial partition of its elements. The basic idea is to split the collection into smaller parts until they are small enough to be operated on sequentially. @@ -55,7 +55,7 @@ subsets of elements of the whole parallel collection. And similar to normal `Iterator`s, a `Splitter` is invalidated after its `split` method is invoked. In general, collections are partitioned using `Splitter`s into subsets of -roughly the same size. In cases where more arbitrarily-sized partions are +roughly the same size. In cases where more arbitrarily-sized partitions are required, in particular on parallel sequences, a `PreciseSplitter` is used, which inherits `Splitter` and additionally implements a precise split method, `psplit`. @@ -82,7 +82,7 @@ and the type of the resulting collection, respectively. _Note:_ Given two `Combiner`s, `c1` and `c2` where `c1 eq c2` is `true` (meaning they're the same `Combiner`), invoking `c1.combine(c2)` always does -nothing and simpy returns the receiving `Combiner`, `c1`. +nothing and simply returns the receiving `Combiner`, `c1`. ## Hierarchy diff --git a/_overviews/quasiquotes/definition-details.md b/_overviews/quasiquotes/definition-details.md index d859b6d136..7d3c38e3cc 100644 --- a/_overviews/quasiquotes/definition-details.md +++ b/_overviews/quasiquotes/definition-details.md @@ -216,7 +216,7 @@ Abstract type definitions have the following shape: low: universe.Tree = high: universe.Tree = List[T] -Whenever one of the bounds isn\'t available, it gets represented as an [empty tree](expression-details.html#empty). Here each of the type arguments is a type definition itself. +Whenever one of the bounds isn't available, it gets represented as an [empty tree](expression-details.html#empty). Here each of the type arguments is a type definition itself. Another form of type definition is a type alias: @@ -259,7 +259,7 @@ Alternatively you can also deconstruct arguments, separating implicit and non-im implparams: List[universe.ValDef] = List(implicit val y: Int = _) body: universe.Tree = x.$plus(y) -This way of handling parameters will still work if the method doesn\'t have any implicit parameters and `implparams` will get extracted as an empty list: +This way of handling parameters will still work if the method doesn't have any implicit parameters and `implparams` will get extracted as an empty list: scala> val q"def g(...$paramss)(implicit ..$implparams) = $rhs" = q"def g(x: Int)(y: Int) = x + y" @@ -344,7 +344,7 @@ Packages are a fundamental primitive to organize source code. You can express th } }) -Quasiquotes don\'t support the inline package definition syntax that is usually used in the header of the source file (but it's equivalent to the supported one in terms of ASTs). +Quasiquotes don't support the inline package definition syntax that is usually used in the header of the source file (but it's equivalent to the supported one in terms of ASTs). ## Package Object Definition @@ -352,7 +352,7 @@ Package objects are a cross between packages and object: q"package object $tname extends { ..$earlydefns } with ..$parents { $self => ..$stats }" -All of the handling properties are equivalent to those of objects apart from the fact that they don\'t have [modifiers](#modifiers). +All of the handling properties are equivalent to those of objects apart from the fact that they don't have [modifiers](#modifiers). Even though package and regular objects seem to be quite similar syntactically, they don't match one another: diff --git a/_overviews/quasiquotes/expression-details.md b/_overviews/quasiquotes/expression-details.md index 371b7508dc..19cbc5ee67 100644 --- a/_overviews/quasiquotes/expression-details.md +++ b/_overviews/quasiquotes/expression-details.md @@ -290,7 +290,7 @@ At the moment, tuples are only supported up to an arity of 22, but this is just scala> val `tuple 23 supported?` = definitions.TupleClass(23) != NoSymbol tuple 23 supported?: Boolean = false -Despited the fact that `Tuple1` class exists there is no built-in syntax for it. Single parens around expression do not change its meaning: +Despite the fact that `Tuple1` class exists there is no built-in syntax for it. Single parens around expression do not change its meaning: scala> val inparens = q"(a)" inparens: universe.Ident = a diff --git a/_overviews/quasiquotes/intro.md b/_overviews/quasiquotes/intro.md index fbebb00f77..274a0d936f 100644 --- a/_overviews/quasiquotes/intro.md +++ b/_overviews/quasiquotes/intro.md @@ -73,7 +73,7 @@ Each of these contexts is covered by a separate interpolator: tq | [types]({{ site.baseurl }}/overviews/quasiquotes/syntax-summary.html#types) pq | [patterns]({{ site.baseurl }}/overviews/quasiquotes/syntax-summary.html#patterns) -Syntactical similarity between different contexts doesn\'t imply similarity between underlying trees: +Syntactical similarity between different contexts doesn't imply similarity between underlying trees: scala> println(q"List[Int]" equalsStructure tq"List[Int]") false @@ -110,7 +110,7 @@ Unquote splicing is a way to unquote a variable number of elements: scala> val fab = q"f(..$ab)" fab: universe.Tree = f(a, b) -Dots before the unquotee annotate indicate a degree of flattenning and are called a *splicing rank*. `..$` expects the argument to be an `Iterable[Tree]` and `...$` expects an `Iterable[Iterable[Tree]]`. +Dots before the unquotee annotate indicate a degree of flattening and are called a *splicing rank*. `..$` expects the argument to be an `Iterable[Tree]` and `...$` expects an `Iterable[Iterable[Tree]]`. Splicing can easily be combined with regular unquotation: diff --git a/_overviews/quasiquotes/terminology.md b/_overviews/quasiquotes/terminology.md index d528551c4c..3b153a2274 100644 --- a/_overviews/quasiquotes/terminology.md +++ b/_overviews/quasiquotes/terminology.md @@ -19,6 +19,6 @@ permalink: /overviews/quasiquotes/:title.html * **Tree deconstruction** refers to usages of quasiquotes as patterns to structurally tear apart trees. * **Unquoting** is a way of either putting things in or extracting things out of quasiquotes. Can be performed with `$` syntax within a quasiquote. * **Unquote splicing** (or just splicing) is another form of unquoting that flattens contents of the unquotee into a tree. Can be performed with either `..$` or `...$` syntax. -* **Rank** is a degree of flattenning of unquotee: `rank($) == 0`, `rank(..$) == 1`, `rank(...$) == 2`. +* **Rank** is a degree of flattening of unquotee: `rank($) == 0`, `rank(..$) == 1`, `rank(...$) == 2`. * [**Lifting**](lifting.html) is a way to unquote non-tree values and transform them into trees with the help of the `Liftable` typeclass. * [**Unlifting**](unlifting.html) is a way to unquote non-tree values out of quasiquote patterns with the help of the `Unliftable` typeclass. diff --git a/_overviews/quasiquotes/type-details.md b/_overviews/quasiquotes/type-details.md index b9d6929f22..9258d5928e 100644 --- a/_overviews/quasiquotes/type-details.md +++ b/_overviews/quasiquotes/type-details.md @@ -92,7 +92,7 @@ Lastly and [similarly to expressions](expression-details.html#super-and-this) on ## Applied Type -Instantiations of parametized types can be expressed with the help of applied types (type-level equivalent of type application): +Instantiations of parameterized types can be expressed with the help of applied types (type-level equivalent of type application): scala> val applied = tq"Foo[A, B]" applied: universe.Tree = Foo[A, B] @@ -151,7 +151,7 @@ Existential types consist of a type tree and a list of definitions: tpt: universe.Tree = List[T] defns: List[universe.MemberDef] = List(type T) -Alternatively there is also an underscrore notation: +Alternatively there is also an underscore notation: scala> val tq"$tpt forSome { ..$defns }" = tq"List[_]" tpt: universe.Tree = List[_$1] diff --git a/_overviews/tutorials/binary-compatibility-for-library-authors.md b/_overviews/tutorials/binary-compatibility-for-library-authors.md index d8cf3002da..655317c95d 100644 --- a/_overviews/tutorials/binary-compatibility-for-library-authors.md +++ b/_overviews/tutorials/binary-compatibility-for-library-authors.md @@ -79,23 +79,23 @@ Two library versions are **Binary Compatible** with each other if the compiled b ### Relationship between source and binary compatibility While breaking source compatibility often results in binary incompatibilities as well, they are actually orthogonal -- breaking one does not imply breaking the other. -#### Forwards and Backwards Compatibility +#### Forward and Backward Compatibility There are two "directions" when we describe compatibility of a library release: -**Backwards Compatible** means that a newer library version can be used in an environment where an older version is expected. When talking about binary and source compatibility, +**Backward Compatible** means that a newer library version can be used in an environment where an older version is expected. When talking about binary and source compatibility, this is the common and implied direction. -**Forwards Compatible** means that an older library can be used in an environment where a newer version is expected. +**Forward Compatible** means that an older library can be used in an environment where a newer version is expected. Forward compatibility is generally not upheld for libraries. Let's look at an example where library `A v1.0.0` is compiled with library `C v1.1.0`. -![Forwards and Backwards Compatibility]({{ site.baseurl }}/resources/images/library-author-guide/fowards_backwards_compatibility.png){: style="width: 65%; margin: auto; display: block"} +![Forward and Backward Compatibility]({{ site.baseurl }}/resources/images/library-author-guide/forward_backward_compatibility.png){: style="width: 65%; margin: auto; display: block"} `C v1.1.0 ` is **Forwards Binary Compatible** with `v1.0.0` if we can use `v1.0.0`'s JAR at runtime instead of `v1.1.0`'s JAR without any linkage errors. -`C v1.2.0 ` is **Backwards Binary Compatible** with `v1.1.0` if we can use `v1.2.0`'s JAR at runtime instead of `v1.1.0`'s JAR without any linkage errors. +`C v1.2.0 ` is **Backward Binary Compatible** with `v1.1.0` if we can use `v1.2.0`'s JAR at runtime instead of `v1.1.0`'s JAR without any linkage errors. ## Why binary compatibility matters diff --git a/_sips/minutes/2016-09-20-sip-20th-september-minutes.md b/_sips/minutes/2016-09-20-sip-20th-september-minutes.md index fe5bd46fe5..584975a64d 100644 --- a/_sips/minutes/2016-09-20-sip-20th-september-minutes.md +++ b/_sips/minutes/2016-09-20-sip-20th-september-minutes.md @@ -154,12 +154,12 @@ issue, two things are required: The second option is not feasible because unsigned numbers are AnyVals, and they can only extend `Object`. Working around this in the backend is, in Sébastien's opinion, not an exciting adventure to embark on: a lot of patches and quirky -fixes are required in the compiler. Sébastien, recognizing his unability to fix +fixes are required in the compiler. Sébastien, recognizing his inability to fix the issue, recommends to reject the proposal. Josh needs to leave. Eugene wonders if these problems are only JVM-specific. Sébastien replies that both yes and no, and he confirms that unsigned integers -will be implemented in Scalajs alone, so the implementation won't be +will be implemented in Scala.js alone, so the implementation won't be platform-independent. Eugene is interested in knowing if there will be any code duplication in the implementation, and Sébastien doesn't think so, since Scala Native implements unsigned integer in a different way. diff --git a/_sips/minutes/2016-11-29-sip-minutes.md b/_sips/minutes/2016-11-29-sip-minutes.md index a3736d79a0..c970ddb730 100644 --- a/_sips/minutes/2016-11-29-sip-minutes.md +++ b/_sips/minutes/2016-11-29-sip-minutes.md @@ -66,7 +66,7 @@ The main motivation is to prepare for inline. Inline won't work very well withou ### [SIP-NN:Static](https://github.com/scala/docs.scala-lang/pull/491/files) -Iulian says too much code is generated by annotations. We could solve name clashes the way ScalaJS does by specifying the exported name. How can we wake code generation predictable without looking at annotations? How do we emit public static field without accessors? Having everything emitted as static and object where possible is going to simplify reasoning about how things are initialized. +Iulian says too much code is generated by annotations. We could solve name clashes the way Scala.js does by specifying the exported name. How can we wake code generation predictable without looking at annotations? How do we emit public static field without accessors? Having everything emitted as static and object where possible is going to simplify reasoning about how things are initialized. How should a user decide when to use static? It is platform-dependent. diff --git a/_sips/minutes/2017-02-14-sip-minutes.md b/_sips/minutes/2017-02-14-sip-minutes.md index a1d8785ba0..ac54f216d3 100644 --- a/_sips/minutes/2017-02-14-sip-minutes.md +++ b/_sips/minutes/2017-02-14-sip-minutes.md @@ -147,7 +147,7 @@ The current SIP tries to make it behave as expected by the users in common cases **Jorge** We have to pass here both on this proposal as is right now but I think this could be dangerous in the case where we don't have an implementation for Scalac because maybe the details change and assume something in Scalac that the SIP is not able to predict or guard against it. Let's wait until next month and I will double check whether this is possible or not. Then I will get in touch with the Lightbend team to see whether this can be implemented or not. We'll decide in a month whether it should be accepted. -**Sébastien** ScalaJS already implemented it under another name but it's supposed to be conservative with respect to the aesthetic SIP in the sense that things that are allowed now with @jsstatic will also be allowed with @static. @static might open up a little bit more. +**Sébastien** Scala.js already implemented it under another name but it's supposed to be conservative with respect to the aesthetic SIP in the sense that things that are allowed now with @jsstatic will also be allowed with @static. @static might open up a little bit more. **Conclusion** The static SIP proposal has to be implemented in Scala, as it's already present in Dotty. Triplequote (Iulian Dragos and Mirco Dotta) has offered to provide an implementation targeting 2.12.3. @@ -221,7 +221,7 @@ There are multiple use cases covered by this SIP. I think the two most important **Martin** If you don't emit a Scala signature then you can't have a co- or contravariant type parameter because they are only expressed in Scala signatures, in Java it's not there. I don't see how that follows from the current proposal. Also, isn't it platform dependent? -**Sébastien** We do have a Java signature. Scala-JS doesn't disable classfile emission. When you say quickly compile, it uses the classfiles to quickly compile. when you use macros, it will extend from those classfiles. When you use an IDE it reduces the classfiles to identify things. When you use sbt, it uses classfiles to detect the changes. However, they aren't used by the ScalaJS linker. +**Sébastien** We do have a Java signature. Scala.js doesn't disable classfile emission. When you say quickly compile, it uses the classfiles to quickly compile. when you use macros, it will extend from those classfiles. When you use an IDE it reduces the classfiles to identify things. When you use sbt, it uses classfiles to detect the changes. However, they aren't used by the Scala.js linker. **Seth** Does this need to be part of the compiler or can it move forward as a plugin or just as a check performed in MiMa? MiMa just compares two different APIs. Can it have this other job as well: seeing if it does anything outside of the boundaries. diff --git a/_sips/minutes/2017-05-08-sip-minutes.md b/_sips/minutes/2017-05-08-sip-minutes.md index e5d2e52ccf..752873ef1b 100644 --- a/_sips/minutes/2017-05-08-sip-minutes.md +++ b/_sips/minutes/2017-05-08-sip-minutes.md @@ -47,12 +47,12 @@ Minutes were taken by Darja Jovanovic. Proposal aims to introduce new syntax from comprehension for monads to comonads. Martin is the reviewer. He asks others attendees for their opinion on this. Everyone had read the SIP. -**Eugene** referred to original proposal and wishes to see a better motivation for this language feature encouraging use of “plain English” to simplify the use of Scala as practice oriented language. He believes that it could be critical how this SIP can be improved. During the recent conference, organized by Facebook, he spoke with typescript guys that are developing idiomic solutions that would benefit typescript and javascript and allow community users to give their inputs. +**Eugene** referred to original proposal and wishes to see a better motivation for this language feature encouraging use of “plain English” to simplify the use of Scala as practice oriented language. He believes that it could be critical how this SIP can be improved. During the recent conference, organized by Facebook, he spoke with TypeScript guys that are developing idiomatic solutions that would benefit TypeScript and JavaScript and allow community users to give their inputs. Refers to the paper “Denotation” he linked in a proposal, that is not enough for Scala, but a good start. **Jorge** is getting back discussion on voting on this proposal and he mentioned that Josh insisted on more examples and suggestions on motivation of this SIP. -**Eugene** wanted to add more syntax (map and flatmap), but **Martin** opposed to that saying that Scala is quite serious program and needs more reason to add any additional syntax to it. **Martin** would like to see more widespread use of comonadic constructs and Libraries, and before doing that, he wouldn’t consider any further change. **Sebastian** agrees with Martin and says that he doesn’t really understand Josh’s and Eugene’s proposal. **Iulian** agrees that the proposal is quite complicated and he wonders how it can be useful. He believes that it is an interesting research direction, but that it needs more users feedbacks in aim to be included in the Scala, therefore questioning if the proposal should be numbered in the current form. Seth and Adriaan agree with Martin and Iulian. +**Eugene** wanted to add more syntax (map and flatMap), but **Martin** opposed to that saying that Scala is quite serious program and needs more reason to add any additional syntax to it. **Martin** would like to see more widespread use of comonadic constructs and Libraries, and before doing that, he wouldn’t consider any further change. **Sebastian** agrees with Martin and says that he doesn’t really understand Josh’s and Eugene’s proposal. **Iulian** agrees that the proposal is quite complicated and he wonders how it can be useful. He believes that it is an interesting research direction, but that it needs more users feedback in aim to be included in the Scala, therefore questioning if the proposal should be numbered in the current form. Seth and Adriaan agree with Martin and Iulian. **Conclusion** Proposal discarded unanimously. They will send the feedback to the author. diff --git a/_sips/minutes/2018-05-18-sip-minutes.md b/_sips/minutes/2018-05-18-sip-minutes.md index 3f4c390f78..b707f52f73 100644 --- a/_sips/minutes/2018-05-18-sip-minutes.md +++ b/_sips/minutes/2018-05-18-sip-minutes.md @@ -62,7 +62,7 @@ Given the short time and amount of decisions that need to be made, the Committee *Structure* a) Have a **list of changes**, grouped in batches that would be decided within the next year, meeting once a month -b) **Plan** - full and strucutured list of changes that need to be implemented consolidated between the Committee members using a shared a Google doc +b) **Plan** - full and structured list of changes that need to be implemented consolidated between the Committee members using a shared a Google doc c) **Public comments** - each batch should be published on the Contributors thread, for a month at a time in order to have community involved, share their opinion and contribute. Advise was proposed - each thread should clearly point out start and end date of collecting the comments/suggestions. *Organisation* @@ -80,10 +80,10 @@ The above mentioned structure and organisation was gathered throughout the meeti 4. Other: spec, quorum -**Heather** bings up an important question "What about Scala spec" ([YouTube time: 4'49''](https://youtu.be/q2LVmTe9qmU?t=289)) to which **Martin** responds within the next year we should know which features are included as a first priority but that spec should not be left for the last minute. +**Heather** brings up an important question "What about Scala spec" ([YouTube time: 4'49''](https://youtu.be/q2LVmTe9qmU?t=289)) to which **Martin** responds within the next year we should know which features are included as a first priority but that spec should not be left for the last minute. **Miles** ([YouTube time: 8'45](https://youtu.be/q2LVmTe9qmU?t=525))suggested that SIP proposals should include draft specification changes to save time and effort pulling the eventual spec update together. **Martin** ([YouTube time: 37'59''](https://youtu.be/q2LVmTe9qmU?t=2279)) also raised a question about the decision making process, asking if it would be better to change to simple majority when it comes to voting. This was rejected by most of the Members and agreed it should be discussed in a different meeting or time. -**Conclusion** The first batch should be agreed upon, posted on the Contributors thread for public comments. Such discussion should be summaraized and included in the next meeting (22nd June 2018, after ScalaDays NewYork). +**Conclusion** The first batch should be agreed upon, posted on the Contributors thread for public comments. Such discussion should be summarized and included in the next meeting (22nd June 2018, after ScalaDays NewYork). diff --git a/_sips/minutes/2018-08-30-sip-minutes.md b/_sips/minutes/2018-08-30-sip-minutes.md index 30fbc4bc49..48bc21c12f 100644 --- a/_sips/minutes/2018-08-30-sip-minutes.md +++ b/_sips/minutes/2018-08-30-sip-minutes.md @@ -141,7 +141,7 @@ Comments + Interaction with nullary constructors. Currently `class Foo` is interpreted as `class Foo()`. Mutatis mutandis for case class `apply` methods. -**Martin** ([Youtube time: 11.37](https://youtu.be/gnlL4PlstFY?t=688)) mentiones that this proposal also came about due to New collection usecases that surfaced in recent work - showing that without a strict rule there is a high amount of "un-disciplined" use of (). But he agrees with Miles about merging the two proposals together. +**Martin** ([Youtube time: 11.37](https://youtu.be/gnlL4PlstFY?t=688)) mentioned that this proposal also came about due to New collection usecases that surfaced in recent work - showing that without a strict rule there is a high amount of "un-disciplined" use of (). But he agrees with Miles about merging the two proposals together. **Conclusion** **Jorge** takes the task to merge the proposals and extend the motivation. @@ -210,7 +210,7 @@ Discussion: **Josh** ([YouTube time: 27’16’’](https://youtu.be/gnlL4PlstFY?t=1636)) clarifies that in order to replace the libraries one would need a proof of concept, and currently there is none. -**Adriaan** ([YouTube time 30’](https://youtu.be/gnlL4PlstFY?t=1796)) summarises the discussion, pointing out that Committee needs to answer a question *will we support XML in some way* and *waht would be the most "Scala-like" way to do so* and *who will be maintaing it*. +**Adriaan** ([YouTube time 30’](https://youtu.be/gnlL4PlstFY?t=1796)) summarises the discussion, pointing out that Committee needs to answer a question *will we support XML in some way* and *what would be the most "Scala-like" way to do so* and *who will be maintaining it*. **Seth** ([YouTube time 35’57’’](https://youtu.be/gnlL4PlstFY?t=2157)) is under the impression that large portion of XML user base are the ones using it to do generation and rarer to be reading in XML using the existing Scala XML support and asks others to share their impressions. **Martin** re-phrases it as “using XML for pattern matching”. @@ -269,7 +269,7 @@ Counter Proposals - Multiple "def" keywords, one which would mean side-effecting function := for side effects -**Josh** concludes: big point to debate would the language consistency be worth the change to more verbose expresion. +**Josh** concludes: big point to debate would the language consistency be worth the change to more verbose expression. **Iulian** ([You/tube time: ]( https://youtu.be/gnlL4PlstFY?t=2928)) adds that 1. last 5 years Syntax procedure was anyway deprecated; 2. going forward we should consider Scala 3 in a light of next 15 years, now is the right moment to clean up the language and 3. this is “the easiest refactoring to automate the code base” that could be a “zero cost migration” diff --git a/_sips/sip-tutorial.md b/_sips/sip-tutorial.md index 680eee2d73..b5ed7e03ae 100644 --- a/_sips/sip-tutorial.md +++ b/_sips/sip-tutorial.md @@ -11,7 +11,7 @@ The process to submit is simple: * Fork the [Scala documentation repository](http://github.com/scala/docs.scala-lang) and clone it. * Create a new SIP file in the `sips/pending/_posts/`. Use the [S(L)IP template](https://github.com/scala/docs.scala-lang/blob/master/_sips/sip-template.md) - * Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Use the proposal date for `YYYY-MM-dd`. + * Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Use the proposal date for `YYYY-MM-dd`. * Use the [Markdown Syntax](http://daringfireball.net/projects/markdown/syntax) to write your SIP. * Follow the instructions in the [README](https://github.com/scala/docs.scala-lang/blob/master/README.md) to build your SIP locally so you can ensure that it looks correct on the website. * Create a link to your SIP in the "pending sips" section of `index.md`. @@ -21,7 +21,7 @@ The process to submit is simple: ## SIP Post Format ## -First, create a new SIP file in the `pending/_posts` directory. Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Where: +First, create a new SIP file in the `pending/_posts` directory. Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Where: * `YYYY` is the current year when the proposal originated. * `MM` is the current month (`01` = January, `12` = December) when the proposal originated. * `dd` is the day of the month when the proposal originated. diff --git a/_sips/sips/2010-01-22-named-and-default-arguments.md b/_sips/sips/2010-01-22-named-and-default-arguments.md index fecaed1b71..a3d5a96165 100644 --- a/_sips/sips/2010-01-22-named-and-default-arguments.md +++ b/_sips/sips/2010-01-22-named-and-default-arguments.md @@ -16,13 +16,13 @@ The second language feature discussed in this document, default arguments, in ge ## Named Arguments -In Scala 2.8, method arguments can be specified in _named style_ using the same syntax as variable assignments: +In Scala 2.8, method arguments can be specified in _named style_ using the same syntax as variable assignments: def f[T](a: Int, b: T) f(b = getT(), a = getInt()) -The argument expressions are evaluated in call-site order, so in the above example `getT()` is executed before `getInt()`f. Mixing named and positional arguments is allowed as long as the positional part forms a prefix of the argument list: +The argument expressions are evaluated in call-site order, so in the above example `getT()` is executed before `getInt()`f. Mixing named and positional arguments is allowed as long as the positional part forms a prefix of the argument list: f(0, b = "1") // valid f(b = "1", a = 0) // valid @@ -51,7 +51,7 @@ The following list shows how named arguments interfere with other language featu **By-Name Parameters** continue to work as expected when using named arguments. The expression is only (and repeatedly) evaluated when the body of the method accesses the parameter. -**Repeated Parameters** When an application uses named arguments, the repeated parameter has to be specified exactly once. Using the same parameter name multiple times is disallowed. +**Repeated Parameters** When an application uses named arguments, the repeated parameter has to be specified exactly once. Using the same parameter name multiple times is disallowed. **Functional values** A functional value in Scala is an instance of a class which implements a method called apply. One can use the parameter names of that apply method for a named application. For functional values whose static type is scala.FunctionN, the parameter names of that apply method can be used. @@ -68,17 +68,17 @@ The following list shows how named arguments interfere with other language featu val a: A = new B a.f(a = 1) // OK -**Overloading Resolution** When a method application refers to an overloaded method, first the set of applicable alternatives is determined and then the most specific alternative is chosen (see [1], Chapter 6.26.3). +**Overloading Resolution** When a method application refers to an overloaded method, first the set of applicable alternatives is determined and then the most specific alternative is chosen (see [1], Chapter 6.26.3). -The presence of named argument influences the set of applicable alternatives, the argument types have to be matched against the corresponding parameter types based on the names. In the following example, the second alternative is applicable: +The presence of named argument influences the set of applicable alternatives, the argument types have to be matched against the corresponding parameter types based on the names. In the following example, the second alternative is applicable: def f() // #1 def f(a: Int, b: String) // #2 f(b = "someString", a = 1) // using #2 -If multiple alternatives are applicable, the most specific one is determined. This process is independent of the argument names used in a specific application and only looks at the method signature (for a detailed description, see [1], Chapter 6.26.3). +If multiple alternatives are applicable, the most specific one is determined. This process is independent of the argument names used in a specific application and only looks at the method signature (for a detailed description, see [1], Chapter 6.26.3). -In the following example, both alternatives are applicable, but none of them is more specific than the other because the argument types are compared based on their position, not on the argument name: +In the following example, both alternatives are applicable, but none of them is more specific than the other because the argument types are compared based on their position, not on the argument name: def f(a: Int, b: String) // #1 def f(b: Object, a: Int) // #2 @@ -113,7 +113,7 @@ A default argument may be an arbitrary expression. Since the scope of a paramete // def f(a: Int = 0, b: Int = a + 1) // "error: not found: value a" f(10)() // returns 11 (not 1) -A special expected type is used for type-checking the default argument `expr` of a method parameter `”x: T = expr”`: it is obtained by replacing all occurrences of type parameters of the method (type parameters of the class for constructors) with the undefined type. This allows specifying default arguments for polymorphic methods and classes: +A special expected type is used for type-checking the default argument `expr` of a method parameter `”x: T = expr”`: it is obtained by replacing all occurrences of type parameters of the method (type parameters of the class for constructors) with the undefined type. This allows specifying default arguments for polymorphic methods and classes: def f[T](a: T = 1) = a f() // returns 1: Int @@ -157,7 +157,7 @@ During type-checking, the static type is used to determine whether a parameter h def f(a: String, b: Int = 1) // #2 f("str") // both are applicable, #1 is selected -**Case Classes** For every case class, a method named `”copy”` is now generated which allows to easily create modified copies of the class’s instances. The copy method takes the same type and value parameters as the primary constructor of the case class, and every parameter defaults to the corresponding constructor parameter. +**Case Classes** For every case class, a method named `”copy”` is now generated which allows to easily create modified copies of the class’s instances. The copy method takes the same type and value parameters as the primary constructor of the case class, and every parameter defaults to the corresponding constructor parameter. case class A[T](a: T, b: Int) { // def copy[T’](a’: T’ = a, b’: Int = b): A[T’] = @@ -215,4 +215,4 @@ For constructor defaults, these methods are added to the companion object of the // } ## References -1. Odersky, M. _The Scala Language Specification, Version 2.11_. Available online at [http://www.scala-lang.org/files/archive/spec/2.11/](http://www.scala-lang.org/files/archive/spec/2.11/) +1. Odersky, M. _The Scala Language Specification, Version 2.11_. Available online at [http://www.scala-lang.org/files/archive/spec/2.11/](http://www.scala-lang.org/files/archive/spec/2.11/) diff --git a/_sips/sips/2010-01-22-scala-2-8-arrays.md b/_sips/sips/2010-01-22-scala-2-8-arrays.md index 407dc19bf1..3411fa929c 100644 --- a/_sips/sips/2010-01-22-scala-2-8-arrays.md +++ b/_sips/sips/2010-01-22-scala-2-8-arrays.md @@ -26,8 +26,8 @@ First, there’s actually not a single array type representation in Java but nine different ones: One representation for arrays of reference type and another eight for arrays of each of the primitive types `byte`, `char`, `short`, `int`, `long`, `float`, `double`, and `boolean`. There is no common -type for these different representations which is more specific than just -`java.lang.Object`, even though there are some reflective methods to deal with +type for these different representations which is more specific than just +`java.lang.Object`, even though there are some reflective methods to deal with arrays of arbitrary type in `java.lang.reflect.Array`. Second, there’s no way to create an array of a generic type; only monomorphic array creations are allowed. Third, the only operations supported by arrays are indexing, updates, @@ -35,14 +35,14 @@ and get length. Contrast this with what we would like to have in Scala: Arrays should slot into the collections hierarchy, supporting the hundred or so methods that are -defined on sequences. And they should certainly be generic, so that one can +defined on sequences. And they should certainly be generic, so that one can create an `Array[T]` where `T` is a type variable. ### The Past How to combine these desirables with the representation restrictions imposed by Java interoperability and performance? There’s no easy answer, and I -believe we got it wrong the first time when we designed Scala. The Scala +believe we got it wrong the first time when we designed Scala. The Scala language up to 2.7.x “magically” wrapped and unwrapped arrays when required in a process called boxing and unboxing, similarly to what is done to treat primitive numeric types as objects. “Magically” means: the compiler generated @@ -89,7 +89,7 @@ proposal is that one would not normally refer to Scala native arrays in user code, just as one rarely referred to RichString in Scala. One would only rely on the implicit conversion to add the necessary methods and traits to Java arrays. Unfortunately, the String/RichString experience has shown that this is -also problematic. In par- ticular, in pre 2.8 versions of Scala, one had the +also problematic. In particular, in pre 2.8 versions of Scala, one had the non-intuitive property that "abc".reverse.reverse == "abc" //, yet diff --git a/_sips/sips/2011-10-13-uncluttering-control.md b/_sips/sips/2011-10-13-uncluttering-control.md index 5f4dea8d64..e1ceb5d790 100644 --- a/_sips/sips/2011-10-13-uncluttering-control.md +++ b/_sips/sips/2011-10-13-uncluttering-control.md @@ -71,7 +71,7 @@ For while loops: To write a `do-while` inside a `while` loop you will need braces, like this: - while (expression1) { do expression2 while epression3 } + while (expression1) { do expression2 while expression3 } 3. In Scala 2.11: Disallow diff --git a/_sips/sips/2012-01-21-futures-promises.md b/_sips/sips/2012-01-21-futures-promises.md index a1b8d43666..11983d2201 100644 --- a/_sips/sips/2012-01-21-futures-promises.md +++ b/_sips/sips/2012-01-21-futures-promises.md @@ -109,7 +109,7 @@ We do so by calling the method `getRecentPosts` which returns a `List[String]`: f onComplete { case Right(posts) => for (post <- posts) render(post) - case Left(t) => render("An error has occured: " + t.getMessage) + case Left(t) => render("An error has occurred: " + t.getMessage) } The `onComplete` method is general in the sense that it allows the @@ -387,16 +387,16 @@ multiple `andThen` calls are ordered, as in the following example which stores the recent posts from a social network to a mutable set and then renders all the posts to the screen: - val allposts = mutable.Set[String]() + val allPosts = mutable.Set[String]() Future { session.getRecentPosts } andThen { - case Success(posts) => allposts ++= posts + case Success(posts) => allPosts ++= posts } andThen { case _ => clearAll() - for (post <- allposts) render(post) + for (post <- allPosts) render(post) } In summary, the combinators on futures are purely functional. diff --git a/_sips/sips/2013-05-31-improved-lazy-val-initialization.md b/_sips/sips/2013-05-31-improved-lazy-val-initialization.md index b3fc711ced..2ff2dfee7c 100644 --- a/_sips/sips/2013-05-31-improved-lazy-val-initialization.md +++ b/_sips/sips/2013-05-31-improved-lazy-val-initialization.md @@ -529,7 +529,7 @@ Note that this class is extracted from other place in standard library that uses - it requires usage of `identityHashCode` that is stored for every object inside object header. - as global arrays are used to store monitors, seemingly unrelated things may create contention. This is addressed in detail in evaluation section. -Both absence of monitor expansion and usage of `idetityHashCode` interact with +Both absence of monitor expansion and usage of `identityHashCode` interact with each other, as both of them operate on the object header. \[[12][12]\] presents the complete graph of transitions between possible states of the object header. What can be seen from this transition graph is that in the contended case, @@ -679,7 +679,7 @@ For those wishing to reproduce the results, the benchmarking suite takes 90 minu The final result of those benchmarks is that amount proposed versions, the two that worth considering are (V4-general) and (V6). They both perform better than the current implementation in all the contended case. -Specifically, in the contended case, V6 is 2 times fater than V1, while V4-general is 4 times faster. +Specifically, in the contended case, V6 is 2 times faster than V1, while V4-general is 4 times faster. Unfortunately V4-general is 30% slower in the uncontended case than current implementation(V1), while V6 is in the same ballpark, being up to 5% slower or faster depending on the setup of the benchmark. Based on this, we propose V6 to be used as default in future versions of Scala. @@ -699,7 +699,7 @@ Both Dotty and released Scala 2.12 already implement "Elegant Local lazy vals". ### Unsafe ### The proposed version, V6 relies on `sun.misc.Unsafe` in order to implement it's behaviour. -While `sun.misc.Unsafe` will remain availabe in Java9 there's an intention to deprecate it and replace it with VarHandles.\[[20][20]\]. +While `sun.misc.Unsafe` will remain available in Java9 there's an intention to deprecate it and replace it with VarHandles.\[[20][20]\]. The proposed version V6 can be implemented with using functionality present in Var Handles. ## Acknowledgements ## diff --git a/_sips/sips/2014-06-27-42.type.md b/_sips/sips/2014-06-27-42.type.md index 0c4e208810..afe0aeaeae 100644 --- a/_sips/sips/2014-06-27-42.type.md +++ b/_sips/sips/2014-06-27-42.type.md @@ -455,7 +455,7 @@ applications which work with large datasets. ``` This SIP updates the specification to match the current implementation and then adds the further - refinement that an explict upper bound of `Singleton` indicates that a singleton type should be + refinement that an explicit upper bound of `Singleton` indicates that a singleton type should be inferred. Given, @@ -592,7 +592,7 @@ the singleton types). This is desirable, but due to value class restrictions, en primitive types (such as `Int`). If we implemented `ValueOf[A]` as an opaque type instead of a value class, then this boxing -would be ellided, and the `valueOf[A]` method would be compiled to an identity function. +would be elided, and the `valueOf[A]` method would be compiled to an identity function. ## Related Scala issues resolved by the literal types implementation diff --git a/_sips/sips/2016-01-11-static-members.md b/_sips/sips/2016-01-11-static-members.md index 9fff070f02..3d98d6f5fe 100644 --- a/_sips/sips/2016-01-11-static-members.md +++ b/_sips/sips/2016-01-11-static-members.md @@ -97,7 +97,7 @@ object O { } {% endhighlight %} -Under the proposed scheme users will be able to opt-in to have the field `f` defined in the inner object `I` emited as a static field. +Under the proposed scheme users will be able to opt-in to have the field `f` defined in the inner object `I` emitted as a static field. In case `O.d` is annotated with `@static` the field will be created as a static field `d` in `class O`. If not annotated, it will be created in the companion module with a static forwarder `d` in `class O`. @@ -109,7 +109,7 @@ The following rules ensure that methods can be correctly compiled into static me 2. The fields annotated with `@static` should precede any non-`@static` fields. This ensures that we do not introduce surprises for users in initialization order of this class. -3. The right hand side of a method or field annotated with `@static` can only refer to top-level classes, members of globally accessible objects and `@static` members. In particular, for non-static objects `this` is not accesible. `super` is never accessible. +3. The right hand side of a method or field annotated with `@static` can only refer to top-level classes, members of globally accessible objects and `@static` members. In particular, for non-static objects `this` is not accessible. `super` is never accessible. 4. If a member `foo` of an `object C` is annotated with `@static`, the companion class `C` is not allowed to define term members with name `foo`. @@ -153,7 +153,7 @@ This means that no code precedes the `@static` field initialization which makes since fields are initialized in the order `as written`, similar to how normal fields are initialized. The `@static` proposal is similar to `@tailrec` in a sense that it fails compilation in the case where the user did not write code that follows the aforementioned rules. -These rules exist to enforce the unlikelyhood of an observable difference in semantics if `@static` annotations are dropped; +These rules exist to enforce the unlikelihood of an observable difference in semantics if `@static` annotations are dropped; The restrictions in this SIP make it hard to observe changes in initialization within the same object. It is still possible to observe those changes using multiple classes and side effects within initializers: diff --git a/_sips/sips/2017-02-07-priority-based-infix-type-precedence.md b/_sips/sips/2017-02-07-priority-based-infix-type-precedence.md index 95c73ab90d..8e2341c1eb 100644 --- a/_sips/sips/2017-02-07-priority-based-infix-type-precedence.md +++ b/_sips/sips/2017-02-07-priority-based-infix-type-precedence.md @@ -104,7 +104,7 @@ val fails : 1 + 2 * 3 + 4 = 11 //left associative:(((1+2)*3)+4))) = 13 ``` #### Developer issues example -[This](http://stackoverflow.com/questions/23333882/scala-infix-type-aliasing-for-2-type-parameters) stackoverflow question demonstrate developers are 'surprised' by the difference in infix precedence, expecting infix type precedence to act the same as expression operations. +[This](http://stackoverflow.com/questions/23333882/scala-infix-type-aliasing-for-2-type-parameters) Stack Overflow question demonstrate developers are 'surprised' by the difference in infix precedence, expecting infix type precedence to act the same as expression operations. --- diff --git a/_sips/sips/2017-09-20-opaque-types.md b/_sips/sips/2017-09-20-opaque-types.md index 7c8d5e3444..bbd4a798d3 100644 --- a/_sips/sips/2017-09-20-opaque-types.md +++ b/_sips/sips/2017-09-20-opaque-types.md @@ -885,7 +885,7 @@ there will certainly be an impact on the bytecode produced (and possibly the runtime performance). By contrast, replacing `String` with `Digits` is guaranteed to have no -impact (all occurances of `Digits` are guaranteed to be erased to +impact (all occurrences of `Digits` are guaranteed to be erased to `String`). Aside from the ergonomics of calling the `fromString` and `asString` methods, there's no runtime impact versus using the underlying type. @@ -953,7 +953,7 @@ but it is *not* a `List[AnyVal]`. Since value classes do have a runtime representation, they do increase the size of runtime artifacts produced (whether a JAR file, a -javascript file, or something else). Their methods are also compiled +JavaScript file, or something else). Their methods are also compiled to multiple representations (i.e. they support both the boxed and unboxed forms via extensions methods). Again, this comes at a cost. diff --git a/_sips/sips/2018-07-31-interpolation-quote-escape.md b/_sips/sips/2018-07-31-interpolation-quote-escape.md index bd5658d618..a04703d2a9 100644 --- a/_sips/sips/2018-07-31-interpolation-quote-escape.md +++ b/_sips/sips/2018-07-31-interpolation-quote-escape.md @@ -21,7 +21,7 @@ rather passes the raw string to the interpolator, which then has the option to process escapes itself as it sees fit. That means there are no lexing rules that process the escape, and the sequence `\"` simply terminates the interpolation. -Interpolations have a different meta-charcter -- the `$` character -- which is +Interpolations have a different meta-character -- the `$` character -- which is treated specially. Interpolations use this escape to splice in arguments, and it can also be used to escape itself as the sequence `$$` to represent a literal `$` character. @@ -90,7 +90,7 @@ on the original ticket ## Implementation The implementation is simple to the point of being trivial: see -[the implementation][5] for the actual change in functonality and the rest of +[the implementation][5] for the actual change in functionality and the rest of that PR for the spec and test changes. ## Drawbacks @@ -101,12 +101,12 @@ the language. An argument could be made that this change makes that worse rather than better. Because it affects parsing, this change may affect syntax highlighters. Syntax -highlighters tend to already stuggle around "funky" strings and interpolations. +highlighters tend to already struggle around "funky" strings and interpolations. ## Alternatives More ambitious proposals around interpolations are possible, and have been -propsed in different forms before. [This PR][6] in particular shows more options +proposed in different forms before. [This PR][6] in particular shows more options around using `\` as a meta character in interpolations. It stranded somewhere between red tape, ambition and changing processes. diff --git a/_tour/automatic-closures.md b/_tour/automatic-closures.md index 37b82524ef..e65c7130af 100644 --- a/_tour/automatic-closures.md +++ b/_tour/automatic-closures.md @@ -7,7 +7,7 @@ discourse: true partof: scala-tour --- -Scala allows parameterless function names as parameters of methods. When such a method is called, the actual parameters for parameterless function names are not evaluated and a nullary function is passed instead which encapsulates the computation of the corresponding parameter (so-called *call-by-name* evalutation). +Scala allows parameterless function names as parameters of methods. When such a method is called, the actual parameters for parameterless function names are not evaluated and a nullary function is passed instead which encapsulates the computation of the corresponding parameter (so-called *call-by-name* evaluation). The following code demonstrates this mechanism: diff --git a/_tour/traits.md b/_tour/traits.md index 121255457d..37bf615c6c 100644 --- a/_tour/traits.md +++ b/_tour/traits.md @@ -45,7 +45,7 @@ trait Iterator[A] { class IntIterator(to: Int) extends Iterator[Int] { private var current = 0 override def hasNext: Boolean = current < to - override def next(): Int = { + override def next(): Int = { if (hasNext) { val t = current current += 1 diff --git a/contribute.md b/contribute.md index 9f4692f679..5f4c2b6850 100644 --- a/contribute.md +++ b/contribute.md @@ -79,7 +79,7 @@ If you have something you're thinking about contributing, or that you're thinkin ### Guides/Overviews -A guide or an overview that can be logically placed on **one** page must be placed in the directory `overviews/RELEVANT-CATEGORY/_posts` with the file name in the format `YYYY-MM-dd-title-separarted-by-dashes.md`, and header: +A guide or an overview that can be logically placed on **one** page must be placed in the directory `overviews/RELEVANT-CATEGORY/_posts` with the file name in the format `YYYY-MM-dd-title-separated-by-dashes.md`, and header: --- layout: overview diff --git a/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md b/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md index 74bfff8b5b..021aed1bbf 100644 --- a/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md +++ b/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md @@ -19,11 +19,11 @@ Started with Scala and sbt on the Command Line]({{site.baseurl}}/getting-started here to the section "Writing Scala code". 1. If you didn't create the project from the command line, open up IntelliJ and select "Create New Project" - * On the left panel, select Scala and on the right panel, select SBT + * On the left panel, select Scala and on the right panel, select sbt * Click **Next** - * Name the project "SBTExampleProject" + * Name the project "SbtExampleProject" 1. If you already created the project on the command line, open up IntelliJ, select *Import Project* and open the `build.sbt` file for your project -1. Make sure the **JDK Version** is 1.8 and the **SBT Version** is at least 0.13.13 +1. Make sure the **JDK version** is 1.8 and the **sbt version** is at least 0.13.13 1. Select **Use auto-import** so dependencies are automatically downloaded when available 1. Select **Finish** @@ -47,7 +47,7 @@ but here's a glance at what everything is for: ## Writing Scala code -1. On the **Project** panel on the left, expand `SBTExampleProject` => `src` +1. On the **Project** panel on the left, expand `SbtExampleProject` => `src` => `main` 1. Right-click `scala` and select **New** => **Package** 1. Name the package `example` and click **OK**. @@ -68,9 +68,9 @@ to see if sbt can run your project on the command line. ## Running the project 1. From the **Run** menu, select **Edit configurations** -1. Click the **+** button and select **SBT Task**. +1. Click the **+** button and select **sbt Task**. 1. Name it `Run the program`. -1. In the **Tasks** field, type `~run`. The `~` causes SBT to rebuild and rerun the project +1. In the **Tasks** field, type `~run`. The `~` causes sbt to rebuild and rerun the project when you save changes to a file in the project. 1. Click **OK**. 1. On the **Run** menu. Click **Run 'Run the program'**. diff --git a/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md b/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md index 388f76a1de..ba38a030ee 100644 --- a/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md +++ b/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md @@ -20,9 +20,9 @@ We assume you know [how to create a Scala project with sbt](getting-started-with ``` sbt test -[info] Loading global plugins from /Users/travislee/.sbt/0.13/plugins -[info] Loading project definition from /Users/travislee/workspace/sandbox/my-something-project/project -[info] Set current project to scalatest-example (in build file:/Users/travislee/workspace/sandbox/my-something-project/) +[info] Loading global plugins from /Users/username/.sbt/0.13/plugins +[info] Loading project definition from /Users/username/workspace/sandbox/my-something-project/project +[info] Set current project to scalatest-example (in build file:/Users/username/workspace/sandbox/my-something-project/) [info] CubeCalculatorTest: [info] - CubeCalculator.cube [info] Run completed in 267 milliseconds. diff --git a/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md b/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md index 7735015903..60c52a7875 100644 --- a/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md +++ b/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md @@ -6,7 +6,7 @@ discourse: true ###### By Heather Miller and Martin Odersky
- In this post, we discuss our experience giving the popular MOOC Functional Programming Principles in Scala, and provide some insight into who our course participants were, how, overall, students performed in the course, and how students felt about the course. We visualize a lot of these statistics in a number of interactive plots, and we go on to publicly release the data and the code to generate these plots within a fun Scala-based project aimed at allowing you to manipulate these statistics with functional programming in Scala, to generate HTML/Javascript for easily visualizing and sharing them. We encourage you to share what you find with us— we'll share a number of your plots in a follow-up post! + In this post, we discuss our experience giving the popular MOOC Functional Programming Principles in Scala, and provide some insight into who our course participants were, how, overall, students performed in the course, and how students felt about the course. We visualize a lot of these statistics in a number of interactive plots, and we go on to publicly release the data and the code to generate these plots within a fun Scala-based project aimed at allowing you to manipulate these statistics with functional programming in Scala, to generate HTML/JavaScript for easily visualizing and sharing them. We encourage you to share what you find with us— we'll share a number of your plots in a follow-up post!
[_Functional Programming Principles in Scala_](https://www.coursera.org/course/progfun) is a [MOOC](http://en.wikipedia.org/wiki/Massive_open_online_course) given by [our research group](http://lamp.epfl.ch) at [EPFL](http://www.epfl.ch), whose first edition was recently completed on [Coursera](http://www.coursera.org). The certificates of completion for those who passed the course have been released, and in looking back as the dust settles— it was a great experience to have done a class like that which greatly exceeded our expectations in more than one dimension. diff --git a/resources/images/library-author-guide/fowards_backwards_compatibility.png b/resources/images/library-author-guide/forward_backward_compatibility.png similarity index 100% rename from resources/images/library-author-guide/fowards_backwards_compatibility.png rename to resources/images/library-author-guide/forward_backward_compatibility.png From 557caf9adb45b7b84b1072cc603964ffbee2a9c3 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 10 Jun 2019 15:43:32 +0200 Subject: [PATCH 0505/3075] Update representation of un-evaluated collections as per scala/scala#8029 --- .../concrete-immutable-collection-classes.md | 4 ++-- _overviews/collections-2.13/views.md | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_overviews/collections-2.13/concrete-immutable-collection-classes.md b/_overviews/collections-2.13/concrete-immutable-collection-classes.md index e3c8f68556..131295bf0f 100644 --- a/_overviews/collections-2.13/concrete-immutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-immutable-collection-classes.md @@ -25,7 +25,7 @@ A [LazyList](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/co Whereas lists are constructed with the `::` operator, lazy lists are constructed with the similar-looking `#::`. Here is a simple example of a lazy list containing the integers 1, 2, and 3: scala> val lazyList = 1 #:: 2 #:: 3 #:: LazyList.empty - lazyList: scala.collection.immutable.LazyList[Int] = LazyList(?) + lazyList: scala.collection.immutable.LazyList[Int] = LazyList() The head of this lazy list is 1, and the tail of it has 2 and 3. None of the elements are printed here, though, because the list hasn’t been computed yet! Lazy lists are specified to compute lazily, and the `toString` method of a lazy list is careful not to force any extra evaluation. @@ -40,7 +40,7 @@ This function is deceptively simple. The first element of the sequence is clearl Here are the first few elements of the Fibonacci sequence starting with two ones: scala> val fibs = fibFrom(1, 1).take(7) - fibs: scala.collection.immutable.LazyList[Int] = LazyList(?) + fibs: scala.collection.immutable.LazyList[Int] = LazyList() scala> fibs.toList res9: List[Int] = List(1, 1, 2, 3, 5, 8, 13) diff --git a/_overviews/collections-2.13/views.md b/_overviews/collections-2.13/views.md index a9ec4c3d25..61ebae3cef 100644 --- a/_overviews/collections-2.13/views.md +++ b/_overviews/collections-2.13/views.md @@ -46,20 +46,20 @@ In the last statement, the expression `v map (_ + 1)` constructs a new vector wh Let's do this sequence of operations again, one by one: scala> val vv = v.view - vv: scala.collection.IndexedSeqView[Int] = View(?) + vv: scala.collection.IndexedSeqView[Int] = IndexedSeqView() The application `v.view` gives you an `IndexedSeqView[Int]`, i.e. a lazily evaluated `IndexedSeq[Int]`. Like with `LazyList`, -the `toString` operation of views does not force the view elements, that’s why the content of `vv` is shown as `View(?)`. +the `toString` operation of views does not force the view elements, that’s why the content of `vv` is shown as `IndexedSeqView()`. Applying the first `map` to the view gives: scala> vv map (_ + 1) - res13: scala.collection.IndexedSeqView[Int] = View(?) + res13: scala.collection.IndexedSeqView[Int] = IndexedSeqView() The result of the `map` is another `IndexedSeqView[Int]` value. This is in essence a wrapper that *records* the fact that a `map` with function `(_ + 1)` needs to be applied on the vector `v`. It does not apply that map until the view is forced, however. Let's now apply the second `map` to the last result. scala> res13 map (_ * 2) - res14: scala.collection.IndexedSeqView[Int] = View(?) + res14: scala.collection.IndexedSeqView[Int] = IndexedSeqView() Finally, forcing the last result gives: From e56ed6502486f58935cb08f2a663535890d287b4 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 10 Jun 2019 22:34:04 +0200 Subject: [PATCH 0506/3075] update 2.13 collections intro --- _overviews/collections-2.13/introduction.md | 46 ++++++++++----------- 1 file changed, 21 insertions(+), 25 deletions(-) diff --git a/_overviews/collections-2.13/introduction.md b/_overviews/collections-2.13/introduction.md index 2f077f3383..a4ff432874 100644 --- a/_overviews/collections-2.13/introduction.md +++ b/_overviews/collections-2.13/introduction.md @@ -12,22 +12,15 @@ num: 1 permalink: /overviews/collections-2.13/:title.html --- -**Martin Odersky, and Lex Spoon** - -In the eyes of many, the new collections framework is the most significant -change in the Scala 2.8 release. Scala had collections before (and in fact the new -framework is largely compatible with them). But it's only 2.8 that -provides a common, uniform, and all-encompassing framework for -collection types. - -Even though the additions to collections are subtle at first glance, -the changes they can provoke in your programming style can be -profound. In fact, quite often it's as if you work on a higher-level -with the basic building blocks of a program being whole collections -instead of their elements. This new style of programming requires some -adaptation. Fortunately, the adaptation is helped by several nice -properties of the new Scala collections. They are easy to use, -concise, safe, fast, universal. +The collections framework is the heart of the Scala 2.13 standard +library. It provides a common, uniform, and all-encompassing +framework for collection types. This framework enables you to work +with data in memory at a high level, with the basic building blocks of +a program being whole collections, instead of individual elements. + +This style of programming requires some learning. Fortunately, +the adaptation is helped by several nice properties of the Scala +collections. They are easy to use, concise, safe, fast, universal. **Easy to use:** A small vocabulary of 20-50 methods is enough to solve most collection problems in a couple of operations. No @@ -40,7 +33,7 @@ collection updates is eliminated. **Concise:** You can achieve with a single word what used to take one or several loops. You can express functional operations with lightweight syntax and combine operations effortlessly, so that the result -feels like a custom algebra. +feels like a custom algebra. **Safe:** This one has to be experienced to sink in. The statically typed and functional nature of Scala's collections means @@ -59,10 +52,13 @@ libraries. As a result, using collections is typically quite efficient. You might be able to do a little bit better with carefully hand-tuned data structures and operations, but you might also do a lot worse by making some suboptimal implementation decisions along the -way. What's more, collections have been recently adapted to parallel -execution on multi-cores. Parallel collections support the same -operations as sequential ones, so no new operations need to be learned -and no code needs to be rewritten. You can turn a sequential collection into a +way. + +**Parallel**: The +[`scala-parallel-collections` module](https://index.scala-lang.org/scala/scala-parallel-collections/scala-parallel-collections) +provides parallel execution of collections operations across multiple cores. +Parallel collections generally support the same +operations as sequential ones. You can turn a sequential collection into a parallel one simply by invoking the `par` method. **Universal:** Collections provide the same operations on @@ -89,10 +85,10 @@ traditional collection processing (three loops for an array, because the intermediate results need to be buffered somewhere else). Once you have learned the basic collection vocabulary you will also find writing this code is much easier and safer than writing explicit -loops. Furthermore, the `partition` operation is quite fast, and can -be even faster on parallel collections on multi-cores. (Parallel -collections are available as a -[separate library](https://index.scala-lang.org/scala/scala-parallel-collections/scala-parallel-collections)) +loops. + +Furthermore, the `partition` operation is quite fast, and can +be even faster on parallel collections on multiple cores. This document provides an in depth discussion of the APIs of the Scala collections classes from a user perspective. It takes you on From c95cb8f2f4577e845853784f0cbc0d4ea09184c3 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Tue, 11 Jun 2019 10:14:11 +0800 Subject: [PATCH 0507/3075] Fix issue#1361, add space for markdown syntax enclosing . --- glossary/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary/index.md b/glossary/index.md index 3b638f3a46..ca50ce5486 100644 --- a/glossary/index.md +++ b/glossary/index.md @@ -195,7 +195,7 @@ Meta-programming software is software whose input is itself software. Compilers A _method_ is a function that is a member of some class, trait, or singleton object. * #### mixin -_Mixin_ is what a trait is called when it is being used in a mixin composition. In other words, in “`trait Hat`,” `Hat` is just a trait, but in “`new Cat extends AnyRef with Hat`,” `Hat` can be called a mixin. When used as a verb, “mix in” is two words. For example, you can _mix_ traits _in_to classes or other traits. +_Mixin_ is what a trait is called when it is being used in a mixin composition. In other words, in “`trait Hat`,” `Hat` is just a trait, but in “`new Cat extends AnyRef with Hat`,” `Hat` can be called a mixin. When used as a verb, “mix in” is two words. For example, you can _mix_ traits _in_ to classes or other traits. * #### mixin composition The process of mixing traits into classes or other traits. _Mixin composition_ differs from traditional multiple inheritance in that the type of the super reference is not known at the point the trait is defined, but rather is determined anew each time the trait is mixed into a class or other trait. From 4998f619855df3accd6d6409a42c0cc300148a48 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Tue, 11 Jun 2019 12:22:24 +0800 Subject: [PATCH 0508/3075] Fix issue#1363, remove - and space within defined. --- glossary/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary/index.md b/glossary/index.md index 3b638f3a46..ba2382b2ac 100644 --- a/glossary/index.md +++ b/glossary/index.md @@ -216,7 +216,7 @@ In Scala, every _operation_ is a method call. Methods may be invoked in _operato Functions may take zero to many _parameters_. Each parameter has a name and a type. The distinction between parameters and arguments is that arguments refer to the actual objects passed when a function is invoked. Parameters are the variables that refer to those passed arguments. * #### parameterless function -A function that takes no parameters, which is de- fined without any empty parentheses. Invocations of parameterless functions may not supply parentheses. This supports the [uniform access principle](#uniform-access-principle), which enables the `def` to be changed into a `val` without requiring a change to client code. +A function that takes no parameters, which is defined without any empty parentheses. Invocations of parameterless functions may not supply parentheses. This supports the [uniform access principle](#uniform-access-principle), which enables the `def` to be changed into a `val` without requiring a change to client code. * #### parameterless method A _parameterless method_ is a parameterless function that is a member of a class, trait, or singleton object. From 978b9b07ed0d981b7967cf0fe0bcdb81ddf0b27d Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 10 Jun 2019 13:45:16 +0200 Subject: [PATCH 0509/3075] Scala 2.13 release --- _config.yml | 4 +-- .../concrete-immutable-collection-classes.md | 22 ++++++++-------- .../concrete-mutable-collection-classes.md | 22 ++++++++-------- _overviews/collections-2.13/iterators.md | 6 ++--- _overviews/collections-2.13/overview.md | 8 +++--- _overviews/collections-2.13/trait-iterable.md | 4 +-- _overviews/collections/arrays.md | 2 +- .../concrete-immutable-collection-classes.md | 20 +++++++------- .../concrete-mutable-collection-classes.md | 26 +++++++++---------- ...ions-between-java-and-scala-collections.md | 4 +-- _overviews/collections/iterators.md | 6 ++--- .../concrete-parallel-collections.md | 22 ++++++++-------- api/all.md | 6 +++++ 13 files changed, 79 insertions(+), 73 deletions(-) diff --git a/_config.yml b/_config.yml index 32288ccccc..e7564efd1a 100644 --- a/_config.yml +++ b/_config.yml @@ -15,8 +15,8 @@ keywords: - Document - Guide -scala-version: 2.12.8 -scala-213-version: 2.13.0-M5 +scala-version: 2.13.0 +scala-212-version: 2.12.8 collections: style: diff --git a/_overviews/collections-2.13/concrete-immutable-collection-classes.md b/_overviews/collections-2.13/concrete-immutable-collection-classes.md index e3c8f68556..af8ed0b95c 100644 --- a/_overviews/collections-2.13/concrete-immutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-immutable-collection-classes.md @@ -16,11 +16,11 @@ Scala provides many concrete immutable collection classes for you to choose from ## Lists -A [List](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/List.html) is a finite immutable sequence. They provide constant-time access to their first element as well as the rest of the list, and they have a constant-time cons operation for adding a new element to the front of the list. Many other operations take linear time. +A [List](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/List.html) is a finite immutable sequence. They provide constant-time access to their first element as well as the rest of the list, and they have a constant-time cons operation for adding a new element to the front of the list. Many other operations take linear time. ## LazyLists -A [LazyList](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/LazyList.html) is like a list except that its elements are computed lazily. Because of this, a lazy list can be infinitely long. Only those elements requested are computed. Otherwise, lazy lists have the same performance characteristics as lists. +A [LazyList](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/LazyList.html) is like a list except that its elements are computed lazily. Because of this, a lazy list can be infinitely long. Only those elements requested are computed. Otherwise, lazy lists have the same performance characteristics as lists. Whereas lists are constructed with the `::` operator, lazy lists are constructed with the similar-looking `#::`. Here is a simple example of a lazy list containing the integers 1, 2, and 3: @@ -48,7 +48,7 @@ Here are the first few elements of the Fibonacci sequence starting with two ones Lists are very efficient when the algorithm processing them is careful to only process their heads. Accessing, adding, and removing the head of a list takes only constant time, whereas accessing or modifying elements later in the list takes time linear in the depth into the list. -[ArraySeq](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/ArraySeq.html) is a +[ArraySeq](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/ArraySeq.html) is a collection type (introduced in Scala 2.13) that addresses the inefficiency for random access on lists. ArraySeqs allow accessing any element of the collection in constant time. As a result, algorithms using ArraySeqs do not have to be careful about accessing just the head of the collection. They can access elements at arbitrary locations, @@ -87,7 +87,7 @@ We have seen in the previous sections that `List` and `ArraySeq` are efficient d use cases but they are also inefficient in other use cases: for instance, prepending an element is constant for `List`, but linear for `ArraySeq`, and, conversely, indexed access is constant for `ArraySeq` but linear for `List`. -[Vector](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/Vector.html) is a collection type that provides good performance for all its operations. Vectors allow accessing any element of the sequence in "effectively" constant time. It's a larger constant than for access to the head of a List or for reading an element of an ArraySeq, but it's a constant nonetheless. As a result, algorithms using vectors do not have to be careful about accessing just the head of the sequence. They can access and modify elements at arbitrary locations, and thus they can be much more convenient to write. +[Vector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html) is a collection type that provides good performance for all its operations. Vectors allow accessing any element of the sequence in "effectively" constant time. It's a larger constant than for access to the head of a List or for reading an element of an ArraySeq, but it's a constant nonetheless. As a result, algorithms using vectors do not have to be careful about accessing just the head of the sequence. They can access and modify elements at arbitrary locations, and thus they can be much more convenient to write. Vectors are built and modified just like any other sequence. @@ -112,7 +112,7 @@ Because vectors strike a good balance between fast random selections and fast ra ## Immutable Queues -A [Queue](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/Queue.html) is a first-in-first-out sequence. You enqueue an element onto a queue with `enqueue`, and dequeue an element with `dequeue`. These operations are constant time. +A [Queue](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Queue.html) is a first-in-first-out sequence. You enqueue an element onto a queue with `enqueue`, and dequeue an element with `dequeue`. These operations are constant time. Here's how you can create an empty immutable queue: @@ -140,7 +140,7 @@ Note that `dequeue` returns a pair consisting of the element removed and the res ## Ranges -A [Range](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/Range.html) is an ordered sequence of integers that are equally spaced apart. For example, "1, 2, 3," is a range, as is "5, 8, 11, 14." To create a range in Scala, use the predefined methods `to` and `by`. +A [Range](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html) is an ordered sequence of integers that are equally spaced apart. For example, "1, 2, 3," is a range, as is "5, 8, 11, 14." To create a range in Scala, use the predefined methods `to` and `by`. scala> 1 to 3 res2: scala.collection.immutable.Range.Inclusive = Range(1, 2, 3) @@ -156,7 +156,7 @@ Ranges are represented in constant space, because they can be defined by just th ## Compressed Hash-Array Mapped Prefix-trees -Hash tries are a standard way to implement immutable sets and maps efficiently. [Compressed Hash-Array Mapped Prefix-trees](https://github.com/msteindorfer/oopsla15-artifact/) are a design for hash tries on the JVM which improves locality and makes sure the trees remain in a canonical and compact representation. They are supported by class [immutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/HashMap.html). Their representation is similar to vectors in that they are also trees where every node has 32 elements or 32 subtrees. But the selection of these keys is now done based on hash code. For instance, to find a given key in a map, one first takes the hash code of the key. Then, the lowest 5 bits of the hash code are used to select the first subtree, followed by the next 5 bits and so on. The selection stops once all elements stored in a node have hash codes that differ from each other in the bits that are selected up to this level. +Hash tries are a standard way to implement immutable sets and maps efficiently. [Compressed Hash-Array Mapped Prefix-trees](https://github.com/msteindorfer/oopsla15-artifact/) are a design for hash tries on the JVM which improves locality and makes sure the trees remain in a canonical and compact representation. They are supported by class [immutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/HashMap.html). Their representation is similar to vectors in that they are also trees where every node has 32 elements or 32 subtrees. But the selection of these keys is now done based on hash code. For instance, to find a given key in a map, one first takes the hash code of the key. Then, the lowest 5 bits of the hash code are used to select the first subtree, followed by the next 5 bits and so on. The selection stops once all elements stored in a node have hash codes that differ from each other in the bits that are selected up to this level. Hash tries strike a nice balance between reasonably fast lookups and reasonably efficient functional insertions (`+`) and deletions (`-`). That's why they underly Scala's default implementations of immutable maps and sets. In fact, Scala has a further optimization for immutable sets and maps that contain less than five elements. Sets and maps with one to four elements are stored as single objects that just contain the elements (or key/value pairs in the case of a map) as fields. The empty immutable set and the empty immutable map is in each case a single object - there's no need to duplicate storage for those because an empty immutable set or map will always stay empty. @@ -164,7 +164,7 @@ Hash tries strike a nice balance between reasonably fast lookups and reasonably Red-black trees are a form of balanced binary tree where some nodes are designated "red" and others designated "black." Like any balanced binary tree, operations on them reliably complete in time logarithmic to the size of the tree. -Scala provides implementations of immutable sets and maps that use a red-black tree internally. Access them under the names [TreeSet](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/TreeSet.html) and [TreeMap](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/TreeMap.html). +Scala provides implementations of immutable sets and maps that use a red-black tree internally. Access them under the names [TreeSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/TreeSet.html) and [TreeMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/TreeMap.html). scala> scala.collection.immutable.TreeSet.empty[Int] @@ -176,7 +176,7 @@ Red-black trees are the standard implementation of `SortedSet` in Scala, because ## Immutable BitSets -A [BitSet](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/BitSet.html) represents a collection of small integers as the bits of a larger integer. For example, the bit set containing 3, 2, and 0 would be represented as the integer 1101 in binary, which is 13 in decimal. +A [BitSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/BitSet.html) represents a collection of small integers as the bits of a larger integer. For example, the bit set containing 3, 2, and 0 would be represented as the integer 1101 in binary, which is 13 in decimal. Internally, bit sets use an array of 64-bit `Long`s. The first `Long` in the array is for integers 0 through 63, the second is for 64 through 127, and so on. Thus, bit sets are very compact so long as the largest integer in the set is less than a few hundred or so. @@ -193,7 +193,7 @@ Operations on bit sets are very fast. Testing for inclusion takes constant time. ## VectorMaps -A [VectorMap](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/VectorMap.html) represents +A [VectorMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/VectorMap.html) represents a map using both a `Vector` of keys and a `HashMap`. It provides an iterator that returns all the entries in their insertion order. @@ -217,7 +217,7 @@ order of elements into account. ## ListMaps -A [ListMap](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/ListMap.html) represents a map as a linked list of key-value pairs. In general, operations on a list map might have to iterate through the entire list. Thus, operations on a list map take time linear in the size of the map. In fact there is little usage for list maps in Scala because standard immutable maps are almost always faster. The only possible exception to this is if the map is for some reason constructed in such a way that the first elements in the list are selected much more often than the other elements. +A [ListMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/ListMap.html) represents a map as a linked list of key-value pairs. In general, operations on a list map might have to iterate through the entire list. Thus, operations on a list map take time linear in the size of the map. In fact there is little usage for list maps in Scala because standard immutable maps are almost always faster. The only possible exception to this is if the map is for some reason constructed in such a way that the first elements in the list are selected much more often than the other elements. scala> val map = scala.collection.immutable.ListMap(1->"one", 2->"two") map: scala.collection.immutable.ListMap[Int,java.lang.String] = diff --git a/_overviews/collections-2.13/concrete-mutable-collection-classes.md b/_overviews/collections-2.13/concrete-mutable-collection-classes.md index bcf855ddc6..f2cf39eb41 100644 --- a/_overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -16,7 +16,7 @@ You've now seen the most commonly used immutable collection classes that Scala p ## Array Buffers -An [ArrayBuffer](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/ArrayBuffer.html) buffer holds an array and a size. Most operations on an array buffer have the same speed as for an array, because the operations simply access and modify the underlying array. Additionally, array buffers can have data efficiently added to the end. Appending an item to an array buffer takes amortized constant time. Thus, array buffers are useful for efficiently building up a large collection whenever the new items are always added to the end. +An [ArrayBuffer](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayBuffer.html) buffer holds an array and a size. Most operations on an array buffer have the same speed as for an array, because the operations simply access and modify the underlying array. Additionally, array buffers can have data efficiently added to the end. Appending an item to an array buffer takes amortized constant time. Thus, array buffers are useful for efficiently building up a large collection whenever the new items are always added to the end. scala> val buf = scala.collection.mutable.ArrayBuffer.empty[Int] buf: scala.collection.mutable.ArrayBuffer[Int] = ArrayBuffer() @@ -29,7 +29,7 @@ An [ArrayBuffer](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scal ## List Buffers -A [ListBuffer](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/ListBuffer.html) is like an array buffer except that it uses a linked list internally instead of an array. If you plan to convert the buffer to a list once it is built up, use a list buffer instead of an array buffer. +A [ListBuffer](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ListBuffer.html) is like an array buffer except that it uses a linked list internally instead of an array. If you plan to convert the buffer to a list once it is built up, use a list buffer instead of an array buffer. scala> val buf = scala.collection.mutable.ListBuffer.empty[Int] buf: scala.collection.mutable.ListBuffer[Int] = ListBuffer() @@ -42,7 +42,7 @@ A [ListBuffer](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/ ## StringBuilders -Just like an array buffer is useful for building arrays, and a list buffer is useful for building lists, a [StringBuilder](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/StringBuilder.html) is useful for building strings. String builders are so commonly used that they are already imported into the default namespace. Create them with a simple `new StringBuilder`, like this: +Just like an array buffer is useful for building arrays, and a list buffer is useful for building lists, a [StringBuilder](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/StringBuilder.html) is useful for building strings. String builders are so commonly used that they are already imported into the default namespace. Create them with a simple `new StringBuilder`, like this: scala> val buf = new StringBuilder buf: StringBuilder = @@ -55,7 +55,7 @@ Just like an array buffer is useful for building arrays, and a list buffer is us ## ArrayDeque -An [ArrayDeque](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/ArrayDeque.html) +An [ArrayDeque](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayDeque.html) is a sequence that supports efficient addition of elements in the front and in the end. It internally uses a resizable array. @@ -81,7 +81,7 @@ Scala provides mutable queues in addition to immutable ones. You use a `mQueue` ## Stacks -You saw immutable stacks earlier. There is also a mutable version, supported by class [mutable.Stack](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/Stack.html). It works exactly the same as the immutable version except that modifications happen in place. +You saw immutable stacks earlier. There is also a mutable version, supported by class [mutable.Stack](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/Stack.html). It works exactly the same as the immutable version except that modifications happen in place. scala> val stack = new scala.collection.mutable.Stack[Int] stack: scala.collection.mutable.Stack[Int] = Stack() @@ -104,13 +104,13 @@ You saw immutable stacks earlier. There is also a mutable version, supported by ## Mutable ArraySeqs -Array sequences are mutable sequences of fixed size which store their elements internally in an `Array[Object]`. They are implemented in Scala by class [ArraySeq](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/ArraySeq.html). +Array sequences are mutable sequences of fixed size which store their elements internally in an `Array[Object]`. They are implemented in Scala by class [ArraySeq](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArraySeq.html). You would typically use an `ArraySeq` if you want an array for its performance characteristics, but you also want to create generic instances of the sequence where you do not know the type of the elements and you do not have a `ClassTag` to provide it at run-time. These issues are explained in the section on [arrays]({{ site.baseurl }}/overviews/collections/arrays.html). ## Hash Tables -A hash table stores its elements in an underlying array, placing each item at a position in the array determined by the hash code of that item. Adding an element to a hash table takes only constant time, so long as there isn't already another element in the array that has the same hash code. Hash tables are thus very fast so long as the objects placed in them have a good distribution of hash codes. As a result, the default mutable map and set types in Scala are based on hash tables. You can access them also directly under the names [mutable.HashSet](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/HashSet.html) and [mutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/HashMap.html). +A hash table stores its elements in an underlying array, placing each item at a position in the array determined by the hash code of that item. Adding an element to a hash table takes only constant time, so long as there isn't already another element in the array that has the same hash code. Hash tables are thus very fast so long as the objects placed in them have a good distribution of hash codes. As a result, the default mutable map and set types in Scala are based on hash tables. You can access them also directly under the names [mutable.HashSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/HashSet.html) and [mutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/HashMap.html). Hash sets and maps are used just like any other set or map. Here are some simple examples: @@ -129,11 +129,11 @@ Iteration over a hash table is not guaranteed to occur in any particular order. ## Weak Hash Maps -A weak hash map is a special kind of hash map where the garbage collector does not follow links from the map to the keys stored in it. This means that a key and its associated value will disappear from the map if there is no other reference to that key. Weak hash maps are useful for tasks such as caching, where you want to re-use an expensive function's result if the function is called again on the same key. If keys and function results are stored in a regular hash map, the map could grow without bounds, and no key would ever become garbage. Using a weak hash map avoids this problem. As soon as a key object becomes unreachable, it's entry is removed from the weak hashmap. Weak hash maps in Scala are implemented by class [WeakHashMap](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/WeakHashMap.html) as a wrapper of an underlying Java implementation `java.util.WeakHashMap`. +A weak hash map is a special kind of hash map where the garbage collector does not follow links from the map to the keys stored in it. This means that a key and its associated value will disappear from the map if there is no other reference to that key. Weak hash maps are useful for tasks such as caching, where you want to re-use an expensive function's result if the function is called again on the same key. If keys and function results are stored in a regular hash map, the map could grow without bounds, and no key would ever become garbage. Using a weak hash map avoids this problem. As soon as a key object becomes unreachable, it's entry is removed from the weak hashmap. Weak hash maps in Scala are implemented by class [WeakHashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/WeakHashMap.html) as a wrapper of an underlying Java implementation `java.util.WeakHashMap`. ## Concurrent Maps -A concurrent map can be accessed by several threads at once. In addition to the usual [Map](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Map.html) operations, it provides the following atomic operations: +A concurrent map can be accessed by several threads at once. In addition to the usual [Map](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Map.html) operations, it provides the following atomic operations: ### Operations in Class concurrent.Map @@ -144,11 +144,11 @@ A concurrent map can be accessed by several threads at once. In addition to the | `m.replace(k, old, new)` |Replaces value associated with key `k` to `new`, if it was previously bound to `old`. | | `m.replace (k, v)` |Replaces value associated with key `k` to `v`, if it was previously bound to some value.| -`concurrent.Map` is a trait in the Scala collections library. Currently, it has two implementations. The first one is Java's `java.util.concurrent.ConcurrentMap`, which can be converted automatically into a Scala map using the [standard Java/Scala collection conversions]({{ site.baseurl }}/overviews/collections/conversions-between-java-and-scala-collections.html). The second implementation is [TrieMap](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/concurrent/TrieMap.html), which is a lock-free implementation of a hash array mapped trie. +`concurrent.Map` is a trait in the Scala collections library. Currently, it has two implementations. The first one is Java's `java.util.concurrent.ConcurrentMap`, which can be converted automatically into a Scala map using the [standard Java/Scala collection conversions]({{ site.baseurl }}/overviews/collections/conversions-between-java-and-scala-collections.html). The second implementation is [TrieMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), which is a lock-free implementation of a hash array mapped trie. ## Mutable Bitsets -A mutable bit of type [mutable.BitSet](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/BitSet.html) set is just like an immutable one, except that it is modified in place. Mutable bit sets are slightly more efficient at updating than immutable ones, because they don't have to copy around `Long`s that haven't changed. +A mutable bit of type [mutable.BitSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/BitSet.html) set is just like an immutable one, except that it is modified in place. Mutable bit sets are slightly more efficient at updating than immutable ones, because they don't have to copy around `Long`s that haven't changed. scala> val bits = scala.collection.mutable.BitSet.empty bits: scala.collection.mutable.BitSet = BitSet() diff --git a/_overviews/collections-2.13/iterators.md b/_overviews/collections-2.13/iterators.md index 55de58cb7e..6d71f2bd1b 100644 --- a/_overviews/collections-2.13/iterators.md +++ b/_overviews/collections-2.13/iterators.md @@ -12,7 +12,7 @@ num: 15 permalink: /overviews/collections-2.13/:title.html --- -An iterator is not a collection, but rather a way to access the elements of a collection one by one. The two basic operations on an iterator `it` are `next` and `hasNext`. A call to `it.next()` will return the next element of the iterator and advance the state of the iterator. Calling `next` again on the same iterator will then yield the element one beyond the one returned previously. If there are no more elements to return, a call to `next` will throw a `NoSuchElementException`. You can find out whether there are more elements to return using [Iterator](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Iterator.html)'s `hasNext` method. +An iterator is not a collection, but rather a way to access the elements of a collection one by one. The two basic operations on an iterator `it` are `next` and `hasNext`. A call to `it.next()` will return the next element of the iterator and advance the state of the iterator. Calling `next` again on the same iterator will then yield the element one beyond the one returned previously. If there are no more elements to return, a call to `next` will throw a `NoSuchElementException`. You can find out whether there are more elements to return using [Iterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html)'s `hasNext` method. The most straightforward way to "step through" all the elements returned by an iterator `it` uses a while-loop: @@ -78,7 +78,7 @@ destructively modified by invoking arbitrary methods. This creates the illusion the elements twice, but the effect is achieved through internal buffering. As usual, the underlying iterator `it` cannot be used directly and must be discarded. -In summary, iterators behave like collections _if one never accesses an iterator again after invoking a method on it_. The Scala collection libraries make this explicit with an abstraction [IterableOnce](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/IterableOnce.html), which is a common superclass of [Iterable](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Iterable.html) and [Iterator](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Iterator.html). `IterableOnce[A]` only has two methods: `iterator: Iterator[A]` and `knownSize: Int`. If an `IterableOnce` object is in fact an `Iterator`, its `iterator` operation always returns itself, in its current state, but if it is an `Iterable`, its `iterator` operation always return a new `Iterator`. A common use case of `IterableOnce` is as an argument type for methods that can take either an iterator or a collection as argument. An example is the appending method `concat` in class `Iterable`. It takes an `IterableOnce` parameter, so you can append elements coming from either an iterator or a collection. +In summary, iterators behave like collections _if one never accesses an iterator again after invoking a method on it_. The Scala collection libraries make this explicit with an abstraction [IterableOnce](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/IterableOnce.html), which is a common superclass of [Iterable](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterable.html) and [Iterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html). `IterableOnce[A]` only has two methods: `iterator: Iterator[A]` and `knownSize: Int`. If an `IterableOnce` object is in fact an `Iterator`, its `iterator` operation always returns itself, in its current state, but if it is an `Iterable`, its `iterator` operation always return a new `Iterator`. A common use case of `IterableOnce` is as an argument type for methods that can take either an iterator or a collection as argument. An example is the appending method `concat` in class `Iterable`. It takes an `IterableOnce` parameter, so you can append elements coming from either an iterator or a collection. All operations on iterators are summarized below. @@ -189,7 +189,7 @@ Sometimes you want an iterator that can "look ahead", so that you can inspect th But looking at this code more closely, it's clear that this is wrong: The code will indeed skip leading empty strings, but it will also advance `it` past the first non-empty string! -The solution to this problem is to use a buffered iterator. Class [BufferedIterator](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/BufferedIterator.html) is a subclass of [Iterator](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Iterator.html), which provides one extra method, `head`. Calling `head` on a buffered iterator will return its first element but will not advance the iterator. Using a buffered iterator, skipping empty words can be written as follows. +The solution to this problem is to use a buffered iterator. Class [BufferedIterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/BufferedIterator.html) is a subclass of [Iterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html), which provides one extra method, `head`. Calling `head` on a buffered iterator will return its first element but will not advance the iterator. Using a buffered iterator, skipping empty words can be written as follows. def skipEmptyWords(it: BufferedIterator[String]) = while (it.head.isEmpty) { it.next() } diff --git a/_overviews/collections-2.13/overview.md b/_overviews/collections-2.13/overview.md index 79cb856cc3..a96995b662 100644 --- a/_overviews/collections-2.13/overview.md +++ b/_overviews/collections-2.13/overview.md @@ -40,10 +40,10 @@ mutable collection means you need to understand which code changes which collection when. A collection in package `scala.collection` can be either mutable or -immutable. For instance, [collection.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/IndexedSeq.html) -is a superclass of both [collection.immutable.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/IndexedSeq.html) +immutable. For instance, [collection.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/IndexedSeq.html) +is a superclass of both [collection.immutable.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/IndexedSeq.html) and -[collection.mutable.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/IndexedSeq.html) +[collection.mutable.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/IndexedSeq.html) Generally, the root collections in package `scala.collection` support transformation operations affecting the whole collection, the immutable @@ -92,7 +92,7 @@ can be accessed alternatively as // is always automatically imported Other types aliased are -[Iterable](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Iterable.html), [Seq](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/Seq.html), [IndexedSeq](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/IndexedSeq.html), [Iterator](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Iterator.html), [LazyList](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/LazyList.html), [Vector](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/Vector.html), [StringBuilder](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/mutable/StringBuilder.html), and [Range](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/immutable/Range.html). +[Iterable](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterable.html), [Seq](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Seq.html), [IndexedSeq](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/IndexedSeq.html), [Iterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html), [LazyList](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/LazyList.html), [Vector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html), [StringBuilder](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/StringBuilder.html), and [Range](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html). The following figure shows all collections in package `scala.collection`. These are all high-level abstract classes or traits, which diff --git a/_overviews/collections-2.13/trait-iterable.md b/_overviews/collections-2.13/trait-iterable.md index 3ae2ecfb99..e306f39f16 100644 --- a/_overviews/collections-2.13/trait-iterable.md +++ b/_overviews/collections-2.13/trait-iterable.md @@ -64,7 +64,7 @@ Two more methods exist in `Iterable` that return iterators: `grouped` and `slidi | `xs grouped size` |An iterator that yields fixed-sized "chunks" of this collection.| | `xs sliding size` |An iterator that yields a sliding fixed-sized window of elements in this collection.| | **Addition:** | | -| `xs concat ys`
(or `xs ++ ys`) |A collection consisting of the elements of both `xs` and `ys`. `ys` is a [IterableOnce](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/IterableOnce.html) collection, i.e., either an [Iterable](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Iterable.html) or an [Iterator](http://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Iterator.html).| +| `xs concat ys`
(or `xs ++ ys`) |A collection consisting of the elements of both `xs` and `ys`. `ys` is a [IterableOnce](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/IterableOnce.html) collection, i.e., either an [Iterable](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterable.html) or an [Iterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html).| | **Maps:** | | | `xs map f` |The collection obtained from applying the function f to every element in `xs`.| | `xs flatMap f` |The collection obtained from applying the collection-valued function `f` to every element in `xs` and concatenating the results.| @@ -141,7 +141,7 @@ Two more methods exist in `Iterable` that return iterators: `grouped` and `slidi | **Views:** | | | `xs.view` |Produces a view over `xs`.| -In the inheritance hierarchy below `Iterable` you find three traits: [Seq](https://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Seq.html), [Set](https://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Set.html), and [Map](https://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/Map.html). `Seq` and `Map` implement the [PartialFunction](https://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/PartialFunction.html) trait with its `apply` and `isDefinedAt` methods, each implemented differently. `Set` gets its `apply` method from [SetOps](https://www.scala-lang.org/api/{{ site.scala-213-version }}/scala/collection/SetOps.html). +In the inheritance hierarchy below `Iterable` you find three traits: [Seq](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Seq.html), [Set](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Set.html), and [Map](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Map.html). `Seq` and `Map` implement the [PartialFunction](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/PartialFunction.html) trait with its `apply` and `isDefinedAt` methods, each implemented differently. `Set` gets its `apply` method from [SetOps](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/SetOps.html). For sequences, `apply` is positional indexing, where elements are always numbered from `0`. That is, `Seq(1, 2, 3)(1)` gives `2`. For sets, `apply` is a membership test. For instance, `Set('a', 'b', 'c')('b')` gives `true` whereas `Set()('a')` gives `false`. Finally for maps, `apply` is a selection. For instance, `Map('a' -> 1, 'b' -> 10, 'c' -> 100)('b')` gives `10`. diff --git a/_overviews/collections/arrays.md b/_overviews/collections/arrays.md index 512df5e432..343ebb1c74 100644 --- a/_overviews/collections/arrays.md +++ b/_overviews/collections/arrays.md @@ -13,7 +13,7 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- -[Array](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/Array.html) is a special kind of collection in Scala. On the one hand, Scala arrays correspond one-to-one to Java arrays. That is, a Scala array `Array[Int]` is represented as a Java `int[]`, an `Array[Double]` is represented as a Java `double[]` and a `Array[String]` is represented as a Java `String[]`. But at the same time, Scala arrays offer much more than their Java analogues. First, Scala arrays can be _generic_. That is, you can have an `Array[T]`, where `T` is a type parameter or abstract type. Second, Scala arrays are compatible with Scala sequences - you can pass an `Array[T]` where a `Seq[T]` is required. Finally, Scala arrays also support all sequence operations. Here's an example of this in action: +[Array](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/Array.html) is a special kind of collection in Scala. On the one hand, Scala arrays correspond one-to-one to Java arrays. That is, a Scala array `Array[Int]` is represented as a Java `int[]`, an `Array[Double]` is represented as a Java `double[]` and a `Array[String]` is represented as a Java `String[]`. But at the same time, Scala arrays offer much more than their Java analogues. First, Scala arrays can be _generic_. That is, you can have an `Array[T]`, where `T` is a type parameter or abstract type. Second, Scala arrays are compatible with Scala sequences - you can pass an `Array[T]` where a `Seq[T]` is required. Finally, Scala arrays also support all sequence operations. Here's an example of this in action: scala> val a1 = Array(1, 2, 3) a1: Array[Int] = Array(1, 2, 3) diff --git a/_overviews/collections/concrete-immutable-collection-classes.md b/_overviews/collections/concrete-immutable-collection-classes.md index 64bfb62655..b0e16eceb7 100644 --- a/_overviews/collections/concrete-immutable-collection-classes.md +++ b/_overviews/collections/concrete-immutable-collection-classes.md @@ -17,7 +17,7 @@ Scala provides many concrete immutable collection classes for you to choose from ## Lists -A [List](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/List.html) is a finite immutable sequence. They provide constant-time access to their first element as well as the rest of the list, and they have a constant-time cons operation for adding a new element to the front of the list. Many other operations take linear time. +A [List](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/List.html) is a finite immutable sequence. They provide constant-time access to their first element as well as the rest of the list, and they have a constant-time cons operation for adding a new element to the front of the list. Many other operations take linear time. Lists have always been the workhorse for Scala programming, so not much needs to be said about them here. The major change in 2.8 is that the `List` class together with its subclass `::` and its subobject `Nil` is now defined in package `scala.collection.immutable`, where it logically belongs. There are still aliases for `List`, `Nil`, and `::` in the `scala` package, so from a user perspective, lists can be accessed as before. @@ -25,7 +25,7 @@ Another change is that lists now integrate more closely into the collections fra ## Streams -A [Stream](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Stream.html) is like a list except that its elements are computed lazily. Because of this, a stream can be infinitely long. Only those elements requested are computed. Otherwise, streams have the same performance characteristics as lists. +A [Stream](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Stream.html) is like a list except that its elements are computed lazily. Because of this, a stream can be infinitely long. Only those elements requested are computed. Otherwise, streams have the same performance characteristics as lists. Whereas lists are constructed with the `::` operator, streams are constructed with the similar-looking `#::`. Here is a simple example of a stream containing the integers 1, 2, and 3: @@ -52,7 +52,7 @@ Here are the first few elements of the Fibonacci sequence starting with two ones Lists are very efficient when the algorithm processing them is careful to only process their heads. Accessing, adding, and removing the head of a list takes only constant time, whereas accessing or modifying elements later in the list takes time linear in the depth into the list. -[Vector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html) is a collection type (introduced in Scala 2.8) that addresses the inefficiency for random access on lists. Vectors allow accessing any element of the list in "effectively" constant time. It's a larger constant than for access to the head of a list or for reading an element of an array, but it's a constant nonetheless. As a result, algorithms using vectors do not have to be careful about accessing just the head of the sequence. They can access and modify elements at arbitrary locations, and thus they can be much more convenient to write. +[Vector](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html) is a collection type (introduced in Scala 2.8) that addresses the inefficiency for random access on lists. Vectors allow accessing any element of the list in "effectively" constant time. It's a larger constant than for access to the head of a list or for reading an element of an array, but it's a constant nonetheless. As a result, algorithms using vectors do not have to be careful about accessing just the head of the sequence. They can access and modify elements at arbitrary locations, and thus they can be much more convenient to write. Vectors are built and modified just like any other sequence. @@ -86,7 +86,7 @@ Because vectors strike a good balance between fast random selections and fast ra ## Immutable stacks -If you need a last-in-first-out sequence, you can use a [Stack](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Stack.html). You push an element onto a stack with `push`, pop an element with `pop`, and peek at the top of the stack without removing it with `top`. All of these operations are constant time. +If you need a last-in-first-out sequence, you can use a [Stack](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Stack.html). You push an element onto a stack with `push`, pop an element with `pop`, and peek at the top of the stack without removing it with `top`. All of these operations are constant time. Here are some simple operations performed on a stack: @@ -106,7 +106,7 @@ Immutable stacks are used rarely in Scala programs because their functionality i ## Immutable Queues -A [Queue](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Queue.html) is just like a stack except that it is first-in-first-out rather than last-in-first-out. +A [Queue](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Queue.html) is just like a stack except that it is first-in-first-out rather than last-in-first-out. Here's how you can create an empty immutable queue: @@ -134,7 +134,7 @@ Note that `dequeue` returns a pair consisting of the element removed and the res ## Ranges -A [Range](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html) is an ordered sequence of integers that are equally spaced apart. For example, "1, 2, 3," is a range, as is "5, 8, 11, 14." To create a range in Scala, use the predefined methods `to` and `by`. +A [Range](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html) is an ordered sequence of integers that are equally spaced apart. For example, "1, 2, 3," is a range, as is "5, 8, 11, 14." To create a range in Scala, use the predefined methods `to` and `by`. scala> 1 to 3 res2: scala.collection.immutable.Range.Inclusive = Range(1, 2, 3) @@ -150,7 +150,7 @@ Ranges are represented in constant space, because they can be defined by just th ## Hash Tries -Hash tries are a standard way to implement immutable sets and maps efficiently. They are supported by class [immutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/HashMap.html). Their representation is similar to vectors in that they are also trees where every node has 32 elements or 32 subtrees. But the selection of these keys is now done based on hash code. For instance, to find a given key in a map, one first takes the hash code of the key. Then, the lowest 5 bits of the hash code are used to select the first subtree, followed by the next 5 bits and so on. The selection stops once all elements stored in a node have hash codes that differ from each other in the bits that are selected up to this level. +Hash tries are a standard way to implement immutable sets and maps efficiently. They are supported by class [immutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/HashMap.html). Their representation is similar to vectors in that they are also trees where every node has 32 elements or 32 subtrees. But the selection of these keys is now done based on hash code. For instance, to find a given key in a map, one first takes the hash code of the key. Then, the lowest 5 bits of the hash code are used to select the first subtree, followed by the next 5 bits and so on. The selection stops once all elements stored in a node have hash codes that differ from each other in the bits that are selected up to this level. Hash tries strike a nice balance between reasonably fast lookups and reasonably efficient functional insertions (`+`) and deletions (`-`). That's why they underlie Scala's default implementations of immutable maps and sets. In fact, Scala has a further optimization for immutable sets and maps that contain less than five elements. Sets and maps with one to four elements are stored as single objects that just contain the elements (or key/value pairs in the case of a map) as fields. The empty immutable set and the empty immutable map is in each case a single object - there's no need to duplicate storage for those because an empty immutable set or map will always stay empty. @@ -158,7 +158,7 @@ Hash tries strike a nice balance between reasonably fast lookups and reasonably Red-black trees are a form of balanced binary tree where some nodes are designated "red" and others designated "black." Like any balanced binary tree, operations on them reliably complete in time logarithmic to the size of the tree. -Scala provides implementations of immutable sets and maps that use a red-black tree internally. Access them under the names [TreeSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/TreeSet.html) and [TreeMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/TreeMap.html). +Scala provides implementations of immutable sets and maps that use a red-black tree internally. Access them under the names [TreeSet](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/TreeSet.html) and [TreeMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/TreeMap.html). scala> scala.collection.immutable.TreeSet.empty[Int] @@ -170,7 +170,7 @@ Red-black trees are the standard implementation of `SortedSet` in Scala, because ## Immutable BitSets -A [BitSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/BitSet.html) represents a collection of small integers as the bits of a larger integer. For example, the bit set containing 3, 2, and 0 would be represented as the integer 1101 in binary, which is 13 in decimal. +A [BitSet](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/BitSet.html) represents a collection of small integers as the bits of a larger integer. For example, the bit set containing 3, 2, and 0 would be represented as the integer 1101 in binary, which is 13 in decimal. Internally, bit sets use an array of 64-bit `Long`s. The first `Long` in the array is for integers 0 through 63, the second is for 64 through 127, and so on. Thus, bit sets are very compact so long as the largest integer in the set is less than a few hundred or so. @@ -187,7 +187,7 @@ Operations on bit sets are very fast. Testing for inclusion takes constant time. ## List Maps -A [ListMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/ListMap.html) represents a map as a linked list of key-value pairs. In general, operations on a list map might have to iterate through the entire list. Thus, operations on a list map take time linear in the size of the map. In fact there is little usage for list maps in Scala because standard immutable maps are almost always faster. The only possible exception to this is if the map is for some reason constructed in such a way that the first elements in the list are selected much more often than the other elements. +A [ListMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/ListMap.html) represents a map as a linked list of key-value pairs. In general, operations on a list map might have to iterate through the entire list. Thus, operations on a list map take time linear in the size of the map. In fact there is little usage for list maps in Scala because standard immutable maps are almost always faster. The only possible exception to this is if the map is for some reason constructed in such a way that the first elements in the list are selected much more often than the other elements. scala> val map = scala.collection.immutable.ListMap(1->"one", 2->"two") map: scala.collection.immutable.ListMap[Int,java.lang.String] = diff --git a/_overviews/collections/concrete-mutable-collection-classes.md b/_overviews/collections/concrete-mutable-collection-classes.md index f229dc818d..432eb6df9f 100644 --- a/_overviews/collections/concrete-mutable-collection-classes.md +++ b/_overviews/collections/concrete-mutable-collection-classes.md @@ -17,7 +17,7 @@ You've now seen the most commonly used immutable collection classes that Scala p ## Array Buffers -An [ArrayBuffer](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayBuffer.html) buffer holds an array and a size. Most operations on an array buffer have the same speed as for an array, because the operations simply access and modify the underlying array. Additionally, array buffers can have data efficiently added to the end. Appending an item to an array buffer takes amortized constant time. Thus, array buffers are useful for efficiently building up a large collection whenever the new items are always added to the end. +An [ArrayBuffer](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ArrayBuffer.html) buffer holds an array and a size. Most operations on an array buffer have the same speed as for an array, because the operations simply access and modify the underlying array. Additionally, array buffers can have data efficiently added to the end. Appending an item to an array buffer takes amortized constant time. Thus, array buffers are useful for efficiently building up a large collection whenever the new items are always added to the end. scala> val buf = scala.collection.mutable.ArrayBuffer.empty[Int] buf: scala.collection.mutable.ArrayBuffer[Int] = ArrayBuffer() @@ -30,7 +30,7 @@ An [ArrayBuffer](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/co ## List Buffers -A [ListBuffer](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ListBuffer.html) is like an array buffer except that it uses a linked list internally instead of an array. If you plan to convert the buffer to a list once it is built up, use a list buffer instead of an array buffer. +A [ListBuffer](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ListBuffer.html) is like an array buffer except that it uses a linked list internally instead of an array. If you plan to convert the buffer to a list once it is built up, use a list buffer instead of an array buffer. scala> val buf = scala.collection.mutable.ListBuffer.empty[Int] buf: scala.collection.mutable.ListBuffer[Int] = ListBuffer() @@ -43,7 +43,7 @@ A [ListBuffer](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/coll ## StringBuilders -Just like an array buffer is useful for building arrays, and a list buffer is useful for building lists, a [StringBuilder](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/StringBuilder.html) is useful for building strings. String builders are so commonly used that they are already imported into the default namespace. Create them with a simple `new StringBuilder`, like this: +Just like an array buffer is useful for building arrays, and a list buffer is useful for building lists, a [StringBuilder](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/StringBuilder.html) is useful for building strings. String builders are so commonly used that they are already imported into the default namespace. Create them with a simple `new StringBuilder`, like this: scala> val buf = new StringBuilder buf: StringBuilder = @@ -56,15 +56,15 @@ Just like an array buffer is useful for building arrays, and a list buffer is us ## Linked Lists -Linked lists are mutable sequences that consist of nodes which are linked with next pointers. They are supported by class [LinkedList](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/LinkedList.html). In most languages `null` would be picked as the empty linked list. That does not work for Scala collections, because even empty sequences must support all sequence methods. In particular `LinkedList.empty.isEmpty` should return `true` and not throw a `NullPointerException`. Empty linked lists are encoded instead in a special way: Their `next` field points back to the node itself. Like their immutable cousins, linked lists are best traversed sequentially. In addition linked lists make it easy to insert an element or linked list into another linked list. +Linked lists are mutable sequences that consist of nodes which are linked with next pointers. They are supported by class [LinkedList](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/LinkedList.html). In most languages `null` would be picked as the empty linked list. That does not work for Scala collections, because even empty sequences must support all sequence methods. In particular `LinkedList.empty.isEmpty` should return `true` and not throw a `NullPointerException`. Empty linked lists are encoded instead in a special way: Their `next` field points back to the node itself. Like their immutable cousins, linked lists are best traversed sequentially. In addition linked lists make it easy to insert an element or linked list into another linked list. ## Double Linked Lists -Double linked lists are like single linked lists, except that they have besides `next` another mutable field `prev` that points to the element preceding the current node. The main benefit of that additional link is that it makes element removal very fast. Double linked lists are supported by class [DoubleLinkedList](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/DoubleLinkedList.html). +Double linked lists are like single linked lists, except that they have besides `next` another mutable field `prev` that points to the element preceding the current node. The main benefit of that additional link is that it makes element removal very fast. Double linked lists are supported by class [DoubleLinkedList](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/DoubleLinkedList.html). ## Mutable Lists -A [MutableList](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/MutableList.html) consists of a single linked list together with a pointer that refers to the terminal empty node of that list. This makes list append a constant time operation because it avoids having to traverse the list in search for its terminal node. [MutableList](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/MutableList.html) is currently the standard implementation of [mutable.LinearSeq](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/LinearSeq.html) in Scala. +A [MutableList](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/MutableList.html) consists of a single linked list together with a pointer that refers to the terminal empty node of that list. This makes list append a constant time operation because it avoids having to traverse the list in search for its terminal node. [MutableList](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/MutableList.html) is currently the standard implementation of [mutable.LinearSeq](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/LinearSeq.html) in Scala. ## Queues @@ -85,13 +85,13 @@ Scala provides mutable queues in addition to immutable ones. You use a `mQueue` ## Array Sequences -Array sequences are mutable sequences of fixed size which store their elements internally in an `Array[Object]`. They are implemented in Scala by class [ArraySeq](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArraySeq.html). +Array sequences are mutable sequences of fixed size which store their elements internally in an `Array[Object]`. They are implemented in Scala by class [ArraySeq](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ArraySeq.html). You would typically use an `ArraySeq` if you want an array for its performance characteristics, but you also want to create generic instances of the sequence where you do not know the type of the elements and you do not have a `ClassTag` to provide it at run-time. These issues are explained in the section on [arrays]({{ site.baseurl }}/overviews/collections/arrays.html). ## Stacks -You saw immutable stacks earlier. There is also a mutable version, supported by class [mutable.Stack](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/Stack.html). It works exactly the same as the immutable version except that modifications happen in place. +You saw immutable stacks earlier. There is also a mutable version, supported by class [mutable.Stack](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/Stack.html). It works exactly the same as the immutable version except that modifications happen in place. scala> val stack = new scala.collection.mutable.Stack[Int] stack: scala.collection.mutable.Stack[Int] = Stack() @@ -114,11 +114,11 @@ You saw immutable stacks earlier. There is also a mutable version, supported by ## Array Stacks -[ArrayStack](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayStack.html) is an alternative implementation of a mutable stack which is backed by an Array that gets re-sized as needed. It provides fast indexing and is generally slightly more efficient for most operations than a normal mutable stack. +[ArrayStack](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ArrayStack.html) is an alternative implementation of a mutable stack which is backed by an Array that gets re-sized as needed. It provides fast indexing and is generally slightly more efficient for most operations than a normal mutable stack. ## Hash Tables -A hash table stores its elements in an underlying array, placing each item at a position in the array determined by the hash code of that item. Adding an element to a hash table takes only constant time, so long as there isn't already another element in the array that has the same hash code. Hash tables are thus very fast so long as the objects placed in them have a good distribution of hash codes. As a result, the default mutable map and set types in Scala are based on hash tables. You can access them also directly under the names [mutable.HashSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/HashSet.html) and [mutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/HashMap.html). +A hash table stores its elements in an underlying array, placing each item at a position in the array determined by the hash code of that item. Adding an element to a hash table takes only constant time, so long as there isn't already another element in the array that has the same hash code. Hash tables are thus very fast so long as the objects placed in them have a good distribution of hash codes. As a result, the default mutable map and set types in Scala are based on hash tables. You can access them also directly under the names [mutable.HashSet](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/HashSet.html) and [mutable.HashMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/HashMap.html). Hash sets and maps are used just like any other set or map. Here are some simple examples: @@ -137,11 +137,11 @@ Iteration over a hash table is not guaranteed to occur in any particular order. ## Weak Hash Maps -A weak hash map is a special kind of hash map where the garbage collector does not follow links from the map to the keys stored in it. This means that a key and its associated value will disappear from the map if there is no other reference to that key. Weak hash maps are useful for tasks such as caching, where you want to re-use an expensive function's result if the function is called again on the same key. If keys and function results are stored in a regular hash map, the map could grow without bounds, and no key would ever become garbage. Using a weak hash map avoids this problem. As soon as a key object becomes unreachable, it's entry is removed from the weak hashmap. Weak hash maps in Scala are implemented by class [WeakHashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/WeakHashMap.html) as a wrapper of an underlying Java implementation `java.util.WeakHashMap`. +A weak hash map is a special kind of hash map where the garbage collector does not follow links from the map to the keys stored in it. This means that a key and its associated value will disappear from the map if there is no other reference to that key. Weak hash maps are useful for tasks such as caching, where you want to re-use an expensive function's result if the function is called again on the same key. If keys and function results are stored in a regular hash map, the map could grow without bounds, and no key would ever become garbage. Using a weak hash map avoids this problem. As soon as a key object becomes unreachable, it's entry is removed from the weak hashmap. Weak hash maps in Scala are implemented by class [WeakHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/WeakHashMap.html) as a wrapper of an underlying Java implementation `java.util.WeakHashMap`. ## Concurrent Maps -A concurrent map can be accessed by several threads at once. In addition to the usual [Map](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Map.html) operations, it provides the following atomic operations: +A concurrent map can be accessed by several threads at once. In addition to the usual [Map](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Map.html) operations, it provides the following atomic operations: ### Operations in class ConcurrentMap @@ -156,7 +156,7 @@ A concurrent map can be accessed by several threads at once. In addition to the ## Mutable Bitsets -A mutable bit of type [mutable.BitSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/BitSet.html) set is just like an immutable one, except that it is modified in place. Mutable bit sets are slightly more efficient at updating than immutable ones, because they don't have to copy around `Long`s that haven't changed. +A mutable bit of type [mutable.BitSet](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/BitSet.html) set is just like an immutable one, except that it is modified in place. Mutable bit sets are slightly more efficient at updating than immutable ones, because they don't have to copy around `Long`s that haven't changed. scala> val bits = scala.collection.mutable.BitSet.empty bits: scala.collection.mutable.BitSet = BitSet() diff --git a/_overviews/collections/conversions-between-java-and-scala-collections.md b/_overviews/collections/conversions-between-java-and-scala-collections.md index c476d4369c..7d1f3d150a 100644 --- a/_overviews/collections/conversions-between-java-and-scala-collections.md +++ b/_overviews/collections/conversions-between-java-and-scala-collections.md @@ -15,7 +15,7 @@ permalink: /overviews/collections/:title.html Like Scala, Java also has a rich collections library. There are many similarities between the two. For instance, both libraries know iterators, iterables, sets, maps, and sequences. But there are also important differences. In particular, the Scala libraries put much more emphasis on immutable collections, and provide many more operations that transform a collection into a new one. -Sometimes you might need to pass from one collection framework to the other. For instance, you might want to access an existing Java collection as if it were a Scala collection. Or you might want to pass one of Scala's collections to a Java method that expects its Java counterpart. It is quite easy to do this, because Scala offers implicit conversions between all the major collection types in the [JavaConverters](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/JavaConverters$.html) object. In particular, you will find bidirectional conversions between the following types. +Sometimes you might need to pass from one collection framework to the other. For instance, you might want to access an existing Java collection as if it were a Scala collection. Or you might want to pass one of Scala's collections to a Java method that expects its Java counterpart. It is quite easy to do this, because Scala offers implicit conversions between all the major collection types in the [JavaConverters](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/JavaConverters$.html) object. In particular, you will find bidirectional conversions between the following types. Iterator <=> java.util.Iterator @@ -27,7 +27,7 @@ Sometimes you might need to pass from one collection framework to the other. For mutable.Map <=> java.util.Map mutable.ConcurrentMap <=> java.util.concurrent.ConcurrentMap -To enable these conversions, simply import them from the [JavaConverters](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/JavaConverters$.html) object: +To enable these conversions, simply import them from the [JavaConverters](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/JavaConverters$.html) object: scala> import collection.JavaConverters._ import collection.JavaConverters._ diff --git a/_overviews/collections/iterators.md b/_overviews/collections/iterators.md index e771513c0c..975824d498 100644 --- a/_overviews/collections/iterators.md +++ b/_overviews/collections/iterators.md @@ -13,7 +13,7 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- -An iterator is not a collection, but rather a way to access the elements of a collection one by one. The two basic operations on an iterator `it` are `next` and `hasNext`. A call to `it.next()` will return the next element of the iterator and advance the state of the iterator. Calling `next` again on the same iterator will then yield the element one beyond the one returned previously. If there are no more elements to return, a call to `next` will throw a `NoSuchElementException`. You can find out whether there are more elements to return using [Iterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html)'s `hasNext` method. +An iterator is not a collection, but rather a way to access the elements of a collection one by one. The two basic operations on an iterator `it` are `next` and `hasNext`. A call to `it.next()` will return the next element of the iterator and advance the state of the iterator. Calling `next` again on the same iterator will then yield the element one beyond the one returned previously. If there are no more elements to return, a call to `next` will throw a `NoSuchElementException`. You can find out whether there are more elements to return using [Iterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html)'s `hasNext` method. The most straightforward way to "step through" all the elements returned by an iterator `it` uses a while-loop: @@ -76,7 +76,7 @@ destructively modified by invoking arbitrary methods. This creates the illusion the elements twice, but the effect is achieved through internal buffering. As usual, the underlying iterator `it` cannot be used directly and must be discarded. -In summary, iterators behave like collections _if one never accesses an iterator again after invoking a method on it_. The Scala collection libraries make this explicit with an abstraction [TraversableOnce](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/TraversableOnce.html), which is a common superclass of [Traversable](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Traversable.html) and [Iterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html). As the name implies, `TraversableOnce` objects can be traversed using `foreach` but the state of that object after the traversal is not specified. If the `TraversableOnce` object is in fact an `Iterator`, it will be at its end after the traversal, but if it is a `Traversable`, it will still exist as before. A common use case of `TraversableOnce` is as an argument type for methods that can take either an iterator or a traversable as argument. An example is the appending method `++` in class `Traversable`. It takes a `TraversableOnce` parameter, so you can append elements coming from either an iterator or a traversable collection. +In summary, iterators behave like collections _if one never accesses an iterator again after invoking a method on it_. The Scala collection libraries make this explicit with an abstraction [TraversableOnce](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/TraversableOnce.html), which is a common superclass of [Traversable](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Traversable.html) and [Iterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html). As the name implies, `TraversableOnce` objects can be traversed using `foreach` but the state of that object after the traversal is not specified. If the `TraversableOnce` object is in fact an `Iterator`, it will be at its end after the traversal, but if it is a `Traversable`, it will still exist as before. A common use case of `TraversableOnce` is as an argument type for methods that can take either an iterator or a traversable as argument. An example is the appending method `++` in class `Traversable`. It takes a `TraversableOnce` parameter, so you can append elements coming from either an iterator or a traversable collection. All operations on iterators are summarized below. @@ -186,7 +186,7 @@ Sometimes you want an iterator that can "look ahead", so that you can inspect th But looking at this code more closely, it's clear that this is wrong: The code will indeed skip leading empty strings, but it will also advance `it` past the first non-empty string! -The solution to this problem is to use a buffered iterator. Class [BufferedIterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/BufferedIterator.html) is a subclass of [Iterator](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html), which provides one extra method, `head`. Calling `head` on a buffered iterator will return its first element but will not advance the iterator. Using a buffered iterator, skipping empty words can be written as follows. +The solution to this problem is to use a buffered iterator. Class [BufferedIterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/BufferedIterator.html) is a subclass of [Iterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html), which provides one extra method, `head`. Calling `head` on a buffered iterator will return its first element but will not advance the iterator. Using a buffered iterator, skipping empty words can be written as follows. def skipEmptyWords(it: BufferedIterator[String]) = while (it.head.isEmpty) { it.next() } diff --git a/_overviews/parallel-collections/concrete-parallel-collections.md b/_overviews/parallel-collections/concrete-parallel-collections.md index d171a4968a..3c82e34930 100644 --- a/_overviews/parallel-collections/concrete-parallel-collections.md +++ b/_overviews/parallel-collections/concrete-parallel-collections.md @@ -15,7 +15,7 @@ permalink: /overviews/parallel-collections/:title.html ## Parallel Array -A [ParArray](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/mutable/ParArray.html) +A [ParArray](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/mutable/ParArray.html) sequence holds a linear, contiguous array of elements. This means that the elements can be accessed and updated efficiently by modifying the underlying array. Traversing the @@ -54,7 +54,7 @@ parallel array it was obtained from. ## Parallel Vector -A [ParVector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParVector.html) +A [ParVector](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParVector.html) is an immutable sequence with a low-constant factor logarithmic access and update time. @@ -76,16 +76,16 @@ combiners will be combined using concatenation and transformer methods will become much more efficient. Parallel vector is a parallel counterpart of the sequential -[Vector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html), +[Vector](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html), so conversion between the two takes constant time. ## Parallel Range -A [ParRange](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParRange.html) +A [ParRange](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParRange.html) is an ordered sequence of elements equally spaced apart. A parallel range is created in a similar way as the sequential -[Range](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html): +[Range](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html): scala> 1 to 3 par res0: scala.collection.parallel.immutable.ParRange = ParRange(1, 2, 3) @@ -105,9 +105,9 @@ another using the `seq` and `par` methods. Parallel hash tables store their elements in an underlying array and place them in the position determined by the hash code of the respective element. Parallel mutable hash sets -([mutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/mutable/ParHashSet.html)) +([mutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/mutable/ParHashSet.html)) and parallel mutable hash maps -([mutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/mutable/ParHashMap.html)) +([mutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/mutable/ParHashMap.html)) are based on hash tables. scala> val phs = scala.collection.parallel.mutable.ParHashSet(1 until 2000: _*) @@ -142,9 +142,9 @@ versa. Parallel hash tries are a parallel counterpart of the immutable hash tries, which are used to represent immutable sets and maps efficiently. They are supported by classes -[immutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParHashSet.html) +[immutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParHashSet.html) and -[immutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/immutable/ParHashMap.html). +[immutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/immutable/ParHashMap.html). scala> val phs = scala.collection.parallel.immutable.ParHashSet(1 until 1000: _*) phs: scala.collection.parallel.immutable.ParHashSet[Int] = ParSet(645, 892, 69, 809, 629, 365, 138, 760, 101, 479,... @@ -165,9 +165,9 @@ by using the `seq` and `par` method in constant time. ## Parallel Concurrent Tries -A [concurrent.TrieMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html) +A [concurrent.TrieMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/concurrent/TrieMap.html) is a concurrent thread-safe map, whereas a -[mutable.ParTrieMap](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/mutable/ParTrieMap.html) +[mutable.ParTrieMap](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/mutable/ParTrieMap.html) is its parallel counterpart. While most concurrent data structures do not guarantee consistent traversal if the data structure is modified during traversal, Ctries guarantee that updates are only visible in the next iteration. This diff --git a/api/all.md b/api/all.md index 77ecd28618..7c655d88d0 100644 --- a/api/all.md +++ b/api/all.md @@ -6,6 +6,10 @@ includeTOC: true ## Latest releases +* Scala 2.13.0 + * [Library API](https://www.scala-lang.org/api/2.13.0/) + * [Compiler API](https://www.scala-lang.org/api/2.13.0/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.0/scala-reflect/scala/reflect/) * Scala 2.12.8 * [Library API](https://www.scala-lang.org/api/2.12.8/) * [Compiler API](https://www.scala-lang.org/api/2.12.8/scala-compiler/scala/) @@ -26,12 +30,14 @@ includeTOC: true * [Continuations API](https://www.scala-lang.org/files/archive/api/2.11.12/scala-continuations-library/#scala.util.continuations.package) * [Scala 2.10.7](https://www.scala-lang.org/api/2.10.7/) + ## Nightly builds From 7a3d45dd1ab648313aba06fe3b5ec5bbaed74f07 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Wed, 12 Jun 2019 08:35:59 +0800 Subject: [PATCH 0510/3075] Fix#1368, fill a word for the syntax correctness. --- glossary/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary/index.md b/glossary/index.md index 1d4e421eea..472b2ebe3b 100644 --- a/glossary/index.md +++ b/glossary/index.md @@ -267,7 +267,7 @@ A property of functions that are independent of temporal context and have no sid A variable in a running Scala program always _refers_ to some object. Even if that variable is assigned to `null`, it conceptually refers to the `Null` object. At runtime, an object may be implemented by a Java object or a value of a primitive type, but Scala allows programmers to think at a higher level of abstraction about their code as they imagine it running. See also [reference](#reference). * #### refinement type -A type formed by supplying a base type a number of members inside curly braces. The members in the curly braces refine the types that are present in the base type. For example, the type of “animal that eats grass” is `Animal { type SuitableFood = Grass }`. +A type formed by supplying a base type with a number of members inside curly braces. The members in the curly braces refine the types that are present in the base type. For example, the type of “animal that eats grass” is `Animal { type SuitableFood = Grass }`. * #### result An expression in a Scala program yields a _result_. The result of every expression in Scala is an object. From 967cf14521537b389cfa449d17913c13ea74524c Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Wed, 12 Jun 2019 08:44:57 +0800 Subject: [PATCH 0511/3075] Fix#1369, replace quote with italic underbars enclosing to make the term consistent with other terms. --- glossary/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary/index.md b/glossary/index.md index 1d4e421eea..6a36a9b3b5 100644 --- a/glossary/index.md +++ b/glossary/index.md @@ -276,7 +276,7 @@ An expression in a Scala program yields a _result_. The result of every expressi A method’s _result type_ is the type of the value that results from calling the method. (In Java, this concept is called the return type.) * #### return -A function in a Scala program `returns` a value. You can call this value the [result](#result) of the function. You can also say the function _results in_ the value. The result of every function in Scala is an object. +A function in a Scala program _returns_ a value. You can call this value the [result](#result) of the function. You can also say the function _results in_ the value. The result of every function in Scala is an object. * #### runtime The Java Virtual Machine, or [JVM](#jvm), that hosts a running Scala program. Runtime encompasses both the virtual machine, as defined by the Java Virtual Machine Specification, and the runtime libraries of the Java API and the standard Scala API. The phrase at run time (with a space between run and time) means when the program is running, and contrasts with compile time. From 7eb53d367d14abab588135ab4da159833e15ad85 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Wed, 12 Jun 2019 09:20:49 +0800 Subject: [PATCH 0512/3075] Fix issue#1372, add the lost right of parentheses. --- glossary/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary/index.md b/glossary/index.md index 1d4e421eea..7cb6cdb063 100644 --- a/glossary/index.md +++ b/glossary/index.md @@ -291,7 +291,7 @@ A file containing top level definitions and statements, which can be run directl The value being matched on in a `match` expression. For example, in “`s match { case _ => }`”, the selector is `s`. * #### self type -A _self type_ of a trait is the assumed type of `this`, the receiver, to be used within the trait. Any concrete class that mixes in the trait must ensure that its type conforms to the trait’s self type. The most common use of self types is for dividing a large class into several traits (as described in Chapter 29 of [Programming in Scala](http://www.artima.com/shop/programming_in_scala). +A _self type_ of a trait is the assumed type of `this`, the receiver, to be used within the trait. Any concrete class that mixes in the trait must ensure that its type conforms to the trait’s self type. The most common use of self types is for dividing a large class into several traits (as described in Chapter 29 of [Programming in Scala](http://www.artima.com/shop/programming_in_scala)). * #### semi-structured data XML data is semi-structured. It is more structured than a flat binary file or text file, but it does not have the full structure of a programming language’s data structures. From 556c843c21b04034e1a3fba578b4e57707b81716 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Wed, 12 Jun 2019 14:49:35 +0800 Subject: [PATCH 0513/3075] Fix issue#1374, remove bar and space between word 'between'. --- glossary/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary/index.md b/glossary/index.md index 1d4e421eea..165accc0db 100644 --- a/glossary/index.md +++ b/glossary/index.md @@ -381,7 +381,7 @@ See [unreachable](#unreachable). The result of any computation or expression in Scala is a _value_, and in Scala, every value is an object. The term value essentially means the image of an object in memory (on the JVM’s heap or stack). * #### value type -A _value type_ is any subclass of `AnyVal`, such as `Int`, `Double`, or `Unit`. This term has meaning at the level of Scala source code. At runtime, instances of value types that correspond to Java primitive types may be implemented in terms of primitive type values or instances of wrapper types, such as `java.lang.Integer`. Over the lifetime of a value type instance, the runtime may transform it back and forth be- tween primitive and wrapper types (_i.e._, to box and unbox it). +A _value type_ is any subclass of `AnyVal`, such as `Int`, `Double`, or `Unit`. This term has meaning at the level of Scala source code. At runtime, instances of value types that correspond to Java primitive types may be implemented in terms of primitive type values or instances of wrapper types, such as `java.lang.Integer`. Over the lifetime of a value type instance, the runtime may transform it back and forth between primitive and wrapper types (_i.e._, to box and unbox it). * #### variable A named entity that refers to an object. A variable is either a `val` or a `var`. Both `val`s and `var`s must be initialized when defined, but only `var`s can be later reassigned to refer to a different object. From 9ff917defe6b08e378fcf973448500b6488c66d3 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Wed, 12 Jun 2019 15:29:48 +0800 Subject: [PATCH 0514/3075] Fix issue#1376, replace in with of for 'at that point of time' --- glossary/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glossary/index.md b/glossary/index.md index 1d4e421eea..d0b9f78cba 100644 --- a/glossary/index.md +++ b/glossary/index.md @@ -372,7 +372,7 @@ A method’s _type signature_ comprises its name, the number, order, and types o The _uniform access principle_ states that variables and parameterless functions should be accessed using the same syntax. Scala supports this principle by not allowing parentheses to be placed at call sites of parameterless functions. As a result, a parameterless function definition can be changed to a `val`, or _vice versa_, without affecting client code. * #### unreachable -At the Scala level, objects can become _unreachable_, at which point the memory they occupy may be reclaimed by the runtime. Unreachable does not necessarily mean unreferenced. Reference types (instances of `AnyRef`) are implemented as objects that reside on the JVM’s heap. When an instance of a reference type becomes unreachable, it indeed becomes unreferenced, and is available for garbage collection. Value types (instances of `AnyVal`) are implemented as both primitive type values and as instances of Java wrapper types (such as `java.lang.Integer`), which reside on the heap. Value type instances can be boxed (converted from a primitive value to a wrapper object) and unboxed (converted from a wrapper object to a primitive value) throughout the lifetime of the variables that refer to them. If a value type instance currently represented as a wrapper object on the JVM’s heap becomes unreachable, it indeed becomes unreferenced, and is available for garbage collection. But if a value type currently represented as a primitive value becomes unreachable, then it does not become unreferenced, because it does not exist as an object on the JVM’s heap at that point in time. The runtime may reclaim memory occupied by unreachable objects, but if an Int, for example, is implemented at run time by a primitive Java int that occupies some memory in the stack frame of an executing method, then the memory for that object is “reclaimed” when the stack frame is popped as the method completes. Memory for reference types, such as `Strings`, may be reclaimed by the JVM’s garbage collector after they become unreachable. +At the Scala level, objects can become _unreachable_, at which point the memory they occupy may be reclaimed by the runtime. Unreachable does not necessarily mean unreferenced. Reference types (instances of `AnyRef`) are implemented as objects that reside on the JVM’s heap. When an instance of a reference type becomes unreachable, it indeed becomes unreferenced, and is available for garbage collection. Value types (instances of `AnyVal`) are implemented as both primitive type values and as instances of Java wrapper types (such as `java.lang.Integer`), which reside on the heap. Value type instances can be boxed (converted from a primitive value to a wrapper object) and unboxed (converted from a wrapper object to a primitive value) throughout the lifetime of the variables that refer to them. If a value type instance currently represented as a wrapper object on the JVM’s heap becomes unreachable, it indeed becomes unreferenced, and is available for garbage collection. But if a value type currently represented as a primitive value becomes unreachable, then it does not become unreferenced, because it does not exist as an object on the JVM’s heap at that point of time. The runtime may reclaim memory occupied by unreachable objects, but if an Int, for example, is implemented at run time by a primitive Java int that occupies some memory in the stack frame of an executing method, then the memory for that object is “reclaimed” when the stack frame is popped as the method completes. Memory for reference types, such as `Strings`, may be reclaimed by the JVM’s garbage collector after they become unreachable. * #### unreferenced See [unreachable](#unreachable). From c9cfb6e93ee0070f80c61f03eb2d5fd469bc97db Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Wed, 12 Jun 2019 16:19:14 +0800 Subject: [PATCH 0515/3075] This is to add the skeleton of translatable glossary, and the fix of zh-cn for issue#1224. --- _config.yml | 3 + {glossary => _glossary}/index.md | 2 + _layouts/glossary.html | 22 +- _zh-cn/glossary/index.md | 397 +++++++++++++++++++++++++++++++ 4 files changed, 423 insertions(+), 1 deletion(-) rename {glossary => _glossary}/index.md (99%) create mode 100644 _zh-cn/glossary/index.md diff --git a/_config.yml b/_config.yml index e7564efd1a..320c7a9839 100644 --- a/_config.yml +++ b/_config.yml @@ -29,6 +29,9 @@ collections: tutorials: output: true permalink: /:collection/:path.html + glossary: + output: true + permalink: /:collection/:path.html sips: output: true permalink: /:collection/:path.html diff --git a/glossary/index.md b/_glossary/index.md similarity index 99% rename from glossary/index.md rename to _glossary/index.md index 1d4e421eea..95ef0df59f 100644 --- a/glossary/index.md +++ b/_glossary/index.md @@ -1,6 +1,8 @@ --- layout: glossary title: Glossary + +languages: [zh-cn] ---
Glossary from the definitive book on Scala, Programming in Scala.
diff --git a/_layouts/glossary.html b/_layouts/glossary.html index 62b50b0a39..59a14bf8f9 100644 --- a/_layouts/glossary.html +++ b/_layouts/glossary.html @@ -10,7 +10,27 @@
{{content}}
- + {% if page.languages %} + + {% elsif page.language %} + {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} + {% assign engPg = site.glossary | first %} + + {% endif %} {% include contributors-list.html %}
diff --git a/_zh-cn/glossary/index.md b/_zh-cn/glossary/index.md new file mode 100644 index 0000000000..bc7aff3156 --- /dev/null +++ b/_zh-cn/glossary/index.md @@ -0,0 +1,397 @@ +--- +layout: glossary +title: Glossary + +language: zh-cn +--- + +
该术语表摘自Scala权威书籍《Programming in Scala》
+ +
+
+ +
+ + +   +
+ +* #### 代数数据类型（algebraic data type） +通过提供若干个带有独立构造器的备选项来定义的类型。它一般通过模式匹配的方式来结构类型，在规约语言和函数式编程语言中常见到这个概念。Scala可通过案例类来模拟代数数据类型。 + +* #### 备选项（alternative） +match表达式的一个分支，形如 “`case` _pattern_ => _expression_”。备选项的别名是 _案例_（_case_）。 + +* #### 注解（annotation） +注解一般出现在源码中，并附加到语法的某个部分。注解对于计算机来说都是可处理的，所以可以用来有效的增加Scala扩展。 + +* #### 匿名类（anonymous class） +匿名类是由Scala编译器根据一种new表达式生成的合成子类，这种new表达式由类名或特质名后面紧跟一对花括号组成。花括号内包含了匿名子类的构造体，可为空，不过一旦跟在new后面名称指向的特质或类包含了抽象成员，则这些抽象成员就必须在其匿名子类的构造体内具化，即在花括号内要实现这些成员。 + +* #### 匿名函数（anonymous function） +[函数字面量](#function-literal)的另一种叫法。 + +* #### 应用（apply） +方法、函数或闭包应用于参数，意思是说通过这些实参来调用方法、函数或闭包。 + +* #### 实参（argument） +在函数调用过程中实参被传给函数的各个参数，其中参数就是指向实参的变量，实参则是调用发生时被传入的对象。另外，应用程序都可以获取被传入单例对象的main方法且类型为`Array[String]`的实参（来自命令行）。 + +* #### 赋值（assign） +可把对象赋值给变量，之后，变量就会指向对象。 + +* #### 辅助构造器（auxiliary constructor） +在类定义体花括号里面定义的所有附加构造器，其形似名为`this`但无结果类型的方法定义。 + +* #### 块（block） +被花括号围起来的一个或多个表达式和声明。求值块的时候，块内所有表达式和声明会被顺序处理，然后会返回最后一个表达式的值作为其自身的值。块通常被用来作为构造体，诸如函数、[for表达式](#for-expression)、`while`循环以及其他任何需要把语句组织到一起的地方，都会用到块。更正式点说，块是一个只其副作用和结果值对外可见的封装构造体。因此，类或对象的花括号是不会形成块的，因其内部定义字段和方法均对外可见。这样的花括号形成的是模板。 + +* #### 绑定变量（bound variable） +表达式的绑定变量是定义和使用都在表达式内部的变量。例如，在函数字面量表达式`(x: Int) => (x, y)`里面，`x`和`y`都被用到了，但只有`x`被绑定了，因为它在表达式中被定义为一个`Int`变量，并且它也是表达式所描述函数的唯一实参。 + +* #### 传名参数（by-name parameter） +参数类型前面带有`=>`的参数，如`(x: => Int)`。传名参数对应的实参求值不在方法被调用前，而是在每次方法通过名称引用到参数的时候。参数若不是传名的，则定是传值的。 + +* #### 传值参数（by-value parameter） +参数类型前面不带`=>`的参数，如`(x: Int)`。传值参数对应的实参是在方法调用前被求值的。传值参数是相对传名参数而言的。 + +* #### 类（class） +通过关键字`class`来定义的类，可抽象可具体，且在实例化时可用类型和值对其进行参数化处理。比如`new Array[String](2)`，被实例化的类是`Array`，产生的值类型为`Array[String]`。带有类型参数的类被称为 _类型构造器_ ，也可说成是类型具有类属性，如：类型`Array[String]`具有的类属性是`Array`。 + +* #### 闭包（closure） +可以捕获自由变量，或者说"关闭"函数创建时可见变量的函数对象。 + +* #### 伴生类（companion class） +和定义在相同源文件中的单例对象共享同一个名称的类，这样的类就叫做那个单例对象的伴生类。 + +* #### 伴生对象（companion object） +和定义在相同源文件中的类共享同一个名称的单例对象。伴生对象和伴生类具备访问彼此私有成员的能力。另外，类不管被用在何处，其伴生对象中定义的任何隐式转换都在其作用域内。 + +* #### 逆变（contravariant） +逆变标注可应用于类或特质的类型参数上，把减号（-）置于类型参数前即可。标注为逆变后类或特质的子类型将逆向（向相反的方向）协变于类型标注的参数。比如，`Function1`的第一个类型参数就是逆变的，所以`Function1[Any, Any]`是`Function1[String, Any]`的子类。 + +* #### 协变（covariant） +协变标注可应用于类或特质的类型参数上，把加号（+）置于类型参数前即可。标注为协变后类或特质的子类型将正向（向相同的方向）协变于类型标注的参数。比如，`List`的类型参数是协变的，所以`List[String]`是`List[Any]`的子类。 + +* #### 柯里化（currying） +把函数写成多个参数列表的方式。例如：`def f(x: Int)(y: Int)`是一个带有两个参数列表的柯里化函数。应用柯里化函数时需传入若干个实参列表，像`f(3)(4)`这样。不过也可以写成柯里化函数的 _部分应用_（partial application），像`f(3)`这样。 + +* #### 声明（declare） +可以通过 _声明_ 抽象的字段、方法或类型来赋给实体一个名称，但是没有具体实现。声明和定义最关键的差异就是定义会为命名实体创建具体实现，而声明则不会。 + +* #### 定义（define） +在Scala程序中若提到 _定义_ 什么东西，就是说给它赋个名称并给出实现。可以定义的东西包括类、特质、单例对象、字段、方法、本地函数、本地变量等。由于提到定义常常会涉及到某种具体实现，故而抽象成员应为声明而非定义。 + +* #### 直接子类（direct subclass） +类是其 _直接子类_ 的直接超类。 + +* #### 直接超类（direct superclass） +从某个类直接衍生出类或特质，或者说在继承层级结构最接近自己的上层的某个类，这样的类就是直接超类。若类`Child`的可选的extends子句中含有类`Parent`，则`Parent`就是`Child`的直接超类。若`Child`的可选extends子句中含有特质，则特质的直接超类也是`Child`的直接超类。若`Child`没有extends子句，则`AnyRef`就是`Child`的直接超类。若类的直接超类带有类型参数，比如`Child extends Parent[String]`，`Child`的直接超类依旧是`Parent`，而不是`Parent[String]`。另一方面，`Parent[String]`应该叫做`Child`的直接超类型。参见[超类型](#supertype)了解更多关于类和类型间的区别。 + +* #### 相等性（equality） +在没有条件限制的情况下使用时，_相等性_ 就是`==`所表达的两个值之间的关系。参见[引用相等性](#reference-equality)。 + +* #### 存在类型（existential type） +存在类型包含未知类型变量的引用。比如：`Array[T] forSome { type T }`是个存在类型，是`T`的数组，而`T`是某个完全未知的类型，关于`T`唯一能够假定的是它是确定存在的。尽管这个假定很虚，但是至少意味着`Array[T] forSome { type T }`确实是个数组，而不是香蕉什么的东西。 + +* #### 表达式（expression） +任何能够得到结果的Scala代码，也可说成表达式求值为某个结果或结果为某个值。 + +* #### 过滤器（filter） +[for表达式](#for-expression)中的`if`及跟在其后的布尔表达式。在`for(i <- 1 to 10; if i % 2 == 0)`中，过滤器为"`if i % 2 == 0`"。`if`右边的值就是[过滤器表达式](#filter-expression)，也称为守卫。 + +* #### 过滤器表达式（filter expression） +过滤器表达式就是[for表达式](#for-expression)里面跟在`if`后面的布尔表达式。`for( i <- 1 to 10 ; if i % 2 == 0)`的过滤器表达式为"`i % 2 == 0`"。 + +* #### 头等函数（first-class function） +Scala支持 _头等函数_ ，意味着可以通过函数字面量语法来表达函数。如：`(x: Int) => x + 1`，并且函数可由对象来表达，叫做[函数值](#function-value)。 + +* #### for推解式（for comprehension） +_for推解式_ 是[for表达式](#for-expression)的一种，一般用来创建新的集合。对`for`推解式的每次迭代，[yield](#yield)子句都会定义新集合的一个元素。比如：`for (i <- (0 until 2); j <- (2 until 4)) yield (i, j)`将返回集合`Vector((0,2), (0,3), (1,2), (1,3))`。 + +* #### for表达式（for expression） +_for表达式_ 要么是个[for循环](#for-loop)，可以迭代一个或多个集合，要么是个[for推解式](#for-comprehension)，可以从一个或多个集合的元素中推解出一个新的集合。`for`表达式建于[生成器](#generator)、[过滤器](#filter)、变量定义和[yield](#yield)子句（针对[for推解式](#for-comprehension)）基础之上， + +* #### for循环（for loop） +_for循环_ 是[for表达式](#for-expression)的一种，一般用来循环迭代一个或多个集合。因为`for`循环返回unit，所以经常被用来产生副作用。比如：`for (i <- 0 until 100) println(i)`打印数字0到99。 + +* #### 自由变量（free variable） +一个表达式的 _自由变量_ 指的是在表达式中使用但不定义在其中的变量。例如，在函数字面量表达式`(x: Int) => (x, y)`中，变量`x`和`y`都被用到了，但只有`y`是自由变量，因其未在表达式中定义。 + +* #### 函数（function） +_函数_ 可通过一列实参来[调用](#invoke)然后产生结果。函数一般具有参数列表、函数体和结果类型。作为类、特质或单例对象的函数叫做[方法](#method)。定义在其他函数内部的函数叫做[本地函数](#local-function)。结果类型为`Unit`的函数叫做[过程](#procedure)。源码里面的匿名函数叫做[函数字面量](#function-literal)。运行时，函数字面量被实例化为对象，叫做[函数值](#function-value)。 + +* #### 函数字面量（function literal） +在Scala源码中的无名函数，通过函数字面量语法来特别对待。比如：`(x: Int, y: Int) => x + y`。 + +* #### 函数值（function value） +可以像其他函数一样被调用的函数对象。函数值的类一般是继承了`scala`包中的`FunctionN`（比如`Function0`，`Function1`等）这类特质的其中之一，且在源码中常通过[函数字面量](#function-literal)语法来表示。当函数值的apply方法被调用时就说这个函数值被调用。捕获自由变量的函数值为[闭包](#closure)。 + +* #### 函数式风格（functional style） +_函数式风格_ 编程注重函数和求值结果而非操作发生的顺序。这种风格的特征是可传递函数值给循环方法、不可变数据、方法无副作用，是像Haskell和Erlang等这些语言的主要范式，与[命令式风格](#imperative-style)相对应。 + +* #### 生成器（generator） +生成器在[for表达式](#for-expression)中定义一个命名的val变量并赋予其一系列值。比如：`for(i <- 1 to 10)`的生成器是"`i <- 1 to 10`"，`<-`右边的值是[generator表达式](#generator-expression)。 + +* #### 生成器表达式（generator expression） +生成器表达式在[for表达式](#for-expression)中生成一些列值。比如：`for(i <- 1 to 10)`的生成器表达式是"`1 to 10`"。 + +* #### 泛型类（generic class） +带有类型参数的类。例如，因`scala.List`带一类型参数，故其为泛型类。 + +* #### 泛型特质（generic trait） +带有类型参数的特质。例如，因`scala.collection.Set`带一类型参数，故其为泛型特质。 + +* #### 守卫（guard） +参见[过滤器](#filter). + +* #### 助手函数（helper function） +目的是为一个或多个其他邻近函数提供服务的函数。助手函数常实现为本地函数。 + +* #### 助手方法（helper method） +作为类成员的[助手函数](#helper-function)。助手方法常为私有方法。 + +* #### 不可变（immutable） +若对象的值在任何对客户端可见的方式下创建后不会被修改则称对象是 _不可变_ 的。对象既可以是不可变的，也可以是可变的。 + +* #### 命令式风格（imperative style） +_命令式风格_ 编程强调严谨的操作序列以令效用能在正确的顺序发生。这种风格的特征是循环迭代、适当变更数据、方法有副作用，是像C, C++, C#和Java等这些语言的主要范式，与[函数式风格](#functional-style)相对应。 + +* #### 初始化（initialize） +变量在Scala源码中被定义时，必须用对象对其进行初始化。 + +* #### 实例（instance） +_实例_ ，或叫类实例，是个对象，是个仅在运行时存在的概念 + +* #### 实例化（instantiate） +_实例化_ 类是根据类创建一个新对象，是仅在运行时发生的动作。 + +* #### 不变性（invariant） +_不变性_ 用在两个地方。首先在数据结构组织良好的情况下它可以表示某个属性始终为真。比如，若排序二叉树具有右子节点，则其各节点就会在其右子节点前完成排序，这就属于排序二叉树的不变性。其次有时不变性也作为非协变的同义词，如："类`Array`在类型参数上具备不变性"。 + +* #### 调用（invoke） +在实参上 _调用_ 方法、函数或闭包，意即其方法体会在指定实参上执行。 + +* #### Java虚拟机（JVM） +_JVM_ 是Java虚拟机(#runtime)的缩写，或叫[运行时](#runtime)，是运行Scala程序的宿主。 + +* #### 字面量（literal） +`1`，`"One"`，和`(x: Int) => x + 1`是 _字面量_ 的例子，字面量是描述对象的便捷方式，便捷在这种方式正好反映了所创建对象的结构。 + +* #### 本地函数（local function） +_本地函数_ 是块内`def`定义的，作为对比，同为`def`定义的作为类、特质或单例对象的成员则被称作[方法](#method)。 + +* #### 本地变量（local variable） +_本地变量_ 是块内`val`或`var`定义的。尽管函数参数和[本地变量](#local-variable)类似，但并不叫本地变量，而是去掉"本地"直接叫"参数"或"变量"。 + +* #### 成员（member） +_成员_ 是类、特质或单例对象模板中被命名的元素。成员可通过所有者名称，点及其简名访问。例如，定义在类的最顶层字段和方法是这个类的成员。定义在类中的特质是包围它的类的成员。类中通过type关键字定义的类型是这个类的成员。类是其定义所在的包的成员。相比之下，本地变量或本地函数就不是包围他们的块的成员。 + +* #### 消息（message） +Actor是通过给彼此之间发送 _消息_ 来进行通信的。发送消息不会打断接收者正在处理的事情，接收者可一直等到当前活动结束且其不变性被重建之后。 + +* #### 元编程（meta-programming） +元编程程序是指其输入是其自身程序的程序。编译器都是元程序，像`scaladoc`这样的工具也是。要用注解做任何事都需要元编程程序。 + +* #### 方法（method） +_方法_ 就是类、特质或单例对象的成员函数。 + +* #### 混入（mixin） +_混入_ 就是特质用在混入组合时的名称。换言之，在"`trait Hat`"里面，`Hat`仅为特质，而"`new Cat extends AnyRef with Hat`"里面的`Hat`就可叫混入。用作动词时，"混"和"入"（"mix in"）是两个词。比如，可 _混_ 特质 _入_ 至类或其他特质。 + +* #### 混入组合（mixin composition） +把特质混入类或其他特质的过程。_混入组合_ 与传统的多重继承不同之处在于父级引用的类型不是在特质定义时已知的，而是在每次特质每次混入到类或其他特质时才被重新确定。 + +* #### 修饰符（modifier） +用来以某种方式限定类、特质、字段或方法等的定义的关键字。比如，`private`修饰符表明被定义的类、特质、字段或方法是私有的。 + +* #### 多重定义（multiple definitions） +通过使用类似这样的语法`val v1, v2, v3 = exp`，同一个表达式根据 _多重定义_ 概念可被赋值给多个变量。 + +* #### 非协变（nonvariant） +类或特质的类型参数默认是 _非协变_ 的，故而参数变化并不会子类化相应的类或特质。比如，因类`Array`非协变于其类型参数，故`Array[String]`既非`Array[Any]`之子类，亦非其超类。 + +* #### 操作（operation） +在Scala中，每个 _操作_ 都是一个方法调用。方法也可以 _操作符符号_ 的方式被调用，像在`b + 2`里面符号`+`就是一个 _操作符_。 + +* #### 参数（parameter） +函数可带有零至多个 _参数_，每个参数都有名称和类型。参数与实参之间的区别在于函数调用时实参指向具体的对象，参数则是指向这些传入实参的变量。 + +* #### 无参函数（parameterless function） +不带参数的函数，其定义时没有任何空括号。无参函数可不带括号调用，这种方式符合[统一访问原则](#uniform-access-principle)，就是在客户端不改变任何代码的情况下把`def`改成`val`。、 + +* #### 无参方法（parameterless method） +_无参方法_ 就是作为类、特质或单例对象成员的无参函数。 + +* #### 参数化字段（parametric field） +定义为类参数的字段。 + +* #### 偏应用函数（部分应用函数）（partially applied function） +用在表达式中，省掉某些参数的函数。例如：若函数`f`的类型为`Int => Int => Int`，则`f`和`f(1)`就是 _偏应用函数_。 + +* #### 路径依赖类型（path-dependent type） +类似`swiss.cow.Food`的一种类型，`swiss.cow`部分形成一个对象引用的路径。这种类型的含义对于用来访问它的路径是敏感的，比如，`swiss.cow.Food`和`fish.Food`这两个是不同的类型。 + +* #### 模式（pattern） +在`match`表达式的某个备选项中，_模式_ 跟在`case`关键字后，先于 _模式守卫_ 或`=>`符号二者之一。 + +* #### 模式守卫（pattern guard） +在`match`表达式的某个备选项中，_模式守卫_ 可跟在某个[模式](#pattern)后面。比如，"`case x if x % 2 == 0 => x + 1`"中的模式守卫为"`if x % 2 == 0`"。带有模式守卫的备选项（case）仅当其模式匹配了并且模式守卫为真的时候才会被选中。 + +* #### 断言（predicate） +断言是结果类型为`Boolean`的函数。 + +* #### 主构造器（primary constructor） +类的主要构造器，会调用超类构造器，如果有必要，也会初始化字段进行传值，并且会执行类的花括号内定义的的顶层（top-level）代码。字段仅由不传给超类构造器的值参数做初始化，那些类构造体内因未用到而被优化掉的除外。 + +* #### 过程（procedure） +_过程_ 是结果类型为`Unit`的函数，其存在的理由仅为产生副作用。 + +* #### 可重新赋值（reassignable） +变量可以是可重新赋值的，也可以不是可重新赋值的。`var`是可重新赋值的，而`val`则不是。 + +* #### 递归的（recursive） +若函数可调用自身就说它是 _递归的_。若函数调用自身的唯一位置是函数的最后一个表达式，则函数是[尾递归的](#tail-recursive) + +* #### 引用（reference） +_引用_ 是指针的Java抽象，可唯一确定存在JVM堆中的对象。引用类型变量持有对象的引用，因为引用类型（`AnyRef`的实例）是存在JVM堆上的Java对象实现的。相比之下，值类型变量有时会持有一个（装箱类型的）引用，也有时（当对象表示基础类型值的时候）不会。一般说来，Scala变量[指向](#refers)对象。术语"指向"比"持有引用"更加抽象。如果类型为`scala.Int`的变量当前代表Java基础类型`int`的值，则这个变量仍然指向`Int`对象，但并不涉及任何引用。 + +* #### 引用相等性（reference equality） +_引用相等性_ 意思是两个引用指向同一个Java对象。引用相等性仅针对引用类型有意义，是可以通过调用`AnyRef`中的`eq`来确定的（在Java程序中，引用相等性通过在Java[引用类型](#reference-type)上调用`==`来确定）。 + +* #### 引用类型（reference type） +_引用类型_ 是`AnyRef`的子类。在运行时，引用类型的实例常驻JVM堆中。 + +* #### 引用透明（referential transparency） +独立于临时上下文且无副作用的函数属性。对于特定输入，引用透明函数的调用可由其结果替换而不改变程序语义。 + +* #### 指向（refers） +运行的Scala程序中的变量常 _指向_ 某个对象。变量即使被赋为`null`，概念上也是指向`Null`对象。在运行时，对象可由Java对象或基础类型值来实现，不过Scala允许程序员在更高层次抽象代码以他们设想的方式运行。参见[引用](#reference). + +* #### 精化类型（refinement type） +通过提供基础类型及其构造体花括号内若干成员而形成的类型。花括号内的成员精细化了基础类型所体现的类型。比如，"食草动物"（animal that eats grass）的类型为`Animal { type SuitableFood = Grass }`。 +A type formed by supplying a base type a number of members inside curly braces. The members in the curly braces refine the types that are present in the base type. For example, the type of “animal that eats grass” is `Animal { type SuitableFood = Grass }`. + +* #### 结果（result） +Scala程序中的表达式会产生 _结果_。Scala中的每个表达式的结果都是对象。 + +* #### 结果类型（result type） +方法的 _结果类型_ 是调用方法所产生的值的类型。（在Java中，这个概念被称为返回类型） + +* #### 返回（return） +Scala程序中的函数会 _返回_ 值，可把这个值叫做函数的[结果](#result)。也可以说函数 _结果是_ 某个值。Scala中的每个函数结果都是一个对象。 +A function in a Scala program `returns` a value. You can call this value the [result](#result) of the function. You can also say the function _results in_ the value. The result of every function in Scala is an object. + +* #### 运行时（runtime） +正在运行Scala程序的宿主Java虚拟机，或宿主[JVM](#jvm)。运行时这个概念包含了Java虚拟机规范中定义的虚拟机以及Java API和标准Scala API的运行时库。在运行时的这个阶段，意味着程序正在运行中，与编译时是相对的概念。 + +* #### 运行时类型（runtime type） +对象在运行时的类型。相比之下，[静态类型](#static-type)指的是表达式在编译时的类型。多数运行时类型都是无类型参数的裸类，比如，`"Hi"`的运行时类型是`String`，`(x: Int) => x + 1`的运行时类型是`Function1`。运行时类型可通过`isInstanceOf`来检测。 + +* #### 脚本（script） +包含顶层定义和语句，可直接通过`scala`命令来跑而无需显式编译的文件就是脚本，脚本结尾必须是表达式，而不能是定义。 + +* #### 选择器（selector） +`match`表达式中被匹配的值。比如，在"`s match { case _ => }`"中，选择器是`s`。 + +* #### 自身类型（self type） +特质的 _自身类型_ 是特质中用到的接收者`this`的假想类型。任何混入特质的具体类必须要确保其类型符合特质的自身类型。自身类型常被用来把大类分解为若干个特质（[Programming in Scala](http://www.artima.com/shop/programming_in_scala)第29章有述）。 + +* #### 半结构化数据（semi-structured data） +XML数据就是半结构化的，因其相比于普通的二进制文件或文本文件更加结构化，而又不像编程语言的数据结构具备完全结构化。 + +* #### 序列化（serialization） +可把对象 _序列化_ 成字节流，以便将其保存至文件或通过网络传输。之后可对字节流进行 _反序列化_ （可发生在不同计算机上）来获取和原始被序列化的对象一样的对象。 + +* #### 遮掩（shadow） +本地变量的重新声明会 _遮掩_ 作用域内相同名称的变量声明。 + +* #### 签名（signature） +_签名_ 是[类型签名](#type-signature)的简写。 + +* #### 单例对象（singleton object） +由object关键字定义的对象。每个单例对象有且仅有一个实例。与某个类共享名称且与这个类定义在同一源文件中的单例对象，叫这个类的[伴随对象](#companion-object)，类则叫单列对象的[伴随类](#companion-class)。无伴随类的单例对象叫[独立对象](#standalone-object)。 + +* #### 独立对象（standalone object） +没有[伴生类](#companion-class)的[单例对象](#singleton-object)。 + +* #### 语句（statement） +指的是表达式、定义或包导入等这些可放到Scala源码的模板或块中的东西。 + +* #### 静态类型（static type） +参见[类型](#type)。 + +* #### 结构类型（structural type） +也是一种[精化类型](#refinement-type)，只是精化的目标是未在基类型中的成员。比如`{ def close(): Unit }`就是结构类型，因其基类型是`AnyRef`，而`AnyRef`并无名为`close`的成员。 + +* #### 子类（subclass） +一个类是其所有[超类](#superclass)和[超特质](#supertrait)的 _子类_。 + +* #### 子特质（subtrait） +一个特质是其所有[超特质](#supertrait)的 _子特质_。 + +* #### 子类型（subtype） +Scala编译器允许任何类型在需要该类型的地方使用其 _子类型_ 作为替代。对不带类型参数的类和特质来说，子类型的关系会反映子类的关系。比如，若类`Cat`是抽象类`Animal`的子类，且也不带类型参数，则类型`Cat`就是类型`Animal`的子类型。同样，若特质`Apple`是特质`Fruit`的子特质且无类型参数，则类型`Apple`就是类型`Fruit`的子类型。而对于带有类型参数的类和特质来说，协变就起作用了。比如，由于抽象类`List`被声明为在其长类型参数上是协变的（例，`List`被声明为`List[+A]`），`List[Cat]`是`List[Animal]`的子类型，`List[Apple]`是`List[Fruit]`的子类型。尽管这些类型的类都是`List`，但其子类型的关系依旧是存在的。对比来看，因为`Set`未被声明在其类型参数上是协变的（例，`Set`被声明为`Set[A]`，不带加号），所以`Set[Cat]`并不是`Set[Animal]`的子类型。子类型应该正确实现其超类型的契约，以便应用里氏替换原则（Liskov Substitution Principle），不过编译器仅会在类型检查级别核验此属性。 + +* #### 超类（superclass） +一个类的 _超类_ 包括其直接超类，其直接超类的直接超类，等等一直到`Any`。 + +* #### 超特质（supertrait） +类或特质的 _超特质_，如果有的话，就包括所有直接混入类或特质或其任意超类的特质，以及这些特质的所有超特质。 + +* #### 超类型（supertype） +类型是其所有子类型的 _超类型_。 + +* #### 合成类（synthetic class） +合成类是编译器自动生成的而不是程序员手写的。 + +* #### 尾递归（tail recursive） +函数是 _尾递归_ 的，仅当函数调用自身的地方是函数的最后一条操作。 + +* #### 目标类型化（target typing） +_目标类型化_ 是参考所需类型来进行类型推导的一种形式。比如在`nums.filter((x) => x > 0)`中，Scala编译器能推导出`x`的类型是`nums`的元素类型，因为`filter`方法会在`nums`的每个元素上调用函数。 + +* #### 模板（template） +_模板_ 是类、特质或单例对象定义体，它定义了类、特质或对象的类型签名，行为以及初始状态。 + +* #### 特质（trait） +_特质_ 通过`trait`关键字定义，是像抽象类一样不带任何值参数，并且可通过被称为[混入组合](#mixin-composition)的过程"混入到"类或其他特质。当某个特质被混入到其他类或特质，它就被叫做[混入](#mixin)。特质可通过一个或多个类型参数化。用类型来参数化后，特质就形成了类型。比如，`Set`是带有单类型参数的特质，而`Set[Int]`却是一个类型。`Set`也被说成是类型`Set[Int]`的"特质"。 + +* #### 类型（type） +Scala程序中每个变量和表达式都有编译时确定的 _类型_。类型可以在运行时限定变量能指向的值和表达式所能产生的值。如果有必要从对象的[运行时类型](#runtime-type)的角度对变量和表达式的类型进行区分的话，他们也被称为 _静态类型_。换句话说，"类型"这个词本身意味着静态类型。类型与类是区分开的因为带有类型参数的类可以构成许多类型。比如，`List`是类不是类型，`List[T]`则是一个带有自由类型参数的类型，`List[Int]`和`List[String]`也是类型（称为实类型因为他们没有自由类型参数）。类型可以有"[类](#class)"或"[特质](#trait)"，比如类型`List[Int]`的类是`List`，类型`Set[String]`的特质是`Set`。、 + +* #### 类型约束（type constraint） +有些[注解](#annotation)是 _类型约束_，意味着他们会对类型能够包含的取值增加额外的限制或约束。比如，`@positive`可以是类型`Int`的类型约束，用来限制32位整型的取值为正的整数。类型约束虽然不会被标准Scala编译器检查，但相应的必须可被额外的工具或编译器插件检查。 + +* #### 类型构造器（type constructor） +带类型参数的类或特质。 + +* #### 类型参数（type parameter） +必须被填入类型的泛型类或泛型方法的参数。比如，类`List`定义为"`class List[T] { . . . `"，对象`Predef`的一个成员方法`identity`定义为"`def identity[T](x:T) = x`"，二者定义中的`T`就是类型参数。 + +* #### 类型签名（type signature） +方法的 _类型签名_ 包括名称，参数（如果有的话）的数量、顺序和类型，以及结果类型。类、特质或单例对象的类型签名包括名称，所有成员和构造器的类型签名，及其声明的继承和混入关系。 + +* #### 统一访问原则（uniform access principle） +_统一访问原则_ 指的是变量和无参函数应以相同的语法来访问。Scala通过不允许在无参函数的调用点放置括号来支持该原则。这样的话，无参函数定义就可以改成`val`而不影响客户端代码，_反之亦然_。 + +* #### 不可达（unreachable） +在Scala层面，对象可以是 _不可达_ 的，此时其所占据的内存可被运行时回收。不可达并不一定意味着未被引用。引用类型（`AnyRef`的实例）被实现为驻于JVM堆上的对象。当引用类型的实例不可达后，它也确实不被引用了，且可被垃圾回收。值类型（`AnyVal`的实例）可被实现为驻于堆中的基础类型值或Java包装类型实例（如`java.lang.Integer`）。值类型实例可在指向他们的变量的整个生命周期内被装箱（从基础类型值转成包装类型对象）或拆箱（从包装类型对象转成基础类型值）。若表现为JVM堆上的包装类型对象的值类型实例不可达，那就确实不会被引用并且可被垃圾回收。但是若正在表现为基础类型值的值类型不可达，则其仍可被引用，因为此时它并不会以作为对象驻于JVM堆上。运行时可回收不可达对象所占据的内存，但是假如一个Int在运行时被实现为Java基础类型int，在一个运行中的方法的栈帧上占据了一些内存，则这个对象的内存将在方法运行完成且栈帧弹出时才被回收。引用类型的内存，比如`Strings`，可在不可达之后由JVM的垃圾收集器回收。 + +* #### 未引用（unreferenced） +参见[不可达](#unreachable)。 + +* #### 值（value） +Scala中的任何计算或表达式的结果都是一个 _值_，而Scala中的每个值都是一个对象。值这个术语本质上是指对象在内存中（在JVM堆或栈上）的镜像。 + +* #### 值类型（value type） +_值类型_ 是`AnyVal`的任意子类，像`Int`，`Double`或`Unit`。该术语具有Scala源码级别的意味。在运行时，对应于Java基础类型的值类型实例可由基础类型值或包装类型实例来实现，比如`java.lang.Integer`。在值类型实例的整个生命周期内，运行时可将其在基础类型和包装类型间来回转换（如，对其装箱和拆箱）。 + +* #### 变量（variable） +指向对象的命名实体。变量要么是`val`，要么是 `var`，`val`变量和`var`变量在定义时都必须被初始化，但仅`var`变量可被重新赋值来指向不同对象。 + +* #### 型变（variance） +类或特质的类型参数可用 _型变_ 标号来做标记，即[协变](#covariant)（+）或[逆变](#contravariant)（-）。这样的型变标号表明了泛型类或特质的子类化是如何开展的，比如，泛型类`List`在其类型参数上是协变的，因此`List[String]`就是`List[Any]`的子类型。默认情况下，即缺少标号`+`或`-`的类型参数是[非协变](#nonvariant)的。 + +* #### 产生（yield） +表达式可以 _产生_ 结果。`yield`关键字指定了[for推解式](#for-comprehension)的结果。 From cc8106fb900d9b9a60de9c8a72569e44fac85c2a Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Wed, 12 Jun 2019 22:29:31 +0800 Subject: [PATCH 0516/3075] Polish. --- _zh-cn/glossary/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_zh-cn/glossary/index.md b/_zh-cn/glossary/index.md index bc7aff3156..37cedcbd39 100644 --- a/_zh-cn/glossary/index.md +++ b/_zh-cn/glossary/index.md @@ -218,7 +218,7 @@ _混入_ 就是特质用在混入组合时的名称。换言之，在"`trait Hat 函数可带有零至多个 _参数_，每个参数都有名称和类型。参数与实参之间的区别在于函数调用时实参指向具体的对象，参数则是指向这些传入实参的变量。 * #### 无参函数（parameterless function） -不带参数的函数，其定义时没有任何空括号。无参函数可不带括号调用，这种方式符合[统一访问原则](#uniform-access-principle)，就是在客户端不改变任何代码的情况下把`def`改成`val`。、 +不带参数的函数，其定义时没有任何空括号。无参函数可不带括号调用，这种方式符合[统一访问原则](#uniform-access-principle)，就是在客户端不改变任何代码的情况下把`def`改成`val`。 * #### 无参方法（parameterless method） _无参方法_ 就是作为类、特质或单例对象成员的无参函数。 @@ -358,7 +358,7 @@ _模板_ 是类、特质或单例对象定义体，它定义了类、特质或 _特质_ 通过`trait`关键字定义，是像抽象类一样不带任何值参数，并且可通过被称为[混入组合](#mixin-composition)的过程"混入到"类或其他特质。当某个特质被混入到其他类或特质，它就被叫做[混入](#mixin)。特质可通过一个或多个类型参数化。用类型来参数化后，特质就形成了类型。比如，`Set`是带有单类型参数的特质，而`Set[Int]`却是一个类型。`Set`也被说成是类型`Set[Int]`的"特质"。 * #### 类型（type） -Scala程序中每个变量和表达式都有编译时确定的 _类型_。类型可以在运行时限定变量能指向的值和表达式所能产生的值。如果有必要从对象的[运行时类型](#runtime-type)的角度对变量和表达式的类型进行区分的话，他们也被称为 _静态类型_。换句话说，"类型"这个词本身意味着静态类型。类型与类是区分开的因为带有类型参数的类可以构成许多类型。比如，`List`是类不是类型，`List[T]`则是一个带有自由类型参数的类型，`List[Int]`和`List[String]`也是类型（称为实类型因为他们没有自由类型参数）。类型可以有"[类](#class)"或"[特质](#trait)"，比如类型`List[Int]`的类是`List`，类型`Set[String]`的特质是`Set`。、 +Scala程序中每个变量和表达式都有编译时确定的 _类型_。类型可以在运行时限定变量能指向的值和表达式所能产生的值。如果有必要从对象的[运行时类型](#runtime-type)的角度对变量和表达式的类型进行区分的话，他们也被称为 _静态类型_。换句话说，"类型"这个词本身意味着静态类型。类型与类是区分开的因为带有类型参数的类可以构成许多类型。比如，`List`是类不是类型，`List[T]`则是一个带有自由类型参数的类型，`List[Int]`和`List[String]`也是类型（称为实类型因为他们没有自由类型参数）。类型可以有"[类](#class)"或"[特质](#trait)"，比如类型`List[Int]`的类是`List`，类型`Set[String]`的特质是`Set`。 * #### 类型约束（type constraint） 有些[注解](#annotation)是 _类型约束_，意味着他们会对类型能够包含的取值增加额外的限制或约束。比如，`@positive`可以是类型`Int`的类型约束，用来限制32位整型的取值为正的整数。类型约束虽然不会被标准Scala编译器检查，但相应的必须可被额外的工具或编译器插件检查。 From 0906818684e9063f423dd2d15c1cd411706d90a0 Mon Sep 17 00:00:00 2001 From: Dale Wijnand Date: Wed, 12 Jun 2019 17:47:26 +0200 Subject: [PATCH 0517/3075] Fix links Fix the errors in CI: - ./_site/es/tour/annotations.html * External link https://www.scala-lang.org/api/current/scala/remote.html failed: 404 No error - ./_site/overviews/collections/trait-iterable.html * External link https://www.scala-lang.org/api/current/scala/collection/GenSetLike.html failed: 404 No error htmlproofer 3.9.1 | Error: HTML-Proofer found 2 failures! Use scala-212-version over "current" for the old(!) collections. --- _es/tour/annotations.md | 1 - _overviews/collections/trait-iterable.md | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/_es/tour/annotations.md b/_es/tour/annotations.md index abcd9654bc..4d42a6f406 100644 --- a/_es/tour/annotations.md +++ b/_es/tour/annotations.md @@ -27,7 +27,6 @@ El significado de las anotaciones _depende de la implementación_. En la platafo | [`scala.deprecated`](https://www.scala-lang.org/api/current/scala/deprecated.html) | [`java.lang.Deprecated`](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Deprecated.html) | | [`scala.inline`](https://www.scala-lang.org/api/current/scala/inline.html) (desde 2.6.0) | sin equivalente | | [`scala.native`](https://www.scala-lang.org/api/current/scala/native.html) (desde 2.6.0) | [`native`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (palabra clave) | -| [`scala.remote`](https://www.scala-lang.org/api/current/scala/remote.html) | [`java.rmi.Remote`](http://java.sun.com/j2se/1.5.0/docs/api/java/rmi/Remote.html) | | [`scala.throws`](https://www.scala-lang.org/api/current/scala/throws.html) | [`throws`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (palabra clave) | | [`scala.transient`](https://www.scala-lang.org/api/current/scala/transient.html) | [`transient`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (palabra clave) | | [`scala.unchecked`](https://www.scala-lang.org/api/current/scala/unchecked.html) (desde 2.4.0) | sin equivalente | diff --git a/_overviews/collections/trait-iterable.md b/_overviews/collections/trait-iterable.md index ed2938fe6d..e478f3d4d7 100644 --- a/_overviews/collections/trait-iterable.md +++ b/_overviews/collections/trait-iterable.md @@ -62,7 +62,7 @@ Trait `Iterable` also adds some other methods to `Traversable` that can be imple | **Comparison:** | | | `xs sameElements ys` |A test whether `xs` and `ys` contain the same elements in the same order| -In the inheritance hierarchy below Iterable you find three traits: [Seq](https://www.scala-lang.org/api/current/scala/collection/Seq.html), [Set](https://www.scala-lang.org/api/current/scala/collection/Set.html), and [Map](https://www.scala-lang.org/api/current/scala/collection/Map.html). `Seq` and `Map` implement the [PartialFunction](https://www.scala-lang.org/api/current/scala/PartialFunction.html) trait with its `apply` and `isDefinedAt` methods, each implemented differently. `Set` gets its `apply` method from [GenSetLike](https://www.scala-lang.org/api/current/scala/collection/GenSetLike.html). +In the inheritance hierarchy below Iterable you find three traits: [Seq](https://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Seq.html), [Set](https://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Set.html), and [Map](https://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Map.html). `Seq` and `Map` implement the [PartialFunction](https://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/PartialFunction.html) trait with its `apply` and `isDefinedAt` methods, each implemented differently. `Set` gets its `apply` method from [GenSetLike](https://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/GenSetLike.html). For sequences, `apply` is positional indexing, where elements are always numbered from `0`. That is, `Seq(1, 2, 3)(1)` gives `2`. For sets, `apply` is a membership test. For instance, `Set('a', 'b', 'c')('b')` gives `true` whereas `Set()('a')` gives `false`. Finally for maps, `apply` is a selection. For instance, `Map('a' -> 1, 'b' -> 10, 'c' -> 100)('b')` gives `10`. From 494bffd50071cba60d72c51abe3ce9453934c371 Mon Sep 17 00:00:00 2001 From: Alfonso Ruzafa Date: Wed, 12 Jun 2019 18:20:53 +0200 Subject: [PATCH 0518/3075] add visual scala reference to learn page --- learn.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/learn.md b/learn.md index 720a2cb3c2..5a6f817518 100644 --- a/learn.md +++ b/learn.md @@ -52,3 +52,6 @@ There are a handful of websites where you can interactively run Scala code in yo ## ScalaCourses [Independent Courseware](http://getscala.com), online self-study or instructor-led Scala and Play courses for a fee. + +## Visual Scala Reference +[Visual Scala Reference](https://superruzafa.github.com/visual-scala-reference/), a guide to visually learn about Scala concepts and functions. From d3aac4ad5c3eb2fd329cd8b3f053d6ff61b5cf96 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Thu, 13 Jun 2019 09:03:28 +0800 Subject: [PATCH 0519/3075] Polish base on liufengyun's review. --- _zh-cn/glossary/index.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/_zh-cn/glossary/index.md b/_zh-cn/glossary/index.md index 37cedcbd39..1227db611c 100644 --- a/_zh-cn/glossary/index.md +++ b/_zh-cn/glossary/index.md @@ -80,7 +80,7 @@ match表达式的一个分支，形如 “`case` _pattern_ => _expression_”。 可以通过 _声明_ 抽象的字段、方法或类型来赋给实体一个名称，但是没有具体实现。声明和定义最关键的差异就是定义会为命名实体创建具体实现，而声明则不会。 * #### 定义（define） -在Scala程序中若提到 _定义_ 什么东西，就是说给它赋个名称并给出实现。可以定义的东西包括类、特质、单例对象、字段、方法、本地函数、本地变量等。由于提到定义常常会涉及到某种具体实现，故而抽象成员应为声明而非定义。 +在Scala程序中若提到 _定义_ 什么东西，就是说给它赋个名称并给出实现。可以定义的东西包括类、特质、单例对象、字段、方法、局部函数、局部变量等。由于提到定义常常会涉及到某种具体实现，故而抽象成员应为声明而非定义。 * #### 直接子类（direct subclass） 类是其 _直接子类_ 的直接超类。 @@ -119,7 +119,7 @@ _for循环_ 是[for表达式](#for-expression)的一种，一般用来循环迭 一个表达式的 _自由变量_ 指的是在表达式中使用但不定义在其中的变量。例如，在函数字面量表达式`(x: Int) => (x, y)`中，变量`x`和`y`都被用到了，但只有`y`是自由变量，因其未在表达式中定义。 * #### 函数（function） -_函数_ 可通过一列实参来[调用](#invoke)然后产生结果。函数一般具有参数列表、函数体和结果类型。作为类、特质或单例对象的函数叫做[方法](#method)。定义在其他函数内部的函数叫做[本地函数](#local-function)。结果类型为`Unit`的函数叫做[过程](#procedure)。源码里面的匿名函数叫做[函数字面量](#function-literal)。运行时，函数字面量被实例化为对象，叫做[函数值](#function-value)。 +_函数_ 可通过一列实参来[调用](#invoke)然后产生结果。函数一般具有参数列表、函数体和结果类型。作为类、特质或单例对象的函数叫做[方法](#method)。定义在其他函数内部的函数叫做[局部函数](#local-function)。结果类型为`Unit`的函数叫做[过程](#procedure)。源码里面的匿名函数叫做[函数字面量](#function-literal)。运行时，函数字面量被实例化为对象，叫做[函数值](#function-value)。 * #### 函数字面量（function literal） 在Scala源码中的无名函数，通过函数字面量语法来特别对待。比如：`(x: Int, y: Int) => x + y`。 @@ -146,7 +146,7 @@ _函数式风格_ 编程注重函数和求值结果而非操作发生的顺序 参见[过滤器](#filter). * #### 助手函数（helper function） -目的是为一个或多个其他邻近函数提供服务的函数。助手函数常实现为本地函数。 +目的是为一个或多个其他邻近函数提供服务的函数。助手函数常实现为局部函数。 * #### 助手方法（helper method） 作为类成员的[助手函数](#helper-function)。助手方法常为私有方法。 @@ -178,14 +178,14 @@ _JVM_ 是Java虚拟机(#runtime)的缩写，或叫[运行时](#runtime)，是运 * #### 字面量（literal） `1`，`"One"`，和`(x: Int) => x + 1`是 _字面量_ 的例子，字面量是描述对象的便捷方式，便捷在这种方式正好反映了所创建对象的结构。 -* #### 本地函数（local function） -_本地函数_ 是块内`def`定义的，作为对比，同为`def`定义的作为类、特质或单例对象的成员则被称作[方法](#method)。 +* #### 局部函数（local function） +_局部函数_ 是块内`def`定义的，作为对比，同为`def`定义的作为类、特质或单例对象的成员则被称作[方法](#method)。 -* #### 本地变量（local variable） -_本地变量_ 是块内`val`或`var`定义的。尽管函数参数和[本地变量](#local-variable)类似，但并不叫本地变量，而是去掉"本地"直接叫"参数"或"变量"。 +* #### 局部变量（local variable） +_局部变量_ 是块内`val`或`var`定义的。尽管函数参数和[局部变量](#local-variable)类似，但并不叫局部变量，而是去掉"局部"直接叫"参数"或"变量"。 * #### 成员（member） -_成员_ 是类、特质或单例对象模板中被命名的元素。成员可通过所有者名称，点及其简名访问。例如，定义在类的最顶层字段和方法是这个类的成员。定义在类中的特质是包围它的类的成员。类中通过type关键字定义的类型是这个类的成员。类是其定义所在的包的成员。相比之下，本地变量或本地函数就不是包围他们的块的成员。 +_成员_ 是类、特质或单例对象模板中被命名的元素。成员可通过所有者名称，点及其简名访问。例如，定义在类的最顶层字段和方法是这个类的成员。定义在类中的特质是包围它的类的成员。类中通过type关键字定义的类型是这个类的成员。类是其定义所在的包的成员。相比之下，局部变量或局部函数就不是包围他们的块的成员。 * #### 消息（message） Actor是通过给彼此之间发送 _消息_ 来进行通信的。发送消息不会打断接收者正在处理的事情，接收者可一直等到当前活动结束且其不变性被重建之后。 @@ -304,7 +304,7 @@ XML数据就是半结构化的，因其相比于普通的二进制文件或文 可把对象 _序列化_ 成字节流，以便将其保存至文件或通过网络传输。之后可对字节流进行 _反序列化_ （可发生在不同计算机上）来获取和原始被序列化的对象一样的对象。 * #### 遮掩（shadow） -本地变量的重新声明会 _遮掩_ 作用域内相同名称的变量声明。 +局部变量的重新声明会 _遮掩_ 作用域内相同名称的变量声明。 * #### 签名（signature） _签名_ 是[类型签名](#type-signature)的简写。 From 7616f33fe9ef0b7b98b468f09b6d78f558f66e2e Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Thu, 13 Jun 2019 09:07:12 +0800 Subject: [PATCH 0520/3075] Polish base on liufengyun's review 2. --- _zh-cn/glossary/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_zh-cn/glossary/index.md b/_zh-cn/glossary/index.md index 1227db611c..79893b5298 100644 --- a/_zh-cn/glossary/index.md +++ b/_zh-cn/glossary/index.md @@ -145,11 +145,11 @@ _函数式风格_ 编程注重函数和求值结果而非操作发生的顺序 * #### 守卫（guard） 参见[过滤器](#filter). -* #### 助手函数（helper function） -目的是为一个或多个其他邻近函数提供服务的函数。助手函数常实现为局部函数。 +* #### 辅助函数（helper function） +目的是为一个或多个其他邻近函数提供服务的函数。辅助函数常实现为局部函数。 -* #### 助手方法（helper method） -作为类成员的[助手函数](#helper-function)。助手方法常为私有方法。 +* #### 辅助方法（helper method） +作为类成员的[辅助函数](#helper-function)。辅助方法常为私有方法。 * #### 不可变（immutable） 若对象的值在任何对客户端可见的方式下创建后不会被修改则称对象是 _不可变_ 的。对象既可以是不可变的，也可以是可变的。 From e37260db541f6971087c212a1e995c09b33ce974 Mon Sep 17 00:00:00 2001 From: abosshard <23498828+abosshard@users.noreply.github.com> Date: Sat, 15 Jun 2019 16:27:16 +0200 Subject: [PATCH 0521/3075] Update concrete-mutable-collection-classes.md As there is no immutable version of Stack in 2.13, I adjusted the description accordingly. --- .../collections-2.13/concrete-mutable-collection-classes.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/concrete-mutable-collection-classes.md b/_overviews/collections-2.13/concrete-mutable-collection-classes.md index f2cf39eb41..9ddd1242ef 100644 --- a/_overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -81,7 +81,8 @@ Scala provides mutable queues in addition to immutable ones. You use a `mQueue` ## Stacks -You saw immutable stacks earlier. There is also a mutable version, supported by class [mutable.Stack](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/Stack.html). It works exactly the same as the immutable version except that modifications happen in place. +A stack implements a data structure which allows to store and retrieve objects in a last-in-first-out (LIFO) fashion. +It is supported by class [mutable.Stack](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/Stack.html). scala> val stack = new scala.collection.mutable.Stack[Int] stack: scala.collection.mutable.Stack[Int] = Stack() From 82bb519d421f07c512f4e9bd77e551b8bd62a78b Mon Sep 17 00:00:00 2001 From: Jim Van Horn Date: Sat, 15 Jun 2019 22:32:41 -0700 Subject: [PATCH 0522/3075] Update creating-collections-from-scratch.md edit for clarity --- .../collections-2.13/creating-collections-from-scratch.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/collections-2.13/creating-collections-from-scratch.md b/_overviews/collections-2.13/creating-collections-from-scratch.md index c86dd32db2..7f5a0b4ca2 100644 --- a/_overviews/collections-2.13/creating-collections-from-scratch.md +++ b/_overviews/collections-2.13/creating-collections-from-scratch.md @@ -27,7 +27,7 @@ You have syntax `List(1, 2, 3)` to create a list of three integers and `Map('A' List.apply(1.0, 2.0) -So this is a call to the `apply` method of the companion object of the `List` class. That method takes an arbitrary number of arguments and constructs a list from them. Every collection class in the Scala library has a companion object with such an `apply` method. It does not matter whether the collection class represents a concrete implementation, like `List`, or `LazyList` or `Vector`, do, or whether it is an abstract base class such as `Seq`, `Set` or `Iterable`. In the latter case, calling apply will produce some default implementation of the abstract base class. Examples: +So this is a call to the `apply` method of the companion object of the `List` class. That method takes an arbitrary number of arguments and constructs a list from them. Every collection class in the Scala library has a companion object with such an `apply` method. It does not matter whether the collection class represents a concrete implementation, like `List`, `LazyList` or `Vector`, or whether it is an abstract base class such as `Seq`, `Set` or `Iterable`. In the latter case, calling apply will produce some default implementation of the abstract base class. Examples: scala> List(1, 2, 3) res17: List[Int] = List(1, 2, 3) @@ -59,4 +59,4 @@ The operations provided by collection companion objects are summarized in the fo | `C.range(start, end)` | The collection of integers `start` ... `end-1`. | | `C.range(start, end, step)`| The collection of integers starting with `start` and progressing by `step` increments up to, and excluding, the `end` value. | | `C.iterate(x, n)(f)` | The collection of length `n` with elements `x`, `f(x)`, `f(f(x))`, ... | -| `C.unfold(init)(f)` | A collection that uses a function `f` to compute its next element and state, starting from the `init` state.| \ No newline at end of file +| `C.unfold(init)(f)` | A collection that uses a function `f` to compute its next element and state, starting from the `init` state.| From 07135b1bd8aac30b842fb485d1e7a724bba2aeff Mon Sep 17 00:00:00 2001 From: Jim Van Horn Date: Sat, 15 Jun 2019 23:04:18 -0700 Subject: [PATCH 0523/3075] Update seqs.md Corrected distinctBy example result. -jvh --- _overviews/collections-2.13/seqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/seqs.md b/_overviews/collections-2.13/seqs.md index d61f7e4f86..4cd3060b68 100644 --- a/_overviews/collections-2.13/seqs.md +++ b/_overviews/collections-2.13/seqs.md @@ -73,7 +73,7 @@ If a sequence is mutable, it offers in addition a side-effecting `update` method | `xs intersect ys` |The multi-set intersection of sequences `xs` and `ys` that preserves the order of elements in `xs`.| | `xs diff ys` |The multi-set difference of sequences `xs` and `ys` that preserves the order of elements in `xs`.| | `xs.distinct` |A subsequence of `xs` that contains no duplicated element.| -| `xs distinctBy f` |A subsequence of `xs` that contains no duplicated element after applying the transforming function `f`. For instance, `List("foo", "bar", "quux").distinctBy(_.length) == List("foo", "bar")`| +| `xs distinctBy f` |A subsequence of `xs` that contains no duplicated element after applying the transforming function `f`. For instance, `List("foo", "bar", "quux").distinctBy(_.length) == List("foo", "quux")`| Trait [Seq](http://www.scala-lang.org/api/current/scala/collection/Seq.html) has two subtraits [LinearSeq](http://www.scala-lang.org/api/current/scala/collection/LinearSeq.html), and [IndexedSeq](http://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html). These do not add any new operations to the immutable branch, but each offers different performance characteristics: A linear sequence has efficient `head` and `tail` operations, whereas an indexed sequence has efficient `apply`, `length`, and (if mutable) `update` operations. Frequently used linear sequences are `scala.collection.immutable.List` and `scala.collection.immutable.LazyList`. Frequently used indexed sequences are `scala.Array` and `scala.collection.mutable.ArrayBuffer`. The `Vector` class provides an interesting compromise between indexed and linear access. It has both effectively constant time indexing overhead and constant time linear access overhead. Because of this, vectors are a good foundation for mixed access patterns where both indexed and linear accesses are used. You'll learn more on vectors [later](concrete-immutable-collection-classes.html). From 4905400e0fb84f54fc5fb66374251cf923d62dc6 Mon Sep 17 00:00:00 2001 From: Dima Kotobotov Date: Tue, 14 May 2019 00:15:26 +0300 Subject: [PATCH 0524/3075] :sparkles: Russian Collections introduction --- _overviews/collections/introduction.md | 2 +- _ru/overviews/collections/introduction.md | 70 +++++++++++++++++++++++ 2 files changed, 71 insertions(+), 1 deletion(-) create mode 100644 _ru/overviews/collections/introduction.md diff --git a/_overviews/collections/introduction.md b/_overviews/collections/introduction.md index bf16363308..e026efafaa 100644 --- a/_overviews/collections/introduction.md +++ b/_overviews/collections/introduction.md @@ -9,7 +9,7 @@ overview-name: Collections num: 1 -languages: [ja, zh-cn] +languages: [ja, zh-cn, ru] permalink: /overviews/collections/:title.html --- diff --git a/_ru/overviews/collections/introduction.md b/_ru/overviews/collections/introduction.md new file mode 100644 index 0000000000..4f503f94d6 --- /dev/null +++ b/_ru/overviews/collections/introduction.md @@ -0,0 +1,70 @@ +--- +layout: multipage-overview +title: Введение + +discourse: false + +partof: collections +overview-name: Collections + +num: 1 + +language: ru +--- + +**Martin Odersky и Lex Spoon** + +Популярно мнение, что новые коллекции это самое значимое изменение в Scala версии 2.8. +В Scala и раньше были коллекции (и на самом деле, новая модель +во многом совместима с прежней). Но только начиная с версии 2.8 +появилась единая, общая и всеобъемлющая база для всех типов коллекций. + +Несмотря на то, что улучшения коллекций на первый взгляд едва заметны, они могут привести к существенному изменению в вашем стиле программирования. +Теперь чаще, при работе на высоком уровне, вся коллекция становится базовым строительным блоком вашей программы, а не её отдельные элементы. + +К такому стилю программирования необходимо небольшое привыкание. +К счастью, адаптация облегчается приятными свойствами характерными для новых коллекций Scala. +Они обладают простотой в использовании, лаконичностью, безопасностью и универсальностью. + +**Простота:** Небольшого набора из 20-50 методов достаточно для решения большинства задач. +Нет необходимости использовать запутанные циклы или рекурсии. +Персистентные коллекции и операции без побочных эффектов означают, +что вам не нужно беспокоиться о случайном повреждении существующих коллекций новыми данными. +Больше нет путаницы из-за использования итераторов и одновременного изменения коллекций. + +**Лаконичность:** Одной командой можно достичь, столько же, сколько обычно получают используя несколько вложенных операций с циклами. +Вы можете выразить функциональные операции с помощью простого синтаксиса и с легкостью сочетать операции, создавая ощущение +работы со специализированным под задачу языком. + +**Безопасность:** Требуется определенный опыт, чтоб погрузится в эту специфику. +Статически типизированная и функциональная природа коллекций Scala подразумевает, что подавляющее большинство ошибок, которые вы можете совершить, будут пойманы во время компиляции. +Это потому что: + 1. Коллекции сами по себе очень активно используются, поэтому хорошо протестированы. + 2. Использование операции в коллекциях создает явное описание того, что мы ожидаем для входящих данных и для результата. + 3. Это явное описание для входа и результата подвергается статической проверке типа. В результате подавляющее большинство проблем будет проявляться в виде ошибок типов. +Поэтому запуск программ из нескольких сотен строк, с первого раза, вполне типичная ситуация. + + +**Скорость:** Все операции в коллекциях уже настроены и оптимизированы. В результате, работа коллекций получается очень эффективной. +Можно конечно сделать немного более эффективную настройку структур данных и операций с ними, но при этом, +вероятно, вы получите хуже эффективность в непосредственной реализации и использовании. +Кроме того, коллекции оптимизированы для параллельного исполнения на нескольких ядрах. Параллельные коллекции поддерживают те же операции, что и последовательные, поэтому нет необходимости в изучении новых операций или переписывании кода. +Вы можете превратить последовательную коллекцию в параллельную просто вызвав метод `par`. + +**Универсальность:** Коллекции обеспечивают одинаковые операции на любом типе коллекций, где это имеет смысл. Таким образом, можно достичь многого, имея сравнительно небольшой набор операций. Например строка, в принципе, представляет собой последовательность символов. Следовательно, в коллекциях Scala строки поддерживают все операции которые есть у последовательностей (`Seq`). То же самое относится и к массивам. + +**Пример:** Вот лишь одна строчка кода, демонстрирующая преимущества Scala коллекций. + + val (minors, adults) = people partition (_.age < 18) + +Сразу становится понятно, что делает эта строчка: она разделяет коллекцию людей `people` на несовершеннолетних `minors` и взрослых `adults` в зависимости от возраста `age`. +Поскольку метод `partition` определен в базовом типе коллекции `TraversableLike`, этот код работает для любого типа коллекций, включая массивы. +Полученные в результате коллекции `minors` и `adults` будут иметь тот же тип, что и коллекция `people` . + +Этот код намного лаконичнее, чем несколько циклов, необходимых для того, чтоб провести обработку традиционным методом +(три цикла для массива, т.к. промежуточные результаты должны быть сохранены где-то в другом месте). +Как только вы освоите базовую схему работы с коллекциями, вы оцените на сколько проще и безопаснее написание такого кода, в отличии от более низкоуровневого кода с циклами. +Кроме того, сама операция `partition` работает довольно быстро и будет работать еще быстрее на многоядерных процессорах при использовании параллельных коллекций. (Параллельные коллекции стали частью Scala начиная с версии 2.9.) + +В этом разделе подробно рассматриваются API классов коллекций Scala с пользовательской точки зрения. +Вы также познакомитесь со всеми фундаментальными классами и методами, которые есть у коллекций. From 44032b5473103a5cf21a47552398910667898f0d Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 19 Jun 2019 07:38:39 +0200 Subject: [PATCH 0525/3075] update spec links and advisements partially addresses scala/bug#11566 --- contribute/bug-reporting-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 71cb5e7ad8..bd2f2c70c4 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -44,7 +44,7 @@ If you have a code snippet that is resulting in bytecode which you believe is be 5. If you want to file an improvement in the issue tracker please discuss it first on one of the mailing lists. They offer much bigger audience than issue tracker. The latter is not suitable for long discussions. -* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/files/archive/spec/2.12/). If in doubt, you may always ask on the [Community Category](https://contributors.scala-lang.org/c/community) or [Stack Overflow](https://stackoverflow.com/questions/tagged/scala). +* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/files/archive/spec/2.13/). If in doubt, you may always ask on the [Community Category](https://contributors.scala-lang.org/c/community) or [Stack Overflow](https://stackoverflow.com/questions/tagged/scala). In general, if you find yourself stuck on any of these steps, asking on [Scala Contributors](https://contributors.scala-lang.org/) can be helpful: From e7b6030befe29b9c56eaf4641397d2513fee2223 Mon Sep 17 00:00:00 2001 From: Jorge Vicente Cantero Date: Fri, 21 Jun 2019 08:06:32 +0200 Subject: [PATCH 0526/3075] Migrate to ci.scala-lang Drone 8 instance --- .drone.yml | 1 - .drone.yml.sig | 1 - 2 files changed, 2 deletions(-) delete mode 100644 .drone.yml.sig diff --git a/.drone.yml b/.drone.yml index d36025ce89..7b74f75e3a 100644 --- a/.drone.yml +++ b/.drone.yml @@ -1,6 +1,5 @@ pipeline: build: image: scalacenter/scala-rvm-jvm-coursier:2.0 - pull: true commands: - ./scripts/ci.sh diff --git a/.drone.yml.sig b/.drone.yml.sig deleted file mode 100644 index 8240a38b07..0000000000 --- a/.drone.yml.sig +++ /dev/null @@ -1 +0,0 @@ -eyJhbGciOiJIUzI1NiJ9.cGlwZWxpbmU6CiAgYnVpbGQ6CiAgICBpbWFnZTogamRrLXJ2bS1jb3Vyc2llcjpsYXRlc3QKICAgIHB1bGw6IHRydWUKICAgIGNvbW1hbmRzOgogICAgICAtIHNvdXJjZSB-Ly5wcm9maWxlCiAgICAgIC0gYnVuZGxlIGluc3RhbGwKICAgICAgLSAuL3NjcmlwdHMvcnVuLXR1dC5zaAogICAgICAtIHJtIC1yIHR1dC10bXAKICAgICAgLSBidW5kbGUgZXhlYyBqZWt5bGwgYnVpbGQK.7Rp37FEwRqAo85EdFYZh1PoyU8mxpFdEnpchWaQkHCc From 2c87d8ff773632e9da0b1a760a9ee20c304b3fb6 Mon Sep 17 00:00:00 2001 From: mumutu66 <30490822+mumutu66@users.noreply.github.com> Date: Fri, 21 Jun 2019 14:16:43 +0800 Subject: [PATCH 0527/3075] Update breakOut.md fix the B type error --- _overviews/FAQ/breakout.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/FAQ/breakout.md b/_overviews/FAQ/breakout.md index 0a39214d55..b5ef234cda 100644 --- a/_overviews/FAQ/breakout.md +++ b/_overviews/FAQ/breakout.md @@ -154,7 +154,7 @@ chain, we find that the types passed to `TraversableLike`, and, thus, used by Going back to the example, the first map is receiving a function of type `((Int, String)) => (Int, Int)` and the second map is receiving a function of -type `((Int, String)) => Int`. I use the double parenthesis to emphasize it is +type `((Int, String)) => String`. I use the double parenthesis to emphasize it is a tuple being received, as that's the type of `A` as we saw. With that information, let's consider the other types. @@ -163,7 +163,7 @@ With that information, let's consider the other types. B = (Int, Int) map (_._2): - B = Int + B = String We can see that the type returned by the first `map` is `Map[Int,Int]`, and the second is `Iterable[String]`. Looking at `map`'s definition, it is easy to see From 9d5a769f68e6e1593943efb3549b1a158936e660 Mon Sep 17 00:00:00 2001 From: Jorge Vicente Cantero Date: Fri, 21 Jun 2019 09:12:43 +0200 Subject: [PATCH 0528/3075] Update CI badge --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bed6ea16d7..93bf91952e 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Scala Documentation # -[![Build Status](https://platform-ci.scala-lang.org/api/badges/scala/docs.scala-lang/status.svg)](https://platform-ci.scala-lang.org/scala/docs.scala-lang) +[![Build Status](https://ci.scala-lang.org/api/badges/scala/docs.scala-lang/status.svg)](https://platform-ci.scala-lang.org/scala/docs.scala-lang) This repository contains the source for the Scala documentation website, as well as the source for "Scala Improvement Process" (SIP) documents. From 7fb22d57689d82e20f7bdac4926bbba719d30448 Mon Sep 17 00:00:00 2001 From: cclaudiu81 Date: Fri, 21 Jun 2019 23:11:20 +0300 Subject: [PATCH 0529/3075] PR changes refactored OO info in the page intro & change small things based on the PR review. --- _tour/higher-order-functions.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/_tour/higher-order-functions.md b/_tour/higher-order-functions.md index d6d1681894..f080bb8350 100644 --- a/_tour/higher-order-functions.md +++ b/_tour/higher-order-functions.md @@ -19,6 +19,8 @@ The terminology can get a bit confusing at this point, and we use the phrase "higher order function" for both methods and functions that take functions as parameters or that return a function. +In a pure Object Oriented world a good practice is to avoid exposing methods parameterized with functions that might leak object's internal state. Leaking internal state might break the invariants of the object itself thus violating encapsulation. + One of the most common examples is the higher-order function `map` which is available for collections in Scala. ```tut @@ -58,10 +60,8 @@ case class WeeklyWeatherForecast(temperatures: Seq[Double]) { def forecastInFahrenheit: Seq[Double] = temperatures.map(convertCtoF) // <-- passing the method convertCtoF } ``` -Here the method `convertCtoF` is passed to `forecastInFahrenheit`. This is possible because the compiler coerces `convertCtoF` to the function `x => convertCtoF(x)` (note: `x` will +Here the method `convertCtoF` is passed to the higher order function `map`. This is possible because the compiler coerces `convertCtoF` to the function `x => convertCtoF(x)` (note: `x` will be a generated name which is guaranteed to be unique within its scope). - -In a pure Object Oriented world a good practice is to avoid exposing methods that are parameterized with functions that might escape the internal state of the objects. Leaking internal state might break the invariants of the object itself. ## Functions that accept functions One reason to use higher-order functions is to reduce redundant code. Let's say you wanted some methods that could raise someone's salaries by various factors. Without creating a higher-order function, @@ -104,6 +104,8 @@ object SalaryRaiser { The new method, `promotion`, takes the salaries plus a function of type `Double => Double` (i.e. a function that takes a Double and returns a Double) and returns the product. +Methods and functions usually express behaviours or data transformations, therefore having functions that compose based on other functions can help building generic mechanisms. Those generic operations defer to lock down the entire operation behaviour giving clients a way to control or further customize parts of the operation itself. + ## Functions that return functions There are certain cases where you want to generate a function. Here's an example From 2555a85e19ab9573529beb01f0b35a2d0d3596fe Mon Sep 17 00:00:00 2001 From: Dale Wijnand Date: Fri, 21 Jun 2019 09:42:37 +0100 Subject: [PATCH 0530/3075] Fix some more links Pin some translated guides back to Scala 2.12, and drop scala.remote in the Korean docs. --- .../concrete-parallel-collections.md | 16 +++++----- .../concrete-immutable-collection-classes.md | 22 +++++++------- .../concrete-mutable-collection-classes.md | 30 +++++++++---------- _ja/overviews/collections/iterators.md | 6 ++-- _ja/overviews/collections/overview.md | 8 ++--- .../collections/trait-traversable.md | 4 +-- .../concrete-parallel-collections.md | 22 +++++++------- _ko/tour/annotations.md | 1 - _overviews/collections/trait-traversable.md | 2 +- _pl/tour/annotations.md | 1 - _pt-br/tour/annotations.md | 1 - _zh-cn/overviews/collections/overview.md | 4 +-- 12 files changed, 57 insertions(+), 60 deletions(-) diff --git a/_es/overviews/parallel-collections/concrete-parallel-collections.md b/_es/overviews/parallel-collections/concrete-parallel-collections.md index 158c923f6e..3cb5e36a94 100644 --- a/_es/overviews/parallel-collections/concrete-parallel-collections.md +++ b/_es/overviews/parallel-collections/concrete-parallel-collections.md @@ -13,7 +13,7 @@ language: es ## Array Paralelo -Una secuencia [ParArray](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/mutable/ParArray.html) contiene un conjunto de elementos contiguos lineales. Esto significa que los elementos pueden ser accedidos y actualizados (modificados) eficientemente al modificar la estructura subyacente (un array). El iterar sobre sus elementos es también muy eficiente por esta misma razón. Los Arrays Paralelos son como arrays en el sentido de que su tamaño es constante. +Una secuencia [ParArray](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/mutable/ParArray.html) contiene un conjunto de elementos contiguos lineales. Esto significa que los elementos pueden ser accedidos y actualizados (modificados) eficientemente al modificar la estructura subyacente (un array). El iterar sobre sus elementos es también muy eficiente por esta misma razón. Los Arrays Paralelos son como arrays en el sentido de que su tamaño es constante. scala> val pa = scala.collection.parallel.mutable.ParArray.tabulate(1000)(x => 2 * x + 1) pa: scala.collection.parallel.mutable.ParArray[Int] = ParArray(1, 3, 5, 7, 9, 11, 13,... @@ -31,7 +31,7 @@ Al invocar el método `seq`, los arrays paralelos son convertidos al tipo de col ## Vector Paralelo -Un [ParVector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParVector.html) es una secuencia inmutable con un tiempo de acceso y modificación logarítimico bajo a constante. +Un [ParVector](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParVector.html) es una secuencia inmutable con un tiempo de acceso y modificación logarítimico bajo a constante. scala> val pv = scala.collection.parallel.immutable.ParVector.tabulate(1000)(x => x) pv: scala.collection.parallel.immutable.ParVector[Int] = ParVector(0, 1, 2, 3, 4, 5, 6, 7, 8, 9,... @@ -41,11 +41,11 @@ Un [ParVector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/coll Los vectores inmutables son representados por árboles, por lo que los splitters dividen pasándose subárboles entre ellos. Los combiners concurrentemente mantienen un vector de elementos y son combinados al copiar dichos elementos de forma "retardada". Es por esta razón que los métodos tranformadores son menos escalables que sus contrapartes en arrays paralelos. Una vez que las operaciones de concatenación de vectores estén disponibles en una versión futura de Scala, los combiners podrán usar dichas características y hacer más eficientes los métodos transformadores. -Un vector paralelo es la contraparte paralela de un [Vector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html) secuencial, por lo tanto la conversión entre estas dos estructuras se efectúa en tiempo constante. +Un vector paralelo es la contraparte paralela de un [Vector](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html) secuencial, por lo tanto la conversión entre estas dos estructuras se efectúa en tiempo constante. ## Rango (Range) Paralelo -Un [ParRange](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParRange.html) es una secuencia ordenada separada por intervalos iguales (ej: 1, 2, 3 o 1, 3, 5, 7). Un rango paralelo es creado de forma similar al [Rango](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html) secuencial: +Un [ParRange](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParRange.html) es una secuencia ordenada separada por intervalos iguales (ej: 1, 2, 3 o 1, 3, 5, 7). Un rango paralelo es creado de forma similar al [Rango](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html) secuencial: scala> 1 to 3 par res0: scala.collection.parallel.immutable.ParRange = ParRange(1, 2, 3) @@ -61,7 +61,7 @@ Tal como los rangos secuenciales no tienen constructores, los rangos paralelos n ## Tablas Hash Paralelas -Las tablas hash paralelas almacenan sus elementos en un array subyacente y los almacenan en una posición determinada por el código hash del elemento respectivo. Las versiones mutables de los hash sets paralelos ([mutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/mutable/ParHashSet.html)) y los hash maps paraleos ([mutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/mutable/ParHashMap.html)) están basados en tablas hash. +Las tablas hash paralelas almacenan sus elementos en un array subyacente y los almacenan en una posición determinada por el código hash del elemento respectivo. Las versiones mutables de los hash sets paralelos ([mutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/mutable/ParHashSet.html)) y los hash maps paraleos ([mutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/mutable/ParHashMap.html)) están basados en tablas hash. scala> val phs = scala.collection.parallel.mutable.ParHashSet(1 until 2000: _*) phs: scala.collection.parallel.mutable.ParHashSet[Int] = ParHashSet(18, 327, 736, 1045, 773, 1082,... @@ -75,9 +75,9 @@ Los "Mapas Hash" (Hash Maps) y los "Conjuntos Hash" (Hash Sets) secuenciales pue ## Hash Tries Paralelos -Los Hash Tries paralelos son la contraparte paralela de los hash tries inmutables, que son usados para representar conjuntos y mapas inmutables de forma eficiente. Las clases involucradas son: [immutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParHashSet.html) +Los Hash Tries paralelos son la contraparte paralela de los hash tries inmutables, que son usados para representar conjuntos y mapas inmutables de forma eficiente. Las clases involucradas son: [immutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParHashSet.html) y -[immutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/immutable/ParHashMap.html). +[immutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/immutable/ParHashMap.html). scala> val phs = scala.collection.parallel.immutable.ParHashSet(1 until 1000: _*) phs: scala.collection.parallel.immutable.ParHashSet[Int] = ParSet(645, 892, 69, 809, 629, 365, 138, 760, 101, 479,... @@ -92,7 +92,7 @@ Los hash tries paralelos pueden ser convertidos hacia y desde hash tries secuenc ## Tries Paralelos Concurrentes -Un [concurrent.TrieMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html) es un mapa thread-safe (seguro ante la utilización de múltiples hilos concurrentes) mientras que [mutable.ParTrieMap](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/mutable/ParTrieMap.html) es su contraparte paralela. Si bien la mayoría de las estructuras de datos no garantizan una iteración consistente si la estructura es modificada en medio de dicha iteración, los tries concurrentes garantizan que las actualizaciones sean solamente visibles en la próxima iteración. Esto significa que es posible mutar el trie concurrente mientras se está iterando sobre este, como en el siguiente ejemplo, que computa e imprime las raíces cuadradas de los números entre 1 y 99: +Un [concurrent.TrieMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/concurrent/TrieMap.html) es un mapa thread-safe (seguro ante la utilización de múltiples hilos concurrentes) mientras que [mutable.ParTrieMap](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/mutable/ParTrieMap.html) es su contraparte paralela. Si bien la mayoría de las estructuras de datos no garantizan una iteración consistente si la estructura es modificada en medio de dicha iteración, los tries concurrentes garantizan que las actualizaciones sean solamente visibles en la próxima iteración. Esto significa que es posible mutar el trie concurrente mientras se está iterando sobre este, como en el siguiente ejemplo, que computa e imprime las raíces cuadradas de los números entre 1 y 99: scala> val numbers = scala.collection.parallel.mutable.ParTrieMap((1 until 100) zip (1 until 100): _*) map { case (k, v) => (k.toDouble, v.toDouble) } numbers: scala.collection.parallel.mutable.ParTrieMap[Double,Double] = ParTrieMap(0.0 -> 0.0, 42.0 -> 42.0, 70.0 -> 70.0, 2.0 -> 2.0,... diff --git a/_ja/overviews/collections/concrete-immutable-collection-classes.md b/_ja/overviews/collections/concrete-immutable-collection-classes.md index 508ca9a227..77a2a4880a 100644 --- a/_ja/overviews/collections/concrete-immutable-collection-classes.md +++ b/_ja/overviews/collections/concrete-immutable-collection-classes.md @@ -16,7 +16,7 @@ Scala は様々な具象不変コレクションクラス (concrete immutable co ## リスト -リスト ([`List`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/List.html)) は有限の不変列だ。リストは最初の要素とリストの残りの部分に定数時間でアクセスでき、また、新たな要素をリストの先頭に追加する定数時間の cons 演算を持つ。他の多くの演算は線形時間で行われる。 +リスト ([`List`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/List.html)) は有限の不変列だ。リストは最初の要素とリストの残りの部分に定数時間でアクセスでき、また、新たな要素をリストの先頭に追加する定数時間の cons 演算を持つ。他の多くの演算は線形時間で行われる。 リストは Scala プログラミングの働き者であり続けてきたので、あえてここで語るべきことは多くない。Scala 2.8 での大きな変更点は `List` クラスはそのサブクラスである `::` とそのサブオブジェクトである `Nil` とともに、論理的にふさわしい `scala.collection.immutable` パッケージで定義されるようになったことだ。`scala` パッケージには `List`、`Nil`、および `::` へのエイリアスがあるため、ユーザの立場から見ると、リストは今まで通り使うことができる。 @@ -24,7 +24,7 @@ Scala は様々な具象不変コレクションクラス (concrete immutable co ## ストリーム -ストリーム ([`Stream`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Stream.html)) はリストに似ているが、要素は遅延評価される。そのため、ストリームは無限の長さをもつことができる。呼び出された要素のみが計算される。他の点においては、ストリームはリストと同じ性能特性をもつ。 +ストリーム ([`Stream`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Stream.html)) はリストに似ているが、要素は遅延評価される。そのため、ストリームは無限の長さをもつことができる。呼び出された要素のみが計算される。他の点においては、ストリームはリストと同じ性能特性をもつ。 リストは `::` 演算子によって構築されるが、ストリームはそれに似た `#::` 演算子によって構築される。以下は、整数の 1, 2, 3 からなる簡単なストリームの例だ: @@ -52,7 +52,7 @@ Scala は様々な具象不変コレクションクラス (concrete immutable co リストはアルゴリズムが慎重にリストの先頭要素 (`head`) のみを処理する場合、非常に効率的だ。`head` の読み込み、追加、および削除は一定数時間で行われるのに対して、リストの後続の要素に対する読み込みや変更は、その要素の深さに依存した線形時間で実行される。 -ベクトル ([`Vector`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html)) は、ランダムアクセス時の非効率性を解決するために Scala 2.8 から導入された新しいコレクション型だ。ベクトルはどの要素の読み込みも「事実上」定数時間で行う。リストの `head` の読み込みや配列の要素読み込みに比べると大きい定数だが、定数であることには変りない。この結果、ベクトルを使ったアルゴリズムは列の `head` のみを読み込むことに神経質にならなくていい。任意の場所の要素を読み込んだり、変更したりできるため、コードを書くのに便利だ。 +ベクトル ([`Vector`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html)) は、ランダムアクセス時の非効率性を解決するために Scala 2.8 から導入された新しいコレクション型だ。ベクトルはどの要素の読み込みも「事実上」定数時間で行う。リストの `head` の読み込みや配列の要素読み込みに比べると大きい定数だが、定数であることには変りない。この結果、ベクトルを使ったアルゴリズムは列の `head` のみを読み込むことに神経質にならなくていい。任意の場所の要素を読み込んだり、変更したりできるため、コードを書くのに便利だ。 ベクトルは、他の列と同じように作成され、変更される。 @@ -79,14 +79,14 @@ Scala は様々な具象不変コレクションクラス (concrete immutable co 最後の行が示すように、`updated` の呼び出しは元のベクトル `vec` には一切影響しない。読み込みと同様に、ベクトルの関数型更新も「事実上定数時間」で実行される。ベクトルの真ん中にある要素を更新するには、その要素を格納するノードと、木構造の根ノードからを初めとする全ての親ノードをコピーすることによって行われる。これは関数型更新は、32以内の要素か部分木を格納する 1 〜 5個の ノードを作成することを意味する。これは、可変配列の in-place での上書きに比べると、ずっと時間のかかる計算であるが、ベクトル全体をコピーするよりはずっと安いものだ。 -ベクトルは高速なランダム読み込みと高速な関数型更新の丁度いいバランスを取れているため、不変添字付き列 ([`immutable.IndexedSeq`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/IndexedSeq.html)) トレイトのデフォルトの実装となっている: +ベクトルは高速なランダム読み込みと高速な関数型更新の丁度いいバランスを取れているため、不変添字付き列 ([`immutable.IndexedSeq`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/IndexedSeq.html)) トレイトのデフォルトの実装となっている: scala> collection.immutable.IndexedSeq(1, 2, 3) res2: scala.collection.immutable.IndexedSeq[Int] = Vector(1, 2, 3) ## 不変スタック -後入れ先出し (LIFO: last in first out) の列が必要ならば、スタック ([`Stack`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Stack.html)) がある。 `push` メソッドを使ってスタックに要素をプッシュ、`pop` を使ってポップ、そして`top` を使って削除することなく一番上の要素を読み込むことができる。これらの演算は、全て定数時間で行われる。 +後入れ先出し (LIFO: last in first out) の列が必要ならば、スタック ([`Stack`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Stack.html)) がある。 `push` メソッドを使ってスタックに要素をプッシュ、`pop` を使ってポップ、そして`top` を使って削除することなく一番上の要素を読み込むことができる。これらの演算は、全て定数時間で行われる。 以下はスタックに対して行われる簡単な演算の例だ: @@ -105,7 +105,7 @@ Scala は様々な具象不変コレクションクラス (concrete immutable co ## 不変キュー -キュー ([`Queue`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Queue.html)) はスタックに似ているが、後入れ先出し (LIFO: last in first out) ではなく、先入れ先出し (FIFO: +キュー ([`Queue`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Queue.html)) はスタックに似ているが、後入れ先出し (LIFO: last in first out) ではなく、先入れ先出し (FIFO: first in first out) だ。 以下に空の不変キューの作り方を示す: @@ -134,7 +134,7 @@ first in first out) だ。 ## 範囲 -範囲 ([`Range`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html)) は順序付けされた等間隔の整数の列だ。例えば、「1、2、3」は範囲であり、「5、8、11、14」も範囲だ。Scala で範囲を作成するには、予め定義された `to` メソッドと `by` メソッドを使う。 +範囲 ([`Range`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html)) は順序付けされた等間隔の整数の列だ。例えば、「1、2、3」は範囲であり、「5、8、11、14」も範囲だ。Scala で範囲を作成するには、予め定義された `to` メソッドと `by` メソッドを使う。 scala> 1 to 3 res2: scala.collection.immutable.Range.Inclusive = Range(1, 2, 3) @@ -150,7 +150,7 @@ first in first out) だ。 ## ハッシュトライ -ハッシュトライは不変集合と不変マップを効率的に実装する標準的な方法だ。ハッシュトライは、[`immutable.HashMap`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/HashMap.html) クラスによりサポートされている。データ構造は、全てのノードに 32個の要素か 32個の部分木があるという意味でベクトルに似ている。しかし、キーの選択はハッシュコードにより行われる。たとえば、マップから任意のキーを検索する場合、まずキーのハッシュコードを計算する。その後、最初の部分木を選択するのにハッシュコードの下位 5ビットが使われ、次の 5ビットで次の部分木が選択される、という具合だ。ノード内の全ての要素が、その階層までで選ばれているビット範囲内でお互いと異なるハッシュコードを持った時点で選択は終了する。 +ハッシュトライは不変集合と不変マップを効率的に実装する標準的な方法だ。ハッシュトライは、[`immutable.HashMap`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/HashMap.html) クラスによりサポートされている。データ構造は、全てのノードに 32個の要素か 32個の部分木があるという意味でベクトルに似ている。しかし、キーの選択はハッシュコードにより行われる。たとえば、マップから任意のキーを検索する場合、まずキーのハッシュコードを計算する。その後、最初の部分木を選択するのにハッシュコードの下位 5ビットが使われ、次の 5ビットで次の部分木が選択される、という具合だ。ノード内の全ての要素が、その階層までで選ばれているビット範囲内でお互いと異なるハッシュコードを持った時点で選択は終了する。 ハッシュトライは、サイズ相応の高速な検索と、相応に効率的な関数型加算 `(+)` と減算 `(-)` の調度良いバランスが取れている。そのため、ハッシュトライは Scala の不変マップと不変集合のデフォルトの実装を支えている。実は、Scala は要素が 5個未満の不変集合と不変マップに関して、更なる最適化をしている。1 〜 4個の要素を持つ集合とセットは、要素 (マップの場合は、キー/値のペア) をフィールドとして持つ単一のオブジェクトとして格納する。空の不変集合と、空の不変マップは、ぞれぞれ単一のオブジェクトである。空の不変集合や不変マップは、空であり続けるため、データ構造を複製する必要はない。 @@ -158,7 +158,7 @@ first in first out) だ。 赤黒木は、ノードが「赤」か「黒」に色付けされている平衡二分木の一種だ。他の平衡二分木と同様に演算は木のサイズのログ時間内に確実に完了する。 -Scala は内部で赤黒木を使った不変集合と不変マップの実装を提供する。[`TreeSet`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/TreeSet.html) と [`TreeMap`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/TreeMap.html) クラスがそれだ。 +Scala は内部で赤黒木を使った不変集合と不変マップの実装を提供する。[`TreeSet`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/TreeSet.html) と [`TreeMap`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/TreeMap.html) クラスがそれだ。 scala> scala.collection.immutable.TreeSet.empty[Int] res11: scala.collection.immutable.TreeSet[Int] = TreeSet() @@ -170,7 +170,7 @@ Scala は内部で赤黒木を使った不変集合と不変マップの実装 ## 不変ビット集合 -ビット集合 ([`BitSet`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/BitSet.html)) は大きい整数のビットを小さな整数のコレクションを使って表す。例えば、3, 2, と 0 を格納するビット集合は二進法で整数の 1101、十進法で 13 を表す。 +ビット集合 ([`BitSet`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/BitSet.html)) は大きい整数のビットを小さな整数のコレクションを使って表す。例えば、3, 2, と 0 を格納するビット集合は二進法で整数の 1101、十進法で 13 を表す。 内部では、ビット集合は 64ビットの `Long` の配列を使っている。配列の最初の `Long` は 整数の 0〜63、二番目は 64〜127 という具合だ。そのため、ビット集合は最大値が数百以下の場合は非常にコンパクトだ。 @@ -187,7 +187,7 @@ Scala は内部で赤黒木を使った不変集合と不変マップの実装 ## リストマップ -リストマップ ([`ListMap`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/ListMap.html)) は、キー/値ペアの連結リスト (linked list) により実装されたマップを表す。一般的に、リストマップの演算はリスト全体を総なめする必要がある可能性がある。そのため、リストマップの演算はマップのサイズに対して線形時間をとる。標準の不変マップの方が常に高速なので Scala のリストマップが使われることはほとんど無い。唯一性能の差が出る可能性としては、マップが何らかの理由でリストの最初の要素が他の要素に比べてずっと頻繁に読み込まれるように構築された場合だ。 +リストマップ ([`ListMap`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/ListMap.html)) は、キー/値ペアの連結リスト (linked list) により実装されたマップを表す。一般的に、リストマップの演算はリスト全体を総なめする必要がある可能性がある。そのため、リストマップの演算はマップのサイズに対して線形時間をとる。標準の不変マップの方が常に高速なので Scala のリストマップが使われることはほとんど無い。唯一性能の差が出る可能性としては、マップが何らかの理由でリストの最初の要素が他の要素に比べてずっと頻繁に読み込まれるように構築された場合だ。 scala> val map = scala.collection.immutable.ListMap(1->"one", 2->"two") map: scala.collection.immutable.ListMap[Int,java.lang.String] = diff --git a/_ja/overviews/collections/concrete-mutable-collection-classes.md b/_ja/overviews/collections/concrete-mutable-collection-classes.md index 4889c7a559..8534783b1a 100644 --- a/_ja/overviews/collections/concrete-mutable-collection-classes.md +++ b/_ja/overviews/collections/concrete-mutable-collection-classes.md @@ -16,7 +16,7 @@ Scala が標準ライブラリで提供する不変コレクションで最も ## 配列バッファ -配列バッファ ([`ArrayBuffer`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayBuffer.html)) は、配列とサイズを格納するバッファだ。配列バッファの演算のほとんどは、単に内部の配列にアクセスして変更するだけなので、配列の演算と同じ速さで実行される。また、配列バッファは効率的にデータをバッファの最後に追加できる。配列バッファへの要素の追加はならし定数時間 (amortized constant time) で実行される。よって、配列バッファは要素が常に最後に追加される場合、大きいコレクションを効率的に構築するのに便利だ。 +配列バッファ ([`ArrayBuffer`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ArrayBuffer.html)) は、配列とサイズを格納するバッファだ。配列バッファの演算のほとんどは、単に内部の配列にアクセスして変更するだけなので、配列の演算と同じ速さで実行される。また、配列バッファは効率的にデータをバッファの最後に追加できる。配列バッファへの要素の追加はならし定数時間 (amortized constant time) で実行される。よって、配列バッファは要素が常に最後に追加される場合、大きいコレクションを効率的に構築するのに便利だ。 scala> val buf = scala.collection.mutable.ArrayBuffer.empty[Int] buf: scala.collection.mutable.ArrayBuffer[Int] = ArrayBuffer() @@ -29,7 +29,7 @@ Scala が標準ライブラリで提供する不変コレクションで最も ## リストバッファ -リストバッファ ([`ListBuffer`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ListBuffer.html)) は、内部に配列の代わりに連結リストを使うこと以外は配列バッファに似ている。バッファを構築後にリストに変換する予定なら、配列バッファの代わりにリストバッファを使うべきだ。 +リストバッファ ([`ListBuffer`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ListBuffer.html)) は、内部に配列の代わりに連結リストを使うこと以外は配列バッファに似ている。バッファを構築後にリストに変換する予定なら、配列バッファの代わりにリストバッファを使うべきだ。 scala> val buf = scala.collection.mutable.ListBuffer.empty[Int] buf: scala.collection.mutable.ListBuffer[Int] = ListBuffer() @@ -42,7 +42,7 @@ Scala が標準ライブラリで提供する不変コレクションで最も ## 文字列ビルダ -配列バッファが配列を構築するのに便利で、リストバッファがリストを構築するのに便利なように、文字列ビルダ ([`StringBuilder`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/StringBuilder.html)) は文字列を構築するのに便利なものだ。文字列ビルダはあまりに頻繁に使われるため、デフォルトの名前空間に既にインポートされている。以下のように、単に `new StringBuilder` で文字列ビルダを作成することができる: +配列バッファが配列を構築するのに便利で、リストバッファがリストを構築するのに便利なように、文字列ビルダ ([`StringBuilder`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/StringBuilder.html)) は文字列を構築するのに便利なものだ。文字列ビルダはあまりに頻繁に使われるため、デフォルトの名前空間に既にインポートされている。以下のように、単に `new StringBuilder` で文字列ビルダを作成することができる: scala> val buf = new StringBuilder buf: StringBuilder = @@ -55,19 +55,19 @@ Scala が標準ライブラリで提供する不変コレクションで最も ## 連結リスト -連結リスト ([`LinkedList`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/LinkedList.html)) は、`next` ポインタにより連結されたノードから成る可変列だ。多くの言語では空の連結リストを表すのに `null` が選ばれるが、空の列も全ての列演算をサポートする必要があるため、Scala のコレクションでは `null` は都合が悪い。特に、`LinkedList.empty.isEmpty` は `true` を返すべきで、`NullPointerException` を発生させるべきではない。 代わりに、空の連結リストは `next` フィールドがノード自身を指すという特殊な方法で表現されている。不変リスト同様、連結リストは順列通りに探索するのに適している。また、連結リストは要素や他の連結リストを簡単に挿入できるように実装されている。 +連結リスト ([`LinkedList`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/LinkedList.html)) は、`next` ポインタにより連結されたノードから成る可変列だ。多くの言語では空の連結リストを表すのに `null` が選ばれるが、空の列も全ての列演算をサポートする必要があるため、Scala のコレクションでは `null` は都合が悪い。特に、`LinkedList.empty.isEmpty` は `true` を返すべきで、`NullPointerException` を発生させるべきではない。 代わりに、空の連結リストは `next` フィールドがノード自身を指すという特殊な方法で表現されている。不変リスト同様、連結リストは順列通りに探索するのに適している。また、連結リストは要素や他の連結リストを簡単に挿入できるように実装されている。 ## 双方向リスト -双方向リスト ([`DoubleLinkedList`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/DoubleLinkedList.html)) は、`next` の他に、現ノードの一つ前の要素を指す `prev` +双方向リスト ([`DoubleLinkedList`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/DoubleLinkedList.html)) は、`next` の他に、現ノードの一つ前の要素を指す `prev` というもう一つの可変フィールドがあることを除けば、単方向の連結リストに似ている。リンクが一つ増えたことで要素の削除が非常に高速になる。 ## 可変リスト -可変リスト ([`MutableList`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/MutableList.html)) は単方向連結リストとリスト終端の空ノードを参照するポインタから構成される。これにより、リストの最後への要素の追加が、終端ノードのためにリスト全体を探索しなくてよくなるため、定数時間の演算となる。[`MutableList`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/MutableList.html) は、現在 Scala の [`mutable.LinearSeq`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/LinearSeq.html) トレイトの標準実装だ。 +可変リスト ([`MutableList`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/MutableList.html)) は単方向連結リストとリスト終端の空ノードを参照するポインタから構成される。これにより、リストの最後への要素の追加が、終端ノードのためにリスト全体を探索しなくてよくなるため、定数時間の演算となる。[`MutableList`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/MutableList.html) は、現在 Scala の [`mutable.LinearSeq`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/LinearSeq.html) トレイトの標準実装だ。 ## キュー -Scala は不変キューの他に可変キュー ([`mutable.Queue`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/Queue.html)) も提供する。可変キューは不変のものと同じように使えるが、`enqueue` の代わりに `+=` と `++=` 演算子を使って加算する。また、可変キューの `dequeue` は先頭の要素を削除して、それを返す。次に具体例で説明する: +Scala は不変キューの他に可変キュー ([`mutable.Queue`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/Queue.html)) も提供する。可変キューは不変のものと同じように使えるが、`enqueue` の代わりに `+=` と `++=` 演算子を使って加算する。また、可変キューの `dequeue` は先頭の要素を削除して、それを返す。次に具体例で説明する: scala> val queue = new scala.collection.mutable.Queue[String] queue: scala.collection.mutable.Queue[String] = Queue() @@ -84,13 +84,13 @@ Scala は不変キューの他に可変キュー ([`mutable.Queue`](http://www.s ## 配列シーケンス -配列シーケンス ([`ArraySeq`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArraySeq.html)) は、内部で要素を `Array[Object]` に格納する固定長の可変列だ。 +配列シーケンス ([`ArraySeq`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ArraySeq.html)) は、内部で要素を `Array[Object]` に格納する固定長の可変列だ。 -典型的には、配列の性能特性が欲しいが、要素の型が特定できず、実行時に `ClassManifest` も無く、ジェネリックな列を作成したい場合に [`ArraySeq`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArraySeq.html) を使う。この問題は後ほど[配列の節](arrays.html)で説明する。 +典型的には、配列の性能特性が欲しいが、要素の型が特定できず、実行時に `ClassManifest` も無く、ジェネリックな列を作成したい場合に [`ArraySeq`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ArraySeq.html) を使う。この問題は後ほど[配列の節](arrays.html)で説明する。 ## スタック -既に不変スタックについては説明した。スタックには、[`mutable.Stack`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/Stack.html) クラスにより実装される可変バージョンもある。変更が上書き処理されるという違いの他は、不変バージョンと全く同じように動作する。 +既に不変スタックについては説明した。スタックには、[`mutable.Stack`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/Stack.html) クラスにより実装される可変バージョンもある。変更が上書き処理されるという違いの他は、不変バージョンと全く同じように動作する。 scala> val stack = new scala.collection.mutable.Stack[Int] stack: scala.collection.mutable.Stack[Int] = Stack() @@ -113,11 +113,11 @@ Scala は不変キューの他に可変キュー ([`mutable.Queue`](http://www.s ## 配列スタック -配列スタック ([`ArrayStack`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayStack.html) ) は、内部に必要に応じて大きさを変えた `Array` を使った、可変スタックの代替実装だ。配列スタックは、高速な添字読み込みを提供し、他の演算に関しても普通の可変スタックに比べて少し効率的だ。 +配列スタック ([`ArrayStack`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/ArrayStack.html) ) は、内部に必要に応じて大きさを変えた `Array` を使った、可変スタックの代替実装だ。配列スタックは、高速な添字読み込みを提供し、他の演算に関しても普通の可変スタックに比べて少し効率的だ。 ## ハッシュテーブル -ハッシュテーブルは、内部で要素を配列に格納し、要素の位置はハッシュコードにより決められる。ハッシュテーブルへの要素の追加は、既に配列の中に同じハッシュコードを持つ他の要素が無い限り、定数時間で行われる。そのため、ハッシュコードの分布が適度である限り非常に高速だ。結果として、Scala の可変マップと可変集合のデフォルトの実装はハッシュテーブルに基づいており、[`mutable.HashSet`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/HashSet.html) クラスと [`mutable.HashMap`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/HashMap.html) クラスから直接アクセスできる。 +ハッシュテーブルは、内部で要素を配列に格納し、要素の位置はハッシュコードにより決められる。ハッシュテーブルへの要素の追加は、既に配列の中に同じハッシュコードを持つ他の要素が無い限り、定数時間で行われる。そのため、ハッシュコードの分布が適度である限り非常に高速だ。結果として、Scala の可変マップと可変集合のデフォルトの実装はハッシュテーブルに基づいており、[`mutable.HashSet`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/HashSet.html) クラスと [`mutable.HashMap`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/HashMap.html) クラスから直接アクセスできる。 ハッシュ集合とハッシュマップは他の集合やマップと変りなく使うことができる。以下に具体例で説明する: @@ -136,11 +136,11 @@ Scala は不変キューの他に可変キュー ([`mutable.Queue`](http://www.s ## ウィークハッシュマップ -ウィークハッシュマップ（[`WeakHashMap`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/WeakHashMap.html)) は、ガーベッジコレクタがマップから「弱キー」への参照を追跡しないという特殊なハッシュマップだ。他にキーを参照するものが無くなると、キーとその関連する値はマップから勝手にいなくなる。ウィークハッシュマップは、キーに対する時間のかかる計算結果を再利用するキャッシュのような用途に向いている。キーとその計算結果が普通のハッシュマップに格納された場合、そのマップは限りなく大きくなり続け、キーはガベージコレクタに永遠に回収されない。ウィークハッシュマップを使うことでこの問題を回避できる。キーオブジェクトが到達不可能になり次第、そのエントリーごとウィークハッシュマップから削除される。Scala のウィークハッシュマップは、Java による実装 `java.util.WeakHashMap` のラッパーである [`WeakHashMap`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/WeakHashMap.html) クラスにより実装されている。 +ウィークハッシュマップ（[`WeakHashMap`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/WeakHashMap.html)) は、ガーベッジコレクタがマップから「弱キー」への参照を追跡しないという特殊なハッシュマップだ。他にキーを参照するものが無くなると、キーとその関連する値はマップから勝手にいなくなる。ウィークハッシュマップは、キーに対する時間のかかる計算結果を再利用するキャッシュのような用途に向いている。キーとその計算結果が普通のハッシュマップに格納された場合、そのマップは限りなく大きくなり続け、キーはガベージコレクタに永遠に回収されない。ウィークハッシュマップを使うことでこの問題を回避できる。キーオブジェクトが到達不可能になり次第、そのエントリーごとウィークハッシュマップから削除される。Scala のウィークハッシュマップは、Java による実装 `java.util.WeakHashMap` のラッパーである [`WeakHashMap`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/WeakHashMap.html) クラスにより実装されている。 ## 並行マップ -並行マップ (`ConcurrentMap`) は複数のスレッドから同時にアクセスすることできる。通常の[マップ](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Map.html)の演算の他に、以下のアトミックな演算を提供する: +並行マップ (`ConcurrentMap`) は複数のスレッドから同時にアクセスすることできる。通常の[マップ](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Map.html)の演算の他に、以下のアトミックな演算を提供する: ### ConcurrentMap クラスの演算 ### @@ -156,7 +156,7 @@ Scala は不変キューの他に可変キュー ([`mutable.Queue`](http://www.s ## 可変ビット集合 -可変ビット集合 ([`mutable.BitSet`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/BitSet.html)) は、変更が上書き処理される他は不変のものとほとんど同じだ。可変ビット集合は、変更しなかった `Long` をコピーしなくても済むぶん不変ビット集合に比べて少し効率的だ。 +可変ビット集合 ([`mutable.BitSet`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/BitSet.html)) は、変更が上書き処理される他は不変のものとほとんど同じだ。可変ビット集合は、変更しなかった `Long` をコピーしなくても済むぶん不変ビット集合に比べて少し効率的だ。 scala> val bits = scala.collection.mutable.BitSet.empty bits: scala.collection.mutable.BitSet = BitSet() diff --git a/_ja/overviews/collections/iterators.md b/_ja/overviews/collections/iterators.md index 4c2b700761..7ac3076e79 100644 --- a/_ja/overviews/collections/iterators.md +++ b/_ja/overviews/collections/iterators.md @@ -12,7 +12,7 @@ num: 15 language: ja --- -イテレータ ([`Iterator`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html)) はコレクションではなく、コレクションから要素を1つづつアクセスするための方法だ。イテレータ `it` に対する基本的な演算として `next` と `hasNext` の2つがある。 `it.next()` を呼び出すことで、次の要素が返り、イテレータの内部状態が前進する。よって、同じイテレータに対して `next` を再び呼び出すと、前回返したものの次の要素が得られる。返す要素が無くなると、`next` の呼び出しは `NoSuchElementException` を発生させる。返す要素が残っているかは [`Iterator`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html) の `hasNext` メソッドを使って調べることができる。 +イテレータ ([`Iterator`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html)) はコレクションではなく、コレクションから要素を1つづつアクセスするための方法だ。イテレータ `it` に対する基本的な演算として `next` と `hasNext` の2つがある。 `it.next()` を呼び出すことで、次の要素が返り、イテレータの内部状態が前進する。よって、同じイテレータに対して `next` を再び呼び出すと、前回返したものの次の要素が得られる。返す要素が無くなると、`next` の呼び出しは `NoSuchElementException` を発生させる。返す要素が残っているかは [`Iterator`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html) の `hasNext` メソッドを使って調べることができる。 イテレータ `it` が返す全ての要素を渡り歩くのに最も率直な方法は while ループを使うことだ: @@ -64,7 +64,7 @@ language: ja への呼び出しはイテレータ `it` と全く同じ要素を返すイテレータを**2つ**返す。この2つのイテレータは独立して作動するため、片方を前進しても他方は影響を受けない。一方、元のイテレータ `it` は `duplicate` により終端まで前進したため、使いものにならない。 要約すると、イテレータは**メソッドを呼び出した後、絶対にアクセスしなければ**コレクションのように振る舞う。Scala -コレクションライブラリは、[`Traversable`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Traversable.html) と [`Iterator`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html) に共通の親クラスである [`TraversableOnce`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/TraversableOnce.html) を提供することで、明示的にこれを示す。名前が示す通り、 `TraversableOnce` は `foreach` を用いて一度だけ探索することができるが、探索後のそのオブジェクトの状態は指定されていない。`TraversableOnce` オブジェクトが `Iterator` ならば、探索後はその終端にあるし、もし `Traversable` ならば、そのオブジェクトは今まで通り存在する。 `TraversableOnce` のよく使われる事例としては、イテレータか `Traversable` を受け取ることができるメソッドの引数の型だ。その例として、 `Traversable` クラスの追加メソッド `++` がある。`TraversableOnce` パラメータを受け取るため、イテレータか `Traversable` なコレクションの要素を追加することができる。 +コレクションライブラリは、[`Traversable`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Traversable.html) と [`Iterator`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html) に共通の親クラスである [`TraversableOnce`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/TraversableOnce.html) を提供することで、明示的にこれを示す。名前が示す通り、 `TraversableOnce` は `foreach` を用いて一度だけ探索することができるが、探索後のそのオブジェクトの状態は指定されていない。`TraversableOnce` オブジェクトが `Iterator` ならば、探索後はその終端にあるし、もし `Traversable` ならば、そのオブジェクトは今まで通り存在する。 `TraversableOnce` のよく使われる事例としては、イテレータか `Traversable` を受け取ることができるメソッドの引数の型だ。その例として、 `Traversable` クラスの追加メソッド `++` がある。`TraversableOnce` パラメータを受け取るため、イテレータか `Traversable` なコレクションの要素を追加することができる。 イテレータの全演算は次の表にまとめられている。 @@ -158,7 +158,7 @@ language: ja しかし、このコードを慎重に見ると間違っていることが分かるはずだ。コードは確かに先頭の空白文字列の続きを読み飛ばすが、`it` は最初の非空白文字列も追い越してしまっているのだ。 -この問題はバッファ付きイテレータを使うことで解決できる。[`BufferedIterator`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/BufferedIterator.html) トレイトは、`head` というメソッドを追加で提供する [`Iterator`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html) の子トレイトだ。バッファ付きイテレータに対して `head` を呼び出すことで、イテレータを前進させずに最初の要素を返すことができる。バッファ付きイテレータを使うと、空白文字列を読み飛ばすのは以下のように書ける。 +この問題はバッファ付きイテレータを使うことで解決できる。[`BufferedIterator`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/BufferedIterator.html) トレイトは、`head` というメソッドを追加で提供する [`Iterator`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html) の子トレイトだ。バッファ付きイテレータに対して `head` を呼び出すことで、イテレータを前進させずに最初の要素を返すことができる。バッファ付きイテレータを使うと、空白文字列を読み飛ばすのは以下のように書ける。 def skipEmptyWords(it: BufferedIterator[String]) = while (it.head.isEmpty) { it.next() } diff --git a/_ja/overviews/collections/overview.md b/_ja/overviews/collections/overview.md index 82a26ba556..83b514eb30 100644 --- a/_ja/overviews/collections/overview.md +++ b/_ja/overviews/collections/overview.md @@ -22,8 +22,8 @@ Scala のコレクションは、体系的に可変および不変コレクシ `scala.collection.mutable` パッケージのコレクションは、コレクションを上書き変更する演算がある。 だから可変コレクションを扱うということは、どのコードが、何時どのコレクションを変更したのかということを理解する必要があることを意味する。 -`scala.collection` パッケージのコレクションは、可変か不変かのどちらでもありうる。例えば [`collection.IndexedSeq[T]`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/IndexedSeq.html) -は、[`collection.immutable.IndexedSeq[T]`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/IndexedSeq.html) と [`collection.mutable.IndexedSeq[T]`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/IndexedSeq.html) 両方の親クラスだ。一般的に、`scala.collection`パッケージの基底コレクションは不変コレクションと同じインターフェイスを定義し、`scala.collection.mutable` パッケージ内の可変コレクションは、副作用を伴う変更演算を不変インターフェイスに加える。 +`scala.collection` パッケージのコレクションは、可変か不変かのどちらでもありうる。例えば [`collection.IndexedSeq[T]`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/IndexedSeq.html) +は、[`collection.immutable.IndexedSeq[T]`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/IndexedSeq.html) と [`collection.mutable.IndexedSeq[T]`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/IndexedSeq.html) 両方の親クラスだ。一般的に、`scala.collection`パッケージの基底コレクションは不変コレクションと同じインターフェイスを定義し、`scala.collection.mutable` パッケージ内の可変コレクションは、副作用を伴う変更演算を不変インターフェイスに加える。 基底コレクションと不変コレクションの違いは、不変なコレクションのクライアントは、他の誰もコレクションを変更しないという保証があるのに対し、基底コレクションのクライアントは自分ではコレクションを変更しなかったという約束しかできない。たとえ静的な型がコレクションを変更するような演算を提供していなくても、実行時の型は他のクライアントが手を加えることができる可変コレクションである可能性がある。 @@ -40,7 +40,7 @@ Scala のコレクションは、体系的に可変および不変コレクシ このパッケージには、コレクションを実装するための基本的なパーツが含まれている。 コレクションクラスがいくつかの演算を `generic` 内のクラスに委譲することはよくあるが、 フレームワークのユーザーが `generic` 内のクラスが必要になることは普通はありえない。 -利便性と後方互換性のために、いくつかの重要な型は `scala` パッケージ内に別名を定義してあるため、インポート無しで単純な名前でコレクションを使うことができる。[`List`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/List.html) 型が良い例で、以下の名前でもアクセスすることができる +利便性と後方互換性のために、いくつかの重要な型は `scala` パッケージ内に別名を定義してあるため、インポート無しで単純な名前でコレクションを使うことができる。[`List`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/List.html) 型が良い例で、以下の名前でもアクセスすることができる scala.collection.immutable.List // 定義元 scala.List // scala パッケージのエイリアス経由 @@ -48,7 +48,7 @@ Scala のコレクションは、体系的に可変および不変コレクシ // 常に自動的にインポートされるため エイリアスされているその他の型は次のとおり: -[`Traversable`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Traversable.html)、[`Iterable`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterable.html)、[`Seq`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Seq.html)、[`IndexedSeq`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/IndexedSeq.html)、[`Iterator`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html)、[`Stream`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Stream.html)、[`Vector`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html)、[`StringBuilder`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/StringBuilder.html)、[`Range`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html)。 +[`Traversable`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Traversable.html)、[`Iterable`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterable.html)、[`Seq`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Seq.html)、[`IndexedSeq`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/IndexedSeq.html)、[`Iterator`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html)、[`Stream`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Stream.html)、[`Vector`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html)、[`StringBuilder`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/StringBuilder.html)、[`Range`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html)。 次の図は `scala.collection` パッケージ内の全てのコレクションを示す。 これらはすべて、高レベルの抽象クラスやトレイトで一般に可変と不変の両方の実装を持っている。 diff --git a/_ja/overviews/collections/trait-traversable.md b/_ja/overviews/collections/trait-traversable.md index eed29ac4de..52c14efb64 100644 --- a/_ja/overviews/collections/trait-traversable.md +++ b/_ja/overviews/collections/trait-traversable.md @@ -12,7 +12,7 @@ num: 3 language: ja --- -走査可能 ([`Traversable`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Traversable.html))トレイトはコレクション階層の最上位に位置する。訳注: 木構造などでノードを一つづつ走査することを traverse と言う。また、-able で終わるトレイトは名詞としても使われるため、「走査可能なもの」という意味だ。 `Traversable` の抽象的な演算は `foreach` のみだ: +走査可能 ([`Traversable`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Traversable.html))トレイトはコレクション階層の最上位に位置する。訳注: 木構造などでノードを一つづつ走査することを traverse と言う。また、-able で終わるトレイトは名詞としても使われるため、「走査可能なもの」という意味だ。 `Traversable` の抽象的な演算は `foreach` のみだ: def foreach[U](f: Elem => U) @@ -52,7 +52,7 @@ language: ja | **抽象メソッド:** | | | `xs foreach f` |`xs` 内の全ての要素に対して関数 `f` を実行する。 | | **加算:** | | -| `xs ++ ys` |`xs` と `ys` の両方の要素から成るコレクション。 `ys` は [`TraversableOnce`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/TraversableOnce.html) なコレクション、つまり [`Traversable`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Traversable.html) または [`Iterator`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html) だ。| +| `xs ++ ys` |`xs` と `ys` の両方の要素から成るコレクション。 `ys` は [`TraversableOnce`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/TraversableOnce.html) なコレクション、つまり [`Traversable`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Traversable.html) または [`Iterator`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html) だ。| | **map 演算:** | | | `xs map f` |`xs` 内の全ての要素に関数 `f` を適用することによって得られるコレクション。| | `xs flatMap f` |`xs` 内の全ての要素に対してコレクション値を返す関数 `f` を適用し、その結果を連結したコレクション。| diff --git a/_ja/overviews/parallel-collections/concrete-parallel-collections.md b/_ja/overviews/parallel-collections/concrete-parallel-collections.md index 1681cfa468..4951280848 100644 --- a/_ja/overviews/parallel-collections/concrete-parallel-collections.md +++ b/_ja/overviews/parallel-collections/concrete-parallel-collections.md @@ -13,7 +13,7 @@ language: ja ## 並列配列 -並列配列 ([`ParArray`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/mutable/ParArray.html)) は、線形で連続的な要素の配列を保持する列だ。 +並列配列 ([`ParArray`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/mutable/ParArray.html)) は、線形で連続的な要素の配列を保持する列だ。 そのため、内部の配列を変更することで効率的な要素の読み込みや更新ができるようになる。 また、要素の走査も非常に効率的だ。 並列配列は、サイズが一定であるという意味で配列と似ている。 @@ -38,7 +38,7 @@ language: ja ## 並列ベクトル -並列ベクトル ([`ParVector`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParVector.html)) +並列ベクトル ([`ParVector`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParVector.html)) は、低い定数係数の対数時間で読み込みと書き込みを行う不変列だ。 scala> val pv = scala.collection.parallel.immutable.ParVector.tabulate(1000)(x => x) @@ -52,13 +52,13 @@ language: ja このため、変換メソッドは並列配列のそれに比べてスケーラビリティが低い。 ベクトルの連結が将来の Scala リリースで提供されるようになれば、コンバイナは連結を用いて合成できるようになり、変換メソッドはより効率的になる。 -並列ベクトルは、順次[ベクトル](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html)の並列版で、定数時間で一方から他方へと変換できる。 +並列ベクトルは、順次[ベクトル](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html)の並列版で、定数時間で一方から他方へと変換できる。 ## 並列範囲 -並列範囲 ([`ParRange`](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParRange.html)) +並列範囲 ([`ParRange`](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParRange.html)) は、順序付けされた等間隔の要素の列だ。 -並列範囲は、逐次版の [Range](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html) と同様に作成される: +並列範囲は、逐次版の [Range](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html) と同様に作成される: scala> 1 to 3 par res0: scala.collection.parallel.immutable.ParRange = ParRange(1, 2, 3) @@ -74,8 +74,8 @@ language: ja 並列ハッシュテーブルは要素を内部の配列に格納し、各要素のハッシュコードにより格納する位置を決定する。 並列可変ハッシュ集合 ( -[mutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/mutable/ParHashSet.html)) -と並列可変ハッシュマップ ([mutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/mutable/ParHashMap.html)) +[mutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/mutable/ParHashSet.html)) +と並列可変ハッシュマップ ([mutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/mutable/ParHashMap.html)) はハッシュテーブルに基づいている。 scala> val phs = scala.collection.parallel.mutable.ParHashSet(1 until 2000: _*) @@ -100,8 +100,8 @@ language: ja ## 並列ハッシュトライ 並列ハッシュトライは、不変集合と不変マップを効率的に表す不変ハッシュトライの並列版だ。 -これらは、[immutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParHashSet.html) クラスと -[immutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/immutable/ParHashMap.html) クラスにより提供される。 +これらは、[immutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParHashSet.html) クラスと +[immutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/immutable/ParHashMap.html) クラスにより提供される。 scala> val phs = scala.collection.parallel.immutable.ParHashSet(1 until 1000: _*) phs: scala.collection.parallel.immutable.ParHashSet[Int] = ParSet(645, 892, 69, 809, 629, 365, 138, 760, 101, 479,... @@ -115,9 +115,9 @@ language: ja ## 並列並行トライ -[concurrent.TrieMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html) +[concurrent.TrieMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/concurrent/TrieMap.html) は、複数のスレッドから同時にアクセスできる (concurrent thread-safe) マップだが、 -[mutable.ParTrieMap](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/mutable/ParTrieMap.html) +[mutable.ParTrieMap](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/mutable/ParTrieMap.html) は、その並列版だ。 並列データ構造の多くは、走査時にデータ構造が変更された場合に一貫性のある走査を保証しないが、並行トライは更新が次回の走査まで見えないことを保証する。 つまり以下の 1 から 99 の数の平方根を出力する例のように、並行トライを走査中に変更できるようになる: diff --git a/_ko/tour/annotations.md b/_ko/tour/annotations.md index 4e2cba3524..e4674f5bbc 100644 --- a/_ko/tour/annotations.md +++ b/_ko/tour/annotations.md @@ -27,7 +27,6 @@ previous-page: automatic-closures | [`scala.deprecated`](https://www.scala-lang.org/api/current/scala/deprecated.html) | [`java.lang.Deprecated`](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Deprecated.html) | | [`scala.inline`](https://www.scala-lang.org/api/current/scala/inline.html) (2.6.0 부터) | 해당 없음 | | [`scala.native`](https://www.scala-lang.org/api/current/scala/native.html) (2.6.0 부터) | [`native`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (키워드) | -| [`scala.remote`](https://www.scala-lang.org/api/current/scala/remote.html) | [`java.rmi.Remote`](http://java.sun.com/j2se/1.5.0/docs/api/java/rmi/Remote.html) | | [`scala.throws`](https://www.scala-lang.org/api/current/scala/throws.html) | [`throws`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (키워드) | | [`scala.transient`](https://www.scala-lang.org/api/current/scala/transient.html) | [`transient`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (키워드) | | [`scala.unchecked`](https://www.scala-lang.org/api/current/scala/unchecked.html) (2.4.0 부터) | 해당 없음 | diff --git a/_overviews/collections/trait-traversable.md b/_overviews/collections/trait-traversable.md index ad749d8097..fe048347ec 100644 --- a/_overviews/collections/trait-traversable.md +++ b/_overviews/collections/trait-traversable.md @@ -44,7 +44,7 @@ The `foreach` method is meant to traverse all elements of the collection, and ap | **Abstract Method:** | | | `xs foreach f` |Executes function `f` for every element of `xs`.| | **Addition:** | | -| `xs ++ ys` |A collection consisting of the elements of both `xs` and `ys`. `ys` is a [TraversableOnce](http://www.scala-lang.org/api/current/scala/collection/TraversableOnce.html) collection, i.e., either a [Traversable](http://www.scala-lang.org/api/current/scala/collection/Traversable.html) or an [Iterator](http://www.scala-lang.org/api/current/scala/collection/Iterator.html).| +| `xs ++ ys` |A collection consisting of the elements of both `xs` and `ys`. `ys` is a [TraversableOnce](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/TraversableOnce.html) collection, i.e., either a [Traversable](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Traversable.html) or an [Iterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html).| | **Maps:** | | | `xs map f` |The collection obtained from applying the function f to every element in `xs`.| | `xs flatMap f` |The collection obtained from applying the collection-valued function `f` to every element in `xs` and concatenating the results.| diff --git a/_pl/tour/annotations.md b/_pl/tour/annotations.md index 65921a156f..70feceffde 100644 --- a/_pl/tour/annotations.md +++ b/_pl/tour/annotations.md @@ -26,7 +26,6 @@ Znaczenie adnotacji jest zależne od implementacji. Na platformie Java poniższe | [`scala.deprecated`](https://www.scala-lang.org/api/current/scala/deprecated.html) | [`java.lang.Deprecated`](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Deprecated.html) | | [`scala.inline`](https://www.scala-lang.org/api/current/scala/inline.html) (since 2.6.0) | brak odpowiednika | | [`scala.native`](https://www.scala-lang.org/api/current/scala/native.html) (since 2.6.0) | [`native`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (słowo kluczowe) | -| [`scala.remote`](https://www.scala-lang.org/api/current/scala/remote.html) | [`java.rmi.Remote`](http://java.sun.com/j2se/1.5.0/docs/api/java/rmi/Remote.html) | | [`scala.throws`](https://www.scala-lang.org/api/current/scala/throws.html) | [`throws`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (słowo kluczowe) | | [`scala.transient`](https://www.scala-lang.org/api/current/scala/transient.html) | [`transient`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (słowo kluczowe) | | [`scala.unchecked`](https://www.scala-lang.org/api/current/scala/unchecked.html) (od 2.4.0) | brak odpowiednika | diff --git a/_pt-br/tour/annotations.md b/_pt-br/tour/annotations.md index 3b262897de..1ae94788c7 100644 --- a/_pt-br/tour/annotations.md +++ b/_pt-br/tour/annotations.md @@ -26,7 +26,6 @@ O significado das cláusulas de anotação é _dependente da implementação_. N | [`scala.deprecated`](https://www.scala-lang.org/api/current/scala/deprecated.html) | [`java.lang.Deprecated`](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Deprecated.html) | | [`scala.inline`](https://www.scala-lang.org/api/current/scala/inline.html) (desde 2.6.0) | não há equivalente | | [`scala.native`](https://www.scala-lang.org/api/current/scala/native.html) (desde 2.6.0) | [`native`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (keyword) | -| [`scala.remote`](https://www.scala-lang.org/api/current/scala/remote.html) | [`java.rmi.Remote`](http://java.sun.com/j2se/1.5.0/docs/api/java/rmi/Remote.html) | | [`scala.throws`](https://www.scala-lang.org/api/current/scala/throws.html) | [`throws`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (keyword) | | [`scala.transient`](https://www.scala-lang.org/api/current/scala/transient.html) | [`transient`](http://java.sun.com/docs/books/tutorial/java/nutsandbolts/_keywords.html) (keyword) | | [`scala.unchecked`](https://www.scala-lang.org/api/current/scala/unchecked.html) (since 2.4.0) | não há equivalente | diff --git a/_zh-cn/overviews/collections/overview.md b/_zh-cn/overviews/collections/overview.md index 26d5e90771..3d2391a12e 100644 --- a/_zh-cn/overviews/collections/overview.md +++ b/_zh-cn/overviews/collections/overview.md @@ -20,7 +20,7 @@ Scala 集合类系统地区分了可变的和不可变的集合。可变集合 `scala.collection.mutable`包的集合类则有一些操作可以修改集合。所以处理可变集合意味着你需要去理解哪些代码的修改会导致集合同时改变。 -`scala.collection`包中的集合，既可以是可变的，也可以是不可变的。例如：[collection.IndexedSeq[T]](http://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html)] 就是 [collection.immutable.IndexedSeq[T]](http://www.scala-lang.org/api/current/scala/collection/immutable/IndexedSeq.html) 和[collection.mutable.IndexedSeq[T]](http://www.scala-lang.org/api/current/scala/collection/mutable/IndexedSeq.html)这两类的超类。`scala.collection`包中的根集合类中定义了相同的接口作为不可变集合类，同时，`scala.collection.mutable`包中的可变集合类代表性的添加了一些有辅助作用的修改操作到这个immutable 接口。 +`scala.collection`包中的集合，既可以是可变的，也可以是不可变的。例如：[collection.IndexedSeq[T]](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/IndexedSeq.html)] 就是 [collection.immutable.IndexedSeq[T]](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/IndexedSeq.html) 和[collection.mutable.IndexedSeq[T]](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/IndexedSeq.html)这两类的超类。`scala.collection`包中的根集合类中定义了相同的接口作为不可变集合类，同时，`scala.collection.mutable`包中的可变集合类代表性的添加了一些有辅助作用的修改操作到这个immutable 接口。 根集合类与不可变集合类之间的区别是不可变集合类的客户端可以确保没有人可以修改集合。然而，根集合类的客户端仅保证不修改集合本身。即使这个集合类没有提供修改集合的静态操作，它仍然可能在运行时作为可变集合被其它客户端所修改。 @@ -41,7 +41,7 @@ Scala 集合类系统地区分了可变的和不可变的集合。可变集合 List // 因为scala._ // 总是是被自动导入。 -其它类型的别名有： [Traversable](http://www.scala-lang.org/api/current/scala/collection/Traversable.html), [Iterable](http://www.scala-lang.org/api/current/scala/collection/Iterable.html), [Seq](http://www.scala-lang.org/api/current/scala/collection/Seq.html), [IndexedSeq](http://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html), [Iterator](http://www.scala-lang.org/api/current/scala/collection/Iterator.html), [Stream](http://www.scala-lang.org/api/current/scala/collection/immutable/Stream.html), [Vector](http://www.scala-lang.org/api/current/scala/collection/immutable/Vector.html), [StringBuilder](http://www.scala-lang.org/api/current/scala/collection/mutable/StringBuilder.html), [Range](http://www.scala-lang.org/api/current/scala/collection/immutable/Range.html)。 +其它类型的别名有： [Traversable](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Traversable.html), [Iterable](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterable.html), [Seq](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Seq.html), [IndexedSeq](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/IndexedSeq.html), [Iterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html), [Stream](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Stream.html), [Vector](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html), [StringBuilder](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/StringBuilder.html), [Range](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html)。 下面的图表显示了`scala.collection`包中所有的集合类。这些都是高级抽象类或特性，它们通常具备和不可变实现一样的可变实现。 From f6431aae58c113fe6a3be8a193892149887a977d Mon Sep 17 00:00:00 2001 From: Dale Wijnand Date: Tue, 11 Jun 2019 07:57:25 +0200 Subject: [PATCH 0531/3075] Reorder and retitle the collection guides --- _data/overviews.yml | 94 ++++++++++++++++++++++----------------------- 1 file changed, 47 insertions(+), 47 deletions(-) diff --git a/_data/overviews.yml b/_data/overviews.yml index 0b5470023e..bfc4c293ed 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -2,53 +2,6 @@ - category: Standard Library description: "Guides and overviews covering the Scala standard library." overviews: - - title: Collections - by: Martin Odersky - icon: sitemap - url: "collections/introduction.html" - description: "Scala's Collection Library." - subdocs: - - title: Introduction - url: "collections/introduction.html" - - title: Mutable and Immutable Collections - url: "collections/overview.html" - - title: Trait Traversable - url: "collections/trait-traversable.html" - - title: Trait Iterable - url: "collections/trait-iterable.html" - - title: The sequence traits Seq, IndexedSeq, and LinearSeq - url: "collections/seqs.html" - - title: Sets - url: "collections/sets.html" - - title: Maps - url: "collections/maps.html" - - title: Concrete Immutable Collection Classes - url: "collections/concrete-immutable-collection-classes.html" - - title: Concrete Mutable Collection Classes - url: "collections/concrete-mutable-collection-classes.html" - - title: Arrays - url: "collections/arrays.html" - - title: Strings - url: "collections/strings.html" - - title: Performance Characteristics - url: "collections/performance-characteristics.html" - - title: Equality - url: "collections/equality.html" - - title: Views - url: "collections/views.html" - - title: Iterators - url: "collections/iterators.html" - - title: Creating Collections From Scratch - url: "collections/creating-collections-from-scratch.html" - - title: Conversions Between Java and Scala Collections - url: "collections/conversions-between-java-and-scala-collections.html" - - title: Migrating from Scala 2.7 - url: "collections/migrating-from-scala-27.html" - - title: The Architecture of Scala Collections - icon: building - url: "core/architecture-of-scala-collections.html" - by: Martin Odersky and Lex Spoon - description: "These pages describe the architecture of the Scala collections framework in detail. Compared to the Collections API you will find out more about the internal workings of the framework. You will also learn how this architecture helps you define your own collections in a few lines of code, while reusing the overwhelming part of collection functionality from the framework." - title: Scala 2.13’s Collections by: Martin Odersky and Julien Richard-Foy icon: sitemap @@ -102,6 +55,53 @@ url: "core/custom-collection-operations.html" by: Julien Richard-Foy description: "This guide shows how to write operations that can be applied to any collection type and return the same collection type, and how to write operations that can be parameterized by the type of collection to build." + - title: Scala 2.8 to 2.12’s Collections + by: Martin Odersky + icon: sitemap + url: "collections/introduction.html" + description: "Scala's Collection Library." + subdocs: + - title: Introduction + url: "collections/introduction.html" + - title: Mutable and Immutable Collections + url: "collections/overview.html" + - title: Trait Traversable + url: "collections/trait-traversable.html" + - title: Trait Iterable + url: "collections/trait-iterable.html" + - title: The sequence traits Seq, IndexedSeq, and LinearSeq + url: "collections/seqs.html" + - title: Sets + url: "collections/sets.html" + - title: Maps + url: "collections/maps.html" + - title: Concrete Immutable Collection Classes + url: "collections/concrete-immutable-collection-classes.html" + - title: Concrete Mutable Collection Classes + url: "collections/concrete-mutable-collection-classes.html" + - title: Arrays + url: "collections/arrays.html" + - title: Strings + url: "collections/strings.html" + - title: Performance Characteristics + url: "collections/performance-characteristics.html" + - title: Equality + url: "collections/equality.html" + - title: Views + url: "collections/views.html" + - title: Iterators + url: "collections/iterators.html" + - title: Creating Collections From Scratch + url: "collections/creating-collections-from-scratch.html" + - title: Conversions Between Java and Scala Collections + url: "collections/conversions-between-java-and-scala-collections.html" + - title: Migrating from Scala 2.7 + url: "collections/migrating-from-scala-27.html" + - title: The Architecture of Scala 2.8 to 2.12’s Collections + icon: building + url: "core/architecture-of-scala-collections.html" + by: Martin Odersky and Lex Spoon + description: "These pages describe the architecture of the Scala collections framework in detail. Compared to the Collections API you will find out more about the internal workings of the framework. You will also learn how this architecture helps you define your own collections in a few lines of code, while reusing the overwhelming part of collection functionality from the framework." - category: Language description: "Guides and overviews covering features in the Scala language." From 6e177b98b9752e80dd3cae77ff37ae37fb8738aa Mon Sep 17 00:00:00 2001 From: Dale Wijnand Date: Mon, 24 Jun 2019 07:51:13 +0100 Subject: [PATCH 0532/3075] Fix links, take 3 --- _overviews/collections/overview.md | 8 ++++---- .../concrete-parallel-collections.md | 14 +++++++------- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/_overviews/collections/overview.md b/_overviews/collections/overview.md index a394241837..41bdf6ff39 100644 --- a/_overviews/collections/overview.md +++ b/_overviews/collections/overview.md @@ -41,10 +41,10 @@ mutable collection means you need to understand which code changes which collection when. A collection in package `scala.collection` can be either mutable or -immutable. For instance, [collection.IndexedSeq\[T\]](http://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html) -is a superclass of both [collection.immutable.IndexedSeq\[T\]](http://www.scala-lang.org/api/current/scala/collection/immutable/IndexedSeq.html) +immutable. For instance, [collection.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/IndexedSeq.html) +is a superclass of both [collection.immutable.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/IndexedSeq.html) and -[collection.mutable.IndexedSeq\[T\]](http://www.scala-lang.org/api/current/scala/collection/mutable/IndexedSeq.html) +[collection.mutable.IndexedSeq\[T\]](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/IndexedSeq.html) Generally, the root collections in package `scala.collection` define the same interface as the immutable collections, and the mutable collections in package @@ -94,7 +94,7 @@ can be accessed alternatively as // is always automatically imported Other types aliased are -[Traversable](http://www.scala-lang.org/api/current/scala/collection/Traversable.html), [Iterable](http://www.scala-lang.org/api/current/scala/collection/Iterable.html), [Seq](http://www.scala-lang.org/api/current/scala/collection/Seq.html), [IndexedSeq](http://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html), [Iterator](http://www.scala-lang.org/api/current/scala/collection/Iterator.html), [Stream](http://www.scala-lang.org/api/current/scala/collection/immutable/Stream.html), [Vector](http://www.scala-lang.org/api/current/scala/collection/immutable/Vector.html), [StringBuilder](http://www.scala-lang.org/api/current/scala/collection/mutable/StringBuilder.html), and [Range](http://www.scala-lang.org/api/current/scala/collection/immutable/Range.html). +[Traversable](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Traversable.html), [Iterable](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterable.html), [Seq](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Seq.html), [IndexedSeq](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/IndexedSeq.html), [Iterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html), [Stream](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Stream.html), [Vector](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html), [StringBuilder](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/mutable/StringBuilder.html), and [Range](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html). The following figure shows all collections in package `scala.collection`. These are all high-level abstract classes or traits, which diff --git a/_ru/overviews/parallel-collections/concrete-parallel-collections.md b/_ru/overviews/parallel-collections/concrete-parallel-collections.md index f0985016b8..7dc087e280 100644 --- a/_ru/overviews/parallel-collections/concrete-parallel-collections.md +++ b/_ru/overviews/parallel-collections/concrete-parallel-collections.md @@ -13,7 +13,7 @@ num: 2 ## Параллельный Массив -Последовательность [ParArray](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/mutable/ParArray.html) хранит линейный массив смежно хранимых элементов. Это означает, что получение доступа и обновление элементов эффективно, так как происходит путем изменения массива, лежащего в основе. По этой причине наиболее эффективна последовательная обработка элементов одного за другим. Параллельные массивы похожи на обычные в том отношении, что их размер постоянен. +Последовательность [ParArray](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/mutable/ParArray.html) хранит линейный массив смежно хранимых элементов. Это означает, что получение доступа и обновление элементов эффективно, так как происходит путем изменения массива, лежащего в основе. По этой причине наиболее эффективна последовательная обработка элементов одного за другим. Параллельные массивы похожи на обычные в том отношении, что их размер постоянен. scala> val pa = scala.collection.parallel.mutable.ParArray.tabulate(1000)(x => 2 * x + 1) pa: scala.collection.parallel.mutable.ParArray[Int] = ParArray(1, 3, 5, 7, 9, 11, 13,... @@ -30,7 +30,7 @@ num: 2 ## Параллельный вектор -[ParVector](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/immutable/ParVector.html) является неизменяемой последовательностью, временная сложность доступа и обновления которой является логарифмической с низкой константой-множителем. +[ParVector](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/immutable/ParVector.html) является неизменяемой последовательностью, временная сложность доступа и обновления которой является логарифмической с низкой константой-множителем. scala> val pv = scala.collection.parallel.immutable.ParVector.tabulate(1000)(x => x) pv: scala.collection.parallel.immutable.ParVector[Int] = ParVector(0, 1, 2, 3, 4, 5, 6, 7, 8, 9,... @@ -41,11 +41,11 @@ num: 2 Неизменяемые векторы представлены 32-ичными деревьями (32-way trees), поэтому [разделители]({{ site.baseurl }}/ru/overviews/parallel-collections/architecture.html) разбивают их, назначая по поддереву каждому новому разделителю. [Компоновщики]({{ site.baseurl }}/ru/overviews/parallel-collections/architecture.html) в настоящий момент хранят вектор из элементов и компонуют путем отложенного копирования. По этой причине методы трансформации менее масштабируемы по сравнению с теми же методами параллельного массива. Как только в будущем релизе Scala станет доступной операция конкатенации векторов, компоновщики станут образовываться путем конкатенации, и от этого методы трансформации станут гораздо более эффективными. -Параллельный вектор является параллельным аналогом последовательной коллекции [Vector](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html), и преобразования одного в другое занимают постоянное время. +Параллельный вектор является параллельным аналогом последовательной коллекции [Vector](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Vector.html), и преобразования одного в другое занимают постоянное время. ## Параллельный диапазон -[ParRange](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParRange.html) представляет собой упорядоченную последовательность элементов, отстоящих друг от друга на одинаковые промежутки. Параллельный диапазон создается подобно последовательному [Range](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Range.html): +[ParRange](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParRange.html) представляет собой упорядоченную последовательность элементов, отстоящих друг от друга на одинаковые промежутки. Параллельный диапазон создается подобно последовательному [Range](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html): scala> 1 to 3 par res0: scala.collection.parallel.immutable.ParRange = ParRange(1, 2, 3) @@ -57,7 +57,7 @@ num: 2 ## Параллельные хэш-таблицы -В основе параллельной хэш-таблицы лежит массив, причем место элемента таблицы в этом массиве определяется хэш-кодом элемента. На хэш-таблицах основаны параллельные изменяемые хэш-множества ([mutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/mutable/ParHashSet.html)) и параллельные изменяемые ассоциативные хэш-массивы (хэш-отображения) ([mutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/mutable/ParHashMap.html)). +В основе параллельной хэш-таблицы лежит массив, причем место элемента таблицы в этом массиве определяется хэш-кодом элемента. На хэш-таблицах основаны параллельные изменяемые хэш-множества ([mutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/mutable/ParHashSet.html)) и параллельные изменяемые ассоциативные хэш-массивы (хэш-отображения) ([mutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/mutable/ParHashMap.html)). scala> val phs = scala.collection.parallel.mutable.ParHashSet(1 until 2000: _*) phs: scala.collection.parallel.mutable.ParHashSet[Int] = ParHashSet(18, 327, 736, 1045, 773, 1082,... @@ -71,7 +71,7 @@ num: 2 ## Параллельные префиксные хэш-деревья (Hash Tries) -Параллельные префиксные хэш-деревья являются параллельным аналогом неизменяемых префиксных хэш-деревьев, которые используются для эффективного представления неизменяемых множеств и ассоциативных массивов. Последние представлены классами [immutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/parallel/immutable/ParHashSet.html) и [immutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/immutable/ParHashMap.html). +Параллельные префиксные хэш-деревья являются параллельным аналогом неизменяемых префиксных хэш-деревьев, которые используются для эффективного представления неизменяемых множеств и ассоциативных массивов. Последние представлены классами [immutable.ParHashSet](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParHashSet.html) и [immutable.ParHashMap](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/immutable/ParHashMap.html). scala> val phs = scala.collection.parallel.immutable.ParHashSet(1 until 1000: _*) phs: scala.collection.parallel.immutable.ParHashSet[Int] = ParSet(645, 892, 69, 809, 629, 365, 138, 760, 101, 479,... @@ -85,7 +85,7 @@ num: 2 ## Параллельные многопоточные префиксные деревья (Concurrent Tries) -Параллельным аналогом коллекции [concurrent.TrieMap](http://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), представляющей собой многопоточный и потокозащищеный ассоциативный массив, является коллекция [mutable.ParTrieMap](http://www.scala-lang.org/api/{{ site.scala-version}}/scala/collection/parallel/mutable/ParTrieMap.html). В то время, как большинство многопоточных структур данных не гарантируют правильного перебора элементов в случае, если эта структура данных была изменена во время ее прохождения, многопоточные деревья `Ctries` гарантируют, что обновленные данные станут видны только при следующем прохождении. Это означает, что можно изменять многопоточное дерево прямо во время прохождения, как в следующем примере, в котором выводятся квадратные корни от 1 до 99: +Параллельным аналогом коллекции [concurrent.TrieMap](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/concurrent/TrieMap.html), представляющей собой многопоточный и потокозащищеный ассоциативный массив, является коллекция [mutable.ParTrieMap](http://www.scala-lang.org/api/{{ site.scala-212-version}}/scala/collection/parallel/mutable/ParTrieMap.html). В то время, как большинство многопоточных структур данных не гарантируют правильного перебора элементов в случае, если эта структура данных была изменена во время ее прохождения, многопоточные деревья `Ctries` гарантируют, что обновленные данные станут видны только при следующем прохождении. Это означает, что можно изменять многопоточное дерево прямо во время прохождения, как в следующем примере, в котором выводятся квадратные корни от 1 до 99: scala> val numbers = scala.collection.parallel.mutable.ParTrieMap((1 until 100) zip (1 until 100): _*) map { case (k, v) => (k.toDouble, v.toDouble) } numbers: scala.collection.parallel.mutable.ParTrieMap[Double,Double] = ParTrieMap(0.0 -> 0.0, 42.0 -> 42.0, 70.0 -> 70.0, 2.0 -> 2.0,... From 37f64a196bb756d7bc85ac845741b248d7ddd5c6 Mon Sep 17 00:00:00 2001 From: Dale Wijnand <344610+dwijnand@users.noreply.github.com> Date: Sun, 23 Jun 2019 14:40:24 +0100 Subject: [PATCH 0533/3075] Rebrand MiMa & clarify recommended version scheme --- ...binary-compatibility-for-library-authors.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/_overviews/tutorials/binary-compatibility-for-library-authors.md b/_overviews/tutorials/binary-compatibility-for-library-authors.md index 655317c95d..79efcdc29b 100644 --- a/_overviews/tutorials/binary-compatibility-for-library-authors.md +++ b/_overviews/tutorials/binary-compatibility-for-library-authors.md @@ -143,11 +143,11 @@ How can we, as library authors, spare our users of runtime errors and dependency ## MiMa - Checking binary compatibility against previous library versions -The [Migration Manager for Scala](https://github.com/lightbend/migration-manager) (MiMa) is a tool for diagnosing binary incompatibilities between different library versions. +[MiMa](https://github.com/lightbend/mima) is a tool for diagnosing binary incompatibilities between different library versions. It works by comparing the class files of two provided JARs and report any binary incompatibilities found. Both backwards and forwards binary incompatibility can be detected by swapping input order of the JARs. -By incorporating MiMa's [sbt plugin](https://github.com/lightbend/migration-manager/wiki/sbt-plugin) into your sbt build, you can easily check whether +By incorporating MiMa's [sbt plugin](https://github.com/lightbend/mima/wiki/sbt-plugin) into your sbt build, you can easily check whether you have accidentally introduced binary incompatible changes. Detailed instruction on how to use the sbt plugin can be found in the link. We strongly encourage every library author to incorporate MiMa into their continuous integration and release workflow. @@ -175,7 +175,7 @@ Again, we recommend using MiMa to double check that you have not broken binary c ## Versioning Scheme - Communicating compatibility breakages -Library authors use versioning schemes to communicate compatibility guarantees between library releases to their users. Versioning schemes like [Semantic Versioning](http://semver.org/)(SemVer) allow +Library authors use versioning schemes to communicate compatibility guarantees between library releases to their users. Versioning schemes like [Semantic Versioning](http://semver.org/) (SemVer) allow users to easily reason about the impact of updating a library, without needing to read the detailed release notes. In the following section, we will outline a versioning scheme based on Semantic Versioning that we **strongly encourage** you to adopt for your libraries. The rules listed below are **in addition** to @@ -183,12 +183,16 @@ Semantic Versioning v2.0.0. ### Recommended Versioning Scheme -* If backward **binary compatibility** is broken, **major version number** must be increased. -* If backward **source compatibility** is broken, **minor version number** must be increased. -* A change in **patch version number** signals **neither binary nor source incompatibility**. +Given a version number MAJOR.MINOR.PATCH, you MUST increment the: + +1. MAJOR version if backward **binary compatibility** is broken, +2. MINOR version if backward **source compatibility** is broken, and +3. PATCH version to signal **neither binary nor source incompatibility**. + According to SemVer, patch versions should contain only bug fixes that fix incorrect behavior so major behavioral change in method/classes should result in a minor version bump. -* When major version is `0`, a minor version bump **may contain both source and binary breakages**. + +* When the major version is `0`, a minor version bump **may contain both source and binary breakages**. Some examples: From dc06ff3c20e7464a100fc65869b04294daee1296 Mon Sep 17 00:00:00 2001 From: Dale Wijnand <344610+dwijnand@users.noreply.github.com> Date: Mon, 24 Jun 2019 10:07:33 +0100 Subject: [PATCH 0534/3075] Drop the reference to SLIPs --- _sips/sip-tutorial.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sip-tutorial.md b/_sips/sip-tutorial.md index b5ed7e03ae..24d1577a0d 100644 --- a/_sips/sip-tutorial.md +++ b/_sips/sip-tutorial.md @@ -10,7 +10,7 @@ This tutorial details of how to write a new SIP and adding it to the website. The process to submit is simple: * Fork the [Scala documentation repository](http://github.com/scala/docs.scala-lang) and clone it. -* Create a new SIP file in the `sips/pending/_posts/`. Use the [S(L)IP template](https://github.com/scala/docs.scala-lang/blob/master/_sips/sip-template.md) +* Create a new SIP file in the `sips/pending/_posts/`. Use the [SIP template](https://github.com/scala/docs.scala-lang/blob/master/_sips/sip-template.md) * Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Use the proposal date for `YYYY-MM-dd`. * Use the [Markdown Syntax](http://daringfireball.net/projects/markdown/syntax) to write your SIP. * Follow the instructions in the [README](https://github.com/scala/docs.scala-lang/blob/master/README.md) to build your SIP locally so you can ensure that it looks correct on the website. From 50f3d29704c7e05ca34583c6b83c5fb4c4f3f5c6 Mon Sep 17 00:00:00 2001 From: Dale Wijnand <344610+dwijnand@users.noreply.github.com> Date: Mon, 24 Jun 2019 10:53:48 +0100 Subject: [PATCH 0535/3075] Add 2.13.0 to the JDK compatibility table --- _overviews/jdk-compatibility/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 117e52b90b..57d9e3d7b3 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -18,8 +18,8 @@ This table shows the first Scala release in each series that works with each JVM | JVM version | Minimum Scala versions | |:-----------:|:----------------------------------------------------------------------------------------------| | 12 | see [below](#jdk-12-compatibility-notes) | -| 11 | 2.12.4, 2.11.12, 2.10.7 (but also, see [below](#jdk-11-compatibility-notes)) | -| 8 | 2.12.0, 2.11.0, 2.10.2 | +| 11 | 2.13.0, 2.12.4, 2.11.12, 2.10.7 (but also, see [below](#jdk-11-compatibility-notes)) | +| 8 | 2.13.0, 2.12.0, 2.11.0, 2.10.2 | | 7 | 2.11.0, 2.10.0 | | 6 | 2.11.0, 2.10.0 | From 5a501aa966675623c714bb848202eaaf545a5f0f Mon Sep 17 00:00:00 2001 From: alex-t-wix <47665163+alex-t-wix@users.noreply.github.com> Date: Mon, 24 Jun 2019 14:54:25 +0300 Subject: [PATCH 0536/3075] Clarifying first limitation of value-classes Phrase "... val parameter whose type is not a value class" seems wrong. You actually can have value class as a parameter but it must be a standard value class. I suggest using term "user-defined value class". --- _overviews/core/value-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/core/value-classes.md b/_overviews/core/value-classes.md index 9b9d0c06a4..06cba3d4cb 100644 --- a/_overviews/core/value-classes.md +++ b/_overviews/core/value-classes.md @@ -140,7 +140,7 @@ Full details on the implementation of value classes and their limitations may be A value class ... -1. ... must have only a primary constructor with exactly one public, val parameter whose type is not a value class. (From Scala 2.11.0, the parameter may be non-public.) +1. ... must have only a primary constructor with exactly one public, val parameter whose type is not a user-defined value class. (From Scala 2.11.0, the parameter may be non-public.) 2. ... may not have specialized type parameters. 3. ... may not have nested or local classes, traits, or objects 4. ... may not define a equals or hashCode method. From 2927896954776c1d3144078e4f742cab59ac4696 Mon Sep 17 00:00:00 2001 From: Dale Wijnand <344610+dwijnand@users.noreply.github.com> Date: Mon, 24 Jun 2019 14:07:38 +0100 Subject: [PATCH 0537/3075] Add 2.13.0 to JDK 11 compat notes --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 57d9e3d7b3..92ae69b088 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -43,7 +43,7 @@ Like the 2.12.x series, the Scala 2.13.x series will support Java 8 and higher. Although the table above jumps from 8 to 11, JDK 9 and 10 will probably also work wherever 11 does. But unlike 9 and 10, 11 is an LTS release, so 11 is what we actually test on and recommend. -As of Scala 2.12.8 and 2.11.12, **JDK 11 support is incomplete**. Notably, `scalac` will not enforce the restrictions of the Java Platform Module System, which means that code that typechecks may incur linkage errors at runtime. Scala 2.13.x will eventually provide [rudimentary support](https://github.com/scala/scala/pull/7218) for this, but likely only in nightlies built on Java 11. +As of Scala 2.13.0, 2.12.8 and 2.11.12, **JDK 11 support is incomplete**. Notably, `scalac` will not enforce the restrictions of the Java Platform Module System, which means that code that typechecks may incur linkage errors at runtime. Scala 2.13.x will eventually provide [rudimentary support](https://github.com/scala/scala/pull/7218) for this, but likely only in nightlies built on Java 11. JDK 11 support requires minimum sbt version 1.1.0, or 0.13.17 in the 0.13.x series. From 771034b0b2c2fed5e38e8775bc671948a4317887 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Tue, 25 Jun 2019 11:39:21 +0800 Subject: [PATCH 0538/3075] (overview) Fix zh-cn in pr#1398, with more fixes of the same page. --- _zh-cn/overviews/core/value-classes.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_zh-cn/overviews/core/value-classes.md b/_zh-cn/overviews/core/value-classes.md index b731b9da0e..d19501d7e4 100644 --- a/_zh-cn/overviews/core/value-classes.md +++ b/_zh-cn/overviews/core/value-classes.md @@ -123,9 +123,9 @@ value类在以下情况下，需要真正实例化： 一个value类 ... -1. ... 必须只有一个public的构造函数。并有且只有一个public的，类型不为value类的val参数。 -2. ... 不能有特殊的类型参数. -3. ... 不能有嵌套或本地类、trait或对象。 +1. ... 必须只有一个主构造器。该构造器有且仅有一个public修饰的不可变（val）参数，且参数的类型不是用户自定义的value类。 +2. ... 不能有特殊的类型参数。 +3. ... 不能有嵌套或局部的类、特质或对象。 4. ... 不能定义equals或hashCode方法。 5. ... 必须是一个顶级类，或静态访问对象的一个成员 6. ... 仅能有def为成员。尤其是，成员不能有惰性val、val或者var 。 From 160c8358f543ac056236226dae59f6d8af9b87d2 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Tue, 25 Jun 2019 11:43:54 +0800 Subject: [PATCH 0539/3075] (overview) Fix zh-cn in pr#1398, with more polish-es. --- _zh-cn/overviews/core/value-classes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_zh-cn/overviews/core/value-classes.md b/_zh-cn/overviews/core/value-classes.md index d19501d7e4..2a2366e4d7 100644 --- a/_zh-cn/overviews/core/value-classes.md +++ b/_zh-cn/overviews/core/value-classes.md @@ -127,8 +127,8 @@ value类在以下情况下，需要真正实例化： 2. ... 不能有特殊的类型参数。 3. ... 不能有嵌套或局部的类、特质或对象。 4. ... 不能定义equals或hashCode方法。 -5. ... 必须是一个顶级类，或静态访问对象的一个成员 -6. ... 仅能有def为成员。尤其是，成员不能有惰性val、val或者var 。 +5. ... 必须是一个顶级类，或静态访问对象的一个成员。 +6. ... 仅能有def为成员。尤其是，成员不能有惰性val、val或者var。 7. ... 不能被其它类继承。 ### 限制示例 From c9275510fb5547ef302480d7356470aa850c11eb Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Tue, 25 Jun 2019 19:58:42 +0800 Subject: [PATCH 0540/3075] (overview) Improve one statement, add 's for user perspective. --- _overviews/collections-2.13/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/introduction.md b/_overviews/collections-2.13/introduction.md index a4ff432874..7d27aec31f 100644 --- a/_overviews/collections-2.13/introduction.md +++ b/_overviews/collections-2.13/introduction.md @@ -91,5 +91,5 @@ Furthermore, the `partition` operation is quite fast, and can be even faster on parallel collections on multiple cores. This document provides an in depth discussion of the APIs of the -Scala collections classes from a user perspective. It takes you on +Scala collections classes from a user's perspective. It takes you on a tour of all the fundamental classes and the methods they define. From d523cdec634ad56c0bbbdbbc07fae719f9a7043b Mon Sep 17 00:00:00 2001 From: take2 Date: Wed, 26 Jun 2019 07:33:08 +0900 Subject: [PATCH 0541/3075] Translation tour ja (#1387) Authored-By: take2webservice Reviewed by Yasuhiro Tatsuno and Eugene Yokota. --- _data/translations.yml | 2 +- _ja/tour/abstract-type-members.md | 79 ++++++ _ja/tour/annotations.md | 130 ++++++++++ _ja/tour/automatic-closures.md | 62 +++++ _ja/tour/basics.md | 325 ++++++++++++++++++++++++ _ja/tour/by-name-parameters.md | 45 ++++ _ja/tour/case-classes.md | 66 +++++ _ja/tour/classes.md | 131 ++++++++++ _ja/tour/compound-types.md | 54 ++++ _ja/tour/default-parameter-values.md | 50 ++++ _ja/tour/extractor-objects.md | 72 ++++++ _ja/tour/for-comprehensions.md | 77 ++++++ _ja/tour/generic-classes.md | 65 +++++ _ja/tour/higher-order-functions.md | 121 +++++++++ _ja/tour/implicit-conversions.md | 62 +++++ _ja/tour/implicit-parameters.md | 75 ++++++ _ja/tour/inner-classes.md | 91 +++++++ _ja/tour/lower-type-bounds.md | 76 ++++++ _ja/tour/mixin-class-composition.md | 84 ++++++ _ja/tour/multiple-parameter-lists.md | 79 ++++++ _ja/tour/named-arguments.md | 36 +++ _ja/tour/nested-functions.md | 40 +++ _ja/tour/operators.md | 88 +++++++ _ja/tour/package-objects.md | 73 ++++++ _ja/tour/packages-and-imports.md | 87 +++++++ _ja/tour/pattern-matching.md | 166 ++++++++++++ _ja/tour/polymorphic-methods.md | 39 +++ _ja/tour/regular-expression-patterns.md | 63 +++++ _ja/tour/self-types.md | 42 +++ _ja/tour/singleton-objects.md | 122 +++++++++ _ja/tour/tour-of-scala.md | 86 +++++++ _ja/tour/traits.md | 89 +++++++ _ja/tour/tuples.md | 79 ++++++ _ja/tour/type-inference.md | 74 ++++++ _ja/tour/unified-types.md | 97 +++++++ _ja/tour/upper-type-bounds.md | 60 +++++ _ja/tour/variances.md | 184 ++++++++++++++ 37 files changed, 3170 insertions(+), 1 deletion(-) create mode 100644 _ja/tour/abstract-type-members.md create mode 100644 _ja/tour/annotations.md create mode 100644 _ja/tour/automatic-closures.md create mode 100644 _ja/tour/basics.md create mode 100644 _ja/tour/by-name-parameters.md create mode 100644 _ja/tour/case-classes.md create mode 100644 _ja/tour/classes.md create mode 100644 _ja/tour/compound-types.md create mode 100644 _ja/tour/default-parameter-values.md create mode 100644 _ja/tour/extractor-objects.md create mode 100644 _ja/tour/for-comprehensions.md create mode 100644 _ja/tour/generic-classes.md create mode 100644 _ja/tour/higher-order-functions.md create mode 100644 _ja/tour/implicit-conversions.md create mode 100644 _ja/tour/implicit-parameters.md create mode 100644 _ja/tour/inner-classes.md create mode 100644 _ja/tour/lower-type-bounds.md create mode 100644 _ja/tour/mixin-class-composition.md create mode 100644 _ja/tour/multiple-parameter-lists.md create mode 100644 _ja/tour/named-arguments.md create mode 100644 _ja/tour/nested-functions.md create mode 100644 _ja/tour/operators.md create mode 100644 _ja/tour/package-objects.md create mode 100644 _ja/tour/packages-and-imports.md create mode 100644 _ja/tour/pattern-matching.md create mode 100644 _ja/tour/polymorphic-methods.md create mode 100644 _ja/tour/regular-expression-patterns.md create mode 100644 _ja/tour/self-types.md create mode 100644 _ja/tour/singleton-objects.md create mode 100644 _ja/tour/tour-of-scala.md create mode 100644 _ja/tour/traits.md create mode 100644 _ja/tour/tuples.md create mode 100644 _ja/tour/type-inference.md create mode 100644 _ja/tour/unified-types.md create mode 100644 _ja/tour/upper-type-bounds.md create mode 100644 _ja/tour/variances.md diff --git a/_data/translations.yml b/_data/translations.yml index 266b039905..56d0fd59cf 100644 --- a/_data/translations.yml +++ b/_data/translations.yml @@ -1,2 +1,2 @@ tour: - languages: [ba, es, ko, pt-br, pl, zh-cn, th, ru] + languages: [ba, es, ko, pt-br, pl, zh-cn, th, ru, ja] diff --git a/_ja/tour/abstract-type-members.md b/_ja/tour/abstract-type-members.md new file mode 100644 index 0000000000..f5821a7b74 --- /dev/null +++ b/_ja/tour/abstract-type-members.md @@ -0,0 +1,79 @@ +--- +layout: tour +title: 抽象型メンバー +language: ja + +discourse: true + +partof: scala-tour +num: 23 +next-page: compound-types +previous-page: inner-classes +topics: abstract type members +prerequisite-knowledge: variance, upper-type-bound + +redirect_from: "/tutorials/tour/abstract-types.html" +redirect_from: "/tour/abstract-types.html" +--- + +トレイトや抽象クラスのような抽象型は抽象型メンバーを持つことができます。 +これは具体的な実装で実際の型を定義するという意味です。 +こちらが例です。 + +```tut +trait Buffer { + type T + val element: T +} +``` +こちらでは、抽象型`type T`を定義しています。それは`element`の型を記述するために使われます。このトレイトを抽象クラスで継承し、より具体的にするために上限型境界を`T`に追加することができます。 + +```tut +abstract class SeqBuffer extends Buffer { + type U + type T <: Seq[U] + def length = element.length +} +``` +`T`の上限型境界の定義に出てきた、更に別の抽象型`U`の使い方に気をつけてください。この`class SeqBuffer`はこのバッファーの中にシーケンスのみを保持することができます。それは型`T`は新しい抽象型`U`を使った`Seq[U]`のサブタイプであると記述しているからです。 + +抽象型メンバーを持つトレイトと[クラス](classes.html)は無名クラスのインスタンス化と組み合わせてよく使われます。 +これを説明するために、今から整数のリストを参照するシーケンスバッファーを扱うプログラムを見てみます。 + +```tut +abstract class IntSeqBuffer extends SeqBuffer { + type U = Int +} + + +def newIntSeqBuf(elem1: Int, elem2: Int): IntSeqBuffer = + new IntSeqBuffer { + type T = List[U] + val element = List(elem1, elem2) + } +val buf = newIntSeqBuf(7, 8) +println("length = " + buf.length) +println("content = " + buf.element) +``` +ここで、ファクトリー`newIntSeqBuf`は抽象型`T`を具体的な型`List[Int]`に設定するために、`IntSeqBuf`(つまり`new IntSeqBuffer`)を無名クラスで実装します。 + +抽象型メンバーをクラスの型パラメータに変えることも、その逆も可能です。以下は上記コードの型パラメータのみを使うバージョンです。 + +```tut +abstract class Buffer[+T] { + val element: T +} +abstract class SeqBuffer[U, +T <: Seq[U]] extends Buffer[T] { + def length = element.length +} + +def newIntSeqBuf(e1: Int, e2: Int): SeqBuffer[Int, Seq[Int]] = + new SeqBuffer[Int, List[Int]] { + val element = List(e1, e2) + } + +val buf = newIntSeqBuf(7, 8) +println("length = " + buf.length) +println("content = " + buf.element) +``` +ここでは(`+T <: Seq[U]`)をメソッド`newIntSeqBuf`から戻されるオブジェクトの具体的なシーケンス実装の型を隠すために [変位指定アノテーション](variances.html)を使わなければなりません。さらに、抽象型メンバをパラメータで置換することができないケースがあります。 diff --git a/_ja/tour/annotations.md b/_ja/tour/annotations.md new file mode 100644 index 0000000000..88114954f1 --- /dev/null +++ b/_ja/tour/annotations.md @@ -0,0 +1,130 @@ +--- +layout: tour +title: アノテーション +language: ja + +discourse: true + +partof: scala-tour + +num: 32 +next-page: default-parameter-values +previous-page: by-name-parameters + +redirect_from: "/tutorials/tour/annotations.html" +--- + +アノテーションはメタ情報と定義を関連づけます。例えば、メソッドの前のアノテーション`@deprecated`はメソッドが使われたらコンパイラに警告を出力させます。 +``` +object DeprecationDemo extends App { + @deprecated("deprecation message", "release # which deprecates method") + def hello = "hola" + + hello +} +``` +これはコンパイルされますが、コンパイラは警告"there was one deprecation warning"を出力します。 + +アノテーション句はそれに続く最初の定義か宣言に適用されます。定義と宣言の前には1つ以上のアノテーション句を置くことができます。これらの句の順番は重要ではありません。 + + +## エンコーディングの正確性を保証するアノテーション +条件が一致しない場合にコンパイルを失敗させるアノテーションもあります。例えば、アノテーション`@tailrec`はメソッドが[末尾再帰](https://en.wikipedia.org/wiki/Tail_call)であると保証します。末尾再帰ではメモリ使用量が一定になります。こちらは階乗を計算するメソッドの中での使われ方です。 +```tut +import scala.annotation.tailrec + +def factorial(x: Int): Int = { + + @tailrec + def factorialHelper(x: Int, accumulator: Int): Int = { + if (x == 1) accumulator else factorialHelper(x - 1, accumulator * x) + } + factorialHelper(x, 1) +} +``` +`factorialHelper`メソッドは`@tailrec`を持ちます。`@tailrec`はメソッドが実際に末尾再帰であると保証します。もし`factorialHelper`の実装を以下のように変更すれば、失敗し +``` +import scala.annotation.tailrec + +def factorial(x: Int): Int = { + @tailrec + def factorialHelper(x: Int): Int = { + if (x == 1) 1 else x * factorialHelper(x - 1) + } + factorialHelper(x) +} +``` +"Recursive call not in tail position"というメッセージを受け取ります。 + + +## コード生成に影響するアノテーション +`@inline`のようなアノテーションは生成されたコードに影響します(つまり、アノテーションを使わなかった場合とでjarファイルのバイト数が異なる場合があります)。インライン化とは、メソッドを呼び出している箇所にメソッド本体のコードを挿入することを意味します。結果のバイトコードはより長くなりますが、上手くいけば実行が早くなります。アノテーション`@inline`を使ってもメソッドのインライン化が保証されるわけではありません。しかし、生成されたコードのサイズに関するヒューリスティックスが満たされた場合に限りコンパイラにインライン化をさせます。 + +### Javaのアノテーション ### +Javaと相互運用するScalaのコードを書いている時、記述するアノテーション構文は少し違います。 + +**注:** Javaアノテーションを使う場合、`-target:jvm-1.8`オプションを使ってください。 + +Javaには[アノテーション](https://docs.oracle.com/javase/tutorial/java/annotations/)の形をしたユーザー定義メタデータがあります。Javaのアノテーションの特徴は、要素の初期化のために名前と値のペアを指定する必要があることです。例えば、クラスのソースを追いかけるためのアノテーションが必要なとき、以下のように定義するかもしれません。 + +``` +@interface Source { + public String URL(); + public String mail(); +} +``` + +そして、それは以下のように適用されます。 + +``` +@Source(URL = "http://coders.com/", + mail = "support@coders.com") +public class MyClass extends TheirClass ... +``` + +Scalaでのアノテーションの適用はコンストラクタの呼び出しと似ています。Javaのアノテーションをインスタンス化するためには名前付き引数を使う必要があります。 + +``` +@Source(URL = "http://coders.com/", + mail = "support@coders.com") +class MyScalaClass ... +``` + +アノテーションが(デフォルト値を除き)要素を1つだけ含む場合、この構文はかなり退屈です。そのため慣例により、名前が`value`と指定されていれば、コンストラクタのような構文でJavaに適用できます。 + +``` +@interface SourceURL { + public String value(); + public String mail() default ""; +} +``` + +そして以下のように適用します。 + +``` +@SourceURL("http://coders.com/") +public class MyClass extends TheirClass ... +``` + +この場合、Scalaでも同じことができます。 + +``` +@SourceURL("http://coders.com/") +class MyScalaClass ... +``` + +`mail`要素はデフォルト値つきで定義されているので、明示的に値を指定する必要がありません。しかしながら、もし値を指定する必要がある場合、Javaでは2つのスタイルを混ぜて組み合わせることはできません。 + +``` +@SourceURL(value = "http://coders.com/", + mail = "support@coders.com") +public class MyClass extends TheirClass ... +``` + +Scalaはこの点においてより柔軟です。 + +``` +@SourceURL("http://coders.com/", + mail = "support@coders.com") + class MyScalaClass ... +``` diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md new file mode 100644 index 0000000000..29ae0a8c00 --- /dev/null +++ b/_ja/tour/automatic-closures.md @@ -0,0 +1,62 @@ +--- +layout: tour +title: Automatic Type-Dependent Closure Construction +language: ja + +discourse: true + +partof: scala-tour +--- + +Scala allows parameterless function names as parameters of methods. When such a method is called, the actual parameters for parameterless function names are not evaluated and a nullary function is passed instead which encapsulates the computation of the corresponding parameter (so-called *call-by-name* evaluation). + +The following code demonstrates this mechanism: + + object TargetTest1 extends Application { + def whileLoop(cond: => Boolean)(body: => Unit): Unit = + if (cond) { + body + whileLoop(cond)(body) + } + var i = 10 + whileLoop (i > 0) { + println(i) + i -= 1 + } + } + +The function whileLoop takes two parameters `cond` and `body`. When the function is applied, the actual parameters do not get evaluated. But whenever the formal parameters are used in the body of `whileLoop`, the implicitly created nullary functions will be evaluated instead. Thus, our method `whileLoop` implements a Java-like while-loop with a recursive implementation scheme. + +We can combine the use of [infix/postfix operators](operators.html) with this mechanism to create more complex statements (with a nice syntax). + +Here is the implementation of a loop-unless statement: + + object TargetTest2 extends Application { + def loop(body: => Unit): LoopUnlessCond = + new LoopUnlessCond(body) + protected class LoopUnlessCond(body: => Unit) { + def unless(cond: => Boolean) { + body + if (!cond) unless(cond) + } + } + var i = 10 + loop { + println("i = " + i) + i -= 1 + } unless (i == 0) + } +The `loop` function just accepts a body of a loop and returns an instance of class `LoopUnlessCond` (which encapsulates this body object). Note that the body didn't get evaluated yet. Class `LoopUnlessCond` has a method `unless` which we can use as a *infix operator*. This way, we achieve a quite natural syntax for our new loop: `loop { < stats > } unless ( < cond > )`. + +Here's the output when `TargetTest2` gets executed: + + i = 10 + i = 9 + i = 8 + i = 7 + i = 6 + i = 5 + i = 4 + i = 3 + i = 2 + i = 1 diff --git a/_ja/tour/basics.md b/_ja/tour/basics.md new file mode 100644 index 0000000000..b14330f2b3 --- /dev/null +++ b/_ja/tour/basics.md @@ -0,0 +1,325 @@ +--- +layout: tour +title: 基本 +language: ja + +discourse: true + +partof: scala-tour + +num: 2 +next-page: unified-types +previous-page: tour-of-scala + +redirect_from: "/tutorials/tour/basics.html" +--- + +このページでは、Scalaの基本を取り扱います。 + +## Scalaをブラウザで試してみる + +ScalaFiddleを利用することでブラウザ上でScalaを実行することができます。 + +1. [https://scalafiddle.io](https://scalafiddle.io)を開きます。 +2. 左側のパネルに`println("Hello, world!")`を貼り付けます。 +3. "Run"ボタンを押すと、右側のパネルに出力が表示されます。 + +このサイトを使えば、簡単にセットアップせずScalaのコードの一部を試すことができます。 + +このドキュメントの多くのコードの例はScalaFiddleで開発されています。 +そのため、サンプルコード内のRunボタンをクリックするだけで、そのまま簡単にコードを試すことができます。 + +## 式 + +式は計算可能な文です。 + +``` +1 + 1 +``` +`println`を使うことで、式の結果を出力できます。 + +{% scalafiddle %} +```tut +println(1) // 1 +println(1 + 1) // 2 +println("Hello!") // Hello! +println("Hello," + " world!") // Hello, world! +``` +{% endscalafiddle %} + +### 値 + +`val`キーワードを利用することで、式の結果に名前を付けることができます。 + +```tut +val x = 1 + 1 +println(x) // 2 +``` + +ここでいうところの `x` のように、名前をつけられた結果は 値 と呼ばれます。 +値を参照した場合、その値は再計算されません。 + +値は再代入することができません。 + +```tut:fail +x = 3 // この記述はコンパイルされません。 +``` + +値の型は推測可能ですが、このように型を明示的に宣言することもできます。 + +```tut +val x: Int = 1 + 1 +``` + +型定義では`Int` は識別子`x`の後にくることに注意してください。そして`:`も必要となります。 + +### 変数 + +再代入ができることを除けば、変数は値と似ています。 +`var`キーワードを使うことで、変数は定義できます。 + +```tut +var x = 1 + 1 +x = 3 // "x"は"var"キーワードで宣言されているので、これはコンパイルされます。 +println(x * x) // 9 +``` + +値と同様に、型を宣言したければ、明示的に型を宣言することができます。 + +```tut +var x: Int = 1 + 1 +``` + + +## ブロック + +`{}`で囲むことで式をまとめることができます。これをブロックと呼びます。 + +ブロックの最後の式の結果はブロック全体の結果にもなります。 + +```tut +println({ + val x = 1 + 1 + x + 1 +}) // 3 +``` + +## 関数 + +関数はパラメーターを受け取る式です。 +ここでは与えられた数値に1を足す無名関数（すなわち名前が無い関数）を宣言しています。 + +```tut +(x: Int) => x + 1 +``` +`=>` の左側はパラメーターのリストです。右側はパラメーターを含む式です。 + +関数には名前をつけることもできます。 + +{% scalafiddle %} +```tut +val addOne = (x: Int) => x + 1 +println(addOne(1)) // 2 +``` +{% endscalafiddle %} + +関数は複数のパラメーターをとることもできます。 + +{% scalafiddle %} +```tut +val add = (x: Int, y: Int) => x + y +println(add(1, 2)) // 3 +``` +{% endscalafiddle %} + +またパラメーターを取らないこともありえます。 + +```tut +val getTheAnswer = () => 42 +println(getTheAnswer()) // 42 +``` + +## メソッド + +メソッドは関数と見た目、振る舞いがとても似ていますが、それらには違いがいくつかあります。 + +メソッドは `def` キーワードで定義されます。 `def` の後ろには名前、パラメーターリスト、戻り値の型、処理の内容が続きます。 + +{% scalafiddle %} +```tut +def add(x: Int, y: Int): Int = x + y +println(add(1, 2)) // 3 +``` +{% endscalafiddle %} + +戻り値の型は引数リストとコロンの「後ろ」に宣言することに注意してください。`: Int` + +メソッドは複数のパラメーターリストを受け取ることができます。 + +{% scalafiddle %} +```tut +def addThenMultiply(x: Int, y: Int)(multiplier: Int): Int = (x + y) * multiplier +println(addThenMultiply(1, 2)(3)) // 9 +``` +{% endscalafiddle %} + +また、パラメーターリストを一切受け取らないこともあります。 + +```tut +def name: String = System.getProperty("user.name") +println("Hello, " + name + "!") +``` +メソッドと関数には他にも違いがありますが、今のところは同じようなものと考えて大丈夫です。 + +メソッドは複数行の式も持つことができます。 +```tut +def getSquareString(input: Double): String = { + val square = input * input + square.toString +} +``` +メソッド本体にある最後の式はメソッドの戻り値になります。(Scalaには`return`キーワードはありますが、めったに使われません。) + +## クラス + +`class` キーワードとその後ろに名前、コンストラクタパラメーターを続けることで、クラスを定義することができます。 + +```tut +class Greeter(prefix: String, suffix: String) { + def greet(name: String): Unit = + println(prefix + name + suffix) +} +``` +`greet` メソッドの戻り値の型は`Unit`です。`Unit`は戻り値として意味がないことを示します。 +それはJavaやC言語の`void`と似たような使われ方をします。（`void`との違いは、全てのScalaの式は値を持つ必要があるため、 +実はUnit型のシングルトンで`()`と書かれる値があります。その値には情報はありません。） + +`new` キーワードを使うことで、クラスのインスタンスを生成することができます。 + +```tut +val greeter = new Greeter("Hello, ", "!") +greeter.greet("Scala developer") // Hello, Scala developer! +``` + +クラスについては[後で](classes.html)詳しく取り扱います。 + +## ケースクラス + +Scalaには"ケース"クラスという特別な種類のクラスがあります。デフォルトでケースクラスは不変であり、値で比較されます。 +`case class` キーワードを利用して、ケースクラスを定義できます。 + +```tut +case class Point(x: Int, y: Int) +``` +ケースクラスは、`new` キーワードなしでインスタンス化できます。 + +```tut +val point = Point(1, 2) +val anotherPoint = Point(1, 2) +val yetAnotherPoint = Point(2, 2) +``` + +ケースクラスは値で比較されます。 + +```tut +if (point == anotherPoint) { + println(point + " and " + anotherPoint + " are the same.") +} else { + println(point + " and " + anotherPoint + " are different.") +} // Point(1,2) と Point(1,2) は同じです。 + +if (point == yetAnotherPoint) { + println(point + " and " + yetAnotherPoint + " are the same.") +} else { + println(point + " and " + yetAnotherPoint + " are different.") +} // Point(1,2) と Point(2,2) は異なります。 +``` + +ケースクラスについて紹介すべきことはたくさんあり、あなたはケースクラスが大好きになると確信しています！ +それらについては[後で](case-classes.html)詳しく取り扱います。 + +## オブジェクト + +オブジェクトはそれ自体が定義である単一のインスタンスです。そのクラスのシングルトンと考えることもできます。 + +`object`キーワードを利用してオブジェクトを定義することができます。 + +```tut +object IdFactory { + private var counter = 0 + def create(): Int = { + counter += 1 + counter + } +} +``` + +名前を参照してオブジェクトにアクセスすることができます。 + +```tut +val newId: Int = IdFactory.create() +println(newId) // 1 +val newerId: Int = IdFactory.create() +println(newerId) // 2 +``` + +オブジェクトについては [後で](singleton-objects.html)詳しく取り扱います。 + +## トレイト + +トレイトはいくつかのフィールドとメソッドを含む型です。複数のトレイトを結合することもできます。 + +`trait`キーワードでトレイトを定義することができます。 + +```tut +trait Greeter { + def greet(name: String): Unit +} +``` + +トレイトはデフォルトの実装を持つこともできます。 + +{% scalafiddle %} +```tut +trait Greeter { + def greet(name: String): Unit = + println("Hello, " + name + "!") +} +``` + +`extends`キーワードでトレイトを継承することも、`override` キーワードで実装をオーバーライドすることもできます。 + +```tut +class DefaultGreeter extends Greeter + +class CustomizableGreeter(prefix: String, postfix: String) extends Greeter { + override def greet(name: String): Unit = { + println(prefix + name + postfix) + } +} + +val greeter = new DefaultGreeter() +greeter.greet("Scala developer") // Hello, Scala developer! + +val customGreeter = new CustomizableGreeter("How are you, ", "?") +customGreeter.greet("Scala developer") // How are you, Scala developer? +``` +{% endscalafiddle %} + +ここでは、`DefaultGreeter`は一つのトレイトだけを継承していますが、複数のトレイトを継承することもできます。 + +トレイトについては [後で](traits.html)詳しく取り扱います。 + +## メインメソッド + +メインメソッドはプログラムの始点になります。Javaバーチャルマシーンは`main`と名付けられたメインメソッドが必要で、 +それは文字列の配列を一つ引数として受け取ります。 + +オブジェクトを使い、以下のようにメインメソッドを定義することができます。 + +```tut +object Main { + def main(args: Array[String]): Unit = + println("Hello, Scala developer!") +} +``` diff --git a/_ja/tour/by-name-parameters.md b/_ja/tour/by-name-parameters.md new file mode 100644 index 0000000000..86325795ba --- /dev/null +++ b/_ja/tour/by-name-parameters.md @@ -0,0 +1,45 @@ +--- +layout: tour +title: 名前渡しパラメータ +language: ja + +discourse: true + +partof: scala-tour + +num: 31 +next-page: annotations +previous-page: operators + +redirect_from: "/tutorials/tour/by-name-parameters.html" +--- + +*名前渡しのパラメータ*は使用された時に評価されます。それらは*値渡しパラメータ*とは対照的です。名前渡しのパラメータを作るには、単純に`=>`を型の前につけます。 +```tut +def calculate(input: => Int) = input * 37 +``` + +名前渡しパラメータの利点は関数本体の中で使わなければ評価されない点です。一方で、値渡しパラメータの利点は1度しか評価されない点です。 + +こちらはwhileループをどのように実装するかの例です。 + +```tut +def whileLoop(condition: => Boolean)(body: => Unit): Unit = + if (condition) { + body + whileLoop(condition)(body) + } + +var i = 2 + +whileLoop (i > 0) { + println(i) + i -= 1 +} // prints 2 1 +``` + +このメソッド`whileLoop`は条件とループの本体を受け取るために複数パラメータリストを使います。もし`condition`がtrueならば、`body`が実行され、次にwhileLoopが再帰的に呼ばれます。`condition`がfalseならば、bodyは決して評価されません。それは`body`の型の前に`=>`をつけたからです。 + +ここで、`condition`に`i > 0`、`body`に`println(i); i-= 1`を渡した場合、多くの言語で一般的なwhileループと同じ振る舞いをします。 + +パラメータが使われるまで評価を遅延する機能はパフォーマンスの助けになることがあります。それはパラメータを評価するのに多くの計算が必要な場合や、URLの取得のような時間がかかるコードブロックの場合です。 diff --git a/_ja/tour/case-classes.md b/_ja/tour/case-classes.md new file mode 100644 index 0000000000..99a1b6e6f0 --- /dev/null +++ b/_ja/tour/case-classes.md @@ -0,0 +1,66 @@ +--- +layout: tour +title: ケースクラス +language: ja + +discourse: true + +partof: scala-tour + +num: 11 +next-page: pattern-matching +previous-page: multiple-parameter-lists +prerequisite-knowledge: classes, basics, mutability + +redirect_from: "/tutorials/tour/case-classes.html" +--- + +ケースクラスはこれから論じるいくつかの差異はあるものの普通のクラスと似ています。 +ケースクラスは不変なデータを作るのに適しています。 +このツアーの次のステップでは、[パターンマッチング](pattern-matching.html)でのそれらの有用性を解説します。 + +## ケースクラスの宣言 + +最小のケースクラスにはキーワード`case class`、識別子、パラメータリスト(空かもしれません)が必要です。 +```tut +case class Book(isbn: String) + +val frankenstein = Book("978-0486282114") +``` +ケースクラス`Book`をインスタンス化する時キーワード`new`が使われていないことに気をつけてください。 +これはケースクラスがオブジェクトの生成を行う`apply`メソッドを標準で保有するためです。 + +パラメータ有りでケースクラスを作ると、パラメータはパブリックの`val`となります。 +``` +case class Message(sender: String, recipient: String, body: String) +val message1 = Message("guillaume@quebec.ca", "jorge@catalonia.es", "Ça va ?") + +println(message1.sender) // guillaume@quebec.ca が出力されます +message1.sender = "travis@washington.us" // この行はコンパイルされません +``` +`message1.sender` に再代入することはできません、なぜなら`val`（つまりイミュータブル）だからです。 +ケースクラスでは`var`も使うことができますが、推奨されません。 + +## 比較 +ケースクラスは参照ではなく、構造で比較されます。 +``` +case class Message(sender: String, recipient: String, body: String) + +val message2 = Message("jorge@catalonia.es", "guillaume@quebec.ca", "Com va?") +val message3 = Message("jorge@catalonia.es", "guillaume@quebec.ca", "Com va?") +val messagesAreTheSame = message2 == message3 // true +``` +たとえ`message2`と`message3`が異なるオブジェクトを参照していたとしても、それぞれのオブジェクトの値は等価となります。 + +## コピー +`copy`メソッドを使うことで簡単にケースクラスのインスタンスの（浅い）コピーを作ることができます。 +必要に応じて、コンストラクタ引数を変更することもできます。 +``` +case class Message(sender: String, recipient: String, body: String) +val message4 = Message("julien@bretagne.fr", "travis@washington.us", "Me zo o komz gant ma amezeg") +val message5 = message4.copy(sender = message4.recipient, recipient = "claire@bourgogne.fr") +message5.sender // travis@washington.us +message5.recipient // claire@bourgogne.fr +message5.body // "Me zo o komz gant ma amezeg" +``` +`message4`のrecipientは`message5`のsenderとして使われますが、`message4`の定数`body`は直接コピーされます。 diff --git a/_ja/tour/classes.md b/_ja/tour/classes.md new file mode 100644 index 0000000000..0253f210f5 --- /dev/null +++ b/_ja/tour/classes.md @@ -0,0 +1,131 @@ +--- +layout: tour +title: クラス +language: ja + +discourse: true + +partof: scala-tour + +num: 4 +next-page: traits +previous-page: unified-types +topics: classes +prerequisite-knowledge: no-return-keyword, type-declaration-syntax, string-interpolation, procedures + +redirect_from: "/tutorials/tour/classes.html" +--- + +Scalaにおけるクラスはオブジェクトを作るための設計図です。 +クラスはメソッド、値、変数、型、オブジェクト、トレイト、クラスを持ち、それらはまとめて _メンバー_ と呼ばれます。 +型、オブジェクト、トレイトはツアーで後ほど取り扱います。 + +## クラスを定義する + +最小のクラス定義は単純にキーワード`class`と識別子だけというものです。 +クラス名は大文字から始まるべきです。 + +```tut +class User + +val user1 = new User +``` +`new`キーワードはクラスのインスタンスを作るために使われます。 +`User`はコンストラクターが定義されていないので、引数なしのデフォルトコンストラクターを持ちます。 +しかしながら、コンストラクターとクラス本体は頻繁に欲しくなるでしょう。 +こちらは位置情報のクラス定義の例になります。 + +```tut +class Point(var x: Int, var y: Int) { + + def move(dx: Int, dy: Int): Unit = { + x = x + dx + y = y + dy + } + + override def toString: String = + s"($x, $y)" +} + +val point1 = new Point(2, 3) +point1.x // 2 +println(point1) // prints (2, 3) +``` +この`Point`クラスは4つのメンバーを持ちます。 +変数`x` と `y` そしてメソッド `move` と `toString`です。 +多くの他の言語とは異なり、プライマリコンストラクタはクラスのシグネチャ`(var x: Int, var y: Int)`です。 +`move` メソッドは2つの整数の引数を受け取り、情報を持たない Unit 値 `()` を返します。 +これは大雑把に言えば、Javaのような言語における`void`に対応します。 +その一方で`toString`は引数を受け取りませんが、`String`の値を返します。 +`toString`は[`AnyRef`](unified-types.html)の`toString`をオーバーライドしているので、`override`キーワードのタグが付いています。 + +## コンストラクター + +コンストラクターは次のようにデフォルト値を与えると省略可能なパラメーターを持つことができます。 + +```tut +class Point(var x: Int = 0, var y: Int = 0) + +val origin = new Point // x と y には共に0がセットされます。 +val point1 = new Point(1) +println(point1.x) // 1 が出力されます。 +``` +このバージョンの`Point`クラスでは、`x` と `y` はデフォルト値0を持ち、引数が必須ではありません。 +しかしながらコンストラクタは引数を左から右に読み込むため、もし`y`の値だけを渡したい場合は、パラメーターに名前をつける必要があります。 + +``` +class Point(var x: Int = 0, var y: Int = 0) +val point2 = new Point(y=2) +println(point2.y) // 2 が出力されます。 +``` + +これは明快さを高めるための良い習慣でもあります。 + +## プライベートメンバーとゲッター/セッター構文 +メンバーはデフォルトではパブリックになります。 +クラスの外から隠したい場合は`private`アクセス修飾詞を使いましょう。 + +```tut +class Point { + private var _x = 0 + private var _y = 0 + private val bound = 100 + + def x = _x + def x_= (newValue: Int): Unit = { + if (newValue < bound) _x = newValue else printWarning + } + + def y = _y + def y_= (newValue: Int): Unit = { + if (newValue < bound) _y = newValue else printWarning + } + + private def printWarning = println("WARNING: Out of bounds") +} + +val point1 = new Point +point1.x = 99 +point1.y = 101 // 警告が出力されます。 +``` +このバージョンの`Point`クラスでは、データはプライベート変数 `_x` と `_y` に保存されます。 +プライベートなデータにアクセスするためのメソッド`def x` と `def y` があります。 +`def x_=` と `def y_=` は `_x` と `_y` の値を検証し設定するためのものになります。 +セッターのための特別な構文に注意してください。 +セッターメソッドはゲッターメソッドの識別子に`_=`を追加し、その後ろにパラメーターを取ります。 + +プライマリコンストラクタの`val` と `var` を持つパラメーターはパブリックになります。 +しかしながら`val` は不変となるため、以下のように記述することはできません。 + +``` +class Point(val x: Int, val y: Int) +val point = new Point(1, 2) +point.x = 3 // <-- コンパイルされません。 +``` + +`val` や `var` が存在しないパラメーターはクラス内でだけで参照できるプライベートな値や変数となります。 +``` +class Point(x: Int, y: Int) +val point = new Point(1, 2) +point.x // <-- コンパイルされません。 +``` diff --git a/_ja/tour/compound-types.md b/_ja/tour/compound-types.md new file mode 100644 index 0000000000..6eeadc481d --- /dev/null +++ b/_ja/tour/compound-types.md @@ -0,0 +1,54 @@ +--- +layout: tour +title: 複合型 +language: ja + +discourse: true + +partof: scala-tour + +num: 24 +next-page: self-types +previous-page: abstract-type-members + +redirect_from: "/tutorials/tour/compound-types.html" +--- +ときどき、あるオブジェクトの型が、複数の他の型のサブタイプであると表現する必要が生じます。 +Scalaでは、これは*複合型*を用いて表現できます。複合型とはオブジェクトの型同士を重ねることです。 + +2つのトレイト`Cloneable`と`Resetable`があるとしましょう。 + +```tut +trait Cloneable extends java.lang.Cloneable { + override def clone(): Cloneable = { + super.clone().asInstanceOf[Cloneable] + } +} +trait Resetable { + def reset: Unit +} +``` + +今、関数`cloneAndReset`を書きたいとします。それはオブジェクトを受け取り、それをクローンして、元のオブジェクトをリセットします。 + +``` +def cloneAndReset(obj: ?): Cloneable = { + val cloned = obj.clone() + obj.reset + cloned +} +``` + +パラメータ`obj`の型は何かという疑問が生じます。もし`Cloneable`であれば、オブジェクトを`clone`することができますが、`reset`することはできません。もし`Resetable`であれば、`reset`することができますが、`clone`の操作はできません。そのような状態で型キャストを回避するために`obj`の型を`Cloneable`と`Resetable`の両方であると指定することができます。Scalaではこの複合型は`Cloneable with Resetable`のように書くことができます。 + +こちらが書き変えた関数です。 + +``` +def cloneAndReset(obj: Cloneable with Resetable): Cloneable = { + //... +} +``` +複合型は複数のオブジェクトの型からなり、一つだけの細別型(refinement)を持てます。細別型は既存オブジェクトのメンバーのシグネチャを絞り込むのに使えます。 +一般的な形は`A with B with C ... { refinement }`です。 + +細別の使い方の例は[ミックスインを用いたクラス合成](mixin-class-composition.html)のページにあります。 diff --git a/_ja/tour/default-parameter-values.md b/_ja/tour/default-parameter-values.md new file mode 100644 index 0000000000..fe2da78c75 --- /dev/null +++ b/_ja/tour/default-parameter-values.md @@ -0,0 +1,50 @@ +--- +layout: tour +title: デフォルト引数 +language: ja + +discourse: true + +partof: scala-tour + +num: 33 +next-page: named-arguments +previous-page: annotations +prerequisite-knowledge: named-arguments, function syntax + +redirect_from: "/tutorials/tour/default-parameter-values.html" +--- + +Scalaはパラメータのデフォルト値を与えることができ、呼び出す側はこれらのパラメータを省略できます。 + +```tut +def log(message: String, level: String = "INFO") = println(s"$level: $message") + +log("System starting") // prints INFO: System starting +log("User not found", "WARNING") // prints WARNING: User not found +``` + +パラメータ`level`はデフォルト値を持つので、省略可能です。最終行では、引数`"WARNING"`はデフォルト値`"INFO"`を上書きします。Javaで同じ効果を得るのに、省略可能なパラメータをもつメソッドを複数使ってメソッドのオーバーロードをしたようなものです。しかしながら呼び出す側が引数をひとつ省略すると、以降全ての引数は名前つきにする必要があります。 + +```tut +class Point(val x: Double = 0, val y: Double = 0) + +val point1 = new Point(y = 1) +``` +ここでは、`y = 1`と書かなければなりません。 + +Scalaで定義したデフォルトパラメータはJavaのコードから呼び出される時はオプショナルではありません。 + +```tut +// Point.scala +class Point(val x: Double = 0, val y: Double = 0) +``` + +```java +// Main.java +public class Main { + public static void main(String[] args) { + Point point = new Point(1); // コンパイルされません + } +} +``` diff --git a/_ja/tour/extractor-objects.md b/_ja/tour/extractor-objects.md new file mode 100644 index 0000000000..2b12283764 --- /dev/null +++ b/_ja/tour/extractor-objects.md @@ -0,0 +1,72 @@ +--- +layout: tour +title: 抽出子オブジェクト +language: ja + +discourse: true + +partof: scala-tour + +num: 16 +next-page: for-comprehensions +previous-page: regular-expression-patterns + +redirect_from: "/tutorials/tour/extractor-objects.html" +--- + +抽出子オブジェクトは`unapply`メソッドを持つオブジェクトです。 +`apply`メソッドが引数を取り、オブジェクトを作るコンストラクタであるように、`unapply`は1つのオブジェクトを受け取り、引数を返そうとします。 +これはパターンマッチングと部分関数で最も頻繁に使われます。 + +```tut +import scala.util.Random + +object CustomerID { + + def apply(name: String) = s"$name--${Random.nextLong}" + + def unapply(customerID: String): Option[String] = { + val stringArray: Array[String] = customerID.split("--") + if (stringArray.tail.nonEmpty) Some(stringArray.head) else None + } +} + +val customer1ID = CustomerID("Sukyoung") // Sukyoung--23098234908 +customer1ID match { + case CustomerID(name) => println(name) // prints Sukyoung + case _ => println("Could not extract a CustomerID") +} +``` + +`apply`メソッドは`name`から`CustomerID`文字列を作ります。`unapply`は逆に`name`を返します。 + `CustomerID("Sukyoung")`は、`CustomerID.apply("Sukyoung")`を短く書く構文です。 + `case CustomerID(name) => println(name)`では、unapplyメソッドを呼んでいます。 + +値を定義する文で、パターン中に新しい変数を使うことができるので、抽出子は変数を初期化するのに使えます。この場合unapplyメソッドが初期値を与えます。 + +```tut +val customer2ID = CustomerID("Nico") +val CustomerID(name) = customer2ID +println(name) // prints Nico +``` +これは `val name = CustomerID.unapply(customer2ID).get`.と同じです。 + +```tut +val CustomerID(name2) = "--asdfasdfasdf" +``` +もし一致しない場合`scala.MatchError`が投げられます。 + +```tut:fail +val CustomerID(name3) = "-asdfasdfasdf" +``` + +`unapply`の戻り値型は以下のように選ばれなければなりません。 + +* ただのテストであれば、`Boolean`を返します。例えば`case even()`。 +* T型のサブバリュー1つを返すのであれば、`Option[T]`を返します。 +* いくつかのサブバリュー`T1,...,Tn`を返したいのであれば、オプショナルタプル`Option[(T1,...,Tn)]`でグループ化します。 + +時々、抽出する値の数が確定せず、入力に応じて任意の数の値を返したいことがあります。 +この場合は、`Option[Seq[T]]`を返す`unapplySeq`メソッドを持つ抽出子を定義することができます。 +これらのパターンと同様の例として以下のものがあります。 +`case List(x, y, z) =>`を使って`List`を分解する例や`case r(name, remainingFields @ _*) =>`.のように正規表現`Regex`を使って`String`を分解する例です。 diff --git a/_ja/tour/for-comprehensions.md b/_ja/tour/for-comprehensions.md new file mode 100644 index 0000000000..89bce4d42a --- /dev/null +++ b/_ja/tour/for-comprehensions.md @@ -0,0 +1,77 @@ +--- +layout: tour +title: for内包表記 +language: ja + +discourse: true + +partof: scala-tour + +num: 17 +next-page: generic-classes +previous-page: extractor-objects + +redirect_from: "/tutorials/tour/for-comprehensions.html" +--- + +Scalaは*シーケンス内包表記*を表現するための軽量な記法を提供します。 +内含表記は`for (enumerators) yield e`という形をとります。`enumerators`はセミコロンで区切られたEnumeratorのリストを指します。 +1つの*enumerator*は新しい変数を導き出すジェネレータかフィルタのどちらかです。 +内包表記はenumeratorsが生成する束縛一つ一つについて本体`e`を評価し、これらの値のシーケンスを返します。 + +こちらは例です。 + +```tut +case class User(name: String, age: Int) + +val userBase = List(User("Travis", 28), + User("Kelly", 33), + User("Jennifer", 44), + User("Dennis", 23)) + +val twentySomethings = for (user <- userBase if (user.age >=20 && user.age < 30)) + yield user.name // これをリストに追加する + +twentySomethings.foreach(name => println(name)) // prints Travis Dennis +``` +この`yield`文と一緒に使われている`for`ループは実際には`List`を生成します。 +`yield user.name`を返しているので、型は`List[String]`になります。 +`user <- userBase`はジェネレータであり、`if (user.age >=20 && user.age < 30)`は20代ではないユーザーをフィルターするガードです。 + +こちらは2つのジェネレータを使ったより複雑な例です。 +合計が与えられた値`v`と等しくなる、`0`から`n-1`の全てのペアを計算します。 + +```tut +def foo(n: Int, v: Int) = + for (i <- 0 until n; + j <- 0 until n if i + j == v) + yield (i, j) + +foo(10, 10) foreach { + case (i, j) => + println(s"($i, $j) ") // prints (1, 9) (2, 8) (3, 7) (4, 6) (5, 5) (6, 4) (7, 3) (8, 2) (9, 1) +} + +``` +この例では`n == 10`で`v == 10`です。最初のイテレーションでは`i == 0`かつ`j == 0`で、`i + j != v`となるので、何も生成されません。 +`i`が`1`にインクリメントされるまでに、`j`はあと9回インクリメントされます。`if`ガードがなければ、単純に以下の内容が表示されます。 + +``` + +(0, 0) (0, 1) (0, 2) (0, 3) (0, 4) (0, 5) (0, 6) (0, 7) (0, 8) (0, 9) (1, 0) ... +``` +内包表記はリストだけのものではありません。 +操作 `withFilter`、`map`、`flatMap`を（適切な型で）サポートする全てのデータ型は、シーケンス内包表記で使うことができます。 + +内包表記の中では`yield`を省略することができます。その場合、内包表記は`Unit`を返します。 +これは副作用をもたらす必要があるときに役立ちます。 +こちらは先に出たプログラムと同等のものですが、`yield`を使っていません。 + +```tut +def foo(n: Int, v: Int) = + for (i <- 0 until n; + j <- 0 until n if i + j == v) + println(s"($i, $j)") + +foo(10, 10) +``` diff --git a/_ja/tour/generic-classes.md b/_ja/tour/generic-classes.md new file mode 100644 index 0000000000..2535e31695 --- /dev/null +++ b/_ja/tour/generic-classes.md @@ -0,0 +1,65 @@ +--- +layout: tour +title: ジェネリッククラス +language: ja + +discourse: true + +partof: scala-tour + +num: 18 +next-page: variances +previous-page: for-comprehensions +assumed-knowledge: classes unified-types + +redirect_from: "/tutorials/tour/generic-classes.html" +--- +ジェネリッククラスはパラメータとして型を1つ受け取るクラスです。それらはコレクションクラスで特に役立ちます。 + +## ジェネリッククラスの定義 +ジェネリッククラスは角カッコ`[]`の中にパラメータとして型を1つ受け取ります。 +型パラメータの識別子として文字`A`を使う習慣がありますが、任意のパラメータ名を使うことができます。 +```tut +class Stack[A] { + private var elements: List[A] = Nil + def push(x: A) { elements = x :: elements } + def peek: A = elements.head + def pop(): A = { + val currentTop = peek + elements = elements.tail + currentTop + } +} +``` +この`Stack`クラスの実装はパラメータとして任意の型`A`を受け取ります。 +これはメンバーのリスト`var elements: List[A] = Nil`が型`A`の要素のみを格納できることを意味します。 +手続き`def push`は型`A`のオブジェクトのみを受け取ります +(注: `elements = x :: elements`は、`x`を現在の`elements`の先頭に追加した新しいリストを`elements`に割り当て直します)。 + +## 使い方 + +ジェネリッククラスを使うには、角カッコの中に`A`の代わりに型を入れます。 +``` +val stack = new Stack[Int] +stack.push(1) +stack.push(2) +println(stack.pop) // prints 2 +println(stack.pop) // prints 1 +``` +インスタンス`stack`はIntのみを受け取ることができます。 +しかしながら、型がサブタイプを持つ場合、それらは以下のように渡すことができます。 +``` +class Fruit +class Apple extends Fruit +class Banana extends Fruit + +val stack = new Stack[Fruit] +val apple = new Apple +val banana = new Banana + +stack.push(apple) +stack.push(banana) +``` +クラス`Apple`と`Banana`は共に`Fruit`を継承しています。そのため`Fruit`のスタックには`apple`と`banana`のインスタンスを追加できます。 + +_注意: ジェネリック型のサブタイプは*非変(invariant)*です。つまり`Stack[Char]`型の文字スタックがあるとき、それを`Stack[Int]`型の整数スタックとして使うことはできません。文字スタックに整数を入れることはできるので、このことは変に思えるかもしれません。結論としては、`B = A`の場合に限り、`Stack[A]`は`Stack[B]`の唯一のサブタイプとなります。これでは制限が強いので、ジェネリック型のサブタイプの振る舞いをコントロールするために、Scalaは[型引数アノテーションの仕組み](variances.html)を提供します。_ diff --git a/_ja/tour/higher-order-functions.md b/_ja/tour/higher-order-functions.md new file mode 100644 index 0000000000..57714202e8 --- /dev/null +++ b/_ja/tour/higher-order-functions.md @@ -0,0 +1,121 @@ +--- +layout: tour +title: 高階関数 +language: ja + +discourse: true + +partof: scala-tour + +num: 8 +next-page: nested-functions +previous-page: mixin-class-composition + +redirect_from: "/tutorials/tour/higher-order-functions.html" +--- + +高階関数は他の関数をパラメーターとして受け取る、もしくは結果として関数を返します。 +このようなことができるのは、Scalaでは関数が第一級値 (first-classs value) だからです。 +用語が少し紛らわしいかもしれませんが、 +ここでは"高階関数"というフレーズを関数をパラメーターとして受け取る、または関数を返すメソッドと関数の両方に対して使います。 + +もっとも一般的な例の1つは、Scalaのコレクションで利用可能な高階関数`map`です。 +```tut +val salaries = Seq(20000, 70000, 40000) +val doubleSalary = (x: Int) => x * 2 +val newSalaries = salaries.map(doubleSalary) // List(40000, 140000, 80000) +``` +`doubleSalary`はInt`x`を1つだけ受け取り、`x * 2`を返す関数です。 +一般的に、アロー`=>`の左側のタプルは引数リストであり、右側の式の値が返されます。 +3行目で、給与のリストのそれぞれの値に`doubleSalary`が適用されます。 + +コードを減らすため、以下のように無名関数を作ることができ、引数として直接mapに渡すことができます +``` +val salaries = Seq(20000, 70000, 40000) +val newSalaries = salaries.map(x => x * 2) // List(40000, 140000, 80000) +``` +上記例では`x`をIntとして宣言していないことに注意してください。 +それはmap関数が期待する型を基にコンパイラーが型を推論できるからです。 +さらに言えば、慣用的には同じコードを以下のように書きます。 + +```tut +val salaries = Seq(20000, 70000, 40000) +val newSalaries = salaries.map(_ * 2) +``` +Scalaコンパイラはパラメーターの型を（Intが1つだけと）既に知っているため、関数の右側を提供するだけでよいです。 +唯一の注意点はパラメータ名の代わりに`_`を使う必要があるということです（先の例では`x`でした）。 + +## メソッドを関数に強制変換 +高階関数には引数としてとしてメソッドを渡すことも可能で、それはScalaコンパイラがメソッドを関数に強制変換するからです。 +``` +case class WeeklyWeatherForecast(temperatures: Seq[Double]) { + + private def convertCtoF(temp: Double) = temp * 1.8 + 32 + + def forecastInFahrenheit: Seq[Double] = temperatures.map(convertCtoF) // <-- convertCtoFメソッドが渡されます +} +``` +ここで、メソッド`convertCtoF`が`forecastInFahrenheit`に渡されています。 +これはコンパイラが`convertCtoF`を関数`x => convertCtoF(x)`(注意点：`x`はスコープ内でユニークであることが保証された名前になります)に変換することで実現します。 + +## 関数を受け取る関数 +高階関数を使う理由の1つは余分なコードを削減することです。 +たとえば、何通りかの係数で人の給料を上げるメソッドが欲しいとしましょう。 +高階関数を作らないなら、こんな感じになるかもしれません。 + +```tut +object SalaryRaiser { + + def smallPromotion(salaries: List[Double]): List[Double] = + salaries.map(salary => salary * 1.1) + + def greatPromotion(salaries: List[Double]): List[Double] = + salaries.map(salary => salary * math.log(salary)) + + def hugePromotion(salaries: List[Double]): List[Double] = + salaries.map(salary => salary * salary) +} +``` + +3つのメソッドはそれぞれ掛け算の係数のみ異なることに気をつけてください。 +簡潔にするため、以下のように繰り返されているコードを高階関数に抽出することができます。 + +```tut +object SalaryRaiser { + + private def promotion(salaries: List[Double], promotionFunction: Double => Double): List[Double] = + salaries.map(promotionFunction) + + def smallPromotion(salaries: List[Double]): List[Double] = + promotion(salaries, salary => salary * 1.1) + + def bigPromotion(salaries: List[Double]): List[Double] = + promotion(salaries, salary => salary * math.log(salary)) + + def hugePromotion(salaries: List[Double]): List[Double] = + promotion(salaries, salary => salary * salary) +} +``` +新しいメソッド`promotion`はsalariesと`Double => Double`型の関数(すなわち、Doubleを受け取り、Doubleを返す関数)を受け取り、積を返します。 + +## 関数を返す関数 + +関数を生成したい場合がいくつかあります。 +こちらは関数を返すメソッドの例になります。 + +```tut +def urlBuilder(ssl: Boolean, domainName: String): (String, String) => String = { + val schema = if (ssl) "https://" else "http://" + (endpoint: String, query: String) => s"$schema$domainName/$endpoint?$query" +} + +val domainName = "www.example.com" +def getURL = urlBuilder(ssl=true, domainName) +val endpoint = "users" +val query = "id=1" +val url = getURL(endpoint, query) // "https://www.example.com/users?id=1": String +``` + +urlBuilderの戻り値型`(String, String) => String`に注意してください。 +これは返される無名関数はStringを2つ受け取り、Stringを1つ返すことを意味します。 +このケースでは返される無名関数は`(endpoint: String, query: String) => s"https://www.example.com/$endpoint?$query"`です。 diff --git a/_ja/tour/implicit-conversions.md b/_ja/tour/implicit-conversions.md new file mode 100644 index 0000000000..386ed3c500 --- /dev/null +++ b/_ja/tour/implicit-conversions.md @@ -0,0 +1,62 @@ +--- +layout: tour +title: 暗黙の変換 +language: ja + +discourse: true + +partof: scala-tour + +num: 27 +next-page: polymorphic-methods +previous-page: implicit-parameters + +redirect_from: "/tutorials/tour/implicit-conversions.html" +--- + +型`S`から型`T`への暗黙の変換は`S => T`という型のimplicit値や、その型に一致するimplicitメソッドで定義されます。 + +暗黙の変換は2つの状況で適用されます。 + +* もし式`e`が型`S`であり、`S`は式の期待する型`T`に適合しない場合 +* 型`S`の`e`を使う表記`e.m`があって、セレクター`m`が`S`のメンバーではない場合 + +最初のケースでは、`e`を渡せて、戻り値の型が`T`に適合するような変換`c`を検索します。 +2つ目のケースでは、`e`を渡せて、戻り値が`m`というメンバーを持つような変換`c`を検索します。 + +implicitなメソッド`List[A] => Ordered[List[A]]`と`Int => Ordered[Int]`がスコープの中にあれば、`List[Int]`型の2つのリストにおける以下の処理は正当なものになります。 + +``` +List(1, 2, 3) <= List(4, 5) +``` +implicitなメソッド`Int => Ordered[Int]`は`scala.Predef.intWrapper`を通じて自動的に提供されます。implicitなメソッドの例`List[A] => Ordered[List[A]]`は以下にあります。 + +```tut +import scala.language.implicitConversions + +implicit def list2ordered[A](x: List[A]) + (implicit elem2ordered: A => Ordered[A]): Ordered[List[A]] = + new Ordered[List[A]] { + //replace with a more useful implementation + def compare(that: List[A]): Int = 1 + } +``` +暗黙にインポートされているオブジェクト`scala.Predef`は、頻繁に使われる型（例えば`scala.collection.immutable.Map`は`Map`と別名づけられます）とメソッド（例えば`assert`）といくつかの暗黙の型変換を宣言しています。 + +例えば、`java.lang.Integer`を受け取るようなJavaのメソッドを呼び出す時、自由に`scala.Int`を代わりに渡すことができます。それはPredefオブジェクトが以下の暗黙の変換をを含んでいるからです。 + +```tut +import scala.language.implicitConversions + +implicit def int2Integer(x: Int) = + java.lang.Integer.valueOf(x) +``` + +暗黙の変換は見境なく使われると落とし穴になり得るため、暗黙の変換の定義をコンパイルしている時にコンパイラは警告を出します。 + +警告をオフにするには、次のいずれかの措置を講じてください。 + +* 暗黙の変換定義のスコープに`scala.language.implicitConversions`をインポートする。 +* コンパイラを`-language:implicitConversions`をつけて起動する + +コンパイラにより変換が適用された時、警告は出ません。 diff --git a/_ja/tour/implicit-parameters.md b/_ja/tour/implicit-parameters.md new file mode 100644 index 0000000000..38067f9e27 --- /dev/null +++ b/_ja/tour/implicit-parameters.md @@ -0,0 +1,75 @@ +--- +layout: tour +title: 暗黙のパラメータ +language: ja + +discourse: true + +partof: scala-tour + +num: 26 +next-page: implicit-conversions +previous-page: self-types + +redirect_from: "/tutorials/tour/implicit-parameters.html" +--- + +メソッドは _暗黙の_ パラメータのリストを持つことができ、パラメータリストの先頭には _implicit_ キーワードで印をつけます。 +もしそのパラメータリストの中のパラメータがいつものように渡らなければ、Scalaは正しい型の暗黙値を受け取ることができるかを確認し、可能であればそれを自動的に渡します。 + +Scalaがこれらのパラメータを探す場所は2つのカテゴリに分かれます。 + +* Scalaはまず最初に暗黙のパラメータブロックを持つメソッドが呼び出されている箇所で、直接(プレフィックスなしに)アクセスできる暗黙の定義と暗黙のパラメータを探します。 +* 次に、候補となる型に関連づけられた全てのコンパニオンオブジェクトの中でimplicitと宣言されているメンバーを探します。 + +Scalaがimplicitをどこから見つけるかについてのより詳しいガイドは[FAQ](//docs.scala-lang.org/tutorials/FAQ/finding-implicits.html)で見ることができます。 + +以下の例では、モノイドの`add`と`unit`の演算を使い、要素のリストの合計を計算するメソッド`sum`を定義しています。 +implicitの値をトップレベルには置けないことに注意してください。 + +```tut +abstract class Monoid[A] { + def add(x: A, y: A): A + def unit: A +} + +object ImplicitTest { + implicit val stringMonoid: Monoid[String] = new Monoid[String] { + def add(x: String, y: String): String = x concat y + def unit: String = "" + } + + implicit val intMonoid: Monoid[Int] = new Monoid[Int] { + def add(x: Int, y: Int): Int = x + y + def unit: Int = 0 + } + + def sum[A](xs: List[A])(implicit m: Monoid[A]): A = + if (xs.isEmpty) m.unit + else m.add(xs.head, sum(xs.tail)) + + def main(args: Array[String]): Unit = { + println(sum(List(1, 2, 3))) // intMonoidを暗に使用 + println(sum(List("a", "b", "c"))) // stringMonoidを暗に使用 + } +} +``` +`Monoid`はここでは`add`と呼ばれる処理を定義します。この処理は`A`のペアを結合して、別の`A`を返します。また、(特定の)`A`を作ることができる`unit`と呼ばれる処理も定義します。 + +暗黙のパラメータがどのように働くかを見るため、まずは文字列と整数のためにそれぞれモノイド`stringMonoid`と`intMonoid`を定義します。`implicit`キーワードは対応するオブジェクトが暗黙に使われうることを指し示します。 + +メソッド`sum`は`List[A]`を受け取り、`A`を返します。このメソッドは初期値`A`を`unit`から受け取り、リスト中の`A`を順番に`add`メソッドで結合します。ここでパラメータ`m`をimplicitにしているのは、そのメソッドを呼び出すとき、Scalaが暗黙のパラメータ`m`として暗黙の`Monoid[A]`を見つけることができるなら、私達は`xs`パラメータを提供するだけで良いということです。 + +`main`メソッドでは`sum`を2回呼んでいて、`xs`パラメータだけを渡しています。するとScalaは先に言及したスコープの中でimplicitを探します。最初の`sum`の呼び出しは`xs`として`List[Int]`を渡します。それは `A`が`Int`であることを意味します。暗黙のパラメータリスト`m`が省略されているので、Scalaは暗黙の`Monoid[Int]`を探します。最初の探索ルールはこうでした。 + +> Scalaはまず最初に暗黙のパラメータブロックを持つメソッドが呼び出されている箇所で、直接(プレフィックスなしに)アクセスできる暗黙の定義と暗黙のパラメータを探します。 + +`intMonoid`は`main`の中で直接アクセスできる暗黙の定義です。型も一致しているので、`sum`メソッドに自動的に渡されます。 + +`sum`の2回目の呼び出しは`List[String]`を渡します。それは`A`は`String`であることを意味します。暗黙の値の探索は`Int`の時と同様に動きますが、今回は `stringMonoid`を見つけ、`m`として自動的に渡します。 + +そのプログラムは以下を出力します。 +``` +6 +abc +``` diff --git a/_ja/tour/inner-classes.md b/_ja/tour/inner-classes.md new file mode 100644 index 0000000000..4bc373d8c8 --- /dev/null +++ b/_ja/tour/inner-classes.md @@ -0,0 +1,91 @@ +--- +layout: tour +title: 内部クラス +language: ja + +discourse: true + +partof: scala-tour + +num: 22 +next-page: abstract-type-members +previous-page: lower-type-bounds + +redirect_from: "/tutorials/tour/inner-classes.html" +--- + +Scalaではクラスが他のクラスをメンバーとして保持することが可能です。 +Javaのような、内部クラスが外側のクラスのメンバーとなる言語とは対照的に、Scalaでは、内部クラスは外側のオブジェクトに束縛されます。 +どのノードがどのグラフに属しているのかを私達が混同しないように、コンパイラがコンパイル時に防いでほしいのです。 +パス依存型はその解決策の1つです。 + +その違いを示すために、グラフデータ型の実装をさっと書きます。 + +```tut +class Graph { + class Node { + var connectedNodes: List[Node] = Nil + def connectTo(node: Node) { + if (connectedNodes.find(node.equals).isEmpty) { + connectedNodes = node :: connectedNodes + } + } + } + var nodes: List[Node] = Nil + def newNode: Node = { + val res = new Node + nodes = res :: nodes + res + } +} +``` +このプログラムはグラフをノードのリスト(`List[Node]`)で表現しています。いずれのノードも接続している他のノードへのリスト(`connectedNodes`)を保持します。`class Node`は `class Graph`の中にネストしているので、 _パス依存型_ です。 +そのため`connectedNodes`の中にある全てのノードは同じ`Graph`インスタンスから`newNode`を使用して作る必要があります。 + +```tut +val graph1: Graph = new Graph +val node1: graph1.Node = graph1.newNode +val node2: graph1.Node = graph1.newNode +val node3: graph1.Node = graph1.newNode +node1.connectTo(node2) +node3.connectTo(node1) +``` +わかりやすくするため`node1`、`node2`、`node3`の型を`graph1.Node`と明示的に宣言しましたが、なくてもコンパイラは推論できます。 +これは`new Node`を呼んでいる`graph1.newNode`を呼び出す時、メソッドが`Node`のインスタンス`graph1`を使用しているからです。 + +2つのグラフがあるとき、Scalaの型システムは1つのグラフの中で定義されたノードと別のグラフで定義されたノードを混ぜることを許しません。 +それは別のグラフのノードは別の型を持つからです。 +こちらは不正なプログラムです。 + +``` +val graph1: Graph = new Graph +val node1: graph1.Node = graph1.newNode +val node2: graph1.Node = graph1.newNode +node1.connectTo(node2) // legal +val graph2: Graph = new Graph +val node3: graph2.Node = graph2.newNode +node1.connectTo(node3) // illegal! +``` +型`graph1.Node`は`graph2.Node`とは異なります。Javaであれば先のプログラム例の最後の行は正しいでしょう。 +2つのグラフのノードに対して、Javaは同じ型`Graph.Node`を指定します。つまりクラス`Graph`は`Node`の接頭辞です。 +Scalaではそのような型も同様に表現することができ、`Graph#Node`と書きます。 +もし他のグラフのノードに接続できるようにしたければ、以下の方法で最初のグラフ実装の定義を変える必要があります。 + +```tut +class Graph { + class Node { + var connectedNodes: List[Graph#Node] = Nil + def connectTo(node: Graph#Node) { + if (connectedNodes.find(node.equals).isEmpty) { + connectedNodes = node :: connectedNodes + } + } + } + var nodes: List[Node] = Nil + def newNode: Node = { + val res = new Node + nodes = res :: nodes + res + } +} +``` diff --git a/_ja/tour/lower-type-bounds.md b/_ja/tour/lower-type-bounds.md new file mode 100644 index 0000000000..d461e31e5d --- /dev/null +++ b/_ja/tour/lower-type-bounds.md @@ -0,0 +1,76 @@ +--- +layout: tour +title: 下限型境界 +language: ja + +discourse: true + +partof: scala-tour + +num: 21 +next-page: inner-classes +previous-page: upper-type-bounds +prerequisite-knowledge: upper-type-bounds, generics, variance + +redirect_from: "/tutorials/tour/lower-type-bounds.html" +--- + + [上限型境界](upper-type-bounds.html) は型を別の型のサブタイプに制限しますが、*下限型境界*は型が別の型のスーパータイプであることを宣言します。表現`B >: A`はパラメータ`B`または抽象型`B`が型`A`のスーパータイプであることを表します。ほとんどのケースで`A`はそのクラスの型パラメータであり、`B`はメソッドの型パラメータになります。 + +以下はこれが役立つ場合の例です。 + +```tut:fail +trait Node[+B] { + def prepend(elem: B): Node[B] +} + +case class ListNode[+B](h: B, t: Node[B]) extends Node[B] { + def prepend(elem: B): ListNode[B] = ListNode(elem, this) + def head: B = h + def tail: Node[B] = t +} + +case class Nil[+B]() extends Node[B] { + def prepend(elem: B): ListNode[B] = ListNode(elem, this) +} +``` + +このプログラムは片方向リストを実装します。`Nil`は空の要素（すなわち空のリスト）を意味します。 +`class ListNode`は型`B` (`head`)の要素と、リストの残りの部分(`tail`)への参照を持つノードです。 +`class Node`とそのサブタイプは、`+B`とあるので、共変です。 + +しかしながら、このプログラムはコンパイル _されません_。`prepend`のパラメータ`elem`が、宣言時に*共* 変と宣言した型`B`になっているからです。 +なぜ通らないかというと、関数はそれらの型パラメータに対して*反*変であり、それらの結果型に対して*共*変だからです。 + +これを解決するためには、`prepend`のパラメータ`elem`の型の変位指定を逆転させる必要があります。 +これを実現するには、下限型境界として`B`を持つ新しい型パラメータ`U`を導入します。 + +```tut +trait Node[+B] { + def prepend[U >: B](elem: U): Node[U] +} + +case class ListNode[+B](h: B, t: Node[B]) extends Node[B] { + def prepend[U >: B](elem: U): ListNode[U] = ListNode(elem, this) + def head: B = h + def tail: Node[B] = t +} + +case class Nil[+B]() extends Node[B] { + def prepend[U >: B](elem: U): ListNode[U] = ListNode(elem, this) +} +``` + +すると、以下のようなことができます。 +```tut +trait Bird +case class AfricanSwallow() extends Bird +case class EuropeanSwallow() extends Bird + + +val africanSwallowList= ListNode[AfricanSwallow](AfricanSwallow(), Nil()) +val birdList: Node[Bird] = africanSwallowList +birdList.prepend(new EuropeanSwallow) +``` +`Node[Bird]`は`africanSwallowList`をアサインできますが、その後`EuropeanSwallow`を受け入れられます。 + diff --git a/_ja/tour/mixin-class-composition.md b/_ja/tour/mixin-class-composition.md new file mode 100644 index 0000000000..9ec9fd65f4 --- /dev/null +++ b/_ja/tour/mixin-class-composition.md @@ -0,0 +1,84 @@ +--- +layout: tour +title: ミックスインを用いたクラス合成 +language: ja + +discourse: true + +partof: scala-tour + +num: 7 +next-page: higher-order-functions +previous-page: tuples +prerequisite-knowledge: inheritance, traits, abstract-classes, unified-types + +redirect_from: "/tutorials/tour/mixin-class-composition.html" +--- +ミックスインはクラスを構成するのに使われるトレイトです。 + +```tut +abstract class A { + val message: String +} +class B extends A { + val message = "I'm an instance of class B" +} +trait C extends A { + def loudMessage = message.toUpperCase() +} +class D extends B with C + +val d = new D +println(d.message) // I'm an instance of class B +println(d.loudMessage) // I'M AN INSTANCE OF CLASS B +``` +クラス`D`は スーパークラスを`B` とし、 ミックスイン`C`を持ちます。 +クラスは1つだけしかスーパークラスを持つことができませんが、ミックスインは複数持つことができます(キーワードはそれぞれ`extends`と`with`を使います)。 +ミックスインとスーパークラスは同じスーパータイプを持つことができます。 + +それでは抽象クラスから始まる興味深い例を見てみましょう。 + +```tut +abstract class AbsIterator { + type T + def hasNext: Boolean + def next(): T +} +``` +クラスは抽象型`T`と標準的なイテレーターのメソッドを持ちます。 +次に、（全ての抽象メンバー`T`, `hasNext`, `next`が実装を持つ）具象クラスを実装します。 + +```tut +class StringIterator(s: String) extends AbsIterator { + type T = Char + private var i = 0 + def hasNext = i < s.length + def next() = { + val ch = s charAt i + i += 1 + ch + } +} +``` +`StringIterator`は`String`を受け取り、そのStringを反復処理するために使われます。 +（例：Stringに特定の文字が含まれているかを確認するために） + +それでは`AbsIterator`を継承したトレイトも作ってみましょう。 + +```tut +trait RichIterator extends AbsIterator { + def foreach(f: T => Unit): Unit = while (hasNext) f(next()) +} +``` +このトレイトは(`while (hasNext)`で)要素がある限り、与えられた関数 `f: T => Unit`を次の要素(`next()`)に対し連続して呼び出す`foreach`メソッドを実装しています。 +`RichIterator`はトレイトなので、`RichIterator`はAbsIteratorの抽象メンバーを実装する必要がありません。 + +`StringIterator`と`RichIterator`の機能を1つのクラスに組み合わせてみましょう。 +```tut +class RichStringIter extends StringIterator("Scala") with RichIterator +val richStringIter = new RichStringIter +richStringIter foreach println +``` +新しいクラス`RichStringIter`は`StringIterator`をスーパークラスとし、`RichIterator`をミックスインとしています。 + +単一継承ではこのレベルの柔軟性を達成することはできないでしょう。 diff --git a/_ja/tour/multiple-parameter-lists.md b/_ja/tour/multiple-parameter-lists.md new file mode 100644 index 0000000000..a35bccf615 --- /dev/null +++ b/_ja/tour/multiple-parameter-lists.md @@ -0,0 +1,79 @@ +--- +layout: tour +title: 複数パラメータリスト(カリー化) +language: ja + +discourse: true + +partof: scala-tour + +num: 10 +next-page: case-classes +previous-page: nested-functions + +redirect_from: "/tutorials/tour/multiple-parameter-lists.html" +--- + +メソッドは複数のパラメータリストを持てます。 + +# 例 + +こちらはScalaのコレクションAPIの `TraversableOnce`トレイトで定義されている実例です。 + +``` +def foldLeft[B](z: B)(op: (B, A) => B): B +``` +`foldLeft`は、2つのパラメータを取る関数`op`を、初期値`z`とこのコレクションの全要素に対して左から右に適用していきます。 +以下はその使い方の例です。 + +初期値0から始まり、`foldLeft`はここではリスト内の各要素とその一つ前の累積値に関数`(m, n) => m + n`を適用します。 + +{% scalafiddle %} +```tut +val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +val res = numbers.foldLeft(0)((m, n) => m + n) +println(res) // 55 +``` +{% endscalafiddle %} + +### ユースケース +推奨される複数パラメータリストのユースケースは次の通りです。 + +#### パラメータに関数を一つ渡す場合 +パラメータに関数を一つだけ渡すのであれば、上記の`foldLeft`のケースでの`op`のように、複数パラメータリストを利用して簡潔な構文でメソッドに無名関数を渡すことができます。 +複数パラメータリストがない場合、このコードは以下のようになります。 + + +``` +numbers.foldLeft(0, (m: Int, n: Int) => m + n) +``` + +複数パラメータリストを使うことで、Scalaの型インターフェースの利点を享受でき、以下のようにコードをより簡潔にすることができるのです。 + +``` +numbers.foldLeft(0)(_ + _) +``` +単一のパラメータリストではScalaコンパイラが関数のパラメータを型推論できないので、このようなことはできません。 + +#### 暗黙のパラメータ +特定のパラメータだけを`implicit`として指定するには、`implicit`のパラメーターリストに入れなければなりません。 +こちらが例です。 + +``` +def execute(arg: Int)(implicit ec: scala.concurrent.ExecutionContext) = ??? +``` + +#### 部分適用 + +メソッドが少ない数のパラメータリストで呼び出された時、不足しているパラメータリストを引数として受け取る関数が生成されます。 +これは一般的に[部分適用](https://en.wikipedia.org/wiki/Partial_application)として知られています。 + +例えば +```tut +val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +val numberFunc = numbers.foldLeft(List[Int]()) _ +val squares = numberFunc((xs, x) => xs :+ x*x) +print(squares) // List(1, 4, 9, 16, 25, 36, 49, 64, 81, 100) +val cubes = numberFunc((xs, x) => xs :+ x*x*x) +print(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) +``` diff --git a/_ja/tour/named-arguments.md b/_ja/tour/named-arguments.md new file mode 100644 index 0000000000..b7f0ca82a2 --- /dev/null +++ b/_ja/tour/named-arguments.md @@ -0,0 +1,36 @@ +--- +layout: tour +title: 名前付き引数 +language: ja + +discourse: true + +partof: scala-tour + +num: 34 +next-page: packages-and-imports +previous-page: default-parameter-values +prerequisite-knowledge: function-syntax + +redirect_from: "/tutorials/tour/named-arguments.html" +--- + +メソッドを呼ぶ時、以下のように引数にパラメータ名でラベル付が可能です。 + +```tut +def printName(first: String, last: String): Unit = { + println(first + " " + last) +} + +printName("John", "Smith") // Prints "John Smith" +printName(first = "John", last = "Smith") // Prints "John Smith" +printName(last = "Smith", first = "John") // Prints "John Smith" +``` + +名前付き引数の順序はどのように並び替えられるかに気をつけましょう。ただし、名前つき引数と名前つきでない引数がある場合は、名前つきでない引数は引数リストの最初に置かれ、かつメソッドシグネチャのパラメーター順でなければなりません。 + +```tut:fail +printName(last = "Smith", "john") // error: positional after named argument +``` + +名前付き引数はJavaメソッドを呼び出す時には使えません。 diff --git a/_ja/tour/nested-functions.md b/_ja/tour/nested-functions.md new file mode 100644 index 0000000000..05a57a2fae --- /dev/null +++ b/_ja/tour/nested-functions.md @@ -0,0 +1,40 @@ +--- +layout: tour +title: ネストしたメソッド +language: ja + +discourse: true + +partof: scala-tour + +num: 9 +next-page: multiple-parameter-lists +previous-page: higher-order-functions + +redirect_from: "/tutorials/tour/nested-functions.html" +--- + +Scalaではメソッドの定義をネストする（_訳注：入れ子にする_）ことができます。 +以下のコードは与えられた数値の階乗を計算するための`factorial`メソッドを提供します。 + +{% scalafiddle %} +```tut + def factorial(x: Int): Int = { + def fact(x: Int, accumulator: Int): Int = { + if (x <= 1) accumulator + else fact(x - 1, x * accumulator) + } + fact(x, 1) + } + + println("Factorial of 2: " + factorial(2)) + println("Factorial of 3: " + factorial(3)) +``` +{% endscalafiddle %} + +このプログラムの出力は以下の通りです。 + +``` +Factorial of 2: 2 +Factorial of 3: 6 +``` diff --git a/_ja/tour/operators.md b/_ja/tour/operators.md new file mode 100644 index 0000000000..b61b229558 --- /dev/null +++ b/_ja/tour/operators.md @@ -0,0 +1,88 @@ +--- +layout: tour +title: 演算子 +language: ja + +discourse: true + +partof: scala-tour + +num: 30 +next-page: by-name-parameters +previous-page: type-inference +prerequisite-knowledge: case-classes + +redirect_from: "/tutorials/tour/operators.html" +--- +Scalaでは演算子はメソッドです。パラメータを1つだけ持つメソッドであれば*中置演算子*として使えます。例えば、`+`はドット記法で呼び出せます。 + +``` +10.+(1) +``` + +しかしながら、中置演算子の方が読みやすいです。 + +``` +10 + 1 +``` + +## 演算子の定義方法と使い方 + +有効な識別子であれば演算子として使用できます。これは `add`のような名前も`+`のような記号も含みます。 +```tut +case class Vec(val x: Double, val y: Double) { + def +(that: Vec) = new Vec(this.x + that.x, this.y + that.y) +} + +val vector1 = Vec(1.0, 1.0) +val vector2 = Vec(2.0, 2.0) + +val vector3 = vector1 + vector2 +vector3.x // 3.0 +vector3.y // 3.0 +``` +クラスVecはメソッド`+`を持ち、 `vector1`と`vector2`を足しわせるのに使います。丸括弧を用いて、複雑な式を読みやすい構文で作ることができます。 +こちらはクラス`MyBool`の定義です。クラス`MyBool`はメソッド`and`と`or`を含みます。 + +```tut +case class MyBool(x: Boolean) { + def and(that: MyBool): MyBool = if (x) that else this + def or(that: MyBool): MyBool = if (x) this else that + def negate: MyBool = MyBool(!x) +} +``` + +この時、`and`と`or`を中置演算子として使えます。 + +```tut +def not(x: MyBool) = x.negate +def xor(x: MyBool, y: MyBool) = (x or y) and not(x and y) +``` + +これにより`xor`の定義がより読みやすくなります。 + +## 優先順位 + +式が複数の演算子を使う時、それらの演算子は最初の文字の（以下に挙げる）優先度に基づき評価されます。 +``` +(以下に表示されていない記号) +* / % ++ - +: += ! +< > +& +^ +| +(全ての文字) +``` +これはあなたが定義した関数にも適用できます。 +たとえば、以下の式 +``` +a + b ^? c ?^ d less a ==> b | c +``` +は以下と同じ意味です。 +``` +((a + b) ^? (c ?^ d)) less ((a ==> b) | c) +``` +`?^`は最も高い優先順位を持ちます。`?^`は`?`から始まるからです。`+`は二番目に高い優先順位を持ち、その後に`==>`、 `^?`、 `|`、 そして`less`が続きます。 diff --git a/_ja/tour/package-objects.md b/_ja/tour/package-objects.md new file mode 100644 index 0000000000..fd7eaced57 --- /dev/null +++ b/_ja/tour/package-objects.md @@ -0,0 +1,73 @@ +--- +layout: tour +title: パッケージオブジェクト +language: ja + +discourse: true + +partof: scala-tour + +num: 36 +previous-page: packages-and-imports +--- + +# パッケージオブジェクト + +Scalaはパッケージ全体を通して共有される便利なコンテナとしてパッケージオブジェクトを提供します。 + +パッケージオブジェクトは、変数やメソッド定義だけでなく、任意の定義を含むことができます。 +例えば、それらはパッケージ全体で使われる型エイリアスと暗黙の変換を保有するためによく使われます。 +パッケージオブジェクトはScalaクラスやトレイトを継承することもできます。 + +慣習として、パッケージオブジェクトのソースコードは通常`package.scala`という名のソースファイルに設置されます。 + +1つのパッケージはパッケージオブジェクトを1つ持てます。パッケージオブジェクト内の全ての定義はパッケージ自体のメンバーと見なされます。 + +以下の例を見てみましょう。まず1つのクラス`Fruit`と3つの`Fruit`オブジェクトがパッケージ`gardening.fruits`にあるとします。 + +``` +// ファイル gardening/fruits/Fruit.scala の中 +package gardening.fruits + +case class Fruit(name: String, color: String) +object Apple extends Fruit("Apple", "green") +object Plum extends Fruit("Plum", "blue") +object Banana extends Fruit("Banana", "yellow") +``` + +ここで、変数`planted`とメソッド`showFruit`を直接パッケージ`gardening.fruits`内に置きたいとします。 +こちらがその方法になります。 + +``` +// ファイル gardening/fruits/package.scala の中 +package gardening +package object fruits { + val planted = List(Apple, Plum, Banana) + def showFruit(fruit: Fruit): Unit = { + println(s"${fruit.name}s are ${fruit.color}") + } +} +``` + +利用側がどのようになるかの例としては、以下のオブジェクト`PrintPlanted`は、ワイルドカードインポートでクラス`Fruit`と全く同様に`planted`と`showFruit`をインポートしています。 + +``` +// ファイル PrintPlanted.scala の中 +import gardening.fruits._ +object PrintPlanted { + def main(args: Array[String]): Unit = { + for (fruit <- fruits.planted) { + showFruit(fruit) + } + } +} +``` + +パッケージオブジェクトは他のオブジェクトのように、継承を利用して構成できます。例えば、一つのパッケージオブジェクトが２つのトレイトをミックスインしている例を示します。 + +``` +package object fruits extends FruitAliases with FruitHelpers { + // ヘルパーと変数がここに続きます。 +} +``` +メソッドオーバーライドはパッケージオブジェクト内では動作しないので気をつけましょう。 diff --git a/_ja/tour/packages-and-imports.md b/_ja/tour/packages-and-imports.md new file mode 100644 index 0000000000..dd2e42f844 --- /dev/null +++ b/_ja/tour/packages-and-imports.md @@ -0,0 +1,87 @@ +--- +layout: tour +title: パッケージとインポート +language: ja + +discourse: true + +partof: scala-tour + +num: 35 +previous-page: named-arguments +next-page: package-objects +--- + +# パッケージとインポート +Scalaは名前空間を作るためにパッケージを使います。名前空間によりプログラムをモジュール化できます。 + +## パッケージの作成 +Scalaファイルの先頭で1つ以上のパッケージ名を宣言することでパッケージは作られます。 + +``` +package users + +class User +``` +パッケージとScalaファイルが含まれるディレクトリは同じ名前をつける習慣があります。しかし、Scalaはファイルのレイアウトには関知しません。`package users`を含むsbtプロジェクトのディレクトリ構成はこのようになるかもしれません。 + +``` +- ExampleProject + - build.sbt + - project + - src + - main + - scala + - users + User.scala + UserProfile.scala + UserPreferences.scala + - test +``` +`users`ディレクトリがどのように`scala`ディレクトリの中にあり、複数のScalaファイルがどのようにパッケージ内にあるのかに注意してください。パッケージ内のScalaファイルは同じパッケージ宣言を持ちます。パッケージ宣言の他の方法は波括弧を使い以下のようにします。 + +``` +package users { + package administrators { + class NormalUser + } + package normalusers { + class NormalUser + } +} +``` +見ての通り、この方法はパッケージのネストができ、スコープとカプセル化をより強くコントロールできます。 + +パッケージ名は全て小文字で書き、もしコードがwebサイトを持つ組織によって開発される場合、慣習として次のフォーマットであるべきです。`<トップレベルドメイン>.<ドメイン名>.<プロジェクト名>`。例えば、Googleが`SelfDrivingCar`と呼ばれるプロジェクトを持っている場合、パッケージ名はこんな風になるでしょう。 +``` +package com.google.selfdrivingcar.camera + +class Lens +``` +これは次のディレクトリ構成に対応します。`SelfDrivingCar/src/main/scala/com/google/selfdrivingcar/camera/Lens.scala` + +## インポート +`import`句は他パッケージのメンバー（クラス、トレイト、関数など）にアクセスするためのものです。同じパッケージのメンバーにアクセスするには`import`句は必要ありません。import句は以下のどれでも使えます。 +``` +import users._ // usersパッケージから全てをインポートする +import users.User // クラスUserをインポートする +import users.{User, UserPreferences} // 選択されたメンバーのみインポートする +import users.{UserPreferences => UPrefs} // インポートし利便性のために名前を変更する +``` +ScalaのJavaと異なる点の1つはインポートがどこでも使える点です。 + +```tut +def sqrtplus1(x: Int) = { + import scala.math.sqrt + sqrt(x) + 1.0 +} +``` +名前競合があり、プロジェクトのルートから何かをインポートする必要がある時、パッケージ名の前に`_root_`をつけます。 +``` +package accounts + +import _root_.users._ +``` + + +注：`scala`と`java.lang` パッケージは`object Predef`と同じように標準でインポートされています。 diff --git a/_ja/tour/pattern-matching.md b/_ja/tour/pattern-matching.md new file mode 100644 index 0000000000..d44d13e41b --- /dev/null +++ b/_ja/tour/pattern-matching.md @@ -0,0 +1,166 @@ +--- +layout: tour +title: パターンマッチング +language: ja + +discourse: true + +partof: scala-tour + +num: 12 + +next-page: singleton-objects +previous-page: case-classes +prerequisite-knowledge: case-classes, string-interpolation, subtyping + +redirect_from: "/tutorials/tour/pattern-matching.html" +--- + +パターンマッチングは値をパターンに照合するための仕組みです。 +マッチに成功すれば、一つの値をその構成要素のパーツに分解することもできます。 +Javaの`switch`文の強化バージョンで、if/else文の連続の代わりとして同様に使うことができます。 + +## 構文 + +マッチ式は値、キーワード`match`と少なくとも1つの`case`句を持ちます。 +```tut +import scala.util.Random + +val x: Int = Random.nextInt(10) + +x match { + case 0 => "zero" + case 1 => "one" + case 2 => "two" + case _ => "other" +} +``` +上記の`val x`は0から10の間のランダムな整数です。`x`は`match`演算子の左オペランドで、右側は4つのケースを持つ式です。 +最後のケース`_`は その他の取りうる整数値のための"全てを捕捉する"ケースです。 +ケースは*オルタナティブ*とも呼ばれます。 + +マッチ式は値を持ちます。 +```tut +def matchTest(x: Int): String = x match { + case 1 => "one" + case 2 => "two" + case _ => "other" +} +matchTest(3) // other +matchTest(1) // one +``` +全てのケースでStringを返しているので、このマッチ式はString型を持ちます。 +そのため関数`matchTest`はStringを返します。 + +## ケースクラスでのマッチング + +ケースクラスはパターンマッチングで特に役立ちます。 + +```tut +abstract class Notification + +case class Email(sender: String, title: String, body: String) extends Notification + +case class SMS(caller: String, message: String) extends Notification + +case class VoiceRecording(contactName: String, link: String) extends Notification + +``` +`Notification`は抽象スーパークラスで、ケースクラスの実装`Email`、 `SMS`、 `VoiceRecording`3つの具象クラスがあります。 +今、これらのケースクラスでパターンマッチングをすることができます。 + +``` +def showNotification(notification: Notification): String = { + notification match { + case Email(sender, title, _) => + s"You got an email from $sender with title: $title" + case SMS(number, message) => + s"You got an SMS from $number! Message: $message" + case VoiceRecording(name, link) => + s"you received a Voice Recording from $name! Click the link to hear it: $link" + } +} +val someSms = SMS("12345", "Are you there?") +val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") + +println(showNotification(someSms)) // You got an SMS from 12345! Message: Are you there? が出力されます。 + +println(showNotification(someVoiceRecording)) // you received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123 が出力されます。 +``` +関数`showNotification`は抽象型`Notification`をパラメータとして受け取り、`Notification`の型でマッチします（すなわち`Email`、`SMS`、または `VoiceRecording`のいずれであるかを解決します）。 +`case Email(sender, title, _)` ではフィールド`sender`と`title`が戻り値として使われますが、`_`を使うことでフィールド`body`は無視されます。 + +## パターンガード +パターンガードはケースをより具体的にするために使われる簡単な真偽表現です。 +`if `をパターンの後ろに追加するだけです。 + +``` + +def showImportantNotification(notification: Notification, importantPeopleInfo: Seq[String]): String = { + notification match { + case Email(sender, _, _) if importantPeopleInfo.contains(sender) => + "You got an email from special someone!" + case SMS(number, _) if importantPeopleInfo.contains(number) => + "You got an SMS from special someone!" + case other => + showNotification(other) // 特別なものではなく、オリジナルのshowNotification関数に委譲します。 + } +} + +val importantPeopleInfo = Seq("867-5309", "jenny@gmail.com") + +val someSms = SMS("867-5309", "Are you there?") +val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") +val importantEmail = Email("jenny@gmail.com", "Drinks tonight?", "I'm free after 5!") +val importantSms = SMS("867-5309", "I'm here! Where are you?") + +println(showImportantNotification(someSms, importantPeopleInfo)) +println(showImportantNotification(someVoiceRecording, importantPeopleInfo)) +println(showImportantNotification(importantEmail, importantPeopleInfo)) +println(showImportantNotification(importantSms, importantPeopleInfo)) +``` + +`case Email(sender, _, _) if importantPeopleInfo.contains(sender)`では、パターンは`sender`が重要な人のリストに存在して初めてマッチします。 + +## 型のみでのマッチング + +以下のように型のみでマッチすることができます。 +```tut +abstract class Device +case class Phone(model: String) extends Device{ + def screenOff = "Turning screen off" +} +case class Computer(model: String) extends Device { + def screenSaverOn = "Turning screen saver on..." +} + +def goIdle(device: Device) = device match { + case p: Phone => p.screenOff + case c: Computer => c.screenSaverOn +} +``` +`def goIdle`は`Device`の型によって異なる振る舞いをします。 +これはケースがそのパターンのメソッドを呼び出す必要がある時に役立ちます。 +ケースの識別子には型の最初の一文字（この場合に`p`と`c`）を利用する慣習があります。 + +## シールドクラス +トレイトとクラスに`sealed`をつけると、全てのサブタイプは同一ファイル内で宣言されなければならないという意味になります。 +これは全てのサブタイプが既知であることを保証します。 + +```tut +sealed abstract class Furniture +case class Couch() extends Furniture +case class Chair() extends Furniture + +def findPlaceToSit(piece: Furniture): String = piece match { + case a: Couch => "Lie on the couch" + case b: Chair => "Sit on the chair" +} +``` +これは"全てに対応する"ケースを必要としなくて済むので、パターンマッチングで役立ちます。 + +## 注意 +Scalaのパターンマッチング文は[ケースクラス](case-classes.html)で表現される代数型のマッチングに最も役立ちます。 + + +Scalaでは[抽出子オブジェクト](extractor-objects.html)の`unapply`メソッドを使うと、ケースクラスのパターンを独自に定義することもできます。 diff --git a/_ja/tour/polymorphic-methods.md b/_ja/tour/polymorphic-methods.md new file mode 100644 index 0000000000..0770657246 --- /dev/null +++ b/_ja/tour/polymorphic-methods.md @@ -0,0 +1,39 @@ +--- +layout: tour +title: ポリモーフィックメソッド +language: ja + +discourse: true + +partof: scala-tour + +num: 28 + +next-page: type-inference +previous-page: implicit-conversions +prerequisite-knowledge: unified-types + +redirect_from: "/tutorials/tour/polymorphic-methods.html" +--- + +Scalaのメソッドは値と同様に型によってパラメータ化することができます。構文はジェネリッククラスの構文と似ています。 +値パラメータは丸括弧で囲まれるのに対して、型パラメータは角カッコで囲まれます。 + +こちらが例です。 + +```tut +def listOfDuplicates[A](x: A, length: Int): List[A] = { + if (length < 1) + Nil + else + x :: listOfDuplicates(x, length - 1) +} +println(listOfDuplicates[Int](3, 4)) // List(3, 3, 3, 3) +println(listOfDuplicates("La", 8)) // List(La, La, La, La, La, La, La, La) +``` + +メソッド`listOfDuplicates`は型パラメータ`A`と値パラメータ`x`と`length`を受け取ります。値`x`の型は`A`です。もし`length < 1`なら空のリストを返します。それ以外の場合は`x`を再帰呼び出しで返された複写リストの先頭に追加します。(`::`の意味は、左辺の要素を右辺のリストの先頭に追加することです。) + +最初の呼び出し例では、`[Int]`と書いて明示的に型引数を渡しています。そのため最初の引数は`Int`でなければならず、戻される型は`List[Int]`となります。 + +2つ目の呼び出し例では必ずしも明示的に型パラメータを渡す必要がないことを示しています。コンパイラは文脈または値引数の型に基づき、型パラメータを推論できることが多いです。この例では`"La"`が`String`なので、コンパイラは`A`が`String`に違いないことが分かります。 diff --git a/_ja/tour/regular-expression-patterns.md b/_ja/tour/regular-expression-patterns.md new file mode 100644 index 0000000000..21068d1de1 --- /dev/null +++ b/_ja/tour/regular-expression-patterns.md @@ -0,0 +1,63 @@ +--- +layout: tour +title: 正規表現パターン +language: ja + +discourse: true + +partof: scala-tour + +num: 15 + +next-page: extractor-objects +previous-page: singleton-objects + +redirect_from: "/tutorials/tour/regular-expression-patterns.html" +--- +正規表現はデータの中からパターン（またはその欠如）を探すために使うことができる文字列です。 +どんな文字列も`.r`メソッドを使うことで、正規表現に変換できます。 + +```tut +import scala.util.matching.Regex + +val numberPattern: Regex = "[0-9]".r + +numberPattern.findFirstMatchIn("awesomepassword") match { + case Some(_) => println("Password OK") + case None => println("Password must contain a number") +} +``` +上記の例では、`numberPattern`は`Regex`(正規表現)型で、パスワードに数字が含まれていることを確認するのに使います。 + +括弧を使うことで、正規表現のグループを探すこともできます。 + +```tut +import scala.util.matching.Regex + +val keyValPattern: Regex = "([0-9a-zA-Z-#() ]+): ([0-9a-zA-Z-#() ]+)".r + +val input: String = + """background-color: #A03300; + |background-image: url(img/header100.png); + |background-position: top center; + |background-repeat: repeat-x; + |background-size: 2160px 108px; + |margin: 0; + |height: 108px; + |width: 100%;""".stripMargin + +for (patternMatch <- keyValPattern.findAllMatchIn(input)) + println(s"key: ${patternMatch.group(1)} value: ${patternMatch.group(2)}") +``` +ここでは、文字列のキーと値を解析しています。 +それぞれのマッチはサブマッチのグループを持ちます。こちらが出力結果です。 +``` +key: background-color value: #A03300 +key: background-image value: url(img/header100.png) +key: background-position value: top center +key: background-repeat value: repeat-x +key: background-size value: 2160px 108px +key: margin value: 0 +key: height value: 108px +key: width value: 100 +``` diff --git a/_ja/tour/self-types.md b/_ja/tour/self-types.md new file mode 100644 index 0000000000..836e4459ec --- /dev/null +++ b/_ja/tour/self-types.md @@ -0,0 +1,42 @@ +--- +layout: tour +title: 自分型 +language: ja + +discourse: true + +partof: scala-tour + +num: 25 +next-page: implicit-parameters +previous-page: compound-types +topics: self-types +prerequisite-knowledge: nested-classes, mixin-class-composition + +redirect_from: "/tutorials/tour/self-types.html" +--- +自分型は、直接継承していなくてもトレイトが他のトレイトにミックスインされていることを宣言する方法です。 +これにより依存先のメンバーをimportなしで利用できます。 + +自分型は`this`、または`this`の別名となる他の識別子の型を絞り込む方法です。 +その構文は普通の関数構文のように見えますが、全く異なる意味があります。 + +トレイトで自分型を使うには、識別子、ミックスインする他のトレイトの型、`=>`を書きます(例えば `someIdentifier: SomeOtherTrait =>`)。 +```tut +trait User { + def username: String +} + +trait Tweeter { + this: User => // thisが再割り当てされます + def tweet(tweetText: String) = println(s"$username: $tweetText") +} + +class VerifiedTweeter(val username_ : String) extends Tweeter with User { // TweeterがUserを必要とするためミックスインします。 + def username = s"real $username_" +} + +val realBeyoncé = new VerifiedTweeter("Beyoncé") +realBeyoncé.tweet("Just spilled my glass of lemonade") // "real Beyoncé: Just spilled my glass of lemonade"と出力します。 +``` +`trait Tweeter`の中で`this: User =>`と記述したので、今は変数`username`は`tweet`メソッドのスコープ内にあります。これはさらに、`VerifiedTweeter`が`Tweeter`を継承する際、(`with User`を使って)`User`もミックスインしなければならいことを意味します。 diff --git a/_ja/tour/singleton-objects.md b/_ja/tour/singleton-objects.md new file mode 100644 index 0000000000..e920e884c9 --- /dev/null +++ b/_ja/tour/singleton-objects.md @@ -0,0 +1,122 @@ +--- +layout: tour +title: シングルトンオブジェクト +language: ja + +discourse: true + +partof: scala-tour + +num: 13 + +next-page: regular-expression-patterns +previous-page: pattern-matching +redirect_from: "/tutorials/tour/singleton-objects.html" +prerequisite-knowledge: classes, methods, private-methods, packages, option +--- +オブジェクトは丁度1つのインスタンスを持つクラスです。 +それはlazy valのように参照された際に遅れて作られます。 + +トップレベルにあるオブジェクトは、シングルトンです。 +クラスのメンバーやローカル変数としてのオブジェクトは、lazy valと全く同じように振る舞います。 + +# シングルトンオブジェクトの定義 +オブジェクトは値です。オブジェクトの定義はクラスのように見えますが、キーワード`object`を使います。 +```tut +object Box +``` +これはメソッドを持つオブジェクトの例です。 +``` +package logging + +object Logger { + def info(message: String): Unit = println(s"INFO: $message") +} +``` +`info`メソッドはプログラム上のどこからでもimportすることができます。 +このように便利なメソッドを作ることはシングルトンオブジェクトのユースケースと同じです。 + +他のパッケージで`info`がどのように使われるか見てみましょう。 + +``` +import logging.Logger.info + +class Project(name: String, daysToComplete: Int) + +class Test { + val project1 = new Project("TPS Reports", 1) + val project2 = new Project("Website redesign", 5) + info("Created projects") // Prints "INFO: Created projects" +} +``` + +import文`import logging.Logger.info`により、`info`メソッドが見えるようになります。 + +import文には取り込むシンボルへの"変動しないパス"が必要であり、オブジェクトは変動しないパスとなります。 + +注意：`object`がトップレベルではなく他のクラスやオブジェクトにネストされている時、そのオブジェクトは他のメンバーのように"経路依存性"があります。 +これは2種類の飲み物`class 牛乳`と`class オレンジジュース`が与えられた場合、クラスメンバーの`object 栄養素`はそれが属するインスタンス、すなわち牛乳またはオレンジジュースのいずれかに依存することを意味します。 +`milk.NutritionInfo`は`oj.NutritionInfo`とは全く異なります。 + +## コンパニオンオブジェクト + +クラスと同じ名前のオブジェクトは*コンパニオンオブジェクト*と呼ばれます。 +逆にそのクラスはオブジェクトのコンパニオンクラスと呼ばれます。 +コンパニオンクラスやコンパニオンオブジェクトは自身のコンパニオンのプライベートメンバーにアクセスできます。 +コンパニオンクラスのインスタンスに特定されないメソッドや値にはコンパニオンオブジェクトを使います。 + +``` +import scala.math._ + +case class Circle(radius: Double) { + import Circle._ + def area: Double = calculateArea(radius) +} + +object Circle { + private def calculateArea(radius: Double): Double = Pi * pow(radius, 2.0) +} + +val circle1 = new Circle(5.0) + +circle1.area +``` + +`class Circle`は各インスタンスの固有のメンバー`area`を持ち、シングルトンオブジェクト`object Circle`は全てのインスタンスで利用できる`calculateArea`メソッドを持ちます。 + +コンパニオンオブジェクトはファクトリーメソッドを含むことができます。 +```tut +class Email(val username: String, val domainName: String) + +object Email { + def fromString(emailString: String): Option[Email] = { + emailString.split('@') match { + case Array(a, b) => Some(new Email(a, b)) + case _ => None + } + } +} + +val scalaCenterEmail = Email.fromString("scala.center@epfl.ch") +scalaCenterEmail match { + case Some(email) => println( + s"""Registered an email + |Username: ${email.username} + |Domain name: ${email.domainName} + """) + case None => println("Error: could not parse email") +} +``` +`object Email`はファクトリー`fromString`を持ち、Stringから`Email`インスタンスを作ります。 +パースエラーの場合も考えて、返り値の型を`Option[Email]`とします。 + +注意：クラスまたはオブジェクトがコンパニオンを持つ場合、クラス、オブジェクトの両方は同じファイルの中に定義されていなければなりません。 +REPL内でコンパニオンを定義する場合は、それらを同じ行で定義するか、`:paste`モードに入ります。 + +## Javaプログラマのための注意事項 ## + +Javaにおける`static`メンバーはScalaではコンパニオンオブジェクトの一般メンバーとして作られています。 + +Javaのコードからコンパニオンオブジェクトを使う場合、メンバーはコンパニオンクラス内で`static`識別子を用いて定義されます。 +これは*static forwarding*と呼ばれます。 +これはコンパニオンクラスを自分で定義していなかったとしても起きます。 diff --git a/_ja/tour/tour-of-scala.md b/_ja/tour/tour-of-scala.md new file mode 100644 index 0000000000..775c66557f --- /dev/null +++ b/_ja/tour/tour-of-scala.md @@ -0,0 +1,86 @@ +--- +layout: tour +title: 前書き +language: ja + +discourse: true + +partof: scala-tour + +num: 1 + +next-page: basics + +redirect_from: "/tutorials/tour/tour-of-scala.html" +--- + +## ようこそツアーへ +このツアーはScalaで最もよく使う機能を一口サイズで紹介をしています。 +これらはScala初心者を対象としています。 + +これはほんの短いツアーで、完全な言語のチュートリアルではありません。 +もしそれを望むなら、[こちらの本](/books.html) を手に入れるか、 +[その他の解決手段](/learn.html) での相談を検討してください。 + +## Scalaとは？ +Scalaは一般的なプログラミング方法を簡潔かつエレガントかつ型安全な方法で表現するために設計されたモダンなマルチパラダイム言語です。 +それはオブジェクト指向言語と関数型言語の機能をスムーズに統合しています。 + +## Scalaはオブジェクト指向 ## +Scalaは[全ての値がオブジェクトである](unified-types.html) という意味では純粋オブジェクト指向言語です。 +型とオブジェクトの振る舞いは[クラス](classes.html) と[トレイト](traits.html) によって記述されます。 +クラスはサブクラス化と、多重継承を巧みに置き換える柔軟な[ミックスインを基にした合成](mixin-class-composition.html) 機構により拡張されます。 + +## Scalaは関数型 ## +Scalaは[すべての関数が値である](unified-types.html) という意味で関数型言語でもあります。 +Scalaは無名関数を定義するために[軽量な構文](basics.html#関数)を提供し、 +[高階関数](higher-order-functions.html) をサポートし、関数は[ネスト](nested-functions.html)しても良く、[カリー化](multiple-parameter-lists.html) をサポートします。 +Scalaの[ケースクラス](case-classes.html)には[パターンマッチング](pattern-matching.html)が組み込まれていることにより、多くの関数型プログラミング言語で使われる代数型を作ることができます。 +[シングルトンオブジェクト](singleton-objects.html) はクラスのメンバーではない関数をグループ化する便利な方法を提供します。 + +さらに、Scalaのパターンマッチングの概念は、[抽出子オブジェクト](extractor-objects.html) による一般的な拡張として、[右無視シーケンスパターン](regular-expression-patterns.html)の働きにより、自然に[XMLデータの処理](https://github.com/scala/scala-xml/wiki/XML-Processing) にまで拡張されています。 +（訳者註：現在のバージョンでは右無視シーケンスパターンの説明は正規表現のページから除かれています。[→古いバージョン](https://www.scala-lang.org/old/node/122)） +この文脈では、For内包表記はクエリの設計に役立ちます。 +これらの機能により、ScalaはWebサービスのようなアプリケーション開発に理想的なものとなっています。 + +## Scalaは静的型付け ## +Scalaは抽象化が安全で首尾一貫した方法で使われることをコンパイル時に強制する、表現力豊かな型システムを備えています。 +特にその型システムは以下をサポートします: + +* [ジェネリッククラス](generic-classes.html) +* [変位指定アノテーション](variances.html) +* [上限](upper-type-bounds.html) と [下限](lower-type-bounds.html) 型境界 +* [内部クラス](inner-classes.html) とオブジェクトメンバーとしての[抽象型メンバー](abstract-type-members.html) +* [複合型](compound-types.html) +* [明示的に型指定された自己参照](self-types.html) +* [暗黙パラメーター](implicit-parameters.html) と [暗黙の変換](implicit-conversions.html) +* [ポリモーフィックメソッド](polymorphic-methods.html) + +[型推論](type-inference.html) は、ユーザーがコードに冗長な型情報の注釈をつける必要はないことを意味します。 +これらの機能を組み合わせることにより、プログラミングの抽象化を安全に再利用でき、ソフトウェアを型安全に拡張できる強力な基盤となります。 + +## Scalaは拡張可能 ## + +実際問題として、ドメイン固有のアプリケーションの開発ではよくドメイン固有の言語拡張が必要となります。 +Scalaは言語メカニズムのユニークな組み合わせを提供します。それにより、新しい言語構成要素をライブラリという形で円滑に追加することを簡単にします。 + +多くのケースで、これはマクロのようなメタプログラミングの機能を使わずに実現できます。例えば、 + +* [暗黙のクラス](http://docs.scala-lang.org/overviews/core/implicit-classes.html) で既存の型に拡張メソッドを追加できます。 + +* [文字列補間](/ja/overviews/core/string-interpolation.html) はカスタム補間を使ってユーザー拡張可能です。 + +## Scalaの相互運用 + +Scalaは一般的なJava実行環境 (JRE) と相互運用するように設計されています。 +特に、主流であるオブジェクト指向のJavaプログラミング言語とのやり取りはできるだけスムーズになっています。 +ScalaではSAMs、[ラムダ](higher-order-functions.html) 、[アノテーション](annotations.html) 、[ジェネリクス](generic-classes.html) のようなJavaの新しい機能には直接の類似物があります。 + +[デフォルト引数](default-parameter-values.html) 、[名前付きパラメータ](named-arguments.html) +といった、Javaに類似物がないScalaの機能はできるだけ適切でJavaに近い形にコンパイルされます。 +ScalaはJavaのような同じコンパイルモデル(分割コンパイル、動的クラス読み込み) を持っており、数千の既存の高品質なライブラリにアクセスができます。 + +## ツアーを楽しんで! + +もっと読むには、目次メニューの[次のページ](basics.html) に進んでください。 + diff --git a/_ja/tour/traits.md b/_ja/tour/traits.md new file mode 100644 index 0000000000..1ea0b11809 --- /dev/null +++ b/_ja/tour/traits.md @@ -0,0 +1,89 @@ +--- +layout: tour +title: トレイト +language: ja + +discourse: true + +partof: scala-tour + +num: 5 +next-page: tuples +previous-page: classes +topics: traits +prerequisite-knowledge: expressions, classes, generics, objects, companion-objects + +redirect_from: "/tutorials/tour/traits.html" +--- + +トレイトはクラス間でインターフェースとフィールドを共有するために使います。それらはJava 8のインターフェースと似ています。 +クラスとオブジェクトはトレイトを継承することができますが、トレイトはインスタンス化ができません、したがってパラメータを持ちません。 + +## トレイトを定義する +最小のトレイトはキーワード `trait` と識別子だけというものです。 + +```tut +trait HairColor +``` + +トレイトはジェネリック型として、抽象メソッドとあわせて使うと特に便利です。 +```tut +trait Iterator[A] { + def hasNext: Boolean + def next(): A +} +``` + +`trait Iterator[A]` を継承することは `A` 型と、`hasNext` と `next` メソッドの実装を必要とします。 + +## トレイトの使い方 +トレイトを継承するには `extends` キーワードを使います。その際に、 `override` キーワードを利用しすべての抽象メンバーを実装します。 +```tut +trait Iterator[A] { + def hasNext: Boolean + def next(): A +} + +class IntIterator(to: Int) extends Iterator[Int] { + private var current = 0 + override def hasNext: Boolean = current < to + override def next(): Int = { + if (hasNext) { + val t = current + current += 1 + t + } else 0 + } +} + + +val iterator = new IntIterator(10) +iterator.next() // returns 0 +iterator.next() // returns 1 +``` +ここでの `IntIterator` クラスは上限として引数 `to` を取ります。 +`extends Iterator[Int]` は `next` メソッドは Int を返さなければならないことを意味します。 + +## サブタイピング +あるトレイトが必要とされている場所に、代りにそのトレイトのサブタイプを使うことができます。 + +```tut +import scala.collection.mutable.ArrayBuffer + +trait Pet { + val name: String +} + +class Cat(val name: String) extends Pet +class Dog(val name: String) extends Pet + +val dog = new Dog("Harry") +val cat = new Cat("Sally") + +val animals = ArrayBuffer.empty[Pet] +animals.append(dog) +animals.append(cat) +animals.foreach(pet => println(pet.name)) // Prints Harry Sally +``` +`trait Pet` が持つ抽象フィールド `name`は、Cat と Dog のコンストラクタで実装されました。 +最終行では、`Pet` トレイトの全てのサブタイプの中で実装される必要がある `pet.name` を呼んでいます。 diff --git a/_ja/tour/tuples.md b/_ja/tour/tuples.md new file mode 100644 index 0000000000..0d67f6c5c1 --- /dev/null +++ b/_ja/tour/tuples.md @@ -0,0 +1,79 @@ +--- +layout: tour +title: タプル +language: ja + +discourse: true + +partof: scala-tour + +num: 6 +next-page: mixin-class-composition +previous-page: traits +topics: tuples + +redirect_from: "/tutorials/tour/tuples.html" +--- + +Scalaではタプルは決まった数の要素を含む値であり、各要素はそれぞれの型を持ちます。 +タプルは不変です。 + +タプルはメソッドから複数の値を返す際に特に役立ちます。 + +2つの要素を持つタプルは以下のように作ることができます。 + +```tut +val ingredient = ("Sugar" , 25) +``` +ここでは`String`要素を1つと`Int`要素を1つ含むタプルを作っています。 + +推論される`ingredient`の型は`(String, Int)`であり、これは`Tuple2[String, Int]`の簡単な表記法です。 + +タプルを表すために、Scalaは`Tuple2`, `Tuple3` … `Tuple22`までのクラス群を使います。 +それぞれのクラスは要素の数と同じ数の型パラメータを持ちます。 + +## 要素へのアクセス + +タプルの要素へのアクセス方法の1つとして、位置があります。 +個々の要素は`_1`、`_2`などと名付けられます。 + +```tut +println(ingredient._1) // Sugar +println(ingredient._2) // 25 +``` +## タプルでのパターンマッチング +タプルはパターンマッチングを使って分解することもできます。 + +```tut +val (name, quantity) = ingredient +println(name) // Sugar +println(quantity) // 25 +``` + +ここでは`name`に推論される型は`String`で、`quantity`に推論される型は`Int`です。 + +こちらはタプルのパターンマッチングの他の例です。 + +```tut +val planets = + List(("Mercury", 57.9), ("Venus", 108.2), ("Earth", 149.6), + ("Mars", 227.9), ("Jupiter", 778.3)) +planets.foreach{ + case ("Earth", distance) => + println(s"Our planet is $distance million kilometers from the sun") + case _ => +} +``` + +また、`for`内包表記では以下のようになります。 + +```tut +val numPairs = List((2, 5), (3, -7), (20, 56)) +for ((a, b) <- numPairs) { + println(a * b) +} +``` + +## タプルとケースクラス +ユーザーは時々、タプルとケースクラスの選択を難しいと思うかもしれません。ケースクラスには名前付き要素があります。それらの名前によってコードの可読性を改善できる場合があります。 +上記の惑星の例ではタプルを使うより、`case class Planet(name: String, distance: Double)`を定義したほうがいいかもしれません。 diff --git a/_ja/tour/type-inference.md b/_ja/tour/type-inference.md new file mode 100644 index 0000000000..5a0dc8c4a7 --- /dev/null +++ b/_ja/tour/type-inference.md @@ -0,0 +1,74 @@ +--- +layout: tour +title: 型推論 +language: ja + +discourse: true + +partof: scala-tour + +num: 29 +next-page: operators +previous-page: polymorphic-methods +--- + +Scalaコンパイラが式の型を推論できることが多いので、明示的に型を宣言する必要はありません。 + +## 型の省略 + +```tut +val businessName = "Montreux Jazz Café" +``` +コンパイラは`businessName`がStringだと検知できます。これはメソッドでも同様に動きます。 + +```tut +def squareOf(x: Int) = x * x +``` +コンパイラは戻り値の型が`Int`だと推論できるので、明示的な戻り値の型は必要ありません。 + +再帰的メソッドでは、コンパイラは結果の型を推論できません。こちらはこの理由でコンパイラが失敗するプログラムです。 + +```tut:fail +def fac(n: Int) = if (n == 0) 1 else n * fac(n - 1) +``` + +[ポリモーフフィックメソッド](polymorphic-methods.html)が呼ばれる時や[ジェネリッククラス](generic-classes.html) がインスタンス化される場合も型パラメータの指定は強制ではありません。Scalaコンパイラは文脈あるいはメソッドやコンストラクタの実際の引数から、指定されていない型パラメータを推論します。 + +こちらは2つの例です。 + +```tut +case class MyPair[A, B](x: A, y: B); +val p = MyPair(1, "scala") // 型: MyPair[Int, String] + +def id[T](x: T) = x +val q = id(1) // 型: Int +``` +コンパイラは型`A`と`B`が何であるかを見つけ出すために`MyPair`の引数の型を使用します。`x`の型も同様です。 + +## パラメータ + +コンパイラはメソッドのパラメータ型を決して推論しません。しかし、関数が引数として渡されている場合は、無名関数のパラメータ型を推論できます。 + +```tut +Seq(1, 3, 4).map(x => x * 2) // List(2, 6, 8) +``` + +mapのパラメータは`f: A => B`です。`Seq`の中に整数が入っているので、コンパイラは`A`が`Int`だと知っています(つまり、この`x`は整数です)。したがってコンパイラは`x * 2`から`B`が型`Int`であると推論できます。 + +## 型推論に頼ら*ない*時 + +一般的には、パブリックなAPIで公開されているメンバーの型を宣言したほうが読みやすいと考えられています。そのため、ユーザーに公開するAPIではあなたのコードの型を明示することをお勧めします。 + +また、型推論は特定の型を推論することがあります。次のように書いたとします。 + +```tut +var obj = null +``` + +これ以上進められず、再割り当てができません。 + +```tut:fail +obj = new AnyRef +``` + +こちらはコンパイルできません。`obj`に推論された型は`Null`だからです。その型の唯一の値が`null`なので、他の値を代入できれません。 diff --git a/_ja/tour/unified-types.md b/_ja/tour/unified-types.md new file mode 100644 index 0000000000..98482b1c95 --- /dev/null +++ b/_ja/tour/unified-types.md @@ -0,0 +1,97 @@ +--- +layout: tour +title: 統合された型 +language: ja + +discourse: true + +partof: scala-tour + +num: 3 +next-page: classes +previous-page: basics +prerequisite-knowledge: classes, basics + +redirect_from: "/tutorials/tour/unified-types.html" +--- +Scalaでは数値や関数を含め、全ての値は型を持ちます。 +以下の図は型階層の一部を説明しています。 + +Scala Type Hierarchy + +## Scalaの型階層 ## + +[`Any`](http://www.scala-lang.org/api/2.12.1/scala/Any.html) は全ての型のスーパータイプであり、トップ型とも呼ばれます。 +Anyは `equals`、` hashCode`、そして `toString`のようないくつかの普遍的なメソッドを定義しています。 +そして`AnyVal`と`AnyRef` という2つの直系のサブクラスを持ちます。 + +`AnyVal` は値型に相当します。 +事前に定義された9つの値型が存在し、それら`Double`, `Float`, `Long`, `Int`, `Short`, `Byte`, `Char`, `Unit`,`Boolean`は +null非許容です。 +`Unit`は意味のある情報をもたない値型です。`Unit`型のインスタンスはただ1つだけあり、`()`というリテラルで宣言することができます。 +全ての関数は必ず何かを返さなければなりません。そのため`Unit`は戻り値の型として時々役立ちます。 + +`AnyRef` は参照型を意味します。全ての値型でない型は参照型として定義されます。Scalaでは全てのユーザー定義型は`AnyRef`のサブタイプになります。 +もしScalaがJava実行環境上で利用されるなら、`AnyRef` は `java.lang.Object` に相当します。 + +以下にstring、integer、character、boolean、関数が他のオブジェクトと同様に全てオブジェクトであるという例を示します。 + +```tut +val list: List[Any] = List( + "a string", + 732, // integer + 'c', // character + true, // boolean value + () => "文字列を返す無名関数" +) + +list.foreach(element => println(element)) +``` + +これは`List[Any]`型の`list`という値を定義します。 +このlistは様々な型の要素で初期化されています。しかしそれぞれの要素は `scala.Any` のインスタンスなのでlistに追加することができています。 + +こちらは先程のプログラムの出力です。 + +``` +a string +732 +c +true + +``` + +## 型キャスト +値型は以下の順序でキャストできます。 + +Scalaの型階層 + +例えば、 + +```tut +val x: Long = 987654321 +val y: Float = x // 9.8765434E8 (この場合精度が落ちることに注意してください) + +val face: Char = '☺' +val number: Int = face // 9786 +``` + +型変換は一方向です。これはコンパイルができないでしょう。 + +``` +val x: Long = 987654321 +val y: Float = x // 9.8765434E8 +val z: Long = y // 一致しない +``` + +参照型をサブタイプにキャストすることもできます。こちらはツアーの中で後ほど紹介します。 + +## Nothing と Null +`Nothing`は全ての型のサブタイプであり、ボトム型とも呼ばれます。`Nothing`型を持つ値は存在しません。 +一般的に例外のスロー、プログラム終了、無限ループなど終了していないことを示すのに使われます。 +(すなわち、値として評価されない式や正常に返らないメソッドなどです。) + + +`Null` は全ての参照型のサブタイプ(すなわち、全てのAnyRefのサブタイプ)です。`null`というキーワードリテラルが指す値を1つだけもちます。 +`Null` は、ほぼ他のJVM言語との相互運用性のためだけに提供されているので、Scalaのコード内ではほとんどの場合、使われるべきではありません。 +`null`の代替手段については、後のツアーで説明します。 diff --git a/_ja/tour/upper-type-bounds.md b/_ja/tour/upper-type-bounds.md new file mode 100644 index 0000000000..427dbe429f --- /dev/null +++ b/_ja/tour/upper-type-bounds.md @@ -0,0 +1,60 @@ +--- +layout: tour +title: 上限型境界 +language: ja + +discourse: true + +partof: scala-tour +categories: tour +num: 20 +next-page: lower-type-bounds +previous-page: variances + +redirect_from: "/tutorials/tour/upper-type-bounds.html" +--- + +Scalaでは [型パラメータ](generic-classes.html)と[抽象型メンバー](abstract-type-members.html) は型境界による制約をかけることができます。 +型境界は型変数に入れられる具象型を制限して、時にはそれらの型のメンバーについてより多くの情報を与えます。 +_上限型境界_ `T <: A` は型変数`T`が型`A`のサブタイプであるという宣言です。 + +こちらはクラス`PetContainer`の型パラメータの上限型境界を実演する例です。 + +```tut +abstract class Animal { + def name: String +} + +abstract class Pet extends Animal {} + +class Cat extends Pet { + override def name: String = "Cat" +} + +class Dog extends Pet { + override def name: String = "Dog" +} + +class Lion extends Animal { + override def name: String = "Lion" +} + +class PetContainer[P <: Pet](p: P) { + def pet: P = p +} + +val dogContainer = new PetContainer[Dog](new Dog) +val catContainer = new PetContainer[Cat](new Cat) +``` + +```tut:fail +// これはコンパイルされません +val lionContainer = new PetContainer[Lion](new Lion) +``` +`class PetContainer`は型パラメータ`P`を受け取ります。それは`Pet`のサブタイプである必要があります。 + `Dog`と`Cat`は`Pet`のサブタイプなので、新たな`PetContainer[Dog]`と`PetContainer[Cat]`を作ることができます。 + しかしながら、もし`PetContainer[Lion]`を作ろうとすると、以下のエラーが返ってきます。 + +`type arguments [Lion] do not conform to class PetContainer's type parameter bounds [P <: Pet]` + +これは`Lion`は`Pet`のサブタイプではないからです。 diff --git a/_ja/tour/variances.md b/_ja/tour/variances.md new file mode 100644 index 0000000000..35f0d01de8 --- /dev/null +++ b/_ja/tour/variances.md @@ -0,0 +1,184 @@ +--- +layout: tour +title: 変位指定 +language: ja + +discourse: true + +partof: scala-tour + +num: 19 +next-page: upper-type-bounds +previous-page: generic-classes + +redirect_from: "/tutorials/tour/variances.html" +--- + +変位指定は複合型の間の継承関係とそれらの型パラメータ間の継承関係の相関です。 +Scalaは[ジェネリッククラス](generic-classes.html)の型パラメータの変位指定アノテーションをサポートしています。 +変位指定アノテーションにより共変、反変にでき、アノテーション無しなら非変になります。 +型システム上で変位指定を利用すると複合型間の直感的な繋がりを作ることができます。 +もし変位指定が無ければ、クラスを抽象化して再利用しにくくなるでしょう。 + + +```tut +class Foo[+A] // 共変クラス +class Bar[-A] // 反変クラス +class Baz[A] // 非変クラス +``` + +### 共変 + +ジェネリッククラスの型パラメータ`A`はアノテーション`+A`を使うと共変になります。 +`class List[+A]`では、`A`が共変になっているので、`A`が`B`のサブタイプであるような`A`と`B`に対して`List[A]`が`List[B]`のサブタイプであることを示します。 +これによりジェネリックを利用したとても便利で直感的なサブタイプの関係を作ることができます。 + +このシンプルなクラス構成を考えてみましょう。 + +```tut +abstract class Animal { + def name: String +} +case class Cat(name: String) extends Animal +case class Dog(name: String) extends Animal +``` +`Cat`と`Dog`は`Animal`のサブタイプです。 +Scala標準ライブラリにはイミュータブルなジェネリッククラス`sealed abstract class List[+A]`があり、型パラメータ`A`が共変です。 +これは`List[Cat]`は`List[Animal]`であり、`List[Dog]`も`List[Animal]`であることを意味します。 +猫のリストも犬のリストも動物のリストであり、どちらも`List[Animal]`の代わりにできる、というのは直感的に理解できます。 + +以下の例では、メソッド`printAnimalNames`は引数に動物のリストを受け取り、新しい行にそれらの名前をプリントします。 +もし`List[A]`が共変でなければ、最後の2つのメソッド呼び出しはコンパイルされず、`printAnimalNames`メソッドの使い勝手はひどく制限されます。 + +```tut +object CovarianceTest extends App { + def printAnimalNames(animals: List[Animal]): Unit = { + animals.foreach { animal => + println(animal.name) + } + } + + val cats: List[Cat] = List(Cat("Whiskers"), Cat("Tom")) + val dogs: List[Dog] = List(Dog("Fido"), Dog("Rex")) + + printAnimalNames(cats) + // Whiskers + // Tom + + printAnimalNames(dogs) + // Fido + // Rex +} +``` + +### 反変 + +ジェネリッククラスの型パラメータ`A`はアノテーション`-A`を利用して反変にできます。 +これはクラスとその型パラメータの間で、共変と似ていますが反対の意味のサブタイプ関係を作ります。 + +`class Writer[-A]`では`A`が反変になっているので、`A`が`B`のサブタイプであるような`A`と`B`に対し、`Writer[B]`が`Writer[A]`のサブタイプであることを示します。 + +先に定義された`Cat`、`Dog`、`Animal`クラスを以下の例で検討してみます。 + +```tut +abstract class Printer[-A] { + def print(value: A): Unit +} +``` +`Printer[A]`はある型`A`をどのようにプリントするかを知っている簡単なクラスです。 +特定の型でいくつかのサブクラスを定義してみましょう。 + +```tut +class AnimalPrinter extends Printer[Animal] { + def print(animal: Animal): Unit = + println("The animal's name is: " + animal.name) +} + +class CatPrinter extends Printer[Cat] { + def print(cat: Cat): Unit = + println("The cat's name is: " + cat.name) +} +``` +`Printer[Cat]`はコンソールに任意の`Cat`をプリントする方法を知っています。 +そして`Printer[Animal]`はコンソールに任意の`Animal`をプリントする方法を知っています。 +それは`Printer[Animal]`も任意の`Cat`をプリントする方法を知っていることを意味します。 +逆の関係性は適用されません、それは`Printer[Cat]`がコンソールに任意の`Animal`をプリントする方法を知らないからです。 +したがって、私達は必要であれば`Printer[Animal]`を`Printer[Cat]`代わりに使うことができます。これは`Printer[A]`が反変であるからこそ可能なのです。 + +```tut +object ContravarianceTest extends App { + val myCat: Cat = Cat("Boots") + + def printMyCat(printer: Printer[Cat]): Unit = { + printer.print(myCat) + } + + val catPrinter: Printer[Cat] = new CatPrinter + val animalPrinter: Printer[Animal] = new AnimalPrinter + + printMyCat(catPrinter) + printMyCat(animalPrinter) +} +``` + +この出力結果は以下のようになります。 + +``` +The cat's name is: Boots +The animal's name is: Boots +``` + +### 非変 + +Scalaのジェネリッククラスは標準では非変です。 +これは共変でも反変でもないことを意味します。 +以下の例の状況では、`Container`クラスは非変です。`Container[Cat]`は`Container[Animal]`_ではなく_、逆もまた同様です。 + +```tut +class Container[A](value: A) { + private var _value: A = value + def getValue: A = _value + def setValue(value: A): Unit = { + _value = value + } +} +``` +`Container[Cat]`が `Container[Animal]`でもあることは自然なように思えるかもしれませんが、ミュータブルジェネリッククラスを共変にするのは安全ではありません。 +この例では、`Container`が非変であることは非常に重要です。`Container`が仮に共変だったとするとこのようなことが起こり得ます。 + +``` +val catContainer: Container[Cat] = new Container(Cat("Felix")) +val animalContainer: Container[Animal] = catContainer +animalContainer.setValue(Dog("Spot")) +val cat: Cat = catContainer.getValue // おっと、犬に猫に割り当ててしまった。 +``` + +幸いにも、実行する前にコンパイラが止めてくれます。 + +### 他の例 + +変位指定の理解を助けるもう一つの例はScala標準ライブラリの`trait Function1[-T, +R]`です。 +`Function1`は1つのパラメータを持つ関数を表します。1つ目の型パラメータ`T`はパラメータの型を表します。 +そして2つ目の型パラメータ`R`は戻り値の型を表します。 +`Function1`はその引数の型に対して反変であり、戻り値の型に対して共変です。 +この例では`Function1[A, B]`を表現するために`A => B`という文字での表記をします。 + +先ほど利用された`Cat`, `Dog`, `Animal`の継承ツリーに、以下のものを加えましょう： + +```tut +abstract class SmallAnimal extends Animal +case class Mouse(name: String) extends SmallAnimal +``` + +動物の種類を受け取り、それらが食べる食料の種類を返す関数がいくつかあるとしましょう。 +もし（猫は小動物を食べるので）`Cat => SmallAnimal`が欲しい場合に代わりに`Animal => Mouse`を与えられたとしても、私たちのプログラムはまだ動きます。 +直感的に、`Cat`は`Animal`なので、`Animal => Mouse` は`Cat`を引数として受け取ります。 +そして`SmallAnimal`である`Mouse`を返します。 + +安全に、そのままで前者に代えて後者を用いることができるため、`Animal => Mouse`は`Cat => SmallAnimal`のサブタイプと言うことができます。 + +### 他の言語との比較 + +Scalaに似たいくつかの言語で、変位指定はいろんな方法でサポートされています。 +例えば、Scalaの変位指定アノテーションはC#のそれと非常に似ています。C#ではクラスの抽象性を定義する時にアノテーションが追加されます(宣言時の変位指定)。 +しかしながら、Javaでは、クラスの抽象性を使う時に変位指定アノテーションが利用側のコードから与えられます(使用時の変位指定)。 From 3308d9fae3cdf58ea122d7de98bd2002c3b870c7 Mon Sep 17 00:00:00 2001 From: Eugene Kim Date: Thu, 27 Jun 2019 00:45:44 +0900 Subject: [PATCH 0542/3075] Fix deprecated method definition change a part of the source "def move(dx: Int, dy: Int) {" instead of "def move(dx: Int, dy: Int): Unit = {" "def main(args: Array[String]) {" ---> "def main(args: Array[String]): Unit = {" --- _ko/tour/classes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_ko/tour/classes.md b/_ko/tour/classes.md index 0e3a54f558..e2aebe798b 100644 --- a/_ko/tour/classes.md +++ b/_ko/tour/classes.md @@ -19,7 +19,7 @@ previous-page: unified-types class Point(xc: Int, yc: Int) { var x: Int = xc var y: Int = yc - def move(dx: Int, dy: Int) { + def move(dx: Int, dy: Int): Unit = { x = x + dx y = y + dy } @@ -33,7 +33,7 @@ previous-page: unified-types 클래스들은 아래의 예제가 보여주는 것처럼 새로운 기본형으로 초기화된다. object Classes { - def main(args: Array[String]) { + def main(args: Array[String]): Unit = { val pt = new Point(1, 2) println(pt) pt.move(10, 10) From 9b14836791fe9b15ff161b496491762aebe1cdee Mon Sep 17 00:00:00 2001 From: Patrick Moore Date: Wed, 26 Jun 2019 10:28:32 -0700 Subject: [PATCH 0543/3075] Update scala-for-java-programmers.md Java 8 has java.util.function package. Java 8 was released in 2014 (5 years ago). At this point in time, Java developers are *not* surprised about being able to manipulate functions as values and pass them as arguments. --- _overviews/tutorials/scala-for-java-programmers.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index 3ed8305c2a..9daab8070e 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -155,7 +155,7 @@ Scala is a pure object-oriented language in the sense that *everything* is an object, including numbers or functions. It differs from Java in that respect, since Java distinguishes primitive types (such as `boolean` and `int`) from reference -types, and does not enable one to manipulate functions as values. +types. ### Numbers are objects @@ -190,7 +190,7 @@ prevents `1` from being interpreted as a `Double`. ### Functions are objects -Perhaps more surprising for the Java programmer, functions are also +Functions are also objects in Scala. It is therefore possible to pass functions as arguments, to store them in variables, and to return them from other functions. This ability to manipulate functions as values is one of From 0caa894bfe10fb4f50d5b0b9846f62781de90fd4 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Fri, 28 Jun 2019 14:04:08 +0800 Subject: [PATCH 0544/3075] (tutorials) Fix pr#1405 for zh-cn. --- _zh-cn/tutorials/scala-for-java-programmers.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_zh-cn/tutorials/scala-for-java-programmers.md b/_zh-cn/tutorials/scala-for-java-programmers.md index f25a39db69..b5fcb5770e 100644 --- a/_zh-cn/tutorials/scala-for-java-programmers.md +++ b/_zh-cn/tutorials/scala-for-java-programmers.md @@ -87,7 +87,7 @@ Scala 的导入表达式跟 Java 非常像，但更为强大。如第一行， ## 一切都是对象 -Scala 是一个纯粹的面向对象语言，这句话的意思是说，*所有东西*都是对象，包括数字、函数。因为 Java 将基本类型 (如 `boolean` 与 `int` ) 跟参照类型分开，而且没有办法像操作变量一样操作函数，从这角度来看 Scala 跟 Java 是不同的。 +Scala 是一个纯粹的面向对象语言，意即包括数字、函数在内的*所有东西*都是对象。这跟 Java 不同，因为 Java 的基本类型 (如 `boolean` 与 `int` ) 和引用类型是有区别的。 ### 数字是对象 @@ -113,7 +113,7 @@ Scala 是一个纯粹的面向对象语言，这句话的意思是说，*所有 ### 函数是对象 -可能令 Java 程序员更为惊讶的会是，Scala 中函数也是对象。因此，将函数当做对象传递、把它们存入变量、从其他函数返回函数都是可能的。能够像操作变量一样的操作函数这点是*函数式编程*这一非常有趣的程序设计思想的基石之一。 +Scala 中的函数也是对象，所以将函数当做对象传递、把它们存入变量、从其他函数返回函数都是可能的。能够像操作变量一样的操作函数这点是*函数式编程*这一非常有趣的程序设计思想的基石之一。 为何把函数当做变量一样的操作会很有用呢，让我们考虑一个定时函数，功能是每秒执行一些动作。我们要怎么将这动作传给它？最直接的便是将这动作视为函数传入。应该有不少程序员对这种简单传递函数的行为很熟悉：通常在用户界面相关的程序上，用来注册一些当事件发生时被调用的回调函数。 From dbfeb680e2971536dda84e1643fea0ee91df4cad Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Fri, 28 Jun 2019 14:07:09 +0800 Subject: [PATCH 0545/3075] polish. --- _zh-cn/tutorials/scala-for-java-programmers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/tutorials/scala-for-java-programmers.md b/_zh-cn/tutorials/scala-for-java-programmers.md index b5fcb5770e..b42c241852 100644 --- a/_zh-cn/tutorials/scala-for-java-programmers.md +++ b/_zh-cn/tutorials/scala-for-java-programmers.md @@ -87,7 +87,7 @@ Scala 的导入表达式跟 Java 非常像，但更为强大。如第一行， ## 一切都是对象 -Scala 是一个纯粹的面向对象语言，意即包括数字、函数在内的*所有东西*都是对象。这跟 Java 不同，因为 Java 的基本类型 (如 `boolean` 与 `int` ) 和引用类型是有区别的。 +Scala 是一个纯粹的面向对象语言，意即包括数字、函数在内的*一切*都是对象。这跟 Java 不同，因为 Java 的基本类型 (如 `boolean` 与 `int` ) 和引用类型是有区别的。 ### 数字是对象 From 3bdfd8c2554d34573d4e7057a2dc9847ae844d30 Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Fri, 28 Jun 2019 14:39:17 +0800 Subject: [PATCH 0546/3075] Fix internal hashes. --- _zh-cn/glossary/index.md | 87 ++++++++++++++++++++-------------------- 1 file changed, 43 insertions(+), 44 deletions(-) diff --git a/_zh-cn/glossary/index.md b/_zh-cn/glossary/index.md index 79893b5298..60df57c6eb 100644 --- a/_zh-cn/glossary/index.md +++ b/_zh-cn/glossary/index.md @@ -29,7 +29,7 @@ match表达式的一个分支，形如 “`case` _pattern_ => _expression_”。 匿名类是由Scala编译器根据一种new表达式生成的合成子类，这种new表达式由类名或特质名后面紧跟一对花括号组成。花括号内包含了匿名子类的构造体，可为空，不过一旦跟在new后面名称指向的特质或类包含了抽象成员，则这些抽象成员就必须在其匿名子类的构造体内具化，即在花括号内要实现这些成员。 * #### 匿名函数（anonymous function） -[函数字面量](#function-literal)的另一种叫法。 +[函数字面量](#函数字面量function-literal)的另一种叫法。 * #### 应用（apply） 方法、函数或闭包应用于参数，意思是说通过这些实参来调用方法、函数或闭包。 @@ -44,7 +44,7 @@ match表达式的一个分支，形如 “`case` _pattern_ => _expression_”。 在类定义体花括号里面定义的所有附加构造器，其形似名为`this`但无结果类型的方法定义。 * #### 块（block） -被花括号围起来的一个或多个表达式和声明。求值块的时候，块内所有表达式和声明会被顺序处理，然后会返回最后一个表达式的值作为其自身的值。块通常被用来作为构造体，诸如函数、[for表达式](#for-expression)、`while`循环以及其他任何需要把语句组织到一起的地方，都会用到块。更正式点说，块是一个只其副作用和结果值对外可见的封装构造体。因此，类或对象的花括号是不会形成块的，因其内部定义字段和方法均对外可见。这样的花括号形成的是模板。 +被花括号围起来的一个或多个表达式和声明。求值块的时候，块内所有表达式和声明会被顺序处理，然后会返回最后一个表达式的值作为其自身的值。块通常被用来作为构造体，诸如函数、[for表达式](#for表达式for-expression)、`while`循环以及其他任何需要把语句组织到一起的地方，都会用到块。更正式点说，块是一个只其副作用和结果值对外可见的封装构造体。因此，类或对象的花括号是不会形成块的，因其内部定义字段和方法均对外可见。这样的花括号形成的是模板。 * #### 绑定变量（bound variable） 表达式的绑定变量是定义和使用都在表达式内部的变量。例如，在函数字面量表达式`(x: Int) => (x, y)`里面，`x`和`y`都被用到了，但只有`x`被绑定了，因为它在表达式中被定义为一个`Int`变量，并且它也是表达式所描述函数的唯一实参。 @@ -86,10 +86,10 @@ match表达式的一个分支，形如 “`case` _pattern_ => _expression_”。 类是其 _直接子类_ 的直接超类。 * #### 直接超类（direct superclass） -从某个类直接衍生出类或特质，或者说在继承层级结构最接近自己的上层的某个类，这样的类就是直接超类。若类`Child`的可选的extends子句中含有类`Parent`，则`Parent`就是`Child`的直接超类。若`Child`的可选extends子句中含有特质，则特质的直接超类也是`Child`的直接超类。若`Child`没有extends子句，则`AnyRef`就是`Child`的直接超类。若类的直接超类带有类型参数，比如`Child extends Parent[String]`，`Child`的直接超类依旧是`Parent`，而不是`Parent[String]`。另一方面，`Parent[String]`应该叫做`Child`的直接超类型。参见[超类型](#supertype)了解更多关于类和类型间的区别。 +从某个类直接衍生出类或特质，或者说在继承层级结构最接近自己的上层的某个类，这样的类就是直接超类。若类`Child`的可选的extends子句中含有类`Parent`，则`Parent`就是`Child`的直接超类。若`Child`的可选extends子句中含有特质，则特质的直接超类也是`Child`的直接超类。若`Child`没有extends子句，则`AnyRef`就是`Child`的直接超类。若类的直接超类带有类型参数，比如`Child extends Parent[String]`，`Child`的直接超类依旧是`Parent`，而不是`Parent[String]`。另一方面，`Parent[String]`应该叫做`Child`的直接超类型。参见[超类型](#超类型supertype)了解更多关于类和类型间的区别。 * #### 相等性（equality） -在没有条件限制的情况下使用时，_相等性_ 就是`==`所表达的两个值之间的关系。参见[引用相等性](#reference-equality)。 +在没有条件限制的情况下使用时，_相等性_ 就是`==`所表达的两个值之间的关系。参见[引用相等性](#引用相等性reference-equality)。 * #### 存在类型（existential type） 存在类型包含未知类型变量的引用。比如：`Array[T] forSome { type T }`是个存在类型，是`T`的数组，而`T`是某个完全未知的类型，关于`T`唯一能够假定的是它是确定存在的。尽管这个假定很虚，但是至少意味着`Array[T] forSome { type T }`确实是个数组，而不是香蕉什么的东西。 @@ -98,43 +98,43 @@ match表达式的一个分支，形如 “`case` _pattern_ => _expression_”。 任何能够得到结果的Scala代码，也可说成表达式求值为某个结果或结果为某个值。 * #### 过滤器（filter） -[for表达式](#for-expression)中的`if`及跟在其后的布尔表达式。在`for(i <- 1 to 10; if i % 2 == 0)`中，过滤器为"`if i % 2 == 0`"。`if`右边的值就是[过滤器表达式](#filter-expression)，也称为守卫。 +[for表达式](#for表达式for-expression)中的`if`及跟在其后的布尔表达式。在`for(i <- 1 to 10; if i % 2 == 0)`中，过滤器为"`if i % 2 == 0`"。`if`右边的值就是[过滤器表达式](#过滤器表达式filter-expression)，也称为守卫。 * #### 过滤器表达式（filter expression） -过滤器表达式就是[for表达式](#for-expression)里面跟在`if`后面的布尔表达式。`for( i <- 1 to 10 ; if i % 2 == 0)`的过滤器表达式为"`i % 2 == 0`"。 +过滤器表达式就是[for表达式](#for表达式for-expression)里面跟在`if`后面的布尔表达式。`for( i <- 1 to 10 ; if i % 2 == 0)`的过滤器表达式为"`i % 2 == 0`"。 * #### 头等函数（first-class function） -Scala支持 _头等函数_ ，意味着可以通过函数字面量语法来表达函数。如：`(x: Int) => x + 1`，并且函数可由对象来表达，叫做[函数值](#function-value)。 +Scala支持 _头等函数_ ，意味着可以通过函数字面量语法来表达函数。如：`(x: Int) => x + 1`，并且函数可由对象来表达，叫做[函数值](#函数值function-value)。 * #### for推解式（for comprehension） -_for推解式_ 是[for表达式](#for-expression)的一种，一般用来创建新的集合。对`for`推解式的每次迭代，[yield](#yield)子句都会定义新集合的一个元素。比如：`for (i <- (0 until 2); j <- (2 until 4)) yield (i, j)`将返回集合`Vector((0,2), (0,3), (1,2), (1,3))`。 +_for推解式_ 是[for表达式](#for表达式for-expression)的一种，一般用来创建新的集合。对`for`推解式的每次迭代，[yield](#产生yield)子句都会定义新集合的一个元素。比如：`for (i <- (0 until 2); j <- (2 until 4)) yield (i, j)`将返回集合`Vector((0,2), (0,3), (1,2), (1,3))`。 * #### for表达式（for expression） -_for表达式_ 要么是个[for循环](#for-loop)，可以迭代一个或多个集合，要么是个[for推解式](#for-comprehension)，可以从一个或多个集合的元素中推解出一个新的集合。`for`表达式建于[生成器](#generator)、[过滤器](#filter)、变量定义和[yield](#yield)子句（针对[for推解式](#for-comprehension)）基础之上， +_for表达式_ 要么是个[for循环](#for循环for-loop)，可以迭代一个或多个集合，要么是个[for推解式](#for推解式for-comprehension)，可以从一个或多个集合的元素中推解出一个新的集合。`for`表达式建于[生成器](#生成器generator)、[过滤器](#过滤器filter)、变量定义和[yield](#产生yield)子句（针对[for推解式](#for推解式for-comprehension)）基础之上， * #### for循环（for loop） -_for循环_ 是[for表达式](#for-expression)的一种，一般用来循环迭代一个或多个集合。因为`for`循环返回unit，所以经常被用来产生副作用。比如：`for (i <- 0 until 100) println(i)`打印数字0到99。 +_for循环_ 是[for表达式](#for表达式for-expression)的一种，一般用来循环迭代一个或多个集合。因为`for`循环返回unit，所以经常被用来产生副作用。比如：`for (i <- 0 until 100) println(i)`打印数字0到99。 * #### 自由变量（free variable） 一个表达式的 _自由变量_ 指的是在表达式中使用但不定义在其中的变量。例如，在函数字面量表达式`(x: Int) => (x, y)`中，变量`x`和`y`都被用到了，但只有`y`是自由变量，因其未在表达式中定义。 * #### 函数（function） -_函数_ 可通过一列实参来[调用](#invoke)然后产生结果。函数一般具有参数列表、函数体和结果类型。作为类、特质或单例对象的函数叫做[方法](#method)。定义在其他函数内部的函数叫做[局部函数](#local-function)。结果类型为`Unit`的函数叫做[过程](#procedure)。源码里面的匿名函数叫做[函数字面量](#function-literal)。运行时，函数字面量被实例化为对象，叫做[函数值](#function-value)。 +_函数_ 可通过一列实参来[调用](#调用invoke)然后产生结果。函数一般具有参数列表、函数体和结果类型。作为类、特质或单例对象的函数叫做[方法](#方法method)。定义在其他函数内部的函数叫做[局部函数](#局部函数local-function)。结果类型为`Unit`的函数叫做[过程](#过程procedure)。源码里面的匿名函数叫做[函数字面量](#函数字面量function-literal)。运行时，函数字面量被实例化为对象，叫做[函数值](#函数值function-value)。 * #### 函数字面量（function literal） 在Scala源码中的无名函数，通过函数字面量语法来特别对待。比如：`(x: Int, y: Int) => x + y`。 * #### 函数值（function value） -可以像其他函数一样被调用的函数对象。函数值的类一般是继承了`scala`包中的`FunctionN`（比如`Function0`，`Function1`等）这类特质的其中之一，且在源码中常通过[函数字面量](#function-literal)语法来表示。当函数值的apply方法被调用时就说这个函数值被调用。捕获自由变量的函数值为[闭包](#closure)。 +可以像其他函数一样被调用的函数对象。函数值的类一般是继承了`scala`包中的`FunctionN`（比如`Function0`，`Function1`等）这类特质的其中之一，且在源码中常通过[函数字面量](#函数字面量function-literal)语法来表示。当函数值的apply方法被调用时就说这个函数值被调用。捕获自由变量的函数值为[闭包](#闭包closure)。 * #### 函数式风格（functional style） -_函数式风格_ 编程注重函数和求值结果而非操作发生的顺序。这种风格的特征是可传递函数值给循环方法、不可变数据、方法无副作用，是像Haskell和Erlang等这些语言的主要范式，与[命令式风格](#imperative-style)相对应。 +_函数式风格_ 编程注重函数和求值结果而非操作发生的顺序。这种风格的特征是可传递函数值给循环方法、不可变数据、方法无副作用，是像Haskell和Erlang等这些语言的主要范式，与[命令式风格](#命令式风格imperative-style)相对应。 * #### 生成器（generator） -生成器在[for表达式](#for-expression)中定义一个命名的val变量并赋予其一系列值。比如：`for(i <- 1 to 10)`的生成器是"`i <- 1 to 10`"，`<-`右边的值是[generator表达式](#generator-expression)。 +生成器在[for表达式](#for表达式for-expression)中定义一个命名的val变量并赋予其一系列值。比如：`for(i <- 1 to 10)`的生成器是"`i <- 1 to 10`"，`<-`右边的值是[生成器表达式](#生成器表达式generator-expression)。 * #### 生成器表达式（generator expression） -生成器表达式在[for表达式](#for-expression)中生成一些列值。比如：`for(i <- 1 to 10)`的生成器表达式是"`1 to 10`"。 +生成器表达式在[for表达式](#for表达式for-expression)中生成一些列值。比如：`for(i <- 1 to 10)`的生成器表达式是"`1 to 10`"。 * #### 泛型类（generic class） 带有类型参数的类。例如，因`scala.List`带一类型参数，故其为泛型类。 @@ -143,19 +143,19 @@ _函数式风格_ 编程注重函数和求值结果而非操作发生的顺序 带有类型参数的特质。例如，因`scala.collection.Set`带一类型参数，故其为泛型特质。 * #### 守卫（guard） -参见[过滤器](#filter). +参见[过滤器](#过滤器filter). * #### 辅助函数（helper function） 目的是为一个或多个其他邻近函数提供服务的函数。辅助函数常实现为局部函数。 * #### 辅助方法（helper method） -作为类成员的[辅助函数](#helper-function)。辅助方法常为私有方法。 +作为类成员的[辅助函数](#辅助函数helper-function)。辅助方法常为私有方法。 * #### 不可变（immutable） 若对象的值在任何对客户端可见的方式下创建后不会被修改则称对象是 _不可变_ 的。对象既可以是不可变的，也可以是可变的。 * #### 命令式风格（imperative style） -_命令式风格_ 编程强调严谨的操作序列以令效用能在正确的顺序发生。这种风格的特征是循环迭代、适当变更数据、方法有副作用，是像C, C++, C#和Java等这些语言的主要范式，与[函数式风格](#functional-style)相对应。 +_命令式风格_ 编程强调严谨的操作序列以令效用能在正确的顺序发生。这种风格的特征是循环迭代、适当变更数据、方法有副作用，是像C, C++, C#和Java等这些语言的主要范式，与[函数式风格](#函数式风格functional-style)相对应。 * #### 初始化（initialize） 变量在Scala源码中被定义时，必须用对象对其进行初始化。 @@ -173,16 +173,16 @@ _不变性_ 用在两个地方。首先在数据结构组织良好的情况下 在实参上 _调用_ 方法、函数或闭包，意即其方法体会在指定实参上执行。 * #### Java虚拟机（JVM） -_JVM_ 是Java虚拟机(#runtime)的缩写，或叫[运行时](#runtime)，是运行Scala程序的宿主。 +_JVM_ 是Java虚拟机(#runtime)的缩写，或叫[运行时](#运行时runtime)，是运行Scala程序的宿主。 * #### 字面量（literal） `1`，`"One"`，和`(x: Int) => x + 1`是 _字面量_ 的例子，字面量是描述对象的便捷方式，便捷在这种方式正好反映了所创建对象的结构。 * #### 局部函数（local function） -_局部函数_ 是块内`def`定义的，作为对比，同为`def`定义的作为类、特质或单例对象的成员则被称作[方法](#method)。 +_局部函数_ 是块内`def`定义的，作为对比，同为`def`定义的作为类、特质或单例对象的成员则被称作[方法](#方法method)。 * #### 局部变量（local variable） -_局部变量_ 是块内`val`或`var`定义的。尽管函数参数和[局部变量](#local-variable)类似，但并不叫局部变量，而是去掉"局部"直接叫"参数"或"变量"。 +_局部变量_ 是块内`val`或`var`定义的。尽管函数参数和[局部变量](#局部变量local-variable)类似，但并不叫局部变量，而是去掉"局部"直接叫"参数"或"变量"。 * #### 成员（member） _成员_ 是类、特质或单例对象模板中被命名的元素。成员可通过所有者名称，点及其简名访问。例如，定义在类的最顶层字段和方法是这个类的成员。定义在类中的特质是包围它的类的成员。类中通过type关键字定义的类型是这个类的成员。类是其定义所在的包的成员。相比之下，局部变量或局部函数就不是包围他们的块的成员。 @@ -218,7 +218,7 @@ _混入_ 就是特质用在混入组合时的名称。换言之，在"`trait Hat 函数可带有零至多个 _参数_，每个参数都有名称和类型。参数与实参之间的区别在于函数调用时实参指向具体的对象，参数则是指向这些传入实参的变量。 * #### 无参函数（parameterless function） -不带参数的函数，其定义时没有任何空括号。无参函数可不带括号调用，这种方式符合[统一访问原则](#uniform-access-principle)，就是在客户端不改变任何代码的情况下把`def`改成`val`。 +不带参数的函数，其定义时没有任何空括号。无参函数可不带括号调用，这种方式符合[统一访问原则](#统一访问原则uniform-access-principle)，就是在客户端不改变任何代码的情况下把`def`改成`val`。 * #### 无参方法（parameterless method） _无参方法_ 就是作为类、特质或单例对象成员的无参函数。 @@ -236,7 +236,7 @@ _无参方法_ 就是作为类、特质或单例对象成员的无参函数。 在`match`表达式的某个备选项中，_模式_ 跟在`case`关键字后，先于 _模式守卫_ 或`=>`符号二者之一。 * #### 模式守卫（pattern guard） -在`match`表达式的某个备选项中，_模式守卫_ 可跟在某个[模式](#pattern)后面。比如，"`case x if x % 2 == 0 => x + 1`"中的模式守卫为"`if x % 2 == 0`"。带有模式守卫的备选项（case）仅当其模式匹配了并且模式守卫为真的时候才会被选中。 +在`match`表达式的某个备选项中，_模式守卫_ 可跟在某个[模式](#模式pattern)后面。比如，"`case x if x % 2 == 0 => x + 1`"中的模式守卫为"`if x % 2 == 0`"。带有模式守卫的备选项（case）仅当其模式匹配了并且模式守卫为真的时候才会被选中。 * #### 断言（predicate） 断言是结果类型为`Boolean`的函数。 @@ -251,13 +251,13 @@ _过程_ 是结果类型为`Unit`的函数，其存在的理由仅为产生副 变量可以是可重新赋值的，也可以不是可重新赋值的。`var`是可重新赋值的，而`val`则不是。 * #### 递归的（recursive） -若函数可调用自身就说它是 _递归的_。若函数调用自身的唯一位置是函数的最后一个表达式，则函数是[尾递归的](#tail-recursive) +若函数可调用自身就说它是 _递归的_。若函数调用自身的唯一位置是函数的最后一个表达式，则函数是[尾递归](#尾递归tail-recursive)的。 * #### 引用（reference） -_引用_ 是指针的Java抽象，可唯一确定存在JVM堆中的对象。引用类型变量持有对象的引用，因为引用类型（`AnyRef`的实例）是存在JVM堆上的Java对象实现的。相比之下，值类型变量有时会持有一个（装箱类型的）引用，也有时（当对象表示基础类型值的时候）不会。一般说来，Scala变量[指向](#refers)对象。术语"指向"比"持有引用"更加抽象。如果类型为`scala.Int`的变量当前代表Java基础类型`int`的值，则这个变量仍然指向`Int`对象，但并不涉及任何引用。 +_引用_ 是指针的Java抽象，可唯一确定存在JVM堆中的对象。引用类型变量持有对象的引用，因为引用类型（`AnyRef`的实例）是存在JVM堆上的Java对象实现的。相比之下，值类型变量有时会持有一个（装箱类型的）引用，也有时（当对象表示基础类型值的时候）不会。一般说来，Scala变量[指向](#指向refers)对象。术语"指向"比"持有引用"更加抽象。如果类型为`scala.Int`的变量当前代表Java基础类型`int`的值，则这个变量仍然指向`Int`对象，但并不涉及任何引用。 * #### 引用相等性（reference equality） -_引用相等性_ 意思是两个引用指向同一个Java对象。引用相等性仅针对引用类型有意义，是可以通过调用`AnyRef`中的`eq`来确定的（在Java程序中，引用相等性通过在Java[引用类型](#reference-type)上调用`==`来确定）。 +_引用相等性_ 意思是两个引用指向同一个Java对象。引用相等性仅针对引用类型有意义，是可以通过调用`AnyRef`中的`eq`来确定的（在Java程序中，引用相等性通过在Java[引用类型](#引用类型reference-type)上调用`==`来确定）。 * #### 引用类型（reference type） _引用类型_ 是`AnyRef`的子类。在运行时，引用类型的实例常驻JVM堆中。 @@ -266,7 +266,7 @@ _引用类型_ 是`AnyRef`的子类。在运行时，引用类型的实例常驻 独立于临时上下文且无副作用的函数属性。对于特定输入，引用透明函数的调用可由其结果替换而不改变程序语义。 * #### 指向（refers） -运行的Scala程序中的变量常 _指向_ 某个对象。变量即使被赋为`null`，概念上也是指向`Null`对象。在运行时，对象可由Java对象或基础类型值来实现，不过Scala允许程序员在更高层次抽象代码以他们设想的方式运行。参见[引用](#reference). +运行的Scala程序中的变量常 _指向_ 某个对象。变量即使被赋为`null`，概念上也是指向`Null`对象。在运行时，对象可由Java对象或基础类型值来实现，不过Scala允许程序员在更高层次抽象代码以他们设想的方式运行。参见[引用](#引用reference). * #### 精化类型（refinement type） 通过提供基础类型及其构造体花括号内若干成员而形成的类型。花括号内的成员精细化了基础类型所体现的类型。比如，"食草动物"（animal that eats grass）的类型为`Animal { type SuitableFood = Grass }`。 @@ -279,14 +279,13 @@ Scala程序中的表达式会产生 _结果_。Scala中的每个表达式的结 方法的 _结果类型_ 是调用方法所产生的值的类型。（在Java中，这个概念被称为返回类型） * #### 返回（return） -Scala程序中的函数会 _返回_ 值，可把这个值叫做函数的[结果](#result)。也可以说函数 _结果是_ 某个值。Scala中的每个函数结果都是一个对象。 -A function in a Scala program `returns` a value. You can call this value the [result](#result) of the function. You can also say the function _results in_ the value. The result of every function in Scala is an object. +Scala程序中的函数会 _返回_ 值，可把这个值叫做函数的[结果](#结果result)。也可以说函数 _结果是_ 某个值。Scala中的每个函数结果都是一个对象。 * #### 运行时（runtime） -正在运行Scala程序的宿主Java虚拟机，或宿主[JVM](#jvm)。运行时这个概念包含了Java虚拟机规范中定义的虚拟机以及Java API和标准Scala API的运行时库。在运行时的这个阶段，意味着程序正在运行中，与编译时是相对的概念。 +正在运行Scala程序的宿主Java虚拟机，或宿主[JVM](#java虚拟机jvm)。运行时这个概念包含了Java虚拟机规范中定义的虚拟机以及Java API和标准Scala API的运行时库。在运行时的这个阶段，意味着程序正在运行中，与编译时是相对的概念。 * #### 运行时类型（runtime type） -对象在运行时的类型。相比之下，[静态类型](#static-type)指的是表达式在编译时的类型。多数运行时类型都是无类型参数的裸类，比如，`"Hi"`的运行时类型是`String`，`(x: Int) => x + 1`的运行时类型是`Function1`。运行时类型可通过`isInstanceOf`来检测。 +对象在运行时的类型。相比之下，[静态类型](#静态类型static-type)指的是表达式在编译时的类型。多数运行时类型都是无类型参数的裸类，比如，`"Hi"`的运行时类型是`String`，`(x: Int) => x + 1`的运行时类型是`Function1`。运行时类型可通过`isInstanceOf`来检测。 * #### 脚本（script） 包含顶层定义和语句，可直接通过`scala`命令来跑而无需显式编译的文件就是脚本，脚本结尾必须是表达式，而不能是定义。 @@ -307,28 +306,28 @@ XML数据就是半结构化的，因其相比于普通的二进制文件或文 局部变量的重新声明会 _遮掩_ 作用域内相同名称的变量声明。 * #### 签名（signature） -_签名_ 是[类型签名](#type-signature)的简写。 +_签名_ 是[类型签名](#类型签名type-signature)的简写。 * #### 单例对象（singleton object） -由object关键字定义的对象。每个单例对象有且仅有一个实例。与某个类共享名称且与这个类定义在同一源文件中的单例对象，叫这个类的[伴随对象](#companion-object)，类则叫单列对象的[伴随类](#companion-class)。无伴随类的单例对象叫[独立对象](#standalone-object)。 +由object关键字定义的对象。每个单例对象有且仅有一个实例。与某个类共享名称且与这个类定义在同一源文件中的单例对象，叫这个类的[伴随对象](#伴随对象companion-object)，类则叫单列对象的[伴随类](#伴随类companion-class)。无伴随类的单例对象叫[独立对象](#独立对象standalone-object)。 * #### 独立对象（standalone object） -没有[伴生类](#companion-class)的[单例对象](#singleton-object)。 +没有[伴生类](#伴生类companion-class)的[单例对象](#单例对象singleton-object)。 * #### 语句（statement） 指的是表达式、定义或包导入等这些可放到Scala源码的模板或块中的东西。 * #### 静态类型（static type） -参见[类型](#type)。 +参见[类型](#类型type)。 * #### 结构类型（structural type） -也是一种[精化类型](#refinement-type)，只是精化的目标是未在基类型中的成员。比如`{ def close(): Unit }`就是结构类型，因其基类型是`AnyRef`，而`AnyRef`并无名为`close`的成员。 +也是一种[精化类型](#精化类型refinement-type)，只是精化的目标是未在基类型中的成员。比如`{ def close(): Unit }`就是结构类型，因其基类型是`AnyRef`，而`AnyRef`并无名为`close`的成员。 * #### 子类（subclass） -一个类是其所有[超类](#superclass)和[超特质](#supertrait)的 _子类_。 +一个类是其所有[超类](#超类superclass)和[超特质](#超特质supertrait)的 _子类_。 * #### 子特质（subtrait） -一个特质是其所有[超特质](#supertrait)的 _子特质_。 +一个特质是其所有[超特质](#超特质supertrait)的 _子特质_。 * #### 子类型（subtype） Scala编译器允许任何类型在需要该类型的地方使用其 _子类型_ 作为替代。对不带类型参数的类和特质来说，子类型的关系会反映子类的关系。比如，若类`Cat`是抽象类`Animal`的子类，且也不带类型参数，则类型`Cat`就是类型`Animal`的子类型。同样，若特质`Apple`是特质`Fruit`的子特质且无类型参数，则类型`Apple`就是类型`Fruit`的子类型。而对于带有类型参数的类和特质来说，协变就起作用了。比如，由于抽象类`List`被声明为在其长类型参数上是协变的（例，`List`被声明为`List[+A]`），`List[Cat]`是`List[Animal]`的子类型，`List[Apple]`是`List[Fruit]`的子类型。尽管这些类型的类都是`List`，但其子类型的关系依旧是存在的。对比来看，因为`Set`未被声明在其类型参数上是协变的（例，`Set`被声明为`Set[A]`，不带加号），所以`Set[Cat]`并不是`Set[Animal]`的子类型。子类型应该正确实现其超类型的契约，以便应用里氏替换原则（Liskov Substitution Principle），不过编译器仅会在类型检查级别核验此属性。 @@ -355,13 +354,13 @@ _目标类型化_ 是参考所需类型来进行类型推导的一种形式。 _模板_ 是类、特质或单例对象定义体，它定义了类、特质或对象的类型签名，行为以及初始状态。 * #### 特质（trait） -_特质_ 通过`trait`关键字定义，是像抽象类一样不带任何值参数，并且可通过被称为[混入组合](#mixin-composition)的过程"混入到"类或其他特质。当某个特质被混入到其他类或特质，它就被叫做[混入](#mixin)。特质可通过一个或多个类型参数化。用类型来参数化后，特质就形成了类型。比如，`Set`是带有单类型参数的特质，而`Set[Int]`却是一个类型。`Set`也被说成是类型`Set[Int]`的"特质"。 +_特质_ 通过`trait`关键字定义，是像抽象类一样不带任何值参数，并且可通过被称为[混入组合](#混入组合mixin-composition)的过程"混入到"类或其他特质。当某个特质被混入到其他类或特质，它就被叫做[混入](#混入mixin)。特质可通过一个或多个类型参数化。用类型来参数化后，特质就形成了类型。比如，`Set`是带有单类型参数的特质，而`Set[Int]`却是一个类型。`Set`也被说成是类型`Set[Int]`的"特质"。 * #### 类型（type） -Scala程序中每个变量和表达式都有编译时确定的 _类型_。类型可以在运行时限定变量能指向的值和表达式所能产生的值。如果有必要从对象的[运行时类型](#runtime-type)的角度对变量和表达式的类型进行区分的话，他们也被称为 _静态类型_。换句话说，"类型"这个词本身意味着静态类型。类型与类是区分开的因为带有类型参数的类可以构成许多类型。比如，`List`是类不是类型，`List[T]`则是一个带有自由类型参数的类型，`List[Int]`和`List[String]`也是类型（称为实类型因为他们没有自由类型参数）。类型可以有"[类](#class)"或"[特质](#trait)"，比如类型`List[Int]`的类是`List`，类型`Set[String]`的特质是`Set`。 +Scala程序中每个变量和表达式都有编译时确定的 _类型_。类型可以在运行时限定变量能指向的值和表达式所能产生的值。如果有必要从对象的[运行时类型](#运行时类型runtime-type)的角度对变量和表达式的类型进行区分的话，他们也被称为 _静态类型_。换句话说，"类型"这个词本身意味着静态类型。类型与类是区分开的因为带有类型参数的类可以构成许多类型。比如，`List`是类不是类型，`List[T]`则是一个带有自由类型参数的类型，`List[Int]`和`List[String]`也是类型（称为实类型因为他们没有自由类型参数）。类型可以有"[类](#类class)"或"[特质](#特质trait)"，比如类型`List[Int]`的类是`List`，类型`Set[String]`的特质是`Set`。 * #### 类型约束（type constraint） -有些[注解](#annotation)是 _类型约束_，意味着他们会对类型能够包含的取值增加额外的限制或约束。比如，`@positive`可以是类型`Int`的类型约束，用来限制32位整型的取值为正的整数。类型约束虽然不会被标准Scala编译器检查，但相应的必须可被额外的工具或编译器插件检查。 +有些[注解](#注解annotation)是 _类型约束_，意味着他们会对类型能够包含的取值增加额外的限制或约束。比如，`@positive`可以是类型`Int`的类型约束，用来限制32位整型的取值为正的整数。类型约束虽然不会被标准Scala编译器检查，但相应的必须可被额外的工具或编译器插件检查。 * #### 类型构造器（type constructor） 带类型参数的类或特质。 @@ -379,7 +378,7 @@ _统一访问原则_ 指的是变量和无参函数应以相同的语法来访 在Scala层面，对象可以是 _不可达_ 的，此时其所占据的内存可被运行时回收。不可达并不一定意味着未被引用。引用类型（`AnyRef`的实例）被实现为驻于JVM堆上的对象。当引用类型的实例不可达后，它也确实不被引用了，且可被垃圾回收。值类型（`AnyVal`的实例）可被实现为驻于堆中的基础类型值或Java包装类型实例（如`java.lang.Integer`）。值类型实例可在指向他们的变量的整个生命周期内被装箱（从基础类型值转成包装类型对象）或拆箱（从包装类型对象转成基础类型值）。若表现为JVM堆上的包装类型对象的值类型实例不可达，那就确实不会被引用并且可被垃圾回收。但是若正在表现为基础类型值的值类型不可达，则其仍可被引用，因为此时它并不会以作为对象驻于JVM堆上。运行时可回收不可达对象所占据的内存，但是假如一个Int在运行时被实现为Java基础类型int，在一个运行中的方法的栈帧上占据了一些内存，则这个对象的内存将在方法运行完成且栈帧弹出时才被回收。引用类型的内存，比如`Strings`，可在不可达之后由JVM的垃圾收集器回收。 * #### 未引用（unreferenced） -参见[不可达](#unreachable)。 +参见[不可达](#不可达unreachable)。 * #### 值（value） Scala中的任何计算或表达式的结果都是一个 _值_，而Scala中的每个值都是一个对象。值这个术语本质上是指对象在内存中（在JVM堆或栈上）的镜像。 @@ -391,7 +390,7 @@ _值类型_ 是`AnyVal`的任意子类，像`Int`，`Double`或`Unit`。该术 指向对象的命名实体。变量要么是`val`，要么是 `var`，`val`变量和`var`变量在定义时都必须被初始化，但仅`var`变量可被重新赋值来指向不同对象。 * #### 型变（variance） -类或特质的类型参数可用 _型变_ 标号来做标记，即[协变](#covariant)（+）或[逆变](#contravariant)（-）。这样的型变标号表明了泛型类或特质的子类化是如何开展的，比如，泛型类`List`在其类型参数上是协变的，因此`List[String]`就是`List[Any]`的子类型。默认情况下，即缺少标号`+`或`-`的类型参数是[非协变](#nonvariant)的。 +类或特质的类型参数可用 _型变_ 标号来做标记，即[协变](#协变covariant)（+）或[逆变](#逆变contravariant)（-）。这样的型变标号表明了泛型类或特质的子类化是如何开展的，比如，泛型类`List`在其类型参数上是协变的，因此`List[String]`就是`List[Any]`的子类型。默认情况下，即缺少标号`+`或`-`的类型参数是[非协变](#非协变nonvariant)的。 * #### 产生（yield） -表达式可以 _产生_ 结果。`yield`关键字指定了[for推解式](#for-comprehension)的结果。 +表达式可以 _产生_ 结果。`yield`关键字指定了[for推解式](#for推解式for-comprehension)的结果。 From 72add3cf5f67110884e1243dd5beb973de4b081d Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Fri, 28 Jun 2019 14:53:56 +0800 Subject: [PATCH 0547/3075] Fix typo for internal hashes. --- _zh-cn/glossary/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/glossary/index.md b/_zh-cn/glossary/index.md index 60df57c6eb..393593654d 100644 --- a/_zh-cn/glossary/index.md +++ b/_zh-cn/glossary/index.md @@ -309,7 +309,7 @@ XML数据就是半结构化的，因其相比于普通的二进制文件或文 _签名_ 是[类型签名](#类型签名type-signature)的简写。 * #### 单例对象（singleton object） -由object关键字定义的对象。每个单例对象有且仅有一个实例。与某个类共享名称且与这个类定义在同一源文件中的单例对象，叫这个类的[伴随对象](#伴随对象companion-object)，类则叫单列对象的[伴随类](#伴随类companion-class)。无伴随类的单例对象叫[独立对象](#独立对象standalone-object)。 +由object关键字定义的对象。每个单例对象有且仅有一个实例。与某个类共享名称且与这个类定义在同一源文件中的单例对象，叫这个类的[伴生对象](#伴生对象companion-object)，类则叫单列对象的[伴生类](#伴生类companion-class)。无伴随类的单例对象叫[独立对象](#独立对象standalone-object)。 * #### 独立对象（standalone object） 没有[伴生类](#伴生类companion-class)的[单例对象](#单例对象singleton-object)。 From 60011d873bfcd15b38e6445ccb51c32de28e9377 Mon Sep 17 00:00:00 2001 From: Anastasia Ostretsova Date: Fri, 28 Jun 2019 20:28:21 +0300 Subject: [PATCH 0548/3075] Translate "Partial application" part into russian --- _ru/tour/multiple-parameter-lists.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/_ru/tour/multiple-parameter-lists.md b/_ru/tour/multiple-parameter-lists.md index d1938cb4b0..f58066b0e8 100644 --- a/_ru/tour/multiple-parameter-lists.md +++ b/_ru/tour/multiple-parameter-lists.md @@ -78,3 +78,20 @@ numbers.foldRight(0)(_+_) // Форма с каррированием def execute(arg: Int)(implicit ec: ExecutionContext) = ??? ``` +#### Частичное применение + Когда метод вызывается с меньшим количеством списков параметров, то результатом будет функция, + которая принимает в качестве параметров недостающие списки. Это официально известно как + [частичное применение](https://ru.wikipedia.org/wiki/%D0%A7%D0%B0%D1%81%D1%82%D0%B8%D1%87%D0%BD%D0%BE%D0%B5_%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5). + + Например, + + ```tut + val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) + val numberFunc = numbers.foldLeft(List[Int]()) _ + + val squares = numberFunc((xs, x) => xs :+ x*x) + print(squares) // List(1, 4, 9, 16, 25, 36, 49, 64, 81, 100) + + val cubes = numberFunc((xs, x) => xs :+ x*x*x) + print(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) + ``` \ No newline at end of file From e26fc4b0de48b9e7dee9eb545350c446f0000d49 Mon Sep 17 00:00:00 2001 From: Guannan Wei Date: Fri, 28 Jun 2019 17:08:16 -0400 Subject: [PATCH 0549/3075] update the compiler plugin example to Scala 2.13 --- _overviews/plugins/index.md | 22 +++++----------------- 1 file changed, 5 insertions(+), 17 deletions(-) diff --git a/_overviews/plugins/index.md b/_overviews/plugins/index.md index 3b11e43164..ff9e3ffdc6 100644 --- a/_overviews/plugins/index.md +++ b/_overviews/plugins/index.md @@ -99,11 +99,6 @@ There are several steps to making the plugin. First you need to write and compile the source of the plugin itself. Here is the source code for it: - // IMPORTANT: - // this code was written for Scala 2.8. - // it needs to be updated for Scala 2.12. - // the changes required are modest. - package localhost import scala.tools.nsc @@ -126,11 +121,11 @@ it: def newPhase(_prev: Phase) = new DivByZeroPhase(_prev) class DivByZeroPhase(prev: Phase) extends StdPhase(prev) { override def name = DivByZero.this.name - def apply(unit: CompilationUnit) { + def apply(unit: CompilationUnit): Unit = { for ( tree @ Apply(Select(rcvr, nme.DIV), List(Literal(Constant(0)))) <- unit.body if rcvr.tpe <:< definitions.IntClass.tpe) { - unit.error(tree.pos, "definitely division by zero") + global.reporter.error(tree.pos, "definitely division by zero") } } } @@ -276,11 +271,6 @@ sure you got the help string looking right. Here is a complete plugin that has an option. This plugin has no behavior other than to print out its option. - // IMPORTANT: - // this code was written for Scala 2.8. - // it needs to be updated for Scala 2.12. - // the changes required are modest. - package localhost import scala.tools.nsc @@ -298,7 +288,7 @@ behavior other than to print out its option. var level = 1000000 - override def processOptions(options: List[String], error: String => Unit) { + override def processOptions(options: List[String], error: String => Unit): Unit = { for (option <- options) { if (option.startsWith("level:")) { level = option.substring("level:".length).toInt @@ -313,15 +303,13 @@ behavior other than to print out its option. private object Component extends PluginComponent { val global: Silly.this.global.type = Silly.this.global - val runsAfter = "refchecks" - // Using the Scala Compiler 2.8.x the runsAfter should be written as shown below - // val runsAfter = List[String]("refchecks"); + val runsAfter = List[String]("refchecks"); val phaseName = Silly.this.name def newPhase(_prev: Phase) = new SillyPhase(_prev) class SillyPhase(prev: Phase) extends StdPhase(prev) { override def name = Silly.this.name - def apply(unit: CompilationUnit) { + def apply(unit: CompilationUnit): Unit = { println("Silliness level: " + level) } } From 61cbc3266b2d32e23d689151a4ad53b1e056c57a Mon Sep 17 00:00:00 2001 From: Anastasia Ostretsova Date: Sat, 29 Jun 2019 13:06:37 +0300 Subject: [PATCH 0550/3075] Leave just an example --- _ru/tour/multiple-parameter-lists.md | 33 ++++++++++++---------------- 1 file changed, 14 insertions(+), 19 deletions(-) diff --git a/_ru/tour/multiple-parameter-lists.md b/_ru/tour/multiple-parameter-lists.md index f58066b0e8..019f17d77d 100644 --- a/_ru/tour/multiple-parameter-lists.md +++ b/_ru/tour/multiple-parameter-lists.md @@ -15,6 +15,19 @@ previous-page: nested-functions Методы могут объявляться с несколькими списками параметров. При этом когда такой метод вызывается с меньшим количеством списков параметров, это приводит к созданию новой функции, которая ожидает на вход не достающий список параметров. Формально это называется [частичное применение](https://en.wikipedia.org/wiki/Partial_application). +Например, + + ```tut + val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) + val numberFunc = numbers.foldLeft(List[Int]()) _ + + val squares = numberFunc((xs, x) => xs :+ x*x) + print(squares) // List(1, 4, 9, 16, 25, 36, 49, 64, 81, 100) + + val cubes = numberFunc((xs, x) => xs :+ x*x*x) + print(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) + ``` + Рассмотрим такие примеры из класса [Traversable](/overviews/collections/trait-traversable.html) коллекции Scala: ``` @@ -76,22 +89,4 @@ numbers.foldRight(0)(_+_) // Форма с каррированием ``` def execute(arg: Int)(implicit ec: ExecutionContext) = ??? -``` - -#### Частичное применение - Когда метод вызывается с меньшим количеством списков параметров, то результатом будет функция, - которая принимает в качестве параметров недостающие списки. Это официально известно как - [частичное применение](https://ru.wikipedia.org/wiki/%D0%A7%D0%B0%D1%81%D1%82%D0%B8%D1%87%D0%BD%D0%BE%D0%B5_%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5). - - Например, - - ```tut - val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) - val numberFunc = numbers.foldLeft(List[Int]()) _ - - val squares = numberFunc((xs, x) => xs :+ x*x) - print(squares) // List(1, 4, 9, 16, 25, 36, 49, 64, 81, 100) - - val cubes = numberFunc((xs, x) => xs :+ x*x*x) - print(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) - ``` \ No newline at end of file +``` \ No newline at end of file From 2feaa411073aa8d3ca96afad92f8fc00b14ff71c Mon Sep 17 00:00:00 2001 From: Dima Kotobotov Date: Sat, 29 Jun 2019 20:07:32 +0300 Subject: [PATCH 0551/3075] :pencil2: Fixing typos. --- _overviews/collections-2.13/equality.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/equality.md b/_overviews/collections-2.13/equality.md index 42137a43ca..68f5f4141c 100644 --- a/_overviews/collections-2.13/equality.md +++ b/_overviews/collections-2.13/equality.md @@ -31,4 +31,4 @@ It does not matter for the equality check whether a collection is mutable or imm java.util.NoSuchElementException: key not found: ArrayBuffer(2, 2, 3) -In this example, the selection in the last line will most likely fail because the hash-code of the array `xs` has changed in the second-to-last line. Therefore, the hash-code-based lookup will look at a different place than the one where `xs` was stored. +In this example, the selection in the last line will most likely fail because the hash-code of the array `buf` has changed in the second-to-last line. Therefore, the hash-code-based lookup will look at a different place than the one where `buf` was stored. From f749e02964f2155db205a66c60e1cf6d242a5580 Mon Sep 17 00:00:00 2001 From: Taketo Iseki Date: Mon, 1 Jul 2019 20:14:23 +0900 Subject: [PATCH 0552/3075] translate tour/automatic-closures into Japanese --- _ja/tour/automatic-closures.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md index 29ae0a8c00..3bb7fa6935 100644 --- a/_ja/tour/automatic-closures.md +++ b/_ja/tour/automatic-closures.md @@ -1,6 +1,6 @@ --- layout: tour -title: Automatic Type-Dependent Closure Construction +title: 型依存クロージャの自動構築 language: ja discourse: true @@ -8,9 +8,9 @@ discourse: true partof: scala-tour --- -Scala allows parameterless function names as parameters of methods. When such a method is called, the actual parameters for parameterless function names are not evaluated and a nullary function is passed instead which encapsulates the computation of the corresponding parameter (so-called *call-by-name* evaluation). +Scalaはメソッドのパラメータにパラメータを受け取らない関数名が使えます。このようなメソッドが呼び出される時、パラメータを受け取らない関数名は実際に評価されず、代わりに対応するパラメーターの処理をカプセル化した、引数を取らない関数が渡されます(そのため *名前渡し*評価と呼ばれます)。 -The following code demonstrates this mechanism: +以下のコードはこの仕組みを説明しています。 object TargetTest1 extends Application { def whileLoop(cond: => Boolean)(body: => Unit): Unit = @@ -25,11 +25,11 @@ The following code demonstrates this mechanism: } } -The function whileLoop takes two parameters `cond` and `body`. When the function is applied, the actual parameters do not get evaluated. But whenever the formal parameters are used in the body of `whileLoop`, the implicitly created nullary functions will be evaluated instead. Thus, our method `whileLoop` implements a Java-like while-loop with a recursive implementation scheme. +関数 whileLoop は2つのパラメータ`cond`と`body`を受け取ります。関数が適用される時、実際のパラメータは評価されません。しかし形式上のパラメータが`whileLoop`の本体内で使われる度に、暗黙に生成された引数の無い関数が代わりに評価されます。このようにメソッド`whileLoop`はJavaのようなwhileループを再帰的な実装案で実装しています。 -We can combine the use of [infix/postfix operators](operators.html) with this mechanism to create more complex statements (with a nice syntax). +[中置/後置 演算子](operators.html)とこのメカニズムを組み合わせ利用し、より複雑な式を(より良い構文で)が作れます。 -Here is the implementation of a loop-unless statement: +こちらがloop-unless式の実装です。 object TargetTest2 extends Application { def loop(body: => Unit): LoopUnlessCond = @@ -46,9 +46,9 @@ Here is the implementation of a loop-unless statement: i -= 1 } unless (i == 0) } -The `loop` function just accepts a body of a loop and returns an instance of class `LoopUnlessCond` (which encapsulates this body object). Note that the body didn't get evaluated yet. Class `LoopUnlessCond` has a method `unless` which we can use as a *infix operator*. This way, we achieve a quite natural syntax for our new loop: `loop { < stats > } unless ( < cond > )`. +この`loop`関数はループ処理の本体を受け取り、クラス`LoopUnlessCond`(bodyのオブジェクトをカプセル化する)のインスタンスを返すだけです。bodyはまだ評価されていないことに気をつけてください。クラス`LoopUnlessCond`は中置演算子として使えるメソッド`unless`を持ちます。このようにより自然な構文で新しいループ処理`loop { < stats > } unless ( < cond > )`を作れます。 -Here's the output when `TargetTest2` gets executed: +こちらが`TargetTest2`を実行した時の出力です。 i = 10 i = 9 From 7c9abb1eee083ad094cc72b1b15bc656fa41a919 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 1 Jul 2019 17:17:33 +0200 Subject: [PATCH 0553/3075] =?UTF-8?q?Move=20guides=20of=202.12=E2=80=99s?= =?UTF-8?q?=20collections=20to=20the=20=E2=80=9CLegacy=E2=80=9D=20category?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Also remove the Scala version number from the title of the current collection guide. --- _data/overviews.yml | 104 ++++++++++++++++++++++---------------------- 1 file changed, 52 insertions(+), 52 deletions(-) diff --git a/_data/overviews.yml b/_data/overviews.yml index bfc4c293ed..c84a29131c 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -2,7 +2,7 @@ - category: Standard Library description: "Guides and overviews covering the Scala standard library." overviews: - - title: Scala 2.13’s Collections + - title: Scala Collections by: Martin Odersky and Julien Richard-Foy icon: sitemap url: "collections-2.13/introduction.html" @@ -40,68 +40,21 @@ url: "core/collections-migration-213.html" description: "This page describes the main changes for collection users that migrate to Scala 2.13 and shows how to cross-build projects with Scala 2.11 / 2.12 and 2.13." - - title: The Architecture of Scala 2.13’s Collections + - title: The Architecture of Scala Collections icon: sitemap url: "core/architecture-of-scala-213-collections.html" by: Julien Richard-Foy description: "These pages describe the architecture of the collections framework introduced in Scala 2.13. Compared to the Collections API you will find out more about the internal workings of the framework." - - title: Implementing Custom Collections (Scala 2.13) + - title: Implementing Custom Collections icon: building url: "core/custom-collections.html" by: Martin Odersky, Lex Spoon and Julien Richard-Foy description: "In this document you will learn how the collections framework helps you define your own collections in a few lines of code, while reusing the overwhelming part of collection functionality from the framework." - - title: Adding Custom Collection Operations (Scala 2.13) + - title: Adding Custom Collection Operations icon: building url: "core/custom-collection-operations.html" by: Julien Richard-Foy description: "This guide shows how to write operations that can be applied to any collection type and return the same collection type, and how to write operations that can be parameterized by the type of collection to build." - - title: Scala 2.8 to 2.12’s Collections - by: Martin Odersky - icon: sitemap - url: "collections/introduction.html" - description: "Scala's Collection Library." - subdocs: - - title: Introduction - url: "collections/introduction.html" - - title: Mutable and Immutable Collections - url: "collections/overview.html" - - title: Trait Traversable - url: "collections/trait-traversable.html" - - title: Trait Iterable - url: "collections/trait-iterable.html" - - title: The sequence traits Seq, IndexedSeq, and LinearSeq - url: "collections/seqs.html" - - title: Sets - url: "collections/sets.html" - - title: Maps - url: "collections/maps.html" - - title: Concrete Immutable Collection Classes - url: "collections/concrete-immutable-collection-classes.html" - - title: Concrete Mutable Collection Classes - url: "collections/concrete-mutable-collection-classes.html" - - title: Arrays - url: "collections/arrays.html" - - title: Strings - url: "collections/strings.html" - - title: Performance Characteristics - url: "collections/performance-characteristics.html" - - title: Equality - url: "collections/equality.html" - - title: Views - url: "collections/views.html" - - title: Iterators - url: "collections/iterators.html" - - title: Creating Collections From Scratch - url: "collections/creating-collections-from-scratch.html" - - title: Conversions Between Java and Scala Collections - url: "collections/conversions-between-java-and-scala-collections.html" - - title: Migrating from Scala 2.7 - url: "collections/migrating-from-scala-27.html" - - title: The Architecture of Scala 2.8 to 2.12’s Collections - icon: building - url: "core/architecture-of-scala-collections.html" - by: Martin Odersky and Lex Spoon - description: "These pages describe the architecture of the Scala collections framework in detail. Compared to the Collections API you will find out more about the internal workings of the framework. You will also learn how this architecture helps you define your own collections in a few lines of code, while reusing the overwhelming part of collection functionality from the framework." - category: Language description: "Guides and overviews covering features in the Scala language." @@ -303,7 +256,7 @@ - category: Legacy - description: "Guides covering features no longer relevant to recent Scala versions (2.11+)." + description: "Guides covering features no longer relevant to recent Scala versions (2.12+)." overviews: - title: The Scala Actors Migration Guide by: Vojin Jovanovic and Philipp Haller @@ -317,3 +270,50 @@ description: "This guide describes the API of the scala.actors package of Scala 2.8/2.9. The organization follows groups of types that logically belong together. The trait hierarchy is taken into account to structure the individual sections. The focus is on the run-time behavior of the various methods that these traits define, thereby complementing the existing Scaladoc-based API documentation." label-color: "#899295" label-text: deprecated + - title: Scala 2.8 to 2.12’s Collections + by: Martin Odersky + icon: sitemap + url: "collections/introduction.html" + description: "Scala's Collection Library." + subdocs: + - title: Introduction + url: "collections/introduction.html" + - title: Mutable and Immutable Collections + url: "collections/overview.html" + - title: Trait Traversable + url: "collections/trait-traversable.html" + - title: Trait Iterable + url: "collections/trait-iterable.html" + - title: The sequence traits Seq, IndexedSeq, and LinearSeq + url: "collections/seqs.html" + - title: Sets + url: "collections/sets.html" + - title: Maps + url: "collections/maps.html" + - title: Concrete Immutable Collection Classes + url: "collections/concrete-immutable-collection-classes.html" + - title: Concrete Mutable Collection Classes + url: "collections/concrete-mutable-collection-classes.html" + - title: Arrays + url: "collections/arrays.html" + - title: Strings + url: "collections/strings.html" + - title: Performance Characteristics + url: "collections/performance-characteristics.html" + - title: Equality + url: "collections/equality.html" + - title: Views + url: "collections/views.html" + - title: Iterators + url: "collections/iterators.html" + - title: Creating Collections From Scratch + url: "collections/creating-collections-from-scratch.html" + - title: Conversions Between Java and Scala Collections + url: "collections/conversions-between-java-and-scala-collections.html" + - title: Migrating from Scala 2.7 + url: "collections/migrating-from-scala-27.html" + - title: The Architecture of Scala 2.8 to 2.12’s Collections + icon: building + url: "core/architecture-of-scala-collections.html" + by: Martin Odersky and Lex Spoon + description: "These pages describe the architecture of the Scala collections framework in detail. Compared to the Collections API you will find out more about the internal workings of the framework. You will also learn how this architecture helps you define your own collections in a few lines of code, while reusing the overwhelming part of collection functionality from the framework." From 9a29e0c37f857dca7a712fd43b01ba4379b5ef15 Mon Sep 17 00:00:00 2001 From: take2 Date: Wed, 3 Jul 2019 01:09:30 +0900 Subject: [PATCH 0554/3075] Update _ja/tour/automatic-closures.md Co-Authored-By: Masanori Fujita --- _ja/tour/automatic-closures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md index 3bb7fa6935..3d21d052cd 100644 --- a/_ja/tour/automatic-closures.md +++ b/_ja/tour/automatic-closures.md @@ -8,7 +8,7 @@ discourse: true partof: scala-tour --- -Scalaはメソッドのパラメータにパラメータを受け取らない関数名が使えます。このようなメソッドが呼び出される時、パラメータを受け取らない関数名は実際に評価されず、代わりに対応するパラメーターの処理をカプセル化した、引数を取らない関数が渡されます(そのため *名前渡し*評価と呼ばれます)。 +Scalaはメソッドのパラメータとしてパラメータ無しの関数名を渡せます。そのようなメソッドが呼ばれると、パラメータ無しの関数名は実際に評価されず、代わりに対応するパラメーターの処理をカプセル化した、引数無しの関数が渡されます(いわゆる *名前渡し*評価です)。 以下のコードはこの仕組みを説明しています。 From 35e386e93a6aa6465514fab1f652501c31e6f166 Mon Sep 17 00:00:00 2001 From: take2 Date: Wed, 3 Jul 2019 01:09:55 +0900 Subject: [PATCH 0555/3075] Update _ja/tour/automatic-closures.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 実装案 => 方法 Co-Authored-By: Masanori Fujita --- _ja/tour/automatic-closures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md index 3d21d052cd..1d190d4cae 100644 --- a/_ja/tour/automatic-closures.md +++ b/_ja/tour/automatic-closures.md @@ -25,7 +25,7 @@ Scalaはメソッドのパラメータとしてパラメータ無しの関数名 } } -関数 whileLoop は2つのパラメータ`cond`と`body`を受け取ります。関数が適用される時、実際のパラメータは評価されません。しかし形式上のパラメータが`whileLoop`の本体内で使われる度に、暗黙に生成された引数の無い関数が代わりに評価されます。このようにメソッド`whileLoop`はJavaのようなwhileループを再帰的な実装案で実装しています。 +関数 whileLoop は2つのパラメータ`cond`と`body`を受け取ります。関数が適用される時、実際のパラメータは評価されません。しかし形式上のパラメータが`whileLoop`の本体内で使われる度に、暗黙に生成された引数の無い関数が代わりに評価されます。このようにメソッド`whileLoop`はJavaのようなwhileループを再帰的な方法で実装しています。 [中置/後置 演算子](operators.html)とこのメカニズムを組み合わせ利用し、より複雑な式を(より良い構文で)が作れます。 From 6a0d6ea2492a0ba551ac9db86277354d4a17be48 Mon Sep 17 00:00:00 2001 From: take2 Date: Wed, 3 Jul 2019 01:10:14 +0900 Subject: [PATCH 0556/3075] Update _ja/tour/automatic-closures.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 不要ながを削除 Co-Authored-By: Masanori Fujita --- _ja/tour/automatic-closures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md index 1d190d4cae..a12b8e8742 100644 --- a/_ja/tour/automatic-closures.md +++ b/_ja/tour/automatic-closures.md @@ -27,7 +27,7 @@ Scalaはメソッドのパラメータとしてパラメータ無しの関数名 関数 whileLoop は2つのパラメータ`cond`と`body`を受け取ります。関数が適用される時、実際のパラメータは評価されません。しかし形式上のパラメータが`whileLoop`の本体内で使われる度に、暗黙に生成された引数の無い関数が代わりに評価されます。このようにメソッド`whileLoop`はJavaのようなwhileループを再帰的な方法で実装しています。 -[中置/後置 演算子](operators.html)とこのメカニズムを組み合わせ利用し、より複雑な式を(より良い構文で)が作れます。 +[中置/後置 演算子](operators.html)とこのメカニズムを組み合わせ利用し、より複雑な式を(より良い構文で)作れます。 こちらがloop-unless式の実装です。 From 3d67daf99b56fbef8c7dd45d847f23caeec12548 Mon Sep 17 00:00:00 2001 From: take2 Date: Wed, 3 Jul 2019 01:14:37 +0900 Subject: [PATCH 0557/3075] Update _ja/tour/automatic-closures.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit bodyは素直に概念の説明にした方が日本語が読みやすい Co-Authored-By: Masanori Fujita --- _ja/tour/automatic-closures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md index a12b8e8742..0b865b72fd 100644 --- a/_ja/tour/automatic-closures.md +++ b/_ja/tour/automatic-closures.md @@ -46,7 +46,7 @@ Scalaはメソッドのパラメータとしてパラメータ無しの関数名 i -= 1 } unless (i == 0) } -この`loop`関数はループ処理の本体を受け取り、クラス`LoopUnlessCond`(bodyのオブジェクトをカプセル化する)のインスタンスを返すだけです。bodyはまだ評価されていないことに気をつけてください。クラス`LoopUnlessCond`は中置演算子として使えるメソッド`unless`を持ちます。このようにより自然な構文で新しいループ処理`loop { < stats > } unless ( < cond > )`を作れます。 +この`loop`関数はループ処理の本体を受け取り、クラス`LoopUnlessCond`(この処理の本体をカプセル化する)のインスタンスを返すだけです。処理の本体はまだ評価されていないことに気をつけてください。クラス`LoopUnlessCond`は *中置演算子* として使えるメソッド`unless`を持ちます。このように、新しいループ処理: `loop { < stats > } unless ( < cond > )`のとても自然な構文を作れます。 こちらが`TargetTest2`を実行した時の出力です。 From 6e5434acba1e4ca38b33c31ccdad0924052ec17c Mon Sep 17 00:00:00 2001 From: Suraj Gharat Date: Wed, 3 Jul 2019 15:00:49 +0530 Subject: [PATCH 0558/3075] Update futures.md Correcting a statement that incorrectly refers future instead of promise. --- _overviews/core/futures.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/core/futures.md b/_overviews/core/futures.md index a0eea92daf..9546e86c33 100644 --- a/_overviews/core/futures.md +++ b/_overviews/core/futures.md @@ -841,7 +841,7 @@ for a more precise description of the semantics. ## Promises So far we have only considered `Future` objects created by -asynchronous computations started using the `future` method. +asynchronous computations started using the `Future` method. However, futures can also be created using *promises*. While futures are defined as a type of read-only placeholder object @@ -935,7 +935,7 @@ has not been completed yet (e.g., there are several HTTP requests being executed from several different futures and the client is interested only in the first HTTP response - corresponding to the first future to complete the promise). For these reasons methods `tryComplete`, -`trySuccess` and `tryFailure` exist on future. The client should be +`trySuccess` and `tryFailure` exist on promise. The client should be aware that using these methods results in programs which are not deterministic, but depend on the execution schedule. From 131a53b860396a4f3392b57513eee368aafdecb4 Mon Sep 17 00:00:00 2001 From: "Aaron S. Hawley" Date: Wed, 3 Jul 2019 05:41:16 -0400 Subject: [PATCH 0559/3075] Fix page title for cheatsheet --- _ba/cheatsheets/index.md | 2 +- _fr/cheatsheets/index.md | 2 +- _ja/cheatsheets/index.md | 2 +- _overviews/cheatsheets/index.md | 2 +- _pt-br/cheatsheets/index.md | 2 +- _ru/cheatsheets/index.md | 2 +- _th/cheatsheets/index.md | 2 +- _zh-cn/cheatsheets/index.md | 2 +- 8 files changed, 8 insertions(+), 8 deletions(-) diff --git a/_ba/cheatsheets/index.md b/_ba/cheatsheets/index.md index 0a7e59790f..c311bf4b1e 100644 --- a/_ba/cheatsheets/index.md +++ b/_ba/cheatsheets/index.md @@ -1,6 +1,6 @@ --- layout: cheatsheet -title: Scalacheat +title: Scala Cheatsheet partof: cheatsheet diff --git a/_fr/cheatsheets/index.md b/_fr/cheatsheets/index.md index 9cb47c6f8d..a75cc71141 100644 --- a/_fr/cheatsheets/index.md +++ b/_fr/cheatsheets/index.md @@ -1,6 +1,6 @@ --- layout: cheatsheet -title: Scalacheat +title: Scala Cheatsheet partof: cheatsheet diff --git a/_ja/cheatsheets/index.md b/_ja/cheatsheets/index.md index b133ef48e4..cf7d670ced 100644 --- a/_ja/cheatsheets/index.md +++ b/_ja/cheatsheets/index.md @@ -1,6 +1,6 @@ --- layout: cheatsheet -title: Scalacheat +title: Scala Cheatsheet partof: cheatsheet diff --git a/_overviews/cheatsheets/index.md b/_overviews/cheatsheets/index.md index 42c2b9c06b..07d96b55c8 100644 --- a/_overviews/cheatsheets/index.md +++ b/_overviews/cheatsheets/index.md @@ -1,6 +1,6 @@ --- layout: cheatsheet -title: Scalacheat +title: Scala Cheatsheet partof: cheatsheet diff --git a/_pt-br/cheatsheets/index.md b/_pt-br/cheatsheets/index.md index 5d3176bda0..27e64f8d74 100644 --- a/_pt-br/cheatsheets/index.md +++ b/_pt-br/cheatsheets/index.md @@ -1,6 +1,6 @@ --- layout: cheatsheet -title: Scalacheat +title: Scala Cheatsheet partof: cheatsheet diff --git a/_ru/cheatsheets/index.md b/_ru/cheatsheets/index.md index 83d2e9d7c4..98b883f9e4 100644 --- a/_ru/cheatsheets/index.md +++ b/_ru/cheatsheets/index.md @@ -1,6 +1,6 @@ --- layout: cheatsheet -title: Scalacheat +title: Scala Cheatsheet partof: cheatsheet diff --git a/_th/cheatsheets/index.md b/_th/cheatsheets/index.md index 0b2faca68b..26b27062da 100644 --- a/_th/cheatsheets/index.md +++ b/_th/cheatsheets/index.md @@ -1,6 +1,6 @@ --- layout: cheatsheet -title: Scalacheat +title: Scala Cheatsheet partof: cheatsheet diff --git a/_zh-cn/cheatsheets/index.md b/_zh-cn/cheatsheets/index.md index 6fe47a86b2..b8178b3fd3 100644 --- a/_zh-cn/cheatsheets/index.md +++ b/_zh-cn/cheatsheets/index.md @@ -1,6 +1,6 @@ --- layout: cheatsheet -title: Scalacheat +title: Scala Cheatsheet partof: cheatsheet From 7290a257267acbc58ebe6be55df9dea0e6a07062 Mon Sep 17 00:00:00 2001 From: "Aaron S. Hawley" Date: Wed, 3 Jul 2019 06:46:06 -0400 Subject: [PATCH 0560/3075] Add contributing page for Scaladoc Move off of overview page. Mention Dottydoc. --- _overviews/scaladoc/contribute.md | 28 ++++++++++++++++++++++++++++ _overviews/scaladoc/overview.md | 11 ----------- 2 files changed, 28 insertions(+), 11 deletions(-) create mode 100644 _overviews/scaladoc/contribute.md diff --git a/_overviews/scaladoc/contribute.md b/_overviews/scaladoc/contribute.md new file mode 100644 index 0000000000..e7fa785616 --- /dev/null +++ b/_overviews/scaladoc/contribute.md @@ -0,0 +1,28 @@ +--- +layout: multipage-overview +title: Contributing to Scaladoc + +discourse: true + +partof: scaladoc +overview-name: Scaladoc + +num: 5 + +permalink: /overviews/scaladoc/:title.html +--- + +If you are interested in contributing to the API documentation of the Scala +standard library (the documentation generated by Scaladoc), please read +[Generating Scaladoc]({{ site.baseurl }}/overviews/scaladoc/generate.html) and +[Scaladoc for Library Authors]({{ site.baseurl }}/overviews/scaladoc/basics.html) first. + +If you'd like to contribute to the actual Scaladoc documentation generation +tool itself, then please see the +[Hacker Set Up Guide](http://scala-lang.org/contribute/hacker-guide.html#2-set-up) +which covers the steps and workflow necessary work on the Scaladoc tool. + +As of Scala 2.13, the Scaladoc tool is maintained but not actively +developed. Major development of Scaladoc will progress as a part of +Dotty for Scala 3 in the +[Dottydoc](https://dotty.epfl.ch/docs/usage/dottydoc.html) tool. \ No newline at end of file diff --git a/_overviews/scaladoc/overview.md b/_overviews/scaladoc/overview.md index b31aea8ef5..92426fa0bf 100644 --- a/_overviews/scaladoc/overview.md +++ b/_overviews/scaladoc/overview.md @@ -22,14 +22,3 @@ There are three aspects of Scaladoc documentation: - **[Using the Scaladoc interface]({{ site.baseurl }}/overviews/scaladoc/interface.html)** – how to navigate and use generated Scaladoc documentation to learn more about a library. - **[Scaladoc for Library Authors]({{ site.baseurl }}/overviews/scaladoc/for-library-authors.html)** – how to add Scaladoc comments to generate documentation for your library. - **[Generating documentation for your library with Scaladoc]({{ site.baseurl }}/overviews/scaladoc/generate.html)** – how to use Scaladoc to generate documentation for your library. - -### Contributing to Scaladoc - -If you are interested in contributing to the API documentation of the Scala -standard library (the documentation generated by Scaladoc), please read the -[Scaladoc for Library Authors]({{ site.baseurl }}/overviews/scaladoc/basics.html) first. - -If you'd like to contribute to the actual Scaladoc documentation generation -tool itself, then please see the -[Hacker Set Up Guide](http://scala-lang.org/contribute/hacker-guide.html#2_set_up) -which covers the steps and workflow necessary work on the Scaladoc tool. From cb9c19f2f4225fadfc9029bb32335311aa322914 Mon Sep 17 00:00:00 2001 From: Parambir Singh Date: Thu, 4 Jul 2019 16:37:21 -0700 Subject: [PATCH 0561/3075] Update inner-classes.md Explicitly specify `Unit` return type in example code --- _tour/inner-classes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_tour/inner-classes.md b/_tour/inner-classes.md index 172dd03bcd..fd99065542 100644 --- a/_tour/inner-classes.md +++ b/_tour/inner-classes.md @@ -21,7 +21,7 @@ To illustrate the difference, we quickly sketch the implementation of a graph da class Graph { class Node { var connectedNodes: List[Node] = Nil - def connectTo(node: Node) { + def connectTo(node: Node): Unit = { if (connectedNodes.find(node.equals).isEmpty) { connectedNodes = node :: connectedNodes } @@ -65,7 +65,7 @@ The type `graph1.Node` is distinct from the type `graph2.Node`. In Java, the las class Graph { class Node { var connectedNodes: List[Graph#Node] = Nil - def connectTo(node: Graph#Node) { + def connectTo(node: Graph#Node): Unit = { if (connectedNodes.find(node.equals).isEmpty) { connectedNodes = node :: connectedNodes } From edce11e76d7c3599d78d4d6b11aa89d40c530f03 Mon Sep 17 00:00:00 2001 From: take2 Date: Fri, 5 Jul 2019 12:51:56 +0900 Subject: [PATCH 0562/3075] Update _ja/tour/automatic-closures.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 「代わりに」の意味を明確にするため句点を追加 Co-Authored-By: TATSUNO Yasuhiro --- _ja/tour/automatic-closures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md index 0b865b72fd..e40a3202fd 100644 --- a/_ja/tour/automatic-closures.md +++ b/_ja/tour/automatic-closures.md @@ -8,7 +8,7 @@ discourse: true partof: scala-tour --- -Scalaはメソッドのパラメータとしてパラメータ無しの関数名を渡せます。そのようなメソッドが呼ばれると、パラメータ無しの関数名は実際に評価されず、代わりに対応するパラメーターの処理をカプセル化した、引数無しの関数が渡されます(いわゆる *名前渡し*評価です)。 +Scalaはメソッドのパラメータとしてパラメータ無しの関数名を渡せます。そのようなメソッドが呼ばれると、パラメータ無しの関数名は実際に評価されず、代わりに、対応するパラメーターの処理をカプセル化した、引数無しの関数が渡されます(いわゆる *名前渡し*評価です)。 以下のコードはこの仕組みを説明しています。 From c8441a92ed310a6d37c128fadb58ca7df8ab7b9e Mon Sep 17 00:00:00 2001 From: take2 Date: Fri, 5 Jul 2019 12:55:56 +0900 Subject: [PATCH 0563/3075] Update _ja/tour/automatic-closures.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit statementは「式」ではなく「文」、文章の流れ的に「命令文」がより適切 Co-Authored-By: TATSUNO Yasuhiro --- _ja/tour/automatic-closures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md index e40a3202fd..3b38e98178 100644 --- a/_ja/tour/automatic-closures.md +++ b/_ja/tour/automatic-closures.md @@ -27,7 +27,7 @@ Scalaはメソッドのパラメータとしてパラメータ無しの関数名 関数 whileLoop は2つのパラメータ`cond`と`body`を受け取ります。関数が適用される時、実際のパラメータは評価されません。しかし形式上のパラメータが`whileLoop`の本体内で使われる度に、暗黙に生成された引数の無い関数が代わりに評価されます。このようにメソッド`whileLoop`はJavaのようなwhileループを再帰的な方法で実装しています。 -[中置/後置 演算子](operators.html)とこのメカニズムを組み合わせ利用し、より複雑な式を(より良い構文で)作れます。 +[中置/後置 演算子](operators.html)とこのメカニズムを組み合わせて利用し、より複雑な命令文を(より良い構文で)作れます。 こちらがloop-unless式の実装です。 From 99ce16089c0874e4eba958cbcadb67f59533e442 Mon Sep 17 00:00:00 2001 From: Dima Kotobotov Date: Fri, 5 Jul 2019 00:34:44 +0300 Subject: [PATCH 0564/3075] :pencil2: Fixing typos. --- _overviews/collections-2.13/iterators.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_overviews/collections-2.13/iterators.md b/_overviews/collections-2.13/iterators.md index 55de58cb7e..7577377bb8 100644 --- a/_overviews/collections-2.13/iterators.md +++ b/_overviews/collections-2.13/iterators.md @@ -46,7 +46,7 @@ The other operations that `Iterator` has in common with `Iterable` have the same res4: Boolean = false As you can see, after the call to `it.map`, the `it` iterator hasn’t advanced to its end, but traversing the iterator -resulting from the call to `it.map` also traverses `it` and advances it to its end. +resulting from the call to `res1.foreach` also traverses `it` and advances it to its end. Another example is the `dropWhile` method, which can be used to find the first elements of an iterator that has a certain property. For instance, to find the first word in the iterator above that has at least two characters you could write: @@ -92,7 +92,7 @@ All operations on iterators are summarized below. | **Variations:** | | | `it.buffered` | A buffered iterator returning all elements of `it`. | | `it grouped size` | An iterator that yields the elements returned by `it` in fixed-sized sequence "chunks". | -| `xs sliding size` | An iterator that yields the elements returned by `it` in sequences representing a sliding fixed-sized window. | +| `it sliding size` | An iterator that yields the elements returned by `it` in sequences representing a sliding fixed-sized window. | | **Duplication:** | | | `it.duplicate` | A pair of iterators that each independently return all elements of `it`. | | **Additions:** | | @@ -100,7 +100,7 @@ All operations on iterators are summarized below. | `it.padTo(len, x)` | The iterator that first returns all elements of `it` and then follows that by copies of `x` until length `len` elements are returned overall. | | **Maps:** | | | `it map f` | The iterator obtained from applying the function `f` to every element returned from `it`. | -| `it flatMap f` | The iterator obtained from applying the iterator-valued function f to every element in `it` and appending the results. | +| `it flatMap f` | The iterator obtained from applying the iterator-valued function `f` to every element in `it` and appending the results. | | `it collect f` | The iterator obtained from applying the partial function `f` to every element in `it` for which it is defined and collecting the results. | | **Conversions:** | | | `it.toArray` | Collects the elements returned by `it` in an array. | @@ -118,7 +118,7 @@ All operations on iterators are summarized below. | `it.nonEmpty` | Test whether the collection contains elements (alias of `hasNext`). | | `it.size` | The number of elements returned by `it`. Note: `it` will be at its end after this operation! | | `it.length` | Same as `it.size`. | -| `xs.knownSize` |The number of elements, if this one is known without modifying the iterator’s state, otherwise `-1`. | +| `it.knownSize` |The number of elements, if this one is known without modifying the iterator’s state, otherwise `-1`. | | **Element Retrieval Index Search:**| | | `it find p` | An option containing the first element returned by `it` that satisfies `p`, or `None` is no element qualifies. Note: The iterator advances to after the element, or, if none is found, to the end. | | `it indexOf x` | The index of the first element returned by `it` that equals `x`. Note: The iterator advances past the position of this element. | @@ -157,7 +157,7 @@ All operations on iterators are summarized below. | **Update:** | | | `it.patch(i, jt, r)` | The iterator resulting from `it` by replacing `r` elements starting with `i` by the patch iterator `jt`. | | **Comparison:** | | -| `it sameElements jt` | A test whether iterators it and `jt` return the same elements in the same order. Note: Using the iterators after this operation is undefined and subject to change. | +| `it sameElements jt` | A test whether iterators `it` and `jt` return the same elements in the same order. Note: Using the iterators after this operation is undefined and subject to change. | | **Strings:** | | | `it.addString(b, start, sep, end)`| Adds a string to `StringBuilder` `b` which shows all elements returned by `it` between separators `sep` enclosed in strings `start` and `end`. `start`, `sep`, `end` are all optional. | | `it.mkString(start, sep, end)` | Converts the collection to a string which shows all elements returned by `it` between separators `sep` enclosed in strings `start` and `end`. `start`, `sep`, `end` are all optional. | From b24c5b23f55a03608d46848623eb2ff0f3575605 Mon Sep 17 00:00:00 2001 From: Philippus Date: Sun, 7 Jul 2019 17:36:40 +0200 Subject: [PATCH 0565/3075] Remove redirect_from from ja tour --- _ja/tour/abstract-type-members.md | 2 -- _ja/tour/annotations.md | 1 - _ja/tour/basics.md | 1 - _ja/tour/by-name-parameters.md | 1 - _ja/tour/case-classes.md | 1 - _ja/tour/classes.md | 1 - _ja/tour/compound-types.md | 1 - _ja/tour/default-parameter-values.md | 1 - _ja/tour/extractor-objects.md | 1 - _ja/tour/for-comprehensions.md | 1 - _ja/tour/generic-classes.md | 1 - _ja/tour/higher-order-functions.md | 1 - _ja/tour/implicit-conversions.md | 1 - _ja/tour/implicit-parameters.md | 1 - _ja/tour/inner-classes.md | 1 - _ja/tour/lower-type-bounds.md | 1 - _ja/tour/mixin-class-composition.md | 1 - _ja/tour/multiple-parameter-lists.md | 1 - _ja/tour/named-arguments.md | 1 - _ja/tour/nested-functions.md | 1 - _ja/tour/operators.md | 1 - _ja/tour/pattern-matching.md | 1 - _ja/tour/polymorphic-methods.md | 1 - _ja/tour/regular-expression-patterns.md | 1 - _ja/tour/self-types.md | 1 - _ja/tour/singleton-objects.md | 1 - _ja/tour/tour-of-scala.md | 1 - _ja/tour/traits.md | 1 - _ja/tour/tuples.md | 1 - _ja/tour/unified-types.md | 1 - _ja/tour/upper-type-bounds.md | 1 - _ja/tour/variances.md | 1 - 32 files changed, 33 deletions(-) diff --git a/_ja/tour/abstract-type-members.md b/_ja/tour/abstract-type-members.md index f5821a7b74..0a0a61f387 100644 --- a/_ja/tour/abstract-type-members.md +++ b/_ja/tour/abstract-type-members.md @@ -12,8 +12,6 @@ previous-page: inner-classes topics: abstract type members prerequisite-knowledge: variance, upper-type-bound -redirect_from: "/tutorials/tour/abstract-types.html" -redirect_from: "/tour/abstract-types.html" --- トレイトや抽象クラスのような抽象型は抽象型メンバーを持つことができます。 diff --git a/_ja/tour/annotations.md b/_ja/tour/annotations.md index 88114954f1..5858105b01 100644 --- a/_ja/tour/annotations.md +++ b/_ja/tour/annotations.md @@ -11,7 +11,6 @@ num: 32 next-page: default-parameter-values previous-page: by-name-parameters -redirect_from: "/tutorials/tour/annotations.html" --- アノテーションはメタ情報と定義を関連づけます。例えば、メソッドの前のアノテーション`@deprecated`はメソッドが使われたらコンパイラに警告を出力させます。 diff --git a/_ja/tour/basics.md b/_ja/tour/basics.md index b14330f2b3..8eb67a0ddb 100644 --- a/_ja/tour/basics.md +++ b/_ja/tour/basics.md @@ -11,7 +11,6 @@ num: 2 next-page: unified-types previous-page: tour-of-scala -redirect_from: "/tutorials/tour/basics.html" --- このページでは、Scalaの基本を取り扱います。 diff --git a/_ja/tour/by-name-parameters.md b/_ja/tour/by-name-parameters.md index 86325795ba..411afa5957 100644 --- a/_ja/tour/by-name-parameters.md +++ b/_ja/tour/by-name-parameters.md @@ -11,7 +11,6 @@ num: 31 next-page: annotations previous-page: operators -redirect_from: "/tutorials/tour/by-name-parameters.html" --- *名前渡しのパラメータ*は使用された時に評価されます。それらは*値渡しパラメータ*とは対照的です。名前渡しのパラメータを作るには、単純に`=>`を型の前につけます。 diff --git a/_ja/tour/case-classes.md b/_ja/tour/case-classes.md index 99a1b6e6f0..5493a00790 100644 --- a/_ja/tour/case-classes.md +++ b/_ja/tour/case-classes.md @@ -12,7 +12,6 @@ next-page: pattern-matching previous-page: multiple-parameter-lists prerequisite-knowledge: classes, basics, mutability -redirect_from: "/tutorials/tour/case-classes.html" --- ケースクラスはこれから論じるいくつかの差異はあるものの普通のクラスと似ています。 diff --git a/_ja/tour/classes.md b/_ja/tour/classes.md index 0253f210f5..36cf3ec851 100644 --- a/_ja/tour/classes.md +++ b/_ja/tour/classes.md @@ -13,7 +13,6 @@ previous-page: unified-types topics: classes prerequisite-knowledge: no-return-keyword, type-declaration-syntax, string-interpolation, procedures -redirect_from: "/tutorials/tour/classes.html" --- Scalaにおけるクラスはオブジェクトを作るための設計図です。 diff --git a/_ja/tour/compound-types.md b/_ja/tour/compound-types.md index 6eeadc481d..061a5dc331 100644 --- a/_ja/tour/compound-types.md +++ b/_ja/tour/compound-types.md @@ -11,7 +11,6 @@ num: 24 next-page: self-types previous-page: abstract-type-members -redirect_from: "/tutorials/tour/compound-types.html" --- ときどき、あるオブジェクトの型が、複数の他の型のサブタイプであると表現する必要が生じます。 Scalaでは、これは*複合型*を用いて表現できます。複合型とはオブジェクトの型同士を重ねることです。 diff --git a/_ja/tour/default-parameter-values.md b/_ja/tour/default-parameter-values.md index fe2da78c75..dde76cdeaf 100644 --- a/_ja/tour/default-parameter-values.md +++ b/_ja/tour/default-parameter-values.md @@ -12,7 +12,6 @@ next-page: named-arguments previous-page: annotations prerequisite-knowledge: named-arguments, function syntax -redirect_from: "/tutorials/tour/default-parameter-values.html" --- Scalaはパラメータのデフォルト値を与えることができ、呼び出す側はこれらのパラメータを省略できます。 diff --git a/_ja/tour/extractor-objects.md b/_ja/tour/extractor-objects.md index 2b12283764..d3af5a18e7 100644 --- a/_ja/tour/extractor-objects.md +++ b/_ja/tour/extractor-objects.md @@ -11,7 +11,6 @@ num: 16 next-page: for-comprehensions previous-page: regular-expression-patterns -redirect_from: "/tutorials/tour/extractor-objects.html" --- 抽出子オブジェクトは`unapply`メソッドを持つオブジェクトです。 diff --git a/_ja/tour/for-comprehensions.md b/_ja/tour/for-comprehensions.md index 89bce4d42a..eccd124c8c 100644 --- a/_ja/tour/for-comprehensions.md +++ b/_ja/tour/for-comprehensions.md @@ -11,7 +11,6 @@ num: 17 next-page: generic-classes previous-page: extractor-objects -redirect_from: "/tutorials/tour/for-comprehensions.html" --- Scalaは*シーケンス内包表記*を表現するための軽量な記法を提供します。 diff --git a/_ja/tour/generic-classes.md b/_ja/tour/generic-classes.md index 2535e31695..7912d2be21 100644 --- a/_ja/tour/generic-classes.md +++ b/_ja/tour/generic-classes.md @@ -12,7 +12,6 @@ next-page: variances previous-page: for-comprehensions assumed-knowledge: classes unified-types -redirect_from: "/tutorials/tour/generic-classes.html" --- ジェネリッククラスはパラメータとして型を1つ受け取るクラスです。それらはコレクションクラスで特に役立ちます。 diff --git a/_ja/tour/higher-order-functions.md b/_ja/tour/higher-order-functions.md index 57714202e8..88d432aaf5 100644 --- a/_ja/tour/higher-order-functions.md +++ b/_ja/tour/higher-order-functions.md @@ -11,7 +11,6 @@ num: 8 next-page: nested-functions previous-page: mixin-class-composition -redirect_from: "/tutorials/tour/higher-order-functions.html" --- 高階関数は他の関数をパラメーターとして受け取る、もしくは結果として関数を返します。 diff --git a/_ja/tour/implicit-conversions.md b/_ja/tour/implicit-conversions.md index 386ed3c500..107979e2dc 100644 --- a/_ja/tour/implicit-conversions.md +++ b/_ja/tour/implicit-conversions.md @@ -11,7 +11,6 @@ num: 27 next-page: polymorphic-methods previous-page: implicit-parameters -redirect_from: "/tutorials/tour/implicit-conversions.html" --- 型`S`から型`T`への暗黙の変換は`S => T`という型のimplicit値や、その型に一致するimplicitメソッドで定義されます。 diff --git a/_ja/tour/implicit-parameters.md b/_ja/tour/implicit-parameters.md index 38067f9e27..53613be8ee 100644 --- a/_ja/tour/implicit-parameters.md +++ b/_ja/tour/implicit-parameters.md @@ -11,7 +11,6 @@ num: 26 next-page: implicit-conversions previous-page: self-types -redirect_from: "/tutorials/tour/implicit-parameters.html" --- メソッドは _暗黙の_ パラメータのリストを持つことができ、パラメータリストの先頭には _implicit_ キーワードで印をつけます。 diff --git a/_ja/tour/inner-classes.md b/_ja/tour/inner-classes.md index 4bc373d8c8..03450fdc14 100644 --- a/_ja/tour/inner-classes.md +++ b/_ja/tour/inner-classes.md @@ -11,7 +11,6 @@ num: 22 next-page: abstract-type-members previous-page: lower-type-bounds -redirect_from: "/tutorials/tour/inner-classes.html" --- Scalaではクラスが他のクラスをメンバーとして保持することが可能です。 diff --git a/_ja/tour/lower-type-bounds.md b/_ja/tour/lower-type-bounds.md index d461e31e5d..b6b98cebdb 100644 --- a/_ja/tour/lower-type-bounds.md +++ b/_ja/tour/lower-type-bounds.md @@ -12,7 +12,6 @@ next-page: inner-classes previous-page: upper-type-bounds prerequisite-knowledge: upper-type-bounds, generics, variance -redirect_from: "/tutorials/tour/lower-type-bounds.html" --- [上限型境界](upper-type-bounds.html) は型を別の型のサブタイプに制限しますが、*下限型境界*は型が別の型のスーパータイプであることを宣言します。表現`B >: A`はパラメータ`B`または抽象型`B`が型`A`のスーパータイプであることを表します。ほとんどのケースで`A`はそのクラスの型パラメータであり、`B`はメソッドの型パラメータになります。 diff --git a/_ja/tour/mixin-class-composition.md b/_ja/tour/mixin-class-composition.md index 9ec9fd65f4..c5d40ebe16 100644 --- a/_ja/tour/mixin-class-composition.md +++ b/_ja/tour/mixin-class-composition.md @@ -12,7 +12,6 @@ next-page: higher-order-functions previous-page: tuples prerequisite-knowledge: inheritance, traits, abstract-classes, unified-types -redirect_from: "/tutorials/tour/mixin-class-composition.html" --- ミックスインはクラスを構成するのに使われるトレイトです。 diff --git a/_ja/tour/multiple-parameter-lists.md b/_ja/tour/multiple-parameter-lists.md index a35bccf615..3cddffe859 100644 --- a/_ja/tour/multiple-parameter-lists.md +++ b/_ja/tour/multiple-parameter-lists.md @@ -11,7 +11,6 @@ num: 10 next-page: case-classes previous-page: nested-functions -redirect_from: "/tutorials/tour/multiple-parameter-lists.html" --- メソッドは複数のパラメータリストを持てます。 diff --git a/_ja/tour/named-arguments.md b/_ja/tour/named-arguments.md index b7f0ca82a2..eda94a0c8c 100644 --- a/_ja/tour/named-arguments.md +++ b/_ja/tour/named-arguments.md @@ -12,7 +12,6 @@ next-page: packages-and-imports previous-page: default-parameter-values prerequisite-knowledge: function-syntax -redirect_from: "/tutorials/tour/named-arguments.html" --- メソッドを呼ぶ時、以下のように引数にパラメータ名でラベル付が可能です。 diff --git a/_ja/tour/nested-functions.md b/_ja/tour/nested-functions.md index 05a57a2fae..2769c20674 100644 --- a/_ja/tour/nested-functions.md +++ b/_ja/tour/nested-functions.md @@ -11,7 +11,6 @@ num: 9 next-page: multiple-parameter-lists previous-page: higher-order-functions -redirect_from: "/tutorials/tour/nested-functions.html" --- Scalaではメソッドの定義をネストする（_訳注：入れ子にする_）ことができます。 diff --git a/_ja/tour/operators.md b/_ja/tour/operators.md index b61b229558..e6c2352ef2 100644 --- a/_ja/tour/operators.md +++ b/_ja/tour/operators.md @@ -12,7 +12,6 @@ next-page: by-name-parameters previous-page: type-inference prerequisite-knowledge: case-classes -redirect_from: "/tutorials/tour/operators.html" --- Scalaでは演算子はメソッドです。パラメータを1つだけ持つメソッドであれば*中置演算子*として使えます。例えば、`+`はドット記法で呼び出せます。 diff --git a/_ja/tour/pattern-matching.md b/_ja/tour/pattern-matching.md index d44d13e41b..dd032ed48e 100644 --- a/_ja/tour/pattern-matching.md +++ b/_ja/tour/pattern-matching.md @@ -13,7 +13,6 @@ next-page: singleton-objects previous-page: case-classes prerequisite-knowledge: case-classes, string-interpolation, subtyping -redirect_from: "/tutorials/tour/pattern-matching.html" --- パターンマッチングは値をパターンに照合するための仕組みです。 diff --git a/_ja/tour/polymorphic-methods.md b/_ja/tour/polymorphic-methods.md index 0770657246..7eac75ff39 100644 --- a/_ja/tour/polymorphic-methods.md +++ b/_ja/tour/polymorphic-methods.md @@ -13,7 +13,6 @@ next-page: type-inference previous-page: implicit-conversions prerequisite-knowledge: unified-types -redirect_from: "/tutorials/tour/polymorphic-methods.html" --- Scalaのメソッドは値と同様に型によってパラメータ化することができます。構文はジェネリッククラスの構文と似ています。 diff --git a/_ja/tour/regular-expression-patterns.md b/_ja/tour/regular-expression-patterns.md index 21068d1de1..a81168544c 100644 --- a/_ja/tour/regular-expression-patterns.md +++ b/_ja/tour/regular-expression-patterns.md @@ -12,7 +12,6 @@ num: 15 next-page: extractor-objects previous-page: singleton-objects -redirect_from: "/tutorials/tour/regular-expression-patterns.html" --- 正規表現はデータの中からパターン（またはその欠如）を探すために使うことができる文字列です。 どんな文字列も`.r`メソッドを使うことで、正規表現に変換できます。 diff --git a/_ja/tour/self-types.md b/_ja/tour/self-types.md index 836e4459ec..1bffbfe63c 100644 --- a/_ja/tour/self-types.md +++ b/_ja/tour/self-types.md @@ -13,7 +13,6 @@ previous-page: compound-types topics: self-types prerequisite-knowledge: nested-classes, mixin-class-composition -redirect_from: "/tutorials/tour/self-types.html" --- 自分型は、直接継承していなくてもトレイトが他のトレイトにミックスインされていることを宣言する方法です。 これにより依存先のメンバーをimportなしで利用できます。 diff --git a/_ja/tour/singleton-objects.md b/_ja/tour/singleton-objects.md index e920e884c9..feea0e5171 100644 --- a/_ja/tour/singleton-objects.md +++ b/_ja/tour/singleton-objects.md @@ -11,7 +11,6 @@ num: 13 next-page: regular-expression-patterns previous-page: pattern-matching -redirect_from: "/tutorials/tour/singleton-objects.html" prerequisite-knowledge: classes, methods, private-methods, packages, option --- オブジェクトは丁度1つのインスタンスを持つクラスです。 diff --git a/_ja/tour/tour-of-scala.md b/_ja/tour/tour-of-scala.md index 775c66557f..46658101bf 100644 --- a/_ja/tour/tour-of-scala.md +++ b/_ja/tour/tour-of-scala.md @@ -11,7 +11,6 @@ num: 1 next-page: basics -redirect_from: "/tutorials/tour/tour-of-scala.html" --- ## ようこそツアーへ diff --git a/_ja/tour/traits.md b/_ja/tour/traits.md index 1ea0b11809..5152af0fb0 100644 --- a/_ja/tour/traits.md +++ b/_ja/tour/traits.md @@ -13,7 +13,6 @@ previous-page: classes topics: traits prerequisite-knowledge: expressions, classes, generics, objects, companion-objects -redirect_from: "/tutorials/tour/traits.html" --- トレイトはクラス間でインターフェースとフィールドを共有するために使います。それらはJava 8のインターフェースと似ています。 diff --git a/_ja/tour/tuples.md b/_ja/tour/tuples.md index 0d67f6c5c1..822a6f5a72 100644 --- a/_ja/tour/tuples.md +++ b/_ja/tour/tuples.md @@ -12,7 +12,6 @@ next-page: mixin-class-composition previous-page: traits topics: tuples -redirect_from: "/tutorials/tour/tuples.html" --- Scalaではタプルは決まった数の要素を含む値であり、各要素はそれぞれの型を持ちます。 diff --git a/_ja/tour/unified-types.md b/_ja/tour/unified-types.md index 98482b1c95..c694663c59 100644 --- a/_ja/tour/unified-types.md +++ b/_ja/tour/unified-types.md @@ -12,7 +12,6 @@ next-page: classes previous-page: basics prerequisite-knowledge: classes, basics -redirect_from: "/tutorials/tour/unified-types.html" --- Scalaでは数値や関数を含め、全ての値は型を持ちます。 以下の図は型階層の一部を説明しています。 diff --git a/_ja/tour/upper-type-bounds.md b/_ja/tour/upper-type-bounds.md index 427dbe429f..ac6b1f2440 100644 --- a/_ja/tour/upper-type-bounds.md +++ b/_ja/tour/upper-type-bounds.md @@ -11,7 +11,6 @@ num: 20 next-page: lower-type-bounds previous-page: variances -redirect_from: "/tutorials/tour/upper-type-bounds.html" --- Scalaでは [型パラメータ](generic-classes.html)と[抽象型メンバー](abstract-type-members.html) は型境界による制約をかけることができます。 diff --git a/_ja/tour/variances.md b/_ja/tour/variances.md index 35f0d01de8..523820403f 100644 --- a/_ja/tour/variances.md +++ b/_ja/tour/variances.md @@ -11,7 +11,6 @@ num: 19 next-page: upper-type-bounds previous-page: generic-classes -redirect_from: "/tutorials/tour/variances.html" --- 変位指定は複合型の間の継承関係とそれらの型パラメータ間の継承関係の相関です。 From 4f0e54b1000e155cdd8d1ba3e6de7d7bd02eb933 Mon Sep 17 00:00:00 2001 From: Dale Wijnand Date: Thu, 4 Jul 2019 18:16:59 +0100 Subject: [PATCH 0566/3075] Tweak literal types spec part about asInstanceOf --- _sips/sips/2014-06-27-42.type.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/_sips/sips/2014-06-27-42.type.md b/_sips/sips/2014-06-27-42.type.md index afe0aeaeae..701c01c43c 100644 --- a/_sips/sips/2014-06-27-42.type.md +++ b/_sips/sips/2014-06-27-42.type.md @@ -23,6 +23,7 @@ Sabin** | Feb 9th 2017 | New author volunteered to update the SIP for review | | Nov 16th 2017 | Updated following implementation experience in Typelevel Scala | | Aug 7th 2018 | Updated to remove Symbol literals, which won't be supported in 3 | +| Jul 4th 2019 | Drop behaviour spec around asInstanceOf, which is a user assertion | ## Introduction @@ -104,7 +105,7 @@ Lightbend Scala compiler. narrow(23) // result is 23: 23 ``` -+ Pattern matching against literal types and `isInstanceOf`/`asInstanceOf` tests/conversions are ++ Pattern matching against literal types and `isInstanceOf` tests are implemented via equality/identity tests of the corresponding values. ``` (1: Any) match { @@ -112,8 +113,6 @@ Lightbend Scala compiler. case _ => false } // result is true (1: Any).isInstanceOf[1] // result is true - (1: Any).asInstanceOf[1] // result is 1: 1 - (1: Any).asInstanceOf[2] // ClassCastException ``` + A `scala.ValueOf[T]` type class and corresponding `scala.Predef.valueOf[T]` operator has been @@ -519,7 +518,7 @@ applications which work with large datasets. valueOf[23] // result is 23: 23 ``` -+ Pattern matching against literal types and `isInstanceOf`/`asInstanceOf` tests/conversions are ++ Pattern matching against literal types and `isInstanceOf` tests are implemented via equality/identity tests of the corresponding values. Pattern matching against typed patterns (see [8.1.2 Typed @@ -527,9 +526,9 @@ applications which work with large datasets. where the `TypePat` is a literal type is translated as a match against the subsuming non-singleton type followed by an equality test with the value corresponding to the literal type. - Where applied to literal types `isInstanceOf` and `asInstanceOf` are translated to a test against + Where applied to literal types `isInstanceOf` is translated to a test against the subsuming non-singleton type and an equality test with the value corresponding to the literal - type. In the case of `asInstanceOf` a `ClassCastException` is thrown if the test fails. + type. Examples, ``` @@ -538,10 +537,13 @@ applications which work with large datasets. case _ => false } // result is true (1: Any).isInstanceOf[1] // result is true - (1: Any).asInstanceOf[1] // result is 1: 1 - (1: Any).asInstanceOf[2] // ClassCastException ``` + Importantly, that doesn't include `asInstanceOf` as that is a user assertion to the compiler, with + the compiler inserting in the generated code just enough code for the underlying runtime to not + give a `ValidationError`. The compiler should not, for instance, generate code such that an + expression like `(1: Any).asInstanceOf[2]` would throw a `ClassCastException`. + + Default initialization for vars with literal types is forbidden. The default initializer for a var is already mandated to be it's natural zero element (`0`, From 4643f1228a86fb6c347d746267989a73cc89b695 Mon Sep 17 00:00:00 2001 From: Dale Wijnand <344610+dwijnand@users.noreply.github.com> Date: Tue, 9 Jul 2019 14:41:22 +0100 Subject: [PATCH 0567/3075] Point the hacker guide to 2.13 --- contribute/hacker-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 78af87bbcd..b9e657adfb 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -10,7 +10,7 @@ This guide is intended to help you get from an idea of fixing a bug or implement This guide covers the entire process, from the conception of your idea or bugfix to the point where it is merged into Scala. Throughout, we will use a running example of an idea or bugfix one might wish to contribute. -Other good starting points for first-time contributors include the [Scala README](https://github.com/scala/scala#get-in-touch) and [contributor's guidelines](https://github.com/scala/scala/blob/2.12.x/CONTRIBUTING.md). +Other good starting points for first-time contributors include the [Scala README](https://github.com/scala/scala#get-in-touch) and [contributor's guidelines](https://github.com/scala/scala/blob/2.13.x/CONTRIBUTING.md). ## The Running Example From 7bc642cd5d844621e9bb08f9c0e8529960417c1b Mon Sep 17 00:00:00 2001 From: Srishti Jain Date: Thu, 11 Jul 2019 14:42:31 +0530 Subject: [PATCH 0568/3075] Update overview.md `TypeTags` -> `TypeTag`s --- _overviews/reflection/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/reflection/overview.md b/_overviews/reflection/overview.md index 22b267acfa..037207df3e 100644 --- a/_overviews/reflection/overview.md +++ b/_overviews/reflection/overview.md @@ -69,7 +69,7 @@ means that if you were to inspect the runtime type of some instance, that you might not have access to all type information that the Scala compiler has available at compile time. -`TypeTags` can be thought of as objects which carry along all type information +`TypeTag`s can be thought of as objects which carry along all type information available at compile time, to runtime. Though, it's important to note that `TypeTag`s are always generated by the compiler. This generation is triggered whenever an implicit parameter or context bound requiring a `TypeTag` is used. From 2a2b92b1b6212f39b71a566532c2d605c4da3c68 Mon Sep 17 00:00:00 2001 From: Lucas Cardoso Date: Thu, 11 Jul 2019 10:18:34 -0300 Subject: [PATCH 0569/3075] Add Portuguese translation for Tuples --- _pt-br/tour/tuples.md | 73 ++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 68 insertions(+), 5 deletions(-) diff --git a/_pt-br/tour/tuples.md b/_pt-br/tour/tuples.md index 8b81442317..15462f152e 100644 --- a/_pt-br/tour/tuples.md +++ b/_pt-br/tour/tuples.md @@ -1,15 +1,78 @@ --- layout: tour -title: Tuples +title: Tuplas -discourse: true +discourse: false partof: scala-tour -num: + +num: 6 next-page: mixin-class-composition previous-page: traits language: pt-br --- -(this section of the tour has not been translated yet. pull request -with translation welcome!) \ No newline at end of file +Em Scala, uma tupla é um valor que contém um número fixo de elementos, cada um com tipos distintos e as tuplas são imutaveis. + +Tuplas são sobretudo úteis para retornar múltiplos valores de um método. + +Uma Tupla com dois lementos pode ser criada dessa forma: + +```tut +val ingrediente = ("Açucar" , 25) +``` + +Isto cria uma tupla contendo dois elementos um `String` e o outro `Int`. + +O tipo inferido de `ingrediente` é `(String, Int)`, que é uma forma abreviada para `Tuple2[String, Int]` . + +Para representar tuplas, Scala usa uma serie de classes: `Tuple2`, `Tuple3`, etc., até `Tuple22` . Cada classe tem + +## Acessando os Elementos + +Uma maneira de acessar os elementos da tupla é pela sua respectiva posição. Os elementos individuais são nomeados _1 , _2 , e assim por diante. + +```tut +println(ingrediente._1) // Açucar +println(ingrediente._2) // 25 +``` + +## Correspondência de padrões em tuplas + +Uma tupla pode tambem ser desmembrada usando correspondência de padrões: + +```tut +val (nome, quantidade) = ingrediente +println(nome) // Açucar +println(quantidade) // 25 +``` + +Aqui `nome` é um tipo inferido `String` e `quantidade` é um tipo inferido `Int` . + +Outro exemplo de correspondência de padrões em uma tupla: + +```tut +val planetas = + List(("Mercurio", 57.9), ("Vénus", 108.2), ("Terra", 149.6), + ("Marte", 227.9), ("Júpiter", 778.3)) +planetas.foreach{ + case ("Terra", distancia) => + println(s"Nosso planeta está a $distancia milhões de kilometros do sol") + case _ => +} +``` + +ou, um exemplo com `for` : + +```tut +val numPars = List((2, 5), (3, -7), (20, 56)) +for ((a, b) <- numPars) { + println(a * b) +} +``` + +## Tuplas e classes case + +Desenvolvedores às vezes acham dificil escolher entre tuplas e classes case. Classes case tem elementos nomeados, e esses podem melhorar a leitura de alguns tipos de códigos. No planeta exemplo abaixo, nós poderiamos definir uma `case class Planeta(nome: String, distancia: Double)` ao invés de usar tuplas. + + From 95d2b37d36359933fdf2bcef31cb43188cee0eb1 Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Fri, 12 Jul 2019 04:09:02 +0900 Subject: [PATCH 0570/3075] Let match print messages to output comments --- _ja/tour/basics.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_ja/tour/basics.md b/_ja/tour/basics.md index 8eb67a0ddb..cab1c3d171 100644 --- a/_ja/tour/basics.md +++ b/_ja/tour/basics.md @@ -222,15 +222,15 @@ val yetAnotherPoint = Point(2, 2) ```tut if (point == anotherPoint) { - println(point + " and " + anotherPoint + " are the same.") + println(point + " と " + anotherPoint + " は同じです。") } else { - println(point + " and " + anotherPoint + " are different.") + println(point + " と " + anotherPoint + " は異なります。") } // Point(1,2) と Point(1,2) は同じです。 if (point == yetAnotherPoint) { - println(point + " and " + yetAnotherPoint + " are the same.") + println(point + " と " + yetAnotherPoint + " は同じです。") } else { - println(point + " and " + yetAnotherPoint + " are different.") + println(point + " と " + yetAnotherPoint + " は異なります。") } // Point(1,2) と Point(2,2) は異なります。 ``` From 61bad7b8fea308f60be8be96f1570bcc52a6e3b7 Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Fri, 12 Jul 2019 04:31:48 +0900 Subject: [PATCH 0571/3075] =?UTF-8?q?Replace=20comma=20with=20reading=20po?= =?UTF-8?q?int=20(,=20=E2=86=92=20=E3=80=81)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- _ja/tour/unified-types.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/unified-types.md b/_ja/tour/unified-types.md index c694663c59..ab65765d37 100644 --- a/_ja/tour/unified-types.md +++ b/_ja/tour/unified-types.md @@ -25,7 +25,7 @@ Anyは `equals`、` hashCode`、そして `toString`のようないくつかの そして`AnyVal`と`AnyRef` という2つの直系のサブクラスを持ちます。 `AnyVal` は値型に相当します。 -事前に定義された9つの値型が存在し、それら`Double`, `Float`, `Long`, `Int`, `Short`, `Byte`, `Char`, `Unit`,`Boolean`は +事前に定義された9つの値型が存在し、それら`Double`、`Float`、`Long`、`Int`、`Short`、`Byte`、`Char`、`Unit`、`Boolean`は null非許容です。 `Unit`は意味のある情報をもたない値型です。`Unit`型のインスタンスはただ1つだけあり、`()`というリテラルで宣言することができます。 全ての関数は必ず何かを返さなければなりません。そのため`Unit`は戻り値の型として時々役立ちます。 From 20b9bbc651c5c939b2e4bd199c700166bc7008ee Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Fri, 12 Jul 2019 04:55:40 +0900 Subject: [PATCH 0572/3075] Remove a unneeded space --- _ja/tour/unified-types.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/unified-types.md b/_ja/tour/unified-types.md index ab65765d37..0317f06fe4 100644 --- a/_ja/tour/unified-types.md +++ b/_ja/tour/unified-types.md @@ -21,7 +21,7 @@ Scalaでは数値や関数を含め、全ての値は型を持ちます。 ## Scalaの型階層 ## [`Any`](http://www.scala-lang.org/api/2.12.1/scala/Any.html) は全ての型のスーパータイプであり、トップ型とも呼ばれます。 -Anyは `equals`、` hashCode`、そして `toString`のようないくつかの普遍的なメソッドを定義しています。 +Anyは `equals`、`hashCode`、そして `toString`のようないくつかの普遍的なメソッドを定義しています。 そして`AnyVal`と`AnyRef` という2つの直系のサブクラスを持ちます。 `AnyVal` は値型に相当します。 From a5bdc323a457701a65852bc04e745870f7352b7d Mon Sep 17 00:00:00 2001 From: "Aaron S. Hawley" Date: Thu, 11 Jul 2019 17:05:23 -0400 Subject: [PATCH 0573/3075] Move Scaladoc interface in menu as second --- _overviews/scaladoc/for-library-authors.md | 2 +- _overviews/scaladoc/interface.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scaladoc/for-library-authors.md b/_overviews/scaladoc/for-library-authors.md index 9d3fc9e9a3..eb747c025c 100644 --- a/_overviews/scaladoc/for-library-authors.md +++ b/_overviews/scaladoc/for-library-authors.md @@ -7,7 +7,7 @@ discourse: true partof: scaladoc overview-name: Scaladoc -num: 2 +num: 3 permalink: /overviews/scaladoc/:title.html --- diff --git a/_overviews/scaladoc/interface.md b/_overviews/scaladoc/interface.md index f64417c2be..75a95d4f10 100644 --- a/_overviews/scaladoc/interface.md +++ b/_overviews/scaladoc/interface.md @@ -7,7 +7,7 @@ discourse: true partof: scaladoc overview-name: Scaladoc -num: 3 +num: 2 permalink: /overviews/scaladoc/:title.html --- From d7c05b665528136b17e0e86eafbfd27050c958e5 Mon Sep 17 00:00:00 2001 From: exoego Date: Fri, 5 Jul 2019 20:03:05 +0900 Subject: [PATCH 0574/3075] Do not remove language code from page.url --- _includes/sidebar-toc-multipage-overview.html | 2 +- _includes/sidebar-toc-singlepage-overview.html | 2 +- _layouts/cheatsheet.html | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_includes/sidebar-toc-multipage-overview.html b/_includes/sidebar-toc-multipage-overview.html index f454abc5e6..8d2e419efc 100644 --- a/_includes/sidebar-toc-multipage-overview.html +++ b/_includes/sidebar-toc-multipage-overview.html @@ -27,7 +27,7 @@
Contents
+
+ {% if page.previous-page %} + ← previous + {% else %} +
+ {% endif %} + {% if page.next-page %} + next → + {% endif %} +
+ {% include contributors-list.html %}
diff --git a/_overviews/collections-2.13/arrays.md b/_overviews/collections-2.13/arrays.md index 461d1edc1d..65c2a82d2f 100644 --- a/_overviews/collections-2.13/arrays.md +++ b/_overviews/collections-2.13/arrays.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 10 +previous-page: concrete-mutable-collection-classes +next-page: strings permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/concrete-immutable-collection-classes.md b/_overviews/collections-2.13/concrete-immutable-collection-classes.md index f2327fe8d8..a93e1911cf 100644 --- a/_overviews/collections-2.13/concrete-immutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-immutable-collection-classes.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 8 +previous-page: maps +next-page: concrete-mutable-collection-classes permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/concrete-mutable-collection-classes.md b/_overviews/collections-2.13/concrete-mutable-collection-classes.md index 9ddd1242ef..21b373078b 100644 --- a/_overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 9 +previous-page: concrete-immutable-collection-classes +next-page: arrays permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/conversions-between-java-and-scala-collections.md b/_overviews/collections-2.13/conversions-between-java-and-scala-collections.md index a1bf75ff12..b23967df24 100644 --- a/_overviews/collections-2.13/conversions-between-java-and-scala-collections.md +++ b/_overviews/collections-2.13/conversions-between-java-and-scala-collections.md @@ -8,6 +8,7 @@ partof: collections-213 overview-name: Collections num: 17 +previous-page: creating-collections-from-scratch permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/creating-collections-from-scratch.md b/_overviews/collections-2.13/creating-collections-from-scratch.md index 7f5a0b4ca2..7305a4b13d 100644 --- a/_overviews/collections-2.13/creating-collections-from-scratch.md +++ b/_overviews/collections-2.13/creating-collections-from-scratch.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 16 +previous-page: iterators +next-page: conversions-between-java-and-scala-collections permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/equality.md b/_overviews/collections-2.13/equality.md index 68f5f4141c..6be2ab45a6 100644 --- a/_overviews/collections-2.13/equality.md +++ b/_overviews/collections-2.13/equality.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 13 +previous-page: performance-characteristics +next-page: views permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/introduction.md b/_overviews/collections-2.13/introduction.md index 7d27aec31f..2b238045da 100644 --- a/_overviews/collections-2.13/introduction.md +++ b/_overviews/collections-2.13/introduction.md @@ -8,6 +8,7 @@ partof: collections-213 overview-name: Collections num: 1 +next-page: overview permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/iterators.md b/_overviews/collections-2.13/iterators.md index d2736f49b6..915e3d1018 100644 --- a/_overviews/collections-2.13/iterators.md +++ b/_overviews/collections-2.13/iterators.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 15 +previous-page: views +next-page: creating-collections-from-scratch permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/maps.md b/_overviews/collections-2.13/maps.md index 9d89489c6f..7097e9e38d 100644 --- a/_overviews/collections-2.13/maps.md +++ b/_overviews/collections-2.13/maps.md @@ -8,8 +8,10 @@ partof: collections-213 overview-name: Collections num: 7 +previous-page: sets +next-page: concrete-immutable-collection-classes -permalink: /overviews/collections2.13/:title.html +permalink: /overviews/collections-2.13/:title.html --- A [Map](http://www.scala-lang.org/api/current/scala/collection/Map.html) is an [Iterable](http://www.scala-lang.org/api/current/scala/collection/Iterable.html) consisting of pairs of keys and values (also named _mappings_ or _associations_). Scala's [Predef](http://www.scala-lang.org/api/current/scala/Predef$.html) object offers an implicit conversion that lets you write `key -> value` as an alternate syntax for the pair `(key, value)`. For instance `Map("x" -> 24, "y" -> 25, "z" -> 26)` means exactly the same as `Map(("x", 24), ("y", 25), ("z", 26))`, but reads better. diff --git a/_overviews/collections-2.13/overview.md b/_overviews/collections-2.13/overview.md index a96995b662..681566cd85 100644 --- a/_overviews/collections-2.13/overview.md +++ b/_overviews/collections-2.13/overview.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 2 +previous-page: introduction +next-page: trait-iterable permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/performance-characteristics.md b/_overviews/collections-2.13/performance-characteristics.md index 9c46cfc8d2..e706b078a1 100644 --- a/_overviews/collections-2.13/performance-characteristics.md +++ b/_overviews/collections-2.13/performance-characteristics.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 12 +previous-page: strings +next-page: equality permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/seqs.md b/_overviews/collections-2.13/seqs.md index 4cd3060b68..1ad5a91c52 100644 --- a/_overviews/collections-2.13/seqs.md +++ b/_overviews/collections-2.13/seqs.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 5 +previous-page: trait-iterable +next-page: sets permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/sets.md b/_overviews/collections-2.13/sets.md index 9189d179e1..37ac00855a 100644 --- a/_overviews/collections-2.13/sets.md +++ b/_overviews/collections-2.13/sets.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 6 +previous-page: seqs +next-page: maps permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/strings.md b/_overviews/collections-2.13/strings.md index 1b84877b51..f869e5dd67 100644 --- a/_overviews/collections-2.13/strings.md +++ b/_overviews/collections-2.13/strings.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 11 +previous-page: arrays +next-page: performance-characteristics permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/trait-iterable.md b/_overviews/collections-2.13/trait-iterable.md index e306f39f16..aedbd5915d 100644 --- a/_overviews/collections-2.13/trait-iterable.md +++ b/_overviews/collections-2.13/trait-iterable.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 4 +previous-page: overview +next-page: seqs permalink: /overviews/collections-2.13/:title.html --- diff --git a/_overviews/collections-2.13/views.md b/_overviews/collections-2.13/views.md index 61ebae3cef..97401e510f 100644 --- a/_overviews/collections-2.13/views.md +++ b/_overviews/collections-2.13/views.md @@ -8,6 +8,8 @@ partof: collections-213 overview-name: Collections num: 14 +previous-page: equality +next-page: iterators permalink: /overviews/collections-2.13/:title.html --- From c56c5bdcf5e6ef1c566e52027acf0e5d82d68b63 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Thu, 18 Jul 2019 11:10:49 +0200 Subject: [PATCH 0599/3075] Add missing URL for seqs.html page --- _data/overviews.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/_data/overviews.yml b/_data/overviews.yml index c84a29131c..bd12fb5844 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -15,6 +15,7 @@ - title: Trait Iterable url: "collections-2.13/trait-iterable.html" - title: The sequence traits Seq, IndexedSeq, and LinearSeq + url: "collections-2.13/seqs.html" - title: Concrete Immutable Collection Classes url: "collections-2.13/concrete-immutable-collection-classes.html" - title: Concrete Mutable Collection Classes From 4fad8b1ed1ad2978910f435145aa04eb4703ffb8 Mon Sep 17 00:00:00 2001 From: exoego Date: Fri, 19 Jul 2019 06:32:12 +0900 Subject: [PATCH 0600/3075] Instruct --help command as manual, sice nightly/docs are removed. --- _overviews/scaladoc/generate.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scaladoc/generate.md b/_overviews/scaladoc/generate.md index 4c26f39a08..31b1b84428 100644 --- a/_overviews/scaladoc/generate.md +++ b/_overviews/scaladoc/generate.md @@ -46,7 +46,7 @@ This will put the HTML in the current directory. This is probably not what you $ scaladoc -d build/ src/main/scala/App.scala -For more information on the `scaladoc` command and what other command-line options it supports, see the [scaladoc man page](https://www.scala-lang.org/files/archive/nightly/docs/manual/html/scaladoc.html). +For more information on the `scaladoc` command and what other command-line options it supports, see the `scaladoc --help`. This command is harder to operate with more complex projects containing both multiple Scala source files and library dependencies. This is why using sbt (see above) is easier and better suited for generating Scaladoc. From ef3c5b183da297ef3dc89ff0e9e2a30d50da66de Mon Sep 17 00:00:00 2001 From: exoego Date: Fri, 19 Jul 2019 07:15:36 +0900 Subject: [PATCH 0601/3075] Escape special characters in string --- _data/compiler-options.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_data/compiler-options.yml b/_data/compiler-options.yml index 429f31b0c7..dc6649d8f1 100644 --- a/_data/compiler-options.yml +++ b/_data/compiler-options.yml @@ -429,7 +429,7 @@ - option: "-Xno-uescape" schema: type: "Boolean" - description: "Disable handling of \u unicode escapes." + description: "Disable handling of \\u unicode escapes." - option: "-Xnojline" schema: type: "Boolean" @@ -812,7 +812,7 @@ type: "String" arg: "path" default: - description: "Write repl-generated classfiles to given output directory (use "" to generate a temporary dir)" + description: "Write repl-generated classfiles to given output directory (use \"\" to generate a temporary dir)" - option: "-Yrepl-sync" schema: type: "Boolean" From c3759bc905de544a1d2586492c346d75d7c784fb Mon Sep 17 00:00:00 2001 From: exoego Date: Fri, 19 Jul 2019 07:15:46 +0900 Subject: [PATCH 0602/3075] Indent choices --- _data/compiler-options.yml | 380 ++++++++++++++++++------------------- 1 file changed, 190 insertions(+), 190 deletions(-) diff --git a/_data/compiler-options.yml b/_data/compiler-options.yml index dc6649d8f1..7f97ccede2 100644 --- a/_data/compiler-options.yml +++ b/_data/compiler-options.yml @@ -79,11 +79,11 @@ arg: "level" default: "vars" choices: - - choice: "none" - - choice: "source" - - choice: "line" - - choice: "vars" - - choice: "notailcalls" + - choice: "none" + - choice: "source" + - choice: "line" + - choice: "vars" + - choice: "notailcalls" description: "Set level of generated debugging info. Choices: (none,source,line,vars,notailcalls), default: vars." - option: "-help" schema: @@ -107,20 +107,20 @@ arg: "feature" multiple: "true" choices: - - choice: "dynamics" - description: "Allow direct or indirect subclasses of scala.Dynamic" - - choice: "postfixOps" - description: "Allow postfix operator notation, such as `1 to 10 toList`" - - choice: "reflectiveCalls" - description: "Allow reflective access to members of structural types" - - choice: "implicitConversions" - description: "Allow definition of implicit functions called views" - - choice: "higherKinds" - description: "Allow higher-kinded types" - - choice: "existentials" - description: "Existential types (besides wildcard types) can be written and inferred" - - choice: "experimental.macros" - description: "Allow macro definition (besides implementation and application)" + - choice: "dynamics" + description: "Allow direct or indirect subclasses of scala.Dynamic" + - choice: "postfixOps" + description: "Allow postfix operator notation, such as `1 to 10 toList`" + - choice: "reflectiveCalls" + description: "Allow reflective access to members of structural types" + - choice: "implicitConversions" + description: "Allow definition of implicit functions called views" + - choice: "higherKinds" + description: "Allow higher-kinded types" + - choice: "existentials" + description: "Existential types (besides wildcard types) can be written and inferred" + - choice: "experimental.macros" + description: "Allow macro definition (besides implementation and application)" description: "Enable or disable language features: `_` for all, `-language:help` to list choices." - option: "-no-specialization" schema: @@ -140,36 +140,36 @@ arg: "optimization" multiple: "true" choices: - - choice: "unreachable-code" - description: "Eliminate unreachable code, exception handlers guarding no instructions, redundant metadata (debug information, line numbers)." - - choice: "simplify-jumps" - description: "Simplify branching instructions, eliminate unnecessary ones." - - choice: "compact-locals" - description: "Eliminate empty slots in the sequence of local variables." - - choice: "copy-propagation" - description: "Eliminate redundant local variables and unused values (including closures). Enables unreachable-code." - - choice: "redundant-casts" - description: "Eliminate redundant casts using a type propagation analysis." - - choice: "box-unbox" - description: "Eliminate box-unbox pairs within the same method (also tuples, xRefs, value class instances). Enables unreachable-code." - - choice: "nullness-tracking" - description: "Track nullness / non-nullness of local variables and apply optimizations." - - choice: "closure-invocations" - description: "Rewrite closure invocations to the implementation method." - - choice: "inline" - description: "Inline method invocations according to -Yopt-inline-heuristics and -opt-inline-from." - - choice: "l:none" - description: "Disable optimizations. Takes precedence: `-opt:l:none,+box-unbox` / `-opt:l:none -opt:box-unbox` don`t enable box-unbox." - - choice: "l:default" - description: "Enable default optimizations: unreachable-code." - - choice: "l:method" - description: "Enable intra-method optimizations: unreachable-code,simplify-jumps,compact-locals,copy-propagation,redundant-casts,box-unbox,nullness-tracking,closure-invocations." - - choice: "l:inline" - description: "Enable cross-method optimizations (note: inlining requires -opt-inline-from): l:method,inline." - - choice: "l:project" - description: "[deprecated, use -opt:l:inline, -opt-inline-from] Enable cross-method optimizations within the current project." - - choice: "l:classpath" - description: "[deprecated, use -opt:l:inline, -opt-inline-from] Enable cross-method optimizations across the entire classpath." + - choice: "unreachable-code" + description: "Eliminate unreachable code, exception handlers guarding no instructions, redundant metadata (debug information, line numbers)." + - choice: "simplify-jumps" + description: "Simplify branching instructions, eliminate unnecessary ones." + - choice: "compact-locals" + description: "Eliminate empty slots in the sequence of local variables." + - choice: "copy-propagation" + description: "Eliminate redundant local variables and unused values (including closures). Enables unreachable-code." + - choice: "redundant-casts" + description: "Eliminate redundant casts using a type propagation analysis." + - choice: "box-unbox" + description: "Eliminate box-unbox pairs within the same method (also tuples, xRefs, value class instances). Enables unreachable-code." + - choice: "nullness-tracking" + description: "Track nullness / non-nullness of local variables and apply optimizations." + - choice: "closure-invocations" + description: "Rewrite closure invocations to the implementation method." + - choice: "inline" + description: "Inline method invocations according to -Yopt-inline-heuristics and -opt-inline-from." + - choice: "l:none" + description: "Disable optimizations. Takes precedence: `-opt:l:none,+box-unbox` / `-opt:l:none -opt:box-unbox` don`t enable box-unbox." + - choice: "l:default" + description: "Enable default optimizations: unreachable-code." + - choice: "l:method" + description: "Enable intra-method optimizations: unreachable-code,simplify-jumps,compact-locals,copy-propagation,redundant-casts,box-unbox,nullness-tracking,closure-invocations." + - choice: "l:inline" + description: "Enable cross-method optimizations (note: inlining requires -opt-inline-from): l:method,inline." + - choice: "l:project" + description: "[deprecated, use -opt:l:inline, -opt-inline-from] Enable cross-method optimizations within the current project." + - choice: "l:classpath" + description: "[deprecated, use -opt:l:inline, -opt-inline-from] Enable cross-method optimizations across the entire classpath." description: "Enable optimizations: `_` for all, `-opt:help` to list choices." - option: "-opt-inline-from" schema: @@ -183,20 +183,20 @@ arg: "warning" multiple: "true" choices: - - choice: "none" - description: "No optimizer warnings." - - choice: "at-inline-failed-summary" - description: "One-line summary if there were @inline method calls that could not be inlined." - - choice: "at-inline-failed" - description: "A detailed warning for each @inline method call that could not be inlined." - - choice: "any-inline-failed" - description: "A detailed warning for every callsite that was chosen for inlining by the heuristics, but could not be inlined." - - choice: "no-inline-mixed" - description: "In mixed compilation, warn at callsites methods defined in java sources (the inlining decision cannot be made without bytecode)." - - choice: "no-inline-missing-bytecode" - description: "Warn if an inlining decision cannot be made because a the bytecode of a class or member cannot be found on the compilation classpath." - - choice: "no-inline-missing-attribute" - description: "Warn if an inlining decision cannot be made because a Scala classfile does not have a ScalaInlineInfo attribute." + - choice: "none" + description: "No optimizer warnings." + - choice: "at-inline-failed-summary" + description: "One-line summary if there were @inline method calls that could not be inlined." + - choice: "at-inline-failed" + description: "A detailed warning for each @inline method call that could not be inlined." + - choice: "any-inline-failed" + description: "A detailed warning for every callsite that was chosen for inlining by the heuristics, but could not be inlined." + - choice: "no-inline-mixed" + description: "In mixed compilation, warn at callsites methods defined in java sources (the inlining decision cannot be made without bytecode)." + - choice: "no-inline-missing-bytecode" + description: "Warn if an inlining decision cannot be made because a the bytecode of a class or member cannot be found on the compilation classpath." + - choice: "no-inline-missing-attribute" + description: "Warn if an inlining decision cannot be made because a Scala classfile does not have a ScalaInlineInfo attribute." description: "Enable optimizer warnings: `_` for all, `-opt-warnings:help` to list choices." - option: "-optimise" schema: @@ -226,10 +226,10 @@ arg: "target" default: "jvm-1.8" choices: - - choice: "jvm-1.5" - - choice: "jvm-1.6" - - choice: "jvm-1.7" - - choice: "jvm-1.8" + - choice: "jvm-1.5" + - choice: "jvm-1.6" + - choice: "jvm-1.7" + - choice: "jvm-1.8" description: "Target platform for object files. All JVM 1.5 - 1.7 targets are deprecated. Choices: (jvm-1.5,jvm-1.6,jvm-1.7,jvm-1.8), default: jvm-1.8." - option: "-toolcp" schema: @@ -313,42 +313,42 @@ arg: "warning" multiple: "true" choices: - - choice: "adapted-args" - description: "Warn if an argument list is modified to match the receiver." - - choice: "nullary-unit" - description: "Warn when nullary methods return Unit." - - choice: "inaccessible" - description: "Warn about inaccessible types in method signatures." - - choice: "nullary-override" - description: "Warn when non-nullary `def f()` overrides nullary `def f`." - - choice: "infer-any" - description: "Warn when a type argument is inferred to be `Any`." - - choice: "missing-interpolator" - description: "A string literal appears to be missing an interpolator id." - - choice: "doc-detached" - description: "A Scaladoc comment appears to be detached from its element." - - choice: "private-shadow" - description: "A private field (or class parameter) shadows a superclass field." - - choice: "type-parameter-shadow" - description: "A local type parameter shadows a type already in scope." - - choice: "poly-implicit-overload" - description: "Parameterized overloaded implicit methods are not visible as view bounds." - - choice: "option-implicit" - description: "Option.apply used implicit view." - - choice: "delayedinit-select" - description: "Selecting member of DelayedInit." - - choice: "by-name-right-associative" - description: "By-name parameter of right associative operator." - - choice: "package-object-classes" - description: "Class or object defined in package object." - - choice: "unsound-match" - description: "Pattern match may not be typesafe." - - choice: "stars-align" - description: "Pattern sequence wildcard must align with sequence component." - - choice: "constant" - description: "Evaluation of a constant arithmetic expression results in an error." - - choice: "unused" - description: "Enable -Ywarn-unused:imports,privates,locals,implicits." + - choice: "adapted-args" + description: "Warn if an argument list is modified to match the receiver." + - choice: "nullary-unit" + description: "Warn when nullary methods return Unit." + - choice: "inaccessible" + description: "Warn about inaccessible types in method signatures." + - choice: "nullary-override" + description: "Warn when non-nullary `def f()` overrides nullary `def f`." + - choice: "infer-any" + description: "Warn when a type argument is inferred to be `Any`." + - choice: "missing-interpolator" + description: "A string literal appears to be missing an interpolator id." + - choice: "doc-detached" + description: "A Scaladoc comment appears to be detached from its element." + - choice: "private-shadow" + description: "A private field (or class parameter) shadows a superclass field." + - choice: "type-parameter-shadow" + description: "A local type parameter shadows a type already in scope." + - choice: "poly-implicit-overload" + description: "Parameterized overloaded implicit methods are not visible as view bounds." + - choice: "option-implicit" + description: "Option.apply used implicit view." + - choice: "delayedinit-select" + description: "Selecting member of DelayedInit." + - choice: "by-name-right-associative" + description: "By-name parameter of right associative operator." + - choice: "package-object-classes" + description: "Class or object defined in package object." + - choice: "unsound-match" + description: "Pattern match may not be typesafe." + - choice: "stars-align" + description: "Pattern sequence wildcard must align with sequence component." + - choice: "constant" + description: "Evaluation of a constant arithmetic expression results in an error." + - choice: "unused" + description: "Enable -Ywarn-unused:imports,privates,locals,implicits." description: "Enable or disable specific warnings: `_` for all, `-Xlint:help` to list choices." - option: "-Xlog-free-terms" schema: @@ -411,12 +411,12 @@ arg: "mode" default: "true" choices: - - choice: "true" - description: "Always generate mixin forwarders." - - choice: "junit" - description: "Generate mixin forwarders for JUnit-annotated methods (JUnit 4 does not support default methods)." - - choice: "false" - description: "Only generate mixin forwarders required for program correctness." + - choice: "true" + description: "Always generate mixin forwarders." + - choice: "junit" + description: "Generate mixin forwarders for JUnit-annotated methods (JUnit 4 does not support default methods)." + - choice: "false" + description: "Only generate mixin forwarders required for program correctness." description: "Generate forwarder methods in classes inhering concrete methods from traits. Default: `true`, `help` to list choices." - option: "-Xno-forwarders" schema: @@ -541,8 +541,8 @@ arg: "property" multiple: "true" choices: - - choice: "coalescing" - description: "Convert PCData to Text and coalesce sibling nodes" + - choice: "coalescing" + description: "Convert PCData to Text and coalesce sibling nodes" description: "Configure XML parsing.: `_` for all, `-Xxml:help` to list choices." - category: "Verbose Settings" description: @@ -579,10 +579,10 @@ arg: "policy" default: "none" choices: - - choice: "none" - description: "Don't cache class loader" - - choice: "last-modified" - description: "Cache class loader, using file last-modified time to invalidate" + - choice: "none" + description: "Don't cache class loader" + - choice: "last-modified" + description: "Cache class loader, using file last-modified time to invalidate" description: "Policy for caching class loaders for macros that are dynamically loaded. Default: `none`, `help` to list choices." - option: "-Ycache-plugin-class-loader" schema: @@ -590,10 +590,10 @@ arg: "policy" default: "none" choices: - - choice: "none" - description: "Don't cache class loader" - - choice: "last-modified" - description: "Cache class loader, using file last-modified time to invalidate" + - choice: "none" + description: "Don't cache class loader" + - choice: "last-modified" + description: "Cache class loader, using file last-modified time to invalidate" description: "Policy for caching class loaders for compiler plugins that are dynamically loaded. Default: `none`, `help` to list choices." - option: "-Ycheck" schema: @@ -614,8 +614,8 @@ arg: "strategy" default: "method" choices: - - choice: "inline" - - choice: "method" + - choice: "inline" + - choice: "method" description: "Strategy used for translating lambdas into JVM code. Choices: (inline,method), default: method." - option: "-YdisableFlatCpCaching" schema: @@ -683,9 +683,9 @@ arg: "policy" default: "normal" choices: - - choice: "normal" - - choice: "none" - - choice: "discard" + - choice: "normal" + - choice: "none" + - choice: "discard" description: "Control expansion of macros, useful for scaladoc and presentation compiler. Choices: (normal,none,discard), default: normal." - option: "-Ymacro-no-expand" schema: @@ -717,9 +717,9 @@ arg: "strategy" default: "default" choices: - - choice: "at-inline-annotated" - - choice: "everything" - - choice: "default" + - choice: "at-inline-annotated" + - choice: "everything" + - choice: "default" description: "Set the heuristics for inlining decisions. Choices: (at-inline-annotated,everything,default), default: default." - option: "-Yopt-log-inline" schema: @@ -823,9 +823,9 @@ arg: "strategy" default: "error" choices: - - choice: "package" - - choice: "object" - - choice: "error" + - choice: "package" + - choice: "object" + - choice: "error" description: "Resolve term conflicts. Choices: (package,object,error), default: error." - option: "-Yshow" schema: @@ -923,14 +923,14 @@ arg: "mode" default: "before" choices: - - choice: "none" - description: "Do not inspect expansions or their original trees when generating unused symbol warnings." - - choice: "before" - description: "Only inspect unexpanded user-written code for unused symbols." - - choice: "after" - description: "Only inspect expanded trees when generating unused symbol warnings." - - choice: "both" - description: "Inspect both user-written code and expanded trees when generating unused symbol warnings." + - choice: "none" + description: "Do not inspect expansions or their original trees when generating unused symbol warnings." + - choice: "before" + description: "Only inspect unexpanded user-written code for unused symbols." + - choice: "after" + description: "Only inspect expanded trees when generating unused symbol warnings." + - choice: "both" + description: "Inspect both user-written code and expanded trees when generating unused symbol warnings." description: "Enable lint warnings on macro expansions. Default: `before`, `help` to list choices." - option: "-Ywarn-nullary-override" schema: @@ -954,22 +954,22 @@ arg: "warning" multiple: "true" choices: - - choice: "imports" - description: "Warn if an import selector is not referenced." - - choice: "patvars" - description: "Warn if a variable bound in a pattern is unused." - - choice: "privates" - description: "Warn if a private member is unused." - - choice: "locals" - description: "Warn if a local definition is unused." - - choice: "explicits" - description: "Warn if an explicit parameter is unused." - - choice: "implicits" - description: "Warn if an implicit parameter is unused." - - choice: "params" - description: "Enable -Ywarn-unused:explicits,implicits." - - choice: "linted" - description: "-Xlint:unused." + - choice: "imports" + description: "Warn if an import selector is not referenced." + - choice: "patvars" + description: "Warn if a variable bound in a pattern is unused." + - choice: "privates" + description: "Warn if a private member is unused." + - choice: "locals" + description: "Warn if a local definition is unused." + - choice: "explicits" + description: "Warn if an explicit parameter is unused." + - choice: "implicits" + description: "Warn if an implicit parameter is unused." + - choice: "params" + description: "Enable -Ywarn-unused:explicits,implicits." + - choice: "linted" + description: "-Xlint:unused." description: "Enable or disable specific `unused` warnings: `_` for all, `-Ywarn-unused:help` to list choices." - option: "-Ywarn-unused-import" schema: @@ -988,42 +988,42 @@ arg: "warning" multiple: "true" choices: - - choice: "adapted-args" - description: "Warn if an argument list is modified to match the receiver." - - choice: "nullary-unit" - description: "Warn when nullary methods return Unit." - - choice: "inaccessible" - description: "Warn about inaccessible types in method signatures." - - choice: "nullary-override" - description: "Warn when non-nullary `def f()` overrides nullary `def f`." - - choice: "infer-any" - description: "Warn when a type argument is inferred to be `Any`." - - choice: "missing-interpolator" - description: "A string literal appears to be missing an interpolator id." - - choice: "doc-detached" - description: "A Scaladoc comment appears to be detached from its element." - - choice: "private-shadow" - description: "A private field (or class parameter) shadows a superclass field." - - choice: "type-parameter-shadow" - description: "A local type parameter shadows a type already in scope." - - choice: "poly-implicit-overload" - description: "Parameterized overloaded implicit methods are not visible as view bounds." - - choice: "option-implicit" - description: "Option.apply used implicit view." - - choice: "delayedinit-select" - description: "Selecting member of DelayedInit." - - choice: "by-name-right-associative" - description: "By-name parameter of right associative operator." - - choice: "package-object-classes" - description: "Class or object defined in package object." - - choice: "unsound-match" - description: "Pattern match may not be typesafe." - - choice: "stars-align" - description: "Pattern sequence wildcard must align with sequence component." - - choice: "constant" - description: "Evaluation of a constant arithmetic expression results in an error." - - choice: "unused" - description: "Enable -Ywarn-unused:imports,privates,locals,implicits." + - choice: "adapted-args" + description: "Warn if an argument list is modified to match the receiver." + - choice: "nullary-unit" + description: "Warn when nullary methods return Unit." + - choice: "inaccessible" + description: "Warn about inaccessible types in method signatures." + - choice: "nullary-override" + description: "Warn when non-nullary `def f()` overrides nullary `def f`." + - choice: "infer-any" + description: "Warn when a type argument is inferred to be `Any`." + - choice: "missing-interpolator" + description: "A string literal appears to be missing an interpolator id." + - choice: "doc-detached" + description: "A Scaladoc comment appears to be detached from its element." + - choice: "private-shadow" + description: "A private field (or class parameter) shadows a superclass field." + - choice: "type-parameter-shadow" + description: "A local type parameter shadows a type already in scope." + - choice: "poly-implicit-overload" + description: "Parameterized overloaded implicit methods are not visible as view bounds." + - choice: "option-implicit" + description: "Option.apply used implicit view." + - choice: "delayedinit-select" + description: "Selecting member of DelayedInit." + - choice: "by-name-right-associative" + description: "By-name parameter of right associative operator." + - choice: "package-object-classes" + description: "Class or object defined in package object." + - choice: "unsound-match" + description: "Pattern match may not be typesafe." + - choice: "stars-align" + description: "Pattern sequence wildcard must align with sequence component." + - choice: "constant" + description: "Evaluation of a constant arithmetic expression results in an error." + - choice: "unused" + description: "Enable -Ywarn-unused:imports,privates,locals,implicits." description: "Enable or disable specific warnings: `_` for all, `-Xlint:help` to list choices." - category: "IDE-specific Settings" description: From 104599e56657ee833957049f8298e7ebe005f658 Mon Sep 17 00:00:00 2001 From: exoego Date: Mon, 15 Jul 2019 19:36:11 +0900 Subject: [PATCH 0603/3075] Add language dropdown to masthead-documentation layout --- _includes/masthead-documentation.html | 28 +++++++++++++++++++++++++++ _sass/components/dropdown.scss | 11 +++++++++++ 2 files changed, 39 insertions(+) diff --git a/_includes/masthead-documentation.html b/_includes/masthead-documentation.html index a15b70e81e..0411d88942 100644 --- a/_includes/masthead-documentation.html +++ b/_includes/masthead-documentation.html @@ -1,6 +1,34 @@
+ +
+
+ Language +
    +
    +
    + + +
    {% for section in page.sections %}
    diff --git a/_sass/components/dropdown.scss b/_sass/components/dropdown.scss index 30f41cb713..6cf33e73ca 100644 --- a/_sass/components/dropdown.scss +++ b/_sass/components/dropdown.scss @@ -18,6 +18,11 @@ // } float: right; + .table-of-content & { + margin-top: 0; + margin-right: 0; + } + .wrapper-dropdown { padding: 8px 18px 8px 40px; appearance: none; @@ -25,6 +30,12 @@ border-radius: $border-radius-base; box-sizing: border-box; + .table-of-content & { + border: 1px solid rgba(128, 128, 128, 0.5); + } + .table-of-content &:focus { + } + &:focus { outline: none; background: rgba(#fff, 0.9); From 2c282bb67f99d501c3a9bf3398d57357577705b4 Mon Sep 17 00:00:00 2001 From: exoego Date: Tue, 16 Jul 2019 13:34:47 +0900 Subject: [PATCH 0604/3075] Add Japanese translations of root page (index.md) --- _ja/index.md | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++ index.md | 7 +++--- 2 files changed, 74 insertions(+), 3 deletions(-) create mode 100644 _ja/index.md diff --git a/_ja/index.md b/_ja/index.md new file mode 100644 index 0000000000..12a737d4c1 --- /dev/null +++ b/_ja/index.md @@ -0,0 +1,70 @@ +--- +layout: inner-page-documentation +title: ドキュメント +language: ja +partof: documentation +discourse: true + +# Content masthead links +sections: + + - title: "最初のステップ" + links: + - title: "入門" + description: "あなたのコンピューターに Scala をインストールして、Scala コードを書きはじめよう！（英語のみ）" + icon: "fa fa-rocket" + link: /getting-started.html + - title: "Scala ツアー" + description: "コア言語機能をひと口大で紹介" + icon: "fa fa-flag" + link: /ja/tour/tour-of-scala.html + - title: "Java プログラマーのための Scala" + description: "Java 経験者向けのすばやい紹介" + icon: "fa fa-coffee" + link: /ja/tutorials/scala-for-java-programmers.html + more-resources: + - title: オンラインリソース（英語のみ） + url: /learn.html + - title: 書籍（英語のみ） + url: /books.html + + - title: "リピーター向け" + links: + - title: "API" + description: "Scala の全バージョンの API ドキュメント（英語のみ）" + icon: "fa fa-file-text" + link: /api/all.html + - title: "Overviews" + description: "Scala の多くの機能を網羅する詳細ドキュメント" + icon: "fa fa-database" + # TODO: 日本語訳はあるがリニューアル前のもの。要修正 + link: /ja/overviews/index.html + - title: "スタイルガイド" + description: "Scala らしいコードを書くための詳細なガイド（英語のみ）" + icon: "fa fa-bookmark" + link: /style/index.html + - title: "チートシート" + description: "Scala 構文の基礎を網羅する便利なチートシート" + icon: "fa fa-list" + link: /ja/cheatsheets/index.html + - title: "Scala よくある質問" + description: "Scala 言語機能についてよく聞かれる質問＆回答集（英語のみ）" + icon: "fa fa-question-circle" + link: /tutorials/FAQ/index.html + - title: "言語仕様" + description: "Scala の形式的言語仕様（英語のみ）" + icon: "fa fa-book" + link: http://scala-lang.org/files/archive/spec/2.12/ + + - title: "Scala の進化" + links: + - title: "SIP" + description: "Scala Improvement Process（Scala 改善プロセス）。言語とコンパイラの進化（英語のみ）" + icon: "fa fa-cogs" + link: sips/index.html + - title: "SPP" + description: "Scala Platform Process（Scala プラットフォームプロセス）。コミュニティ主導型のライブラリの進化（英語のみ）" + icon: "fa fa-users" + link: https://platform.scala-lang.org + +--- diff --git a/index.md b/index.md index 23ed9edcd5..7a98cad905 100644 --- a/index.md +++ b/index.md @@ -1,9 +1,10 @@ --- layout: inner-page-documentation title: Documentation -#redirect_from: -# - /what-is-scala/ -#includeTOC: true +languages: [ja] +namespace: root +partof: documentation +discourse: true # Content masthead links sections: From b0f8ffb199aa437746570840c125d6136913d4ce Mon Sep 17 00:00:00 2001 From: exoego Date: Tue, 16 Jul 2019 15:43:11 +0900 Subject: [PATCH 0605/3075] Fix missing directory separator. --- _ja/index.md | 2 +- index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_ja/index.md b/_ja/index.md index 12a737d4c1..4f22939227 100644 --- a/_ja/index.md +++ b/_ja/index.md @@ -61,7 +61,7 @@ sections: - title: "SIP" description: "Scala Improvement Process（Scala 改善プロセス）。言語とコンパイラの進化（英語のみ）" icon: "fa fa-cogs" - link: sips/index.html + link: /sips/index.html - title: "SPP" description: "Scala Platform Process（Scala プラットフォームプロセス）。コミュニティ主導型のライブラリの進化（英語のみ）" icon: "fa fa-users" diff --git a/index.md b/index.md index 7a98cad905..fb6d93db53 100644 --- a/index.md +++ b/index.md @@ -61,7 +61,7 @@ sections: - title: "SIPs" description: "The Scala Improvement Process. Language & compiler evolution." icon: "fa fa-cogs" - link: sips/index.html + link: /sips/index.html - title: "SPP" description: "The Scala Platform Process. Community-driven library evolution." icon: "fa fa-users" From a4eddf115b7e1560c0af3ca27dfdb053812dd112 Mon Sep 17 00:00:00 2001 From: Valentin Willscher Date: Fri, 19 Jul 2019 17:59:36 +0900 Subject: [PATCH 0606/3075] Naming convention exception generating/deriving formats --- _style/naming-conventions.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/_style/naming-conventions.md b/_style/naming-conventions.md index f97f3328fe..c357c6e65f 100644 --- a/_style/naming-conventions.md +++ b/_style/naming-conventions.md @@ -40,6 +40,12 @@ Classes should be named in upper camel case: This mimics the Java naming convention for classes. +Sometimes traits and classes as well as their members are used to describe +formats, documentation or protocols and generate/derive them. +In these cases it is desirable to be close to a 1:1 relation to the output format +and the naming conventions don't apply. In this case, they should only be used +for that specific purpose and not throughout the rest of the code. + ## Objects Object names are like class names (upper camel case). From e6f122e9d42f065101d4166b3b59745240737ddc Mon Sep 17 00:00:00 2001 From: Daniel Capo Sobral Date: Fri, 19 Jul 2019 12:38:12 -0600 Subject: [PATCH 0607/3075] Update for Scala 2.13 --- _overviews/macros/annotations.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_overviews/macros/annotations.md b/_overviews/macros/annotations.md index d7b70d9258..dfe7a57abb 100644 --- a/_overviews/macros/annotations.md +++ b/_overviews/macros/annotations.md @@ -16,11 +16,11 @@ permalink: /overviews/macros/:title.html **Eugene Burmako** -Macro annotations are only available with the macro paradise plugin (in Scala 2.10.x, 2.11.x and 2.12.x alike). -Their inclusion in official Scala might happen in Scala 2.13, but there is no certainty about it yet. -Follow the instructions at the ["Macro Paradise"](paradise.html) page to download and use our compiler plugin. +Macro annotations are available in Scala 2.13, but only with the macro paradise plugin from Scala 2.10.x to Scala 2.12.x. +Follow the instructions at the ["Macro Paradise"](paradise.html) page to download and use our compiler plugin if using +those older Scala versions. -Note that macro paradise is needed both to compile and to expand macro annotations, +Note that the macro paradise plugin is needed both to compile and to expand macro annotations, which means that your users will have to also add macro paradise to their builds in order to use your macro annotations. However, after macro annotations expand, the resulting code will no longer have any references to macro paradise and won't require its presence at compile-time or at runtime. From 29fa1544602a7462cfa535db964da8da2f13df15 Mon Sep 17 00:00:00 2001 From: Daniel Capo Sobral Date: Fri, 19 Jul 2019 12:40:40 -0600 Subject: [PATCH 0608/3075] Mention flag for 2.13 --- _overviews/macros/annotations.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_overviews/macros/annotations.md b/_overviews/macros/annotations.md index dfe7a57abb..154f341022 100644 --- a/_overviews/macros/annotations.md +++ b/_overviews/macros/annotations.md @@ -16,7 +16,8 @@ permalink: /overviews/macros/:title.html **Eugene Burmako** -Macro annotations are available in Scala 2.13, but only with the macro paradise plugin from Scala 2.10.x to Scala 2.12.x. +Macro annotations are available in Scala 2.13 with the `-Ymacro-annotations` flag, but only with the macro paradise +plugin from Scala 2.10.x to Scala 2.12.x. Follow the instructions at the ["Macro Paradise"](paradise.html) page to download and use our compiler plugin if using those older Scala versions. From f8699afe3297a6a9663405d937415c69114cab2c Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Fri, 14 Jun 2019 11:38:15 -0700 Subject: [PATCH 0609/3075] First update to 2.13 Still needs addition of previous material. --- _data/compiler-options.yml | 735 ++++++++++++++++++++++--------------- 1 file changed, 439 insertions(+), 296 deletions(-) diff --git a/_data/compiler-options.yml b/_data/compiler-options.yml index 7f97ccede2..fb67497392 100644 --- a/_data/compiler-options.yml +++ b/_data/compiler-options.yml @@ -15,6 +15,20 @@ arg: "plugin:opt" multiple: "true" description: "Pass an option to a plugin" + - option: "-V" + schema: + type: "Boolean" + description: "Print a synopsis of verbose options." + - option: "-W" + schema: + type: "Boolean" + description: "Print a synopsis of warning options." + - option: "-Werror" + schema: + type: "Boolean" + description: "Fail the compilation if there are any warnings." + abbreviations: + - "-Xfatal-warnings" - option: "-X" schema: type: "Boolean" @@ -29,6 +43,8 @@ arg: "path" default: description: "Override location of bootstrap class files." + abbreviations: + - "--boot-class-path" - option: "-classpath" schema: type: "Path" @@ -37,6 +53,7 @@ description: "Specify where to find user class files." abbreviations: - "-cp" + - "--class-path" - option: "-d" schema: type: "String" @@ -49,30 +66,42 @@ arg: "file" default: ".scala_dependencies" description: "Set dependency tracking file." + abbreviations: + - "--dependency-file" - option: "-deprecation" schema: type: "Boolean" description: "Emit warning and location for usages of deprecated APIs." + abbreviations: + - "--deprecation" - option: "-encoding" schema: type: "String" arg: "encoding" default: "UTF-8" description: "Specify character encoding used by source files." + abbreviations: + - "--encoding" - option: "-explaintypes" schema: type: "Boolean" description: "Explain type errors in more detail." + abbreviations: + - "--explain-types" - option: "-extdirs" schema: type: "Path" arg: "path" default: description: "Override location of installed extensions." + abbreviations: + - "--extension-directories" - option: "-feature" schema: type: "Boolean" description: "Emit warning and location for usages of features that should be imported explicitly." + abbreviations: + - "--feature" - option: "-g" schema: type: "Choice" @@ -84,23 +113,29 @@ - choice: "line" - choice: "vars" - choice: "notailcalls" - description: "Set level of generated debugging info. Choices: (none,source,line,vars,notailcalls), default: vars." + description: "Set level of generated debugging info. (none,source,line,[vars],notailcalls)" - option: "-help" schema: type: "Boolean" description: "Print a synopsis of standard options" + abbreviations: + - "--help" - option: "-javabootclasspath" schema: type: "Path" arg: "path" - default: "/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/resources.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/rt.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/sunrsasign.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/jsse.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/jce.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/charsets.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/jfr.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/classes" + default: "" description: "Override java boot classpath." + abbreviations: + - "--java-boot-class-path" - option: "-javaextdirs" schema: type: "Path" arg: "path" - default: "/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext:/usr/java/packages/lib/ext" + default: description: "Override java extdirs classpath." + abbreviations: + - "--java-extension-directories" - option: "-language" schema: type: "Choice" @@ -109,31 +144,39 @@ choices: - choice: "dynamics" description: "Allow direct or indirect subclasses of scala.Dynamic" + - choice: "existentials" + description: "Existential types (besides wildcard types) can be written and inferred" + - choice: "higherKinds" + description: "Allow higher-kinded types" + - choice: "implicitConversions" + description: "Allow definition of implicit functions called views" - choice: "postfixOps" - description: "Allow postfix operator notation, such as `1 to 10 toList`" + description: "Allow postfix operator notation, such as `1 to 10 toList` (not recommended)" - choice: "reflectiveCalls" description: "Allow reflective access to members of structural types" - - choice: "implicitConversions" - description: "Allow definition of implicit functions called views" - - choice: "higherKinds" - description: "Allow higher-kinded types" - - choice: "existentials" - description: "Existential types (besides wildcard types) can be written and inferred" - choice: "experimental.macros" description: "Allow macro definition (besides implementation and application)" - description: "Enable or disable language features: `_` for all, `-language:help` to list choices." + description: "Enable or disable language features" + abbreviations: + - "--language" - option: "-no-specialization" schema: type: "Boolean" description: "Ignore @specialize annotations." + abbreviations: + - "--no-specialization" - option: "-nobootcp" schema: type: "Boolean" description: "Do not use the boot classpath for the scala jars." + abbreviations: + - "--no-boot-class-path" - option: "-nowarn" schema: type: "Boolean" description: "Generate no warnings." + abbreviations: + - "--no-warnings" - option: "-opt" schema: type: "Choice" @@ -156,6 +199,12 @@ description: "Track nullness / non-nullness of local variables and apply optimizations." - choice: "closure-invocations" description: "Rewrite closure invocations to the implementation method." + - choice: "allow-skip-core-module-init" + description: "Allow eliminating unused module loads for core modules of the standard library (e.g., Predef, ClassTag)." + - choice: "assume-modules-non-null" + description: "Assume loading a module never results in null (happens if the module is accessed in its super constructor)." + - choice: "allow-skip-class-loading" + description: "Allow optimizations that can skip or delay class loading." - choice: "inline" description: "Inline method invocations according to -Yopt-inline-heuristics and -opt-inline-from." - choice: "l:none" @@ -163,14 +212,10 @@ - choice: "l:default" description: "Enable default optimizations: unreachable-code." - choice: "l:method" - description: "Enable intra-method optimizations: unreachable-code,simplify-jumps,compact-locals,copy-propagation,redundant-casts,box-unbox,nullness-tracking,closure-invocations." + description: "Enable intra-method optimizations: unreachable-code,simplify-jumps,compact-locals,copy-propagation,redundant-casts,box-unbox,nullness-tracking,closure-invocations,allow-skip-core-module-init,assume-modules-non-null,allow-skip-class-loading." - choice: "l:inline" description: "Enable cross-method optimizations (note: inlining requires -opt-inline-from): l:method,inline." - - choice: "l:project" - description: "[deprecated, use -opt:l:inline, -opt-inline-from] Enable cross-method optimizations within the current project." - - choice: "l:classpath" - description: "[deprecated, use -opt:l:inline, -opt-inline-from] Enable cross-method optimizations across the entire classpath." - description: "Enable optimizations: `_` for all, `-opt:help` to list choices." + description: "Enable optimizations" - option: "-opt-inline-from" schema: type: "String" @@ -197,70 +242,93 @@ description: "Warn if an inlining decision cannot be made because a the bytecode of a class or member cannot be found on the compilation classpath." - choice: "no-inline-missing-attribute" description: "Warn if an inlining decision cannot be made because a Scala classfile does not have a ScalaInlineInfo attribute." - description: "Enable optimizer warnings: `_` for all, `-opt-warnings:help` to list choices." - - option: "-optimise" + description: "Enable optimizer warnings" + - option: "-optimize" schema: type: "Boolean" - description: "Compiler flag for the optimizer in Scala 2.11" + description: "Enables optimizations." abbreviations: - - "-optimize" + - "-optimise" - option: "-print" schema: type: "Boolean" description: "Print program with Scala-specific features removed." + abbreviations: + - "--print" - option: "-release" schema: type: "String" arg: "release" default: description: "Compile for a specific version of the Java platform. Supported targets: 6, 7, 8, 9" + abbreviations: + - "--release" - option: "-sourcepath" schema: type: "Path" arg: "path" default: description: "Specify location(s) of source files." + abbreviations: + - "--source-path" - option: "-target" schema: type: "Choice" arg: "target" - default: "jvm-1.8" + default: "8" choices: - - choice: "jvm-1.5" - - choice: "jvm-1.6" - - choice: "jvm-1.7" - - choice: "jvm-1.8" - description: "Target platform for object files. All JVM 1.5 - 1.7 targets are deprecated. Choices: (jvm-1.5,jvm-1.6,jvm-1.7,jvm-1.8), default: jvm-1.8." + - choice: "8" + - choice: "9" + - choice: "10" + - choice: "11" + - choice: "12" + description: "Target platform for object files. ([8],9,10,11,12)" + abbreviations: + - "--target" - option: "-toolcp" schema: type: "Path" arg: "path" default: description: "Add to the runner classpath." + abbreviations: + - "--tool-class-path" - option: "-unchecked" schema: type: "Boolean" description: "Enable additional warnings where generated code depends on assumptions." + abbreviations: + - "--unchecked" - option: "-uniqid" schema: type: "Boolean" description: "Uniquely tag all identifiers in debugging output." + abbreviations: + - "--unique-id" - option: "-usejavacp" schema: type: "Boolean" description: "Utilize the java.class.path in classpath resolution." + abbreviations: + - "--use-java-class-path" - option: "-usemanifestcp" schema: type: "Boolean" description: "Utilize the manifest in classpath resolution." + abbreviations: + - "--use-manifest-class-path" - option: "-verbose" schema: type: "Boolean" description: "Output messages about what the compiler is doing." + abbreviations: + - "--verbose" - option: "-version" schema: type: "Boolean" description: "Print product version and exit." + abbreviations: + - "--version" - option: "@" schema: type: "Boolean" @@ -288,19 +356,11 @@ - option: "-Xexperimental" schema: type: "Boolean" - description: "Enable experimental extensions." - - option: "-Xfatal-warnings" - schema: - type: "Boolean" - description: "Fail the compilation if there are any warnings." - - option: "-Xfull-lubs" - schema: - type: "Boolean" - description: "Retains pre 2.10 behavior of less aggressive truncation of least upper bounds." + description: "Former graveyard for language-forking extensions." - option: "-Xfuture" schema: type: "Boolean" - description: "Turn on future language features." + description: "Replaced by -Xsource." - option: "-Xgenerate-phase-graph" schema: type: "String" @@ -337,39 +397,29 @@ description: "Option.apply used implicit view." - choice: "delayedinit-select" description: "Selecting member of DelayedInit." - - choice: "by-name-right-associative" - description: "By-name parameter of right associative operator." - choice: "package-object-classes" description: "Class or object defined in package object." - - choice: "unsound-match" - description: "Pattern match may not be typesafe." - choice: "stars-align" description: "Pattern sequence wildcard must align with sequence component." - choice: "constant" description: "Evaluation of a constant arithmetic expression results in an error." - choice: "unused" - description: "Enable -Ywarn-unused:imports,privates,locals,implicits." - description: "Enable or disable specific warnings: `_` for all, `-Xlint:help` to list choices." - - option: "-Xlog-free-terms" - schema: - type: "Boolean" - description: "Print a message when reification creates a free term." - - option: "-Xlog-free-types" - schema: - type: "Boolean" - description: "Print a message when reification resorts to generating a free type." - - option: "-Xlog-implicit-conversions" - schema: - type: "Boolean" - description: "Print a message whenever an implicit conversion is inserted." - - option: "-Xlog-implicits" - schema: - type: "Boolean" - description: "Show more detail on why some implicits are not applicable." - - option: "-Xlog-reflective-calls" - schema: - type: "Boolean" - description: "Print a message when a reflective method call is generated" + description: "Enable -Wunused:imports,privates,locals,implicits." + - choice: "nonlocal-return" + description: "A return statement used an exception for flow control." + - choice: "implicit-not-found" + description: "Check @implicitNotFound and @implicitAmbiguous messages." + - choice: "serial" + description: "@SerialVersionUID on traits and non-serializable classes." + - choice: "valpattern" + description: "Enable pattern checks in val definitions." + - choice: "eta-zero" + description: "Warn on eta-expansion (rather than auto-application) of zero-ary method." + - choice: "eta-sam" + description: "Warn on eta-expansion to meet a Java-defined functional interface that is not explicitly annotated with @FunctionalInterface." + - choice: "deprecation" + description: "Enable linted deprecations." + description: "Enable recommended warnings" - option: "-Xmacro-settings" schema: type: "String" @@ -382,13 +432,6 @@ arg: "path" default: description: "Class for manifest's Main-Class entry (only useful with -d jar)" - - option: "-Xmax-classfile-name" - schema: - type: "Int" - default: "255" - min: "72" - max: "255" - description: "Maximum filename length for generated classes" - option: "-Xmaxerrs" schema: type: "Int" @@ -460,25 +503,8 @@ schema: type: "String" arg: "path" - default: "misc/scala-devel/plugins" + default: "" description: "Path to search for plugin archives." - - option: "-Xprint" - schema: - type: "Phases" - default: - description: "Print out program after phases" - - option: "-Xprint-args" - schema: - type: "Boolean" - description: "Print all compiler arguments and exit." - - option: "-Xprint-pos" - schema: - type: "Boolean" - description: "Print tree positions, as offsets." - - option: "-Xprint-types" - schema: - type: "Boolean" - description: "Print tree types (debugging option)." - option: "-Xprompt" schema: type: "Boolean" @@ -499,27 +525,11 @@ arg: "object" default: description: "Treat the source file as a script and wrap it in a main method." - - option: "-Xshow-class" - schema: - type: "String" - arg: "class" - default: - description: "Show internal representation of class." - - option: "-Xshow-object" - schema: - type: "String" - arg: "object" - default: - description: "Show internal representation of object." - - option: "-Xshow-phases" - schema: - type: "Boolean" - description: "Print a synopsis of compiler phases." - option: "-Xsource" schema: type: "ScalaVersion" arg: "version" - default: "2.12.0" + default: "2.13.0" description: "Treat compiler input as Scala source for the specified version, see scala/bug#8126." - option: "-Xsource-reader" schema: @@ -527,10 +537,6 @@ arg: "classname" default: description: "Specify a custom method for reading source files." - - option: "-Xstrict-inference" - schema: - type: "Boolean" - description: "Don't infer known-unsound types" - option: "-Xverify" schema: type: "Boolean" @@ -543,10 +549,237 @@ choices: - choice: "coalescing" description: "Convert PCData to Text and coalesce sibling nodes" - description: "Configure XML parsing.: `_` for all, `-Xxml:help` to list choices." + description: "Configure XML parsing." - category: "Verbose Settings" description: options: + - option: "-Vbrowse" + schema: + type: "Phases" + default: + description: "Browse the abstract syntax tree after phases" + abbreviations: + - "-Ybrowse" + - option: "-Vclasspath" + schema: + type: "Boolean" + description: "Output information about what classpath is being applied." + abbreviations: + - "-Ylog-classpath" + - option: "-Vdebug" + schema: + type: "Boolean" + description: "Increase the quantity of debugging output." + abbreviations: + - "-Ydebug" + - option: "-Vdoc" + schema: + type: "Boolean" + description: "Trace scaladoc activity." + abbreviations: + - "-Ydoc-debug" + - option: "-Vfree-terms" + schema: + type: "Boolean" + description: "Print a message when reification creates a free term." + abbreviations: + - "-Xlog-free-terms" + - option: "-Vfree-types" + schema: + type: "Boolean" + description: "Print a message when reification resorts to generating a free type." + abbreviations: + - "-Xlog-free-types" + - option: "-Vhot-statistics" + schema: + type: "Boolean" + description: "Enable `-Vstatistics` to also print hot statistics." + abbreviations: + - "-Yhot-statistics" + - option: "-Vide" + schema: + type: "Boolean" + description: "Generate, validate and output trees using the interactive compiler." + abbreviations: + - "-Yide-debug" + - option: "-Vimplicit-conversions" + schema: + type: "Boolean" + description: "Print a message whenever an implicit conversion is inserted." + abbreviations: + - "-Xlog-implicit-conversions" + - option: "-Vimplicits" + schema: + type: "Boolean" + description: "Show more detail on why some implicits are not applicable." + abbreviations: + - "-Xlog-implicits" + - option: "-Vinline" + schema: + type: "String" + arg: "package/Class.method" + default: + description: "Print a summary of inliner activity; `_` to print all, prefix match to select." + abbreviations: + - "-Yopt-log-inline" + - option: "-Vissue" + schema: + type: "Boolean" + description: "Print stack traces when a context issues an error." + abbreviations: + - "-Yissue-debug" + - option: "-Vlog" + schema: + type: "Phases" + default: + description: "Log operations during phases" + abbreviations: + - "-Ylog" + - option: "-Vmacro" + schema: + type: "Boolean" + description: "Trace macro activities: compilation, generation of synthetics, classloading, expansion, exceptions." + abbreviations: + - "-Ymacro-debug-verbose" + - option: "-Vmacro-lite" + schema: + type: "Boolean" + description: "Trace macro activities with less output." + abbreviations: + - "-Ymacro-debug-lite" + - option: "-Vopt" + schema: + type: "String" + arg: "package/Class.method" + default: + description: "Trace the optimizer progress for methods; `_` to print all, prefix match to select." + abbreviations: + - "-Yopt-trace" + - option: "-Vpatmat" + schema: + type: "Boolean" + description: "Trace pattern matching translation." + abbreviations: + - "-Ypatmat-debug" + - option: "-Vphases" + schema: + type: "Boolean" + description: "Print a synopsis of compiler phases." + abbreviations: + - "-Xshow-phases" + - option: "-Vpos" + schema: + type: "Boolean" + description: "Trace position validation." + abbreviations: + - "-Ypos-debug" + - option: "-Vprint" + schema: + type: "Phases" + default: + description: "Print out program after phases" + abbreviations: + - "-Xprint" + - option: "-Vprint-args" + schema: + type: "String" + arg: "file" + default: "-" + description: "Print all compiler arguments to the specified location. Use - to echo to the reporter." + abbreviations: + - "-Xprint-args" + - option: "-Vprint-pos" + schema: + type: "Boolean" + description: "Print tree positions, as offsets." + abbreviations: + - "-Xprint-pos" + - option: "-Vprint-types" + schema: + type: "Boolean" + description: "Print tree types (debugging option)." + abbreviations: + - "-Xprint-types" + - option: "-Vquasiquote" + schema: + type: "Boolean" + description: "Trace quasiquotations." + abbreviations: + - "-Yquasiquote-debug" + - option: "-Vreflective-calls" + schema: + type: "Boolean" + description: "Print a message when a reflective method call is generated" + abbreviations: + - "-Xlog-reflective-calls" + - option: "-Vreify" + schema: + type: "Boolean" + description: "Trace reification." + abbreviations: + - "-Yreify-debug" + - option: "-Vshow" + schema: + type: "Phases" + default: + description: "(Requires -Xshow-class or -Xshow-object) Show after phases" + abbreviations: + - "-Yshow" + - option: "-Vshow-class" + schema: + type: "String" + arg: "class" + default: + description: "Show internal representation of class." + abbreviations: + - "-Xshow-class" + - option: "-Vshow-member-pos" + schema: + type: "String" + arg: "output style" + default: + description: "Show start and end positions of members (implies -Yrangepos)" + abbreviations: + - "-Yshow-member-pos" + - option: "-Vshow-object" + schema: + type: "String" + arg: "object" + default: + description: "Show internal representation of object." + abbreviations: + - "-Xshow-object" + - option: "-Vshow-symkinds" + schema: + type: "Boolean" + description: "Print abbreviated symbol kinds next to symbol names." + abbreviations: + - "-Yshow-symkinds" + - option: "-Vshow-symowners" + schema: + type: "Boolean" + description: "Print owner identifiers next to symbol names." + abbreviations: + - "-Yshow-symowners" + - option: "-Vstatistics" + schema: + type: "Phases" + default: "parser,typer,patmat,erasure,cleanup,jvm" + description: "Print compiler statistics for specific phases phases (default: parser,typer,patmat,erasure,cleanup,jvm)" + abbreviations: + - "-Ystatistics" + - option: "-Vsymbols" + schema: + type: "Boolean" + description: "Print the AST symbol hierarchy after each phase." + abbreviations: + - "-Yshow-syms" + - option: "-Vtyper" + schema: + type: "Boolean" + description: "Trace type assignments." + abbreviations: + - "-Ytyper-debug" - category: "Private Settings" description: options: @@ -568,11 +801,6 @@ schema: type: "Boolean" description: "Attempt to break cycles encountered during typing" - - option: "-Ybrowse" - schema: - type: "Phases" - default: - description: "Browse the abstract syntax tree after phases" - option: "-Ycache-macro-class-loader" schema: type: "Choice" @@ -583,6 +811,8 @@ description: "Don't cache class loader" - choice: "last-modified" description: "Cache class loader, using file last-modified time to invalidate" + - choice: "always" + description: "Cache class loader with no invalidation" description: "Policy for caching class loaders for macros that are dynamically loaded. Default: `none`, `help` to list choices." - option: "-Ycache-plugin-class-loader" schema: @@ -594,6 +824,8 @@ description: "Don't cache class loader" - choice: "last-modified" description: "Cache class loader, using file last-modified time to invalidate" + - choice: "always" + description: "Cache class loader with no invalidation" description: "Policy for caching class loaders for compiler plugins that are dynamically loaded. Default: `none`, `help` to list choices." - option: "-Ycheck" schema: @@ -604,10 +836,6 @@ schema: type: "Boolean" description: "Use compact tree printer when displaying trees." - - option: "-Ydebug" - schema: - type: "Boolean" - description: "Increase the quantity of debugging output." - option: "-Ydelambdafy" schema: type: "Choice" @@ -616,15 +844,7 @@ choices: - choice: "inline" - choice: "method" - description: "Strategy used for translating lambdas into JVM code. Choices: (inline,method), default: method." - - option: "-YdisableFlatCpCaching" - schema: - type: "Boolean" - description: "Do not cache flat classpath representation of classpath elements from jars across compiler instances." - - option: "-Ydoc-debug" - schema: - type: "Boolean" - description: "Trace all scaladoc activity." + description: "Strategy used for translating lambdas into JVM code. (inline,[method])" - option: "-Ydump-classes" schema: type: "String" @@ -637,22 +857,12 @@ arg: "dir" default: description: "Generate a parallel output directory of .asmp files (ie ASM Textifier output)." - - option: "-Yhot-statistics-enabled" - schema: - type: "Boolean" - description: "Enable `-Ystatistics` to print hot statistics." - - option: "-Yide-debug" - schema: - type: "Boolean" - description: "Generate, validate and output trees using the interactive compiler." - - option: "-Yinfer-argument-types" - schema: - type: "Boolean" - description: "Infer types for arguments of overridden methods." - - option: "-Yissue-debug" + - option: "-Yimports" schema: - type: "Boolean" - description: "Print stack traces when a context issues an error." + type: "String" + arg: "import" + multiple: "true" + description: "Custom root imports, default is `java.lang,scala,scala.Predef`." - option: "-Yjar-compression-level" schema: type: "Int" @@ -660,23 +870,16 @@ min: "-1" max: "9" description: "compression level to use when writing jar files" - - option: "-Ylog" - schema: - type: "Phases" - default: - description: "Log operations during phases" - - option: "-Ylog-classpath" - schema: - type: "Boolean" - description: "Output information about what classpath is being applied." - - option: "-Ymacro-debug-lite" + - option: "-Ymacro-annotations" schema: type: "Boolean" - description: "Trace essential macro-related activities." - - option: "-Ymacro-debug-verbose" + description: "Enable support for macro annotations, formerly in macro paradise." + - option: "-Ymacro-classpath" schema: - type: "Boolean" - description: "Trace all macro-related activities: compilation, generation of synthetics, classloading, expansion, exceptions." + type: "Path" + arg: "path" + default: + description: "The classpath used to reflectively load macro implementations, default is the compilation classpath." - option: "-Ymacro-expand" schema: type: "Choice" @@ -686,19 +889,21 @@ - choice: "normal" - choice: "none" - choice: "discard" - description: "Control expansion of macros, useful for scaladoc and presentation compiler. Choices: (normal,none,discard), default: normal." - - option: "-Ymacro-no-expand" - schema: - type: "Boolean" - description: "Don't expand macros. Might be useful for scaladoc and presentation compiler, but will crash anything which uses macros and gets past typer." - - option: "-Yno-adapted-args" + description: "Control expansion of macros, useful for scaladoc and presentation compiler. ([normal],none,discard)" + - option: "-Ymacro-global-fresh-names" schema: type: "Boolean" - description: "Do not adapt an argument list (either by inserting () or creating a tuple) to match the receiver." + description: "Should fresh names in macros be unique across all compilation units" - option: "-Yno-completion" schema: type: "Boolean" description: "Disable tab-completion in the REPL." + - option: "-Yno-flat-classpath-cache" + schema: + type: "Boolean" + description: "Do not cache flat classpath representation of classpath elements from jars across compiler instances." + abbreviations: + - "-YdisableFlatCpCaching" - option: "-Yno-generic-signatures" schema: type: "Boolean" @@ -720,35 +925,7 @@ - choice: "at-inline-annotated" - choice: "everything" - choice: "default" - description: "Set the heuristics for inlining decisions. Choices: (at-inline-annotated,everything,default), default: default." - - option: "-Yopt-log-inline" - schema: - type: "String" - arg: "package/Class.method" - default: - description: "Print a summary of inliner activity; `_` to print all, prefix match to select." - - option: "-Yopt-trace" - schema: - type: "String" - arg: "package/Class.method" - default: - description: "Trace the optimizer progress for methods; `_` to print all, prefix match to select." - - option: "-Yoverride-objects" - schema: - type: "Boolean" - description: "Allow member objects to be overridden." - - option: "-Yoverride-vars" - schema: - type: "Boolean" - description: "Allow vars to be overridden." - - option: "-Ypartial-unification" - schema: - type: "Boolean" - description: "Enable partial unification in type constructor inference" - - option: "-Ypatmat-debug" - schema: - type: "Boolean" - description: "Trace pattern matching translation." + description: "Set the heuristics for inlining decisions. (at-inline-annotated,everything,[default])" - option: "-Ypatmat-exhaust-depth" schema: type: "Int" @@ -756,16 +933,23 @@ min: "10" max: "2147483647" description: "off" - - option: "-Ypos-debug" + - option: "-Yprint-trees" schema: - type: "Boolean" - description: "Trace position validation." + type: "Choice" + arg: "style" + default: "text" + choices: + - choice: "text" + - choice: "compact" + - choice: "format" + - choice: "text+format" + description: "How to print trees when -Vprint is enabled. ([text],compact,format,text+format)" - option: "-Yprofile-destination" schema: type: "String" arg: "file" default: - description: "where to send profiling output - specify a file, default is to the console." + description: "Profiling output - specify a file or `-` for console." - option: "-Yprofile-enabled" schema: type: "Boolean" @@ -780,10 +964,12 @@ type: "Phases" default: "_" description: "Run a GC between phases - this allows heap size to be accurate at the expense of more time. Specify a list of phases, or all phases (default: _)" - - option: "-Yquasiquote-debug" + - option: "-Yprofile-trace" schema: - type: "Boolean" - description: "Trace quasiquote-related activities." + type: "String" + arg: "file" + default: "profile.trace" + description: "Capture trace of compilation in Chrome Trace format" - option: "-Yrangepos" schema: type: "Boolean" @@ -799,10 +985,6 @@ schema: type: "Boolean" description: "Dump the reified trees in copypasteable representation." - - option: "-Yreify-debug" - schema: - type: "Boolean" - description: "Trace reification." - option: "-Yrepl-class-based" schema: type: "Boolean" @@ -813,10 +995,6 @@ arg: "path" default: description: "Write repl-generated classfiles to given output directory (use \"\" to generate a temporary dir)" - - option: "-Yrepl-sync" - schema: - type: "Boolean" - description: "Do not use asynchronous code for repl startup" - option: "-Yresolve-term-conflict" schema: type: "Choice" @@ -826,52 +1004,18 @@ - choice: "package" - choice: "object" - choice: "error" - description: "Resolve term conflicts. Choices: (package,object,error), default: error." - - option: "-Yshow" - schema: - type: "Phases" - default: - description: "(Requires -Xshow-class or -Xshow-object) Show after phases" - - option: "-Yshow-member-pos" + description: "Resolve term conflicts. (package,object,[error])" + - option: "-Yscriptrunner" schema: type: "String" - arg: "output style" - default: - description: "Show start and end positions of members (implies -Yrangepos)" - - option: "-Yshow-symkinds" - schema: - type: "Boolean" - description: "Print abbreviated symbol kinds next to symbol names." - - option: "-Yshow-symowners" - schema: - type: "Boolean" - description: "Print owner identifiers next to symbol names." - - option: "-Yshow-syms" - schema: - type: "Boolean" - description: "Print the AST symbol hierarchy after each phase." - - option: "-Yshow-trees" - schema: - type: "Boolean" - description: "(Requires -Xprint:) Print detailed ASTs in formatted form." - - option: "-Yshow-trees-compact" - schema: - type: "Boolean" - description: "(Requires -Xprint:) Print detailed ASTs in compact form." - - option: "-Yshow-trees-stringified" - schema: - type: "Boolean" - description: "(Requires -Xprint:) Print stringifications along with detailed ASTs." + arg: "classname" + default: "default" + description: "Specify a scala.tools.nsc.ScriptRunner (default, resident, shutdown, or a class name)." - option: "-Yskip" schema: type: "Phases" default: description: "Skip phases" - - option: "-Ystatistics" - schema: - type: "Phases" - default: "parser,typer,patmat,erasure,cleanup,jvm" - description: "Print compiler statistics for specific phases phases (default: parser,typer,patmat,erasure,cleanup,jvm)" - option: "-Ystop-after" schema: type: "Phases" @@ -884,40 +1028,27 @@ type: "Phases" default: description: "Stop before phases" - - option: "-Ytyper-debug" - schema: - type: "Boolean" - description: "Trace all type assignments." - option: "-Yvalidate-pos" schema: type: "Phases" default: description: "Validate positions after the given phases (implies -Yrangepos) phases" - - option: "-Yvirtpatmat" - schema: - type: "Boolean" - description: "Enable pattern matcher virtualization" - - option: "-Ywarn-adapted-args" - schema: - type: "Boolean" - description: "Warn if an argument list is modified to match the receiver." - - option: "-Ywarn-dead-code" +- category: "Warning Settings" + description: + options: + - option: "-Wdead-code" schema: type: "Boolean" description: "Warn when dead code is identified." - - option: "-Ywarn-extra-implicit" + abbreviations: + - "-Ywarn-dead-code" + - option: "-Wextra-implicit" schema: type: "Boolean" description: "Warn when more than one implicit parameter section is defined." - - option: "-Ywarn-inaccessible" - schema: - type: "Boolean" - description: "Warn about inaccessible types in method signatures." - - option: "-Ywarn-infer-any" - schema: - type: "Boolean" - description: "Warn when a type argument is inferred to be `Any`." - - option: "-Ywarn-macros" + abbreviations: + - "-Ywarn-extra-implicit" + - option: "-Wmacros" schema: type: "Choice" arg: "mode" @@ -932,23 +1063,27 @@ - choice: "both" description: "Inspect both user-written code and expanded trees when generating unused symbol warnings." description: "Enable lint warnings on macro expansions. Default: `before`, `help` to list choices." - - option: "-Ywarn-nullary-override" - schema: - type: "Boolean" - description: "Warn when non-nullary `def f()` overrides nullary `def f`." - - option: "-Ywarn-nullary-unit" + abbreviations: + - "-Ywarn-macros" + - option: "-Wnumeric-widen" schema: type: "Boolean" - description: "Warn when nullary methods return Unit." - - option: "-Ywarn-numeric-widen" + description: "Warn when numerics are widened." + abbreviations: + - "-Ywarn-numeric-widen" + - option: "-Woctal-literal" schema: type: "Boolean" - description: "Warn when numerics are widened." - - option: "-Ywarn-self-implicit" + description: "Warn on obsolete octal syntax." + abbreviations: + - "-Ywarn-octal-literal" + - option: "-Wself-implicit" schema: type: "Boolean" description: "Warn when an implicit resolves to an enclosing self-definition." - - option: "-Ywarn-unused" + abbreviations: + - "-Ywarn-self-implicit" + - option: "-Wunused" schema: type: "Choice" arg: "warning" @@ -967,21 +1102,18 @@ - choice: "implicits" description: "Warn if an implicit parameter is unused." - choice: "params" - description: "Enable -Ywarn-unused:explicits,implicits." + description: "Enable -Wunused:explicits,implicits." - choice: "linted" description: "-Xlint:unused." - description: "Enable or disable specific `unused` warnings: `_` for all, `-Ywarn-unused:help` to list choices." - - option: "-Ywarn-unused-import" - schema: - type: "Boolean" - description: "Warn when imports are unused." - - option: "-Ywarn-value-discard" + description: "Enable or disable specific `unused` warnings" + abbreviations: + - "-Ywarn-unused" + - option: "-Wvalue-discard" schema: type: "Boolean" description: "Warn when non-Unit expression results are unused." -- category: "Warning Settings" - description: - options: + abbreviations: + - "-Ywarn-value-discard" - option: "-Xlint" schema: type: "Choice" @@ -1012,19 +1144,29 @@ description: "Option.apply used implicit view." - choice: "delayedinit-select" description: "Selecting member of DelayedInit." - - choice: "by-name-right-associative" - description: "By-name parameter of right associative operator." - choice: "package-object-classes" description: "Class or object defined in package object." - - choice: "unsound-match" - description: "Pattern match may not be typesafe." - choice: "stars-align" description: "Pattern sequence wildcard must align with sequence component." - choice: "constant" description: "Evaluation of a constant arithmetic expression results in an error." - choice: "unused" - description: "Enable -Ywarn-unused:imports,privates,locals,implicits." - description: "Enable or disable specific warnings: `_` for all, `-Xlint:help` to list choices." + description: "Enable -Wunused:imports,privates,locals,implicits." + - choice: "nonlocal-return" + description: "A return statement used an exception for flow control." + - choice: "implicit-not-found" + description: "Check @implicitNotFound and @implicitAmbiguous messages." + - choice: "serial" + description: "@SerialVersionUID on traits and non-serializable classes." + - choice: "valpattern" + description: "Enable pattern checks in val definitions." + - choice: "eta-zero" + description: "Warn on eta-expansion (rather than auto-application) of zero-ary method." + - choice: "eta-sam" + description: "Warn on eta-expansion to meet a Java-defined functional interface that is not explicitly annotated with @FunctionalInterface." + - choice: "deprecation" + description: "Enable linted deprecations." + description: "Enable recommended warnings" - category: "IDE-specific Settings" description: options: @@ -1063,3 +1205,4 @@ schema: type: "Boolean" description: "Print information about presentation compiler tasks." + From 98ebcab76dcd2ebf0147ff61731543169b597e9f Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Fri, 14 Jun 2019 11:42:52 -0700 Subject: [PATCH 0610/3075] Mention PathResolver --- _overviews/compiler-options/index.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/_overviews/compiler-options/index.md b/_overviews/compiler-options/index.md index aa228ba67d..b27efbaa4f 100644 --- a/_overviews/compiler-options/index.md +++ b/_overviews/compiler-options/index.md @@ -49,6 +49,11 @@ scalac [ ] E.g. `scalac -encoding utf8 -Xfatal-warnings Hello.scala` +Default paths can be listed by running a command line tool: +``` +scala scala.tools.util.PathResolver [ ] +``` + ### Use compiler options with sbt From a078d49a93193a7e405856092dff1725bf596b8f Mon Sep 17 00:00:00 2001 From: Dongxu Wang Date: Sat, 20 Jul 2019 08:08:45 +0800 Subject: [PATCH 0611/3075] Add zh-cn version of landing page. --- _zh-cn/index.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++ index.md | 2 +- 2 files changed, 70 insertions(+), 1 deletion(-) create mode 100644 _zh-cn/index.md diff --git a/_zh-cn/index.md b/_zh-cn/index.md new file mode 100644 index 0000000000..c6b0e0d8d3 --- /dev/null +++ b/_zh-cn/index.md @@ -0,0 +1,69 @@ +--- +layout: inner-page-documentation +title: 文档 +language: zh-cn +partof: documentation +discourse: true + +# Content masthead links +sections: + + - title: "第一步..." + links: + - title: "快速开始" + description: "在电脑上安装Scala然后开始写些Scala代码吧！" + icon: "fa fa-rocket" + link: /getting-started.html + - title: "Scala之旅" + description: "核心语言特性简介" + icon: "fa fa-flag" + link: /tour/tour-of-scala.html + - title: "Java程序员Scala入门" + description: "为具有Java背景的程序员准备的Scala简介" + icon: "fa fa-coffee" + link: /tutorials/scala-for-java-programmers.html + more-resources: + - title: 在线课程、练习和博客 + url: /learn.html + - title: 书籍 + url: /books.html + + - title: "回归用户" + links: + - title: "API" + description: "各个Scala版本的API文档" + icon: "fa fa-file-text" + link: /api/all.html + - title: "总览" + description: "涵盖Scala各种特性的深度分析文档" + icon: "fa fa-database" + link: /overviews/index.html + - title: "风格引导" + description: "深度指导如何写出地道的Scala代码" + icon: "fa fa-bookmark" + link: /style/index.html + - title: "速查" + description: "包含Scala基础语法的速查手册" + icon: "fa fa-list" + link: /cheatsheets/index.html + - title: "Scala常见问题" + description: "Scala语言特性的常见问题及答案" + icon: "fa fa-question-circle" + link: /tutorials/FAQ/index.html + - title: "语言规范" + description: "Scala正式语言规范" + icon: "fa fa-book" + link: http://scala-lang.org/files/archive/spec/2.12/ + + - title: "Scala进展" + links: + - title: "SIPs" + description: "Scala改进过程（Scala Improvement Process），语言及编译器进展" + icon: "fa fa-cogs" + link: /sips/index.html + - title: "SPP" + description: "Scala平台进程（Scala Platform Process）， 社区驱动代码库的进展" + icon: "fa fa-users" + link: https://platform.scala-lang.org + +--- diff --git a/index.md b/index.md index fb6d93db53..7f1527e81a 100644 --- a/index.md +++ b/index.md @@ -1,7 +1,7 @@ --- layout: inner-page-documentation title: Documentation -languages: [ja] +languages: [ja, zh-cn] namespace: root partof: documentation discourse: true From 1228f6497cf8141658695f07bbd807ba43be27e2 Mon Sep 17 00:00:00 2001 From: Miron Aseev Date: Sat, 20 Jul 2019 11:18:53 +0700 Subject: [PATCH 0612/3075] Remove the redundant 'val' and 'new' keywords --- _ba/tour/operators.md | 4 ++-- _ja/tour/operators.md | 4 ++-- _ru/tour/operators.md | 4 ++-- _tour/operators.md | 4 ++-- _zh-cn/tour/operators.md | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/_ba/tour/operators.md b/_ba/tour/operators.md index 363cf74858..1f68f621a7 100644 --- a/_ba/tour/operators.md +++ b/_ba/tour/operators.md @@ -29,8 +29,8 @@ Međutim, lakše je čitati kada se napiše kao infiksni operator: Možete koristiti bilo koji legalni identifikator kao operator. To uključuje i imena kao `add` ili simbole kao `+`. ```tut -case class Vec(val x: Double, val y: Double) { - def +(that: Vec) = new Vec(this.x + that.x, this.y + that.y) +case class Vec(x: Double, y: Double) { + def +(that: Vec) = Vec(this.x + that.x, this.y + that.y) } val vector1 = Vec(1.0, 1.0) diff --git a/_ja/tour/operators.md b/_ja/tour/operators.md index e6c2352ef2..f5b1ac6ed5 100644 --- a/_ja/tour/operators.md +++ b/_ja/tour/operators.md @@ -29,8 +29,8 @@ Scalaでは演算子はメソッドです。パラメータを1つだけ持つ 有効な識別子であれば演算子として使用できます。これは `add`のような名前も`+`のような記号も含みます。 ```tut -case class Vec(val x: Double, val y: Double) { - def +(that: Vec) = new Vec(this.x + that.x, this.y + that.y) +case class Vec(x: Double, y: Double) { + def +(that: Vec) = Vec(this.x + that.x, this.y + that.y) } val vector1 = Vec(1.0, 1.0) diff --git a/_ru/tour/operators.md b/_ru/tour/operators.md index 1609ce60f5..33b4cbfd20 100644 --- a/_ru/tour/operators.md +++ b/_ru/tour/operators.md @@ -26,8 +26,8 @@ prerequisite-knowledge: case-classes ## Создание и использование операторов В качестве оператора можно использовать любой допустимый символ. Включая имена на подобии `add` или символ (символы) типа `+`. ```tut -case class Vec(val x: Double, val y: Double) { - def +(that: Vec) = new Vec(this.x + that.x, this.y + that.y) +case class Vec(x: Double, y: Double) { + def +(that: Vec) = Vec(this.x + that.x, this.y + that.y) } val vector1 = Vec(1.0, 1.0) diff --git a/_tour/operators.md b/_tour/operators.md index b3ad662813..5744213cc0 100644 --- a/_tour/operators.md +++ b/_tour/operators.md @@ -26,8 +26,8 @@ However, it's easier to read as an infix operator: ## Defining and using operators You can use any legal identifier as an operator. This includes a name like `add` or a symbol(s) like `+`. ```tut -case class Vec(val x: Double, val y: Double) { - def +(that: Vec) = new Vec(this.x + that.x, this.y + that.y) +case class Vec(x: Double, y: Double) { + def +(that: Vec) = Vec(this.x + that.x, this.y + that.y) } val vector1 = Vec(1.0, 1.0) diff --git a/_zh-cn/tour/operators.md b/_zh-cn/tour/operators.md index c662d3a80c..dc42357bc8 100644 --- a/_zh-cn/tour/operators.md +++ b/_zh-cn/tour/operators.md @@ -26,8 +26,8 @@ previous-page: type-inference ## 定义和使用运算符 你可以使用任何合法标识符作为运算符。 包括像 `add` 这样的名字或像 `+` 这样的符号。 ```tut -case class Vec(val x: Double, val y: Double) { - def +(that: Vec) = new Vec(this.x + that.x, this.y + that.y) +case class Vec(x: Double, y: Double) { + def +(that: Vec) = Vec(this.x + that.x, this.y + that.y) } val vector1 = Vec(1.0, 1.0) From a6500c6d0e99016311473853dc2d8ebf54efba01 Mon Sep 17 00:00:00 2001 From: Flakeparadigm Date: Sat, 20 Jul 2019 13:10:36 +1000 Subject: [PATCH 0613/3075] Update Style Guide TOC and Method Invocation page --- _style/index.md | 9 ++-- _style/method-invocation.md | 96 ++++++++++++++++++++++++------------- 2 files changed, 67 insertions(+), 38 deletions(-) diff --git a/_style/index.md b/_style/index.md index 29ae8d16b5..8fed2138bb 100644 --- a/_style/index.md +++ b/_style/index.md @@ -54,11 +54,10 @@ This document is intended to outline some basic Scala stylistic guidelines which - [Trivial Conditionals](control-structures.html#trivial-conditionals) - [Method Invocation](method-invocation.html) - [Arity-0](method-invocation.html#arity-0) - - [Infix Notation](method-invocation.html#infix-notation) - - [Postfix Notation](method-invocation.html) - - [Arity-1](method-invocation.html) - - [Higher-Order Functions](method-invocation.html) - - [Symbolic methods/Operators](method-invocation.html) + - [Postfix Notation](method-invocation.html#postfix-notation) + - [Arity-1 (Infix Notation)](method-invocation.html#arity-1-infix-notation) + - [Symbolic Methods/Operators](method-invocation.html#symbolic-methodsoperators) + - [Higher-Order Functions](method-invocation.html#higher-order-functions) - [Files](files.html) - [Multi-Unit Files](files.html#multi-unit-files) - [Scaladoc](scaladoc.html) diff --git a/_style/method-invocation.md b/_style/method-invocation.md index bb9fdb3fb9..5b0b5099ea 100644 --- a/_style/method-invocation.md +++ b/_style/method-invocation.md @@ -56,22 +56,36 @@ readability and will make it much easier to understand at a glance the most basic operation of any given method. Resist the urge to omit parentheses simply to save two characters! -## Infix notation +### Postfix Notation -Scala has a special punctuation-free syntax for invoking methods that -take one argument. Many Scala programmers use this notation for -symbolic-named methods: +Scala allows methods that take no arguments to be invoked using postfix notation: // recommended - a + b + names.toList - // legal, but less readable - a+b + // discourage + names toList - // legal, but definitely strange - a.+(b) +This style is unsafe, and should not be used. Since semicolons are +optional, the compiler will attempt to treat it as an infix method +if it can, potentially taking a term from the next line. -but avoid it for almost all alphabetic-named methods: + names toList + val answer = 42 // will not compile! + +This may result in unexpected compile errors at best, and happily +compiled faulty code at worst. Although the syntax is used by some +DSLs, it should be considered deprecated, and avoided. + +Since Scala 2.10, using postfix operator notation will result in a +compiler warning. + +## Arity-1 (Infix Notation) + +Scala has a special punctuation-free syntax for invoking methods of arity-1 +(one argument). This should generally be avoided, but with the following +exceptions for operators and higher-order functions. In these cases it should +only be used for purely-functional methods (methods with no side-effects). // recommended names.mkString(",") @@ -79,8 +93,25 @@ but avoid it for almost all alphabetic-named methods: // also sometimes seen; controversial names mkString "," -A gray area is short, operator-like methods like `max`, -especially if commutative: + // wrong - has side-effects + javaList add item + +### Symbolic Methods/Operators + +Symbolic methods (operators) should always be invoked using infix notation with +spaces separating the target, the operator, and the parameter: + + // right! + "daniel" + " " + "spiewak" + a + b + + // wrong! + "daniel"+" "+"spiewak" + a+b + a.+(b) + +For the most part, this idiom follows Java and Haskell syntactic conventions. A +gray area is short, operator-like methods like `max`, especially if commutative: // fairly common a max b @@ -90,31 +121,30 @@ may still be invoked using infix notation, delimited by spaces: foo ** (bar, baz) -Such methods are fairly rare, however, and should normally be avoided -during API design. For example, the use of the `/:` and `:\` methods -should be avoided in preference to their better-known names, -`foldLeft` and `foldRight`. - -## Postfix Notation +Such methods are fairly rare, however, and should normally be avoided during API +design. For example, the use of the `/:` and `:\` methods should be avoided in +preference to their better-known names, `foldLeft` and `foldRight`. -Scala allows methods that take no arguments to be invoked using postfix notation: +### Higher-Order Functions - // recommended - names.toList +As noted, methods which take functions as parameters (such as `map` or +`foreach`) should be invoked using infix notation. It is also *possible* to +invoke such methods in the following way: - // discourage - names toList + // wrong! + names.map { _.toUpperCase } -This style is unsafe, and should not be used. Since semicolons are -optional, the compiler will attempt to treat it as an infix method -if it can, potentially taking a term from the next line. +This style is *not* the accepted standard! The reason to avoid this style is for +situations where more than one invocation must be chained together: - names toList - val answer = 42 // will not compile! + // wrong! + names.map { _.toUpperCase }.filter { _.length > 5 } -This may result in unexpected compile errors at best, and happily -compiled faulty code at worst. Although the syntax is used by some -DSLs, it should be considered deprecated, and avoided. + // right! + names map { _.toUpperCase } filter { _.length > 5 } -Since Scala 2.10, using postfix operator notation will result in a -compiler warning. +Both of these work, but the former can easily lead to confusion. The +sub-expression `{ _.toUpperCase }.filter` when taken in isolation looks like we +are invoking the `filter` method on a function value. However, we are actually +invoking `filter` on the result of the `map` method, which takes the function +value as a parameter. From 0d03cba3440e0048d5b2221b1f0f33cb55b66485 Mon Sep 17 00:00:00 2001 From: Flakeparadigm Date: Sat, 20 Jul 2019 15:22:38 +1000 Subject: [PATCH 0614/3075] Ensure Style guide overview and TOC match --- _style/control-structures.md | 2 +- _style/declarations.md | 12 ++++++------ _style/files.md | 6 +++--- _style/index.md | 5 +++-- _style/method-invocation.md | 2 +- _style/nested-blocks.md | 2 +- _style/scaladoc.md | 2 +- 7 files changed, 16 insertions(+), 15 deletions(-) diff --git a/_style/control-structures.md b/_style/control-structures.md index df74036aee..7a746c46bd 100644 --- a/_style/control-structures.md +++ b/_style/control-structures.md @@ -7,7 +7,7 @@ overview-name: "Style Guide" num: 7 -previous-page: files +previous-page: declarations next-page: method-invocation --- diff --git a/_style/declarations.md b/_style/declarations.md index 90708e4b1b..b8cdb75c7f 100644 --- a/_style/declarations.md +++ b/_style/declarations.md @@ -5,10 +5,10 @@ title: Declarations partof: style overview-name: "Style Guide" -num: 9 +num: 6 -previous-page: method-invocation -next-page: scaladoc +previous-page: nested-blocks +next-page: control-structures --- ## Classes @@ -51,7 +51,7 @@ empty line should be added to further separate extensions from class implementat with Logging with Identifiable with Serializable { - + def firstMethod: Foo = … } @@ -286,11 +286,11 @@ function value. When styles (1) and (4) are used exclusively, it becomes very easy to distinguish places in the source code where function values are used. -Both styles make use of parentheses, since they look clean on a single line. +Both styles make use of parentheses, since they look clean on a single line. ### Spacing -There should be no space between parentheses and the code they contain. +There should be no space between parentheses and the code they contain. Curly braces should be separated from the code within them by a one-space gap, to give the visually busy braces "breathing room". diff --git a/_style/files.md b/_style/files.md index 668ac3c82b..54ddf4e2db 100644 --- a/_style/files.md +++ b/_style/files.md @@ -5,10 +5,10 @@ title: Files partof: style overview-name: "Style Guide" -num: 6 +num: 9 -previous-page: nested-blocks -next-page: control-structures +previous-page: method-invocation +next-page: scaladoc --- As a rule, files should contain a *single* logical compilation unit. By diff --git a/_style/index.md b/_style/index.md index 8fed2138bb..df59d51944 100644 --- a/_style/index.md +++ b/_style/index.md @@ -31,7 +31,7 @@ This document is intended to outline some basic Scala stylistic guidelines which - [Annotations](types.html#annotations) - [Ascription](types.html#ascription) - [Functions](types.html#functions) - - [Arity-1](types.html) + - [Arity-1](types.html#arity-1) - [Structural Types](types.html#structural-types) - [Nested Blocks](nested-blocks.html) - [Curly Braces](nested-blocks.html#curly-braces) @@ -40,10 +40,11 @@ This document is intended to outline some basic Scala stylistic guidelines which - [Classes](declarations.html#classes) - [Ordering Of Class Elements](declarations.html#ordering-of-class-elements) - [Methods](declarations.html#methods) + - [Procedure Syntax](declarations.html#procedure-syntax) - [Modifiers](declarations.html#modifiers) - [Body](declarations.html#body) - [Multiple Parameter Lists](declarations.html#multiple-parameter-lists) - - [Higher-Order Functions](declarations.html) + - [Higher-Order Functions](declarations.html#higher-order-functions) - [Fields](declarations.html#fields) - [Function Values](declarations.html#function-values) - [Spacing](declarations.html#spacing) diff --git a/_style/method-invocation.md b/_style/method-invocation.md index 5b0b5099ea..694552afba 100644 --- a/_style/method-invocation.md +++ b/_style/method-invocation.md @@ -8,7 +8,7 @@ overview-name: "Style Guide" num: 8 previous-page: control-structures -next-page: declarations +next-page: files --- Generally speaking, method invocation in Scala follows Java conventions. diff --git a/_style/nested-blocks.md b/_style/nested-blocks.md index 3c489da966..6970f050f9 100644 --- a/_style/nested-blocks.md +++ b/_style/nested-blocks.md @@ -8,7 +8,7 @@ overview-name: "Style Guide" num: 5 previous-page: types -next-page: files +next-page: declarations --- ## Curly Braces diff --git a/_style/scaladoc.md b/_style/scaladoc.md index 6ce4b63fef..7a78bd713f 100644 --- a/_style/scaladoc.md +++ b/_style/scaladoc.md @@ -7,7 +7,7 @@ overview-name: "Style Guide" num: 10 -previous-page: declarations +previous-page: files --- It is important to provide documentation for all packages, classes, From 81b316edabeb8efcbfb2ba2945fabe5f31e94d30 Mon Sep 17 00:00:00 2001 From: exoego Date: Sat, 20 Jul 2019 11:49:56 +0900 Subject: [PATCH 0615/3075] Add Japanese translation of Getting Started. --- ...g-a-scala-project-with-intellij-and-sbt.md | 101 ++++++++++++++++++ .../getting-started-with-scala-in-intellij.md | 73 +++++++++++++ ...esting-scala-in-intellij-with-scalatest.md | 71 ++++++++++++ ...-with-scala-and-sbt-on-the-command-line.md | 89 +++++++++++++++ ...ting-scala-with-sbt-on-the-command-line.md | 71 ++++++++++++ _ja/getting-started.md | 52 +++++++++ ...g-a-scala-project-with-intellij-and-sbt.md | 2 + .../getting-started-with-scala-in-intellij.md | 2 + ...esting-scala-in-intellij-with-scalatest.md | 2 + ...-with-scala-and-sbt-on-the-command-line.md | 2 + ...ting-scala-with-sbt-on-the-command-line.md | 2 + getting-started.md | 2 + 12 files changed, 469 insertions(+) create mode 100644 _ja/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md create mode 100644 _ja/getting-started-intellij-track/getting-started-with-scala-in-intellij.md create mode 100644 _ja/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md create mode 100644 _ja/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md create mode 100644 _ja/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md create mode 100644 _ja/getting-started.md diff --git a/_ja/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md b/_ja/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md new file mode 100644 index 0000000000..7059ff70f2 --- /dev/null +++ b/_ja/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md @@ -0,0 +1,101 @@ +--- +title: Intellij で sbt を使って Scala プロジェクトをビルドする +layout: singlepage-overview +partof: building-a-scala-project-with-intellij-and-sbt +language: ja +disqus: true +previous-page: /ja/getting-started-intellij-track/getting-started-with-scala-in-intellij +next-page: /ja/testing-scala-in-intellij-with-scalatest +--- + +このチュートリアルでは、[sbt](http://www.scala-sbt.org/1.x/docs/index.html) を使って Scala プロジェクトをビルドする方法を見ていきます。 +sbtは、どのようなサイズの Scala プロジェクトでもコンパイル、実行、テストできる人気のツールです。 +sbt（または Maven や Gradle）のようなビルドツールの使用は、1つ以上のコードファイルや依存関係のあるプロジェクトを作ったら、絶対不可欠になります。 +[最初のチュートリアル](./getting-started-with-scala-in-intellij.html)を完了していることを前提とします。 + +## プロジェクトを作成 +このでは、Intellij でプロジェクトの作り方をお見せします。 +ですが、コマンドラインのほうが快適でしたら、[Getting +コマンドラインの sbt で Scala を始める](/ja/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) を試して、「Scala コードを記述」節に戻ってくるのをおすすめします。 + +1. コマンドラインからプロジェクトを作っていなければ、Intellij を開き、"Create New Project" を選びます。 + * 左パネルで Scala を選び、右パネルで sbt を選びます。 + * **Next** をクリックします + * プロジェクトに **SbtExampleProject** と名前を付けます。 +1. コマンドラインですでにプロジェクトを作成していたら、Intelij を開き、**Import Project** を選んで、あなたのプロジェクトの `build.sbt` ファイルを開きます。 +1. **JDK version** が `1.8` で、**sbt version** が少なくとも `0.13.13` であることを確認します。 +1. **Use auto-import** を選びます。すると依存関係が利用可能であれば自動でダウンロードされます。 +1. **Finish** を選びます。 + +## ディレクトリ構造を理解 + +sbt は、より複雑なプロジェクトを構築すだしたら便利になるであろう多くのディレクトリを作成します。 +今はそのほとんどを無視できますが、全部が何のためかをここでちらっと見ておきましょう。 + +``` +- .idea (IntelliJ ファイル) +- project (sbt のプラグインや追加設定) +- src (ソースファイル) + - main (アプリケーションコード) + - java (Java ソースファイル) + - scala (Scala ソースファイル) + ^-- 今はこれが必要なものの全てです + - scala-2.12 (Scala 2.12 固有ファイル) + - test (ユニットテスト) +- target (生成されたファイル) +- build.sbt (sbt のためのビルド定義ファイル) +``` + + +## Scala コードを記述 +1. 左の **Project** パネルで、`SbtExampleProject` => `src` => `main` を展開します。 +1. `scala` を右クリックし、**New** => **Package** を選択します。 +1. パッケージに `example` と名前をつけ、**OK** をクリックします。 +1. パッケージ `example` を右クリックし、**New** => **Scala class** をクリックします。 +1. クラスに　`Main` と名前をつけ、**Kind** を `object` に変更します。 +1. クラスのコードを次おように変更します。 + +``` +object Main extends App { + val ages = Seq(42, 75, 29, 64) + println(s"The oldest person is ${ages.max}") +} +``` + +注：Intellij は Scala コンパイラーの独自実装を持っており、コードが間違っていると Intellij が示しても正しい場合がときどきあります。 +コマンドラインで sbt がプロジェクトを実行できるかを常にチェックできます。。 + +## プロジェクトを実行 +1. **Run** メニューから、**Edit configurations** を選びます。 +1. **+** ボタンをクリックし、**sbt Task** を選びます +1. それに `Run the program` と名付けます。 +1. **Tasks** フィールドで、`~run` と入力します. + `~` は、プロジェクトファイルへの変更を保存するたびに sbt にプロジェクトを再ビルド、再実行させます。 +1. **OK** をクリックします。 +1. **Run** メニューで、**Run 'Run the program'** をクリックします。 +1. コードの `75` を `61` に変えて、コンソールで更新された出力を見ます。 + +## 依存関係を追加 + +趣向を少し変えて、アプリに追加機能を加えるために公開ライブラリの使い方を見てみましょう。 + +`build.sbt` を開き、以下のファイルを追加します。 + +``` +libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % "1.1.0" +``` + +ここで `libraryDependencies` は依存関係の集合であり、`+=` を使うことにより、[scala-parser-combinators](https://github.com/scala/scala-parser-combinators) への依存を、sbt が起動時に取得してくる依存関係の集合に加えています。 +これで、どの Scala ファイルでも、`scala-parser-combinator` にあるクラスやオブジェクトなどを通常のインポートでインポートできます。 + +さらなる公開ライブラリは、Scala ライブラリインデックス [Scaladex](https://index.scala-lang.org/) で見つけられます。 +そこでは上述のような依存関係情報をコピーでき、`build.sbt` ファイルにペーストできます。 + +## 次のステップ + +**Intellij で入門** シリーズの次のチュートリアルに進み、[Intelij で ScalaTest を使って Scala をテストする](testing-scala-in-intellij-with-scalatest.html)方法を学びます。 + +**あるいは** + +- インタラクティブなオンラインコース [Scala Exercises](https://www.scala-exercises.org/scala_tutorial) で Scala を学習します。 +- [Scala ツアー](/ja//tour/tour-of-scala.html) で Scala の特徴を一口大のサイズでステップバイステップに学びます。 diff --git a/_ja/getting-started-intellij-track/getting-started-with-scala-in-intellij.md b/_ja/getting-started-intellij-track/getting-started-with-scala-in-intellij.md new file mode 100644 index 0000000000..676c247d40 --- /dev/null +++ b/_ja/getting-started-intellij-track/getting-started-with-scala-in-intellij.md @@ -0,0 +1,73 @@ +--- +title: Intellij で Scala を始める +layout: singlepage-overview +partof: getting-started-with-scala-in-intellij +language: ja +disqus: true +next-page: /ja/building-a-scala-project-with-intellij-and-sbt +--- + +このチュートリアルでは、Intellij IDEA と Scala プラグインを使って最小限の Scala プロジェクトを作る方法を見ていきます。 +このガイドでは、Intellij があなたのために Scala をダウンロードしてくれます。 + +## インストール +1. Java 8 JDK（別名 1.8）がインストールされていることを確認します。 + * コマンドラインで `javac -version` を実行し、`javac 1.8.___` と表示されるのを確認します。 + * バージョン 1.8 かそれ以上がなければ、[JDK をインストールします](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)。 +1. [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/) をダウンロード、インストールします。 +1. それから、Intellij を起動したあと、[how to install IntelliJ plugins](https://www.jetbrains.com/help/idea/installing-updating-and-uninstalling-repository-plugins.html) の指示に従って Scala プラグインをダウンロードしてインストールできます（プラグインメニューで「Scala」と検索）。 + +プロジェクトを作るときは、Scala の最新バージョンをインストールします。 +注：存在する Scala プロジェクトを開きたければ、Intellij をスタートするときに **Open** をクリックします。 + + +## プロジェクトを作成 +1. Intellij を開き、**File** => **New** => **Project** をクリックします。 +1. 左パネルで Scala を選びます。右のパネルで IDEA を開きます。 +1. プロジェクトに **HelloWorld** と名前を付けます。 +1. 今回始めて Intellij で Scala プロジェクトを初めて作るとすれば、Scala SDK をインストールする必要があります。Scala SDK フィールドの右側にある **Create** ボタンをクリックします。 +1. 最新のバージョン番号（例 {{ site.scala-version }}）を選び、**Download**をクリックします。 + これは数分かかるかもしれませんが、今後のプロジェクトでは同じ SDK を使えます。 +1. SDK がダウンロードされたらすぐに、「New Project」ウィンドウに戻って **Finish** ボタンをクリックします。 + + +## コードを記述 + +1. 左側の **プロジェクト** ペインで、`src` ディレクトリを右クリックし、**New** => **Scala class** を選択します。 + もし、**Scala class** が見当たらなければ、**HelloWorld** を右クリックし、**Add Framework Support...** をクリックし、**Scala** を選択して進めます。 + **Error: library is not specified** が発生したら、ダウンロードボタンをクリックするか、またはライブラリパスを手動で選択します。 +1. クラスに `Hello` と名前を付けて、**Kind** を `object` に変更します。 +1. クラスのコードを次のように変更します。 + +``` +object Hello extends App { + println("Hello, World!") +} +``` + +## 実行 +* あなたのコード `Hello` で右クリックし、**Run 'Hello'** を選びます。 +* 完了です！ + +## Scala を試してみる + +コード例を試してみる良い方法は、Scala ワークシートです。 + +1. 左のプロジェクトペインで、`src` ディレクトリを右クリックし、**New** => **Scala Worksheet** を選びます。 +2. 新しい Scala ワークシートに "Mathematician" と名前を付けます。 +3. ワークシートに以下のコードを入力します。 + +``` +def square(x: Int) = x * x + +square(2) +``` + +コードを変更するにつれて、その評価結果が右ペインに現れるのに気づくでしょう。 + +## 次のステップ + +言語を学び始めるのに使える、シンプルな Scala プロジェクトの作り方を学びました。 +次のチュートリアルでは、シンプルなプロジェクトから本番アプリケーションまで使える sbt という重要なビルドツールを紹介します。 + +次: [Intellij で sbt を使って Scala プロジェクトをビルドする](building-a-scala-project-with-intellij-and-sbt.html) diff --git a/_ja/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md b/_ja/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md new file mode 100644 index 0000000000..e2cedcac86 --- /dev/null +++ b/_ja/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -0,0 +1,71 @@ +--- +title: Intelij で ScalaTest を使って Scala をテストする +layout: singlepage-overview +partof: testing-scala-in-intellij-with-scalatest +language: ja +disqus: true +previous-page: /ja/building-a-scala-project-with-intellij-and-sbt +--- + +Scala には複数のライブラリとテスト方法がありますが、このチュートリアルでは、ScalaTest フレームワークから [FunSuite](http://www.scalatest.org/getting_started_with_fun_suite) という人気のある選択肢を実演します。 + +[Intellij で sbt を使って Scala プロジェクトをビルドする方法](./building-a-scala-project-with-intellij-and-sbt.html)を知っている前提とします。 + +## セットアップ +1. Intellij で sbt プロジェクトを作成します。 +1. ScalaTest への依存を追加します。 + 1. `build.sbt` ファイルに ScalaTest への依存を追加します。 + ``` + libraryDependencies += "org.scalatest" %% "scalatest" % "3.0.5" % "test" + ``` + 1. `build.sbt was changed` という通知が出たら、**auto-import** を選択します。 + 1. これらの2つのアクションにより、`sbt` が ScalaTest ライブラリをダウンロードします。 + 1. `sbt` の同期完了を待ちます。そうしなければ `FunSuite` と `test()` は認識されません。 +1. 左のプロジェクトペインで、`src` => `main` を展開します。 +1. `scala` を右クリックし、**New** => **Scala class** を選択します。 +1. クラスに `CubeCalculator` と名前をつけて、**Kind** を `object` に変更し、**OK** をクリックします。 +1. コードを次の通り置き換えます。 + ``` + object CubeCalculator extends App { + def cube(x: Int) = { + x * x * x + } + } + ``` + +## テストを作成 +1. 左のプロジェクトペインで、`src` => `test` を展開します。 +1. `scala` を右クリックし、**New** => **Scala class** を選択します。 +1. クラスに `CubeCalculatorTest` と名前を付けて、**OK** をクリックします。 +1. コードを次の通り置き換えます。 + ``` + import org.scalatest.FunSuite + + class CubeCalculatorTest extends FunSuite { + test("CubeCalculator.cube") { + assert(CubeCalculator.cube(3) === 27) + } + } + ``` +1. `CubeCalculatorTest` のソースコード内で右クリックし、**Run 'CubeCalculatorTest'** を選択します。 + +## コードを理解 + +一行ずつ詳細に調べていきましょう。 + +* `class CubeCalculatorTest` は、オブジェクト `CubeCalculator` をテストすることを意味します。 +* `extends FunSuite` により、ScalaTest の FunSuite クラスの機能（例えば `test` 関数）が使えるようになります。 +* `test` は FunSuite から来た関数で、関数本体内のアサーションの結果を収集します。 +* `"CubeCalculator.cube"` は、テストの名前です。 + どんな名前でもよいですが、慣例のひとつは "ClassName.methodName" です。 +* `assert` は、真偽値の条件を1つ受けとり、そのテストが合格するか失敗するかを判断します。 +* `CubeCalculator.cube(3) === 27` は `cube` 関数の結果が実際に 27 であるかどうかを調べます。 + `===` は ScalaTest の一部であり、きれいなエラーメッセージを提供します。 + +## テストケースを追加する +1. 1つ目の `assert` 句のあとにもう1つの句を追加し、`0` の3乗をチェックします。 +1. `CubeCalculatorTest` を右クリックして 'Run **CubeCalculatorTest**' を選ぶことで、テストを再実行します。 + +## 結び +Scala コードのテスト方法のひとつを見ました。 +ScalaTest の FunSuite については[公式ウェブサイト](http://www.scalatest.org/getting_started_with_fun_suite)で詳しく学べます。 diff --git a/_ja/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md b/_ja/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md new file mode 100644 index 0000000000..e87db4bd38 --- /dev/null +++ b/_ja/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md @@ -0,0 +1,89 @@ +--- +title: コマンドラインの sbt で Scala を始める +layout: singlepage-overview +partof: getting-started-with-scala-and-sbt-on-the-command-line +language: ja +disqus: true +next-page: /ja/testing-scala-with-sbt-on-the-command-line +--- + +このチュートリアルでは、テンプレートから Scala プロジェクトを作成する方法を見ていきます。 +あなた自身のプロジェクトを始めるスタート地点として使えます。 +Scala のデファクトのビルドツール [sbt](http://www.scala-sbt.org/1.x/docs/index.html) を用います。 +sbt はあなたのプロジェクトに関連した様々なタスク、とりわけコンパイル、実行、テストをしてくれます。 +ターミナルの使い方を知っていることを前提とします。 + +## インストール +1. Java 8 JDK（別名 1.8）がインストールされていることを確認します。 + * コマンドラインで `javac -version` を実行し、`javac 1.8.___` と表示されるのを確認します。 + * バージョン 1.8 かそれ以上がなければ、[JDK をインストールします](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)。 +1. sbt をインストールします。 + * [Mac](http://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Mac.html) + * [Windows](http://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Windows.html) + * [Linux](http://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Linux.html) + +## プロジェクトを作成 +1. `cd` to an empty folder. +1. Run the following command `sbt new scala/hello-world.g8`. +This pulls the 'hello-world' template from GitHub. +It will also create a `target` folder, which you can ignore. +1. When prompted, name the application `hello-world`. This will +create a project called "hello-world". +1. Let's take a look at what just got generated: + +``` +- hello-world + - project (sbt uses this to install manage plugins and dependencies) + - build.properties + - src + - main + - scala (All of your scala code goes here) + -Main.scala (Entry point of program) <-- this is all we need for now + build.sbt (sbt's build definition file) +``` + +After you build your project, sbt will create more `target` directories +for generated files. You can ignore these. + +## Running the project +1. `cd` into `hello-world`. +1. Run `sbt`. This will open up the sbt console. +1. Type `~run`. The `~` is optional and causes sbt to re-run on every file save, +allowing for a fast edit/run/debug cycle. sbt will also generate a `target` directory +which you can ignore. + +## Modifying the code +1. Open the file `src/main/scala/Main.scala` in your favorite text editor. +1. Change "Hello, World!" to "Hello, New York!" +1. If you haven't stopped the sbt command, you should see "Hello, New York!" +printed to the console. +1. You can continue to make changes and see the results in the console. + +## Adding a dependency +Changing gears a bit, let's look at how to use published libraries to add +extra functionality to our apps. + +1. Open up `build.sbt` and add the following line: + +``` +libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % "1.1.0" +``` +Here, `libraryDependencies` is a set of dependencies, and by using `+=`, +we're adding the [scala-parser-combinators](https://github.com/scala/scala-parser-combinators) dependency to the set of dependencies that sbt will go +and fetch when it starts up. Now, in any Scala file, you can import classes, +objects, etc, from scala-parser-combinators with a regular import. + +You can find more published libraries on +[Scaladex](https://index.scala-lang.org/), the Scala library index, where you +can also copy the above dependency information for pasting into your `build.sbt` +file. + +## Next steps + +Continue to the next tutorial in the _getting started with sbt_ series, and learn about [testing Scala code with sbt in the command line](testing-scala-with-sbt-on-the-command-line.html). + +**or** + +- Continue learning Scala interactively online on + [Scala Exercises](https://www.scala-exercises.org/scala_tutorial). +- Learn about Scala's features in bite-sized pieces by stepping through our [Tour of Scala]({{ site.baseurl }}/tour/tour-of-scala.html). diff --git a/_ja/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md b/_ja/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md new file mode 100644 index 0000000000..0c2d7f1a42 --- /dev/null +++ b/_ja/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md @@ -0,0 +1,71 @@ +--- +title: コマンドラインで ScalaTest を使って Scala をテストする +layout: singlepage-overview +partof: testing-scala-with-sbt-on-the-command-line +language: ja +disqus: true +previous-page: /ja/getting-started-with-scala-and-sbt-on-the-command-line +--- + +Scala には複数のライブラリとテスト方法がありますが、このチュートリアルでは、ScalaTest フレームワークから [FunSuite](http://www.scalatest.org/getting_started_with_fun_suite) という人気のある選択肢を実演します。 + +[sbt での Scala プロジェクト作成方法](/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html)を知っている前提とします。 + +## セットアップ +1. コマンドラインで、どこかに新しいディレクトリを作成します。 +1. そのディレクトリに `cd` して、`sbt new scala/scalatest-example.g8` を実行します。 +1. プロジェクトに `ScalaTestTutorial` と名前を付けます。 +1. ScalaTest が依存関係として `build.sbt` ファイルに書かれたプロジェクトができます。. +1. そのディレクトリに `cd` して、`sbt test` を実行します。 + これは `CubeCalculator.cube` という1つのテストを含むテストスイート `CubeCalculatorTest` を実行します。 + +``` +sbt test +[info] Loading global plugins from /Users/username/.sbt/0.13/plugins +[info] Loading project definition from /Users/username/workspace/sandbox/my-something-project/project +[info] Set current project to scalatest-example (in build file:/Users/username/workspace/sandbox/my-something-project/) +[info] CubeCalculatorTest: +[info] - CubeCalculator.cube +[info] Run completed in 267 milliseconds. +[info] Total number of tests run: 1 +[info] Suites: completed 1, aborted 0 +[info] Tests: succeeded 1, failed 0, canceled 0, ignored 0, pending 0 +[info] All tests passed. +[success] Total time: 1 s, completed Feb 2, 2017 7:37:31 PM +``` + +## テストを理解 +1. テキストエディタで2つのファイルを開きます。 + * `src/main/scala/CubeCalculator.scala` + * `src/test/scala/CubeCalculatorTest.scala` +1. `CubeCalculator.scala` ファイルでは、関数 `cube` がどのように定義されているかが分かります。 +1. `CubeCalculatorTest.scala` ファイルでは、テスト対象オブジェクトにちなんで名前を付けられたクラスが見えます。 + +``` + import org.scalatest.FunSuite + + class CubeCalculatorTest extends FunSuite { + test("CubeCalculator.cube") { + assert(CubeCalculator.cube(3) === 27) + } + } +``` + +一行ずつ詳細に調べていきましょう。 + +* `class CubeCalculatorTest` は、オブジェクト `CubeCalculator` をテストすることを意味します。 +* `extends FunSuite` により、ScalaTest の FunSuite クラスの機能（例えば `test` 関数）が使えるようになります。 +* `test` は FunSuite から来た関数で、関数本体内のアサーションの結果を収集します。 +* `"CubeCalculator.cube"` は、テストの名前です。 + どんな名前でもよいですが、慣例のひとつは "ClassName.methodName" です。 +* `assert` は、真偽値の条件を1つ受けとり、そのテストが合格するか失敗するかを判断します。 +* `CubeCalculator.cube(3) === 27` は `cube` 関数の結果が実際に 27 であるかどうかを調べます。 + `===` は ScalaTest の一部であり、きれいなエラーメッセージを提供します。 + +## テストケースを追加する +1. 1つ目の `assert` 句のあとにもう1つの句を追加し、`0` の3乗をチェックします。 +1. `sbt test` を再び実行し、結果を見ます。 + +## 結び +Scala コードのテスト方法のひとつを見ました。 +ScalaTest の FunSuite については[公式ウェブサイト](http://www.scalatest.org/getting_started_with_fun_suite)で詳しく学べます。 diff --git a/_ja/getting-started.md b/_ja/getting-started.md new file mode 100644 index 0000000000..1f02d1588b --- /dev/null +++ b/_ja/getting-started.md @@ -0,0 +1,52 @@ +--- +layout: singlepage-overview +title: 入門 +partof: getting-started +language: ja +includeTOC: true +--- + +
    Scala の取り組み方で人々に好まれている主な方法は 2つ あります。
    + +1. IDE を使う +2. コマンドラインを使う + +以下のチュートリアルでは、どちらかお好みの方法をセットアップする一連のプロセスを通して行っていきます。 + +ですが、もし何もインストールせずに直接 Scala に飛び込んでみたければ、このページのガイドは飛ばして、以下をチェックしてみましょう。 + +* [scala-exercises.com での Scala のインタラクティブな導入](https://www.scala-exercises.org/scala_tutorial/terms_and_types) +* [Scastie](https://scastie.scala-lang.org/)。ブラウザで動く Scalaで、すべての Scala コンパイラと公開されたライブラリにアクセス可能。 + +## セットアップして Scala に入門 + +### IDE で取り組むのをお好みの場合 + +Intellij は、Scala 開発者にもっともよく使われている IDE です。 +このチュートリアルでは、Intellij をダウンロードして Scala プラグインをセットアップするまでを通して行い、それから初めての Scala プロジェクトを開始して、ユニットテストを完了させます！ + +* [Intellij で Scala を始める](/ja/getting-started-intellij-track/getting-started-with-scala-in-intellij.html) +* [Intellij で sbt を使って Scala プロジェクトをビルドする](/ja/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.html) +* [Intelij で ScalaTest を使って Scala をテストする](/ja/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.html) + + +### コマンドラインで取り組むのをお好みの場合 + +emacs、Vim、Atom、Sublime Text のようなテキストエディターの使用がお好みでしたら、Scala コードをコンパイル、テスト、実行する最良の方法は、**sbt**（Scala build tool） を使うことです。 + +* [コマンドラインの sbt で Scala を始める](/ja/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) +* [コマンドラインで ScalaTest を使って Scala をテストする](/ja/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.html) + +## 次のステップ + +このチュートリアルを終えたら、次をチェックしてみましょう。 + +* [Scala ツアー](/ja/tour/tour-of-scala.html)は、Scala の特徴を簡単に理解できるサイズで紹介します。 +* [学習リソース](/learn.html)（英語のみ）は、オンラインのインタラクティブなチュートリアルや教材を紹介します。 +* [Scala の人気書籍一覧](/books.html)（訳注：英語のみですが、邦訳されたものもあります）。 + +## 助けを求めるには + +他の Scala ユーザーとすばやくつながりたいとときには、メーリングリストやリアルタイムのチャットチャンネルがたくさんあります。 +こうしたリソースや助けを求められる場所を一覧できる [community](https://scala-lang.org/community/) ページをチェックしてみてください。 + diff --git a/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md b/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md index 021aed1bbf..860adfcc5f 100644 --- a/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md +++ b/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md @@ -1,6 +1,8 @@ --- title: Building a Scala Project with IntelliJ and sbt layout: singlepage-overview +partof: building-a-scala-project-with-intellij-and-sbt +languages: [ja] disqus: true previous-page: getting-started-intellij-track/getting-started-with-scala-in-intellij next-page: testing-scala-in-intellij-with-scalatest diff --git a/getting-started-intellij-track/getting-started-with-scala-in-intellij.md b/getting-started-intellij-track/getting-started-with-scala-in-intellij.md index 730f2e7f36..bfe19ca864 100644 --- a/getting-started-intellij-track/getting-started-with-scala-in-intellij.md +++ b/getting-started-intellij-track/getting-started-with-scala-in-intellij.md @@ -1,6 +1,8 @@ --- title: Getting Started with Scala in IntelliJ layout: singlepage-overview +partof: getting-started-with-scala-in-intellij +languages: [ja] disqus: true next-page: building-a-scala-project-with-intellij-and-sbt --- diff --git a/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md b/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md index 93a9574272..a517067bfc 100644 --- a/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -1,6 +1,8 @@ --- title: Testing Scala in IntelliJ with ScalaTest layout: singlepage-overview +partof: testing-scala-in-intellij-with-scalatest +languages: [ja] disqus: true previous-page: building-a-scala-project-with-intellij-and-sbt --- diff --git a/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md b/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md index 0c69c6595f..12dca3b8ba 100644 --- a/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md +++ b/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md @@ -1,6 +1,8 @@ --- title: Getting Started with Scala and sbt on the Command Line layout: singlepage-overview +partof: getting-started-with-scala-and-sbt-on-the-command-line +languages: [ja] disqus: true next-page: testing-scala-with-sbt-on-the-command-line --- diff --git a/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md b/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md index ba38a030ee..8c9d74b23b 100644 --- a/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md +++ b/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md @@ -1,6 +1,8 @@ --- title: Testing Scala with sbt and ScalaTest on the Command Line layout: singlepage-overview +partof: testing-scala-with-sbt-on-the-command-line +languages: [ja] disqus: true previous-page: getting-started-with-scala-and-sbt-on-the-command-line --- diff --git a/getting-started.md b/getting-started.md index fb392d5344..2808703712 100644 --- a/getting-started.md +++ b/getting-started.md @@ -1,6 +1,8 @@ --- layout: singlepage-overview title: Getting Started +partof: getting-started +languages: [ja] includeTOC: true --- From eade469c24073ad18fb1153485a34a3010cfdefe Mon Sep 17 00:00:00 2001 From: exoego Date: Sat, 20 Jul 2019 11:50:09 +0900 Subject: [PATCH 0616/3075] Update link to ja/getting-started --- _ja/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_ja/index.md b/_ja/index.md index 4f22939227..1cbc83b784 100644 --- a/_ja/index.md +++ b/_ja/index.md @@ -11,9 +11,9 @@ sections: - title: "最初のステップ" links: - title: "入門" - description: "あなたのコンピューターに Scala をインストールして、Scala コードを書きはじめよう！（英語のみ）" + description: "あなたのコンピューターに Scala をインストールして、Scala コードを書きはじめよう！" icon: "fa fa-rocket" - link: /getting-started.html + link: /ja/getting-started.html - title: "Scala ツアー" description: "コア言語機能をひと口大で紹介" icon: "fa fa-flag" From 988a18fc89efe2fd58e2a67e9780256b9576cd5a Mon Sep 17 00:00:00 2001 From: exoego Date: Sat, 20 Jul 2019 11:57:48 +0900 Subject: [PATCH 0617/3075] Move "Getting Started" and sub pages into collection, so that it site.documents finds them. --- _config.yml | 3 +++ _data/doc-nav-header.yml | 2 +- .../index.md | 18 ++++++++++-------- ...ng-a-scala-project-with-intellij-and-sbt.md | 6 ++++-- .../getting-started-with-scala-in-intellij.md | 2 ++ ...testing-scala-in-intellij-with-scalatest.md | 2 ++ ...d-with-scala-and-sbt-on-the-command-line.md | 2 ++ ...sting-scala-with-sbt-on-the-command-line.md | 2 ++ _includes/sidebar-toc-singlepage-overview.html | 2 +- .../index.md} | 10 +++++----- ...ng-a-scala-project-with-intellij-and-sbt.md | 4 ++-- .../getting-started-with-scala-in-intellij.md | 0 ...testing-scala-in-intellij-with-scalatest.md | 0 ...d-with-scala-and-sbt-on-the-command-line.md | 0 ...sting-scala-with-sbt-on-the-command-line.md | 2 +- _ja/index.md | 2 +- _overviews/scaladoc/generate.md | 2 +- 17 files changed, 37 insertions(+), 22 deletions(-) rename getting-started.md => _getting-started/index.md (70%) rename {getting-started-intellij-track => _getting-started/intellij-track}/building-a-scala-project-with-intellij-and-sbt.md (95%) rename {getting-started-intellij-track => _getting-started/intellij-track}/getting-started-with-scala-in-intellij.md (97%) rename {getting-started-intellij-track => _getting-started/intellij-track}/testing-scala-in-intellij-with-scalatest.md (97%) rename {getting-started-sbt-track => _getting-started/sbt-track}/getting-started-with-scala-and-sbt-on-the-command-line.md (97%) rename {getting-started-sbt-track => _getting-started/sbt-track}/testing-scala-with-sbt-on-the-command-line.md (97%) rename _ja/{getting-started.md => getting-started/index.md} (90%) rename _ja/{getting-started-intellij-track => getting-started/intellij-track}/building-a-scala-project-with-intellij-and-sbt.md (97%) rename _ja/{getting-started-intellij-track => getting-started/intellij-track}/getting-started-with-scala-in-intellij.md (100%) rename _ja/{getting-started-intellij-track => getting-started/intellij-track}/testing-scala-in-intellij-with-scalatest.md (100%) rename _ja/{getting-started-sbt-track => getting-started/sbt-track}/getting-started-with-scala-and-sbt-on-the-command-line.md (100%) rename _ja/{getting-started-sbt-track => getting-started/sbt-track}/testing-scala-with-sbt-on-the-command-line.md (98%) diff --git a/_config.yml b/_config.yml index 320c7a9839..b2c1f4ffa9 100644 --- a/_config.yml +++ b/_config.yml @@ -37,6 +37,9 @@ collections: permalink: /:collection/:path.html books: output: false + getting-started: + output: true + permalink: /:collection/:path.html ja: # Japanese translations output: true permalink: /:collection/:path.html diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index f7a4ff3ea2..f46ecfe93b 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -11,7 +11,7 @@ url: "#" submenu: - title: Getting Started - url: "/getting-started.html" + url: "/getting-started/index.html" - title: Tour of Scala url: "/tour/tour-of-scala.html" - title: Scala for Java Programmers diff --git a/getting-started.md b/_getting-started/index.md similarity index 70% rename from getting-started.md rename to _getting-started/index.md index 2808703712..2680e32d83 100644 --- a/getting-started.md +++ b/_getting-started/index.md @@ -4,6 +4,8 @@ title: Getting Started partof: getting-started languages: [ja] includeTOC: true + +redirect_from: "/getting-started.html" ---
    There are two main ways people prefer to work in Scala.
    @@ -33,9 +35,9 @@ we'll walk you through downloading and setting up IntelliJ with the Scala plugin, and we'll get you started with your first Scala project, complete with unit tests! -* [Getting Started with Scala in IntelliJ](getting-started-intellij-track/getting-started-with-scala-in-intellij.html) -* [Building a Scala Project with IntelliJ and sbt](getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.html) -* [Testing Scala in IntelliJ with ScalaTest](getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.html) +* [Getting Started with Scala in IntelliJ](/getting-started/intellij-track/getting-started-with-scala-in-intellij.html) +* [Building a Scala Project with IntelliJ and sbt](/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.html) +* [Testing Scala in IntelliJ with ScalaTest](/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.html) ### If you prefer working on the command line... @@ -44,8 +46,8 @@ If you prefer using a text editor like emacs, Vim, Atom, or Sublime Text, then the best way to compile, test, and run Scala code is using _sbt_, Scala's build tool. -* [Getting Started with Scala and sbt on the Command Line](getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) -* [Testing Scala with sbt and ScalaTest on the Command Line](getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.html) +* [Getting Started with Scala and sbt on the Command Line](/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) +* [Testing Scala with sbt and ScalaTest on the Command Line](/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.html) ## Next Steps Once you've finished these tutorials, check out -* [The Tour of Scala](tour/tour-of-scala.html) for bite-sized introductions to Scala's features. -* [Learning Resources](learn.html), which includes online interactive tutorials and courses. -* [Our list of some popular Scala books](books.html). +* [The Tour of Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. +* [Learning Resources](/learn.html), which includes online interactive tutorials and courses. +* [Our list of some popular Scala books](/books.html). ## Getting Help There are a multitude of mailing lists and real-time chat channels in case you want to quickly connect with other Scala users. Check out our [community](https://scala-lang.org/community/) page a list of these resources and where to reach out for help. diff --git a/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md b/_getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md similarity index 95% rename from getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md rename to _getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md index 860adfcc5f..622ebc61fd 100644 --- a/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.md +++ b/_getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md @@ -4,8 +4,10 @@ layout: singlepage-overview partof: building-a-scala-project-with-intellij-and-sbt languages: [ja] disqus: true -previous-page: getting-started-intellij-track/getting-started-with-scala-in-intellij +previous-page: getting-started/intellij-track/getting-started-with-scala-in-intellij next-page: testing-scala-in-intellij-with-scalatest + +redirect_from: "/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.html" --- In this tutorial, we'll see how to build a Scala project using [sbt](http://www.scala-sbt.org/1.x/docs/index.html). sbt is a popular tool for compiling, running, and testing Scala projects of any @@ -17,7 +19,7 @@ or more than one code file. ## Creating the project In this section, we'll show you how to create the project in IntelliJ. However, if you're comfortable with the command line, we recommend you try [Getting -Started with Scala and sbt on the Command Line]({{site.baseurl}}/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) and then come back +Started with Scala and sbt on the Command Line]({{site.baseurl}}/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) and then come back here to the section "Writing Scala code". 1. If you didn't create the project from the command line, open up IntelliJ and select "Create New Project" diff --git a/getting-started-intellij-track/getting-started-with-scala-in-intellij.md b/_getting-started/intellij-track/getting-started-with-scala-in-intellij.md similarity index 97% rename from getting-started-intellij-track/getting-started-with-scala-in-intellij.md rename to _getting-started/intellij-track/getting-started-with-scala-in-intellij.md index bfe19ca864..a4544a707e 100644 --- a/getting-started-intellij-track/getting-started-with-scala-in-intellij.md +++ b/_getting-started/intellij-track/getting-started-with-scala-in-intellij.md @@ -5,6 +5,8 @@ partof: getting-started-with-scala-in-intellij languages: [ja] disqus: true next-page: building-a-scala-project-with-intellij-and-sbt + +redirect_from: "/getting-started-intellij-track/getting-started-with-scala-in-intellij.html" --- In this tutorial, we'll see how to build a minimal Scala project using IntelliJ diff --git a/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md b/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md similarity index 97% rename from getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md rename to _getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index a517067bfc..bf895167e2 100644 --- a/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -5,6 +5,8 @@ partof: testing-scala-in-intellij-with-scalatest languages: [ja] disqus: true previous-page: building-a-scala-project-with-intellij-and-sbt + +redirect_from: "/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.html" --- There are multiple libraries and testing methodologies for Scala, diff --git a/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md b/_getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md similarity index 97% rename from getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md rename to _getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md index 12dca3b8ba..64c6fdb5fa 100644 --- a/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md +++ b/_getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md @@ -5,6 +5,8 @@ partof: getting-started-with-scala-and-sbt-on-the-command-line languages: [ja] disqus: true next-page: testing-scala-with-sbt-on-the-command-line + +redirect_from: "/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html" --- In this tutorial, you'll see how to create a Scala project from diff --git a/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md b/_getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md similarity index 97% rename from getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md rename to _getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md index 8c9d74b23b..9a3d4507b9 100644 --- a/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.md +++ b/_getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md @@ -5,6 +5,8 @@ partof: testing-scala-with-sbt-on-the-command-line languages: [ja] disqus: true previous-page: getting-started-with-scala-and-sbt-on-the-command-line + +redirect_from: "/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.html" --- There are multiple libraries and testing methodologies for Scala, diff --git a/_includes/sidebar-toc-singlepage-overview.html b/_includes/sidebar-toc-singlepage-overview.html index d8fa5c3ede..bcea6a8911 100644 --- a/_includes/sidebar-toc-singlepage-overview.html +++ b/_includes/sidebar-toc-singlepage-overview.html @@ -15,7 +15,7 @@
    Contents
    {% elsif page.language %} {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} - {% assign engPg = site.overviews | where: 'partof', page.partof | first %} + {% assign engPg = site.documents | where: 'partof', page.partof | first %}
    {% endfor %} diff --git a/_sass/layout/overviews.scss b/_sass/layout/overviews.scss index 930502116b..39058ef40f 100644 --- a/_sass/layout/overviews.scss +++ b/_sass/layout/overviews.scss @@ -47,12 +47,10 @@ position: relative; flex: 0 1 calc(50% - 1em); margin-bottom: 2em; - transition: max-height .3s ease-out; text-decoration: none; border-radius: 2px; box-shadow: 0 1px 3px 0 rgba(0,0,0,.2), 0 1px 1px 0 rgba(0,0,0,.14), 0 2px 1px -1px rgba(0,0,0,.12); background: #fff; - max-height: 400px; overflow: hidden; @include bp(medium) { @@ -76,7 +74,7 @@ .card-content { padding: 20px; padding-top: 0px; - padding-bottom: 0px; + padding-bottom: 60px; } h2 { @@ -160,25 +158,23 @@ position: absolute; bottom: 0; width: 100%; - padding: 20px; - height: 66px; - background: #fff; - border-top: 1px solid lighten($base-font-color-light, 35%); - - &:hover { - cursor: pointer; - background: $brand-primary; - .expand-btn, - .go-btn { - color: #fff; - } - } - .expand-btn, .go-btn { - color: lighten($base-font-color-light, 15%); + display: block; + padding: 20px; + height: 66px; + background: #fff; + border-top: 1px solid lighten($base-font-color-light, 35%); + color: lighten($base-font-color-light, 10%); font-weight: $font-regular; font-size: $font-regular; + text-decoration: none; + + &:hover { + cursor: pointer; + background: $brand-primary; + color: #fff; + } } } } diff --git a/resources/js/functions.js b/resources/js/functions.js index 3d7ff70428..046ec1a7f5 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -133,30 +133,6 @@ $(document).ready(function() { return false; }; - - $('.white-card').each(function(index) { - if (!$(this).hasOverflow()) { - $(this).find(".expand-btn").hide(); - $(this).find(".go-btn").show(); - } - }); - - $(".card-footer").click(function() { - // if we clicked on the expand button, expand the box - if ($(this).find(".expand-btn").is(':visible')) { - - // height mangling becasue flexbox align-self: self-end; doesn't work :( - $(this).parent().css('max-height', 'none'); - var cardWrapHeight = $(this).parent().find(".card-wrap").outerHeight(); - var cardFooterHeight = $(this).outerHeight() - $(this).parent().outerHeight(cardWrapHeight + cardFooterHeight); - - $(this).find(".expand-btn").hide(); - $(this).find(".go-btn").show(); - } else { - window.location.href = $(this).find(".go-btn").attr("href"); - } - }); }); From ad9ccd05ee688afba00c1f9181e6dedb51737271 Mon Sep 17 00:00:00 2001 From: exoego Date: Mon, 22 Jul 2019 14:03:51 +0900 Subject: [PATCH 0620/3075] Add subtitle so user/crawler know the group the page belongs to. --- _includes/headertop.html | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/_includes/headertop.html b/_includes/headertop.html index e39ab97d51..de2b123d50 100644 --- a/_includes/headertop.html +++ b/_includes/headertop.html @@ -1,7 +1,11 @@ - {% if page.title %}{{ page.title }} | {% endif %}{{ site.title }} + + {% if page.title %}{{ page.title }} | {% endif %} + {% if page.overview-name %}{{ page.overview-name }} | {% endif %} + {{ site.title }} + {% if page.description %} {% endif %} From 290ac29e58b5809e4326060f3036f9b262cdea0c Mon Sep 17 00:00:00 2001 From: wooruang Date: Tue, 23 Jul 2019 07:43:42 +0900 Subject: [PATCH 0621/3075] Translate tuples.md and Modify the 'num' of elements in tour docs (#1403) --- _ko/tour/case-classes.md | 2 +- _ko/tour/higher-order-functions.md | 2 +- _ko/tour/mixin-class-composition.md | 2 +- _ko/tour/multiple-parameter-lists.md | 2 +- _ko/tour/nested-functions.md | 2 +- _ko/tour/pattern-matching.md | 2 +- _ko/tour/singleton-objects.md | 2 +- _ko/tour/tuples.md | 74 ++++++++++++++++++++++++++-- 8 files changed, 77 insertions(+), 11 deletions(-) diff --git a/_ko/tour/case-classes.md b/_ko/tour/case-classes.md index 6d32c6bac2..5823edd55f 100644 --- a/_ko/tour/case-classes.md +++ b/_ko/tour/case-classes.md @@ -6,7 +6,7 @@ discourse: false partof: scala-tour -num: 10 +num: 11 language: ko next-page: pattern-matching diff --git a/_ko/tour/higher-order-functions.md b/_ko/tour/higher-order-functions.md index 40adfba248..cfd1decc91 100644 --- a/_ko/tour/higher-order-functions.md +++ b/_ko/tour/higher-order-functions.md @@ -6,7 +6,7 @@ discourse: false partof: scala-tour -num: 7 +num: 8 language: ko next-page: nested-functions diff --git a/_ko/tour/mixin-class-composition.md b/_ko/tour/mixin-class-composition.md index e4d2cac40f..0f6f1b8a54 100644 --- a/_ko/tour/mixin-class-composition.md +++ b/_ko/tour/mixin-class-composition.md @@ -6,7 +6,7 @@ discourse: false partof: scala-tour -num: 6 +num: 7 language: ko next-page: higher-order-functions diff --git a/_ko/tour/multiple-parameter-lists.md b/_ko/tour/multiple-parameter-lists.md index 03d6e171ec..49d514be94 100644 --- a/_ko/tour/multiple-parameter-lists.md +++ b/_ko/tour/multiple-parameter-lists.md @@ -6,7 +6,7 @@ discourse: false partof: scala-tour -num: 9 +num: 10 language: ko next-page: case-classes diff --git a/_ko/tour/nested-functions.md b/_ko/tour/nested-functions.md index 9f55347977..8d9126e7ce 100644 --- a/_ko/tour/nested-functions.md +++ b/_ko/tour/nested-functions.md @@ -6,7 +6,7 @@ discourse: false partof: scala-tour -num: 8 +num: 9 language: ko next-page: multiple-parameter-lists diff --git a/_ko/tour/pattern-matching.md b/_ko/tour/pattern-matching.md index 9be1ac47e4..64063ee003 100644 --- a/_ko/tour/pattern-matching.md +++ b/_ko/tour/pattern-matching.md @@ -6,7 +6,7 @@ discourse: false partof: scala-tour -num: 11 +num: 12 language: ko next-page: singleton-objects diff --git a/_ko/tour/singleton-objects.md b/_ko/tour/singleton-objects.md index daff154256..339d05fc1a 100644 --- a/_ko/tour/singleton-objects.md +++ b/_ko/tour/singleton-objects.md @@ -6,7 +6,7 @@ discourse: false partof: scala-tour -num: 12 +num: 13 language: ko next-page: regular-expression-patterns diff --git a/_ko/tour/tuples.md b/_ko/tour/tuples.md index 4463425bee..476aa69d6b 100644 --- a/_ko/tour/tuples.md +++ b/_ko/tour/tuples.md @@ -1,17 +1,83 @@ --- layout: tour -title: Tuples +title: 튜플 discourse: true partof: scala-tour -num: + +num: 6 language: ko next-page: mixin-class-composition previous-page: traits +topics: tuples +redirect_from: "/tutorials/tour/tuples.html" --- -(this section of the tour has not been translated yet. pull request -with translation welcome!) \ No newline at end of file +스칼라에서 튜플은 정해진 요소(element)를 가지는 값으로 각 요소는 고유한 타입을 가진다. 튜플은 불변적이다. + +튜플은 특히 메소드로부터 여러개의 값을 리턴하는데 편리하게 사용할 수 있다. + +두개의 엘리먼트를 갖는 튜플은 다음과 같이 생성할 수 있다: + +```tut +val ingredient = ("Sugar" , 25) +``` + +위 코드는 `String`과 `Int` 엘리먼트를 포함하는 튜플을 생성한다. + +`ingredient`의 추론된 타입은 `Tuple2[String, Int]`의 약칭인 `(String, Int)`이다. + +튜플들을 나타내기 위해서 Scala에서는 다음과 같은 형태의 클래스들을 사용한다: `Tuple2`, `Tuple3`, ... ,`Tuple22`. +각 클래스는 파라미터 타입의 갯수 만큼 엘리먼트들을 가지고 있다. + +## 엘리먼트 접근하기 + +튜플의 엘리먼트에 접근하기 위한 한가지 방법은 위치로 접근하는 것이다. 각 요소들은 `_1`, `_2`, ... 와 같은 이름을 갖는다. + +```tut +println(ingredient._1) // Sugar +println(ingredient._2) // 25 +``` + +## 튜플에서의 패턴 매칭 + +하나의 튜플은 패턴 매칭을 사용하여 분리할 수 있다: + +```tut +val (name, quantity) = ingredient +println(name) // Sugar +println(quantity) // 25 +``` + +여기에서 `name`의 추론된 타입은 `String`이고 `quantity`의 추론된 타입은 `Int`이다. + +여기 튜플을 패턴 매칭한 또 다른 예제가 있다: + +```tut +val planets = + List(("Mercury", 57.9), ("Venus", 108.2), ("Earth", 149.6), + ("Mars", 227.9), ("Jupiter", 778.3)) +planets.foreach{ + case ("Earth", distance) => + println(s"Our planet is $distance million kilometers from the sun") + case _ => +} +``` + +또는 `for` comprehension에서: + +```tut +val numPairs = List((2, 5), (3, -7), (20, 56)) +for ((a, b) <- numPairs) { + println(a * b) +} +``` + +## 튜플과 케이스 클래스 + +때로는 튜플과 케이스 클래스 중 무엇을 사용할지 힘들 수 있다. 케이스 클래스는 이름이 있는 엘리먼트들을 갖는다. 그 엘리먼트의 이름들은 어떤 종류의 코드에서 가독성을 높일 수 있다. 위의 planet 예제에서 우리는 튜플을 사용하는 것보다 `case class Planet(name: String, distance: Double)`로 정의 하는 것이 더 나을 수도 있다. + +이한샘 옮김 From f3cde7e6ee36b56b1d9af7c2a13622b8f00ccc48 Mon Sep 17 00:00:00 2001 From: exoego Date: Mon, 22 Jul 2019 13:44:52 +0900 Subject: [PATCH 0622/3075] Mark older Overviews/Collections --- _overviews/collections/arrays.md | 2 +- _overviews/collections/concrete-immutable-collection-classes.md | 2 +- _overviews/collections/concrete-mutable-collection-classes.md | 2 +- .../conversions-between-java-and-scala-collections.md | 2 +- _overviews/collections/creating-collections-from-scratch.md | 2 +- _overviews/collections/equality.md | 2 +- _overviews/collections/introduction.md | 2 +- _overviews/collections/iterators.md | 2 +- _overviews/collections/maps.md | 2 +- _overviews/collections/migrating-from-scala-27.md | 2 +- _overviews/collections/overview.md | 2 +- _overviews/collections/performance-characteristics.md | 2 +- _overviews/collections/seqs.md | 2 +- _overviews/collections/sets.md | 2 +- _overviews/collections/strings.md | 2 +- _overviews/collections/trait-iterable.md | 2 +- _overviews/collections/trait-traversable.md | 2 +- _overviews/collections/views.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/_overviews/collections/arrays.md b/_overviews/collections/arrays.md index 343ebb1c74..bce565ea14 100644 --- a/_overviews/collections/arrays.md +++ b/_overviews/collections/arrays.md @@ -5,7 +5,7 @@ title: Arrays discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 10 diff --git a/_overviews/collections/concrete-immutable-collection-classes.md b/_overviews/collections/concrete-immutable-collection-classes.md index b0e16eceb7..3f1fad4378 100644 --- a/_overviews/collections/concrete-immutable-collection-classes.md +++ b/_overviews/collections/concrete-immutable-collection-classes.md @@ -5,7 +5,7 @@ title: Concrete Immutable Collection Classes discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 8 diff --git a/_overviews/collections/concrete-mutable-collection-classes.md b/_overviews/collections/concrete-mutable-collection-classes.md index 432eb6df9f..2e7e94e988 100644 --- a/_overviews/collections/concrete-mutable-collection-classes.md +++ b/_overviews/collections/concrete-mutable-collection-classes.md @@ -5,7 +5,7 @@ title: Concrete Mutable Collection Classes discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 9 diff --git a/_overviews/collections/conversions-between-java-and-scala-collections.md b/_overviews/collections/conversions-between-java-and-scala-collections.md index 7d1f3d150a..7c7323125c 100644 --- a/_overviews/collections/conversions-between-java-and-scala-collections.md +++ b/_overviews/collections/conversions-between-java-and-scala-collections.md @@ -5,7 +5,7 @@ title: Conversions Between Java and Scala Collections discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 17 diff --git a/_overviews/collections/creating-collections-from-scratch.md b/_overviews/collections/creating-collections-from-scratch.md index cdff42e054..d21c13d710 100644 --- a/_overviews/collections/creating-collections-from-scratch.md +++ b/_overviews/collections/creating-collections-from-scratch.md @@ -5,7 +5,7 @@ title: Creating Collections From Scratch discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 16 diff --git a/_overviews/collections/equality.md b/_overviews/collections/equality.md index 0e41a5ccd9..08a8d110eb 100644 --- a/_overviews/collections/equality.md +++ b/_overviews/collections/equality.md @@ -5,7 +5,7 @@ title: Equality discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 13 diff --git a/_overviews/collections/introduction.md b/_overviews/collections/introduction.md index e026efafaa..c480affa85 100644 --- a/_overviews/collections/introduction.md +++ b/_overviews/collections/introduction.md @@ -5,7 +5,7 @@ title: Introduction discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 1 diff --git a/_overviews/collections/iterators.md b/_overviews/collections/iterators.md index 975824d498..02a41f1ed0 100644 --- a/_overviews/collections/iterators.md +++ b/_overviews/collections/iterators.md @@ -5,7 +5,7 @@ title: Iterators discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 15 diff --git a/_overviews/collections/maps.md b/_overviews/collections/maps.md index 89a0663914..d7291dc6cb 100644 --- a/_overviews/collections/maps.md +++ b/_overviews/collections/maps.md @@ -5,7 +5,7 @@ title: Maps discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 7 diff --git a/_overviews/collections/migrating-from-scala-27.md b/_overviews/collections/migrating-from-scala-27.md index 87f557ca4f..939ef0987c 100644 --- a/_overviews/collections/migrating-from-scala-27.md +++ b/_overviews/collections/migrating-from-scala-27.md @@ -5,7 +5,7 @@ title: Migrating from Scala 2.7 discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 18 diff --git a/_overviews/collections/overview.md b/_overviews/collections/overview.md index 41bdf6ff39..b4c73e0567 100644 --- a/_overviews/collections/overview.md +++ b/_overviews/collections/overview.md @@ -5,7 +5,7 @@ title: Mutable and Immutable Collections discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 2 diff --git a/_overviews/collections/performance-characteristics.md b/_overviews/collections/performance-characteristics.md index c43aeabb68..e6e1e92537 100644 --- a/_overviews/collections/performance-characteristics.md +++ b/_overviews/collections/performance-characteristics.md @@ -5,7 +5,7 @@ title: Performance Characteristics discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 12 diff --git a/_overviews/collections/seqs.md b/_overviews/collections/seqs.md index 3e12de6fc1..a932a8ce4b 100644 --- a/_overviews/collections/seqs.md +++ b/_overviews/collections/seqs.md @@ -5,7 +5,7 @@ title: The sequence traits Seq, IndexedSeq, and LinearSeq discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 5 diff --git a/_overviews/collections/sets.md b/_overviews/collections/sets.md index 4b06a0501f..d93a03acad 100644 --- a/_overviews/collections/sets.md +++ b/_overviews/collections/sets.md @@ -5,7 +5,7 @@ title: Sets discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 6 diff --git a/_overviews/collections/strings.md b/_overviews/collections/strings.md index b1729328de..058fb8b281 100644 --- a/_overviews/collections/strings.md +++ b/_overviews/collections/strings.md @@ -5,7 +5,7 @@ title: Strings discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 11 diff --git a/_overviews/collections/trait-iterable.md b/_overviews/collections/trait-iterable.md index e478f3d4d7..f8f0bf7763 100644 --- a/_overviews/collections/trait-iterable.md +++ b/_overviews/collections/trait-iterable.md @@ -5,7 +5,7 @@ title: Trait Iterable discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 4 diff --git a/_overviews/collections/trait-traversable.md b/_overviews/collections/trait-traversable.md index fe048347ec..a954246f99 100644 --- a/_overviews/collections/trait-traversable.md +++ b/_overviews/collections/trait-traversable.md @@ -5,7 +5,7 @@ title: Trait Traversable discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 3 diff --git a/_overviews/collections/views.md b/_overviews/collections/views.md index 09e5b8f7ff..2a7f90c929 100644 --- a/_overviews/collections/views.md +++ b/_overviews/collections/views.md @@ -5,7 +5,7 @@ title: Views discourse: true partof: collections -overview-name: Collections +overview-name: Collections (Scala 2.8 - 2.12) num: 14 From 06213510180fc9c12d9163d5498127095ceb5195 Mon Sep 17 00:00:00 2001 From: exoego Date: Mon, 22 Jul 2019 13:45:23 +0900 Subject: [PATCH 0623/3075] Add a link to newer version of collections. --- _overviews/collections/arrays.md | 5 +++++ .../collections/concrete-immutable-collection-classes.md | 5 +++++ .../collections/concrete-mutable-collection-classes.md | 5 +++++ .../conversions-between-java-and-scala-collections.md | 5 +++++ _overviews/collections/creating-collections-from-scratch.md | 5 +++++ _overviews/collections/equality.md | 5 +++++ _overviews/collections/introduction.md | 5 +++++ _overviews/collections/iterators.md | 5 +++++ _overviews/collections/maps.md | 5 +++++ _overviews/collections/migrating-from-scala-27.md | 5 +++++ _overviews/collections/overview.md | 5 +++++ _overviews/collections/performance-characteristics.md | 5 +++++ _overviews/collections/seqs.md | 5 +++++ _overviews/collections/sets.md | 5 +++++ _overviews/collections/strings.md | 5 +++++ _overviews/collections/trait-iterable.md | 5 +++++ _overviews/collections/trait-traversable.md | 5 +++++ _overviews/collections/views.md | 6 ++++++ _sass/layout/documentation.scss | 5 +++++ 19 files changed, 96 insertions(+) diff --git a/_overviews/collections/arrays.md b/_overviews/collections/arrays.md index bce565ea14..382af6a839 100644 --- a/_overviews/collections/arrays.md +++ b/_overviews/collections/arrays.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + [Array](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/Array.html) is a special kind of collection in Scala. On the one hand, Scala arrays correspond one-to-one to Java arrays. That is, a Scala array `Array[Int]` is represented as a Java `int[]`, an `Array[Double]` is represented as a Java `double[]` and a `Array[String]` is represented as a Java `String[]`. But at the same time, Scala arrays offer much more than their Java analogues. First, Scala arrays can be _generic_. That is, you can have an `Array[T]`, where `T` is a type parameter or abstract type. Second, Scala arrays are compatible with Scala sequences - you can pass an `Array[T]` where a `Seq[T]` is required. Finally, Scala arrays also support all sequence operations. Here's an example of this in action: scala> val a1 = Array(1, 2, 3) diff --git a/_overviews/collections/concrete-immutable-collection-classes.md b/_overviews/collections/concrete-immutable-collection-classes.md index 3f1fad4378..8e7e74d6f8 100644 --- a/_overviews/collections/concrete-immutable-collection-classes.md +++ b/_overviews/collections/concrete-immutable-collection-classes.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + Scala provides many concrete immutable collection classes for you to choose from. They differ in the traits they implement (maps, sets, sequences), whether they can be infinite, and the speed of various operations. Here are some of the most common immutable collection types used in Scala. ## Lists diff --git a/_overviews/collections/concrete-mutable-collection-classes.md b/_overviews/collections/concrete-mutable-collection-classes.md index 2e7e94e988..404a1715ee 100644 --- a/_overviews/collections/concrete-mutable-collection-classes.md +++ b/_overviews/collections/concrete-mutable-collection-classes.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + You've now seen the most commonly used immutable collection classes that Scala provides in its standard library. Take a look now at the mutable collection classes. ## Array Buffers diff --git a/_overviews/collections/conversions-between-java-and-scala-collections.md b/_overviews/collections/conversions-between-java-and-scala-collections.md index 7c7323125c..cb9675fae0 100644 --- a/_overviews/collections/conversions-between-java-and-scala-collections.md +++ b/_overviews/collections/conversions-between-java-and-scala-collections.md @@ -13,6 +13,11 @@ languages: [zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + Like Scala, Java also has a rich collections library. There are many similarities between the two. For instance, both libraries know iterators, iterables, sets, maps, and sequences. But there are also important differences. In particular, the Scala libraries put much more emphasis on immutable collections, and provide many more operations that transform a collection into a new one. Sometimes you might need to pass from one collection framework to the other. For instance, you might want to access an existing Java collection as if it were a Scala collection. Or you might want to pass one of Scala's collections to a Java method that expects its Java counterpart. It is quite easy to do this, because Scala offers implicit conversions between all the major collection types in the [JavaConverters](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/JavaConverters$.html) object. In particular, you will find bidirectional conversions between the following types. diff --git a/_overviews/collections/creating-collections-from-scratch.md b/_overviews/collections/creating-collections-from-scratch.md index d21c13d710..22c07d2016 100644 --- a/_overviews/collections/creating-collections-from-scratch.md +++ b/_overviews/collections/creating-collections-from-scratch.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + You have syntax `List(1, 2, 3)` to create a list of three integers and `Map('A' -> 1, 'C' -> 2)` to create a map with two bindings. This is actually a universal feature of Scala collections. You can take any collection name and follow it by a list of elements in parentheses. The result will be a new collection with the given elements. Here are some more examples: Traversable() // An empty traversable object diff --git a/_overviews/collections/equality.md b/_overviews/collections/equality.md index 08a8d110eb..1bded6008e 100644 --- a/_overviews/collections/equality.md +++ b/_overviews/collections/equality.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + The collection libraries have a uniform approach to equality and hashing. The idea is, first, to divide collections into sets, maps, and sequences. Collections in different categories are always unequal. For instance, `Set(1, 2, 3)` is unequal to `List(1, 2, 3)` even though they contain the same elements. On the other hand, within the same category, collections are equal if and only if they have the same elements (for sequences: the same elements in the same order). For example, `List(1, 2, 3) == Vector(1, 2, 3)`, and `HashSet(1, 2) == TreeSet(2, 1)`. It does not matter for the equality check whether a collection is mutable or immutable. For a mutable collection one simply considers its current elements at the time the equality test is performed. This means that a mutable collection might be equal to different collections at different times, depending what elements are added or removed. This is a potential trap when using a mutable collection as a key in a hashmap. Example: diff --git a/_overviews/collections/introduction.md b/_overviews/collections/introduction.md index c480affa85..23136be5ec 100644 --- a/_overviews/collections/introduction.md +++ b/_overviews/collections/introduction.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn, ru] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + **Martin Odersky, and Lex Spoon** In the eyes of many, the new collections framework is the most significant diff --git a/_overviews/collections/iterators.md b/_overviews/collections/iterators.md index 02a41f1ed0..c273f87c12 100644 --- a/_overviews/collections/iterators.md +++ b/_overviews/collections/iterators.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + An iterator is not a collection, but rather a way to access the elements of a collection one by one. The two basic operations on an iterator `it` are `next` and `hasNext`. A call to `it.next()` will return the next element of the iterator and advance the state of the iterator. Calling `next` again on the same iterator will then yield the element one beyond the one returned previously. If there are no more elements to return, a call to `next` will throw a `NoSuchElementException`. You can find out whether there are more elements to return using [Iterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html)'s `hasNext` method. The most straightforward way to "step through" all the elements returned by an iterator `it` uses a while-loop: diff --git a/_overviews/collections/maps.md b/_overviews/collections/maps.md index d7291dc6cb..6ba3b480b4 100644 --- a/_overviews/collections/maps.md +++ b/_overviews/collections/maps.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + A [Map](http://www.scala-lang.org/api/current/scala/collection/Map.html) is an [Iterable](http://www.scala-lang.org/api/current/scala/collection/Iterable.html) consisting of pairs of keys and values (also named _mappings_ or _associations_). Scala's [Predef](http://www.scala-lang.org/api/current/scala/Predef$.html) object offers an implicit conversion that lets you write `key -> value` as an alternate syntax for the pair `(key, value)`. For instance `Map("x" -> 24, "y" -> 25, "z" -> 26)` means exactly the same as `Map(("x", 24), ("y", 25), ("z", 26))`, but reads better. The fundamental operations on maps are similar to those on sets. They are summarized in the following table and fall into the following categories: diff --git a/_overviews/collections/migrating-from-scala-27.md b/_overviews/collections/migrating-from-scala-27.md index 939ef0987c..56760c67f9 100644 --- a/_overviews/collections/migrating-from-scala-27.md +++ b/_overviews/collections/migrating-from-scala-27.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + Porting your existing Scala applications to use the new collections should be almost automatic. There are only a couple of possible issues to take care of. Generally, the old functionality of Scala 2.7 collections has been left in place. Some features have been deprecated, which means they will removed in some future release. You will get a _deprecation warning_ when you compile code that makes use of these features in Scala 2.8. In a few places deprecation was unfeasible, because the operation in question was retained in 2.8, but changed in meaning or performance characteristics. These cases will be flagged with _migration warnings_ when compiled under 2.8. To get full deprecation and migration warnings with suggestions how to change your code, pass the `-deprecation` and `-Xmigration` flags to `scalac` (note that `-Xmigration` is an extended option, so it starts with an `X`). You can also pass the same options to the `scala` REPL to get the warnings in an interactive session. Example: diff --git a/_overviews/collections/overview.md b/_overviews/collections/overview.md index b4c73e0567..cc46a849ba 100644 --- a/_overviews/collections/overview.md +++ b/_overviews/collections/overview.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + Scala collections systematically distinguish between mutable and immutable collections. A _mutable_ collection can be updated or extended in place. This means you can change, add, or remove elements diff --git a/_overviews/collections/performance-characteristics.md b/_overviews/collections/performance-characteristics.md index e6e1e92537..96cbacbe59 100644 --- a/_overviews/collections/performance-characteristics.md +++ b/_overviews/collections/performance-characteristics.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + The previous explanations have made it clear that different collection types have different performance characteristics. That's often the primary reason for picking one collection type over another. You can see the performance characteristics of some common operations on collections summarized in the following two tables. Performance characteristics of sequence types: diff --git a/_overviews/collections/seqs.md b/_overviews/collections/seqs.md index a932a8ce4b..17aa7f708b 100644 --- a/_overviews/collections/seqs.md +++ b/_overviews/collections/seqs.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + The [Seq](http://www.scala-lang.org/api/current/scala/collection/Seq.html) trait represents sequences. A sequence is a kind of iterable that has a `length` and whose elements have fixed index positions, starting from `0`. The operations on sequences, summarized in the table below, fall into the following categories: diff --git a/_overviews/collections/sets.md b/_overviews/collections/sets.md index d93a03acad..85d21f3c28 100644 --- a/_overviews/collections/sets.md +++ b/_overviews/collections/sets.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + `Set`s are `Iterable`s that contain no duplicate elements. The operations on sets are summarized in the following table for general sets and in the table after that for mutable sets. They fall into the following categories: * **Tests** `contains`, `apply`, `subsetOf`. The `contains` method asks whether a set contains a given element. The `apply` method for a set is the same as `contains`, so `set(elem)` is the same as `set contains elem`. That means sets can also be used as test functions that return true for the elements they contain. diff --git a/_overviews/collections/strings.md b/_overviews/collections/strings.md index 058fb8b281..a6545dbf6a 100644 --- a/_overviews/collections/strings.md +++ b/_overviews/collections/strings.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + Like arrays, strings are not directly sequences, but they can be converted to them, and they also support all sequence operations on strings. Here are some examples of operations you can invoke on strings. scala> val str = "hello" diff --git a/_overviews/collections/trait-iterable.md b/_overviews/collections/trait-iterable.md index f8f0bf7763..b708c251f5 100644 --- a/_overviews/collections/trait-iterable.md +++ b/_overviews/collections/trait-iterable.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + The next trait from the top in the collections hierarchy is `Iterable`. All methods in this trait are defined in terms of an abstract method, `iterator`, which yields the collection's elements one by one. The `foreach` method from trait `Traversable` is implemented in `Iterable` in terms of `iterator`. Here is the actual implementation: def foreach[U](f: Elem => U): Unit = { diff --git a/_overviews/collections/trait-traversable.md b/_overviews/collections/trait-traversable.md index a954246f99..010a74fedb 100644 --- a/_overviews/collections/trait-traversable.md +++ b/_overviews/collections/trait-traversable.md @@ -13,6 +13,11 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + At the top of the collection hierarchy is trait `Traversable`. Its only abstract operation is `foreach`: def foreach[U](f: Elem => U) diff --git a/_overviews/collections/views.md b/_overviews/collections/views.md index 2a7f90c929..4968547708 100644 --- a/_overviews/collections/views.md +++ b/_overviews/collections/views.md @@ -13,6 +13,12 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- + + See this in Scala 2.13 + + + Collections have quite a few methods that construct new collections. Examples are `map`, `filter` or `++`. We call such methods transformers because they take at least one collection as their receiver object and produce another collection as their result. There are two principal ways to implement transformers. One is _strict_, that is a new collection with all its elements is constructed as a result of the transformer. The other is non-strict or _lazy_, that is one constructs only a proxy for the result collection, and its elements get constructed only as one demands them. diff --git a/_sass/layout/documentation.scss b/_sass/layout/documentation.scss index 9a04495b27..c9c121e9a6 100644 --- a/_sass/layout/documentation.scss +++ b/_sass/layout/documentation.scss @@ -57,3 +57,8 @@ padding: 1px 5px; } } + +.link-to-newer-version { + float: right; + padding: 0 0 1em 1em; +} From a22c2b648225d06cbb394f38348b4b65d5ac4d34 Mon Sep 17 00:00:00 2001 From: exoego Date: Mon, 22 Jul 2019 14:21:32 +0900 Subject: [PATCH 0624/3075] There is no newer version for those 2 pages. --- _overviews/collections/migrating-from-scala-27.md | 5 ----- _overviews/collections/trait-traversable.md | 5 ----- 2 files changed, 10 deletions(-) diff --git a/_overviews/collections/migrating-from-scala-27.md b/_overviews/collections/migrating-from-scala-27.md index 56760c67f9..939ef0987c 100644 --- a/_overviews/collections/migrating-from-scala-27.md +++ b/_overviews/collections/migrating-from-scala-27.md @@ -13,11 +13,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - Porting your existing Scala applications to use the new collections should be almost automatic. There are only a couple of possible issues to take care of. Generally, the old functionality of Scala 2.7 collections has been left in place. Some features have been deprecated, which means they will removed in some future release. You will get a _deprecation warning_ when you compile code that makes use of these features in Scala 2.8. In a few places deprecation was unfeasible, because the operation in question was retained in 2.8, but changed in meaning or performance characteristics. These cases will be flagged with _migration warnings_ when compiled under 2.8. To get full deprecation and migration warnings with suggestions how to change your code, pass the `-deprecation` and `-Xmigration` flags to `scalac` (note that `-Xmigration` is an extended option, so it starts with an `X`). You can also pass the same options to the `scala` REPL to get the warnings in an interactive session. Example: diff --git a/_overviews/collections/trait-traversable.md b/_overviews/collections/trait-traversable.md index 010a74fedb..a954246f99 100644 --- a/_overviews/collections/trait-traversable.md +++ b/_overviews/collections/trait-traversable.md @@ -13,11 +13,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - At the top of the collection hierarchy is trait `Traversable`. Its only abstract operation is `foreach`: def foreach[U](f: Elem => U) From 843382f1f35a79250803d704612226cbb2a5f467 Mon Sep 17 00:00:00 2001 From: exoego Date: Tue, 23 Jul 2019 12:13:52 +0900 Subject: [PATCH 0625/3075] Add newer version notice --- _layouts/inner-page-parent-dropdown.html | 1 + _layouts/inner-page-parent.html | 4 ++-- _overviews/collections/arrays.md | 6 +----- .../collections/concrete-immutable-collection-classes.md | 6 +----- .../collections/concrete-mutable-collection-classes.md | 6 +----- .../conversions-between-java-and-scala-collections.md | 6 +----- .../collections/creating-collections-from-scratch.md | 6 +----- _overviews/collections/equality.md | 6 +----- _overviews/collections/introduction.md | 6 +----- _overviews/collections/iterators.md | 6 +----- _overviews/collections/maps.md | 6 +----- _overviews/collections/overview.md | 6 +----- _overviews/collections/performance-characteristics.md | 6 +----- _overviews/collections/seqs.md | 6 +----- _overviews/collections/sets.md | 6 +----- _overviews/collections/strings.md | 6 +----- _overviews/collections/trait-iterable.md | 6 +----- _overviews/collections/views.md | 7 +------ _sass/layout/documentation.scss | 8 +++++--- 19 files changed, 24 insertions(+), 86 deletions(-) diff --git a/_layouts/inner-page-parent-dropdown.html b/_layouts/inner-page-parent-dropdown.html index d2e5029f68..5b89d3ef47 100644 --- a/_layouts/inner-page-parent-dropdown.html +++ b/_layouts/inner-page-parent-dropdown.html @@ -1,5 +1,6 @@ {% include headertop.html %} {% include headerbottom.html %} +{% if page.new-version %}This page has a new version.{% endif %}
    diff --git a/_layouts/inner-page-parent.html b/_layouts/inner-page-parent.html index 3ed25753ca..2dc28bb539 100644 --- a/_layouts/inner-page-parent.html +++ b/_layouts/inner-page-parent.html @@ -1,4 +1,5 @@ {% include headertop.html %} {% include headerbottom.html %} + {% if page.new-version %}This page has a new version.{% endif %}
    @@ -20,7 +21,6 @@

    {{page.title}}

    -
    @@ -28,4 +28,4 @@

    {{page.title}}

    -{% include footer.html %} \ No newline at end of file +{% include footer.html %} diff --git a/_overviews/collections/arrays.md b/_overviews/collections/arrays.md index 382af6a839..74af34c41a 100644 --- a/_overviews/collections/arrays.md +++ b/_overviews/collections/arrays.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/arrays.html num: 10 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - [Array](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/Array.html) is a special kind of collection in Scala. On the one hand, Scala arrays correspond one-to-one to Java arrays. That is, a Scala array `Array[Int]` is represented as a Java `int[]`, an `Array[Double]` is represented as a Java `double[]` and a `Array[String]` is represented as a Java `String[]`. But at the same time, Scala arrays offer much more than their Java analogues. First, Scala arrays can be _generic_. That is, you can have an `Array[T]`, where `T` is a type parameter or abstract type. Second, Scala arrays are compatible with Scala sequences - you can pass an `Array[T]` where a `Seq[T]` is required. Finally, Scala arrays also support all sequence operations. Here's an example of this in action: scala> val a1 = Array(1, 2, 3) diff --git a/_overviews/collections/concrete-immutable-collection-classes.md b/_overviews/collections/concrete-immutable-collection-classes.md index 8e7e74d6f8..f18caed726 100644 --- a/_overviews/collections/concrete-immutable-collection-classes.md +++ b/_overviews/collections/concrete-immutable-collection-classes.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/concrete-immutable-collection-classes.html num: 8 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - Scala provides many concrete immutable collection classes for you to choose from. They differ in the traits they implement (maps, sets, sequences), whether they can be infinite, and the speed of various operations. Here are some of the most common immutable collection types used in Scala. ## Lists diff --git a/_overviews/collections/concrete-mutable-collection-classes.md b/_overviews/collections/concrete-mutable-collection-classes.md index 404a1715ee..c54343554d 100644 --- a/_overviews/collections/concrete-mutable-collection-classes.md +++ b/_overviews/collections/concrete-mutable-collection-classes.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/concrete-mutable-collection-classes.html num: 9 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - You've now seen the most commonly used immutable collection classes that Scala provides in its standard library. Take a look now at the mutable collection classes. ## Array Buffers diff --git a/_overviews/collections/conversions-between-java-and-scala-collections.md b/_overviews/collections/conversions-between-java-and-scala-collections.md index cb9675fae0..290726fdab 100644 --- a/_overviews/collections/conversions-between-java-and-scala-collections.md +++ b/_overviews/collections/conversions-between-java-and-scala-collections.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/conversions-between-java-and-scala-collections.html num: 17 @@ -13,11 +14,6 @@ languages: [zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - Like Scala, Java also has a rich collections library. There are many similarities between the two. For instance, both libraries know iterators, iterables, sets, maps, and sequences. But there are also important differences. In particular, the Scala libraries put much more emphasis on immutable collections, and provide many more operations that transform a collection into a new one. Sometimes you might need to pass from one collection framework to the other. For instance, you might want to access an existing Java collection as if it were a Scala collection. Or you might want to pass one of Scala's collections to a Java method that expects its Java counterpart. It is quite easy to do this, because Scala offers implicit conversions between all the major collection types in the [JavaConverters](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/JavaConverters$.html) object. In particular, you will find bidirectional conversions between the following types. diff --git a/_overviews/collections/creating-collections-from-scratch.md b/_overviews/collections/creating-collections-from-scratch.md index 22c07d2016..1732a844e6 100644 --- a/_overviews/collections/creating-collections-from-scratch.md +++ b/_overviews/collections/creating-collections-from-scratch.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/creating-collections-from-scratch.html num: 16 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - You have syntax `List(1, 2, 3)` to create a list of three integers and `Map('A' -> 1, 'C' -> 2)` to create a map with two bindings. This is actually a universal feature of Scala collections. You can take any collection name and follow it by a list of elements in parentheses. The result will be a new collection with the given elements. Here are some more examples: Traversable() // An empty traversable object diff --git a/_overviews/collections/equality.md b/_overviews/collections/equality.md index 1bded6008e..e368d64b35 100644 --- a/_overviews/collections/equality.md +++ b/_overviews/collections/equality.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/creating-collections-from-scratch.html num: 13 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - The collection libraries have a uniform approach to equality and hashing. The idea is, first, to divide collections into sets, maps, and sequences. Collections in different categories are always unequal. For instance, `Set(1, 2, 3)` is unequal to `List(1, 2, 3)` even though they contain the same elements. On the other hand, within the same category, collections are equal if and only if they have the same elements (for sequences: the same elements in the same order). For example, `List(1, 2, 3) == Vector(1, 2, 3)`, and `HashSet(1, 2) == TreeSet(2, 1)`. It does not matter for the equality check whether a collection is mutable or immutable. For a mutable collection one simply considers its current elements at the time the equality test is performed. This means that a mutable collection might be equal to different collections at different times, depending what elements are added or removed. This is a potential trap when using a mutable collection as a key in a hashmap. Example: diff --git a/_overviews/collections/introduction.md b/_overviews/collections/introduction.md index 23136be5ec..39445c561f 100644 --- a/_overviews/collections/introduction.md +++ b/_overviews/collections/introduction.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/introduction.html num: 1 @@ -13,11 +14,6 @@ languages: [ja, zh-cn, ru] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - **Martin Odersky, and Lex Spoon** In the eyes of many, the new collections framework is the most significant diff --git a/_overviews/collections/iterators.md b/_overviews/collections/iterators.md index c273f87c12..abb3ca4a97 100644 --- a/_overviews/collections/iterators.md +++ b/_overviews/collections/iterators.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/iterators.html num: 15 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - An iterator is not a collection, but rather a way to access the elements of a collection one by one. The two basic operations on an iterator `it` are `next` and `hasNext`. A call to `it.next()` will return the next element of the iterator and advance the state of the iterator. Calling `next` again on the same iterator will then yield the element one beyond the one returned previously. If there are no more elements to return, a call to `next` will throw a `NoSuchElementException`. You can find out whether there are more elements to return using [Iterator](http://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/Iterator.html)'s `hasNext` method. The most straightforward way to "step through" all the elements returned by an iterator `it` uses a while-loop: diff --git a/_overviews/collections/maps.md b/_overviews/collections/maps.md index 6ba3b480b4..93b73342fa 100644 --- a/_overviews/collections/maps.md +++ b/_overviews/collections/maps.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/maps.html num: 7 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - A [Map](http://www.scala-lang.org/api/current/scala/collection/Map.html) is an [Iterable](http://www.scala-lang.org/api/current/scala/collection/Iterable.html) consisting of pairs of keys and values (also named _mappings_ or _associations_). Scala's [Predef](http://www.scala-lang.org/api/current/scala/Predef$.html) object offers an implicit conversion that lets you write `key -> value` as an alternate syntax for the pair `(key, value)`. For instance `Map("x" -> 24, "y" -> 25, "z" -> 26)` means exactly the same as `Map(("x", 24), ("y", 25), ("z", 26))`, but reads better. The fundamental operations on maps are similar to those on sets. They are summarized in the following table and fall into the following categories: diff --git a/_overviews/collections/overview.md b/_overviews/collections/overview.md index cc46a849ba..2b3db7713b 100644 --- a/_overviews/collections/overview.md +++ b/_overviews/collections/overview.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/overview.html num: 2 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - Scala collections systematically distinguish between mutable and immutable collections. A _mutable_ collection can be updated or extended in place. This means you can change, add, or remove elements diff --git a/_overviews/collections/performance-characteristics.md b/_overviews/collections/performance-characteristics.md index 96cbacbe59..55e8080163 100644 --- a/_overviews/collections/performance-characteristics.md +++ b/_overviews/collections/performance-characteristics.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/performance-characteristics.html num: 12 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - The previous explanations have made it clear that different collection types have different performance characteristics. That's often the primary reason for picking one collection type over another. You can see the performance characteristics of some common operations on collections summarized in the following two tables. Performance characteristics of sequence types: diff --git a/_overviews/collections/seqs.md b/_overviews/collections/seqs.md index 17aa7f708b..9883ce9c36 100644 --- a/_overviews/collections/seqs.md +++ b/_overviews/collections/seqs.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/seqs.html num: 5 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - The [Seq](http://www.scala-lang.org/api/current/scala/collection/Seq.html) trait represents sequences. A sequence is a kind of iterable that has a `length` and whose elements have fixed index positions, starting from `0`. The operations on sequences, summarized in the table below, fall into the following categories: diff --git a/_overviews/collections/sets.md b/_overviews/collections/sets.md index 85d21f3c28..76745eb8bb 100644 --- a/_overviews/collections/sets.md +++ b/_overviews/collections/sets.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/sets.html num: 6 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - `Set`s are `Iterable`s that contain no duplicate elements. The operations on sets are summarized in the following table for general sets and in the table after that for mutable sets. They fall into the following categories: * **Tests** `contains`, `apply`, `subsetOf`. The `contains` method asks whether a set contains a given element. The `apply` method for a set is the same as `contains`, so `set(elem)` is the same as `set contains elem`. That means sets can also be used as test functions that return true for the elements they contain. diff --git a/_overviews/collections/strings.md b/_overviews/collections/strings.md index a6545dbf6a..bb1a66dd5f 100644 --- a/_overviews/collections/strings.md +++ b/_overviews/collections/strings.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/strings.html num: 11 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - Like arrays, strings are not directly sequences, but they can be converted to them, and they also support all sequence operations on strings. Here are some examples of operations you can invoke on strings. scala> val str = "hello" diff --git a/_overviews/collections/trait-iterable.md b/_overviews/collections/trait-iterable.md index b708c251f5..5f07a242c8 100644 --- a/_overviews/collections/trait-iterable.md +++ b/_overviews/collections/trait-iterable.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/trait-iterable.html num: 4 @@ -13,11 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - The next trait from the top in the collections hierarchy is `Iterable`. All methods in this trait are defined in terms of an abstract method, `iterator`, which yields the collection's elements one by one. The `foreach` method from trait `Traversable` is implemented in `Iterable` in terms of `iterator`. Here is the actual implementation: def foreach[U](f: Elem => U): Unit = { diff --git a/_overviews/collections/views.md b/_overviews/collections/views.md index 4968547708..86bacf29e1 100644 --- a/_overviews/collections/views.md +++ b/_overviews/collections/views.md @@ -6,6 +6,7 @@ discourse: true partof: collections overview-name: Collections (Scala 2.8 - 2.12) +new-version: /overviews/collections-2.13/views.html num: 14 @@ -13,12 +14,6 @@ languages: [ja, zh-cn] permalink: /overviews/collections/:title.html --- - - See this in Scala 2.13 - - - Collections have quite a few methods that construct new collections. Examples are `map`, `filter` or `++`. We call such methods transformers because they take at least one collection as their receiver object and produce another collection as their result. There are two principal ways to implement transformers. One is _strict_, that is a new collection with all its elements is constructed as a result of the transformer. The other is non-strict or _lazy_, that is one constructs only a proxy for the result collection, and its elements get constructed only as one demands them. diff --git a/_sass/layout/documentation.scss b/_sass/layout/documentation.scss index c9c121e9a6..f1a16f69d5 100644 --- a/_sass/layout/documentation.scss +++ b/_sass/layout/documentation.scss @@ -58,7 +58,9 @@ } } -.link-to-newer-version { - float: right; - padding: 0 0 1em 1em; +a.new-version-notice { + display: block; + background: rgb(255, 255, 200); + font-size: large; + text-align: center; } From 26e40b026b8cdb98abb560d1a7334d71332d6dda Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 23 Jul 2019 14:07:12 -0700 Subject: [PATCH 0626/3075] update spec version in footer fixes #1447 --- _data/footer.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_data/footer.yml b/_data/footer.yml index 04e60f45eb..b810181f92 100644 --- a/_data/footer.yml +++ b/_data/footer.yml @@ -8,7 +8,7 @@ - title: Overviews/Guides url: "/overviews" - title: Language Specification - url: "http://scala-lang.org/files/archive/spec/2.12/" + url: "http://scala-lang.org/files/archive/spec/2.13/" - title: Download class: download links: From cac3f800cf5654c4d6a00f107c7b7c7cd5729937 Mon Sep 17 00:00:00 2001 From: exoego Date: Wed, 24 Jul 2019 08:14:40 +0900 Subject: [PATCH 0627/3075] Move cheatsheet to its own collection just like site structure. --- {_overviews/cheatsheets => _cheatsheets}/index.md | 1 - _config.yml | 3 +++ _layouts/cheatsheet.html | 2 +- 3 files changed, 4 insertions(+), 2 deletions(-) rename {_overviews/cheatsheets => _cheatsheets}/index.md (99%) diff --git a/_overviews/cheatsheets/index.md b/_cheatsheets/index.md similarity index 99% rename from _overviews/cheatsheets/index.md rename to _cheatsheets/index.md index 07d96b55c8..67d4c59144 100644 --- a/_overviews/cheatsheets/index.md +++ b/_cheatsheets/index.md @@ -8,7 +8,6 @@ by: Brendan O'Connor about: Thanks to Brendan O'Connor, this cheatsheet aims to be a quick reference of Scala syntactic constructions. Licensed by Brendan O'Connor under a CC-BY-SA 3.0 license. languages: [ba, fr, ja, pl, pt-br, zh-cn, th, ru] -permalink: /cheatsheets/index.html --- diff --git a/_config.yml b/_config.yml index 320c7a9839..2862096ac9 100644 --- a/_config.yml +++ b/_config.yml @@ -35,6 +35,9 @@ collections: sips: output: true permalink: /:collection/:path.html + cheatsheets: + output: true + permalink: /:collection/:path.html books: output: false ja: # Japanese translations diff --git a/_layouts/cheatsheet.html b/_layouts/cheatsheet.html index 9e0e978e63..9ee9695c01 100644 --- a/_layouts/cheatsheet.html +++ b/_layouts/cheatsheet.html @@ -22,7 +22,7 @@ {% elsif page.language %} {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} - {% assign engPg = site.overviews | where: 'partof', page.partof | first %} + {% assign engPg = site.cheatsheets | where: 'partof', page.partof | first %} {{ engPg.languages }} -
    Problem with this page?
         Please help us fix it!
    +
    Problem with this page?
         Please help us fix it!
    diff --git a/_overviews/contributors/index.md b/_overviews/contributors/index.md index 0d31996273..c20879ffbd 100644 --- a/_overviews/contributors/index.md +++ b/_overviews/contributors/index.md @@ -742,7 +742,7 @@ Last, add the following job to the “test” stage, in the `.travis.yml` file: This will check that pull requests don’t make changes that are binary incompatible with the previous stable version. -We suggest working with the following Git workflow: the `master` branch always receives pull requests +We suggest working with the following Git workflow: the `main` branch always receives pull requests for the next major version (so, binary compatibility checks are disabled, by setting the `mimaPreviousArtifacts` value to `Set.empty`), and each major version `N` has a corresponding `N.x` branch (e.g., `1.x`, `2.x`, etc.) branch where the binary compatibility checks are enabled. diff --git a/_sips/sip-submission.md b/_sips/sip-submission.md index 1d7d1d0609..e2efb5ec2a 100644 --- a/_sips/sip-submission.md +++ b/_sips/sip-submission.md @@ -76,7 +76,7 @@ a SIP or needs more work. After receiving the green light from the Process Lead, you can write up your idea and submit it as a SIP. -A SIP is a Markdown document written in conformance with the [process template](https://github.com/scala/docs.scala-lang/blob/master/_sips/sip-template.md). +A SIP is a Markdown document written in conformance with the [process template](https://github.com/scala/docs.scala-lang/blob/main/_sips/sip-template.md). It ought to contain a clear specification of the proposed changes. When such changes significantly alter the compiler internals, the author is invited to provide a proof of concept. Delivering a basic implementation can speed up the @@ -323,7 +323,7 @@ Scala compiler. The process to submit is simple: * Fork the Scala documentation repository, [https://github.com/scala/docs.scala-lang](https://github.com/scala/docs.scala-lang). -* Create a new SIP file in the `_sips/sips/`. Use the [S(L)IP template](https://github.com/scala/docs.scala-lang/blob/master/_sips/sip-template.md) +* Create a new SIP file in the `_sips/sips/`. Use the [S(L)IP template](https://github.com/scala/docs.scala-lang/blob/main/_sips/sip-template.md) * Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Use the proposal date for `YYYY-MM-dd`. * Use the [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax) to write your SIP. * Follow the instructions in the [README](https://github.com/scala/docs.scala-lang/) to build your SIP locally so you can ensure that it looks correct on the website. diff --git a/_sips/sip-tutorial.md b/_sips/sip-tutorial.md index 2696fd12af..6103c16d94 100644 --- a/_sips/sip-tutorial.md +++ b/_sips/sip-tutorial.md @@ -10,10 +10,10 @@ This tutorial details of how to write a new SIP and adding it to the website. The process to submit is simple: * Fork the [Scala documentation repository](https://github.com/scala/docs.scala-lang) and clone it. -* Create a new SIP file in the `_sips/sips`. Use the [SIP template](https://github.com/scala/docs.scala-lang/blob/master/_sips/sip-template.md) +* Create a new SIP file in the `_sips/sips`. Use the [SIP template](https://github.com/scala/docs.scala-lang/blob/main/_sips/sip-template.md) * Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Use the proposal date for `YYYY-MM-dd`. * Use the [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax) to write your SIP. - * Follow the instructions in the [README](https://github.com/scala/docs.scala-lang/blob/master/README.md) to build your SIP locally so you can ensure that it looks correct on the website. + * Follow the instructions in the [README](https://github.com/scala/docs.scala-lang/blob/main/README.md) to build your SIP locally so you can ensure that it looks correct on the website. * Create a link to your SIP in the "pending sips" section of `index.md`. * Commit your changes and push them to your forked repository. * Create a new pull request. This will notify the Scala SIP team. @@ -34,7 +34,7 @@ Use the [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax) t If you would like a starting point, clone the [SIP Template](./sip-template.html) in `_sips/sip-template.md` and use that. -See the [source](https://github.com/scala/docs.scala-lang/blob/master/_sips/sip-template.md) for this document (`sip-tutorial.md`) for how to do syntax highlighting. +See the [source](https://github.com/scala/docs.scala-lang/blob/main/_sips/sip-template.md) for this document (`sip-tutorial.md`) for how to do syntax highlighting. ```scala class Foo @@ -46,6 +46,6 @@ class Foo Testing changes requires installing [Jekyll](https://jekyllrb.com/docs/installation/). Since this site is hosted on github pages, make sure you have [whatever version of Jekyll that github is running](https://help.github.com/articles/using-jekyll-with-pages#troubleshooting). As of the writing of this README, that is version >= 1.0.x. After the installation, you need to start up the local server. The -[README](https://github.com/scala/docs.scala-lang/blob/master/README.md) gives +[README](https://github.com/scala/docs.scala-lang/blob/main/README.md) gives a concise explanation on how to do it. When the server is running, view your changes at [https://localhost:4000/sips](https://localhost:4000/sips). diff --git a/scala3/contribute-to-docs.md b/scala3/contribute-to-docs.md index 25d719a764..91b467766f 100644 --- a/scala3/contribute-to-docs.md +++ b/scala3/contribute-to-docs.md @@ -28,13 +28,13 @@ Typically, each of the different documentation projects contain links (and so do ## Scala 3 Book The [Scala 3 Book][scala3-book] is being written by Alvin Alexander and provides an overview over all the important features of Scala 3. It targets readers, which are new to Scala. -- [Sources](https://github.com/scala/docs.scala-lang/tree/master/_overviews/scala3-book) +- [Sources](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-book) - [Issues](https://github.com/scala/docs.scala-lang/issues) ## Macros Tutorial The [Macros Tutorial](/scala3/guides/macros) is being written by Nicolas Stucki and contains detailed information about macros in Scala 3 and best-practices. -- [Sources](https://github.com/scala/docs.scala-lang/tree/master/_overviews/scala3-macros) +- [Sources](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-macros) - [Issues](https://github.com/scala/docs.scala-lang/issues) ## Migration Guide @@ -42,7 +42,7 @@ The [Scala 3 Migration Guide](/scala3/guides/migration/compatibility-intro.html) contains an comprehensive overview over compatibility between Scala 2 and Scala 3, a tour presenting the migration tools, and detailed migration guides. -- [Source](https://github.com/scala/docs.scala-lang/tree/master/_overviews/scala3-migration) +- [Source](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-migration) - [Issues](https://github.com/scalacenter/docs.scala-lang/issues) ## Scala 3 Language Reference From 3d94c2fb4c6df2b8db2bfda9209c5bd65aab64c6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Koz=C5=82owski?= Date: Wed, 2 Jun 2021 19:17:24 +0200 Subject: [PATCH 1491/3075] Update index.md --- _overviews/plugins/index.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/_overviews/plugins/index.md b/_overviews/plugins/index.md index 9e1b2015b7..20b3508cf9 100644 --- a/_overviews/plugins/index.md +++ b/_overviews/plugins/index.md @@ -46,11 +46,10 @@ include: - Plugins that alter Scala's behavior around errors and warnings, such as [silencer](https://github.com/ghik/silencer), [splain](https://github.com/tek/splain) and [clippy](https://scala-clippy.org/). - Plugins that analyze the structure of source code, such as - [Sculpt](https://github.com/lightbend/scala-sculpt) and [acyclic](https://github.com/lihaoyi/acyclic). + [Sculpt](https://github.com/lightbend/scala-sculpt), [acyclic](https://github.com/lihaoyi/acyclic) and [graph-buddy](https://github.com/VirtusLab/graphbuddy). - Plugins that instrument user code to collect information, such as the code coverage tool [scoverage](https://github.com/scoverage/scalac-scoverage-plugin). -- Plugins that add metaprogramming facilities to Scala, - such as [Macro Paradise](https://github.com/scalamacros/paradise), [semanticdb](https://scalameta.org/docs/semanticdb/guide.html). +- Plugins that enable tooling. One such plugin is [semanticdb](https://scalameta.org/docs/semanticdb/guide.html), which enables [scalafix](https://scalacenter.github.io/scalafix/) (a well-known refactoring and linting tool) to do its work. Another one is [Macro Paradise](https://github.com/scalamacros/paradise) (only needed for Scala 2.12). - Plugins that modify existing Scala constructs in user code, such as [better-monadic-for](https://github.com/oleg-py/better-monadic-for) and [better-tostring](https://github.com/polyvariant/better-tostring). - Plugins that add entirely new constructs to Scala by From 619652ef2d82107bdc03acfbb55877abd2fec84d Mon Sep 17 00:00:00 2001 From: nscarcella Date: Thu, 3 Jun 2021 03:37:26 -0300 Subject: [PATCH 1492/3075] Fixed typos (#2049) * Fixed missing `then` keyword * Replaced Any type for Matchable * Adding missing parenthesis * Added short Matchable description --- _overviews/scala3-book/fun-write-map-function.md | 4 ++-- _overviews/scala3-book/methods-most.md | 8 +++++--- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/_overviews/scala3-book/fun-write-map-function.md b/_overviews/scala3-book/fun-write-map-function.md index 37a0748074..633d9b8fb8 100644 --- a/_overviews/scala3-book/fun-write-map-function.md +++ b/_overviews/scala3-book/fun-write-map-function.md @@ -20,13 +20,13 @@ Given that statement, you start to write the method signature. First, you know that you want to accept a function as a parameter, and that function should transform an `Int` into some generic type `A`, so you write: ```scala -def map(f: (Int) => A +def map(f: (Int) => A) ``` The syntax for using a generic type requires declaring that type symbol before the parameter list, so you add that: ```scala -def map[A](f: (Int) => A +def map[A](f: (Int) => A) ``` Next, you know that `map` should also accept a `List[Int]`: diff --git a/_overviews/scala3-book/methods-most.md b/_overviews/scala3-book/methods-most.md index b501b1687b..ac2140a41b 100644 --- a/_overviews/scala3-book/methods-most.md +++ b/_overviews/scala3-book/methods-most.md @@ -233,7 +233,7 @@ Here’s a method named `isTruthy` that implements the Perl definitions of `true ```scala def isTruthy(a: Any) = - if a == 0 || a == "" + if a == 0 || a == "" then false else true @@ -256,13 +256,14 @@ A `match` expression can also be used as the entire method body, and often is. Here’s another version of `isTruthy`, written with a `match` expression : ```scala -def isTruthy(a: Any) = a match +def isTruthy(a: Matchable) = a match case 0 | "" => false case _ => true ``` -This method works just like the previous method that used an `if`/`else` expression. +This method works just like the previous method that used an `if`/`else` expression. We use `Matchable` instead of `Any` as the parameter's type to accept any value that supports pattern matching. +For more details on the `Matchable` trait, see the [Reference documentation][reference_matchable]. ## Controlling visibility in classes @@ -401,3 +402,4 @@ See the [Reference documentation][reference] for more details on these features. [extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} [reference_extension_methods]: {{ site.scala3ref }}/contextual/extension-methods.html [reference]: {{ site.scala3ref }}/overview.html +[reference_matchable]: {{ site.scala3ref }}/other-new-features/matchable.html From 6b2ae553fc0b34e1b6f78b30a81e6892e59b3553 Mon Sep 17 00:00:00 2001 From: SourceCodeBot Date: Thu, 3 Jun 2021 16:54:34 +0200 Subject: [PATCH 1493/3075] docs: add import notice for extension methods (#2042) * docs: add import notice for extension methods * fix: solved review discussions --- .../scala3-book/ca-extension-methods.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/_overviews/scala3-book/ca-extension-methods.md b/_overviews/scala3-book/ca-extension-methods.md index 7c8639e020..b860b4f928 100644 --- a/_overviews/scala3-book/ca-extension-methods.md +++ b/_overviews/scala3-book/ca-extension-methods.md @@ -50,6 +50,25 @@ Then in your code you use `circumference` just as though it was originally defin aCircle.circumference ``` +### Import extension method + +Imagine, that `circumference` is defined in package `lib`, you can import it by + +```scala +import lib.circumference + +aCircle.circumference +``` + +The compiler also support you if the import is missing by showing a detailed compilation error message such as the following: + +```text +value circumference is not a member of Circle, but could be made available as an extension method. + +The following import might fix the problem: + + import lib.circumference +``` ## Discussion From 38c8ef07dd499326b3a5a8660817d2bf02ee7d52 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Fri, 4 Jun 2021 12:17:43 +0200 Subject: [PATCH 1494/3075] Fix redirects --- _sips/all.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_sips/all.md b/_sips/all.md index ed26042765..8133c137af 100644 --- a/_sips/all.md +++ b/_sips/all.md @@ -2,8 +2,9 @@ layout: sips title: List of All SIPs -redirect_from: "/sips/sip-list.html" -redirect_from: "/sips/pending/index.html" +redirect_from: + - "/sips/sip-list.html" + - "/sips/pending/index.html" --- From 6b8bc3882609961746ea005ad9fb2fd94f03d027 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Fri, 4 Jun 2021 12:23:48 +0200 Subject: [PATCH 1495/3075] Fix redirects --- _tour/named-arguments.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_tour/named-arguments.md b/_tour/named-arguments.md index 3dc7a4a503..af82d72844 100644 --- a/_tour/named-arguments.md +++ b/_tour/named-arguments.md @@ -8,8 +8,9 @@ next-page: traits previous-page: default-parameter-values prerequisite-knowledge: function-syntax -redirect_from: "/tutorials/tour/named-arguments.html" -redirect_from: "/tutorials/tour/named-parameters.html" +redirect_from: + - "/tutorials/tour/named-arguments.html" + - "/tutorials/tour/named-parameters.html" --- When calling methods, you can label the arguments with their parameter names like so: From a480f7581acab3e49b5fa2d4169c76bafa41efc0 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Fri, 4 Jun 2021 12:24:22 +0200 Subject: [PATCH 1496/3075] Fix redirects --- _tour/tour-of-scala.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/_tour/tour-of-scala.md b/_tour/tour-of-scala.md index 2f23fdd254..59e4072e3a 100644 --- a/_tour/tour-of-scala.md +++ b/_tour/tour-of-scala.md @@ -7,9 +7,10 @@ num: 1 next-page: basics -redirect_from: "/tutorials/tour/tour-of-scala.html" -redirect_from: "/tutorials/tour/anonymous-function-syntax.html" -redirect_from: "/tutorials/tour/explicitly-typed-self-references.html" +redirect_from: + - "/tutorials/tour/tour-of-scala.html" + - "/tutorials/tour/anonymous-function-syntax.html" + - "/tutorials/tour/explicitly-typed-self-references.html" --- ## Welcome to the tour From 980dc6d1f9e9f53c63413a1c11c82b2bde24f496 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Fri, 4 Jun 2021 12:24:49 +0200 Subject: [PATCH 1497/3075] Fix redirects --- _tour/for-comprehensions.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_tour/for-comprehensions.md b/_tour/for-comprehensions.md index 54ed69f0bf..ce9a8849c5 100644 --- a/_tour/for-comprehensions.md +++ b/_tour/for-comprehensions.md @@ -7,8 +7,9 @@ num: 19 next-page: generic-classes previous-page: extractor-objects -redirect_from: "/tutorials/tour/for-comprehensions.html" -redirect_from: "/tutorials/tour/sequence-comprehensions.html" +redirect_from: + - "/tutorials/tour/for-comprehensions.html" + - "/tutorials/tour/sequence-comprehensions.html" --- Scala offers a lightweight notation for expressing *sequence comprehensions*. Comprehensions have the form `for (enumerators) yield e`, where `enumerators` refers to a semicolon-separated list of enumerators. An *enumerator* is either a generator which introduces new variables, or it is a filter. A comprehension evaluates the body `e` for each binding generated by the enumerators and returns a sequence of these values. From f51e92ee1dd4b976b036f83cf73b232df533604e Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Fri, 4 Jun 2021 12:25:14 +0200 Subject: [PATCH 1498/3075] Fix redirects --- _tour/abstract-type-members.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_tour/abstract-type-members.md b/_tour/abstract-type-members.md index 8cad19b617..77dedcc386 100644 --- a/_tour/abstract-type-members.md +++ b/_tour/abstract-type-members.md @@ -8,8 +8,9 @@ previous-page: inner-classes topics: abstract type members prerequisite-knowledge: variance, upper-type-bound -redirect_from: "/tutorials/tour/abstract-types.html" -redirect_from: "/tour/abstract-types.html" +redirect_from: + - "/tutorials/tour/abstract-types.html" + - "/tour/abstract-types.html" --- Abstract types, such as traits and abstract classes, can in turn have abstract type members. From 2eee485ffb573391f00861027d85d61b53afc1a5 Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Fri, 4 Jun 2021 14:39:30 +0200 Subject: [PATCH 1499/3075] Fix redirects --- _overviews/FAQ/index.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index b9eca9a551..0e4b7200ad 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -2,14 +2,15 @@ layout: singlepage-overview title: Scala FAQ permalink: /tutorials/FAQ/index.html -redirect_from: "/tutorials/FAQ/breakout.html" -redirect_from: "/tutorials/FAQ/chaining-implicits.html" -redirect_from: "/tutorials/FAQ/collections.html" -redirect_from: "/tutorials/FAQ/context-bounds.html" -redirect_from: "/tutorials/FAQ/finding-implicits.html" -redirect_from: "/tutorials/FAQ/finding-symbols.html" -redirect_from: "/tutorials/FAQ/stream-view.html" -redirect_from: "/tutorials/FAQ/yield.html" +redirect_from: + - "/tutorials/FAQ/breakout.html" + - "/tutorials/FAQ/chaining-implicits.html" + - "/tutorials/FAQ/collections.html" + - "/tutorials/FAQ/context-bounds.html" + - "/tutorials/FAQ/finding-implicits.html" + - "/tutorials/FAQ/finding-symbols.html" + - "/tutorials/FAQ/stream-view.html" + - "/tutorials/FAQ/yield.html" --- Frequently asked questions, with _brief_ answers and/or links to From c3fd91cc9b2c2148410373ebab177cc85597b30e Mon Sep 17 00:00:00 2001 From: Alessandro Buggin <830963+abuggin@users.noreply.github.com> Date: Thu, 10 Jun 2021 14:21:41 +0100 Subject: [PATCH 1500/3075] Minor typo --- _overviews/scala3-migration/tooling-migration-mode.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/tooling-migration-mode.md b/_overviews/scala3-migration/tooling-migration-mode.md index 045ede947b..b8c2cb0904 100644 --- a/_overviews/scala3-migration/tooling-migration-mode.md +++ b/_overviews/scala3-migration/tooling-migration-mode.md @@ -37,7 +37,7 @@ where possible standard options include: The `-source:3.0-migration` option makes the compiler forgiving on most of the dropped features, printing warnings in place of errors. Each warning is a strong indication that the compiler is even capable of safely rewriting the deprecated pieces of code into their cross-compiling counterparts. -We call this the **Scala 3 migration compialtion**. +We call this the **Scala 3 migration compilation**. ## Automatic rewrites From 262f04216954d5ee7651300c3f8fac0b17199883 Mon Sep 17 00:00:00 2001 From: vincenzobaz Date: Fri, 28 May 2021 10:49:25 +0200 Subject: [PATCH 1501/3075] Use GitHub actions instead of Travis CI --- _overviews/contributors/index.md | 354 ++++++++++++------------------- 1 file changed, 135 insertions(+), 219 deletions(-) diff --git a/_overviews/contributors/index.md b/_overviews/contributors/index.md index 0d31996273..4421211e15 100644 --- a/_overviews/contributors/index.md +++ b/_overviews/contributors/index.md @@ -46,62 +46,47 @@ use the correct sbt version. ## Setup Continuous Integration The first reason for setting up a continuous integration (CI) server is to systematically run tests on pull requests. -Examples of CI servers that are free for open source projects are [Travis CI](https://travis-ci.org), -[Drone](https://drone.io) or [AppVeyor](https://appveyor.com). +Examples of CI servers that are free for open source projects are [GitHub Actions](https://github.com/features/actions), +[Travis CI](https://travis-ci.com), [Drone](https://drone.io) or [AppVeyor](https://appveyor.com). -Our example uses Travis CI. To enable Travis CI on your project, go to [travis-ci.org](https://travis-ci.org/), -sign up using your GitHub account, and enable your project repository. Then, add a `.travis.yml` file to your -repository with the following content: +Our example uses Github Actions. This feature is enabled by default on GitHub repositories. You can verify if that is +the case and enable them in the *Actions* section of the *Settings* tab of the repository. -~~~ yaml -language: scala -~~~ - -Push your changes and check that Travis CI triggers a build for your repository. - -Travis CI tries to guess which build tool your project uses and executes a default command to run the project tests. -For instance, if your repository contains a `build.sbt` file in the root directory, Travis CI executes the -`sbt ++$TRAVIS_SCALA_VERSION test` command, where the `TRAVIS_SCALA_VERSION` variable is, by default, set to an -arbitrary Scala version (`2.12.8`, at the time these lines are written), which could be inconsistent with the -`scalaVersion` defined in your `build.sbt` file. - -To avoid this potential inconsistency, you want to use one Scala version definition as a single source of truth. -For instance, the [sbt-travisci](https://github.com/dwijnand/sbt-travisci) plugin lets you define the Scala version -in the `.travis.yml` file, and then forwards this version to your sbt build definition. Alternatively, you can -override the default command run by Travis CI to use the Scala version defined by the `scalaVersion` settings of -your build. +With Actions enabled, you can create a *workflow definition file*. A **workflow** is an automated procedure, +composed of one or more jobs. A **job** is a set of sequential steps that are executed on the same runner. +A **step** is an individual task that can run commands; a step can be either an *action* or a shell command. +An **action** is the smallest building block of a workflow, it is possible to reuse community actions or to +define new ones. -The latter approach is the one used in this guide. Override the command run by Travis CI by adding the folliwng -lines to your `.travis.yml` file: +To create a workflow, create a *yaml* file in the directory `.github/workflows/` in the repository, for example +`.github/workflows/ci.yml` with the following content: ~~~ yaml +name: Continuous integration +on: push + jobs: - include: - - stage: test - script: sbt test + Tests: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 # Retrieve the content of the repository + - uses: olafurpg/setup-scala@v11 # Set up a jdk and sbt + - name: unit tests # Custom action consisting of a shell command + run: sbt +test ~~~ -Travis CI will now execute the `sbt test` command, which uses the Scala version from the build definition. +This workflow is called *Continuous integration* and it will run every time one or more commits are pushed to +the repository. It contains only one job called *Tests*, which will run on an Ubuntu runner and that is composed +of three actions. `setup-scala` uses the sbt version specified in `project/build.properties` and the Scala +version defined in your `build.sbt`. -Last, an important thing to setup is caching, to avoid the CI server to re-download your project dependencies each -time it runs. For instance, in case you use sbt, you can instruct Travis CI to save the content of the `~/.ivy2/` -and `~/.sbt/` directories across builds by adding the following lines to your `.travis.yml` file: - -~~~ yaml -# These directories are cached at the end of the build -cache: - directories: - - $HOME/.ivy2/cache - - $HOME/.sbt -before_cache: - # Cleanup the cached directories to avoid unnecessary cache updates - - rm -fv $HOME/.ivy2/.sbt.ivy.lock - - find $HOME/.ivy2/cache -name "ivydata-*.properties" -print -delete - - find $HOME/.sbt -name "*.lock" -print -delete -~~~ +The worfklow above will run at any push to any branch of the repository. You can +specify the branch or add more triggers such as pull requests, releases, tags or +schedules. More information about workflow triggers is available [here](https://docs.github.com/en/actions/reference/events-that-trigger-workflows). +while the `setup-scala` action is hosted [in this repository](https://github.com/olafurpg/setup-scala). For reference, here is our complete -[.travis.yml example file](https://github.com/scalacenter/library-example/blob/master/.travis.yml). +[workflow example file](https://github.com/scalacenter/library-example/blob/master/.github/.workflows/ci.yml). ## Publish a Release @@ -125,7 +110,7 @@ sign the binaries. ### Create a Sonatype Account and Project Follow the instructions given on the [OSSRH Guide](https://central.sonatype.org/pages/ossrh-guide.html#initial-setup) -to create a new Sonatype account (unless you already have one) and to +to create a new Sonatype account (unless you already have one) and to [create a new project ticket](https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134). This latter step is where you define the `groupId` that you will release to. You can use a domain name that you already own, otherwise a common practice is to use `io.github.(username)` (where `(username)` is replaced with your GitHub @@ -143,7 +128,7 @@ This step has to be performed only once per person. ### Setup Your Project -In case you use sbt, we recommend using the [sbt-sonatype](https://github.com/xerial/sbt-sonatype) +In case you use sbt, we recommend using the [sbt-sonatype](https://github.com/xerial/sbt-sonatype) and [sbt-pgp](https://www.scala-sbt.org/sbt-pgp/) plugins to publish your artifacts. Add the following dependencies to your `project/plugins.sbt` file: @@ -201,7 +186,7 @@ And make sure your build does **not** define the `version` setting. With this setup, the process for cutting a release is the following. Create a Git tag whose name begins with a lowercase `v` followed by the version number: - + ~~~ bash $ git tag v0.1.0 ~~~ @@ -236,9 +221,8 @@ Continuous publication addresses these issues by delegating the publication proc follows: any contributor with write access to the repository can cut a release by pushing a Git tag, the CI server first checks that the tests pass and then runs the publication commands. -The remaining sections show how to setup Travis CI for continuous publication on Sonatype. You can find instructions -for other CI servers and repositories in the [sbt-release-early](https://github.com/scalacenter/sbt-release-early) -plugin documentation. +The remaining sections show how to setup GitHub Actions for continuous publication on Sonatype. You can find instructions +for Travis CI in the [sbt-ci-release](https://github.com/olafurpg/sbt-ci-release) plugin documentation. ### Setup the CI Server @@ -247,28 +231,14 @@ it is possible to securely give this information by using the secret management #### Export Your Sonatype Account Credentials -The `SONATYPE_USERNAME` and `SONATYPE_PASSWORD` environment variables are recognized by the `sbt-sonatype` -plugin, as documented [here](https://github.com/xerial/sbt-sonatype#homesbtsbt-version-013-or-10sonatypesbt-1). +Create two [GitHub Encrypted secrets](https://docs.github.com/en/actions/reference/encrypted-secrets) +for your Sonatype account credentials: `SONATYPE_USERNAME` and `SONATYPE_PASSWORD`. +To do so, go to the *Settings* tab of the repository and select *Secrets* on the left panel. +You can then use the button *New repository secret* to open the secret creation menu where you will enter +the name of the secret and its content. -With Travis CI, you will have to install the [Travis CLI](https://github.com/travis-ci/travis.rb#installation). - -Then, run the following commands from your project root directory to add your Sonatype credentials as -environment variables to your `.travis.yml` file in an encrypted form: - -~~~ bash -$ travis encrypt SONATYPE_USERNAME="(Sonatype user name)" --add -$ travis encrypt SONATYPE_PASSWORD="(Sonatype password)" --add -~~~ - -(Put your actual user name and password in place of `(Sonatype user name)` and `(Sonatype password)`) - -The `--add` option updates your `.travis.yml` file with entries like the following: - -~~~ yaml -env: - global: - - secure: "dllL1w+pZT6yTBYwy5hX07t8r0JL5Cqer6YgYnXJ+q3OhSGUs7ul2fDUiqVxGIgUpTij1cGwBmoJOTbRk2V/be4+3Ua4ZNrAxjNF2ehqUcV5KdC3ufTTTXX0ZoL9MqEIb+GKzKtPqbzR4uly/5q5NbV7J1GeZRhummnx87POl6yH4kmXTpahig7vvnwN5dLanMshRb2Z8tO8kF4SnC31QuNBDQLnS89PEajHQu+LRAJloYvcikm+NeUj79m64CYg9JZdrHvZpIYKOMY1twT+lYoerqzG+asiNE1WrDs/We1RFVgcrKLpEThcvuIxuuPKhu24+0KteAX+7z/ulT0lndyBRfuuDjHV844LrNbjhnTB64V1uF7aEdaEZRLTsFQnFZqzpoqYqxzgfow9LN/kU5CMJX1R4wwf3YgR1VC9ZfjZnu0Pbt24g48I+72ZDNk3oRZoPsN9AtovwdZcg7TgU/iPcHNKSNhEZRP6ryhv/9aX3URLkfhnDaJmTXAnC3YCYt5cGo0FBUHARA+AHcas14Dx95bFSbH7EBivb2LiDmi44goRCWR4p+vNSBJ6Ak1NZz/+paai0pXDG6S/VdqwGSmmfjn7m9H3L5c8X5xNich9qtZbWz0fj2baZGq/doA8KE91JCzX11p/9fKNzbVivQZdsw3C3ZWDjkMZM+hl++0=" -~~~ +Repository Secrets allow us to safely store confidential information and to expose +it to Actions workflows without the risk of committing them to git history. #### Export Your PGP Key Pair @@ -285,72 +255,65 @@ uid Julien Richard-Foy In my case, I have one key pair, whose ID is `BE614499`. -Export your public and private keys into files, in a `ci` directory: - -~~~ bash -$ mkdir ci -$ gpg -a --export (key ID) > ci/pubring.asc -$ gpg -a --export-secret-keys (key ID) > ci/secring.asc -~~~ +Then: + + 1. Create a new Secret containing the passphrase of your PGP key named `PGP_PASSPHRASE`. + 2. Create a new Secret containing the base64 encoded secret of your private key, which you can obtain + by running: +``` +# macOS +gpg --armor --export-secret-keys $LONG_ID | base64 +# Ubuntu (assuming GNU base64) +gpg --armor --export-secret-keys $LONG_ID | base64 -w0 +# Arch +gpg --armor --export-secret-keys $LONG_ID | base64 | sed -z 's;\n;;g' +# FreeBSD (assuming BSD base64) +gpg --armor --export-secret-keys $LONG_ID | base64 +# Windows +gpg --armor --export-secret-keys %LONG_ID% | openssl base64 +``` + 3. Publish your public key signature to a public server, for example [http://keyserver.ubuntu.com:11371](http://keyserver.ubuntu.com:11371/). + You can obtain the signature by running: +``` +# macOS and linux +gpg --armor --export $LONG_ID +# Windows +gpg --armor --export %LONG_ID% +``` (Replace `(key ID)` with **your** key ID) -Add the `ci/pubring.asc` file (which contains your public key) to your repository. The `secring.asc` file -(which contains your private key) should **not** be added as it is to the repository, so make sure it will -be ignored by Git by adding it to the `.gitignore` file: - -~~~ -ci/secring.asc -~~~ - -Encrypt it with the `travis` tool: - -~~~ bash -$ travis encrypt-file ci/secring.asc ci/secring.asc.enc --add -~~~ - -As advised in the command output, make sure to add the `secring.asc.enc` to the git repository. - -The `--add` option above adds a line like the following to your `.travis.yml` file: - -~~~ diff -before_install: - - openssl aes-256-cbc -K $encrypted_602f530300eb_key -iv $encrypted_602f530300eb_iv -in ci/secring.asc.enc -out ci/secring.asc -d -~~~ - -Finally, add export your PGP passphrase to the `.travis.yml` file: - -~~~ -$ travis encrypt PGP_PASSPHRASE="(your passphrase)" --add -~~~ - -(Replace `(your passphrase)` with your actual passphrase) #### Publish From the CI Server -On Travis CI, you can define a -[conditional stage](https://docs.travis-ci.com/user/build-stages/#specifying-stage-order-and-conditions) -publishing the library when a tag is pushed: +On GitHub Actions, you can define a workflow to publish the library when a tag is pushed: ~~~ yaml -jobs: - include: - - stage: test - script: sbt test - - stage: deploy - if: tag =~ ^v - script: sbt publishSigned sonatypeRelease -~~~ +# .github/workflows/release.yml +name: Continuous publication +on: + push: + branches: ['**'] + tags: [v*] -The last step is to tell your build definition how to retrieve the PGP passphrase from the `PGP_PASSPHRASE` -environment variable and to use the `pubring.asc` and `secring.asc` files as the PGP key pair. -Include the following settings in your `build.sbt` file: - -~~~ scala -pgpPublicRing := file("ci/pubring.asc") -pgpSecretRing := file("ci/secring.asc") -pgpPassphrase := sys.env.get("PGP_PASSPHRASE").map(_.toArray) -~~~ +jobs: + release: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + with: + fetch-depth: 0 # fetch all tags, required for sbt-dynver + - uses: olafurpg/setup-scala@v11 + - run: sbt ci-release + env: + PGP_PASSPHRASE: ${{ secrets.PGP_PASSPHRASE }} + PGP_SECRET: ${{ secrets.PGP_SECRET }} + SONATYPE_PASSWORD: ${{ secrets.SONATYPE_PASSWORD }} + SONATYPE_USERNAME: ${{ secrets.SONATYPE_USERNAME }} +~~~ + +The `env` statement exposes the secrets you defined earlier to the publication process through +environment variables. ### Cut a Release @@ -374,19 +337,7 @@ scalaVersion := crossScalaVersions.value.head ~~~ The second line makes sbt use by default the first Scala version of the `crossScalaVersions`. - -Modify the CI jobs to use all the Scala versions of your build definition by using the `+` prefix, -when appropriate: - -~~~ yaml -jobs: - include: - - stage: test - script: sbt +test - - stage: deploy - if: tag =~ ^v - script: sbt +publishSigned sonatypeRelease -~~~ +The CI job will use all the Scala versions of your build definition. ## Publish Online Documentation @@ -589,78 +540,28 @@ can browse it at [https://scalacenter.github.io/library-example/](https://scalac ### Continuous Publication -You need to grant the CI job write access to the Git repository hosting the documentation. This can be achieved -by creating an SSH key that the CI job can use to push the website to GitHub. - -Create an SSH key: +You can extend `.github/workflows/release.yml` to automatically publish documentation to GitHub pages. +To do so, add another job: -~~~ bash -$ ssh-keygen -t rsa -b 4096 -C "sbt-site@travis" -f ci/travis-key -~~~ - -Make sure to **not** define a passphrase (just leave it empty and press enter), and to add the private -key (the `ci/travis-key` file) to your `.gitignore`: - -~~~ -ci/secring.asc -ci/travis-key -~~~ +```yml +# .github/workflows/release.yml +name: Continuous publication -Add the public key, `ci/travis-key.pub`, in the Deploy Keys section of your GitHub project’s settings page: - -![](/resources/images/travis-publishing-key.png) - -Make sure you “allow write access” by checking the box. - -The private key has to be added to the repository, like we did with the PGP private key. Unfortunately, due -to a limitation of Travis CI, you can not add several encrypted files. The -[workaround](https://docs.travis-ci.com/user/encrypting-files/#encrypting-multiple-files) consists in -creating an archive containing all the files to encrypt. In your case, you want to encrypt the PGP -key and the SSH key into a single `ci/secrets.tar` file: - -~~~ bash -$ tar cvf ci/secrets.tar ci/secring.asc ci/travis-key -$ travis encrypt-file ci/secrets.tar ci/secrets.tar.enc --add -~~~ - -Make sure to add the `ci/secrets.tar` file to your `.gitignore`: - -~~~ -ci/secring.asc -ci/travis-key -ci/secrets.tar -~~~ - -Finally, update the `.travis.yml` file to unpack the archive and push the documentation website -on releases: - -~~~ yaml jobs: - include: - - stage: test - # Run tests for all Scala versions - script: sbt +test - name: "Tests" - # Check that the documentation can be built - - script: sbt makeSite - name: "Documentation" - - - stage: deploy - if: tag =~ ^v - script: - # decrypt PGP secret key and GitHub SSH key - - openssl aes-256-cbc -K $encrypted_602f530300eb_key -iv $encrypted_602f530300eb_iv -in ci/secrets.tar.enc -out ci/secrets.tar -d - - tar xvf ci/secrets.tar - # load the key in the ssh-agent - - chmod 600 ci/travis-key - - eval "$(ssh-agent -s)" - - ssh-add ci/travis-key - # perform deployment - - sbt makeSite +publishSigned sonatypeRelease ghpagesPushSite -~~~ - -(Replace the `$encrypted_602f530300eb_key` and `$encrypted_602f530300eb_iv` variables with the ones produced by the -`travis encrypt-file` command) + release: # The release job is not changed, you can find it above + publishSite: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - uses: olafurpg/setup-scala@v11 + - name: Generate site + run: sbt makeSite + - uses: JamesIves/github-pages-deploy-action@4.1.3 + with: + branch: gh-pages + folder: target/site + +``` As usual, cut a release by pushing a Git tag. The CI server will run the tests, publish the binaries and update the online documentation. @@ -699,14 +600,19 @@ addSbtPlugin("com.geirsson" % "sbt-scalafmt" % "1.5.1") In the `CONTRIBUTING.md` file, mention that you use that code formatter and encourage users to use the “format on save” feature of their editor. -In your `.travis.yml` file, add a first stage checking that the code has been properly formatted: +In your `.github/workflows/ci.yml` file, add a step checking that the code has been properly formatted: ~~~ yaml +# .github/workflows/ci.yml +# The three periods `...` indicate the parts of file that do not change +# from the snippets above and they are omitted for brevity jobs: - include: - - - stage: style - script: sbt scalafmtCheck + ci: + # ... + steps: + # ... + - name: Code style + run: sbt scalafmtCheck ~~~ ## Evolve @@ -732,11 +638,21 @@ Configure it as follow, in `build.sbt`: mimaPreviousArtifacts := previousStableVersion.value.map(organization.value %% name.value % _).toSet ~~~ -Last, add the following job to the “test” stage, in the `.travis.yml` file: +Last, add the following step to the job `ci` of the `Continuous integration` workflow, in the `.github/workflows/ci.yml` file: ~~~ yaml - - script: sbt mimaReportBinaryIssues - name: "Binary compatibility" +# .github/workflows/ci.yml +# The three periods `...` indicate the parts of file that do not change +# from the snippets above and they are omitted for brevity + +# ... +jobs: + ci: + # ... + steps: + # ... + - name: Binary compatibility + run: sbt mimaReportBinaryIssues ~~~ This will check that pull requests don’t make changes that are binary incompatible with the From 797f0f77b1f1b3276c6d281718c1aefaa40ffcc3 Mon Sep 17 00:00:00 2001 From: vincenzobaz Date: Wed, 9 Jun 2021 16:22:36 +0200 Subject: [PATCH 1502/3075] t# This is a combination of 3 commits. Drop Scala 2.11 --- _overviews/contributors/index.md | 41 +++++++++++++++++++------------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/_overviews/contributors/index.md b/_overviews/contributors/index.md index 4421211e15..1c94648972 100644 --- a/_overviews/contributors/index.md +++ b/_overviews/contributors/index.md @@ -50,7 +50,9 @@ Examples of CI servers that are free for open source projects are [GitHub Action [Travis CI](https://travis-ci.com), [Drone](https://drone.io) or [AppVeyor](https://appveyor.com). Our example uses Github Actions. This feature is enabled by default on GitHub repositories. You can verify if that is -the case and enable them in the *Actions* section of the *Settings* tab of the repository. +the case in the *Actions* section of the *Settings* tab of the repository. +If *Disable all actions* is checked, then Actions are not enabled and you can activate them +by selecting *Allow all actions*, *Allow local actions only* or *Allow select actions*. With Actions enabled, you can create a *workflow definition file*. A **workflow** is an automated procedure, composed of one or more jobs. A **job** is a set of sequential steps that are executed on the same runner. @@ -66,7 +68,7 @@ name: Continuous integration on: push jobs: - Tests: + ci: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 # Retrieve the content of the repository @@ -75,18 +77,23 @@ jobs: run: sbt +test ~~~ -This workflow is called *Continuous integration* and it will run every time one or more commits are pushed to -the repository. It contains only one job called *Tests*, which will run on an Ubuntu runner and that is composed -of three actions. `setup-scala` uses the sbt version specified in `project/build.properties` and the Scala -version defined in your `build.sbt`. +This workflow is called *Continuous integration* and it will run every time one +or more commits are pushed to the repository. It contains only one job called +*ci*, which will run on an Ubuntu runner and that is composed of three +actions. The action `setup-scala` installs the sbt launcher in the runner. Then +the job runs `sbt +test`, which loads the sbt version specified in +`project/build.properties`, and runs the project tests using the Scala version +defined in the file `build.sbt`. -The worfklow above will run at any push to any branch of the repository. You can -specify the branch or add more triggers such as pull requests, releases, tags or -schedules. More information about workflow triggers is available [here](https://docs.github.com/en/actions/reference/events-that-trigger-workflows). -while the `setup-scala` action is hosted [in this repository](https://github.com/olafurpg/setup-scala). +The workflow above will run at any push to any branch of the repository. You +can specify the branch or add more triggers such as pull requests, releases, +tags or schedules. More information about workflow triggers is available +[here](https://docs.github.com/en/actions/reference/events-that-trigger-workflows). +while the `setup-scala` action is hosted [in this +repository](https://github.com/olafurpg/setup-scala). -For reference, here is our complete -[workflow example file](https://github.com/scalacenter/library-example/blob/master/.github/.workflows/ci.yml). +For reference, here is our complete [workflow example +file](https://github.com/scalacenter/library-example/blob/master/.github/.workflows/ci.yml). ## Publish a Release @@ -156,7 +163,7 @@ import xerial.sbt.Sonatype._ sonatypeProjectHosting := Some(GitHubHosting("scalacenter", "library-example", "julien.richard-foy@epfl.ch")) // publish to the sonatype repository -publishTo := sonatypePublishTo.value +publishTo := sonatypePublishToBundle.value ~~~ Put your Sonatype credentials in a `$HOME/.sbt/1.0/sonatype.sbt` file: @@ -289,7 +296,7 @@ gpg --armor --export %LONG_ID% On GitHub Actions, you can define a workflow to publish the library when a tag is pushed: ~~~ yaml -# .github/workflows/release.yml +# .github/workflows/publish.yml name: Continuous publication on: push: @@ -332,7 +339,7 @@ If you have written a library, you probably want it to be usable from several Sc Define the versions you want to support in the `crossScalaVersions` setting, in your `build.sbt` file: ~~~ scala -crossScalaVersions := Seq("2.12.8", "2.11.12") +crossScalaVersions := Seq("2.13.6", "2.12.8") scalaVersion := crossScalaVersions.value.head ~~~ @@ -540,11 +547,11 @@ can browse it at [https://scalacenter.github.io/library-example/](https://scalac ### Continuous Publication -You can extend `.github/workflows/release.yml` to automatically publish documentation to GitHub pages. +You can extend `.github/workflows/publish.yml` to automatically publish documentation to GitHub pages. To do so, add another job: ```yml -# .github/workflows/release.yml +# .github/workflows/publish.yml name: Continuous publication jobs: From 5c24940560a5107139bf93364e562b428a7257a4 Mon Sep 17 00:00:00 2001 From: vincenzobaz Date: Fri, 11 Jun 2021 11:36:15 +0200 Subject: [PATCH 1503/3075] Update dependencies --- _overviews/contributors/index.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/_overviews/contributors/index.md b/_overviews/contributors/index.md index 1c94648972..76eb540b80 100644 --- a/_overviews/contributors/index.md +++ b/_overviews/contributors/index.md @@ -72,7 +72,7 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 # Retrieve the content of the repository - - uses: olafurpg/setup-scala@v11 # Set up a jdk and sbt + - uses: olafurpg/setup-scala@v12 # Set up a jdk and sbt - name: unit tests # Custom action consisting of a shell command run: sbt +test ~~~ @@ -140,8 +140,8 @@ and [sbt-pgp](https://www.scala-sbt.org/sbt-pgp/) plugins to publish your artifa dependencies to your `project/plugins.sbt` file: ~~~ scala -addSbtPlugin("org.xerial.sbt" % "sbt-sonatype" % "2.4") -addSbtPlugin("com.jsuereth" % "sbt-pgp" % "1.1.0") +addSbtPlugin("org.xerial.sbt" % "sbt-sonatype" % "3.9.7") +addSbtPlugin("com.jsuereth" % "sbt-pgp" % "2.1.1") ~~~ And make sure your build fulfills the [Sonatype requirements](https://central.sonatype.org/publish/requirements) @@ -183,7 +183,7 @@ Last, we recommend using the [sbt-dynver](https://github.com/dwijnand/sbt-dynver of your releases. Add the following dependency to your `project/plugins.sbt` file: ~~~ scala -addSbtPlugin("com.dwijnand" % "sbt-dynver" % "3.1.0") +addSbtPlugin("com.dwijnand" % "sbt-dynver" % "4.1.1") ~~~ And make sure your build does **not** define the `version` setting. @@ -310,7 +310,7 @@ jobs: - uses: actions/checkout@v2 with: fetch-depth: 0 # fetch all tags, required for sbt-dynver - - uses: olafurpg/setup-scala@v11 + - uses: olafurpg/setup-scala@v12 - run: sbt ci-release env: PGP_PASSPHRASE: ${{ secrets.PGP_PASSPHRASE }} @@ -339,7 +339,7 @@ If you have written a library, you probably want it to be usable from several Sc Define the versions you want to support in the `crossScalaVersions` setting, in your `build.sbt` file: ~~~ scala -crossScalaVersions := Seq("2.13.6", "2.12.8") +crossScalaVersions := Seq("2.13.6", "2.12.14") scalaVersion := crossScalaVersions.value.head ~~~ @@ -372,8 +372,8 @@ most other documentation generators, which are based on Ruby, Node.js or Python) To install Paradox and sbt-site, add the following lines to your `project/plugins.sbt` file: ~~~ scala -addSbtPlugin("com.typesafe.sbt" % "sbt-site" % "1.3.2") -addSbtPlugin("com.lightbend.paradox" % "sbt-paradox" % "0.4.4") +addSbtPlugin("com.typesafe.sbt" % "sbt-site" % "1.4.1") +addSbtPlugin("com.lightbend.paradox" % "sbt-paradox" % "0.9.2") ~~~ And then add the following configuration to your `build.sbt` file: @@ -560,7 +560,7 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - - uses: olafurpg/setup-scala@v11 + - uses: olafurpg/setup-scala@v12 - name: Generate site run: sbt makeSite - uses: JamesIves/github-pages-deploy-action@4.1.3 @@ -601,7 +601,7 @@ For instance, to use [scalafmt](https://scalameta.org/scalafmt/), add the follow file: ~~~ scala -addSbtPlugin("com.geirsson" % "sbt-scalafmt" % "1.5.1") +addSbtPlugin("org.scalameta" % "sbt-scalafmt" % "2.4.2") ~~~ In the `CONTRIBUTING.md` file, mention that you use that code formatter and encourage users to use the “format @@ -636,7 +636,7 @@ break this versioning policy. Add the `sbt-mima-plugin` to your build with the f `project/plugins.sbt` file: ~~~ scala -addSbtPlugin("com.typesafe" % "sbt-mima-plugin" % "0.3.0") +addSbtPlugin("com.typesafe" % "sbt-mima-plugin" % "0.9.2") ~~~ Configure it as follow, in `build.sbt`: From f0ee521a5c99065fc84ddb3cd7ed84af9706d12f Mon Sep 17 00:00:00 2001 From: "Lan, Jian" <45252210+ShapelessCat@users.noreply.github.com> Date: Sat, 12 Jun 2021 01:22:07 -0700 Subject: [PATCH 1504/3075] Fix why-scala-3.md The second `LinearSeq` of the clause "traits like `LinearSeq` and `LinearSeq`" should be another trait. --- _overviews/scala3-book/why-scala-3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/why-scala-3.md b/_overviews/scala3-book/why-scala-3.md index 1c23d1e7f0..e5f317f9f3 100644 --- a/_overviews/scala3-book/why-scala-3.md +++ b/_overviews/scala3-book/why-scala-3.md @@ -45,7 +45,7 @@ For instance, a `List` is defined as a class---technically it’s an abstract cl val x = List(1, 2, 3) ``` -However, what appears to the programmer to be a simple `List` is actually built from a combination of several specialized types, including an abstract class named `AbstractSeq`, traits like `LinearSeq` and `LinearSeq`, and more. +However, what appears to the programmer to be a simple `List` is actually built from a combination of several specialized types, including an abstract class named `AbstractSeq`, traits like `LinearSeq` and `LinearSeqOps`, and more. Those types are similarly composed of other small, modular units of code. In addition to building a type like `List` from a series of modular traits, the `List` API also consists of dozens of other methods, many of which are higher-order functions: From 273a57fd4fa472fc3248a1a26703daeaa593ced4 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Wed, 9 Jun 2021 18:15:48 +0200 Subject: [PATCH 1505/3075] Suggestions in the Scala book MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I’ve reviewed the chapters Methods, Functions, and Packaging and Imports. --- .../scala3-book/fun-anonymous-functions.md | 4 +- _overviews/scala3-book/fun-hofs.md | 32 ++++++------ .../scala3-book/fun-write-map-function.md | 4 +- _overviews/scala3-book/methods-intro.md | 2 +- .../scala3-book/methods-main-methods.md | 4 +- _overviews/scala3-book/methods-most.md | 25 ++++----- _overviews/scala3-book/packaging-imports.md | 51 +++++++++++-------- 7 files changed, 65 insertions(+), 57 deletions(-) diff --git a/_overviews/scala3-book/fun-anonymous-functions.md b/_overviews/scala3-book/fun-anonymous-functions.md index c771c1458c..39d87da216 100644 --- a/_overviews/scala3-book/fun-anonymous-functions.md +++ b/_overviews/scala3-book/fun-anonymous-functions.md @@ -116,7 +116,7 @@ In other examples, you can simplify your anonymous functions further. For instance, beginning with the most explicit form, you can print each element in `ints` using this anonymous function with the `List` class `foreach` method: ```scala -ints.foreach((i:Int) => println(i)) +ints.foreach((i: Int) => println(i)) ``` As before, the `Int` declaration isn’t required, and because there’s only one argument, the parentheses around `i` aren’t needed: @@ -131,7 +131,7 @@ Because `i` is used only once in the body of the function, the expression can be ints.foreach(println(_)) ``` -Finally, if an anonymous function consists of one statement that takes a single argument, you don’t need to explicitly name and specify the argument, so the statement can finally be reduced to this: +Finally, if an anonymous function consists of one method call that takes a single argument, you don’t need to explicitly name and specify the argument, so you can finally write only the name of the method (here, `println`): ```scala ints.foreach(println) diff --git a/_overviews/scala3-book/fun-hofs.md b/_overviews/scala3-book/fun-hofs.md index c8d93c46ef..0985c38ea2 100644 --- a/_overviews/scala3-book/fun-hofs.md +++ b/_overviews/scala3-book/fun-hofs.md @@ -37,7 +37,7 @@ As a beneficial side effect of this discussion, once you’re comfortable with t To understand how higher-order functions work, it helps to dig into an example. For instance, you can understand the type of functions `filter` accepts by looking at its Scaladoc. -Here’s the `filter` definition in the `List` class: +Here’s the `filter` definition in the `List[A]` class: ```scala def filter(p: (A) => Boolean): List[A] @@ -102,7 +102,7 @@ Here’s how this works: It’s just like naming a `String` parameter `s` or an `Int` parameter `i`. - The type signature of `f` specifies the *type* of the functions this method will accept. - The `()` portion of `f`’s signature (on the left side of the `=>` symbol) states that `f` takes no input parameters. -- The `Unit` portion of the signature (on the right side of the `=>` symbol) indicates that `f` should return nothing. +- The `Unit` portion of the signature (on the right side of the `=>` symbol) indicates that `f` should not return a meaningful result. - Looking back at the body of the `sayHello` method (on the right side of the `=` symbol), the `f()` statement there invokes the function that’s passed in. Now that we’ve defined `sayHello`, let’s create a function to match `f`’s signature so we can test it. @@ -148,7 +148,7 @@ The only thing to do now is see a few more examples of how to define different t In this method: ```scala -def sayHello(f: () => Unit) +def sayHello(f: () => Unit): Unit ``` We noted that the type signature for `f` is: @@ -157,7 +157,7 @@ We noted that the type signature for `f` is: () => Unit ``` -We know that this means, “a function that takes no input parameters and returns nothing (given by `Unit`).” +We know that this means, “a function that takes no input parameters and returns nothing meaningful (given by `Unit`).” To demonstrate more type signature examples, here’s a function that takes a `String` parameter and returns an `Int`: @@ -255,40 +255,40 @@ executeAndPrint(multiply, 3, 9) // prints 27 ## Function type signature consistency -A great thing about learning about Scala’s function type signatures is that the syntax you use to define function input parameters is the same syntax you use to write anonymous functions and function variables. +A great thing about learning about Scala’s function type signatures is that the syntax you use to define function input parameters is the same syntax you use to write function literals. -For instance, if you were to write an anonymous function that calculates the sum of two integers, you’d write it like this: +For instance, if you were to write a function that calculates the sum of two integers, you’d write it like this: ```scala -(Int, Int) => Int = (a, b) => a + b +val f: (Int, Int) => Int = (a, b) => a + b ``` That code consists of the type signature: ```` -(Int, Int) => Int = (a, b) => a + b ------------------ +val f: (Int, Int) => Int = (a, b) => a + b + ----------------- ```` The input parameters: ```` -(Int, Int) => Int = (a, b) => a + b - ------ +val f: (Int, Int) => Int = (a, b) => a + b + ------ ```` and the body of the function: ```` -(Int, Int) => Int = (a, b) => a + b - ----- +val f: (Int, Int) => Int = (a, b) => a + b + ----- ```` -Scala’s consistency is shown here, where this anonymous function type signature: +Scala’s consistency is shown here, where this function type: ```` -(Int, Int) => Int = (a, b) => a + b ------------------ +val f: (Int, Int) => Int = (a, b) => a + b + ----------------- ```` is the same as the type signature you use to define a function input parameter: diff --git a/_overviews/scala3-book/fun-write-map-function.md b/_overviews/scala3-book/fun-write-map-function.md index 633d9b8fb8..74cab95213 100644 --- a/_overviews/scala3-book/fun-write-map-function.md +++ b/_overviews/scala3-book/fun-write-map-function.md @@ -66,7 +66,7 @@ As a bonus, notice that the `for` expression doesn’t do anything that depends Therefore, you can replace `Int` in the type signature with the generic type parameter `B`: ```scala -def map[A,B](f: (B) => A, xs: List[B]): List[A] = +def map[A, B](f: (B) => A, xs: List[B]): List[A] = for x <- xs yield f(x) ``` @@ -76,7 +76,7 @@ These examples demonstrate that `map` works as desired: ```scala def double(i : Int) = i * 2 -map(double, List(1, 2, 3)) // List(2,4,6) +map(double, List(1, 2, 3)) // List(2, 4, 6) def strlen(s: String) = s.length map(strlen, List("a", "bb", "ccc")) // List(1, 2, 3) diff --git a/_overviews/scala3-book/methods-intro.md b/_overviews/scala3-book/methods-intro.md index a6bf3e2fff..1c1414746c 100644 --- a/_overviews/scala3-book/methods-intro.md +++ b/_overviews/scala3-book/methods-intro.md @@ -9,7 +9,7 @@ next-page: methods-most In Scala 2, _methods_ can be defined inside classes, traits, objects, case classes, and case objects. -But it gets better: In Scala 3 they can also be defined _outside_ any of those constructs with a new feature named Toplevel definitions. +But it gets better: In Scala 3 they can also be defined _outside_ any of those constructs; we say that they are "top-level" definitions, since they are not nested in another definition. In short, methods can now be defined anywhere. Many features of methods are demonstrated in the next section. diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index 1077e238a2..bee342a45f 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -11,7 +11,7 @@ next-page: methods-summary Scala 3 offers a new way to define programs that can be invoked from the command line: Adding a `@main` annotation to a method turns it into entry point of an executable program: ```scala -@main def hello = println("Hello, world") +@main def hello() = println("Hello, world") ``` Just save that line of code in a file named something like *Hello.scala*---the filename doesn’t have to match the method name---and compile it with `scalac`: @@ -81,7 +81,7 @@ Illegal command line: java.lang.NumberFormatException: For input string: "sixty" The Scala compiler generates a program from an `@main` method `f` as follows: - It creates a class named `f` in the package where the `@main` method was found. -- The class has a static method `main` with the usual signature: It takes an `Array[String]` as argument and returns `Unit`. +- The class has a static method `main` with the usual signature of a Java `main` method: it takes an `Array[String]` as argument and returns `Unit`. - The generated `main` method calls method `f` with arguments converted using methods in the `scala.util.CommandLineParser` object. For instance, the `happyBirthday` method above generates additional code equivalent to the following class: diff --git a/_overviews/scala3-book/methods-most.md b/_overviews/scala3-book/methods-most.md index ac2140a41b..233c51b847 100644 --- a/_overviews/scala3-book/methods-most.md +++ b/_overviews/scala3-book/methods-most.md @@ -7,16 +7,16 @@ previous-page: methods-intro next-page: methods-main-methods --- -This section introduces the various aspects of how to define and call methods in Scala 2. +This section introduces the various aspects of how to define and call methods in Scala 3. ## Defining Methods Scala methods have many features, including these: - Generic (type) parameters -- Automatically provided `using` parameters - Default parameter values - Multiple parameter groups +- Context-provided parameters - By-name parameters - ... @@ -63,7 +63,7 @@ The Scala collections classes have dozens of built-in methods. These examples show how to call them: ```scala -val x = List(1,2,3) +val x = List(1, 2, 3) x.size // 3 x.contains(1) // true @@ -102,7 +102,7 @@ res0: Int = 4 ``` Notice that there’s no need for a `return` statement at the end of the method. -Because almost everything in Scala is an _expression_---meaning that each line of code returns (or _evaluates to) a value---there’s no need to use `return`. +Because almost everything in Scala is an _expression_---meaning that each line of code returns (or _evaluates to_) a value---there’s no need to use `return`. This becomes more clear when you condense that method and write it on one line: @@ -118,6 +118,7 @@ The body of a method can use all the different features of the language: - `for` loops and `for` expressions - Variable assignments - Calls to other methods +- Definitions of other methods As an example of a real-world multiline method, this `getStackTraceAsString` method converts its `Throwable` input parameter into a well-formatted `String`: @@ -202,10 +203,10 @@ When a method takes no parameters, it’s said to have an _arity_ level of _arit Similarly, when a method takes one parameter it’s an _arity-1_ method. When you create arity-0 methods: -- If the method has side effects, such as calling `println`, declare the method with empty parentheses -- If the method does not have side effects---such as getting the size of a collection, which is similar to accessing a field on the collection---leave the parentheses off +- If the method performs side effects, such as calling `println`, declare the method with empty parentheses +- If the method does not perform side effects---such as getting the size of a collection, which is similar to accessing a field on the collection---leave the parentheses off -For example, this method has a side effect, so it’s declared with empty parentheses: +For example, this method performs a side effect, so it’s declared with empty parentheses: ```scala def speak() = println("hi") @@ -218,7 +219,7 @@ speak // error: "method speak must be called with () argument" speak() // prints "hi" ``` -While this is just a convention, following it dramatically improves code readability: It makes it easier to understand at a glance that an arity-0 method has side effects. +While this is just a convention, following it dramatically improves code readability: It makes it easier to understand at a glance that an arity-0 method performs side effects. {% comment %} Some of that wording comes from this page: https://docs.scala-lang.org/style/method-invocation.html @@ -233,7 +234,7 @@ Here’s a method named `isTruthy` that implements the Perl definitions of `true ```scala def isTruthy(a: Any) = - if a == 0 || a == "" then + if a == 0 || a == "" || a == false then false else true @@ -257,7 +258,7 @@ Here’s another version of `isTruthy`, written with a `match` expression : ```scala def isTruthy(a: Matchable) = a match - case 0 | "" => false + case 0 | "" | false => false case _ => true ``` @@ -279,7 +280,7 @@ d.speak() // prints "Woof" ``` Methods can also be marked as `private`. -This makes them private to the current class, and they can’t be overridden in subclasses: +This makes them private to the current class, so they can’t be called nor overridden in subclasses: ```scala class Animal: @@ -290,7 +291,7 @@ class Cat extends Animal: override def breathe() = println("Yo, I’m totally breathing") ``` -If you want to make a method private to the current class and also allow subclasses to override it, mark the method as `protected`, as shown with the `speak` method in this example: +If you want to make a method private to the current class and also allow subclasses to call it or override it, mark the method as `protected`, as shown with the `speak` method in this example: ```scala class Animal: diff --git a/_overviews/scala3-book/packaging-imports.md b/_overviews/scala3-book/packaging-imports.md index b34071123d..ef3b9a16c1 100644 --- a/_overviews/scala3-book/packaging-imports.md +++ b/_overviews/scala3-book/packaging-imports.md @@ -33,26 +33,33 @@ package com.acme.myapp.model class Person ... ``` -By convention, package names should be all lower case, and the formal naming convention is *...*. +By convention, package names should be all lower case, and the formal naming convention is *\.\.\.\*. Although it’s not required, package names typically follow directory structure names, so if you follow this convention, a `Person` class in this project will be found in a *MyApp/src/main/scala/com/acme/myapp/model/Person.scala* file. -### Curly brace packaging style +### Using multiple packages in the same file -The other way to declare packages in Scala is by using the curly brace namespace notation used in languages like C, C++, and C#: +The syntax shown above applies to the entire source file: all the definitions in the file +`Person.scala` belong to package `com.acme.myapp.model`, according to the package clause +at the beginning of the file. + +Alternatively, it is possible to write package clauses that apply only to the definitions +they contain: ```scala -package users { - package administrators { - class AdminUser - } - package normalusers { - class NormalUser - } -} +package users: + + package administrators: // the full name of this package is users.administrators + class AdminUser // the full name of this class is users.administrators.AdminUser + + package normalusers: // the full name of this package is users.normalusers + class NormalUser // the full name of this class is users.normalusers.NormalUser ``` +Note that the package names are followed by a colon, and that the defininitions within +a package are indented. + The advantages of this approach are that it allows for package nesting, and provides more obvious control of scope and encapsulation, especially within the same file. @@ -92,27 +99,27 @@ A note before moving on: In Scala you can import one member from a package like this: ```scala -import java.io.File +import scala.concurrent.Future ``` and multiple members like this: ```scala -import java.io.File -import java.io.IOException -import java.io.FileNotFoundException +import scala.concurrent.Future +import scala.concurrent.Promise +import scala.concurrent.blocking ``` When importing multiple members, you can import them more concisely like this: ```scala -import java.io.{File, IOException, FileNotFoundException} +import scala.concurrent.{Future, Promise, blocking} ``` -When you want to import everything from the *java.io* package, use this syntax: +When you want to import everything from the *scala.concurrent* package, use this syntax: ```scala -import java.io.* +import scala.concurrent.* ``` @@ -170,13 +177,13 @@ val res0: java.util.ArrayList[String] = [] Because those Java classes are hidden, you can also use the Scala `List`, `Set`, and `Map` classes without having a naming collision: ```scala -scala> val a = List(1,2,3) +scala> val a = List(1, 2, 3) val a: List[Int] = List(1, 2, 3) -scala> val b = Set(1,2,3) +scala> val b = Set(1, 2, 3) val b: Set[Int] = Set(1, 2, 3) -scala> val c = Map(1->1, 2->2) +scala> val c = Map(1 -> 1, 2 -> 2) val c: Map[Int, Int] = Map(1 -> 1, 2 -> 2) ``` @@ -241,7 +248,7 @@ Two packages are implicitly imported into the scope of all of your source code f - java.lang.* - scala.* -The Scala `Predef` object is also imported by default. +The members of the Scala object `Predef` are also imported by default. > If you ever wondered why you can use classes like `List`, `Vector`, `Map`, etc., without importing them, they’re available because of definitions in the `Predef` object. From 08ede3bd71d7e400206b247beaf213065bf2535d Mon Sep 17 00:00:00 2001 From: Todd O'Bryan Date: Mon, 14 Jun 2021 01:06:14 -0700 Subject: [PATCH 1506/3075] Update quotes.md (#2047) I think the first two things are just typos. The third seems much easier for me, as a native English speaker, to understand. --- _overviews/scala3-macros/tutorial/quotes.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-macros/tutorial/quotes.md b/_overviews/scala3-macros/tutorial/quotes.md index fe99cb4260..a772b23f8f 100644 --- a/_overviews/scala3-macros/tutorial/quotes.md +++ b/_overviews/scala3-macros/tutorial/quotes.md @@ -14,7 +14,7 @@ Intuitively, the code directly within the quote is not executed now, while the c ```scala val msg = Expr("Hello") -val printHello = '{ print($hello) } +val printHello = '{ print($msg) } println(printHello.show) // print("Hello") ``` @@ -46,7 +46,8 @@ def myBadCounter2(using Quotes): Expr[Int] = '{ } ``` Clearly, this should not work as the variable does not exist yet. -To make sure you can only write programs that do not contain these kinds of problems we restrict the set of references to variable and other definitions. + +To make sure you cannot write programs that contain these kinds of problems, we restrict the kinds of references allowed in quote environments. We introduce _levels_ as a count of the number of quotes minus the number of splices surrounding an expression or definition. From e70abc8308d1d262ade788c96a11d27745815c02 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Wed, 2 Jun 2021 15:59:37 +0200 Subject: [PATCH 1507/3075] Some suggestions in the Scala 3 book --- _overviews/scala3-book/introduction.md | 4 +- _overviews/scala3-book/scala-features.md | 38 ++++----- _overviews/scala3-book/taste-collections.md | 12 ++- .../scala3-book/taste-control-structures.md | 17 ++-- _overviews/scala3-book/taste-functions.md | 4 +- _overviews/scala3-book/taste-methods.md | 2 +- _overviews/scala3-book/taste-modeling.md | 14 +-- _overviews/scala3-book/taste-objects.md | 4 +- _overviews/scala3-book/why-scala-3.md | 85 ++++++++++--------- scala3/contribute-to-docs.md | 2 +- 10 files changed, 90 insertions(+), 92 deletions(-) diff --git a/_overviews/scala3-book/introduction.md b/_overviews/scala3-book/introduction.md index c2e131e26c..3d3558203d 100644 --- a/_overviews/scala3-book/introduction.md +++ b/_overviews/scala3-book/introduction.md @@ -12,8 +12,8 @@ The goal of this book is to provide an informal introduction to the Scala langua It touches on all Scala topics, in a relatively light manner. If at any time while you’re reading this book and want more information on a specific feature, you’ll find links to our [_Reference_ documentation][reference], which covers many new features of the Scala language in more detail. -Over the course of this book, we hope to demonstrate that Scala is a beautiful, expressive programming language, with a clean, modern syntax, and supports functional programming (FP), object-oriented programming (OOP), and a fusion of FP and OOP in a typed setting. -Scala’s syntax, grammar, and features have been re-thought, debated in an open process, and updated in 2020 to be more clear and easier to understand than ever before. +Over the course of this book, we hope to demonstrate that Scala is a beautiful, expressive programming language, with a clean, modern syntax, which supports functional programming (FP) and object-oriented programming (OOP), and that provides a safe static type system. +Scala’s syntax, grammar, and features have been re-thought, debated in an open process, and updated in 2020 to be clearer and easier to understand than ever before. The book begins with a whirlwind tour of many of Scala’s features in the [“A Taste of Scala” section][taste]. After that tour, the sections that follow it provide more details on those language features. diff --git a/_overviews/scala3-book/scala-features.md b/_overviews/scala3-book/scala-features.md index 048d7e4519..f0c8efb129 100644 --- a/_overviews/scala3-book/scala-features.md +++ b/_overviews/scala3-book/scala-features.md @@ -30,8 +30,8 @@ Looking at Scala from the proverbial “30,000 foot view,” you can make the fo - It has a concise, readable syntax - It’s statically-typed (but feels dynamic) - It has an expressive type system -- It’s a pure functional programming (FP) language -- It’s a pure object-oriented programming (OOP) language +- It’s a functional programming (FP) language +- It’s an object-oriented programming (OOP) language - It supports the fusion of FP and OOP - Contextual abstractions provide a clear way to implement _term inference_ - It runs on the JVM (and in the browser) @@ -63,7 +63,7 @@ val newNumbers = double(oldNumbers) ``` That code instructs the compiler what to do on a step-by-step basis. -Instead, we write high-level, functional code using higher-order functions and lambdas like this to achieve the same effect: +Instead, we write high-level, functional code using higher-order functions and lambdas like this to compute the same result: ```scala val newNumbers = oldNumbers.map(_ * 2) @@ -92,7 +92,7 @@ nums.filter(i => i > 1) nums.filter(_ > 1) ``` -And traits, classes, and methods are defined with a clean, light syntax: +Traits, classes, and methods are defined with a clean, light syntax: ```scala trait Animal: @@ -128,15 +128,13 @@ As Heather Miller states, Scala is considered to be a [strong, statically-typed - Correctness: you catch most errors at compile-time - Great IDE support - - Code completion + - Reliable code completion - Catching errors at compile-time means catching mistakes as you type - Easy and reliable refactoring - - Reliable code completion - You can refactor your code with confidence - Method type declarations tell readers what the method does, and help serve as documentation -- Types make your code easier to maintain -- Scalability: types help ensure correctness across arbitrarily large applications and development teams -- Strong typing in combination with excellent inference enables mechanisms like [contextual abstraction]({{ site.scala3ref }}/contextual/motivation.html) that allows you to omit boilerplate code. Often, this boilerplate code can be inferred by the compiler, based on type definitions and a given context (e.g. method arguments for implicit parameters). +- Scalability and maintainability: types help ensure correctness across arbitrarily large applications and development teams +- Strong typing in combination with excellent inference enables mechanisms like [contextual abstraction]({{ site.scala3ref }}/contextual/motivation.html) that allows you to omit boilerplate code. Often, this boilerplate code can be inferred by the compiler, based on type definitions and a given context. {% comment %} In that list: @@ -156,11 +154,11 @@ In that list: - i removed these items until we can replace them: * [Compound types](/tour/compound-types.html) -* [Implicit parameters](/tour/implicit-parameters.html) and [conversions](/tour/implicit-conversions.html) +* [conversions](/tour/implicit-conversions.html) * [Explicitly typed self references](/tour/self-types.html) {% endcomment %} -Scala’s expressive type system enforces, at compile-time, that abstractions are used in a safe and coherent manner. +Scala’s type system enforces, at compile-time, that abstractions are used in a safe and coherent manner. In particular, the type system supports: - [Type inference](/tour/type-inference.html) @@ -187,11 +185,11 @@ In particular, the type system supports: In combination, these features provide a powerful basis for the safe reuse of programming abstractions and for the type-safe extension of software. -### A pure FP language +### A functional programming language Scala is a functional programming (FP) language, meaning: -- Functions are variables, and can be passed around like any other variable +- Functions are values, and can be passed around like any other value - Higher-order functions are directly supported - Lambdas are built in - Everything in Scala is an expression that returns a value @@ -200,10 +198,10 @@ Scala is a functional programming (FP) language, meaning: - Those collection classes come with dozens of functional methods: they don’t mutate the collection, but instead return an updated copy of the data -### A pure OOP language +### An object-oriented language -Scala is a _pure_ object-oriented programming (OOP) language. -Every variable is an object and every “operator” is a method. +Scala is an object-oriented programming (OOP) language. +Every value is an instance of a class and every “operator” is a method. In Scala, all types inherit from a top-level class `Any`, whose immediate children are `AnyVal` (_value types_, such as `Int` and `Boolean`) and `AnyRef` (_reference types_, as in Java). This means that the Java distinction between primitive types and boxed types (e.g. `int` vs. `Integer`) isn’t present in Scala. @@ -236,9 +234,9 @@ Following Haskell, Scala was the second popular language to have some form of _i In Scala 3 these concepts have been completely re-thought and more clearly implemented. The core idea is _term inference_: Given a type, the compiler synthesizes a “canonical” term that has that type. -In Scala, an implicit parameter directly leads to an inferred argument term that could also be written down explicitly. +In Scala, a context parameter directly leads to an inferred argument term that could also be written down explicitly. -Use cases for this concept include implementing type classes, establishing context, dependency injection, expressing capabilities, computing new types, and proving relationships between them. +Use cases for this concept include implementing [type classes]({% link _overviews/scala3-book/ca-type-classes.md %}), establishing context, dependency injection, expressing capabilities, computing new types, and proving relationships between them. Scala 3 makes this process more clear than ever before. Read about contextual abstractions in the [Reference documentation]({{ site.scala3ref }}/contextual/motivation.html). @@ -442,7 +440,7 @@ Serialization: - [ScalaPB](https://github.com/scalapb/ScalaPB) -Science and data analysis: +### Science and data analysis: - [Algebird](https://github.com/twitter/algebird) - [Spire](https://github.com/typelevel/spire) @@ -461,7 +459,7 @@ Science and data analysis: - [TensorFlow Scala](https://github.com/eaplatanios/tensorflow_scala) -### FP & FRP +### Functional Programming & Functional Reactive Programming FP: diff --git a/_overviews/scala3-book/taste-collections.md b/_overviews/scala3-book/taste-collections.md index e40b85887b..67fdbc1d61 100644 --- a/_overviews/scala3-book/taste-collections.md +++ b/_overviews/scala3-book/taste-collections.md @@ -60,15 +60,13 @@ nums.map(_.toUpperCase) // List("ONE", "TWO") nums.flatMap(_.toUpperCase) // List('O', 'N', 'E', 'T', 'W', 'O') ``` -These examples show how the “fold” and “reduce” methods are used to sum the values in a sequence of integers: +These examples show how the “foldLeft” and “reduceLeft” methods are used to sum the values in a sequence of integers: ```scala val firstTen = (1 to 10).toList // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) -firstTen.reduce(_ + _) // 55 firstTen.reduceLeft(_ + _) // 55 -firstTen.fold(100)(_ + _) // 155 (100 is a “seed” value) -firstTen.foldLeft(100)(_ + _) // 155 +firstTen.foldLeft(100)(_ + _) // 155 (100 is a “seed” value) ``` There are many more methods available to Scala collections classes, and they’re demonstrated in the [Collections chapter][collections], and in the [API Documentation][api]. @@ -93,9 +91,9 @@ val t = (11, "eleven", Person("Eleven")) Once you have a tuple, you can access its values by binding them to variables, or access them by number: ```scala -t._1 // 11 -t._2 // "eleven" -t._3 // Person("Eleven") +t(0) // 11 +t(1) // "eleven" +t(2) // Person("Eleven") ``` You can also use this _extractor_ approach to assign the tuple fields to variable names: diff --git a/_overviews/scala3-book/taste-control-structures.md b/_overviews/scala3-book/taste-control-structures.md index a527f603d2..5c30f73da4 100644 --- a/_overviews/scala3-book/taste-control-structures.md +++ b/_overviews/scala3-book/taste-control-structures.md @@ -186,7 +186,7 @@ This example shows (a) how to use a `match` expression as the body of a method, ```scala // getClassAsString is a method that takes a single argument of any type. -def getClassAsString(x: Any): String = x match +def getClassAsString(x: Matchable): String = x match case s: String => s"'$s' is a String" case i: Int => "Int" case d: Double => "Double" @@ -199,6 +199,10 @@ getClassAsString("hello") // 'hello' is a String getClassAsString(List(1, 2, 3)) // List ``` +The method `getClassAsString` takes as a parameter a value of type [Matchable]({{ site.scala3ref }}/other-new-features/matchable.html), which can be +any type supporting pattern matching (some types don’t support pattern matching because this could +break encapsulation). + There’s _much_ more to pattern matching in Scala. Patterns can be nested, results of patterns can be bound, and pattern matching can even be user-defined. See the pattern matching examples in the [Control Structures chapter][control] for more details. @@ -231,29 +235,26 @@ It’s one-line syntax looks like this: while x >= 0 do x = f(x) ``` -Again, Scala’s control structure syntax is flexible, and you can write this code in different ways depending on your preferences: +In Scala 2, the syntax was a bit different. The condition was surrounded by parentheses, and +there was no `do` keyword: ```scala while (x >= 0) do x = f(x) while (x >= 0) { x = f(x) } ``` +Scala 3 still supports the Scala 2 syntax for the sake of compatibility. + The `while` loop multiline syntax looks like this: ```scala var x = 1 -// without parentheses while x < 3 do println(x) x += 1 - -// with parentheses -while (x < 3) - println(x) - x += 1 ``` diff --git a/_overviews/scala3-book/taste-functions.md b/_overviews/scala3-book/taste-functions.md index 7977f6d600..b103dba666 100644 --- a/_overviews/scala3-book/taste-functions.md +++ b/_overviews/scala3-book/taste-functions.md @@ -11,13 +11,13 @@ next-page: taste-objects Scala has most features you’d expect in a functional programming language, including: -- Lambdas +- Lambdas (anonymous functions) - Higher-order functions (HOFs) - Immutable collections in the standard library Lambdas, also known as _anonymous functions_, are a big part of keeping your code concise but readable. -The `map` method of the `List` class is a typical example of a higher-order function---a function that takes a lambda as parameter. +The `map` method of the `List` class is a typical example of a higher-order function---a function that takes a function as parameter. These two examples are equivalent, and show how to multiply each number in a list by `2` by passing a lambda into the `map` method: diff --git a/_overviews/scala3-book/taste-methods.md b/_overviews/scala3-book/taste-methods.md index 011ba23bd7..2718059bb1 100644 --- a/_overviews/scala3-book/taste-methods.md +++ b/_overviews/scala3-book/taste-methods.md @@ -128,7 +128,7 @@ extension (s: String) ## See also Scala Methods can be much more powerful: they can take type parameters and context parameters. -They are covered in detail in the [Data Modeling][data-1] section. +They are covered in detail in the [Domain Modeling][data-1] section. diff --git a/_overviews/scala3-book/taste-modeling.md b/_overviews/scala3-book/taste-modeling.md index aaee4fa19a..20c605c6f9 100644 --- a/_overviews/scala3-book/taste-modeling.md +++ b/_overviews/scala3-book/taste-modeling.md @@ -81,7 +81,7 @@ c.stopRunning() // "No need to stop" ``` If that code makes sense---great, you’re comfortable with traits as interfaces. -If not, don’t worry, they’re explained in more detail in the [Data Modeling][data-1] chapter. +If not, don’t worry, they’re explained in more detail in the [Domain Modeling][data-1] chapter. ### Classes @@ -106,7 +106,7 @@ Notice that the class declaration creates a constructor: val p = Person("John", "Stephens") ``` -Constructors and other class-related topics are covered in the [Data Modeling][data-1] chapter. +Constructors and other class-related topics are covered in the [Domain Modeling][data-1] chapter. ## FP Domain Modeling @@ -170,7 +170,7 @@ enum Nat: case Succ(pred: Nat) ``` -Enums are covered in detail in the [Data Modeling][data-1] section of this book, and in the [Reference documentation]({{ site.scala3ref }}/enums/enums.html). +Enums are covered in detail in the [Domain Modeling][data-1] section of this book, and in the [Reference documentation]({{ site.scala3ref }}/enums/enums.html). ### Case classes @@ -183,7 +183,7 @@ When the compiler sees the `case` keyword in front of a `class` it has these eff - An `unapply` method is generated, which lets you use case classes in more ways in `match` expressions. - A `copy` method is generated in the class. This provides a way to create updated copies of the object without changing the original object. -- `equals` and `hashCode` methods are generated. +- `equals` and `hashCode` methods are generated to implement structural equality. - A default `toString` method is generated, which is helpful for debugging. @@ -206,7 +206,7 @@ case class Person( val p = Person("Reginald Kenneth Dwight", "Singer") // a good default toString method -p // Person = Person(Reginald Kenneth Dwight,Singer) +p // : Person = Person(Reginald Kenneth Dwight,Singer) // can access its fields, which are immutable p.name // "Reginald Kenneth Dwight" @@ -215,10 +215,10 @@ p.name = "Joe" // error: can’t reassign a val field // when you need to make a change, use the `copy` method // to “update as you copy” val p2 = p.copy(name = "Elton John") -p2 // Person = Person(Elton John,Singer) +p2 // : Person = Person(Elton John,Singer) ``` -See the [Data Modeling][data-1] sections for many more details on `case` classes. +See the [Domain Modeling][data-1] sections for many more details on `case` classes. diff --git a/_overviews/scala3-book/taste-objects.md b/_overviews/scala3-book/taste-objects.md index 1ba49e30d6..ae522627f1 100644 --- a/_overviews/scala3-book/taste-objects.md +++ b/_overviews/scala3-book/taste-objects.md @@ -1,7 +1,7 @@ --- -title: Objects +title: Singleton Objects type: section -description: This section provides an introduction to the use of objects in Scala 3. +description: This section provides an introduction to the use of singleton objects in Scala 3. num: 12 previous-page: taste-functions next-page: taste-collections diff --git a/_overviews/scala3-book/why-scala-3.md b/_overviews/scala3-book/why-scala-3.md index e5f317f9f3..e6c5b2bd96 100644 --- a/_overviews/scala3-book/why-scala-3.md +++ b/_overviews/scala3-book/why-scala-3.md @@ -45,7 +45,7 @@ For instance, a `List` is defined as a class---technically it’s an abstract cl val x = List(1, 2, 3) ``` -However, what appears to the programmer to be a simple `List` is actually built from a combination of several specialized types, including an abstract class named `AbstractSeq`, traits like `LinearSeq` and `LinearSeqOps`, and more. +However, what appears to the programmer to be a simple `List` is actually built from a combination of several specialized types, including abstract classes named `Iterable`, `Seq`, and `LinearSeq`. Those types are similarly composed of other small, modular units of code. In addition to building a type like `List` from a series of modular traits, the `List` API also consists of dozens of other methods, many of which are higher-order functions: @@ -67,7 +67,7 @@ The `List` class is immutable, so all of those methods return new values, as sho ## 2) A dynamic feel Scala’s _type inference_ often makes the language feel dynamically typed, even though it’s statically typed. -This is true with variable assignment: +This is true with variable declaration: ```scala val a = 1 @@ -108,7 +108,7 @@ val b: Password | Username = if (true) name else password ## 3) Concise syntax -Scala is a low ceremony, “concise but still readable” language. For instance, variable type assignment is concise: +Scala is a low ceremony, “concise but still readable” language. For instance, variable declaration is concise: ```scala val a = 1 @@ -120,8 +120,8 @@ Creating types like traits, classes, and enumerations are concise: ```scala trait Tail: - def wagTail: Unit - def stopTail: Unit + def wagTail(): Unit + def stopTail(): Unit enum Topping: case Cheese, Pepperoni, Sausage, Mushrooms, Onions @@ -151,7 +151,7 @@ All of these expressions and many more are concise, and still very readable: wha Implicits in Scala 2 were a major distinguishing design feature. They represented _the_ fundamental way to abstract over context, with a unified paradigm that served a great variety of use cases, among them: -- Implementing type classes +- Implementing [type classes]({% link _overviews/scala3-book/ca-type-classes.md %}) - Establishing context - Dependency injection - Expressing capabilities @@ -208,7 +208,7 @@ See that chapter for more details on these features. Scala can be used on the server side with terrific frameworks: - The [Play Framework](https://www.playframework.com) lets you build highly scalable server-side applications and microservices -- [Akka Actors](https://akka.io) let you use the actor model to greatly simplify parallel and concurrent software applications +- [Akka Actors](https://akka.io) let you use the actor model to greatly simplify distributed and concurrent software applications Scala can also be used in the browser with the [Scala.js project](https://www.scala-js.org), which is a type-safe replacement for JavaScript. The Scala.js ecosystem [has dozens of libraries](https://www.scala-js.org/libraries) to let you use React, Angular, jQuery, and many other JavaScript and Scala libraries in the browser. @@ -227,50 +227,50 @@ While these all use the `List` class, the same methods work with other collectio Here are some examples: ```scala -List.range(1, 3) // List(1, 2) -List.range(1, 6, 2) // List(1, 3, 5) -List.fill(3)("foo") // List(foo, foo, foo) -List.tabulate(3)(n => n * n) // List(0, 1, 4) -List.tabulate(4)(n => n * n) // List(0, 1, 4, 9) - -val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) -a.distinct // List(10, 20, 30, 40) -a.drop(2) // List(30, 40, 10) -a.dropRight(2) // List(10, 20, 30) -a.dropWhile(_ < 25) // List(30, 40, 10) -a.filter(_ < 25) // List(10, 20, 10) -a.filter(_ > 100) // List() -a.find(_ > 20) // Some(30) -a.head // 10 -a.headOption // Some(10) -a.init // List(10, 20, 30, 40) -a.intersect(List(19,20,21)) // List(20) -a.last // 10 -a.lastOption // Some(10) -a.map(_ * 2) // List(20, 40, 60, 80, 20) -a.slice(2,4) // List(30, 40) -a.tail // List(20, 30, 40, 10) -a.take(3) // List(10, 20, 30) -a.takeRight(2) // List(40, 10) -a.takeWhile(_ < 30) // List(10, 20) -a.filter(_ < 30).map(_ * 10) // List(100, 200) +List.range(1, 3) // List(1, 2) +List.range(start = 1, end = 6, step = 2) // List(1, 3, 5) +List.fill(3)("foo") // List(foo, foo, foo) +List.tabulate(3)(n => n * n) // List(0, 1, 4) +List.tabulate(4)(n => n * n) // List(0, 1, 4, 9) + +val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) +a.distinct // List(10, 20, 30, 40) +a.drop(2) // List(30, 40, 10) +a.dropRight(2) // List(10, 20, 30) +a.dropWhile(_ < 25) // List(30, 40, 10) +a.filter(_ < 25) // List(10, 20, 10) +a.filter(_ > 100) // List() +a.find(_ > 20) // Some(30) +a.head // 10 +a.headOption // Some(10) +a.init // List(10, 20, 30, 40) +a.intersect(List(19,20,21)) // List(20) +a.last // 10 +a.lastOption // Some(10) +a.map(_ * 2) // List(20, 40, 60, 80, 20) +a.slice(2, 4) // List(30, 40) +a.tail // List(20, 30, 40, 10) +a.take(3) // List(10, 20, 30) +a.takeRight(2) // List(40, 10) +a.takeWhile(_ < 30) // List(10, 20) +a.filter(_ < 30).map(_ * 10) // List(100, 200) val fruits = List("apple", "pear") -fruits.map(_.toUpperCase) // List(APPLE, PEAR) -fruits.flatMap(_.toUpperCase) // List(A, P, P, L, E, P, E, A, R) +fruits.map(_.toUpperCase) // List(APPLE, PEAR) +fruits.flatMap(_.toUpperCase) // List(A, P, P, L, E, P, E, A, R) val nums = List(10, 5, 8, 1, 7) -nums.sorted // List(1, 5, 7, 8, 10) -nums.sortWith(_ < _) // List(1, 5, 7, 8, 10) -nums.sortWith(_ > _) // List(10, 8, 7, 5, 1) +nums.sorted // List(1, 5, 7, 8, 10) +nums.sortWith(_ < _) // List(1, 5, 7, 8, 10) +nums.sortWith(_ > _) // List(10, 8, 7, 5, 1) ``` -## 8) Built-in practices +## 8) Built-in best practices Scala idioms encourage best practices in many ways. -For immutability, you’re encouraged to create immutable `val` fields: +For immutability, you’re encouraged to create immutable `val` declarations: ```scala val a = 1 // immutable variable @@ -283,7 +283,7 @@ val b = List(1,2,3) // List is immutable val c = Map(1 -> "one") // Map is immutable ``` -Case classes are primarily intended for use in functional programming, and their parameters are immutable: +Case classes are primarily intended for use in [domain modeling]({% link _overviews/scala3-book/domain-modeling-intro.md %}), and their parameters are immutable: ```scala case class Person(name: String) @@ -386,6 +386,7 @@ _Safety_ is related to several new and changed features: - Multiversal equality - Restricting implicit conversions - Null safety +- Safe initialization Good examples of _ergonomics_ are enumerations and extension methods, which have been added to Scala 3 in a very readable manner: diff --git a/scala3/contribute-to-docs.md b/scala3/contribute-to-docs.md index 91b467766f..642a12f2c0 100644 --- a/scala3/contribute-to-docs.md +++ b/scala3/contribute-to-docs.md @@ -16,7 +16,7 @@ We welcome contributions from the community to every aspect of the documentation ### How can I contribute? -In general, there is many different ways you could help us: +In general, there are many ways you can help us: - **Confused about something in any of the docs?** Open an issue. - **Found something not up-to-date?** Open an issue or create a PR. From 5bc689d64915c1e7f90a6d821e2adc7aa3c36a47 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 7 Jun 2021 18:35:57 +0200 Subject: [PATCH 1508/3075] Some suggestions in the Scala 3 book (2) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I’ve reviewed the following chapters: - a first look at types - control structures - domain modeling Here are some simple suggestions, or typos fixes. --- _overviews/scala3-book/control-structures.md | 34 ++++++------------- _overviews/scala3-book/domain-modeling-fp.md | 2 +- _overviews/scala3-book/domain-modeling-oop.md | 21 ++++++------ .../scala3-book/domain-modeling-tools.md | 20 +---------- _overviews/scala3-book/first-look-at-types.md | 7 ++-- 5 files changed, 27 insertions(+), 57 deletions(-) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index a1fd727a3d..50f81a2b1b 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -144,26 +144,14 @@ scala> for i <- ints do println(i) 3 ```` -When you need a multiline block of code following the `for` generator, use either of these approaches: +When you need a multiline block of code following the `for` generator, use the following syntax: ```scala -// option 1 for i <- ints do val x = i * 2 println(s"i = $i, x = $x") - -// option 2 -for (i <- ints) - val x = i * 2 - println(s"i = $i, x = $x") - -// option 3 -for (i <- ints) { - val x = i * 2 - println(s"i = $i, x = $x") -} ``` ### Multiple generators @@ -276,7 +264,7 @@ val list = yield i * 2 -// result: list == Vector(20, 22, 24) +// list: IndexedSeq[Int] = Vector(20, 22, 24) ``` After that `for` expression runs, the variable `list` is a `Vector` that contains the values shown. @@ -288,7 +276,7 @@ This is how the expression works: It multiples it by `2`, then yields the value `22`. You can think of these yielded values as accumulating in a temporary holding place. 3. Finally the loop gets the number `12` from the range, multiplies it by `2`, yielding the number `24`. - The loop completes at this point and yields the final result, the `Vector(20,22,24)`. + The loop completes at this point and yields the final result, the `Vector(20, 22, 24)`. {% comment %} NOTE: This is a place where it would be great to have a TIP or NOTE block: @@ -297,7 +285,7 @@ NOTE: This is a place where it would be great to have a TIP or NOTE block: While the intent of this section is to demonstrate `for` expressions, it can help to know that the `for` expression shown is equivalent to this `map` method call: ```scala -val list = (10 to 12).map { i => i * 2} +val list = (10 to 12).map(i => i * 2) ``` `for` expressions can be used any time you need to traverse all of the elements in a collection and apply an algorithm to those elements to create a new list. @@ -312,7 +300,7 @@ val capNames = for name <- names yield val capName = nameWithoutUnderscore.capitalize capName -// result: List[String] = List(Olivia, Walter, Peter) +// capNames: List[String] = List(Olivia, Walter, Peter) ``` @@ -329,7 +317,7 @@ def between3and10(xs: List[Int]): List[Int] = if x <= 10 yield x -between3and10(List(1, 3, 7, 11)) // result: List(3, 7) +between3and10(List(1, 3, 7, 11)) // : List[Int] = List(3, 7) ``` @@ -386,7 +374,7 @@ If it’s between `0` and `6`, `day` is bound to a string that represents one of Otherwise, the catch-all case is represented by the `_` character, and `day` is bound to the string, `"invalid day"`. > When writing simple `match` expressions like this, it’s recommended to use the `@switch` annotation on the variable `i`. -> This annotation provides a compile time warning if the switch can’t be compiled to a `tableswitch` or `lookupswitch`, which are better for performance. +> This annotation provides a compile-time warning if the switch can’t be compiled to a `tableswitch` or `lookupswitch`, which are better for performance. ### Using the default value @@ -417,7 +405,7 @@ val evenOrOdd = i match ``` -### Using `if` expressions in `case` statements +### Using `if` guards in `case` clauses You can also use guards in the `case`s of a match expression. In this example the second and third `case` both use guards to match multiple integer values: @@ -528,8 +516,8 @@ def pattern(x: Matchable): String = x match case a: Array[Int] => s"array of int: ${a.mkString(",")}" case as: Array[String] => s"string array: ${as.mkString(",")}" case d: Dog => s"dog: ${d.name}" - case list: List[_] => s"got a List: $list" - case m: Map[_, _] => m.toString + case list: List[?] => s"got a List: $list" + case m: Map[?, ?] => m.toString // the default wildcard pattern case _ => "Unknown" @@ -561,7 +549,7 @@ finally println("Came to the 'finally' clause.") ``` -Assuming that the `openAndReadAFile` method uses the Java `java.io._` classes to read a file and doesn’t catch its exceptions, attempting to open and read a file can result in both a `FileNotFoundException` and an `IOException`, and those two exceptions are caught in the `catch` block of this example. +Assuming that the `openAndReadAFile` method uses the Java `java.io.*` classes to read a file and doesn’t catch its exceptions, attempting to open and read a file can result in both a `FileNotFoundException` and an `IOException`, and those two exceptions are caught in the `catch` block of this example. [matchable]: {{ site.scala3ref }}/other-new-features/matchable.html diff --git a/_overviews/scala3-book/domain-modeling-fp.md b/_overviews/scala3-book/domain-modeling-fp.md index 4d42dc6abb..dec7dda6d2 100644 --- a/_overviews/scala3-book/domain-modeling-fp.md +++ b/_overviews/scala3-book/domain-modeling-fp.md @@ -43,7 +43,7 @@ An FP design is implemented in a similar way: > As we will see, reasoning about programs in this style is quite different from the object-oriented programming. > Data in FP simply **is**: -> Separating functionality from your data let's you inspect your data without having to worry about behavior. +> Separating functionality from your data lets you inspect your data without having to worry about behavior. In this chapter we’ll model the data and operations for a “pizza” in a pizza store. You’ll see how to implement the “data” portion of the Scala/FP model, and then you’ll see several different ways you can organize the operations on that data. diff --git a/_overviews/scala3-book/domain-modeling-oop.md b/_overviews/scala3-book/domain-modeling-oop.md index 10821996d9..c06260d84d 100644 --- a/_overviews/scala3-book/domain-modeling-oop.md +++ b/_overviews/scala3-book/domain-modeling-oop.md @@ -89,12 +89,11 @@ When designing software in Scala, it’s often helpful to only consider using cl NOTE: I think “leaves” may technically be the correct word to use, but I prefer “leafs.” {% endcomment %} -```text -traits T1 T2 ... T3 -composed traits S extends T1, T2 ... S extends T2, T3 -classes C extends S, T3 -instances new C -``` +| Traits | `T1`, `T2`, `T3` +| Composed traits | `S extends T1, T2`, `S extends T2, T3` +| Classes | `C extends S, T3` +| Instances | `C()` + This is even more the case in Scala 3, where traits now can also take parameters, further eliminating the need for classes. #### Defining Classes @@ -147,7 +146,7 @@ class Counter: // can only be observed by the method `count` private var currentCount = 0 - def tick() = currentCount += 1 + def tick(): Unit = currentCount += 1 def count: Int = currentCount ``` Every instance of the class `Counter` has its own private state that can only be observed through the method `count`, as the following interaction illustrates: @@ -198,7 +197,7 @@ There are a few things that need explanation. #### Abstract Type Members The declaration `type S <: Subject` says that within the trait `SubjectObserver` we can refer to some _unknown_ (that is, abstract) type that we call `S`. However, the type is not completely unknown: we know at least that it is _some subtype_ of the trait `Subject`. -All traits and classes extending `SubjectObserer` are free to chose any type for `S` as long as the chosen type is a subtype of `Subject`. +All traits and classes extending `SubjectObserer` are free to choose any type for `S` as long as the chosen type is a subtype of `Subject`. The `<: Subject` part of the declaration is also referred to as an _upper bound on `S`_. #### Nested Traits @@ -210,12 +209,12 @@ The second trait, `Subject`, defines one private field `observers` to store all Subscribing to a subject simply stores the object into this list. Again, the type of parameter `obs` is `O`, not `Observer`. -#### Selftype Annotations +#### Self-type Annotations Finally, you might have wondered what the `self: S =>` on trait `Subject` is supposed to mean. -This is called a _selftype annotation_. +This is called a _self-type annotation_. It requires subtypes of `Subject` to also be subtypes of `S`. This is necessary to be able to call `obs.notify` with `this` as an argument, since it requires a value of type `S`. -If `S` was a _concrete_ type, the selftype annotation could be replaced by `trait Subject extends S`. +If `S` was a _concrete_ type, the self-type annotation could be replaced by `trait Subject extends S`. ### Implementing the Component We can now implement the above component and define the abstract type members to be concrete types: diff --git a/_overviews/scala3-book/domain-modeling-tools.md b/_overviews/scala3-book/domain-modeling-tools.md index bd9e955ba5..b8fd76f2fc 100644 --- a/_overviews/scala3-book/domain-modeling-tools.md +++ b/_overviews/scala3-book/domain-modeling-tools.md @@ -33,27 +33,9 @@ class Movie(var name: String, var director: String, var year: Int) ``` These examples show that Scala has a very lightweight way to declare classes. -The definition of the class `Person` roughly corresponds to the following, more explicit, version: - -```scala -class Person: - // fields - var name: String = null - var vocation: String = null - - // constructor - def this(_name: String, _vocation: String) = - // call to the super constructor - this() - // assigning the fields - name = _name - vocation = _vocation -``` - -This version defines the two fields `name` and `vocation`, together with a constructor that accepts values for those two fields and assigns them. All of the parameters of our example classes are defined as `var` fields, which means they are mutable: you can read them, and also modify them. -If you want them to be immutable---read only---create them as `val` fields instead. +If you want them to be immutable---read only---create them as `val` fields instead, or use a case class. Prior to Scala 3, you used the `new` keyword to create a new instance of a class: diff --git a/_overviews/scala3-book/first-look-at-types.md b/_overviews/scala3-book/first-look-at-types.md index 0a14e41a8c..106f564258 100644 --- a/_overviews/scala3-book/first-look-at-types.md +++ b/_overviews/scala3-book/first-look-at-types.md @@ -267,13 +267,14 @@ A common use is to signal non-termination, such as a thrown exception, program e `Null` is a subtype of all reference types (i.e. any subtype of `AnyRef`). It has a single value identified by the keyword literal `null`. -`Null` is provided mostly for interoperability with other JVM languages and should almost never be used in Scala code. -Alternatives to `null` are discussed in the [Functional Programming chapter][fp] of this book, and the [API documentation][option-api]. - +Currently, the usage of `null` is considered bad practice. It should be used mostly for interoperability with other JVM languages. An opt-in compiler option changes the status of `Null` to fix the caveats related to its usage. This option might become the default in a future version of Scala. You can learn more about it [here][safe-null]. +In the meantime, `null` should almost never be used in Scala code. +Alternatives to `null` are discussed in the [Functional Programming chapter][fp] of this book, and the [API documentation][option-api]. [reference]: {{ site.scala3ref }}/overview.html [matchable]: {{ site.scala3ref }}/other-new-features/matchable.html [interpolation]: {% link _overviews/core/string-interpolation.md %} [fp]: {% link _overviews/scala3-book/fp-intro.md %} [option-api]: https://dotty.epfl.ch/api/scala/Option.html +[safe-null]: {{ site.scala3ref }}/other-new-features/explicit-nulls.html From 84ef96cf45c0c27a59fda3162b529e01d210f6c8 Mon Sep 17 00:00:00 2001 From: SourceCodeBot Date: Mon, 14 Jun 2021 21:14:46 +0200 Subject: [PATCH 1509/3075] fix: fix syntax issue with arguments --- _overviews/scala3-book/ca-given-using-clauses.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/ca-given-using-clauses.md b/_overviews/scala3-book/ca-given-using-clauses.md index dd1b4ccc1b..5ba38fd64b 100644 --- a/_overviews/scala3-book/ca-given-using-clauses.md +++ b/_overviews/scala3-book/ca-given-using-clauses.md @@ -26,7 +26,7 @@ def renderWebsite(path: String, c: Config): String = def renderWidget(items: List[String], c: Config): String = ??? val config = Config(8080, "docs.scala-lang.org") -renderWebsite("/home")(config) +renderWebsite("/home", config) ``` Let us assume that the configuration does not change throughout most of our code base. Passing `c` to each and every method call (like `renderWidget`) becomes very tedious and makes our program more difficult to read, since we need to ignore the `c` argument. From 83206c35bbfeaafe52ae49bd92d709894e76d1f3 Mon Sep 17 00:00:00 2001 From: Stephan Schneider Date: Mon, 14 Jun 2021 21:32:28 +0200 Subject: [PATCH 1510/3075] Update index.md typo --- _overviews/FAQ/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 0e4b7200ad..e7d25dbcf5 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -188,7 +188,7 @@ differ from a function value such as: Note that in **Scala 3** most of the differences will go; for example, they will be able to [accept implicit parameters](https://dotty.epfl.ch/docs/reference/contextual/context-functions.html) -as well as [type parameterts](https://dotty.epfl.ch/docs/reference/new-types/polymorphic-function-types.html). +as well as [type parameters](https://dotty.epfl.ch/docs/reference/new-types/polymorphic-function-types.html). Nevertheless, it is still recommended to use methods most of the time, unless you absolutely need a function. And, thanks to From f6943140ff557f826c81e2d46ea96d72f6a83011 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 14 Jun 2021 17:04:36 +0200 Subject: [PATCH 1511/3075] Suggestions in the Scala 3 book (part 4) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I’ve reviewed the following chapters: - Scala Collections - Functional Programming - Types and the Type System - Contextual Abstractions --- _overviews/scala3-book/ca-context-bounds.md | 2 +- .../scala3-book/ca-given-using-clauses.md | 2 +- .../scala3-book/ca-implicit-conversions.md | 11 +++--- _overviews/scala3-book/collections-classes.md | 36 ++++++++++--------- _overviews/scala3-book/collections-methods.md | 16 ++++----- .../fp-functional-error-handling.md | 18 +++++----- _overviews/scala3-book/types-inferred.md | 2 +- _overviews/scala3-book/types-type-classes.md | 4 +-- _overviews/scala3-book/types-variance.md | 16 ++++----- 9 files changed, 57 insertions(+), 50 deletions(-) diff --git a/_overviews/scala3-book/ca-context-bounds.md b/_overviews/scala3-book/ca-context-bounds.md index fd435eb68f..462774a2d4 100644 --- a/_overviews/scala3-book/ca-context-bounds.md +++ b/_overviews/scala3-book/ca-context-bounds.md @@ -13,7 +13,7 @@ next-page: ca-given-imports - TODO: define "synthesized" and "synthesized arguments" {% endcomment %} -In many situations the name of a _context parameter_ doesn’t have to be mentioned explicitly, since it’s only used in synthesized arguments for other context parameters. +In many situations the name of a _context parameter_ doesn’t have to be mentioned explicitly, since it’s only used by the compiler in synthesized arguments for other context parameters. In that case you don’t have to define a parameter name, and can just provide the parameter type. diff --git a/_overviews/scala3-book/ca-given-using-clauses.md b/_overviews/scala3-book/ca-given-using-clauses.md index dd1b4ccc1b..39af385316 100644 --- a/_overviews/scala3-book/ca-given-using-clauses.md +++ b/_overviews/scala3-book/ca-given-using-clauses.md @@ -47,7 +47,7 @@ The Scala compiler thus performs **term inference**. In our call to `renderWidget(List("cart"))` the Scala compiler will see that there is a term of type `Config` in scope (the `c`) and automatically provide it to `renderWidget`. So the program is equivalent to the one above. -In fact, since we do not need to refer to `c` in our implementation of `renderWebsite` anymore, we can even omit it in the signature: +In fact, since we do not need to refer to `c` in our implementation of `renderWebsite` anymore, we can even omit its name in the signature: ```scala // no need to come up with a parameter name diff --git a/_overviews/scala3-book/ca-implicit-conversions.md b/_overviews/scala3-book/ca-implicit-conversions.md index 4a421da97b..d04cefa104 100644 --- a/_overviews/scala3-book/ca-implicit-conversions.md +++ b/_overviews/scala3-book/ca-implicit-conversions.md @@ -8,8 +8,8 @@ next-page: ca-summary --- -Implicit conversions are defined by `given` instances of the _scala.Conversion_ class. -For example, not accounting for possible conversion errors, this code defines an an implicit conversion from `String` to `Int`: +Implicit conversions are defined by `given` instances of the `scala.Conversion` class. +For example, not accounting for possible conversion errors, this code defines an implicit conversion from `String` to `Int`: ```scala given Conversion[String, Int] with @@ -34,10 +34,13 @@ def plus1(i: Int) = i + 1 plus1("1") ``` +> Note the clause `import scala.language.implicitConversions` at the beginning, +> to enable implicit conversions in the file. + ## Discussion -The Predef package contains “auto-boxing” conversions that map primitive number types to subclasses of _java.lang.Number_. -For instance, the conversion from `Int` to _java.lang.Integer_ can be defined as follows: +The Predef package contains “auto-boxing” conversions that map primitive number types to subclasses of `java.lang.Number`. +For instance, the conversion from `Int` to `java.lang.Integer` can be defined as follows: ```scala given int2Integer: Conversion[Int, java.lang.Integer] = diff --git a/_overviews/scala3-book/collections-classes.md b/_overviews/scala3-book/collections-classes.md index 7226398406..e9b7adec45 100644 --- a/_overviews/scala3-book/collections-classes.md +++ b/_overviews/scala3-book/collections-classes.md @@ -28,9 +28,9 @@ When you need more flexibility, see these pages at the end of this section for m Looking at Scala collections from a high level, there are three main categories to choose from: -- **Sequences** are a linear collection of elements and may be _indexed_ (like an array) or _linear_ (like a linked list) +- **Sequences** are a sequential collection of elements and may be _indexed_ (like an array) or _linear_ (like a linked list) - **Maps** contain a collection of key/value pairs, like a Java `Map`, Python dictionary, or Ruby `Hash` -- **Sets** are an unordered sequence of unique elements +- **Sets** are an unordered collection of unique elements All of those are basic types, and have subtypes for specific purposes, such as concurrency, caching, and streaming. In addition to those three main categories, there are other useful collection types, including ranges, stacks, and queues. @@ -74,7 +74,7 @@ The main collections you’ll use on a regular basis are: | `LazyList` | ✓ | | A lazy immutable linked list, its elements are computed only when they’re needed; Good for large or infinite sequences. | | `ArrayBuffer` | | ✓ | The go-to type for a mutable, indexed sequence | | `ListBuffer` | | ✓ | Used when you want a mutable `List`; typically converted to a `List` | -| `Map` | ✓ | ✓ | An iterable sequence that consists of pairs of keys and values. | +| `Map` | ✓ | ✓ | An iterable collection that consists of pairs of keys and values. | | `Set` | ✓ | ✓ | An iterable collection with no duplicate elements | As shown, `Map` and `Set` come in both immutable and mutable versions. @@ -109,7 +109,7 @@ For example, if you need an immutable, indexed collection, in general you should Conversely, if you need a mutable, indexed collection, use an `ArrayBuffer`. > `List` and `Vector` are often used when writing code in a functional style. -> `ArrayBuffer` is commonly used when writing code in a mutable style. +> `ArrayBuffer` is commonly used when writing code in an imperative style. > `ListBuffer` is used when you’re mixing styles, such as building a list. The next several sections briefly demonstrate the `List`, `Vector`, and `ArrayBuffer` types. @@ -291,7 +291,7 @@ val nums = Vector(1, 2, 3, 4, 5) val strings = Vector("one", "two") -case class Person(val name: String) +case class Person(name: String) val people = Vector( Person("Bert"), Person("Ernie"), @@ -383,10 +383,9 @@ Or if you prefer methods with textual names you can also use `append`, `appendAl Here are some examples of `+=` and `++=`: ```scala -var nums = ArrayBuffer(1, 2, 3) // ArrayBuffer(1, 2, 3) +val nums = ArrayBuffer(1, 2, 3) // ArrayBuffer(1, 2, 3) nums += 4 // ArrayBuffer(1, 2, 3, 4) -nums += (5, 6) // ArrayBuffer(1, 2, 3, 4, 5, 6) -nums ++= List(7, 8) // ArrayBuffer(1, 2, 3, 4, 5, 6, 7, 8) +nums ++= List(5, 6) // ArrayBuffer(1, 2, 3, 4, 5, 6) ``` ### Removing elements from an ArrayBuffer @@ -415,7 +414,7 @@ a.update(0, 10) // ArrayBuffer(10, 2, 50, 4) ## Maps -A `Map` is an iterable sequence that consists of pairs of keys and values. +A `Map` is an iterable collection that consists of pairs of keys and values. Scala has both mutable and immutable `Map` types, and this section demonstrates how to use the _immutable_ `Map`. ### Creating an immutable Map @@ -433,13 +432,13 @@ val states = Map( Once you have a `Map` you can traverse its elements in a `for` loop like this: ```scala -for ((k,v) <- states) println(s"key: $k, value: $v") +for (k, v) <- states do println(s"key: $k, value: $v") ``` The REPL shows how this works: ```` -scala> for ((k,v) <- states) println(s"key: $k, value: $v") +scala> for (k, v) <- states do println(s"key: $k, value: $v") key: AK, value: Alaska key: AL, value: Alabama key: AZ, value: Arizona @@ -463,7 +462,7 @@ Add elements to an immutable map using `+` and `++`, remembering to assign the r ```scala val a = Map(1 -> "one") // a: Map(1 -> one) val b = a + (2 -> "two") // b: Map(1 -> one, 2 -> two) -val c = b + ( +val c = b ++ Seq( 3 -> "three", 4 -> "four" ) @@ -482,13 +481,13 @@ val a = Map( 4 -> "four" ) -a - 4 // Map(1 -> one, 2 -> two, 3 -> three) -a - 4 - 3 // Map(1 -> one, 2 -> two) +val b = a - 4 // b: Map(1 -> one, 2 -> two, 3 -> three) +val c = a - 4 - 3 // c: Map(1 -> one, 2 -> two) ``` ### Updating Map elements -To update elements in an immutable map, use the `updated` method while assigning the result to a new variable: +To update elements in an immutable map, use the `updated` method (or the `+` operator) while assigning the result to a new variable: ```scala val a = Map( @@ -497,7 +496,8 @@ val a = Map( 3 -> "three" ) -val b = a.updated(3, "THREE!") // Map(1 -> one, 2 -> two, 3 -> THREE!) +val b = a.updated(3, "THREE!") // b: Map(1 -> one, 2 -> two, 3 -> THREE!) +val c = a + (2 -> "TWO...") // c: Map(1 -> one, 2 -> TWO..., 3 -> three) ``` ### Traversing a Map @@ -511,7 +511,7 @@ val states = Map( "AZ" -> "Arizona" ) -for ((k,v) <- states) println(s"key: $k, value: $v") +for (k, v) <- states do println(s"key: $k, value: $v") ``` That being said, there are _many_ ways to work with the keys and values in a map. @@ -558,6 +558,8 @@ val c = b ++ Seq(4, 1, 5, 5) // HashSet(5, 1, 2, 3, 4) Notice that when you attempt to add duplicate elements, they’re quietly dropped. +Also notice that the order of iteration of the elements is arbitrary. + ### Deleting elements from a Set diff --git a/_overviews/scala3-book/collections-methods.md b/_overviews/scala3-book/collections-methods.md index 3e6c208a21..4316dea761 100644 --- a/_overviews/scala3-book/collections-methods.md +++ b/_overviews/scala3-book/collections-methods.md @@ -34,7 +34,7 @@ The following methods work on all of the sequence types, including `List`, `Vect ## Examples of common methods To give you an overview of what you’ll see in the following sections, these examples show some of the most commonly used collections methods. -First, here are some methods don’t use lambdas: +First, here are some methods that don’t use lambdas: ```scala val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) @@ -103,7 +103,7 @@ a.map(double(_)) a.map(double) ``` -In the last example, when an anonymous function consists of one statement that takes a single argument, you don’t have to name the argument, so even `-` isn’t required. +In the last example, when an anonymous function consists of one function call that takes a single argument, you don’t have to name the argument, so even `_` isn’t required. Finally, you can combine HOFs as desired to solve problems: @@ -217,10 +217,10 @@ david ## `head` The `head` method comes from Lisp and other earlier functional programming languages. -It’s used to print the first element (the head element) of a list: +It’s used to access the first element (the head element) of a list: ```scala -oneToTen.head // Int = 1 +oneToTen.head // 1 names.head // adam ``` @@ -228,8 +228,8 @@ Because a `String` can be seen as a sequence of characters, you can also treat i This is how `head` works on these strings: ```scala -"foo".head // Char = 'f' -"bar".head // Char = 'b' +"foo".head // 'f' +"bar".head // 'b' ``` `head` is a great method to work with, but as a word of caution it can also throw an exception when called on an empty collection: @@ -242,7 +242,7 @@ emptyList.head // java.util.NoSuchElementException: head of empty Because of this you may want to use `headOption` instead of `head`, especially when programming in a functional style: ```scala -emptyList.headOption // Option[Int] = None +emptyList.headOption // None ``` As shown, it doesn’t throw an exception, it simply returns the type `Option` that has the value `None`. @@ -256,7 +256,7 @@ The `tail` method also comes from Lisp, and it’s used to print every element i A few examples demonstrate this: ```scala -oneToTen.head // Int = 1 +oneToTen.head // 1 oneToTen.tail // List(2, 3, 4, 5, 6, 7, 8, 9, 10) names.head // adam diff --git a/_overviews/scala3-book/fp-functional-error-handling.md b/_overviews/scala3-book/fp-functional-error-handling.md index ee33cffe11..d56dfff3a6 100644 --- a/_overviews/scala3-book/fp-functional-error-handling.md +++ b/_overviews/scala3-book/fp-functional-error-handling.md @@ -106,7 +106,7 @@ makeInt(x) match case None => println("That didn’t work.") ``` -In this example, if `x` can be converted to an `Int`, the first `case` statement is executed; if `x` can’t be converted to an `Int`, the second `case` statement is executed. +In this example, if `x` can be converted to an `Int`, the expression on the right-hand side of the first `case` clause is evaluated; if `x` can’t be converted to an `Int`, the expression on the right-hand side of the second `case` clause is evaluated. @@ -240,19 +240,20 @@ makeInt(x) match Getting back to `null` values, a place where a `null` value can silently creep into your code is with a class like this: ```scala -class Address: +class Address( var street1: String, var street2: String, - var city: String, - var state: String, + var city: String, + var state: String, var zip: String +) ``` While every address on Earth has a `street1` value, the `street2` value is optional. As a result, the `street2` field can be assigned a `null` value: ```scala -val santa = new Address( +val santa = Address( "1 Main Street", null, // <-- D’oh! A null value! "North Pole", @@ -265,18 +266,19 @@ Historically, developers have used blank strings and null values in this situati In Scala---and other modern languages---the correct solution is to declare up front that `street2` is optional: ```scala -class Address: +class Address( var street1: String, var street2: Option[String], // an optional value var city: String, var state: String, var zip: String +) ``` Now developers can write more accurate code like this: ```scala -val santa = new Address( +val santa = Address( "1 Main Street", None, // 'street2' has no value "North Pole", @@ -288,7 +290,7 @@ val santa = new Address( or this: ```scala -val santa = new Address( +val santa = Address( "123 Main Street", Some("Apt. 2B"), "Talkeetna", diff --git a/_overviews/scala3-book/types-inferred.md b/_overviews/scala3-book/types-inferred.md index fab485fecc..d56bafb629 100644 --- a/_overviews/scala3-book/types-inferred.md +++ b/_overviews/scala3-book/types-inferred.md @@ -12,7 +12,7 @@ As with other statically typed programming languages, in Scala you can _declare_ ```scala val x: Int = 1 -val x: Double = 1 +val y: Double = 1 ``` In those examples the types are _explicitly_ declared to be `Int` and `Double`, respectively. diff --git a/_overviews/scala3-book/types-type-classes.md b/_overviews/scala3-book/types-type-classes.md index 239866ecb7..24619309d1 100644 --- a/_overviews/scala3-book/types-type-classes.md +++ b/_overviews/scala3-book/types-type-classes.md @@ -23,7 +23,7 @@ In Scala 3, _type classes_ are just _traits_ with one or more type parameters, l trait Show[A]: def show(a: A): String ``` -Instances of `Show` for a particular type `A` witness that `A` we can show an instance of type `A`. +Instances of `Show` for a particular type `A` witness that we can show (i.e., produce a text representation of) an instance of type `A`. For example, let’s look at the following `Show` instance for `Int` values: ```scala @@ -43,7 +43,7 @@ toHtml(42)(ShowInt()) // results in "

    The number is 42!

    " ``` -#### Automatically passing Type Class Instances +#### Automatically passing type class instances Since type classes are a very important way to structure software, Scala 3 offers additional features that make working with them very convenient. We discuss these additional features (which fall into the category of *Contextual Abstractions*) in a [later chapter][typeclasses-chapter] of this book. diff --git a/_overviews/scala3-book/types-variance.md b/_overviews/scala3-book/types-variance.md index 5eec37b647..90ee0d04ba 100644 --- a/_overviews/scala3-book/types-variance.md +++ b/_overviews/scala3-book/types-variance.md @@ -22,11 +22,11 @@ Let us also assume the following parameterized types: trait Pipeline[T]: def process(t: T): T -// an example of an covariant type +// an example of a covariant type trait Producer[+T]: def make: T -// an example of an contravariant type +// an example of a contravariant type trait Consumer[-T]: def take(t: T): Unit ``` @@ -73,7 +73,7 @@ In contrast to `Pipeline`, which is invariant, the type `Producer` is marked as This is valid, since the type parameter is only used in a _return position_. Marking it as covariant means that we can pass (or return) a `Producer[Book]` where a `Producer[Buyable]` is expected. -And in fact, this is sound: The type of `Producer[Buyable].make` only promises to _return_ a `Buyable`. +And in fact, this is sound. The type of `Producer[Buyable].make` only promises to _return_ a `Buyable`. As a caller of `make`, we will be happy to also accept a `Book`, which is a subtype of `Buyable`---that is, it is _at least_ a `Buyable`. This is illustrated by the following example, where the function `makeTwo` expects a `Producer[Buyable]`: @@ -108,12 +108,12 @@ They have an additional ISBN method in our example, but you are free to ignore t In contrast to the type `Producer`, which is marked as covariant, the type `Consumer` is marked as **contravariant** by prefixing the type parameter with a `-`. This is valid, since the type parameter is only used in an _argument position_. -Marking it as contravariant means that we can pass (or return) a `Producer[Item]` where a `Producer[Buyable]` is expected. -That is, we have the subtyping relationship `Producer[Item] <: Producer[Buyable]`. -Remember, for type `Consumer`, it was the other way around, and we had `Consumer[Buyable] <: Consumer[Item]`. +Marking it as contravariant means that we can pass (or return) a `Consumer[Item]` where a `Consumer[Buyable]` is expected. +That is, we have the subtyping relationship `Consumer[Item] <: Consumer[Buyable]`. +Remember, for type `Producer`, it was the other way around, and we had `Producer[Buyable] <: Producer[Item]`. -And in fact, this is sound: The type of `Producer[Buyable].make` only promises us to _return_ a `Buyable`. -As a caller of `make`, we will be happy to also accept a `Book`, which is a subtype of `Buyable`---that is, it is _at least_ a `Buyable`. +And in fact, this is sound. The method `Consumer[Item].take` accepts an `Item`. +As a caller of `take`, we can also supply a `Buyable`, which will be happily accepted by the `Consumer[Item]` since `Buyable` is a subtype of `Item`---that is, it is _at least_ an `Item`. #### Contravariant Types for Consumers From 592063af448278ba521e82dac23ebc6b4fb1122a Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 15 Jun 2021 12:57:20 -0700 Subject: [PATCH 1512/3075] update FAQ for Scala 3 release (#2074) --- _overviews/FAQ/index.md | 33 ++++++++++++++------------------- 1 file changed, 14 insertions(+), 19 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index e7d25dbcf5..ba0cce896d 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -2,14 +2,14 @@ layout: singlepage-overview title: Scala FAQ permalink: /tutorials/FAQ/index.html -redirect_from: +redirect_from: - "/tutorials/FAQ/breakout.html" - "/tutorials/FAQ/chaining-implicits.html" - "/tutorials/FAQ/collections.html" - "/tutorials/FAQ/context-bounds.html" - "/tutorials/FAQ/finding-implicits.html" - "/tutorials/FAQ/finding-symbols.html" - - "/tutorials/FAQ/stream-view.html" + - "/tutorials/FAQ/stream-view.html" - "/tutorials/FAQ/yield.html" --- @@ -35,25 +35,21 @@ are out there; there are many. You can go on the [Scala room on Gitter](https://gitter.im/scala/scala) or another community forum and -ask for book recommendations, but note that you'll get more helpful +ask for book recommendations. You'll get more helpful answers if you provide some information about your background and your reasons for wanting to learn Scala. ### Should I learn Scala 2, or Scala 3? -The default choice remains Scala 2 for now. Most Scala jobs are Scala -2 jobs; most Scala books and online learning materials cover Scala 2; -tooling and library support is strongest in Scala 2; and so on. +Scala 3 was released in May 2021. Because Scala 3 is still so new, +most Scala jobs are Scala 2 jobs; most Scala books and online learning +materials cover Scala 2; tooling and library support is strongest in +Scala 2; and so on. -Scala 3.0.0 is planned for release in 2021, and a number of -Scala 3 books will come out in 2021 as well. In time, there will -be more and more Scala 3 jobs as well. +Thus, Scala 2 remains a common and reasonable choice. -### When is Scala 3 coming out? - -In 2021. Watch the [Scala blog](https://www.scala-lang.org/blog/) -for announcements. For a more detailed view of how work is progressing, -see the [Dotty milestones](https://github.com/lampepfl/dotty/milestones). +Some books that cover Scala 3 are already available; more are on the +way. In time, there will be more and more Scala 3 jobs as well. ### Where are Scala jobs advertised? @@ -181,11 +177,10 @@ differ from a function value such as: val square: Int => Int = x => x * x -[Complete answer on Stack Overflow](https://stackoverflow.com/a/2530007/4111404). - -[Summary with practical differences](https://tpolecat.github.io/2014/06/09/methods-functions.html). +For Scala 2, there is a [complete answer on Stack Overflow](https://stackoverflow.com/a/2530007/4111404) +and a [summary with practical differences](https://tpolecat.github.io/2014/06/09/methods-functions.html). -Note that in **Scala 3** most of the differences will go; +Note that in **Scala 3** the differences are fewer; for example, they will be able to [accept implicit parameters](https://dotty.epfl.ch/docs/reference/contextual/context-functions.html) as well as [type parameters](https://dotty.epfl.ch/docs/reference/new-types/polymorphic-function-types.html). @@ -193,7 +188,7 @@ as well as [type parameters](https://dotty.epfl.ch/docs/reference/new-types/poly Nevertheless, it is still recommended to use methods most of the time, unless you absolutely need a function. And, thanks to [eta-expansion](https://stackoverflow.com/questions/39445018/what-is-the-eta-expansion-in-scala) -you rarely would need to define a function over a method. +you rarely would need to define a function rather than a method. ### What's the difference between types and classes? From d9a05be0d454d9433db78187a13f9b6dee2ebfd4 Mon Sep 17 00:00:00 2001 From: "Lan, Jian" Date: Tue, 15 Jun 2021 14:06:23 -0700 Subject: [PATCH 1513/3075] Fix why-scala-3.md --- _overviews/scala3-book/why-scala-3.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/why-scala-3.md b/_overviews/scala3-book/why-scala-3.md index e6c5b2bd96..ac74de1606 100644 --- a/_overviews/scala3-book/why-scala-3.md +++ b/_overviews/scala3-book/why-scala-3.md @@ -29,7 +29,6 @@ It’s hard to list every benefit of Scala, but a “Top Ten” list might look - ## 1) FP/OOP fusion More than any other language, Scala supports a fusion of the FP and OOP paradigms. @@ -45,7 +44,7 @@ For instance, a `List` is defined as a class---technically it’s an abstract cl val x = List(1, 2, 3) ``` -However, what appears to the programmer to be a simple `List` is actually built from a combination of several specialized types, including abstract classes named `Iterable`, `Seq`, and `LinearSeq`. +However, what appears to the programmer to be a simple `List` is actually built from a combination of several specialized types, including traits named `Iterable`, `Seq`, and `LinearSeq`. Those types are similarly composed of other small, modular units of code. In addition to building a type like `List` from a series of modular traits, the `List` API also consists of dozens of other methods, many of which are higher-order functions: @@ -106,6 +105,7 @@ val b: Password | Username = if (true) name else password ``` + ## 3) Concise syntax Scala is a low ceremony, “concise but still readable” language. For instance, variable declaration is concise: @@ -176,7 +176,6 @@ These capabilities are described in detail in other sections, so see the [Contex - ## 5) Seamless Java integration Scala/Java interaction is seamless in many ways. @@ -357,6 +356,7 @@ Some of the most important features in this category are: {% comment %} A list of types from the Dotty documentation: + - Inferred types - Generics - Intersection types From fcb797833e2b08cd0e549037109dc1b3450ba86b Mon Sep 17 00:00:00 2001 From: Elias Baldwin Date: Tue, 15 Jun 2021 14:15:45 -0700 Subject: [PATCH 1514/3075] Fix typo on line 131 of domain-modeling-oop.md --- _overviews/scala3-book/domain-modeling-oop.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/domain-modeling-oop.md b/_overviews/scala3-book/domain-modeling-oop.md index c06260d84d..56d0972198 100644 --- a/_overviews/scala3-book/domain-modeling-oop.md +++ b/_overviews/scala3-book/domain-modeling-oop.md @@ -128,7 +128,7 @@ In order to allow this, the base class needs to be marked as `open`: ```scala open class Person(name: String) ``` -Marking classes with [`open`][open] is a new feature of Sala 3. Having to explicitly mark classes as open avoids many common pitfalls in OO design. +Marking classes with [`open`][open] is a new feature of Scala 3. Having to explicitly mark classes as open avoids many common pitfalls in OO design. In particular, it requires library designers to explicitly plan for extension and for instance document the classes that are marked as open with additional extension contracts. {% comment %} From 6ca2c3dbcb959eee3424e90a6dea5afdcfa26f6f Mon Sep 17 00:00:00 2001 From: Andrea Peruffo Date: Mon, 24 May 2021 14:40:20 +0100 Subject: [PATCH 1515/3075] Add graalvm AOT notes --- _overviews/jdk-compatibility/overview.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 880c4a4614..6c6a0e9201 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -89,6 +89,16 @@ JDK 17 prereleases are already available. The final release is [targeted](https: The Scala community build doesn't run on JDK 17 yet. We will add it once 17 is closer to release. +## GraalVM Native Image compatibility notes + +There are several records of successfully using Scala with [GraalVM](https://www.graalvm.org) Native Image(i.e.: ahead of time compiler) to produce directly executable binaries. +Beware that, even using solely the Scala standard library, Native Image compilation have some heavy requirements in terms of [reflective access](https://www.graalvm.org/reference-manual/native-image/Reflection/), and it very likely require additional configuration steps to be performed. + +A few sbt plugins are offering support for GraalVM Native Image compilation: + +- [sbt-native-packager](https://www.scala-sbt.org/sbt-native-packager/formats/graalvm-native-image.html) +- [sbt-native-image](https://github.com/scalameta/sbt-native-image) + ## Scala 3 The Scala 3.0.x series supports JDK 8, as well as 11 and beyond. From 57f573092edbb37d038da4d8f479a115757aa89e Mon Sep 17 00:00:00 2001 From: Theofanis Despoudis <328805+theodesp@users.noreply.github.com> Date: Wed, 9 Jun 2021 16:36:21 +0100 Subject: [PATCH 1516/3075] Update learn.md Removed ScalaCourses expired link for consistency and less confusion --- learn.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/learn.md b/learn.md index 2204c55f1d..19af2b78c9 100644 --- a/learn.md +++ b/learn.md @@ -101,9 +101,6 @@ You can visit his [YouTube channel](https://www.youtube.com/user/DrMarkCLewis/fe ## allaboutscala [allaboutscala](https://allaboutscala.com/) provides detailed tutorials for beginners. -## ScalaCourses -[Independent Courseware](https://getscala.com), online self-study or instructor-led Scala and Play courses for a fee. - ## DevInsideYou [DevInsideYou](https://youtube.com/devinsideyou) is a YouTube channel with hundreds of hours of free Scala content. From e2aa390b9d5ba0410181c84a64f9ed2990455ca0 Mon Sep 17 00:00:00 2001 From: kenji yoshida <6b656e6a69@gmail.com> Date: Sat, 19 Jun 2021 04:53:48 +0900 Subject: [PATCH 1517/3075] Create CODEOWNERS https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-code-owners --- .github/CODEOWNERS | 1 + 1 file changed, 1 insertion(+) create mode 100644 .github/CODEOWNERS diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 0000000000..ce1bb0f48b --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1 @@ +/_ja @scala/docs-ja From af81dade1616289e5bc5e01404322713ba433582 Mon Sep 17 00:00:00 2001 From: Myyk Seok Date: Sat, 19 Jun 2021 16:34:05 +0800 Subject: [PATCH 1518/3075] Fix typo: eather -> either --- _overviews/scala3-migration/incompat-dropped-features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/incompat-dropped-features.md b/_overviews/scala3-migration/incompat-dropped-features.md index 2ba51e4a86..a8fe9b7789 100644 --- a/_overviews/scala3-migration/incompat-dropped-features.md +++ b/_overviews/scala3-migration/incompat-dropped-features.md @@ -204,7 +204,7 @@ Existential type is a [dropped feature](https://dotty.epfl.ch/docs/reference/dro def foo: List[Class[T]] forSome { type T } // Error: Existential types are no longer supported ``` -> Existential type is an experimental feature in Scala 2.13 that must be enabled explicitly eather by importing `import scala.language.existentials` or by setting the `-language:existentials` compiler flag. +> Existential type is an experimental feature in Scala 2.13 that must be enabled explicitly either by importing `import scala.language.existentials` or by setting the `-language:existentials` compiler flag. The proposed solution is to introduce an enclosing type that carries the dependent type: From 9ce11019bb8bfb0796a39af4503fa3d277113943 Mon Sep 17 00:00:00 2001 From: Abhishek Vyas <44902551+abhi887@users.noreply.github.com> Date: Mon, 21 Jun 2021 00:22:10 +0530 Subject: [PATCH 1519/3075] scala-for-python-devs.md creating multiline string variables Added an example for creating multiline string variables --- _overviews/scala3-book/scala-for-python-devs.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index b045e67ac6..4a39f4ee27 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -136,13 +136,19 @@ These examples demonstrate how to create variables in Python and Scala. x = 1 -
    x = "Hi"     +
    x = "Hi" +
    x = """foo +
           bar +
           baz"""     val x = 1 -
    val x = "Hi"     +
    val x = "Hi" +
    val x = """foo +
               bar +
               baz"""     From 652241943ce762bbd488461a257e61cd640321c6 Mon Sep 17 00:00:00 2001 From: PJ Fanning Date: Mon, 21 Jun 2021 14:23:35 +0100 Subject: [PATCH 1520/3075] compatibility example has wrong scala version --- _overviews/scala3-migration/compatibility-classpath.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-migration/compatibility-classpath.md b/_overviews/scala3-migration/compatibility-classpath.md index e9d71d65ab..521b2e448b 100644 --- a/_overviews/scala3-migration/compatibility-classpath.md +++ b/_overviews/scala3-migration/compatibility-classpath.md @@ -113,13 +113,13 @@ Or, in case `bar` is a published Scala 3 library: ```scala lazy val foo = project.in.file("foo") .settings( - scalaVersion := "3.0.0", + scalaVersion := "2.13.6", scalacOptions += "-Ytasty-reader", libraryDependencies += ("org.bar" %% "bar" % "1.0.0").cross(CrossVersion.for2_13Use3) ) ``` -Similarly to `CrossVersion.for2_13Use3`, we use `CrossVersion.for3Use2_13` in sbt to resolve `bar_2.13` instead of `bar_3`. +Similarly to `CrossVersion.for2_13Use3`, we use `CrossVersion.for3Use2_13` in sbt to resolve `bar_3` instead of `bar_2.13`. ## Interoperability Overview From ce031b5be7d04107c96c22e9afdbc850e6634a2e Mon Sep 17 00:00:00 2001 From: Abhishek Vyas <44902551+abhi887@users.noreply.github.com> Date: Mon, 21 Jun 2021 19:34:38 +0530 Subject: [PATCH 1521/3075] updated identifiers for multiline string and dictionary variables updated identifiers for multiline string variables and dictionary/map variable in scala-for-python-devs.md --- _overviews/scala3-book/scala-for-python-devs.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index 4a39f4ee27..0934989d4e 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -137,7 +137,7 @@ These examples demonstrate how to create variables in Python and Scala. x = 1
    x = "Hi" -
    x = """foo +
    y = """foo
           bar
           baz"""     @@ -146,7 +146,7 @@ These examples demonstrate how to create variables in Python and Scala. val x = 1
    val x = "Hi" -
    val x = """foo +
    val y = """foo
               bar
               baz"""     @@ -186,7 +186,7 @@ These examples demonstrate how to create variables in Python and Scala. - val movies = Map( + val x = Map(
      "Toy Story" -> 8.3,
      "Forrest Gump" -> 8.8,
      "Cloud Atlas" -> 7.4 From 5f734205a00ae937f335c59e5fed26d4d6b69cf9 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 21 Jun 2021 13:39:55 -0700 Subject: [PATCH 1522/3075] fix Error Formatting page --- _data/overviews.yml | 2 +- _overviews/compiler-options/errors.md | 5 +++++ 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/_data/overviews.yml b/_data/overviews.yml index 1764f6bc5e..54bb90a02b 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -257,7 +257,7 @@ - title: Error Formatting by: Torsten Schmits icon: cog - url: "compiler-options/index.html" + url: "compiler-options/errors.html" description: "A new engine for more user-friendly error messages, printing chains of dependent implicits and colored found/required type diffs." diff --git a/_overviews/compiler-options/errors.md b/_overviews/compiler-options/errors.md index f6e7823689..8128ef96ae 100644 --- a/_overviews/compiler-options/errors.md +++ b/_overviews/compiler-options/errors.md @@ -1,3 +1,8 @@ +--- +layout: singlepage-overview +title: Error Formatting +--- + # Introduction An advanced mechanism for formatting type errors and inspecting missing From 7c7eb8499a26b7ea7a1b07074dc3a25f4f431e4a Mon Sep 17 00:00:00 2001 From: Dean Wampler Date: Tue, 22 Jun 2021 16:08:18 -0500 Subject: [PATCH 1523/3075] Updated Programming Scala book images --- .../books/ProgrammingScala-final-border.gif | Bin 5574 -> 5619 bytes resources/img/books/ProgrammingScala.jpg | Bin 42408 -> 60005 bytes 2 files changed, 0 insertions(+), 0 deletions(-) diff --git a/resources/img/books/ProgrammingScala-final-border.gif b/resources/img/books/ProgrammingScala-final-border.gif index 69f7cb8cad766bf0185700a2712858f73f7d9c8a..a8646acbdd87d5a7b1ee0fd9fd9c85b2f2048c81 100644 GIT binary patch literal 5619 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 YT)^)+s+S#2M=?0SZl|3b1c6Qe2dyeKE&u=k literal 5574 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 diff --git a/resources/img/books/ProgrammingScala.jpg b/resources/img/books/ProgrammingScala.jpg index 07db7ec46afc58b6c3f551498481de25399610a8..232d0abff801c3f66ec604c7a3432d4d71635341 100644 GIT binary patch literal 60005 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μ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 Date: Tue, 22 Jun 2021 16:35:27 -0500 Subject: [PATCH 1524/3075] Updated content for Programming Scala by Dean Wampler --- _books/2-programming-scala.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_books/2-programming-scala.md b/_books/2-programming-scala.md index 27a1e9ce61..8fc729169f 100644 --- a/_books/2-programming-scala.md +++ b/_books/2-programming-scala.md @@ -1,11 +1,11 @@ --- title: "Programming Scala" -link: https://shop.oreilly.com/product/0636920033073.do +link: http://programming-scala.com image: /resources/img/books/ProgrammingScala-final-border.gif -status: Updated for Scala 2.12 -authors: ["Alex Payne", "Dean Wampler"] +status: Updated for Scala 3 +authors: ["Dean Wampler"] publisher: O’Reilly publisherLink: https://www.oreilly.com/ --- -Both are industry experts, Alex Payne being the lead API programmer at Twitter, a social networking service based on Scala. O’Reilly, the publisher, writes: "Learn how to be more productive with Scala, a new multi-paradigm language for the Java Virtual Machine (JVM) that integrates features of both object-oriented and functional programming. With this book, you'll discover why Scala is ideal for highly scalable, component-based applications that support concurrency and distribution. You'll also learn how to leverage the wealth of Java class libraries to meet the practical needs of enterprise and Internet projects more easily." +Dean is a well-known member of the Scala community, using Scala recently for streaming data systems at Lightbend and now at Domino Data Lab. This edition covers the new features of Scala 3, with comparisons to Scala 2, both to explain why the changes were made and how they improve Scala, and also to enable developers using mixed Scala 2 and 3 code bases to work effectively. The book is aimed at professional programmers who want a comprehensive, in-depth, yet pragmatic tour of Scala and best practices for using it. From bcad9c105fc521b4bff0661017dede35c17042c0 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 23 Jun 2021 13:49:51 -0700 Subject: [PATCH 1525/3075] update JDK 17 info on JDK compatiblity page --- _overviews/jdk-compatibility/overview.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 6c6a0e9201..85e65f3448 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,8 +12,8 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | JDK version | Minimum Scala versions | Recommended Scala versions | |:-----------:|:---------------------------------|:-----------------------------------------------------------| -| 17 | 2.13.6, 2.12.14 (see below) | 2.13.6, 2.12.14 (see below) -| 16 | 2.13.5, 2.12.14 | 2.13.6, 2.12.14 +| 17 | 2.13.6, 2.12.15 (forthcoming) | 2.13.6, 2.12.15 (forthcoming) | +| 16 | 2.13.5, 2.12.14 | 2.13.6, 2.12.14 | | 13, 14, 15 | 2.13.2, 2.12.11 | 2.13.6, 2.12.14 | | 12 | 2.13.1, 2.12.9 | 2.13.6, 2.12.14 | | 11 | 2.13.0, 2.12.4, 2.11.12 | 2.13.6, 2.12.14, 2.11.12 | @@ -81,13 +81,15 @@ As far as we know, 12, 13, 14, and 15 are similar to 11 with respect to Scala co JDK 16 was released in March 2021. It is not an LTS release, so the remarks above about non-LTS releases apply. The next LTS release will be JDK 17. -The Scala community build and the Scala build and test suite run on JDK 16. We shipped improved JDK 16 support in [Scala 2.13.5](https://github.com/scala/scala/releases/tag/v2.13.5) and intend to ship the same improvements soon in Scala 2.12.14 ([release timing thread](https://contributors.scala-lang.org/t/scala-2-12-14-planning/4852/2)). +The Scala build and test suite pass on JDK 16, and so does most of the Scala community build. We shipped improved JDK 16 support in [Scala 2.13.5](https://github.com/scala/scala/releases/tag/v2.13.5) and [2.12.14](https://github.com/scala/scala/releases/tag/v2.12.14). ## JDK 17 compatibility notes -JDK 17 prereleases are already available. The final release is [targeted](https://openjdk.java.net/projects/jdk/17/) for September 2021. JDK 17 will be an LTS release. +JDK 17 prereleases are already available. As of June 2021, the feature set is frozen. The final release is [targeted](https://openjdk.java.net/projects/jdk/17/) for September 2021. JDK 17 will be an LTS release. -The Scala community build doesn't run on JDK 17 yet. We will add it once 17 is closer to release. +The Scala community build is mostly green on JDK 17, as of June 2021. We are in the process of making Scala's own build and test suite pass. + +Scala 2.13.6 already supports JDK 17. Scala 2.12.14 mostly works as well, but there is a known issue with lambda deserialiation; a fix will ship in Scala 2.12.15 (see [release timing thread](https://contributors.scala-lang.org/t/scala-2-12-15-planning/5152)). ## GraalVM Native Image compatibility notes @@ -101,6 +103,6 @@ A few sbt plugins are offering support for GraalVM Native Image compilation: ## Scala 3 -The Scala 3.0.x series supports JDK 8, as well as 11 and beyond. +The Scala 3.x series supports JDK 8, as well as 11 and beyond. -As Scala and the JVM continue to evolve, some eventual Scala 3.x version may drop support for JDK 8, in order to better take advantage of new JVM features. It isn't clear yet what the new minimum supported version might become. +As Scala and the JVM continue to evolve, some eventual Scala version may drop support for JDK 8, in order to better take advantage of new JVM features. It isn't clear yet what the new minimum supported version might become. From 0e4bce98931a9a0e4d3ab5c75b5a28905207f444 Mon Sep 17 00:00:00 2001 From: Liam Bohl Date: Thu, 24 Jun 2021 11:37:33 -0400 Subject: [PATCH 1526/3075] Replaced functions deprecated as of 2.13 += (varargs) -> ++= -= (varargs) -> --= retain -> filterInPlace --- _overviews/scala-book/collections-maps.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_overviews/scala-book/collections-maps.md b/_overviews/scala-book/collections-maps.md index 1556a66ef8..95e890bbc3 100644 --- a/_overviews/scala-book/collections-maps.md +++ b/_overviews/scala-book/collections-maps.md @@ -83,18 +83,18 @@ Here are some things you can do with a mutable `Map`: ```scala // add elements with += states += ("AZ" -> "Arizona") -states += ("CO" -> "Colorado", "KY" -> "Kentucky") +states ++= Map("CO" -> "Colorado", "KY" -> "Kentucky") // remove elements with -= states -= "KY" -states -= ("AZ", "CO") +states --= List("AZ", "CO") // update elements by reassigning them states("AK") = "Alaska, The Big State" -// retain elements by supplying a function that operates on +// filter elements by supplying a function that operates on // the keys and/or values -states.retain((k,v) => k == "AK") +states.filterInPlace((k,v) => k == "AK") ``` From 8c0d3389302ac608fc436dc61a149dce5b723812 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Thu, 24 Jun 2021 08:40:05 -0700 Subject: [PATCH 1527/3075] tweak wording around community build as per Lukas's feedback --- _overviews/jdk-compatibility/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 85e65f3448..dd151bf707 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -81,13 +81,13 @@ As far as we know, 12, 13, 14, and 15 are similar to 11 with respect to Scala co JDK 16 was released in March 2021. It is not an LTS release, so the remarks above about non-LTS releases apply. The next LTS release will be JDK 17. -The Scala build and test suite pass on JDK 16, and so does most of the Scala community build. We shipped improved JDK 16 support in [Scala 2.13.5](https://github.com/scala/scala/releases/tag/v2.13.5) and [2.12.14](https://github.com/scala/scala/releases/tag/v2.12.14). +The Scala build and test suite pass on JDK 16, and so does the Scala community build. We shipped improved JDK 16 support in [Scala 2.13.5](https://github.com/scala/scala/releases/tag/v2.13.5) and [2.12.14](https://github.com/scala/scala/releases/tag/v2.12.14). ## JDK 17 compatibility notes JDK 17 prereleases are already available. As of June 2021, the feature set is frozen. The final release is [targeted](https://openjdk.java.net/projects/jdk/17/) for September 2021. JDK 17 will be an LTS release. -The Scala community build is mostly green on JDK 17, as of June 2021. We are in the process of making Scala's own build and test suite pass. +The Scala community build passes on JDK 17. We are in the process of making Scala's own build and test suite pass. Scala 2.13.6 already supports JDK 17. Scala 2.12.14 mostly works as well, but there is a known issue with lambda deserialiation; a fix will ship in Scala 2.12.15 (see [release timing thread](https://contributors.scala-lang.org/t/scala-2-12-15-planning/5152)). From bcd05f58cb46217358858002a9e17be6a57f2699 Mon Sep 17 00:00:00 2001 From: Dmitrii Naumenko Date: Thu, 24 Jun 2021 19:01:58 +0300 Subject: [PATCH 1528/3075] Update ca-given-imports.md --- _overviews/scala3-book/ca-given-imports.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/ca-given-imports.md b/_overviews/scala3-book/ca-given-imports.md index 2b5c0a6429..6cfb436a29 100644 --- a/_overviews/scala3-book/ca-given-imports.md +++ b/_overviews/scala3-book/ca-given-imports.md @@ -14,7 +14,7 @@ The basic form is shown in this example: ```scala object A: class TC - given tc as TC + given tc: TC = ??? def f(using TC) = ??? object B: From c3a58d34c576e4798bc141ac7967117a81331920 Mon Sep 17 00:00:00 2001 From: Altair-Bueno <67512202+Altair-Bueno@users.noreply.github.com> Date: Thu, 24 Jun 2021 19:30:21 +0200 Subject: [PATCH 1529/3075] Using Scala 2 If-else expression instead if () else syntax is from Scala 2. Use if then else instead or simplify it by removing the if-else expression. If-else is unnecessary --- _overviews/scala3-book/taste-objects.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_overviews/scala3-book/taste-objects.md b/_overviews/scala3-book/taste-objects.md index ae522627f1..5c27e3b8a9 100644 --- a/_overviews/scala3-book/taste-objects.md +++ b/_overviews/scala3-book/taste-objects.md @@ -27,8 +27,7 @@ For example, this `StringUtils` object contains a small collection of string-rel ```scala object StringUtils: - def isNullOrEmpty(s: String): Boolean = - if (s==null || s.trim.equals("")) true else false + def isNullOrEmpty(s: String): Boolean = s==null || s.trim.equals("") def leftTrim(s: String): String = s.replaceAll("^\\s+", "") def rightTrim(s: String): String = s.replaceAll("\\s+$", "") ``` From 662cf053d5c84f5e11650e4e6787b41ed34c4d08 Mon Sep 17 00:00:00 2001 From: Altair-Bueno <67512202+Altair-Bueno@users.noreply.github.com> Date: Fri, 25 Jun 2021 11:28:03 +0200 Subject: [PATCH 1530/3075] Added @SethTisue suggestion --- _overviews/scala3-book/taste-objects.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/taste-objects.md b/_overviews/scala3-book/taste-objects.md index 5c27e3b8a9..6e33d8fd55 100644 --- a/_overviews/scala3-book/taste-objects.md +++ b/_overviews/scala3-book/taste-objects.md @@ -27,7 +27,7 @@ For example, this `StringUtils` object contains a small collection of string-rel ```scala object StringUtils: - def isNullOrEmpty(s: String): Boolean = s==null || s.trim.equals("") + def isNullOrEmpty(s: String): Boolean = s==null || s.trim == "" def leftTrim(s: String): String = s.replaceAll("^\\s+", "") def rightTrim(s: String): String = s.replaceAll("\\s+$", "") ``` From 430252a1766eb0062784ad992d78eec516965b27 Mon Sep 17 00:00:00 2001 From: Altair-Bueno <67512202+Altair-Bueno@users.noreply.github.com> Date: Fri, 25 Jun 2021 11:29:44 +0200 Subject: [PATCH 1531/3075] Update taste-objects.md --- _overviews/scala3-book/taste-objects.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/taste-objects.md b/_overviews/scala3-book/taste-objects.md index 6e33d8fd55..2e6d1428ca 100644 --- a/_overviews/scala3-book/taste-objects.md +++ b/_overviews/scala3-book/taste-objects.md @@ -27,7 +27,7 @@ For example, this `StringUtils` object contains a small collection of string-rel ```scala object StringUtils: - def isNullOrEmpty(s: String): Boolean = s==null || s.trim == "" + def isNullOrEmpty(s: String): Boolean = s==null || s.trim.isEmpty def leftTrim(s: String): String = s.replaceAll("^\\s+", "") def rightTrim(s: String): String = s.replaceAll("\\s+$", "") ``` From f8b8af443956c64769a7577ed0882b182ec8d87e Mon Sep 17 00:00:00 2001 From: Altair-Bueno <67512202+Altair-Bueno@users.noreply.github.com> Date: Fri, 25 Jun 2021 13:06:17 +0200 Subject: [PATCH 1532/3075] Found another Scala 2 `isNullOrEmpty` --- _overviews/scala3-book/domain-modeling-tools.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_overviews/scala3-book/domain-modeling-tools.md b/_overviews/scala3-book/domain-modeling-tools.md index b8fd76f2fc..f59c39c8af 100644 --- a/_overviews/scala3-book/domain-modeling-tools.md +++ b/_overviews/scala3-book/domain-modeling-tools.md @@ -219,8 +219,7 @@ Here’s an example of a “string utilities” object that contains a set of me object StringUtils: def truncate(s: String, length: Int): String = s.take(length) def containsWhitespace(s: String): Boolean = s.matches(".*\\s.*") - def isNullOrEmpty(s: String): Boolean = - if s == null || s.trim.equals("") then true else false + def isNullOrEmpty(s: String): Boolean = s==null || s.trim.isEmpty ``` We can use the object as follows: From cb136c0b509d438348c6e9737eb0fb55a7d119fe Mon Sep 17 00:00:00 2001 From: Jentsch Date: Sat, 26 Jun 2021 11:52:38 +0200 Subject: [PATCH 1533/3075] Fix docker port in Readme.md docker-compose.yml:7 exposes the port on 4000 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index eef762ce16..8b3d557025 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ To build and view site with docker: docker-compose up -It will incrementally build and serve site at `http://localhost:8080` +It will incrementally build and serve site at `http://localhost:4000` ## Contributing ## From 904fdf7d95ce146f37c1ab1ee37c0ecf41917916 Mon Sep 17 00:00:00 2001 From: Genghis Yang Date: Sat, 26 Jun 2021 19:56:02 +0800 Subject: [PATCH 1534/3075] Fix a typo in Domain Modeling / Tools I believe `have also have` is not grammatical. Should be `also have` --- _overviews/scala3-book/domain-modeling-tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/domain-modeling-tools.md b/_overviews/scala3-book/domain-modeling-tools.md index b8fd76f2fc..e994551aff 100644 --- a/_overviews/scala3-book/domain-modeling-tools.md +++ b/_overviews/scala3-book/domain-modeling-tools.md @@ -66,7 +66,7 @@ p.vocation = "Musician" ### Fields and methods -Classes can have also have methods and additional fields that are not part of constructors. +Classes can also have methods and additional fields that are not part of constructors. They are defined in the body of the class. The body is initialized as part of the default constructor: From 4d0e5d3baae763f96046c2d7ad5b8a6d4658c165 Mon Sep 17 00:00:00 2001 From: Genghis Yang Date: Sat, 26 Jun 2021 21:18:08 +0800 Subject: [PATCH 1535/3075] Fix a typo in scala 3 book domain modeling fp Just a typo --- _overviews/scala3-book/domain-modeling-fp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/domain-modeling-fp.md b/_overviews/scala3-book/domain-modeling-fp.md index dec7dda6d2..9d1c163864 100644 --- a/_overviews/scala3-book/domain-modeling-fp.md +++ b/_overviews/scala3-book/domain-modeling-fp.md @@ -259,7 +259,7 @@ Pizza.price(pizza1) Grouping functionality this way has a few advantages: - It associates functionality with data and makes it easier to find for programmers (and the compiler). -- It creates a namespace and for instance let's us use `price` as a method name without having to rely on overloading. +- It creates a namespace and for instance let's use `price` as a method name without having to rely on overloading. - The implementation of `Topping.price` can access enumeration values like `Cheese` without having to import them. However, there are also a few tradeoffs that should be considered: From 8bd14057ecc07ae2b9c82ba0acc228812e9b7dc3 Mon Sep 17 00:00:00 2001 From: Mario Galic Date: Sat, 10 Apr 2021 19:07:47 +0100 Subject: [PATCH 1536/3075] Conversion Between Option and the Collections - Clarify if Option is considered a collection by summarising discussion at Make Option extend IterableOnce #8038 - Document implicit conversion option2iterable --- ...sion-between-option-and-the-collections.md | 53 +++++++++++++++++++ ...ions-between-java-and-scala-collections.md | 1 + 2 files changed, 54 insertions(+) create mode 100644 _overviews/collections-2.13/conversion-between-option-and-the-collections.md diff --git a/_overviews/collections-2.13/conversion-between-option-and-the-collections.md b/_overviews/collections-2.13/conversion-between-option-and-the-collections.md new file mode 100644 index 0000000000..7fff2ea548 --- /dev/null +++ b/_overviews/collections-2.13/conversion-between-option-and-the-collections.md @@ -0,0 +1,53 @@ +--- +layout: multipage-overview +title: Conversion Between Option and the Collections +partof: collections-213 +overview-name: Collections + +num: 18 +previous-page: conversions-between-java-and-scala-collections + +permalink: /overviews/collections-2.13/:title.html +--- +`Option` can be seen as a collection that has zero or exactly one element, and it provides a degree of interoperability with the collection types found in the package `scala.collection`. In particular, it implements the interface `IterableOnce`, which models the simplest form of collections: something that can be iterated over, at least once. However, `Option` does not implement the more comprehensive interface of `Iterable`. Indeed, we cannot provide a sensible implementation for the operation [`fromSpecific`](https://github.com/scala/scala/blob/6c68c2825e893bb71d6dc78465ac8c6f415cbd93/src/library/scala/collection/Iterable.scala#L173), which is supposed to create an `Option` from a collection of possibly more than one element. Starting from [Scala 2.13](https://github.com/scala/scala/pull/8038), `Option` was made an `IterableOnce` but not an `Iterable`. + +Hence `Option` can be used everywhere an `IterableOnce` is expected, for example, when calling `flatMap` on a collection (or inside a for-comprehension) + +```scala mdoc +for { + a <- Set(1) + b <- Option(41) +} yield (a + b) +// : Set[Int] = Set(42) +``` + +since the operation `flatMap` on the type `Set[Int]` takes a function returning an `IterableOnce`: + +``` +def flatMap[B](f: Int => IterableOnce[B]): Set[B] +``` + +Although `Option` does not extend `Iterable`, there exists an [implicit conversion](https://github.com/scala/scala/blob/6c68c2825e893bb71d6dc78465ac8c6f415cbd93/src/library/scala/Option.scala#L19) between `Option` and `Iterable` + + +``` +implicit def option2Iterable[A](xo: Option[A]): Iterable[A] +``` + +so although `Option[A]` is not a full collection it can be _viewed_ as one. For example, + +```scala mdoc +Some(42).drop(1) +// : Iterable[Int] = List() +``` + +expands to + +```scala mdoc +Option.option2Iterable(Some(42)).drop(1) +// : Iterable[Int] = List() +``` + +because `drop` is not defined on `Option`. A downside of the above implicit conversion is that instead of getting back an `Option[A]` we are left with an `Iterable[A]`. For this reason, `Option`’s documentation carries the following note: + +> Many of the methods in `Option` are duplicative with those in the `Iterable` hierarchy, but they are duplicated for a reason: the implicit conversion tends to leave one with an `Iterable` in situations where one could have retained an `Option`. diff --git a/_overviews/collections-2.13/conversions-between-java-and-scala-collections.md b/_overviews/collections-2.13/conversions-between-java-and-scala-collections.md index 86070db314..b4090053ba 100644 --- a/_overviews/collections-2.13/conversions-between-java-and-scala-collections.md +++ b/_overviews/collections-2.13/conversions-between-java-and-scala-collections.md @@ -6,6 +6,7 @@ overview-name: Collections num: 17 previous-page: creating-collections-from-scratch +next-page: conversion-between-option-and-the-collections languages: [ru] permalink: /overviews/collections-2.13/:title.html From 824a0ab96c40c373fa2b4372098cfe079c696e0b Mon Sep 17 00:00:00 2001 From: Genghis Yang Date: Mon, 28 Jun 2021 16:13:54 +0800 Subject: [PATCH 1537/3075] Fix typo --- _overviews/scala3-book/domain-modeling-fp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/domain-modeling-fp.md b/_overviews/scala3-book/domain-modeling-fp.md index 9d1c163864..31e5d19008 100644 --- a/_overviews/scala3-book/domain-modeling-fp.md +++ b/_overviews/scala3-book/domain-modeling-fp.md @@ -259,7 +259,7 @@ Pizza.price(pizza1) Grouping functionality this way has a few advantages: - It associates functionality with data and makes it easier to find for programmers (and the compiler). -- It creates a namespace and for instance let's use `price` as a method name without having to rely on overloading. +- It creates a namespace and for instance lets us use `price` as a method name without having to rely on overloading. - The implementation of `Topping.price` can access enumeration values like `Cheese` without having to import them. However, there are also a few tradeoffs that should be considered: From 923bb72a713bef577cde546368a30c4a1e2d59d9 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 21 Jun 2021 15:01:12 +0200 Subject: [PATCH 1538/3075] Suggestions on the Scala 3 book (part 5) --- _overviews/scala3-book/concurrency.md | 63 ++++++++----- .../scala3-book/interacting-with-java.md | 11 ++- _overviews/scala3-book/scala-for-java-devs.md | 23 +++-- .../scala3-book/scala-for-javascript-devs.md | 7 +- .../scala3-book/scala-for-python-devs.md | 34 ++++--- _overviews/scala3-book/scala-tools.md | 89 +++++++++++++------ 6 files changed, 139 insertions(+), 88 deletions(-) diff --git a/_overviews/scala3-book/concurrency.md b/_overviews/scala3-book/concurrency.md index 59b86b0815..bda65f21a9 100644 --- a/_overviews/scala3-book/concurrency.md +++ b/_overviews/scala3-book/concurrency.md @@ -55,7 +55,8 @@ You’ll also see examples of methods that are used to handle the value in a fut > When you think about futures, it’s important to know that they’re intended as a one-shot, “Handle this relatively slow computation on some other thread, and call me back with a result when you’re done” construct. > As a point of contrast, [Akka](https://akka.io) actors are intended to run for a long time and respond to many requests during their lifetime. -> While an actor may live forever, a future is intended to be run only once. +> While an actor may live forever, a future eventually contains the result +> of a computation that ran only once. @@ -77,7 +78,7 @@ Now you’re ready to create a future. For this example, first define a long-running, single-threaded algorithm: ```scala -def longRunningAlgorithm = +def longRunningAlgorithm() = Thread.sleep(10_000) 42 ``` @@ -86,29 +87,29 @@ That fancy algorithm returns the integer value `42` after a ten second delay. Now call that algorithm by wrapping it into the `Future` constructor, and assigning the result to a variable: ```scala -scala> val f = Future(longRunningAlgorithm) -f: scala.concurrent.Future[Int] = Future() +scala> val eventualInt = Future(longRunningAlgorithm()) +eventualInt: scala.concurrent.Future[Int] = Future() ``` -Right away your future begins running. -If you immediately check the value of the variable `f`, you see that the future hasn’t completed yet: +Right away, your computation---the call to `longRunningAlgorithm()`---begins running. +If you immediately check the value of the variable `eventualInt`, you see that the future hasn’t been completed yet: ```scala -scala> f +scala> eventualInt val res1: scala.concurrent.Future[Int] = Future() ``` -But if you check again after ten seconds, you’ll see that it completes successfully: +But if you check again after ten seconds, you’ll see that it is completed successfully: ```scala -scala> f +scala> eventualInt val res2: scala.concurrent.Future[Int] = Future(Success(42)) ``` While that’s a relatively simple example, it shows the basic approach: Just construct a new `Future` with your long-running algorithm. One thing to notice is that the `42` you expected is wrapped in a `Success`, which is further wrapped in a `Future`. -This is a key concept to understand: the value in a `Future` is always an instance of one of the *scala.util.Try* types: `Success` or `Failure`. +This is a key concept to understand: the value in a `Future` is always an instance of one of the `scala.util.Try` types: `Success` or `Failure`. Therefore, when you work with the result of a future, you use the usual `Try`-handling techniques. @@ -118,7 +119,7 @@ Therefore, when you work with the result of a future, you use the usual `Try`-ha This is what the result looks like when you call `map` right after creating the variable `f`: ```scala -scala> val a = f.map(_ * 2) +scala> val a = eventualInt.map(_ * 2) a: scala.concurrent.Future[Int] = Future() ``` @@ -139,13 +140,13 @@ In addition to higher-order functions like `map`, you can also use callback meth One commonly used callback method is `onComplete`, which takes a *partial function* in which you handle the `Success` and `Failure` cases: ```scala -f.onComplete { +eventualInt.onComplete { case Success(value) => println(s"Got the callback, value = $value") case Failure(e) => e.printStackTrace } ``` -When you paste that code in the REPL you’ll see the result: +When you paste that code in the REPL you’ll eventually see the result: ```scala Got the callback, value = 42 @@ -180,10 +181,11 @@ See the [Futures and Promises][futures] page for a discussion of additional meth ## Running multiple futures and joining their results -To run multiple futures in parallel and join their results when all of the futures complete, use a `for` expression. +To run multiple computations in parallel and join their results when all of the futures have been completed, use a `for` expression. + The correct approach is: -1. Create the futures +1. Start the computations that return `Future` results 2. Merge their results in a `for` expression 3. Extract the merged result using `onComplete` or a similar technique @@ -191,27 +193,27 @@ The correct approach is: ### An example The three steps of the correct approach are shown in the following example. -A key is that you first create the futures and then join them in the `for` expression: +A key is that you first start the computations that return futures, and then join them in the `for` expression: ```scala import scala.concurrent.Future import scala.concurrent.ExecutionContext.Implicits.global import scala.util.{Failure, Success} -val startTime = System.currentTimeMillis -def delta() = System.currentTimeMillis - startTime +val startTime = System.currentTimeMillis() +def delta() = System.currentTimeMillis() - startTime def sleep(millis: Long) = Thread.sleep(millis) @main def multipleFutures1 = println(s"creating the futures: ${delta()}") - // (1) create the futures + // (1) start the computations that return futures val f1 = Future { sleep(800); 1 } // eventually returns 1 val f2 = Future { sleep(200); 2 } // eventually returns 2 val f3 = Future { sleep(400); 3 } // eventually returns 3 - // (2) run them simultaneously in a `for` expression + // (2) join the futures in a `for` expression val result = for r1 <- f1 @@ -251,10 +253,23 @@ All of that code is run on the JVM’s main thread. Then, at 806 ms, the three futures complete and the code in the `yield` block is run. Then the code immediately goes to the `Success` case in the `onComplete` method. -The 806 ms output is a key to seeing that the three futures are run in parallel. -If they were run sequentially, the total time would be about 1,400 ms---the sum of the sleep times of the three futures. -But because they’re run in parallel, the total time is just slightly longer than the longest-running future: `f1`, which is 800 ms. - +The 806 ms output is a key to seeing that the three computations are run in parallel. +If they were run sequentially, the total time would be about 1,400 ms---the sum of the sleep times of the three computations. +But because they’re run in parallel, the total time is just slightly longer than the longest-running computation: `f1`, which is 800 ms. + +> Notice that if the computations were run within the `for` expression, they +> would be executed sequentially, not in parallel: +> ~~~ +> // Sequential execution (no parallelism!) +> for +> r1 <- Future { sleep(800); 1 } +> r2 <- Future { sleep(200); 2 } +> r3 <- Future { sleep(400); 3 } +> yield +> r1 + r2 + r3 +> ~~~ +> So, if you want the computations to be possibly run in parallel, remember +> to run them outside of the `for` expression. ### A method that returns a future diff --git a/_overviews/scala3-book/interacting-with-java.md b/_overviews/scala3-book/interacting-with-java.md index 36ceb7fe58..8ccb38e156 100644 --- a/_overviews/scala3-book/interacting-with-java.md +++ b/_overviews/scala3-book/interacting-with-java.md @@ -58,9 +58,8 @@ You can convert that Java list to a Scala `Seq`, using the conversion utilities ```scala // scala import scala.jdk.CollectionConverters.* -import java.util.List -def testList = +def testList() = println("Using a Java List in Scala") val javaList: java.util.List[String] = JavaClass.getStrings() val scalaSeq: Seq[String] = javaList.asScala.toSeq @@ -156,7 +155,7 @@ class Dog extends Animal, Wagging, Running: ## How to use Scala collections in Java -When you need to use a Scala collection class in your Java code, use the methods of Scala’s _scala.jdk.javaapi.CollectionConverters_ object in your Java code to make the conversions work. +When you need to use a Scala collection class in your Java code, use the methods of Scala’s `scala.jdk.javaapi.CollectionConverters` object in your Java code to make the conversions work. For example, if you have a `List[String]` like this in a Scala class: ```scala @@ -192,7 +191,7 @@ Here are a few things to notice in that code: ## How to use Scala `Option` in Java -When you need to use a Scala `Option` in your Java code, you can convert the `Option` to a Java `Optional` value using the `toJava` method of the Scala _scala.jdk.javaapi.OptionConverters_ object. +When you need to use a Scala `Option` in your Java code, you can convert the `Option` to a Java `Optional` value using the `toJava` method of the Scala `scala.jdk.javaapi.OptionConverters` object. To demonstrate this, create a Scala class with two `Option[String]` values, one containing a string and the other one empty: @@ -203,7 +202,7 @@ object ScalaObject: val noneString: Option[String] = None ``` -Then in your Java code, convert those `Option[String]` values into `java.util.Optional[String]` using the `toJava` method from the _scala.jdk.javaapi.OptionConverters_ object: +Then in your Java code, convert those `Option[String]` values into `java.util.Optional[String]` using the `toJava` method from the `scala.jdk.javaapi.OptionConverters` object: ```java // java @@ -258,7 +257,7 @@ System.out.println(jm.multiply(3,4)); // 12 ## How to handle Scala methods that throw exceptions in Java code When you’re writing Scala code using Scala programming idioms, you’ll never write a method that throws an exception. -But if for some reason you have a Scala method that does throw an exception, and you want Java developers to be able to use that method, add the `@throws` annotation to your Scala method so Java consumers will know the exceptions they can throw. +But if for some reason you have a Scala method that does throw an exception, and you want Java developers to be able to use that method, add the `@throws` annotation to your Scala method so Java consumers will know the exceptions it can throw. For example, this Scala `exceptionThrower` method is annotated to declare that it throws an `Exception`: diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index 50d1777677..be54f5fd25 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -49,6 +49,7 @@ Also at a high level, the differences between Java and Scala are: - Scala has a full suite of immutable collections, including `List`, `Vector`, and immutable `Map` and `Set` implementations - Everything in Scala is an _expression_: constructs like `if` statements, `for` loops, `match` expressions, and even `try`/`catch` expressions all have return values - Scala idioms favor immutability by default: you’re encouraged to use immutable (`final`) variables and immutable collections +- Idiomatic Scala code does not use `null`, and thus does not suffer from `NullPointerException` - The Scala ecosystem has other [build tools][tools] in sbt, Mill, and others - In addition to running on the JVM, the [Scala.js](https://www.scala-js.org) project lets you use Scala as a JavaScript replacement - The [Scala Native](http://www.scala-native.org) project adds low-level constructs to let you write “systems” level code, and also compiles to native executables @@ -117,14 +118,18 @@ This section provides comparisons of features related to OOP-style classes and m ### OOP style class, primary constructor: +Scala doesn’t follow the JavaBeans standard, so instead of showing Java +code written in the JavaBeans style, here we show Java code that is +equivalent to the Scala code that follows it. + @@ -976,7 +981,7 @@ val a = Array("a", "b") as being backed by this Java `String[]`: ```scala -String[] a = ["a", "b"] +String[] a = ["a", "b"]; ``` However, a Scala `Array` also has all of the functional methods you expect in a Scala collection, including `map` and `filter`: @@ -1275,7 +1280,7 @@ For more information on dealing with errors and exceptions in Scala, see the [Fu That concludes are comparison of the Java and Scala languages. -Currently there are other concepts in Scala which currently have no equal in Java 11. +There are other concepts in Scala which currently have no equal in Java 11. This includes: - Everything related to Scala’s [contextual abstractions][contextual] diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index 0237e0d63c..a577837e56 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -36,7 +36,7 @@ At a high level, Scala shares these similarities with JavaScript: - Both languages have similar `if` statements, `while` loops, and `for` loops - Starting [at this Scala.js page](https://www.scala-js.org/libraries/index.html), you’ll find dozens of libraries to support React, Angular, jQuery, and many other JavaScript and Scala libraries - JavaScript objects are mutable; Scala objects _can_ be mutable when writing in an imperative style -- Both JavaScript and Scala support _promises_ as a way of running asynchronous computations ([Scala concurrency][concurrency] uses futures and promises) +- Both JavaScript and Scala support _promises_ as a way of handling the result of asynchronous computations ([Scala concurrency][concurrency] uses futures and promises) ### High-level differences @@ -441,7 +441,7 @@ In both JavaScript and Scala, functions are objects, so their functionality is s @@ -474,7 +474,7 @@ In both JavaScript and Scala, functions are objects, so their functionality is s
    class Person { -
      private String firstName; -
      private String lastName; -
      private int age; +
      public String firstName; +
      public String lastName; +
      public int age;
      public Person(
        String firstName,
        String lastName, int age @@ -160,9 +165,9 @@ This section provides comparisons of features related to OOP-style classes and m
    public class Person { -
      private String firstName; -
      private String lastName; -
      private int age; +
      public String firstName; +
      public String lastName; +
      public int age;

      // primary constructor
      public Person( @@ -424,7 +429,7 @@ This section compares Java interfaces to Scala traits, including how classes ext
    - class Dog extends Animal, HasLegs, HasTail + class Dog extends Animal implements HasLegs, HasTail
    - // technically this is a “method,” not a function + // technically this is a method, not a function
    def add(a: Int, b: Int) = a + b
    add(2, 2)   // 4
    In Scala, showing the `Int` return type is optional. -It’s _not_ shown in the `add` example and _is_ shown in the `addThenDouble` example, so you can see both approaches. +It’s _not_ shown in the `add` example and _is_ shown in the `addAndDouble` example, so you can see both approaches. @@ -1374,4 +1374,3 @@ There are other concepts in Scala which currently have no equivalent in JavaScri [union-types]: {% link _overviews/scala3-book/types-union.md %} - diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index 0934989d4e..395d7c450d 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -230,7 +230,7 @@ These examples demonstrate how to create variables in Python and Scala. -If a Scala field is going to be mutable, use `var` instead of `val` for variable assignment: +If a Scala field is going to be mutable, use `var` instead of `val` for variable definition: ```scala var x = 1 @@ -631,18 +631,14 @@ Scala also has `match` expressions. - x = [i*10 for i in range(1,4)] -
    # x: [10,20,30]     + xs = [i * 10 for i in range(1, 4)] +
    # xs: [10,20,30]     - val x = -
      for -
        i <- 1 to 3 -
      yield -
        i * 10 -
    // x: Vector(10, 20, 30)     + val xs = for i <- 1 to 3 yield i * 10 +
    // xs: Vector(10, 20, 30)     @@ -894,9 +890,7 @@ However, the default Scala map is _immutable_, and has a number of transformatio - for -
      (key,value) <- myMap -
    do + for (key,value) <- myMap do
      println(key)
      println(value)     @@ -934,7 +928,7 @@ The Python set is similar to the _mutable_ Scala `Set` class. set = {1,2,1} -
    # set: {1,2}     +
    # set: {1,2}     @@ -1012,7 +1006,7 @@ Those lists are used in the following table, that shows how to apply mapping and - x = [i*10 for i in numbers] + x = [i * 10 for i in numbers] @@ -1034,7 +1028,9 @@ Those lists are used in the following table, that shows how to apply mapping and - val evens = numbers.filter(_ % 2 == 0) + val evens = numbers.filter(_ % 2 == 0) +
    // or +
    val evens = for i <- numbers if i % 2 == 0 yield i     @@ -1051,8 +1047,9 @@ Those lists are used in the following table, that shows how to apply mapping and - val x = numbers.filter(_ % 2 == 0) -
              .map(_ * 10)     + val x = numbers.filter(_ % 2 == 0).map(_ * 10) +
    // or +
    val x = for i <- numbers if i % 2 == 0 yield i * 10     @@ -1064,8 +1061,7 @@ Those lists are used in the following table, that shows how to apply mapping and - def times_10(n): return n * 10 -
    x = map(lambda x: x * 10, numbers)     + x = map(lambda x: x * 10, numbers) diff --git a/_overviews/scala3-book/scala-tools.md b/_overviews/scala3-book/scala-tools.md index 81f7177515..75bb1f2c0d 100644 --- a/_overviews/scala3-book/scala-tools.md +++ b/_overviews/scala3-book/scala-tools.md @@ -22,7 +22,7 @@ We’ll start by showing how to use sbt to build your Scala projects, and then w ## Building Scala projects with sbt You can use several different tools to build your Scala projects, including Ant, Maven, Gradle, Mill, and more. -But a tool named _sbt_ was the first build tool that was specifically created for Scala, and these days it’s supported by [Lightbend](https://www.lightbend.com), the company that also maintains [Akka](https://akka.io), the [Play framework](https://www.playframework.com), the [Lagom framework](https://www.lagomframework.com), and more. +But a tool named _sbt_ was the first build tool that was specifically created for Scala. > To install sbt, see [its download page](https://www.scala-sbt.org/download.html) or our [Getting Started][getting_started] page. @@ -38,7 +38,20 @@ $ mkdir hello $ cd hello ``` -Then create a file named _build.sbt_ that contains this line: +In the directory `hello`, create a subdirectory `project`: + +```bash +$ mkdir project +``` + +Create a file named _build.properties_ in the directory `project`, with +the following content: + +```text +sbt.version=1.5.4 +``` + +Then create a file named _build.sbt_ in the project root directory that contains this line: ```scala scalaVersion := "{{ site.scala-3-version }}" @@ -51,6 +64,18 @@ Now create a file named something like _Hello.scala_---the first part of the nam ``` That’s all you have to do. + +You should have a project structure like the following: + +~~~ bash +$ tree +. +├── build.sbt +├── Hello.scala +└── project + └── build.properties +~~~ + Now run the project with this `sbt` command: ```bash @@ -61,7 +86,7 @@ You should see output that looks like this, including the `"Hello, world"` from ```bash $ sbt run -[info] welcome to sbt 1.4.4 (AdoptOpenJDK Java 11.x) +[info] welcome to sbt 1.5.4 (AdoptOpenJDK Java 11.x) [info] loading project definition from project ... [info] loading settings for project from build.sbt ... [info] compiling 1 Scala source to target/scala-3.0.0/classes ... @@ -70,7 +95,9 @@ Hello, world [success] Total time: 2 s ``` -When you look at your directory, you’ll see that sbt has created two directories named _project_ and _target_. +The sbt launcher---the `sbt` command-line tool---loads the version of sbt set in the file _project/build.properties_, which loads the version of the Scala compiler set in the file _build.sbt_, compiles the code in the file _Hello.scala_, and runs the resulting bytecode. + +When you look at your directory, you’ll see that sbt has a directory named _target_. These are working directories that sbt uses. As you can see, creating and running a little Scala project with sbt takes just a few simple steps. @@ -92,31 +119,34 @@ A nice benefit of that is that once you’re comfortable with its structure, it The first thing to know is that underneath the root directory of your project, sbt expects a directory structure that looks like this: -```bash -build.sbt -project/ -src/ --- main/ - |-- java/ - |-- resources/ - |-- scala/ -|-- test/ - |-- java/ - |-- resources/ - |-- scala/ -target/ +```text +. +├── build.sbt +├── project/ +│ └── build.properties +├── src/ +│ ├── main/ +│ │ ├── java/ +│ │ ├── resources/ +│ │ └── scala/ +│ └── test/ +│ ├── java/ +│ ├── resources/ +│ └── scala/ +└── target/ ``` You can also add a _lib_ directory under the root directory if you want to add unmanaged dependencies---JAR files---to your project. If you’re going to create a project that has Scala source code files and tests, but won’t be using any Java source code files, and doesn’t need any “resources”---such as embedded images, configuration files, etc.---this is all you really need under the _src_ directory: -```bash -src/ --- main/ - |-- scala/ -|-- test/ - |-- scala/ +```text +. +└── src/ + ├── main/ + │ └── scala/ + └── test/ + └── scala/ ``` @@ -284,11 +314,18 @@ As with the previous lesson, create an sbt project directory structure for a pro $ mkdir HelloScalaTest $ cd HelloScalaTest $ mkdir -p src/{main,test}/scala -$ mkdir project target +$ mkdir project ``` -### Creating the build.sbt file +### Creating the build.properties and build.sbt files + +Next, create a _build.properties_ file in the _project/_ subdirectory of your project +with this line: + +```text +sbt.version=1.5.4 +``` Next, create a _build.sbt_ file in the root directory of your project with these contents: @@ -298,7 +335,7 @@ version := "0.1" scalaVersion := "{{site.scala-3-version}}" libraryDependencies ++= Seq( - "org.scalatest" %% "scalatest" % "3.3.0-SNAP3" % Test + "org.scalatest" %% "scalatest" % "3.2.9" % Test ) ``` From 512f89eb3fbdd80305d56e186f3775a7c49621ce Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 28 Jun 2021 17:30:19 +0200 Subject: [PATCH 1539/3075] Clarify the recommended learning path via the MOOCs --- learn.md | 16 ++++++++++++++++ resources/images/learning-path.png | Bin 0 -> 42763 bytes 2 files changed, 16 insertions(+) create mode 100644 resources/images/learning-path.png diff --git a/learn.md b/learn.md index 19af2b78c9..797f193e3e 100644 --- a/learn.md +++ b/learn.md @@ -36,6 +36,8 @@ this course in the following video: +This course is also a good way to upgrade your Scala 2 knowledge to Scala 3. + After taking this course, you might be interested in improving your skills in specific areas by taking the courses [Parallel Programming], [Big Data Analysis with Scala and Spark], or [Programming Reactive Systems]. @@ -61,6 +63,20 @@ and Spark. teaches how to write responsive, scalable, and resilient systems with the library Akka. +### Scala Learning Path + +The diagram below summarizes the possible learning paths with our courses: + +![](/resources/images/learning-path.png) + +The “foundational” courses target programmers with no prior experience in Scala, whereas the “deepening” +courses aim at strengthening Scala programmers skills in a specific domain (such as parallel programming). + +We recommend starting with either Effective Programming in Scala, or Functional Programming Principles in +Scala followed by Functional Program Design. Then, you can complement your Scala skills by taking any +of the courses Programming Reactive Systems, Parallel Programming, or Big Data Analysis with Scala and Spark. +In case you take the Scala Specialization, you will end with the Scala Capstone Project. + ### Scala 2 Courses The above courses use Scala 3 (except the Spark courses). If needed, you can find diff --git a/resources/images/learning-path.png b/resources/images/learning-path.png new file mode 100644 index 0000000000000000000000000000000000000000..43e9d09631651ea12fc71a3cd9707a9f97e05da8 GIT binary patch literal 42763 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 Date: Mon, 28 Jun 2021 10:07:30 -0700 Subject: [PATCH 1540/3075] FAQ: Who's behind Scala? --- _overviews/FAQ/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index ba0cce896d..1bf9ea5b7a 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -58,6 +58,10 @@ This is addressed on our [Community page](https://scala-lang.org/community/#scal In short, the only officially sanctioned place is the [scala/job-board room on Gitter](https://gitter.im/scala/job-board). +### Who's behind Scala? + +This is answered [on the community page](https://www.scala-lang.org/community/#whos-behind-scala). + ### Can I use the Scala logo? See [scala/scala-lang#1040](https://github.com/scala/scala-lang/issues/1040). From 9ffe4b9aff6443d9e789a89bf2c84a62be7a55e7 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Wed, 30 Jun 2021 11:18:07 +0200 Subject: [PATCH 1541/3075] Merge https://github.com/lampepfl/dotty/blob/master/docs/docs/usage/getting-started.md here MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - The part about scastie was already mentioned in our scala3/getting-started.md page - Copied the part about the giter8 templates into the Scala 3 book, - IDE support was covered in our getting-started page - Skipped “Standalone installation”, since the recommended way to install Scala 3 is to use `cs` - “Scala 3 for scripting” was already covered by scala3/book/taste-hello-world.md --- _overviews/scala3-book/scala-tools.md | 36 +++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/_overviews/scala3-book/scala-tools.md b/_overviews/scala3-book/scala-tools.md index 75bb1f2c0d..bffe1791dd 100644 --- a/_overviews/scala3-book/scala-tools.md +++ b/_overviews/scala3-book/scala-tools.md @@ -269,6 +269,42 @@ There, that’s much faster. If you type `help` at the sbt command prompt you’ll see a list of other commands you can run. But for now, just type `exit` (or press `CTRL-D`) to leave the sbt shell. +### Using project templates + +Manually creating the project structure can be tedious. Thankfully, sbt can create it for you, +based on a template. + +To create a Scala 3 project from a template, run the following command in a shell: + +~~~ +$ sbt new scala/scala3.g8 +~~~ + +Sbt will load the template, ask some questions, and create the project files in a subdirectory: + +~~~ +$ tree scala-3-project-template +scala-3-project-template +├── build.sbt +├── project +│ └── build.properties +├── README.md +└── src + ├── main + │ └── scala + │ └── Main.scala + └── test + └── scala + └── Test1.scala +~~~ + +> If you want to create a Scala 3 project that cross-compiles with Scala 2, use the template `scala/scala3-cross.g8`: +> +> ~~~ +> $ sbt new scala/scala3-cross.g8 +> ~~~ + +Learn more about `sbt new` and project templates in the [documentation of sbt](https://www.scala-sbt.org/1.x/docs/sbt-new-and-Templates.html#sbt+new+and+Templates). ### Other build tools for Scala From 446a51fb7d8b4f907f2325d1a5cc3affcdc1790f Mon Sep 17 00:00:00 2001 From: Nate Black Date: Wed, 30 Jun 2021 08:31:25 -0400 Subject: [PATCH 1542/3075] Removed 'do' line from the Scala 2 while section --- _overviews/scala3-book/taste-control-structures.md | 1 - 1 file changed, 1 deletion(-) diff --git a/_overviews/scala3-book/taste-control-structures.md b/_overviews/scala3-book/taste-control-structures.md index 5c30f73da4..520453481f 100644 --- a/_overviews/scala3-book/taste-control-structures.md +++ b/_overviews/scala3-book/taste-control-structures.md @@ -239,7 +239,6 @@ In Scala 2, the syntax was a bit different. The condition was surrounded by pare there was no `do` keyword: ```scala -while (x >= 0) do x = f(x) while (x >= 0) { x = f(x) } ``` From 9b8c42b8498c3f55d0d2ffcec9c8c02b0c3d4866 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Wed, 30 Jun 2021 15:06:16 +0200 Subject: [PATCH 1543/3075] Merge https://github.com/lampepfl/dotty/blob/master/docs/docs/usage/ide-support.md here MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Only added a mention of BSP - Skipped instructions in “importing the project using BSP using IntelliJ” because they are not working --- scala3/getting-started.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/scala3/getting-started.md b/scala3/getting-started.md index b24836f764..c888285fb3 100644 --- a/scala3/getting-started.md +++ b/scala3/getting-started.md @@ -117,8 +117,9 @@ They both offer rich IDE features, but you can still use [many other editors.](h When prompted to do so, select _Import build_. >[Metals](https://scalameta.org/metals) is a “Scala language server” that provides support for writing Scala code in VS Code and other editors like [Atom, Sublime Text, and more](https://scalameta.org/metals/docs/editors/overview.html), using the Language Server Protocol. -(For details on how Metals works, see, [“Write Scala in VS Code, Vim, Emacs, Atom and Sublime Text with Metals”](https://www.scala-lang.org/2019/04/16/metals.html).) - +> +> Under the hood, Metals communicates with the build tool by using +> the [Build Server Protocol (BSP)](https://build-server-protocol.github.io/). For details on how Metals works, see, [“Write Scala in VS Code, Vim, Emacs, Atom and Sublime Text with Metals”](https://www.scala-lang.org/2019/04/16/metals.html). ### View the source code From 3d941d96c703c12d4c8732ae5306530b5c7239d5 Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Wed, 30 Jun 2021 15:17:52 +0200 Subject: [PATCH 1544/3075] Fix page number --- _overviews/scala3-migration/external-resources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/external-resources.md b/_overviews/scala3-migration/external-resources.md index 77a65829b2..4915537176 100644 --- a/_overviews/scala3-migration/external-resources.md +++ b/_overviews/scala3-migration/external-resources.md @@ -2,7 +2,7 @@ title: External Resources type: section description: This section lists external resources about the migration to Scala 3. -num: 26 +num: 27 previous-page: plugin-kind-projector next-page: --- From 01b5a7cfff1ae96a9c2b9d1918df4f9e66fc2b5c Mon Sep 17 00:00:00 2001 From: Adrian Theodorescu Date: Sat, 3 Jul 2021 13:49:48 -0500 Subject: [PATCH 1545/3075] Fix typo in overviews/scala-book/scala-build-tool-sbt --- _overviews/scala-book/scala-build-tool-sbt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala-book/scala-build-tool-sbt.md b/_overviews/scala-book/scala-build-tool-sbt.md index e798bc05d2..8986433976 100644 --- a/_overviews/scala-book/scala-build-tool-sbt.md +++ b/_overviews/scala-book/scala-build-tool-sbt.md @@ -156,7 +156,7 @@ If you type `help` at the sbt command prompt you’ll see a bunch of other comma ## See also -Here’s a list of other build tools you can use to build Scala projects are: +Here’s a list of other build tools you can use to build Scala projects: - [Ant](http://ant.apache.org/) - [Gradle](https://gradle.org/) From 1b0bd33313fa592a65bec9731a85d9425ebf4c56 Mon Sep 17 00:00:00 2001 From: Genghis Yang Date: Sun, 4 Jul 2021 17:26:13 +0800 Subject: [PATCH 1546/3075] Remove duplicated `a` --- _overviews/scala3-book/fp-functions-are-values.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/fp-functions-are-values.md b/_overviews/scala3-book/fp-functions-are-values.md index 0c8a1df792..d2766c65fe 100644 --- a/_overviews/scala3-book/fp-functions-are-values.md +++ b/_overviews/scala3-book/fp-functions-are-values.md @@ -37,7 +37,7 @@ val doubles = nums.filter(underFive).map(double) This ability to treat methods and functions as values is a powerful feature that functional programming languages provide. -> Technically, a a function that takes another function as an input parameter is known as a *Higher-Order Function*. +> Technically, a function that takes another function as an input parameter is known as a *Higher-Order Function*. > (If you like humor, as someone once wrote, that’s like saying that a class that takes an instance of another class as a constructor parameter is a Higher-Order Class.) From bf9f32e844c577d1d4ba55a5f7fe31ffd11a4300 Mon Sep 17 00:00:00 2001 From: Haythem Chagwey Date: Sun, 4 Jul 2021 10:48:27 +0100 Subject: [PATCH 1547/3075] Update the Type inference section's link --- _overviews/scala3-book/scala-features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/scala-features.md b/_overviews/scala3-book/scala-features.md index f0c8efb129..606365a130 100644 --- a/_overviews/scala3-book/scala-features.md +++ b/_overviews/scala3-book/scala-features.md @@ -161,7 +161,7 @@ In that list: Scala’s type system enforces, at compile-time, that abstractions are used in a safe and coherent manner. In particular, the type system supports: -- [Type inference](/tour/type-inference.html) +- [Inferred types]({% link _overviews/scala3-book/types-inferred.md %}) - [Generic classes]({% link _overviews/scala3-book/types-generics.md %}) - [Variance annotations]({% link _overviews/scala3-book/types-variance.md %}) - [Upper](/tour/upper-type-bounds.html) and [lower](/tour/lower-type-bounds.html) type bounds From 45678020ba4566d9d8cf8562a39827c7d1dbe34a Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 5 Jul 2021 14:36:41 +0200 Subject: [PATCH 1548/3075] Introduce a page about worksheets MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Previously, the page “Scala Tools” was mainly about sbt. We now have a chapter “Scala Tools”, which contains two sections: “Building and Testing Scala Projects with sbt”, and “Worksheets”. --- .../scala3-book/interacting-with-java.md | 4 +- _overviews/scala3-book/scala-for-java-devs.md | 2 +- .../scala3-book/scala-for-javascript-devs.md | 2 +- .../scala3-book/scala-for-python-devs.md | 2 +- _overviews/scala3-book/scala-tools.md | 508 +---------------- _overviews/scala3-book/taste-repl.md | 2 + _overviews/scala3-book/tools-sbt.md | 512 ++++++++++++++++++ _overviews/scala3-book/tools-worksheets.md | 56 ++ .../images/scala3-book/intellij-worksheet.png | Bin 0 -> 12899 bytes .../images/scala3-book/metals-worksheet.png | Bin 0 -> 16233 bytes 10 files changed, 579 insertions(+), 509 deletions(-) create mode 100644 _overviews/scala3-book/tools-sbt.md create mode 100644 _overviews/scala3-book/tools-worksheets.md create mode 100644 resources/images/scala3-book/intellij-worksheet.png create mode 100644 resources/images/scala3-book/metals-worksheet.png diff --git a/_overviews/scala3-book/interacting-with-java.md b/_overviews/scala3-book/interacting-with-java.md index 8ccb38e156..5b0b99286b 100644 --- a/_overviews/scala3-book/interacting-with-java.md +++ b/_overviews/scala3-book/interacting-with-java.md @@ -2,8 +2,8 @@ title: Interacting with Java type: chapter description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. -num: 70 -previous-page: scala-tools +num: 72 +previous-page: tools-worksheets next-page: scala-for-java-devs --- diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index be54f5fd25..125f77c06e 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -2,7 +2,7 @@ title: Scala for Java Developers type: chapter description: This page is for Java developers who are interested in learning about Scala 3. -num: 71 +num: 73 previous-page: interacting-with-java next-page: scala-for-javascript-devs --- diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index a577837e56..462a1017ce 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -2,7 +2,7 @@ title: Scala for JavaScript Developers type: chapter description: This chapter provides an introduction to Scala 3 for JavaScript developers -num: 72 +num: 74 previous-page: scala-for-java-devs next-page: scala-for-python-devs --- diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index 395d7c450d..77fb3c5881 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -2,7 +2,7 @@ title: Scala for Python Developers type: chapter description: This page is for Python developers who are interested in learning about Scala 3. -num: 73 +num: 75 previous-page: scala-for-javascript-devs next-page: --- diff --git a/_overviews/scala3-book/scala-tools.md b/_overviews/scala3-book/scala-tools.md index bffe1791dd..52e4bc67b7 100644 --- a/_overviews/scala3-book/scala-tools.md +++ b/_overviews/scala3-book/scala-tools.md @@ -4,510 +4,10 @@ type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. num: 69 previous-page: concurrency -next-page: interacting-with-java +next-page: tools-sbt --- +This chapter introduces two ways to write and run Scala programs: -In this chapter you’ll see two tools that are commonly used in Scala projects: - -- The [sbt](https://www.scala-sbt.org) build tool -- [ScalaTest](https://www.scalatest.org), a source code testing framework - -We’ll start by showing how to use sbt to build your Scala projects, and then we’ll show how to use sbt and ScalaTest together to test your Scala projects. - -> If you want to learn about tools to help you migrate your Scala 2 code to Scala 3, see our [Scala 3 Migration Guide](/scala3/guides/migration/compatibility-intro.html). - - - -## Building Scala projects with sbt - -You can use several different tools to build your Scala projects, including Ant, Maven, Gradle, Mill, and more. -But a tool named _sbt_ was the first build tool that was specifically created for Scala. - -> To install sbt, see [its download page](https://www.scala-sbt.org/download.html) or our [Getting Started][getting_started] page. - - - -### Creating a “Hello, world” project - -You can create an sbt “Hello, world” project in just a few steps. -First, create a directory to work in, and move into that directory: - -```bash -$ mkdir hello -$ cd hello -``` - -In the directory `hello`, create a subdirectory `project`: - -```bash -$ mkdir project -``` - -Create a file named _build.properties_ in the directory `project`, with -the following content: - -```text -sbt.version=1.5.4 -``` - -Then create a file named _build.sbt_ in the project root directory that contains this line: - -```scala -scalaVersion := "{{ site.scala-3-version }}" -``` - -Now create a file named something like _Hello.scala_---the first part of the name doesn’t matter---with this line: - -```scala -@main def helloWorld = println("Hello, world") -``` - -That’s all you have to do. - -You should have a project structure like the following: - -~~~ bash -$ tree -. -├── build.sbt -├── Hello.scala -└── project - └── build.properties -~~~ - -Now run the project with this `sbt` command: - -```bash -$ sbt run -``` - -You should see output that looks like this, including the `"Hello, world"` from your program: - -```bash -$ sbt run -[info] welcome to sbt 1.5.4 (AdoptOpenJDK Java 11.x) -[info] loading project definition from project ... -[info] loading settings for project from build.sbt ... -[info] compiling 1 Scala source to target/scala-3.0.0/classes ... -[info] running helloWorld -Hello, world -[success] Total time: 2 s -``` - -The sbt launcher---the `sbt` command-line tool---loads the version of sbt set in the file _project/build.properties_, which loads the version of the Scala compiler set in the file _build.sbt_, compiles the code in the file _Hello.scala_, and runs the resulting bytecode. - -When you look at your directory, you’ll see that sbt has a directory named _target_. -These are working directories that sbt uses. - -As you can see, creating and running a little Scala project with sbt takes just a few simple steps. - -> For sbt version < 1.5.0, it is required to have the following line in a *project/plugins.sbt* file: `addSbtPlugin("ch.epfl.lamp" % "sbt-dotty" % "{{ site.scala-3-plugin-version }}")` - - -### Using sbt with larger projects - -For a little project, that’s all that sbt requires to run. -For larger projects that require many source code files, dependencies, or sbt plugins, you’ll want to create an organized directory structure. -The rest of this section demonstrates the structure that sbt uses. - - -### The sbt directory structure - -Like Maven, sbt uses a standard project directory structure. -A nice benefit of that is that once you’re comfortable with its structure, it makes it easy to work on other Scala/sbt projects. - -The first thing to know is that underneath the root directory of your project, sbt expects a directory structure that looks like this: - -```text -. -├── build.sbt -├── project/ -│ └── build.properties -├── src/ -│ ├── main/ -│ │ ├── java/ -│ │ ├── resources/ -│ │ └── scala/ -│ └── test/ -│ ├── java/ -│ ├── resources/ -│ └── scala/ -└── target/ -``` - -You can also add a _lib_ directory under the root directory if you want to add unmanaged dependencies---JAR files---to your project. - -If you’re going to create a project that has Scala source code files and tests, but won’t be using any Java source code files, and doesn’t need any “resources”---such as embedded images, configuration files, etc.---this is all you really need under the _src_ directory: - -```text -. -└── src/ - ├── main/ - │ └── scala/ - └── test/ - └── scala/ -``` - - -### “Hello, world” with an sbt directory structure - -{% comment %} -LATER: using something like `sbt new scala/scala3.g8` may eventually - be preferable, but that seems to have a few bugs atm (creates - a 'target' directory above the root; renames the root dir; - uses 'dottyVersion'; 'name' doesn’t match the supplied name; - config syntax is a little hard for beginners.) -{% endcomment %} - -Creating this directory structure is simple. -There are tools to do this for you, but assuming that you’re using a Unix/Linux system, you can use these commands to create your first sbt project directory structure: - -```bash -$ mkdir HelloWorld -$ cd HelloWorld -$ mkdir -p src/{main,test}/scala -$ mkdir project target -``` - -When you run a `find .` command after running those commands, you should see this result: - -```bash -$ find . -. -./project -./src -./src/main -./src/main/scala -./src/test -./src/test/scala -./target -``` - -If you see that, you’re in great shape for the next step. - -> There are other ways to create the files and directories for an sbt project. -> One way is to use the `sbt new` command, [which is documented here on scala-sbt.org](https://www.scala-sbt.org/1.x/docs/Hello.html). -> That approach isn’t shown here because some of the files it creates are more complicated than necessary for an introduction like this. - - -### Creating a first build.sbt file - -At this point you only need two more things to run a “Hello, world” project: - -- A _build.sbt_ file -- A _Hello.scala_ file - -For a little project like this, the _build.sbt_ file only needs a `scalaVersion` entry, but we’ll add three lines that you commonly see: - -```scala -name := "HelloWorld" -version := "0.1" -scalaVersion := "{{ site.scala-3-version }}" -``` - -Because sbt projects use a standard directory structure, sbt can find everything else it needs. - -Now you just need to add a little “Hello, world” program. - - -### A “Hello, world” program - -In large projects, all of your Scala source code files will go under the _src/main/scala_ and _src/test/scala_ directories, but for a little sample project like this, you can put your source code file in the root directory of your project. -Therefore, create a file named _HelloWorld.scala_ in the root directory with these contents: - -```scala -@main def helloWorld = println("Hello, world") -``` - -That code defines a Scala 3 “main” method that prints the `"Hello, world"` when it’s run. - -Now, use the `sbt run` command to compile and run your project: - -```bash -$ sbt run - -[info] welcome to sbt -[info] loading settings for project ... -[info] loading project definition -[info] loading settings for project root from build.sbt ... -[info] Compiling 1 Scala source ... -[info] running helloWorld -Hello, world -[success] Total time: 4 s -``` - -The first time you run `sbt` it downloads everything it needs, and that can take a few moments to run, but after that it gets much faster. - -Also, once you get this first step working, you’ll find that it’s much faster to run sbt interactively. -To do that, first run the `sbt` command by itself: - -```bash -$ sbt - -[info] welcome to sbt -[info] loading settings for project ... -[info] loading project definition ... -[info] loading settings for project root from build.sbt ... -[info] sbt server started at - local:///${HOME}/.sbt/1.0/server/7d26bae822c36a31071c/sock -sbt:hello-world> _ -``` - -Then inside this sbt shell, execute its `run` command: - -```` -sbt:hello-world> run - -[info] running helloWorld -Hello, world -[success] Total time: 0 s -```` - -There, that’s much faster. - -If you type `help` at the sbt command prompt you’ll see a list of other commands you can run. -But for now, just type `exit` (or press `CTRL-D`) to leave the sbt shell. - -### Using project templates - -Manually creating the project structure can be tedious. Thankfully, sbt can create it for you, -based on a template. - -To create a Scala 3 project from a template, run the following command in a shell: - -~~~ -$ sbt new scala/scala3.g8 -~~~ - -Sbt will load the template, ask some questions, and create the project files in a subdirectory: - -~~~ -$ tree scala-3-project-template -scala-3-project-template -├── build.sbt -├── project -│ └── build.properties -├── README.md -└── src - ├── main - │ └── scala - │ └── Main.scala - └── test - └── scala - └── Test1.scala -~~~ - -> If you want to create a Scala 3 project that cross-compiles with Scala 2, use the template `scala/scala3-cross.g8`: -> -> ~~~ -> $ sbt new scala/scala3-cross.g8 -> ~~~ - -Learn more about `sbt new` and project templates in the [documentation of sbt](https://www.scala-sbt.org/1.x/docs/sbt-new-and-Templates.html#sbt+new+and+Templates). - -### Other build tools for Scala - -While sbt is widely used, there are other tools you can use to build Scala projects: - -- [Ant](https://ant.apache.org/) -- [Gradle](https://gradle.org/) -- [Maven](https://maven.apache.org/) -- [Mill](https://com-lihaoyi.github.io/mill/) - -#### Coursier - -In a related note, [Coursier](https://get-coursier.io/docs/overview) is a “dependency resolver,” similar to Maven and Ivy in function. -It’s written from scratch in Scala, “embraces functional programming principles,” and downloads artifacts in parallel for rapid downloads. -sbt uses it to handle most dependency resolutions, and as a command-line tool, it can be used to easily install tools like sbt, Java, and Scala on your system, as shown in our [Getting Started][getting_started] page. - -This example from the `launch` web page shows that the `cs launch` command can be used to launch applications from dependencies: - -```scala -$ cs launch org.scalameta::scalafmt-cli:2.4.2 -- --help -scalafmt 2.4.2 -Usage: scalafmt [options] [...] - - -h, --help prints this usage text - -v, --version print version - more ... -``` - -See Coursier’s [launch page](https://get-coursier.io/docs/cli-launch) for more details. - - - -## Using sbt with ScalaTest - -[ScalaTest](https://www.scalatest.org) is one of the main testing libraries for Scala projects, and in this section you’ll see how to create a Scala/sbt project that uses ScalaTest. - - -### Creating the project directory structure - -As with the previous lesson, create an sbt project directory structure for a project named _HelloScalaTest_ with the following commands: - -```bash -$ mkdir HelloScalaTest -$ cd HelloScalaTest -$ mkdir -p src/{main,test}/scala -$ mkdir project -``` - - -### Creating the build.properties and build.sbt files - -Next, create a _build.properties_ file in the _project/_ subdirectory of your project -with this line: - -```text -sbt.version=1.5.4 -``` - -Next, create a _build.sbt_ file in the root directory of your project with these contents: - -```scala -name := "HelloScalaTest" -version := "0.1" -scalaVersion := "{{site.scala-3-version}}" - -libraryDependencies ++= Seq( - "org.scalatest" %% "scalatest" % "3.2.9" % Test -) -``` - -The first three lines of this file are essentially the same as the first example. -The `libraryDependencies` lines tell sbt to include the dependencies (JAR files) that are needed to include ScalaTest. - -> The ScalaTest documentation has always been good, and you can always find the up to date information on what those lines should look like on the [Installing ScalaTest](https://www.scalatest.org/install) page. - - -### Create a Scala source code file - -Next, create a Scala program that you can use to demonstrate ScalaTest. -First, create a directory under _src/main/scala_ named _math_: - -```bash -$ mkdir src/main/scala/math - ---- -``` - -Then, inside that directory, create a file named _MathUtils.scala_ with these contents: - -```scala -package math - -object MathUtils: - def double(i: Int) = i * 2 -``` - -That method provides a simple way to demonstrate ScalaTest. - - -{% comment %} -Because this project doesn’t have a `main` method, we don’t try to run it with `sbt run`; we just compile it with `sbt compile`: - -```` -$ sbt compile - -[info] welcome to sbt -[info] loading settings for project ... -[info] loading project definition ... -[info] loading settings for project ... -[info] Executing in batch mode. For better performance use sbt's shell -[success] Total time: 1 s -```` - -With that compiled, let’s create a ScalaTest file to test the `double` method. -{% endcomment %} - - -### Your first ScalaTest tests - -ScalaTest is very flexible, and offers several different ways to write tests. -A simple way to get started is to write tests using the ScalaTest `AnyFunSuite`. -To get started, create a directory named _math_ under the _src/test/scala_ directory: - -```bash -$ mkdir src/test/scala/math - ---- -``` - -Next, create a file named _MathUtilsTests.scala_ in that directory with the following contents: - -```scala -package math - -import org.scalatest.funsuite.AnyFunSuite - -class MathUtilsTests extends AnyFunSuite: - - // test 1 - test("'double' should handle 0") { - val result = MathUtils.double(0) - assert(result == 0) - } - - // test 2 - test("'double' should handle 1") { - val result = MathUtils.double(1) - assert(result == 2) - } - - test("test with Int.MaxValue") (pending) - -end MathUtilsTests -``` - -This code demonstrates the ScalaTest `AnyFunSuite` approach. -A few important points: - -- Your test class should extend `AnyFunSuite` -- You create tests as shown, by giving each `test` a unique name -- At the end of each test you should call `assert` to test that a condition has been satisfied -- When you know you want to write a test, but you don’t want to write it right now, create the test as “pending,” with the syntax shown - -Using ScalaTest like this is similar to JUnit, so if you’re coming to Scala from Java, hopefully this looks similar. - -Now you can run these tests with the `sbt test` command. -Skipping the first few lines of output, the result looks like this: - -```` -sbt:HelloScalaTest> test - -[info] Compiling 1 Scala source ... -[info] MathUtilsTests: -[info] - 'double' should handle 0 -[info] - 'double' should handle 1 -[info] - test with Int.MaxValue (pending) -[info] Total number of tests run: 2 -[info] Suites: completed 1, aborted 0 -[info] Tests: succeeded 2, failed 0, canceled 0, ignored 0, pending 1 -[info] All tests passed. -[success] Total time: 1 s -```` - -If everything works well, you’ll see output that looks like that. -Welcome to the world of testing Scala applications with sbt and ScalaTest. - - -### Support for many types of tests - -This example demonstrates a style of testing that’s similar to xUnit _Test-Driven Development_ (TDD) style testing, with a few benefits of the _Behavior-Driven Development_ (BDD) style. - -As mentioned, ScalaTest is flexible and you can also write tests using other styles, such as a style similar to Ruby’s RSpec. -You can also use mock objects, property-based testing, and use ScalaTest to test Scala.js code. - -See the User Guide on the [ScalaTest website](https://www.scalatest.org) for more details on the different testing styles that are available. - - - -## Where to go from here - -For more information about sbt and ScalaTest, see the following resources: - -- [The sbt documentation](https://www.scala-sbt.org/1.x/docs/) -- [The ScalaTest website](https://www.scalatest.org/) - - - -[getting_started]: {{ site.baseurl }}/scala3/getting-started.html +- by creating Scala projects, possibly containing multiple files, and defining a program entry point, +- by interacting with a worksheet, which is a program defined in a single file, executed line by line. diff --git a/_overviews/scala3-book/taste-repl.md b/_overviews/scala3-book/taste-repl.md index 130168c5cb..dba5420401 100644 --- a/_overviews/scala3-book/taste-repl.md +++ b/_overviews/scala3-book/taste-repl.md @@ -54,4 +54,6 @@ val res2: Int = 4 If you prefer a browser-based playground environment, you can also use [scastie.scala-lang.org](https://scastie.scala-lang.org). +If you prefer writing your code in a text editor instead of in console prompt, you can use a [worksheet]. +[worksheet]: {% link _overviews/scala3-book/tools-worksheets.md %} diff --git a/_overviews/scala3-book/tools-sbt.md b/_overviews/scala3-book/tools-sbt.md new file mode 100644 index 0000000000..e5dd291293 --- /dev/null +++ b/_overviews/scala3-book/tools-sbt.md @@ -0,0 +1,512 @@ +--- +title: Building and Testing Scala Projects with sbt +type: section +description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. +num: 70 +previous-page: scala-tools +next-page: tools-worksheets +--- + +In this section you’ll see two tools that are commonly used in Scala projects: + +- The [sbt](https://www.scala-sbt.org) build tool +- [ScalaTest](https://www.scalatest.org), a source code testing framework + +We’ll start by showing how to use sbt to build your Scala projects, and then we’ll show how to use sbt and ScalaTest together to test your Scala projects. + +> If you want to learn about tools to help you migrate your Scala 2 code to Scala 3, see our [Scala 3 Migration Guide](/scala3/guides/migration/compatibility-intro.html). + + + +## Building Scala projects with sbt + +You can use several different tools to build your Scala projects, including Ant, Maven, Gradle, Mill, and more. +But a tool named _sbt_ was the first build tool that was specifically created for Scala. + +> To install sbt, see [its download page](https://www.scala-sbt.org/download.html) or our [Getting Started][getting_started] page. + + + +### Creating a “Hello, world” project + +You can create an sbt “Hello, world” project in just a few steps. +First, create a directory to work in, and move into that directory: + +```bash +$ mkdir hello +$ cd hello +``` + +In the directory `hello`, create a subdirectory `project`: + +```bash +$ mkdir project +``` + +Create a file named _build.properties_ in the directory `project`, with +the following content: + +```text +sbt.version=1.5.4 +``` + +Then create a file named _build.sbt_ in the project root directory that contains this line: + +```scala +scalaVersion := "{{ site.scala-3-version }}" +``` + +Now create a file named something like _Hello.scala_---the first part of the name doesn’t matter---with this line: + +```scala +@main def helloWorld = println("Hello, world") +``` + +That’s all you have to do. + +You should have a project structure like the following: + +~~~ bash +$ tree +. +├── build.sbt +├── Hello.scala +└── project + └── build.properties +~~~ + +Now run the project with this `sbt` command: + +```bash +$ sbt run +``` + +You should see output that looks like this, including the `"Hello, world"` from your program: + +```bash +$ sbt run +[info] welcome to sbt 1.5.4 (AdoptOpenJDK Java 11.x) +[info] loading project definition from project ... +[info] loading settings for project from build.sbt ... +[info] compiling 1 Scala source to target/scala-3.0.0/classes ... +[info] running helloWorld +Hello, world +[success] Total time: 2 s +``` + +The sbt launcher---the `sbt` command-line tool---loads the version of sbt set in the file _project/build.properties_, which loads the version of the Scala compiler set in the file _build.sbt_, compiles the code in the file _Hello.scala_, and runs the resulting bytecode. + +When you look at your directory, you’ll see that sbt has a directory named _target_. +These are working directories that sbt uses. + +As you can see, creating and running a little Scala project with sbt takes just a few simple steps. + +> For sbt version < 1.5.0, it is required to have the following line in a *project/plugins.sbt* file: `addSbtPlugin("ch.epfl.lamp" % "sbt-dotty" % "{{ site.scala-3-plugin-version }}")` + + +### Using sbt with larger projects + +For a little project, that’s all that sbt requires to run. +For larger projects that require many source code files, dependencies, or sbt plugins, you’ll want to create an organized directory structure. +The rest of this section demonstrates the structure that sbt uses. + + +### The sbt directory structure + +Like Maven, sbt uses a standard project directory structure. +A nice benefit of that is that once you’re comfortable with its structure, it makes it easy to work on other Scala/sbt projects. + +The first thing to know is that underneath the root directory of your project, sbt expects a directory structure that looks like this: + +```text +. +├── build.sbt +├── project/ +│ └── build.properties +├── src/ +│ ├── main/ +│ │ ├── java/ +│ │ ├── resources/ +│ │ └── scala/ +│ └── test/ +│ ├── java/ +│ ├── resources/ +│ └── scala/ +└── target/ +``` + +You can also add a _lib_ directory under the root directory if you want to add unmanaged dependencies---JAR files---to your project. + +If you’re going to create a project that has Scala source code files and tests, but won’t be using any Java source code files, and doesn’t need any “resources”---such as embedded images, configuration files, etc.---this is all you really need under the _src_ directory: + +```text +. +└── src/ + ├── main/ + │ └── scala/ + └── test/ + └── scala/ +``` + + +### “Hello, world” with an sbt directory structure + +{% comment %} +LATER: using something like `sbt new scala/scala3.g8` may eventually + be preferable, but that seems to have a few bugs atm (creates + a 'target' directory above the root; renames the root dir; + uses 'dottyVersion'; 'name' doesn’t match the supplied name; + config syntax is a little hard for beginners.) +{% endcomment %} + +Creating this directory structure is simple. +There are tools to do this for you, but assuming that you’re using a Unix/Linux system, you can use these commands to create your first sbt project directory structure: + +```bash +$ mkdir HelloWorld +$ cd HelloWorld +$ mkdir -p src/{main,test}/scala +$ mkdir project target +``` + +When you run a `find .` command after running those commands, you should see this result: + +```bash +$ find . +. +./project +./src +./src/main +./src/main/scala +./src/test +./src/test/scala +./target +``` + +If you see that, you’re in great shape for the next step. + +> There are other ways to create the files and directories for an sbt project. +> One way is to use the `sbt new` command, [which is documented here on scala-sbt.org](https://www.scala-sbt.org/1.x/docs/Hello.html). +> That approach isn’t shown here because some of the files it creates are more complicated than necessary for an introduction like this. + + +### Creating a first build.sbt file + +At this point you only need two more things to run a “Hello, world” project: + +- A _build.sbt_ file +- A _Hello.scala_ file + +For a little project like this, the _build.sbt_ file only needs a `scalaVersion` entry, but we’ll add three lines that you commonly see: + +```scala +name := "HelloWorld" +version := "0.1" +scalaVersion := "{{ site.scala-3-version }}" +``` + +Because sbt projects use a standard directory structure, sbt can find everything else it needs. + +Now you just need to add a little “Hello, world” program. + + +### A “Hello, world” program + +In large projects, all of your Scala source code files will go under the _src/main/scala_ and _src/test/scala_ directories, but for a little sample project like this, you can put your source code file in the root directory of your project. +Therefore, create a file named _HelloWorld.scala_ in the root directory with these contents: + +```scala +@main def helloWorld = println("Hello, world") +``` + +That code defines a Scala 3 “main” method that prints the `"Hello, world"` when it’s run. + +Now, use the `sbt run` command to compile and run your project: + +```bash +$ sbt run + +[info] welcome to sbt +[info] loading settings for project ... +[info] loading project definition +[info] loading settings for project root from build.sbt ... +[info] Compiling 1 Scala source ... +[info] running helloWorld +Hello, world +[success] Total time: 4 s +``` + +The first time you run `sbt` it downloads everything it needs, and that can take a few moments to run, but after that it gets much faster. + +Also, once you get this first step working, you’ll find that it’s much faster to run sbt interactively. +To do that, first run the `sbt` command by itself: + +```bash +$ sbt + +[info] welcome to sbt +[info] loading settings for project ... +[info] loading project definition ... +[info] loading settings for project root from build.sbt ... +[info] sbt server started at + local:///${HOME}/.sbt/1.0/server/7d26bae822c36a31071c/sock +sbt:hello-world> _ +``` + +Then inside this sbt shell, execute its `run` command: + +```` +sbt:hello-world> run + +[info] running helloWorld +Hello, world +[success] Total time: 0 s +```` + +There, that’s much faster. + +If you type `help` at the sbt command prompt you’ll see a list of other commands you can run. +But for now, just type `exit` (or press `CTRL-D`) to leave the sbt shell. + +### Using project templates + +Manually creating the project structure can be tedious. Thankfully, sbt can create it for you, +based on a template. + +To create a Scala 3 project from a template, run the following command in a shell: + +~~~ +$ sbt new scala/scala3.g8 +~~~ + +Sbt will load the template, ask some questions, and create the project files in a subdirectory: + +~~~ +$ tree scala-3-project-template +scala-3-project-template +├── build.sbt +├── project +│ └── build.properties +├── README.md +└── src + ├── main + │ └── scala + │ └── Main.scala + └── test + └── scala + └── Test1.scala +~~~ + +> If you want to create a Scala 3 project that cross-compiles with Scala 2, use the template `scala/scala3-cross.g8`: +> +> ~~~ +> $ sbt new scala/scala3-cross.g8 +> ~~~ + +Learn more about `sbt new` and project templates in the [documentation of sbt](https://www.scala-sbt.org/1.x/docs/sbt-new-and-Templates.html#sbt+new+and+Templates). + +### Other build tools for Scala + +While sbt is widely used, there are other tools you can use to build Scala projects: + +- [Ant](https://ant.apache.org/) +- [Gradle](https://gradle.org/) +- [Maven](https://maven.apache.org/) +- [Mill](https://com-lihaoyi.github.io/mill/) + +#### Coursier + +In a related note, [Coursier](https://get-coursier.io/docs/overview) is a “dependency resolver,” similar to Maven and Ivy in function. +It’s written from scratch in Scala, “embraces functional programming principles,” and downloads artifacts in parallel for rapid downloads. +sbt uses it to handle most dependency resolutions, and as a command-line tool, it can be used to easily install tools like sbt, Java, and Scala on your system, as shown in our [Getting Started][getting_started] page. + +This example from the `launch` web page shows that the `cs launch` command can be used to launch applications from dependencies: + +```scala +$ cs launch org.scalameta::scalafmt-cli:2.4.2 -- --help +scalafmt 2.4.2 +Usage: scalafmt [options] [...] + + -h, --help prints this usage text + -v, --version print version + more ... +``` + +See Coursier’s [launch page](https://get-coursier.io/docs/cli-launch) for more details. + + + +## Using sbt with ScalaTest + +[ScalaTest](https://www.scalatest.org) is one of the main testing libraries for Scala projects, and in this section you’ll see how to create a Scala/sbt project that uses ScalaTest. + + +### Creating the project directory structure + +As with the previous lesson, create an sbt project directory structure for a project named _HelloScalaTest_ with the following commands: + +```bash +$ mkdir HelloScalaTest +$ cd HelloScalaTest +$ mkdir -p src/{main,test}/scala +$ mkdir project +``` + + +### Creating the build.properties and build.sbt files + +Next, create a _build.properties_ file in the _project/_ subdirectory of your project +with this line: + +```text +sbt.version=1.5.4 +``` + +Next, create a _build.sbt_ file in the root directory of your project with these contents: + +```scala +name := "HelloScalaTest" +version := "0.1" +scalaVersion := "{{site.scala-3-version}}" + +libraryDependencies ++= Seq( + "org.scalatest" %% "scalatest" % "3.2.9" % Test +) +``` + +The first three lines of this file are essentially the same as the first example. +The `libraryDependencies` lines tell sbt to include the dependencies (JAR files) that are needed to include ScalaTest. + +> The ScalaTest documentation has always been good, and you can always find the up to date information on what those lines should look like on the [Installing ScalaTest](https://www.scalatest.org/install) page. + + +### Create a Scala source code file + +Next, create a Scala program that you can use to demonstrate ScalaTest. +First, create a directory under _src/main/scala_ named _math_: + +```bash +$ mkdir src/main/scala/math + ---- +``` + +Then, inside that directory, create a file named _MathUtils.scala_ with these contents: + +```scala +package math + +object MathUtils: + def double(i: Int) = i * 2 +``` + +That method provides a simple way to demonstrate ScalaTest. + + +{% comment %} +Because this project doesn’t have a `main` method, we don’t try to run it with `sbt run`; we just compile it with `sbt compile`: + +```` +$ sbt compile + +[info] welcome to sbt +[info] loading settings for project ... +[info] loading project definition ... +[info] loading settings for project ... +[info] Executing in batch mode. For better performance use sbt's shell +[success] Total time: 1 s +```` + +With that compiled, let’s create a ScalaTest file to test the `double` method. +{% endcomment %} + + +### Your first ScalaTest tests + +ScalaTest is very flexible, and offers several different ways to write tests. +A simple way to get started is to write tests using the ScalaTest `AnyFunSuite`. +To get started, create a directory named _math_ under the _src/test/scala_ directory: + +```bash +$ mkdir src/test/scala/math + ---- +``` + +Next, create a file named _MathUtilsTests.scala_ in that directory with the following contents: + +```scala +package math + +import org.scalatest.funsuite.AnyFunSuite + +class MathUtilsTests extends AnyFunSuite: + + // test 1 + test("'double' should handle 0") { + val result = MathUtils.double(0) + assert(result == 0) + } + + // test 2 + test("'double' should handle 1") { + val result = MathUtils.double(1) + assert(result == 2) + } + + test("test with Int.MaxValue") (pending) + +end MathUtilsTests +``` + +This code demonstrates the ScalaTest `AnyFunSuite` approach. +A few important points: + +- Your test class should extend `AnyFunSuite` +- You create tests as shown, by giving each `test` a unique name +- At the end of each test you should call `assert` to test that a condition has been satisfied +- When you know you want to write a test, but you don’t want to write it right now, create the test as “pending,” with the syntax shown + +Using ScalaTest like this is similar to JUnit, so if you’re coming to Scala from Java, hopefully this looks similar. + +Now you can run these tests with the `sbt test` command. +Skipping the first few lines of output, the result looks like this: + +```` +sbt:HelloScalaTest> test + +[info] Compiling 1 Scala source ... +[info] MathUtilsTests: +[info] - 'double' should handle 0 +[info] - 'double' should handle 1 +[info] - test with Int.MaxValue (pending) +[info] Total number of tests run: 2 +[info] Suites: completed 1, aborted 0 +[info] Tests: succeeded 2, failed 0, canceled 0, ignored 0, pending 1 +[info] All tests passed. +[success] Total time: 1 s +```` + +If everything works well, you’ll see output that looks like that. +Welcome to the world of testing Scala applications with sbt and ScalaTest. + + +### Support for many types of tests + +This example demonstrates a style of testing that’s similar to xUnit _Test-Driven Development_ (TDD) style testing, with a few benefits of the _Behavior-Driven Development_ (BDD) style. + +As mentioned, ScalaTest is flexible and you can also write tests using other styles, such as a style similar to Ruby’s RSpec. +You can also use mock objects, property-based testing, and use ScalaTest to test Scala.js code. + +See the User Guide on the [ScalaTest website](https://www.scalatest.org) for more details on the different testing styles that are available. + + + +## Where to go from here + +For more information about sbt and ScalaTest, see the following resources: + +- [The sbt documentation](https://www.scala-sbt.org/1.x/docs/) +- [The ScalaTest website](https://www.scalatest.org/) + + + +[getting_started]: {{ site.baseurl }}/scala3/getting-started.html diff --git a/_overviews/scala3-book/tools-worksheets.md b/_overviews/scala3-book/tools-worksheets.md new file mode 100644 index 0000000000..3231d4e654 --- /dev/null +++ b/_overviews/scala3-book/tools-worksheets.md @@ -0,0 +1,56 @@ +--- +title: Worksheets +type: section +description: This section looks at worksheets, an alternative to Scala projects. +num: 71 +previous-page: tools-sbt +next-page: interacting-with-java +--- + +A worksheet is a Scala file that is evaluated on save, and the result of each expression is shown +in a column to the right of your program. Worksheets are like a [REPL session] on steroids, and +enjoy 1st class editor support: completion, hyperlinking, interactive errors-as-you-type, etc. +Worksheets use the extension `.worksheet.sc`. + +In the following, we show how to use worksheets in IntelliJ, and in VS Code (with the Metals extension). + +1. Open a Scala project, or create one. + - To create a project in IntelliJ, select “File” -> “New” -> “Project…”, select “Scala” + in the left column, and click “Next” to set the project name and location. + - To create a project in VS Code, run the command “Metals: New Scala project”, select the + seed `scala/scala3.g8`, set the project location, open it in a new VS Code window, and + import its build. +1. Create a file named `hello.worksheet.sc` in the directory `src/main/scala/`. + - In IntelliJ, right-click on the directory `src/main/scala/`, and select “New”, and + then “File”. + - In VS Code, right-click on the directory `src/main/scala/`, and select “New File”. +1. Paste the following content in the editor: + ~~~ + println("Hello, world!") + + val x = 1 + x + x + ~~~ +1. Evaluate the worksheet. + - In IntelliJ, click on the green arrow at the top of the editor to evaluate the worksheet. + - In VS Code, save the file. + + You should see the result of the evaluation of every line on the right panel (IntelliJ), or + as comments (VS Code). + +![]({{ site.baseurl }}/resources/images/scala3-book/intellij-worksheet.png) + +A worksheet evaluated in IntelliJ. + +![]({{ site.baseurl }}/resources/images/scala3-book/metals-worksheet.png) + +A worksheet evaluated in VS Code (with the Metals extension). + +Note that the worksheet will use the Scala version defined by your project (set by the key `scalaVersion`, +in your file `build.sbt`, typically). + +Also note that worksheets don’t have a [program entry point]. Instead, top-level statements and expressions +are evaluated from top to bottom. + +[REPL session]: {% link _overviews/scala3-book/taste-repl.md %} +[program entry point]: {% link _overviews/scala3-book/methods-main-methods.md %} diff --git a/resources/images/scala3-book/intellij-worksheet.png b/resources/images/scala3-book/intellij-worksheet.png new file mode 100644 index 0000000000000000000000000000000000000000..e33fd3566e8c43b3e32aeb06a951f69f57bdd03b GIT binary patch literal 12899 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 literal 0 HcmV?d00001 From 8c1ff35b174b2446b9be5e9739c1d79164b07779 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 5 Jul 2021 16:27:14 +0200 Subject: [PATCH 1549/3075] Create docs.scala-lang.org/scala3/guides/reference and move language-versions here Content was taken from commit 270bd8b0f5af338be73790082d774516a83a73b5 --- _config.yml | 11 +++++- .../scala3-reference/language-versions.md | 36 +++++++++++++++++++ _overviews/scala3-reference/overview.md | 7 ++++ scala3/guides.md | 4 +++ 4 files changed, 57 insertions(+), 1 deletion(-) create mode 100644 _overviews/scala3-reference/language-versions.md create mode 100644 _overviews/scala3-reference/overview.md diff --git a/_config.yml b/_config.yml index ea13ad3eae..395bed4a34 100644 --- a/_config.yml +++ b/_config.yml @@ -123,6 +123,15 @@ defaults: overview-name: "Macros in Scala 3" layout: multipage-overview permalink: "/scala3/guides/macros/:title.html" + - + scope: + path: "_overviews/scala3-reference" + values: + scala3: true + partof: scala3-reference + overview-name: "Scala 3 Language Reference" + layout: multipage-overview + permalink: "/scala3/guides/reference/:title.html" - scope: path: "scala3" @@ -133,7 +142,7 @@ defaults: highlighter: rouge permalink: /:categories/:title.html:output_ext baseurl: -scala3ref: "https://dotty.epfl.ch/docs/reference" +scala3ref: "/scala3/guides/reference" exclude: ["vendor"] plugins: - jekyll-redirect-from diff --git a/_overviews/scala3-reference/language-versions.md b/_overviews/scala3-reference/language-versions.md new file mode 100644 index 0000000000..01a8ab1c32 --- /dev/null +++ b/_overviews/scala3-reference/language-versions.md @@ -0,0 +1,36 @@ +--- +title: Language Versions +type: chapter +description: This page lists the different flavours of language supported by the Scala 3 compiler. +num: 2 +previous-page: overview +--- + +The default Scala language version currently supported by the Dotty compiler is `3.0`. There are also other language versions that can be specified instead: + +- `3.0-migration`: Same as `3.0` but with a Scala 2 compatibility mode that helps moving Scala 2.13 sources over to Scala 3. In particular, it + + - flags some Scala 2 constructs that are disallowed in Scala 3 as migration warnings instead of hard errors, + - changes some rules to be more lenient and backwards compatible with Scala 2.13 + - gives some additional warnings where the semantics has changed between Scala 2.13 and 3.0 + - in conjunction with `-rewrite`, offer code rewrites from Scala 2.13 to 3.0. + +- `future`: A preview of changes introduced in the next versions after 3.0. In the doc pages here we refer to the language version with these changes as `3.1`, but it might be that some of these changes will be rolled out in later `3.x` versions. + +Some Scala-2 specific idioms will be dropped in this version. The feature set supported by this version will be refined over time as we approach its release. + +- `future-migration`: Same as `future` but with additional helpers to migrate from `3.0`. Similarly to the helpers available under `3.0-migration`, these include migration warnings and optional rewrites. + +There are two ways to specify a language version. + +- With a `-source` command line setting, e.g. `-source 3.0-migration`. +- With a `scala.language` import at the top of a source file, e.g: + +```scala +package p +import scala.language.`future-migration` + +class C { ... } +``` + +Language imports supersede command-line settings in the source files where they are specified. Only one language import specifying a source version is allowed in a source file, and it must come before any definitions in that file. diff --git a/_overviews/scala3-reference/overview.md b/_overviews/scala3-reference/overview.md new file mode 100644 index 0000000000..aa34ec188f --- /dev/null +++ b/_overviews/scala3-reference/overview.md @@ -0,0 +1,7 @@ +--- +title: Overview +type: chapter +description: This page begins the reference documentation. +num: 1 +next-page: language-versions +--- diff --git a/scala3/guides.md b/scala3/guides.md index 45587d280f..e6ddb733db 100644 --- a/scala3/guides.md +++ b/scala3/guides.md @@ -18,6 +18,10 @@ guides: icon: birthday-cake url: "/scala3/guides/tasty-overview.html" description: "An overview over the TASTy format aimed at end-users of the Scala language." + - title: Scala 3 Language Reference + icon: book + url: "/scala3/guides/reference/overview.html" + description: "The reference for Scala 3" --- \ No newline at end of file + diff --git a/_layouts/frontpage.html b/_layouts/frontpage.html index 743e27bd83..29fa5825fe 100644 --- a/_layouts/frontpage.html +++ b/_layouts/frontpage.html @@ -299,24 +299,24 @@

    {{forum.title}}

    {% endfor %} -
    -

    Real-time (topic-specialized) chat

    - {% assign modLimit = site.data.chats-forums.gitterChannels.size | modulo: 2 %} +
    +

    Real-time chat

    + {% assign modLimit = site.data.chats-forums.discordServers.size | modulo: 2 %} {% capture channelLimit %} {% if modLimit != 0 %} - {{site.data.chats-forums.gitterChannels.size | minus: 1}} + {{site.data.chats-forums.discordServers.size | minus: 1}} {% else %} - {{site.data.chats-forums.gitterChannels.size}} + {{site.data.chats-forums.discordServers.size}} {% endif %} {% endcapture %} - {% for channel in site.data.chats-forums.gitterChannels limit: channelLimit %} + {% for server in site.data.chats-forums.discordServers limit: channelLimit %} {% if forloop.first %}
    From 2dd2d506445008554d88614618b9faf28b16a355 Mon Sep 17 00:00:00 2001 From: Horimoto Yasuhiro Date: Wed, 9 Feb 2022 23:19:53 +0900 Subject: [PATCH 1778/3075] Add a missing translation in getting-started.md (Japanese) --- _includes/_ja/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_includes/_ja/getting-started.md b/_includes/_ja/getting-started.md index 97ebcbd692..f70eba4848 100644 --- a/_includes/_ja/getting-started.md +++ b/_includes/_ja/getting-started.md @@ -150,7 +150,7 @@ Scala について日本語で質問したい場合、Twitterでつぶやくと
    From 1dd5138701fd92d82ebe284f49e566c39e1e68db Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 10 Feb 2022 16:57:43 +0100 Subject: [PATCH 1779/3075] Update the Getting Started page(s) for the latest `cs` behavior. The default installation of coursier now installs Scala 3 by default under `scala` and `scalac`. However, it also allows to override that with `cs launch scala:2.13.8` or `cs install scala:2.13.8`, as Scala 2 and Scala 3 have been unified. --- _includes/getting-started.md | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/_includes/getting-started.md b/_includes/getting-started.md index dcbf448b0f..628f2a41c5 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -34,20 +34,24 @@ Along with managing JVMs, `cs setup` also installs useful command-line tools: - The [sbt](https://www.scala-sbt.org/) build tool - [Ammonite](https://ammonite.io/), an enhanced REPL - [scalafmt](https://scalameta.org/scalafmt/), the Scala code formatter -- `scalac` (the Scala 2 compiler) -- `scala` (the Scala 2 REPL and script runner). +- `scalac` (the Scala compiler) +- `scala` (the Scala REPL and script runner). For more information about `cs`, read [coursier-cli documentation](https://get-coursier.io/docs/cli-overview). -> Currently, `cs setup` installs the Scala 2 compiler and runner (the `scalac` and -> `scala` commands, respectively). This is usually not an issue because most projects -> use a build tool that works with both Scala 2 and Scala 3. -> Nevertheless, you can install the Scala 3 compiler and runner as command-line tools -> by running the following additional commands: +> `cs setup` installs the Scala 3 compiler and runner by default (the `scalac` and +> `scala` commands, respectively). Whether you intend to use Scala 2 or 3, +> this is usually not an issue because most projects use a build tool that will +> use the correct version of Scala irrespective of the one installed "globally". +> Nevertheless, you can always launch a specific version of Scala using > ``` -> $ cs install scala3-compiler -> $ cs install scala3 +> $ cs launch scala:{{ site.scala-version }} +> $ cs launch scalac:{{ site.scala-version }} +> ``` +> If you prefer Scala 2 to be run by default, you can force that version to be installed with: +> ``` +> $ cs install scala:{{ site.scala-version }} scalac:{{ site.scala-version }} > ``` ### ...or manually @@ -164,7 +168,7 @@ There are a multitude of mailing lists and real-time chat rooms in case you want + --> From 30f11ac17dbe37d7edc46bd64450dd030207b07d Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Thu, 10 Feb 2022 20:02:07 -0800 Subject: [PATCH 1780/3075] Mention library version quirk --- _overviews/FAQ/index.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index d20c5d7a4b..fe4b457451 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -105,9 +105,22 @@ get poor results, try surrounding the symbol with double quotes. sbt 1.x always uses Scala 2.12 to compile build definitions. Your sbt 1.x build definition is always a Scala 2.12 program. -Regardless, in your `build.sbt` you can set `scalaVersion` to anything -you want and your actual program code will be compiled with that -version. +Regardless, in your `build.sbt`, you can set `scalaVersion` to whichever +available distribution you want and your program code will be compiled with that version. + +### I want Scala 3.1.1 (etc); why does std lib say it's using Scala 2.13? + +Scala 3 currently uses the Scala 2.13 library by leveraging its seamless +interoperability. Note that it does not necessarily ingest the latest +version of the Scala 2.13 library. + +``` +Welcome to Scala 3.1.1 (17.0.2, Java OpenJDK 64-Bit Server VM). +Type in expressions for evaluation. Or try :help. + +scala> util.Properties.versionString +val res0: String = version 2.13.6 +``` ### Why is my (abstract or overridden) `val` null? From dcc51592443ca85e535c71068137865daf1ef17e Mon Sep 17 00:00:00 2001 From: czasoprzestrzenny <46657059+czasoprzestrzenny@users.noreply.github.com> Date: Fri, 11 Feb 2022 15:41:48 +0100 Subject: [PATCH 1781/3075] Update generic-classes.md changed a stack pop to stack.pop() --- _tour/generic-classes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_tour/generic-classes.md b/_tour/generic-classes.md index 0b479d30df..d883e88115 100644 --- a/_tour/generic-classes.md +++ b/_tour/generic-classes.md @@ -38,8 +38,8 @@ To use a generic class, put the type in the square brackets in place of `A`. val stack = new Stack[Int] stack.push(1) stack.push(2) -println(stack.pop) // prints 2 -println(stack.pop) // prints 1 +println(stack.pop()) // prints 2 +println(stack.pop()) // prints 1 ``` The instance `stack` can only take Ints. However, if the type argument had subtypes, those could be passed in: ``` From 15ba133475ab1f48392e0b82f1356d93899f2178 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Tue, 15 Feb 2022 10:37:40 +0100 Subject: [PATCH 1782/3075] update install instructions for coursier Use the same instructions as listed on the official Coursier website, as git.io short url service is no longer maintained. --- _includes/_ja/getting-started.md | 8 ++++---- _includes/getting-started.md | 6 +++--- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/_includes/_ja/getting-started.md b/_includes/_ja/getting-started.md index 0fe5652204..40bcf9ff29 100644 --- a/_includes/_ja/getting-started.md +++ b/_includes/_ja/getting-started.md @@ -14,7 +14,7 @@ Scala をインストールすると、コンパイラやビルドツールな ### Scala インストーラーを使う（推奨） -Scala のインストーラーは[Coursier](https://get-coursier.io/docs/cli-overview)というツールで、コマンドは`cs`です。このツールを使うと、JVM と標準 Scala ツールがシステムにインストールされます。 +Scala のインストーラーは[Coursier](https://get-coursier.io/docs/cli-overview)というツールで、コマンドは`cs`です。このツールを使うと、JVM と標準 Scala ツールがシステムにインストールされます。 以下の手順でお使いのシステムにインストールしてください。
    @@ -146,7 +146,7 @@ Scala について日本語で質問したい場合、Twitterでつぶやくと -- This is handled in `resources/js/functions.js`. -->

    または、Homebrewを使用しない場合は

    - $ curl -fLo cs https://git.io/coursier-cli-macos && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup
    + $ curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup
    diff --git a/_includes/getting-started.md b/_includes/getting-started.md index 628f2a41c5..83c1de45fe 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -170,7 +170,7 @@ There are a multitude of mailing lists and real-time chat rooms in case you want -- This is handled in `resources/js/functions.js`. -->

    Alternatively, if you don't use Homebrew

    - $ curl -fLo cs https://git.io/coursier-cli-macos && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup
    + $ curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup
    From b3e7f156841a4b3b7ec3f36d739f01d3c65874b1 Mon Sep 17 00:00:00 2001 From: Bersier Date: Wed, 16 Feb 2022 16:06:11 -0500 Subject: [PATCH 1783/3075] Update staging.md Added a link for "PCP". --- _scala3-reference/metaprogramming/staging.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_scala3-reference/metaprogramming/staging.md b/_scala3-reference/metaprogramming/staging.md index 0e90966c85..bb35f51055 100644 --- a/_scala3-reference/metaprogramming/staging.md +++ b/_scala3-reference/metaprogramming/staging.md @@ -62,7 +62,7 @@ impose the following restrictions on the use of splices. The framework as discussed so far allows code to be staged, i.e. be prepared to be executed at a later stage. To run that code, there is another method in class `Expr` called `run`. Note that `$` and `run` both map from `Expr[T]` -to `T` but only `$` is subject to the PCP, whereas `run` is just a normal method. +to `T` but only `$` is subject to the [PCP](./macros.html#the-phase-consistency-principle), whereas `run` is just a normal method. `scala.quoted.staging.run` provides a `Quotes` that can be used to show the expression in its scope. On the other hand `scala.quoted.staging.withQuotes` provides a `Quotes` without evaluating the expression. From 99b84bc5a89a1e76535abbea3199d1bb8ee31020 Mon Sep 17 00:00:00 2001 From: Ye Shu Date: Sun, 20 Feb 2022 18:58:55 -0500 Subject: [PATCH 1784/3075] Fix deprecated warning in scala for java programer ``` warning: method + in class Int is deprecated (since 2.13.0): Adding a number and a String is deprecated. Use the string interpolation `s"$num$str"` override def toString(): String = year + "-" + month + "-" + day ``` --- _it/tutorials/scala-for-java-programmers.md | 2 +- _ja/tutorials/scala-for-java-programmers.md | 2 +- _ko/tutorials/scala-for-java-programmers.md | 2 +- _overviews/tutorials/scala-for-java-programmers.md | 2 +- _zh-cn/tutorials/scala-for-java-programmers.md | 2 +- _zh-tw/tutorials/scala-for-java-programmers.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_it/tutorials/scala-for-java-programmers.md b/_it/tutorials/scala-for-java-programmers.md index 5cf8cb4b1c..7a60a2d6c6 100644 --- a/_it/tutorials/scala-for-java-programmers.md +++ b/_it/tutorials/scala-for-java-programmers.md @@ -578,7 +578,7 @@ definendo la classe `Date` come segue: def year = y def month = m def day = d - override def toString(): String = year + "-" + month + "-" + day + override def toString(): String = s"$year-$month-$day" La parte importante qui è la dichiarazione `extends Ord` che segue il nome della classe e dei parametri. Dichiara che la classe `Date` eredita il diff --git a/_ja/tutorials/scala-for-java-programmers.md b/_ja/tutorials/scala-for-java-programmers.md index 8d6fb7aef3..b49113ff72 100644 --- a/_ja/tutorials/scala-for-java-programmers.md +++ b/_ja/tutorials/scala-for-java-programmers.md @@ -461,7 +461,7 @@ Java の `Object` 型のより一般的なものとしてとらえられます def year = y def month = m def day = d - override def toString(): String = year + "-" + month + "-" + day + override def toString(): String = s"$year-$month-$day" ここで重要なのは、クラス名とパラメータのあとに続く `extends Ord` という宣言です。 `Date` クラスが `Ord` トレイトを継承していることを宣言しています。 diff --git a/_ko/tutorials/scala-for-java-programmers.md b/_ko/tutorials/scala-for-java-programmers.md index 4f26dee244..b3f3d1b6d3 100644 --- a/_ko/tutorials/scala-for-java-programmers.md +++ b/_ko/tutorials/scala-for-java-programmers.md @@ -547,7 +547,7 @@ Java 프로그래머들이 트레잇을 이해하는 가장 쉬운 길은 코드 def year = y def month = m def day = d - override def toString(): String = year + "-" + month + "-" + day + override def toString(): String = s"$year-$month-$day" 여기서 중요한 부분은 클래스 이름과 파라미터 뒤에 따라오는 `extends Ord` 선언이다. 이 선언은 `Date` 클래스가 `Ord` diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index 52c988066e..ebac87fce3 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -595,7 +595,7 @@ represent as integers. We therefore start the definition of the def year = y def month = m def day = d - override def toString(): String = year + "-" + month + "-" + day + override def toString(): String = s"$year-$month-$day" The important part here is the `extends Ord` declaration which follows the class name and parameters. It declares that the diff --git a/_zh-cn/tutorials/scala-for-java-programmers.md b/_zh-cn/tutorials/scala-for-java-programmers.md index 9ee8838b4d..00559b596d 100644 --- a/_zh-cn/tutorials/scala-for-java-programmers.md +++ b/_zh-cn/tutorials/scala-for-java-programmers.md @@ -308,7 +308,7 @@ Java 中我们会将这个树用一个抽象父类表示，然后每种节点跟 def year = y def month = m def day = d - override def toString(): String = year + "-" + month + "-" + day + override def toString(): String = s"$year-$month-$day" 这边要注意的是声明在类名称跟参数之后的 `extends Ord`。这个语法声明了 `Date` 继承 `Ord` 特质。 diff --git a/_zh-tw/tutorials/scala-for-java-programmers.md b/_zh-tw/tutorials/scala-for-java-programmers.md index 290ee22ac3..d9b4bcd4d0 100755 --- a/_zh-tw/tutorials/scala-for-java-programmers.md +++ b/_zh-tw/tutorials/scala-for-java-programmers.md @@ -308,7 +308,7 @@ Java 中我們會將這個樹用一個抽象母類別表示，然後每種節點 def year = y def month = m def day = d - override def toString(): String = year + "-" + month + "-" + day + override def toString(): String = s"$year-$month-$day" 這邊要注意的是宣告在類別名稱跟參數之後的 `extends Ord`。這個語法宣告了 `Date` 繼承 `Ord` 特質。 From cf096aebaaceb121695d1aea973c5216c97d8437 Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Wed, 23 Feb 2022 20:24:54 -0800 Subject: [PATCH 1785/3075] Add lightbend blog post --- _overviews/compiler-options/optimizer.md | 221 +++++++++++++++++++++++ 1 file changed, 221 insertions(+) create mode 100644 _overviews/compiler-options/optimizer.md diff --git a/_overviews/compiler-options/optimizer.md b/_overviews/compiler-options/optimizer.md new file mode 100644 index 0000000000..a5cf6fbb29 --- /dev/null +++ b/_overviews/compiler-options/optimizer.md @@ -0,0 +1,221 @@ +# The Scala 2.12 / 2.13 Inliner and Optimizer + +_by [Lukas Rytz](https://github.com/lrytz), November 7, 2018_ + +tl;dr: + +- Don't enable the optimizer during development: it breaks incremental compilation, and it makes the compiler slower. Only enable it for testing, on CI, and to build releases. +- Enable method-local optimizations with `-opt:l:method`. This option is safe for binary compatibility, but typically doesn't improve performance on its own. +- Enable inlining in addition to method-local optimizations with `-opt:l:inline` and `-opt-inline-from:[PATTERN]` + - Don't inline from your dependencies when publishing a library, it breaks binary compatibility. Use `-opt-inline-from:my.package.**` to only inline from packages within your library. + - When compiling an application with global inlining (`-opt-inline-from:**`), ensure that the run-time classpath is exactly the same as the compile-time classpath. +- The `@inline` annotation only has an effect if the inliner is enabled. It tells the inliner to always try to inline the annotated method or callsite. +- Without the `@inline` annotation, the inliner generally inlines higher-order methods and forwarder methods. The main goal is to eliminate megamorphic callsites due to functions passed as argument, and to eliminate value boxing. Other optimizations are delegated to the JVM. + +To learn more, read on. + +## Intro + +The Scala compiler has included an inliner since version 2.0. Closure elimination and dead code elimination were added in 2.1. That was the first Scala optimizer, written and maintained by [Iulian Dragos](https://github.com/dragos). He continued to improve these features over time and consolidated them under the `-optimise` flag (later Americanized to `-optimize`), which remained available through Scala 2.11. + +The optimizer was re-written for Scala 2.12 to become more reliable and powerful – and to side-step the spelling issue by calling the new flag `-opt`. This post describes how to use the optimizer in Scala 2.12 and 2.13: what it does, how it works, and what are its limitations. + +## Motivation + +Why does the Scala compiler even have a JVM bytecode optimizer? The JVM is a highly optimized runtime with a just-in-time (JIT) compiler with 19 years of tuning. It's because there are certain well-known code patterns that the JVM fails to optimize properly. These patterns are common in functional languages such as Scala. (Increasingly, Java code with lambdas is catching up and showing the same performance issues at run-time.) + +The two most important such patterns are "megamorphic dispatch" (also called "the inlining problem") and value boxing. If you'd like to learn more about these problems in the context of Scala, you could watch the part of [my Scala Days 2015 talk (starting at 26:13)](https://youtu.be/Ic4vQJcYwsU?t=1573). + +The goal of the Scala optimizer is to produce bytecode that the JVM can execute fast. It is also a goal to avoid performing any optimizations that the JVM can already do well. + +This means that the Scala optimizer may become obsolete in the future, if the JIT compiler is improved to handle these patterns better. In fact, with the arrival of GraalVM, that future might be nearer than you think! We take a closer look at Graal in a follow-up post. But for now, we dive into some details about the Scala optimizer. + +## Constraints and assumptions + +The Scala optimizer has to make its improvements within fairly narrow constraints: + +- The optimizer only changes method bodies, but never signatures of classes or methods. The generated bytecode has the same (binary) interface, whether or not the optimizer is enabled. +- We don't assume the whole program (all user code plus all of its dependencies, that together make up an application) is known when running the optimizer. There may be classes on the run-time classpath that we don't see at compile-time: we may be compiling a library, or only a component of an application. This means that: + - Every non-final method can potentially be overridden, even if at compile-time there are no classes that define such an override + - Consequently, we can only inline methods that can be resolved at compile-time: final methods, methods in `object`s, and methods where the receiver's type is precisely known (for example, in `(new A).f`, the receiver is known to be exactly `A`, not a subtype of `A`). +- The optimizer does not break applications that use reflection. This follows from the two points above: changes to classes could be observed by reflection, and additional classes could be loaded and instantiated dynamically. + +However, even when staying within these constraints, some changes performed by the optimizer can be observed at run-time: + +- Inlined methods disappear from call stacks. + + - This can lead to unexpected behaviors when using a debugger. + - Related: line numbers (stored in bytecode) are discarded when a method is inlined into a different classfile, which also impacts debugging experience. (This [could be improved](https://github.com/scala/scala-dev/issues/3).) + +- Inlining a method can delay class loading of the class where the method is defined. + +- The optimizer assumes that modules (singletons like `object O`) are never `null`. + - This assumption can be false if the module is loaded in its superclass. The following example throws a `NullPointerException` when compiled normally, but prints `0` when compiled with the optimizer enabled: + + ```scala + class A { + println(Test.f) + } + object Test extends A { + @inline def f = 0 + def main(args: Array[String]): Unit = () + } + ``` + + - This assumption can be disabled with `-opt:-assume-modules-non-null`, which results in additional null checks in optimized code. + +- The optimizer removes unnecessary loads of certain built-in modules, for example `scala.Predef` and `scala.runtime.ScalaRunTime`. This means that initialization (construction) of these modules can be skipped or delayed. + + - For example, in `def f = 1 -> ""`, the method `Predef.->` is inlined and the access to `Predef` is eliminated. The resulting code is `def f = new Tuple2(1, "")`. + - This assumption can be disabled with `-opt:-allow-skip-core-module-init` + +- The optimizer eliminates unused `C.getClass` calls, which may delay class loading. This can be disabled with `-opt:-allow-skip-class-loading`. + +## Binary compatibility + +Scala minor releases are binary compatible with each other, for example 2.12.6 and 2.12.7. The same is true for many libraries in the Scala ecosystem. These binary compatibility promises are the main reason for the Scala optimizer not to be enabled everywhere. + +The reason is that inlining a method from one class into another changes the (binary) interface that is accessed: + +```scala +class C { + private[this] var x = 0 + @inline final def inc(): Int = { x += 1; x } +} +``` + +When inlining a callsite `c.inc()`, the resulting code no longer calls `inc`, but instead accesses the field `x` directly. Since that field is private (also in bytecode), inlining `inc` is only allowed within the class `C` itself. Trying to access `x` from any other class would cause an `IllegalAccessError` at run-time. + +However, there are many cases where implementation details in Scala source code become public in bytecode: + +```scala +class C { + private def x = 0 + @inline final def m: Int = x +} +object C { + def t(c: C) = c.x +} +``` + +Scala allows accessing the private method `x` in the companion object `C`. In bytecode, however, the classfile for the companion `C$` is not allowed to access a private method of `C`. For that reason, the Scala compiler "mangles" the name of `x` to `C$$x` and makes the method public. + +This means that `m` can be inlined into classes other than `C`, since the resulting code invokes `C.C$$x` instead of `C.m`. Unfortunately this breaks Scala's binary compatibility promise: the fact that the public method `m` calls a private method `x` is considered to be an implementation detail that can change in a minor release of the library defining `C`. + +Even more trivially, assume that method `m` was buggy and is changed to `def m = if (fullMoon) 1 else x` in a minor release. Normally, it would be enough for a user to put the new version on the classpath. However, if the old version of `c.m` was inlined at compile-time, having the new version of C on the run-time classpath would not fix the bug. + +In order to safely use the Scala optimizer, users need to make sure that the compile-time and run-time classpaths are identical. This has a far-reaching consequence for library developers: **libraries that are published to be consumed by other projects should not inline code from the classpath**. The inliner can be configured to inline code from the library itself using `-opt-inline-from:my.package.**`. + +The reason for this restriction is that dependency management tools like sbt will often pick newer versions of transitive dependencies. For example, if library `A` depends on `core-1.1.1`, `B` depends on `core-1.1.2` and the application depends on both `A` and `B`, the build tool will put `core-1.1.2` on the classpath. If code from `core-1.1.1` was inlined into `A` at compile-time, it might break at run-time due to a binary incompatibility. + +## Using and interacting with the optimizer + +The compiler flag for enabling the optimizer is `-opt`. Running `scalac -opt:help` shows how to use the flag. + +By default (without any compiler flags, or with `-opt:l:default`), the Scala compiler eliminates unreachable code, but does not run any other optimizations. + +`-opt:l:method` enables all method-local optimizations, for example: + +- Elimination of code that loads unused values +- Rewriting of null and `isInstanceOf` checks whose result is known at compile-time +- Elimination of value boxes like `java.lang.Integer` or `scala.runtime.DoubleRef` that are created within a method and don't escape it + +Individual optimizations can be disabled. For example, `-opt:l:method,-nullness-tracking` disables nullness optimizations. + +Method-local optimizations alone typically don't have any positive effect on performance, because source code usually doesn't have unnecessary boxing or null checks. However, local optimizations can often be applied after inlining, so it's really the combination of inlining and local optimizations that can improve program performance. + +`-opt:l:inline` enables inlining in addition to method-local optimizations. However, to avoid unexpected binary compatibility issues, we also need to tell the compiler which code it is allowed to inline. This is done with the `-opt-inline-from` compiler flag. Examples: + +- `-opt-inline-from:my.library.**` enables inlining from any class defined in package `my.library`, or in any of its sub-packages. Inlining within a library is safe for binary compatibility, so the resulting binary can be published. It will still work correctly even if one of its dependencies is updated to a newer minor version in the run-time classpath. +- `-opt-inline-from:` enables inlining from the set of source files being compiled in the current compiler invocation. This option can also be used for compiling libraries. If the source files of a library are split up across multiple sbt projects, inlining is only done within each project. Note that in an incremental compilation, inlining would only happen within the sources being re-compiled – but in any case, it is recommended to only enable the optimizer in CI and release builds (and to run `clean` before building). +- `-opt-inline-from:**` allows inlining from every class, including the JDK. This option enables full optimization when compiling an application. To avoid binary incompatibilities, it is mandatory to ensure that the run-time classpath is identical to the compile-time classpath, including the Java standard library. + +Running `scalac -opt-inline-from:help` explains how to use the compiler flag. + +### Inliner heuristics and `@inline` + +When the inliner is enabled, it automatically selects callsites for inlining according to a heuristic. + +As mentioned in the introduction, the main goal of the Scala optimizer is to eliminate megamorphic dispatch and value boxing. In order to keep this post from growing too long, a followup post will include the analysis of concrete examples that motivate which callsites are selected by the inliner heuristic. + +Nevertheless, it is useful to have an intuition of how the heuristic works, so here is an overview: + +- Methods or callsites annotated [`@noinline`](https://www.scala-lang.org/api/current/scala/noinline.html) are not inlined. +- The inliner doesn't inline *into* forwarder methods. +- Methods or callsites annotated [`@inline`](https://www.scala-lang.org/api/current/scala/inline.html) are inlined. +- Higher-order methods with a function literal as argument are inlined. +- Higher-order methods where a parameter function of the callsite method is forwarded to the callee are inlined. +- Methods with an `IntRef` / `DoubleRef` / ... parameter are inlined. When nested methods update variables of the outer method, those variables are boxed into `XRef` objects. These boxes can often be eliminated after inlining the nested method. +- Forwarders, factory methods and trivial methods are inlined. Examples include simple closure bodies like `_ + 1` and synthetic methods (potentially with boxing / unboxing adaptations) such as bridges. + +To prevent methods from exceeding the JVM's method size limit, the inliner has size limits. Inlining into a method stops when the number of instructions exceeds a certain threshold. + +As you can see in the list above, the `@inline` and `@noinline` annotations are the only way for programmers to influence inlining decisions. In general, our recommendation is to avoid using these annotations. If you observe issues with the inliner heuristic that can be fixed by annotating methods, we are very keen to hear about them, for example in the form of a [bug report](https://github.com/scala/bug/issues). + +A related anecdote: in the Scala compiler and standard library (which are built with the optimizer enabled), there are roughly 330 `@inline`-annotated methods. Removing all of these annotations and re-building the project has no effect on the compiler's performance. So the annotations are well-intended and benign, but in reality unnecessary. + +For expert users, `@inline` annotations can be used to hand-tune performance critical code without reducing abstraction. If you have a project that falls into this category, please [let us know](https://contributors.scala-lang.org), we're interested to learn more! + +Finally, note that the `@inline` annotation only has an effect when the inliner is enabled, which is not the case by default. The reason is to avoid introducing accidental binary incompatibilities, as [explained above](#binary-compatibility). + +### Inliner warnings + +The inliner can issue warnings when callsites cannot be inlined. By default, these warnings are not issued individually, but only as a summary at the end of compilation (similar to deprecation warnings). + +``` +$> scalac Test.scala -opt:l:inline '-opt-inline-from:**' +warning: there was one inliner warning; re-run enabling -opt-warnings for details, or try -help +one warning found + +$> scalac Test.scala -opt:l:inline '-opt-inline-from:**' -opt-warnings +Test.scala:3: warning: C::f()I is annotated @inline but could not be inlined: +The method is not final and may be overridden. + def t = f + ^ +one warning found +``` + +By default, the inliner issues warnings for invocations of methods annotated `@inline` that cannot be inlined. Here is the source code that was compiled in the commands above: + +```scala +class C { + @inline def f = 1 + def t = f // cannot inline: C.f is not final +} +object T extends C { + override def t = f // can inline: T.f is final +} +``` + +The `-opt-warnings` flag has more configurations. With `-opt-warnings:_`, a warning is issued for every callsite that is selected by the heuristic but cannot be inlined. See also `-opt-warnings:help`. + +### Inliner log + +If you're curious (or maybe even skeptical) about what the inliner is doing to your code, you can use the `-Yopt-log-inline` flag to produce a trace of the inliner's work: + +```scala +package my.project +class C { + def f(a: Array[Int]) = a.map(_ + 1) +} +``` + +``` +$> scalac Test.scala -opt:l:inline '-opt-inline-from:**' -Yopt-log-inline my/project/C.f +Inlining into my/project/C.f + inlined scala/Predef$.intArrayOps (the callee is annotated `@inline`). Before: 15 ins, after: 30 ins. + inlined scala/collection/ArrayOps$.map$extension (the callee is a higher-order method, the argument for parameter (evidence$6: Function1) is a function literal). Before: 30 ins, after: 94 ins. + inlined scala/runtime/ScalaRunTime$.array_length (the callee is annotated `@inline`). Before: 94 ins, after: 110 ins. + [...] + rewrote invocations of closure allocated in my/project/C.f with body $anonfun$f$1: INVOKEINTERFACE scala/Function1.apply (Ljava/lang/Object;)Ljava/lang/Object; (itf) + inlined my/project/C.$anonfun$f$1 (the callee is a synthetic forwarder method). Before: 654 ins, after: 666 ins. + inlined scala/runtime/BoxesRunTime.boxToInteger (the callee is a forwarder method with boxing adaptation). Before: 666 ins, after: 674 ins. +``` + +Explaining the details here is out of scope for this post. We defer this discussion to a follow-up post that will explain the internals of the Scala optimizer in more detail. + +## Summary + +The goal of this article was to explain why the Scala optimizer exists and give a rough explanation what it can and cannot do. It also showed how to configure and use the optimizer in your project. + +In the next post, we will go into detail about how the optimizer works, what transformations are applied, and how they work together. We will also measure performance improvements that the optimizer can bring. Finally, we will look at related projects, dive a little more into the history of the optimizer, and discuss ideas for the future. From 13f8c85396d73527fdeab4372455424e1ed3a615 Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Wed, 23 Feb 2022 21:39:23 -0800 Subject: [PATCH 1786/3075] Update optimizer overview --- _data/overviews.yml | 5 ++ _overviews/compiler-options/optimizer.md | 68 ++++++++++++------------ 2 files changed, 40 insertions(+), 33 deletions(-) diff --git a/_data/overviews.yml b/_data/overviews.yml index cf89f286a7..ae56e9b5e9 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -259,6 +259,11 @@ icon: cog url: "compiler-options/errors.html" description: "A new engine for more user-friendly error messages, printing chains of dependent implicits and colored found/required type diffs." + - title: Optimizer + by: Lukas Rytz and Andrew Marki + icon: cog + url: "compiler-options/optimizer.html" + description: "The compiler can perform various optimizations as specified by compiler options." - category: Legacy diff --git a/_overviews/compiler-options/optimizer.md b/_overviews/compiler-options/optimizer.md index a5cf6fbb29..936967e8a0 100644 --- a/_overviews/compiler-options/optimizer.md +++ b/_overviews/compiler-options/optimizer.md @@ -1,18 +1,26 @@ -# The Scala 2.12 / 2.13 Inliner and Optimizer +--- +layout: singlepage-overview +title: Optimizer +--- + +**[Lukas Rytz](https://github.com/lrytz) (November 7, 2018)** -_by [Lukas Rytz](https://github.com/lrytz), November 7, 2018_ +**[Andrew Marki](https://github.com/som-snytt) (February 29, 2022)** -tl;dr: +# The Scala 2.12 / 2.13 Inliner and Optimizer +## In Brief + +- The Scala compiler has a compile-time optimizer that is available in versions 2.12 and 2.13, but not yet in Scala 3. - Don't enable the optimizer during development: it breaks incremental compilation, and it makes the compiler slower. Only enable it for testing, on CI, and to build releases. -- Enable method-local optimizations with `-opt:l:method`. This option is safe for binary compatibility, but typically doesn't improve performance on its own. -- Enable inlining in addition to method-local optimizations with `-opt:l:inline` and `-opt-inline-from:[PATTERN]` - - Don't inline from your dependencies when publishing a library, it breaks binary compatibility. Use `-opt-inline-from:my.package.**` to only inline from packages within your library. - - When compiling an application with global inlining (`-opt-inline-from:**`), ensure that the run-time classpath is exactly the same as the compile-time classpath. +- Enable method-local optimizations with `-opt:local`. This option is safe for binary compatibility, but typically doesn't improve performance on its own. +- Enable inlining in addition to method-local optimizations with `-opt:inline:[PATTERN]`. + - Don't inline from your dependencies when publishing a library, it breaks binary compatibility. Use `-opt:inline:my.package.**` to only inline from packages within your library. + - When compiling an application with global inlining (`-opt:inline:**`), ensure that the run-time classpath is **exactly the same** as the compile-time classpath. - The `@inline` annotation only has an effect if the inliner is enabled. It tells the inliner to always try to inline the annotated method or callsite. - Without the `@inline` annotation, the inliner generally inlines higher-order methods and forwarder methods. The main goal is to eliminate megamorphic callsites due to functions passed as argument, and to eliminate value boxing. Other optimizations are delegated to the JVM. -To learn more, read on. +Read more to learn more. ## Intro @@ -20,15 +28,17 @@ The Scala compiler has included an inliner since version 2.0. Closure eliminatio The optimizer was re-written for Scala 2.12 to become more reliable and powerful – and to side-step the spelling issue by calling the new flag `-opt`. This post describes how to use the optimizer in Scala 2.12 and 2.13: what it does, how it works, and what are its limitations. +The options were simplified for 2.13.9, as described here. The [earlier version](https://www.lightbend.com/blog/scala-inliner-optimizer) of this article uses the traditional forms, which are still supported. + ## Motivation -Why does the Scala compiler even have a JVM bytecode optimizer? The JVM is a highly optimized runtime with a just-in-time (JIT) compiler with 19 years of tuning. It's because there are certain well-known code patterns that the JVM fails to optimize properly. These patterns are common in functional languages such as Scala. (Increasingly, Java code with lambdas is catching up and showing the same performance issues at run-time.) +Why does the Scala compiler even have a JVM bytecode optimizer? The JVM is a highly optimized runtime with a just-in-time (JIT) compiler that benefits from over two decades of tuning. It's because there are certain well-known code patterns that the JVM fails to optimize properly. These patterns are common in functional languages such as Scala. (Increasingly, Java code with lambdas is catching up and showing the same performance issues at run-time.) The two most important such patterns are "megamorphic dispatch" (also called "the inlining problem") and value boxing. If you'd like to learn more about these problems in the context of Scala, you could watch the part of [my Scala Days 2015 talk (starting at 26:13)](https://youtu.be/Ic4vQJcYwsU?t=1573). The goal of the Scala optimizer is to produce bytecode that the JVM can execute fast. It is also a goal to avoid performing any optimizations that the JVM can already do well. -This means that the Scala optimizer may become obsolete in the future, if the JIT compiler is improved to handle these patterns better. In fact, with the arrival of GraalVM, that future might be nearer than you think! We take a closer look at Graal in a follow-up post. But for now, we dive into some details about the Scala optimizer. +This means that the Scala optimizer may become obsolete in the future, if the JIT compiler is improved to handle these patterns better. In fact, with the arrival of GraalVM, that future might be nearer than you think! But for now, we dive into some details about the Scala optimizer. ## Constraints and assumptions @@ -45,7 +55,7 @@ However, even when staying within these constraints, some changes performed by t - Inlined methods disappear from call stacks. - This can lead to unexpected behaviors when using a debugger. - - Related: line numbers (stored in bytecode) are discarded when a method is inlined into a different classfile, which also impacts debugging experience. (This [could be improved](https://github.com/scala/scala-dev/issues/3).) + - Related: line numbers (stored in bytecode) are discarded when a method is inlined into a different classfile, which also impacts debugging experience. (This [could be improved](https://github.com/scala/scala-dev/issues/3) and is expected to [progress](https://github.com/lampepfl/dotty/pull/11492).) - Inlining a method can delay class loading of the class where the method is defined. @@ -73,7 +83,7 @@ However, even when staying within these constraints, some changes performed by t ## Binary compatibility -Scala minor releases are binary compatible with each other, for example 2.12.6 and 2.12.7. The same is true for many libraries in the Scala ecosystem. These binary compatibility promises are the main reason for the Scala optimizer not to be enabled everywhere. +Scala minor releases are binary compatible with each other, for example, 2.12.6 and 2.12.7. The same is true for many libraries in the Scala ecosystem. These binary compatibility promises are the main reason for the Scala optimizer not to be enabled everywhere. The reason is that inlining a method from one class into another changes the (binary) interface that is accessed: @@ -112,25 +122,25 @@ The reason for this restriction is that dependency management tools like sbt wil The compiler flag for enabling the optimizer is `-opt`. Running `scalac -opt:help` shows how to use the flag. -By default (without any compiler flags, or with `-opt:l:default`), the Scala compiler eliminates unreachable code, but does not run any other optimizations. +By default (without any compiler flags, or with `-opt:default`), the Scala compiler eliminates unreachable code, but does not run any other optimizations. -`-opt:l:method` enables all method-local optimizations, for example: +`-opt:local` enables all method-local optimizations, for example: - Elimination of code that loads unused values - Rewriting of null and `isInstanceOf` checks whose result is known at compile-time - Elimination of value boxes like `java.lang.Integer` or `scala.runtime.DoubleRef` that are created within a method and don't escape it -Individual optimizations can be disabled. For example, `-opt:l:method,-nullness-tracking` disables nullness optimizations. +Individual optimizations can be disabled. For example, `-opt:local,-nullness-tracking` disables nullness optimizations. Method-local optimizations alone typically don't have any positive effect on performance, because source code usually doesn't have unnecessary boxing or null checks. However, local optimizations can often be applied after inlining, so it's really the combination of inlining and local optimizations that can improve program performance. -`-opt:l:inline` enables inlining in addition to method-local optimizations. However, to avoid unexpected binary compatibility issues, we also need to tell the compiler which code it is allowed to inline. This is done with the `-opt-inline-from` compiler flag. Examples: +`-opt:inline` enables inlining in addition to method-local optimizations. However, to avoid unexpected binary compatibility issues, we also need to tell the compiler which code it is allowed to inline. This is done by specifying a pattern after the option to select packages, classes, and methods for inlining. Examples: -- `-opt-inline-from:my.library.**` enables inlining from any class defined in package `my.library`, or in any of its sub-packages. Inlining within a library is safe for binary compatibility, so the resulting binary can be published. It will still work correctly even if one of its dependencies is updated to a newer minor version in the run-time classpath. -- `-opt-inline-from:` enables inlining from the set of source files being compiled in the current compiler invocation. This option can also be used for compiling libraries. If the source files of a library are split up across multiple sbt projects, inlining is only done within each project. Note that in an incremental compilation, inlining would only happen within the sources being re-compiled – but in any case, it is recommended to only enable the optimizer in CI and release builds (and to run `clean` before building). -- `-opt-inline-from:**` allows inlining from every class, including the JDK. This option enables full optimization when compiling an application. To avoid binary incompatibilities, it is mandatory to ensure that the run-time classpath is identical to the compile-time classpath, including the Java standard library. +- `-opt:inline:my.library.**` enables inlining from any class defined in package `my.library`, or in any of its sub-packages. Inlining within a library is safe for binary compatibility, so the resulting binary can be published. It will still work correctly even if one of its dependencies is updated to a newer minor version in the run-time classpath. +- `-opt-inline:`, where the pattern is the literal string ``, enables inlining from the set of source files being compiled in the current compiler invocation. This option can also be used for compiling libraries. If the source files of a library are split up across multiple sbt projects, inlining is only done within each project. Note that in an incremental compilation, inlining would only happen within the sources being re-compiled – but in any case, it is recommended to only enable the optimizer in CI and release builds (and to run `clean` before building). +- `-opt:inline:**` allows inlining from every class, including the JDK. This option enables full optimization when compiling an application. To avoid binary incompatibilities, it is mandatory to ensure that the run-time classpath is identical to the compile-time classpath, including the Java standard library. -Running `scalac -opt-inline-from:help` explains how to use the compiler flag. +Running `scalac -opt:help` explains how to use the compiler flag. ### Inliner heuristics and `@inline` @@ -163,11 +173,11 @@ Finally, note that the `@inline` annotation only has an effect when the inliner The inliner can issue warnings when callsites cannot be inlined. By default, these warnings are not issued individually, but only as a summary at the end of compilation (similar to deprecation warnings). ``` -$> scalac Test.scala -opt:l:inline '-opt-inline-from:**' +$> scalac Test.scala '-opt:inline:**' warning: there was one inliner warning; re-run enabling -opt-warnings for details, or try -help one warning found -$> scalac Test.scala -opt:l:inline '-opt-inline-from:**' -opt-warnings +$> scalac Test.scala '-opt:inline:**' -Wopt Test.scala:3: warning: C::f()I is annotated @inline but could not be inlined: The method is not final and may be overridden. def t = f @@ -187,11 +197,11 @@ object T extends C { } ``` -The `-opt-warnings` flag has more configurations. With `-opt-warnings:_`, a warning is issued for every callsite that is selected by the heuristic but cannot be inlined. See also `-opt-warnings:help`. +The `-Wopt` flag has more configurations. With `-Wopt:_`, a warning is issued for every callsite that is selected by the heuristic but cannot be inlined. See also `-Wopt:help`. ### Inliner log -If you're curious (or maybe even skeptical) about what the inliner is doing to your code, you can use the `-Yopt-log-inline` flag to produce a trace of the inliner's work: +If you're curious (or maybe even skeptical) about what the inliner is doing to your code, you can use the `-Vinline` verbose flag to produce a trace of the inliner's work: ```scala package my.project @@ -201,7 +211,7 @@ class C { ``` ``` -$> scalac Test.scala -opt:l:inline '-opt-inline-from:**' -Yopt-log-inline my/project/C.f +$> scalac Test.scala '-opt:inline:**' -Vinline my/project/C.f Inlining into my/project/C.f inlined scala/Predef$.intArrayOps (the callee is annotated `@inline`). Before: 15 ins, after: 30 ins. inlined scala/collection/ArrayOps$.map$extension (the callee is a higher-order method, the argument for parameter (evidence$6: Function1) is a function literal). Before: 30 ins, after: 94 ins. @@ -211,11 +221,3 @@ Inlining into my/project/C.f inlined my/project/C.$anonfun$f$1 (the callee is a synthetic forwarder method). Before: 654 ins, after: 666 ins. inlined scala/runtime/BoxesRunTime.boxToInteger (the callee is a forwarder method with boxing adaptation). Before: 666 ins, after: 674 ins. ``` - -Explaining the details here is out of scope for this post. We defer this discussion to a follow-up post that will explain the internals of the Scala optimizer in more detail. - -## Summary - -The goal of this article was to explain why the Scala optimizer exists and give a rough explanation what it can and cannot do. It also showed how to configure and use the optimizer in your project. - -In the next post, we will go into detail about how the optimizer works, what transformations are applied, and how they work together. We will also measure performance improvements that the optimizer can bring. Finally, we will look at related projects, dive a little more into the history of the optimizer, and discuss ideas for the future. From 3925a6475dfe3ff6ef0d25c319663d1117df31a9 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 26 Feb 2022 02:56:40 +0000 Subject: [PATCH 1787/3075] Bump nokogiri from 1.12.5 to 1.13.3 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.12.5 to 1.13.3. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.12.5...v1.13.3) --- updated-dependencies: - dependency-name: nokogiri dependency-type: indirect ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 0bbe4414f9..5b52d7697a 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -54,9 +54,9 @@ GEM rb-fsevent (~> 0.10, >= 0.10.3) rb-inotify (~> 0.9, >= 0.9.10) mercenary (0.3.6) - mini_portile2 (2.6.1) - nokogiri (1.12.5) - mini_portile2 (~> 2.6.1) + mini_portile2 (2.8.0) + nokogiri (1.13.3) + mini_portile2 (~> 2.8.0) racc (~> 1.4) nokogumbo (2.0.2) nokogiri (~> 1.8, >= 1.8.4) @@ -64,7 +64,7 @@ GEM pathutil (0.16.2) forwardable-extended (~> 2.6) public_suffix (4.0.6) - racc (1.5.2) + racc (1.6.0) rainbow (3.0.0) rb-fsevent (0.11.0) rb-inotify (0.10.1) From 582e6c017de371609f54545b0e340fe4287cc22f Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 2 Mar 2022 07:06:41 -0800 Subject: [PATCH 1788/3075] Ruby 2.6 (was 2.5) --- .github/workflows/build.yml | 2 +- Dockerfile | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index f9cca5b785..808f492a7d 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -8,7 +8,7 @@ jobs: - name: Set up Ruby uses: ruby/setup-ruby@v1 with: - ruby-version: 2.5.8 + ruby-version: 2.6.9 bundler-cache: true - name: Set up coursier uses: coursier/setup-action@v1.2.0-M2 diff --git a/Dockerfile b/Dockerfile index b972fe1c24..2fe3d70737 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,4 +1,4 @@ -FROM ruby:2.5 +FROM ruby:2.6 RUN gem install bundler jekyll From b33f3a7d286db7aa3d3eb481b1997b5d1ce7388b Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Thu, 3 Mar 2022 02:46:11 -0800 Subject: [PATCH 1789/3075] Review and corrections --- _data/overviews.yml | 2 +- _overviews/compiler-options/optimizer.md | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_data/overviews.yml b/_data/overviews.yml index ae56e9b5e9..a8bc055f7c 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -263,7 +263,7 @@ by: Lukas Rytz and Andrew Marki icon: cog url: "compiler-options/optimizer.html" - description: "The compiler can perform various optimizations as specified by compiler options." + description: "The compiler can perform various optimizations." - category: Legacy diff --git a/_overviews/compiler-options/optimizer.md b/_overviews/compiler-options/optimizer.md index 936967e8a0..cad7255280 100644 --- a/_overviews/compiler-options/optimizer.md +++ b/_overviews/compiler-options/optimizer.md @@ -3,9 +3,9 @@ layout: singlepage-overview title: Optimizer --- -**[Lukas Rytz](https://github.com/lrytz) (November 7, 2018)** +**[Lukas Rytz](https://github.com/lrytz) (2018)** -**[Andrew Marki](https://github.com/som-snytt) (February 29, 2022)** +**[Andrew Marki](https://github.com/som-snytt) (2022)** # The Scala 2.12 / 2.13 Inliner and Optimizer @@ -114,7 +114,7 @@ This means that `m` can be inlined into classes other than `C`, since the result Even more trivially, assume that method `m` was buggy and is changed to `def m = if (fullMoon) 1 else x` in a minor release. Normally, it would be enough for a user to put the new version on the classpath. However, if the old version of `c.m` was inlined at compile-time, having the new version of C on the run-time classpath would not fix the bug. -In order to safely use the Scala optimizer, users need to make sure that the compile-time and run-time classpaths are identical. This has a far-reaching consequence for library developers: **libraries that are published to be consumed by other projects should not inline code from the classpath**. The inliner can be configured to inline code from the library itself using `-opt-inline-from:my.package.**`. +In order to safely use the Scala optimizer, users need to make sure that the compile-time and run-time classpaths are identical. This has a far-reaching consequence for library developers: **libraries that are published to be consumed by other projects should not inline code from the classpath**. The inliner can be configured to inline code from the library itself using `-opt:inline:my.package.**`. The reason for this restriction is that dependency management tools like sbt will often pick newer versions of transitive dependencies. For example, if library `A` depends on `core-1.1.1`, `B` depends on `core-1.1.2` and the application depends on both `A` and `B`, the build tool will put `core-1.1.2` on the classpath. If code from `core-1.1.1` was inlined into `A` at compile-time, it might break at run-time due to a binary incompatibility. @@ -137,7 +137,7 @@ Method-local optimizations alone typically don't have any positive effect on per `-opt:inline` enables inlining in addition to method-local optimizations. However, to avoid unexpected binary compatibility issues, we also need to tell the compiler which code it is allowed to inline. This is done by specifying a pattern after the option to select packages, classes, and methods for inlining. Examples: - `-opt:inline:my.library.**` enables inlining from any class defined in package `my.library`, or in any of its sub-packages. Inlining within a library is safe for binary compatibility, so the resulting binary can be published. It will still work correctly even if one of its dependencies is updated to a newer minor version in the run-time classpath. -- `-opt-inline:`, where the pattern is the literal string ``, enables inlining from the set of source files being compiled in the current compiler invocation. This option can also be used for compiling libraries. If the source files of a library are split up across multiple sbt projects, inlining is only done within each project. Note that in an incremental compilation, inlining would only happen within the sources being re-compiled – but in any case, it is recommended to only enable the optimizer in CI and release builds (and to run `clean` before building). +- `-opt:inline:`, where the pattern is the literal string ``, enables inlining from the set of source files being compiled in the current compiler invocation. This option can also be used for compiling libraries. If the source files of a library are split up across multiple sbt projects, inlining is only done within each project. Note that in an incremental compilation, inlining would only happen within the sources being re-compiled – but in any case, it is recommended to only enable the optimizer in CI and release builds (and to run `clean` before building). - `-opt:inline:**` allows inlining from every class, including the JDK. This option enables full optimization when compiling an application. To avoid binary incompatibilities, it is mandatory to ensure that the run-time classpath is identical to the compile-time classpath, including the Java standard library. Running `scalac -opt:help` explains how to use the compiler flag. @@ -174,7 +174,7 @@ The inliner can issue warnings when callsites cannot be inlined. By default, the ``` $> scalac Test.scala '-opt:inline:**' -warning: there was one inliner warning; re-run enabling -opt-warnings for details, or try -help +warning: there was one inliner warning; re-run enabling -Wopt for details, or try -help one warning found $> scalac Test.scala '-opt:inline:**' -Wopt From 5ab2ddda467ac4b3228338002648c0315da28269 Mon Sep 17 00:00:00 2001 From: Brian Yue Date: Sat, 5 Mar 2022 12:19:04 +0800 Subject: [PATCH 1790/3075] Fix invalid links --- _overviews/scaladoc/contribute.md | 2 +- _scala3-reference/other-new-features/explicit-nulls.md | 2 +- scala3/scaladoc.md | 6 +++--- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/_overviews/scaladoc/contribute.md b/_overviews/scaladoc/contribute.md index c902e99f97..dc0af2ce57 100644 --- a/_overviews/scaladoc/contribute.md +++ b/_overviews/scaladoc/contribute.md @@ -25,4 +25,4 @@ which covers the steps and workflow necessary work on the Scaladoc tool. As of Scala 2.13, the Scaladoc tool is maintained but not actively developed. Major development of Scaladoc will progress as a part of Dotty for Scala 3 in the -[Dottydoc](https://dotty.epfl.ch/docs/usage/dottydoc.html) tool. +[Scaladoc]({% link _overviews/scala3-scaladoc/index.md %}) tool. diff --git a/_scala3-reference/other-new-features/explicit-nulls.md b/_scala3-reference/other-new-features/explicit-nulls.md index a0dac187ae..d33d86c931 100644 --- a/_scala3-reference/other-new-features/explicit-nulls.md +++ b/_scala3-reference/other-new-features/explicit-nulls.md @@ -537,4 +537,4 @@ Our strategy for binary compatibility with Scala binaries that predate explicit and new libraries compiled without `-Yexplicit-nulls` is to leave the types unchanged and be compatible but unsound. -[More details](https://dotty.epfl.ch/docs/internals/explicit-nulls.html) +[More details](https://dotty.epfl.ch/3.0.0/docs/internals/explicit-nulls.html) diff --git a/scala3/scaladoc.md b/scala3/scaladoc.md index 69c307654e..3b8e90b7d8 100644 --- a/scala3/scaladoc.md +++ b/scala3/scaladoc.md @@ -79,7 +79,7 @@ For more information see [Guides](/scala3/guides/scaladoc/search-engine.html) Note that this feature is still in development, so it can be subject to considerable change. If you encounter a bug or have an idea for improvement, don't hesitate to create an issue on [Inkuire](https://github.com/VirtusLab/Inkuire/issues/new) or [dotty](https://github.com/lampepfl/dotty/issues/new). -[scaladoc-docstrings]: https://dotty.epfl.ch/docs/usage/scaladoc/docstrings.html -[static-documentation]: https://dotty.epfl.ch/docs/usage/scaladoc/static-site.html -[built-in-blog]: https://dotty.epfl.ch/docs/usage/scaladoc/blog.html +[scaladoc-docstrings]: {% link _overviews/scala3-scaladoc/docstrings.md %} +[static-documentation]: {% link _overviews/scala3-scaladoc/static-site.md %} +[built-in-blog]: {% link _overviews/scala3-scaladoc/blog.md %} [social-links]: https://dotty.epfl.ch/docs/usage/scaladoc/settings.html#-social-links From 821446e2eb2ed77a39e0839698f821b5e5051562 Mon Sep 17 00:00:00 2001 From: Brian Yue Date: Fri, 4 Mar 2022 22:47:25 +0800 Subject: [PATCH 1791/3075] [zh-cn] Scala 3 Features --- _zh-cn/overviews/scala3-book/introduction.md | 12 +- .../overviews/scala3-book/scala-features.md | 891 ++++++++++++++++++ 2 files changed, 897 insertions(+), 6 deletions(-) create mode 100644 _zh-cn/overviews/scala3-book/scala-features.md diff --git a/_zh-cn/overviews/scala3-book/introduction.md b/_zh-cn/overviews/scala3-book/introduction.md index 158c93df11..21d8562dc2 100644 --- a/_zh-cn/overviews/scala3-book/introduction.md +++ b/_zh-cn/overviews/scala3-book/introduction.md @@ -4,7 +4,7 @@ type: chapter description: This page begins the overview documentation of the Scala 3 language. num: 1 previous-page: -next-page: +next-page: scala-features scala3: true partof: scala3-book @@ -14,13 +14,13 @@ permalink: "/zh-cn/scala3/book/:title.html" --- 欢迎阅读《Scala 3》一书。 -本书的目标是提供对Scala语言的非正式介绍，并以相对轻松的方式涉及所有的Scala主题。 -若您在阅读本书时想了解有关特定功能的更多信息，可以随时参阅[_参考文档_][reference]，其中更详细地涵盖了Scala语言的许多新特性。 +本书的目标是提供对 Scala 语言的非正式介绍，并以相对轻松的方式涉及所有的 Scala 主题。 +若您在阅读本书时想了解有关特定功能的更多信息，可以随时参阅[_参考文档_][reference]，其中更详细地涵盖了 Scala 语言的许多新特性。 -在本书中，我们希望证明Scala是一种优美的、富有表现力的编程语言。它具有简洁、现代的语法，支持函数式编程（FP）和面向对象编程（OOP），并提供安全的静态类型系统。 -Scala的语法和特性都经过了重新思考与公开辩论，并在2020年更新，比以往任何时候都更清晰、更容易理解。 +在本书中，我们希望证明 Scala 是一种优美的、富有表现力的编程语言。它具有简洁、现代的语法，支持函数式编程（FP）和面向对象编程（OOP），并提供安全的静态类型系统。 +Scala 的语法和特性都经过了重新思考与公开辩论，并在2020年更新，比以往任何时候都更清晰、更容易理解。 -本书首先在[“品味Scala”部分][taste]对Scala的许多特性进行了一次“旋风之旅”。随后的章节会提供有关这些语言特性的更多详细信息。 +本书首先在[“品味 Scala”部分][taste]对 Scala 的许多特性进行了一次“旋风之旅”。随后的章节会提供有关这些语言特性的更多详细信息。 > 我们仍在撰写本书的过程中。 > 您可以[帮助我们改进][contributing] diff --git a/_zh-cn/overviews/scala3-book/scala-features.md b/_zh-cn/overviews/scala3-book/scala-features.md new file mode 100644 index 0000000000..394681e1cf --- /dev/null +++ b/_zh-cn/overviews/scala3-book/scala-features.md @@ -0,0 +1,891 @@ +--- +title: Scala 3 特性 +type: chapter +description: This page discusses the main features of the Scala 3 programming language. +num: 2 +previous-page: introduction +next-page: + +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +layout: multipage-overview +permalink: "/zh-cn/scala3/book/:title.html" +--- + +{% comment %} +The name _Scala_ comes from the word _scalable_, and true to that name, the Scala language is used to power busy websites and analyze huge data sets. +This section introduces the features that make Scala a scalable language. +These features are split into three sections: +{% endcomment %} + +_Scala_ 这个名字来源于 _scalable_ 一词。正如其名，Scala 语言被用于支撑高流量网站以及分析庞大的数据集。 +本节介绍了使 Scala 成为一门可扩展语言的特性。 +这些特性分为三个部分： + +{% comment %} + +- High-level language features +- Lower-level language features +- Scala ecosystem features + +{% endcomment %} + +- 高级语言特性 +- 底层语言特性 +- Scala 生态系统特性 + +{% comment %} +I think of this section as being like an “elevator pitch.” +{% endcomment %} + +{% comment %} + +## High-level features + +{% endcomment %} + +## 高级特性 + +{% comment %} +Looking at Scala from the proverbial “30,000 foot view,” you can make the following statements about it: +{% endcomment %} + +从宏观视角来看 Scala，您可以对它做出以下陈述： + +{% comment %} + +- It’s a high-level programming language +- It has a concise, readable syntax +- It’s statically-typed (but feels dynamic) +- It has an expressive type system +- It’s a functional programming (FP) language +- It’s an object-oriented programming (OOP) language +- It supports the fusion of FP and OOP +- Contextual abstractions provide a clear way to implement _term inference_ +- It runs on the JVM (and in the browser) +- It interacts seamlessly with Java code +- It’s used for server-side applications (including microservices), big data applications, and can also be used in the browser with Scala.js + +{% endcomment %} + +- 它是一种高级编程语言 +- 它具有简明易读的语法 +- 它是静态类型的（但使人感觉是动态的） +- 它有一个表达力强大的类型系统 +- 它是一种函数式编程（FP）语言 +- 它是一种面向对象的编程（OOP）语言 +- 它支持 FP 与 OOP 的融合 +- 上下文抽象提供了一种清晰的方式来实现 _表达式推断_ +- 它在 JVM（和浏览器）上运行 +- 它与 Java 代码无缝交互 +- 它可被用于服务器端应用（包括微服务）、大数据应用，也可以在浏览器中与 Scala.js 共同使用 + +{% comment %} +The following sections take a quick look at these features. +{% endcomment %} + +以下部分将对这些特性进行简要介绍。 + +{% comment %} + +### A high-level language + +{% endcomment %} + +### 一门高级语言 + +{% comment %} +Scala is considered a high-level language in at least two ways. +First, like Java and many other modern languages, you don’t deal with low-level concepts like pointers and memory management. +{% endcomment %} + +Scala 至少在两个方面被认为是一门高级语言。 +首先，像 Java 和许多其他现代语言一样，您不需要与指针和内存管理等底层概念打交道。 + +{% comment %} +Second, with the use of lambdas and higher-order functions, you write your code at a very high level. +As the functional programming saying goes, in Scala you write _what_ you want, not _how_ to achieve it. +That is, we don’t write imperative code like this: +{% endcomment %} + +其次，通过使用 lambda 与高阶函数，您可以在非常高的层次上编写代码。 +正如函数式编程的说法，在 Scala 中，您编写您想要 _“什么”_，而不是 _“如何”_ 去实现它。 +也就是说，我们不会像这样编写命令式代码： + +```scala +def double(ints: List[Int]): List[Int] = { + val buffer = new ListBuffer[Int]() + for (i <- ints) { + buffer += i * 2 + } + buffer.toList +} + +val newNumbers = double(oldNumbers) +``` + +{% comment %} +That code instructs the compiler what to do on a step-by-step basis. +Instead, we write high-level, functional code using higher-order functions and lambdas like this to compute the same result: +{% endcomment %} + +这段代码指示编译器逐步执行特定操作。 +相反，我们使用像这样的高阶函数与 lambda 来编写高层次的函数式代码以计算出相同的结果： + +```scala +val newNumbers = oldNumbers.map(_ * 2) +``` + +{% comment %} +As you can see, that code is much more concise, easier to read, and easier to maintain. +{% endcomment %} + +如您所见，该代码更简洁、更容易阅读且更易于维护。 + +{% comment %} + +### Concise syntax + +{% endcomment %} + +### 简明的语法 + +{% comment %} +Scala has a concise, readable syntax. +For instance, variables are created concisely, and their types are clear: +{% endcomment %} + +Scala 具有简明易读的语法。例如，变量的创建十分简洁，其类型也很明确。 + +```scala +val nums = List(1,2,3) +val p = Person("Martin", "Odersky") +``` + +{% comment %} +Higher-order functions and lambdas make for concise code that’s readable: +{% endcomment %} + +高阶函数与 lambda 使代码简明易读： + +```scala +nums.map(i => i * 2) // long form +nums.map(_ * 2) // short form + +nums.filter(i => i > 1) +nums.filter(_ > 1) +``` + +{% comment %} +Traits, classes, and methods are defined with a clean, light syntax: +{% endcomment %} + +特质（Traits）、类（Class）和方法（Method）都是用简洁、轻巧的语法定义的。 + +```scala +trait Animal: + def speak(): Unit + +trait HasTail: + def wagTail(): Unit + +class Dog extends Animal, HasTail: + def speak() = println("Woof") + def wagTail() = println("⎞⎜⎛ ⎞⎜⎛") +``` + +{% comment %} +Studies have shown that the time a developer spends _reading_ code to _writing_ code is at least a 10:1 ratio, so writing code that is concise _and_ readable is important. +{% endcomment %} + +研究表明，开发人员花在 _阅读_ 代码和 _编写_ 代码上的时间比例至少为 10:1。因此，编写简洁 _并_ 易读的代码非常重要。 + +{% comment %} + +### A dynamic feel + +{% endcomment %} + +### 动态感受 + +{% comment %} +Scala is a statically-typed language, but thanks to its type inference capabilities it feels dynamic. +All of these expressions look like a dynamically-typed language like Python or Ruby, but they’re all Scala: +{% endcomment %} + +Scala 是一种静态类型的语言，但由于其类型推断能力，它使人感觉是动态的。所有这些表达式看起来都像 Python 或 Ruby 这样的动态类型语言代码，但其实它们都是 Scala 代码： + +```scala +val s = "Hello" +val p = Person("Al", "Pacino") +val sum = ints.reduceLeft(_ + _) +val y = for i <- nums yield i * 2 +val z = nums.filter(_ > 100) + .filter(_ < 10_000) + .map(_ * 2) +``` + +{% comment %} +As Heather Miller states, Scala is considered to be a [strong, statically-typed language](https://heather.miller.am/blog/types-in-scala.html), and you get all the benefits of static types: +{% endcomment %} + +正如 Heather Miller 所说，Scala 被认为是一种[强静态类型语言](https://heather.miller.am/blog/types-in-scala.html)。您可以获得静态类型的全部益处： + +{% comment %} + +- Correctness: you catch most errors at compile-time +- Great IDE support + - Reliable code completion + - Catching errors at compile-time means catching mistakes as you type + - Easy and reliable refactoring +- You can refactor your code with confidence +- Method type declarations tell readers what the method does, and help serve as documentation +- Scalability and maintainability: types help ensure correctness across arbitrarily large applications and development teams +- Strong typing in combination with excellent inference enables mechanisms like [contextual abstraction]({{ site.scala3ref }}/contextual.html) that allows you to omit boilerplate code. Often, this boilerplate code can be inferred by the compiler, based on type definitions and a given context. + +{% endcomment %} + +- 正确性：您可以在编译时捕获大多数错误 +- 强大的 IDE 支持 + - 可靠的代码补全 + - 在编译时捕获错误意味着在您打字时捕获错误 + - 简单而可靠的重构 +- 您可以自信地重构您的代码 +- 方法类型声明告诉读者该方法的作用，并作为文档提供帮助 +- 可扩展性与可维护性：类型有助于在任意大小的应用程序与开发团队中确保正确性 +- 强类型结合优秀的推断能力可实现[上下文抽象]({{ site.scala3ref }}/contextual.html)等机制，这允许您省略样板代码。通常，这些样板代码可由编译器根据类型定义及给定的上下文推断出来。 + +{% comment %} +In that list: +- 'Correctness' and 'Scalability' come from Heather Miller’s page +- the IDE-related quotes in this section come from the Scala.js website: + - catch most errors in the IDE + - Easy and reliable refactoring + - Reliable code completion +{% endcomment %} + +{% comment %} + +### Expressive type system + +{% endcomment %} + +### 富有表现力的类型系统 + +{% comment %} +- this text comes from the current [ScalaTour](https://docs.scala-lang.org/tour/tour-of-scala.html). +- TODO: all of the URLs will have to be updated + +- i removed these items until we can replace them: +* [Compound types](/tour/compound-types.html) +* [conversions](/tour/implicit-conversions.html) +* [Explicitly typed self references](/tour/self-types.html) +{% endcomment %} + +{% comment %} +Scala’s type system enforces, at compile-time, that abstractions are used in a safe and coherent manner. +In particular, the type system supports: +{% endcomment %} + +Scala 的类型系统在编译时强制要求以安全与连贯的方式使用抽象概念。特别是，该类型系统支持： + +{% comment %} +- [Inferred types]({% link _overviews/scala3-book/types-inferred.md %}) +- [Generic classes]({% link _overviews/scala3-book/types-generics.md %}) +- [Variance annotations]({% link _overviews/scala3-book/types-variance.md %}) +- [Upper](/tour/upper-type-bounds.html) and [lower](/tour/lower-type-bounds.html) type bounds +- [Polymorphic methods](/tour/polymorphic-methods.html) +- [Intersection types]({% link _overviews/scala3-book/types-intersection.md %}) +- [Union types]({% link _overviews/scala3-book/types-union.md %}) +- [Type lambdas]({{ site.scala3ref }}/new-types/type-lambdas.html) +- [`given` instances and `using` clauses]({% link _overviews/scala3-book/ca-given-using-clauses.md %}) +- [Extension methods]({% link _overviews/scala3-book/ca-extension-methods.md %}) +- [Type classes]({% link _overviews/scala3-book/ca-type-classes.md %}) +- [Multiversal equality]({% link _overviews/scala3-book/ca-multiversal-equality.md %}) +- [Opaque type aliases]({% link _overviews/scala3-book/types-opaque-types.md %}) +- [Open classes]({{ site.scala3ref }}/other-new-features/open-classes.html) +- [Match types]({{ site.scala3ref }}/new-types/match-types.html) +- [Dependent function types]({{ site.scala3ref }}/new-types/dependent-function-types.html) +- [Polymorphic function types]({{ site.scala3ref }}/new-types/polymorphic-function-types.html) +- [Context bounds]({{ site.scala3ref }}/contextual/context-bounds.html) +- [Context functions]({{ site.scala3ref }}/contextual/context-functions.html) +- [Inner classes](/tour/inner-classes.html) and [abstract type members](/tour/abstract-type-members.html) as object members +{% endcomment %} + +- [推断类型]({% link _overviews/scala3-book/types-inferred.md %}) +- [泛型类]({% link _overviews/scala3-book/types-generics.md %}) +- [型变]({% link _overviews/scala3-book/types-variance.md %}) +- [类型上界](/tour/upper-type-bounds.html) 与 [类型下界](/tour/lower-type-bounds.html) +- [多态方法](/tour/polymorphic-methods.html) +- [交叉类型]({% link _overviews/scala3-book/types-intersection.md %}) +- [联合类型]({% link _overviews/scala3-book/types-union.md %}) +- [类型 Lambda]({{ site.scala3ref }}/new-types/type-lambdas.html) +- [`given` 实例与 `using` 子句]({% link _overviews/scala3-book/ca-given-using-clauses.md %}) +- [扩展方法]({% link _overviews/scala3-book/ca-extension-methods.md %}) +- [类型类]({% link _overviews/scala3-book/ca-type-classes.md %}) +- [多元相等]({% link _overviews/scala3-book/ca-multiversal-equality.md %}) +- [不透明类型别名]({% link _overviews/scala3-book/types-opaque-types.md %}) +- [开放类]({{ site.scala3ref }}/other-new-features/open-classes.html) +- [匹配类型]({{ site.scala3ref }}/new-types/match-types.html) +- [依赖函数类型]({{ site.scala3ref }}/new-types/dependent-function-types.html) +- [多态函数类型]({{ site.scala3ref }}/new-types/polymorphic-function-types.html) +- [上下文边界]({{ site.scala3ref }}/contextual/context-bounds.html) +- [上下文函数]({{ site.scala3ref }}/contextual/context-functions.html) +- 作为对象成员的[内部类](/tour/inner-classes.html) 与 [抽象类型](/tour/abstract-type-members.html) + +{% comment %} +In combination, these features provide a powerful basis for the safe reuse of programming abstractions and for the type-safe extension of software. +{% endcomment %} + +通过结合使用，这些特性为编程抽象的安全重用及软件的类型安全扩展提供了强大的基础。 + +{% comment %} + +### A functional programming language + +{% endcomment %} + +### 一门函数式编程语言 + +{% comment %} +Scala is a functional programming (FP) language, meaning: +{% endcomment %} + +Scala 是一门函数式编程（FP）语言，也就是说： + +{% comment %} + +- Functions are values, and can be passed around like any other value +- Higher-order functions are directly supported +- Lambdas are built in +- Everything in Scala is an expression that returns a value +- Syntactically it’s easy to use immutable variables, and their use is encouraged +- It has a wealth of immutable collection classes in the standard library +- Those collection classes come with dozens of functional methods: they don’t mutate the collection, but instead return an updated copy of the data + +{% endcomment %} + +- 函数是值，可以像任何其他值一样被传递 +- 直接支持高阶函数 +- 原生地支持 Lambda +- Scala 中的一切都是会返回值的表达式 +- 从语法上来说，使用不可变变量很容易并且此行为被鼓励 +- 在标准库中有大量的不可变集合类 +- 这些集合类带有许多函数式方法：它们不改变集合本身，而是返回数据的更新副本 + +{% comment %} + +### An object-oriented language + +{% endcomment %} + +### 一门面向对象语言 + +{% comment %} +Scala is an object-oriented programming (OOP) language. +Every value is an instance of a class and every “operator” is a method. +{% endcomment %} + +Scala 是一门面向对象编程（OOP）语言。 +每个值都是一个类的实例，每个“运算符”都是一个方法。 + +{% comment %} +In Scala, all types inherit from a top-level class `Any`, whose immediate children are `AnyVal` (_value types_, such as `Int` and `Boolean`) and `AnyRef` (_reference types_, as in Java). +This means that the Java distinction between primitive types and boxed types (e.g. `int` vs. `Integer`) isn’t present in Scala. +Boxing and unboxing is completely transparent to the user. +{% endcomment %} + +在 Scala 中，所有类型都继承自顶层类 `Any`，其直接子类是 `AnyVal`（_值类型_，例如 `Int` 与 `Boolean`）和 `AnyRef`（_引用类型_，与 Java 中相同）。 +这意味着 Scala 中不存在 Java 中原始类型和包装类型的区别（例如 `int` 与 `Integer`）。 +装箱与拆箱对用户来说是完全透明的。 + +{% comment %} +- AnyRef above is wrong in case of strict null checking, no? On the other hand, maybe too much information to state this here +- probably not worth to mention (too advanced at this point) there is AnyKind +- Add the “types hierarchy” image here? +{% endcomment %} + +{% comment %} + +### Supports FP/OOP fusion + +{% endcomment %} + +### 支持 FP 与 OOP 融合 + +{% comment %} +NOTE: This text in the first line comes from this slide: https://twitter.com/alexelcu/status/996408359514525696 +{% endcomment %} + +{% comment %} +The essence of Scala is the fusion of functional programming and object-oriented programming in a typed setting: + +- Functions for the logic +- Objects for the modularity + +As [Martin Odersky has stated](https://jaxenter.com/current-state-scala-odersky-interview-129495.html), “Scala was designed to show that a fusion of functional and object-oriented programming is possible and practical.” +{% endcomment %} + +Scala 的本质是函数式编程和面向对象编程的融合： + +- 函数用于代表逻辑 +- 对象用于模块化 + +正如 [Martin Odersky 所说](https://jaxenter.com/current-state-scala-odersky-interview-129495.html)，“Scala 旨在表明函数式编程与面向对象编程的融合是切实可行的。” + +{% comment %} + +### Term inference, made clearer + +{% endcomment %} + +### 表达式推断，更加清晰 + +{% comment %} +Following Haskell, Scala was the second popular language to have some form of _implicits_. +In Scala 3 these concepts have been completely re-thought and more clearly implemented. + +The core idea is _term inference_: Given a type, the compiler synthesizes a “canonical” term that has that type. +In Scala, a context parameter directly leads to an inferred argument term that could also be written down explicitly. + +Use cases for this concept include implementing [type classes]({% link _overviews/scala3-book/ca-type-classes.md %}), establishing context, dependency injection, expressing capabilities, computing new types, and proving relationships between them. + +Scala 3 makes this process more clear than ever before. +Read about contextual abstractions in the [Reference documentation]({{ site.scala3ref }}/contextual.html). +{% endcomment %} + +继 Haskell 之后，Scala 是第二种具有某种形式的 _隐式_ 的流行语言。 +在 Scala 3 中，这些概念经过了重新考虑并更清晰地实现。 + +其核心思想是 _表达式推断_：给定一个类型，编译器会合成一个具有该类型的“规范”表达式。 +在 Scala 中，一个上下文参数直接导致一个被推断出的参数项的出现。该参数项也可以被显式地写出来。 + +此概念的用例包括实现[类型类]({% link _overviews/scala3-book/ca-type-classes.md %})、建立上下文、依赖注入、表达能力、计算新类型以及证明它们之间的关系。 + +Scala 3 使此过程比以往任何时候都更加清晰。 +请在[参考文档]({{ site.scala3ref }}/contextual.html)中阅读关于上下文抽象的内容。 + +{% comment %} + +### Client & server + +{% endcomment %} + +### 客户端与服务器 + +{% comment %} +Scala code runs on the Java Virtual Machine (JVM), so you get all of its benefits: + +- Security +- Performance +- Memory management +- Portability and platform independence +- The ability to use the wealth of existing Java and JVM libraries + +In addition to running on the JVM, Scala also runs in the browser with Scala.js (and open source third-party tools to integrate popular JavaScript libraries), and native executables can be built with Scala Native and GraalVM. +{% endcomment %} + +Scala 代码在 Java 虚拟机（JVM）上运行，因此您可以获得它的全部益处： + +- 安全性 +- 性能 +- 内存管理 +- 可移植性与平台独立性 +- 能够使用大量的现有 Java 和 JVM 库 + +除了在 JVM 上运行外，Scala 还可以通过 Scala.js （以及开源的第三方工具以集成流行的 JavaScript 库）在浏览器中运行，并且可以使用Scala Native 与 GraalVM 构建原生可执行文件。 + +{% comment %} + +### Seamless Java interaction + +{% endcomment %} + +### 与 Java 无缝交互 + +{% comment %} +You can use Java classes and libraries in your Scala applications, and you can use Scala code in your Java applications. +In regards to the second point, large libraries like [Akka](https://akka.io) and the [Play Framework](https://www.playframework.com) are written in Scala, and can be used in Java applications. +{% endcomment %} + +您可以在 Scala 应用程序中使用 Java 类和库，也可以在 Java 应用程序中使用 Scala 代码。 +对于第二点来说，诸如 [Akka](https://akka.io) 和 [Play Framework](https://www.playframework.com) 之类的大型库是用 Scala 编写的，并且它们可以在 Java 应用程序中使用。 + +{% comment %} +In regards to the first point, Java classes and libraries are used in Scala applications every day. +For instance, in Scala you can read files with a Java `BufferedReader` and `FileReader`: +{% endcomment %} + +对于第一点来说，Scala 应用程序中每天都会用到 Java 类和库。 +例如，在 Scala 中，您可以使用 Java 的 `BufferedReader` 和 `FileReader` 来读取文件： + +```scala +import java.io.* +val br = BufferedReader(FileReader(filename)) +// read the file with `br` ... +``` + +{% comment %} +Using Java code in Scala is generally seamless. + +Java collections can also be used in Scala, and if you want to use Scala’s rich collection class methods with them, you can convert them with just a few lines of code: +{% endcomment %} + +在 Scala 中使用 Java 代码通常是无缝衔接的。 + +Java 集合也可以在 Scala 中使用， 如果您想将 Scala 丰富的集合类方法与其一起使用，只需几行代码即可转换它们： + + +```scala +import scala.jdk.CollectionConverters.* +val scalaList: Seq[Integer] = JavaClass.getJavaList().asScala.toSeq +``` + +{% comment %} + +### Wealth of libraries + +{% endcomment %} + +### 丰富的库 + +{% comment %} +As you’ll see in the third section of this page, Scala libraries and frameworks like these have been written to power busy websites and work with huge datasets: + +1. The [Play Framework](https://www.playframework.com) is a lightweight, stateless, developer-friendly, web-friendly architecture for creating highly-scalable applications +2. [Lagom](https://www.lagomframework.com) is a microservices framework that helps you decompose your legacy monolith and build, test, and deploy entire systems of reactive microservices +3. [Apache Spark](https://spark.apache.org) is a unified analytics engine for big data processing, with built-in modules for streaming, SQL, machine learning and graph processing + +The [Awesome Scala list](https://github.com/lauris/awesome-scala) shows dozens of additional open source tools that developers have created to build Scala applications. + +In addition to server-side programming, [Scala.js](https://www.scala-js.org) is a strongly-typed replacement for writing JavaScript, with open source third-party libraries that include tools to integrate with Facebook’s React library, jQuery, and more. +{% endcomment %} + +正如您将在本页的第三部分中所看到的那样，已经有诸如此类的 Scala 库和框架被编写出来用于支撑高流量网站以及分析庞大的数据集： + +1. [Play Framework](https://www.playframework.com) 是一种用于创建高度可扩展应用程序的轻量级、无状态、对开发者及Web友好的架构 +2. [Lagom](https://www.lagomframework.com) 是一种微服务框架，可帮助您分解遗留的单体应用并构建、测试和部署整个响应式微服务系统 +3. [Apache Spark](https://spark.apache.org) 是一种面向大规模数据处理的统一分析引擎，内置流、SQL、机器学习和图形处理等模块 + +[Awesome Scala 列表](https://github.com/lauris/awesome-scala)展示了开发人员为构建 Scala 应用程序而创建的许多其他开源工具。 + +除了服务器端编程之外，[Scala.js](https://www.scala-js.org) 是一款用于编写 JavaScript 应用的强类型替代方案。其开源的第三方库包含支持与 Facebook 的 React、jQuery 及其他库等集成的工具。 + +{% comment %} +The Lower-Level Features section is like the second part of an elevator pitch. +Assuming you told someone about the previous high-level features and then they say, “Tell me more,” this is what you might tell them. +{% endcomment %} + +{% comment %} + +## Lower-level language features + +{% endcomment %} + +## 底层语言特性 + +{% comment %} +Where the previous section covered high-level features of Scala 3, it’s interesting to note that at a high level you can make the same statements about both Scala 2 and Scala 3. +A decade ago Scala started with a strong foundation of desirable features, and as you’ll see in this section, those benefits have been improved with Scala 3. +{% endcomment %} + +上一节介绍了 Scala 3 的高级特性，有趣的是，您可以从高层次上对 Scala 2 和 Scala 3 作出相同的表述。 +十年前，Scala 就为各种理想特性打下了坚实基础，正如您在本节中即将看到的那样，这些效益在 Scala 3 中得到了提高。 + +{% comment %} +At a “sea level” view of the details---i.e., the language features programmers use everyday---Scala 3 has significant advantages over Scala 2: + +- The ability to create algebraic data types (ADTs) more concisely with enums +- An even more concise and readable syntax: + - The “quiet” control structure syntax is easier to read + - Optional braces + - Fewer symbols in the code creates less visual noise, making it easier to read + - The `new` keyword is generally no longer needed when creating class instances + - The formality of package objects have been dropped in favor of simpler “top level” definitions +- A grammar that’s more clear: + - Multiple different uses of the `implicit` keyword have been removed; those uses are replaced by more obvious keywords like `given`, `using`, and `extension`, focusing on intent over mechanism (see the [Givens][givens] section for details) + - [Extension methods][extension] replace implicit classes with a clearer and simpler mechanism + - The addition of the `open` modifier for classes makes the developer intentionally declare that a class is open for modification, thereby limiting ad-hoc extensions to a code base + - [Multiversal equality][multiversal] rules out nonsensical comparisons with `==` and `!=` (i.e., attempting to compare a `Person` to a `Planet`) + - Macros are implemented much more easily + - Union and intersection offer a flexible way to model types + - Trait parameters replace and simplify early initializers + - [Opaque type aliases][opaque_types] replace most uses of value classes, while guaranteeing the absence of boxing + - Export clauses provide a simple and general way to express aggregation, which can replace the previous facade pattern of package objects inheriting from classes + - The procedure syntax has been dropped, and the varargs syntax has been changed, both to make the language more consistent + - The `@infix` annotation makes it obvious how you want a method to be applied + - The [`@targetName`]({{ site.scala3ref }}/other-new-features/targetName.html) method annotation defines an alternate name for the method, improving Java interoperability, and letting you provide aliases for symbolic operators + +It would take too much space to demonstrate all of those features here, but follow the links in the items above to see those features in action. +All of these features are discussed in detail in the *New*, *Changed*, and *Dropped* features pages in the [Overview documentation][reference]. +{% endcomment %} + +以小见大，从程序员日常使用的语言特性来看，Scala 3 比 Scala 2 具有显著优势： + +- 可以用枚举更简洁地创建代数数据类型（ADT） +- 更简明易读的语法： + - “干净”的控制结构语法更容易阅读 + - 可选的大括号 + - 代码中包含更少的符号，因此会产生更少的视觉噪音，使其更容易阅读 + - 创建类实例时一般不再需要 `new` 关键字 + - 弃用了包对象，转而使用更简单的“顶层”定义 +- 更清晰的语法： + - 移除了 `implicit` 关键字的多种不同用法，这些用法被更显而易见的关键字所取代，如 `given`、 `using`、和 `extension`，以此将关注重点放在意图而不是机制上（详见 [Givens][givens] 部分） + - [扩展方法][extension]通过更加清晰简单的机制取代了隐式类 + - 为类添加了 `open` 修饰符，使开发者能够有意识地声明一个类是可以被修改的，从而限制对代码库的临时扩展 + - [多元相等][multiversal]排除了用 `==` 和 `!=` 进行无意义的比较（即试图将 `Person` 与 `Planet` 进行比较） + - 宏的实现变得更加容易 + - 联合与交叉提供了一种灵活的方式以建模类型 + - 特质参数取代并简化了早期初始化器 + - [不透明类型别名][opaque_types]取代了值类的大多数用途，并确保不进行装箱 + - 导出子句提供了一种简单而通用的方式来表现聚合，它可以取代之前继承自类的包对象的外观模式 + - 删除了过程语法并更改了可变参数语法，这增加了语言一致性 + - `@infix` 注解使得您想让一个方法被如何应用更加显而易见 + - [`@targetName`]({{ site.scala3ref }}/other-new-features/targetName.html) 方法注解为方法定义了一个候补名称。这提高了与 Java 的互操作性，并允许您为符号运算符提供别名 + +在这里演示所有这些特性会占用太多空间，请通过上述内容中的链接来查看这些特性的实际效果。 +所有这些特性都在[概述文档][reference]的*新特性*、*变更的特性*、与*删除的特性*等页面中进行了详细讨论。 + +{% comment %} +CHECKLIST OF ALL ADDED, UPDATED, AND REMOVED FEATURES +===================================================== + +New Features +------------ +- trait parameters +- super traits +- creator applications +- export clauses +- opaque type aliases +- open classes +- parameter untupling +- kind polymorphism +- tupled function +- threadUnsafe annotation +- new control syntax +- optional braces (experimental) +- explicit nulls +- safe initialization + +CHANGED FEATURES +---------------- +- numeric literals +- structural types +- operators +- wildcard types +- type checking +- type inference +- implicit resolution +- implicit conversions +- overload resolution +- match expressions +- vararg patterns +- pattern bindings +- pattern matching +- eta expansion +- compiler plugins +- lazy vals initialization +- main functions + +DROPPED FEATURES +---------------- +- DelayedInit +- macros +- existential types +- type projection +- do/while syntax +- procedure syntax +- package objects +- early initializers +- class shadowing +- limit 22 +- XML literals +- symbol literals +- auto-application +- weak conformance +- nonlocal returns +- [this] qualifier + - private[this] and protected[this] access modifiers are deprecated + and will be phased out +{% endcomment %} + + +{% comment %} + +## Scala ecosystem + +{% endcomment %} + +## Scala 生态系统 + +{% comment %} +TODO: I didn’t put much work into this section because I don’t know if you want + to add many tools because (a) that can be seen as an endorsement and + (b) it creates a section that can need more maintenance than average + since tool popularity can wax and wane. One way to avoid the first + point is to base the lists on Github stars and activity. +{% endcomment %} + +{% comment %} +Scala has a vibrant ecosystem, with libraries and frameworks for every need. +The [“Awesome Scala” list](https://github.com/lauris/awesome-scala) provides a list of hundreds of open source projects that are available to Scala developers, and the [Scaladex](https://index.scala-lang.org) provides a searchable index of Scala libraries. +Some of the more notable libraries are listed below. +{% endcomment %} + +Scala 拥有一个充满活力的生态系统，有满足各种需求的库和框架。 +[Awesome Scala 列表](https://github.com/lauris/awesome-scala)提供了数百个可供 Scala 开发者使用的开源项目，[Scaladex](https://index.scala-lang.org) 则提供了 Scala 库的可搜索索引。 +以下列出了一些比较著名的库： + +{% comment %} + +### Web development + +{% endcomment %} + +### Web 开发 + +{% comment %} + +- The [Play Framework](https://www.playframework.com) followed the Ruby on Rails model to become a lightweight, stateless, developer-friendly, web-friendly architecture for highly-scalable applications +- [Scalatra](https://scalatra.org) is a tiny, high-performance, async web framework, inspired by Sinatra +- [Finatra](https://twitter.github.io/finatra) is Scala services built on TwitterServer and Finagle +- [Scala.js](https://www.scala-js.org) is a strongly-typed replacement for JavaScript that provides a safer way to build robust front-end web applications +- [ScalaJs-React](https://github.com/japgolly/scalajs-react) lifts Facebook’s React library into Scala.js, and endeavours to make it as type-safe and Scala-friendly as possible +- [Lagom](https://www.lagomframework.com) is a microservices framework that helps you decompose your legacy monolith and build, test, and deploy entire systems of Reactive microservices +- +{% endcomment %} + +- [Play Framework](https://www.playframework.com) 遵循 Ruby on Rails 模型，是一种用于高度可扩展应用程序的轻量级、无状态、对开发者及Web友好的架构 +- [Scalatra](https://scalatra.org) 是一个小型的、高性能的、异步的网络框架，其灵感来自于 Sinatra +- [Finatra](https://twitter.github.io/finatra) 是基于 TwitterServer 和 Finagle 构建的 Scala 服务 +- [Scala.js](https://www.scala-js.org) 是 JavaScript 的强类型替代品，它提供了一种更安全的方式以构建稳健的前端 Web 应用程序 +- [ScalaJs-React](https://github.com/japgolly/scalajs-react) 将 Facebook 的 React 库整合至 Scala.js，并努力使其尽可能类型安全和 Scala 友好 +- [Lagom](https://www.lagomframework.com) 是一种微服务框架，可帮助您分解遗留的单体应用并构建、测试和部署整个响应式微服务系统 + +{% comment %} +HTTP(S) libraries: +{% endcomment %} + +HTTP(S) 库： + +- [Akka-http](https://akka.io) +- [Finch](https://github.com/finagle/finch) +- [Http4s](https://github.com/http4s/http4s) +- [Sttp](https://github.com/softwaremill/sttp) + +{% comment %} +JSON libraries: +{% endcomment %} + +JSON 库： + +- [Argonaut](https://github.com/argonaut-io/argonaut) +- [Circe](https://github.com/circe/circe) +- [Json4s](https://github.com/json4s/json4s) +- [Play-JSON](https://github.com/playframework/play-json) + +{% comment %} +Serialization: +{% endcomment %} + +序列化： + +- [ScalaPB](https://github.com/scalapb/ScalaPB) + +{% comment %} + +### Science and data analysis: + +{% endcomment %} + +### 科学和数据分析 + +- [Algebird](https://github.com/twitter/algebird) +- [Spire](https://github.com/typelevel/spire) +- [Squants](https://github.com/typelevel/squants) + +{% comment %} + +### Big data + +{% endcomment %} + +### 大数据 + +- [Apache Spark](https://github.com/apache/spark) +- [Apache Flink](https://github.com/apache/flink) + +{% comment %} + +### AI, machine learning + +- [BigDL](https://github.com/intel-analytics/BigDL) (Distributed Deep Learning Framework for Apache Spark) for Apache Spark +- [TensorFlow Scala](https://github.com/eaplatanios/tensorflow_scala) + +{% endcomment %} + +### 人工智能，机器学习 + +- [BigDL](https://github.com/intel-analytics/BigDL) （用于 Apache Spark 的分布式深度学习框架） +- [TensorFlow Scala](https://github.com/eaplatanios/tensorflow_scala) + +{% comment %} + +### Functional Programming & Functional Reactive Programming + +{% endcomment %} + +### 函数式编程 & 函数式响应式编程 + +{% comment %} +FP: +{% endcomment %} + +函数式编程： + +- [Cats](https://github.com/typelevel/cats) +- [Zio](https://github.com/zio/zio) + +{% comment %} +Functional reactive programming (FRP): +{% endcomment %} + +函数式响应式编程（FRP） + +- [fs2](https://github.com/typelevel/fs2) +- [monix](https://github.com/monix/monix) + +{% comment %} + +### Build tools + +{% endcomment %} + +### 构建工具 + +- [sbt](https://www.scala-sbt.org) +- [Gradle](https://gradle.org) +- [Mill](https://github.com/lihaoyi/mill) + +{% comment %} + +## Summary + +As this page shows, Scala has many terrific programming language features at a high level, at an everyday programming level, and through its developer ecosystem. + +{% endcomment %} + +## 总结 + +如此页所示，Scala 在高层、日常编程层面以及贯穿开发者生态系统都具有许多出色的编程语言特性。 + + +[reference]: {{ site.scala3ref }}/overview.html +[multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} +[extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[opaque_types]: {% link _overviews/scala3-book/types-opaque-types.md %} + + + From 0eae0a35185c354be03ab5b707b993c06c555be0 Mon Sep 17 00:00:00 2001 From: Thanh Le Date: Tue, 8 Mar 2022 20:37:57 +0100 Subject: [PATCH 1792/3075] Fix link to for type lambdas url --- _overviews/scala3-migration/plugin-kind-projector.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/plugin-kind-projector.md b/_overviews/scala3-migration/plugin-kind-projector.md index 6d49be8d28..8557cdb559 100644 --- a/_overviews/scala3-migration/plugin-kind-projector.md +++ b/_overviews/scala3-migration/plugin-kind-projector.md @@ -100,7 +100,7 @@ type MyLambda[F[_], A] = EitherT[F, Int, A] MyLambda ``` -Alternatively you may use Scala 3's [Native Type Lambdas](https://dotty.epfl.ch/docs/reference/new-types/type-lambdas.html) if you do not need to cross-compile: +Alternatively you may use Scala 3's [Native Type Lambdas](https://docs.scala-lang.org/scala3/reference/new-types/type-lambdas.html) if you do not need to cross-compile: ```scala [F[_], A] =>> EitherT[F, Int, A] From 9097144e071d4290dc165aee2e2855c48aae64dd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Filip=20Zyba=C5=82a?= Date: Tue, 8 Feb 2022 15:13:34 +0100 Subject: [PATCH 1793/3075] Update static site docs --- _overviews/scala3-scaladoc/blog.md | 13 +- _overviews/scala3-scaladoc/static-site.md | 170 ++++++++++++---------- 2 files changed, 96 insertions(+), 87 deletions(-) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index 1e3c371c8e..612ee5c25e 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -15,24 +15,17 @@ Blog is treated a little differently than regular static sites. This article wil ## Proper directory setup -All your blogposts must be put under `blog/_posts` directory. +All your blogposts must be put under `_blog/_posts` directory. ``` -├── blog +├── _blog │ ├── _posts │ │ └── 2016-12-05-implicit-function-types.md │ └── index.html ``` -If you are using yaml [sidebar]({% link _overviews/scala3-scaladoc/static-site.md %}#sidebar) don't forget to place - -``` -sidebar: - - title: Blog -``` - -somewhere inside the `yaml` tree representing the sidebar sections. Scaladoc will attach under that section all of your blogposts. +Scaladoc loads blog if the `_blog` directory exists. ## Naming convention diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index e7516ea09c..d9d11f6bf6 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -20,16 +20,18 @@ and will from here on be referred to as "template files" or "templates". A simple "hello world" site could look something like this: ``` -├── docs -│ └── getting-started.md -└── index.html +. +└── / + └── _docs/ + ├── index.html + └── getting-started.html ``` This will give you a site with the following files in generated documentation: ``` index.html -docs/getting-started.html +getting-started.html ``` Scaladoc can transform both files and directories (to organize your documentation into a tree-like structure). By default, directories have a title based on the file name and have empty content. It is possible to provide index pages for each section by creating `index.html` or `index.md` (not both) in the dedicated directory. @@ -98,63 +100,64 @@ Layouts must be placed in a `_layouts` directory in the site root: ``` ├── _layouts │ └── main.html -├── docs -│ └── getting-started.md -└── index.html +└── _docs + └── getting-started.md +``` + +## Assets + +In order to render assets along with static site, they need to be placed in the `_assets` directory in the site root: +``` +├── _assets +│ └── images +│ └── myimage.png +└── _docs + └── getting-started.md +``` +To reference the asset in a page, one need to create link relative to the `_assets` directory + +``` +Take a look at the following image: [My image](images/myimage.png) ``` ## Sidebar -Scaladoc by default uses layout of files in `docs` directory to create table of content. There is also ability to override it by providing a `sidebar.yml` file in the site root: +Scaladoc by default uses directory structure in `_docs` directory to organize static sites. There is also possibility to override it by providing a `sidebar.yml` file in the site root. The YAML configuration file describes the structure of rendered static site and the table of content: ```yaml -sidebar: - - title: Blog - - title: My title - page: my-page1.md - - page: my-page2.md - - page: my-page3/subsection - - title: Reference - subsection: - - page: my-page3.md - - index: my-page4/index.md - subsection: - - page: my-page4/my-page4.md - - title: My subsection - index: my-page5/index.md - subsection: - - page: my-page5/my-page5.md - - index: my-page6/index.md - subsection: - - index: my-page6/my-page6/index.md - subsection: - - page: my-page6/my-page6/my-page6.md -``` - -The `sidebar` key is mandatory. -On each level, you can have three different types of entries: `page`, `blog` or `subsection`. - -`page` is a leaf of the structure and accepts the following attributes: -- `title` (optional) - title of the page -- `page` (mandatory) - path to the file that will represent the page, it can be either html or markdown file to be rendered, there is also the possibility to pass the `directory` path. If so, the scaladoc will render the directory and all its content as if there were no `sidebar.yml` basing on its tree structure and index files. - -The `page` property `subsection` accepts nested nodes, these can be either pages or subsections, which allow you to create tree-like navigation. The attributes are: -- `title` (optional) - title of the page -- `index` (optional) - path to the file that will represent the index file of the subsection, it can be either html or markdown file to be rendered -- `subsection` (mandatory) - nested nodes, can be either pages or subsections - -In `subsection`s, you can omit `title` or `index`, however not specifying any of these properties prevents you from specifying the title of the section. - -`blog` is a special node represented by simple entry `- title: Blog` with no other attributes. All your blog posts will be automatically linked under this section. You can read more about the blog [here]({% link _overviews/scala3-scaladoc/blog.md %}). - -``` -├── blog -│ ├── _posts -│ │ └── 2016-12-05-implicit-function-types.md -│ └── index.html -├── index.html -└── sidebar.yml -``` +index: index.html +subsection: + - title: Usage + index: usage/index.html + directory: usage + subsection: + - title: Dottydoc + page: usage/dottydoc.html + hidden: false + - title: sbt-projects + page: usage/sbt-projects.html + hidden: false +``` +The root element needs to be a `subsection`. +Nesting subsections will result in a tree-like structure of navigation. + +`subsection` properties are: + - `title` - Optional string - A default title of the subsection. + Front-matter titles have higher priorities. + - `index` - Optional string - A path to index page of a subsection. + - `directory` - Optional string - A name of the directory that will contain the subsection. + By default, the directory name is the subsection name converted to kebab case. + - `subsection` - Array of `subsection` or `page`. + + Either `index` or `subsection` must be defined. The subsection defined with `index` and without `subsection` will contain pages and directories loaded recursively from directory of the index page. + +`page` properties are: + - `title` - Optional string - A default title of the page. + Front-matter titles have higher priorities. + - `page` - String - A path to the page + - `hidden` - Optional boolean - A flag that indicates whether the page should be visible in navigation. By default, it is set to `false`. + +**Note**: All paths in YAML configuration file are relative to `/_docs`. ## Hierarchy of title @@ -174,30 +177,43 @@ If the title is specified multiple times, the priority is as follows (from highe Note that if you skip the `index` file in your tree structure or you don't specify the `title` in the frontmatter, there will be given a generic name `index`. The same applies when using `sidebar.yml` but not specifying `title` nor `index`, just a subsection. Again, a generic `index` name will appear. +## Blog +Blog feature is described in [a separate document]({% link _overviews/scala3-scaladoc/blog.md %}) -## Static resources - -You can attach static resources (pdf, images) to your documentation by using two dedicated directories: -`resources` and `images`. After placing your assets under any of these directories, you can reference them in markdown -as if they were relatively at the same level. - -For example, consider the following situation: - +## Advanced configuration +### Full structure of site root ``` -├── blog -│ ├── _posts -│ │ └── 2016-12-05-implicit-function-types.md -│ └── index.html -├── index.html -├── resources -│ └── my_file.pdf -├── images -│ └── my_image.png -└── sidebar.yml - +. +└── / + ├── _layouts_/ + │ └── ... + ├── _docs/ + │ └── ... + ├── _blog/ + │ ├── index.md + │ └── _posts/ + │ └── ... + └── _assets/ + ├── js/ + │ └── ... + ├── img/ + │ └── ... + └── ... ``` +It results in static site containing documents as well as blog. It also contains custom layouts and assets. The structure of rendered documentation can be based on file system but it can also be overriden by YAML configuration. -You can refer to the assets from within any of the files using markdown links: +### Mapping directory structure -``` -This is my blog post. Here is the image ![](my_image.png) and here is my [pdf](my_file.pdf)``` +Using YAML configuration file, we can define how the source directory structure should be transformed in target directory structure. + +Take a look at following subsection definition: +```yaml +- title: Some other subsection + index: abc/index.html + directory: custom-directory + subsection: + - page: abc2/page1.md + - page: foo/page2.md +``` +This subsection shows the ability of YAML configuration to map the directory structure. +Even though the index page and all defined children are in different directories, they will be rendered in `custom-directory`. From 6e2cf92d84dc4ee4290dc65cd83f2a4a4b250796 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Filip=20Zyba=C5=82a?= Date: Thu, 10 Mar 2022 09:05:31 +0100 Subject: [PATCH 1794/3075] Apply suggestions from review --- _overviews/scala3-scaladoc/static-site.md | 27 +++++++++++++---------- 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index d9d11f6bf6..127f6c59e7 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -101,7 +101,8 @@ Layouts must be placed in a `_layouts` directory in the site root: ├── _layouts │ └── main.html └── _docs - └── getting-started.md + ├── getting-started.md + └── index.html ``` ## Assets @@ -114,7 +115,7 @@ In order to render assets along with static site, they need to be placed in the └── _docs └── getting-started.md ``` -To reference the asset in a page, one need to create link relative to the `_assets` directory +To reference the asset on a page, one needs to create a link relative to the `_assets` directory ``` Take a look at the following image: [My image](images/myimage.png) @@ -122,7 +123,7 @@ Take a look at the following image: [My image](images/myimage.png) ## Sidebar -Scaladoc by default uses directory structure in `_docs` directory to organize static sites. There is also possibility to override it by providing a `sidebar.yml` file in the site root. The YAML configuration file describes the structure of rendered static site and the table of content: +By default, Scaladoc reflects the directory structure from `_docs` directory in the rendered site. There is also the ability to override it by providing a `sidebar.yml` file in the site root directory. The YAML configuration file describes the structure of the rendered static site and the table of content: ```yaml index: index.html @@ -144,20 +145,20 @@ Nesting subsections will result in a tree-like structure of navigation. `subsection` properties are: - `title` - Optional string - A default title of the subsection. Front-matter titles have higher priorities. - - `index` - Optional string - A path to index page of a subsection. - - `directory` - Optional string - A name of the directory that will contain the subsection. + - `index` - Optional string - A path to index page of a subsection. The path is relative to the `_docs` directory. + - `directory` - Optional string - A name of the directory that will contain the subsection in the generated site. By default, the directory name is the subsection name converted to kebab case. - `subsection` - Array of `subsection` or `page`. - Either `index` or `subsection` must be defined. The subsection defined with `index` and without `subsection` will contain pages and directories loaded recursively from directory of the index page. + Either `index` or `subsection` must be defined. The subsection defined with `index` and without `subsection` will contain pages and directories loaded recursively from the directory of the index page. `page` properties are: - `title` - Optional string - A default title of the page. Front-matter titles have higher priorities. - - `page` - String - A path to the page - - `hidden` - Optional boolean - A flag that indicates whether the page should be visible in navigation. By default, it is set to `false`. + - `page` - String - A path to the page, relative to the `_docs` directory. + - `hidden` - Optional boolean - A flag that indicates whether the page should be visible in the navigation sidebar. By default, it is set to `false`. -**Note**: All paths in YAML configuration file are relative to `/_docs`. +**Note**: All the paths in the YAML configuration file are relative to `/_docs`. ## Hierarchy of title @@ -200,13 +201,13 @@ Blog feature is described in [a separate document]({% link _overviews/scala3-sca │ └── ... └── ... ``` -It results in static site containing documents as well as blog. It also contains custom layouts and assets. The structure of rendered documentation can be based on file system but it can also be overriden by YAML configuration. +It results in a static site containing documents as well as a blog. It also contains custom layouts and assets. The structure of the rendered documentation can be based on the file system but it can also be overridden by YAML configuration. ### Mapping directory structure -Using YAML configuration file, we can define how the source directory structure should be transformed in target directory structure. +Using the YAML configuration file, we can define how the source directory structure should be transformed into an outputs directory structure. -Take a look at following subsection definition: +Take a look at the following subsection definition: ```yaml - title: Some other subsection index: abc/index.html @@ -217,3 +218,5 @@ Take a look at following subsection definition: ``` This subsection shows the ability of YAML configuration to map the directory structure. Even though the index page and all defined children are in different directories, they will be rendered in `custom-directory`. +The source page `abc/index.html` will generate a page `custom-directory/index.html`, the source page `abc2/page1.md` will generate a page `custom-directory/page1.html`, +and the source page `foo/page2.md` will generate a page `custom-directory/page2.html`. From 388973da5dfc75990bb00be1d15ea2bd217b8780 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 14 Mar 2022 14:12:50 +0100 Subject: [PATCH 1795/3075] list scala 3 releases in api/all --- api/all.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/api/all.md b/api/all.md index ddf77295f7..ea55e544d9 100644 --- a/api/all.md +++ b/api/all.md @@ -6,6 +6,8 @@ includeTOC: true ## Latest releases +* Scala 3.1.1 + * [Library API](https://www.scala-lang.org/api/3.1.1/) * Scala 2.13.8 * [Library API](https://www.scala-lang.org/api/2.13.8/) * [Compiler API](https://www.scala-lang.org/api/2.13.8/scala-compiler/scala/) @@ -58,6 +60,14 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.1.0 + * [Library API](https://www.scala-lang.org/api/3.1.0/) +* Scala 3.0.2 + * [Library API](https://www.scala-lang.org/api/3.0.2/) +* Scala 3.0.1 + * [Library API](https://www.scala-lang.org/api/3.0.1/) +* Scala 3.0.0 + * [Library API](https://www.scala-lang.org/api/3.0.0/) * Scala 2.13.7 * [Library API](https://www.scala-lang.org/api/2.13.7/) * [Compiler API](https://www.scala-lang.org/api/2.13.7/scala-compiler/scala/) From 5152494a70fb70694d0381474115e404d7e89317 Mon Sep 17 00:00:00 2001 From: TSLsun Date: Sat, 19 Mar 2022 11:10:20 +0800 Subject: [PATCH 1796/3075] fix compiling warnings in code example --- _tour/classes.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_tour/classes.md b/_tour/classes.md index 47b5079bc5..ee3dc33703 100644 --- a/_tour/classes.md +++ b/_tour/classes.md @@ -76,17 +76,17 @@ class Point { private var _y = 0 private val bound = 100 - def x = _x + def x: Int = _x def x_= (newValue: Int): Unit = { - if (newValue < bound) _x = newValue else printWarning + if (newValue < bound) _x = newValue else printWarning() } - def y = _y + def y: Int = _y def y_= (newValue: Int): Unit = { - if (newValue < bound) _y = newValue else printWarning + if (newValue < bound) _y = newValue else printWarning() } - private def printWarning = println("WARNING: Out of bounds") + private def printWarning(): Unit = println("WARNING: Out of bounds") } val point1 = new Point From 532dbc3f09686cedda3ac3cf8fd90986f5ffbe85 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 21 Mar 2022 11:51:25 +0100 Subject: [PATCH 1797/3075] enable collection contribute_resources change icons in contribute_resources --- _config.yml | 1 + _contribute_resources/1-documentation.md | 2 +- _contribute_resources/2-bug-fixes.md | 2 +- _contribute_resources/6-compiler-language.md | 2 +- 4 files changed, 4 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index ecd8829749..0d58e58a8f 100644 --- a/_config.yml +++ b/_config.yml @@ -20,6 +20,7 @@ scala-212-version: 2.12.15 scala-3-version: 3.1.1 collections: + contribute_resources: style: output: true overviews: diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md index b39290a394..431c4e0ab1 100644 --- a/_contribute_resources/1-documentation.md +++ b/_contribute_resources/1-documentation.md @@ -1,6 +1,6 @@ --- title: Documentation link: /contribute/documentation.html -icon: fa fa-file-text +icon: fa fa-book --- [Scaladoc (API)](/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](https://docs.scala-lang.org/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). diff --git a/_contribute_resources/2-bug-fixes.md b/_contribute_resources/2-bug-fixes.md index cca6269e06..54e6d2cf9d 100644 --- a/_contribute_resources/2-bug-fixes.md +++ b/_contribute_resources/2-bug-fixes.md @@ -1,6 +1,6 @@ --- title: Bug fixes link: /contribute/guide.html -icon: fa fa-pencil +icon: fa fa-bug --- Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/contribute/bug-reporting-guide.html). diff --git a/_contribute_resources/6-compiler-language.md b/_contribute_resources/6-compiler-language.md index fcfea35d5a..d54e34fac9 100644 --- a/_contribute_resources/6-compiler-language.md +++ b/_contribute_resources/6-compiler-language.md @@ -1,6 +1,6 @@ --- title: Compiler/Language link: /contribute/guide.html#larger-changes-new-features -icon: fa fa-gears +icon: fa fa-cogs --- Larger language features and compiler enhancements including language specification and SIPs. From d9c44ebf1f469c7d8ed2b46c2a38f0940569b6e2 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 21 Mar 2022 13:13:26 +0100 Subject: [PATCH 1798/3075] prepare for move files --- contribute/bug-reporting-guide.md | 4 ++-- contribute/codereviews.md | 2 +- contribute/corelibs.md | 2 +- contribute/documentation.md | 2 +- contribute/guide.md | 2 +- contribute/hacker-guide.md | 2 +- contribute/index.md | 2 +- contribute/partest-guide.md | 4 ++-- contribute/scala-internals.md | 2 +- contribute/scala-standard-library-api-documentation.md | 2 +- contribute/tools.md | 2 +- 11 files changed, 13 insertions(+), 13 deletions(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 88317da0ce..d4588de422 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -1,8 +1,8 @@ --- -title: Bug Reporting +title: Bug Reporting Guide layout: inner-page-no-masthead -# permalink: /contribute/bug-reporting-guide/ includeTOC: true +permalink: /contribute/bug-reporting-guide.html --- The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. diff --git a/contribute/codereviews.md b/contribute/codereviews.md index 6e0a2592b6..860ba65884 100644 --- a/contribute/codereviews.md +++ b/contribute/codereviews.md @@ -1,8 +1,8 @@ --- title: Code Review Contributions layout: inner-page-no-masthead -# permalink: /contribute/codereviews/ includeTOC: true +permalink: /contribute/codereviews.html --- ## Code Review Contributions diff --git a/contribute/corelibs.md b/contribute/corelibs.md index 6b2cc5d95f..4f10208334 100644 --- a/contribute/corelibs.md +++ b/contribute/corelibs.md @@ -1,8 +1,8 @@ --- title: Core Library Contributions layout: inner-page-no-masthead -# permalink: /contribute/corelibs/ includeTOC: true +permalink: /contribute/corelibs.html --- ## Core Library Contributions diff --git a/contribute/documentation.md b/contribute/documentation.md index 967806de42..b8ea229f93 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -1,8 +1,8 @@ --- title: Documentation Contributions layout: inner-page-no-masthead -# permalink: /contribute/documentation/ includeTOC: true +permalink: /contribute/documentation.html --- ## Contributing Documentation to the Scala project diff --git a/contribute/guide.md b/contribute/guide.md index 7e4f375005..c10a5c20c1 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -1,8 +1,8 @@ --- title: Contributing guide layout: inner-page-no-masthead -# permalink: /contribute/guide/ includeTOC: true +permalink: /contribute/guide.html ---
    diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 302635fae1..990754e3df 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -2,8 +2,8 @@ title: Scala hacker guide by: Eugene Burmako layout: inner-page-no-masthead -# permalink: /contribute/hacker-guide/ includeTOC: true +permalink: /contribute/hacker-guide.html ---
    This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea. diff --git a/contribute/index.md b/contribute/index.md index d78a72e159..d4bc7069a2 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -1,8 +1,8 @@ --- title: Contribute layout: inner-page-no-masthead -# permalink: /contribute/ includeTOC: true +permalink: /contribute/ --- The Scala programming language is an open source project with a very diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md index e7e10621e1..d55c02e884 100644 --- a/contribute/partest-guide.md +++ b/contribute/partest-guide.md @@ -1,8 +1,8 @@ --- title: Running the Test Suite layout: inner-page-no-masthead -# permalink: /contribute/partest-guide/ includeTOC: true +permalink: /contribute/partest-guide.html --- Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go to the scala project folder from your local checkout and run it via `sbt`, `ant` or standalone as follows. @@ -35,7 +35,7 @@ The test suite can be run by using ant from the command line: Please note the standalone scripts mentioned below were removed in 2.12.2. sbt is the preferred way to run the test suite. -There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use +There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use ./test/partest --show-diff --show-log --failed diff --git a/contribute/scala-internals.md b/contribute/scala-internals.md index e6fde53a81..b380525088 100644 --- a/contribute/scala-internals.md +++ b/contribute/scala-internals.md @@ -1,8 +1,8 @@ --- title: Scala Internals Mailing List layout: inner-page-no-masthead -permalink: /contribute/scala-internals/ includeTOC: true +permalink: /contribute/scala-internals/ --- ## scala-internals diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index 6f3af62b30..2700d2fd11 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -1,8 +1,8 @@ --- title: Contribute to API Documentation layout: inner-page-no-masthead -# permalink: /contribute/scala-standard-library-api-documentation.html includeTOC: true +permalink: /contribute/scala-standard-library-api-documentation.html --- This page is specific to API documentation contributions – that is, API diff --git a/contribute/tools.md b/contribute/tools.md index 0afd3982d8..a76d0b90bd 100644 --- a/contribute/tools.md +++ b/contribute/tools.md @@ -1,8 +1,8 @@ --- title: IDE and Build Tool Contributions layout: inner-page-no-masthead -# permalink: /contribute/tools/ includeTOC: true +permalink: /contribute/tools.html # Projects list: projects: From 30735654a67e967f41a9c7162b64846f2050f5ae Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 21 Mar 2022 13:14:45 +0100 Subject: [PATCH 1799/3075] move contribute files --- {contribute => _overviews/contribute}/bug-reporting-guide.md | 0 {contribute => _overviews/contribute}/codereviews.md | 0 {contribute => _overviews/contribute}/corelibs.md | 0 {contribute => _overviews/contribute}/documentation.md | 0 {contribute => _overviews/contribute}/guide.md | 0 {contribute => _overviews/contribute}/hacker-guide.md | 0 {contribute => _overviews/contribute}/inclusive-language-guide.md | 0 {contribute => _overviews/contribute}/index.md | 0 {contribute => _overviews/contribute}/partest-guide.md | 0 {contribute => _overviews/contribute}/scala-internals.md | 0 .../contribute}/scala-standard-library-api-documentation.md | 0 {contribute => _overviews/contribute}/tools.md | 0 12 files changed, 0 insertions(+), 0 deletions(-) rename {contribute => _overviews/contribute}/bug-reporting-guide.md (100%) rename {contribute => _overviews/contribute}/codereviews.md (100%) rename {contribute => _overviews/contribute}/corelibs.md (100%) rename {contribute => _overviews/contribute}/documentation.md (100%) rename {contribute => _overviews/contribute}/guide.md (100%) rename {contribute => _overviews/contribute}/hacker-guide.md (100%) rename {contribute => _overviews/contribute}/inclusive-language-guide.md (100%) rename {contribute => _overviews/contribute}/index.md (100%) rename {contribute => _overviews/contribute}/partest-guide.md (100%) rename {contribute => _overviews/contribute}/scala-internals.md (100%) rename {contribute => _overviews/contribute}/scala-standard-library-api-documentation.md (100%) rename {contribute => _overviews/contribute}/tools.md (100%) diff --git a/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md similarity index 100% rename from contribute/bug-reporting-guide.md rename to _overviews/contribute/bug-reporting-guide.md diff --git a/contribute/codereviews.md b/_overviews/contribute/codereviews.md similarity index 100% rename from contribute/codereviews.md rename to _overviews/contribute/codereviews.md diff --git a/contribute/corelibs.md b/_overviews/contribute/corelibs.md similarity index 100% rename from contribute/corelibs.md rename to _overviews/contribute/corelibs.md diff --git a/contribute/documentation.md b/_overviews/contribute/documentation.md similarity index 100% rename from contribute/documentation.md rename to _overviews/contribute/documentation.md diff --git a/contribute/guide.md b/_overviews/contribute/guide.md similarity index 100% rename from contribute/guide.md rename to _overviews/contribute/guide.md diff --git a/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md similarity index 100% rename from contribute/hacker-guide.md rename to _overviews/contribute/hacker-guide.md diff --git a/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md similarity index 100% rename from contribute/inclusive-language-guide.md rename to _overviews/contribute/inclusive-language-guide.md diff --git a/contribute/index.md b/_overviews/contribute/index.md similarity index 100% rename from contribute/index.md rename to _overviews/contribute/index.md diff --git a/contribute/partest-guide.md b/_overviews/contribute/partest-guide.md similarity index 100% rename from contribute/partest-guide.md rename to _overviews/contribute/partest-guide.md diff --git a/contribute/scala-internals.md b/_overviews/contribute/scala-internals.md similarity index 100% rename from contribute/scala-internals.md rename to _overviews/contribute/scala-internals.md diff --git a/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md similarity index 100% rename from contribute/scala-standard-library-api-documentation.md rename to _overviews/contribute/scala-standard-library-api-documentation.md diff --git a/contribute/tools.md b/_overviews/contribute/tools.md similarity index 100% rename from contribute/tools.md rename to _overviews/contribute/tools.md From db3d07ea0ff961fd5000fe4adf99491b6a01645e Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 21 Mar 2022 13:27:32 +0100 Subject: [PATCH 1800/3075] convert to multipage overview --- _overviews/contribute/bug-reporting-guide.md | 6 ++++-- _overviews/contribute/codereviews.md | 6 ++++-- _overviews/contribute/corelibs.md | 6 ++++-- _overviews/contribute/documentation.md | 6 ++++-- _overviews/contribute/guide.md | 6 ++++-- _overviews/contribute/hacker-guide.md | 6 ++++-- _overviews/contribute/inclusive-language-guide.md | 6 ++++-- _overviews/contribute/index.md | 6 ++++-- _overviews/contribute/partest-guide.md | 6 ++++-- _overviews/contribute/scala-internals.md | 6 ++++-- .../contribute/scala-standard-library-api-documentation.md | 6 ++++-- _overviews/contribute/tools.md | 6 ++++-- 12 files changed, 48 insertions(+), 24 deletions(-) diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index d4588de422..3e358a30f0 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -1,7 +1,9 @@ --- title: Bug Reporting Guide -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 7 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/bug-reporting-guide.html --- diff --git a/_overviews/contribute/codereviews.md b/_overviews/contribute/codereviews.md index 860ba65884..5b5a4a4697 100644 --- a/_overviews/contribute/codereviews.md +++ b/_overviews/contribute/codereviews.md @@ -1,7 +1,9 @@ --- title: Code Review Contributions -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 3 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/codereviews.html --- ## Code Review Contributions diff --git a/_overviews/contribute/corelibs.md b/_overviews/contribute/corelibs.md index 4f10208334..984f8c4f7c 100644 --- a/_overviews/contribute/corelibs.md +++ b/_overviews/contribute/corelibs.md @@ -1,7 +1,9 @@ --- title: Core Library Contributions -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 4 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/corelibs.html --- ## Core Library Contributions diff --git a/_overviews/contribute/documentation.md b/_overviews/contribute/documentation.md index b8ea229f93..01cd8a5c15 100644 --- a/_overviews/contribute/documentation.md +++ b/_overviews/contribute/documentation.md @@ -1,7 +1,9 @@ --- title: Documentation Contributions -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 5 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/documentation.html --- ## Contributing Documentation to the Scala project diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index c10a5c20c1..7cafd3d8a3 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -1,7 +1,9 @@ --- title: Contributing guide -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 9 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/guide.html --- diff --git a/_overviews/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md index 990754e3df..df659678cb 100644 --- a/_overviews/contribute/hacker-guide.md +++ b/_overviews/contribute/hacker-guide.md @@ -1,8 +1,10 @@ --- title: Scala hacker guide by: Eugene Burmako -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 11 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/hacker-guide.html ---
    diff --git a/_overviews/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md index 6703532594..d673d57ad8 100644 --- a/_overviews/contribute/inclusive-language-guide.md +++ b/_overviews/contribute/inclusive-language-guide.md @@ -1,7 +1,9 @@ --- title: Inclusive Language Guide -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 2 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/inclusive-language/ --- diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index d4bc7069a2..ac513b0009 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -1,7 +1,9 @@ --- title: Contribute -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 1 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/ --- diff --git a/_overviews/contribute/partest-guide.md b/_overviews/contribute/partest-guide.md index d55c02e884..8f4dff394b 100644 --- a/_overviews/contribute/partest-guide.md +++ b/_overviews/contribute/partest-guide.md @@ -1,7 +1,9 @@ --- title: Running the Test Suite -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 12 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/partest-guide.html --- diff --git a/_overviews/contribute/scala-internals.md b/_overviews/contribute/scala-internals.md index b380525088..f52faa5c18 100644 --- a/_overviews/contribute/scala-internals.md +++ b/_overviews/contribute/scala-internals.md @@ -1,7 +1,9 @@ --- title: Scala Internals Mailing List -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 8 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/scala-internals/ --- diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md index 2700d2fd11..97e3d708f9 100644 --- a/_overviews/contribute/scala-standard-library-api-documentation.md +++ b/_overviews/contribute/scala-standard-library-api-documentation.md @@ -1,7 +1,9 @@ --- title: Contribute to API Documentation -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 6 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/scala-standard-library-api-documentation.html --- diff --git a/_overviews/contribute/tools.md b/_overviews/contribute/tools.md index a76d0b90bd..6df7c454a9 100644 --- a/_overviews/contribute/tools.md +++ b/_overviews/contribute/tools.md @@ -1,7 +1,9 @@ --- title: IDE and Build Tool Contributions -layout: inner-page-no-masthead -includeTOC: true +layout: multipage-overview +num: 10 +partof: scala-contribution +overview-name: Contributing to Scala permalink: /contribute/tools.html # Projects list: From c692ad3ab96c94ea22c9f5e99e0cabcccd76489b Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 21 Mar 2022 13:59:30 +0100 Subject: [PATCH 1801/3075] migrate urls to /overviews/contribute fix broken links --- _contribute_resources/1-documentation.md | 4 +-- _contribute_resources/2-bug-fixes.md | 4 +-- _contribute_resources/3-code-reviews.md | 6 ++-- _contribute_resources/4-core-libraries.md | 2 +- .../5-ide-and-build-tools.md | 2 +- _contribute_resources/6-compiler-language.md | 2 +- _overviews/contribute/bug-reporting-guide.md | 1 - _overviews/contribute/codereviews.md | 7 ++-- _overviews/contribute/corelibs.md | 7 ++-- _overviews/contribute/documentation.md | 11 +++---- _overviews/contribute/guide.md | 33 +++++++++---------- _overviews/contribute/hacker-guide.md | 11 +++---- .../contribute/inclusive-language-guide.md | 3 +- _overviews/contribute/index.md | 9 +++-- _overviews/contribute/partest-guide.md | 1 - _overviews/contribute/scala-internals.md | 1 - ...cala-standard-library-api-documentation.md | 7 ++-- _overviews/contribute/tools.md | 7 ++-- 18 files changed, 53 insertions(+), 65 deletions(-) diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md index 431c4e0ab1..3e1b81a7b9 100644 --- a/_contribute_resources/1-documentation.md +++ b/_contribute_resources/1-documentation.md @@ -1,6 +1,6 @@ --- title: Documentation -link: /contribute/documentation.html +link: /overviews/contribute/documentation.html icon: fa fa-book --- -[Scaladoc (API)](/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](https://docs.scala-lang.org/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). +[Scaladoc (API)](/overviews/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). diff --git a/_contribute_resources/2-bug-fixes.md b/_contribute_resources/2-bug-fixes.md index 54e6d2cf9d..2baf672e5a 100644 --- a/_contribute_resources/2-bug-fixes.md +++ b/_contribute_resources/2-bug-fixes.md @@ -1,6 +1,6 @@ --- title: Bug fixes -link: /contribute/guide.html +link: /overviews/contribute/guide.html icon: fa fa-bug --- -Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/contribute/bug-reporting-guide.html). +Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/overviews/contribute/bug-reporting-guide.html). diff --git a/_contribute_resources/3-code-reviews.md b/_contribute_resources/3-code-reviews.md index 2fc057eb0d..41f6821414 100644 --- a/_contribute_resources/3-code-reviews.md +++ b/_contribute_resources/3-code-reviews.md @@ -1,8 +1,8 @@ --- title: Code Reviews -link: /contribute/codereviews.html +link: /overviews/contribute/codereviews.html icon: fa fa-eye --- -Review pull requests against [scala/scala](https://github.com/scala/scala/pulls), -[scala/scala-lang](https://github.com/scala/scala-lang/pulls), +Review pull requests against [scala/scala](https://github.com/scala/scala/pulls), +[scala/scala-lang](https://github.com/scala/scala-lang/pulls), [scala/docs.scala-lang](https://github.com/scala/docs.scala-lang/pulls) and others. diff --git a/_contribute_resources/4-core-libraries.md b/_contribute_resources/4-core-libraries.md index 06f1018479..fb66a906b8 100644 --- a/_contribute_resources/4-core-libraries.md +++ b/_contribute_resources/4-core-libraries.md @@ -1,6 +1,6 @@ --- title: Core Libraries -link: /contribute/corelibs.html +link: /overviews/contribute/corelibs.html icon: fa fa-clipboard --- Update and expand the capabilities of the core (and associated) Scala libraries. diff --git a/_contribute_resources/5-ide-and-build-tools.md b/_contribute_resources/5-ide-and-build-tools.md index 7202f0d953..2bf2c7d729 100644 --- a/_contribute_resources/5-ide-and-build-tools.md +++ b/_contribute_resources/5-ide-and-build-tools.md @@ -1,6 +1,6 @@ --- title: IDE and Build Tools -link: /contribute/tools.html +link: /overviews/contribute/tools.html icon: fa fa-terminal --- Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects. diff --git a/_contribute_resources/6-compiler-language.md b/_contribute_resources/6-compiler-language.md index d54e34fac9..a7dc618322 100644 --- a/_contribute_resources/6-compiler-language.md +++ b/_contribute_resources/6-compiler-language.md @@ -1,6 +1,6 @@ --- title: Compiler/Language -link: /contribute/guide.html#larger-changes-new-features +link: /overviews/contribute/guide.html#larger-changes-new-features icon: fa fa-cogs --- Larger language features and compiler enhancements including language specification and SIPs. diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 3e358a30f0..5cbf0a3f46 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 7 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/bug-reporting-guide.html --- The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. diff --git a/_overviews/contribute/codereviews.md b/_overviews/contribute/codereviews.md index 5b5a4a4697..368bf96793 100644 --- a/_overviews/contribute/codereviews.md +++ b/_overviews/contribute/codereviews.md @@ -4,11 +4,10 @@ layout: multipage-overview num: 3 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/codereviews.html --- ## Code Review Contributions -In addition to [bug fixing](/contribute/guide.html), you can help us review +In addition to [bug fixing](/overviews/contribute/guide.html), you can help us review [waiting pull requests](#pull-requests-awaiting-comment). This is also a good (and recommended) way to get to know the feel of the bug-fixing and submissions process before jumping in with your @@ -17,7 +16,7 @@ own pull requests. ### Review Guidelines -[Code of Conduct reminder]({{ site.baseurl }}/conduct.html) +[Code of Conduct reminder](https://scala-lang.org/conduct.html) * Keep comments on-topic, concise and precise. * Attach comments to particular lines or regions they pertain to whenever possible. @@ -53,4 +52,4 @@ own pull requests.
    -Also note that the [Tools contributions](/contribute/tools.html) page has more projects that will generate pull requests. +Also note that the [Tools contributions](/overviews/contribute/tools.html) page has more projects that will generate pull requests. diff --git a/_overviews/contribute/corelibs.md b/_overviews/contribute/corelibs.md index 984f8c4f7c..6c64a887d7 100644 --- a/_overviews/contribute/corelibs.md +++ b/_overviews/contribute/corelibs.md @@ -4,15 +4,14 @@ layout: multipage-overview num: 4 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/corelibs.html --- ## Core Library Contributions There are several options for contributing to Scala's core libraries. You can: -* Help with [Documentation](/contribute/documentation.html). -* [Report Bugs or Issues](/contribute/bug-reporting-guide.html) against the core libraries. -* [Fix Bugs or Issues](/contribute/guide.html) against the +* Help with [Documentation](/overviews/contribute/documentation.html). +* [Report Bugs or Issues](/overviews/contribute/bug-reporting-guide.html) against the core libraries. +* [Fix Bugs or Issues](/overviews/contribute/guide.html) against the [reported library bugs/issues](https://github.com/scala/bug). ### Significant changes diff --git a/_overviews/contribute/documentation.md b/_overviews/contribute/documentation.md index 01cd8a5c15..7fca82ff53 100644 --- a/_overviews/contribute/documentation.md +++ b/_overviews/contribute/documentation.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 5 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/documentation.html --- ## Contributing Documentation to the Scala project @@ -24,11 +23,11 @@ Thanks The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: -* [Log issues for missing scaladoc documentation](/contribute/scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - +* [Log issues for missing scaladoc documentation](/overviews/contribute/scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - Please *follow the issue submission process closely* to help prevent duplicate issues being created. -* [Claim Scaladoc Issues and Provide Documentation](/contribute/scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. +* [Claim Scaladoc Issues and Provide Documentation](/overviews/contribute/scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. * You can also just -[submit new Scaladoc](/contribute/scala-standard-library-api-documentation.html) +[submit new Scaladoc](/overviews/contribute/scala-standard-library-api-documentation.html) without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on [Scala Contributors](https://contributors.scala-lang.org/) so that people know what you are doing. ### The Main Scala Documentation Site @@ -45,7 +44,7 @@ without creating an issue, but please look to see if there is an issue already s * SIP (Scala Improvement Process) Proposals and more -Please read [contributing to the docs.scala-lang.org site](https://docs.scala-lang.org/contribute.html) through before embarking on changes. The site uses +Please read [contributing to the docs.scala-lang.org site](/contribute.html) through before embarking on changes. The site uses the [Jekyll](https://jekyllrb.com/) markdown engine so you will need to follow the instructions to get that running as well. ### Updating scala-lang.org @@ -56,4 +55,4 @@ to Scala and related projects) is provided on the main [scala-lang GitHub project](https://github.com/scala/scala-lang) which may be forked to create pull requests. Please read both the -[docs.scala-lang.org contribution](https://docs.scala-lang.org/contribute.html) document and the [scala-lang.org GitHub README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. +[docs.scala-lang.org contribution](/contribute.html) document and the [scala-lang.org GitHub README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index 7cafd3d8a3..0b5b146ffc 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 9 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/guide.html ---
    @@ -14,18 +13,18 @@ permalink: /contribute/guide.html

    Get a peek into the inners of the Scala compiler.

    -

    Report an issue

    +

    Report an issue

    File a bug report or a feature request.

    -

    Community issues

    +

    Community issues

    Get cracking on some easy to approach issues.

    -

    Hacker guide

    +

    Hacker guide

    Learn to write good code and improve your chances of contributing to the Scala galaxy.

    @@ -56,22 +55,22 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [GitHub branch](https://github.com/scala/scala) -1. [Select a bug to fix from GitHub](/contribute/#community-tickets), or if you found the bug yourself and want to fix it, [create a GitHub issue](/contribute/bug-reporting-guide.html) (but please -[make sure it's not a duplicate](/contribute/bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). -2. Optional ([but recommended](/contribute/scala-internals/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with -[these friendly people](/contribute/hacker-guide.html#1-connect) - it's one of the perks of contributing. -3. [Fork the Scala repository](/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). -4. [Create a feature branch](/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the GitHub issue number. -5. [Fix the bug, or implement the new small feature](/contribute/hacker-guide.html#implement), include new tests (yes, for bug fixes too). -6. [Test, rinse](/contribute/hacker-guide.html#test) and [test some more](/contribute/partest-guide.html) until [all the tests pass](/contribute/hacker-guide.html#verify). -7. [Commit your changes](/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. +1. [Select a bug to fix from GitHub](/overviews/contribute/index.html#community-tickets), or if you found the bug yourself and want to fix it, [create a GitHub issue](/overviews/contribute/bug-reporting-guide.html) (but please +[make sure it's not a duplicate](/overviews/contribute/bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). +2. Optional ([but recommended](/overviews/contribute/scala-internals.html/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with +[these friendly people](/overviews/contribute/hacker-guide.html#1-connect) - it's one of the perks of contributing. +3. [Fork the Scala repository](/overviews/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). +4. [Create a feature branch](/overviews/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the GitHub issue number. +5. [Fix the bug, or implement the new small feature](/overviews/contribute/hacker-guide.html#implement), include new tests (yes, for bug fixes too). +6. [Test, rinse](/overviews/contribute/hacker-guide.html#test) and [test some more](/overviews/contribute/partest-guide.html) until [all the tests pass](/overviews/contribute/hacker-guide.html#verify). +7. [Commit your changes](/overviews/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. 8. If necessary [re-write git history](https://git-scm.com/book/en/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) -9. [Submit a pull request](./hacker-guide.html#submit). -10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/contribute/hacker-guide.html#review). +9. [Submit a pull request](/overviews/contribute/hacker-guide.html#submit). +10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/overviews/contribute/hacker-guide.html#review). 11. Celebrate! -Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide](./hacker-guide.html) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). +Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide](/overviews/contribute/hacker-guide.html) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). ### Larger Changes, New Features @@ -80,4 +79,4 @@ and on the implementation plan. Announce the change on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](https://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list and if a SIP is required, that will be discussed on the mailing list. Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against -the Scala project source tree. The [hacker guide](/contribute/hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. +the Scala project source tree. The [hacker guide](/overviews/contribute/hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. diff --git a/_overviews/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md index df659678cb..cb83b6218a 100644 --- a/_overviews/contribute/hacker-guide.md +++ b/_overviews/contribute/hacker-guide.md @@ -5,7 +5,6 @@ layout: multipage-overview num: 11 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/hacker-guide.html ---
    This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea. @@ -32,7 +31,7 @@ Sometimes it's appealing to hack alone and not to have to interact with others o this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. -Typically bug fixes and new features start out as an idea or an experiment posted on one of [our mailing lists]({{ site.baseurl }}/community/index.html#forums) to find out how people feel +Typically bug fixes and new features start out as an idea or an experiment posted on one of [our mailing lists](https://scala-lang.org/community/index.html#forums) to find out how people feel about things you want to implement. People proficient in certain areas of Scala usually monitor mailing lists, so you'll often get some help by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. @@ -200,7 +199,7 @@ Contributing to the Scala standard library is about the same as working on one o If documentation is necessary for some trait/class/object/method/etc in the Scala standard library, typically maintainers will include inline comments describing their design decisions or rationale for implementing things the way they have, if it is not straightforward. -If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections](https://docs.scala-lang.org/overviews/core/architecture-of-scala-collections.html), as well as a larger more general [Scala collections Guide](https://docs.scala-lang.org/overviews/collections/introduction.html) covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide](https://docs.scala-lang.org/overviews/parallel-collections/overview.html). +If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections](/overviews/core/architecture-of-scala-collections.html), as well as a larger more general [Scala collections Guide](/overviews/collections/introduction.html) covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide](/overviews/parallel-collections/overview.html). ##### The Scala Compiler @@ -208,7 +207,7 @@ Documentation about the internal workings of the Scala compiler is scarce, and m * [Compiler internals videos by Martin Odersky](https://www.scala-lang.org/old/node/598.html) are quite dated, but still very useful. In this three-video series Martin explains the general architecture of the compiler, and the basics of the front-end, which has recently become Scala reflection API. -* [Reflection documentation](https://docs.scala-lang.org/overviews/reflection/overview.html) describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that +* [Reflection documentation](/overviews/reflection/overview.html) describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that are used to represent Scala programs and operations defined on then. Since much of the compiler has been factored out and made accessible via the Reflection API, all of the fundamentals needed for reflection are the same for the compiler. * [Reflection and Compilers by Martin Odersky](https://channel9.msdn.com/Events/Lang-NEXT/Lang-NEXT-2012/Reflection-and-Compilers), a talk at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the architecture of the reflection API. @@ -266,7 +265,7 @@ Adding tests to the test suite is as easy as moving them to the appropriate dire * Code which should compile successfully, but doesn't need to be executed, needs to go into the [“pos” directory](https://github.com/scala/scala/tree/2.12.x/test/files/pos). * Code which should not compile needs to go into the [“neg” directory](https://github.com/scala/scala/tree/2.12.x/test/files/neg). -* Code which should compile and get executed by the test suite needs to go into the [“run” directory](https://github.com/scala/scala/tree/2.12.x/test/files/run) and have a corresponding `.check` file with the expected output. You will get test failures if the content of a `.check` file is different from what the test produces while running. If the change in the output is an expected product of your work, you might not want to change the `.check` file by hand. To make partest change the `.check` file, run it with a `--update-check` flag, like so `./test/partest --update-check path/to/test.scala`. For more information on partest, please refer to its [documentation](https://docs.scala-lang.org/tutorials/partest-guide.html). +* Code which should compile and get executed by the test suite needs to go into the [“run” directory](https://github.com/scala/scala/tree/2.12.x/test/files/run) and have a corresponding `.check` file with the expected output. You will get test failures if the content of a `.check` file is different from what the test produces while running. If the change in the output is an expected product of your work, you might not want to change the `.check` file by hand. To make partest change the `.check` file, run it with a `--update-check` flag, like so `./test/partest --update-check path/to/test.scala`. For more information on partest, please refer to its [documentation](https://github.com/scala/scala-partest). * Everything that can be unit-tested should go to ["junit" directory](https://github.com/scala/scala/tree/2.12.x/test/junit) * Property-based tests go to the ["scalacheck" directory](https://github.com/scala/scala/tree/2.12.x/test/scalacheck) @@ -311,7 +310,7 @@ This means your change is backward or forward binary incompatible with the speci ### Verify -Now to make sure that my fix doesn't break anything I need to run the test suite. The Scala test suite uses [JUnit](https://junit.org/junit4/) and [partest](partest-guide.html), a tool we wrote for testing Scala. +Now to make sure that my fix doesn't break anything I need to run the test suite. The Scala test suite uses [JUnit](https://junit.org/junit4/) and [partest](/overviews/contribute/partest-guide.html), a tool we wrote for testing Scala. Run `sbt test` and `sbt partest` to run all of the JUnit and partest tests, respectively. `partest` (not `sbt partest`) also allows you to run a subset of the tests using wildcards: diff --git a/_overviews/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md index d673d57ad8..7f7c428f42 100644 --- a/_overviews/contribute/inclusive-language-guide.md +++ b/_overviews/contribute/inclusive-language-guide.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 2 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/inclusive-language/ --- We are committed to providing a friendly, safe and welcoming environment for @@ -131,4 +130,4 @@ In those cases, we recommend to keep the old names, but document (e.g., in Scala ## See also -* Our [code of conduct](../../conduct/). +* Our [code of conduct](https://scala-lang.org/conduct/). diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index ac513b0009..8b7dad1e83 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 1 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/ --- The Scala programming language is an open source project with a very @@ -19,7 +18,7 @@ That depends on what you want to contribute. Below are some getting started reso ### Reporting bugs -See our [bug reporting guide](/contribute/bug-reporting-guide.html) to learn +See our [bug reporting guide](/overviews/contribute/bug-reporting-guide.html) to learn how to efficiently report a bug. ### Contribute @@ -33,8 +32,8 @@ Coordination of contribution efforts takes place on When contributing, please follow: -* The [Scala Code of Conduct](../conduct/) -* The [Inclusive Language Guide](./inclusive-language/) +* The [Scala Code of Conduct](https://scala-lang.org/conduct/) +* The [Inclusive Language Guide](/overviews/contribute/inclusive-language-guide.html) ### Community Tickets @@ -48,7 +47,7 @@ with their own maintainers and community of contributors. Helping out one of these projects is another way to help Scala. Consider lending on a hand on a project you're already using. Or, to find out about other projects, see the -[Libraries and Tools section](/community/#community-libraries-and-tools) +[Libraries and Tools section](https://scala-lang.org/community/#community-libraries-and-tools) on our Community page. ### Scala Community Build diff --git a/_overviews/contribute/partest-guide.md b/_overviews/contribute/partest-guide.md index 8f4dff394b..6fb5a2644b 100644 --- a/_overviews/contribute/partest-guide.md +++ b/_overviews/contribute/partest-guide.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 12 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/partest-guide.html --- Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go to the scala project folder from your local checkout and run it via `sbt`, `ant` or standalone as follows. diff --git a/_overviews/contribute/scala-internals.md b/_overviews/contribute/scala-internals.md index f52faa5c18..82346bcb15 100644 --- a/_overviews/contribute/scala-internals.md +++ b/_overviews/contribute/scala-internals.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 8 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/scala-internals/ --- ## scala-internals diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md index 97e3d708f9..977e733528 100644 --- a/_overviews/contribute/scala-standard-library-api-documentation.md +++ b/_overviews/contribute/scala-standard-library-api-documentation.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 6 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/scala-standard-library-api-documentation.html --- This page is specific to API documentation contributions – that is, API @@ -13,8 +12,8 @@ documentation for sometimes referred to as Scaladoc contributions. For contributions to tutorial and guide-style documentation on -[docs.scala-lang.org](https://docs.scala-lang.org), -see the ["doc-site"'s contribution guide](https://docs.scala-lang.org/contribute.html). +[docs.scala-lang.org](/), +see the ["doc-site"'s contribution guide](/contribute.html). *Please note, these instructions cover documentation contributions Scala core libraries only. For other Scala projects please check those projects for the @@ -79,7 +78,7 @@ component so that they show up in the correct issue filters. Please familiarize yourself with the following before contributing new API documentation to save time, effort, mistakes and repetition. -* [Forking the Repo](./hacker-guide.html#2-set-up) - follow the setup steps through +* [Forking the Repo](/overviews/contribute/hacker-guide.html#2-set-up) - follow the setup steps through the Branch section. If providing new documentation related to an existing GitHub issue, use `issue/NNNN` or `ticket/NNNN` as the guide states. If providing API documentation with no associated GitHub issue, use `scaladoc/xxxx` instead. diff --git a/_overviews/contribute/tools.md b/_overviews/contribute/tools.md index 6df7c454a9..b7ae46b9ed 100644 --- a/_overviews/contribute/tools.md +++ b/_overviews/contribute/tools.md @@ -4,7 +4,6 @@ layout: multipage-overview num: 10 partof: scala-contribution overview-name: Contributing to Scala -permalink: /contribute/tools.html # Projects list: projects: @@ -23,7 +22,7 @@ projects: homeLink: https://www.scala-lang.org/api issuesLink: https://github.com/scala/bug/labels/scaladoc readmeLink: https://github.com/scala/scala#welcome - contributingLink: https://scala-lang.org/contribute/guide.html + contributingLink: /overviews/contribute/guide.html - title: Scala IDE description: Interactive build tool. icon: https://avatars2.githubusercontent.com/u/1026788?v=3&s=200 @@ -70,7 +69,7 @@ projectsInNeed: The links below are to a number of Scala build and IDE related projects that are important in the larger Scala space, and which welcome contributions. -Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](/contribute/hacker-guide.html) and [Bug-fixing](/contribute/guide.html) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. +Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](/overviews/contribute/hacker-guide.html) and [Bug-fixing](/overviews/contribute/guide.html) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. Typically, issues for these projects will be reported and kept in the GitHub project issue tracker for that project rather than in the Scala bug tracker. @@ -82,7 +81,7 @@ if you would like to help revive them. ### Broken Links? -Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/contribute/documentation.html#updating-scala-langorg) to fix it. +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/overviews/contribute/documentation.html#updating-scala-langorg) to fix it. ### Projects From 9d9f0968e4635dc5eaf74cc0053b091e22eb2811 Mon Sep 17 00:00:00 2001 From: Antoine Pointeau Date: Mon, 21 Mar 2022 14:04:32 +0100 Subject: [PATCH 1802/3075] Translation for fr/extractor-objects (#2268) --- _fr/tour/extractor-objects.md | 58 +++++++++++++++++++++++++++++++++-- 1 file changed, 56 insertions(+), 2 deletions(-) diff --git a/_fr/tour/extractor-objects.md b/_fr/tour/extractor-objects.md index ac5c1dc013..9ffc529a58 100644 --- a/_fr/tour/extractor-objects.md +++ b/_fr/tour/extractor-objects.md @@ -3,10 +3,64 @@ layout: tour title: Extractor Objects partof: scala-tour -num: 14 +num: 18 language: fr -next-page: generic-classes +next-page: for-comprehensions previous-page: regular-expression-patterns --- + +Un objet extracteur est un objet avec une méthode `unapply`. Tandis que la méthode `apply` ressemble à un constructeur qui prend des arguments et crée un objet, `unapply` prend un object et essaye de retourner ses arguments. Il est utilisé le plus souvent en filtrage par motif (*pattern matching*) ou avec les fonctions partielles. + +```scala mdoc +import scala.util.Random + +object CustomerID { + + def apply(name: String) = s"$name--${Random.nextLong}" + + def unapply(customerID: String): Option[String] = { + val stringArray: Array[String] = customerID.split("--") + if (stringArray.tail.nonEmpty) Some(stringArray.head) else None + } +} + +val customer1ID = CustomerID("Sukyoung") // Sukyoung--23098234908 +customer1ID match { + case CustomerID(name) => println(name) // prints Sukyoung + case _ => println("Could not extract a CustomerID") +} +``` + +La méthode `apply` crée une chaîne de caractères `CustomerID` depuis `name`. La méthode `unapply` fait l'inverse pour retrouver le `name`. Lorsqu'on appelle `CustomerID("Sukyoung")`, c'est un raccourci pour `CustomerID.apply("Sukyoung")`. Lorsqu'on appelle `case CustomerID(name) => println(name)`, on appelle la méthode `unapply` avec `CustomerID.unapply(customer1ID)`. + +Sachant qu'une définition de valeur peut utiliser une décomposition pour introduire une nouvelle variable, un extracteur peut être utilisé pour initialiser la variable, avec la méthode `unapply` pour fournir la valeur. + +```scala mdoc +val customer2ID = CustomerID("Nico") +val CustomerID(name) = customer2ID +println(name) // prints Nico +``` + +C'est équivalent à `val name = CustomerID.unapply(customer2ID).get`. + +```scala mdoc +val CustomerID(name2) = "--asdfasdfasdf" +``` + +S'il n'y a pas de correspondance, une `scala.MatchError` est levée : + +```scala +val CustomerID(name3) = "-asdfasdfasdf" +``` + +Le type de retour de `unapply` doit être choisi comme suit : + +* Si c'est juste un test, retourner un `Boolean`. Par exemple, `case even()`. +* Si cela retourne une seule sous-valeur de type T, retourner un `Option[T]`. +* Si vous souhaitez retourner plusieurs sous-valeurs `T1,...,Tn`, groupez-les dans un tuple optionnel `Option[(T1,...,Tn)]`. + +Parfois, le nombre de valeurs à extraire n'est pas fixe et on souhaiterait retourner un nombre arbitraire de valeurs, en fonction des données d'entrée. Pour ce cas, vous pouvez définir des extracteurs avec la méthode `unapplySeq` qui retourne un `Option[Seq[T]]`. Un exemple commun d'utilisation est la déconstruction d'une liste en utilisant `case List(x, y, z) =>`. Un autre est la décomposition d'une `String` en utilisant une expression régulière `Regex`, comme `case r(name, remainingFields @ _*) =>`. + +Traduit par Antoine Pointeau. \ No newline at end of file From ef8f171b14742544916c206bada7517d7cb99d53 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 21 Mar 2022 14:32:32 +0100 Subject: [PATCH 1803/3075] modernise the content somewhat --- _contribute_resources/3-code-reviews.md | 1 + _overviews/contribute/bug-reporting-guide.md | 29 +++---- _overviews/contribute/codereviews.md | 47 ++++++----- _overviews/contribute/guide.md | 44 ++++------ _overviews/contribute/index.md | 2 +- _overviews/contribute/scala-internals.md | 84 +++++++++++-------- ...cala-standard-library-api-documentation.md | 9 +- _overviews/contribute/tools.md | 61 +++++--------- 8 files changed, 137 insertions(+), 140 deletions(-) diff --git a/_contribute_resources/3-code-reviews.md b/_contribute_resources/3-code-reviews.md index 41f6821414..e6f15e271c 100644 --- a/_contribute_resources/3-code-reviews.md +++ b/_contribute_resources/3-code-reviews.md @@ -4,5 +4,6 @@ link: /overviews/contribute/codereviews.html icon: fa fa-eye --- Review pull requests against [scala/scala](https://github.com/scala/scala/pulls), +[lampepfl/dotty](https://github.com/lampepfl/dotty/pulls), [scala/scala-lang](https://github.com/scala/scala-lang/pulls), [scala/docs.scala-lang](https://github.com/scala/docs.scala-lang/pulls) and others. diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 5cbf0a3f46..9545ecdc53 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -6,7 +6,7 @@ partof: scala-contribution overview-name: Contributing to Scala --- -The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. +The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug), and for Scala 3, it is located at [github.com/lampepfl/dotty](https://github.com/lampepfl/dotty/issues). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. ## Is it a Bug? @@ -22,7 +22,6 @@ If your issue is related to any of the following external projects, make sure to - [Akka](https://doc.akka.io/docs/akka/current/project/issue-tracking.html) - [Play!](https://github.com/playframework/Play20/issues) - [Slick](https://github.com/slick/slick/issues) - - [Scala IDE](https://scala-ide-portfolio.assembla.com/spaces/scala-ide/support/tickets) - [sbt](https://github.com/sbt/sbt/issues) The following are generally considered to be bugs: @@ -53,10 +52,10 @@ In general, if you find yourself stuck on any of these steps, asking on [Scala C - For compiler bugs use the [Compiler Category](https://contributors.scala-lang.org/c/compiler). * Examples of exceptions reported by the compiler which usually are not bugs: - 1. `StackOverflowError` is typically not a bug unless the stacktrace involves the internal packages of the compiler (like `scala.tools.nsc...`). Try to increase the Java stack size (`-Xss`), in most of the cases it helps. + 1. `StackOverflowError` is typically not a bug unless the stacktrace involves the internal packages of the compiler (like `scala.tools.nsc...`, or `dotty.tools.dotc...`). Try to increase the Java stack size (`-Xss`), in most of the cases it helps. 2. `AbstractMethodError` can occur when you did not recompile all the necessary Scala files (build tools, like `sbt`, can prevent that from happening) or you are mixing external libraries compiled for different Scala versions (for example one uses `2.10.x` and the other `2.11.x`). -## Reporting Confirmed Bugs is a Sin +## Please Check Before Reporting a Bug Before reporting your bug, make sure to check the issue tracker for other similar bugs. The exception name or a compiler phase are the best keywords to search for. If you are experiencing unexpected behavior search for method/class names where it happens. Your issue might already be reported, and a workaround might already be available for you take advantage of. If your issue *is* reported, be sure to add your test case as a comment if it is different from any of the existing ones. @@ -68,7 +67,7 @@ If you cannot find your issue in the issue tracker, create a new bug. The detail Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - 1. **Exact Scala version** that you are using. For example, `2.10.1` or `2.11.0-RC`. If the bug happens in multiple versions indicate all of them. + 1. **Exact Scala version** that you are using. For example, `2.13.8` or `3.1.2-RC1`. If the bug happens in multiple versions indicate all of them. 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? @@ -78,12 +77,14 @@ In order for us to quickly triage the bug that you've found, it's important that ### Description In the description of your issue, be as detailed as you can. Bug reports which have the following information included are typically understood, triaged, and fixed very quickly: - - 1. Include a test case (minimized if possible) enabling us to reproduce the problematic behavior. Include your test case (and output) in proper formatting `{code}` blocks: - - {code}Here you put your classes{code} - - 2. The expected output. - 3. The actual output, including the stacktrace. - 4. Related discussion on the mailing lists, if applicable. - 5. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. +1. Include a test case (minimized if possible) enabling us to reproduce the problematic behavior. Include your test +case (and output) in properly formatted code blocks: +~~~ +```scala +List(1, 2, 3).map(x => x + 1) +``` +~~~ +2. The expected output. +3. The actual output, including the stacktrace. +4. Related discussion on the mailing lists, if applicable. +5. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. diff --git a/_overviews/contribute/codereviews.md b/_overviews/contribute/codereviews.md index 368bf96793..e7dea2acea 100644 --- a/_overviews/contribute/codereviews.md +++ b/_overviews/contribute/codereviews.md @@ -29,27 +29,32 @@ own pull requests. ## Pull Requests Awaiting Comment
    -
    -
    -

    scala/scala

    -

    Scala bug fixes and changes in the language, core libs and included tools.

    -
    -
    -

    scala/scala.github.com

    -

    Scala documentation site.

    -
    -
    - -
    -
    -

    scala/scala-lang

    -

    The Scala language web site.

    -
    -
    -

    All Scala GitHub Projects

    -

    For other PRs, follow the scala project from here.

    -
    -
    +
    +
    +

    lampepfl/dotty

    +

    Scala 3 bug fixes and changes in the language, core libs and included tools.

    +
    +
    +

    scala/scala

    +

    Scala 2 bug fixes and changes in the language, core libs and included tools.

    +
    +
    +
    +
    +

    scala/scala-lang

    +

    The Scala language web site.

    +
    +
    +

    scala/docs.scala-lang.org

    +

    Scala documentation site.

    +
    +
    +
    +
    +

    All Scala GitHub Projects

    +

    For other PRs, follow the scala project from here.

    +
    +
    Also note that the [Tools contributions](/overviews/contribute/tools.html) page has more projects that will generate pull requests. diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index 0b5b146ffc..5acc188a27 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -6,29 +6,13 @@ partof: scala-contribution overview-name: Contributing to Scala --- -
    -
    -
    -

    Scala Contributors

    -

    Get a peek into the inners of the Scala compiler.

    -
    -
    -

    Report an issue

    -

    File a bug report or a feature request.

    -
    -
    - -
    -
    -

    Community issues

    -

    Get cracking on some easy to approach issues.

    -
    -
    -

    Hacker guide

    -

    Learn to write good code and improve your chances of contributing to the Scala galaxy.

    -
    -
    -
    +| **Shortcut** | **Description** | +|----------------------------------------|-----------------| +| [Scala Contributors][contrib-forum] | Get a peek into the inners of the Scala compiler. | +| [Report an Issue][bug-reporting-guide] | File a bug report or a feature request. | +| [Community Issues][community-tickets] | Get cracking on some easy to approach issues. | +| [Scala 2 Hacker's Guide][hackers] | Learn to write good code and improve your chances of contributing to the Scala galaxy. | +| [Scala 3 Contributing Guide][scala3-hackers] | Walkthrough contributing to the Scala 3 compiler, along with a guide to compiler internals. | @@ -52,11 +36,13 @@ which allows us to ensure that all code submitted to the project is unencumbered by copyrights or patents. ### Bug-fix Check List +> Originally these steps cover the [Scala 2 compiler](https://github.com/scala/scala), but they also are relevant to +> the [Scala 3 compiler](https://github.com/lampepfl/dotty). This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [GitHub branch](https://github.com/scala/scala) 1. [Select a bug to fix from GitHub](/overviews/contribute/index.html#community-tickets), or if you found the bug yourself and want to fix it, [create a GitHub issue](/overviews/contribute/bug-reporting-guide.html) (but please -[make sure it's not a duplicate](/overviews/contribute/bug-reporting-guide.html#reporting-confirmed-bugs-is-a-sin)). +[make sure it's not a duplicate](/overviews/contribute/bug-reporting-guide.html#please-check-before-reporting-a-bug)). 2. Optional ([but recommended](/overviews/contribute/scala-internals.html/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with [these friendly people](/overviews/contribute/hacker-guide.html#1-connect) - it's one of the perks of contributing. 3. [Fork the Scala repository](/overviews/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). @@ -70,7 +56,7 @@ https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is r 10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/overviews/contribute/hacker-guide.html#review). 11. Celebrate! -Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide](/overviews/contribute/hacker-guide.html) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). +Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide][hackers] (or the [equivalent Scala 3 Contributing Guide][scala3-hackers]) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). ### Larger Changes, New Features @@ -79,4 +65,10 @@ and on the implementation plan. Announce the change on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](https://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list and if a SIP is required, that will be discussed on the mailing list. Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against -the Scala project source tree. The [hacker guide](/overviews/contribute/hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. +the Scala project source tree. The hacker's guides ([Scala 2][hackers], or [Scala 3][scala3-hackers]) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. + +[hackers]: /overviews/contribute/hacker-guide.html +[community-tickets]: /overviews/contribute/index.html#community-tickets +[bug-reporting-guide]: /overviews/contribute/bug-reporting-guide.html +[scala3-hackers]: {% link _overviews/scala3-contribution/procedures-intro.md %} +[contrib-forum]: https://contributors.scala-lang.org/ diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index 8b7dad1e83..b89f04803a 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -37,7 +37,7 @@ When contributing, please follow: ### Community Tickets -All issues can be found in the [Scala bug tracker](https://github.com/scala/bug). Most issues are labeled +All issues can be found in the [Scala bug tracker](https://github.com/scala/bug), or the [Scala 3 issue tracker](https://github.com/lampepfl/dotty/issues). Most issues are labeled to make it easier to find issues you are interested in. ### Tools and Libraries diff --git a/_overviews/contribute/scala-internals.md b/_overviews/contribute/scala-internals.md index 82346bcb15..ac5be2fd85 100644 --- a/_overviews/contribute/scala-internals.md +++ b/_overviews/contribute/scala-internals.md @@ -1,47 +1,63 @@ --- -title: Scala Internals Mailing List +title: Scala Contributors Forum layout: multipage-overview num: 8 partof: scala-contribution overview-name: Contributing to Scala --- -## scala-internals - -The [scala-internals mailing list](https://groups.google.com/d/forum/scala-internals) is where technical and logistical discussions concerning bugs, bug fixes, documentation, improvements, new features and other contributor related topics occur. - -### Coordinating on scala-internals - -Prior to commencing on contribution work on larger changes to the Scala project, it is recommended (but not required) that you make a post on scala-internals announcing your intention. It's a great time to invite any help, advice or ask any questions you might have. It's also a great place to meet peers, one of whom will probably be reviewing your contribution at some point. For smaller bug fixes or documentation changes where the risk of effort duplication is minimal, you can skip this post. - -To help subscribers on the scala-internals list to sort through the postings, we request that the following topic labels are applied when you start a new post please: - -| Label | Topics | -|-----------|-------------------------------------------------------| -| [docs] | Documentation, e.g. docs.scala-lang.org, API (scaladoc), etc. | -| [issues] | Bug reporting/fixing | -| [tools] | Tools including sbt, IDE plugins, testing, scaladoc generator, etc. | -| [libs] | Core libraries, extension libraries | -| [compiler] | Scala compiler discussions/features/issues | -| [admin] | Administrative/coordination topics | - -So, to talk about this list (an admin activity primarily) one might use: - -`[admin] more suggested labels for topic differentiation.` - -as a title, which then shows up on the mailing lists as - -`[scala-internals] [admin] more suggested labels for topic differentiation.` +The [Scala Contributors Forum][scala-contributors] is where discussions about the Scala ecosystem +occur, from the perspectives of core compiler, documentation and library contributors. It features updates from the +Scala Center, along with technical and logistical discussions concerning bugs, bug fixes, documentation, improvements, +new features and other contributor related topics. + +> The now legacy [scala-internals mailing list](https://groups.google.com/d/forum/scala-internals) used to fulfil this +> purpose, but has since expanded to encompass more topics in the new [forum][scala-contributors]. + +## Coordinating on Scala Contributors + +Prior to commencing on contribution work on larger changes to the Scala project, it is recommended (but not required) +that you make a post on [Scala Contributors][scala-contributors] announcing your intention. +It's a great time to invite any help, advice or ask any questions you might have. It's also a great place to meet peers, +one of whom will probably be reviewing your contribution at some point. +For smaller bug fixes or documentation changes where the risk of effort duplication is minimal, you can skip this post. + +To help users to sort through the posts, we request that the following categories are applied when you start a +new post please: + +| Category | Topics | +|-----------------------------|---------------------------------------------------------------------| +| `Documentation` | Documentation, e.g. docs.scala-lang.org, API (scaladoc), etc. | +| `Compiler` | Bug reporting/fixing, Scala compiler discussions/issues | +| `Tooling` | Tools including sbt, IDE plugins, testing, scaladoc generator, etc. | +| `Scala Standard Library` | Core libraries | +| `Scala Platform` | Extension libraries | +| `Language Design` | Scala language feature discussions / informal proposals | +| `Scala Improvement Process` | Scala language feature formal proposals | +| `Meta Discourse` | Administrative/coordination topics | +| `Community` | Discussions about events, community organising | ### Why It's a Good Idea -While it is optional to announce your intentions/work items on scala-internals before starting, it is recommended and a smart thing to do for a number of reasons: +While it is optional to announce your intentions/work items on [Scala Contributors][scala-contributors] before starting, it is recommended thing to do for a number of reasons: * To attempt to cut down on duplicate effort (i.e. to avoid two people working on the same bug at the same time without coordinating effort). * Related to the above: to allow the compiler team and core committers to warn of or smooth over potential merge conflicts between separate bugs that might affect the same code. -* Potentially someone has already thought about or even worked on that issue or a related one, and has valuable insight that might save you time (including warnings about what you might find and may want to avoid - dead ends that have already been explored). -* You might find a group of impassioned individuals want to volunteer to help you, since you got there first with your post it's up to you to decide if you want help or not. -* Posting could start a dialog with a potential reviewer, smoothing the latter, merge stages of the issue. -* There are a lot of nice people waiting to talk to you on scala-internals, you might be surprised how valuable and pleasant you find the experience of talking to them. - -If all of this has not convinced you then, please, go ahead and work on contributions anyway. It *is* less important to post to scala-internals first for small, self contained bugs than it is for larger issues or features, and not having posted first will not be a reason for your PR to be rejected, it just might be a rougher review/merge process than if you had posted first. It's your choice. +* Potentially someone has already thought about or even worked on that issue or a related one, and has valuable insight +that might save you time (including warnings about what you might find and may want to avoid - perhaps one option +already tried lead to no benefit). +* You might find a group of impassioned individuals who want to volunteer and help you. You will have the momentum since +you posted first, so then it's up to you to decide if you want their help or not. +* Posting could start a dialog with a potential reviewer, smoothing the later stages of your contribution before +merging your changes. +* There are a lot of nice people waiting to talk to you on [Scala Contributors][scala-contributors], you might be +surprised how valuable and pleasant you find the experience of talking to them. + +Even if you do not wish to post on [Scala Contributors][scala-contributors], please feel welcome to make contributions +anyway, as posting to the forum is *not* criteria for it to be accepted. For smaller, self-contained bugs it is +especially less important to make a post, however larger issues or features take more time to consider accepting them. +For large contributions we strongly recommend that you do to notify of your intention, which will help you determine if +there is large community support for your change, making it more likely that your large contribution will accepted, +before you spend a long time implementing it. + +[scala-contributors]: https://contributors.scala-lang.org diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md index 977e733528..ba59855392 100644 --- a/_overviews/contribute/scala-standard-library-api-documentation.md +++ b/_overviews/contribute/scala-standard-library-api-documentation.md @@ -43,7 +43,8 @@ and identify missing, incorrect or inadequate documentation. A good place to sta package objects for important packages (these often get overlooked for documentation and are a good place for API overviews). -If you find an issue, please log it in the [Scala bug tracker](https://github.com/scala/bug) +If you find an issue, please log it in the [Scala bug tracker](https://github.com/scala/bug), +(or else the [Scala 3 issue tracker](https://github.com/lampepfl/dotty/issues) for Scala 3 library additions) **after making sure it is not already logged as an issue**. To help with disambiguation, please use the following format for issue title: @@ -112,10 +113,10 @@ PR is merged in smoothly: Scala code is likely to flag as mis-spelled sometimes, but any written language should be checked. If you can also use a grammar checker, even better. We *will* ask for spelling and grammar to be corrected before acceptance. -* You **must** also run `ant docs`, fix any problems and check the formatting and +* You **must** also run `sbt doc`, fix any problems and check the formatting and layout of your changes. Again, corrections will be required if formatting or - layout are inadequate. After running `ant docs` the generated documents can be - found under the `build/scaladoc/` folders (probably in the `library` folder + layout are inadequate. After running `sbt doc` the generated documents can be + found under the `build/scaladoc/` folders (probably in the `library` subdirectory but maybe under the others depending on what section of the Scala source you are working on). * All of these steps are required to save time for both the reviewers and diff --git a/_overviews/contribute/tools.md b/_overviews/contribute/tools.md index b7ae46b9ed..4ce5a3be0a 100644 --- a/_overviews/contribute/tools.md +++ b/_overviews/contribute/tools.md @@ -8,8 +8,8 @@ overview-name: Contributing to Scala # Projects list: projects: - title: sbt - description: Interactive build tool. - icon: https://www.scala-sbt.org/assets/typesafe_sbt_svg.svg + description: The interactive build tool. + icon: https://www.scala-sbt.org/assets/sbt-logo.svg link: https://github.com/sbt/sbt homeLink: https://www.scala-sbt.org/ issuesLink: https://github.com/sbt/sbt#issues-and-pull-requests @@ -23,57 +23,26 @@ projects: issuesLink: https://github.com/scala/bug/labels/scaladoc readmeLink: https://github.com/scala/scala#welcome contributingLink: /overviews/contribute/guide.html - - title: Scala IDE - description: Interactive build tool. - icon: https://avatars2.githubusercontent.com/u/1026788?v=3&s=200 - link: https://github.com/scala-ide/scala-ide - homeLink: http://scala-ide.org/ - issuesLink: https://scala-ide-portfolio.assembla.com/spaces/scala-ide/support/tickets - readmeLink: https://github.com/scala-ide/scala-ide/blob/master/README.md - contributingLink: https://github.com/scala-ide/scala-ide/blob/master/CONTRIBUTING.md - - title: DBuild - description: Multi-project build tool. - icon: https://avatars3.githubusercontent.com/u/784923?v=3&s=200 - link: https://github.com/lightbend/dbuild - homeLink: https://lightbend.github.io/dbuild - issuesLink: https://github.com/lightbend/dbuild/issues - readmeLink: https://github.com/lightbend/dbuild/blob/master/README.md - contributingLink: https://github.com/lightbend/dbuild/blob/master/README.md#get-involved - title: Partest - description: Scala Compiler/Library Testing + description: Scala Compiler/Library Testing (Contribute through scala/scala) icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 - link: https://github.com/scala/scala-partest - homeLink: https://docs.scala-lang.org/tutorials/partest-guide.html - issuesLink: https://github.com/scala/scala-partest/issues - readmeLink: https://github.com/scala/scala-partest/blob/1.1.x/README.md + link: https://github.com/scala/scala + homeLink: https://github.com/scala/scala + issuesLink: https://github.com/scala/scala/issues + readmeLink: https://github.com/scala/scala/blob/2.13.x/CONTRIBUTING.md#partest contributingLink: - - title: Scoverage - description: Scala code coverage tool - icon: https://avatars1.githubusercontent.com/u/5998302?v=3&s=200 - link: https://github.com/scoverage/scalac-scoverage-plugin - homeLink: http://scoverage.org/ - issuesLink: https://github.com/scoverage/scalac-scoverage-plugin/issues - readmeLink: https://github.com/scoverage/scalac-scoverage-plugin/blob/master/README.md - contributingLink: https://groups.google.com/forum/#!forum/scala-code-coverage-tool projectsInNeed: - - title: Scalariform - description: Scala source code formatter - icon: /resources/img/white-line.png - link: https://github.com/mdr/scalariform - homeLink: https://github.com/mdr/scalariform/wiki/Command-line-tool - issuesLink: https://github.com/mdr/scalariform/issues - readmeLink: https://github.com/mdr/scalariform/blob/master/README.rst --- ## Contributing to IDE and Build Tools The links below are to a number of Scala build and IDE related projects that are important in the larger Scala space, and which welcome contributions. -Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. The [Hacker Guide](/overviews/contribute/hacker-guide.html) and [Bug-fixing](/overviews/contribute/guide.html) pages will likely have much in the way of related information on how to contribute to these projects, and are recommended reading. You should also check the README.md and (if it's present) CONTRIBUTING.md files from the actual projects before contributing to them. +Since these tools are in separate projects, they may (and likely will) have their own rules and guidelines for contributing. You should also check the `README.md` and (if it's present) `CONTRIBUTING.md` files from the actual projects before contributing to them. Typically, issues for these projects will be reported and kept in the GitHub project issue tracker for that project rather than in the Scala bug tracker. -Many of these projects have a chat room on Discord or Gitter (usually linked from their README or CONTRIBUTING files) which is a great place to discuss proposed work before starting. +Many of these projects have a chat room on Discord or Gitter (usually linked from their `README.md` or `CONTRIBUTING.md` files) which is a great place to discuss proposed work before starting. There are some projects in this section that are in [particular need](#projects-in-particular-need) so please check those out @@ -85,10 +54,22 @@ Stuff changes. Found a broken link or something that needs updating on this page ### Projects +{% if page.projects.size > 0 %} {% include contributions-projects-list.html collection=page.projects %} +{% else %} +There are no projects. +{% endif %} ### Projects in Particular Need +{% if page.projectsInNeed.size > 0 %} + The following projects are important to the Scala community but are particularly in need of contributors to continue their development. {% include contributions-projects-list.html collection=page.projectsInNeed %} + +{% else %} + +There are no projects in particular need. + +{% endif %} From b32fe5627023d8c45d20a1fcf20c20ae3e70e7b0 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 21 Mar 2022 14:47:11 +0100 Subject: [PATCH 1804/3075] add new page - Add New Guides/Tutorials --- README.md | 2 +- _contribute_resources/1-documentation.md | 2 +- _overviews/contribute/add-guides.md | 221 ++++++++++++++++++ _overviews/contribute/bug-reporting-guide.md | 2 +- _overviews/contribute/documentation.md | 4 +- _overviews/contribute/guide.md | 2 +- _overviews/contribute/hacker-guide.md | 2 +- _overviews/contribute/partest-guide.md | 2 +- _overviews/contribute/scala-internals.md | 2 +- ...cala-standard-library-api-documentation.md | 2 +- _overviews/contribute/tools.md | 2 +- contribute.md | 179 +------------- 12 files changed, 237 insertions(+), 185 deletions(-) create mode 100644 _overviews/contribute/add-guides.md diff --git a/README.md b/README.md index a6283b2386..ee37fe58d4 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ For more details on the Docker option, see [this issue](https://github.com/scala ## Contributing ## -Please have a look at [https://docs.scala-lang.org/contribute.html](https://docs.scala-lang.org/contribute.html) before making a contribution. +Please have a look at [Add New Guides/Tutorials](https://docs.scala-lang.org/overviews/contribute/add-guides.html) before making a contribution. This document gives an overview of the type of documentation contained within the Scala Documentation repository and the repository's structure. Small changes, or corrected typos will generally be pulled in right away. Large changes, like the addition of new documents, or the rewriting of diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md index 3e1b81a7b9..7515ff7519 100644 --- a/_contribute_resources/1-documentation.md +++ b/_contribute_resources/1-documentation.md @@ -3,4 +3,4 @@ title: Documentation link: /overviews/contribute/documentation.html icon: fa fa-book --- -[Scaladoc (API)](/overviews/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](/contribute.html) and [scala-lang.org](https://github.com/scala/scala-lang). +[Scaladoc (API)](/overviews/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](/overviews/contribute/add-guides.html) and [scala-lang.org](https://github.com/scala/scala-lang). diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md new file mode 100644 index 0000000000..c8f5e42f0c --- /dev/null +++ b/_overviews/contribute/add-guides.md @@ -0,0 +1,221 @@ +--- +title: Add New Guides/Tutorials +layout: multipage-overview +num: 7 +partof: scala-contribution +overview-name: Contributing to Scala +--- + +## Why Contribute New Learning Material? + +As [Heather Miller writes](/contribute.html), contributing to [docs.scala-lang.org](https://docs.scala-lang.org) is +critical to making Scala accessible to newcomers, experience programmers, and anyone who is curious. +It is also a fantastic way to contribute for anyone who is comfortable using Scala, but maybe does not want to get +involved with complex tools like the compiler. + +## Architecture + +This documentation website is backed by an open-source [github repository](https://github.com/scala/docs.scala-lang), +and is always contribution-ready. + +### Content + +Currently, the _types_ of documentation supported in this repository are: + +- **Guides/Overviews**: Definitive guides/overviews of specific language features. Often long, detailed documents, + often produced by members of the Scala team. An example is the excellent [Collections][collections-overview] overview. +- **Tutorials**: Bite-size, example-rich, and concise articles meant to get a developer up to speed quickly. +- **Cheatsheets**: Quick reference of Scala syntax and behaviors. + +### Implementation + +The website is statically generated from [Markdown](https://en.wikipedia.org/wiki/Markdown) source using +[Jekyll](https://github.com/mojombo/jekyll), and hosted on [GitHub Pages](https://pages.github.com/). +This workflow was chosen so as to make it as easy as possible for core committers and the community alike +to produce HTML documentation, and as easy as possible to publish it in a central location. + +The markdown syntax being used supports [Maruku](https://github.com/bhollis/maruku) extensions, and has automatic +syntax highlighting, without the need for any tags. + +Additionally [mdoc](https://github.com/scalameta/mdoc) is used during pull requests to validate Scala code blocks. +To use this feature you must use the backtick notation as documented by mdoc. Note that only validation is done. +The output files from mdoc are not used in the building of the tutorial. Use `mdoc` or `mdoc:fail` for your code blocks. + +## Submitting Docs + +For one to contribute a document, one must simply +[fork](https://help.github.com/articles/fork-a-repo/) the +[repo](https://github.com/scala/docs.scala-lang), write their article in +[Markdown](https://daringfireball.net/projects/markdown/syntax) (example below), and submit a pull request. That's it. +Likely after some edits and discussion, your document will be made live +on [docs.scala-lang.org](https://docs.scala-lang.org). + + --- + layout: overview + title: My Awesome Title + --- + + ## An h2 Header in Markdown + + And a paragraph, with a [link](https://www.scala-lang.org). + +One can contribute code in a markdown document by either + - indenting it by 4 spaces + - surrounding by triple backticks, as shown below + - in-line by putting backticks around it, e.g. `def foo`. + + ```scala + println("hello") + ``` + +Everything else is automatically generated for you; tables of contents, and most index pages. And of course, the +styling is already taken care of for you. + +### Criteria for Docs to be Accepted + +The goal of this documentation repository is to be tighter and more organized than other community-driven documentation platforms, like wikis. As such, any document pulled in for inclusion on +[docs.scala-lang.org](https://docs.scala-lang.org) must: + +- **"fit in"** to the repository ( _i.e.,_ it should not be a complete duplicate of another article), +- **be polished** it must be thorough, complete, correct, organized, and "article-like" (personal programming notes +don't quite fit.) +- **be maintained** if the document might require revisions from time to time, be prepared to keep it up to date, or +nominate someone to take ownership. + +If you have something you're thinking about contributing, or that you're thinking about writing in order to contribute +-- we'd love to consider it! Please don't hesitate to use GitHub issues and pull requests and the +\#scala-contributors room [on Discord](https://discord.com/invite/scala) for any questions, concerns, +clarifications, etc. + +## Document Templates + +> **Note:** These templates will soon change slightly as a result of necessary refactoring. + +### Guides/Overviews + +A guide or an overview that can be logically placed on **one** page must be placed in the directory +`_overviews/RELEVANT-CATEGORY/_posts` with the file name in the format `YYYY-MM-dd-title-separated-by-dashes.md`, +and header: + + --- + layout: overview + title: YOUR TITLE + --- + +The rest of the document should, of course, be written in [Markdown](https://en.wikipedia.org/wiki/Markdown). + +At the moment, `RELEVANT-CATEGORY` corresponds to only a single category, "core," because we are currently focusing on +building up documentation of core libraries. However, expect more categories here in the future. + +If your document consists of **multiple** pages, like the [Collections][collections-overview] overview, an ordering +must be specified, by numbering documents in their logical order with `num`, and a name must be assigned to the +collection of pages using `partof`. For example, the following header might be used for a document in the collections +overview: + + --- + layout: overview + title: YOUR TITLE + + partof: collections + num: 10 + --- + +A **single** document in the collection must contain a tag in the header, `outof`, that indicates the total number of +documents in the large overview. Putting it on the last page in the overview is often best: + + --- + layout: overview + title: YOUR TITLE + + partof: collections + num: 15 + outof: 15 + --- + +Index pages, such as [docs.scala-lang.org/overviews/index.html](https://docs.scala-lang.org/overviews/index.html) are +generated, by reading data from a configuration file, such as `_data/overviews.yml`, so your overview should be +placed into a category there. + +### Tutorials + +At the moment, tutorials are written the same as Guides/Overviews, except that their link must be added to +the metadata of `/tutorials.md`. e.g. for the [Scala With Maven][scala-with-maven] tutorial, the +metadata of `/tutorials.md` looks like + + --- + layout: inner-page-parent + title: Tutorials + + tutorials: + ... + - title: "Scala with Maven" + url: "/tutorials/scala-with-maven.html" + description: "Create a Scala project with Maven." + icon: code + --- + +For a single-page tutorial, the typical directory to place them in is `_overviews/tutorials`. + +### Cheatsheets + +For now, cheatsheets are assumed to be in the form of tables. To contribute a cheatsheet, one must simply produce their +cheatsheet as a Markdown table, with the following header: + + --- + layout: cheatsheet + title: YOUR TITLE + by: YOUR NAME + about: SOME TEXT ABOUT THE CHEAT SHEET. + --- + +### Code blocks + +The site build process uses [mdoc](https://scalameta.org/mdoc/) to typecheck +code snippets in markdown. This is a great way to ensure the code snippets that +you're including typecheck and are valid. Here are a few quick types to get +started. + +To get started, add `mdoc` after `scala` when you are creating a +code block. The `mdoc` modifier here will make sure that `mdoc` runs the code +snippet and ensures that it's valid. + + ```scala mdoc + val a = 1 + ``` +If you have a snippet that you expect to fail, you can also account for this by +using `mdoc:fail` for a compile error `mdoc:crash` for a runtime-error. + + ```scala mdoc:fail + val b: String = 3 // won't compile + ``` +Keep in mind that a single file is all compiled as a single unit, so you can't +redefine a variable that was defined above in another code snippet. _However_ +there are a couple ways to get around this. Firstly, you can use the `mdoc:nest` +modifier with will wrap the snippet in a `scala.Predef.locally{...}`. This will +essentially "hide" the snippet from the others. Another way around this is to +use the `mdoc:reset` modifier, which _resets_ and forgets about everything up +above. Here is an example using the various modifiers. + + ```scala mdoc + import java.time.Instant + + def now() = Instant.now() + object Foo {} + ``` + + ```scala mdoc:nest + case class Foo(a: Int) // conflicts with Foo above, but it's nested so it's fine + ``` + + ```scala mdoc + val a = s"The time is ${now()}" // still have access to the now method from above + ``` + ```scala mdoc:reset + case class Foo(a: String) // forget the previous Foo's and start fresh + ``` + ```scala mdoc + val myFoo = Foo("hi") // now we only have access to the last Foo + ``` + +[collections-overview]: {% link _overviews/collections-2.13/introduction.md %} +[scala-with-maven]: {% link _overviews/tutorials/scala-with-maven.md %} diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 9545ecdc53..ac6df525a5 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -1,7 +1,7 @@ --- title: Bug Reporting Guide layout: multipage-overview -num: 7 +num: 8 partof: scala-contribution overview-name: Contributing to Scala --- diff --git a/_overviews/contribute/documentation.md b/_overviews/contribute/documentation.md index 7fca82ff53..417f9b234a 100644 --- a/_overviews/contribute/documentation.md +++ b/_overviews/contribute/documentation.md @@ -44,7 +44,7 @@ without creating an issue, but please look to see if there is an issue already s * SIP (Scala Improvement Process) Proposals and more -Please read [contributing to the docs.scala-lang.org site](/contribute.html) through before embarking on changes. The site uses +Please read [Add New Guides/Tutorials](/overviews/contribute/add-guides.html) through before embarking on changes. The site uses the [Jekyll](https://jekyllrb.com/) markdown engine so you will need to follow the instructions to get that running as well. ### Updating scala-lang.org @@ -55,4 +55,4 @@ to Scala and related projects) is provided on the main [scala-lang GitHub project](https://github.com/scala/scala-lang) which may be forked to create pull requests. Please read both the -[docs.scala-lang.org contribution](/contribute.html) document and the [scala-lang.org GitHub README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. +[Add New Guides/Tutorials](/overviews/contribute/add-guides.html) document and the [scala-lang.org GitHub README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index 5acc188a27..802e3c387c 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -1,7 +1,7 @@ --- title: Contributing guide layout: multipage-overview -num: 9 +num: 10 partof: scala-contribution overview-name: Contributing to Scala --- diff --git a/_overviews/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md index cb83b6218a..f342c98040 100644 --- a/_overviews/contribute/hacker-guide.md +++ b/_overviews/contribute/hacker-guide.md @@ -2,7 +2,7 @@ title: Scala hacker guide by: Eugene Burmako layout: multipage-overview -num: 11 +num: 12 partof: scala-contribution overview-name: Contributing to Scala --- diff --git a/_overviews/contribute/partest-guide.md b/_overviews/contribute/partest-guide.md index 6fb5a2644b..548eb8d5e6 100644 --- a/_overviews/contribute/partest-guide.md +++ b/_overviews/contribute/partest-guide.md @@ -1,7 +1,7 @@ --- title: Running the Test Suite layout: multipage-overview -num: 12 +num: 13 partof: scala-contribution overview-name: Contributing to Scala --- diff --git a/_overviews/contribute/scala-internals.md b/_overviews/contribute/scala-internals.md index ac5be2fd85..5f391947fa 100644 --- a/_overviews/contribute/scala-internals.md +++ b/_overviews/contribute/scala-internals.md @@ -1,7 +1,7 @@ --- title: Scala Contributors Forum layout: multipage-overview -num: 8 +num: 9 partof: scala-contribution overview-name: Contributing to Scala --- diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md index ba59855392..99f1bb16e0 100644 --- a/_overviews/contribute/scala-standard-library-api-documentation.md +++ b/_overviews/contribute/scala-standard-library-api-documentation.md @@ -13,7 +13,7 @@ sometimes referred to as Scaladoc contributions. For contributions to tutorial and guide-style documentation on [docs.scala-lang.org](/), -see the ["doc-site"'s contribution guide](/contribute.html). +see [Add New Guides/Tutorials](/overviews/contribute/add-guides.html). *Please note, these instructions cover documentation contributions Scala core libraries only. For other Scala projects please check those projects for the diff --git a/_overviews/contribute/tools.md b/_overviews/contribute/tools.md index 4ce5a3be0a..875160ca96 100644 --- a/_overviews/contribute/tools.md +++ b/_overviews/contribute/tools.md @@ -1,7 +1,7 @@ --- title: IDE and Build Tool Contributions layout: multipage-overview -num: 10 +num: 11 partof: scala-contribution overview-name: Contributing to Scala diff --git a/contribute.md b/contribute.md index 1abb5e539c..4a7d38faec 100644 --- a/contribute.md +++ b/contribute.md @@ -1,9 +1,9 @@ --- -layout: contribute -title: Contribute +layout: singlepage-overview +title: Why Contribute to docs.scala-lang.org? --- -###### Heather Miller +###### A note from Heather Miller ## A Place to Build Documentation Together @@ -21,175 +21,6 @@ If we want Scala to be accessible to more programmers, clear, easy-to-find docum If you're interested in contributing to the Scala project in general, I argue that one of the most meaningful ways that you can, is to help us improve this transfer of information- let's make it easier and faster for people to _get_ core concepts, and to answer their own questions so they can progress to _Scala-proficient_ quickly. Each line that you contribute has the potential to affect the entire Scala community as a whole-- current, and future. -## About docs.scala-lang.org +## How Can I Contribute? -### Content - -Currently, the _types_ of documentation supported in this repository are: - -- **Guides/Overviews**: Definitive guides/overviews of specific language features. Often long, detailed documents, often produced by members of the Scala team. An example is the excellent [Collections]({{ site.baseurl }}/overviews/collections-2.13/introduction.html) overview. -- **Tutorials**: Bite-size, example-rich, and concise articles meant to get a developer up to speed quickly. -- **Cheatsheets**: Quick reference of Scala syntax and behaviors. - -### Implementation - -This documentation repository is open-source, it lives in [github repository](https://github.com/scala/docs.scala-lang), and is always contribution-ready. - -It's statically generated from [Markdown](https://en.wikipedia.org/wiki/Markdown) source using [Jekyll](https://github.com/mojombo/jekyll), and hosted on [GitHub Pages](https://pages.github.com/). This workflow was chosen so as to make it as easy as possible for core committers and the community alike to produce HTML documentation, and as easy as possible to publish it in a central location. - -The markdown syntax being used supports [Maruku](https://github.com/bhollis/maruku) extensions, and has automatic syntax highlighting, without the need for any tags. - -Additionally [mdoc](https://github.com/scalameta/mdoc) is used during pull requests to validate Scala code blocks. To use this feature you must use the backtick notation as documented by mdoc. Note that only validation is done. The output files from mdoc are not used in the building of the tutorial. Use `mdoc` or `mdoc:fail` for your code blocks. - -## Submitting Docs - -For one to contribute a document, one must simply -[fork](https://help.github.com/articles/fork-a-repo/) the -[repo](https://github.com/scala/docs.scala-lang), write their article in -[Markdown](https://daringfireball.net/projects/markdown/syntax) (example below), and submit a pull request. That's it. Likely after some edits and discussion, your document will be made live on [docs.scala-lang.org](https://docs.scala-lang.org). - - --- - layout: overview - title: My Awesome Title - --- - - ## An h2 Header in Markdown - - And a paragraph, with a [link](https://www.scala-lang.org). - - One can contribute code by indenting it 4 spaces, or in-line by putting backticks around it like so, `def foo` - -Everything else is automatically generated for you; tables of contents, and most index pages. And of course, the styling is already taken care of for you. - -### Criteria for Docs to be Accepted - -The goal of this documentation repository is to be tighter and more organized than other community-driven documentation platforms, like wikis. As such, any document pulled in for inclusion on [https://docs.scala-lang.org](https://docs.scala-lang.org) must: - -- **"fit in"** to the repository ( _i.e.,_ it should not be a complete duplicate of another article), -- **be polished** it must be thorough, complete, correct, organized, and "article-like" (personal programming notes don't quite fit.) -- **be maintained** if the document might require revisions from time to time, it should come with an owner - -If you have something you're thinking about contributing, or that you're thinking about writing in order to contribute-- we'd love to consider it! Please don't hesitate to use GitHub issues and pull requests and the \#scala-contributors room [on Discord](https://discord.com/invite/scala) for any questions, concerns, clarifications, etc. - -## Document Templates - -
    -

    Note: These templates will soon change slightly as a result of necessary refactoring.

    -
    - -### Guides/Overviews - -A guide or an overview that can be logically placed on **one** page must be placed in the directory `overviews/RELEVANT-CATEGORY/_posts` with the file name in the format `YYYY-MM-dd-title-separated-by-dashes.md`, and header: - - --- - layout: overview - title: YOUR TITLE - --- - -The rest of the document should, of course, be written in [Markdown](https://en.wikipedia.org/wiki/Markdown). - -At the moment, `RELEVANT-CATEGORY` corresponds to only a single category, "core," because we are currently focusing on building up documentation of core libraries. However, expect more categories here in the future. - -If your document consists of **multiple** pages, like the [Collections]({{ site.baseurl }}/overviews/collections-2.13/introduction.html) overview, an ordering must be specified, by numbering documents in their logical order with `num`, and a name must be assigned to the collection of pages using `partof`. For example, the following header might be used for a document in the collections overview: - - --- - layout: overview - title: YOUR TITLE - - partof: collections - num: 10 - --- - -A **single** document in the collection must contain a tag in the header, `outof`, that indicates the total number of documents in the large overview. Putting it on the last page in the overview is often best: - - --- - layout: overview - title: YOUR TITLE - - partof: collections - num: 15 - outof: 15 - --- - -Index pages, such as [https://docs.scala-lang.org/overviews/index.html](https://docs.scala-lang.org/overviews/index.html) are automatically generated, assuming documents are properly placed under the correct `RELEVANT-CATEGORY`. So, simply drop your document into the correct folder, and you're done. - -### Tutorials - -At the moment, a tutorial that can be logically placed on **one** page must be placed in the directory `tutorials/` with the file name in the format `title-separated-by-dashes.md`. For the moment, single-page tutorials use the same layout as single-page overviews: - - --- - layout: overview - title: YOUR TITLE - --- - -If you have a **multiple-page** tutorial, like in the case of multiple-page overviews, you must both specify an ordering for your document, and a name must be assigned to the collection of tutorial pages. For example, the following header is used for the [Tour of Scala]({{ site.baseurl }}/tour/tour-of-scala.html) series of tutorial articles: - - --- - layout: inner-page-no-masthead - title: YOUR TITLE - - tutorial: scala-tour - num: 4 - --- - -At the moment, only indexes for multiple-page tutorials are automatically generated. - -### Cheatsheets - -For now, cheatsheets are assumed to be in the form of tables. To contribute a cheatsheet, one must simply produce their cheatsheet as a Markdown table, with the following header: - - --- - layout: cheatsheet - title: YOUR TITLE - by: YOUR NAME - about: SOME TEXT ABOUT THE CHEAT SHEET. - --- - -### Code blocks - -The site build process uses [mdoc](https://scalameta.org/mdoc/) to typecheck -code snippets in markdown. This is a great way to ensure the code snippets that -you're including typecheck and are valid. Here are a few quick types to get -started. - -To get started, you can simply add `mdoc` behind `scala` when you are creating a -code block. The `mdoc` modifier here will make sure that `mdoc` runs the code -snippet and ensures that it's valid. - - ```scala mdoc - val a = 1 - ``` -If you have a snippet that you expect to fail, you can also account for this by -using `mdoc:fail` for a compile error `mdoc:crash` for a runtime-error. - - ```scala mdoc:fail - val b: String = 3 // won't compile - ``` -Keep in mind that a single file is all compiled as a single unit, so you can't -redefine a variable that was defined above in another code snippet. _However_ -there are a couple ways to get around this. Firstly, you can use the `mdoc:nest` -modifier with will wrap the snippet in a `scala.Predef.locally{...}`. This will -essentially "hide" the snippet from the others. Another way around this is to -use the `mdoc:reset` modifier, which _resets_ and forgets about everything up -above. Here is an example using the various modifiers. - - ```scala mdoc - import java.time.Instant - - def now() = Instant.now() - object Foo {} - ``` - - ```scala mdoc:nest - case class Foo(a: Int) // conflicts with Foo above, but it's nested so it's fine - ``` - - ```scala mdoc - val a = s"The time is ${now()}" // still have access to the now method from above - ``` - ```scala mdoc:reset - case class Foo(a: String) // forget the previous Foo's and start fresh - ``` - ```scala mdoc - val myFoo = Foo("hi") // now we only have access to the last Foo - ``` +Please read: [Add New Guides/Tutorials](/overviews/contribute/add-guides.html) From 4b34e7fa4a4a5a972026e91cc3daa76451f3489d Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 21 Mar 2022 15:19:19 +0100 Subject: [PATCH 1805/3075] integrate guide with the site --- _data/doc-nav-header.yml | 2 ++ _data/nav-header.yml | 7 ++++++- _includes/site-header.html | 2 +- _ja/scala3/contribute-to-docs.md | 4 ++-- _ja/scala3/new-in-scala3.md | 2 +- index.md | 6 +++++- scala3/contribute-to-docs.md | 4 ++-- scala3/guides.md | 2 +- scala3/index.md | 2 +- scala3/new-in-scala3.md | 2 +- 10 files changed, 22 insertions(+), 11 deletions(-) diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index a96fdb3d42..9f45227579 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -35,6 +35,8 @@ url: "/tutorials/FAQ/index.html" - title: Language Specification url: http://scala-lang.org/files/archive/spec/2.13/ + - title: Contribution Guide + url: "/overviews/contribute/" - title: Style Guide url: "/style/index.html" - title: Cheatsheet diff --git a/_data/nav-header.yml b/_data/nav-header.yml index 26bd280020..a9d2f9ab38 100644 --- a/_data/nav-header.yml +++ b/_data/nav-header.yml @@ -1,12 +1,17 @@ - title: Documentation url: "/" + can-highlight: true - title: Download url: https://www.scala-lang.org/download/ + can-highlight: true - title: Community url: https://www.scala-lang.org/community/ + can-highlight: true - title: Libraries url: https://index.scala-lang.org + can-highlight: true - title: Contribute - url: https://www.scala-lang.org/contribute/ + url: /overviews/contribute/ - title: Blog url: https://www.scala-lang.org/blog/ + can-highlight: true diff --git a/_includes/site-header.html b/_includes/site-header.html index 31f2bc2a38..70f1cb6840 100644 --- a/_includes/site-header.html +++ b/_includes/site-header.html @@ -10,7 +10,7 @@ diff --git a/_ja/scala3/contribute-to-docs.md b/_ja/scala3/contribute-to-docs.md index 2902ff1d2a..c13b4b0904 100644 --- a/_ja/scala3/contribute-to-docs.md +++ b/_ja/scala3/contribute-to-docs.md @@ -45,8 +45,8 @@ Scala 3 の高品質なドキュメンテーションを作るためのいくつ - [Source](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-migration) - [Issues](https://github.com/scalacenter/docs.scala-lang/issues) -## Scala 3 Contribution Guide -[Scala 3 Contribution Guide](/scala3/guides/contribution/contribution-intro.html) +## Scala 3 Contributing Guide +[Scala 3 Contributing Guide](/scala3/guides/contribution/contribution-intro.html) Scala 3 コンパイラとライブラリへの貢献と内部に関する包括的な概要が含まれています - [Source](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-contribution) diff --git a/_ja/scala3/new-in-scala3.md b/_ja/scala3/new-in-scala3.md index eea8ee14ca..8e69859268 100644 --- a/_ja/scala3/new-in-scala3.md +++ b/_ja/scala3/new-in-scala3.md @@ -13,7 +13,7 @@ Scala 3 は Scala 2 から大幅な改善が行われ、さまざまな新機能 - [Syntax Summary][syntax-summary] では Scala 3 で新しく追加されたシンタックスを解説している。 - [Language Reference][reference] を見ればScala 2 と Scala 3 の変更点を詳しく確認できる。 - Scala 2 から Scala 3 への移行を考えている方は[Migration Guide][migration] を参照。 -- [Contribution Guide][contribution] は、問題を修正するためのガイドを含め、コンパイラーをさらに深く掘り下げます。 +- [Scala 3 Contributing Guide][contribution] は、問題を修正するためのガイドを含め、コンパイラーをさらに深く掘り下げます。 ## What's new in Scala 3 Scala 3 は Scala 2 を徹底的に見直して再設計されている。核心部分で、型システムの多くの面が変更されより原理原則に基づいたものになった。この変更によって新機能(ユニオン型)が使えるようになったことにくわえて、なにより型システムがさらに使いやすくなった。 例えば、[型推論][type-inference] や overload resolution が改善された. diff --git a/index.md b/index.md index 7e778ec83c..aacc00e221 100644 --- a/index.md +++ b/index.md @@ -40,7 +40,7 @@ scala3-sections: description: "The Scala 3 language reference." icon: "fa fa-book" link: /scala3/reference/overview.html - - title: "Contribution Guide" + - title: "Scala 3 Contributing Guide" description: "Guide to the Scala 3 Compiler and fixing an issue" icon: "fa fa-cogs" link: /scala3/guides/contribution/contribution-intro.html @@ -118,4 +118,8 @@ scala2-sections: description: "The Scala Improvement Process. Language & compiler evolution." icon: "fa fa-cogs" link: /sips/index.html + - title: "Contributing to Scala" + description: "The Complete Guide to Contributing to the Scala Project" + icon: "fa fa-cogs" + link: /overviews/contribute/ --- diff --git a/scala3/contribute-to-docs.md b/scala3/contribute-to-docs.md index 5a2a336440..d39ba71ec4 100644 --- a/scala3/contribute-to-docs.md +++ b/scala3/contribute-to-docs.md @@ -45,8 +45,8 @@ a tour presenting the migration tools, and detailed migration guides. - [Source](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-migration) - [Issues](https://github.com/scala/docs.scala-lang/issues) -## Scala 3 Contribution Guide -The [Scala 3 Contribution Guide](/scala3/guides/contribution/contribution-intro.html) +## Scala 3 Contributing Guide +The [Scala 3 Contributing Guide](/scala3/guides/contribution/contribution-intro.html) contains a comprehensive overview over contribution to and internals of the Scala 3 compiler and libraries - [Source](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-contribution) diff --git a/scala3/guides.md b/scala3/guides.md index 812cedb611..26110b10ba 100644 --- a/scala3/guides.md +++ b/scala3/guides.md @@ -18,7 +18,7 @@ guides: icon: birthday-cake url: "/scala3/guides/tasty-overview.html" description: "An overview over the TASTy format aimed at end-users of the Scala language." - - title: "Contribution Guide" + - title: "Scala 3 Contributing Guide" by: Jamie Thompson, Anatolii Kmetiuk icon: cogs url: "/scala3/guides/contribution/contribution-intro.html" diff --git a/scala3/index.md b/scala3/index.md index 7c741fd931..a34c19a1ca 100644 --- a/scala3/index.md +++ b/scala3/index.md @@ -40,7 +40,7 @@ sections: description: "The Scala 3 language reference." icon: "fa fa-book" link: /scala3/reference/overview.html - - title: "Contribution Guide" + - title: "Scala 3 Contributing Guide" description: "Guide to the Scala 3 Compiler and fixing an issue" icon: "fa fa-cogs" link: /scala3/guides/contribution/contribution-intro.html diff --git a/scala3/new-in-scala3.md b/scala3/new-in-scala3.md index 9a1e9da872..af6d6111c1 100644 --- a/scala3/new-in-scala3.md +++ b/scala3/new-in-scala3.md @@ -11,7 +11,7 @@ changes. If you want to dig deeper, there are a few references at your disposal: - The [Syntax Summary][syntax-summary] provides you with a formal description of the new syntax. - The [Language Reference][reference] gives a detailed description of the changes from Scala 2 to Scala 3. - The [Migration Guide][migration] provides you with all of the information necessary to move from Scala 2 to Scala 3. -- The [Contribution Guide][contribution] dives deeper into the compiler, including a guide to fix issues. +- The [Scala 3 Contributing Guide][contribution] dives deeper into the compiler, including a guide to fix issues. ## What's new in Scala 3 Scala 3 is a complete overhaul of the Scala language. At its core, many aspects From aa00e9cd6626ada8738267b9fb8a50f5378dfe0c Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 21 Mar 2022 12:17:23 -0500 Subject: [PATCH 1806/3075] update status of JDK 8 also change AdoptOpenJDK->Temurin also move some GraalVM text to a more appropriate location --- _overviews/jdk-compatibility/overview.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 9eb850a77f..c00fd2f05f 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -26,13 +26,11 @@ Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platfo ## Running versus compiling -JDK 8, 11, and 17 are all good choices both for *compiling* and *running* Scala code. +JDK 8, 11, and 17 are all reasonable choices both for *compiling* and *running* Scala code. Since the JVM is normally backwards compatible, it is usually safe to use a newer JVM for *running* your code than the one it was compiled on, especially if you are not using JVM features designated "experimental" or "unsafe". -If you compile on JDK 11+ but have users on an older JDK version, additional care is needed to avoid using APIs and features that don't exist in 8. Therefore, *compiling* on 8 may be the safest choice in this scenario. (Some Scala developers use JDK 11 or 17 for their daily work, but do release builds on JDK 8.) - -Additionally, you can also run your Scala application on GraalVM which is a JVM. GraalVM performs well on the Scala benchmarks, and it benefits from GraalVM runtime and runs faster too. +JDK 8 remains in use at many shops (as of early 2022), but usage is declining and some projects are dropping support. If you compile on JDK 11+ but want to allow your users to stay on 8, additional care is needed to avoid using APIs and features that don't exist in 8. (For this reason, some Scala developers use JDK 11 or 17 for their daily work but do release builds on JDK 8.) ## Long Term Support (LTS) versions @@ -50,9 +48,9 @@ In almost every case, you're free to use the JDK and JVM of your choice. JDK 8 users typically use the Oracle JDK or some flavor of OpenJDK. -Most JDK 11+ users are using either OpenJDK or GraalVM which runs in the context of OpenJDK. +Most JDK 11+ users are using OpenJDK, or GraalVM which runs in the context of OpenJDK. GraalVM performs well on the Scala benchmarks, and it benefits from GraalVM runtime and runs faster too. -OpenJDK comes in various flavors, offered by different providers. We build and test Scala using [AdoptOpenJDK](https://adoptopenjdk.net) in particular, but the differences are unlikely to matter to most users. +OpenJDK comes in various flavors, offered by different providers. We build and test Scala using [Temurin](https://adoptium.net) primarily, but the differences are unlikely to matter to most users. ## JDK 11 compatibility notes From 302bfbff1dc497bd07acaf9c5596ec94f8d50aa0 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Tue, 22 Mar 2022 16:00:44 +0100 Subject: [PATCH 1807/3075] revert to /contribute/ urls --- README.md | 2 +- _config.yml | 8 +++++ _contribute_resources/1-documentation.md | 4 +-- _contribute_resources/2-bug-fixes.md | 4 +-- _contribute_resources/3-code-reviews.md | 2 +- _contribute_resources/4-core-libraries.md | 2 +- .../5-ide-and-build-tools.md | 2 +- _contribute_resources/6-compiler-language.md | 2 +- _data/doc-nav-header.yml | 2 +- _data/nav-header.yml | 2 +- _overviews/contribute/add-guides.md | 3 -- _overviews/contribute/bug-reporting-guide.md | 3 -- _overviews/contribute/codereviews.md | 7 ++--- _overviews/contribute/corelibs.md | 9 ++---- _overviews/contribute/documentation.md | 13 +++----- _overviews/contribute/guide.md | 31 +++++++++---------- _overviews/contribute/hacker-guide.md | 5 +-- .../contribute/inclusive-language-guide.md | 3 -- _overviews/contribute/index.md | 7 ++--- _overviews/contribute/partest-guide.md | 3 -- _overviews/contribute/scala-internals.md | 3 -- ...cala-standard-library-api-documentation.md | 7 ++--- _overviews/contribute/tools.md | 7 ++--- contribute.md | 2 +- index.md | 2 +- 25 files changed, 52 insertions(+), 83 deletions(-) diff --git a/README.md b/README.md index ee37fe58d4..fe377e9f6b 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ For more details on the Docker option, see [this issue](https://github.com/scala ## Contributing ## -Please have a look at [Add New Guides/Tutorials](https://docs.scala-lang.org/overviews/contribute/add-guides.html) before making a contribution. +Please have a look at [Add New Guides/Tutorials](https://docs.scala-lang.org/contribute/add-guides.html) before making a contribution. This document gives an overview of the type of documentation contained within the Scala Documentation repository and the repository's structure. Small changes, or corrected typos will generally be pulled in right away. Large changes, like the addition of new documents, or the rewriting of diff --git a/_config.yml b/_config.yml index 0d58e58a8f..43f6dfd536 100644 --- a/_config.yml +++ b/_config.yml @@ -105,6 +105,14 @@ defaults: overview-name: "Scala 3 — Book" layout: multipage-overview permalink: "/scala3/book/:title.html" + - + scope: + path: "_overviews/contribute" + values: + partof: scala-contribution + overview-name: Contributing to Scala + layout: multipage-overview + permalink: "/contribute/:title.html" - scope: path: "_overviews/scala3-migration" diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md index 7515ff7519..474bea075f 100644 --- a/_contribute_resources/1-documentation.md +++ b/_contribute_resources/1-documentation.md @@ -1,6 +1,6 @@ --- title: Documentation -link: /overviews/contribute/documentation.html +link: /contribute/documentation.html icon: fa fa-book --- -[Scaladoc (API)](/overviews/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](/overviews/contribute/add-guides.html) and [scala-lang.org](https://github.com/scala/scala-lang). +[Scaladoc (API)](/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](/contribute/add-guides.html) and [scala-lang.org](https://github.com/scala/scala-lang). diff --git a/_contribute_resources/2-bug-fixes.md b/_contribute_resources/2-bug-fixes.md index 2baf672e5a..54e6d2cf9d 100644 --- a/_contribute_resources/2-bug-fixes.md +++ b/_contribute_resources/2-bug-fixes.md @@ -1,6 +1,6 @@ --- title: Bug fixes -link: /overviews/contribute/guide.html +link: /contribute/guide.html icon: fa fa-bug --- -Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/overviews/contribute/bug-reporting-guide.html). +Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/contribute/bug-reporting-guide.html). diff --git a/_contribute_resources/3-code-reviews.md b/_contribute_resources/3-code-reviews.md index e6f15e271c..e03305beb5 100644 --- a/_contribute_resources/3-code-reviews.md +++ b/_contribute_resources/3-code-reviews.md @@ -1,6 +1,6 @@ --- title: Code Reviews -link: /overviews/contribute/codereviews.html +link: /contribute/codereviews.html icon: fa fa-eye --- Review pull requests against [scala/scala](https://github.com/scala/scala/pulls), diff --git a/_contribute_resources/4-core-libraries.md b/_contribute_resources/4-core-libraries.md index fb66a906b8..06f1018479 100644 --- a/_contribute_resources/4-core-libraries.md +++ b/_contribute_resources/4-core-libraries.md @@ -1,6 +1,6 @@ --- title: Core Libraries -link: /overviews/contribute/corelibs.html +link: /contribute/corelibs.html icon: fa fa-clipboard --- Update and expand the capabilities of the core (and associated) Scala libraries. diff --git a/_contribute_resources/5-ide-and-build-tools.md b/_contribute_resources/5-ide-and-build-tools.md index 2bf2c7d729..7202f0d953 100644 --- a/_contribute_resources/5-ide-and-build-tools.md +++ b/_contribute_resources/5-ide-and-build-tools.md @@ -1,6 +1,6 @@ --- title: IDE and Build Tools -link: /overviews/contribute/tools.html +link: /contribute/tools.html icon: fa fa-terminal --- Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects. diff --git a/_contribute_resources/6-compiler-language.md b/_contribute_resources/6-compiler-language.md index a7dc618322..d54e34fac9 100644 --- a/_contribute_resources/6-compiler-language.md +++ b/_contribute_resources/6-compiler-language.md @@ -1,6 +1,6 @@ --- title: Compiler/Language -link: /overviews/contribute/guide.html#larger-changes-new-features +link: /contribute/guide.html#larger-changes-new-features icon: fa fa-cogs --- Larger language features and compiler enhancements including language specification and SIPs. diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index 9f45227579..52b66be1da 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -36,7 +36,7 @@ - title: Language Specification url: http://scala-lang.org/files/archive/spec/2.13/ - title: Contribution Guide - url: "/overviews/contribute/" + url: "/contribute/" - title: Style Guide url: "/style/index.html" - title: Cheatsheet diff --git a/_data/nav-header.yml b/_data/nav-header.yml index a9d2f9ab38..03621e6d64 100644 --- a/_data/nav-header.yml +++ b/_data/nav-header.yml @@ -11,7 +11,7 @@ url: https://index.scala-lang.org can-highlight: true - title: Contribute - url: /overviews/contribute/ + url: /contribute/ - title: Blog url: https://www.scala-lang.org/blog/ can-highlight: true diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md index c8f5e42f0c..8e638021d2 100644 --- a/_overviews/contribute/add-guides.md +++ b/_overviews/contribute/add-guides.md @@ -1,9 +1,6 @@ --- title: Add New Guides/Tutorials -layout: multipage-overview num: 7 -partof: scala-contribution -overview-name: Contributing to Scala --- ## Why Contribute New Learning Material? diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index ac6df525a5..e2637ccd09 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -1,9 +1,6 @@ --- title: Bug Reporting Guide -layout: multipage-overview num: 8 -partof: scala-contribution -overview-name: Contributing to Scala --- The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug), and for Scala 3, it is located at [github.com/lampepfl/dotty](https://github.com/lampepfl/dotty/issues). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. diff --git a/_overviews/contribute/codereviews.md b/_overviews/contribute/codereviews.md index e7dea2acea..6325fcde6c 100644 --- a/_overviews/contribute/codereviews.md +++ b/_overviews/contribute/codereviews.md @@ -1,13 +1,10 @@ --- title: Code Review Contributions -layout: multipage-overview num: 3 -partof: scala-contribution -overview-name: Contributing to Scala --- ## Code Review Contributions -In addition to [bug fixing](/overviews/contribute/guide.html), you can help us review +In addition to [bug fixing](/contribute/guide.html), you can help us review [waiting pull requests](#pull-requests-awaiting-comment). This is also a good (and recommended) way to get to know the feel of the bug-fixing and submissions process before jumping in with your @@ -57,4 +54,4 @@ own pull requests. -Also note that the [Tools contributions](/overviews/contribute/tools.html) page has more projects that will generate pull requests. +Also note that the [Tools contributions](/contribute/tools.html) page has more projects that will generate pull requests. diff --git a/_overviews/contribute/corelibs.md b/_overviews/contribute/corelibs.md index 6c64a887d7..3ee05e6c13 100644 --- a/_overviews/contribute/corelibs.md +++ b/_overviews/contribute/corelibs.md @@ -1,17 +1,14 @@ --- title: Core Library Contributions -layout: multipage-overview num: 4 -partof: scala-contribution -overview-name: Contributing to Scala --- ## Core Library Contributions There are several options for contributing to Scala's core libraries. You can: -* Help with [Documentation](/overviews/contribute/documentation.html). -* [Report Bugs or Issues](/overviews/contribute/bug-reporting-guide.html) against the core libraries. -* [Fix Bugs or Issues](/overviews/contribute/guide.html) against the +* Help with [Documentation](/contribute/documentation.html). +* [Report Bugs or Issues](/contribute/bug-reporting-guide.html) against the core libraries. +* [Fix Bugs or Issues](/contribute/guide.html) against the [reported library bugs/issues](https://github.com/scala/bug). ### Significant changes diff --git a/_overviews/contribute/documentation.md b/_overviews/contribute/documentation.md index 417f9b234a..3d3311dbce 100644 --- a/_overviews/contribute/documentation.md +++ b/_overviews/contribute/documentation.md @@ -1,9 +1,6 @@ --- title: Documentation Contributions -layout: multipage-overview num: 5 -partof: scala-contribution -overview-name: Contributing to Scala --- ## Contributing Documentation to the Scala project @@ -23,11 +20,11 @@ Thanks The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: -* [Log issues for missing scaladoc documentation](/overviews/contribute/scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - +* [Log issues for missing scaladoc documentation](/contribute/scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - Please *follow the issue submission process closely* to help prevent duplicate issues being created. -* [Claim Scaladoc Issues and Provide Documentation](/overviews/contribute/scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. +* [Claim Scaladoc Issues and Provide Documentation](/contribute/scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. * You can also just -[submit new Scaladoc](/overviews/contribute/scala-standard-library-api-documentation.html) +[submit new Scaladoc](/contribute/scala-standard-library-api-documentation.html) without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on [Scala Contributors](https://contributors.scala-lang.org/) so that people know what you are doing. ### The Main Scala Documentation Site @@ -44,7 +41,7 @@ without creating an issue, but please look to see if there is an issue already s * SIP (Scala Improvement Process) Proposals and more -Please read [Add New Guides/Tutorials](/overviews/contribute/add-guides.html) through before embarking on changes. The site uses +Please read [Add New Guides/Tutorials](/contribute/add-guides.html) through before embarking on changes. The site uses the [Jekyll](https://jekyllrb.com/) markdown engine so you will need to follow the instructions to get that running as well. ### Updating scala-lang.org @@ -55,4 +52,4 @@ to Scala and related projects) is provided on the main [scala-lang GitHub project](https://github.com/scala/scala-lang) which may be forked to create pull requests. Please read both the -[Add New Guides/Tutorials](/overviews/contribute/add-guides.html) document and the [scala-lang.org GitHub README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. +[Add New Guides/Tutorials](/contribute/add-guides.html) document and the [scala-lang.org GitHub README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index 802e3c387c..70d470d454 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -1,9 +1,6 @@ --- title: Contributing guide -layout: multipage-overview num: 10 -partof: scala-contribution -overview-name: Contributing to Scala --- | **Shortcut** | **Description** | @@ -41,19 +38,19 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [GitHub branch](https://github.com/scala/scala) -1. [Select a bug to fix from GitHub](/overviews/contribute/index.html#community-tickets), or if you found the bug yourself and want to fix it, [create a GitHub issue](/overviews/contribute/bug-reporting-guide.html) (but please -[make sure it's not a duplicate](/overviews/contribute/bug-reporting-guide.html#please-check-before-reporting-a-bug)). -2. Optional ([but recommended](/overviews/contribute/scala-internals.html/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with -[these friendly people](/overviews/contribute/hacker-guide.html#1-connect) - it's one of the perks of contributing. -3. [Fork the Scala repository](/overviews/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). -4. [Create a feature branch](/overviews/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the GitHub issue number. -5. [Fix the bug, or implement the new small feature](/overviews/contribute/hacker-guide.html#implement), include new tests (yes, for bug fixes too). -6. [Test, rinse](/overviews/contribute/hacker-guide.html#test) and [test some more](/overviews/contribute/partest-guide.html) until [all the tests pass](/overviews/contribute/hacker-guide.html#verify). -7. [Commit your changes](/overviews/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. +1. [Select a bug to fix from GitHub](/contribute/index.html#community-tickets), or if you found the bug yourself and want to fix it, [create a GitHub issue](/contribute/bug-reporting-guide.html) (but please +[make sure it's not a duplicate](/contribute/bug-reporting-guide.html#please-check-before-reporting-a-bug)). +2. Optional ([but recommended](/contribute/scala-internals.html/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with +[these friendly people](/contribute/hacker-guide.html#1-connect) - it's one of the perks of contributing. +3. [Fork the Scala repository](/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). +4. [Create a feature branch](/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the GitHub issue number. +5. [Fix the bug, or implement the new small feature](/contribute/hacker-guide.html#implement), include new tests (yes, for bug fixes too). +6. [Test, rinse](/contribute/hacker-guide.html#test) and [test some more](/contribute/partest-guide.html) until [all the tests pass](/contribute/hacker-guide.html#verify). +7. [Commit your changes](/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. 8. If necessary [re-write git history](https://git-scm.com/book/en/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) -9. [Submit a pull request](/overviews/contribute/hacker-guide.html#submit). -10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/overviews/contribute/hacker-guide.html#review). +9. [Submit a pull request](/contribute/hacker-guide.html#submit). +10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/contribute/hacker-guide.html#review). 11. Celebrate! Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide][hackers] (or the [equivalent Scala 3 Contributing Guide][scala3-hackers]) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). @@ -67,8 +64,8 @@ on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list a Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against the Scala project source tree. The hacker's guides ([Scala 2][hackers], or [Scala 3][scala3-hackers]) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. -[hackers]: /overviews/contribute/hacker-guide.html -[community-tickets]: /overviews/contribute/index.html#community-tickets -[bug-reporting-guide]: /overviews/contribute/bug-reporting-guide.html +[hackers]: /contribute/hacker-guide.html +[community-tickets]: /contribute/index.html#community-tickets +[bug-reporting-guide]: /contribute/bug-reporting-guide.html [scala3-hackers]: {% link _overviews/scala3-contribution/procedures-intro.md %} [contrib-forum]: https://contributors.scala-lang.org/ diff --git a/_overviews/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md index f342c98040..f9db614056 100644 --- a/_overviews/contribute/hacker-guide.md +++ b/_overviews/contribute/hacker-guide.md @@ -1,10 +1,7 @@ --- title: Scala hacker guide by: Eugene Burmako -layout: multipage-overview num: 12 -partof: scala-contribution -overview-name: Contributing to Scala ---
    This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea. @@ -310,7 +307,7 @@ This means your change is backward or forward binary incompatible with the speci ### Verify -Now to make sure that my fix doesn't break anything I need to run the test suite. The Scala test suite uses [JUnit](https://junit.org/junit4/) and [partest](/overviews/contribute/partest-guide.html), a tool we wrote for testing Scala. +Now to make sure that my fix doesn't break anything I need to run the test suite. The Scala test suite uses [JUnit](https://junit.org/junit4/) and [partest](/contribute/partest-guide.html), a tool we wrote for testing Scala. Run `sbt test` and `sbt partest` to run all of the JUnit and partest tests, respectively. `partest` (not `sbt partest`) also allows you to run a subset of the tests using wildcards: diff --git a/_overviews/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md index 7f7c428f42..375d988158 100644 --- a/_overviews/contribute/inclusive-language-guide.md +++ b/_overviews/contribute/inclusive-language-guide.md @@ -1,9 +1,6 @@ --- title: Inclusive Language Guide -layout: multipage-overview num: 2 -partof: scala-contribution -overview-name: Contributing to Scala --- We are committed to providing a friendly, safe and welcoming environment for diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index b89f04803a..eb0596d802 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -1,9 +1,6 @@ --- title: Contribute -layout: multipage-overview num: 1 -partof: scala-contribution -overview-name: Contributing to Scala --- The Scala programming language is an open source project with a very @@ -18,7 +15,7 @@ That depends on what you want to contribute. Below are some getting started reso ### Reporting bugs -See our [bug reporting guide](/overviews/contribute/bug-reporting-guide.html) to learn +See our [bug reporting guide](/contribute/bug-reporting-guide.html) to learn how to efficiently report a bug. ### Contribute @@ -33,7 +30,7 @@ Coordination of contribution efforts takes place on When contributing, please follow: * The [Scala Code of Conduct](https://scala-lang.org/conduct/) -* The [Inclusive Language Guide](/overviews/contribute/inclusive-language-guide.html) +* The [Inclusive Language Guide](/contribute/inclusive-language-guide.html) ### Community Tickets diff --git a/_overviews/contribute/partest-guide.md b/_overviews/contribute/partest-guide.md index 548eb8d5e6..c3e6980b06 100644 --- a/_overviews/contribute/partest-guide.md +++ b/_overviews/contribute/partest-guide.md @@ -1,9 +1,6 @@ --- title: Running the Test Suite -layout: multipage-overview num: 13 -partof: scala-contribution -overview-name: Contributing to Scala --- Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go to the scala project folder from your local checkout and run it via `sbt`, `ant` or standalone as follows. diff --git a/_overviews/contribute/scala-internals.md b/_overviews/contribute/scala-internals.md index 5f391947fa..f3b1de54de 100644 --- a/_overviews/contribute/scala-internals.md +++ b/_overviews/contribute/scala-internals.md @@ -1,9 +1,6 @@ --- title: Scala Contributors Forum -layout: multipage-overview num: 9 -partof: scala-contribution -overview-name: Contributing to Scala --- The [Scala Contributors Forum][scala-contributors] is where discussions about the Scala ecosystem diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md index 99f1bb16e0..606407f886 100644 --- a/_overviews/contribute/scala-standard-library-api-documentation.md +++ b/_overviews/contribute/scala-standard-library-api-documentation.md @@ -1,9 +1,6 @@ --- title: Contribute to API Documentation -layout: multipage-overview num: 6 -partof: scala-contribution -overview-name: Contributing to Scala --- This page is specific to API documentation contributions – that is, API @@ -13,7 +10,7 @@ sometimes referred to as Scaladoc contributions. For contributions to tutorial and guide-style documentation on [docs.scala-lang.org](/), -see [Add New Guides/Tutorials](/overviews/contribute/add-guides.html). +see [Add New Guides/Tutorials](/contribute/add-guides.html). *Please note, these instructions cover documentation contributions Scala core libraries only. For other Scala projects please check those projects for the @@ -79,7 +76,7 @@ component so that they show up in the correct issue filters. Please familiarize yourself with the following before contributing new API documentation to save time, effort, mistakes and repetition. -* [Forking the Repo](/overviews/contribute/hacker-guide.html#2-set-up) - follow the setup steps through +* [Forking the Repo](/contribute/hacker-guide.html#2-set-up) - follow the setup steps through the Branch section. If providing new documentation related to an existing GitHub issue, use `issue/NNNN` or `ticket/NNNN` as the guide states. If providing API documentation with no associated GitHub issue, use `scaladoc/xxxx` instead. diff --git a/_overviews/contribute/tools.md b/_overviews/contribute/tools.md index 875160ca96..68cee7796f 100644 --- a/_overviews/contribute/tools.md +++ b/_overviews/contribute/tools.md @@ -1,9 +1,6 @@ --- title: IDE and Build Tool Contributions -layout: multipage-overview num: 11 -partof: scala-contribution -overview-name: Contributing to Scala # Projects list: projects: @@ -22,7 +19,7 @@ projects: homeLink: https://www.scala-lang.org/api issuesLink: https://github.com/scala/bug/labels/scaladoc readmeLink: https://github.com/scala/scala#welcome - contributingLink: /overviews/contribute/guide.html + contributingLink: /contribute/guide.html - title: Partest description: Scala Compiler/Library Testing (Contribute through scala/scala) icon: https://avatars1.githubusercontent.com/u/57059?v=3&s=200 @@ -50,7 +47,7 @@ if you would like to help revive them. ### Broken Links? -Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/overviews/contribute/documentation.html#updating-scala-langorg) to fix it. +Stuff changes. Found a broken link or something that needs updating on this page? Please, consider [submitting a documentation pull request](/contribute/documentation.html#updating-scala-langorg) to fix it. ### Projects diff --git a/contribute.md b/contribute.md index 4a7d38faec..02a8e4b8d7 100644 --- a/contribute.md +++ b/contribute.md @@ -23,4 +23,4 @@ If you're interested in contributing to the Scala project in general, I argue th ## How Can I Contribute? -Please read: [Add New Guides/Tutorials](/overviews/contribute/add-guides.html) +Please read: [Add New Guides/Tutorials](/contribute/add-guides.html) diff --git a/index.md b/index.md index aacc00e221..5790ce8b7c 100644 --- a/index.md +++ b/index.md @@ -121,5 +121,5 @@ scala2-sections: - title: "Contributing to Scala" description: "The Complete Guide to Contributing to the Scala Project" icon: "fa fa-cogs" - link: /overviews/contribute/ + link: /contribute/ --- From 573e494856dd4138c155d7e6dbb7492b2e21ad28 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Tue, 22 Mar 2022 16:59:40 +0100 Subject: [PATCH 1808/3075] use jekyll link tag to render internal links --- _contribute_resources/1-documentation.md | 5 ++- _contribute_resources/2-bug-fixes.md | 4 +- _includes/column-list-of-items.html | 2 +- _overviews/contribute/add-guides.md | 11 +++-- _overviews/contribute/bug-reporting-guide.md | 4 +- _overviews/contribute/codereviews.md | 7 ++- _overviews/contribute/corelibs.md | 10 +++-- _overviews/contribute/documentation.md | 17 +++++--- _overviews/contribute/guide.md | 43 ++++++++++++------- _overviews/contribute/hacker-guide.md | 12 ++++-- _overviews/contribute/index.md | 7 ++- ...cala-standard-library-api-documentation.md | 16 ++++--- 12 files changed, 94 insertions(+), 44 deletions(-) diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md index 474bea075f..1f42a6e20b 100644 --- a/_contribute_resources/1-documentation.md +++ b/_contribute_resources/1-documentation.md @@ -3,4 +3,7 @@ title: Documentation link: /contribute/documentation.html icon: fa fa-book --- -[Scaladoc (API)](/contribute/scala-standard-library-api-documentation.html), [docs.scala-lang.org](/contribute/add-guides.html) and [scala-lang.org](https://github.com/scala/scala-lang). +[Scaladoc (API)][scala-standard-library-api-documentation], [docs.scala-lang.org][add-guides] and [scala-lang.org](https://github.com/scala/scala-lang). + +[add-guides]: {% link _overviews/contribute/add-guides.md %} +[scala-standard-library-api-documentation]: {% link _overviews/contribute/scala-standard-library-api-documentation.md %} diff --git a/_contribute_resources/2-bug-fixes.md b/_contribute_resources/2-bug-fixes.md index 54e6d2cf9d..7026e7e15b 100644 --- a/_contribute_resources/2-bug-fixes.md +++ b/_contribute_resources/2-bug-fixes.md @@ -3,4 +3,6 @@ title: Bug fixes link: /contribute/guide.html icon: fa fa-bug --- -Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs](/contribute/bug-reporting-guide.html). +Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs][bug-reporting-guide]. + +[bug-reporting-guide]: {% link _overviews/contribute/bug-reporting-guide.md %} diff --git a/_includes/column-list-of-items.html b/_includes/column-list-of-items.html index eb9e1600be..2ce303e678 100644 --- a/_includes/column-list-of-items.html +++ b/_includes/column-list-of-items.html @@ -15,4 +15,4 @@

    {{item.title}}

    {% endfor %} - \ No newline at end of file + diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md index 8e638021d2..96091fb311 100644 --- a/_overviews/contribute/add-guides.md +++ b/_overviews/contribute/add-guides.md @@ -5,7 +5,7 @@ num: 7 ## Why Contribute New Learning Material? -As [Heather Miller writes](/contribute.html), contributing to [docs.scala-lang.org](https://docs.scala-lang.org) is +As [Heather Miller writes][why-contribute], contributing to [docs.scala-lang.org][home] is critical to making Scala accessible to newcomers, experience programmers, and anyone who is curious. It is also a fantastic way to contribute for anyone who is comfortable using Scala, but maybe does not want to get involved with complex tools like the compiler. @@ -45,7 +45,7 @@ For one to contribute a document, one must simply [repo](https://github.com/scala/docs.scala-lang), write their article in [Markdown](https://daringfireball.net/projects/markdown/syntax) (example below), and submit a pull request. That's it. Likely after some edits and discussion, your document will be made live -on [docs.scala-lang.org](https://docs.scala-lang.org). +on [docs.scala-lang.org][home]. --- layout: overview @@ -71,7 +71,7 @@ styling is already taken care of for you. ### Criteria for Docs to be Accepted The goal of this documentation repository is to be tighter and more organized than other community-driven documentation platforms, like wikis. As such, any document pulled in for inclusion on -[docs.scala-lang.org](https://docs.scala-lang.org) must: +[docs.scala-lang.org][home] must: - **"fit in"** to the repository ( _i.e.,_ it should not be a complete duplicate of another article), - **be polished** it must be thorough, complete, correct, organized, and "article-like" (personal programming notes @@ -129,7 +129,7 @@ documents in the large overview. Putting it on the last page in the overview is outof: 15 --- -Index pages, such as [docs.scala-lang.org/overviews/index.html](https://docs.scala-lang.org/overviews/index.html) are +Index pages, such as [docs.scala-lang.org/overviews/index.html][overviews-index] are generated, by reading data from a configuration file, such as `_data/overviews.yml`, so your overview should be placed into a category there. @@ -216,3 +216,6 @@ above. Here is an example using the various modifiers. [collections-overview]: {% link _overviews/collections-2.13/introduction.md %} [scala-with-maven]: {% link _overviews/tutorials/scala-with-maven.md %} +[why-contribute]: {% link contribute.md %} +[home]: {% link index.md %} +[overviews-index]: {% link _overviews/index.md %} diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index e2637ccd09..91858d589c 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -41,7 +41,7 @@ If you have a code snippet that is resulting in bytecode which you believe is be 5. If you want to file an improvement in the issue tracker please discuss it first on one of the mailing lists. They offer much bigger audience than issue tracker. The latter is not suitable for long discussions. -* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](https://docs.scala-lang.org/sips/) or in the [Scala Language Specification](https://www.scala-lang.org/files/archive/spec/2.13/). If in doubt, you may always ask on the [Community Category](https://contributors.scala-lang.org/c/community) or [Stack Overflow](https://stackoverflow.com/questions/tagged/scala). +* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents][sips] or in the [Scala Language Specification](https://www.scala-lang.org/files/archive/spec/2.13/). If in doubt, you may always ask on the [Community Category](https://contributors.scala-lang.org/c/community) or [Stack Overflow](https://stackoverflow.com/questions/tagged/scala). In general, if you find yourself stuck on any of these steps, asking on [Scala Contributors](https://contributors.scala-lang.org/) can be helpful: @@ -85,3 +85,5 @@ List(1, 2, 3).map(x => x + 1) 3. The actual output, including the stacktrace. 4. Related discussion on the mailing lists, if applicable. 5. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. + +[sips]: {% link _sips/index.md %} diff --git a/_overviews/contribute/codereviews.md b/_overviews/contribute/codereviews.md index 6325fcde6c..be8e66ba46 100644 --- a/_overviews/contribute/codereviews.md +++ b/_overviews/contribute/codereviews.md @@ -4,7 +4,7 @@ num: 3 --- ## Code Review Contributions -In addition to [bug fixing](/contribute/guide.html), you can help us review +In addition to [bug fixing][bug-fixing], you can help us review [waiting pull requests](#pull-requests-awaiting-comment). This is also a good (and recommended) way to get to know the feel of the bug-fixing and submissions process before jumping in with your @@ -54,4 +54,7 @@ own pull requests. -Also note that the [Tools contributions](/contribute/tools.html) page has more projects that will generate pull requests. +Also note that the [Tools contributions][tools] page has more projects that will generate pull requests. + +[bug-fixing]: {% link _overviews/contribute/guide.md %} +[tools]: {% link _overviews/contribute/tools.md %} diff --git a/_overviews/contribute/corelibs.md b/_overviews/contribute/corelibs.md index 3ee05e6c13..1eb2f840b0 100644 --- a/_overviews/contribute/corelibs.md +++ b/_overviews/contribute/corelibs.md @@ -6,12 +6,16 @@ num: 4 There are several options for contributing to Scala's core libraries. You can: -* Help with [Documentation](/contribute/documentation.html). -* [Report Bugs or Issues](/contribute/bug-reporting-guide.html) against the core libraries. -* [Fix Bugs or Issues](/contribute/guide.html) against the +* Help with [Documentation][documentation]. +* [Report Bugs or Issues][bug-reporting-guide] against the core libraries. +* [Fix Bugs or Issues][guide] against the [reported library bugs/issues](https://github.com/scala/bug). ### Significant changes For significant new functionality or a whole new API to be considered for inclusion in the core Scala distribution, please take into account [https://github.com/scala/scala-dev/issues/661] before doing so. + +[documentation]: {% link _overviews/contribute/documentation.md %} +[bug-reporting-guide]: {% link _overviews/contribute/bug-reporting-guide.md %} +[guide]: {% link _overviews/contribute/guide.md %} diff --git a/_overviews/contribute/documentation.md b/_overviews/contribute/documentation.md index 3d3311dbce..9bd4597b36 100644 --- a/_overviews/contribute/documentation.md +++ b/_overviews/contribute/documentation.md @@ -20,16 +20,16 @@ Thanks The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: -* [Log issues for missing scaladoc documentation](/contribute/scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - +* [Log issues for missing scaladoc documentation][report-api-doc-bugs] - Please *follow the issue submission process closely* to help prevent duplicate issues being created. -* [Claim Scaladoc Issues and Provide Documentation](/contribute/scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. +* [Claim Scaladoc Issues and Provide Documentation][scala-standard-library-api-documentation] - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. * You can also just -[submit new Scaladoc](/contribute/scala-standard-library-api-documentation.html) +[submit new Scaladoc][scala-standard-library-api-documentation] without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on [Scala Contributors](https://contributors.scala-lang.org/) so that people know what you are doing. ### The Main Scala Documentation Site -[docs.scala-lang.org](https://docs.scala-lang.org/) houses the primary source of written, non-API documentation for Scala. It's a GitHub project that you can fork and submit pull requests from. It includes: +[docs.scala-lang.org][home] houses the primary source of written, non-API documentation for Scala. It's a GitHub project that you can fork and submit pull requests from. It includes: * Overviews * Tutorials @@ -41,7 +41,7 @@ without creating an issue, but please look to see if there is an issue already s * SIP (Scala Improvement Process) Proposals and more -Please read [Add New Guides/Tutorials](/contribute/add-guides.html) through before embarking on changes. The site uses +Please read [Add New Guides/Tutorials][add-guides] through before embarking on changes. The site uses the [Jekyll](https://jekyllrb.com/) markdown engine so you will need to follow the instructions to get that running as well. ### Updating scala-lang.org @@ -52,4 +52,9 @@ to Scala and related projects) is provided on the main [scala-lang GitHub project](https://github.com/scala/scala-lang) which may be forked to create pull requests. Please read both the -[Add New Guides/Tutorials](/contribute/add-guides.html) document and the [scala-lang.org GitHub README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. +[Add New Guides/Tutorials][add-guides] document and the [scala-lang.org GitHub README](https://github.com/scala/scala-lang#scala-langorg) before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. + +[report-api-doc-bugs]: {% link _overviews/contribute/scala-standard-library-api-documentation.md %}#contribute-api-documentation-bug-reports +[scala-standard-library-api-documentation]: {% link _overviews/contribute/scala-standard-library-api-documentation.md %} +[home]: {% link index.md %} +[add-guides]: {% link _overviews/contribute/add-guides.md %} diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index 70d470d454..472d2d41ab 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -38,19 +38,19 @@ unencumbered by copyrights or patents. This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [GitHub branch](https://github.com/scala/scala) -1. [Select a bug to fix from GitHub](/contribute/index.html#community-tickets), or if you found the bug yourself and want to fix it, [create a GitHub issue](/contribute/bug-reporting-guide.html) (but please -[make sure it's not a duplicate](/contribute/bug-reporting-guide.html#please-check-before-reporting-a-bug)). -2. Optional ([but recommended](/contribute/scala-internals.html/#why-its-a-good-idea)), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with -[these friendly people](/contribute/hacker-guide.html#1-connect) - it's one of the perks of contributing. -3. [Fork the Scala repository](/contribute/hacker-guide.html#fork) and clone your fork (if you haven't already). -4. [Create a feature branch](/contribute/hacker-guide.html#branch) to work on: use the branch name `issue/NNNN` where NNNN is the GitHub issue number. -5. [Fix the bug, or implement the new small feature](/contribute/hacker-guide.html#implement), include new tests (yes, for bug fixes too). -6. [Test, rinse](/contribute/hacker-guide.html#test) and [test some more](/contribute/partest-guide.html) until [all the tests pass](/contribute/hacker-guide.html#verify). -7. [Commit your changes](/contribute/hacker-guide.html#commit) to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. +1. [Select a bug to fix from GitHub][community-tickets], or if you found the bug yourself and want to fix it, [create a GitHub issue][bug-reporting-guide] (but please +[make sure it's not a duplicate][bug-report-check-dupes]). +2. Optional ([but recommended][why-its-a-good-idea]), announce your intention to work on the bug on [Scala Contributors](https://contributors.scala-lang.org/). After all, don't you want to work on a team with +[these friendly people][hackers-connect] - it's one of the perks of contributing. +3. [Fork the Scala repository][hackers-fork] and clone your fork (if you haven't already). +4. [Create a feature branch][hackers-branch] to work on: use the branch name `issue/NNNN` where NNNN is the GitHub issue number. +5. [Fix the bug, or implement the new small feature][hackers-implement], include new tests (yes, for bug fixes too). +6. [Test, rinse][hackers-test] and [test some more][partest-guide] until [all the tests pass][hackers-verify]. +7. [Commit your changes][hackers-commit] to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. 8. If necessary [re-write git history](https://git-scm.com/book/en/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) -9. [Submit a pull request](/contribute/hacker-guide.html#submit). -10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in](/contribute/hacker-guide.html#review). +9. [Submit a pull request][hackers-submit]. +10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in][hackers-review]. 11. Celebrate! Need more information or a little more hand-holding for the first one? We got you covered: take a read through the entire [Hacker Guide][hackers] (or the [equivalent Scala 3 Contributing Guide][scala3-hackers]) for an example of implementing a new feature (some of the steps can be skipped for bug fixes, this will be obvious from reading it, but many of the steps here will help with bug fixes too). @@ -59,13 +59,26 @@ Need more information or a little more hand-holding for the first one? We got yo For larger, more ambitious changes (e.g. new language features), the first step to making a change is to discuss it with the community at large, to make sure everyone agrees on the idea and on the implementation plan. Announce the change -on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](https://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list and if a SIP is required, that will be discussed on the mailing list. +on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)][sips] document might be required, but the first step is always to discuss it on the mailing list and if a SIP is required, that will be discussed on the mailing list. Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against the Scala project source tree. The hacker's guides ([Scala 2][hackers], or [Scala 3][scala3-hackers]) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. -[hackers]: /contribute/hacker-guide.html -[community-tickets]: /contribute/index.html#community-tickets -[bug-reporting-guide]: /contribute/bug-reporting-guide.html +[hackers]: {% link _overviews/contribute/hacker-guide.md %} +[community-tickets]: {% link _overviews/contribute/index.md %}#community-tickets +[bug-reporting-guide]: {% link _overviews/contribute/bug-reporting-guide.md %} +[bug-report-check-dupes]: {% link _overviews/contribute/bug-reporting-guide.md %}#please-check-before-reporting-a-bug [scala3-hackers]: {% link _overviews/scala3-contribution/procedures-intro.md %} [contrib-forum]: https://contributors.scala-lang.org/ +[why-its-a-good-idea]: {% link _overviews/contribute/scala-internals.md %}#why-its-a-good-idea +[hackers-connect]: {% link _overviews/contribute/hacker-guide.md %}#1-connect +[hackers-fork]: {% link _overviews/contribute/hacker-guide.md %}#fork +[hackers-branch]: {% link _overviews/contribute/hacker-guide.md %}#branch +[hackers-implement]: {% link _overviews/contribute/hacker-guide.md %}#implement +[hackers-test]: {% link _overviews/contribute/hacker-guide.md %}#test +[hackers-verify]: {% link _overviews/contribute/hacker-guide.md %}#verify +[hackers-commit]: {% link _overviews/contribute/hacker-guide.md %}#commit +[hackers-submit]: {% link _overviews/contribute/hacker-guide.md %}#submit +[hackers-review]: {% link _overviews/contribute/hacker-guide.md %}#review +[partest-guide]: {% link _overviews/contribute/partest-guide.md %} +[sips]: {% link _sips/index.md %} diff --git a/_overviews/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md index f9db614056..92181003fa 100644 --- a/_overviews/contribute/hacker-guide.md +++ b/_overviews/contribute/hacker-guide.md @@ -196,7 +196,7 @@ Contributing to the Scala standard library is about the same as working on one o If documentation is necessary for some trait/class/object/method/etc in the Scala standard library, typically maintainers will include inline comments describing their design decisions or rationale for implementing things the way they have, if it is not straightforward. -If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections](/overviews/core/architecture-of-scala-collections.html), as well as a larger more general [Scala collections Guide](/overviews/collections/introduction.html) covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide](/overviews/parallel-collections/overview.html). +If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections][collections-arch], as well as a larger more general [Scala collections Guide][collections-intro] covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide][collections-par]. ##### The Scala Compiler @@ -204,7 +204,7 @@ Documentation about the internal workings of the Scala compiler is scarce, and m * [Compiler internals videos by Martin Odersky](https://www.scala-lang.org/old/node/598.html) are quite dated, but still very useful. In this three-video series Martin explains the general architecture of the compiler, and the basics of the front-end, which has recently become Scala reflection API. -* [Reflection documentation](/overviews/reflection/overview.html) describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that +* [Reflection documentation][reflect-overview] describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that are used to represent Scala programs and operations defined on then. Since much of the compiler has been factored out and made accessible via the Reflection API, all of the fundamentals needed for reflection are the same for the compiler. * [Reflection and Compilers by Martin Odersky](https://channel9.msdn.com/Events/Lang-NEXT/Lang-NEXT-2012/Reflection-and-Compilers), a talk at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the architecture of the reflection API. @@ -307,7 +307,7 @@ This means your change is backward or forward binary incompatible with the speci ### Verify -Now to make sure that my fix doesn't break anything I need to run the test suite. The Scala test suite uses [JUnit](https://junit.org/junit4/) and [partest](/contribute/partest-guide.html), a tool we wrote for testing Scala. +Now to make sure that my fix doesn't break anything I need to run the test suite. The Scala test suite uses [JUnit](https://junit.org/junit4/) and [partest][partest-guide], a tool we wrote for testing Scala. Run `sbt test` and `sbt partest` to run all of the JUnit and partest tests, respectively. `partest` (not `sbt partest`) also allows you to run a subset of the tests using wildcards: @@ -378,3 +378,9 @@ workflow) and be ready to elaborate and adjust your patch if necessary. In this After your reviewer is happy with your code (usually signaled by a LGTM — “Looks good to me”), your job is done. Note that there can be a gap between a successful review and the merge, because not every reviewer has merge rights. In that case, someone else from the team will pick up your pull request and merge it. So don't be confused if your reviewer says “LGTM”, but your code doesn't get merged immediately. + +[collections-arch]: {% link _overviews/core/architecture-of-scala-collections.md %} +[collections-intro]: {% link _overviews/collections/introduction.md %} +[collections-par]: {% link _overviews/parallel-collections/overview.md %} +[reflect-overview]: {% link _overviews/reflection/overview.md %} +[partest-guide]: {% link _overviews/contribute/partest-guide.md %} diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index eb0596d802..4e94334061 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -15,7 +15,7 @@ That depends on what you want to contribute. Below are some getting started reso ### Reporting bugs -See our [bug reporting guide](/contribute/bug-reporting-guide.html) to learn +See our [bug reporting guide][bug-reporting-guide] to learn how to efficiently report a bug. ### Contribute @@ -30,7 +30,7 @@ Coordination of contribution efforts takes place on When contributing, please follow: * The [Scala Code of Conduct](https://scala-lang.org/conduct/) -* The [Inclusive Language Guide](/contribute/inclusive-language-guide.html) +* The [Inclusive Language Guide][inclusive-language-guide] ### Community Tickets @@ -63,3 +63,6 @@ open-source Scala library or tool, please visit the [community build documentation](https://github.com/scala/community-build/wiki) for guidelines on what projects are suitable for the community build and how projects can be added. + +[bug-reporting-guide]: {% link _overviews/contribute/bug-reporting-guide.md %} +[inclusive-language-guide]: {% link _overviews/contribute/inclusive-language-guide.md %} diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md index 606407f886..c1303e8b18 100644 --- a/_overviews/contribute/scala-standard-library-api-documentation.md +++ b/_overviews/contribute/scala-standard-library-api-documentation.md @@ -9,8 +9,8 @@ documentation for sometimes referred to as Scaladoc contributions. For contributions to tutorial and guide-style documentation on -[docs.scala-lang.org](/), -see [Add New Guides/Tutorials](/contribute/add-guides.html). +[docs.scala-lang.org][home], +see [Add New Guides/Tutorials][add-guides]. *Please note, these instructions cover documentation contributions Scala core libraries only. For other Scala projects please check those projects for the @@ -76,13 +76,13 @@ component so that they show up in the correct issue filters. Please familiarize yourself with the following before contributing new API documentation to save time, effort, mistakes and repetition. -* [Forking the Repo](/contribute/hacker-guide.html#2-set-up) - follow the setup steps through +* [Forking the Repo][hackers-setup] - follow the setup steps through the Branch section. If providing new documentation related to an existing GitHub issue, use `issue/NNNN` or `ticket/NNNN` as the guide states. If providing API documentation with no associated GitHub issue, use `scaladoc/xxxx` instead. -* [Scaladoc for library authors](https://docs.scala-lang.org/overviews/scaladoc/for-library-authors.html) +* [Scaladoc for library authors][scaladoc-lib-authors] covers the use of scaladoc tags, markdown and other features. -* [Scaladoc's interface](https://docs.scala-lang.org/overviews/scaladoc/interface.html) +* [Scaladoc's interface][scaladoc-interface] covers all of the features of Scaladoc's interface, e.g. switching between companions, browsing package object documentation, searching, token searches and so on. @@ -121,3 +121,9 @@ PR is merged in smoothly: as smooth and streamlined as possible. Thanks for helping us improve the Scaladoc API documentation! + +[home]: {% link index.md %} +[add-guides]: {% link _overviews/contribute/add-guides.md %} +[hackers-setup]: {% link _overviews/contribute/hacker-guide.md %}#2-set-up +[scaladoc-lib-authors]: {% link _overviews/scaladoc/for-library-authors.md %} +[scaladoc-interface]: {% link _overviews/scaladoc/interface.md %} From 7de6290af5657b4a02373222452f25daca0fe0c8 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 23 Mar 2022 18:01:50 +0100 Subject: [PATCH 1809/3075] add back Scoverage as a project in need --- _overviews/contribute/tools.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/_overviews/contribute/tools.md b/_overviews/contribute/tools.md index 68cee7796f..77115d03ab 100644 --- a/_overviews/contribute/tools.md +++ b/_overviews/contribute/tools.md @@ -30,6 +30,14 @@ projects: contributingLink: projectsInNeed: + - title: Scoverage + description: Scala code coverage tool + icon: https://avatars1.githubusercontent.com/u/5998302?v=3&s=200 + link: https://github.com/scoverage/scalac-scoverage-plugin + homeLink: http://scoverage.org/ + issuesLink: https://github.com/scoverage/scalac-scoverage-plugin/issues + readmeLink: https://github.com/scoverage/scalac-scoverage-plugin/blob/master/README.md + contributingLink: https://groups.google.com/forum/#!forum/scala-code-coverage-tool --- ## Contributing to IDE and Build Tools From e2a41dc6ad52aad13d3e07acc1971c3cbc859344 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 23 Mar 2022 19:41:21 +0100 Subject: [PATCH 1810/3075] use more accessible language in Add New Guides/Tutorials - also switch some code blocks to explicit html so that mdoc code blocks are not escaped. --- _overviews/contribute/add-guides.md | 204 +++++++++++++++++----------- 1 file changed, 126 insertions(+), 78 deletions(-) diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md index 96091fb311..ed8b0d36c7 100644 --- a/_overviews/contribute/add-guides.md +++ b/_overviews/contribute/add-guides.md @@ -19,8 +19,11 @@ and is always contribution-ready. Currently, the _types_ of documentation supported in this repository are: -- **Guides/Overviews**: Definitive guides/overviews of specific language features. Often long, detailed documents, - often produced by members of the Scala team. An example is the excellent [Collections][collections-overview] overview. +- **Guides/Overviews/Books**: Definitive guides/overviews of specific language features. Often long, detailed documents, + often produced by members of the Scala team. An example is the [Collections][collections-overview] overview. +- **References**: The canonical reference for language features, written by members of the Scala team. + These provide the exact specification to understand more subtle aspects of the language. An example is the + [Scala 3 reference][scala-3-reference]. - **Tutorials**: Bite-size, example-rich, and concise articles meant to get a developer up to speed quickly. - **Cheatsheets**: Quick reference of Scala syntax and behaviors. @@ -28,27 +31,29 @@ Currently, the _types_ of documentation supported in this repository are: The website is statically generated from [Markdown](https://en.wikipedia.org/wiki/Markdown) source using [Jekyll](https://github.com/mojombo/jekyll), and hosted on [GitHub Pages](https://pages.github.com/). -This workflow was chosen so as to make it as easy as possible for core committers and the community alike -to produce HTML documentation, and as easy as possible to publish it in a central location. +This workflow was chosen to help contributors to focus on writing helpful content, rather than on configuration and +boilerplate. It also aids publishing a static site in a central location. The markdown syntax being used supports [Maruku](https://github.com/bhollis/maruku) extensions, and has automatic syntax highlighting, without the need for any tags. Additionally [mdoc](https://github.com/scalameta/mdoc) is used during pull requests to validate Scala code blocks. -To use this feature you must use the backtick notation as documented by mdoc. Note that only validation is done. -The output files from mdoc are not used in the building of the tutorial. Use `mdoc` or `mdoc:fail` for your code blocks. +To use this feature you must use the backtick notation as documented by mdoc, +[see here](#code-blocks) for an example. + +**Note:** only validation of code is done by mdoc, and no extra output is generated. ## Submitting Docs -For one to contribute a document, one must simply +For you to contribute a document, first [fork](https://help.github.com/articles/fork-a-repo/) the -[repo](https://github.com/scala/docs.scala-lang), write their article in -[Markdown](https://daringfireball.net/projects/markdown/syntax) (example below), and submit a pull request. That's it. +[repo](https://github.com/scala/docs.scala-lang), then write your article in +[Markdown](https://daringfireball.net/projects/markdown/syntax) (example below), and finally submit a pull request. Likely after some edits and discussion, your document will be made live on [docs.scala-lang.org][home]. --- - layout: overview + layout: singlepage-overview title: My Awesome Title --- @@ -56,32 +61,41 @@ on [docs.scala-lang.org][home]. And a paragraph, with a [link](https://www.scala-lang.org). -One can contribute code in a markdown document by either - - indenting it by 4 spaces - - surrounding by triple backticks, as shown below - - in-line by putting backticks around it, e.g. `def foo`. +You can contribute code in a markdown document by either +- in-line by putting backticks around it, +- surrounding by triple backticks, +- or indenting it by 4 spaces, e.g.: + +~~~ +inline example: `val x = 23` + +block example: +```scala +println("hello") +``` + +indented example: - ```scala - println("hello") - ``` + case class Foo(x: Int) +~~~ -Everything else is automatically generated for you; tables of contents, and most index pages. And of course, the -styling is already taken care of for you. +Tables of contents will be automatically generated in a sidebar for your document, and syntax highlighting +is provided. ### Criteria for Docs to be Accepted -The goal of this documentation repository is to be tighter and more organized than other community-driven documentation platforms, like wikis. As such, any document pulled in for inclusion on -[docs.scala-lang.org][home] must: +The goal of this documentation repository is to be highly curated, rather than the approach by other community-driven +documentation platforms, like wikis. Therefore, to be included on [docs.scala-lang.org][home], a document must: - **"fit in"** to the repository ( _i.e.,_ it should not be a complete duplicate of another article), -- **be polished** it must be thorough, complete, correct, organized, and "article-like" (personal programming notes -don't quite fit.) -- **be maintained** if the document might require revisions from time to time, be prepared to keep it up to date, or +- **be polished**, i.e. it must be thorough, complete, correct, and organized; written as an article to be understood + by many users. +- **be maintained**, if the document might require revisions from time to time, be prepared to keep it up to date, or nominate someone to take ownership. If you have something you're thinking about contributing, or that you're thinking about writing in order to contribute -- we'd love to consider it! Please don't hesitate to use GitHub issues and pull requests and the -\#scala-contributors room [on Discord](https://discord.com/invite/scala) for any questions, concerns, +`#scala-contributors` room [on Discord](https://discord.com/invite/scala) for any questions, concerns, clarifications, etc. ## Document Templates @@ -90,38 +104,36 @@ clarifications, etc. ### Guides/Overviews -A guide or an overview that can be logically placed on **one** page must be placed in the directory -`_overviews/RELEVANT-CATEGORY/_posts` with the file name in the format `YYYY-MM-dd-title-separated-by-dashes.md`, -and header: +A guide or an overview that can be logically placed on **one** markdown page should be placed in the directory +`_overviews/RELEVANT-CATEGORY/`. It should have the header: --- - layout: overview + layout: singlepage-overview title: YOUR TITLE --- -The rest of the document should, of course, be written in [Markdown](https://en.wikipedia.org/wiki/Markdown). +The rest of the document will be written in [Markdown](https://en.wikipedia.org/wiki/Markdown) syntax. -At the moment, `RELEVANT-CATEGORY` corresponds to only a single category, "core," because we are currently focusing on -building up documentation of core libraries. However, expect more categories here in the future. +You may substitute `RELEVANT-CATEGORY` for any directory that is related, or create a new one if one is not suitable. -If your document consists of **multiple** pages, like the [Collections][collections-overview] overview, an ordering -must be specified, by numbering documents in their logical order with `num`, and a name must be assigned to the -collection of pages using `partof`. For example, the following header might be used for a document in the collections -overview: +If your guide/overview consists of **multiple** pages, like the [Collections][collections-overview] overview, +an ordering must be specified, by numbering documents in their logical order with the `num` tag in the header, +and a name must be assigned to the collection of pages using the `partof` tag. +For example, the following header might be used for a document in the collections overview: --- - layout: overview + layout: multipage-overview title: YOUR TITLE partof: collections num: 10 --- -A **single** document in the collection must contain a tag in the header, `outof`, that indicates the total number of -documents in the large overview. Putting it on the last page in the overview is often best: +**At least one** document in the collection must contain a tag in the header, `outof`, that indicates the total number +of documents in the large overview. Putting it on the last page in the overview is often best: --- - layout: overview + layout: multipage-overview title: YOUR TITLE partof: collections @@ -130,14 +142,18 @@ documents in the large overview. Putting it on the last page in the overview is --- Index pages, such as [docs.scala-lang.org/overviews/index.html][overviews-index] are -generated, by reading data from a configuration file, such as `_data/overviews.yml`, so your overview should be +generated by reading data from a configuration file, such as `_data/overviews.yml`, so your overview should be placed into a category there. ### Tutorials -At the moment, tutorials are written the same as Guides/Overviews, except that their link must be added to -the metadata of `/tutorials.md`. e.g. for the [Scala With Maven][scala-with-maven] tutorial, the -metadata of `/tutorials.md` looks like +Tutorials are different to guides, they should be written in a much more concise, task-oriented style, +usually on a single page. + +Similar to guides, tutorials also use the same markdown header. + +Once the tutorial is written, to aid user navigation their link must be added to +the metadata of `/tutorials.md`. e.g. it could look like --- layout: inner-page-parent @@ -145,18 +161,33 @@ metadata of `/tutorials.md` looks like tutorials: ... - - title: "Scala with Maven" - url: "/tutorials/scala-with-maven.html" - description: "Create a Scala project with Maven." - icon: code + - title: My New Tutorial + url: "/tutorials/my-new-tutorial.html" + description: "Learn How To Do This Specific Task" + icon: code --- -For a single-page tutorial, the typical directory to place them in is `_overviews/tutorials`. +You must also add the tutorial to the drop down list in the navigation bar. To do this, add an extra entry to +`_data/doc-nav-header.yml`. i.e. + + --- + - title: Getting Started + url: "/getting-started/index.html" + - title: Learn + ... + - title: Tutorials + url: "#" + submenu: + ... + - title: My New Tutorial + url: "/tutorials/my-new-tutorial.html" + ... + --- ### Cheatsheets -For now, cheatsheets are assumed to be in the form of tables. To contribute a cheatsheet, one must simply produce their -cheatsheet as a Markdown table, with the following header: +Cheatsheets have a special layout, and the content is expected to be a markdown table. To contribute a cheatsheet, +you should use the following format: --- layout: cheatsheet @@ -164,27 +195,37 @@ cheatsheet as a Markdown table, with the following header: by: YOUR NAME about: SOME TEXT ABOUT THE CHEAT SHEET. --- + | Title A | Title B | + |---------|---------| + | content | more | ### Code blocks The site build process uses [mdoc](https://scalameta.org/mdoc/) to typecheck code snippets in markdown. This is a great way to ensure the code snippets that -you're including typecheck and are valid. Here are a few quick types to get -started. +you're including typecheck and are valid. Here are a few quick tips to get +started: -To get started, add `mdoc` after `scala` when you are creating a +First, add `mdoc` after `scala` when you are creating a code block. The `mdoc` modifier here will make sure that `mdoc` runs the code snippet and ensures that it's valid. - ```scala mdoc - val a = 1 - ``` +
    +
    + 
    +            ```scala mdoc
+val a = 1
+```
+
    + If you have a snippet that you expect to fail, you can also account for this by using `mdoc:fail` for a compile error `mdoc:crash` for a runtime-error. - ```scala mdoc:fail - val b: String = 3 // won't compile - ``` +
    ```scala mdoc:fail
+val b: String = 3 // won't compile
+```
+
    + Keep in mind that a single file is all compiled as a single unit, so you can't redefine a variable that was defined above in another code snippet. _However_ there are a couple ways to get around this. Firstly, you can use the `mdoc:nest` @@ -193,29 +234,36 @@ essentially "hide" the snippet from the others. Another way around this is to use the `mdoc:reset` modifier, which _resets_ and forgets about everything up above. Here is an example using the various modifiers. - ```scala mdoc - import java.time.Instant +
    ```scala mdoc
+import java.time.Instant
+
+def now() = Instant.now()
+object Foo {}
+```
+
    + +
    ```scala mdoc:nest
+case class Foo(a: Int) // conflicts with Foo above, but it's nested so it's fine
+```
+
    - def now() = Instant.now() - object Foo {} - ``` +
    ```scala mdoc
+val a = s"The time is ${now()}" // still have access to the now method from above
+```
+
    - ```scala mdoc:nest - case class Foo(a: Int) // conflicts with Foo above, but it's nested so it's fine - ``` +
    ```scala mdoc:reset
+case class Foo(a: String) // forget the previous Foo's and start fresh
+```
+
    - ```scala mdoc - val a = s"The time is ${now()}" // still have access to the now method from above - ``` - ```scala mdoc:reset - case class Foo(a: String) // forget the previous Foo's and start fresh - ``` - ```scala mdoc - val myFoo = Foo("hi") // now we only have access to the last Foo - ``` +
    ```scala mdoc
+val myFoo = Foo("hi") // now we only have access to the last Foo
+```
+
    [collections-overview]: {% link _overviews/collections-2.13/introduction.md %} -[scala-with-maven]: {% link _overviews/tutorials/scala-with-maven.md %} [why-contribute]: {% link contribute.md %} [home]: {% link index.md %} [overviews-index]: {% link _overviews/index.md %} +[scala-3-reference]: https://docs.scala-lang.org/scala3/reference/overview.html From d8e9d2ebc889dc4b7e5a22530596bc9b6d7f24aa Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 23 Mar 2022 19:58:56 +0100 Subject: [PATCH 1811/3075] enhance contribute intro --- _contribute_resources/1-documentation.md | 4 +++- _overviews/contribute/index.md | 6 +++--- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/_contribute_resources/1-documentation.md b/_contribute_resources/1-documentation.md index 1f42a6e20b..e11b539e16 100644 --- a/_contribute_resources/1-documentation.md +++ b/_contribute_resources/1-documentation.md @@ -3,7 +3,9 @@ title: Documentation link: /contribute/documentation.html icon: fa fa-book --- -[Scaladoc (API)][scala-standard-library-api-documentation], [docs.scala-lang.org][add-guides] and [scala-lang.org](https://github.com/scala/scala-lang). +[Library API docs][scala-standard-library-api-documentation], [new guides][add-guides] on [docs.scala-lang.org][home], and help +with [scala-lang.org](https://github.com/scala/scala-lang). [add-guides]: {% link _overviews/contribute/add-guides.md %} [scala-standard-library-api-documentation]: {% link _overviews/contribute/scala-standard-library-api-documentation.md %} +[home]: {% link index.md %} diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index 4e94334061..da197e233e 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -1,16 +1,16 @@ --- -title: Contribute +title: Introduction num: 1 --- +### Why You Should Contribute To Scala The Scala programming language is an open source project with a very diverse community, where people from all over the world contribute their work, with everyone benefiting from friendly help and advice, and kindly helping others in return. So why not join the Scala community and help everyone make things better? -## How to help? - +**What Can I Do?** That depends on what you want to contribute. Below are some getting started resources for different contribution domains. Please read all of the documentation and follow all the links from the topic pages below before attempting to contribute, as many of the questions you have will already be answered. ### Reporting bugs From 7282312e59bc4a38a1bf508e01ad7342cea386c9 Mon Sep 17 00:00:00 2001 From: Florian3k <24961583+Florian3k@users.noreply.github.com> Date: Sat, 26 Mar 2022 13:07:21 +0100 Subject: [PATCH 1812/3075] Remove dangling opening brace --- _overviews/scala3-book/fp-functional-error-handling.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/fp-functional-error-handling.md b/_overviews/scala3-book/fp-functional-error-handling.md index d56dfff3a6..41410e5cf1 100644 --- a/_overviews/scala3-book/fp-functional-error-handling.md +++ b/_overviews/scala3-book/fp-functional-error-handling.md @@ -137,7 +137,7 @@ val stringA = "1" val stringB = "2" val stringC = "3" -val y = for { +val y = for a <- makeInt(stringA) b <- makeInt(stringB) c <- makeInt(stringC) From 7a3468bec81c9382d37a10e6d2be5c928d4000db Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Sat, 26 Mar 2022 16:56:46 -0700 Subject: [PATCH 1813/3075] Give Nth advice --- _overviews/core/collections-migration-213.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 68c5247774..114da1f632 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -15,6 +15,8 @@ The most important changes in the Scala 2.13 collections library are: - Transformation methods no longer have an implicit `CanBuildFrom` parameter. This makes the library easier to understand (in source code, Scaladoc, and IDE code completion). It also makes compiling user code more efficient. - The type hierarchy is simplified. `Traversable` no longer exists, only `Iterable`. - The `to[Collection]` method was replaced by the `to(Collection)` method. + - The `toC` methods are strict by convention and yield the default collection type where applicable. For example, `Iterator.continually(42).take(10).toSeq` produces a `List[Int]` and without the limit would not. + - `toIterable` is deprecated wherever defined. For `Iterator`, in particular, prefer `to[LazyList]`. - Views have been vastly simplified and work reliably now. They no longer extend their corresponding collection type, for example, an `IndexedSeqView` no longer extends `IndexedSeq`. - `collection.breakOut` no longer exists, use `.view` and `.to(Collection)` instead. - Immutable hash sets and hash maps have a new implementation (`ChampHashSet` and `ChampHashMap`, based on the ["CHAMP" encoding](https://michael.steindorfer.name/publications/oopsla15.pdf)). From f874fe30c3d6c2b68483281ceadcc51b5620f301 Mon Sep 17 00:00:00 2001 From: som-snytt Date: Sat, 26 Mar 2022 18:35:24 -0700 Subject: [PATCH 1814/3075] Relax it's private --- _tour/classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/classes.md b/_tour/classes.md index ee3dc33703..0bda77c78e 100644 --- a/_tour/classes.md +++ b/_tour/classes.md @@ -86,7 +86,7 @@ class Point { if (newValue < bound) _y = newValue else printWarning() } - private def printWarning(): Unit = println("WARNING: Out of bounds") + private def printWarning() = println("WARNING: Out of bounds") } val point1 = new Point From e6f52d94d532d7f6d8a07d8e5bac6a46ef11cf30 Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Sat, 26 Mar 2022 22:14:41 -0700 Subject: [PATCH 1815/3075] Lower bound in tour includes dangers --- _tour/lower-type-bounds.md | 32 +++++++++++++++++++++++--------- 1 file changed, 23 insertions(+), 9 deletions(-) diff --git a/_tour/lower-type-bounds.md b/_tour/lower-type-bounds.md index a1cdb9648f..548ffb733b 100644 --- a/_tour/lower-type-bounds.md +++ b/_tour/lower-type-bounds.md @@ -42,26 +42,40 @@ trait Node[+B] { def prepend[U >: B](elem: U): Node[U] } -case class ListNode[+B](h: B, t: Node[B]) extends Node[B] { +case class ListNode[+B](head: B, tail: Node[B]) extends Node[B] { def prepend[U >: B](elem: U): ListNode[U] = ListNode(elem, this) - def head: B = h - def tail: Node[B] = t } -case class Nil[+B]() extends Node[B] { - def prepend[U >: B](elem: U): ListNode[U] = ListNode(elem, this) +object Nil extends Node[Nothing] { + def prepend[U >: Nothing](elem: U): ListNode[U] = ListNode(elem, this) } ``` +We have also simplified `ListNode` to leverage its `case class` fields, and `Nil` to be a singleton object; it is a "node of nothing" because it does not hold an element. The type parameter for `Node` is `B` to suggest we want to store birds at each node. + Now we can do the following: ```scala mdoc trait Bird case class AfricanSwallow() extends Bird case class EuropeanSwallow() extends Bird +val africanSwallows: Node[AfricanSwallow] = ListNode[AfricanSwallow](AfricanSwallow(), Nil) +val swallowsFromAntarctica: Node[Bird] = Nil -val africanSwallowList = ListNode[AfricanSwallow](AfricanSwallow(), Nil()) -val birdList: Node[Bird] = africanSwallowList -birdList.prepend(EuropeanSwallow()) +// assign swallows to birds +val birds: Node[Bird] = africanSwallows + +// add a swallow to birds +val moreBirds = birds.prepend(EuropeanSwallow()) + +// add disparate swallows together to get birds +val allBirds = africanSwallows.prepend(EuropeanSwallow()) + +// but this is a mistake! adding a Node to birds widens the type arg too much. -Xlint will warn! +val error = moreBirds.prepend(swallowsFromAntarctica) ``` -The `Node[Bird]` can be assigned the `africanSwallowList` but then accept `EuropeanSwallow`s. +The covariant type parameter allows `birds` to get the value of `africanSwallows`. + +The type bound on the type parameter for `prepend` allows adding different varieties of swallows and getting a wider type: instead of `Node[AfricanSwallow]`, we get a `Node[Bird]`. + +The canary in the coal mine is `-Xlint`, which will warn if the type arg is widened too much. From e2f00f6c39981cdbeeaf5688b9f374904e403574 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 29 Mar 2022 18:10:06 +0200 Subject: [PATCH 1816/3075] Add parentheses to hello method definition Fixes #2357 --- _overviews/scala3-book/taste-hello-world.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/taste-hello-world.md b/_overviews/scala3-book/taste-hello-world.md index 7acf47e20e..110d55ba91 100644 --- a/_overviews/scala3-book/taste-hello-world.md +++ b/_overviews/scala3-book/taste-hello-world.md @@ -12,7 +12,7 @@ A Scala 3 “Hello, world!” example goes as follows. First, put this code in a file named _Hello.scala_: ```scala -@main def hello = println("Hello, world!") +@main def hello() = println("Hello, world!") ``` In this code, `hello` is a method. From 4895a4b7cc34c786937d1ef5c198bce66ab8777c Mon Sep 17 00:00:00 2001 From: som-snytt Date: Tue, 29 Mar 2022 09:49:23 -0700 Subject: [PATCH 1817/3075] Fix brackets Co-authored-by: Julien Richard-Foy --- _overviews/core/collections-migration-213.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/core/collections-migration-213.md b/_overviews/core/collections-migration-213.md index 114da1f632..5eb05536ee 100644 --- a/_overviews/core/collections-migration-213.md +++ b/_overviews/core/collections-migration-213.md @@ -16,7 +16,7 @@ The most important changes in the Scala 2.13 collections library are: - The type hierarchy is simplified. `Traversable` no longer exists, only `Iterable`. - The `to[Collection]` method was replaced by the `to(Collection)` method. - The `toC` methods are strict by convention and yield the default collection type where applicable. For example, `Iterator.continually(42).take(10).toSeq` produces a `List[Int]` and without the limit would not. - - `toIterable` is deprecated wherever defined. For `Iterator`, in particular, prefer `to[LazyList]`. + - `toIterable` is deprecated wherever defined. For `Iterator`, in particular, prefer `to(LazyList)`. - Views have been vastly simplified and work reliably now. They no longer extend their corresponding collection type, for example, an `IndexedSeqView` no longer extends `IndexedSeq`. - `collection.breakOut` no longer exists, use `.view` and `.to(Collection)` instead. - Immutable hash sets and hash maps have a new implementation (`ChampHashSet` and `ChampHashMap`, based on the ["CHAMP" encoding](https://michael.steindorfer.name/publications/oopsla15.pdf)). From add60f3231771d2132441cacfc9ec8815f711211 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 30 Mar 2022 16:26:08 +0200 Subject: [PATCH 1818/3075] final proof read --- _overviews/contribute/add-guides.md | 29 +++---- _overviews/contribute/bug-reporting-guide.md | 13 +-- _overviews/contribute/corelibs.md | 2 +- _overviews/contribute/documentation.md | 6 +- _overviews/contribute/guide.md | 2 +- _overviews/contribute/hacker-guide.md | 81 ++++++++++--------- _overviews/contribute/partest-guide.md | 14 +++- ...cala-standard-library-api-documentation.md | 35 ++++---- 8 files changed, 89 insertions(+), 93 deletions(-) diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md index ed8b0d36c7..bbb43a9686 100644 --- a/_overviews/contribute/add-guides.md +++ b/_overviews/contribute/add-guides.md @@ -6,7 +6,7 @@ num: 7 ## Why Contribute New Learning Material? As [Heather Miller writes][why-contribute], contributing to [docs.scala-lang.org][home] is -critical to making Scala accessible to newcomers, experience programmers, and anyone who is curious. +critical to making Scala accessible to newcomers, experienced programmers, and anyone who is curious. It is also a fantastic way to contribute for anyone who is comfortable using Scala, but maybe does not want to get involved with complex tools like the compiler. @@ -45,7 +45,7 @@ To use this feature you must use the backtick notation as documented by mdoc, ## Submitting Docs -For you to contribute a document, first +To contribute a new document, you should first [fork](https://help.github.com/articles/fork-a-repo/) the [repo](https://github.com/scala/docs.scala-lang), then write your article in [Markdown](https://daringfireball.net/projects/markdown/syntax) (example below), and finally submit a pull request. @@ -87,7 +87,7 @@ is provided. The goal of this documentation repository is to be highly curated, rather than the approach by other community-driven documentation platforms, like wikis. Therefore, to be included on [docs.scala-lang.org][home], a document must: -- **"fit in"** to the repository ( _i.e.,_ it should not be a complete duplicate of another article), +- **"fit in"** to the repository (_i.e.,_ it should not be a complete duplicate of another article), - **be polished**, i.e. it must be thorough, complete, correct, and organized; written as an article to be understood by many users. - **be maintained**, if the document might require revisions from time to time, be prepared to keep it up to date, or @@ -100,8 +100,6 @@ clarifications, etc. ## Document Templates -> **Note:** These templates will soon change slightly as a result of necessary refactoring. - ### Guides/Overviews A guide or an overview that can be logically placed on **one** markdown page should be placed in the directory @@ -215,16 +213,14 @@ snippet and ensures that it's valid. 
                 ```scala mdoc
 val a = 1
-```
-
    +```     If you have a snippet that you expect to fail, you can also account for this by using `mdoc:fail` for a compile error `mdoc:crash` for a runtime-error. 
    ```scala mdoc:fail
 val b: String = 3 // won't compile
-```
-
    +``` Keep in mind that a single file is all compiled as a single unit, so you can't redefine a variable that was defined above in another code snippet. _However_ @@ -239,28 +235,23 @@ above. Here is an example using the various modifiers. def now() = Instant.now() object Foo {} -``` - +``` 
    ```scala mdoc:nest
 case class Foo(a: Int) // conflicts with Foo above, but it's nested so it's fine
-```
-
    +``` 
    ```scala mdoc
 val a = s"The time is ${now()}" // still have access to the now method from above
-```
-
    +``` 
    ```scala mdoc:reset
 case class Foo(a: String) // forget the previous Foo's and start fresh
-```
-
    +``` 
    ```scala mdoc
 val myFoo = Foo("hi") // now we only have access to the last Foo
-```
-
    +``` [collections-overview]: {% link _overviews/collections-2.13/introduction.md %} [why-contribute]: {% link contribute.md %} diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 91858d589c..6830c18ab9 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -3,7 +3,8 @@ title: Bug Reporting Guide num: 8 --- -The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug), and for Scala 3, it is located at [github.com/lampepfl/dotty](https://github.com/lampepfl/dotty/issues). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. +The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug), and for Scala 3, it is located at [github.com/lampepfl/dotty](https://github.com/lampepfl/dotty/issues). Before you submit a bug make sure that it is certainly a bug by following instructions +in [Is it a Bug?](#is-it-a-bug). ## Is it a Bug? @@ -11,7 +12,7 @@ The first step in identifying a bug is to identify which component of the Scala - **Library** bugs typically manifest themselves as run-time exceptions, or as *unexpected*/*unintuitive* behavior of Scala Standard Library methods. - **Compiler** errors are manifested as compile time exceptions, unexpected behavior of your code at run time, or invalid behavior of the type system. - - **Reflection** are bugs that appear in the ‘scala.reflect’ package. For the *reflection* bugs , the same rules apply as for the *library* bugs. + - **Reflection** are bugs that appear in the `scala.reflect` package. For the *reflection* bugs, the same rules apply as for the *library* bugs. - **Scaladoc** bugs are manifested as a logical problems in the information it presents (that is, the displayed information is incorrect, such as an incorrect subclassing relationship), or incorrect behavior of the user interface. If you'd like to suggest a change in the content of the documentation, please submit a pull request (possible to do in the browser using GitHub, which is easier and faster than filing a bug). Please file a bug about the content of documentation only if you cannot provide a suggestion for its fix. If your issue is related to any of the following external projects, make sure to use its appropriate issue tracker: @@ -31,13 +32,13 @@ If you have a code snippet that is resulting in bytecode which you believe is be * Make sure you minimize your problem. To correctly minimize the problem follow the following instructions: - 1. Gradually take apart the offensive code snippet until you believe you have the simplest representation of your problem. + 1. Gradually remove parts from the original failing code snippet until you believe you have the simplest representation of your problem. - 2. Ensure that you have decoupled your code snippet from any library that could be introducing the offensive behavior. One way to achieve this is to try to recompile the offensive code snippet in isolation, outside of the context of any complex build environment. If your code depends on some strictly Java library and source code is available for it, make sure that the latter is also minimized. + 2. Ensure that you have decoupled your code snippet from any library that could be introducing the incorrect behavior. One way to achieve this is to try to recompile the offending code snippet in isolation, outside of the context of any complex build environment. If your code depends on some strictly Java library and source code is available for it, make sure that the latter is also minimized. 3. Make sure you are compiling your project from a clean slate. Your problem could be related to separate compilation, which is difficult to detect without a clean build with new `.class` files. - 4. If you have encountered a bug while building your code in the IDE, then please reproduce it on the command line. The same rule applies for build tools like `sbt` or `ant`. + 4. If you have encountered a bug while building your code in the IDE, then please reproduce it on the command line. The same rule applies for build tools like **sbt** or **Mill**. 5. If you want to file an improvement in the issue tracker please discuss it first on one of the mailing lists. They offer much bigger audience than issue tracker. The latter is not suitable for long discussions. @@ -69,7 +70,7 @@ Please make sure to fill in as many fields as possible. Make sure you've indicat 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? -In order for us to quickly triage the bug that you've found, it's important that the code snippet which produces the observed issue is as minimized as possible. For advice on minimizing your code snippet, please see the appropriate subsection of the above (Is it a Bug?). +In order for us to quickly triage the bug that you've found, it's important that the code snippet which produces the observed issue is as minimized as possible. For advice on minimizing your code snippet, please see the appropriate subsection of the above ([Is it a Bug?](#is-it-a-bug)). ### Description diff --git a/_overviews/contribute/corelibs.md b/_overviews/contribute/corelibs.md index 1eb2f840b0..4fcab907a2 100644 --- a/_overviews/contribute/corelibs.md +++ b/_overviews/contribute/corelibs.md @@ -14,7 +14,7 @@ There are several options for contributing to Scala's core libraries. You can: ### Significant changes For significant new functionality or a whole new API to be considered for inclusion in the core Scala distribution, -please take into account [https://github.com/scala/scala-dev/issues/661] before doing so. +please take into account [scala/scala-dev#661](https://github.com/scala/scala-dev/issues/661) before doing so. [documentation]: {% link _overviews/contribute/documentation.md %} [bug-reporting-guide]: {% link _overviews/contribute/bug-reporting-guide.md %} diff --git a/_overviews/contribute/documentation.md b/_overviews/contribute/documentation.md index 9bd4597b36..bd93b7fbd3 100644 --- a/_overviews/contribute/documentation.md +++ b/_overviews/contribute/documentation.md @@ -7,10 +7,10 @@ num: 5 There are several ways you can help out with the improvement of Scala documentation. These include: * API Documentation in Scaladoc -* Guides, Overviews, Tutorials, Cheat Sheets and more on the docs.scala-lang.org site -* Updating scala-lang.org +* Guides, Overviews, Tutorials, Cheat Sheets and more on the [docs.scala-lang.org][home] site +* Updating [scala-lang.org](https://scala-lang.org) -Please read this page, and the pages linked from this one, fully before contributing documentation. Many of the questions you have will be answered in these resources. If you have a question that isn't answered, feel free to ask on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and then, please, submit a pull request with updated documentation reflecting that answer. +Please read this page, and the pages linked from this one, fully before contributing documentation. Many frequently asked questions will be answered in these resources. If you have a question that isn't answered, feel free to ask on the [Scala Contributors](https://contributors.scala-lang.org/) forum and then, please, submit a pull request with updated documentation reflecting that answer. **General requirements** for documentation submissions include spell-checking all written language, ensuring code samples compile and run correctly, correct grammar, and clean formatting/layout of the documentation. diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index 472d2d41ab..33330f511d 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -18,7 +18,7 @@ num: 10 Just to name a few common reasons: * contributing a patch is the best way to make sure your desired changes will be available in the next Scala version -* Scala is written in Scala, so going through the source code and patching it will improve your Scala-fu +* Scala is written in Scala, so going through the source code and patching it will improve your knowledge of Scala. * last but not least, it only takes a few accepted commits to make it into the [Scala Contributor Hall of Fame](https://github.com/scala/scala/contributors). The main Scala project consists of the standard Scala library, the Scala reflection and macros library, diff --git a/_overviews/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md index 92181003fa..2a70714f53 100644 --- a/_overviews/contribute/hacker-guide.md +++ b/_overviews/contribute/hacker-guide.md @@ -1,5 +1,5 @@ --- -title: Scala hacker guide +title: Scala 2 Hacker's Guide by: Eugene Burmako num: 12 --- @@ -18,26 +18,27 @@ Though, there's an annoying issue which you occasionally stumble upon: the formatting string interpolator `f` [does not support](https://github.com/scala/bug/issues/6725) new line tokens `%n`. -One approach would be to go the mailing list, request that the bug be fixed, and then to wait indefinitely for the fix arrive. Another approach would be to instead patch Scala oneself, and to submit the fix to the Scala repository in hopes that it might make it into a subsequent release. +One approach would be to go the [Scala 2 bug tracker](https://github.com/scala/bug), request that the bug be fixed, and then to wait indefinitely for the fix arrive. Another approach would be to instead patch Scala yourself, and to submit the fix to the Scala repository in hopes that it might make it into a subsequent release. **_Of note_**: There are several types of releases/builds. Nightly builds are produced every night at a fixed time. Minor releases happen once every few months. Major releases typically happen once per year. ## 1. Connect -Sometimes it's appealing to hack alone and not to have to interact with others out of fear, or out of comfort. However, in the context a big project such as Scala, -this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide +Sometimes it's appealing to hack alone and not to have to interact with others. However, in the context a big project such as Scala, there might be better ways. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. -Typically bug fixes and new features start out as an idea or an experiment posted on one of [our mailing lists](https://scala-lang.org/community/index.html#forums) to find out how people feel -about things you want to implement. People proficient in certain areas of Scala usually monitor mailing lists, so you'll often get some help -by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. +Typically bug fixes and new features start out as an idea or an experiment posted on one of [our forums](https://scala-lang.org/community/index.html#forums) to find out how people feel +about things you want to implement. People proficient in certain areas of Scala usually monitor forums and discussion rooms, so you'll often get some help by posting a message. +But the most efficient way to connect is to mention in your message one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. A list of language features/libraries along with their maintainer's full names and GitHub usernames is [in the Scala repo README](https://github.com/scala/scala#get-in-touch). In our running example, since Martin is the person who submitted the string interpolation Scala Improvement Proposal and implemented this language feature for Scala 2.10.0, he might be interested in learning of new bugfixes to that feature. -As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the [Scala Contributors](https://contributors.scala-lang.org/) mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, -in this example, we post to the [the scala-user mailing list](https://groups.google.com/group/scala-user) about our issue. +As alluded to earlier, one must also choose an appropriate avenue to discuss the issue. Typically, one would use the [Scala Contributor's Forum][contrib-forum], as there are post categories devoted to discussions about the core internal design and implementation of the Scala system. + +In this example, the issue was previously discussed on the (now unused) scala-user mailing list, at the time, +we would have posted to the [the (now unused) scala-user mailing list](https://groups.google.com/group/scala-user) about our issue: Posting to scala-user Response from Martin @@ -86,10 +87,11 @@ Before you start making changes, always create your own branch. Never work on th the changes you plan on making. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: bug fixes and new features. -* For bug fixes, use `issue/NNNN` or `ticket/NNNN` for bug NNNN from the [Scala bug tracker](https://github.com/scala/bug). -* For new feature use `topic/XXX` for feature XXX. Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaladoc-diagrams` instead of just `topic/diagrams` would be a good branch name. +* For bug fixes, use `issue/NNNN` or `ticket/NNNN` for bug `NNNN` from the [Scala bug tracker](https://github.com/scala/bug). +* For new feature use `topic/XXX` for feature `XXX`. Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaladoc-diagrams` instead of just `topic/diagrams` would be a good branch name. -Since in our example, we're going to fix an existing bug [6725](https://github.com/scala/bug/issues/6725), we'll create a branch named `ticket/6725`. +Since in our example, we're going to fix an existing bug +[scala/bug#6725](https://github.com/scala/bug/issues/6725), we'll create a branch named `ticket/6725`. 16:39 ~/Projects/scala (master)$ git checkout -b ticket/6725 Switched to a new branch 'ticket/6725' @@ -102,13 +104,13 @@ The next step after cloning your fork is setting up your machine to build Scala. You need the following tools: -* A Java SDK. The baseline version is 6 for 2.11.x and 8 for 2.12.x. It's possible to use a later SDK for local development, but the continuous integration builds will verify against the baseline version. +* A Java JDK. The baseline version is `8` for 2.13.x and higher. It's possible to use a higher JDK version for local development, but the continuous integration builds will verify against the baseline version. * `sbt`, an interactive build tool commonly used in Scala projects. Acquiring sbt manually is not necessary -- the recommended approach is to download the [sbt-extras runner script](https://github.com/paulp/sbt-extras/blob/master/sbt) and use it in place of `sbt`. The script will download and run the correct version of sbt when run from the Scala repository's root directory. * `curl` -- the build uses `curl` in the `pull-binary-libs.sh` script to download bootstrap libs. -OS X and Linux builds should work. Windows is supported, but it might have issues. Please report to the [Scala bug tracker](https://github.com/scala/bug) if you encounter any. +macOS and Linux builds should work. Windows is supported, but it might have issues. Please report to the [Scala 2 bug tracker](https://github.com/scala/bug) if you encounter any. -Building Scala is as easy as running `sbt dist/mkPack` in the root of your cloned repository. In general, it's much more efficient to enter the `sbt` shell once and run the various tasks from there, instead of running each task by launching `sbt some-task` on your command prompt. +Building Scala can be done with a single command `sbt dist/mkPack`, from the root of your cloned repository. In general, it's much more efficient to enter the `sbt` shell once and run the various tasks from there, instead of running each task by launching `sbt some-task` on your command prompt. Be prepared to wait for a while -- a full "clean" build takes 5+ minutes depending on your machine (longer on older machines with less memory). On a recent laptop, incremental builds usually complete within 10-30 seconds. @@ -116,16 +118,13 @@ Be prepared to wait for a while -- a full "clean" build takes 5+ minutes dependi There's no single editor of choice for working with Scala sources, as there are trade-offs associated with each available tool. -Both Eclipse and IntelliJ IDEA have Scala plugins, which are known to work with our codebase. -Both of those Scala plugins provide navigation, refactoring, error reporting functionality, and integrated debugging. -See [the Scala README](https://github.com/scala/scala#ide-setup) for instructions on using Eclipse and IntelliJ IDEA with the Scala repository. +IntelliJ IDEA has a Scala plugin, which is known to work with our codebase. Alternatively you can use Visual Studio Code with the [Metals IDE extension](https://marketplace.visualstudio.com/items?itemName=scalameta.metals). +Both of these Scala IDE solutions provide navigation, refactoring, error reporting functionality, and integrated debugging. +See [the Scala README](https://github.com/scala/scala#ide-setup) for instructions on using either IntelliJ IDEA or Metals with the Scala repository. -There also exist lighter-weight editors such as Emacs, Sublime or jEdit which are faster and much less memory/compute-intensive to run, while -lacking semantic services and debugging. To address this shortcoming, they can integrate with ENSIME, -a helper program, which hosts a resident Scala compiler providing some of the features implemented in traditional IDEs. However despite -having significantly matured over the last year, support for our particular code base is still being improved, and is not as mature as for Eclipse and IntelliJ. +Other alternative editors exist, such as Atom, Emacs, Sublime Text or jEdit. These are faster and much less memory/compute-intensive to run, but lack semantic services and debugging. -Due to the immense variability in personal preference between IDE/editor experience, it's difficult to recommend a particular tool, and your choice should boil down to your personal preferences. +We recognise that there exist preferences towards specific IDE/editor experiences, so ultimately we recommend that your choice be your personal preference. ## 3. Hack @@ -156,7 +155,7 @@ Now, implement your bugfix or new feature! Here are also some tips & tricks that have proven useful in Scala development: * After building your working copy with the `compile` sbt task, there's no need to leave the comfort of your sbt shell to try it out: the REPL is available as the `scala` task, and you can also run the compiler using the `scalac` task. If you prefer to run the REPL outside sbt, you can generate the scripts in `build/quick/bin` using the `dist/mkQuick` task. -* The sbt workflow is also great for debugging, as you can simply create a remote debugging session in your favorite IDE, and then activate the JVM options for the next time you run the `scala` or `scalac` tasks using: +* The sbt workflow is also great for debugging, as you can create a remote debugging session in your favorite IDE, and then activate the JVM options for the next time you run the `scala` or `scalac` tasks using: ``` > set javaOptions in compiler := List("-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8002") @@ -167,9 +166,8 @@ Listening for transport dt_socket at address: 8002 * Also see [the Scala README](https://github.com/scala/scala#incremental-compilation) for tips on speeding up compile times. * If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, try the `clean` task and building again. -* Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how - things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious - to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use `showRaw` to get the `AST` representation. +* Don't underestimate the power of using `println` to print debug information. When starting with Scala, I spent a lot of time in the debugger trying to figure out how + things work. However later I found out that print-based debugging is often more effective than jumping around. It's also useful to print stack traces to understand the flow of execution, for example what code executed before some action occurred. When working with `Trees`, you might want to use `showRaw` to get the `AST` representation. * You can publish your newly-built scala version locally using the `publishLocal` task in sbt. * It's convenient to enable the following local settings to speed up your workflow (put these in `local.sbt` in your working copy): @@ -184,33 +182,33 @@ testOptions in IntegrationTest in LocalProject("test") ++= Seq(Tests.Argument("- // antStyle := true ``` -* Adding a macro to the `Predef` object is a pretty involved task. Due to bootstrapping, you cannot just throw a macro into it. For this reason, the process is more involved. You might want to follow the way `StringContext.f` itself is added. In short, you need to define your macro under `src/compiler/scala/tools/reflect/` and provide no implementation in `Predef` (`def fn = macro ???`). Now you have to set up the wiring. Add the name of your macro to `src/reflect/scala/reflect/internal/StdNames.scala`, add the needed links to it to `src/reflect/scala/reflect/internal/Definitions.scala`, and finally specify the bindings in `src/compiler/scala/tools/reflect/FastTrack.scala`. [Here's](https://github.com/folone/scala/commit/59536ea833ca16c985339727baed5d70e577b0fe) an example of adding a macro. +* Adding a macro to the `Predef` object is a pretty involved task. Due to bootstrapping, it makes it more complex to add a macro. For this reason, the process is more involved. It could be useful to replicate the way `StringContext.f` itself is added. In short, you need to define your macro under `src/compiler/scala/tools/reflect/` and provide no implementation in `Predef` (it will look like `def fn = macro ???`). Now you have to set up the wiring. Add the name of your macro to `src/reflect/scala/reflect/internal/StdNames.scala`, add the needed links to it to `src/reflect/scala/reflect/internal/Definitions.scala`, and finally specify the bindings in `src/compiler/scala/tools/reflect/FastTrack.scala`. [Here's](https://github.com/folone/scala/commit/59536ea833ca16c985339727baed5d70e577b0fe) an example of adding a macro. -### Documentation +### Where to Find Documentation -There are several areas that one could contribute to -- there is the Scala library, the Scala compiler, and other tools such as Scaladoc. Each area has varying amounts of documentation. +The separate projects under Scala have varying amounts of documentation: ##### The Scala Library -Contributing to the Scala standard library is about the same as working on one of your own libraries. Beyond the Scala collections hierarchy, there are no complex internals or architectures to have to worry about. Just make sure that you code in a "don't-repeat-yourself" (DRY) style, obeying the "boy scout principle" (i.e. make sure you've left the code cleaner than you found it). +Contributing to the Scala standard library is about the same as working on one of your own libraries. If documentation is necessary for some trait/class/object/method/etc in the Scala standard library, typically maintainers will include inline comments describing their design decisions or rationale for implementing things the way they have, if it is not straightforward. -If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections][collections-arch], as well as a larger more general [Scala collections Guide][collections-intro] covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide][collections-par]. +The Scala collections framework, part of the Scala standard library, is more complex. You should become familiar +with its architecture, which is documented in [the Architecture of Scala Collections][collections-arch]. +The [Scala Collections Guide][collections-intro] is more general, covering the synchronous portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide][collections-par]. ##### The Scala Compiler -Documentation about the internal workings of the Scala compiler is scarce, and most of the knowledge is passed around by email ([Scala Contributors](https://contributors.scala-lang.org/) mailing list), ticket, or word of mouth. However the situation is steadily improving. Here are the resources that might help: +Documentation about the internal workings of the Scala compiler is scarce, and most of the knowledge is passed around by forum ([Scala Contributors](https://contributors.scala-lang.org/) forum), chat-rooms (see `#scala-contributors` on [Discord][discord-contrib]), ticket, or word of mouth. However the situation is steadily improving. Here are the resources that might help: * [Compiler internals videos by Martin Odersky](https://www.scala-lang.org/old/node/598.html) are quite dated, but still very useful. In this three-video - series Martin explains the general architecture of the compiler, and the basics of the front-end, which has recently become Scala reflection API. + series Martin explains the general architecture of the compiler, and the basics of the front-end, which later became the `scala-reflect` module's API. * [Reflection documentation][reflect-overview] describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that - are used to represent Scala programs and operations defined on then. Since much of the compiler has been factored out and made accessible via the Reflection API, all of the fundamentals needed for reflection are the same for the compiler. -* [Reflection and Compilers by Martin Odersky](https://channel9.msdn.com/Events/Lang-NEXT/Lang-NEXT-2012/Reflection-and-Compilers), a talk - at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the architecture of the reflection API. + are used to represent Scala programs and operations defined on then. Since much of the compiler has been factored out and made accessible via the `scala-reflect` module, all of the fundamentals needed for reflection are the same for the compiler. * [Scala compiler corner](https://lampwww.epfl.ch/~magarcia/ScalaCompilerCornerReloaded/) contains extensive documentation about most of the post-typer phases (i.e. the backend) in the Scala compiler. -* [Scala Contributors](https://contributors.scala-lang.org/), a mailing list which hosts discussions about the core +* [Scala Contributors](https://contributors.scala-lang.org/), a forum which hosts discussions about the core internal design and implementation of the Scala system. ##### Other Projects @@ -303,7 +301,7 @@ Here are some more testing tips: ... Finished: FAILURE -This means your change is backward or forward binary incompatible with the specified version (the check is performed by the [migration manager](https://github.com/typesafehub/migration-manager)). The error message is actually saying what you need to add to `bincompat-backward.whitelist.conf` or `bincompat-forward.whitelist.conf` to make the error go away. If you are getting this on an internal/experimental api, it should be safe to add suggested sections to the config. Otherwise, you might want to target a newer version of scala for this change. +This means your change is backward or forward binary incompatible with the specified version (the check is performed by the [migration manager](https://github.com/typesafehub/migration-manager)). The error message is actually saying what you need to modify `project/MimaFilters.scala` to make the error go away. If you are getting this on an internal/experimental api, it should be safe to add suggested sections to the config. Otherwise, you might want to target a newer version of scala for this change. ### Verify @@ -380,7 +378,10 @@ Note that there can be a gap between a successful review and the merge, because So don't be confused if your reviewer says “LGTM”, but your code doesn't get merged immediately. [collections-arch]: {% link _overviews/core/architecture-of-scala-collections.md %} -[collections-intro]: {% link _overviews/collections/introduction.md %} +[collections-intro]: {% link _overviews/collections-2.13/introduction.md %} [collections-par]: {% link _overviews/parallel-collections/overview.md %} [reflect-overview]: {% link _overviews/reflection/overview.md %} [partest-guide]: {% link _overviews/contribute/partest-guide.md %} +[documentation]: {% link _overviews/contribute/documentation.md %} +[contrib-forum]: https://contributors.scala-lang.org/ +[discord-contrib]: https://discord.com/invite/scala diff --git a/_overviews/contribute/partest-guide.md b/_overviews/contribute/partest-guide.md index c3e6980b06..c8eb5cbf02 100644 --- a/_overviews/contribute/partest-guide.md +++ b/_overviews/contribute/partest-guide.md @@ -9,21 +9,27 @@ Partest is a custom parallel testing tool that we use to run the test suite for The test suite can be run from the sbt console with: - > partest +``` +sbt:root> partest +``` You can get a summary of the usage by running `partest --help`. If you would like to run particular tests pass the test paths as arguments - > partest test/files/pos/bounds.scala test/scaladoc/run/diagrams-base.scala +``` +sbt:root> partest test/files/pos/bounds.scala test/scaladoc/run/diagrams-base.scala +``` To run only the Scaladoc tests use `--srcpath` with the location of the tests - > partest --srcpath scaladoc +``` +sbt:root> partest --srcpath scaladoc +``` ## Using ant -Please note support for ant was removed on the 2.12 branch. +> Please note support for ant was removed on the 2.12 branch. The test suite can be run by using ant from the command line: diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md index c1303e8b18..a6c812b7e4 100644 --- a/_overviews/contribute/scala-standard-library-api-documentation.md +++ b/_overviews/contribute/scala-standard-library-api-documentation.md @@ -21,16 +21,14 @@ contribution steps and guidelines. Thank you.* Since API documentation is located in Scala source code files, the process for contributing API documentation is similar to that of contributing bug-fixes to the Scala code base, but without the requirement that there be an issue filed on GitHub -first. When forking/branching, just use a `scaladoc/xxxx` branch name, where xxxx is a +first. When forking/branching, it would help to use a `scaladoc/xxxx` branch name, where `xxxx` is a descriptive, but short branch name (e.g. `scaladoc/future-object`). -However, if an issue *does* exist, please use `issue/NNNN`, where NNNN is the ticket number, +However, if an issue *does* exist, please use `issue/NNNN`, where `NNNN` is the ticket number, instead. -If you would like to assist us by helping us find missing documentation and -submitting bug reports for existing documentation, -[please read the following section](#contribute-api-documentation-bug-reports). -If you want to contribute new API documentation, -[jump down to the next section](#contribute-new-api-documentation). +If you would like to assist us, you can +[report missing/incorrect API documentation](#contribute-api-documentation-bug-reports), or +[contribute new API documentation](#contribute-new-api-documentation). ## Contribute API Documentation Bug Reports @@ -45,8 +43,8 @@ If you find an issue, please log it in the [Scala bug tracker](https://github.co **after making sure it is not already logged as an issue**. To help with disambiguation, please use the following format for issue title: -* Use an action describing the work required. E.g. Add, Document, Correct, Remove -* Use the full package, class/trait/object name (or state package object if +* Use an action describing the work required, e.g. **Add**, **Document**, **Correct**, **Remove**. +* Use the full package, class/trait/object/enum name (or state package object if that is the case). * Extremely short description of what to do. * More detail can (and should) go into the issue description, including a short @@ -60,10 +58,10 @@ Here is an example of the title and description for an example API documentation and the description: -`The methods on the Future companion object are critical` -`for using Futures effectively without blocking. Provide code` -`examples of how methods like sequence, transform, fold and` -`firstCompletedOf should be used.` +> The methods on the `Future` companion object are critical +> for using Futures effectively without blocking. Provide code +> examples of how methods like `sequence`, `transform`, `fold` and +> `firstCompletedOf` should be used. In addition to following these conventions, please add `documentation` and `community` labels to the issue, and put them in the `Documentation and API` @@ -93,9 +91,8 @@ new API documentation to save time, effort, mistakes and repetition. the whole document though, and pay close attention to the title and commit message formats, noting *present tense*, *length limits* and that it must merge cleanly. Remember that the title of the pull request will become the commit - message when merged. **Also**, be sure to assign one or more reviewers to the PR, list of - reviewers is at the bottom of this document, but the quick version is to add - `Review by @heathermiller` or `Review by @dickwall` **in the pull request comments**. + message when merged. **Also**, be sure to assign one or more reviewers to the PR, if this is + not possible for you, you could mention a user in **in the pull request comments**. ### Extra Requirements for Scaladoc Documentation Commits @@ -106,9 +103,9 @@ PR is merged in smoothly: * Any and all code examples provided should *be correct, compile and run* as expected (ensure this in the REPL or your IDE). * Spelling must be checked for all written language *and* code examples where - possible. Most editors have some spell checking feature available. Obviously - Scala code is likely to flag as mis-spelled sometimes, but any written language - should be checked. If you can also use a grammar checker, even better. We + possible. Most editors have some spell checking feature available. Scala code + itself is permitted to not pass a spell-checker, however any written language + should be checked. If you can also use a grammar checker, it will help. We *will* ask for spelling and grammar to be corrected before acceptance. * You **must** also run `sbt doc`, fix any problems and check the formatting and layout of your changes. Again, corrections will be required if formatting or From 8c3c443440ea72588a6bf8f35aeebfcad8ce464c Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 30 Mar 2022 17:00:52 +0200 Subject: [PATCH 1819/3075] remove contribute from nav bar --- _data/nav-header.yml | 7 ------- _includes/site-header.html | 2 +- 2 files changed, 1 insertion(+), 8 deletions(-) diff --git a/_data/nav-header.yml b/_data/nav-header.yml index 03621e6d64..b04b23ca78 100644 --- a/_data/nav-header.yml +++ b/_data/nav-header.yml @@ -1,17 +1,10 @@ - title: Documentation url: "/" - can-highlight: true - title: Download url: https://www.scala-lang.org/download/ - can-highlight: true - title: Community url: https://www.scala-lang.org/community/ - can-highlight: true - title: Libraries url: https://index.scala-lang.org - can-highlight: true -- title: Contribute - url: /contribute/ - title: Blog url: https://www.scala-lang.org/blog/ - can-highlight: true diff --git a/_includes/site-header.html b/_includes/site-header.html index 70f1cb6840..d2583b913f 100644 --- a/_includes/site-header.html +++ b/_includes/site-header.html @@ -10,7 +10,7 @@ From e99b6c664acc165fe48ee8307139c3cebb4a0173 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Wed, 30 Mar 2022 18:21:18 +0200 Subject: [PATCH 1820/3075] Recommend using the Scala Improvement Process category only instead of cross-posting on two categories. --- _sips/sip-submission.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/_sips/sip-submission.md b/_sips/sip-submission.md index e2efb5ec2a..4d9ae53a40 100644 --- a/_sips/sip-submission.md +++ b/_sips/sip-submission.md @@ -53,11 +53,10 @@ There are four major steps in the SIP process: Before submitting a SIP, it is required that you perform necessary preparations: -Discuss your idea on the [Scala Contributors Page](https://contributors.scala-lang.org/) (currently, we suggest -cross-posting on -[Scala Improvement Process](https://contributors.scala-lang.org/c/sip) and -[Language Design](https://contributors.scala-lang.org/c/language-design). This -may change in the future.) Create a topic that starts with “Pre-SIP” and briefly +Discuss your idea on the [Scala Contributors Page](https://contributors.scala-lang.org/) (we suggest +posting in the category +[Scala Improvement Process](https://contributors.scala-lang.org/c/sip)). +Create a topic that starts with “Pre-SIP” and briefly describe what you would like to change and why you think it’s a good idea. Proposing your ideas on the mailing list is not an optional step. For every From 640c86c471fcaed944350565e9094d90ef1b4a2e Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Thu, 31 Mar 2022 00:53:26 -0700 Subject: [PATCH 1821/3075] Simplify example and minimize diff --- _tour/lower-type-bounds.md | 40 ++++++++++++++------------------------ 1 file changed, 15 insertions(+), 25 deletions(-) diff --git a/_tour/lower-type-bounds.md b/_tour/lower-type-bounds.md index 548ffb733b..9f5cd53b89 100644 --- a/_tour/lower-type-bounds.md +++ b/_tour/lower-type-bounds.md @@ -16,42 +16,32 @@ While [upper type bounds](upper-type-bounds.html) limit a type to a subtype of a Here is an example where this is useful: ```scala mdoc:fail -trait Node[+B] { - def prepend(elem: B): Node[B] +trait List[+B] { + def prepend(elem: B): NonEmptyList[B] = NonEmptyList(elem, this) } -case class ListNode[+B](h: B, t: Node[B]) extends Node[B] { - def prepend(elem: B): ListNode[B] = ListNode(elem, this) - def head: B = h - def tail: Node[B] = t -} +case class NonEmptyList[+B](head: B, tail: List[B]) extends List[B] -case class Nil[+B]() extends Node[B] { - def prepend(elem: B): ListNode[B] = ListNode(elem, this) -} +object Nil extends List[Nothing] ``` -This program implements a singly-linked list. `Nil` represents an empty element (i.e. an empty list). `class ListNode` is a node which contains an element of type `B` (`head`) and a reference to the rest of the list (`tail`). The `class Node` and its subtypes are covariant because we have `+B`. +This program implements a singly-linked list. `Nil` represents an empty list with no elements. `class NonEmptyList` is a node which contains an element of type `B` (`head`) and a reference to the rest of the list (`tail`). The `trait List` and its subtypes are covariant because we have `+B`. However, this program does _not_ compile because the parameter `elem` in `prepend` is of type `B`, which we declared *co*variant. This doesn't work because functions are *contra*variant in their parameter types and *co*variant in their result types. To fix this, we need to flip the variance of the type of the parameter `elem` in `prepend`. We do this by introducing a new type parameter `U` that has `B` as a lower type bound. ```scala mdoc -trait Node[+B] { - def prepend[U >: B](elem: U): Node[U] +trait List[+B] { + def prepend[U >: B](elem: U): NonEmptyList[U] = NonEmptyList(elem, this) } -case class ListNode[+B](head: B, tail: Node[B]) extends Node[B] { - def prepend[U >: B](elem: U): ListNode[U] = ListNode(elem, this) -} +case class NonEmptyList[+B](head: B, tail: List[B]) extends List[B] -object Nil extends Node[Nothing] { - def prepend[U >: Nothing](elem: U): ListNode[U] = ListNode(elem, this) -} +object Nil extends List[Nothing] ``` -We have also simplified `ListNode` to leverage its `case class` fields, and `Nil` to be a singleton object; it is a "node of nothing" because it does not hold an element. The type parameter for `Node` is `B` to suggest we want to store birds at each node. +The type parameter for `List` is `B` to suggest we want to keep lists of birds. Now we can do the following: ```scala mdoc @@ -59,11 +49,11 @@ trait Bird case class AfricanSwallow() extends Bird case class EuropeanSwallow() extends Bird -val africanSwallows: Node[AfricanSwallow] = ListNode[AfricanSwallow](AfricanSwallow(), Nil) -val swallowsFromAntarctica: Node[Bird] = Nil +val africanSwallows: List[AfricanSwallow] = Nil.prepend(AfricanSwallow()) +val swallowsFromAntarctica: List[Bird] = Nil // assign swallows to birds -val birds: Node[Bird] = africanSwallows +val birds: List[Bird] = africanSwallows // add a swallow to birds val moreBirds = birds.prepend(EuropeanSwallow()) @@ -71,11 +61,11 @@ val moreBirds = birds.prepend(EuropeanSwallow()) // add disparate swallows together to get birds val allBirds = africanSwallows.prepend(EuropeanSwallow()) -// but this is a mistake! adding a Node to birds widens the type arg too much. -Xlint will warn! +// but this is a mistake! adding a list of birds widens the type arg too much. -Xlint will warn! val error = moreBirds.prepend(swallowsFromAntarctica) ``` The covariant type parameter allows `birds` to get the value of `africanSwallows`. -The type bound on the type parameter for `prepend` allows adding different varieties of swallows and getting a wider type: instead of `Node[AfricanSwallow]`, we get a `Node[Bird]`. +The type bound on the type parameter for `prepend` allows adding different varieties of swallows and getting a wider type: instead of `List[AfricanSwallow]`, we get a `List[Bird]`. The canary in the coal mine is `-Xlint`, which will warn if the type arg is widened too much. From 0bd08091e2cbccdd3d1f9fdeaa49911ba14fdcaa Mon Sep 17 00:00:00 2001 From: Andrea Mucciarelli Date: Thu, 31 Mar 2022 09:56:08 +0200 Subject: [PATCH 1822/3075] Getting started - sbt track - italian translations (#2239) Co-authored-by: Dale Wijnand --- ...-with-scala-and-sbt-on-the-command-line.md | 79 ++++++++++++++ ...ting-scala-with-sbt-on-the-command-line.md | 101 ++++++++++++++++++ 2 files changed, 180 insertions(+) create mode 100644 _it/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md create mode 100644 _it/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md diff --git a/_it/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md b/_it/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md new file mode 100644 index 0000000000..0de0347ca5 --- /dev/null +++ b/_it/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md @@ -0,0 +1,79 @@ +--- +title: Primi passi su scala e sbt con la linea di comando +layout: singlepage-overview +partof: getting-started-with-scala-and-sbt-on-the-command-line +language: it +disqus: true +next-page: /it/testing-scala-with-sbt-on-the-command-line +--- + +In questo tutorial si vedrà come creare un progetto Scala a partire da un template, che può essere usato come punto di partenza anche per progettti personali. +Lo strumento utilizzato per tale scopo è [sbt](https://www.scala-sbt.org/1.x/docs/index.html), che è lo standard di build per Scala. +sbt permette di compilare, eseguire e testare i tuoi progetti, ma permette di svolgere anche altri compiti. +Si presuppone una conoscenza dell'uso della linea di comando. + +## Installazione +1. Assicurarsi di avere la Java 8 JDK (conosciuta anche come 1.8) installata + * Per verificarlo, eseguire `javac -version` da linea di comando e controllare che nell'output sia riportato + `javac 1.8.___` + * Se non si possiede la versione 1.8 o superiore, installarla seguendo [queste indicazioni](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) +1. Installare sbt + * [Mac](https://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Mac.html) + * [Windows](https://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Windows.html) + * [Linux](https://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Linux.html) + +## Creare il progetto +1. Eseguire il comando `cd` specificando una cartella vuota per spostarsi in essa. +1. Eseguire il comando `sbt new scala/hello-world.g8`. Questo effettuerà una pull del template 'hello-world' da GitHub. + Si occuperà inoltre di creare la cartella `target`, che per ora può essere ignorata. +1. Quando richiesto verrà richiesto il nome dell'applicazione, indicare `hello-world`. In questo modo verrà creato un progetto chiamato "hello-world". +1. Osserviamo cosa è stato generato una volta eseguiti i passaggi sopra riportati: + +``` +- hello-world + - project (sbt usa questa cartella per installare e gestire plugins e dipendenze) + - build.properties + - src + - main + - scala (Tutto il codice scala che viene scritto dovrà andare qui) + - Main.scala (Entry point dell'applicazione) <-- per ora è tutto ciò che ci servirà + - build.sbt (il file di definizione della build interpretato da sbt) +``` + +Una volta che verrà buildato il progetto, sbt creerà diverse cartelle `target` per i file generati. Possono essere ignorate per lo scopo di questo tutorial. + +## Eseguire il progetto +1. `cd` nella cartella `hello-world`. +1. Lanciare il comando `sbt`. Questo aprirà la console di sbt. +1. Eseguire `~run`. Il carattere `~` è opzionale. Indica ad sbt di eseguirsi ad ogni salvataggio di un file, permettendo un ciclo di modifica, esecuzione e debug più veloce. sbt genererà anche una cartella chiamata `target` che può essere ignorata. + +## Modificare il codice +1. Aprire il file `src/main/scala/Main.scala` in un qualsiasi editor di testo. +1. Modificare "Hello, World!" in "Hello, New York!" +1. Se non è stato interrotto il comando sbt, dovrebbe ora apparire "Hello, New York!" sulla console. +1. Si può continuare a modificare il file, e le modifiche dovrebbero apparire a schermo se non vengono riportati errori. + +## Aggiungere una dipendenza +Vediamo ora come utilizzare librerie pubblicate da terzi per aggiungere ulteriori funzionalità alle nostre applicazioni. + +1. Aprire il file `build.sbt` con un qualsiasi editor di testo e aggiungere la seguente riga: + +``` +libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % "1.1.2" +``` +`libraryDependencies` è un set (un tipo di collection in scala), e utilizzando il simbolo `+=`, +si sta aggiungendo la dipendenza [scala-parser-combinators](https://github.com/scala/scala-parser-combinators) al set di dipendenze che sbt fetcherà quando verà inizializzato. +Una volta eseguito questo passaggio, sarà possibile importare classi, object ed altro da scala-parser-combinators tramite una semplice istruzione di import. + +Ulteriori librerie pubblicate possono essere trovate sul sito +[Scaladex](https://index.scala-lang.org/), dove è possibile copiare le informazioni delle dipendenze cercate nel file `build.sbt`. + +## Next steps + +Si consiglia di continuare al tutorial successivo della serie _getting started with sbt_ , ed imparare a [testare il codice Scala con sbt tramite linea di comando](testing-scala-with-sbt-on-the-command-line.html). + +**oppure** + +- Continuare ad imparare Scala online e in maniera interattiva su + [Scala Exercises](https://www.scala-exercises.org/scala_tutorial). +- Imparare le feature di Scala tramite articoli più concisi su [Tour of Scala]({{ site.baseurl }}/tour/tour-of-scala.html). \ No newline at end of file diff --git a/_it/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md b/_it/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md new file mode 100644 index 0000000000..cac6f0953a --- /dev/null +++ b/_it/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md @@ -0,0 +1,101 @@ +--- +title: Testare scala con sbt da linea di comando +layout: singlepage-overview +partof: testing-scala-with-sbt-on-the-command-line +language: it +disqus: true +previous-page: /it/getting-started-with-scala-and-sbt-on-the-command-line +--- + +Ci sono diverse librerie e modalità per testare il codice Scala, ma in questo tutorial verrà mostrato come eseguire il testing usando [AnyFunSuite](https://www.scalatest.org/scaladoc/3.2.2/org/scalatest/funsuite/AnyFunSuite.html) del framework ScalaTest. +Si assume che si sappia [creare un progetto Scala con sbt](getting-started-with-scala-and-sbt-on-the-command-line.html). + +## Setup +1. Da linea di comando, creare una nuova directory in una posizione a propria scelta. +1. `cd` nella cartella appena creata ed eseguire `sbt new scala/scalatest-example.g8` +1. Quando richiesto, rinominare il progetto come `ScalaTestTutorial`. +1. Il progetto avrà già in se la libreria ScalaTest come dipendenza indicata nel file `build.sbt`. +1. `cd` nel progetto ed eseguire `sbt test`. Questo eseguirà la test suite +`CubeCalculatorTest` con un unico test chiamato `CubeCalculator.cube`. + +``` +sbt test +[info] Loading global plugins from /Users/username/.sbt/0.13/plugins +[info] Loading project definition from /Users/username/workspace/sandbox/my-something-project/project +[info] Set current project to scalatest-example (in build file:/Users/username/workspace/sandbox/my-something-project/) +[info] CubeCalculatorTest: +[info] - CubeCalculator.cube +[info] Run completed in 267 milliseconds. +[info] Total number of tests run: 1 +[info] Suites: completed 1, aborted 0 +[info] Tests: succeeded 1, failed 0, canceled 0, ignored 0, pending 0 +[info] All tests passed. +[success] Total time: 1 s, completed Feb 2, 2017 7:37:31 PM +``` + +## Comprendere i test +1. In qualsiasi editor di testo aprire i seguenti due file: + * `src/main/scala/CubeCalculator.scala` + * `src/test/scala/CubeCalculatorTest.scala` +1. Nel file `CubeCalculator.scala`, è riportata la definizione della funzione `cube`. +1. Nel file `CubeCalculatorTest.scala`, è presente una classe chiamata allo stesso modo dell'oggetto che stiamo testando. + +``` + import org.scalatest.funsuite.AnyFunSuite + + class CubeCalculatorTest extends AnyFunSuite { + test("CubeCalculator.cube") { + assert(CubeCalculator.cube(3) === 27) + } + } +``` + +Analizziamo ogni riga di codice. + +* `class CubeCalculatorTest` significa che stiamo testando l'oggetto `CubeCalculator` +* `extends AnyFunSuite` ci permette di utilizzare la funzionalità della classe AnyFunSuite, come ad esempio la funzione `test` +* `test` è una funzione proveniente da AnyFunSuite che raccoglie i risultati delle asserzioni all'interno del corpo della funzione. +* `"CubeCalculator.cube"` è il nome del test. Può essere chiamato in qualsiasi modo, ma la convenzione è "NomeClasse.nomeMetodo". +* `assert` prende una condizione booleana e stabilisce se il test è superato o no. +* `CubeCalculator.cube(3) === 27` controlla se l'output della funzione `cube` sia realmente 27. +Il simbolo `===` è parte di ScalaTest e restituisce messaggi di errore comprensibili. + +## Aggiungere un altro test case +1. Aggiungere un altro blocco di testo contenente il proprio enunciato `assert` che verificherà il cubo di `0`. + + ``` + import org.scalatest.funsuite.AnyFunSuite + + class CubeCalculatorTest extends AnyFunSuite { + test("CubeCalculator.cube 3 should be 27") { + assert(CubeCalculator.cube(3) === 27) + } + + test("CubeCalculator.cube 0 should be 0") { + assert(CubeCalculator.cube(0) === 0) + } + } + ``` + +1. Lanciare `sbt test` nuovamente e controllare i risultati. + + ``` + sbt test + [info] Loading project definition from C:\projects\scalaPlayground\scalatestpractice\project + [info] Loading settings for project root from build.sbt ... + [info] Set current project to scalatest-example (in build file:/C:/projects/scalaPlayground/scalatestpractice/) + [info] Compiling 1 Scala source to C:\projects\scalaPlayground\scalatestpractice\target\scala-2.13\test-classes ... + [info] CubeCalculatorTest: + [info] - CubeCalculator.cube 3 should be 27 + [info] - CubeCalculator.cube 0 should be 0 + [info] Run completed in 257 milliseconds. + [info] Total number of tests run: 2 + [info] Suites: completed 1, aborted 0 + [info] Tests: succeeded 2, failed 0, canceled 0, ignored 0, pending 0 + [info] All tests passed. + [success] Total time: 3 s, completed Dec 4, 2019 10:34:04 PM + ``` + +## Conclusioni +In questo tutorial è stato mostrato una delle modalità per testare il codice Scala. Per saperne di più su FunSuite si può consultare [il sito ufficiale](https://www.scalatest.org/getting_started_with_fun_suite). +Si possono anche consultare altri framework di testing come [ScalaCheck](https://www.scalacheck.org/) e [Specs2](https://etorreborre.github.io/specs2/). From 100ba0eb73d497874afc0e7c3c3a07c2b9405e4e Mon Sep 17 00:00:00 2001 From: Ondrej Lhotak Date: Thu, 31 Mar 2022 11:07:03 +0200 Subject: [PATCH 1823/3075] add instructions for viewing contents of .tasty files to Tasty Overview --- scala3/guides/tasty-overview.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/scala3/guides/tasty-overview.md b/scala3/guides/tasty-overview.md index 11d0fa3608..1bf643bebd 100644 --- a/scala3/guides/tasty-overview.md +++ b/scala3/guides/tasty-overview.md @@ -52,6 +52,13 @@ $ scalac | Hello.scala | -> | Hello.tasty | -> | Hello.class | information) ``` +You can view the contents of a _.tasty_ file in a human-readable form by running the compiler on it with the `-print-tasty` flag. +You can also view the contents decompiled in a form similar to Scala source code using the `-decompile` flag. +```bash +$ scalac -print-tasty hello.tasty +$ scalac -decompile hello.tasty +``` + ### The issue with _.class_ files Because of issues such as [type erasure][erasure], _.class_ files are actually an incomplete representation of your code. From 6d41790cd92819c3f645342eb8bfd5d779294032 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Thu, 31 Mar 2022 11:30:57 +0200 Subject: [PATCH 1824/3075] Add scastie, rename top links --- _data/nav-header.yml | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/_data/nav-header.yml b/_data/nav-header.yml index b04b23ca78..eeaa88291c 100644 --- a/_data/nav-header.yml +++ b/_data/nav-header.yml @@ -1,10 +1,12 @@ -- title: Documentation +- title: Learn url: "/" -- title: Download +- title: Install url: https://www.scala-lang.org/download/ +- title: Playground + url: https://scastie.scala-lang.org +- title: Find A Library + url: https://index.scala-lang.org - title: Community url: https://www.scala-lang.org/community/ -- title: Libraries - url: https://index.scala-lang.org - title: Blog url: https://www.scala-lang.org/blog/ From f69fb47e4ad56bc419efbcb6ca8739555728635a Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Thu, 31 Mar 2022 04:34:41 -0700 Subject: [PATCH 1825/3075] Normalize type param and add clarity per review --- _tour/lower-type-bounds.md | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/_tour/lower-type-bounds.md b/_tour/lower-type-bounds.md index 9f5cd53b89..f4191b425b 100644 --- a/_tour/lower-type-bounds.md +++ b/_tour/lower-type-bounds.md @@ -16,33 +16,30 @@ While [upper type bounds](upper-type-bounds.html) limit a type to a subtype of a Here is an example where this is useful: ```scala mdoc:fail -trait List[+B] { - def prepend(elem: B): NonEmptyList[B] = NonEmptyList(elem, this) +trait List[+A] { + def prepend(elem: A): NonEmptyList[A] = NonEmptyList(elem, this) } -case class NonEmptyList[+B](head: B, tail: List[B]) extends List[B] +case class NonEmptyList[+A](head: A, tail: List[A]) extends List[A] object Nil extends List[Nothing] ``` -This program implements a singly-linked list. `Nil` represents an empty list with no elements. `class NonEmptyList` is a node which contains an element of type `B` (`head`) and a reference to the rest of the list (`tail`). The `trait List` and its subtypes are covariant because we have `+B`. +This program implements a singly-linked list. `Nil` represents an empty list with no elements. `class NonEmptyList` is a node which contains an element of type `A` (`head`) and a reference to the rest of the list (`tail`). The `trait List` and its subtypes are covariant because we have `+A`. -However, this program does _not_ compile because the parameter `elem` in `prepend` is of type `B`, which we declared *co*variant. This doesn't work because functions are *contra*variant in their parameter types and *co*variant in their result types. +However, this program does _not_ compile because the parameter `elem` in `prepend` is of type `A`, which we declared *co*variant. This doesn't work because functions are *contra*variant in their parameter types and *co*variant in their result types. -To fix this, we need to flip the variance of the type of the parameter `elem` in `prepend`. We do this by introducing a new type parameter `U` that has `B` as a lower type bound. +To fix this, we need to flip the variance of the type of the parameter `elem` in `prepend`. We do this by introducing a new type parameter `B` that has `A` as a lower type bound. ```scala mdoc -trait List[+B] { - def prepend[U >: B](elem: U): NonEmptyList[U] = NonEmptyList(elem, this) +trait List[+A] { + def prepend[B >: A](elem: B): NonEmptyList[B] = NonEmptyList(elem, this) } -case class NonEmptyList[+B](head: B, tail: List[B]) extends List[B] +case class NonEmptyList[+A](head: A, tail: List[A]) extends List[A] object Nil extends List[Nothing] ``` - -The type parameter for `List` is `B` to suggest we want to keep lists of birds. - Now we can do the following: ```scala mdoc trait Bird @@ -51,21 +48,25 @@ case class EuropeanSwallow() extends Bird val africanSwallows: List[AfricanSwallow] = Nil.prepend(AfricanSwallow()) val swallowsFromAntarctica: List[Bird] = Nil +val someBird: Bird = EuropeanSwallow() // assign swallows to birds val birds: List[Bird] = africanSwallows +// add some bird to swallows, `B` is `Bird` +val someBirds = africanSwallows.prepend(someBird) + // add a swallow to birds val moreBirds = birds.prepend(EuropeanSwallow()) -// add disparate swallows together to get birds +// add disparate swallows together, `B` is `Bird` because that is the supertype common to both swallows val allBirds = africanSwallows.prepend(EuropeanSwallow()) // but this is a mistake! adding a list of birds widens the type arg too much. -Xlint will warn! -val error = moreBirds.prepend(swallowsFromAntarctica) +val error = moreBirds.prepend(swallowsFromAntarctica) // List[Object] ``` The covariant type parameter allows `birds` to get the value of `africanSwallows`. The type bound on the type parameter for `prepend` allows adding different varieties of swallows and getting a wider type: instead of `List[AfricanSwallow]`, we get a `List[Bird]`. -The canary in the coal mine is `-Xlint`, which will warn if the type arg is widened too much. +Use `-Xlint` to warn if the inferred type arg is widened too much. From 9821a64394baf44857099a69a95dca605b7e1ad3 Mon Sep 17 00:00:00 2001 From: Lixiang Ao Date: Fri, 1 Apr 2022 15:18:59 -0700 Subject: [PATCH 1826/3075] Remove deprecated methods As of 2.13.4, the following methods have been deprecated: - append(elems: A*): ArrayBuffer.this.type - prepend(elems: A*): ArrayBuffer.this.type - trimStart(n: Int): Unit - trimEnd(n: Int): Unit Affected examples are updated in this pr. --- _overviews/scala-book/arraybuffer-examples.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/_overviews/scala-book/arraybuffer-examples.md b/_overviews/scala-book/arraybuffer-examples.md index 8d4dd8ef53..381b593e49 100644 --- a/_overviews/scala-book/arraybuffer-examples.md +++ b/_overviews/scala-book/arraybuffer-examples.md @@ -114,24 +114,22 @@ As a brief overview, here are several methods you can use with an `ArrayBuffer`: ```scala val a = ArrayBuffer(1, 2, 3) // ArrayBuffer(1, 2, 3) a.append(4) // ArrayBuffer(1, 2, 3, 4) -a.append(5, 6) // ArrayBuffer(1, 2, 3, 4, 5, 6) -a.appendAll(Seq(7,8)) // ArrayBuffer(1, 2, 3, 4, 5, 6, 7, 8) +a.appendAll(Seq(5, 6)) // ArrayBuffer(1, 2, 3, 4, 5, 6) a.clear // ArrayBuffer() val a = ArrayBuffer(9, 10) // ArrayBuffer(9, 10) a.insert(0, 8) // ArrayBuffer(8, 9, 10) a.insertAll(0, Vector(4, 5, 6, 7)) // ArrayBuffer(4, 5, 6, 7, 8, 9, 10) a.prepend(3) // ArrayBuffer(3, 4, 5, 6, 7, 8, 9, 10) -a.prepend(1, 2) // ArrayBuffer(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) -a.prependAll(Array(0)) // ArrayBuffer(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +a.prependAll(Array(0, 1, 2)) // ArrayBuffer(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10) val a = ArrayBuffer.range('a', 'h') // ArrayBuffer(a, b, c, d, e, f, g) a.remove(0) // ArrayBuffer(b, c, d, e, f, g) a.remove(2, 3) // ArrayBuffer(b, c, g) val a = ArrayBuffer.range('a', 'h') // ArrayBuffer(a, b, c, d, e, f, g) -a.trimStart(2) // ArrayBuffer(c, d, e, f, g) -a.trimEnd(2) // ArrayBuffer(c, d, e) +a.dropInPlace(2) // ArrayBuffer(c, d, e, f, g) +a.dropRightInPlace(2) // ArrayBuffer(c, d, e) ``` From f7afc59478816fbfaf4c1991d22fc4d1f900daa5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Krenski?= Date: Sun, 3 Apr 2022 18:39:02 +0200 Subject: [PATCH 1827/3075] Fix 2.13 -Xsource:3 flag in incompatibility table --- _overviews/scala3-migration/incompatibility-table.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/incompatibility-table.md b/_overviews/scala3-migration/incompatibility-table.md index 36e156a868..e699addbfe 100644 --- a/_overviews/scala3-migration/incompatibility-table.md +++ b/_overviews/scala3-migration/incompatibility-table.md @@ -19,7 +19,7 @@ Each incompatibility is described by: - The existence of a Scalafix rule that can fix it > #### Scala 2.13 deprecations and feature warnings -> Run the 2.13 compilation with `-source:3` to locate those incompatibilities in the code. +> Run the 2.13 compilation with `-Xsource:3` to locate those incompatibilities in the code. > #### Scala 3 migration versus Scalafix rewrites > The Scala 3 migration mode comes out-of-the-box. From a9de797f1d0cc5957221d13406038606a28cdd65 Mon Sep 17 00:00:00 2001 From: Florian CUNY Date: Mon, 4 Apr 2022 15:05:55 +0200 Subject: [PATCH 1828/3075] fixed typo --- _overviews/scala-book/pure-functions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala-book/pure-functions.md b/_overviews/scala-book/pure-functions.md index e753d67ce4..97c6ef6fb9 100644 --- a/_overviews/scala-book/pure-functions.md +++ b/_overviews/scala-book/pure-functions.md @@ -49,7 +49,7 @@ Conversely, the following functions are *impure* because they violate the defini The `foreach` method on collections classes is impure because it’s only used for its side effects, such as printing to STDOUT. ->A great hint that `foreach` is impure is that it’s method signature declares that it returns the type `Unit`. Because it returns nothing, logically the only reason you ever call it is to achieve some side effect. Similarly, *any* method that returns `Unit` is going to be an impure function. +>A great hint that `foreach` is impure is that its method signature declares that it returns the type `Unit`. Because it returns nothing, logically the only reason you ever call it is to achieve some side effect. Similarly, *any* method that returns `Unit` is going to be an impure function. Date and time related methods like `getDayOfWeek`, `getHour`, and `getMinute` are all impure because their output depends on something other than their input parameters. Their results rely on some form of hidden I/O, *hidden input* in these examples. From 180b9088915462d575813bc2644e598fb2f00348 Mon Sep 17 00:00:00 2001 From: Jason Pickens Date: Wed, 6 Apr 2022 08:02:06 +1200 Subject: [PATCH 1829/3075] Remove strikethrough from rewrite steps example (#2356) --- _overviews/scala3-migration/tooling-syntax-rewriting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/tooling-syntax-rewriting.md b/_overviews/scala3-migration/tooling-syntax-rewriting.md index 976e3c097e..bbe246aa1e 100644 --- a/_overviews/scala3-migration/tooling-syntax-rewriting.md +++ b/_overviews/scala3-migration/tooling-syntax-rewriting.md @@ -86,7 +86,7 @@ We will be able to move it to new syntax automatically in two steps: first by us > The `-indent` option does not work on the classic control structures. > So make sure to run the two steps in the correct order. -> Unfortunately, the compiler is not able to apply both steps at the same time: `-indent -new-syntax -rewrite`. +> Unfortunately, the compiler is not able to apply both steps at the same time: `-indent -new-syntax -rewrite`. ### New Control Structures From 3841483fd8a4c2e64fc021db1eca8d42a264f0ff Mon Sep 17 00:00:00 2001 From: Artem Korsakov Date: Sat, 9 Apr 2022 10:26:48 +0300 Subject: [PATCH 1830/3075] Fix error in `given` definition We can see in the [reference](https://docs.scala-lang.org/scala3/reference/contextual/givens.html) that the right `given` definition is: ``` given intMonthConverter: MonthConverter[Int] with ``` --- _overviews/scala3-book/packaging-imports.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/packaging-imports.md b/_overviews/scala3-book/packaging-imports.md index 07450f72f8..3ae2e7c318 100644 --- a/_overviews/scala3-book/packaging-imports.md +++ b/_overviews/scala3-book/packaging-imports.md @@ -354,20 +354,19 @@ object MonthConversions: trait MonthConverter[A]: def convert(a: A): String - given intMonthConverter as MonthConverter[Int]: + given intMonthConverter: MonthConverter[Int] with def convert(i: Int): String = i match case 1 => "January" case 2 => "February" // more cases here ... - given stringMonthConverter as MonthConverter[String]: + given stringMonthConverter: MonthConverter[String] with def convert(s: String): String = s match case "jan" => "January" case "feb" => "February" // more cases here ... -} ``` To import those givens into the current scope, use these two `import` statements: From 519639583aa576680692632a85d94cf1b4118ddb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=A2=A6=E5=A2=83=E8=BF=B7=E7=A6=BB?= Date: Mon, 11 Apr 2022 20:13:10 +0800 Subject: [PATCH 1831/3075] add zn-cn --- _zh-cn/scala3/new-in-scala3.md | 128 +++++++++++++++++++++++++++++++++ scala3/new-in-scala3.md | 2 +- 2 files changed, 129 insertions(+), 1 deletion(-) create mode 100644 _zh-cn/scala3/new-in-scala3.md diff --git a/_zh-cn/scala3/new-in-scala3.md b/_zh-cn/scala3/new-in-scala3.md new file mode 100644 index 0000000000..28b458c8d5 --- /dev/null +++ b/_zh-cn/scala3/new-in-scala3.md @@ -0,0 +1,128 @@ +--- +layout: singlepage-overview +title: New in Scala 3 +scala3: true +--- + +令人振奋的新版 Scala 3 带来了许多改进和新功能。在这里，我们为你提供最重要的变更的快速概述。如果你想深入挖掘，还有一些参考资料供你使用。 + +- [Scala 3 Book]({% link _overviews/scala3-book/introduction.md %}) 面向刚接触 Scala 语言的开发人员。 +- [Syntax Summary][syntax-summary] 为您提供了新语法的正式描述。 +- [Language Reference][reference] 对 Scala 2 到 Scala 3 的变化做了详细说明。 +- [Migration Guide][migration] 为你提供了从 Scala 2 迁移到 Scala 3 的所有必要信息。 +- [Scala 3 Contributing Guide][contribution] Scala 3 贡献指南，更深入地探讨了编译器，包括修复问题的指南。 + +## What's new in Scala 3 +Scala 3 是对 Scala 语言的一次彻底改造。在其核心部分，类型系统的许多方面都被改变了，变得更有原则性。虽然这也带来了令人兴奋的新功能（比如联合类型），但首先意味着类型系统变得（甚至）不那么碍事了，例如[类型推断][type-inference]和 overload resolution 都得到了很大的改善。 + +### 新的和闪亮的：语法 + +除了许多（小的）清理，Scala 3 的语法还提供了以下改进： + +- 用于控制结构的新“quiet”语法，如 `if`、`while` 和 `for` 。 ([new control syntax][syntax-control]) +- `new` 关键字是可选的 (_aka_ [creator applications][creator]) +- [Optional braces][syntax-indentation]：可选的大括号，支持不受干扰、缩进敏感的编程风格 +- [类型级通配符][syntax-wildcard] 从 `_` 更改为 `?`。 +- implicit（和它们的语法）已被[大量修订][implicits]。 + +### Opinionated: Contextual Abstractions +Scala的一个基本核心概念是（在某种程度上仍然是）为用户提供一小部分强大的功能，这些功能可以被组合成巨大的（有时甚至是不可预见的）表达能力。例如，_implicit_ 的特性被用来模拟上下文抽象、表达类型级计算、模拟类型类、执行隐式强制、编码扩展方法等等。从这些用例中学习，Scala 3 采取了一种略微不同的方法，专注于 __意图__ 而非 __机制__。Scala 3 没有提供一个非常强大的功能，而是提供了多个定制的语言功能，让程序员直接表达他们的意图。 + +- **Abtracting over contextual information**. [Using clauses][contextual-using] 允许程序员对调用上下文中的信息进行抽象，这些信息应该以隐式方式传递。作为对 Scala 2 implicits 的改进，可以按类型指定`using`子句，从而将函数签名从从未显式引用的术语变量名中解放出来。 + +- **Providing Type-class instances**. [Given instances][contextual-givens] 允许程序员定义某个类型的 _规范值_ 。这使得使用类型类的编程更加简单，而不会泄露实现细节。 + +- **Retroactively extending classes**. 在 Scala 2 中，扩展方法必须使用隐式转换或隐式类进行编码。相比之下，在 Scala 3 中，[extension methods][contextual-extension]现在直接内置于语言中，从而产生更好的错误消息和改进的类型推断。 + +- **Viewing one type as another**. 隐式转换已经被重新[设计][contextual-conversions]为类型类转`Conversion`的实例。 + +- **Higher-order contextual abstractions**. [context functions][contextual-functions]的 _全新_ 功能使上下文抽象成为一流的公民。它们是库作者的一个重要工具，允许表达简洁的特定领域语言。 + +- **Actionable feedback from the compiler**. 如果一个隐式参数不能被编译器解决，它现在提供了可能解决这个问题的[import suggestions](https://www.scala-lang.org/blog/2020/05/05/scala-3-import-suggestions.html)。 + +### Say What You Mean: 类型系统改进 +除了极大地改进了类型推断，Scala 3 类型系统还提供了许多新的功能，还为你提供了强大的工具来静态地表达类型中的不变量。 + +- **Enumerations**. [枚举][enums]已经被重新设计，以便与样例类很好地融合，并形成表达[代数数据类型][enums-adts]的新标准。 + +- **Opaque Types**. 将实现细节隐藏在[opaque type aliases][types-opaque]的别名后面，而不需要在性能上付出代价! Opaque types 取代了值类，并允许你建立一个抽象的屏障，而不会造成额外的装箱开销。 + +- **Intersection and union types**. 将类型系统建立在新的基础上，导致了新的类型系统功能的引入：[intersection types][types-intersection]的实例，如`A & B`，既是`A`的实例，也是`B`的实例；[union types][types-union]的实例，如`A | B`，是`A`或`B`的实例。这两种结构都允许程序员在继承层次结构之外灵活地表达类型约束。 + +- **Dependent function types**. Scala 2 已经允许返回类型依赖于（值）参数。在 Scala 3 中，现在可以对这种模式进行抽象，表达[dependent function types][types-dependent]。在类型`F = (e: Entry) => e.Key`中，结果类型取决于参数。 + +- **Polymorphic function types**. 与 dependent function types 一样，Scala 2 支持拥有类型参数的方法，但不允许程序员对这些方法进行抽象。在 Scala 3 中，像`[A] => List[A] => List[A]`这样的[polymorphic function types][types-polymorphic]可以抽象出除值参数外还接受 _类型参数_ 的函数。 + +- **Type lambdas**. 在 Scala 2 中需要用[编译器插件](https://github.com/typelevel/kind-projector)来表达的东西，现在在 Scala 3 中是第一类的功能：类型lambdas是类型级别的函数，可以作为（高等类型的）类型参数传递，而不需要辅助类型定义。 + +- **Match types**. Scala 3 提供了对[matching on types][types-match]的直接支持，而不是使用隐式解析对类型级别的计算进行编码。将类型级计算整合到类型检查器中，可以改进错误信息，并消除对复杂编码的需求。 + +### 重新设想的：面向对象的编程 + +Scala 一直处于函数式编程和面向对象编程的前沿 -- 而 Scala 3 在这两个方向上都推动了边界的发展! 上述类型系统的变化和上下文抽象的重新设计使得 _函数式编程_ 比以前更容易。同时，以下的新特性使结构良好的 _面向对象设计_ 成为可能，并支持最佳实践。 + +- **Pass it on**. Trait 更接近于 class，现在也可以接受[参数][oo-trait-parameters]，使其作为模块化软件分解的工具更加强大。 + +- **Plan for extension**. 在面向对象的设计中，扩展那些不打算扩展的类是一个长期存在的问题。为了解决这个问题，[open classes][oo-open]要求库设计者 _明确地_ 将类标记为 open（开放的）。 + +- **Hide implementation details**. 实施行为的实用性traits有时不应该是推断类型的一部分。在 Scala 3 中，这些traits可以被标记为[transparent][oo-transparent]，（在推断类型中）向用户隐藏继承性。 + +- **Composition over inheritance**. 这句话经常被引用，但实现起来却很繁琐。Scala 3 的[export clauses][oo-export]则不然：与imports对应，export clauses 允许用户为对象的选定成员定义别名。 + +- **No more NPEs**. Scala 3 比以往任何时候都更安全：[explicit null][oo-explicit-null]将`null`移出了类型层次结构，帮助你静态地捕捉错误；[safe initialization][oo-safe-init]的额外检查可以检测对未初始化对象的访问。 + +### Batteries Included: 元编程 +Scala 2 中的宏只是一个实验性的功能，而 Scala 3 则为元编程提供了强大的工具库。[宏教程]({% link _overviews/scala3-macros/tutorial/index.md %})中包含了关于不同设施的详细信息。特别是，Scala 3 为元编程提供了以下功能： + +作为基本的起点，[inline feature][meta-inline]允许在编译时减少数值和方法。这个简单的功能已经涵盖了许多使用情况，同时也为更高级的功能提供了入口。 + +- **Inline**. [inline feature][meta-inline]允许在编译时减少数值和方法。这个简单的功能已经涵盖了许多使用情况，同时也为更高级的功能提供了入口。 +- **Compile-time operations**. 包[`scala.compiletime`][meta-compiletime]中包含了额外的功能，可以用来实现内联方法。 +- **Quoted code blocks**. Scala 3为代码增加了[quasi-quotation][meta-quotes]的新功能，这为构建和分析代码提供了方便的高级接口。构建加一加一的代码就像`'{ 1 + 1 }`一样简单。 +- **Reflection API**. 对于更高级的用例，[quotes.reflect][meta-reflection]提供了更详细的控制来检查和生成程序树。 + + +如果你想进一步了解 Scala 3 中的元编程，我们邀请你参加我们的[教程][meta-tutorial]。 + +[enums]: {{ site.scala3ref }}/enums/enums.html +[enums-adts]: {{ site.scala3ref }}/enums/adts.html + +[types-intersection]: {{ site.scala3ref }}/new-types/intersection-types.html +[types-union]: {{ site.scala3ref }}/new-types/union-types.html +[types-dependent]: {{ site.scala3ref }}/new-types/dependent-function-types.html +[types-lambdas]: {{ site.scala3ref }}/new-types/type-lambdas.html +[types-polymorphic]: {{ site.scala3ref }}/new-types/polymorphic-function-types.html +[types-match]: {{ site.scala3ref }}/new-types/match-types.html +[types-opaque]: {{ site.scala3ref }}/other-new-features/opaques.html + +[type-inference]: {{ site.scala3ref }}/changed-features/type-inference.html +[overload-resolution]: {{ site.scala3ref }}/changed-features/overload-resolution.html +[reference]: {{ site.scala3ref }}/overview.html +[creator]: {{ site.scala3ref }}/other-new-features/creator-applications.html +[migration]: {% link _overviews/scala3-migration/compatibility-intro.md %} +[contribution]: {% link _overviews/scala3-contribution/contribution-intro.md %} + +[implicits]: {{ site.scala3ref }}/contextual.html +[contextual-using]: {{ site.scala3ref }}/contextual/using-clauses.html +[contextual-givens]: {{ site.scala3ref }}/contextual/givens.html +[contextual-extension]: {{ site.scala3ref }}/contextual/extension-methods.html +[contextual-conversions]: {{ site.scala3ref }}/contextual/conversions.html +[contextual-functions]: {{ site.scala3ref }}/contextual/context-functions.html + +[syntax-summary]: {{ site.scala3ref }}/syntax.html +[syntax-control]: {{ site.scala3ref }}/other-new-features/control-syntax.html +[syntax-indentation]: {{ site.scala3ref }}/other-new-features/indentation.html +[syntax-wildcard]: {{ site.scala3ref }}/changed-features/wildcards.html + +[meta-tutorial]: {% link _overviews/scala3-macros/tutorial/index.md %} +[meta-inline]: {% link _overviews/scala3-macros/tutorial/inline.md %} +[meta-compiletime]: {% link _overviews/scala3-macros/tutorial/compiletime.md %} +[meta-quotes]: {% link _overviews/scala3-macros/tutorial/quotes.md %} +[meta-reflection]: {% link _overviews/scala3-macros/tutorial/reflection.md %} + +[oo-explicit-null]: {{ site.scala3ref }}/other-new-features/explicit-nulls.html +[oo-safe-init]: {{ site.scala3ref }}/other-new-features/safe-initialization.html +[oo-trait-parameters]: {{ site.scala3ref }}/other-new-features/trait-parameters.html +[oo-open]: {{ site.scala3ref }}/other-new-features/open-classes.html +[oo-transparent]: {{ site.scala3ref }}/other-new-features/transparent-traits.html +[oo-export]: {{ site.scala3ref }}/other-new-features/export.html diff --git a/scala3/new-in-scala3.md b/scala3/new-in-scala3.md index af6d6111c1..5b30d76158 100644 --- a/scala3/new-in-scala3.md +++ b/scala3/new-in-scala3.md @@ -1,7 +1,7 @@ --- layout: singlepage-overview title: New in Scala 3 -languages: ["ja"] +languages: ["ja","zh-cn"] --- The exciting new version of Scala 3 brings many improvements and new features. Here we provide you with a quick overview of the most important From afcaefc6d26c42d36da3bbad2d1ef81244b01a48 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=A2=A6=E5=A2=83=E8=BF=B7=E7=A6=BB?= Date: Mon, 11 Apr 2022 20:25:45 +0800 Subject: [PATCH 1832/3075] fix --- _zh-cn/scala3/new-in-scala3.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/_zh-cn/scala3/new-in-scala3.md b/_zh-cn/scala3/new-in-scala3.md index 28b458c8d5..472f66331f 100644 --- a/_zh-cn/scala3/new-in-scala3.md +++ b/_zh-cn/scala3/new-in-scala3.md @@ -17,7 +17,7 @@ Scala 3 是对 Scala 语言的一次彻底改造。在其核心部分，类型 ### 新的和闪亮的：语法 -除了许多（小的）清理，Scala 3 的语法还提供了以下改进： +除了许多（小的）清理工作，Scala 3 的语法还提供了以下改进： - 用于控制结构的新“quiet”语法，如 `if`、`while` 和 `for` 。 ([new control syntax][syntax-control]) - `new` 关键字是可选的 (_aka_ [creator applications][creator]) @@ -34,9 +34,9 @@ Scala的一个基本核心概念是（在某种程度上仍然是）为用户提 - **Retroactively extending classes**. 在 Scala 2 中，扩展方法必须使用隐式转换或隐式类进行编码。相比之下，在 Scala 3 中，[extension methods][contextual-extension]现在直接内置于语言中，从而产生更好的错误消息和改进的类型推断。 -- **Viewing one type as another**. 隐式转换已经被重新[设计][contextual-conversions]为类型类转`Conversion`的实例。 +- **Viewing one type as another**. [隐式转换][contextual-conversions]已经被重新设计为类型类`Conversion`的实例。 -- **Higher-order contextual abstractions**. [context functions][contextual-functions]的 _全新_ 功能使上下文抽象成为一流的公民。它们是库作者的一个重要工具，允许表达简洁的特定领域语言。 +- **Higher-order contextual abstractions**. [context functions][contextual-functions]的 _全新_ 功能使上下文抽象成为一流的公民。它们是库开发人员的一个重要工具，允许表达简洁的特定领域语言。 - **Actionable feedback from the compiler**. 如果一个隐式参数不能被编译器解决，它现在提供了可能解决这个问题的[import suggestions](https://www.scala-lang.org/blog/2020/05/05/scala-3-import-suggestions.html)。 @@ -74,15 +74,13 @@ Scala 一直处于函数式编程和面向对象编程的前沿 -- 而 Scala 3 ### Batteries Included: 元编程 Scala 2 中的宏只是一个实验性的功能，而 Scala 3 则为元编程提供了强大的工具库。[宏教程]({% link _overviews/scala3-macros/tutorial/index.md %})中包含了关于不同设施的详细信息。特别是，Scala 3 为元编程提供了以下功能： -作为基本的起点，[inline feature][meta-inline]允许在编译时减少数值和方法。这个简单的功能已经涵盖了许多使用情况，同时也为更高级的功能提供了入口。 - - **Inline**. [inline feature][meta-inline]允许在编译时减少数值和方法。这个简单的功能已经涵盖了许多使用情况，同时也为更高级的功能提供了入口。 - **Compile-time operations**. 包[`scala.compiletime`][meta-compiletime]中包含了额外的功能，可以用来实现内联方法。 - **Quoted code blocks**. Scala 3为代码增加了[quasi-quotation][meta-quotes]的新功能，这为构建和分析代码提供了方便的高级接口。构建加一加一的代码就像`'{ 1 + 1 }`一样简单。 - **Reflection API**. 对于更高级的用例，[quotes.reflect][meta-reflection]提供了更详细的控制来检查和生成程序树。 -如果你想进一步了解 Scala 3 中的元编程，我们邀请你参加我们的[教程][meta-tutorial]。 +如果你想进一步了解 Scala 3 中的元编程，我们邀请你参加[教程][meta-tutorial]。 [enums]: {{ site.scala3ref }}/enums/enums.html [enums-adts]: {{ site.scala3ref }}/enums/adts.html From 9109395ffc43c7168daf02d0b328aca7c116ec39 Mon Sep 17 00:00:00 2001 From: Gord Currie <1119730+gordcurrie@users.noreply.github.com> Date: Mon, 11 Apr 2022 09:04:42 -0500 Subject: [PATCH 1833/3075] Update implicit casting example (#2370) --- _overviews/scala3-book/first-look-at-types.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/_overviews/scala3-book/first-look-at-types.md b/_overviews/scala3-book/first-look-at-types.md index c62e2cc9dd..85c3214ad9 100644 --- a/_overviews/scala3-book/first-look-at-types.md +++ b/_overviews/scala3-book/first-look-at-types.md @@ -238,20 +238,19 @@ Value types can be cast in the following way: For example: ```scala -val x: Long = 987654321 -val y: Float = x // 9.8765434E8 (note that some precision is lost in this case) +val b: Byte = 127 +val i: Int = b // 127 val face: Char = '☺' val number: Int = face // 9786 ``` -Casting is unidirectional. -This will not compile: +You can only cast to a type if there is no loss of information. Otherwise, you need to be explicit about the cast: -``` +```scala val x: Long = 987654321 -val y: Float = x // 9.8765434E8 -val z: Long = y // Does not conform +val y: Float = x.toFloat // 9.8765434E8 (note that `.toFloat` is required because the cast results in percision loss) +val z: Long = y // Error ``` You can also cast a reference type to a subtype. From 10c29916a9bfebaa979209d9421ff6d2a43d8e08 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 12 Apr 2022 10:15:06 +0000 Subject: [PATCH 1834/3075] Bump nokogiri from 1.13.3 to 1.13.4 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.13.3 to 1.13.4. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/v1.13.4/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.13.3...v1.13.4) --- updated-dependencies: - dependency-name: nokogiri dependency-type: indirect ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 5b52d7697a..3c6f6b8d12 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -55,7 +55,7 @@ GEM rb-inotify (~> 0.9, >= 0.9.10) mercenary (0.3.6) mini_portile2 (2.8.0) - nokogiri (1.13.3) + nokogiri (1.13.4) mini_portile2 (~> 2.8.0) racc (~> 1.4) nokogumbo (2.0.2) From b9926e655a75be592d5fae52ca894e0490901692 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= Date: Tue, 12 Apr 2022 15:46:45 +0200 Subject: [PATCH 1835/3075] Update Scala version to 3.1.2 --- _config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_config.yml b/_config.yml index 43f6dfd536..accb4b5df1 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.8 scala-212-version: 2.12.15 -scala-3-version: 3.1.1 +scala-3-version: 3.1.2 collections: contribute_resources: From 10abafb233f9b2877585e4316cf30ab308bd7449 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= Date: Tue, 12 Apr 2022 15:50:34 +0200 Subject: [PATCH 1836/3075] Add entry for the documentation --- api/all.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/api/all.md b/api/all.md index ea55e544d9..33566543b6 100644 --- a/api/all.md +++ b/api/all.md @@ -6,8 +6,8 @@ includeTOC: true ## Latest releases -* Scala 3.1.1 - * [Library API](https://www.scala-lang.org/api/3.1.1/) +* Scala 3.1.2 + * [Library API](https://www.scala-lang.org/api/3.1.2/) * Scala 2.13.8 * [Library API](https://www.scala-lang.org/api/2.13.8/) * [Compiler API](https://www.scala-lang.org/api/2.13.8/scala-compiler/scala/) @@ -60,6 +60,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.1.1 + * [Library API](https://www.scala-lang.org/api/3.1.1/) * Scala 3.1.0 * [Library API](https://www.scala-lang.org/api/3.1.0/) * Scala 3.0.2 From 496e82cc9e0515c68f7359425728da91d8953a62 Mon Sep 17 00:00:00 2001 From: Jochen Schneider Date: Fri, 15 Apr 2022 18:37:06 +0200 Subject: [PATCH 1837/3075] Example variable typo --- _overviews/collections-2.13/maps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/maps.md b/_overviews/collections-2.13/maps.md index 3a27586614..8dff664b27 100644 --- a/_overviews/collections-2.13/maps.md +++ b/_overviews/collections-2.13/maps.md @@ -62,7 +62,7 @@ Mutable maps support in addition the operations summarized in the following tabl | WHAT IT IS | WHAT IT DOES | | ------ | ------ | | **Additions and Updates:**| | -| `ms(k) = v` |(Or, written out, `ms.update(x, v)`). Adds mapping from key `k` to value `v` to map ms as a side effect, overwriting any previous mapping of `k`.| +| `ms(k) = v` |(Or, written out, `ms.update(k, v)`). Adds mapping from key `k` to value `v` to map ms as a side effect, overwriting any previous mapping of `k`.| | `ms.addOne(k -> v)`
    or `ms += (k -> v)` |Adds mapping from key `k` to value `v` to map `ms` as a side effect and returns `ms` itself.| | `ms addAll xvs`
    or `ms ++= kvs` |Adds all mappings in `kvs` to `ms` as a side effect and returns `ms` itself.| | `ms.put(k, v)` |Adds mapping from key `k` to value `v` to `ms` and returns any value previously associated with `k` as an option.| From 86724d38cd620fff0568b1b6399e047f81de24ec Mon Sep 17 00:00:00 2001 From: Philippus Date: Sat, 16 Apr 2022 10:56:08 +0200 Subject: [PATCH 1838/3075] Update scalatest to 3.2.11 in scala book --- _overviews/scala-book/sbt-scalatest-bdd.md | 4 ++-- _overviews/scala-book/sbt-scalatest-tdd.md | 16 ++++++++-------- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/_overviews/scala-book/sbt-scalatest-bdd.md b/_overviews/scala-book/sbt-scalatest-bdd.md index ee20a8490e..5117bbc0fc 100644 --- a/_overviews/scala-book/sbt-scalatest-bdd.md +++ b/_overviews/scala-book/sbt-scalatest-bdd.md @@ -70,7 +70,7 @@ class MathUtilsSpec extends FunSpec { As you can see, this is a very different-looking style than the TDD tests in the previous lesson. If you’ve never used a BDD style of testing before, a main idea is that the tests should be relatively easy to read for one of the “domain experts” who work with the programmers to create the application. A few notes about this code: -- It uses the `FunSpec` class where the TDD tests used `FunSuite` +- It uses the `AnyFunSpec` class where the TDD tests used `AnyFunSuite` - A set of tests begins with `describe` - Each test begins with `it`. The idea is that the test should read like, “It should do XYZ...,” where “it” is the `double` function - This example also shows how to mark a test as “pending” @@ -96,7 +96,7 @@ With those files in place you can again run `sbt test`. The important part of th [info] Suites: completed 2, aborted 0 [info] Tests: succeeded 4, failed 0, canceled 0, ignored 0, pending 1 [info] All tests passed. -[success] Total time: 4 s, completed Jan 6, 2018 4:58:23 PM +[success] Total time: 4 s ```` A few notes about that output: diff --git a/_overviews/scala-book/sbt-scalatest-tdd.md b/_overviews/scala-book/sbt-scalatest-tdd.md index 7214566a09..a0c61da35c 100644 --- a/_overviews/scala-book/sbt-scalatest-tdd.md +++ b/_overviews/scala-book/sbt-scalatest-tdd.md @@ -39,7 +39,7 @@ version := "1.0" scalaVersion := "{{site.scala-version}}" libraryDependencies += - "org.scalatest" %% "scalatest" % "3.0.8" % Test + "org.scalatest" %% "scalatest" % "3.2.11" % Test ``` @@ -47,7 +47,7 @@ The first three lines of this file are essentially the same as the first example ```scala libraryDependencies += - "org.scalatest" %% "scalatest" % "3.0.8" % Test + "org.scalatest" %% "scalatest" % "3.2.11" % Test ``` >The ScalaTest documentation has always been good, and you can always find the up to date information on what those lines should look like on the [Installing ScalaTest](http://www.scalatest.org/install) page. @@ -85,8 +85,8 @@ There isn’t much that can go wrong with that source code, but it provides a si [warn] consider launching sbt without any commands, or explicitly passing 'shell' ... ... -[info] Compiling 1 Scala source to /Users/al/Projects/Scala/HelloScalaTest/target/scala-2.12/classes... -[info] Running simpletest.Hello +[info] compiling 1 Scala source to /Users/al/Projects/Scala/HelloScalaTest/target/scala-2.13/classes... +[info] running simpletest.Hello Hello Alvin Alexander [success] Total time: 4 s ```` @@ -108,9 +108,9 @@ Next, create a file named *HelloTests.scala* in that directory with the followin ```scala package simpletest -import org.scalatest.FunSuite +import org.scalatest.funsuite.AnyFunSuite -class HelloTests extends FunSuite { +class HelloTests extends AnyFunSuite { // test 1 test("the name is set correctly in constructor") { @@ -130,7 +130,7 @@ class HelloTests extends FunSuite { This file demonstrates the ScalaTest `FunSuite` approach. A few important points: -- Your class should extend `FunSuite` +- Your class should extend `AnyFunSuite` - You create tests as shown, by giving each `test` a unique name - At the end of each test you should call `assert` to test that a condition has been satisfied @@ -140,7 +140,7 @@ Now you can run these tests with the `sbt test` command. Skipping the first few ```` > sbt test -[info] Set current project to HelloScalaTest (in build file:/Users/al/Projects/Scala/HelloScalaTest/) +[info] set current project to HelloScalaTest (in build file:/Users/al/Projects/Scala/HelloScalaTest/) [info] HelloTests: [info] - the name is set correctly in constructor [info] - a Person's name can be changed From 9ac6061ceacad3e7a8906abe49e6a8f2504ac2f4 Mon Sep 17 00:00:00 2001 From: Philippus Date: Sat, 16 Apr 2022 10:56:35 +0200 Subject: [PATCH 1839/3075] Update scalatest to 3.2.11 in IntelliJ example --- .../testing-scala-in-intellij-with-scalatest.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index 77d0b3341a..fb34580984 100644 --- a/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -20,15 +20,15 @@ This assumes you know [how to build a project in IntelliJ](building-a-scala-proj 1. Add the ScalaTest dependency: 1. Add the ScalaTest dependency to your `build.sbt` file: ``` - libraryDependencies += "org.scalatest" %% "scalatest" % "3.0.8" % Test + libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.11" % Test ``` 1. If you get a notification "build.sbt was changed", select **auto-import**. 1. These two actions will cause `sbt` to download the ScalaTest library. - 1. Wait for the `sbt` sync to finish; otherwise, `FunSuite` and `test()` will be + 1. Wait for the `sbt` sync to finish; otherwise, `AnyFunSuite` and `test()` will be unrecognized. 1. On the project pane on the left, expand `src` => `main`. 1. Right-click on `scala` and select **New** => **Scala class**. -1. Call it `CubeCalculator`, change the **Kind** to `object`, and click **OK**. +1. Call it `CubeCalculator`, change the **Kind** to `object`, and hit enter or double click on `object`. 1. Replace the code with the following: ``` object CubeCalculator extends App { @@ -41,12 +41,12 @@ This assumes you know [how to build a project in IntelliJ](building-a-scala-proj ## Creating a test 1. On the project pane on the left, expand `src` => `test`. 1. Right-click on `scala` and select **New** => **Scala class**. -1. Name the class `CubeCalculatorTest` and click **OK**. +1. Name the class `CubeCalculatorTest` and hit enter or double click on `class`. 1. Replace the code with the following: ``` - import org.scalatest.FunSuite + import org.scalatest.funsuite.AnyFunSuite - class CubeCalculatorTest extends FunSuite { + class CubeCalculatorTest extends AnyFunSuite { test("CubeCalculator.cube") { assert(CubeCalculator.cube(3) === 27) } @@ -60,9 +60,9 @@ This assumes you know [how to build a project in IntelliJ](building-a-scala-proj Let's go over this line by line: * `class CubeCalculatorTest` means we are testing the object `CubeCalculator` -* `extends FunSuite` lets us use functionality of ScalaTest's FunSuite class +* `extends AnyFunSuite` lets us use functionality of ScalaTest's AnyFunSuite class such as the `test` function -* `test` is function that comes from the FunSuite library that collects +* `test` is a function that comes from the FunSuite library that collects results from assertions within the function body. * `"CubeCalculator.cube"` is a name for the test. You can call it anything but one convention is "ClassName.methodName". From 533d497ffc5c11e24f3efb5dbf67b387a4872083 Mon Sep 17 00:00:00 2001 From: Philippus Date: Sat, 16 Apr 2022 14:18:31 +0200 Subject: [PATCH 1840/3075] Drop references to Discourse comments --- _ja/tour/abstract-type-members.md | 4 ---- _ja/tour/annotations.md | 5 ----- _ja/tour/automatic-closures.md | 3 --- _ja/tour/basics.md | 5 ----- _ja/tour/by-name-parameters.md | 5 ----- _ja/tour/case-classes.md | 5 ----- _ja/tour/classes.md | 5 ----- _ja/tour/compound-types.md | 5 ----- _ja/tour/default-parameter-values.md | 5 ----- _ja/tour/extractor-objects.md | 5 ----- _ja/tour/for-comprehensions.md | 5 ----- _ja/tour/generic-classes.md | 5 ----- _ja/tour/higher-order-functions.md | 5 ----- _ja/tour/implicit-conversions.md | 5 ----- _ja/tour/implicit-parameters.md | 5 ----- _ja/tour/inner-classes.md | 5 ----- _ja/tour/lower-type-bounds.md | 5 ----- _ja/tour/mixin-class-composition.md | 5 ----- _ja/tour/multiple-parameter-lists.md | 5 ----- _ja/tour/named-arguments.md | 5 ----- _ja/tour/nested-functions.md | 5 ----- _ja/tour/operators.md | 5 ----- _ja/tour/package-objects.md | 4 ---- _ja/tour/packages-and-imports.md | 4 ---- _ja/tour/pattern-matching.md | 6 ------ _ja/tour/polymorphic-methods.md | 6 ------ _ja/tour/regular-expression-patterns.md | 6 ------ _ja/tour/self-types.md | 5 ----- _ja/tour/singleton-objects.md | 5 ----- _ja/tour/tour-of-scala.md | 6 ------ _ja/tour/traits.md | 5 ----- _ja/tour/tuples.md | 5 ----- _ja/tour/type-inference.md | 4 ---- _ja/tour/unified-types.md | 5 ----- _ja/tour/upper-type-bounds.md | 4 ---- _ja/tour/variances.md | 5 ----- _ja/tutorials/scala-for-java-programmers.md | 3 --- _overviews/scala-book/abstract-classes.md | 1 - _overviews/scala-book/anonymous-functions.md | 1 - _overviews/scala-book/arraybuffer-examples.md | 1 - _overviews/scala-book/built-in-types.md | 1 - _overviews/scala-book/case-classes.md | 1 - _overviews/scala-book/case-objects.md | 1 - _overviews/scala-book/classes-aux-constructors.md | 1 - _overviews/scala-book/classes.md | 1 - _overviews/scala-book/collections-101.md | 1 - _overviews/scala-book/collections-maps.md | 1 - _overviews/scala-book/collections-methods.md | 1 - _overviews/scala-book/command-line-io.md | 1 - _overviews/scala-book/companion-objects.md | 1 - _overviews/scala-book/concurrency-signpost.md | 1 - _overviews/scala-book/constructors-default-values.md | 1 - _overviews/scala-book/control-structures.md | 1 - _overviews/scala-book/enumerations-pizza-class.md | 1 - _overviews/scala-book/for-expressions.md | 1 - _overviews/scala-book/for-loops.md | 1 - _overviews/scala-book/functional-error-handling.md | 1 - _overviews/scala-book/functional-programming.md | 1 - _overviews/scala-book/futures.md | 1 - _overviews/scala-book/hello-world-1.md | 1 - _overviews/scala-book/hello-world-2.md | 1 - _overviews/scala-book/if-then-else-construct.md | 1 - _overviews/scala-book/list-class.md | 1 - _overviews/scala-book/map-class.md | 1 - _overviews/scala-book/match-expressions.md | 1 - _overviews/scala-book/methods-first-look.md | 1 - _overviews/scala-book/misc.md | 1 - _overviews/scala-book/no-null-values.md | 1 - _overviews/scala-book/oop-pizza-example.md | 1 - _overviews/scala-book/passing-functions-around.md | 1 - _overviews/scala-book/preliminaries.md | 1 - _overviews/scala-book/prelude-taste-of-scala.md | 1 - _overviews/scala-book/pure-functions.md | 1 - _overviews/scala-book/sbt-scalatest-bdd.md | 1 - _overviews/scala-book/sbt-scalatest-intro.md | 1 - _overviews/scala-book/sbt-scalatest-tdd.md | 1 - _overviews/scala-book/scala-build-tool-sbt.md | 1 - _overviews/scala-book/scala-features.md | 1 - _overviews/scala-book/scala-repl.md | 1 - _overviews/scala-book/set-class.md | 1 - _overviews/scala-book/traits-abstract-mixins.md | 1 - _overviews/scala-book/traits-interfaces.md | 1 - _overviews/scala-book/traits-intro.md | 1 - _overviews/scala-book/try-catch-finally.md | 1 - _overviews/scala-book/tuples.md | 1 - _overviews/scala-book/two-notes-about-strings.md | 1 - _overviews/scala-book/two-types-variables.md | 1 - _overviews/scala-book/type-is-optional.md | 1 - _overviews/scala-book/vector-class.md | 1 - _overviews/scala-book/where-next.md | 1 - _overviews/scaladoc/contribute.md | 5 ----- _overviews/scaladoc/generate.md | 5 ----- _ru/overviews/collections-2.13/arrays.md | 5 ----- .../concrete-immutable-collection-classes.md | 6 ------ .../collections-2.13/concrete-mutable-collection-classes.md | 6 ------ .../conversions-between-java-and-scala-collections.md | 6 ------ .../collections-2.13/creating-collections-from-scratch.md | 6 ------ _ru/overviews/collections-2.13/equality.md | 6 ------ _ru/overviews/collections-2.13/introduction.md | 6 ------ _ru/overviews/collections-2.13/iterators.md | 6 ------ _ru/overviews/collections-2.13/maps.md | 6 ------ _ru/overviews/collections-2.13/overview.md | 6 ------ .../collections-2.13/performance-characteristics.md | 6 ------ _ru/overviews/collections-2.13/seqs.md | 6 ------ _ru/overviews/collections-2.13/sets.md | 6 ------ _ru/overviews/collections-2.13/strings.md | 6 ------ _ru/overviews/collections-2.13/trait-iterable.md | 6 ------ _ru/overviews/collections-2.13/views.md | 6 ------ _ru/overviews/collections/introduction.md | 5 ----- _ru/overviews/parallel-collections/architecture.md | 3 --- .../parallel-collections/concrete-parallel-collections.md | 4 ---- _ru/overviews/parallel-collections/configuration.md | 4 ---- _ru/overviews/parallel-collections/conversions.md | 4 ---- _ru/overviews/parallel-collections/ctries.md | 4 ---- .../parallel-collections/custom-parallel-collections.md | 4 ---- _ru/overviews/parallel-collections/overview.md | 4 ---- _ru/overviews/parallel-collections/performance.md | 4 ---- _ru/tour/abstract-type-members.md | 4 ---- _ru/tour/annotations.md | 5 ----- _ru/tour/automatic-closures.md | 2 -- _ru/tour/basics.md | 5 ----- _ru/tour/by-name-parameters.md | 5 ----- _ru/tour/case-classes.md | 5 ----- _ru/tour/classes.md | 5 ----- _ru/tour/compound-types.md | 5 ----- _ru/tour/default-parameter-values.md | 5 ----- _ru/tour/extractor-objects.md | 5 ----- _ru/tour/for-comprehensions.md | 5 ----- _ru/tour/generic-classes.md | 5 ----- _ru/tour/higher-order-functions.md | 5 ----- _ru/tour/implicit-conversions.md | 5 ----- _ru/tour/implicit-parameters.md | 5 ----- _ru/tour/inner-classes.md | 5 ----- _ru/tour/lower-type-bounds.md | 5 ----- _ru/tour/mixin-class-composition.md | 5 ----- _ru/tour/multiple-parameter-lists.md | 5 ----- _ru/tour/named-arguments.md | 5 ----- _ru/tour/nested-functions.md | 5 ----- _ru/tour/operators.md | 5 ----- _ru/tour/package-objects.md | 4 ---- _ru/tour/packages-and-imports.md | 4 ---- _ru/tour/pattern-matching.md | 5 ----- _ru/tour/polymorphic-methods.md | 5 ----- _ru/tour/regular-expression-patterns.md | 5 ----- _ru/tour/self-types.md | 5 ----- _ru/tour/singleton-objects.md | 4 ---- _ru/tour/tour-of-scala.md | 4 ---- _ru/tour/traits.md | 5 ----- _ru/tour/tuples.md | 5 ----- _ru/tour/type-inference.md | 4 ---- _ru/tour/unified-types.md | 5 ----- _ru/tour/upper-type-bounds.md | 4 ---- _ru/tour/variances.md | 5 ----- 153 files changed, 544 deletions(-) diff --git a/_ja/tour/abstract-type-members.md b/_ja/tour/abstract-type-members.md index 2f480833bf..af08eb5c2b 100644 --- a/_ja/tour/abstract-type-members.md +++ b/_ja/tour/abstract-type-members.md @@ -2,16 +2,12 @@ layout: tour title: 抽象型メンバー language: ja - -discourse: true - partof: scala-tour num: 23 next-page: compound-types previous-page: inner-classes topics: abstract type members prerequisite-knowledge: variance, upper-type-bound - --- トレイトや抽象クラスのような抽象型は抽象型メンバーを持つことができます。 diff --git a/_ja/tour/annotations.md b/_ja/tour/annotations.md index d0fad2e82a..90545140fc 100644 --- a/_ja/tour/annotations.md +++ b/_ja/tour/annotations.md @@ -2,15 +2,10 @@ layout: tour title: アノテーション language: ja - -discourse: true - partof: scala-tour - num: 32 next-page: packages-and-imports previous-page: by-name-parameters - --- アノテーションはメタ情報と定義を関連づけます。例えば、メソッドの前のアノテーション`@deprecated`はメソッドが使われたらコンパイラに警告を出力させます。 diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md index 3b38e98178..0ba4911aa2 100644 --- a/_ja/tour/automatic-closures.md +++ b/_ja/tour/automatic-closures.md @@ -2,9 +2,6 @@ layout: tour title: 型依存クロージャの自動構築 language: ja - -discourse: true - partof: scala-tour --- diff --git a/_ja/tour/basics.md b/_ja/tour/basics.md index b2b06317bb..09c7033f3a 100644 --- a/_ja/tour/basics.md +++ b/_ja/tour/basics.md @@ -2,15 +2,10 @@ layout: tour title: 基本 language: ja - -discourse: true - partof: scala-tour - num: 2 next-page: unified-types previous-page: tour-of-scala - --- このページでは、Scalaの基本を取り扱います。 diff --git a/_ja/tour/by-name-parameters.md b/_ja/tour/by-name-parameters.md index c3494f5634..b88f6dd617 100644 --- a/_ja/tour/by-name-parameters.md +++ b/_ja/tour/by-name-parameters.md @@ -2,15 +2,10 @@ layout: tour title: 名前渡しパラメータ language: ja - -discourse: true - partof: scala-tour - num: 31 next-page: annotations previous-page: operators - --- *名前渡しのパラメータ*は使用された時に評価されます。それらは*値渡しパラメータ*とは対照的です。名前渡しのパラメータを作るには、単純に`=>`を型の前につけます。 diff --git a/_ja/tour/case-classes.md b/_ja/tour/case-classes.md index 65cce59c9b..2015b843c1 100644 --- a/_ja/tour/case-classes.md +++ b/_ja/tour/case-classes.md @@ -2,16 +2,11 @@ layout: tour title: ケースクラス language: ja - -discourse: true - partof: scala-tour - num: 11 next-page: pattern-matching previous-page: multiple-parameter-lists prerequisite-knowledge: classes, basics, mutability - --- ケースクラスはこれから論じるいくつかの差異はあるものの普通のクラスと似ています。 diff --git a/_ja/tour/classes.md b/_ja/tour/classes.md index e594b4ea37..74bd6c6997 100644 --- a/_ja/tour/classes.md +++ b/_ja/tour/classes.md @@ -2,17 +2,12 @@ layout: tour title: クラス language: ja - -discourse: true - partof: scala-tour - num: 4 next-page: traits previous-page: unified-types topics: classes prerequisite-knowledge: no-return-keyword, type-declaration-syntax, string-interpolation, procedures - --- Scalaにおけるクラスはオブジェクトを作るための設計図です。 diff --git a/_ja/tour/compound-types.md b/_ja/tour/compound-types.md index 60be4af3c3..2137ecc432 100644 --- a/_ja/tour/compound-types.md +++ b/_ja/tour/compound-types.md @@ -2,15 +2,10 @@ layout: tour title: 複合型 language: ja - -discourse: true - partof: scala-tour - num: 24 next-page: self-types previous-page: abstract-type-members - --- ときどき、あるオブジェクトの型が、複数の他の型のサブタイプであると表現する必要が生じます。 Scalaでは、これは*複合型*を用いて表現できます。複合型とはオブジェクトの型同士を重ねることです。 diff --git a/_ja/tour/default-parameter-values.md b/_ja/tour/default-parameter-values.md index 1e03cebe50..499f543566 100644 --- a/_ja/tour/default-parameter-values.md +++ b/_ja/tour/default-parameter-values.md @@ -2,16 +2,11 @@ layout: tour title: デフォルト引数 language: ja - -discourse: true - partof: scala-tour - num: 33 next-page: named-arguments previous-page: annotations prerequisite-knowledge: named-arguments, function syntax - --- Scalaはパラメータのデフォルト値を与えることができ、呼び出す側はこれらのパラメータを省略できます。 diff --git a/_ja/tour/extractor-objects.md b/_ja/tour/extractor-objects.md index ba4603a3fa..6dac1d2209 100644 --- a/_ja/tour/extractor-objects.md +++ b/_ja/tour/extractor-objects.md @@ -2,15 +2,10 @@ layout: tour title: 抽出子オブジェクト language: ja - -discourse: true - partof: scala-tour - num: 16 next-page: for-comprehensions previous-page: regular-expression-patterns - --- 抽出子オブジェクトは`unapply`メソッドを持つオブジェクトです。 diff --git a/_ja/tour/for-comprehensions.md b/_ja/tour/for-comprehensions.md index c673135b2b..1600904350 100644 --- a/_ja/tour/for-comprehensions.md +++ b/_ja/tour/for-comprehensions.md @@ -2,15 +2,10 @@ layout: tour title: for内包表記 language: ja - -discourse: true - partof: scala-tour - num: 17 next-page: generic-classes previous-page: extractor-objects - --- Scalaは*シーケンス内包表記*を表現するための軽量な記法を提供します。 diff --git a/_ja/tour/generic-classes.md b/_ja/tour/generic-classes.md index 2de82cc5ce..ad944b8b39 100644 --- a/_ja/tour/generic-classes.md +++ b/_ja/tour/generic-classes.md @@ -2,16 +2,11 @@ layout: tour title: ジェネリッククラス language: ja - -discourse: true - partof: scala-tour - num: 18 next-page: variances previous-page: for-comprehensions assumed-knowledge: classes unified-types - --- ジェネリッククラスはパラメータとして型を1つ受け取るクラスです。それらはコレクションクラスで特に役立ちます。 diff --git a/_ja/tour/higher-order-functions.md b/_ja/tour/higher-order-functions.md index 1740d1ba3d..773ca7170b 100644 --- a/_ja/tour/higher-order-functions.md +++ b/_ja/tour/higher-order-functions.md @@ -2,15 +2,10 @@ layout: tour title: 高階関数 language: ja - -discourse: true - partof: scala-tour - num: 8 next-page: nested-functions previous-page: mixin-class-composition - --- 高階関数は他の関数をパラメーターとして受け取る、もしくは結果として関数を返します。 diff --git a/_ja/tour/implicit-conversions.md b/_ja/tour/implicit-conversions.md index 8ee5a23069..d4de2375f3 100644 --- a/_ja/tour/implicit-conversions.md +++ b/_ja/tour/implicit-conversions.md @@ -2,15 +2,10 @@ layout: tour title: 暗黙の変換 language: ja - -discourse: true - partof: scala-tour - num: 27 next-page: polymorphic-methods previous-page: implicit-parameters - --- 型`S`から型`T`への暗黙の変換は`S => T`という型のimplicit値や、その型に一致するimplicitメソッドで定義されます。 diff --git a/_ja/tour/implicit-parameters.md b/_ja/tour/implicit-parameters.md index 30ff6028df..db43cd76fc 100644 --- a/_ja/tour/implicit-parameters.md +++ b/_ja/tour/implicit-parameters.md @@ -2,15 +2,10 @@ layout: tour title: 暗黙のパラメータ language: ja - -discourse: true - partof: scala-tour - num: 26 next-page: implicit-conversions previous-page: self-types - --- メソッドは _暗黙の_ パラメータのリストを持つことができ、パラメータリストの先頭には _implicit_ キーワードで印をつけます。 diff --git a/_ja/tour/inner-classes.md b/_ja/tour/inner-classes.md index 5d38b1f1f6..2bc8ecf450 100644 --- a/_ja/tour/inner-classes.md +++ b/_ja/tour/inner-classes.md @@ -2,15 +2,10 @@ layout: tour title: 内部クラス language: ja - -discourse: true - partof: scala-tour - num: 22 next-page: abstract-type-members previous-page: lower-type-bounds - --- Scalaではクラスが他のクラスをメンバーとして保持することが可能です。 diff --git a/_ja/tour/lower-type-bounds.md b/_ja/tour/lower-type-bounds.md index 62a15447d3..e72a3773f8 100644 --- a/_ja/tour/lower-type-bounds.md +++ b/_ja/tour/lower-type-bounds.md @@ -2,16 +2,11 @@ layout: tour title: 下限型境界 language: ja - -discourse: true - partof: scala-tour - num: 21 next-page: inner-classes previous-page: upper-type-bounds prerequisite-knowledge: upper-type-bounds, generics, variance - --- [上限型境界](upper-type-bounds.html) は型を別の型のサブタイプに制限しますが、*下限型境界*は型が別の型のスーパータイプであることを宣言します。表現`B >: A`はパラメータ`B`または抽象型`B`が型`A`のスーパータイプであることを表します。ほとんどのケースで`A`はそのクラスの型パラメータであり、`B`はメソッドの型パラメータになります。 diff --git a/_ja/tour/mixin-class-composition.md b/_ja/tour/mixin-class-composition.md index 8b4e26067e..f95ab54cb9 100644 --- a/_ja/tour/mixin-class-composition.md +++ b/_ja/tour/mixin-class-composition.md @@ -2,16 +2,11 @@ layout: tour title: ミックスインを用いたクラス合成 language: ja - -discourse: true - partof: scala-tour - num: 7 next-page: higher-order-functions previous-page: tuples prerequisite-knowledge: inheritance, traits, abstract-classes, unified-types - --- ミックスインはクラスを構成するのに使われるトレイトです。 diff --git a/_ja/tour/multiple-parameter-lists.md b/_ja/tour/multiple-parameter-lists.md index ff267531b8..c9b70ec998 100644 --- a/_ja/tour/multiple-parameter-lists.md +++ b/_ja/tour/multiple-parameter-lists.md @@ -2,15 +2,10 @@ layout: tour title: 複数パラメータリスト(カリー化) language: ja - -discourse: true - partof: scala-tour - num: 10 next-page: case-classes previous-page: nested-functions - --- メソッドは複数のパラメータリストを持てます。 diff --git a/_ja/tour/named-arguments.md b/_ja/tour/named-arguments.md index 8ce70335a9..88bc231fda 100644 --- a/_ja/tour/named-arguments.md +++ b/_ja/tour/named-arguments.md @@ -2,16 +2,11 @@ layout: tour title: 名前付き引数 language: ja - -discourse: true - partof: scala-tour - num: 34 next-page: packages-and-imports previous-page: default-parameter-values prerequisite-knowledge: function-syntax - --- メソッドを呼ぶ時、以下のように引数にパラメータ名でラベル付が可能です。 diff --git a/_ja/tour/nested-functions.md b/_ja/tour/nested-functions.md index 9701e421cc..9fa581bc3e 100644 --- a/_ja/tour/nested-functions.md +++ b/_ja/tour/nested-functions.md @@ -2,15 +2,10 @@ layout: tour title: ネストしたメソッド language: ja - -discourse: true - partof: scala-tour - num: 9 next-page: multiple-parameter-lists previous-page: higher-order-functions - --- Scalaではメソッドの定義をネストする（_訳注：入れ子にする_）ことができます。 diff --git a/_ja/tour/operators.md b/_ja/tour/operators.md index 7df5800aa1..398790b4e0 100644 --- a/_ja/tour/operators.md +++ b/_ja/tour/operators.md @@ -2,16 +2,11 @@ layout: tour title: 演算子 language: ja - -discourse: true - partof: scala-tour - num: 30 next-page: by-name-parameters previous-page: type-inference prerequisite-knowledge: case-classes - --- Scalaでは演算子はメソッドです。パラメータを1つだけ持つメソッドであれば*中置演算子*として使えます。例えば、`+`はドット記法で呼び出せます。 diff --git a/_ja/tour/package-objects.md b/_ja/tour/package-objects.md index 755935d3ef..f2ed9b1d89 100644 --- a/_ja/tour/package-objects.md +++ b/_ja/tour/package-objects.md @@ -2,11 +2,7 @@ layout: tour title: パッケージオブジェクト language: ja - -discourse: true - partof: scala-tour - num: 36 previous-page: packages-and-imports --- diff --git a/_ja/tour/packages-and-imports.md b/_ja/tour/packages-and-imports.md index 8e44239b05..4e94731644 100644 --- a/_ja/tour/packages-and-imports.md +++ b/_ja/tour/packages-and-imports.md @@ -2,11 +2,7 @@ layout: tour title: パッケージとインポート language: ja - -discourse: true - partof: scala-tour - num: 35 previous-page: named-arguments next-page: package-objects diff --git a/_ja/tour/pattern-matching.md b/_ja/tour/pattern-matching.md index 9e1f5d9692..23c997ca91 100644 --- a/_ja/tour/pattern-matching.md +++ b/_ja/tour/pattern-matching.md @@ -2,17 +2,11 @@ layout: tour title: パターンマッチング language: ja - -discourse: true - partof: scala-tour - num: 12 - next-page: singleton-objects previous-page: case-classes prerequisite-knowledge: case-classes, string-interpolation, subtyping - --- パターンマッチングは値をパターンに照合するための仕組みです。 diff --git a/_ja/tour/polymorphic-methods.md b/_ja/tour/polymorphic-methods.md index 6143ef2612..4bab5f63bd 100644 --- a/_ja/tour/polymorphic-methods.md +++ b/_ja/tour/polymorphic-methods.md @@ -2,17 +2,11 @@ layout: tour title: ポリモーフィックメソッド language: ja - -discourse: true - partof: scala-tour - num: 28 - next-page: type-inference previous-page: implicit-conversions prerequisite-knowledge: unified-types - --- Scalaのメソッドは値と同様に型によってパラメータ化することができます。構文はジェネリッククラスの構文と似ています。 diff --git a/_ja/tour/regular-expression-patterns.md b/_ja/tour/regular-expression-patterns.md index 05882529c0..79cf565c9f 100644 --- a/_ja/tour/regular-expression-patterns.md +++ b/_ja/tour/regular-expression-patterns.md @@ -2,16 +2,10 @@ layout: tour title: 正規表現パターン language: ja - -discourse: true - partof: scala-tour - num: 15 - next-page: extractor-objects previous-page: singleton-objects - --- 正規表現はデータの中からパターン（またはその欠如）を探すために使うことができる文字列です。 どんな文字列も`.r`メソッドを使うことで、正規表現に変換できます。 diff --git a/_ja/tour/self-types.md b/_ja/tour/self-types.md index cb585dc09e..7ffa6745ec 100644 --- a/_ja/tour/self-types.md +++ b/_ja/tour/self-types.md @@ -2,17 +2,12 @@ layout: tour title: 自分型 language: ja - -discourse: true - partof: scala-tour - num: 25 next-page: implicit-parameters previous-page: compound-types topics: self-types prerequisite-knowledge: nested-classes, mixin-class-composition - --- 自分型は、直接継承していなくてもトレイトが他のトレイトにミックスインされていることを宣言する方法です。 これにより依存先のメンバーをimportなしで利用できます。 diff --git a/_ja/tour/singleton-objects.md b/_ja/tour/singleton-objects.md index 69ce1aeede..0414291909 100644 --- a/_ja/tour/singleton-objects.md +++ b/_ja/tour/singleton-objects.md @@ -2,13 +2,8 @@ layout: tour title: シングルトンオブジェクト language: ja - -discourse: true - partof: scala-tour - num: 13 - next-page: regular-expression-patterns previous-page: pattern-matching prerequisite-knowledge: classes, methods, private-methods, packages, option diff --git a/_ja/tour/tour-of-scala.md b/_ja/tour/tour-of-scala.md index ff2d026686..9e5d2b9860 100644 --- a/_ja/tour/tour-of-scala.md +++ b/_ja/tour/tour-of-scala.md @@ -2,15 +2,9 @@ layout: tour title: 前書き language: ja - -discourse: true - partof: scala-tour - num: 1 - next-page: basics - --- ## ようこそツアーへ diff --git a/_ja/tour/traits.md b/_ja/tour/traits.md index 81b7dc7046..1738b0fc0d 100644 --- a/_ja/tour/traits.md +++ b/_ja/tour/traits.md @@ -2,17 +2,12 @@ layout: tour title: トレイト language: ja - -discourse: true - partof: scala-tour - num: 5 next-page: tuples previous-page: classes topics: traits prerequisite-knowledge: expressions, classes, generics, objects, companion-objects - --- トレイトはクラス間でインターフェースとフィールドを共有するために使います。それらはJava 8のインターフェースと似ています。 diff --git a/_ja/tour/tuples.md b/_ja/tour/tuples.md index 7729138914..e3c2f1e0f7 100644 --- a/_ja/tour/tuples.md +++ b/_ja/tour/tuples.md @@ -2,16 +2,11 @@ layout: tour title: タプル language: ja - -discourse: true - partof: scala-tour - num: 6 next-page: mixin-class-composition previous-page: traits topics: tuples - --- Scalaではタプルは決まった数の要素を含む値であり、各要素はそれぞれの型を持ちます。 diff --git a/_ja/tour/type-inference.md b/_ja/tour/type-inference.md index 2db0e440b9..5973da20a2 100644 --- a/_ja/tour/type-inference.md +++ b/_ja/tour/type-inference.md @@ -2,11 +2,7 @@ layout: tour title: 型推論 language: ja - -discourse: true - partof: scala-tour - num: 29 next-page: operators previous-page: polymorphic-methods diff --git a/_ja/tour/unified-types.md b/_ja/tour/unified-types.md index 8f9710b62a..a12895c677 100644 --- a/_ja/tour/unified-types.md +++ b/_ja/tour/unified-types.md @@ -2,16 +2,11 @@ layout: tour title: 統合された型 language: ja - -discourse: true - partof: scala-tour - num: 3 next-page: classes previous-page: basics prerequisite-knowledge: classes, basics - --- Scalaでは数値や関数を含め、全ての値は型を持ちます。 以下の図は型階層の一部を説明しています。 diff --git a/_ja/tour/upper-type-bounds.md b/_ja/tour/upper-type-bounds.md index 7d8ac4df9a..8dfe6ca8ac 100644 --- a/_ja/tour/upper-type-bounds.md +++ b/_ja/tour/upper-type-bounds.md @@ -2,15 +2,11 @@ layout: tour title: 上限型境界 language: ja - -discourse: true - partof: scala-tour categories: tour num: 20 next-page: lower-type-bounds previous-page: variances - --- Scalaでは [型パラメータ](generic-classes.html)と[抽象型メンバー](abstract-type-members.html) は型境界による制約をかけることができます。 diff --git a/_ja/tour/variances.md b/_ja/tour/variances.md index c7eb10304e..314f8c2e48 100644 --- a/_ja/tour/variances.md +++ b/_ja/tour/variances.md @@ -2,15 +2,10 @@ layout: tour title: 変位指定 language: ja - -discourse: true - partof: scala-tour - num: 19 next-page: upper-type-bounds previous-page: generic-classes - --- 変位指定は複合型の間の継承関係とそれらの型パラメータ間の継承関係の相関です。 diff --git a/_ja/tutorials/scala-for-java-programmers.md b/_ja/tutorials/scala-for-java-programmers.md index b49113ff72..a2076100b1 100644 --- a/_ja/tutorials/scala-for-java-programmers.md +++ b/_ja/tutorials/scala-for-java-programmers.md @@ -1,10 +1,7 @@ --- layout: singlepage-overview title: JavaプログラマーのためのScalaチュートリアル - partof: scala-for-java-programmers - -discourse: false language: ja --- diff --git a/_overviews/scala-book/abstract-classes.md b/_overviews/scala-book/abstract-classes.md index a5ec3b96fa..ed8dc3b147 100644 --- a/_overviews/scala-book/abstract-classes.md +++ b/_overviews/scala-book/abstract-classes.md @@ -5,7 +5,6 @@ title: Abstract Classes description: This page shows how to use abstract classes, including when and why you should use abstract classes. partof: scala_book overview-name: Scala Book -discourse: true num: 27 outof: 54 previous-page: traits-abstract-mixins diff --git a/_overviews/scala-book/anonymous-functions.md b/_overviews/scala-book/anonymous-functions.md index bbd7bc8d8d..de9c9ebd14 100644 --- a/_overviews/scala-book/anonymous-functions.md +++ b/_overviews/scala-book/anonymous-functions.md @@ -5,7 +5,6 @@ title: Anonymous Functions description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. partof: scala_book overview-name: Scala Book -discourse: true num: 34 outof: 54 previous-page: set-class diff --git a/_overviews/scala-book/arraybuffer-examples.md b/_overviews/scala-book/arraybuffer-examples.md index 8d4dd8ef53..1f0206e58f 100644 --- a/_overviews/scala-book/arraybuffer-examples.md +++ b/_overviews/scala-book/arraybuffer-examples.md @@ -5,7 +5,6 @@ title: The ArrayBuffer Class description: This page provides examples of how to use the Scala ArrayBuffer class, including adding and removing elements. partof: scala_book overview-name: Scala Book -discourse: true num: 29 outof: 54 previous-page: collections-101 diff --git a/_overviews/scala-book/built-in-types.md b/_overviews/scala-book/built-in-types.md index 209b1b8f0b..1567d13970 100644 --- a/_overviews/scala-book/built-in-types.md +++ b/_overviews/scala-book/built-in-types.md @@ -5,7 +5,6 @@ title: A Few Built-In Types description: A brief introduction to Scala's built-in types. partof: scala_book overview-name: Scala Book -discourse: true num: 10 outof: 54 previous-page: type-is-optional diff --git a/_overviews/scala-book/case-classes.md b/_overviews/scala-book/case-classes.md index 8722d4c5ae..33db4a9a7f 100644 --- a/_overviews/scala-book/case-classes.md +++ b/_overviews/scala-book/case-classes.md @@ -5,7 +5,6 @@ title: Case Classes description: This lesson provides an introduction to 'case classes' in Scala. partof: scala_book overview-name: Scala Book -discourse: true num: 49 outof: 54 previous-page: companion-objects diff --git a/_overviews/scala-book/case-objects.md b/_overviews/scala-book/case-objects.md index 1b7426f12a..ca6a5f155a 100644 --- a/_overviews/scala-book/case-objects.md +++ b/_overviews/scala-book/case-objects.md @@ -5,7 +5,6 @@ title: Case Objects description: This lesson introduces Scala 'case objects', which are used to create singletons with a few additional features. partof: scala_book overview-name: Scala Book -discourse: true num: 50 outof: 54 previous-page: case-classes diff --git a/_overviews/scala-book/classes-aux-constructors.md b/_overviews/scala-book/classes-aux-constructors.md index a66a4b4d80..d3af412a53 100644 --- a/_overviews/scala-book/classes-aux-constructors.md +++ b/_overviews/scala-book/classes-aux-constructors.md @@ -5,7 +5,6 @@ title: Auxiliary Class Constructors description: This page shows how to write auxiliary Scala class constructors, including several examples of the syntax. partof: scala_book overview-name: Scala Book -discourse: true num: 20 outof: 54 previous-page: classes diff --git a/_overviews/scala-book/classes.md b/_overviews/scala-book/classes.md index bc4fe65b66..c4861bc7c2 100644 --- a/_overviews/scala-book/classes.md +++ b/_overviews/scala-book/classes.md @@ -5,7 +5,6 @@ title: Scala Classes description: This page shows examples of how to create Scala classes, including the basic Scala class constructor. partof: scala_book overview-name: Scala Book -discourse: true num: 19 outof: 54 previous-page: try-catch-finally diff --git a/_overviews/scala-book/collections-101.md b/_overviews/scala-book/collections-101.md index 6df136b528..b98a72d116 100644 --- a/_overviews/scala-book/collections-101.md +++ b/_overviews/scala-book/collections-101.md @@ -5,7 +5,6 @@ title: Scala Collections description: This page provides an introduction to the Scala collections classes, including Vector, List, ArrayBuffer, Map, Set, and more. partof: scala_book overview-name: Scala Book -discourse: true num: 28 outof: 54 previous-page: abstract-classes diff --git a/_overviews/scala-book/collections-maps.md b/_overviews/scala-book/collections-maps.md index 95e890bbc3..84a9f065c4 100644 --- a/_overviews/scala-book/collections-maps.md +++ b/_overviews/scala-book/collections-maps.md @@ -5,7 +5,6 @@ title: Common Map Methods description: This page shows examples of the most common methods that are available on Scala Maps. partof: scala_book overview-name: Scala Book -discourse: true num: 36 outof: 54 previous-page: collections-methods diff --git a/_overviews/scala-book/collections-methods.md b/_overviews/scala-book/collections-methods.md index 7bd8d9a15a..e888179940 100644 --- a/_overviews/scala-book/collections-methods.md +++ b/_overviews/scala-book/collections-methods.md @@ -5,7 +5,6 @@ title: Common Sequence Methods description: This page shows examples of the most common methods that are available on the Scala sequences (collections classes). partof: scala_book overview-name: Scala Book -discourse: true num: 35 outof: 54 previous-page: anonymous-functions diff --git a/_overviews/scala-book/command-line-io.md b/_overviews/scala-book/command-line-io.md index ffb35f698e..14bf2901af 100644 --- a/_overviews/scala-book/command-line-io.md +++ b/_overviews/scala-book/command-line-io.md @@ -5,7 +5,6 @@ title: Command-Line I/O description: An introduction to command-line I/O in Scala. partof: scala_book overview-name: Scala Book -discourse: true num: 12 outof: 54 previous-page: two-notes-about-strings diff --git a/_overviews/scala-book/companion-objects.md b/_overviews/scala-book/companion-objects.md index 6babb21eb9..f024a8a2d5 100644 --- a/_overviews/scala-book/companion-objects.md +++ b/_overviews/scala-book/companion-objects.md @@ -5,7 +5,6 @@ title: Companion Objects description: This lesson provides an introduction to 'companion objects' in Scala, including writing 'apply' and 'unapply' methods. partof: scala_book overview-name: Scala Book -discourse: true num: 48 outof: 54 previous-page: no-null-values diff --git a/_overviews/scala-book/concurrency-signpost.md b/_overviews/scala-book/concurrency-signpost.md index 1629700299..d3435c4ede 100644 --- a/_overviews/scala-book/concurrency-signpost.md +++ b/_overviews/scala-book/concurrency-signpost.md @@ -5,7 +5,6 @@ title: Concurrency description: An introduction to concurrency in Scala. partof: scala_book overview-name: Scala Book -discourse: true num: 52 outof: 54 previous-page: functional-error-handling diff --git a/_overviews/scala-book/constructors-default-values.md b/_overviews/scala-book/constructors-default-values.md index aa4429305e..b54da93584 100644 --- a/_overviews/scala-book/constructors-default-values.md +++ b/_overviews/scala-book/constructors-default-values.md @@ -5,7 +5,6 @@ title: Supplying Default Values for Constructor Parameters description: This page shows how to provide default values for Scala constructor parameters, with several examples. partof: scala_book overview-name: Scala Book -discourse: true num: 21 outof: 54 previous-page: classes-aux-constructors diff --git a/_overviews/scala-book/control-structures.md b/_overviews/scala-book/control-structures.md index 813a05face..9d21b18eb3 100644 --- a/_overviews/scala-book/control-structures.md +++ b/_overviews/scala-book/control-structures.md @@ -5,7 +5,6 @@ title: Control Structures description: This page provides an introduction to Scala's control structures, including if/then/else, for loops, try/catch/finally, etc. partof: scala_book overview-name: Scala Book -discourse: true num: 13 outof: 54 previous-page: command-line-io diff --git a/_overviews/scala-book/enumerations-pizza-class.md b/_overviews/scala-book/enumerations-pizza-class.md index 31625129f0..d4052378bb 100644 --- a/_overviews/scala-book/enumerations-pizza-class.md +++ b/_overviews/scala-book/enumerations-pizza-class.md @@ -5,7 +5,6 @@ title: Enumerations (and a Complete Pizza Class) description: This page introduces Scala enumerations, and further shows how to create a complete OOP 'Pizza' class that uses those enumerations. partof: scala_book overview-name: Scala Book -discourse: true num: 23 outof: 54 previous-page: methods-first-look diff --git a/_overviews/scala-book/for-expressions.md b/_overviews/scala-book/for-expressions.md index 7977777872..4cd666ef42 100644 --- a/_overviews/scala-book/for-expressions.md +++ b/_overviews/scala-book/for-expressions.md @@ -5,7 +5,6 @@ title: for Expressions description: This page shows how to use Scala 'for' expressions (also known as 'for-expressions'), including examples of how to use it with the 'yield' keyword. partof: scala_book overview-name: Scala Book -discourse: true num: 16 outof: 54 previous-page: for-loops diff --git a/_overviews/scala-book/for-loops.md b/_overviews/scala-book/for-loops.md index 5eef6cc279..ef382270f2 100644 --- a/_overviews/scala-book/for-loops.md +++ b/_overviews/scala-book/for-loops.md @@ -5,7 +5,6 @@ title: for Loops description: This page provides an introduction to the Scala 'for' loop, including how to iterate over Scala collections. partof: scala_book overview-name: Scala Book -discourse: true num: 15 outof: 54 previous-page: if-then-else-construct diff --git a/_overviews/scala-book/functional-error-handling.md b/_overviews/scala-book/functional-error-handling.md index 00a448ccc0..8e779a2bc2 100644 --- a/_overviews/scala-book/functional-error-handling.md +++ b/_overviews/scala-book/functional-error-handling.md @@ -5,7 +5,6 @@ title: Functional Error Handling in Scala description: This lesson takes a look at error handling with functional programming in Scala. partof: scala_book overview-name: Scala Book -discourse: true num: 51 outof: 54 previous-page: case-objects diff --git a/_overviews/scala-book/functional-programming.md b/_overviews/scala-book/functional-programming.md index aa0581cf87..dee9cc4533 100644 --- a/_overviews/scala-book/functional-programming.md +++ b/_overviews/scala-book/functional-programming.md @@ -5,7 +5,6 @@ title: Functional Programming description: This lesson begins a second on 'An introduction to functional programming in Scala'. partof: scala_book overview-name: Scala Book -discourse: true num: 44 outof: 54 previous-page: sbt-scalatest-bdd diff --git a/_overviews/scala-book/futures.md b/_overviews/scala-book/futures.md index 9324b0ddf9..e585ff2819 100644 --- a/_overviews/scala-book/futures.md +++ b/_overviews/scala-book/futures.md @@ -5,7 +5,6 @@ title: Scala Futures description: This page provides an introduction to Futures in Scala, including Future callback methods. partof: scala_book overview-name: Scala Book -discourse: true num: 53 outof: 54 previous-page: concurrency-signpost diff --git a/_overviews/scala-book/hello-world-1.md b/_overviews/scala-book/hello-world-1.md index c9793a2376..28aa21f19b 100644 --- a/_overviews/scala-book/hello-world-1.md +++ b/_overviews/scala-book/hello-world-1.md @@ -5,7 +5,6 @@ title: Hello, World description: This page shares a Scala 'Hello, world' example. partof: scala_book overview-name: Scala Book -discourse: true num: 5 outof: 54 previous-page: scala-features diff --git a/_overviews/scala-book/hello-world-2.md b/_overviews/scala-book/hello-world-2.md index d07b7da00f..76d1bf053c 100644 --- a/_overviews/scala-book/hello-world-2.md +++ b/_overviews/scala-book/hello-world-2.md @@ -5,7 +5,6 @@ title: Hello, World - Version 2 description: This is a second Scala 'Hello, World' example. partof: scala_book overview-name: Scala Book -discourse: true num: 6 outof: 54 previous-page: hello-world-1 diff --git a/_overviews/scala-book/if-then-else-construct.md b/_overviews/scala-book/if-then-else-construct.md index 6fd09ef879..bd720f758a 100644 --- a/_overviews/scala-book/if-then-else-construct.md +++ b/_overviews/scala-book/if-then-else-construct.md @@ -5,7 +5,6 @@ title: The if/then/else Construct description: This page demonstrates Scala's if/then/else construct, including several examples you can try in the REPL. partof: scala_book overview-name: Scala Book -discourse: true num: 14 outof: 54 previous-page: control-structures diff --git a/_overviews/scala-book/list-class.md b/_overviews/scala-book/list-class.md index 1a606afc98..0e4e324e89 100644 --- a/_overviews/scala-book/list-class.md +++ b/_overviews/scala-book/list-class.md @@ -5,7 +5,6 @@ title: The List Class description: This page provides examples of the Scala List class, including how to add and remove elements from a List. partof: scala_book overview-name: Scala Book -discourse: true num: 30 outof: 54 previous-page: arraybuffer-examples diff --git a/_overviews/scala-book/map-class.md b/_overviews/scala-book/map-class.md index 4a7d48db98..34f0824fae 100644 --- a/_overviews/scala-book/map-class.md +++ b/_overviews/scala-book/map-class.md @@ -5,7 +5,6 @@ title: The Map Class description: This page provides examples of the Scala 'Map' class, including how to add and remove elements from a Map, and iterate over Map elements. partof: scala_book overview-name: Scala Book -discourse: true num: 32 outof: 54 previous-page: vector-class diff --git a/_overviews/scala-book/match-expressions.md b/_overviews/scala-book/match-expressions.md index 4b54dfb35c..60cc0d92ae 100644 --- a/_overviews/scala-book/match-expressions.md +++ b/_overviews/scala-book/match-expressions.md @@ -5,7 +5,6 @@ title: match Expressions description: This page shows examples of the Scala 'match' expression, including how to write match/case expressions. partof: scala_book overview-name: Scala Book -discourse: true num: 17 outof: 54 previous-page: for-expressions diff --git a/_overviews/scala-book/methods-first-look.md b/_overviews/scala-book/methods-first-look.md index 7e10bdfd77..348c66f56f 100644 --- a/_overviews/scala-book/methods-first-look.md +++ b/_overviews/scala-book/methods-first-look.md @@ -5,7 +5,6 @@ title: A First Look at Scala Methods description: This page provides a first look at how to write Scala methods, including how to test them in the REPL. partof: scala_book overview-name: Scala Book -discourse: true num: 22 outof: 54 previous-page: constructors-default-values diff --git a/_overviews/scala-book/misc.md b/_overviews/scala-book/misc.md index 61c19bd1b2..07f511305c 100644 --- a/_overviews/scala-book/misc.md +++ b/_overviews/scala-book/misc.md @@ -5,7 +5,6 @@ title: A Few Miscellaneous Items description: A few miscellaneous items about Scala partof: scala_book overview-name: Scala Book -discourse: true num: 37 outof: 54 previous-page: collections-maps diff --git a/_overviews/scala-book/no-null-values.md b/_overviews/scala-book/no-null-values.md index 757fc62670..194348c246 100644 --- a/_overviews/scala-book/no-null-values.md +++ b/_overviews/scala-book/no-null-values.md @@ -5,7 +5,6 @@ title: No Null Values description: This lesson demonstrates the Scala Option, Some, and None classes, including how to use them instead of null values. partof: scala_book overview-name: Scala Book -discourse: true num: 47 outof: 54 previous-page: passing-functions-around diff --git a/_overviews/scala-book/oop-pizza-example.md b/_overviews/scala-book/oop-pizza-example.md index 7d50686e71..c70df45e3f 100644 --- a/_overviews/scala-book/oop-pizza-example.md +++ b/_overviews/scala-book/oop-pizza-example.md @@ -5,7 +5,6 @@ title: An OOP Example description: This lesson shares an example of some OOP-style classes for a pizza restaurant order entry system, including Pizza, Topping, and Order classes. partof: scala_book overview-name: Scala Book -discourse: true num: 39 outof: 54 previous-page: tuples diff --git a/_overviews/scala-book/passing-functions-around.md b/_overviews/scala-book/passing-functions-around.md index 2700ea06c7..80c6cd2f2b 100644 --- a/_overviews/scala-book/passing-functions-around.md +++ b/_overviews/scala-book/passing-functions-around.md @@ -5,7 +5,6 @@ title: Passing Functions Around description: Like a good functional programming language, Scala lets you use functions just like other variables, including passing them into other functions. partof: scala_book overview-name: Scala Book -discourse: true num: 46 outof: 54 previous-page: pure-functions diff --git a/_overviews/scala-book/preliminaries.md b/_overviews/scala-book/preliminaries.md index e8057e37d9..ac3af5ea33 100644 --- a/_overviews/scala-book/preliminaries.md +++ b/_overviews/scala-book/preliminaries.md @@ -5,7 +5,6 @@ title: Preliminaries description: A few things to know about getting started with Scala. partof: scala_book overview-name: Scala Book -discourse: true num: 3 outof: 54 previous-page: prelude-taste-of-scala diff --git a/_overviews/scala-book/prelude-taste-of-scala.md b/_overviews/scala-book/prelude-taste-of-scala.md index 1317561825..aba0111219 100644 --- a/_overviews/scala-book/prelude-taste-of-scala.md +++ b/_overviews/scala-book/prelude-taste-of-scala.md @@ -5,7 +5,6 @@ title: Prelude꞉ A Taste of Scala description: This page shares a Taste Of Scala example, quickly covering Scala's main features. partof: scala_book overview-name: Scala Book -discourse: true num: 2 outof: 54 previous-page: introduction diff --git a/_overviews/scala-book/pure-functions.md b/_overviews/scala-book/pure-functions.md index 97c6ef6fb9..5bbb4f50c2 100644 --- a/_overviews/scala-book/pure-functions.md +++ b/_overviews/scala-book/pure-functions.md @@ -5,7 +5,6 @@ title: Pure Functions description: This lesson provides an introduction to writing pure functions in Scala. partof: scala_book overview-name: Scala Book -discourse: true num: 45 outof: 54 previous-page: functional-programming diff --git a/_overviews/scala-book/sbt-scalatest-bdd.md b/_overviews/scala-book/sbt-scalatest-bdd.md index ee20a8490e..6bb134abdb 100644 --- a/_overviews/scala-book/sbt-scalatest-bdd.md +++ b/_overviews/scala-book/sbt-scalatest-bdd.md @@ -5,7 +5,6 @@ title: Writing BDD Style Tests with ScalaTest and sbt description: This lesson shows how to write ScalaTest unit tests with sbt in a behavior-driven development (TDD) style. partof: scala_book overview-name: Scala Book -discourse: true num: 43 outof: 54 previous-page: sbt-scalatest-tdd diff --git a/_overviews/scala-book/sbt-scalatest-intro.md b/_overviews/scala-book/sbt-scalatest-intro.md index bf40ba8c6c..e7f8d20bed 100644 --- a/_overviews/scala-book/sbt-scalatest-intro.md +++ b/_overviews/scala-book/sbt-scalatest-intro.md @@ -5,7 +5,6 @@ title: sbt and ScalaTest description: In this lesson we'll start to introduce sbt and ScalaTest, two tools commonly used on Scala projects. partof: scala_book overview-name: Scala Book -discourse: true num: 40 outof: 54 previous-page: oop-pizza-example diff --git a/_overviews/scala-book/sbt-scalatest-tdd.md b/_overviews/scala-book/sbt-scalatest-tdd.md index 7214566a09..724d9c1728 100644 --- a/_overviews/scala-book/sbt-scalatest-tdd.md +++ b/_overviews/scala-book/sbt-scalatest-tdd.md @@ -5,7 +5,6 @@ title: Using ScalaTest with sbt description: This lesson shows how to write ScalaTest unit tests with sbt in a test-driven development (TDD) style. partof: scala_book overview-name: Scala Book -discourse: true num: 42 outof: 54 previous-page: scala-build-tool-sbt diff --git a/_overviews/scala-book/scala-build-tool-sbt.md b/_overviews/scala-book/scala-build-tool-sbt.md index 8986433976..aefb28ecea 100644 --- a/_overviews/scala-book/scala-build-tool-sbt.md +++ b/_overviews/scala-book/scala-build-tool-sbt.md @@ -5,7 +5,6 @@ title: The most used scala build tool (sbt) description: This page provides an introduction to the Scala Build Tool, sbt, including a simple 'Hello, world' project. partof: scala_book overview-name: Scala Book -discourse: true num: 41 outof: 54 previous-page: sbt-scalatest-intro diff --git a/_overviews/scala-book/scala-features.md b/_overviews/scala-book/scala-features.md index eee55bd089..c7d7387d4a 100644 --- a/_overviews/scala-book/scala-features.md +++ b/_overviews/scala-book/scala-features.md @@ -5,7 +5,6 @@ title: Scala Features description: TODO partof: scala_book overview-name: Scala Book -discourse: true num: 4 outof: 54 previous-page: preliminaries diff --git a/_overviews/scala-book/scala-repl.md b/_overviews/scala-book/scala-repl.md index c1ced1f219..062ca12b7f 100644 --- a/_overviews/scala-book/scala-repl.md +++ b/_overviews/scala-book/scala-repl.md @@ -5,7 +5,6 @@ title: The Scala REPL description: This page shares an introduction to the Scala REPL. partof: scala_book overview-name: Scala Book -discourse: true num: 7 outof: 54 previous-page: hello-world-2 diff --git a/_overviews/scala-book/set-class.md b/_overviews/scala-book/set-class.md index 55fefb31d0..dc69cb2ae4 100644 --- a/_overviews/scala-book/set-class.md +++ b/_overviews/scala-book/set-class.md @@ -5,7 +5,6 @@ title: The Set Class description: This page provides examples of the Scala 'Set' class, including how to add and remove elements from a Set, and iterate over Set elements. partof: scala_book overview-name: Scala Book -discourse: true num: 33 outof: 54 previous-page: map-class diff --git a/_overviews/scala-book/traits-abstract-mixins.md b/_overviews/scala-book/traits-abstract-mixins.md index eeecb67aee..db3ab56d63 100644 --- a/_overviews/scala-book/traits-abstract-mixins.md +++ b/_overviews/scala-book/traits-abstract-mixins.md @@ -5,7 +5,6 @@ title: Using Scala Traits Like Abstract Classes description: This page shows how to use Scala traits just like abstract classes in Java, with examples of concrete and abstract methods. partof: scala_book overview-name: Scala Book -discourse: true num: 26 outof: 54 previous-page: traits-interfaces diff --git a/_overviews/scala-book/traits-interfaces.md b/_overviews/scala-book/traits-interfaces.md index a10ed18a61..f422f158bc 100644 --- a/_overviews/scala-book/traits-interfaces.md +++ b/_overviews/scala-book/traits-interfaces.md @@ -5,7 +5,6 @@ title: Using Scala Traits as Interfaces description: This page shows how to use Scala traits just like Java interfaces, including several examples. partof: scala_book overview-name: Scala Book -discourse: true num: 25 outof: 54 previous-page: traits-intro diff --git a/_overviews/scala-book/traits-intro.md b/_overviews/scala-book/traits-intro.md index a6d1db0f26..75656b4a64 100644 --- a/_overviews/scala-book/traits-intro.md +++ b/_overviews/scala-book/traits-intro.md @@ -5,7 +5,6 @@ title: Scala Traits and Abstract Classes description: An introduction to Scala traits and abstract classes. partof: scala_book overview-name: Scala Book -discourse: true num: 24 outof: 54 previous-page: enumerations-pizza-class diff --git a/_overviews/scala-book/try-catch-finally.md b/_overviews/scala-book/try-catch-finally.md index 5dee7890a4..607bf3fc0b 100644 --- a/_overviews/scala-book/try-catch-finally.md +++ b/_overviews/scala-book/try-catch-finally.md @@ -5,7 +5,6 @@ title: try/catch/finally Expressions description: This page shows how to use Scala's try/catch/finally construct, including several complete examples. partof: scala_book overview-name: Scala Book -discourse: true num: 18 outof: 54 previous-page: match-expressions diff --git a/_overviews/scala-book/tuples.md b/_overviews/scala-book/tuples.md index c2eb8e4225..568037274b 100644 --- a/_overviews/scala-book/tuples.md +++ b/_overviews/scala-book/tuples.md @@ -5,7 +5,6 @@ title: Tuples description: This page is an introduction to the Scala 'tuple' data type, showing examples of how to use tuples in your Scala code. partof: scala_book overview-name: Scala Book -discourse: true num: 38 outof: 54 previous-page: misc diff --git a/_overviews/scala-book/two-notes-about-strings.md b/_overviews/scala-book/two-notes-about-strings.md index fdcbd7a29a..dea6f3e643 100644 --- a/_overviews/scala-book/two-notes-about-strings.md +++ b/_overviews/scala-book/two-notes-about-strings.md @@ -5,7 +5,6 @@ title: Two Notes About Strings description: This page shares two important notes about strings in Scala. partof: scala_book overview-name: Scala Book -discourse: true num: 11 outof: 54 previous-page: built-in-types diff --git a/_overviews/scala-book/two-types-variables.md b/_overviews/scala-book/two-types-variables.md index 678c89dc3d..f369c66a87 100644 --- a/_overviews/scala-book/two-types-variables.md +++ b/_overviews/scala-book/two-types-variables.md @@ -5,7 +5,6 @@ title: Two Types of Variables description: Scala has two types of variables, val and var. partof: scala_book overview-name: Scala Book -discourse: true num: 8 outof: 54 previous-page: scala-repl diff --git a/_overviews/scala-book/type-is-optional.md b/_overviews/scala-book/type-is-optional.md index 3b21654433..0d8b0a1c93 100644 --- a/_overviews/scala-book/type-is-optional.md +++ b/_overviews/scala-book/type-is-optional.md @@ -5,7 +5,6 @@ title: The Type is Optional description: A note about explicit and implicit data type declarations in Scala. partof: scala_book overview-name: Scala Book -discourse: true num: 9 outof: 54 previous-page: two-types-variables diff --git a/_overviews/scala-book/vector-class.md b/_overviews/scala-book/vector-class.md index 15981e7904..1c17c9183c 100644 --- a/_overviews/scala-book/vector-class.md +++ b/_overviews/scala-book/vector-class.md @@ -5,7 +5,6 @@ title: The Vector Class description: This page provides examples of the Scala 'Vector' class, including how to add and remove elements from a Vector. partof: scala_book overview-name: Scala Book -discourse: true num: 31 outof: 54 previous-page: list-class diff --git a/_overviews/scala-book/where-next.md b/_overviews/scala-book/where-next.md index 4b045d7182..6bce221a97 100644 --- a/_overviews/scala-book/where-next.md +++ b/_overviews/scala-book/where-next.md @@ -5,7 +5,6 @@ title: Where To Go Next description: Where to go next after reading the Scala Book partof: scala_book overview-name: Scala Book -discourse: true num: 54 outof: 54 previous-page: futures diff --git a/_overviews/scaladoc/contribute.md b/_overviews/scaladoc/contribute.md index dc0af2ce57..0d8999574a 100644 --- a/_overviews/scaladoc/contribute.md +++ b/_overviews/scaladoc/contribute.md @@ -1,14 +1,9 @@ --- layout: multipage-overview title: Contributing to Scaladoc - -discourse: true - partof: scaladoc overview-name: Scaladoc - num: 5 - permalink: /overviews/scaladoc/:title.html --- diff --git a/_overviews/scaladoc/generate.md b/_overviews/scaladoc/generate.md index 98c0942ffe..0fbd38d533 100644 --- a/_overviews/scaladoc/generate.md +++ b/_overviews/scaladoc/generate.md @@ -1,14 +1,9 @@ --- layout: multipage-overview title: Generating Scaladoc - -discourse: true - partof: scaladoc overview-name: Scaladoc - num: 4 - permalink: /overviews/scaladoc/:title.html --- diff --git a/_ru/overviews/collections-2.13/arrays.md b/_ru/overviews/collections-2.13/arrays.md index 7e71da1027..dba3fb4e08 100644 --- a/_ru/overviews/collections-2.13/arrays.md +++ b/_ru/overviews/collections-2.13/arrays.md @@ -1,17 +1,12 @@ --- layout: multipage-overview title: Массивы - -discourse: true - partof: collections-213 overview-name: Collections - num: 10 previous-page: concrete-mutable-collection-classes next-page: strings language: ru - --- [Массивы](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/Array.html) особый вид коллекций в Scala. diff --git a/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md b/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md index 6da8bcc3e1..0c6a672ae0 100644 --- a/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md +++ b/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Реализации Неизменяемых Коллекций - -discourse: true - partof: collections-213 overview-name: Collections - previous-page: maps next-page: concrete-mutable-collection-classes - num: 8 language: ru - --- Scala предлагает множество конечных реализаций неизменяемых коллекций. Они отличаются реализуемыми трейтами (мапы (map), множества(set), последовательности(seq)), они могут быть бесконечными, и различаются производительностью операций. Вот некоторые из наиболее распространенных неизменяемых типов коллекций, используемых в Scala. diff --git a/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md b/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md index 7152037ce9..a65910b05a 100644 --- a/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Реализации Изменяемых Коллекций - -discourse: true - partof: collections-213 overview-name: Collections - num: 9 previous-page: concrete-immutable-collection-classes next-page: arrays - language: ru - --- Вы уже успели увидеть наиболее часто используемые неизменяемые типы коллекции, которые есть в стандартной библиотеке Scala. Настало время посмотреть на изменяемые (mutable) типы коллекции. diff --git a/_ru/overviews/collections-2.13/conversions-between-java-and-scala-collections.md b/_ru/overviews/collections-2.13/conversions-between-java-and-scala-collections.md index 2471e0121f..0320c0c59d 100644 --- a/_ru/overviews/collections-2.13/conversions-between-java-and-scala-collections.md +++ b/_ru/overviews/collections-2.13/conversions-between-java-and-scala-collections.md @@ -1,17 +1,11 @@ --- layout: multipage-overview title: Преобразования между Java и Scala коллекциями - -discourse: true - partof: collections-213 overview-name: Collections - num: 17 previous-page: creating-collections-from-scratch - language: ru - --- Как и в Scala, в Java есть богатая библиотека коллекций. Между ними много общего. Например, обе библиотеки предоставляют итераторы, итерируемые сущности, множества, мапы и списки. Но есть и серьезные различия. В частности, библиотека Scala фокусируют больше внимания на неизменяемых коллекциях, предоставляя больше возможностей для преобразования исходной коллекции в новую. diff --git a/_ru/overviews/collections-2.13/creating-collections-from-scratch.md b/_ru/overviews/collections-2.13/creating-collections-from-scratch.md index 1eacea990f..25c9cb21cf 100644 --- a/_ru/overviews/collections-2.13/creating-collections-from-scratch.md +++ b/_ru/overviews/collections-2.13/creating-collections-from-scratch.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Создание коллекций с нуля - -discourse: true - partof: collections-213 overview-name: Collections - num: 16 previous-page: iterators next-page: conversions-between-java-and-scala-collections - language: ru - --- У вас есть синтаксис `List(1, 2, 3)` для создания списка из трех целых чисел и `Map('A' -> 1, 'C' -> 2)` для создания мапы с двумя элементами. На самом деле, это универсальная функциональность коллекций Scala. Можно получить любую коллекцию написав ее название и указав следом список элементов в круглых скобках. В результате получится новая коллекция с заданными элементами. Вот еще несколько примеров: diff --git a/_ru/overviews/collections-2.13/equality.md b/_ru/overviews/collections-2.13/equality.md index 5908d1ca2b..179ae0bd71 100644 --- a/_ru/overviews/collections-2.13/equality.md +++ b/_ru/overviews/collections-2.13/equality.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Равенство - -discourse: true - partof: collections-213 overview-name: Collections - num: 13 previous-page: performance-characteristics next-page: views - language: ru - --- Коллекций придерживаются единого подхода к определению равенства и получению хэшей. Идея состоит, во-первых, в том, чтобы разделить коллекции на группы: множества, мапы и последовательности. Коллекции в разных группах всегда различаются. Например, `Set(1,2,3)` неравнозначен списку `List(1,2,3)`, хотя они содержат одни и те же элементы. С другой стороны, в рамках одной и той же группы коллекции равны тогда и только тогда, когда они имеют одинаковые элементы (для последовательностей: одни и те же элементы в одном порядке). Например `List(1, 2, 3) == Vector(1, 2, 3)`, и `HashSet(1, 2) == TreeSet(2, 1)`. diff --git a/_ru/overviews/collections-2.13/introduction.md b/_ru/overviews/collections-2.13/introduction.md index c965ef979e..e97c142eb8 100644 --- a/_ru/overviews/collections-2.13/introduction.md +++ b/_ru/overviews/collections-2.13/introduction.md @@ -1,17 +1,11 @@ --- layout: multipage-overview title: Введение - -discourse: true - partof: collections-213 overview-name: Collections - num: 1 next-page: overview - language: ru - --- **Martin Odersky и Lex Spoon** diff --git a/_ru/overviews/collections-2.13/iterators.md b/_ru/overviews/collections-2.13/iterators.md index ee7c02c50d..a74e0bc860 100644 --- a/_ru/overviews/collections-2.13/iterators.md +++ b/_ru/overviews/collections-2.13/iterators.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Итераторы - -discourse: true - partof: collections-213 overview-name: Collections - num: 15 previous-page: views next-page: creating-collections-from-scratch - language: ru - --- Итератор (Iterator) - это не коллекция, а скорее способ поочередного доступа к элементам коллекции. Есть две основные операции у итератора - это `next` и `hasNext`. Вызов метода `it.next()` на итераторе `it` вернет следующий элемент и изменит его состояние. Повторный вызов `next` на том же итераторе выведит следующий элемент идущий после ранее возвращённого. Если больше нет элементов для возврата, вызов команды `next` кинет исключение `NoSuchElementException`. Вы можете узнать, есть ли еще элементы для возврата с помощью метода `hasNext` у [Итератора](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html). diff --git a/_ru/overviews/collections-2.13/maps.md b/_ru/overviews/collections-2.13/maps.md index 18cfc11245..a3d93834fd 100644 --- a/_ru/overviews/collections-2.13/maps.md +++ b/_ru/overviews/collections-2.13/maps.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Мапы - -discourse: true - partof: collections-213 overview-name: Collections - num: 7 previous-page: sets next-page: concrete-immutable-collection-classes - language: ru - --- [Map](https://www.scala-lang.org/api/current/scala/collection/Map.html) это [Iterable](https://www.scala-lang.org/api/current/scala/collection/Iterable.html) состоящее из пар ключ значение (также называемых _связкой_ или _ассоциативным массивом_). diff --git a/_ru/overviews/collections-2.13/overview.md b/_ru/overviews/collections-2.13/overview.md index b0fe21b1cd..361d8f5551 100644 --- a/_ru/overviews/collections-2.13/overview.md +++ b/_ru/overviews/collections-2.13/overview.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Изменяемые и Неизменяемые Коллекции - -discourse: true - partof: collections-213 overview-name: Collections - num: 2 previous-page: introduction next-page: trait-iterable - language: ru - --- В коллекциях Scala постоянно проводят различие между неизменяемыми и изменяемыми коллекциями. _Изменяемые_ (mutable) коллекции могут быть изменены или дополнены. Это означает, что вы можете изменять, добавлять или удалять её элементы. _Неизменяемые_ (Immutable) коллекции, напротив, никогда не меняются. У них есть операции, имитирующие добавления, удаления или обновления, но эти операции каждый раз будут возвращать новую коллекцию и оставлять старую коллекцию без изменений. diff --git a/_ru/overviews/collections-2.13/performance-characteristics.md b/_ru/overviews/collections-2.13/performance-characteristics.md index 526a74a2b2..eb63206c02 100644 --- a/_ru/overviews/collections-2.13/performance-characteristics.md +++ b/_ru/overviews/collections-2.13/performance-characteristics.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Показатели производительности - -discourse: true - partof: collections-213 overview-name: Collections - num: 12 previous-page: strings next-page: equality - language: ru - --- Из предыдущих объяснений стало ясно, что разные типы коллекций имеют разные показатели производительности. Что зачастую является основной причиной, выбора одной коллекции вместо другой. Показатели для наиболее распространенных операций собраны в таблицах ниже. diff --git a/_ru/overviews/collections-2.13/seqs.md b/_ru/overviews/collections-2.13/seqs.md index c5557bdd40..9bf9d180c3 100644 --- a/_ru/overviews/collections-2.13/seqs.md +++ b/_ru/overviews/collections-2.13/seqs.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Последовательности. Трейт Seq, IndexedSeq и LinearSeq - -discourse: true - partof: collections-213 overview-name: Collections - num: 5 previous-page: trait-iterable next-page: sets - language: ru - --- Трейт [Seq](https://www.scala-lang.org/api/current/scala/collection/Seq.html) представляет из себя последовательность. Последовательность - это своего рода итерируемая сущность, у которой есть длина (`length`) и элементы с фиксированным индексом, начинающийся от `0`. diff --git a/_ru/overviews/collections-2.13/sets.md b/_ru/overviews/collections-2.13/sets.md index 3a2bbbf98e..2a4d4a0550 100644 --- a/_ru/overviews/collections-2.13/sets.md +++ b/_ru/overviews/collections-2.13/sets.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Множества - -discourse: true - partof: collections-213 overview-name: Collections - num: 6 previous-page: seqs next-page: maps - language: ru - --- Множества (`Set`) - это итерируемые сущности, которые не содержат дублирующих друг друга элементов. Операции с множествами описаны в таблицах ниже. Описания включают операции для базовых, неизменяемых и изменяемых множеств. Все их операции поделены на следующие категории: diff --git a/_ru/overviews/collections-2.13/strings.md b/_ru/overviews/collections-2.13/strings.md index 1527860415..17e13d1a14 100644 --- a/_ru/overviews/collections-2.13/strings.md +++ b/_ru/overviews/collections-2.13/strings.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Строки - -discourse: true - partof: collections-213 overview-name: Collections - num: 11 previous-page: arrays next-page: performance-characteristics - language: ru - --- Как и массивы, строки не являются непосредственно последовательностями, но могут быть преобразованы в них, а также поддерживают все операции которые есть у последовательностей. Ниже приведены некоторые примеры операций, которые можно вызывать на строках. diff --git a/_ru/overviews/collections-2.13/trait-iterable.md b/_ru/overviews/collections-2.13/trait-iterable.md index 25cfd6ed37..447859daba 100644 --- a/_ru/overviews/collections-2.13/trait-iterable.md +++ b/_ru/overviews/collections-2.13/trait-iterable.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Трейт Iterable - -discourse: true - partof: collections-213 overview-name: Collections - num: 4 previous-page: overview next-page: seqs - language: ru - --- На самом верху иерархии коллекций находится трейт `Iterable`. Все методы в этого трейта описаны как абстрактные, `iterator` - это метод, который выдает элементы коллекции один за другим. diff --git a/_ru/overviews/collections-2.13/views.md b/_ru/overviews/collections-2.13/views.md index 8a095c96a1..3b8a5f5d76 100644 --- a/_ru/overviews/collections-2.13/views.md +++ b/_ru/overviews/collections-2.13/views.md @@ -1,18 +1,12 @@ --- layout: multipage-overview title: Отображения - -discourse: true - partof: collections-213 overview-name: Collections - num: 14 previous-page: equality next-page: iterators - language: ru - --- У коллекций довольно много вариантов создания новых коллекций. Ну например используя операции `map`, `filter` или `++`. Мы называем такие операции *трансформерами*, потому что они берут хотя бы одну коллекцию и трансформируют её в новую коллекцию. diff --git a/_ru/overviews/collections/introduction.md b/_ru/overviews/collections/introduction.md index 4f503f94d6..5b996a9254 100644 --- a/_ru/overviews/collections/introduction.md +++ b/_ru/overviews/collections/introduction.md @@ -1,14 +1,9 @@ --- layout: multipage-overview title: Введение - -discourse: false - partof: collections overview-name: Collections - num: 1 - language: ru --- diff --git a/_ru/overviews/parallel-collections/architecture.md b/_ru/overviews/parallel-collections/architecture.md index 5ee10d99b9..9677440e9c 100644 --- a/_ru/overviews/parallel-collections/architecture.md +++ b/_ru/overviews/parallel-collections/architecture.md @@ -1,9 +1,6 @@ --- layout: multipage-overview title: Архитектура библиотеки параллельных коллекций - -discourse: false - partof: parallel-collections overview-name: Parallel Collections diff --git a/_ru/overviews/parallel-collections/concrete-parallel-collections.md b/_ru/overviews/parallel-collections/concrete-parallel-collections.md index ab41a576c7..b6170ffe1d 100644 --- a/_ru/overviews/parallel-collections/concrete-parallel-collections.md +++ b/_ru/overviews/parallel-collections/concrete-parallel-collections.md @@ -1,12 +1,8 @@ --- layout: multipage-overview title: Конкретные классы параллельных коллекций - -discourse: false - partof: parallel-collections overview-name: Parallel Collections - language: ru num: 2 --- diff --git a/_ru/overviews/parallel-collections/configuration.md b/_ru/overviews/parallel-collections/configuration.md index 5dbd2b1e38..253c4c30d5 100644 --- a/_ru/overviews/parallel-collections/configuration.md +++ b/_ru/overviews/parallel-collections/configuration.md @@ -1,12 +1,8 @@ --- layout: multipage-overview title: Конфигурирование параллельных коллекций - -discourse: false - partof: parallel-collections overview-name: Parallel Collections - language: ru num: 7 --- diff --git a/_ru/overviews/parallel-collections/conversions.md b/_ru/overviews/parallel-collections/conversions.md index 114f2d8986..f001762841 100644 --- a/_ru/overviews/parallel-collections/conversions.md +++ b/_ru/overviews/parallel-collections/conversions.md @@ -1,12 +1,8 @@ --- layout: multipage-overview title: Преобразования параллельных коллекций - -discourse: false - partof: parallel-collections overview-name: Parallel Collections - language: ru num: 3 --- diff --git a/_ru/overviews/parallel-collections/ctries.md b/_ru/overviews/parallel-collections/ctries.md index 9e52d407bf..640ac7e8b9 100644 --- a/_ru/overviews/parallel-collections/ctries.md +++ b/_ru/overviews/parallel-collections/ctries.md @@ -1,12 +1,8 @@ --- layout: multipage-overview title: Многопоточные префиксные деревья - -discourse: false - partof: parallel-collections overview-name: Parallel Collections - language: ru num: 4 --- diff --git a/_ru/overviews/parallel-collections/custom-parallel-collections.md b/_ru/overviews/parallel-collections/custom-parallel-collections.md index 6fd6fa9f58..4dbcdf7e96 100644 --- a/_ru/overviews/parallel-collections/custom-parallel-collections.md +++ b/_ru/overviews/parallel-collections/custom-parallel-collections.md @@ -1,12 +1,8 @@ --- layout: multipage-overview title: Создание пользовательской параллельной коллекции - -discourse: false - partof: parallel-collections overview-name: Parallel Collections - language: ru num: 6 --- diff --git a/_ru/overviews/parallel-collections/overview.md b/_ru/overviews/parallel-collections/overview.md index 2d68d91d8d..e2b4bbcd7d 100644 --- a/_ru/overviews/parallel-collections/overview.md +++ b/_ru/overviews/parallel-collections/overview.md @@ -1,12 +1,8 @@ --- layout: multipage-overview title: Обзор - -discourse: false - partof: parallel-collections overview-name: Parallel Collections - num: 1 language: ru --- diff --git a/_ru/overviews/parallel-collections/performance.md b/_ru/overviews/parallel-collections/performance.md index b86e90bc2c..64e533e359 100644 --- a/_ru/overviews/parallel-collections/performance.md +++ b/_ru/overviews/parallel-collections/performance.md @@ -1,12 +1,8 @@ --- layout: multipage-overview title: Измерение производительности - -discourse: false - partof: parallel-collections overview-name: Parallel Collections - num: 8 language: ru --- diff --git a/_ru/tour/abstract-type-members.md b/_ru/tour/abstract-type-members.md index 849286419f..6da748d090 100644 --- a/_ru/tour/abstract-type-members.md +++ b/_ru/tour/abstract-type-members.md @@ -1,9 +1,6 @@ --- layout: tour title: Члены Абстрактного Типа - -discourse: true - partof: scala-tour num: 23 language: ru @@ -11,7 +8,6 @@ next-page: compound-types previous-page: inner-classes topics: abstract type members prerequisite-knowledge: variance, upper-type-bound - --- Абстрактные типы, такие как трейты и абстрактные классы, могут содержать членов абстрактного типа. diff --git a/_ru/tour/annotations.md b/_ru/tour/annotations.md index 99a668acb0..46718f2d77 100644 --- a/_ru/tour/annotations.md +++ b/_ru/tour/annotations.md @@ -1,16 +1,11 @@ --- layout: tour title: Аннотации - -discourse: true - partof: scala-tour - num: 32 language: ru next-page: packages-and-imports previous-page: by-name-parameters - --- Аннотации используются для передачи метаданных при объявлении. Например, аннотация `@deprecated` перед объявлением метода, заставит компилятор вывести предупреждение, если этот метод будет использован. diff --git a/_ru/tour/automatic-closures.md b/_ru/tour/automatic-closures.md index 7de83279d8..7465e6abef 100644 --- a/_ru/tour/automatic-closures.md +++ b/_ru/tour/automatic-closures.md @@ -1,8 +1,6 @@ --- layout: tour title: Конструкция Автоматического Замыкания Зависимого Типа - -discourse: true language: ru partof: scala-tour num: 14 diff --git a/_ru/tour/basics.md b/_ru/tour/basics.md index f6c3788f4c..518662c9f6 100644 --- a/_ru/tour/basics.md +++ b/_ru/tour/basics.md @@ -1,16 +1,11 @@ --- layout: tour title: Основы - -discourse: true - partof: scala-tour - num: 2 language: ru next-page: unified-types previous-page: tour-of-scala - --- На этой странице мы расскажем об основах Scala. diff --git a/_ru/tour/by-name-parameters.md b/_ru/tour/by-name-parameters.md index 4a1a4d4417..3be9478fe8 100644 --- a/_ru/tour/by-name-parameters.md +++ b/_ru/tour/by-name-parameters.md @@ -1,16 +1,11 @@ --- layout: tour title: Вызов по имени - -discourse: true - partof: scala-tour - num: 31 language: ru next-page: annotations previous-page: operators - --- _Вызов параметров по имени_ - это когда значение параметра вычисляется только в момент вызова параметра. Этот способ противоположен _вызову по значению_. Чтоб вызов параметра был по имени, необходимо просто указать `=>` перед его типом. diff --git a/_ru/tour/case-classes.md b/_ru/tour/case-classes.md index 9a49c560dd..64fab9024e 100644 --- a/_ru/tour/case-classes.md +++ b/_ru/tour/case-classes.md @@ -1,17 +1,12 @@ --- layout: tour title: Классы Образцы - -discourse: true - partof: scala-tour - num: 11 language: ru next-page: pattern-matching previous-page: multiple-parameter-lists prerequisite-knowledge: classes, basics, mutability - --- Классы образцы (Case classes) похожи на обычные классы с несколькими ключевыми отличиями, о которых мы поговорим ниже. Классы образцы хороши для моделирования неизменяемых данных. На следующей странице обзора вы увидите, насколько они полезны для участия в [сопоставлении с примером](pattern-matching.html). diff --git a/_ru/tour/classes.md b/_ru/tour/classes.md index db66150841..d7e66a84c0 100644 --- a/_ru/tour/classes.md +++ b/_ru/tour/classes.md @@ -1,18 +1,13 @@ --- layout: tour title: Классы - -discourse: true - partof: scala-tour - num: 4 language: ru next-page: traits previous-page: unified-types topics: classes prerequisite-knowledge: no-return-keyword, type-declaration-syntax, string-interpolation, procedures - --- Классы в Scala являются основами для создания объектов. Они могут содержать методы, константы, переменные, типы, объекты, трейты и классы, которые в совокупности называются _членами_. Типы, объекты и трейты будут рассмотрены позже в ходе нашего обзора. diff --git a/_ru/tour/compound-types.md b/_ru/tour/compound-types.md index eb861afbfd..5d0a49aa0e 100644 --- a/_ru/tour/compound-types.md +++ b/_ru/tour/compound-types.md @@ -1,16 +1,11 @@ --- layout: tour title: Составные Типы - -discourse: true - partof: scala-tour - num: 24 language: ru next-page: self-types previous-page: abstract-type-members - --- Иногда необходимо выразить, то что тип объекта является подтипом нескольких других типов. В Scala это можно выразить с помощью *составных типов*, которые являются объединением нескольких типов объектов. diff --git a/_ru/tour/default-parameter-values.md b/_ru/tour/default-parameter-values.md index 72ab55e786..ac8c04eda4 100644 --- a/_ru/tour/default-parameter-values.md +++ b/_ru/tour/default-parameter-values.md @@ -1,17 +1,12 @@ --- layout: tour title: Значения Параметров По умолчанию - -discourse: true - partof: scala-tour - num: 33 language: ru next-page: named-arguments previous-page: classes prerequisite-knowledge: named-arguments, function syntax - --- Scala предоставляет возможность задавать значения параметров по умолчанию, что позволяет лишний раз не указывать параметры. diff --git a/_ru/tour/extractor-objects.md b/_ru/tour/extractor-objects.md index 0c968f36cd..8d86b454ac 100644 --- a/_ru/tour/extractor-objects.md +++ b/_ru/tour/extractor-objects.md @@ -1,16 +1,11 @@ --- layout: tour title: Объект Экстрактор - -discourse: true - partof: scala-tour - num: 16 language: ru next-page: for-comprehensions previous-page: regular-expression-patterns - --- Объект Экстрактор (объект распаковщик или extractor object) - это объект с методом `unapply`. В то время как метод `apply` обычно действует как конструктор, который принимает аргументы и создает объект, метод `unapply` действует обратным образом, он принимает объект и пытается извлечь и вернуть аргументы из которых он (возможно) был создан. Чаще всего этот метод используется в функциях сопоставления с примером и в частично определенных функциях. diff --git a/_ru/tour/for-comprehensions.md b/_ru/tour/for-comprehensions.md index 29aad7105c..5a2c538769 100644 --- a/_ru/tour/for-comprehensions.md +++ b/_ru/tour/for-comprehensions.md @@ -1,16 +1,11 @@ --- layout: tour title: Сложные for-выражения - -discourse: true - partof: scala-tour - num: 17 language: ru next-page: generic-classes previous-page: extractor-objects - --- Scala предлагает простую запись для выражения *последовательных преобразований*. Эти преобразования можно упростить используя специальный синтаксис `for выражения` (for comprehension), который записывается как `for (enumerators) yield e`, где `enumerators` относятся к списку перечислителей, разделенных точкой с запятой. Где отдельный такой "перечислитель" (*enumerator*) является либо генератором, который вводит новые переменные, либо фильтром. For-выражение вычисляет тело `e` (которое связанно с тем что генерирует *enumerator*) и возвращает последовательность вычислений. diff --git a/_ru/tour/generic-classes.md b/_ru/tour/generic-classes.md index fafc2fd13e..48d68a9733 100644 --- a/_ru/tour/generic-classes.md +++ b/_ru/tour/generic-classes.md @@ -1,17 +1,12 @@ --- layout: tour title: Обобщенные Классы - -discourse: true - partof: scala-tour - num: 18 language: ru next-page: variances previous-page: for-comprehensions assumed-knowledge: classes unified-types - --- Обобщенные классы (Generic classes) - это классы, обладающие параметрическим полиморфизмом (т. е. классы, которые изменяют свое поведение в зависимости от приписываемого им типа. Этот тип указывается в квадратных скобках `[]` сразу после имени класса). Они особенно полезны для создания коллекций. diff --git a/_ru/tour/higher-order-functions.md b/_ru/tour/higher-order-functions.md index 36a8f0a2a7..2b029a6ca1 100644 --- a/_ru/tour/higher-order-functions.md +++ b/_ru/tour/higher-order-functions.md @@ -1,16 +1,11 @@ --- layout: tour title: Функции Высшего Порядка - -discourse: true - partof: scala-tour - num: 8 language: ru next-page: nested-functions previous-page: mixin-class-composition - --- Функции высшего порядка могут принимать другие функции в качестве параметров или возвращать функцию в качестве результата. diff --git a/_ru/tour/implicit-conversions.md b/_ru/tour/implicit-conversions.md index bd36a9e749..02c5319fae 100644 --- a/_ru/tour/implicit-conversions.md +++ b/_ru/tour/implicit-conversions.md @@ -1,16 +1,11 @@ --- layout: tour title: Неявные Преобразования - -discourse: true - partof: scala-tour - num: 27 language: ru next-page: polymorphic-methods previous-page: implicit-parameters - --- Неявные преобразование типа `S` к типу `T` задается неявным значением функционального типа `S =>T`, или неявным методом, который способен преобразовывать к значению требуемого типа. diff --git a/_ru/tour/implicit-parameters.md b/_ru/tour/implicit-parameters.md index cf58ded10e..f6ca9b6fda 100644 --- a/_ru/tour/implicit-parameters.md +++ b/_ru/tour/implicit-parameters.md @@ -1,16 +1,11 @@ --- layout: tour title: Неявные Параметры - -discourse: true - partof: scala-tour - num: 26 language: ru next-page: implicit-conversions previous-page: self-types - --- Метод может иметь список _неявных_ параметров, помеченный ключевым словом _implicit_ в начале списка параметров. Если параметры в этом списке не передаются как обычно, то Scala будет искать, где можно получить неявное значение требуемого типа, и если найдет, то передаст его автоматически. diff --git a/_ru/tour/inner-classes.md b/_ru/tour/inner-classes.md index 736677ceff..9d86b84000 100644 --- a/_ru/tour/inner-classes.md +++ b/_ru/tour/inner-classes.md @@ -1,16 +1,11 @@ --- layout: tour title: Внутренние классы - -discourse: true - partof: scala-tour - num: 22 language: ru next-page: abstract-type-members previous-page: lower-type-bounds - --- В Scala классам можно иметь в качестве членов другие классы. В отличие от Java-подобных языков, где такие внутренние классы являются членами окружающего класса, в Scala такие внутренние классы привязаны к содержащему его объекту. Предположим, мы хотим, чтобы компилятор не позволял нам на этапе компиляции смешивать узлы этого графа. Для решения этой задачи нам подойдут типы, зависящие от своего расположения. diff --git a/_ru/tour/lower-type-bounds.md b/_ru/tour/lower-type-bounds.md index 8351695a72..ac9e08bd59 100644 --- a/_ru/tour/lower-type-bounds.md +++ b/_ru/tour/lower-type-bounds.md @@ -1,17 +1,12 @@ --- layout: tour title: Нижнее Ограничение Типа - -discourse: true - partof: scala-tour - num: 21 language: ru next-page: inner-classes previous-page: upper-type-bounds prerequisite-knowledge: upper-type-bounds, generics, variance - --- В то время как [верхнее ограничение типа](upper-type-bounds.html) ограничивает тип до подтипа стороннего типа, *нижнее ограничение типа* объявляют тип супертипом стороннего типа. Термин `B >: A` выражает, то что параметр типа `B` или абстрактный тип `B` относится к супертипу типа `A`. В большинстве случаев `A` будет задавать тип класса, а `B` задавать тип метода. diff --git a/_ru/tour/mixin-class-composition.md b/_ru/tour/mixin-class-composition.md index ff7c1d60d9..c27a2edea1 100644 --- a/_ru/tour/mixin-class-composition.md +++ b/_ru/tour/mixin-class-composition.md @@ -1,17 +1,12 @@ --- layout: tour title: Композиция классов с примесями - -discourse: true - partof: scala-tour - num: 7 language: ru next-page: higher-order-functions previous-page: tuples prerequisite-knowledge: inheritance, traits, abstract-classes, unified-types - --- Примеси (Mixin) - это трейты, которые используются для создания класса. diff --git a/_ru/tour/multiple-parameter-lists.md b/_ru/tour/multiple-parameter-lists.md index c4656f5193..c93a6e31d1 100644 --- a/_ru/tour/multiple-parameter-lists.md +++ b/_ru/tour/multiple-parameter-lists.md @@ -1,16 +1,11 @@ --- layout: tour title: Множественные списки параметров (Каррирование) - -discourse: true - partof: scala-tour - num: 10 language: ru next-page: case-classes previous-page: nested-functions - --- Методы могут объявляться с несколькими списками параметров. При этом когда такой метод вызывается с меньшим количеством списков параметров, это приводит к созданию новой функции, которая ожидает на вход не достающий список параметров. Формально это называется [частичное применение](https://en.wikipedia.org/wiki/Partial_application). diff --git a/_ru/tour/named-arguments.md b/_ru/tour/named-arguments.md index 32b83664e4..463480e547 100644 --- a/_ru/tour/named-arguments.md +++ b/_ru/tour/named-arguments.md @@ -1,17 +1,12 @@ --- layout: tour title: Именованные Аргументы - -discourse: true - partof: scala-tour - num: 34 language: ru next-page: packages-and-imports previous-page: default-parameter-values prerequisite-knowledge: function-syntax - --- При вызове методов можно конкретно указывать название задаваемого аргумента следующим образом: diff --git a/_ru/tour/nested-functions.md b/_ru/tour/nested-functions.md index 663e0fdc36..6a59ca5a0e 100644 --- a/_ru/tour/nested-functions.md +++ b/_ru/tour/nested-functions.md @@ -1,16 +1,11 @@ --- layout: tour title: Вложенные Методы - -discourse: true - partof: scala-tour - num: 9 language: ru next-page: multiple-parameter-lists previous-page: higher-order-functions - --- В Scala возможно объявление метода вкладывать в тело другого метода. Это реализовано в следующем примере, в котором метод `factorial` используется для вычисления факториала заданного числа: diff --git a/_ru/tour/operators.md b/_ru/tour/operators.md index 09ea35ea76..dd80f7905d 100644 --- a/_ru/tour/operators.md +++ b/_ru/tour/operators.md @@ -1,17 +1,12 @@ --- layout: tour title: Операторы - -discourse: true - partof: scala-tour - num: 30 language: ru next-page: by-name-parameters previous-page: type-inference prerequisite-knowledge: case-classes - --- В Скале операторы - это обычные методы. В качестве _инфиксного оператора_ может быть использован любой метод с одним параметром. Например, `+` может вызываться с использованием точки: ``` diff --git a/_ru/tour/package-objects.md b/_ru/tour/package-objects.md index 1a0ba1b7f2..e7924e8de8 100644 --- a/_ru/tour/package-objects.md +++ b/_ru/tour/package-objects.md @@ -1,11 +1,7 @@ --- layout: tour title: Объекты Пакета - -discourse: true - partof: scala-tour - num: 36 language: ru previous-page: packages-and-imports diff --git a/_ru/tour/packages-and-imports.md b/_ru/tour/packages-and-imports.md index 2a3e6ba6ff..a4d6710454 100644 --- a/_ru/tour/packages-and-imports.md +++ b/_ru/tour/packages-and-imports.md @@ -1,11 +1,7 @@ --- layout: tour title: Пакеты и Импорт - -discourse: true - partof: scala-tour - num: 35 language: ru previous-page: annotations diff --git a/_ru/tour/pattern-matching.md b/_ru/tour/pattern-matching.md index 8d329636da..15e58ff983 100644 --- a/_ru/tour/pattern-matching.md +++ b/_ru/tour/pattern-matching.md @@ -1,17 +1,12 @@ --- layout: tour title: Сопоставление с примером - -discourse: true - partof: scala-tour - num: 12 language: ru next-page: singleton-objects previous-page: case-classes prerequisite-knowledge: case-classes, string-interpolation, subtyping - --- Сопоставление с примером (Pattern matching) - это механизм сравнения значений с определенным примером. При успешном совпадении значение может быть разложено на составные части. Мы рассматриваем сопоставление с примером, как более мощную версию `switch` оператора из Java. Eго также можно использовать вместо серии if/else выражений. diff --git a/_ru/tour/polymorphic-methods.md b/_ru/tour/polymorphic-methods.md index 3c017b89f6..9d54223100 100644 --- a/_ru/tour/polymorphic-methods.md +++ b/_ru/tour/polymorphic-methods.md @@ -1,17 +1,12 @@ --- layout: tour title: Полиморфные методы - -discourse: true - partof: scala-tour - num: 28 language: ru next-page: type-inference previous-page: implicit-conversions prerequisite-knowledge: unified-types - --- Также как и у обобщенных классов, у методов есть полиморфизм по типу, с таким же синтаксисом (параметр типа указывается в квадратных скобках сразу после названия метода). diff --git a/_ru/tour/regular-expression-patterns.md b/_ru/tour/regular-expression-patterns.md index e8c2ea8404..159921587c 100644 --- a/_ru/tour/regular-expression-patterns.md +++ b/_ru/tour/regular-expression-patterns.md @@ -1,16 +1,11 @@ --- layout: tour title: Регулярные Выражения - -discourse: true - partof: scala-tour - num: 15 language: ru next-page: extractor-objects previous-page: singleton-objects - --- Регулярные выражения (Regular expression) - это специальный шаблон для поиска данных, задаваемый в виде текстовой строки. Любая строка может быть преобразована в регулярное выражение методом `.r`. diff --git a/_ru/tour/self-types.md b/_ru/tour/self-types.md index 2ce9946450..5ca4c91b22 100644 --- a/_ru/tour/self-types.md +++ b/_ru/tour/self-types.md @@ -1,18 +1,13 @@ --- layout: tour title: Самоописываемые типы - -discourse: true - partof: scala-tour - num: 25 language: ru next-page: implicit-parameters previous-page: compound-types topics: self-types prerequisite-knowledge: nested-classes, mixin-class-composition - --- Самоописываемый тип(Self type) - это способ объявить, что трейт должен быть смешан с другим трейтом, даже если он не расширяет его напрямую. Что открывает доступ к членам зависимости без импортирования. diff --git a/_ru/tour/singleton-objects.md b/_ru/tour/singleton-objects.md index d39f5c170e..5b2f79dac8 100644 --- a/_ru/tour/singleton-objects.md +++ b/_ru/tour/singleton-objects.md @@ -1,11 +1,7 @@ --- layout: tour title: Объекты Одиночки - -discourse: true - partof: scala-tour - num: 13 language: ru next-page: regular-expression-patterns diff --git a/_ru/tour/tour-of-scala.md b/_ru/tour/tour-of-scala.md index ac523d9914..321685dbb3 100644 --- a/_ru/tour/tour-of-scala.md +++ b/_ru/tour/tour-of-scala.md @@ -1,11 +1,7 @@ --- layout: tour title: Введение - -discourse: true - partof: scala-tour - num: 1 language: ru next-page: basics diff --git a/_ru/tour/traits.md b/_ru/tour/traits.md index 3eec6fd35c..ab7f6a5ade 100644 --- a/_ru/tour/traits.md +++ b/_ru/tour/traits.md @@ -1,18 +1,13 @@ --- layout: tour title: Трейты - -discourse: true - partof: scala-tour - num: 5 language: ru next-page: tuples previous-page: named-arguments topics: traits prerequisite-knowledge: expressions, classes, generics, objects, companion-objects - --- Трейты (Traits) используются, чтобы обмениваться между классами информацией о структуре и полях. Они похожи на интерфейсы из Java 8. Классы и объекты могут расширять трейты, но трейты не могут быть созданы и поэтому не имеют параметров. diff --git a/_ru/tour/tuples.md b/_ru/tour/tuples.md index 8d30c607c5..8af61d5102 100644 --- a/_ru/tour/tuples.md +++ b/_ru/tour/tuples.md @@ -1,17 +1,12 @@ --- layout: tour title: Кортежи - -discourse: true - partof: scala-tour - num: 6 language: ru next-page: mixin-class-composition previous-page: traits topics: tuples - --- В Scala, кортеж (Тuple) это класс контейнер содержащий упорядоченный набор элементов различного типа. diff --git a/_ru/tour/type-inference.md b/_ru/tour/type-inference.md index 5e5e39cf17..6709acf411 100644 --- a/_ru/tour/type-inference.md +++ b/_ru/tour/type-inference.md @@ -1,11 +1,7 @@ --- layout: tour title: Выведение Типа - -discourse: true - partof: scala-tour - num: 29 language: ru next-page: operators diff --git a/_ru/tour/unified-types.md b/_ru/tour/unified-types.md index 1bd87556b7..7399f82409 100644 --- a/_ru/tour/unified-types.md +++ b/_ru/tour/unified-types.md @@ -1,17 +1,12 @@ --- layout: tour title: Единобразие типов - -discourse: true - partof: scala-tour - num: 3 language: ru next-page: classes previous-page: basics prerequisite-knowledge: classes, basics - --- В Scala все значения имеют тип, включая числовые значения и функции. Диаграмма ниже иллюстрирует подмножество иерархии типов. diff --git a/_ru/tour/upper-type-bounds.md b/_ru/tour/upper-type-bounds.md index 60ca550d59..2bfe19f96e 100644 --- a/_ru/tour/upper-type-bounds.md +++ b/_ru/tour/upper-type-bounds.md @@ -1,16 +1,12 @@ --- layout: tour title: Верхнее Ограничение Типа - -discourse: true - partof: scala-tour categories: tour num: 20 language: ru next-page: lower-type-bounds previous-page: variances - --- В Scala [параметры типа](generic-classes.html) и [члены абстрактного типа](abstract-type-members.html) могут быть ограничены определенными диапазонами. Такие диапазоны ограничивают конкретные значение типа и, возможно, предоставляют больше информации о членах таких типов. _Верхнее ограничение типа_ `T <: A` указывает на то что тип `T` относится к подтипу типа `A`. diff --git a/_ru/tour/variances.md b/_ru/tour/variances.md index c59549f340..17dd06b74c 100644 --- a/_ru/tour/variances.md +++ b/_ru/tour/variances.md @@ -1,16 +1,11 @@ --- layout: tour title: Вариантность - -discourse: true - partof: scala-tour - num: 19 language: ru next-page: upper-type-bounds previous-page: generic-classes - --- Вариантность (Variances) - это указание определенной специфики взаимосвязи между связанными типам. Scala поддерживает вариантную аннотацию типов у [обобщенных классов](generic-classes.html), что позволяет им быть ковариантными, контрвариантными или инвариантными (если нет никакого указание на вариантность). Использование вариантности в системе типов позволяет устанавливать понятные взаимосвязи между сложными типами, в то время как отсутствие вариантности может ограничить повторное использование абстракции класса. From 86b753a7c61b9ef04013902b6104eb92439b38fd Mon Sep 17 00:00:00 2001 From: Philippus Date: Tue, 19 Apr 2022 08:47:50 +0200 Subject: [PATCH 1841/3075] Display code blocks inside details/summary correctly --- _overviews/scala3-macros/tutorial/inline.md | 12 ++++++++++-- _sass/layout/details-summary.scss | 3 +++ resources/css/style.scss | 1 + 3 files changed, 14 insertions(+), 2 deletions(-) create mode 100644 _sass/layout/details-summary.scss diff --git a/_overviews/scala3-macros/tutorial/inline.md b/_overviews/scala3-macros/tutorial/inline.md index c081b8d61c..30c445cef0 100644 --- a/_overviews/scala3-macros/tutorial/inline.md +++ b/_overviews/scala3-macros/tutorial/inline.md @@ -254,8 +254,11 @@ Calling `power` with statically known constants results in the following code: val x = 2 power(x * x, 1) ``` + +{::options parse_block_html="true" /}
    - See rest of inlining steps + See rest of inlining steps + ```scala // then inlined as @@ -283,6 +286,8 @@ x2 * 1.0 ```
    +{::options parse_block_html="false" /} + In contrast, let us imagine we do not know the value of `n`: ```scala @@ -291,8 +296,10 @@ power(2, unknownNumber) Driven by the inline annotation on the parameter, the compiler will try to unroll the recursion. But without any success, since the parameter is not statically known. +{::options parse_block_html="true" /}
    - See inlining steps + See inlining steps + ```scala // first inlines as @@ -318,6 +325,7 @@ else { ... ```
    +{::options parse_block_html="false" /} To guarantee that the branching can indeed be performed at compile-time, we can use the `inline if` variant of `if`. Annotating a conditional with `inline` will guarantee that the conditional can be reduced at compile-time and emits an error if the condition is not a statically known constant. diff --git a/_sass/layout/details-summary.scss b/_sass/layout/details-summary.scss new file mode 100644 index 0000000000..1f18d4cd64 --- /dev/null +++ b/_sass/layout/details-summary.scss @@ -0,0 +1,3 @@ +details > summary > p { + display: inline; +} diff --git a/resources/css/style.scss b/resources/css/style.scss index 57b121deba..fb5c150296 100755 --- a/resources/css/style.scss +++ b/resources/css/style.scss @@ -56,6 +56,7 @@ @import 'layout/blog'; @import 'layout/download'; @import 'layout/content-contributors'; // COMPONENTS +@import 'layout/details-summary'; //------------------------------------------------ //------------------------------------------------ @import 'components/buttons'; From c4c0be187b9caf2c5243da2a2b521e91efba2ef2 Mon Sep 17 00:00:00 2001 From: Erik van Oosten Date: Thu, 21 Apr 2022 14:54:35 +0200 Subject: [PATCH 1842/3075] Avoid dysphemisms I was reading the inclusive language guide at https://docs.scala-lang.org/contribute/inclusive-language-guide.html. I have 2 points of feedback. I initially posted this on Discord but then I noticed I could do a pull request. So here it is. Re. blacklist/whitelist. Such lists are often used to regulate access. Therefore I propose we suggest the alternative 'allowlist/denylist' as it is probably appropriate in more circumstances. This is also the suggestion done from the linked page https://github.com/dialpad/inclusive-language. --- _overviews/contribute/inclusive-language-guide.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/_overviews/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md index 375d988158..5689979302 100644 --- a/_overviews/contribute/inclusive-language-guide.md +++ b/_overviews/contribute/inclusive-language-guide.md @@ -90,7 +90,7 @@ This list is neither comprehensive nor definitive, and it can evolve over time. * **blacklist/whitelist** \ While the etymology of these words has no relation to racism, their use suggests an association between the color black and some form of badness or exclusion, and between the color white and some form of goodness or inclusion. Prefer alternatives when possible. - Several alternatives have been proposed but none sticks as "the one". We suggest using the pair *excludelist*/*includelist*, as it is generic enough to replace all uses of *blacklist*/*whitelist*. + Several alternatives have been proposed but none sticks as "the one". We suggest using the pair *allowlist*/*denylist*, as it is generic enough to replace most uses of *blacklist*/*whitelist*. * **master/slave** \ Never use *slave*. Never use *master* in conjunction with *slave*. @@ -116,6 +116,12 @@ We encourage you to research inclusive language guidelines applicable to your do You may want to use automated software like [In Solidarity](https://github.com/apps/in-solidarity) to steer contributors away from loaded words. +## Dysphemism + +Dysphemisms, the opposite of euphemisms, should be avoided. For example, the English expressions "pull the trigger" (enforce a decision) and "bite the bullet" (endure hardship) can be disturbingly violent if you are not used to them. + +Using the direct meaning is preferred. + ## Backward compatibility Sometimes, we have existing code, APIs or commands that do not follow the above recommendations. From 99d4d45e3c58c988849a1439a83e8f69a155a295 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9dric=20Chantepie?= Date: Thu, 21 Apr 2022 21:25:45 +0200 Subject: [PATCH 1843/3075] Fix StandardPlugin example --- _scala3-reference/changed-features/compiler-plugins.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_scala3-reference/changed-features/compiler-plugins.md b/_scala3-reference/changed-features/compiler-plugins.md index c77796d71d..39358b4e8c 100644 --- a/_scala3-reference/changed-features/compiler-plugins.md +++ b/_scala3-reference/changed-features/compiler-plugins.md @@ -57,6 +57,7 @@ package dividezero import dotty.tools.dotc.ast.Trees.* import dotty.tools.dotc.ast.tpd +import dotty.tools.dotc.report import dotty.tools.dotc.core.Constants.Constant import dotty.tools.dotc.core.Contexts.Context import dotty.tools.dotc.core.Decorators.* @@ -84,7 +85,7 @@ class DivideZeroPhase extends PluginPhase: tree match case Apply(Select(rcvr, nme.DIV), List(Literal(Constant(0)))) if rcvr.tpe <:< defn.IntType => - report.error("dividing by zero", tree.pos) + report.error("dividing by zero", tree.srcPos) case _ => () tree From 885fac887ecff3a2964c095af6cd5b8e05782180 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=A2=A6=E5=A2=83=E8=BF=B7=E7=A6=BB?= Date: Fri, 22 Apr 2022 23:48:15 +0800 Subject: [PATCH 1844/3075] fix --- _zh-cn/scala3/new-in-scala3.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/_zh-cn/scala3/new-in-scala3.md b/_zh-cn/scala3/new-in-scala3.md index 472f66331f..ed649cb7da 100644 --- a/_zh-cn/scala3/new-in-scala3.md +++ b/_zh-cn/scala3/new-in-scala3.md @@ -36,7 +36,7 @@ Scala的一个基本核心概念是（在某种程度上仍然是）为用户提 - **Viewing one type as another**. [隐式转换][contextual-conversions]已经被重新设计为类型类`Conversion`的实例。 -- **Higher-order contextual abstractions**. [context functions][contextual-functions]的 _全新_ 功能使上下文抽象成为一流的公民。它们是库开发人员的一个重要工具，允许表达简洁的特定领域语言。 +- **Higher-order contextual abstractions**. [context functions][contextual-functions]的 _全新_ 功能使上下文抽象成为第一等公民。它们是库开发人员的一个重要工具，允许表达简洁的特定领域语言。 - **Actionable feedback from the compiler**. 如果一个隐式参数不能被编译器解决，它现在提供了可能解决这个问题的[import suggestions](https://www.scala-lang.org/blog/2020/05/05/scala-3-import-suggestions.html)。 @@ -47,17 +47,17 @@ Scala的一个基本核心概念是（在某种程度上仍然是）为用户提 - **Opaque Types**. 将实现细节隐藏在[opaque type aliases][types-opaque]的别名后面，而不需要在性能上付出代价! Opaque types 取代了值类，并允许你建立一个抽象的屏障，而不会造成额外的装箱开销。 -- **Intersection and union types**. 将类型系统建立在新的基础上，导致了新的类型系统功能的引入：[intersection types][types-intersection]的实例，如`A & B`，既是`A`的实例，也是`B`的实例；[union types][types-union]的实例，如`A | B`，是`A`或`B`的实例。这两种结构都允许程序员在继承层次结构之外灵活地表达类型约束。 +- **Intersection and union types**. 将类型系统建立在新的基础上，引入了新的类型系统特性：[intersection types][types-intersection]的实例，如`A & B`，既是`A`的实例，也是`B`的实例；[union types][types-union]的实例，如`A | B`，是`A`或`B`的实例。这两种结构都允许程序员在继承层次结构之外灵活地表达类型约束。 - **Dependent function types**. Scala 2 已经允许返回类型依赖于（值）参数。在 Scala 3 中，现在可以对这种模式进行抽象，表达[dependent function types][types-dependent]。在类型`F = (e: Entry) => e.Key`中，结果类型取决于参数。 - **Polymorphic function types**. 与 dependent function types 一样，Scala 2 支持拥有类型参数的方法，但不允许程序员对这些方法进行抽象。在 Scala 3 中，像`[A] => List[A] => List[A]`这样的[polymorphic function types][types-polymorphic]可以抽象出除值参数外还接受 _类型参数_ 的函数。 -- **Type lambdas**. 在 Scala 2 中需要用[编译器插件](https://github.com/typelevel/kind-projector)来表达的东西，现在在 Scala 3 中是第一类的功能：类型lambdas是类型级别的函数，可以作为（高等类型的）类型参数传递，而不需要辅助类型定义。 +- **Type lambdas**. 在 Scala 2 中需要用[编译器插件](https://github.com/typelevel/kind-projector)来表达的东西，现在在 Scala 3 中是原生支持的功能：类型lambdas是类型级别的函数，可以作为（高等类型的）类型参数传递，而不需要辅助类型定义。 - **Match types**. Scala 3 提供了对[matching on types][types-match]的直接支持，而不是使用隐式解析对类型级别的计算进行编码。将类型级计算整合到类型检查器中，可以改进错误信息，并消除对复杂编码的需求。 -### 重新设想的：面向对象的编程 +### Re-envisioned：面向对象的编程 Scala 一直处于函数式编程和面向对象编程的前沿 -- 而 Scala 3 在这两个方向上都推动了边界的发展! 上述类型系统的变化和上下文抽象的重新设计使得 _函数式编程_ 比以前更容易。同时，以下的新特性使结构良好的 _面向对象设计_ 成为可能，并支持最佳实践。 @@ -65,7 +65,7 @@ Scala 一直处于函数式编程和面向对象编程的前沿 -- 而 Scala 3 - **Plan for extension**. 在面向对象的设计中，扩展那些不打算扩展的类是一个长期存在的问题。为了解决这个问题，[open classes][oo-open]要求库设计者 _明确地_ 将类标记为 open（开放的）。 -- **Hide implementation details**. 实施行为的实用性traits有时不应该是推断类型的一部分。在 Scala 3 中，这些traits可以被标记为[transparent][oo-transparent]，（在推断类型中）向用户隐藏继承性。 +- **Hide implementation details**. 实现功能的工具性的traits有时不应该是推断类型的一部分。在 Scala 3 中，这些traits可以被标记为[transparent][oo-transparent]，（在推断类型中）向用户隐藏继承信息。 - **Composition over inheritance**. 这句话经常被引用，但实现起来却很繁琐。Scala 3 的[export clauses][oo-export]则不然：与imports对应，export clauses 允许用户为对象的选定成员定义别名。 @@ -74,13 +74,13 @@ Scala 一直处于函数式编程和面向对象编程的前沿 -- 而 Scala 3 ### Batteries Included: 元编程 Scala 2 中的宏只是一个实验性的功能，而 Scala 3 则为元编程提供了强大的工具库。[宏教程]({% link _overviews/scala3-macros/tutorial/index.md %})中包含了关于不同设施的详细信息。特别是，Scala 3 为元编程提供了以下功能： -- **Inline**. [inline feature][meta-inline]允许在编译时减少数值和方法。这个简单的功能已经涵盖了许多使用情况，同时也为更高级的功能提供了入口。 +- **Inline**. [inline feature][meta-inline]允许在编译时化简值和方法。这个简单的功能已经涵盖了许多使用情况，同时也为更高级的功能提供了入口。 - **Compile-time operations**. 包[`scala.compiletime`][meta-compiletime]中包含了额外的功能，可以用来实现内联方法。 - **Quoted code blocks**. Scala 3为代码增加了[quasi-quotation][meta-quotes]的新功能，这为构建和分析代码提供了方便的高级接口。构建加一加一的代码就像`'{ 1 + 1 }`一样简单。 - **Reflection API**. 对于更高级的用例，[quotes.reflect][meta-reflection]提供了更详细的控制来检查和生成程序树。 -如果你想进一步了解 Scala 3 中的元编程，我们邀请你参加[教程][meta-tutorial]。 +如果你想进一步了解 Scala 3 中的元编程，我们邀请你参阅我们的[教程][meta-tutorial]。 [enums]: {{ site.scala3ref }}/enums/enums.html [enums-adts]: {{ site.scala3ref }}/enums/adts.html From 6b6676f885d39e05e8be4eb4fc076d416366bb34 Mon Sep 17 00:00:00 2001 From: Maximilien Tirard Date: Sat, 23 Apr 2022 14:28:14 +0100 Subject: [PATCH 1845/3075] Typo --- _overviews/parallel-collections/performance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/parallel-collections/performance.md b/_overviews/parallel-collections/performance.md index 625f08304e..96be271b44 100644 --- a/_overviews/parallel-collections/performance.md +++ b/_overviews/parallel-collections/performance.md @@ -81,7 +81,7 @@ For proper benchmark examples, you can see the source code inside [Scala library This is a question commonly asked. The answer is somewhat involved. -The size of the collection at which the parallelization pays of really +The size of the collection at which the parallelization pays off really depends on many factors. Some of them, but not all, include: - Machine architecture. Different CPU types have different From c09f64ad58eaf42a3f5619c434c9f3919f846124 Mon Sep 17 00:00:00 2001 From: kenji yoshida <6b656e6a69@gmail.com> Date: Sun, 24 Apr 2022 09:50:15 +0900 Subject: [PATCH 1846/3075] fix Scala 3 reflection doc. `companionObject` => `companionClass` https://github.com/lampepfl/dotty/blob/3.1.3-RC2/library/src/scala/quoted/Quotes.scala#L3929-L3933 --- _overviews/scala3-macros/tutorial/reflection.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/reflection.md b/_overviews/scala3-macros/tutorial/reflection.md index b9bca2e1c9..46618a1d4f 100644 --- a/_overviews/scala3-macros/tutorial/reflection.md +++ b/_overviews/scala3-macros/tutorial/reflection.md @@ -117,7 +117,7 @@ In addition, `Symbol` exposes and is used by many useful methods. For example: - `declaredFields` and `declaredMethods` allow you to iterate on the fields and members defined inside a symbol - `flags` allows you to check multiple properties of a symbol - - `companionObject` and `companionModule` provide a way to jump to and from the companion object/class + - `companionClass` and `companionModule` provide a way to jump to and from the companion object/class - `TypeRepr.baseClasses` returns the list of symbols of classes extended by a type - `Symbol.pos` gives you access to the position where the symbol is defined, the source code of the definition, and even the filename where the symbol is defined - many others that you can find in [`SymbolMethods`](https://scala-lang.org/api/3.x/scala/quoted/Quotes$reflectModule$SymbolMethods.html) From 0ac46fb75644b042c04bb9469f8951847331d1b0 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Fri, 29 Apr 2022 17:00:51 +0200 Subject: [PATCH 1847/3075] add tabs on get-started page (english) --- _config.yml | 3 + _data/setup-scala.yml | 4 + _includes/code-snippet.html | 6 ++ _includes/getting-started.md | 52 +++++----- _includes/tabsection.html | 20 ++++ _install_tabs/1-macos.md | 23 +++++ _install_tabs/2-linux.md | 14 +++ _install_tabs/3-windows.md | 14 +++ _install_tabs/4-other.md | 17 ++++ _sass/layout/alt-details.scss | 46 +++++++++ _sass/layout/scala-in-action.scss | 158 ++++++++++++++++++++++++++++++ _sass/layout/tabsection.scss | 60 ++++++++++++ resources/css/style.scss | 3 + resources/js/functions.js | 78 ++++++++++++--- 14 files changed, 456 insertions(+), 42 deletions(-) create mode 100644 _data/setup-scala.yml create mode 100644 _includes/code-snippet.html create mode 100644 _includes/tabsection.html create mode 100644 _install_tabs/1-macos.md create mode 100644 _install_tabs/2-linux.md create mode 100644 _install_tabs/3-windows.md create mode 100644 _install_tabs/4-other.md create mode 100644 _sass/layout/alt-details.scss create mode 100755 _sass/layout/scala-in-action.scss create mode 100755 _sass/layout/tabsection.scss diff --git a/_config.yml b/_config.yml index accb4b5df1..21f5c59539 100644 --- a/_config.yml +++ b/_config.yml @@ -21,6 +21,9 @@ scala-3-version: 3.1.2 collections: contribute_resources: + output: false + install_tabs: + output: false style: output: true overviews: diff --git a/_data/setup-scala.yml b/_data/setup-scala.yml new file mode 100644 index 0000000000..d1bb19a78d --- /dev/null +++ b/_data/setup-scala.yml @@ -0,0 +1,4 @@ +linux: curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup +macOS-default: curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup +macOS-brew: brew install coursier/formulas/coursier && cs setup +windows-link: https://github.com/coursier/launchers/raw/master/cs-x86_64-pc-win32.zip diff --git a/_includes/code-snippet.html b/_includes/code-snippet.html new file mode 100644 index 0000000000..0286da8b4d --- /dev/null +++ b/_includes/code-snippet.html @@ -0,0 +1,6 @@ +
    +
    +
    +
    + 
    {{include.codeSnippet}}
    +
    diff --git a/_includes/getting-started.md b/_includes/getting-started.md index 83c1de45fe..2df5661769 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -21,9 +21,29 @@ It ensures that a JVM and standard Scala tools are installed on your system. Install it on your system with the following instructions.
    -
    -

    Follow the instructions to install the cs launcher then run:

    -

    $ ./cs setup

    +
    +
    +
    +
    + {% include tabsection.html extraClasses='inline-tabs' category='get-started' collection=site.install_tabs %} +
    + +
    +
    +

    Check your setup with the command scala -version, which should output:

    +
    + 
    $ scala -version
+Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL
    +
    +

    If that does not work, you may need to log out and log back in (or reboot) in order for the changes to take effect. +

    +
    +
    +
    +
    +
    +
    @@ -165,29 +185,3 @@ Once you've finished the above tutorials, consider checking out: ## Getting Help There are a multitude of mailing lists and real-time chat rooms in case you want to quickly connect with other Scala users. Check out our [community](https://scala-lang.org/community/) page for a list of these resources, and for where to reach out for help. - - - - - - - - - diff --git a/_includes/tabsection.html b/_includes/tabsection.html new file mode 100644 index 0000000000..a5473b04e5 --- /dev/null +++ b/_includes/tabsection.html @@ -0,0 +1,20 @@ +
    +
    + {% for tabRoot in include.collection %} + + {% endfor %} +
    + {% for tabRoot in include.collection %} +
    {{tabRoot.content}}
    + {% endfor %} +
    diff --git a/_install_tabs/1-macos.md b/_install_tabs/1-macos.md new file mode 100644 index 0000000000..f91ab023fa --- /dev/null +++ b/_install_tabs/1-macos.md @@ -0,0 +1,23 @@ +--- +tabId: osx +tabLabel: macOS +--- +
    +
    +
    +
    +

    Run the following command in your terminal, following the on-screen instructions:

    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} +
    + +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +
    +
    +
    +
    +
    +
    +
    diff --git a/_install_tabs/2-linux.md b/_install_tabs/2-linux.md new file mode 100644 index 0000000000..6924edf275 --- /dev/null +++ b/_install_tabs/2-linux.md @@ -0,0 +1,14 @@ +--- +tabId: linux +tabLabel: Linux +--- +
    +
    +
    +
    +

    Run the following command in your terminal, following the on-screen instructions:

    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +
    +
    +
    +
    diff --git a/_install_tabs/3-windows.md b/_install_tabs/3-windows.md new file mode 100644 index 0000000000..c3e31fb837 --- /dev/null +++ b/_install_tabs/3-windows.md @@ -0,0 +1,14 @@ +--- +tabId: windows +tabLabel: Windows +--- +
    +
    +
    +
    +

    Download and execute the Scala + installer for Windows based on Coursier, and follow the on-screen instructions.

    +
    +
    +
    +
    diff --git a/_install_tabs/4-other.md b/_install_tabs/4-other.md new file mode 100644 index 0000000000..d60085c17f --- /dev/null +++ b/_install_tabs/4-other.md @@ -0,0 +1,17 @@ +--- +tabId: other +tabLabel: Other +fallbackNoJS: true +--- +
    +
    +
    +
    + +

    Follow the documentation from Coursier on how to install and run cs setup.

    +
    +
    +
    +
    diff --git a/_sass/layout/alt-details.scss b/_sass/layout/alt-details.scss new file mode 100644 index 0000000000..aae4addefb --- /dev/null +++ b/_sass/layout/alt-details.scss @@ -0,0 +1,46 @@ +// ALT-DETAILS +//------------------------------------------------ +//------------------------------------------------ + +.alt-details { + margin: 10px 0px; + + button.alt-details-toggle { + width: 100%; + border: none; + background-color: #b635c4; + padding: 5px 10px; + border-radius: 15px; + font-size: $font-size-medium; + cursor: pointer; + font-weight: 500; + color: #fff; + + &:hover { + background-color: #941fa1; + } + + &:after { + content: "\f13a"; // + font-family: "Font Awesome 5 Free"; + font-weight: 900; + font-size: 15px; + color: #fff; + float: right; + margin-top: 2px; + } + + &.alt-details-closed:after { + content: "\f138"; // + } + } + + .alt-details-detail { + background-color: rgb(248, 226, 255); + border: 1px solid rgb(239, 207, 248); + padding-top: 25px; + padding-bottom: 10px; + margin-top: -15px; + margin-bottom: 10px; + } +} diff --git a/_sass/layout/scala-in-action.scss b/_sass/layout/scala-in-action.scss new file mode 100755 index 0000000000..404c9bbd7f --- /dev/null +++ b/_sass/layout/scala-in-action.scss @@ -0,0 +1,158 @@ +// SCALA-IN-ACTION +//------------------------------------------------ +//------------------------------------------------ + +.scala-in-action { + + .tabcontent { + .scala-text { + .alt-details { + button.alt-details-toggle { + border: 1px solid #a0dff0; + background-color: #d1e5eb; + color: $gray; + + &:hover { + background-color: #c9e3eb; + } + + &:after { + color: $gray; + } + } + + .alt-details-detail { + background-color: $gray-light; + border: 1px solid darken($gray-light, 3%); + } + } + } + } + + .scala-in-action-content { + transition: $base-transition; + + + .scala-in-action-code { + // display: none; + // background: $gray-dark; + padding: 20px 0; + + .wrap { + margin-bottom: 0px; + } + + .snippet { + position: relative; + margin: 10px 0px; + cursor: default; + width: 100%; + + &:hover { + .buttons { + opacity: 0.95; + + &:active { + opacity: 0.3; + } + } + } + + .buttons { + position: absolute; + right: 4px; + top: 5px; + transition: all .2s ease; + display: flex; + opacity: 0; + flex-direction: row-reverse; + justify-content: flex-start; + + button { + outline: none; + background: #fff; + border: none; + font-size: $font-size-medium; + color: rgba($gray, .6); + cursor: pointer; + + i { + font-weight: $font-bold; + } + } + } + + pre.snippet-code { + margin: 0px; + display: block; + overflow-x: auto; + + code { + overflow-x: auto; + display: block; + } + } + } + + .scala-code { + + @include span-columns(7); + + @include bp(large) { + @include span-columns(12); + } + } + + .scala-text { + + details { + summary { + + &:hover { + background-color: lighten($gray-lighter, 5%); + } + } + + summary>* { + display: inline; + } + } + + code { + padding: 3px 6px; + color: #859900; + background-color: #fff; + border-radius: 10px; + border: 1px solid $gray-light; + } + + .snippet { + pre.snippet-code { + code { + border: 1px solid darken($gray-light, 10%); + } + } + } + + @include span-columns(5); + + @include bp(large) { + @include span-columns(12); + } + + h3 { + font-size: 1.525rem; + margin-bottom: 20px; + } + + p { + color: $base-font-color; + } + + &.scala-text-large { + @include span-columns(12); + } + } + } + } +} diff --git a/_sass/layout/tabsection.scss b/_sass/layout/tabsection.scss new file mode 100755 index 0000000000..71c2777183 --- /dev/null +++ b/_sass/layout/tabsection.scss @@ -0,0 +1,60 @@ +// TABSECTION +//------------------------------------------------ +//------------------------------------------------ + +.recommended-install { + margin-top: -2em; + .tabsection { + background: $gray-lighter; + } +} + +.tabsection { + + &.inline-tabs { + margin: 20px 0px; + } + + /* Style the tab */ + .tab { + overflow: hidden; + margin-bottom: -12px; + } + + /* Style the buttons that are used to open the tab content */ + .tab button { + font-family: $heading-font-family; + font-size: $font-size-medium; + font-weight: $font-bold; + color: lighten($gray, 25%); + background-color: inherit; + float: left; + border: none; + border-radius: 30px; + outline: none; + cursor: pointer; + padding: 14px 16px; + } + + /* Change background color of buttons on hover */ + .tab button:hover { + color: #fff; + background-color: $gray; + border-bottom: $base-border-white; + } + + /* Create an active/current tablink class */ + .tab button.active { + background-color: $gray; + border-bottom: $base-border-white; + color: #fff; + } + + /* Style the tab content */ + .tabcontent { + display: none; + padding: 0px 2px; + border-top: none; + transition: all .5s linear; + } +} diff --git a/resources/css/style.scss b/resources/css/style.scss index fb5c150296..02ed07ce47 100755 --- a/resources/css/style.scss +++ b/resources/css/style.scss @@ -28,6 +28,9 @@ @import 'layout/twitter-feed'; @import 'layout/cheatsheet'; @import 'layout/ides'; +@import 'layout/alt-details'; +@import 'layout/tabsection'; +@import 'layout/scala-in-action'; @import 'layout/nutshell'; @import 'layout/overviews'; @import 'layout/sips'; diff --git a/resources/js/functions.js b/resources/js/functions.js index e52eddd5cf..cd5ac73eac 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -404,6 +404,58 @@ $(document).ready(function() { } }); +const toggleElement = (evt, elemId) => { + const btn = evt.target; + const elem = document.getElementById(elemId); + if (elem.style.display === "none") { + elem.style.display = "block"; + } else { + elem.style.display = "none"; + } + $(btn).toggleClass("alt-details-closed"); +} + +$(document).ready(() => { + $('.alt-details-toggle').click(); +}); + +function copySnippet(evt) { + const snippet = evt.target.closest('.snippet').querySelector('.snippet-code'); + const code = snippet.querySelector('code').innerText; + window.navigator.clipboard.writeText(code) +} + +function openTab(evt, category, tabName) { + // Get all elements with class="tabcontent" and hide them + $('.tabcontent-' + category + '.tabcontent').css('display', 'none'); + + const queried = evt.target; + + // Get all elements with class="tablinks" and remove the class "active" + $('.tablinks-' + category + '.tablinks').removeClass('active'); + + // Show the current tab, and add an "active" class to the button that opened the tab + document.getElementById(category + '-' + tabName).style.display = "block"; + queried.className += " active"; +} + +$(document).ready(() => { + const defaultTabs = document.getElementsByClassName('default-tab'); + for (i = 0; i < defaultTabs.length; i++) { + defaultTabs[i].click(); + } +}); + +$(document).ready(function () { + if ($(".main-download").length) { + let os = getOS(); + if (os === 'unix') { + os = 'linux'; + } + $("#get-started-tab-" + os).click(); + } +}); + var image = { width: 1680, height: 1100 @@ -467,18 +519,18 @@ $('#filter-glossary-terms').focus(); //Footer scroll to top button -$(document).ready(function(){ - $(window).scroll(function(){ - if ($(this).scrollTop() > 100) { - $('#scroll-to-top-btn').fadeIn(); - } else { - $('#scroll-to-top-btn').fadeOut(); - } - }); - $('#scroll-to-top-btn').click(function(){ - $("html, body").animate({ scrollTop: 0 }, 600); - return false; - }); +$(document).ready(function(){ + $(window).scroll(function(){ + if ($(this).scrollTop() > 100) { + $('#scroll-to-top-btn').fadeIn(); + } else { + $('#scroll-to-top-btn').fadeOut(); + } + }); + $('#scroll-to-top-btn').click(function(){ + $("html, body").animate({ scrollTop: 0 }, 600); + return false; + }); }); //Contributors widget @@ -490,7 +542,7 @@ $(document).ready(function () { * - some files aren't prefixed with underscore, see rootFiles * - some files are placed in _overviews but rendered to its folder, see overviewsFolders */ - + let rootFiles = ['getting-started', 'learn', 'glossary']; let overviewsFolders = ['FAQ', 'cheatsheets', 'collections', 'compiler-options', 'core', 'jdk-compatibility', 'macros', 'parallel-collections', From 71cf7e946fc3377ab35ae90e46cf3a9a9d8bc531 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Fri, 29 Apr 2022 18:03:35 +0200 Subject: [PATCH 1848/3075] add tabs to other translated pages --- _fr/getting-started/index.md | 41 +++--------- _includes/_ja/getting-started.md | 39 +++--------- _includes/alt-details.html | 6 ++ _includes/code-snippet.html | 2 + _includes/getting-started.md | 45 +++++++------- _includes/tabsection.html | 4 ++ _install_tabs/1-macos.md | 20 +++--- _install_tabs/2-linux.md | 1 + _install_tabs/3-windows.md | 1 + _install_tabs/4-other.md | 1 + _install_tabs/fr-1-macos.md | 26 ++++++++ _install_tabs/fr-2-linux.md | 14 +++++ _install_tabs/fr-3-windows.md | 14 +++++ _install_tabs/fr-4-other.md | 19 ++++++ _install_tabs/ja-1-macos.md | 26 ++++++++ _install_tabs/ja-2-linux.md | 14 +++++ _install_tabs/ja-3-windows.md | 14 +++++ _install_tabs/ja-4-other.md | 18 ++++++ _layouts/downloadpage.html | 100 ------------------------------ _sass/layout/scala-in-action.scss | 3 +- resources/js/functions.js | 30 +++------ 21 files changed, 225 insertions(+), 213 deletions(-) create mode 100644 _includes/alt-details.html create mode 100644 _install_tabs/fr-1-macos.md create mode 100644 _install_tabs/fr-2-linux.md create mode 100644 _install_tabs/fr-3-windows.md create mode 100644 _install_tabs/fr-4-other.md create mode 100644 _install_tabs/ja-1-macos.md create mode 100644 _install_tabs/ja-2-linux.md create mode 100644 _install_tabs/ja-3-windows.md create mode 100644 _install_tabs/ja-4-other.md delete mode 100644 _layouts/downloadpage.html diff --git a/_fr/getting-started/index.md b/_fr/getting-started/index.md index f9b05d7df9..397c18e59c 100644 --- a/_fr/getting-started/index.md +++ b/_fr/getting-started/index.md @@ -24,13 +24,19 @@ Nous recommandons l'utilisation de l'outil d'installation "Coursier" qui va auto ### Utilisation de l'installateur Scala (recommandé) L'installateur Scala est un outil nommé [Coursier](https://get-coursier.io/docs/cli-overview), la commande principale de l'outil est `cs`. -Il s'assure que la JVM est les outils standards de Scala sont installés sur votre système. +Il s'assure que la JVM est les outils standards de Scala sont installés sur votre système. Installez-le sur votre système avec les instructions suivantes.
    -
    -

    Suivez les instructions pour installer la commande cs puis exécutez :

    -

    $ ./cs setup

    +
    +
    +
    +
    + {% include tabsection.html language='fr' extraClasses='inline-tabs' category='get-started' collection=site.install_tabs %} + +
    +
    +
    @@ -165,30 +171,3 @@ Une fois que vous avez terminé le tutoriel ce dessus, vous pouvez consulter : Il y a plusieurs listes de diffusion et canaux de discussions instantanés si vous souhaitez rencontrer rapidement d'autres utilisateurs de Scala. Allez faire un tour sur notre page [community](https://scala-lang.org/community/) pour consulter la liste des ces ressources et obtenir de l'aide. Traduction par Antoine Pointeau. - - - - - - - - - diff --git a/_includes/_ja/getting-started.md b/_includes/_ja/getting-started.md index 1df3b33933..f747ff92f7 100644 --- a/_includes/_ja/getting-started.md +++ b/_includes/_ja/getting-started.md @@ -18,13 +18,18 @@ Scala のインストーラーは[Coursier](https://get-coursier.io/docs/cli-ove 以下の手順でお使いのシステムにインストールしてください。
    -
    -

    Follow the instructions to install the cs launcher then run:

    -

    $ ./cs setup

    +
    +
    +
    +
    + {% include tabsection.html language='ja' extraClasses='inline-tabs' category='get-started' collection=site.install_tabs %} + +
    +
    +
    - `cs setup` は JVM の管理だけでなく、便利なコマンドラインツールもインストールします: - JDK (インストール済みでなければ) @@ -141,29 +146,3 @@ IDE の使用に慣れている場合は、IDE から_Main.scala_のコードを ### (日本語のみ追記) Scala について日本語で質問したい場合、Twitterでつぶやくと気づいた人が教えてくれます。 - - - - - - - - - diff --git a/_includes/alt-details.html b/_includes/alt-details.html new file mode 100644 index 0000000000..52e8d9cf67 --- /dev/null +++ b/_includes/alt-details.html @@ -0,0 +1,6 @@ +
    + +
    + {{include.detail}} +
    +
    diff --git a/_includes/code-snippet.html b/_includes/code-snippet.html index 0286da8b4d..6267a08ad3 100644 --- a/_includes/code-snippet.html +++ b/_includes/code-snippet.html @@ -1,6 +1,8 @@
    + {% unless include.nocopy %}
    + {% endunless %} 
    {{include.codeSnippet}}
    diff --git a/_includes/getting-started.md b/_includes/getting-started.md index 2df5661769..45c42b166f 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -20,31 +20,32 @@ The Scala installer is a tool named [Coursier](https://get-coursier.io/docs/cli- It ensures that a JVM and standard Scala tools are installed on your system. Install it on your system with the following instructions. +{% capture scalaDemo %}$ scala -version +Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL{% endcapture %} +
    -
    -
    -
    -
    - {% include tabsection.html extraClasses='inline-tabs' category='get-started' collection=site.install_tabs %} -
    - -
    -
    -

    Check your setup with the command scala -version, which should output:

    -
    - 
    $ scala -version
-Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL
    -
    -

    If that does not work, you may need to log out and log back in (or reboot) in order for the changes to take effect. -

    -
    -
    -
    -
    -
    +
    +
    +
    +
    + {% include tabsection.html language='en' extraClasses='inline-tabs' category='get-started' collection=site.install_tabs %} + {% capture checkSetupDetail %} +
    +

    Check your setup with the command scala -version, which should output:

    + {% include code-snippet.html codeSnippet=scalaDemo language='bash' nocopy=true %} +

    If that does not work, you may need to log out and log back in (or reboot) in order for the changes to take effect.

    +
    + {% endcapture %} + {% include alt-details.html + title='Testing your setup' + detail=checkSetupDetail + targetId='macos-get-started-alt1' + extraClasses='scala-text scala-text-large' + %}
    +
    +
    diff --git a/_includes/tabsection.html b/_includes/tabsection.html index a5473b04e5..a03f01130f 100644 --- a/_includes/tabsection.html +++ b/_includes/tabsection.html @@ -1,14 +1,17 @@
    {% for tabRoot in include.collection %} + {% if tabRoot.language == include.language %} + {% endif %} {% endfor %}
    {% for tabRoot in include.collection %} + {% if tabRoot.language == include.language %}
    {{tabRoot.content}}
    + {% endif %} {% endfor %}
    diff --git a/_install_tabs/1-macos.md b/_install_tabs/1-macos.md index f91ab023fa..e8dc277265 100644 --- a/_install_tabs/1-macos.md +++ b/_install_tabs/1-macos.md @@ -1,6 +1,7 @@ --- tabId: osx tabLabel: macOS +language: en ---
    @@ -8,15 +9,18 @@ tabLabel: macOS

    Run the following command in your terminal, following the on-screen instructions:

    {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} -
    - -
    -
    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} -
    -
    + {% assign homebrewAlt = "Alternatively, if you don't use Homebrew:" %} + {% capture homebrewDetail %} +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %}
    + {% endcapture %} + {% include alt-details.html + title=homebrewAlt + detail=homebrewDetail + targetId='macos-get-started-alt' + extraClasses='scala-text-large alt-details-detail' + %}
    diff --git a/_install_tabs/2-linux.md b/_install_tabs/2-linux.md index 6924edf275..a5a8eb7169 100644 --- a/_install_tabs/2-linux.md +++ b/_install_tabs/2-linux.md @@ -1,6 +1,7 @@ --- tabId: linux tabLabel: Linux +language: en ---
    diff --git a/_install_tabs/3-windows.md b/_install_tabs/3-windows.md index c3e31fb837..9d9ae82c68 100644 --- a/_install_tabs/3-windows.md +++ b/_install_tabs/3-windows.md @@ -1,6 +1,7 @@ --- tabId: windows tabLabel: Windows +language: en ---
    diff --git a/_install_tabs/4-other.md b/_install_tabs/4-other.md index d60085c17f..00ceb97edb 100644 --- a/_install_tabs/4-other.md +++ b/_install_tabs/4-other.md @@ -2,6 +2,7 @@ tabId: other tabLabel: Other fallbackNoJS: true +language: en ---
    diff --git a/_install_tabs/fr-1-macos.md b/_install_tabs/fr-1-macos.md new file mode 100644 index 0000000000..836b8f53e1 --- /dev/null +++ b/_install_tabs/fr-1-macos.md @@ -0,0 +1,26 @@ +--- +tabId: osx +tabLabel: macOS +language: fr +--- +
    +
    +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} + {% assign homebrewAlt = "Alternativement, si vous n'utilisez pas Homebrew:" %} + {% capture homebrewDetail %} +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +
    + {% endcapture %} + {% include alt-details.html + title=homebrewAlt + detail=homebrewDetail + targetId='macos-get-started-alt' + extraClasses='scala-text-large alt-details-detail' + %} +
    +
    +
    +
    diff --git a/_install_tabs/fr-2-linux.md b/_install_tabs/fr-2-linux.md new file mode 100644 index 0000000000..18a0925149 --- /dev/null +++ b/_install_tabs/fr-2-linux.md @@ -0,0 +1,14 @@ +--- +tabId: linux +tabLabel: Linux +language: fr +--- +
    +
    +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +
    +
    +
    +
    diff --git a/_install_tabs/fr-3-windows.md b/_install_tabs/fr-3-windows.md new file mode 100644 index 0000000000..2c22382b2e --- /dev/null +++ b/_install_tabs/fr-3-windows.md @@ -0,0 +1,14 @@ +--- +tabId: windows +tabLabel: Windows +language: fr +--- +
    +
    +
    +
    +

    Téléchargez et exécutez l'intallateur Scala pour Windows basé sur Coursier

    +
    +
    +
    +
    diff --git a/_install_tabs/fr-4-other.md b/_install_tabs/fr-4-other.md new file mode 100644 index 0000000000..89bee815a8 --- /dev/null +++ b/_install_tabs/fr-4-other.md @@ -0,0 +1,19 @@ +--- +tabId: other +tabLabel: Other +fallbackNoJS: true +language: fr +--- +
    +
    +
    +
    + +

    Suivez les instructions pour installer la commande + cspuis exécutez ./cs setup.

    +
    +
    +
    +
    diff --git a/_install_tabs/ja-1-macos.md b/_install_tabs/ja-1-macos.md new file mode 100644 index 0000000000..792efacfc2 --- /dev/null +++ b/_install_tabs/ja-1-macos.md @@ -0,0 +1,26 @@ +--- +tabId: osx +tabLabel: macOS +language: ja +--- +
    +
    +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} + {% assign homebrewAlt = "または、Homebrewを使用しない場合は" %} + {% capture homebrewDetail %} +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +
    + {% endcapture %} + {% include alt-details.html + title=homebrewAlt + detail=homebrewDetail + targetId='macos-get-started-alt' + extraClasses='scala-text-large alt-details-detail' + %} +
    +
    +
    +
    diff --git a/_install_tabs/ja-2-linux.md b/_install_tabs/ja-2-linux.md new file mode 100644 index 0000000000..a59f88d1e1 --- /dev/null +++ b/_install_tabs/ja-2-linux.md @@ -0,0 +1,14 @@ +--- +tabId: linux +tabLabel: Linux +language: ja +--- +
    +
    +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +
    +
    +
    +
    diff --git a/_install_tabs/ja-3-windows.md b/_install_tabs/ja-3-windows.md new file mode 100644 index 0000000000..76ff527bea --- /dev/null +++ b/_install_tabs/ja-3-windows.md @@ -0,0 +1,14 @@ +--- +tabId: windows +tabLabel: Windows +language: ja +--- +
    +
    +
    +
    +

    the Scala installer for Windowsを、ダウンロードして実行してください。

    +
    +
    +
    +
    diff --git a/_install_tabs/ja-4-other.md b/_install_tabs/ja-4-other.md new file mode 100644 index 0000000000..0e400d4fcb --- /dev/null +++ b/_install_tabs/ja-4-other.md @@ -0,0 +1,18 @@ +--- +tabId: other +tabLabel: Other +fallbackNoJS: true +language: ja +--- +
    +
    +
    +
    + +

    手順に従って cs ランチャーをインストールし、その次に以下を実行します。./cs setup

    +
    +
    +
    +
    diff --git a/_layouts/downloadpage.html b/_layouts/downloadpage.html deleted file mode 100644 index 0849a3d013..0000000000 --- a/_layouts/downloadpage.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -layout: inner-page-parent ---- - -
    -
    -
    -
    -
    - {{page.release_version}} -
    - -
    -
    -

    Compared to other programming languages, installing Scala is a bit unusual. It's possible to "install" Scala in numerous ways.

    -
    -
    - -
    1
    -
    -

    First, make sure you have the Java 8 JDK installed.

    -

    java -version(Make sure you have version 1.8.)

    -
    -
    -
    -
    2
    -
    -

    Then, install Scala using:

    -
    -
    -
    -
    - or -
    - -

    Best if you prefer a full-featured IDE (recommended for beginners)

    -
    - - - Download intellij - -
      - {% include tutorial-list.html column=1 %} -
    -
    -
    -
    - -

    Best if you are familiar with the command line

    -
    - - - Download Sbt - -
      - {% include tutorial-list.html column=0 %} -
    -
    -
    -

    Scala is unusual because it is usually installed for each of your Scala projects rather than being installed system-wide. Both of the above options manage a specific Scala version per Scala project you create.

    - -

    Release Notes

    -

    For important changes, please consult the release notes.

    - -

    Software Requirements

    - - {{ page.requirements }} - - {{ content }} - - {% if page.show_resources == "true" %} - - {% include download-resource-list.html %} - - {% endif %} - -

    License

    -

    The Scala distribution is released under the 3-clause BSD license.

    -
    - -
    -
    -
    - - {% for step in site.data.downloads.stepOne %} - - {% endfor %} - - {% for intellijUrl in site.data.downloads.intellijUrls %} - - {% endfor %} - - {% for sbtUrl in site.data.downloads.sbtUrls %} - - {% endfor %} -
    \ No newline at end of file diff --git a/_sass/layout/scala-in-action.scss b/_sass/layout/scala-in-action.scss index 404c9bbd7f..297dda244e 100755 --- a/_sass/layout/scala-in-action.scss +++ b/_sass/layout/scala-in-action.scss @@ -13,7 +13,7 @@ color: $gray; &:hover { - background-color: #c9e3eb; + background-color: #b8deea; } &:after { @@ -129,6 +129,7 @@ .snippet { pre.snippet-code { code { + padding: 7px 6px; border: 1px solid darken($gray-light, 10%); } } diff --git a/resources/js/functions.js b/resources/js/functions.js index cd5ac73eac..cc61873b19 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -392,21 +392,9 @@ function getOS() { return osname; } -$(document).ready(function() { - if ($(".main-download").length) { - var os = getOS(); - var intelliJlink = $("#intellij-" + os).text(); - var sbtLink = $("#sbt-" + os).text(); - var stepOneContent = $("#stepOne-" + os).html() - $("#download-intellij-link").attr("href", intelliJlink); - $("#download-sbt-link").attr("href", sbtLink); - $("#download-step-one").html(stepOneContent); - } -}); - -const toggleElement = (evt, elemId) => { - const btn = evt.target; - const elem = document.getElementById(elemId); +function toggleElement(evt, elemId) { + var btn = evt.target; + var elem = document.getElementById(elemId); if (elem.style.display === "none") { elem.style.display = "block"; } else { @@ -415,13 +403,13 @@ const toggleElement = (evt, elemId) => { $(btn).toggleClass("alt-details-closed"); } -$(document).ready(() => { +$(document).ready(function() { $('.alt-details-toggle').click(); }); function copySnippet(evt) { - const snippet = evt.target.closest('.snippet').querySelector('.snippet-code'); - const code = snippet.querySelector('code').innerText; + var snippet = evt.target.closest('.snippet').querySelector('.snippet-code'); + var code = snippet.querySelector('code').innerText; window.navigator.clipboard.writeText(code) } @@ -429,7 +417,7 @@ function openTab(evt, category, tabName) { // Get all elements with class="tabcontent" and hide them $('.tabcontent-' + category + '.tabcontent').css('display', 'none'); - const queried = evt.target; + var queried = evt.target; // Get all elements with class="tablinks" and remove the class "active" $('.tablinks-' + category + '.tablinks').removeClass('active'); @@ -439,8 +427,8 @@ function openTab(evt, category, tabName) { queried.className += " active"; } -$(document).ready(() => { - const defaultTabs = document.getElementsByClassName('default-tab'); +$(document).ready(function() { + var defaultTabs = document.getElementsByClassName('default-tab'); for (i = 0; i < defaultTabs.length; i++) { defaultTabs[i].click(); } From a6f5a9e9aab443df7804c10136a8fe24e17f6bf6 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 3 May 2022 15:17:24 +0200 Subject: [PATCH 1849/3075] Mark SIP 34 as completed Implemented in Scala 2.13 in scala/scala#5969 Implemented in Scala 3 in lampepfl/dotty#3841 --- _sips/sips/2017-07-12-right-associative-by-name-operators.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_sips/sips/2017-07-12-right-associative-by-name-operators.md b/_sips/sips/2017-07-12-right-associative-by-name-operators.md index 6b9ae3d0a6..b93ea41f09 100644 --- a/_sips/sips/2017-07-12-right-associative-by-name-operators.md +++ b/_sips/sips/2017-07-12-right-associative-by-name-operators.md @@ -1,7 +1,8 @@ --- layout: sip title: SIP-34 - Right-Associative By-Name Operators -vote-status: accepted +vote-status: complete +vote-text: This SIP has been implemented in Scala 2.13.0 and Scala 3.0.0 permalink: /sips/:title.html redirect_from: /sips/pending/right-associative-by-name-operators.html --- From 49a15bb87f054de92a3d14387fae22e3bbf79244 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 3 May 2022 15:25:12 +0200 Subject: [PATCH 1850/3075] Mark SIP 36 as completed MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Assigned number 36 to SIP “By-name implicit arguments”. Implemented in Scala 2.13 in scala/scala#6050 Implemented in Scala 3 in lampepfl/dotty#5461 --- _sips/sips/2017-11-20-byname-implicits.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_sips/sips/2017-11-20-byname-implicits.md b/_sips/sips/2017-11-20-byname-implicits.md index db735776a6..75c61fec46 100644 --- a/_sips/sips/2017-11-20-byname-implicits.md +++ b/_sips/sips/2017-11-20-byname-implicits.md @@ -1,7 +1,8 @@ --- layout: sip -title: SIP-NN - Byname implicit arguments -vote-status: pending +title: SIP-36 - Byname implicit arguments +vote-status: complete +vote-text: This SIP has been implemented in Scala 2.13.0 and Scala 3.0.0 permalink: /sips/:title.html redirect_from: /sips/pending/byname-implicits.html --- From d8e3b682eecb73bef222619b27a84150601bb6dc Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 3 May 2022 15:30:58 +0200 Subject: [PATCH 1851/3075] Mark SIP 37 as complete MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Assigned number 37 to SIP “Quote escapes for interpolations”. Implemented in Scala 2.13.6 in scala/scala#9536 Implemented in Scala 3.0.0 in lampepfl/dotty#7486 --- _sips/sips/2018-07-31-interpolation-quote-escape.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/_sips/sips/2018-07-31-interpolation-quote-escape.md b/_sips/sips/2018-07-31-interpolation-quote-escape.md index fe6615f12f..692e528de0 100644 --- a/_sips/sips/2018-07-31-interpolation-quote-escape.md +++ b/_sips/sips/2018-07-31-interpolation-quote-escape.md @@ -1,7 +1,8 @@ --- layout: sip -title: SIP-NN - Quote escapes for interpolations -vote-status: pending +title: SIP-37 - Quote escapes for interpolations +vote-status: complete +vote-text: This SIP has been implemented in Scala 2.13.6 and Scala 3.0.0 permalink: /sips/:title.html redirect_from: /sips/pending/interpolation-quote-escape.html --- @@ -126,4 +127,4 @@ proposals. [^4]: https://github.com/scala/bug/issues/6476#issuecomment-292412577 "@retronym said: +1 to s"$"". Because it doesn't compile today, we don't risk changing the meaning of existing programs." [^5]: https://github.com/Scala/Scala/pull/6953/files#diff-0023b3bfa053fb16603156b785efa7ad "" [^6]: https://github.com/Scala/Scala/pull/4308 "SI-6476 Accept escaped quotes in interp strings" -[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" +[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" From 663a312785daa8982e6c3c61c0b1cc1ed551086d Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 3 May 2022 15:40:33 +0200 Subject: [PATCH 1852/3075] Mark SIP 38 as complete MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Assigned number 38 to SIP “Converters among optional functions, partial functions, and extractor objects”. Implemented in Scala 2.13.0 and Scala 3.0.0 in scala/scala#7111 The change did not _require_ a SIP because it was implemented at the library-level. Nevertheless, I decided to keep the SIP for posterity. --- ...ional-functions-partialfunctions-and-extractor-objects.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_sips/sips/2018-08-20-converters-among-optional-functions-partialfunctions-and-extractor-objects.md b/_sips/sips/2018-08-20-converters-among-optional-functions-partialfunctions-and-extractor-objects.md index 7bd7571ea8..816ee0af7f 100644 --- a/_sips/sips/2018-08-20-converters-among-optional-functions-partialfunctions-and-extractor-objects.md +++ b/_sips/sips/2018-08-20-converters-among-optional-functions-partialfunctions-and-extractor-objects.md @@ -1,7 +1,8 @@ --- layout: sip -title: SIP-NN - Converters among optional Functions, PartialFunctions and extractor objects -vote-status: pending +title: SIP-38 - Converters among optional Functions, PartialFunctions and extractor objects +vote-status: complete +vote-text: This SIP has been implemented in Scala 2.13.0 and Scala 3.0.0 permalink: /sips/:title.html redirect_from: /sips/pending/converters-among-optional-functions-partialfunctions-and-extractor-object.html --- From 22876be86617912f5be3b914ac184fc349e0a94d Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 3 May 2022 16:13:44 +0200 Subject: [PATCH 1853/3075] Mark SIP 35 as complete --- _sips/sips/2017-09-20-opaque-types.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/_sips/sips/2017-09-20-opaque-types.md b/_sips/sips/2017-09-20-opaque-types.md index 9847baea50..58996ca60b 100644 --- a/_sips/sips/2017-09-20-opaque-types.md +++ b/_sips/sips/2017-09-20-opaque-types.md @@ -2,7 +2,8 @@ layout: sip title: SIP-35 - Opaque types -vote-status: accepted +vote-status: complete +vote-text: This SIP has been implemented with some changes in Scala 3.0.0 permalink: /sips/:title.html redirect_from: /sips/pending/opaque-types.html --- @@ -50,11 +51,8 @@ For a definition of boxing and previous state-of-the-art, we recommend reading [ ### Implementation note -The proposal is currently in an early stage. -[It’s being implemented](https://github.com/scalacenter/scala/tree/opaque-type), -but the proposed implementation strategy is not detailed enough to be able -to predict with certainty that it will work as specified. Consequently, -details of the proposal might change driven by implementation concerns. +Opaque types have been implemented in Scala 3.0.0 with +[some changes compared to this proposal](https://docs.scala-lang.org/scala3/reference/other-new-features/opaques-details.html#relationship-to-sip-35). ## Opaque types From 046797af822cf01c2951017d387446fc2e62522f Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 3 May 2022 16:15:14 +0200 Subject: [PATCH 1854/3075] =?UTF-8?q?Normalize=20name=20of=20SIP=20?= =?UTF-8?q?=E2=80=9CSealed=20types=E2=80=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- _sips/sips/2021-05-18-sealed-types.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/2021-05-18-sealed-types.md b/_sips/sips/2021-05-18-sealed-types.md index 369c705079..6c9406c97b 100644 --- a/_sips/sips/2021-05-18-sealed-types.md +++ b/_sips/sips/2021-05-18-sealed-types.md @@ -1,6 +1,6 @@ --- layout: sip -title: Sealed Types +title: SIP-NN - Sealed Types vote-status: pending permalink: /sips/:title.html redirect_from: /sips/pending/sealed-types.html From 51faf4329ac33c0d9f78895ef1597d32265178ca Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 3 May 2022 16:35:54 +0200 Subject: [PATCH 1855/3075] Mark SIP-25 as complete --- _sips/sips/2015-6-18-trait-parameters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/2015-6-18-trait-parameters.md b/_sips/sips/2015-6-18-trait-parameters.md index 6abef5c4b8..a5dffe5446 100644 --- a/_sips/sips/2015-6-18-trait-parameters.md +++ b/_sips/sips/2015-6-18-trait-parameters.md @@ -1,7 +1,7 @@ --- layout: sip title: SIP-25 - Trait Parameters -vote-status: accepted +vote-status: complete vote-text: Trait parameters are implemented in Scala 3.0. permalink: /sips/:title.html redirect_from: /sips/pending/trait-parameters.html From c2477907c859030b5f2227b23b5f40eaee149839 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Wed, 4 May 2022 11:21:23 +0200 Subject: [PATCH 1856/3075] Make sure SIP numbers are used exactly once, and proposals use exactly one number. --- _sips/sips/2016-09-09-inline-meta.md | 2 +- _sips/sips/2017-07-12-right-associative-by-name-operators.md | 2 +- _sips/sips/2017-11-20-byname-implicits.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_sips/sips/2016-09-09-inline-meta.md b/_sips/sips/2016-09-09-inline-meta.md index 8aa401d125..c3eb059723 100644 --- a/_sips/sips/2016-09-09-inline-meta.md +++ b/_sips/sips/2016-09-09-inline-meta.md @@ -1,6 +1,6 @@ --- layout: sip -title: SIP-28 and SIP-29 - Inline meta +title: SIP-28 - Inline meta vote-status: dormant vote-text: This proposal needs an owner. permalink: /sips/:title.html diff --git a/_sips/sips/2017-07-12-right-associative-by-name-operators.md b/_sips/sips/2017-07-12-right-associative-by-name-operators.md index b93ea41f09..e9451c4705 100644 --- a/_sips/sips/2017-07-12-right-associative-by-name-operators.md +++ b/_sips/sips/2017-07-12-right-associative-by-name-operators.md @@ -1,6 +1,6 @@ --- layout: sip -title: SIP-34 - Right-Associative By-Name Operators +title: SIP-39 - Right-Associative By-Name Operators vote-status: complete vote-text: This SIP has been implemented in Scala 2.13.0 and Scala 3.0.0 permalink: /sips/:title.html diff --git a/_sips/sips/2017-11-20-byname-implicits.md b/_sips/sips/2017-11-20-byname-implicits.md index 75c61fec46..3de5293b4f 100644 --- a/_sips/sips/2017-11-20-byname-implicits.md +++ b/_sips/sips/2017-11-20-byname-implicits.md @@ -1,6 +1,6 @@ --- layout: sip -title: SIP-36 - Byname implicit arguments +title: SIP-31 - Byname implicit arguments vote-status: complete vote-text: This SIP has been implemented in Scala 2.13.0 and Scala 3.0.0 permalink: /sips/:title.html From d1072f0485cea45bd64ff2a28d2534498f360ae5 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Thu, 5 May 2022 14:52:00 +0200 Subject: [PATCH 1857/3075] Remove source files in _scala3-reference/ --- _config.yml | 14 +- _data/scala3-doc-nav-header.yml | 2 +- _ja/index.md | 2 +- _ja/scala3/contribute-to-docs.md | 4 +- _ja/scala3/index.md | 2 +- _overviews/FAQ/index.md | 4 +- _overviews/contribute/add-guides.md | 2 +- _overviews/scala3-book/why-scala-3.md | 8 +- .../scala3-contribution/arch-lifecycle.md | 2 +- _overviews/scala3-contribution/arch-phases.md | 2 +- .../scala3-contribution/contribution-intro.md | 2 +- _overviews/scala3-macros/other-resources.md | 2 +- _overviews/scala3-macros/tutorial/inline.md | 2 +- .../compatibility-classpath.md | 36 +- .../compatibility-metaprogramming.md | 2 +- .../incompat-contextual-abstractions.md | 2 +- .../incompat-dropped-features.md | 10 +- .../incompat-other-changes.md | 2 +- .../incompat-type-inference.md | 2 +- .../scala3-migration/incompatibility-table.md | 4 +- .../scala3-migration/plugin-kind-projector.md | 2 +- .../tooling-syntax-rewriting.md | 2 +- _overviews/scala3-scaladoc/settings.md | 2 +- _scala3-reference/changed-features.md | 9 - .../changed-features/compiler-plugins.md | 131 --- .../changed-features/eta-expansion-spec.md | 77 -- .../changed-features/eta-expansion.md | 44 - .../implicit-conversions-spec.md | 117 --- .../changed-features/implicit-conversions.md | 66 -- .../changed-features/implicit-resolution.md | 170 ---- _scala3-reference/changed-features/imports.md | 61 -- .../changed-features/interpolation-escapes.md | 14 - .../changed-features/lazy-vals-init.md | 82 -- .../changed-features/main-functions.md | 91 -- .../changed-features/match-syntax.md | 58 -- .../changed-features/numeric-literals.md | 264 ------ .../changed-features/operators.md | 167 ---- .../changed-features/overload-resolution.md | 94 -- .../changed-features/pattern-bindings.md | 62 -- .../changed-features/pattern-matching.md | 246 ------ .../changed-features/structural-types-spec.md | 153 ---- .../changed-features/structural-types.md | 194 ---- .../changed-features/type-checking.md | 9 - .../changed-features/type-inference.md | 12 - .../changed-features/vararg-splices.md | 42 - .../changed-features/wildcards.md | 52 -- _scala3-reference/contextual.md | 85 -- .../contextual/by-name-context-parameters.md | 67 -- .../contextual/context-bounds.md | 48 - .../contextual/context-functions-spec.md | 79 -- .../contextual/context-functions.md | 156 ---- _scala3-reference/contextual/conversions.md | 78 -- .../contextual/derivation-macro.md | 204 ----- _scala3-reference/contextual/derivation.md | 405 --------- .../contextual/extension-methods.md | 308 ------- _scala3-reference/contextual/given-imports.md | 119 --- _scala3-reference/contextual/givens.md | 173 ---- .../contextual/multiversal-equality.md | 229 ----- .../contextual/relationship-implicits.md | 208 ----- .../right-associative-extension-methods.md | 52 -- _scala3-reference/contextual/type-classes.md | 284 ------ _scala3-reference/contextual/using-clauses.md | 155 ---- _scala3-reference/dropped-features.md | 9 - .../dropped-features/auto-apply.md | 98 --- .../dropped-features/class-shadowing-spec.md | 26 - .../dropped-features/class-shadowing.md | 35 - .../dropped-features/delayed-init.md | 32 - .../dropped-features/do-while.md | 43 - .../dropped-features/early-initializers.md | 18 - .../dropped-features/existential-types.md | 37 - _scala3-reference/dropped-features/limit22.md | 19 - _scala3-reference/dropped-features/macros.md | 18 - .../dropped-features/nonlocal-returns.md | 26 - .../dropped-features/package-objects.md | 49 -- .../dropped-features/procedure-syntax.md | 21 - _scala3-reference/dropped-features/symlits.md | 12 - .../dropped-features/this-qualifier.md | 17 - .../dropped-features/type-projection.md | 20 - .../dropped-features/weak-conformance-spec.md | 54 -- .../dropped-features/weak-conformance.md | 49 -- .../dropped-features/wildcard-init.md | 25 - _scala3-reference/dropped-features/xml.md | 41 - _scala3-reference/enums.md | 9 - _scala3-reference/enums/adts.md | 175 ---- _scala3-reference/enums/desugarEnums.md | 217 ----- _scala3-reference/enums/enums.md | 196 ----- _scala3-reference/experimental/canthrow.md | 242 ----- .../experimental/erased-defs-spec.md | 65 -- _scala3-reference/experimental/erased-defs.md | 229 ----- _scala3-reference/features-classification.md | 201 ----- _scala3-reference/language-versions.md | 11 - .../language-versions/binary-compatibility.md | 38 - .../language-versions/source-compatibility.md | 38 - _scala3-reference/metaprogramming.md | 49 -- .../metaprogramming/compiletime-ops.md | 296 ------- _scala3-reference/metaprogramming/inline.md | 380 -------- .../metaprogramming/macros-spec.md | 254 ------ _scala3-reference/metaprogramming/macros.md | 825 ------------------ .../metaprogramming/reflection.md | 133 --- .../metaprogramming/simple-smp.md | 232 ----- _scala3-reference/metaprogramming/staging.md | 123 --- .../metaprogramming/tasty-inspect.md | 59 -- _scala3-reference/new-types.md | 9 - .../dependent-function-types-spec.md | 125 --- .../new-types/dependent-function-types.md | 51 -- .../new-types/intersection-types-spec.md | 108 --- .../new-types/intersection-types.md | 70 -- _scala3-reference/new-types/match-types.md | 247 ------ .../new-types/polymorphic-function-types.md | 96 -- .../new-types/type-lambdas-spec.md | 119 --- _scala3-reference/new-types/type-lambdas.md | 19 - .../new-types/union-types-spec.md | 172 ---- _scala3-reference/new-types/union-types.md | 48 - _scala3-reference/other-new-features.md | 9 - .../other-new-features/control-syntax.md | 49 -- .../creator-applications.md | 59 -- .../other-new-features/explicit-nulls.md | 540 ------------ .../other-new-features/export.md | 183 ---- .../indentation-experimental.md | 83 -- .../other-new-features/indentation.md | 455 ---------- .../other-new-features/kind-polymorphism.md | 49 -- .../other-new-features/matchable.md | 144 --- .../other-new-features/named-typeargs-spec.md | 39 - .../other-new-features/named-typeargs.md | 33 - .../other-new-features/opaques-details.md | 123 --- .../other-new-features/opaques.md | 169 ---- .../other-new-features/open-classes.md | 82 -- .../parameter-untupling-spec.md | 88 -- .../other-new-features/parameter-untupling.md | 48 - .../other-new-features/safe-initialization.md | 246 ------ .../other-new-features/targetName.md | 122 --- .../threadUnsafe-annotation.md | 20 - .../other-new-features/trait-parameters.md | 90 -- .../other-new-features/transparent-traits.md | 72 -- .../other-new-features/type-test.md | 183 ---- _scala3-reference/overview.md | 155 ---- _scala3-reference/soft-modifier.md | 27 - _scala3-reference/syntax.md | 447 ---------- _sips/minutes/2019-12-18-sip-minutes.md | 2 +- _sips/sips/2017-09-20-opaque-types.md | 2 +- _zh-cn/index.md | 2 +- index.md | 2 +- scala3/contribute-to-docs.md | 6 +- scala3/index.md | 2 +- scala3/reference/README.md | 6 + 145 files changed, 64 insertions(+), 13935 deletions(-) delete mode 100644 _scala3-reference/changed-features.md delete mode 100644 _scala3-reference/changed-features/compiler-plugins.md delete mode 100644 _scala3-reference/changed-features/eta-expansion-spec.md delete mode 100644 _scala3-reference/changed-features/eta-expansion.md delete mode 100644 _scala3-reference/changed-features/implicit-conversions-spec.md delete mode 100644 _scala3-reference/changed-features/implicit-conversions.md delete mode 100644 _scala3-reference/changed-features/implicit-resolution.md delete mode 100644 _scala3-reference/changed-features/imports.md delete mode 100644 _scala3-reference/changed-features/interpolation-escapes.md delete mode 100644 _scala3-reference/changed-features/lazy-vals-init.md delete mode 100644 _scala3-reference/changed-features/main-functions.md delete mode 100644 _scala3-reference/changed-features/match-syntax.md delete mode 100644 _scala3-reference/changed-features/numeric-literals.md delete mode 100644 _scala3-reference/changed-features/operators.md delete mode 100644 _scala3-reference/changed-features/overload-resolution.md delete mode 100644 _scala3-reference/changed-features/pattern-bindings.md delete mode 100644 _scala3-reference/changed-features/pattern-matching.md delete mode 100644 _scala3-reference/changed-features/structural-types-spec.md delete mode 100644 _scala3-reference/changed-features/structural-types.md delete mode 100644 _scala3-reference/changed-features/type-checking.md delete mode 100644 _scala3-reference/changed-features/type-inference.md delete mode 100644 _scala3-reference/changed-features/vararg-splices.md delete mode 100644 _scala3-reference/changed-features/wildcards.md delete mode 100644 _scala3-reference/contextual.md delete mode 100644 _scala3-reference/contextual/by-name-context-parameters.md delete mode 100644 _scala3-reference/contextual/context-bounds.md delete mode 100644 _scala3-reference/contextual/context-functions-spec.md delete mode 100644 _scala3-reference/contextual/context-functions.md delete mode 100644 _scala3-reference/contextual/conversions.md delete mode 100644 _scala3-reference/contextual/derivation-macro.md delete mode 100644 _scala3-reference/contextual/derivation.md delete mode 100644 _scala3-reference/contextual/extension-methods.md delete mode 100644 _scala3-reference/contextual/given-imports.md delete mode 100644 _scala3-reference/contextual/givens.md delete mode 100644 _scala3-reference/contextual/multiversal-equality.md delete mode 100644 _scala3-reference/contextual/relationship-implicits.md delete mode 100644 _scala3-reference/contextual/right-associative-extension-methods.md delete mode 100644 _scala3-reference/contextual/type-classes.md delete mode 100644 _scala3-reference/contextual/using-clauses.md delete mode 100644 _scala3-reference/dropped-features.md delete mode 100644 _scala3-reference/dropped-features/auto-apply.md delete mode 100644 _scala3-reference/dropped-features/class-shadowing-spec.md delete mode 100644 _scala3-reference/dropped-features/class-shadowing.md delete mode 100644 _scala3-reference/dropped-features/delayed-init.md delete mode 100644 _scala3-reference/dropped-features/do-while.md delete mode 100644 _scala3-reference/dropped-features/early-initializers.md delete mode 100644 _scala3-reference/dropped-features/existential-types.md delete mode 100644 _scala3-reference/dropped-features/limit22.md delete mode 100644 _scala3-reference/dropped-features/macros.md delete mode 100644 _scala3-reference/dropped-features/nonlocal-returns.md delete mode 100644 _scala3-reference/dropped-features/package-objects.md delete mode 100644 _scala3-reference/dropped-features/procedure-syntax.md delete mode 100644 _scala3-reference/dropped-features/symlits.md delete mode 100644 _scala3-reference/dropped-features/this-qualifier.md delete mode 100644 _scala3-reference/dropped-features/type-projection.md delete mode 100644 _scala3-reference/dropped-features/weak-conformance-spec.md delete mode 100644 _scala3-reference/dropped-features/weak-conformance.md delete mode 100644 _scala3-reference/dropped-features/wildcard-init.md delete mode 100644 _scala3-reference/dropped-features/xml.md delete mode 100644 _scala3-reference/enums.md delete mode 100644 _scala3-reference/enums/adts.md delete mode 100644 _scala3-reference/enums/desugarEnums.md delete mode 100644 _scala3-reference/enums/enums.md delete mode 100644 _scala3-reference/experimental/canthrow.md delete mode 100644 _scala3-reference/experimental/erased-defs-spec.md delete mode 100644 _scala3-reference/experimental/erased-defs.md delete mode 100644 _scala3-reference/features-classification.md delete mode 100644 _scala3-reference/language-versions.md delete mode 100644 _scala3-reference/language-versions/binary-compatibility.md delete mode 100644 _scala3-reference/language-versions/source-compatibility.md delete mode 100644 _scala3-reference/metaprogramming.md delete mode 100644 _scala3-reference/metaprogramming/compiletime-ops.md delete mode 100644 _scala3-reference/metaprogramming/inline.md delete mode 100644 _scala3-reference/metaprogramming/macros-spec.md delete mode 100644 _scala3-reference/metaprogramming/macros.md delete mode 100644 _scala3-reference/metaprogramming/reflection.md delete mode 100644 _scala3-reference/metaprogramming/simple-smp.md delete mode 100644 _scala3-reference/metaprogramming/staging.md delete mode 100644 _scala3-reference/metaprogramming/tasty-inspect.md delete mode 100644 _scala3-reference/new-types.md delete mode 100644 _scala3-reference/new-types/dependent-function-types-spec.md delete mode 100644 _scala3-reference/new-types/dependent-function-types.md delete mode 100644 _scala3-reference/new-types/intersection-types-spec.md delete mode 100644 _scala3-reference/new-types/intersection-types.md delete mode 100644 _scala3-reference/new-types/match-types.md delete mode 100644 _scala3-reference/new-types/polymorphic-function-types.md delete mode 100644 _scala3-reference/new-types/type-lambdas-spec.md delete mode 100644 _scala3-reference/new-types/type-lambdas.md delete mode 100644 _scala3-reference/new-types/union-types-spec.md delete mode 100644 _scala3-reference/new-types/union-types.md delete mode 100644 _scala3-reference/other-new-features.md delete mode 100644 _scala3-reference/other-new-features/control-syntax.md delete mode 100644 _scala3-reference/other-new-features/creator-applications.md delete mode 100644 _scala3-reference/other-new-features/explicit-nulls.md delete mode 100644 _scala3-reference/other-new-features/export.md delete mode 100644 _scala3-reference/other-new-features/indentation-experimental.md delete mode 100644 _scala3-reference/other-new-features/indentation.md delete mode 100644 _scala3-reference/other-new-features/kind-polymorphism.md delete mode 100644 _scala3-reference/other-new-features/matchable.md delete mode 100644 _scala3-reference/other-new-features/named-typeargs-spec.md delete mode 100644 _scala3-reference/other-new-features/named-typeargs.md delete mode 100644 _scala3-reference/other-new-features/opaques-details.md delete mode 100644 _scala3-reference/other-new-features/opaques.md delete mode 100644 _scala3-reference/other-new-features/open-classes.md delete mode 100644 _scala3-reference/other-new-features/parameter-untupling-spec.md delete mode 100644 _scala3-reference/other-new-features/parameter-untupling.md delete mode 100644 _scala3-reference/other-new-features/safe-initialization.md delete mode 100644 _scala3-reference/other-new-features/targetName.md delete mode 100644 _scala3-reference/other-new-features/threadUnsafe-annotation.md delete mode 100644 _scala3-reference/other-new-features/trait-parameters.md delete mode 100644 _scala3-reference/other-new-features/transparent-traits.md delete mode 100644 _scala3-reference/other-new-features/type-test.md delete mode 100644 _scala3-reference/overview.md delete mode 100644 _scala3-reference/soft-modifier.md delete mode 100644 _scala3-reference/syntax.md create mode 100644 scala3/reference/README.md diff --git a/_config.yml b/_config.yml index accb4b5df1..35bcc57abf 100644 --- a/_config.yml +++ b/_config.yml @@ -45,8 +45,6 @@ collections: getting-started: output: true permalink: /:collection/:path.html - scala3-reference: # not really a collection, but this is the only way I found to be able to generate the navigation bar on the right - output: true ja: # Japanese translations output: true permalink: /:collection/:path.html @@ -152,16 +150,6 @@ defaults: overview-name: "Scaladoc" layout: multipage-overview permalink: "/scala3/guides/scaladoc/:title.html" - - - scope: - path: "_scala3-reference" - values: - scala3: true - partof: scala3-reference - type: section - overview-name: "Scala 3 Language Reference" - layout: multipage-overview - permalink: "/scala3/reference/:path.html" - scope: path: "scala3" @@ -172,7 +160,7 @@ defaults: highlighter: rouge permalink: /:categories/:title.html:output_ext baseurl: -scala3ref: "/scala3/reference" +scala3ref: "https://docs.scala-lang.org/scala3/reference" exclude: ["vendor"] plugins: - jekyll-redirect-from diff --git a/_data/scala3-doc-nav-header.yml b/_data/scala3-doc-nav-header.yml index 4b2201d17f..3493bd4de3 100644 --- a/_data/scala3-doc-nav-header.yml +++ b/_data/scala3-doc-nav-header.yml @@ -17,7 +17,7 @@ - title: Guides url: '/scala3/guides.html' - title: Language Specification - url: "/scala3/reference/overview.html" + url: "https://docs.scala-lang.org/scala3/reference" - title: Scala Library API url: "https://scala-lang.org/api/3.x/" - title: Contributing Guide diff --git a/_ja/index.md b/_ja/index.md index a64b13546e..9fa0201200 100644 --- a/_ja/index.md +++ b/_ja/index.md @@ -40,7 +40,7 @@ scala3-sections: - title: "Language Reference" description: "Scala 3 の言語仕様" icon: "fa fa-book" - link: /scala3/reference/overview.html + link: https://docs.scala-lang.org/scala3/reference scala2-sections: diff --git a/_ja/scala3/contribute-to-docs.md b/_ja/scala3/contribute-to-docs.md index c13b4b0904..74023f6f7d 100644 --- a/_ja/scala3/contribute-to-docs.md +++ b/_ja/scala3/contribute-to-docs.md @@ -53,9 +53,9 @@ Scala 3 コンパイラとライブラリへの貢献と内部に関する包括 - [Issues](https://github.com/scala/docs.scala-lang/issues) ## Scala 3 Language Reference -The [Dotty reference](/scala3/reference/overview.html) は Scala 3 になる予定である。これにはさまざまな言語仕様に関する公式のプレゼンテーションや技術的情報が含まれている。 +The [Dotty reference]({{ site.scala3ref }}/overview.html) は Scala 3 になる予定である。これにはさまざまな言語仕様に関する公式のプレゼンテーションや技術的情報が含まれている。 -- [Sources](https://github.com/lampepfl/dotty/tree/master/docs/docs/reference) +- [Sources](https://github.com/lampepfl/dotty/tree/main/docs/_docs) - [Issues](https://github.com/lampepfl/dotty/issues) diff --git a/_ja/scala3/index.md b/_ja/scala3/index.md index 8ad7fbabf2..5940a8babb 100644 --- a/_ja/scala3/index.md +++ b/_ja/scala3/index.md @@ -40,5 +40,5 @@ sections: - title: "Language Reference" description: "Scala 3 の言語仕様" icon: "fa fa-book" - link: /scala3/reference/overview.html + link: https://docs.scala-lang.org/scala3/reference --- \ No newline at end of file diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index fe4b457451..3cbbfcecb2 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -216,8 +216,8 @@ and a [summary with practical differences](https://tpolecat.github.io/2014/06/09 Note that in **Scala 3** the differences are fewer; for example, they will be able to -[accept implicit parameters](/scala3/reference/contextual/context-functions.html) -as well as [type parameters](/scala3/reference/new-types/polymorphic-function-types.html). +[accept implicit parameters]({{ site.scala3ref }}/contextual/context-functions.html) +as well as [type parameters]({{ site.scala3ref }}/new-types/polymorphic-function-types.html). Nevertheless, it is still recommended to use methods most of the time, unless you absolutely need a function. And, thanks to diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md index bbb43a9686..f99c81de92 100644 --- a/_overviews/contribute/add-guides.md +++ b/_overviews/contribute/add-guides.md @@ -257,4 +257,4 @@ above. Here is an example using the various modifiers. [why-contribute]: {% link contribute.md %} [home]: {% link index.md %} [overviews-index]: {% link _overviews/index.md %} -[scala-3-reference]: https://docs.scala-lang.org/scala3/reference/overview.html +[scala-3-reference]: {{ site.scala3ref }} diff --git a/_overviews/scala3-book/why-scala-3.md b/_overviews/scala3-book/why-scala-3.md index 53f0184685..3c5b7bbc7a 100644 --- a/_overviews/scala3-book/why-scala-3.md +++ b/_overviews/scala3-book/why-scala-3.md @@ -427,10 +427,10 @@ Hopefully you’ll discover more great Scala features as you use the language. [java]: {% link _overviews/scala3-book/interacting-with-java.md %} [given]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} [contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} -[reference]: {{ site.scala3ref }}/overview.html -[dropped]: https://docs.scala-lang.org/scala3/reference/dropped-features.html -[changed]: https://docs.scala-lang.org/scala3/reference/changed-features.html -[added]: https://docs.scala-lang.org/scala3/reference/other-new-features.html +[reference]: {{ site.scala3ref }} +[dropped]: {{ site.scala3ref }}/dropped-features.html +[changed]: {{ site.scala3ref }}/changed-features.html +[added]:{{ site.scala3ref }}/other-new-features.html [union-types]: {% link _overviews/scala3-book/types-union.md %} [opaque-types]: {% link _overviews/scala3-book/types-opaque-types.md %} diff --git a/_overviews/scala3-contribution/arch-lifecycle.md b/_overviews/scala3-contribution/arch-lifecycle.md index 9fe58e7a46..99e7c86d4b 100644 --- a/_overviews/scala3-contribution/arch-lifecycle.md +++ b/_overviews/scala3-contribution/arch-lifecycle.md @@ -88,7 +88,7 @@ tools // contains helpers and the `scala` generic runner [dotty.tools]: https://github.com/lampepfl/dotty/tree/master/compiler/src/dotty/tools [ScalaSettings]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/config/ScalaSettings.scala [phase-categories]: {% link _overviews/scala3-contribution/arch-phases.md %}#phase-categories -[syntax]: {% link _scala3-reference/syntax.md %} +[syntax]: {{ site.scala3ref }}/syntax.html [Main]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Main.scala [Driver]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Driver.scala [Compiler]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Compiler.scala diff --git a/_overviews/scala3-contribution/arch-phases.md b/_overviews/scala3-contribution/arch-phases.md index 235148fc5e..b4dff883cb 100644 --- a/_overviews/scala3-contribution/arch-phases.md +++ b/_overviews/scala3-contribution/arch-phases.md @@ -110,4 +110,4 @@ These map the transformed trees to Java classfiles or SJSIR files. [patternMatcher]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/PatternMatcher.scala [erasure]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/Erasure.scala [Mirror]: https://github.com/lampepfl/dotty/blob/master/library/src/scala/deriving/Mirror.scala -[PCP]: {% link _scala3-reference/metaprogramming/macros.md %}#the-phase-consistency-principle +[PCP]: {{ site.scala3ref }}/metaprogramming/macros.html#the-phase-consistency-principle diff --git a/_overviews/scala3-contribution/contribution-intro.md b/_overviews/scala3-contribution/contribution-intro.md index 283f65cfb5..66ed7cb7a2 100644 --- a/_overviews/scala3-contribution/contribution-intro.md +++ b/_overviews/scala3-contribution/contribution-intro.md @@ -22,7 +22,7 @@ on [GitHub](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3 `dotc` is built with Scala 3, fully utilising its [new features](/scala3/new-in-scala3.html). It is recommended that you first have some familiarity with Scala 3 -to get the most out of this guide. You can learn more in the [language reference](/scala3/reference/overview.html). +to get the most out of this guide. You can learn more in the [language reference]({{ site.scala3ref}}). Many code snippets in this guide make use of shell commands (a line beginning with `$`), and in this case a `bash` compatible shell is assumed. You may have to look up how to translate commands to your shell. diff --git a/_overviews/scala3-macros/other-resources.md b/_overviews/scala3-macros/other-resources.md index 476f901b08..23a48463cb 100644 --- a/_overviews/scala3-macros/other-resources.md +++ b/_overviews/scala3-macros/other-resources.md @@ -9,7 +9,7 @@ num: 9 * [Migration status][migration-status] ## Dotty documentation -- [Dotty Documentation](/scala3/reference/metaprogramming.html) +- [Dotty Documentation]({{ site.scala3ref }}/metaprogramming.html) - [Macros: The Plan For Scala 3](https://www.scala-lang.org/blog/2018/04/30/in-a-nutshell.html) - [Examples](https://github.com/lampepfl/dotty-macro-examples) - a repository with small, self-contained examples of various tasks done with Dotty macros. diff --git a/_overviews/scala3-macros/tutorial/inline.md b/_overviews/scala3-macros/tutorial/inline.md index 30c445cef0..e27d610b18 100644 --- a/_overviews/scala3-macros/tutorial/inline.md +++ b/_overviews/scala3-macros/tutorial/inline.md @@ -499,7 +499,7 @@ def powerCode(x: Expr[Double], n: Expr[Int])(using Quotes): Expr[Double] = ... ``` -[soft-modifier]: {% link _scala3-reference/soft-modifier.md %} +[soft-modifier]: {{ site.scala3ref }}/soft-modifier.html [contributing]: {% link scala3/contribute-to-docs.md %} [best-practices]: {% link _overviews/scala3-macros/best-practices.md %} diff --git a/_overviews/scala3-migration/compatibility-classpath.md b/_overviews/scala3-migration/compatibility-classpath.md index b1374f6474..ba825a4411 100644 --- a/_overviews/scala3-migration/compatibility-classpath.md +++ b/_overviews/scala3-migration/compatibility-classpath.md @@ -63,30 +63,30 @@ The second piece of good news is that the Scala 2.13 TASTy reader, which enables ### Supported Features The TASTy reader supports all the traditional language features as well as the following brand-new features: -- [Enumerations]({% link _scala3-reference/enums/enums.md %}) -- [Intersection Types]({% link _scala3-reference/new-types/intersection-types.md %}) -- [Opaque Type Aliases]({% link _scala3-reference/other-new-features/opaques.md %}) -- [Type Lambdas]({% link _scala3-reference/new-types/type-lambdas.md %}) -- [Contextual Abstractions]({% link _scala3-reference/contextual.md %}) (new syntax) -- [Open Classes]({% link _scala3-reference/other-new-features/open-classes.md %}) (and inheritance of super traits) -- [Export Clauses]({% link _scala3-reference/other-new-features/export.md %}) +- [Enumerations]({{ site.scala3ref }}/enums/enums.html) +- [Intersection Types]({{ site.scala3ref }}/new-types/intersection-types.html) +- [Opaque Type Aliases]({{ site.scala3ref }}/other-new-features/opaques.html) +- [Type Lambdas]({{ site.scala3ref }}/new-types/type-lambdas.html) +- [Contextual Abstractions]({{ site.scala3ref }}/contextual.html) (new syntax) +- [Open Classes]({{ site.scala3ref }}/other-new-features/open-classes.html) (and inheritance of super traits) +- [Export Clauses]({{ site.scala3ref }}/other-new-features/export.html) We have limited support on: -- [Top-Level Definitions]({% link _scala3-reference/dropped-features/package-objects.md %}) -- [Extension Methods]({% link _scala3-reference/contextual/extension-methods.md %}) +- [Top-Level Definitions]({{ site.scala3ref }}/dropped-features/package-objects.html) +- [Extension Methods]({{ site.scala3ref }}/contextual/extension-methods.html) More exotic features are not supported: -- [Context Functions]({% link _scala3-reference/contextual/context-functions.md %}) -- [Polymorphic Function Types]({% link _scala3-reference/new-types/polymorphic-function-types.md %}) -- [Trait Parameters]({% link _scala3-reference/other-new-features/trait-parameters.md %}) +- [Context Functions]({{ site.scala3ref }}/contextual/context-functions.html) +- [Polymorphic Function Types]({{ site.scala3ref }}/new-types/polymorphic-function-types.html) +- [Trait Parameters]({{ site.scala3ref }}/other-new-features/trait-parameters.html) - `@static` Annotation - `@alpha` Annotation -- [Functions and Tuples larger than 22 parameters]({% link _scala3-reference/dropped-features/limit22.md %}) -- [Match Types]({% link _scala3-reference/new-types/match-types.md %}) -- [Union Types]({% link _scala3-reference/new-types/union-types.md %}) -- [Multiversal Equality]({% link _scala3-reference/contextual/multiversal-equality.md %}) (unless explicit) -- [Inline]({% link _scala3-reference/metaprogramming/inline.md %}) (including Scala 3 macros) -- [Kind Polymorphism]({% link _scala3-reference/other-new-features/kind-polymorphism.md %}) (the `scala.AnyKind` upper bound) +- [Functions and Tuples larger than 22 parameters]({{ site.scala3ref }}/dropped-features/limit22.html) +- [Match Types]({{ site.scala3ref }}/new-types/match-types.html) +- [Union Types]({{ site.scala3ref }}/new-types/union-types.html) +- [Multiversal Equality]({{ site.scala3ref }}/contextual/multiversal-equality.html) (unless explicit) +- [Inline]({{ site.scala3ref }}/metaprogramming/inline.html) (including Scala 3 macros) +- [Kind Polymorphism]({{ site.scala3ref }}/other-new-features/kind-polymorphism.html) (the `scala.AnyKind` upper bound) ### A Scala 2.13 module can depend on a Scala 3 artifact diff --git a/_overviews/scala3-migration/compatibility-metaprogramming.md b/_overviews/scala3-migration/compatibility-metaprogramming.md index c8d7ae25db..6b0e55b537 100644 --- a/_overviews/scala3-migration/compatibility-metaprogramming.md +++ b/_overviews/scala3-migration/compatibility-metaprogramming.md @@ -56,7 +56,7 @@ Before getting deep into reimplementing a macro you should ask yourself: - Can I use `inline` and the `scala.compiletime` operations to reimplement my logic? - Can I use the simpler and safer expression based macros? - Do I really need to access the AST? -- Can I use a [match type](/scala3/reference/new-types/match-types.html) as return type? +- Can I use a [match type]({{ site.scala3ref }}/new-types/match-types.html) as return type? You can learn all the new metaprogramming concepts by reading the [Macro Tutorial][scala3-macros]. diff --git a/_overviews/scala3-migration/incompat-contextual-abstractions.md b/_overviews/scala3-migration/incompat-contextual-abstractions.md index e215fff469..6538c3baf0 100644 --- a/_overviews/scala3-migration/incompat-contextual-abstractions.md +++ b/_overviews/scala3-migration/incompat-contextual-abstractions.md @@ -7,7 +7,7 @@ previous-page: incompat-dropped-features next-page: incompat-other-changes --- -The redesign of [contextual abstractions]({% link _scala3-reference/contextual.md %}) brings some incompatibilities. +The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual.html) brings some incompatibilities. |Incompatibility|Scala 2.13|Scala 3 Migration Rewrite|Scalafix Rule|Runtime Incompatibiltiy| |--- |--- |--- |--- |--- | diff --git a/_overviews/scala3-migration/incompat-dropped-features.md b/_overviews/scala3-migration/incompat-dropped-features.md index eef4ce46a3..26e4d84ced 100644 --- a/_overviews/scala3-migration/incompat-dropped-features.md +++ b/_overviews/scala3-migration/incompat-dropped-features.md @@ -47,7 +47,7 @@ You are recommended, as a second step, to replace every use of `Symbol` with a p ## `do`-`while` construct -The `do` keyword has acquired a different meaning in the [New Control Syntax]({% link _scala3-reference/other-new-features/control-syntax.md %}). +The `do` keyword has acquired a different meaning in the [New Control Syntax]({{ site.scala3ref }}/other-new-features/control-syntax.html). To avoid confusion, the traditional `do while ()` construct is dropped. It is recommended to use the equivalent `while ({ ; }) ()` that can be cross-compiled, or the new Scala 3 syntax `while { ; } do ()`. @@ -94,11 +94,11 @@ object Hello { +println(Hello.message()) {% endhighlight %} -Auto-application is covered in detail in [this page](/scala3/reference/dropped-features/auto-apply.html) of the Scala 3 reference documentation. +Auto-application is covered in detail in [this page]({{ site.scala3ref }}/dropped-features/auto-apply.html) of the Scala 3 reference documentation. ## Value eta-expansion -Scala 3 introduces [Automatic Eta-Expansion](/scala3/reference/changed-features/eta-expansion-spec.html) which will deprecate the method to value syntax `m _`. +Scala 3 introduces [Automatic Eta-Expansion]({{ site.scala3ref }}/changed-features/eta-expansion-spec.html) which will deprecate the method to value syntax `m _`. Furthermore Scala 3 does not allow eta-expansion of values to nullary functions anymore. Thus, this piece of code is invalid in Scala 3: @@ -138,7 +138,7 @@ This rewrite can be applied by the `fix.scala213.Any2StringAdd` Scalafix rule in ## Early Initializer Early initializers are deprecated in Scala 2.13 and dropped in Scala 3. -They were rarely used, and mostly to compensate for the lack of [Trait parameters](/scala3/reference/other-new-features/trait-parameters.html) which are now supported in Scala 3. +They were rarely used, and mostly to compensate for the lack of [Trait parameters]({{ site.scala3ref }}/other-new-features/trait-parameters.html) which are now supported in Scala 3. That is why the following piece of code does not compile anymore. @@ -198,7 +198,7 @@ class Fizz private (val name: String) extends Bar { ## Existential Type -Existential type is a [dropped feature](/scala3/reference/dropped-features/existential-types.html), which makes the following code invalid. +Existential type is a [dropped feature]({{ site.scala3ref }}/dropped-features/existential-types.html), which makes the following code invalid. ```scala def foo: List[Class[T]] forSome { type T } // Error: Existential types are no longer supported diff --git a/_overviews/scala3-migration/incompat-other-changes.md b/_overviews/scala3-migration/incompat-other-changes.md index 8fc2ae4402..505df8c17f 100644 --- a/_overviews/scala3-migration/incompat-other-changes.md +++ b/_overviews/scala3-migration/incompat-other-changes.md @@ -151,7 +151,7 @@ fooCtr.tupled((2, false)) In Scala, case classes have an auto-generated extractor method, called `unapply` in their companion object. Its signature has changed between Scala 2.13 and Scala 3. -The new signature is option-less (see the new [Pattern Matching](/scala3/reference/changed-features/pattern-matching.html) reference), which causes an incompatibility when `unapply` is called explicitly. +The new signature is option-less (see the new [Pattern Matching]({{ site.scala3ref }}/changed-features/pattern-matching.html) reference), which causes an incompatibility when `unapply` is called explicitly. Note that this problem does not affect user-defined extractors, whose signature stays the same across Scala versions. diff --git a/_overviews/scala3-migration/incompat-type-inference.md b/_overviews/scala3-migration/incompat-type-inference.md index e279a440ec..387bc918c7 100644 --- a/_overviews/scala3-migration/incompat-type-inference.md +++ b/_overviews/scala3-migration/incompat-type-inference.md @@ -65,7 +65,7 @@ class Child extends Parent { ## Reflective Type -Scala 2 reflective calls are dropped and replaced by the broader [Programmatic Structural Types](/scala3/reference/changed-features/structural-types.html). +Scala 2 reflective calls are dropped and replaced by the broader [Programmatic Structural Types]({{ site.scala3ref }}/changed-features/structural-types.html). Scala 3 can imitate Scala 2 reflective calls by making `scala.reflect.Selectable.reflectiveSelectable` available wherever `scala.language.reflectiveCalls` is imported. However the Scala 3 compiler does not infer structural types by default, and thus fails at compiling: diff --git a/_overviews/scala3-migration/incompatibility-table.md b/_overviews/scala3-migration/incompatibility-table.md index e699addbfe..3783ac8d3f 100644 --- a/_overviews/scala3-migration/incompatibility-table.md +++ b/_overviews/scala3-migration/incompatibility-table.md @@ -59,7 +59,7 @@ Some features are dropped to simplify the language. ### Contextual Abstractions -The redesign of [contextual abstractions]({% link _scala3-reference/contextual.md %}) brings some well defined incompatibilities. +The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual.html) brings some well defined incompatibilities. |Incompatibility|Scala 2.13|Scala 3 Migration Rewrite|Scalafix Rule|Runtime Incompatibility| |--- |--- |--- |--- |--- | @@ -69,7 +69,7 @@ The redesign of [contextual abstractions]({% link _scala3-reference/contextual.m |[Ambiguous conversion on `A` and `=> A`](incompat-contextual-abstractions.html#ambiguous-conversion-on-a-and--a)||||| Furthermore we have changed the implicit resolution rules so that they are more useful and less surprising. -The new rules are described [here](/scala3/reference/changed-features/implicit-resolution.html). +The new rules are described [here]({{ site.scala3ref }}/changed-features/implicit-resolution.html). Because of these changes, the Scala 3 compiler could possibly fail at resolving some implicit parameters of existing Scala 2.13 code. diff --git a/_overviews/scala3-migration/plugin-kind-projector.md b/_overviews/scala3-migration/plugin-kind-projector.md index 8557cdb559..471657b488 100644 --- a/_overviews/scala3-migration/plugin-kind-projector.md +++ b/_overviews/scala3-migration/plugin-kind-projector.md @@ -100,7 +100,7 @@ type MyLambda[F[_], A] = EitherT[F, Int, A] MyLambda ``` -Alternatively you may use Scala 3's [Native Type Lambdas](https://docs.scala-lang.org/scala3/reference/new-types/type-lambdas.html) if you do not need to cross-compile: +Alternatively you may use Scala 3's [Native Type Lambdas]({{ site.scala3ref }}/new-types/type-lambdas.html) if you do not need to cross-compile: ```scala [F[_], A] =>> EitherT[F, Int, A] diff --git a/_overviews/scala3-migration/tooling-syntax-rewriting.md b/_overviews/scala3-migration/tooling-syntax-rewriting.md index bbe246aa1e..67898458e6 100644 --- a/_overviews/scala3-migration/tooling-syntax-rewriting.md +++ b/_overviews/scala3-migration/tooling-syntax-rewriting.md @@ -13,7 +13,7 @@ Both are optional so that the Scala 2 code style is still perfectly valid in Sca The new syntax for control structures makes it possible to write the condition of an `if`-expression, the condition of a `while`-loop or the generators of a `for`-expression without enclosing parentheses. The significant indentation syntax makes braces `{...}` not needed in many occurences: class and method bodies, `if`-expressions, `match`-expressions and more. -You can find a complete description in the [Optional Braces](https://docs.scala-lang.org/scala3/reference/other-new-features/indentation.html) page of the Scala 3 reference website. +You can find a complete description in the [Optional Braces]({{ site.scala3ref }}/other-new-features/indentation.html) page of the Scala 3 reference website. Converting existing Scala code to the new syntax by hand is tedious and error-prone. In this chapter we show how you can use the compiler to rewrite your code automatically from the classic Scala 2 style to the new style, or conversely. diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index d490f82043..c7f7935ac3 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -160,7 +160,7 @@ compile - Enables snippet checking. nocompile - Disables snippet checking. fail - Enables snippet checking, asserts that snippet doesn't compile. -The fail flag comes in handy for snippets that present that some action would eventually fail during compilation, e. g. [Opaques page]({% link _scala3-reference/other-new-features/opaques.md %}) +The fail flag comes in handy for snippets that present that some action would eventually fail during compilation, e. g. [Opaques page]({{ site.scala3ref }}/other-new-features/opaques.html) Example usage: diff --git a/_scala3-reference/changed-features.md b/_scala3-reference/changed-features.md deleted file mode 100644 index c23a9031be..0000000000 --- a/_scala3-reference/changed-features.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: "Other Changed Features" -type: chapter -num: 51 -previous-page: /scala3/reference/other-new-features/type-test -next-page: /scala3/reference/changed-features/numeric-literals ---- - -The following pages document the features that have changed in Scala 3, compared to Scala 2. diff --git a/_scala3-reference/changed-features/compiler-plugins.md b/_scala3-reference/changed-features/compiler-plugins.md deleted file mode 100644 index 39358b4e8c..0000000000 --- a/_scala3-reference/changed-features/compiler-plugins.md +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: "Changes in Compiler Plugins" -type: section -num: 67 -previous-page: /scala3/reference/changed-features/eta-expansion -next-page: /scala3/reference/changed-features/lazy-vals-init ---- - -Compiler plugins are supported by Dotty (and Scala 3) since 0.9. There are two notable changes -compared to `scalac`: - -- No support for analyzer plugins -- Added support for research plugins - -[Analyzer plugins][1] in `scalac` run during type checking and may influence -normal type checking. This is a very powerful feature but for production usages, -a predictable and consistent type checker is more important. - -For experimentation and research, Scala 3 introduces _research plugin_. Research plugins -are more powerful than `scalac` analyzer plugins as they let plugin authors customize -the whole compiler pipeline. One can easily replace the standard typer by a custom one or -create a parser for a domain-specific language. However, research plugins are only -enabled for nightly or snaphot releases of Scala 3. - -Common plugins that add new phases to the compiler pipeline are called -_standard plugins_ in Scala 3. In terms of features, they are similar to -`scalac` plugins, despite minor changes in the API. - -## Using Compiler Plugins - -Both standard and research plugins can be used with `scalac` by adding the `-Xplugin:` option: - -```shell -scalac -Xplugin:pluginA.jar -Xplugin:pluginB.jar Test.scala -``` - -The compiler will examine the jar provided, and look for a property file named -`plugin.properties` in the root directory of the jar. The property file specifies -the fully qualified plugin class name. The format of a property file is as follows: - -```properties -pluginClass=dividezero.DivideZero -``` - -This is different from `scalac` plugins that required a `scalac-plugin.xml` file. - -Starting from 1.1.5, `sbt` also supports Scala 3 compiler plugins. Please refer to the -[`sbt` documentation][2] for more information. - -## Writing a Standard Compiler Plugin - -Here is the source code for a simple compiler plugin that reports integer divisions by -zero as errors. - -```scala -package dividezero - -import dotty.tools.dotc.ast.Trees.* -import dotty.tools.dotc.ast.tpd -import dotty.tools.dotc.report -import dotty.tools.dotc.core.Constants.Constant -import dotty.tools.dotc.core.Contexts.Context -import dotty.tools.dotc.core.Decorators.* -import dotty.tools.dotc.core.StdNames.* -import dotty.tools.dotc.core.Symbols.* -import dotty.tools.dotc.plugins.{PluginPhase, StandardPlugin} -import dotty.tools.dotc.transform.{Pickler, Staging} - -class DivideZero extends StandardPlugin: - val name: String = "divideZero" - override val description: String = "divide zero check" - - def init(options: List[String]): List[PluginPhase] = - (new DivideZeroPhase) :: Nil - -class DivideZeroPhase extends PluginPhase: - import tpd.* - - val phaseName = "divideZero" - - override val runsAfter = Set(Pickler.name) - override val runsBefore = Set(Staging.name) - - override def transformApply(tree: Apply)(implicit ctx: Context): Tree = - tree match - case Apply(Select(rcvr, nme.DIV), List(Literal(Constant(0)))) - if rcvr.tpe <:< defn.IntType => - report.error("dividing by zero", tree.srcPos) - case _ => - () - tree -end DivideZeroPhase -``` - -The plugin main class (`DivideZero`) must extend the trait `StandardPlugin` -and implement the method `init` that takes the plugin's options as argument -and returns a list of `PluginPhase`s to be inserted into the compilation pipeline. - -Our plugin adds one compiler phase to the pipeline. A compiler phase must extend -the `PluginPhase` trait. In order to specify when the phase is executed, we also -need to specify a `runsBefore` and `runsAfter` constraints that are list of phase -names. - -We can now transform trees by overriding methods like `transformXXX`. - -## Writing a Research Compiler Plugin - -Here is a template for research plugins. - -```scala -import dotty.tools.dotc.core.Contexts.Context -import dotty.tools.dotc.core.Phases.Phase -import dotty.tools.dotc.plugins.ResearchPlugin - -class DummyResearchPlugin extends ResearchPlugin: - val name: String = "dummy" - override val description: String = "dummy research plugin" - - def init(options: List[String], phases: List[List[Phase]])(implicit ctx: Context): List[List[Phase]] = - phases -end DummyResearchPlugin -``` - -A research plugin must extend the trait `ResearchPlugin` and implement the -method `init` that takes the plugin's options as argument as well as the compiler -pipeline in the form of a list of compiler phases. The method can replace, remove -or add any phases to the pipeline and return the updated pipeline. - - -[1]: https://github.com/scala/scala/blob/2.13.x/src/compiler/scala/tools/nsc/typechecker/AnalyzerPlugins.scala -[2]: https://www.scala-sbt.org/1.x/docs/Compiler-Plugins.html diff --git a/_scala3-reference/changed-features/eta-expansion-spec.md b/_scala3-reference/changed-features/eta-expansion-spec.md deleted file mode 100644 index 78d021003c..0000000000 --- a/_scala3-reference/changed-features/eta-expansion-spec.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Automatic Eta Expansion - More Details" ---- - -## Motivation - -Scala maintains a convenient distinction between _methods_ and _functions_. -Methods are part of the definition of a class that can be invoked in objects while functions are complete objects themselves, making them first-class entities. For example, they can be assigned to variables. -These two mechanisms are bridged in Scala by a mechanism called -[_eta-expansion_](https://www.scala-lang.org/files/archive/spec/2.13/06-expressions.html#eta-expansion-section) -(also called eta-abstraction), which converts a reference to a method into a function. Intuitively, a method `m` can be passed around by turning it into an object: the function `x => m(x)`. - -In this snippet which assigns a method to a `val`, the compiler will perform _automatic eta-expansion_, as shown in the comment: - -```scala -def m(x: Int, y: String) = ??? -val f = m // becomes: val f = (x: Int, y: String) => m(x, y) -``` - -In Scala 2, a method reference `m` is converted to a function value only if the expected type is a function type, which means the conversion in the example above would not have been triggered, because `val f` does not have a type ascription. To still get eta-expansion, a shortcut `m _` would force the conversion. - -For methods with one or more parameters like in the example above, this restriction has now been dropped. The syntax `m _` is no longer needed and will be deprecated in the future. - -## Automatic eta-expansion and partial application -In the following example `m` can be partially applied to the first two parameters. -Assigning `m` to `f1` will automatically eta-expand. - -```scala -def m(x: Boolean, y: String)(z: Int): List[Int] -val f1 = m -val f2 = m(true, "abc") -``` - -This creates two function values: - -```scala -f1: (Boolean, String) => Int => List[Int] -f2: Int => List[Int] -``` - -## Automatic eta-expansion and implicit parameter lists - -Methods with implicit parameter lists will always get applied to implicit arguments. - -```scala -def foo(x: Int)(implicit p: Double): Float = ??? -implicit val bla: Double = 1.0 - -val bar = foo // val bar: Int => Float = ... -``` - -## Automatic Eta-Expansion and query types - -A method with context parameters can be expanded to a value of a context type by writing the expected context type explicitly. - -```scala -def foo(x: Int)(using p: Double): Float = ??? -val bar: Double ?=> Float = foo(3) -``` - -## Rules - -- If `m` has an argument list with one or more parameters, we always eta-expand -- If `m` is has an empty argument list (i.e. has type `()R`): - 1. If the expected type is of the form `() => T`, we eta expand. - 2. If m is defined by Java, or overrides a Java defined method, we insert `()`. - 3. Otherwise we issue an error of the form: - -Thus, an unapplied method with an empty argument list is only converted to a function when a function type is expected. It is considered best practice to either explicitly apply the method to `()`, or convert it to a function with `() => m()`. - -The method value syntax `m _` is deprecated. - -## Reference - -For more information, see [PR #2701](https://github.com/lampepfl/dotty/pull/2701). diff --git a/_scala3-reference/changed-features/eta-expansion.md b/_scala3-reference/changed-features/eta-expansion.md deleted file mode 100644 index 91516edca5..0000000000 --- a/_scala3-reference/changed-features/eta-expansion.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: "Automatic Eta Expansion" -type: section -num: 66 -previous-page: /scala3/reference/changed-features/pattern-matching -next-page: /scala3/reference/changed-features/compiler-plugins ---- - -The conversion of _methods_ into _functions_ has been improved and happens automatically for methods with one or more parameters. - -```scala -def m(x: Boolean, y: String)(z: Int): List[Int] -val f1 = m -val f2 = m(true, "abc") -``` - -This creates two function values: -```scala -f1: (Boolean, String) => Int => List[Int] -f2: Int => List[Int] -``` - -The syntax `m _` is no longer needed and will be deprecated in the future. - -## Automatic eta-expansion and nullary methods - -Automatic eta expansion does not apply to "nullary" methods that take an empty parameter list. - -```scala -def next(): T -``` - -Given a simple reference to `next` does not auto-convert to a function. -One has to write explicitly `() => next()` to achieve that. -Once again since the `_` is going to be deprecated it's better to write it this way -rather than `next _`. - -The reason for excluding nullary methods from automatic eta expansion -is that Scala implicitly inserts the `()` argument, which would -conflict with eta expansion. Automatic `()` insertion is -[limited](../dropped-features/auto-apply.html) in Scala 3, but the fundamental ambiguity -remains. - -[More details](eta-expansion-spec.html) diff --git a/_scala3-reference/changed-features/implicit-conversions-spec.md b/_scala3-reference/changed-features/implicit-conversions-spec.md deleted file mode 100644 index 32bb641dbf..0000000000 --- a/_scala3-reference/changed-features/implicit-conversions-spec.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Implicit Conversions - More Details" ---- - -## Implementation - -An implicit conversion, or _view_, from type `S` to type `T` is -defined by either: - -- An `implicit def` which has type `S => T` or `(=> S) => T` -- An implicit value which has type `Conversion[S, T]` - -The standard library defines an abstract class `Conversion`: - -```scala -package scala -@java.lang.FunctionalInterface -abstract class Conversion[-T, +U] extends Function1[T, U]: - def apply(x: T): U -``` - -Function literals are automatically converted to `Conversion` values. - -Views are applied in three situations: - -1. If an expression `e` is of type `T`, and `T` does not conform to - the expression's expected type `pt`. In this case, an implicit `v` - which is applicable to `e` and whose result type conforms to `pt` - is searched. The search proceeds as in the case of implicit - parameters, where the implicit scope is the one of `T => pt`. If - such a view is found, the expression `e` is converted to `v(e)`. -1. In a selection `e.m` with `e` of type `T`, if the selector `m` does - not denote an accessible member of `T`. In this case, a view `v` - which is applicable to `e` and whose result contains an accessible - member named `m` is searched. The search proceeds as in the case of - implicit parameters, where the implicit scope is the one of `T`. If - such a view is found, the selection `e.m` is converted to `v(e).m`. -1. In an application `e.m(args)` with `e` of type `T`, if the selector - `m` denotes some accessible member(s) of `T`, but none of these - members is applicable to the arguments `args`. In this case, a view - `v` which is applicable to `e` and whose result contains a method - `m` which is applicable to `args` is searched. The search proceeds - as in the case of implicit parameters, where the implicit scope is - the one of `T`. If such a view is found, the application - `e.m(args)` is converted to `v(e).m(args)`. - -# Differences with Scala 2 implicit conversions - -In Scala 2, views whose parameters are passed by-value take precedence -over views whose parameters are passed by-name. This is no longer the -case in Scala 3. A type error reporting the ambiguous conversions will -be emitted in cases where this rule would be applied in Scala 2: - -```scala -implicit def conv1(x: Int): String = x.toString -implicit def conv2(x: => Int): String = x.toString - -val x: String = 0 // Compiles in Scala2 (uses `conv1`), - // type error in Scala 3 because of ambiguity. -``` - -In Scala 2, implicit values of a function type would be considered as -potential views. In Scala 3, these implicit value need to have type -`Conversion`: - -```scala -// Scala 2: -def foo(x: Int)(implicit conv: Int => String): String = x - -// Becomes with Scala 3: -def foo(x: Int)(implicit conv: Conversion[Int, String]): String = x - -// Call site is unchanged: -foo(4)(_.toString) - -// Scala 2: -implicit val myConverter: Int => String = _.toString - -// Becomes with Scala 3: -implicit val myConverter: Conversion[Int, String] = _.toString -``` - -Note that implicit conversions are also affected by the [changes to implicit resolution](implicit-resolution.html) between Scala 2 and Scala 3. - -## Motivation for the changes - -The introduction of [`scala.Conversion`](https://github.com/lampepfl/dotty/blob/master/library/src/scala/Conversion.scala) -in Scala 3 and the decision to restrict implicit values of this type to be -considered as potential views comes from the desire to remove surprising -behavior from the language: - -```scala -implicit val m: Map[Int, String] = Map(1 -> "abc") - -val x: String = 1 // Scala 2: assigns "abc" to x - // Scala 3: type error -``` - -This snippet contains a type error. The right-hand side of `val x` -does not conform to type `String`. In Scala 2, the compiler will use -`m` as an implicit conversion from `Int` to `String`, whereas Scala 3 -will report a type error, because `Map` isn't an instance of -`Conversion`. - -## Migration path - -Implicit values that are used as views should see their type changed to `Conversion`. - -For the migration of implicit conversions that are affected by the -changes to implicit resolution, refer to the [Changes in Implicit Resolution](implicit-resolution.html) for more information. - -## Reference - -For more information about implicit resolution, see [Changes in Implicit Resolution](implicit-resolution.html). -Other details are available in [PR #2065](https://github.com/lampepfl/dotty/pull/2065). diff --git a/_scala3-reference/changed-features/implicit-conversions.md b/_scala3-reference/changed-features/implicit-conversions.md deleted file mode 100644 index 39b4cde31e..0000000000 --- a/_scala3-reference/changed-features/implicit-conversions.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: "Implicit Conversions" -type: section -num: 60 -previous-page: /scala3/reference/changed-features/implicit-resolution -next-page: /scala3/reference/changed-features/overload-resolution ---- - -An _implicit conversion_, also called _view_, is a conversion that -is applied by the compiler in several situations: - -1. When an expression `e` of type `T` is encountered, but the compiler - needs an expression of type `S`. -1. When an expression `e.m` where `e` has type `T` but `T` defines no - member `m` is encountered. - -In those cases, the compiler looks in the implicit scope for a -conversion that can convert an expression of type `T` to an expression -of type `S` (or to a type that defines a member `m` in the second -case). - -This conversion can be either: - -1. An `implicit def` of type `T => S` or `(=> T) => S` -1. An implicit value of type `scala.Conversion[T, S]` - -Defining an implicit conversion will emit a warning unless the import -`scala.language.implicitConversions` is in scope, or the flag -`-language:implicitConversions` is given to the compiler. - -## Examples - -The first example is taken from `scala.Predef`. Thanks to this -implicit conversion, it is possible to pass a `scala.Int` to a Java -method that expects a `java.lang.Integer` - -```scala -import scala.language.implicitConversions -implicit def int2Integer(x: Int): java.lang.Integer = - x.asInstanceOf[java.lang.Integer] -``` - -The second example shows how to use `Conversion` to define an -`Ordering` for an arbitrary type, given existing `Ordering`s for other -types: - -```scala -import scala.language.implicitConversions -implicit def ordT[T, S]( - implicit conv: Conversion[T, S], - ordS: Ordering[S] - ): Ordering[T] = - // `ordS` compares values of type `S`, but we can convert from `T` to `S` - (x: T, y: T) => ordS.compare(x, y) - -class A(val x: Int) // The type for which we want an `Ordering` - -// Convert `A` to a type for which an `Ordering` is available: -implicit val AToInt: Conversion[A, Int] = _.x - -implicitly[Ordering[Int]] // Ok, exists in the standard library -implicitly[Ordering[A]] // Ok, will use the implicit conversion from - // `A` to `Int` and the `Ordering` for `Int`. -``` - -[More details](implicit-conversions-spec.html) diff --git a/_scala3-reference/changed-features/implicit-resolution.md b/_scala3-reference/changed-features/implicit-resolution.md deleted file mode 100644 index 22d6ba7d1f..0000000000 --- a/_scala3-reference/changed-features/implicit-resolution.md +++ /dev/null @@ -1,170 +0,0 @@ ---- -title: "Changes in Implicit Resolution" -type: section -num: 59 -previous-page: /scala3/reference/changed-features/type-inference -next-page: /scala3/reference/changed-features/implicit-conversions ---- - -This section describes changes to the implicit resolution that apply both to the new `given`s and to the old-style `implicit`s in Scala 3. -Implicit resolution uses a new algorithm which caches implicit results -more aggressively for performance. There are also some changes that -affect implicits on the language level. - -**1.** Types of implicit values and result types of implicit methods -must be explicitly declared. Excepted are only values in local blocks -where the type may still be inferred: -```scala - class C { - - val ctx: Context = ... // ok - - /*!*/ implicit val x = ... // error: type must be given explicitly - - /*!*/ implicit def y = ... // error: type must be given explicitly - } - val y = { - implicit val ctx = this.ctx // ok - ... - } -``` -**2.** Nesting is now taken into account for selecting an implicit. Consider for instance the following scenario: -```scala - def f(implicit i: C) = { - def g(implicit j: C) = { - implicitly[C] - } - } -``` -This will now resolve the `implicitly` call to `j`, because `j` is nested -more deeply than `i`. Previously, this would have resulted in an -ambiguity error. The previous possibility of an implicit search failure -due to _shadowing_ (where an implicit is hidden by a nested definition) -no longer applies. - -**3.** Package prefixes no longer contribute to the implicit search scope of a type. Example: -```scala - package p - - given a: A = A() - - object o: - given b: B = B() - type C -``` -Both `a` and `b` are visible as implicits at the point of the definition -of `type C`. However, a reference to `p.o.C` outside of package `p` will -have only `b` in its implicit search scope but not `a`. - -In more detail, here are the rules for what constitutes the implicit scope of -a type: - -**Definition:** A reference is an _anchor_ if it refers to an object, a class, a trait, an abstract type, an opaque type alias, or a match type alias. References to packages and package objects are anchors only under `-source:3.0-migration`. - -**Definition:** The _anchors_ of a type _T_ is a set of references defined as follows: - - 1. If _T_ is a reference to an anchor, _T_ itself plus, if _T_ is of the form _P#A_, the anchors of _P_. - 1. If _T_ is an alias of _U_, the anchors of _U_. - 1. If _T_ is a reference to a type parameter, the union of the anchors of both of its bounds. - 1. If _T_ is a singleton reference, the anchors of its underlying type, plus, - if _T_ is of the form _(P#x).type_, the anchors of _P_. - 1. If _T_ is the this-type _o.this_ of a static object _o_, the anchors of a term reference _o.type_ to that object. - 1. If _T_ is some other type, the union of the anchors of each constituent type of _T_. - - **Definition:** The _implicit scope_ of a type _T_ is the smallest set _S_ of term references such that - - 1. If _T_ is a reference to a class, _S_ includes a reference to the companion object - of the class, if it exists, as well as the implicit scopes of all of _T_'s parent classes. - 1. If _T_ is a reference to an object, _S_ includes _T_ itself as well as - the implicit scopes of all of _T_'s parent classes. - 1. If _T_ is a reference to an opaque type alias named _A_, _S_ includes - a reference to an object _A_ defined in the same scope as the type, if it exists, - as well as the implicit scope of _T_'s underlying type or bounds. - 1. If _T_ is a reference to an abstract type or match type alias - named _A_, _S_ includes a reference to an object _A_ defined in the same scope as the type, if it exists, as well as the implicit scopes of _T_'s given bounds. - 1. If _T_ is a reference to an anchor of the form _p.A_ then _S_ also includes - all term references on the path _p_. - 1. If _T_ is some other type, _S_ includes the implicit scopes of all anchors of _T_. - - -**4.** The treatment of ambiguity errors has changed. If an ambiguity is encountered in some recursive step of an implicit search, the ambiguity is propagated to the caller. - -Example: Say you have the following definitions: -```scala - class A - class B extends C - class C - implicit def a1: A - implicit def a2: A - implicit def b(implicit a: A): B - implicit def c: C -``` -and the query `implicitly[C]`. - -This query would now be classified as ambiguous. This makes sense, after all -there are two possible solutions, `b(a1)` and `b(a2)`, neither of which is better -than the other and both of which are better than the third solution, `c`. -By contrast, Scala 2 would have rejected the search for `A` as -ambiguous, and subsequently have classified the query `b(implicitly[A])` as a normal fail, -which means that the alternative `c` would be chosen as solution! - -Scala 2's somewhat puzzling behavior with respect to ambiguity has been exploited to implement -the analogue of a "negated" search in implicit resolution, where a query `Q1` fails if some -other query `Q2` succeeds and `Q1` succeeds if `Q2` fails. With the new cleaned up behavior -these techniques no longer work. But there is now a new special type `scala.util.NotGiven` -which implements negation directly. For any query type `Q`, `NotGiven[Q]` succeeds if and only if -the implicit search for `Q` fails. - -**5.** The treatment of divergence errors has also changed. A divergent implicit is treated as a normal failure, after which alternatives are still tried. This also makes sense: Encountering a divergent implicit means that we assume that no finite solution can be found on the corresponding path, but another path can still be tried. By contrast, -most (but not all) divergence errors in Scala 2 would terminate the implicit search as a whole. - -**6.** Scala 2 gives a lower level of priority to implicit conversions with call-by-name parameters relative to implicit conversions with call-by-value parameters. Scala 3 drops this distinction. So the following code snippet would be ambiguous in Scala 3: - -```scala - implicit def conv1(x: Int): A = new A(x) - implicit def conv2(x: => Int): A = new A(x) - def buzz(y: A) = ??? - buzz(1) // error: ambiguous -``` -**7.** The rule for picking a _most specific_ alternative among a set of overloaded or implicit alternatives is refined to take context parameters into account. All else being equal, an alternative that takes some context parameters is taken to be less specific than an alternative that takes none. If both alternatives take context parameters, we try to choose between them as if they were methods with regular parameters. The following paragraph in the [SLS §6.26.3](https://scala-lang.org/files/archive/spec/2.13/06-expressions.html#overloading-resolution) is affected by this change: - -_Original version:_ - -> An alternative A is _more specific_ than an alternative B if the relative weight of A over B is greater than the relative weight of B over A. - -_Modified version:_ - -An alternative A is _more specific_ than an alternative B if - - - the relative weight of A over B is greater than the relative weight of B over A, or - - the relative weights are the same, and A takes no implicit parameters but B does, or - - the relative weights are the same, both A and B take implicit parameters, and A is more specific than B if all implicit parameters in either alternative are replaced by regular parameters. - -**8.** The previous disambiguation of implicits based on inheritance depth is refined to make it transitive. Transitivity is important to guarantee that search outcomes are compilation-order independent. Here's a scenario where the previous rules violated transitivity: -```scala - class A extends B - object A { given a ... } - class B - object B extends C { given b ... } - class C { given c } -``` - Here `a` is more specific than `b` since the companion class `A` is a subclass of the companion class `B`. Also, `b` is more specific than `c` - since `object B` extends class `C`. But `a` is not more specific than `c`. This means if `a, b, c` are all applicable implicits, it makes - a difference in what order they are compared. If we compare `b` and `c` - first, we keep `b` and drop `c`. Then, comparing `a` with `b` we keep `a`. But if we compare `a` with `c` first, we fail with an ambiguity error. - -The new rules are as follows: An implicit `a` defined in `A` is more specific than an implicit `b` defined in `B` if - - - `A` extends `B`, or - - `A` is an object and the companion class of `A` extends `B`, or - - `A` and `B` are objects, - `B` does not inherit any implicit members from base classes (*), - and the companion class of `A` extends the companion class of `B`. - -Condition (*) is new. It is necessary to ensure that the defined relation is transitive. - - - - - -[//]: # todo: expand with precise rules diff --git a/_scala3-reference/changed-features/imports.md b/_scala3-reference/changed-features/imports.md deleted file mode 100644 index 39568769a2..0000000000 --- a/_scala3-reference/changed-features/imports.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: "Imports" -type: section -num: 56 -previous-page: /scala3/reference/changed-features/wildcards -next-page: /scala3/reference/changed-features/type-checking ---- - -The syntax of wildcard and renaming imports (and exports) has changed. - -## Wildcard Imports - -Wildcard imports are now expressed with `*` instead of underscore. Example: -```scala -import scala.annotation.* // imports everything in the annotation package -``` - -If you want to import a member named `*` specifically, you can use backticks around it. - -```scala -object A: - def * = ... - def min = ... - -object B: - import A.`*` // imports just `*` - -object C: - import A.* // imports everything in A -``` - -## Renaming Imports - -To rename or exclude an import, we now use `as` instead of `=>`. A single renaming import no longer needs to be enclosed in braces. Examples: - -```scala -import A.{min as minimum, `*` as multiply} -import Predef.{augmentString as _, *} // imports everything except augmentString -import scala.annotation as ann -import java as j -``` - -### Migration - -To support cross-building, Scala 3.0 supports the old import syntax with `_` for wildcards and `=>` for renamings in addition to the new one. The old syntax -will be dropped in a future versions. Automatic rewritings from old to new syntax -are offered under settings `-source 3.1-migration -rewrite`. - -### Syntax - -``` -Import ::= ‘import’ ImportExpr {‘,’ ImportExpr} -ImportExpr ::= SimpleRef {‘.’ id} ‘.’ ImportSpec -ImportSpec ::= NamedSelector - | WildcardSelector - | ‘{’ ImportSelectors) ‘}’ -NamedSelector ::= id [‘as’ (id | ‘_’)] -WildCardSelector ::= ‘*' | ‘given’ [InfixType] -ImportSelectors ::= NamedSelector [‘,’ ImportSelectors] - | WildCardSelector {‘,’ WildCardSelector} -``` diff --git a/_scala3-reference/changed-features/interpolation-escapes.md b/_scala3-reference/changed-features/interpolation-escapes.md deleted file mode 100644 index c61ef98281..0000000000 --- a/_scala3-reference/changed-features/interpolation-escapes.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Escapes in interpolations" ---- - -In Scala 2 there is no straightforward way to represent a single quote character `"` in a single quoted interpolation. A `\` character can't be used for that because interpolators themselves decide how to handle escaping, so the parser doesn't know whether the `"` should be escaped or used as a terminator. - -In Scala 3, we can use the `$` meta character of interpolations to escape a `"` character. Example: - -```scala - val inventor = "Thomas Edison" - val interpolation = s"as $inventor said: $"The three great essentials to achieve anything worth while are: Hard work, Stick-to-itiveness, and Common sense.$"" -``` diff --git a/_scala3-reference/changed-features/lazy-vals-init.md b/_scala3-reference/changed-features/lazy-vals-init.md deleted file mode 100644 index a065cebb2a..0000000000 --- a/_scala3-reference/changed-features/lazy-vals-init.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: Lazy Vals Initialization -type: section -num: 68 -previous-page: /scala3/reference/changed-features/compiler-plugins -next-page: /scala3/reference/changed-features/main-functions ---- - -Scala 3 implements [Version 6](https://docs.scala-lang.org/sips/improved-lazy-val-initialization.html#version-6---no-synchronization-on-this-and-concurrent-initialization-of-fields) -of the [SIP-20] improved lazy vals initialization proposal. - -## Motivation - -The newly proposed lazy val initialization mechanism aims to eliminate the acquisition of resources -during the execution of the lazy val initializer block, thus reducing the possibility of a deadlock. -The concrete deadlock scenarios that the new lazy val initialization scheme eliminates are -summarized in the [SIP-20] document. - -## Implementation - -Given a lazy field of the form: - -```scala -class Foo { - lazy val bar = -} -``` - -The Scala 3 compiler will generate code equivalent to: - -```scala -class Foo { - import scala.runtime.LazyVals - var value_0: Int = _ - var bitmap: Long = 0L - val bitmap_offset: Long = LazyVals.getOffset(classOf[LazyCell], "bitmap") - - def bar(): Int = { - while (true) { - val flag = LazyVals.get(this, bitmap_offset) - val state = LazyVals.STATE(flag, ) - - if (state == ) { - return value_0 - } else if (state == ) { - if (LazyVals.CAS(this, bitmap_offset, flag, , )) { - try { - val result = - value_0 = result - LazyVals.setFlag(this, bitmap_offset, , ) - return result - } - catch { - case ex => - LazyVals.setFlag(this, bitmap_offset, , ) - throw ex - } - } - } else /* if (state == || state == ) */ { - LazyVals.wait4Notification(this, bitmap_offset, flag, ) - } - } - } -} -``` - -The state of the lazy val `` is represented with 4 values: 0, 1, 2 and 3. The state 0 -represents a non-initialized lazy val. The state 1 represents a lazy val that is currently being -initialized by some thread. The state 2 denotes that there are concurrent readers of the lazy val. -The state 3 represents a lazy val that has been initialized. `` is the id of the lazy -val. This id grows with the number of volatile lazy vals defined in the class. - -## Note on recursive lazy vals - -Ideally recursive lazy vals should be flagged as an error. The current behavior for -recursive lazy vals is undefined (initialization may result in a deadlock). - -## Reference - -* [SIP-20] - -[SIP-20]: https://docs.scala-lang.org/sips/improved-lazy-val-initialization.html diff --git a/_scala3-reference/changed-features/main-functions.md b/_scala3-reference/changed-features/main-functions.md deleted file mode 100644 index 6f035278ed..0000000000 --- a/_scala3-reference/changed-features/main-functions.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: "Main Methods" -type: section -num: 69 -previous-page: /scala3/reference/changed-features/lazy-vals-init -next-page: /scala3/reference/dropped-features ---- - -Scala 3 offers a new way to define programs that can be invoked from the command line: -A `@main` annotation on a method turns this method into an executable program. -Example: - -```scala -@main def happyBirthday(age: Int, name: String, others: String*) = - val suffix = - age % 100 match - case 11 | 12 | 13 => "th" - case _ => - age % 10 match - case 1 => "st" - case 2 => "nd" - case 3 => "rd" - case _ => "th" - val bldr = new StringBuilder(s"Happy $age$suffix birthday, $name") - for other <- others do bldr.append(" and ").append(other) - bldr.toString -``` - -This would generate a main program `happyBirthday` that could be called like this - -``` -> scala happyBirthday 23 Lisa Peter -Happy 23rd birthday, Lisa and Peter -``` - -A `@main` annotated method can be written either at the top-level or in a statically accessible object. The name of the program is in each case the name of the method, without any object prefixes. The `@main` method can have an arbitrary number of parameters. -For each parameter type there must be an instance of the `scala.util.CommandLineParser.FromString` type class -that is used to convert an argument string to the required parameter type. -The parameter list of a main method can end in a repeated parameter that then -takes all remaining arguments given on the command line. - -The program implemented from a `@main` method checks that there are enough arguments on -the command line to fill in all parameters, and that argument strings are convertible to -the required types. If a check fails, the program is terminated with an error message. - -Examples: - -``` -> scala happyBirthday 22 -Illegal command line after first argument: more arguments expected - -> scala happyBirthday sixty Fred -Illegal command line: java.lang.NumberFormatException: For input string: "sixty" -``` - -The Scala compiler generates a program from a `@main` method `f` as follows: - - - It creates a class named `f` in the package where the `@main` method was found - - The class has a static method `main` with the usual signature. It takes an `Array[String]` - as argument and returns `Unit`. - - The generated `main` method calls method `f` with arguments converted using - methods in the [`scala.util.CommandLineParser`](https://scala-lang.org/api/3.x/scala/util/CommandLineParser$.html) object. - -For instance, the `happyBirthDay` method above would generate additional code equivalent to the following class: - -```scala -final class happyBirthday: - import scala.util.CommandLineParser as CLP - def main(args: Array[String]): Unit = - try - happyBirthday( - CLP.parseArgument[Int](args, 0), - CLP.parseArgument[String](args, 1), - CLP.parseRemainingArguments[String](args, 2)) - catch - case error: CLP.ParseError => CLP.showError(error) -``` - -**Note**: The `` modifier above expresses that the `main` method is generated -as a static method of class `happyBirthDay`. It is not available for user programs in Scala. Regular "static" members are generated in Scala using objects instead. - -`@main` methods are the recommended scheme to generate programs that can be invoked from the command line in Scala 3. They replace the previous scheme to write program as objects with a special `App` parent class. In Scala 2, `happyBirthday` could be written also like this: - -```scala -object happyBirthday extends App: - // needs by-hand parsing of arguments vector - ... -``` - -The previous functionality of `App`, which relied on the "magic" [`DelayedInit`]({% link _scala3-reference/dropped-features/delayed-init.md %}) trait, is no longer available. [`App`](https://scala-lang.org/api/3.x/scala/App.html) still exists in limited form for now, but it does not support command line arguments and will be deprecated in the future. If programs need to cross-build -between Scala 2 and Scala 3, it is recommended to use an explicit `main` method with an `Array[String]` argument instead. diff --git a/_scala3-reference/changed-features/match-syntax.md b/_scala3-reference/changed-features/match-syntax.md deleted file mode 100644 index 7ebc85b6d0..0000000000 --- a/_scala3-reference/changed-features/match-syntax.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: "Match Expressions" -type: section -num: 62 -previous-page: /scala3/reference/changed-features/overload-resolution -next-page: /scala3/reference/changed-features/vararg-splices ---- - -The syntactical precedence of match expressions has been changed. -`match` is still a keyword, but it is used like an alphabetical operator. This has several consequences: - - 1. `match` expressions can be chained: - - ```scala - xs match { - case Nil => "empty" - case _ => "nonempty" - } match { - case "empty" => 0 - case "nonempty" => 1 - } - ``` - - (or, dropping the optional braces) - - ```scala - xs match - case Nil => "empty" - case _ => "nonempty" - match - case "empty" => 0 - case "nonempty" => 1 - ``` - - 2. `match` may follow a period: - - ```scala - if xs.match - case Nil => false - case _ => true - then "nonempty" - else "empty" - ``` - - 3. The scrutinee of a match expression must be an `InfixExpr`. Previously the scrutinee could be followed by a type ascription `: T`, but this is no longer supported. So `x : T match { ... }` now has to be - written `(x: T) match { ... }`. - -## Syntax - -The new syntax of match expressions is as follows. - -``` -InfixExpr ::= ... - | InfixExpr MatchClause -SimpleExpr ::= ... - | SimpleExpr ‘.’ MatchClause -MatchClause ::= ‘match’ ‘{’ CaseClauses ‘}’ -``` diff --git a/_scala3-reference/changed-features/numeric-literals.md b/_scala3-reference/changed-features/numeric-literals.md deleted file mode 100644 index 8d62ba4aab..0000000000 --- a/_scala3-reference/changed-features/numeric-literals.md +++ /dev/null @@ -1,264 +0,0 @@ ---- -title: "Numeric Literals" -type: section -num: 52 -previous-page: /scala3/reference/changed-features -next-page: /scala3/reference/changed-features/structural-types ---- - -**Note**: This feature is not yet part of the Scala 3 language definition. It can be made available by a language import: - -```scala -import scala.language.experimental.genericNumberLiterals -``` - -In Scala 2, numeric literals were confined to the primitive numeric types `Int`, `Long`, `Float`, and `Double`. Scala 3 allows to write numeric literals also for user-defined types. Example: - -```scala -val x: Long = -10_000_000_000 -val y: BigInt = 0x123_abc_789_def_345_678_901 -val z: BigDecimal = 110_222_799_799.99 - -(y: BigInt) match - case 123_456_789_012_345_678_901 => -``` - -The syntax of numeric literals is the same as before, except there are no pre-set limits -how large they can be. - -### Meaning of Numeric Literals - -The meaning of a numeric literal is determined as follows: - -- If the literal ends with `l` or `L`, it is a `Long` integer (and must fit in its legal range). -- If the literal ends with `f` or `F`, it is a single precision floating point number of type `Float`. -- If the literal ends with `d` or `D`, it is a double precision floating point number of type `Double`. - -In each of these cases the conversion to a number is exactly as in Scala 2 or in Java. If a numeric literal does _not_ end in one of these suffixes, its meaning is determined by the expected type: - -1. If the expected type is `Int`, `Long`, `Float`, or `Double`, the literal is - treated as a standard literal of that type. -2. If the expected type is a fully defined type `T` that has a given instance of type - `scala.util.FromDigits[T]`, the literal is converted to a value of type `T` by passing it as an argument to - the `fromDigits` method of that instance (more details below). -3. Otherwise, the literal is treated as a `Double` literal (if it has a decimal point or an - exponent), or as an `Int` literal (if not). (This last possibility is again as in Scala 2 or Java.) - -With these rules, the definition - -```scala -val x: Long = -10_000_000_000 -``` - -is legal by rule (1), since the expected type is `Long`. The definitions - -```scala -val y: BigInt = 0x123_abc_789_def_345_678_901 -val z: BigDecimal = 111222333444.55 -``` - -are legal by rule (2), since both `BigInt` and `BigDecimal` have `FromDigits` instances -(which implement the `FromDigits` subclasses `FromDigits.WithRadix` and `FromDigits.Decimal`, respectively). -On the other hand, - -```scala -val x = -10_000_000_000 -``` - -gives a type error, since without an expected type `-10_000_000_000` is treated by rule (3) as an `Int` literal, but it is too large for that type. - -### The FromDigits Trait - -To allow numeric literals, a type simply has to define a `given` instance of the -`scala.util.FromDigits` type class, or one of its subclasses. `FromDigits` is defined -as follows: - -```scala -trait FromDigits[T]: - def fromDigits(digits: String): T -``` - -Implementations of the `fromDigits` convert strings of digits to the values of the -implementation type `T`. -The `digits` string consists of digits between `0` and `9`, possibly preceded by a -sign ("+" or "-"). Number separator characters `_` are filtered out before -the string is passed to `fromDigits`. - -The companion object `FromDigits` also defines subclasses of `FromDigits` for -whole numbers with a given radix, for numbers with a decimal point, and for -numbers that can have both a decimal point and an exponent: - -```scala -object FromDigits: - - /** A subclass of `FromDigits` that also allows to convert whole - * number literals with a radix other than 10 - */ - trait WithRadix[T] extends FromDigits[T]: - def fromDigits(digits: String): T = fromDigits(digits, 10) - def fromDigits(digits: String, radix: Int): T - - /** A subclass of `FromDigits` that also allows to convert number - * literals containing a decimal point ".". - */ - trait Decimal[T] extends FromDigits[T] - - /** A subclass of `FromDigits`that allows also to convert number - * literals containing a decimal point "." or an - * exponent `('e' | 'E')['+' | '-']digit digit*`. - */ - trait Floating[T] extends Decimal[T] -``` - -A user-defined number type can implement one of those, which signals to the compiler -that hexadecimal numbers, decimal points, or exponents are also accepted in literals -for this type. - -### Error Handling - -`FromDigits` implementations can signal errors by throwing exceptions of some subtype -of `FromDigitsException`. `FromDigitsException` is defined with three subclasses in the -`FromDigits` object as follows: - -```scala -abstract class FromDigitsException(msg: String) extends NumberFormatException(msg) - -class NumberTooLarge (msg: String = "number too large") extends FromDigitsException(msg) -class NumberTooSmall (msg: String = "number too small") extends FromDigitsException(msg) -class MalformedNumber(msg: String = "malformed number literal") extends FromDigitsException(msg) -``` - -### Example - -As a fully worked out example, here is an implementation of a new numeric class, `BigFloat`, that accepts numeric literals. `BigFloat` is defined in terms of a `BigInt` mantissa and an `Int` exponent: - -```scala -case class BigFloat(mantissa: BigInt, exponent: Int): - override def toString = s"${mantissa}e${exponent}" -``` - -`BigFloat` literals can have a decimal point as well as an exponent. E.g. the following expression -should produce the `BigFloat` number `BigFloat(-123, 997)`: - -```scala --0.123E+1000: BigFloat -``` - -The companion object of `BigFloat` defines an `apply` constructor method to construct a `BigFloat` -from a `digits` string. Here is a possible implementation: - -```scala -object BigFloat: - import scala.util.FromDigits - - def apply(digits: String): BigFloat = - val (mantissaDigits, givenExponent) = - digits.toUpperCase.split('E') match - case Array(mantissaDigits, edigits) => - val expo = - try FromDigits.intFromDigits(edigits) - catch case ex: FromDigits.NumberTooLarge => - throw FromDigits.NumberTooLarge(s"exponent too large: $edigits") - (mantissaDigits, expo) - case Array(mantissaDigits) => - (mantissaDigits, 0) - val (intPart, exponent) = - mantissaDigits.split('.') match - case Array(intPart, decimalPart) => - (intPart ++ decimalPart, givenExponent - decimalPart.length) - case Array(intPart) => - (intPart, givenExponent) - BigFloat(BigInt(intPart), exponent) -``` - -To accept `BigFloat` literals, all that's needed in addition is a `given` instance of type -`FromDigits.Floating[BigFloat]`: - -```scala - given FromDigits: FromDigits.Floating[BigFloat] with - def fromDigits(digits: String) = apply(digits) -end BigFloat -``` - -Note that the `apply` method does not check the format of the `digits` argument. It is -assumed that only valid arguments are passed. For calls coming from the compiler -that assumption is valid, since the compiler will first check whether a numeric -literal has the correct format before it gets passed on to a conversion method. - -### Compile-Time Errors - -With the setup of the previous section, a literal like - -```scala -1e10_0000_000_000: BigFloat -``` - -would be expanded by the compiler to - -```scala -BigFloat.FromDigits.fromDigits("1e100000000000") -``` - -Evaluating this expression throws a `NumberTooLarge` exception at run time. We would like it to -produce a compile-time error instead. We can achieve this by tweaking the `BigFloat` class -with a small dose of metaprogramming. The idea is to turn the `fromDigits` method -into a macro, i.e. make it an inline method with a splice as right-hand side. -To do this, replace the `FromDigits` instance in the `BigFloat` object by the following two definitions: - -```scala -object BigFloat: - ... - - class FromDigits extends FromDigits.Floating[BigFloat]: - def fromDigits(digits: String) = apply(digits) - - given FromDigits with - override inline def fromDigits(digits: String) = ${ - fromDigitsImpl('digits) - } -``` - -Note that an inline method cannot directly fill in for an abstract method, since it produces -no code that can be executed at runtime. That is why we define an intermediary class -`FromDigits` that contains a fallback implementation which is then overridden by the inline -method in the `FromDigits` given instance. That method is defined in terms of a macro -implementation method `fromDigitsImpl`. Here is its definition: - -```scala - private def fromDigitsImpl(digits: Expr[String])(using ctx: Quotes): Expr[BigFloat] = - digits.value match - case Some(ds) => - try - val BigFloat(m, e) = apply(ds) - '{BigFloat(${Expr(m)}, ${Expr(e)})} - catch case ex: FromDigits.FromDigitsException => - ctx.error(ex.getMessage) - '{BigFloat(0, 0)} - case None => - '{apply($digits)} -end BigFloat -``` - -The macro implementation takes an argument of type `Expr[String]` and yields -a result of type `Expr[BigFloat]`. It tests whether its argument is a constant -string. If that is the case, it converts the string using the `apply` method -and lifts the resulting `BigFloat` back to `Expr` level. For non-constant -strings `fromDigitsImpl(digits)` is simply `apply(digits)`, i.e. everything is -evaluated at runtime in this case. - -The interesting part is the `catch` part of the case where `digits` is constant. -If the `apply` method throws a `FromDigitsException`, the exception's message is issued as a compile time error in the `ctx.error(ex.getMessage)` call. - -With this new implementation, a definition like - -```scala -val x: BigFloat = 1234.45e3333333333 -``` - -would give a compile time error message: - -```scala -3 | val x: BigFloat = 1234.45e3333333333 - | ^^^^^^^^^^^^^^^^^^ - | exponent too large: 3333333333 -``` diff --git a/_scala3-reference/changed-features/operators.md b/_scala3-reference/changed-features/operators.md deleted file mode 100644 index 5e05c6bfbc..0000000000 --- a/_scala3-reference/changed-features/operators.md +++ /dev/null @@ -1,167 +0,0 @@ ---- -title: "Rules for Operators" -type: section -num: 54 -previous-page: /scala3/reference/changed-features/structural-types -next-page: /scala3/reference/changed-features/wildcards ---- - -The rules for infix operators have changed in some parts: - -First, an alphanumeric method can be used as an infix operator only if its definition carries an `infix` modifier. Second, it is recommended (but not enforced) to -augment definitions of symbolic operators with [`@targetName` annotations](../other-new-features/targetName.html). Finally, -a syntax change allows infix operators to be written on the left in a multi-line expression. - -## The `infix` Modifier - -An `infix` modifier on a method definition allows using the method as an infix operation. Example: - -```scala -import scala.annotation.targetName - -trait MultiSet[T]: - - infix def union(other: MultiSet[T]): MultiSet[T] - - def difference(other: MultiSet[T]): MultiSet[T] - - @targetName("intersection") - def *(other: MultiSet[T]): MultiSet[T] - -end MultiSet - -val s1, s2: MultiSet[Int] - -s1 union s2 // OK -s1 `union` s2 // also OK but unusual -s1.union(s2) // also OK - -s1.difference(s2) // OK -s1 `difference` s2 // OK -s1 difference s2 // gives a deprecation warning - -s1 * s2 // OK -s1 `*` s2 // also OK, but unusual -s1.*(s2) // also OK, but unusual -``` - -Infix operations involving alphanumeric operators are deprecated, unless -one of the following conditions holds: - - - the operator definition carries an `infix` modifier, or - - the operator was compiled with Scala 2, or - - the operator is followed by an opening brace. - -An alphanumeric operator is an operator consisting entirely of letters, digits, the `$` and `_` characters, or -any Unicode character `c` for which `java.lang.Character.isIdentifierPart(c)` returns `true`. - -Infix operations involving symbolic operators are always allowed, so `infix` is redundant for methods with symbolic names. - -The `infix` modifier can also be given to a type: - -```scala -infix type or[X, Y] -val x: String or Int = ... -``` - -### Motivation - -The purpose of the `infix` modifier is to achieve consistency across a code base in how a method or type is applied. The idea is that the author of a method decides whether that method should be applied as an infix operator or in a regular application. Use sites then implement that decision consistently. - -### Details - - 1. `infix` is a soft modifier. It is treated as a normal identifier except when in modifier position. - - 2. If a method overrides another, their infix annotations must agree. Either both are annotated with `infix`, or none of them are. - - 3. `infix` modifiers can be given to method definitions. The first non-receiver parameter list of an `infix` method must define exactly one parameter. Examples: - - ```scala - infix def op1(x: S): R // ok - infix def op2[T](x: T)(y: S): R // ok - infix def op3[T](x: T, y: S): R // error: two parameters - - extension (x: A) - infix def op4(y: B): R // ok - infix def op5(y1: B, y2: B): R // error: two parameters - ``` - - 4. `infix` modifiers can also be given to type, trait or class definitions that have exactly two type parameters. An infix type like - - ```scala - infix type op[X, Y] - ``` - - can be applied using infix syntax, i.e. `A op B`. - - 5. To smooth migration to Scala 3.0, alphanumeric operators will only be deprecated from Scala 3.1 onwards, -or if the `-source future` option is given in Dotty/Scala 3. - -## The `@targetName` Annotation - -It is recommended that definitions of symbolic operators carry a [`@targetName` annotation](../other-new-features/targetName.html) that provides an encoding of the operator with an alphanumeric name. This has several benefits: - - - It helps interoperability between Scala and other languages. One can call - a Scala-defined symbolic operator from another language using its target name, - which avoids having to remember the low-level encoding of the symbolic name. - - It helps legibility of stacktraces and other runtime diagnostics, where the - user-defined alphanumeric name will be shown instead of the low-level encoding. - - It serves as a documentation tool by providing an alternative regular name - as an alias of a symbolic operator. This makes the definition also easier - to find in a search. - -## Syntax Change - -Infix operators can now appear at the start of lines in a multi-line expression. Examples: - -```scala -val str = "hello" - ++ " world" - ++ "!" - -def condition = - x > 0 - || - xs.exists(_ > 0) - || xs.isEmpty -``` - -Previously, those expressions would have been rejected, since the compiler's semicolon inference -would have treated the continuations `++ " world"` or `|| xs.isEmpty` as separate statements. - -To make this syntax work, the rules are modified to not infer semicolons in front of leading infix operators. -A _leading infix operator_ is - - a symbolic identifier such as `+`, or `approx_==`, or an identifier in backticks that - - starts a new line, and - - is not following a blank line, and - - is followed by at least one whitespace character and a token that can start an expression. - - Furthermore, if the operator appears on its own line, the next line must have at least - the same indentation width as the operator. - -Example: - -```scala - freezing - | boiling -``` - -This is recognized as a single infix operation. Compare with: - -```scala - freezing - !boiling -``` - -This is seen as two statements, `freezing` and `!boiling`. The difference is that only the operator in the first example -is followed by a space. - -Another example: - -```scala - println("hello") - ??? - ??? match { case 0 => 1 } -``` - -This code is recognized as three different statements. `???` is syntactically a symbolic identifier, but -neither of its occurrences is followed by a space and a token that can start an expression. diff --git a/_scala3-reference/changed-features/overload-resolution.md b/_scala3-reference/changed-features/overload-resolution.md deleted file mode 100644 index 6b20329970..0000000000 --- a/_scala3-reference/changed-features/overload-resolution.md +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: "Changes in Overload Resolution" -type: section -num: 61 -previous-page: /scala3/reference/changed-features/implicit-conversions -next-page: /scala3/reference/changed-features/match-syntax ---- - -Overload resolution in Scala 3 improves on Scala 2 in two ways. -First, it takes all argument lists into account instead of -just the first argument list. -Second, it can infer parameter types of function values even if they -are in the first argument list. - -## Looking Beyond the First Argument List - -Overloading resolution now can take argument lists into account when -choosing among a set of overloaded alternatives. -For example, the following code compiles in Scala 3, while it results in an -ambiguous overload error in Scala 2: - -```scala -def f(x: Int)(y: String): Int = 0 -def f(x: Int)(y: Int): Int = 0 - -f(3)("") // ok -``` - -The following code compiles as well: - -```scala -def g(x: Int)(y: Int)(z: Int): Int = 0 -def g(x: Int)(y: Int)(z: String): Int = 0 - -g(2)(3)(4) // ok -g(2)(3)("") // ok -``` - -To make this work, the rules for overloading resolution in [SLS §6.26.3](https://www.scala-lang.org/files/archive/spec/2.13/06-expressions.html#overloading-resolution) are augmented -as follows: - -> In a situation where a function is applied to more than one argument list, if overloading -resolution yields several competing alternatives when `n >= 1` parameter lists are taken -into account, then resolution re-tried using `n + 1` argument lists. - -This change is motivated by the new language feature -[extension methods](../contextual/extension-methods.html), where emerges the need to do -overload resolution based on additional argument blocks. - -## Parameter Types of Function Values - -The handling of function values with missing parameter types has been improved. We can now -pass such values in the first argument list of an overloaded application, provided -that the remaining parameters suffice for picking a variant of the overloaded function. -For example, the following code compiles in Scala 3, while it results in a -missing parameter type error in Scala2: - -```scala -def f(x: Int, f2: Int => Int) = f2(x) -def f(x: String, f2: String => String) = f2(x) -f("a", _.toUpperCase) -f(2, _ * 2) -``` - -To make this work, the rules for overloading resolution in [SLS §6.26.3](https://www.scala-lang.org/files/archive/spec/2.13/06-expressions.html#overloading-resolution) are modified -as follows: - -Replace the sentence - -> Otherwise, let `S1,…,Sm` be the vector of types obtained by typing each argument with an undefined expected type. - -with the following paragraph: - -> Otherwise, let `S1,…,Sm` be the vector of known types of all argument types, where the _known type_ of an argument `E` -is determined as followed: - - - If `E` is a function value `(p_1, ..., p_n) => B` that misses some parameter types, the known type - of `E` is `(S_1, ..., S_n) => ?`, where each `S_i` is the type of parameter `p_i` if it is given, or `?` - otherwise. Here `?` stands for a _wildcard type_ that is compatible with every other type. - - Otherwise the known type of `E` is the result of typing `E` with an undefined expected type. - -A pattern matching closure - -```scala -{ case P1 => B1 ... case P_n => B_n } -```` - -is treated as if it was expanded to the function value - -```scala -x => x match { case P1 => B1 ... case P_n => B_n } -``` - -and is therefore also approximated with a `? => ?` type. diff --git a/_scala3-reference/changed-features/pattern-bindings.md b/_scala3-reference/changed-features/pattern-bindings.md deleted file mode 100644 index be13cee3ac..0000000000 --- a/_scala3-reference/changed-features/pattern-bindings.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: "Pattern Bindings" -type: section -num: 64 -previous-page: /scala3/reference/changed-features/vararg-splices -next-page: /scala3/reference/changed-features/pattern-matching ---- - -In Scala 2, pattern bindings in `val` definitions and `for` expressions are -loosely typed. Potentially failing matches are still accepted at compile-time, -but may influence the program's runtime behavior. -From Scala 3.2 on, type checking rules will be tightened so that warnings are reported at compile-time instead. - -## Bindings in Pattern Definitions - -```scala -val xs: List[Any] = List(1, 2, 3) -val (x: String) :: _ = xs // error: pattern's type String is more specialized - // than the right-hand side expression's type Any -``` -This code gives a compile-time warning in Scala 3.2 (and also earlier Scala 3.x under the `-source future` setting) whereas it will fail at runtime with a `ClassCastException` in Scala 2. In Scala 3.2, a pattern binding is only allowed if the pattern is _irrefutable_, that is, if the right-hand side's type conforms to the pattern's type. For instance, the following is OK: -```scala -val pair = (1, true) -val (x, y) = pair -``` -Sometimes one wants to decompose data anyway, even though the pattern is refutable. For instance, if at some point one knows that a list `elems` is non-empty one might -want to decompose it like this: -```scala -val first :: rest = elems // error -``` -This works in Scala 2. In fact it is a typical use case for Scala 2's rules. But in Scala 3.2 it will give a warning. One can avoid the warning by marking the right-hand side with an `@unchecked` annotation: -```scala -val first :: rest = elems: @unchecked // OK -``` -This will make the compiler accept the pattern binding. It might give an error at runtime instead, if the underlying assumption that `elems` can never be empty is wrong. - -## Pattern Bindings in `for` Expressions - -Analogous changes apply to patterns in `for` expressions. For instance: - -```scala -val elems: List[Any] = List((1, 2), "hello", (3, 4)) -for (x, y) <- elems yield (y, x) // error: pattern's type (Any, Any) is more specialized - // than the right-hand side expression's type Any -``` -This code gives a compile-time warning in Scala 3.2 whereas in Scala 2 the list `elems` -is filtered to retain only the elements of tuple type that match the pattern `(x, y)`. -The filtering functionality can be obtained in Scala 3 by prefixing the pattern with `case`: -```scala -for case (x, y) <- elems yield (y, x) // returns List((2, 1), (4, 3)) -``` - -## Syntax Changes - -Generators in for expressions may be prefixed with `case`. -``` -Generator ::= [‘case’] Pattern1 ‘<-’ Expr -``` - -## Migration - -The new syntax is supported in Scala 3.0. However, to enable smooth cross compilation between Scala 2 and Scala 3, the changed behavior and additional type checks are only enabled under the `-source future` setting. They will be enabled by default in version 3.2 of the language. diff --git a/_scala3-reference/changed-features/pattern-matching.md b/_scala3-reference/changed-features/pattern-matching.md deleted file mode 100644 index c0f3afa1f5..0000000000 --- a/_scala3-reference/changed-features/pattern-matching.md +++ /dev/null @@ -1,246 +0,0 @@ ---- -title: "Option-less pattern matching" -type: section -num: 65 -previous-page: /scala3/reference/changed-features/pattern-bindings -next-page: /scala3/reference/changed-features/eta-expansion ---- - -The implementation of pattern matching in Scala 3 was greatly simplified compared to Scala 2. From a user perspective, this means that Scala 3 generated patterns are a *lot* easier to debug, as variables all show up in debug modes and positions are correctly preserved. - -Scala 3 supports a superset of Scala 2 [extractors](https://www.scala-lang.org/files/archive/spec/2.13/08-pattern-matching.html#extractor-patterns). - -## Extractors - -Extractors are objects that expose a method `unapply` or `unapplySeq`: - -```Scala -def unapply[A](x: T)(implicit x: B): U -def unapplySeq[A](x: T)(implicit x: B): U -``` - -Extractors that expose the method `unapply` are called fixed-arity extractors, which -work with patterns of fixed arity. Extractors that expose the method `unapplySeq` are -called variadic extractors, which enables variadic patterns. - -### Fixed-Arity Extractors - -Fixed-arity extractors expose the following signature: - -```Scala -def unapply[A](x: T)(implicit x: B): U -``` - -The type `U` conforms to one of the following matches: - -- Boolean match -- Product match - -Or `U` conforms to the type `R`: - -```Scala -type R = { - def isEmpty: Boolean - def get: S -} -``` - -and `S` conforms to one of the following matches: - -- single match -- name-based match - -The former form of `unapply` has higher precedence, and _single match_ has higher -precedence over _name-based match_. - -A usage of a fixed-arity extractor is irrefutable if one of the following condition holds: - -- `U = true` -- the extractor is used as a product match -- `U = Some[T]` (for Scala 2 compatibility) -- `U <: R` and `U <: { def isEmpty: false }` - -### Variadic Extractors - -Variadic extractors expose the following signature: - -```Scala -def unapplySeq[A](x: T)(implicit x: B): U -``` - -The type `U` conforms to one of the following matches: - -- sequence match -- product-sequence match - -Or `U` conforms to the type `R`: - -```Scala -type R = { - def isEmpty: Boolean - def get: S -} -``` - -and `S` conforms to one of the two matches above. - -The former form of `unapplySeq` has higher priority, and _sequence match_ has higher -precedence over _product-sequence match_. - -A usage of a variadic extractor is irrefutable if one of the following conditions holds: - -- the extractor is used directly as a sequence match or product-sequence match -- `U = Some[T]` (for Scala 2 compatibility) -- `U <: R` and `U <: { def isEmpty: false }` - -## Boolean Match - -- `U =:= Boolean` -- Pattern-matching on exactly `0` patterns - -For example: - - - -```scala -object Even: - def unapply(s: String): Boolean = s.size % 2 == 0 - -"even" match - case s @ Even() => println(s"$s has an even number of characters") - case s => println(s"$s has an odd number of characters") - -// even has an even number of characters -``` - -## Product Match - -- `U <: Product` -- `N > 0` is the maximum number of consecutive (parameterless `def` or `val`) `_1: P1` ... `_N: PN` members in `U` -- Pattern-matching on exactly `N` patterns with types `P1, P2, ..., PN` - -For example: - - - -```scala -class FirstChars(s: String) extends Product: - def _1 = s.charAt(0) - def _2 = s.charAt(1) - - // Not used by pattern matching: Product is only used as a marker trait. - def canEqual(that: Any): Boolean = ??? - def productArity: Int = ??? - def productElement(n: Int): Any = ??? - -object FirstChars: - def unapply(s: String): FirstChars = new FirstChars(s) - -"Hi!" match - case FirstChars(char1, char2) => - println(s"First: $char1; Second: $char2") - -// First: H; Second: i -``` - -## Single Match - -- If there is exactly `1` pattern, pattern-matching on `1` pattern with type `U` - - - -```scala -class Nat(val x: Int): - def get: Int = x - def isEmpty = x < 0 - -object Nat: - def unapply(x: Int): Nat = new Nat(x) - -5 match - case Nat(n) => println(s"$n is a natural number") - case _ => () - -// 5 is a natural number -``` - -## Name-based Match - -- `N > 1` is the maximum number of consecutive (parameterless `def` or `val`) `_1: P1 ... _N: PN` members in `U` -- Pattern-matching on exactly `N` patterns with types `P1, P2, ..., PN` - -```Scala -object ProdEmpty: - def _1: Int = ??? - def _2: String = ??? - def isEmpty = true - def unapply(s: String): this.type = this - def get = this - -"" match - case ProdEmpty(_, _) => ??? - case _ => () -``` - - -## Sequence Match - -- `U <: X`, `T2` and `T3` conform to `T1` - -```Scala -type X = { - def lengthCompare(len: Int): Int // or, `def length: Int` - def apply(i: Int): T1 - def drop(n: Int): scala.Seq[T2] - def toSeq: scala.Seq[T3] -} -``` - -- Pattern-matching on _exactly_ `N` simple patterns with types `T1, T1, ..., T1`, where `N` is the runtime size of the sequence, or -- Pattern-matching on `>= N` simple patterns and _a vararg pattern_ (e.g., `xs: _*`) with types `T1, T1, ..., T1, Seq[T1]`, where `N` is the minimum size of the sequence. - - - -```scala -object CharList: - def unapplySeq(s: String): Option[Seq[Char]] = Some(s.toList) - -"example" match - case CharList(c1, c2, c3, c4, _, _, _) => - println(s"$c1,$c2,$c3,$c4") - case _ => - println("Expected *exactly* 7 characters!") - -// e,x,a,m -``` - -## Product-Sequence Match - -- `U <: Product` -- `N > 0` is the maximum number of consecutive (parameterless `def` or `val`) `_1: P1` ... `_N: PN` members in `U` -- `PN` conforms to the signature `X` defined in Seq Pattern -- Pattern-matching on exactly `>= N` patterns, the first `N - 1` patterns have types `P1, P2, ... P(N-1)`, - the type of the remaining patterns are determined as in Seq Pattern. - -```Scala -class Foo(val name: String, val children: Int *) -object Foo: - def unapplySeq(f: Foo): Option[(String, Seq[Int])] = - Some((f.name, f.children)) - -def foo(f: Foo) = f match - case Foo(name, ns : _*) => - case Foo(name, x, y, ns : _*) => -``` - -There are plans for further simplification, in particular to factor out *product -match* and *name-based match* into a single type of extractor. - -## Type testing - -Abstract type testing with `ClassTag` is replaced with `TypeTest` or the alias `Typeable`. - -- pattern `_: X` for an abstract type requires a `TypeTest` in scope -- pattern `x @ X()` for an unapply that takes an abstract type requires a `TypeTest` in scope - -[More details on `TypeTest`](../other-new-features/type-test.html) diff --git a/_scala3-reference/changed-features/structural-types-spec.md b/_scala3-reference/changed-features/structural-types-spec.md deleted file mode 100644 index eb7e653a78..0000000000 --- a/_scala3-reference/changed-features/structural-types-spec.md +++ /dev/null @@ -1,153 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Programmatic Structural Types - More Details" ---- - -## Syntax - -``` -SimpleType ::= ... | Refinement -Refinement ::= ‘{’ RefineStatSeq ‘}’ -RefineStatSeq ::= RefineStat {semi RefineStat} -RefineStat ::= ‘val’ VarDcl | ‘def’ DefDcl | ‘type’ {nl} TypeDcl -``` - -## Implementation of Structural Types - -The standard library defines a universal marker trait -[`scala.Selectable`](https://github.com/lampepfl/dotty/blob/master/library/src/scala/Selectable.scala): - -```scala -trait Selectable extends Any -``` - -An implementation of `Selectable` that relies on [Java reflection](https://www.oracle.com/technical-resources/articles/java/javareflection.html) is -available in the standard library: `scala.reflect.Selectable`. Other -implementations can be envisioned for platforms where Java reflection -is not available. - -Implementations of `Selectable` have to make available one or both of -the methods `selectDynamic` and `applyDynamic`. The methods could be members of the `Selectable` implementation or they could be extension methods. - -The `selectDynamic` method takes a field name and returns the value associated with that name in the `Selectable`. -It should have a signature of the form: - -```scala -def selectDynamic(name: String): T -``` - -Often, the return type `T` is `Any`. - -Unlike `scala.Dynamic`, there is no special meaning for an `updateDynamic` method. -However, we reserve the right to give it meaning in the future. -Consequently, it is recommended not to define any member called `updateDynamic` in `Selectable`s. - -The `applyDynamic` method is used for selections that are applied to arguments. It takes a method name and possibly `Class`es representing its parameters types as well as the arguments to pass to the function. -Its signature should be of one of the two following forms: - -```scala -def applyDynamic(name: String)(args: Any*): T -def applyDynamic(name: String, ctags: Class[?]*)(args: Any*): T -``` - -Both versions are passed the actual arguments in the `args` parameter. The second version takes in addition a vararg argument of `java.lang.Class`es that identify the method's parameter classes. Such an argument is needed -if `applyDynamic` is implemented using Java reflection, but it could be -useful in other cases as well. `selectDynamic` and `applyDynamic` can also take additional context parameters in using clauses. These are resolved in the normal way at the callsite. - -Given a value `v` of type `C { Rs }`, where `C` is a class reference -and `Rs` are structural refinement declarations, and given `v.a` of type `U`, we consider three distinct cases: - -- If `U` is a value type, we map `v.a` to: - ```scala - v.selectDynamic("a").asInstanceOf[U] - ``` - -- If `U` is a method type `(T11, ..., T1n)...(TN1, ..., TNn): R` and it is not a dependent method type, we map `v.a(a11, ..., a1n)...(aN1, ..., aNn)` to: - ```scala - v.applyDynamic("a")(a11, ..., a1n, ..., aN1, ..., aNn) - .asInstanceOf[R] - ``` - If this call resolves to an `applyDynamic` method of the second form that takes a `Class[?]*` argument, we further rewrite this call to - ```scala - v.applyDynamic("a", c11, ..., c1n, ..., cN1, ... cNn)( - a11, ..., a1n, ..., aN1, ..., aNn) - .asInstanceOf[R] - ``` - where each `c_ij` is the literal `java.lang.Class[?]` of the type of the formal parameter `Tij`, i.e., `classOf[Tij]`. - -- If `U` is neither a value nor a method type, or a dependent method - type, an error is emitted. - -Note that `v`'s static type does not necessarily have to conform to `Selectable`, nor does it need to have `selectDynamic` and `applyDynamic` as members. It suffices that there is an implicit -conversion that can turn `v` into a `Selectable`, and the selection methods could also be available as -[extension methods](../contextual/extension-methods.html). - -## Limitations of Structural Types - -- Dependent methods cannot be called via structural call. - -- Refinements may not introduce overloads: If a refinement specifies the signature - of a method `m`, and `m` is also defined in the parent type of the refinement, then - the new signature must properly override the existing one. - -- Subtyping of structural refinements must preserve erased parameter types: Assume - we want to prove `S <: T { def m(x: A): B }`. Then, as usual, `S` must have a member method `m` that can take an argument of type `A`. Furthermore, if `m` is not a member of `T` (i.e. the refinement is structural), an additional condition applies. In this case, the member _definition_ `m` of `S` will have a parameter - with type `A'` say. The additional condition is that the erasure of `A'` and `A` is the same. Here is an example: - - ```scala - class Sink[A] { def put(x: A): Unit = {} } - val a = Sink[String]() - val b: { def put(x: String): Unit } = a // error - b.put("abc") // looks for a method with a `String` parameter - ``` - The second to last line is not well-typed, - since the erasure of the parameter type of `put` in class `Sink` is `Object`, - but the erasure of `put`'s parameter in the type of `b` is `String`. - This additional condition is necessary, since we will have to resort - to some (as yet unknown) form of reflection to call a structural member - like `put` in the type of `b` above. The condition ensures that the statically - known parameter types of the refinement correspond up to erasure to the - parameter types of the selected call target at runtime. - - Most reflection dispatch algorithms need to know exact erased parameter types. For instance, if the example above would typecheck, the call - `b.put("abc")` on the last line would look for a method `put` in the runtime type of `b` that takes a `String` parameter. But the `put` method is the one from class `Sink`, which takes an `Object` parameter. Hence the call would fail at runtime with a `NoSuchMethodException`. - - One might hope for a "more intelligent" reflexive dispatch algorithm that does not require exact parameter type matching. Unfortunately, this can always run into ambiguities, as long as overloading is a possibility. For instance, continuing the example above, we might introduce a new subclass `Sink1` of `Sink` and change the definition of `a` as follows: - - ```scala - class Sink1[A] extends Sink[A] { def put(x: "123") = ??? } - val a: Sink[String] = Sink1[String]() - ``` - - Now there are two `put` methods in the runtime type of `b` with erased parameter - types `Object` and `String`, respectively. Yet dynamic dispatch still needs to go - to the first `put` method, even though the second looks like a better match. - - For the cases where we can in fact implement reflection without knowing precise parameter types (for instance if static overloading is replaced by dynamically dispatched multi-methods), there is an escape hatch. For types that extend `scala.Selectable.WithoutPreciseParameterTypes` the signature check is omitted. Example: - - ```scala - trait MultiMethodSelectable extends Selectable.WithoutPreciseParameterTypes: - // Assume this version of `applyDynamic` can be implemented without knowing - // precise parameter types `paramTypes`: - def applyDynamic(name: String, paramTypes: Class[_]*)(args: Any*): Any = ??? - - class Sink[A] extends MultiMethodSelectable: - def put(x: A): Unit = {} - - val a = new Sink[String] - val b: MultiMethodSelectable { def put(x: String): Unit } = a // OK - ``` -## Differences with Scala 2 Structural Types - -- Scala 2 supports structural types by means of Java reflection. Unlike - Scala 3, structural calls do not rely on a mechanism such as - `Selectable`, and reflection cannot be avoided. -- In Scala 2, refinements can introduce overloads. -- In Scala 2, mutable `var`s are allowed in refinements. In Scala 3, - they are no longer allowed. -- Scala 2 does not impose the "same-erasure" restriction on subtyping of structural types. It allows some calls to fail at runtime instead. - -## Context - -For more information, see [Rethink Structural Types](https://github.com/lampepfl/dotty/issues/1886). diff --git a/_scala3-reference/changed-features/structural-types.md b/_scala3-reference/changed-features/structural-types.md deleted file mode 100644 index fe20a3aa54..0000000000 --- a/_scala3-reference/changed-features/structural-types.md +++ /dev/null @@ -1,194 +0,0 @@ ---- -title: "Programmatic Structural Types" -type: section -num: 53 -previous-page: /scala3/reference/changed-features/numeric-literals -next-page: /scala3/reference/changed-features/operators ---- - -## Motivation - -Some usecases, such as modelling database access, are more awkward in -statically typed languages than in dynamically typed languages: With -dynamically typed languages, it's quite natural to model a row as a -record or object, and to select entries with simple dot notation (e.g. -`row.columnName`). - -Achieving the same experience in statically typed -language requires defining a class for every possible row arising from -database manipulation (including rows arising from joins and -projections) and setting up a scheme to map between a row and the -class representing it. - -This requires a large amount of boilerplate, which leads developers to -trade the advantages of static typing for simpler schemes where colum -names are represented as strings and passed to other operators (e.g. -`row.select("columnName")`). This approach forgoes the advantages of -static typing, and is still not as natural as the dynamically typed -version. - -Structural types help in situations where we would like to support -simple dot notation in dynamic contexts without losing the advantages -of static typing. They allow developers to use dot notation and -configure how fields and methods should be resolved. - -## Example - -Here's an example of a structural type `Person`: - -```scala - class Record(elems: (String, Any)*) extends Selectable: - private val fields = elems.toMap - def selectDynamic(name: String): Any = fields(name) - - type Person = Record { val name: String; val age: Int } - ``` - -The type `Person` adds a _refinement_ to its parent type `Record` that defines the two fields `name` and `age`. We say the refinement is _structural_ since `name` and `age` are not defined in the parent type. But they exist nevertheless as members of class `Person`. For instance, the following -program would print "Emma is 42 years old.": - -```scala - val person = Record("name" -> "Emma", "age" -> 42).asInstanceOf[Person] - println(s"${person.name} is ${person.age} years old.") -``` - -The parent type `Record` in this example is a generic class that can represent arbitrary records in its `elems` argument. This argument is a -sequence of pairs of labels of type `String` and values of type `Any`. -When we create a `Person` as a `Record` we have to assert with a typecast -that the record defines the right fields of the right types. `Record` -itself is too weakly typed so the compiler cannot know this without -help from the user. In practice, the connection between a structural type -and its underlying generic representation would most likely be done by -a database layer, and therefore would not be a concern of the end user. - -`Record` extends the marker trait `scala.Selectable` and defines -a method `selectDynamic`, which maps a field name to its value. -Selecting a structural type member is done by calling this method. -The `person.name` and `person.age` selections are translated by -the Scala compiler to: - -```scala - person.selectDynamic("name").asInstanceOf[String] - person.selectDynamic("age").asInstanceOf[Int] -``` - -Besides `selectDynamic`, a `Selectable` class sometimes also defines a method `applyDynamic`. This can then be used to translate function calls of structural members. So, if `a` is an instance of `Selectable`, a structural call like `a.f(b, c)` would translate to - -```scala - a.applyDynamic("f")(b, c) -``` - -## Using Java Reflection - -Structural types can also be accessed using [Java reflection](https://www.oracle.com/technical-resources/articles/java/javareflection.html). Example: - -```scala - type Closeable = { def close(): Unit } - - class FileInputStream: - def close(): Unit - - class Channel: - def close(): Unit -``` - -Here, we define a structural type `Closeable` that defines a `close` method. There are various classes that have `close` methods, we just list `FileInputStream` and `Channel` as two examples. It would be easiest if the two classes shared a common interface that factors out the `close` method. But such factorings are often not possible if different libraries are combined in one application. Yet, we can still have methods that work on -all classes with a `close` method by using the `Closeable` type. For instance, - -```scala - import scala.reflect.Selectable.reflectiveSelectable - - def autoClose(f: Closeable)(op: Closeable => Unit): Unit = - try op(f) finally f.close() -``` - -The call `f.close()` has to use Java reflection to identify and call the `close` method in the receiver `f`. This needs to be enabled by an import -of `reflectiveSelectable` shown above. What happens "under the hood" is then the following: - - - The import makes available an implicit conversion that turns any type into a - `Selectable`. `f` is wrapped in this conversion. - - - The compiler then transforms the `close` call on the wrapped `f` - to an `applyDynamic` call. The end result is: - - ```scala - reflectiveSelectable(f).applyDynamic("close")() - ``` - - The implementation of `applyDynamic` in `reflectiveSelectable`'s result -uses Java reflection to find and call a method `close` with zero parameters in the value referenced by `f` at runtime. - -Structural calls like this tend to be much slower than normal method calls. The mandatory import of `reflectiveSelectable` serves as a signpost that something inefficient is going on. - -**Note:** In Scala 2, Java reflection is the only mechanism available for structural types and it is automatically enabled without needing the -`reflectiveSelectable` conversion. However, to warn against inefficient -dispatch, Scala 2 requires a language import `import scala.language.reflectiveCalls`. - -Before resorting to structural calls with Java reflection one should consider alternatives. For instance, sometimes a more a modular _and_ efficient architecture can be obtained using type classes. - -## Extensibility - -New instances of `Selectable` can be defined to support means of -access other than Java reflection, which would enable usages such as -the database access example given at the beginning of this document. - -## Local Selectable Instances - -Local and anonymous classes that extend `Selectable` get more refined types -than other classes. Here is an example: - -```scala -trait Vehicle extends reflect.Selectable: - val wheels: Int - -val i3 = new Vehicle: // i3: Vehicle { val range: Int } - val wheels = 4 - val range = 240 - -i3.range -``` - -The type of `i3` in this example is `Vehicle { val range: Int }`. Hence, -`i3.range` is well-formed. Since the base class `Vehicle` does not define a `range` field or method, we need structural dispatch to access the `range` field of the anonymous class that initializes `id3`. Structural dispatch -is implemented by the base trait `reflect.Selectable` of `Vehicle`, which -defines the necessary `selectDynamic` member. - -`Vehicle` could also extend some other subclass of `scala.Selectable` that implements `selectDynamic` and `applyDynamic` differently. But if it does not extend a `Selectable` at all, the code would no longer typecheck: - -```scala -trait Vehicle: - val wheels: Int - -val i3 = new Vehicle: // i3: Vehicle - val wheels = 4 - val range = 240 - -i3.range // error: range is not a member of `Vehicle` -``` - -The difference is that the type of an anonymous class that does not extend `Selectable` is just formed from the parent type(s) of the class, without -adding any refinements. Hence, `i3` now has just type `Vehicle` and the selection `i3.range` gives a "member not found" error. - -Note that in Scala 2 all local and anonymous classes could produce values with refined types. But -members defined by such refinements could be selected only with the language import -`reflectiveCalls`. - -## Relation with `scala.Dynamic` - -There are clearly some connections with `scala.Dynamic` here, since -both select members programmatically. But there are also some -differences. - -- Fully dynamic selection is not typesafe, but structural selection - is, as long as the correspondence of the structural type with the - underlying value is as stated. - -- `Dynamic` is just a marker trait, which gives more leeway where and - how to define reflective access operations. By contrast - `Selectable` is a trait which declares the access operations. - -- Two access operations, `selectDynamic` and `applyDynamic` are shared - between both approaches. In `Selectable`, `applyDynamic` also may also take - `java.lang.Class` arguments indicating the method's formal parameter types. - `Dynamic` comes with `updateDynamic`. - -[More details](structural-types-spec.html) diff --git a/_scala3-reference/changed-features/type-checking.md b/_scala3-reference/changed-features/type-checking.md deleted file mode 100644 index 81ca345a6c..0000000000 --- a/_scala3-reference/changed-features/type-checking.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: "Changes in Type Checking" -type: section -num: 57 -previous-page: /scala3/reference/changed-features/imports -next-page: /scala3/reference/changed-features/type-inference ---- - -*** **TO BE FILLED IN** *** diff --git a/_scala3-reference/changed-features/type-inference.md b/_scala3-reference/changed-features/type-inference.md deleted file mode 100644 index 873c918312..0000000000 --- a/_scala3-reference/changed-features/type-inference.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "Changes in Type Inference" -type: section -num: 58 -previous-page: /scala3/reference/changed-features/type-checking -next-page: /scala3/reference/changed-features/implicit-resolution ---- - -For more information, see the two presentations - -* [Scala 3, Type inference and You!](https://www.youtube.com/watch?v=lMvOykNQ4zs) by Guillaume Martres (September 2019) -* [GADTs in Dotty](https://www.youtube.com/watch?v=VV9lPg3fNl8) by Aleksander Boruch-Gruszecki (July 2019). diff --git a/_scala3-reference/changed-features/vararg-splices.md b/_scala3-reference/changed-features/vararg-splices.md deleted file mode 100644 index efa7f034ac..0000000000 --- a/_scala3-reference/changed-features/vararg-splices.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: "Vararg Splices" -type: section -num: 63 -previous-page: /scala3/reference/changed-features/match-syntax -next-page: /scala3/reference/changed-features/pattern-bindings ---- - -The syntax of vararg splices in patterns and function arguments has changed. The new syntax uses a postfix `*`, analogously to how a vararg parameter is declared. - -```scala -val arr = Array(0, 1, 2, 3) -val lst = List(arr*) // vararg splice argument -lst match - case List(0, 1, xs*) => println(xs) // binds xs to Seq(2, 3) - case List(1, _*) => // wildcard pattern -``` - -The old syntax for splice arguments will be phased out. - -```scala -/*!*/ val lst = List(arr: _*) // syntax error - lst match - case List(0, 1, xs @ _*) // ok, equivalent to `xs*` -``` - -## Syntax - -``` -ArgumentPatterns ::= ‘(’ [Patterns] ‘)’ - | ‘(’ [Patterns ‘,’] Pattern2 ‘*’ ‘)’ - -ParArgumentExprs ::= ‘(’ [‘using’] ExprsInParens ‘)’ - | ‘(’ [ExprsInParens ‘,’] PostfixExpr ‘*’ ‘)’ -``` - -## Compatibility considerations - -To enable cross compilation between Scala 2 and Scala 3, the compiler will -accept both the old and the new syntax. Under the `-source future` setting, an error -will be emitted when the old syntax is encountered. An automatic rewrite from old -to new syntax is offered under `-source future-migration`. diff --git a/_scala3-reference/changed-features/wildcards.md b/_scala3-reference/changed-features/wildcards.md deleted file mode 100644 index fdf69fdcd9..0000000000 --- a/_scala3-reference/changed-features/wildcards.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Wildcard Arguments in Types -type: section -num: 55 -previous-page: /scala3/reference/changed-features/operators -next-page: /scala3/reference/changed-features/imports ---- - -The syntax of wildcard arguments in types has changed from `_` to `?`. Example: -```scala -List[?] -Map[? <: AnyRef, ? >: Null] -``` - -### Motivation - -We would like to use the underscore syntax `_` to stand for an anonymous type parameter, aligning it with its meaning in -value parameter lists. So, just as `f(_)` is a shorthand for the lambda `x => f(x)`, in the future `C[_]` will be a shorthand -for the type lambda `[X] =>> C[X]`. This makes higher-kinded types easier to use. It also removes the wart that, used as a type -parameter, `F[_]` means `F` is a type constructor whereas used as a type, `F[_]` means it is a wildcard (i.e. existential) type. -In the future, `F[_]` will mean the same thing, no matter where it is used. - -We pick `?` as a replacement syntax for wildcard types, since it aligns with -[Java's syntax](https://docs.oracle.com/javase/tutorial/java/generics/wildcardGuidelines.html). - -### Migration Strategy - -The migration to the new scheme is complicated, in particular since the [kind projector](https://github.com/typelevel/kind-projector) -compiler plugin still uses the reverse convention, with `?` meaning parameter placeholder instead of wildcard. Fortunately, kind projector has added `*` as an alternative syntax for `?`. - -A step-by-step migration is made possible with the following measures: - - 1. In Scala 3.0, both `_` and `?` are legal names for wildcards. - 2. In Scala 3.1, `_` is deprecated in favor of `?` as a name for a wildcard. A `-rewrite` option is - available to rewrite one to the other. - 3. In Scala 3.2, the meaning of `_` changes from wildcard to placeholder for type parameter. - 4. The Scala 3.1 behavior is already available today under the `-source future` setting. - -To smooth the transition for codebases that use kind-projector, we adopt the following measures under the command line -option `-Ykind-projector`: - - 1. In Scala 3.0, `*` is available as a type parameter placeholder. - 2. In Scala 3.2, `*` is deprecated in favor of `_`. A `-rewrite` option is - available to rewrite one to the other. - 3. In Scala 3.3, `*` is removed again, and all type parameter placeholders will be expressed with `_`. - -These rules make it possible to cross build between Scala 2 using the kind projector plugin and Scala 3.0 - 3.2 using the compiler option `-Ykind-projector`. - -There is also a migration path for users that want a one-time transition to syntax with `_` as a type parameter placeholder. -With option `-Ykind-projector:underscores` Scala 3 will regard `_` as a type parameter placeholder, leaving `?` as the only syntax for wildcards. - -To cross-compile with old Scala 2 sources, while using `_` a placeholder, you must use options `-Xsource:3 -P:kind-projector:underscore-placeholders` together with a recent version of kind-projector (`0.13` and higher) and most recent versions of Scala 2 (`2.13.5` and higher and `2.12.14` and higher) diff --git a/_scala3-reference/contextual.md b/_scala3-reference/contextual.md deleted file mode 100644 index 1dfc5e6baa..0000000000 --- a/_scala3-reference/contextual.md +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: "Contextual Abstractions" -type: chapter -num: 13 -previous-page: /scala3/reference/enums/desugarEnums -next-page: /scala3/reference/contextual/givens ---- - -### Critique of the Status Quo - -Scala's implicits are its most distinguished feature. They are _the_ fundamental way to abstract over context. They represent a unified paradigm with a great variety of use cases, among them: implementing type classes, establishing context, dependency injection, expressing capabilities, computing new types and proving relationships between them. - -Following Haskell, Scala was the second popular language to have some form of implicits. Other languages have followed suit. E.g [Rust's traits](https://doc.rust-lang.org/rust-by-example/trait.html) or [Swift's protocol extensions](https://docs.swift.org/swift-book/LanguageGuide/Protocols.html#ID521). Design proposals are also on the table for Kotlin as [compile time dependency resolution](https://github.com/Kotlin/KEEP/blob/e863b25f8b3f2e9b9aaac361c6ee52be31453ee0/proposals/compile-time-dependency-resolution.md), for C# as [Shapes and Extensions](https://github.com/dotnet/csharplang/issues/164) -or for F# as [Traits](https://github.com/MattWindsor91/visualfsharp/blob/hackathon-vs/examples/fsconcepts.md). Implicits are also a common feature of theorem provers such as [Coq](https://coq.inria.fr/refman/language/extensions/implicit-arguments.html) or [Agda](https://agda.readthedocs.io/en/latest/language/implicit-arguments.html). - -Even though these designs use widely different terminology, they are all variants of the core idea of _term inference_. Given a type, the compiler synthesizes a "canonical" term that has that type. Scala embodies the idea in a purer form than most other languages: An implicit parameter directly leads to an inferred argument term that could also be written down explicitly. By contrast, type class based designs are less direct since they hide term inference behind some form of type classification and do not offer the option of writing the inferred quantities (typically, dictionaries) explicitly. - -Given that term inference is where the industry is heading, and given that Scala has it in a very pure form, how come implicits are not more popular? In fact, it's fair to say that implicits are at the same time Scala's most distinguished and most controversial feature. I believe this is due to a number of aspects that together make implicits harder to learn than necessary and also make it harder to prevent abuses. - -Particular criticisms are: - -1. Being very powerful, implicits are easily over-used and mis-used. This observation holds in almost all cases when we talk about _implicit conversions_, which, even though conceptually different, share the same syntax with other implicit definitions. For instance, regarding the two definitions - - ```scala - implicit def i1(implicit x: T): C[T] = ... - implicit def i2(x: T): C[T] = ... - ``` - - the first of these is a conditional implicit _value_, the second an implicit _conversion_. Conditional implicit values are a cornerstone for expressing type classes, whereas most applications of implicit conversions have turned out to be of dubious value. The problem is that many newcomers to the language start with defining implicit conversions since they are easy to understand and seem powerful and convenient. Scala 3 will put under a language flag both definitions and applications of "undisciplined" implicit conversions between types defined elsewhere. This is a useful step to push back against overuse of implicit conversions. But the problem remains that syntactically, conversions and values just look too similar for comfort. - -2. Another widespread abuse is over-reliance on implicit imports. This often leads to inscrutable type errors that go away with the right import incantation, leaving a feeling of frustration. Conversely, it is hard to see what implicits a program uses since implicits can hide anywhere in a long list of imports. - -3. The syntax of implicit definitions is too minimal. It consists of a single modifier, `implicit`, that can be attached to a large number of language constructs. A problem with this for newcomers is that it conveys mechanism instead of intent. For instance, a type class instance is an implicit object or val if unconditional and an implicit def with implicit parameters referring to some class if conditional. This describes precisely what the implicit definitions translate to -- just drop the `implicit` modifier, and that's it! But the cues that define intent are rather indirect and can be easily misread, as demonstrated by the definitions of `i1` and `i2` above. - -4. The syntax of implicit parameters also has shortcomings. While implicit _parameters_ are designated specifically, arguments are not. Passing an argument to an implicit parameter looks like a regular application `f(arg)`. This is problematic because it means there can be confusion regarding what parameter gets instantiated in a call. For instance, in - - ```scala - def currentMap(implicit ctx: Context): Map[String, Int] - ``` - - one cannot write `currentMap("abc")` since the string `"abc"` is taken as explicit argument to the implicit `ctx` parameter. One has to write `currentMap.apply("abc")` instead, which is awkward and irregular. For the same reason, a method definition can only have one implicit parameter section and it must always come last. This restriction not only reduces orthogonality, but also prevents some useful program constructs, such as a method with a regular parameter whose type depends on an implicit value. Finally, it's also a bit annoying that implicit parameters must have a name, even though in many cases that name is never referenced. - -5. Implicits pose challenges for tooling. The set of available implicits depends on context, so command completion has to take context into account. This is feasible in an IDE but tools like [Scaladoc](https://docs.scala-lang.org/overviews/scaladoc/overview.html) that are based on static web pages can only provide an approximation. Another problem is that failed implicit searches often give very unspecific error messages, in particular if some deeply recursive implicit search has failed. Note that the Scala 3 compiler has already made a lot of progress in the error diagnostics area. If a recursive search fails some levels down, it shows what was constructed and what is missing. Also, it suggests imports that can bring missing implicits in scope. - -None of the shortcomings is fatal, after all implicits are very widely used, and many libraries and applications rely on them. But together, they make code using implicits a lot more cumbersome and less clear than it could be. - -Historically, many of these shortcomings come from the way implicits were gradually "discovered" in Scala. Scala originally had only implicit conversions with the intended use case of "extending" a class or trait after it was defined, i.e. what is expressed by implicit classes in later versions of Scala. Implicit parameters and instance definitions came later in 2006 and we picked similar syntax since it seemed convenient. For the same reason, no effort was made to distinguish implicit imports or arguments from normal ones. - -Existing Scala programmers by and large have gotten used to the status quo and see little need for change. But for newcomers this status quo presents a big hurdle. I believe if we want to overcome that hurdle, we should take a step back and allow ourselves to consider a radically new design. - -### The New Design - -The following pages introduce a redesign of contextual abstractions in Scala. They introduce four fundamental changes: - -1. [Given Instances](./contextual/givens.html) are a new way to define basic terms that can be synthesized. They replace implicit definitions. The core principle of the proposal is that, rather than mixing the `implicit` modifier with a large number of features, we have a single way to define terms that can be synthesized for types. - -2. [Using Clauses](./contextual/using-clauses.html) are a new syntax for implicit _parameters_ and their _arguments_. It unambiguously aligns parameters and arguments, solving a number of language warts. It also allows us to have several `using` clauses in a definition. - -3. ["Given" Imports](./contextual/given-imports.html) are a new class of import selectors that specifically import - givens and nothing else. - -4. [Implicit Conversions](./contextual/conversions.html) are now expressed as given instances of a standard `Conversion` class. All other forms of implicit conversions will be phased out. - -This section also contains pages describing other language features that are related to context abstraction. These are: - -- [Context Bounds](./contextual/context-bounds.html), which carry over unchanged. -- [Extension Methods](./contextual/extension-methods.html) replace implicit classes in a way that integrates better with type classes. -- [Implementing Type Classes](./contextual/type-classes.html) demonstrates how some common type classes can be implemented using the new constructs. -- [Type Class Derivation](./contextual/derivation.html) introduces constructs to automatically derive type class instances for ADTs. -- [Multiversal Equality](./contextual/multiversal-equality.html) introduces a special type class to support type safe equality. -- [Context Functions](./contextual/context-functions.html) provide a way to abstract over context parameters. -- [By-Name Context Parameters](./contextual/by-name-context-parameters.html) are an essential tool to define recursive synthesized values without looping. -- [Relationship with Scala 2 Implicits](./contextual/relationship-implicits.html) discusses the relationship between old-style implicits and new-style givens and how to migrate from one to the other. - -Overall, the new design achieves a better separation of term inference from the rest of the language: There is a single way to define givens instead of a multitude of forms all taking an `implicit` modifier. There is a single way to introduce implicit parameters and arguments instead of conflating implicit with normal arguments. There is a separate way to import givens that does not allow them to hide in a sea of normal imports. And there is a single way to define an implicit conversion which is clearly marked as such and does not require special syntax. - -This design thus avoids feature interactions and makes the language more consistent and orthogonal. It will make implicits easier to learn and harder to abuse. It will greatly improve the clarity of the 95% of Scala programs that use implicits. It has thus the potential to fulfil the promise of term inference in a principled way that is also accessible and friendly. - -Could we achieve the same goals by tweaking existing implicits? After having tried for a long time, I believe now that this is impossible. - -- First, some of the problems are clearly syntactic and require different syntax to solve them. -- Second, there is the problem how to migrate. We cannot change the rules in mid-flight. At some stage of language evolution we need to accommodate both the new and the old rules. With a syntax change, this is easy: Introduce the new syntax with new rules, support the old syntax for a while to facilitate cross compilation, deprecate and phase out the old syntax at some later time. Keeping the same syntax does not offer this path, and in fact does not seem to offer any viable path for evolution -- Third, even if we would somehow succeed with migration, we still have the problem - how to teach this. We cannot make existing tutorials go away. Almost all existing tutorials start with implicit conversions, which will go away; they use normal imports, which will go away, and they explain calls to methods with implicit parameters by expanding them to plain applications, which will also go away. This means that we'd have - to add modifications and qualifications to all existing literature and courseware, likely causing more confusion with beginners instead of less. By contrast, with a new syntax there is a clear criterion: Any book or courseware that mentions `implicit` is outdated and should be updated. diff --git a/_scala3-reference/contextual/by-name-context-parameters.md b/_scala3-reference/contextual/by-name-context-parameters.md deleted file mode 100644 index c1777b6259..0000000000 --- a/_scala3-reference/contextual/by-name-context-parameters.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: "By-Name Context Parameters" -type: section -num: 25 -previous-page: /scala3/reference/contextual/conversions -next-page: /scala3/reference/contextual/relationship-implicits ---- - -Context parameters can be declared by-name to avoid a divergent inferred expansion. Example: - -```scala -trait Codec[T]: - def write(x: T): Unit - -given intCodec: Codec[Int] = ??? - -given optionCodec[T](using ev: => Codec[T]): Codec[Option[T]] with - def write(xo: Option[T]) = xo match - case Some(x) => ev.write(x) - case None => - -val s = summon[Codec[Option[Int]]] - -s.write(Some(33)) -s.write(None) -``` -As is the case for a normal by-name parameter, the argument for the context parameter `ev` -is evaluated on demand. In the example above, if the option value `x` is `None`, it is -not evaluated at all. - -The synthesized argument for a context parameter is backed by a local val -if this is necessary to prevent an otherwise diverging expansion. - -The precise steps for synthesizing an argument for a by-name context parameter of type `=> T` are as follows. - - 1. Create a new given of type `T`: - - ```scala - given lv: T = ??? - ``` - - where `lv` is an arbitrary fresh name. - - 1. This given is not immediately available as candidate for argument inference (making it immediately available could result in a loop in the synthesized computation). But it becomes available in all nested contexts that look again for an argument to a by-name context parameter. - - 1. If this search succeeds with expression `E`, and `E` contains references to `lv`, replace `E` by - - ```scala - { given lv: T = E; lv } - ``` - - Otherwise, return `E` unchanged. - -In the example above, the definition of `s` would be expanded as follows. - -```scala -val s = summon[Test.Codec[Option[Int]]]( - optionCodec[Int](using intCodec) -) -``` - -No local given instance was generated because the synthesized argument is not recursive. - -### Reference - -For more information, see [Issue #1998](https://github.com/lampepfl/dotty/issues/1998) -and the associated [Scala SIP](https://docs.scala-lang.org/sips/byname-implicits.html). diff --git a/_scala3-reference/contextual/context-bounds.md b/_scala3-reference/contextual/context-bounds.md deleted file mode 100644 index 5c7ea5cd59..0000000000 --- a/_scala3-reference/contextual/context-bounds.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "Context Bounds" -type: section -num: 17 -previous-page: /scala3/reference/contextual/using-clauses -next-page: /scala3/reference/contextual/given-imports ---- - -A context bound is a shorthand for expressing the common pattern of a context parameter that depends on a type parameter. Using a context bound, the `maximum` function of the last section can be written like this: - -```scala -def maximum[T: Ord](xs: List[T]): T = xs.reduceLeft(max) -``` - -A bound like `: Ord` on a type parameter `T` of a method or class indicates a context parameter `using Ord[T]`. The context parameter(s) generated from context bounds come last in the definition of the containing method or class. For instance, - -```scala -def f[T: C1 : C2, U: C3](x: T)(using y: U, z: V): R -``` - -would expand to - -```scala -def f[T, U](x: T)(using y: U, z: V)(using C1[T], C2[T], C3[U]): R -``` - -Context bounds can be combined with subtype bounds. If both are present, subtype bounds come first, e.g. - -```scala -def g[T <: B : C](x: T): R = ... -``` - -## Migration - -To ease migration, context bounds in Dotty map in Scala 3.0 to old-style implicit parameters -for which arguments can be passed either with a `(using ...)` clause or with a normal application. From Scala 3.1 on, they will map to context parameters instead, as is described above. - -If the source version is `future-migration`, any pairing of an evidence -context parameter stemming from a context bound with a normal argument will give a migration -warning. The warning indicates that a `(using ...)` clause is needed instead. The rewrite can be -done automatically under `-rewrite`. - -## Syntax - -``` -TypeParamBounds ::= [SubtypeBounds] {ContextBound} -ContextBound ::= ‘:’ Type -``` diff --git a/_scala3-reference/contextual/context-functions-spec.md b/_scala3-reference/contextual/context-functions-spec.md deleted file mode 100644 index 9267eea23f..0000000000 --- a/_scala3-reference/contextual/context-functions-spec.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Context Functions - More Details" ---- - -## Syntax - -``` -Type ::= ... - | FunArgTypes ‘?=>’ Type -Expr ::= ... - | FunParams ‘?=>’ Expr -``` - -Context function types associate to the right, e.g. -`S ?=> T ?=> U` is the same as `S ?=> (T ?=> U)`. - -## Implementation - -Context function types are shorthands for class types that define `apply` -methods with context parameters. Specifically, the `N`-ary function type - -`T1, ..., TN ?=> R` is a shorthand for the class type -`ContextFunctionN[T1, ..., TN, R]`. Such class types are assumed to have the following definitions, for any value of `N >= 1`: - -```scala -package scala -trait ContextFunctionN[-T1, ..., -TN, +R]: - def apply(using x1: T1, ..., xN: TN): R -``` - -Context function types erase to normal function types, so these classes are -generated on the fly for typechecking, but not realized in actual code. - -Context function literals `(x1: T1, ..., xn: Tn) ?=> e` map -context parameters `xi` of types `Ti` to the result of evaluating the expression `e`. -The scope of each context parameter `xi` is `e`. The parameters must have pairwise distinct names. - -If the expected type of the context function literal is of the form -`scala.ContextFunctionN[S1, ..., Sn, R]`, the expected type of `e` is `R` and -the type `Ti` of any of the parameters `xi` can be omitted, in which case `Ti -= Si` is assumed. If the expected type of the context function literal is -some other type, all context parameter types must be explicitly given, and the expected type of `e` is undefined. -The type of the context function literal is `scala.ContextFunctionN[S1, ...,Sn, T]`, where `T` is the widened -type of `e`. `T` must be equivalent to a type which does not refer to any of -the context parameters `xi`. - -The context function literal is evaluated as the instance creation expression - -```scala -new scala.ContextFunctionN[T1, ..., Tn, T]: - def apply(using x1: T1, ..., xn: Tn): T = e -``` - -A context parameter may also be a wildcard represented by an underscore `_`. In that case, a fresh name for the parameter is chosen arbitrarily. - -**Note:** The closing paragraph of the -[Anonymous Functions section](https://www.scala-lang.org/files/archive/spec/2.13/06-expressions.html#anonymous-functions) -of Scala 2.13 is subsumed by context function types and should be removed. - -Context function literals `(x1: T1, ..., xn: Tn) ?=> e` are -automatically created for any expression `e` whose expected type is -`scala.ContextFunctionN[T1, ..., Tn, R]`, unless `e` is -itself a context function literal. This is analogous to the automatic -insertion of `scala.Function0` around expressions in by-name argument position. - -Context function types generalize to `N > 22` in the same way that function types do, see [the corresponding -documentation](../dropped-features/limit22.html). - -## Examples - -See the section on Expressiveness from [Simplicitly: foundations and -applications of implicit function -types](https://dl.acm.org/citation.cfm?id=3158130). - -### Type Checking - -After desugaring no additional typing rules are required for context function types. diff --git a/_scala3-reference/contextual/context-functions.md b/_scala3-reference/contextual/context-functions.md deleted file mode 100644 index 1b930b3c8d..0000000000 --- a/_scala3-reference/contextual/context-functions.md +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: "Context Functions" -type: section -num: 23 -previous-page: /scala3/reference/contextual/multiversal-equality -next-page: /scala3/reference/contextual/conversions ---- - -_Context functions_ are functions with (only) context parameters. -Their types are _context function types_. Here is an example of a context function type: - -```scala -type Executable[T] = ExecutionContext ?=> T -``` -Context functions are written using `?=>` as the "arrow" sign. -They are applied to synthesized arguments, in -the same way methods with context parameters are applied. For instance: -```scala - given ec: ExecutionContext = ... - - def f(x: Int): ExecutionContext ?=> Int = ... - - // could be written as follows with the type alias from above - // def f(x: Int): Executable[Int] = ... - - f(2)(using ec) // explicit argument - f(2) // argument is inferred -``` -Conversely, if the expected type of an expression `E` is a context function type -`(T_1, ..., T_n) ?=> U` and `E` is not already an -context function literal, `E` is converted to a context function literal by rewriting it to -```scala - (x_1: T1, ..., x_n: Tn) ?=> E -``` -where the names `x_1`, ..., `x_n` are arbitrary. This expansion is performed -before the expression `E` is typechecked, which means that `x_1`, ..., `x_n` -are available as givens in `E`. - -Like their types, context function literals are written using `?=>` as the arrow between parameters and results. They differ from normal function literals in that their types are context function types. - -For example, continuing with the previous definitions, -```scala - def g(arg: Executable[Int]) = ... - - g(22) // is expanded to g((ev: ExecutionContext) ?=> 22) - - g(f(2)) // is expanded to g((ev: ExecutionContext) ?=> f(2)(using ev)) - - g((ctx: ExecutionContext) ?=> f(3)) // is expanded to g((ctx: ExecutionContext) ?=> f(3)(using ctx)) - g((ctx: ExecutionContext) ?=> f(3)(using ctx)) // is left as it is -``` - -### Example: Builder Pattern - -Context function types have considerable expressive power. For -instance, here is how they can support the "builder pattern", where -the aim is to construct tables like this: -```scala - table { - row { - cell("top left") - cell("top right") - } - row { - cell("bottom left") - cell("bottom right") - } - } -``` -The idea is to define classes for `Table` and `Row` that allow the -addition of elements via `add`: -```scala - class Table: - val rows = new ArrayBuffer[Row] - def add(r: Row): Unit = rows += r - override def toString = rows.mkString("Table(", ", ", ")") - - class Row: - val cells = new ArrayBuffer[Cell] - def add(c: Cell): Unit = cells += c - override def toString = cells.mkString("Row(", ", ", ")") - - case class Cell(elem: String) -``` -Then, the `table`, `row` and `cell` constructor methods can be defined -with context function types as parameters to avoid the plumbing boilerplate -that would otherwise be necessary. -```scala - def table(init: Table ?=> Unit) = - given t: Table = Table() - init - t - - def row(init: Row ?=> Unit)(using t: Table) = - given r: Row = Row() - init - t.add(r) - - def cell(str: String)(using r: Row) = - r.add(new Cell(str)) -``` -With that setup, the table construction code above compiles and expands to: -```scala - table { ($t: Table) ?=> - - row { ($r: Row) ?=> - cell("top left")(using $r) - cell("top right")(using $r) - }(using $t) - - row { ($r: Row) ?=> - cell("bottom left")(using $r) - cell("bottom right")(using $r) - }(using $t) - } -``` -### Example: Postconditions - -As a larger example, here is a way to define constructs for checking arbitrary postconditions using an extension method `ensuring` so that the checked result can be referred to simply by `result`. The example combines opaque type aliases, context function types, and extension methods to provide a zero-overhead abstraction. - -```scala -object PostConditions: - opaque type WrappedResult[T] = T - - def result[T](using r: WrappedResult[T]): T = r - - extension [T](x: T) - def ensuring(condition: WrappedResult[T] ?=> Boolean): T = - assert(condition(using x)) - x -end PostConditions -import PostConditions.{ensuring, result} - -val s = List(1, 2, 3).sum.ensuring(result == 6) -``` -**Explanations**: We use a context function type `WrappedResult[T] ?=> Boolean` -as the type of the condition of `ensuring`. An argument to `ensuring` such as -`(result == 6)` will therefore have a given of type `WrappedResult[T]` in -scope to pass along to the `result` method. `WrappedResult` is a fresh type, to make sure -that we do not get unwanted givens in scope (this is good practice in all cases -where context parameters are involved). Since `WrappedResult` is an opaque type alias, its -values need not be boxed, and since `ensuring` is added as an extension method, its argument -does not need boxing either. Hence, the implementation of `ensuring` is close in efficiency to the best possible code one could write by hand: - -```scala -val s = - val result = List(1, 2, 3).sum - assert(result == 6) - result -``` -### Reference - -For more information, see the [blog article](https://www.scala-lang.org/blog/2016/12/07/implicit-function-types.html), -(which uses a different syntax that has been superseded). - -[More details](./context-functions-spec.html) diff --git a/_scala3-reference/contextual/conversions.md b/_scala3-reference/contextual/conversions.md deleted file mode 100644 index 5a222515ad..0000000000 --- a/_scala3-reference/contextual/conversions.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: "Implicit Conversions" -type: section -num: 24 -previous-page: /scala3/reference/contextual/context-functions -next-page: /scala3/reference/contextual/by-name-context-parameters ---- - -Implicit conversions are defined by given instances of the `scala.Conversion` class. -This class is defined in package `scala` as follows: -```scala -abstract class Conversion[-T, +U] extends (T => U): - def apply (x: T): U -``` -For example, here is an implicit conversion from `String` to `Token`: -```scala -given Conversion[String, Token] with - def apply(str: String): Token = new KeyWord(str) -``` -Using an alias this can be expressed more concisely as: -```scala -given Conversion[String, Token] = new KeyWord(_) -``` -An implicit conversion is applied automatically by the compiler in three situations: - -1. If an expression `e` has type `T`, and `T` does not conform to the expression's expected type `S`. -2. In a selection `e.m` with `e` of type `T`, but `T` defines no member `m`. -3. In an application `e.m(args)` with `e` of type `T`, if `T` does define - some member(s) named `m`, but none of these members can be applied to the arguments `args`. - -In the first case, the compiler looks for a given `scala.Conversion` instance that maps -an argument of type `T` to type `S`. In the second and third -case, it looks for a given `scala.Conversion` instance that maps an argument of type `T` -to a type that defines a member `m` which can be applied to `args` if present. -If such an instance `C` is found, the expression `e` is replaced by `C.apply(e)`. - -## Examples - -1. The `Predef` package contains "auto-boxing" conversions that map -primitive number types to subclasses of `java.lang.Number`. For instance, the -conversion from `Int` to `java.lang.Integer` can be defined as follows: - ```scala - given int2Integer: Conversion[Int, java.lang.Integer] = - java.lang.Integer.valueOf(_) - ``` - -2. The "magnet" pattern is sometimes used to express many variants of a method. Instead of defining overloaded versions of the method, one can also let the method take one or more arguments of specially defined "magnet" types, into which various argument types can be converted. Example: - ```scala - object Completions: - - // The argument "magnet" type - enum CompletionArg: - case Error(s: String) - case Response(f: Future[HttpResponse]) - case Status(code: Future[StatusCode]) - - object CompletionArg: - - // conversions defining the possible arguments to pass to `complete` - // these always come with CompletionArg - // They can be invoked explicitly, e.g. - // - // CompletionArg.fromStatusCode(statusCode) - - given fromString : Conversion[String, CompletionArg] = Error(_) - given fromFuture : Conversion[Future[HttpResponse], CompletionArg] = Response(_) - given fromStatusCode: Conversion[Future[StatusCode], CompletionArg] = Status(_) - end CompletionArg - import CompletionArg.* - - def complete[T](arg: CompletionArg) = arg match - case Error(s) => ... - case Response(f) => ... - case Status(code) => ... - - end Completions - ``` -This setup is more complicated than simple overloading of `complete`, but it can still be useful if normal overloading is not available (as in the case above, since we cannot have two overloaded methods that take `Future[...]` arguments), or if normal overloading would lead to a combinatorial explosion of variants. diff --git a/_scala3-reference/contextual/derivation-macro.md b/_scala3-reference/contextual/derivation-macro.md deleted file mode 100644 index c9c657d780..0000000000 --- a/_scala3-reference/contextual/derivation-macro.md +++ /dev/null @@ -1,204 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "How to write a type class `derived` method using macros" ---- - -In the main [derivation](./derivation.html) documentation page, we explained the -details behind `Mirror`s and type class derivation. Here we demonstrate how to -implement a type class `derived` method using macros only. We follow the same -example of deriving `Eq` instances and for simplicity we support a `Product` -type e.g., a case class `Person`. The low-level method we will use to implement -the `derived` method exploits quotes, splices of both expressions and types and -the `scala.quoted.Expr.summon` method which is the equivalent of -`summonFrom`. The former is suitable for use in a quote context, used within -macros. - -As in the original code, the type class definition is the same: - -```scala -trait Eq[T]: - def eqv(x: T, y: T): Boolean -``` - -we need to implement a method `Eq.derived` on the companion object of `Eq` that -produces a quoted instance for `Eq[T]`. Here is a possible signature, - -```scala -given derived[T: Type](using Quotes): Expr[Eq[T]] -``` - -and for comparison reasons we give the same signature we had with `inline`: - -```scala -inline given derived[T]: (m: Mirror.Of[T]) => Eq[T] = ??? -``` - -Note, that since a type is used in a subsequent stage it will need to be lifted -to a `Type` by using the corresponding context bound. Also, not that we can -summon the quoted `Mirror` inside the body of the `derived` this we can omit it -from the signature. The body of the `derived` method is shown below: - - -```scala -given derived[T: Type](using Quotes): Expr[Eq[T]] = - import quotes.reflect.* - - val ev: Expr[Mirror.Of[T]] = Expr.summon[Mirror.Of[T]].get - - ev match - case '{ $m: Mirror.ProductOf[T] { type MirroredElemTypes = elementTypes }} => - val elemInstances = summonAll[elementTypes] - val eqProductBody: (Expr[T], Expr[T]) => Expr[Boolean] = (x, y) => - elemInstances.zipWithIndex.foldLeft(Expr(true: Boolean)) { - case (acc, (elem, index)) => - val e1 = '{$x.asInstanceOf[Product].productElement(${Expr(index)})} - val e2 = '{$y.asInstanceOf[Product].productElement(${Expr(index)})} - '{ $acc && $elem.asInstanceOf[Eq[Any]].eqv($e1, $e2) } - } - - '{ eqProduct((x: T, y: T) => ${eqProductBody('x, 'y)}) } - - // case for Mirror.ProductOf[T] - // ... -``` - -Note, that in the `inline` case we can merely write -`summonAll[m.MirroredElemTypes]` inside the inline method but here, since -`Expr.summon` is required, we can extract the element types in a macro fashion. -Being inside a macro, our first reaction would be to write the code below. Since -the path inside the type argument is not stable this cannot be used: - -```scala -'{ - summonAll[$m.MirroredElemTypes] -} -``` - -Instead we extract the tuple-type for element types using pattern matching over -quotes and more specifically of the refined type: - -```scala - case '{ $m: Mirror.ProductOf[T] { type MirroredElemTypes = elementTypes }} => ... -``` - -Shown below is the implementation of `summonAll` as a macro. We assume that -given instances for our primitive types exist. - -```scala -def summonAll[T: Type](using Quotes): List[Expr[Eq[_]]] = - Type.of[T] match - case '[String *: tpes] => '{ summon[Eq[String]] } :: summonAll[tpes] - case '[Int *: tpes] => '{ summon[Eq[Int]] } :: summonAll[tpes] - case '[tpe *: tpes] => derived[tpe] :: summonAll[tpes] - case '[EmptyTuple] => Nil -``` - -One additional difference with the body of `derived` here as opposed to the one -with `inline` is that with macros we need to synthesize the body of the code during the -macro-expansion time. That is the rationale behind the `eqProductBody` function. -Assuming that we calculate the equality of two `Person`s defined with a case -class that holds a name of type [`String`](https://scala-lang.org/api/3.x/scala/Predef$.html#String-0) -and an age of type `Int`, the equality check we want to generate is the following: - -```scala - true - && Eq[String].eqv(x.productElement(0),y.productElement(0)) - && Eq[Int].eqv(x.productElement(1), y.productElement(1)) -``` - -## Calling the derived method inside the macro - -Following the rules in [Macros](../metaprogramming.html) we create two methods. -One that hosts the top-level splice `eqv` and one that is the implementation. -Alternatively and what is shown below is that we can call the `eqv` method -directly. The `eqGen` can trigger the derivation. - -```scala -extension [T](inline x: T) - inline def === (inline y: T)(using eq: Eq[T]): Boolean = eq.eqv(x, y) - -inline given eqGen[T]: Eq[T] = ${ Eq.derived[T] } -``` - -Note, that we use inline method syntax and we can compare instance such as -`Sm(Person("Test", 23)) === Sm(Person("Test", 24))` for e.g., the following two -types: - -```scala -case class Person(name: String, age: Int) - -enum Opt[+T]: - case Sm(t: T) - case Nn -``` - -The full code is shown below: - -```scala -import scala.deriving.* -import scala.quoted.* - - -trait Eq[T]: - def eqv(x: T, y: T): Boolean - -object Eq: - given Eq[String] with - def eqv(x: String, y: String) = x == y - - given Eq[Int] with - def eqv(x: Int, y: Int) = x == y - - def eqProduct[T](body: (T, T) => Boolean): Eq[T] = - new Eq[T]: - def eqv(x: T, y: T): Boolean = body(x, y) - - def eqSum[T](body: (T, T) => Boolean): Eq[T] = - new Eq[T]: - def eqv(x: T, y: T): Boolean = body(x, y) - - def summonAll[T: Type](using Quotes): List[Expr[Eq[_]]] = - Type.of[T] match - case '[String *: tpes] => '{ summon[Eq[String]] } :: summonAll[tpes] - case '[Int *: tpes] => '{ summon[Eq[Int]] } :: summonAll[tpes] - case '[tpe *: tpes] => derived[tpe] :: summonAll[tpes] - case '[EmptyTuple] => Nil - - given derived[T: Type](using q: Quotes): Expr[Eq[T]] = - import quotes.reflect.* - - val ev: Expr[Mirror.Of[T]] = Expr.summon[Mirror.Of[T]].get - - ev match - case '{ $m: Mirror.ProductOf[T] { type MirroredElemTypes = elementTypes }} => - val elemInstances = summonAll[elementTypes] - val eqProductBody: (Expr[T], Expr[T]) => Expr[Boolean] = (x, y) => - elemInstances.zipWithIndex.foldLeft(Expr(true: Boolean)) { - case (acc, (elem, index)) => - val e1 = '{$x.asInstanceOf[Product].productElement(${Expr(index)})} - val e2 = '{$y.asInstanceOf[Product].productElement(${Expr(index)})} - - '{ $acc && $elem.asInstanceOf[Eq[Any]].eqv($e1, $e2) } - } - '{ eqProduct((x: T, y: T) => ${eqProductBody('x, 'y)}) } - - case '{ $m: Mirror.SumOf[T] { type MirroredElemTypes = elementTypes }} => - val elemInstances = summonAll[elementTypes] - val eqSumBody: (Expr[T], Expr[T]) => Expr[Boolean] = (x, y) => - val ordx = '{ $m.ordinal($x) } - val ordy = '{ $m.ordinal($y) } - - val elements = Expr.ofList(elemInstances) - '{ $ordx == $ordy && $elements($ordx).asInstanceOf[Eq[Any]].eqv($x, $y) } - - '{ eqSum((x: T, y: T) => ${eqSumBody('x, 'y)}) } - end derived -end Eq - -object Macro3: - extension [T](inline x: T) - inline def === (inline y: T)(using eq: Eq[T]): Boolean = eq.eqv(x, y) - - inline given eqGen[T]: Eq[T] = ${ Eq.derived[T] } -``` diff --git a/_scala3-reference/contextual/derivation.md b/_scala3-reference/contextual/derivation.md deleted file mode 100644 index 8039cfdc1a..0000000000 --- a/_scala3-reference/contextual/derivation.md +++ /dev/null @@ -1,405 +0,0 @@ ---- -title: "Type Class Derivation" -type: section -num: 21 -previous-page: /scala3/reference/contextual/type-classes -next-page: /scala3/reference/contextual/multiversal-equality ---- - -Type class derivation is a way to automatically generate given instances for type classes which satisfy some simple -conditions. A type class in this sense is any trait or class with a type parameter determining the type being operated -on. Common examples are `Eq`, `Ordering`, or `Show`. For example, given the following `Tree` algebraic data type -(ADT), - -```scala -enum Tree[T] derives Eq, Ordering, Show: - case Branch(left: Tree[T], right: Tree[T]) - case Leaf(elem: T) -``` - -The `derives` clause generates the following given instances for the `Eq`, `Ordering` and `Show` type classes in the -companion object of `Tree`, - -```scala -given [T: Eq] : Eq[Tree[T]] = Eq.derived -given [T: Ordering] : Ordering[Tree] = Ordering.derived -given [T: Show] : Show[Tree] = Show.derived -``` - -We say that `Tree` is the _deriving type_ and that the `Eq`, `Ordering` and `Show` instances are _derived instances_. - -### Types supporting `derives` clauses - -All data types can have a `derives` clause. This document focuses primarily on data types which also have a given instance -of the `Mirror` type class available. Instances of the `Mirror` type class are generated automatically by the compiler -for, - -+ enums and enum cases -+ case classes and case objects -+ sealed classes or traits that have only case classes and case objects as children - -`Mirror` type class instances provide information at the type level about the components and labelling of the type. -They also provide minimal term level infrastructure to allow higher level libraries to provide comprehensive -derivation support. - -```scala -sealed trait Mirror: - - /** the type being mirrored */ - type MirroredType - - /** the type of the elements of the mirrored type */ - type MirroredElemTypes - - /** The mirrored *-type */ - type MirroredMonoType - - /** The name of the type */ - type MirroredLabel <: String - - /** The names of the elements of the type */ - type MirroredElemLabels <: Tuple - -object Mirror: - - /** The Mirror for a product type */ - trait Product extends Mirror: - - /** Create a new instance of type `T` with elements - * taken from product `p`. - */ - def fromProduct(p: scala.Product): MirroredMonoType - - trait Sum extends Mirror: - - /** The ordinal number of the case class of `x`. - * For enums, `ordinal(x) == x.ordinal` - */ - def ordinal(x: MirroredMonoType): Int - -end Mirror -``` - -Product types (i.e. case classes and objects, and enum cases) have mirrors which are subtypes of `Mirror.Product`. Sum -types (i.e. sealed class or traits with product children, and enums) have mirrors which are subtypes of `Mirror.Sum`. - -For the `Tree` ADT from above the following `Mirror` instances will be automatically provided by the compiler, - -```scala -// Mirror for Tree -new Mirror.Sum: - type MirroredType = Tree - type MirroredElemTypes[T] = (Branch[T], Leaf[T]) - type MirroredMonoType = Tree[_] - type MirroredLabel = "Tree" - type MirroredElemLabels = ("Branch", "Leaf") - - def ordinal(x: MirroredMonoType): Int = x match - case _: Branch[_] => 0 - case _: Leaf[_] => 1 - -// Mirror for Branch -new Mirror.Product: - type MirroredType = Branch - type MirroredElemTypes[T] = (Tree[T], Tree[T]) - type MirroredMonoType = Branch[_] - type MirroredLabel = "Branch" - type MirroredElemLabels = ("left", "right") - - def fromProduct(p: Product): MirroredMonoType = - new Branch(...) - -// Mirror for Leaf -new Mirror.Product: - type MirroredType = Leaf - type MirroredElemTypes[T] = Tuple1[T] - type MirroredMonoType = Leaf[_] - type MirroredLabel = "Leaf" - type MirroredElemLabels = Tuple1["elem"] - - def fromProduct(p: Product): MirroredMonoType = - new Leaf(...) -``` - -Note the following properties of `Mirror` types, - -+ Properties are encoded using types rather than terms. This means that they have no runtime footprint unless used and - also that they are a compile time feature for use with Scala 3's metaprogramming facilities. -+ The kinds of `MirroredType` and `MirroredElemTypes` match the kind of the data type the mirror is an instance for. - This allows `Mirror`s to support ADTs of all kinds. -+ There is no distinct representation type for sums or products (ie. there is no `HList` or `Coproduct` type as in - Scala 2 versions of Shapeless). Instead the collection of child types of a data type is represented by an ordinary, - possibly parameterized, tuple type. Scala 3's metaprogramming facilities can be used to work with these tuple types - as-is, and higher level libraries can be built on top of them. -+ For both product and sum types, the elements of `MirroredElemTypes` are arranged in definition order (i.e. `Branch[T]` - precedes `Leaf[T]` in `MirroredElemTypes` for `Tree` because `Branch` is defined before `Leaf` in the source file). - This means that `Mirror.Sum` differs in this respect from Shapeless's generic representation for ADTs in Scala 2, - where the constructors are ordered alphabetically by name. -+ The methods `ordinal` and `fromProduct` are defined in terms of `MirroredMonoType` which is the type of kind-`*` - which is obtained from `MirroredType` by wildcarding its type parameters. - -### Type classes supporting automatic deriving - -A trait or class can appear in a `derives` clause if its companion object defines a method named `derived`. The -signature and implementation of a `derived` method for a type class `TC[_]` are arbitrary but it is typically of the -following form, - -```scala -import scala.deriving.Mirror - -def derived[T](using Mirror.Of[T]): TC[T] = ... -``` - -That is, the `derived` method takes a context parameter of (some subtype of) type `Mirror` which defines the shape of -the deriving type `T`, and computes the type class implementation according to that shape. This is all that the -provider of an ADT with a `derives` clause has to know about the derivation of a type class instance. - -Note that `derived` methods may have context `Mirror` parameters indirectly (e.g. by having a context argument which in turn -has a context `Mirror` parameter, or not at all (e.g. they might use some completely different user-provided mechanism, for -instance using Scala 3 macros or runtime reflection). We expect that (direct or indirect) `Mirror` based implementations -will be the most common and that is what this document emphasises. - -Type class authors will most likely use higher level derivation or generic programming libraries to implement -`derived` methods. An example of how a `derived` method might be implemented using _only_ the low level facilities -described above and Scala 3's general metaprogramming features is provided below. It is not anticipated that type class -authors would normally implement a `derived` method in this way, however this walkthrough can be taken as a guide for -authors of the higher level derivation libraries that we expect typical type class authors will use (for a fully -worked out example of such a library, see [Shapeless 3](https://github.com/milessabin/shapeless/tree/shapeless-3)). - -#### How to write a type class `derived` method using low level mechanisms - -The low-level method we will use to implement a type class `derived` method in this example exploits three new -type-level constructs in Scala 3: inline methods, inline matches, and implicit searches via `summonInline` or `summonFrom`. Given this definition of the -`Eq` type class, - -```scala -trait Eq[T]: - def eqv(x: T, y: T): Boolean -``` - -we need to implement a method `Eq.derived` on the companion object of `Eq` that produces a given instance for `Eq[T]` given -a `Mirror[T]`. Here is a possible implementation, - -```scala -import scala.deriving.Mirror - -inline given derived[T](using m: Mirror.Of[T]): Eq[T] = - val elemInstances = summonAll[m.MirroredElemTypes] // (1) - inline m match // (2) - case s: Mirror.SumOf[T] => eqSum(s, elemInstances) - case p: Mirror.ProductOf[T] => eqProduct(p, elemInstances) -``` - -Note that `derived` is defined as an `inline` given. This means that the method will be expanded at -call sites (for instance the compiler generated instance definitions in the companion objects of ADTs which have a -`derived Eq` clause), and also that it can be used recursively if necessary, to compute instances for children. - -The body of this method (1) first materializes the `Eq` instances for all the child types of type the instance is -being derived for. This is either all the branches of a sum type or all the fields of a product type. The -implementation of `summonAll` is `inline` and uses Scala 3's `summonInline` construct to collect the instances as a -`List`, - -```scala -inline def summonAll[T <: Tuple]: List[Eq[_]] = - inline erasedValue[T] match - case _: EmptyTuple => Nil - case _: (t *: ts) => summonInline[Eq[t]] :: summonAll[ts] -``` - -with the instances for children in hand the `derived` method uses an `inline match` to dispatch to methods which can -construct instances for either sums or products (2). Note that because `derived` is `inline` the match will be -resolved at compile-time and only the left-hand side of the matching case will be inlined into the generated code with -types refined as revealed by the match. - -In the sum case, `eqSum`, we use the runtime `ordinal` values of the arguments to `eqv` to first check if the two -values are of the same subtype of the ADT (3) and then, if they are, to further test for equality based on the `Eq` -instance for the appropriate ADT subtype using the auxiliary method `check` (4). - -```scala -import scala.deriving.Mirror - -def eqSum[T](s: Mirror.SumOf[T], elems: List[Eq[_]]): Eq[T] = - new Eq[T]: - def eqv(x: T, y: T): Boolean = - val ordx = s.ordinal(x) // (3) - (s.ordinal(y) == ordx) && check(elems(ordx))(x, y) // (4) -``` - -In the product case, `eqProduct` we test the runtime values of the arguments to `eqv` for equality as products based -on the `Eq` instances for the fields of the data type (5), - -```scala -import scala.deriving.Mirror - -def eqProduct[T](p: Mirror.ProductOf[T], elems: List[Eq[_]]): Eq[T] = - new Eq[T]: - def eqv(x: T, y: T): Boolean = - iterator(x).zip(iterator(y)).zip(elems.iterator).forall { // (5) - case ((x, y), elem) => check(elem)(x, y) - } -``` - -Pulling this all together we have the following complete implementation, - -```scala -import scala.deriving.* -import scala.compiletime.{erasedValue, summonInline} - -inline def summonAll[T <: Tuple]: List[Eq[_]] = - inline erasedValue[T] match - case _: EmptyTuple => Nil - case _: (t *: ts) => summonInline[Eq[t]] :: summonAll[ts] - -trait Eq[T]: - def eqv(x: T, y: T): Boolean - -object Eq: - given Eq[Int] with - def eqv(x: Int, y: Int) = x == y - - def check(elem: Eq[_])(x: Any, y: Any): Boolean = - elem.asInstanceOf[Eq[Any]].eqv(x, y) - - def iterator[T](p: T) = p.asInstanceOf[Product].productIterator - - def eqSum[T](s: Mirror.SumOf[T], elems: => List[Eq[_]]): Eq[T] = - new Eq[T]: - def eqv(x: T, y: T): Boolean = - val ordx = s.ordinal(x) - (s.ordinal(y) == ordx) && check(elems(ordx))(x, y) - - def eqProduct[T](p: Mirror.ProductOf[T], elems: => List[Eq[_]]): Eq[T] = - new Eq[T]: - def eqv(x: T, y: T): Boolean = - iterator(x).zip(iterator(y)).zip(elems.iterator).forall { - case ((x, y), elem) => check(elem)(x, y) - } - - inline given derived[T](using m: Mirror.Of[T]): Eq[T] = - lazy val elemInstances = summonAll[m.MirroredElemTypes] - inline m match - case s: Mirror.SumOf[T] => eqSum(s, elemInstances) - case p: Mirror.ProductOf[T] => eqProduct(p, elemInstances) -end Eq -``` - -we can test this relative to a simple ADT like so, - -```scala -enum Opt[+T] derives Eq: - case Sm(t: T) - case Nn - -@main def test(): Unit = - import Opt.* - val eqoi = summon[Eq[Opt[Int]]] - assert(eqoi.eqv(Sm(23), Sm(23))) - assert(!eqoi.eqv(Sm(23), Sm(13))) - assert(!eqoi.eqv(Sm(23), Nn)) -``` - -In this case the code that is generated by the inline expansion for the derived `Eq` instance for `Opt` looks like the -following, after a little polishing, - -```scala -given derived$Eq[T](using eqT: Eq[T]): Eq[Opt[T]] = - eqSum( - summon[Mirror[Opt[T]]], - List( - eqProduct(summon[Mirror[Sm[T]]], List(summon[Eq[T]])), - eqProduct(summon[Mirror[Nn.type]], Nil) - ) - ) -``` - -Alternative approaches can be taken to the way that `derived` methods can be defined. For example, more aggressively -inlined variants using Scala 3 macros, whilst being more involved for type class authors to write than the example -above, can produce code for type classes like `Eq` which eliminate all the abstraction artefacts (eg. the `Lists` of -child instances in the above) and generate code which is indistinguishable from what a programmer might write by hand. -As a third example, using a higher level library such as Shapeless the type class author could define an equivalent -`derived` method as, - -```scala -given eqSum[A](using inst: => K0.CoproductInstances[Eq, A]): Eq[A] with - def eqv(x: A, y: A): Boolean = inst.fold2(x, y)(false)( - [t] => (eqt: Eq[t], t0: t, t1: t) => eqt.eqv(t0, t1) - ) - -given eqProduct[A](using inst: K0.ProductInstances[Eq, A]): Eq[A] with - def eqv(x: A, y: A): Boolean = inst.foldLeft2(x, y)(true: Boolean)( - [t] => (acc: Boolean, eqt: Eq[t], t0: t, t1: t) => - Complete(!eqt.eqv(t0, t1))(false)(true) - ) - -inline def derived[A](using gen: K0.Generic[A]): Eq[A] = - gen.derive(eqProduct, eqSum) -``` - -The framework described here enables all three of these approaches without mandating any of them. - -For a brief discussion on how to use macros to write a type class `derived` -method please read more at [How to write a type class `derived` method using macros](./derivation-macro.html). - -### Deriving instances elsewhere - -Sometimes one would like to derive a type class instance for an ADT after the ADT is defined, without being able to -change the code of the ADT itself. To do this, simply define an instance using the `derived` method of the type class -as right-hand side. E.g, to implement `Ordering` for `Option` define, - -```scala -given [T: Ordering]: Ordering[Option[T]] = Ordering.derived -``` - -Assuming the `Ordering.derived` method has a context parameter of type `Mirror[T]` it will be satisfied by the -compiler generated `Mirror` instance for `Option` and the derivation of the instance will be expanded on the right -hand side of this definition in the same way as an instance defined in ADT companion objects. - -### Syntax - -``` -Template ::= InheritClauses [TemplateBody] -EnumDef ::= id ClassConstr InheritClauses EnumBody -InheritClauses ::= [‘extends’ ConstrApps] [‘derives’ QualId {‘,’ QualId}] -ConstrApps ::= ConstrApp {‘with’ ConstrApp} - | ConstrApp {‘,’ ConstrApp} -``` - -**Note:** To align `extends` clauses and `derives` clauses, Scala 3 also allows multiple -extended types to be separated by commas. So the following is now legal: - -```scala -class A extends B, C { ... } -``` - -It is equivalent to the old form - -```scala -class A extends B with C { ... } -``` - -### Discussion - -This type class derivation framework is intentionally very small and low-level. There are essentially two pieces of -infrastructure in compiler-generated `Mirror` instances, - -+ type members encoding properties of the mirrored types. -+ a minimal value level mechanism for working generically with terms of the mirrored types. - -The `Mirror` infrastructure can be seen as an extension of the existing `Product` infrastructure for case classes: -typically `Mirror` types will be implemented by the ADTs companion object, hence the type members and the `ordinal` or -`fromProduct` methods will be members of that object. The primary motivation for this design decision, and the -decision to encode properties via types rather than terms was to keep the bytecode and runtime footprint of the -feature small enough to make it possible to provide `Mirror` instances _unconditionally_. - -Whilst `Mirrors` encode properties precisely via type members, the value level `ordinal` and `fromProduct` are -somewhat weakly typed (because they are defined in terms of `MirroredMonoType`) just like the members of `Product`. -This means that code for generic type classes has to ensure that type exploration and value selection proceed in -lockstep and it has to assert this conformance in some places using casts. If generic type classes are correctly -written these casts will never fail. - -As mentioned, however, the compiler-provided mechanism is intentionally very low level and it is anticipated that -higher level type class derivation and generic programming libraries will build on this and Scala 3's other -metaprogramming facilities to hide these low-level details from type class authors and general users. Type class -derivation in the style of both Shapeless and Magnolia are possible (a prototype of Shapeless 3, which combines -aspects of both Shapeless 2 and Magnolia has been developed alongside this language feature) as is a more aggressively -inlined style, supported by Scala 3's new quote/splice macro and inlining facilities. diff --git a/_scala3-reference/contextual/extension-methods.md b/_scala3-reference/contextual/extension-methods.md deleted file mode 100644 index 06364baa50..0000000000 --- a/_scala3-reference/contextual/extension-methods.md +++ /dev/null @@ -1,308 +0,0 @@ ---- -title: "Extension Methods" -type: section -num: 19 -previous-page: /scala3/reference/contextual/given-imports -next-page: /scala3/reference/contextual/type-classes ---- - -Extension methods allow one to add methods to a type after the type is defined. Example: - -```scala -case class Circle(x: Double, y: Double, radius: Double) - -extension (c: Circle) - def circumference: Double = c.radius * math.Pi * 2 -``` - -Like regular methods, extension methods can be invoked with infix `.`: - -```scala -val circle = Circle(0, 0, 1) -circle.circumference -``` - -### Translation of Extension Methods - -An extension method translates to a specially labelled method that takes the leading parameter section as its first argument list. The label, expressed -as `` here, is compiler-internal. So, the definition of `circumference` above translates to the following method, and can also be invoked as such: - -``` - def circumference(c: Circle): Double = c.radius * math.Pi * 2 - -assert(circle.circumference == circumference(circle)) -``` - -### Operators - -The extension method syntax can also be used to define operators. Examples: - -```scala -extension (x: String) - def < (y: String): Boolean = ... -extension (x: Elem) - def +: (xs: Seq[Elem]): Seq[Elem] = ... -extension (x: Number) - infix def min (y: Number): Number = ... - -"ab" < "c" -1 +: List(2, 3) -x min 3 -``` - -The three definitions above translate to - -``` - def < (x: String)(y: String): Boolean = ... - def +: (xs: Seq[Elem])(x: Elem): Seq[Elem] = ... - infix def min(x: Number)(y: Number): Number = ... -``` - -Note the swap of the two parameters `x` and `xs` when translating -the right-associative operator `+:` to an extension method. This is analogous -to the implementation of right binding operators as normal methods. The Scala -compiler preprocesses an infix operation `x +: xs` to `xs.+:(x)`, so the extension -method ends up being applied to the sequence as first argument (in other words, the -two swaps cancel each other out). See [here for details](./right-associative-extension-methods.html). - -### Generic Extensions - -It is also possible to extend generic types by adding type parameters to an extension. For instance: - -```scala -extension [T](xs: List[T]) - def second = xs.tail.head - -extension [T: Numeric](x: T) - def + (y: T): T = summon[Numeric[T]].plus(x, y) -``` - -Type parameters on extensions can also be combined with type parameters on the methods -themselves: - -```scala -extension [T](xs: List[T]) - def sumBy[U: Numeric](f: T => U): U = ... -``` - -Type arguments matching method type parameters are passed as usual: - -```scala -List("a", "bb", "ccc").sumBy[Int](_.length) -``` - -By contrast, type arguments matching type parameters following `extension` can be passed -only if the method is referenced as a non-extension method: - -```scala -sumBy[String](List("a", "bb", "ccc"))(_.length) -``` - -Or, when passing both type arguments: - -```scala -sumBy[String](List("a", "bb", "ccc"))[Int](_.length) -``` - -Extensions can also take using clauses. For instance, the `+` extension above could equivalently be written with a using clause: - -```scala -extension [T](x: T)(using n: Numeric[T]) - def + (y: T): T = n.plus(x, y) -``` - -### Collective Extensions - -Sometimes, one wants to define several extension methods that share the same -left-hand parameter type. In this case one can "pull out" the common parameters into -a single extension and enclose all methods in braces or an indented region. -Example: - -```scala -extension (ss: Seq[String]) - - def longestStrings: Seq[String] = - val maxLength = ss.map(_.length).max - ss.filter(_.length == maxLength) - - def longestString: String = longestStrings.head -``` - -The same can be written with braces as follows (note that indented regions can still be used inside braces): - -```scala -extension (ss: Seq[String]) { - - def longestStrings: Seq[String] = { - val maxLength = ss.map(_.length).max - ss.filter(_.length == maxLength) - } - - def longestString: String = longestStrings.head -} -``` - -Note the right-hand side of `longestString`: it calls `longestStrings` directly, implicitly -assuming the common extended value `ss` as receiver. - -Collective extensions like these are a shorthand for individual extensions -where each method is defined separately. For instance, the first extension above expands to: - -```scala -extension (ss: Seq[String]) - def longestStrings: Seq[String] = - val maxLength = ss.map(_.length).max - ss.filter(_.length == maxLength) - -extension (ss: Seq[String]) - def longestString: String = ss.longestStrings.head -``` - -Collective extensions also can take type parameters and have using clauses. Example: - -```scala -extension [T](xs: List[T])(using Ordering[T]) - def smallest(n: Int): List[T] = xs.sorted.take(n) - def smallestIndices(n: Int): List[Int] = - val limit = smallest(n).max - xs.zipWithIndex.collect { case (x, i) if x <= limit => i } -``` - -### Translation of Calls to Extension Methods - -To convert a reference to an extension method, the compiler has to know about the extension -method. We say in this case that the extension method is _applicable_ at the point of reference. -There are four possible ways for an extension method to be applicable: - - 1. The extension method is visible under a simple name, by being defined or inherited or imported in a scope enclosing the reference. - 2. The extension method is a member of some given - instance that is visible at the point of the reference. - 3. The reference is of the form `r.m` and the extension method - is defined in the implicit scope of the type of `r`. - 4. The reference is of the form `r.m` and the extension method - is defined in some given instance in the implicit scope of the type of `r`. - -Here is an example for the first rule: - -```scala -trait IntOps: - extension (i: Int) def isZero: Boolean = i == 0 - - extension (i: Int) def safeMod(x: Int): Option[Int] = - // extension method defined in same scope IntOps - if x.isZero then None - else Some(i % x) - -object IntOpsEx extends IntOps: - extension (i: Int) def safeDiv(x: Int): Option[Int] = - // extension method brought into scope via inheritance from IntOps - if x.isZero then None - else Some(i / x) - -trait SafeDiv: - import IntOpsEx.* // brings safeDiv and safeMod into scope - - extension (i: Int) def divide(d: Int): Option[(Int, Int)] = - // extension methods imported and thus in scope - (i.safeDiv(d), i.safeMod(d)) match - case (Some(d), Some(r)) => Some((d, r)) - case _ => None -``` - -By the second rule, an extension method can be made available by defining a given instance containing it, like this: - -```scala -given ops1: IntOps() // brings safeMod into scope - -1.safeMod(2) -``` - -By the third and fourth rule, an extension method is available if it is in the implicit scope of the receiver type or in a given instance in that scope. Example: - -```scala -class List[T]: - ... -object List: - ... - extension [T](xs: List[List[T]]) - def flatten: List[T] = xs.foldLeft(List.empty[T])(_ ++ _) - - given [T: Ordering]: Ordering[List[T]] with - extension (xs: List[T]) - def < (ys: List[T]): Boolean = ... -end List - -// extension method available since it is in the implicit scope -// of List[List[Int]] -List(List(1, 2), List(3, 4)).flatten - -// extension method available since it is in the given Ordering[List[T]], -// which is itself in the implicit scope of List[Int] -List(1, 2) < List(3) -``` - -The precise rules for resolving a selection to an extension method are as follows. - -Assume a selection `e.m[Ts]` where `m` is not a member of `e`, where the type arguments `[Ts]` are optional, and where `T` is the expected type. -The following two rewritings are tried in order: - - 1. The selection is rewritten to `m[Ts](e)`. - 2. If the first rewriting does not typecheck with expected type `T`, - and there is an extension method `m` in some eligible object `o`, the selection is rewritten to `o.m[Ts](e)`. An object `o` is _eligible_ if - - - `o` forms part of the implicit scope of `T`, or - - `o` is a given instance that is visible at the point of the application, or - - `o` is a given instance in the implicit scope of `T`. - - This second rewriting is attempted at the time where the compiler also tries an implicit conversion - from `T` to a type containing `m`. If there is more than one way of rewriting, an ambiguity error results. - -An extension method can also be referenced using a simple identifier without a preceding expression. If an identifier `g` appears in the body of an extension method `f` and refers to an extension method `g` that is defined in the same collective extension - -```scala -extension (x: T) - def f ... = ... g ... - def g ... -``` - -the identifier is rewritten to `x.g`. This is also the case if `f` and `g` are the same method. Example: - -```scala -extension (s: String) - def position(ch: Char, n: Int): Int = - if n < s.length && s(n) != ch then position(ch, n + 1) - else n -``` - -The recursive call `position(ch, n + 1)` expands to `s.position(ch, n + 1)` in this case. The whole extension method rewrites to - -```scala -def position(s: String)(ch: Char, n: Int): Int = - if n < s.length && s(n) != ch then position(s)(ch, n + 1) - else n -``` - -### Syntax - -Here are the syntax changes for extension methods and collective extensions relative -to the [current syntax](../syntax.html). - -``` -BlockStat ::= ... | Extension -TemplateStat ::= ... | Extension -TopStat ::= ... | Extension -Extension ::= ‘extension’ [DefTypeParamClause] {UsingParamClause} - ‘(’ DefParam ‘)’ {UsingParamClause} ExtMethods -ExtMethods ::= ExtMethod | [nl] <<< ExtMethod {semi ExtMethod} >>> -ExtMethod ::= {Annotation [nl]} {Modifier} ‘def’ DefDef -``` - -In the above the notation `<<< ts >>>` in the production rule `ExtMethods` is defined as follows : - -``` -<<< ts >>> ::= ‘{’ ts ‘}’ | indent ts outdent -``` - -`extension` is a soft keyword. It is recognized as a keyword only if it appears -at the start of a statement and is followed by `[` or `(`. In all other cases -it is treated as an identifier. diff --git a/_scala3-reference/contextual/given-imports.md b/_scala3-reference/contextual/given-imports.md deleted file mode 100644 index 7e49841588..0000000000 --- a/_scala3-reference/contextual/given-imports.md +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: "Importing Givens" -type: section -num: 18 -previous-page: /scala3/reference/contextual/context-bounds -next-page: /scala3/reference/contextual/extension-methods ---- - -A special form of import wildcard selector is used to import given instances. Example: - -```scala -object A: - class TC - given tc: TC = ??? - def f(using TC) = ??? - -object B: - import A.* - import A.given - ... -``` - -In the code above, the `import A.*` clause in object `B` imports all members -of `A` _except_ the given instance `tc`. Conversely, the second import `import A.given` will import _only_ that given instance. -The two import clauses can also be merged into one: - -```scala -object B: - import A.{given, *} - ... -``` - -Generally, a normal wildcard selector `*` brings all definitions other than givens or extensions into scope -whereas a `given` selector brings all givens (including those resulting from extensions) into scope. - -There are two main benefits arising from these rules: - -- It is made clearer where givens in scope are coming from. - In particular, it is not possible to hide imported givens in a long list of regular wildcard imports. -- It enables importing all givens - without importing anything else. This is particularly important since givens - can be anonymous, so the usual recourse of using named imports is not - practical. - -### Importing By Type - -Since givens can be anonymous it is not always practical to import them by their name, and wildcard imports are typically used instead. By-type imports provide a more specific alternative to wildcard imports, which makes it clearer what is imported. Example: - -```scala -import A.given TC -``` - -This imports any given in `A` that has a type which conforms to `TC`. Importing givens of several types `T1,...,Tn` -is expressed by multiple `given` selectors. - -```scala -import A.{given T1, ..., given Tn} -``` - -Importing all given instances of a parameterized type is expressed by wildcard arguments. -For instance, assuming the object - -```scala -object Instances: - given intOrd: Ordering[Int] = ... - given listOrd[T: Ordering]: Ordering[List[T]] = ... - given ec: ExecutionContext = ... - given im: Monoid[Int] = ... -``` - -the import clause - -```scala -import Instances.{given Ordering[?], given ExecutionContext} -``` - -would import the `intOrd`, `listOrd`, and `ec` instances but leave out the `im` instance, since it fits none of the specified bounds. - -By-type imports can be mixed with by-name imports. If both are present in an import clause, by-type imports come last. For instance, the import clause - -```scala -import Instances.{im, given Ordering[?]} -``` - -would import `im`, `intOrd`, and `listOrd` but leave out `ec`. - -### Migration - -The rules for imports stated above have the consequence that a library -would have to migrate in lockstep with all its users from old style implicits and -normal imports to givens and given imports. - -The following modifications avoid this hurdle to migration. - - 1. A `given` import selector also brings old style implicits into scope. So, in Scala 3.0 - an old-style implicit definition can be brought into scope either by a `*` or a `given` wildcard selector. - - 2. In Scala 3.1, old-style implicits accessed through a `*` wildcard import will give a deprecation warning. - - 3. In some version after 3.1, old-style implicits accessed through a `*` wildcard import will give a compiler error. - -These rules mean that library users can use `given` selectors to access old-style implicits in Scala 3.0, -and will be gently nudged and then forced to do so in later versions. Libraries can then switch to -given instances once their user base has migrated. - -### Syntax - -``` -Import ::= ‘import’ ImportExpr {‘,’ ImportExpr} -Export ::= ‘export’ ImportExpr {‘,’ ImportExpr} -ImportExpr ::= SimpleRef {‘.’ id} ‘.’ ImportSpec -ImportSpec ::= NamedSelector - | WildcardSelector - | ‘{’ ImportSelectors) ‘}’ -NamedSelector ::= id [‘as’ (id | ‘_’)] -WildCardSelector ::= ‘*' | ‘given’ [InfixType] -ImportSelectors ::= NamedSelector [‘,’ ImportSelectors] - | WildCardSelector {‘,’ WildCardSelector} -``` diff --git a/_scala3-reference/contextual/givens.md b/_scala3-reference/contextual/givens.md deleted file mode 100644 index 0ca25c068c..0000000000 --- a/_scala3-reference/contextual/givens.md +++ /dev/null @@ -1,173 +0,0 @@ ---- -title: "Given Instances" -type: section -num: 15 -previous-page: /scala3/reference/contextual -next-page: /scala3/reference/contextual/using-clauses ---- - -Given instances (or, simply, "givens") define "canonical" values of certain types -that serve for synthesizing arguments to [context parameters](./using-clauses.html). Example: - -```scala -trait Ord[T]: - def compare(x: T, y: T): Int - extension (x: T) def < (y: T) = compare(x, y) < 0 - extension (x: T) def > (y: T) = compare(x, y) > 0 - -given intOrd: Ord[Int] with - def compare(x: Int, y: Int) = - if x < y then -1 else if x > y then +1 else 0 - -given listOrd[T](using ord: Ord[T]): Ord[List[T]] with - - def compare(xs: List[T], ys: List[T]): Int = (xs, ys) match - case (Nil, Nil) => 0 - case (Nil, _) => -1 - case (_, Nil) => +1 - case (x :: xs1, y :: ys1) => - val fst = ord.compare(x, y) - if fst != 0 then fst else compare(xs1, ys1) - -``` - -This code defines a trait `Ord` with two given instances. `intOrd` defines -a given for the type `Ord[Int]` whereas `listOrd[T]` defines givens -for `Ord[List[T]]` for all types `T` that come with a given instance for `Ord[T]` -themselves. The `using` clause in `listOrd` defines a condition: There must be a -given of type `Ord[T]` for a given of type `Ord[List[T]]` to exist. -Such conditions are expanded by the compiler to [context parameters](./using-clauses.html). - -## Anonymous Givens - -The name of a given can be left out. So the definitions -of the last section can also be expressed like this: - -```scala -given Ord[Int] with - ... -given [T](using Ord[T]): Ord[List[T]] with - ... -``` - -If the name of a given is missing, the compiler will synthesize a name from -the implemented type(s). - -**Note** The name synthesized by the compiler is chosen to be readable and reasonably concise. For instance, the two instances above would get the names: - -```scala -given_Ord_Int -given_Ord_List_T -``` - -The precise rules for synthesizing names are found [here](./relationship-implicits.html#anonymous-given-instances). These rules do not guarantee absence of name conflicts between -given instances of types that are "too similar". To avoid conflicts one can -use named instances. - -**Note** To ensure robust binary compatibility, publicly available libraries should prefer named instances. - -## Alias Givens - -An alias can be used to define a given instance that is equal to some expression. Example: - -```scala -given global: ExecutionContext = ForkJoinPool() -``` - -This creates a given `global` of type `ExecutionContext` that resolves to the right -hand side `ForkJoinPool()`. -The first time `global` is accessed, a new `ForkJoinPool` is created, which is then -returned for this and all subsequent accesses to `global`. This operation is thread-safe. - -Alias givens can be anonymous as well, e.g. - -```scala -given Position = enclosingTree.position -given (using config: Config): Factory = MemoizingFactory(config) -``` - -An alias given can have type parameters and context parameters just like any other given, -but it can only implement a single type. - -## Given Macros - -Given aliases can have the `inline` and `transparent` modifiers. -Example: - -```scala -transparent inline given mkAnnotations[A, T]: Annotations[A, T] = ${ - // code producing a value of a subtype of Annotations -} -``` - -Since `mkAnnotations` is `transparent`, the type of an application is the type of its right-hand side, which can be a proper subtype of the declared result type `Annotations[A, T]`. - -## Pattern-Bound Given Instances - -Given instances can also appear in patterns. Example: - -```scala -for given Context <- applicationContexts do - -pair match - case (ctx @ given Context, y) => ... -``` - -In the first fragment above, anonymous given instances for class `Context` are established by enumerating over `applicationContexts`. In the second fragment, a given `Context` -instance named `ctx` is established by matching against the first half of the `pair` selector. - -In each case, a pattern-bound given instance consists of `given` and a type `T`. The pattern matches exactly the same selectors as the type ascription pattern `_: T`. - -## Negated Givens - -Scala 2's somewhat puzzling behavior with respect to ambiguity has been exploited to implement the analogue of a "negated" search in implicit resolution, -where a query Q1 fails if some other query Q2 succeeds and Q1 succeeds if Q2 fails. With the new cleaned up behavior these techniques no longer work. -But the new special type `scala.util.NotGiven` now implements negation directly. - -For any query type `Q`, `NotGiven[Q]` succeeds if and only if the implicit -search for `Q` fails, for example: - -```scala -import scala.util.NotGiven - -trait Tagged[A] - -case class Foo[A](value: Boolean) -object Foo: - given fooTagged[A](using Tagged[A]): Foo[A] = Foo(true) - given fooNotTagged[A](using NotGiven[Tagged[A]]): Foo[A] = Foo(false) - -@main def test(): Unit = - given Tagged[Int]() - assert(summon[Foo[Int]].value) // fooTagged is found - assert(!summon[Foo[String]].value) // fooNotTagged is found -``` - -## Given Instance Initialization - -A given instance without type or context parameters is initialized on-demand, the first -time it is accessed. If a given has type or context parameters, a fresh instance -is created for each reference. - -## Syntax - -Here is the syntax for given instances: - -``` -TmplDef ::= ... - | ‘given’ GivenDef -GivenDef ::= [GivenSig] StructuralInstance - | [GivenSig] AnnotType ‘=’ Expr - | [GivenSig] AnnotType -GivenSig ::= [id] [DefTypeParamClause] {UsingParamClause} ‘:’ -StructuralInstance ::= ConstrApp {‘with’ ConstrApp} ‘with’ TemplateBody -``` - -A given instance starts with the reserved word `given` and an optional _signature_. The signature -defines a name and/or parameters for the instance. It is followed by `:`. There are three kinds -of given instances: - -- A _structural instance_ contains one or more types or constructor applications, - followed by `with` and a template body that contains member definitions of the instance. -- An _alias instance_ contains a type, followed by `=` and a right-hand side expression. -- An _abstract instance_ contains just the type, which is not followed by anything. diff --git a/_scala3-reference/contextual/multiversal-equality.md b/_scala3-reference/contextual/multiversal-equality.md deleted file mode 100644 index 19b44c6544..0000000000 --- a/_scala3-reference/contextual/multiversal-equality.md +++ /dev/null @@ -1,229 +0,0 @@ ---- -title: "Multiversal Equality" -type: section -num: 22 -previous-page: /scala3/reference/contextual/derivation -next-page: /scala3/reference/contextual/context-functions ---- - -Previously, Scala had universal equality: Two values of any types -could be compared with each other with `==` and `!=`. This came from -the fact that `==` and `!=` are implemented in terms of Java's -`equals` method, which can also compare values of any two reference -types. - -Universal equality is convenient. But it is also dangerous since it -undermines type safety. For instance, let's assume one is left after some refactoring -with an erroneous program where a value `y` has type `S` instead of the correct type `T`. - -```scala -val x = ... // of type T -val y = ... // of type S, but should be T -x == y // typechecks, will always yield false -``` - -If `y` gets compared to other values of type `T`, -the program will still typecheck, since values of all types can be compared with each other. -But it will probably give unexpected results and fail at runtime. - -Multiversal equality is an opt-in way to make universal equality safer. -It uses a binary type class [`scala.CanEqual`](https://github.com/lampepfl/dotty/blob/master/library/src/scala/CanEqual.scala) -to indicate that values of two given types can be compared with each other. -The example above would not typecheck if `S` or `T` was a class -that derives `CanEqual`, e.g. - -```scala -class T derives CanEqual -``` - -Alternatively, one can also provide a `CanEqual` given instance directly, like this: - -```scala -given CanEqual[T, T] = CanEqual.derived -``` - -This definition effectively says that values of type `T` can (only) be -compared to other values of type `T` when using `==` or `!=`. The definition -affects type checking but it has no significance for runtime -behavior, since `==` always maps to `equals` and `!=` always maps to -the negation of `equals`. The right-hand side `CanEqual.derived` of the definition -is a value that has any `CanEqual` instance as its type. Here is the definition of class -`CanEqual` and its companion object: - -```scala -package scala -import annotation.implicitNotFound - -@implicitNotFound("Values of types ${L} and ${R} cannot be compared with == or !=") -sealed trait CanEqual[-L, -R] - -object CanEqual: - object derived extends CanEqual[Any, Any] -``` - -One can have several `CanEqual` given instances for a type. For example, the four -definitions below make values of type `A` and type `B` comparable with -each other, but not comparable to anything else: - -```scala -given CanEqual[A, A] = CanEqual.derived -given CanEqual[B, B] = CanEqual.derived -given CanEqual[A, B] = CanEqual.derived -given CanEqual[B, A] = CanEqual.derived -``` - -The [`scala.CanEqual`](https://github.com/lampepfl/dotty/blob/master/library/src/scala/CanEqual.scala) -object defines a number of `CanEqual` given instances that together -define a rule book for what standard types can be compared (more details below). - -There is also a "fallback" instance named `canEqualAny` that allows comparisons -over all types that do not themselves have a `CanEqual` given. `canEqualAny` is defined as follows: - -```scala -def canEqualAny[L, R]: CanEqual[L, R] = CanEqual.derived -``` - -Even though `canEqualAny` is not declared as `given`, the compiler will still -construct an `canEqualAny` instance as answer to an implicit search for the -type `CanEqual[L, R]`, unless `L` or `R` have `CanEqual` instances -defined on them, or the language feature `strictEquality` is enabled. - -The primary motivation for having `canEqualAny` is backwards compatibility. -If this is of no concern, one can disable `canEqualAny` by enabling the language -feature `strictEquality`. As for all language features this can be either -done with an import - -```scala -import scala.language.strictEquality -``` -or with a command line option `-language:strictEquality`. - -## Deriving CanEqual Instances - -Instead of defining `CanEqual` instances directly, it is often more convenient to derive them. Example: - -```scala -class Box[T](x: T) derives CanEqual -``` - -By the usual rules of [type class derivation](./derivation.html), -this generates the following `CanEqual` instance in the companion object of `Box`: - -```scala -given [T, U](using CanEqual[T, U]): CanEqual[Box[T], Box[U]] = - CanEqual.derived -``` - -That is, two boxes are comparable with `==` or `!=` if their elements are. Examples: - -```scala -new Box(1) == new Box(1L) // ok since there is an instance for `CanEqual[Int, Long]` -new Box(1) == new Box("a") // error: can't compare -new Box(1) == 1 // error: can't compare -``` - -## Precise Rules for Equality Checking - -The precise rules for equality checking are as follows. - -If the `strictEquality` feature is enabled then -a comparison using `x == y` or `x != y` between values `x: T` and `y: U` -is legal if there is a `given` of type `CanEqual[T, U]`. - -In the default case where the `strictEquality` feature is not enabled the comparison is -also legal if - - 1. `T` and `U` are the same, or - 2. one of `T`, `U` is a subtype of the _lifted_ version of the other type, or - 3. neither `T` nor `U` have a _reflexive_ `CanEqual` instance. - -Explanations: - - - _lifting_ a type `S` means replacing all references to abstract types - in covariant positions of `S` by their upper bound, and replacing - all refinement types in covariant positions of `S` by their parent. - - a type `T` has a _reflexive_ `CanEqual` instance if the implicit search for `CanEqual[T, T]` - succeeds. - -## Predefined CanEqual Instances - -The `CanEqual` object defines instances for comparing - - the primitive types `Byte`, `Short`, `Char`, `Int`, `Long`, `Float`, `Double`, `Boolean`, and `Unit`, - - `java.lang.Number`, `java.lang.Boolean`, and `java.lang.Character`, - - `scala.collection.Seq`, and `scala.collection.Set`. - -Instances are defined so that every one of these types has a _reflexive_ `CanEqual` instance, and the following holds: - - - Primitive numeric types can be compared with each other. - - Primitive numeric types can be compared with subtypes of `java.lang.Number` (and _vice versa_). - - `Boolean` can be compared with `java.lang.Boolean` (and _vice versa_). - - `Char` can be compared with `java.lang.Character` (and _vice versa_). - - Two sequences (of arbitrary subtypes of `scala.collection.Seq`) can be compared - with each other if their element types can be compared. The two sequence types - need not be the same. - - Two sets (of arbitrary subtypes of `scala.collection.Set`) can be compared - with each other if their element types can be compared. The two set types - need not be the same. - - Any subtype of `AnyRef` can be compared with `Null` (and _vice versa_). - -## Why Two Type Parameters? - -One particular feature of the `CanEqual` type is that it takes _two_ type parameters, representing the types of the two items to be compared. By contrast, conventional -implementations of an equality type class take only a single type parameter which represents the common type of _both_ operands. -One type parameter is simpler than two, so why go through the additional complication? The reason has to do with the fact that, rather than coming up with a type class where no operation existed before, -we are dealing with a refinement of pre-existing, universal equality. It is best illustrated through an example. - -Say you want to come up with a safe version of the `contains` method on `List[T]`. The original definition of `contains` in the standard library was: -```scala -class List[+T]: - ... - def contains(x: Any): Boolean -``` -That uses universal equality in an unsafe way since it permits arguments of any type to be compared with the list's elements. The "obvious" alternative definition -```scala - def contains(x: T): Boolean -``` -does not work, since it refers to the covariant parameter `T` in a nonvariant context. The only variance-correct way to use the type parameter `T` in `contains` is as a lower bound: -```scala - def contains[U >: T](x: U): Boolean -``` -This generic version of `contains` is the one used in the current (Scala 2.13) version of `List`. -It looks different but it admits exactly the same applications as the `contains(x: Any)` definition we started with. -However, we can make it more useful (i.e. restrictive) by adding a `CanEqual` parameter: -```scala - def contains[U >: T](x: U)(using CanEqual[T, U]): Boolean // (1) -``` -This version of `contains` is equality-safe! More precisely, given -`x: T`, `xs: List[T]` and `y: U`, then `xs.contains(y)` is type-correct if and only if -`x == y` is type-correct. - -Unfortunately, the crucial ability to "lift" equality type checking from simple equality and pattern matching to arbitrary user-defined operations gets lost if we restrict ourselves to an equality class with a single type parameter. Consider the following signature of `contains` with a hypothetical `CanEqual1[T]` type class: -```scala - def contains[U >: T](x: U)(using CanEqual1[U]): Boolean // (2) -``` -This version could be applied just as widely as the original `contains(x: Any)` method, -since the `CanEqual1[Any]` fallback is always available! So we have gained nothing. What got lost in the transition to a single parameter type class was the original rule that `CanEqual[A, B]` is available only if neither `A` nor `B` have a reflexive `CanEqual` instance. That rule simply cannot be expressed if there is a single type parameter for `CanEqual`. - -The situation is different under `-language:strictEquality`. In that case, -the `CanEqual[Any, Any]` or `CanEqual1[Any]` instances would never be available, and the -single and two-parameter versions would indeed coincide for most practical purposes. - -But assuming `-language:strictEquality` immediately and everywhere poses migration problems which might well be unsurmountable. Consider again `contains`, which is in the standard library. Parameterizing it with the `CanEqual` type class as in (1) is an immediate win since it rules out non-sensical applications while still allowing all sensible ones. -So it can be done almost at any time, modulo binary compatibility concerns. -On the other hand, parameterizing `contains` with `CanEqual1` as in (2) would make `contains` -unusable for all types that have not yet declared a `CanEqual1` instance, including all -types coming from Java. This is clearly unacceptable. It would lead to a situation where, -rather than migrating existing libraries to use safe equality, the only upgrade path is to have parallel libraries, with the new version only catering to types deriving `CanEqual1` and the old version dealing with everything else. Such a split of the ecosystem would be very problematic, which means the cure is likely to be worse than the disease. - -For these reasons, it looks like a two-parameter type class is the only way forward because it can take the existing ecosystem where it is and migrate it towards a future where more and more code uses safe equality. - -In applications where `-language:strictEquality` is the default one could also introduce a one-parameter type alias such as -```scala -type Eq[-T] = CanEqual[T, T] -``` -Operations needing safe equality could then use this alias instead of the two-parameter `CanEqual` class. But it would only -work under `-language:strictEquality`, since otherwise the universal `Eq[Any]` instance would be available everywhere. - - -More on multiversal equality is found in a [blog post](http://www.scala-lang.org/blog/2016/05/06/multiversal-equality.html) -and a [GitHub issue](https://github.com/lampepfl/dotty/issues/1247). diff --git a/_scala3-reference/contextual/relationship-implicits.md b/_scala3-reference/contextual/relationship-implicits.md deleted file mode 100644 index 9be698affd..0000000000 --- a/_scala3-reference/contextual/relationship-implicits.md +++ /dev/null @@ -1,208 +0,0 @@ ---- -title: "Relationship with Scala 2 Implicits" -type: section -num: 26 -previous-page: /scala3/reference/contextual/by-name-context-parameters -next-page: /scala3/reference/metaprogramming ---- - -Many, but not all, of the new contextual abstraction features in Scala 3 can be mapped to Scala 2's implicits. This page gives a rundown on the relationships between new and old features. - -## Simulating Scala 3 Contextual Abstraction Concepts with Scala 2 Implicits - -### Given Instances - -Given instances can be mapped to combinations of implicit objects, classes and implicit methods. - - 1. Given instances without parameters are mapped to implicit objects. For instance, - - ```scala - given intOrd: Ord[Int] with { ... } - ``` - - maps to - - ```scala - implicit object intOrd extends Ord[Int] { ... } - ``` - - 2. Parameterized givens are mapped to combinations of classes and implicit methods. For instance, - - ```scala - given listOrd[T](using ord: Ord[T]): Ord[List[T]] with { ... } - ``` - - maps to - - ```scala - class listOrd[T](implicit ord: Ord[T]) extends Ord[List[T]] { ... } - final implicit def listOrd[T](implicit ord: Ord[T]): listOrd[T] = - new listOrd[T] - ``` - - 3. Alias givens map to implicit methods or implicit lazy vals. If an alias has neither type nor context parameters, - it is treated as a lazy val, unless the right-hand side is a simple reference, in which case we can use a forwarder to - that reference without caching it. - -Examples: - -```scala -given global: ExecutionContext = new ForkJoinContext() - -val ctx: Context -given Context = ctx -``` - -would map to - -```scala -final implicit lazy val global: ExecutionContext = new ForkJoinContext() -final implicit def given_Context = ctx -``` - -### Anonymous Given Instances - -Anonymous given instances get compiler synthesized names, which are generated in a reproducible way from the implemented type(s). For example, if the names of the `IntOrd` and `ListOrd` givens above were left out, the following names would be synthesized instead: - -```scala -given given_Ord_Int: Ord[Int] with { ... } -given given_Ord_List_T[T](using ord: Ord[T]): Ord[List[T]] with { ... } -``` - -The synthesized type names are formed from - -1. the prefix `given_`, -2. the simple name(s) of the implemented type(s), leaving out any prefixes, -3. the simple name(s) of the top-level argument type constructors to these types. - -Tuples are treated as transparent, i.e. a type `F[(X, Y)]` would get the synthesized name -`F_X_Y`. Directly implemented function types `A => B` are represented as `A_to_B`. Function types used as arguments to other type constructors are represented as `Function`. - -### Using Clauses - -Using clauses correspond largely to Scala 2's implicit parameter clauses. E.g. - -```scala -def max[T](x: T, y: T)(using ord: Ord[T]): T -``` - -would be written - -```scala -def max[T](x: T, y: T)(implicit ord: Ord[T]): T -``` - -in Scala 2. The main difference concerns applications of such parameters. -Explicit arguments to parameters of using clauses _must_ be written using `(using ...)`, -mirroring the definition syntax. E.g, `max(2, 3)(using IntOrd)`. -Scala 2 uses normal applications `max(2, 3)(IntOrd)` instead. The Scala 2 syntax has some inherent ambiguities and restrictions which are overcome by the new syntax. For instance, multiple implicit parameter lists are not available in the old syntax, even though they can be simulated using auxiliary objects in the "Aux" pattern. - -The `summon` method corresponds to `implicitly` in Scala 2. -It is precisely the same as the `the` method in [Shapeless](https://github.com/milessabin/shapeless). -The difference between `summon` (or `the`) and `implicitly` is -that `summon` can return a more precise type than the type that was -asked for. - -### Context Bounds - -Context bounds are the same in both language versions. They expand to the respective forms of implicit parameters. - -**Note:** To ease migration, context bounds in Scala 3 map for a limited time to old-style implicit parameters for which arguments can be passed either in a using clause or -in a normal argument list. Once old-style implicits are deprecated, context bounds -will map to using clauses instead. - -### Extension Methods - -Extension methods have no direct counterpart in Scala 2, but they can be simulated with implicit classes. For instance, the extension method - -```scala -extension (c: Circle) - def circumference: Double = c.radius * math.Pi * 2 -``` - -could be simulated to some degree by - -```scala -implicit class CircleDecorator(c: Circle) extends AnyVal { - def circumference: Double = c.radius * math.Pi * 2 -} -``` - -Abstract extension methods in traits that are implemented in given instances have no direct counterpart in Scala 2. The only way to simulate these is to make implicit classes available through imports. The Simulacrum macro library can automate this process in some cases. - -### Type Class Derivation - -Type class derivation has no direct counterpart in the Scala 2 language. Comparable functionality can be achieved by macro-based libraries such as [Shapeless](https://github.com/milessabin/shapeless), [Magnolia](https://propensive.com/opensource/magnolia), or [scalaz-deriving](https://github.com/scalaz/scalaz-deriving). - -### Context Function Types - -Context function types have no analogue in Scala 2. - -### Implicit By-Name Parameters - -Implicit by-name parameters are not supported in Scala 2, but can be emulated to some degree by the `Lazy` type in Shapeless. - -## Simulating Scala 2 Implicits in Scala 3 - -### Implicit Conversions - -Implicit conversion methods in Scala 2 can be expressed as given instances of the `scala.Conversion` class in Scala 3. For instance, instead of - -```scala -implicit def stringToToken(str: String): Token = new Keyword(str) -``` - -one can write - -```scala -given stringToToken: Conversion[String, Token] with - def apply(str: String): Token = KeyWord(str) -``` - -or - -```scala -given stringToToken: Conversion[String, Token] = KeyWord(_) -``` - -### Implicit Classes - -Implicit classes in Scala 2 are often used to define extension methods, which are directly supported in Scala 3. Other uses of implicit classes can be simulated by a pair of a regular class and a given `Conversion` instance. - -### Implicit Values - -Implicit `val` definitions in Scala 2 can be expressed in Scala 3 using a regular `val` definition and an alias given. -For instance, Scala 2's - -```scala -lazy implicit val pos: Position = tree.sourcePos -``` - -can be expressed in Scala 3 as - -```scala -lazy val pos: Position = tree.sourcePos -given Position = pos -``` - -### Abstract Implicits - -An abstract implicit `val` or `def` in Scala 2 can be expressed in Scala 3 using a regular abstract definition and an alias given. For instance, Scala 2's - -```scala -implicit def symDecorator: SymDecorator -``` - -can be expressed in Scala 3 as - -```scala -def symDecorator: SymDecorator -given SymDecorator = symDecorator -``` - -## Implementation Status and Timeline - -The Scala 3 implementation implements both Scala 2's implicits and the new abstractions. In fact, support for Scala 2's implicits is an essential part of the common language subset between 2.13 and Scala 3. -Migration to the new abstractions will be supported by making automatic rewritings available. - -Depending on adoption patterns, old style implicits might start to be deprecated in a version following Scala 3.0. diff --git a/_scala3-reference/contextual/right-associative-extension-methods.md b/_scala3-reference/contextual/right-associative-extension-methods.md deleted file mode 100644 index b77e6dccdd..0000000000 --- a/_scala3-reference/contextual/right-associative-extension-methods.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Right-Associative Extension Methods: Details" ---- - -The most general form of leading parameters of an extension method is as follows: - - - A possibly empty list of using clauses `leadingUsing` - - A single parameter `extensionParam` - - A possibly empty list of using clauses `trailingUsing` - -This is then followed by `def`, the method name, and possibly further parameters -`otherParams`. An example is: - -```scala - extension (using a: A, b: B)(using c: C) // <-- leadingUsing - (x: X) // <-- extensionParam - (using d: D) // <-- trailingUsing - def +:: (y: Y)(using e: E)(z: Z) // <-- otherParams -``` - -An extension method is treated as a right-associative operator -(as in [SLS §6.12.3](https://www.scala-lang.org/files/archive/spec/2.13/06-expressions.html#infix-operations)) -if it has a name ending in `:` and is immediately followed by a -single parameter. In the example above, that parameter is `(y: Y)`. - -The Scala compiler pre-processes a right-associative infix operation such as `x +: xs` -to `xs.+:(x)` if `x` is a pure expression or a call-by-name parameter and to `val y = x; xs.+:(y)` otherwise. This is necessary since a regular right-associative infix method -is defined in the class of its right operand. To make up for this swap, -the expansion of right-associative extension methods performs an analogous parameter swap. More precisely, if `otherParams` consists of a single parameter -`rightParam` followed by `remaining`, the total parameter sequence -of the extension method's expansion is: - -``` - leadingUsing rightParam trailingUsing extensionParam remaining -``` - -For instance, the `+::` method above would become - -```scala - def +:: (using a: A, b: B)(using c: C) - (y: Y) - (using d: D) - (x: X) - (using e: E)(z: Z) -``` - -This expansion has to be kept in mind when writing right-associative extension -methods with inter-parameter dependencies. - -An overall simpler design could be obtained if right-associative operators could _only_ be defined as extension methods, and would be disallowed as normal methods. In that case neither arguments nor parameters would have to be swapped. Future versions of Scala should strive to achieve this simplification. diff --git a/_scala3-reference/contextual/type-classes.md b/_scala3-reference/contextual/type-classes.md deleted file mode 100644 index 4c80e7b53b..0000000000 --- a/_scala3-reference/contextual/type-classes.md +++ /dev/null @@ -1,284 +0,0 @@ ---- -title: "Implementing Type classes" -type: section -num: 20 -previous-page: /scala3/reference/contextual/extension-methods -next-page: /scala3/reference/contextual/derivation ---- - -A _type class_ is an abstract, parameterized type that lets you add new behavior to any closed data type without using sub-typing. This can be useful in multiple use-cases, for example: - -* expressing how a type you don't own (from the standard or 3rd-party library) conforms to such behavior -* expressing such a behavior for multiple types without involving sub-typing relationships (one `extends` another) between those types (see: [ad hoc polymorphism](https://en.wikipedia.org/wiki/Ad_hoc_polymorphism) for instance) - -Therefore in Scala 3, _type classes_ are just _traits_ with one or more parameters whose implementations are not defined through the `extends` keyword, but by **given instances**. -Here are some examples of common type classes: - -### Semigroups and monoids - -Here's the `Monoid` type class definition: - -```scala -trait SemiGroup[T]: - extension (x: T) def combine (y: T): T - -trait Monoid[T] extends SemiGroup[T]: - def unit: T -``` - -An implementation of this `Monoid` type class for the type `String` can be the following: - -```scala -given Monoid[String] with - extension (x: String) def combine (y: String): String = x.concat(y) - def unit: String = "" -``` - -Whereas for the type `Int` one could write the following: - -```scala -given Monoid[Int] with - extension (x: Int) def combine (y: Int): Int = x + y - def unit: Int = 0 -``` - -This monoid can now be used as _context bound_ in the following `combineAll` method: - -```scala -def combineAll[T: Monoid](xs: List[T]): T = - xs.foldLeft(summon[Monoid[T]].unit)(_.combine(_)) -``` - -To get rid of the `summon[...]` we can define a `Monoid` object as follows: - -```scala -object Monoid: - def apply[T](using m: Monoid[T]) = m -``` - -Which would allow to re-write the `combineAll` method this way: - -```scala -def combineAll[T: Monoid](xs: List[T]): T = - xs.foldLeft(Monoid[T].unit)(_.combine(_)) -``` - -### Functors - -A `Functor` for a type provides the ability for its values to be "mapped over", i.e. apply a function that transforms inside a value while remembering its shape. For example, to modify every element of a collection without dropping or adding elements. -We can represent all types that can be "mapped over" with `F`. It's a type constructor: the type of its values becomes concrete when provided a type argument. -Therefore we write it `F[_]`, hinting that the type `F` takes another type as argument. -The definition of a generic `Functor` would thus be written as: - -```scala -trait Functor[F[_]]: - def map[A, B](x: F[A], f: A => B): F[B] -``` - -Which could read as follows: "A `Functor` for the type constructor `F[_]` represents the ability to transform `F[A]` to `F[B]` through the application of function `f` with type `A => B`". We call the `Functor` definition here a _type class_. -This way, we could define an instance of `Functor` for the `List` type: - -```scala -given Functor[List] with - def map[A, B](x: List[A], f: A => B): List[B] = - x.map(f) // List already has a `map` method -``` - -With this `given` instance in scope, everywhere a `Functor` is expected, the compiler will accept a `List` to be used. - -For instance, we may write such a testing method: - -```scala -def assertTransformation[F[_]: Functor, A, B](expected: F[B], original: F[A], mapping: A => B): Unit = - assert(expected == summon[Functor[F]].map(original, mapping)) -``` - -And use it this way, for example: - -```scala -assertTransformation(List("a1", "b1"), List("a", "b"), elt => s"${elt}1") -``` - -That's a first step, but in practice we probably would like the `map` function to be a method directly accessible on the type `F`. So that we can call `map` directly on instances of `F`, and get rid of the `summon[Functor[F]]` part. -As in the previous example of Monoids, [`extension` methods](extension-methods.html) help achieving that. Let's re-define the `Functor` type class with extension methods. - -```scala -trait Functor[F[_]]: - extension [A](x: F[A]) - def map[B](f: A => B): F[B] -``` - -The instance of `Functor` for `List` now becomes: - -```scala -given Functor[List] with - extension [A](xs: List[A]) - def map[B](f: A => B): List[B] = - xs.map(f) // List already has a `map` method - -``` - -It simplifies the `assertTransformation` method: - -```scala -def assertTransformation[F[_]: Functor, A, B](expected: F[B], original: F[A], mapping: A => B): Unit = - assert(expected == original.map(mapping)) -``` - -The `map` method is now directly used on `original`. It is available as an extension method -since `original`'s type is `F[A]` and a given instance for `Functor[F[A]]` which defines `map` -is in scope. - -### Monads - -Applying `map` in `Functor[List]` to a mapping function of type `A => B` results in a `List[B]`. So applying it to a mapping function of type `A => List[B]` results in a `List[List[B]]`. To avoid managing lists of lists, we may want to "flatten" the values in a single list. - -That's where `Monad` comes in. A `Monad` for type `F[_]` is a `Functor[F]` with two more operations: - -* `flatMap`, which turns an `F[A]` into an `F[B]` when given a function of type `A => F[B]`, -* `pure`, which creates an `F[A]` from a single value `A`. - -Here is the translation of this definition in Scala 3: - -```scala -trait Monad[F[_]] extends Functor[F]: - - /** The unit value for a monad */ - def pure[A](x: A): F[A] - - extension [A](x: F[A]) - /** The fundamental composition operation */ - def flatMap[B](f: A => F[B]): F[B] - - /** The `map` operation can now be defined in terms of `flatMap` */ - def map[B](f: A => B) = x.flatMap(f.andThen(pure)) - -end Monad -``` - -#### List - -A `List` can be turned into a monad via this `given` instance: - -```scala -given listMonad: Monad[List] with - def pure[A](x: A): List[A] = - List(x) - extension [A](xs: List[A]) - def flatMap[B](f: A => List[B]): List[B] = - xs.flatMap(f) // rely on the existing `flatMap` method of `List` -``` - -Since `Monad` is a subtype of `Functor`, `List` is also a functor. The Functor's `map` -operation is already provided by the `Monad` trait, so the instance does not need to define -it explicitly. - -#### Option - -`Option` is an other type having the same kind of behaviour: - -```scala -given optionMonad: Monad[Option] with - def pure[A](x: A): Option[A] = - Option(x) - extension [A](xo: Option[A]) - def flatMap[B](f: A => Option[B]): Option[B] = xo match - case Some(x) => f(x) - case None => None -``` - -#### Reader - -Another example of a `Monad` is the _Reader_ Monad, which acts on functions instead of -data types like `List` or `Option`. It can be used to combine multiple functions -that all need the same parameter. For instance multiple functions needing access to some configuration, context, environment variables, etc. - -Let's define a `Config` type, and two functions using it: - -```scala -trait Config -// ... -def compute(i: Int)(config: Config): String = ??? -def show(str: String)(config: Config): Unit = ??? -``` - -We may want to combine `compute` and `show` into a single function, accepting a `Config` as parameter, and showing the result of the computation, and we'd like to use -a monad to avoid passing the parameter explicitly multiple times. So postulating -the right `flatMap` operation, we could write: - -```scala -def computeAndShow(i: Int): Config => Unit = compute(i).flatMap(show) -``` - -instead of - -```scala -show(compute(i)(config))(config) -``` - -Let's define this m then. First, we are going to define a type named `ConfigDependent` representing a function that when passed a `Config` produces a `Result`. - -```scala -type ConfigDependent[Result] = Config => Result -``` - -The monad instance will look like this: - -```scala -given configDependentMonad: Monad[ConfigDependent] with - - def pure[A](x: A): ConfigDependent[A] = - config => x - - extension [A](x: ConfigDependent[A]) - def flatMap[B](f: A => ConfigDependent[B]): ConfigDependent[B] = - config => f(x(config))(config) - -end configDependentMonad -``` - -The type `ConfigDependent` can be written using [type lambdas](../new-types/type-lambdas.html): - -```scala -type ConfigDependent = [Result] =>> Config => Result -``` - -Using this syntax would turn the previous `configDependentMonad` into: - -```scala -given configDependentMonad: Monad[[Result] =>> Config => Result] with - - def pure[A](x: A): Config => A = - config => x - - extension [A](x: Config => A) - def flatMap[B](f: A => Config => B): Config => B = - config => f(x(config))(config) - -end configDependentMonad -``` - -It is likely that we would like to use this pattern with other kinds of environments than our `Config` trait. The Reader monad allows us to abstract away `Config` as a type _parameter_, named `Ctx` in the following definition: - -```scala -given readerMonad[Ctx]: Monad[[X] =>> Ctx => X] with - - def pure[A](x: A): Ctx => A = - ctx => x - - extension [A](x: Ctx => A) - def flatMap[B](f: A => Ctx => B): Ctx => B = - ctx => f(x(ctx))(ctx) - -end readerMonad -``` - -### Summary - -The definition of a _type class_ is expressed with a parameterised type with abstract members, such as a `trait`. -The main difference between subtype polymorphism and ad-hoc polymorphism with _type classes_ is how the definition of the _type class_ is implemented, in relation to the type it acts upon. -In the case of a _type class_, its implementation for a concrete type is expressed through a `given` instance definition, which is supplied as an implicit argument alongside the value it acts upon. With subtype polymorphism, the implementation is mixed into the parents of a class, and only a single term is required to perform a polymorphic operation. The type class solution -takes more effort to set up, but is more extensible: Adding a new interface to a -class requires changing the source code of that class. But contrast, instances for type classes can be defined anywhere. - -To conclude, we have seen that traits and given instances, combined with other constructs like extension methods, context bounds and type lambdas allow a concise and natural expression of _type classes_. diff --git a/_scala3-reference/contextual/using-clauses.md b/_scala3-reference/contextual/using-clauses.md deleted file mode 100644 index b233c84667..0000000000 --- a/_scala3-reference/contextual/using-clauses.md +++ /dev/null @@ -1,155 +0,0 @@ ---- -title: "Using Clauses" -type: section -num: 16 -previous-page: /scala3/reference/contextual/givens -next-page: /scala3/reference/contextual/context-bounds ---- - -Functional programming tends to express most dependencies as simple function parameterization. -This is clean and powerful, but it sometimes leads to functions that take many parameters where the same value is passed over and over again in long call chains to many -functions. Context parameters can help here since they enable the compiler to synthesize -repetitive arguments instead of the programmer having to write them explicitly. - -For example, with the [given instances](./givens.html) defined previously, -a `max` function that works for any arguments for which an ordering exists can be defined as follows: - -```scala -def max[T](x: T, y: T)(using ord: Ord[T]): T = - if ord.compare(x, y) < 0 then y else x -``` - -Here, `ord` is a _context parameter_ introduced with a `using` clause. -The `max` function can be applied as follows: - -```scala -max(2, 3)(using intOrd) -``` - -The `(using intOrd)` part passes `intOrd` as an argument for the `ord` parameter. But the point of context parameters is that this argument can also be left out (and it usually is). So the following applications are equally valid: - -```scala -max(2, 3) -max(List(1, 2, 3), Nil) -``` - -## Anonymous Context Parameters - -In many situations, the name of a context parameter need not be -mentioned explicitly at all, since it is used only in synthesized arguments for -other context parameters. In that case one can avoid defining a parameter name -and just provide its type. Example: - -```scala -def maximum[T](xs: List[T])(using Ord[T]): T = - xs.reduceLeft(max) -``` - -`maximum` takes a context parameter of type `Ord[T]` only to pass it on as an -inferred argument to `max`. The name of the parameter is left out. - -Generally, context parameters may be defined either as a full parameter list `(p_1: T_1, ..., p_n: T_n)` or just as a sequence of types `T_1, ..., T_n`. Vararg parameters are not supported in `using` clauses. - -## Class Context Parameters - -If a class context parameter is made a member by adding a `val` or `var` modifier, -then that member is available as a given instance. - -Compare the following examples, where the attempt to supply an explicit `given` member induces an ambiguity: - -```scala -class GivenIntBox(using val givenInt: Int): - def n = summon[Int] - -class GivenIntBox2(using givenInt: Int): - given Int = givenInt - //def n = summon[Int] // ambiguous -``` - -The `given` member is importable as explained in the section on [importing `given`s](./given-imports.html): - -```scala -val b = GivenIntBox(using 23) -import b.given -summon[Int] // 23 - -import b.* -//givenInt // Not found -``` - -## Inferring Complex Arguments - -Here are two other methods that have a context parameter of type `Ord[T]`: - -```scala -def descending[T](using asc: Ord[T]): Ord[T] = new Ord[T]: - def compare(x: T, y: T) = asc.compare(y, x) - -def minimum[T](xs: List[T])(using Ord[T]) = - maximum(xs)(using descending) -``` - -The `minimum` method's right-hand side passes `descending` as an explicit argument to `maximum(xs)`. -With this setup, the following calls are all well-formed, and they all normalize to the last one: - -```scala -minimum(xs) -maximum(xs)(using descending) -maximum(xs)(using descending(using listOrd)) -maximum(xs)(using descending(using listOrd(using intOrd))) -``` - -## Multiple `using` Clauses - -There can be several `using` clauses in a definition and `using` clauses can be freely mixed with normal parameter clauses. Example: - -```scala -def f(u: Universe)(using ctx: u.Context)(using s: ctx.Symbol, k: ctx.Kind) = ... -``` - -Multiple `using` clauses are matched left-to-right in applications. Example: - -```scala -object global extends Universe { type Context = ... } -given ctx : global.Context with { type Symbol = ...; type Kind = ... } -given sym : ctx.Symbol -given kind: ctx.Kind - -``` -Then the following calls are all valid (and normalize to the last one) - -```scala -f(global) -f(global)(using ctx) -f(global)(using ctx)(using sym, kind) -``` - -But `f(global)(using sym, kind)` would give a type error. - - -## Summoning Instances - -The method `summon` in `Predef` returns the given of a specific type. For example, -the given instance for `Ord[List[Int]]` is produced by - -```scala -summon[Ord[List[Int]]] // reduces to listOrd(using intOrd) -``` - -The `summon` method is simply defined as the (non-widening) identity function over a context parameter. - -```scala -def summon[T](using x: T): x.type = x -``` - -## Syntax - -Here is the new syntax of parameters and arguments seen as a delta from the [standard context free syntax of Scala 3](../syntax.html). `using` is a soft keyword, recognized only at the start of a parameter or argument list. It can be used as a normal identifier everywhere else. - -``` -ClsParamClause ::= ... | UsingClsParamClause -DefParamClauses ::= ... | UsingParamClause -UsingClsParamClause ::= ‘(’ ‘using’ (ClsParams | Types) ‘)’ -UsingParamClause ::= ‘(’ ‘using’ (DefParams | Types) ‘)’ -ParArgumentExprs ::= ... | ‘(’ ‘using’ ExprsInParens ‘)’ -``` diff --git a/_scala3-reference/dropped-features.md b/_scala3-reference/dropped-features.md deleted file mode 100644 index fdffc69542..0000000000 --- a/_scala3-reference/dropped-features.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Dropped Features -type: chapter -num: 70 -previous-page: /scala3/reference/changed-features/main-functions -next-page: /scala3/reference/dropped-features/delayed-init ---- - -The following pages document the features of Scala 2 that have been dropped in Scala 3. diff --git a/_scala3-reference/dropped-features/auto-apply.md b/_scala3-reference/dropped-features/auto-apply.md deleted file mode 100644 index 8670850f79..0000000000 --- a/_scala3-reference/dropped-features/auto-apply.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: "Dropped: Auto-Application" -type: section -num: 83 -previous-page: /scala3/reference/dropped-features/symlits -next-page: /scala3/reference/dropped-features/weak-conformance ---- - -Previously an empty argument list `()` was implicitly inserted when -calling a nullary method without arguments. Example: - -```scala -def next(): T = ... -next // is expanded to next() -``` - -In Scala 3, this idiom is an error. - -```scala -next -^ -missing arguments for method next -``` - -In Scala 3, the application syntax has to follow exactly the parameter -syntax. Excluded from this rule are methods that are defined in Java -or that override methods defined in Java. The reason for being more -lenient with such methods is that otherwise everyone would have to -write - -```scala -xs.toString().length() -``` - -instead of - -```scala -xs.toString.length -``` - -The latter is idiomatic Scala because it conforms to the _uniform -access principle_. This principle states that one should be able to -change an object member from a field to a non-side-effecting method -and back without affecting clients that access the -member. Consequently, Scala encourages to define such "property" -methods without a `()` parameter list whereas side-effecting methods -should be defined with it. Methods defined in Java cannot make this -distinction; for them a `()` is always mandatory. So Scala fixes the -problem on the client side, by allowing the parameterless references. -But where Scala allows that freedom for all method references, Scala 3 -restricts it to references of external methods that are not defined -themselves in Scala 3. - -For reasons of backwards compatibility, Scala 3 for the moment also -auto-inserts `()` for nullary methods that are defined in Scala 2, or -that override a method defined in Scala 2. It turns out that, because -the correspondence between definition and call was not enforced in -Scala so far, there are quite a few method definitions in Scala 2 -libraries that use `()` in an inconsistent way. For instance, we -find in `scala.math.Numeric` - -```scala -def toInt(): Int -``` - -whereas `toInt` is written without parameters everywhere -else. Enforcing strict parameter correspondence for references to -such methods would project the inconsistencies to client code, which -is undesirable. So Scala 3 opts for more leniency when type-checking -references to such methods until most core libraries in Scala 2 have -been cleaned up. - -Stricter conformance rules also apply to overriding of nullary -methods. It is no longer allowed to override a parameterless method -by a nullary method or _vice versa_. Instead, both methods must agree -exactly in their parameter lists. - -```scala -class A: - def next(): Int - -class B extends A: - def next: Int // overriding error: incompatible type -``` - -Methods overriding Java or Scala 2 methods are again exempted from this -requirement. - -### Migrating code - -Existing Scala code with inconsistent parameters can still be compiled -in Scala 3 under `-source 3.0-migration`. When paired with the `-rewrite` -option, the code will be automatically rewritten to conform to Scala 3's -stricter checking. - -### Reference - -For more information, see [Issue #2570](https://github.com/lampepfl/dotty/issues/2570) and [PR #2716](https://github.com/lampepfl/dotty/pull/2716). diff --git a/_scala3-reference/dropped-features/class-shadowing-spec.md b/_scala3-reference/dropped-features/class-shadowing-spec.md deleted file mode 100644 index d1d5d4b34b..0000000000 --- a/_scala3-reference/dropped-features/class-shadowing-spec.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Dropped: Class Shadowing - More Details" ---- - -Spec diff: in section [5.1.4 Overriding](https://www.scala-lang.org/files/archive/spec/2.13/05-classes-and-objects.html#Overriding), add *M' must not be a class*. - -> Why do we want to make this change to the language? - -Class shadowing is irregular compared to other types of overrides. Indeed, inner classes are not actually overridden but simply shadowed. - - -> How much existing code is going to be affected? - -From all the code compiled so far with Scala 3 the only instance of this I could find is in the stdlib. Looking at [this commit](https://github.com/lampepfl/scala/commit/68f13bf39979b631ed211ec1751934306ceb5d6c#diff-7aa508b70e055b47c823764e3e5646b8) it seems like the usage of class shadowing was accidental. - - -> How exactly is existing code going to be affected? - -Code that relies on overridden inner classes will stop compiling. - - -> Is this change going to be migratable automatically? - -No. diff --git a/_scala3-reference/dropped-features/class-shadowing.md b/_scala3-reference/dropped-features/class-shadowing.md deleted file mode 100644 index b3a4ab2dc1..0000000000 --- a/_scala3-reference/dropped-features/class-shadowing.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: "Dropped: Class Shadowing" -type: section -num: 79 -previous-page: /scala3/reference/dropped-features/early-initializers -next-page: /scala3/reference/dropped-features/limit22 ---- - -Scala 2 so far allowed patterns like this: - -```scala -class Base { - class Ops { ... } -} - -class Sub extends Base { - class Ops { ... } -} -``` - -Scala 3 rejects this with the error message: - -```scala -6 | class Ops { } - | ^ - |class Ops cannot have the same name as class Ops in class Base - | -- class definitions cannot be overridden -``` - -The issue is that the two `Ops` classes _look_ like one overrides the -other, but classes in Scala 2 cannot be overridden. To keep things clean -(and its internal operations consistent) the Scala 3 compiler forces you -to rename the inner classes so that their names are different. - -[More details](./class-shadowing-spec.html) diff --git a/_scala3-reference/dropped-features/delayed-init.md b/_scala3-reference/dropped-features/delayed-init.md deleted file mode 100644 index 5673db5dfb..0000000000 --- a/_scala3-reference/dropped-features/delayed-init.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: "Dropped: DelayedInit" -type: section -num: 71 -previous-page: /scala3/reference/dropped-features -next-page: /scala3/reference/dropped-features/macros ---- - -The special handling of the `DelayedInit` trait is no longer supported. - -One consequence is that the `App` class, which used `DelayedInit` is -now partially broken. You can still use `App` as a simple way to set up a main program. Example: - -```scala -object HelloWorld extends App { - println("Hello, world!") -} -``` - -However, the code is now run in the initializer of the object, which on -some JVM's means that it will only be interpreted. So, better not use it -for benchmarking! Also, if you want to access the command line arguments, -you need to use an explicit `main` method for that. - -```scala -object Hello: - def main(args: Array[String]) = - println(s"Hello, ${args(0)}") -``` - -On the other hand, Scala 3 offers a convenient alternative to such "program" objects -with [`@main` methods](../changed-features/main-functions.html). diff --git a/_scala3-reference/dropped-features/do-while.md b/_scala3-reference/dropped-features/do-while.md deleted file mode 100644 index 3fd59430ac..0000000000 --- a/_scala3-reference/dropped-features/do-while.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: "Dropped: Do-While" -type: section -num: 75 -previous-page: /scala3/reference/dropped-features/type-projection -next-page: /scala3/reference/dropped-features/procedure-syntax ---- - -The syntax construct -```scala -do while -``` -is no longer supported. Instead, it is recommended to use the equivalent `while` loop -below: -```scala -while ({ ; }) () -``` -For instance, instead of -```scala -do - i += 1 -while (f(i) == 0) -``` -one writes -```scala -while - i += 1 - f(i) == 0 -do () -``` -The idea to use a block as the condition of a while also gives a solution -to the "loop-and-a-half" problem. Here is another example: -```scala -while - val x: Int = iterator.next - x >= 0 -do print(".") -``` - -### Why Drop The Construct? - - - `do-while` is used relatively rarely and it can be expressed faithfully using just `while`. So there seems to be little point in having it as a separate syntax construct. - - Under the [new syntax rules](../other-new-features/control-syntax.html) `do` is used as a statement continuation, which would clash with its meaning as a statement introduction. diff --git a/_scala3-reference/dropped-features/early-initializers.md b/_scala3-reference/dropped-features/early-initializers.md deleted file mode 100644 index 18d97640b1..0000000000 --- a/_scala3-reference/dropped-features/early-initializers.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Dropped: Early Initializers" -type: section -num: 78 -previous-page: /scala3/reference/dropped-features/package-objects -next-page: /scala3/reference/dropped-features/class-shadowing ---- - -Early initializers of the form - -```scala -class C extends { ... } with SuperClass ... -``` - -have been dropped. They were rarely used, and mostly to compensate for the lack of -[trait parameters](../other-new-features/trait-parameters.html), which are now directly supported in Scala 3. - -For more information, see [SLS §5.1.6](https://www.scala-lang.org/files/archive/spec/2.13/05-classes-and-objects.html#early-definitions). diff --git a/_scala3-reference/dropped-features/existential-types.md b/_scala3-reference/dropped-features/existential-types.md deleted file mode 100644 index df624cbd07..0000000000 --- a/_scala3-reference/dropped-features/existential-types.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: "Dropped: Existential Types" -type: section -num: 73 -previous-page: /scala3/reference/dropped-features/macros -next-page: /scala3/reference/dropped-features/type-projection ---- - -Existential types using `forSome` (as in -[SLS §3.2.12](https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#existential-types)) -have been dropped. The reasons for dropping them are: - - - Existential types violate a type soundness principle on which DOT - and Scala 3 are constructed. That principle says that every - prefix (`p`, respectvely `S`) of a type selection `p.T` or `S#T` - must either come from a value constructed at runtime or refer to a - type that is known to have only good bounds. - - - Existential types create many difficult feature interactions - with other Scala constructs. - - - Existential types largely overlap with path-dependent types, - so the gain of having them is relatively minor. - -Existential types that can be expressed using only wildcards (but not -`forSome`) are still supported, but are treated as refined types. -For instance, the type -```scala -Map[_ <: AnyRef, Int] -``` -is treated as the type `Map`, where the first type parameter -is upper-bounded by `AnyRef` and the second type parameter is an alias -of `Int`. - -When reading class files compiled with Scala 2, Scala 3 will do a best -effort to approximate existential types with its own types. It will -issue a warning that a precise emulation is not possible. diff --git a/_scala3-reference/dropped-features/limit22.md b/_scala3-reference/dropped-features/limit22.md deleted file mode 100644 index 2e21efec58..0000000000 --- a/_scala3-reference/dropped-features/limit22.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Dropped: Limit 22" -type: section -num: 80 -previous-page: /scala3/reference/dropped-features/class-shadowing -next-page: /scala3/reference/dropped-features/xml ---- - -The limits of 22 for the maximal number of parameters of function types and the -maximal number of fields in tuple types have been dropped. - -* Functions can now have an arbitrary number of parameters. Functions beyond - [`scala.Function22`](https://www.scala-lang.org/api/current/scala/Function22.html) are erased to a new trait [`scala.runtime.FunctionXXL`](https://scala-lang.org/api/3.x/scala/runtime/FunctionXXL.html). - -* Tuples can also have an arbitrary number of fields. Tuples beyond [`scala.Tuple22`](https://www.scala-lang.org/api/current/scala/Tuple22.html) - are erased to a new class [`scala.runtime.TupleXXL`](https://scala-lang.org/api/3.x/scala/runtime/TupleXXL.html) (which extends the trait [`scala.Product`](https://scala-lang.org/api/3.x/scala/Product.html)). Furthermore, they support generic - operation such as concatenation and indexing. - -Both of these are implemented using arrays. diff --git a/_scala3-reference/dropped-features/macros.md b/_scala3-reference/dropped-features/macros.md deleted file mode 100644 index f7a23edb00..0000000000 --- a/_scala3-reference/dropped-features/macros.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: "Dropped: Scala 2 Macros" -type: section -num: 72 -previous-page: /scala3/reference/dropped-features/delayed-init -next-page: /scala3/reference/dropped-features/existential-types ---- - -The previous, experimental macro system has been dropped. - -Instead, there is a cleaner, more restricted system based on two complementary concepts: `inline` and `'{ ... }`/`${ ... }` code generation. -`'{ ... }` delays the compilation of the code and produces an object containing the code, dually `${ ... }` evaluates an expression which produces code and inserts it in the surrounding `${ ... }`. -In this setting, a definition marked as inlined containing a `${ ... }` is a macro, the code inside the `${ ... }` is executed at compile-time and produces code in the form of `'{ ... }`. -Additionally, the contents of code can be inspected and created with a more complex reflection API as an extension of `'{ ... }`/`${ ... }` framework. - -* `inline` has been [implemented](../metaprogramming/inline.html) in Scala 3. -* Quotes `'{ ... }` and splices `${ ... }` has been [implemented](../metaprogramming/macros.html) in Scala 3. -* [TASTy reflect](../metaprogramming/reflection.html) provides more complex tree based APIs to inspect or create quoted code. diff --git a/_scala3-reference/dropped-features/nonlocal-returns.md b/_scala3-reference/dropped-features/nonlocal-returns.md deleted file mode 100644 index 89b244f122..0000000000 --- a/_scala3-reference/dropped-features/nonlocal-returns.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Deprecated: Nonlocal Returns" ---- - -Returning from nested anonymous functions has been deprecated. - -Nonlocal returns are implemented by throwing and catching `scala.runtime.NonLocalReturnException`-s. This is rarely what is intended by the programmer. It can be problematic because of the hidden performance cost of throwing and catching exceptions. Furthermore, it is a leaky implementation: a catch-all exception handler can intercept a `NonLocalReturnException`. - -A drop-in library replacement is provided in [`scala.util.control.NonLocalReturns`](https://scala-lang.org/api/3.x/scala/util/control/NonLocalReturns$.html). Example: - -```scala -import scala.util.control.NonLocalReturns.* - -extension [T](xs: List[T]) - def has(elem: T): Boolean = returning { - for x <- xs do - if x == elem then throwReturn(true) - false - } - -@main def test(): Unit = - val xs = List(1, 2, 3, 4, 5) - assert(xs.has(2) == xs.contains(2)) -``` diff --git a/_scala3-reference/dropped-features/package-objects.md b/_scala3-reference/dropped-features/package-objects.md deleted file mode 100644 index 35e21d56a2..0000000000 --- a/_scala3-reference/dropped-features/package-objects.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: "Dropped: Package Objects" -type: section -num: 77 -previous-page: /scala3/reference/dropped-features/procedure-syntax -next-page: /scala3/reference/dropped-features/early-initializers ---- - -Package objects -```scala -package object p { - val a = ... - def b = ... -} -``` -will be dropped. They are still available in Scala 3.0, but will be deprecated and removed afterwards. - -Package objects are no longer needed since all kinds of definitions can now be written at the top-level. Example: -```scala -package p -type Labelled[T] = (String, T) -val a: Labelled[Int] = ("count", 1) -def b = a._2 - -case class C() - -extension (x: C) def pair(y: C) = (x, y) -``` -There may be several source files in a package containing such top-level definitions, and source files can freely mix top-level value, method, and type definitions with classes and objects. - -The compiler generates synthetic objects that wrap top-level definitions falling into one of the following categories: - - - all pattern, value, method, and type definitions, - - implicit classes and objects, - - companion objects of opaque type aliases. - -If a source file `src.scala` contains such top-level definitions, they will be put in a synthetic object named `src$package`. The wrapping is transparent, however. The definitions in `src` can still be accessed as members of the enclosing package. - -**Note:** This means that -1. The name of a source file containing wrapped top-level definitions is relevant for binary compatibility. If the name changes, so does the name of the generated object and its class. - -2. A top-level main method `def main(args: Array[String]): Unit = ...` is wrapped as any other method. If it appears -in a source file `src.scala`, it could be invoked from the command line using a command like `scala src$package`. Since the -"program name" is mangled it is recommended to always put `main` methods in explicitly named objects. - -3. The notion of `private` is independent of whether a definition is wrapped or not. A `private` top-level definition is always visible from everywhere in the enclosing package. - -4. If several top-level definitions are overloaded variants with the same name, -they must all come from the same source file. diff --git a/_scala3-reference/dropped-features/procedure-syntax.md b/_scala3-reference/dropped-features/procedure-syntax.md deleted file mode 100644 index f3bf8cc9d4..0000000000 --- a/_scala3-reference/dropped-features/procedure-syntax.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: "Dropped: Procedure Syntax" -type: section -num: 76 -previous-page: /scala3/reference/dropped-features/do-while -next-page: /scala3/reference/dropped-features/package-objects ---- - -Procedure syntax -```scala -def f() { ... } -``` -has been dropped. You need to write one of the following instead: -```scala -def f() = { ... } -def f(): Unit = { ... } -``` -Scala 3 accepts the old syntax under the `-source:3.0-migration` option. -If the `-migration` option is set, it can even rewrite old syntax to new. -The [Scalafix](https://scalacenter.github.io/scalafix/) tool also -can rewrite procedure syntax to make it Scala 3 compatible. diff --git a/_scala3-reference/dropped-features/symlits.md b/_scala3-reference/dropped-features/symlits.md deleted file mode 100644 index 3cb7243af9..0000000000 --- a/_scala3-reference/dropped-features/symlits.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "Dropped: Symbol Literals" -type: section -num: 82 -previous-page: /scala3/reference/dropped-features/xml -next-page: /scala3/reference/dropped-features/auto-apply ---- - -Symbol literals are no longer supported. - -The `scala.Symbol` class still exists, so a -literal translation of the symbol literal `'xyz` is `Symbol("xyz")`. However, it is recommended to use a plain string literal `"xyz"` instead. (The `Symbol` class will be deprecated and removed in the future). diff --git a/_scala3-reference/dropped-features/this-qualifier.md b/_scala3-reference/dropped-features/this-qualifier.md deleted file mode 100644 index c25f896415..0000000000 --- a/_scala3-reference/dropped-features/this-qualifier.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: "Dropped: private[this] and protected[this]" -type: section -num: 85 -previous-page: /scala3/reference/dropped-features/weak-conformance -next-page: /scala3/reference/dropped-features/wildcard-init ---- - -The `private[this]` and `protected[this]` access modifiers are deprecated and will be phased out. - -Previously, these modifiers were needed for - - - avoiding the generation of getters and setters - - excluding code under a `private[this]` from variance checks. (Scala 2 also excludes `protected[this]` but this was found to be unsound and was therefore removed). - -The compiler now infers for `private` members the fact that they are only accessed via `this`. Such members are treated as if they had been declared `private[this]`. `protected[this]` is dropped without a replacement. - diff --git a/_scala3-reference/dropped-features/type-projection.md b/_scala3-reference/dropped-features/type-projection.md deleted file mode 100644 index fb87ef79be..0000000000 --- a/_scala3-reference/dropped-features/type-projection.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Dropped: General Type Projection" -type: section -num: 74 -previous-page: /scala3/reference/dropped-features/existential-types -next-page: /scala3/reference/dropped-features/do-while ---- - -Scala so far allowed general type projection `T#A` where `T` is an arbitrary type -and `A` names a type member of `T`. - -Scala 3 disallows this if `T` is an abstract type (class types and type aliases -are fine). This change was made because unrestricted type projection -is [unsound](https://github.com/lampepfl/dotty/issues/1050). - -This restriction rules out the [type-level encoding of a combinator -calculus](https://michid.wordpress.com/2010/01/29/scala-type-level-encoding-of-the-ski-calculus/). - -To rewrite code using type projections on abstract types, consider using -path-dependent types or implicit parameters. diff --git a/_scala3-reference/dropped-features/weak-conformance-spec.md b/_scala3-reference/dropped-features/weak-conformance-spec.md deleted file mode 100644 index 147298f557..0000000000 --- a/_scala3-reference/dropped-features/weak-conformance-spec.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Dropped: Weak Conformance - More Details" ---- - -To simplify the underlying type theory, Scala 3 drops the notion of -[*weak conformance*](https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#weak-conformance) -altogether. Instead, it provides more flexibility when -assigning a type to a constant expression. The new rule is: - - - *If* a list of expressions `Es` appears as one of - - - the elements of a vararg parameter, or - - the alternatives of an if-then-else or match expression, or - - the body and catch results of a try expression, - -- *and* all expressions have primitive numeric types, but they do not - all have the same type, - -- *then* the following is attempted: - - - the expressions `Es` are partitioned into `Int` constants on the - one hand, and all other expressions on the other hand, - - if all the other expressions have the same numeric type `T` - (which can be one of `Byte`, `Short`, `Char`, `Int`, `Long`, `Float`, - `Double`), possibly after widening, and if none of the `Int` - literals would incur a loss of precision when converted to `T`, - then they are thus converted (the other expressions are left - unchanged regardless), - - otherwise, the expressions `Es` are used unchanged. - - A loss of precision occurs for - - an `Int -> Float` conversion of a constant - `c` if `c.toFloat.toInt != c` - - an `Int -> Byte` conversion of a constant - `c` if `c.toByte.toInt != c`, - - an `Int -> Short` conversion of a constant - `c` if `c.toShort.toInt != c`. - -### Examples - -```scala -inline val b = 33 -def f(): Int = b + 1 -Array(b, 33, 5.5) : Array[Double] // b is an inline val -Array(f(), 33, 5.5) : Array[AnyVal] // f() is not a constant -Array(5, 11L) : Array[Long] -Array(5, 11L, 5.5) : Array[AnyVal] // Long and Double found -Array(1.0f, 2) : Array[Float] -Array(1.0f, 1234567890): Array[AnyVal] // loss of precision -Array(b, 33, 'a') : Array[Char] -Array(5.toByte, 11) : Array[Byte] -``` diff --git a/_scala3-reference/dropped-features/weak-conformance.md b/_scala3-reference/dropped-features/weak-conformance.md deleted file mode 100644 index deca70b607..0000000000 --- a/_scala3-reference/dropped-features/weak-conformance.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: "Dropped: Weak Conformance" -type: section -num: 84 -previous-page: /scala3/reference/dropped-features/auto-apply -next-page: /scala3/reference/dropped-features/this-qualifier ---- - -In some situations, Scala used a _weak conformance_ relation when -testing type compatibility or computing the least upper bound of a set -of types. The principal motivation behind weak conformance was to -make an expression like this have type `List[Double]`: - -```scala -List(1.0, math.sqrt(3.0), 0, -3.3) // : List[Double] -``` - -It's "obvious" that this should be a `List[Double]`. However, without -some special provision, the least upper bound of the lists's element -types `(Double, Double, Int, Double)` would be `AnyVal`, hence the list -expression would be given type `List[AnyVal]`. - -A less obvious example is the following one, which was also typed as a -`List[Double]`, using the weak conformance relation. - -```scala -val n: Int = 3 -val c: Char = 'X' -val d: Double = math.sqrt(3.0) -List(n, c, d) // used to be: List[Double], now: List[AnyVal] -``` - -Here, it is less clear why the type should be widened to -`List[Double]`, a `List[AnyVal]` seems to be an equally valid -- and -more principled -- choice. - -Weak conformance applies to all "numeric" types (including `Char`), and -independently of whether the expressions are literals or not. However, -in hindsight, the only intended use case is for *integer literals* to -be adapted to the type of the other expressions. Other types of numerics -have an explicit type annotation embedded in their syntax (`f`, `d`, -`.`, `L` or `'` for `Char`s) which ensures that their author really -meant them to have that specific type). - -Therefore, Scala 3 drops the general notion of weak conformance, and -instead keeps one rule: `Int` literals are adapted to other numeric -types if necessary. - -[More details](weak-conformance-spec.html) diff --git a/_scala3-reference/dropped-features/wildcard-init.md b/_scala3-reference/dropped-features/wildcard-init.md deleted file mode 100644 index be633fb1ca..0000000000 --- a/_scala3-reference/dropped-features/wildcard-init.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: "Dropped: Wildcard Initializer" -type: section -num: 86 -previous-page: /scala3/reference/dropped-features/this-qualifier -next-page: /scala3/reference/syntax ---- - -The syntax - -```scala - var x: A = _ -``` - -that was used to indicate an uninitialized field, has been dropped. -At its place there is a special value `uninitialized` in the `scala.compiletime` package. -To get an uninitialized field, you now write - -```scala -import scala.compiletime.uninitialized - -var x: A = uninitialized -``` - -To enable cross-compilation, `_` is still supported, but it will be dropped in a future 3.x version. diff --git a/_scala3-reference/dropped-features/xml.md b/_scala3-reference/dropped-features/xml.md deleted file mode 100644 index cab3d0663a..0000000000 --- a/_scala3-reference/dropped-features/xml.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Dropped: XML Literals" -type: section -num: 81 -previous-page: /scala3/reference/dropped-features/limit22 -next-page: /scala3/reference/dropped-features/symlits ---- - -XML Literals are still supported, but will be dropped in the near future, to -be replaced with [XML string interpolation](https://github.com/lampepfl/xml-interpolator): - -```scala -import dotty.xml.interpolator.* - -case class Person(name: String) { override def toString = name } - -@main def test: Unit = - val bill = Person("Bill") - val john = Person("John") - val mike = Person("Mike") - val todoList = List( - (bill, john, "Meeting", "Room 203, 11:00am"), - (john, mike, "Holiday", "March 22-24") - ) - // XML literals (to be dropped) - val mails1 = for (from, to, heading, body) <- todoList yield - - {from}{to} - {heading}{body} - - println(mails1) - // XML string interpolation - val mails2 = for (from, to, heading, body) <- todoList yield xml""" - - ${from}${to} - ${heading}${body} - """ - println(mails2) -``` - -For more information, see the semester project [XML String Interpolator for Dotty](https://infoscience.epfl.ch/record/267527) by Yassin Kammoun (2019). diff --git a/_scala3-reference/enums.md b/_scala3-reference/enums.md deleted file mode 100644 index e8c63c2377..0000000000 --- a/_scala3-reference/enums.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: "Enums" -type: chapter -num: 9 -previous-page: /scala3/reference/new-types/polymorphic-function-types -next-page: /scala3/reference/enums/enums ---- - -This chapter documents enums in Scala 3. diff --git a/_scala3-reference/enums/adts.md b/_scala3-reference/enums/adts.md deleted file mode 100644 index 10558707b5..0000000000 --- a/_scala3-reference/enums/adts.md +++ /dev/null @@ -1,175 +0,0 @@ ---- -title: "Algebraic Data Types" -type: section -num: 11 -previous-page: /scala3/reference/enums/enums -next-page: /scala3/reference/enums/desugarEnums ---- - -The [`enum` concept](./enums.html) is general enough to also support algebraic data -types (ADTs) and their generalized version (GADTs). Here is an example -how an `Option` type can be represented as an ADT: - -```scala -enum Option[+T]: - case Some(x: T) - case None -``` - -This example introduces an `Option` enum with a covariant type -parameter `T` consisting of two cases, `Some` and `None`. `Some` is -parameterized with a value parameter `x`. It is a shorthand for writing a -case class that extends `Option`. Since `None` is not parameterized, it -is treated as a normal enum value. - -The `extends` clauses that were omitted in the example above can also -be given explicitly: - -```scala -enum Option[+T]: - case Some(x: T) extends Option[T] - case None extends Option[Nothing] -``` - -Note that the parent type of the `None` value is inferred as -`Option[Nothing]`. Generally, all covariant type parameters of the enum -class are minimized in a compiler-generated `extends` clause whereas all -contravariant type parameters are maximized. If `Option` was non-variant, -you would need to give the extends clause of `None` explicitly. - -As for normal enum values, the cases of an `enum` are all defined in -the `enum`s companion object. So it's `Option.Some` and `Option.None` -unless the definitions are "pulled out" with an import: - -```scala -scala> Option.Some("hello") -val res1: t2.Option[String] = Some(hello) - -scala> Option.None -val res2: t2.Option[Nothing] = None -``` - -Note that the type of the expressions above is always `Option`. Generally, the type of a enum case constructor application will be widened to the underlying enum type, unless a more specific type is expected. This is a subtle difference with respect to normal case classes. The classes making up the cases do exist, and can be unveiled, either by constructing them directly with a `new`, or by explicitly providing an expected type. - -```scala -scala> new Option.Some(2) -val res3: Option.Some[Int] = Some(2) -scala> val x: Option.Some[Int] = Option.Some(3) -val res4: Option.Some[Int] = Some(3) -``` - -As all other enums, ADTs can define methods. For instance, here is `Option` again, with an -`isDefined` method and an `Option(...)` constructor in its companion object. - -```scala -enum Option[+T]: - case Some(x: T) - case None - - def isDefined: Boolean = this match - case None => false - case _ => true - -object Option: - - def apply[T >: Null](x: T): Option[T] = - if x == null then None else Some(x) - -end Option -``` - -Enumerations and ADTs have been presented as two different -concepts. But since they share the same syntactic construct, they can -be seen simply as two ends of a spectrum and it is perfectly possible -to construct hybrids. For instance, the code below gives an -implementation of `Color` either with three enum values or with a -parameterized case that takes an RGB value. - -```scala -enum Color(val rgb: Int): - case Red extends Color(0xFF0000) - case Green extends Color(0x00FF00) - case Blue extends Color(0x0000FF) - case Mix(mix: Int) extends Color(mix) -``` - -### Parameter Variance of Enums - -By default, parameterized cases of enums with type parameters will copy the type parameters of their parent, along -with any variance notations. As usual, it is important to use type parameters carefully when they are variant, as shown -below: - -The following `View` enum has a contravariant type parameter `T` and a single case `Refl`, representing a function -mapping a type `T` to itself: - -```scala -enum View[-T]: - case Refl(f: T => T) -``` - -The definition of `Refl` is incorrect, as it uses contravariant type `T` in the covariant result position of a -function type, leading to the following error: - -```scala --- Error: View.scala:2:12 -------- -2 | case Refl(f: T => T) - | ^^^^^^^^^ - |contravariant type T occurs in covariant position in type T => T of value f - |enum case Refl requires explicit declaration of type T to resolve this issue. -``` - -Because `Refl` does not declare explicit parameters, it looks to the compiler like the following: - -```scala -enum View[-T]: - case Refl[/*synthetic*/-T1](f: T1 => T1) extends View[T1] -``` - -The compiler has inferred for `Refl` the contravariant type parameter `T1`, following `T` in `View`. -We can now clearly see that `Refl` needs to declare its own non-variant type parameter to correctly type `f`, -and can remedy the error by the following change to `Refl`: - -```diff -enum View[-T]: -- case Refl(f: T => T) -+ case Refl[R](f: R => R) extends View[R] -``` - -Above, type `R` is chosen as the parameter for `Refl` to highlight that it has a different meaning to -type `T` in `View`, but any name will do. - -After some further changes, a more complete implementation of `View` can be given as follows and be used -as the function type `T => U`: - -```scala -enum View[-T, +U] extends (T => U): - case Refl[R](f: R => R) extends View[R, R] - - final def apply(t: T): U = this match - case refl: Refl[r] => refl.f(t) -``` - -### Syntax of Enums - -Changes to the syntax fall in two categories: enum definitions and cases inside enums. -The changes are specified below as deltas with respect to the Scala syntax given [here](../syntax.html) - - 1. Enum definitions are defined as follows: - - ``` - TmplDef ::= `enum' EnumDef - EnumDef ::= id ClassConstr [`extends' [ConstrApps]] EnumBody - EnumBody ::= [nl] ‘{’ [SelfType] EnumStat {semi EnumStat} ‘}’ - EnumStat ::= TemplateStat - | {Annotation [nl]} {Modifier} EnumCase - ``` - - 2. Cases of enums are defined as follows: - - ``` - EnumCase ::= `case' (id ClassConstr [`extends' ConstrApps]] | ids) - ``` - -### Reference - -For more information, see [Issue #1970](https://github.com/lampepfl/dotty/issues/1970). diff --git a/_scala3-reference/enums/desugarEnums.md b/_scala3-reference/enums/desugarEnums.md deleted file mode 100644 index efcc41d5b2..0000000000 --- a/_scala3-reference/enums/desugarEnums.md +++ /dev/null @@ -1,217 +0,0 @@ ---- -title: "Translation of Enums and ADTs" -type: section -num: 12 -previous-page: /scala3/reference/enums/adts -next-page: /scala3/reference/contextual ---- - -The compiler expands enums and their cases to code that only uses -Scala's other language features. As such, enums in Scala are -convenient _syntactic sugar_, but they are not essential to understand -Scala's core. - -We now explain the expansion of enums in detail. First, -some terminology and notational conventions: - - - We use `E` as a name of an enum, and `C` as a name of a case that appears in `E`. - - We use `<...>` for syntactic constructs that in some circumstances might be empty. For instance, - `` represents one or more parameter lists `(...)` or nothing at all. - - - Enum cases fall into three categories: - - - _Class cases_ are those cases that are parameterized, either with a type parameter section `[...]` or with one or more (possibly empty) parameter sections `(...)`. - - _Simple cases_ are cases of a non-generic enum that have neither parameters nor an extends clause or body. That is, they consist of a name only. - - _Value cases_ are all cases that do not have a parameter section but that do have a (possibly generated) `extends` clause and/or a body. - - Simple cases and value cases are collectively called _singleton cases_. - -The desugaring rules imply that class cases are mapped to case classes, and singleton cases are mapped to `val` definitions. - -There are nine desugaring rules. Rule (1) desugars enum definitions. Rules -(2) and (3) desugar simple cases. Rules (4) to (6) define `extends` clauses for cases that -are missing them. Rules (7) to (9) define how such cases with `extends` clauses -map into `case class`es or `val`s. - -1. An `enum` definition - ```scala - enum E ... { } - ``` - expands to a `sealed abstract` class that extends the `scala.reflect.Enum` trait and - an associated companion object that contains the defined cases, expanded according - to rules (2 - 8). The enum class starts with a compiler-generated import that imports - the names `` of all cases so that they can be used without prefix in the class. - ```scala - sealed abstract class E ... extends with scala.reflect.Enum { - import E.{ } - - } - object E { } - ``` - -2. A simple case consisting of a comma-separated list of enum names - ```scala - case C_1, ..., C_n - ``` - expands to - ```scala - case C_1; ...; case C_n - ``` - Any modifiers or annotations on the original case extend to all expanded - cases. - -3. A simple case - ```scala - case C - ``` - of an enum `E` that does not take type parameters expands to - ```scala - val C = $new(n, "C") - ``` - Here, `$new` is a private method that creates an instance of `E` (see - below). - -4. If `E` is an enum with type parameters - ```scala - V1 T1 >: L1 <: U1 , ... , Vn Tn >: Ln <: Un (n > 0) - ``` - where each of the variances `Vi` is either `'+'` or `'-'`, then a simple case - ```scala - case C - ``` - expands to - ```scala - case C extends E[B1, ..., Bn] - ``` - where `Bi` is `Li` if `Vi = '+'` and `Ui` if `Vi = '-'`. This result is then further - rewritten with rule (8). Simple cases of enums with non-variant type - parameters are not permitted (however value cases with explicit `extends` clause are) - -5. A class case without an extends clause - ```scala - case C - ``` - of an enum `E` that does not take type parameters expands to - ```scala - case C extends E - ``` - This result is then further rewritten with rule (9). - -6. If `E` is an enum with type parameters `Ts`, a class case with neither type parameters nor an extends clause - ```scala - case C - ``` - expands to - ```scala - case C[Ts] extends E[Ts] - ``` - This result is then further rewritten with rule (9). For class cases that have type parameters themselves, an extends clause needs to be given explicitly. - -7. If `E` is an enum with type parameters `Ts`, a class case without type parameters but with an extends clause - ```scala - case C extends - ``` - expands to - ```scala - case C[Ts] extends - ``` - provided at least one of the parameters `Ts` is mentioned in a parameter type in - `` or in a type argument in ``. - -8. A value case - ```scala - case C extends - ``` - expands to a value definition in `E`'s companion object: - ```scala - val C = new { ; def ordinal = n } - ``` - where `n` is the ordinal number of the case in the companion object, - starting from 0. The anonymous class also - implements the abstract `Product` methods that it inherits from `Enum`. - - It is an error if a value case refers to a type parameter of the enclosing `enum` - in a type argument of ``. - -9. A class case - ```scala - case C extends - ``` - expands analogous to a final case class in `E`'s companion object: - ```scala - final case class C extends - ``` - The enum case defines an `ordinal` method of the form - ```scala - def ordinal = n - ``` - where `n` is the ordinal number of the case in the companion object, - starting from 0. - - It is an error if a value case refers to a type parameter of the enclosing `enum` - in a parameter type in `` or in a type argument of ``, unless that parameter is already - a type parameter of the case, i.e. the parameter name is defined in ``. - - The compiler-generated `apply` and `copy` methods of an enum case - ```scala - case C(ps) extends P1, ..., Pn - ``` - are treated specially. A call `C(ts)` of the apply method is ascribed the underlying type - `P1 & ... & Pn` (dropping any [transparent traits](../other-new-features/transparent-traits.html)) - as long as that type is still compatible with the expected type at the point of application. - A call `t.copy(ts)` of `C`'s `copy` method is treated in the same way. - -### Translation of Enums with Singleton Cases - -An enum `E` (possibly generic) that defines one or more singleton cases -will define the following additional synthetic members in its companion object (where `E'` denotes `E` with -any type parameters replaced by wildcards): - - - A method `valueOf(name: String): E'`. It returns the singleton case value whose identifier is `name`. - - A method `values` which returns an `Array[E']` of all singleton case - values defined by `E`, in the order of their definitions. - -If `E` contains at least one simple case, its companion object will define in addition: - - - A private method `$new` which defines a new simple case value with given - ordinal number and name. This method can be thought as being defined as - follows. - - ```scala - private def $new(_$ordinal: Int, $name: String) = - new E with runtime.EnumValue: - def ordinal = _$ordinal - override def productPrefix = $name // if not overridden in `E` - override def toString = $name // if not overridden in `E` - ``` - -The anonymous class also implements the abstract `Product` methods that it inherits from `Enum`. -The `ordinal` method is only generated if the enum does not extend from `java.lang.Enum` (as Scala enums do not extend -`java.lang.Enum`s unless explicitly specified). In case it does, there is no need to generate `ordinal` as -`java.lang.Enum` defines it. Similarly there is no need to override `toString` as that is defined in terms of `name` in -`java.lang.Enum`. Finally, `productPrefix` will call `this.name` when `E` extends `java.lang.Enum`. - -### Scopes for Enum Cases - -A case in an `enum` is treated similarly to a secondary constructor. It can access neither the enclosing `enum` using `this`, nor its value parameters or instance members using simple -identifiers. - -Even though translated enum cases are located in the enum's companion object, referencing -this object or its members via `this` or a simple identifier is also illegal. The compiler typechecks enum cases in the scope of the enclosing companion object but flags any such illegal accesses as errors. - -### Translation of Java-compatible enums - -A Java-compatible enum is an enum that extends `java.lang.Enum`. The translation rules are the same as above, with the reservations defined in this section. - -It is a compile-time error for a Java-compatible enum to have class cases. - -Cases such as `case C` expand to a `@static val` as opposed to a `val`. This allows them to be generated as static fields of the enum type, thus ensuring they are represented the same way as Java enums. - -### Other Rules - -- A normal case class which is not produced from an enum case is not allowed to extend - `scala.reflect.Enum`. This ensures that the only cases of an enum are the ones that are - explicitly declared in it. - -- If an enum case has an `extends` clause, the enum class must be one of the - classes that's extended. diff --git a/_scala3-reference/enums/enums.md b/_scala3-reference/enums/enums.md deleted file mode 100644 index 96d11e8742..0000000000 --- a/_scala3-reference/enums/enums.md +++ /dev/null @@ -1,196 +0,0 @@ ---- -title: "Enumerations" -type: section -num: 10 -previous-page: /scala3/reference/enums -next-page: /scala3/reference/enums/adts ---- - -An enumeration is used to define a type consisting of a set of named values. - -```scala -enum Color: - case Red, Green, Blue -``` - -This defines a new `sealed` class, `Color`, with three values, `Color.Red`, -`Color.Green`, `Color.Blue`. The color values are members of `Color`s -companion object. - -### Parameterized enums - -Enums can be parameterized. - -```scala -enum Color(val rgb: Int): - case Red extends Color(0xFF0000) - case Green extends Color(0x00FF00) - case Blue extends Color(0x0000FF) -``` - -As the example shows, you can define the parameter value by using an -explicit extends clause. - -### Methods defined for enums - -The values of an enum correspond to unique integers. The integer -associated with an enum value is returned by its `ordinal` method: - -```scala -scala> val red = Color.Red -val red: Color = Red -scala> red.ordinal -val res0: Int = 0 -``` - -The companion object of an enum also defines three utility methods. -The `valueOf` method obtains an enum value -by its name. The `values` method returns all enum values -defined in an enumeration in an `Array`. The `fromOrdinal` -method obtains an enum value from its ordinal (`Int`) value. - -```scala -scala> Color.valueOf("Blue") -val res0: Color = Blue -scala> Color.values -val res1: Array[Color] = Array(Red, Green, Blue) -scala> Color.fromOrdinal(0) -val res2: Color = Red -``` - -### User-defined members of enums - -It is possible to add your own definitions to an enum. Example: - -```scala -enum Planet(mass: Double, radius: Double): - private final val G = 6.67300E-11 - def surfaceGravity = G * mass / (radius * radius) - def surfaceWeight(otherMass: Double) = otherMass * surfaceGravity - - case Mercury extends Planet(3.303e+23, 2.4397e6) - case Venus extends Planet(4.869e+24, 6.0518e6) - case Earth extends Planet(5.976e+24, 6.37814e6) - case Mars extends Planet(6.421e+23, 3.3972e6) - case Jupiter extends Planet(1.9e+27, 7.1492e7) - case Saturn extends Planet(5.688e+26, 6.0268e7) - case Uranus extends Planet(8.686e+25, 2.5559e7) - case Neptune extends Planet(1.024e+26, 2.4746e7) -end Planet -``` - -It is also possible to define an explicit companion object for an enum: - -```scala -object Planet: - def main(args: Array[String]) = - val earthWeight = args(0).toDouble - val mass = earthWeight / Earth.surfaceGravity - for p <- values do - println(s"Your weight on $p is ${p.surfaceWeight(mass)}") -end Planet -``` - -### Deprecation of Enum Cases - -As a library author, you may want to signal that an enum case is no longer intended for use. However you could still want to gracefully handle the removal of a case from your public API, such as special casing deprecated cases. - -To illustrate, say that the `Planet` enum originally had an additional case: - -```diff - enum Planet(mass: Double, radius: Double): - ... - case Neptune extends Planet(1.024e+26, 2.4746e7) -+ case Pluto extends Planet(1.309e+22, 1.1883e3) - end Planet -``` - -We now want to deprecate the `Pluto` case. First we add the `scala.deprecated` annotation to `Pluto`: - -```diff - enum Planet(mass: Double, radius: Double): - ... - case Neptune extends Planet(1.024e+26, 2.4746e7) -- case Pluto extends Planet(1.309e+22, 1.1883e3) -+ -+ @deprecated("refer to IAU definition of planet") -+ case Pluto extends Planet(1.309e+22, 1.1883e3) - end Planet -``` - -Outside the lexical scopes of `enum Planet` or `object Planet`, references to `Planet.Pluto` will produce a deprecation warning, but within those scopes we can still reference it to implement introspection over the deprecated cases: - -```scala -trait Deprecations[T <: reflect.Enum] { - extension (t: T) def isDeprecatedCase: Boolean -} - -object Planet { - given Deprecations[Planet] with { - extension (p: Planet) - def isDeprecatedCase = p == Pluto - } -} -``` - -We could imagine that a library may use [type class derivation](../contextual/derivation.html) to automatically provide an instance for `Deprecations`. - -### Compatibility with Java Enums - -If you want to use the Scala-defined enums as [Java enums](https://docs.oracle.com/javase/tutorial/java/javaOO/enum.html), you can do so by extending -the class `java.lang.Enum`, which is imported by default, as follows: - -```scala -enum Color extends Enum[Color] { case Red, Green, Blue } -``` - -The type parameter comes from the Java enum [definition](https://docs.oracle.com/javase/8/docs/api/index.html?java/lang/Enum.html) and should be the same as the type of the enum. -There is no need to provide constructor arguments (as defined in the Java API docs) to `java.lang.Enum` when extending it – the compiler will generate them automatically. - -After defining `Color` like that, you can use it like you would a Java enum: - -```scala -scala> Color.Red.compareTo(Color.Green) -val res15: Int = -1 -``` - -For a more in-depth example of using Scala 3 enums from Java, see [this test](https://github.com/lampepfl/dotty/tree/master/tests/run/enum-java). In the test, the enums are defined in the `MainScala.scala` file and used from a Java source, `Test.java`. - -### Implementation - -Enums are represented as `sealed` classes that extend the `scala.reflect.Enum` trait. -This trait defines a single public method, `ordinal`: - -```scala -package scala.reflect - -/** A base trait of all Scala enum definitions */ -transparent trait Enum extends Any, Product, Serializable: - - /** A number uniquely identifying a case of an enum */ - def ordinal: Int -``` - -Enum values with `extends` clauses get expanded to anonymous class instances. -For instance, the `Venus` value above would be defined like this: - -```scala -val Venus: Planet = new Planet(4.869E24, 6051800.0): - def ordinal: Int = 1 - override def productPrefix: String = "Venus" - override def toString: String = "Venus" -``` - -Enum values without `extends` clauses all share a single implementation -that can be instantiated using a private method that takes a tag and a name as arguments. -For instance, the first -definition of value `Color.Red` above would expand to: - -```scala -val Red: Color = $new(0, "Red") -``` - -### Reference - -For more information, see [Issue #1970](https://github.com/lampepfl/dotty/issues/1970) and -[PR #4003](https://github.com/lampepfl/dotty/pull/4003). diff --git a/_scala3-reference/experimental/canthrow.md b/_scala3-reference/experimental/canthrow.md deleted file mode 100644 index f25a869467..0000000000 --- a/_scala3-reference/experimental/canthrow.md +++ /dev/null @@ -1,242 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: CanThrow Abilities -author: Martin Odersky ---- - -This page describes experimental support for exception checking in Scala 3. It is enabled by the language import -```scala -import language.experimental.saferExceptions -``` -The reason for publishing this extension now is to get feedback on its usability. We are working on more advanced type systems that build on the general ideas put forward in the extension. Those type systems have application areas beyond checked exceptions. Exception checking is a useful starting point since exceptions are familiar to all Scala programmers and their current treatment leaves room for improvement. - -## Why Exceptions? - -Exceptions are an ideal mechanism for error handling in many situations. They serve the intended purpose of propagating error conditions with a minimum of boilerplate. They cause zero overhead for the "happy path", which means they are very efficient as long as errors arise infrequently. Exceptions are also debug friendly, since they produce stack traces that can be inspected at the handler site. So one never has to guess where an erroneous condition originated. - -## Why Not Exceptions? - -However, exceptions in current Scala and many other languages are not reflected in the type system. This means that an essential part of the contract of a function - i.e. what exceptions can it produce? - is not statically checked. Most people acknowledge that this is a problem, but that so far the alternative of checked exceptions was just too painful to be considered. A good example are Java checked exceptions, which do the right thing in principle, but are widely regarded as a mistake since they are so difficult to deal with. So far, none of the successor languages that are modeled after Java or that build on the JVM has copied this feature. See for example Anders Hejlsberg's [statement on why C# does not have checked exceptions](https://www.artima.com/articles/the-trouble-with-checked-exceptions). - -## The Problem With Java's Checked Exceptions - -The main problem with Java's checked exception model is its inflexibility, which is due to lack of polymorphism. Consider for instance the `map` function which is declared on `List[A]` like this: -```scala - def map[B](f: A => B): List[B] -``` -In the Java model, function `f` is not allowed to throw a checked exception. So the following call would be invalid: -```scala - xs.map(x => if x < limit then x * x else throw LimitExceeded()) -``` -The only way around this would be to wrap the checked exception `LimitExceeded` in an unchecked `RuntimeException` that is caught at the callsite and unwrapped again. Something like this: -```scala - try - xs.map(x => if x < limit then x * x else throw Wrapper(LimitExceeded())) - catch case Wrapper(ex) => throw ex -``` -Ugh! No wonder checked exceptions in Java are not very popular. - -## Monadic Effects - -So the dilemma is that exceptions are easy to use only as long as we forgo static type checking. This has caused many people working with Scala to abandon exceptions altogether and to use an error monad like `Either` instead. This can work in many situations but is not without its downsides either. It makes code a lot more complicated and harder to refactor. It means one is quickly confronted with the problem how to work with several monads. In general, dealing with one monad at a time in Scala is straightforward but dealing with several monads together is much less pleasant since monads don't compose. A great number of techniques have been proposed, implemented, and promoted to deal with this, from monad transformers, to free monads, to tagless final. But none of these techniques is universally liked; each introduces a complicated DSL that's hard to understand for non-experts, introduces runtime overheads, and makes debugging difficult. In the end, quite a few developers prefer to work instead with a single "super-monad" like ZIO that has error propagation built in alongside other aspects. This one-size fits all approach can work very nicely, even though (or is it because?) it represents an all-encompassing framework. - -However, a programming language is not a framework; it has to cater also for those applications that do not fit the framework's use cases. So there's still a strong motivation for getting exception checking right. - -## From Effects To Abilities - -Why does `map` work so poorly with Java's checked exception model? It's because -`map`'s signature limits function arguments to not throw checked exceptions. We could try to come up with a more polymorphic formulation of `map`. For instance, it could look like this: -```scala - def map[B, E](f: A => B canThrow E): List[B] canThrow E -``` -This assumes a type `A canThrow E` to indicate computations of type `A` that can throw an exception of type `E`. But in practice the overhead of the additional type parameters makes this approach unappealing as well. Note in particular that we'd have to parameterize _every method_ that takes a function argument that way, so the added overhead of declaring all these exception types looks just like a sort of ceremony we would like to avoid. - -But there is a way to avoid the ceremony. Instead of concentrating on possible _effects_ such as "this code might throw an exception", concentrate on _capabilities_ such as "this code needs the capability to throw an exception". From a standpoint of expressiveness this is quite similar. But capabilities can be expressed as parameters whereas traditionally effects are expressed as some addition to result values. It turns out that this can make a big difference! - -Going to the root of the word _capability_, it means "being _able_ to do something", so the "cap" prefix is really just a filler. Following Conor McBride, we will use the name _ability_ from now on. - -## The CanThrow Ability - -In the _effects as abilities_ model, an effect is expressed as an (implicit) parameter of a certain type. For exceptions we would expect parameters of type -`CanThrow[E]` where `E` stands for the exception that can be thrown. Here is the definition of `CanThrow`: -```scala -erased class CanThrow[-E <: Exception] -``` -This shows another experimental Scala feature: [erased definitions]({% link _scala3-reference/experimental/erased-defs.md %}). Roughly speaking, values of an erased class do not generate runtime code; they are erased before code generation. This means that all `CanThrow` abilities are compile-time only artifacts; they do not have a runtime footprint. - -Now, if the compiler sees a `throw Exc()` construct where `Exc` is a checked exception, it will check that there is an ability of type `CanThrow[Exc]` that can be summoned as a given. It's a compile-time error if that's not the case. - -How can the ability be produced? There are several possibilities: - -Most often, the ability is produced by having a using clause `(using CanThrow[Exc])` in some enclosing scope. This roughly corresponds to a `throws` clause -in Java. The analogy is even stronger since alongside `CanThrow` there is also the following type alias defined in the `scala` package: -```scala -infix type canThrow[R, +E <: Exception] = CanThrow[E] ?=> R -``` -That is, `R canThrow E` is a context function type that takes an implicit `CanThrow[E]` parameter and that returns a value of type `R`. Therefore, a method written like this: -```scala -def m(x: T)(using CanThrow[E]): U -``` -can alternatively be expressed like this: -```scala -def m(x: T): U canThrow E -``` -_Aside_: If we rename `canThrow` to `throws` we would have a perfect analogy with Java but unfortunately `throws` is already taken in Scala 2.13. - -The `CanThrow`/`canThrow` combo essentially propagates the `CanThrow` requirement outwards. But where are these abilities created in the first place? That's in the `try` expression. Given a `try` like this: - -```scala -try - body -catch - case ex1: Ex1 => handler1 - ... - case exN: ExN => handlerN -``` -the compiler generates abilities for `CanThrow[Ex1]`, ..., `CanThrow[ExN]` that are in scope as givens in `body`. It does this by augmenting the `try` roughly as follows: -```scala -try - erased given CanThrow[Ex1] = ??? - ... - erased given CanThrow[ExN] = ??? - body -catch ... -``` -Note that the right-hand side of all givens is `???` (undefined). This is OK since -these givens are erased; they will not be executed at runtime. - -## An Example - -That's it. Let's see it in action in an example. First, add an import -```scala -import language.experimental.saferExceptions -``` -to enable exception checking. Now, define an exception `LimitExceeded` and -a function `f` like this: -```scala -val limit = 10e9 -class LimitExceeded extends Exception -def f(x: Double): Double = - if x < limit then x * x else throw LimitExceeded() -``` -You'll get this error message: -``` -9 | if x < limit then x * x else throw LimitExceeded() - | ^^^^^^^^^^^^^^^^^^^^^ - |The ability to throw exception LimitExceeded is missing. - |The ability can be provided by one of the following: - | - A using clause `(using CanThrow[LimitExceeded])` - | - A `canThrow` clause in a result type such as `X canThrow LimitExceeded` - | - an enclosing `try` that catches LimitExceeded - | - |The following import might fix the problem: - | - | import unsafeExceptions.canThrowAny -``` -As the error message implies, you have to declare that `f` needs the ability to throw a `LimitExceeded` exception. The most concise way to do so is to add a `canThrow` clause: -```scala -def f(x: Double): Double canThrow LimitExceeded = - if x < limit then x * x else throw LimitExceeded() -``` -Now put a call to `f` in a `try` that catches `LimitExceeded`: -```scala -@main def test(xs: Double*) = - try println(xs.map(f).sum) - catch case ex: LimitExceeded => println("too large") -``` -Run the program with some inputs: -``` -> scala test 1 2 3 -14.0 -> scala test -0.0 -> scala test 1 2 3 100000000000 -too large -``` -Everything typechecks and works as expected. But wait - we have called `map` without any ceremony! How did that work? Here's how the compiler expands the `test` function: -```scala -// compiler-generated code -@main def test(xs: Double*) = - try - erased given ctl: CanThrow[LimitExceeded] = ??? - println(xs.map(x => f(x)(using ctl)).sum) - catch case ex: LimitExceeded => println("too large") -``` -The `CanThrow[LimitExceeded]` ability is passed in a synthesized `using` clause to `f`, since `f` requires it. Then the resulting closure is passed to `map`. The signature of `map` does not have to account for effects. It takes a closure as always, but that -closure may refer to abilities in its free variables. This means that `map` is -already effect polymorphic even though we did not change its signature at all. -So the takeaway is that the effects as abilities model naturally provides for effect polymorphism whereas this is something that other approaches struggle with. - -## Gradual Typing Via Imports - -Another advantage is that the model allows a gradual migration from current unchecked exceptions to safer exceptions. Imagine for a moment that `experimental.saferExceptions` is turned on everywhere. There would be lots of code that breaks since functions have not yet been properly annotated with `canThrow`. But it's easy to create an escape hatch that lets us ignore the breakages for a while: simply add the import -```scala -import scala.unsafeExceptions.canThrowAny -``` -This will provide the `CanThrow` ability for any exception, and thereby allow -all throws and all other calls, no matter what the current state of `canThrow` declarations is. Here's the -definition of `canThrowAny`: -```scala -package scala -object unsafeExceptions: - given canThrowAny: CanThrow[Exception] = ??? -``` -Of course, defining a global ability like this amounts to cheating. But the cheating is useful for gradual typing. The import could be used to migrate existing code, or to -enable more fluid explorations of code without regard for complete exception safety. At the end of these migrations or explorations the import should be removed. - -## Scope Of the Extension - -To summarize, the extension for safer exception checking consists of the following elements: - - - It adds to the standard library the class `scala.CanThrow`, the type `scala.canThrow`, and the `scala.unsafeExceptions` object, as they were described above. - - It augments the type checking of `throw` by _demanding_ a `CanThrow` ability or the thrown exception. - - It augments the type checking of `try` by _providing_ `CanThrow` abilities for every caught exception. - -That's all. It's quite remarkable that one can do exception checking in this way without any special additions to the type system. We just need regular givens and context functions. Any runtime overhead is eliminated using `erased`. - -## Caveats - -Our ability model allows to declare and check the thrown exceptions of first-order code. But as it stands, it does not give us enough mechanism to enforce the _absence_ of -abilities for arguments to higher-order functions. Consider a variant `pureMap` -of `map` that should enforce that its argument does not throw exceptions or have any other effects (maybe because wants to reorder computations transparently). Right now -we cannot enforce that since the function argument to `pureMap` can capture arbitrary -abilities in its free variables without them showing up in its type. One possible way to -address this would be to introduce a pure function type (maybe written `A -> B`). Pure functions are not allowed to close over abilities. Then `pureMap` could be written -like this: -``` - def pureMap(f: A -> B): List[B] -``` -Another area where the lack of purity requirements shows up is when abilities escape from bounded scopes. Consider the following function -```scala -def escaped(xs: Double*): () => Int = - try () => xs.map(f).sum - catch case ex: LimitExceeded => -1 -``` -With the system presented here, this function typechecks, with expansion -```scala -// compiler-generated code -def escaped(xs: Double*): () => Int = - try - given ctl: CanThrow[LimitExceeded] = ??? - () => xs.map(x => f(x)(using ctl)).sum - catch case ex: LimitExceeded => -1 -``` -But if you try to call `escaped` like this -```scala -val g = escaped(1, 2, 1000000000) -g() -``` -the result will be a `LimitExceeded` exception thrown at the second line where `g` is called. What's missing is that `try` should enforce that the abilities it generates do not escape as free variables in the result of its body. It makes sense to describe such scoped effects as _ephemeral abilities_ - they have lifetimes that cannot be extended to delayed code in a lambda. - - -# Outlook - -We are working on a new class of type system that supports ephemeral abilities by tracking the free variables of values. Once that research matures, it will hopefully be possible to augment the language so that we can enforce the missing properties. - -And it would have many other applications besides: Exceptions are a special case of _algebraic effects_, which has been a very active research area over the last 20 years and is finding its way into programming languages (e.g. Koka, Eff, Multicore OCaml, Unison). In fact, algebraic effects have been characterized as being equivalent to exceptions with an additional _resume_ operation. The techniques developed here for exceptions can probably be generalized to other classes of algebraic effects. - -But even without these additional mechanisms, exception checking is already useful as it is. It gives a clear path forward to make code that uses exceptions safer, better documented, and easier to refactor. The only loophole arises for scoped abilities - here we have to verify manually that these abilities do not escape. Specifically, a `try` always has to be placed in the same computation stage as the throws that it enables. - -Put another way: If the status quo is 0% static checking since 100% is too painful, then an alternative that gives you 95% static checking with great ergonomics looks like a win. And we might still get to 100% in the future. - diff --git a/_scala3-reference/experimental/erased-defs-spec.md b/_scala3-reference/experimental/erased-defs-spec.md deleted file mode 100644 index 7905e4776f..0000000000 --- a/_scala3-reference/experimental/erased-defs-spec.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Erased Definitions: More Details" ---- - -TODO: complete -## Rules - -1. `erased` is a soft modifier. It can appear: - * At the start of a parameter block of a method, function or class - * In a method definition - * In a `val` definition (but not `lazy val` or `var`) - * In a `class` or `trait` definition - - ```scala - erased val x = ... - erased def f = ... - - def g(erased x: Int) = ... - - (erased x: Int) => ... - def h(x: (erased Int) => Int) = ... - - class K(erased x: Int) { ... } - erased class E {} - ``` - - -2. A reference to an `erased` val or def can only be used - * Inside the expression of argument to an `erased` parameter - * Inside the body of an `erased` `val` or `def` - - -3. Functions - * `(erased x1: T1, x2: T2, ..., xN: TN) => y : (erased T1, T2, ..., TN) => R` - * `(given erased x1: T1, x2: T2, ..., xN: TN) => y: (given erased T1, T2, ..., TN) => R` - * `(given erased T1) => R <:< erased T1 => R` - * `(given erased T1, T2) => R <:< (erased T1, T2) => R` - * ... - - Note that there is no subtype relation between `(erased T) => R` and `T => R` (or `(given erased T) => R` and `(given T) => R`) - - -4. Eta expansion - - if `def f(erased x: T): U` then `f: (erased T) => U`. - - -5. Erasure semantics - * All `erased` parameters are removed from the function - * All argument to `erased` parameters are not passed to the function - * All `erased` definitions are removed - * All `(erased T1, T2, ..., TN) => R` and `(given erased T1, T2, ..., TN) => R` become `() => R` - - -6. Overloading - - Method with `erased` parameters will follow the normal overloading constraints after erasure. - - -7. Overriding - * Member definitions overriding each other must both be `erased` or not be `erased` - * `def foo(x: T): U` cannot be overridden by `def foo(erased x: T): U` and vice-versa - diff --git a/_scala3-reference/experimental/erased-defs.md b/_scala3-reference/experimental/erased-defs.md deleted file mode 100644 index 07191a819c..0000000000 --- a/_scala3-reference/experimental/erased-defs.md +++ /dev/null @@ -1,229 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Erased Definitions" ---- - -`erased` is a modifier that expresses that some definition or expression is erased by the compiler instead of being represented in the compiled output. It is not yet part of the Scala language standard. To enable `erased`, turn on the language feature -`experimental.erasedDefinitions`. This can be done with a language import -```scala -import scala.language.experimental.erasedDefinitions -``` -or by setting the command line option `-language:experimental.erasedDefinitions`. -## Why erased terms? - -Let's describe the motivation behind erased terms with an example. In the -following we show a simple state machine which can be in a state `On` or `Off`. -The machine can change state from `Off` to `On` with `turnedOn` only if it is -currently `Off`. This last constraint is captured with the `IsOff[S]` contextual -evidence which only exists for `IsOff[Off]`. For example, not allowing calling -`turnedOn` on in an `On` state as we would require an evidence of type -`IsOff[On]` that will not be found. - -```scala -sealed trait State -final class On extends State -final class Off extends State - -@implicitNotFound("State must be Off") -class IsOff[S <: State] -object IsOff: - given isOff: IsOff[Off] = new IsOff[Off] - -class Machine[S <: State]: - def turnedOn(using IsOff[S]): Machine[On] = new Machine[On] - -val m = new Machine[Off] -m.turnedOn -m.turnedOn.turnedOn // ERROR -// ^ -// State must be Off -``` - -Note that in the code above the actual context arguments for `IsOff` are never -used at runtime; they serve only to establish the right constraints at compile -time. As these terms are never used at runtime there is not real need to have -them around, but they still need to be present in some form in the generated -code to be able to do separate compilation and retain binary compatibility. We -introduce _erased terms_ to overcome this limitation: we are able to enforce the -right constrains on terms at compile time. These terms have no run time -semantics and they are completely erased. - -## How to define erased terms? - -Parameters of methods and functions can be declared as erased, placing `erased` -in front of a parameter list (like `given`). - -```scala -def methodWithErasedEv(erased ev: Ev): Int = 42 - -val lambdaWithErasedEv: erased Ev => Int = - (erased ev: Ev) => 42 -``` - -`erased` parameters will not be usable for computations, though they can be used -as arguments to other `erased` parameters. - -```scala -def methodWithErasedInt1(erased i: Int): Int = - i + 42 // ERROR: can not use i - -def methodWithErasedInt2(erased i: Int): Int = - methodWithErasedInt1(i) // OK -``` - -Not only parameters can be marked as erased, `val` and `def` can also be marked -with `erased`. These will also only be usable as arguments to `erased` -parameters. - -```scala -erased val erasedEvidence: Ev = ... -methodWithErasedEv(erasedEvidence) -``` - -## What happens with erased values at runtime? - -As `erased` are guaranteed not to be used in computations, they can and will be -erased. - -```scala -// becomes def methodWithErasedEv(): Int at runtime -def methodWithErasedEv(erased ev: Ev): Int = ... - -def evidence1: Ev = ... -erased def erasedEvidence2: Ev = ... // does not exist at runtime -erased val erasedEvidence3: Ev = ... // does not exist at runtime - -// evidence1 is not evaluated and no value is passed to methodWithErasedEv -methodWithErasedEv(evidence1) -``` - -## State machine with erased evidence example - -The following example is an extended implementation of a simple state machine -which can be in a state `On` or `Off`. The machine can change state from `Off` -to `On` with `turnedOn` only if it is currently `Off`, conversely from `On` to -`Off` with `turnedOff` only if it is currently `On`. These last constraint are -captured with the `IsOff[S]` and `IsOn[S]` given evidence only exist for -`IsOff[Off]` and `IsOn[On]`. For example, not allowing calling `turnedOff` on in -an `Off` state as we would require an evidence `IsOn[Off]` that will not be -found. - -As the given evidences of `turnedOn` and `turnedOff` are not used in the -bodies of those functions we can mark them as `erased`. This will remove the -evidence parameters at runtime, but we would still evaluate the `isOn` and -`isOff` givens that were found as arguments. As `isOn` and `isOff` are not -used except as `erased` arguments, we can mark them as `erased`, hence removing -the evaluation of the `isOn` and `isOff` evidences. - -```scala -import scala.annotation.implicitNotFound - -sealed trait State -final class On extends State -final class Off extends State - -@implicitNotFound("State must be Off") -class IsOff[S <: State] -object IsOff: - // will not be called at runtime for turnedOn, the - // compiler will only require that this evidence exists - given IsOff[Off] = new IsOff[Off] - -@implicitNotFound("State must be On") -class IsOn[S <: State] -object IsOn: - // will not exist at runtime, the compiler will only - // require that this evidence exists at compile time - erased given IsOn[On] = new IsOn[On] - -class Machine[S <: State] private (): - // ev will disappear from both functions - def turnedOn(using erased ev: IsOff[S]): Machine[On] = new Machine[On] - def turnedOff(using erased ev: IsOn[S]): Machine[Off] = new Machine[Off] - -object Machine: - def newMachine(): Machine[Off] = new Machine[Off] - -@main def test = - val m = Machine.newMachine() - m.turnedOn - m.turnedOn.turnedOff - - // m.turnedOff - // ^ - // State must be On - - // m.turnedOn.turnedOn - // ^ - // State must be Off -``` - -Note that in [Inline](../metaprogramming/inline.html) we discussed `erasedValue` and inline -matches. `erasedValue` is implemented with `erased`, so the state machine above -can be encoded as follows: - -```scala -import scala.compiletime.* - -sealed trait State -final class On extends State -final class Off extends State - -class Machine[S <: State]: - transparent inline def turnOn(): Machine[On] = - inline erasedValue[S] match - case _: Off => new Machine[On] - case _: On => error("Turning on an already turned on machine") - - transparent inline def turnOff(): Machine[Off] = - inline erasedValue[S] match - case _: On => new Machine[Off] - case _: Off => error("Turning off an already turned off machine") - -object Machine: - def newMachine(): Machine[Off] = - println("newMachine") - new Machine[Off] -end Machine - -@main def test = - val m = Machine.newMachine() - m.turnOn() - m.turnOn().turnOff() - m.turnOn().turnOn() // error: Turning on an already turned on machine -``` - -## Erased Classes - -`erased` can also be used as a modifier for a class. An erased class is intended to be used only in erased definitions. If the type of a val definition or parameter is -a (possibly aliased, refined, or instantiated) erased class, the definition is assumed to be `erased` itself. Likewise, a method with an erased class return type is assumed to be `erased` itself. Since given instances expand to vals and defs, they are also assumed to be erased if the type they produce is an erased class. Finally -function types with erased classes as arguments turn into erased function types. - -Example: -```scala -erased class CanRead - -val x: CanRead = ... // `x` is turned into an erased val -val y: CanRead => Int = ... // the function is turned into an erased function -def f(x: CanRead) = ... // `f` takes an erased parameter -def g(): CanRead = ... // `g` is turned into an erased def -given CanRead = ... // the anonymous given is assumed to be erased -``` -The code above expands to -```scala -erased class CanRead - -erased val x: CanRead = ... -val y: (erased CanRead) => Int = ... -def f(erased x: CanRead) = ... -erased def g(): CanRead = ... -erased given CanRead = ... -``` -After erasure, it is checked that no references to values of erased classes remain and that no instances of erased classes are created. So the following would be an error: -```scala -val err: Any = CanRead() // error: illegal reference to erased class CanRead -``` -Here, the type of `err` is `Any`, so `err` is not considered erased. Yet its initializing value is a reference to the erased class `CanRead`. - -[More Details](./erased-defs-spec.html) diff --git a/_scala3-reference/features-classification.md b/_scala3-reference/features-classification.md deleted file mode 100644 index 528b2ffccd..0000000000 --- a/_scala3-reference/features-classification.md +++ /dev/null @@ -1,201 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "A Classification of Proposed Language Features" -date: April 6, 2019 -author: Martin Odersky ---- - -This document provides an overview of the constructs proposed for Scala 3 with the aim to facilitate the discussion what to include and when to include it. It classifies features into eight groups: (1) essential foundations, (2) simplifications, (3) restrictions, (4) dropped features, (5) changed features, (6) new features, (7) features oriented towards metaprogramming with the aim to replace existing macros, and (8) changes to type checking and inference. - -Each group contains sections classifying the status (i.e. relative importance to be a part of Scala 3, and relative urgency when to decide this) and the migration cost -of the constructs in it. - -The current document reflects the state of things as of April, 2019. It will be updated to reflect any future changes in that status. - -## Essential Foundations - -These new constructs directly model core features of [DOT](https://www.scala-lang.org/blog/2016/02/03/essence-of-scala.html), higher-kinded types, and the [SI calculus for implicit resolution](https://infoscience.epfl.ch/record/229878/files/simplicitly_1.pdf). - - - [Intersection types](new-types/intersection-types.html), replacing compound types, - - [Union types](new-types/union-types.html), - - [Type lambdas](new-types/type-lambdas.html), - replacing encodings using structural types and type projection. - - [Context functions](contextual/context-functions.html) offering abstraction over given parameters. - -**Status: essential** - -These are essential core features of Scala 3. Without them, Scala 3 would be a completely different language, with different foundations. - -**Migration cost: none to low** - -Since these are additions, there's generally no migration cost for old code. An exception are intersection types which replace compound types with slightly cleaned-up semantics. But few programs would be affected by this change. - -## Simplifications - -These constructs replace existing constructs with the aim of making the language safer and simpler to use, and to promote uniformity in code style. - - - [Trait parameters](other-new-features/trait-parameters.html) replace [early initializers](dropped-features/early-initializers.html) with a more generally useful construct. - - [Given instances](contextual/givens.html) - replace implicit objects and defs, focussing on intent over mechanism. - - [Using clauses](contextual/using-clauses.html) replace implicit parameters, avoiding their ambiguities. - - [Extension methods](contextual/extension-methods.html) replace implicit classes with a clearer and simpler mechanism. - - [Opaque type aliases](other-new-features/opaques.html) replace most uses - of value classes while guaranteeing absence of boxing. - - [Top-level definitions](dropped-features/package-objects.html) replace package objects, dropping syntactic boilerplate. - - [Export clauses](other-new-features/export.html) - provide a simple and general way to express aggregation, which can replace the - previous facade pattern of package objects inheriting from classes. - - [Vararg splices](changed-features/vararg-splices.html) now use the form `*` instead of `@ _*`, mirroring vararg expressions, - - [Creator applications](other-new-features/creator-applications.html) allow using simple function call syntax - instead of `new` expressions. `new` expressions stay around as a fallback for - the cases where creator applications cannot be used. - -With the exception of early initializers and old-style vararg splices, all superseded constructs continue to be available in Scala 3.0. The plan is to deprecate and phase them out later. - -Value classes (superseded by opaque type aliases) are a special case. There are currently no deprecation plans for value classes, since we might bring them back in a more general form if they are supported natively by the JVM as is planned by project Valhalla. - -**Status: bimodal: now or never / can delay** - -These are essential simplifications. If we decide to adopt them, we should do it for 3.0. Otherwise we are faced with the awkward situation that the Scala 3 documentation has to describe an old feature that will be replaced or superseded by a simpler one in the future. - -On the other hand, we need to decide now only about the new features in this list. The decision to drop the superseded features can be delayed. Of course, adopting a new feature without deciding to drop the superseded feature will make the language larger. - -**Migration cost: moderate** - -For the next several versions, old features will remain available and deprecation and rewrite techniques can make any migration effort low and gradual. - - -## Restrictions - -These constructs are restricted to make the language safer. - - - [Implicit Conversions](contextual/conversions.html): there is only one way to define implicit conversions instead of many, and potentially surprising implicit conversions require a language import. - - [Given Imports](contextual/given-imports.html): implicits now require a special form of import, to make the import clearly visible. - - [Type Projection](dropped-features/type-projection.html): only classes can be used as prefix `C` of a type projection `C#A`. Type projection on abstract types is no longer supported since it is unsound. - - [Multiversal equality](contextual/multiversal-equality.html) implements an "opt-in" scheme to rule out nonsensical comparisons with `==` and `!=`. - - [infix](https://github.com/lampepfl/dotty/pull/5975) - makes method application syntax uniform across code bases. - -Unrestricted implicit conversions continue to be available in Scala 3.0, but will be deprecated and removed later. Unrestricted versions of the other constructs in the list above are available only under `-source 3.0-migration`. - -**Status: now or never** - -These are essential restrictions. If we decide to adopt them, we should do it for 3.0. Otherwise we are faced with the awkward situation that the Scala 3 documentation has to describe a feature that will be restricted in the future. - -**Migration cost: low to high** - - - _low_: multiversal equality rules out code that is nonsensical, so any rewrites required by its adoption should be classified as bug fixes. - - _moderate_: Restrictions to implicits can be accommodated by straightforward rewriting. - - _high_: Unrestricted type projection cannot always rewritten directly since it is unsound in general. - -## Dropped Constructs - -These constructs are proposed to be dropped without a new construct replacing them. The motivation for dropping these constructs is to simplify the language and its implementation. - - - [DelayedInit](dropped-features/delayed-init.html), - - [Existential types](dropped-features/existential-types.html), - - [Procedure syntax](dropped-features/procedure-syntax.html), - - [Class shadowing](dropped-features/class-shadowing.html), - - [XML literals](dropped-features/xml.html), - - [Symbol literals](dropped-features/symlits.html), - - [Auto application](dropped-features/auto-apply.html), - - [Weak conformance](dropped-features/weak-conformance.html), - - [Compound types](new-types/intersection-types.html), - - [Auto tupling](https://github.com/lampepfl/dotty/pull/4311) (implemented, but not merged). - -The date when these constructs are dropped varies. The current status is: - - - Not implemented at all: - - DelayedInit, existential types, weak conformance. - - Supported under `-source 3.0-migration`: - - procedure syntax, class shadowing, symbol literals, auto application, auto tupling in a restricted form. - - Supported in 3.0, to be deprecated and phased out later: - - XML literals, compound types. - -**Status: mixed** - -Currently unimplemented features would require considerable implementation effort which would in most cases make the compiler more buggy and fragile and harder to understand. If we do not decide to drop them, they will probably show up as "not yet implemented" in the Scala 3.0 release. - -Currently implemented features could stay around indefinitely. Updated docs may simply ignore them, in the expectation that they might go away eventually. So the decision about their removal can be delayed. - -**Migration cost: moderate to high** - -Dropped features require rewrites to avoid their use in programs. These rewrites can sometimes be automatic (e.g. for procedure syntax, symbol literals, auto application) -and sometimes need to be manual (e.g. class shadowing, auto tupling). Sometimes the rewrites would have to be non-local, affecting use sites as well as definition sites (e.g., in the case of `DelayedInit`, unless we find a solution). - -## Changes - -These constructs have undergone changes to make them more regular and useful. - - - [Structural Types](changed-features/structural-types.html): They now allow pluggable implementations, which greatly increases their usefulness. Some usage patterns are restricted compared to the status quo. - - [Name-based pattern matching](changed-features/pattern-matching.html): The existing undocumented Scala 2 implementation has been codified in a slightly simplified form. - - [Eta expansion](changed-features/eta-expansion.html) is now performed universally also in the absence of an expected type. The postfix `_` operator is thus made redundant. It will be deprecated and dropped after Scala 3.0. - - [Implicit Resolution](changed-features/implicit-resolution.html): The implicit resolution rules have been cleaned up to make them more useful and less surprising. Implicit scope is restricted to no longer include package prefixes. - -Most aspects of old-style implicit resolution are still available under `-source 3.0-migration`. The other changes in this list are applied unconditionally. - -**Status: strongly advisable** - -The features have been implemented in their new form in Scala 3.0's compiler. They provide clear improvements in simplicity and functionality compared to the status quo. Going back would require significant implementation effort for a net loss of functionality. - -**Migration cost: low to high** - -Only a few programs should require changes, but some necessary changes might be non-local (as in the case of restrictions to implicit scope). - -## New Constructs - -These are additions to the language that make it more powerful or pleasant to use. - - - [Enums](enums/enums.html) provide concise syntax for enumerations and [algebraic data types](enums/adts.html). - - [Parameter untupling](other-new-features/parameter-untupling.html) avoids having to use `case` for tupled parameter destructuring. - - [Dependent function types](new-types/dependent-function-types.html) generalize dependent methods to dependent function values and types. - - [Polymorphic function types](https://github.com/lampepfl/dotty/pull/4672) generalize polymorphic methods to dependent function values and types. _Current status_: There is a proposal, and a prototype implementation, but the implementation has not been finalized or merged yet. - - [Kind polymorphism](other-new-features/kind-polymorphism.html) allows the definition of operators working equally on types and type constructors. - -**Status: mixed** - -Enums offer an essential simplification of fundamental use patterns, so they should be adopted for Scala 3.0. Auto-parameter tupling is a very small change that removes some awkwardness, so it might as well be adopted now. The other features constitute more specialized functionality which could be introduced in later versions. On the other hand, except for polymorphic function types they are all fully implemented, so if the Scala 3.0 spec does not include them, they might be still made available under a language flag. - -**Migration cost: none** - -Being new features, existing code migrates without changes. To be sure, sometimes it would be attractive to rewrite code to make use of the new features in order to increase clarity and conciseness. - -## Metaprogramming - -The following constructs together aim to put metaprogramming in Scala on a new basis. So far, metaprogramming was achieved by a combination of macros and libraries such as [Shapeless](https://github.com/milessabin/shapeless) that were in turn based on some key macros. Current Scala 2 macro mechanisms are a thin veneer on top the current Scala 2 compiler, which makes them fragile and in many cases impossible to port to Scala 3. - -It's worth noting that macros were never included in the [Scala 2 language specification](https://scala-lang.org/files/archive/spec/2.13/) and were so far made available only under an `-experimental` flag. This has not prevented their widespread usage. - -To enable porting most uses of macros, we are experimenting with the advanced language constructs listed below. These designs are more provisional than the rest of the proposed language constructs for Scala 3.0. There might still be some changes until the final release. Stabilizing the feature set needed for metaprogramming is our first priority. - -- [Match types](new-types/match-types.html) allow computation on types. -- [Inline](metaprogramming/inline.html) provides -by itself a straightforward implementation of some simple macros and is at the same time an essential building block for the implementation of complex macros. -- [Quotes and splices](metaprogramming/macros.html) provide a principled way to express macros and staging with a unified set of abstractions. -- [Type class derivation](contextual/derivation.html) provides an in-language implementation of the `Gen` macro in Shapeless and other foundational libraries. The new implementation is more robust, efficient and easier to use than the macro. -- [Implicit by-name parameters](contextual/by-name-context-parameters.html) provide a more robust in-language implementation of the `Lazy` macro in Shapeless. - -**Status: not yet settled** - -We know we need a practical replacement for current macros. The features listed above are very promising in that respect, but we need more complete implementations and more use cases to reach a final verdict. - -**Migration cost: very high** - -Existing macro libraries will have to be rewritten from the ground up. In many cases the rewritten libraries will turn out to be simpler and more robust than the old ones, but that does not relieve one of the cost of the rewrites. It's currently unclear to what degree users of macro libraries will be affected. We aim to provide sufficient functionality so that core macros can be re-implemented fully, but given the vast feature set of the various macro extensions to Scala 2 it is difficult to arrive at a workable limitation of scope. - -## Changes to Type Checking and Inference - -The Scala 3 compiler uses a new algorithm for type inference, which relies on a general subtype constraint solver. The new algorithm often [works better than the old](https://contributors.scala-lang.org/t/better-type-inference-for-scala-send-us-your-problematic-cases/2410), but there are inevitably situations where the results of both algorithms differ, leading to errors diagnosed by Scala 3 for programs that the Scala 2 compiler accepts. - -**Status: essential** - -The new type-checking and inference algorithms are the essential core of the new compiler. They cannot be reverted without dropping the whole implementation of Scala 3. - -**Migration cost: high** - -Some existing programs will break and, given the complex nature of type inference, it will not always be clear what change caused the breakage and how to fix it. - -In our experience, macros and changes in type and implicit argument inference together cause the large majority of problems encountered when porting existing code to Scala 3. The latter source of problems could be addressed systematically by a tool that added all inferred types and implicit arguments to a Scala 2 source code file. Most likely such a tool would be implemented as a [Scala 2 compiler plugin](https://docs.scala-lang.org/overviews/plugins/index.html). The resulting code would have a greatly increased likelihood to compile under Scala 3, but would often be bulky to the point of being unreadable. A second part of the rewriting tool should then selectively and iteratively remove type and implicit annotations that were synthesized by the first part as long as they compile under Scala 3. This second part could be implemented as a program that invokes the Scala 3 compiler `scalac` programmatically. - -Several people have proposed such a tool for some time now. I believe it is time we find the will and the resources to actually implement it. diff --git a/_scala3-reference/language-versions.md b/_scala3-reference/language-versions.md deleted file mode 100644 index 46636fb8d2..0000000000 --- a/_scala3-reference/language-versions.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Language Versions -type: chapter -num: 100 -previous-page: /scala3/reference/syntax -next-page: /scala3/reference/language-versions/source-compatibility ---- - -This chapter explains how different versions of the language interact with each other regarding their inputs and outputs. - -Additional information on interoperability and migration between Scala 2 and 3 can be found [here]({% link _overviews/scala3-migration/compatibility-intro.md %}). diff --git a/_scala3-reference/language-versions/binary-compatibility.md b/_scala3-reference/language-versions/binary-compatibility.md deleted file mode 100644 index 2d1eb6ee89..0000000000 --- a/_scala3-reference/language-versions/binary-compatibility.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Binary Compatibility -type: section -num: 102 -previous-page: /scala3/reference/language-versions/source-compatibility ---- - -In Scala 2, different minor versions of the compiler were free to change the way how they encoded different language features in JVM bytecode. So each bump of the compiler's minor version resulted in breaking the binary compatibility, and if a project had any Scala dependencies they all needed to be (cross-)compiled to the same minor Scala version that was used in that project itself. On the contrary, Scala 3 has a stable encoding into JVM bytecode. - -In addition to classfiles, the compilation process in Scala 3 also produces files with `.tasty` extension. [TASTy]({% link scala3/guides/tasty-overview.md %}) files represent fully elaborated Scala programs in the sense that they contain all the information that has been inferred by the compiler during the compilation (like contextual parameters and type parameters). Some of this information is lost during the generation of bytecode so Scala 3 compilers read TASTy files during compilation in addition to classfiles to know the exact types of values, methods, etc. in already compiled classes (although compilation from TASTy files only is also possible). TASTy files are also typically distributed together with classfiles in published artifacts. - -TASTy format is extensible but it preserves backward compatibility and the evolution happens between minor releases of the language. This means a Scala compiler in version `3.x1.y1` is able to read TASTy files produced by another compiler in version `3.x2.y2` if `x1 >= x2` (assuming two stable versions of the compiler are considered - `SNAPSHOT` or `NIGHTLY` compiler versions can read TASTy in an older stable format but their TASTY versions are not compatible between each other even if the compilers have the same minor version; also compilers in stable versions cannot read TASTy generated by an unstable version). - -TASTy version number has the format of `.-` and the numbering changes in parallel to language releases in such a way that a bump in language minor version corresponds to a bump in TASTy minor version (e.g. for Scala `3.0.0` the TASTy version is `28.0-0`). Experimental version set to 0 signifies a stable version while others are considered unstable/experimental. TASTy version is not strictly bound to the data format itself - any changes to the API of the standard library also require a change in TASTy minor version. - -Being able to bump the compiler version in a project without having to wait for all of its dependencies to do the same is already a big leap forward when compared to Scala 2. However, we might still try to do better, especially from the perspective of authors of libraries. -If you maintain a library and you would like it to be usable as a dependency for all Scala 3 projects, you would have to always emit TASTy in a version that would be readble by everyone, which would normally mean getting stuck at 3.0.x forever. - -To solve this problem a new experimental compiler flag `-Yscala-release ` (available since 3.1.2-RC1) has been added. Setting this flag makes the compiler produce TASTy files that should be possible to use by all Scala 3 compilers in version `` or newer (this flag was inspired by how `-release` works for specifying the target version of JDK). More specifically this enforces emitting TASTy files in an older format ensuring that: -* the code contains no references to parts of the standard library which were added to the API after `` and would crash at runtime when a program is executed with the older version of the standard library on the classpath -* no dependency found on the classpath during compilation (except for the standard library itself) contains TASTy files produced by a compiler newer than `` (otherwise they could potentially leak such disallowed references to the standard library). - -If any of the checks above is not fulfilled or for any other reason older TASTy cannot be emitted (e.g. the code uses some new language features which cannot be expressed the the older format) the entire compilation fails (with errors reported for each of such issues). - -As this feature is experimental it does not have any special support in build tools yet (at least not in sbt 1.6.1 or lower). -E.g. when a project gets compiled with Scala compiler `3.x1.y1` and `-Yscala-release 3.x2` option and then published using sbt -then the standard library in version `3.x1.y1` gets added to the project's dependencies instead of `3.x2.y2`. -When the dependencies are added to the classpath during compilation with Scala `3.x2.y2` the compiler will crash while trying to read TASTy files in the newer format. -A currently known workaround is to modify the build definition of the dependent project by explicitly overriding the version of Scala standard library in dependencies, e.g. - -```scala -dependencyOverrides ++= Seq( - scalaOrganization.value %% "scala3-library" % scalaVersion.value, - scalaOrganization.value %% "scala3-library_sjs1" % scalaVersion.value // for Scala.js projects -) -``` - -The behaviour of `-Yscala-release` flag might still change in the future, especially it's not guaranteed that every new version of the compiler would be able to generate TASTy in all older formats going back to the one produced by `3.0.x` compiler. diff --git a/_scala3-reference/language-versions/source-compatibility.md b/_scala3-reference/language-versions/source-compatibility.md deleted file mode 100644 index 6ae3cd5fb0..0000000000 --- a/_scala3-reference/language-versions/source-compatibility.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Source Compatibility -type: section -num: 101 -previous-page: /scala3/reference/language-versions -next-page: /scala3/reference/language-versions/binary-compatibility ---- - -Scala 3 does NOT guarantee source compatibility between different minor language versions (e.g. some syntax valid in 3.x might get deprecated and then phased out in 3.y for y > x). There are also some syntax structures that were valid in Scala 2 but are not anymore in Scala 3. However the compiler provides a possibility to specify the desired version of syntax used in a particular file or globally for a run of the compiler to make migration between versions easier. - -The default Scala language syntax version currently supported by the Dotty compiler is [`3.0`](https://scala-lang.org/api/3.x/scala/runtime/stdLibPatches/language$$3/0$.html). There are also other language versions that can be specified instead: - -- [`3.0-migration`](https://scala-lang.org/api/3.x/scala/runtime/stdLibPatches/language$$3/0-migration$.html): Same as `3.0` but with a Scala 2 compatibility mode that helps moving Scala 2.13 sources over to Scala 3. In particular, it - - - flags some Scala 2 constructs that are disallowed in Scala 3 as migration warnings instead of hard errors, - - changes some rules to be more lenient and backwards compatible with Scala 2.13 - - gives some additional warnings where the semantics has changed between Scala 2.13 and 3.0 - - in conjunction with `-rewrite`, offer code rewrites from Scala 2.13 to 3.0. - -- [`future`](https://scala-lang.org/api/3.x/scala/runtime/stdLibPatches/language$$future$.html): A preview of changes introduced in the next versions after 3.0. In the doc pages here we refer to the language version with these changes as `3.1`, but it might be that some of these changes will be rolled out in later `3.x` versions. - -Some Scala 2 specific idioms will be dropped in this version. The feature set supported by this version will be refined over time as we approach its release. - -- [`future-migration`](https://scala-lang.org/api/3.x/scala/runtime/stdLibPatches/language$$future-migration$.html): Same as `future` but with additional helpers to migrate from `3.0`. Similarly to the helpers available under `3.0-migration`, these include migration warnings and optional rewrites. - -There are two ways to specify a language version : - -- with a `-source` command line setting, e.g. `-source 3.0-migration`. -- with a `scala.language` import at the top of a source file, e.g: - -```scala -package p -import scala.language.`future-migration` - -class C { ... } -``` - -Language imports supersede command-line settings in the source files where they are specified. Only one language import specifying a source version is allowed in a source file, and it must come before any definitions in that file. diff --git a/_scala3-reference/metaprogramming.md b/_scala3-reference/metaprogramming.md deleted file mode 100644 index 18664703a0..0000000000 --- a/_scala3-reference/metaprogramming.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: "Metaprogramming" -type: chapter -num: 27 -previous-page: /scala3/reference/contextual/relationship-implicits -next-page: /scala3/reference/metaprogramming/inline ---- - -The following pages introduce the redesign of metaprogramming in Scala. They -introduce the following fundamental facilities: - -1. [`inline`](./metaprogramming/inline.html) is a new modifier that guarantees that - a definition will be inlined at the point of use. The primary motivation - behind inline is to reduce the overhead behind function calls and access to - values. The expansion will be performed by the Scala compiler during the - `Typer` compiler phase. As opposed to inlining in some other ecosystems, - inlining in Scala is not merely a request to the compiler but is a - _command_. The reason is that inlining in Scala can drive other compile-time - operations, like inline pattern matching (enabling type-level - programming), macros (enabling compile-time, generative, metaprogramming) and - runtime code generation (multi-stage programming). - -2. [Compile-time ops](./metaprogramming/compiletime-ops.html) are helper definitions in the - standard library that provide support for compile-time operations over values and types. - -3. [Macros](./metaprogramming/macros.html) are built on two well-known fundamental - operations: quotation and splicing. Quotation converts program code to - data, specifically, a (tree-like) representation of this code. It is - expressed as `'{...}` for expressions and as `'[...]` for types. Splicing, - expressed as `${ ... }`, goes the other way: it converts a program's representation - to program code. Together with `inline`, these two abstractions allow - to construct program code programmatically. - -4. [Runtime Staging](./metaprogramming/staging.html) Where macros construct code at _compile-time_, - staging lets programs construct new code at _runtime_. That way, - code generation can depend not only on static data but also on data available at runtime. This splits the evaluation of the program in two or more phases or ... - stages. Consequently, this method of generative programming is called "Multi-Stage Programming". Staging is built on the same foundations as macros. It uses - quotes and splices, but leaves out `inline`. - -5. [Reflection](./metaprogramming/reflection.html) Quotations are a "black-box" - representation of code. They can be parameterized and composed using - splices, but their structure cannot be analyzed from the outside. TASTy - reflection gives a way to analyze code structure by partly revealing the representation type of a piece of code in a standard API. The representation - type is a form of typed abstract syntax tree, which gives rise to the `TASTy` - moniker. - -6. [TASTy Inspection](./metaprogramming/tasty-inspect.html) Typed abstract syntax trees are serialized - in a custom compressed binary format stored in `.tasty` files. TASTy inspection allows - to load these files and analyze their content's tree structure. diff --git a/_scala3-reference/metaprogramming/compiletime-ops.md b/_scala3-reference/metaprogramming/compiletime-ops.md deleted file mode 100644 index 9bf0bc5379..0000000000 --- a/_scala3-reference/metaprogramming/compiletime-ops.md +++ /dev/null @@ -1,296 +0,0 @@ ---- -title: "Compile-time operations" -type: section -num: 29 -previous-page: /scala3/reference/metaprogramming/inline -next-page: /scala3/reference/metaprogramming/macros ---- - -## The `scala.compiletime` Package - -The [`scala.compiletime`](https://scala-lang.org/api/3.x/scala/compiletime.html) package contains helper definitions that provide support for compile-time operations over values. They are described in the following. - -### `constValue` and `constValueOpt` - -`constValue` is a function that produces the constant value represented by a -type. - -```scala -import scala.compiletime.constValue -import scala.compiletime.ops.int.S - -transparent inline def toIntC[N]: Int = - inline constValue[N] match - case 0 => 0 - case _: S[n1] => 1 + toIntC[n1] - -inline val ctwo = toIntC[2] -``` - -`constValueOpt` is the same as `constValue`, however returning an `Option[T]` -enabling us to handle situations where a value is not present. Note that `S` is -the type of the successor of some singleton type. For example the type `S[1]` is -the singleton type `2`. - -### `erasedValue` - -So far we have seen inline methods that take terms (tuples and integers) as -parameters. What if we want to base case distinctions on types instead? For -instance, one would like to be able to write a function `defaultValue`, that, -given a type `T`, returns optionally the default value of `T`, if it exists. -We can already express this using rewrite match expressions and a simple -helper function, `scala.compiletime.erasedValue`, which is defined as follows: - -```scala -def erasedValue[T]: T -``` - -The `erasedValue` function _pretends_ to return a value of its type argument `T`. -Calling this function will always result in a compile-time error unless the call -is removed from the code while inlining. - -Using `erasedValue`, we can then define `defaultValue` as follows: - -```scala -import scala.compiletime.erasedValue - -transparent inline def defaultValue[T] = - inline erasedValue[T] match - case _: Byte => Some(0: Byte) - case _: Char => Some(0: Char) - case _: Short => Some(0: Short) - case _: Int => Some(0) - case _: Long => Some(0L) - case _: Float => Some(0.0f) - case _: Double => Some(0.0d) - case _: Boolean => Some(false) - case _: Unit => Some(()) - case _ => None -``` - -Then: - -```scala -val dInt: Some[Int] = defaultValue[Int] -val dDouble: Some[Double] = defaultValue[Double] -val dBoolean: Some[Boolean] = defaultValue[Boolean] -val dAny: None.type = defaultValue[Any] -``` - -As another example, consider the type-level version of `toInt` below: -given a _type_ representing a Peano number, -return the integer _value_ corresponding to it. -Consider the definitions of numbers as in the _Inline -Match_ section above. Here is how `toIntT` can be defined: - -```scala -transparent inline def toIntT[N <: Nat]: Int = - inline scala.compiletime.erasedValue[N] match - case _: Zero.type => 0 - case _: Succ[n] => toIntT[n] + 1 - -inline val two = toIntT[Succ[Succ[Zero.type]]] -``` - -`erasedValue` is an `erased` method so it cannot be used and has no runtime -behavior. Since `toIntT` performs static checks over the static type of `N` we -can safely use it to scrutinize its return type (`S[S[Z]]` in this case). - -### `error` - -The `error` method is used to produce user-defined compile errors during inline expansion. -It has the following signature: - -```scala -inline def error(inline msg: String): Nothing -``` - -If an inline expansion results in a call `error(msgStr)` the compiler -produces an error message containing the given `msgStr`. - -```scala -import scala.compiletime.{error, code} - -inline def fail() = - error("failed for a reason") - -fail() // error: failed for a reason -``` - -or - -```scala -inline def fail(p1: => Any) = - error(code"failed on: $p1") - -fail(identity("foo")) // error: failed on: identity("foo") -``` - -### The `scala.compiletime.ops` package - -The [`scala.compiletime.ops`](https://scala-lang.org/api/3.x/scala/compiletime/ops.html) package contains types that provide support for -primitive operations on singleton types. For example, -`scala.compiletime.ops.int.*` provides support for multiplying two singleton -`Int` types, and `scala.compiletime.ops.boolean.&&` for the conjunction of two -`Boolean` types. When all arguments to a type in `scala.compiletime.ops` are -singleton types, the compiler can evaluate the result of the operation. - -```scala -import scala.compiletime.ops.int.* -import scala.compiletime.ops.boolean.* - -val conjunction: true && true = true -val multiplication: 3 * 5 = 15 -``` - -Many of these singleton operation types are meant to be used infix (as in [SLS §3.2.10](https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#infix-types)). - -Since type aliases have the same precedence rules as their term-level -equivalents, the operations compose with the expected precedence rules: - -```scala -import scala.compiletime.ops.int.* -val x: 1 + 2 * 3 = 7 -``` - -The operation types are located in packages named after the type of the -left-hand side parameter: for instance, `scala.compiletime.ops.int.+` represents -addition of two numbers, while `scala.compiletime.ops.string.+` represents string -concatenation. To use both and distinguish the two types from each other, a -match type can dispatch to the correct implementation: - -```scala -import scala.compiletime.ops.* - -import scala.annotation.infix - -type +[X <: Int | String, Y <: Int | String] = (X, Y) match - case (Int, Int) => int.+[X, Y] - case (String, String) => string.+[X, Y] - -val concat: "a" + "b" = "ab" -val addition: 1 + 1 = 2 -``` - -## Summoning Implicits Selectively - -It is foreseen that many areas of typelevel programming can be done with rewrite -methods instead of implicits. But sometimes implicits are unavoidable. The -problem so far was that the Prolog-like programming style of implicit search -becomes viral: Once some construct depends on implicit search it has to be -written as a logic program itself. Consider for instance the problem of creating -a `TreeSet[T]` or a `HashSet[T]` depending on whether `T` has an `Ordering` or -not. We can create a set of implicit definitions like this: - -```scala -trait SetFor[T, S <: Set[T]] - -class LowPriority: - implicit def hashSetFor[T]: SetFor[T, HashSet[T]] = ... - -object SetsFor extends LowPriority: - implicit def treeSetFor[T: Ordering]: SetFor[T, TreeSet[T]] = ... -``` - -Clearly, this is not pretty. Besides all the usual indirection of implicit -search, we face the problem of rule prioritization where we have to ensure that -`treeSetFor` takes priority over `hashSetFor` if the element type has an -ordering. This is solved (clumsily) by putting `hashSetFor` in a superclass -`LowPriority` of the object `SetsFor` where `treeSetFor` is defined. Maybe the -boilerplate would still be acceptable if the crufty code could be contained. -However, this is not the case. Every user of the abstraction has to be -parameterized itself with a `SetFor` implicit. Considering the simple task _"I -want a `TreeSet[T]` if `T` has an ordering and a `HashSet[T]` otherwise"_, this -seems like a lot of ceremony. - -There are some proposals to improve the situation in specific areas, for -instance by allowing more elaborate schemes to specify priorities. But they all -keep the viral nature of implicit search programs based on logic programming. - -By contrast, the new `summonFrom` construct makes implicit search available -in a functional context. To solve the problem of creating the right set, one -would use it as follows: - -```scala -import scala.compiletime.summonFrom - -inline def setFor[T]: Set[T] = summonFrom { - case ord: Ordering[T] => new TreeSet[T]()(using ord) - case _ => new HashSet[T] -} -``` - -A `summonFrom` call takes a pattern matching closure as argument. All patterns -in the closure are type ascriptions of the form `identifier : Type`. - -Patterns are tried in sequence. The first case with a pattern `x: T` such that an implicit value of type `T` can be summoned is chosen. - -Alternatively, one can also use a pattern-bound given instance, which avoids the explicit using clause. For instance, `setFor` could also be formulated as follows: - -```scala -import scala.compiletime.summonFrom - -inline def setFor[T]: Set[T] = summonFrom { - case given Ordering[T] => new TreeSet[T] - case _ => new HashSet[T] -} -``` - -`summonFrom` applications must be reduced at compile time. - -Consequently, if we summon an `Ordering[String]` the code above will return a -new instance of `TreeSet[String]`. - -```scala -summon[Ordering[String]] - -println(setFor[String].getClass) // prints class scala.collection.immutable.TreeSet -``` - -**Note** `summonFrom` applications can raise ambiguity errors. Consider the following -code with two givens in scope of type `A`. The pattern match in `f` will raise -an ambiguity error of `f` is applied. - -```scala -class A -given a1: A = new A -given a2: A = new A - -inline def f: Any = summonFrom { - case given _: A => ??? // error: ambiguous givens -} -``` - -## `summonInline` - -The shorthand `summonInline` provides a simple way to write a `summon` that is delayed until the call is inlined. -Unlike `summonFrom`, `summonInline` also yields the implicit-not-found error, if a given instance of the summoned -type is not found. -```scala -import scala.compiletime.summonInline -import scala.annotation.implicitNotFound - -@implicitNotFound("Missing One") -trait Missing1 - -@implicitNotFound("Missing Two") -trait Missing2 - -trait NotMissing -given NotMissing = ??? - -transparent inline def summonInlineCheck[T <: Int](inline t : T) : Any = - inline t match - case 1 => summonInline[Missing1] - case 2 => summonInline[Missing2] - case _ => summonInline[NotMissing] - -val missing1 = summonInlineCheck(1) // error: Missing One -val missing2 = summonInlineCheck(2) // error: Missing Two -val notMissing : NotMissing = summonInlineCheck(3) -``` - -## Reference - -For more information about compile-time operations, see [PR #4768](https://github.com/lampepfl/dotty/pull/4768), -which explains how `summonFrom`'s predecessor (implicit matches) can be used for typelevel programming and code specialization and [PR #7201](https://github.com/lampepfl/dotty/pull/7201) which explains the new `summonFrom` syntax. diff --git a/_scala3-reference/metaprogramming/inline.md b/_scala3-reference/metaprogramming/inline.md deleted file mode 100644 index 2e55b8e63c..0000000000 --- a/_scala3-reference/metaprogramming/inline.md +++ /dev/null @@ -1,380 +0,0 @@ ---- -title: Inline -type: section -num: 28 -previous-page: /scala3/reference/metaprogramming -next-page: /scala3/reference/metaprogramming/compiletime-ops ---- - -## Inline Definitions - -`inline` is a new [soft modifier](../soft-modifier.html) that guarantees that a -definition will be inlined at the point of use. Example: - -```scala -object Config: - inline val logging = false - -object Logger: - - private var indent = 0 - - inline def log[T](msg: String, indentMargin: =>Int)(op: => T): T = - if Config.logging then - println(s"${" " * indent}start $msg") - indent += indentMargin - val result = op - indent -= indentMargin - println(s"${" " * indent}$msg = $result") - result - else op -end Logger -``` - -The `Config` object contains a definition of the **inline value** `logging`. -This means that `logging` is treated as a _constant value_, equivalent to its -right-hand side `false`. The right-hand side of such an `inline val` must itself -be a [constant expression](https://scala-lang.org/files/archive/spec/2.13/06-expressions.html#constant-expressions). -Used in this way, `inline` is equivalent to Java and Scala 2's `final`. Note that `final`, meaning -_inlined constant_, is still supported in Scala 3, but will be phased out. - -The `Logger` object contains a definition of the **inline method** `log`. This -method will always be inlined at the point of call. - -In the inlined code, an `if-then-else` with a constant condition will be rewritten -to its `then`- or `else`-part. Consequently, in the `log` method above the -`if Config.logging` with `Config.logging == true` will get rewritten into its -`then`-part. - -Here's an example: - -```scala -var indentSetting = 2 - -def factorial(n: BigInt): BigInt = - log(s"factorial($n)", indentSetting) { - if n == 0 then 1 - else n * factorial(n - 1) - } -``` - -If `Config.logging == false`, this will be rewritten (simplified) to: - -```scala -def factorial(n: BigInt): BigInt = - if n == 0 then 1 - else n * factorial(n - 1) -``` - -As you notice, since neither `msg` or `indentMargin` were used, they do not -appear in the generated code for `factorial`. Also note the body of our `log` -method: the `else-` part reduces to just an `op`. In the generated code we do -not generate any closures because we only refer to a by-name parameter *once*. -Consequently, the code was inlined directly and the call was beta-reduced. - -In the `true` case the code will be rewritten to: - -```scala -def factorial(n: BigInt): BigInt = - val msg = s"factorial($n)" - println(s"${" " * indent}start $msg") - Logger.inline$indent_=(indent.+(indentSetting)) - val result = - if n == 0 then 1 - else n * factorial(n - 1) - Logger.inline$indent_=(indent.-(indentSetting)) - println(s"${" " * indent}$msg = $result") - result -``` - -Note that the by-value parameter `msg` is evaluated only once, per the usual Scala -semantics, by binding the value and reusing the `msg` through the body of -`factorial`. Also, note the special handling of the assignment to the private var -`indent`. It is achieved by generating a setter method `def inline$indent_=` and calling it instead. - -### Recursive Inline Methods - -Inline methods can be recursive. For instance, when called with a constant -exponent `n`, the following method for `power` will be implemented by -straight inline code without any loop or recursion. - -```scala -inline def power(x: Double, n: Int): Double = - if n == 0 then 1.0 - else if n == 1 then x - else - val y = power(x, n / 2) - if n % 2 == 0 then y * y else y * y * x - -power(expr, 10) -// translates to -// -// val x = expr -// val y1 = x * x // ^2 -// val y2 = y1 * y1 // ^4 -// val y3 = y2 * x // ^5 -// y3 * y3 // ^10 -``` - -Parameters of inline methods can have an `inline` modifier as well. This means -that actual arguments to these parameters will be inlined in the body of the -`inline def`. `inline` parameters have call semantics equivalent to by-name parameters -but allow for duplication of the code in the argument. It is usually useful when constant -values need to be propagated to allow further optimizations/reductions. - -The following example shows the difference in translation between by-value, by-name and `inline` -parameters: - -```scala -inline def funkyAssertEquals(actual: Double, expected: =>Double, inline delta: Double): Unit = - if (actual - expected).abs > delta then - throw new AssertionError(s"difference between ${expected} and ${actual} was larger than ${delta}") - -funkyAssertEquals(computeActual(), computeExpected(), computeDelta()) -// translates to -// -// val actual = computeActual() -// def expected = computeExpected() -// if (actual - expected).abs > computeDelta() then -// throw new AssertionError(s"difference between ${expected} and ${actual} was larger than ${computeDelta()}") -``` - -### Rules for Overriding - -Inline methods can override other non-inline methods. The rules are as follows: - -1. If an inline method `f` implements or overrides another, non-inline method, the inline method can also be invoked at runtime. For instance, consider the scenario: - - ```scala - abstract class A: - def f: Int - def g: Int = f - - class B extends A: - inline def f = 22 - override inline def g = f + 11 - - val b = new B - val a: A = b - // inlined invocatons - assert(b.f == 22) - assert(b.g == 33) - // dynamic invocations - assert(a.f == 22) - assert(a.g == 33) - ``` - - The inlined invocations and the dynamically dispatched invocations give the same results. - -2. Inline methods are effectively final. - -3. Inline methods can also be abstract. An abstract inline method can be implemented only by other inline methods. It cannot be invoked directly: - - ```scala - abstract class A: - inline def f: Int - - object B extends A: - inline def f: Int = 22 - - B.f // OK - val a: A = B - a.f // error: cannot inline f in A. - ``` - -### Relationship to `@inline` - -Scala 2 also defines a `@inline` annotation which is used as a hint for the -backend to inline code. The `inline` modifier is a more powerful option: - -- expansion is guaranteed instead of best effort, -- expansion happens in the frontend instead of in the backend and -- expansion also applies to recursive methods. - - - -#### The definition of constant expression - -Right-hand sides of inline values and of arguments for inline parameters must be -constant expressions in the sense defined by the [SLS §6.24](https://www.scala-lang.org/files/archive/spec/2.13/06-expressions.html#constant-expressions), -including _platform-specific_ extensions such as constant folding of pure -numeric computations. - -An inline value must have a literal type such as `1` or `true`. - -```scala -inline val four = 4 -// equivalent to -inline val four: 4 = 4 -``` - -It is also possible to have inline vals of types that do not have a syntax, such as `Short(4)`. - -```scala -trait InlineConstants: - inline val myShort: Short - -object Constants extends InlineConstants: - inline val myShort/*: Short(4)*/ = 4 -``` - -## Transparent Inline Methods - -Inline methods can additionally be declared `transparent`. -This means that the return type of the inline method can be -specialized to a more precise type upon expansion. Example: - -```scala -class A -class B extends A: - def m = true - -transparent inline def choose(b: Boolean): A = - if b then new A else new B - -val obj1 = choose(true) // static type is A -val obj2 = choose(false) // static type is B - -// obj1.m // compile-time error: `m` is not defined on `A` -obj2.m // OK -``` - -Here, the inline method `choose` returns an instance of either of the two types `A` or `B`. -If `choose` had not been declared to be `transparent`, the result -of its expansion would always be of type `A`, even though the computed value might be of the subtype `B`. -The inline method is a "blackbox" in the sense that details of its implementation do not leak out. -But if a `transparent` modifier is given, the expansion is the type of the expanded body. If the argument `b` -is `true`, that type is `A`, otherwise it is `B`. Consequently, calling `m` on `obj2` -type-checks since `obj2` has the same type as the expansion of `choose(false)`, which is `B`. -Transparent inline methods are "whitebox" in the sense that the type -of an application of such a method can be more specialized than its declared -return type, depending on how the method expands. - -In the following example, we see how the return type of `zero` is specialized to -the singleton type `0` permitting the addition to be ascribed with the correct -type `1`. - -```scala -transparent inline def zero: Int = 0 - -val one: 1 = zero + 1 -``` - -### Transparent vs. non-transparent inline - -As we already discussed, transparent inline methods may influence type checking at call site. -Technically this implies that transparent inline methods must be expanded during type checking of the program. -Other inline methods are inlined later after the program is fully typed. - -For example, the following two functions will be typed the same way but will be inlined at different times. - -```scala -inline def f1: T = ... -transparent inline def f2: T = (...): T -``` - -A noteworthy difference is the behavior of `transparent inline given`. -If there is an error reported when inlining that definition, it will be considered as an implicit search mismatch and the search will continue. -A `transparent inline given` can add a type ascription in its RHS (as in `f2` from the previous example) to avoid the precise type but keep the search behavior. -On the other hand, an `inline given` is taken as an implicit and then inlined after typing. -Any error will be emitted as usual. - -## Inline Conditionals - -An if-then-else expression whose condition is a constant expression can be simplified to -the selected branch. Prefixing an if-then-else expression with `inline` enforces that -the condition has to be a constant expression, and thus guarantees that the conditional will always -simplify. - -Example: - -```scala -inline def update(delta: Int) = - inline if delta >= 0 then increaseBy(delta) - else decreaseBy(-delta) -``` - -A call `update(22)` would rewrite to `increaseBy(22)`. But if `update` was called with -a value that was not a compile-time constant, we would get a compile time error like the one -below: - -```scala - | inline if delta >= 0 then ??? - | ^ - | cannot reduce inline if - | its condition - | delta >= 0 - | is not a constant value - | This location is in code that was inlined at ... -``` - -In a transparent inline, an `inline if` will force the inlining of any inline definition in its condition during type checking. - -## Inline Matches - -A `match` expression in the body of an `inline` method definition may be -prefixed by the `inline` modifier. If there is enough static information to -unambiguously take a branch, the expression is reduced to that branch and the -type of the result is taken. If not, a compile-time error is raised that -reports that the match cannot be reduced. - -The example below defines an inline method with a -single inline match expression that picks a case based on its static type: - -```scala -transparent inline def g(x: Any): Any = - inline x match - case x: String => (x, x) // Tuple2[String, String](x, x) - case x: Double => x - -g(1.0d) // Has type 1.0d which is a subtype of Double -g("test") // Has type (String, String) -``` - -The scrutinee `x` is examined statically and the inline match is reduced -accordingly returning the corresponding value (with the type specialized because `g` is declared `transparent`). This example performs a simple type test over the -scrutinee. The type can have a richer structure like the simple ADT below. -`toInt` matches the structure of a number in [Church-encoding](https://en.wikipedia.org/wiki/Church_encoding) -and _computes_ the corresponding integer. - -```scala -trait Nat -case object Zero extends Nat -case class Succ[N <: Nat](n: N) extends Nat - -transparent inline def toInt(n: Nat): Int = - inline n match - case Zero => 0 - case Succ(n1) => toInt(n1) + 1 - -inline val natTwo = toInt(Succ(Succ(Zero))) -val intTwo: 2 = natTwo -``` - -`natTwo` is inferred to have the singleton type 2. - -### Reference - -For more information about the semantics of `inline`, see the [Scala 2020: Semantics-preserving inlining for metaprogramming](https://dl.acm.org/doi/10.1145/3426426.3428486) paper. diff --git a/_scala3-reference/metaprogramming/macros-spec.md b/_scala3-reference/metaprogramming/macros-spec.md deleted file mode 100644 index aa819c5ecb..0000000000 --- a/_scala3-reference/metaprogramming/macros-spec.md +++ /dev/null @@ -1,254 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Macros Spec" ---- - -## Implementation - -### Syntax - -Compared to the [Scala 3 reference grammar](../syntax.html) -there are the following syntax changes: -``` -SimpleExpr ::= ... - | ‘'’ ‘{’ Block ‘}’ - | ‘'’ ‘[’ Type ‘]’ - | ‘$’ ‘{’ Block ‘}’ -SimpleType ::= ... - | ‘$’ ‘{’ Block ‘}’ -``` -In addition, an identifier `$x` starting with a `$` that appears inside -a quoted expression or type is treated as a splice `${x}` and a quoted identifier -`'x` that appears inside a splice is treated as a quote `'{x}` - -### Implementation in `scalac` - -Quotes and splices are primitive forms in the generated abstract syntax trees. -Top-level splices are eliminated during macro expansion while typing. On the -other hand, top-level quotes are eliminated in an expansion phase `PickleQuotes` -phase (after typing and pickling). PCP checking occurs while preparing the RHS -of an inline method for top-level splices and in the `Staging` phase (after -typing and before pickling). - -Macro-expansion works outside-in. If the outermost scope is a splice, -the spliced AST will be evaluated in an interpreter. A call to a -previously compiled method can be implemented as a reflective call to -that method. With the restrictions on splices that are currently in -place that’s all that’s needed. We might allow more interpretation in -splices in the future, which would allow us to loosen the -restriction. Quotes in spliced, interpreted code are kept as they -are, after splices nested in the quotes are expanded. - -If the outermost scope is a quote, we need to generate code that -constructs the quoted tree at run-time. We implement this by -serializing the tree as a TASTy structure, which is stored -in a string literal. At runtime, an unpickler method is called to -deserialize the string into a tree. - -Splices inside quoted code insert the spliced tree as is, after -expanding any quotes in the spliced code recursively. - -## Formalization - -The phase consistency principle can be formalized in a calculus that -extends simply-typed lambda calculus with quotes and splices. - -### Syntax - -The syntax of terms, values, and types is given as follows: -``` -Terms t ::= x variable - (x: T) => t lambda - t t application - 't quote - $t splice - -Values v ::= (x: T) => t lambda - 'u quote - -Simple terms u ::= x | (x: T) => u | u u | 't - -Types T ::= A base type - T -> T function type - expr T quoted -``` -Typing rules are formulated using a stack of environments -`Es`. Individual environments `E` consist as usual of variable -bindings `x: T`. Environments can be combined using the two -combinators `'` and `$`. -``` -Environment E ::= () empty - E, x: T - -Env. stack Es ::= () empty - E simple - Es * Es combined - -Separator * ::= ' - $ -``` -The two environment combinators are both associative with left and -right identity `()`. - -### Operational semantics - -We define a small step reduction relation `-->` with the following rules: -``` - ((x: T) => t) v --> [x := v]t - - ${'u} --> u - - t1 --> t2 - ----------------- - e[t1] --> e[t2] -``` -The first rule is standard call-by-value beta-reduction. The second -rule says that splice and quotes cancel each other out. The third rule -is a context rule; it says that reduction is allowed in the hole `[ ]` -position of an evaluation context. Evaluation contexts `e` and -splice evaluation context `e_s` are defined syntactically as follows: -``` -Eval context e ::= [ ] | e t | v e | 'e_s[${e}] -Splice context e_s ::= [ ] | (x: T) => e_s | e_s t | u e_s -``` - -### Typing rules - -Typing judgments are of the form `Es |- t: T`. There are two -substructural rules which express the fact that quotes and splices -cancel each other out: -``` - Es1 * Es2 |- t: T - --------------------------- - Es1 $ E1 ' E2 * Es2 |- t: T - - - Es1 * Es2 |- t: T - --------------------------- - Es1 ' E1 $ E2 * Es2 |- t: T -``` -The lambda calculus fragment of the rules is standard, except that we -use a stack of environments. The rules only interact with the topmost -environment of the stack. -``` - x: T in E - -------------- - Es * E |- x: T - - - Es * E, x: T1 |- t: T2 - ------------------------------- - Es * E |- (x: T1) => t: T -> T2 - - - Es |- t1: T2 -> T Es |- t2: T2 - --------------------------------- - Es |- t1 t2: T -``` -The rules for quotes and splices map between `expr T` and `T` by trading `'` and `$` between -environments and terms. -``` - Es $ () |- t: expr T - -------------------- - Es |- $t: T - - - Es ' () |- t: T - ---------------- - Es |- 't: expr T -``` -The meta theory of a slightly simplified 2-stage variant of this calculus -is studied [separately](./simple-smp.html). - -## Going Further - -The metaprogramming framework as presented and currently implemented is quite restrictive -in that it does not allow for the inspection of quoted expressions and -types. It’s possible to work around this by providing all necessary -information as normal, unquoted inline parameters. But we would gain -more flexibility by allowing for the inspection of quoted code with -pattern matching. This opens new possibilities. - -For instance, here is a version of `power` that generates the multiplications -directly if the exponent is statically known and falls back to the dynamic -implementation of `power` otherwise. -```scala -import scala.quoted.* - -inline def power(x: Double, n: Int): Double = - ${ powerExpr('x, 'n) } - -private def powerExpr(x: Expr[Double], n: Expr[Int]) - (using Quotes): Expr[Double] = - n.value match - case Some(m) => powerExpr(x, m) - case _ => '{ dynamicPower($x, $n) } - -private def powerExpr(x: Expr[Double], n: Int) - (using Quotes): Expr[Double] = - if n == 0 then '{ 1.0 } - else if n == 1 then x - else if n % 2 == 0 then '{ val y = $x * $x; ${ powerExpr('y, n / 2) } } - else '{ $x * ${ powerExpr(x, n - 1) } } - -private def dynamicPower(x: Double, n: Int): Double = - if n == 0 then 1.0 - else if n % 2 == 0 then dynamicPower(x * x, n / 2) - else x * dynamicPower(x, n - 1) -``` - -In the above, the method `.value` maps a constant expression of the type -`Expr[T]` to its value of the type `T`. - -With the right extractors, the "AsFunction" conversion -that maps expressions over functions to functions over expressions can -be implemented in user code: -```scala -given AsFunction1[T, U]: Conversion[Expr[T => U], Expr[T] => Expr[U]] with - def apply(f: Expr[T => U]): Expr[T] => Expr[U] = - (x: Expr[T]) => f match - case Lambda(g) => g(x) - case _ => '{ ($f)($x) } -``` -This assumes an extractor -```scala -object Lambda: - def unapply[T, U](x: Expr[T => U]): Option[Expr[T] => Expr[U]] -``` -Once we allow inspection of code via extractors, it’s tempting to also -add constructors that create typed trees directly without going -through quotes. Most likely, those constructors would work over `Expr` -types which lack a known type argument. For instance, an `Apply` -constructor could be typed as follows: -```scala -def Apply(fn: Expr[Any], args: List[Expr[Any]]): Expr[Any] -``` -This would allow constructing applications from lists of arguments -without having to match the arguments one-by-one with the -corresponding formal parameter types of the function. We then need "at -the end" a method to convert an `Expr[Any]` to an `Expr[T]` where `T` is -given from the outside. For instance, if `code` yields a `Expr[Any]`, then -`code.atType[T]` yields an `Expr[T]`. The `atType` method has to be -implemented as a primitive; it would check that the computed type -structure of `Expr` is a subtype of the type structure representing -`T`. - -Before going down that route, we should evaluate in detail the tradeoffs it -presents. Constructing trees that are only verified _a posteriori_ -to be type correct loses a lot of guidance for constructing the right -trees. So we should wait with this addition until we have more -use-cases that help us decide whether the loss in type-safety is worth -the gain in flexibility. In this context, it seems that deconstructing types is -less error-prone than deconstructing terms, so one might also -envisage a solution that allows the former but not the latter. - -## Conclusion - -Metaprogramming has a reputation of being difficult and confusing. -But with explicit `Expr/Type` types and quotes and splices it can become -downright pleasant. A simple strategy first defines the underlying quoted or unquoted -values using `Expr` and `Type` and then inserts quotes and splices to make the types -line up. Phase consistency is at the same time a great guideline -where to insert a splice or a quote and a vital sanity check that -the result makes sense. diff --git a/_scala3-reference/metaprogramming/macros.md b/_scala3-reference/metaprogramming/macros.md deleted file mode 100644 index 9d70230c13..0000000000 --- a/_scala3-reference/metaprogramming/macros.md +++ /dev/null @@ -1,825 +0,0 @@ ---- -title: "Macros" -type: section -num: 30 -previous-page: /scala3/reference/metaprogramming/compiletime-ops -next-page: /scala3/reference/metaprogramming/staging ---- - -> When developing macros enable `-Xcheck-macros` scalac option flag to have extra runtime checks. - -## Macros: Quotes and Splices - -Macros are built on two well-known fundamental operations: quotation and splicing. -Quotation is expressed as `'{...}` for expressions and splicing is expressed as `${ ... }`. -Additionally, within a quote or a splice we can quote or splice identifiers directly (i.e. `'e` and `$e`). -Readers may notice the resemblance of the two aforementioned syntactic -schemes with the familiar string interpolation syntax. - -```scala -println(s"Hello, $name, here is the result of 1 + 1 = ${1 + 1}") -``` - -In string interpolation we _quoted_ a string and then we _spliced_ into it, two others. The first, `name`, is a reference to a value of type [`String`](https://scala-lang.org/api/3.x/scala/Predef$.html#String-0), and the second is an arithmetic expression that will be _evaluated_ followed by the splicing of its string representation. - -Quotes and splices in this section allow us to treat code in a similar way, -effectively supporting macros. The entry point for macros is an inline method -with a top-level splice. We call it a top-level because it is the only occasion -where we encounter a splice outside a quote (consider as a quote the -compilation-unit at the call-site). For example, the code below presents an -`inline` method `assert` which calls at compile-time a method `assertImpl` with -a boolean expression tree as argument. `assertImpl` evaluates the expression and -prints it again in an error message if it evaluates to `false`. - -```scala -import scala.quoted.* - -inline def assert(inline expr: Boolean): Unit = - ${ assertImpl('expr) } - -def assertImpl(expr: Expr[Boolean])(using Quotes) = '{ - if !$expr then - throw AssertionError(s"failed assertion: ${${ showExpr(expr) }}") -} - -def showExpr(expr: Expr[Boolean])(using Quotes): Expr[String] = - '{ [actual implementation later in this document] } -``` - -If `e` is an expression, then `'{e}` represents the typed -abstract syntax tree representing `e`. If `T` is a type, then `Type.of[T]` -represents the type structure representing `T`. The precise -definitions of "typed abstract syntax tree" or "type-structure" do not -matter for now, the terms are used only to give some -intuition. Conversely, `${e}` evaluates the expression `e`, which must -yield a typed abstract syntax tree or type structure, and embeds the -result as an expression (respectively, type) in the enclosing program. - -Quotations can have spliced parts in them; in this case the embedded -splices are evaluated and embedded as part of the formation of the -quotation. - -Quotes and splices can also be applied directly to identifiers. An identifier -`$x` starting with a `$` that appears inside a quoted expression or type is treated as a -splice `${x}`. Analogously, an quoted identifier `'x` that appears inside a splice -is treated as a quote `'{x}`. See the Syntax section below for details. - -Quotes and splices are duals of each other. -For arbitrary expressions `e` we have: - -```scala -${'{e}} = e -'{${e}} = e -``` - -## Types for Quotations - -The type signatures of quotes and splices can be described using -two fundamental types: - -- `Expr[T]`: abstract syntax trees representing expressions of type `T` -- `Type[T]`: non erased representation of type `T`. - -Quoting takes expressions of type `T` to expressions of type `Expr[T]` -and it takes types `T` to expressions of type `Type[T]`. Splicing -takes expressions of type `Expr[T]` to expressions of type `T` and it -takes expressions of type `Type[T]` to types `T`. - -The two types can be defined in package [`scala.quoted`](https://scala-lang.org/api/3.x/scala/quoted.html) as follows: - -```scala -package scala.quoted - -sealed trait Expr[+T] -sealed trait Type[T] -``` - -Both `Expr` and `Type` are abstract and sealed, so all constructors for -these types are provided by the system. One way to construct values of -these types is by quoting, the other is by type-specific lifting -operations that will be discussed later on. - -## The Phase Consistency Principle - -A fundamental *phase consistency principle* (PCP) regulates accesses -to free variables in quoted and spliced code: - -- _For any free variable reference `x`, the number of quoted scopes and the number of spliced scopes between the reference to `x` and the definition of `x` must be equal_. - -Here, `this`-references count as free variables. On the other -hand, we assume that all imports are fully expanded and that `_root_` is -not a free variable. So references to global definitions are -allowed everywhere. - -The phase consistency principle can be motivated as follows: First, -suppose the result of a program `P` is some quoted text `'{ ... x -... }` that refers to a free variable `x` in `P`. This can be -represented only by referring to the original variable `x`. Hence, the -result of the program will need to persist the program state itself as -one of its parts. We don’t want to do this, hence this situation -should be made illegal. Dually, suppose a top-level part of a program -is a spliced text `${ ... x ... }` that refers to a free variable `x` -in `P`. This would mean that we refer during _construction_ of `P` to -a value that is available only during _execution_ of `P`. This is of -course impossible and therefore needs to be ruled out. Now, the -small-step evaluation of a program will reduce quotes and splices in -equal measure using the cancellation rules above. But it will neither -create nor remove quotes or splices individually. So the PCP ensures -that program elaboration will lead to neither of the two unwanted -situations described above. - -In what concerns the range of features it covers, this form of macros introduces -a principled metaprogramming framework that is quite close to the MetaML family of -languages. One difference is that MetaML does not have an equivalent of the PCP - -quoted code in MetaML _can_ access variables in its immediately enclosing -environment, with some restrictions and caveats since such accesses involve -serialization. However, this does not constitute a fundamental gain in -expressiveness. - -## From `Expr`s to Functions and Back - -It is possible to convert any `Expr[T => R]` into `Expr[T] => Expr[R]` and back. -These conversions can be implemented as follows: - -```scala -def to[T: Type, R: Type](f: Expr[T] => Expr[R])(using Quotes): Expr[T => R] = - '{ (x: T) => ${ f('x) } } - -def from[T: Type, R: Type](f: Expr[T => R])(using Quotes): Expr[T] => Expr[R] = - (x: Expr[T]) => '{ $f($x) } -``` - -Note how the fundamental phase consistency principle works in two -different directions here for `f` and `x`. In the method `to`, the reference to `f` is -legal because it is quoted, then spliced, whereas the reference to `x` -is legal because it is spliced, then quoted. - -They can be used as follows: - -```scala -val f1: Expr[Int => String] = - to((x: Expr[Int]) => '{ $x.toString }) // '{ (x: Int) => x.toString } - -val f2: Expr[Int] => Expr[String] = - from('{ (x: Int) => x.toString }) // (x: Expr[Int]) => '{ ((x: Int) => x.toString)($x) } -f2('{2}) // '{ ((x: Int) => x.toString)(2) } -``` - -One limitation of `from` is that it does not β-reduce when a lambda is called immediately, as evidenced in the code `{ ((x: Int) => x.toString)(2) }`. -In some cases we want to remove the lambda from the code, for this we provide the method `Expr.betaReduce` that turns a tree -describing a function into a function mapping trees to trees. - -```scala -object Expr: - ... - def betaReduce[...](...)(...): ... = ... -``` - -The definition of `Expr.betaReduce(f)(x)` is assumed to be functionally the same as -`'{($f)($x)}`, however it should optimize this call by returning the -result of beta-reducing `f(x)` if `f` is a known lambda expression. -`Expr.betaReduce` distributes applications of `Expr` over function arrows: - -```scala -Expr.betaReduce(_): Expr[(T1, ..., Tn) => R] => ((Expr[T1], ..., Expr[Tn]) => Expr[R]) -``` - -## Lifting Types - -Types are not directly affected by the phase consistency principle. -It is possible to use types defined at any level in any other level. -But, if a type is used in a subsequent stage it will need to be lifted to a `Type`. -Indeed, the definition of `to` above uses `T` in the next stage, there is a -quote but no splice between the parameter binding of `T` and its -usage. But the code can be rewritten by adding an explicit binding of a `Type[T]`: - -```scala -def to[T, R](f: Expr[T] => Expr[R])(using t: Type[T])(using Type[R], Quotes): Expr[T => R] = - '{ (x: t.Underlying) => ${ f('x) } } -``` - -In this version of `to`, the type of `x` is now the result of -inserting the type `Type[T]` and selecting its `Underlying`. - -To avoid clutter, the compiler converts any type reference to -a type `T` in subsequent phases to `summon[Type[T]].Underlying`. - -And to avoid duplication it does it once per type, and creates -an alias for that type at the start of the quote. - -For instance, the user-level definition of `to`: - -```scala -def to[T, R](f: Expr[T] => Expr[R])(using t: Type[T], r: Type[R])(using Quotes): Expr[T => R] = - '{ (x: T) => ${ f('x) } } -``` - -would be rewritten to - -```scala -def to[T, R](f: Expr[T] => Expr[R])(using t: Type[T], r: Type[R])(using Quotes): Expr[T => R] = - '{ - type T = t.Underlying - (x: T) => ${ f('x) } - } -``` - -The `summon` query succeeds because there is a given instance of -type `Type[T]` available (namely the given parameter corresponding -to the context bound `: Type`), and the reference to that value is -phase-correct. If that was not the case, the phase inconsistency for -`T` would be reported as an error. - -## Lifting Expressions - -Consider the following implementation of a staged interpreter that implements -a compiler through staging. - -```scala -import scala.quoted.* - -enum Exp: - case Num(n: Int) - case Plus(e1: Exp, e2: Exp) - case Var(x: String) - case Let(x: String, e: Exp, in: Exp) - -import Exp.* -``` - -The interpreted language consists of numbers `Num`, addition `Plus`, and variables -`Var` which are bound by `Let`. Here are two sample expressions in the language: - -```scala -val exp = Plus(Plus(Num(2), Var("x")), Num(4)) -val letExp = Let("x", Num(3), exp) -``` - -Here’s a compiler that maps an expression given in the interpreted -language to quoted Scala code of type `Expr[Int]`. -The compiler takes an environment that maps variable names to Scala `Expr`s. - -```scala -import scala.quoted.* - -def compile(e: Exp, env: Map[String, Expr[Int]])(using Quotes): Expr[Int] = - e match - case Num(n) => - Expr(n) - case Plus(e1, e2) => - '{ ${ compile(e1, env) } + ${ compile(e2, env) } } - case Var(x) => - env(x) - case Let(x, e, body) => - '{ val y = ${ compile(e, env) }; ${ compile(body, env + (x -> 'y)) } } -``` - -Running `compile(letExp, Map())` would yield the following Scala code: - -```scala -'{ val y = 3; (2 + y) + 4 } -``` - -The body of the first clause, `case Num(n) => Expr(n)`, looks suspicious. `n` -is declared as an `Int`, yet it is converted to an `Expr[Int]` with `Expr()`. -Shouldn’t `n` be quoted? In fact this would not -work since replacing `n` by `'n` in the clause would not be phase -correct. - -The `Expr.apply` method is defined in package `quoted`: - -```scala -package quoted - -object Expr: - ... - def apply[T: ToExpr](x: T)(using Quotes): Expr[T] = - summon[ToExpr[T]].toExpr(x) -``` - -This method says that values of types implementing the `ToExpr` type class can be -converted to `Expr` values using `Expr.apply`. - -Scala 3 comes with given instances of `ToExpr` for -several types including `Boolean`, `String`, and all primitive number -types. For example, `Int` values can be converted to `Expr[Int]` -values by wrapping the value in a `Literal` tree node. This makes use -of the underlying tree representation in the compiler for -efficiency. But the `ToExpr` instances are nevertheless not _magic_ -in the sense that they could all be defined in a user program without -knowing anything about the representation of `Expr` trees. For -instance, here is a possible instance of `ToExpr[Boolean]`: - -```scala -given ToExpr[Boolean] with - def toExpr(b: Boolean) = - if b then '{ true } else '{ false } -``` - -Once we can lift bits, we can work our way up. For instance, here is a -possible implementation of `ToExpr[Int]` that does not use the underlying -tree machinery: - -```scala -given ToExpr[Int] with - def toExpr(n: Int) = n match - case Int.MinValue => '{ Int.MinValue } - case _ if n < 0 => '{ - ${ toExpr(-n) } } - case 0 => '{ 0 } - case _ if n % 2 == 0 => '{ ${ toExpr(n / 2) } * 2 } - case _ => '{ ${ toExpr(n / 2) } * 2 + 1 } -``` - -Since `ToExpr` is a type class, its instances can be conditional. For example, -a `List` is liftable if its element type is: - -```scala -given [T: ToExpr : Type]: ToExpr[List[T]] with - def toExpr(xs: List[T]) = xs match - case head :: tail => '{ ${ Expr(head) } :: ${ toExpr(tail) } } - case Nil => '{ Nil: List[T] } -``` - -In the end, `ToExpr` resembles very much a serialization -framework. Like the latter it can be derived systematically for all -collections, case classes and enums. Note also that the synthesis -of _type-tag_ values of type `Type[T]` is essentially the type-level -analogue of lifting. - -Using lifting, we can now give the missing definition of `showExpr` in the introductory example: - -```scala -def showExpr[T](expr: Expr[T])(using Quotes): Expr[String] = - val code: String = expr.show - Expr(code) -``` - -That is, the `showExpr` method converts its `Expr` argument to a string (`code`), and lifts -the result back to an `Expr[String]` using `Expr.apply`. - -## Lifting Types - -The previous section has shown that the metaprogramming framework has -to be able to take a type `T` and convert it to a type tree of type -`Type[T]` that can be reified. This means that all free variables of -the type tree refer to types and values defined in the current stage. - -For a reference to a global class, this is easy: Just issue the fully -qualified name of the class. Members of reifiable types are handled by -just reifying the containing type together with the member name. But -what to do for references to type parameters or local type definitions -that are not defined in the current stage? Here, we cannot construct -the `Type[T]` tree directly, so we need to get it from a recursive -implicit search. For instance, to implement - -```scala -summon[Type[List[T]]] -``` - -where `T` is not defined in the current stage, we construct the type constructor -of `List` applied to the splice of the result of searching for a given instance for `Type[T]`: - -```scala -Type.of[ List[ summon[Type[T]].Underlying ] ] -``` - -This is exactly the algorithm that Scala 2 uses to search for type tags. -In fact Scala 2's type tag feature can be understood as a more ad-hoc version of -`quoted.Type`. As was the case for type tags, the implicit search for a `quoted.Type` -is handled by the compiler, using the algorithm sketched above. - -## Relationship with `inline` - -Seen by itself, principled metaprogramming looks more like a framework for -runtime metaprogramming than one for compile-time metaprogramming with macros. -But combined with Scala 3’s `inline` feature it can be turned into a compile-time -system. The idea is that macro elaboration can be understood as a combination of -a macro library and a quoted program. For instance, here’s the `assert` macro -again together with a program that calls `assert`. - -```scala -object Macros: - - inline def assert(inline expr: Boolean): Unit = - ${ assertImpl('expr) } - - def assertImpl(expr: Expr[Boolean])(using Quotes) = - val failMsg: Expr[String] = Expr("failed assertion: " + expr.show) - '{ if !($expr) then throw new AssertionError($failMsg) } - -@main def program = - val x = 1 - Macros.assert(x != 0) -``` - -Inlining the `assert` function would give the following program: - -```scala -@main def program = - val x = 1 - ${ Macros.assertImpl('{ x != 0}) } -``` - -The example is only phase correct because `Macros` is a global value and -as such not subject to phase consistency checking. Conceptually that’s -a bit unsatisfactory. If the PCP is so fundamental, it should be -applicable without the global value exception. But in the example as -given this does not hold since both `assert` and `program` call -`assertImpl` with a splice but no quote. - -However, one could argue that the example is really missing -an important aspect: The macro library has to be compiled in a phase -prior to the program using it, but in the code above, macro -and program are defined together. A more accurate view of -macros would be to have the user program be in a phase after the macro -definitions, reflecting the fact that macros have to be defined and -compiled before they are used. Hence, conceptually the program part -should be treated by the compiler as if it was quoted: - -```scala -@main def program = '{ - val x = 1 - ${ Macros.assertImpl('{ x != 0 }) } -} -``` - -If `program` is treated as a quoted expression, the call to -`Macro.assertImpl` becomes phase correct even if macro library and -program are conceptualized as local definitions. - -But what about the call from `assert` to `assertImpl`? Here, we need a -tweak of the typing rules. An inline function such as `assert` that -contains a splice operation outside an enclosing quote is called a -_macro_. Macros are supposed to be expanded in a subsequent phase, -i.e. in a quoted context. Therefore, they are also type checked as if -they were in a quoted context. For instance, the definition of -`assert` is typechecked as if it appeared inside quotes. This makes -the call from `assert` to `assertImpl` phase-correct, even if we -assume that both definitions are local. - -The `inline` modifier is used to declare a `val` that is -either a constant or is a parameter that will be a constant when instantiated. This -aspect is also important for macro expansion. - -To get values out of expressions containing constants `Expr` provides the method -`value` (or `valueOrError`). This will convert the `Expr[T]` into a `Some[T]` (or `T`) when the -expression contains value. Otherwise it will return `None` (or emit an error). -To avoid having incidental val bindings generated by the inlining of the `def` -it is recommended to use an inline parameter. To illustrate this, consider an -implementation of the `power` function that makes use of a statically known exponent: - -```scala -inline def power(x: Double, inline n: Int) = ${ powerCode('x, 'n) } - -private def powerCode(x: Expr[Double], n: Expr[Int])(using Quotes): Expr[Double] = - n.value match - case Some(m) => powerCode(x, m) - case None => '{ Math.pow($x, $n.toDouble) } - -private def powerCode(x: Expr[Double], n: Int)(using Quotes): Expr[Double] = - if n == 0 then '{ 1.0 } - else if n == 1 then x - else if n % 2 == 0 then '{ val y = $x * $x; ${ powerCode('y, n / 2) } } - else '{ $x * ${ powerCode(x, n - 1) } } -``` - -## Scope Extrusion - -Quotes and splices are duals as far as the PCP is concerned. But there is an -additional restriction that needs to be imposed on splices to guarantee -soundness: code in splices must be free of side effects. The restriction -prevents code like this: - -```scala -var x: Expr[T] = ... -'{ (y: T) => ${ x = 'y; 1 } } -``` - -This code, if it was accepted, would _extrude_ a reference to a quoted variable -`y` from its scope. This would subsequently allow access to a variable outside the -scope where it is defined, which is likely problematic. The code is clearly -phase consistent, so we cannot use PCP to rule it out. Instead, we postulate a -future effect system that can guarantee that splices are pure. In the absence of -such a system we simply demand that spliced expressions are pure by convention, -and allow for undefined compiler behavior if they are not. This is analogous to -the status of pattern guards in Scala, which are also required, but not -verified, to be pure. - -[Multi-Stage Programming](./staging.html) introduces one additional method where -you can expand code at runtime with a method `run`. There is also a problem with -that invocation of `run` in splices. Consider the following expression: - -```scala -'{ (x: Int) => ${ run('x); 1 } } -``` - -This is again phase correct, but will lead us into trouble. Indeed, evaluating -the splice will reduce the expression `run('x)` to `x`. But then the result - -```scala -'{ (x: Int) => ${ x; 1 } } -``` - -is no longer phase correct. To prevent this soundness hole it seems easiest to -classify `run` as a side-effecting operation. It would thus be prevented from -appearing in splices. In a base language with side effects we would have to do this -anyway: Since `run` runs arbitrary code it can always produce a side effect if -the code it runs produces one. - -## Example Expansion - -Assume we have two methods, one `map` that takes an `Expr[Array[T]]` and a -function `f` and one `sum` that performs a sum by delegating to `map`. - -```scala -object Macros: - - def map[T](arr: Expr[Array[T]], f: Expr[T] => Expr[Unit]) - (using Type[T], Quotes): Expr[Unit] = '{ - var i: Int = 0 - while i < ($arr).length do - val element: T = ($arr)(i) - ${f('element)} - i += 1 - } - - def sum(arr: Expr[Array[Int]])(using Quotes): Expr[Int] = '{ - var sum = 0 - ${ map(arr, x => '{sum += $x}) } - sum - } - - inline def sum_m(arr: Array[Int]): Int = ${sum('arr)} - -end Macros -``` - -A call to `sum_m(Array(1,2,3))` will first inline `sum_m`: - -```scala -val arr: Array[Int] = Array.apply(1, [2,3 : Int]:Int*) -${_root_.Macros.sum('arr)} -``` - -then it will splice `sum`: - -```scala -val arr: Array[Int] = Array.apply(1, [2,3 : Int]:Int*) - -var sum = 0 -${ map('arr, x => '{sum += $x}) } -sum -``` - -then it will inline `map`: - -```scala -val arr: Array[Int] = Array.apply(1, [2,3 : Int]:Int*) - -var sum = 0 -val f = x => '{sum += $x} -${ _root_.Macros.map('arr, 'f)(Type.of[Int])} -sum -``` - -then it will expand and splice inside quotes `map`: - -```scala -val arr: Array[Int] = Array.apply(1, [2,3 : Int]:Int*) - -var sum = 0 -val f = x => '{sum += $x} -var i: Int = 0 -while i < arr.length do - val element: Int = (arr)(i) - sum += element - i += 1 -sum -``` - -Finally cleanups and dead code elimination: - -```scala -val arr: Array[Int] = Array.apply(1, [2,3 : Int]:Int*) -var sum = 0 -var i: Int = 0 -while i < arr.length do - val element: Int = arr(i) - sum += element - i += 1 -sum -``` - -## Find implicits within a macro - -Similarly to the `summonFrom` construct, it is possible to make implicit search available -in a quote context. For this we simply provide `scala.quoted.Expr.summon`: - -```scala -import scala.collection.immutable.{ TreeSet, HashSet } -inline def setFor[T]: Set[T] = ${ setForExpr[T] } - -def setForExpr[T: Type](using Quotes): Expr[Set[T]] = - Expr.summon[Ordering[T]] match - case Some(ord) => '{ new TreeSet[T]()($ord) } - case _ => '{ new HashSet[T] } -``` - -## Relationship with Transparent Inline - -[Inline](./inline.html) documents inlining. The code below introduces a transparent -inline method that can calculate either a value of type `Int` or a value of type -`String`. - -```scala -transparent inline def defaultOf(inline str: String) = - ${ defaultOfImpl('str) } - -def defaultOfImpl(strExpr: Expr[String])(using Quotes): Expr[Any] = - strExpr.valueOrError match - case "int" => '{1} - case "string" => '{"a"} - -// in a separate file -val a: Int = defaultOf("int") -val b: String = defaultOf("string") - -``` - -## Defining a macro and using it in a single project - -It is possible to define macros and use them in the same project as long as the implementation -of the macros does not have run-time dependencies on code in the file where it is used. -It might still have compile-time dependencies on types and quoted code that refers to the use-site file. - -To provide this functionality Scala 3 provides a transparent compilation mode where files that -try to expand a macro but fail because the macro has not been compiled yet are suspended. -If there are any suspended files when the compilation ends, the compiler will automatically restart -compilation of the suspended files using the output of the previous (partial) compilation as macro classpath. -In case all files are suspended due to cyclic dependencies the compilation will fail with an error. - -## Pattern matching on quoted expressions - -It is possible to deconstruct or extract values out of `Expr` using pattern matching. - -`scala.quoted` contains objects that can help extracting values from `Expr`. - -- `scala.quoted.Expr`/`scala.quoted.Exprs`: matches an expression of a value (or list of values) and returns the value (or list of values). -- `scala.quoted.Const`/`scala.quoted.Consts`: Same as `Expr`/`Exprs` but only works on primitive values. -- `scala.quoted.Varargs`: matches an explicit sequence of expressions and returns them. These sequences are useful to get individual `Expr[T]` out of a varargs expression of type `Expr[Seq[T]]`. - -These could be used in the following way to optimize any call to `sum` that has statically known values. - -```scala -inline def sum(inline args: Int*): Int = ${ sumExpr('args) } -private def sumExpr(argsExpr: Expr[Seq[Int]])(using Quotes): Expr[Int] = - argsExpr match - case Varargs(args @ Exprs(argValues)) => - // args is of type Seq[Expr[Int]] - // argValues is of type Seq[Int] - Expr(argValues.sum) // precompute result of sum - case Varargs(argExprs) => // argExprs is of type Seq[Expr[Int]] - val staticSum: Int = argExprs.map(_.value.getOrElse(0)).sum - val dynamicSum: Seq[Expr[Int]] = argExprs.filter(_.value.isEmpty) - dynamicSum.foldLeft(Expr(staticSum))((acc, arg) => '{ $acc + $arg }) - case _ => - '{ $argsExpr.sum } -``` - -### Quoted patterns - -Quoted pattens allow deconstructing complex code that contains a precise structure, types or methods. -Patterns `'{ ... }` can be placed in any location where Scala expects a pattern. - -For example - -```scala -optimize { - sum(sum(1, a, 2), 3, b) -} // should be optimized to 6 + a + b -``` - -```scala -def sum(args: Int*): Int = args.sum -inline def optimize(inline arg: Int): Int = ${ optimizeExpr('arg) } -private def optimizeExpr(body: Expr[Int])(using Quotes): Expr[Int] = - body match - // Match a call to sum without any arguments - case '{ sum() } => Expr(0) - // Match a call to sum with an argument $n of type Int. - // n will be the Expr[Int] representing the argument. - case '{ sum($n) } => n - // Match a call to sum and extracts all its args in an `Expr[Seq[Int]]` - case '{ sum(${Varargs(args)}: _*) } => sumExpr(args) - case body => body - -private def sumExpr(args1: Seq[Expr[Int]])(using Quotes): Expr[Int] = - def flatSumArgs(arg: Expr[Int]): Seq[Expr[Int]] = arg match - case '{ sum(${Varargs(subArgs)}: _*) } => subArgs.flatMap(flatSumArgs) - case arg => Seq(arg) - val args2 = args1.flatMap(flatSumArgs) - val staticSum: Int = args2.map(_.value.getOrElse(0)).sum - val dynamicSum: Seq[Expr[Int]] = args2.filter(_.value.isEmpty) - dynamicSum.foldLeft(Expr(staticSum))((acc, arg) => '{ $acc + $arg }) -``` - -### Recovering precise types using patterns - -Sometimes it is necessary to get a more precise type for an expression. This can be achieved using the following pattern match. - -```scala -def f(expr: Expr[Any])(using Quotes) = expr match - case '{ $x: t } => - // If the pattern match succeeds, then there is - // some type `t` such that - // - `x` is bound to a variable of type `Expr[t]` - // - `t` is bound to a new type `t` and a given - // instance `Type[t]` is provided for it - // That is, we have `x: Expr[t]` and `given Type[t]`, - // for some (unknown) type `t`. -``` - -This might be used to then perform an implicit search as in: - -```scala -extension (inline sc: StringContext) - inline def showMe(inline args: Any*): String = ${ showMeExpr('sc, 'args) } - -private def showMeExpr(sc: Expr[StringContext], argsExpr: Expr[Seq[Any]])(using Quotes): Expr[String] = - import quotes.reflect.report - argsExpr match - case Varargs(argExprs) => - val argShowedExprs = argExprs.map { - case '{ $arg: tp } => - Expr.summon[Show[tp]] match - case Some(showExpr) => - '{ $showExpr.show($arg) } - case None => - report.error(s"could not find implicit for ${Type.show[Show[tp]]}", arg); '{???} - } - val newArgsExpr = Varargs(argShowedExprs) - '{ $sc.s($newArgsExpr: _*) } - case _ => - // `new StringContext(...).showMeExpr(args: _*)` not an explicit `showMeExpr"..."` - report.error(s"Args must be explicit", argsExpr) - '{???} - -trait Show[-T]: - def show(x: T): String - -// in a different file -given Show[Boolean] with - def show(b: Boolean) = "boolean!" - -println(showMe"${true}") -``` - -### Open code patterns - -Quoted pattern matching also provides higher-order patterns to match open terms. If a quoted term contains a definition, -then the rest of the quote can refer to this definition. - -```scala -'{ - val x: Int = 4 - x * x -} -``` - -To match such a term we need to match the definition and the rest of the code, but we need to explicitly state that the rest of the code may refer to this definition. - -```scala -case '{ val y: Int = $x; $body(y): Int } => -``` - -Here `$x` will match any closed expression while `$body(y)` will match an expression that is closed under `y`. Then -the subexpression of type `Expr[Int]` is bound to `body` as an `Expr[Int => Int]`. The extra argument represents the references to `y`. Usually this expression is used in combination with `Expr.betaReduce` to replace the extra argument. - -```scala -inline def eval(inline e: Int): Int = ${ evalExpr('e) } - -private def evalExpr(e: Expr[Int])(using Quotes): Expr[Int] = e match - case '{ val y: Int = $x; $body(y): Int } => - // body: Expr[Int => Int] where the argument represents - // references to y - evalExpr(Expr.betaReduce('{$body(${evalExpr(x)})})) - case '{ ($x: Int) * ($y: Int) } => - (x.value, y.value) match - case (Some(a), Some(b)) => Expr(a * b) - case _ => e - case _ => e -``` - -```scala -eval { // expands to the code: (16: Int) - val x: Int = 4 - x * x -} -``` - -We can also close over several bindings using `$b(a1, a2, ..., an)`. -To match an actual application we can use braces on the function part `${b}(a1, a2, ..., an)`. - -## More details - -[More details](./macros-spec.html) diff --git a/_scala3-reference/metaprogramming/reflection.md b/_scala3-reference/metaprogramming/reflection.md deleted file mode 100644 index a7c65cff68..0000000000 --- a/_scala3-reference/metaprogramming/reflection.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: "Reflection" -type: section -num: 32 -previous-page: /scala3/reference/metaprogramming/staging -next-page: /scala3/reference/metaprogramming/tasty-inspect ---- - -Reflection enables inspection and construction of Typed Abstract Syntax Trees -(Typed-AST). It may be used on quoted expressions (`quoted.Expr`) and quoted -types (`quoted.Type`) from [Macros](./macros.html) or on full TASTy files. - -If you are writing macros, please first read [Macros](./macros.html). -You may find all you need without using quote reflection. - -## API: From quotes and splices to TASTy reflect trees and back - -With `quoted.Expr` and `quoted.Type` we can compute code but also analyze code -by inspecting the ASTs. [Macros](./macros.html) provide the guarantee that the -generation of code will be type-correct. Using quote reflection will break these -guarantees and may fail at macro expansion time, hence additional explicit -checks must be done. - -To provide reflection capabilities in macros we need to add an implicit parameter -of type `scala.quoted.Quotes` and import `quotes.reflect.*` from it in the scope -where it is used. - -```scala -import scala.quoted.* - -inline def natConst(inline x: Int): Int = ${natConstImpl('{x})} - -def natConstImpl(x: Expr[Int])(using Quotes): Expr[Int] = - import quotes.reflect.* - ... -``` - -### Extractors - -`import quotes.reflect.*` will provide all extractors and methods on `quotes.reflect.Tree`s. -For example the `Literal(_)` extractor used below. - -```scala -def natConstImpl(x: Expr[Int])(using Quotes): Expr[Int] = - import quotes.reflect.* - val tree: Term = x.asTerm - tree match - case Inlined(_, _, Literal(IntConstant(n))) => - if n <= 0 then - report.error("Parameter must be natural number") - '{0} - else - tree.asExprOf[Int] - case _ => - report.error("Parameter must be a known constant") - '{0} -``` - -We can easily know which extractors are needed using `Printer.TreeStructure.show`, -which returns the string representation the structure of the tree. Other printers -can also be found in the `Printer` module. - -```scala -tree.show(using Printer.TreeStructure) -// or -Printer.TreeStructure.show(tree) -``` - -The methods `quotes.reflect.Term.{asExpr, asExprOf}` provide a way to go back to -a `quoted.Expr`. Note that `asExpr` returns a `Expr[Any]`. On the other hand -`asExprOf[T]` returns a `Expr[T]`, if the type does not conform to it an exception -will be thrown at runtime. - -### Positions - -The `Position` in the context provides an `ofMacroExpansion` value. It corresponds -to the expansion site for macros. The macro authors can obtain various information -about that expansion site. The example below shows how we can obtain position -information such as the start line, the end line or even the source code at the -expansion point. - -```scala -def macroImpl()(quotes: Quotes): Expr[Unit] = - import quotes.reflect.* - val pos = Position.ofMacroExpansion - - val path = pos.sourceFile.jpath.toString - val start = pos.start - val end = pos.end - val startLine = pos.startLine - val endLine = pos.endLine - val startColumn = pos.startColumn - val endColumn = pos.endColumn - val sourceCode = pos.sourceCode - ... -``` - -### Tree Utilities - -`quotes.reflect` contains three facilities for tree traversal and -transformation. - -`TreeAccumulator` ties the knot of a traversal. By calling `foldOver(x, tree)(owner)` -we can dive into the `tree` node and start accumulating values of type `X` (e.g., -of type `List[Symbol]` if we want to collect symbols). The code below, for -example, collects the `val` definitions in the tree. - -```scala -def collectPatternVariables(tree: Tree)(using ctx: Context): List[Symbol] = - val acc = new TreeAccumulator[List[Symbol]]: - def foldTree(syms: List[Symbol], tree: Tree)(owner: Symbol): List[Symbol] = tree match - case ValDef(_, _, rhs) => - val newSyms = tree.symbol :: syms - foldTree(newSyms, body)(tree.symbol) - case _ => - foldOverTree(syms, tree)(owner) - acc(Nil, tree) -``` - -A `TreeTraverser` extends a `TreeAccumulator` and performs the same traversal -but without returning any value. Finally, a `TreeMap` performs a transformation. - -#### ValDef.let - -`quotes.reflect.ValDef` also offers a method `let` that allows us to bind the `rhs` (right-hand side) to a `val` and use it in `body`. -Additionally, `lets` binds the given `terms` to names and allows to use them in the `body`. -Their type definitions are shown below: - -```scala -def let(rhs: Term)(body: Ident => Term): Term = ... - -def lets(terms: List[Term])(body: List[Term] => Term): Term = ... -``` diff --git a/_scala3-reference/metaprogramming/simple-smp.md b/_scala3-reference/metaprogramming/simple-smp.md deleted file mode 100644 index 6a7e2c0fba..0000000000 --- a/_scala3-reference/metaprogramming/simple-smp.md +++ /dev/null @@ -1,232 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "The Meta-theory of Symmetric Metaprogramming" ---- - -This note presents a simplified variant of -[principled metaprogramming](./macros.html) -and sketches its soundness proof. The variant treats only dialogues -between two stages. A program can have quotes which can contain -splices (which can contain quotes, which can contain splices, and so -on). Or the program could start with a splice with embedded -quotes. The essential restriction is that (1) a term can contain top-level -quotes or top-level splices, but not both, and (2) quotes cannot appear -directly inside quotes and splices cannot appear directly inside -splices. In other words, the universe is restricted to two phases -only. - -Under this restriction we can simplify the typing rules so that there are -always exactly two environments instead of having a stack of environments. -The variant presented here differs from the full calculus also in that we -replace evaluation contexts with contextual typing rules. While this -is more verbose, it makes it easier to set up the meta theory. - -## Syntax -``` -Terms t ::= x variable - (x: T) => t lambda - t t application - ’t quote - ~t splice - -Simple terms u ::= x | (x: T) => u | u u - -Values v ::= (x: T) => t lambda - ’u quoted value - -Types T ::= A base type - T -> T function type - ’T quoted type -``` -## Operational semantics - -### Evaluation -``` - ((x: T) => t) v --> [x := v]t - - t1 --> t2 - --------------- - t1 t --> t2 t - - t1 --> t2 - --------------- - v t1 --> v t2 - - t1 ==> t2 - ------------- - ’t1 --> ’t2 -``` - -### Splicing -``` - ~’u ==> u - - t1 ==> t2 - ------------------------------- - (x: T) => t1 ==> (x: T) => t2 - - t1 ==> t2 - --------------- - t1 t ==> t2 t - - t1 ==> t2 - --------------- - u t1 ==> u t2 - - t1 --> t2 - ------------- - ~t1 ==> ~t2 - -``` -## Typing Rules - -Typing judgments are of the form `E1 * E2 |- t: T` where `E1, E2` are environments and -`*` is one of `~` and `’`. -``` - x: T in E2 - --------------- - E1 * E2 |- x: T - - - E1 * E2, x: T1 |- t: T2 - -------------------------------- - E1 * E2 |- (x: T1) => t: T -> T2 - - - E1 * E2 |- t1: T2 -> T E1 * E2 |- t2: T2 - ------------------------------------------- - E1 * E2 |- t1 t2: T - - - E2 ’ E1 |- t: T - ----------------- - E1 ~ E2 |- ’t: ’T - - - E2 ~ E1 |- t: ’T - ---------------- - E1 ’ E2 |- ~t: T -``` - -(Curiously, this looks a bit like a Christmas tree). - -## Soundness - -The meta-theory typically requires mutual inductions over two judgments. - -### Progress Theorem - - 1. If `E1 ~ |- t: T` then either `t = v` for some value `v` or `t --> t2` for some term `t2`. - 2. If ` ’ E2 |- t: T` then either `t = u` for some simple term `u` or `t ==> t2` for some term `t2`. - -Proof by structural induction over terms. - -To prove (1): - - - the cases for variables, lambdas and applications are as in [STLC](https://en.wikipedia.org/wiki/Simply_typed_lambda_calculus). - - If `t = ’t2`, then by inversion we have ` ’ E1 |- t2: T2` for some type `T2`. - By the second [induction hypothesis](https://en.wikipedia.org/wiki/Mathematical_induction) (I.H.), we have one of: - - `t2 = u`, hence `’t2` is a value, - - `t2 ==> t3`, hence `’t2 --> ’t3`. - - The case `t = ~t2` is not typable. - -To prove (2): - - - If `t = x` then `t` is a simple term. - - If `t = (x: T) => t2`, then either `t2` is a simple term, in which case `t` is as well. - Or by the second I.H. `t2 ==> t3`, in which case `t ==> (x: T) => t3`. - - If `t = t1 t2` then one of three cases applies: - - - `t1` and `t2` are a simple term, then `t` is as well a simple term. - - `t1` is not a simple term. Then by the second I.H., `t1 ==> t12`, hence `t ==> t12 t2`. - - `t1` is a simple term but `t2` is not. Then by the second I.H. `t2 ==> t22`, hence `t ==> t1 t22`. - - - The case `t = ’t2` is not typable. - - If `t = ~t2` then by inversion we have `E2 ~ |- t2: ’T2`, for some type `T2`. - By the first I.H., we have one of - - - `t2 = v`. Since `t2: ’T2`, we must have `v = ’u`, for some simple term `u`, hence `t = ~’u`. - By quote-splice reduction, `t ==> u`. - - `t2 --> t3`. Then by the context rule for `’t`, `t ==> ’t3`. - - -### Substitution Lemma - - 1. If `E1 ~ E2 |- s: S` and `E1 ~ E2, x: S |- t: T` then `E1 ~ E2 |- [x := s]t: T`. - 2. If `E1 ~ E2 |- s: S` and `E2, x: S ’ E1 |- t: T` then `E2 ’ E1 |- [x := s]t: T`. - -The proofs are by induction on typing derivations for `t`, analogous -to the proof for STL (with (2) a bit simpler than (1) since we do not -need to swap lambda bindings with the bound variable `x`). The -arguments that link the two hypotheses are as follows. - -To prove (1), let `t = ’t1`. Then `T = ’T1` for some type `T1` and the last typing rule is -``` - E2, x: S ’ E1 |- t1: T1 - ------------------------- - E1 ~ E2, x: S |- ’t1: ’T1 -``` -By the second I.H. `E2 ’ E1 |- [x := s]t1: T1`. By typing, `E1 ~ E2 |- ’[x := s]t1: ’T1`. -Since `[x := s]t = [x := s](’t1) = ’[x := s]t1` we get `[x := s]t: ’T1`. - -To prove (2), let `t = ~t1`. Then the last typing rule is -``` - E1 ~ E2, x: S |- t1: ’T - ----------------------- - E2, x: S ’ E1 |- ~t1: T -``` -By the first I.H., `E1 ~ E2 |- [x := s]t1: ’T`. By typing, `E2 ’ E1 |- ~[x := s]t1: T`. -Since `[x := s]t = [x := s](~t1) = ~[x := s]t1` we get `[x := s]t: T`. - - -### Preservation Theorem - - 1. If `E1 ~ E2 |- t1: T` and `t1 --> t2` then `E1 ~ E2 |- t2: T`. - 2. If `E1 ’ E2 |- t1: T` and `t1 ==> t2` then `E1 ’ E2 |- t2: T`. - -The proof is by structural induction on evaluation derivations. The proof of (1) is analogous -to the proof for STL, using the substitution lemma for the beta reduction case, with the addition of reduction of quoted terms, which goes as follows: - - - Assume the last rule was - ``` - t1 ==> t2 - ------------- - ’t1 --> ’t2 - ``` - By inversion of typing rules, we must have `T = ’T1` for some type `T1` such that `t1: T1`. - By the second I.H., `t2: T1`, hence `’t2: `T1`. - - -To prove (2): - - - Assume the last rule was `~’u ==> u`. The typing proof of `~’u` must have the form - - ``` - E1 ’ E2 |- u: T - ----------------- - E1 ~ E2 |- ’u: ’T - ----------------- - E1 ’ E2 |- ~’u: T - ``` - Hence, `E1 ’ E2 |- u: T`. - - - Assume the last rule was - ``` - t1 ==> t2 - ------------------------------- - (x: S) => t1 ==> (x: T) => t2 - ``` - By typing inversion, `E1 ' E2, x: S |- t1: T1` for some type `T1` such that `T = S -> T1`. - By the I.H, `t2: T1`. By the typing rule for lambdas the result follows. - - - The context rules for applications are equally straightforward. - - - Assume the last rule was - ``` - t1 ==> t2 - ------------- - ~t1 ==> ~t2 - ``` - By inversion of typing rules, we must have `t1: ’T`. - By the first I.H., `t2: ’T`, hence `~t2: T`. diff --git a/_scala3-reference/metaprogramming/staging.md b/_scala3-reference/metaprogramming/staging.md deleted file mode 100644 index bb35f51055..0000000000 --- a/_scala3-reference/metaprogramming/staging.md +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: "Runtime Multi-Stage Programming" -type: section -num: 31 -previous-page: /scala3/reference/metaprogramming/macros -next-page: /scala3/reference/metaprogramming/reflection ---- - -The framework expresses at the same time compile-time metaprogramming and -multi-stage programming. We can think of compile-time metaprogramming as a -two stage compilation process: one that we write the code in top-level splices, -that will be used for code generation (macros) and one that will perform all -necessary evaluations at compile-time and an object program that we will run -as usual. What if we could synthesize code at run-time and offer one extra stage -to the programmer? Then we can have a value of type `Expr[T]` at run-time that we -can essentially treat as a typed-syntax tree that we can either _show_ as a -string (pretty-print) or compile and run. If the number of quotes exceeds the -number of splices by more than one (effectively handling at run-time values of type -`Expr[Expr[T]]`, `Expr[Expr[Expr[T]]]`, ...) then we talk about Multi-Stage -Programming. - -The motivation behind this _paradigm_ is to let runtime information affect or -guide code-generation. - -Intuition: The phase in which code is run is determined by the difference -between the number of splice scopes and quote scopes in which it is embedded. - - - If there are more splices than quotes, the code is run at compile-time i.e. - as a macro. In the general case, this means running an interpreter that - evaluates the code, which is represented as a typed abstract syntax tree. The - interpreter can fall back to reflective calls when evaluating an application - of a previously compiled method. If the splice excess is more than one, it - would mean that a macro’s implementation code (as opposed to the code it - expands to) invokes other macros. If macros are realized by interpretation, - this would lead to towers of interpreters, where the first interpreter would - itself interpret an interpreter code that possibly interprets another - interpreter and so on. - - - If the number of splices equals the number of quotes, the code is compiled - and run as usual. - - - If the number of quotes exceeds the number of splices, the code is staged. - That is, it produces a typed abstract syntax tree or type structure at - run-time. A quote excess of more than one corresponds to multi-staged - programming. - -Providing an interpreter for the full language is quite difficult, and it is -even more difficult to make that interpreter run efficiently. So we currently -impose the following restrictions on the use of splices. - - 1. A top-level splice must appear in an inline method (turning that method - into a macro) - - 2. The splice must call a previously compiled - method passing quoted arguments, constant arguments or inline arguments. - - 3. Splices inside splices (but no intervening quotes) are not allowed. - - -## API - -The framework as discussed so far allows code to be staged, i.e. be prepared -to be executed at a later stage. To run that code, there is another method -in class `Expr` called `run`. Note that `$` and `run` both map from `Expr[T]` -to `T` but only `$` is subject to the [PCP](./macros.html#the-phase-consistency-principle), whereas `run` is just a normal method. -`scala.quoted.staging.run` provides a `Quotes` that can be used to show the expression in its scope. -On the other hand `scala.quoted.staging.withQuotes` provides a `Quotes` without evaluating the expression. - -```scala -package scala.quoted.staging - -def run[T](expr: Quotes ?=> Expr[T])(using Compiler): T = ... - -def withQuotes[T](thunk: Quotes ?=> T)(using Compiler): T = ... -``` - -## Create a new Scala 3 project with staging enabled - -```shell -sbt new scala/scala3-staging.g8 -``` - -From [`scala/scala3-staging.g8`](https://github.com/scala/scala3-staging.g8). - -It will create a project with the necessary dependencies and some examples. - -In case you prefer to create the project on your own, make sure to define the following dependency in your [`build.sbt` build definition](https://www.scala-sbt.org/1.x/docs/Basic-Def.html) - -```scala -libraryDependencies += "org.scala-lang" %% "scala3-staging" % scalaVersion.value -``` - -and in case you use `scalac`/`scala` directly, then use the `-with-compiler` flag for both: - -```shell -scalac -with-compiler -d out Test.scala -scala -with-compiler -classpath out Test -``` - -## Example - -Now take exactly the same example as in [Macros](./macros.html). Assume that we -do not want to pass an array statically but generate code at run-time and pass -the value, also at run-time. Note, how we make a future-stage function of type -`Expr[Array[Int] => Int]` in line 6 below. Using `staging.run { ... }` we can evaluate an -expression at runtime. Within the scope of `staging.run` we can also invoke `show` on an expression -to get a source-like representation of the expression. - -```scala -import scala.quoted.* - -// make available the necessary compiler for runtime code generation -given staging.Compiler = staging.Compiler.make(getClass.getClassLoader) - -val f: Array[Int] => Int = staging.run { - val stagedSum: Expr[Array[Int] => Int] = - '{ (arr: Array[Int]) => ${sum('arr)}} - println(stagedSum.show) // Prints "(arr: Array[Int]) => { var sum = 0; ... }" - stagedSum -} - -f.apply(Array(1, 2, 3)) // Returns 6 -``` diff --git a/_scala3-reference/metaprogramming/tasty-inspect.md b/_scala3-reference/metaprogramming/tasty-inspect.md deleted file mode 100644 index 32bc2efa43..0000000000 --- a/_scala3-reference/metaprogramming/tasty-inspect.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: "TASTy Inspection" -type: section -num: 33 -previous-page: /scala3/reference/metaprogramming/reflection -next-page: /scala3/reference/other-new-features ---- - -```scala -libraryDependencies += "org.scala-lang" %% "scala3-tasty-inspector" % scalaVersion.value -``` - -TASTy files contain the full typed tree of a class including source positions -and documentation. This is ideal for tools that analyze or extract semantic -information from the code. To avoid the hassle of working directly with the TASTy -file we provide the `Inspector` which loads the contents and exposes it -through the TASTy reflect API. - -## Inspecting TASTy files - -To inspect the trees of a TASTy file a consumer can be defined in the following way. - -```scala -import scala.quoted.* -import scala.tasty.inspector.* - -class MyInspector extends Inspector: - def inspect(using Quotes)(tastys: List[Tasty[quotes.type]]): Unit = - import quotes.reflect.* - for tasty <- tastys do - val tree = tasty.ast - // Do something with the tree -``` - -Then the consumer can be instantiated with the following code to get the tree of the `foo/Bar.tasty` file. - -```scala -object Test: - def main(args: Array[String]): Unit = - val tastyFiles = List("foo/Bar.tasty") - TastyInspector.inspectTastyFiles(tastyFiles)(new MyInspector) -``` - -Note that if we need to run the main (in the example below defined in an object called `Test`) after compilation we need to make the compiler available to the runtime: - -```shell -scalac -d out Test.scala -scala -with-compiler -classpath out Test -``` - -## Template project - -Using sbt version `1.1.5+`, do: - -```shell -sbt new scala/scala3-tasty-inspector.g8 -``` - -in the folder where you want to clone the template. diff --git a/_scala3-reference/new-types.md b/_scala3-reference/new-types.md deleted file mode 100644 index e5d26e9c59..0000000000 --- a/_scala3-reference/new-types.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: New Types -type: chapter -num: 2 -previous-page: /scala3/reference/overview -next-page: /scala3/reference/new-types/intersection-types ---- - -This chapter documents the new types introduced in Scala 3. diff --git a/_scala3-reference/new-types/dependent-function-types-spec.md b/_scala3-reference/new-types/dependent-function-types-spec.md deleted file mode 100644 index 07a07b7428..0000000000 --- a/_scala3-reference/new-types/dependent-function-types-spec.md +++ /dev/null @@ -1,125 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Dependent Function Types - More Details" ---- - -Initial implementation in [PR #3464](https://github.com/lampepfl/dotty/pull/3464). - -## Syntax - -``` -FunArgTypes ::= InfixType - | ‘(’ [ FunArgType {',' FunArgType } ] ‘)’ - | ‘(’ TypedFunParam {',' TypedFunParam } ‘)’ -TypedFunParam ::= id ‘:’ Type -``` - -Dependent function types associate to the right, e.g. -`(s: S) => (t: T) => U` is the same as `(s: S) => ((t: T) => U)`. - -## Implementation - -Dependent function types are shorthands for class types that define `apply` -methods with a dependent result type. Dependent function types desugar to -refinement types of `scala.FunctionN`. A dependent function type -`(x1: K1, ..., xN: KN) => R` of arity `N` translates to: - -```scala -FunctionN[K1, ..., Kn, R']: - def apply(x1: K1, ..., xN: KN): R -``` - -where the result type parameter `R'` is the least upper approximation of the -precise result type `R` without any reference to value parameters `x1, ..., xN`. - -The syntax and semantics of anonymous dependent functions is identical to the -one of regular functions. Eta expansion is naturally generalized to produce -dependent function types for methods with dependent result types. - -Dependent functions can be implicit, and generalize to arity `N > 22` in the -same way that other functions do, see -[the corresponding documentation](../dropped-features/limit22.html). - -## Examples - -The example below defines a trait `C` and the two dependent function types -`DF` and `IDF` and prints the results of the respective function applications: - -[depfuntype.scala]: https://github.com/lampepfl/dotty/blob/master/tests/pos/depfuntype.scala - -```scala -trait C { type M; val m: M } - -type DF = (x: C) => x.M - -type IDF = (x: C) ?=> x.M - -@main def test = - val c = new C { type M = Int; val m = 3 } - - val depfun: DF = (x: C) => x.m - val t = depfun(c) - println(s"t=$t") // prints "t=3" - - val idepfun: IDF = summon[C].m - val u = idepfun(using c) - println(s"u=$u") // prints "u=3" - -``` - -In the following example the depend type `f.Eff` refers to the effect type `CanThrow`: - -[eff-dependent.scala]: https://github.com/lampepfl/dotty/blob/master/tests/run/eff-dependent.scala - -```scala -trait Effect - -// Type X => Y -abstract class Fun[-X, +Y]: - type Eff <: Effect - def apply(x: X): Eff ?=> Y - -class CanThrow extends Effect -class CanIO extends Effect - -given ct: CanThrow = new CanThrow -given ci: CanIO = new CanIO - -class I2S extends Fun[Int, String]: - type Eff = CanThrow - def apply(x: Int) = x.toString - -class S2I extends Fun[String, Int]: - type Eff = CanIO - def apply(x: String) = x.length - -// def map(f: A => B)(xs: List[A]): List[B] -def map[A, B](f: Fun[A, B])(xs: List[A]): f.Eff ?=> List[B] = - xs.map(f.apply) - -// def mapFn[A, B]: (A => B) -> List[A] -> List[B] -def mapFn[A, B]: (f: Fun[A, B]) => List[A] => f.Eff ?=> List[B] = - f => xs => map(f)(xs) - -// def compose(f: A => B)(g: B => C)(x: A): C -def compose[A, B, C](f: Fun[A, B])(g: Fun[B, C])(x: A): - f.Eff ?=> g.Eff ?=> C = - g(f(x)) - -// def composeFn: (A => B) -> (B => C) -> A -> C -def composeFn[A, B, C]: - (f: Fun[A, B]) => (g: Fun[B, C]) => A => f.Eff ?=> g.Eff ?=> C = - f => g => x => compose(f)(g)(x) - -@main def test = - val i2s = new I2S - val s2i = new S2I - - assert(mapFn(i2s)(List(1, 2, 3)).mkString == "123") - assert(composeFn(i2s)(s2i)(22) == 2) -``` - -### Type Checking - -After desugaring no additional typing rules are required for dependent function types. diff --git a/_scala3-reference/new-types/dependent-function-types.md b/_scala3-reference/new-types/dependent-function-types.md deleted file mode 100644 index ffa9012c4a..0000000000 --- a/_scala3-reference/new-types/dependent-function-types.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: "Dependent Function Types" -type: section -num: 7 -previous-page: /scala3/reference/new-types/match-types -next-page: /scala3/reference/new-types/polymorphic-function-types ---- - -A dependent function type is a function type whose result depends -on the function's parameters. For example: - -```scala -trait Entry { type Key; val key: Key } - -def extractKey(e: Entry): e.Key = e.key // a dependent method - -val extractor: (e: Entry) => e.Key = extractKey // a dependent function value -// ^^^^^^^^^^^^^^^^^^^ -// a dependent function type -``` - -Scala already has _dependent methods_, i.e. methods where the result -type refers to some of the parameters of the method. Method -`extractKey` is an example. Its result type, `e.Key` refers to its -parameter `e` (we also say, `e.Key` _depends_ on `e`). But so far it -was not possible to turn such methods into function values, so that -they can be passed as parameters to other functions, or returned as -results. Dependent methods could not be turned into functions simply -because there was no type that could describe them. - -In Scala 3 this is now possible. The type of the `extractor` value above is - -```scala -(e: Entry) => e.Key -``` - -This type describes function values that take any argument `e` of type -`Entry` and return a result of type `e.Key`. - -Recall that a normal function type `A => B` is represented as an -instance of the [`Function1` trait](https://scala-lang.org/api/3.x/scala/Function1.html) -(i.e. `Function1[A, B]`) and analogously for functions with more parameters. Dependent functions -are also represented as instances of these traits, but they get an additional -refinement. In fact, the dependent function type above is just syntactic sugar for - -```scala -Function1[Entry, Entry#Key]: - def apply(e: Entry): e.Key -``` - -[More details](./dependent-function-types-spec.html) diff --git a/_scala3-reference/new-types/intersection-types-spec.md b/_scala3-reference/new-types/intersection-types-spec.md deleted file mode 100644 index aeceeac048..0000000000 --- a/_scala3-reference/new-types/intersection-types-spec.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Intersection Types - More Details" ---- - -## Syntax - -Syntactically, the type `S & T` is an infix type, where the infix operator is `&`. -The operator `&` is a normal identifier -with the usual precedence and subject to usual resolving rules. -Unless shadowed by another definition, it resolves to the type `scala.&`, -which acts as a type alias to an internal representation of intersection types. - -``` -Type ::= ...| InfixType -InfixType ::= RefinedType {id [nl] RefinedType} -``` - -## Subtyping Rules - -``` -T <: A T <: B ----------------- - T <: A & B - - A <: T ----------------- - A & B <: T - - B <: T ----------------- - A & B <: T -``` - -From the rules above, we can show that `&` is _commutative_: `A & B <: B & A` for any type `A` and `B`. - -``` - B <: B A <: A ----------- ----------- -A & B <: B A & B <: A ---------------------------- - A & B <: B & A -``` - -In another word, `A & B` is the same type as `B & A`, in the sense that the two types -have the same values and are subtypes of each other. - -If `C` is a type constructor, then `C[A] & C[B]` can be simplified using the following three rules: - -- If `C` is covariant, `C[A] & C[B] ~> C[A & B]` -- If `C` is contravariant, `C[A] & C[B] ~> C[A | B]` -- If `C` is non-variant, emit a compile error - -When `C` is covariant, `C[A & B] <: C[A] & C[B]` can be derived: - -``` - A <: A B <: B - ---------- --------- - A & B <: A A & B <: B ---------------- ----------------- -C[A & B] <: C[A] C[A & B] <: C[B] ------------------------------------------- - C[A & B] <: C[A] & C[B] -``` - -When `C` is contravariant, `C[A | B] <: C[A] & C[B]` can be derived: - -``` - A <: A B <: B - ---------- --------- - A <: A | B B <: A | B -------------------- ---------------- -C[A | B] <: C[A] C[A | B] <: C[B] --------------------------------------------------- - C[A | B] <: C[A] & C[B] -``` - -## Erasure - -The erased type for `S & T` is the erased _glb_ (greatest lower bound) of the -erased type of `S` and `T`. The rules for erasure of intersection types are given -below in pseudocode: - -``` -|S & T| = glb(|S|, |T|) - -glb(JArray(A), JArray(B)) = JArray(glb(A, B)) -glb(JArray(T), _) = JArray(T) -glb(_, JArray(T)) = JArray(T) -glb(A, B) = A if A extends B -glb(A, B) = B if B extends A -glb(A, _) = A if A is not a trait -glb(_, B) = B if B is not a trait -glb(A, _) = A // use first -``` - -In the above, `|T|` means the erased type of `T`, `JArray` refers to -the type of Java Array. - -See also: [`TypeErasure#erasedGlb`](https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/TypeErasure.scala#L289). - -## Relationship with Compound Type (`with`) - -Intersection types `A & B` replace compound types `A with B` in Scala 2. For the -moment, the syntax `A with B` is still allowed and interpreted as `A & B`, but -its usage as a type (as opposed to in a `new` or `extends` clause) will be -deprecated and removed in the future. diff --git a/_scala3-reference/new-types/intersection-types.md b/_scala3-reference/new-types/intersection-types.md deleted file mode 100644 index e912ec6994..0000000000 --- a/_scala3-reference/new-types/intersection-types.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Intersection Types -type: section -num: 3 -previous-page: /scala3/reference/new-types -next-page: /scala3/reference/new-types/union-types ---- - -Used on types, the `&` operator creates an intersection type. - -## Type Checking - -The type `S & T` represents values that are of the type `S` and `T` at the same time. - -```scala -trait Resettable: - def reset(): Unit - -trait Growable[T]: - def add(t: T): Unit - -def f(x: Resettable & Growable[String]) = - x.reset() - x.add("first") -``` - -The parameter `x` is required to be _both_ a `Resettable` and a -`Growable[String]`. - -The members of an intersection type `A & B` are all the members of `A` and all -the members of `B`. For instance `Resettable & Growable[String]` -has member methods `reset` and `add`. - -`&` is _commutative_: `A & B` is the same type as `B & A`. - -If a member appears in both `A` and `B`, its type in `A & B` is the intersection -of its type in `A` and its type in `B`. For instance, assume the definitions: - -```scala -trait A: - def children: List[A] - -trait B: - def children: List[B] - -val x: A & B = new C -val ys: List[A & B] = x.children -``` - -The type of `children` in `A & B` is the intersection of `children`'s -type in `A` and its type in `B`, which is `List[A] & List[B]`. This -can be further simplified to `List[A & B]` because `List` is -covariant. - -One might wonder how the compiler could come up with a definition for -`children` of type `List[A & B]` since what is given are `children` -definitions of type `List[A]` and `List[B]`. The answer is the compiler does not -need to. `A & B` is just a type that represents a set of requirements for -values of the type. At the point where a value is _constructed_, one -must make sure that all inherited members are correctly defined. -So if one defines a class `C` that inherits `A` and `B`, one needs -to give at that point a definition of a `children` method with the required type. - -```scala -class C extends A, B: - def children: List[A & B] = ??? -``` - - -[More details](./intersection-types-spec.html) diff --git a/_scala3-reference/new-types/match-types.md b/_scala3-reference/new-types/match-types.md deleted file mode 100644 index 70d34ff416..0000000000 --- a/_scala3-reference/new-types/match-types.md +++ /dev/null @@ -1,247 +0,0 @@ ---- -title: "Match Types" -type: section -num: 6 -previous-page: /scala3/reference/new-types/type-lambdas -next-page: /scala3/reference/new-types/dependent-function-types ---- - -A match type reduces to one of its right-hand sides, depending on the type of -its scrutinee. For example: - -```scala -type Elem[X] = X match - case String => Char - case Array[t] => t - case Iterable[t] => t -``` - -This defines a type that reduces as follows: - -```scala -Elem[String] =:= Char -Elem[Array[Int]] =:= Int -Elem[List[Float]] =:= Float -Elem[Nil.type] =:= Nothing -``` - -Here `=:=` is understood to mean that left and right-hand sides are mutually -subtypes of each other. - -In general, a match type is of the form - -```scala -S match { P1 => T1 ... Pn => Tn } -``` - -where `S`, `T1`, ..., `Tn` are types and `P1`, ..., `Pn` are type patterns. Type -variables in patterns start with a lower case letter, as usual. - -Match types can form part of recursive type definitions. Example: - -```scala -type LeafElem[X] = X match - case String => Char - case Array[t] => LeafElem[t] - case Iterable[t] => LeafElem[t] - case AnyVal => X -``` - -Recursive match type definitions can also be given an upper bound, like this: - -```scala -type Concat[Xs <: Tuple, +Ys <: Tuple] <: Tuple = Xs match - case EmptyTuple => Ys - case x *: xs => x *: Concat[xs, Ys] -``` - -In this definition, every instance of `Concat[A, B]`, whether reducible or not, -is known to be a subtype of `Tuple`. This is necessary to make the recursive -invocation `x *: Concat[xs, Ys]` type check, since `*:` demands a `Tuple` as its -right operand. - -## Dependent Typing - -Match types can be used to define dependently typed methods. For instance, here -is the value level counterpart to the `LeafElem` type defined above (note the -use of the match type as the return type): - -```scala -def leafElem[X](x: X): LeafElem[X] = x match - case x: String => x.charAt(0) - case x: Array[t] => leafElem(x(0)) - case x: Iterable[t] => leafElem(x.head) - case x: AnyVal => x -``` - -This special mode of typing for match expressions is only used when the -following conditions are met: - -1. The match expression patterns do not have guards -2. The match expression scrutinee's type is a subtype of the match type - scrutinee's type -3. The match expression and the match type have the same number of cases -4. The match expression patterns are all [Typed Patterns](https://scala-lang.org/files/archive/spec/2.13/08-pattern-matching.html#typed-patterns), - and these types are `=:=` to their corresponding type patterns in the match - type - -## Representation of Match Types - -The internal representation of a match type -``` -S match { P1 => T1 ... Pn => Tn } -``` -is `Match(S, C1, ..., Cn) <: B` where each case `Ci` is of the form -``` -[Xs] =>> P => T -``` - -Here, `[Xs]` is a type parameter clause of the variables bound in pattern `Pi`. -If there are no bound type variables in a case, the type parameter clause is -omitted and only the function type `P => T` is kept. So each case is either a -unary function type or a type lambda over a unary function type. - -`B` is the declared upper bound of the match type, or `Any` if no such bound is -given. We will leave it out in places where it does not matter for the -discussion. The scrutinee, bound, and pattern types must all be first-order -types. - -## Match Type Reduction - -Match type reduction follows the semantics of match expressions, that is, a -match type of the form `S match { P1 => T1 ... Pn => Tn }` reduces to `Ti` if -and only if `s: S match { _: P1 => T1 ... _: Pn => Tn }` evaluates to a value of -type `Ti` for all `s: S`. - -The compiler implements the following reduction algorithm: - -- If the scrutinee type `S` is an empty set of values (such as `Nothing` or - `String & Int`), do not reduce. -- Sequentially consider each pattern `Pi` - - If `S <: Pi` reduce to `Ti`. - - Otherwise, try constructing a proof that `S` and `Pi` are disjoint, or, in - other words, that no value `s` of type `S` is also of type `Pi`. - - If such proof is found, proceed to the next case (`Pi+1`), otherwise, do - not reduce. - -Disjointness proofs rely on the following properties of Scala types: - -1. Single inheritance of classes -2. Final classes cannot be extended -3. Constant types with distinct values are nonintersecting -4. Singleton paths to distinct values are nonintersecting, such as `object` definitions or singleton enum cases. - -Type parameters in patterns are minimally instantiated when computing `S <: Pi`. -An instantiation `Is` is _minimal_ for `Xs` if all type variables in `Xs` that -appear covariantly and nonvariantly in `Is` are as small as possible and all -type variables in `Xs` that appear contravariantly in `Is` are as large as -possible. Here, "small" and "large" are understood with respect to `<:`. - -For simplicity, we have omitted constraint handling so far. The full formulation -of subtyping tests describes them as a function from a constraint and a pair of -types to either _success_ and a new constraint or _failure_. In the context of -reduction, the subtyping test `S <: [Xs := Is] P` is understood to leave the -bounds of all variables in the input constraint unchanged, i.e. existing -variables in the constraint cannot be instantiated by matching the scrutinee -against the patterns. - -## Subtyping Rules for Match Types - -The following rules apply to match types. For simplicity, we omit environments -and constraints. - -1. The first rule is a structural comparison between two match types: - - ``` - S match { P1 => T1 ... Pm => Tm } <: T match { Q1 => U1 ... Qn => Un } - ``` - - if - - ``` - S =:= T, m >= n, Pi =:= Qi and Ti <: Ui for i in 1..n - ``` - - I.e. scrutinees and patterns must be equal and the corresponding bodies must - be subtypes. No case re-ordering is allowed, but the subtype can have more - cases than the supertype. - -2. The second rule states that a match type and its redux are mutual subtypes. - - ``` - S match { P1 => T1 ... Pn => Tn } <: U - U <: S match { P1 => T1 ... Pn => Tn } - ``` - - if - - `S match { P1 => T1 ... Pn => Tn }` reduces to `U` - -3. The third rule states that a match type conforms to its upper bound: - - ``` - (S match { P1 => T1 ... Pn => Tn } <: B) <: B - ``` - -## Termination - -Match type definitions can be recursive, which means that it's possible to run -into an infinite loop while reducing match types. - -Since reduction is linked to subtyping, we already have a cycle detection -mechanism in place. As a result, the following will already give a reasonable -error message: - -```scala -type L[X] = X match - case Int => L[X] - -def g[X]: L[X] = ??? -``` - -```scala - | val x: Int = g[Int] - | ^ - |Recursion limit exceeded. - |Maybe there is an illegal cyclic reference? - |If that's not the case, you could also try to - |increase the stacksize using the -Xss JVM option. - |A recurring operation is (inner to outer): - | - | subtype LazyRef(Test.L[Int]) <:< Int -``` - -Internally, the Scala compiler detects these cycles by turning selected stack overflows into -type errors. If there is a stack overflow during subtyping, the exception will -be caught and turned into a compile-time error that indicates a trace of the -subtype tests that caused the overflow without showing a full stack trace. - -## Variance Laws for Match Types - -**Note:** This section does not reflect the current implementation. - -Within a match type `Match(S, Cs) <: B`, all occurrences of type variables count -as covariant. By the nature of the cases `Ci` this means that occurrences in -pattern position are contravariant (since patterns are represented as function -type arguments). - -## Related Work - -Match types have similarities with -[closed type families](https://wiki.haskell.org/GHC/Type_families) in Haskell. -Some differences are: - -- Subtyping instead of type equalities. -- Match type reduction does not tighten the underlying constraint, whereas type - family reduction does unify. This difference in approach mirrors the - difference between local type inference in Scala and global type inference in - Haskell. - -Match types are also similar to Typescript's -[conditional types](https://github.com/Microsoft/TypeScript/pull/21316). The -main differences here are: - - - Conditional types only reduce if both the scrutinee and pattern are ground, - whereas match types also work for type parameters and abstract types. - - Match types support direct recursion. - - Conditional types distribute through union types. diff --git a/_scala3-reference/new-types/polymorphic-function-types.md b/_scala3-reference/new-types/polymorphic-function-types.md deleted file mode 100644 index 58224ef0de..0000000000 --- a/_scala3-reference/new-types/polymorphic-function-types.md +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: "Polymorphic Function Types" -type: section -num: 8 -previous-page: /scala3/reference/new-types/dependent-function-types -next-page: /scala3/reference/enums ---- - -A polymorphic function type is a function type which accepts type parameters. -For example: - -```scala -// A polymorphic method: -def foo[A](xs: List[A]): List[A] = xs.reverse - -// A polymorphic function value: -val bar: [A] => List[A] => List[A] -// ^^^^^^^^^^^^^^^^^^^^^^^^^ -// a polymorphic function type - = [A] => (xs: List[A]) => foo[A](xs) -``` - -Scala already has _polymorphic methods_, i.e. methods which accepts type parameters. -Method `foo` above is an example, accepting a type parameter `A`. -So far, it -was not possible to turn such methods into polymorphic function values like `bar` above, -which can be passed as parameters to other functions, or returned as results. - -In Scala 3 this is now possible. The type of the `bar` value above is - -```scala -[A] => List[A] => List[A] -``` - -This type describes function values which take a type `A` as a parameter, -then take a list of type `List[A]`, and return a list of the same type `List[A]`. - -[More details](https://github.com/lampepfl/dotty/pull/4672) - - -## Example Usage - -Polymorphic function type are particularly useful -when callers of a method are required to provide a -function which has to be polymorphic, -meaning that it should accept arbitrary types as part of its inputs. - -For instance, consider the situation where we have -a data type to represent the expressions of a simple language -(consisting only of variables and function applications) -in a strongly-typed way: - -```scala -enum Expr[A]: - case Var(name: String) - case Apply[A, B](fun: Expr[B => A], arg: Expr[B]) extends Expr[A] -``` - -We would like to provide a way for users to map a function -over all immediate subexpressions of a given `Expr`. -This requires the given function to be polymorphic, -since each subexpression may have a different type. -Here is how to implement this using polymorphic function types: - -```scala -def mapSubexpressions[A](e: Expr[A])(f: [B] => Expr[B] => Expr[B]): Expr[A] = - e match - case Apply(fun, arg) => Apply(f(fun), f(arg)) - case Var(n) => Var(n) -``` - -And here is how to use this function to _wrap_ each subexpression -in a given expression with a call to some `wrap` function, -defined as a variable: - -```scala -val e0 = Apply(Var("f"), Var("a")) -val e1 = mapSubexpressions(e0)( - [B] => (se: Expr[B]) => Apply(Var[B => B]("wrap"), se)) -println(e1) // Apply(Apply(Var(wrap),Var(f)),Apply(Var(wrap),Var(a))) -``` - -## Relationship With Type Lambdas - -Polymorphic function types are not to be confused with -[_type lambdas_](type-lambdas.html). -While the former describes the _type_ of a polymorphic _value_, -the latter is an actual function value _at the type level_. - -A good way of understanding the difference is to notice that -**_type lambdas are applied in types, -whereas polymorphic functions are applied in terms_**: -One would call the function `bar` above -by passing it a type argument `bar[Int]` _within a method body_. -On the other hand, given a type lambda such as `type F = [A] =>> List[A]`, -one would call `F` _within a type expression_, as in `type Bar = F[Int]`. diff --git a/_scala3-reference/new-types/type-lambdas-spec.md b/_scala3-reference/new-types/type-lambdas-spec.md deleted file mode 100644 index 06bd314512..0000000000 --- a/_scala3-reference/new-types/type-lambdas-spec.md +++ /dev/null @@ -1,119 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Type Lambdas - More Details" ---- - -## Syntax - -``` -Type ::= ... | TypeParamClause ‘=>>’ Type -TypeParamClause ::= ‘[’ TypeParam {‘,’ TypeParam} ‘]’ -TypeParam ::= {Annotation} (id [HkTypeParamClause] | ‘_’) TypeBounds -TypeBounds ::= [‘>:’ Type] [‘<:’ Type] -``` - -### Type Checking - -A type lambda such as `[X] =>> F[X]` defines a function from types to types. The parameter(s) may carry bounds. -If a parameter is bounded, as in `[X >: L <: U] =>> F[X]` it is checked that arguments to the parameters conform to the bounds `L` and `U`. -Only the upper bound `U` can be F-bounded, i.e. `X` can appear in it. - -## Subtyping Rules - -Assume two type lambdas -```scala -type TL1 = [X >: L1 <: U1] =>> R1 -type TL2 = [X >: L2 <: U2] =>> R2 -``` -Then `TL1 <: TL2`, if - - - the type interval `L2..U2` is contained in the type interval `L1..U1` (i.e. -`L1 <: L2` and `U2 <: U1`), - - `R1 <: R2` - -Here we have relied on [alpha renaming](https://en.wikipedia.org/wiki/Lambda_calculus#%CE%B1-conversion) to match the two bound types `X`. - -A partially applied type constructor such as `List` is assumed to be equivalent to -its eta expansion. I.e, `List = [X] =>> List[X]`. This allows type constructors to be compared with type lambdas. - -## Relationship with Parameterized Type Definitions - -A parameterized type definition -```scala -type T[X] = R -``` -is regarded as a shorthand for an unparameterized definition with a type lambda as right-hand side: -```scala -type T = [X] =>> R -``` -If the type definition carries `+` or `-` variance annotations, -it is checked that the variance annotations are satisfied by the type lambda. -For instance, -```scala -type F2[A, +B] = A => B -``` -expands to -```scala -type F2 = [A, B] =>> A => B -``` -and at the same time it is checked that the parameter `B` appears covariantly in `A => B`. - -A parameterized abstract type -```scala -type T[X] >: L <: U -``` -is regarded as shorthand for an unparameterized abstract type with type lambdas as bounds. -```scala -type T >: ([X] =>> L) <: ([X] =>> U) -``` -However, if `L` is `Nothing` it is not parameterized, since `Nothing` is treated as a bottom type for all kinds. For instance, -```scala -type T[X] <: X => X -``` -is expanded to -```scala -type T >: Nothing <: ([X] =>> X => X) -``` -instead of -```scala -type T >: ([X] =>> Nothing) <: ([X] =>> X => X) -``` - -The same expansions apply to type parameters. For instance, -```scala -[F[X] <: Coll[X]] -``` -is treated as a shorthand for -```scala -[F >: Nothing <: [X] =>> Coll[X]] -``` -Abstract types and opaque type aliases remember the variances they were created with. So the type -```scala -type F2[-A, +B] -``` -is known to be contravariant in `A` and covariant in `B` and can be instantiated only -with types that satisfy these constraints. Likewise -```scala -opaque type O[X] = List[X] -``` -`O` is known to be invariant (and not covariant, as its right-hand side would suggest). On the other hand, a transparent alias -```scala -type O2[X] = List[X] -``` -would be treated as covariant, `X` is used covariantly on its right-hand side. - -**Note**: The decision to treat `Nothing` as universal bottom type is provisional, and might be changed after further discussion. - -**Note**: Scala 2 and 3 differ in that Scala 2 also treats `Any` as universal top-type. This is not done in Scala 3. See also the discussion on [kind polymorphism](../other-new-features/kind-polymorphism.html) - -## Curried Type Parameters - -The body of a type lambda can again be a type lambda. Example: -```scala -type TL = [X] =>> [Y] =>> (X, Y) -``` -Currently, no special provision is made to infer type arguments to such curried type lambdas. This is left for future work. - - - diff --git a/_scala3-reference/new-types/type-lambdas.md b/_scala3-reference/new-types/type-lambdas.md deleted file mode 100644 index 8b12fbcece..0000000000 --- a/_scala3-reference/new-types/type-lambdas.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: "Type Lambdas" -type: section -num: 5 -previous-page: /scala3/reference/new-types/union-types -next-page: /scala3/reference/new-types/match-types ---- - -A _type lambda_ lets one express a higher-kinded type directly, without -a type definition. - -```scala -[X, Y] =>> Map[Y, X] -``` - -For instance, the type above defines a binary type constructor, which maps arguments `X` and `Y` to `Map[Y, X]`. -Type parameters of type lambdas can have bounds, but they cannot carry `+` or `-` variance annotations. - -[More details](./type-lambdas-spec.html) diff --git a/_scala3-reference/new-types/union-types-spec.md b/_scala3-reference/new-types/union-types-spec.md deleted file mode 100644 index 9cfa27f619..0000000000 --- a/_scala3-reference/new-types/union-types-spec.md +++ /dev/null @@ -1,172 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Union Types - More Details" ---- - -## Syntax - -Syntactically, unions follow the same rules as intersections, but have a lower precedence, see -[Intersection Types - More Details](./intersection-types-spec.html). - -### Interaction with pattern matching syntax -`|` is also used in pattern matching to separate pattern alternatives and has -lower precedence than `:` as used in typed patterns, this means that: - -```scala -case _: A | B => ... -``` - -is still equivalent to: - -```scala -case (_: A) | B => ... -``` - -and not to: - -```scala -case _: (A | B) => ... -``` - -## Subtyping Rules - -- `A` is always a subtype of `A | B` for all `A`, `B`. -- If `A <: C` and `B <: C` then `A | B <: C` -- Like `&`, `|` is commutative and associative: - - ```scala - A | B =:= B | A - A | (B | C) =:= (A | B) | C - ``` - -- `&` is distributive over `|`: - - ```scala - A & (B | C) =:= A & B | A & C - ``` - -From these rules it follows that the _least upper bound_ (LUB) of a set of types -is the union of these types. This replaces the -[definition of least upper bound in the Scala 2 specification](https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#least-upper-bounds-and-greatest-lower-bounds). - -## Motivation - -The primary reason for introducing union types in Scala is that they allow us to -guarantee that for every set of types, we can always form a finite LUB. This is -both useful in practice (infinite LUBs in Scala 2 were approximated in an ad-hoc -way, resulting in imprecise and sometimes incredibly long types) and in theory -(the type system of Scala 3 is based on the -[DOT calculus](https://infoscience.epfl.ch/record/227176/files/soundness_oopsla16.pdf), -which has union types). - -Additionally, union types are a useful construct when trying to give types to existing -dynamically typed APIs, this is why they're [an integral part of TypeScript](https://www.typescriptlang.org/docs/handbook/advanced-types.html#union-types) -and have even been [partially implemented in Scala.js](https://github.com/scala-js/scala-js/blob/master/library/src/main/scala/scala/scalajs/js/Union.scala). - -## Join of a union type - -In some situation described below, a union type might need to be widened to -a non-union type, for this purpose we define the _join_ of a union type `T1 | -... | Tn` as the smallest intersection type of base class instances of -`T1`,...,`Tn`. Note that union types might still appear as type arguments in the -resulting type, this guarantees that the join is always finite. - -### Example - -Given - -```scala -trait C[+T] -trait D -trait E -class A extends C[A] with D -class B extends C[B] with D with E -``` - -The join of `A | B` is `C[A | B] & D` - -## Type inference - -When inferring the result type of a definition (`val`, `var`, or `def`) and the -type we are about to infer is a union type, then we replace it by its join. -Similarly, when instantiating a type argument, if the corresponding type -parameter is not upper-bounded by a union type and the type we are about to -instantiate is a union type, we replace it by its join. This mirrors the -treatment of singleton types which are also widened to their underlying type -unless explicitly specified. The motivation is the same: inferring types -which are "too precise" can lead to unintuitive typechecking issues later on. - -**Note:** Since this behavior limits the usability of union types, it might -be changed in the future. For example by not widening unions that have been -explicitly written down by the user and not inferred, or by not widening a type -argument when the corresponding type parameter is covariant. - -See [PR #2330](https://github.com/lampepfl/dotty/pull/2330) and -[Issue #4867](https://github.com/lampepfl/dotty/issues/4867) for further discussions. - -### Example - -```scala -import scala.collection.mutable.ListBuffer -val x = ListBuffer(Right("foo"), Left(0)) -val y: ListBuffer[Either[Int, String]] = x -``` - -This code typechecks because the inferred type argument to `ListBuffer` in the -right-hand side of `x` was `Left[Int, Nothing] | Right[Nothing, String]` which -was widened to `Either[Int, String]`. If the compiler hadn't done this widening, -the last line wouldn't typecheck because `ListBuffer` is invariant in its -argument. - - -## Members - -The members of a union type are the members of its join. - -### Example - -The following code does not typecheck, because method `hello` is not a member of -`AnyRef` which is the join of `A | B`. - -```scala -trait A { def hello: String } -trait B { def hello: String } - -def test(x: A | B) = x.hello // error: value `hello` is not a member of A | B -``` - -On the other hand, the following would be allowed - -```scala -trait C { def hello: String } -trait A extends C with D -trait B extends C with E - -def test(x: A | B) = x.hello // ok as `hello` is a member of the join of A | B which is C -``` - -## Exhaustivity checking - -If the selector of a pattern match is a union type, the match is considered -exhaustive if all parts of the union are covered. - -## Erasure - -The erased type for `A | B` is the _erased least upper bound_ of the erased -types of `A` and `B`. Quoting from the documentation of `TypeErasure#erasedLub`, -the erased LUB is computed as follows: - -- if both argument are arrays of objects, an array of the erased LUB of the element types -- if both arguments are arrays of same primitives, an array of this primitive -- if one argument is array of primitives and the other is array of objects, - [`Object`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html) -- if one argument is an array, [`Object`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html) -- otherwise a common superclass or trait S of the argument classes, with the - following two properties: - * S is minimal: no other common superclass or trait derives from S - * S is last : in the linearization of the first argument type `|A|` - there are no minimal common superclasses or traits that - come after S. - The reason to pick last is that we prefer classes over traits that way, - which leads to more predictable bytecode and (?) faster dynamic dispatch. diff --git a/_scala3-reference/new-types/union-types.md b/_scala3-reference/new-types/union-types.md deleted file mode 100644 index 0d3df4645d..0000000000 --- a/_scala3-reference/new-types/union-types.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "Union Types" -type: section -num: 4 -previous-page: /scala3/reference/new-types/intersection-types -next-page: /scala3/reference/new-types/type-lambdas ---- - -A union type `A | B` has as values all values of type `A` and also all values of type `B`. - - -```scala -case class UserName(name: String) -case class Password(hash: Hash) - -def help(id: UserName | Password) = - val user = id match - case UserName(name) => lookupName(name) - case Password(hash) => lookupPassword(hash) - ... -``` - -Union types are duals of intersection types. `|` is _commutative_: -`A | B` is the same type as `B | A`. - -The compiler will assign a union type to an expression only if such a -type is explicitly given. This can be seen in the following [REPL](https://docs.scala-lang.org/overviews/repl/overview.html) transcript: - -```scala -scala> val password = Password(123) -val password: Password = Password(123) - -scala> val name = UserName("Eve") -val name: UserName = UserName(Eve) - -scala> if true then name else password -val res2: Object = UserName(Eve) - -scala> val either: Password | UserName = if true then name else password -val either: Password | UserName = UserName(Eve) -``` - -The type of `res2` is `Object & Product`, which is a supertype of -`UserName` and `Password`, but not the least supertype `Password | -UserName`. If we want the least supertype, we have to give it -explicitly, as is done for the type of `either`. - -[More details](./union-types-spec.html) diff --git a/_scala3-reference/other-new-features.md b/_scala3-reference/other-new-features.md deleted file mode 100644 index faa2aefc6a..0000000000 --- a/_scala3-reference/other-new-features.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: "Other New Features" -type: chapter -num: 34 -previous-page: /scala3/reference/metaprogramming/tasty-inspect -next-page: /scala3/reference/other-new-features/trait-parameters ---- - -The following pages document new features of Scala 3. diff --git a/_scala3-reference/other-new-features/control-syntax.md b/_scala3-reference/other-new-features/control-syntax.md deleted file mode 100644 index 0fefba262b..0000000000 --- a/_scala3-reference/other-new-features/control-syntax.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: New Control Syntax -type: section -num: 46 -previous-page: /scala3/reference/other-new-features/targetName -next-page: /scala3/reference/other-new-features/indentation ---- - -Scala 3 has a new "quiet" syntax for control expressions that does not rely on -enclosing the condition in parentheses, and also allows to drop parentheses or braces -around the generators of a `for`-expression. Examples: -```scala -if x < 0 then - "negative" -else if x == 0 then - "zero" -else - "positive" - -if x < 0 then -x else x - -while x >= 0 do x = f(x) - -for x <- xs if x > 0 -yield x * x - -for - x <- xs - y <- ys -do - println(x + y) - -try body -catch case ex: IOException => handle -``` - -The rules in detail are: - - - The condition of an `if`-expression can be written without enclosing parentheses if it is followed by a `then`. - - The condition of a `while`-loop can be written without enclosing parentheses if it is followed by a `do`. - - The enumerators of a `for`-expression can be written without enclosing parentheses or braces if they are followed by a `yield` or `do`. - - A `do` in a `for`-expression expresses a `for`-loop. - - A `catch` can be followed by a single case on the same line. - If there are multiple cases, these have to appear within braces (just like in Scala 2) - or an indented block. -### Rewrites - -The Scala 3 compiler can rewrite source code from old syntax to new syntax and back. -When invoked with options `-rewrite -new-syntax` it will rewrite from old to new syntax, dropping parentheses and braces in conditions and enumerators. When invoked with options `-rewrite -old-syntax` it will rewrite in the reverse direction, inserting parentheses and braces as needed. diff --git a/_scala3-reference/other-new-features/creator-applications.md b/_scala3-reference/other-new-features/creator-applications.md deleted file mode 100644 index 0422bbfac7..0000000000 --- a/_scala3-reference/other-new-features/creator-applications.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: "Universal Apply Methods" -type: section -num: 37 -previous-page: /scala3/reference/other-new-features/transparent-traits -next-page: /scala3/reference/other-new-features/export ---- - -Scala case classes generate apply methods, so that values of case classes can be created using simple -function application, without needing to write `new`. - -Scala 3 generalizes this scheme to all concrete classes. Example: - -```scala -class StringBuilder(s: String): - def this() = this("") - -StringBuilder("abc") // old: new StringBuilder("abc") -StringBuilder() // old: new StringBuilder() -``` - -This works since a companion object with two `apply` methods -is generated together with the class. The object looks like this: - -```scala -object StringBuilder: - inline def apply(s: String): StringBuilder = new StringBuilder(s) - inline def apply(): StringBuilder = new StringBuilder() -``` - -The synthetic object `StringBuilder` and its `apply` methods are called _constructor proxies_. -Constructor proxies are generated even for Java classes and classes coming from Scala 2. -The precise rules are as follows: - - 1. A constructor proxy companion object `object C` is created for a concrete class `C`, - provided the class does not have already a companion, and there is also no other value - or method named `C` defined or inherited in the scope where `C` is defined. - - 2. Constructor proxy `apply` methods are generated for a concrete class provided - - - the class has a companion object (which might have been generated in step 1), and - - that companion object does not already define a member named `apply`. - - Each generated `apply` method forwards to one constructor of the class. It has the - same type and value parameters as the constructor. - -Constructor proxy companions cannot be used as values by themselves. A proxy companion object must -be selected with `apply` (or be applied to arguments, in which case the `apply` is implicitly -inserted). - -Constructor proxies are also not allowed to shadow normal definitions. That is, -if an identifier resolves to a constructor proxy, and the same identifier is also -defined or imported in some other scope, an ambiguity is reported. - -### Motivation - -Leaving out `new` hides an implementation detail and makes code more pleasant to read. Even though -it requires a new rule, it will likely increase the perceived regularity of the language, since case -classes already provide function call creation syntax (and are often defined for this reason alone). diff --git a/_scala3-reference/other-new-features/explicit-nulls.md b/_scala3-reference/other-new-features/explicit-nulls.md deleted file mode 100644 index d33d86c931..0000000000 --- a/_scala3-reference/other-new-features/explicit-nulls.md +++ /dev/null @@ -1,540 +0,0 @@ ---- -title: "Explicit Nulls" -type: section -num: 48 -previous-page: /scala3/reference/other-new-features/indentation -next-page: /scala3/reference/other-new-features/safe-initialization ---- - -Explicit nulls is an opt-in feature that modifies the Scala type system, which makes reference types -(anything that extends `AnyRef`) _non-nullable_. - -This means the following code will no longer typecheck: - -```scala -val x: String = null // error: found `Null`, but required `String` -``` - -Instead, to mark a type as nullable we use a [union type](../new-types/union-types.html) - -```scala -val x: String | Null = null // ok -``` - -A nullable type could have null value during runtime; hence, it is not safe to select a member without checking its nullity. - -```scala -x.trim // error: trim is not member of String | Null -``` - -Explicit nulls are enabled via a `-Yexplicit-nulls` flag. - -Read on for details. - -## New Type Hierarchy - -When explicit nulls are enabled, the type hierarchy changes so that `Null` is only a subtype of -`Any`, as opposed to every reference type, which means `null` is no longer a value of `AnyRef` and its subtypes. - -This is the new type hierarchy: - -!["Type Hierarchy for Explicit Nulls"](/resources/images/scala3/explicit-nulls/explicit-nulls-type-hierarchy.png) - -After erasure, `Null` remains a subtype of all reference types (as forced by the JVM). - -## Working with `Null` - -To make working with nullable values easier, we propose adding a few utilities to the standard library. -So far, we have found the following useful: - -- An extension method `.nn` to "cast away" nullability - - ```scala - extension [T](x: T | Null) - inline def nn: T = - assert(x != null) - x.asInstanceOf[T] - ``` - - This means that given `x: String | Null`, `x.nn` has type `String`, so we can call all the - usual methods on it. Of course, `x.nn` will throw a NPE if `x` is `null`. - - Don't use `.nn` on mutable variables directly, because it may introduce an unknown type into the type of the variable. - -- An `unsafeNulls` language feature. - - When imported, `T | Null` can be used as `T`, similar to regular Scala (without explicit nulls). - - See [UnsafeNulls](#unsafenulls) section for more details. - -## Unsoundness - -The new type system is unsound with respect to `null`. This means there are still instances where an expression has a non-nullable type like `String`, but its value is actually `null`. - -The unsoundness happens because uninitialized fields in a class start out as `null`: - -```scala -class C: - val f: String = foo(f) - def foo(f2: String): String = f2 - -val c = new C() -// c.f == "field is null" -``` - -The unsoundness above can be caught by the compiler with the option `-Ysafe-init`. -More details can be found in [safe initialization](./safe-initialization.html). - -## Equality - -We don't allow the double-equal (`==` and `!=`) and reference (`eq` and `ne`) comparison between -`AnyRef` and `Null` anymore, since a variable with a non-nullable type cannot have `null` as value. -`null` can only be compared with `Null`, nullable union (`T | Null`), or `Any` type. - -For some reason, if we really want to compare `null` with non-null values, we have to provide a type hint (e.g. `: Any`). - -```scala -val x: String = ??? -val y: String | Null = ??? - -x == null // error: Values of types String and Null cannot be compared with == or != -x eq null // error -"hello" == null // error - -y == null // ok -y == x // ok - -(x: String | Null) == null // ok -(x: Any) == null // ok -``` - -## Java Interoperability - -The Scala compiler can load Java classes in two ways: from source or from bytecode. In either case, -when a Java class is loaded, we "patch" the type of its members to reflect that Java types -remain implicitly nullable. - -Specifically, we patch - -- the type of fields - -- the argument type and return type of methods - -We illustrate the rules with following examples: - -- The first two rules are easy: we nullify reference types but not value types. - - ```java - class C { - String s; - int x; - } - ``` - - ==> - - ```scala - class C: - val s: String | Null - val x: Int - ``` - -- We nullify type parameters because in Java a type parameter is always nullable, so the following code compiles. - - ```java - class C { T foo() { return null; } } - ``` - - ==> - - ```scala - class C[T] { def foo(): T | Null } - ``` - - Notice this is rule is sometimes too conservative, as witnessed by - - ```scala - class InScala: - val c: C[Bool] = ??? // C as above - val b: Bool = c.foo() // no longer typechecks, since foo now returns Bool | Null - ``` - -- We can reduce the number of redundant nullable types we need to add. Consider - - ```java - class Box { T get(); } - class BoxFactory { Box makeBox(); } - ``` - - ==> - - ```scala - class Box[T] { def get(): T | Null } - class BoxFactory[T] { def makeBox(): Box[T] | Null } - ``` - - Suppose we have a `BoxFactory[String]`. Notice that calling `makeBox()` on it returns a - `Box[String] | Null`, not a `Box[String | Null] | Null`. This seems at first - glance unsound ("What if the box itself has `null` inside?"), but is sound because calling - `get()` on a `Box[String]` returns a `String | Null`. - - Notice that we need to patch _all_ Java-defined classes that transitively appear in the - argument or return type of a field or method accessible from the Scala code being compiled. - Absent crazy reflection magic, we think that all such Java classes _must_ be visible to - the Typer in the first place, so they will be patched. - -- We will append `Null` to the type arguments if the generic class is defined in Scala. - - ```java - class BoxFactory { - Box makeBox(); // Box is Scala-defined - List>> makeCrazyBoxes(); // List is Java-defined - } - ``` - - ==> - - ```scala - class BoxFactory[T]: - def makeBox(): Box[T | Null] | Null - def makeCrazyBoxes(): java.util.List[Box[java.util.List[T] | Null]] | Null - ``` - - In this case, since `Box` is Scala-defined, we will get `Box[T | Null] | Null`. - This is needed because our nullability function is only applied (modularly) to the Java - classes, but not to the Scala ones, so we need a way to tell `Box` that it contains a - nullable value. - - The `List` is Java-defined, so we don't append `Null` to its type argument. But we - still need to nullify its inside. - -- We don't nullify _simple_ literal constant (`final`) fields, since they are known to be non-null - - ```java - class Constants { - final String NAME = "name"; - final int AGE = 0; - final char CHAR = 'a'; - - final String NAME_GENERATED = getNewName(); - } - ``` - - ==> - - ```scala - class Constants: - val NAME: String("name") = "name" - val AGE: Int(0) = 0 - val CHAR: Char('a') = 'a' - - val NAME_GENERATED: String | Null = getNewName() - ``` - -- We don't append `Null` to a field nor to a return type of a method which is annotated with a - `NotNull` annotation. - - ```java - class C { - @NotNull String name; - @NotNull List getNames(String prefix); // List is Java-defined - @NotNull Box getBoxedName(); // Box is Scala-defined - } - ``` - - ==> - - ```scala - class C: - val name: String - def getNames(prefix: String | Null): java.util.List[String] // we still need to nullify the paramter types - def getBoxedName(): Box[String | Null] // we don't append `Null` to the outmost level, but we still need to nullify inside - ``` - - The annotation must be from the list below to be recognized as `NotNull` by the compiler. - Check `Definitions.scala` for an updated list. - - ```scala - // A list of annotations that are commonly used to indicate - // that a field/method argument or return type is not null. - // These annotations are used by the nullification logic in - // JavaNullInterop to improve the precision of type nullification. - // We don't require that any of these annotations be present - // in the class path, but we want to create Symbols for the - // ones that are present, so they can be checked during nullification. - @tu lazy val NotNullAnnots: List[ClassSymbol] = ctx.getClassesIfDefined( - "javax.annotation.Nonnull" :: - "edu.umd.cs.findbugs.annotations.NonNull" :: - "androidx.annotation.NonNull" :: - "android.support.annotation.NonNull" :: - "android.annotation.NonNull" :: - "com.android.annotations.NonNull" :: - "org.eclipse.jdt.annotation.NonNull" :: - "org.checkerframework.checker.nullness.qual.NonNull" :: - "org.checkerframework.checker.nullness.compatqual.NonNullDecl" :: - "org.jetbrains.annotations.NotNull" :: - "lombok.NonNull" :: - "io.reactivex.annotations.NonNull" :: Nil map PreNamedString) - ``` - -### Override check - -When we check overriding between Scala classes and Java classes, the rules are relaxed for `Null` type with this feature, in order to help users to working with Java libraries. - -Suppose we have Java method `String f(String x)`, we can override this method in Scala in any of the following forms: - -```scala -def f(x: String | Null): String | Null - -def f(x: String): String | Null - -def f(x: String | Null): String - -def f(x: String): String -``` - -Note that some of the definitions could cause unsoundness. For example, the return type is not nullable, but a `null` value is actually returned. - -## Flow Typing - -We added a simple form of flow-sensitive type inference. The idea is that if `p` is a -stable path or a trackable variable, then we can know that `p` is non-null if it's compared -with `null`. This information can then be propagated to the `then` and `else` branches -of an if-statement (among other places). - -Example: - -```scala -val s: String | Null = ??? -if s != null then - // s: String - -// s: String | Null - -assert(s != null) -// s: String -``` - -A similar inference can be made for the `else` case if the test is `p == null` - -```scala -if s == null then - // s: String | Null -else - // s: String -``` - -`==` and `!=` is considered a comparison for the purposes of the flow inference. - -### Logical Operators - -We also support logical operators (`&&`, `||`, and `!`): - -```scala -val s: String | Null = ??? -val s2: String | Null = ??? -if s != null && s2 != null then - // s: String - // s2: String - -if s == null || s2 == null then - // s: String | Null - // s2: String | Null -else - // s: String - // s2: String -``` - -### Inside Conditions - -We also support type specialization _within_ the condition, taking into account that `&&` and `||` are short-circuiting: - -```scala -val s: String | Null = ??? - -if s != null && s.length > 0 then // s: String in `s.length > 0` - // s: String - -if s == null || s.length > 0 then // s: String in `s.length > 0` - // s: String | Null -else - // s: String -``` - -### Match Case - -The non-null cases can be detected in match statements. - -```scala -val s: String | Null = ??? - -s match - case _: String => // s: String - case _ => -``` - -### Mutable Variable - -We are able to detect the nullability of some local mutable variables. A simple example is: - -```scala -class C(val x: Int, val next: C | Null) - -var xs: C | Null = C(1, C(2, null)) -// xs is trackable, since all assignments are in the same method -while xs != null do - // xs: C - val xsx: Int = xs.x - val xscpy: C = xs - xs = xscpy // since xscpy is non-null, xs still has type C after this line - // xs: C - xs = xs.next // after this assignment, xs can be null again - // xs: C | Null -``` - -When dealing with local mutable variables, there are two questions: - -1. Whether to track a local mutable variable during flow typing. - We track a local mutable variable if the variable is not assigned in a closure. - For example, in the following code `x` is assigned to by the closure `y`, so we do not - do flow typing on `x`. - - ```scala - var x: String | Null = ??? - def y = - x = null - - if x != null then - // y can be called here, which would break the fact - val a: String = x // error: x is captured and mutated by the closure, not trackable - ``` - -2. Whether to generate and use flow typing on a specific _use_ of a local mutable variable. - We only want to do flow typing on a use that belongs to the same method as the definition - of the local variable. - For example, in the following code, even `x` is not assigned to by a closure, we can only - use flow typing in one of the occurrences (because the other occurrence happens within a - nested closure). - - ```scala - var x: String | Null = ??? - def y = - if x != null then - // not safe to use the fact (x != null) here - // since y can be executed at the same time as the outer block - val _: String = x - if x != null then - val a: String = x // ok to use the fact here - x = null - ``` - -See [more examples](https://github.com/lampepfl/dotty/blob/master/tests/explicit-nulls/neg/flow-varref-in-closure.scala). - -Currently, we are unable to track paths with a mutable variable prefix. -For example, `x.a` if `x` is mutable. - -### Unsupported Idioms - -We don't support: - -- flow facts not related to nullability (`if x == 0 then { // x: 0.type not inferred }`) -- tracking aliasing between non-nullable paths - - ```scala - val s: String | Null = ??? - val s2: String | Null = ??? - if s != null && s == s2 then - // s: String inferred - // s2: String not inferred - ``` - -### UnsafeNulls - -It is difficult to work with many nullable values, we introduce a language feature `unsafeNulls`. -Inside this "unsafe" scope, all `T | Null` values can be used as `T`. - -Users can import `scala.language.unsafeNulls` to create such scopes, or use `-language:unsafeNulls` to enable this feature globally (for migration purpose only). - -Assume `T` is a reference type (a subtype of `AnyRef`), the following unsafe operation rules are -applied in this unsafe-nulls scope: - -1. the members of `T` can be found on `T | Null` - -2. a value with type `T` can be compared with `T | Null` and `Null` - -3. suppose `T1` is not a subtype of `T2` using explicit-nulls subtyping (where `Null` is a direct -subtype of Any), extension methods and implicit conversions designed for `T2` can be used for -`T1` if `T1` is a subtype of `T2` using regular subtyping rules (where `Null` is a subtype of every -reference type) - -4. suppose `T1` is not a subtype of `T2` using explicit-nulls subtyping, a value with type `T1` -can be used as `T2` if `T1` is a subtype of `T2` using regular subtyping rules - -Addtionally, `null` can be used as `AnyRef` (`Object`), which means you can select `.eq` or `.toString` on it. - -The program in `unsafeNulls` will have a **similar** semantic as regular Scala, but not **equivalent**. - -For example, the following code cannot be compiled even using unsafe nulls. Because of the -Java interoperation, the type of the get method becomes `T | Null`. - -```Scala -def head[T](xs: java.util.List[T]): T = xs.get(0) // error -``` - -Since the compiler doesn’t know whether `T` is a reference type, it is unable to cast `T | Null` -to `T`. A `.nn` need to be inserted after `xs.get(0)` by user manually to fix the error, which -strips the `Null` from its type. - -The intention of this `unsafeNulls` is to give users a better migration path for explicit nulls. -Projects for Scala 2 or regular Scala 3 can try this by adding `-Yexplicit-nulls -language:unsafeNulls` -to the compile options. A small number of manual modifications are expected. To migrate to the full -explicit nulls feature in the future, `-language:unsafeNulls` can be dropped and add -`import scala.language.unsafeNulls` only when needed. - -```scala -def f(x: String): String = ??? -def nullOf[T >: Null]: T = null - -import scala.language.unsafeNulls - -val s: String | Null = ??? -val a: String = s // unsafely convert String | Null to String - -val b1 = s.trim // call .trim on String | Null unsafely -val b2 = b1.length - -f(s).trim // pass String | Null as an argument of type String unsafely - -val c: String = null // Null to String - -val d1: Array[String] = ??? -val d2: Array[String | Null] = d1 // unsafely convert Array[String] to Array[String | Null] -val d3: Array[String] = Array(null) // unsafe - -class C[T >: Null <: String] // define a type bound with unsafe conflict bound - -val n = nullOf[String] // apply a type bound unsafely -``` - -Without the `unsafeNulls`, all these unsafe operations will not be type-checked. - -`unsafeNulls` also works for extension methods and implicit search. - -```scala -import scala.language.unsafeNulls - -val x = "hello, world!".split(" ").map(_.length) - -given Conversion[String, Array[String]] = _ => ??? - -val y: String | Null = ??? -val z: Array[String | Null] = y -``` - -## Binary Compatibility - -Our strategy for binary compatibility with Scala binaries that predate explicit nulls -and new libraries compiled without `-Yexplicit-nulls` is to leave the types unchanged -and be compatible but unsound. - -[More details](https://dotty.epfl.ch/3.0.0/docs/internals/explicit-nulls.html) diff --git a/_scala3-reference/other-new-features/export.md b/_scala3-reference/other-new-features/export.md deleted file mode 100644 index 49a190c4c9..0000000000 --- a/_scala3-reference/other-new-features/export.md +++ /dev/null @@ -1,183 +0,0 @@ ---- -title: "Export Clauses" -type: section -num: 38 -previous-page: /scala3/reference/other-new-features/creator-applications -next-page: /scala3/reference/other-new-features/opaques ---- - -An export clause defines aliases for selected members of an object. Example: - -```scala -class BitMap -class InkJet - -class Printer: - type PrinterType - def print(bits: BitMap): Unit = ??? - def status: List[String] = ??? - -class Scanner: - def scan(): BitMap = ??? - def status: List[String] = ??? - -class Copier: - private val printUnit = new Printer { type PrinterType = InkJet } - private val scanUnit = new Scanner - - export scanUnit.scan - export printUnit.{status => _, *} - - def status: List[String] = printUnit.status ++ scanUnit.status -``` - -The two `export` clauses define the following _export aliases_ in class `Copier`: - -```scala -final def scan(): BitMap = scanUnit.scan() -final def print(bits: BitMap): Unit = printUnit.print(bits) -final type PrinterType = printUnit.PrinterType -``` - -They can be accessed inside `Copier` as well as from outside: - -```scala -val copier = new Copier -copier.print(copier.scan()) -``` - -An export clause has the same format as an import clause. Its general form is: - -```scala -export path . { sel_1, ..., sel_n } -``` - -It consists of a qualifier expression `path`, which must be a stable identifier, followed by -one or more selectors `sel_i` that identify what gets an alias. Selectors can be -of one of the following forms: - - - A _simple selector_ `x` creates aliases for all eligible members of `path` that are named `x`. - - A _renaming selector_ `x => y` creates aliases for all eligible members of `path` that are named `x`, but the alias is named `y` instead of `x`. - - An _omitting selector_ `x => _` prevents `x` from being aliased by a subsequent - wildcard selector. - - A _given selector_ `given x` has an optional type bound `x`. It creates aliases for all eligible given instances that conform to either `x`, or `Any` if `x` is omitted, except for members that are named by a previous simple, renaming, or omitting selector. - - A _wildcard selector_ `*` creates aliases for all eligible members of `path` except for given instances, - synthetic members generated by the compiler and those members that are named by a previous simple, renaming, or omitting selector. - \ - Notes: - - eligible construtor proxies are also included, even though they are synthetic members. - - members created by an export are also included. They are created by the compiler, but are not considered synthetic. - -A member is _eligible_ if all of the following holds: - - - its owner is not a base class of the class[(\*)](#note_class) containing the export clause, - - the member does not override a concrete definition that has as owner - a base class of the class containing the export clause. - - it is accessible at the export clause, - - it is not a constructor, nor the (synthetic) class part of an object, - - it is a given instance (declared with `given`) if and only if the export is from a _given selector_. - -It is a compile-time error if a simple or renaming selector does not identify any eligible members. - -Type members are aliased by type definitions, and term members are aliased by method definitions. Export aliases copy the type and value parameters of the members they refer to. -Export aliases are always `final`. Aliases of given instances are again defined as givens (and aliases of old-style implicits are `implicit`). Aliases of extensions are again defined as extensions. Aliases of inline methods or values are again defined `inline`. There are no other modifiers that can be given to an alias. This has the following consequences for overriding: - - - Export aliases cannot be overridden, since they are final. - - Export aliases cannot override concrete members in base classes, since they are - not marked `override`. - - However, export aliases can implement deferred members of base classes. - -Export aliases for public value definitions that are accessed without -referring to private values in the qualifier path -are marked by the compiler as "stable" and their result types are the singleton types of the aliased definitions. This means that they can be used as parts of stable identifier paths, even though they are technically methods. For instance, the following is OK: -```scala -class C { type T } -object O { val c: C = ... } -export O.c -def f: c.T = ... -``` - - -**Restrictions:** - - 1. Export clauses can appear in classes or they can appear at the top-level. An export clause cannot appear as a statement in a block. - 1. If an export clause contains a wildcard or given selector, it is forbidden for its qualifier path to refer to a package. This is because it is not yet known how to safely track wildcard dependencies to a package for the purposes of incremental compilation. - - 1. Simple renaming exports like - ```scala - export status as stat - ``` - are not supported yet. They would run afoul of the restriction that the - exported `a` cannot be already a member of the object containing the export. - This restriction might be lifted in the future. - - -(\*) **Note:** Unless otherwise stated, the term "class" in this discussion also includes object and trait definitions. - -## Motivation - -It is a standard recommendation to prefer composition over inheritance. This is really an application of the principle of least power: Composition treats components as blackboxes whereas inheritance can affect the internal workings of components through overriding. Sometimes the close coupling implied by inheritance is the best solution for a problem, but where this is not necessary the looser coupling of composition is better. - -So far, object-oriented languages including Scala made it much easier to use inheritance than composition. Inheritance only requires an `extends` clause whereas composition required a verbose elaboration of a sequence of forwarders. So in that sense, object-oriented languages are pushing -programmers to a solution that is often too powerful. Export clauses redress the balance. They make composition relationships as concise and easy to express as inheritance relationships. Export clauses also offer more flexibility than extends clauses since members can be renamed or omitted. - -Export clauses also fill a gap opened by the shift from package objects to top-level definitions. One occasionally useful idiom that gets lost in this shift is a package object inheriting from some class. The idiom is often used in a facade like pattern, to make members -of internal compositions available to users of a package. Top-level definitions are not wrapped in a user-defined object, so they can't inherit anything. However, top-level definitions can be export clauses, which supports the facade design pattern in a safer and -more flexible way. - -## Syntax changes: - -``` -TemplateStat ::= ... - | Export -TopStat ::= ... - | Export -Export ::= ‘export’ ImportExpr {‘,’ ImportExpr} -ImportExpr ::= SimpleRef {‘.’ id} ‘.’ ImportSpec -ImportSpec ::= NamedSelector - | WildcardSelector - | ‘{’ ImportSelectors) ‘}’ -NamedSelector ::= id [‘as’ (id | ‘_’)] -WildCardSelector ::= ‘*’ | ‘given’ [InfixType] -ImportSelectors ::= NamedSelector [‘,’ ImportSelectors] - | WildCardSelector {‘,’ WildCardSelector} -``` - -## Elaboration of Export Clauses - -Export clauses raise questions about the order of elaboration during type checking. -Consider the following example: - -```scala -class B { val c: Int } -object a { val b = new B } -export a.* -export b.* -``` - -Is the `export b.*` clause legal? If yes, what does it export? Is it equivalent to `export a.b.*`? What about if we swap the last two clauses? - -``` -export b.* -export a.* -``` - -To avoid tricky questions like these, we fix the elaboration order of exports as follows. - -Export clauses are processed when the type information of the enclosing object or class is completed. Completion so far consisted of the following steps: - - 1. Elaborate any annotations of the class. - 2. Elaborate the parameters of the class. - 3. Elaborate the self type of the class, if one is given. - 4. Enter all definitions of the class as class members, with types to be completed - on demand. - 5. Determine the types of all parents of the class. - - With export clauses, the following steps are added: - - 6. Compute the types of all paths in export clauses. - 7. Enter export aliases for the eligible members of all paths in export clauses. - -It is important that steps 6 and 7 are done in sequence: We first compute the types of _all_ -paths in export clauses and only after this is done we enter any export aliases as class members. This means that a path of an export clause cannot refer to an alias made available -by another export clause of the same class. diff --git a/_scala3-reference/other-new-features/indentation-experimental.md b/_scala3-reference/other-new-features/indentation-experimental.md deleted file mode 100644 index 389219d8e8..0000000000 --- a/_scala3-reference/other-new-features/indentation-experimental.md +++ /dev/null @@ -1,83 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Fewer Braces" ---- - -By and large, the possible indentation regions coincide with those regions where braces `{...}` are also legal, no matter whether the braces enclose an expression or a set of definitions. There is one exception, though: Arguments to function can be enclosed in braces but they cannot be simply indented instead. Making indentation always significant for function arguments would be too restrictive and fragile. - -To allow such arguments to be written without braces, a variant of the indentation scheme is implemented under language import -```scala -import language.experimental.fewerBraces -``` -Alternatively, it can be enabled with command line option `-language:experimental.fewerBraces`. - -This variant is more contentious and less stable than the rest of the significant indentation scheme. It allows to replace a function argument in braces by a `:` at the end of a line and indented code, similar to the convention for class bodies. It also allows to leave out braces around arguments that are multi-line function values. - -## Using `:` At End Of Line - - -Similar to what is done for classes and objects, a `:` that follows a function reference at the end of a line means braces can be omitted for function arguments. Example: -```scala -times(10): - println("ah") - println("ha") -``` - -The colon can also follow an infix operator: - -```scala -credentials ++ : - val file = Path.userHome / ".credentials" - if file.exists - then Seq(Credentials(file)) - else Seq() -``` - -Function calls that take multiple argument lists can also be handled this way: - -```scala -val firstLine = files.get(fileName).fold: - val fileNames = files.values - s"""no file named $fileName found among - |${values.mkString(\n)}""".stripMargin - : - f => - val lines = f.iterator.map(_.readLine) - lines.mkString("\n) -``` - - -## Lambda Arguments Without Braces - -Braces can also be omitted around multiple line function value arguments: -```scala -val xs = elems.map x => - val y = x - 1 - y * y -xs.foldLeft (x, y) => - x + y -``` -Braces can be omitted if the lambda starts with a parameter list and `=>` or `=>?` at the end of one line and it has an indented body on the following lines. - -## Syntax Changes - -``` -SimpleExpr ::= ... - | SimpleExpr `:` IndentedArgument - | SimpleExpr FunParams (‘=>’ | ‘?=>’) IndentedArgument -InfixExpr ::= ... - | InfixExpr id `:` IndentedArgument -IndentedArgument ::= indent (CaseClauses | Block) outdent -``` - -Note that a lambda argument must have the `=>` at the end of a line for braces -to be optional. For instance, the following would also be incorrect: - -```scala - xs.map x => x + 1 // error: braces or parentheses are required -``` -The lambda has to be enclosed in braces or parentheses: -```scala - xs.map(x => x + 1) // ok -``` diff --git a/_scala3-reference/other-new-features/indentation.md b/_scala3-reference/other-new-features/indentation.md deleted file mode 100644 index 6a71e351f3..0000000000 --- a/_scala3-reference/other-new-features/indentation.md +++ /dev/null @@ -1,455 +0,0 @@ ---- -title: "Optional Braces" -type: section -num: 47 -previous-page: /scala3/reference/other-new-features/control-syntax -next-page: /scala3/reference/other-new-features/explicit-nulls ---- - -Scala 3 enforces some rules on indentation and allows some occurrences of braces `{...}` to be optional: - -- First, some badly indented programs are flagged with warnings. -- Second, some occurrences of braces `{...}` are made optional. Generally, the rule - is that adding a pair of optional braces will not change the meaning of a well-indented program. - -These changes can be turned off with the compiler flag `-no-indent`. - -### Indentation Rules - -The compiler enforces two rules for well-indented programs, flagging violations as warnings. - - 1. In a brace-delimited region, no statement is allowed to start to the left - of the first statement after the opening brace that starts a new line. - - This rule is helpful for finding missing closing braces. It prevents errors like: - - ```scala - if (x < 0) { - println(1) - println(2) - - println("done") // error: indented too far to the left - ``` - - 2. If significant indentation is turned off (i.e. under Scala 2 mode or under `-no-indent`) and we are at the start of an indented sub-part of an expression, and the indented part ends in a newline, the next statement must start at an indentation width less than the sub-part. This prevents errors where an opening brace was forgotten, as in - - ```scala - if (x < 0) - println(1) - println(2) // error: missing `{` - ``` - -These rules still leave a lot of leeway how programs should be indented. For instance, they do not impose -any restrictions on indentation within expressions, nor do they require that all statements of an indentation block line up exactly. - -The rules are generally helpful in pinpointing the root cause of errors related to missing opening or closing braces. These errors are often quite hard to diagnose, in particular in large programs. - -### Optional Braces - -The compiler will insert `` or `` -tokens at certain line breaks. Grammatically, pairs of `` and `` tokens have the same effect as pairs of braces `{` and `}`. - -The algorithm makes use of a stack `IW` of previously encountered indentation widths. The stack initially holds a single element with a zero indentation width. The _current indentation width_ is the indentation width of the top of the stack. - -There are two rules: - - 1. An `` is inserted at a line break, if - - - An indentation region can start at the current position in the source, and - - the first token on the next line has an indentation width strictly greater - than the current indentation width - - An indentation region can start - - - after the leading parameters of an `extension`, or - - after a `with` in a given instance, or - - after a ": at end of line" token (see below) - - after one of the following tokens: - - ``` - = => ?=> <- catch do else finally for - if match return then throw try while yield - ``` - - - after the closing `)` of a condition in an old-style `if` or `while`. - - after the closing `)` or `}` of the enumerations of an old-style `for` loop without a `do`. - - If an `` is inserted, the indentation width of the token on the next line - is pushed onto `IW`, which makes it the new current indentation width. - - 2. An `` is inserted at a line break, if - - - the first token on the next line has an indentation width strictly less - than the current indentation width, and - - the last token on the previous line is not one of the following tokens - which indicate that the previous statement continues: - ``` - then else do catch finally yield match - ``` - - if the first token on the next line is a - [leading infix operator](../changed-features/operators.html). - then its indentation width is less then the current indentation width, - and it either matches a previous indentation width or is also less - than the enclosing indentation width. - - If an `` is inserted, the top element is popped from `IW`. - If the indentation width of the token on the next line is still less than the new current indentation width, step (2) repeats. Therefore, several `` tokens - may be inserted in a row. - - The following two additional rules support parsing of legacy code with ad-hoc layout. They might be withdrawn in future language versions: - - - An `` is also inserted if the next token following a statement sequence starting with an `` closes an indentation region, i.e. is one of `then`, `else`, `do`, `catch`, `finally`, `yield`, `}`, `)`, `]` or `case`. - - An `` is finally inserted in front of a comma that follows a statement sequence starting with an `` if the indented region is itself enclosed in parentheses - -It is an error if the indentation width of the token following an `` does not match the indentation of some previous line in the enclosing indentation region. For instance, the following would be rejected. - -```scala -if x < 0 then - -x - else // error: `else` does not align correctly - x -``` - -Indentation tokens are only inserted in regions where newline statement separators are also inferred: -at the top-level, inside braces `{...}`, but not inside parentheses `(...)`, patterns or types. - -**Note:** The rules for leading infix operators above are there to make sure that -```scala - one - + two.match - case 1 => b - case 2 => c - + three -``` -is parsed as `one + (two.match ...) + three`. Also, that -```scala -if x then - a - + b - + c -else d -``` -is parsed as `if x then a + b + c else d`. - -### Optional Braces Around Template Bodies - -The Scala grammar uses the term _template body_ for the definitions of a class, trait, or object that are normally enclosed in braces. The braces around a template body can also be omitted by means of the following rule. - -If at the point where a template body can start there is a `:` that occurs at the end -of a line, and that is followed by at least one indented statement, the recognized -token is changed from ":" to ": at end of line". The latter token is one of the tokens -that can start an indentation region. The Scala grammar is changed so an optional ": at end of line" is allowed in front of a template body. - -Analogous rules apply for enum bodies and local packages containing nested definitions. - -With these new rules, the following constructs are all valid: - -```scala -trait A: - def f: Int - -class C(x: Int) extends A: - def f = x - -object O: - def f = 3 - -enum Color: - case Red, Green, Blue - -new A: - def f = 3 - -package p: - def a = 1 - -package q: - def b = 2 -``` - -In each case, the `:` at the end of line can be replaced without change of meaning by a pair of braces that enclose the following indented definition(s). - -The syntax changes allowing this are as follows: - -``` -Template ::= InheritClauses [colonEol] [TemplateBody] -EnumDef ::= id ClassConstr InheritClauses [colonEol] EnumBody -Packaging ::= ‘package’ QualId [nl | colonEol] ‘{’ TopStatSeq ‘}’ -SimpleExpr ::= ‘new’ ConstrApp {‘with’ ConstrApp} [[colonEol] TemplateBody] -``` - -Here, `colonEol` stands for ": at end of line", as described above. -The lexical analyzer is modified so that a `:` at the end of a line -is reported as `colonEol` if the parser is at a point where a `colonEol` is -valid as next token. - -### Spaces vs Tabs - -Indentation prefixes can consist of spaces and/or tabs. Indentation widths are the indentation prefixes themselves, ordered by the string prefix relation. So, so for instance "2 tabs, followed by 4 spaces" is strictly less than "2 tabs, followed by 5 spaces", but "2 tabs, followed by 4 spaces" is incomparable to "6 tabs" or to "4 spaces, followed by 2 tabs". It is an error if the indentation width of some line is incomparable with the indentation width of the region that's current at that point. To avoid such errors, it is a good idea not to mix spaces and tabs in the same source file. - -### Indentation and Braces - -Indentation can be mixed freely with braces `{...}`, as well as brackets `[...]` and parentheses `(...)`. For interpreting indentation inside such regions, the following rules apply. - - 1. The assumed indentation width of a multiline region enclosed in braces is the - indentation width of the first token that starts a new line after the opening brace. - - 2. The assumed indentation width of a multiline region inside brackets or parentheses is: - - - if the opening bracket or parenthesis is at the end of a line, the indentation width of token following it, - - otherwise, the indentation width of the enclosing region. - - 3. On encountering a closing brace `}`, bracket `]` or parenthesis `)`, as many `` tokens as necessary are inserted to close all open nested indentation regions. - -For instance, consider: -```scala -{ - val x = f(x: Int, y => - x * ( - y + 1 - ) + - (x + - x) - ) -} -``` - - Here, the indentation width of the region enclosed by the braces is 3 (i.e. the indentation width of the -statement starting with `val`). - - The indentation width of the region in parentheses that follows `f` is also 3, since the opening - parenthesis is not at the end of a line. - - The indentation width of the region in parentheses around `y + 1` is 9 - (i.e. the indentation width of `y + 1`). - - Finally, the indentation width of the last region in parentheses starting with `(x` is 6 (i.e. the indentation width of the indented region following the `=>`. - -### Special Treatment of Case Clauses - -The indentation rules for `match` expressions and `catch` clauses are refined as follows: - -- An indentation region is opened after a `match` or `catch` also if the following `case` - appears at the indentation width that's current for the `match` itself. -- In that case, the indentation region closes at the first token at that - same indentation width that is not a `case`, or at any token with a smaller - indentation width, whichever comes first. - -The rules allow to write `match` expressions where cases are not indented themselves, as in the example below: - -```scala -x match -case 1 => print("I") -case 2 => print("II") -case 3 => print("III") -case 4 => print("IV") -case 5 => print("V") - -println(".") -``` - -### The End Marker - -Indentation-based syntax has many advantages over other conventions. But one possible problem is that it makes it hard to discern when a large indentation region ends, since there is no specific token that delineates the end. Braces are not much better since a brace by itself also contains no information about what region is closed. - -To solve this problem, Scala 3 offers an optional `end` marker. Example: - -```scala -def largeMethod(...) = - ... - if ... then ... - else - ... // a large block - end if - ... // more code -end largeMethod -``` - -An `end` marker consists of the identifier `end` and a follow-on specifier token that together constitute all the tokes of a line. Possible specifier tokens are -identifiers or one of the following keywords - -```scala -if while for match try new this val given -``` - -End markers are allowed in statement sequences. The specifier token `s` of an end marker must correspond to the statement that precedes it. This means: - -- If the statement defines a member `x` then `s` must be the same identifier `x`. -- If the statement defines a constructor then `s` must be `this`. -- If the statement defines an anonymous given, then `s` must be `given`. -- If the statement defines an anonymous extension, then `s` must be `extension`. -- If the statement defines an anonymous class, then `s` must be `new`. -- If the statement is a `val` definition binding a pattern, then `s` must be `val`. -- If the statement is a package clause that refers to package `p`, then `s` must be the same identifier `p`. -- If the statement is an `if`, `while`, `for`, `try`, or `match` statement, then `s` must be that same token. - -For instance, the following end markers are all legal: - -```scala -package p1.p2: - - abstract class C(): - - def this(x: Int) = - this() - if x > 0 then - val a :: b = - x :: Nil - end val - var y = - x - end y - while y > 0 do - println(y) - y -= 1 - end while - try - x match - case 0 => println("0") - case _ => - end match - finally - println("done") - end try - end if - end this - - def f: String - end C - - object C: - given C = - new C: - def f = "!" - end f - end new - end given - end C - - extension (x: C) - def ff: String = x.f ++ x.f - end extension - -end p2 -``` - -#### When to Use End Markers - -It is recommended that `end` markers are used for code where the extent of an indentation region is not immediately apparent "at a glance". People will have different preferences what this means, but one can nevertheless give some guidelines that stem from experience. An end marker makes sense if - -- the construct contains blank lines, or -- the construct is long, say 15-20 lines or more, -- the construct ends heavily indented, say 4 indentation levels or more. - -If none of these criteria apply, it's often better to not use an end marker since the code will be just as clear and more concise. If there are several ending regions that satisfy one of the criteria above, we usually need an end marker only for the outermost closed region. So cascades of end markers as in the example above are usually better avoided. - -#### Syntax - -``` -EndMarker ::= ‘end’ EndMarkerTag -- when followed by EOL -EndMarkerTag ::= id | ‘if’ | ‘while’ | ‘for’ | ‘match’ | ‘try’ - | ‘new’ | ‘this’ | ‘given’ | ‘extension’ | ‘val’ -BlockStat ::= ... | EndMarker -TemplateStat ::= ... | EndMarker -TopStat ::= ... | EndMarker -``` - -### Example - -Here is a (somewhat meta-circular) example of code using indentation. It provides a concrete representation of indentation widths as defined above together with efficient operations for constructing and comparing indentation widths. - -```scala -enum IndentWidth: - case Run(ch: Char, n: Int) - case Conc(l: IndentWidth, r: Run) - - def <= (that: IndentWidth): Boolean = this match - case Run(ch1, n1) => - that match - case Run(ch2, n2) => n1 <= n2 && (ch1 == ch2 || n1 == 0) - case Conc(l, r) => this <= l - case Conc(l1, r1) => - that match - case Conc(l2, r2) => l1 == l2 && r1 <= r2 - case _ => false - - def < (that: IndentWidth): Boolean = - this <= that && !(that <= this) - - override def toString: String = - this match - case Run(ch, n) => - val kind = ch match - case ' ' => "space" - case '\t' => "tab" - case _ => s"'$ch'-character" - val suffix = if n == 1 then "" else "s" - s"$n $kind$suffix" - case Conc(l, r) => - s"$l, $r" - -object IndentWidth: - private inline val MaxCached = 40 - - private val spaces = IArray.tabulate(MaxCached + 1)(new Run(' ', _)) - private val tabs = IArray.tabulate(MaxCached + 1)(new Run('\t', _)) - - def Run(ch: Char, n: Int): Run = - if n <= MaxCached && ch == ' ' then - spaces(n) - else if n <= MaxCached && ch == '\t' then - tabs(n) - else - new Run(ch, n) - end Run - - val Zero = Run(' ', 0) -end IndentWidth -``` - -### Settings and Rewrites - -Significant indentation is enabled by default. It can be turned off by giving any of the options `-no-indent`, `-old-syntax` and `-language:Scala2`. If indentation is turned off, it is nevertheless checked that indentation conforms to the logical program structure as defined by braces. If that is not the case, the compiler issues a warning. - -The Scala 3 compiler can rewrite source code to indented code and back. -When invoked with options `-rewrite -indent` it will rewrite braces to -indented regions where possible. When invoked with options `-rewrite -no-indent` it will rewrite in the reverse direction, inserting braces for indentation regions. -The `-indent` option only works on [new-style syntax](./control-syntax.html). So to go from old-style syntax to new-style indented code one has to invoke the compiler twice, first with options `-rewrite -new-syntax`, then again with options -`-rewrite -indent`. To go in the opposite direction, from indented code to old-style syntax, it's `-rewrite -no-indent`, followed by `-rewrite -old-syntax`. - -### Variant: Indentation Marker `:` - -Generally, the possible indentation regions coincide with those regions where braces `{...}` are also legal, no matter whether the braces enclose an expression or a set of definitions. There is one exception, though: Arguments to function can be enclosed in braces but they cannot be simply indented instead. Making indentation always significant for function arguments would be too restrictive and fragile. - -To allow such arguments to be written without braces, a variant of the indentation scheme is implemented under language import -```scala -import language.experimental.fewerBraces -``` -This variant is more contentious and less stable than the rest of the significant indentation scheme. In this variant, a colon `:` at the end of a line is also one of the possible tokens that opens an indentation region. Examples: - -```scala -times(10): - println("ah") - println("ha") -``` - -or - -```scala -xs.map: - x => - val y = x - 1 - y * y -``` - -The colon is usable not only for lambdas and by-name parameters, but -also even for ordinary parameters: - -```scala -credentials ++ : - val file = Path.userHome / ".credentials" - if file.exists - then Seq(Credentials(file)) - else Seq() -``` - -How does this syntax variant work? Colons at the end of lines are their own token, distinct from normal `:`. -The Scala grammar is changed so that colons at end of lines are accepted at all points -where an opening brace enclosing an argument is legal. Special provisions are taken so that method result types can still use a colon on the end of a line, followed by the actual type on the next. diff --git a/_scala3-reference/other-new-features/kind-polymorphism.md b/_scala3-reference/other-new-features/kind-polymorphism.md deleted file mode 100644 index 7e69bca4ea..0000000000 --- a/_scala3-reference/other-new-features/kind-polymorphism.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: "Kind Polymorphism" -type: section -num: 42 -previous-page: /scala3/reference/other-new-features/parameter-untupling -next-page: /scala3/reference/other-new-features/matchable ---- - -Normally type parameters in Scala are partitioned into _kinds_. First-level types are types of values. Higher-kinded types are type constructors -such as `List` or `Map`. The kind of a type is indicated by the top type of which it is a subtype. Normal types are subtypes of `Any`, -covariant single argument type constructors such as `List` are subtypes of `[+X] =>> Any`, and the `Map` type constructor is -a subtype of `[X, +Y] =>> Any`. - -A type can be used only as prescribed by its kind. Subtypes of `Any` cannot be applied to type arguments whereas subtypes of `[X] =>> Any` -_must_ be applied to a type argument, unless they are passed to type parameters of the same kind. - -Sometimes we would like to have type parameters that can have more than one kind, for instance to define an implicit -value that works for parameters of any kind. This is now possible through a form of (_subtype_) kind polymorphism. -Kind polymorphism relies on the special type `scala.AnyKind` that can be used as an upper bound of a type. - -```scala -def f[T <: AnyKind] = ... -``` - -The actual type arguments of `f` can then be types of arbitrary kinds. So the following would all be legal: - -```scala -f[Int] -f[List] -f[Map] -f[[X] =>> String] -``` - -We call type parameters and abstract types with an `AnyKind` upper bound _any-kinded types_. -Since the actual kind of an any-kinded type is unknown, its usage must be heavily restricted: An any-kinded type -can be neither the type of a value, nor can it be instantiated with type parameters. So about the only -thing one can do with an any-kinded type is to pass it to another any-kinded type argument. -Nevertheless, this is enough to achieve some interesting generalizations that work across kinds, typically -through advanced uses of implicits. - -(todo: insert good concise example) - -Some technical details: `AnyKind` is a synthesized class just like `Any`, but without any members. It extends no other class. -It is declared `abstract` and `final`, so it can be neither instantiated nor extended. - -`AnyKind` plays a special role in Scala's subtype system: It is a supertype of all other types no matter what their kind is. It is also assumed to be kind-compatible with all other types. Furthermore, `AnyKind` is treated as a higher-kinded type (so it cannot be used as a type of values), but at the same time it has no type parameters (so it cannot be instantiated). - -**Note**: This feature is considered experimental but stable and it can be disabled under compiler flag -(i.e. `-Yno-kind-polymorphism`). diff --git a/_scala3-reference/other-new-features/matchable.md b/_scala3-reference/other-new-features/matchable.md deleted file mode 100644 index 1b2996f662..0000000000 --- a/_scala3-reference/other-new-features/matchable.md +++ /dev/null @@ -1,144 +0,0 @@ ---- -title: "The Matchable Trait" -type: section -num: 43 -previous-page: /scala3/reference/other-new-features/kind-polymorphism -next-page: /scala3/reference/other-new-features/threadUnsafe-annotation ---- - -A new trait `Matchable` controls the ability to pattern match. - -### The Problem - -The Scala 3 standard library has a type `IArray` for immutable -arrays that is defined like this: - -```scala - opaque type IArray[+T] = Array[_ <: T] -``` - -The `IArray` type offers extension methods for `length` and `apply`, but not for `update`; hence it seems values of type `IArray` cannot be updated. - -However, there is a potential hole due to pattern matching. Consider: - -```scala -val imm: IArray[Int] = ... -imm match - case a: Array[Int] => a(0) = 1 -``` - -The test will succeed at runtime since `IArray`s _are_ represented as -`Array`s at runtime. But if we allowed it, it would break the fundamental abstraction of immutable arrays. - -__Aside:__ One could also achieve the same by casting: - -```scala -imm.asInstanceOf[Array[Int]](0) = 1 -``` - -But that is not as much of a problem since in Scala `asInstanceOf` is understood to be low-level and unsafe. By contrast, a pattern match that compiles without warning or error should not break abstractions. - -Note also that the problem is not tied to opaque types as match selectors. The following slight variant with a value of parametric -type `T` as match selector leads to the same problem: - -```scala -def f[T](x: T) = x match - case a: Array[Int] => a(0) = 0 -f(imm) -``` - -Finally, note that the problem is not linked to just opaque types. No unbounded type parameter or abstract type should be decomposable with a pattern match. - -### The Solution - -There is a new type `scala.Matchable` that controls pattern matching. When typing a pattern match of a constructor pattern `C(...)` or -a type pattern `_: C` it is required that the selector type conforms -to `Matchable`. If that's not the case a warning is issued. For instance when compiling the example at the start of this section we get: - -``` -> sc ../new/test.scala -source future --- Warning: ../new/test.scala:4:12 --------------------------------------------- -4 | case a: Array[Int] => a(0) = 0 - | ^^^^^^^^^^ - | pattern selector should be an instance of Matchable, - | but it has unmatchable type IArray[Int] instead -``` - -To allow migration from Scala 2 and cross-compiling -between Scala 2 and 3 the warning is turned on only for `-source future-migration` or higher. - -`Matchable` is a universal trait with `Any` as its parent class. It is -extended by both `AnyVal` and `AnyRef`. Since `Matchable` is a supertype of every concrete value or reference class it means that instances of such classes can be matched as before. However, match selectors of the following types will produce a warning: - -- Type `Any`: if pattern matching is required one should use `Matchable` instead. -- Unbounded type parameters and abstract types: If pattern matching is required they should have an upper bound `Matchable`. -- Type parameters and abstract types that are only bounded by some - universal trait: Again, `Matchable` should be added as a bound. - -Here is the hierarchy of top-level classes and traits with their defined methods: - -```scala -abstract class Any: - def getClass - def isInstanceOf - def asInstanceOf - def == - def != - def ## - def equals - def hashCode - def toString - -trait Matchable extends Any - -class AnyVal extends Any, Matchable -class Object extends Any, Matchable -``` - -`Matchable` is currently a marker trait without any methods. Over time -we might migrate methods `getClass` and `isInstanceOf` to it, since these are closely related to pattern-matching. - -### `Matchable` and Universal Equality - -Methods that pattern-match on selectors of type `Any` will need a cast once the -Matchable warning is turned on. The most common such method is the universal -`equals` method. It will have to be written as in the following example: - -```scala -class C(val x: String): - - override def equals(that: Any): Boolean = - that.asInstanceOf[Matchable] match - case that: C => this.x == that.x - case _ => false -``` - -The cast of `that` to `Matchable` serves as an indication that universal equality -is unsafe in the presence of abstract types and opaque types since it cannot properly distinguish the meaning of a type from its representation. The cast -is guaranteed to succeed at run-time since `Any` and `Matchable` both erase to -`Object`. - -For instance, consider the definitions - -```scala -opaque type Meter = Double -def Meter(x: Double): Meter = x - -opaque type Second = Double -def Second(x: Double): Second = x -``` - -Here, universal `equals` will return true for - -```scala - Meter(10).equals(Second(10)) -``` - -even though this is clearly false mathematically. With [multiversal equality](../contextual/multiversal-equality.html) one can mitigate that problem somewhat by turning - -```scala - import scala.language.strictEquality - Meter(10) == Second(10) -``` - -into a type error. diff --git a/_scala3-reference/other-new-features/named-typeargs-spec.md b/_scala3-reference/other-new-features/named-typeargs-spec.md deleted file mode 100644 index ddd8085598..0000000000 --- a/_scala3-reference/other-new-features/named-typeargs-spec.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Named Type Arguments - More Details" ---- - -## Syntax - -The addition to the grammar is: - -``` -SimpleExpr1 ::= ... - | SimpleExpr (TypeArgs | NamedTypeArgs) -NamedTypeArgs ::= ‘[’ NamedTypeArg {‘,’ NamedTypeArg} ‘]’ -NamedTypeArg ::= id ‘=’ Type -``` - -Note in particular that named arguments cannot be passed to type constructors: - -``` scala -class C[T] - -val x: C[T = Int] = // error - new C[T = Int] // error - -class E extends C[T = Int] // error -``` - -## Compatibility considerations - -Named type arguments do not have an impact on binary compatibility, but they -have an impact on source compatibility: if the name of a method type parameter -is changed, any existing named reference to this parameter will break. This -means that the names of method type parameters are now part of the public API -of a library. - -(Unimplemented proposal: to mitigate this, -[`scala.deprecatedName`](https://www.scala-lang.org/api/current/scala/deprecatedName.html) -could be extended to also be applicable on method type parameters.) diff --git a/_scala3-reference/other-new-features/named-typeargs.md b/_scala3-reference/other-new-features/named-typeargs.md deleted file mode 100644 index 23881307b8..0000000000 --- a/_scala3-reference/other-new-features/named-typeargs.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Named Type Arguments" ---- - -**Note:** This feature is implemented in Scala 3, but is not expected to be part of Scala 3.0. - -Type arguments of methods can now be specified by name as well as by position. Example: - -``` scala -def construct[Elem, Coll[_]](xs: Elem*): Coll[Elem] = ??? - -val xs1 = construct[Coll = List, Elem = Int](1, 2, 3) -val xs2 = construct[Coll = List](1, 2, 3) -``` - -Similar to a named value argument `(x = e)`, a named type argument -`[X = T]` instantiates the type parameter `X` to the type `T`. -Named type arguments do not have to be in order (see `xs1` above) and -unspecified arguments are inferred by the compiler (see `xs2` above). -Type arguments must be all named or un-named, mixtures of named and -positional type arguments are not supported. - -## Motivation - -The main benefit of named type arguments is that unlike positional arguments, -you are allowed to omit passing arguments for some parameters, like in the -definition of `xs2` above. A missing type argument is inferred as usual by -local type inference. This is particularly useful in situations where some type -arguments can be easily inferred from others. - -[More details](./named-typeargs-spec.html) diff --git a/_scala3-reference/other-new-features/opaques-details.md b/_scala3-reference/other-new-features/opaques-details.md deleted file mode 100644 index b7891a86c0..0000000000 --- a/_scala3-reference/other-new-features/opaques-details.md +++ /dev/null @@ -1,123 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Opaque Type Aliases: More Details" ---- - -### Syntax - -``` -Modifier ::= ... - | ‘opaque’ -``` - -`opaque` is a [soft modifier](../soft-modifier.html). It can still be used as a normal identifier when it is not in front of a definition keyword. - -Opaque type aliases must be members of classes, traits, or objects, or they are defined -at the top-level. They cannot be defined in local blocks. - -### Type Checking - -The general form of a (monomorphic) opaque type alias is - -```scala -opaque type T >: L <: U = R -``` - -where the lower bound `L` and the upper bound `U` may be missing, in which case they are assumed to be `scala.Nothing` and `scala.Any`, respectively. If bounds are given, it is checked that the right-hand side `R` conforms to them, i.e. `L <: R` and `R <: U`. F-bounds are not supported for opaque type aliases: `T` is not allowed to appear in `L` or `U`. - -Inside the scope of the alias definition, the alias is transparent: `T` is treated -as a normal alias of `R`. Outside its scope, the alias is treated as the abstract type -```scala -type T >: L <: U -``` -A special case arises if the opaque type alias is defined in an object. Example: - -```scala -object o: - opaque type T = R -``` - -In this case we have inside the object (also for non-opaque types) that `o.T` is equal to -`T` or its expanded form `o.this.T`. Equality is understood here as mutual subtyping, i.e. -`o.T <: o.this.T` and `o.this.T <: T`. Furthermore, we have by the rules of opaque type aliases -that `o.this.T` equals `R`. The two equalities compose. That is, inside `o`, it is -also known that `o.T` is equal to `R`. This means the following code type-checks: - -```scala -object o: - opaque type T = Int - val x: Int = id(2) -def id(x: o.T): o.T = x -``` - -### Type Parameters of Opaque Types - -Opaque type aliases can have a single type parameter list. The following aliases -are well-formed -```scala -opaque type F[T] = (T, T) -opaque type G = [T] =>> List[T] -``` -but the following are not: -```scala -opaque type BadF[T] = [U] =>> (T, U) -opaque type BadG = [T] =>> [U] => (T, U) -``` - -### Translation of Equality - -Comparing two values of opaque type with `==` or `!=` normally uses universal equality, -unless another overloaded `==` or `!=` operator is defined for the type. To avoid -boxing, the operation is mapped after type checking to the (in-)equality operator -defined on the underlying type. For instance, -```scala - opaque type T = Int - - ... - val x: T - val y: T - x == y // uses Int equality for the comparison. -``` - -### Top-level Opaque Types - -An opaque type alias on the top-level is transparent in all other top-level definitions in the sourcefile where it appears, but is opaque in nested -objects and classes and in all other source files. Example: -```scala -// in test1.scala -opaque type A = String -val x: A = "abc" - -object obj: - val y: A = "abc" // error: found: "abc", required: A - -// in test2.scala -def z: String = x // error: found: A, required: String -``` -This behavior becomes clear if one recalls that top-level definitions are placed in their own synthetic object. For instance, the code in `test1.scala` would expand to -```scala -object test1$package: - opaque type A = String - val x: A = "abc" - -object obj: - val y: A = "abc" // error: cannot assign "abc" to opaque type alias A -``` -The opaque type alias `A` is transparent in its scope, which includes the definition of `x`, but not the definitions of `obj` and `y`. - - -### Relationship to SIP 35 - -Opaque types in Scala 3 are an evolution from what is described in -[Scala SIP 35](https://docs.scala-lang.org/sips/opaque-types.html). - -The differences compared to the state described in this SIP are: - - 1. Opaque type aliases cannot be defined anymore in local statement sequences. - 2. The scope where an opaque type alias is visible is now the whole scope where - it is defined, instead of just a companion object. - 3. The notion of a companion object for opaque type aliases has been dropped. - 4. Opaque type aliases can have bounds. - 5. The notion of type equality involving opaque type aliases has been clarified. It was - strengthened with respect to the previous implementation of SIP 35. diff --git a/_scala3-reference/other-new-features/opaques.md b/_scala3-reference/other-new-features/opaques.md deleted file mode 100644 index cb4cf63567..0000000000 --- a/_scala3-reference/other-new-features/opaques.md +++ /dev/null @@ -1,169 +0,0 @@ ---- -title: "Opaque Type Aliases" -type: section -num: 39 -previous-page: /scala3/reference/other-new-features/export -next-page: /scala3/reference/other-new-features/open-classes ---- - -Opaque types aliases provide type abstraction without any overhead. Example: - -```scala -object MyMath: - - opaque type Logarithm = Double - - object Logarithm: - - // These are the two ways to lift to the Logarithm type - - def apply(d: Double): Logarithm = math.log(d) - - def safe(d: Double): Option[Logarithm] = - if d > 0.0 then Some(math.log(d)) else None - - end Logarithm - - // Extension methods define opaque types' public APIs - extension (x: Logarithm) - def toDouble: Double = math.exp(x) - def + (y: Logarithm): Logarithm = Logarithm(math.exp(x) + math.exp(y)) - def * (y: Logarithm): Logarithm = x + y - -end MyMath -``` - -This introduces `Logarithm` as a new abstract type, which is implemented as `Double`. -The fact that `Logarithm` is the same as `Double` is only known in the scope where -`Logarithm` is defined which in the above example corresponds to the object `MyMath`. -Or in other words, within the scope it is treated as type alias, but this is opaque to the outside world -where in consequence `Logarithm` is seen as an abstract type and has nothing to do with `Double`. - -The public API of `Logarithm` consists of the `apply` and `safe` methods defined in the companion object. -They convert from `Double`s to `Logarithm` values. Moreover, an operation `toDouble` that converts the other way, and operations `+` and `*` are defined as extension methods on `Logarithm` values. -The following operations would be valid because they use functionality implemented in the `MyMath` object. - -```scala -import MyMath.Logarithm - -val l = Logarithm(1.0) -val l2 = Logarithm(2.0) -val l3 = l * l2 -val l4 = l + l2 -``` - -But the following operations would lead to type errors: - -```scala -val d: Double = l // error: found: Logarithm, required: Double -val l2: Logarithm = 1.0 // error: found: Double, required: Logarithm -l * 2 // error: found: Int(2), required: Logarithm -l / l2 // error: `/` is not a member of Logarithm -``` - -### Bounds For Opaque Type Aliases - -Opaque type aliases can also come with bounds. Example: - -```scala -object Access: - - opaque type Permissions = Int - opaque type PermissionChoice = Int - opaque type Permission <: Permissions & PermissionChoice = Int - - extension (x: Permissions) - def & (y: Permissions): Permissions = x | y - extension (x: PermissionChoice) - def | (y: PermissionChoice): PermissionChoice = x | y - extension (granted: Permissions) - def is(required: Permissions) = (granted & required) == required - extension (granted: Permissions) - def isOneOf(required: PermissionChoice) = (granted & required) != 0 - - val NoPermission: Permission = 0 - val Read: Permission = 1 - val Write: Permission = 2 - val ReadWrite: Permissions = Read | Write - val ReadOrWrite: PermissionChoice = Read | Write - -end Access -``` - -The `Access` object defines three opaque type aliases: - -- `Permission`, representing a single permission, -- `Permissions`, representing a set of permissions with the meaning "all of these permissions granted", -- `PermissionChoice`, representing a set of permissions with the meaning "at least one of these permissions granted". - -Outside the `Access` object, values of type `Permissions` may be combined using the `&` operator, -where `x & y` means "all permissions in `x` *and* in `y` granted". -Values of type `PermissionChoice` may be combined using the `|` operator, -where `x | y` means "a permission in `x` *or* in `y` granted". - -Note that inside the `Access` object, the `&` and `|` operators always resolve to the corresponding methods of `Int`, -because members always take precedence over extension methods. -Because of that, the `|` extension method in `Access` does not cause infinite recursion. -Also, the definition of `ReadWrite` must use `|`, -even though an equivalent definition outside `Access` would use `&`. - -All three opaque type aliases have the same underlying representation type `Int`. The -`Permission` type has an upper bound `Permissions & PermissionChoice`. This makes -it known outside the `Access` object that `Permission` is a subtype of the other -two types. Hence, the following usage scenario type-checks. - -```scala -object User: - import Access.* - - case class Item(rights: Permissions) - - val roItem = Item(Read) // OK, since Permission <: Permissions - val rwItem = Item(ReadWrite) - val noItem = Item(NoPermission) - - assert(!roItem.rights.is(ReadWrite)) - assert(roItem.rights.isOneOf(ReadOrWrite)) - - assert(rwItem.rights.is(ReadWrite)) - assert(rwItem.rights.isOneOf(ReadOrWrite)) - - assert(!noItem.rights.is(ReadWrite)) - assert(!noItem.rights.isOneOf(ReadOrWrite)) -end User -``` - -On the other hand, the call `roItem.rights.isOneOf(ReadWrite)` would give a type error -since `Permissions` and `PermissionChoice` are different, unrelated types outside `Access`. - - -### Opaque Type Members on Classes -While typically, opaque types are used together with objects to hide implementation details of a module, they can also be used with classes. - -For example, we can redefine the above example of Logarithms as a class. -```scala -class Logarithms: - - opaque type Logarithm = Double - - def apply(d: Double): Logarithm = math.log(d) - - def safe(d: Double): Option[Logarithm] = - if d > 0.0 then Some(math.log(d)) else None - - def mul(x: Logarithm, y: Logarithm) = x + y -``` - -Opaque type members of different instances are treated as different: -```scala -val l1 = new Logarithms -val l2 = new Logarithms -val x = l1(1.5) -val y = l1(2.6) -val z = l2(3.1) -l1.mul(x, y) // type checks -l1.mul(x, z) // error: found l2.Logarithm, required l1.Logarithm -``` -In general, one can think of an opaque type as being only transparent in the scope of `private[this]`. - -[More details](opaques-details.html) diff --git a/_scala3-reference/other-new-features/open-classes.md b/_scala3-reference/other-new-features/open-classes.md deleted file mode 100644 index 342faed61a..0000000000 --- a/_scala3-reference/other-new-features/open-classes.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: "Open Classes" -type: section -num: 40 -previous-page: /scala3/reference/other-new-features/opaques -next-page: /scala3/reference/other-new-features/parameter-untupling ---- - -An `open` modifier on a class signals that the class is planned for extensions. Example: -```scala -// File Writer.scala -package p - -open class Writer[T]: - - /** Sends to stdout, can be overridden */ - def send(x: T) = println(x) - - /** Sends all arguments using `send` */ - def sendAll(xs: T*) = xs.foreach(send) -end Writer - -// File EncryptedWriter.scala -package p - -class EncryptedWriter[T: Encryptable] extends Writer[T]: - override def send(x: T) = super.send(encrypt(x)) -``` -An open class typically comes with some documentation that describes -the internal calling patterns between methods of the class as well as hooks that can be overridden. We call this the _extension contract_ of the class. It is different from the _external contract_ between a class and its users. - -Classes that are not open can still be extended, but only if at least one of two alternative conditions is met: - - - The extending class is in the same source file as the extended class. In this case, the extension is usually an internal implementation matter. - - - The language feature `adhocExtensions` is enabled for the extending class. This is typically enabled by an import clause in the source file of the extension: - ```scala - import scala.language.adhocExtensions - ``` - Alternatively, the feature can be enabled by the compiler option `-language:adhocExtensions`. - If the feature is not enabled, the compiler will issue a "feature" warning. For instance, if the `open` modifier on class `Writer` is dropped, compiling `EncryptedWriter` would produce a warning: - ``` - -- Feature Warning: EncryptedWriter.scala:6:14 ---- - |class EncryptedWriter[T: Encryptable] extends Writer[T] - | ^ - |Unless class Writer is declared 'open', its extension - | in a separate file should be enabled - |by adding the import clause 'import scala.language.adhocExtensions' - |or by setting the compiler option -language:adhocExtensions. - ``` - -### Motivation - -When writing a class, there are three possible expectations of extensibility: - -1. The class is intended to allow extensions. This means one should expect -a carefully worked out and documented extension contract for the class. - -2. Extensions of the class are forbidden, for instance to make correctness or security guarantees. - -3. There is no firm decision either way. The class is not _a priori_ intended for extensions, but if others find it useful to extend on an _ad-hoc_ basis, let them go ahead. However, they are on their own in this case. There is no documented extension contract, and future versions of the class might break the extensions (by rearranging internal call patterns, for instance). - -The three cases are clearly distinguished by using `open` for (1), `final` for (2) and no modifier for (3). - -It is good practice to avoid _ad-hoc_ extensions in a code base, since they tend to lead to fragile systems that are hard to evolve. But there -are still some situations where these extensions are useful: for instance, -to mock classes in tests, or to apply temporary patches that add features or fix bugs in library classes. That's why _ad-hoc_ extensions are permitted, but only if there is an explicit opt-in via a language feature import. - -### Details - - - `open` is a soft modifier. It is treated as a normal identifier - unless it is in modifier position. - - An `open` class cannot be `final` or `sealed`. - - Traits or `abstract` classes are always `open`, so `open` is redundant for them. - -### Relationship with `sealed` - -A class that is neither `abstract` nor `open` is similar to a `sealed` class: it can still be extended, but only in the same source file. The difference is what happens if an extension of the class is attempted in another source file. For a `sealed` class, this is an error, whereas for a simple non-open class, this is still permitted provided the `adhocExtensions` feature is enabled, and it gives a warning otherwise. - -### Migration - -`open` is a new modifier in Scala 3. To allow cross compilation between Scala 2.13 and Scala 3.0 without warnings, the feature warning for ad-hoc extensions is produced only under `-source future`. It will be produced by default from Scala 3.1 on. diff --git a/_scala3-reference/other-new-features/parameter-untupling-spec.md b/_scala3-reference/other-new-features/parameter-untupling-spec.md deleted file mode 100644 index dbabf9d5d7..0000000000 --- a/_scala3-reference/other-new-features/parameter-untupling-spec.md +++ /dev/null @@ -1,88 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: "Parameter Untupling - More Details" ---- - -## Motivation - -Say you have a list of pairs - -```scala -val xs: List[(Int, Int)] -``` - -and you want to map `xs` to a list of `Int`s so that each pair of numbers is mapped to their sum. -Previously, the best way to do this was with a pattern-matching decomposition: - -```scala -xs.map { - case (x, y) => x + y -} -``` -While correct, this is inconvenient. Instead, we propose to write it the following way: - -```scala -xs.map { - (x, y) => x + y -} -``` - -or, equivalently: - -```scala -xs.map(_ + _) -``` - -Generally, a function value with `n > 1` parameters can be converted to a function with tupled arguments if the expected type is a unary function type of the form `((T_1, ..., T_n)) => U`. - -## Type Checking - -The type checking happens in two steps: - -1. Check whether parameter untupling is feasible -2. Adapt the function and type check it - -### Feasibility Check - -Suppose a function `f` of the form `(p1, ..., pn) => e` (where `n > 1`), with `p1, ..., pn` as parameters and `e` as function body. - -If the expected type for checking `f` is a fully defined function type of the form `TupleN[T1, ..., Tn] => R` (or an equivalent SAM-type), where each type `Ti` fits the corresponding parameter `pi`. Then `f` is feasible for parameter untupling with the expected type `TupleN[T1, ..., Tn] => R`. - -A type `Ti` fits a parameter `pi` if one of the following two cases is `true`: - -* `pi` comes without a type, i.e. it is a simple identifier or `_`. -* `pi` is of the form `x: Ui` or `_: Ui` and `Ti <: Ui`. - -Parameter untupling composes with eta-expansion. That is, an n-ary function generated by eta-expansion can in turn be adapted to the expected type with parameter untupling. - -### Term adaptation - -If the function - -```scala -(p1, ..., pn) => e -``` - -is feasible for parameter untupling with the expected type `TupleN[T1, ..., Tn] => Te`, then continue to type check the following adapted function - -```scala -(x: TupleN[T1, ..., Tn]) => - def p1: T1 = x._1 - ... - def pn: Tn = x._n - e -``` - -with the same expected type. -## Migration - -Code like this could not be written before, hence the new notation would not be ambiguous after adoption. - -Though it is possible that someone has written an implicit conversion form `(T1, ..., Tn) => R` to `TupleN[T1, ..., Tn] => R` -for some `n`. This change could be detected and fixed by [`Scalafix`](https://scalacenter.github.io/scalafix/). Furthermore, such conversion would probably -be doing the same translation (semantically) but in a less efficient way. - -## Reference - -For more information, see [Issue #897](https://github.com/lampepfl/dotty/issues/897). diff --git a/_scala3-reference/other-new-features/parameter-untupling.md b/_scala3-reference/other-new-features/parameter-untupling.md deleted file mode 100644 index de58f8c61f..0000000000 --- a/_scala3-reference/other-new-features/parameter-untupling.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "Parameter Untupling" -type: section -num: 41 -previous-page: /scala3/reference/other-new-features/open-classes -next-page: /scala3/reference/other-new-features/kind-polymorphism ---- - -Say you have a list of pairs - -```scala -val xs: List[(Int, Int)] -``` - -and you want to map `xs` to a list of `Int`s so that each pair of numbers is mapped to -their sum. Previously, the best way to do this was with a pattern-matching decomposition: - -```scala -xs map { - case (x, y) => x + y -} -``` - -While correct, this is also inconvenient and confusing, since the `case` -suggests that the pattern match could fail. As a shorter and clearer alternative Scala 3 now allows - -```scala -xs.map { - (x, y) => x + y -} -``` - -or, equivalently: - -```scala -xs.map(_ + _) -``` - -Generally, a function value with `n > 1` parameters is converted to a -pattern-matching closure using `case` if the expected type is a unary -function type of the form `((T_1, ..., T_n)) => U`. - -## Reference - -For more information see: - -* [More details](./parameter-untupling-spec.html) -* [Issue #897](https://github.com/lampepfl/dotty/issues/897). diff --git a/_scala3-reference/other-new-features/safe-initialization.md b/_scala3-reference/other-new-features/safe-initialization.md deleted file mode 100644 index 7ecafb9a28..0000000000 --- a/_scala3-reference/other-new-features/safe-initialization.md +++ /dev/null @@ -1,246 +0,0 @@ ---- -title: "Safe Initialization" -type: section -num: 49 -previous-page: /scala3/reference/other-new-features/explicit-nulls -next-page: /scala3/reference/other-new-features/type-test ---- - -Scala 3 implements experimental safe initialization check, which can be enabled by the compiler option `-Ysafe-init`. - -## A Quick Glance - -To get a feel of how it works, we first show several examples below. - -### Parent-Child Interaction - -Given the following code snippet: - -``` scala -abstract class AbstractFile: - def name: String - val extension: String = name.substring(4) - -class RemoteFile(url: String) extends AbstractFile: - val localFile: String = s"${url.##}.tmp" // error: usage of `localFile` before it's initialized - def name: String = localFile -``` - -The checker will report: - -``` scala --- Warning: tests/init/neg/AbstractFile.scala:7:4 ------------------------------ -7 | val localFile: String = s"${url.##}.tmp" // error: usage of `localFile` before it's initialized - | ^ - | Access non-initialized field value localFile. Calling trace: - | -> val extension: String = name.substring(4) [ AbstractFile.scala:3 ] - | -> def name: String = localFile [ AbstractFile.scala:8 ] -``` - -### Inner-Outer Interaction - -Given the code below: - -``` scala -object Trees: - class ValDef { counter += 1 } - class EmptyValDef extends ValDef - val theEmptyValDef = new EmptyValDef - private var counter = 0 // error -``` - -The checker will report: - -``` scala --- Warning: tests/init/neg/trees.scala:5:14 ------------------------------------ -5 | private var counter = 0 // error - | ^ - | Access non-initialized field variable counter. Calling trace: - | -> val theEmptyValDef = new EmptyValDef [ trees.scala:4 ] - | -> class EmptyValDef extends ValDef [ trees.scala:3 ] - | -> class ValDef { counter += 1 } [ trees.scala:2 ] -``` - -### Functions - -Given the code below: - -``` scala -abstract class Parent: - val f: () => String = () => this.message - def message: String - -class Child extends Parent: - val a = f() - val b = "hello" // error - def message: String = b -``` - -The checker reports: - -``` scala --- Warning: tests/init/neg/features-high-order.scala:7:6 ----------------------- -7 | val b = "hello" // error - | ^ - |Access non-initialized field value b. Calling trace: - | -> val a = f() [ features-high-order.scala:6 ] - | -> val f: () => String = () => this.message [ features-high-order.scala:2 ] - | -> def message: String = b [ features-high-order.scala:8 ] -``` -## Design Goals - -We establish the following design goals: - -- __Sound__: checking always terminates, and is sound for common and reasonable usage (over-approximation) -- __Expressive__: support common and reasonable initialization patterns -- __Friendly__: simple rules, minimal syntactic overhead, informative error messages -- __Modular__: modular checking, no analysis beyond project boundary -- __Fast__: instant feedback -- __Simple__: no changes to core type system, explainable by a simple theory - -By _reasonable usage_, we include the following use cases (but not restricted to them): - -- Access fields on `this` and outer `this` during initialization -- Call methods on `this` and outer `this` during initialization -- Instantiate inner class and call methods on such instances during initialization -- Capture fields in functions - -## Principles - -To achieve the goals, we uphold three fundamental principles: -_stackability_, _monotonicity_ and _scopability_. - -Stackability means that all fields of a class are initialized at the end of the -class body. Scala enforces this property in syntax by demanding that all fields -are initialized at the end of the primary constructor, except for the language -feature below: - -``` scala -var x: T = _ -``` - -Control effects such as exceptions may break this property, as the -following example shows: - -``` scala -class MyException(val b: B) extends Exception("") -class A: - val b = try { new B } catch { case myEx: MyException => myEx.b } - println(b.a) - -class B: - throw new MyException(this) - val a: Int = 1 -``` - -In the code above, the control effect teleport the uninitialized value -wrapped in an exception. In the implementation, we avoid the problem -by ensuring that the values that are thrown must be transitively initialized. - -Monotonicity means that the initialization status of an object should -not go backward: initialized fields continue to be initialized, a -field points to an initialized object may not later point to an -object under initialization. As an example, the following code will be rejected: - -``` scala -trait Reporter: - def report(msg: String): Unit - -class FileReporter(ctx: Context) extends Reporter: - ctx.typer.reporter = this // ctx now reaches an uninitialized object - val file: File = new File("report.txt") - def report(msg: String) = file.write(msg) -``` - -In the code above, suppose `ctx` points to a transitively initialized -object. Now the assignment at line 3 makes `this`, which is not fully -initialized, reachable from `ctx`. This makes field usage dangerous, -as it may indirectly reach uninitialized fields. - -Monotonicity is based on a well-known technique called _heap monotonic -typestate_ to ensure soundness in the presence of aliasing -[1]. Roughly speaking, it means initialization state should not go backwards. - -Scopability means that there are no side channels to access to partially constructed objects. Control effects like coroutines, delimited -control, resumable exceptions may break the property, as they can transport a -value upper in the stack (not in scope) to be reachable from the current scope. -Static fields can also serve as a teleport thus breaks this property. In the -implementation, we need to enforce that teleported values are transitively -initialized. - -The principles enable _local reasoning_ of initialization, which means: - -> An initialized environment can only produce initialized values. - -For example, if the arguments to an `new`-expression are transitively -initialized, so is the result. If the receiver and arguments in a method call -are transitively initialized, so is the result. - -## Rules - -With the established principles and design goals, following rules are imposed: - -1. In an assignment `o.x = e`, the expression `e` may only point to transitively initialized objects. - - This is how monotonicity is enforced in the system. Note that in an - initialization `val f: T = e`, the expression `e` may point to an object - under initialization. This requires a distinction between mutation and - initialization in order to enforce different rules. Scala - has different syntax for them, it thus is not an issue. - -2. Objects under initialization may not be passed as arguments to method calls. - - Escape of `this` in the constructor is commonly regarded as an anti-pattern. - However, escape of `this` as constructor arguments are allowed, to support - creation of cyclic data structures. The checker will ensure that the escaped - non-initialized object is not used, i.e. calling methods or accessing fields - on the escaped object is not allowed. - -3. Local definitions may only refer to transitively initialized objects. - - It means that in a local definition `val x: T = e`, the expression `e` may - only evaluate to transitively initialized objects. The same goes for local - lazy variables and methods. This rule is again motivated for simplicity in - reasoning about initialization: programmers may safely assume that all local - definitions only point to transitively initialized objects. - -## Modularity - -The analysis takes the primary constructor of concrete classes as entry points. -It follows the constructors of super classes, which might be defined in another project. -The analysis takes advantage of TASTy for analyzing super classes defined in another project. - -The crossing of project boundary raises a concern about modularity. It is -well-known in object-oriented programming that superclass and subclass are -tightly coupled. For example, adding a method in the superclass requires -recompiling the child class for checking safe overriding. - -Initialization is no exception in this respect. The initialization of an object -essentially invovles close interaction between subclass and superclass. If the -superclass is defined in another project, the crossing of project boundary -cannot be avoided for soundness of the analysis. - -Meanwhile, inheritance across project boundary has been under scrutiny and the -introduction of [open classes](./open-classes.html) mitigate the concern here. -For example, the initialization check could enforce that the constructors of -open classes may not contain method calls on `this` or introduce annotations as -a contract. - -The feedback from the community on the topic is welcome. - -## Back Doors - -Occasionally you may want to suppress warnings reported by the -checker. You can either write `e: @unchecked` to tell the checker to -skip checking for the expression `e`, or you may use the old trick: -mark some fields as lazy. - -## Caveats - -- The system cannot provide safety guarantee when extending Java or Scala 2 classes. -- Safe initialization of global objects is only partially checked. - -## References - -1. Fähndrich, M. and Leino, K.R.M., 2003, July. [_Heap monotonic typestates_](https://www.microsoft.com/en-us/research/publication/heap-monotonic-typestate/). In International Workshop on Aliasing, Confinement and Ownership in object-oriented programming (IWACO). -2. Fengyun Liu, Ondřej Lhoták, Aggelos Biboudis, Paolo G. Giarrusso, and Martin Odersky. 2020. [_A type-and-effect system for object initialization_](https://dl.acm.org/doi/10.1145/3428243). OOPSLA, 2020. diff --git a/_scala3-reference/other-new-features/targetName.md b/_scala3-reference/other-new-features/targetName.md deleted file mode 100644 index 377bd2db10..0000000000 --- a/_scala3-reference/other-new-features/targetName.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: "The @targetName annotation" -type: section -num: 45 -previous-page: /scala3/reference/other-new-features/threadUnsafe-annotation -next-page: /scala3/reference/other-new-features/control-syntax ---- - -A `@targetName` annotation on a definition defines an alternate name for the implementation of that definition. Example: - -```scala -import scala.annotation.targetName - -object VecOps: - extension [T](xs: Vec[T]) - @targetName("append") - def ++= [T] (ys: Vec[T]): Vec[T] = ... -``` - -Here, the `++=` operation is implemented (in Byte code or native code) under the name `append`. The implementation name affects the code that is generated, and is the name under which code from other languages can call the method. For instance, `++=` could be invoked from Java like this: - -```java -VecOps.append(vec1, vec2) -``` - -The `@targetName` annotation has no bearing on Scala usages. Any application of that method in Scala has to use `++=`, not `append`. - -### Details - - 1. `@targetName` is defined in package `scala.annotation`. It takes a single argument - of type `String`. That string is called the _external name_ of the definition - that's annotated. - - 2. A `@targetName` annotation can be given for all kinds of definitions. - - 3. The name given in a `@targetName` annotation must be a legal name - for the defined entities on the host platform. - - 4. It is recommended that definitions with symbolic names have a `@targetName` annotation. This will establish an alternate name that is easier to search for and - will avoid cryptic encodings in runtime diagnostics. - - 5. Definitions with names in backticks that are not legal host platform names - should also have a `@targetName` annotation. - -### Relationship with Overriding - -`@targetName` annotations are significant for matching two method definitions to decide whether they conflict or override each other. Two method definitions match if they have the same name, signature, and erased name. Here, - -- The _signature_ of a definition consists of the names of the erased types of all (value-) parameters and the method's result type. -- The _erased name_ of a method definition is its target name if a `@targetName` - annotation is given and its defined name otherwise. - -This means that `@targetName` annotations can be used to disambiguate two method definitions that would otherwise clash. For instance. - -```scala -def f(x: => String): Int = x.length -def f(x: => Int): Int = x + 1 // error: double definition -``` - -The two definitions above clash since their erased parameter types are both `Function0`, which is the type of the translation of a by-name-parameter. Hence -they have the same names and signatures. But we can avoid the clash by adding a `@targetName` annotation to either method or to both of them. Example: - -```scala -@targetName("f_string") -def f(x: => String): Int = x.length -def f(x: => Int): Int = x + 1 // OK -``` - -This will produce methods `f_string` and `f` in the generated code. - -However, `@targetName` annotations are not allowed to break overriding relationships -between two definitions that have otherwise the same names and types. So the following would be in error: - -```scala -import annotation.targetName -class A: - def f(): Int = 1 -class B extends A: - @targetName("g") def f(): Int = 2 -``` - -The compiler reports here: - -``` --- Error: test.scala:6:23 ------------------------------------------------------ -6 | @targetName("g") def f(): Int = 2 - | ^ - |error overriding method f in class A of type (): Int; - | method f of type (): Int should not have a @targetName - | annotation since the overridden member hasn't one either -``` - -The relevant overriding rules can be summarized as follows: - -- Two members can override each other if their names and signatures are the same, - and they either have the same erased names or the same types. -- If two members override, then both their erased names and their types must be the same. - -As usual, any overriding relationship in the generated code must also -be present in the original code. So the following example would also be in error: - -```scala -import annotation.targetName -class A: - def f(): Int = 1 -class B extends A: - @targetName("f") def g(): Int = 2 -``` - -Here, the original methods `g` and `f` do not override each other since they have -different names. But once we switch to target names, there is a clash that is reported by the compiler: - -``` --- [E120] Naming Error: test.scala:4:6 ----------------------------------------- -4 |class B extends A: - | ^ - | Name clash between defined and inherited member: - | def f(): Int in class A at line 3 and - | def g(): Int in class B at line 5 - | have the same name and type after erasure. -1 error found -``` diff --git a/_scala3-reference/other-new-features/threadUnsafe-annotation.md b/_scala3-reference/other-new-features/threadUnsafe-annotation.md deleted file mode 100644 index 0916f6ff9b..0000000000 --- a/_scala3-reference/other-new-features/threadUnsafe-annotation.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "The @threadUnsafe annotation" -type: section -num: 44 -previous-page: /scala3/reference/other-new-features/matchable -next-page: /scala3/reference/other-new-features/targetName ---- - -A new annotation `@threadUnsafe` can be used on a field which defines -a `lazy val`. When this annotation is used, the initialization of the -`lazy val` will use a faster mechanism which is not thread-safe. - -### Example - -```scala -import scala.annotation.threadUnsafe - -class Hello: - @threadUnsafe lazy val x: Int = 1 -``` diff --git a/_scala3-reference/other-new-features/trait-parameters.md b/_scala3-reference/other-new-features/trait-parameters.md deleted file mode 100644 index a3a692f91c..0000000000 --- a/_scala3-reference/other-new-features/trait-parameters.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: "Trait Parameters" -type: section -num: 35 -previous-page: /scala3/reference/other-new-features -next-page: /scala3/reference/other-new-features/transparent-traits ---- - -Scala 3 allows traits to have parameters, just like classes have parameters. - -```scala -trait Greeting(val name: String): - def msg = s"How are you, $name" - -class C extends Greeting("Bob"): - println(msg) -``` - -Arguments to a trait are evaluated immediately before the trait is initialized. - -One potential issue with trait parameters is how to prevent -ambiguities. For instance, you might try to extend `Greeting` twice, -with different parameters. - -```scala -class D extends C, Greeting("Bill") // error: parameter passed twice -``` - -Should this print "Bob" or "Bill"? In fact this program is illegal, -because it violates the second rule of the following for trait parameters: - - 1. If a class `C` extends a parameterized trait `T`, and its superclass does not, `C` _must_ pass arguments to `T`. - - 2. If a class `C` extends a parameterized trait `T`, and its superclass does as well, `C` _must not_ pass arguments to `T`. - - 3. Traits must never pass arguments to parent traits. - -Here's a trait extending the parameterized trait `Greeting`. - -```scala -trait FormalGreeting extends Greeting: - override def msg = s"How do you do, $name" -``` -As is required, no arguments are passed to `Greeting`. However, this poses an issue -when defining a class that extends `FormalGreeting`: - -```scala -class E extends FormalGreeting // error: missing arguments for `Greeting`. -``` - -The correct way to write `E` is to extend both `Greeting` and -`FormalGreeting` (in either order): - -```scala -class E extends Greeting("Bob"), FormalGreeting -``` - -### Traits With Context Parameters - -This "explicit extension required" rule is relaxed if the missing trait contains only -[context parameters]({% link _scala3-reference/contextual/using-clauses.md %}). In that case the trait reference is -implicitly inserted as an additional parent with inferred arguments. For instance, -here's a variant of greetings where the addressee is a context parameter of type -`ImpliedName`: - -```scala -case class ImpliedName(name: String): - override def toString = name - -trait ImpliedGreeting(using val iname: ImpliedName): - def msg = s"How are you, $iname" - -trait ImpliedFormalGreeting extends ImpliedGreeting: - override def msg = s"How do you do, $iname" - -class F(using iname: ImpliedName) extends ImpliedFormalGreeting -``` - -The definition of `F` in the last line is implicitly expanded to -```scala -class F(using iname: ImpliedName) extends - Object, - ImpliedGreeting(using iname), - ImpliedFormalGreeting(using iname) -``` -Note the inserted reference to the super trait `ImpliedGreeting`, which was not mentioned explicitly. - -## Reference - -For more information, see [Scala SIP 25](http://docs.scala-lang.org/sips/pending/trait-parameters.html). diff --git a/_scala3-reference/other-new-features/transparent-traits.md b/_scala3-reference/other-new-features/transparent-traits.md deleted file mode 100644 index 5621ca5914..0000000000 --- a/_scala3-reference/other-new-features/transparent-traits.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: "Transparent Traits" -type: section -num: 36 -previous-page: /scala3/reference/other-new-features/trait-parameters -next-page: /scala3/reference/other-new-features/creator-applications ---- - -Traits are used in two roles: - - 1. As mixins for other classes and traits - 2. As types of vals, defs, or parameters - -Some traits are used primarily in the first role, and we usually do not want to see them in inferred types. An example is the `Product` trait that the compiler adds as a mixin trait to every case class or case object. In Scala 2, this parent trait sometimes makes inferred types more complicated than they should be. Example: - -```scala -trait Kind -case object Var extends Kind -case object Val extends Kind -val x = Set(if condition then Val else Var) -``` - -Here, the inferred type of `x` is `Set[Kind & Product & Serializable]` whereas one would have hoped it to be `Set[Kind]`. The reasoning for this particular type to be inferred is as follows: - -- The type of the conditional above is the [union type](../new-types/union-types.html) `Val | Var`. -- A union type is widened in type inference to the least supertype that is not a union type. - In the example, this type is `Kind & Product & Serializable` since all three traits are traits of both `Val` and `Var`. - So that type becomes the inferred element type of the set. - -Scala 3 allows one to mark a mixin trait as `transparent`, which means that it can be suppressed in type inference. Here's an example that follows the lines of the code above, but now with a new transparent trait `S` instead of `Product`: - -```scala -transparent trait S -trait Kind -object Var extends Kind, S -object Val extends Kind, S -val x = Set(if condition then Val else Var) -``` - -Now `x` has inferred type `Set[Kind]`. The common transparent trait `S` does not -appear in the inferred type. - -## Transparent Traits - -The traits `scala.Product`, `java.lang.Serializable` and `java.lang.Comparable` -are treated automatically as transparent. Other traits are turned into transparent traits using the modifier `transparent`. Scala 2 traits can also be made transparent -by adding a [`@transparentTrait` annotation](https://scala-lang.org/api/3.x/scala/annotation/transparentTrait.html). This annotation is defined in `scala.annotation`. It will be deprecated and phased out once Scala 2/3 interoperability is no longer needed. - -Typically, transparent traits are traits -that influence the implementation of inheriting classes and traits that are not usually used as types by themselves. Two examples from the standard collection library are: - -- `IterableOps`, which provides method implementations for an `Iterable`. -- `StrictOptimizedSeqOps`, which optimises some of these implementations for sequences with efficient indexing. - -Generally, any trait that is extended recursively is a good candidate to be -declared transparent. - -## Rules for Inference - -Transparent traits can be given as explicit types as usual. But they are often elided when types are inferred. Roughly, the rules for type inference say that transparent traits are dropped from intersections where possible. - -The precise rules are as follows: - -- When inferring a type of a type variable, or the type of a val, or the return type of a def, -- where that type is not higher-kinded, -- and where `B` is its known upper bound or `Any` if none exists: -- If the type inferred so far is of the form `T1 & ... & Tn` where - `n >= 1`, replace the maximal number of transparent `Ti`s by `Any`, while ensuring that - the resulting type is still a subtype of the bound `B`. -- However, do not perform this widening if all transparent traits `Ti` can get replaced in that way. - -The last clause ensures that a single transparent trait instance such as `Product` is not widened to `Any`. Transparent trait instances are only dropped when they appear in conjunction with some other type. diff --git a/_scala3-reference/other-new-features/type-test.md b/_scala3-reference/other-new-features/type-test.md deleted file mode 100644 index 1fab03490e..0000000000 --- a/_scala3-reference/other-new-features/type-test.md +++ /dev/null @@ -1,183 +0,0 @@ ---- -title: "TypeTest" -type: section -num: 50 -previous-page: /scala3/reference/other-new-features/safe-initialization -next-page: /scala3/reference/changed-features ---- - -## TypeTest - -When pattern matching there are two situations where a runtime type test must be performed. -The first case is an explicit type test using the ascription pattern notation. - -```scala -(x: X) match - case y: Y => -``` - -The second case is when an extractor takes an argument that is not a subtype of the scrutinee type. - -```scala -(x: X) match - case y @ Y(n) => - -object Y: - def unapply(x: Y): Some[Int] = ... -``` - -In both cases, a class test will be performed at runtime. -But when the type test is on an abstract type (type parameter or type member), the test cannot be performed because the type is erased at runtime. - -A `TypeTest` can be provided to make this test possible. - -```scala -package scala.reflect - -trait TypeTest[-S, T]: - def unapply(s: S): Option[s.type & T] -``` - -It provides an extractor that returns its argument typed as a `T` if the argument is a `T`. -It can be used to encode a type test. - -```scala -def f[X, Y](x: X)(using tt: TypeTest[X, Y]): Option[Y] = x match - case tt(x @ Y(1)) => Some(x) - case tt(x) => Some(x) - case _ => None -``` - -To avoid the syntactic overhead the compiler will look for a type test automatically if it detects that the type test is on abstract types. -This means that `x: Y` is transformed to `tt(x)` and `x @ Y(_)` to `tt(x @ Y(_))` if there is a contextual `TypeTest[X, Y]` in scope. -The previous code is equivalent to - -```scala -def f[X, Y](x: X)(using TypeTest[X, Y]): Option[Y] = x match - case x @ Y(1) => Some(x) - case x: Y => Some(x) - case _ => None -``` - -We could create a type test at call site where the type test can be performed with runtime class tests directly as follows - -```scala -val tt: TypeTest[Any, String] = - new TypeTest[Any, String]: - def unapply(s: Any): Option[s.type & String] = s match - case s: String => Some(s) - case _ => None - -f[AnyRef, String]("acb")(using tt) -``` - -The compiler will synthesize a new instance of a type test if none is found in scope as: - -```scala -new TypeTest[A, B]: - def unapply(s: A): Option[s.type & B] = s match - case s: B => Some(s) - case _ => None -``` - -If the type tests cannot be done there will be an unchecked warning that will be raised on the `case s: B =>` test. - -The most common `TypeTest` instances are the ones that take any parameters (i.e. `TypeTest[Any, T]`). -To make it possible to use such instances directly in context bounds we provide the alias - -```scala -package scala.reflect - -type Typeable[T] = TypeTest[Any, T] -``` - -This alias can be used as - -```scala -def f[T: Typeable]: Boolean = - "abc" match - case x: T => true - case _ => false - -f[String] // true -f[Int] // false -``` - -## TypeTest and ClassTag - -`TypeTest` is a replacement for functionality provided previously by `ClassTag.unapply`. -Using `ClassTag` instances was unsound since classtags can check only the class component of a type. -`TypeTest` fixes that unsoundness. -`ClassTag` type tests are still supported but a warning will be emitted after 3.0. - - -## Example - -Given the following abstract definition of Peano numbers that provides two given instances of types `TypeTest[Nat, Zero]` and `TypeTest[Nat, Succ]` - -```scala -import scala.reflect.* - -trait Peano: - type Nat - type Zero <: Nat - type Succ <: Nat - - def safeDiv(m: Nat, n: Succ): (Nat, Nat) - - val Zero: Zero - - val Succ: SuccExtractor - trait SuccExtractor: - def apply(nat: Nat): Succ - def unapply(succ: Succ): Some[Nat] - - given typeTestOfZero: TypeTest[Nat, Zero] - given typeTestOfSucc: TypeTest[Nat, Succ] -``` - -together with an implementation of Peano numbers based on type `Int` - -```scala -object PeanoInt extends Peano: - type Nat = Int - type Zero = Int - type Succ = Int - - def safeDiv(m: Nat, n: Succ): (Nat, Nat) = (m / n, m % n) - - val Zero: Zero = 0 - - val Succ: SuccExtractor = new: - def apply(nat: Nat): Succ = nat + 1 - def unapply(succ: Succ) = Some(succ - 1) - - def typeTestOfZero: TypeTest[Nat, Zero] = new: - def unapply(x: Nat): Option[x.type & Zero] = - if x == 0 then Some(x) else None - - def typeTestOfSucc: TypeTest[Nat, Succ] = new: - def unapply(x: Nat): Option[x.type & Succ] = - if x > 0 then Some(x) else None -``` - -it is possible to write the following program - -```scala -@main def test = - import PeanoInt.* - - def divOpt(m: Nat, n: Nat): Option[(Nat, Nat)] = - n match - case Zero => None - case s @ Succ(_) => Some(safeDiv(m, s)) - - val two = Succ(Succ(Zero)) - val five = Succ(Succ(Succ(two))) - - println(divOpt(five, two)) // prints "Some((2,1))" - println(divOpt(two, five)) // prints "Some((0,2))" - println(divOpt(two, Zero)) // prints "None" -``` - -Note that without the `TypeTest[Nat, Succ]` the pattern `Succ.unapply(nat: Succ)` would be unchecked. diff --git a/_scala3-reference/overview.md b/_scala3-reference/overview.md deleted file mode 100644 index 20995b4567..0000000000 --- a/_scala3-reference/overview.md +++ /dev/null @@ -1,155 +0,0 @@ ---- -title: Overview -type: chapter -num: 1 -next-page: /scala3/reference/new-types ---- - -Scala 3 implements many language changes and improvements over Scala 2. -In this reference, we discuss design decisions and present important differences compared to Scala 2. - -## Goals - -The language redesign was guided by three main goals: - -- Strengthen Scala's foundations. - Make the full programming language compatible with the foundational work on the - [DOT calculus](https://infoscience.epfl.ch/record/227176/files/soundness_oopsla16.pdf) - and apply the lessons learned from that work. -- Make Scala easier and safer to use. - Tame powerful constructs such as implicits to provide a gentler learning curve. Remove warts and puzzlers. -- Further improve the consistency and expressiveness of Scala's language constructs. - -Corresponding to these goals, the language changes fall into seven categories: -(1) Core constructs to strengthen foundations, (2) simplifications and (3) [restrictions](#restrictions), to make the language easier and safer to use, (4) [dropped constructs](#dropped-constructs) to make the language smaller and more regular, (5) [changed constructs](#changes) to remove warts, and increase consistency and usability, (6) [new constructs](#new-constructs) to fill gaps and increase expressiveness, (7) a new, principled approach to metaprogramming that replaces [Scala 2 experimental macros](https://docs.scala-lang.org/overviews/macros/overview.html). - -## Essential Foundations - -These new constructs directly model core features of DOT, higher-kinded types, and the [SI calculus for implicit resolution](https://infoscience.epfl.ch/record/229878/files/simplicitly_1.pdf). - -- [Intersection types](new-types/intersection-types.html), replacing compound types, -- [Union types](new-types/union-types.html), -- [Type lambdas](new-types/type-lambdas.html), replacing encodings using structural types and type projection. -- [Context functions](contextual/context-functions.html), offering abstraction over given parameters. - -## Simplifications - -These constructs replace existing constructs with the aim of making the language safer and simpler to use, and to promote uniformity in code style. - -- [Trait parameters](other-new-features/trait-parameters.html) - replace [early initializers](dropped-features/early-initializers.html) with a more generally useful construct. -- [Given instances](contextual/givens.html) - replace implicit objects and defs, focussing on intent over mechanism. -- [Using clauses](contextual/using-clauses.html) - replace implicit parameters, avoiding their ambiguities. -- [Extension methods](contextual/extension-methods.html) - replace implicit classes with a clearer and simpler mechanism. -- [Opaque type aliases](other-new-features/opaques.html) - replace most uses of value classes while guaranteeing absence of boxing. -- [Top-level definitions](dropped-features/package-objects.html) - replace package objects, dropping syntactic boilerplate. -- [Export clauses](other-new-features/export.html) - provide a simple and general way to express aggregation, which can replace - the previous facade pattern of package objects inheriting from classes. -- [Vararg splices](changed-features/vararg-splices.html) - now use the form `xs*` in function arguments and patterns instead of `xs: _*` and `xs @ _*`, -- [Universal apply methods](other-new-features/creator-applications.html) - allow using simple function call syntax instead of `new` expressions. `new` expressions stay around - as a fallback for the cases where creator applications cannot be used. - -With the exception of [early initializers](dropped-features/early-initializers.html) and old-style vararg patterns, all superseded constructs continue to be available in Scala 3.0. The plan is to deprecate and phase them out later. - -Value classes (superseded by opaque type aliases) are a special case. There are currently no deprecation plans for value classes, since we might bring them back in a more general form if they are supported natively by the JVM as is planned by [project Valhalla](https://openjdk.java.net/projects/valhalla/). - -## Restrictions - -These constructs are restricted to make the language safer. - -- [Implicit Conversions](contextual/conversions.html): - there is only one way to define implicit conversions instead of many, and potentially surprising implicit conversions require a language import. -- [Given Imports](contextual/given-imports.html): - implicits now require a special form of import, to make the import clearly visible. -- [Type Projection](dropped-features/type-projection.html): - only classes can be used as prefix `C` of a type projection `C#A`. Type projection on abstract types is no longer supported since it is unsound. -- [Multiversal Equality](contextual/multiversal-equality.html): - implement an "opt-in" scheme to rule out nonsensical comparisons with `==` and `!=`. -- [infix](changed-features/operators.html): - make method application syntax uniform across code bases. - -Unrestricted implicit conversions continue to be available in Scala 3.0, but will be deprecated and removed later. Unrestricted versions of the other constructs in the list above are available only under `-source 3.0-migration`. - -## Dropped Constructs - -These constructs are proposed to be dropped without a new construct replacing them. The motivation for dropping these constructs is to simplify the language and its implementation. - -- [DelayedInit](dropped-features/delayed-init.html), -- [Existential types](dropped-features/existential-types.html), -- [Procedure syntax](dropped-features/procedure-syntax.html), -- [Class shadowing](dropped-features/class-shadowing.html), -- [XML literals](dropped-features/xml.html), -- [Symbol literals](dropped-features/symlits.html), -- [Auto application](dropped-features/auto-apply.html), -- [Weak conformance](dropped-features/weak-conformance.html), -- Compound types (replaced by [Intersection types](new-types/intersection-types.html)), -- [Auto tupling](https://github.com/lampepfl/dotty/pull/4311) (implemented, but not merged). - -The date when these constructs are dropped varies. The current status is: - -- Not implemented at all: - - DelayedInit, existential types, weak conformance. -- Supported under `-source 3.0-migration`: - - procedure syntax, class shadowing, symbol literals, auto application, auto tupling in a restricted form. -- Supported in 3.0, to be deprecated and phased out later: - - [XML literals](dropped-features/xml.html), compound types. - -## Changes - -These constructs have undergone changes to make them more regular and useful. - -- [Structural Types](changed-features/structural-types.html): - They now allow pluggable implementations, which greatly increases their usefulness. Some usage patterns are restricted compared to the status quo. -- [Name-based pattern matching](changed-features/pattern-matching.html): - The existing undocumented Scala 2 implementation has been codified in a slightly simplified form. -- [Automatic Eta expansion](changed-features/eta-expansion.html): - Eta expansion is now performed universally also in the absence of an expected type. The postfix `_` operator is thus made redundant. It will be deprecated and dropped after Scala 3.0. -- [Implicit Resolution](changed-features/implicit-resolution.html): - The implicit resolution rules have been cleaned up to make them more useful and less surprising. Implicit scope is restricted to no longer include package prefixes. - -Most aspects of old-style implicit resolution are still available under `-source 3.0-migration`. The other changes in this list are applied unconditionally. - -## New Constructs - -These are additions to the language that make it more powerful or pleasant to use. - -- [Enums](enums/enums.html) provide concise syntax for enumerations and [algebraic data types](enums/adts.html). -- [Parameter untupling](other-new-features/parameter-untupling.html) avoids having to use `case` for tupled parameter destructuring. -- [Dependent function types](new-types/dependent-function-types.html) generalize dependent methods to dependent function values and types. -- [Polymorphic function types](new-types/polymorphic-function-types.html) generalize polymorphic methods to polymorphic function values and types. - _Current status_: There is a proposal and a merged prototype implementation, but the implementation has not been finalized (it is notably missing type inference support). -- [Kind polymorphism](other-new-features/kind-polymorphism.html) allows the definition of operators working equally on types and type constructors. -- [`@targetName` annotations](other-new-features/targetName.html) make it easier to interoperate with code written in other languages and give more flexibility for avoiding name clashes. - -## Metaprogramming - -The following constructs together aim to put metaprogramming in Scala on a new basis. So far, metaprogramming was achieved by a combination of macros and libraries such as [Shapeless](https://github.com/milessabin/shapeless) that were in turn based on some key macros. Current Scala 2 macro mechanisms are a thin veneer on top the current Scala 2 compiler, which makes them fragile and in many cases impossible to port to Scala 3. - -It's worth noting that macros were never included in the [Scala 2 language specification](https://scala-lang.org/files/archive/spec/2.13/) and were so far made available only under an `-experimental` flag. This has not prevented their widespread usage. - -To enable porting most uses of macros, we are experimenting with the advanced language constructs listed below. These designs are more provisional than the rest of the proposed language constructs for Scala 3.0. There might still be some changes until the final release. Stabilizing the feature set needed for metaprogramming is our first priority. - -- [Match Types](new-types/match-types.html) - allow computation on types. -- [Inline](metaprogramming/inline.html) - provides by itself a straightforward implementation of some simple macros and is at the same time an essential building block for the implementation of complex macros. -- [Quotes and Splices](metaprogramming/macros.html) - provide a principled way to express macros and staging with a unified set of abstractions. -- [Type class derivation](contextual/derivation.html) - provides an in-language implementation of the `Gen` macro in Shapeless and other foundational libraries. The new implementation is more robust, efficient and easier to use than the macro. -- [By-name context parameters](contextual/by-name-context-parameters.html) - provide a more robust in-language implementation of the `Lazy` macro in [Shapeless](https://github.com/milessabin/shapeless). - -## See Also - -[A classification of proposed language features](./features-classification.html) is -an expanded version of this page that adds the status (i.e. relative importance to be a part of Scala 3, and relative urgency when to decide this) and expected migration cost -of each language construct. diff --git a/_scala3-reference/soft-modifier.md b/_scala3-reference/soft-modifier.md deleted file mode 100644 index 23ac18640c..0000000000 --- a/_scala3-reference/soft-modifier.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -layout: singlepage-overview -scala3: true -title: Soft Keywords ---- - -A soft modifier is one of the identifiers `opaque`, `inline`, `open`, `transparent`, and `infix`. - -A soft keyword is a soft modifier, or one of `as`, `derives`, `end`, `extension`, `using`, `|`, `+`, `-`, `*` - -A soft modifier is treated as potential modifier of a definition if it is followed by a hard modifier or a keyword combination starting a definition (`def`, `val`, `var`, `type`, `given`, `class`, `trait`, `object`, `enum`, `case class`, `case object`). Between the two words there may be a sequence of newline tokens and soft modifiers. - -Otherwise, soft keywords are treated specially in the following situations: - - - `inline`, if it is followed by any token that can start an expression. - - `derives`, if it appears after an extension clause or after - the name and possibly parameters of a class, trait, object, or enum definition. - - `end`, if it appears at the start of a line following a statement (i.e. definition or toplevel expression) - - `extension`, if it appears at the start of a statement and is followed by `(` or `[`. - - `using`, if it appears at the start of a parameter or argument list. - - `as`, in a renaming import clause - - `|`, if it separates two patterns in an alternative. - - `+`, `-`, if they appear in front of a type parameter. - - `*`, in a wildcard import, or it follows the type of a parameter, or if it appears in - a vararg splice `x*`. - -Everywhere else a soft keyword is treated as a normal identifier. diff --git a/_scala3-reference/syntax.md b/_scala3-reference/syntax.md deleted file mode 100644 index 74d5537674..0000000000 --- a/_scala3-reference/syntax.md +++ /dev/null @@ -1,447 +0,0 @@ ---- -title: "Scala 3 Syntax Summary" -type: chapter -num: 87 -previous-page: /scala3/reference/dropped-features/wildcard-init ---- - -The following description of Scala tokens uses literal characters `‘c’` when -referring to the ASCII fragment `\u0000` – `\u007F`. - -_Unicode escapes_ are used to represent the [Unicode character](https://www.w3.org/International/articles/definitions-characters/) with the given -hexadecimal code: - -``` -UnicodeEscape ::= ‘\’ ‘u’ {‘u’} hexDigit hexDigit hexDigit hexDigit -hexDigit ::= ‘0’ | … | ‘9’ | ‘A’ | … | ‘F’ | ‘a’ | … | ‘f’ -``` - -Informal descriptions are typeset as `“some comment”`. - -### Lexical Syntax - -The lexical syntax of Scala is given by the following grammar in EBNF -form. - -``` -whiteSpace ::= ‘\u0020’ | ‘\u0009’ | ‘\u000D’ | ‘\u000A’ -upper ::= ‘A’ | … | ‘Z’ | ‘\$’ | ‘_’ “… and Unicode category Lu” -lower ::= ‘a’ | … | ‘z’ “… and Unicode category Ll” -letter ::= upper | lower “… and Unicode categories Lo, Lt, Nl” -digit ::= ‘0’ | … | ‘9’ -paren ::= ‘(’ | ‘)’ | ‘[’ | ‘]’ | ‘{’ | ‘}’ | ‘'(’ | ‘'[’ | ‘'{’ -delim ::= ‘`’ | ‘'’ | ‘"’ | ‘.’ | ‘;’ | ‘,’ -opchar ::= “printableChar not matched by (whiteSpace | upper | - lower | letter | digit | paren | delim | opchar | - Unicode_Sm | Unicode_So)” -printableChar ::= “all characters in [\u0020, \u007F] inclusive” -charEscapeSeq ::= ‘\’ (‘b’ | ‘t’ | ‘n’ | ‘f’ | ‘r’ | ‘"’ | ‘'’ | ‘\’) - -op ::= opchar {opchar} -varid ::= lower idrest -alphaid ::= upper idrest - | varid -plainid ::= alphaid - | op -id ::= plainid - | ‘`’ { charNoBackQuoteOrNewline | UnicodeEscape | charEscapeSeq } ‘`’ -idrest ::= {letter | digit} [‘_’ op] -quoteId ::= ‘'’ alphaid - -integerLiteral ::= (decimalNumeral | hexNumeral) [‘L’ | ‘l’] -decimalNumeral ::= ‘0’ | nonZeroDigit [{digit | ‘_’} digit] -hexNumeral ::= ‘0’ (‘x’ | ‘X’) hexDigit [{hexDigit | ‘_’} hexDigit] -nonZeroDigit ::= ‘1’ | … | ‘9’ - -floatingPointLiteral - ::= [decimalNumeral] ‘.’ digit [{digit | ‘_’} digit] [exponentPart] [floatType] - | decimalNumeral exponentPart [floatType] - | decimalNumeral floatType -exponentPart ::= (‘E’ | ‘e’) [‘+’ | ‘-’] digit [{digit | ‘_’} digit] -floatType ::= ‘F’ | ‘f’ | ‘D’ | ‘d’ - -booleanLiteral ::= ‘true’ | ‘false’ - -characterLiteral ::= ‘'’ (printableChar | charEscapeSeq) ‘'’ - -stringLiteral ::= ‘"’ {stringElement} ‘"’ - | ‘"""’ multiLineChars ‘"""’ -stringElement ::= printableChar \ (‘"’ | ‘\’) - | UnicodeEscape - | charEscapeSeq -multiLineChars ::= {[‘"’] [‘"’] char \ ‘"’} {‘"’} -processedStringLiteral - ::= alphaid ‘"’ {[‘\’] processedStringPart | ‘\\’ | ‘\"’} ‘"’ - | alphaid ‘"""’ {[‘"’] [‘"’] char \ (‘"’ | ‘$’) | escape} {‘"’} ‘"""’ -processedStringPart - ::= printableChar \ (‘"’ | ‘$’ | ‘\’) | escape -escape ::= ‘$$’ - | ‘$’ letter { letter | digit } - | ‘{’ Block [‘;’ whiteSpace stringFormat whiteSpace] ‘}’ -stringFormat ::= {printableChar \ (‘"’ | ‘}’ | ‘ ’ | ‘\t’ | ‘\n’)} - -symbolLiteral ::= ‘'’ plainid // until 2.13 - -comment ::= ‘/*’ “any sequence of characters; nested comments are allowed” ‘*/’ - | ‘//’ “any sequence of characters up to end of line” - -nl ::= “new line character” -semi ::= ‘;’ | nl {nl} -``` - -## Optional Braces - -The lexical analyzer also inserts `indent` and `outdent` tokens that represent regions of indented code [at certain points](./other-new-features/indentation.html). - -In the context-free productions below we use the notation `<<< ts >>>` -to indicate a token sequence `ts` that is either enclosed in a pair of braces `{ ts }` or that constitutes an indented region `indent ts outdent`. Analogously, the -notation `:<<< ts >>>` indicates a token sequence `ts` that is either enclosed in a pair of braces `{ ts }` or that constitutes an indented region `indent ts outdent` that follows -a `:` at the end of a line. - -``` - <<< ts >>> ::= ‘{’ ts ‘}’ - | indent ts outdent -:<<< ts >>> ::= [nl] ‘{’ ts ‘}’ - | `:` indent ts outdent -``` - -## Keywords - -### Regular keywords - -``` -abstract case catch class def do else -enum export extends false final finally for -given if implicit import lazy match new -null object override package private protected return -sealed super then throw trait true try -type val var while with yield -: = <- => <: >: # -@ =>> ?=> -``` - -### Soft keywords - -``` -as derives end extension infix inline opaque open transparent using | * + - -``` - -See the [separate section on soft keywords](./soft-modifier.html) for additional -details on where a soft keyword is recognized. - -## Context-free Syntax - -The context-free syntax of Scala is given by the following EBNF -grammar: - -### Literals and Paths -``` -SimpleLiteral ::= [‘-’] integerLiteral - | [‘-’] floatingPointLiteral - | booleanLiteral - | characterLiteral - | stringLiteral -Literal ::= SimpleLiteral - | processedStringLiteral - | symbolLiteral - | ‘null’ - -QualId ::= id {‘.’ id} -ids ::= id {‘,’ id} - -SimpleRef ::= id - | [id ‘.’] ‘this’ - | [id ‘.’] ‘super’ [ClassQualifier] ‘.’ id - -ClassQualifier ::= ‘[’ id ‘]’ -``` - -### Types -``` -Type ::= FunType - | HkTypeParamClause ‘=>>’ Type - | FunParamClause ‘=>>’ Type - | MatchType - | InfixType -FunType ::= FunTypeArgs (‘=>’ | ‘?=>’) Type - | HKTypeParamClause '=>' Type -FunTypeArgs ::= InfixType - | ‘(’ [ FunArgTypes ] ‘)’ - | FunParamClause -FunParamClause ::= ‘(’ TypedFunParam {‘,’ TypedFunParam } ‘)’ -TypedFunParam ::= id ‘:’ Type -MatchType ::= InfixType `match` <<< TypeCaseClauses >>> -InfixType ::= RefinedType {id [nl] RefinedType} -RefinedType ::= AnnotType {[nl] Refinement} -AnnotType ::= SimpleType {Annotation} - -SimpleType ::= SimpleLiteral - | ‘?’ TypeBounds - | id - | Singleton ‘.’ id - | Singleton ‘.’ ‘type’ - | ‘(’ Types ‘)’ - | Refinement - | ‘$’ ‘{’ Block ‘}’ - | SimpleType1 TypeArgs - | SimpleType1 ‘#’ id -Singleton ::= SimpleRef - | SimpleLiteral - | Singleton ‘.’ id - -FunArgType ::= Type - | ‘=>’ Type -FunArgTypes ::= FunArgType { ‘,’ FunArgType } -ParamType ::= [‘=>’] ParamValueType -ParamValueType ::= Type [‘*’] -TypeArgs ::= ‘[’ Types ‘]’ -Refinement ::= ‘{’ [RefineDcl] {semi [RefineDcl]} ‘}’ -TypeBounds ::= [‘>:’ Type] [‘<:’ Type] -TypeParamBounds ::= TypeBounds {‘:’ Type} -Types ::= Type {‘,’ Type} -``` - -### Expressions -``` -Expr ::= FunParams (‘=>’ | ‘?=>’) Expr - | HkTypeParamClause ‘=>’ Expr - | Expr1 -BlockResult ::= FunParams (‘=>’ | ‘?=>’) Block - | HkTypeParamClause ‘=>’ Block - | Expr1 -FunParams ::= Bindings - | id - | ‘_’ -Expr1 ::= [‘inline’] ‘if’ ‘(’ Expr ‘)’ {nl} Expr [[semi] ‘else’ Expr] - | [‘inline’] ‘if’ Expr ‘then’ Expr [[semi] ‘else’ Expr] - | ‘while’ ‘(’ Expr ‘)’ {nl} Expr - | ‘while’ Expr ‘do’ Expr - | ‘try’ Expr Catches [‘finally’ Expr] - | ‘try’ Expr [‘finally’ Expr] - | ‘throw’ Expr - | ‘return’ [Expr] - | ForExpr - | [SimpleExpr ‘.’] id ‘=’ Expr - | SimpleExpr1 ArgumentExprs ‘=’ Expr - | PostfixExpr [Ascription] - | ‘inline’ InfixExpr MatchClause -Ascription ::= ‘:’ InfixType - | ‘:’ Annotation {Annotation} -Catches ::= ‘catch’ (Expr | ExprCaseClause) -PostfixExpr ::= InfixExpr [id] -- only if language.postfixOperators is enabled -InfixExpr ::= PrefixExpr - | InfixExpr id [nl] InfixExpr - | InfixExpr MatchClause -MatchClause ::= ‘match’ <<< CaseClauses >>> -PrefixExpr ::= [‘-’ | ‘+’ | ‘~’ | ‘!’] SimpleExpr -SimpleExpr ::= SimpleRef - | Literal - | ‘_’ - | BlockExpr - | ‘$’ ‘{’ Block ‘}’ - | Quoted - | quoteId -- only inside splices - | ‘new’ ConstrApp {‘with’ ConstrApp} [TemplateBody] - | ‘new’ TemplateBody - | ‘(’ ExprsInParens ‘)’ - | SimpleExpr ‘.’ id - | SimpleExpr ‘.’ MatchClause - | SimpleExpr TypeArgs - | SimpleExpr ArgumentExprs -Quoted ::= ‘'’ ‘{’ Block ‘}’ - | ‘'’ ‘[’ Type ‘]’ -ExprsInParens ::= ExprInParens {‘,’ ExprInParens} -ExprInParens ::= PostfixExpr ‘:’ Type - | Expr -ParArgumentExprs ::= ‘(’ [‘using’] ExprsInParens ‘)’ - | ‘(’ [ExprsInParens ‘,’] PostfixExpr ‘*’ ‘)’ -ArgumentExprs ::= ParArgumentExprs - | BlockExpr -BlockExpr ::= <<< (CaseClauses | Block) >>> -Block ::= {BlockStat semi} [BlockResult] -BlockStat ::= Import - | {Annotation {nl}} {LocalModifier} Def - | Extension - | Expr1 - | EndMarker - -ForExpr ::= ‘for’ ‘(’ Enumerators0 ‘)’ {nl} [‘do‘ | ‘yield’] Expr - | ‘for’ ‘{’ Enumerators0 ‘}’ {nl} [‘do‘ | ‘yield’] Expr - | ‘for’ Enumerators0 (‘do‘ | ‘yield’) Expr -Enumerators0 ::= {nl} Enumerators [semi] -Enumerators ::= Generator {semi Enumerator | Guard} -Enumerator ::= Generator - | Guard - | Pattern1 ‘=’ Expr -Generator ::= [‘case’] Pattern1 ‘<-’ Expr -Guard ::= ‘if’ PostfixExpr - -CaseClauses ::= CaseClause { CaseClause } -CaseClause ::= ‘case’ Pattern [Guard] ‘=>’ Block -ExprCaseClause ::= ‘case’ Pattern [Guard] ‘=>’ Expr -TypeCaseClauses ::= TypeCaseClause { TypeCaseClause } -TypeCaseClause ::= ‘case’ InfixType ‘=>’ Type [nl] - -Pattern ::= Pattern1 { ‘|’ Pattern1 } -Pattern1 ::= Pattern2 [‘:’ RefinedType] -Pattern2 ::= [id ‘@’] InfixPattern [‘*’] -InfixPattern ::= SimplePattern { id [nl] SimplePattern } -SimplePattern ::= PatVar - | Literal - | ‘(’ [Patterns] ‘)’ - | Quoted - | SimplePattern1 [TypeArgs] [ArgumentPatterns] - | ‘given’ RefinedType -SimplePattern1 ::= SimpleRef - | SimplePattern1 ‘.’ id -PatVar ::= varid - | ‘_’ -Patterns ::= Pattern {‘,’ Pattern} -ArgumentPatterns ::= ‘(’ [Patterns] ‘)’ - | ‘(’ [Patterns ‘,’] PatVar ‘*’ ‘)’ -``` - -### Type and Value Parameters -``` -ClsTypeParamClause::= ‘[’ ClsTypeParam {‘,’ ClsTypeParam} ‘]’ -ClsTypeParam ::= {Annotation} [‘+’ | ‘-’] id [HkTypeParamClause] TypeParamBounds - -DefTypeParamClause::= ‘[’ DefTypeParam {‘,’ DefTypeParam} ‘]’ -DefTypeParam ::= {Annotation} id [HkTypeParamClause] TypeParamBounds - -TypTypeParamClause::= ‘[’ TypTypeParam {‘,’ TypTypeParam} ‘]’ -TypTypeParam ::= {Annotation} id [HkTypeParamClause] TypeBounds - -HkTypeParamClause ::= ‘[’ HkTypeParam {‘,’ HkTypeParam} ‘]’ -HkTypeParam ::= {Annotation} [‘+’ | ‘-’] (id [HkTypeParamClause] | ‘_’) TypeBounds - -ClsParamClauses ::= {ClsParamClause} [[nl] ‘(’ [‘implicit’] ClsParams ‘)’] -ClsParamClause ::= [nl] ‘(’ ClsParams ‘)’ - | [nl] ‘(’ ‘using’ (ClsParams | FunArgTypes) ‘)’ -ClsParams ::= ClsParam {‘,’ ClsParam} -ClsParam ::= {Annotation} [{Modifier} (‘val’ | ‘var’) | ‘inline’] Param -Param ::= id ‘:’ ParamType [‘=’ Expr] - -DefParamClauses ::= {DefParamClause} [[nl] ‘(’ [‘implicit’] DefParams ‘)’] -DefParamClause ::= [nl] ‘(’ DefParams ‘)’ | UsingParamClause -UsingParamClause ::= [nl] ‘(’ ‘using’ (DefParams | FunArgTypes) ‘)’ -DefParams ::= DefParam {‘,’ DefParam} -DefParam ::= {Annotation} [‘inline’] Param -``` - -### Bindings and Imports -``` -Bindings ::= ‘(’ [Binding {‘,’ Binding}] ‘)’ -Binding ::= (id | ‘_’) [‘:’ Type] - -Modifier ::= LocalModifier - | AccessModifier - | ‘override’ - | ‘opaque’ -LocalModifier ::= ‘abstract’ - | ‘final’ - | ‘sealed’ - | ‘open’ - | ‘implicit’ - | ‘lazy’ - | ‘inline’ -AccessModifier ::= (‘private’ | ‘protected’) [AccessQualifier] -AccessQualifier ::= ‘[’ id ‘]’ - -Annotation ::= ‘@’ SimpleType1 {ParArgumentExprs} - -Import ::= ‘import’ ImportExpr {‘,’ ImportExpr} -Export ::= ‘export’ ImportExpr {‘,’ ImportExpr} -ImportExpr ::= SimpleRef {‘.’ id} ‘.’ ImportSpec - | SimpleRef ‘as’ id -ImportSpec ::= NamedSelector - | WildcardSelector - | ‘{’ ImportSelectors) ‘}’ -NamedSelector ::= id [‘as’ (id | ‘_’)] -WildCardSelector ::= ‘*' | ‘given’ [InfixType] -ImportSelectors ::= NamedSelector [‘,’ ImportSelectors] - | WildCardSelector {‘,’ WildCardSelector} - -EndMarker ::= ‘end’ EndMarkerTag -- when followed by EOL -EndMarkerTag ::= id | ‘if’ | ‘while’ | ‘for’ | ‘match’ | ‘try’ - | ‘new’ | ‘this’ | ‘given’ | ‘extension’ | ‘val’ -``` - -### Declarations and Definitions -``` -RefineDcl ::= ‘val’ ValDcl - | ‘def’ DefDcl - | ‘type’ {nl} TypeDcl -Dcl ::= RefineDcl - | ‘var’ VarDcl -ValDcl ::= ids ‘:’ Type -VarDcl ::= ids ‘:’ Type -DefDcl ::= DefSig ‘:’ Type -DefSig ::= id [DefTypeParamClause] DefParamClauses -TypeDcl ::= id [TypeParamClause] {FunParamClause} TypeBounds [‘=’ Type] - -Def ::= ‘val’ PatDef - | ‘var’ PatDef - | ‘def’ DefDef - | ‘type’ {nl} TypeDcl - | TmplDef -PatDef ::= ids [‘:’ Type] ‘=’ Expr - | Pattern2 [‘:’ Type] ‘=’ Expr -DefDef ::= DefSig [‘:’ Type] ‘=’ Expr - | ‘this’ DefParamClause DefParamClauses ‘=’ ConstrExpr - -TmplDef ::= ([‘case’] ‘class’ | ‘trait’) ClassDef - | [‘case’] ‘object’ ObjectDef - | ‘enum’ EnumDef - | ‘given’ GivenDef -ClassDef ::= id ClassConstr [Template] -ClassConstr ::= [ClsTypeParamClause] [ConstrMods] ClsParamClauses -ConstrMods ::= {Annotation} [AccessModifier] -ObjectDef ::= id [Template] -EnumDef ::= id ClassConstr InheritClauses EnumBody -GivenDef ::= [GivenSig] (AnnotType [‘=’ Expr] | StructuralInstance) -GivenSig ::= [id] [DefTypeParamClause] {UsingParamClause} ‘:’ -- one of `id`, `DefParamClause`, `UsingParamClause` must be present -StructuralInstance ::= ConstrApp {‘with’ ConstrApp} [‘with’ TemplateBody] -Extension ::= ‘extension’ [DefTypeParamClause] {UsingParamClause} - ‘(’ DefParam ‘)’ {UsingParamClause} ExtMethods -ExtMethods ::= ExtMethod | [nl] <<< ExtMethod {semi ExtMethod} >>> -ExtMethod ::= {Annotation [nl]} {Modifier} ‘def’ DefDef -Template ::= InheritClauses [TemplateBody] -InheritClauses ::= [‘extends’ ConstrApps] [‘derives’ QualId {‘,’ QualId}] -ConstrApps ::= ConstrApp ({‘,’ ConstrApp} | {‘with’ ConstrApp}) -ConstrApp ::= SimpleType1 {Annotation} {ParArgumentExprs} -ConstrExpr ::= SelfInvocation - | <<< SelfInvocation {semi BlockStat} >>> -SelfInvocation ::= ‘this’ ArgumentExprs {ArgumentExprs} - -TemplateBody ::= :<<< [SelfType] TemplateStat {semi TemplateStat} >>> -TemplateStat ::= Import - | Export - | {Annotation [nl]} {Modifier} Def - | {Annotation [nl]} {Modifier} Dcl - | Extension - | Expr1 - | EndMarker - | -SelfType ::= id [‘:’ InfixType] ‘=>’ - | ‘this’ ‘:’ InfixType ‘=>’ - -EnumBody ::= :<<< [SelfType] EnumStat {semi EnumStat} >>> -EnumStat ::= TemplateStat - | {Annotation [nl]} {Modifier} EnumCase -EnumCase ::= ‘case’ (id ClassConstr [‘extends’ ConstrApps]] | ids) - -TopStats ::= TopStat {semi TopStat} -TopStat ::= Import - | Export - | {Annotation [nl]} {Modifier} Def - | Extension - | Packaging - | PackageObject - | EndMarker - | -Packaging ::= ‘package’ QualId :<<< TopStats >>> -PackageObject ::= ‘package’ ‘object’ ObjectDef - -CompilationUnit ::= {‘package’ QualId semi} TopStats -``` diff --git a/_sips/minutes/2019-12-18-sip-minutes.md b/_sips/minutes/2019-12-18-sip-minutes.md index fe4181354b..f1d72914fe 100644 --- a/_sips/minutes/2019-12-18-sip-minutes.md +++ b/_sips/minutes/2019-12-18-sip-minutes.md @@ -161,7 +161,7 @@ New thread: [SIP public review: Open classes](https://contributors.scala-lang.or ### Review the "Explicit nulls" SIP -Thread: +Thread: <{{ site.scala3ref }}/other-new-features/explicit-nulls.html> Sébastien championing and presenting. diff --git a/_sips/sips/2017-09-20-opaque-types.md b/_sips/sips/2017-09-20-opaque-types.md index 58996ca60b..ff7cf4e9d3 100644 --- a/_sips/sips/2017-09-20-opaque-types.md +++ b/_sips/sips/2017-09-20-opaque-types.md @@ -52,7 +52,7 @@ For a definition of boxing and previous state-of-the-art, we recommend reading [ ### Implementation note Opaque types have been implemented in Scala 3.0.0 with -[some changes compared to this proposal](https://docs.scala-lang.org/scala3/reference/other-new-features/opaques-details.html#relationship-to-sip-35). +[some changes compared to this proposal]({{ site.scala3ref }}/other-new-features/opaques-details.html#relationship-to-sip-35). ## Opaque types diff --git a/_zh-cn/index.md b/_zh-cn/index.md index fd73fb62fc..9e1e7d3507 100644 --- a/_zh-cn/index.md +++ b/_zh-cn/index.md @@ -40,7 +40,7 @@ scala3-sections: - title: "语言参考手册" description: "Scala 3 语言参考手册" icon: "fa fa-book" - link: /scala3/reference/overview.html + link: https://docs.scala-lang.org/scala3/reference - title: "贡献指南" description: "Scala 3 编译器指南及如何贡献代码" icon: "fa fa-cogs" diff --git a/index.md b/index.md index 5790ce8b7c..774df86279 100644 --- a/index.md +++ b/index.md @@ -39,7 +39,7 @@ scala3-sections: - title: "Language Reference" description: "The Scala 3 language reference." icon: "fa fa-book" - link: /scala3/reference/overview.html + link: https://docs.scala-lang.org/scala3/reference - title: "Scala 3 Contributing Guide" description: "Guide to the Scala 3 Compiler and fixing an issue" icon: "fa fa-cogs" diff --git a/scala3/contribute-to-docs.md b/scala3/contribute-to-docs.md index d39ba71ec4..a30c99effa 100644 --- a/scala3/contribute-to-docs.md +++ b/scala3/contribute-to-docs.md @@ -53,10 +53,10 @@ contains a comprehensive overview over contribution to and internals of the Scal - [Issues](https://github.com/scala/docs.scala-lang/issues) ## Scala 3 Language Reference -The [Scala 3 reference](/scala3/reference/overview.html) contains a formal presentation and detailed technical information about the various features of the language. +The [Scala 3 reference]({{ site.scala3ref }}) contains a formal presentation and detailed technical information about the various features of the language. -- [Sources](https://github.com/scala/docs.scala-lang/tree/main/_scala3-reference) -- [Issues](https://github.com/scala/docs.scala-lang/issues) +- [Sources](https://github.com/lampepfl/dotty/tree/main/docs/_docs) +- [Issues](https://github.com/lampepfl/dotty/issues) [scala3-book]: {% link _overviews/scala3-book/introduction.md %} diff --git a/scala3/index.md b/scala3/index.md index a34c19a1ca..3dcea8d2b7 100644 --- a/scala3/index.md +++ b/scala3/index.md @@ -39,7 +39,7 @@ sections: - title: "Language Reference" description: "The Scala 3 language reference." icon: "fa fa-book" - link: /scala3/reference/overview.html + link: https://docs.scala-lang.org/scala3/reference - title: "Scala 3 Contributing Guide" description: "Guide to the Scala 3 Compiler and fixing an issue" icon: "fa fa-cogs" diff --git a/scala3/reference/README.md b/scala3/reference/README.md new file mode 100644 index 0000000000..b23145e7f2 --- /dev/null +++ b/scala3/reference/README.md @@ -0,0 +1,6 @@ +The content of the pages https://docs.scala-lang.org/scala3/reference is +generated from the [Scala 3 compiler repository](https://github.com/lampepfl/dotty). + +Please go here to contribute to the Scala 3 reference documentation: + +https://github.com/lampepfl/dotty/tree/main/docs/_docs From 763d51842a16cf2398087a4a1af3c914fbbd8179 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Thu, 5 May 2022 15:52:47 +0200 Subject: [PATCH 1858/3075] Fix broken links --- _ja/scala3/new-in-scala3.md | 4 ++-- _overviews/scala3-book/ca-summary.md | 2 +- _overviews/scala3-book/first-look-at-types.md | 2 +- _overviews/scala3-book/scala-features.md | 4 ++-- _overviews/scala3-book/why-scala-3.md | 6 +++--- _overviews/scala3-macros/other-resources.md | 2 +- _overviews/scala3-migration/compatibility-classpath.md | 2 +- .../scala3-migration/incompat-contextual-abstractions.md | 2 +- _overviews/scala3-migration/incompatibility-table.md | 2 +- _sips/minutes/2019-12-18-sip-minutes.md | 2 +- _zh-cn/overviews/scala3-book/scala-features.md | 8 ++++---- _zh-cn/scala3/new-in-scala3.md | 4 ++-- scala3/new-in-scala3.md | 4 ++-- 13 files changed, 22 insertions(+), 22 deletions(-) diff --git a/_ja/scala3/new-in-scala3.md b/_ja/scala3/new-in-scala3.md index 8e69859268..6022519757 100644 --- a/_ja/scala3/new-in-scala3.md +++ b/_ja/scala3/new-in-scala3.md @@ -102,7 +102,7 @@ Scala 3 のメタプログラミングについてもっと知りたいかたは [migration]: {% link _overviews/scala3-migration/compatibility-intro.md %} [contribution]: {% link _overviews/scala3-contribution/contribution-intro.md %} -[implicits]: {{ site.scala3ref }}/contextual.html +[implicits]: {{ site.scala3ref }}/contextual [contextual-using]: {{ site.scala3ref }}/contextual/using-clauses.html [contextual-givens]: {{ site.scala3ref }}/contextual/givens.html [contextual-extension]: {{ site.scala3ref }}/contextual/extension-methods.html @@ -120,7 +120,7 @@ Scala 3 のメタプログラミングについてもっと知りたいかたは [meta-quotes]: {% link _overviews/scala3-macros/tutorial/quotes.md %} [meta-reflection]: {% link _overviews/scala3-macros/tutorial/reflection.md %} -[oo-explicit-null]: {{ site.scala3ref }}/other-new-features/explicit-nulls.html +[oo-explicit-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html [oo-safe-init]: {{ site.scala3ref }}/other-new-features/safe-initialization.html [oo-trait-parameters]: {{ site.scala3ref }}/other-new-features/trait-parameters.html [oo-open]: {{ site.scala3ref }}/other-new-features/open-classes.html diff --git a/_overviews/scala3-book/ca-summary.md b/_overviews/scala3-book/ca-summary.md index 8815df2009..ef0bc9fea4 100644 --- a/_overviews/scala3-book/ca-summary.md +++ b/_overviews/scala3-book/ca-summary.md @@ -27,4 +27,4 @@ A few more advanced topics aren’t covered here, including: Those topics are discussed in detail in the [Reference documentation][ref]. -[ref]: {{ site.scala3ref }}/contextual.html +[ref]: {{ site.scala3ref }}/contextual diff --git a/_overviews/scala3-book/first-look-at-types.md b/_overviews/scala3-book/first-look-at-types.md index 85c3214ad9..5e7b8f0099 100644 --- a/_overviews/scala3-book/first-look-at-types.md +++ b/_overviews/scala3-book/first-look-at-types.md @@ -276,4 +276,4 @@ Alternatives to `null` are discussed in the [Functional Programming chapter][fp] [interpolation]: {% link _overviews/core/string-interpolation.md %} [fp]: {% link _overviews/scala3-book/fp-intro.md %} [option-api]: https://scala-lang.org/api/3.x/scala/Option.html -[safe-null]: {{ site.scala3ref }}/other-new-features/explicit-nulls.html +[safe-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html diff --git a/_overviews/scala3-book/scala-features.md b/_overviews/scala3-book/scala-features.md index b5bd769e29..be3cd3ec8c 100644 --- a/_overviews/scala3-book/scala-features.md +++ b/_overviews/scala3-book/scala-features.md @@ -137,7 +137,7 @@ As Heather Miller states, Scala is considered to be a [strong, statically-typed - You can refactor your code with confidence - Method type declarations tell readers what the method does, and help serve as documentation - Scalability and maintainability: types help ensure correctness across arbitrarily large applications and development teams -- Strong typing in combination with excellent inference enables mechanisms like [contextual abstraction]({{ site.scala3ref }}/contextual.html) that allows you to omit boilerplate code. Often, this boilerplate code can be inferred by the compiler, based on type definitions and a given context. +- Strong typing in combination with excellent inference enables mechanisms like [contextual abstraction]({{ site.scala3ref }}/contextual) that allows you to omit boilerplate code. Often, this boilerplate code can be inferred by the compiler, based on type definitions and a given context. {% comment %} In that list: @@ -242,7 +242,7 @@ In Scala, a context parameter directly leads to an inferred argument term that c Use cases for this concept include implementing [type classes]({% link _overviews/scala3-book/ca-type-classes.md %}), establishing context, dependency injection, expressing capabilities, computing new types, and proving relationships between them. Scala 3 makes this process more clear than ever before. -Read about contextual abstractions in the [Reference documentation]({{ site.scala3ref }}/contextual.html). +Read about contextual abstractions in the [Reference documentation]({{ site.scala3ref }}/contextual). ### Client & server diff --git a/_overviews/scala3-book/why-scala-3.md b/_overviews/scala3-book/why-scala-3.md index 3c5b7bbc7a..245abab515 100644 --- a/_overviews/scala3-book/why-scala-3.md +++ b/_overviews/scala3-book/why-scala-3.md @@ -428,9 +428,9 @@ Hopefully you’ll discover more great Scala features as you use the language. [given]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} [contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} [reference]: {{ site.scala3ref }} -[dropped]: {{ site.scala3ref }}/dropped-features.html -[changed]: {{ site.scala3ref }}/changed-features.html -[added]:{{ site.scala3ref }}/other-new-features.html +[dropped]: {{ site.scala3ref }}/dropped-features +[changed]: {{ site.scala3ref }}/changed-features +[added]:{{ site.scala3ref }}/other-new-features [union-types]: {% link _overviews/scala3-book/types-union.md %} [opaque-types]: {% link _overviews/scala3-book/types-opaque-types.md %} diff --git a/_overviews/scala3-macros/other-resources.md b/_overviews/scala3-macros/other-resources.md index 23a48463cb..a50aefa23e 100644 --- a/_overviews/scala3-macros/other-resources.md +++ b/_overviews/scala3-macros/other-resources.md @@ -9,7 +9,7 @@ num: 9 * [Migration status][migration-status] ## Dotty documentation -- [Dotty Documentation]({{ site.scala3ref }}/metaprogramming.html) +- [Dotty Documentation]({{ site.scala3ref }}/metaprogramming) - [Macros: The Plan For Scala 3](https://www.scala-lang.org/blog/2018/04/30/in-a-nutshell.html) - [Examples](https://github.com/lampepfl/dotty-macro-examples) - a repository with small, self-contained examples of various tasks done with Dotty macros. diff --git a/_overviews/scala3-migration/compatibility-classpath.md b/_overviews/scala3-migration/compatibility-classpath.md index ba825a4411..fbe2684dc1 100644 --- a/_overviews/scala3-migration/compatibility-classpath.md +++ b/_overviews/scala3-migration/compatibility-classpath.md @@ -67,7 +67,7 @@ The TASTy reader supports all the traditional language features as well as the f - [Intersection Types]({{ site.scala3ref }}/new-types/intersection-types.html) - [Opaque Type Aliases]({{ site.scala3ref }}/other-new-features/opaques.html) - [Type Lambdas]({{ site.scala3ref }}/new-types/type-lambdas.html) -- [Contextual Abstractions]({{ site.scala3ref }}/contextual.html) (new syntax) +- [Contextual Abstractions]({{ site.scala3ref }}/contextual) (new syntax) - [Open Classes]({{ site.scala3ref }}/other-new-features/open-classes.html) (and inheritance of super traits) - [Export Clauses]({{ site.scala3ref }}/other-new-features/export.html) diff --git a/_overviews/scala3-migration/incompat-contextual-abstractions.md b/_overviews/scala3-migration/incompat-contextual-abstractions.md index 6538c3baf0..cd43809c28 100644 --- a/_overviews/scala3-migration/incompat-contextual-abstractions.md +++ b/_overviews/scala3-migration/incompat-contextual-abstractions.md @@ -7,7 +7,7 @@ previous-page: incompat-dropped-features next-page: incompat-other-changes --- -The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual.html) brings some incompatibilities. +The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual) brings some incompatibilities. |Incompatibility|Scala 2.13|Scala 3 Migration Rewrite|Scalafix Rule|Runtime Incompatibiltiy| |--- |--- |--- |--- |--- | diff --git a/_overviews/scala3-migration/incompatibility-table.md b/_overviews/scala3-migration/incompatibility-table.md index 3783ac8d3f..a7aec7e25f 100644 --- a/_overviews/scala3-migration/incompatibility-table.md +++ b/_overviews/scala3-migration/incompatibility-table.md @@ -59,7 +59,7 @@ Some features are dropped to simplify the language. ### Contextual Abstractions -The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual.html) brings some well defined incompatibilities. +The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual) brings some well defined incompatibilities. |Incompatibility|Scala 2.13|Scala 3 Migration Rewrite|Scalafix Rule|Runtime Incompatibility| |--- |--- |--- |--- |--- | diff --git a/_sips/minutes/2019-12-18-sip-minutes.md b/_sips/minutes/2019-12-18-sip-minutes.md index f1d72914fe..f3ea7d1a23 100644 --- a/_sips/minutes/2019-12-18-sip-minutes.md +++ b/_sips/minutes/2019-12-18-sip-minutes.md @@ -161,7 +161,7 @@ New thread: [SIP public review: Open classes](https://contributors.scala-lang.or ### Review the "Explicit nulls" SIP -Thread: <{{ site.scala3ref }}/other-new-features/explicit-nulls.html> +Thread: <{{ site.scala3ref }}/experimental/explicit-nulls.html> Sébastien championing and presenting. diff --git a/_zh-cn/overviews/scala3-book/scala-features.md b/_zh-cn/overviews/scala3-book/scala-features.md index 394681e1cf..d5e1ccef3e 100644 --- a/_zh-cn/overviews/scala3-book/scala-features.md +++ b/_zh-cn/overviews/scala3-book/scala-features.md @@ -242,7 +242,7 @@ As Heather Miller states, Scala is considered to be a [strong, statically-typed - You can refactor your code with confidence - Method type declarations tell readers what the method does, and help serve as documentation - Scalability and maintainability: types help ensure correctness across arbitrarily large applications and development teams -- Strong typing in combination with excellent inference enables mechanisms like [contextual abstraction]({{ site.scala3ref }}/contextual.html) that allows you to omit boilerplate code. Often, this boilerplate code can be inferred by the compiler, based on type definitions and a given context. +- Strong typing in combination with excellent inference enables mechanisms like [contextual abstraction]({{ site.scala3ref }}/contextual) that allows you to omit boilerplate code. Often, this boilerplate code can be inferred by the compiler, based on type definitions and a given context. {% endcomment %} @@ -254,7 +254,7 @@ As Heather Miller states, Scala is considered to be a [strong, statically-typed - 您可以自信地重构您的代码 - 方法类型声明告诉读者该方法的作用，并作为文档提供帮助 - 可扩展性与可维护性：类型有助于在任意大小的应用程序与开发团队中确保正确性 -- 强类型结合优秀的推断能力可实现[上下文抽象]({{ site.scala3ref }}/contextual.html)等机制，这允许您省略样板代码。通常，这些样板代码可由编译器根据类型定义及给定的上下文推断出来。 +- 强类型结合优秀的推断能力可实现[上下文抽象]({{ site.scala3ref }}/contextual)等机制，这允许您省略样板代码。通常，这些样板代码可由编译器根据类型定义及给定的上下文推断出来。 {% comment %} In that list: @@ -452,7 +452,7 @@ In Scala, a context parameter directly leads to an inferred argument term that c Use cases for this concept include implementing [type classes]({% link _overviews/scala3-book/ca-type-classes.md %}), establishing context, dependency injection, expressing capabilities, computing new types, and proving relationships between them. Scala 3 makes this process more clear than ever before. -Read about contextual abstractions in the [Reference documentation]({{ site.scala3ref }}/contextual.html). +Read about contextual abstractions in the [Reference documentation]({{ site.scala3ref }}/contextual). {% endcomment %} 继 Haskell 之后，Scala 是第二种具有某种形式的 _隐式_ 的流行语言。 @@ -464,7 +464,7 @@ Read about contextual abstractions in the [Reference documentation]({{ site.scal 此概念的用例包括实现[类型类]({% link _overviews/scala3-book/ca-type-classes.md %})、建立上下文、依赖注入、表达能力、计算新类型以及证明它们之间的关系。 Scala 3 使此过程比以往任何时候都更加清晰。 -请在[参考文档]({{ site.scala3ref }}/contextual.html)中阅读关于上下文抽象的内容。 +请在[参考文档]({{ site.scala3ref }}/contextual)中阅读关于上下文抽象的内容。 {% comment %} diff --git a/_zh-cn/scala3/new-in-scala3.md b/_zh-cn/scala3/new-in-scala3.md index ed649cb7da..8308c7ac89 100644 --- a/_zh-cn/scala3/new-in-scala3.md +++ b/_zh-cn/scala3/new-in-scala3.md @@ -100,7 +100,7 @@ Scala 2 中的宏只是一个实验性的功能，而 Scala 3 则为元编程提 [migration]: {% link _overviews/scala3-migration/compatibility-intro.md %} [contribution]: {% link _overviews/scala3-contribution/contribution-intro.md %} -[implicits]: {{ site.scala3ref }}/contextual.html +[implicits]: {{ site.scala3ref }}/contextual [contextual-using]: {{ site.scala3ref }}/contextual/using-clauses.html [contextual-givens]: {{ site.scala3ref }}/contextual/givens.html [contextual-extension]: {{ site.scala3ref }}/contextual/extension-methods.html @@ -118,7 +118,7 @@ Scala 2 中的宏只是一个实验性的功能，而 Scala 3 则为元编程提 [meta-quotes]: {% link _overviews/scala3-macros/tutorial/quotes.md %} [meta-reflection]: {% link _overviews/scala3-macros/tutorial/reflection.md %} -[oo-explicit-null]: {{ site.scala3ref }}/other-new-features/explicit-nulls.html +[oo-explicit-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html [oo-safe-init]: {{ site.scala3ref }}/other-new-features/safe-initialization.html [oo-trait-parameters]: {{ site.scala3ref }}/other-new-features/trait-parameters.html [oo-open]: {{ site.scala3ref }}/other-new-features/open-classes.html diff --git a/scala3/new-in-scala3.md b/scala3/new-in-scala3.md index 5b30d76158..f91f0d06af 100644 --- a/scala3/new-in-scala3.md +++ b/scala3/new-in-scala3.md @@ -113,7 +113,7 @@ If you want to learn more about metaprogramming in Scala 3, we invite you to tak [migration]: {% link _overviews/scala3-migration/compatibility-intro.md %} [contribution]: {% link _overviews/scala3-contribution/contribution-intro.md %} -[implicits]: {{ site.scala3ref }}/contextual.html +[implicits]: {{ site.scala3ref }}/contextual [contextual-using]: {{ site.scala3ref }}/contextual/using-clauses.html [contextual-givens]: {{ site.scala3ref }}/contextual/givens.html [contextual-extension]: {{ site.scala3ref }}/contextual/extension-methods.html @@ -131,7 +131,7 @@ If you want to learn more about metaprogramming in Scala 3, we invite you to tak [meta-quotes]: {% link _overviews/scala3-macros/tutorial/quotes.md %} [meta-reflection]: {% link _overviews/scala3-macros/tutorial/reflection.md %} -[oo-explicit-null]: {{ site.scala3ref }}/other-new-features/explicit-nulls.html +[oo-explicit-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html [oo-safe-init]: {{ site.scala3ref }}/other-new-features/safe-initialization.html [oo-trait-parameters]: {{ site.scala3ref }}/other-new-features/trait-parameters.html [oo-open]: {{ site.scala3ref }}/other-new-features/open-classes.html From 65d72ded63f3f2cebb689ee5e4dd69174516acbf Mon Sep 17 00:00:00 2001 From: Satendra Kumar Date: Tue, 10 May 2022 12:46:32 +0530 Subject: [PATCH 1859/3075] typo correction --- _overviews/scala3-book/ca-contextual-abstractions-intro.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/ca-contextual-abstractions-intro.md b/_overviews/scala3-book/ca-contextual-abstractions-intro.md index d95a9bfc54..dc14d90c62 100644 --- a/_overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -36,7 +36,7 @@ While these concepts were gradually “discovered” in Scala 2, they’re now w The design of Scala 3 focuses on **intent** rather than **mechanism**. Instead of offering one very powerful feature of implicits, Scala 3 offers several use-case oriented features: -- **Abtracting over contextual information**. +- **Abstracting over contextual information**. [Using clauses][givens] allow programmers to abstract over information that is available in the calling context and should be passed implicitly. As an improvement over Scala 2 implicits, using clauses can be specified by type, freeing function signatures from term variable names that are never explicitly referred to. From 5bdcacd5ba6aca09e3d35592abef068269291575 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Tue, 10 May 2022 15:27:27 +0200 Subject: [PATCH 1860/3075] update to new style --- _fr/getting-started/index.md | 12 +-- _includes/_ja/getting-started.md | 12 +-- _includes/alt-details.html | 6 +- _includes/code-snippet.html | 8 +- _includes/getting-started.md | 35 +++---- _includes/tabsection.html | 25 ++--- _install_tabs/1-macos.html | 20 ++++ _install_tabs/1-macos.md | 27 ----- _install_tabs/2-linux.html | 11 +++ _install_tabs/2-linux.md | 15 --- _install_tabs/3-windows.html | 11 +++ _install_tabs/3-windows.md | 15 --- _install_tabs/4-other.html | 15 +++ _install_tabs/4-other.md | 18 ---- _install_tabs/fr-1-macos.html | 19 ++++ _install_tabs/fr-1-macos.md | 26 ----- _install_tabs/fr-2-linux.html | 10 ++ _install_tabs/fr-2-linux.md | 14 --- _install_tabs/fr-3-windows.html | 10 ++ _install_tabs/fr-3-windows.md | 14 --- _install_tabs/fr-4-other.html | 15 +++ _install_tabs/fr-4-other.md | 19 ---- _install_tabs/ja-1-macos.html | 19 ++++ _install_tabs/ja-1-macos.md | 26 ----- _install_tabs/ja-2-linux.html | 10 ++ _install_tabs/ja-2-linux.md | 14 --- _install_tabs/ja-3-windows.html | 10 ++ _install_tabs/ja-3-windows.md | 14 --- _install_tabs/ja-4-other.html | 14 +++ _install_tabs/ja-4-other.md | 18 ---- _sass/base/helper.scss | 17 ++++ _sass/components/alt-details.scss | 44 +++++++++ _sass/components/code.scss | 42 ++++++++ _sass/components/tab.scss | 43 +++++++- _sass/layout/alt-details.scss | 46 --------- _sass/layout/scala-in-action.scss | 159 ------------------------------ _sass/layout/tabsection.scss | 60 ----------- _sass/layout/type-md.scss | 35 +++++-- _sass/utils/_variables.scss | 2 + resources/css/style.scss | 4 +- resources/js/functions.js | 93 +++++++++-------- 41 files changed, 429 insertions(+), 598 deletions(-) create mode 100644 _install_tabs/1-macos.html delete mode 100644 _install_tabs/1-macos.md create mode 100644 _install_tabs/2-linux.html delete mode 100644 _install_tabs/2-linux.md create mode 100644 _install_tabs/3-windows.html delete mode 100644 _install_tabs/3-windows.md create mode 100644 _install_tabs/4-other.html delete mode 100644 _install_tabs/4-other.md create mode 100644 _install_tabs/fr-1-macos.html delete mode 100644 _install_tabs/fr-1-macos.md create mode 100644 _install_tabs/fr-2-linux.html delete mode 100644 _install_tabs/fr-2-linux.md create mode 100644 _install_tabs/fr-3-windows.html delete mode 100644 _install_tabs/fr-3-windows.md create mode 100644 _install_tabs/fr-4-other.html delete mode 100644 _install_tabs/fr-4-other.md create mode 100644 _install_tabs/ja-1-macos.html delete mode 100644 _install_tabs/ja-1-macos.md create mode 100644 _install_tabs/ja-2-linux.html delete mode 100644 _install_tabs/ja-2-linux.md create mode 100644 _install_tabs/ja-3-windows.html delete mode 100644 _install_tabs/ja-3-windows.md create mode 100644 _install_tabs/ja-4-other.html delete mode 100644 _install_tabs/ja-4-other.md create mode 100644 _sass/components/alt-details.scss delete mode 100644 _sass/layout/alt-details.scss delete mode 100755 _sass/layout/scala-in-action.scss delete mode 100755 _sass/layout/tabsection.scss diff --git a/_fr/getting-started/index.md b/_fr/getting-started/index.md index 397c18e59c..0228e5ea0b 100644 --- a/_fr/getting-started/index.md +++ b/_fr/getting-started/index.md @@ -28,15 +28,11 @@ Il s'assure que la JVM est les outils standards de Scala sont installés sur vot Installez-le sur votre système avec les instructions suivantes.
    -
    -
    -
    -
    - {% include tabsection.html language='fr' extraClasses='inline-tabs' category='get-started' collection=site.install_tabs %} - -
    -
    +
    +
    + {% include tabsection.html language='fr' id='install-cs-setup-tabs' collection=site.install_tabs %}
    +
    diff --git a/_includes/_ja/getting-started.md b/_includes/_ja/getting-started.md index f747ff92f7..4faa2e2a35 100644 --- a/_includes/_ja/getting-started.md +++ b/_includes/_ja/getting-started.md @@ -18,15 +18,11 @@ Scala のインストーラーは[Coursier](https://get-coursier.io/docs/cli-ove 以下の手順でお使いのシステムにインストールしてください。
    -
    -
    -
    -
    - {% include tabsection.html language='ja' extraClasses='inline-tabs' category='get-started' collection=site.install_tabs %} - -
    -
    +
    +
    + {% include tabsection.html language='ja' id='install-cs-setup-tabs' collection=site.install_tabs %}
    +
    diff --git a/_includes/alt-details.html b/_includes/alt-details.html index 52e8d9cf67..457544612e 100644 --- a/_includes/alt-details.html +++ b/_includes/alt-details.html @@ -1,6 +1,6 @@ -
    - -
    +
    + +
    {{include.detail}}
    diff --git a/_includes/code-snippet.html b/_includes/code-snippet.html index 6267a08ad3..3af87d0f97 100644 --- a/_includes/code-snippet.html +++ b/_includes/code-snippet.html @@ -1,8 +1,8 @@ -
    +
    {% unless include.nocopy %} -
    -
    +
    +
    {% endunless %} - 
    {{include.codeSnippet}}
    + 
    {{include.codeSnippet}}
    diff --git a/_includes/getting-started.md b/_includes/getting-started.md index 45c42b166f..0a00d4d358 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -24,27 +24,24 @@ Install it on your system with the following instructions. Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL{% endcapture %}
    -
    -
    -
    -
    - {% include tabsection.html language='en' extraClasses='inline-tabs' category='get-started' collection=site.install_tabs %} - {% capture checkSetupDetail %} -
    -

    Check your setup with the command scala -version, which should output:

    - {% include code-snippet.html codeSnippet=scalaDemo language='bash' nocopy=true %} -

    If that does not work, you may need to log out and log back in (or reboot) in order for the changes to take effect.

    -
    - {% endcapture %} - {% include alt-details.html - title='Testing your setup' - detail=checkSetupDetail - targetId='macos-get-started-alt1' - extraClasses='scala-text scala-text-large' - %} -
    +
    +
    + {% include tabsection.html language='en' id='install-cs-setup-tabs' collection=site.install_tabs %} +
    + {% capture checkSetupDetail %} +
    +
    +

    Check your setup with the command scala -version, which should output:

    + {% include code-snippet.html nocopy=true language='bash' codeSnippet=scalaDemo %} +

    If that does not work, you may need to log out and log back in (or reboot) in order for the changes to take + effect. +

    + {% endcapture %} +
    + {% include alt-details.html id='testing-your-setup' title='Testing your setup' detail=checkSetupDetail %} +
    diff --git a/_includes/tabsection.html b/_includes/tabsection.html index a03f01130f..ad62625e63 100644 --- a/_includes/tabsection.html +++ b/_includes/tabsection.html @@ -1,24 +1,19 @@ -
    -
    +
    +
      {% for tabRoot in include.collection %} {% if tabRoot.language == include.language %} - +
    • + {{tabRoot.tabLabel}} +
      • {% endif %} {% endfor %} -
    + {% for tabRoot in include.collection %} {% if tabRoot.language == include.language %} -
    {{tabRoot.content}}
    +
    + {{tabRoot.content}} +
    {% endif %} {% endfor %}
    diff --git a/_install_tabs/1-macos.html b/_install_tabs/1-macos.html new file mode 100644 index 0000000000..2f34dcbe3b --- /dev/null +++ b/_install_tabs/1-macos.html @@ -0,0 +1,20 @@ +--- +tabId: osx +tabLabel: macOS +language: en +--- +
    +
    +

    Run the following command in your terminal, following the on-screen instructions:

    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} + {% capture homebrewDetail %} +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +
    + {% endcapture %} + {% include alt-details.html + title="Alternatively, if you don't use Homebrew:" + detail=homebrewDetail + %} +
    +
    diff --git a/_install_tabs/1-macos.md b/_install_tabs/1-macos.md deleted file mode 100644 index e8dc277265..0000000000 --- a/_install_tabs/1-macos.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -tabId: osx -tabLabel: macOS -language: en ---- -
    -
    -
    -
    -

    Run the following command in your terminal, following the on-screen instructions:

    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} - {% assign homebrewAlt = "Alternatively, if you don't use Homebrew:" %} - {% capture homebrewDetail %} -
    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} -
    - {% endcapture %} - {% include alt-details.html - title=homebrewAlt - detail=homebrewDetail - targetId='macos-get-started-alt' - extraClasses='scala-text-large alt-details-detail' - %} -
    -
    -
    -
    diff --git a/_install_tabs/2-linux.html b/_install_tabs/2-linux.html new file mode 100644 index 0000000000..5f29b25c2b --- /dev/null +++ b/_install_tabs/2-linux.html @@ -0,0 +1,11 @@ +--- +tabId: linux +tabLabel: Linux +language: en +--- +
    +
    +

    Run the following command in your terminal, following the on-screen instructions:

    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +
    +
    diff --git a/_install_tabs/2-linux.md b/_install_tabs/2-linux.md deleted file mode 100644 index a5a8eb7169..0000000000 --- a/_install_tabs/2-linux.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -tabId: linux -tabLabel: Linux -language: en ---- -
    -
    -
    -
    -

    Run the following command in your terminal, following the on-screen instructions:

    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} -
    -
    -
    -
    diff --git a/_install_tabs/3-windows.html b/_install_tabs/3-windows.html new file mode 100644 index 0000000000..01da9c604b --- /dev/null +++ b/_install_tabs/3-windows.html @@ -0,0 +1,11 @@ +--- +tabId: windows +tabLabel: Windows +language: en +--- +
    +
    +

    Download and execute the Scala + installer for Windows based on Coursier, and follow the on-screen instructions.

    +
    +
    diff --git a/_install_tabs/3-windows.md b/_install_tabs/3-windows.md deleted file mode 100644 index 9d9ae82c68..0000000000 --- a/_install_tabs/3-windows.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -tabId: windows -tabLabel: Windows -language: en ---- -
    -
    -
    -
    -

    Download and execute the Scala - installer for Windows based on Coursier, and follow the on-screen instructions.

    -
    -
    -
    -
    diff --git a/_install_tabs/4-other.html b/_install_tabs/4-other.html new file mode 100644 index 0000000000..638409d939 --- /dev/null +++ b/_install_tabs/4-other.html @@ -0,0 +1,15 @@ +--- +tabId: other +tabLabel: Other +fallbackNoJS: true +language: en +--- +
    +
    + +

    Follow the documentation from Coursier on how to install and run cs setup.

    +
    +
    diff --git a/_install_tabs/4-other.md b/_install_tabs/4-other.md deleted file mode 100644 index 00ceb97edb..0000000000 --- a/_install_tabs/4-other.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -tabId: other -tabLabel: Other -fallbackNoJS: true -language: en ---- -
    -
    -
    -
    - -

    Follow the documentation from Coursier on how to install and run cs setup.

    -
    -
    -
    -
    diff --git a/_install_tabs/fr-1-macos.html b/_install_tabs/fr-1-macos.html new file mode 100644 index 0000000000..2aa67ed447 --- /dev/null +++ b/_install_tabs/fr-1-macos.html @@ -0,0 +1,19 @@ +--- +tabId: osx +tabLabel: macOS +language: fr +--- +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} + {% capture homebrewDetail %} +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +
    + {% endcapture %} + {% include alt-details.html + title="Alternativement, si vous n'utilisez pas Homebrew:" + detail=homebrewDetail + %} +
    +
    diff --git a/_install_tabs/fr-1-macos.md b/_install_tabs/fr-1-macos.md deleted file mode 100644 index 836b8f53e1..0000000000 --- a/_install_tabs/fr-1-macos.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -tabId: osx -tabLabel: macOS -language: fr ---- -
    -
    -
    -
    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} - {% assign homebrewAlt = "Alternativement, si vous n'utilisez pas Homebrew:" %} - {% capture homebrewDetail %} -
    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} -
    - {% endcapture %} - {% include alt-details.html - title=homebrewAlt - detail=homebrewDetail - targetId='macos-get-started-alt' - extraClasses='scala-text-large alt-details-detail' - %} -
    -
    -
    -
    diff --git a/_install_tabs/fr-2-linux.html b/_install_tabs/fr-2-linux.html new file mode 100644 index 0000000000..df2e1ccdba --- /dev/null +++ b/_install_tabs/fr-2-linux.html @@ -0,0 +1,10 @@ +--- +tabId: linux +tabLabel: Linux +language: fr +--- +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +
    +
    diff --git a/_install_tabs/fr-2-linux.md b/_install_tabs/fr-2-linux.md deleted file mode 100644 index 18a0925149..0000000000 --- a/_install_tabs/fr-2-linux.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -tabId: linux -tabLabel: Linux -language: fr ---- -
    -
    -
    -
    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} -
    -
    -
    -
    diff --git a/_install_tabs/fr-3-windows.html b/_install_tabs/fr-3-windows.html new file mode 100644 index 0000000000..7da64e60a0 --- /dev/null +++ b/_install_tabs/fr-3-windows.html @@ -0,0 +1,10 @@ +--- +tabId: windows +tabLabel: Windows +language: fr +--- +
    +
    +

    Téléchargez et exécutez l'intallateur Scala pour Windows basé sur Coursier

    +
    +
    diff --git a/_install_tabs/fr-3-windows.md b/_install_tabs/fr-3-windows.md deleted file mode 100644 index 2c22382b2e..0000000000 --- a/_install_tabs/fr-3-windows.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -tabId: windows -tabLabel: Windows -language: fr ---- -
    -
    -
    -
    -

    Téléchargez et exécutez l'intallateur Scala pour Windows basé sur Coursier

    -
    -
    -
    -
    diff --git a/_install_tabs/fr-4-other.html b/_install_tabs/fr-4-other.html new file mode 100644 index 0000000000..770366796e --- /dev/null +++ b/_install_tabs/fr-4-other.html @@ -0,0 +1,15 @@ +--- +tabId: other +tabLabel: Other +fallbackNoJS: true +language: fr +--- +
    +
    + +

    Suivez les instructions pour installer la commande + cspuis exécutez ./cs setup.

    +
    +
    diff --git a/_install_tabs/fr-4-other.md b/_install_tabs/fr-4-other.md deleted file mode 100644 index 89bee815a8..0000000000 --- a/_install_tabs/fr-4-other.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -tabId: other -tabLabel: Other -fallbackNoJS: true -language: fr ---- -
    -
    -
    -
    - -

    Suivez les instructions pour installer la commande - cspuis exécutez ./cs setup.

    -
    -
    -
    -
    diff --git a/_install_tabs/ja-1-macos.html b/_install_tabs/ja-1-macos.html new file mode 100644 index 0000000000..acb2ae7798 --- /dev/null +++ b/_install_tabs/ja-1-macos.html @@ -0,0 +1,19 @@ +--- +tabId: osx +tabLabel: macOS +language: ja +--- +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} + {% capture homebrewDetail %} +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +
    + {% endcapture %} + {% include alt-details.html + title="または、Homebrewを使用しない場合は" + detail=homebrewDetail + %} +
    +
    diff --git a/_install_tabs/ja-1-macos.md b/_install_tabs/ja-1-macos.md deleted file mode 100644 index 792efacfc2..0000000000 --- a/_install_tabs/ja-1-macos.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -tabId: osx -tabLabel: macOS -language: ja ---- -
    -
    -
    -
    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} - {% assign homebrewAlt = "または、Homebrewを使用しない場合は" %} - {% capture homebrewDetail %} -
    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} -
    - {% endcapture %} - {% include alt-details.html - title=homebrewAlt - detail=homebrewDetail - targetId='macos-get-started-alt' - extraClasses='scala-text-large alt-details-detail' - %} -
    -
    -
    -
    diff --git a/_install_tabs/ja-2-linux.html b/_install_tabs/ja-2-linux.html new file mode 100644 index 0000000000..42b98e6a67 --- /dev/null +++ b/_install_tabs/ja-2-linux.html @@ -0,0 +1,10 @@ +--- +tabId: linux +tabLabel: Linux +language: ja +--- +
    +
    + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +
    +
    diff --git a/_install_tabs/ja-2-linux.md b/_install_tabs/ja-2-linux.md deleted file mode 100644 index a59f88d1e1..0000000000 --- a/_install_tabs/ja-2-linux.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -tabId: linux -tabLabel: Linux -language: ja ---- -
    -
    -
    -
    - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} -
    -
    -
    -
    diff --git a/_install_tabs/ja-3-windows.html b/_install_tabs/ja-3-windows.html new file mode 100644 index 0000000000..f70ffba026 --- /dev/null +++ b/_install_tabs/ja-3-windows.html @@ -0,0 +1,10 @@ +--- +tabId: windows +tabLabel: Windows +language: ja +--- +
    +
    +

    the Scala installer for Windowsを、ダウンロードして実行してください。

    +
    +
    diff --git a/_install_tabs/ja-3-windows.md b/_install_tabs/ja-3-windows.md deleted file mode 100644 index 76ff527bea..0000000000 --- a/_install_tabs/ja-3-windows.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -tabId: windows -tabLabel: Windows -language: ja ---- -
    -
    -
    -
    -

    the Scala installer for Windowsを、ダウンロードして実行してください。

    -
    -
    -
    -
    diff --git a/_install_tabs/ja-4-other.html b/_install_tabs/ja-4-other.html new file mode 100644 index 0000000000..5a4b39e484 --- /dev/null +++ b/_install_tabs/ja-4-other.html @@ -0,0 +1,14 @@ +--- +tabId: other +tabLabel: Other +fallbackNoJS: true +language: ja +--- +
    +
    + +

    手順に従って cs ランチャーをインストールし、その次に以下を実行します。./cs setup

    +
    +
    diff --git a/_install_tabs/ja-4-other.md b/_install_tabs/ja-4-other.md deleted file mode 100644 index 0e400d4fcb..0000000000 --- a/_install_tabs/ja-4-other.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -tabId: other -tabLabel: Other -fallbackNoJS: true -language: ja ---- -
    -
    -
    -
    - -

    手順に従って cs ランチャーをインストールし、その次に以下を実行します。./cs setup

    -
    -
    -
    -
    diff --git a/_sass/base/helper.scss b/_sass/base/helper.scss index 1b32d31165..7f13553247 100755 --- a/_sass/base/helper.scss +++ b/_sass/base/helper.scss @@ -7,6 +7,23 @@ @include padding(0 20px); } +.place-inline { + // add vertical margin + @include outer-container; + @include margin(20px 0); +} + +.wrap-inline { + // add vertical padding + @include outer-container; + @include padding(20px 0); +} + +.wrap-narrow { + @include outer-container; + @include padding(0 10px); +} + .dot { font-size: 10px; color: rgba($base-font-color-light, 0.6); diff --git a/_sass/components/alt-details.scss b/_sass/components/alt-details.scss new file mode 100644 index 0000000000..bacb1f2b3d --- /dev/null +++ b/_sass/components/alt-details.scss @@ -0,0 +1,44 @@ +// ALT-DETAILS +//------------------------------------------------ +//------------------------------------------------ + +.alt-details { + @include span-columns(12); + + .alt-details-toggle { + @include span-columns(12); + border: none; + background-color: $brand-tertiary; + padding: 5px 10px; + border-radius: $border-radius-large; + font-size: $font-size-medium; + cursor: pointer; + font-weight: 500; + color: $gray-dark; + + &:hover { + background-color: darken($brand-tertiary, 15%); + } + + &:after { + content: "\f13a"; // + font-family: "Font Awesome 5 Free"; + font-weight: 900; + font-size: 15px; + float: right; + margin-top: 2px; + } + + &.alt-details-closed:after { + content: "\f138"; // + } + } + + .alt-details-detail { + // The detail box appears to be underneath the toggle button + // so we add a padding to the top and push it up. + border: $base-border-gray; + padding-top: 15px; + margin-top: 15px; + } +} diff --git a/_sass/components/code.scss b/_sass/components/code.scss index e771eb6ad1..15e8c641e3 100755 --- a/_sass/components/code.scss +++ b/_sass/components/code.scss @@ -23,3 +23,45 @@ } } + +.code-snippet-area { + width: 100%; + margin-top: 1em; + margin-bottom: 1em; + position: relative; // so we can position the buttons + + &:hover { + + // display the copy buttons on hover of the whole area + .code-snippet-buttons { + opacity: 0.95; + + &:active { + transition: none; + opacity: 0.7; + } + } + } + + .code-snippet-buttons { + opacity: 0; // default invisible until hover + transition: $base-transition; + position: absolute; // so we can position the buttons + right: 3px; + top: 5px; + + button { + border: none; + background: #fff; + font-size: $font-size-medium; + color: $gray-darker; + cursor: pointer; + } + } + + .code-snippet-display { + margin-top: 0px; + margin-bottom: 0px; + width: 100%; + } +} diff --git a/_sass/components/tab.scss b/_sass/components/tab.scss index b5a9bb89c3..cbd5010d79 100755 --- a/_sass/components/tab.scss +++ b/_sass/components/tab.scss @@ -7,10 +7,11 @@ @include display(flex); @include align-items(center); @include justify-content(flex-start); - margin-bottom: 10px; .item-tab { + a { + transition: none; // do not animate the transition to active color: $base-font-color-light; display: block; padding: 0 20px 10px; @@ -23,21 +24,55 @@ color: $base-font-color; } + &:hover { + cursor: pointer; + } + &.active { border-bottom: 2px solid $brand-primary; + padding: 0 20px 8px; // so text does not jump up when active color: $brand-primary; pointer-events: none; } } } + @include bp(small) { @include justify-content(space-between); + .item-tab { - a { - padding: 0 10px 10px; - font-size: $font-size-medium; + a { + transition: none; // do not animate the transition to active + padding: 0 10px 10px; + font-size: $font-size-medium; + } } + } +} + +.tabsection { + border-bottom: $base-border-gray; + border-left: $base-border-gray; + border-right: $base-border-gray; + border-radius: $border-radius-medium; + + .nav-tab { + padding-left: 0; + margin-bottom: 0; + + .item-tab { + padding: 0; + margin-bottom: 0; + list-style: none; } } } + +.tabcontent { + display: none; + + &.active { + display: block; + } +} diff --git a/_sass/layout/alt-details.scss b/_sass/layout/alt-details.scss deleted file mode 100644 index aae4addefb..0000000000 --- a/_sass/layout/alt-details.scss +++ /dev/null @@ -1,46 +0,0 @@ -// ALT-DETAILS -//------------------------------------------------ -//------------------------------------------------ - -.alt-details { - margin: 10px 0px; - - button.alt-details-toggle { - width: 100%; - border: none; - background-color: #b635c4; - padding: 5px 10px; - border-radius: 15px; - font-size: $font-size-medium; - cursor: pointer; - font-weight: 500; - color: #fff; - - &:hover { - background-color: #941fa1; - } - - &:after { - content: "\f13a"; // - font-family: "Font Awesome 5 Free"; - font-weight: 900; - font-size: 15px; - color: #fff; - float: right; - margin-top: 2px; - } - - &.alt-details-closed:after { - content: "\f138"; // - } - } - - .alt-details-detail { - background-color: rgb(248, 226, 255); - border: 1px solid rgb(239, 207, 248); - padding-top: 25px; - padding-bottom: 10px; - margin-top: -15px; - margin-bottom: 10px; - } -} diff --git a/_sass/layout/scala-in-action.scss b/_sass/layout/scala-in-action.scss deleted file mode 100755 index 297dda244e..0000000000 --- a/_sass/layout/scala-in-action.scss +++ /dev/null @@ -1,159 +0,0 @@ -// SCALA-IN-ACTION -//------------------------------------------------ -//------------------------------------------------ - -.scala-in-action { - - .tabcontent { - .scala-text { - .alt-details { - button.alt-details-toggle { - border: 1px solid #a0dff0; - background-color: #d1e5eb; - color: $gray; - - &:hover { - background-color: #b8deea; - } - - &:after { - color: $gray; - } - } - - .alt-details-detail { - background-color: $gray-light; - border: 1px solid darken($gray-light, 3%); - } - } - } - } - - .scala-in-action-content { - transition: $base-transition; - - - .scala-in-action-code { - // display: none; - // background: $gray-dark; - padding: 20px 0; - - .wrap { - margin-bottom: 0px; - } - - .snippet { - position: relative; - margin: 10px 0px; - cursor: default; - width: 100%; - - &:hover { - .buttons { - opacity: 0.95; - - &:active { - opacity: 0.3; - } - } - } - - .buttons { - position: absolute; - right: 4px; - top: 5px; - transition: all .2s ease; - display: flex; - opacity: 0; - flex-direction: row-reverse; - justify-content: flex-start; - - button { - outline: none; - background: #fff; - border: none; - font-size: $font-size-medium; - color: rgba($gray, .6); - cursor: pointer; - - i { - font-weight: $font-bold; - } - } - } - - pre.snippet-code { - margin: 0px; - display: block; - overflow-x: auto; - - code { - overflow-x: auto; - display: block; - } - } - } - - .scala-code { - - @include span-columns(7); - - @include bp(large) { - @include span-columns(12); - } - } - - .scala-text { - - details { - summary { - - &:hover { - background-color: lighten($gray-lighter, 5%); - } - } - - summary>* { - display: inline; - } - } - - code { - padding: 3px 6px; - color: #859900; - background-color: #fff; - border-radius: 10px; - border: 1px solid $gray-light; - } - - .snippet { - pre.snippet-code { - code { - padding: 7px 6px; - border: 1px solid darken($gray-light, 10%); - } - } - } - - @include span-columns(5); - - @include bp(large) { - @include span-columns(12); - } - - h3 { - font-size: 1.525rem; - margin-bottom: 20px; - } - - p { - color: $base-font-color; - } - - &.scala-text-large { - @include span-columns(12); - } - } - } - } -} diff --git a/_sass/layout/tabsection.scss b/_sass/layout/tabsection.scss deleted file mode 100755 index 71c2777183..0000000000 --- a/_sass/layout/tabsection.scss +++ /dev/null @@ -1,60 +0,0 @@ -// TABSECTION -//------------------------------------------------ -//------------------------------------------------ - -.recommended-install { - margin-top: -2em; - .tabsection { - background: $gray-lighter; - } -} - -.tabsection { - - &.inline-tabs { - margin: 20px 0px; - } - - /* Style the tab */ - .tab { - overflow: hidden; - margin-bottom: -12px; - } - - /* Style the buttons that are used to open the tab content */ - .tab button { - font-family: $heading-font-family; - font-size: $font-size-medium; - font-weight: $font-bold; - color: lighten($gray, 25%); - background-color: inherit; - float: left; - border: none; - border-radius: 30px; - outline: none; - cursor: pointer; - padding: 14px 16px; - } - - /* Change background color of buttons on hover */ - .tab button:hover { - color: #fff; - background-color: $gray; - border-bottom: $base-border-white; - } - - /* Create an active/current tablink class */ - .tab button.active { - background-color: $gray; - border-bottom: $base-border-white; - color: #fff; - } - - /* Style the tab content */ - .tabcontent { - display: none; - padding: 0px 2px; - border-top: none; - transition: all .5s linear; - } -} diff --git a/_sass/layout/type-md.scss b/_sass/layout/type-md.scss index 0696bee09f..f4b70816bc 100755 --- a/_sass/layout/type-md.scss +++ b/_sass/layout/type-md.scss @@ -87,6 +87,11 @@ margin-bottom: 18px; } + p + .code-snippet-area { + // remove the margin-top for code snippet following a paragraph + margin-top: 0px; + } + h4, h5 { margin-bottom: 0.5rem; } @@ -142,6 +147,19 @@ text-decoration: line-through; } + li, + p, + tr, + td, + dt, + dd, + pre { + // common code for all code (inline and blocks) + code { + border: $base-border-gray; + } + } + li, p, tr, @@ -150,23 +168,20 @@ dd { code { font-family: 'Consolas'; - @include border-radius($border-radius-small); - font-size: $font-size-medium; - background: $gray-lighter; - color: #667b83; - // border: 1px solid #ced7d7; - padding: 1px 3px; - margin: 0 2px; + background-color: #fff; + color: #859900; + @include border-radius($border-radius-medium); + padding: 2px 6px; } } pre { - margin-bottom: 36px; - code { - padding: 20px; + overflow-x: auto; + display: block; font-size: $font-size-medium; @include border-radius($border-radius-base); + padding: 10px 7px; } } diff --git a/_sass/utils/_variables.scss b/_sass/utils/_variables.scss index 33277a1b03..f99d09cd96 100755 --- a/_sass/utils/_variables.scss +++ b/_sass/utils/_variables.scss @@ -74,6 +74,8 @@ $padding-small: 20px; //------------------------------------------------ $border-radius-base: 3px; $border-radius-small: 2px; +$border-radius-medium: 10px; +$border-radius-large: 15px; // Breakpoints //------------------------------------------------ diff --git a/resources/css/style.scss b/resources/css/style.scss index 02ed07ce47..c7f0016ba9 100755 --- a/resources/css/style.scss +++ b/resources/css/style.scss @@ -28,9 +28,6 @@ @import 'layout/twitter-feed'; @import 'layout/cheatsheet'; @import 'layout/ides'; -@import 'layout/alt-details'; -@import 'layout/tabsection'; -@import 'layout/scala-in-action'; @import 'layout/nutshell'; @import 'layout/overviews'; @import 'layout/sips'; @@ -66,6 +63,7 @@ @import 'components/call-to-action'; @import 'components/slider'; @import 'components/heading-line'; +@import 'components/alt-details'; @import 'components/card'; @import 'components/calendar'; @import 'components/tooltip'; diff --git a/resources/js/functions.js b/resources/js/functions.js index cc61873b19..4d55b546dd 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -392,55 +392,70 @@ function getOS() { return osname; } -function toggleElement(evt, elemId) { - var btn = evt.target; - var elem = document.getElementById(elemId); - if (elem.style.display === "none") { - elem.style.display = "block"; - } else { - elem.style.display = "none"; - } - $(btn).toggleClass("alt-details-closed"); -} - -$(document).ready(function() { - $('.alt-details-toggle').click(); +$(document).ready(function () { + // for each .alt-details div, find the .alt-details-toggle button, + // and add a click handler to toggle the visibility of the .alt-details-detail + + $('.alt-details').each(function () { + var toggle = $(this).find('.alt-details-toggle'); + var details = $(this).find('.alt-details-detail'); + toggle.click(function () { + details.css('display') === 'none' ? details.show() : details.hide(); + toggle.toggleClass('alt-details-closed'); + }); + toggle.click(); + }); }); -function copySnippet(evt) { - var snippet = evt.target.closest('.snippet').querySelector('.snippet-code'); - var code = snippet.querySelector('code').innerText; - window.navigator.clipboard.writeText(code) -} - -function openTab(evt, category, tabName) { - // Get all elements with class="tabcontent" and hide them - $('.tabcontent-' + category + '.tabcontent').css('display', 'none'); - - var queried = evt.target; - - // Get all elements with class="tablinks" and remove the class "active" - $('.tablinks-' + category + '.tablinks').removeClass('active'); - - // Show the current tab, and add an "active" class to the button that opened the tab - document.getElementById(category + '-' + tabName).style.display = "block"; - queried.className += " active"; -} +$(document).ready(function () { + // for each code snippet area, find the copy button, + // and add a click listener that will copy text from + // the code area to the clipboard + $(".code-snippet-area").each(function () { + var area = this; + $(area).children(".code-snippet-buttons").children("button.copy-button").click(function () { + var code = $(area).children(".code-snippet-display").children("code").text(); + window.navigator.clipboard.writeText(code); + }); + }); +}); -$(document).ready(function() { - var defaultTabs = document.getElementsByClassName('default-tab'); - for (i = 0; i < defaultTabs.length; i++) { - defaultTabs[i].click(); - } +$(document).ready(function () { + $('.tabsection').each(function () { + var tabsection = this; + $(tabsection).find('.nav-tab > .item-tab > .item-tab-link').each(function () { + var tabLink = this; + var targetTab = $(tabLink).attr('data-target'); + $(tabLink).click(function () { + console.log("clicked on " + targetTab); + $(tabsection).find('.nav-tab > .item-tab > .item-tab-link').each(function () { + var otherTab = this; + var otherTarget = $(otherTab).attr('data-target'); + otherTarget === targetTab ? $(otherTab).addClass('active') : $(otherTab).removeClass('active'); + }) + $(tabsection).children('.tabcontent').each(function () { + var tabContent = this; + var tabId = $(tabContent).attr('data-tab'); + targetTab === tabId ? $(tabContent).addClass('active') : $(tabContent).removeClass('active'); + }); + }); + }); + }); }); $(document).ready(function () { + // click the get-started tab corresponding to the users OS. if ($(".main-download").length) { - let os = getOS(); + var os = getOS(); if (os === 'unix') { os = 'linux'; } - $("#get-started-tab-" + os).click(); + $("#install-cs-setup-tabs").find('.nav-tab > .item-tab > .item-tab-link').each(function () { + var targetTab = $(this).attr("data-target"); + if (targetTab === os) { + $(this).click(); + } + }); } }); From f38f5ff61bb9df1e5477ed1955a1573564dab3fa Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Wed, 11 May 2022 07:39:57 +0800 Subject: [PATCH 1861/3075] modify/correct _zh-cn/index.md --- _zh-cn/index.md | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/_zh-cn/index.md b/_zh-cn/index.md index 9e1e7d3507..c8da57c6e5 100644 --- a/_zh-cn/index.md +++ b/_zh-cn/index.md @@ -12,37 +12,37 @@ scala3-sections: - title: "第一步" links: - title: "Scala 3 中的新东西" - description: "Scala 3 现存新特性概览" + description: "Scala 3 中令人兴奋的新特性概览" icon: "fa fa-star" link: /scala3/new-in-scala3.html - title: "快速开始" - description: "安装 Scala 3 并开始写些 Scala 代码" + description: "在你的电脑中安装 Scala 3，然后开始写些 Scala 代码！" icon: "fa fa-rocket" link: /scala3/getting-started.html - - title: "Scala 3 书籍" - description: "一部介绍主要语言特性的线上书" + - title: "Scala 3 册子" + description: "通过一系列小课程来学习 Scala。" icon: "fa fa-book" link: /scala3/book/introduction.html - title: "更多细节" links: - title: "迁移指引" - description: "一份帮你从 Scala 2 迁移到 Scala 3 的指引" + description: "一份帮你从 Scala 2 迁移到 Scala 3 的指引。" icon: "fa fa-suitcase" link: /scala3/guides/migration/compatibility-intro.html - title: "导览" - description: "关于语言特别之处的详细导览" + description: "关于语言特别之处的详细导览。" icon: "fa fa-map" link: /zh-cn/scala3/guides.html - title: "Scala 库 API" - description: "Scala 3 标准库API文档（多个小版本）" + description: "Scala 3 每一个版本的标准库API文档。" icon: "fa fa-file-alt" link: https://scala-lang.org/api/3.x/ - title: "语言参考手册" - description: "Scala 3 语言参考手册" + description: "Scala 3 语言参考手册。" icon: "fa fa-book" link: https://docs.scala-lang.org/scala3/reference - title: "贡献指南" - description: "Scala 3 编译器指南及如何贡献代码" + description: "Scala 3 编译器指南及如何修复问题" icon: "fa fa-cogs" link: /scala3/guides/contribution/contribution-intro.html - title: "Scala 3 全新的 Scaladoc" @@ -109,4 +109,8 @@ scala2-sections: description: "Scala改进过程（Scala Improvement Process），语言及编译器进展" icon: "fa fa-cogs" link: /sips/index.html + - title: "为 Scala 作贡献" + description: "为 Scala 项目作贡献的完整指南" + icon: "fa fa-cogs" + link: /contribute/ --- From 30add3033c86a06478f4af1962dbad3c04e3f5f7 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Wed, 11 May 2022 08:24:45 +0800 Subject: [PATCH 1862/3075] modify _zh-cn/scala3/new-in-scala3.md --- _zh-cn/scala3/new-in-scala3.md | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/_zh-cn/scala3/new-in-scala3.md b/_zh-cn/scala3/new-in-scala3.md index 8308c7ac89..5f82276635 100644 --- a/_zh-cn/scala3/new-in-scala3.md +++ b/_zh-cn/scala3/new-in-scala3.md @@ -1,10 +1,9 @@ --- layout: singlepage-overview -title: New in Scala 3 +title: Scala 3 里的新东西 scala3: true --- - -令人振奋的新版 Scala 3 带来了许多改进和新功能。在这里，我们为你提供最重要的变更的快速概述。如果你想深入挖掘，还有一些参考资料供你使用。 +令人振奋的新版 Scala 3 带来了许多改进和新功能。在这里，我们为你提供最重要的变更的快速概述。如果你想深入挖掘，还有一些参考资料供你使用： - [Scala 3 Book]({% link _overviews/scala3-book/introduction.md %}) 面向刚接触 Scala 语言的开发人员。 - [Syntax Summary][syntax-summary] 为您提供了新语法的正式描述。 @@ -12,11 +11,10 @@ scala3: true - [Migration Guide][migration] 为你提供了从 Scala 2 迁移到 Scala 3 的所有必要信息。 - [Scala 3 Contributing Guide][contribution] Scala 3 贡献指南，更深入地探讨了编译器，包括修复问题的指南。 -## What's new in Scala 3 +## Scala 3 里有什么新东西 Scala 3 是对 Scala 语言的一次彻底改造。在其核心部分，类型系统的许多方面都被改变了，变得更有原则性。虽然这也带来了令人兴奋的新功能（比如联合类型），但首先意味着类型系统变得（甚至）不那么碍事了，例如[类型推断][type-inference]和 overload resolution 都得到了很大的改善。 ### 新的和闪亮的：语法 - 除了许多（小的）清理工作，Scala 3 的语法还提供了以下改进： - 用于控制结构的新“quiet”语法，如 `if`、`while` 和 `for` 。 ([new control syntax][syntax-control]) @@ -25,10 +23,10 @@ Scala 3 是对 Scala 语言的一次彻底改造。在其核心部分，类型 - [类型级通配符][syntax-wildcard] 从 `_` 更改为 `?`。 - implicit（和它们的语法）已被[大量修订][implicits]。 -### Opinionated: Contextual Abstractions -Scala的一个基本核心概念是（在某种程度上仍然是）为用户提供一小部分强大的功能，这些功能可以被组合成巨大的（有时甚至是不可预见的）表达能力。例如，_implicit_ 的特性被用来模拟上下文抽象、表达类型级计算、模拟类型类、执行隐式强制、编码扩展方法等等。从这些用例中学习，Scala 3 采取了一种略微不同的方法，专注于 __意图__ 而非 __机制__。Scala 3 没有提供一个非常强大的功能，而是提供了多个定制的语言功能，让程序员直接表达他们的意图。 +### Opinionated: 上下文抽象 +Scala的一个基本核心概念是（在某种程度上仍然是）为用户提供一小部分强大的功能，这些功能可以被组合成巨大的（有时甚至是不可预见的）表达能力。例如，_implicit_ 的特性被用来模拟上下文抽象、表达类型级计算、模拟类型类、执行隐式强制、编码扩展方法等等。从这些用例中学习，Scala 3 采取了一种略微不同的方法，专注于 **意图** 而非 **机制**。Scala 3 没有提供一个非常强大的功能，而是提供了多个定制的语言功能，让程序员直接表达他们的意图。 -- **Abtracting over contextual information**. [Using clauses][contextual-using] 允许程序员对调用上下文中的信息进行抽象，这些信息应该以隐式方式传递。作为对 Scala 2 implicits 的改进，可以按类型指定`using`子句，从而将函数签名从从未显式引用的术语变量名中解放出来。 +- **Abtracting over contextual information**. [Using clauses][contextual-using] 允许程序员对调用上下文中的信息进行抽象，这些信息应该以隐式方式传递。作为对 Scala 2 implicits 的改进，可以按类型指定 using 子句，从而将函数签名从从未显式引用的术语变量名中解放出来。 - **Providing Type-class instances**. [Given instances][contextual-givens] 允许程序员定义某个类型的 _规范值_ 。这使得使用类型类的编程更加简单，而不会泄露实现细节。 @@ -40,8 +38,8 @@ Scala的一个基本核心概念是（在某种程度上仍然是）为用户提 - **Actionable feedback from the compiler**. 如果一个隐式参数不能被编译器解决，它现在提供了可能解决这个问题的[import suggestions](https://www.scala-lang.org/blog/2020/05/05/scala-3-import-suggestions.html)。 -### Say What You Mean: 类型系统改进 -除了极大地改进了类型推断，Scala 3 类型系统还提供了许多新的功能，还为你提供了强大的工具来静态地表达类型中的不变量。 +### 表达真正的意思: 类型系统改进 +除了极大地改进了类型推断，Scala 3 类型系统还提供了许多新的功能，还为你提供了强大的工具来静态地表达类型中的不变量： - **Enumerations**. [枚举][enums]已经被重新设计，以便与样例类很好地融合，并形成表达[代数数据类型][enums-adts]的新标准。 @@ -58,7 +56,6 @@ Scala的一个基本核心概念是（在某种程度上仍然是）为用户提 - **Match types**. Scala 3 提供了对[matching on types][types-match]的直接支持，而不是使用隐式解析对类型级别的计算进行编码。将类型级计算整合到类型检查器中，可以改进错误信息，并消除对复杂编码的需求。 ### Re-envisioned：面向对象的编程 - Scala 一直处于函数式编程和面向对象编程的前沿 -- 而 Scala 3 在这两个方向上都推动了边界的发展! 上述类型系统的变化和上下文抽象的重新设计使得 _函数式编程_ 比以前更容易。同时，以下的新特性使结构良好的 _面向对象设计_ 成为可能，并支持最佳实践。 - **Pass it on**. Trait 更接近于 class，现在也可以接受[参数][oo-trait-parameters]，使其作为模块化软件分解的工具更加强大。 @@ -79,7 +76,6 @@ Scala 2 中的宏只是一个实验性的功能，而 Scala 3 则为元编程提 - **Quoted code blocks**. Scala 3为代码增加了[quasi-quotation][meta-quotes]的新功能，这为构建和分析代码提供了方便的高级接口。构建加一加一的代码就像`'{ 1 + 1 }`一样简单。 - **Reflection API**. 对于更高级的用例，[quotes.reflect][meta-reflection]提供了更详细的控制来检查和生成程序树。 - 如果你想进一步了解 Scala 3 中的元编程，我们邀请你参阅我们的[教程][meta-tutorial]。 [enums]: {{ site.scala3ref }}/enums/enums.html From 1c937b8a3cf7e58a8b611e29357f0f45fd2829af Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Wed, 11 May 2022 17:28:50 +0800 Subject: [PATCH 1863/3075] add _zh-cn/scala3/guides/tasty-overview.md --- _zh-cn/scala3/guides/tasty-overview.md | 146 +++++++++++++++++++++++++ 1 file changed, 146 insertions(+) create mode 100644 _zh-cn/scala3/guides/tasty-overview.md diff --git a/_zh-cn/scala3/guides/tasty-overview.md b/_zh-cn/scala3/guides/tasty-overview.md new file mode 100644 index 0000000000..ca2d4260c5 --- /dev/null +++ b/_zh-cn/scala3/guides/tasty-overview.md @@ -0,0 +1,146 @@ +--- +layout: singlepage-overview +title: TASTy 概览 +--- +假定你创建了一个 Scala 3 源代码文件叫 _Hello.scala_: + +```scala +@main def hello = println("Hello, world") +``` + +然后用 `scalac` 编译了该文件： + +```bash +$ scalac Hello.scala +``` + +你会发现在 `scalac` 生成的其它文件结果中，有些文件是以 _.tasty_ 为扩展名： + +```bash +$ ls -1 +Hello$package$.class +Hello$package.class +Hello$package.tasty +Hello.scala +hello.class +hello.tasty +``` + +这自然地会引出一个问题，“什么是 tasty？” + +## 什么是 TASTy? + +TASTy 是从 _Typed Abstract Syntax Trees_ 这个术语的首字母缩写来的。它是 Scala 3 的高级交换格式，在本文档中，我们将它称为 _Tasty_ 。 + +首先要知道的是，Tasty 文件是由 `scalac` 编译器生成的，并且包含 _所有_ 有关源代码的信息，这些信息包括程序的语法结构，以及有关类型，位置甚至文档的 _所有_ 信息。Tasty 文件包含的信息比 _.class_ 文件多得多，后者是为在 JVM 上运行而生成的。（后面有详细介绍）。 + +在 Scala 3 中，编译流程像这样： + +```text + +-------------+ +-------------+ +-------------+ +$ scalac | Hello.scala | -> | Hello.tasty | -> | Hello.class | + +-------------+ +-------------+ +-------------+ + ^ ^ ^ + | | | + 你的代码 TASTy 文件 Class 文件 + 用于 scalac 用于 JVM + （包括完整信息） （不完整信息） +``` + +您可以通过使用 `-print-tasty` 标志在 _.tasty_ 文件上运行编译器，以人类可读的形式查看 _.tasty_ 文件的内容。 +您还可以使用 `-decompile` 标志以类似于 Scala 源代码的形式查看反编译的内容。 + +```bash +$ scalac -print-tasty hello.tasty +$ scalac -decompile hello.tasty +``` + +### The issue with _.class_ files + +由于象 [类型擦除][erasure] 等问题，_.class_ 文件实际上是代码的不完整表示形式。 +演示这一点的一种简单方法是使用 `List` 示例。 + +_类型擦除_ 意味着当你编写这样的 Scala 代码时，它假定在 JVM 上运行： + +```scala +val xs: List[Int] = List(1, 2, 3) +``` + +该代码被编译为需要与 JVM 兼容的 _.class_ 文件。由于该兼容性要求，该类文件中的代码 --- 您可以使用 `javap` 命令看到它，--- 最终看起来像这样： + +```java +public scala.collection.immutable.List xs(); +``` + +该 `javap` 命令输出显示了类文件中包含的内容，该内容是 Java 的表示形式。请注意，在此输出中，`xs` _不是_ 定义为 `List[Int]` ；它基本上表示为 `List[java.lang.Object]` 。为了使您的 Scala 代码与 JVM 配合使用，`Int` 类型已被擦除。 + +稍后，当您在 Scala 代码中访问 `List[Int]` 的元素时，像这样： + +```scala +val x = xs(0) +``` + +生成的类文件对此行代码进行强制转换操作，您可以将其想象成： + +``` +int x = (Int) xs.get(0) // Java-ish +val x = xs.get(0).asInstanceOf[Int] // more Scala-like +``` + +同样，这样做是为了兼容性，因此您的 Scala 代码可以在 JVM 上运行。但是，我们已经有的整数列表的信息在类文件中丢失了。 +当尝试使用已编译的库来编译 Scala 程序时，会带来问题。为此，我们需要比类文件中通常可用的信息更多的信息。 + +此讨论仅涵盖类型擦除的主题。对于 JVM 没有意识到的所有其他 Scala 结构，也存在类似的问题，包括 unions, intersections, 带有参数的 traits 以及更多 Scala 3 特性。 + +### TASTy to the Rescue + +因此，TASTy 格式不是没有关于 _.class_ 文件中原始类型的信息，或者只有公共 API（如Scala 2.13 “Pickle” 格式），而是在类型检查后存储完整的抽象语法树（AST）。存储整个 AST 有很多优点：它支持单独编译，针对不同的 JVM 版本重新编译，程序的静态分析等等。 + +### 重点 + +因此，这是本节的第一个要点：您在 Scala 代码中指定的类型在 _.class_ 文件中没有完全准确地表示。 + +第二个关键点是要了解 _编译时_ 和 _运行时_ 提供的信息之间存在差异： + +- 在**编译时**，当 `scalac` 读取和分析你的代码时，它知道 `xs` 是一个 `List[Int]` +- 当编译器将你的代码写入类文件时，它会写 `xs` 是 `List[Object]` ，并在访问 `xs` 的任何地方添加转换信息 +- 然后在**运行时** --- 你的代码在 JVM 中运行，--- JVM 不知道你的列表是一个 `List[Int]` + +对于 Scala 3 和 Tasty，这里有一个关于编译时的重要说明： + +- 当您编写使用其他 Scala 3 库的 Scala 3 代码时，`scalac` 不必再读取其 _.class_ 文件;它可以读取其 _.tasty_ 文件，如前所述，这些文件是代码的 _准确_ 表示形式。这对于在 Scala 2.13 和 Scala 3 之间实现单独编译和兼容性非常重要。 + +## Tasty 的好处 + +可以想象，拥有代码的完整表示形式具有[许多好处][benefits]： + +- 编译器使用它来支持单独的编译。 +- Scala 基于 _Language Server Protocol_ 的语言服务器使用它来支持超链接、命令补全、文档以及全局操作，如查找引用和重命名。 +- Tasty 为新一代[基于反射的宏][macros]奠定了良好的基础。 +- 优化器和分析器可以使用它进行深度代码分析和高级代码生成。 + +在相关的说明中，Scala 2.13.6 有一个 TASTy 读取器，Scala 3 编译器也可以读取2.13“Pickle”格式。Scala 3 迁移指南中的 [类路径兼容性页面][compatibility-ref] 解释了此交叉编译功能的好处。 + +## 更多信息 + +总之，Tasty 是 Scala 3 的高级交换格式，_.tasty_ 文件包含源代码的完整表示形式，从而带来了上一节中概述的好处。 + +有关更多详细信息，请参阅以下资源： + +- 在 [此视频](https://www.youtube.com/watch?v=YQmVrUdx8TU) 中，Scala 中心的Jamie Thompson 对 Tasty 的工作原理及其优势进行了详尽的讨论 +- [库作者的二进制兼容性][binary] 讨论二进制兼容性、源代码兼容性和 JVM 执行模型 +- [Scala 3 Transition 的前向兼容性](https://www.scala-lang.org/blog/2020/11/19/scala-3-forward-compat.html) 演示了在同一项目中使用 Scala 2.13 和 Scala 3 的技术 + +这些文章提供了有关 Scala 3 宏的更多信息： + +- [Scala 宏库](https://scalacenter.github.io/scala-3-migration-guide/docs/macros/macro-libraries.html) +- [宏：Scala 3 的计划](https://www.scala-lang.org/blog/2018/04/30/in-a-nutshell.html) +- [Quotes Reflect 的参考文档][quotes-reflect] +- [宏的参考文档](macros) + +[benefits]: https://www.scala-lang.org/blog/2018/04/30/in-a-nutshell.html +[erasure]: https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#type-erasure +[binary]: {% link _overviews/tutorials/binary-compatibility-for-library-authors.md %} +[compatibility-ref]: {% link _overviews/scala3-migration/compatibility-classpath.md %} +[quotes-reflect]: {{ site.scala3ref }}/metaprogramming/reflection.html +[macros]: {{ site.scala3ref }}/metaprogramming/macros.html From 0068671371109e14fff7d65ca9edf4182ac63c44 Mon Sep 17 00:00:00 2001 From: Erik van Oosten Date: Wed, 11 May 2022 14:39:46 +0200 Subject: [PATCH 1864/3075] Update _overviews/contribute/inclusive-language-guide.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Sébastien Doeraene --- _overviews/contribute/inclusive-language-guide.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md index 5689979302..0782dcf640 100644 --- a/_overviews/contribute/inclusive-language-guide.md +++ b/_overviews/contribute/inclusive-language-guide.md @@ -118,9 +118,9 @@ You may want to use automated software like [In Solidarity](https://github.com/a ## Dysphemism -Dysphemisms, the opposite of euphemisms, should be avoided. For example, the English expressions "pull the trigger" (enforce a decision) and "bite the bullet" (endure hardship) can be disturbingly violent if you are not used to them. - -Using the direct meaning is preferred. +Dysphemisms, the opposite of euphemisms, can be disturbingly violent if you are not used to them. +Examples include the English expressions "pull the trigger" (enforce a decision) and "bite the bullet" (endure hardship). +Prefer the direct meaning instead. ## Backward compatibility From 2827fa88c88521422876a321dcf0875a9893af09 Mon Sep 17 00:00:00 2001 From: Erik van Oosten Date: Wed, 11 May 2022 15:59:41 +0200 Subject: [PATCH 1865/3075] Adopts suggestion from review --- _overviews/contribute/inclusive-language-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md index 0782dcf640..717c8d8dfc 100644 --- a/_overviews/contribute/inclusive-language-guide.md +++ b/_overviews/contribute/inclusive-language-guide.md @@ -90,7 +90,7 @@ This list is neither comprehensive nor definitive, and it can evolve over time. * **blacklist/whitelist** \ While the etymology of these words has no relation to racism, their use suggests an association between the color black and some form of badness or exclusion, and between the color white and some form of goodness or inclusion. Prefer alternatives when possible. - Several alternatives have been proposed but none sticks as "the one". We suggest using the pair *allowlist*/*denylist*, as it is generic enough to replace most uses of *blacklist*/*whitelist*. + Several alternatives have been proposed but none sticks as "the one". We suggest using the pair *allowlist*/*denylist* or the pair *include*/*exclude*, as these are generic enough to replace most uses of *blacklist*/*whitelist*. * **master/slave** \ Never use *slave*. Never use *master* in conjunction with *slave*. From 7930c371ad142cfae5bb579d5120dcfd726d860f Mon Sep 17 00:00:00 2001 From: Erik van Oosten Date: Wed, 11 May 2022 16:01:01 +0200 Subject: [PATCH 1866/3075] Adopts suggestion from review --- _overviews/contribute/inclusive-language-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md index 717c8d8dfc..5072f71813 100644 --- a/_overviews/contribute/inclusive-language-guide.md +++ b/_overviews/contribute/inclusive-language-guide.md @@ -90,7 +90,7 @@ This list is neither comprehensive nor definitive, and it can evolve over time. * **blacklist/whitelist** \ While the etymology of these words has no relation to racism, their use suggests an association between the color black and some form of badness or exclusion, and between the color white and some form of goodness or inclusion. Prefer alternatives when possible. - Several alternatives have been proposed but none sticks as "the one". We suggest using the pair *allowlist*/*denylist* or the pair *include*/*exclude*, as these are generic enough to replace most uses of *blacklist*/*whitelist*. + Several alternatives have been proposed but none sticks as "the one". We suggest using the pair *denylist*/*allowlist* or the pair *excludelist*/*includelist*, as these are generic enough to replace most uses of *blacklist*/*whitelist*. * **master/slave** \ Never use *slave*. Never use *master* in conjunction with *slave*. From 770e5a78f3c91f43780eca0aa65392a53fcb84dd Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Fri, 13 May 2022 15:03:10 +0800 Subject: [PATCH 1867/3075] Change _zh-cn/scala3/guides/tasty-overview.md according to review. Add _zh-cn/scala3/reference/README.md Add _zh-cn/overview/scala3-book/why-scala-3.md --- _zh-cn/overviews/scala3-book/why-scala-3.md | 411 ++++++++++++++++++++ _zh-cn/scala3/guides/tasty-overview.md | 10 +- _zh-cn/scala3/reference/README.md | 5 + 3 files changed, 421 insertions(+), 5 deletions(-) create mode 100644 _zh-cn/overviews/scala3-book/why-scala-3.md create mode 100644 _zh-cn/scala3/reference/README.md diff --git a/_zh-cn/overviews/scala3-book/why-scala-3.md b/_zh-cn/overviews/scala3-book/why-scala-3.md new file mode 100644 index 0000000000..8a2121caed --- /dev/null +++ b/_zh-cn/overviews/scala3-book/why-scala-3.md @@ -0,0 +1,411 @@ +--- +title: 为什么是 Scala 3 ？ +type: chapter +description: This page describes the benefits of the Scala 3 programming language. +num: 3 +previous-page: scala-features +next-page: taste-intro +--- + +{% comment %} +TODO: Is “Scala 3 Benefits” a better title? +NOTE: Could mention “grammar” as a way of showing that Scala isn’t a large language; see this slide: https://www.slideshare.net/Odersky/preparing-for-scala-3#13 +{% endcomment %} + +使用 Scala 有很多好处，特别是 Scala 3。 +很难列出 Scala 的每一个好处，但“前十名”列表可能看起来像这样： + +1. Scala 融合了函数式编程（FP）和面向对象编程（OOP） +2. Scala 是静态类型的语言，但通常感觉像一种动态类型语言。 +3. Scala 的语法简洁，但仍然可读;它通常被称为 _易于表达_ +4. Scala 2 中的 _Implicits_ 是一个定义特性，它们在 Scala 3 中得到了改进和简化。 +5. Scala 与 Java 无缝集成，因此您可以创建混合了 Scala 和 Java 代码的项目，Scala 代码可以轻松使用成千上万个现有的 Java 库 +6. Scala 可以在服务器上使用，通过 [Scala.js](https://www.scala-js.org)， Scala 也可以在浏览器中使用 +7. Scala 标准库具有数十种预构建的函数式方法，可节省您的时间，并大大减少编写自定义 `for` 循环和算法的需要 +8. Scala 内置了“最佳实践”，它支持不可变性，匿名函数，高阶函数，模式匹配，默认情况下无法扩展的类等 +9. Scala 生态系统提供世界上最现代化的 FP 库 +10. 强型式系统 + +## 1) FP/OOP 融合 + +Scala 比任何其他语言都更支持 FP 和 OOP 范式的融合。 +正如 Martin Odersky 所说，Scala 的本质是在类型化环境中融合了函数式和面向对象编程，具有： + +- 逻辑函数，以及 +- 模块化对象 + +模块化的一些最佳示例可能是标准库中的类。 +例如，`List` 被定义为一个类---从技术上讲，它是一个抽象类---并且像这样创建了一个新实例： + +```scala +val x = List(1, 2, 3) +``` + +但是，在程序员看来是一个简单的 `List` 实际上是由几种特殊类型的组合构建的，包括名为`Iterable`, `Seq`, 和 `LinearSeq` 的 traits。 +这些类型同样由其他小型的模块化代码单元组成。 + +除了从一系列模块化 traits 构建/cases像 `List` 这样的类型之外，`List` API还包含数十种其他方法，其中许多是高阶函数： + +```scala +val xs = List(1, 2, 3, 4, 5) + +xs.map(_ + 1) // List(2, 3, 4, 5, 6) +xs.filter(_ < 3) // List(1, 2) +xs.find(_ > 3) // Some(4) +xs.takeWhile(_ < 3) // List(1, 2) +``` + +在这些示例中，无法修改列表中的值。 +`List` 类是不可变的，因此所有这些方法都返回新值，如每个注释中的数据所示。 + +## 2) 动态的感觉 + +Scala的 _类型推断_ 经常使语言感觉是动态类型的，即使它是静态类型的。 +对于变量声明，情况确实如此： + +```scala +val a = 1 +val b = "Hello, world" +val c = List(1,2,3,4,5) +val stuff = ("fish", 42, 1_234.5) +``` + +当把匿名函数传递给高阶函数时，情况也是如此： + +```scala +list.filter(_ < 4) +list.map(_ * 2) +list.filter(_ < 4) + .map(_ * 2) +``` + +还有定义方法的时候： + +```scala +def add(a: Int, b: Int) = a + b +``` + +这在Scala 3中比以往任何时候都更加真实，例如在使用[union types][union-types] 时： + +```scala +// union type parameter +def help(id: Username | Password) = + val user = id match + case Username(name) => lookupName(name) + case Password(hash) => lookupPassword(hash) + // more code here ... + +// union type value +val b: Password | Username = if (true) name else password +``` + +## 3) 简洁的语法 + +Scala是一种 low ceremony，“简洁但仍然可读”的语言。例如，变量声明是简洁的： + +```scala +val a = 1 +val b = "Hello, world" +val c = List(1,2,3) +``` + +创建类型如traits, 类和枚举都很简洁： + +```scala +trait Tail: + def wagTail(): Unit + def stopTail(): Unit + +enum Topping: + case Cheese, Pepperoni, Sausage, Mushrooms, Onions + +class Dog extends Animal, Tail, Legs, RubberyNose + +case class Person( + firstName: String, + lastName: String, + age: Int +) +``` + +高阶函数简洁： + +```scala +list.filter(_ < 4) +list.map(_ * 2) +``` + +所有这些表达方式以及更多表达方式都很简洁，并且仍然非常易读：我们称之为 _富有表现力_。 + +## 4) 隐式，简化 + +Scala 2 中的隐式是一个主要明显的设计特征。 +它们代表了抽象上下文的基本方式，具有服务于各种用例的统一范式，其中包括： + +- 实现 [type classes]({% link _overviews/scala3-book/ca-type-classes.md %}) +- 建立背景 +- 依赖注入 +- 表达能力 + +从那以后，其他语言也采用了类似的概念，所有这些都是 _术语推断_ 核心思想的变体：给定一个类型，编译器合成一个具有该类型的“规范”术语。 + +虽然隐式是 Scala 2 中的一个定义特性，但它们的设计在 Scala 3 中得到了极大的改进： + +- 定义“given”值的方法只有一种 +- 只有一种方法可以引入隐式参数和参数 +- 有一种单独的方式来导入 givens，不允许它们隐藏在正常导入的海洋中 +- 只有一种定义隐式转换的方法，它被清楚地标记为这样，并且不需要特殊的语法 + +这些变化的好处包括： + +- 新设计避免了特性交叉，使语言更加一致 +- 它使隐式更容易学习和不容易滥用 +- 它极大地提高了 95% 使用隐式的 Scala 程序的清晰度 +- 它有可能以一种易于理解和友好的原则方式进行术语推断 + +这些功能在其他部分有详细描述，因此请参阅 [上下文抽象介绍][context] 和 [`given` 和 `using` 子句][given] 部分了解更多详细信息。 + +## 5) 与 Java 无缝集成 + +Scala/Java 交互在许多方面都是无缝的。 +例如： + +- 您可以使用 Scala 项目中可用的所有数千个 Java 库 +- Scala `String` 本质上是 Java `String`，添加了附加功能 +- Scala 无缝使用 Java 中 *java.time._* 包中的日期/时间类 + +您还可以在 Scala 中使用 Java 集合类，并为它们提供更多功能，Scala 包含方法，因此您可以将它们转换为 Scala 集合。 + +虽然几乎所有交互都是无缝的，但[“与 Java 交互”一章][java] 演示了如何更好地结合使用某些功能，包括如何使用： + +- Scala 中的 Java 集合 +- Scala 中的 Java `Optional` +- Scala 中的 Java 接口 +- Java 中的 Scala 集合 +- Java 中的 Scala `Option` +- Java 中的 Scala traits +- 在 Java 代码中引发异常的 Scala 方法 +- Java 中的 Scala 可变参数 + +有关这些功能的更多详细信息，请参见该章。 + +## 6) 客户 &服务器 + +Scala 可以通过非常棒的框架在服务器端使用： + +- [Play Framework](https://www.playframework.com) 可让您构建高度可扩展的服务器端应用程序和微服务 +- [Akka Actors](https://akka.io) 让你使用actor模型大大简化分布式和并发软件应用程序 + +Scala 也可以通过 [Scala.js 项目](https://www.scala-js.org) 在浏览器中使用，它是 JavaScript 的类型安全替代品。 +Scala.js 生态系统 [有几十个库](https://www.scala-js.org/libraries) 让您可以在浏览器中使用 React、Angular、jQuery 和许多其他 JavaScript 和 Scala 库。 + +除了这些工具之外，[Scala Native](https://github.com/scala-native/scala-native) 项目“是一个优化的提前编译器和专为 Scala 设计的轻量级托管运行时”。它允许您使用纯 Scala 代码构建“系统”风格的二进制可执行应用程序，还允许您使用较低级别的原语。 + +## 7) 标准库方法 + +您将很少需要再次编写自定义的 `for` 循环，因为 Scala 标准库中的数十种预构建函数方法既可以节省您的时间，又有助于使代码在不同应用程序之间更加一致。 + +下面的例子展示了一些内置的集合方法，除此之外还有很多。 +虽然这些都使用 `List` 类，但相同的方法适用于其他集合类，例如 `Seq`、`Vector`、`LazyList`、`Set`、`Map`、`Array` 和 `ArrayBuffer`。 + +这里有些例子： + +```scala +List.range(1, 3) // List(1, 2) +List.range(start = 1, end = 6, step = 2) // List(1, 3, 5) +List.fill(3)("foo") // List(foo, foo, foo) +List.tabulate(3)(n => n * n) // List(0, 1, 4) +List.tabulate(4)(n => n * n) // List(0, 1, 4, 9) + +val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) +a.distinct // List(10, 20, 30, 40) +a.drop(2) // List(30, 40, 10) +a.dropRight(2) // List(10, 20, 30) +a.dropWhile(_ < 25) // List(30, 40, 10) +a.filter(_ < 25) // List(10, 20, 10) +a.filter(_ > 100) // List() +a.find(_ > 20) // Some(30) +a.head // 10 +a.headOption // Some(10) +a.init // List(10, 20, 30, 40) +a.intersect(List(19,20,21)) // List(20) +a.last // 10 +a.lastOption // Some(10) +a.map(_ * 2) // List(20, 40, 60, 80, 20) +a.slice(2, 4) // List(30, 40) +a.tail // List(20, 30, 40, 10) +a.take(3) // List(10, 20, 30) +a.takeRight(2) // List(40, 10) +a.takeWhile(_ < 30) // List(10, 20) +a.filter(_ < 30).map(_ * 10) // List(100, 200, 100) + +val fruits = List("apple", "pear") +fruits.map(_.toUpperCase) // List(APPLE, PEAR) +fruits.flatMap(_.toUpperCase) // List(A, P, P, L, E, P, E, A, R) + +val nums = List(10, 5, 8, 1, 7) +nums.sorted // List(1, 5, 7, 8, 10) +nums.sortWith(_ < _) // List(1, 5, 7, 8, 10) +nums.sortWith(_ > _) // List(10, 8, 7, 5, 1) +``` + +## 8) 内置最佳实践 + +Scala 习语以多种方式鼓励最佳实践。 +对于不可变性，我们鼓励您创建不可变的 `val` 声明： + +```scala +val a = 1 // 不可变变量 +``` + +还鼓励您使用不可变集合类，例如 `List` 和 `Map`： + +```scala +val b = List(1,2,3) // List 是不可变的 +val c = Map(1 -> "one") // Map 是不可变的 +``` + +Case 类主要用于 [领域建模]({% link _overviews/scala3-book/domain-modeling-intro.md %})，它们的参数是不可变的： + +```scala +case class Person(name: String) +val p = Person("Michael Scott") +p.name // Michael Scott +p.name = "Joe" // 编译器错误（重新分配给 val 名称） +``` + +如上一节所示，Scala 集合类支持高阶函数，您可以将方法（未显示）和匿名函数传递给它们： + +```scala +a.dropWhile(_ < 25) +a.filter(_ < 25) +a.takeWhile(_ < 30) +a.filter(_ < 30).map(_ * 10) +nums.sortWith(_ < _) +nums.sortWith(_ > _) +``` + +`match` 表达式让您可以使用模式匹配，它们确实是返回值的 _表达式_： + +```scala +val numAsString = i match + case 1 | 3 | 5 | 7 | 9 => "odd" + case 2 | 4 | 6 | 8 | 10 => "even" + case _ => "too big" +``` + +因为它们可以返回值，所以它们经常被用作方法的主体： + +```scala +def isTruthy(a: Matchable) = a match + case 0 | "" => false + case _ => true +``` + +## 9) 生态系统库 + +用于函数式编程的 Scala 库，如 [Cats](https://typelevel.org/cats) 和 [Zio](https://zio.dev) 是 FP 社区中的前沿库。 +所有流行语，如高性能、类型安全、并发、异步、资源安全、可测试、功能性、模块化、二进制兼容、高效、副作用/有副作用等，都可以用于这些库。 + +我们可以在这里列出数百个库，但幸运的是它们都列在另一个位置：有关这些详细信息，请参阅 [“Awesome Scala” 列表](https://github.com/lauris/awesome-scala)。 + +## 10) 强类型系统 + +Scala 有一个强大的类型系统，它在 Scala 3 中得到了更多的改进。 +Scala 3 的目标很早就定义了，与类型系统相关的目标包括： + +- 简化 +- 消除不一致 +- 安全 +- 人体工程学 +- 性能 + +_简化_ 来自数十个更改和删除的特性。 +例如，从 Scala 2 中重载的 `implicit` 关键字到 Scala 3 中的术语 `given` 和 `using` 的变化使语言更加清晰，尤其是对于初学者来说。 + +_消除不一致_ 与Scala 3中的几十个[删除的特性][dropped]、[改变的特性][changed]和[增加的特性][add]有关。 +此类别中一些最重要的功能是： + +- Intersection类型 +- 联合类型 +- 隐式函数类型 +- 依赖函数类型 +- trait 参数 +- 通用元组 + +{% comment %} +A list of types from the Dotty documentation: + +- Inferred types +- Generics +- Intersection types +- Union types +- Structural types +- Dependent function types +- Type classes +- Opaque types +- Variance +- Algebraic Data Types +- Wildcard arguments in types: ? replacing _ +- Type lambdas +- Match types +- Existential types +- Higher-kinded types +- Singleton types +- Refinement types +- Kind polymorphism +- Abstract type members and path-dependent types +- Dependent function types +- Bounds +{% endcomment %} + +_安全_ 与几个新的和改变的特性有关： + +- Multiversal equality +- Restricting implicit conversions +- Null safety +- Safe initialization + +_人体工程学_ 的好例子是枚举和扩展方法，它们以非常易读的方式添加到 Scala 3 中： + +```scala +// 枚举 +enum Color: + case Red, Green, Blue + +// 扩展方法 +extension (c: Circle) + def circumference: Double = c.radius * math.Pi * 2 + def diameter: Double = c.radius * 2 + def area: Double = math.Pi * c.radius * c.radius +``` + +_性能_ 涉及几个方面。 +其中之一是 [不透明类型][opaque-types]。 +在 Scala 2 中，有几次尝试创建解决方案以与域驱动设计 (DDD) 实践相一致，即赋予值更有意义的类型。 +这些尝试包括： + +- 类型别名 +- 值类 +- case类 + +不幸的是，所有这些方法都有弱点，如 [_Opaque Types_ SIP](https://docs.scala-lang.org/sips/opaque-types.html) 中所述。 +相反，如 SIP 中所述，不透明类型的目标是“对这些包装器类型的操作不得在运行时产生任何额外开销，同时在编译时仍提供类型安全使用。” + +有关更多类型系统的详细信息，请参阅 [参考文档][reference]。 + +## 其他很棒的功能 + +Scala 有许多很棒的特性，选择十大列表可能是主观的。 +多项调查表明，不同的开发人员群体喜欢不同的特性。 + +[java]: {% link _overviews/scala3-book/interacting-with-java.md %} +[given]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} +[reference]: {{ site.scala3ref }} +[dropped]: {{ site.scala3ref }}/dropped-features +[changed]: {{ site.scala3ref }}/changed-features +[added]:{{ site.scala3ref }}/other-new-features + +[union-types]: {% link _overviews/scala3-book/types-union.md %} +[opaque-types]: {% link _overviews/scala3-book/types-opaque-types.md %} diff --git a/_zh-cn/scala3/guides/tasty-overview.md b/_zh-cn/scala3/guides/tasty-overview.md index ca2d4260c5..9ab7cc3124 100644 --- a/_zh-cn/scala3/guides/tasty-overview.md +++ b/_zh-cn/scala3/guides/tasty-overview.md @@ -60,7 +60,7 @@ $ scalac -decompile hello.tasty 由于象 [类型擦除][erasure] 等问题，_.class_ 文件实际上是代码的不完整表示形式。 演示这一点的一种简单方法是使用 `List` 示例。 -_类型擦除_ 意味着当你编写这样的 Scala 代码时，它假定在 JVM 上运行： +_类型擦除_ 意味着当你编写这样的Scala代码，并假定它是在JVM上运行时： ```scala val xs: List[Int] = List(1, 2, 3) @@ -72,7 +72,7 @@ val xs: List[Int] = List(1, 2, 3) public scala.collection.immutable.List xs(); ``` -该 `javap` 命令输出显示了类文件中包含的内容，该内容是 Java 的表示形式。请注意，在此输出中，`xs` _不是_ 定义为 `List[Int]` ；它基本上表示为 `List[java.lang.Object]` 。为了使您的 Scala 代码与 JVM 配合使用，`Int` 类型已被擦除。 +该 `javap` 命令输出显示了类文件中包含的内容，该内容是 Java 的表示形式。请注意，在此输出中，`xs` _不是_ 定义为 `List[Int]` ；它真正表示的是 `List[java.lang.Object]` 。为了使您的 Scala 代码与 JVM 配合使用，`Int` 类型已被擦除。 稍后，当您在 Scala 代码中访问 `List[Int]` 的元素时，像这样： @@ -88,13 +88,13 @@ val x = xs.get(0).asInstanceOf[Int] // more Scala-like ``` 同样，这样做是为了兼容性，因此您的 Scala 代码可以在 JVM 上运行。但是，我们已经有的整数列表的信息在类文件中丢失了。 -当尝试使用已编译的库来编译 Scala 程序时，会带来问题。为此，我们需要比类文件中通常可用的信息更多的信息。 +当尝试使用已编译的库来编译 Scala 程序时，会带来问题。为此，我们需要的信息比类文件中通常可用的信息更多。 此讨论仅涵盖类型擦除的主题。对于 JVM 没有意识到的所有其他 Scala 结构，也存在类似的问题，包括 unions, intersections, 带有参数的 traits 以及更多 Scala 3 特性。 ### TASTy to the Rescue -因此，TASTy 格式不是没有关于 _.class_ 文件中原始类型的信息，或者只有公共 API（如Scala 2.13 “Pickle” 格式），而是在类型检查后存储完整的抽象语法树（AST）。存储整个 AST 有很多优点：它支持单独编译，针对不同的 JVM 版本重新编译，程序的静态分析等等。 +因此，TASTy 格式不是像 _.class_ 文件那样没有原始类型的信息，或者只有公共 API（如Scala 2.13 “Pickle” 格式），而是在类型检查后存储完整的抽象语法树（AST）。存储整个 AST 有很多优点：它支持单独编译，针对不同的 JVM 版本重新编译，程序的静态分析等等。 ### 重点 @@ -136,7 +136,7 @@ val x = xs.get(0).asInstanceOf[Int] // more Scala-like - [Scala 宏库](https://scalacenter.github.io/scala-3-migration-guide/docs/macros/macro-libraries.html) - [宏：Scala 3 的计划](https://www.scala-lang.org/blog/2018/04/30/in-a-nutshell.html) - [Quotes Reflect 的参考文档][quotes-reflect] -- [宏的参考文档](macros) +- [宏的参考文档][macros] [benefits]: https://www.scala-lang.org/blog/2018/04/30/in-a-nutshell.html [erasure]: https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#type-erasure diff --git a/_zh-cn/scala3/reference/README.md b/_zh-cn/scala3/reference/README.md new file mode 100644 index 0000000000..4606ed70d9 --- /dev/null +++ b/_zh-cn/scala3/reference/README.md @@ -0,0 +1,5 @@ +https://docs.scala-lang.org/scala3/reference 的页面内容是从 [Scala 3 编译器库](https://github.com/lampepfl/dotty) 生成的。 + +请到这里为 Scala 3 参考文档做贡献： + +https://github.com/lampepfl/dotty/tree/main/docs/_docs From 70ef2634e61ca254077c537fb43fd346652e3cf1 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Fri, 13 May 2022 11:36:51 +0200 Subject: [PATCH 1868/3075] JS not required to operate tabs or alt-details --- _includes/alt-details.html | 5 ++- _includes/tabsection.html | 33 +++++++++++----- _install_tabs/1-macos.html | 1 + _install_tabs/4-other.html | 4 +- _install_tabs/fr-1-macos.html | 1 + _install_tabs/fr-4-other.html | 4 +- _install_tabs/ja-1-macos.html | 1 + _install_tabs/ja-4-other.html | 4 +- _sass/components/alt-details.scss | 30 ++++++++++++--- _sass/components/tab.scss | 62 +++++++++++++++++++++++++------ _sass/layout/inner-main.scss | 12 +++--- resources/js/functions.js | 45 +--------------------- 12 files changed, 118 insertions(+), 84 deletions(-) diff --git a/_includes/alt-details.html b/_includes/alt-details.html index 457544612e..fc2d94c85e 100644 --- a/_includes/alt-details.html +++ b/_includes/alt-details.html @@ -1,5 +1,6 @@ -
    - +
    + +
    {{include.detail}}
    diff --git a/_includes/tabsection.html b/_includes/tabsection.html index ad62625e63..f779ce2efb 100644 --- a/_includes/tabsection.html +++ b/_includes/tabsection.html @@ -1,19 +1,32 @@ -
    -
      +
      + {% for tabRoot in include.collection %} + {% if tabRoot.language == include.language %} + + {% endif %} + {% endfor %} + - {% for tabRoot in include.collection %} - {% if tabRoot.language == include.language %} -
      - {{tabRoot.content}} +
      + {% for tabRoot in include.collection %} + {% if tabRoot.language == include.language %} +
      + {{tabRoot.content}} +
      + {% endif %} + {% endfor %}
      - {% endif %} - {% endfor %}
      diff --git a/_install_tabs/1-macos.html b/_install_tabs/1-macos.html index 2f34dcbe3b..f8caa80c19 100644 --- a/_install_tabs/1-macos.html +++ b/_install_tabs/1-macos.html @@ -13,6 +13,7 @@
      {% endcapture %} {% include alt-details.html + id='cs-setup-macos-nobrew' title="Alternatively, if you don't use Homebrew:" detail=homebrewDetail %} diff --git a/_install_tabs/4-other.html b/_install_tabs/4-other.html index 638409d939..8332bba359 100644 --- a/_install_tabs/4-other.html +++ b/_install_tabs/4-other.html @@ -1,13 +1,13 @@ --- tabId: other tabLabel: Other -fallbackNoJS: true +defaultTab: true language: en ---

      Follow the documentation from Coursier on how to install and run cs setup.

      diff --git a/_install_tabs/fr-1-macos.html b/_install_tabs/fr-1-macos.html index 2aa67ed447..99fc4aaa34 100644 --- a/_install_tabs/fr-1-macos.html +++ b/_install_tabs/fr-1-macos.html @@ -12,6 +12,7 @@
      {% endcapture %} {% include alt-details.html + id='cs-setup-macos-nobrew' title="Alternativement, si vous n'utilisez pas Homebrew:" detail=homebrewDetail %} diff --git a/_install_tabs/fr-4-other.html b/_install_tabs/fr-4-other.html index 770366796e..c54fd24c27 100644 --- a/_install_tabs/fr-4-other.html +++ b/_install_tabs/fr-4-other.html @@ -1,13 +1,13 @@ --- tabId: other tabLabel: Other -fallbackNoJS: true +defaultTab: true language: fr ---

      Suivez les instructions pour installer la commande cspuis exécutez ./cs setup.

      diff --git a/_install_tabs/ja-1-macos.html b/_install_tabs/ja-1-macos.html index acb2ae7798..553508b039 100644 --- a/_install_tabs/ja-1-macos.html +++ b/_install_tabs/ja-1-macos.html @@ -12,6 +12,7 @@
      {% endcapture %} {% include alt-details.html + id='cs-setup-macos-nobrew' title="または、Homebrewを使用しない場合は" detail=homebrewDetail %} diff --git a/_install_tabs/ja-4-other.html b/_install_tabs/ja-4-other.html index 5a4b39e484..b923a3b164 100644 --- a/_install_tabs/ja-4-other.html +++ b/_install_tabs/ja-4-other.html @@ -1,13 +1,13 @@ --- tabId: other tabLabel: Other -fallbackNoJS: true +defaultTab: true language: ja ---

      手順に従って cs ランチャーをインストールし、その次に以下を実行します。./cs setup

      diff --git a/_sass/components/alt-details.scss b/_sass/components/alt-details.scss index bacb1f2b3d..b058364039 100644 --- a/_sass/components/alt-details.scss +++ b/_sass/components/alt-details.scss @@ -7,6 +7,9 @@ .alt-details-toggle { @include span-columns(12); + font-family: $base-font-family; + line-height: normal; + text-align: center; border: none; background-color: $brand-tertiary; padding: 5px 10px; @@ -21,7 +24,8 @@ } &:after { - content: "\f13a"; // + // show a right arrow at the end of the toggle element + content: "\f138"; // font-family: "Font Awesome 5 Free"; font-weight: 900; font-size: 15px; @@ -29,15 +33,31 @@ margin-top: 2px; } - &.alt-details-closed:after { - content: "\f138"; // - } + } + + .alt-details-control+.alt-details-toggle+.alt-details-detail { + // by default, hide the details + position: absolute; + top: -999em; + left: -999em; + } + + .alt-details-control:checked+.alt-details-toggle+.alt-details-detail { + // show the details when the control is checked + position: static; + } + + .alt-details-control:checked+.alt-details-toggle:after { + // change the marker on the toggle label to a down arrow + content: "\f13a"; // } .alt-details-detail { // The detail box appears to be underneath the toggle button // so we add a padding to the top and push it up. - border: $base-border-gray; + border-bottom: $base-border-gray; + border-left: $base-border-gray; + border-right: $base-border-gray; padding-top: 15px; margin-top: 15px; } diff --git a/_sass/components/tab.scss b/_sass/components/tab.scss index cbd5010d79..00309cd483 100755 --- a/_sass/components/tab.scss +++ b/_sass/components/tab.scss @@ -2,6 +2,8 @@ //------------------------------------------------ //------------------------------------------------ +// dynamic tab switching based on https: //levelup.gitconnected.com/tabbed-interfaces-without-javascript-661bab1eaec8 + .nav-tab { border-bottom: $base-border-gray; @include display(flex); @@ -10,6 +12,7 @@ .item-tab { + label, a { transition: none; // do not animate the transition to active color: $base-font-color-light; @@ -27,13 +30,15 @@ &:hover { cursor: pointer; } + } - &.active { - border-bottom: 2px solid $brand-primary; - padding: 0 20px 8px; // so text does not jump up when active - color: $brand-primary; - pointer-events: none; - } + label { + -webkit-touch-callout: none; + -webkit-user-select: none; + -khtml-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; } } @@ -42,6 +47,7 @@ @include justify-content(space-between); .item-tab { + label, a { transition: none; // do not animate the transition to active padding: 0 10px 10px; @@ -51,6 +57,22 @@ } } +.nav-tab>.item-tab>a.active, // used in the blog +.tabsection>input:nth-child(1):checked~.nav-tab .item-tab:nth-child(1) label, +.tabsection>input:nth-child(2):checked~.nav-tab .item-tab:nth-child(2) label, +.tabsection>input:nth-child(3):checked~.nav-tab .item-tab:nth-child(3) label, +.tabsection>input:nth-child(4):checked~.nav-tab .item-tab:nth-child(4) label, +.tabsection>input:nth-child(5):checked~.nav-tab .item-tab:nth-child(5) label, +.tabsection>input:nth-child(6):checked~.nav-tab .item-tab:nth-child(6) label, +.tabsection>input:nth-child(7):checked~.nav-tab .item-tab:nth-child(7) label, +.tabsection>input:nth-child(8):checked~.nav-tab .item-tab:nth-child(8) label, +.tabsection>input:nth-child(9):checked~.nav-tab .item-tab:nth-child(9) label { + border-bottom: 2px solid $brand-primary; + padding: 0 20px 8px; // so text does not jump up when active + color: $brand-primary; + pointer-events: none; +} + .tabsection { border-bottom: $base-border-gray; border-left: $base-border-gray; @@ -67,12 +89,30 @@ list-style: none; } } -} -.tabcontent { - display: none; + input { // hide the input because they are not interactive + display: block; /* "enable" hidden elements in IE/edge */ + position: absolute; /* then hide them off-screen */ + left: -100%; + } - &.active { - display: block; + .tabcontent { + section { // by default, hide all sections until the user clicks on the associated label + position: absolute; + top: -999em; + left: -999em; + } } } + +.tabsection>input:nth-child(1):checked~.tabcontent section:nth-child(1), +.tabsection>input:nth-child(2):checked~.tabcontent section:nth-child(2), +.tabsection>input:nth-child(3):checked~.tabcontent section:nth-child(3), +.tabsection>input:nth-child(4):checked~.tabcontent section:nth-child(4), +.tabsection>input:nth-child(5):checked~.tabcontent section:nth-child(5), +.tabsection>input:nth-child(6):checked~.tabcontent section:nth-child(6), +.tabsection>input:nth-child(7):checked~.tabcontent section:nth-child(7), +.tabsection>input:nth-child(8):checked~.tabcontent section:nth-child(8), +.tabsection>input:nth-child(9):checked~.tabcontent section:nth-child(9) { + position: static; +} diff --git a/_sass/layout/inner-main.scss b/_sass/layout/inner-main.scss index 6233be6fdb..3e145637bc 100755 --- a/_sass/layout/inner-main.scss +++ b/_sass/layout/inner-main.scss @@ -2,16 +2,16 @@ //------------------------------------------------ //------------------------------------------------ +#inner-main>section:nth-child(2) { + // corresponds to area with the content below the title + position: relative; + margin-top: -80px; // have it overlap with the title area +} + #inner-main { background: $gray-lighter; padding-bottom: $padding-xlarge; - - section:nth-child(2) { - position: relative; - top: -80px; - } - .inner-box { padding: $padding-medium; background: #fff; diff --git a/resources/js/functions.js b/resources/js/functions.js index 4d55b546dd..d6524a72f4 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -392,21 +392,6 @@ function getOS() { return osname; } -$(document).ready(function () { - // for each .alt-details div, find the .alt-details-toggle button, - // and add a click handler to toggle the visibility of the .alt-details-detail - - $('.alt-details').each(function () { - var toggle = $(this).find('.alt-details-toggle'); - var details = $(this).find('.alt-details-detail'); - toggle.click(function () { - details.css('display') === 'none' ? details.show() : details.hide(); - toggle.toggleClass('alt-details-closed'); - }); - toggle.click(); - }); -}); - $(document).ready(function () { // for each code snippet area, find the copy button, // and add a click listener that will copy text from @@ -420,29 +405,6 @@ $(document).ready(function () { }); }); -$(document).ready(function () { - $('.tabsection').each(function () { - var tabsection = this; - $(tabsection).find('.nav-tab > .item-tab > .item-tab-link').each(function () { - var tabLink = this; - var targetTab = $(tabLink).attr('data-target'); - $(tabLink).click(function () { - console.log("clicked on " + targetTab); - $(tabsection).find('.nav-tab > .item-tab > .item-tab-link').each(function () { - var otherTab = this; - var otherTarget = $(otherTab).attr('data-target'); - otherTarget === targetTab ? $(otherTab).addClass('active') : $(otherTab).removeClass('active'); - }) - $(tabsection).children('.tabcontent').each(function () { - var tabContent = this; - var tabId = $(tabContent).attr('data-tab'); - targetTab === tabId ? $(tabContent).addClass('active') : $(tabContent).removeClass('active'); - }); - }); - }); - }); -}); - $(document).ready(function () { // click the get-started tab corresponding to the users OS. if ($(".main-download").length) { @@ -450,12 +412,7 @@ $(document).ready(function () { if (os === 'unix') { os = 'linux'; } - $("#install-cs-setup-tabs").find('.nav-tab > .item-tab > .item-tab-link').each(function () { - var targetTab = $(this).attr("data-target"); - if (targetTab === os) { - $(this).click(); - } - }); + $("#install-cs-setup-tabs").find('input[data-target=' + os + ']').prop("checked", true); } }); From 3edca3b9ea1c47a6fa954acf63cc97f9f6652b6c Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Mon, 16 May 2022 19:56:49 +0800 Subject: [PATCH 1869/3075] add few chapters in _zh-cn/overviews/scala3-book --- .../scala3-book/taste-control-structures.md | 270 ++++++++++++++++++ .../overviews/scala3-book/taste-functions.md | 62 ++++ .../scala3-book/taste-hello-world.md | 53 ++++ _zh-cn/overviews/scala3-book/taste-intro.md | 16 ++ _zh-cn/overviews/scala3-book/taste-methods.md | 129 +++++++++ .../overviews/scala3-book/taste-modeling.md | 215 ++++++++++++++ _zh-cn/overviews/scala3-book/taste-repl.md | 59 ++++ .../scala3-book/taste-vars-data-types.md | 198 +++++++++++++ 8 files changed, 1002 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/taste-control-structures.md create mode 100644 _zh-cn/overviews/scala3-book/taste-functions.md create mode 100644 _zh-cn/overviews/scala3-book/taste-hello-world.md create mode 100644 _zh-cn/overviews/scala3-book/taste-intro.md create mode 100644 _zh-cn/overviews/scala3-book/taste-methods.md create mode 100644 _zh-cn/overviews/scala3-book/taste-modeling.md create mode 100644 _zh-cn/overviews/scala3-book/taste-repl.md create mode 100644 _zh-cn/overviews/scala3-book/taste-vars-data-types.md diff --git a/_zh-cn/overviews/scala3-book/taste-control-structures.md b/_zh-cn/overviews/scala3-book/taste-control-structures.md new file mode 100644 index 0000000000..caefdfbe5b --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-control-structures.md @@ -0,0 +1,270 @@ +--- +title: 控制结构 +type: section +description: This section demonstrates Scala 3 control structures. +num: 8 +previous-page: taste-vars-data-types +next-page: taste-modeling +--- + + +Scala 具有您在其他编程语言中可以找到的控制结构，并且还具有强大的 `for` 表达式和 `match` 表达式： + +- `if`/`else` +- `for` 循环和表达式 +- `match` 表达式 +- `while` 循环 +- `try`/`catch` + +这些结构在以下示例中进行了说明。 + +## `if`/`else` + +Scala 的 `if`/`else` 控制结构看起来与其他语言相似： + +```scala +if x < 0 then + println("negative") +else if x == 0 then + println("zero") +else + println("positive") +``` + +请注意，这确实是一个 _表达式_ ---不是一个 _语句_。 +这意味着它返回一个值，因此您可以将结果赋值给一个变量： + +```scala +val x = if a < b then a else b +``` + +正如您将在本书中看到的那样，_所有_ Scala 控制结构都可以用作表达式。 + +> 表达式返回结果，而语句不返回。 +> 语句通常用于它们的副作用，例如使用 `println` 打印到控制台。 + +在 Scala 2 中 `if`/`else` 控制结构的构造不同，需要括号和大括号，而不是关键字 `then`。 + +```scala +// Scala 2 syntax +if (test1) { + doX() +} else if (test2) { + doY() +} else { + doZ() +} +``` + +## `for` 循环和表达式 + +`for` 关键字用于创建 `for` 循环。 +这个例子展示了如何打印 `List` 中的每个元素： + +```scala +val ints = List(1, 2, 3, 4, 5) + +for i <- ints do println(i) +``` + +代码 `i <- ints` 被称为 _生成器_，紧随 `do` 关键字的代码是 _循环体_。 + +Scala 2 中这种控制结构的旧语法是： + +```scala +// Scala 2 语法 +for (i <- ints) println(i) +``` + +再次注意括号的使用和 Scala 3 中新的 `for`-`do`。 + +### 守卫 + +您还可以在 `for` 循环中使用一个或多个 `if` 表达式。 +这些被称为 _守卫_。 +此示例打印 `ints` 中大于 `2` 的所有数字： + +```scala +for + i <- ints + if i > 2 +do + println(i) +``` + +您可以使用多个生成器和守卫。 +此循环遍历数字 `1` 到 `3`，并且对于每个数字，它还遍历字符 `a` 到 `c`。 +然而，它也有两个守卫，所以唯一一次调用 print 语句是当 `i` 的值为 `2` 并且 `j` 是字符 `b` 时： + +```scala +for + i <- 1 to 3 + j <- 'a' to 'c' + if i == 2 + if j == 'b' +do + println(s"i = $i, j = $j") // prints: "i = 2, j = b" +``` + +### `for` 表达式 + +`for` 关键字更强大：当您使用 `yield` 关键字代替 `do` 时，您会创建 `for` _表达式_ 用于计算和产生结果。 + +几个例子演示了这一点。 +使用与上一个示例相同的 `ints` 列表，此代码创建一个新列表，其中新列表中每个元素的值是原始列表中元素值的两倍： + +```` +scala> val doubles = for i <- ints yield i * 2 +val doubles: List[Int] = List(2, 4, 6, 8, 10) +```` + +Scala 的控制结构语法很灵活，`for` 表达式可以用其他几种方式编写，具体取决于您的偏好： + +```scala +val doubles = for i <- ints yield i * 2 // 如上所示的风格 +val doubles = for (i <- ints) yield i * 2 +val doubles = for (i <- ints) yield (i * 2) +val doubles = for { i <- ints } yield (i * 2) +``` + +此示例显示如何将列表中每个字符串的第一个字符大写： + +```scala +val names = List("chris", "ed", "maurice") +val capNames = for name <- names yield name.capitalize +``` + +最后，这个 `for` 表达式遍历一个字符串列表，并返回每个字符串的长度，但前提是该长度大于 `4`： + +```scala +val fruits = List("apple", "banana", "lime", "orange") + +val fruitLengths = for + f <- fruits + if f.length > 4 +yield + // 在这里你可以 + // 使用多行代码 + f.length + +//fruitLengths: List[Int] = List(5, 6, 6) +``` + +`for` 循环和表达式更多细节在本书的 [控制结构部分][control] 中，和 [参考文档]({{ site.scala3ref }}/other-new-features/control-syntax.html) 中。 + +## `match` 表达式 + +Scala 有一个 `match` 表达式，它最基本的用途类似于 Java `switch` 语句： + +```scala +val i = 1 + +// later in the code ... +i match + case 1 => println("one") + case 2 => println("two") + case _ => println("other") +``` + +但是，`match` 确实是一个表达式，这意味着它会根据模式匹配返回一个结果，您可以将其绑定到一个变量： + +```scala +val result = i match + case 1 => "one" + case 2 => "two" + case _ => "other" +``` + +`match` 不仅限于使用整数值，它可以用于任何数据类型： + +```scala +val p = Person("Fred") + +// later in the code +p match + case Person(name) if name == "Fred" => + println(s"$name says, Yubba dubba doo") + + case Person(name) if name == "Bam Bam" => + println(s"$name says, Bam bam!") + + case _ => println("Watch the Flintstones!") +``` + +事实上，`match` 表达式可以用许多模式的不同类型来测试变量。 +此示例显示 (a) 如何使用 `match` 表达式作为方法的主体，以及 (b) 如何匹配显示的所有不同类型： + +```scala +// getClassAsString 是一个接受任何类型的单个参数的方法。 +def getClassAsString(x: Matchable): String = x match + case s: String => s"'$s' is a String" + case i: Int => "Int" + case d: Double => "Double" + case l: List[_] => "List" + case _ => "Unknown" + +// examples +getClassAsString(1) // Int +getClassAsString("hello") // 'hello' is a String +getClassAsString(List(1, 2, 3)) // List +``` + +`getClassAsString` 方法将 [Matchable]({{ site.scala3ref }}/other-new-features/matchable.html) 类型的值作为参数，它可以是 +任何支持模式匹配的类型（某些类型不支持模式匹配，因为这可能 +打破封装）。 + +Scala 中的模式匹配还有 _更多_ 内容。 +模式可以嵌套，模式的结果可以绑定，模式匹配甚至可以是用户自定义的。 +有关详细信息，请参阅 [控制结构章节][control] 中的模式匹配示例。 + +## `try`/`catch`/`finally` + +Scala 的 `try`/`catch`/`finally` 控制结构让你捕获异常。 +它类似于 Java，但其语法与 `match` 表达式一致： + +```scala +try + writeTextToFile(text) +catch + case ioe: IOException => println("Got an IOException.") + case nfe: NumberFormatException => println("Got a NumberFormatException.") +finally + println("Clean up your resources here.") +``` + +## `while` 循环 + +Scala 还有一个 `while` 循环结构。 +它的单行语法如下所示： + +```scala +while x >= 0 do x = f(x) +``` + +在 Scala 2 中，语法有点不同。条件用括号括起来，并且 +没有 `do` 关键字： + +```scala +while (x >= 0) { x = f(x) } +``` + +为了兼容性，Scala 3 仍然支持 Scala 2 语法。 + +`while` 循环多行语法如下所示： + +```scala +var x = 1 + +while + x < 3 +do + println(x) + x += 1 +``` + +## 自定义控制结构 + +由于 by-name 参数、中缀表示法、流畅接口、可选括号、扩展方法和高阶函数等功能，您还可以创建自己的代码，就像控制结构一样工作。 +您将在 [控制结构][control] 部分了解更多信息。 + +[control]: {% link _overviews/scala3-book/control-structures.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-functions.md b/_zh-cn/overviews/scala3-book/taste-functions.md new file mode 100644 index 0000000000..b458e09a59 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-functions.md @@ -0,0 +1,62 @@ +--- +title: First-Class Functions +type: section +description: This page provides an introduction to functions in Scala 3. +num: 11 +previous-page: taste-methods +next-page: taste-objects +--- + + +Scala具有函数式编程语言中您期望的大多数功能，包括： + +- Lambdas（匿名函数） +- 高阶函数 （HOFs） +- 标准库中的不可变集合 + +Lambdas（也称为 _匿名函数_）是保持代码简洁但可读性的重要组成部分。 + +`List` 类的 `map` 方法是高阶函数的典型示例---一个将函数作为参数的函数。 + +这两个示例是等效的，并演示如何通过将 lambda 传递到 `map` 方法中，将列表中的每个数字乘以 `2`： + +```scala +val a = List(1, 2, 3).map(i => i * 2) // List(2,4,6) +val b = List(1, 2, 3).map(_ * 2) // List(2,4,6) +``` + +这些示例也等效于以下代码，该代码使用 `double` 方法而不是lambda： + +```scala +def double(i: Int): Int = i * 2 + +val a = List(1, 2, 3).map(i => double(i)) // List(2,4,6) +val b = List(1, 2, 3).map(double) // List(2,4,6) +``` + +> 如果您以前从未见过 `map` 方法，它会将给定的函数应用于列表中的每个元素，从而生成一个包含结果值的新列表。 + +将 lambda 传递给集合类上的高阶函数（如 `List`）是 Scala 体验的一部分，您每天都会这样做。 + +## 不可变集合 + +当您使用不可变集合（如 `List`，`Vector`）以及不可变的 `Map` 和 `Set` 类时，重要的是要知道这些函数不会改变它们被调用的集合；相反，它们返回包含更新数据的新集合。 +因此，以“流式”的风格将它们链接在一起以解决问题也很常见。 + +例如，此示例演示如何对一个集合进行两次筛选，然后将其余集合中的每个元素乘某个数： + +```scala +// a sample list +val nums = (1 to 10).toList // List(1,2,3,4,5,6,7,8,9,10) + +// methods can be chained together as needed +val x = nums.filter(_ > 3) + .filter(_ < 7) + .map(_ * 10) + +// result: x == List(40, 50, 60) +``` + +除了在整个标准库中使用的高阶函数外，您还可以[创建自己的][higher-order] 高阶函数。 + +[higher-order]: {% link _overviews/scala3-book/fun-hofs.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-hello-world.md b/_zh-cn/overviews/scala3-book/taste-hello-world.md new file mode 100644 index 0000000000..577699528c --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-hello-world.md @@ -0,0 +1,53 @@ +--- +title: Hello, World! +type: section +description: This section demonstrates a Scala 3 'Hello, World!' example. +num: 5 +previous-page: taste-intro +next-page: taste-repl +--- + + +Scala 3 “Hello, world!” 例子展示如下。 +首先，把以下代码写入 _Hello.scala_: + +```scala +@main def hello() = println("Hello, world!") +``` + +代码中， `hello` 是方法。 +它使用 `def` 定义，并用 `@main` 注释的手段把它声明为“main”方法。 +使用 `println` 方法，它在标准输出 （STDOUT）中打印了 `"Hello, world!"` 字符串。 + +下一步，用 `scalac` 编译代码： + +```bash +$ scalac Hello.scala +``` + +如果你是从 Java 转到 Scala，`scalac` 就像 `javac`，所以该命令会创建几个文件： + +```bash +$ ls -1 +Hello$package$.class +Hello$package.class +Hello$package.tasty +Hello.scala +hello.class +hello.tasty +``` + +与 Java 一样，_.class_ 文件是字节码文件，它们已准备好在 JVM 中运行。 + +现在您可以使用 `scala` 命令运行 `hello` 方法： + +```bash +$ scala hello +Hello, world! +``` + +假设它运行成功，那么恭喜，您刚刚编译并运行了您的第一个 Scala 应用程序。 + +> 在 [Scala 工具][scala_tools] 章节中可以找到 sbt 和其他使 Scala 开发更容易的工具相关的更多信息。 + +[scala_tools]: {% link _overviews/scala3-book/scala-tools.md %} \ No newline at end of file diff --git a/_zh-cn/overviews/scala3-book/taste-intro.md b/_zh-cn/overviews/scala3-book/taste-intro.md new file mode 100644 index 0000000000..fc4294c0f7 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-intro.md @@ -0,0 +1,16 @@ +--- +title: Scala 的味道 +type: chapter +description: This chapter provides a high-level overview of the main features of the Scala 3 programming language. +num: 4 +previous-page: why-scala-3 +next-page: taste-hello-world +--- + + +本章提供的快速导览涉及 Scala 3 编程语言的主要特性。 +在本导览之后，本书的其余部分提供了有关这些特性的更多详细信息，而[参考文档][reference]提供了_许多_ 细节。 + +> 在本书中，我们建议您在[Scastie](https://scastie.scala-lang.org) 或 Scala REPL 中尝试一些示例，该示例稍后演示。 + +[reference]: {{ site.scala3ref }}/overview.html diff --git a/_zh-cn/overviews/scala3-book/taste-methods.md b/_zh-cn/overviews/scala3-book/taste-methods.md new file mode 100644 index 0000000000..6507cab8a0 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-methods.md @@ -0,0 +1,129 @@ +--- +title: Methods +type: section +description: This section provides an introduction to defining and using methods in Scala 3. +num: 10 +previous-page: taste-modeling +next-page: taste-functions +--- + + +## Scala 方法 + +Scala 类、case 类、traits、枚举和对象都可以包含方法。 +简单方法的语法如下所示： + +```scala +def methodName(param1: Type1, param2: Type2): ReturnType = + // the method body + // goes here +``` + +这有一些例子： + +```scala +def sum(a: Int, b: Int): Int = a + b +def concatenate(s1: String, s2: String): String = s1 + s2 +``` + +您不必声明方法的返回类型，因此如果您愿意，可以像这样编写这些方法： + +```scala +def sum(a: Int, b: Int) = a + b +def concatenate(s1: String, s2: String) = s1 + s2 +``` + +这是你如何调用这些方法： + +```scala +val x = sum(1, 2) +val y = concatenate("foo", "bar") +``` + +这是一个多行的方法： + +```scala +def getStackTraceAsString(t: Throwable): String = + val sw = new StringWriter + t.printStackTrace(new PrintWriter(sw)) + sw.toString +``` + +方法参数也可以具有默认值。 +在此示例中，`timeout` 参数的默认值为 `5000`： + +```scala +def makeConnection(url: String, timeout: Int = 5000): Unit = + println(s"url=$url, timeout=$timeout") +``` + +由于方法声明中提供了默认的 `超时` 值，因此可以通过以下两种方式调用该方法： + +```scala +makeConnection("https://localhost") // url=http://localhost, timeout=5000 +makeConnection("https://localhost", 2500) // url=http://localhost, timeout=2500 +``` + +Scala 还支持在调用方法时使用 _命名参数_，因此如果您愿意，也可以像这样调用该方法： + +```scala +makeConnection( + url = "https://localhost", + timeout = 2500 +) +``` + +当多个方法参数具有相同的类型时，命名参数特别有用。 +乍一看，使用此方法，您可能想知道哪些参数设置为 `true` 或 `false`： + +```scala +engage(true, true, true, false) +``` + +如果没有IDE的帮助，那段代码可能很难阅读，但这个代码要明显得多： + +```scala +engage( + speedIsSet = true, + directionIsSet = true, + picardSaidMakeItSo = true, + turnedOffParkingBrake = false +) +``` + +## 扩展方法 + +_扩展方法_ 允许您向封闭类添加新方法。 +例如，如果要将两个名为 `hello` 和 `aloha` 的方法添加到 `String` 类中，请将它们声明为扩展方法： + +```scala +extension (s: String) + def hello: String = s"Hello, ${s.capitalize}!" + def aloha: String = s"Aloha, ${s.capitalize}!" + +"world".hello // "Hello, World!" +"friend".aloha // "Aloha, Friend!" +``` + +`extension` 关键字声明了括号内的参数将定义一个或多个扩展方法。 +如此示例所示，可以在扩展方法体中使用 `String` 类型的参数 `s`。 + +下一个示例演示如何将 `makeInt` 方法添加到 `String` 类。 +在这里，`makeInt` 采用一个名为 `radix` 的参数。 +该代码不考虑可能的字符串到整数转换错误，但跳过细节，示例显示了它的工作原理： + +```scala +extension (s: String) + def makeInt(radix: Int): Int = Integer.parseInt(s, radix) + +"1".makeInt(2) // Int = 1 +"10".makeInt(2) // Int = 2 +"100".makeInt(2) // Int = 4 +``` + +## See also + +Scala方法可以更强大：它们可以采用类型参数和上下文参数。 +它们在[领域建模][data-1]一节中有详细介绍。 + +[data-1]: {% link _overviews/scala3-book/domain-modeling-tools.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-modeling.md b/_zh-cn/overviews/scala3-book/taste-modeling.md new file mode 100644 index 0000000000..89a63d6a0f --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-modeling.md @@ -0,0 +1,215 @@ +--- +title: 领域建模 +type: section +description: This section provides an introduction to data modeling in Scala 3. +num: 9 +previous-page: taste-control-structures +next-page: taste-methods +--- + + +{% comment %} +NOTE: I kept the OOP section first, assuming that most readers will be coming from an OOP background. +{% endcomment %} + +Scala 同时支持函数式编程 (FP) 和面向对象编程 (OOP)，以及这两种范式的融合。 +本节简要概述了 OOP 和 FP 中的数据建模。 + +## OOP 领域建模 + +以 OOP 风格编写代码时，用于数据封装的两个主要工具是 _traits_ 和 _classes_。 + +{% comment %} +NOTE: Julien had a comment, “in OOP we don’t really model data. +It’s more about modeling operations, imho.” + +How to resolve? Is there a good DDD term to use here? +{% endcomment %} + +### traits + +Scala trait 可以用作简单的接口，但它们也可以包含抽象和具体的方法和字段，并且它们可以有参数，就像类一样。 +它们为您提供了一种将行为组织成小型模块化单元的好方法。 +稍后，当您想要创建属性和行为的具体实现时，类和对象可以扩展特征，根据需要混合尽可能多的特征以实现所需的行为。 + +作为如何将 traits 用作接口的示例，以下是三个 traits，它们为狗和猫等动物定义了结构良好并且模块化的行为： + +```scala +trait Speaker: + def speak(): String // 没有函数体，这样它是抽象的。 + +trait TailWagger: + def startTail(): Unit = println("tail is wagging") + def stopTail(): Unit = println("tail is stopped") + +trait Runner: + def startRunning(): Unit = println("I’m running") + def stopRunning(): Unit = println("Stopped running") +``` + +鉴于这些特征，这里有一个 `Dog` 类，它扩展了所有这些特征，同时为抽象 `speak` 方法提供了一种行为： + +```scala +class Dog(name: String) extends Speaker, TailWagger, Runner: + def speak(): String = "Woof!" +``` + +请注意该类如何使用 `extends` 关键字扩展 traits。 + +类似地，这里有一个 `Cat` 类，它实现了这些相同的 traits，同时还覆盖了它继承的两个具体方法： + +```scala +class Cat(name: String) extends Speaker, TailWagger, Runner: + def speak(): String = "Meow" + override def startRunning(): Unit = println("Yeah ... I don’t run") + override def stopRunning(): Unit = println("No need to stop") +``` + +这些示例显示了如何使用这些类： + +```scala +val d = Dog("Rover") +println(d.speak()) // prints "Woof!" + +val c = Cat("Morris") +println(c.speak()) // "Meow" +c.startRunning() // "Yeah ... I don’t run" +c.stopRunning() // "No need to stop" +``` + +如果该代码有意义---太好了，您把 traits 作为接口感到舒服。 +如果没有，请不要担心，它们在 [Domain Modeling][data-1] 章节中有更详细的解释。 + +### 类 + +Scala _classes_ 用于 OOP 风格的编程。 +这是一个模拟“人”的类的示例。在 OOP 中，字段通常是可变的，所以 `firstName` 和 `lastName` 都被声明为 `var` 参数： + +```scala +class Person(var firstName: String, var lastName: String): + def printFullName() = println(s"$firstName $lastName") + +val p = Person("John", "Stephens") +println(p.firstName) // "John" +p.lastName = "Legend" +p.printFullName() // "John Legend" +``` + +请注意，类声明创建了一个构造函数： + +```斯卡拉 +// 此代码使用该构造函数 +val p = Person("约翰", "斯蒂芬斯") +``` + +[Domain Modeling][data-1] 章节中介绍了构造函数和其他与类相关的主题。 + +## FP 领域建模 + +{% comment %} +NOTE: Julien had a note about expecting to see sealed traits here. +I didn’t include that because I didn’t know if enums are intended +to replace the Scala2 “sealed trait + case class” pattern. How to resolve? +{% endcomment %} + +以 FP 风格编写代码时，您将使用以下结构： + +- 枚举来定义 ADT +- Case类 +- Traits + +### 枚举 + +`enum` 构造是在 Scala 3 中对代数数据类型 (ADT) 进行建模的好方法。 +例如，披萨具有三个主要属性： + +- 面饼大小 +- 面饼类型 +- 馅料 + +这些是用枚举简洁地建模的： + +```scala +enum CrustSize: + case Small, Medium, Large + +enum CrustType: + case Thin, Thick, Regular + +enum Topping: + case Cheese, Pepperoni, BlackOlives, GreenOlives, Onions +``` + +一旦你有了一个枚举，你就可以按照你通常使用特征、类或对象的所有方式来使用枚举： + +```scala +import CrustSize.* +val currentCrustSize = Small + +// enums in a `match` expression +currentCrustSize match + case Small => println("Small crust size") + case Medium => println("Medium crust size") + case Large => println("Large crust size") + +// enums in an `if` statement +if currentCrustSize == Small then println("Small crust size") +``` + +下面是另一个如何在 Scala 中创建和使用 ADT 的示例： + +```scala +enum Nat: + case Zero + case Succ(pred: Nat) +``` + +枚举在本书的 [领域建模][data-1] 部分和 [参考文档]({{ site.scala3ref }}/enums/enums.html) 中有详细介绍。 + +### Case 类 + +Scala `case` 类允许您使用不可变数据结构对概念进行建模。 +`case` 类具有 `class` 的所有功能，还包含其他功能，使它们对函数式编程很有用。 +当编译器在 `class` 前面看到 `case` 关键字时，它具有以下效果和好处： + +- Case 类构造函数参数默认为 public `val` 字段，因此字段是不可变的，并且为每个参数生成访问器方法。 +- 生成一个 `unapply` 方法，它允许您在 `match` 表达式中以更多方式使用 case 类。 +- 在类中生成一个 `copy` 方法。 + 这提供了一种在不更改原始对象的情况下创建对象的更新副本的方法。 +- 生成 `equals` 和 `hashCode` 方法来实现结构相等等式。 +- 生成一个默认的 `toString` 方法，有助于调试。 + +{% comment %} +NOTE: Julien had a comment about how he decides when to use case classes vs classes. Add something here? +{% endcomment %} + +您_可以_自己手动将所有这些方法添加到一个类中，但是由于这些功能在函数式编程中非常常用，因此使用“case”类要方便得多。 + +这段代码演示了几个 `case` 类的特性： + +```scala +// define a case class +case class Person( + name: String, + vocation: String +) + +// create an instance of the case class +val p = Person("Reginald Kenneth Dwight", "Singer") + +// a good default toString method +p // : Person = Person(Reginald Kenneth Dwight,Singer) + +// can access its fields, which are immutable +p.name // "Reginald Kenneth Dwight" +p.name = "Joe" // error: can’t reassign a val field + +// when you need to make a change, use the `copy` method +// to “update as you copy” +val p2 = p.copy(name = "Elton John") +p2 // : Person = Person(Elton John,Singer) +``` + +有关 `case` 类的更多详细信息，请参阅 [领域建模][data-1] 部分。 + +[data-1]: {% link _overviews/scala3-book/domain-modeling-tools.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-repl.md b/_zh-cn/overviews/scala3-book/taste-repl.md new file mode 100644 index 0000000000..1f4c892027 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-repl.md @@ -0,0 +1,59 @@ +--- +title: The REPL +type: section +description: This section provides an introduction to the Scala REPL. +num: 6 +previous-page: taste-hello-world +next-page: taste-vars-data-types +--- + + +Scala REPL（“Read-Evaluate-Print-Loop”）是一个命令行解释器，您可以将其用作“游乐场”区域来测试 Scala 代码。 +你可以通过运行 `scala` 或 `scala3` 命令来启动一个 REPL 会话，具体取决于您在操作系统命令行中的安装，您将看到如下所示的“欢迎”提示： + +```bash +$ scala +Welcome to Scala 3.0.0 (OpenJDK 64-Bit Server VM, Java 11.0.9). +Type in expressions for evaluation. +Or try :help. + +scala> _ +``` + +REPL 是一个命令行解释器，所以它就在那里等着你输入一些东西。 +现在您可以输入 Scala 表达式来查看它们是如何工作的： + +```` +scala> 1 + 1 +val res0: Int = 2 + +scala> 2 + 2 +val res1: Int = 4 +```` + +如输出所示，如果您不为表达式的结果分配变量，REPL 会为您创建名为 `res0`、`res1` 等的变量。 +您可以在后续表达式中使用这些变量名称： + +```` +scala> val x = res0 * 10 +val x: Int = 20 +```` + +请注意，REPL 输出还显示了表达式的结果。 + +您可以在 REPL 中运行各种实验。 +这个例子展示了如何创建然后调用一个 `sum` 方法： + +```` +scala> def sum(a: Int, b: Int): Int = a + b +def sum(a: Int, b: Int): Int + +scala> sum(2, 2) +val res2: Int = 4 +```` + +如果您更喜欢基于浏览器的游乐场环境，也可以使用 [scastie.scala-lang.org](https://scastie.scala-lang.org)。 + +如果您更喜欢在文本编辑器中而不是在控制台提示符中编写代码，您可以使用 [worksheet]。 + +[worksheet]: {% link _overviews/scala3-book/tools-worksheets.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md new file mode 100644 index 0000000000..8864c23773 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md @@ -0,0 +1,198 @@ +--- +title: 变量和数据类型 +type: section +description: This section demonstrates val and var variables, and some common Scala data types. +num: 7 +previous-page: taste-repl +next-page: taste-control-structures +--- + + + +本节介绍 Scala 变量和数据类型。 + +## 两种类型的变量 + +当你在 Scala 中创建一个新变量时，你声明该变量是不可变的还是可变的： + + + + + + + + + + + + + + + + + + +
      变量类型说明
      val创建一个不可变变量——类似于 Java 中的 final。 您应该始终使用 val 创建一个变量，除非有理由使用可变变量。
      var创建一个可变变量，并且只应在变量的内容随时间变化时使用。
      + +这些示例展示了如何创建 `val` 和 `var` 变量： + +```scala +// immutable +val a = 0 + +// mutable +var b = 1 +``` + +在应用程序中，不能重新给一个 `val` 变量赋值。 +如果您尝试重新赋值一个 `val` 变量，将导致编译器错误： + +```scala +val msg = "Hello, world" +msg = "Aloha" // "reassignment to val" error; this won’t compile +``` + +相反，可以重新分配一个 `var` 变量： + +```scala +var msg = "Hello, world" +msg = "Aloha" // 因为可以重新分配 var，所以可以编译 +``` + +## 声明变量类型 + +创建变量时，您可以显式声明其类型，或让编译器推断类型： + +```scala +val x: Int = 1 // 显式 +val x = 1 // 隐式的；编译器推断类型 +``` + +第二种形式称为 _类型推断_，它是帮助保持此类代码简洁的好方法。 +Scala 编译器通常可以为您推断数据类型，如以下 REPL 示例的输出所示： + +```scala +scala> val x = 1 +val x: Int = 1 + +scala> val s = "a string" +val s: String = a string + +scala> val nums = List(1, 2, 3) +val nums: List[Int] = List(1, 2, 3) +``` + +如果您愿意，您始终可以显式声明变量的类型，但在像这样的简单赋值中，不须要这样： + +```scala +val x: Int = 1 +val s: String = "a string" +val p: Person = Person("Richard") +``` + +请注意，使用这种方法，代码感觉太啰嗦。 + +{% comment %} +TODO: Jonathan had an early comment on the text below: “While it might feel like this, I would be afraid that people automatically assume from this statement that everything is always boxed.” Suggestion on how to change this? +{% endcomment %} + +## 内置数据类型 + +Scala 带有你所期望的标准数值数据类型，它们都是类的成熟（full-blown）实例。 +在 Scala 中，一切都是对象。 + +这些示例展示了如何声明数字类型的变量： + +```scala +val b: Byte = 1 +val i: Int = 1 +val l: Long = 1 +val s: Short = 1 +val d: Double = 2.0 +val f: Float = 3.0 +``` + +因为 `Int` 和 `Double` 是默认的数字类型，所以您通常创建它们而不显式声明数据类型： + +```scala +val i = 123 // 默认为 Int +val j = 1.0 // 默认为 Double +``` + +在您的代码中，您还可以将字符 `L`、`D` 和 `F`（或者它们对应的小写字母）加到数字后面以指定它们是 `Long`、`Double` 或 `Float` 值： + +```scala +val x = 1_000L // val x: Long = 1000 +val y = 2.2D // val y: Double = 2.2 +val z = 3.3F // val z: Float = 3.3 +``` + +当您需要非常大的数字时，请使用 `BigInt` 和 `BigDecimal` 类型： + +```scala +var a = BigInt(1_234_567_890_987_654_321L) +var b = BigDecimal(123_456.789) +``` + +其中 `Double` 和 `Float` 是近似十进制数，`BigDecimal` 用于精确算术。 + +Scala 还有 `String` 和 `Char` 数据类型： + +```scala +val name = "Bill" // String +val c = 'a' // Char +``` + +### 字符串 + +Scala 字符串类似于 Java 字符串，但它们有两个很棒的附加特性： + +- 他们支持字符串插值 +- 创建多行字符串很容易 + +#### 字符串插值 + +字符串插值提供了一种非常易读的方式在字符串中使用变量。 +例如，给定这三个变量： + +```scala +val firstName = "John" +val mi = 'C' +val lastName = "Doe" +``` + +您可以将这些变量组合在一个字符串中，如下所示： + +```scala +println(s"Name: $firstName $mi $lastName") // "Name: John C Doe" +``` + +只需在字符串前面加上字母 `s`，然后在字符串中的变量名之前放置一个 `$` 符号。 + +要将任意表达式嵌入字符串中，请将它们括在花括号中： + +``` scala +println(s"2 + 2 = ${2 + 2}") // 打印 "2 + 2 = 4" + +val x = -1 +println(s"x.abs = ${x.abs}") // 打印 "x.abs = 1" +``` + +放在字符串前面的 `s` 只是一种可能的插值器。 +如果使用 `f` 而不是 `s`，则可以在字符串中使用 `printf` 样式的格式化语法。 +此外，字符串插值器只是一种特殊方法，可以定义自己的方法。 +例如，一些数据库的程序库定义了非常强大的 `sql` 插值器。 + +#### 多行字符串 + +多行字符串是通过将字符串包含在三个双引号内来创建的： + +```scala +val quote = """The essence of Scala: + Fusion of functional and object-oriented + programming in a typed setting.""" +``` + +> 有关字符串插值器和多行字符串的更多详细信息，请参阅[“First Look at Types”章节][first-look]。 + +[first-look]: {% link _overviews/scala3-book/first-look-at-types.md %} From 0f2d2724a289ff29348b218c551dbdecc888b57d Mon Sep 17 00:00:00 2001 From: Zimo Li <7163127+lzm0@users.noreply.github.com> Date: Mon, 16 May 2022 11:14:55 -0400 Subject: [PATCH 1870/3075] Fix misaligned page content --- _sass/layout/inner-main.scss | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sass/layout/inner-main.scss b/_sass/layout/inner-main.scss index 3e145637bc..72a996231f 100755 --- a/_sass/layout/inner-main.scss +++ b/_sass/layout/inner-main.scss @@ -5,7 +5,7 @@ #inner-main>section:nth-child(2) { // corresponds to area with the content below the title position: relative; - margin-top: -80px; // have it overlap with the title area + top: -80px; // have it overlap with the title area } #inner-main { From e732e9e79ddbacd037f7109c1b3729b9066a00cf Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 17 May 2022 16:19:40 +0800 Subject: [PATCH 1871/3075] translated all tastes files. in scala3-book. --- .../scala3-book/taste-collections.md | 108 ++++++++++++++++++ .../taste-contextual-abstractions.md | 54 +++++++++ _zh-cn/overviews/scala3-book/taste-objects.md | 90 +++++++++++++++ _zh-cn/overviews/scala3-book/taste-summary.md | 29 +++++ .../scala3-book/taste-toplevel-definitions.md | 62 ++++++++++ 5 files changed, 343 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/taste-collections.md create mode 100644 _zh-cn/overviews/scala3-book/taste-contextual-abstractions.md create mode 100644 _zh-cn/overviews/scala3-book/taste-objects.md create mode 100644 _zh-cn/overviews/scala3-book/taste-summary.md create mode 100644 _zh-cn/overviews/scala3-book/taste-toplevel-definitions.md diff --git a/_zh-cn/overviews/scala3-book/taste-collections.md b/_zh-cn/overviews/scala3-book/taste-collections.md new file mode 100644 index 0000000000..e1845e2b0b --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-collections.md @@ -0,0 +1,108 @@ +--- +title: Collections +type: section +description: This page provides a high-level overview of the main features of the Scala 3 programming language. +num: 13 +previous-page: taste-objects +next-page: taste-contextual-abstractions +--- + + +Scala 库具有一组丰富的集合类，这些类具有一组丰富的方法。 +集合类有不可变和可变两种形式。 + +## 创建列表 + +为了让您了解这些类的工作原理，下面是一些使用 `List` 类的示例，该类是不可变的链接列表类。 +这些示例显示了创建填充的 `List` 的不同方法： + +```scala +val a = List(1, 2, 3) // a: List[Int] = List(1, 2, 3) + +// Range methods +val b = (1 to 5).toList // b: List[Int] = List(1, 2, 3, 4, 5) +val c = (1 to 10 by 2).toList // c: List[Int] = List(1, 3, 5, 7, 9) +val e = (1 until 5).toList // e: List[Int] = List(1, 2, 3, 4) +val f = List.range(1, 5) // f: List[Int] = List(1, 2, 3, 4) +val g = List.range(1, 10, 3) // g: List[Int] = List(1, 4, 7) +``` + +## `List`方法 + +拥有填充的列表后，以下示例将显示可以对其调用的一些方法。 +请注意，这些都是函数式方法，这意味着它们不会改变调用的集合，而是返回包含更新元素的新集合。 +每个表达式返回的结果显示在每行的注释中： + +```scala +// a sample list +val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) + +a.drop(2) // List(30, 40, 10) +a.dropWhile(_ < 25) // List(30, 40, 10) +a.filter(_ < 25) // List(10, 20, 10) +a.slice(2,4) // List(30, 40) +a.tail // List(20, 30, 40, 10) +a.take(3) // List(10, 20, 30) +a.takeWhile(_ < 30) // List(10, 20) + +// flatten +val a = List(List(1,2), List(3,4)) +a.flatten // List(1, 2, 3, 4) + +// map, flatMap +val nums = List("one", "two") +nums.map(_.toUpperCase) // List("ONE", "TWO") +nums.flatMap(_.toUpperCase) // List('O', 'N', 'E', 'T', 'W', 'O') +``` + +这些示例显示了如何使用 `foldLeft` 和 `reduceLeft` 方法来对整数序列中的值求和： + +```scala +val firstTen = (1 to 10).toList // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) + +firstTen.reduceLeft(_ + _) // 55 +firstTen.foldLeft(100)(_ + _) // 155 (100 is a “seed” value) +``` + +Scala 集合类还有更多可用的方法，它们在[集合章节][collections]和 [API 文档][api]中进行了演示。 + +## 元组 + +Scala _元组_ 是一种类型，可让您轻松地将不同类型的集合放在同一个容器中。 +例如，给定以下 `Person` case 类： + +```scala +case class Person(name: String) +``` + +这是演示你如创建一个元组，这个元组包含 `Int`, `String`, 和定制的 `Person` 值： + +```scala +val t = (11, "eleven", Person("Eleven")) +``` + +有元组后，可以通过将其值绑定到变量来访问，也可以通过数字访问它们： + +```scala +t(0) // 11 +t(1) // "eleven" +t(2) // Person("Eleven") +``` + +您还可以使用以下 _解析器_ 的办法将元组字段分配变量名： + +```scala +val (num, str, person) = t + +// result: +// val num: Int = 11 +// val str: String = eleven +// val person: Person = Person(Eleven) +``` + +有些情况更适合使用元组， 那就是当你想要将异构类型的集合放在一个小的类似集合的结构中。 +有关更多元组详细信息，请参阅 [参考文档][reference]。 + +[collections]: {% link _overviews/scala3-book/collections-intro.md %} +[api]: https://scala-lang.org/api/3.x/ +[reference]: {{ site.scala3ref }}/overview.html diff --git a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md new file mode 100644 index 0000000000..f845a0b8d4 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md @@ -0,0 +1,54 @@ +--- +title: Contextual Abstractions +type: section +description: This section provides an introduction to Contextual Abstractions in Scala 3. +num: 14 +previous-page: taste-collections +next-page: taste-toplevel-definitions +--- + + +{% comment %} +TODO: Now that this is a separate section, it needs a little more content. +{% endcomment %} + +在某些情况下，可以省略在方法调用中你认为是重复的的某些参数。 + +这些参数之所以称为 _上下文参数_，是因为它们是由编译器从方法调用周围的上下文中推断出来的。 + +例如，考虑一个程序，该程序按两个条件对地址列表进行排序：城市名称，然后是街道名称。 + +```scala +val addresses: List[Address] = ... + +addresses.sortBy(address => (address.city, address.street)) +``` + +`sortBy` 方法调用一个函数，该函数为每个地址返回值，这个值会用来与其他地址比较。 +在本例中，我们传递一个函数，该函数返回一对，该对包含城市名称和街道名称。 + +请注意，我们只指示 _怎么_ 比较的，而不是 _如何_ 来执行比较。 +排序算法如何知道如何比较 `String` 对的？ + +实际上，`sortBy` 方法采用第二个参数---一个上下文参数---该参数由编译器推断。 +它不会出现在上面的示例中，因为它是由编译器提供的。 + +第二个参数实现 _如何_ 进行比较。 +省略它很方便，因为我们知道 `String` 通常使用词典顺序进行比较。 + +但是，也可以显式传递它： + +```scala +addresses.sortBy(address => (address.city, address.street))(using Ordering.Tuple2(Ordering.String, Ordering.String)) +``` + +在本例中，`Ordering.Tuple2(Ordering.String, Ordering.String)` 实例正是编译器以其他方式推断的实例。 +换句话说，这两个示例生成相同的程序。 + +_上下文抽象_ 用于避免重复代码。 +它们帮助开发人员编写可扩展且同时简洁的代码段。 + +有关更多详细信息，请参阅本书的[上下文抽象章节][contextual]，以及[参考文档][reference]。 + +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} +[reference]: {{ site.scala3ref }}/overview.html diff --git a/_zh-cn/overviews/scala3-book/taste-objects.md b/_zh-cn/overviews/scala3-book/taste-objects.md new file mode 100644 index 0000000000..a3a6be6470 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-objects.md @@ -0,0 +1,90 @@ +--- +title: Singleton Objects +type: section +description: This section provides an introduction to the use of singleton objects in Scala 3. +num: 12 +previous-page: taste-functions +next-page: taste-collections +--- + + +在 Scala 中，`object` 关键字创建一个单例对象。 +换句话说，对象定义了一个只有一个实例的类。 + +对象有多种用途： + +- 它们用于创建实用程序方法的集合。 +- _伴随对象_ 与一个类同名二者在同一个文件里。 + 在此情况下，该类也称为 _伴随类_。 +- 它们用于实现 traits，再用 traits 来创建 _模块_。 + +## “实用工具”方法 + +因为 `object` 是单例，所以它的方法可以像 Java 类中的 `static` 方法一样被访问。 +例如，此 `StringUtils` 对象包含一个与字符串相关的方法的小型集合： + +```scala +object StringUtils: + def isNullOrEmpty(s: String): Boolean = s == null || s.trim.isEmpty + def leftTrim(s: String): String = s.replaceAll("^\\s+", "") + def rightTrim(s: String): String = s.replaceAll("\\s+$", "") +``` + +由于 `StringUtils` 是一个单例，因此可以直接在对象上调用其方法： + +```scala +val x = StringUtils.isNullOrEmpty("") // true +val x = StringUtils.isNullOrEmpty("a") // false +``` + +## 伴随对象 + +伴随类或对象可以访问其伙伴的私有成员。 +对不特定于伴随类实例的方法和值使用伴随对象。 + +此示例演示了伴随类中的 `area` 方法如何访问其伴随对象中的私有 `calculateArea` 方法： + +```scala +import scala.math.* + +class Circle(radius: Double): + import Circle.* + def area: Double = calculateArea(radius) + +object Circle: + private def calculateArea(radius: Double): Double = + Pi * pow(radius, 2.0) + +val circle1 = Circle(5.0) +circle1.area // Double = 78.53981633974483 +``` + +## 从 traits 创建模块 + +对象还可用于实现创建模块的 trait。 +这种技术需要两个traits，并将它们结合起来创建一个具体的 `object`： + +```scala +trait AddService: + def add(a: Int, b: Int) = a + b + +trait MultiplyService: + def multiply(a: Int, b: Int) = a * b + +// implement those traits as a concrete object +object MathService extends AddService, MultiplyService + +// use the object +import MathService.* +println(add(1,1)) // 2 +println(multiply(2,2)) // 4 +``` + +{% comment %} +NOTE: I don’t know if this is worth keeping, but I’m leaving it here as a comment for now. + +> You may read that objects are used to _reify_ traits into modules. +> _Reify_ means, “to take an abstract concept and turn it into something concrete.” This is what happens in these examples, but “implement” is a more familiar word for most people than “reify.” +{% endcomment %} + + diff --git a/_zh-cn/overviews/scala3-book/taste-summary.md b/_zh-cn/overviews/scala3-book/taste-summary.md new file mode 100644 index 0000000000..3b6f74d6b7 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-summary.md @@ -0,0 +1,29 @@ +--- +title: Summary +type: section +description: This page provides a summary of the previous 'Taste of Scala' sections. +num: 16 +previous-page: taste-toplevel-definitions +next-page: first-look-at-types +--- + + +在前面的部分中，您看到了： + +- 如何使用 Scala REPL +- 如何使用 `val` 和 `var` 创建变量 +- 一些常见的数据类型 +- 控制结构 +- 如何使用 OOP 和 FP 样式对现实世界进行建模 +- 如何创建和使用方法 +- 如何使用lambdas（匿名函数）和高阶函数 +- 如何将对象用于多种目的 +- [上下文抽象][contextual]的介绍 + +我们还提到，如果您更喜欢使用基于浏览器的游乐场环境而不是 Scala REPL，您还可以使用[Scastie.scala-lang.org](https://scastie.scala-lang.org/?target=dotty) 或 [ScalaFiddle.io](https://scalafiddle.io)。 + +Scala还有更多功能在这次旋风之旅中没有涵盖。 +有关更多详细信息，请参阅本书的其余部分和[参考文档][reference]。 + +[reference]: {{ site.scala3ref }}/overview.html +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md new file mode 100644 index 0000000000..7e848d6caf --- /dev/null +++ b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md @@ -0,0 +1,62 @@ +--- +title: Toplevel Definitions +type: section +description: This page provides an introduction to top-level definitions in Scala 3 +num: 15 +previous-page: taste-contextual-abstractions +next-page: taste-summary +--- + + +在 Scala 3 中，各种定义都可以在源代码文件的 “顶层” 编写。 +例如，您可以创建一个名为 _MyCoolApp.scala_ 的文件，并将以下内容放入其中： + +```scala +import scala.collection.mutable.ArrayBuffer + +enum Topping: + case Cheese, Pepperoni, Mushrooms + +import Topping.* +class Pizza: + val toppings = ArrayBuffer[Topping]() + +val p = Pizza() + +extension (s: String) + def capitalizeAllWords = s.split(" ").map(_.capitalize).mkString(" ") + +val hwUpper = "hello, world".capitalizeAllWords + +type Money = BigDecimal + +// more definitions here as desired ... + +@main def myApp = + p.toppings += Cheese + println("show me the code".capitalizeAllWords) +``` + +如代码中展示的，无需将这些定义放在 `package`, `class` 或其他构造中。 + +## 替换包对象 + +如果你熟悉Scala 2，这种方法可以取代 _包对象_。 +但是，虽然更易于使用，但它们的工作方式类似：当您将定义放在名为 _foo_ 的包中时，您可以在 _foo_ 包内的所有其他包内访问该定义，例如在此示例中的 _foo.bar_ 包中： + +```scala +package foo { + def double(i: Int) = i * 2 +} + +package foo { + package bar { + @main def fooBarMain = + println(s"${double(1)}") // this works + } +} +``` + +本示例中使用大括号来强调包嵌套。 + +这种方法的好处是，您可以将定义放在名为 _com.acme.myapp_ 的包下，然后可以在 _com.acme.myapp.model_、_com.acme.myapp.controller_ 等中引用这些定义。 From 74405c5b3e8f985547fea70850c581c5955d640c Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 17 May 2022 19:53:51 +0800 Subject: [PATCH 1872/3075] modified according to review. --- _zh-cn/overviews/scala3-book/taste-collections.md | 2 +- _zh-cn/overviews/scala3-book/taste-control-structures.md | 5 ++--- _zh-cn/overviews/scala3-book/taste-methods.md | 2 +- _zh-cn/overviews/scala3-book/taste-modeling.md | 8 ++++---- _zh-cn/overviews/scala3-book/taste-vars-data-types.md | 4 ++-- _zh-cn/overviews/scala3-book/why-scala-3.md | 8 ++++---- 6 files changed, 14 insertions(+), 15 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/taste-collections.md b/_zh-cn/overviews/scala3-book/taste-collections.md index e1845e2b0b..1046bf1784 100644 --- a/_zh-cn/overviews/scala3-book/taste-collections.md +++ b/_zh-cn/overviews/scala3-book/taste-collections.md @@ -69,7 +69,7 @@ Scala 集合类还有更多可用的方法，它们在[集合章节][collections ## 元组 Scala _元组_ 是一种类型，可让您轻松地将不同类型的集合放在同一个容器中。 -例如，给定以下 `Person` case 类： +例如，给定以下 `Person` 样例类： ```scala case class Person(name: String) diff --git a/_zh-cn/overviews/scala3-book/taste-control-structures.md b/_zh-cn/overviews/scala3-book/taste-control-structures.md index caefdfbe5b..ace393cf6a 100644 --- a/_zh-cn/overviews/scala3-book/taste-control-structures.md +++ b/_zh-cn/overviews/scala3-book/taste-control-structures.md @@ -210,8 +210,7 @@ getClassAsString(List(1, 2, 3)) // List ``` `getClassAsString` 方法将 [Matchable]({{ site.scala3ref }}/other-new-features/matchable.html) 类型的值作为参数，它可以是 -任何支持模式匹配的类型（某些类型不支持模式匹配，因为这可能 -打破封装）。 +任何支持模式匹配的类型（某些类型不支持模式匹配，因为这可能打破封装）。 Scala 中的模式匹配还有 _更多_ 内容。 模式可以嵌套，模式的结果可以绑定，模式匹配甚至可以是用户自定义的。 @@ -264,7 +263,7 @@ do ## 自定义控制结构 -由于 by-name 参数、中缀表示法、流畅接口、可选括号、扩展方法和高阶函数等功能，您还可以创建自己的代码，就像控制结构一样工作。 +由于传名参数、中缀表示法、流畅接口、可选括号、扩展方法和高阶函数等功能，您还可以创建自己的代码，就像控制结构一样工作。 您将在 [控制结构][control] 部分了解更多信息。 [control]: {% link _overviews/scala3-book/control-structures.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-methods.md b/_zh-cn/overviews/scala3-book/taste-methods.md index 6507cab8a0..9404f4366b 100644 --- a/_zh-cn/overviews/scala3-book/taste-methods.md +++ b/_zh-cn/overviews/scala3-book/taste-methods.md @@ -10,7 +10,7 @@ next-page: taste-functions ## Scala 方法 -Scala 类、case 类、traits、枚举和对象都可以包含方法。 +Scala 类、样例类、traits、枚举和对象都可以包含方法。 简单方法的语法如下所示： ```scala diff --git a/_zh-cn/overviews/scala3-book/taste-modeling.md b/_zh-cn/overviews/scala3-book/taste-modeling.md index 89a63d6a0f..34e9c9bce8 100644 --- a/_zh-cn/overviews/scala3-book/taste-modeling.md +++ b/_zh-cn/overviews/scala3-book/taste-modeling.md @@ -115,7 +115,7 @@ to replace the Scala2 “sealed trait + case class” pattern. How to resolve? 以 FP 风格编写代码时，您将使用以下结构： - 枚举来定义 ADT -- Case类 +- 样例类 - Traits ### 枚举 @@ -166,14 +166,14 @@ enum Nat: 枚举在本书的 [领域建模][data-1] 部分和 [参考文档]({{ site.scala3ref }}/enums/enums.html) 中有详细介绍。 -### Case 类 +### 样例类 Scala `case` 类允许您使用不可变数据结构对概念进行建模。 `case` 类具有 `class` 的所有功能，还包含其他功能，使它们对函数式编程很有用。 当编译器在 `class` 前面看到 `case` 关键字时，它具有以下效果和好处： -- Case 类构造函数参数默认为 public `val` 字段，因此字段是不可变的，并且为每个参数生成访问器方法。 -- 生成一个 `unapply` 方法，它允许您在 `match` 表达式中以更多方式使用 case 类。 +- 样例类构造函数参数默认为 public `val` 字段，因此字段是不可变的，并且为每个参数生成访问器方法。 +- 生成一个 `unapply` 方法，它允许您在 `match` 表达式中以更多方式使用 样例类。 - 在类中生成一个 `copy` 方法。 这提供了一种在不更改原始对象的情况下创建对象的更新副本的方法。 - 生成 `equals` 和 `hashCode` 方法来实现结构相等等式。 diff --git a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md index 8864c23773..4c504e9a00 100644 --- a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md +++ b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md @@ -101,7 +101,7 @@ TODO: Jonathan had an early comment on the text below: “While it might feel li Scala 带有你所期望的标准数值数据类型，它们都是类的成熟（full-blown）实例。 在 Scala 中，一切都是对象。 -这些示例展示了如何声明数字类型的变量： +这些示例展示了如何声明数值类型的变量： ```scala val b: Byte = 1 @@ -181,7 +181,7 @@ println(s"x.abs = ${x.abs}") // 打印 "x.abs = 1" 放在字符串前面的 `s` 只是一种可能的插值器。 如果使用 `f` 而不是 `s`，则可以在字符串中使用 `printf` 样式的格式化语法。 此外，字符串插值器只是一种特殊方法，可以定义自己的方法。 -例如，一些数据库的程序库定义了非常强大的 `sql` 插值器。 +例如，有一些数据库方向的类库定义了非常强大的 `sql` 插值器。 #### 多行字符串 diff --git a/_zh-cn/overviews/scala3-book/why-scala-3.md b/_zh-cn/overviews/scala3-book/why-scala-3.md index 8a2121caed..535be70deb 100644 --- a/_zh-cn/overviews/scala3-book/why-scala-3.md +++ b/_zh-cn/overviews/scala3-book/why-scala-3.md @@ -128,7 +128,7 @@ case class Person( ) ``` -高阶函数简洁： +简洁的高阶函数： ```scala list.filter(_ < 4) @@ -265,7 +265,7 @@ val b = List(1,2,3) // List 是不可变的 val c = Map(1 -> "one") // Map 是不可变的 ``` -Case 类主要用于 [领域建模]({% link _overviews/scala3-book/domain-modeling-intro.md %})，它们的参数是不可变的： +样例类主要用于 [领域建模]({% link _overviews/scala3-book/domain-modeling-intro.md %})，它们的参数是不可变的： ```scala case class Person(name: String) @@ -305,7 +305,7 @@ def isTruthy(a: Matchable) = a match ## 9) 生态系统库 用于函数式编程的 Scala 库，如 [Cats](https://typelevel.org/cats) 和 [Zio](https://zio.dev) 是 FP 社区中的前沿库。 -所有流行语，如高性能、类型安全、并发、异步、资源安全、可测试、功能性、模块化、二进制兼容、高效、副作用/有副作用等，都可以用于这些库。 +所有流行语，如高性能、类型安全、并发、异步、资源安全、可测试、函数式、模块化、二进制兼容、高效、副作用/有副作用等，都可以用于这些库。 我们可以在这里列出数百个库，但幸运的是它们都列在另一个位置：有关这些详细信息，请参阅 [“Awesome Scala” 列表](https://github.com/lauris/awesome-scala)。 @@ -387,7 +387,7 @@ _性能_ 涉及几个方面。 - 类型别名 - 值类 -- case类 +- 样例类 不幸的是，所有这些方法都有弱点，如 [_Opaque Types_ SIP](https://docs.scala-lang.org/sips/opaque-types.html) 中所述。 相反，如 SIP 中所述，不透明类型的目标是“对这些包装器类型的操作不得在运行时产生任何额外开销，同时在编译时仍提供类型安全使用。” From 2e5b38b4beeec3e9b790a5feb5e4c8c674bf5c58 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 17 May 2022 16:02:41 +0200 Subject: [PATCH 1873/3075] Fix broken links due to lampepfl/dotty#15169 --- .../scala3-migration/scaladoc-settings-compatibility.md | 2 +- scala3/scaladoc.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-migration/scaladoc-settings-compatibility.md b/_overviews/scala3-migration/scaladoc-settings-compatibility.md index 5e1f2e6005..7bb96b90d8 100644 --- a/_overviews/scala3-migration/scaladoc-settings-compatibility.md +++ b/_overviews/scala3-migration/scaladoc-settings-compatibility.md @@ -60,7 +60,7 @@ Source links are used to point to source code at some remote repository like git Hopefully, the new syntax is almost superset of the old syntax. To migrate to the new scaladoc syntax, make sure that you don't use any of these variables: `€{TPL_OWNER}` or `€{FILE_PATH_EXT}`. Otherwise you have to rewrite your source link, using either other `variables` or you can use new -syntax, about which you can read more at [dotty docs](https://dotty.epfl.ch/docs/usage/scaladoc/settings.html) +syntax, about which you can read more in the [Scaladoc documentation]({% link _overviews/scala3-scaladoc/settings.md %}). Note that new syntax let you specify prefixes of your files paths to match specific url in case your sources are scattered in different directories or even different repositories. diff --git a/scala3/scaladoc.md b/scala3/scaladoc.md index 3b8e90b7d8..f6706ffdf0 100644 --- a/scala3/scaladoc.md +++ b/scala3/scaladoc.md @@ -5,7 +5,7 @@ title: New features for Scaladoc The new Scala version 3 comes with a completely new implementation of the documentation generator _Scaladoc_, rewritten from scratch. In this article you can find highlights of new features that are or will be introduced to Scaladoc. -For general reference, visit [Scaladoc manual](https://dotty.epfl.ch/docs/usage/scaladoc/) +For general reference, visit [Scaladoc manual]({% link _overviews/scala3-scaladoc/index.md %}). ## New features @@ -82,4 +82,4 @@ If you encounter a bug or have an idea for improvement, don't hesitate to create [scaladoc-docstrings]: {% link _overviews/scala3-scaladoc/docstrings.md %} [static-documentation]: {% link _overviews/scala3-scaladoc/static-site.md %} [built-in-blog]: {% link _overviews/scala3-scaladoc/blog.md %} -[social-links]: https://dotty.epfl.ch/docs/usage/scaladoc/settings.html#-social-links +[social-links]: {% link _overviews/scala3-scaladoc/settings.md %}#-social-links From 313fdff2ac627657cfef75d441ab9f9be475176f Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Wed, 18 May 2022 11:05:52 +0800 Subject: [PATCH 1874/3075] correct translation according review. --- _zh-cn/overviews/scala3-book/taste-collections.md | 2 +- _zh-cn/overviews/scala3-book/taste-objects.md | 12 ++++++------ _zh-cn/overviews/scala3-book/why-scala-3.md | 2 +- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/taste-collections.md b/_zh-cn/overviews/scala3-book/taste-collections.md index 1046bf1784..5e79cb4a15 100644 --- a/_zh-cn/overviews/scala3-book/taste-collections.md +++ b/_zh-cn/overviews/scala3-book/taste-collections.md @@ -89,7 +89,7 @@ t(1) // "eleven" t(2) // Person("Eleven") ``` -您还可以使用以下 _解析器_ 的办法将元组字段分配变量名： +您还可以使用以下 _解构_ 的办法将元组字段分配变量名： ```scala val (num, str, person) = t diff --git a/_zh-cn/overviews/scala3-book/taste-objects.md b/_zh-cn/overviews/scala3-book/taste-objects.md index a3a6be6470..2cb04d4d14 100644 --- a/_zh-cn/overviews/scala3-book/taste-objects.md +++ b/_zh-cn/overviews/scala3-book/taste-objects.md @@ -14,8 +14,8 @@ next-page: taste-collections 对象有多种用途： - 它们用于创建实用程序方法的集合。 -- _伴随对象_ 与一个类同名二者在同一个文件里。 - 在此情况下，该类也称为 _伴随类_。 +- _伴生对象_ 与一个类同名二者在同一个文件里。 + 在此情况下，该类也称为 _伴生类_。 - 它们用于实现 traits，再用 traits 来创建 _模块_。 ## “实用工具”方法 @@ -37,12 +37,12 @@ val x = StringUtils.isNullOrEmpty("") // true val x = StringUtils.isNullOrEmpty("a") // false ``` -## 伴随对象 +## 伴生对象 -伴随类或对象可以访问其伙伴的私有成员。 -对不特定于伴随类实例的方法和值使用伴随对象。 +伴生类或对象可以访问其伙伴的私有成员。 +对不特定于伴生类实例的方法和值使用伴生对象。 -此示例演示了伴随类中的 `area` 方法如何访问其伴随对象中的私有 `calculateArea` 方法： +此示例演示了伴生类中的 `area` 方法如何访问其伴生对象中的私有 `calculateArea` 方法： ```scala import scala.math.* diff --git a/_zh-cn/overviews/scala3-book/why-scala-3.md b/_zh-cn/overviews/scala3-book/why-scala-3.md index 535be70deb..00c37f54af 100644 --- a/_zh-cn/overviews/scala3-book/why-scala-3.md +++ b/_zh-cn/overviews/scala3-book/why-scala-3.md @@ -24,7 +24,7 @@ NOTE: Could mention “grammar” as a way of showing that Scala isn’t a large 7. Scala 标准库具有数十种预构建的函数式方法，可节省您的时间，并大大减少编写自定义 `for` 循环和算法的需要 8. Scala 内置了“最佳实践”，它支持不可变性，匿名函数，高阶函数，模式匹配，默认情况下无法扩展的类等 9. Scala 生态系统提供世界上最现代化的 FP 库 -10. 强型式系统 +10. 强类型式系统 ## 1) FP/OOP 融合 From 300d5cde0b406a7cd0d158d865e15b62caa2f01b Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Wed, 18 May 2022 11:12:27 +0800 Subject: [PATCH 1875/3075] Missed one translation. Finish all corrects. --- _zh-cn/overviews/scala3-book/taste-vars-data-types.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md index 4c504e9a00..c19549248d 100644 --- a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md +++ b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md @@ -90,7 +90,7 @@ val s: String = "a string" val p: Person = Person("Richard") ``` -请注意，使用这种方法，代码感觉太啰嗦。 +请注意，使用这种方法会感觉代码太啰嗦。 {% comment %} TODO: Jonathan had an early comment on the text below: “While it might feel like this, I would be afraid that people automatically assume from this statement that everything is always boxed.” Suggestion on how to change this? From ef7ef68f32eea361365d9142248318618f898444 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 19 May 2022 03:38:56 +0000 Subject: [PATCH 1876/3075] Bump nokogiri from 1.13.4 to 1.13.6 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.13.4 to 1.13.6. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.13.4...v1.13.6) --- updated-dependencies: - dependency-name: nokogiri dependency-type: indirect ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 3c6f6b8d12..10b4148d6c 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -55,7 +55,7 @@ GEM rb-inotify (~> 0.9, >= 0.9.10) mercenary (0.3.6) mini_portile2 (2.8.0) - nokogiri (1.13.4) + nokogiri (1.13.6) mini_portile2 (~> 2.8.0) racc (~> 1.4) nokogumbo (2.0.2) From 3f33fc4a5323239bb0e0b0fc70743f514320dcfc Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sat, 21 May 2022 11:47:00 +0800 Subject: [PATCH 1877/3075] add _zh-cn/overviews/scala3-book/first-look-at-types.md --- .../scala3-book/first-look-at-types.md | 269 ++++++++++++++++++ 1 file changed, 269 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/first-look-at-types.md diff --git a/_zh-cn/overviews/scala3-book/first-look-at-types.md b/_zh-cn/overviews/scala3-book/first-look-at-types.md new file mode 100644 index 0000000000..adc9ebd91c --- /dev/null +++ b/_zh-cn/overviews/scala3-book/first-look-at-types.md @@ -0,0 +1,269 @@ +--- +title: 类型初探 +type: chapter +description: This page provides a brief introduction to Scala's built-in data types, including Int, Double, String, Long, Any, AnyRef, Nothing, and Null. +num: 17 +previous-page: taste-summary +next-page: control-structures +--- + + + +## 所有值都有一个类型 + +在 Scala 中，所有值都有一个类型，包括数值和函数。 +下图展示了类型层次结构的一个子集。 + +Scala 3 Type Hierarchy + +## Scala 类型层次结构 + +`Any` 是所有类型的超类型，也称为 **首类型**。 +它定义了某些通用方法，例如 `equals` ， `hashCode` 和 `toString` 。 + +首类型 `Any` 有一个子类型 [`Matchable`][matchable]，它用于标记可以执行模式匹配的所有类型。 +保证属性调用 _“参数化”_ 非常重要。 +我们不会在这里详细介绍，但总而言之，这意味着我们不能对类型为 `Any` 的值进行模式匹配，而只能对 `Matchable` 的子类型的值进行模式匹配。 +[参考文档][matchable]包含有关 `Matchable` 的更多信息。 + +`Matchable` 有两个重要的子类型： `AnyVal` 和 `AnyRef` 。 + +*`AnyVal`* 表示值类型。 +有几个预定义的值类型，它们是不可为空的： `Double`, `Float`, `Long`, `Int`, `Short`, `Byte`, `Char`, `Unit`, 和 `Boolean`。 +`Unit` 是一种值类型，它不携带有意义的信息。 +`Unit` 只有一个实例，我们可以将其称为：`()`。 + +*`AnyRef`* 表示引用类型。 +所有非值类型都定义为引用类型。 +Scala中的每个用户定义类型都是 `AnyRef` 的子类型。 +如果在Java运行时环境的上下文中使用Scala，则 `AnyRef` 对应于 `java.lang.Object`。 + +在基于语句的编程语言中， `void` 用于没有返回值的方法。 +如果您在Scala中编写没有返回值的方法，例如以下方法，则 `Unit` 用于相同的目的： + +```scala +def printIt(a: Any): Unit = println(a) +``` + +下面是一个示例，它演示了字符串、整数、字符、布尔值和函数都是 `Any` 的实例，可以像对待其他所有对象一样处理： + +```scala +val list: List[Any] = List( + "a string", + 732, // an integer + 'c', // a character + true, // a boolean value + () => "an anonymous function returning a string" +) + +list.foreach(element => println(element)) +``` + +该代码定义了一个类型为 `List[Any]` 的值 `list` 。 +该列表使用各种类型的元素进行初始化，但每个元素都是 `scala.Any` 的实例，因此我们可以将它们添加到列表中。 + +下面是程序的输出： + +``` +a string +732 +c +true + +``` + +## Scala的“值类型” + +如上所示，Scala的值类型扩展了 `AnyVal`，它们都是成熟的对象。 +这些示例演示如何声明以下数值类型的变量： + +```scala +val b: Byte = 1 +val i: Int = 1 +val l: Long = 1 +val s: Short = 1 +val d: Double = 2.0 +val f: Float = 3.0 +``` + +在前四个示例中，如果未显式指定类型，则数字 `1` 将默认为 `Int` ，因此，如果需要其他数据类型之一 --- `Byte` 、`Long` 或 `Short` --- 则需要显式声明这些类型，如上面代码所示。 +带有小数的数字（如2.0）将默认为 `Double` ，因此，如果您想要 `Float` ，则需要声明 `Float` ，如上一个示例所示。 + +由于 `Int` 和 `Double` 是默认数值类型，因此通常在不显式声明数据类型的情况下创建它们： + +```scala +val i = 123 // defaults to Int +val x = 1.0 // defaults to Double +``` + +在代码中，您还可以将字符 `L` 、 `D` 和 `F` （及其小写等效项）加到数字末尾，以指定它们是 `Long`, `Double`, 或 `Float` 值： + +```scala +val x = 1_000L // val x: Long = 1000 +val y = 2.2D // val y: Double = 2.2 +val z = 3.3F // val z: Float = 3.3 +``` + +Scala还具有 `String` 和 `Char` 类型，通常可以使用隐式形式声明： + +```scala +val s = "Bill" +val c = 'a' +``` + +如下面表格所示，将字符串括在双引号中 --- 或多行字符串括在三引号中 --- 或字符括在单引号中。 + +这些数据类型及其范围包括： + +| 数据类型 | 可能的值 | +| ---------- | --------------- | +| Boolean | `true` 或 `false` | +| Byte | 8 位有符号二进制补码整数（-2^7 至 2^7-1,含）
      -128 至 127 | +| Short | 16 位有符号二进制补码整数（-2^15 至 2^15-1,含）
      -32,768 至 32,767 | +| Int | 32 位二进制补码整数（-2^31 至 2^31-1,含）
      -2,147,483,648 至 2,147,483,647 | +| Long | 64 位 2 的补码整数（-2^63 到 2^63-1,含）
      （-2^63 到 2^63-1,包括） | +| Float | 32 位 IEEE 754 单精度浮点数
      1.40129846432481707e-45 到 3.40282346638528860e+38 | +| Double | 64 位 IEEE 754 双精度浮点数
      4.94065645841246544e-324 到 1.79769313486231570e+308 | +| Char | 16 位无符号 Unicode 字符（0 到 2^16-1,含）
      0 到 65,535 | +| String | 一个 `Char` 序列 | + +## `BigInt` 和 `BigDecimal` + +当您需要非常大的数字时，请使用 `BigInt` 和 `BigDecimal` 类型： + +```scala +val a = BigInt(1_234_567_890_987_654_321L) +val b = BigDecimal(123_456.789) +``` + +其中 `Double` 和 `Float` 是近似的十进制数， `BigDecimal` 用于精确算术，例如在使用货币时。 + +`BigInt` 和 `BigDecimal` 的一个好处是，它们支持您习惯于用于数字类型的所有运算符： + +```scala +val b = BigInt(1234567890) // scala.math.BigInt = 1234567890 +val c = b + b // scala.math.BigInt = 2469135780 +val d = b * b // scala.math.BigInt = 1524157875019052100 +``` + +## 关于字符串的两个注释 + +Scala字符串类似于Java字符串，但它们有两个很棒的附加特性： + +- 它们支持字符串插值 +- 创建多行字符串很容易 + +### 字符串插值 + +字符串插值提供了一种非常可读的方式在字符串中使用变量。 +例如，给定以下三个变量： + +```scala +val firstName = "John" +val mi = 'C' +val lastName = "Doe" +``` + +你可以把那些变量组合成这样的字符串： + +```scala +println(s"Name: $firstName $mi $lastName") // "Name: John C Doe" +``` + +只需在字符串前面加上字母 `s` ，然后在字符串内的变量名称之前放置一个 `$` 符号。 + +如果要在字符串中使用可能较大的表达式时，请将它们放在大括号中： + +```scala +println(s"2 + 2 = ${2 + 2}") // prints "2 + 2 = 4" +val x = -1 +println(s"x.abs = ${x.abs}") // prints "x.abs = 1" +``` + +#### 其他插值器 + +放置在字符串前面的 `s` 只是一个可能的插值器。 +如果使用 `f` 而不是 `s` ，则可以在字符串中使用 `printf` 样式的格式语法。 +此外，字符串插值器只是一种特殊方法，可以定义自己的方法。 +例如，一些数据库库定义了非常强大的 `sql` 插值器。 + +### 多行字符串 + +多行字符串是通过将字符串包含在三个双引号内来创建的： + +```scala +val quote = """The essence of Scala: + Fusion of functional and object-oriented + programming in a typed setting.""" +``` + +这种基本方法的一个缺点是，第一行之后的行是缩进的，如下所示： + +```scala +"The essence of Scala: + Fusion of functional and object-oriented + programming in a typed setting." +``` + +当间距很重要时，在第一行之后的所有行前面放一个 `|` 符号，并在字符串之后调用 `stripMargin` 方法： + +```scala +val quote = """The essence of Scala: + |Fusion of functional and object-oriented + |programming in a typed setting.""".stripMargin +``` + +现在字符串里所有行都是左对齐了： + +```scala +"The essence of Scala: +Fusion of functional and object-oriented +programming in a typed setting." +``` + +## 类型转换 + +可以通过以下方式强制转换值类型： + +Scala Type Hierarchy + +例如： + +```scala +val b: Byte = 127 +val i: Int = b // 127 + +val face: Char = '☺' +val number: Int = face // 9786 +``` + +只有在没有丢失信息的情况下，才能强制转换为类型。否则，您需要明确说明强制转换： + +```scala +val x: Long = 987654321 +val y: Float = x.toFloat // 9.8765434E8 (注意 `.toFloat` 是必须的，因为强制类型转换后的精度会损) +val z: Long = y // Error +``` + +还可以将引用类型强制转换为子类型。 +这将在教程的后面部分介绍。 + +## `Nothing` 和 `null` + +`Nothing` 是所有类型的子类型，也称为**底部类型**。 +`Nothing` 类型是没有值的。 +一个常见的用途是发出非终止信号，例如抛出异常，程序退出或无限循环---即，它是不计算为值的那种表达式，或者不正常返回的方法。 + +`Null` 是所有引用类型的子类型（即 `AnyRef` 的任何子类型）。 +它具有由关键字面量 `null` 标识的单个值。 +目前，使用 `null` 被认为是不好的做法。它应该主要用于与其他JVM语言的互操作性。选择加入编译器选项会更改 `Null` 状态，以修复与其用法相关的警告。此选项可能会成为将来版本的 Scala 中的默认值。你可以在[这里][safe-null]了解更多关于它的信息。 + +与此同时， `null` 几乎不应该在Scala代码中使用。 +本书的[函数式编程章节][fp]和 [API文档][option-api]中讨论了 `null` 的替代方法。 + +[reference]: {{ site.scala3ref }}/overview.html +[matchable]: {{ site.scala3ref }}/other-new-features/matchable.html +[interpolation]: {% link _overviews/core/string-interpolation.md %} +[fp]: {% link _overviews/scala3-book/fp-intro.md %} +[option-api]: https://scala-lang.org/api/3.x/scala/Option.html +[safe-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html From e10cf0d837e90cd8b236b2de3662e4cebe482b9d Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sun, 22 May 2022 00:12:57 +0800 Subject: [PATCH 1878/3075] add _zh-cn/overviews/scala3-book/control-structures.md --- .../scala3-book/control-structures.md | 537 ++++++++++++++++++ 1 file changed, 537 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/control-structures.md diff --git a/_zh-cn/overviews/scala3-book/control-structures.md b/_zh-cn/overviews/scala3-book/control-structures.md new file mode 100644 index 0000000000..d52501eb45 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/control-structures.md @@ -0,0 +1,537 @@ +--- +title: 控制结构 +type: chapter +description: This page provides an introduction to Scala's control structures, including if/then/else, 'for' loops, 'for' expressions, 'match' expressions, try/catch/finally, and 'while' loops. +num: 18 +previous-page: first-look-at-types +next-page: domain-modeling-intro +--- + + +Scala具有您希望在编程语言中找到的控制结构，包括： + +- `if`/`then`/`else` +- `for` 循环 +- `while` 循环 +- `try`/`catch`/`finally` + +它还具有另外两个您可能以前从未见过的强大结构，具体取决于您的编程背景： + +- `for` 表达式（也被称作 _`for` 理解_） +- `match` 表达式 + +这些都将在以下各节中进行演示。 + +## if/then/else 结构nstruct + +单行 Scala `if` 语句像这样： + +```scala +if x == 1 then println(x) +``` + +如果要在 `if` 比较后运行多行代码，用这个语法： + +```scala +if x == 1 then + println("x is 1, as you can see:") + println(x) +``` + +`if`/`else` 语法像这样： + +```scala +if x == 1 then + println("x is 1, as you can see:") + println(x) +else + println("x was not 1") +``` + +这是 `if`/`else if`/`else` 语法： + +```scala +if x < 0 then + println("negative") +else if x == 0 then + println("zero") +else + println("positive") +``` + +如果您愿意，可以选择在每个表达式的末尾包含 `end if` 语句： + +```scala +if x == 1 then + println("x is 1, as you can see:") + println(x) +end if +``` + +### `if`/`else` 表达式总是有返回值 + +请注意， `if` / `else` 比较形式为 _表达式_，这意味着它们返回一个可以分配给变量的值。 +因此，不需要特殊的三元运算符： + +```scala +val minValue = if a < b then a else b +``` + +由于它们返回一个值，因此可以使用 `if`/`else` 表达式作为方法的主体： + +```scala +def compare(a: Int, b: Int): Int = + if a < b then + -1 + else if a == b then + 0 + else + 1 +``` + +### 题外话：面向表达式的编程 + +作为一般编程的简要说明，当您编写的每个表达式都返回一个值时，该样式称为面向 _面向表达式的编程_ 或 EOP。 +例如，这是一个 _表达式_： + +```scala +val minValue = if a < b then a else b +``` + +相反，不返回值的代码行称为 _语句_，用它们的 _副作用_。 +例如，这些代码行不返回值，因此用它们的副作用： + +```scala +if a == b then action() +println("Hello") +``` + +第一个示例在 `a` 等于 `b` 时将 `action` 方法作为副作用运行。 +第二个示例用于将字符串打印到 STDOUT 的副作用。 +随着你对Scala的了解越来越多，你会发现自己写的 _表达式_ 越来越多，_语句_ 也越来越少。 + +## `for` 循环 + +在最简单的用法中，Scala `for` 循环可用于迭代集合中的元素。 +例如，给定一个整数序列，您可以循环访问其元素并打印其值，如下所示： + +```scala +val ints = Seq(1, 2, 3) +for i <- ints do println(i) +``` + +代码 `i <- ints` 被称为 _生成器_，如果将括号从生成器中去掉，则必须在括号之后的代码前加上 `do` 关键字。 +否则，您可以像这样编写代码： + +```scala +for (i <- ints) println(i) +``` + +无论您使用哪种方法，这都是 Scala REPL 中的结果： + +```` +scala> val ints = Seq(1,2,3) +ints: Seq[Int] = List(1, 2, 3) + +scala> for i <- ints do println(i) +1 +2 +3 +```` + +如果需要在 `for` 生成器后面显示多行代码块，请使用以下语法： + +```scala +for + i <- ints +do + val x = i * 2 + println(s"i = $i, x = $x") +``` + +### 多生成器 + +`for` 循环可以有多个生成器，如以下示例所示： + +```scala +for + i <- 1 to 2 + j <- 'a' to 'b' + k <- 1 to 10 by 5 +do + println(s"i = $i, j = $j, k = $k") +``` + +那个表达式的输出： + +```` +i = 1, j = a, k = 1 +i = 1, j = a, k = 6 +i = 1, j = b, k = 1 +i = 1, j = b, k = 6 +i = 2, j = a, k = 1 +i = 2, j = a, k = 6 +i = 2, j = b, k = 1 +i = 2, j = b, k = 6 +```` + +### 防护 + +`for` 循环也可以包含 `if` 语句，这些语句称为 _防护_： + +```scala +for + i <- 1 to 5 + if i % 2 == 0 +do + println(i) +``` + +以上循环的输出是： + +```` +2 +4 +```` + +`for` 循环可以根据需要有任意数量的防护装置。 +此示例显示了打印数字`4`的一种方法： + +```scala +for + i <- 1 to 10 + if i > 3 + if i < 6 + if i % 2 == 0 +do + println(i) +``` + +### 把 `for` 用在 `Map` 上 + +您还可以将 `for` 循环与 `Map` 一起使用。 +例如，给定州缩写及其全名的 `Map`： + +```scala +val states = Map( + "AK" -> "Alaska", + "AL" -> "Alabama", + "AR" -> "Arizona" +) +``` + +您可以使用 `for` 打印键和值，如下所示： + +```scala +for (abbrev, fullName) <- states do println(s"$abbrev: $fullName") +``` + +以下是 REPL 中的样子： + +```scala +scala> for (abbrev, fullName) <- states do println(s"$abbrev: $fullName") +AK: Alaska +AL: Alabama +AR: Arizona +``` + +当 `for` 循环遍历映射时，每个键/值对都绑定到变量 `abbrev` 和 `fullName` ，它们位于元组中： + +```scala +(abbrev, fullName) <- states +``` + +当循环运行时，变量 `abbrev` 被分配给映射中的当前 _键_，变量 `fullName` 被分配给当前map 的 _值_。 + +## `for` 表达式 + +在前面的 `for` 循环示例中，这些循环都用于 _副作用_，特别是使用 `println` 将这些值打印到STDOUT。 + +重要的是要知道，您还可以创建有返回值的 `for` _表达式_。 +您可以通过添加 `yield` 关键字和要返回的表达式来创建 `for` 表达式，如下所示： + +```scala +val list = + for + i <- 10 to 12 + yield + i * 2 + +// list: IndexedSeq[Int] = Vector(20, 22, 24) +``` + +在 `for` 表达式运行后，变量 `list` 是包含所示值的 `Vector` 。 +这是表达式的工作原理： + +1. `for` 表达式开始循环访问范围 `(10, 11, 12)` 中的值。 + 它首先处理值`10`，将其乘以`2`，然后 _产生_ 结果为`20`的值。 +2. 接下来，它适用于`11`---范围中的第二个值。 + 它乘以`2`，然后产生值`22`。 + 您可以将这些产生的值看作它们累积在某个临时位置。 +3. 最后，循环从范围中获取数字 `12`，将其乘以 `2`，得到数字 `24`。 + 循环此时完成并产生最终结果 `Vector(20, 22, 24)`。 + +{% comment %} +NOTE: This is a place where it would be great to have a TIP or NOTE block: +{% endcomment %} + +虽然本节的目的是演示 `for` 表达式，但它可以帮助知道显示的 `for` 表达式等效于以下 `map` 方法调用： + +```scala +val list = (10 to 12).map(i => i * 2) +``` + +只要您需要遍历集合中的所有元素，并将算法应用于这些元素以创建新列表，就可以使用 `for` 表达式。 + +下面是一个示例，演示如何在 `yield` 之后使用代码块： + +```scala +val names = List("_olivia", "_walter", "_peter") + +val capNames = for name <- names yield + val nameWithoutUnderscore = name.drop(1) + val capName = nameWithoutUnderscore.capitalize + capName + +// capNames: List[String] = List(Olivia, Walter, Peter) +``` + +### 使用 `for` 表达式作为方法的主体 + +由于 `for` 表达式产生结果，因此可以将其用作返回有用值的方法的主体。 +此方法返回给定整数列表中介于`3`和`10`之间的所有值： + +```scala +def between3and10(xs: List[Int]): List[Int] = + for + x <- xs + if x >= 3 + if x <= 10 + yield x + +between3and10(List(1, 3, 7, 11)) // : List[Int] = List(3, 7) +``` + +## `while` 循环 + +Scala `while` 循环语法如下： + +```scala +var i = 0 + +while i < 3 do + println(i) + i += 1 +``` + +如果你把测试条件放在括号里，它可以写成这样： + +```scala +var i = 0 + +while (i < 3) { + println(i) + i += 1 +} +``` + + +## `match` 表达式 + +模式匹配是函数式编程语言的一个主要特征，Scala包含一个具有许多功能的 `match` 表达式。 + +在最简单的情况下，您可以使用 `match` 表达式，象Java `switch` 语句，根据整数值匹配。 +请注意，这实际上是一个表达式，因为它计算出一个结果： + +```scala +import scala.annotation.switch + +// `i` is an integer +val day = i match + case 0 => "Sunday" + case 1 => "Monday" + case 2 => "Tuesday" + case 3 => "Wednesday" + case 4 => "Thursday" + case 5 => "Friday" + case 6 => "Saturday" + case _ => "invalid day" // the default, catch-all +``` + +在此示例中，变量 `i` 根据所示情况进行测试。 +如果它介于`0`和`6`之间，则 `day` 绑定到一个字符串，该字符串表示一周中的某一天。 +否则，捕获所有情况，这些情况用 `_` 字符表示，这样 `day` 绑定到字符串 `"invalid day"`。 + +> 在编写像这样的简单 `match` 表达式时，建议在变量 `i` 上使用 `@switch` 注释。 +> 如果开关无法编译为 `tableswitch` 或 `lookupswitch`，则此注释会提供编译时警告，这个开关对性能更好。 + +### 使用缺省值 + +当您需要访问 `match` 表达式中匹配所有情况，也就是默认值时，只需在 `case` 语句的左侧提供一个变量名称，然后根据需要在语句的右侧使用该变量名称： + +```scala +i match + case 0 => println("1") + case 1 => println("2") + case what => println(s"You gave me: $what" ) +``` + +在此示例中，变量被命名为 `what` ，以表明可以为其指定任何合法名称。 +您还可以使用 `_` 作为名称来忽略该值。 + +### 在一行上处理多个可能的匹配项 + +如前所述，`match` 表达式具有许多功能。 +此示例演示如何在每个 `case` 语句中使用多个可能的模式匹配： + +```scala +val evenOrOdd = i match + case 1 | 3 | 5 | 7 | 9 => println("odd") + case 2 | 4 | 6 | 8 | 10 => println("even") + case _ => println("some other number") +``` + +### 在 `case` 子句中使用 `if` 防护 + +您还可以在匹配表达式的 `case` 中使用防护装置。 +在此示例中，第二个和第三个 `case` 都使用防护来匹配多个整数值： + +```scala +i match + case 1 => println("one, a lonely number") + case x if x == 2 || x == 3 => println("two’s company, three’s a crowd") + case x if x > 3 => println("4+, that’s a party") + case _ => println("i’m guessing your number is zero or less") +``` + +下面是另一个示例，它显示了如何将给定值与数字范围进行匹配： + +```scala +i match + case a if 0 to 9 contains a => println(s"0-9 range: $a") + case b if 10 to 19 contains b => println(s"10-19 range: $b") + case c if 20 to 29 contains c => println(s"20-29 range: $c") + case _ => println("Hmmm...") +``` + +#### 样例类和 match 表达式 + +您还可以从 `case` 类中提取字段---以及正确编写了 `apply`/`unapply` 方法的类---并在防护条件下使用这些字段。 +下面是一个使用简单 `Person` 案例类的示例： + +```scala +case class Person(name: String) + +def speak(p: Person) = p match + case Person(name) if name == "Fred" => println(s"$name says, Yubba dubba doo") + case Person(name) if name == "Bam Bam" => println(s"$name says, Bam bam!") + case _ => println("Watch the Flintstones!") + +speak(Person("Fred")) // "Fred says, Yubba dubba doo" +speak(Person("Bam Bam")) // "Bam Bam says, Bam bam!" +``` + +### 使用 `match` 表达式作为方法的主体 + +由于 `match` 表达式返回一个值，因此它们可以用作方法的主体。 +此方法采用 `Matchable` 值作为输入参数，并根据 `match` 表达式的结果返回 `Boolean`： + +```scala +def isTruthy(a: Matchable) = a match + case 0 | "" | false => false + case _ => true +``` + +输入参数 `a` 被定义为[`Matchable`类型][matchable]---这是可以对其执行模式匹配的所有Scala类型的根。 +该方法通过在输入上进行匹配来实现，提供两种情况： +第一个检查给定值是整数`0`，空字符串还是 `false`，在这种情况下返回 `false`。 +在默认情况下，我们为任何其他值返回 `true`。 +以下示例演示此方法的工作原理： + +```scala +isTruthy(0) // false +isTruthy(false) // false +isTruthy("") // false +isTruthy(1) // true +isTruthy(" ") // true +isTruthy(2F) // true +``` + +使用 `match` 表达式作为方法的主体是一种非常常见的用法。 + +#### 匹配表达式支持许多不同类型的模式 + +有许多不同形式的模式可用于编写 `match` 表达式。 +示例包括： + +- 常量模式（如 `case 3 => `） +- 序列模式（如 `case List(els : _*) =>`） +- 元组模式（如 `case (x, y) =>`） +- 构造函数模式（如 `case Person(first, last) =>`） +- 类型测试模式（如 `case p: Person =>`） + +所有这些类型的模式匹配都展示在以下 `pattern` 方法中，该方法采用类型为 `Matchable` 的输入参数并返回 `String` ： + +```scala +def pattern(x: Matchable): String = x match + + // constant patterns + case 0 => "zero" + case true => "true" + case "hello" => "you said 'hello'" + case Nil => "an empty List" + + // sequence patterns + case List(0, _, _) => "a 3-element list with 0 as the first element" + case List(1, _*) => "list, starts with 1, has any number of elements" + case Vector(1, _*) => "vector, starts w/ 1, has any number of elements" + + // tuple patterns + case (a, b) => s"got $a and $b" + case (a, b, c) => s"got $a, $b, and $c" + + // constructor patterns + case Person(first, "Alexander") => s"Alexander, first name = $first" + case Dog("Zeus") => "found a dog named Zeus" + + // type test patterns + case s: String => s"got a string: $s" + case i: Int => s"got an int: $i" + case f: Float => s"got a float: $f" + case a: Array[Int] => s"array of int: ${a.mkString(",")}" + case as: Array[String] => s"string array: ${as.mkString(",")}" + case d: Dog => s"dog: ${d.name}" + case list: List[?] => s"got a List: $list" + case m: Map[?, ?] => m.toString + + // the default wildcard pattern + case _ => "Unknown" +``` + +{% comment %} +TODO: Add in the new Scala 3 syntax shown on this page: +http://dotty.epfl.ch/docs/reference/changed-features/match-syntax.html +{% endcomment %} + +## try/catch/finally + +与Java一样，Scala也有一个 `try`/`catch`/`finally` 结构，让你可以捕获和管理异常。 +为了保持一致性，Scala使用与 `match` 表达式相同的语法，并支持在可能发生的不同可能的异常上进行模式匹配。 + +在下面的示例中，`openAndReadAFile` 是一个执行其名称含义的方法：它打开一个文件并读取其中的文本，将结果分配给可变变量 `text` ： + +```scala +var text = "" +try + text = openAndReadAFile(filename) +catch + case fnf: FileNotFoundException => fnf.printStackTrace() + case ioe: IOException => ioe.printStackTrace() +finally + // close your resources here + println("Came to the 'finally' clause.") +``` + +假设 `openAndReadAFile` 方法使用 Java `java.io.*` 类来读取文件并且不捕获其异常，则尝试打开和读取文件可能会导致 `FileNotFoundException` 和 `IOException` 异常，本例中，这两个异常在 `catch` 块中被捕获。 + +[matchable]: {{ site.scala3ref }}/other-new-features/matchable.html From 3573d192ce0678488253a75fb2d1502738cc0069 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sun, 22 May 2022 20:09:35 +0800 Subject: [PATCH 1879/3075] add two files as below --- .../scala3-book/domain-modeling-intro.md | 14 + .../scala3-book/domain-modeling-tools.md | 700 ++++++++++++++++++ 2 files changed, 714 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/domain-modeling-intro.md create mode 100644 _zh-cn/overviews/scala3-book/domain-modeling-tools.md diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-intro.md b/_zh-cn/overviews/scala3-book/domain-modeling-intro.md new file mode 100644 index 0000000000..eb63b37efb --- /dev/null +++ b/_zh-cn/overviews/scala3-book/domain-modeling-intro.md @@ -0,0 +1,14 @@ +--- +title: 领域建模 +type: chapter +description: This chapter provides an introduction to domain modeling in Scala 3. +num: 19 +previous-page: control-structures +next-page: domain-modeling-tools +--- + +本章介绍如何使用 Scala 3 对周围的世界进行建模： + +- 工具部分介绍了可供您使用的工具，包括类、traits 、枚举等 +- OOP 建模部分着眼于面向对象编程 （OOP） 风格中的建模属性和行为 +- FP 建模部分以函数式编程 （FP） 风格来看领域建模 diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md new file mode 100644 index 0000000000..af76e6ca47 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md @@ -0,0 +1,700 @@ +--- +title: 工具 +type: section +description: This chapter provides an introduction to the available domain modeling tools in Scala 3, including classes, traits, enums, and more. +num: 20 +previous-page: domain-modeling-intro +next-page: domain-modeling-oop +--- + +Scala 3提供了许多不同的结构，因此我们可以对周围的世界进行建模： + +- 类 +- 对象 +- 伴生对象 +- traits +- 抽象类 +- 枚举 +- 样例类 +- 样例对象 + +本节简要介绍其中的每种语言功能。 + +## 类 + +与其他语言一样，Scala中的 _类_是用于创建对象实例的模板。 +下面是一些类的示例： + +```scala +class Person(var name: String, var vocation: String) +class Book(var title: String, var author: String, var year: Int) +class Movie(var name: String, var director: String, var year: Int) +``` + +这些例子表明，Scala有一种非常轻量级的方式来声明类。 + +我们的示例类的所有参数都定义为 `var` 字段，这意味着它们是可变的：您可以读取它们，也可以修改它们。 +如果您希望它们是不可变的---仅读取---请改为将它们创建为 `val` 字段，或者使用样例类。 + +在Scala 3之前，您使用 `new` 关键字来创建类的新实例： + +```scala +val p = new Person("Robert Allen Zimmerman", "Harmonica Player") +// --- +``` + +然而，通过[创造者应用][creator]，在 Scala 3 里面不要求使用 `new`： + +```scala +val p = Person("Robert Allen Zimmerman", "Harmonica Player") +``` + +一旦你有了一个类的实例，比如`p`，你就可以访问它的字段，在此示例中，这些字段都是构造函数的参数： + +```scala +p.name // "Robert Allen Zimmerman" +p.vocation // "Harmonica Player" +``` + +如前所述，所有这些参数都是作为 `var` 字段创建的，因此您也可以更改它们： + +```scala +p.name = "Bob Dylan" +p.vocation = "Musician" +``` + +### 字段和方法 + +类还可以具有不属于构造函数的方法和其他字段。 +它们在类的主体中定义。 +主体初始化为默认构造函数的一部分： + +```scala +class Person(var firstName: String, var lastName: String): + + println("initialization begins") + val fullName = firstName + " " + lastName + + // a class method + def printFullName: Unit = + // access the `fullName` field, which is created above + println(fullName) + + printFullName + println("initialization ends") +``` + +以下 REPL 会话演示如何使用这个类创建新的 `Person` 实例： + +```` +scala> val john = Person("John", "Doe") +initialization begins +John Doe +initialization ends +val john: Person = Person@55d8f6bb + +scala> john.printFullName +John Doe +```` + +类还可以扩展 traits和抽象类，我们将在下面专门部分中介绍这些内容。 + +### 默认参数值 + +快速浏览一下其他功能，类构造函数参数也可以具有默认值： + +```scala +class Socket(val timeout: Int = 5_000, val linger: Int = 5_000): + override def toString = s"timeout: $timeout, linger: $linger" +``` + +此功能的一大优点是，它允许代码的使用者以各种不同的方式创建类，就好像该类有别的构造函数一样： + +```scala +val s = Socket() // timeout: 5000, linger: 5000 +val s = Socket(2_500) // timeout: 2500, linger: 5000 +val s = Socket(10_000, 10_000) // timeout: 10000, linger: 10000 +val s = Socket(timeout = 10_000) // timeout: 10000, linger: 5000 +val s = Socket(linger = 10_000) // timeout: 5000, linger: 10000 +``` + +创建类的新实例时，还可以使用命名参数。 +当许多参数具有相同的类型时，这特别有用，如以下比较所示： + +```scala +// option 1 +val s = Socket(10_000, 10_000) + +// option 2 +val s = Socket( + timeout = 10_000, + linger = 10_000 +) +``` + +### 辅助构造函数 + +可以为类定义多个构造函数，以便类的使用者用不同的方式来生成这个类。 +例如，假设您需要编写一些代码给大学招生系统中的学生进行建模。 +在分析需求时，您已经看到您需要能够以三种方式构建 `Student` 实例： + +- 当他们第一次开始招生过程时，带有姓名和政府 ID， +- 当他们提交申请时，带有姓名，政府 ID 和额外的申请日期 +- 在他们被录取后，带有姓名，政府 ID 和学生证 + +在 OOP 风格中处理这种情况的一种方法是使用以下代码： + +```scala +import java.time.* + +// [1] the primary constructor +class Student( + var name: String, + var govtId: String +): + private var _applicationDate: Option[LocalDate] = None + private var _studentId: Int = 0 + + // [2] a constructor for when the student has completed + // their application + def this( + name: String, + govtId: String, + applicationDate: LocalDate + ) = + this(name, govtId) + _applicationDate = Some(applicationDate) + + // [3] a constructor for when the student is approved + // and now has a student id + def this( + name: String, + govtId: String, + studentId: Int + ) = + this(name, govtId) + _studentId = studentId +``` + +{% comment %} +// for testing that code +override def toString = s""" +|Name: $name +|GovtId: $govtId +|StudentId: $_studentId +|Date Applied: $_applicationDate +""".trim.stripMargin +{% endcomment %} + +该类有三个构造函数，由代码中编号的注释给出： + +1. 主构造函数，由类定义中的 `name` 和 `govtId` 给出 +2. 具有参数 `name` 、 `govtId` 和 `applicationDate` 的辅助构造函数 +3. 另一个带有参数 `name` 、 `govtId` 和 `studentId` 的辅助构造函数 + +这些构造函数可以这样调用： + +```scala +val s1 = Student("Mary", "123") +val s2 = Student("Mary", "123", LocalDate.now) +val s3 = Student("Mary", "123", 456) +``` + +虽然可以使用此技术，但请记住，构造函数参数也可以具有默认值，这使得一个类看起来具有多个构造函数。 +这在前面的 `Socket` 示例中所示。 + +## 对象 + +对象是一个正好有一个实例的类。 +当其成员是引用类时，它会延迟初始化，类似于 `lazy val` 。 +Scala 中的对象允许在一个命名空间下对方法和字段进行分组，类似于我们在 Java，Javascript（ES6）中使用 `static` 方法或在 Python 中使用 `@staticmethod` 方法。 + +声明 `object` 类似于声明 `class` 。 +下面是一个“字符串实用程序”对象的示例，其中包含一组用于处理字符串的方法： + +```scala +object StringUtils: + def truncate(s: String, length: Int): String = s.take(length) + def containsWhitespace(s: String): Boolean = s.matches(".*\\s.*") + def isNullOrEmpty(s: String): Boolean = s == null || s.trim.isEmpty +``` + +我们可以这样使用对象： + +```scala +StringUtils.truncate("Chuck Bartowski", 5) // "Chuck" +``` + +在 Scala 中导入非常灵活，并允许我们导入对象的 _所有_ 成员： + +```scala +import StringUtils.* +truncate("Chuck Bartowski", 5) // "Chuck" +containsWhitespace("Sarah Walker") // true +isNullOrEmpty("John Casey") // false +``` + +或者只是 _部分_ 成员： + +```scala +import StringUtils.{truncate, containsWhitespace} +truncate("Charles Carmichael", 7) // "Charles" +containsWhitespace("Captain Awesome") // true +isNullOrEmpty("Morgan Grimes") // Not found: isNullOrEmpty (error) +``` + +对象还可以包含字段，这些字段也可以像静态成员一样访问： + +```scala +object MathConstants: + val PI = 3.14159 + val E = 2.71828 + +println(MathConstants.PI) // 3.14159 +``` + + +## 伴生对象 + +与类同名且在与类在相同的文件中声明的 `object` 称为 _“伴生对象”_。 +同样，相应的类称为对象的伴生类。 +伴生类或对象可以访问其伴生的私有成员。 + +伴生对象用于不特定于伴生类实例的方法和值。 +例如，在下面的示例中，类 `Circle` 具有一个名为 `area` 的成员，该成员特定于每个实例，其伴生对象具有一个名为 `calculateArea` 的方法，该方法(a)不特定于实例，并且(b)可用于每个实例： + +```scala +import scala.math.* + +case class Circle(radius: Double): + def area: Double = Circle.calculateArea(radius) + +object Circle: + private def calculateArea(radius: Double): Double = Pi * pow(radius, 2.0) + +val circle1 = Circle(5.0) +circle1.area +``` + +在此示例中，每个实例可用的 `area` 方法使用伴生对象中定义的 `calculateArea` 方法。 +再一次， `calculateArea` 类似于Java中的静态方法。 +此外，由于 `calculateArea` 是私有的，因此其他代码无法访问它，但如图所示，它可以被 `Circle` 类的实例看到。 + +### 其他用途 + +伴生对象可用于多种用途： + +- 如图所示，它们可用于将“静态”方法分组到命名空间下 + - 这些方法可以是公共的，也可以是私有的 + - 如果 `calculateArea` 是公开的，它将被访问为 `Circle.calculateArea` +- 它们可以包含 `apply` 方法，这些方法---感谢一些语法糖---作为工厂方法来构建新实例 +- 它们可以包含 `unapply` 方法，用于解构对象，例如模式匹配 + +下面快速了解如何将 `apply` 方法当作工厂方法来创建新对象： + +```scala +class Person: + var name = "" + var age = 0 + override def toString = s"$name is $age years old" + +object Person: + + // a one-arg factory method + def apply(name: String): Person = + var p = new Person + p.name = name + p + + // a two-arg factory method + def apply(name: String, age: Int): Person = + var p = new Person + p.name = name + p.age = age + p + +end Person + +val joe = Person("Joe") +val fred = Person("Fred", 29) + +//val joe: Person = Joe is 0 years old +//val fred: Person = Fred is 29 years old +``` + +此处不涉及 `unapply` 方法，但在 [参考文档][unapply] 中对此进行了介绍。 + +## Traits + +如果你熟悉Java，Scala trait 类似于Java 8+中的接口。性状可以包含： + +- 抽象方法和成员 +- 具体方法和成员 + +在基本用法中，trait 可以用作接口，仅定义将由其他类实现的抽象成员： + +```scala +trait Employee: + def id: Int + def firstName: String + def lastName: String +``` + +但是，traits 也可以包含具体成员。 +例如，以下 traits定义了两个抽象成员---`numLegs` 和 `walk()`---并且还具有`stop()`方法的具体实现： + +```scala +trait HasLegs: + def numLegs: Int + def walk(): Unit + def stop() = println("Stopped walking") +``` + +下面是另一个具有抽象成员和两个具体实现的 trait： + +```scala +trait HasTail: + def tailColor: String + def wagTail() = println("Tail is wagging") + def stopTail() = println("Tail is stopped") +``` + +请注意，每个 trait 只处理非常特定的属性和行为： `HasLegs` 只处理腿，而 `HasTail` 只处理与尾部相关的功能。 +Traits可以让你构建这样的小模块。 + +在代码的后面部分，类可以混合多个 traits 来构建更大的组件： + +```scala +class IrishSetter(name: String) extends HasLegs, HasTail: + val numLegs = 4 + val tailColor = "Red" + def walk() = println("I’m walking") + override def toString = s"$name is a Dog" +``` + +请注意，`IrishSetter` 类实现了在 `HasLegs` 和 `HasTail` 中定义的抽象成员。 +现在，您可以创建新的 `IrishSetter` 实例： + +```scala +val d = IrishSetter（“Big Red”） // “Big Red is a Dog” +``` + +这只是你对 trait 可以完成的事情的一种体验。 +有关更多详细信息，请参阅这些建模课程的其余部分。 + +## 抽象类 + +{% comment %} +LATER: If anyone wants to update this section, our comments about abstract classes and traits are on Slack. The biggest points seem to be: +- The `super` of a trait is dynamic +- At the use site, people can mix in traits but not classes +- It remains easier to extend a class than a trait from Java, if the trait has at least a field +- Similarly, in Scala.js, a class can be imported from or exported to JavaScript. A trait cannot +- There are also some point that unrelated classes can’t be mixed together, and this can be a modeling advantage +{% endcomment %} + +当你想写一个类，但你知道它将有抽象成员时，你可以创建一个 trait 或一个抽象类。 +在大多数情况下，你会使用 trait，但从历史上看，有两种情况，使用抽象类比使用 trait 更好： + +- 您想要创建一个使用构造函数参数的基类 +- 代码将从 Java 代码调用 + +### 使用构造函数参数的基类 + +在 Scala 3 之前，当基类需要使用构造函数参数时，你可以将其声明为`abstract class`： + +```scala +abstract class Pet(name: String): + def greeting: String + def age: Int + override def toString = s"My name is $name, I say $greeting, and I’m $age" + +class Dog(name: String, age: Int) extends Pet(name): + val greeting = "Woof" + +val d = Dog("Fido", 1) +``` + +但是，在 Scala 3 中，trait 现在可以具有[参数][trait-params]，因此您现在可以在相同情况下使用 trait： + +```scala +trait Pet(name: String): + def greeting: String + def age: Int + override def toString = s"My name is $name, I say $greeting, and I’m $age" + +class Dog(name: String, var age: Int) extends Pet(name): + val greeting = "Woof" + +val d = Dog("Fido", 1) +``` + +trait 的组成更加灵活---您可以混合多个 trait，但只能扩展一个类---并且大多数时候应该优先于类和抽象类。 +经验法则是，每当要创建特定类型的实例时，就使用类;如果要分解和重用行为时，应使用trait。 + +## 枚举 + +枚举可用于定义由一组有限的命名值组成的类型（在[FP建模][fp-modeling]一节中，我们将看到枚举比这更灵活）。 +基本枚举用于定义常量集，如一年中的月份、一周中的天数、北/南/东/西方向等。 + +例如，这些枚举定义了与比萨饼相关的属性集： + +```scala +enum CrustSize: + case Small, Medium, Large + +enum CrustType: + case Thin, Thick, Regular + +enum Topping: + case Cheese, Pepperoni, BlackOlives, GreenOlives, Onions +``` + +若要在其他代码中使用它们，请先导入它们，然后使用它们： + +```scala +import CrustSize.* +val currentCrustSize = Small +``` + +枚举值可以使用等于 （`==`） 进行比较，也可以用匹配的方式： + +```scala +// if/then +if (currentCrustSize == Large) + println("You get a prize!") + +// match +currentCrustSize match + case Small => println("small") + case Medium => println("medium") + case Large => println("large") +``` + +### 其他枚举特性 + +枚举也可以参数化： + +```scala +enum Color(val rgb: Int): + case Red extends Color(0xFF0000) + case Green extends Color(0x00FF00) + case Blue extends Color(0x0000FF) +``` + +它们还可以具有成员（如字段和方法）： + +```scala +enum Planet(mass: Double, radius: Double): + private final val G = 6.67300E-11 + def surfaceGravity = G * mass / (radius * radius) + def surfaceWeight(otherMass: Double) = + otherMass * surfaceGravity + + case Mercury extends Planet(3.303e+23, 2.4397e6) + case Earth extends Planet(5.976e+24, 6.37814e6) + // more planets here ... +``` + +### 与 Java 枚举的兼容性 + +如果要将 Scala 定义的枚举用作 Java 枚举，可以通过扩展类 `java.lang.Enum`（默认情况下导入）来实现，如下所示： + +```scala +enum Color extends Enum[Color] { case Red, Green, Blue } +``` + +类型参数来自 Java `enum` 定义，并且应与枚举的类型相同。 +在扩展时，无需向`java.lang.Enum`提供构造函数参数（如Java API文档中所定义的那样）---编译器会自动生成它们。 + +像这样定义 `Color` 之后，你可以像使用 Java 枚举一样使用它： + +```` +scala> Color.Red.compareTo（Color.Green） +val res0： Int = -1 +```` + +关于[代数数据类型][adts]和[参考文档][ref-enums]的部分更详细地介绍了枚举。 + +## 样例类 + +样例类用于对不可变数据结构进行建模。 +举个例子： + +```scala +case class Person(name: String, relation: String) +``` + +由于我们将 `Person` 声明为样例类，因此默认情况下，字段 `name` 和 `relation` 是公共的和不可变的。 +我们可以创建 样例类的实例，如下所示： + +```scala +val christina = Person("Christina", "niece") +``` + +请注意，这些字段不能发生更改： + +```scala +christina.name = "Fred" // error: reassignment to val +``` + +由于 样例类的字段被假定为不可变的，因此 Scala 编译器可以为您生成许多有用的方法： + +* 生成一个 `unapply` 方法，该方法允许您对样例类执行模式匹配（即，`case Person（n， r） => ...`）。 +* 在类中生成一个 `copy` 方法，这对于创建实例的修改副本非常有用。 +* 生成使用结构相等的 `equals` 和 `hashCode` 方法，允许您在 `Map` 中使用样例类的实例。 +* 生成默认的 `toString` 方法，对调试很有帮助。 + +以下示例演示了这些附加功能： + +```scala +// Case classes can be used as patterns +christina match + case Person(n, r) => println("name is " + n) + +// `equals` and `hashCode` methods generated for you +val hannah = Person("Hannah", "niece") +christina == hannah // false + +// `toString` method +println(christina) // Person(Christina,niece) + +// built-in `copy` method +case class BaseballTeam(name: String, lastWorldSeriesWin: Int) +val cubs1908 = BaseballTeam("Chicago Cubs", 1908) +val cubs2016 = cubs1908.copy(lastWorldSeriesWin = 2016) +// result: +// cubs2016: BaseballTeam = BaseballTeam(Chicago Cubs,2016) +``` + +### 支持函数式编程 + +如前所述，样例类支持函数式编程 （FP）： + +- 在FP中，您尽量避免改变数据结构。 + 因此，构造函数字段默认为 `val` 是有道理的。 + 由于无法更改样例类的实例，因此可以轻松共享它们，而不必担心突变或争用条件。 +- 您可以使用 `copy` 方法作为模板来创建新的（可能已更改的）实例，而不是改变实例。 + 此过程可称为“复制时更新”。 +- 自动为您生成 `unapply` 方法，还允许以模式匹配的高级方式使用样例类。 + +{% comment %} +NOTE: We can use this following text, if desired. If it’s used, it needs to be updated a little bit. + +### 一种 `unapply` 的方法 + +样例类的一大优点是，它可以为您的类自动生成一个 `unapply` 方法，因此您不必编写一个方法。 + +为了证明这一点，假设你有这个 trait： + +```scala +trait Person: + def name: String +``` + +然后，创建以下样例类以扩展该 trait： + +```scala +case class Student(name: String, year: Int) extends Person +case class Teacher(name: String, specialty: String) extends Person +``` + +由于它们被定义为样例类---并且它们具有内置的 `unapply` 方法---因此您可以编写如下匹配表达式： + +```scala +def getPrintableString(p: Person): String = p match + case Student(name, year) => + s"$name is a student in Year $year." + case Teacher(name, whatTheyTeach) => + s"$name teaches $whatTheyTeach." +``` + +请注意 `case` 语句中的以下两种模式： + +```scala +case Student(name, year) => +case Teacher(name, whatTheyTeach) => +``` + +这些模式之所以有效，是因为 `Student` 和 `Teacher` 被定义为具有 `unapply` 方法的样例类，其类型签名符合特定标准。 +从技术上讲，这些示例中显示的特定类型的模式匹配称为_结构模式匹配_。 + +> Scala 标准是， `unapply` 方法在包装在 `Option` 中的元组中返回 样例类构造函数字段。 +> 解决方案的“元组”部分在上一课中进行了演示。 + +要显示该代码的工作原理，请创建一个 `Student` 和 `Teacher` 的实例： + +```scala +val s = Student("Al", 1) +val t = Teacher("Bob Donnan", "Mathematics") +``` + +接下来，这是当您使用这两个实例来调用 `getPrintableString` 时，REPL 中的输出如下所示： + +```scala +scala> getPrintableString(s) +res0: String = Al is a student in Year 1. + +scala> getPrintableString(t) +res1: String = Bob Donnan teaches Mathematics. +``` + +>所有这些关于 `unapply` 方法和提取器的内容对于这样的入门书来说都有些先进，但是因为样例类是一个重要的FP主题，所以似乎最好涵盖它们，而不是跳过它们。 + +#### 将模式匹配添加到任何具有 unapply 的类型 + +Scala 的一个很好的特性是，你可以通过编写自己的 `unapply` 方法来向任何类型添加模式匹配。 +例如，此类在其伴生对象中定义了一个 `unapply` 方法： + +```scala +class Person(var name: String, var age: Int) +object Person: + def unapply(p: Person): Tuple2[String, Int] = (p.name, p.age) +``` + +因为它定义了一个 `unapply` 方法，并且因为该方法返回一个元组，所以您现在可以将 `Person` 与 `match` 表达式一起使用： + +```scala +val p = Person("Astrid", 33) + +p match + case Person(n,a) => println(s"name: $n, age: $a") + case null => println("No match") + +// that code prints: "name: Astrid, age: 33" +``` +{% endcomment %} + + +## 样例对象 + +样例对象之于对象，就像 样例类之于类：它们提供了许多自动生成的方法，以使其更加强大。 +每当您需要需要少量额外功能的单例对象时，它们特别有用，例如在 `match` 表达式中与模式匹配一起使用。 + +当您需要传递不可变消息时，样例对象非常有用。 +例如，如果您正在处理音乐播放器项目，您将创建一组命令或消息，如下所示： + +```scala +sealed trait Message +case class PlaySong(name: String) extends Message +case class IncreaseVolume(amount: Int) extends Message +case class DecreaseVolume(amount: Int) extends Message +case object StopPlaying extends Message +``` + +然后在代码的其他部分，你可以编写这样的方法，这些方法使用模式匹配来处理传入的消息（假设方法 `playSong` ， `changeVolume` 和 `stopPlayingSong` 在其他地方定义）： + +```scala +def handleMessages(message: Message): Unit = message match + case PlaySong(name) => playSong(name) + case IncreaseVolume(amount) => changeVolume(amount) + case DecreaseVolume(amount) => changeVolume(-amount) + case StopPlaying => stopPlayingSong() +``` + +[ref-enums]: {{ site.scala3ref }}/enums/enums.html +[adts]: {% link _overviews/scala3-book/types-adts-gadts.md %} +[fp-modeling]: {% link _overviews/scala3-book/domain-modeling-fp.md %} +[creator]: {{ site.scala3ref }}/other-new-features/creator-applications.html +[unapply]: {{ site.scala3ref }}/changed-features/pattern-matching.html +[trait-params]: {{ site.scala3ref }}/other-new-features/trait-parameters.html From d49188affc92d29e3ee91a22a4c27a73b49ced52 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Mon, 23 May 2022 18:00:25 +0200 Subject: [PATCH 1880/3075] add scala-cli to cs setup list --- _includes/getting-started.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/_includes/getting-started.md b/_includes/getting-started.md index 0a00d4d358..4a900782ff 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -48,12 +48,14 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ Along with managing JVMs, `cs setup` also installs useful command-line tools: -- A JDK (if you don't have one already) -- The [sbt](https://www.scala-sbt.org/) build tool -- [Ammonite](https://ammonite.io/), an enhanced REPL -- [scalafmt](https://scalameta.org/scalafmt/), the Scala code formatter -- `scalac` (the Scala compiler) -- `scala` (the Scala REPL and script runner). +| Commands | Description | +|----------|-------------| +| `scalac` | the Scala compiler | +| `scala` | the Scala REPL and script runner | +| `scala-cli`| [Scala CLI](https://scala-cli.virtuslab.org), interactive toolkit for Scala | +| `sbt`, `sbtn` | The [sbt](https://www.scala-sbt.org/) build tool | +| `amm` | [Ammonite](https://ammonite.io/) is an enhanced REPL | +| `scalafmt` | [Scalafmt](https://scalameta.org/scalafmt/) is the Scala code formatter | For more information about `cs`, read [coursier-cli documentation](https://get-coursier.io/docs/cli-overview). From d8cbad31d56ff9104a26b54441316ae95c9a8b93 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 24 May 2022 15:05:07 +0800 Subject: [PATCH 1881/3075] add _zh-cn/overviews/scala3-book/domain-modeling-oop.md --- .../scala3-book/domain-modeling-oop.md | 317 ++++++++++++++++++ 1 file changed, 317 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/domain-modeling-oop.md diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md new file mode 100644 index 0000000000..b00e71b62c --- /dev/null +++ b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md @@ -0,0 +1,317 @@ +--- +title: OOP 建模 +type: section +description: This chapter provides an introduction to OOP domain modeling with Scala 3. +num: 21 +previous-page: domain-modeling-tools +next-page: domain-modeling-fp +--- + + +本章介绍了在 Scala 3 中使用面向对象编程 (OOP) 进行领域建模。 + +## 介绍 + +Scala 为面向对象设计提供了所有必要的工具： + +- **Traits** 让您指定（抽象）接口以及具体实现。 +- **Mixin Composition** 为您提供了从较小的部分组成组件的工具。 +- **类**可以实现trait指定的接口。 +- 类的**实例**可以有自己的私有状态。 +- **Subtyping** 允许您在需要超类实例的地方使用一个类的实例。 +- **访问修饰符**允许您控制类的哪些成员可以被代码的哪个部分访问。 + +## Traits + +可能与支持 OOP 的其他语言（例如 Java）不同，Scala 中分解的主要工具不是类，而是trait。 +它们可以用来描述抽象接口，例如： + +```scala +trait Showable: + def show: String +``` + +并且还可以包含具体的实现： + +```scala +trait Showable: + def show: String + def showHtml = "

      " + show + "

      " +``` + +你可以看到我们用抽象方法 `show` 来定义方法 `showHtml`。 + +[Odersky and Zenger][scalable] 展示了 _面向服务的组件模型_ 和视图： + +- **抽象成员**作为_必须_服务：它们仍然需要由子类实现。 +- **具体成员**作为_提供_服务：它们被提供给子类。 + +我们已经可以在 `Showable` 的示例中看到这一点：定义一个扩展 `Showable` 的类 `Document`，我们仍然必须定义 `show`，但我们提供了 `showHtml`： + +```scala +class Document(text: String) extends Showable: + def show = text +``` + +#### 抽象成员 +抽象方法并不是trait中唯一可以抽象的东西。 +一个trait可以包含： + +- 抽象方法（`def m(): T`） +- 抽象值定义（`val x: T`） +- 抽象类型成员（`type T`），可能有界限（`type T <: S`） +- 抽象给定（`given t: T`） + +上述每个特性都可用于指定对 trait 实现者的某种形式的要求。 + +## 混入组合 + +traits 不仅可以包含抽象和具体的定义，Scala 还提供了一种组合多个 trait 的强大方法：这个特性通常被称为 _混入组合_。 + +让我们假设以下两个（可能独立定义的）traits： + +```scala +trait GreetingService: + def translate(text: String): String + def sayHello = translate("Hello") + +trait TranslationService: + def translate(text: String): String = "..." +``` + +要组合这两个服务，我们可以简单地创建一个扩展它们的新trait： + +```scala +trait ComposedService extends GreetingService, TranslationService +``` + +一个 trait 中的抽象成员（例如 `GreetingService` 中的 `translate`）会自动与另一个 trait 中的具体成员匹配。 +这不仅适用于本例中的方法，而且适用于上述所有其他抽象成员（即类型、值定义等）。 + +## 类 + +Traits 非常适合模块化组件和描述接口（必需和提供）。 +但在某些时候，我们会想要创建它们的实例。 +在 Scala 中设计软件时，只考虑在继承模型的叶子中使用类通常很有帮助： + +{% comment %} +NOTE: I think “leaves” may technically be the correct word to use, but I prefer “leafs.” +{% endcomment %} + +|Traits | `T1`, `T2`, `T3` +|组合 traits | `S extends T1, T2`, `S extends T2, T3` +|类 | `C extends S, T3` +|实例 | `C()` + +在 Scala 3 中更是如此，trait 现在也可以接受参数，进一步消除了对类的需求。 + +#### 定义类 + +像trait一样，类可以扩展多个trait（但只有一个超类）： + +```scala +class MyService(name: String) extends ComposedService, Showable: + def show = s"$name says $sayHello" +``` + +#### 子类型化 + +我们可以创建一个 `MyService` 的实例，如下所示： + +```scala +val s1: MyService = MyService("Service 1") +``` + +通过子类型化的方式，我们的实例 `s1` 可以在任何扩展了trait的地方使用： + +```scala +val s2: GreetingService = s1 +val s3: TranslationService = s1 +val s4: Showable = s1 +// ... and so on ... +``` + +#### 扩展计划 + +如前所述，可以扩展另一个类： + +```scala +class Person(name: String) +class SoftwareDeveloper(name: String, favoriteLang: String) + extends Person(name) +``` + +然而，由于 _traits_ 被设计为主要的分解手段，在一个文件中定义的类_不能_在另一个文件中扩展。 +为了允许这样做，需要将基类标记为 `open`： + +```scala +open class Person(name: String) +``` + +用 [`open`][open] 标记类是 Scala 3 的一个新特性。必须将类显式标记为开放可以避免面向对象设计中的许多常见缺陷。 +特别是，它要求库设计者明确计划扩展，例如记录标记为开放的类以及附加的扩展合同。 + +{% comment %} +NOTE/FWIW: In his book, “Effective Java,” Joshua Bloch describes this as “Item 19: Design and document for inheritance or else prohibit it.” +Unfortunately I can’t find any good links to this on the internet. +I only mention this because I think that book and phrase is pretty well known in the Java world. +{% endcomment %} + +## 实例和私有可变状态 + +与其他支持 OOP 的语言一样，Scala 中的trait和类可以定义可变字段： + +```scala +class Counter: + // can only be observed by the method `count` + private var currentCount = 0 + + def tick(): Unit = currentCount += 1 + def count: Int = currentCount +``` + +`Counter` 类的每个实例都有自己的私有状态，只能通过方法 `count` 观察到，如下面的交互所示： + +```scala +val c1 = Counter() +c1.count // 0 +c1.tick() +c1.tick() +c1.count // 2 +``` + +#### 访问修饰符 + +默认情况下，Scala 中的所有成员定义都是公开可见的。 +要隐藏实现细节，可以将成员（方法、字段、类型等）定义为 `private` 或 `protected`。 +通过这种方式，您可以控制访问或覆盖它们的方式。 +私有成员仅对类/trait本身及其伴生对象可见。 +受保护的成员对类的子类也是可见的。 + +## 高级示例：面向服务的设计 + +在下文中，我们展示了 Scala 的一些高级特性，并展示了如何使用它们来构建更大的软件组件。 +这些示例改编自 Martin Odersky 和 ​​Matthias Zenger 的论文 ["Scalable Component Abstractions"][scalable]。 +如果您不了解示例的所有细节，请不要担心；它的主要目的是演示如何使用多种类型特性来构造更大的组件。 + +我们的目标是定义一个具有_类型族_的软件组件，以后可以在组件的实现中对其进行细化。 +具体来说，以下代码将组件 `SubjectObserver` 定义为具有两个抽象类型成员的trait， `S` （用于主题）和 `O` （用于观察者）： + +```scala +trait SubjectObserver: + + type S <: Subject + type O <: Observer + + trait Subject { self: S => + private var observers: List[O] = List() + def subscribe(obs: O): Unit = + observers = obs :: observers + def publish() = + for obs <- observers do obs.notify(this) + } + + trait Observer { + def notify(sub: S): Unit + } +``` + +有几件事需要解释。 + +#### 抽象类型成员 + +声明 `type S <: Subject` 表示在 trait `SubjectObserver` 中我们可以引用一些我们称为 `S` 的_未知_（即抽象）类型。 +然而，该类型并不是完全未知的：我们至少知道它是trait `Subject` 的_某个子类型_。 +只要选择的类型是 `Subject` 的子类型，所有扩展自 `SubjectObserver` 的trait和类都可以自由地用于 `S`的类型。 +声明的 `<: Subject` 部分也称为 _`S` 的上界_。 + +#### 嵌套trait + +在 trait `SubjectObserver` _内_，我们定义了另外两个traits。 +让我们从 trait `Observer` 开始，它只定义了一个抽象方法 `notify`，它接受一个类型为 `S` 的参数。 +正如我们稍后将看到的，重要的是参数的类型为 `S` 而不是 `Subject` 类型。 + +第二个trait，`Subject`，定义了一个私有字段`observers`来存储所有订阅这个特定主题的观察者。 +订阅主题只是将对象存储到此列表中。 +同样，参数 `obs` 的类型是 `O`，而不是 `Observer`。 + +#### 自类型注解 + +最后，你可能想知道 trait `Subject` 上的 `self: S =>` 应该是什么意思。 +这称为 _自类型注解_。 +它要求 `Subject` 的子类型也是 `S` 的子类型。 +这对于能够使用 `this` 作为参数调用 `obs.notify` 是必要的，因为它需要 `S` 类型的值。 +如果 `S` 是一个_具体_类型，自类型注解可以被 `trait Subject extends S` 代替。 + +### 实现组件 + +我们现在可以实现上述组件并将抽象类型成员定义为具体类型： + +```scala +object SensorReader extends SubjectObserver: + type S = Sensor + type O = Display + + class Sensor(val label: String) extends Subject: + private var currentValue = 0.0 + def value = currentValue + def changeValue(v: Double) = + currentValue = v + publish() + + class Display extends Observer: + def notify(sub: Sensor) = + println(s"${sub.label} has value ${sub.value}") +``` + +具体来说，我们定义了一个扩展 `SubjectObserver` 的_单例_对象 `SensorReader`。 +在 `SensorReader` 的实现中，我们说 `S` 类型现在被定义为 `Sensor` 类型，`O` 类型被定义为等于 `Display` 类型。 +`Sensor` 和 `Display` 都被定义为 `SensorReader` 中的嵌套类，相应地实现了 `Subject` 和 `Observer` 特性。 + +除了作为面向服务设计的示例之外，这段代码还突出了面向对象编程的许多方面： + +- `Sensor` 类引入了它自己的私有状态（`currentValue`），并在方法`changeValue` 后面封装了对状态的修改。 +- `changeValue` 的实现使用扩展trait中定义的方法 `publish`。 +- 类 `Display` 扩展了 `Observer` 特性，并实现了缺失的方法 `notify`。 + +{% comment %} +NOTE: You might say “the abstract method `notify`” in that last sentence, but I like “missing.” +{% endcomment %} + +有一点很重要，需要指出，`notify` 的实现只能安全地访问 `sub` 的标签和值，因为我们最初将参数声明为 `S` 类型。 + +### 使用组件 + +最后，下面的代码说明了如何使用我们的 `SensorReader` 组件： + +```scala +import SensorReader.* + +// setting up a network +val s1 = Sensor("sensor1") +val s2 = Sensor("sensor2") +val d1 = Display() +val d2 = Display() +s1.subscribe(d1) +s1.subscribe(d2) +s2.subscribe(d1) + +// propagating updates through the network +s1.changeValue(2) +s2.changeValue(3) + +// prints: +// sensor1 has value 2.0 +// sensor1 has value 2.0 +// sensor2 has value 3.0 +``` + +借助我们掌握的所有面向对象的编程工具，在下一节中，我们将演示如何以函数式风格设计程序。 + +{% comment %} +NOTE: One thing I occasionally do is flip things like this around, so I first show how to use a component, and then show how to implement that component. I don’t have a rule of thumb about when to do this, but sometimes it’s motivational to see the use first, and then see how to create the code to make that work. +{% endcomment %} + +[scalable]: https://doi.org/10.1145/1094811.1094815 +[open]: {{ site.scala3ref }}/other-new-features/open-classes.html +[trait-params]: {{ site.scala3ref }}/other-new-features/trait-parameters.html From 799b1f28452ac6053a0bd71c3283badbc862b840 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 24 May 2022 18:24:46 +0800 Subject: [PATCH 1882/3075] add and modified as below --- .../scala3-book/domain-modeling-fp.md | 478 ++++++++++++++++++ .../scala3-book/domain-modeling-oop.md | 4 +- 2 files changed, 480 insertions(+), 2 deletions(-) create mode 100644 _zh-cn/overviews/scala3-book/domain-modeling-fp.md diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md new file mode 100644 index 0000000000..7c43c0a1cb --- /dev/null +++ b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md @@ -0,0 +1,478 @@ +--- +title: FP 建模 +type: section +description: This chapter provides an introduction to FP domain modeling with Scala 3. +num: 22 +previous-page: domain-modeling-oop +next-page: methods-intro +--- + + +本章介绍了在 Scala 3 中使用函数式编程 (FP) 进行域建模。 +当使用 FP 对我们周围的世界进行建模时，您通常会使用以下 Scala 构造： + +- 枚举 +- 样例类 +- Traits + +> 如果您不熟悉代数数据类型 (ADT) 及其泛型版本 (GADT)，您可能需要先阅读 [代数数据类型][adts] 部分，然后再阅读本节。 + +## 介绍 + +在 FP 中，*数据* 和*对该数据的操作* 是两个独立的东西；您不必像使用 OOP 那样将它们封装在一起。 + +这个概念类似于数值代数。 +当您考虑值大于或等于零的整数时，您有一*组*可能的值，如下所示： + +```` +0, 1, 2 ... Int.MaxValue +```` + +忽略整数的除法，对这些值可能的*操作*是： + +```` ++, -, * +```` + +FP设计以类似的方式实现： + +- 你描述你的值的集合（你的数据） +- 您描述了对这些值起作用的操作（您的函数） + +> 正如我们将看到的，这种风格的程序推理与面向对象的编程完全不同。 +> FP 中的数据只**是**： +> 将功能与数据分离，让您无需担心行为即可检查数据。 + +在本章中，我们将为比萨店中的“比萨”建模数据和操作。 +您将看到如何实现 Scala/FP 模型的“数据”部分，然后您将看到几种不同的方式来组织对该数据的操作。 + +## 数据建模 + +在 Scala 中，描述编程问题的数据模型很简单： + +- 如果您想使用不同的替代方案对数据进行建模，请使用 `enum` 结构 +- 如果您只想对事物进行分组（或需要更细粒度的控制），请使用 `case` 类 + +### 描述替代方案 + +简单地由不同的选择组成的数据，如面饼大小、面饼类型和馅料，使用 Scala 3 `enum` 结构进行简洁的建模： + +```scala +enum CrustSize: + case Small, Medium, Large + +enum CrustType: + case Thin, Thick, Regular + +enum Topping: + case Cheese, Pepperoni, BlackOlives, GreenOlives, Onions +``` + +> 描述不同选择的数据类型（如 `CrustSize`）有时也称为_聚合类型_。 + +### 描述复合数据 + +可以将比萨饼视为上述不同属性的_组件_容器。 +我们可以使用 `case` 类来描述 `Pizza` 由 `crustSize`、`crustType` 和可能的多个 `Topping` 组成： + +```scala +import CrustSize.* +import CrustType.* +import Topping.* + +case class Pizza( + crustSize: CrustSize, + crustType: CrustType, + toppings: Seq[Topping] +) +``` + +> 聚合多个组件的数据类型（如`Pizza`）有时也称为_产品类型_。 + +就是这样。 +这就是 FP 式比萨系统的数据模型。 +该解决方案非常简洁，因为它不需要将比萨饼上的操作与数据模型相结合。 +数据模型易于阅读，就像声明关系数据库的设计一样。 +创建数据模型的值并检查它们也很容易： + +```scala +val myFavPizza = Pizza(Small, Regular, Seq(Cheese, Pepperoni)) +println(myFavPizza.crustType) // prints Regular +``` + +#### 更多数据模型 + +我们可能会以同样的方式对整个比萨订购系统进行建模。 +下面是一些用于对此类系统建模的其他 `case` 类： + +```scala +case class Address( + street1: String, + street2: Option[String], + city: String, + state: String, + zipCode: String +) + +case class Customer( + name: String, + phone: String, + address: Address +) + +case class Order( + pizzas: Seq[Pizza], + customer: Customer +) +``` + +#### “瘦域对象” + +Debasish Ghosh 在他的《*功能和反应式域建模*》一书中指出，OOP 从业者将他们的类描述为封装数据和行为的“富域模型”，而 FP 数据模型可以被认为是“瘦域对象”。 +这是因为——正如本课所示——数据模型被定义为具有属性但没有行为的 `case` 类，从而产生了简短而简洁的数据结构。 + +## 操作建模 + +这就引出了一个有趣的问题：因为 FP 将数据与对该数据的操作分开，那么如何在 Scala 中实现这些操作？ + +答案实际上很简单：您只需编写对我们刚刚建模的数据值进行操作的函数（或方法）。 +例如，我们可以定义一个计算比萨价格的函数。 + +```scala +def pizzaPrice(p: Pizza): Double = p match + case Pizza(crustSize, crustType, toppings) => + val base = 6.00 + val crust = crustPrice(crustSize, crustType) + val tops = toppings.map(toppingPrice).sum + base + crust + tops +``` + +您注意到函数的实现如何简单地遵循数据的样式：由于 `Pizza` 是一个样例类，我们使用模式匹配来提取组件并调用辅助函数来计算各个部分单独的价格。 + +```scala +def toppingPrice(t: Topping): Double = t match + case Cheese | Onions => 0.5 + case Pepperoni | BlackOlives | GreenOlives => 0.75 +``` + +同样，由于 `Topping` 是一个枚举，我们使用模式匹配来区分不同的变量。 +奶酪和洋葱的价格为 50ct，其余的价格为 75ct。 + +```scala +def crustPrice(s: CrustSize, t: CrustType): Double = + (s, t) match + // if the crust size is small or medium, + // the type is not important + case (Small | Medium, _) => 0.25 + case (Large, Thin) => 0.50 + case (Large, Regular) => 0.75 + case (Large, Thick) => 1.00 +``` + +为了计算面饼的价格，我们同时对面饼的大小和类型进行模式匹配。 + +> 关于上面显示的所有函数的重要一点是它们是*纯函数*：它们不会改变任何数据或有其他副作用（如抛出异常或写入文件）。 +> 他们所做的只是简单地接收值并计算结果。 + +{% comment %} +I’ve added this comment per [this Github comment](https://github.com/scalacenter/docs.scala-lang/pull/3#discussion_r543372428). +To that point, I’ve added these definitions here from our Slack conversation, in case anyone wants to update the “pure function” definition. If not, please delete this comment. + +Sébastien: +---------- +A function `f` is pure if, given the same input `x`, it will always return the same output `f(x)`, and it never modifies any state outside of it (therefore potentially causing other functions to behave differently in the future). + +Jonathan: +--------- +We say a function is 'pure' if it does not depend on or modify the context it is called in. + +Wikipedia +--------- +The function always evaluates to the same result value given the same argument value(s). It cannot depend on any hidden state or value, and it cannot depend on any I/O. +Evaluation of the result does not cause any semantically observable side effect or output, such as mutation of mutable objects or output to I/O devices. + +Mine (Alvin, now modified, from fp-pure-functions.md): +------------------------------------------------------ +- A function `f` is pure if, given the same input `x`, it always returns the same output `f(x)` +- The function’s output depends *only* on its input variables and its internal algorithm +- It doesn’t modify its input parameters +- It doesn’t mutate any hidden state +- It doesn’t have any “back doors”: It doesn’t read data from the outside world (including the console, web services, databases, files, etc.), or write data to the outside world +{% endcomment %} + +## 如何组织功能 + +在实现上面的 `pizzaPrice` 函数时，我们没有说我们将在*哪里*定义它。 +在 Scala 3 中，在文件的顶层定义它是完全有效的。 +但是，该语言为我们提供了许多很棒的工具在不同命名空间和模块中组织我们的逻辑。 + +有几种不同的方式来实现和组织行为： + +- 在伴生对象中定义您的函数 +- 使用模块化编程风格 +- 使用“函数式对象”方法 +- 在扩展方法中定义功能 + +在本节的其余部分将展示这些不同的解决方案。 + +### 伴生对象 + +第一种方法是在伴生对象中定义行为——函数。 + +> 正如在领域建模 [工具部分][modeling-tools] 中所讨论的，_伴生对象_ 是一个与类同名的 `object` ，并在与类相同的文件中声明。 + +使用这种方法，除了枚举或样例类之外，您还定义了一个包含该行为的同名伴生对象。 + +```scala +case class Pizza( + crustSize: CrustSize, + crustType: CrustType, + toppings: Seq[Topping] +) + +// the companion object of case class Pizza +object Pizza: + // the implementation of `pizzaPrice` from above + def price(p: Pizza): Double = ... + +enum Topping: + case Cheese, Pepperoni, BlackOlives, GreenOlives, Onions + +// the companion object of enumeration Topping +object Topping: + // the implementation of `toppingPrice` above + def price(t: Topping): Double = t match + case Cheese | Onions => 0.5 + case Pepperoni | BlackOlives | GreenOlives => 0.75 +``` + +使用这种方法，您可以创建一个 `Pizza` 并计算其价格，如下所示： + +```scala +val pizza1 = Pizza(Small, Thin, Seq(Cheese, Onions)) +Pizza.price(pizza1) +``` + +以这种方式对功能进行分组有几个优点： + +- 它将功能与数据相关联，让程序员（和编译器）更容易找到它。 +- 它创建了一个命名空间，例如让我们使用 `price` 作为方法名称，而不必依赖重载。 +- `Topping.price` 的实现可以访问枚举值，例如 `Cheese` ，而无需导入它们。 + +但是，还应权衡： + +- 它将功能与您的数据模型紧密结合。 + 特别是，伴生对象需要在与您的 `case` 类相同的文件中定义。 +- 可能不清楚在哪里定义像 `crustPrice` 这样同样可以放置在 `CrustSize` 或 `CrustType` 的伴生对象中的函数。 + +## 模块 + +组织行为的第二种方法是使用“模块化”方法。 +这本书，*Programming in Scala*，将 *模块* 定义为“具有良好定义的接口和隐藏实现的‘较小的程序片段’”。 +让我们看看这意味着什么。 + +### 创建一个 `PizzaService` 接口 + +首先要考虑的是 `Pizza` 的“行为”。 +执行此操作时，您可以像这样草拟一个 `PizzaServiceInterface` trait： + +```scala +trait PizzaServiceInterface: + + def price(p: Pizza): Double + + def addTopping(p: Pizza, t: Topping): Pizza + def removeAllToppings(p: Pizza): Pizza + + def updateCrustSize(p: Pizza, cs: CrustSize): Pizza + def updateCrustType(p: Pizza, ct: CrustType): Pizza +``` + +如图所示，每个方法都将 `Pizza` 作为输入参数——连同其他参数——然后返回一个 `Pizza` 实例作为结果 + +当你写一个像这样的纯接口时，你可以把它想象成一个约定，“所有扩展这个特性的非抽象类*必须*提供这些服务的实现。” + +此时您还可以做的是想象您是此 API 的使用者。 +当你这样做时，它有助于草拟一些示例“消费者”代码，以确保 API 看起来像你想要的： + +```scala +val p = Pizza(Small, Thin, Seq(Cheese)) + +// how you want to use the methods in PizzaServiceInterface +val p1 = addTopping(p, Pepperoni) +val p2 = addTopping(p1, Onions) +val p3 = updateCrustType(p2, Thick) +val p4 = updateCrustSize(p3, Large) +``` + +如果该代码看起来没问题，您通常会开始草拟另一个 API ——例如用于订单的 API ——但由于我们现在只关注比萨饼，我们将停止考虑接口，然后创建这个接口的具体实现。 + +> 请注意，这通常是一个两步过程。 +> 在第一步中，您将 API 的合同草拟为*接口*。 +> 在第二步中，您创建该接口的具体*实现*。 +> 在某些情况下，您最终会创建基本接口的多个具体实现。 + +### 创建一个具体的实现 + +现在您知道了 `PizzaServiceInterface` 的样子，您可以通过为接口中定义的所有方法体来创建它的具体实现： + +```scala +object PizzaService extends PizzaServiceInterface: + + def price(p: Pizza): Double = + ... // implementation from above + + def addTopping(p: Pizza, t: Topping): Pizza = + p.copy(toppings = p.toppings :+ t) + + def removeAllToppings(p: Pizza): Pizza = + p.copy(toppings = Seq.empty) + + def updateCrustSize(p: Pizza, cs: CrustSize): Pizza = + p.copy(crustSize = cs) + + def updateCrustType(p: Pizza, ct: CrustType): Pizza = + p.copy(crustType = ct) + +end PizzaService +``` + +虽然创建接口和实现的两步过程并不总是必要的，但明确考虑 API 及其使用是一种好方法。 + +一切就绪后，您可以使用 `Pizza` 类和 `PizzaService`： + +```scala +import PizzaService.* + +val p = Pizza(Small, Thin, Seq(Cheese)) + +// use the PizzaService methods +val p1 = addTopping(p, Pepperoni) +val p2 = addTopping(p1, Onions) +val p3 = updateCrustType(p2, Thick) +val p4 = updateCrustSize(p3, Large) + +println(price(p4)) // prints 8.75 +``` + +### 函数对象 + +在 *Programming in Scala* 一书中，作者将术语“函数对象”定义为“不具有任何可变状态的对象”。 +`scala.collection.immutable` 中的类型也是如此。 +例如，`List` 上的方法不会改变内部状态，而是创建 `List` 的副本作为结果。 + +您可以将此方法视为“混合 FP/OOP 设计”，因为您： + +- 使用不可变的 `case` 类对数据进行建模。 +- 定义_同类型_数据中的行为（方法）。 +- 将行为实现为纯函数：它们不会改变任何内部状态；相反，他们返回一个副本。 + +> 这确实是一种混合方法：就像在 **OOP 设计**中一样，方法与数据一起封装在类中， +> 但作为典型的 **FP 设计**，方法被实现为纯函数，该函数不改变数据 + +#### 例子 + +使用这种方法，您可以在案例案例中直接实现比萨上的功能： +```scala +case class Pizza( + crustSize: CrustSize, + crustType: CrustType, + toppings: Seq[Topping] +): + + // the operations on the data model + def price: Double = + pizzaPrice(this) // implementation from above + + def addTopping(t: Topping): Pizza = + this.copy(toppings = this.toppings :+ t) + + def removeAllToppings: Pizza = + this.copy(toppings = Seq.empty) + + def updateCrustSize(cs: CrustSize): Pizza = + this.copy(crustSize = cs) + + def updateCrustType(ct: CrustType): Pizza = + this.copy(crustType = ct) +``` + +请注意，与之前的方法不同，因为这些是 `Pizza` 类上的方法，它们不会将 `Pizza` 引用作为输入参数。 +相反，他们用 `this` 作为当前比萨实例的引用。 + +现在你可以像这样使用这个新设计： + +```scala +Pizza(Small, Thin, Seq(Cheese)) + .addTopping(Pepperoni) + .updateCrustType(Thick) + .price +``` + +### 扩展方法 + +最后，我们展示了一种介于第一个（在伴生对象中定义函数）和最后一个（将函数定义为类型本身的方法）之间的方法。 + +扩展方法让我们创建一个类似于函数对象的 API，而不必将函数定义为类型本身的方法。 +这可以有多个优点： + +- 我们的数据模型再次_非常简洁_并且没有提及任何行为。 +- 我们可以_追溯性地_为类型配备额外的方法，而无需更改原始定义。 +- 除了伴生对象或类型上的直接方法外，扩展方法可以在_外部_另一个文件中定义。 + +让我们再次回顾一下我们的例子。 + +```scala +case class Pizza( + crustSize: CrustSize, + crustType: CrustType, + toppings: Seq[Topping] +) + +extension (p: Pizza) + def price: Double = + pizzaPrice(p) // implementation from above + + def addTopping(t: Topping): Pizza = + p.copy(toppings = p.toppings :+ t) + + def removeAllToppings: Pizza = + p.copy(toppings = Seq.empty) + + def updateCrustSize(cs: CrustSize): Pizza = + p.copy(crustSize = cs) + + def updateCrustType(ct: CrustType): Pizza = + p.copy(crustType = ct) +``` + +在上面的代码中，我们将比萨上的不同方法定义为_扩展方法_。 +对于 `extension (p: Pizza)`，我们想在 `Pizza` 的实例上让方法可用，并在下文中把扩展的实例称为 `p`。 + +这样我们就可以获得和之前一样的API + +```scala +Pizza(Small, Thin, Seq(Cheese)) + .addTopping(Pepperoni) + .updateCrustType(Thick) + .price +``` + +同时能够在任何其他模块中定义扩展。 +通常，如果您是数据模型的设计者，您将在伴生对象中定义您的扩展方法。 +这样，它们已经可供所有用户使用。 +否则，扩展方法需要显式导入才能使用。 + +## 这种方法的总结 + +在 Scala/FP 中定义数据模型往往很简单：只需使用枚举对数据的变体进行建模，并使用 `case` 类对复合数据进行建模。 +然后，为了对行为建模，定义对数据模型的值进行操作的函数。 +我们已经看到了组织函数的不同方法： + +- 你可以把你的方法放在伴生对象中 +- 您可以使用模块化编程风格，分离接口和实现 +- 您可以使用“函数对象”方法并将方法存储在定义的数据类型上 +- 您可以使用扩展方法把函数装配到数据模型上 + +[adts]: {% link _overviews/scala3-book/types-adts-gadts.md %} +[modeling-tools]: {% link _overviews/scala3-book/domain-modeling-tools.md %} diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md index b00e71b62c..1510152aef 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md @@ -98,8 +98,8 @@ Traits 非常适合模块化组件和描述接口（必需和提供）。 NOTE: I think “leaves” may technically be the correct word to use, but I prefer “leafs.” {% endcomment %} -|Traits | `T1`, `T2`, `T3` -|组合 traits | `S extends T1, T2`, `S extends T2, T3` +|Traits | `T1`, `T2`, `T3` +|组合 traits | `S extends T1, T2`, `S extends T2, T3` |类 | `C extends S, T3` |实例 | `C()` From 3dd2ec3f609fe17a171be24f9f5b60ad60d54584 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 24 May 2022 21:10:37 +0800 Subject: [PATCH 1883/3075] add all methods* --- _zh-cn/overviews/scala3-book/methods-intro.md | 16 + .../scala3-book/methods-main-methods.md | 135 ++++++ _zh-cn/overviews/scala3-book/methods-most.md | 386 ++++++++++++++++++ .../overviews/scala3-book/methods-summary.md | 22 + 4 files changed, 559 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/methods-intro.md create mode 100644 _zh-cn/overviews/scala3-book/methods-main-methods.md create mode 100644 _zh-cn/overviews/scala3-book/methods-most.md create mode 100644 _zh-cn/overviews/scala3-book/methods-summary.md diff --git a/_zh-cn/overviews/scala3-book/methods-intro.md b/_zh-cn/overviews/scala3-book/methods-intro.md new file mode 100644 index 0000000000..bba0ebfe1c --- /dev/null +++ b/_zh-cn/overviews/scala3-book/methods-intro.md @@ -0,0 +1,16 @@ +--- +title: 方法 +type: chapter +description: This section introduces methods in Scala 3. +num: 23 +previous-page: domain-modeling-fp +next-page: methods-most +--- + + +在 Scala 2 中，_方法_可以在类、traits、对象、样例类和样例对象中定义。 +但它变得更好了：在Scala 3中，可以在这些结构的_外部_定义方法；我们说它们是“顶级”定义，因为它们没有嵌套在另一个定义中。 +简而言之，现在可以在任何地方定义方法。 + +方法的许多功能将在下一节中演示。 +由于 `main` 方法需要更多的解释，因此后面有单独部分对其进行描述。 diff --git a/_zh-cn/overviews/scala3-book/methods-main-methods.md b/_zh-cn/overviews/scala3-book/methods-main-methods.md new file mode 100644 index 0000000000..0457b45cc7 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/methods-main-methods.md @@ -0,0 +1,135 @@ +--- +title: main 方法 +type: section +description: This page describes how 'main' methods and the '@main' annotation work in Scala 3. +num: 25 +previous-page: methods-most +next-page: methods-summary +--- + + + +Scala 3 提供了一种定义可以从命令行调用的程序的新方法：在方法中添加 `@main` 注释会将其变成可执行程序的入口点： + +```scala +@main def hello() = println("Hello, world") +``` + +只需将该行代码保存在一个名为 *Hello.scala* 的文件中——文件名不必与方法名匹配——并使用 `scalac` 编译它： + +```bash +$ scalac Hello.scala +``` + +然后用 `scala` 运行它： + +```bash +$ scala hello +Hello, world +``` + +`@main` 注释方法可以写在顶层（如图所示），也可以写在静态可访问的对象中。 +在任何一种情况下，程序的名称都是方法的名称，没有任何对象前缀。 + +### 命令行参数 + +使用这种方法，您的`@main` 方法可以处理命令行参数，并且这些参数可以有不同的类型。 +例如，给定这个 `@main` 方法，它接受一个 `Int`、一个 `String` 和一个可变参数 `String*` 参数： + +```scala +@main def happyBirthday(age: Int, name: String, others: String*) = + val suffix = (age % 100) match + case 11 | 12 | 13 => "th" + case _ => (age % 10) match + case 1 => "st" + case 2 => "nd" + case 3 => "rd" + case _ => "th" + + val sb = StringBuilder(s"Happy $age$suffix birthday, $name") + for other <- others do sb.append(" and ").append(other) + sb.toString +``` + +当你编译该代码时，它会创建一个名为 `happyBirthday` 的主程序，它的调用方式如下： + +``` +$ scala happyBirthday 23 Lisa Peter +Happy 23rd Birthday, Lisa and Peter! +``` + +如图所示，`@main` 方法可以有任意数量的参数。 +对于每个参数类型，必须有一个 *scala.util.FromString* 类型类的实例，它将参数 `String` 转换为所需的参数类型。 +同样如图所示，主方法的参数列表可以以重复参数结尾，例如 `String*`，它接受命令行中给出的所有剩余参数。 + +从 `@main` 方法实现的程序检查命令行上是否有足够的参数来填充所有参数，以及参数字符串是否可以转换为所需的类型。 +如果检查失败，程序将终止并显示错误消息： + +``` +$ scala happyBirthday 22 +Illegal command line after first argument: more arguments expected + +$ scala happyBirthday sixty Fred +Illegal command line: java.lang.NumberFormatException: For input string: "sixty" +``` + +## 细节 + +Scala 编译器从 `@main` 方法 `f` 生成程序，如下所示： + +- 它在有 `@main` 方法的包中创建一个名为 `f` 的类。 +- 该类有一个静态方法 `main`，具有 Java `main` 方法的通常签名：它以 `Array[String]` 作为参数并返回 `Unit`。 +- 生成的 `main` 方法调用方法 `f` 并使用 `scala.util.CommandLineParser` 对象中的方法转换参数。 + +例如，上面的 `happyBirthday` 方法会生成与以下类等效的附加代码： + +```scala +final class happyBirthday { + import scala.util.{CommandLineParser as CLP} + def main(args: Array[String]): Unit = + try + happyBirthday( + CLP.parseArgument[Int](args, 0), + CLP.parseArgument[String](args, 1), + CLP.parseRemainingArguments[String](args, 2)) + catch { + case error: CLP.ParseError => CLP.showError(error) + } +} +``` + +> **注意**：在这个生成的代码中，`` 修饰符表示 `main` 方法是作为 `happyBirthday` 类的静态方法生成的。 +> 此功能不适用于 Scala 中的用户程序。 +> 常规“静态”成员在 Scala 中使用对象生成。 + +## Scala 3 与 Scala 2 的比较 + +`@main` 方法是在 Scala 3 中生成可以从命令行调用的程序的推荐方法。 +它们取代了 Scala 2 中以前的方法，即创建一个扩展 `App` 类的 `object` ： + +```scala +// scala 2 +object happyBirthday extends App { + // needs by-hand parsing of the command line arguments ... +} +``` + +之前依赖于“神奇”的 `DelayedInit` trait 的 `App` 功能不再可用。 +`App` 目前仍以有限的形式存在，但它不支持命令行参数，将来会被弃用。 + +如果程序需要在 Scala 2 和 Scala 3 之间交叉构建，建议使用带有 `Array[String]` 参数的显式 `main` 方法： + +```scala +object happyBirthday: + def main(args: Array[String]) = println("Hello, world") +``` + +如果将该代码放在名为 *happyBirthday.scala* 的文件中，则可以使用 `scalac` 编译它并使用 `scala` 运行它，如前所示： + +```bash +$ scalac happyBirthday.scala + +$ scala happyBirthday +Hello, world +``` + diff --git a/_zh-cn/overviews/scala3-book/methods-most.md b/_zh-cn/overviews/scala3-book/methods-most.md new file mode 100644 index 0000000000..abc8cd96df --- /dev/null +++ b/_zh-cn/overviews/scala3-book/methods-most.md @@ -0,0 +1,386 @@ +--- +title: 方法特性 +type: section +description: This section introduces Scala 3 methods, including main methods, extension methods, and more. +num: 24 +previous-page: methods-intro +next-page: methods-main-methods +--- + + +本节介绍如何在 Scala 3 中定义和调用方法的各个方面。 + +## 定义方法 + +Scala 方法有很多特性，包括： + +- 通用（类型）参数 +- 默认参数值 +- 多个参数组 +- 上下文提供的参数 +- 按名称参数 +- ... + +本节演示了其中一些功能，但是当您定义一个不使用这些功能的“简单”方法时，语法如下所示： + +```scala +def methodName(param1: Type1, param2: Type2): ReturnType = + // the method body + // goes here +end methodName // this is optional +``` + +在该语法中： + +- 关键字 `def` 用于定义方法 +- Scala 标准是使用驼峰式命法来命名方法 +- 方法参数总是和它们的类型一起定义 +- 声明方法返回类型是可选的 +- 方法可以包含多行，也可以只包含一行 +- 在方法体之后提供 `end methodName` 部分也是可选的，仅推荐用于长方法 + +下面是一个名为 `add` 的单行方法的两个示例，它接受两个 `Int` 输入参数。 +第一个版本明确显示方法的 `Int` 返回类型，第二个版本没有： + +```scala +def add(a: Int, b: Int): Int = a + b +def add(a: Int, b: Int) = a + b +``` + +建议使用返回类型注释公开可见的方法。 +声明返回类型可以让您在几个月或几年后查看它或查看其他人的代码时更容易理解它。 + +## 调用方法 + +调用方法很简单： + +```scala +val x = add(1, 2) // 3 +``` + +Scala 集合类有几十个内置方法。 +这些示例显示了如何调用它们： + +```scala +val x = List(1, 2, 3) + +x.size // 3 +x.contains(1) // true +x.map(_ * 10) // List(10, 20, 30) +``` + +注意： + +- `size` 不带参数，并返回列表中元素的数量 +- `contains` 方法接受一个参数，即要搜索的值 +- `map` 接受一个参数，一个函数；在这种情况下，一个匿名函数被传递给它 + +## 多行方法 + +当方法超过一行时，从第二行开始方法体，向右缩进： + +```scala +def addThenDouble(a: Int, b: Int): Int = + // imagine that this body requires multiple lines + val sum = a + b + sum * 2 +``` + +在那个方法中： + +- `sum` 是一个不可变的局部变量；它不能在方法之外访问 +- 最后一行将 `sum` 的值加倍；这个值是从方法返回的 + +当您将该代码粘贴到 REPL 中时，您会看到它按预期工作： + +```scala +scala> addThenDouble(1, 1) +res0: Int = 4 +``` + +请注意，方法末尾不需要 `return` 语句。 +因为在 Scala 中几乎所有的东西都是一个_表达式_——意味着每一行代码都返回（或_执行_）一个值——不需要使用 `return`。 + +当您压缩该方法并将其写在一行上时，这一点变得更加清晰： + +```scala +def addThenDouble(a: Int, b: Int): Int = (a + b) * 2 +``` + +方法的主体可以使用语言的所有不同特性： + +- `if`/`else` 表达式 +- `match` 表达式 +- `while` 循环 +- `for` 循环和 `for` 表达式 +- 变量赋值 +- 调用其他方法 +- 其他方法的定义 + +作为一个真实世界的多行方法的例子，这个 `getStackTraceAsString` 方法将它的 `Throwable` 输入参数转换成一个格式良好的 `String`： + +```scala +def getStackTraceAsString(t: Throwable): String = + val sw = StringWriter() + t.printStackTrace(PrintWriter(sw)) + sw.toString +``` + +在那个方法中： + +- 第一行将 `StringWriter` 的新实例分配给值绑定器 `sw` +- 第二行将堆栈跟踪内容存储到 `StringWriter` +- 第三行产生堆栈跟踪的 `String` 表示 + +## 默认参数值 + +方法参数可以有默认值。 +在此示例中，为 `timeout` 和 `protocol` 参数提供了默认值： + +```scala +def makeConnection(timeout: Int = 5_000, protocol: String = "http") = + println(f"timeout = ${timeout}%d, protocol = ${protocol}%s") + // more code here ... +``` + +由于参数具有默认值，因此可以通过以下方式调用该方法： + +```scala +makeConnection() // timeout = 5000, protocol = http +makeConnection(2_000) // timeout = 2000, protocol = http +makeConnection(3_000, "https") // timeout = 3000, protocol = https +``` + +以下是关于这些示例的一些要点： + +- 在第一个示例中，没有提供任何参数，因此该方法使用默认参数值 `5_000` 和 `http` +- 在第二个示例中，为 `timeout` 值提供了 `2_000`，因此它与 `protocol` 的默认值一起使用 +- 在第三个示例中，为两个参数提供了值，因此它们都被使用 + +请注意，通过使用默认参数值，消费者似乎可以使用三种不同的重载方法。 + +## 命名参数 + +如果您愿意，也可以在调用方法时使用方法参数的名称。 +例如，`makeConnection` 也可以通过以下方式调用： + +```scala +makeConnection(timeout=10_000) +makeConnection(protocol="https") +makeConnection(timeout=10_000, protocol="https") +makeConnection(protocol="https", timeout=10_000) +``` + +在某些框架中，命名参数被大量使用。 +当多个方法参数具有相同类型时，它们也非常有用： + +```scala +engage(true, true, true, false) +``` + +如果没有 IDE 的帮助，代码可能难以阅读，但这段代码更加清晰和明显： + +```scala +engage( + speedIsSet = true, + directionIsSet = true, + picardSaidMakeItSo = true, + turnedOffParkingBrake = false +) +``` + +## 关于不带参数的方法的建议 + +当一个方法不带参数时，它的 _arity_ 级别为 _arity-0_。 +类似地，当一个方法采用一个参数时，它是一个_arity-1_方法。 +当您创建 arity-0 方法时： + +- 如果方法执行副作用，例如调用`println`，用空括号声明方法 +- 如果该方法不执行副作用——例如获取集合的大小，这类似于访问集合上的字段——请去掉括号 + +例如，这个方法会产生副作用，所以它用空括号声明： + +```scala +def speak() = println("hi") +``` + +这样做需要方法的调用者在调用方法时使用括号： + +```scala +speak // error: "method speak must be called with () argument" +speak() // prints "hi" +``` + +虽然这只是一个约定，但遵循它可以显着提高代码的可读性：它可以让您更容易一目了然地理解 arity-0 方法执行副作用。 + +{% comment %} +Some of that wording comes from this page: https://docs.scala-lang.org/style/method-invocation.html +{% endcomment %} + +## 使用 `if` 作为方法体 + +因为 `if`/`else` 表达式返回一个值，所以它们可以用作方法的主体。 +这是一个名为 `isTruthy` 的方法，它实现了 Perl 对 `true` 和 `false` 的定义： + +```scala +def isTruthy(a: Any) = + if a == 0 || a == "" || a == false then + false + else + true +``` + +这些示例显示了该方法的工作原理： + +```scala +isTruthy(0) // false +isTruthy("") // false +isTruthy("hi") // true +isTruthy(1.0) // true +``` + +## 使用 `match` 作为方法体 + +`match` 表达式也可以用作整个方法体，而且经常如此。 +这是 `isTruthy` 的另一个版本，用 `match` 表达式编写： + +```scala +def isTruthy(a: Matchable) = a match + case 0 | "" | false => false + case _ => true +``` + +此方法的工作方式与之前使用 `if`/`else` 表达式的方法一样。我们使用 `Matchable` 而不是 `Any` 作为参数的类型来接受任何支持模式匹配的值。 + +有关 `Matchable` trait 的更多详细信息，请参阅 [参考文档][reference_matchable]。 + +## 控制类中的可见性 + +在类、对象、trait和枚举中，Scala 方法默认是公共的，所以这里创建的 `Dog` 实例可以访问 `speak` 方法： + +```scala +class Dog: + def speak() = println("Woof") + +val d = new Dog +d.speak() // prints "Woof" +``` + +方法也可以标记为 `private`。 +这使得它们对当前类是私有的，因此它们不能在子类中被调用或重载： + +```scala +class Animal: + private def breathe() = println("I’m breathing") + +class Cat extends Animal: + // this method won’t compile + override def breathe() = println("Yo, I’m totally breathing") +``` + +如果你想让一个方法对当前类私有，并且允许子类调用它或覆盖它，将该方法标记为 `protected`，如本例中的 `speak` 方法所示： + +```scala +class Animal: + private def breathe() = println("I’m breathing") + def walk() = + breathe() + println("I’m walking") + protected def speak() = println("Hello?") + +class Cat extends Animal: + override def speak() = println("Meow") + +val cat = new Cat +cat.walk() +cat.speak() +cat.breathe() // won’t compile because it’s private +``` + +`protected` 设置意味着： + +- 方法（或字段）可以被同一类的其他实例访问 +- 对当前包中的其他代码是不可见的 +- 它适用于子类 + +## 对象可以包含方法 + +之前你看到trait和类可以有方法。 +Scala `object` 关键字用于创建单例类，对象也可以包含方法。 +这是对一组“实用程序”方法进行分组的好方法。 +例如，此对象包含一组处理字符串的方法： + +```scala +object StringUtils: + + /** + * Returns a string that is the same as the input string, but + * truncated to the specified length. + */ + def truncate(s: String, length: Int): String = s.take(length) + + /** + * Returns true if the string contains only letters and numbers. + */ + def lettersAndNumbersOnly_?(s: String): Boolean = + s.matches("[a-zA-Z0-9]+") + + /** + * Returns true if the given string contains any whitespace + * at all. Assumes that `s` is not null. + */ + def containsWhitespace(s: String): Boolean = + s.matches(".*\\s.*") + +end StringUtils +``` + +## 扩展方法 + +扩展方法在上下文抽象一章的[扩展方法部分][extension]中讨论。 +它们的主要目的是让您向封闭类添加新功能。 +如该部分所示，假设您有一个 `Circle` 类，但您无法更改其源代码。 +例如，它可以在第三方库中这样定义： + +```scala +case class Circle(x: Double, y: Double, radius: Double) +``` + +当你想给这个类添加方法时，你可以将它们定义为扩展方法，像这样： + +```scala +extension (c: Circle) + def circumference: Double = c.radius * math.Pi * 2 + def diameter: Double = c.radius * 2 + def area: Double = math.Pi * c.radius * c.radius +``` + +现在，当您有一个名为 `aCircle` 的 `Circle` 实例时，您可以像这样调用这些方法： + +```scala +aCircle.circumference +aCircle.diameter +aCircle.area +``` + +请参阅本书的[扩展方法部分][reference_extension_methods]，以及[“扩展方法”参考页面][reference]了解更多详细信息。 + +## 更多 + +还有更多关于方法的知识，包括如何： + +- 调用超类的方法 +- 定义和使用按名称参数 +- 编写一个带有函数参数的方法 +- 创建内嵌方法 +- 处理异常 +- 使用可变参数输入参数 +- 编写具有多个参数组的方法（部分应用的函数） +- 创建具有泛型类型参数的方法 + +有关这些功能的更多详细信息，请参阅 [参考文档][reference]。 + +[extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[reference_extension_methods]: {{ site.scala3ref }}/contextual/extension-methods.html +[reference]: {{ site.scala3ref }}/overview.html +[reference_matchable]: {{ site.scala3ref }}/other-new-features/matchable.html diff --git a/_zh-cn/overviews/scala3-book/methods-summary.md b/_zh-cn/overviews/scala3-book/methods-summary.md new file mode 100644 index 0000000000..6bea602874 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/methods-summary.md @@ -0,0 +1,22 @@ +--- +title: 总结 +type: section +description: This section summarizes the previous sections on Scala 3 methods. +num: 26 +previous-page: methods-main-methods +next-page: fun-intro +--- + + +还有更多关于方法的知识，包括如何： + +- 调用超类的方法 +- 定义和使用按名称参数 +- 编写一个带有函数参数的方法 +- 创建内嵌方法 +- 处理异常 +- 使用可变参数输入参数 +- 编写具有多个参数组的方法（部分应用的函数） +- 创建具有泛型类型参数的方法 + +[reference]: {{ site.scala3ref }}/overview.html From 5d368f8adad392625475e21e1ccb10eaad3d2b78 Mon Sep 17 00:00:00 2001 From: Artem Korsakov Date: Wed, 25 May 2022 08:15:39 +0300 Subject: [PATCH 1884/3075] Update quotes.md --- _overviews/scala3-macros/tutorial/quotes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/quotes.md b/_overviews/scala3-macros/tutorial/quotes.md index 109e509e59..54ea43d438 100644 --- a/_overviews/scala3-macros/tutorial/quotes.md +++ b/_overviews/scala3-macros/tutorial/quotes.md @@ -154,7 +154,7 @@ given ToExpr[Boolean] with { } given ToExpr[StringContext] with { - def apply(x: StringContext)(using Quotes) = + def apply(stringContext: StringContext)(using Quotes) = val parts = Varargs(stringContext.parts.map(Expr(_))) '{ StringContext($parts: _*) } } From 2f54c514e2dc4e3fb38aeaed259ea2a16ed8d656 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 25 May 2022 16:47:38 +0200 Subject: [PATCH 1885/3075] write tabs inline in markdown --- _config.yml | 2 - _fr/getting-started/index.md | 45 +++++++-- _includes/_ja/getting-started.md | 43 ++++++-- _includes/alt-details.html | 7 -- _includes/getting-started.md | 74 +++++++++----- _includes/tabsection.html | 32 ------ _install_tabs/1-macos.html | 21 ---- _install_tabs/2-linux.html | 11 --- _install_tabs/3-windows.html | 11 --- _install_tabs/4-other.html | 15 --- _install_tabs/fr-1-macos.html | 20 ---- _install_tabs/fr-2-linux.html | 10 -- _install_tabs/fr-3-windows.html | 10 -- _install_tabs/fr-4-other.html | 15 --- _install_tabs/ja-1-macos.html | 20 ---- _install_tabs/ja-2-linux.html | 10 -- _install_tabs/ja-3-windows.html | 10 -- _install_tabs/ja-4-other.html | 14 --- _plugins/alt-details-lib/alt-details.rb | 39 ++++++++ .../alt-details-lib/alt-details/version.rb | 5 + _plugins/alt-details-lib/template.erb | 11 +++ _plugins/alt_details.rb | 1 + _plugins/jekyll-tabs-lib/LICENCE | 22 +++++ _plugins/jekyll-tabs-lib/README.md | 8 ++ .../jekyll-tabs-lib/jekyll-tabs-4scala.rb | 97 +++++++++++++++++++ .../jekyll-tabs-lib/jekyll-tabs/version.rb | 5 + _plugins/jekyll-tabs-lib/template.erb | 29 ++++++ _plugins/jekyll_tabs_4scala.rb | 1 + _sass/base/helper.scss | 6 ++ resources/js/functions.js | 7 +- 30 files changed, 350 insertions(+), 251 deletions(-) delete mode 100644 _includes/alt-details.html delete mode 100644 _includes/tabsection.html delete mode 100644 _install_tabs/1-macos.html delete mode 100644 _install_tabs/2-linux.html delete mode 100644 _install_tabs/3-windows.html delete mode 100644 _install_tabs/4-other.html delete mode 100644 _install_tabs/fr-1-macos.html delete mode 100644 _install_tabs/fr-2-linux.html delete mode 100644 _install_tabs/fr-3-windows.html delete mode 100644 _install_tabs/fr-4-other.html delete mode 100644 _install_tabs/ja-1-macos.html delete mode 100644 _install_tabs/ja-2-linux.html delete mode 100644 _install_tabs/ja-3-windows.html delete mode 100644 _install_tabs/ja-4-other.html create mode 100644 _plugins/alt-details-lib/alt-details.rb create mode 100644 _plugins/alt-details-lib/alt-details/version.rb create mode 100644 _plugins/alt-details-lib/template.erb create mode 100644 _plugins/alt_details.rb create mode 100644 _plugins/jekyll-tabs-lib/LICENCE create mode 100644 _plugins/jekyll-tabs-lib/README.md create mode 100644 _plugins/jekyll-tabs-lib/jekyll-tabs-4scala.rb create mode 100644 _plugins/jekyll-tabs-lib/jekyll-tabs/version.rb create mode 100644 _plugins/jekyll-tabs-lib/template.erb create mode 100644 _plugins/jekyll_tabs_4scala.rb diff --git a/_config.yml b/_config.yml index 008a39325a..4f559b2295 100644 --- a/_config.yml +++ b/_config.yml @@ -22,8 +22,6 @@ scala-3-version: 3.1.2 collections: contribute_resources: output: false - install_tabs: - output: false style: output: true overviews: diff --git a/_fr/getting-started/index.md b/_fr/getting-started/index.md index 0228e5ea0b..4b73224c27 100644 --- a/_fr/getting-started/index.md +++ b/_fr/getting-started/index.md @@ -27,14 +27,43 @@ L'installateur Scala est un outil nommé [Coursier](https://get-coursier.io/docs Il s'assure que la JVM est les outils standards de Scala sont installés sur votre système. Installez-le sur votre système avec les instructions suivantes. -
      -
      -
      - {% include tabsection.html language='fr' id='install-cs-setup-tabs' collection=site.install_tabs %} -
      - -
      -
      + +{% tabs install-cs-setup-tabs class=platform-os-options %} + + +{% tab macOS for=install-cs-setup-tabs %} +{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} +{% altDetails cs-setup-macos-nobrew "Alternativement, si vous n'utilisez pas Homebrew:" %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +{% endaltDetails %} +{% endtab %} + + + +{% tab Linux for=install-cs-setup-tabs %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +{% endtab %} + + + +{% tab Windows for=install-cs-setup-tabs %} + Téléchargez et exécutez [l'intallateur Scala pour Windows]({{site.data.setup-scala.windows-link}}) basé sur Coursier. +{% endtab %} + + + +{% tab Other for=install-cs-setup-tabs defaultTab %} + + Suivez + [les instructions pour installer la commande `cs`](https://get-coursier.io/docs/cli-installation) + puis exécutez `./cs setup`. +{% endtab %} + + +{% endtabs %} + En plus de gérer les JVMs, `cs setup` installe aussi des utilitaires en ligne de commande : diff --git a/_includes/_ja/getting-started.md b/_includes/_ja/getting-started.md index 4faa2e2a35..f200bcb759 100644 --- a/_includes/_ja/getting-started.md +++ b/_includes/_ja/getting-started.md @@ -17,14 +17,41 @@ Scala をインストールすると、コンパイラやビルドツールな Scala のインストーラーは[Coursier](https://get-coursier.io/docs/cli-overview)というツールで、コマンドは`cs`です。このツールを使うと、JVM と標準 Scala ツールがシステムにインストールされます。 以下の手順でお使いのシステムにインストールしてください。 -
      -
      -
      - {% include tabsection.html language='ja' id='install-cs-setup-tabs' collection=site.install_tabs %} -
      - -
      -
      + +{% tabs install-cs-setup-tabs class=platform-os-options %} + + +{% tab macOS for=install-cs-setup-tabs %} +{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} +{% altDetails cs-setup-macos-nobrew "または、Homebrewを使用しない場合は" %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +{% endaltDetails %} +{% endtab %} + + + +{% tab Linux for=install-cs-setup-tabs %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +{% endtab %} + + + +{% tab Windows for=install-cs-setup-tabs %} + [the Scala installer for Windows]({{site.data.setup-scala.windows-link}})を、ダウンロードして実行してください。 +{% endtab %} + + + +{% tab Other for=install-cs-setup-tabs defaultTab %} + + [手順に従って `cs` ランチャーをインストール](https://get-coursier.io/docs/cli-installation)し、その次に以下を実行します。`./cs setup` +{% endtab %} + + +{% endtabs %} + `cs setup` は JVM の管理だけでなく、便利なコマンドラインツールもインストールします: diff --git a/_includes/alt-details.html b/_includes/alt-details.html deleted file mode 100644 index fc2d94c85e..0000000000 --- a/_includes/alt-details.html +++ /dev/null @@ -1,7 +0,0 @@ -
      - - -
      - {{include.detail}} -
      -
      diff --git a/_includes/getting-started.md b/_includes/getting-started.md index 4a900782ff..491859f405 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -20,30 +20,56 @@ The Scala installer is a tool named [Coursier](https://get-coursier.io/docs/cli- It ensures that a JVM and standard Scala tools are installed on your system. Install it on your system with the following instructions. -{% capture scalaDemo %}$ scala -version -Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL{% endcapture %} - -
      -
      -
      - {% include tabsection.html language='en' id='install-cs-setup-tabs' collection=site.install_tabs %} -
      - {% capture checkSetupDetail %} -
      -
      -

      Check your setup with the command scala -version, which should output:

      - {% include code-snippet.html nocopy=true language='bash' codeSnippet=scalaDemo %} -

      If that does not work, you may need to log out and log back in (or reboot) in order for the changes to take - effect. -

      -
      -
      - {% endcapture %} -
      - {% include alt-details.html id='testing-your-setup' title='Testing your setup' detail=checkSetupDetail %} -
      -
      -
      + +{% tabs install-cs-setup-tabs class=platform-os-options %} + + +{% tab macOS for=install-cs-setup-tabs %} +Run the following command in your terminal, following the on-screen instructions: +{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} +{% altDetails cs-setup-macos-nobrew "Alternatively, if you don't use Homebrew:" %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +{% endaltDetails %} +{% endtab %} + + + +{% tab Linux for=install-cs-setup-tabs %} + Run the following command in your terminal, following the on-screen instructions: + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +{% endtab %} + + + +{% tab Windows for=install-cs-setup-tabs %} + Download and execute [the Scala installer for Windows]({{site.data.setup-scala.windows-link}}) + based on Coursier, and follow the on-screen instructions. +{% endtab %} + + + +{% tab Other for=install-cs-setup-tabs defaultTab %} + + Follow the documentation from Coursier on + [how to install and run `cs setup`](https://get-coursier.io/docs/cli-installation). +{% endtab %} + + +{% endtabs %} + + + +{% altDetails testing-your-setup 'Testing your setup' %} +Check your setup with the command `scala -version`, which should output: +```bash +$ scala -version +Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL +``` +If that does not work, you may need to log out and log back in (or reboot) in order for the changes to take effect. +{% endaltDetails %} + Along with managing JVMs, `cs setup` also installs useful command-line tools: diff --git a/_includes/tabsection.html b/_includes/tabsection.html deleted file mode 100644 index f779ce2efb..0000000000 --- a/_includes/tabsection.html +++ /dev/null @@ -1,32 +0,0 @@ -
      - {% for tabRoot in include.collection %} - {% if tabRoot.language == include.language %} - - {% endif %} - {% endfor %} - -
      - {% for tabRoot in include.collection %} - {% if tabRoot.language == include.language %} -
      - {{tabRoot.content}} -
      - {% endif %} - {% endfor %} -
      -
      diff --git a/_install_tabs/1-macos.html b/_install_tabs/1-macos.html deleted file mode 100644 index f8caa80c19..0000000000 --- a/_install_tabs/1-macos.html +++ /dev/null @@ -1,21 +0,0 @@ ---- -tabId: osx -tabLabel: macOS -language: en ---- -
      -
      -

      Run the following command in your terminal, following the on-screen instructions:

      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} - {% capture homebrewDetail %} -
      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} -
      - {% endcapture %} - {% include alt-details.html - id='cs-setup-macos-nobrew' - title="Alternatively, if you don't use Homebrew:" - detail=homebrewDetail - %} -
      -
      diff --git a/_install_tabs/2-linux.html b/_install_tabs/2-linux.html deleted file mode 100644 index 5f29b25c2b..0000000000 --- a/_install_tabs/2-linux.html +++ /dev/null @@ -1,11 +0,0 @@ ---- -tabId: linux -tabLabel: Linux -language: en ---- -
      -
      -

      Run the following command in your terminal, following the on-screen instructions:

      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} -
      -
      diff --git a/_install_tabs/3-windows.html b/_install_tabs/3-windows.html deleted file mode 100644 index 01da9c604b..0000000000 --- a/_install_tabs/3-windows.html +++ /dev/null @@ -1,11 +0,0 @@ ---- -tabId: windows -tabLabel: Windows -language: en ---- -
      -
      -

      Download and execute the Scala - installer for Windows based on Coursier, and follow the on-screen instructions.

      -
      -
      diff --git a/_install_tabs/4-other.html b/_install_tabs/4-other.html deleted file mode 100644 index 8332bba359..0000000000 --- a/_install_tabs/4-other.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -tabId: other -tabLabel: Other -defaultTab: true -language: en ---- -
      -
      - -

      Follow the documentation from Coursier on how to install and run cs setup.

      -
      -
      diff --git a/_install_tabs/fr-1-macos.html b/_install_tabs/fr-1-macos.html deleted file mode 100644 index 99fc4aaa34..0000000000 --- a/_install_tabs/fr-1-macos.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -tabId: osx -tabLabel: macOS -language: fr ---- -
      -
      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} - {% capture homebrewDetail %} -
      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} -
      - {% endcapture %} - {% include alt-details.html - id='cs-setup-macos-nobrew' - title="Alternativement, si vous n'utilisez pas Homebrew:" - detail=homebrewDetail - %} -
      -
      diff --git a/_install_tabs/fr-2-linux.html b/_install_tabs/fr-2-linux.html deleted file mode 100644 index df2e1ccdba..0000000000 --- a/_install_tabs/fr-2-linux.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -tabId: linux -tabLabel: Linux -language: fr ---- -
      -
      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} -
      -
      diff --git a/_install_tabs/fr-3-windows.html b/_install_tabs/fr-3-windows.html deleted file mode 100644 index 7da64e60a0..0000000000 --- a/_install_tabs/fr-3-windows.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -tabId: windows -tabLabel: Windows -language: fr ---- -
      -
      -

      Téléchargez et exécutez l'intallateur Scala pour Windows basé sur Coursier

      -
      -
      diff --git a/_install_tabs/fr-4-other.html b/_install_tabs/fr-4-other.html deleted file mode 100644 index c54fd24c27..0000000000 --- a/_install_tabs/fr-4-other.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -tabId: other -tabLabel: Other -defaultTab: true -language: fr ---- -
      -
      - -

      Suivez les instructions pour installer la commande - cspuis exécutez ./cs setup.

      -
      -
      diff --git a/_install_tabs/ja-1-macos.html b/_install_tabs/ja-1-macos.html deleted file mode 100644 index 553508b039..0000000000 --- a/_install_tabs/ja-1-macos.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -tabId: osx -tabLabel: macOS -language: ja ---- -
      -
      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} - {% capture homebrewDetail %} -
      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} -
      - {% endcapture %} - {% include alt-details.html - id='cs-setup-macos-nobrew' - title="または、Homebrewを使用しない場合は" - detail=homebrewDetail - %} -
      -
      diff --git a/_install_tabs/ja-2-linux.html b/_install_tabs/ja-2-linux.html deleted file mode 100644 index 42b98e6a67..0000000000 --- a/_install_tabs/ja-2-linux.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -tabId: linux -tabLabel: Linux -language: ja ---- -
      -
      - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} -
      -
      diff --git a/_install_tabs/ja-3-windows.html b/_install_tabs/ja-3-windows.html deleted file mode 100644 index f70ffba026..0000000000 --- a/_install_tabs/ja-3-windows.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -tabId: windows -tabLabel: Windows -language: ja ---- -
      -
      -

      the Scala installer for Windowsを、ダウンロードして実行してください。

      -
      -
      diff --git a/_install_tabs/ja-4-other.html b/_install_tabs/ja-4-other.html deleted file mode 100644 index b923a3b164..0000000000 --- a/_install_tabs/ja-4-other.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -tabId: other -tabLabel: Other -defaultTab: true -language: ja ---- -
      -
      - -

      手順に従って cs ランチャーをインストールし、その次に以下を実行します。./cs setup

      -
      -
      diff --git a/_plugins/alt-details-lib/alt-details.rb b/_plugins/alt-details-lib/alt-details.rb new file mode 100644 index 0000000000..4ddbee64f4 --- /dev/null +++ b/_plugins/alt-details-lib/alt-details.rb @@ -0,0 +1,39 @@ +require 'erb' + +module Jekyll + module AltDetails + class AltDetailsBlock < Liquid::Block + SYNTAX = /^\s*(#{Liquid::QuotedFragment})\s+(#{Liquid::QuotedFragment})/o + Syntax = SYNTAX + + alias_method :render_block, :render + + def unquote(string) + string.gsub(/^['"]|['"]$/, '') + end + + def initialize(block_name, markup, tokens) + super + + if markup =~ SYNTAX + @name = unquote($1) + @title = unquote($2) + else + raise SyntaxError.new("Block #{block_name} requires an id and a title") + end + end + + def render(context) + site = context.registers[:site] + converter = site.find_converter_instance(::Jekyll::Converters::Markdown) + altDetailsContent = converter.convert(render_block(context)) + currentDirectory = File.dirname(__FILE__) + templateFile = File.read(currentDirectory + '/template.erb') + template = ERB.new(templateFile) + template.result(binding) + end + end + end +end + +Liquid::Template.register_tag('altDetails', Jekyll::AltDetails::AltDetailsBlock) diff --git a/_plugins/alt-details-lib/alt-details/version.rb b/_plugins/alt-details-lib/alt-details/version.rb new file mode 100644 index 0000000000..147e33df9c --- /dev/null +++ b/_plugins/alt-details-lib/alt-details/version.rb @@ -0,0 +1,5 @@ +module Jekyll + module AltDetails + VERSION = "1.1.1" + end +end diff --git a/_plugins/alt-details-lib/template.erb b/_plugins/alt-details-lib/template.erb new file mode 100644 index 0000000000..6aba6f127f --- /dev/null +++ b/_plugins/alt-details-lib/template.erb @@ -0,0 +1,11 @@ +
      +
      + + +
      +
      + <%= altDetailsContent %> +
      +
      +
      +
      diff --git a/_plugins/alt_details.rb b/_plugins/alt_details.rb new file mode 100644 index 0000000000..57d2420105 --- /dev/null +++ b/_plugins/alt_details.rb @@ -0,0 +1 @@ +require_relative "alt-details-lib/alt-details" diff --git a/_plugins/jekyll-tabs-lib/LICENCE b/_plugins/jekyll-tabs-lib/LICENCE new file mode 100644 index 0000000000..43ae840e30 --- /dev/null +++ b/_plugins/jekyll-tabs-lib/LICENCE @@ -0,0 +1,22 @@ +MIT License + +Copyright (c) 2022 Baptiste Bouchereau +Copyright (c) 2022 LAMP/EPFL + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/_plugins/jekyll-tabs-lib/README.md b/_plugins/jekyll-tabs-lib/README.md new file mode 100644 index 0000000000..4e84712723 --- /dev/null +++ b/_plugins/jekyll-tabs-lib/README.md @@ -0,0 +1,8 @@ +originally sourced from https://github.com/Ovski4/jekyll-tabs. + +changes: +- template.erb adapted to match the pre-existing tab html structure for docs.scala-lang.org +- `tabs` do not use secure random uuid as the id, the `tabs` name parameter is used instead. +- for the `tabs` block, add an optional second `class='foo bar'` parameter to allow custom classes for the tabs. +- for the `tab` block, reorder the parameters: the tab label comes first, followed by the name of the parent `tabs`. +- addition of a third `defaultTab` attribute for `tab`, which defaults to the final tab if not set. diff --git a/_plugins/jekyll-tabs-lib/jekyll-tabs-4scala.rb b/_plugins/jekyll-tabs-lib/jekyll-tabs-4scala.rb new file mode 100644 index 0000000000..c9a829f07f --- /dev/null +++ b/_plugins/jekyll-tabs-lib/jekyll-tabs-4scala.rb @@ -0,0 +1,97 @@ +require 'erb' + +module Jekyll + module Tabs + + def self.unquote(string) + string.gsub(/^['"]|['"]$/, '') + end + + def self.asAnchor(title) + title.gsub(/[^a-zA-Z0-9\-_]/, '-').gsub(/-{2,}/, '-').downcase + end + + TabDetails = Struct.new(:label, :anchor, :defaultTab, :content, keyword_init: true) + + class TabsBlock < Liquid::Block + SYNTAX = /^\s*(#{Liquid::QuotedFragment})(?=\s+class=(#{Liquid::QuotedFragment}))?/o + Syntax = SYNTAX + + def initialize(block_name, markup, tokens) + super + + if markup =~ SYNTAX + @name = Tabs::unquote($1) + @css_classes = "" + if $2 + # append $2 to @css_classes + @css_classes = "#{@css_classes} #{Tabs::unquote($2)}" + end + else + raise SyntaxError.new("Block #{block_name} requires 1 attribute") + end + end + + def render(context) + environment = context.environments.first + environment["tabs-#{@name}"] = [] # reset every time (so page translations can use the same name) + super + + foundDefault = false + + allTabs = environment["tabs-#{@name}"] + + allTabs.each do | tab | + if tab.defaultTab + foundDefault = true + end + end + + if !foundDefault and allTabs.length > 0 + # set last tab to default + allTabs[-1].defaultTab = true + end + + currentDirectory = File.dirname(__FILE__) + templateFile = File.read(currentDirectory + '/template.erb') + template = ERB.new(templateFile) + template.result(binding) + end + end + + class TabBlock < Liquid::Block + alias_method :render_block, :render + + SYNTAX = /^\s*(#{Liquid::QuotedFragment})\s+(?:for=(#{Liquid::QuotedFragment}))(?:\s+(defaultTab))?/o + Syntax = SYNTAX + + def initialize(block_name, markup, tokens) + super + + if markup =~ SYNTAX + @tab = Tabs::unquote($1) + @name = Tabs::unquote($2) + @anchor = Tabs::asAnchor(@tab) + if $3 + @defaultTab = true + end + else + raise SyntaxError.new("Block #{block_name} requires at least 2 attributes") + end + end + + def render(context) + site = context.registers[:site] + converter = site.find_converter_instance(::Jekyll::Converters::Markdown) + content = converter.convert(render_block(context)) + tabcontent = TabDetails.new(label: @tab, anchor: @anchor, defaultTab: @defaultTab, content: content) + environment = context.environments.first + environment["tabs-#{@name}"] ||= [] + environment["tabs-#{@name}"] << tabcontent + end + end + end +end + +Liquid::Template.register_tag('tab', Jekyll::Tabs::TabBlock) +Liquid::Template.register_tag('tabs', Jekyll::Tabs::TabsBlock) diff --git a/_plugins/jekyll-tabs-lib/jekyll-tabs/version.rb b/_plugins/jekyll-tabs-lib/jekyll-tabs/version.rb new file mode 100644 index 0000000000..498949a13d --- /dev/null +++ b/_plugins/jekyll-tabs-lib/jekyll-tabs/version.rb @@ -0,0 +1,5 @@ +module Jekyll + module Tabs + VERSION = "1.1.1" + end +end diff --git a/_plugins/jekyll-tabs-lib/template.erb b/_plugins/jekyll-tabs-lib/template.erb new file mode 100644 index 0000000000..0d2e2ec147 --- /dev/null +++ b/_plugins/jekyll-tabs-lib/template.erb @@ -0,0 +1,29 @@ +
      +
      + <% environment["tabs-#{@name}"].each do | tab | %> + > + <% end %> + +
      + <% environment["tabs-#{@name}"].each do | tab | %> +
      +
      + <%= tab.content %> +
      +
      + <% end %> +
      +
      +
      diff --git a/_plugins/jekyll_tabs_4scala.rb b/_plugins/jekyll_tabs_4scala.rb new file mode 100644 index 0000000000..7470d622a7 --- /dev/null +++ b/_plugins/jekyll_tabs_4scala.rb @@ -0,0 +1 @@ +require_relative "jekyll-tabs-lib/jekyll-tabs-4scala" diff --git a/_sass/base/helper.scss b/_sass/base/helper.scss index 7f13553247..d0f6281ea0 100755 --- a/_sass/base/helper.scss +++ b/_sass/base/helper.scss @@ -19,6 +19,12 @@ @include padding(20px 0); } +.wrap-tab { + @extend .wrap-narrow; + margin-top: 20px; + margin-bottom: 20px; +} + .wrap-narrow { @include outer-container; @include padding(0 10px); diff --git a/resources/js/functions.js b/resources/js/functions.js index d6524a72f4..7bd39db251 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -386,7 +386,7 @@ $(document).ready(function() { function getOS() { var osname = "linux"; if (navigator.appVersion.indexOf("Win") != -1) osname = "windows"; - if (navigator.appVersion.indexOf("Mac") != -1) osname = "osx"; + if (navigator.appVersion.indexOf("Mac") != -1) osname = "macos"; if (navigator.appVersion.indexOf("Linux") != -1) osname = "linux"; if (navigator.appVersion.indexOf("X11") != -1) osname = "unix"; return osname; @@ -407,12 +407,13 @@ $(document).ready(function () { $(document).ready(function () { // click the get-started tab corresponding to the users OS. - if ($(".main-download").length) { + var platformOSOptions = $(".tabsection.platform-os-options"); + if (platformOSOptions.length) { var os = getOS(); if (os === 'unix') { os = 'linux'; } - $("#install-cs-setup-tabs").find('input[data-target=' + os + ']').prop("checked", true); + platformOSOptions.find('input[data-target=' + os + ']').prop("checked", true); } }); From 8390a956fda475592c5342ee46d041012f28d8c8 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Thu, 26 May 2022 22:11:18 +0800 Subject: [PATCH 1886/3075] add functions --- .../scala3-book/fun-anonymous-functions.md | 133 ++++++++ .../scala3-book/fun-eta-expansion.md | 83 +++++ .../scala3-book/fun-function-variables.md | 112 +++++++ _zh-cn/overviews/scala3-book/fun-hofs.md | 288 ++++++++++++++++++ _zh-cn/overviews/scala3-book/fun-intro.md | 11 + _zh-cn/overviews/scala3-book/fun-summary.md | 34 +++ .../scala3-book/fun-write-map-function.md | 86 ++++++ .../fun-write-method-returns-function.md | 162 ++++++++++ 8 files changed, 909 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/fun-anonymous-functions.md create mode 100644 _zh-cn/overviews/scala3-book/fun-eta-expansion.md create mode 100644 _zh-cn/overviews/scala3-book/fun-function-variables.md create mode 100644 _zh-cn/overviews/scala3-book/fun-hofs.md create mode 100644 _zh-cn/overviews/scala3-book/fun-intro.md create mode 100644 _zh-cn/overviews/scala3-book/fun-summary.md create mode 100644 _zh-cn/overviews/scala3-book/fun-write-map-function.md create mode 100644 _zh-cn/overviews/scala3-book/fun-write-method-returns-function.md diff --git a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md new file mode 100644 index 0000000000..e4576252bf --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md @@ -0,0 +1,133 @@ +--- +title: 匿名函数 +type: section +description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. +num: 28 +previous-page: fun-intro +next-page: fun-function-variables +--- + + +匿名函数（也称为 *lambda*）是作为参数传递给高阶函数的代码块。 +维基百科将 [匿名函数](https://en.wikipedia.org/wiki/Anonymous_function) 定义为“未绑定到标识符的函数定义”。 + +例如，给定这样的列表： + +```scala +val ints = List(1, 2, 3) +``` + +您可以通过使用 `List` 类 `map` 方法和自定义匿名函数将 `ints` 中的每个元素加倍来创建一个新列表： + +```scala +val doubledInts = ints.map(_ * 2) // List(2, 4, 6) +``` + +如注释所示，`doubledInts` 包含列表`List(2, 4, 6)`。 +在该示例中，这部分代码是一个匿名函数： + +```scala +_ * 2 +``` + +这是“将给定元素乘以 2”的简写方式。 + +## 更长的形式 + +一旦你熟悉了 Scala，你就会一直使用这种形式来编写匿名函数，这些函数在函数的一个位置使用一个变量。 +但如果你愿意，你也可以用更长的形式来写它们，所以除了写这段代码： + +```scala +val doubledInts = ints.map(_ * 2) +``` + +您也可以使用以下形式编写它： + +```scala +val doubledInts = ints.map((i: Int) => i * 2) +val doubledInts = ints.map((i) => i * 2) +val doubledInts = ints.map(i => i * 2) +``` + +所有这些行的含义完全相同：将 `ints` 中的每个元素加倍以创建一个新列表 `doubledInts`。 +（稍后会解释每种形式的语法。） + +如果您熟悉 Java，了解这些 `map` 示例与以下 Java 代码等价可能会有所帮助： + +```java +List ints = List.of(1, 2, 3); +List doubledInts = ints.stream() + .map(i -> i * 2) + .collect(Collectors.toList()); +``` + +## 缩短匿名函数 + +当你想要明确时，你可以使用这个长格式编写一个匿名函数： + +```scala +val doubledInts = ints.map((i: Int) => i * 2) +``` + +该表达式中的匿名函数是这样的： + +```scala +(i: Int) => i * 2 +``` + +如果您不熟悉这种语法，将 `=>` 符号视为转换器会有所帮助，因为表达式使用 `=>` 符号右侧的算法（在这种情况下，一个将 `Int` 加倍的表达式）把符号左侧的参数列表（名为 `i` 的 `Int` 变量) *转换*为新结果。 + +### 缩短该表达式 + +这种长形式可以缩短，如以下步骤所示。 +首先，这是最长和最明确的形式： + +```scala +val doubledInts = ints.map((i: Int) => i * 2) +``` + +因为 Scala 编译器可以从 `ints` 中的数据推断 `i` 是一个 `Int`，所以可以删除 `Int` 声明： + +```scala +val doubledInts = ints.map((i) => i * 2) +``` + +因为只有一个参数，所以不需要在参数 `i` 周围的括号： + +```scala +val doubledInts = ints.map(i => i * 2) +``` + +因为当参数在函数中只出现一次时，Scala 允许您使用 `_` 符号而不是变量名，所以代码可以进一步简化： + +```scala +val doubledInts = ints.map(_ * 2) +``` + +### 变得更短 + +在其他示例中，您可以进一步简化匿名函数。 +例如，从最显式的形式开始，您可以使用带有 `List` 类 `foreach` 方法的匿名函数打印 `ints` 中的每个元素： + +```scala +ints.foreach((i: Int) => println(i)) +``` + +和以前一样，不需要 `Int` 声明，因为只有一个参数，所以不需要 `i` 周围的括号： + +```scala +ints.foreach(i => println(i)) +``` + +因为 `i` 在函数体中只使用一次，表达式可以进一步简化为 `_` 符号： + +```scala +ints.foreach(println(_)) +``` + +最后，如果一个匿名函数由一个接受单个参数的方法调用组成，您不需要显式命名和指定参数，因此您最终可以只写方法的名称（此处为 `println`）： + +```scala +ints.foreach(println) +``` + diff --git a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md new file mode 100644 index 0000000000..daff0b8d25 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md @@ -0,0 +1,83 @@ +--- +title: Eta 扩展 +type: section +description: This page discusses Eta Expansion, the Scala technology that automatically and transparently converts methods into functions. +num: 30 +previous-page: fun-function-variables +next-page: fun-hofs +--- + + +当你查看 Scala 集合类的 `map` 方法的 Scaladoc 时，你会看到它被定义为接受一个_函数_： + +```scala +def map[B](f: (A) => B): List[B] + ------------ +``` + +事实上，Scaladoc 明确指出，“`f` 是应用于每个元素的_函数_。” +但尽管如此，你可以通过某种方式将_方法_传递给 `map`，它仍然有效： + +```scala +def times10(i: Int) = i * 10 // a method +List(1, 2, 3).map(times10) // List(10,20,30) +``` + +你有没有想过这是如何工作的——如何将_方法_传递给需要_函数_的`map`？ + +这背后的技术被称为_Eta Expansion_。 +它将 _方法类型_的表达式转换为 _函数类型_的等效表达式，并且它无缝而安静地完成了。 + +## 方法和函数的区别 + +{% comment %} +NOTE: I got the following “method” definition from this page (https://dotty.epfl.ch/docs/reference/changed-features/eta-expansion-spec.html), but I’m not sure it’s 100% accurate now that 方法 can exist outside of classes/traits/objects. +I’ve made a few changes to that description that I hope are more accurate and up to date. +{% endcomment %} + +从历史上看，_方法_一直是类定义的一部分，尽管在 Scala 3 中您现在可以拥有类之外的方法，例如 [Toplevel definitions][toplevel] 和 [extension 方法][extension]。 + +与方法不同，_函数_本身就是完整的对象，使它们成为第一等的实体。 + +它们的语法也不同。 +此示例说明如何定义执行相同任务的方法和函数，确定给定整数是否为偶数： + +```scala +def isEvenMethod(i: Int) = i % 2 == 0 // a method +val isEvenFunction = (i: Int) => i % 2 == 0 // a function +``` + +该函数确实是一个对象，因此您可以像使用任何其他变量一样使用它，例如将其放入列表中： + +```scala +val functions = List(isEvenFunction) +``` + +相反，从技术上讲，方法不是对象，因此在 Scala 2 中，您不能将方法放入 `List` 中，至少不能直接放入，如下例所示： + +```scala +// this example shows the Scala 2 error message +val methods = List(isEvenMethod) + ^ +error: missing argument list for method isEvenMethod +Unapplied methods are only converted to functions when a function type is expected. +You can make this conversion explicit by writing `isEvenMethod _` or `isEvenMethod(_)` instead of `isEvenMethod`. +``` + +如该错误消息所示，在 Scala 2 中可以手动将方法转换为函数，但 Scala 3 的重要部分是改进了 Eta 扩展技术，所以现在当您尝试将方法当作变量用，它是可以工作的---您不必自己处理手动转换： + +```scala +val functions = List(isEvenFunction) // works +val methods = List(isEvenMethod) // works +``` + +就这本入门书而言，需要了解的重要事项是： + +- Eta Expansion 是 Scala 技术，让您可以像使用函数一样使用方法 +- 该技术在 Scala 3 中得到了改进，几乎完全无缝 + +有关其工作原理的更多详细信息，请参阅参考文档中的 [Eta 扩展页面][eta_expansion]。 + +[eta_expansion]: {{ site.scala3ref }}/changed-features/eta-expansion.html +[extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[toplevel]: {% link _overviews/scala3-book/taste-toplevel-definitions.md %} diff --git a/_zh-cn/overviews/scala3-book/fun-function-variables.md b/_zh-cn/overviews/scala3-book/fun-function-variables.md new file mode 100644 index 0000000000..d92c0610db --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fun-function-variables.md @@ -0,0 +1,112 @@ +--- +title: 函数变量 +type: section +description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. +num: 29 +previous-page: fun-anonymous-functions +next-page: fun-eta-expansion +--- + + +从上一节回到这个例子： + +```scala +val doubledInts = ints.map((i: Int) => i * 2) +``` + +我们注意到这部分表达式是一个匿名函数： + +```scala +(i: Int) => i * 2 +``` + +它被称为 *匿名* 的原因是它没有分配给变量，因此没有名称。 + +但是，可以将匿名函数（也称为*函数字面量*）分配给变量以创建*函数变量*： + +```scala +val double = (i: Int) => i * 2 +``` + +这将创建一个名为 `double` 的函数变量。 +在这个表达式中，原始函数字面量在 `=` 符号的右侧： + +```scala +val double = (i: Int) => i * 2 + ----------------- +``` + +新变量名在左侧： + +```scala +val double = (i: Int) => i * 2 + ------ +``` + +并且函数的参数列表在此处加下划线： + +```scala +val double = (i: Int) => i * 2 + -------- +``` + +就像方法的参数列表一样，这意味着 `double` 函数有一个参数，一个名为 `i` 的 `Int`。 +你可以在 REPL 中看到 `double` 的类型为 `Int => Int`，这意味着它接受一个 `Int` 参数并返回一个 `Int`： + +```scala +scala> val double = (i: Int) => i * 2 +val double: Int => Int = ... +``` + +### 调用函数 + +现在你可以像这样调用`double`函数： + +```scala +val x = double(2) // 4 +``` + +您还可以将 `double` 传递给 `map` 调用： + +```scala +List(1, 2, 3).map(double) // List(2, 4, 6) +``` + +此外，当您有 `Int => Int` 类型的其他函数时： + +```scala +val triple = (i: Int) => i * 3 +``` + +您可以将它们存储在 `List` 或 `Map` 中： + +```scala +val functionList = List(double, triple) + +val functionMap = Map( + "2x" -> double, + "3x" -> triple +) +``` + +如果将这些表达式粘贴到 REPL 中，您会看到它们具有以下类型： + +```` +// a List that contains functions of the type `Int => Int` +functionList: List[Int => Int] + +// a Map whose keys have the type `String`, and whose +// values have the type `Int => Int` +functionMap: Map[String, Int => Int] +```` + +## 关键点 + +这里的重要部分是： + +- 要创建函数变量，只需将变量名分配给函数字面量 +- 一旦你有了一个函数，你可以像对待任何其他变量一样对待它，即像一个`String`或`Int`变量 + +并且由于 Scala 3 中改进的 [Eta Expansion][eta_expansion] 函数式，您可以以相同的方式处理 *方法*。 + +[eta_expansion]: {% link _overviews/scala3-book/fun-eta-expansion.md %} diff --git a/_zh-cn/overviews/scala3-book/fun-hofs.md b/_zh-cn/overviews/scala3-book/fun-hofs.md new file mode 100644 index 0000000000..5fd9bb9c72 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fun-hofs.md @@ -0,0 +1,288 @@ +--- +title: 高阶函数 +type: section +description: This page demonstrates how to create and use higher-order functions in Scala. +num: 31 +previous-page: fun-eta-expansion +next-page: fun-write-map-function +--- + + +高阶函数 (HOF) 通常定义为这类函数，它 (a) 将其他函数作为输入参数或 (b) 返回函数作为结果。 +在 Scala 中，HOF 是可能的，因为函数是一等值。 + +需要注意的是，虽然我们在本文档中使用了常见的行业术语“高阶函数”，但在 Scala 中，该短语同时适用于 *方法* 和 *函数*。 +得益于 Scala 的 [Eta 扩展技术][eta_expansion]，它们通常可以在相同的地方使用。 + +## 从消费者到创造者 + +在本书到目前为止的示例中，您已经了解了如何成为方法的*消费者*，该方法将其他函数作为输入参数，例如使用诸如 `map` 和 `filter` 之类的 HOF。 +在接下来的几节中，您将了解如何成为 HOF 的*创造者*，包括： + +- 如何编写将函数作为输入参数的方法 +- 如何从方法中返回函数 + +在这个过程中你会看到： + +- 用于定义函数输入参数的语法 +- 引用函数后如何调用它 + +作为本次讨论的一个有益的副作用，一旦您对这种语法感到满意，您将使用它来定义函数参数、匿名函数和函数变量，并且也更容易阅读有关高阶函数的 Scaladoc。 + +## 理解过滤器的 Scaladoc + +要了解高阶函数的工作原理，深入研究一个示例会有所帮助。 +例如，您可以通过查看 Scaladoc 来了解 `filter` 接受的函数类型。 +这是 `List[A]` 类中的 `filter` 定义： + +```scala +def filter(p: (A) => Boolean): List[A] +``` + +这表明 `filter` 是一个接受名为 `p` 的函数参数的方法。 +按照惯例，`p` 代表 *谓词（predicate）*，它只是一个返回 `Boolean` 值的函数。 +所以 `filter` 将谓词 `p` 作为输入参数，并返回一个 `List[A]`，其中 `A` 是列表中保存的类型；如果你在 `List[Int]` 上调用 `filter`，`A` 是 `Int` 类型。 + +在这一点上，如果你不知道 `filter` 方法的用途，你只知道它的算法以某种方式使用谓词 `p` 创建并返回 `List[A]`。 + +具体看函数参数 `p`，这部分 `filter` 的描述： + +```scala +p: (A) => Boolean +``` + +意味着您传入的任何函数都必须将类型 `A` 作为输入参数并返回一个 `Boolean` 。 +因此，如果您的列表是 `List[Int]`，则可以将通用类型 `A` 替换为 `Int`，并像这样读取该签名： + +```scala +p: (Int) => Boolean +``` + +因为 `isEven` 具有这种类型——它将输入 `Int` 转换为结果 `Boolean`——它可以与 `filter` 一起使用。 + +{% comment %} +NOTE: (A low-priority issue): The next several sections can be condensed. +{% endcomment %} + +## 编写接受函数参数的方法 + +鉴于此背景，让我们开始编写将函数作为输入参数的方法。 + +**注意：**为了使下面的讨论更清楚，我们将您编写的代码称为*方法*，将您作为输入参数接受的代码称为*函数*。 + +### 第一个例子 + +要创建一个接受函数参数的方法，您所要做的就是： + +1. 在方法的参数列表中，定义要接受的函数的签名 +2. 在你的方法中使用那个函数 + +为了证明这一点，这里有一个方法，它接受一个名为 `f` 的输入参数，其中 `f` 是一个函数： + +```scala +def sayHello(f: () => Unit): Unit = f() +``` + +这部分代码---*类型签名*---声明 `f` 是一个函数，并定义了 `sayHello` 方法将接受的函数类型： + +```scala +f: () => Unit +``` + +这是它的工作原理： + +- `f` 是函数输入参数的名称。 + 这就像将 `String` 参数命名为 `s` 或 `Int` 参数命名为 `i`。 +- `f` 的类型签名指定此方法将接受的函数的 *类型*。 +- `f` 签名的 `()` 部分（在 `=>` 符号的左侧）表明 `f` 不接受输入参数。 +- 签名的 `Unit` 部分（在 `=>` 符号的右侧）表示 `f` 不应返回有意义的结果。 +- 回顾 `sayHello` 方法的主体（在 `=` 符号的右侧），那里的 `f()` 语句调用传入的函数。 + +现在我们已经定义了 `sayHello`，让我们创建一个函数来匹配 `f` 的签名，以便我们可以测试它。 +以下函数不接受任何输入参数并且不返回任何内容，因此它匹配 `f` 的类型签名： + +```scala +def helloJoe(): Unit = println("Hello, Joe") +``` + +因为类型签名匹配，你可以将 `helloJoe` 传递给 `sayHello`： + +```scala +sayHello(helloJoe) // prints "Hello, Joe" +``` + +如果您以前从未这样做过，那么恭喜您： +您刚刚定义了一个名为 `sayHello` 的方法，它接受一个函数作为输入参数，然后在其方法体中调用该函数。 + +### sayHello 可以带很多函数 + +重要的是要知道这种方法的美妙之处并不是说​​ `sayHello` 可以将 *一个* 函数作为输入参数；而在于它可以采用与 `f` 签名匹配的 *任意一个* 函数。 +例如，因为下一个函数没有输入参数并且不返回任何内容，所以它也适用于 `sayHello`： + +```scala +def bonjourJulien(): Unit = println("Bonjour, Julien") +``` + +它在 REPL 中： + +```` +scala> sayHello(bonjourJulien) +Bonjour, Julien +```` + +这是一个好的开始。 +现在唯一要做的就是查看更多示例，了解如何为函数参数定义不同的类型签名。 + +## 定义函数输入参数的通用语法 + +在这种方法中： + +```scala +def sayHello(f: () => Unit): Unit +``` + +我们注意到 `f` 的类型签名是： + +```scala +() => Unit +``` + +我们知道这意味着，“一个没有输入参数并且不返回任何有意义的东西的函数（由 `Unit` 给出）。” + +为了演示更多类型签名示例，这里有一个函数，它接受一个 `String` 参数并返回一个 `Int`： + +```scala +f: (String) => Int +``` + +什么样的函数接受一个字符串并返回一个整数？ +“字符串长度”和校验和等函数就是两个例子。 + +同样，此函数接受两个 `Int` 参数并返回一个 `Int`： + +```scala +f: (Int, Int) => Int +``` + +你能想象什么样的函数匹配那个签名？ + +答案是任何接受两个 `Int` 输入参数并返回 `Int` 的函数都与该签名匹配，因此所有这些“函数”（实际上是方法）都是匹配的： + +```scala +def add(a: Int, b: Int): Int = a + b +def subtract(a: Int, b: Int): Int = a - b +def multiply(a: Int, b: Int): Int = a * b +``` + +正如您可以从这些示例中推断出的，定义函数参数类型签名的一般语法是： + +```scala +variableName: (parameterTypes ...) => returnType +``` + +> 因为函数式编程就像创建和组合一系列代数方程，所以在设计函数和应用程序时通常会考虑*很多*类型。 +> 你可能会说你“在类型中思考”。 + +## 将函数参数与其他参数一起使用 + +为了使 HOF 真正有用，它们还需要一些数据来处理。 +对于像 `List` 这样的类，它的 `map` 方法已经有数据可以处理：`List` 中的数据。 +但是对于没有自己数据的独立 HOF，它也应该接受数据作为其他输入参数。 + +例如，这是一个名为 `executeNTimes` 的方法，它有两个输入参数：一个函数和一个 `Int`： + +```scala +def executeNTimes(f: () => Unit, n: Int): Unit = + for i <- 1 to n do f() +``` + +如代码所示，`executeNTimes` 执行了`f` 函数 `n` 次。 +因为像这样的简单 `for` 循环没有返回值，`executeNTimes` 返回 `Unit`。 + +要测试 `executeNTimes`，请定义一个匹配 `f` 签名的方法： + +```scala +// a method of type `() => Unit` +def helloWorld(): Unit = println("Hello, world") +``` + +然后将该方法与 `Int` 一起传递给`executeNTimes`： + +```` +scala> executeNTimes(helloWorld, 3) +Hello, world +Hello, world +Hello, world +```` + +优秀。 +`executeNTimes` 方法执行 `helloWorld` 函数 3 次。 + +### 需要多少参数 + +您的方法可以继续变得尽可能复杂。 +例如，此方法采用类型为 `(Int, Int) => Int` 的函数，以及两个输入参数： + +```scala +def executeAndPrint(f: (Int, Int) => Int, i: Int, j: Int): Unit = + println(f(i, j)) +``` + +因为这些 `sum` 和 `multiply` 方法与该类型签名匹配，所以它们可以与两个 `Int` 值一起传递到 `executeAndPrint` 中： + +```scala +def sum(x: Int, y: Int) = x + y +def multiply(x: Int, y: Int) = x * y + +executeAndPrint(sum, 3, 11) // prints 14 +executeAndPrint(multiply, 3, 9) // prints 27 +``` + +## 函数类型签名一致性 + +学习 Scala 的函数类型签名的一个好处是，用于定义函数输入参数的语法与用于编写函数字面量的语法相同。 + +例如，如果你要编写一个计算两个整数之和的函数，你可以这样写： + +```scala +val f: (Int, Int) => Int = (a, b) => a + b +``` + +该代码由类型签名组成： + +```` +val f: (Int, Int) => Int = (a, b) => a + b + ----------------- +```` + +输入参数： + +```` +val f: (Int, Int) => Int = (a, b) => a + b + ------ +```` + +和函数体： + +```` +val f: (Int, Int) => Int = (a, b) => a + b + ----- +```` + +这里展示了 Scala 的一致性，这里的函数类型： + +```` +val f: (Int, Int) => Int = (a, b) => a + b + ----------------- +```` + +与用于定义函数输入参数的类型签名相同： + +```` +def executeAndPrint(f: (Int, Int) => Int, ... + ----------------- +```` + +一旦你熟悉了这种语法，你就会用它来定义函数参数、匿名函数和函数变量，而且当你阅读 Scaladoc 中有关高阶函数的内容时，这些内容变得更容易了。 + +[eta_expansion]: {% link _overviews/scala3-book/fun-eta-expansion.md %} diff --git a/_zh-cn/overviews/scala3-book/fun-intro.md b/_zh-cn/overviews/scala3-book/fun-intro.md new file mode 100644 index 0000000000..2935e0b0e1 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fun-intro.md @@ -0,0 +1,11 @@ +--- +title: 函数 +type: chapter +description: This chapter looks at all topics related to functions in Scala 3. +num: 27 +previous-page: methods-summary +next-page: fun-anonymous-functions +--- + +上一章介绍了 Scala *方法*，本章深入研究 *函数*。 +涵盖的主题包括匿名函数、函数变量和高阶函数 (HOF)，包括如何创建自己的 HOF。 diff --git a/_zh-cn/overviews/scala3-book/fun-summary.md b/_zh-cn/overviews/scala3-book/fun-summary.md new file mode 100644 index 0000000000..017d9d1742 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fun-summary.md @@ -0,0 +1,34 @@ +--- +title: 总结 +type: section +description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. +num: 34 +previous-page: fun-write-method-returns-function +next-page: packaging-imports +--- + + +这是一个很长的章节，所以让我们回顾一下所涵盖的关键点。 + +我们通常这样定义高阶函数 (HOF)，它以其他函数作为输入参数或将函数作为其值。 +在 Scala 中这是可能的，因为函数是一等值。 + +浏览这些部分，首先您会看到： + +- 您可以将匿名函数编写为小代码片段 +- 您可以将它们传递给集合类上的几十个 HOF（方法），即像 `filter`、`map` 等方法。 +- 使用这些小代码片段和强大的 HOF，您只需少量代码即可创建大量的函数 + +在查看了匿名函数和 HOF 之后，您看到了： + +- 函数变量只是绑定到变量的匿名函数 + +在了解如何成为 HOF 的*消费者*之后，您将了解如何成为 HOF 的*创造者*。 +具体来说，您看到了： + +- 如何编写将函数作为输入参数的方法 +- 如何从方法中返回函数 + +本章的一个有益的副作用是您看到了许多关于如何为函数声明类型签名的示例。 +这样做的好处是，您可以使用相同的语法来定义函数参数、匿名函数和函数变量，而且对于 `map`、`filter` 等高阶函数，阅读 Scaladoc 也变得更容易。 + diff --git a/_zh-cn/overviews/scala3-book/fun-write-map-function.md b/_zh-cn/overviews/scala3-book/fun-write-map-function.md new file mode 100644 index 0000000000..5183a1dd0b --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fun-write-map-function.md @@ -0,0 +1,86 @@ +--- +title: 写你自己的 map 方法 +type: section +description: This page demonstrates how to create and use higher-order functions in Scala. +num: 32 +previous-page: fun-hofs +next-page: fun-write-method-returns-function +--- + + +现在您已经了解了如何编写自己的高阶函数，让我们快速浏览一个更真实的示例。 + +想象一下，`List` 类没有自己的 `map` 方法，而您想编写自己的方法。 +创建函数的第一步是准确地陈述问题。 +只关注 `List[Int]`，你说： + +> 我想编写一个 `map` 方法，该方法可用于将函数应用于给定的 `List[Int]` 中的每个元素， +> 并将转换后的元素作为新列表返回。 + +鉴于该声明，您开始编写方法签名。 +首先，您知道您想接受一个函数作为参数，并且该函数应该将 `Int` 转换为某种通用类型 `A`，因此您编写： + +```scala +def map(f: (Int) => A) +``` + +使用泛型类型的语法要求在参数列表之前声明该类型符号，因此您添加： + +```scala +def map[A](f: (Int) => A) +``` + +接下来，您知道 `map` 也应该接受 `List[Int]`： + +```scala +def map[A](f: (Int) => A, xs: List[Int]) +``` + +最后，您还知道 `map` 返回一个转换后的 `List`，其中包含泛型类型 `A` 的元素： + +```scala +def map[A](f: (Int) => A, xs: List[Int]): List[A] = ??? +``` + +这负责方法签名。 +现在您所要做的就是编写方法体。 +`map` 方法将它赋予的函数应用于它赋予的列表中的每个元素，以生成一个新的、转换的列表。 +一种方法是使用 `for` 表达式： + +```scala +for x <- xs yield f(x) +``` + +`for` 表达式通常使代码出奇地简单，对于我们的目的，它最终成为整个方法体。 + +把它和方法签名放在一起，你现在有了一个独立的 `map` 方法，它与 `List[Int]` 一起工作： + +```scala +def map[A](f: (Int) => A, xs: List[Int]): List[A] = + for x <- xs yield f(x) +``` + +### 使其通型化 + +作为奖励，请注意 `for` 表达式不做任何取决于 `List` 中的类型为 `Int` 的事情。 +因此，您可以将类型签名中的 `Int` 替换为泛型类型参数 `B`： + +```scala +def map[A, B](f: (B) => A, xs: List[B]): List[A] = + for x <- xs yield f(x) +``` + +现在你有了一个适用于任何 `List` 的 `map` 方法。 + +这些示例表明 `map` 可以按需要工作： + +```scala +def double(i : Int) = i * 2 +map(double, List(1, 2, 3)) // List(2, 4, 6) + +def strlen(s: String) = s.length +map(strlen, List("a", "bb", "ccc")) // List(1, 2, 3) +``` + +现在您已经了解了如何编写接受函数作为输入参数的方法，让我们看看返回函数的方法。 + diff --git a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md new file mode 100644 index 0000000000..fc7dbf7a4f --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md @@ -0,0 +1,162 @@ +--- +title: 创建可以返回函数的方法 +type: section +description: This page demonstrates how to create and use higher-order functions in Scala. +num: 33 +previous-page: fun-write-map-function +next-page: fun-summary +--- + + +由于 Scala 的一致性，编写一个返回函数的方法与您在前几节中看到的所有内容相似。 +例如，假设您想编写一个返回函数的 `greet` 方法。 +我们再次从问题陈述开始： + +> 我想创建一个返回函数的 `greet` 方法。 +> 该函数将接受一个字符串参数并使用 `println` 打印它。 +> 为了简化第一个示例，`greet` 不会接受任何输入参数；它只会构建一个函数并返回它。 + +鉴于该声明，您可以开始构建 `greet`。 +你知道这将是一种方法： + +```scala +def greet() +``` + +您还知道此方法将返回一个函数，该函数 (a) 采用 `String` 参数，并且 (b) 使用 `println` 打印该字符串。 +因此，该函数的类型为 `String => Unit`： + +```scala +def greet(): String => Unit = ??? + ---------------- +``` + +现在你只需要一个方法体。 +您知道该方法需要返回一个函数，并且该函数接受一个“字符串”并打印它。 +此匿名函数与该描述匹配： + +```scala +(name: String) => println(s"Hello, $name") +``` + +现在您只需从方法中返回该函数： + +```scala +// a method that returns a function +def greet(): String => Unit = + (name: String) => println(s"Hello, $name") +``` + +因为这个方法返回一个函数，所以你可以通过调用`greet()`来得到这个函数。 +这是在 REPL 中做的一个很好的步骤，因为它验证了新函数的类型： + +```` +scala> val greetFunction = greet() +val greetFunction: String => Unit = Lambda.... + ----------------------------------------- +```` + +现在你可以调用`greetFunction`了： + +```scala +greetFunction("Joe") // prints "Hello, Joe" +``` + +恭喜，您刚刚创建了一个返回函数的方法，然后执行了该函数。 + +## 改进方法 + +如果您可以传递问候语，我们的方法会更有用，所以让我们这样做。 +您所要做的就是将问候语作为参数传递给 `greet` 方法，并在 `println` 中的字符串中使用它： + +```scala +def greet(theGreeting: String): String => Unit = + (name: String) => println(s"$theGreeting, $name") +``` + +现在，当您调用您的方法时，该过程更加灵活，因为您可以更改问候语。 +当您从此方法创建函数时，它是这样的： + +```` +scala> val sayHello = greet("Hello") +val sayHello: String => Unit = Lambda..... + ---------------------- +```` + +REPL 类型签名输出显示 `sayHello` 是一个接受 `String` 输入参数并返回 `Unit`（无）的函数。 +所以现在当你给 `sayHello` 一个 `String` 时，它会打印问候语： + +```scala +sayHello("Joe") // prints "Hello, Joe" +``` + +您还可以根据需要更改问候语以创建新函数： + +```scala +val sayCiao = greet("Ciao") +val sayHola = greet("Hola") + +sayCiao("Isabella") // prints "Ciao, Isabella" +sayHola("Carlos") // prints "Hola, Carlos" +``` + +## 一个更真实的例子 + +当您的方法返回许多可能的函数之一时，这种技术会更加有用，例如返回自定义构建函数的工厂。 + +例如，假设您想编写一个方法，该方法返回用不同语言问候人们的函数。 +我们将其限制为使用英语或法语问候的函数，具体取决于传递给方法的参数。 + +您知道的第一件事是，您想要创建一个方法，该方法 (a) 将“所需语言”作为输入，并且 (b) 返回一个函数作为其结果。 +此外，由于该函数会打印给定的字符串，因此您知道它的类型为 `String => Unit`。 +使用该信息编写方法签名： + +```scala +def createGreetingFunction(desiredLanguage: String): String => Unit = ??? +``` + +接下来，因为您知道可能返回的函数接受一个字符串并打印它，所以您可以为英语和法语编写两个匿名函数： + +```scala +(name: String) => println(s"你好，$name") +(name: String) => println(s"Bonjour, $name") +``` + +在方法内部，如果你给这些匿名函数起一些名字，它可能会更易读，所以让我们将它们分配给两个变量： + +```scala +val englishGreeting = (name: String) => println(s"Hello, $name") +val frenchGreeting = (name: String) => println(s"Bonjour, $name") +``` + +现在您需要做的就是 (a) 如果 `desiredLanguage` 是英语，则返回 `englishGreeting`，并且 (b) 如果 `desiredLanguage` 是法语，则返回 `frenchGreeting`。 +一种方法是使用 `match` 表达式： + +```scala +def createGreetingFunction(desiredLanguage: String): String => Unit = + val englishGreeting = (name: String) => println(s"Hello, $name") + val frenchGreeting = (name: String) => println(s"Bonjour, $name") + desiredLanguage match + case "english" => englishGreeting + case "french" => frenchGreeting +``` + +这是最后的方法。 +请注意，从方法返回函数值与返回字符串或整数没有什么不同呃值。 + +这就是 `createGreetingFunction` 构建法语问候函数的方式： + +```scala +val greetInFrench = createGreetingFunction("french") +greetInFrench("Jonathan") // prints "Bonjour, Jonathan" +``` + +这就是它构建英语问候功能的方式： + +```scala +val greetInEnglish = createGreetingFunction("english") +greetInEnglish("Joe") // prints "Hello, Joe" +``` + +如果你对这段代码感到满意——恭喜——你现在知道如何编写返回函数的方法了。 + From fdec7e1120d43ebeb878a1e716a4a74b061ad915 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Fri, 27 May 2022 10:23:16 +0200 Subject: [PATCH 1887/3075] scroll tabs on smaller screens --- _sass/components/tab.scss | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/_sass/components/tab.scss b/_sass/components/tab.scss index 00309cd483..4d21d60c5e 100755 --- a/_sass/components/tab.scss +++ b/_sass/components/tab.scss @@ -9,6 +9,8 @@ @include display(flex); @include align-items(center); @include justify-content(flex-start); + overflow-x: auto; // scrollbar when width is too small. + overflow-y: hidden; .item-tab { @@ -57,6 +59,7 @@ } } +/* Active Tabs for standard screen size */ .nav-tab>.item-tab>a.active, // used in the blog .tabsection>input:nth-child(1):checked~.nav-tab .item-tab:nth-child(1) label, .tabsection>input:nth-child(2):checked~.nav-tab .item-tab:nth-child(2) label, @@ -73,6 +76,22 @@ pointer-events: none; } +/* Active Tabs for small screen size */ +@include bp(small) { + .nav-tab>.item-tab>a.active, + .tabsection>input:nth-child(1):checked~.nav-tab .item-tab:nth-child(1) label, + .tabsection>input:nth-child(2):checked~.nav-tab .item-tab:nth-child(2) label, + .tabsection>input:nth-child(3):checked~.nav-tab .item-tab:nth-child(3) label, + .tabsection>input:nth-child(4):checked~.nav-tab .item-tab:nth-child(4) label, + .tabsection>input:nth-child(5):checked~.nav-tab .item-tab:nth-child(5) label, + .tabsection>input:nth-child(6):checked~.nav-tab .item-tab:nth-child(6) label, + .tabsection>input:nth-child(7):checked~.nav-tab .item-tab:nth-child(7) label, + .tabsection>input:nth-child(8):checked~.nav-tab .item-tab:nth-child(8) label, + .tabsection>input:nth-child(9):checked~.nav-tab .item-tab:nth-child(9) label { + padding: 0 10px 8px; // match narrower padding for inactive tabs + } +} + .tabsection { border-bottom: $base-border-gray; border-left: $base-border-gray; From b48eb7c2be35437bd17ef1021574f366f27d69d2 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sat, 28 May 2022 13:13:15 +0800 Subject: [PATCH 1888/3075] add _zh-cn/overviews/scala3-book/packaging-imports.md --- .../scala3-book/packaging-imports.md | 378 ++++++++++++++++++ 1 file changed, 378 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/packaging-imports.md diff --git a/_zh-cn/overviews/scala3-book/packaging-imports.md b/_zh-cn/overviews/scala3-book/packaging-imports.md new file mode 100644 index 0000000000..a4adc04ba8 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/packaging-imports.md @@ -0,0 +1,378 @@ +--- +title: 打包和导入 +type: chapter +description: A discussion of using packages and imports to organize your code, build related modules of code, control scope, and help prevent namespace collisions. +num: 35 +previous-page: fun-summary +next-page: collections-intro +--- + + +Scala 使用 *包* 创建命名空间，让您可以模块化程序并帮助防止命名空间冲突。 +Scala 支持 Java 使用的包命名样式，也支持 C++ 和 C# 等语言使用的“花括号”命名空间表示法。 + +Scala 导入成员的方法也类似于 Java，并且更灵活。 +使用 Scala，您可以： + +- 导入包、类、对象、traits 和方法 +- 将导入语句放在任何地方 +- 导入成员时隐藏和重命名成员 + +这些特性在以下示例中进行了演示。 + +## 创建一个包 + +通过在 Scala 文件的顶部声明一个或多个包名称来创建包。 +例如，当您的域名是 _acme.com_ 并且您正在使用名为 _myapp_ 的应用程序中的 _model_ 包中工作时，您的包声明如下所示： + +```scala +package com.acme.myapp.model + +class Person ... +``` + +按照约定，包名应全部小写，正式命名约定为 *\.\.\.\*。 + +虽然不是必需的，但包名称通常遵循目录结构名称，因此如果您遵循此约定，则此项目中的 `Person` 类将在 *MyApp/src/main/scala/com/acme/myapp/model/Person.scala* 文件中找到。 + +### 在同一个文件中使用多个包 + +上面显示的语法适用于整个源文件：文件中的所有定义 +`Person.scala` 属于 `com.acme.myapp.model` 包，根据包子句 +在文件的开头。 + +或者，可以编写仅适用于定义的包子句 +他们包含： + +```scala +package users: + + package administrators: // the full name of this package is users.administrators + class AdminUser // the full name of this class is users.administrators.AdminUser + + package normalusers: // the full name of this package is users.normalusers + class NormalUser // the full name of this class is users.normalusers.NormalUser +``` + +请注意，包名称后跟一个冒号，并且其中的定义 +一个包是缩进的。 + +这种方法的优点是它允许包嵌套，并提供更明显的范围和封装控制，尤其是在同一个文件中。 + +## 导入语句，第 1 部分 + +导入语句用于访问其他包中的实体。 +导入语句分为两大类： + +- 导入类、trait、对象、函数和方法 +- 导入 `given` 子句 + +如果您习惯于 Java 之类的语言，则第一类 import 语句与 Java 使用的类似，只是语法略有不同，因此具有更大的灵活性。 +这些示例展示了其中的一些灵活性： + +```` +import users.* // import everything from the `users` package +import users.User // import only the `User` class +import users.{User, UserPreferences} // import only two selected members +import users.{UserPreferences as UPrefs} // rename a member as you import it +```` + +这些示例旨在让您了解第一类 `import` 语句的工作原理。 +在接下来的小节中对它们进行了更多解释。 + +导入语句还用于将 `given` 实例导入本范围。 +这些将在本章末尾讨论。 + +继续之前的注意事项： + +> 访问同一包的成员不需要导入子句。 + +### 导入一个或多个成员 + +在 Scala 中，您可以从包中导入一个成员，如下所示： + +```scala +import scala.concurrent.Future +``` + +和这样的多个成员： + +```scala +import scala.concurrent.Future +import scala.concurrent.Promise +import scala.concurrent.blocking +``` + +导入多个成员时，您可以像这样更简洁地导入它们： + +```scala +import scala.concurrent.{Future, Promise, blocking} +``` + +当您想从 *scala.concurrent* 包中导入所有内容时，请使用以下语法： + +```scala +import scala.concurrent.* +``` + +### 在导入时重命名成员 + +有时，在导入实体时重命名实体会有所帮助，以避免名称冲突。 +例如，如果您想同时使用 Scala `List` 类和 *java.util.List* 类，可以在导入时重命名 *java.util.List* 类： + +```scala +import java.util.{List as JavaList} +``` + +现在您使用名称 `JavaList` 来引用该类，并使用 `List` 来引用 Scala 列表类。 + +您还可以使用以下语法一次重命名多个成员： + +```scala +import java.util.{Date as JDate, HashMap as JHashMap, *} +``` + +那行代码说，“重命名 `Date` 和 `HashMap` 类，如图所示，并导入 _java.util_ 包中的所有其他内容，而不重命名任何其他成员。” + +### 在导入时隐藏成员 + +您还可以在导入过程中*隐藏*成员。 +这个 `import` 语句隐藏了 *java.util.Random* 类，同时导入 *java.util 中的所有其他内容* 包裹： + +```scala +import java.util.{Random as _, *} +``` + +如果您尝试访问 `Random` 类，它将无法正常工作，但您可以访问该包中的所有其他成员： + +```scala +val r = new Random // won’t compile +new ArrayList // works +``` + +#### 隐藏多个成员 + +要在导入过程中隐藏多个成员，请在使用最终通配符导入之前列出它们： + +```scala +scala> import java.util.{List as _, Map as _, Set as _, *} +``` + +这些类再次被隐藏，但您可以使用 *java.util* 中的所有其他类： + +```scala +scala> new ArrayList[String] +val res0: java.util.ArrayList[String] = [] +``` + +因为这些 Java 类是隐藏的，所以您也可以使用 Scala 的 `List`、`Set` 和 `Map` 类而不会发生命名冲突： + +```scala +scala> val a = List(1, 2, 3) +val a: List[Int] = List(1, 2, 3) + +scala> val b = Set(1, 2, 3) +val b: Set[Int] = Set(1, 2, 3) + +scala> val c = Map(1 -> 1, 2 -> 2) +val c: Map[Int, Int] = Map(1 -> 1, 2 -> 2) +``` + +### 在任何地方使用导入 + +在 Scala 中，`import` 语句可以在任何地方。 +它们可以在源代码文件的顶部使用： + +```scala +package foo + +import scala.util.Random + +class ClassA: + def printRandom: + val r = new Random // use the imported class + // more code here... +``` + +如果您愿意，您还可以使用更接近需要它们的点的 `import` 语句： + +```scala +package foo + +class ClassA: + import scala.util.Random // inside ClassA + def printRandom { + val r = new Random + // more code here... + +class ClassB: + // the Random class is not visible here + val r = new Random // this code will not compile +``` + +### “静态”导入 + +当您想以类似于 Java “静态导入”方法的方式导入成员时——因此您可以直接引用成员名称，而不必在它们前面加上类名——使用以下方法。 + +使用此语法导入 Java `Math` 类的所有静态成员： + +```scala +import java.lang.Math.* +``` + +现在您可以访问静态的 `Math` 类方法，例如 `sin` 和 `cos`，而不必在它们前面加上类名： + +```scala +import java.lang.Math.* + +val a = sin(0) // 0.0 +val b = cos(PI) // -1.0 +``` + +### 默认导入的包 + +两个包被隐式导入到所有源代码文件的范围内： + +- java.lang.* +- scala.* + +Scala 对象 `Predef` 的成员也是默认导入的。 + +> 如果您想知道为什么可以使用 `List`、`Vector`、`Map` 等类，而无需导入它们，它们是可用的，因为 `Predef` 对象中的定义。 + +### 处理命名冲突 + +在极少数情况下会出现命名冲突，您需要从项目的根目录导入一些东西，在包名前加上 `_root_`： + +``` +package accounts + +import _root_.accounts.* +``` + +## 导入 `given` 实例 + +正如您将在 [上下文抽象][contextual] 一章中看到的，`import` 语句的一种特殊形式用于导入 `given` 实例。 +基本形式如本例所示： + +```scala +object A: + class TC + given tc as TC + def f(using TC) = ??? + +object B: + import A.* // import all non-given members + import A.given // import the given instance +``` + +在此代码中，对象 `B` 的 `import A.*` 子句导入了 `A` 的所有成员 *除了* `given` 实例 `tc`。 +相反，第二个导入，`import A.given`，*仅*导入那个 `given` 实例。 +两个 `import` 子句也可以合并为一个： + +```scala +object B: + import A.{given, *} +``` + +### 讨论 + +通配符选择器 `*` 将除给定或扩展之外的所有定义带入范围，而 `given` 选择器将所有*给定*——包括那些由扩展产生的定义——带入范围。 + +这些规则有两个主要好处： + +- 范围内的给定来自哪里更清楚。 + 特别是，不可能在一长串其他通配符导入中隐藏导入的给定。 +- 它可以在不导入任何其他内容的情况下导入所有给定。 + 这一点特别重要，因为给定可以是匿名的，所以通常使用命名导入是不切实际的。 + +### 按类型导入 + +由于给定可以是匿名的，因此按名称导入它们并不总是可行的，通常使用通配符导入。 +*按类型导入* 为通配符导入提供了更具体的替代方案，这使得导入的内容更加清晰： + +```scala +import A.{given TC} +``` + +这会在 `A` 中导入任何具有符合 `TC` 的类型的 `given`。 +导入多种类型的给定 `T1,...,Tn` 由多个 `given` 选择器表示： + +```scala +import A.{given T1, ..., given Tn} +``` + +导入参数化类型的所有 `given` 实例由通配符参数表示。 +例如，当你有这个 `object` 时： + +```scala +object Instances: + given intOrd as Ordering[Int] + given listOrd[T: Ordering] as Ordering[List[T]] + given ec as ExecutionContext = ... + given im as Monoid[Int] +``` + +此导入语句导入 `intOrd`、`listOrd` 和 `ec` 实例，但省略了 `im` 实例，因为它不符合任何指定的边界： + +```scala +import Instances.{given Ordering[?], given ExecutionContext} +``` + +按类型导入可以与按名称导入混合。 +如果两者都存在于导入子句中，则按类型导入排在最后。 +例如，这个 import 子句导入了 `im`、`intOrd` 和 `listOrd`，但省略了 `ec`： + +```scala +import Instances.{im, given Ordering[?]} +``` + +### 一个例子 + +作为一个具体的例子，假设你有这个 `MonthConversions` 对象，它包含两个 `given` 定义： + +```scala +object MonthConversions: + trait MonthConverter[A]: + def convert(a: A): String + + given intMonthConverter: MonthConverter[Int] with + def convert(i: Int): String = + i match + case 1 => "January" + case 2 => "February" + // more cases here ... + + given stringMonthConverter: MonthConverter[String] with + def convert(s: String): String = + s match + case "jan" => "January" + case "feb" => "February" + // more cases here ... +``` + +要将这些给定导入当前范围，请使用以下两个 `import` 语句： + +```scala +import MonthConversions.* +import MonthConversions.{given MonthConverter[?]} +``` + +现在您可以创建一个使用这些 `given` 实例的方法： + +```scala +def genericMonthConverter[A](a: A)(using monthConverter: MonthConverter[A]): String = + monthConverter.convert(a) +``` + +然后您可以在您的应用程序中使用该方法： + +```scala +@main def main = + println(genericMonthConverter(1)) // January + println(genericMonthConverter("jan")) // January +``` + +如前所述， `import given` 语法的主要设计优势之一是明确范围内的给定来自何处，并且在这些 `import` 语句中，很清楚地表明给定是来自 `MonthConversions` 对象。 + +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} From c11754c24be7b6f29a0fd465035e04f096f105c3 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sat, 28 May 2022 16:56:04 +0800 Subject: [PATCH 1889/3075] add all collections --- .../scala3-book/collections-classes.md | 609 ++++++++++++++++++ .../scala3-book/collections-intro.md | 24 + .../scala3-book/collections-methods.md | 401 ++++++++++++ .../scala3-book/collections-summary.md | 31 + 4 files changed, 1065 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/collections-classes.md create mode 100644 _zh-cn/overviews/scala3-book/collections-intro.md create mode 100644 _zh-cn/overviews/scala3-book/collections-methods.md create mode 100644 _zh-cn/overviews/scala3-book/collections-summary.md diff --git a/_zh-cn/overviews/scala3-book/collections-classes.md b/_zh-cn/overviews/scala3-book/collections-classes.md new file mode 100644 index 0000000000..7617c934a3 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/collections-classes.md @@ -0,0 +1,609 @@ +--- +title: 集合类型 +type: section +description: This page introduces the common Scala 3 collections types and some of their methods. +num: 37 +previous-page: collections-intro +next-page: collections-methods +--- + + +{% comment %} +TODO: mention Array, ArrayDeque, ListBuffer, Queue, Stack, StringBuilder? +LATER: note that methods like `+`, `++`, etc., are aliases for other methods +LATER: add links to the Scaladoc for the major types shown here +{% endcomment %} + +本页演示了常见的 Scala 3 集合及其附带的方法。 +Scala 提供了丰富的集合类型，但您可以从其中的几个开始，然后根据需要使用其他的。 +同样，每种集合类型都有数十种方法可以让您的生活更轻松，但您可以从其中的少数几个开始使用，就可以有很多收获。 + +因此，本节介绍并演示了在开始时，需要使用的最常见的类型和方法。 +当您需要更大的灵活性时，请参阅本节末尾的这些页面以获取更多细节。 + +## 三大类集合 + +从高层次看 Scala 集合，有三个主要类别可供选择： + +- **序列**是元素的顺序集合，可以是_有索引的_（如数组）或_线性的_（如链表） +- **影射** 包含键/值对的集合，例如 Java `Map`、Python 字典或 Ruby `Hash` +- **集合** 是无重复元素的无序集合 + +所有这些都是基本类型，并且具有用于特定目的的子类型，例如并发、缓存和流式传输。 +除了这三个主要类别之外，还有其他有用的集合类型，包括范围、堆栈和队列。 + +### 集合层次结构 + +作为简要概述，接下来的三个图显示了 Scala 集合中类和 trait 的层次结构。 + +第一张图显示了_scala.collection_包中的集合类型。 +这些都是高级抽象类或 traits，它们 +通常有_不可变_和_可变_的实现。 + +![一般集合层次结构][collections1] + +此图显示包 _scala.collection.immutable_ 中的所有集合： + +![不可变集合层次结构][collections2] + +此图显示包 _scala.collection.mutable_ 中的所有集合： + +![可变集合层次结构][collections3] + +在查看了所有集合类型的详细视图后，以下部分将介绍一些经常使用的常见类型。 + +{% comment %} +NOTE: those images come from this page: https://docs.scala-lang.org/overviews/collections-2.13/overview.html +{% endcomment %} + +## 常用集合 + +您经常使用的主要集合是： + +| 集合类型 | 不可变 | 可变 | 说明 | +| ------------- | --------- | -------- | ------------ | +| `List` | ✓ | | 线性（链表）、不可变序列 | +| `Vector` | ✓ | | 一个索引的、不可变的序列 | +| `LazyList` | ✓ | | 一个惰性不可变链表，它的元素仅在需要时才计算；适用于大型或无限序列。 | +| `ArrayBuffer` | | ✓ | 可变索引序列的首选类型 | +| `ListBuffer` | | ✓ | 当你想要一个可变的 `List` 时使用；通常转换为“列表” | +| `Map` | ✓ | ✓ | 由键和值对组成的可迭代集合。 | +| `Set` | ✓ | ✓ | 没有重复元素的可迭代集合 | + +如图所示，`Map` 和 `Set` 有不可变和可变版本。 + +以下部分演示了每种类型的基础知识。 + +> 在 Scala 中，_缓冲_——例如 `ArrayBuffer` 和 `ListBuffer`——是一个可以增长和缩小的序列。 + +### 关于不可变集合的说明 + +在接下来的部分中，无论何时使用_不可变_这个词，都可以安全地假设该类型旨在用于_函数性编程_(FP) 风格。 +使用这些类型，您无需修改​​集合；您将功能方法应用于该集合以创建新的结果。 + +## 选择序列 + +选择_序列_---一个顺序集合元素时---您有两个主要决定： + +- 是否应该对序列进行索引（如数组），允许快速访问任何元素，还是应该将其实现为线性链表？ +- 你想要一个可变的还是不可变的集合？ + +此处显示了推荐的通用顺序集合，用于可变/不可变和索引/线性组合： + +| 类型/类别 | 不可变 | 可变 | +| --------------------- | --------- | ------------ | +|索引 | `Vector` |`ArrayBuffer` | +|线性（链表） | `List` |`ListBuffer` | + +例如，如果您需要一个不可变的索引集合，通常您应该使用 `Vector`。 +相反，如果您需要一个可变的索引集合，请使用 `ArrayBuffer`。 + +> `List` 和 `Vector` 在以函数式风格编写代码时经常使用。 +> `ArrayBuffer` 通常在以命令式风格编写代码时使用。 +> `ListBuffer` 用于混合样式时，例如构建列表。 + +接下来的几节简要介绍了 `List`、`Vector` 和 `ArrayBuffer` 类型。 + +## `List` + +[列表类型](https://www.scala-lang.org/api/current/scala/collection/immutable/List.html) 是一个线性的、不可变的序列。 +这只是意味着它是一个您无法修改的链表。 +任何时候你想添加或删除 `List` 元素，你都可以从现有的 `List` 中创建一个新的 `List`。 + +### 创建列表 + +这是创建初始“列表”的方式： + +```scala +val ints = List(1, 2, 3) +val names = List("Joel", "Chris", "Ed") + +// another way to construct a List +val namesAgain = "Joel" :: "Chris" :: "Ed" :: Nil +``` + +如果您愿意，也可以声明 `List` 的类型，但通常不是必需的： + +```scala +val ints: List[Int] = List(1, 2, 3) +val names: List[String] = List("Joel", "Chris", "Ed") +``` + +一个例外是集合中有混合类型时。在这种情况下，您可能需要明确指定其类型： + +```scala +val things: List[Any] = List(1, "two", 3.0) +``` + +### 将元素添加到列表 + +因为 `List` 是不可变的，所以你不能向它添加新元素。 +相反，您可以通过将元素添加到现有 `List` 来创建新列表。 +例如，给定这个 `List`： + +```scala +val a = List(1, 2, 3) +``` + +使用 `List` 时，用 `::` 来_附加_一个元素，用 `:::` 把另一个 `List` 插在这个 `List` 之前，如下所示： + +```scala +val b = 0 :: a // List(0, 1, 2, 3) +val c = List(-1, 0) ::: a // List(-1, 0, 1, 2, 3) +``` + +你也可以在 `List` 中添加元素，但是因为 `List` 是一个单链表，你通常应该只在它前面添加元素； +在它的后面添加元素是一个相对较慢的操作，尤其是在处理大型序列时。 + +> 提示：如果您想将元素添加到不可变序列的前面或者后面时，请改用 `Vector`。 + +因为 `List` 是一个链表，你不应该尝试通过索引值来访问大列表的元素。 +例如，如果您有一个包含一百万个元素的 `List` ，则访问像 `myList(999_999)` 这样的元素将花费相对较长的时间，因为该请求必须遍历所有这些元素。 +如果您有一个大型集合并希望通过索引访问元素，请改用 `Vector` 或 `ArrayBuffer`。 + +### 如何记住方法名 + +现在 IDE 为我们提供了极大的帮助，但是记住这些方法名称的一种方法是，认为 `:` 字符代表序列所在的一侧，因此当您使用 `+:` 时，您知道列表需要在右边，像这样： + +```scala +0 +： a +``` + +同样，当您使用 `:+` 时，您知道列表需要在左侧： + +```scala +a ：+ 4 +``` + +有更多的技术方法可以考虑这一点，但这可能是记住方法名称的有用方法。 + +{% comment %} +LATER: Add a discussion of `:` on method names, right-associativity, and infix operators. +{% endcomment %} + +此外，这些符号方法名称的一个好处是它们是一致的。 +相同的方法名称用于其他不可变序列，例如 `Seq` 和 `Vector`。 +如果您愿意，还可以使用非符号方法名称来附加元素和在头部插入元素。 + +### 如何遍历列表 + +给定一个名称 `List`： + +```scala +val names = List("Joel", "Chris", "Ed") +``` + +您可以像这样打印每个字符串： + +```scala +for name <- names do println(name) +``` + +这是它在 REPL 中的样子： + +```scala +scala> for name <-names do println(name) +Joel +Chris +Ed +``` + +将 `for` 循环与集合一起使用的一个好处是 Scala 是一致的，并且相同的方法适用于所有序列，包括 `Array`、`ArrayBuffer`、`List`、`Seq`、`Vector`、`Map` ，`Set` 等。 + +### 一点历史 + +对于那些对历史感兴趣的人，Scala `List` 类似于 [Lisp 编程语言](https://en.wikipedia.org/wiki/Lisp_(programming_language)) 中的 `List`，它是最初于 1958 年确定的。 +实际上，除了像这样创建一个 `List` 之外： + +```scala +val ints = List(1, 2, 3) +``` + +您也可以通过这种方式创建完全相同的列表： + +```scala +val list = 1 :: 2 :: 3 :: Nil +``` + +REPL 展示了它是如何工作的： + +```scala +scala> val list = 1 :: 2 :: 3 :: Nil +list: List[Int] = List(1, 2, 3) +``` + +这是因为 `List` 是一个以 `Nil` 元素结尾的单链表，而 `::` 是一个 `List` 方法，其工作方式类似于 Lisp 的“cons”运算符。 + +### 旁白：LazyList + +Scala 集合还包括一个 [LazyList](https://www.scala-lang.org/api/current/scala/collection/immutable/LazyList.html)，它是一个 _惰性_不可变链表。 +它被称为“惰性”——或非严格——因为它仅在需要时计算其元素。 + +你可以看到 REPL 中的 `LazyList` 有多懒惰： + +```scala +val x = LazyList.range(1, Int.MaxValue) +x.take(1) // LazyList() +x.take(5) // LazyList() +x.map(_ + 1) // LazyList() +``` + +在所有这些例子中，什么都没有发生。 +事实上，除非你强迫它发生，否则什么都不会发生，例如通过调用它的 `foreach` 方法： + +```` +scala> x.take(1).foreach(println) +1 +```` + +有关严格和非严格的用途、好处和缺点的更多信息严格（惰性）集合，请参阅 [The Architecture of Scala 2.13's Collections][strict] 页面上的“严格”和“非严格”讨论。 + + + +## 向量 + +[向量](https://www.scala-lang.org/api/current/scala/collection/immutable/Vector.html) 是一个索引的、不可变的序列。 +描述的“索引”部分意味着它提供了在有效恒定时间内随机访问和更新向量，因此您可以通过索引值快速访问 `Vector` 元素，例如访问 `listOfPeople(123_456_789)` 。 + +一般来说，除了 (a) `Vector` 有索引而 `List` 没有索引，以及 (b) `List` 有 `::` 方法这两个不同外，这两种类型的工作方式相同，所以我们将快速过一下示例。 + +以下是创建“向量”的几种方法： + +```scala +val nums = Vector(1, 2, 3, 4, 5) + +val strings = Vector("one", "two") + +case class Person(name: String) +val people = Vector( + Person("Bert"), + Person("Ernie"), + Person("Grover") +) +``` + +因为 `Vector` 是不可变的，所以你不能向它添加新元素。 +相反，您通过将元素附加或插入头部到现有的 `Vector`，从而创建新序列。 +这些示例展示了如何将元素_附加_到 `Vector`： + +```scala +val a = Vector(1,2,3) // Vector(1, 2, 3) +val b = a :+ 4 // Vector(1, 2, 3, 4) +val c = a ++ Vector(4, 5) // Vector(1, 2, 3, 4, 5) +``` + +这就是你_插入头部_元素的方式： + +```scala +val a = Vector(1,2,3) // Vector(1, 2, 3) +val b = 0 +: a // Vector(0, 1, 2, 3) +val c = Vector(-1, 0) ++: a // Vector(-1, 0, 1, 2, 3) +``` + +除了快速的随机访问和更新之外，`Vector` 还提供了快速的追加和前置时间，因此您可以根据需要使用这些功能。 + +> 请参阅 [集合性能特性](https://docs.scala-lang.org/overviews/collections-2.13/performance-characteristics.html) 了解有关 `Vector` 和其他集合的性能详细信息。 + +最后，您可以在 `for` 循环中使用 `Vector`，就像 `List`、`ArrayBuffer` 或任何其他序列一样： + +```scala +scala> val names = Vector("Joel", "Chris", "Ed") +val names: Vector[String] = Vector(Joel, Chris, Ed) + +scala> for name <- names do println(name) +Joel +Chris +Ed +``` + +## 数组缓冲区 + +当您在 Scala 应用程序中需要一个通用的、可变的索引序列时，请使用 `ArrayBuffer`。 +它是可变的，所以你可以改变它的元素，也可以调整它的大小。 +因为它是索引的，所以元素的随机访问很快。 + +### 创建一个数组缓冲区 + +要使用 `ArrayBuffer`，首先导入它： + +```scala +import scala.collection.mutable.ArrayBuffer +``` + +如果您需要从一个空的 `ArrayBuffer` 开始，只需指定其类型： + +```scala +var strings = ArrayBuffer[String]() +var ints = ArrayBuffer[Int]() +var people = ArrayBuffer[Person]() +``` + +如果您知道 `ArrayBuffer` 最终需要的大致大小，则可以使用初始大小创建它： + +```scala +// ready to hold 100,000 ints +val buf = new ArrayBuffer[Int](100_000) +``` + +要创建具有初始元素的新 `ArrayBuffer`，只需指定其初始元素，就像 `List` 或 `Vector` 一样： + +```scala +val nums = ArrayBuffer(1, 2, 3) +val people = ArrayBuffer( + Person("Bert"), + Person("Ernie"), + Person("Grover") +) +``` + +### 将元素添加到数组缓冲区 + +使用 `+=` 和 `++=` 方法将新元素附加到 `ArrayBuffer`。 +或者，如果您更喜欢具有文本名称的方法，您也可以使用 `append`、`appendAll`、`insert`、`insertAll`、`prepend` 和 `prependAll`。 + +以下是 `+=` 和 `++=` 的一些示例： + +```scala +val nums = ArrayBuffer(1, 2, 3) // ArrayBuffer(1, 2, 3) +nums += 4 // ArrayBuffer(1, 2, 3, 4) +nums ++= List(5, 6) // ArrayBuffer(1, 2, 3, 4, 5, 6) +``` + +### 从数组缓冲区中移除元素 + +`ArrayBuffer` 是可变的，所以它有 `-=`、`--=`、`clear`、`remove` 等方法。 +这些示例演示了 `-=` 和 `--=` 方法： + +```scala +val a = ArrayBuffer.range('a', 'h') // ArrayBuffer(a, b, c, d, e, f, g) +a -= 'a' // ArrayBuffer(b, c, d, e, f, g) +a --= Seq('b', 'c') // ArrayBuffer(d, e, f, g) +a --= Set('d', 'e') // ArrayBuffer(f, g) +``` + +### 更新数组缓冲区元素 + +通过重新分配所需元素或使用 `update` 方法来更新 `ArrayBuffer` 中的元素： + +```scala +val a = ArrayBuffer.range(1,5) // ArrayBuffer(1, 2, 3, 4) +a(2) = 50 // ArrayBuffer(1, 2, 50, 4) +a.update(0, 10) // ArrayBuffer(10, 2, 50, 4) +``` + +## 映射 + +`Map` 是由键值对组成的可迭代集合。 +Scala 有可变和不可变的 `Map` 类型，本节演示如何使用_不可变_ `Map`。 + +### 创建不可变映射 + +像这样创建一个不可变的`Map`： + +```scala +val states = Map( + "AK" -> "Alaska", + "AL" -> "Alabama", + "AZ" -> "Arizona" +) +``` + +一旦你有了一个`Map`，你可以像这样在`for`循环中遍历它的元素： + +```scala +for (k, v) <- states do println(s"key: $k, value: $v") +``` + +REPL 展示了它是如何工作的： + +```` +scala> for (k, v) <- states do println(s"key: $k, value: $v") +key: AK, value: Alaska +key: AL, value: Alabama +key: AZ, value: Arizona +```` + +### 访问映射元素 + +通过在括号中指定所需的键值来访问映射元素： + +```scala +val ak = states("AK") // ak: String = Alaska +val al = states("AL") // al: String = Alabama +``` + +在实践中，您还将使用诸如 `keys`、`keySet`、`keysIterator`、`for` 循环之类的方法以及 `map` 之类的高阶函数来处理 `Map` 键和值。 + +### 向映射添加元素 + +使用 `+` 和 `++` 将元素添加到不可变映射中，记住将结果分配给新变量： + +```scala +val a = Map(1 -> "one") // a: Map(1 -> one) +val b = a + (2 -> "two") // b: Map(1 -> one, 2 -> two) +val c = b ++ Seq( + 3 -> "three", + 4 -> "four" +) +// c: Map(1 -> one, 2 -> two, 3 -> three, 4 -> four) +``` + +### 从映射中删除元素 + +使用 `-` 或 `--` 和要删除的键值从不可变映射中删除元素，记住将结果分配给新变量： + +```scala +val a = Map( + 1 -> "one", + 2 -> "two", + 3 -> "three", + 4 -> "four" +) + +val b = a - 4 // b: Map(1 -> one, 2 -> two, 3 -> three) +val c = a - 4 - 3 // c: Map(1 -> one, 2 -> two) +``` + +### 更新映射元素 + +要更新不可变映射中的元素，请在将结果分配给新变量时使用 `updated` 方法（或 `+` 运算符）： + +```scala +val a = Map( + 1 -> "one", + 2 -> "two", + 3 -> "three" +) + +val b = a.updated(3, "THREE!") // b: Map(1 -> one, 2 -> two, 3 -> THREE!) +val c = a + (2 -> "TWO...") // c: Map(1 -> one, 2 -> TWO..., 3 -> three) +``` + +### 遍历映射 + +如前所述，这是使用 `for` 循环手动遍历映射中元素的常用方法： + +```scala +val states = Map( + "AK" -> "Alaska", + "AL" -> "Alabama", + "AZ" -> "Arizona" +) + +for (k, v) <- states do println(s"key: $k, value: $v") +``` + +话虽如此，有_许多_方法可以使用映射中的键和值。 +常见的 `Map` 方法包括 `foreach`、`map`、`keys` 和 `values`。 + +Scala 有许多更专业的`Map` 类型，包括`CollisionProofHashMap`、`HashMap`、`LinkedHashMap`、`ListMap`、`SortedMap`、`TreeMap`、`WeakHashMap` 等等。 + +## 使用集合 + +Scala [集合]({{site.baseurl}}/overviews/collections-2.13/sets.html) 是一个没有重复元素的可迭代集合。 + +Scala 有可变和不可变的 `Set` 类型。 +本节演示_不可变_ `Set`。 + +### 创建一个集合 + +像这样创建新的空集： + +```scala +val nums = Set[Int]() +val letters = Set[Char]() +``` + +使用初始数据创建集合，如下： + +```scala +val nums = Set(1, 2, 3, 3, 3) // Set(1, 2, 3) +val letters = Set('a', 'b', 'c', 'c') // Set('a', 'b', 'c') +``` + +### 向集合中添加元素 + +使用 `+` 和 `++` 将元素添加到不可变的 `Set`，记住将结果分配给一个新变量： + +```scala +val a = Set(1, 2) // Set(1, 2) +val b = a + 3 // Set(1, 2, 3) +val c = b ++ Seq(4, 1, 5, 5) // HashSet(5, 1, 2, 3, 4) +``` + +请注意，当您尝试添加重复元素时，它们会被悄悄删除。 + +另请注意，元素的迭代顺序是任意的。 + +### 从集合中删除元素 + +使用 `-` 和 `--` 从不可变集合中删除元素，再次将结果分配给新变量： + +```scala +val a = Set(1, 2, 3, 4, 5) // HashSet(5, 1, 2, 3, 4) +val b = a - 5 // HashSet(1, 2, 3, 4) +val c = b -- Seq(3, 4) // HashSet(1, 2) +``` + +## 范围 + +Scala `Range` 通常用于填充数据结构和迭代 `for` 循环。 +这些 REPL 示例演示了如何创建范围： + +{% comment %} +LATER: the dotty repl currently shows results differently +{% endcomment %} + +```scala +1 to 5 // Range(1, 2, 3, 4, 5) +1 until 5 // Range(1, 2, 3, 4) +1 to 10 by 2 // Range(1, 3, 5, 7, 9) +'a' to 'c' // NumericRange(a, b, c) +``` + +您可以使用范围来填充集合： + +```scala +val x = (1 to 5).toList // List(1, 2, 3, 4, 5) +val x = (1 to 5).toBuffer // ArrayBuffer(1, 2, 3, 4, 5) +``` + +它们也用于 `for` 循环： + +```` +scala> for i <- 1 to 3 do println(i) +1 +2 +3 +```` + +还有 `range` 方法： + +```scala +Vector.range(1, 5) // Vector(1, 2, 3, 4) +List.range(1, 10, 2) // List(1, 3, 5, 7, 9) +Set.range(1, 10) // HashSet(5, 1, 6, 9, 2, 7, 3, 8, 4) +``` + +当您运行测试时，范围对于生成​​测试集合也很有用： + +```scala +val evens = (0 to 10 by 2).toList // List(0, 2, 4, 6, 8, 10) +val odds = (1 to 10 by 2).toList // List(1, 3, 5, 7, 9) +val doubles = (1 to 5).map(_ * 2.0) // Vector(2.0, 4.0, 6.0, 8.0, 10.0) + +// create a Map +val map = (1 to 3).map(e => (e,s"$e")).toMap + // map: Map[Int, String] = Map(1 -> "1", 2 -> "2", 3 -> "3") +``` + +## 更多细节 + +当您需要特定集合更多的信息，请参阅以下资源： + +- [具体的不可变集合类](https://docs.scala-lang.org/overviews/collections-2.13/concrete-immutable-collection-classes.html) +- [具体的可变集合类](https://docs.scala-lang.org/overviews/collections-2.13/concrete-mutable-collection-classes.html) +- [集合是如何构造的？ 我应该选择哪一个？](https://docs.scala-lang.org/tutorials/FAQ/collections.html) + diff --git a/_zh-cn/overviews/scala3-book/collections-intro.md b/_zh-cn/overviews/scala3-book/collections-intro.md new file mode 100644 index 0000000000..e8ee13baed --- /dev/null +++ b/_zh-cn/overviews/scala3-book/collections-intro.md @@ -0,0 +1,24 @@ +--- +title: Scala 集合 +type: chapter +description: This page provides and introduction to the common collections classes and their methods in Scala 3. +num: 36 +previous-page: packaging-imports +next-page: collections-classes +--- + + +本章介绍了最常见的 Scala 3 集合及其附带的方法。 +Scala 提供了丰富的集合类型，但您可以从其中的几个开始，然后根据需要使用其他的。 +同样，每种类型都有数十种方法可以让您的生活更轻松，但您可以从少数几种方法开始使用，就可以有很多收获。 + +因此，本节介绍并演示您开始时，需要使用的最常见的集合类型和方法。 + +{% comment %} +LATER: Use more of the content from this page: + https://docs.scala-lang.org/overviews/index.html +{% endcomment %} + + + + diff --git a/_zh-cn/overviews/scala3-book/collections-methods.md b/_zh-cn/overviews/scala3-book/collections-methods.md new file mode 100644 index 0000000000..7d0d19f368 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/collections-methods.md @@ -0,0 +1,401 @@ +--- +title: 集合方法 +type: section +description: This page demonstrates the common methods on the Scala 3 collections classes. +num: 38 +previous-page: collections-classes +next-page: collections-summary +--- + + +Scala 集合的一大优势在于它们提供了许多开箱即用的方法，并且这些方法在不可变和可变集合类型中始终可用。 +这样做的好处是，您不用在每次需要使用集合时编写自定义的 `for` 循环，并且当您从一个项目转到另一个项目时，您会发现更多地使用这些相同的方法，而不是使用自定义 `for` 循环。 + +有*几十*种方法可供您使用，因此此处并未全部显示。 +相反，只显示了一些最常用的方法，包括： + +- `map` +- `filter` +- `foreach` +- `head` +- `tail` +- `take`, `takeWhile` +- `drop`, `dropWhile` +- `reduce` + +以下方法适用于所有序列类型，包括 `List`、`Vector`、`ArrayBuffer` 等，但除非另有说明，否则这些示例使用 `List`。 + +> 作为一个非常重要的说明，`List` 上的任何方法都不会改变列表。 +> 它们都以函数式风格工作，这意味着它们返回带有修改结果的新集合。 + +## 常用方法示例 + +为了让您大致了解在后面章节中将看到的内容，这些示例展示了一些最常用的集合方法。 +首先，这里有一些不使用 lambda 的方法： + +```scala +val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) + +a.distinct // List(10, 20, 30, 40) +a.drop(2) // List(30, 40, 10) +a.dropRight(2) // List(10, 20, 30) +a.head // 10 +a.headOption // Some(10) +a.init // List(10, 20, 30, 40) +a.intersect(List(19,20,21)) // List(20) +a.last // 10 +a.lastOption // Some(10) +a.slice(2,4) // List(30, 40) +a.tail // List(20, 30, 40, 10) +a.take(3) // List(10, 20, 30) +a.takeRight(2) // List(40, 10) +``` + +### 高阶函数和 lambda + +接下来，我们将展示一些常用的接受 lambda（匿名函数）的高阶函数 (HOF)。 +首先，这里有几个 lambda 语法的变体，从最长的形式开始，逐步过渡最简洁的形式： + +```scala +// these functions are all equivalent and return +// the same data: List(10, 20, 10) + +a.filter((i: Int) => i < 25) // 1. most explicit form +a.filter((i) => i < 25) // 2. `Int` is not required +a.filter(i => i < 25) // 3. the parens are not required +a.filter(_ < 25) // 4. `i` is not required +``` + +在那些编号的例子中： + +1. 第一个例子显示了最长的形式。 + _很少_需要这么多的冗长，并且只在最复杂的用法中需要。 +2. 编译器知道 `a` 包含 `Int`，所以这里没有必要重述。 +3. 只有一个参数时不需要括号，例如`i`。 +4. 当你有一个参数并且它在你的匿名函数中只出现一次时，你可以用 `_` 替换参数。 + +[匿名函数][lambdas] 提供了与缩短 lambda 表达式相关的规则的更多详细信息和示例。 + +现在您已经看到了简洁的形式，下面是使用短形式 lambda 语法的其他 HOF 的示例： + +```scala +a.dropWhile(_ < 25) // List(30, 40, 10) +a.filter(_ > 100) // List() +a.filterNot(_ < 25) // List(30, 40) +a.find(_ > 20) // Some(30) +a.takeWhile(_ < 30) // List(10, 20) +``` + +值得注意的是，HOF 也接受方法和函数作为参数——不仅仅是 lambda 表达式。 +下面是一些使用名为 `double` 的方法的`map` HOF 示例。 +再次显示了 lambda 语法的几种变体： + +```scala +def double(i: Int) = i * 2 + +// these all return `List(20, 40, 60, 80, 20)` +a.map(i => double(i)) +a.map(double(_)) +a.map(double) +``` + +在最后一个示例中，当匿名函数由一个接受单个参数的函数调用组成时，您不必命名参数，因此甚至不需要 `_`。 + +最后，您可以根据需要组合 HOF 来解决问题： + +```scala +// yields `List(100, 200)` +a.filter(_ < 40) + .takeWhile(_ < 30) + .map(_ * 10) +``` + +## 例子数据 + +以下部分中的示例使用这些列表： + +```scala +val oneToTen = (1 to 10).toList +val names = List("adam", "brandy", "chris", "david") +``` + +## `map` + +`map` 方法遍历现有列表中的每个元素，将您提供的函数应用于每个元素，一次一个； +然后它返回一个包含所有修改元素的新列表。 + +这是一个将 `map` 方法应用于 `oneToTen` 列表的示例： + +```scala +scala> val doubles = oneToTen.map(_ * 2) +doubles: List[Int] = List(2, 4, 6, 8, 10, 12, 14, 16, 18, 20) +``` + +您还可以使用长格式编写匿名函数，如下所示： + +```scala +scala> val doubles = oneToTen.map(i => i * 2) +doubles: List[Int] = List(2, 4, 6, 8, 10, 12, 14, 16, 18, 20) +``` + +但是，在本课中，我们将始终使用第一种较短的形式。 + +以下是更多应用于 `oneToTen` 和 `names` 列表的 `map` 方法的示例： + +```scala +scala> val capNames = names.map(_.capitalize) +capNames: List[String] = List(Adam, Brandy, Chris, David) + +scala> val nameLengthsMap = names.map(s => (s, s.length)).toMap +nameLengthsMap: Map[String, Int] = Map(adam -> 4, brandy -> 6, chris -> 5, david -> 5) + +scala> val isLessThanFive = oneToTen.map(_ < 5) +isLessThanFive: List[Boolean] = List(true, true, true, true, false, false, false, false, false, false) +``` + +如最后两个示例所示，使用 `map` 返回与原始类型不同类型的集合是完全合法的（并且很常见）。 + +## `filter` + +`filter` 方法创建一个新列表，其中包含满足所提供谓词的元素。 +谓词或条件是返回 `Boolean`（`true` 或 `false`）的函数。 +这里有一些例子： + +```scala +scala> val lessThanFive = oneToTen.filter(_ < 5) +lessThanFive: List[Int] = List(1, 2, 3, 4) + +scala> val evens = oneToTen.filter(_ % 2 == 0) +evens: List[Int] = List(2, 4, 6, 8, 10) + +scala> val shortNames = names.filter(_.length <= 4) +shortNames: List[String] = List(adam) +``` + +集合上的函数式方法的一个优点是您可以将它们链接在一起以解决问题。 +例如，这个例子展示了如何链接 `filter` 和 `map`： + +```scala +oneToTen.filter(_ < 4).map(_ * 10) +``` + +REPL 显示结果： + +```scala +scala> oneToTen.filter(_ < 4).map(_ * 10) +val res1: List[Int] = List(10, 20, 30) +``` + +## `foreach` + +`foreach` 方法用于遍历集合中的所有元素。 +请注意，`foreach` 用于副作用，例如打印信息。 +这是一个带有 `names` 列表的示例： + +```scala +scala> names.foreach(println) +adam +brandy +chris +david +``` + +## `head` + +`head` 方法来自 Lisp 和其他早期的函数式编程语言。 +它用于访问列表的第一个元素（头元素）： + +```scala +oneToTen.head // 1 +names.head // adam +``` + +因为 `String` 可以看作是一个字符序列，所以你也可以把它当作一个列表。 +这就是 `head` 在这些字符串上的工作方式： + +```scala +"foo".head // 'f' +"bar".head // 'b' +``` + +`head` 是一个很好的方法，但需要注意的是，在空集合上调用它时也会抛出异常： + +```scala +val emptyList = List[Int]() // emptyList: List[Int] = List() +emptyList.head // java.util.NoSuchElementException: head of empty list +``` + +因此，您可能希望使用 `headOption` 而不是 `head`，尤其是在以函数式编程时： + +```scala +emptyList.headOption // None +``` + +如图所示，它不会抛出异常，它只是返回值为 `None` 的类型 `Option`。 +您可以在 [函数式编程][fp-intro] 章节中了解有关这种编程风格的更多信息。 + +## `tail` + +`tail` 方法也来自 Lisp，它用于打印列表头元素之后的每个元素。 +几个例子展示了这一点： + +```scala +oneToTen.head // 1 +oneToTen.tail // List(2, 3, 4, 5, 6, 7, 8, 9, 10) + +names.head // adam +names.tail // List(brandy, chris, david) +``` + +就像 `head` 一样，`tail` 也适用于字符串： + +```scala +"foo".tail // "oo" +"bar".tail // "ar" +``` + +如果列表为空，`tail` 会抛出 _java.lang.UnsupportedOperationException_，所以就像 `head` 和 `headOption` 一样，还有一个 `tailOption` 方法，这是函数式编程的首选方法。 + +也可以匹配一个列表，因此您可以编写如下表达式： + +```scala +val x :: xs = names +``` + +将该代码放在 REPL 中显示 `x` 分配给列表的头部，而 `xs` 分配给列表尾部： + +```scala +scala> val x :: xs = names +val x: String = adam +val xs: List[String] = List(brandy, chris, david) +``` + +像这样的模式匹配在许多情况下都很有用，例如使用递归编写一个 `sum` 方法： + +```scala +def sum(list: List[Int]): Int = list match + case Nil => 0 + case x :: xs => x + sum(xs) +``` + +## `take`、`takeRight`、`takeWhile` + +`take`、`takeRight` 和 `takeWhile` 方法为您提供了一种从列表中“获取”要用于创建新列表的元素的好方法。 +这是 `take` 和 `takeRight`： + +```scala +oneToTen.take(1) // List(1) +oneToTen.take(2) // List(1, 2) + +oneToTen.takeRight(1) // List(10) +oneToTen.takeRight(2) // List(9, 10) +``` + +注意这些方法是如何处理“临界”情况的，当我们要求比序列中更多的元素，或者要求零元素的时候： + +```scala +oneToTen.take(Int.MaxValue) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +oneToTen.takeRight(Int.MaxValue) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +oneToTen.take(0) // List() +oneToTen.takeRight(0) // List() +``` + +这是`takeWhle`，它与谓词函数一起使用： + +```scala +oneToTen.takeWhile(_ < 5) // List(1, 2, 3, 4) +names.takeWhile(_.length < 5) // List(adam) +``` + +## `drop`、`dropRight`、`dropWhile` + +`drop`、`dropRight` 和 `dropWhile` 本质上与它们对应的“取”相反，从列表中删除元素。 +这里有些例子： + +```scala +oneToTen.drop(1) // List(2, 3, 4, 5, 6, 7, 8, 9, 10) +oneToTen.drop(5) // List(6, 7, 8, 9, 10) + +oneToTen.dropRight(8) // List(1, 2) +oneToTen.dropRight(7) // List(1, 2, 3) +``` + +再次注意这些方法如何处理临界情况： + +```scala +oneToTen.drop(Int.MaxValue) // List() +oneToTen.dropRight(Int.MaxValue) // List() +oneToTen.drop(0) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +oneToTen.dropRight(0) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +``` + +这是 `dropWhile`，它与谓词函数一起使用： + +```scala +oneToTen.dropWhile(_ < 5) // List(5, 6, 7, 8, 9, 10) +names.dropWhile(_ != "chris") // List(chris, david) +``` + +## `reduce` + +当您听到“映射归约”这个术语时，“归约”部分指的是诸如 `reduce` 之类的方法。 +它接受一个函数（或匿名函数）并将该函数应用于列表中的连续元素。 + +解释 `reduce` 的最好方法是创建一个可以传递给它的小辅助方法。 +例如，这是一个将两个整数相加的 `add` 方法，还为我们提供了一些不错的调试输出： + +```scala +def add(x: Int, y: Int): Int = + val theSum = x + y + println(s"received $x and $y, their sum is $theSum") + theSum +``` + +有上面的方法和下面的列表： + +```scala +val a = List(1,2,3,4) +``` + +这就是将 `add` 方法传递给 `reduce` 时发生的情况： + +```scala +scala> a.reduce(add) +received 1 and 2, their sum is 3 +received 3 and 3, their sum is 6 +received 6 and 4, their sum is 10 +res0: Int = 10 +``` + +如该结果所示，`reduce` 使用`add` 将列表 `a` 归约为单个值，在这种情况下，是列表中整数的总和。 + +一旦你习惯了 `reduce`，你会写一个像这样的“求和”算法： + +```scala +scala> a.reduce(_ + _) +res0: Int = 10 +``` + +类似地，“连乘”算法如下所示： + +```scala +scala> a.reduce(_ * _) +res1: Int = 24 +``` + +> 关于 `reduce` 的一个重要概念是——顾名思义——它用于将集合_归约_为单个值。 + +## 更多 + +在 Scala 集合类型上确实有几十个额外的方法，可以让你不再需要编写另一个 `for` 循环。有关 Scala 集合的更多详细信息，请参阅[可变和不可变集合][mut-immut-colls]和[Scala集合的构架][architecture]。 + +> 最后一点，如果您在 Scala 项目中使用 Java 代码，您可以将 Java 集合转换为 Scala 集合。 +> 通过这样做，您可以在 `for` 表达式中使用这些集合，还可以利用 Scala 的函数式集合方法。 +> 请参阅 [与 Java 交互][interacting] 部分了解更多详细信息。 + +[interacting]: {% link _overviews/scala3-book/interacting-with-java.md %} +[lambdas]: {% link _overviews/scala3-book/fun-anonymous-functions.md %} +[fp-intro]: {% link _overviews/scala3-book/fp-intro.md %} +[mut-immut-colls]: {% link _overviews/collections-2.13/overview.md %} +[architecture]: {% link _overviews/core/architecture-of-scala-213-collections.md %} + diff --git a/_zh-cn/overviews/scala3-book/collections-summary.md b/_zh-cn/overviews/scala3-book/collections-summary.md new file mode 100644 index 0000000000..4a47cb2ffd --- /dev/null +++ b/_zh-cn/overviews/scala3-book/collections-summary.md @@ -0,0 +1,31 @@ +--- +title: 总结 +type: section +description: This page provides a summary of the Collections chapter. +num: 39 +previous-page: collections-methods +next-page: fp-intro +--- + + +本章总结了常见的 Scala 3 集合及其附带的方法。 +如图所示，Scala 带有丰富的集合和方法。 + +当您需要查看本章中显示的集合类型的更多详细信息时，请参阅他们的 Scaladoc 页面： + +- [List](https://www.scala-lang.org/api/current/scala/collection/immutable/List.html) +- [Vector](https://www.scala-lang.org/api/current/scala/collection/immutable/Vector.html) +- [ArrayBuffer](https://www.scala-lang.org/api/current/scala/collection/mutable/ArrayBuffer.html) +- [Range](https://www.scala-lang.org/api/current/scala/collection/immutable/Range.html) + +也提到了不可变的 `Map` 和 `Set`: + +- [Map](https://www.scala-lang.org/api/current/scala/collection/immutable/Map.html) +- [Set](https://www.scala-lang.org/api/current/scala/collection/immutable/Set.html) + +和可变的 `Map` 和 `Set`: + +- [Map](https://www.scala-lang.org/api/current/scala/collection/mutable/Map.html) +- [Set](https://www.scala-lang.org/api/current/scala/collection/mutable/Set.html) + + From f751a72c38639a08f11d2e4c6b235e15c3d06964 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sun, 29 May 2022 20:55:50 +0800 Subject: [PATCH 1890/3075] add all fp files --- .../fp-functional-error-handling.md | 303 ++++++++++++++++++ .../scala3-book/fp-functions-are-values.md | 99 ++++++ .../scala3-book/fp-immutable-values.md | 70 ++++ _zh-cn/overviews/scala3-book/fp-intro.md | 24 ++ .../scala3-book/fp-pure-functions.md | 106 ++++++ _zh-cn/overviews/scala3-book/fp-summary.md | 24 ++ _zh-cn/overviews/scala3-book/fp-what-is-fp.md | 27 ++ 7 files changed, 653 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/fp-functional-error-handling.md create mode 100644 _zh-cn/overviews/scala3-book/fp-functions-are-values.md create mode 100644 _zh-cn/overviews/scala3-book/fp-immutable-values.md create mode 100644 _zh-cn/overviews/scala3-book/fp-intro.md create mode 100644 _zh-cn/overviews/scala3-book/fp-pure-functions.md create mode 100644 _zh-cn/overviews/scala3-book/fp-summary.md create mode 100644 _zh-cn/overviews/scala3-book/fp-what-is-fp.md diff --git a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md new file mode 100644 index 0000000000..effde2f6c8 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md @@ -0,0 +1,303 @@ +--- +title: 函数式错误处理 +type: section +description: This section provides an introduction to functional error handling in Scala 3. +num: 45 +previous-page: fp-functions-are-values +next-page: fp-summary +--- + + +函数式编程就像写一系列代数方程，因为代数没有空值或抛出异常，所以你不用在 FP 中使用这些特性。 +这带来了一个有趣的问题：在 OOP 代码中通常可能使用空值或异常的情况下，您会怎么做？ + +Scala 的解决方案是使用类似 `Option`/`Some`/`None` 类的结构。 +本课介绍如何使用这些技术。 + +在我们开始之前有两个注意事项： + +- `Some` 和 `None` 类是 `Option` 的子类。 +- 下面的文字一般只指“`Option`”或“`Option`类”，而不是重复说“`Option`/`Some`/`None`”。 + +## 第一个例子 + +虽然第一个示例不处理空值，但它是引入 `Option` 类的好方法，所以我们将从它开始。 + +想象一下，您想编写一个方法，可以轻松地将字符串转换为整数值，并且您想要一种优雅的方法来处理异常，这个是异常是该方法获取类似“Hello”而不是“1”的字符串时引发的。 +对这种方法的初步猜测可能如下所示： + +```scala +def makeInt(s: String): Int = + try + Integer.parseInt(s.trim) + catch + case e: Exception => 0 +``` + +如果转换成功，则此方法返回正确的 `Int` 值，但如果失败，则该方法返回 `0`。 +出于某些目的，这可能是可以的，但它并不准确。 +例如，该方法可能收到了`"0"`，但它也可能收到了 `"foo"`、`"bar"` 或无数其他将引发异常的字符串。 +这是一个真正的问题：您如何知道该方法何时真正收到 `"0"`，或者何时收到其他内容？ +答案是，用这种方法，没有办法知道。 + +## 使用 Option/Some/None + +Scala 中这个问题的一个常见解决方案是使用三个类，称为 `Option`、`Some` 和 `None` 。 +`Some` 和 `None` 类是 `Option` 的子类，因此解决方案的工作原理如下： + +- 你声明 `makeInt` 返回一个 `Option` 类型 +- 如果 `makeInt` 接收到一个字符串，它*可以* 转换为 `Int`，答案将包含在 `Some` 中 +- 如果 `makeInt` 接收到一个它*无法*转换的字符串，它返回一个 `None` + +这是 `makeInt` 的修订版： + +```scala +def makeInt(s: String): Option[Int] = + try + Some(Integer.parseInt(s.trim)) + catch + case e: Exception => None +``` + +这段代码可以理解为，“当给定的字符串转换为整数时，返回包裹在 `Some` 中的 `Int`，例如 `Some(1)`。 +当字符串无法转换为整数时，会抛出并捕获异常，并且该方法返回一个 `None` 值。” + +这些示例展示了 `makeInt` 的工作原理： + +```scala +val a = makeInt("1") // Some(1) +val b = makeInt("one") // None +``` + +如图所示，字符串`"1"`产生一个 `Some(1)`，而字符串 `"one"` 产生一个 `None`。 +这是错误处理的 `Option` 方法的本质。 +如图所示，使用了这种技术，因此方法可以返回 *值* 而不是 *异常*。 +在其他情况下，`Option` 值也用于替换 `null` 值。 + +两个注意事项： + +- 你会发现这种方法在整个 Scala 库类和第三方 Scala 库中使用。 +- 这个例子的一个关键点是函数式方法不会抛出异常；相反，它们返回类似 `Option` 的值。 + +## 成为 makeInt 的消费者 + +现在假设您是 `makeInt` 方法的使用者。 +你知道它返回一个 `Option[Int]` 的子类，所以问题就变成了，你如何处理这些返回类型？ + +根据您的需要，有两个常见的答案： + +- 使用 `match` 表达式 +- 使用 `for` 表达式 + +## 使用 `match` 表达式 + +一种可能的解决方案是使用 `match` 表达式： + +```scala +makeInt(x) match + case Some(i) => println(i) + case None => println("That didn’t work.") +``` + +在本例中，如果 `x` 可以转换为 `Int`，则计算第一个 `case` 子句右侧的表达式；如果 `x` 不能转换为 `Int`，则计算第二个 `case` 子句右侧的表达式。 + +## 使用 `for` 表达式 + +另一种常见的解决方案是使用 `for` 表达式，即本书前面显示的 `for`/`yield` 组合。 +例如，假设您要将三个字符串转换为整数值，然后将它们相加。 +这就是你使用 `for` 表达式和 `makeInt` 的方法： + +```scala +val y = for + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +yield + a + b + c +``` + +在该表达式运行后，`y` 将是以下两种情况之一： + +- 如果*所有*三个字符串都转换为 `Int` 值，`y` 将是 `Some[Int]`，即包裹在 `Some` 中的整数 +- 如果三个字符串中*任意一个*字符串不能转换为 `Int`，则 `y` 将是 `None` + +你可以自己测试一下： + +```scala +val stringA = "1" +val stringB = "2" +val stringC = "3" + +val y = for + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +yield + a + b + c +``` + +使用该样本数据，变量 `y` 的值将是 `Some(6)` 。 + +要查看失败案例，请将这些字符串中的任何一个更改为不会转换为整数的字符串。 +当你这样做时，你会看到 `y` 是 `None`： + +```scala +y: Option[Int] = None +``` + +## 将 Option 视为容器 + +心智模型通常可以帮助我们理解新情况，因此，如果您不熟悉 `Option` 类，可以将它们视为*容器*： + +- `Some` 是一个容器，里面有一个项目 +- `None` 是一个容器，但里面什么都没有 + +如果您更愿意将 `Option` 类想象成一个盒子，`None` 就像一个空盒子。 +它可能有一些东西，但它没有。 + +{% comment %} +NOTE: I commented-out this subsection because it continues to explain Some and None, and I thought it was probably too much for this book. + +## Using `foreach` with `Option` + +Because `Some` and `None` can be thought of containers, they’re also like collections classes. +They have many of the methods you’d expect from a collection class, including `map`, `filter`, `foreach`, etc. + +This raises an interesting question: What will these two values print, if anything? + +```scala +makeInt("1").foreach(println) +makeInt("x").foreach(println) +``` + +Answer: The first example prints the number `1`, and the second example doesn’t print anything. +The first example prints `1` because: + +- `makeInt("1")` evaluates to `Some(1)` +- The expression becomes `Some(1).foreach(println)` +- The `foreach` method on the `Some` class knows how to reach inside the `Some` container and extract the value (`1`) that’s inside it, so it passes that value to `println` + +Similarly, the second example prints nothing because: + +- `makeInt("x")` evaluates to `None` +- The `foreach` method on the `None` class knows that `None` doesn’t contain anything, so it does nothing + +In this regard, `None` is similar to an empty `List`. + +### The happy and unhappy paths + +Somewhere in Scala’s history, someone noted that the first example (the `Some`) represents the “Happy Path” of the `Option` approach, and the second example (the `None`) represents the “Unhappy Path.” +*But* despite having two different possible outcomes, the great thing with `Option` is that there’s really just one path: The code you write to handle the `Some` and `None` possibilities is the same in both cases. +The `foreach` examples look like this: + +```scala +makeInt(aString).foreach(println) +``` + +And the `for` expression looks like this: + +```scala +val y = for + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +yield + a + b + c +``` + +With exceptions you have to worry about handling branching logic, but because `makeInt` returns a value, you only have to write one piece of code to handle both the Happy and Unhappy Paths, and that simplifies your code. + +Indeed, the only time you have to think about whether the `Option` is a `Some` or a `None` is when you handle the result value, such as in a `match` expression: + +```scala +makeInt(x) match + case Some(i) => println(i) + case None => println("That didn't work.") +``` + +> There are several other ways to handle `Option` values. +> See the reference documentation for more details. +{% endcomment %} + +## 使用 `Option` 替换 `null` + +回到 `null` 值，`null` 值可以悄悄地潜入你的代码的地方是这样的类： + +```scala +class Address( + var street1: String, + var street2: String, + var city: String, + var state: String, + var zip: String +) +``` + +虽然地球上的每个地址都有一个 `street1` 值，但 `street2` 值是可选的。 +因此，`street2` 字段可以被分配一个 `null` 值： + +```scala +val santa = Address( + "1 Main Street", + null, // <-- D’oh! A null value! + "North Pole", + "Alaska", + "99705" +) +``` + +从历史上看，开发人员在这种情况下使用了空白字符串和空值，这两种方法都是使用技巧来解决基础性的问题，这个问题是：`street2` 是一个*可选*字段。 +在 Scala 和其他现代语言中，正确的解决方案是预先声明 `street2` 是可选的： + +```scala +class Address( + var street1: String, + var street2: Option[String], // an optional value + var city: String, + var state: String, + var zip: String +) +``` + +现在开发人员可以编写更准确的代码，如下所示： + +```scala +val santa = Address( + "1 Main Street", + None, // 'street2' has no value + "North Pole", + "Alaska", + "99705" +) +``` + +或这个： + +```scala +val santa = Address( + "123 Main Street", + Some("Apt. 2B"), + "Talkeetna", + "Alaska", + "99676" +) +``` + +## `Option` 不是唯一的解决方案 + +虽然本节关注的是 `Option` 类，但 Scala 还有一些其他选择。 + +例如，称为 `Try`/`Success`/`Failure` 的三个类以相同的方式工作，但是 (a) 当您的代码可以抛出异常时，您主要使用这些类，并且 (b) 您想要使用`Failure` 类，因为它使您可以访问异常消息。 +例如，在编写与文件、数据库和 Internet 服务交互的方法时，通常会使用这些 `Try` 类，因为这些函数很容易引发异常。 + +## 快速回顾 + +这部分很长，让我们快速回顾一下： + +- 函数式程序员不使用 `null` 值 +- `null` 值的主要替代品是使用 `Option` 类 +- 函数式方法不会抛出异常； 相反，它们返回诸如 `Option` 、 `Try` 或 `Either` 之类的值 +- 使用 `Option` 值的常用方法是 `match` 和 `for` 表达式 +- Option 可以被认为是一个项目（`Some`）和没有项目（`None`）的容器 +- option 也可用于可选的构造函数或方法参数 + diff --git a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md new file mode 100644 index 0000000000..a4e3c6df72 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md @@ -0,0 +1,99 @@ +--- +title: 函数是值 +type: section +description: This section looks at the use of functions as values in functional programming. +num: 44 +previous-page: fp-pure-functions +next-page: fp-functional-error-handling +--- + + +虽然曾经创建的每种编程语言都可能允许您编写纯函数，但 Scala FP 的第二个重要特性是*您可以将函数创建为值*，就像您创建 `String` 和 `Int` 值一样。 + +这个特性有很多好处，其中最常见的是（a）您可以定义方法来接受函数参数，以及（b）您可以将函数作为参数传递给方法。 +你已经在本书的多个地方看到了这一点，每当演示像 `map` 和 `filter` 这样的方法时： + +```scala +val nums = (1 to 10).toList + +val doubles = nums.map(_ * 2) // double each value +val lessThanFive = nums.filter(_ < 5) // List(1,2,3,4) +``` + +在这些示例中，匿名函数被传递到 `map` 和 `filter` 中。 + +> 匿名函数也称为 *lambdas*。 + +除了将匿名函数传递给 `filter` 和 `map` 之外，您还可以为它们提供 *方法*： + +```scala +// two methods +def double(i: Int): Int = i * 2 +def underFive(i: Int): Boolean = i < 5 + +// pass those methods into filter and map +val doubles = nums.filter(underFive).map(double) +``` + +这种将方法和函数视为值的能力是函数式编程语言提供的强大特性。 + +> 从技术上讲，将另一个函数作为输入参数的函数称为 *高阶函数*。 +> （如果你喜欢幽默，就像有人曾经写过的那样，这就像说一个将另一个类的实例作为构造函数参数的类是一个高阶类。） + +## 函数、匿名函数和方法 + +正如您在这些示例中看到的，这是一个匿名函数： + +```scala +_ * 2 +``` + +如 [高阶函数][hofs] 讨论中所示，上面的写法是下面语法的简写版本： + +```scala +(i: Int) => i * 2 +``` + +像这样的函数被称为“匿名”，因为它们没有名字。 +如果你想给一个名字，只需将它分配给一个变量： + +```scala +val double = (i: Int) => i * 2 +``` + +现在你有了一个命名函数，一个分配给变量的函数。 +您可以像使用方法一样使用此函数： + +```scala +double(2) // 4 +``` + +在大多数情况下，`double` 是函数还是方法并不重要。 Scala 允许您以同样的方式对待它们。 +在幕后，让您像对待函数一样对待方法的 Scala 技术被称为 [Eta 表达式][eta]。 + +这种将函数作为变量无缝传递的能力是 Scala 等函数式编程语言的一个显着特征。 +正如您在本书中的 `map` 和 `filter` 示例中所见，将函数传递给其他函数的能力有助于您创建简洁且仍然可读的代码---*富有表现力*。 + +如果您对将函数作为参数传递给其他函数的过程不适应，可以尝试以下几个示例： + +```scala +List("bob", "joe").map(_.toUpperCase) // List(BOB, JOE) +List("bob", "joe").map(_.capitalize) // List(Bob, Joe) +List("plum", "banana").map(_.length) // List(4, 6) + +val fruits = List("apple", "pear") +fruits.map(_.toUpperCase) // List(APPLE, PEAR) +fruits.flatMap(_.toUpperCase) // List(A, P, P, L, E, P, E, A, R) + +val nums = List(5, 1, 3, 11, 7) +nums.map(_ * 2) // List(10, 2, 6, 22, 14) +nums.filter(_ > 3) // List(5, 11, 7) +nums.takeWhile(_ < 6) // List(5, 1, 3) +nums.sortWith(_ < _) // List(1, 3, 5, 7, 11) +nums.sortWith(_ > _) // List(11, 7, 5, 3, 1) + +nums.takeWhile(_ < 6).sortWith(_ < _) // List(1, 3, 5) +``` + +[hofs]: {% link _overviews/scala3-book/fun-hofs.md %} +[eta]: {% link _overviews/scala3-book/fun-eta-expansion.md %} diff --git a/_zh-cn/overviews/scala3-book/fp-immutable-values.md b/_zh-cn/overviews/scala3-book/fp-immutable-values.md new file mode 100644 index 0000000000..d176af3a75 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fp-immutable-values.md @@ -0,0 +1,70 @@ +--- +title: 不可变值 +type: section +description: This section looks at the use of immutable values in functional programming. +num: 42 +previous-page: fp-what-is-fp +next-page: fp-pure-functions +--- + + +在纯函数式编程中，只使用不可变的值。 +在 Scala 中，这意味着： + +- 所有变量都创建为 `val` 字段 +- 仅使用不可变的集合类，例如 `List`、`Vector` 和不可变的 `Map` 和 `Set` 类 + +只使用不可变变量会引发一个有趣的问题：如果一切都是不可变的，那么任何东西都如何改变？ + +当谈到使用集合时，一个答案是你不会改变现有的集合。相反，您将函数应用于现有集合以创建新集合。 +这就是像 `map` 和 `filter` 这样的高阶函数的用武之地。 + +例如，假设你有一个名字列表——一个 `List[String]`——都是小写的，你想找到所有以字母 `"j"` 开头的名字，并且把找出来的名字大写。 +在 FP 中，您编写以下代码： + +```scala +val a = List("jane", "jon", "mary", "joe") +val b = a.filter(_.startsWith("j")) + .map(_.capitalize) +``` + +如图所示，您不会改变原始列表 `a`。 +相反，您将过滤和转换函数应用于 `a` 以创建一个新集合，并将该结果分配给新的不可变变量 `b` 。 + +同样，在 FP 中，您不会创建具有可变 `var` 构造函数参数的类。 +也就是说，你不要这样写： + +```scala +```scala +// don’t do this in FP +class Person(var firstName: String, var lastName: String) + --- --- +``` + +相反，您通常创建 `case` 类，其构造函数参数默认为 `val`： + +```scala +case class Person(firstName: String, lastName: String) +``` + +现在你创建一个 `Person` 实例作为 `val` 字段： + +```scala +val reginald = Person("Reginald", "Dwight") +``` + +然后，当您需要对数据进行更改时，您可以使用 `case` 类附带的 `copy` 方法来“在制作副本时更新数据”，如下所示： + +```scala +val elton = reginald.copy( + firstName = "Elton", // update the first name + lastName = "John" // update the last name +) +``` + +还有其他处理不可变集合和变量的技术，但希望这些示例能让您尝试一下这些技术。 + +> 根据您的需要，您可以创建枚举、traits 或类，而不是 `case` 类。 +> 有关详细信息，请参阅[数据建模][modeling]一章。 + +[modeling]: {% link _overviews/scala3-book/domain-modeling-intro.md %} diff --git a/_zh-cn/overviews/scala3-book/fp-intro.md b/_zh-cn/overviews/scala3-book/fp-intro.md new file mode 100644 index 0000000000..83e1c6c08e --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fp-intro.md @@ -0,0 +1,24 @@ +--- +title: 函数式编程 +type: chapter +description: This chapter provides an introduction to functional programming in Scala 3. +num: 40 +previous-page: collections-summary +next-page: fp-what-is-fp +--- + + +Scala 允许您以面向对象编程 (OOP) 风格、函数式编程 (FP) 风格以及混合风格编写代码——结合使用这两种方法。 +[正如 Martin Odersky 所说](https://twitter.com/alexelcu/status/996408359514525696)，Scala 的本质是在类型化设置中融合了函数式编程和面向对象编程： + +- 逻辑函数 +- 模块化的对象 + +本章假设您熟悉 OOP 而不太熟悉 FP，因此它简要介绍了几个主要的函数式编程概念： + +- 什么是函数式编程？ +- 不可变值 +- 纯函数 +- 函数是值 +- 函数式错误处理 + diff --git a/_zh-cn/overviews/scala3-book/fp-pure-functions.md b/_zh-cn/overviews/scala3-book/fp-pure-functions.md new file mode 100644 index 0000000000..3a88f34431 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fp-pure-functions.md @@ -0,0 +1,106 @@ +--- +title: 纯函数 +type: section +description: This section looks at the use of pure functions in functional programming. +num: 43 +previous-page: fp-immutable-values +next-page: fp-functions-are-values +--- + + +Scala 提供的另一个帮助您编写函数式代码的特性是编写纯函数的能力。 +一个_纯函数_可以这样定义： + +- 函数 `f` 是纯函数，如果给定相同的输入 `x`，它总是返回相同的输出 `f(x)` +- 函数的输出_只_取决于它的输入变量和它的实现 +- 它只计算输出而不修改周围的世界 + +这意味着： +- 它不修改其输入参数 +- 它不会改变任何隐藏状态 +- 没有任何“后门”：不从外界读取数据（包括控制台、Web服务、数据库、文件等），也不向外界写入数据 + +作为这个定义的结果，任何时候你调用一个具有相同输入值的纯函数，你总是会得到相同的结果。 +例如，您可以使用输入值 `2` 无限次调用 `double` 函数，并且始终得到结果 `4`。 + +## 纯函数示例 + +给定这个定义，你可以想象， *scala.math._* 包中的这些方法是纯函数： + +- `abs` +- `ceil` +- `max` + +这些 `String` 方法也是纯函数： + +-`isEmpty` +- `length` +- `substring` + +Scala 集合类上的大多数方法也可以作为纯函数工作，包括 `drop`、`filter`、`map` 等等。 + +> 在 Scala 中，_函数_和_方法_几乎可以完全互换，因此即使我们使用行业通用术语“纯函数”，这个术语也可以用来描述函数和方法。 +> 如果您对如何像函数一样使用方法感兴趣，请参阅 [Eta 表达式][eta] 的讨论。 + +## 不纯函数示例 + +相反，以下函数是_不纯的_，因为它们违反了纯函数的定义。 + +- `println` -- 与控制台、文件、数据库、Web 服务、传感器等交互的方法都是不纯的。 +- `currentTimeMillis ` -- 与日期和时间相关的方法都是不纯的，因为它们的输出取决于输入参数以外的其他东西 +- `sys.error` -- 异常抛出方法是不纯的，因为它们不简单地返回结果 + +不纯函数通常会执行以下一项或多项操作： + +- 从隐藏状态读取，即它们访问的变量和数据不是作为输入参数明确地传递给函数 +- 写入隐藏状态 +- 改变他们给定的参数，或改变隐藏变量，例如类中包涵的字段 +- 与外界执行某种 I/O + +> 通常，您应该注意返回类型为 `Unit` 的函数。 +> 因为这些函数不返回任何东西，逻辑上你调用它的唯一原因是实现一些副作用。 +> 因此，这些功能的使用通常是不纯的。 + +## 但是需要不纯的函数... + +当然，如果一个应用程序不能读取或写入外部世界，它就不是很有用，所以人们提出以下建议： + +> 使用纯函数编写应用程序的核心，然后围绕该核心编写一个不纯的“包装器”以与外部世界交互。 +> 正如有人曾经说过的，这就像在纯蛋糕上加了一层不纯的糖霜。 + +重要的是要注意，有一些方法可以让与外界的不纯粹互动感觉更纯粹。 +例如，你会听说使用 `IO` Monad 来处理输入和输出。 +这些主题超出了本文档的范围，所以为了简单起见，这样认识 FP 会有所帮助：FP 应用程序有一个纯函数核心，还有其他一些函数把这些纯函数包装起来与外部世界交互。 + +## 编写纯函数 + +**注意**：在本节中，常见的行业术语“纯函数”通常用于指代 Scala 方法。 + +要在 Scala 中编写纯函数，只需使用 Scala 的方法语法编写它们（尽管您也可以使用 Scala 的函数语法）。 +例如，这是一个将给定输入值加倍的纯函数： + +```scala +def double(i: Int): Int = i * 2 +``` + +如果您对递归感到满意，这是一个计算整数列表之和的纯函数： + +```scala +def sum(xs: List[Int]): Int = xs match + case Nil => 0 + case head :: tail => head + sum(tail) +``` + +如果您理解该代码，您会发现它符合纯函数定义。 + +## 要点 + +本节的第一个要点是纯函数的定义： + +> _纯函数_是仅依赖于其声明的输入及其实现来产生其输出的函数。 +> 它只计算其输出，不依赖或修改外部世界。 + +第二个要点是每个现实世界的应用程序都与外部世界交互。 +因此，考虑函数式程序的一种简化方法是，它们由一个纯函数核心组成，其他一些函数把这些纯函数包装起来与外部世界交互。 + +[eta]: {% link _overviews/scala3-book/fun-eta-expansion.md %} diff --git a/_zh-cn/overviews/scala3-book/fp-summary.md b/_zh-cn/overviews/scala3-book/fp-summary.md new file mode 100644 index 0000000000..47a3019a51 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fp-summary.md @@ -0,0 +1,24 @@ +--- +title: 总结 +type: section +description: This section summarizes the previous functional programming sections. +num: 46 +previous-page: fp-functional-error-handling +next-page: types-introduction +--- + + +本章在比较高的层次上，对 Scala 中的函数式编程进行了介绍。 +涵盖的主题是： + +- 什么是函数式编程？ +- 不可变值 +- 纯函数 +- 函数是值 +- 函数式错误处理 + +如前所述，函数式编程是一个很大的话题，所以我们在本书中所能做的就是触及这些介绍性概念。 +有关详细信息，请参阅 [参考文档][reference]。 + +[reference]: {{ site.scala3ref }}/overview.html + diff --git a/_zh-cn/overviews/scala3-book/fp-what-is-fp.md b/_zh-cn/overviews/scala3-book/fp-what-is-fp.md new file mode 100644 index 0000000000..314b39fce5 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/fp-what-is-fp.md @@ -0,0 +1,27 @@ +--- +title: 什么是函数式编程？ +type: section +description: This section provides an answer to the question, what is functional programming? +num: 41 +previous-page: fp-intro +next-page: fp-immutable-values +--- + + +[维基百科定义_函数式编程_](https://en.wikipedia.org/wiki/Functional_programming)如下： + +
      +

      函数式编程是一种编程范式，通过应用和组合函数来构建程序。 +它是一种声明式编程范例，其中函数定义是表达式树，每个表达式都返回一个值，而不是改变程序状态的命令式语句序列。

      +

       

      +

      在函数式编程中，函数被视为一等公民，这意味着它们可以绑定到名称（包括本地标识符）、作为参数传递以及从其他函数返回，就像任何其他数据类型一样。 +这允许以声明式和可组合的方式编写程序，其中小函数以模块化方式组合。

      +
      + +知道这样的情况对你很有帮助：有经验的函数式程序员非常倾向于将他们的代码视为数学，将纯函数组合在一起就像组合一系列代数方程一样。 + +当你编写函数式代码时，你会感觉自己像个数学家，一旦你理解了范式，你就会想编写总是返回_值_---而不是异常或空值---的纯函数，这样你就可以将它们组合（结合）在一起以创建解决方案。 +编写类似数学的方程式（表达式）的感觉是驱使您_只_使用纯函数和不可变值的动力，因为这就是您在代数和其他形式的数学中使用的东西。 + +函数式编程是一个很大的主题，没有简单的方法可以将整个主题浓缩为一章，但希望以下部分能够概述主要主题，并展示 Scala 为编写函数式代码提供的一些工具。 + From f4607af6349c70ab6c6c5f593af64ee4756fe7f8 Mon Sep 17 00:00:00 2001 From: vegchic Date: Sun, 29 May 2022 22:08:25 +0800 Subject: [PATCH 1891/3075] 2.13 collections doc: fix wrong link to arrays.html --- .../collections-2.13/concrete-mutable-collection-classes.md | 4 ++-- .../collections-2.13/concrete-mutable-collection-classes.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_overviews/collections-2.13/concrete-mutable-collection-classes.md b/_overviews/collections-2.13/concrete-mutable-collection-classes.md index 883d1978ca..82715e2f55 100644 --- a/_overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -107,7 +107,7 @@ It is supported by class [mutable.Stack](https://www.scala-lang.org/api/{{ site. Array sequences are mutable sequences of fixed size which store their elements internally in an `Array[Object]`. They are implemented in Scala by class [ArraySeq](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArraySeq.html). -You would typically use an `ArraySeq` if you want an array for its performance characteristics, but you also want to create generic instances of the sequence where you do not know the type of the elements and you do not have a `ClassTag` to provide it at run-time. These issues are explained in the section on [arrays]({{ site.baseurl }}/overviews/collections/arrays.html). +You would typically use an `ArraySeq` if you want an array for its performance characteristics, but you also want to create generic instances of the sequence where you do not know the type of the elements and you do not have a `ClassTag` to provide it at run-time. These issues are explained in the section on [arrays](arrays.html). ## Hash Tables @@ -145,7 +145,7 @@ A concurrent map can be accessed by several threads at once. In addition to the | `m.replace(k, old, new)` |Replaces value associated with key `k` to `new`, if it was previously bound to `old`. | | `m.replace (k, v)` |Replaces value associated with key `k` to `v`, if it was previously bound to some value.| -`concurrent.Map` is a trait in the Scala collections library. Currently, it has two implementations. The first one is Java's `java.util.concurrent.ConcurrentMap`, which can be converted automatically into a Scala map using the [standard Java/Scala collection conversions]({{ site.baseurl }}/overviews/collections/conversions-between-java-and-scala-collections.html). The second implementation is [TrieMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), which is a lock-free implementation of a hash array mapped trie. +`concurrent.Map` is a trait in the Scala collections library. Currently, it has two implementations. The first one is Java's `java.util.concurrent.ConcurrentMap`, which can be converted automatically into a Scala map using the [standard Java/Scala collection conversions](conversions-between-java-and-scala-collections.html). The second implementation is [TrieMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), which is a lock-free implementation of a hash array mapped trie. ## Mutable Bitsets diff --git a/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md b/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md index a65910b05a..1e215bb7ea 100644 --- a/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -102,7 +102,7 @@ Scala предоставляет не только неизменяемые, н Последовательные массивы - это изменяемые массивы со свойствами последовательности фиксированного размера, которые хранят свои элементы внутри `Array[Object]`. Они реализованы в Scala классом [ArraySeq](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArraySeq.html). -Вам стоит использовать `ArraySeq`, если вам нужен массив из-за его показателей производительности, но вы дополнительно хотите использовать обобщеные экземпляры последовательности, в которых вы не знаете тип элементов и у которого нет `ClassTag` который будет предоставлен непосредственно во время исполнения. Эти аспекты рассматриваются в разделе [arrays]({{ site.baseurl }}/overviews/collections/arrays.html). +Вам стоит использовать `ArraySeq`, если вам нужен массив из-за его показателей производительности, но вы дополнительно хотите использовать обобщеные экземпляры последовательности, в которых вы не знаете тип элементов и у которого нет `ClassTag` который будет предоставлен непосредственно во время исполнения. Эти аспекты рассматриваются в разделе [arrays](arrays.html). ## Hash Tables (Хэш Таблицы) @@ -140,7 +140,7 @@ Scala предоставляет не только неизменяемые, н | `m.replace(k, old, new)` |Заменяет значение, связанное с ключом `k` на `new`, если ранее оно было равно `old`. | | `m.replace (k, v)` | Заменяет значение, связанное с ключом `k` на `v`, если ранее значение вообще существовало.| -`concurrent.Map` это трейт в библиотеке коллекций Scala. В настоящее время он реализуется двумя способами. Первый - через Java мапу `java.util.concurrent.ConcurrentMap`, который может быть автоматически преобразован в Scala мапу с помощью [стандартного механизма преобразования Java/Scala коллекций]({{ site.baseurl }}/overviews/collections/conversions-between-java-and-scala-collections.html). Вторая реализация через [TrieMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), которая представляет из себя не блокируемую хэш-таблицу привязанную к дереву. +`concurrent.Map` это трейт в библиотеке коллекций Scala. В настоящее время он реализуется двумя способами. Первый - через Java мапу `java.util.concurrent.ConcurrentMap`, который может быть автоматически преобразован в Scala мапу с помощью [стандартного механизма преобразования Java/Scala коллекций](conversions-between-java-and-scala-collections.html). Вторая реализация через [TrieMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), которая представляет из себя не блокируемую хэш-таблицу привязанную к дереву. ## Mutable Bitsets (Изменяемый Битовый Набор) From f0a5b4a8bcd6fee4f986f119857c4c4d0cedc937 Mon Sep 17 00:00:00 2001 From: vegchic Date: Sun, 29 May 2022 22:37:18 +0800 Subject: [PATCH 1892/3075] navigation-menu: fix wrong style --- _sass/layout/doc-navigation.scss | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sass/layout/doc-navigation.scss b/_sass/layout/doc-navigation.scss index 7fa75f5d6a..7539881c3f 100644 --- a/_sass/layout/doc-navigation.scss +++ b/_sass/layout/doc-navigation.scss @@ -65,7 +65,7 @@ $nav-height: 46px; position: absolute; margin-top: 10px; display: none; - z-index: 1; + z-index: 40; box-shadow: 0 3px 12px rgba(0, 0, 0, 0.15); @include bp(medium) { From 86a356f909a1d276a727347d3b75e2d144844744 Mon Sep 17 00:00:00 2001 From: Artem Korsakov Date: Mon, 30 May 2022 08:21:01 +0300 Subject: [PATCH 1893/3075] Rename deprecated annotation in the doc [scala.annotation.alpha is deprecated](https://scala-lang.org/api/3.x/scala/annotation/alpha.html) We must use `@targetName` instead --- _overviews/scala3-book/interacting-with-java.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-book/interacting-with-java.md b/_overviews/scala3-book/interacting-with-java.md index 5b0b99286b..300ebed689 100644 --- a/_overviews/scala3-book/interacting-with-java.md +++ b/_overviews/scala3-book/interacting-with-java.md @@ -341,10 +341,10 @@ def +(a: Int, b: Int) = a + b That method name won’t work well in Java, but what you can do in Scala 3 is provide an “alternate” name for the method---an alias---that will work in Java: ```scala -import scala.annotation.alpha +import scala.annotation.targetName class Adder: - @alpha("add") def +(a: Int, b: Int) = a + b + @targetName("add") def +(a: Int, b: Int) = a + b ``` Now in your Java code you can use the aliased method name `add`: From d75b4e0d70619802f6b7c10119cabdf631494a08 Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Thu, 26 May 2022 19:07:08 +0300 Subject: [PATCH 1894/3075] Add Ukrainian index page. Roman review fixes --- _config.yml | 3 ++ _uk/index.md | 128 +++++++++++++++++++++++++++++++++++++++++++++++++++ index.md | 2 +- 3 files changed, 132 insertions(+), 1 deletion(-) create mode 100644 _uk/index.md diff --git a/_config.yml b/_config.yml index 4f559b2295..9d756807cd 100644 --- a/_config.yml +++ b/_config.yml @@ -85,6 +85,9 @@ collections: th: # Thai translations output: true permalink: /:collection/:path.html + uk: # Ukrainian translations + output: true + permalink: /:collection/:path.html defaults: - diff --git a/_uk/index.md b/_uk/index.md new file mode 100644 index 0000000000..211050d3f1 --- /dev/null +++ b/_uk/index.md @@ -0,0 +1,128 @@ +--- +layout: documentation +title: Документація +language: uk +partof: documentation +discourse: true +more-resources-label: Додаткові Матеріали + + +# Content masthead links + + +scala3-sections: + - title: "Перші кроки" + links: + - title: "Нове у Scala 3" + description: "Огляд нових функцій у Scala 3." + icon: "fa fa-star" + link: /scala3/new-in-scala3.html + - title: "Початок роботи" + description: "Встанови Scala 3 на свій комп'ютер і почни писати код Scala!" + icon: "fa fa-rocket" + link: /scala3/getting-started.html + - title: "Книга по Scala 3" + description: "Вивчи Scala, прочитавши серію коротких уроків." + icon: "fa fa-book-open" + link: /scala3/book/introduction.html + - title: "Детальніше" + links: + - title: "Посібник з міграції" + description: "Посібник, що допоможе перейти від Scala 2 до Scala 3." + icon: "fa fa-suitcase" + link: /scala3/guides/migration/compatibility-intro.html + - title: "Посібники" + description: "Детальні посібники про окремі аспекти мови." + icon: "fa fa-map" + link: /scala3/guides.html + - title: "API бібліотек Scala" + description: "Документація API для кожної версії стандартної бібліотеки Scala 3." + icon: "fa fa-file-alt" + link: https://scala-lang.org/api/3.x/ + - title: "Довідник про мову" + description: "Довідкова інформація про мову Scala 3." + icon: "fa fa-book" + link: https://docs.scala-lang.org/scala3/reference + - title: "Зробити внесок у Scala 3" + description: "Посібник з компілятора Scala 3 та вирішення проблем." + icon: "fa fa-cogs" + link: /scala3/guides/contribution/contribution-intro.html + - title: "Новий Scaladoc для Scala 3" + description: "Основні характеристики нових функцій у Scaladoc." + icon: "fa fa-star" + link: /scala3/scaladoc.html + - title: "Доповіді" + description: "Онлайн доповіді про Scala 3." + icon: "fa fa-play-circle" + link: /scala3/talks.html + - title: "Онлайн курси" + description: "MOOC для вивчення Scala для початківців і досвідчених програмістів." + icon: "fa fa-cloud" + link: /online-courses.html + +scala2-sections: + - title: "Перші кроки..." + links: + - title: "Початок роботи" + description: "Встанови Scala на свій комп'ютер і почни писати код Scala!" + icon: "fa fa-rocket" + link: /getting-started.html + - title: "Екскурсія по Скала" + description: "Короткі введення в основні особливості мови." + icon: "fa fa-flag" + link: /tour/tour-of-scala.html + - title: "Книга по Scala" + description: "Вивчи Scala, прочитавши серію коротких уроків." + icon: "fa fa-book-open" + link: /overviews/scala-book/introduction.html + - title: "Онлайн курси" + description: "MOOC для вивчення Scala для початківців і досвідчених програмістів." + icon: "fa fa-cloud" + link: /online-courses.html + - title: "Книги" + description: "Друковані та цифрові книги по Scala." + icon: "fa fa-book" + link: /books.html + - title: "Посібники" + description: "Путівник з серії кроків для створення програм на Scala." + icon: "fa fa-tasks" + link: /tutorials.html + + - title: "Для досвічених" + links: + - title: "API" + description: "Документація API для кожної версії Scala." + icon: "fa fa-file-alt" + link: /api/all.html + - title: "Посібники та огляди" + description: "Поглиблена документація, що покриває багато особливостей Scala." + icon: "fa fa-database" + link: /overviews/index.html + - title: "Довідник по стилю" + description: "Поглиблений посібник з написання ідіоматичного коду на Scala." + icon: "fa fa-bookmark" + link: /style/index.html + - title: "Шпаргалка" + description: "Зручна шпаргалка з основ синтаксису Scala." + icon: "fa fa-list" + link: /cheatsheets/index.html + - title: "Питання-Відповіді" + description: "Відповіді на часті запитання про Scala." + icon: "fa fa-question-circle" + link: /tutorials/FAQ/index.html + - title: "Специфікація мови" + description: "Специфікація формальної мови Scala." + icon: "fa fa-book" + link: https://scala-lang.org/files/archive/spec/2.13/ + + - title: "Еволюція Scala" + links: + - title: "SIPs" + description: "Процес удосконалення Scala (Scala Improvement Process). Еволюція мови та компілятора." + icon: "fa fa-cogs" + link: /sips/index.html + - title: "Внесок у Scala" + description: "Повний посібник із участі в проекті Scala." + icon: "fa fa-cogs" + link: /contribute/ +--- diff --git a/index.md b/index.md index 774df86279..7990a48ba5 100644 --- a/index.md +++ b/index.md @@ -1,6 +1,6 @@ --- layout: documentation -languages: [ja, zh-cn, ru] +languages: [ja, zh-cn, ru, uk] title: Documentation namespace: root discourse: true From eaee767fea68d9d24dcebad3c9f1ac0f8b0e4abd Mon Sep 17 00:00:00 2001 From: HughKu Date: Wed, 1 Jun 2022 22:16:12 +0200 Subject: [PATCH 1895/3075] doc(overview): fix typo --- _overviews/scala3-book/scala-for-python-devs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index 320bb80ecf..579095ae1c 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -1313,7 +1313,7 @@ sbt compile automatically resolves all dependencies for that particular project. The location of downloaded dependencies is largely an implementation detail of the build tool, and users do not have to interact with these downloaded dependencies directly. For example, if we delete the whole sbt dependencies cache, on the next compilation of the project, sbt simply resolves and downloads all the required dependencies again, automatically. -This differs from Python, were by default dependencies are installed in system-wide or user-wide directories, so to obtain an isolated environment on a per-project basis one has to create a corresponding virtual environment. For example, using the `venv` module, we might create one for a particular project like so +This differs from Python, where by default dependencies are installed in system-wide or user-wide directories, so to obtain an isolated environment on a per-project basis one has to create a corresponding virtual environment. For example, using the `venv` module, we might create one for a particular project like so ``` cd myapp From b9415eeea40bcf105fbeeaccc97f3574c9d16354 Mon Sep 17 00:00:00 2001 From: vegchic Date: Thu, 2 Jun 2022 11:12:44 +0800 Subject: [PATCH 1896/3075] replaced by wiser link --- .../collections-2.13/concrete-immutable-collection-classes.md | 2 +- .../collections-2.13/concrete-mutable-collection-classes.md | 4 ++-- _overviews/collections-2.13/seqs.md | 2 +- _overviews/collections-2.13/sets.md | 2 +- _overviews/collections-2.13/trait-iterable.md | 2 +- .../collections-2.13/concrete-immutable-collection-classes.md | 2 +- .../collections-2.13/concrete-mutable-collection-classes.md | 4 ++-- _ru/overviews/collections-2.13/seqs.md | 2 +- _ru/overviews/collections-2.13/sets.md | 2 +- _ru/overviews/collections-2.13/trait-iterable.md | 2 +- 10 files changed, 12 insertions(+), 12 deletions(-) diff --git a/_overviews/collections-2.13/concrete-immutable-collection-classes.md b/_overviews/collections-2.13/concrete-immutable-collection-classes.md index 166f3e280d..152605d760 100644 --- a/_overviews/collections-2.13/concrete-immutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-immutable-collection-classes.md @@ -77,7 +77,7 @@ res27: scala.collection.immutable.ArraySeq[Int] = ArraySeq(1, 2, 3) As the last line above shows, a call to `updated` has no effect on the original ArraySeq `arr`. -ArraySeqs store their elements in a private [Array](arrays.html). This is a compact representation that supports fast +ArraySeqs store their elements in a private [Array]({% link _overviews/collections-2.13/arrays.md %}). This is a compact representation that supports fast indexed access, but updating or adding one element is linear since it requires creating another array and copying all the original array’s elements. diff --git a/_overviews/collections-2.13/concrete-mutable-collection-classes.md b/_overviews/collections-2.13/concrete-mutable-collection-classes.md index 82715e2f55..ddc5daf609 100644 --- a/_overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -107,7 +107,7 @@ It is supported by class [mutable.Stack](https://www.scala-lang.org/api/{{ site. Array sequences are mutable sequences of fixed size which store their elements internally in an `Array[Object]`. They are implemented in Scala by class [ArraySeq](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArraySeq.html). -You would typically use an `ArraySeq` if you want an array for its performance characteristics, but you also want to create generic instances of the sequence where you do not know the type of the elements and you do not have a `ClassTag` to provide it at run-time. These issues are explained in the section on [arrays](arrays.html). +You would typically use an `ArraySeq` if you want an array for its performance characteristics, but you also want to create generic instances of the sequence where you do not know the type of the elements and you do not have a `ClassTag` to provide it at run-time. These issues are explained in the section on [arrays]({% link _overviews/collections-2.13/arrays.md %}). ## Hash Tables @@ -145,7 +145,7 @@ A concurrent map can be accessed by several threads at once. In addition to the | `m.replace(k, old, new)` |Replaces value associated with key `k` to `new`, if it was previously bound to `old`. | | `m.replace (k, v)` |Replaces value associated with key `k` to `v`, if it was previously bound to some value.| -`concurrent.Map` is a trait in the Scala collections library. Currently, it has two implementations. The first one is Java's `java.util.concurrent.ConcurrentMap`, which can be converted automatically into a Scala map using the [standard Java/Scala collection conversions](conversions-between-java-and-scala-collections.html). The second implementation is [TrieMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), which is a lock-free implementation of a hash array mapped trie. +`concurrent.Map` is a trait in the Scala collections library. Currently, it has two implementations. The first one is Java's `java.util.concurrent.ConcurrentMap`, which can be converted automatically into a Scala map using the [standard Java/Scala collection conversions]({% link _overviews/collections-2.13/conversions-between-java-and-scala-collections.md %}). The second implementation is [TrieMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), which is a lock-free implementation of a hash array mapped trie. ## Mutable Bitsets diff --git a/_overviews/collections-2.13/seqs.md b/_overviews/collections-2.13/seqs.md index 1cd8ebfc7b..712f28002f 100644 --- a/_overviews/collections-2.13/seqs.md +++ b/_overviews/collections-2.13/seqs.md @@ -75,7 +75,7 @@ If a sequence is mutable, it offers in addition a side-effecting `update` method | `xs.distinct` |A subsequence of `xs` that contains no duplicated element.| | `xs distinctBy f` |A subsequence of `xs` that contains no duplicated element after applying the transforming function `f`. For instance, `List("foo", "bar", "quux").distinctBy(_.length) == List("foo", "quux")`| -Trait [Seq](https://www.scala-lang.org/api/current/scala/collection/Seq.html) has two subtraits [LinearSeq](https://www.scala-lang.org/api/current/scala/collection/LinearSeq.html), and [IndexedSeq](https://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html). These do not add any new operations to the immutable branch, but each offers different performance characteristics: A linear sequence has efficient `head` and `tail` operations, whereas an indexed sequence has efficient `apply`, `length`, and (if mutable) `update` operations. Frequently used linear sequences are `scala.collection.immutable.List` and `scala.collection.immutable.LazyList`. Frequently used indexed sequences are `scala.Array` and `scala.collection.mutable.ArrayBuffer`. The `Vector` class provides an interesting compromise between indexed and linear access. It has both effectively constant time indexing overhead and constant time linear access overhead. Because of this, vectors are a good foundation for mixed access patterns where both indexed and linear accesses are used. You'll learn more on vectors [later](concrete-immutable-collection-classes.html). +Trait [Seq](https://www.scala-lang.org/api/current/scala/collection/Seq.html) has two subtraits [LinearSeq](https://www.scala-lang.org/api/current/scala/collection/LinearSeq.html), and [IndexedSeq](https://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html). These do not add any new operations to the immutable branch, but each offers different performance characteristics: A linear sequence has efficient `head` and `tail` operations, whereas an indexed sequence has efficient `apply`, `length`, and (if mutable) `update` operations. Frequently used linear sequences are `scala.collection.immutable.List` and `scala.collection.immutable.LazyList`. Frequently used indexed sequences are `scala.Array` and `scala.collection.mutable.ArrayBuffer`. The `Vector` class provides an interesting compromise between indexed and linear access. It has both effectively constant time indexing overhead and constant time linear access overhead. Because of this, vectors are a good foundation for mixed access patterns where both indexed and linear accesses are used. You'll learn more on vectors [later]({% link _overviews/collections-2.13/concrete-immutable-collection-classes.md %}). On the mutable branch, `IndexedSeq` adds operations for transforming its elements in place (by contrast with transformation operations such as `map` and `sort`, available on the root `Seq`, which return a new collection diff --git a/_overviews/collections-2.13/sets.md b/_overviews/collections-2.13/sets.md index 96984d34f3..835c4a45eb 100644 --- a/_overviews/collections-2.13/sets.md +++ b/_overviews/collections-2.13/sets.md @@ -108,7 +108,7 @@ Comparing the two interactions shows an important principle. You often can repla Mutable sets also provide add and remove as variants of `+=` and `-=`. The difference is that `add` and `remove` return a Boolean result indicating whether the operation had an effect on the set. -The current default implementation of a mutable set uses a hashtable to store the set's elements. The default implementation of an immutable set uses a representation that adapts to the number of elements of the set. An empty set is represented by just a singleton object. Sets of sizes up to four are represented by a single object that stores all elements as fields. Beyond that size, immutable sets are implemented as [Compressed Hash-Array Mapped Prefix-tree](concrete-immutable-collection-classes.html). +The current default implementation of a mutable set uses a hashtable to store the set's elements. The default implementation of an immutable set uses a representation that adapts to the number of elements of the set. An empty set is represented by just a singleton object. Sets of sizes up to four are represented by a single object that stores all elements as fields. Beyond that size, immutable sets are implemented as [Compressed Hash-Array Mapped Prefix-tree]({% link _overviews/collections-2.13/concrete-immutable-collection-classes.md %}). A consequence of these representation choices is that, for sets of small sizes (say up to 4), immutable sets are usually more compact and also more efficient than mutable sets. So, if you expect the size of a set to be small, try making it immutable. diff --git a/_overviews/collections-2.13/trait-iterable.md b/_overviews/collections-2.13/trait-iterable.md index edc2ef2b1f..bd219ec746 100644 --- a/_overviews/collections-2.13/trait-iterable.md +++ b/_overviews/collections-2.13/trait-iterable.md @@ -32,7 +32,7 @@ Collection classes that implement `Iterable` just need to define this method; al * **Folds** `foldLeft`, `foldRight`, `reduceLeft`, `reduceRight` which apply a binary operation to successive elements. * **Specific folds** `sum`, `product`, `min`, `max`, which work on collections of specific types (numeric or comparable). * **String** operations `mkString`, `addString`, `className`, which give alternative ways of converting a collection to a string. -* **View** operation: A view is a collection that's evaluated lazily. You'll learn more about views in [later](views.html). +* **View** operation: A view is a collection that's evaluated lazily. You'll learn more about views in [later]({% link _overviews/collections-2.13/views.md %}). Two more methods exist in `Iterable` that return iterators: `grouped` and `sliding`. These iterators, however, do not return single elements but whole subsequences of elements of the original collection. The maximal size of these subsequences is given as an argument to these methods. The `grouped` method returns its elements in "chunked" increments, where `sliding` yields a sliding "window" over the elements. The difference between the two should become clear by looking at the following REPL interaction: diff --git a/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md b/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md index 0c6a672ae0..dd9f2e5658 100644 --- a/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md +++ b/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md @@ -72,7 +72,7 @@ res27: scala.collection.immutable.ArraySeq[Int] = ArraySeq(1, 2, 3) Как видно из последней строки выше, вызов `updated` не влияет на исходный ArraySeq `arr`. -ArraySeqs хранят свои элементы в приватном [Массиве](arrays.html). Таким образом достигается компактное представление и обеспечивается быстрый индексированный доступ к элементам, но обновление или добавление одного элемента занимает линейное время, так как требует создания другого массива и копирования всех элементов исходного массива. +ArraySeqs хранят свои элементы в приватном [Массиве]({% link _ru/overviews/collections-2.13/arrays.md %}). Таким образом достигается компактное представление и обеспечивается быстрый индексированный доступ к элементам, но обновление или добавление одного элемента занимает линейное время, так как требует создания другого массива и копирования всех элементов исходного массива. ## Вектора (Vectors) diff --git a/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md b/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md index 1e215bb7ea..d6f23a7024 100644 --- a/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -102,7 +102,7 @@ Scala предоставляет не только неизменяемые, н Последовательные массивы - это изменяемые массивы со свойствами последовательности фиксированного размера, которые хранят свои элементы внутри `Array[Object]`. Они реализованы в Scala классом [ArraySeq](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArraySeq.html). -Вам стоит использовать `ArraySeq`, если вам нужен массив из-за его показателей производительности, но вы дополнительно хотите использовать обобщеные экземпляры последовательности, в которых вы не знаете тип элементов и у которого нет `ClassTag` который будет предоставлен непосредственно во время исполнения. Эти аспекты рассматриваются в разделе [arrays](arrays.html). +Вам стоит использовать `ArraySeq`, если вам нужен массив из-за его показателей производительности, но вы дополнительно хотите использовать обобщеные экземпляры последовательности, в которых вы не знаете тип элементов и у которого нет `ClassTag` который будет предоставлен непосредственно во время исполнения. Эти аспекты рассматриваются в разделе [arrays]({% link _ru/overviews/collections-2.13/arrays.md %}). ## Hash Tables (Хэш Таблицы) @@ -140,7 +140,7 @@ Scala предоставляет не только неизменяемые, н | `m.replace(k, old, new)` |Заменяет значение, связанное с ключом `k` на `new`, если ранее оно было равно `old`. | | `m.replace (k, v)` | Заменяет значение, связанное с ключом `k` на `v`, если ранее значение вообще существовало.| -`concurrent.Map` это трейт в библиотеке коллекций Scala. В настоящее время он реализуется двумя способами. Первый - через Java мапу `java.util.concurrent.ConcurrentMap`, который может быть автоматически преобразован в Scala мапу с помощью [стандартного механизма преобразования Java/Scala коллекций](conversions-between-java-and-scala-collections.html). Вторая реализация через [TrieMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), которая представляет из себя не блокируемую хэш-таблицу привязанную к дереву. +`concurrent.Map` это трейт в библиотеке коллекций Scala. В настоящее время он реализуется двумя способами. Первый - через Java мапу `java.util.concurrent.ConcurrentMap`, который может быть автоматически преобразован в Scala мапу с помощью [стандартного механизма преобразования Java/Scala коллекций]({% link _ru/overviews/collections-2.13/conversions-between-java-and-scala-collections.md %}). Вторая реализация через [TrieMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/concurrent/TrieMap.html), которая представляет из себя не блокируемую хэш-таблицу привязанную к дереву. ## Mutable Bitsets (Изменяемый Битовый Набор) diff --git a/_ru/overviews/collections-2.13/seqs.md b/_ru/overviews/collections-2.13/seqs.md index 9bf9d180c3..bf67f53cf0 100644 --- a/_ru/overviews/collections-2.13/seqs.md +++ b/_ru/overviews/collections-2.13/seqs.md @@ -73,7 +73,7 @@ language: ru | `xs distinctBy f` |Подпоследовательность `xs`, которая не содержит дублирующего элемента после применения функции преобразования `f`. Например, `List("foo", "bar", "quux").distinctBy(_.length) == List("foo", "quux")`| У трейта [Seq](https://www.scala-lang.org/api/current/scala/collection/Seq.html) есть два дочерних трейта [LinearSeq](https://www.scala-lang.org/api/current/scala/collection/LinearSeq.html), и [IndexedSeq](https://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html). -Они не добавляют никаких новых операций, но у каждого из них разные характеристики производительности: у LinearSeq эффективные операции `head` и `tail`, в то время как у IndexedSeq эффективные операции `apply`, `length` и (если мутабельная) `update`. Часто используемые варианты LinearSeq - это `scala.collection.immutable.List` и `scala.collection.immutable.LazyList`. А наиболее часто используемые IndexedSeq - это `scala.Array` и `scala.collection.mutable.ArrayBuffer`. Класс `Vector` представляет собой компромисс между IndexedSeq и LinearSeq. У него эффективные, как обращение по индексу, так и последовательный обход элементов. Поэтому вектора хорошая основа для смешанных моделей доступа, где используются как индексированный, так и последовательный доступ. Позже мы расскажем больше о [векторах](concrete-immutable-collection-classes.html). +Они не добавляют никаких новых операций, но у каждого из них разные характеристики производительности: у LinearSeq эффективные операции `head` и `tail`, в то время как у IndexedSeq эффективные операции `apply`, `length` и (если мутабельная) `update`. Часто используемые варианты LinearSeq - это `scala.collection.immutable.List` и `scala.collection.immutable.LazyList`. А наиболее часто используемые IndexedSeq - это `scala.Array` и `scala.collection.mutable.ArrayBuffer`. Класс `Vector` представляет собой компромисс между IndexedSeq и LinearSeq. У него эффективные, как обращение по индексу, так и последовательный обход элементов. Поэтому вектора хорошая основа для смешанных моделей доступа, где используются как индексированный, так и последовательный доступ. Позже мы расскажем больше о [векторах]({% link _ru/overviews/collections-2.13/concrete-immutable-collection-classes.md %}). В мутабельном варианте `IndexedSeq` добавляет операции преобразования ее элементов в самой коллекции (в отличие от таких операций как `map` и `sort`, доступных на базовом трейте `Seq`, для которых результат - это новая коллекция). diff --git a/_ru/overviews/collections-2.13/sets.md b/_ru/overviews/collections-2.13/sets.md index 2a4d4a0550..20becc4ffa 100644 --- a/_ru/overviews/collections-2.13/sets.md +++ b/_ru/overviews/collections-2.13/sets.md @@ -105,7 +105,7 @@ language: ru У изменяемых множеств также есть операции `add` и `remove` как эквиваленты для `+=` и `-=`. Разница лишь в том, что команды `add` и `remove` возвращают логический результат, показывающий, повлияла ли операция на само множество или нет. -Текущая реализация изменяемого множества по умолчанию использует хэш-таблицу для хранения элементов множества. Реализация неизменяемого множества по умолчанию использует представление, которое адаптируется к количеству элементов множества. Пустое множество представлено объектом сингэлтоном. Множества размеров до четырех представлены одним объектом, в котором все элементы хранятся в виде полей. За пределами этого размера, неизменяемые множества реализованны в виде [Сжатого Отображенния Префиксного Дерева на Ассоциативном Массиве](concrete-immutable-collection-classes.html). +Текущая реализация изменяемого множества по умолчанию использует хэш-таблицу для хранения элементов множества. Реализация неизменяемого множества по умолчанию использует представление, которое адаптируется к количеству элементов множества. Пустое множество представлено объектом сингэлтоном. Множества размеров до четырех представлены одним объектом, в котором все элементы хранятся в виде полей. За пределами этого размера, неизменяемые множества реализованны в виде [Сжатого Отображенния Префиксного Дерева на Ассоциативном Массиве]({% link _ru/overviews/collections-2.13/concrete-immutable-collection-classes.md %}). Результатом такой схемы представления является то, что неизменяемые множества малых размеров (скажем, до 4), более компактны и более эффективны, чем изменяемые. Поэтому, если вы ожидаете, что размер множества будет небольшим, постарайтесь сделать его неизменяемым. diff --git a/_ru/overviews/collections-2.13/trait-iterable.md b/_ru/overviews/collections-2.13/trait-iterable.md index 447859daba..b02ffd19a1 100644 --- a/_ru/overviews/collections-2.13/trait-iterable.md +++ b/_ru/overviews/collections-2.13/trait-iterable.md @@ -29,7 +29,7 @@ language: ru * **Свертки** `foldLeft`, `foldRight`, `reduceLeft`, `reduceRight` которые применяют двуместную операцию к последовательным элементам. * **Определённых сверток** `sum`, `product`, `min`, `max`, которые работают над коллекциями конкретных типов (числовыми или сопоставимыми). * **Строковая** операции `mkString`, `addString`, `className`, которые дают альтернативные способы преобразования коллекции в строку. -* **Отображения** - это такая коллекция, которая лениво вычисляется. Позже мы расмотрим отображения [подробнее](views.html). +* **Отображения** - это такая коллекция, которая лениво вычисляется. Позже мы расмотрим отображения [подробнее]({% link _ru/overviews/collections-2.13/views.md %}). В `Iterable` есть два метода, которые возвращают итераторы: `grouped` и `sliding`. Правда эти итераторы возвращают не отдельные элементы, а целые подпоследовательности элементов исходной коллекции. Максимальный размер таких подпоследовательностей задается аргументом. Метод `grouped` возвращает свои элементы "нарезанные" на фиксированные части, тогда как `sliding` возвращает результат "прохода окна" (заданной длинны) над элементами. Разница между ними станет очевидной, если взглянуть на следующий результат в консоли: From 4772a39184c42aa57caeb7c28958a36ac047c16e Mon Sep 17 00:00:00 2001 From: breucode Date: Fri, 3 Jun 2022 22:14:22 +0200 Subject: [PATCH 1897/3075] Fix typo in Type Casting section --- _overviews/scala3-book/first-look-at-types.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/first-look-at-types.md b/_overviews/scala3-book/first-look-at-types.md index 5e7b8f0099..9ae69afd3a 100644 --- a/_overviews/scala3-book/first-look-at-types.md +++ b/_overviews/scala3-book/first-look-at-types.md @@ -249,7 +249,7 @@ You can only cast to a type if there is no loss of information. Otherwise, you n ```scala val x: Long = 987654321 -val y: Float = x.toFloat // 9.8765434E8 (note that `.toFloat` is required because the cast results in percision loss) +val y: Float = x.toFloat // 9.8765434E8 (note that `.toFloat` is required because the cast results in precision loss) val z: Long = y // Error ``` From d811abadddd44817103b8a62b4f43303250c843c Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sun, 5 Jun 2022 22:44:35 +0800 Subject: [PATCH 1898/3075] add all types files --- .../overviews/scala3-book/types-adts-gadts.md | 207 ++++++++++++++++++ 1 file changed, 207 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/types-adts-gadts.md diff --git a/_zh-cn/overviews/scala3-book/types-adts-gadts.md b/_zh-cn/overviews/scala3-book/types-adts-gadts.md new file mode 100644 index 0000000000..5c504d0165 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-adts-gadts.md @@ -0,0 +1,207 @@ +--- +title: 代数数据类型 +type: section +description: This section introduces and demonstrates algebraic data types (ADTs) in Scala 3. +num: 52 +previous-page: types-union +next-page: types-variance +--- + + +代数数据类型 (ADT) 可以使用 `enum` 构造创建，因此我们将在查看 ADT 之前简要回顾一下枚举。 + +## 枚举 + +_enumeration_ 用于定义由一组命名值组成的类型： + +```scala +enum Color: + case Red, Green, Blue +``` + +这可以看作是以下的简写： + +```scala +enum Color: + case Red extends Color + case Green extends Color + case Blue extends Color +``` + +#### 参数 + +枚举可以参数化： + +```scala +enum Color(val rgb: Int): + case Red extends Color(0xFF0000) + case Green extends Color(0x00FF00) + case Blue extends Color(0x0000FF) +``` + +这样，每个不同的变体都有一个值成员 `rgb`，它被分配了相应的值： + +```scala +println(Color.Green.rgb) // prints 65280 +``` + +#### 自定义 + +枚举也可以有自定义： + +```scala +enum Planet(mass: Double, radius: Double): + + private final val G = 6.67300E-11 + def surfaceGravity = G * mass / (radius * radius) + def surfaceWeight(otherMass: Double) = otherMass * surfaceGravity + + case Mercury extends Planet(3.303e+23, 2.4397e6) + case Venus extends Planet(4.869e+24, 6.0518e6) + case Earth extends Planet(5.976e+24, 6.37814e6) + // 5 or 6 more planets ... +``` + +像类和 `case` 类一样，你也可以为枚举定义一个伴生对象： + +```scala +object Planet: + def main(args: Array[String]) = + val earthWeight = args(0).toDouble + val mass = earthWeight / Earth.surfaceGravity + for (p <- values) + println(s"Your weight on $p is ${p.surfaceWeight(mass)}") +``` + +## 代数数据类型 (ADTs) + +`enum` 概念足够通用，既支持_代数数据类型_（ADT）和它的通用版本（GADT）。 +本示例展示了如何将 `Option` 类型表示为 ADT： + +```scala +enum Option[+T]: + case Some(x: T) + case None +``` + +这个例子创建了一个带有协变类型参数 `T` 的 `Option` 枚举，它由两种情况组成， `Some` 和 `None`。 +`Some` 是_参数化_的，它带有值参数 `x`；它是从 `Option` 继承的 `case` 类的简写。 +由于 `None` 没有参数化，它被视为普通的 `enum` 值。 + +前面示例中省略的 `extends` 子句也可以显式给出： + +```scala +enum Option[+T]: + case Some(x: T) extends Option[T] + case None extends Option[Nothing] +``` + +与普通的 `enum` 值一样，`enum` 的情况是在 `enum` 的伴生对象中定义的，因此它们被引用为 `Option.Some` 和 `Option.None`（除非定义是在导入时单独列出）： + +```scala +scala> Option.Some("hello") +val res1: t2.Option[String] = Some(hello) + +scala> Option.None +val res2: t2.Option[Nothing] = None +``` + +与其他枚举用途一样，ADT 可以定义更多的方法。 +例如，这里又是一个 `Option`，它的伴生对象中有一个 `isDefined` 方法和一个 `Option(...)` 构造函数： + +```scala +enum Option[+T]: + case Some(x: T) + case None + + def isDefined: Boolean = this match + case None => false + case Some(_) => true + +object Option: + def apply[T >: Null](x: T): Option[T] = + if (x == null) None else Some(x) +``` + +枚举和 ADT 共享相同的句法结构，因此它们可以 +被简单地视为光谱的两端，把二者混搭是完全可能的。 +例如，下面的代码给出了一个 +`Color` 的实现，可以使用三个枚举值或使用 +RGB 值的参数化情况： + +```scala +enum Color(val rgb: Int): + case Red extends Color(0xFF0000) + case Green extends Color(0x00FF00) + case Blue extends Color(0x0000FF) + case Mix(mix: Int) extends Color(mix) +``` + +#### 递归枚举 + +到目前为止，我们定义的所有枚举都由值或样例类的不同变体组成。 +枚举也可以是递归的，如下面的自然数编码示例所示： + +```scala +enum Nat: + case Zero + case Succ(n: Nat) +``` + +例如，值 `Succ(Succ(Zero))` 表示一元编码中的数字 `2`。 +列表可以以非常相似的方式定义： + +```scala +enum List[+A]: + case Nil + case Cons(head: A, tail: List[A]) +``` + +## 广义代数数据类型 (GADT) + +上面的枚举表示法非常简洁，可以作为建模数据类型的完美起点。 +由于我们总是可以更明确，因此也可以表达更强大的类型：广义代数数据类型 (GADT)。 + +这是一个 GADT 示例，其中类型参数 (`T`) 指定存储在框中的内容： + +```scala +enum Box[T](contents: T): + case IntBox(n: Int) extends Box[Int](n) + case BoolBox(b: Boolean) extends Box[Boolean](b) +``` + +特定构造函数（`IntBox` 或 `BoolBox`）上的模式匹配可恢复类型信息： + +```scala +def extract[T](b: Box[T]): T = b match + case IntBox(n) => n + 1 + case BoolBox(b) => !b +``` + +只有在第一种情况下返回一个 `Int` 才是安全的，因为我们从 pattern 匹配输入是一个“IntBox”。 + +## 去除语法糖的枚举 + +_从概念上讲_，枚举可以被认为是定义一个密封类及其伴生对象。 +让我们看看上面的 `Color` 枚举的无语法糖版本： + +```scala +sealed abstract class Color(val rgb: Int) extends scala.reflect.Enum +object Color: + case object Red extends Color(0xFF0000) { def ordinal = 0 } + case object Green extends Color(0x00FF00) { def ordinal = 1 } + case object Blue extends Color(0x0000FF) { def ordinal = 2 } + case class Mix(mix: Int) extends Color(mix) { def ordinal = 3 } + + def fromOrdinal(ordinal: Int): Color = ordinal match + case 0 => Red + case 1 => Green + case 2 => Blue + case _ => throw new NoSuchElementException(ordinal.toString) +``` + +请注意，上面的去除语法糖被简化了，我们故意省略了[一些细节][desugar-enums]。 + +虽然枚举可以使用其他构造手动编码，但使用枚举更简洁，并且还附带了一些额外的实用程序（例如 `fromOrdinal` 方法）。 + +[desugar-enums]: {{ site.scala3ref }}/enums/desugarEnums.html From b9c6ac030f24b850f83894d30583e3b700e85166 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sun, 5 Jun 2022 22:45:04 +0800 Subject: [PATCH 1899/3075] add all types files --- .../scala3-book/types-dependent-function.md | 169 ++++++++++++++++++ .../overviews/scala3-book/types-generics.md | 46 +++++ .../overviews/scala3-book/types-inferred.md | 40 +++++ .../scala3-book/types-intersection.md | 43 +++++ .../scala3-book/types-introduction.md | 47 +++++ .../scala3-book/types-opaque-types.md | 154 ++++++++++++++++ _zh-cn/overviews/scala3-book/types-others.md | 24 +++ .../overviews/scala3-book/types-structural.md | 104 +++++++++++ .../scala3-book/types-type-classes.md | 52 ++++++ _zh-cn/overviews/scala3-book/types-union.md | 99 ++++++++++ .../overviews/scala3-book/types-variance.md | 164 +++++++++++++++++ 11 files changed, 942 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/types-dependent-function.md create mode 100644 _zh-cn/overviews/scala3-book/types-generics.md create mode 100644 _zh-cn/overviews/scala3-book/types-inferred.md create mode 100644 _zh-cn/overviews/scala3-book/types-intersection.md create mode 100644 _zh-cn/overviews/scala3-book/types-introduction.md create mode 100644 _zh-cn/overviews/scala3-book/types-opaque-types.md create mode 100644 _zh-cn/overviews/scala3-book/types-others.md create mode 100644 _zh-cn/overviews/scala3-book/types-structural.md create mode 100644 _zh-cn/overviews/scala3-book/types-type-classes.md create mode 100644 _zh-cn/overviews/scala3-book/types-union.md create mode 100644 _zh-cn/overviews/scala3-book/types-variance.md diff --git a/_zh-cn/overviews/scala3-book/types-dependent-function.md b/_zh-cn/overviews/scala3-book/types-dependent-function.md new file mode 100644 index 0000000000..20550ffabd --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-dependent-function.md @@ -0,0 +1,169 @@ +--- +title: 依赖函数类型 +type: section +description: This section introduces and demonstrates dependent function types in Scala 3. +num: 56 +previous-page: types-structural +next-page: types-others +--- + + +*依赖函数类型*描述函数类型，其中结果类型可能取决于函数的参数值。 +依赖类型和依赖函数类型的概念更高级，您通常只会在设计自己的库或使用高级库时遇到它。 + +## 依赖方法类型 + +让我们考虑以下可以存储不同类型值的异构数据库示例。 +键包含有关相应值的类型的信息： + +```scala +trait Key { type Value } + +trait DB { + def get(k: Key): Option[k.Value] // a dependent method +} +``` + +给定一个键，`get` 方法允许我们访问地图并可能返回类型为 `k.Value` 的存储值。 +我们可以将这个_路径依赖类型_解读为：“根据参数 `k` 的具体类型，我们返回一个匹配值”。 + +例如，我们可以有以下键： + +```scala +object Name extends Key { type Value = String } +object Age extends Key { type Value = Int } +``` + +以下对方法 `get` 的调用现在将键入检查： + +```scala +val db: DB = ... +val res1: Option[String] = db.get(Name) +val res2: Option[Int] = db.get(Age) +``` + +调用方法 `db.get(Name)` 返回一个 `Option[String]` 类型的值，而调用 `db.get(Age)` 返回一个 `Option[Int]` 类型的值。 +返回类型_依赖_于传递给 `get` 的参数的具体类型---因此名称为_依赖类型_。 + +## 依赖函数类型 + +如上所示，Scala 2 已经支持依赖方法类型。 +但是，创建 `DB` 类型的值非常麻烦： + +```scala +// a user of a DB +def user(db: DB): Unit = + db.get(Name) ... db.get(Age) + +// creating an instance of the DB and passing it to `user` +user(new DB { + def get(k: Key): Option[k.Value] = ... // implementation of DB +}) +``` + +我们需要手动创建一个匿名的 `DB` 内部类，实现 `get` 方法。 +对于依赖于创建许多不同的 `DB` 实例的代码，这是非常乏味的。 + + `DB` 只有一个抽象方法 `get` 。 +如果我们可以使用 lambda 语法，那不是很好吗？ + +```scala +user { k => + ... // implementation of DB +``` + +事实上，现在这在 Scala 3 中是可能的！我们可以将 `DB` 定义为_依赖函数类型_： + +```scala +type DB = (k: Key) => Option[k.Value] +// ^^^^^^^^^^^^^^^^^^^^^^^^^^^ +// A dependent function type +``` + +鉴于 `DB` 的这个定义，上面对 `user` 类型的调用按原样检查。 + +您可以在 [参考文档][ref] 中阅读有关依赖函数类型内部结构的更多信息。 + +## 案例研究：数值表达式 + +假设我们要定义一个抽象数字内部表示的模块。 +例如，这对于实现用于自动派生的库很有用。 + +我们首先为数字定义我们的模块： + +```scala +trait Nums: + // the type of numbers is left abstract + type Num + + // some operations on numbers + def lit(d: Double): Num + def add(l: Num, r: Num): Num + def mul(l: Num, r: Num): Num +``` + +> 我们省略了 `Nums` 的具体实现，但作为练习，您可以通过分配 `type Num = Double` 来实现 `Nums` 并相应地实现方法。 + +使用我们的数字抽象的程序现在具有以下类型： + +```scala +type Prog = (n: Nums) => n.Num => n.Num + +val ex: Prog = nums => x => nums.add(nums.lit(0.8), x) +``` + +计算诸如 `ex` 之类的程序的导数的函数的类型是： + +```scala +def derivative(input: Prog): Double +``` + +鉴于依赖函数类型的便利，用不同的程序调用这个函数非常方便： + +```scala +derivative { nums => x => x } +derivative { nums => x => nums.add(nums.lit(0.8), x) } +// ... +``` + +回想一下，上面编码中的相同程序将是： + +```scala +derivative(new Prog { + def apply(nums: Nums)(x: nums.Num): nums.Num = x +}) +derivative(new Prog { + def apply(nums: Nums)(x: nums.Num): nums.Num = nums.add(nums.lit(0.8), x) +}) +// ... +``` + +#### 上下文组合函数 + +扩展方法、[上下文函数][ctx-fun]和依赖函数的组合为库设计者提供了强大的工具。 +例如，我们可以从上面优化我们的库，如下所示： + +```scala +trait NumsDSL extends Nums: + extension (x: Num) + def +(y: Num) = add(x, y) + def *(y: Num) = mul(x, y) + +def const(d: Double)(using n: Nums): n.Num = n.lit(d) + +type Prog = (n: NumsDSL) ?=> n.Num => n.Num +// ^^^ +// prog is now a context function that implicitly +// assumes a NumsDSL in the calling context + +def derivative(input: Prog): Double = ... + +// notice how we do not need to mention Nums in the examples below? +derivative { x => const(1.0) + x } +derivative { x => x * x + const(2.0) } +// ... +``` + + +[ref]: {{ site.scala3ref }}/new-types/dependent-function-types.html +[ctx-fun]: {{ site.scala3ref }}/contextual/context-functions.html diff --git a/_zh-cn/overviews/scala3-book/types-generics.md b/_zh-cn/overviews/scala3-book/types-generics.md new file mode 100644 index 0000000000..7871b4c70e --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-generics.md @@ -0,0 +1,46 @@ +--- +title: 泛型 +type: section +description: This section introduces and demonstrates generics in Scala 3. +num: 49 +previous-page: types-inferred +next-page: types-intersection +--- + + +泛型类（或 traits）把在方括号 `[...]` 中的类型作为_参数_进行调用。 +Scala 约定是使用单个字母（如 `A`）来命名这些类型参数。 +然后当需要时，该类型可以在类中用于方法实例参数，或返回类型： + +```scala +// here we declare the type parameter A +// v +class Stack[A]: + private var elements: List[A] = Nil + // ^ + // Here we refer to the type parameter + // v + def push(x: A): Unit = { elements = elements.prepended(x) } + def peek: A = elements.head + def pop(): A = + val currentTop = peek + elements = elements.tail + currentTop +``` + +`Stack` 类的这个实现采用任何类型作为参数。 +泛型的美妙之处在于您现在可以创建一个 `Stack[Int]`、`Stack[String]` 等，允许您将 `Stack` 的实现重复用于任意元素类型。 + +这是创建和使用 `Stack[Int]` 的方式： + +``` +val stack = Stack[Int] +stack.push(1) +stack.push(2) +println(stack.pop()) // prints 2 +println(stack.pop()) // prints 1 +``` + +> 有关如何用泛型类型表达可变的详细信息，请参阅[可变（Variance）部分][variance]。 + +[variance]: {% link _overviews/scala3-book/types-variance.md %} diff --git a/_zh-cn/overviews/scala3-book/types-inferred.md b/_zh-cn/overviews/scala3-book/types-inferred.md new file mode 100644 index 0000000000..645af43dbc --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-inferred.md @@ -0,0 +1,40 @@ +--- +title: 推断类型 +type: section +description: This section introduces and demonstrates inferred types in Scala 3 +num: 48 +previous-page: types-introduction +next-page: types-generics +--- + + +与其他静态类型编程语言一样，在 Scala 中，您可以在创建新变量时_声明_类型： + +```scala +val x: Int = 1 +val y: Double = 1 +``` + +在这些示例中，类型分别_明确地_声明为 `Int` 和 `Double` 。 +但是，在 Scala 中，您通常不必在定义值绑定器时声明类型： + +```scala +val a = 1 +val b = List(1, 2, 3) +val m = Map(1 -> "one", 2 -> "two") +``` + +当你这样做时，Scala _推断_类型，如下面的 REPL 交互所示： + +```scala +scala> val a = 1 +val a: Int = 1 + +scala> val b = List(1, 2, 3) +val b: List[Int] = List(1, 2, 3) + +scala> val m = Map(1 -> "one", 2 -> "two") +val m: Map[Int, String] = Map(1 -> one, 2 -> two) +``` + +事实上，大多数变量都是这样定义的，而 Scala 自动推断类型的能力是使它_感觉_像一种动态类型语言的一个特性。 diff --git a/_zh-cn/overviews/scala3-book/types-intersection.md b/_zh-cn/overviews/scala3-book/types-intersection.md new file mode 100644 index 0000000000..d716d1b00e --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-intersection.md @@ -0,0 +1,43 @@ +--- +title: 交集类型 +type: section +description: This section introduces and demonstrates intersection types in Scala 3. +num: 50 +previous-page: types-generics +next-page: types-union +--- + + +用于类型，`&` 运算符创建一个所谓的_交集类型_。 +`A & B` 类型表示同时是 `A` 类型和 `B` 类型**两者**的值。 +例如，以下示例使用交集类型 `Resettable & Growable[String]`： + +```scala +trait Resettable: + def reset(): Unit + +trait Growable[A]: + def add(a: A): Unit + +def f(x: Resettable & Growable[String]): Unit = + x.reset() + x.add("first") +``` + +在本例中的方法 `f` 中，参数 `x` 必须*同时*既是 `Resettable` 也是 `Growable[String]`。 + +交集类型 `A & B` 的_成员_既有 `A` 的所有成员，也有 `B` 的所有成员。 +因此，如图所示，`Resettable & Growable[String]` 具有成员方法 `reset` 和 `add`。 + +交集类型可用于_结构性_地描述需求。 +也就是说，在我们的示例 `f` 中，我们直接表示只要 `x` 是 `Resettable` 和 `Growable` 的子类型的任意值， 我们就感到满意。 +我们**不**需要创建一个_通用_的辅助 trait，如下所示： + +```scala +trait Both[A] extends Resettable, Growable[A] +def f(x: Both[String]): Unit +``` + +定义 `f` 的两种选择之间有一个重要区别：虽然两者都允许使用 `Both` 的实例调用 `f`，但只有前者允许传递属于 `Resettable` 和 `Growable[String]` 子类型的实例，后者 `Both[String]` _不允许_。 + +> 请注意，`&` 是_可交换的_：`A & B` 与 `B & A` 的类型相同。 diff --git a/_zh-cn/overviews/scala3-book/types-introduction.md b/_zh-cn/overviews/scala3-book/types-introduction.md new file mode 100644 index 0000000000..ee8eeba7ea --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-introduction.md @@ -0,0 +1,47 @@ +--- +title: 类型和类型系统 +type: chapter +description: This chapter provides an introduction to Scala 3 types and the type system. +num: 47 +previous-page: fp-summary +next-page: types-inferred +--- + + +Scala 是一种独特的语言，因为它是静态类型的，但通常_感觉_它灵活和动态。 +例如，由于类型推断，您可以编写这样的代码而无需显式指定变量类型： + +```scala +val a = 1 +val b = 2.0 +val c = "Hi!" +``` + +这使代码感觉是动态类型的。 +并且由于新特性，例如 Scala 3 中的 [联合类型][union-types]，您还可以编写如下代码，非常简洁地表达出期望哪些值作为参数，哪些值作为返回的类型： + +```scala +def isTruthy(a: Boolean | Int | String): Boolean = ??? +def dogCatOrWhatever(): Dog | Plant | Car | Sun = ??? +``` + +正如例子所暗示的，当使用联合类型时，这些类型不必共享一个公共层次结构，您仍然可以接受它们作为参数或从方法中返回它们。 + +如果您是应用程序开发人员，您将每天使用类型推断和每周使用泛型等功能。 +当您阅读 Scaladoc 中的类和方法时，您还需要对_可变的(variance)_有所了解。 +希望您会发现使用类型可以相当简单，而且使用类型可以为库开发人员提供了很多表达能力、灵活性和控制力。 + +## 类型的好处 + +静态类型的编程语言提供了许多好处，包括： + +- 帮助提供强大的 IDE 支持 +- 在编译时消除许多类的潜在错误 +- 协助重构 +- 提供强大的文档，因为它经过类型检查，所以不会过时 + +## Scala 类型系统的特性介绍 + +鉴于此简要介绍，以下部分将概述 Scala 类型系统的特性。 + +[union-types]: {% link _overviews/scala3-book/types-union.md %} diff --git a/_zh-cn/overviews/scala3-book/types-opaque-types.md b/_zh-cn/overviews/scala3-book/types-opaque-types.md new file mode 100644 index 0000000000..bd66bb4f95 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-opaque-types.md @@ -0,0 +1,154 @@ +--- +title: 不透明类型 +type: section +description: This section introduces and demonstrates opaque types in Scala 3. +num: 54 +previous-page: types-variance +next-page: types-structural +--- + + +Scala 3 _不透明类型别名_提供没有任何**开销**的类型抽象。 + +## 抽象开销 + +假设我们要定义一个提供数字算术运算的模块，这些数字由它们的对数表示。 +当涉及的数值非常大或接近于零时，使用对数有利于提高精度。 + +把“常规”双精度值与存储为对数的值区分开来很重要，我们引入了一个类 `Logarithm`： + +```scala +class Logarithm(protected val underlying: Double): + def toDouble: Double = math.exp(underlying) + def + (that: Logarithm): Logarithm = + // here we use the apply method on the companion + Logarithm(this.toDouble + that.toDouble) + def * (that: Logarithm): Logarithm = + new Logarithm(this.underlying + that.underlying) + +object Logarithm: + def apply(d: Double): Logarithm = new Logarithm(math.log(d)) +``` + +伴生对象上的 apply 方法让我们可以创建 `Logarithm` 类型的值，我们可用如下方式使用： + +```scala +val l2 = Logarithm(2.0) +val l3 = Logarithm(3.0) +println((l2 * l3).toDouble) // prints 6.0 +println((l2 + l3).toDouble) // prints 4.999... +``` + +虽然 `Logarithm` 类为以这种特殊对数形式存储的 `Double` 值提供了一个很好的抽象，但它带来了严重的性能开销：对于每一个数学运算，我们需要提取基础值，然后将其再次包装在一个 `Logarithm` 的新实例中。 + +## 模块抽象 + +让我们考虑另一种实现相同库的方法。 +这次我们没有将 `Logarithm` 定义为一个类，而是使用_类型别名_来定义它。 +首先，我们定义模块的抽象接口： + +```scala +trait Logarithms: + + type Logarithm + + // operations on Logarithm + def add(x: Logarithm, y: Logarithm): Logarithm + def mul(x: Logarithm, y: Logarithm): Logarithm + + // functions to convert between Double and Logarithm + def make(d: Double): Logarithm + def extract(x: Logarithm): Double + + // extension methods to use `add` and `mul` as "methods" on Logarithm + extension (x: Logarithm) + def toDouble: Double = extract(x) + def + (y: Logarithm): Logarithm = add(x, y) + def * (y: Logarithm): Logarithm = mul(x, y) +``` + +现在，让我们通过说类型 `Logarithm` 等于 `Double` 来实现这个抽象接口： + +```scala +object LogarithmsImpl extends Logarithms: + + type Logarithm = Double + + // operations on Logarithm + def add(x: Logarithm, y: Logarithm): Logarithm = make(x.toDouble + y.toDouble) + def mul(x: Logarithm, y: Logarithm): Logarithm = x + y + + // functions to convert between Double and Logarithm + def make(d: Double): Logarithm = math.log(d) + def extract(x: Logarithm): Double = math.exp(x) +``` + +在 `LogarithmsImpl` 的实现中，等式 `Logarithm = Double` 允许我们实现各种方法。 + +#### 泄漏抽象 + +但是，这种抽象有点泄漏。 +我们必须确保_只_针对抽象接口 `Logarithms` 进行编程，并且永远不要直接使用 `LogarithmsImpl`。 +直接使用 `LogarithmsImpl` 会使等式 `Logarithm = Double` 对用户可见，用户可能会意外使用 `Double`，而实际上是需要 对数双精度。 +例如： + +```scala +import LogarithmsImpl.* +val l: Logarithm = make(1.0) +val d: Double = l // type checks AND leaks the equality! +``` + +必须将模块分离为抽象接口和实现可能很有用，但只为了隐藏 `Logarithm` 的实现细节，就需要付出很多努力。 +针对抽象模块 `Logarithm` 进行编程可能非常乏味，并且通常需要使用像路径依赖类型这样的高级特性，如下例所示： + +```scala +def someComputation(L: Logarithms)(init: L.Logarithm): L.Logarithm = ... +``` + +#### 装箱的开销 + +类型抽象，例如 `type Logarithm` [抹去](https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#type-erasure) 到它们的界限（在我们的例子中是 `Any`）。 +也就是说，虽然我们不需要手动包装和解包 `Double` 值，但仍然会有一些与装箱原始类型 `Double` 相关的装箱开销。 + +## 不透明类型 + +我们可以简单地使用 Scala 3 中的不透明类型来实现类似的效果，而不是手动将我们的 `Logarithms` 组件拆分为抽象部分和具体实现： + +```scala +object Logarithms: +//vvvvvv this is the important difference! + opaque type Logarithm = Double + + object Logarithm: + def apply(d: Double): Logarithm = math.log(d) + + extension (x: Logarithm) + def toDouble: Double = math.exp(x) + def + (y: Logarithm): Logarithm = Logarithm(math.exp(x) + math.exp(y)) + def * (y: Logarithm): Logarithm = x + y +``` + +`Logarithm` 与 `Double` 相同的事实仅在定义 `Logarithm` 的范围内已知，在上面的示例中对应于对象 `Logarithms`。 +类型相等 `Logarithm = Double` 可用于实现方法（如 `*` 和 `toDouble`）。 + +然而，在模块之外， `Logarithm` 类型是完全封装的，或者说是“不透明的”。 对于 `Logarithm` 的用户来说，不可能发现 `Logarithm` 实际上是作为 `Double` 实现的： + +```scala +import Logarithms.* +val l2 = Logarithm(2.0) +val l3 = Logarithm(3.0) +println((l2 * l3).toDouble) // prints 6.0 +println((l2 + l3).toDouble) // prints 4.999... + +val d: Double = l2 // ERROR: Found Logarithm required Double +``` + +尽管我们抽象了 `Logarithm`，但抽象是免费的： +由于只有一种实现，在运行时对于像 `Double` 这样的原始类型将_没有装箱开销_。 + +### 不透明类型总结 + +不透明类型提供了对实现细节的合理抽象，而不会增加性能开销。 +如上图所示，不透明类型使用起来很方便，并且与 [扩展方法][extension] 功能很好地集成在一起。 + +[extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} diff --git a/_zh-cn/overviews/scala3-book/types-others.md b/_zh-cn/overviews/scala3-book/types-others.md new file mode 100644 index 0000000000..fb1f979676 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-others.md @@ -0,0 +1,24 @@ +--- +title: 其他类型 +type: section +description: This section mentions other advanced types in Scala 3. +num: 57 +previous-page: types-dependent-function +next-page: ca-contextual-abstractions-intro +--- + + +Scala还有其他几种高级类型，本书中没有介绍，包括： + +- 类型 lambdas +- 匹配类型 +- 存在类型 +- 高等类型 +- 单例类型 +- 精简类型 +- 种类多态性 + +有关这些类型的更多详细信息，请参阅[参考文档][reference]。 + + +[reference]: {{ site.scala3ref }}/overview.html diff --git a/_zh-cn/overviews/scala3-book/types-structural.md b/_zh-cn/overviews/scala3-book/types-structural.md new file mode 100644 index 0000000000..049c20ae77 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-structural.md @@ -0,0 +1,104 @@ +--- +title: 构造类型 +type: section +description: This section introduces and demonstrates structural types in Scala 3. +num: 55 +previous-page: types-opaque-types +next-page: types-dependent-function +--- + + +{% comment %} +NOTE: It would be nice to simplify this more. +{% endcomment %} + + +一些用例，例如建模数据库访问，在静态类型语言中比在动态类型语言中更尴尬。 +使用动态类型语言，很自然地将行建模为记录或对象，并使用简单的点表示法选择条目，例如 `row.columnName`。 + +要在静态类型语言中获得相同的体验，需要为数据库操作产生的每个可能的行定义一个类——包括连接和投影产生的行——并设置一个方案以在行和代表它的类之间进行映射。 + +这需要大量样板文件，这导致开发人员将静态类型的优势换成更简单的方案，其中列名表示为字符串并传递给其他运算符，例如 `row.select("columnName")`。 +这种方法即便放弃了静态类型的优点，也仍然不如动态类型的版本自然。 + +在您希望在动态上下文中支持简单的点表示法而又不失静态类型优势的情况下，构造类型会有所帮助。 +它们允许开发人员使用点表示法并配置应如何解析字段和方法。 + +## 例子 + +这是一个构造类型 `Person` 的示例： + +```scala +class Record(elems: (String, Any)*) extends Selectable: + private val fields = elems.toMap + def selectDynamic(name: String): Any = fields(name) + +type Person = Record { + val name: String + val age: Int +} +``` + +`Person` 类型在其父类型 `Record` 中添加了一个_精细的改进_，它定义了 `name` 和 `age` 字段。 +我们精细的改进是_构造的_，因为 `name` 和 `age` 没有在父类型中定义。 +但是它们仍然作为 `Person` 类的成员存在。 +例如，以下程序将打印 `"Emma is 42 years old."`： + +```scala +val person = Record( + "name" -> "Emma", + "age" -> 42 +).asInstanceOf[Person] + +println(s"${person.name} is ${person.age} years old.") +``` + +本例中的父类型 `Record` 是一个通用类，可以在其 `elems` 参数中表示任意记录。 +该参数是一个序列，该序列的元素是 `String` 类型的标签和 `Any` 类型的值组成的对。 +当您将 `Person` 创建为 `Record` 时，您必须使用类型转换断言该记录定义了正确类型的正确字段。 +`Record` 本身的类型太弱了，所以编译器在没有用户帮助的情况下无法知道这一点。 +实际上，构造类型与其底层通用表示之间的连接很可能由数据库层完成，因此最终用户没必要关注。 + +`Record` 扩展了标记 trait `scala.Selectable` 并定义了一个方法 `selectDynamic`，它将字段名称映射到其值。 +通过调用此方法来选择构造类型成员。 +Scala 编译器把选择 `person.name` 和 `person.age` 翻译成： + +```scala +person.selectDynamic("name").asInstanceOf[String] +person.selectDynamic("age").asInstanceOf[Int] +``` + +## 第二个例子 + +为了强化您刚刚看到的内容，这里有另一个名为 `Book` 的构造类型，它表示您可能从数据库中读取的一本书： + +```scala +type Book = Record { + val title: String + val author: String + val year: Int + val rating: Double +} +``` + +与 `Person` 一样，这是创建 `Book` 实例的方式： + +```scala +val book = Record( + "title" -> "The Catcher in the Rye", + "author" -> "J. D. Salinger", + "year" -> 1951, + "rating" -> 4.5 +).asInstanceOf[Book] +``` + +## 可选类 + +除了 `selectDynamic` 之外，`Selectable`类有时还会定义 `applyDynamic` 方法。 +然后可以使用它来翻译是函数调用的结构成员。 +因此，如果 `a` 是 `Selectable` 的一个实例，则像 `a.f(b, c)` 这样的结构调用将转换为： + +```scala +a.applyDynamic("f")(b, c) +``` + diff --git a/_zh-cn/overviews/scala3-book/types-type-classes.md b/_zh-cn/overviews/scala3-book/types-type-classes.md new file mode 100644 index 0000000000..f0391f3806 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-type-classes.md @@ -0,0 +1,52 @@ +--- +title: Type Classes +type: section +description: This section introduces type classes in Scala 3. +num: 60 +previous-page: ca-given-using-clauses +next-page: ca-context-bounds +--- + +A _type class_ is an abstract, parameterized type that lets you add new behavior to any closed data type without using sub-typing. +If you are coming from Java, you can think of type classes as something like [`java.util.Comparator[T]`][comparator]. + +> The paper [“Type Classes as Objects and Implicits”][typeclasses-paper] (2010) by Oliveira et al. discusses the basic ideas behind type classes in Scala. +> Even though the paper uses an older version of Scala, the ideas still hold to the current day. + +This style of programming is useful in multiple use-cases, for example: + +- Expressing how a type you don’t own---such as from the standard library or a third-party library---conforms to such behavior +- Adding behavior to multiple types without introducing sub-typing relationships between those types (i.e., one `extends` another) + +In Scala 3, _type classes_ are just _traits_ with one or more type parameters, like the following: +``` +trait Show[A]: + def show(a: A): String +``` +Instances of `Show` for a particular type `A` witness that we can show (i.e., produce a text representation of) an instance of type `A`. +For example, let’s look at the following `Show` instance for `Int` values: + +```scala +class ShowInt extends Show[Int]: + def show(a: Int) = s"The number is ${a}!" +``` +We can write methods that work on arbitrary types `A` _constrained_ by `Show` as follows: + +```scala +def toHtml[A](a: A)(showA: Show[A]): String = + "

      " + showA.show(a) + "

      " +``` +That is, `toHtml` can be called with arbitrary `A` _as long_ as you can also provide an instance of `Show[A]`. +For example, we can call it like: +```scala +toHtml(42)(ShowInt()) +// results in "

      The number is 42!

      " +``` + +#### Automatically passing type class instances +Since type classes are a very important way to structure software, Scala 3 offers additional features that make working with them very convenient. +We discuss these additional features (which fall into the category of *Contextual Abstractions*) in a [later chapter][typeclasses-chapter] of this book. + +[typeclasses-paper]: https://infoscience.epfl.ch/record/150280/files/TypeClasses.pdf +[typeclasses-chapter]: {% link _overviews/scala3-book/ca-type-classes.md %} +[comparator]: https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html diff --git a/_zh-cn/overviews/scala3-book/types-union.md b/_zh-cn/overviews/scala3-book/types-union.md new file mode 100644 index 0000000000..18a8a5f8a5 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-union.md @@ -0,0 +1,99 @@ +--- +title: 联合类型 +type: section +description: This section introduces and demonstrates union types in Scala 3. +num: 51 +previous-page: types-intersection +next-page: types-adts-gadts +--- + + +用于类型，`|` 操作符创建一个所谓的_联合类型_。 +类型 `A | B` 表示**要么是** `A` 类型的值，**要么是** `B` 类型的值。 + +在下面的例子中，`help` 方法接受一个名为 `id` 的联合类型 `Username | Password`，可以是 `Useername` 或 `Password`： + +```scala +case class Username(name: String) +case class Password(hash: Hash) + +def help(id: Username | Password) = + val user = id match + case Username(name) => lookupName(name) + case Password(hash) => lookupPassword(hash) + // more code here ... +``` + +我们通过使用模式匹配区分二者，从而实现 `help` 方法。 + +此代码是一种灵活且类型安全的解决方案。 +如果您尝试传入`Useername` 或 `Password` 以外的类型，编译器会将其标记为错误： + +```scala +help("hi") // error: Found: ("hi" : String) + // Required: Username | Password +``` + +如果您尝试将 `case` 添加到与 `Username` 或 `Password` 类型不匹配的 `match` 表达式中，也会出现错误： + +```scala +case 1.0 => ??? // ERROR: this line won’t compile +``` + +### 联合类型的替代方案 + +如图所示，联合类型可用于替代几种不同的类型，而不要求这些类型是定制类层次结构的一部分，也不需要显式包装。 + +#### 预先规划类层次结构 + +其他语言需要预先规划类层次结构，如下例所示： + +```scala +trait UsernameOrPassword +case class Username(name: String) extends UsernameOrPassword +case class Password(hash: Hash) extends UsernameOrPassword +def help(id: UsernameOrPassword) = ... +``` + +预先计划不能很好地扩展，例如，API 用户的需求可能无法预见。 +此外，使用诸如 `UsernameOrPassword` 之类的标记 trait 使类型层次结构混乱也会使代码更难阅读。 + +#### 标记联合 + +另一种选择是定义一个单独的枚举类型，如： + +```scala +enum UsernameOrPassword: + case IsUsername(u: Username) + case IsPassword(p: Password) +``` + +枚举 `UsernameOrPassword` 表示 `Username` 和 `Password` 的 _标记_联合。 +但是，这种联合建模方式需要_显式包装和展开_，例如，`Username` **不是** `UsernameOrPassword` 的子类型。 + +### 联合类型推断 + +_仅当_明确给出这种类型时，编译器才会将联合类型分配给表达式。 +例如，给定这些值： + +```scala +val name = Username("Eve") // name: Username = Username(Eve) +val password = Password(123) // password: Password = Password(123) +``` + +这个 REPL 示例展示了在将变量绑定到 `if`/`else` 表达式的结果时如何使用联合类型： + +```` +scala> val a = if (true) name else password +val a: Object = Username(Eve) + +scala> val b: Password | Username = if (true) name else password +val b: Password | Username = Username(Eve) +```` + +`a` 的类型是 `Object`，它是 `Username` 和 `Password` 的超类型，但不是二者*最小*的超类型 `Password | Username`。 +如果你想要最小的超类型，你必须明确地给出它，就像对 `b` 所做的那样。 + +> 联合类型是交集类型的对偶。 +> 和具有交集类型的 `&` 一样，`|` 也是可交换的：`A | B` 与 `B | A` 是同一类型。 + diff --git a/_zh-cn/overviews/scala3-book/types-variance.md b/_zh-cn/overviews/scala3-book/types-variance.md new file mode 100644 index 0000000000..6f00f6879d --- /dev/null +++ b/_zh-cn/overviews/scala3-book/types-variance.md @@ -0,0 +1,164 @@ +--- +title: 变型 +type: section +description: This section introduces and demonstrates variance in Scala 3. +num: 53 +previous-page: types-adts-gadts +next-page: types-opaque-types +--- + + +类型参数_变型_控制参数化类型（如类或 traits）的子类型。 + +为了解释变型，让我们假设以下类型定义： + +```scala +trait Item { def productNumber: String } +trait Buyable extends Item { def price: Int } +trait Book extends Buyable { def isbn: String } +``` + +我们还假设以下参数化类型： + +```scala +// an example of an invariant type +trait Pipeline[T]: + def process(t: T): T + +// an example of a covariant type +trait Producer[+T]: + def make: T + +// an example of a contravariant type +trait Consumer[-T]: + def take(t: T): Unit +``` + +一般来说，方差有三种模式： + +- **不变的**---默认值，写成 `Pipeline[T]` +- **协变**---用`+`注释，例如 `Producer[+T]` +- **逆变**---用`-`注释，如 `Consumer[-T]` + +我们现在将详细介绍此注释的含义以及我们使用它的原因。 + +### 不变类型 + +默认情况下，像 `Pipeline` 这样的类型在它们的类型参数中是不变的（本例中是 `T`）。 +这意味着像 `Pipeline[Item]`、`Pipeline[Buyable]` 和 `Pipeline[Book]` 这样的类型彼此之间_没有子类型关系_。 + +理所当然地！假设以下方法使用两个类型为`Pipeline[Buyable]` 的值，并根据价格将其参数 `b` 传递给其中一个： + +```scala +def oneOf( + p1: Pipeline[Buyable], + p2: Pipeline[Buyable], + b: Buyable +): Buyable = + val b1 = p1.process(b) + val b2 = p2.process(b) + if b1.price < b2.price then b1 else b2 +``` + +现在，回想一下，我们的类型之间存在以下_子类型关系_： + +```scala +Book <: Buyable <: Item +``` + +我们不能将 `Pipeline[Book]` 传递给 `oneOf` 方法，因为在其实现中，我们调用的 `p1` 和 `p2` 是 `Buyable` 类型的值。 +`Pipeline[Book]` 需要的是 `Book`，这可能会导致运行时错误。 + +我们不能传递一个 `Pipeline[Item]` 因为在它上面调用 `process` 只会保证返回一个 `Item`；但是，我们应该返回一个 `Buyable` 。 + +#### 为什么是不变的？ + +事实上，`Pipeline` 类型需要是不变的，因为它使用它的类型参数 `T` _既_作为参数类型，_又_作为返回类型。 +出于同样的原因，Scala 集合库中的某些类型——例如 `Array` 或 `Set` —— 也是_不变的_。 + +### 协变类型 + +与不变的 `Pipeline` 相比，`Producer` 类型通过在类型参数前面加上 `+` 前缀被标记为 **协变**。 +这是有效的，因为类型参数仅用于_返回的位置_。 + +将其标记为协变意味着当需要 `Producer[Buyable]` 时，我们可以传递（或返回）一个 `Producer[Book]`。 +事实上，这是合理的。 `Producer[Buyable].make` 的类型只承诺_返回_ `Buyable`。 +作为 `make` 的调用者，我们乐意接受作为 `Buyable` 的子类型的 `Book` 类型，---也就是说，它_至少_是一个 `Buyable`。 + +以下示例说明了这一点，其中函数 `makeTwo` 需要一个 `Producer[Buyable]`： + +```scala +def makeTwo(p: Producer[Buyable]): Int = + p.make.price + p.make.price +``` + +通过书籍制作人是完全可以的： + +``` +val bookProducer: Producer[Book] = ??? +makeTwo(bookProducer) +``` + +在 `makeTwo` 中调用 `price` 对书籍仍然有效。 + +#### 不可变容器的协变类型 + +在处理不可变容器时，您会经常遇到协变类型，例如可以在标准库中找到的那些（例如 `List`、`Seq`、`Vector` 等）。 + +例如，`List` 和 `Vector` 大致定义为： + +```scala +class List[+A] ... +class Vector[+A] ... +``` + +这样，您可以在需要 `List[Buyable]` 的地方使用 `List[Book]`。 +这在直觉上也是有道理的：如果您期望收藏可以购买的东西，那么给您收藏书籍应该没问题。 +在我们的示例中，它们有一个额外的 ISBN 方法，但您可以随意忽略这些额外的功能。 + +### 逆变类型 + +与标记为协变的类型 `Producer` 相比，类型 `Consumer` 通过在类型参数前加上 `-` 来标记为**逆变**。 +这是有效的，因为类型参数仅用于_参数位置_。 + +将其标记为逆变意味着如果我们想要 `Consumer[Buyable]` 时，可以传递（或返回） `Consumer[Item]`。 +也就是说，我们有子类型关系`Consumer[Item] <: Consumer[Buyable]`。 +请记住，对于类型 `Producer`，情况正好相反，我们有 `Producer[Buyable] <: Producer[Item]`。 + +事实上，这是合理的。 `Consumer[Item].take` 方法接受一个 `Item`。 +作为 `take` 的调用者，我们还可以提供 `Buyable`，它会被 `Consumer[Item]` 愉快地接受，因为 `Buyable` 是 `Item` 的一个子类型——也就是说，它_至少_是 `Item` 。 + +#### 消费者的逆变类型 + +逆变类型比协变类型少得多。 +在我们的示例中，您可以将它们视为“消费者”。你可能来的最重要的类型标记为逆变的 cross 是函数之一： + +```scala +trait Function[-A, +B]: + def apply(a: A): B +``` + +它的参数类型 `A` 被标记为逆变的 `A` ——它消费 `A` 类型的值。 +相反，它的结果类型 `B` 被标记为协变——它产生 `B` 类型的值。 + +以下是一些示例，这些示例说明了由函数上可变注释引起的子类型关系： + +```scala +val f: Function[Buyable, Buyable] = b => b + +// OK to return a Buyable where a Item is expected +val g: Function[Buyable, Item] = f + +// OK to provide a Book where a Buyable is expected +val h: Function[Book, Buyable] = f +``` + +## 概括 + +在本节中，我们遇到了三种不同的方差： + +- **生产者**通常是协变的，并用 `+` 标记它们的类型参数。 + 这也适用于不可变集合。 +- **消费者**通常是逆变的，并用 `-` 标记他们的类型参数。 +- **既是**生产者**又**是消费者的类型必须是不变的，并且不需要在其类型参数上进行任何标记。 + 像 `Array` 这样的可变集合就属于这一类。 From fdeeaaa420b7481748475eed18cd27b6ece24aa4 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 17 May 2022 14:56:08 +0200 Subject: [PATCH 1900/3075] Introduce the Extension School platform --- online-courses.md | 69 ++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 56 insertions(+), 13 deletions(-) diff --git a/online-courses.md b/online-courses.md index 0266feb859..a59625fca5 100644 --- a/online-courses.md +++ b/online-courses.md @@ -20,21 +20,17 @@ testimonials: - /resources/images/online-courses/testimonial014.jpg --- -The online courses from the [Scala Center] provide two main paths to learn -Scala. The fast path consists of taking the course [Effective Programming -in Scala], -otherwise you can take the full [Scala Specialization], which is made of -four courses and a capstone project. +The [Scala Center] produces online courses of various levels, from beginner +to advanced. -All the courses are available for free. Optionally, a subscription gives -you access to a certificate of completion that attests your accomplishments. -Learn more about -[Coursera certificates](https://learners.coursera.help/hc/en-us/articles/209819053-Get-a-Course-Certificate) or -[edX certificates](https://support.edx.org/hc/en-us/categories/115002269627-Certificates). -Your subscriptions also supports the work of the [Scala Center], whose mission -is to create high-quality educational material. +**If you are a programmer and want to learn Scala**, there are two recommended +approaches. The fast path consists of taking the course [Effective Programming +in Scala](#effective-programming-in-scala). +Otherwise, you can take the full [Scala Specialization], which is made of +four courses (covering advanced topics such as big data analysis and +parallel programming) and a capstone project. -You can learn more about the Scala Center online courses in the following video: +You can learn more about the courses in the following video:
      @@ -54,8 +50,55 @@ Scala followed by Functional Program Design. Then, you can complement your Scala of the courses Programming Reactive Systems, Parallel Programming, or Big Data Analysis with Scala and Spark. In case you take the Scala Specialization, you will end with the Scala Capstone Project. +## Learning Platforms + +Currently, all our courses are available on the platform [Coursera](https://coursera.org), +and some of them are available on [edX](https://edx.org) or the [Extension School](https://extensionschool.ch). +This section explains the differences between these learning platforms. + +On all the platforms the full material is always available online. It includes +video lectures, text articles, quizzes, and auto-graded homeworks. All the +platforms also provide discussion forums where you can exchange with the +other learners. + +The difference between the Extension School and the other platforms is that it +provides live meetings with instructors, and code reviews by Scala experts. + +On the other hand, on Coursera or edX it is possible to take +our courses for free (a.k.a. “audit” mode). Optionally, a subscription gives +you access to a certificate of completion that attests your accomplishments. + +Learn more about +[Coursera certificates](https://learners.coursera.help/hc/en-us/articles/209819053-Get-a-Course-Certificate), +[edX certificates](https://support.edx.org/hc/en-us/categories/115002269627-Certificates), +or [Extension School certificates](https://www.extensionschool.ch/faqs#certifying-coursework). +Note that your subscriptions also supports the work of the [Scala Center], +whose mission is to create high-quality educational material. + +If you prefer learning in autonomy, we recommend +you to choose the Coursera or edX platform, but if you are looking for more +support, we recommend you to choose the Extension School. Here is a table +below that compares the learning platforms: + +| | Coursera / edX (audit) | Coursera / edX (subscription) | Extension School | +|--------------------------------------------------|------------------------|-------------------------------|------------------| +| Video lectures, quizzes | Yes | Yes | Yes | +| Auto-graded homeworks | Yes | Yes | Yes | +| Discussion forums | Yes | Yes | Yes | +| Self-paced | Yes | Yes | Yes | +| Price | $0 | $50 to $100 per course | $420 per month | +| Certificate of completion | No | Yes | Yes | +| Supports the Scala Center | No | Yes | Yes | +| 30 min of live session with instructors per week | No | No | Yes | +| Code reviews by Scala experts | No | No | Yes | + ## Effective Programming in Scala +This course is available on [Coursera](https://coursera.org/learn/effective-scala) +and the [Extension School](https://extensionschool.ch/learn/effective-programming-in-scala). +Please refer to [this section](#learning-platforms) to know the differences +between both learning platforms. + [Effective Programming in Scala] teaches non-Scala programmers everything they need to be ready to work in Scala. At the end of this hands-on course, you will know how to achieve common programming tasks in Scala (e.g., From a98a6872db819e7b67eb3596a3238df2c5ace355 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Wed, 8 Jun 2022 08:41:40 +0800 Subject: [PATCH 1901/3075] add all ca-* files --- .../scala3-book/ca-context-bounds.md | 48 +++++ .../ca-contextual-abstractions-intro.md | 87 ++++++++ .../scala3-book/ca-extension-methods.md | 83 ++++++++ .../overviews/scala3-book/ca-given-imports.md | 48 +++++ .../scala3-book/ca-given-using-clauses.md | 97 +++++++++ .../scala3-book/ca-implicit-conversions.md | 47 +++++ .../scala3-book/ca-multiversal-equality.md | 198 ++++++++++++++++++ _zh-cn/overviews/scala3-book/ca-summary.md | 31 +++ .../overviews/scala3-book/ca-type-classes.md | 108 ++++++++++ 9 files changed, 747 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/ca-context-bounds.md create mode 100644 _zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md create mode 100644 _zh-cn/overviews/scala3-book/ca-extension-methods.md create mode 100644 _zh-cn/overviews/scala3-book/ca-given-imports.md create mode 100644 _zh-cn/overviews/scala3-book/ca-given-using-clauses.md create mode 100644 _zh-cn/overviews/scala3-book/ca-implicit-conversions.md create mode 100644 _zh-cn/overviews/scala3-book/ca-multiversal-equality.md create mode 100644 _zh-cn/overviews/scala3-book/ca-summary.md create mode 100644 _zh-cn/overviews/scala3-book/ca-type-classes.md diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md new file mode 100644 index 0000000000..35cad7d6db --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -0,0 +1,48 @@ +--- +title: 上下文绑定 +type: section +description: This page demonstrates Context Bounds in Scala 3. +num: 61 +previous-page: types-type-classes +next-page: ca-given-imports +--- + + +{% comment %} +- TODO: define "context parameter" +- TODO: define "synthesized" and "synthesized arguments" +{% endcomment %} + + +在许多情况下，_上下文参数_的名称不必明确提及，因为它仅由编译器在其他上下文参数的合成参数中使用。 +在这种情况下，您不必定义参数名称，只需提供参数类型即可。 + +## 背景 + +例如，这个 `maximum` 方法接受 `Ord` 类型的_上下文参数_，只是将它作为参数传递给 `max`： + +```scala +def maximum[A](xs: List[A])(using ord: Ord[A]): A = + xs.reduceLeft(max(ord)) +``` + +在该代码中，参数名称 `ord` 实际上不是必需的；它可以作为推断参数传递给 `max`，因此您只需声明 `maximum` 使用的类型 `Ord[A]` 而不必给它命名： + +```scala +def maximum[A](xs: List[A])(using Ord[A]): A = + xs.reduceLeft(max) +``` + +## 上下文绑定 + +鉴于此背景，_上下文绑定_是一种简写语法，用于表达“依赖于类型参数的上下文参数”模式。 + +使用上下文绑定，`maximum` 方法可以这样写： + +```scala +def maximum[A: Ord](xs: List[A]): A = xs.reduceLeft(max) +``` + +方法或类的类型参数 `A`，有类似 `:Ord` 的绑定，它表示有 `Ord[A]` 的上下文参数。 + +有关上下文绑定的更多信息，请参阅 Scala 常见问题解答的 [“什么是上下文绑定？”](https://docs.scala-lang.org/tutorials/FAQ/context-bounds.html) 部分。 diff --git a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md new file mode 100644 index 0000000000..dc14d90c62 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -0,0 +1,87 @@ +--- +title: Contextual Abstractions +type: chapter +description: This chapter provides an introduction to the Scala 3 concept of Contextual Abstractions. +num: 58 +previous-page: types-others +next-page: ca-given-using-clauses +--- + + +## Background + +Implicits in Scala 2 were a major distinguishing design feature. +They are *the* fundamental way to abstract over context. +They represent a unified paradigm with a great variety of use cases, among them: + +- Implementing type classes +- Establishing context +- Dependency injection +- Expressing capabilities +- Computing new types, and proving relationships between them + +Since then, other languages have followed suit, e.g., Rust’s traits or Swift’s protocol extensions. +Design proposals are also on the table for Kotlin as compile time dependency resolution, for C# as Shapes and Extensions or for F# as Traits. +Implicits are also a common feature of theorem provers such as Coq or Agda. + +Even though these designs use different terminology, they’re all variants of the core idea of *term inference*: +Given a type, the compiler synthesizes a “canonical” term that has that type. + + +## Redesign + +Scala 3 includes a redesign of contextual abstractions in Scala. +While these concepts were gradually “discovered” in Scala 2, they’re now well known and understood, and the redesign takes advantage of that knowledge. + +The design of Scala 3 focuses on **intent** rather than **mechanism**. +Instead of offering one very powerful feature of implicits, Scala 3 offers several use-case oriented features: + +- **Abstracting over contextual information**. + [Using clauses][givens] allow programmers to abstract over information that is available in the calling context and should be passed implicitly. + As an improvement over Scala 2 implicits, using clauses can be specified by type, freeing function signatures from term variable names that are never explicitly referred to. + +- **Providing Type-class instances**. + [Given instances][type-classes] allow programmers to define the _canonical value_ of a certain type. + This makes programming with type-classes more straightforward without leaking implementation details. + +- **Retroactively extending classes**. + In Scala 2, extension methods had to be encoded using implicit conversions or implicit classes. + In contrast, in Scala 3 [extension methods][extension-methods] are now directly built into the language, leading to better error messages and improved type inference. + +- **Viewing one type as another**. + Implicit conversion have been [redesigned][implicit-conversions] from the ground up as instances of a type-class `Conversion`. + +- **Higher-order contextual abstractions**. + The _all-new_ feature of [context functions][contextual-functions] makes contextual abstractions a first-class citizen. + They are an important tool for library authors and allow to express concise domain specific languages. + +- **Actionable feedback from the compiler**. + In case an implicit parameter can not be resolved by the compiler, it now provides you [import suggestions](https://www.scala-lang.org/blog/2020/05/05/scala-3-import-suggestions.html) that may fix the problem. + + +## Benefits + +These changes in Scala 3 achieve a better separation of term inference from the rest of the language: + +- There’s a single way to define givens +- There’s a single way to introduce implicit parameters and arguments +- There’s a separate way to [import givens][given-imports] that does not allow them to hide in a sea of normal imports +- There’s a single way to define an [implicit conversion][implicit-conversions], which is clearly marked as such, and does not require special syntax + +Benefits of these changes include: + +- The new design thus avoids feature interactions and makes the language more consistent +- It makes implicits easier to learn and harder to abuse +- It greatly improves the clarity of the 95% of Scala programs that use implicits +- It has the potential to enable term inference in a principled way that is also accessible and friendly + +This chapter introduces many of these new features in the following sections. + +[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[given-imports]: {% link _overviews/scala3-book/ca-given-imports.md %} +[implicit-conversions]: {% link _overviews/scala3-book/ca-implicit-conversions.md %} +[extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[context-bounds]: {% link _overviews/scala3-book/ca-context-bounds.md %} +[type-classes]: {% link _overviews/scala3-book/ca-type-classes.md %} +[equality]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} +[contextual-functions]: {% link _overviews/scala3-book/types-dependent-function.md %} diff --git a/_zh-cn/overviews/scala3-book/ca-extension-methods.md b/_zh-cn/overviews/scala3-book/ca-extension-methods.md new file mode 100644 index 0000000000..b3e8e8b091 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-extension-methods.md @@ -0,0 +1,83 @@ +--- +title: 扩展方法 +type: section +description: This page demonstrates how Extension Methods work in Scala 3. +num: 63 +previous-page: ca-given-imports +next-page: ca-type-classes +--- + + +扩展方法允许您在定义类型后向类型添加方法，即它们允许您向封闭类添加新方法。 +例如，假设其他人创建了一个 `Circle` 类： + +```scala +case class Circle(x: Double, y: Double, radius: Double) +``` + +现在想象一下，你需要一个 `circumference` 方法，但是你不能修改它们的源代码。 +在将术语推理的概念引入编程语言之前，您唯一能做的就是在单独的类或对象中编写一个方法，如下所示： + +```scala +object CircleHelpers: + def circumference(c: Circle): Double = c.radius * math.Pi * 2 +``` + +你可以像这样用该方法： + +```scala +val aCircle = Circle(2, 3, 5) + +// without extension methods +CircleHelpers.circumference(aCircle) +``` + +但是使用扩展方法，您可以创建一个 `circumference` 方法来处理 `Circle` 实例： + +```scala +extension (c: Circle) + def circumference: Double = c.radius * math.Pi * 2 +``` + +在这段代码中： + +- 扩展方法 `circumference` 将添加到 `Circle` 类型里 +- `c: Circle` 语法允许您在扩展方法中引用变量 `c` + +然后在您的代码中使用 `circumference`，就像它最初是在 `Circle` 类中定义的一样： + +```scala +aCircle.circumference +``` + +### 导入扩展方法 + +想象一下，`circumference` 定义在`lib` 包中，你可以通过以下方式导入它 + +```scala +import lib.circumference + +aCircle.circumference +``` + +如果缺少导入，编译器还会通过显示详细的编译错误消息来支持您，如下所示： + +```text +value circumference is not a member of Circle, but could be made available as an extension method. + +The following import might fix the problem: + + import lib.circumference +``` + +## 讨论 + +`extension` 关键字声明您将要在括号中的类型上定义一个或多个扩展方法。 +要在一个类型上定义多个扩展方法，请使用以下语法： + +```scala +extension (c: Circle) + def circumference: Double = c.radius * math.Pi * 2 + def diameter: Double = c.radius * 2 + def area: Double = math.Pi * c.radius * c.radius +``` diff --git a/_zh-cn/overviews/scala3-book/ca-given-imports.md b/_zh-cn/overviews/scala3-book/ca-given-imports.md new file mode 100644 index 0000000000..f8df481645 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-given-imports.md @@ -0,0 +1,48 @@ +--- +title: 给定导入 +type: section +description: This page demonstrates how 'given' import statements work in Scala 3. +num: 62 +previous-page: ca-context-bounds +next-page: ca-extension-methods +--- + + +为了更清楚地说明当前作用域中的给定来自何处，我们使用一种特殊形式的 `import` 语句来导入 `given` 实例。 +此示例中显示了基本形式： + +```scala +object A: + class TC + given tc: TC = ??? + def f(using TC) = ??? + +object B: + import A.* // import all non-given members + import A.given // import the given instance +``` + +在此代码中，对象 `B` 的 `import A.*` 子句导入 `A` 的所有成员*除了* `given` 实例 `tc`。 +相反，第二个导入 `import A.given` *仅*导入 `given` 实例。 +两个 `import` 子句也可以合并为一个： + +```scala +object B: + import A.{given, *} +``` + +## 讨论 + +通配符选择器 `*` 将除给定或扩展之外的所有定义都导入作用域，而 `given` 选择器将所有*给定*定义---包括由扩展而来的定义---导入作用域。 + +这些规则有两个主要优点： + +- 更清楚当前作用域内给定的来源。 + 特别是，在一长串其他通配符导入中无法隐藏导入的给定。 +- 它可以导入所有给定，而无需导入任何其他内容。 + 这很重要，因为给定是可以匿名的，因此通常使用命名导入是不切实际的。 + +“导入给定”语法的更多示例见[打包和导入章节][imports]。 + + +[imports]: {% link _overviews/scala3-book/packaging-imports.md %} diff --git a/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md b/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md new file mode 100644 index 0000000000..704f83bd82 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md @@ -0,0 +1,97 @@ +--- +title: Given Instances and Using Clauses +type: section +description: This page demonstrates how to use 'given' instances and 'using' clauses in Scala 3. +num: 59 +previous-page: ca-contextual-abstractions-intro +next-page: types-type-classes +--- + +Scala 3 offers two important feature for contextual abstraction: + +- **Using Clauses** allow you to specify parameters that, at the call site, can be omitted by the programmer and should be automatically provided by the context. +- **Given Instances** let you define terms that can be used by the Scala compiler to fill in the missing arguments. + +## Using Clauses +When designing a system, often context information like _configuration_ or settings need to be provided to the different components of your system. +One common way to achieve this is by passing the configuration as additional argument to your methods. + +In the following example, we define a case class `Config` to model some website configuration and pass it around in the different methods. +```scala +case class Config(port: Int, baseUrl: String) + +def renderWebsite(path: String, c: Config): String = + "" + renderWidget(List("cart"), c) + "" + +def renderWidget(items: List[String], c: Config): String = ??? + +val config = Config(8080, "docs.scala-lang.org") +renderWebsite("/home", config) +``` +Let us assume that the configuration does not change throughout most of our code base. +Passing `c` to each and every method call (like `renderWidget`) becomes very tedious and makes our program more difficult to read, since we need to ignore the `c` argument. + +#### Using `using` to mark parameters as contextual +In Scala 3, we can mark some of the parameters of our methods as _contextual_. +```scala +def renderWebsite(path: String)(using c: Config): String = + "" + renderWidget(List("cart")) + "" + // ^^^ + // no argument c required anymore + +def renderWidget(items: List[String])(using c: Config): String = ??? +``` +By starting a parameter section with the keyword `using`, we tell the Scala compiler that at the callsite it should automatically find an argument with the correct type. +The Scala compiler thus performs **term inference**. + +In our call to `renderWidget(List("cart"))` the Scala compiler will see that there is a term of type `Config` in scope (the `c`) and automatically provide it to `renderWidget`. +So the program is equivalent to the one above. + +In fact, since we do not need to refer to `c` in our implementation of `renderWebsite` anymore, we can even omit its name in the signature: + +```scala +// no need to come up with a parameter name +// vvvvvvvvvvvvv +def renderWebsite(path: String)(using Config): String = + "" + renderWidget(List("cart")) + "" +``` + +#### Explicitly providing contextual arguments +We have seen how to _abstract_ over contextual parameters and that the Scala compiler can provide arguments automatically for us. +But how can we specify which configuration to use for our call to `renderWebsite`? + +Like we specified our parameter section with `using`, we can also explicitly provide contextual arguments with `using:` + +```scala +renderWebsite("/home")(using config) +``` +Explicitly providing contextual parameters can be useful if we have multiple different values in scope that would make sense and we want to make sure that the correct one is passed to the function. + +For all other cases, as we will see in the next Section, there is also another way to bring contextual values into scope. + +## Given Instances +We have seen that we can explicitly pass arguments as contextual parameters by marking the argument section of the _call_ with `using`. +However, if there is _a single canonical value_ for a particular type, there is another preferred way to make it available to the Scala compiler: by marking it as `given`. + +```scala +val config = Config(8080, "docs.scala-lang.org") +// this is the type that we want to provide the +// canonical value for +// vvvvvv +given Config = config +// ^^^^^^ +// this is the value the Scala compiler will infer +// as argument to contextual parameters of type Config +``` +In the above example we specify that whenever a contextual parameter of type `Config` is omitted in the current scope, the compiler should infer `config` as an argument. + +Having defined a given for `Config`, we can simply call `renderWebsite`: + +```scala +renderWebsite("/home") +// ^^^^^ +// again no argument +``` + +[reference]: {{ site.scala3ref }}/overview.html +[blog-post]: /2020/11/06/explicit-term-inference-in-scala-3.html diff --git a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md new file mode 100644 index 0000000000..df51bc2bf3 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md @@ -0,0 +1,47 @@ +--- +title: 隐式转换 +type: section +description: This page demonstrates how to implement Implicit Conversions in Scala 3. +num: 66 +previous-page: ca-multiversal-equality +next-page: ca-summary +--- + +隐式转换由 `scala.Conversion` 类的 `given` 实例定义。 +例如，不考虑可能的转换错误，这段代码定义了从 `String` 到 `Int` 的隐式转换： + +```scala +given Conversion[String, Int] with + def apply(s: String): Int = Integer.parseInt(s) +``` + +使用别名可以更简洁地表示为： + +```scala +given Conversion[String, Int] = Integer.parseInt(_) +``` + +使用这些转换中的任何一种，您现在可以在需要 `Int` 的地方使用 `String`： + +```scala +import scala.language.implicitConversions + +// a method that expects an Int +def plus1(i: Int) = i + 1 + +// pass it a String that converts to an Int +plus1("1") +``` + +> 注意开头的子句 `import scala.language.implicitConversions`， +> 在文件中启用隐式转换。 + +## 讨论 + +Predef 包包含“自动装箱”转换，将原始数字类型映射到 `java.lang.Number` 的子类。 +例如，从 `Int` 到 `java.lang.Integer` 的转换可以定义如下： + +```scala +given int2Integer: Conversion[Int, java.lang.Integer] = + java.lang.Integer.valueOf(_) +``` diff --git a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md new file mode 100644 index 0000000000..42c2914042 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md @@ -0,0 +1,198 @@ +--- +title: 多元相等性 +type: section +description: This page demonstrates how to implement Multiversal Equality in Scala 3. +num: 65 +previous-page: ca-type-classes +next-page: ca-implicit-conversions +--- + + +以前，Scala 具有*普遍相等性*：任何类型的两个值都可以使用 `==` 和 `!=` 相互比较。 +这是因为 `==` 和 `!=` 是根据 Java 的 `equals` 方法实现的，该方法还可以比较任何两种引用类型的值。 + +普遍平等很方便，但也很危险，因为它破坏了类型安全。 +例如，假设在一些重构之后，你会得到一个错误的程序，其中值 `y` 的类型为 `S` 而不是正确的类型 `T`： + +```scala +val x = ... // of type T +val y = ... // of type S, but should be T +x == y // typechecks, will always yield false + +``` + +如果 `y` 与其他类型为 `T` 的值进行比较，程序仍然会进行类型检查，因为所有类型的值都可以相互比较。 +但它可能会产生意想不到的结果并在运行时失败。 + +类型安全的编程语言可以做得更好，多重平等是使普遍平等更安全的一种选择方式。 +它使用二进制类型类“CanEqual”来指示两个给定类型的值可以相互比较。 + +## 允许比较类实例 + +默认情况下，在 Scala 3 中，您仍然可以像这样创建相等比较： + +```scala +case class Cat(name: String) +case class Dog(name: String) +val d = Dog("Fido") +val c = Cat("Morris") + +d == c // false, but it compiles +``` + +但是使用 Scala 3，您可以禁用此类比较。 +通过 (a) 导入 `scala.language.strictEquality` 或 (b) 使用 `-language:strictEquality` 编译器标志，此比较不再编译： + +```scala +import scala.language.strictEquality + +val rover = Dog("Rover") +val fido = Dog("Fido") +println(rover == fido) // compiler error + +// compiler error message: +// Values of types Dog and Dog cannot be compared with == or != +``` + +## 启用比较 + +有两种方法可以使用 Scala 3 `CanEqual` 类型类来启用这种比较。 +对于像这样的简单情况，您的类可以*派生* `CanEqual` 类： + +```scala +// Option 1 +case class Dog(name: String) derives CanEqual +``` + +稍后您将看到，当您需要更多的灵活性时，您还可以使用以下语法： + +```scala +// Option 2 +case class Dog(name: String) +given CanEqual[Dog, Dog] = CanEqual.derived +``` + +现在，这两种方法中的任何一种都可以让 `Dog` 实例相互比较。 + +## 一个更真实的例子 + +在一个更真实的示例中，假设您有一家在线书店，并且想要允许或禁止比较实体书、打印的书和有声读物。 +在 Scala 3 中，您首先启用多元平等性，如前面的示例所示： + +```scala +// [1] add this import, or this command line flag: -language:strictEquality +import scala.language.strictEquality +``` + +然后像往常一样创建你的域对象： + +```scala +// [2] create your class hierarchy +trait Book: + def author: String + def title: String + def year: Int + +case class PrintedBook( + author: String, + title: String, + year: Int, + pages: Int +) extends Book + +case class AudioBook( + author: String, + title: String, + year: Int, + lengthInMinutes: Int +) extends Book +``` + +最后，使用 `CanEqual` 定义您想要允许的比较： + +```scala +// [3] create type class instances to define the allowed comparisons. +// allow `PrintedBook == PrintedBook` +// allow `AudioBook == AudioBook` +given CanEqual[PrintedBook, PrintedBook] = CanEqual.derived +given CanEqual[AudioBook, AudioBook] = CanEqual.derived + +// [4a] comparing two printed books works as desired +val p1 = PrintedBook("1984", "George Orwell", 1961, 328) +val p2 = PrintedBook("1984", "George Orwell", 1961, 328) +println(p1 == p2) // true + +// [4b] you can’t compare a printed book and an audiobook +val pBook = PrintedBook("1984", "George Orwell", 1961, 328) +val aBook = AudioBook("1984", "George Orwell", 2006, 682) +println(pBook == aBook) // compiler error +``` + +最后一行代码导致此编译器错误消息： + +```` +Values of types PrintedBook and AudioBook cannot be compared with == or != +```` + +这就是多重​元平等性在编译时捕获非法类型比较的方式。 + +### 启用“PrintedBook == AudioBook” + +这可以按需要工作，但在某些情况下，您可能希望允许将实体书与有声读物进行比较。 +如果需要，请创建以下两个额外的相等比较： + +```scala +// allow `PrintedBook == AudioBook`, and `AudioBook == PrintedBook` +given CanEqual[PrintedBook, AudioBook] = CanEqual.derived +given CanEqual[AudioBook, PrintedBook] = CanEqual.derived +``` + +现在，您可以将实体书与有声书进行比较，而不会出现编译器错误： + +```scala +println(pBook == aBook) // false +println(aBook == pBook) // false +``` + +#### 实施“等于”以使它们真正起作用 + +虽然现在允许进行这些比较，但它们将始终为 `false`，因为它们的 `equals` 方法不知道如何进行这些比较。 +因此，解决方案是重载每个类的 `equals` 方法。 +例如，当您重载 `AudioBook` 的 `equals` 方法时： + +```scala +case class AudioBook( + author: String, + title: String, + year: Int, + lengthInMinutes: Int +) extends Book: + // override to allow AudioBook to be compared to PrintedBook + override def equals(that: Any): Boolean = that match + case a: AudioBook => + if this.author == a.author + && this.title == a.title + && this.year == a.year + && this.lengthInMinutes == a.lengthInMinutes + then true else false + case p: PrintedBook => + if this.author == p.author && this.title == p.title + then true else false + case _ => + false +``` + +您现在可以将 `AudioBook` 与 `PrintedBook` 进行比较： + +```scala +println(aBook == pBook) // true (works because of `equals` in `AudioBook`) +println(pBook == aBook) // false +``` + +目前 `PrintedBook` 书没有 `equals` 方法，所以第二个比较返回 `false`。 +要启用该比较，只需重载 `PrintedBook` 中的 `equals` 方法。 + +您可以在参考文档中找到有关[多元相等性][ref-equal] 的更多信息。 + + +[ref-equal]: {{ site.scala3ref }}/contextual/multiversal-equality.html diff --git a/_zh-cn/overviews/scala3-book/ca-summary.md b/_zh-cn/overviews/scala3-book/ca-summary.md new file mode 100644 index 0000000000..f387d8ed05 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-summary.md @@ -0,0 +1,31 @@ +--- +title: 总结 +type: section +description: This page provides a summary of the Contextual Abstractions lessons. +num: 67 +previous-page: ca-implicit-conversions +next-page: concurrency +--- + + +本章介绍了大多数上下文抽象主题，包括： + +- 给定实例和使用子句 +- 上下文绑定 +- 给定导入 +- 扩展方法 +- 实现类型类 +- 多元相等性 +- 隐式转换 + +这里没有涉及一些更高级的主题，包括： + +- 类型类派生 +- 上下文函数 +- 按名称上下文参数 +- 与 Scala 2 隐式转换 的关系 + +这些主题在 [参考文档][ref] 中有详细讨论。 + + +[ref]: {{ site.scala3ref }}/contextual diff --git a/_zh-cn/overviews/scala3-book/ca-type-classes.md b/_zh-cn/overviews/scala3-book/ca-type-classes.md new file mode 100644 index 0000000000..173361e33f --- /dev/null +++ b/_zh-cn/overviews/scala3-book/ca-type-classes.md @@ -0,0 +1,108 @@ +--- +title: 实现类型类 +type: section +description: This page demonstrates how to create and use type classes in Scala 3. +num: 64 +previous-page: ca-extension-methods +next-page: ca-multiversal-equality +--- + + +_类型类_是一种抽象的参数化类型，它允许您在不使用子类型的情况下向任何封闭数据类型添加新行为。 +这在多用例中很有用，例如： + +- 表达你不拥有的类型——来自标准库或第三方库——如何符合这种行为 +- 为多种类型表达这种行为，而不涉及这些类型之间的子类型关系 + +在 Scala 3 中，类型类只是具有一个或多个参数的 traits，其实现由 `given` 实例提供。 + +## 例子 + +例如，`Show` 是 Haskell 中众所周知的类型类，下面的代码显示了在 Scala 3 中实现它的一种方法。 +如果您认为 Scala 类没有 `toString` 方法，您可以定义一个 `Show` 类型类，然后把此行为添加到任意的类，这个类是能够转换为自定义字符串。 + +### 类型类 + +创建类型类的第一步是声明具有一个或多个抽象方法的参数化 trait。 +因为 `Showable` 只有一个名为 `show` 的方法，所以写成这样： + +```scala +// a type class +trait Showable[A]: + extension(a: A) def show: String +``` + +这是 Scala 3 的说法，任何实现此 trait 的类型都必须定义 `show` 方法的工作方式。 +请注意，语法非常接近普通的 trait： + +```scala +// a trait +trait Show: + def show: String +``` + +有几件重要的事情需要指出： + +1. 像 `Showable` 这样的类型类有一个类型参数 `A` 来说明我们为哪种类型提供了 `show` 的实现；相反，像 `Show` 这样的正常特征不会。 +2. 要将 show 功能添加到特定类型 `A`，正常 trait 需要 `A extends Show`，而对于类型类，我们需要实现 `Showable[A]`。 +3. 为了在两个 `Showable` 中允许相同的方法调用语法来模仿 `Show`，我们将 `Showable.show` 定义为扩展方法。 + +### 实现具体实例 + +下一步是确定在应用程序中，`Showable` 适用于哪些类，然后为它们实现该行为。 +例如，为这个 `Person` 类实现 `Showable`： + +```scala +case class Person(firstName: String, lastName: String) +``` + +你将为 `Showable[Person]` 定义一个 `given` 值。 +这段代码为 `Person` 类提供了一个 `Showable` 的具体实例： + +```scala +given Showable[Person] with + extension(p: Person) def show: String = + s"${p.firstName} ${p.lastName}" +``` + +如图所示，这被定义为 `Person` 类的扩展方法，它使用 `show` 方法主体内的引用 `p`。 + +### 使用类型类 + +现在你可以像这样使用这个类型类： + +```scala +val person = Person("John", "Doe") +println(person.show) +``` + +同样，如果 Scala 没有可用于每个类的 `toString` 方法，您可以使用此技术将 `Showable` 行为添加到您希望能够转换为 `String` 的任何类。 + +### 编写使用类型类的方法 + +与继承一样，您可以定义使用 `Showable` 作为类型参数的方法： + +```scala +def showAll[S: Showable](xs: List[S]): Unit = + xs.foreach(x => println(x.show)) + +showAll(List(Person("Jane"), Person("Mary"))) +``` + +### 具有多种方法的类型类 + +请注意，如果要创建具有多个方法的类型类，则初始语法如下所示： + +```scala +trait HasLegs[A]: + extension (a: A) + def walk(): Unit + def run(): Unit +``` + +### 一个真实的例子 + +有关如何在 Scala 3 中使用类型类的真实示例，请参阅[多元相等性部分][multiversal]中的 `CanEqual` 讨论。 + + +[multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} From c723a2e0b9222d302489b89f37dc7810bcb9625d Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 7 Jun 2022 20:57:09 -0700 Subject: [PATCH 1902/3075] add Scala 2.12.16 --- _config.yml | 2 +- _overviews/jdk-compatibility/overview.md | 8 ++++---- api/all.md | 22 +++++++++++++++------- 3 files changed, 20 insertions(+), 12 deletions(-) diff --git a/_config.yml b/_config.yml index 9d756807cd..034b324714 100644 --- a/_config.yml +++ b/_config.yml @@ -16,7 +16,7 @@ keywords: - Guide scala-version: 2.13.8 -scala-212-version: 2.12.15 +scala-212-version: 2.12.16 scala-3-version: 3.1.2 collections: diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index c00fd2f05f..fb142eb5da 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,10 +12,10 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | JDK version | Minimum Scala versions | Recommended Scala versions | |:-----------:|:---------------------------------|:-----------------------------------------------------------| -| 18 | 2.13.7, 2.12.15 | 2.13.8, 2.12.15 | -| 17 | 2.13.6, 2.12.15 | 2.13.8, 2.12.15 | -| 11 | 2.13.0, 2.12.4, 2.11.12 | 2.13.8, 2.12.15, 2.11.12 | -| 8 | 2.13.0, 2.12.0, 2.11.0, 2.10.2 | 2.13.8, 2.12.15, 2.11.12, 2.10.7 | +| 18 | 2.13.7, 2.12.15 | 2.13.8, 2.12.16 | +| 17 | 2.13.6, 2.12.15 | 2.13.8, 2.12.16 | +| 11 | 2.13.0, 2.12.4, 2.11.12 | 2.13.8, 2.12.16, 2.11.12 | +| 8 | 2.13.0, 2.12.0, 2.11.0, 2.10.2 | 2.13.8, 2.12.16, 2.11.12, 2.10.7 | | 6, 7 | 2.11.0, 2.10.0 | 2.11.12, 2.10.7 | Even when a version combination isn't listed as supported, most features may still work. (But Scala 2.12+ definitely doesn't work at all on JDK 6 or 7.) diff --git a/api/all.md b/api/all.md index 33566543b6..21330fa4b8 100644 --- a/api/all.md +++ b/api/all.md @@ -12,14 +12,14 @@ includeTOC: true * [Library API](https://www.scala-lang.org/api/2.13.8/) * [Compiler API](https://www.scala-lang.org/api/2.13.8/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.8/scala-reflect/scala/reflect/) -* Scala 2.12.15 - * [Library API](https://www.scala-lang.org/api/2.12.15/) - * [Compiler API](https://www.scala-lang.org/api/2.12.15/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.12.15/scala-reflect/scala/reflect/) +* Scala 2.12.16 + * [Library API](https://www.scala-lang.org/api/2.12.16/) + * [Compiler API](https://www.scala-lang.org/api/2.12.16/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.12.16/scala-reflect/scala/reflect/) * Scala Modules - * [XML API](https://www.scala-lang.org/api/2.12.15/scala-xml/scala/xml/) - * [Parser Combinators API](https://www.scala-lang.org/api/2.12.15/scala-parser-combinators/scala/util/parsing/) - * [Swing API](https://www.scala-lang.org/api/2.12.15/scala-swing/scala/swing/) + * [XML API](https://www.scala-lang.org/api/2.12.16/scala-xml/scala/xml/) + * [Parser Combinators API](https://www.scala-lang.org/api/2.12.16/scala-parser-combinators/scala/util/parsing/) + * [Swing API](https://www.scala-lang.org/api/2.12.16/scala-swing/scala/swing/) * Scala 2.11.12 * [Library API](https://www.scala-lang.org/api/2.11.12/) * [Compiler API](https://www.scala-lang.org/api/2.11.12/scala-compiler/) @@ -102,6 +102,14 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/2.13.0/) * [Compiler API](https://www.scala-lang.org/api/2.13.0/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.0/scala-reflect/scala/reflect/) +* Scala 2.12.15 + * [Library API](https://www.scala-lang.org/api/2.12.15/) + * [Compiler API](https://www.scala-lang.org/api/2.12.15/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.12.15/scala-reflect/scala/reflect/) + * Scala Modules + * [XML API](https://www.scala-lang.org/api/2.12.15/scala-xml/scala/xml/) + * [Parser Combinators API](https://www.scala-lang.org/api/2.12.15/scala-parser-combinators/scala/util/parsing/) + * [Swing API](https://www.scala-lang.org/api/2.12.15/scala-swing/scala/swing/) * Scala 2.12.14 * [Library API](https://www.scala-lang.org/api/2.12.14/) * [Compiler API](https://www.scala-lang.org/api/2.12.14/scala-compiler/scala/) From c696594f5996937baae3db30c06e3e9e4fd33e7b Mon Sep 17 00:00:00 2001 From: Philippus Baalman Date: Wed, 8 Jun 2022 07:40:05 +0200 Subject: [PATCH 1903/3075] Update checkout action to v3 --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 808f492a7d..185d285edc 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -4,7 +4,7 @@ jobs: build: runs-on: ubuntu-20.04 steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 - name: Set up Ruby uses: ruby/setup-ruby@v1 with: From 17e388dde18b48bd4341ef5d62173e093b202e89 Mon Sep 17 00:00:00 2001 From: Brian Yue Date: Wed, 8 Jun 2022 20:29:11 +0800 Subject: [PATCH 1904/3075] Unified the zh-cn translation of case class --- _zh-cn/glossary/index.md | 2 +- _zh-cn/tour/case-classes.md | 18 +++++++++--------- _zh-cn/tour/pattern-matching.md | 8 ++++---- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/_zh-cn/glossary/index.md b/_zh-cn/glossary/index.md index dc82232e3f..210c56108b 100644 --- a/_zh-cn/glossary/index.md +++ b/_zh-cn/glossary/index.md @@ -17,7 +17,7 @@ language: zh-cn
      * #### 代数数据类型（algebraic data type） -通过提供若干个带有独立构造器的备选项来定义的类型。它一般通过模式匹配的方式来结构类型，在规约语言和函数式编程语言中常见到这个概念。Scala可通过案例类来模拟代数数据类型。 +通过提供若干个带有独立构造器的备选项来定义的类型。它一般通过模式匹配的方式来结构类型，在规约语言和函数式编程语言中常见到这个概念。Scala可通过样例类来模拟代数数据类型。 * #### 备选项（alternative） match表达式的一个分支，形如 “`case` _pattern_ => _expression_”。备选项的别名是 _案例_（_case_）。 diff --git a/_zh-cn/tour/case-classes.md b/_zh-cn/tour/case-classes.md index cbff24d6e9..15a2dbf4cb 100644 --- a/_zh-cn/tour/case-classes.md +++ b/_zh-cn/tour/case-classes.md @@ -1,6 +1,6 @@ --- layout: tour -title: 案例类（Case Classes） +title: 样例类（Case Classes） partof: scala-tour num: 10 @@ -11,18 +11,18 @@ next-page: pattern-matching previous-page: multiple-parameter-lists --- -案例类（Case classes）和普通类差不多，只有几点关键差别，接下来的介绍将会涵盖这些差别。案例类非常适合用于不可变的数据。下一节将会介绍他们在[模式匹配](pattern-matching.html)中的应用。 +样例类（Case classes）和普通类差不多，只有几点关键差别，接下来的介绍将会涵盖这些差别。样例类非常适合用于不可变的数据。下一节将会介绍他们在[模式匹配](pattern-matching.html)中的应用。 -## 定义一个案例类 -一个最简单的案例类定义由关键字`case class`，类名，参数列表（可为空）组成： +## 定义一个样例类 +一个最简单的样例类定义由关键字`case class`，类名，参数列表（可为空）组成： ```scala mdoc case class Book(isbn: String) val frankenstein = Book("978-0486282114") ``` -注意在实例化案例类`Book`时，并没有使用关键字`new`，这是因为案例类有一个默认的`apply`方法来负责对象的创建。 +注意在实例化样例类`Book`时，并没有使用关键字`new`，这是因为样例类有一个默认的`apply`方法来负责对象的创建。 -当你创建包含参数的案例类时，这些参数是公开（public）的`val` +当你创建包含参数的样例类时，这些参数是公开（public）的`val` ``` case class Message(sender: String, recipient: String, body: String) val message1 = Message("guillaume@quebec.ca", "jorge@catalonia.es", "Ça va ?") @@ -30,10 +30,10 @@ val message1 = Message("guillaume@quebec.ca", "jorge@catalonia.es", "Ça va ?") println(message1.sender) // prints guillaume@quebec.ca message1.sender = "travis@washington.us" // this line does not compile ``` -你不能给`message1.sender`重新赋值，因为它是一个`val`（不可变）。在案例类中使用`var`也是可以的，但并不推荐这样。 +你不能给`message1.sender`重新赋值，因为它是一个`val`（不可变）。在样例类中使用`var`也是可以的，但并不推荐这样。 ## 比较 -案例类在比较的时候是按值比较而非按引用比较： +样例类在比较的时候是按值比较而非按引用比较： ``` case class Message(sender: String, recipient: String, body: String) @@ -44,7 +44,7 @@ val messagesAreTheSame = message2 == message3 // true 尽管`message2`和`message3`引用不同的对象，但是他们的值是相等的，所以`message2 == message3`为`true`。 ## 拷贝 -你可以通过`copy`方法创建一个案例类实例的浅拷贝，同时可以指定构造参数来做一些改变。 +你可以通过`copy`方法创建一个样例类实例的浅拷贝，同时可以指定构造参数来做一些改变。 ``` case class Message(sender: String, recipient: String, body: String) val message4 = Message("julien@bretagne.fr", "travis@washington.us", "Me zo o komz gant ma amezeg") diff --git a/_zh-cn/tour/pattern-matching.md b/_zh-cn/tour/pattern-matching.md index dce4cd0e69..36ad508a7c 100644 --- a/_zh-cn/tour/pattern-matching.md +++ b/_zh-cn/tour/pattern-matching.md @@ -42,9 +42,9 @@ matchTest(1) // one ``` 这个`match`表达式是String类型的，因为所有的情况（case）均返回String，所以`matchTest`函数的返回值是String类型。 -## 案例类（case classes）的匹配 +## 样例类（case classes）的匹配 -案例类非常适合用于模式匹配。 +样例类非常适合用于模式匹配。 ```scala mdoc abstract class Notification @@ -58,7 +58,7 @@ case class VoiceRecording(contactName: String, link: String) extends Notificatio ``` -`Notification` 是一个虚基类，它有三个具体的子类`Email`, `SMS`和`VoiceRecording`，我们可以在这些案例类(Case Class)上像这样使用模式匹配： +`Notification` 是一个虚基类，它有三个具体的子类`Email`, `SMS`和`VoiceRecording`，我们可以在这些样例类(Case Class)上像这样使用模式匹配： ``` def showNotification(notification: Notification): String = { @@ -147,5 +147,5 @@ def findPlaceToSit(piece: Furniture): String = piece match { ## 备注 -Scala的模式匹配语句对于使用[案例类（case classes）](case-classes.html)表示的类型非常有用，同时也可以利用[提取器对象（extractor objects）](extractor-objects.html)中的`unapply`方法来定义非案例类对象的匹配。 +Scala的模式匹配语句对于使用[样例类（case classes）](case-classes.html)表示的类型非常有用，同时也可以利用[提取器对象（extractor objects）](extractor-objects.html)中的`unapply`方法来定义非样例类对象的匹配。 From 0c00bf91b12ce425f1441f9177d26888cf701a40 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 8 Jun 2022 15:52:53 +0200 Subject: [PATCH 1905/3075] add sticky help message to get started --- _includes/getting-started.md | 6 ++++ _plugins/alt-details-lib/alt-details.rb | 7 ++++- _plugins/alt-details-lib/template.erb | 2 +- _sass/base/helper.scss | 42 +++++++++++++++---------- _sass/components/alt-details.scss | 19 +++++++++++ _sass/layout/footer.scss | 2 +- 6 files changed, 59 insertions(+), 19 deletions(-) diff --git a/_includes/getting-started.md b/_includes/getting-started.md index 491859f405..8947879e11 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -1,5 +1,11 @@ The instructions below cover both Scala 2 and Scala 3. +
      +{% altDetails need-help-info-box 'Need Help?' class=help-info %} +*If you are having trouble with setting up Scala, feel free to ask for help in the [#scala-users](https://discord.com/channels/632150470000902164/632150470000902166) channel of our Discord.* +{% endaltDetails %} +
      + ## Try Scala without installing anything To start experimenting with Scala right away, use “Scastie” in your browser. diff --git a/_plugins/alt-details-lib/alt-details.rb b/_plugins/alt-details-lib/alt-details.rb index 4ddbee64f4..f7bf5058a6 100644 --- a/_plugins/alt-details-lib/alt-details.rb +++ b/_plugins/alt-details-lib/alt-details.rb @@ -3,7 +3,7 @@ module Jekyll module AltDetails class AltDetailsBlock < Liquid::Block - SYNTAX = /^\s*(#{Liquid::QuotedFragment})\s+(#{Liquid::QuotedFragment})/o + SYNTAX = /^\s*(#{Liquid::QuotedFragment})\s+(#{Liquid::QuotedFragment})(?=\s+class=(#{Liquid::QuotedFragment}))?/o Syntax = SYNTAX alias_method :render_block, :render @@ -18,6 +18,11 @@ def initialize(block_name, markup, tokens) if markup =~ SYNTAX @name = unquote($1) @title = unquote($2) + @css_classes = "" + if $3 + # append $3 to @css_classes + @css_classes = "#{@css_classes} #{unquote($3)}" + end else raise SyntaxError.new("Block #{block_name} requires an id and a title") end diff --git a/_plugins/alt-details-lib/template.erb b/_plugins/alt-details-lib/template.erb index 6aba6f127f..95d65eb3ef 100644 --- a/_plugins/alt-details-lib/template.erb +++ b/_plugins/alt-details-lib/template.erb @@ -1,5 +1,5 @@
      -
      +
      diff --git a/_sass/base/helper.scss b/_sass/base/helper.scss index d0f6281ea0..dc1ed0ddc0 100755 --- a/_sass/base/helper.scss +++ b/_sass/base/helper.scss @@ -3,35 +3,45 @@ //------------------------------------------------ .wrap { - @include outer-container; - @include padding(0 20px); + @include outer-container; + @include padding(0 20px); } .place-inline { - // add vertical margin - @include outer-container; - @include margin(20px 0); + // add vertical margin + @include outer-container; + @include margin(20px 0); +} + +.inline-sticky-top { + position: sticky; + top: 15px; + background: #fff; + -webkit-box-shadow: 0 0 18px 20px #fff; + -moz-box-shadow: 0 0 18px 20px #fff; + box-shadow: 0 0 18px 20px #fff; + z-index: 999; } .wrap-inline { - // add vertical padding - @include outer-container; - @include padding(20px 0); + // add vertical padding + @include outer-container; + @include padding(20px 0); } .wrap-tab { - @extend .wrap-narrow; - margin-top: 20px; - margin-bottom: 20px; + @extend .wrap-narrow; + margin-top: 20px; + margin-bottom: 20px; } .wrap-narrow { - @include outer-container; - @include padding(0 10px); + @include outer-container; + @include padding(0 10px); } .dot { - font-size: 10px; - color: rgba($base-font-color-light, 0.6); - margin: 0 3px; + font-size: 10px; + color: rgba($base-font-color-light, 0.6); + margin: 0 3px; } diff --git a/_sass/components/alt-details.scss b/_sass/components/alt-details.scss index b058364039..c86febae5d 100644 --- a/_sass/components/alt-details.scss +++ b/_sass/components/alt-details.scss @@ -2,6 +2,21 @@ //------------------------------------------------ //------------------------------------------------ +.alt-details.help-info { + .alt-details-toggle { + background-color: $brand-primary; + color: white; + + &:hover { + background-color: darken($brand-primary, 15%); + } + } + + .alt-details-detail { + background: #fae6e6 + } +} + .alt-details { @include span-columns(12); @@ -35,6 +50,10 @@ } + .alt-details-control { + margin: 0; + } + .alt-details-control+.alt-details-toggle+.alt-details-detail { // by default, hide the details position: absolute; diff --git a/_sass/layout/footer.scss b/_sass/layout/footer.scss index d21eb9e50e..e6f690fd4e 100755 --- a/_sass/layout/footer.scss +++ b/_sass/layout/footer.scss @@ -84,7 +84,7 @@ text-align: center; z-index: 2; color: #f0f3f3; - background-color: #dc322f; + background-color: $brand-primary; border-radius: 50%; display: none; From 9ef32aad6dfce882b26bee45191806a9ae015fe0 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 8 Jun 2022 16:18:55 +0200 Subject: [PATCH 1906/3075] address feedback --- _includes/getting-started.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_includes/getting-started.md b/_includes/getting-started.md index 8947879e11..e05bacfcb9 100644 --- a/_includes/getting-started.md +++ b/_includes/getting-started.md @@ -2,7 +2,8 @@ The instructions below cover both Scala 2 and Scala 3.
      {% altDetails need-help-info-box 'Need Help?' class=help-info %} -*If you are having trouble with setting up Scala, feel free to ask for help in the [#scala-users](https://discord.com/channels/632150470000902164/632150470000902166) channel of our Discord.* +*If you are having trouble with setting up Scala, feel free to ask for help in the `#scala-users` channel of +[our Discord](https://discord.com/invite/scala).* {% endaltDetails %}
      From f0ecd188282d9583d0538725facb5566a1b43d09 Mon Sep 17 00:00:00 2001 From: shorla Date: Wed, 8 Jun 2022 17:46:54 +0100 Subject: [PATCH 1907/3075] Indentation for scala 2 reference made consistent as others --- _overviews/scala3-book/taste-control-structures.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/taste-control-structures.md b/_overviews/scala3-book/taste-control-structures.md index b55e9433b3..13e55a4233 100644 --- a/_overviews/scala3-book/taste-control-structures.md +++ b/_overviews/scala3-book/taste-control-structures.md @@ -50,11 +50,11 @@ The `if`/`else` control struture in Scala 2 was constructed differently, with pa ```scala // Scala 2 syntax if (test1) { - doX() + doX() } else if (test2) { - doY() + doY() } else { - doZ() + doZ() } ``` From 170877ab681425c5c560621ff7106a6d0200748c Mon Sep 17 00:00:00 2001 From: Maximilien Tirard Date: Thu, 9 Jun 2022 00:19:02 +0100 Subject: [PATCH 1908/3075] Fixed error in detailed inlining steps --- _overviews/scala3-macros/tutorial/inline.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-macros/tutorial/inline.md b/_overviews/scala3-macros/tutorial/inline.md index e27d610b18..c900e30401 100644 --- a/_overviews/scala3-macros/tutorial/inline.md +++ b/_overviews/scala3-macros/tutorial/inline.md @@ -276,8 +276,8 @@ val x = 2 val x2 = x * x x2 * { if (0 == 0) 1.0 - else if (0 % 2 == 1) x * power(x, 0 - 1) // dead branch - else power(x * x, 0 / 2) // dead branch + else if (0 % 2 == 1) x * power(x2, 0 - 1) // dead branch + else power(x2 * x2, 0 / 2) // dead branch } // partially evaluated to val x = 2 From 56d3742b8e9433ae314ec07c8864348a703c6256 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Thu, 9 Jun 2022 09:06:28 +0200 Subject: [PATCH 1909/3075] Update _overviews/scala3-macros/tutorial/inline.md --- _overviews/scala3-macros/tutorial/inline.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/inline.md b/_overviews/scala3-macros/tutorial/inline.md index c900e30401..79ce94e4ba 100644 --- a/_overviews/scala3-macros/tutorial/inline.md +++ b/_overviews/scala3-macros/tutorial/inline.md @@ -276,7 +276,7 @@ val x = 2 val x2 = x * x x2 * { if (0 == 0) 1.0 - else if (0 % 2 == 1) x * power(x2, 0 - 1) // dead branch + else if (0 % 2 == 1) x2 * power(x2, 0 - 1) // dead branch else power(x2 * x2, 0 / 2) // dead branch } // partially evaluated to From eaa060944964c144ab1976a256b92b30e31779c3 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Thu, 9 Jun 2022 16:30:34 +0200 Subject: [PATCH 1910/3075] Update SIPs state --- _sips/sips/2011-10-13-uncluttering-control.md | 123 -- _sips/sips/2012-03-09-self-cleaning-macros.md | 16 - _sips/sips/2012-03-30-source-locations.md | 66 -- ...-05-31-improved-lazy-val-initialization.md | 749 ------------ _sips/sips/2013-06-10-spores.md | 459 -------- _sips/sips/2013-06-30-async.md | 298 ----- _sips/sips/2015-6-18-repeated-byname.md | 34 - _sips/sips/2016-01-11-static-members.md | 219 ---- _sips/sips/2016-07-25-unsigned-integers.md | 636 ----------- _sips/sips/2016-09-09-inline-meta.md | 1012 ----------------- ...017-01-11-refer-other-arguments-in-args.md | 107 -- _sips/sips/2017-01-13-binary-compatibility.md | 299 ----- .../2017-02-22-comonadic-comprehensions.md | 223 ---- _sips/sips/2017-10-25-adding-prefix-types.md | 194 ---- _sips/sips/2018-05-26-case-if.md | 115 -- .../2019-07-27-binary-integer-literals.md | 32 - _sips/sips/2019-08-11-curried-varargs.md | 271 ----- _sips/sips/2019-10-24-name-based-xml.md | 421 ------- _sips/sips/2021-05-18-sealed-types.md | 278 ----- .../{2014-06-27-42.type.md => 42.type.md} | 3 +- _sips/sips/adding-prefix-types.md | 7 + ...o-other-arguments-in-default-parameters.md | 7 + _sips/sips/async.md | 6 + ...yname-implicits.md => byname-implicits.md} | 6 +- _sips/sips/comonadic-comprehensions.md | 6 + ...partialfunctions-and-extractor-objects.md} | 6 +- _sips/sips/curried-varargs.md | 7 + ...nitions.md => early-member-definitions.md} | 4 +- ...utures-promises.md => futures-promises.md} | 4 +- ...mplicit-classes.md => implicit-classes.md} | 4 +- _sips/sips/implicit-source-locations.md | 6 + .../sips/improved-lazy-vals-initialization.md | 6 + ...ing-binary-compatibility-with-stableabi.md | 6 + _sips/sips/inline-meta.md | 6 + ...s.md => internals-of-scala-annotations.md} | 4 +- ...scape.md => interpolation-quote-escape.md} | 262 ++--- ...s.md => modularizing-language-features.md} | 5 +- _sips/sips/name-based-xml-literals.md | 7 + ...ents.md => named-and-default-arguments.md} | 4 +- ...n-classes.md => new-collection-classes.md} | 4 +- ...-09-20-opaque-types.md => opaque-types.md} | 7 +- ...ked-signatures.md => picked-signatures.md} | 4 +- ...> priority-based-infix-type-precedence.md} | 3 +- ...trait-parameters.md => rait-parameters.md} | 6 +- _sips/sips/repeated-by-name-parameters.md | 6 + ...=> right-associative-by-name-operators.md} | 6 +- ...cala-2-8-arrays.md => scala-2-8-arrays.md} | 4 +- ...n.md => scala-compiler-phase-plugin-in.md} | 4 +- ...cialization.md => scala-specialization.md} | 4 +- ...ng-overview.md => scala-swing-overview.md} | 4 +- _sips/sips/sealed-types.md | 7 + _sips/sips/self-cleaning-macros.md | 6 + _sips/sips/spores.md | 6 + ...ds-and-methods-in-scala-objects-si-4581.md | 6 + ...terpolation.md => string-interpolation.md} | 4 +- _sips/sips/support-binary-integer-literals.md | 7 + ...-trailing-commas.md => trailing-commas.md} | 6 +- ...-03-13-type-dynamic.md => type-dynamic.md} | 5 +- _sips/sips/uncluttering-abuse-of-match.md | 7 + ...ng-scalas-syntax-for-control-structures.md | 6 + _sips/sips/unsigned-integers.md | 6 + ...1-30-value-classes.md => value-classes.md} | 7 +- 62 files changed, 313 insertions(+), 5730 deletions(-) delete mode 100644 _sips/sips/2011-10-13-uncluttering-control.md delete mode 100644 _sips/sips/2012-03-09-self-cleaning-macros.md delete mode 100644 _sips/sips/2012-03-30-source-locations.md delete mode 100644 _sips/sips/2013-05-31-improved-lazy-val-initialization.md delete mode 100644 _sips/sips/2013-06-10-spores.md delete mode 100644 _sips/sips/2013-06-30-async.md delete mode 100644 _sips/sips/2015-6-18-repeated-byname.md delete mode 100644 _sips/sips/2016-01-11-static-members.md delete mode 100644 _sips/sips/2016-07-25-unsigned-integers.md delete mode 100644 _sips/sips/2016-09-09-inline-meta.md delete mode 100644 _sips/sips/2017-01-11-refer-other-arguments-in-args.md delete mode 100644 _sips/sips/2017-01-13-binary-compatibility.md delete mode 100644 _sips/sips/2017-02-22-comonadic-comprehensions.md delete mode 100644 _sips/sips/2017-10-25-adding-prefix-types.md delete mode 100644 _sips/sips/2018-05-26-case-if.md delete mode 100644 _sips/sips/2019-07-27-binary-integer-literals.md delete mode 100644 _sips/sips/2019-08-11-curried-varargs.md delete mode 100644 _sips/sips/2019-10-24-name-based-xml.md delete mode 100644 _sips/sips/2021-05-18-sealed-types.md rename _sips/sips/{2014-06-27-42.type.md => 42.type.md} (99%) create mode 100644 _sips/sips/adding-prefix-types.md create mode 100644 _sips/sips/allow-referring-to-other-arguments-in-default-parameters.md create mode 100644 _sips/sips/async.md rename _sips/sips/{2017-11-20-byname-implicits.md => byname-implicits.md} (99%) create mode 100644 _sips/sips/comonadic-comprehensions.md rename _sips/sips/{2018-08-20-converters-among-optional-functions-partialfunctions-and-extractor-objects.md => converters-among-optional-functions-partialfunctions-and-extractor-objects.md} (97%) create mode 100644 _sips/sips/curried-varargs.md rename _sips/sips/{2009-06-02-early-member-definitions.md => early-member-definitions.md} (73%) rename _sips/sips/{2012-01-21-futures-promises.md => futures-promises.md} (99%) rename _sips/sips/{2011-10-12-implicit-classes.md => implicit-classes.md} (97%) create mode 100644 _sips/sips/implicit-source-locations.md create mode 100644 _sips/sips/improved-lazy-vals-initialization.md create mode 100644 _sips/sips/improving-binary-compatibility-with-stableabi.md create mode 100644 _sips/sips/inline-meta.md rename _sips/sips/{2010-01-27-internals-of-scala-annotations.md => internals-of-scala-annotations.md} (74%) rename _sips/sips/{2018-07-31-interpolation-quote-escape.md => interpolation-quote-escape.md} (96%) rename _sips/sips/{2012-03-17-modularizing-language-features.md => modularizing-language-features.md} (86%) create mode 100644 _sips/sips/name-based-xml-literals.md rename _sips/sips/{2010-01-22-named-and-default-arguments.md => named-and-default-arguments.md} (99%) rename _sips/sips/{2010-07-20-new-collection-classes.md => new-collection-classes.md} (73%) rename _sips/sips/{2017-09-20-opaque-types.md => opaque-types.md} (99%) rename _sips/sips/{2010-06-01-picked-signatures.md => picked-signatures.md} (75%) rename _sips/sips/{2017-02-07-priority-based-infix-type-precedence.md => priority-based-infix-type-precedence.md} (99%) rename _sips/sips/{2015-6-18-trait-parameters.md => rait-parameters.md} (97%) create mode 100644 _sips/sips/repeated-by-name-parameters.md rename _sips/sips/{2017-07-12-right-associative-by-name-operators.md => right-associative-by-name-operators.md} (97%) rename _sips/sips/{2010-01-22-scala-2-8-arrays.md => scala-2-8-arrays.md} (99%) rename _sips/sips/{2009-05-28-scala-compiler-phase-plugin-in.md => scala-compiler-phase-plugin-in.md} (76%) rename _sips/sips/{2010-05-06-scala-specialization.md => scala-specialization.md} (72%) rename _sips/sips/{2009-11-02-scala-swing-overview.md => scala-swing-overview.md} (72%) create mode 100644 _sips/sips/sealed-types.md create mode 100644 _sips/sips/self-cleaning-macros.md create mode 100644 _sips/sips/spores.md create mode 100644 _sips/sips/static-fields-and-methods-in-scala-objects-si-4581.md rename _sips/sips/{2011-10-13-string-interpolation.md => string-interpolation.md} (69%) create mode 100644 _sips/sips/support-binary-integer-literals.md rename _sips/sips/{2016-06-25-trailing-commas.md => trailing-commas.md} (98%) rename _sips/sips/{2012-03-13-type-dynamic.md => type-dynamic.md} (85%) create mode 100644 _sips/sips/uncluttering-abuse-of-match.md create mode 100644 _sips/sips/uncluttering-scalas-syntax-for-control-structures.md create mode 100644 _sips/sips/unsigned-integers.md rename _sips/sips/{2012-01-30-value-classes.md => value-classes.md} (97%) diff --git a/_sips/sips/2011-10-13-uncluttering-control.md b/_sips/sips/2011-10-13-uncluttering-control.md deleted file mode 100644 index e1ceb5d790..0000000000 --- a/_sips/sips/2011-10-13-uncluttering-control.md +++ /dev/null @@ -1,123 +0,0 @@ ---- -layout: sip -title: SIP-12 - Uncluttering Scala’s syntax for control structures. - -vote-status: rejected -vote-text: The committee votes unanimously to reject the change. The conclusion is that there is not a clear benefit for it and the required invested time and efforts would be too high. For more explanation, read the minutes. -permalink: /sips/:title.html -redirect_from: /sips/pending/uncluttering-control.html ---- - -**By: Martin Odersky** - -## Motivation ## - -The more Scala code I write the more I get tripped up by the need to write conditions in if-then-else expressions and other control constructs in parentheses. I normally would not advocate syntax changes at this level, except that this has been the single syntax decision that feels worse for me the longer I use it. - -## Part 1: if ## - -Having to write parentheses is an unfortunate inheritance from C via Java. It makes code more cluttered than it could be. In C/C++/Java this was no big deal, but because Scala is much cleaner syntactically than these languages it starts to stick out like a sore thumb. This in particular because only one form of `if` comes with parentheses; if you use an if as a filter in a for expression or as a guard in a pattern, no parentheses are required. - -So, here is the proposal (for Scala 2.10): - -1. Introduce a new keyword, `then`. - -2. Allow the following alternative syntax form: - - if expression then expression [else expression] - -3. At some point in the future (there’s no rush) we could deprecate the form - - if (expression) expression else expression - - and then remove it. - - -Once we have dealt with if, we should do the same thing with while, do-while and for. - -## Part 2: do-while ## - -do-while is easy. Simply do the following: - -1. Allow - - do expression while expression - - as syntax (i.e. drop the required parentheses around the condition). - -While loops and for loops are more tricky. - -## Part 3: while ## - -For while loops: - -1. Allow - - while expression do expression - - as syntax.We then have to deal with an ambiguity: What should we do with - - while (expression1) do expression2 while (expression3) - - ? I.e. a `do-while` loop inside an old-style `while` loop? Here’s a possible migration strategy. - -2. In Scala 2.10: Introduce - - while expression1 do expression2 - - where `expression1` is not allowed to have parentheses at the outermost level (there’s no need to have them anyway). Also, emit a deprecation warning if the compiler comes across a do-while nested directly in an old-style while: - - while (expression1) do expression2 while expression3 - - To write a `do-while` inside a `while` loop you will need braces, like this: - - while (expression1) { do expression2 while expression3 } - -3. In Scala 2.11: Disallow - - while (expression1) do expression2 while expression3 - -4. In Scala 2.12: Drop the restriction introduced in 2.10. Conditions in a `while-do` can now be arbitrary expressions including with parentheses at the outside. - -## Part 4: for ## - -For-loops and for expressions can be handled similarly: - -1. Allow - - for enumerators yield expression - - as syntax. Enumerators are treated as if they were in braces, i.e. newlines can separate generators without the need for additional semicolons. - -2. Allow - - for enumerators do expression - - as syntax. Treat `do-while` ambiguities as in the case for `while`. - -3. At some point in the future: deprecate, and then drop the syntax - - for (enumerators) expression - for {enumerators} expression - for (enumerators) yield expression - for {enumerators} yield expression - -## Examples ## - -Here are some examples of expressions enabled by the changes. - - if x < y then x else y - - while x >= y do x /= 2 - - for x <- 1 to 10; y <- 1 to 10 do println(x * y) - - for - x <- 0 until N - y <- 0 until N - if isPrime(x + y) - yield (x, y) - -## Discussion ## - -The new syntax removes more cases than it introduces. It also removes several hard to remember and non-orthogonal rules where you need parentheses, where you can have braces, and what the difference is. It thus makes the language simpler, more regular, and more pleasant to use. Some tricky situations with migration can be dealt with; and should apply anyway only in rare cases. diff --git a/_sips/sips/2012-03-09-self-cleaning-macros.md b/_sips/sips/2012-03-09-self-cleaning-macros.md deleted file mode 100644 index 32d50df49f..0000000000 --- a/_sips/sips/2012-03-09-self-cleaning-macros.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -layout: sip -title: SIP-16 - Self-cleaning Macros - -vote-status: rejected -vote-text: The proposal is rejected unanimously because Scala Meta, the successor metaprogramming tool, is coming soon. For more explanation, read the minutes. -permalink: /sips/:title.html -redirect_from: /sips/pending/self-cleaning-macros.html ---- - - -This SIP is an embedded google document. If you have trouble with this embedded document, you can visit the [document on Google Docs](https://docs.google.com/document/d/1O879Iz-567FzVb8kw6N5OBpei9dnbW0ZaT7-XNSa6Cs/edit?hl=en_US). - - diff --git a/_sips/sips/2012-03-30-source-locations.md b/_sips/sips/2012-03-30-source-locations.md deleted file mode 100644 index b80c95b23b..0000000000 --- a/_sips/sips/2012-03-30-source-locations.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -layout: sip -title: SIP-19 - Implicit Source Locations -vote-status: rejected -vote-text: The proposal is rejected. We expect this to be easily implemented using macros without going through a full SIP. A modern implementation can be found here. -permalink: /sips/:title.html -redirect_from: /sips/pending/source-locations.html ---- - -**Philipp Haller** - -**30 March 2012** - -## Motivation ## - -The Scala compiler's error messages would be nearly useless if they wouldn't provide the corresponding source location, that is, file name, line number, and (some representation of the) character offset, of each error. However, source locations are also very useful outside of the compiler. Libraries and frameworks routinely deal with application- or system-level errors (usually in the form of exceptions), logging, debugging support through tracing, etc. All of these aspects greatly benefit from source location information. - -Moreover, embedded domain-specific languages often depend upon source location information for providing useful error messages. Domain-specific languages that employ staging for code generation can use source locations for debug information in the generated code. - -This proposal discusses a minimal extension of Scala's implicit parameters to provide access to the source location of method invocations. The design is analogous to the way manifests are generated by the compiler, and should therefore be natural to anyone familiar with manifests in Scala. - -## Example ## - -To obtain the source location for each invocation of a method `debug`, say, one adds an implicit parameter of type `SourceLocation`: - - def debug(message: String)(implicit loc: SourceLocation): Unit = { - println("@" + loc.fileName + ":" + loc.line + ": " + message) - } - -This means that inside the body of the `debug` method, we can access the source location of its current invocation through the `loc` parameter. For example, suppose -we are invoking `debug` on line `34` in a file `"MyApp.scala"`: - - 34: if (debugEnabled) debug("debug message") - -Assuming `debugEnabled` evaluates to `true`, the above expression would lead to the following output: - - @MyApp.scala:34: debug message - -## The SourceLocation Trait ## - -The `SourceLocation` trait is a new type member of the `scala.reflect` package. It has the following members: - - trait SourceLocation { - /** The name of the source file */ - def fileName: String - - /** The line number */ - def line: Int - - /** The character offset */ - def charOffset: Int - } - -## Specification ## - -Implicit source locations are supported through the following small addition to Scala's implicit rules. - -If an implicit parameter of a method or constructor is of type `SourceLocation`, a source location object is determined according to the following rules. - -First, if there is already an implicit argument of type `SourceLocation`, this argument is selected. Otherwise, an instance of `SourceLocation` is generated by invoking the `apply` method of the object `scala.reflect.SourceLocation`, passing the components of the source location as arguments. - -## Implementation ## - -An implementation of this proposal can be found at: [https://github.com/phaller/scala/tree/topic/source-location](https://github.com/phaller/scala/tree/topic/source-location) - -An extension of this proposal is also part of Scala-Virtualized. The extension adds a subtrait `SourceContext` which in addition provides access to information, such as variable names in the context of a method invocation. More information can be found at: [https://github.com/TiarkRompf/scala-virtualized/wiki/SourceLocation-and-SourceContext](https://github.com/TiarkRompf/scala-virtualized/wiki/SourceLocation-and-SourceContext) diff --git a/_sips/sips/2013-05-31-improved-lazy-val-initialization.md b/_sips/sips/2013-05-31-improved-lazy-val-initialization.md deleted file mode 100644 index 1efe9e9eab..0000000000 --- a/_sips/sips/2013-05-31-improved-lazy-val-initialization.md +++ /dev/null @@ -1,749 +0,0 @@ ---- -layout: sip -title: SIP-20 - Improved Lazy Vals Initialization -vote-status: dormant -vote-text: This proposal lacks an implementation for Scalac and is looking for a new owner. -permalink: /sips/:title.html -redirect_from: /sips/pending/improved-lazy-val-initialization.html ---- - -**By: Aleksandar Prokopec, Dmitry Petrashko, Miguel Garcia, Jason Zaugg, Hubert Plociniczak, Viktor Klang, Martin Odersky** - - -## Abstract ## - -This SIP describes the changes in the lazy vals initialization mechanism that address some of the unnecessary deadlock scenarios. The newly proposed lazy val initialization mechanism aims to eliminate the acquisition of resources during the execution of the lazy val initializer block, thus reducing the possibility of a deadlock. The concrete deadlock scenarios that the new lazy val initialization scheme eliminates are summarized below. - -The changes in this SIP have previously been discussed in depth on the mailing lists \[[1][1]\] \[[2][2]\] \[[9][9]\] \[[10][10]\]. - - -## Description ## - -The current lazy val initialization scheme uses double-checked locking to initialize the lazy val only once. A separate volatile bitmap field is used to store the state of the lazy val - a single bit in this bitmap denotes whether the lazy val is initialized or not. -Assume we have the following declaration. - - final class LazyCell { - lazy val value = - } - -Here is an example of a manually written implementation equivalent to what the compiler currently does: - - final class LazyCell { - @volatile var bitmap_0: Boolean = false - var value_0: Int = _ - private def value_lzycompute(): Int = { - this.synchronized { - if (!bitmap_0) { - value_0 = - bitmap_0 = true - } - } - value_0 - } - def value = if (bitmap_0) value_0 else value_lzycompute() - } - -We now describe several deadlock scenarios in an attempt to classify deadlocks related to the current lazy val initialization implementation. - -### No circular dependencies ### - -Assume there are two objects A and B with lazy vals `a0` and `a1`, and `b`, respectively: - - object A { - lazy val a0 = B.b - lazy val a1 = 17 - } - - object B { - lazy val b = A.a1 - } - -The initialization block of `a0` above refers to `b` in B, and the initialization of `B.b` refers to `A.a1`. While a circular dependency exists between these two objects, there is no circular dependency **between specific lazy vals** `a0`, `a1` and `b`. - -In the scheme, there exists a possibility of a deadlock if thread Ta attempts to initialize `A.a0` and thread Tb attempts to initialize `B.b`. Assume that both Ta and Tb start their synchronized blocks simultaneously. A deadlock can occur due to each thread trying to grab the lock of the other object, while holding their own lock until the initialization completes. - -This SIP attempts to address this issue. - -### Circular dependencies ### - -Assume there are two objects A and B with lazy vals `a` and `b` respectively, where `a` needs `b` for initialization and vice versa. The current implementation scheme can cause a deadlock in this situation. Furthermore: in a single threaded scenario, circular dependencies between lazy vals lead to stack overflows with the current implementation: - - scala> object Test { - | object A { lazy val a: Int = B.b } - | object B { lazy val b: Int = A.a } - | } - defined object Test - - scala> Test - res0: Test.type = Test$@6fd1046d - - scala> Test.A.a - java.lang.StackOverflowError - -This is considered erroneous code, and this SIP does not attempt to address this. - -### No circular dependencies with other synchronization constructs ### - -Consider the declaration of the following lazy val: - - class A { self => - lazy val x: Int = { - val t = new Thread() { - override def run() { self.synchronized {} } - } - t.start() - t.join() - 1 - } - } - -In the source there appears to be no circular dependency between the lazy val initialization block and the other synchronization construct, so there should be no reason for deadlock. As long as thread `t` completes a condition that the caller depends on and eventually lets go of the current object `self`, the lazy val should be able to initialize itself. - -With the current initialization scheme, however, initializing `x` causes a deadlock. The calling thread initializing `x`, holds the monitor of the current object `self`. The same monitor is needed by thread `t`, since it also synchronizes on `self`, thus causing a deadlock. - -This SIP attempts to address this issue. - -The thread that fulfills the condition that the lazy val initializer block suspends on could on the other hand permanently grab a hold of the monitor of the `self` object. Although this is not strictly speaking a deadlock, it is worth mentioning that the current lazy val initialization implementation might not complete in the following scenario case. - - class A { self => - val latch = new java.util.concurrent.CountDownLatch(1) - val t = new Thread() { - override def run() { - latch.countDown() - self.synchronized { while (true) {} } - } - } - t.start() - lazy val x: Int = { - latch.await() - 1 - } - x - } - -This SIP does not attempt to solve this issue - lazy val initialization semantics assume that the `self` object monitor is available or can be made available throughout the lazy val initialization. - -### Circular dependencies with other synchronization constructs ### - -Consider the declaration of the following lazy val: - - lazy val x: Int = { - val t = new Thread() { - override def run() { println(x) } - } - t.start() - t.join() - 1 - } - -In this code, the lazy val initialization block suspends until a condition is fulfilled. This condition can only be fulfilled by reading the value of lazy val `x` - another thread that is supposed to complete this condition cannot do so. Thus, a circular dependency is formed, and the lazy val cannot be initialized. Similar problems can arise with Scala singleton object initialization \[[3][3]\] when creating threads from the singleton object constructor and waiting for their completion, and with static initializer blocks in Java \[[4][4]\] \[[5][5]\]. - -Note that this problem can also happen if two separate threads try to initialize two singleton objects that refer to each other, which is somewhat more severe. The rule of the thumb for programmers should be - singleton objects should not refer to each other during initialization. - -This is considered an anti-pattern, and this SIP does not attempt to address these issues. - -## Implementation ## - -The solution to the problems that this SIP attempts to address is based on avoiding the acquisition of the current object monitor during the time that the lazy val initializer block executes. Instead of executing the initializer block from within a synchronized block, the synchronized block is run twice, once at the beginning to publicize the information that the initializer block is being run and once after the initializer block to publicize the information that the lazy val field has been computed and assigned. The new scheme will require maintaining 2 bits per lazy field instead of 1, as in the current implementation. -We will refer to the existing, current lazy val initialization implementation as V1. - -### Version V2 ### - -Here is an example of manually written implementation for the `LazyCell` class from the previous section: - - class LazyCell { - @volatile var bitmap_0: Int = 0 - var value_0: Int = _ - private def value_lzycompute(): Int = { - this.synchronized { - if (bitmap_0 == 0) { - bitmap_0 = 1 - } else { - while (bitmap_0 == 1) { - this.wait() - } - return value_0 - } - } - val result = - this.synchronized { - value_0 = result - bitmap_0 = 3 - this.notifyAll() - } - value_0 - } - def value = if (bitmap_0 == 3) value_0 else value_lzycompute() - } - -The state of the lazy val is represented with 3 values: 0, 1 and 3. Note that only 2 bits are sufficient to represent them but we use an entire integer here for purposes of clarity. The state 0 represents a non-initialized lazy val. The state 1 represents the lazy val that is currently being initialized by some thread. The state 3 represents the lazy val that has been initialized. - -The first-arriving thread sets the state 1 from the synchronized block, leaves the synchronized block and proceeds by executing the initializer block. Subsequently arriving threads enter the synchronized block, see state 1 and `wait` until they are notified that the lazy val has been assigned. The first-arriving thread sets the state to 3 and notifies them after it computes the result and enters the second synchronized block. - -### Version V3 - the `notifyAll` improvement ### - -As noted in the previous discussions \[[1][1]\] \[[2][2]\] \[[6][6]\] \[[7][7]\], the `notifyAll` call in the proposed implementation bears a significant cost - in the uncontended case it slows down the initialization by a factor of at least 4x measured on a 3.4 GHz i7-2600 and JDK 7 update 4. - -Therefore, we propose the following implementation that avoids calling `notifyAll` unless the first-arriving thread knows that there are concurrent readers of the lazy val. We introduce the fourth state corresponding to the bitmap value 2, that denotes that there are concurrent readers of the lazy val. The first-arriving thread only calls the `notifyAll` if it finds state 2 in the second synchronized block. - - class LazyCell { - @volatile var bitmap_0 = 0 - var value_0: Int = _ - private def value_lzycompute(): Int = { - this.synchronized { - (bitmap_0: @annotation.switch) match { - case 0 => - bitmap_0 = 1 - case 1 => - bitmap_0 = 2 - do this.wait() while (bitmap_0 == 2.toByte) - return value_0 - case 2 => - do this.wait() while (bitmap_0 == 2.toByte) - return value_0 - case 3 => - return value_0 - } - } - val result = - this.synchronized { - val oldstate = bitmap_0 - value_0 = result - bitmap_0 = 3 - if (oldstate == 2) this.notifyAll() - } - value_0 - } - def value = if (bitmap_0 == 3) value_0 else value_lzycompute() - } - -Measured on the same machine, this change seems to be 50% slower than the current lazy val implementation for the uncontended case. - -### Version V4 - the CAS improvement ### - -Each exit or entrance to a synchronized block in principle requires one atomic instruction, amounting to roughly 4 atomic instructions per lazy val initialization. This can be reduced by using the CAS instruction to switch between lazy val states. -Here is an example of a simple implementation obtained by extending the `AtomicInteger` class: - - class LazyCell - extends java.util.concurrent.atomic.AtomicInteger { - var value_0: Int = _ - @tailrec final def value(): Int = (get: @switch) match { - case 0 => - if (compareAndSet(0, 1)) { - val result = - value_0 = result - if (getAndSet(3) != 1) synchronized { notify() } - result - } else value() - case 1 => - compareAndSet(1, 2) - synchronized { - while (get != 3) wait() - notify() - } - value_0 - case 2 => - synchronized { - while (get != 3) wait() - notify() - } - value_0 - case 3 => value_0 - } - } - -This implementation has the following advantages: -- it seems to have the same initialization performance as the current implementation, in the uncontended case -- it relies less on synchronized blocks, needing them only in case of contention, thus being less prone to deadlocks - -Some disadvantages: -- we cannot always extend `AtomicInteger`, some classes already inherit something else -- in the contended worst-case, this scheme is equally prone to deadlocks, because it needs to acquire the synchronized block - -However, in the more general setting where there are two or more lazy val fields in an object: -- the overall memory footprint could possibly increase - we would spend a minimum of 4 bytes per bitmap on first lazy val, where this was previously 1 byte -- in a setting with multiple bitmaps or an existing base class, we cannot extend `AtomicInteger` (which internally uses `Unsafe` directly), and instead need to use `AtomicIntegerFieldUpdater`s that are slower due to extra checks -- in a setting with multiple lazy val fields, we can no longer use `getAndSet` in the initialization (concurrent accesses to other lazy fields may modify the bitmap - we have to read and recompute the expected bitmap state) - we need a `compareAndSet` and have some retry-logic (see the `complete` method below), which is slower -- due to the restrictions on the `AtomicIntegerFieldUpdater`s, we would need to make the `bitmap_0` field publicly visible on the byte-code level, which might be an issue for Java code interfacing with Scala code -- it is much more complicated than the 2 synchronized blocks implementation - -Here is a more general implementation(V4-general), that is slower in the uncontended case than both the current implementation (V1) and the proposed implementation with synchronized blocks (V3). This implementation is, however, in the contended case twice as fast than the current implementation (V1). -See the evaluation section for more information. - - class LazyCellBase { // in a Java file - we need a public bitmap_0 - public static AtomicIntegerFieldUpdater arfu_0 = - AtomicIntegerFieldUpdater.newUpdater(LazyCellBase.class, "bitmap_0"); - public volatile int bitmap_0 = 0; - } - - final class LazyCell extends LazyCellBase { - import LazyCellBase._ - var value_0: Int = _ - @tailrec final def value(): Int = (arfu_0.get(this): @switch) match { - case 0 => - if (arfu_0.compareAndSet(this, 0, 1)) { - val result = - value_0 = result - - @tailrec def complete(): Unit = (arfu_0.get(this): @switch) match { - case 1 => - if (!arfu_0.compareAndSet(this, 1, 3)) complete() - case 2 => - if (arfu_0.compareAndSet(this, 2, 3)) { - synchronized { notifyAll() } - } else complete() - } - - complete() - result - } else value() - case 1 => - arfu_0.compareAndSet(this, 1, 2) - synchronized { - while (arfu_0.get(this) != 3) wait() - } - value_0 - case 2 => - synchronized { - while (arfu_0.get(this) != 3) wait() - } - value_0 - case 3 => value_0 - } - } - - -### Version 5 - retry in case of failure ### - -The current Scala semantics demand retrying the initialization in case of failure. -The four versions presented above provide good performance characteristics in benchmarks, but may leave threads waiting forever due to failed initializations, thus leaking threads. Consider this example: - - class LazyCell { - private var counter = -1 - lazy val value = { - counter = counter + 1 - if(counter < 42) - throw null - else 0 - } - } - -In this case, the first attempt to initialize the cell would fail. In version 4 this will leave the bitmap with a value still indicating that there's a thread currently computing the value. All the threads trying to access the value would wait for this (non-existent) thread to finish computation, causing the application to leak threads. - -In order to maintain current Scala semantics, we need to correctly handle failed initializations. Version 5 presented below, does this correctly: - - - class LazyCellBase { // in a Java file - we need a public bitmap_0 - public static AtomicIntegerFieldUpdater arfu_0 = - AtomicIntegerFieldUpdater.newUpdater(LazyCellBase.class, "bitmap_0"); - public volatile int bitmap_0 = 0; - } - - final class LazyCell extends LazyCellBase { - import LazyCellBase._ - var value_0: Int = _ - @tailrec final def value(): Int = (arfu_0.get(this): @switch) match { - case 0 => - if (arfu_0.compareAndSet(this, 0, 1)) { - val result = - try {} catch { - case x: Throwable => - complete(0); - throw x - } - value_0 = result - - @tailrec def complete(newState: Int): Unit = (arfu_0.get(this): @switch) match { - case 1 => - if (!arfu_0.compareAndSet(this, 1, newState)) complete() - case 2 => - if (arfu_0.compareAndSet(this, 2, newState)) { - synchronized { notifyAll() } - } else complete() - } - - complete(3) - result - } else value() - case 1 => - arfu_0.compareAndSet(this, 1, 2) - synchronized { - while (arfu_0.get(this) != 3) wait() - } - value_0 - case 2 => - synchronized { - while (arfu_0.get(this) != 3) wait() - } - value_0 - case 3 => value_0 - } - } - -This version is basically the same as Version 4, but it handles retries in accordance with current Scala specification. -Unfortunately, this comes with a slight performance slowdown. See the evaluation section for more information. - - -### Version 6 - No synchronization on `this` and concurrent initialization of fields ### - -Note that the current lazy val initialization implementation is robust against the following scenario, in which the initialization block starts an asynchronous computation attempting to indefinitely grab the monitor of the current object. - - class A { self => - lazy val x: Int = { - (new Thread() { - override def run() = self.synchronized { while (true) {} } - }).start() - 1 - } - } - -In the current implementation, the monitor is held throughout the lazy val initialization and released once the initialization block completes. -All versions proposed above, release the monitor during the initialization block execution and re-acquire it back, so the code above could stall indefinitely. - -Additionally, usage of `this` as synchronization point may disallow concurrent initialization of different lazy vals in the same object. Consider the example below: - - class TwoLazies { - lazy val slow = { Thread.sleep(100000); 0} - lazy val fast = 1 - lazy val bad: Int = { - (new Thread() { - override def run() = self.synchronized { while (true) {} } - }).start() - 1 - } - } - -Although the two `slow` and `fast` vals are independent, `fast` is required to -wait for `slow` to be computed. This is due to the fact that they both -synchronize on `this` for the entire initialization in the current -implementation. - -In the versions presented above, a single call to `bad` may lead to the monitor -for `this` being held forever, making calls to `slow` and `fast` also block -forever. - -Note that these interactions are very surprising to users as they leak the -internal limitations of the lazy val implementation. - -To overcome these limitations we propose a version that does not synchronize on -`this` and instead uses external monitor-objects that are used solely for -synchronization. - - final class LazyCell { - import dotty.runtime.LazyVals - var value_0: Int = _ - private var bitmap = 0 - @static private bitmap_offset = LazyVals.getOffset(classOf[LazyCell], "bitmap") - def value(): Int = { - var result: Int = 0 - var retry: Boolean = true - val fieldId: Int = 0 // id of lazy val - var flag: Long = 0L - while retry do { - flag = LazyVals.get(this, bitmap_offset) - LazyVals.STATE(flag, 0) match { - case 0 => - if LazyVals.CAS(this, bitmap_offset, flag, 1) { - try {result = } catch { - case x: Throwable => - LazyVals.setFlag(this, bitmap_offset, 0, fieldId) - throw x - } - value_0 = result - LazyVals.setFlag(this, bitmap_offset, 3, fieldId) - retry = false - } - case 1 => - LazyVals.wait4Notification(this, bitmap_offset, flag, fieldId) - case 2 => - LazyVals.wait4Notification(this, bitmap_offset, flag, fieldId) - case 3 => - retry = false - result = $target - } - } - result - } - } - -This implementation relies on the helper functions provided in \[[11][11]\] -module. The most important of these functions, `wait4Notification` and -`setFlag`, are presented below: - - def setFlag(t: Object, offset: Long, v: Int, fieldId: Int) = { - var retry = true - while (retry) { - val cur = get(t, offset) - if (STATE(cur) == 1) retry = CAS(t, offset, cur, v) - else { - // cur == 2, somebody is waiting on monitor - if (CAS(t, offset, cur, v)) { - val monitor = getMonitor(t, fieldId) - monitor.synchronized { - monitor.notifyAll() - } - retry = false - } - } - } - } - - def wait4Notification(t: Object, offset: Long, cur: Long, fieldId: Int) = { - var retry = true - while (retry) { - val cur = get(t, offset) - val state = STATE(cur) - if (state == 1) CAS(t, offset, cur, 2) - else if (state == 2) { - val monitor = getMonitor(t, fieldId) - monitor.synchronized { - monitor.wait() - } - } - else retry = false - } - } - - val processors: Int = java.lang.Runtime.getRuntime.availableProcessors() - val base: Int = 8 * processors * processors - val monitors: Array[Object] = (0 to base).map { - x => new Object() - }.toArray - - def getMonitor(obj: Object, fieldId: Int = 0) = { - var id = (java.lang.System.identityHashCode(obj) + fieldId) % base - if (id < 0) id += base - monitors(id) - } - -This implementation has the following advantages compared to previous version: -- it allows concurrent initialization of independent fields -- it does not interact with user-written code that synchronizes on `this` -- it does not require expanding monitor on the object to support `notifyAll` - -Some disadvantages: -- the `Unsafe` class, used internally has a disadvantage that it can be disallowed with a custom `SecurityManager`. -Note that this class is extracted from other place in standard library that uses it: scala.concurrent.util.Unsafe.instance -- it requires usage of `identityHashCode` that is stored for every object inside object header. -- as global arrays are used to store monitors, seemingly unrelated things may create contention. This is addressed in detail in evaluation section. - -Both absence of monitor expansion and usage of `identityHashCode` interact with -each other, as both of them operate on the object header. \[[12][12]\] presents -the complete graph of transitions between possible states of the object header. -What can be seen from this transition graph is that in the contended case, -versions V2-V5 were promoting object into the worst case, the `heavyweight -monitor` object, while the new scheme only disables biasing. - -Note that under the schemes presented here, V2-V5, this change only happens in -the event of contention and happens per-object. - -### Non-thread-safe lazy vals ### -While the new versions introduce speedups in the contended case, they do -generate complex byte-code and this may lead to the new scheme being less -appropriate for lazy vals that are not used in concurrent setting. In order to -perfectly fit this use-case we propose to introduce an encoding for -single-threaded lazy vals that is very simple and efficient: - - final class LazyCell { - var value_0 = 0 - var flag = false - def value = - if (flag) value_0 - else { - value_0 = ; - flag = true; - } - } - -This version is faster than all other versions on benchmarks but does not correctly handle safe publication in the case of multiple threads. It can be used in applications that utilize multiple threads if some other means of safe publication is used instead. - -### Elegant Local lazy vals ### -Aside from lazy vals that are fields of objects, scala supports local lazy vals, defined inside methods: - - def method = { - lazy val s = - s - } - -Currently, they use such encoding(we will call it L1): - - def method = { - var @volatile flag: Byte = 0.toByte - var s_0 = 0 - def s = { - if(flag == 0){ - this.synchronized{ - if (flag == 0) { - s_0 = - flag = 1 - } - } - s_0 - } - s - } - -Which is later translated by subsequent phases to: - - private def method$s(flag: VolatileByteRef, s_0: IntRef) = { - if(flag.value == 0){ - this.synchronized{ - if (flag.value == 0) { - s_0.value = - flag.value = 1 - } - } - s_0.value - } - - def method = { - var flag = new VolatileByteRef(0) - var s_0 = new IntRef(0) - method$s(flag, s_0) - } - - - -The current implementation has several shortcomings: - - it allocates two boxes - - it synchronizes on `this`. This is most severe in case of lambdas, as lambdas do not introduce a new `this`. - -We propose a new scheme, that is both simpler in implementation and is more efficient and slightly more compact. -The scheme introduces new helper classes to the standard library: such as `dotty.runtime.LazyInt`\[[17][17]\] and uses them to implement the local lazy val behavior. - - class LazyInt { - var value: Int = _ - @volatile var initialized: Boolean = false - } - - private def method$s(holder: LazyInt) = { - if(!holder.initialized){ - holder.synchronized{ - if (!holder.initialized) { - holder.value = - holder.initialized = true - } - } - holder.value - } - - def method = { - var holder = new LazyInt() - method$s(holder) - } - -This solves the problem with deadlocks introduced by using java8 lambdas.\[[14][14]\] - - -### Language change ### -To address the fact that we now have both thread safe and single-threaded lazy vals, -we propose to bring lazy vals in sync with normal vals with regards to usage of `@volatile` annotation. - -In order to simplify migration, Scalafix the migration tool that will be used to migrate between versions of Scala, including Dotty, supports a `VolatileLazyVal` rewrite that adds `@volatile` to all `lazy vals` present in the codebase. - - -## Evaluation ## - -We focus on the memory footprint increase, the performance comparison and byte-code size. Note that the fast path (i.e. the cost of accessing a lazy val after it has been initialized) stays the same as in the current implementation. Thus, the focus of our measurements is on the overheads in the lazy val initialization in both the uncontended and the contended case. -The micro-benchmarks used for evaluation are available in a GitHub repo \[[6][6]\] and the graphs of the evaluation results are available online \[[7][7]\], \[[18][18]\], \[[19][19]\] . We used the ScalaMeter tool for measurements \[[9][9]\]. - -### Memory usage footprint ### - -We expect that the proposed changes will not change the memory footprint for most objects that contain lazy vals. Each lazy val currently requires 4 or 8 bytes for the field, and an additional bit in the bitmap. As soon as the first bit is introduced into the bitmap, 1 additional byte is allocated for the object. - -Since we now use 2 bits per lazy val field instead of 1, for classes having 4 or less lazy val field declarations the memory footprint per instance will thus not grow. For classes having more lazy val field declarations the memory footprint per instance will in most cases not grow since the objects have to be aligned to an 8 byte boundary anyway. - -We measured the memory footprint of an array of objects with single lazy val fields. The memory footprint did not change with respect to the current version \[[6][6]\] \[[7][7]\]. -The detailed experimental measurements graphs of memory footprint can be seen in graphs.\[[18][18]\] - -### Performance ### - -We measured performance in both the uncontended and the contended case. We measured on an i7-2600, a 64-bit Oracle JVM, version 1.7 update 4. - -For the uncontended case, we measure the cost of creating N objects and initializing their lazy val fields. The measurement includes both the object creation times and their initialization, where the initialization is the dominant factor. - -For the contended case, we measure the cost of initializing the lazy fields of N objects, previously created and stored in an array, by 4 different threads that linearly try to read the lazy field of an object before proceeding to the next one. The goal of this test is to asses the effect of entering the synchronized block and notifying the waiting threads - since the slow path is slower, the threads that “lag” behind should quickly reach the first object with an uninitialized lazy val, causing contention. - -The current lazy val implementation (V1) seems to incur initialization costs that are at least 6 times greater compared to referencing a regular val. The handwritten implementation produces identical byte-code, with the difference that the calls are virtual instead of just querying the field value; this is probably the reason as to why it is up to 50% slower. The 2 synchronized blocks design with an eager notify (V2) is 3-4 times slower than the current implementation - just adding the `notifyAll` call changes things considerably. The 4 state/2 synchronized blocks approach (V3) is only 33-50% slower than the current implementation (V1). The CAS-based approach where `AtomicInteger`s are extended is as fast as the current lazy val initialization (V1), but when generalized and replaced with `AtomicReferenceFieldUpdater`s as discussed before, it is almost 50% slower than the current implementation (V1). The final version, V6 uses `Unsafe` to bring back performance and is as around twice as fast as current implementation (V1) while maintaining correct semantics. - -The CAS-based approaches (V4, V5 and V6) appear to offer the best performance here, being twice as fast than the current implementation (V1). - -The proposed solution with (V6) is 50% faster\[[19][19]\] than the current lazy val implementation in the contended case. This comes at a price of synchronizing on a global array of monitors, which may create contention between seemingly unrelated things. The more monitors that are created, the less is the probability of such contention. There's also a positive effect though, the reuse of global objects for synchronization allows the monitors on the instances containing lazy vals to not be expanded, saving on non-local memory allocation. The current implementation uses `8 * processorCount * processorCount` monitors and the benchmarks and by-hand study with "Vtune Amplifier XE" demonstrate that the positive effect dominates, introducing a 2% speedup\[[13][13]\]. It’s worth mentioning that this is not a typical use-case that reflects a practical application, but rather a synthetic edge case designed to show the worst-case comparison demonstrating cache contention. - -The local lazy vals implementation is around 6x faster than the current version, as it eliminates the need for boxing and reduces the number of allocations from 2 to 1. - -The concrete micro-benchmark code is available as a GitHub repo \[[6][6]\]. It additionally benchmarks many other implementations that are not covered in the text of this SIP, in particular it tests versions based on MethodHandles and runtime code generation as well as versions that use additional spinning before synchronizing on the monitor. -For those wishing to reproduce the results, the benchmarking suite takes 90 minutes to run on contemporary CPUs. Enabling all the disabled benchmarks, in particular those that evaluate the `invokeDynamic` based implementation, will make the benchmarks take around 5 hours. - -The final result of those benchmarks is that amount proposed versions, the two that worth considering are (V4-general) and (V6). -They both perform better than the current implementation in all the contended case. -Specifically, in the contended case, V6 is 2 times faster than V1, while V4-general is 4 times faster. -Unfortunately V4-general is 30% slower in the uncontended case than current implementation(V1), while V6 is in the same ballpark, being up to 5% slower or faster depending on the setup of the benchmark. - -Based on this, we propose V6 to be used as default in future versions of Scala. - -### Code size ### -The versions presented in V2-V6 have a lot more complex implementation and this shows up the size of the byte-code. In the worst-case scenario, when the `` value is a constant, the current scheme (V1) creates an initializer method that has a size of 34 bytes, while dotty creates a version that is 184 bytes long. Local optimizations present in dotty linker\[[14][14]\] are able to reduce this size down to 160 bytes, but this is still substantially more than the current version. - -On the other hand, the single-threaded version does not need separate initializer method and is around twice smaller than the current scheme (V1). - -The proposed local lazy val transformation scheme also creates less byte-code, introducing 34 bytes instead of 42 bytes, mostly due to reduction in constant table size. - -## Current status ## -Version V6 is implemented and used in Dotty, together with language change that makes lazy vals thread-unsafe if `@volatile` annotation is not specified. -Dotty implementation internally uses `@static` proposed in \[[16][16]\]. - -Both Dotty and released Scala 2.12 already implement "Elegant Local lazy vals". This was incorporated in the 2.12 release before this SIP was considered, as it was fixing a bug that blocked release\[[14][14]\]. - -### Unsafe ### -The proposed version, V6 relies on `sun.misc.Unsafe` in order to implement it's behaviour. -While `sun.misc.Unsafe` will remain available in Java9 there's an intention to deprecate it and replace it with VarHandles.\[[20][20]\]. -The proposed version V6 can be implemented with using functionality present in Var Handles. - -## Acknowledgements ## - -We would like to thank Peter Levart and the other members of the concurrency-interest mailing list for their suggestions, as well as the members of the scala-internals mailing list for the useful discussions and input. - - -## References ## -1. [Summary of lazy vals discussions, Scala Internals Mailing list, May 2013][1] -2. [The cost of `notifyAll`, Concurrency Interest Mailing List, May 2013][2] -3. [Scala Parallel Collection in Object Initializer Causes a Program to Hang][3] -4. [Program Hangs If Thread Is Created In Static Initializer Block][4] -5. [Java Language Specification, 12.4.2][5] -6. [GitHub Repo with Microbenchmarks][6] -7. [Uncontended Performance Evaluation Results][7] -8. [ScalaMeter GitHub Repo][8] -9. [Lazy Vals in Dotty, Scala Internals Mailing list, February 2014][9] -10. [Lazy Vals in Dotty, Dotty Internals Mailing list, February 2014][10] -11. [LazyVals runtime module, Dotty sourcecode, February 2014][11] -12. [Synchronization, HotSpot internals wiki, April 2008][12] -13. [Lazy Vals in Dotty, cache contention discussion, February 2014][13] -14. [SI-9824 SI-9814 proper locking scope for lazy vals in lambdas, April 2016][14] -15. [Introducing Scalafix: a migration tool for Scalac to Dotty, October 2016][15] -16. [@static sip, January 2016][16] -17. [LazyVal Holders in Dotty][17] -18. [Memory Footprint Evaluation Results][18] -19. [Contended Performance Evaluation Results][19] -20. [JEP 193: Variable Handles][20] - - [1]: https://groups.google.com/forum/#!topic/scala-internals/cCgBMp5k8R8 "scala-internals" - [2]: https://cs.oswego.edu/pipermail/concurrency-interest/2013-May/011354.html "concurrency-interest" - [3]: https://stackoverflow.com/questions/15176199/scala-parallel-collection-in-object-initializer-causes-a-program-to-hang "pc-object-hang" - [4]: https://stackoverflow.com/questions/7517964/program-hangs-if-thread-is-created-in-static-initializer-block "static-init-hang" - [5]: https://docs.oracle.com/javase/specs/jls/se7/html/jls-12.html#jls-12.4.2 "jls-spec" - [6]: https://github.com/DarkDimius/lazy-val-bench/blob/CallSites/src/test/scala/example/package.scala "lazy-val-bench-code" - [7]: https://d-d.me/tnc/30/lazy-sip-perf/report/#config=%7B%22filterConfig%22%3A%7B%22curves%22%3A%5B%220%22%2C%221%22%2C%225%22%2C%226%22%2C%227%22%2C%228%22%2C%2210%22%2C%2212%22%5D%2C%22order%22%3A%5B%22param-size%22%2C%22date%22%5D%2C%22filters%22%3A%5B%5B%22100000%22%2C%22300000%22%2C%22500000%22%2C%221000000%22%2C%223000000%22%2C%225000000%22%5D%2C%5B%221477397877000%22%5D%5D%7D%2C%22chartConfig%22%3A%7B%22type%22%3A0%2C%22showCI%22%3Afalse%7D%7D "lazy-val-bench-report" - [8]: https://axel22.github.io/scalameter/ "scalameter-code" - [9]: https://groups.google.com/forum/#!msg/scala-internals/4sjw8pcKysg/GlXYDDzCgI0J "scala-internals" - [10]: https://groups.google.com/forum/#!topic/dotty-internals/soWIWr3bRk8 "dotty-internals" - [11]: https://github.com/lampepfl/dotty/blob/5cbd2fbc8409b446f8751792b006693e1d091055/src/dotty/runtime/LazyVals.scala - [12]: https://wiki.openjdk.java.net/display/HotSpot/Synchronization - [13]: https://groups.google.com/d/msg/scala-internals/4sjw8pcKysg/gD0au4dmTAsJ - [14]: https://github.com/scala/scala-dev/issues/133 - [15]: https://scala-lang.org/blog/2016/10/24/scalafix.html - [16]: https://github.com/scala/docs.scala-lang/pull/491 - [17]: https://github.com/lampepfl/dotty/blob/f92f278ab686ab218e841082dcb026c6c8ef89b7/library/src/dotty/runtime/LazyHolders.scala - [18]: https://d-d.me/tnc/30/lazy-mem/report/#config=%7B%22filterConfig%22%3A%7B%22curves%22%3A%5B%22-1%22%2C%220%22%2C%221%22%2C%222%22%2C%223%22%2C%224%22%2C%225%22%2C%226%22%2C%227%22%2C%228%22%5D%2C%22order%22%3A%5B%22param-size%22%2C%22date%22%5D%2C%22filters%22%3A%5B%5B%221000000%22%2C%222000000%22%2C%223000000%22%2C%224000000%22%2C%225000000%22%5D%2C%5B%221477396691000%22%5D%5D%7D%2C%22chartConfig%22%3A%7B%22type%22%3A0%2C%22showCI%22%3Afalse%7D%7D - [19]: https://d-d.me/tnc/30/lazy-sip-perf/report/#config=%7B%22filterConfig%22%3A%7B%22curves%22%3A%5B%2216%22%2C%2217%22%2C%2218%22%2C%2219%22%2C%2221%22%2C%2222%22%2C%2223%22%5D%2C%22order%22%3A%5B%22param-size%22%2C%22date%22%5D%2C%22filters%22%3A%5B%5B%22100000%22%2C%22300000%22%2C%22500000%22%2C%221000000%22%2C%223000000%22%2C%225000000%22%5D%2C%5B%221477397877000%22%5D%5D%7D%2C%22chartConfig%22%3A%7B%22type%22%3A0%2C%22showCI%22%3Afalse%7D%7D - [20]: https://openjdk.java.net/jeps/193 diff --git a/_sips/sips/2013-06-10-spores.md b/_sips/sips/2013-06-10-spores.md deleted file mode 100644 index 1868410121..0000000000 --- a/_sips/sips/2013-06-10-spores.md +++ /dev/null @@ -1,459 +0,0 @@ ---- -layout: sip -title: SIP-21 - Spores -vote-status: "dormant" -vote-text: There is an implementation for Scala 2.11. A new owner is needed to champion this proposal for the current Scala version. The proposal needs to be updated to explain how to handle transitive spores. -permalink: /sips/:title.html -redirect_from: /sips/pending/spores.html ---- - -**By: Heather Miller, Martin Odersky, and Philipp Haller** - -Updated September 15th, 2013 - -  - -Functional programming languages are regularly touted as an enabling force, as -an increasing number of applications become concurrent and distributed. -However, managing closures in a concurrent or distributed environment, or -writing APIs to be used by clients in such an environment, remains -considerably precarious-- complicated environments can be captured by these -closures, which regularly leads to a whole host of potential hazards across -libraries/frameworks in Scala's standard library and its ecosystem. - -Potential hazards when using closures incorrectly: - -- Memory leaks -- Race conditions, due to capturing mutable references -- Runtime serialization errors, due to unintended capture of references - -This SIP outlines an abstraction, called _spores_, which enables safer use of -closures in concurrent and distributed environments. This is achieved by -controlling the environment which a spore can capture. Using an -_assignment-on-capture_ semantics, certain concurrency bugs due to capturing mutable -references can be avoided. - -## Motivating Examples - -### Futures and Akka Actors - -In the following example, an Akka actor spawns a future to concurrently -process incoming requests. - -**Example 1:** - - def receive = { - case Request(data) => - Future { - val result = transform(data) - sender ! Response(result) - } - } - -Capturing `sender` in the above example is problematic, since it does not -return a stable value. It is possible that the future's body is executed at a -time when the actor has started processing the next `Request` message which -could be originating from a different actor. As a result, the `Response` -message of the future might be sent to the wrong receiver. - - -### Serialization - -The following example uses Java Serialization to serialize a closure. However, -serialization fails with a `NotSerializableException` due to the unintended -capture of a reference to an enclosing object. - -**Example 2:** - - case class Helper(name: String) - - class Main { - val helper = Helper("the helper") - - val fun: Int => Unit = (x: Int) => { - val result = x + " " + helper.toString - println("The result is: " + result) - } - } - -Given the above class definitions, serializing the `fun` member of an instance -of `Main` throws a `NotSerializableException`. This is unexpected, since `fun` -refers only to serializable objects: `x` (an `Int`) and `helper` (an instance -of a case class). - -Here is an explanation of why the serialization of `fun` fails: since `helper` -is a field, it is not actually copied when it is captured by the closure. -Instead, when accessing helper its getter is invoked. This can be made -explicit by replacing `helper.toString` by the invocation of its getter, -`this.helper.toString`. Consequently, the `fun` closure captures `this`, not -just a copy of `helper`. However, `this` is a reference to class `Main` which -is not serializable. - -The above example is not the only possible situation in which a closure can -capture a reference to `this` or to an enclosing object in an unintended way. -Thus, runtime errors when serializing closures are common. - -## Basic Usage - -Spores have a few modes of usage. The simplest form is: - - val s = spore { - val h = helper - (x: Int) => { - val result = x + " " + h.toString - println("The result is: " + result) - } - } - -In this example, no transformation is actually performed. Instead, the -compiler simply ensures that the spore is _well-formed_, i.e., anything that's -captured is explicitly listed as a value definition before the spore's -closure. This ensures that the enclosing `this` instance is not accidentally -captured, in this example. - -Spores can also be used in for-comprehensions: - - for { i <- collection - j <- doSomething(i) - } yield s"${capture(i)}: result: $j" - -Here, the fact that a spore is created is implicit, that is, the `spore` -marker is not used explicitly. Spores come into play because the underlying -`map` method of the type of `doSomething(i)` takes a spore as a parameter. The -`capture(i)` syntax is an alternative way of declaring captured variables, in -particular for use in for-comprehensions. - -Finally, a regular function literal can be used as a spore. That is, a method -that expects a spore can be passed a function literal so long as the function -literal is well-formed. - - def sendOverWire(s: Spore[Int, Int]): Unit = ... - sendOverWire((x: Int) => x * x - 2) - -## Design - -The main idea behind spores is to provide an alternative way to create -closure-like objects, in a way where the environment is controlled. - -A spore is created as follows. - -**Example 3:** - - val s = spore { - val h = helper - (x: Int) => { - val result = x + " " + h.toString - println("The result is: " + result) - } - } - -The body of a spore consists of two parts: - -1. **the spore header:** a sequence of local value (val) declarations only, and -2. **the closure**. - -In general, a `spore { ... }` expression has the following shape. - -Note that the value declarations described in point 1 above can be `implicit` -but not `lazy`. - -**Figure 1:** - - spore { - val x_1: T_1 = init_1 - ... - val x_n: T_n = init_n - (p_1: S_1, ..., p_m: S_m) => { - - } - } - -The types `T_1, ..., T_n` can also be inferred. - -The closure of a spore has to satisfy the following rule. All free variables -of the closure body have to be either - -1. parameters of the closure, or -2. declared in the preceding sequence of local value declarations, or -3. marked using `capture` (see corresponding section below). - -**Example 4:** - - case class Person(name: String, age: Int) - val outer1 = 0 - val outer2 = Person("Jim", 35) - val s = spore { - val inner = outer2 - (x: Int) => { - s"The result is: ${x + inner.age + outer1}" - } - } - -In the above example, the spore's closure is invalid, and would be rejected -during compilation. The reason is that the variable `outer1` is neither a -parameter of the closure nor one of the spore's value declarations (the only -value declaration is: `val inner = outer2`). - -### Evaluation Semantics - -In order to make the runtime behavior of a spore as intuitive as possible, the -design leaves the evaluation semantics unchanged compared to regular closures. -Basically, leaving out the `spore` marker results in a closure with the same -runtime behavior. - -For example, - - spore { - val l = this.logger - () => new LoggingActor(l) - } - -and - - { - val l = this.logger - () => new LoggingActor(l) - } - -have the same behavior at runtime. The rationale for this design decision is -that the runtime behavior of closure-heavy code can already be hard to reason -about. It would become even more difficult if we would introduce additional -rules for spores. - -### Spore Type - -The type of the spore is determined by the type and arity of the closure. If -the closure has type `A => B`, then the spore has type `Spore[A, B]`. For -convenience we also define spore types for two or more parameters. - -In example 3, the type of s is `Spore[Int, Unit]`. -Implementation -The spore construct is a macro which - -- performs the checking described above, and which -- replaces the spore body so that it creates an instance of one of the Spore traits, according to the arity of the closure of the spore. - -The `Spore` trait for spores of arity 1 is declared as follows: - - trait Spore[-T, +R] extends Function1[T, R] - -For each function arity there exists a corresponding `Spore` trait of the same -arity (called `Spore2`, `Spore3`, etc.) - -### Implicit Conversion - -Regular function literals can be implicitly converted to spores. This implicit -conversion has two benefits: - -1. it enables the use of spores in for-comprehensions. -2. it makes the spore syntax more lightweight, which is important in frameworks such as [Spark](https://spark.incubator.apache.org/) where users often create many small function literals. - -This conversion is defined as a member of the `Spore` companion object, so -it's always in the implicit scope when passing a function literal as a method -argument when a `Spore` is expected. For example, one can do the following: - - def sendOverWire(s: Spore[Int, Int]): Unit = ... - sendOverWire((x: Int) => x * x - 2) - -This is arguably much lighter-weight than having to declare a spore before -passing it to `sendOverWire`. - -In general, the implicit conversion will be successful if and only if the -function literal is well-formed according to the spore rules (defined above in -the _Design_ section). Note that _only function literals can be converted to spores_. -This is due to the fact that the body of the function literal has to be checked -by the spore macro to make sure that the conversion is safe. For _named_ function -values (i.e., not literals) on the other hand, it's not guaranteed that the -function value's body is available for the spore macro to check. - -### Capture Syntax and For-Comprehensions - -To enable the use of spores with for-comprehensions, a `capture` syntax has -been introduced to assist in the spore checking. - -To see why this is necessary, let's start with an example. Suppose we have a -type for distributed collections: - - trait DCollection[A] { - def map[B](sp: Spore[A, B]): DCollection[B] - def flatMap[B](sp: Spore[A, DCollection[B]]): DCollection[B] - } - -This type, `DCollection`, might be implemented in a way where the data is -distributed across machines in a cluster. Thus, the functions passed to `map`, -`flatMap`, etc. have to be serializable. A simple way to ensure this is to -require these arguments to be spores. However, we also would like for-comprehensions -like the following to work: - - def lookup(i: Int): DCollection[Int] = ... - val indices: DCollection[Int] = ... - - for { i <- indices - j <- lookup(i) - } yield j + i - -A problem here is that the desugaring done by the compiler for -for-comprehensions doesn't know anything about spores. This is what -the compiler produces from the above expression: - - indices.flatMap(i => lookup(i).map(j => j + i)) - -The problem is that `(j => j + i)` is not a spore. Furthermore, making it a -spore is not straightforward, as we can't change the way for-comprehensions -are translated. - -We can overcome this by using the implicit conversion introduced in the -previous section to convert the function literal implicitly to a spore. - -However, in continuing to look at this example, it's evident that the lambda -still has the wrong shape. The captured variable `i` is not declared in the -spore header (the list of value definitions preceding the closure within the -spore), like a spore demands. - -We can overcome this using the `capture` syntax – an alternative way of -capturing paths. That is, instead of having to write: - - { - val captured = i - j => j + i - } - -One can also write: - - (j => j + capture(i)) - -Thus, the above for-comprehension can be rewritten using spores and `capture` -as follows: - - for { i <- indices - j <- lookup(i) - } yield j + capture(i) - -Here, `i` is "captured" as it occurs syntactically after the arrow of another -generator (it occurs after `j <- lookup(i)`, the second generator in the -for-comprehension). - -**Note:** anything that is "captured" using `capture` may only be a path. - -**A path** (as defined by the Scala Language Specification, section 3.1) is: - -- The empty path ε (which cannot be written explicitly in user programs). -- `C.this`, where `C` references a class. -- `p.x` where `p` is a path and `x` is a stable member of `p`. -- `C.super.x` or `C.super[M].x` where `C` references a class and `x` references a stable member of the super class or designated parent class `M` of `C`. - -The reason why captured expressions are restricted to paths is that otherwise -the two closures - - (x => + capture()) - -and - - (x => + ) - -(where `` and `` are not just paths) would not have the same -runtime behavior, because in the first case, the closure would have to be -transformed in a way that would evaluate `` "outside of the closure". -Not only would this complicate the reasoning about spore-based code (see the -section Evaluation Semantics above), but it's not clear what "outside of the -closure" even means in a context such as for-comprehensions. - -### Macro Expansion - -An invocation of the spore macro expands the spore's body as follows. Given -the general shape of a spore as shown above, the spore macro produces the -following code: - - new [S_1, ..., S_m, R]({ - val x_1: T_1 = init_1 - ... - val x_n: T_n = init_n - (p_1: S_1, ..., p_m: S_m) => { - - } - }) - -Note that, after checking, the spore macro need not do any further -transformation, since implementation details such as unneeded remaining outer -references are removed by the new backend intended for inclusion in Scala -2.11. It's also useful to note that in some cases these unwanted outer -references are already removed by the existing backend. - -The spore implementation classes follow a simple pattern. For example, for -arity 1, the implementation class is declared as follows: - - class SporeImpl[-T, +R](f: T => R) extends Spore[T, R] { - def apply(x: T): R = f(x) - } - -### Type Inference - -Similar to regular functions and closures, the type of a spore should be -inferred. Inferring the type of a spore amounts to inferring the type -arguments when instantiating a spore implementation class: - - new [S_1, ..., S_m, R]({ - // ... - }) - -In the above expression, the type arguments `S_1, ..., S_m`, and `R` should be -inferred from the expected type. - -Our current proposal is to solve this type inference problem in the context of -the integration of Java SAM closures into Scala. Given that it is planned to -eventually support such closures, and to support type inference for these -closures as well, we plan to piggyback on the work done on type inference for -SAMs in general to achieve type inference for spores. - -## Motivating Examples, Revisited - -We now revisit the motivating examples we described in the above section, this -time in the context of spores. - -### Futures and Akka actors - -The safety of futures can be improved by requiring the body of a new future to -be a nullary spore (a spore with an empty parameter list). - -Using spores, example 1 can be re-written as follows: - - def receive = { - case Request(data) => - future(spore { - val from = sender - val d = data - () => { - val result = transform(d) - from ! Response(result) - } - }) - } - -In this case, the problematic capturing of `this` is avoided, since the result -of `this.sender` is assigned to the spore's local value `from` when the spore -is created. The spore conformity checking ensures that within the spore's -closure, only `from` and `d` are used. - -### Serialization - -Using spores, example 2 can be re-written as follows: - - case class Helper(name: String) - - class Main { - val helper = Helper("the helper") - - val fun: Spore[Int, Unit] = spore { - val h = helper - (x: Int) => { - val result = x + " " + h.toString - println("The result is: " + result) - } - } - } - -Similar to example 1, the problematic capturing of `this` is avoided, since -`helper` has to be assigned to a local value (here, `h`) so that it can be -used inside the spore's closure. As a result, `fun` can now be serialized -without runtime errors, since `h` refers to a serializable object (a case -class instance). diff --git a/_sips/sips/2013-06-30-async.md b/_sips/sips/2013-06-30-async.md deleted file mode 100644 index a83bb6f5a4..0000000000 --- a/_sips/sips/2013-06-30-async.md +++ /dev/null @@ -1,298 +0,0 @@ ---- -layout: sip -title: SIP-22 - Async -vote-status: dormant -vote-text: Authors have marked this proposal as dormant. Details in the implementation need to be figured out. Check July 2016's minutes. -permalink: /sips/:title.html -redirect_from: /sips/pending/async.html ---- - -**By: Philipp Haller and Jason Zaugg** - -## Introduction - -This is a proposal to add constructs that simplify asynchronous and concurrent programming in Scala. The main constructs, async and await, are inspired by similar constructs introduced in C# 5.0. The main purpose of async/await is to make it possible to express efficient asynchronous code in a familiar direct style (where suspending operations look as if they were blocking). As a result, non-blocking code using Scala’s futures API \[[1][1]\] can be expressed without using higher-order functions, such as map and flatMap, or low-level callbacks. - -On the level of types, async and await are methods with simple, intuitive types: - - def async[T](body: => T): Future[T] - def await[T](future: Future[T]): T - -Here, `Future[T]` refers to the `Future` trait in package `scala.concurrent`. (The system can be adapted to other implementations of future-like abstractions; at the moment the API with the required extension points is internal, though.) The above methods are used as follows: - - val fut = async { - slowComputation() - } - -The async construct marks a block of asynchronous code, and returns a future. Depending on the execution context in the implicit scope (see \[[1][1]\]), the block of asynchronous code is either executed on the current thread or in a thread pool. The async block can contain calls to await: - - val futureDOY: Future[Response] = - WS.url("https://api.day-of-year/today").get - - val futureDaysLeft: Future[Response] = - WS.url("https://api.days-left/today").get - - val respFut = async { - val dayOfYear = await(futureDOY).body - val daysLeft = await(futureDaysLeft).body - Ok(s"$dayOfYear: $daysLeft days left!") - } - -Line 1 and 4 define two futures obtained as results of asynchronous requests to two hypothetical web services using an API inspired by Play Framework \[[2][2]\] (for the purpose of this example, the definition of type `Response` is unimportant). The `await` on line 8 causes the execution of the `async` block to suspend until `futureDOY` is completed (with a successful result or with an exception). When the future is completed successfully, its result is bound to the `dayOfYear` val, and the execution of the `async` block is resumed. When the future is completed with an exception (for example, because of a timeout), the invocation of `await` re-throws the exception that the future was completed with. In turn, this completes future respFut with the same exception. Likewise, the `await` on line 9 suspends the execution of the `async` block until futureDaysLeft is completed. - -## Comparison with Scala’s Futures API - -The provided async and await constructs can significantly simplify code coordinating multiple futures. Consider the following example, written using Scala’s futures API together with for-comprehensions: - - def nameOfMonth(num: Int): Future[String] = ... - val date = “““(\d+)/(\d+)“““.r - - for { doyResponse <- futureDOY - dayOfYear = doyResponse.body - response <- dayOfYear match { - case date(month, day) => - for (name <- nameOfMonth(month.toInt)) - yield Ok(s“It’s $name!“) - case _ => - Future.successful(NotFound(“Not a...“)) - } - } yield response - -Line 1 defines an asynchronous method that converts an integer representing the number of a month to the name of the month (for example, the integer 2 is converted to "February"). Since the method is asynchronous, it returns a `Future[String]`. Line 2 defines a regular expression used to extract the month from a date string such as "07/24". The for-comprehension starting on line 4 first awaits the result of `futureDOY` (the example re-uses the definition of `futureDOY` shown earlier). Scala's futures provide methods like `map` and `flatMap`, and can thus be used as generators in for-comprehensions (for a more in-depth introduction of this feature see the official documentation \[[1][1]\]). The use of for-comprehensions can help make future-based code more clear, but in many cases it requires a significant amount of unnatural clutter and workarounds. The above example suffers from the following issues: - -- To extract `dayOfYear`, we are forced to introduce the name `doyResponse`, a useless intermediate result (line 4); -- to await the completion of the future returned by `nameOfMonth`, we are forced to use a nested for-comprehension (line 8); -- the nested for-comprehension forces us to bind the result of nameOfMonth to name, a useless intermediate variable (line 8); -- the nested for-comprehension forces us to introduce an artificial future that's completed upon creation (line 11); -- the artificial future introduces additional overhead and garbage (line 11); -- finally, the use of for-yield might obscure the actual domain which is asynchronous computations with non-blocking awaits. - -The same example can be written using async/await as follows: - - async { - await(futureDOY).body match { - case date(month, day) => - Ok(s“It’s ${await(nameOfMonth(month.toInt))}!“) - case _ => - NotFound(“Not a date, mate!“) - } - } - -This version avoids all drawbacks of the previous version listed above. In addition, the generated code is more efficient, because it creates fewer closures. - -## Illegal Uses - -The following uses of await are illegal and are reported as errors: -- await requires a directly-enclosing async; this means await must not be used inside a closure nested within an async block, or inside a nested object, trait, or class. -- await must not be used inside an expression passed as an argument to a by-name parameter. -- await must not be used inside a Boolean short-circuit argument. -- return expressions are illegal inside an async block. - -## Implementation - -We have implemented the present proposal using the macro system which has been introduced in Scala 2.10 as an experimental feature. Our implementation \[[3][3]\] is targeted at Scala 2.11.0, but runs on using Scala 2.10.1 without any limitations. - -## Async Transform Specification - -In the following we consider the transformation of an invocation `async { }` of the async macro. -Before the block of code (``) is transformed, it is normalized into a form amenable to a transformation into a state machine. This form is called the "A-Normal Form" (ANF), and roughly means that: - -- `if`, `match`, and other control-flow constructs are only used as statements; they cannot be used as expressions; -- calls to `await` are not allowed in compound expressions. - -After the ANF transform, the async macro prepares the state machine -transformation by identifying vals, vars and defs that are accessed -from multiple states. These will be lifted out to fields in the state -machine object. - -The next step of the transformation breaks the code into "chunks." -Each chunk contains a linear sequence of statements that concludes -with a branching decision, or with the registration of a subsequent -state handler as the continuation (the "on-completion handler"). Once -all chunks have been built, the macro synthesizes a class representing -the state machine. The class contains: - -- an integer representing the current state ID -- the lifted definitions -- an `apply(value: Try[Any]): Unit` method that will be called on completion of each future. The behavior of this method is determined by the current state. It records the downcast result of the future in a field, and calls the `resume()` method. -- the `resume(): Unit` method that switches on the current state and runs the users code for one "chunk," and either: (a) registers the state machine as the handler for the next future, or (b) completes the result promise of the async block, if at the terminal state. -- an `apply(): Unit` method that starts the evaluation of the async block's body. - -### Example - - val future = async { - val f1 = async { true } - val x = 1 - def inc(t: Int) = t + x - val t = 0 - val f2 = async { 42 } - if (await(f1)) await(f2) else { val z = 1; inc(t + z) } - } - -After the ANF transform: -- `await` calls are moved to only appear on the RHS of a value definition; -- `if` is no longer used as an expression; instead each branch writes its result to a synthetic var; -- the `ExecutionContext` used to run the async block is obtained as an implicit argument. - -Follows the end result of the ANF transform (with very minor -simplifications). - - { - (); - val f1: scala.concurrent.Future[Boolean] = { - scala.concurrent.Future.apply[Boolean](true)(scala.concurrent.ExecutionContext.Implicits.global) - }; - val x: Int = 1; - def inc(t: Int): Int = t.+(x); - val t: Int = 0; - val f2: scala.concurrent.Future[Int] = { - scala.concurrent.Future.apply[Int](42)(scala.concurrent.ExecutionContext.Implicits.global) - }; - val await$1: Boolean = scala.async.Async.await[Boolean](f1); - var ifres$1: Int = 0; - if (await$1) - { - val await$2: Int = scala.async.Async.await[Int](f2); - ifres$1 = await$2 - } - else - { - ifres$1 = { - val z: Int = 1; - inc(t.+(z)) - } - }; - ifres$1 - } - -After the full async transform: - -- one class is synthesized that represents the state machine. Its `apply()` method is used to start the computation (even the code before the first await call is executed asynchronously), and the `apply(tr: scala.util.Try[Any])` method will continue after each completed future that the async block awaits; - -- each chunk of code is moved into the a branch of the pattern match in `resume$async`; - -- value and function definitions accessed from multiple states are lifted to be members of class `stateMachine`; others remain local, e.g. `val z`; - -- `result$async` holds the promise which is completed with the result of the async block; - -- `execContext$async` holds the `ExecutionContext` that has been inferred. - -Follows the end result of the full async transform (with very minor -simplifications). - - { - class stateMachine$7 extends StateMachine[scala.concurrent.Promise[Int], scala.concurrent.ExecutionContext] { - var state$async: Int = 0; - val result$async: scala.concurrent.Promise[Int] = scala.concurrent.Promise.apply[Int](); - val execContext$async = scala.concurrent.ExecutionContext.Implicits.global; - var x$1: Int = 0; - def inc$1(t: Int): Int = t.$plus(x$1); - var t$1: Int = 0; - var f2$1: scala.concurrent.Future[Int] = null; - var await$1: Boolean = false; - var ifres$1: Int = 0; - var await$2: Int = 0; - def resume$async(): Unit = try { - state$async match { - case 0 => { - (); - val f1 = { - scala.concurrent.Future.apply[Boolean](true)(scala.concurrent.ExecutionContext.Implicits.global) - }; - x$1 = 1; - t$1 = 0; - f2$1 = { - scala.concurrent.Future.apply[Int](42)(scala.concurrent.ExecutionContext.Implicits.global) - }; - f1.onComplete(this)(execContext$async) - } - case 1 => { - ifres$1 = 0; - if (await$1) - { - state$async = 2; - resume$async() - } - else - { - state$async = 3; - resume$async() - } - } - case 2 => { - f2$1.onComplete(this)(execContext$async); - () - } - case 5 => { - ifres$1 = await$2; - state$async = 4; - resume$async() - } - case 3 => { - ifres$1 = { - val z = 1; - inc$1(t$1.$plus(z)) - }; - state$async = 4; - resume$async() - } - case 4 => { - result$async.complete(scala.util.Success.apply(ifres$1)); - () - } - } - } catch { - case NonFatal((tr @ _)) => { - { - result$async.complete(scala.util.Failure.apply(tr)); - () - }; - () - } - }; - def apply(tr: scala.util.Try[Any]): Unit = state$async match { - case 0 => { - if (tr.isFailure) - { - result$async.complete(tr.asInstanceOf[scala.util.Try[Int]]); - () - } - else - { - await$1 = tr.get.asInstanceOf[Boolean]; - state$async = 1; - resume$async() - }; - () - } - case 2 => { - if (tr.isFailure) - { - result$async.complete(tr.asInstanceOf[scala.util.Try[Int]]); - () - } - else - { - await$2 = tr.get.asInstanceOf[Int]; - state$async = 5; - resume$async() - }; - () - } - }; - def apply: Unit = resume$async() - }; - val stateMachine$7: StateMachine[scala.concurrent.Promise[Int], scala.concurrent.ExecutionContext] = new stateMachine$7(); - scala.concurrent.Future.apply(stateMachine$7.apply())(scala.concurrent.ExecutionContext.Implicits.global); - stateMachine$7.result$async.future - } - -## References - -1. [The Scala Futures API][1] -2. [The Play! Framework][2] -3. [Scala Async on GitHub][3] - - [1]: https://docs.scala-lang.org/overviews/core/futures.html "ScalaFutures" - [2]: https://www.playframework.com/ "Play" - [3]: https://github.com/scala/async "ScalaAsync" diff --git a/_sips/sips/2015-6-18-repeated-byname.md b/_sips/sips/2015-6-18-repeated-byname.md deleted file mode 100644 index ee71571b6a..0000000000 --- a/_sips/sips/2015-6-18-repeated-byname.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -layout: sip -title: SIP-24 - Repeated By Name Parameters -vote-status: dormant -vote-text: Looking for a new owner. This proposal needs to be updated according to the SIP meeting in November 2016. -permalink: /sips/:title.html -redirect_from: /sips/pending/repeated-byname.html - ---- - -**By: Martin Odersky** - -## Motivation - -Scala so far does not allow by-name repeated parameters. But I can't see a good reason why this combination should be disallowed. Also, the combination is necessary to allow vararg parameters that are passed as expressions to inline methods (instead of being lifted out). - -## Syntax - -The syntax for `ParamType` becomes - - ParamType ::= [`=>'] ParamValueType - ParamValueType ::= Type [`*'] - -The syntax implies that a type such as `=> T*`, which is both by-name and repeated is interpreted as `=> (T*)`, that is, as a by-name type of a repeated type. - -## Translation Rules - -If a parameter has a by-name repeated type `=> T*` it matches an arbitrary number of actual arguments of type `T`. As usual for by-name parameters, the arguments are not evaluated at the point of call. Instead, all arguments are evaluated each time the parameter is referenced in the called method. - -The same holds for an vararg argument of the form `e: _*`. The argument expression `e` is evaluated each time the parameter is referenced in the called method. - -## See also - -[Dotty Issue #499](https://github.com/lampepfl/dotty/issues/499) diff --git a/_sips/sips/2016-01-11-static-members.md b/_sips/sips/2016-01-11-static-members.md deleted file mode 100644 index f36cc89d7d..0000000000 --- a/_sips/sips/2016-01-11-static-members.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -layout: sip -title: SIP-30 - @static fields and methods in Scala objects (SI-4581) -vote-status: "under-review" -vote-text: Authors need to update the proposal before the next review. -permalink: /sips/:title.html -redirect_from: /sips/pending/static-members.html ---- - -__Dmitry Petrashko, Sébastien Doeraene and Martin Odersky__ - -__first submitted 11 January 2016__ - -## Motivation ## - -We would like to allow methods and fields to be compiled as static. This is usable for interop with Java and other JVM languages, as well as with JavaScript, and is convenient for optimizations. - -## Use Cases - -Some JVM and JavaScript frameworks require classes to have specific static fields and/or methods. - -For example, classes extending `android.os.Parcelable` are required to have a static field named `CREATOR` of type `android.os.Parcelable$Creator`. - -Another example is using an [`AtomicReferenceFieldUpdater`](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.html). - -On the JavaScript side, one example is [Relay Route Definitions](https://web.archive.org/web/20180718024336/https://facebook.github.io/relay/docs/en/routing.html), whose subclasses must define static fields such as `queries`. -Static methods and fields for JavaScript classes are one of the very few things (if not the only thing) that Scala.js "cannot do" at the moment, at least not declaratively. - -## Overview ## - -In order for a method or field to be considered static it needs to be defined in an `object` and annotated `@static`. -There is no special syntax proposed to access these members, they are accessed as if they were a member of defining objects with all appropriate access requirements for accessing them. - -For example: - -{% highlight scala %} -class Foo - -object Foo { - @static val x = 5 - @static def bar(y: Int): Int = x + y -} - -println(Foo.x) -println(Foo.bar(12)) -{% endhighlight %} - -Intuitively, the presence of the `@static` annotation ensures that a field/method is declared as a static member of the companion class. -For the JVM, the above would therefore look to other Java code as if it had been declared with the following Java code: - -{% highlight java %} -class Foo { - public static int x = 5; - public static int bar(int y) { - return x + y; - } -} -{% endhighlight %} - -In Scala.js, the `@static` annotation has no semantic effect in Scala objects, as they are not visible from JavaScript anyway (it could be used for optimizations). -It has a semantic effect on Scala.js-defined JS classes, for example: - -{% highlight scala %} -@ScalaJSDefined -class Foo extends js.Object - -@ScalaJSDefined -object Foo extends js.Object { - @static val x = 5 - @static def bar(y: Int): Int = x + y -} -{% endhighlight %} - -would look to JavaScript code as if it had been declared with the following JavaScript code: - -{% highlight javascript %} -class Foo extends Object { - static bar(y) { - return x + y; - } -} -Foo.x = 5; // in ES6, there is no declarative syntax for static fields yet -{% endhighlight %} - -## Comparison with mirror classes ## - -Scalac currently generates static forwarders for fields and methods in top-level objects: - -{% highlight scala %} -object O { - val d = 1 - object I { - val f = 1 - } -} -{% endhighlight %} - -Under the proposed scheme users will be able to opt-in to have the field `f` defined in the inner object `I` emitted as a static field. -In case `O.d` is annotated with `@static` the field will be created as a static field `d` in `class O`. -If not annotated, it will be created in the companion module with a static forwarder `d` in `class O`. - -## Restrictions ## - -The following rules ensure that methods can be correctly compiled into static members on both JVM and JavaScript: - -1. Only objects can have members annotated with `@static` - -2. The fields annotated with `@static` should precede any non-`@static` fields. This ensures that we do not introduce surprises for users in initialization order of this class. - -3. The right hand side of a method or field annotated with `@static` can only refer to top-level classes, members of globally accessible objects and `@static` members. In particular, for non-static objects `this` is not accessible. `super` is never accessible. - -4. If a member `foo` of an `object C` is annotated with `@static`, the companion class `C` is not allowed to define term members with name `foo`. - -5. If a member `foo` of an `object C` is annotated with `@static`, the companion class `C` is not allowed to inherit classes that define a term member with name `foo`. - -6. Only `@static` methods and vals are supported in companions of traits. Java8 supports those, but not vars, and JavaScript does not have interfaces at all. - -Note that because of platform requirements for JavaScript interop, rules `3` and `4` would be lifted for objects that have a companion class that inherits `js.Any`. - -## Compilation scheme ## - -No modification of the typer is planned. The current proposed scheme piggybacks on already existing scoping restrictions in the typer, thus requiring `@static` methods to be defined in `object`s. - -If implemented in the dotty code base, the following modifications would be needed: - - - extend `RefChecks` to check restrictions 1, 2, 4, 5 and 6. This can be done in a separate mini-phase; - - extend `LambdaLift.CollectDependencies` to be aware that accessing a member annotated `@static` should not trigger capturing the object that contains this member; - - extend `LambdaLift` to trigger an error if a method annotated with `@static` method cannot be lifted to the top level scope; - - extend `GenBCode` to emit static fields and methods in companion classes and forwarders to them in companion modules. - -## Overriding & Hiding ## -Java allows classes to define static methods with the same name and signature as a static method of a superclass. In order to define the semantics of such cases, the Java Specification introduces the notion of [hiding](https://docs.oracle.com/javase/specs/jls/se8/html/jls-8.html#jls-8.4.8.2). - -This is required because in Java calling a `static` method on a class instance is supported. -This proposal does not need to introduce this notion as we do not support such calls. - -## Scala.js and @JSStatic ## -As Scala.js needs this feature fast, a decision has been made to ship it under a name of `@JSStatic` before waiting for this SIP to be accepted and implemented in `scalac`. When this SIP is accepted and implemented in `scalac` the `@JSStatic` would become a deprecated type alias to `scala.static`. - -## Comparison with [@lrytz's proposal](https://gist.github.com/lrytz/80f3141de8240f9629da) ## -Lukas Rytz has proposed a similar SIP, but his SIP requires changes to the typer to ensure that `@static` fields do not capture `this`, as in his proposal `@static` fields are defined in the class, rather than its companion object. -It also does not address the question of `@static` members in inner objects and inheritance/hiding of those methods in subclasses. - -## Open questions ## - - @static lazy val - -## Initialization order discussion ## -In general, emission of static fields could affect the initialization order and change semantics. -This SIP solves this by enforcing (rule `2`) that `@static` fields and expressions precede non-static fields. -This means that no code precedes the `@static` field initialization which makes it hard to observe the difference between if the field is initialized statically or not, -since fields are initialized in the order `as written`, similar to how normal fields are initialized. - -The `@static` proposal is similar to `@tailrec` in a sense that it fails compilation in the case where the user did not write code that follows the aforementioned rules. -These rules exist to enforce the unlikelihood of an observable difference in semantics if `@static` annotations are dropped; -The restrictions in this SIP make it hard to observe changes in initialization within the same object. -It is still possible to observe those changes using multiple classes and side effects within initializers: - -{% highlight scala %} -class C { - val x = {println("x"); 1 } -} - - -object O extends C { - val y = { println("y"); 2 } - // prints: - // x - // y -} - -object Os extends C { - @static val y = { println("y"); 2 } - // prints: - // y - // x -} -{% endhighlight %} - - -Static fields can be initialized earlier than they used to be initialized while being non-static, but never later. -By requiring `@static` first to be defined first inside the object, -we guarantee that you can't observe the changes in initialization withing the same object without resorting to code which either uses `Unsafe` or exhibits undefined behaviour under the JVM. - -## Could `@static` be a `@tailrec`-like annotation that doesn't affect code generation but only checks ## -Unlike `@tailrec` this annotation does affect the binary API and dropping such an annotation would be a binary incompatible change. This is why authors believe that developers should be in full control of what is static. - -## Alternative: Emitting fields of objects as static by default ## -An alternative to this proposal would be to emit all the fields defined in objects as static. -Unfortunately this gets us under dark waters when we try to figure out in the following example: - - -{% highlight scala %} -class Super { - val c = {println(1); 1} -} -object Object extends Super { - override val c = {println(2); 2} - val d = {println(3); 2} -} -{% endhighlight %} - -Let's consider possible options: - - - if the field `c` is emitted as `static` on the bytecode level, it will be initialized before the `c` in superclass is initialized, reordering side-effects in initializers; - - if the field `c` is _not_ emitted as `static` but the field `d` is, then the order of initialization would also be affected, reordering side-effects. - -Based on the previous study done in preparation for this SIP, the authors believe that the only reasonable way to maintain current semantics would be to say that such alternative would require these rules: - - - only the fields which were not declared by parents of the object can be emitted as static; - - only fields that are lexically defined before any non-static field or statement in the body can be emitted as static. - -Authors believe that the alternative would require the same effort to implement, but will be less intuitive to users and harder to control as, for example, reordering fields in object might not be binary compatible. - -## See Also ## - * [SI-4581](https://issues.scala-lang.org/browse/SI-4581) is a request for a `@static` annotation - * [Scala.js issue #1902](https://github.com/scala-js/scala-js/issues/1902) is a request for defining static fields in Scala.js-defined JS classes - * [Another proposal by @lrytz](https://gist.github.com/lrytz/80f3141de8240f9629da) - * [Old discussion on scala-internals mailing list](https://groups.google.com/forum/#!searchin/scala-internals/static/scala-internals/vOps4k8CADY/Dq1I3Ysvao0J) - * [Another discussion of scala-internals mailing list](https://groups.google.com/forum/#!searchin/scala-internals/static/scala-internals/Y3OlFWPvnyM/tGE5BQw4Pe0J) diff --git a/_sips/sips/2016-07-25-unsigned-integers.md b/_sips/sips/2016-07-25-unsigned-integers.md deleted file mode 100644 index ef8ecd7bf1..0000000000 --- a/_sips/sips/2016-07-25-unsigned-integers.md +++ /dev/null @@ -1,636 +0,0 @@ ---- -layout: sip -title: SIP-26 - Unsigned Integers - -vote-status: rejected -vote-text: The committee votes to reject the proposal because of a 6% performance hit on the provided implementation by the authors. -permalink: /sips/:title.html -redirect_from: /sips/pending/unsigned-integers.html ---- - -__Sébastien Doeraene and Denys Shabalin__ - -**Summary**: We propose the addition of 4 "primitive" types to represent -unsigned integers: `UByte`, `UShort`, `UInt` and `ULong`. - -A prototype implementation of this proposal, with unit tests and benchmarks, -can be found [here](https://github.com/scala/scala/compare/2.12.x...sjrd:uints). - -## History - -| Date | Version | -|--------------|---------------| -| Nov 9th 2015 | Initial Draft | - -## Introduction - Motivation - Abstract - -Scala was initially designed to target the JVM, and, as such, defines exactly -9 primitive types corresponding to the 9 primitive types of the JVM (including -`void`): - -* `Boolean` -* `Char` -* `Byte` -* `Short` -* `Int` -* `Long` -* `Float` -* `Double` -* `Unit` - -Compared to other languages, especially those in the tradition of -compile-to-machine code, this list is missing types for unsigned integer types. - -When compiling Scala to other platforms than the JVM, such as JavaScript with -Scala.js or native code/LLVM with the upcoming ScalaNative, the missing unsigned -integer types are a liability, especially when it comes to *interoperability -with host language libraries*. - -For example, if a C library defines a function accepting a `uint32_t`, how would -we type it in a FFI definition? Even in JavaScript, which supposedly has only -`Double`s, there are APIs working with unsigned integers. The most well-known -one is -[the TypedArray API](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray). -Currently, because of the lack of unsigned integers in Scala, the -[facade types for `Uint8Array` in Scala.js](https://github.com/scala-js/scala-js/blob/v0.6.5/library/src/main/scala/scala/scalajs/js/typedarray/Uint8Array.scala) -is forced to use `Short` elements instead of a more appropriate `UByte`. Worse, -[the one for `Uint32Array`](https://github.com/scala-js/scala-js/blob/v0.6.5/library/src/main/scala/scala/scalajs/js/typedarray/Uint32Array.scala) -has to work with *Doubles*, because there is no signed integer type existing on -JavaScript that can represent all values of a 32-bit unsigned int. - -On the JVM, interoperability is not an issue. However, it is still sometimes -useful to manipulate unsigned integers. An evidence of this fact is that Java 8 -has added methods in the JDK to *manipulate* signed integers *as if* they were -unsigned. One example is -[`java.lang.Integer.divideUnsigned`](https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html#divideUnsigned-int-int-). -Using signed integer types but interpreting them as unsigned is an obvious lack -of type safety, however. Java cannot decently add new primitive types for -compatibility reasons, but Scala has custom-made `AnyVal`s and other -Object-Oriented abstractions on top of primitive types that can allow for -additional, zero-overhead "primitive" types. - -We therefore propose to extend the Scala programming language with 4 new -primitive data types, representing unsigned integer types: - -* `scala.UByte`, an unsigned 8-bit integer -* `scala.UShort`, an unsigned 16-bit integer -* `scala.UInt`, an unsigned 32-bit integer -* `scala.ULong`, an unsigned 64-bit integer - -These data types will support a set of operations similar to their signed -counterparts, except that they will obviously encode the unsigned behavior. - -For example: - -```scala -val x = Int.MaxValue.toUInt + 1.toUInt // 2147483648 -assert(x.toString == "2147483648") -val y = Int.MaxValue.toUInt + 5.toUInt // 2147483652 -val z = x / y // unsigned division of 2147483652 by 2147483648 -assert(z == 1.toUInt) -assert(x % y == 4.toUInt) -``` - -## Motivating Examples - -### Examples - -#### Interoperability with host language unsigned integers - -The most important use case for true unsigned integers specified by the -language is interoperability with host languages with unsigned data types. - -If we try to manipulate an `Uint32Array` in Scala.js as currently defined, we -end up manipulating `Double`s, which can become extremely confusing: - -```scala -val array = new Uint32Array(js.Array(5, 7, 6, 98)) -val x = array(3) / array(0) -println(x) // 19.6 (!) -``` - -This also causes type safety issues, since nothing prevents the developer from -introducing a non-integer `Double` into such an array: - -```scala -array(2) = 6.4 // compiles, silent drop of precision -println(array(2)) // 6 -``` - -If we can define `Uint32Array` as an array of `UInt` instead, our problems are -solved: - -```scala -val array = new Uint32Array(js.Array(5, 7, 6, 98).map(_.toUInt)) -val x = array(3) / array(0) -println(x) // 19, as expected - -array(2) = 6.4 // does not compile, yeah! -``` - -#### Implementation of algorithms requiring unsigned operations - -No matter the platform, even on the JVM, we sometimes have to implement -algorithms that are best defined in terms of unsigned operations. Particularly, -more often than not, we want to treat bytes in a buffer as unsigned. - -For example, here is a (buggy) algorithm to decode text encoded in ISO-8859-1 -(latin1) into Unicode code points. Can you spot the issue? - -```scala -def decodeISO88591(buffer: Array[Byte]): String = { - val result = new StringBuilder(buffer.length) - for (i <- 0 until buffer.length) - result.append(buffer(i).toChar) - result.toString() -} -``` - -The problem is that `buffer(i).toChar` will first *sign-extend* the signed -`Byte` to an `Int`, then cut off the 16 most significant bits. If the initial -`Byte` was ">= 0x80", it was actually *negative*, and therefore the resulting -`Char` will have its 8 most significant bits set to 1, which is a bug. - -Fixing the algorithm requires knowledge of 2's complement properties and how -the bits are affected by arithmetic operations. The solution is -`(buffer(i) & 0xff).toChar`, which is totally non-obvious. - -With unsigned bytes, the problem does not happen by construction, and the -algorithm is straightforward: - -```scala -def decodeISO88591(buffer: Array[UByte]): String = { - val result = new StringBuilder(buffer.length) - for (i <- 0 until buffer.length) - result.append(buffer(i).toChar) // correct: UByte.toChar does not sign-extend - result.toString() -} -``` - -### Comparison Examples - -The blog post -[Unsigned int considered harmful for Java](https://www.nayuki.io/page/unsigned-int-considered-harmful-for-java) -explains in detail how to correctly manipulate signed integer types to make -them behave as unsigned. - -There are two main problems with this, considering only the JVM target: - -* We have to remember what operations need dedicated methods to deal with the - unsigned case. -* We cannot express in the type of a value whether it is to be interpreted as - a signed or unsigned integer. Effectively, we're back to *Assembly*-grade - weak typing. - -In addition, those separate manipulations do not allow back-ends to other -targets to effectively interoperate with host language unsigned data types. - -### Counter-Examples - -We do not intend to generalize unsigned numbers to Big integers nor to -floating-point numbers. - -Also, it is out of the scope of this proposal to provide literal constant -notations for unsigned integers. They should be constructed from their -corresponding signed literals, and reinterpreted using `.toUInt` and similar. - -## Drawbacks - -### Performance of arrays - -Unless the implementation of unsigned integer types is very much special-cased -in the compiler, arrays of unsigned integer types will likely suffer from the -same performance penalty as arrays of user-defined `AnyVal`s, because the -elements will be boxed. - -This might cause unexpected performance issues, as developers will think that -`Array[UByte]` is as fast as `Array[Byte]`, when in fact it is not. -Performance-critical code should still use `Array[Byte]`, and reinterpret the -bytes into unsigned bytes and back using `sb.toUByte` and `ub.toByte`, -respectively. - -## Alternatives - -The only other alternative is the status quo, where no unsigned integer types -exist, and difficult 2's complement-aware manipulations must be done when we -need them. - -## Design - -Naively, the design of the API is straightforward. We would define 4 new -data types `UByte`, `UShort`, `UInt` and `ULong`, corresponding to the 4 -signed integer data types. They feature the same set of arithmetic and logic -operations, as well as comparisons. However, such a naive design causes -several issues, especially when signed integers and unsigned integers interact -in operations. - -Here, we discuss the set of operations available, and their semantics. - -### No arithmetic/logic operations between signed and unsigned integers - -To prevent typical caveats when mixing signed and unsigned integers in most -languages, we simply *forbid* any arithmetic or logic operations with operands -of different signedness. - -### Universal equality, and hash codes - -The universal equality operators (`==` and `!=`) should behave consistently -across signed and unsigned types. Since `5.toByte == 5` in Scala, we should -also have `5.toUInt == 5`. This requires to modify the `==` implementation -(in `BoxesRunTime`) to implement cooperative equality checks between all -combinations of signed and unsigned values. - -Negative values of signed integers are *not* equal to any unsigned integer -value. For example, this means that `(-1).toUInt != -1`. This is very simply -explained by the fact that the mathematical value of `(-1).toUInt` is -4294967295. - -Because of transitivity of equality, it must be the case that a large value of -an unsigned integer (whose signed reinterpretation is negative, such as -`0xffffffff.toUInt`) *is* equal to values of a larger signed integer types -(such as `0xffffffffL`). - -Hash codes, as computed by `##`, must be made consistent with the generalized -form of universal equality. - -Note that this definition of universal equality is *essential* for these new -primitives to be usable for interoperability scenarios in Scala.js. This is -because, at runtime, "boxed" versions of numeric types loose their type -information, as they are all stuffed into primitive JavaScript numbers. -Therefore, `0xffff.toUShort` is indistinguishable from `0xffff`, and they must -be equal for this "non-boxing" to be valid. - -### Operations on `UByte` and `UShort` - -By analogy to the fact that operations on `Byte`s and `Short` start by -converting their operands to `Int`s (using sign-extend), operations on `UByte`s -and `UShort`s convert their operands to `UInt`s (without sign-extend, -obviously). - -### Arithmetic operations on `UInt`s and `ULong`s. - -For two operands of the same unsigned integer type with N bits, `a + b`, -`a - b`, `a * b`, `a / b` and `a % b` are computed modulo `2^N`. -For `+`, `-` and `*`, this boils down to a primitive (signed) equivalent -operations, on the JVM. `/` and `%` correspond to -`java.lang.{Integer,Long}.divideUnsigned` and `remainderUnsigned`. - -If one of the operand is a `ULong` but the other isn't, the latter is converted -to a `ULong` before performing the operation. - -There is no `unary_-`, because unsigned integers have no opposite. It could be -argued that `-x` could be useful for low-level bit-twiddling-based algorithms. -However, in that case, `~x + 1.toUInt` can be used instead. A basic peephole -optimizer can simplify the latter as `-x` on platforms where this is relevant. - -### Logic (bitwise) operations on `UInt`s and `ULong`s - -`unary_~`, `|`, `&` and `^` behave in the obvious way. If you want a precise -spec, they always behave as if the operand was reinterpreted into its signed -equivalent, then the operation performed, then the result reinterpreted back -into unsigned. - -### Bit shifting operations on `UInt`s and `ULong`s - -Shift left `<<` and shift logical right `>>>` behave in the obvious way. - -The case of shift arithmetic right `>>` is debatable. We argue that it should -*not* be available on unsigned integers for two reasons. - -First, a shift arithmetic right does not appear to have any *meaning* on -unsigned integers. The correct *arithmetic* shift if `>>>`. Therefore, -similarly to `unary_-`, it should not be introduced. - -Second, existing languages that do have unsigned integer types, such as the C -family, actually give different semantics to `>>` depending on whether it has -a signed or unsigned operand: a `>>` on an unsigned operand does *not* -sign-extend. It would be confusing to a C developer for `x >> 3` to sign-extend -in Scala, but it would be equally confusing to a Scala developer that `x >> 3` -*not* sign-extend. Therefore, we prefer to leave it out completely, and let a -compiler error be raised. - -If a bit-twiddling-based algorithm needs the sign-extending shift right, it is -always possible to reinterpret as signed, do the operation, and reinterpret -back as unsigned: `(x.toInt >> 3).toUInt`. - -Note: the current implementation does provide `>>`, until we agree on this -point. - -### Inequality operators - -`<`, `<=`, `>`, `>=` perform unsigned comparisons. On the JVM, they correspond -to `java.lang.{Integer,Long}.compareUnsigned`. - -### String representation - -The string representation is similar to that of signed integers, except that -all numbers are positive, obviously. On the JVM, they correspond to -`java.lang.{Integer,Long}.toUnsignedString`. - -### Implicit widening conversions - -Unsigned integers can be implicitly widened to "larger" unsigned integer types. -For example, `UShort` can be implicitly converted to `UInt` and `ULong`. - -There are no implicit conversions between signed and unsigned integers. It might -be tempting to allow unsigned integers to be widened to larger signed integer -types, since they can always accommodate their mathematical values. However, -this consequently allows operations between signed and unsigned integers, such -as `5L + 4.toUInt`, because of the conversion from `UInt` to `Long`. Since we -want to disallow those to prevent caveats, we do not allow the implicit -conversions. - -### Explicit conversions between signed and unsigned - -We have already extensively used explicit conversions between signed and -unsigned integer types *of the same size* in this document, such as -`someInt.toUInt`. These are specified as reinterpreting the bit pattern into -the other type, with the common specification that integer types are represented -in 2's complement. - -*Narrowing* conversions are also allowed in both directions, such as -`someInt.toUByte` or `someUInt.toByte`. They are equally well specified as -either `someInt.toUInt.toUByte` or `someInt.toByte.toUByte`, with the same -results, and therefore no ambiguity exists. - -*Widening* conversions from unsigned integers to larger signed integers is -allowed, and is specified by conserving the mathematical value, i.e., the -widening does *not* sign-extend. - -Finally, widening conversions from signed integers to larger unsigned integers -is *disallowed*, because both interpretations are equally valid, and therefore -half of the developers will have the wrong expectation. For example, -`someInt.toULong` can be equally validly specified as `someInt.toUInt.toULong` -or `someInt.toLong.toULong`, but those do not yield the same result (the former -does not sign-extend while the latter does). - -### Consequences on other parts of the library - -`scala.math` should receive new overloads of `max` and `min`, taking unsigned -integer types as parameters, and performing the comparisons with unsigned -semantics. - -There should be instances of the `Ordering` typeclass for unsigned integer -types. - -There should *not* be instances of the `Numeric` and `Integral` typeclasses -for unsigned integer types, since they do not support `unary_-`. - -It might be tempting to define `Range`s over unsigned integers, but we do not -want to go there. - -### Performance considerations - -Since they will inevitably be "branded" as primitive data types, unsigned -integer types should be as efficient as signed integer types. - -Fortunately, the JDK 8 added the necessary methods in the standard JDK to -trivially implement all the operations on unsigned integers. It is expected -that these methods be as fast primitive operations, since they can be -intrinsified easily. - -There also exist efficient implementations of these methods in Scala.js. LLVM -supports the relevant operations by default for ScalaNative, obviously. - -The implementations in `BoxesRunTime` for universal equality and hash codes -receives additional cases, which could slow down `==` on `Any`s and generic -values. However, if a codebase does not use any unsigned integer, the JVM, -using global knowledge, can statically determine that the new type tests are -always `false` and therefore remove them. There should be no performance -penalty on such codebases. - -## Implementation - -Because of the cooperative equality with primitive signed integers, the -addition of unsigned integers must necessarily integrate the core library. - -Besides that, there are two major strategies for the implementation: mostly -user-space or mostly in compiler-space. - -### Mostly user-space vs compiler-space - -An existing implementation living mostly in user-space can be found at -https://github.com/scala/scala/compare/2.12.x...sjrd:uints - -In this approach, unsigned integer types are user-defined `AnyVal`s, and all -the new methods are implemented in the library. The compiler needs very little -adaptations; basically only to dispatch `==` of unsigned integers to -`BoxesRunTime` (otherwise, it is "optimized" as directly calling `equals()`). - -This approach has obvious advantages: -* Little room for mistakes -* Very simple implementation -* Minimal impact on the compiler - -However, it also suffers from a couple of limitations, because the new -"primitive" data types are not really primitive, and do not receive some of the -semantic treatment of primitives. - -First, unboxing from `null`: a primitive data type unboxes `null` to its zero, -but user-defined `AnyVal`s throw in those situations. One way to fix this would -be to "fix" the behavior on `AnyVal`s in general, which we think would be a good -idea on its own anyway. - -Second, weak conformance: unsigned integers don't receive the weak conformance -properties. However, we argue that this is no big deal. The main use case for -weak conformance is so that `List(1, 5, 3.5)` can be inferred as a -`List[Double]` instead of a `List[AnyVal]`. The problem initially happens -because of the way we write literal integers and literal doubles. Since unsigned -integers have no literal notation, and are not implicitly compatible with -signed integers nor doubles, this point is moot. - -In the short term, these limitations do not appear important, and we could live -with them. - -More importantly, however, this implementation prevents specialization to be -applied on unsigned integers, and imposes harsh constraints on how back-ends -can implement unsigned integers. - -In Scala.js these constraints are not too hard from the point of view of -interoperability scenarios, although they could limit the performance we can -get out of unsigned integers. Since interoperability is paramount, we can again -live with the constraints for the time being. - -For ScalaNative, the consequences of these constraints are, as of yet, unknown, -but they could affect interoperability scenarios, and will most probably affect -performance. - -In the longer term, we should therefore consider more tightly integrating -unsigned integer types as true primitives of the compiler. - -Such a strategy will however be much riskier, and will take much more time to -get right. - -### Performance evaluation - -To evaluate performance of our prototype we've implemented a simple jmh -benchmark generator that checks composite performance of evaluation of complex -arithmetic expressions for all number types (both primitive signed ones and -user-defined unsigned ones.) - -For each type we've generated 4 benchmarks that use `+, -, *` ops (fastops) -and 4 benchmarks that use `+, -, *, /, %` (allops). Each of the 4 benchmarks uses exactly -the same arithmetic expressions for all types. Benchmarks on bytes and shorts wrap back -to corresponding type after each operation. - -The split between fastops and allops is important because unsigned division is -quite a bit slower than signed one on latest release of JDK 8: - - Benchmark Type Score Error Units - - division Int 289644141.092 ± 1544.707 ops/s - division UInt 129838344.866 ± 95523.094 ops/s - division Long 129839962.558 ± 90581.655 ops/s - division ULong 116493219.034 ± 67688.631 ops/s - - remainder Int 289454769.011 ± 94380.057 ops/s - remainder UInt 111032938.420 ± 679921.289 ops/s - remainder Long 128315753.345 ± 35932.509 ops/s - remainder ULong 97470062.788 ± 346773.054 ops/s - -And here are the results of composite benchmarks. - - Benchmark Type Score Error Units - - allop0 Byte 76612958.318 ± 97814.015 ops/s - allop0 UByte 26160709.822 ± 2098.556 ops/s - allop0 Short 76800575.238 ± 75373.970 ops/s - allop0 UShort 27172978.979 ± 3244.075 ops/s - allop0 Int 82816920.142 ± 50194.565 ops/s - allop0 UInt 27232792.726 ± 5116.920 ops/s - allop0 Long 28648964.226 ± 6115.162 ops/s - allop0 ULong 29657228.040 ± 159758.363 ops/s - - allop1 Byte 73715102.215 ± 17282.291 ops/s - allop1 UByte 26490808.836 ± 86628.862 ops/s - allop1 Short 73718029.884 ± 19413.132 ops/s - allop1 UShort 27041330.181 ± 4533.663 ops/s - allop1 Int 83239625.538 ± 13575.756 ops/s - allop1 UInt 28425497.966 ± 10927.728 ops/s - allop1 Long 29251967.961 ± 8278.100 ops/s - allop1 ULong 30537156.474 ± 14283.996 ops/s - - allop2 Byte 53138040.117 ± 7692.219 ops/s - allop2 UByte 19912528.484 ± 104896.763 ops/s - allop2 Short 52989318.748 ± 10075.293 ops/s - allop2 UShort 19828139.740 ± 217.796 ops/s - allop2 Int 60104405.263 ± 1888.322 ops/s - allop2 UInt 20576204.367 ± 446.445 ops/s - allop2 Long 20752333.428 ± 789.741 ops/s - allop2 ULong 22949083.651 ± 5766.597 ops/s - - allop3 Byte 68147811.661 ± 7349.838 ops/s - allop3 UByte 28016596.929 ± 4795.992 ops/s - allop3 Short 68147020.665 ± 8444.864 ops/s - allop3 UShort 29092855.210 ± 12323.477 ops/s - allop3 Int 93592095.470 ± 2970.030 ops/s - allop3 UInt 33298135.046 ± 15681.174 ops/s - allop3 Long 32276341.887 ± 3748.706 ops/s - allop3 ULong 53345993.564 ± 5486.483 ops/s - - fastop0 Byte 174384841.686 ± 13685.151 ops/s - fastop0 UByte 172490336.775 ± 42178.142 ops/s - fastop0 Short 174388762.469 ± 10303.837 ops/s - fastop0 UShort 172545184.374 ± 37150.012 ops/s - fastop0 Int 335919041.150 ± 121423.806 ops/s - fastop0 UInt 335925277.378 ± 120408.170 ops/s - fastop0 Long 339125057.494 ± 71538.513 ops/s - fastop0 ULong 339306595.964 ± 70387.619 ops/s - - fastop1 Byte 174736448.461 ± 9934.579 ops/s - fastop1 UByte 173817403.787 ± 20752.221 ops/s - fastop1 Short 174734415.599 ± 9850.473 ops/s - fastop1 UShort 173460828.250 ± 18068.154 ops/s - fastop1 Int 285178506.838 ± 129027.835 ops/s - fastop1 UInt 285137070.275 ± 145958.174 ops/s - fastop1 Long 285590926.722 ± 147048.419 ops/s - fastop1 ULong 274695574.679 ± 4878290.228 ops/s - - fastop2 Byte 168971931.233 ± 40481.486 ops/s - fastop2 UByte 169665745.096 ± 27401.842 ops/s - fastop2 Short 168979347.127 ± 11033.548 ops/s - fastop2 UShort 169675543.605 ± 19494.266 ops/s - fastop2 Int 287563728.176 ± 122987.272 ops/s - fastop2 UInt 287559086.868 ± 126833.074 ops/s - fastop2 Long 296129286.397 ± 171488.897 ops/s - fastop2 ULong 296142819.979 ± 167330.949 ops/s - - fastop3 Byte 333536457.973 ± 63928.967 ops/s - fastop3 UByte 339343014.623 ± 119819.041 ops/s - fastop3 Short 333535961.005 ± 69587.789 ops/s - fastop3 UShort 339354474.225 ± 121131.393 ops/s - fastop3 Int 475167307.642 ± 140060.266 ops/s - fastop3 UInt 475181473.416 ± 116982.494 ops/s - fastop3 Long 487109297.325 ± 580807.835 ops/s - fastop3 ULong 487190439.786 ± 737565.041 ops/s - -As you can see, fastops results have statistically insignificant differences -between signed and unsigned numbers. The same is true for allops for `Long` vs -`ULong`. - -Allops are 2-3x slower for `Byte`s, `Short`s and `Int`s, due to the fact that -unsigned division isn't as well optimised. We can probably make divisions for -`UByte` and `UShort` faster by using the regular division at the `Int` level, -but the current implementation does not do that yet. - -### Time frame - -We propose that unsigned integers be integrated in their user-space form as -early as possible, ideally in Scala 2.12, should this proposal be accepted in -time. An implementation is already available for Scalac, and it comes with an -exhaustive unit test suite. - -In the longer term, for 2.13 or 2.14, we propose to evaluate whether the -benefits of a compiler-space implementation outweigh the risks. The existing -test suite will make sure that the behavior of operations is unchanged. This -second phase should probably be studied jointly with the developments of -ScalaNative. - -## Previous discussions and implementations - -When -[Value Classes (SIP-15)](https://docs.scala-lang.org/sips/value-classes.html) -were first introduced, the possibility to have new numeric types such as -unsigned integers was mentioned as a motivation. Subsequently, several people -[came up with implementations](https://groups.google.com/forum/#!topic/scala-sips/xtmUjsY9gTY) -of unsigned Ints and Longs. Those implementations were however more hacky -proofs of concept than a really thought-out proposal. - -Our proposal improves on those early attempts in several aspects: - -* Comprehensive but curated set of operations that are available on unsigned - integers, in particular no mixing signed and unsigned integers (avoid common - pitfalls found in other languages) -* Precise semantics for all operations (a specification) -* A meaningful notion of equality, which works well with other primitive types -* Use JDK 8 methods to implement operations that are specific to unsigned - integers, such as division -* Complete implementation with a test and benchmark suites - -## Out of scope - -The following related aspects are out of the scope of this proposal: - -### Literal notation for unsigned integers - -This proposal does not introduce any literal notation for unsigned integers. -Instead, we always convert from signed literals, e.g., `5.toUInt`. - -Providing literal notation should be done in the context of a SIP for -generalized user-defined literals. - -### Efficient arrays of unsigned integers - -We do not plan to address the issue of efficient arrays of unsigned integers. -Solving this should be part of a broader context for efficient arrays of -user-defined value classes in general, such as the encoding used in Dotty. - -## Unresolved questions - -* Should `>>` be available on unsigned integers? -* Should `null` unbox to 0 for unsigned integers even in their user-space - implementation? This would require some more changes to the compiler. - -## References - -1. [Implementation mostly in user-space for scalac/JVM](https://github.com/scala/scala/compare/2.12.x...sjrd:uints) diff --git a/_sips/sips/2016-09-09-inline-meta.md b/_sips/sips/2016-09-09-inline-meta.md deleted file mode 100644 index c3eb059723..0000000000 --- a/_sips/sips/2016-09-09-inline-meta.md +++ /dev/null @@ -1,1012 +0,0 @@ ---- -layout: sip -title: SIP-28 - Inline meta -vote-status: dormant -vote-text: This proposal needs an owner. -permalink: /sips/:title.html -redirect_from: /sips/pending/inline-meta.html ---- - -**By: Eugene Burmako, Sébastien Doeraene, Vojin Jovanovic, Martin Odersky, Dmitry Petrashko, Denys Shabalin** - -## History - -| Date | Version | -| ---------------|----------------------------------------------| -| Aug 22nd 2016 | Initial Pre-SIP | -| Sep 9th 2016 | Initial SIP | - -## Preface - -This document represents the culmination of a design process that spans several years. -We did our best to extensively evaluate the design space and comprehensively document our findings. - -As a result, this is going to be a very long read. If you're just interested in getting a quick idea -of the proposal, you can read just the ["Intuition"][Intuition] section. - -## Motivation - -Def macros and macro annotations have become an integral -part of the Scala ecosystem. They marry metaprogramming with types -and work in synergy with other language features, enabling [practically important use cases][MacroUsecases]. - -However, in addition to having the reputation of an indispensable tool, Scala macros have also gained notoriety -as an arcane and brittle technology. The most common criticisms of Scala macros concern their -subpar tool support and overcomplicated metaprogramming API powered by scala.reflect. - -While trying to fix these problems via evolutionary changes to the current macro system, -we have realized that they are all caused by the decision to use compiler internals as the underlying metaprogramming API. -Extensive use of desugarings and existence of multiple independent program representations may have worked well -for compiler development, but they turned out to be inadequate for a public API. - -The realization that we cannot make meaningful progress while staying within the confines of scala.reflect -meant that our macro system needs a redesign. We took the best part of the current macros - their smooth integration -into the language - and discarded the rest, replacing scala.reflect with a better metaprogramming API -and coming up with a lightweight declaration syntax. In this document, we present the current version of the design. - -## Table of contents - - * [Intuition](#intuition) - * [Def macros](#def-macros) - * [Discussion](#discussion) - * [Inline/meta](#inlinemeta) - * [Language features](#language-features) - * [Inline definitions](#inline-definitions) - * [Inline reduction](#inline-reduction) - * [Meta expressions](#meta-expressions) - * [Meta expansion](#meta-expansion) - * [Meta APIs](#meta-apis) - * [Design considerations](#design-considerations) - * [Scala.meta](#scalameta) - * [Tool support](#tool-support) - * [Losing whiteboxity](#losing-whiteboxity) - * [Losing compiler internals](#losing-compiler-internals) - * [Macro annotations](#macro-annotations) - * [Why inline](#why-inline) - * [Out of scope](#out-of-scope) - * [Conclusion](#conclusion) - * [Credits](#credits) - -## Intuition - -In this section, we will walk through writing and using compile-time metaprograms that implement a subset of functionality -expected of language-integrated queries. Without going into much detail, -we will obtain high-level intuition behind the underlying mechanisms - -[Language-integrated query][Linq] is a technique that achieves smooth integration of database queries with programming languages. -A common approach to LINQ, popularized by .NET Framework 3.5, consists in representing datasources -by collection-like library types and then allowing users to write queries as series of calls to these types -using familiar higher-order methods like `map`, `filter` and others. - -We will now develop a sketch of a database access library built in the spirit of LINQ. -In this sketch, we will intentionally forgo the practicalities of building a LINQ library -(e.g. mapping from classes to datasources, design of internal ASTs, error reporting, etc.) -in order to clearly illustrate the role played by compile-time metaprogramming. - -Below we define a trait `Query[T]` that encapsulates a query returning a collection -of objects of type `T`. Next to it, we define its children `Table` and `Map` that represent -particular types of queries. `Table` stands for a datasource that knows about the underlying type -(in this sketch, we use an imaginary typeclass `TypeInfo` for that purpose). -`Map` models a restricted subset of SQL SELECT statements via a simple `Node` AST. - -``` -trait Query[T] -case class Table[T: TypeInfo]() extends Query[T] -case class Select[T, U](q: Query[T], fn: Node[U]) extends Query[U] - -trait Node[T] -case class Ref[T](name: String) extends Node[T] - -object Database { - def execute[T](q: Query[T]): List[T] = { ... } -} -``` - -In this model, a SQL query string `"SELECT name FROM users"` is represented as `Select(Table[User](), Ref[String]("name"))`. -Queries like the one just mentioned can be run via `Database.execute` that translates them into SQL, sends the SQL to the database, -receives the response and finally translates it to data objects. For the sake of simplicity, we will assume such implementation as a given. - -The key aspect of a LINQ facility is a convenient notation for queries. -Arguably, none of the aforementioned ways to write queries can be called convenient. -SQL, as any string-based representation, is prone to syntax errors, type errors and injections. -Explicit instantiation of `Query` objects is very verbose, and still doesn't solve all type errors. - -In this sketch, we define a LINQ API in the form of methods that mirror the collection API -from the standard library. We would like our users to be able to encode queries in intuitively looking, -statically typed calls to this API, e.g. `users.map(u => u.name)`, and then have our library translate these -calls into calls to `Query` constructors. - -``` -object Query { - implicit class QueryApi[T](q: Query[T]) { - def map[U](fn: T => U): Query[U] = { ... } - } -} - -case class User(name: String) -val users = Table[User]() -users.map(u => u.name) -// translated to: Select(users, Ref[String]("name")) -``` - -Among other ways, the desired effect can be achieved with compile-time metaprogramming. -A metaprogram that runs at compile time can detect all calls to `Query.map` and rewrite them -to invocations of `Select` with parameters of `map` transformed to corresponding instances of `Node`. - -### Def macros - -Before looking into the design of the new macro system, let's see how the problem at hand -can be solved using the currently available macro system. - -``` -import scala.language.experimental.macros - -object Query { - implicit class QueryApi[T](q: Query[T]) { - def map[U](fn: T => U): Query[U] = macro QueryMacros.map - } -} -``` - -`QueryApi.map` is called a macro def. Since macros are experimental, -in order to define a macro def, it is required to either have `import scala.language.experimental.macros` -in the lexical scope of the definition or to enable the corresponding setting in compiler flags. -This is only necessary to define a macro def, not to use it. - -Macro defs look like normal methods in the sense that -they can have term parameters, type parameters and return types. -Just like regular methods, macro defs can be declared either inside or outside of classes, -can be monomorphic or polymorphic, and can participate in type inference and implicit search. -Refer to [Appendix A][AppendixInteraction] for a detailed account of differences -between macro defs and regular defs. - -Bodies of macro defs have an unusual syntax. The body of a macro def starts with the conditional keyword `macro` and -is followed by a possibly qualified identifier that refers to a macro impl, -an associated metaprogram run by the compiler when it encounters corresponding macro applications. -Macro impls are defined as shown below. - -``` -import scala.reflect.macros.blackbox.Context - -object QueryMacros { - def map(c: Context)(fn: c.Tree): c.Tree = { - import c.universe._ - ... - } -} -``` - -Macro impls take a compiler context that represents the entry point into the macro API. -The macro API consists of a general-purpose metaprogramming toolkit provided by scala.reflect -and several specialized facilities exclusive to macro expansion. -A typical first line of a macro impl is `import c.universe._` that makes the entire scala.reflect API available to the metaprogrammer. - -In addition to the compiler context, for every term parameter of a macro def, its macro impl -takes a term parameter that carries a representation of the corresponding argument of the macro application. -Macro impls can also get ahold of representation of type arguments, but this functionality is unnecessary for this example. - -A macro impl returns an abstract syntax tree, and this AST replaces the original macro application in the compilation pipeline. -This is how we're going to perform the LINQ translation of calls to `Query.map`. - -``` -import scala.reflect.macros.blackbox.Context - -object QueryMacros { - def map(c: Context)(fn: c.Tree): c.Tree = { - import c.universe._ - - // c.prefix looks like: - // Query.QueryApi[]() - val q"$_.$_[$_]($prefix)" = c.prefix - - val node: Tree = fn match { - case q"($param) => $body" => - val sym = param.symbol - body match { - case q"$qual.$_" if qual.symbol == sym => - q"Ref[${body.tpe}](${sym.name.decodedName.toString})" - } - } - - q"Select($prefix, $node)" - } -} -``` - -In the listing above, we handle several challenges of macro writing. -First, we get ahold of the prefix of the application, i.e. the `users` part of `users.map(u => u.name)`. -Unlike macro arguments, prefixes aren't mapped onto parameters of macro impls, -so we need to use the dedicated `c.prefix` API. - -The next challenge is to extract the prefix from the macro application. -Since `Query.map` is an extension method, the actual prefix is going to be `QueryApi(users)`, not `users`, -therefore we need to apply some non-trivial effort. - -One way of getting to the query is to access the corresponding field of the implicit class, -doing something like `QueryApi(users).q`. Unfortunately, this is out of the question, because `q` is private, -and we cannot make it public without adding an extension method called `q` to `Query`. - -Another way of achieving the desired result is to take apart the abstract syntax tree representing `QueryApi(users)`, -extracting `users` as the argument of the application. -It looks like quasiquotes, -which are supposed to provide a convenient WYSIWYG interface to deconstructing Scala code, -are going to be a perfect fit. - -Unfortunately for macro writers, the Scala compiler heavily desugars code during compilation, -so even the modest `QueryApi(users)` -will get to the macro impl in the form of `Query.QueryApi[User](users)`. -Therefore the naive `q"$_($query)"` quasiquote is not going to work, -and we need to apply additional effort. With a bit of knowledge about compiler internals, -we take care of this. - -The final challenge is code generation. -The pattern match in listing above transforms the user-provided lambda expression into an equivalent `Node`. -Since our sketch only supports `Ref`, we only support simple lambdas that select a field from a parameter. -Finally, we produce the macro expansion that has the desired shape. - -### Discussion - -Note how the ability of def macros to access types dramatically improves user experience in comparison with purely syntactic translation. -First, even before `Query.map` gets to expand, the compiler typechecks its argument, making sure that -queries are well-typed. Secondly, we have a way to reliably check the shape of the supported lambda. -The symbol comparison in the nested pattern match makes sure that -the qualifier of field selection refers precisely to the parameter of the lambda -and not to something else accidentally having the same name. Finally, we use information about the type of the body -in order to figure our the mandatory type parameter of `Ref`. - -Also note another piece of knowledge about compiler internals that was essential to robust operation of the macro. -When generating a `Ref`, we can't simply call `sym.name.toString`, because the Scala compiler internally mangles non-alphanumeric names. -If the parameter of the lambda has such a name, a simple `toString` will produce unsatisfying results, -which is why we have to call `Name.decodedName` first. - -Before we conclude, let's highlight a very common metaprogramming mistake that we've just made in `QueryMacros.map`. -Def macros are unhygienic, which means that they don't prevent inadvertent name capture, i.e. scenarios like the following. - -``` -val Select = "hijacked!" -users.map(u => u.name) - -// error: too many arguments for -// method apply: (index: Int)Char in class StringOps -// users.map(u => u.name) -// ^ -``` - -If the macro user accidentally defines a term called `Select` or `Ref`, our macro is going to stop working -with what looks like a nonsensical error message. Because principled tool support wasn't among the design goals of -our macro system, a macro user getting this error is mostly helpless apart from trying to use internal compiler options -that print all macro expansions and then going through the resulting wall of text. - -One reliable approach to prevent hygiene errors is to use fully-qualified names for external references and -to generate unique names for local variables. A somewhat more concise, but potentially much more laborious approach is to explicitly -assign symbols to references and definitions emitted in macro expansions. -This approach often requires extensive knowledge of compiler internals, so it is less frequent in the wild. -Common to both of these approaches is that they require explicit attention from metaprogrammers and -failures to apply them typically go unnoticed. - -To sum it up, even in this simple macro we encountered situations where knowledge of compiler internals -(the desugaring of the `QueryApi` application, the fact that non-alphanumeric names are encoded) was essential. -We also ran into problems with tool support and hygiene, which demonstrates how important they are to a macro system. -These are all common criticisms of def macros. - -### Inline/meta - -User interface of def macros is a seamless extension to the existing language interface. -Thanks to macro defs looking like regular methods and macro applications looking like regular method applications, -macro users are likely to not even realize that they are using macros. - -Unfortunately, metaprogrammer interface leaves much to be desired. First, in the current macro system, -metaprograms have to be defined separately from their signatures, typically involving helper objects and -duplication of parameters. Secondly, the underlying metaprogramming API requires -knowing bits and pieces of compiler internals. For example, in the case of `Query.map`, -the metaprogrammer had to know the internal representation of the `QueryApi` application -and internal details of how names are represented. - -New-style macros provide the same user interface, and at the same time significantly improve metaprogrammer -interface by enabling lightweight macro declaration syntax and using a better metaprogramming API. - -``` -object Query { - implicit class QueryApi[T](q: Query[T]) { - inline def map[U](fn: T => U): Query[U] = meta { - import scala.meta._ - - val q"$_($prefix)" = this - - val node: Tree = fn match { - case q"($name: $_) => $body" => - body match { - case q"$qual.$_" if qual =:= name => - q"Ref[${body.tpe}](${name.toString})" - } - } - - q"Select($prefix, $node)" - } - } -} -``` - -At a glance, new-style macros simply forgo a noticeable amount of ceremony, -merging the previously disparate macro defs and macro impls as well as swapping around a few keywords in the process. -The underlying metaprogram doesn't seem to have changed much, -still using quasiquotes and key APIs like `Tree.tpe` and `Name.toString`. - -First impression notwithstanding, the new design revamps a lot of underlying mechanisms. -Below we provide a high-level overview of our new approach to compile-time metaprogramming, -and refer curious readers to ["Language features"][LanguageFeatures] for information concerning the new expansion mechanism -and to ["Scala.meta"][ScalaMetaSection] for details about the new metaprogramming API. - -**Expansion mechanism**. The new design takes the notions of inlining and compile-time execution -from the current macro system and turns them into separate language features. - -The goal of the `inline` modifier on `Query.map` is to signify that applications of this method are inlined, -i.e. replaced with the method body, in which references to enclosing `this`, self, and formal parameters are rewritten accordingly -(see ["Inline reduction"][InlineExpansion] for details). - -The goal of the `meta` keyword is to demarcate code that executes at compile time and to provide -that code with [scala.meta capabilities][MetaApis]. -The metaprogram written inside the meta scope has access to multiple implicit capabilities -and can get ahold of representations of certain values and types from lexical scope. -The compiler runs this metaprogram, interprets its result as an abstract syntax tree -and replaces the meta expression with that tree (see ["Meta expansion"][MetaExpansion] for details). - -When the compiler encounters a call to `Query.map`, -it simply inlines the body of `map` into the callsite without performing any compile-time function execution. -For the running example of `users.map(u => u.name)`, -this inlining produces the result illustrated in the listing below. - -``` -{ - val prefix$1: QueryApi = QueryApi(users) - val fn$1: User => String = u => u.name - meta { - import scala.meta._ - - val q"$_($prefix)" = q"QueryApi(users)" - - val node: Tree = q"u => u.name" match { - case q"($name: $_) => $body" => - body match { - case q"$qual.$_" if qual =:= name => - q"Ref[${body.tpe}](${name.toString})" - } - } - - q"Select($prefix, $node)" - } -} -``` - -Before inlining a method application, the compiler first hoists the prefix and by-value arguments of the application -into temporary variables. This is done in order to guarantee that applications of inline methods -are semantically equivalent to applications of regular methods. - -Afterwards, the compiler replaces the application with a block that consists of hoisted values and the transformed method body. -In the method body, all regular references to `this` and self as well as -by-value parameters are rewritten to references to the corresponding temporary variables. -If such references are part of a meta scope, they are replaced with scala.meta-based representations of -the prefix and the corresponding arguments, without going into temporary variables. - -When the compiler comes across a meta expression that isn't part of an inline method, -it executes the code inside the expression and replaces the expression with the result of execution. -For our running example, this produces the desired expansion that invokes query constructors corresponding -to the LINQ notation. - -**New metaprogramming API**. Scala.meta noticeably improves on scala.reflect in the convenience of the API -and no longer requires metaprogrammers to understand compiler internals in order to write macros. - -In particular, we don't need to know that construction of the implicit class involves -expanding the reference to `QueryApi` into a fully-qualified name and inferring the missing type argument. -The particular implementation of the scala.meta API that runs the meta expression may or may not -do these desugarings, and scala.meta shields us from this fact. -We can use the WYSIWYG pattern `q"$_($prefix)"` in order to unwrap the original prefix of the call. - -Moreover, we don't have to worry about the compiler internally mangling non-alphanumeric names. -Again, even if the underlying macro engine internally does name mangling, scala.meta abstracts away such implementation details. - -Finally, we are able to improve on scala.reflect thanks to more precise quasiquotes. -If in the current macro system, we used `q"($name: $_) => ..."` to match the `fn` argument, -`name` would capture a scala.reflect `Name` that doesn't carry any semantic information. -In scala.meta, names are full-fledged trees, so we can use `Tree.=:=` to semantically compare the name -with the qualifier of the field selection. - -In order to use semantic APIs, scala.meta metaprograms need the [mirror capability][ScalaMetaSection], -so it is implicitly provided inside meta scopes. As a result, meta expressions can use the full spectrum -of APIs available in scala.meta. - -**To put it in a nutshell**, the new-style macro system combines two language features: -[inline definitions][InlineDefs] and [meta expressions][MetaExprs] -in order to provide a more lightweight syntax for the current def macros. Moreover, this macro system -does a switchover from scala.reflect to scala.meta, featuring a new API that is more convenient and -doesn't require compiler knowledge to be utilized effectively. - -## Language features - -### Inline definitions - -We introduce a new reserved word: `inline`, which can be used as a modifier for -concrete vals, concrete methods and parameters of inline methods, as illustrated in the listing below. - -``` -inline val x = 4 - -inline def square(x: Double) = x * x - -inline def pow(b: Double, inline n: Int): Double = { - if (n == 0) 1 - else b * pow(b, n - 1) -} -``` - -Inline vals are guaranteed to be compile-time constants, superseding the existing approach -of declaring such constants with `final val`. Inline parameters get the same treatment, adding a previously -non-existent functionality of guaranteeing that an argument of a method is a compile-time constant. - -A value is considered to be a compile-time constant if it is a Scala literal, -or it is equivalent to one by the means of inline/meta expansion and constant folding. -Future work may extend this notion to custom classes, but this discussion lies outside the scope of this proposal. - -Inline defs are guaranteed to be inlined at compile time, superseding the existing approach of -annotating methods with the `@inline` annotation. After introducing `inline`, we expect to deprecate and phase out `@inline`. - -The problem with `@inline` is that it doesn't provide guarantees. -As specified in documentation, -`@inline` tells the compiler to "try especially hard to inline the annotated method". -However, different backends interpret this request differently. -The JVM backend ignores this annotation if optimizations are disabled and sometimes skips inlining even when optimizations are enabled. -Both Scala.js and Scala Native always inline methods that are marked with this annotation. -In contrast, `inline` achieves guaranteed inlining, regardless of the backend. - -Inline defs are very similar to macro defs in the sense that they look like regular defs and that they expand at compile time. -As a result, the rules in [Appendix A][AppendixInteraction] also apply to inline defs with three exceptions. - - 1. Inline defs are effectively final; they cannot be overridden. Inline members also never override other members. -The idea of allowing macro defs to override regular defs didn't find compelling use cases, so we prohibit this for inline defs. - - 1. Inline defs can have default parameters. Not supporting default parameters for macro defs was an oversight -of the initial design, so now we fix this oversight in the new macro system. - - 1. Inline defs have regular bodies, just like regular defs. When an inline def is typechecked, its body -is typechecked according to the usual rules, which means that inline defs are eligible for return type inference. If an inline def -doesn't explicitly specify its result type, the result type gets inferred from the type of its body. - -### Inline reduction - -When the compiler encounters certain patterns of code that involve references to inline vals and applications of inline defs, -it will perform the rewritings provided below, if and only if these patterns appear outside the bodies of inline vals and defs. - - 1. If `prefix.v` refers to an inline value, replace the expression with the body of `v`. - - 1. If `prefix.f[Ts](args1)...(argsN)` refers to a fully applied inline method, hoist the prefix and the arguments -into temporary variables with fresh names and then replace the expression with the method body. In the body, replace parameter references -with references to temporary variables created for the corresponding arguments. Also, replace enclosing `this` -and self references with references to the temporary variable created for the prefix. - - ``` - { - val prefix$1 = prefix - val param1$1 = arg1 - ... - val paramN$1 = argN - - } - ``` - - The hoisting is intended to preserve the semantics of method applications under inlining. - A method call should have the same semantics with respect to side effects independently - on whether the method was made inline or not. - If an inline method has by-name parameters, then corresponding arguments are not hoisted. - - The rewriting is done in accordance with hygiene. Any references from the method body to its lexical scope - will be kept in the rewritten code. If the result of the rewriting references private or protected definitions - in the class that defines the inline method, these references will be changed to use accessors generated automatically by the compiler. - To ensure that the rewriting works in the separate compilation setting, - it is critical for the compiler to generate the accessors in advance. - Most of these accessors can be pregenerated by analyzing the bodies of inline methods, - except for members that are referred to inside meta scopes. - Such references are disallowed, because it is impossible to generate them in advance. - - 1. If `prefix.f[Ts](args1)...(argsN)` refers to a partially applied inline method, an error is raised. -Eta expansion of inline methods is prohibited. - -The rules of inline reduction are similar to the rules of feature interaction for macro applications ([Appendix A][AppendixInteraction]) -as well as relevant parts of the rules of def macro expansion ([Appendix B][AppendixExpansion]) with four exceptions. - - 1. Inline reductions in their current form preclude whitebox expansion. -Since bodies of inline vals and defs are typechecked when their definitions are typechecked, -potential meta expansions that may happen afterwards won't be able to change their types. -Implications of this are discussed in ["Losing whiteboxity"][Whiteboxity]. - - 1. By-value and by-name arguments behave differently. By-value arguments are hoisted in temporary variables, -while by-name arguments remain as they were. This doesn't affect meta expansions, -but it does make a semantic difference for parts of inline definitions that are not inside meta scopes. -Note that `this` and self references always follow the by-value scheme, -because there is no syntax in Scala that allows to define them as by-name. - - 1. Named and default arguments are fully supported. Again, not including them in the initial release of def macros -was an oversight, which is now fixed. - - 1. The rules of rewriting mandate the "outside in" style, i.e. calls to inline methods are expanded before possible calls -to inline methods in their prefixes and arguments. This is different from how the "inside out" style of def macros, -where prefixes and arguments are expanded first. Previously, it was very challenging to -take a look at unexpanded trees, but now the metaprogrammer can switch between unexpanded and expanded views using scala.meta. - -From the discussion above, we can see that inline reduction closely resembles the inlining aspect of the current macro system. -The only significant difference is lack of support for whitebox expansion, which will be discussed in ["Losing whiteboxity"][Whiteboxity]. - -### Meta expressions - -A meta expression is an expression of the form `meta { ... }`, where `{ ... }` is some block of Scala code, called meta scope. -(In fact, `meta` may prefix arbitrary expressions, but blocks are expected to be used most commonly). - -Meta expressions can appear both -in the bodies of inline methods (then their expansion is going to be deferred until the enclosing method expands) -and in normal code (in that case, their expansion will take place immediately at the place where the meta expression is written). - -Meta scopes can contain arbitrary code, but they must return values that are either of type `scala.meta.Term` or are convertible -to it via the `scala.meta.Lift` typeclass. There are standard instances of the typeclass that lift simple values to literals -as well as ones that support frequently used collections of liftable values. Metaprogrammers may define and use their own instances -as long as they are available in corresponding meta scopes. - -Inside meta scopes, metaprogrammers can use a combination of general-purpose and expansion-specific metaprogramming facilities. -Refer to ["Meta APIs"][MetaApis] for more information. - -Since meta scopes must return scala.meta trees, and scala.meta trees are by design statically untyped, -the type of meta expressions can't be computed from the inside -and has to come from the outside. Therefore, meta expressions can only be used in contexts that specify an expected type. - -``` -// allowed, expected type provided by the return type -inline def map[U](fn: T => U): Query[U] = meta { ... } - -// not allowed, no explicit return type -val x = meta { ... } - -// allowed, expected type of a condition is Boolean -if (meta(T.isPrimitive)) { ... } -``` - -Meta scopes can reference names in their lexical scope outside the enclosing meta expression. -While crossing the `meta` boundary, references change their meaning. -Concretely, here's how the transformation works for different references: - -**Inline vals and inline parameters**. These are guaranteed to be compile-time constants, -so an inline value of type `T` is available inside a meta scope as a regular value of type `T`. - -**Inline defs**. When viewed from within a meta scope, inline defs become tree transformers. -Types of their inline parameters are unchanged, their non-inline parameters and return type become typed as `scala.meta.Term`. -For example, `inline def pow(b: Double, inline n: Int): Double` transforms into -`def pow(b: scala.meta.Term, n: Int): scala.meta.Term`. - -**Term parameters of an inline method**. References to statically known term parameters, -enclosing `this` or self become values of type `scala.meta.Term`. This is similar to `c.Expr`/`c.Tree` -parameters of macro impls, but more lightweight, because there's no need -to declare these parameters explicitly. - -**Type parameters of an inline method**. References to statically known type parameters become values -of type `scala.meta.Type`. This is similar to `c.WeakTypeTag` parameters of macro impls, -but more lightweight, because metaprogrammers don't need to explicitly manifest their interest in given type parameters -in order to get access to their representations. - -This rule can create clashes between term and type namespaces. -If such a clash happens, i.e. if a reference to a type parameter is ambiguous with an eponymous term, -the compiler emits an error. This is regrettable, but Scala naming conventions make this situation unlikely, -and there is always a workaround of renaming the type parameter. - -**Global definitions**. Statically available types and terms, e.g. `List` or `Int`, -are usable inside meta scopes as themselves. This means that meta expressions, just like macro impls, -can use the standard library and arbitrary third-party libraries. - -**Other definitions**. Macro scopes cannot reference definitions that don't fall into one of the categories mentioned above. -This outlaws usages of local definitions - both terms and types. Such definitions may refer to state that only -exists at runtime, so we prohibit them altogether. This has no analogues in the current macro system, because macro impls -must be defined in static methods, which means that by definition their scope cannot contain local definitions. - -In other words, definitions that are statically available outside meta scopes remain available in meta scopes, -term and type arguments of inline methods become available as their representations, -while signatures of inline methods are recursively transformed according to the rules above. - -From the discussion above, we can see that meta expressions provide an analogue of the compile-time execution part -of the current macro system. In addition to achieving feature parity, meta expressions also improve on the corresponding part of def macros -by allowing metaprograms to easily obtain representations of their term and type parameters and -making it possible to run anonymous snippets of metaprogramming code without wrapping them in a dedicated macro. - -### Meta expansion - -When the compiler encounters a meta expression that appears outside the bodies of inline vals and defs, -it expands that expression as described below. - -A meta expression is expanded by evaluating its body and replacing the original meta expression with an expression -that represents the result of the evaluation. The compiler is responsible for providing [the capabilities][MetaApis] -necessary for meta scopes to evaluate and for converting between its internal representation for language model elements -and representations defined in scala.meta, such as `scala.meta.Term` and `scala.meta.Type`. - -Meta expansion works very similarly to the relevant part of the def macro expansion pipeline ([Appendix B][AppendixExpansion]). -Code in the meta scope is precompiled and then reflectively invoked by the compiler, sharing the class loader with other -metaprograms run inside the compiler. Expansion can return normally or can be interrupted with an exception. Expansion results -are typechecked against the expected type of the meta expression. Typecheck results are upcast to the expected type in blackbox style, -as discussed in ["Losing whiteboxity"][Whiteboxity]. - -Another practicality of meta expansion is the protocol of communication between `inline` and `meta`. -On the one hand, a reasonable default for inlining that doesn't involve meta expressions is to hoist prefixes and by-value arguments -as described in ["Inline reduction"][InlineExpansion]. On the other hand, macro writers default to having unfettered access to -abstract syntax trees without needing to write additional boilerplate. -These two design preferences are at odds with each other. - -Therefore, in our design `inline` both hoists eligible components of inline applications and passes their original -representations into meta expressions. This way, both defaults are satisfied and, additionally, if meta expressions need -to hoist something, they can use the new `hoist` API. - -In the case when an inline method consists in a single meta expression, the new macro engine removes temporary variables -that are produced by hoisting and aren't claimed by `hoist`. In the case when an inline method doesn't contain -meta expressions, all temporary variables are retained, because they are necessary to express method application semantics. -Finally, in the case of a hybrid inline method, meta expressions can look into representations of hoisted expressions, -but they cannot use them in their expansions without calling `hoist` first in order to avoid reordering or duplicating side effects. - -In a nutshell, meta expansion closely resembles the compile-time execution aspect of the current macro system. -The only nuance is the interaction with hoisting performed by the mechanism of inline reduction. - -### Meta APIs - -In scala.meta, all APIs are available out of the box after doing `import scala.meta._`. -However, in order to use most of them, metaprogrammers must have access to certain capabilities -(see ["Scala.meta"][ScalaMetaSection] for details). - -Meta scopes provide two different capabilities. First, there are general-purpose metaprogramming facilities, -enabled by a `Mirror`. Secondly, there are expansion-specific facilities enabled via a newly introduced `Expansion`. - -Mirrors are explained in ["Scala.meta"][ScalaMetaSection], and in this section -we will cover the functionality enabled by expansions. We will also compare this functionality -with macro APIs from the current macro system. - -First, `Context.prefix` is no longer necessary, -because meta expressions can refer to prefixes of enclosing inline definitions via `this`. -`Context.macroApplication` is unnecessary as well, because meta expressions may be written outside inline vals and defs, -which means that they won't have a corresponding application at all. In the rare cases when it is useful to know -the position that spans the entire inline application, it can be obtained by traversing prefixes or arguments via `Tree.parent`. - -Secondly, much like their counterparts in the current macro system, meta APIs support diagnostic messages. -Since the only prevalent macro APIs in this group is `Context.abort`, with `Context.error`, `Context.warning` -and others seeing rare use, we only expose `abort` that works similarly to its predecessor. - -Thirdly, we no longer expose APIs that tightly integrate with compiler internals. Most of these APIs take care -of the limitations of the scala.reflect language model, so in the new metaprogramming framework based on scala.meta -they are simply unnecessary. Others feature advanced functionality that accesses or manipulates internal compiler state, -and this exactly the kind of thing that we would like to avoid in the macro system. We discuss the implications in -["Losing compiler internals"][CompilerInternals]. - -Finally, we also support `hoist`, which takes a `scala.meta.Term`, precomputes it in a temporary variable -outside the meta expansion and returns a reference to it. -Apart from `inline`-compatible precomputation of prefixes and arguments, -this functionality seems relevant to solving the problem of sharing expansions of [implicit materializers][Materialization], -so we are confident that it's a useful addition to the macro API. - -## Design considerations - -### Scala.meta - -Scala.meta is a clean-room implementation of a metaprogramming toolkit for Scala, -designed to be simple, robust and portable. We are striving for scala.meta to become a successor of scala.reflect, -the current de facto standard in the Scala ecosystem. - -We have recently released Scala.meta 1.0.0 that features support for syntactic APIs, such as parsing, tokenization, -quasiquotes and prettyprinting. We are currently working on Scala.meta v2 that will enable semantic APIs, such as -typechecking, name resolution and others. - -In [Appendix C][AppendixMeta], we provide a high-level overview of the architecture of scala.meta -along with several practical examples that illustrate its functionality. - -### Tool support - -The key innovation of the new macro system is the fact that it's based on scala.meta, which finally makes it feasible to -provide third-party implementations of mirrors. - -There now exists a prototype implementation of an IntelliJ mirror, and, in further effort of Mikhail Mutcianko from the IntelliJ team, -this mirror has become the foundation for [an interactive expander of new-style macro annotations][PrototypeIntellij]. -This recent advancement strongly suggests that it was the right choice to bet on scala.meta to fix -code compehension and error reporting issues with the current macro system. - -This takes some pressure off whitebox macros. In the current macro system, there is a preference towards blackbox macros, -because they are much friendlier to IntelliJ. Once we have a fully-working mirror for IntelliJ, user experience of blackbox -and whitebox macros should be equivalent. For additional discussion of whiteboxity from a language design and compiler development -perspective, refer to ["Losing whiteboxity"][Whiteboxity]. - -Improvements in support for incremental compilation, testing and debugging also hinge on a capability of scala.meta -to enable custom mirror implementations. -However, they also require significant new functionality to be developed in the corresponding tools -([additional dependency tracking mechanisms for the incremental compiler][SbtMacroSupport] and changes to the vanilla debugger in IDEs). - -### Losing whiteboxity - -It is desirable for the new design to provide reasonable feature parity with the -current macro system. So far, the biggest digression from this course is giving up whitebox expansion. -In this section, we discuss what it will cost us to follow this through, identify the aspects of the new design that -prevent whiteboxity and propose alternatives. - -The main motivation for getting rid of whitebox expansion is simplification - both of the macro expansion pipeline -and the typechecker. Currently, they are inseparably intertwined, complicating both compiler evolution and tool support. -Therefore, the new design tries to disentangle these systems. - -Let's recapitulate the limitations that def macro expansion applies to applications of blackbox macros, -outlining the most important use cases that blackboxity cannot express. This won't give us the full picture, -because there are many macros in the wild that we haven't classified, but nonetheless it will provide an understanding -of the significant chunk of the Scala macros ecosystem. - - 1. When an application of a blackbox macro expands into a tree `x`, the expansion is wrapped into a type ascription `(x: T)`, -where `T` is the declared return type of the blackbox macro def with type arguments and path dependencies applied in consistency -with the particular macro application being expanded. -This invalidates blackbox macros as an implementation vehicle for [anonymous type providers][AnonymousTypeProviders]. - - 1. When an application of a blackbox macro is used as an implicit candidate, no expansion is performed until the macro -is selected as the result of the implicit search. -This makes it impossible to dynamically calculate availability of implicit macros, -precluding some advanced aspects of [materialization][Materialization]. - - 1. When an application of a blackbox macro still has undetermined type parameters after the Scala type inference algorithm has finished -working, these type parameters are inferred forcibly, in exactly the same manner as type inference happens for normal methods. -This makes it impossible for blackbox macros to influence type inference, prohibiting [fundep materialization][Materialization]. - - 1. When an application of a blackbox macro is used as an extractor in a pattern match, -it triggers an unconditional compiler error, preventing [customizations of pattern matching implemented with macros][ExtractorMacros]. -This precludes blackbox macros from providing precise types to values extracted from patterns written in external DSLs, -preventing a library-based implementation of quasiquotes. - -As we can see, whitebox expansion plays an important role in several use cases, the most practically significant -of them being fundep materialization and quasiquote patterns. Fundep materialization is paramount to the design of Shapeless. -Quasiquote patterns are an integral part of writing any kinds of macros - both blackbox and whitebox - which is the main -reason to use scala.reflect. - -It is now clear that our desire for simplification is at odds with the ways how the Scala community uses macros. -In order to resolve the apparent conflict, we outline several solutions, whose evaluation we leave for later. - -**Give up on simplification**. This is probably the most obvious approach, in which we admit -that tight coupling with the typechecker is intrinsic to the essence of Scala macros and change the new design -to enable whitebox expansion. - -Concretely, accommodating whiteboxity in the new macro system requires changing the aspects of the new design -specified in ["Inline reduction"][InlineExpansion] and ["Meta expansion"][MetaExpansion] according to the -plan provided below. - - * Force inline reductions and meta expansions inside the typechecker. Currently, both the rules of inline reduction -and the rules of meta expansion are intentionally vague about the exact point in the compilation pipeline that does expansions, -but whiteboxity will leave us no room for that. - * Delay typechecking of the bodies of inline vals and defs until their expansion. Meta expressions inside inline definitions -are not expanded, which means that eager typechecking of these definitions precludes whitebox expansion. - * Allow using meta expressions without expected type. This captures the main idea of whitebox expansion, in which compile-time -metaprogramming has the final say about the type of transformed snippets of code. - -**Assimilate the most popular use cases**. Instead of supporting the general notion of whiteboxity, -we can introduce dedicated compiler support for the most popular uses cases including the `Generic` -mechanism in Shapeless and quasiquote patterns in scala.reflect. - -This is an attempt at a compromise. On the one hand, this approach allows us to follow through with simplification. -On the other hand, it significantly minimizes the impact on the existing users of whitebox macros. - -The downside of this solution is that it requires an extensive design process (because it involves adding new language features to Scala) -and assumes that the internalized techniques have reached their final form. If a new version of Shapeless -or a new version of scala.reflect (read: scala.meta) decide to adapt their designs after these designs have been assimilated, -they will have a very hard time doing that. - -**Dedicated support for type-level computations**. Manifestations of whiteboxity are quite diverse, -but a lot of them are reducible to type-level computations. - -For example, let's take a macro `join` that takes two objects and outputs an object that -has fields of both. Since Scala doesn't have row polymorphism, it is impossible to write a type signature -for this macro, so we have to declare it as whitebox. - -``` -scala> def join(x: Any, y: Any): Any = macro ... -defined term macro join: (x: Any, y: Any)Any - -scala> join(new { val x = 2 }, new { val y = 3 }) -res0: AnyRef{val x: Int; val y: Int} = $anon$1@64af328d -``` - -Here we can see how the whitebox macro encapsulates a type-level computation that takes -the types of both arguments (`AnyRef{ val x: Int }` and `AnyRef{ val y: Int }`) -and merges them into the result type. Since this computation doesn't involve the abstract syntax trees -of the arguments, the whitebox part of the macro can be extracted into a helper, making the macro itself -blackbox. - -``` -scala> :paste -// Entering paste mode (ctrl-D to finish) - -trait Join[T, U, V] -object Join { - implicit def materialize[T, U, V]: Join[T, U, V] = macro ... -} - -// Exiting paste mode, now interpreting. - -defined trait Join -defined object Join - -scala> def join[T, U, V](x: T, y: U) - | (implicit ev: Join[T, U, V]): V = macro ... -defined term macro join: [T, U, V](x: T, y: U)... -``` - -This approach can express some macros that refine their return type, all fundep materialization macros, -and even some macros that dynamically compute availability of implicits (such macros can be modified to take -an additional implicit parameter whose failure to materialize can be used to control availability of the enclosing implicit) - -that is, all macros whose whiteboxity depends only on types of their prefix and arguments. - -Now, after eligible whitebox macros are rewritten this way, we can replace the whitebox materializers -that compute types, e.g. `Join.materialize`, with a dedicated language feature that natively expresses them. -The listing below provides a sketch of an imaginary syntax that assumes inline types and type-generating meta expressions. - -``` -inline type Join[T, U] = meta { - import scala.meta._ - val jointVals = union(T, U) - t"{ ..$jointVals }" -} - -inline def join[T, U](x: T, y: U): Join[T, U] = meta { ... } -``` - -From the discussion above, we can see that whiteboxity is an important feature of the current macro system -and is used in multiple highly popular open-source libraries. As a result, giving up whiteboxity -may lead to undesired practical consequences. - -More work is needed to reconcile the design of the new macro system -and existing use cases, and in this section we provided several approaches to addressing this need. In the opinion of the author, -the approach that involves dedicated support to type-level computations is the most promising, because it both simplifies -the macro system and provides support for the most important use cases of whiteboxity. - -### Losing compiler internals - -One of the main goals of this proposal is to stop exposing overcomplicated and brittle compiler internal APIs -in order to make macros more accessible and more robust. - -However, some of the compiler APIs may actually capture useful idioms that we may be able to expose in a principled fashion. -`c.internal.enclosingOwner` immediately comes to mind here. - -More work in collaboration with macro authors is needed to make sure that we don't unnecessarily break existing macros -in the name of elusive conceptual purity. - -### Macro annotations - -Much like the current macro system can get extended to support macro annotations, -the new macro system can get extended to support new-style macro annotations that provide similar functionality. - -``` -import scala.annotation.StaticAnnotation - -class h2db(url: String) extends StaticAnnotation { - inline def apply(defns: Any): Any = meta { - ... - } -} - -object Test { - def main(args: Array[String]): Unit = { - @h2db("coffees") object Db - val brazilian = Db.Coffees.insert("Brazilian", 99.0) - Db.Coffees.update(brazilian.copy(price = 100.0)) - println(Db.Coffees.all) - } -} -``` - -In the current macro system, a macro annotation is a subclass of `StaticAnnotation` that define -a macro def called `macroTransform`. - -Analogously, in the new design, a macro annotation is a subclass of `StaticAnnotation` -that defines an inline def called `apply`. We decided to change the magic name, because the old one no longer applies. -We also simplified the signature to take a block wrapping the definitions being expanded and returns a block wrapping expansion results, -i.e. `Any => Any`, as opposed to having `Any* => Any` in the current system. - -Expansion of new-style macro annotations is very similar to expansion of vanilla macro annotations. -The only difference is that we only provide syntactic APIs, informed about [the limitations][AnnotationsTypecheck] -brought by exposing semantic APIs in macros that generate top-level definitions. -Concretely, meta scopes in macro annotations expose a `Dialect` capability instead of a `Mirror`. -As a result, we can afford to expand on enter without any limitations to the shape of expansion. - -### Why inline - -The main motivation behind inline is to provide a templating system that can express simple use cases -of compile-time metaprogramming in an lightweight declarative style that minimizes explicit introspection. - -For example, in one of the code snippets that illustrates inline defs and inline parameters, we can use the newly -introduced mechanism to express partial evaluation. Thanks to constant folding facilities built into the compiler, -usages of the `pow` method provided below will expand into a sequence of multiplications - all that without -a single line of macro code. - -``` -inline def pow(b: Double, inline n: Int): Double = { - if (n == 0) 1 - else b * pow(b, n - 1) -} -``` - -### Out of scope - -This proposal addresses a lot of pain points of the current macro system, but it doesn't talk about two very common -problems: lack of hygiene and presence of the separate compilation restriction. - -These two problems have a lot in common: we have experimented with both of them, our initial results are promising but insufficient, -both of them can be developed independently of inline/meta. - -Given that both hygiene and joint compilation still require significant research to materialize, -we decided not to include them in this proposal. We think that even without these features, inline/meta represents a significant -improvement over the state of the art, so we leave them for future work that may be submitted in follow-up SIPs when it's done. - -## Conclusion - -Pioneered by def macros and macro annotations, -the area of language-integrated compile-time metaprogramming in Scala has shown significant practical value. - -During the last several years, we have been utilizing and maintaining the current macro system in industrial projects. -Learning from this experience, we have created a new design based on `inline` and `meta` that provides -comparable functionality and avoids the most common pitfalls of existing macros. - -The user interface of the new system is a conservative evolution of def macros. -[Inline defs][InlineDefs] work similarly to macro defs, and -[meta expressions][MetaExprs] play the compile-time execution role of macro impls. -These new language features are designed to be used together, -and in this capacity their look and feel can hardly be distinguished from that of def macros. - -The metaprogrammer interface of the new system is a drastic redesign. We have merged macro defs and macro impls, -and, more importantly, we have switched the underlying metaprogramming API from scala.reflect to [scala.meta][ScalaMetaSection]. -This has allowed us to make significant improvements in robustness and tool support. - -The main open question of the new design is [whether whiteboxity will stay or will be removed][Whiteboxity] from the new macro system. -We also need to figure out [which internal compiler APIs we may want to approximate][CompilerInternals] in the new macro system. -Future work outside the scope of this proposal includes -hygiene and lifting the separate compilation restriction. - -At the time of writing, `inline` and `meta` are partially implemented in [a prototype compiler plugin for Scala 2.11][PrototypeScalac] -and [an accompanying experimental branch of IntelliJ][PrototypeIntellij]. -We are excited with our initial results and are planning to develop the new design further. - -## Credits - -This design was created by Eugene Burmako, Denys Shabalin and Martin Odersky -and was further elaborated together with other members of the inline working group at EPFL: -Sébastien Doeraene, Vojin Jovanovic and Dmitry Petrashko. - -Over time, the ideas behind the design were refined based on experiments carried out by: -Uladzimir Abramchuk, Igor Bogomolov, Mathieu Demarne, Martin Duhem, Adrien Ghosn, Zhivka Gucevska, -Mikhail Mutcianko, Dmitry Naydanov, Artem Nikiforov, Vladimir Nikolaev, Jatin Puri and Valentin Rutz. - -The prototype of scalac integration was developed by Eugene Burmako with open-source contributions from -Tamer Mohammed Abdul-Radi, David Dudson, Takeshi D. Itoh, Oleksandr Olgashko and Hiroshi Yamaguchi. - -The prototype of IntelliJ integration was developed by Mikhail Mutcianko. - -## References - - 1. [Prototype of scalac integration][PrototypeScalac] - 1. [Prototype of IntelliJ integration][PrototypeIntellij] - 1. [(Appendix A) Def macros: feature interaction][AppendixInteraction] - 1. [(Appendix B) Def macros: macro expansion][AppendixExpansion] - 1. [(Appendix C) Scala.meta: high-level overview][AppendixMeta] - -[ScalaMetaSection]: #scalameta -[ScalaMetaWebsite]: https://scalameta.org/ -[MacroUsecases]: https://scalamacros.org/paperstalks/2014-02-04-WhatAreMacrosGoodFor.pdf -[PrototypeScalac]: https://github.com/scalameta/paradise -[PrototypeIntellij]: https://www.youtube.com/watch?v=IPnd_SZJ1nM&feature=youtu.be&t=1360 -[Intuition]: #intuition -[LanguageFeatures]: #language-features -[InlineDefs]: #inline-definitions -[InlineExpansion]: #inline-reduction -[MetaExprs]: #meta-expressions -[MetaExpansion]: #meta-expansion -[MetaApis]: #meta-apis -[Whiteboxity]: #losing-whiteboxity -[CompilerInternals]: #losing-compiler-internals -[Hygiene]: #hygiene -[SeparateCompilation]: #separate-compilation-restriction -[Linq]: https://dl.acm.org/citation.cfm?id=1142552 -[Materialization]: https://docs.scala-lang.org/overviews/macros/implicits.html -[SbtMacroSupport]: https://github.com/sbt/sbt/issues/1729 -[AnonymousTypeProviders]: https://docs.scala-lang.org/overviews/macros/typeproviders.html#anonymous-type-providers -[ExtractorMacros]: https://docs.scala-lang.org/overviews/macros/extractors.html -[AnnotationsTypecheck]: https://github.com/scalamacros/paradise/issues/75 -[AppendixInteraction]: https://gist.github.com/xeno-by/e26a904051a171e4bc8b9096630220a7 -[AppendixExpansion]: https://gist.github.com/xeno-by/5dde62aedcc23afc85ecf4d795ac67c2 -[AppendixMeta]: https://gist.github.com/xeno-by/9741ce7532cb30368b3753521bbfce4e diff --git a/_sips/sips/2017-01-11-refer-other-arguments-in-args.md b/_sips/sips/2017-01-11-refer-other-arguments-in-args.md deleted file mode 100644 index 6d5097038a..0000000000 --- a/_sips/sips/2017-01-11-refer-other-arguments-in-args.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -layout: sip -title: SIP-32 - Allow referring to other arguments in default parameters -vote-status: pending -permalink: /sips/:title.html -redirect_from: /sips/pending/refer-other-arguments-in-args.html ---- - -**By: Pathikrit Bhowmick** - -## History - -| Date | Version | -|---------------|------------------| -| Jan 11th 2017 | Initial Draft | -| Jan 12th 2017 | Initial Feedback | -| Jan 16th 2017 | Minor Changes | - -## Introduction -Currently there is no way to refer to other arguments in the default parameters list: - -Does not compile: -```scala -def substring(s: String, start: Int = 0, end: Int = s.length): String -``` - -The workaround to achieve this is by using a curried-function: -```scala -def substring(s: String, start: Int = 0)(end: Int = s.length): String -``` - -However, the above workaround is not always suitable in all situations since you may not want a curried function. - -The other more verbose alternative is by overloading: -```scala -def substring(s: String, start: Int): String - = substring(s, start = 0, end = s.length) -def substring(s: String, start: Int = 0, end: Int): String -``` - -The above is quite verbose as it required 1 extra function definition per argument that refers other args. - -### Proposal -Allow to refer to ***any*** parameters in the same (or left) curried parameter list: -```scala -def substring(s: String, start: Int = 0, end: Int = s.length) // Legal -def substring(start: Int = 0, end: Int = s.length, s: String) // Legal !!! -def substring(s: String, start: Int = 0)(end: Int = s.length) // Legal (works currently) -def substring(start: Int = 0, end: Int = s.length)(s: String) // Illegal -``` - -The same applies for class arguments: -```scala -class Substring(s: String, start: Int = 0, end: Int = s.length) // Legal -class Substring(start: Int = 0, end: Int = s.length, s: String) // Legal -class Substring(s: String, start: Int = 0)(end: Int = s.length) // Legal -class Substring(start: Int = 0, end: Int = s.length)(s: String) // Illegal -``` - -We should also be able to refer to ***multiple*** parameters: -```scala -def binarySearch(start: Int, end: Int, middle: Int = (start + end)/2) // Legal -``` - -# Motivating examples: - -TBD - -## Interactions with other syntax - -#### Partially Applied Functions: -Works as expected: -```scala -def substring(s: String, start: Int = 0, end: Int = s.length) - -substring(_, start = 0, end = 5) // Legal -substring(_, end = 5) // Legal (start = 0) -substring(_, start = 5) // Legal (same as s => substring(s, start = 5, end = s.length) -``` - -#### Multiple Implicit Parameters -[Multiple implicit parameters](https://github.com/scala/docs.scala-lang/pull/520) should also be allowed to refer to one another (left to right): -```scala -def codec[A](data: A)(implicit encoder: Encoder[A])(implicit decoder: Decoder[A] = encoder.reverse) // Legal -``` - -#### Referring to type members: -The default parameters should be able to refer to type members of other arguments e.g.: -```scala -trait Codec { - type Input - type Output -} - -def codec(codec: Codec, in: codec.Input, out: codec.Output) // Legal !!! -``` - -### Other languages -The following languages allow referring to previously declared arguments in the function signature: -* [CoffeeScript](https://coffeescript.org/) -* [Kotlin](https://kotlinlang.org) -* [TypeScript](https://www.typescriptlang.org/) - -AFAIK, there are no major languages where referring to parameters declared to the ***right*** is allowed. - -### Discussions -[Scala Lang Forum](https://contributors.scala-lang.org/t/refer-to-previous-argument-in-default-argument-list/215/6) diff --git a/_sips/sips/2017-01-13-binary-compatibility.md b/_sips/sips/2017-01-13-binary-compatibility.md deleted file mode 100644 index 96be472776..0000000000 --- a/_sips/sips/2017-01-13-binary-compatibility.md +++ /dev/null @@ -1,299 +0,0 @@ ---- -layout: sip -title: SIP-34 - Improving binary compatibility with @stableABI -vote-status: dormant -vote-text: When the author of this proposal figures out which features should be binary compatible and has more information on the future implementation, the SIP Committee will start the review period. -permalink: /sips/:title.html -redirect_from: /sips/pending/binary-compatibility.html ---- - -__Dmitry Petrashko__ - -__first submitted 13 January 2017__ - -## Introduction - -Scala is a language which evolves fast and thus made a decision to only promise binary compatibility across minor releases\[[3]\]. -At the same time, there is a demand to develop APIs that live longer than a major release cycle of Scala. -This SIP introduces an annotation `@stableABI` that checks that `what you write is what you get`. - -`@stableABI` is a linter, that does not change binary output, but will fail compilation if Public API of a class uses features -of Scala that are desugared by compiler and may be binary incompatible across major releases. - -As long as declarations in source have not changed, `@stableABI` annotated classes will be compatible across major versions of Scala. -It complements MiMa\[[2]\] in indicating if a class will remain binary compatible across major Scala releases. - -## Term definitions - -* ##### Binary descriptors - -As defined by the JVM spec\[[4]\]: - - > A descriptor is a string representing the type of a field or method. Descriptors are represented in the class file format using modified UTF-8 strings (§4.4.7) - > and thus may be drawn, where not further constrained, from the entire Unicode codespace. - > - > A method descriptor contains zero or more parameter descriptors, representing the types of parameters that the method takes, and a return descriptor, representing the type of the value (if any) that the method returns. - - Binary descriptors are used in the bytecode to indicate what fields and methods are accessed or invoked. - If a method or field has its descriptor changed, previously compiled classes that used different descriptor will fail in - runtime as they no longer link to the changed field. - - In this document we use the term `binary descriptor` to refer to both method and field descriptors used by the JVM. - -* ##### Public API - - Methods and fields marked with `ACC_PUBLIC`\[[5]\] may be accessed from any class and package. - This loosely corresponds to absence of AccessModifier\[[6]\] in Scala source. - Changing a binary descriptor of a method or a field marked with `ACC_PUBLIC` is a binary incompatible change - which may affect all classes in all packages leading to a runtime linkage failure. - - Methods and fields marked with `ACC_PROTECTED`\[[5]\] may be accessed within subclasses. - This loosely corresponds to presence of `protected` AccessModifier\[[6]\] in Scala source. - Changing a binary descriptor of a method or a field marked with `ACC_PROTECTED` is a binary incompatible change - which may affect all subclasses of this class leading to a runtime linkage failure. - - In this document we use the term `Public API` to refer both to methods and fields defined as `ACC_PUBLIC` and `ACC_PROTECTED`. - Changes do binary descriptors of Public API may lead to runtime linkage failures. - -* ##### Binary compatibility - - Two versions of the same class are called binary compatible if there are no changes to the Public API of this class, - meaning that those two classes can be substituted in runtime without linkage errors. - -## Use cases - -1. Publishing a library that would work across major Scala versions, such as 2.12 & 2.13 and Dotty. -2. Defining a class which is supposed to be used from other JVM languages such as Java\Kotlin. -`@stableABI` will ensure both binary compatibility and that there are no unexpected methods - that would show up in members of a class or an interface. -3. Library authors can take advantage of language features introduced in new major versions of Scala - while still serving users on older language versions by defining their Public API as `@stableABI`. - -The important use-case envisioned here by the authors is migration to Dotty. -We envision that there might be code-bases that for some reason don't compile either with Dotty or with Scalac. -This can be either because they rely on union types, only present in Dotty, -or because they need early initializers, which are only supported by Scalac. - -At the same time, by marking either those classes themselves or their parents as `@stableABI`, -the compiled artifacts could be used in both Dotty-compiled and Scalac-compiled projects. - - -## Current Status -In case there's a need to develop an API that will be used by clients compiled using different major versions of Scala, -the current approach is to either develop them in Java or to use best guess to restrict what Scala features should be used. - -There's also a different approach which is used by sbt: instead of publishing a binary `compiler-interface`, sources are published instead that would be locally compiled. - -Examples: - - 1. Zinc\[[8]\] is writing their interfaces in Java because the interface has to be Scala version agnostic, as it is shipped in every sbt release, independently of Scala version that was used to compile zinc or will be used in to compile the project. -sbt additionally compiles on demand the compiler bridge, which implements this Java interface. - - 2. Dotty\[[7]\] currently uses java defined interfaces as public API for IntelliJ in order to ensure binary compatibility. -These interfaces can be replaced by `@stableABI` annotated traits to reach the same goal. - -## Design Guidelines -`@stableABI` is a feature which is supposed to be used by a small subset of the ecosystem to be binary compatible across major versions of Scala. -Thus this is designed as an advanced feature that is used rarely and thus is intentionally verbose. -It's designed to provide strong guarantees, in some cases sacrificing ease of use and to be used in combination with MiMa\[[2]\] - -The limitations enforced by `@stableABI` are designed to be an overapproximation: -instead of permitting a list of features known to be compatible, `@stableABI` enforces a stronger -check which is sufficient to promise binary compatibility. - -This SIP intentionally follows a very conservative approach. -This is because we will be able to allow more features later, but we won't have an opportunity to remove them. - -## Overview ## -In order for a class, trait or an object to succeed compilation with the `@stableABI` annotation it has to be: - - - defined on the top level; - - if a class or an object has a companion annotated with `@stableABI`, than annotation applies to both of them; - - use a subset of Scala that during compilation does not require changes to public API of the class, including - - synthesizing new members, either concrete or abstract; - - changing binary descriptors of existing members, either concrete or abstract; - -`@stableABI` does not change the compilation scheme of a class: - compiling a class previously annotated with the `@stableABI`, will produce the same bytecode with or without `@stableABI` annotation. - -Below are several examples of classes and traits that succeed compilation with `@stableABI` - -{% highlight scala %} -@stableABI -trait AbstractFile { - def name(): String - - def path(): String - - def jfile(): Optional[File] -} - -@stableABI -trait SourceFile extends AbstractFile { - def content(): Array[Char] -} - -@stableABI -trait Diagnostic { - def message(): String - - def level(): Int - - def position(): Optional[SourcePosition] -} - -@stableABI -object Diagnostic { - @static final val ERROR: Int = 2 - @static final val WARNING: Int = 1 - @static final val INFO: Int = 0 -} - -@stableABI -class FeaturesInBodies { - def apiMethod: Int = { - // as body of the method isn't part of the public interface, one can use all features of Scala here. - lazy val result = 0 // while lazy vals are prohibited in the class, they are allowed in the bodies of methods - result - } -} -{% endhighlight %} - -## Features that will fail compilation with `@stableABI` -The features listed below have complex encodings that may change in future versions. We prefer not to compromise on them. -Most of those features can be simulated in a binary compatible way by writing a verbose re-implementation -which won't rely on desugaring performed inside compiler. -Note that while those features are prohibited in the public API, they can be safely used inside bodies of the methods. - - - public fields. Can be simulated by explicitly defining public getters and setters that access a private field; - - lazy vals. Can be simulated by explicitly writing an implementation in source; - - case classes. Can be simulated by explicitly defining getters and other members synthesized for a case class(`copy`, `productArity`, `apply`, `unapply`, etc). - -The features listed below cannot be easily re-implemented in a class or trait annotated with `@stableABI`. - - - default arguments; - - default methods. See Addendum; - - constant types(both explicit and inferred); - - inline. - -## Binary compatibility and transitivity ## -Consider a class, that is binary compatible but takes a non-binary compatible argument: - -{% highlight scala %} -@stableABI -class Example { - def foo[T](a: MyOption[T]): T = a.get -} - -trait MyOption[T]{ - lazy val get: T = ??? -} -{% endhighlight %} - - -Consider a situation when we re-compile `MyOption` using a different major compiler version than the one used to compile `Example`. -Let's assume the new major version of compile has changing binary descriptor of method `get`. - -While the code in runtime would still successfully invoke the method `Example.foo`, this method will fail in execution, -as it will itself call a `MyOption.get` using an outdated descriptor. - -While in perfect world it would be nice to require all `@stableABI` classes and traits to only take `@stableABI` arguments -and only return `@stableABI` values, we believe that all-or-nothing system will be a lot harder to adopt and migrate to. - -Because of this we propose to emmit warnings in those cases: - - - non-`@stableABI` value is returned from a method or field defined inside a `@stableABI` class or trait; - - an invocation to a method not-defined inside a `@stableABI` class is used in - implementation of a method or a field initializer inside a `@stableABI` class or trait. - -Those warnings can be suppressed using an `@unchecked` annotations or made fatal using `+Xfatal-warnings`. - -## The case of the standard library ## -The Standard library defines types commonly used as arguments or return types such as `Option` and `List`, -as well as methods and implicit conversions imported from `scala` and `Predef`. - -As such Standard library is expected to be the biggest source of warnings defined in previous section. - -We propose to consider either making some classes in standard library use `@stableABI` or define new `@stableABI` -super-interfaces for them that should be used in `@stableABI` classes. -This would also allow to consume Scala classes from other JVM languages such as Kotlin and Java. -## `@stableABI` and Scala.js - -Allowing to write API-defining classes in Scala instead of Java will allow them to compile with Scala.js, -which would have benefit of sharing the same source for two ecosystems. - -Scala.js currently is binary compatible as long as original bytecode compiled by Scala JVM is binary compatible. -Providing stronger binary compatibility guarantees for JVM will automatically provide stronger guarantees for Scala.js. - - -## Comparison with MiMa ## -The Migration Manager for Scala (MiMa in short) is a tool for diagnosing binary incompatibilities for Scala libraries. -MiMa allows to compare binary APIs of two already compiled classfiles and reports errors if APIs do not match perfectly. - -MiMa and `@stableABI` complement each other, as `@stableABI` helps to develop APIs that stay compatible -across major versions, while MiMa checks that previously published artifacts indeed have the same API. - -`@stableABI` does not compare the currently compiled class or trait against previous version, -so introduction of new members won't be prohibited. This is a use-case for MiMa. - -MiMa does not indicate how hard, if possible, would it be to maintain compatibility of a class across future versions of Scala. -Multiple features of Scala, most notably lazy vals and traits, have been compiled differently by different Scala versions -making porting existing compiled bytecode across versions very hard. -MiMa will complain retroactively that the new version is incompatible with the old one. -`@stableABI` will instead indicate at compile time that the old version used features whose encoding is prone to change. -This provides early guidance and warning when designing long-living APIs before they are publicly released. - -## Compilation scheme ## -No modification of typer or any existing phase is planned. The current proposed scheme introduces a late phase that runs before the very bytecode emission that checks that: - - - classes, traits and objects annotated as `@stableABI` are on the top level; - - compiler did not introduce new Public API methods or fields inside `@stableABI` classes, traits and objects; - - compiler did not change descriptors of existing Public API methods or fields inside `@stableABI` classes, traits and objects. - -This phase additionally warns if Public API method or field takes an argument or returns a value that isn't marked as `@stableABI`. -This warning can be suppressed by annotating with `@unchecked`. - -The current prototype is implemented for Dotty and supports everything described in this SIP, except warnings. -The implementation is simple with less than 50 lines of non-boilerplate code. -The current implementation has a scope for improvement of error messages that will report domain specific details for disallowed features, -but it already prohibits them. - -## Addendum: Default methods ## -By `default methods` we mean non-abstract methods defined and implemented by a trait. - -The way how those methods are implemented by compiler has changed substantially over years. -At the same time, `invokeinterface` has always been a reliable way to invoke such a method, -independently from how it was implemented under the hood. - -One might reason that, as there has been a reliable way to call methods on the binary level, -it should be allowed to use them in binary compatible APIs. - -At the same time, the mixin composition protocol that is followed when a class inherits those traits has also -changed substantially. -The classes which have been correctly inheriting those traits compiled by previous versions of Scala -may need recompilation if trait has been recompiled with a new major version of Scala. - -Thus, the authors of this SIP has decided not to allow default methods in the -`@stableABI` traits. - -## See Also ## - - 1. [dotty#1900][1] - 2. [MiMa][2] - 3. [releases-compatibility][3] - 4. [Descriptor definition in JVM Specification][4] - 5. [JVM access flags][5] - 6. [Scala AccessModifiers][6] - 7. [Dotty interfaces][7] - 8. [Zinc interfaces][8] - - -[1]: https://github.com/lampepfl/dotty/pull/1900 "an implementation for Dotty" -[2]: https://github.com/typesafehub/migration-manager "MiMa" -[3]: https://docs.scala-lang.org/overviews/core/binary-compatibility-of-scala-releases.html "Binary compatibility of Scala releases" -[4]: https://docs.oracle.com/javase/specs/jvms/se8/html/jvms-4.html#jvms-4.3 "Descriptor definition in JVM Specification" -[5]: https://docs.oracle.com/javase/specs/jvms/se8/html/jvms-4.html#jvms-4.6-200-A.1 "JVM access flags" -[6]: https://www.scala-lang.org/files/archive/spec/2.11/05-classes-and-objects.html#modifiers "Scala AccessModifiers" -[7]: https://github.com/lampepfl/dotty/tree/master/interfaces/src/dotty/tools/dotc/interfaces "Dotty interfaces" -[8]: https://github.com/sbt/zinc/tree/v1.0.0/internal/compiler-interface/src/main/java/xsbti "zinc interfaces" - diff --git a/_sips/sips/2017-02-22-comonadic-comprehensions.md b/_sips/sips/2017-02-22-comonadic-comprehensions.md deleted file mode 100644 index 3e29121f79..0000000000 --- a/_sips/sips/2017-02-22-comonadic-comprehensions.md +++ /dev/null @@ -1,223 +0,0 @@ ---- -layout: sip -title: SIP-NN - comonadic-comprehensions -vote-status: rejected -permalink: /sips/:title.html -redirect_from: /sips/pending/comonadic-comprehensions.html ---- - -**By: Shimi Bandiel** - -## History - -| Date | Version | -|---------------|---------------| -| Feb 22nd 2017 | Initial Draft | - -## Motivation - -Scala provides a concise syntax for working with Monads(map & flatMap): -the for comprehension. - -Following is a proposal for a concise syntax for working with Comonads(map, extract & coflatMap): -the cofor comprehension. - -The proposal has an existing implementation in PR 5725 - -## Motivating Examples - -### Examples - -Consider the following class: - -{% highlight scala %} - -case class StreamZipper[A](left: Stream[A], focus: A, right: Stream[A]) { - def map[B](f: A => B): StreamZipper[B] = - StreamZipper(left.map(f), f(focus), right.map(f)) - def extract: A = - focus - def coflatMap(f: StreamZipper[A] => B): StreamZipper[B] = - ??? -} - -{% endhighlight %} - -StreamZipper[A] represents a non-empty Stream of As with a cursor (focus). - -
        -
      • The map method invokes f on every element and produces a StreamZipper of -the results.
        • -
      • The extract method returns the value at the cursor
        • -
      • The coflatMap method invokes f on every cursor (all possible zippers) providing a contextual global operation. -The result is a StreamZipper[B] of the results with a cursor pointing at the same location as this. -
        • -
      - -The above implementation for `coflatMap` was left out for brevity. See [3]. - -Now, consider the following methods: -{% highlight scala %} - - // returns whether the current cursor in a zipper of ints is between the previous - // and the next numbers. - def isInTheMiddle(z : StreamZipper[Int]): Boolean = - z match { - case StreamZipper(pi +: _, i, ni +: _) if (pi < i && i < ni) => true - case _ => false - } - - // counts how many consecutive values of true starting from the cursor - def numberOfTrues(z: StreamZipper[Boolean]) : Int = - if (z.focus) 1 + z.right.takeWhile(true ==).size else 0 - -{% endhighlight %} - -And, let's say we have a StreamZipper[Person]: -{% highlight scala %} - case class Person(name: String, age: Int) - - // a given stream with cursor at some position - val people: StreamZipper[Person] = ??? -{% endhighlight %} - -We would like to get the following: -{% highlight scala %} - - /* - * A StreamZipper of triplets containing: - * _1 -- the original Person value. - * _2 -- whether this Person's age is higher than the previous and lower than the next. - * We'll call this boolean TAG. - * _3 -- how many consecutive TAGs with value "true" starting from current cursor. - */ - val goal: StreamZipper[(Person, Boolean, Int)] = ??? - -{% endhighlight %} - -It seems we can re-use the isInTheMiddle and numberOfTrues methods. -However, without the proposed cofor syntax we'll probably end with: -{% highlight scala %} - val goal = people.map(p => (p, p.age)).coflatMap { zipperOfTuple => - val ages = zipperOfTuple.map(_._2) - (zipperOfTuple.extract._1, isInTheMiddle(ages)) - }.coflatMap { zipperOfTuple => - val tags = zipperOfTuple.map(_._2) - val persons = zipperOfTuple.map(_._1) - val trues = numberOfTrues(tags) - persons.extract, tags.extract, trues) - } -{% endhighlight %} -From the code above, you can see that it is quite cumbersome to handle the passing of -the context between the invocations of coflatMap. - -The proposed syntax allows for the following usage: -{% highlight scala %} - val flow : StreamZipper[Person] => (Person, Boolean, Int) = - cofor (p @ Person(_, age)) { - tag <- isInTheMiddle(age) - count <- numberOfTrues(tag) - } yield (p.extract, tag.extract, count.extract) - - val goal = people.coflatMap(flow) -{% endhighlight %} - - -## Syntax - -The proposed syntax is based on the paper by Dominic Orchard and Alan Mycroft [1]. - -The syntax for `cofor` is defined as: -{% highlight scala %} - cofor (pattern0) { - pattern1 <- generator1 - pattern2 <- generator2 - ... - } yield body - - patternN = regular case patterns - generatorN = expr - body = expr - -{% endhighlight %} - -The result type of a `cofor` expression is a function from the comonad type to -a result (`T[A] => B`). -This means that the return type must be available at call-site! -Note that unlike `for`, guards and assignments are not supported. - -## Desugaring - -A `cofor` desugaring is much more complex than the respective `for`. - -Desugaring example: - -{% highlight scala %} - val flow : StreamZipper[Person] => (Person, Boolean, Int) = - cofor (p @ Person(_, age)) { - tag <- isInTheMiddle(age) - count <- numberOfTrues(tag) - } yield (p.extract, tag.extract, count.extract) - - val goal = people.coflatMap(flow) -{% endhighlight %} - -The above `cofor` expression will be desugared into the following function: -{% highlight scala %} - input => { - // desugaring the generators - val enums = - // assign values to input variables - // actual assignment is done through pattern matching - input.map(p => ( - p match { - case p @ Person(_, age) => p - } - , (p match { - case p @ Person(_, age) => age - }, ()))). - coflatMap(env => { - // extracting collected values from the context - val p = env.map(env => env._1) - val age = env.map(env => env._2._1) - // now we pass the current context and the generator result - (isInTheMiddle(age), env.extract) - }).coflatMap(env => { - // extracting collected values from the context - val tag = env.map(env => env._1) - val p = env.map(env => env._2._1) - val age = env.map(env => env._2._2._1) - // now we pass the current context and the generator result - (numberOfTrues(tag), env.extract) - }) - // the body phase (yield) - { - // deconstructing the collected context - val count = enums.map(env => env._1) - val tag = enums.map(env => env._2._1) - val p = enums.map(env => env._2._2._1) - val age = enums.map(env => env._2._2._2._1) - (p.extract, tag.extract, count.extract) - } - } -{% endhighlight %} - -## Drawbacks - -
        -
      1. Adding a new keyword to the language makes it more complex
        2. -
      2. Understanding the desugaring and concept behind cofor is not -trivial and it's much more complex than for (which many developers still -don't feel at ease with).
        3. -
      - - -## References - -1. [A Notation for Comonads][1] -2. [Implementation Pull-Request][2] -3. [StreamZipper Example][3] - -[1]: https://www.cs.kent.ac.uk/people/staff/dao7/publ/codo-notation-orchard-ifl12.pdf "codo-notation" -[2]: https://github.com/scala/scala/pull/5725 -[3]: https://github.com/shimib/scala/blob/5e257cd4b371769deafba2be1ae3932d772ca67d/test/files/neg/cofor.scala diff --git a/_sips/sips/2017-10-25-adding-prefix-types.md b/_sips/sips/2017-10-25-adding-prefix-types.md deleted file mode 100644 index 9ef94f2427..0000000000 --- a/_sips/sips/2017-10-25-adding-prefix-types.md +++ /dev/null @@ -1,194 +0,0 @@ ---- -layout: sip -title: SIP-36 - Adding prefix types -vote-status: pending -permalink: /sips/:title.html -redirect_from: /sips/pending/adding-prefix-types.html ---- - -**By: Oron Port** - -## History - -| Date | Version | -| ------------- | ---------------------------------------- | -| Oct 25th 2017 | Split prefix types from [SIP33](https://docs.scala-lang.org/sips/priority-based-infix-type-precedence.html), and emphasize motivation | -| Nov 29th 2017 | Updated SIP according to feedback in the PR, and recent update to SIP23 | -| Dec 1st 2017 | Added another use-case for prefix type `~` | - -Your feedback is welcome! If you're interested in discussing this proposal, head over to [this](https://contributors.scala-lang.org/t/sip-nn-make-infix-type-alias-precedence-like-expression-operator-precedence/471) Scala Contributors thread and let me know what you think. - ---- - -## Introduction -Currently scala supports unary prefix operators (`-`, `+`, `~`, `!`) for expressions (e.g., `def unary_-`) and does not support prefix types. See the Scala specification [Prefix Operations](https://scala-lang.org/files/archive/spec/2.12/06-expressions.html#prefix-operations) section. - -**Prefix expression vs. prefix type example**: - -```scala -object PrefixExpression { - case class Nummy(expand : String) { - def unary_- : Nummy = Nummy(s"-$this") - def unary_~ : Nummy = Nummy(s"~$this") - def unary_! : Nummy = Nummy(s"!$this") - def unary_+ : Nummy = Nummy(s"+$this") - } - object N extends Nummy("N") - val n1 = -N - val n2 = ~N - val n3 = !N - val n4 = +N -} -object NonExistingPrefixTypes { - trait unary_-[A] - trait unary_~[A] - trait unary_![A] - trait unary_+[A] - trait N - type N1 = -N //Not working - type N2 = ~N //Not working - type N3 = !N //Not working - type N4 = +N //Not working -} -``` - ---- - -## Motivation -It is easier to reason about the language when mathematical and logical operations for both terms and types are expressed the same. The proposal is relevant solely for projects which utilize numeric literal type operations (supported by SIP23, which was not yet accepted into Lightbend Scala). However, the SIP's implementation is very small and should have minor effect on compiler performance. - -### Motivating examples - -#### Splice prefix types for meta-programming -A requirement for `unary_~` is described by Martin Odersky at [this proposal](https://gist.github.com/odersky/f91362f6d9c58cc1db53f3f443311140). - -#### Singleton-ops library example - -The [singleton-ops library](https://github.com/fthomas/singleton-ops) with [Typelevel Scala](https://github.com/typelevel/scala) (which implemented [SIP-23](https://docs.scala-lang.org/sips/pending/42.type.html)) enable developers to express literal type operations more intuitively. - -Consider the following example, where `foo` has two equivalent implementations, one using types, while the other uses terms: - -```scala -import singleton.ops._ - -object PrefixExample { - /* - We would much rather write the following to acheive more clarity and shorter code: - type Foo[Cond1, Cond2, Num] = ITE[Cond1 && !Cond2, -Num, Num] - */ - type Foo[Cond1, Cond2, Num] = ITE[Cond1 && ![Cond2], Negate[Num], Num] - //foo executes typelevel operations by using singleton-ops - def foo[Cond1, Cond2, Num](implicit f : Foo[Cond1, Cond2, Num]) : f.Out = f.value - //foo executes term operations - def foo(cond1 : Boolean, cond2 : Boolean, num : Int) : Int = - if (cond1 && !cond2) -num else num -} - -import PrefixExample._ - -foo[true, false, 3] //returns -3 -foo(true, false, 3) //returns -3 -``` - -Note: `type ![A]` is possible to define, but `type -[A]` is not due to collision with infix type parsing. - -#### DFiant library example - -DFiant is a domain specific language for hardware description I (Oron) am developing. Hardware interfaces have a direction annotation (e.g., `vec : DFBits[8] <> IN`). Sometime interfaces have multiple ports, in different directions. E.g.: - -```scala -trait MyInterface { - val data : DFBits[32] <> IN - val address : DFBits[32] <> OUT -} -``` - -To be able to use the same interface in reverse, we need the ability to easily express it as: - -```scala -trait MyReversableInterface[D <: Direction] { - val data : DFBits[32] <> D - val address : DFBits[32] <> ~D -} -``` - -An implicit conversion can then assure that `~IN` is translated to `OUT` and vice-versa. - -Interfaces may possess dozens of ports, thus without prefix types can be quite cumbersome. - ---- - -## Proposal - -Add support for prefix types, which is equivalent to the prefix operations for expressions. - -``` -PrefixType ::= [`-' | `+' | `~' | `!'] SimpleType -CompoundType ::= PrefixType - | AnnotType {with AnnotType} [Refinement] - | Refinement -``` - ------- - -## Implementation - -A PR for this SIP is available at: [https://github.com/scala/scala/pull/6148](https://github.com/scala/scala/pull/6148) - ------- - -### Interactions with other language features - -#### Variance Annotation -Variance annotation uses the `-` and `+` symbols to annotate contravariant and covariant subtyping, respectively. Introducing unary prefix types may lead to some developer confusion. However, such interaction is very unlikely to occur. E.g.: - -```scala -trait Negate[A] -trait Positive[A] -type unary_-[A] = Negate[A] -type unary_+[A] = Positive[A] -trait Contravariant[B, -A <: +B] //contravariant A subtype upper-bounded by Positive[B] -trait Covariant[B, +A <: -B] //covariant A subtype upper-bounded by Negative[B] -``` - -#### Negative Literal Types -Negative literal types are annotated using the `-` symbol. This can lead to the following confusion: - -```scala -trait Negate[A] -type unary_-[A] = Negate[A] -trait MyTrait[B] - -type MinusFortyTwo = MyTrait[-42] -type NegateFortyTwo = MyTrait[Negate[42]] -``` - -The above example demonstrates a case of two types `MinusFortyTwo` and `NegateFortyTwo` which are different. They may be equivalent in view (implicit conversion between the two type instances), but they are not equal. - -Note: It is not possible to annotate a positive literal type in Scala (checked both in TLS and Dotty): - -```scala -val a : 42 = +42 //works -val b : -42 = -42 //works -val c : +42 = 42 //error: ';' expected but integer literal found -``` - -This means that if unary prefix types are added, then `+42` will be a type expansion of `unary_+[42]`. - -**Related Issues** -* [Dotty Issue #2783](https://github.com/lampepfl/dotty/issues/2783) -* [Typelevel Scala Issue #157](https://github.com/typelevel/scala/issues/157) (Resolved in recent update to SIP23) - -Dotty's implementation of literal types currently fail compilation when infix types interact with a negative literal type. -```scala -type ~~[A, B] -type good = 2 ~~ 2 -type bad = 2 ~~ -2 //Error:(9, 20) ';' expected but integer literal found. -type work_around = 2 ~~ (-2) //Error in Dotty -``` ----- - -### Bibliography -[Scala Contributors](https://contributors.scala-lang.org/t/sip-nn-make-infix-type-alias-precedence-like-expression-operator-precedence/471) - -[scala-sips](https://groups.google.com/forum/#!topic/scala-sips/ARVf1RLDw9U) diff --git a/_sips/sips/2018-05-26-case-if.md b/_sips/sips/2018-05-26-case-if.md deleted file mode 100644 index 7e4952f262..0000000000 --- a/_sips/sips/2018-05-26-case-if.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -layout: sip -title: SIP-NN - Uncluttering Abuse of Match -vote-status: pending -permalink: /sips/:title.html -redirect_from: /sips/pending/case-if.html ---- - -**By: Som Snytt and A. P. Marki** - -## History - -| Date | Version | -|---------------|----------------| -| May 26th 2018 | Initial Draft | -| May 28th 2018 | Underscoreless | - -## Motivation - -Since the demise of SIP-12, we have relied on Marie Kondo to declutter -what remains of our lives. But we can do better. - -Currently, `case` syntax requires an underscore to represent a pattern, -even if the code of interest is the guard that follows. - -Anxiety over this underscore is expressed in [a StackOverflow question][1] -in which a programmer mulls the question of "Abuse of Match" and whether -it actually makes you go blind. - -We propose to go underscoreless, pace the famous consultancy. - -If we can't have SIP-12 then we can have tidy syntax for `if-then` in `case` blocks. - -Since `Scala <3` abhors two ways of doing a thing, we eliminate underscore -as a pattern. Underscore as a subpattern, that is, as a `pattern2`, is patterned -after placeholder syntax in expressions, just as constructor patterns are patterned -after constructor invocations. We read `C(_)` and `case C(_) =>` to mean construction -of `C` with an argument unspecified. Similarly, just as placeholder syntax is -restricted, so that an underscore is never an `Expr`, pattern syntax must disallow -underscore as a `Pattern` production. - -In fact, underscore never quite functioned that way, since the definition - - val _ = 42 - -has always incorrectly introduced a variable named `_`. - -Suggestions have surfaced that this syntax should mean something entirely different, -namely, the introduction of a freshly named variable which cannot be named in -source code, but induces the evaluation of the RHS of the definition, and which -can be accessed implicitly if defined as an implicit value. - -However that may be, underscore must first be disallowed as a `Pattern`. - -The only way to coherently define a `case` for which no pattern is applied is to omit -the pattern. And in the absence of alternative semantics, `val _` is not meaningful. -Underscore on the RHS of `var` definitions has already been deprecated, and it is -expected that that syntax will also be removed. - -## Syntax - -In lieu of - - 42 match { - case _ if now isAfter midnight => nothingGoodHappens() - case _ => () - } - -we write - - 42 match { - case if now isAfter midnight => nothingGoodHappens() - case => () - } - -The syntax accepts either a pattern with optional guard, or a guard with no pattern: - - CaseClause ::= ‘case’ (Pattern [Guard] | Guard) ‘=>’ Block - Guard ::= ‘if’ PostfixExpr - -## Further Justifications - -In a respected online [forum][2] which brooks no fools, [Mulliganaceous][3] has posted -an "accepted" answer using the idiom, "in case if". This supports `case if` as -a natural locution. - -In a response to one judgment about abuse of match, [one Scala user][4] whose handle I can -never spell quite right let alone pronounce finds the match version -"clearer and visually more pleasant" than the cluttered `if` expression. - -From the beginning, Scala has made great strides in reducing vertical space in source code. -However, we are still constrained horizontally, despite curved OLED screens. -Recently, [a suggested edit][5] was declined because of maximum line length restrictions. -Every wasted character brings us closer to an unfortunate line break. - -## Implementation - -An implementation is [available][6]. It's pretty slick. - -## References - -1. [Abuse of Match?][1] -2. [Reputation requirements for creating tags and tag synonyms][2] -3. [Mulliganaceous user profile][3] -4. [huynhjl user profile][4] -5. [Sample line length limitation in a Scala project][5] -6. [Implementation][6] - -[1]: https://stackoverflow.com/questions/12556236/abuse-of-match "Abuse of Match?" -[2]: https://meta.stackoverflow.com/a/368537/1296806 "Reputation requirements for creating tags and tag synonyms" -[3]: https://meta.stackoverflow.com/users/8242447/mulliganaceous "Mulliganaceous" -[4]: https://stackoverflow.com/users/257449/huynhjl "huynhjl" -[5]: https://github.com/apache/spark/pull/21369/files#r189794046 "scala-style enforces a max of 100 chars per line" -[6]: https://github.com/scala/scala/pull/6241 "Implementation PR 6241" - diff --git a/_sips/sips/2019-07-27-binary-integer-literals.md b/_sips/sips/2019-07-27-binary-integer-literals.md deleted file mode 100644 index da803bd5ae..0000000000 --- a/_sips/sips/2019-07-27-binary-integer-literals.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -layout: sip -title: SIP-NN - Support Binary Integer Literals -vote-status: pending -permalink: /sips/:title.html ---- - -**By: NthPortal** - -## History - -| Date | Version | -|---------------|--------------------------| -| Jul 27th 2019 | Initial Draft | - -Your feedback is welcome! If you're interested in discussing this proposal, head over to [this](https://contributors.scala-lang.org/t/pre-sip-binary-literals/3559) Scala Contributors thread and let me know what you think. - -## Proposal - -Support binary integer literals. For example, the binary literal `0b00101010` would have the integer value `42`. - -## Motivation - -Several other major languages support binary integer literals, including [Java](https://docs.oracle.com/javase/specs/jls/se12/html/jls-3.html#jls-3.10.1) (as of [Java 7](https://docs.oracle.com/javase/specs/jls/se7/html/jls-3.html#jls-3.10.1)), [Kotlin](https://kotlinlang.org/docs/reference/basic-types.html#literal-constants), [Python](https://docs.python.org/3/reference/lexical_analysis.html#integer-literals) and [Rust](https://doc.rust-lang.org/stable/reference/tokens.html#number-literals). - -## Interactions with Other Language Features - -Like other integer literals, binary integer literals support separators (`_`), which can greatly enhance the readability of larger values (e.g. `0b_1110_1101_1011_0111`). - -## Implementation - -The implementation of binary integer literals is quite simple, and can be found at . diff --git a/_sips/sips/2019-08-11-curried-varargs.md b/_sips/sips/2019-08-11-curried-varargs.md deleted file mode 100644 index 8fbe8f094d..0000000000 --- a/_sips/sips/2019-08-11-curried-varargs.md +++ /dev/null @@ -1,271 +0,0 @@ ---- -layout: sip -title: SIP-NN - Curried varargs -vote-status: pending -permalink: /sips/:title.html -redirect_from: /sips/pending/curried-varargs.html ---- - -**By: Yang, Bo** - -## History - -| Date | Version | -|---------------|---------------| -| Aug 11th 2019 | Initial Draft | -| Aug 12th 2019 | Translating sequence arguments to `applyNextSeq` calls | - -## Introduction - -The [repeated parameters](https://scala-lang.org/files/archive/spec/2.13/04-basic-declarations-and-definitions.html#repeated-parameters) syntax is widely used in Scala libraries to create collection initializers, string interpolations, and DSLs. Unfortunately, repeated parameters are type unsafe as it erase all arguments to their common supertype, inefficient as it creates a temporary `Seq` that is difficult to be eliminated by optimizer. In practice, all sophisticated string interpolation libraries, including [string formatting](https://github.com/scala/scala/blob/43e040ff7e4ba92ccf223e77540580b32c1473c0/src/library/scala/StringContext.scala#L94) and [quasiquotes](https://github.com/scala/scala/blob/43e040ff7e4ba92ccf223e77540580b32c1473c0/src/reflect/scala/reflect/api/Quasiquotes.scala#L28) in standard library, [scalameta](https://scalameta.org/docs/trees/quasiquotes.html) and my [fastring](https://github.com/Atry/fastring/blob/67ae4eccdb9b7f58416ed90eae85ddb035b1ffb1/shared/src/main/scala/com/dongxiguo/fastring/Fastring.scala#L242) library, are written in macros in order to avoid runtime overhead of repeated parameters. - -We propose **curried varargs** to improve both the type safety and the performance. Given a function call `f(a, b, c)`, when `f` is a subtype of `Curried`, the function call should be rewritten to `f.applyBegin.applyNext(a).applyNext(b).applyNext(c).applyEnd`. - -## Motivating Examples - -### Examples - -Recently I was working on the implementation of [Pre SIP: name based XML literals](https://contributors.scala-lang.org/t/pre-sip-name-based-xml-literals/2175). During implementing that proposal, I found that the proposal is inefficiency due to repeated parameters, and it could be improved dramatically with the help of curried functions. - -For example, according to the proposal the XML literal `
      line1
      line2
      ` will result the following code: - -``` scala -xml.tags.div( - xml.attributes.title(xml.text("my-title")), - xml.text("line1"), - xml.tags.br(), - xml.text("line2") -) -``` - -With the help of this curried varargs proposal and `@inline`, we are able to implement an API to build a DOM tree with no additional overhead over manually written Scala code. - -``` scala -import org.scalajs.dom.document -import org.scalajs.dom.raw._ - -object xml { - type Attribute[-A <: Element] = A => Unit - @inline def text(data: String) = data - object attributes { - @inline def title(value: String): Attribute[Element] = _.setAttribute("title", value) - } - object tags { - class Builder[+E <: Element](private val element: E) extends AnyVal with Curried { - @inline def applyBegin = this - @inline def applyNext(text: String) = { - element.appendChild(document.createTextNode(text)) - this - } - @inline def applyNext(node: Node) = { - element.appendChild(node) - this - } - @inline def applyNext[A <: Attribute[E]](attribute: A) = { - attribute(element) - this - } - @inline def applyEnd = element - } - @inline def div = new Builder(document.createElement("div")) - @inline def br = new Builder(document.createElement("br")) - } -} -``` - -Since `xml.tags.div` returns a `Builder`, which is a subtype of `Curried`, calls on `xml.tags.div` will be translated to the curried form, as shown below: -``` scala -xml.tags.div - .applyBegin - .applyNext(xml.attributes.title(xml.text("my-title"))) - .applyNext(xml.text("line1")) - .applyNext(xml.tags.br.applyBegin.applyEnd) - .applyNext(xml.text("line2")) - .applyEnd -``` - -When the above code is compiled in Scala.js, the builders should be eliminated entirely as a zero cost abstraction layer, and the output JavaScript is tiny as shown below: - -``` javascript -var $$this = $m_Lorg_scalajs_dom_package$().document__Lorg_scalajs_dom_raw_HTMLDocument().createElement("div"); -$$this.setAttribute("title", "my-title"); -$$this.appendChild($m_Lorg_scalajs_dom_package$().document__Lorg_scalajs_dom_raw_HTMLDocument().createTextNode("line1")); -var $$this$1 = $m_Lorg_scalajs_dom_package$().document__Lorg_scalajs_dom_raw_HTMLDocument().createElement("br"); -$$this.appendChild($$this$1); -$$this.appendChild($m_Lorg_scalajs_dom_package$().document__Lorg_scalajs_dom_raw_HTMLDocument().createTextNode("line2")); -``` - -### Comparison Examples - -The `Builder` API can be also implemented in repeated parameters: - -``` scala -import org.scalajs.dom.document -import org.scalajs.dom.raw._ - -object xml { - type Attribute[-A <: Element] = A => Unit - @inline def text(data: String) = data - object attributes { - @inline def title(value: String): Attribute[Element] = _.setAttribute("title", value) - } - object tags { - class Builder[+E <: Element](private val element: E) extends AnyVal { - @inline def apply(attributesAndChildren: Any*) = { - attributesAndChildren.foreach { - case text: String => - element.appendChild(document.createTextNode(text)) - case node: Node => - element.appendChild(node) - case attribute: Attribute[E] => - attribute(element) - } - element - } - } - @inline def div = new Builder(document.createElement("div")) - @inline def br = new Builder(document.createElement("br")) - } -} -``` - -However, the Scala compiler is unable to optimize repeated parameters, as a result, the output JavaScript from Scala.js would look like the below code. - -``` javascript -var $$this$1 = $m_Lorg_scalajs_dom_package$().document__Lorg_scalajs_dom_raw_HTMLDocument().createElement("div"); -var this$3 = $m_LScalaFiddle$xml$attributes$(); -var jsx$1 = new $c_sjsr_AnonFunction1().init___sjs_js_Function1((function($this, value) { - return (function(x$1$2) { - x$1$2.setAttribute("title", value) - }) -})(this$3, "my-title")); -var $$this = $m_Lorg_scalajs_dom_package$().document__Lorg_scalajs_dom_raw_HTMLDocument().createElement("br"); -var array = [jsx$1, "line1", $$this, "line2"]; -var i = 0; -var len = $uI(array.length); -while ((i < len)) { - var index = i; - var arg1 = array[index]; - if ($is_T(arg1)) { - var x2 = $as_T(arg1); - $$this$1.appendChild($m_Lorg_scalajs_dom_package$().document__Lorg_scalajs_dom_raw_HTMLDocument().createTextNode(x2)) - } else if ($uZ((arg1 instanceof $g.Node))) { - $$this$1.appendChild(arg1) - } else if ($is_F1(arg1)) { - var x4 = $as_F1(arg1); - x4.apply__O__O($$this$1) - } else { - throw new $c_s_MatchError().init___O(arg1) - }; - i = ((1 + i) | 0) -}; -``` - -Despite of the type safety issue due to the usage of `Any`, the above code are inefficient: - -1. Unnecessary temporary object for the `xml.attributes.title(xml.text("my-title"))`. -2. Unnecessary temporary `Seq` to hold repeated parameters. -3. Unnecessary runtime type check for each argument. - -The similar issues can be found in many other usage of repeated parameters. For example, Scala string interpolation is inefficient due to its internal vararg function call, unless implementing it in a macro; Scala collection initializers (e.g. `List(1, 2, 3)`) create unnecessary temporary `Seq` before creating the desired collection. - -## Design - -This proposal introduces a new type `Curried` defined as following: - -``` scala -trait Curried extends Any -``` - -When a function call `f(p1, p2, p3, ... pn)` is being type checked, the compiler will firstly look for `apply` method on `f`. If an applicable `apply` method is not found and `f` is a subtype of `Curried`, the compiler will convert the function call to curried form `f.applyBegin.applyNext(p1).applyNext(p2).applyNext(p3) ... .applyNext(pn).applyEnd`, and continue type checking the translated call. - -### Expanding sequence argument - -Optionally, some arguments to a `Curried` call may be a sequence argument marked as `_*`. Those are arguments should be translated to `applyNextSeq` calls instead of `applyNext`. For example, `f(p1, s1: _*, p2)` will be translated to the following code. - -``` scala -f.applyBegin - .applyNext(p1) - .applyNextSeq(s1) - .applyNext(p2) -.applyEnd -``` - -Unlike traditional repeated parameters, which restrict the sequence argument at the last position, sequence arguments in a curried call are allowed at any position. - -### Builder type shifting - -The type of partially applied function might be changed during applying each argument. Given the following type signature: - -``` scala -class ListBuilder[A] { - def applyNext[B >: A](b: B): ListBuilder[B] = ??? - def applyNextSeq[B >: A](seqB: Seq[B]): ListBuilder[B] = ??? - def applyEnd: List[A] = ??? -} -object List extends Curried { - def applyBegin[A]: ListBuilder[A] = ??? -} -``` - -`List(42, "a")` should be translated to `List.applyBegin.applyNext(42).applyNext("a").applyEnd`. Then, the typer will infer type parameters as `List.applyBegin[Nothing].applyNext[Int](42).applyNext[Any]("a").applyEnd`, therefore the final return type of `applyEnd` will be `List[Any]`. - -### Explicit type parameters - -When a `Curried` is invoked with some type arguments, those type arguments will be moved to the `applyBegin` method. Therefore, `List[Int](1 to 3: _*)` should be translated to `List.applyBegin[Int].applyNextSeq(1 to 3).applyEnd`. - -### Implicit parameters - -A more common form of curried function call would be like `f(a)(b)(c)`. We prefer the explicit named method calls to `applyNext` instead of the common form, in order to support implicit parameters in `applyNext`. Therefore, each explicit parameter might come with an implicit parameter list, resolving the infamous [multiple type parameter lists](https://github.com/scala/bug/issues/4719) issue. - -### Multiple curried vararg parameter lists - -When a `Curried` is invoked with multiple parameter lists, for example: -``` scala -f(a, b, c)(d, e) -``` - -Then the first parameter list should be translated to a curried call: - -``` scala -f.applyBegin - .applyNext(a) - .applyNext(b) - .applyNext(c) -.applyEnd(d, e) -``` - -`(d, e)` is translated to the curried form only if `applyEnd` returns a `Curried`. - -### Overloaded curried calls - -Curried varargs enables overloaded functions for each parameter. Parameters will not be erased to their common supertype. - -## Implementation - -This proposal can be implemented either in the Scala compiler or in a whitebox macro. [Curried.scala](https://github.com/Atry/Curried.scala) is an implementation of the proposal in a whitebox macro. - -## Alternatives - -### Repeated parameters - -Repeated parameters are packed into a `Seq`, which is then passed to the callee. - -#### Pros - -* Interoperable with Java - -#### Cons - -* Always boxing value class parameters -* Unable to inline function parameters -* Unable to inline call-by-name parameters -* Unable to perform implicit conversion for each parameter -* Unable to infer context bound for each parameter -* Erasing all parameters to their common super type - -## Reference -* [Existing Implementation (Curried.scala)](https://github.com/Atry/Curried.scala) -* [Discussion on Scala Contributors forum](https://contributors.scala-lang.org/t/pre-sip-curried-varargs/3608) -* [Pre SIP: name based XML literals](https://contributors.scala-lang.org/t/pre-sip-name-based-xml-literals/2175) -* [Scala Language Specification - Repeated Parameters](https://scala-lang.org/files/archive/spec/2.13/04-basic-declarations-and-definitions.html#repeated-parameters) diff --git a/_sips/sips/2019-10-24-name-based-xml.md b/_sips/sips/2019-10-24-name-based-xml.md deleted file mode 100644 index 6389003fa9..0000000000 --- a/_sips/sips/2019-10-24-name-based-xml.md +++ /dev/null @@ -1,421 +0,0 @@ ---- -layout: sip -title: SIP-NN - Name Based XML Literals -vote-status: pending -permalink: /sips/:title.html -redirect_from: /sips/pending/name-based-xml.html ---- - -**By: Yang, Bo** - -## History - -| Date | Version | -|---------------|---------------| -| Oct 24th 2019 | Initial Draft | - -## Introduction - -Name-based `for` comprehension has been proven success in Scala language design. A `for` / `yield` expression will be converted to higher-order function calls to `flatMap` , `map` and `withFilter` methods, no matter which type signatures they are. The `for` comprehension can be used for either `Option` or `List` , even when `List` has an additional implicit `CanBuildFrom` parameter. Third-party libraries like Scalaz and Cats also provides `Ops` to allow monadic data types in `for` comprehension. - -[Name-based pattern matching](https://dotty.epfl.ch/docs/reference/changed-features/pattern-matching.html) is introduced by Dotty. It is greatly simplified the implementation compared to Scala 2. In addition, specific symbols in Scala library ( `Option` , `Seq` ) are decoupled from the Scala compiler. - -Considering the success of the above name-based syntactic sugars, in order to decouple `scala-xml` library from Scala compiler, name-based XML literal is an obvious approach. - -## Motivating Examples - -### Examples - -Given an XML literal `
      line1
      line2
      `, at the parser phase, the compiler should internally convert it to an AST equivalent to the following code: - -``` scala -xml.literal( - xml.elements.div( - xml.attributes.title(xml.values.`my-title`), - xml.texts.line1, - xml.elements.br(), - xml.texts.line2 - ) -) -``` - -By creating or importing different implementation of `xml`, various representation of objects for the XML literal will be created. For example, to create HTML DOM in Scala.js, you can define `xml` object as following: - -``` scala -import org.scalajs.dom.document -import org.scalajs.dom.raw._ - -object xml { - type Attribute[-A <: Element] = A => Unit - object values extends Dynamic { - def selectDynamic(data: String) = data - } - object texts extends Dynamic { - def selectDynamic(data: String) = data - } - object attributes { - def title(value: String): Attribute[Element] = _.setAttribute("title", value) - } - object elements { - class Builder[+E <: Element](val element: E) extends AnyVal { - def apply(attributesAndChildren: Any*) = { - attributesAndChildren.foreach { - case text: String => - element.appendChild(document.createTextNode(text)) - case builder: Builder[_] => - element.appendChild(builder.element) - case node: Node => - element.appendChild(node) - case attribute: Attribute[E] => - attribute(element) - } - element - } - } - def div = new Builder(document.createElement("div")) - def br = new Builder(document.createElement("br")) - def literal[+E <: Element](builder: Builder[E]) = builder.element - } -} -``` - -The ability of custom implementation for XML literals enables a lot of possibilities, including React-like virtual DOM frameworks, static type checked XML schema, and reactive XHTML/FXML templating. - -### Comparison Examples - -XML literals in Scala 2.13 are symbol based, which means the type of an XML literal is always `scala.xml.Elem`. The code `
      line1
      line2
      ` will be parsed to an AST equivalent to the following code: - -``` scala -{ - var $md: MetaData = Null; - $md = new UnprefixedAttribute("title", new Text("my-title"), $md); - new Elem(null, "div", $md, TopScope, false, ({ - val $buf = new NodeBuffer(); - $buf.$amp$plus(new Text("line1")); - $buf.$amp$plus({ - { - new Elem(null, "br", Null, TopScope, true) - } - }); - $buf.$amp$plus(new Text("line2")); - $buf - }: _*)) -} -``` - -Note that `MetaData`, `UnprefixedAttribute`, `Text`, `Elem` and `TopScope` are types defined in `scala.xml`. Library authors cannot create their custom representation of XML literals. - -### Counter-Examples - -With the help of this proposal, a library author can create custom XML based DSL. - -``` scala -
      -``` - -It will be translated to: - -``` scala -xml.literal( - xml.elements.div( - xml.elements.label( - xml.attributes.`v-if`(xml.interpolation(math.random() < 0.5)), - xml.texts.`You might see me` - ) - ) -) -``` - -The translated `v-if` method can be supported by creating an `implicit class` for `xml.attributes` easily. However, this proposal is not intended to be used for creating a DSL as an alternative to regular Scala code. Instead, you should just use ordinary `if` expression. - -``` scala -
      { - if (math.random() < 0.5) { - - } else { - - } -}
      -``` - -and it will be translated to: - -``` scala -xml.literal( - xml.elements.div( - xml.interpolation { - if (math.random() < 0.5) { - xml.literal( - xml.elements.label( - xml.texts.`You might see me` - ) - ) - } else { - xml.literal( - xml.comment("condition not met") - ) - } - } - ) -) -``` - -Name based XML literal is best for modeling existing XML format within Scala source files. For other cases, just use ordinary Scala control flows for dynamic conditions, and use ordinary Scala case class for data structures not defined in the existing XML format. - -## Design - -### Goals - -* Keeping source-level backward compatibility to existing symbol-based XML literals in most use cases of `scala-xml`. -* Allowing schema-aware XML literals, i.e. static type varying according to tag names, similar to the current TypeScript and [Binding.scala](https://github.com/ThoughtWorksInc/Binding.scala) behavior. -* Schema-aware XML literals should be understandable by both the compiler and IDE (e.g. no white box macros involved). -* Existing libraries like ScalaTags should be able to support XML literals by adding a few simple wrapper classes. No macro or meta-programming knowledge is required for library authors. -* Able to implement an API to build a DOM tree with no more cost than manually written Scala code. - -### Non-goals - -* Embedding fully-featured standard XML in Scala. -* Allowing arbitrary tag names and attribute names (or avoiding reserved word). -* Distinguishing lexical differences, e.g. `` vs `` . - -### Other consideration -#### White space only text - -Whitespace-only is preserved by default. However, a XML library vendor is able to discard whitespace texts during constructing the object for the XML literal. - -#### The usage of varargs - -Since an element might contain arbitrary number of child nodes, varargs are required to handle these child nodes. Unfortunately, traditional varargs are type unsafe as it erase all arguments to their common super type, inefficient as it creates a temporary `Seq` that is difficult to be eliminated by optimizer. - -Both problems can be resolved with the help of [Curried Varargs](https://docs.scala-lang.org/sips/curried-varargs.html), which is another SIP to address the type safety and performance issues in traditional varargs. - -## Other Examples - -### Self-closing tags without prefixes - -``` scala - -``` - -will be translated to - -``` scala -xml.literal( - xml.elements.`tag-name`() -) -``` - -### Node list - -``` scala - - -``` - -will be translated to - -``` scala -xml.literal( - xml.elements.`tag-name`(), - `prefix-1`.elements.`tag-name`() -) -``` -### Attributes - -``` scala - -``` - -will be translated to - -``` scala -xml.literal( - xml.elements.`tag-name`( - xml.attributes.`attribute-1`(xml.values.value), - xml.attributes.`attribute-2`(xml.interpolation(f())) - ) -) -``` - -### CDATA - -`` will be translated to `xml.literal(xml.texts.raw)` if `-Xxml:coalescing` flag is on, or `xml.literal(xml.cdata("raw"))` if the flag is turned off as `-Xxml:-coalescing` . - -### Process instructions - -``` scala - -``` - -will be translated to - -``` scala -xml.literal( - xml.processInstructions.`xml-stylesheet`("type=\"text/xsl\" href=\"style.xsl\"") -) -``` - -### Child nodes - -``` scala - - text & hexadecimal reference & decimal reference - - - { math.random } - - -``` - -will be translated to - -``` scala -xml.literal( - xml.elements.`tag-name`( - xml.attributes.`attribute-1`(xml.values.value), - xml.texts.`$u000A text `, - xml.entities.amp, - xml.texts.` hexadecimal reference `, - xml.entities.AMP, - xml.texts.` decimal reference$u000A `, - xml.elements.`child-1`(), - xml.texts.`$u000A `, - xml.comment(" my comment "), - xml.texts.`$u000A `, - xml.interpolation(math.random), - xml.texts.`$u000A `, - xml.cdata(" raw "), // or (xml.texts.` raw `), if `-Xxml:coalescing` flag is set - xml.texts.`$u000A ` - ) -) -``` - -Note that hexadecimal references and decimal references will be unescaped and translated to `xml.texts` automatically, while entity references are translated to fields in `xml.entities` . - -### Prefixes without `xmlns` bindings. - -``` scala - - content - - -``` - -will be translated to - -``` scala -xml.literal( - `prefix-1`.elements.`tag-name-1`( - `prefix-1`.attributes.`attribute-1`(`prefix-1`.values.`value-1`), - `prefix-2`.attributes.`attribute-2`(`prefix-2`.values.`value-2`), - `prefix-1`.texts.`$u000A `, - xml.elements.`tag-name-2`( - xml.texts.content - ), - `prefix-1`.texts.`$u000A `, - `prefix-1`.comment(" my comment "), - `prefix-1`.texts.`$u000A` - ) -) -``` - -Note that unprefixed attribute will be treated as if it has the same prefix as its enclosing element. - -### `xmlns` bindings. - -``` scala - - content - - -``` - -will be translated to - -``` scala -xml.literal( - xml.prefixes.`prefix-1`(xml.uris.`http://example.com/1`).elements.`tag-name-1`( - xml.prefixes.`prefix-1`(xml.uris.`http://example.com/1`).attributes.`attribute-1`(xml.prefixes.`prefix-1`(xml.uris.`http://example.com/1`).values.`value-1`), - xml.prefixes.`prefix-2`(xml.uris.`http://example.com/2`).attributes.`attribute-2`(xml.prefixes.`prefix-2`(xml.uris.`http://example.com/2`).values.`value-2`), - xml.prefixes.`prefix-1`(xml.uris.`http://example.com/1`).texts.`$u000A `, - xml.noPrefix(xml.uris.`http://example.com/0`).elements.`tag-name-2`( - xml.noPrefix(xml.uris.`http://example.com/0`).texts.content - ), - xml.prefixes.`prefix-1`(xml.uris.`http://example.com/1`).texts.`$u000A `, - xml.prefixes.`prefix-1`(xml.uris.`http://example.com/1`).comment(" my comment "), - xml.prefixes.`prefix-1`(xml.uris.`http://example.com/1`).texts.`$u000A` - ) -) -``` - -## Implementation - -The implementation of this proposal can be two parts: - -1. Compile-time XML translator -2. XML library vendors - -### Compile-time XML translator - -Compile-time XML translator will translate XML literal to Scala AST before type checking. It can be implemented either in the Scala compiler or in a white box macro. [nameBasedXml.scala](https://github.com/GlasslabGames/nameBasedXml.scala) is an implementation of the proposal in a white box macro. - -### XML library vendors - -An XML library vendor should provide a package or object named `xml` , which contains the following methods or values: - -* `elements` -* `attributes` -* `values` -* `entities` -* `processInstructions` -* `texts` -* `comment` -* `cdata` -* `interpolation` -* `noPrefix` -* `prefixes` -* `uris` -* `literal` - -All above methods except `literal` should return a builder, and `literal` will turn one or more builders into an XML object / or an XML node list. - -An XML library user can switch different implementations by importing different `xml` packages or objects. `scala.xml` is used by default when no explicit import is present. - -In a schema-aware XML library like Binding.scala, its `elements` , `attributes` , `processInstructions` and `entities` methods should return factory objects that contain all the definitions of available tag names and attribute names. An XML library user can provide additional tag names and attribute names in user-defined implicit classes for `tags` and `attributes` . - -In a schema-less XML library like `scala-xml` , its `elements` , `attributes` , `processInstructions` and `entities` should return builders that extend [scala.Dynamic](https://www.scala-lang.org/api/current/scala/Dynamic.html) in order to handle tag names and attribute names in `selectDynamic` or `applyDynamic` . - -Those XML libraries can be extended with the help of standard XML namespace bindings. A plug-in author can create `implicit class` for `xml.uris` to introduce foreign elements embedded in existing XML literals. - -[html.scala](https://github.com/GlasslabGames/html.scala) is an XML library vendor for creating reactive HTML templates. - -## Drawbacks - -### Name clash - -`` or `` will not compile due to name clash to `Any.toString` and `Any.equals` . - -* Compilation error is the desired behavior in a schema-aware XML library as long as `toString` is not a valid name in the schema. Fortunately, unlike JSX, `
      ` should compile because `class` is a valid method name. -* A schema-less XML library user should instead explicit construct `` in Scala code, e.g. `new Elem("toString")` . - -## Alternative approach - -XML initialization can be implemented in a special string interpolation as `xml""`, which can be implemented in a macro library. [scala-xml-quote](https://github.com/densh/scala-xml-quote) is an implementation in this approach. The pros and cons of these approaches are listed in the following table: - -||symbol-based XML literals in Scala 2.12|name-based XML literals in this proposal|`xml` string interpolation| -| --- | --- | --- | --- | -|XML is parsed by ...|compiler|compiler|library, IDE, and other code browsers including Github, Jekyll (if syntax highlighting is wanted)| -|Is third-party schema-less XML library supported?|No, unless using white box macros|Yes|Yes| -|Is third-party schema-aware XML library supported?|No, unless using white box macros|Yes|No, unless using white box macros| -|How to highlight XML syntax?|By regular highlighter grammars|By regular highlighter grammars|By special parsing rule for string content| -|Can presentation compiler perform code completion for schema-aware XML literals?|No|Yes|No| - -## References - -* [nameBasedXml.scala](https://github.com/GlasslabGames/nameBasedXml.scala) -* [API Documentation](https://javadoc.io/page/org.lrng.binding/namebasedxml_2.12/1.0.0/org/lrng/binding/nameBasedXml.html) -* [html.scala](https://github.com/GlasslabGames/html.scala) -* [Discussion on Scala Contributors Forum](https://contributors.scala-lang.org/t/pre-sip-name-based-xml-literals/2175) -* [Curried Varargs](https://docs.scala-lang.org/sips/curried-varargs.html) -* [scala-xml-quote](https://github.com/densh/scala-xml-quote) diff --git a/_sips/sips/2021-05-18-sealed-types.md b/_sips/sips/2021-05-18-sealed-types.md deleted file mode 100644 index 6c9406c97b..0000000000 --- a/_sips/sips/2021-05-18-sealed-types.md +++ /dev/null @@ -1,278 +0,0 @@ ---- -layout: sip -title: SIP-NN - Sealed Types -vote-status: pending -permalink: /sips/:title.html -redirect_from: /sips/pending/sealed-types.html ---- - -**By: Dale Wijnand and Fengyun Liu** - -## History - -| Date | Version | -|---------------|-----------| -| May 18th 2021 | Submitted | - -## Introduction - -Exhaustivity checking is one of the safety belts for using pattern matching in functional -programming. However, if one wants to partition values of an existing type to reason about them in -separate cases of a match or as separate types this requires wrapping the values in new classes, -which incurs a boxing cost. - -As an alternative, one may define custom extractors and use them as the case patterns. However, there is no -way in Scala to declare that these extractors are complementary, i.e. the match is exhaustive when -the complete set of extractors are used together. - -Similarly, one can define `TypeTest`s for matching abstract types, but there is no way to determine -if a match on an abstract type exhausts all its subtypes. - -This SIP solves these three problems by introducing *sealed types*. - -## Motivating Examples - -We've identified several real world use cases that calls for enhancing exhaustivity checking, and -used them to stress the design proposed here. You can find them [here][problems], but we'll present -an example below. - -Using the opaque types and custom extractors we can work safely with positive integers and negative -integers: - -```scala -opaque type Pos <: Int = Int -opaque type Neg <: Int = Int - -object Pos { def unapply(x: Int): Option[Pos] = if (x > 0) Some(x) else None } -object Neg { def unapply(x: Int): Option[Neg] = if (x < 0) Some(x) else None } - -(n: Int) match - case 0 => - case Pos(x) => - case Neg(x) => -``` - -With the above, when we get a `Pos` value, it's guaranteed to be a positive number. The same goes -for `Neg`. Sadly the match is reported as not exhaustive because the two extractors and the value -`0` aren't known to be complementary. - -## Design - -We identify two root causes: - -1. You can't define a type, that isn't a class, as `sealed` -2. You can't define a mapping from values to types - -The *sealed type*, proposed by this SIP, allow partitioning of value of a given type into a sealed -type hierarchy. [Here][solutions] you can find how sealed types address the issues faced by all the -motivating examples, but we'll present here how it fixes the number example above. - -In order to partition int into positive, zero, and negative numbers we'll define a new `sealed` type -`Num` and how to distinguish its subtypes with match syntax: - -```scala -sealed type Num = Int { - case 0 => val Zero - case n if n > 0 => type Pos - case _ => type Neg -} -``` - -This sealed type definition desugars into the following type and value definitions: - -```scala -type Num = Int -val Zero: Num = 0 -opaque type Pos <: Num = Num -opaque type Neg <: Num = Num -``` - -The match desugars into an ordinal method, that reuses the logic to associate an ordinal for each -case: - -```scala -extension (n: Num): - def ordinal: Int = (n: Int) match { - case 0 => 0 - case n if n > 0 => 1 - case _ => 2 - } -``` - -Finally a series of `TypeTest`s are defined, allowing for values of both the underlying type `Int` -and the sealed type `Num` to be tested against the subtypes and singleton subtypes `Pos`, -`Zero.type`, and `Neg`, using the `ordinal` method: - -```scala -given TypeTest[Int, Zero.type] = (n: Int) => if ((n: Num).ordinal == 0) Some(n) else None -given TypeTest[Int, Pos] = (n: Int) => if ((n: Num).ordinal == 1) Some(n) else None -given TypeTest[Int, Neg] = (n: Int) => if ((n: Num).ordinal == 2) Some(n) else None -given TypeTest[Int, Num] = (n: Int) => Some(n) -given [T <: Num](using t: TypeTest[Int, T]): TypeTest[Num, T] = (n: Num) => t.unapply(n) -``` - -Given the above, one can either change the usage from extractors to types: - -```scala -(n: Int) match - case 0 => - case x: Pos => - case x: Neg => -``` - -Or we can keep the usage the same by redefining the extractors (using a value class name-based -extractors `PosExtractor` and `NegExtractor` to avoid allocating): - -```scala -object Pos { def unapply(x: Pos): PosExtractor = new PosExtractor(x) } -object Neg { def unapply(x: Neg): NegExtractor = new NegExtractor(x) } - -class PosExtractor(private val x: Pos) extends AnyVal { def isEmpty: false = false ; def get = x } -class NegExtractor(private val x: Neg) extends AnyVal { def isEmpty: false = false ; def get = x } - -(n: Int) match - case 0 => - case Pos(x) => - case Neg(x) => -``` - -## Syntax - -The existing syntax is enhanced as follows: - -``` -TypeDcl ::= `sealed` [`opaque`] `type` id [TypeParamClause] -TypeDef ::= `sealed` [`opaque`] `type` id [TypeParamClause] [`>:` Type] [`<:` Type] `=` Type `{` - `case` Pattern [Guard] `=>` (`type` id [TypeParamClause] | `val` id [`:` Type]) - `}` -``` - -Specifically: - -* the `sealed` modifier becomes available for type definitions and declarations -* on the right-hand side of definitions is the underlying type of the sealed type -* following the underlying type is a match that operates on a value of the - underlying type and defines the type or singleton type associated to that case. -* the type is defined using the `type` keyword and singleton types are defined using `val` - -## Desugaring - -Using the example - -``` -sealed [opaque] type T[X..] [bounds] = U { - case p1 => type C[X..] - case p2 => val S -} -``` - -That desugars into: -* a type alias `type T[X..] [bounds] = U`, `opaque` if the sealed type is `opaque` (see Restrictions) -* opaque type definitions, `opaque type C[X..] <: T[Y..] = T[Y..]`, for each non-singleton type case - - any type argument `Y` that isn't defined from `X..` will be: - + its lower bound, if the type parameter is covariant - + its upper bound, if the type parameter is contravariant - + a wildcard type, with the type parameter's bounds, if the type parameter is invariant -* val definitions, `val S: T[Y..] = p`, for singleton type cases, using the same type argument rules -* an ordinal method, `extension (t: T): def ordinal: Int = (t: U) match { case p1 => 0 p2 => 1 .. }` - - each of the sealed type's cases is associated with a unique ordinal - - ordinals starts from 0 and increase for each case, in the order of their definition - - the ordinal method adds a `case _ => -1` default case, if the sealed type's match is inexhaustive - - such an ordinal method may only be defined by the compiler, to preserve exhaustivity guarantees -* a series a `TypeTest`s, defined in terms of the ordinal method - - a `TypeTest` between `U` and each case `A`, having ordinal `ordA`: - + `given TypeTest[U, C] = (u: U) => if ((u: T).ordinal == $ordA) Some(u) else None` - + `given TypeTest[U, S.type] = (u: U) => if ((u: T).ordinal == $ordA) Some(u) else None` - - a type test between the underlying type and the sealed type: - + `given TypeTest[U, T] = (u: U) => if ((u: T).ordinal == -1) None else Some(u)` - - a generic type test between `T` and each case `A`, defined in terms of the above type tests: - + `given [A <: T](using t: TypeTest[U, A]): TypeTest[T, A] = (x: T) => t.unapply(x)` - -## Restrictions - -1. If the match on the value of the underlying type is not exhaustive, then the sealed type must be - declared `opaque`, in order to preserve the fact that the sealed type represents only a subset of - the values of the underlying type (e.g. positive integers) -2. No other type may be declared to subtype the opaque type `T` -3. For singleton types, the pattern `p` must be a stable value, e.g. a `val`, a `case object`, or a literal -4. Each case must define a new type or singleton type - -## Alternative Design - -An alternative design is to introduce an annotation `@complete` to specify that -a type can be partitioned into a list of subtypes. - -For example, given the following definition: - -```scala - opaque type Nat <: Int = Int - opaque type Neg <: Int = Int - - @complete[(Nat, Neg)] // Num decomposes to `Nat` and `Neg` - type Num = Int - - given TypeTest[Int, Neg] = (n: Int) => if (x < 0) Some(n) else None - given TypeTest[Int, Nat] = (n: Int) => if (x >= 0) Some(n) else None -``` - -The user now can write code as follows: - -``` Scala - def foo(n: Num) = - n match - case x: Neg => - case x: Nat => -``` - -Knowing that the type `Num` can be decomposed to `Neg` and `Nat`, the compiler -can verify that the pattern match above is exhaustive. - -This approach, however, is relatively low-level and the compiler does not -provide any guarantee that the annotation is actually correct. - -You can find more examples [here][complete-gist] - -## Related Work - -Haskell has a `COMPLETE` pragma which allows patterns and type constructors to be -defined to be a complete set, relying on the programmer getting it right. - -```haskell -data Choice a = Choice Bool a - -pattern LeftChoice :: a -> Choice a -pattern LeftChoice a = Choice False a - -pattern RightChoice :: a -> Choice a -pattern RightChoice a = Choice True a - -{-# COMPLETE LeftChoice, RightChoice #-} - -foo :: Choice Int -> Int -foo (LeftChoice n) = n * 2 -foo (RightChoice n) = n - 2 -``` - -## References - -1. [Opaque types][1] -2. [Forum discussion about Opt[T]][2] -3. [Github discussion about enhancing exhaustivity check][3] -4. [_Lightweight static capabilities_][4], Oleg Kiselyov, Chung-chieh Shan, 2007 -5. [TypeTest documentation][5] - -[1]: https://docs.scala-lang.org/sips/opaque-types.html -[2]: https://contributors.scala-lang.org/t/trouble-with-2-13-4-exhaustivity-checking-being-too-strict/4817 -[3]: https://github.com/lampepfl/dotty/issues/10961 -[4]: http://okmij.org/ftp/Computation/lightweight-guarantees/lightweight-static-capabilities.pdf -[5]: http://dotty.epfl.ch/docs/reference/other-new-features/type-test.html -[6]: https://github.com/lampepfl/dotty/pull/11186 -[problems]: https://gist.github.com/dwijnand/d33436cf197daa15216b3cd35d03ba1c#file-sealedtypeproblems-scala -[solutions]: https://gist.github.com/dwijnand/d33436cf197daa15216b3cd35d03ba1c#file-sealedtypesolutions-scala -[complete-gist]: https://gist.github.com/dwijnand/d33436cf197daa15216b3cd35d03ba1c#file-z-complete-scala - -* https://github.com/lampepfl/dotty/issues/10961 False “match may not be exhaustive warning” -* https://github.com/lampepfl/dotty/pull/11186 Implement @covers annotation for partial irrefutable specification -* https://downloads.haskell.org/~ghc/9.0.1/docs/html/users_guide/exts/pragmas.html#complete-pragma -* https://downloads.haskell.org/~ghc/9.0.1/docs/html/users_guide/exts/pattern_synonyms.html -* https://dotty.epfl.ch/docs/reference/other-new-features/opaques.html diff --git a/_sips/sips/2014-06-27-42.type.md b/_sips/sips/42.type.md similarity index 99% rename from _sips/sips/2014-06-27-42.type.md rename to _sips/sips/42.type.md index aef0b4320b..f143c9a8ab 100644 --- a/_sips/sips/2014-06-27-42.type.md +++ b/_sips/sips/42.type.md @@ -1,7 +1,8 @@ --- layout: sip title: SIP-23 - Literal-based singleton types -vote-status: complete +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/42.type.html --- diff --git a/_sips/sips/adding-prefix-types.md b/_sips/sips/adding-prefix-types.md new file mode 100644 index 0000000000..f2e30207ca --- /dev/null +++ b/_sips/sips/adding-prefix-types.md @@ -0,0 +1,7 @@ +--- +title: SIP-36 - Adding prefix types +status: under-review +pull-request-number: 35 +stage: design + +--- diff --git a/_sips/sips/allow-referring-to-other-arguments-in-default-parameters.md b/_sips/sips/allow-referring-to-other-arguments-in-default-parameters.md new file mode 100644 index 0000000000..6ee5776d76 --- /dev/null +++ b/_sips/sips/allow-referring-to-other-arguments-in-default-parameters.md @@ -0,0 +1,7 @@ +--- +title: SIP-32 - Allow referring to other arguments in default parameters +status: under-review +pull-request-number: 29 +stage: design + +--- diff --git a/_sips/sips/async.md b/_sips/sips/async.md new file mode 100644 index 0000000000..49448af0cb --- /dev/null +++ b/_sips/sips/async.md @@ -0,0 +1,6 @@ +--- +title: SIP-22 - Async +status: withdrawn +pull-request-number: 21 + +--- diff --git a/_sips/sips/2017-11-20-byname-implicits.md b/_sips/sips/byname-implicits.md similarity index 99% rename from _sips/sips/2017-11-20-byname-implicits.md rename to _sips/sips/byname-implicits.md index 3de5293b4f..4e47f9765c 100644 --- a/_sips/sips/2017-11-20-byname-implicits.md +++ b/_sips/sips/byname-implicits.md @@ -1,12 +1,14 @@ --- layout: sip title: SIP-31 - Byname implicit arguments -vote-status: complete -vote-text: This SIP has been implemented in Scala 2.13.0 and Scala 3.0.0 +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/byname-implicits.html --- +> This proposal has been implemented in Scala 2.13.0 and Scala 3.0.0. + **Author: Miles Sabin** **Supervisor and advisor: Martin Odersky** diff --git a/_sips/sips/comonadic-comprehensions.md b/_sips/sips/comonadic-comprehensions.md new file mode 100644 index 0000000000..d668fc4d78 --- /dev/null +++ b/_sips/sips/comonadic-comprehensions.md @@ -0,0 +1,6 @@ +--- +title: SIP-NN - comonadic-comprehensions +status: rejected +pull-request-number: 32 + +--- diff --git a/_sips/sips/2018-08-20-converters-among-optional-functions-partialfunctions-and-extractor-objects.md b/_sips/sips/converters-among-optional-functions-partialfunctions-and-extractor-objects.md similarity index 97% rename from _sips/sips/2018-08-20-converters-among-optional-functions-partialfunctions-and-extractor-objects.md rename to _sips/sips/converters-among-optional-functions-partialfunctions-and-extractor-objects.md index 816ee0af7f..cad08453c3 100644 --- a/_sips/sips/2018-08-20-converters-among-optional-functions-partialfunctions-and-extractor-objects.md +++ b/_sips/sips/converters-among-optional-functions-partialfunctions-and-extractor-objects.md @@ -1,12 +1,14 @@ --- layout: sip title: SIP-38 - Converters among optional Functions, PartialFunctions and extractor objects -vote-status: complete -vote-text: This SIP has been implemented in Scala 2.13.0 and Scala 3.0.0 +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/converters-among-optional-functions-partialfunctions-and-extractor-object.html --- +> This proposal has been implemented in Scala 2.13.0 and Scala 3.0.0. + **By: Yang Bo** diff --git a/_sips/sips/curried-varargs.md b/_sips/sips/curried-varargs.md new file mode 100644 index 0000000000..4772fd1adb --- /dev/null +++ b/_sips/sips/curried-varargs.md @@ -0,0 +1,7 @@ +--- +title: SIP-NN - Curried varargs +status: under-review +pull-request-number: 41 +stage: design + +--- diff --git a/_sips/sips/2009-06-02-early-member-definitions.md b/_sips/sips/early-member-definitions.md similarity index 73% rename from _sips/sips/2009-06-02-early-member-definitions.md rename to _sips/sips/early-member-definitions.md index 06adf76c50..244b7c15b3 100644 --- a/_sips/sips/2009-06-02-early-member-definitions.md +++ b/_sips/sips/early-member-definitions.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-4 - Early Member Definitions -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/early-member-definitions.html --- diff --git a/_sips/sips/2012-01-21-futures-promises.md b/_sips/sips/futures-promises.md similarity index 99% rename from _sips/sips/2012-01-21-futures-promises.md rename to _sips/sips/futures-promises.md index 1bc4670945..f69ac68c92 100644 --- a/_sips/sips/2012-01-21-futures-promises.md +++ b/_sips/sips/futures-promises.md @@ -1,8 +1,8 @@ --- layout: sip title: SIP-14 - Futures and Promises -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/futures-promises.html --- diff --git a/_sips/sips/2011-10-12-implicit-classes.md b/_sips/sips/implicit-classes.md similarity index 97% rename from _sips/sips/2011-10-12-implicit-classes.md rename to _sips/sips/implicit-classes.md index 988d146267..495bcadf23 100644 --- a/_sips/sips/2011-10-12-implicit-classes.md +++ b/_sips/sips/implicit-classes.md @@ -1,8 +1,8 @@ --- layout: sip title: SIP-13 - Implicit classes -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/implicit-classes.html --- diff --git a/_sips/sips/implicit-source-locations.md b/_sips/sips/implicit-source-locations.md new file mode 100644 index 0000000000..a51a574f5d --- /dev/null +++ b/_sips/sips/implicit-source-locations.md @@ -0,0 +1,6 @@ +--- +title: SIP-19 - Implicit Source Locations +status: rejected +pull-request-number: 18 + +--- diff --git a/_sips/sips/improved-lazy-vals-initialization.md b/_sips/sips/improved-lazy-vals-initialization.md new file mode 100644 index 0000000000..24f129e8b6 --- /dev/null +++ b/_sips/sips/improved-lazy-vals-initialization.md @@ -0,0 +1,6 @@ +--- +title: SIP-20 - Improved Lazy Vals Initialization +status: withdrawn +pull-request-number: 19 + +--- diff --git a/_sips/sips/improving-binary-compatibility-with-stableabi.md b/_sips/sips/improving-binary-compatibility-with-stableabi.md new file mode 100644 index 0000000000..6e48e46553 --- /dev/null +++ b/_sips/sips/improving-binary-compatibility-with-stableabi.md @@ -0,0 +1,6 @@ +--- +title: SIP-34 - Improving binary compatibility with @stableABI +status: withdrawn +pull-request-number: 30 + +--- diff --git a/_sips/sips/inline-meta.md b/_sips/sips/inline-meta.md new file mode 100644 index 0000000000..c27ee3530a --- /dev/null +++ b/_sips/sips/inline-meta.md @@ -0,0 +1,6 @@ +--- +title: SIP-28 - Inline meta +status: withdrawn +pull-request-number: 28 + +--- diff --git a/_sips/sips/2010-01-27-internals-of-scala-annotations.md b/_sips/sips/internals-of-scala-annotations.md similarity index 74% rename from _sips/sips/2010-01-27-internals-of-scala-annotations.md rename to _sips/sips/internals-of-scala-annotations.md index a21defafcc..792f7ee8ee 100644 --- a/_sips/sips/2010-01-27-internals-of-scala-annotations.md +++ b/_sips/sips/internals-of-scala-annotations.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-5 - Internals of Scala Annotations -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/internals-of-scala-annotations.html --- diff --git a/_sips/sips/2018-07-31-interpolation-quote-escape.md b/_sips/sips/interpolation-quote-escape.md similarity index 96% rename from _sips/sips/2018-07-31-interpolation-quote-escape.md rename to _sips/sips/interpolation-quote-escape.md index 692e528de0..1fade0f6ff 100644 --- a/_sips/sips/2018-07-31-interpolation-quote-escape.md +++ b/_sips/sips/interpolation-quote-escape.md @@ -1,130 +1,132 @@ ---- -layout: sip -title: SIP-37 - Quote escapes for interpolations -vote-status: complete -vote-text: This SIP has been implemented in Scala 2.13.6 and Scala 3.0.0 -permalink: /sips/:title.html -redirect_from: /sips/pending/interpolation-quote-escape.html ---- - -**By: Martijn Hoekstra** - -## History - -| Date | Version | -|---------------|-----------------------| -| Jul 31th 2018 | Initial Draft | -| Aug 1st 2018 | Process lead comments | -| Nov 2nd 2019 | Link dotty impl | - -## Introduction - -It's not straight-forward how to have a quote character (`"`) in an -interpolation. Parsing interpolations does not process backslash escapes, but -rather passes the raw string to the interpolator, which then has the option to -process escapes itself as it sees fit. That means there are no lexing rules that -process the escape, and the sequence `\"` simply terminates the interpolation. - -Interpolations have a different meta-character -- the `$` character -- which is -treated specially. Interpolations use this escape to splice in arguments, and it -can also be used to escape itself as the sequence `$$` to represent a literal -`$` character. - -Because of its special handling during the parse, the `$` could be used to -escape a `"` character to represent a literal `"` withing a string. - -## Motivating Example - -That the `"` character can't be easily escaped in interpolations has been an -open issue since at least 2012[^1], and how to deal with this issue is a -somewhat common SO question[^2][^3] - -{% highlight Scala %} -s"A common question for Scala programmers is "How can I represent a literal " character in Scala interpolations?"" -{% endhighlight %} - -Doesn't work. - -Neither does - -{% highlight Scala %} -s"A common question for Scala programmers is \"How can I represent a literal \" character in Scala interpolations?\"" -{% endhighlight %} - -### Examples - -{% highlight Scala %} -s"A common question for Scala programmers is $"How can I represent a literal $" character in Scala interpolations?$"" -{% endhighlight %} - -### Comparison Examples - -There are a number of ways to work around the current restriction. - -The simplest is triple-quoting the interpolation: -{% highlight Scala %} -s"""A common question for Scala programmers is "How can I represent a literal " character in Scala interpolations?"""" -{% endhighlight %} - -Another common workaround is splicing in a separate string in one way or another. - -{% highlight Scala %} -//with a normal escape in a string in a block -s"A common question for Scala programmers is ${"\""}How can I represent a literal ${"\""} character in Scala interpolations?${"\""}" -//with a quote character as a block -s"A common question for Scala programmers is ${'"'}How can I represent a literal ${'"'} character in Scala interpolations?${'"'}" -//with an identifier referencing a string that contains a single quote -val quote = "\"" -s"A common question for Scala programmers is ${q}How can I represent a literal $q character in Scala interpolations?$q" -{% endhighlight %} - -The second set of workarounds is dependent on the actual interpolator, and the -quote becomes an argument. The `s`, `f` and `raw` interpolators splice their -arguments in to the string, as is the obvious use and implementation of an -interpolator. But it's not the only possible use and implementation for an -interpolator and this way of inserting quotes may not work for any given -interpolator. - -## Design - -This is a non-breaking change. Currently the sequence `$"` within an -interpolation is a syntax error, as has already been noted[^4] -on the original ticket. - -## Implementation - -The implementation is simple to the point of being trivial: see -the implementation [^5] for the actual change in functionality and the rest of -that PR for the spec and test changes. - -There is also an implementation for Dotty.[^7] - -## Drawbacks - -Adding this feature makes the language just a bit more irregular. There already -is some amount of irregularity around string literals and interpolations in -the language. An argument could be made that this change makes that worse rather -than better. - -Because it affects parsing, this change may affect syntax highlighters. Syntax -highlighters tend to already struggle around "funky" strings and interpolations. - -## Alternatives - -More ambitious proposals around interpolations are possible, and have been -proposed in different forms before. For example, there was a PR thatshows more options -around using `\` as a meta character in interpolations[^6]. It stranded somewhere -between red tape, ambition and changing processes. - -I suspect the last word about interpolations hasn't been spoken, and that later -proposals may still make interpolations more regular. This proposal is -deliberately small, and intends not to be in the way of any potential further -proposals. - -[^1]: https://github.com/Scala/bug/issues/6476 "\\\" escape does not work with string interpolation" -[^2]: https://stackoverflow.com/questions/31366563/string-interpolation-escaping-quotation-mark/31366588 "" -[^3]: https://stackoverflow.com/questions/17085354/escaping-quotation-marks-in-f-string-interpolation "" -[^4]: https://github.com/scala/bug/issues/6476#issuecomment-292412577 "@retronym said: +1 to s"$"". Because it doesn't compile today, we don't risk changing the meaning of existing programs." -[^5]: https://github.com/Scala/Scala/pull/6953/files#diff-0023b3bfa053fb16603156b785efa7ad "" -[^6]: https://github.com/Scala/Scala/pull/4308 "SI-6476 Accept escaped quotes in interp strings" -[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" +--- +layout: sip +title: SIP-37 - Quote escapes for interpolations +stage: completed +status: shipped +permalink: /sips/:title.html +redirect_from: /sips/pending/interpolation-quote-escape.html +--- + +> This proposal has been implemented in Scala 2.13.6 and Scala 3.0.0. + +**By: Martijn Hoekstra** + +## History + +| Date | Version | +|---------------|-----------------------| +| Jul 31th 2018 | Initial Draft | +| Aug 1st 2018 | Process lead comments | +| Nov 2nd 2019 | Link dotty impl | + +## Introduction + +It's not straight-forward how to have a quote character (`"`) in an +interpolation. Parsing interpolations does not process backslash escapes, but +rather passes the raw string to the interpolator, which then has the option to +process escapes itself as it sees fit. That means there are no lexing rules that +process the escape, and the sequence `\"` simply terminates the interpolation. + +Interpolations have a different meta-character -- the `$` character -- which is +treated specially. Interpolations use this escape to splice in arguments, and it +can also be used to escape itself as the sequence `$$` to represent a literal +`$` character. + +Because of its special handling during the parse, the `$` could be used to +escape a `"` character to represent a literal `"` withing a string. + +## Motivating Example + +That the `"` character can't be easily escaped in interpolations has been an +open issue since at least 2012[^1], and how to deal with this issue is a +somewhat common SO question[^2][^3] + +{% highlight Scala %} +s"A common question for Scala programmers is "How can I represent a literal " character in Scala interpolations?"" +{% endhighlight %} + +Doesn't work. + +Neither does + +{% highlight Scala %} +s"A common question for Scala programmers is \"How can I represent a literal \" character in Scala interpolations?\"" +{% endhighlight %} + +### Examples + +{% highlight Scala %} +s"A common question for Scala programmers is $"How can I represent a literal $" character in Scala interpolations?$"" +{% endhighlight %} + +### Comparison Examples + +There are a number of ways to work around the current restriction. + +The simplest is triple-quoting the interpolation: +{% highlight Scala %} +s"""A common question for Scala programmers is "How can I represent a literal " character in Scala interpolations?"""" +{% endhighlight %} + +Another common workaround is splicing in a separate string in one way or another. + +{% highlight Scala %} +//with a normal escape in a string in a block +s"A common question for Scala programmers is ${"\""}How can I represent a literal ${"\""} character in Scala interpolations?${"\""}" +//with a quote character as a block +s"A common question for Scala programmers is ${'"'}How can I represent a literal ${'"'} character in Scala interpolations?${'"'}" +//with an identifier referencing a string that contains a single quote +val quote = "\"" +s"A common question for Scala programmers is ${q}How can I represent a literal $q character in Scala interpolations?$q" +{% endhighlight %} + +The second set of workarounds is dependent on the actual interpolator, and the +quote becomes an argument. The `s`, `f` and `raw` interpolators splice their +arguments in to the string, as is the obvious use and implementation of an +interpolator. But it's not the only possible use and implementation for an +interpolator and this way of inserting quotes may not work for any given +interpolator. + +## Design + +This is a non-breaking change. Currently the sequence `$"` within an +interpolation is a syntax error, as has already been noted[^4] +on the original ticket. + +## Implementation + +The implementation is simple to the point of being trivial: see +the implementation [^5] for the actual change in functionality and the rest of +that PR for the spec and test changes. + +There is also an implementation for Dotty.[^7] + +## Drawbacks + +Adding this feature makes the language just a bit more irregular. There already +is some amount of irregularity around string literals and interpolations in +the language. An argument could be made that this change makes that worse rather +than better. + +Because it affects parsing, this change may affect syntax highlighters. Syntax +highlighters tend to already struggle around "funky" strings and interpolations. + +## Alternatives + +More ambitious proposals around interpolations are possible, and have been +proposed in different forms before. For example, there was a PR thatshows more options +around using `\` as a meta character in interpolations[^6]. It stranded somewhere +between red tape, ambition and changing processes. + +I suspect the last word about interpolations hasn't been spoken, and that later +proposals may still make interpolations more regular. This proposal is +deliberately small, and intends not to be in the way of any potential further +proposals. + +[^1]: https://github.com/Scala/bug/issues/6476 "\\\" escape does not work with string interpolation" +[^2]: https://stackoverflow.com/questions/31366563/string-interpolation-escaping-quotation-mark/31366588 "" +[^3]: https://stackoverflow.com/questions/17085354/escaping-quotation-marks-in-f-string-interpolation "" +[^4]: https://github.com/scala/bug/issues/6476#issuecomment-292412577 "@retronym said: +1 to s"$"". Because it doesn't compile today, we don't risk changing the meaning of existing programs." +[^5]: https://github.com/Scala/Scala/pull/6953/files#diff-0023b3bfa053fb16603156b785efa7ad "" +[^6]: https://github.com/Scala/Scala/pull/4308 "SI-6476 Accept escaped quotes in interp strings" +[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" diff --git a/_sips/sips/2012-03-17-modularizing-language-features.md b/_sips/sips/modularizing-language-features.md similarity index 86% rename from _sips/sips/2012-03-17-modularizing-language-features.md rename to _sips/sips/modularizing-language-features.md index b3178ba83f..4de88d18be 100644 --- a/_sips/sips/2012-03-17-modularizing-language-features.md +++ b/_sips/sips/modularizing-language-features.md @@ -1,9 +1,8 @@ --- layout: sip title: SIP-18 - Modularizing Language Features - -vote-status: complete -vote-text: This SIP has already been accepted and completed. Let the record show Paul is against it. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/modularizing-language-features.html --- diff --git a/_sips/sips/name-based-xml-literals.md b/_sips/sips/name-based-xml-literals.md new file mode 100644 index 0000000000..bf471045af --- /dev/null +++ b/_sips/sips/name-based-xml-literals.md @@ -0,0 +1,7 @@ +--- +title: SIP-NN - Name Based XML Literals +status: under-review +pull-request-number: 42 +stage: design + +--- diff --git a/_sips/sips/2010-01-22-named-and-default-arguments.md b/_sips/sips/named-and-default-arguments.md similarity index 99% rename from _sips/sips/2010-01-22-named-and-default-arguments.md rename to _sips/sips/named-and-default-arguments.md index 6b8fb55dd4..3d56605ad7 100644 --- a/_sips/sips/2010-01-22-named-and-default-arguments.md +++ b/_sips/sips/named-and-default-arguments.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-1 Named and Default Arguments -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/named-and-default-arguments.html --- diff --git a/_sips/sips/2010-07-20-new-collection-classes.md b/_sips/sips/new-collection-classes.md similarity index 73% rename from _sips/sips/2010-07-20-new-collection-classes.md rename to _sips/sips/new-collection-classes.md index ea7371be48..d8bb9b8047 100644 --- a/_sips/sips/2010-07-20-new-collection-classes.md +++ b/_sips/sips/new-collection-classes.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-3 - New Collection classes -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/new-collection-classes.html --- diff --git a/_sips/sips/2017-09-20-opaque-types.md b/_sips/sips/opaque-types.md similarity index 99% rename from _sips/sips/2017-09-20-opaque-types.md rename to _sips/sips/opaque-types.md index ff7cf4e9d3..a33083181d 100644 --- a/_sips/sips/2017-09-20-opaque-types.md +++ b/_sips/sips/opaque-types.md @@ -1,13 +1,14 @@ --- layout: sip title: SIP-35 - Opaque types - -vote-status: complete -vote-text: This SIP has been implemented with some changes in Scala 3.0.0 +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/opaque-types.html --- +> This proposal has been implemented with some changes in Scala 3.0.0. + **Authors: Erik Osheim and Jorge Vicente Cantero** **Supervisor and advisor: Sébastien Doeraene** diff --git a/_sips/sips/2010-06-01-picked-signatures.md b/_sips/sips/picked-signatures.md similarity index 75% rename from _sips/sips/2010-06-01-picked-signatures.md rename to _sips/sips/picked-signatures.md index 974dfdbd34..12f205a4e1 100644 --- a/_sips/sips/2010-06-01-picked-signatures.md +++ b/_sips/sips/picked-signatures.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-10 - Storage of pickled Scala signatures in class files -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/picked-signatures.html --- diff --git a/_sips/sips/2017-02-07-priority-based-infix-type-precedence.md b/_sips/sips/priority-based-infix-type-precedence.md similarity index 99% rename from _sips/sips/2017-02-07-priority-based-infix-type-precedence.md rename to _sips/sips/priority-based-infix-type-precedence.md index 295f047dec..fddbb1f58a 100644 --- a/_sips/sips/2017-02-07-priority-based-infix-type-precedence.md +++ b/_sips/sips/priority-based-infix-type-precedence.md @@ -1,7 +1,8 @@ --- layout: sip title: SIP-33 - Priority-based infix type precedence -vote-status: complete +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/priority-based-infix-type-precedence.html --- diff --git a/_sips/sips/2015-6-18-trait-parameters.md b/_sips/sips/rait-parameters.md similarity index 97% rename from _sips/sips/2015-6-18-trait-parameters.md rename to _sips/sips/rait-parameters.md index a5dffe5446..93bcd8bf70 100644 --- a/_sips/sips/2015-6-18-trait-parameters.md +++ b/_sips/sips/rait-parameters.md @@ -1,12 +1,14 @@ --- layout: sip title: SIP-25 - Trait Parameters -vote-status: complete -vote-text: Trait parameters are implemented in Scala 3.0. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/trait-parameters.html --- +> This proposal has been implemented in Scala 3.0. + __Martin Odersky__ __first submitted 18 June 2015__ diff --git a/_sips/sips/repeated-by-name-parameters.md b/_sips/sips/repeated-by-name-parameters.md new file mode 100644 index 0000000000..6949fcf87c --- /dev/null +++ b/_sips/sips/repeated-by-name-parameters.md @@ -0,0 +1,6 @@ +--- +title: SIP-24 - Repeated By Name Parameters +status: withdrawn +pull-request-number: 23 + +--- diff --git a/_sips/sips/2017-07-12-right-associative-by-name-operators.md b/_sips/sips/right-associative-by-name-operators.md similarity index 97% rename from _sips/sips/2017-07-12-right-associative-by-name-operators.md rename to _sips/sips/right-associative-by-name-operators.md index e9451c4705..3d247af33d 100644 --- a/_sips/sips/2017-07-12-right-associative-by-name-operators.md +++ b/_sips/sips/right-associative-by-name-operators.md @@ -1,12 +1,14 @@ --- layout: sip title: SIP-39 - Right-Associative By-Name Operators -vote-status: complete -vote-text: This SIP has been implemented in Scala 2.13.0 and Scala 3.0.0 +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/right-associative-by-name-operators.html --- +> This proposal has been implemented in Scala 2.13.0 and Scala 3.0.0. + **By: Stefan Zeiger** ## History diff --git a/_sips/sips/2010-01-22-scala-2-8-arrays.md b/_sips/sips/scala-2-8-arrays.md similarity index 99% rename from _sips/sips/2010-01-22-scala-2-8-arrays.md rename to _sips/sips/scala-2-8-arrays.md index f733a6de60..7f5999d651 100644 --- a/_sips/sips/2010-01-22-scala-2-8-arrays.md +++ b/_sips/sips/scala-2-8-arrays.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-7 - Scala 2.8 Arrays -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/scala-2-8-arrays.html --- diff --git a/_sips/sips/2009-05-28-scala-compiler-phase-plugin-in.md b/_sips/sips/scala-compiler-phase-plugin-in.md similarity index 76% rename from _sips/sips/2009-05-28-scala-compiler-phase-plugin-in.md rename to _sips/sips/scala-compiler-phase-plugin-in.md index 8d854921c3..24f0330e91 100644 --- a/_sips/sips/2009-05-28-scala-compiler-phase-plugin-in.md +++ b/_sips/sips/scala-compiler-phase-plugin-in.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-2 Scala Compiler Phase and Plug-In Initialization for Scala 2.8 -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/scala-compiler-phase-plugin-in.html --- diff --git a/_sips/sips/2010-05-06-scala-specialization.md b/_sips/sips/scala-specialization.md similarity index 72% rename from _sips/sips/2010-05-06-scala-specialization.md rename to _sips/sips/scala-specialization.md index dc3afd5caf..d9bd06e36e 100644 --- a/_sips/sips/2010-05-06-scala-specialization.md +++ b/_sips/sips/scala-specialization.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-9 - Scala Specialization -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/scala-specialization.html --- diff --git a/_sips/sips/2009-11-02-scala-swing-overview.md b/_sips/sips/scala-swing-overview.md similarity index 72% rename from _sips/sips/2009-11-02-scala-swing-overview.md rename to _sips/sips/scala-swing-overview.md index 497ae502e6..a539dc352c 100644 --- a/_sips/sips/2009-11-02-scala-swing-overview.md +++ b/_sips/sips/scala-swing-overview.md @@ -1,8 +1,8 @@ --- layout: sip title: SID-8 - Scala Swing Overview -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/scala-swing-overview.html --- diff --git a/_sips/sips/sealed-types.md b/_sips/sips/sealed-types.md new file mode 100644 index 0000000000..f9f5a8b70a --- /dev/null +++ b/_sips/sips/sealed-types.md @@ -0,0 +1,7 @@ +--- +title: SIP-NN - Sealed Types +status: under-review +pull-request-number: 43 +stage: design + +--- diff --git a/_sips/sips/self-cleaning-macros.md b/_sips/sips/self-cleaning-macros.md new file mode 100644 index 0000000000..056a674a38 --- /dev/null +++ b/_sips/sips/self-cleaning-macros.md @@ -0,0 +1,6 @@ +--- +title: SIP-16 - Self-cleaning Macros +status: rejected +pull-request-number: 15 + +--- diff --git a/_sips/sips/spores.md b/_sips/sips/spores.md new file mode 100644 index 0000000000..2b9c51d5a3 --- /dev/null +++ b/_sips/sips/spores.md @@ -0,0 +1,6 @@ +--- +title: SIP-21 - Spores +status: withdrawn +pull-request-number: 20 + +--- diff --git a/_sips/sips/static-fields-and-methods-in-scala-objects-si-4581.md b/_sips/sips/static-fields-and-methods-in-scala-objects-si-4581.md new file mode 100644 index 0000000000..6b9e2d57ab --- /dev/null +++ b/_sips/sips/static-fields-and-methods-in-scala-objects-si-4581.md @@ -0,0 +1,6 @@ +--- +title: SIP-30 - @static fields and methods in Scala objects (SI-4581) +status: withdrawn +pull-request-number: 25 + +--- diff --git a/_sips/sips/2011-10-13-string-interpolation.md b/_sips/sips/string-interpolation.md similarity index 69% rename from _sips/sips/2011-10-13-string-interpolation.md rename to _sips/sips/string-interpolation.md index 69b807a6da..f1343fdb22 100644 --- a/_sips/sips/2011-10-13-string-interpolation.md +++ b/_sips/sips/string-interpolation.md @@ -1,9 +1,9 @@ --- layout: sip title: SIP-11 - String Interpolation - +stage: completed +status: shipped vote-status: complete -vote-text: This SIP has already been accepted and completed. We expect a SIP for 2.11 that will allow the desugared form of interpolated strings in the pattern matcher to become valid syntax. This SIP only allows the sugared interpolated strings to work. permalink: /sips/:title.html redirect_from: /sips/pending/string-interpolation.html --- diff --git a/_sips/sips/support-binary-integer-literals.md b/_sips/sips/support-binary-integer-literals.md new file mode 100644 index 0000000000..a6d750722a --- /dev/null +++ b/_sips/sips/support-binary-integer-literals.md @@ -0,0 +1,7 @@ +--- +title: SIP-NN - Support Binary Integer Literals +status: under-review +pull-request-number: 40 +stage: design + +--- diff --git a/_sips/sips/2016-06-25-trailing-commas.md b/_sips/sips/trailing-commas.md similarity index 98% rename from _sips/sips/2016-06-25-trailing-commas.md rename to _sips/sips/trailing-commas.md index 1116621487..9bacf33264 100644 --- a/_sips/sips/2016-06-25-trailing-commas.md +++ b/_sips/sips/trailing-commas.md @@ -1,12 +1,14 @@ --- layout: inner-page-no-masthead title: SIP-27 - Trailing Commas -vote-status: complete -vote-text: This SIP has already been accepted and completed, and is a part of Scala 2.12.2. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/trailing-commas.html --- +> This proposal has been shipped in Scala 2.12.2. + **By: Dale Wijnand** ## History diff --git a/_sips/sips/2012-03-13-type-dynamic.md b/_sips/sips/type-dynamic.md similarity index 85% rename from _sips/sips/2012-03-13-type-dynamic.md rename to _sips/sips/type-dynamic.md index 37385c3c02..c359ec0627 100644 --- a/_sips/sips/2012-03-13-type-dynamic.md +++ b/_sips/sips/type-dynamic.md @@ -1,9 +1,8 @@ --- layout: sip title: SIP-17 - Type Dynamic - -vote-status: complete -vote-text: This SIP has already been accepted and completed. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/type-dynamic.html --- diff --git a/_sips/sips/uncluttering-abuse-of-match.md b/_sips/sips/uncluttering-abuse-of-match.md new file mode 100644 index 0000000000..8d481a92a9 --- /dev/null +++ b/_sips/sips/uncluttering-abuse-of-match.md @@ -0,0 +1,7 @@ +--- +title: SIP-NN - Uncluttering Abuse of Match +status: under-review +pull-request-number: 37 +stage: design + +--- diff --git a/_sips/sips/uncluttering-scalas-syntax-for-control-structures.md b/_sips/sips/uncluttering-scalas-syntax-for-control-structures.md new file mode 100644 index 0000000000..a4c9d95a95 --- /dev/null +++ b/_sips/sips/uncluttering-scalas-syntax-for-control-structures.md @@ -0,0 +1,6 @@ +--- +title: SIP-12 - Uncluttering Scala’s syntax for control structures. +status: rejected +pull-request-number: 12 + +--- diff --git a/_sips/sips/unsigned-integers.md b/_sips/sips/unsigned-integers.md new file mode 100644 index 0000000000..4cfa9995db --- /dev/null +++ b/_sips/sips/unsigned-integers.md @@ -0,0 +1,6 @@ +--- +title: SIP-26 - Unsigned Integers +status: rejected +pull-request-number: 27 + +--- diff --git a/_sips/sips/2012-01-30-value-classes.md b/_sips/sips/value-classes.md similarity index 97% rename from _sips/sips/2012-01-30-value-classes.md rename to _sips/sips/value-classes.md index 35ad090bc1..48ad643281 100644 --- a/_sips/sips/2012-01-30-value-classes.md +++ b/_sips/sips/value-classes.md @@ -1,15 +1,16 @@ --- layout: sip title: SIP-15 - Value Classes - -vote-status: complete -vote-text: This SIP has already been accepted and completed. There has been concern for numerical computing. We think future SIP(s), using work from SIP-15, can provide more benefit to numerical computing users. The SIP as it exists benefits all users of implicit enrichment classes, and takes us much further to unboxed high performance code. This SIP does not exclude further work towards improving numerical computing in Scala. +stage: completed +status: shipped permalink: /sips/:title.html redirect_from: /sips/pending/value-classes.html --- **By: Martin Odersky and Jeff Olson and Paul Phillips and Joshua Suereth** +> Note from the SIP Committee: we think future SIP(s), using work from SIP-15, can provide more benefit to numerical computing users. The SIP as it exists benefits all users of implicit enrichment classes, and takes us much further to unboxed high performance code. This SIP does not exclude further work towards improving numerical computing in Scala. + ## History | Date | Version | From 47b603280832781956bec82dc629346afbd02986 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Fri, 3 Jun 2022 17:27:17 +0200 Subject: [PATCH 1911/3075] Update website to new SIP data and process --- _data/sip-data.yml | 42 +++- _layouts/sip.html | 29 ++- _layouts/sips.html | 15 +- _sass/layout/sips.scss | 65 +---- _sips/all.md | 127 ++++++---- _sips/index.md | 29 ++- _sips/process-specification.md | 315 +++++++++++++++++++++++ _sips/sip-submission.md | 331 ------------------------- _sips/sip-template.md | 117 --------- _sips/sip-tutorial.md | 109 +++++--- resources/images/sip/process-chart.png | Bin 0 -> 128555 bytes resources/images/sip/sip-stages.png | Bin 0 -> 41319 bytes 12 files changed, 543 insertions(+), 636 deletions(-) create mode 100644 _sips/process-specification.md delete mode 100644 _sips/sip-submission.md delete mode 100644 _sips/sip-template.md create mode 100644 resources/images/sip/process-chart.png create mode 100644 resources/images/sip/sip-stages.png diff --git a/_data/sip-data.yml b/_data/sip-data.yml index 6a6b19fe68..0a351b24da 100644 --- a/_data/sip-data.yml +++ b/_data/sip-data.yml @@ -1,27 +1,47 @@ +design: + color: "#839496" + text: "Design" + +implementation: + color: "#839496" + text: "Implementation" + +submitted: + color: "#2aa198" + text: "Submitted" + under-review: color: "#b58900" text: "Under Review" -pending: +vote-requested: color: "#b58900" - text: "Pending" - -dormant: - color: "#839496" - text: "Dormant" + text: "Vote Requested" -under-revision: - color: "#2aa198" - text: "Under Revision" +waiting-for-implementation: + color: "#b58900" + text: "Waiting for Implementation" accepted: color: "#859900" text: "Accepted" -complete: +shipped: color: "#859900" - text: "Complete" + text: "Shipped" rejected: color: "#dc322f" text: "Rejected" + +withdrawn: + color: "#839496" + text: "Withdrawn" + +accept: + color: "#859900" + text: "Accept" + +reject: + color: "#dc322f" + text: "Reject" diff --git a/_layouts/sip.html b/_layouts/sip.html index 3d778db55e..688adf4d46 100644 --- a/_layouts/sip.html +++ b/_layouts/sip.html @@ -14,19 +14,32 @@
      - {% if page.vote-status %} -
      SIP Committee Decision
      -
      {{ site.data.sip-data[page.vote-status].text }}
      -

      - {% if page.vote-text %}{{ page.vote-text }}{% endif %} -

      - {% endif %} +
      Status
      + {% if page.stage == "implementation" %} +

      + This proposal has been accepted by the committee. + {% if page.status == "waiting-for-implementation" %} + An implementation is welcome in the compiler. + {% else %} + It might be available as an experimental feature in the latest version of the compiler. + {% endif %} +

      + {% else if page.stage == "completed" %} +

      + This proposal has been implemented, + {% if page.status == "accepted" %} + it will be available in the next minor release of the compiler. + {% else if page.status == "shipped" %} + it is available in the latest version of the compiler. + {% endif %} +

      + {% endif %}
      SIP Contents
      -
      Problem with this page?
           Please help us fix it!
      +
      Problem with this page?
           Please help us fix it!
      diff --git a/_layouts/sips.html b/_layouts/sips.html index de3535a24e..d2483df2b2 100644 --- a/_layouts/sips.html +++ b/_layouts/sips.html @@ -17,17 +17,8 @@
      Scala Improv -
      SIP/SPP Meetings
      +
      SIP Meetings
      -
      -
      Next meeting:
      -
        Live
      -
      -
      - Tune in and join us, live! Ask the SIP committee questions, weigh in, or just follow along. -
      Watch → -
      -
      -
      Writing a SIP
      +
      Submitting a SIP
      Problem with this page?
           Please help us fix it!
      diff --git a/_sass/layout/sips.scss b/_sass/layout/sips.scss index 631c07762c..7fa2d5114e 100644 --- a/_sass/layout/sips.scss +++ b/_sass/layout/sips.scss @@ -103,41 +103,29 @@ .sips { - .pending, - .completed, - .dormant, - .rejected { - .date { - display: block; - font-size: $font-size-small; - text-transform: uppercase; - font-weight: $font-bold; - color: $base-font-color-light; - margin-top: 4px; - } + .sip-list { strong { font-weight: $font-black; + display: block; + } + + .no-fragmentation { + break-inside: avoid; } .tag { float: left; - position: relative; display: block; - top: 3px; color: #fff; text-transform: uppercase; font-size: 11px; font-weight: 700; padding: 1px 5px; + margin-left: 1px; + margin-top: 1px; } - } - .pending { - display: flex; - // flex-direction: column; - // flex-wrap: wrap; - // max-height: 400px; ul { list-style: inside disc; -webkit-column-count: 2; /* Chrome, Safari, Opera */ @@ -163,41 +151,4 @@ } } - .other-sips { - @include display(flex); - @include flex-direction(row); - @include flex-wrap(wrap); - @include justify-content(space-between); - - .completed, - .dormant, - .rejected { - display: flex; - flex-direction: column; - // justify-content: flex-end; - position: relative; - flex: 0 1 calc(50% - 1em); - - @include bp(medium) { - flex: 0 1 calc(100% - 0.5em); - } - - ul { - // padding-left: 0px; - - li { - // margin-left: 1em; - padding-bottom: 24px; - line-height: 1; - } - - a { - color: $gray-darker; - &:hover { - color: $brand-primary; - } - } - } - } - } } diff --git a/_sips/all.md b/_sips/all.md index 8133c137af..befff8ec61 100644 --- a/_sips/all.md +++ b/_sips/all.md @@ -7,65 +7,92 @@ redirect_from: - "/sips/pending/index.html" --- +{% assign sips = site.sips | sort: title %} +{% assign sipData = site.data.sip-data %} + +## Pre-SIP Discussions + +You can find so-called “pre-SIP discussions” in the Scala Contributors forum, under +the category [Scala Improvement Process](https://contributors.scala-lang.org/c/sip/13). +The goal of pre-SIP discussions is to gather initial community feedback and support. ## Pending SIPs -
      +Proposals that are at the design or implementation stage, and that are actively +discussed by the committee and the proposals’ authors. Click on a proposal to +read its content, or the corresponding discussions on GitHub if its design has +not been accepted yet. + +
        - {% assign sips = site.sips | sort: date | reverse %} {% for sip in sips %} - {% if sip.vote-status == "under-review" or sip.vote-status == "pending" or sip.vote-status == "under-revision" %} -
      • - {{ sip.title }} -
        {{ sip.date | date: '%B %Y' }}
        -
        {{ site.data.sip-data[sip.vote-status].text }}
        + {% if sip.stage == "design" or sip.stage == "implementation" %} +
      • + + + {{ sip.title }} + + +
        Stage: {{ sipData[sip.stage].text }}
        +
        Status: {{ sipData[sip.status].text }}
        + {% if sip.recommendation %} +
        Recommendation: {{ sipData[sip.recommendation].text }}
        + {% endif %}
        • {% endif %} {% endfor %}
      -
      -
      -

      Completed

      -
        - {% for sip in sips %} - {% if sip.vote-status == "complete" or sip.vote-status == "accepted" %} -
      • - {{ sip.title }} -
        {{ sip.date | date: '%B %Y' }}
        -
        {{ site.data.sip-data[sip.vote-status].text }}
        -
        • - {% endif %} - {% endfor %} -
      -
      -
      -

      Dormant

      -
        - {% for sip in sips %} - {% if sip.vote-status == "dormant" %} -
      • - {{ sip.title }} -
        {{ sip.date | date: '%B %Y' }}
        -
        {{ site.data.sip-data[sip.vote-status].text }}
        -
        • - {% endif %} - {% endfor %} -
      -
      -
      -

      Rejected

      -
        - {% for sip in sips %} - {% if sip.vote-status == "rejected" %} -
      • - {{ sip.title }} -
        {{ sip.date | date: '%B %Y' }}
        -
        {{ site.data.sip-data[sip.vote-status].text }}
        -
        • - {% endif %} - {% endfor %} -
      -
      +## Completed SIPs + +Proposals that have been implemented in the compiler and that are available as a stable +feature of the compiler (shipped), or that will be available in the next minor release +of the compiler (accepted). Click on a proposal to read its content. + +
      +
        + {% for sip in sips %} + {% if sip.stage == "completed" %} +
      • + {{ sip.title }} +
        {{ sipData[sip.status].text }}
        +
        • + {% endif %} + {% endfor %} +
      +
      + +## Rejected SIPs + +Proposals that have been rejected by the committee. Click on a proposal to read the +corresponding discussions on GitHub. + +
      +
        + {% for sip in sips %} + {% if sip.status == "rejected" %} +
      • + {{ sip.title }} +
        • + {% endif %} + {% endfor %} +
      +
      + +## Withdrawn SIPs + +Proposals that have been withdrawn by their authors. Click on a proposal to read the +corresponding discussions on GitHub. + +
      +
        + {% for sip in sips %} + {% if sip.status == "withdrawn" %} +
      • + {{ sip.title }} +
        • + {% endif %} + {% endfor %} +
      diff --git a/_sips/index.md b/_sips/index.md index 99c3a5264a..87dc975d0c 100644 --- a/_sips/index.md +++ b/_sips/index.md @@ -3,24 +3,17 @@ layout: sips title: Scala Improvement Process --- - -Two separate processes govern changes to Scala: - -1. The **Scala Improvement Process** (SIP) covers changes to the Scala +The **Scala Improvement Process** covers changes to the Scala language, the Scala compiler, and the core of the Scala standard library. -2. The **Scala Platform Process** (SPP) aims to establish a stable -collection of libraries suitable for widespread use, with a low barrier -to entry for newcomers. - -## Scala Improvement Process (SIP) +## Scala Improvement Process -The **SIP** (_Scala Improvement Process_) is a process for submitting +The _Scala Improvement Process_ is a process for submitting changes to the Scala language. This process aims to evolve Scala openly and collaboratively. -The SIP process covers the Scala language and compiler and the core of +The process covers the Scala language and compiler and the core of the Scala standard library. (The core is anything that is unlikely to be spun off into a separate module.) @@ -28,14 +21,20 @@ A proposed change requires a design document, called a Scala Improvement Proposal (SIP). The SIP committee meets monthly to discuss, and eventually vote upon, proposals. -A SIP is subject to a [review process](./sip-submission.html). +A SIP is subject to a [review process]({% link _sips/process-specification.md %}). Proposals normally include proposed changes to the -[Scala language specification](https://www.scala-lang.org/files/archive/spec/2.12/). +[Scala language specification](https://www.scala-lang.org/files/archive/spec/2.13/). Before reaching the committee, a proposal normally receives community discussion and review on the [Scala Contributors](https://contributors.scala-lang.org/) forum. -Please read [Submitting a SIP](./sip-submission.html) and our -[SIP tutorial](./sip-tutorial.html) for more information. +Please read the [SIP tutorial]({% link _sips/sip-tutorial.md %}) or +[the process specification]({% link _sips/process-specification.md %}) for more +information. + +The aim of the Scala Improvement Process is to apply the openness and +collaboration that have shaped Scala's documentation and implementation to the +process of evolving the language. The linked documents capture our guidelines, +commitments and expectations regarding this process. > Historical note: The SIP replaces the older SID (Scala Improvement Document) process. > Completed SID documents remain available in the diff --git a/_sips/process-specification.md b/_sips/process-specification.md new file mode 100644 index 0000000000..9e8cc0beee --- /dev/null +++ b/_sips/process-specification.md @@ -0,0 +1,315 @@ +--- +layout: sips +title: Process Specification +redirect_from: /sips/sip-submission.html +--- + +The Scala Improvement Process (sometimes called SIP process) is a process for +submitting changes to the Scala language. This process aims to evolve Scala +openly and collaboratively. + +The SIP process covers the Scala language (syntax, type system and semantics) +and the core of the Scala standard library. The core is anything that is +referenced from the language spec (such as primitive types or the definition +of `Seq`). The SIP process is not concerned with compiler changes that do not +affect the language (including but not limited to linting warnings, +optimizations, quality of error messages). + +A proposed change requires a design document, called a Scala Improvement +Proposal (SIP). The committee meets monthly to discuss, and eventually vote +upon, proposals. + +The committee follows the following process when evaluating SIP documents, +from an idea to the inclusion in the language. + +## Definitions + +- SIP (Scala Improvement Proposal): a particular proposal for changing the Scala + language (additions, changes, and/or removals). +- Committee: a group of experienced Scala practitioners and language designers, + who evaluate changes to the Scala programming language. It consists of a + Chairperson and Members. +- Chairperson: person in charge of executing the process. They organize and + chair the meetings of the Committee, and generally make sure the process is + followed, but do not vote on proposals. The Chairperson is an appointed + employee of the Scala Center. +- Committee Member: member of the Committee with voting rights. The Chairperson + cannot be a Member at the same time. +- SIP Author: any individual or group of people who writes a SIP for submission + to the Committee. The Chairperson and Committee Members may also be SIP Authors. + Authors are responsible for building consensus within the community and + documenting dissenting opinions before the SIP is officially discussed by the + SIP Committee. Their goal is to convince the committee that their proposal is + useful and addresses pertinent problems in the language as well as interactions + with already existing features. Authors can change over the life-cycle of the + SIP. +- SIP Reviewers: a subset of Committee Members assigned by the Chairperson to + review in detail a particular SIP. The same person cannot be both a SIP Author + and a SIP Reviewer for the same SIP. + +## Stages + +From being an idea to being part of the language, a SIP goes through several +Stages that indicate the "maturity" level of the SIP. The following table +summarizes the intent of the various stages. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      StagePurposeEntry criteriaPost-entry changes expected
      Pre-SIPGather initial community feedback and support.N/A. Opening a "Pre-SIP" post on the Scala Contributors forum can be done by anyone at any timeN/A
      DesignMake the case for the proposal. Make the design of the feature precise. Evaluate the solution among other possible solutions. Identify potential challenges.Community support was demonstrated in the Pre-SIP forum post. This is loosely defined.Major changes expected.
      ImplementationProvide an Experimental implementation of the changes in the compiler. Evaluate how they hold up in practice. Get feedback from implementers and users.The SIP contains a precise specification for the changes and how they should interact with the rest of the language.
      + The Committee votes in favor of the SIP to be "Accepted for implementation".      		Minor changes based on feedback from implementers and early users.
      CompletedShip the feature. Once accepted, the feature will ship as stable in the next Minor release of the Scala language.A complete implementation, with tests, was merged in the mainline compiler and shipped as Experimental. Implementers do not have any concerns left wrt. the implementation of the feature and its interactions.
      + The Committee votes in favor of the SIP to be "Accepted".      		No changes allowed.
      + +### The process in one graph + +![](/resources/images/sip/process-chart.png) + +### Pre-SIP Stage + +To initiate a discussion, any individual opens a "Pre-SIP" post in the Scala +Contributors forum. The post should be in the +[Scala Improvement Process](https://contributors.scala-lang.org/c/sip/13) +category, and its title should start with "Pre-SIP:". The purpose of the Pre-SIP +post is to present an idea to the Scala community: a Pre-SIP should present a +problem that needs solving (i.e., motivate the changes) and present possible +solutions with pros and cons. The community is encouraged to engage in the +discussions by voicing support, comments and concerns. + +During the Pre-SIP stage, the Committee is not required to be involved. +Committee Members and the Chairperson are expected to follow Pre-SIP +discussions, but not required to engage. + +Once at least one month has passed and the author has built some community +support for their Pre-SIP, they can Submit a SIP for discussion by the +Committee. "Community support" is loosely defined. It involves a mix of positive +comments, likes, etc. Generally, the Chairperson or a Committee member will post +a comment on the thread suggesting to submit a SIP when they see that a Pre-SIP +is ready to enter the process. + +### Entry into the process (SIP Submission) + +To submit a SIP, a SIP Author writes a pull request to the +[scala/improvement-proposals](https://github.com/scala/improvement-proposals) +repository, following the [tutorial]({% link _sips/sip-tutorial.md %}), and +pointing to the Pre-SIP discussion. If the proposal correctly follows the +template, and the Pre-SIP discussion seems to show some community support, +the Chairperson will accept the SIP for review, assign a SIP number, and assign +3 reviewers to the SIP among the Committee Members. Since "community support" is +loosely defined, any Committee Member can also comment on the PR to accept the +SIP for review (this is meant mostly as an escape hatch to prevent the +Chairperson from unilaterally blocking a SIP from entering the process). From +that point onwards, the SIP has entered the Design Stage. + +If the template has not been correctly followed, or if none of the Committee +Members nor the Chairperson think that the Pre-SIP has gathered enough support, +the PR may be closed after 2 weeks. + +### PR states and GitHub labels + +As soon as a SIP PR is opened, the GitHub labels `stage:pre-sip` and +`status:submitted` are applied to it. At any given moment, a SIP PR will have as +labels one of the following possibilities: + +| | | | +|------------------------|-------------------------------------|-------------------------| +| `stage:pre-sip` | `status:submitted` | | +| `stage:design` | `status:under-review` | | +| `stage:design` | `status:vote-requested` | `recommendation:accept` | +| `stage:design` | `status:vote-requested` | `recommendation:reject` | +| `stage:implementation` | `status:waiting-for-implementation` | | +| `stage:implementation` | `status:under-review ` | | +| `stage:implementation` | `status:vote-requested` | `recommendation:accept` | +| `stage:implementation` | `status:vote-requested` | `recommendation:reject` | +| `stage:completed` | `status:accepted` | | +| `stage:completed` | `status:shipped` | | +| | `status:rejected` | | +| | `status:withdrawn` | | + +### Design Stage -- Review + +Once a SIP has entered the Design Stage, the assigned reviewers will review (as +a GitHub Review on the SIP PR) the proposal within 3 weeks. The authors may then +address the concerns by pushing additional commits and ask for a new review. +This phase is iterative, like any pull request to an implementation repository. +After each request for a new review, the reviewers have 3 weeks to do another +round. + +When the reviewers are confident that the SIP is in good shape to be discussed +with the full Committee, they set its status to "Vote Requested" and decide on a +Vote Recommendation that they will bring to the Committee. A Vote Recommendation +is either "Recommend Accept" or "Recommend Reject". The proposal is then +scheduled on the agenda of the next Committee meeting (which happens once a +month). + +At any time, the SIP Author may voluntarily Withdraw their SIP, in which case it +exits the process. It is possible for someone else (or the same person) to +become the new SIP Author for that SIP, and therefore bring it back to the +process. If a SIP Author does not follow up on Reviewers' comments for 2 months, +the SIP will automatically be considered to be Withdrawn. + +### Design Stage -- Vote + +During the Committee meeting, the reviewers of any scheduled SIP present the SIP +to the Committee, their recommendation, and explain why they made that +recommendation. After discussion, the Committee votes for advancing the SIP to +the Implementation Stage. There are three possible outcomes: + +- Accept for implementation: the proposal then advances to the Implementation + Stage, and therefore becomes a formal recommendation to be implemented as an + Experimental feature into the compiler. +- Reject: the proposal is rejected and the PR closed. It exits the process at + this point. The reviewers will communicate on the PR the reason(s) for the + rejection. +- Keep: the proposal remains in the Design Stage for further iterations. The + reviewers will communicate on the PR the current concerns raised by the + Committee. + +In order to be accepted for implementation and advance to the next stage, a SIP +must gather strictly more than 50% of "Advance" votes among the members present +(this means that an abstention is equivalent to "Do not advance" for this +purpose, biasing the process in favor of the status quo). The PR for the SIP is +then also Merged at this point. + +If there was no strict majority in favor of "Advance", a second vote between +Reject and Keep will be used. A proposal needs more than 50% "Reject" votes to +be rejected in that case. Otherwise, it is kept. + +### Implementation Stage + +Once in the implementation stage, the Committee is not concerned with the SIP +anymore, until new concerns are discovered or until the implementation is ready. +The SIP is now a recommendation for the compiler team or any other individual or +group of people to provide an implementation of the proposal, as a pull request +to the Scala 3 compiler repository. There is no set timeline for this phase. + +An implementation will be reviewed by the compiler team, and once the +implementation is deemed good enough, it can ship as an Experimental feature in +the following practical release of the compiler. + +The implementers may hit challenges that were not foreseen by the Committee. +Early users may also provide feedback based on practical experience with the +Experimental feature. This feedback can be sent back to the Committee by +implementers. This is done with a PR to the SIP repository, amending the +previously merged SIP document or raising questions for challenges. In that +case, the SIP Author and Reviewers will work together with the implementers to +address the feedback. This is again an iterative process. Reviewers may merge +changes to the proposal at their discretion during this phase. + +Once the implementation is deemed stable, including appropriate tests, the +implementers and reviewers can schedule the SIP to the next Committee meeting +for final approval. Once again, a SIP needs to gather strictly more than 50% +"Accept" votes to be Completed. If that is not achieved, it may likewise be sent +back for refinements, or be rejected, with the same rules as in the "Design +Stage -- Vote" section. + +### Completed Stage + +Once a SIP is accepted for shipping, it will be enabled by default (as +non-Experimental) in the next practical Minor release of the language. + +From this point onwards, the feature is stable and cannot be changed anymore. +Any further changes would have to come as an entirely new SIP. + +## The SIP Committee + +The current committee members are: + +- Martin Odersky ([@odersky](https://github.com/odersky)), EPFL +- Sébastien Doeraene ([@sjrd](https://github.com/sjrd)), Scala Center + +The current Chairperson is: + +- Julien Richard-Foy ([@julienrf](https://github.com/julienrf)), Scala Center + + +### Committee Meetings + +The plenary Committee Meetings are scheduled monthly by the Chairperson. They +have the following purposes: + +- Vote to accept, keep or reject SIPs that are in a "Vote Requested" state +- Be aware of the list of SIPs that are "Under review". If a SIP stays too long + under review, Committee Members may request for it to be put to discussion + and/or vote in a subsequent plenary meeting, even if the Reviewers do not + think it is ready. This is meant primarily as an escape hatch, preventing + Reviewers from blocking a SIP by infinitely stalling it. +- Make any exception to the process that they judge necessary to unblock a + situation. + +### Responsibilities of the Committee Members + +- Review the proposals they are assigned to: + 1. Discuss unclear points with the authors, + 2. Help them address their issues and questions, + 3. Provide them feedback from the discussions in the meetings, and + 4. Explain the latest progress in every meeting. +- Play a role in the discussions, learn in advance about the topic if needed, + and make up their mind in the voting process. + +### Guests + +Experts in some fields of the compiler may be invited to concrete meetings as +guests when discussing related SIPs. Their input would be important to discuss +the current state of the proposal, both its design and implementation. + +### On what basis are proposals evaluated? + +The Committee ultimately decides how to evaluate proposals, and on what grounds. +The Committee does not need to justify its decisions, although it is highly +encouraged to provide reasons. + +Nevertheless, here is a non-exhaustive list of things that the Reviewers and +Committee are encouraged to take into account: + +- The proposal follows the "spirit" of Scala +- The proposal is well motivated; it solves a recurring problem +- The proposal evaluates the pros and cons of its solution; the solution put + forward is believed to be the best one +- The proposal can be implemented in a way that does not break backward binary + nor TASTy compatibility +- The proposal makes an effort not to break backward source compatibility +- The proposal does not change the meaning of existing programs +- The proposal can be implemented on all major platforms (JVM, JS and Native) + +## Exceptions and changes + +The present document tries to account for most situations that could occur in +the lifetime of SIPs. However, it does not pretend to be an ultimate solution to +all cases. At any time, the Committee can decide, by consensus, to make +exceptions to the process, or to refine the process. + +## How do I submit? + +Follow the [submission tutorial]({% link _sips/sip-tutorial.md %}). diff --git a/_sips/sip-submission.md b/_sips/sip-submission.md deleted file mode 100644 index 4d9ae53a40..0000000000 --- a/_sips/sip-submission.md +++ /dev/null @@ -1,331 +0,0 @@ ---- -layout: sips -title: SIP Specification and Submission ---- - -A **SIP** (_Scala Improvement Process_) is a process for submitting changes to -the Scala language. Its main motivation is to become the primary mechanism to -propose, discuss and implement language changes. In this process, all changes to -the language go through design documents, called Scala Improvement Proposals -(SIPs), which are openly discussed by a committee and only upon reaching a -consensus are accepted to be merged into the Scala compiler. - -The aim of the Scala Improvement Process is to apply the openness and -collaboration that have shaped Scala's documentation and implementation to the -process of evolving the language. This document captures our guidelines, -commitments and expectations regarding this process. - -## Why write a SIP? - -SIPs are key to making Scala better for the good of everyone. If you decide to -invest the time and effort of putting a SIP forward and seeing it through, your -efforts and time will shape and improve the language, which means that your -proposal may impact the life of a myriad of developers all over the world, -including those on your own team. For many, this aspect alone can be quite -worthwhile. - -However, it's important to note that seeing a SIP through to its conclusion is -an involved task. On the one hand, it takes time to convince people that your -suggestions are a worthwhile change for hundreds of thousands of developers to -accept. Particularly given the sheer volume of developers that could be affected -by your SIP, SIP acceptance is conservative and carefully thought through. -Typically, this includes many rounds of discussion with core Scala maintainers -and the overall community, several iterations on the design of the SIP, and some -effort at prototyping the proposed change. Often, it takes months of discussion, -re-design, and prototyping for a SIP to be accepted and included in the Scala -compiler. It is, therefore important to note that seeing a SIP through to its -conclusion can be time-consuming and not all SIPs may end up in the Scala -compiler, although they may teach us all something! - -If you’re motivated enough to go through this involved but rewarding process, go -on with writing and keep on reading. - -## What's the process for submitting a SIP? - -There are four major steps in the SIP process: - -1. Initial informal discussion (2 weeks) -2. Submission -3. Formal presentation (up to 1 month) -4. Formal evaluation (up to 6 months) - -### Initial informal discussion (2 weeks) - -Before submitting a SIP, it is required that you perform necessary preparations: - -Discuss your idea on the [Scala Contributors Page](https://contributors.scala-lang.org/) (we suggest -posting in the category -[Scala Improvement Process](https://contributors.scala-lang.org/c/sip)). -Create a topic that starts with “Pre-SIP” and briefly -describe what you would like to change and why you think it’s a good idea. - -Proposing your ideas on the mailing list is not an optional step. For every -change to the language, it is important to gauge interest from the compiler -maintainers and the community. Use this step to promote your idea and gather -early feedback on your informal proposal. It may happen that experts and -community members may have tried something similar in the past and may offer -valuable advice. - -Within two weeks after your submission of the pre-SIP to the mailing list, the -Process Lead will intervene and advise you whether your idea can be submitted as -a SIP or needs more work. - -### Submission - -After receiving the green light from the Process Lead, you can write up your -idea and submit it as a SIP. - -A SIP is a Markdown document written in conformance with the [process template](https://github.com/scala/docs.scala-lang/blob/main/_sips/sip-template.md). -It ought to contain a clear specification of the proposed changes. When such -changes significantly alter the compiler internals, the author is invited to -provide a proof of concept. Delivering a basic implementation can speed up the -process dramatically. Even compiler hackers find very difficult to predict the -interaction between the design and the implementation, so the sooner we have an -evidence of a working prototype that interacts with all the features in Scala, -the better. Otherwise, committee members may feel that the proposed changes are -impossible and automatically dismiss them. If your changes are big or somewhat -controversial, don’t let people hypothesize about them and show results upfront. - -A SIP is submitted as a pull request against [the official Scala website -repo](https://github.com/scala/docs.scala-lang). Within a week of receiving the -pull request, the Process Lead will acknowledge your submission, validate it and -engage into some discussions with the author to improve the overall quality of -the document (if necessary). - -When you and the Process Lead agree on the final document, it is formally -accepted for review: assigned a reviewer and scheduled for formal presentation. - -### Formal presentation (up to 1 month) - -During the next available SIP Committee meeting, the appointed reviewer presents -the SIP to the committee and kick starts the initial discussion. - -If the committee agrees that following through the SIP is a good idea, then the -following happens: - -1. The SIP is assigned a number. -2. The SIP pull request is merged into the official Scala website repo, and the -merged document becomes the official webpage of the proposal. -3. An issue to discuss the SIP is opened at the official Scala website repo. Then, -the reviewer submits the initial feedback from the committee. -4. An implementation is requested (if not already present). - -Otherwise, the SIP is rejected. The reviewer submits the collected feedback as a -comment to the pull request, and the pull request is closed. - -### Formal evaluation (up to 6 iterations) - -Evaluation of a SIP is done in iterations. The maximum number of iterations is -six. These iterations take place in the SIP meetings and are usually monthly. -However, they can last longer, in which case the author has more time to -implement all the required changes. - -The committee decides the duration of the next iteration depending upon the -feedback and complexity of the SIP. Consequently, authors have more time to -prepare all the changes. If they finish their revision before the scheduled -iteration, the Process Lead will reschedule it for the next available meeting. - -During every iteration, the appointed reviewer presents the changes (updated -design document, progress with the implementation, etc) to the SIP Committee. -Based on the feedback, the SIP is either: - -1. Accepted, in which case the committee asks the compiler maintainers to - indicate the earliest version of Scala that can include the language change. -2. Rejected, in which case the SIP is closed and no longer evaluated in the - future. -3. Under revision, in which case the author needs to continue the formal - evaluation and address all the committee's feedback. Thus, the follow-up - discussion is scheduled for the next iteration. -3. Postponed, in which case the committee does not evaluate the proposal anymore - and sets it aside under some conditions are met. Then, the SIP will be - resubmitted. This situation happens when proposals entirely depend on another - pending proposals and need their admission. In such cases, the dependent - proposal is postponed until the Committee votes on the other one. - -If no changes have been made to a SIP in two iterations, it’s marked as dormant -and both the PR and issue are closed. Dormant SIPs can be reopened by any -person, be it the same or different authors, at which point it will start from -the formal evaluation phase. - -### Merging the proposal - -If the SIP is accepted, the committee will propose a release date to -the compiler maintainers, where the role of the committee ends. -(Compiler maintainers may choose to merge changes under a flag -initially, for testing, or directly, as they deem appropriate, -taking committee and community feedback into consideration.) - -## Structure of the process - -The SIP process involves the following parties: - -1. The SIP Author(s) -2. The Process Lead -3. The SIP Committee - -### The SIP Author(s) - -Authors are responsible for building consensus within the community and -documenting dissenting opinions before the SIP is officially discussed by the -SIP Committee. Their goal is to convince the committee that their proposal is -useful and addresses pertinent problems in the language as well as interactions -with already existing features. Authors can change over the life-cycle of the -SIP. - -### The Process Lead - -The Process Lead is the responsible of the smooth running of SIPs and SLIPs. He -or she appoints the committee members, calls the meetings monthly, assigns new -proposals to the members, and ensures that all of them are discussed within a -short period of time. - -### The SIP Committee - -The SIP Committee is an experienced group of people with knowledge of the -compiler internals, responsible for the strategic direction of Scala. Members -are tasked with (a) communicating with the community, (b) weighing in pros and -cons of every proposal, and (c) accepting, postponing or rejecting the proposal. - -Committee members should be either individuals responsible for a specific part -of the Scala codebase, committers or contributors of the Scala compiler. -Exceptionally, members may also be important representatives of the community -with a high technical knowledge to understand the implications of every proposal -and participate into the discussions. New members are elected by existing -members of the SIP Committee, based on their expertise and involvement in the -community. - -The current committee members are: - -- Martin Odersky ([@odersky](https://github.com/odersky)), EPFL -- Adriaan Moors ([@adriaanm](https://github.com/adriaanm)), Lightbend -- Guillaume Martres ([@smarter](https://github.com/smarter)), EPFL -- Heather Miller ([@heathermiller](https://github.com/heathermiller)), Carnegie Mellon University -- Iulian Dragos ([@dragos](https://github.com/dragos)), Triplequote -- Josh Suereth ([@jsuereth](https://github.com/jsuereth)), Google -- Miles Sabin ([@milessabin](https://github.com/milessabin)), independent -- Seth Tisue ([@SethTisue](https://github.com/SethTisue)), Lightbend -- Sébastien Doeraene ([@sjrd](https://github.com/sjrd)), Scala Center - -The current Process Lead is: - -- Darja Jovanovic ([@darjutak](https://github.com/darjutak)), Scala Center - -### Reviewers - -The Process Lead assigns every proposal to a member of the committee, who -becomes the reviewer. The main tasks of the reviewer are the following: - -1. Discuss unclear points with the authors, -2. Help them address their issues and questions, -3. Provide them feedback from the discussions in the meetings, and -4. Explain the latest progress in every meeting. - -### SIP meetings - -SIP meetings are scheduled monthly by the Process Lead, and require a quorum of -two-thirds (2/3) of the committee members. If the quorum is not reached the -meeting is rescheduled. - -### Voting - -All SIP Committee members vote. They can either vote in the meeting or by -casting their vote via email to the SIP Process Lead before the set deadline. - -SIP Committee members can vote "in favor", "against" or "abstain". - -For a SIP to be accepted, the following three requirements must be met: - -- At least 50% of the committee members vote in favor. -- There are at least two-thirds "in favor" versus "against" votes. -- Martin Odersky does not veto it. - -An alternative way to think of the two-thirds requirement is that the number of -votes in favor must be at least twice the number of votes against. Abstentions -are excluded in calculating a two-thirds vote. - -Note that, when calculating the lower bound, numbers round up. Therefore for a -committee of 9 members, at least 50% means at least 5 members. - -The deadline to vote a proposal is decided on a case-by-case basis. The deadline -will be decided by the committee members present at the last meeting and the SIP -Process Lead, and will be made public right after the meeting. - -#### Examples - -Several voting situations are explained next. - -All of them assume that there are 9 committee members. The 50% requirement -requires at least 5 members to vote in favor. We also assume that Martin does -not veto them. - -| In favor | Against | Abstentions | Voting members | Result | -| -------- | ------- | ----------- | -------------- | ------------ | -| 6 | 2 | 1 | 8 | Accepted | -| 5 | 3 | 1 | 8 | Not Accepted | -| 5 | 2 | 2 | 7 | Accepted | - -In the first situation, the proposal is accepted because 6 is both greater than -the 50% (5) and more than twice the votes against (2). In the second situation, -the proposal meets the 50% requirement but fails the two-thirds requirement -since 5 is less than twice the number of votes against, 3, therefore the -proposal is not accepted. In the third situation, the proposal is accepted -because 5 is equal to 50% of all the committee members and is greater than twice -the number of votes against (2). - -### Responsibilities of the members - -- Review the proposals they are assigned to. The Process Lead will always notify -them two weeks in advance, at minimum. -- Play a role in the discussions, learn in advance about the topic if needed, and -make up their mind in the voting process. -- Decide which utilities should be inside the core module and are required by the -compiler. The goal is to shrink it over time, and, where possible, move modules -to the platform, that will be managed by the SLIP process. - -### Guests - -Experts in some fields of the compiler may be invited to concrete meetings as -guests when discussing related SIPs. Their input would be important to discuss -the current state of the proposal, both its design and implementation. - -## Proposal states - -The state of a proposal changes over time depending on the phase of the process -and the decisions taken by the committee. A given proposal can be in one of -several states: - -1. **Validated:** The Process Lead has validated the proposal and checked that -meets all the formal requirements. -2. **Numbered:** The committee agrees that the proposal is a valid document and -it’s worth considering it. Then, the Process Lead gives it a number. -3. **Awaiting review:** The proposal has been scheduled to be reviewed for a -concrete date. -4. **Under review:** Once the author has delivered a new version, the proposal will -be under review until the next available SIP meeting takes place. -5. **Under revision:** Authors are addressing the issues pinpointed by the -committee or working on the implementation. -6. **Dormant:** When a SIP has been under revision for more than two iterations - and no progress has been made, the Process Lead will mark it as dormant (note - that the committee does not have such privilege). This status means that the - Process Lead will not assign its review in future meetings until authors - provide the requested feedback or progress. Also, authors can also mark their - proposals as dormant, and they are encouraged to do so if they think they - will not have time for their update. -7. **Postponed:** The SIP has been postponed under some concrete conditions. When these -are met, the SIP can be resubmitted. -8. **Rejected:** The SIP has been rejected with a clear and full explanation. -9. **Accepted:** The SIP has been accepted and it’s waiting for the merge into the -Scala compiler. - -## How do I submit? ## - -The process to submit is simple: - -* Fork the Scala documentation repository, [https://github.com/scala/docs.scala-lang](https://github.com/scala/docs.scala-lang). -* Create a new SIP file in the `_sips/sips/`. Use the [S(L)IP template](https://github.com/scala/docs.scala-lang/blob/main/_sips/sip-template.md) - * Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Use the proposal date for `YYYY-MM-dd`. - * Use the [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax) to write your SIP. - * Follow the instructions in the [README](https://github.com/scala/docs.scala-lang/) to build your SIP locally so you can ensure that it looks correct on the website. -* Create a link to your SIP in the "pending sips" section of `index.md` -* Commit your changes to your forked repository -* Create a new [pull request](https://github.com/scala/docs.scala-lang/pull/new/gh-pages). This will notify the Scala SIP team. diff --git a/_sips/sip-template.md b/_sips/sip-template.md deleted file mode 100644 index 07668523a8..0000000000 --- a/_sips/sip-template.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -layout: sip -title: SIP-NN - SIP Title -#vote-status: pending <- uncomment this line -permalink: /sips/:title.html -redirect_from: /sips/pending/{filename-without-md}.html ---- - -**By: Author 1 and Author 2 and Author 3** - -This document is provided as a template to get you started. Feel free to add, augment, -remove, restructure and otherwise adapt the structure for what you need after cloning it. -The cloned document should be placed in sips/pending/_posts according to the naming -conventions described in the [SIP tutorial](./sip-tutorial.html). - -## History - -| Date | Version | -|---------------|---------------| -| Feb 19th 2015 | Initial Draft | -| Feb 20th 2015 | Alteration Details | - -## Introduction/Motivation/Abstract - -(feel free to rename this section to Introduction, Motivation, Abstract, whatever best suits - your library proposal.) - -A high level overview of the library with: - -* Description of the scope/features of the library. -* An explanation of the reason the library is needed, what's missing in the core libs - that is supplied. -* Simple code examples if they help clarify, note that there will be ample opportunity - for more detailed code examples later in the SIP - -Think of the introduction as serving to describe the library addition in a way -that lets a reader decide if this is what they are looking for, whether they think -this is the right approach to supply the extra functionality, and whether they might -want to get involved. - -## Motivating Examples - -### Examples - -Code heavy description of how the library functionality can be used. - -```scala -// here is some example scala code, highlighted nicely -import scala.concurrent._ - -class Foo extends Bar { - val x = 10 - def yo(name: String): String = s"hello $name" -} -``` - -### Comparison Examples - -Code demonstrating why the library is needed, how equivalent functionality -might be provided without it. - -### Counter-Examples - -What the library is not intended to be used for. Examples of what to avoid and -why. - -## Design - -Discuss design decisions (including, as examples): - -* Reason about correctness of the implementation. -* "Feel and fit" with existing core libraries. -* Performance and threading considerations. -* Naming of classes, traits, methods. -* Footprint of API. -* Potential conflicts with existing libraries, e.g. name clashes, IDE auto-import friction, etc. - -## Implementation - -Include consideration of the following: - -* Is this library intended to be bundled with the current core libs, or (recommended) live in -a separate module distributed with the core distribution of Scala -(e.g. parser combinators, reflection, etc.) -* **Existing implementation(s)** (e.g. donor library, github project, etc.). Note that -having an existing implementation library from which this will be drawn, and that people -can download and try now, is highly recommended. -* Time frame, target Scala version for inclusion. -* Roll-out plan (start with external module, include in std distribution, move to core). -* Other volunteers/contributors (with areas of expertise, github contact info, etc.) - -## Counter-Examples - -What the library is not intended to be used for. Examples of what to avoid and -why. - -## Drawbacks - -Why should we *not* do this. Be honest, these questions will come out during the -process anyway so it's better to get them out up front. - -## Alternatives - -* What other possibilities have been examined? -* What is the impact of not implementing this proposal? - -## References - -1. [Existing (Donor) Project][1] -2. [API Documentation][2] -3. [Academic/Research papers/supporting material][3] -4. [Alternative Libraries/Implementations][4] - -[1]: https://github.com "GitHub" -[2]: https://www.scala-lang.org/api/ "Scaladoc" -[3]: https://en.wikipedia.org/wiki/Academic_publishing "Academic/Research" -[4]: https://github.com/dogescript/dogescript "Alternatives" diff --git a/_sips/sip-tutorial.md b/_sips/sip-tutorial.md index 6103c16d94..95bb45b053 100644 --- a/_sips/sip-tutorial.md +++ b/_sips/sip-tutorial.md @@ -1,51 +1,90 @@ --- layout: sips title: Writing a new SIP +redirect_from: /sips/sip-template.html --- -This tutorial details of how to write a new SIP and adding it to the website. +This tutorial details of how to write a new Scala Improvement Proposal (SIP) and how to submit it. + +## Why write a SIP? + +SIPs are key to making Scala better for the good of everyone. If you decide to +invest the time and effort of putting a SIP forward and seeing it through, your +efforts and time will shape and improve the language, which means that your +proposal may impact the life of a myriad of developers all over the world, +including those on your own team. For many, this aspect alone can be quite +worthwhile. + +However, it's important to note that seeing a SIP through to its conclusion is +an involved task. On the one hand, it takes time to convince people that your +suggestions are a worthwhile change for hundreds of thousands of developers to +accept. Particularly given the sheer volume of developers that could be affected +by your SIP, SIP acceptance is conservative and carefully thought through. + +It is important to note that seeing a SIP through to its +conclusion can be time-consuming and not all SIPs may end up in the Scala +compiler, although they may teach us all something! + +Last, but not least, delivering a basic implementation can speed up the +process dramatically. Even compiler hackers find very difficult to predict the +interaction between the design and the implementation, so the sooner we have an +evidence of a working prototype that interacts with all the features in Scala, +the better. + +If you’re motivated enough to go through this involved but rewarding process, go +on with writing and keep on reading. + +The following sections provide an overview of the process, and guidelines on +how to submit a proposal. The detailed process specification is available +[here]({% link _sips/process-specification.md %}). + +## Overview of the process + +From being an idea to being part of the language, a SIP goes through several +*stages* that indicate the “maturity” level of the SIP. The following diagram +summarizes the purpose of each stage: + +![](/resources/images/sip/sip-stages.png) + +0. **Pre-SIP** You should start by creating a discussion thread in the + [Scala Improvement Process](https://contributors.scala-lang.org/c/sip/13) + category of the Scala Contributors forum to gather initial community feedback + and support. The title of your discussion should start with "Pre-SIP". In + this discussion, the community might bring you alternative solutions to + the problem you want to solve, or possible bad interactions with other + features of the language. Eventually, these discussions may help you polish + your proposal. +1. **Design** The next stage consists of submitting a detailed description of + your proposal for approval to the SIP Committee. See the section + [How do I submit?](#how-do-i-submit) to know the procedure and expected + format. Your proposal will first be reviewed by a small group of reviewers, + and eventually the full Committee will either approve it or reject it. +2. **Implementation** If the Committee approved your proposal, you are + welcome to provide an implementation of it in the compiler so that it can + be shipped as an experimental feature. You may hit new challenges during the + implementation of the feature, or when testing it in practice. In such a + case, you should amend the proposal, which will be reviewed again by the + reviewers from the SIP Committee. Once the implementation is deemed stable, + the full Committee will vote again on the final state of the proposal. +3. **Completed** If the Committee accepted the proposal, it will be shipped as + a stable feature in the next minor release of the compiler. The content of + the proposal may not change anymore. ## How do I submit? ## -The process to submit is simple: +The process to submit is the following: -* Fork the [Scala documentation repository](https://github.com/scala/docs.scala-lang) and clone it. -* Create a new SIP file in the `_sips/sips`. Use the [SIP template](https://github.com/scala/docs.scala-lang/blob/main/_sips/sip-template.md) - * Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Use the proposal date for `YYYY-MM-dd`. +* Fork the [Scala improvement proposals repository](https://github.com/scala/improvement-proposals) and clone it. +* Create a new branch off the `main` branch. +* Copy the [SIP template](https://github.com/scala/improvement-proposals/blob/main/sip-template.md) into the directory `content/` + * Give a meaningful name to the file (e.g., `eta-expansion-of-polymorphic-functions.md`). * Use the [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax) to write your SIP. - * Follow the instructions in the [README](https://github.com/scala/docs.scala-lang/blob/main/README.md) to build your SIP locally so you can ensure that it looks correct on the website. -* Create a link to your SIP in the "pending sips" section of `index.md`. + * The template is provided to help you get started. Feel free to add, augment, remove, restructure and otherwise adapt the structure for what you need. * Commit your changes and push them to your forked repository. -* Create a new pull request. This will notify the Scala SIP team. - - -## SIP Post Format ## - -First, create a new SIP file in the `_sips/sips` directory. Make sure the new file follows the format: `YYYY-MM-dd-{title}.md`. Where: -* `YYYY` is the current year when the proposal originated. -* `MM` is the current month (`01` = January, `12` = December) when the proposal originated. -* `dd` is the day of the month when the proposal originated. -* `{title}` is the title for the SIP. +* Create a new pull request. This will notify the Scala SIP team, which will get back to you within a couple of weeks. ### Markdown formatting ### Use the [Markdown Syntax](https://daringfireball.net/projects/markdown/syntax) to write your SIP. -If you would like a starting point, clone the [SIP Template](./sip-template.html) in -`_sips/sip-template.md` and use that. - -See the [source](https://github.com/scala/docs.scala-lang/blob/main/_sips/sip-template.md) for this document (`sip-tutorial.md`) for how to do syntax highlighting. - -```scala -class Foo -``` - - -## Testing changes ## - -Testing changes requires installing [Jekyll](https://jekyllrb.com/docs/installation/). Since this site is hosted on github pages, make sure you have [whatever version of Jekyll that github is running](https://help.github.com/articles/using-jekyll-with-pages#troubleshooting). As of the writing of this README, that is version >= 1.0.x. - -After the installation, you need to start up the local server. The -[README](https://github.com/scala/docs.scala-lang/blob/main/README.md) gives -a concise explanation on how to do it. When the server is running, view your -changes at [https://localhost:4000/sips](https://localhost:4000/sips). +See the content of the [SIP template](https://github.com/scala/improvement-proposals/blob/main/sip-template.md) as a starting point, and for various examples, including syntax highlighting of code snippets. diff --git a/resources/images/sip/process-chart.png b/resources/images/sip/process-chart.png new file mode 100644 index 0000000000000000000000000000000000000000..c647901efd33a17a02b824c24187c52effacbd3d GIT binary patch literal 128555 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

      %rn}a7CWOr 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 literal 0 HcmV?d00001 diff --git a/resources/images/sip/sip-stages.png b/resources/images/sip/sip-stages.png new file mode 100644 index 0000000000000000000000000000000000000000..981f8b8937f5f435178785cdba965de7f3472082 GIT binary patch literal 41319 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

      bLtq|A#Dx%7#+gxbVUIA_i`+?)UBL)>TL@~~GV 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 literal 0 HcmV?d00001 From 6f18e5d2c3bf28ea5c02eaa03de78df88fc911d7 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Thu, 9 Jun 2022 17:34:05 +0200 Subject: [PATCH 1912/3075] Fix dead links --- _ja/overviews/macros/blackbox-whitebox.md | 4 ++-- _overviews/macros/blackbox-whitebox.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_ja/overviews/macros/blackbox-whitebox.md b/_ja/overviews/macros/blackbox-whitebox.md index 36ceca43df..9fe6fd313e 100644 --- a/_ja/overviews/macros/blackbox-whitebox.md +++ b/_ja/overviews/macros/blackbox-whitebox.md @@ -33,7 +33,7 @@ Scala 2.11.x および Scala 2.12.x 系列では、マクロ機能が blackbox しかし、ときとして def マクロは「ただのメソッド呼び出し」という概念を超越することがある。例えば、展開されたマクロは、元のマクロの戻り値の型よりも特化された型を持つ式を返すことが可能だ。Scala 2.10 では、StackOverflow の [Static return type of Scala macros](https://stackoverflow.com/questions/13669974/static-return-type-of-scala-macros) で解説したように、そのような展開は特化された型を保持し続けることができる。 -この興味深い機能がもたらす柔軟性によって、[偽装型プロバイダ](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/)、[具現化の拡張](/sips/source-locations.html)、[関数従属性の具現化](/ja/overviews/macros/implicits.html#fundep_materialization)、抽出子マクロなどを可能とするけども、書かれたコードの明確さ (人にとってもマシンにとっても) が犠牲になるという側面がある。 +この興味深い機能がもたらす柔軟性によって、[偽装型プロバイダ](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/)、[具現化の拡張](https://github.com/scala/improvement-proposals/pull/18)、[関数従属性の具現化](/ja/overviews/macros/implicits.html#fundep_materialization)、抽出子マクロなどを可能とするけども、書かれたコードの明確さ (人にとってもマシンにとっても) が犠牲になるという側面がある。 普通のメソッド同様に振る舞うマクロと戻り値の型を細別化 (refine) するマクロという決定的な区別を明確にするために、blackbox マクロと whitebox マクロという概念を導入することにした。型シグネチャに忠実に従うマクロは、振る舞いを理解するのに実装を知る必要が無い (ブラックボックスとして扱うことができる) ため、**blackbox マクロ** (blackbox macro) と呼ぶ。 Scala の型システムを使ってシグネチャを持つことができないマクロは **whitebox マクロ** (whitebox macro) と呼ぶ。(whitebox def マクロもシグネチャは持つが、これらのシグネチャは近似値でしかない) @@ -50,7 +50,7 @@ blackbox def マクロは Scala 2.10 の def マクロと異なる扱いとな 1. blackbox マクロが構文木 `x` に展開するとき、展開される式は型注釈 `(x: T)` でラップされる。この `T` は blackbox マクロの宣言された戻り値の型に、マクロ適用時に一貫性を持つように型引数やパス依存性を適用したものとなる。これによって、blackbox マクロを[型プロバイダ](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/)のための手段としての利用は無効となる。 1. Scala の型推論アルゴリズムが終わった後でも blackbox マクロの適用に未決定の型パラメータが残る場合、これらの型パラメータは普通のメソッドと同様に強制的に型推論が実行される。これによって blackbox マクロから型推論に影響を与えることが不可能となり、[関数従属性の具現化](/ja/overviews/macros/implicits.html#fundep_materialization)に使うことが無効となる。 -1. blackbox マクロの適用が implicit の候補として使われる場合、implicit 検索がそのマクロを選択するまでは展開は実行されない。これによって [implicit マクロの入手可能性を動的に計算する](/sips/source-locations.html)ことが無効となる。 +1. blackbox マクロの適用が implicit の候補として使われる場合、implicit 検索がそのマクロを選択するまでは展開は実行されない。これによって [implicit マクロの入手可能性を動的に計算する](https://github.com/scala/improvement-proposals/pull/18)ことが無効となる。 1. blackbox マクロの適用がパターンマッチの抽出子として使われる場合、無条件でコンパイラエラーを発生するようにして、マクロで実装されたパターンマッチングのカスタマイズを無効となる。 whitebox def マクロは Scala 2.10 での def マクロ同様に動作する。一切の制限が無いため、2.10 のマクロで出来ていたことの全てが 2.11 と 2.12 でも行えるはずだ。 diff --git a/_overviews/macros/blackbox-whitebox.md b/_overviews/macros/blackbox-whitebox.md index 07c13f2aa2..4fdb9e4fd0 100644 --- a/_overviews/macros/blackbox-whitebox.md +++ b/_overviews/macros/blackbox-whitebox.md @@ -32,7 +32,7 @@ comprehensibility. However sometimes def macros transcend the notion of "just a regular method". For example, it is possible for a macro expansion to yield an expression of a type that is more specific than the return type of a macro. In Scala 2.10, such expansion will retain its precise type as highlighted in the ["Static return type of Scala macros"](https://stackoverflow.com/questions/13669974/static-return-type-of-scala-macros) article at Stack Overflow. -This curious feature provides additional flexibility, enabling [fake type providers](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/), [extended vanilla materialization](/sips/source-locations.html), [fundep materialization]({{ site.baseurl }}/overviews/macros/implicits.html#fundep-materialization) and [extractor macros](https://github.com/scala/scala/commit/84a335916556cb0fe939d1c51f27d80d9cf980dc), but it also sacrifices clarity - both for humans and for machines. +This curious feature provides additional flexibility, enabling [fake type providers](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/), [extended vanilla materialization](https://github.com/scala/improvement-proposals/pull/18), [fundep materialization]({{ site.baseurl }}/overviews/macros/implicits.html#fundep-materialization) and [extractor macros](https://github.com/scala/scala/commit/84a335916556cb0fe939d1c51f27d80d9cf980dc), but it also sacrifices clarity - both for humans and for machines. To concretize the crucial distinction between macros that behave just like normal methods and macros that refine their return types, we introduce the notions of blackbox macros and whitebox macros. Macros that faithfully follow their type signatures are called **blackbox macros** as their implementations are irrelevant to understanding their behaviour (could be treated as black boxes). Macros that can't have precise signatures in Scala's type system are called **whitebox macros** (whitebox def macros do have signatures, but these signatures are only approximations). @@ -48,7 +48,7 @@ Blackbox def macros are treated differently from def macros of Scala 2.10. The f 1. When an application of a blackbox macro expands into tree `x`, the expansion is wrapped into a type ascription `(x: T)`, where `T` is the declared return type of the blackbox macro with type arguments and path dependencies applied in consistency with the particular macro application being expanded. This invalidates blackbox macros as an implementation vehicle of [type providers](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/). 1. When an application of a blackbox macro still has undetermined type parameters after Scala's type inference algorithm has finished working, these type parameters are inferred forcedly, in exactly the same manner as type inference happens for normal methods. This makes it impossible for blackbox macros to influence type inference, prohibiting [fundep materialization]({{ site.baseurl }}/overviews/macros/implicits.html#fundep-materialization). -1. When an application of a blackbox macro is used as an implicit candidate, no expansion is performed until the macro is selected as the result of the implicit search. This makes it impossible to [dynamically calculate availability of implicit macros]({{ site.baseurl }}/sips/source-locations.html). +1. When an application of a blackbox macro is used as an implicit candidate, no expansion is performed until the macro is selected as the result of the implicit search. This makes it impossible to [dynamically calculate availability of implicit macros](https://github.com/scala/improvement-proposals/pull/18). 1. When an application of a blackbox macro is used as an extractor in a pattern match, it triggers an unconditional compiler error, preventing customizations of pattern matching implemented with macros. Whitebox def macros work exactly like def macros used to work in Scala 2.10. No restrictions of any kind get applied, so everything that could be done with macros in 2.10 should be possible in 2.11 and 2.12. From aadcb0ede8c6a25861249441386fa26f711c24fe Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Fri, 10 Jun 2022 08:58:18 +0800 Subject: [PATCH 1913/3075] add concurrency.md --- _zh-cn/overviews/scala3-book/concurrency.md | 312 ++++++++++++++++++++ 1 file changed, 312 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/concurrency.md diff --git a/_zh-cn/overviews/scala3-book/concurrency.md b/_zh-cn/overviews/scala3-book/concurrency.md new file mode 100644 index 0000000000..02b3234842 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/concurrency.md @@ -0,0 +1,312 @@ +--- +title: 并发 +type: chapter +description: This page discusses how Scala concurrency works, with an emphasis on Scala Futures. +num: 68 +previous-page: ca-summary +next-page: scala-tools +--- + + +当您想在 Scala 中编写并行和并发应用程序时，您_可以_使用本机 Java `Thread` --- 但 Scala [Future](https://www.scala-lang.org/api/current/scala/concurrent /Future$.html) 提供了一种更高级和惯用的方法，因此它是首选，本章将对此进行介绍。 + +## 介绍 + +以下是 Scaladoc 中对 Scala `Future` 的描述： + +> “ `Future` 代表一个值，它可能_当前_可用或不可用，但在某个时候可用，或者如果该值不能可用，则表示为异常。” + +为了演示这意味着什么，让我们首先看一下单线程编程。 +在单线程世界中，您将方法调用的结果绑定到如下变量： + +```scala +def aShortRunningTask(): Int = 42 +val x = aShortRunningTask() +``` + +在此代码中，值 `42` 立即绑定到 `x`。 + +当您使用 `Future` 时，分配过程看起来很相似： + +```scala +def aLongRunningTask(): Future[Int] = ??? +val x = aLongRunningTask() +``` + +但在这种情况下的主要区别在于，因为 `aLongRunningTask` 需要不确定的时间才能返回，所以 `x` 中的值可能_当前_可用也可能不可用，但它会在某个时候可用——在未来. + +另一种看待这个问题的方法是阻塞。 +在这个单线程示例中，在 `aShortRunningTask` 完成之前不会打印 `println` 语句： + +```scala +def aShortRunningTask(): Int = + Thread.sleep(500) + 42 +val x = aShortRunningTask() +println("Here") +``` + +相反，如果 `aShortRunningTask` 被创建为 `Future`，`println` 语句几乎立即被打印，因为 `aShortRunningTask` 是在其他线程上产生的——它不会阻塞。 + +在本章中，您将看到如何使用 futures，包括如何并行运行多个 future 并将它们的结果组合到一个 `for` 表达式中。 +您还将看到一些例子，在这些例子中，有些方法用于处理在返回的 future 中的值。 + +> 当你考虑 future 时，重要的是要知道它们是一次性的，“在其他线程上处理这个相对较慢的计算，完成后给把结果通知我”的结构。 +> 作为对比，[Akka](https://akka.io) Actor 旨在运行很长时间，并在其生命周期内响应许多请求。 +> 虽然 actor可能永远活着，但 future 最终会包含只运行一次的计算结果。 + +## REPL 中的一个例子 + +future 用于创建一个临时的并发包。 +例如，当您需要调用运行不确定时间的算法时---例如调用远程微服务---您使用 future---因此您希望在主线程之外运行它。 + +为了演示它是如何工作的，让我们从 REPL 中的 `Future` 示例开始。 +首先，粘贴这些必需的 `import` 语句： + +```scala +import scala.concurrent.Future +import scala.concurrent.ExecutionContext.Implicits.global +import scala.util.{Failure, Success} +``` + +现在您已准备好创造 future 。 +对于这个例子，首先定义一个长时间运行的单线程算法： + +```scala +def longRunningAlgorithm() = + Thread.sleep(10_000) + 42 +``` + +这种奇特的算法在十秒延迟后返回整数值`42`。 +现在通过将其包装到 `Future` 构造函数中来调用该算法，并将结果分配给一个变量： + +```scala +scala> val eventualInt = Future(longRunningAlgorithm()) +eventualInt: scala.concurrent.Future[Int] = Future() +``` + +马上，您的计算——对 `longRunningAlgorithm()` 的调用——开始运行。 +如果你立即检查变量 `eventualInt` 的值，你会看到 future 还没有完成： + +```scala +scala> eventualInt +val res1: scala.concurrent.Future[Int] = Future() +``` + +但是如果你在十秒后再次检查，你会看到它已经成功完成了： + +```scala +scala> eventualInt +val res2: scala.concurrent.Future[Int] = Future(Success(42)) +``` + +虽然这是一个相对简单的示例，但它显示了基本方法：只需使用您的长时间运行的算法构建一个新的 `Future`。 + +需要注意的一点是，您期望的 `42` 被包裹在 `Success` 中，而后者又被包裹在 `Future` 中。 +这是一个需要理解的关键概念：`Future` 中的值始终是`scala.util.Try` 类型之一的实例：`Success` 或 `Failure`。 +因此，当您处理 future 的结果时，您使用通常的 `Try` 处理技术。 + +### 将 `map` 与 future 一起使用 + +`Future` 有一个 `map` 方法，你可以像使用集合中的 `map` 方法一样使用它。 +这是在创建变量 `f` 后立即调用 `map` 时的结果： + +```scala +scala> val a = eventualInt.map(_ * 2) +a: scala.concurrent.Future[Int] = Future() +``` + +如图所示，对于使用 `longRunningAlgorithm` 创建的 future ，初始输出显示 `Future()`。 +但是当你在十秒后检查 `a` 的值时，你会看到它包含 `84` 的预期结果： + +```scala +scala> a +res1: scala.concurrent.Future[Int] = Future(Success(84)) +``` + +再一次，成功的结果被包裹在 `Success` 和 `Future` 中。 + +### 在 future 中使用回调方法 + +除了像`map`这样的高阶函数，你还可以使用回调方法和futures。 +一种常用的回调方法是 `onComplete`，它采用*部分函数*，您可以在其中处理 `Success` 和 `Failure` 情况： + +```scala +eventualInt.onComplete { + case Success(value) => println(s"得到回调，value = $value") + 案例失败（e）=> e.printStackTrace +} +``` + +当您将该代码粘贴到 REPL 中时，您最终会看到结果： + +```scala +收到回调，value = 42 +``` + +## 其他 future 方法 + +`Future` 类还有其他可以使用的方法。 +它具有您在 Scala 集合类中找到的一些方法，包括： + +- `过滤器` +-`平面地图` +- `地图` + +它的回调方法有： + +- `onComplete` +- `然后` +- `foreach` + +其他转换方法包括： + +-`fallbackTo` +- `恢复` +- `recoverWith` + +请参阅 [Futures and Promises][futures] 页面，了解有关 future 可用的其他方法的讨论。 + + + +## 运行多个 future 并加入他们的结果 + +要并行运行多个计算并在所有 future 完成后加入它们的结果，请使用“for”表达式。 + +正确的做法是： + +1. 开始计算返回 `Future` 结果 +2. 将他们的结果合并到一个 `for` 表达式中 +3. 使用 `onComplete` 或类似技术提取合并结果 + + +### 一个例子 + +以下示例显示了正确方法的三个步骤。 +一个关键是你首先开始计算返回 future ，然后将它们加入到 `for` 表达式中： + +```scala +import scala.concurrent.Future +import scala.concurrent.ExecutionContext.Implicits.global +import scala.util.{Failure, Success} + +val startTime = System.currentTimeMillis() +def delta() = System.currentTimeMillis() - startTime +def sleep(millis: Long) = Thread.sleep(millis) + +@main def multipleFutures1 = + + println(s"creating the futures: ${delta()}") + + // (1) start the computations that return futures + val f1 = Future { sleep(800); 1 } // eventually returns 1 + val f2 = Future { sleep(200); 2 } // eventually returns 2 + val f3 = Future { sleep(400); 3 } // eventually returns 3 + + // (2) join the futures in a `for` expression + val result = + for + r1 <- f1 + r2 <- f2 + r3 <- f3 + yield + println(s"in the 'yield': ${delta()}") + (r1 + r2 + r3) + + // (3) process the result + result.onComplete { + case Success(x) => + println(s"in the Success case: ${delta()}") + println(s"result = $x") + case Failure(e) => + e.printStackTrace + } + + println(s"before the 'sleep(3000)': ${delta()}") + + // important for a little parallel demo: keep the jvm alive + sleep(3000) +``` + +当您运行该应用程序时，您会看到如下所示的输出： + +```` +creating the futures: 1 +before the 'sleep(3000)': 2 +in the 'yield': 806 +in the Success case: 806 +result = 6 +```` + +如该输出所示， future 的创建速度非常快，仅在两毫秒内就到达了方法末尾的 `sleep(3000)` 语句之前的打印语句。 +所有这些代码都在 JVM 的主线程上运行。 +然后，在 806 毫秒，三个 future 完成并运行 `yield` 块中的代码。 +然后代码立即转到 `onComplete` 方法中的 `Success` 案例。 + +806 毫秒的输出是看到三个计算并行运行的关键。 +如果它们按顺序运行，总时间约为 1,400 毫秒——三个计算的睡眠时间之和。 +但是因为它们是并行运行的，所以总时间只比运行时间最长的计算：`f1`，即 800 毫秒，稍长。 + +> 请注意，如果计算是在 `for` 表达式中运行的，它们 +> 将按顺序执行，而不是并行执行： +> ~~~ +> // Sequential execution (no parallelism!) +> for +> r1 <- Future { sleep(800); 1 } +> r2 <- Future { sleep(200); 2 } +> r3 <- Future { sleep(400); 3 } +> yield +> r1 + r2 + r3 +> ~~~ +> 因此，如果您希望计算可能并行运行，请记住 +> 在 `for` 表达式之外运行它们。 + +### 一个返回 future 的方法 + +到目前为止，您已经了解了如何将单线程算法传递给 `Future` 构造函数。 +您可以使用相同的技术来创建一个返回 `Future` 的方法： + +```scala +// simulate a slow-running method +def slowlyDouble(x: Int, delay: Long): Future[Int] = Future { + sleep(delay) + x * 2 +} +``` + +与前面的示例一样，只需将方法调用的结果分配给一个新变量。 +然后当你立刻检查结果时，你会看到它没有完成，但是在延迟时间之后，future 会有一个结果： + +```` +scala> val f = slowlyDouble(2, 5_000L) +val f: concurrent.Future[Int] = Future() + +scala> f +val res0: concurrent.Future[Int] = Future() + +scala> f +val res1: concurrent.Future[Int] = Future(Success(4)) +```` + +## 关于 future 的要点 + +希望这些示例能让您了解 Scala future 是如何工作的。 +总而言之，关于 future 的几个关键点是： + +- 您构建 future 以在主线程之外运行任务 +- Futures 用于一次性的、可能长时间运行的并发任务，这些任务*最终*返回一个值；他们创造了一个临时的并发包 +- 一旦你构建了 future，它就会开始运行 +- future 相对于线程的一个好处是它们可以使用 `for` 表达式，并带有各种回调方法，可以简化使用并发线程的过程 +- 当您使用 future 时，您不必关心线程管理的低级细节 +- 您可以使用 `onComplete` 和 `andThen` 之类的回调方法或 `filter`、`map` 等转换方法来处理 future 的结果。 +- `Future` 中的值始终是 `Try` 类型之一的实例：`Success` 或 `Failure` +- 如果您使用多个 future 来产生一个结果，请将它们组合在一个 `for` 表达式中 + +此外，正如您在这些示例中看到的 `import` 语句，Scala `Future` 依赖于 `ExecutionContext`。 + +有关 future 的更多详细信息，请参阅[Future 和 Promises][future]，这是一篇讨论 future 、promises 和执行上下文的文章。 +它还讨论了如何将 `for` 表达式转换为 `flatMap` 操作。 + + +[futures]: {% link _overviews/core/futures.md %} From 4d9e5414ea6f78fbe8713395ebca7a5ac9453bbe Mon Sep 17 00:00:00 2001 From: odersky Date: Fri, 10 Jun 2022 16:08:01 +0200 Subject: [PATCH 1914/3075] Document Vprofile Options --- _overviews/scala3-migration/options-new.md | 28 ++++++++++++++-------- 1 file changed, 18 insertions(+), 10 deletions(-) diff --git a/_overviews/scala3-migration/options-new.md b/_overviews/scala3-migration/options-new.md index 8c6227f2a2..61fd71c0e7 100644 --- a/_overviews/scala3-migration/options-new.md +++ b/_overviews/scala3-migration/options-new.md @@ -32,20 +32,28 @@ The current page only contains the options that were added in Scala 3.0.x. | `-siteroot` | A directory containing static files from which to generate documentation. Default: ./docs. | | `-sourceroot` | Specify workspace root directory. Default: .. | +## Verbose settings + +| 3.2.x | description | +|-|-| +| `-Vprofile` | Show metrics about sources and internal representations to estimate compile-time complexity. | +| `-Vprofile-sorted-by:` | Show metrics about sources and internal representations sorted by given column name. | +| `-Vprofile-details N` | Like -Vprofile, but also show metrics about sources and internal representations of the N most complex methods | + ## Advanced settings | 3.0.x | description | |-|-| -| `-Xignore-scala2-macros` | Ignore errors when compiling code that calls Scala2 macros, these will fail at runtime. | -| `-Ximport-suggestion-timeout` | Timeout (in ms) for searching for import suggestions when errors are reported. | -| `-Xmax-inlined-trees` | Maximal number of inlined trees. Default: 2000000 | -| `-Xmax-inlines` | Maximal number of successive inlines. Default: 32. | -| `-Xprint-diff` | Print changed parts of the tree since last print. | -| `-Xprint-diff-del` | Print changed parts of the tree since last print including deleted parts. | -| `-Xprint-inline` | Show where inlined code comes from. | -| `-Xprint-suspension` | Show when code is suspended until macros are compiled. | -| `-Xrepl-disable-display` | Do not display definitions in REPL. | -| `-Xwiki-syntax` | Retains the Scala2 behavior of using Wiki Syntax in Scaladoc. | +| `-Xignore-scala2-macros` | Ignore errors when compiling code that calls Scala2 macros, these will fail at runtime. | +| `-Ximport-suggestion-timeout` | Timeout (in ms) for searching for import suggestions when errors are reported. | +| `-Xmax-inlined-trees` | Maximal number of inlined trees. Default: 2000000 | +| `-Xmax-inlines` | Maximal number of successive inlines. Default: 32. | +| `-Xprint-diff` | Print changed parts of the tree since last print. | +| `-Xprint-diff-del` | Print changed parts of the tree since last print including deleted parts. | +| `-Xprint-inline` | Show where inlined code comes from. | +| `-Xprint-suspension` | Show when code is suspended until macros are compiled. | +| `-Xrepl-disable-display` | Do not display definitions in REPL. | +| `-Xwiki-syntax` | Retains the Scala2 behavior of using Wiki Syntax in Scaladoc. | ## Private settings From e4d6e11f907bf743db34db78a4bd6ada60f39e45 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Fri, 10 Jun 2022 16:08:21 +0200 Subject: [PATCH 1915/3075] inline sticky should be below nav bar menus --- _sass/base/helper.scss | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sass/base/helper.scss b/_sass/base/helper.scss index dc1ed0ddc0..80297c4637 100755 --- a/_sass/base/helper.scss +++ b/_sass/base/helper.scss @@ -20,7 +20,7 @@ -webkit-box-shadow: 0 0 18px 20px #fff; -moz-box-shadow: 0 0 18px 20px #fff; box-shadow: 0 0 18px 20px #fff; - z-index: 999; + z-index: 5; } .wrap-inline { From bb47995b07118109b949ebdd3a89db564844ab0b Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sat, 11 Jun 2022 11:44:34 +0800 Subject: [PATCH 1916/3075] add all tools files --- _zh-cn/overviews/scala3-book/scala-tools.md | 14 + _zh-cn/overviews/scala3-book/tools-sbt.md | 491 ++++++++++++++++++ .../overviews/scala3-book/tools-worksheets.md | 59 +++ 3 files changed, 564 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/scala-tools.md create mode 100644 _zh-cn/overviews/scala3-book/tools-sbt.md create mode 100644 _zh-cn/overviews/scala3-book/tools-worksheets.md diff --git a/_zh-cn/overviews/scala3-book/scala-tools.md b/_zh-cn/overviews/scala3-book/scala-tools.md new file mode 100644 index 0000000000..1449ac690e --- /dev/null +++ b/_zh-cn/overviews/scala3-book/scala-tools.md @@ -0,0 +1,14 @@ +--- +title: Scala 工具 +type: chapter +description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. +num: 69 +previous-page: concurrency +next-page: tools-sbt +--- + + +本章介绍编写和运行 Scala 程序的两种方法： + +- 通过创建Scala项目，可能包含多个文件，并定义一个程序入口点， +- 通过与工作表交互，工作表是在单个文件中定义的程序，逐行执行。 diff --git a/_zh-cn/overviews/scala3-book/tools-sbt.md b/_zh-cn/overviews/scala3-book/tools-sbt.md new file mode 100644 index 0000000000..23edcbfb0f --- /dev/null +++ b/_zh-cn/overviews/scala3-book/tools-sbt.md @@ -0,0 +1,491 @@ +--- +title: 使用 sbt 构建和测试 Scala 项目 +type: section +description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. +num: 70 +previous-page: scala-tools +next-page: tools-worksheets +--- + + +在本节中，您将看到 Scala 项目中常用的两个工具： + +- [sbt](https://www.scala-sbt.org) 构建工具 +- [ScalaTest](https://www.scalatest.org)，一个源代码测试框架 + +我们将首先展示如何使用 sbt 构建您的 Scala 项目，然后我们将展示如何一起使用 sbt 和 ScalaTest 来测试您的 Scala 项目。 + +> 如果您想了解帮助您将 Scala 2 代码迁移到 Scala 3 的工具，请参阅我们的 [Scala 3 迁移指南](/scala3/guides/migration/compatibility-intro.html)。 + +## 使用 sbt 构建 Scala 项目 + +您可以使用多种不同的工具来构建您的 Scala 项目，包括 Ant、Maven、Gradle、Mill 等。 +但是名为 _sbt_ 的工具是第一个专门为 Scala 创建的构建工具。 + +> 要安装 sbt，请参阅 [其下载页面](https://www.scala-sbt.org/download.html) 或我们的 [Getting Started][getting_started] 页面。 + +### 创建一个 “Hello, world” 项目 + +只需几个步骤，您就可以创建一个 sbt “Hello, world” 项目。 +首先，创建一个工作目录，然后进入该目录： + +```bash +$ mkdir hello +$ cd hello +``` + +在 `hello` 目录下，创建一个子目录 `project`： + +```bash +$ mkdir project +``` + +在 `project` 目录中创建一个名为 _build.properties_ 的文件，其中 +以下内容： + +```text +sbt.version=1.6.1 +``` + +然后在包含此行的项目根目录中创建一个名为 _build.sbt_ 的文件： + +```scala +scalaVersion := "{{ site.scala-3-version }}" +``` + +现在创建一个名为 _Hello.scala_ 的文件——名称的第一部分无关紧要——使用这一行： + +```scala +@main def helloWorld = println("Hello, world") +``` + +这就是你所要做的。 + +您应该具有如下的项目结构： + +~~~ bash +$ tree +. +├── build.sbt +├── Hello.scala +└── project + └── build.properties +~~~ + +现在使用 `sbt` 命令运行项目： + +```bash +$ sbt run +``` + +您应该会看到如下所示的输出，包括程序中的 “Hello, world”： + +```bash +$ sbt run +[info] welcome to sbt 1.5.4 (AdoptOpenJDK Java 11.x) +[info] loading project definition from project ... +[info] loading settings for project from build.sbt ... +[info] compiling 1 Scala source to target/scala-3.0.0/classes ... +[info] running helloWorld +Hello, world +[success] Total time: 2 s +``` + +sbt 启动器——`sbt` 命令行工具——加载文件 _project/build.properties_ 中设置的 sbt 版本，它加载文件 _build.sbt_ 中设置的 Scala 编译器版本，编译 _Hello.scala_ 文件中的代码，并运行生成的字节码。 + +当你查看你的目录时，你会看到 sbt 有一个名为 _target_ 的目录。 +这些是 sbt 使用的工作目录。 + +如您所见，使用 sbt 创建和运行一个小的 Scala 项目只需要几个简单的步骤。 + +### 在大型项目中使用 sbt + +对于一个小项目，这就是 sbt 运行所需的全部内容。 +对于需要许多源代码文件、依赖项或 sbt 插件的大型项目，您需要创建一个有组织的目录结构。 +本节的其余部分演示了 sbt 使用的结构。 + +### sbt 目录结构 + +与 Maven 一样，sbt 使用标准的项目目录结构。 +这样做的一个很好的好处是，一旦你对它的结构感到满意，它就可以很容易地处理其他 Scala/sbt 项目。 + +首先要知道的是，在项目的根目录下，sbt 需要一个如下所示的目录结构： + +```text +. +├── build.sbt +├── project/ +│ └── build.properties +├── src/ +│ ├── main/ +│ │ ├── java/ +│ │ ├── resources/ +│ │ └── scala/ +│ └── test/ +│ ├── java/ +│ ├── resources/ +│ └── scala/ +└── target/ +``` + +如果您想将非托管依赖项---JAR 文件---添加到您的项目中，您还可以在根目录下添加一个 _lib_ 目录。 + +如果您要创建一个包含 Scala 源代码文件和测试的项目，但不会使用任何 Java 源代码文件，并且不需要任何“资源”——例如嵌入式图像、配置文件、等等---这就是你在_src_目录下真正需要的： + +```text +. +└── src/ + ├── main/ + │ └── scala/ + └── test/ + └── scala/ +``` + +### 带有 sbt 目录结构的 “Hello, world” + +{% comment %} +LATER: using something like `sbt new scala/scala3.g8` may eventually + be preferable, but that seems to have a few bugs atm (creates + a 'target' directory above the root; renames the root dir; + uses 'dottyVersion'; 'name' doesn’t match the supplied name; + config syntax is a little hard for beginners.) +{% endcomment %} + +创建这个目录结构很简单。 +有一些工具可以为你做到这一点，但假设你使用的是 Unix/Linux 系统，你可以使用这些命令来创建你的第一个 sbt 项目目录结构： + +```bash +$ mkdir HelloWorld +$ cd HelloWorld +$ mkdir -p src/{main,test}/scala +$ mkdir project target +``` + +在运行这些命令后运行 `find .` 命令时，您应该会看到以下结果： + +```bash +$ find . +. +./project +./src +./src/main +./src/main/scala +./src/test +./src/test/scala +./target +``` + +如果你看到上面那样，那么没有问题，可以进行下一步了。 + +> 还有其他方法可以为 sbt 项目创建文件和目录。 +> 一种方法是使用 `sbt new` 命令，[在 scala-sbt.org 上有文档](https://www.scala-sbt.org/1.x/docs/Hello.html)。 +> 该方法未在此处显示，因为它创建的某些文件比像这样的介绍所必需的要复杂。 + +### 创建第一个 build.sbt 文件 + +此时，您只需要另外两件事来运行 “Hello, world” 项目： + +- 一个 _build.sbt_ 文件 +- 一个 _Hello.scala_ 文件 + +对于像这样的小项目，_build.sbt_ 文件只需要一个 `scalaVersion` 条目，但我们将添加您通常看到的三行： + +```scala +name := "HelloWorld" +version := "0.1" +scalaVersion := "{{ site.scala-3-version }}" +``` + +因为 sbt 项目使用标准的目录结构，所以 sbt 可以找到它需要的所有其他内容。 + +现在你只需要添加一个小小的“Hello, world”程序。 + +### “Hello, world” 程序 + +在大型项目中，您所有的 Scala 源代码文件都将放在 _src/main/scala_ 和 _src/test/scala_ 目录下，但是对于像这样的小示例项目，您可以将源代码文件放在您项目的根目录下。 +因此，在根目录中创建一个名为 _HelloWorld.scala_ 的文件，其中包含以下内容： + +```scala +@main def helloWorld = println("Hello, world") +``` + +该代码定义了一个 Scala 3 “main” 方法，该方法在运行时打印 “Hello, world”。 + +现在，使用 `sbt run` 命令编译并运行您的项目： + +```bash +$ sbt run + +[info] welcome to sbt +[info] loading settings for project ... +[info] loading project definition +[info] loading settings for project root from build.sbt ... +[info] Compiling 1 Scala source ... +[info] running helloWorld +Hello, world +[success] Total time: 4 s +``` + +第一次运行 `sbt` 时，它会下载所需的所有内容，这可能需要一些时间才能运行，但之后它会变得更快。 + +此外，一旦你完成了这第一步，你会发现以交互方式运行 sbt 会快得多。 +为此，首先单独运行 `sbt` 命令： + +```bash +$ sbt + +[info] welcome to sbt +[info] loading settings for project ... +[info] loading project definition ... +[info] loading settings for project root from build.sbt ... +[info] sbt server started at + local:///${HOME}/.sbt/1.0/server/7d26bae822c36a31071c/sock +sbt:hello-world> _ +``` + +然后在这个 sbt shell 中，执行它的 `run` 命令： + +```` +sbt:hello-world> run + +[info] running helloWorld +Hello, world +[success] Total time: 0 s +```` + +这要快得多。 + +如果您在 sbt 命令提示符下键入 `help`，您将看到可以运行的其他命令的列表。 +但现在，只需键入 `exit`（或按 `CTRL-D`）离开 sbt shell。 + +### 使用项目模板 + +手动创建项目结构可能很乏味。谢天谢地，sbt 可以基于模板为你创建项目。 + +要从模板创建 Scala 3 项目，请在 shell 中运行以下命令： + +~~~ +$ sbt new scala/scala3.g8 +~~~ + +Sbt 将加载模板，提出一些问题，并在子目录中创建项目文件： + +~~~ +$ tree scala-3-project-template +scala-3-project-template +├── build.sbt +├── project +│ └── build.properties +├── README.md +└── src + ├── main + │ └── scala + │ └── Main.scala + └── test + └── scala + └── Test1.scala +~~~ + +> 如果要创建与 Scala 2 交叉编译的 Scala 3 项目，请使用模板 `scala/scala3-cross.g8`： +> +> ~~~ +> $ sbt new scala/scala3-cross.g8 +> ~~~ + +在 [sbt 文档](https://www.scala-sbt.org/1.x/docs/sbt-new-and-Templates.html#sbt+new+) 中了解有关 `sbt new` 和项目模板的更多信息和+模板。 + +### Scala 的其他构建工具 + +虽然 sbt 被广泛使用，但您还可以使用其他工具来构建 Scala 项目： + +- [ant](https://ant.apache.org/) +- [Gradle](https://gradle.org/) +- [Maven](https://maven.apache.org/) +- [mill](https://com-lihaoyi.github.io/mill/) + +#### Coursier + +在相关说明中，[Coursier](https://get-coursier.io/docs/overview) 是一个“依赖解析器”，在功能上类似于 Maven 和 Ivy。 +它是用 Scala 从头开始​​编写的，“包含函数式编程原则”，并且可以并行下载工件以实现快速下载。 +sbt 使用它来处理大多数依赖关系解析，并且作为一个命令行工具，它可以用于在您的系统上轻松安装 sbt、Java 和 Scala 等工具，如我们的 [Getting Started][getting_started] 页面所示。 + +来自 `launch` 网页的这个示例显示了 `cs launch` 命令可用于从依赖项启动应用程序： + +```scala +$ cs launch org.scalameta::scalafmt-cli:2.4.2 -- --help +scalafmt 2.4.2 +Usage: scalafmt [options] [...] + + -h, --help prints this usage text + -v, --version print version + more ... +``` + +有关详细信息，请参阅 Coursier 的 [启动页面](https://get-coursier.io/docs/cli-launch)。 + +## 使用 sbt 和 ScalaTest + +[ScalaTest](https://www.scalatest.org) 是 Scala 项目的主要测试库之一。 +在本节中，您将看到创建使用 ScalaTest 的 Scala/sbt 项目所需的步骤。 + +### 1) 创建项目目录结构 + +与上一课一样，使用以下命令为名为 _HelloScalaTest_ 的项目创建一个 sbt 项目目录结构： + +```bash +$ mkdir HelloScalaTest +$ cd HelloScalaTest +$ mkdir -p src/{main,test}/scala +$ mkdir project +``` + +### 2) 创建 build.properties 和 build.sbt 文件 + +接下来，在项目的 _project/_ 子目录中创建一个 _build.properties_ 文件 +用这条线： + +```text +sbt.version=1.5.4 +``` + +接下来，在项目的根目录中创建一个 _build.sbt_ 文件，其中包含以下内容： + +```scala +name := "HelloScalaTest" +version := "0.1" +scalaVersion := "{{site.scala-3-version}}" + +libraryDependencies ++= Seq( + "org.scalatest" %% "scalatest" % "3.2.9" % Test +) +``` + +该文件的前三行与第一个示例基本相同。 +`libraryDependencies` 行告诉 sbt 包含包含 ScalaTest 所需的依赖项（JAR 文件）。 + +> ScalaTest 文档一直很优秀，您始终可以在 [安装 ScalaTest](https://www.scalatest.org/install) 页面上找到有关这些行应该是什么样子的最新信息。 + +### 3) 创建一个 Scala 源代码文件 + +接下来，创建一个可用于演示 ScalaTest 的 Scala 程序。 +首先，在 _src/main/scala_ 下创建一个名为 _math_ 的目录： + +```bash +$ mkdir src/main/scala/math + ---- +``` + +然后，在该目录中，使用以下内容创建一个名为 _MathUtils.scala_ 的文件： + +```scala +package math + +object MathUtils: + def double(i: Int) = i * 2 +``` + +该方法提供了一种演示 ScalaTest 的简单方法。 + +{% comment %} +Because this project doesn’t have a `main` method, we don’t try to run it with `sbt run`; we just compile it with `sbt compile`: + +```` +$ sbt compile + +[info] welcome to sbt +[info] loading settings for project ... +[info] loading project definition ... +[info] loading settings for project ... +[info] Executing in batch mode. For better performance use sbt's shell +[success] Total time: 1 s +```` + +With that compiled, let’s create a ScalaTest file to test the `double` method. +{% endcomment %} + +### 4) 创建你的第一个 ScalaTest 测试 + +ScalaTest 非常灵活，并提供了几种不同的方式来编写测试。 +一个简单的入门方法是使用 ScalaTest `AnyFunSuite` 编写测试。 +首先，在 _src/test/scala_ 目录下创建一个名为 _math_ 的目录： + +```bash +$ mkdir src/test/scala/math + ---- +``` + +接下来，在该目录中创建一个名为 _MathUtilsTests.scala_ 的文件，其内容如下： + +```scala +package math + +import org.scalatest.funsuite.AnyFunSuite + +class MathUtilsTests extends AnyFunSuite: + + // test 1 + test("'double' should handle 0") { + val result = MathUtils.double(0) + assert(result == 0) + } + + // test 2 + test("'double' should handle 1") { + val result = MathUtils.double(1) + assert(result == 2) + } + + test("test with Int.MaxValue") (pending) + +end MathUtilsTests +``` + +此代码演示了 ScalaTest `AnyFunSuite` 方法。 +几个重要的点： + +- 你的测试类应该扩展 `AnyFunSuite` +- 如图所示，您可以通过为每个 `test` 指定一个唯一的名称来创建测试 +- 在每个测试结束时，您应该调用 `assert` 来测试条件是否已满足 +- 当你知道你想写一个测试，但你现在不想写它时，将测试创建为“待定”，语法如上例所示 + +像这样使用 ScalaTest 类似于 JUnit，所以如果你是从 Java 转到 Scala 的，希望这看起来相似。 + +现在您可以使用 `sbt test` 命令运行这些测试。 +跳过前几行输出，结果如下所示： + +```` +sbt:HelloScalaTest> test + +[info] Compiling 1 Scala source ... +[info] MathUtilsTests: +[info] - 'double' should handle 0 +[info] - 'double' should handle 1 +[info] - test with Int.MaxValue (pending) +[info] Total number of tests run: 2 +[info] Suites: completed 1, aborted 0 +[info] Tests: succeeded 2, failed 0, canceled 0, ignored 0, pending 1 +[info] All tests passed. +[success] Total time: 1 s +```` + +如果一切正常，您将看到类似的输出。 +欢迎来到使用 sbt 和 ScalaTest 测试 Scala 应用程序的世界。 + +### 支持多种类型的测试 + +此示例演示了一种类似于 xUnit _测试驱动开发_(TDD) 样式测试的测试样式，并具有_行为驱动开发_(BDD) 样式的一些优点。 + +如前所述，ScalaTest 很灵活，您还可以用其它风格来编写测试，例如类似于 Ruby 的 RSpec 的风格。 +您还可以使用伪对象、基于属性的测试，并使用 ScalaTest 来测试 Scala.js 代码。 + +有关可用的不同测试风格的更多详细信息，请参阅 [ScalaTest 网站](https://www.scalatest.org) 上的用户指南。 + +## 从这往哪儿走 + +有关 sbt 和 ScalaTest 的更多信息，请参阅以下资源： + +- [sbt 文档](https://www.scala-sbt.org/1.x/docs/) +- [ScalaTest 网站](https://www.scalatest.org/) + + +[getting_started]: {{ site.baseurl }}/scala3/getting-started.html diff --git a/_zh-cn/overviews/scala3-book/tools-worksheets.md b/_zh-cn/overviews/scala3-book/tools-worksheets.md new file mode 100644 index 0000000000..1c743ef250 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/tools-worksheets.md @@ -0,0 +1,59 @@ +--- +title: 工作表 +type: section +description: This section looks at worksheets, an alternative to Scala projects. +num: 71 +previous-page: tools-sbt +next-page: interacting-with-java +--- + + +工作表是在保存时评估的 Scala 文件，并把每个表达式的结果 +显示在程序右侧的列中。工作表就像是加了激素的[REPL 会话][REPL session]，并且 +享受一流的编辑器支持：自动补全、超链接、交互式错误输入等。 +工作表使用扩展名 `.worksheet.sc` 。 + +下面，我们将展示如何在 IntelliJ 和 VS Code（带有 Metals 扩展）中使用工作表。 + +1. 打开一个 Scala 项目，或者创建一个。 + - 要在 IntelliJ 中创建项目，选择“File”->“New”->“Project...”， 在左侧栏中选择“Scala”， + 单击“下一步”设置项目名称和位置。 + - 要在 VS Code 中创建项目，请运行命令“Metals: New Scala project”，选择 + 种子 `scala/scala3.g8`，设置项目位置，在新的 VS Code 窗口中打开它，然后 + 导入其构建。 +1. 在 `src/main/scala/` 目录下创建一个名为 `hello.worksheet.sc` 的文件。 + - 在 IntelliJ 中，右键单击目录 `src/main/scala/`，然后选择“New”，然后 + 是“文件”。 + - 在 VS Code 中，右键单击目录`src/main/scala/`，然后选择“New File”。 +1. 在编辑器中粘贴以下内容： + ~~~ + println("Hello, world!") + + val x = 1 + x + x + ~~~ + +1. 评估工作表。 + - 在 IntelliJ 中，单击编辑器顶部的绿色箭头以评估工作表。 + - 在 VS Code 中，保存文件。 + + 您应该在右侧面板 (IntelliJ) 上看到每一行的评估结果，或者 + 作为注释（VS Code）。 + +![]({{ site.baseurl }}/resources/images/scala3-book/intellij-worksheet.png) + +在 IntelliJ 中评估的工作表。 + +![]({{ site.baseurl }}/resources/images/scala3-book/metals-worksheet.png) + +在 VS Code 中评估的工作表（带有 Metals 扩展）。 + +请注意，工作表将使用项目定义的 Scala 版本（通常在文件`build.sbt`中， +设置 `scalaVersion` 键）。 + +另请注意，工作表没有 [程序入口点][program entry point]。作为替代，顶级语句和表达式 +从上到下进行评估。 + + +[REPL session]: {% link _overviews/scala3-book/taste-repl.md %} +[program entry point]: {% link _overviews/scala3-book/methods-main-methods.md %} From c59f3badf08e1882d3c2b5977a8f34c6c60ccfbe Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sat, 11 Jun 2022 22:15:33 +0800 Subject: [PATCH 1917/3075] add interacting-with-java.md --- .../scala3-book/interacting-with-java.md | 337 ++++++++++++++++++ 1 file changed, 337 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/interacting-with-java.md diff --git a/_zh-cn/overviews/scala3-book/interacting-with-java.md b/_zh-cn/overviews/scala3-book/interacting-with-java.md new file mode 100644 index 0000000000..d13ac7635f --- /dev/null +++ b/_zh-cn/overviews/scala3-book/interacting-with-java.md @@ -0,0 +1,337 @@ +--- +title: 与 Java 交互 +type: chapter +description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. +num: 72 +previous-page: tools-worksheets +next-page: scala-for-java-devs +--- + +## 介绍 + +本节介绍如何在 Scala 中使用 Java 代码，以及如何在 Java 中使用 Scala 代码。 + +一般来说，在 Scala 中使用 Java 代码是非常无缝的。 +只有几个地方需要使用 Scala 实用程序将 Java 概念转换为 Scala，包括： + +- Java 集合类 +- Java `Optional` 类 + +同样，如果您正在编写 Java 代码并想使用 Scala 概念，则需要转换 Scala 集合和 Scala `Option` 类。 + +以下部分演示了您需要的最常见的转换： + +- 如何在 Scala 中使用 Java 集合 +- 如何在 Scala 中使用 Java `Optional` +- 在 Scala 中扩展 Java 接口 +- 如何在 Java 中使用 Scala 集合 +- 如何在 Java 中使用 Scala `Option` +- 如何在 Java 中使用 Scala traits +- 如何在 Java 代码中处理 Scala 方法引发的异常 +- 如何在 Java 中使用 Scala 可变参数 +- 创建备用名称以在 Java 中使用 Scala 方法 + +请注意，本节中的 Java 示例假设您使用的是 Java 11 或更高版本。 + +## 如何在 Scala 中使用 Java 集合 + +当您编写 Scala 代码并需要使用 Java 集合类时，您_可以_按原样使用该类。 +但是，如果您想在 Scala `for` 循环中使用该类，或者想利用 Scala 集合类中的高阶函数，则需要将 Java 集合转换为 Scala 集合。 + +这是一个如何工作的例子。 +假定这个例子是 Java `ArrayList`： + +```java +// java +public class JavaClass { + public static List getStrings() { + return new ArrayList(List.of("a", "b", "c")); + } +} +``` + +您可以使用 Scala _scala.jdk.CollectionConverters_ 包中的转换实用程序将该 Java 列表转换为 Scala `Seq`： + +```scala +// scala +import scala.jdk.CollectionConverters.* + +def testList() = + println("Using a Java List in Scala") + val javaList: java.util.List[String] = JavaClass.getStrings() + val scalaSeq: Seq[String] = javaList.asScala.toSeq + scalaSeq.foreach(println) + for s <- scalaSeq do println(s) +``` + +当然，该代码可以缩短，但此处显示的各个步骤是为了准确演示转换过程是如何工作的。 + +## 如何在 Scala 中使用 Java `Optional` + +当您需要在 Scala 代码中使用 Java `Optional` 类时，导入 _scala.jdk.OptionConverters_ 对象，然后使用 `toScala` 方法将 `Optional` 值转换为 Scala `Option`。 + +为了证明这一点，这里有一个带有两个 `Optional` 值的 Java 类，一个包含字符串，另一个为空： + +```java +// java +import java.util.Optional; + +public class JavaClass { + static Optional oString = Optional.of("foo"); + static Optional oEmptyString = Optional.empty(); +} +``` + +现在在您的 Scala 代码中，您可以访问这些字段。 +如果您只是直接访问它们，它们都将是 `Optional` 值： + +```scala +// scala +import java.util.Optional + +val optionalString = JavaClass.oString // Optional[foo] +val eOptionalString = JavaClass.oEmptyString // Optional.empty +``` + +但是通过使用 _scala.jdk.OptionConverters_ 方法，您可以将它们转换为 Scala `Option` 值： + +```scala +import java.util.Optional +import scala.jdk.OptionConverters.* + +val optionalString = JavaClass.oString // Optional[foo] +val optionString = optionalString.toScala // Some(foo) + +val eOptionalString = JavaClass.oEmptyString // Optional.empty +val eOptionString = eOptionalString.toScala // None +``` + +## 在 Scala 中扩展 Java 接口 + +如果您需要在 Scala 代码中使用 Java 接口，请将它们扩展为 Scala trait。 +例如，给定这三个 Java 接口： + +```java +// java +interface Animal { + void speak(); +} + +interface Wagging { + void wag(); +} + +interface Running { + // an implemented method + default void run() { + System.out.println("I’m running"); + } +} +``` + +你可以在 Scala 中创建一个 `Dog` 类，就像使用 trait 一样。 +你所要做的就是实现 `speak` 和 `wag` 方法： + +```scala +// scala +class Dog extends Animal, Wagging, Running: + def speak = println("Woof") + def wag = println("Tail is wagging") + +@main def useJavaInterfaceInScala = + val d = new Dog + d.speak + d.wag +``` + +## 如何在 Java 中使用 Scala 集合 + +当您需要在 Java 代码中使用 Scala 集合类时，请在 Java 代码中使用 Scala 的 `scala.jdk.javaapi.CollectionConverters` 对象的方法来进行转换。 +例如，如果您在 Scala 类中有这样的 `List[String]`： + +```scala +// scala +class ScalaClass: + val strings = List("a", "b") +``` + +您可以像这样在 Java 代码中访问该 Scala `List`： + +```java +// java +import scala.jdk.javaapi.CollectionConverters; + +// create an instance of the Scala class +ScalaClass sc = new ScalaClass(); + +// access the `strings` field as `sc.strings()` +scala.collection.immutable.List xs = sc.strings(); + +// convert the Scala `List` a Java `List` +java.util.List listOfStrings = CollectionConverters.asJava(xs); +listOfStrings.forEach(System.out::println); +``` + +该代码可以缩短，但显示了完整的步骤以演示该过程的工作原理。 +以下是该代码中需要注意的一些事项： + +- 在你的 Java 代码中，你创建一个 `ScalaClass` 的实例，就像一个 Java 类的实例一样 +- `ScalaClass` 有一个名为 `strings` 的字段，但在 Java 中，您可以将该字段作为方法访问，即，作为 `sc.strings()` + +## 如何在 Java 中使用 Scala `Option` + +当您需要在 Java 代码中使用 Scala `Option` 时，可以使用 Scala `scala.jdk.javaapi.OptionConverters` 对象的 `toJava` 方法将 `Option` 转换为 Java `Optional` 值。 + +为了证明这一点，创建一个具有两个 `Option[String]` 值的 Scala 类，一个包含字符串，另一个为空： + +```scala +// scala +object ScalaObject: + val someString = Option("foo") + val noneString: Option[String] = None +``` + +然后在您的 Java 代码中，使用来自 `scala.jdk.javaapi.OptionConverters` 对象的 `toJava` 方法将这些 `Option[String]` 值转换为 `java.util.Optional[String]`： + +```java +// java +import java.util.Optional; +import static scala.jdk.javaapi.OptionConverters.toJava; + +public class JUseScalaOptionInJava { + public static void main(String[] args) { + Optional stringSome = toJava(ScalaObject.someString()); // Optional[foo] + Optional stringNone = toJava(ScalaObject.noneString()); // Optional.empty + System.out.printf("stringSome = %s\n", stringSome); + System.out.printf("stringNone = %s\n", stringNone); + } +} +``` + +两个 Scala `Option` 字段现在可用作 Java `Optional` 值。 + +## 如何在 Java 中使用 Scala trait + +在 Java 11 中，您可以像使用 Java 接口一样使用 Scala trait，即使 trait 已经实现了方法。 +例如，给定这两个 Scala trait，一个具有已实现的方法，一个只有一个接口： + +```scala +// scala +trait ScalaAddTrait: + def sum(x: Int, y: Int) = x + y // implemented + +trait ScalaMultiplyTrait: + def multiply(x: Int, y: Int): Int // abstract +``` + +Java 类可以实现这两个接口，并定义 `multiply` 方法： + +```java +// java +class JavaMath implements ScalaAddTrait, ScalaMultiplyTrait { + public int multiply(int a, int b) { + return a * b; + } +} + +JavaMath jm = new JavaMath(); +System.out.println(jm.sum(3,4)); // 7 +System.out.println(jm.multiply(3,4)); // 12 +``` + +## 如何处理在 Java 代码中抛出异常的 Scala 方法 + +当您使用 Scala 编程习惯编写 Scala 代码时，您永远不会编写引发异常的方法。 +但是如果由于某种原因你有一个抛出异常的 Scala 方法，并且你希望 Java 开发人员能够使用该方法，请在你的 Scala 方法中添加`@throws`注解，以便 Java 使用者知道它可以抛出的异常. + +例如，注解这个 Scala `exceptionThrower` 方法抛出一个 `Exception`： + +```scala +// scala +object SExceptionThrower: + @throws(classOf[Exception]) + def exceptionThrower = + throw new Exception("Idiomatic Scala methods don’t throw exceptions") +``` + +因此，您需要处理 Java 代码中的异常。 +例如，这段代码不会编译，因为我不处理异常： + +```java +// java: won’t compile because the exception isn’t handled +public class ScalaExceptionsInJava { + public static void main(String[] args) { + SExceptionThrower.exceptionThrower(); + } +} +``` + +编译器给出了这个错误： + +```` +[error] ScalaExceptionsInJava: unreported exception java.lang.Exception; + must be caught or declared to be thrown +[error] SExceptionThrower.exceptionThrower() +```` + +这很好——这就是你想要的：注解告诉 Java 编译器 `exceptionThrower` 可以抛出异常。 +现在，当您编写 Java 代码时，您必须使用 `try` 块处理异常或声明您的 Java 方法抛出异常。 + +相反，如果你 Scala `exceptionThrower` 方法的注释，Java 代码_将编译_。 +这可能不是您想要的，因为 Java 代码可能无法考虑引发异常的 Scala 方法。 + +## 如何在 Java 中使用 Scala 可变参数 + +当 Scala 方法具有可变参数并且您想在 Java 中使用该方法时，请使用 `@varargs` 注解来标记 Scala 方法。 +例如，这个 Scala 类中的 `printAll` 方法声明了一个 `String*` 可变参数字段： + +```scala +// scala +import scala.annotation.varargs + +object VarargsPrinter: + @varargs def printAll(args: String*): Unit = args.foreach(println) +``` + +因为 `printAll` 是用 `@varargs` 注释声明的，所以可以从具有可变数量参数的 Java 程序中调用它，如下例所示： + +```scala +// java +public class JVarargs { + public static void main(String[] args) { + VarargsPrinter.printAll("Hello", "world"); + } +} +``` + +运行此代码时，结果在以下输出中： + +```` +Hello +world +```` + +## 创建备用名称以在 Java 中使用 Scala 方法 + +在 Scala 中，您可能希望使用符号字符创建方法名称： + +```scala +def +(a: Int, b: Int) = a + b +``` + +该方法名称在 Java 中不能很好地工作，但您可以在 Scala 3 中为该方法提供一个“替代”名称——别名——这将在 Java 中工作： + +```scala +import scala.annotation.targetName + +class Adder: + @targetName("add") def +(a: Int, b: Int) = a + b +``` + +现在在您的 Java 代码中，您可以使用别名方法名称 `add`： + +```scala +var adder = new Adder(); +int x = adder.add(1,1); +System.out.printf("x = %d\n", x); +``` From 422091726fbd48e8b50bd77616307dcd9d30161d Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Sun, 12 Jun 2022 03:24:00 -0700 Subject: [PATCH 1918/3075] Clarify case _, case x --- _overviews/scala3-book/control-structures.md | 25 +++++++++++++------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index 61141bc606..224183497b 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -369,9 +369,11 @@ val day = i match case _ => "invalid day" // the default, catch-all ``` -In this example the variable `i` is tested against the cases shown. -If it’s between `0` and `6`, `day` is bound to a string that represents one of the days of the week. -Otherwise, the catch-all case is represented by the `_` character, and `day` is bound to the string, `"invalid day"`. +In this example, the variable `i` is tested against the cases shown. +If it’s between `0` and `6`, `day` is bound to the string that represents that day of the week. +Otherwise, it matches the catch-all case represented by the character, `_`, and `day` is bound to the string, `"invalid day"`. + +Since the cases are considered in the order they are written, and the first matching case is used, the default case, which matches any value, must come last. Any cases after the catch-all will be warned as unreachable cases. > When writing simple `match` expressions like this, it’s recommended to use the `@switch` annotation on the variable `i`. > This annotation provides a compile-time warning if the switch can’t be compiled to a `tableswitch` or `lookupswitch`, which are better for performance. @@ -379,18 +381,25 @@ Otherwise, the catch-all case is represented by the `_` character, and `day` is ### Using the default value -When you need to access the catch-all, default value in a `match` expression, just provide a variable name on the left side of the `case` statement, and then use that variable name on the right side of the statement as needed: +When you need to access the catch-all, default value in a `match` expression, just provide a variable name on the left side of the `case` statement instead of `_`, and then use that variable name on the right side of the statement as needed: ```scala i match case 0 => println("1") case 1 => println("2") - case what => println(s"You gave me: $what" ) + case what => println(s"You gave me: $what") ``` +The name used in the pattern must begin with a lowercase letter. +A name beginning with an uppercase letter does not introduce a variable, but matches a value in scope: -In this example the variable is named `what` to show that it can be given any legal name. -You can also use `_` as a name to ignore the value. - +```scala +val N = 42 +i match + case 0 => println("1") + case 1 => println("2") + case N => println("42") + case n => println(s"You gave me: $n" ) +``` ### Handling multiple possible matches on one line From 93f4569e48b12311be478e7d85a4b94c8040a714 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Mon, 13 Jun 2022 12:03:19 +0200 Subject: [PATCH 1919/3075] Indicate that the list of committee members is still being defined --- _sips/process-specification.md | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/_sips/process-specification.md b/_sips/process-specification.md index 9e8cc0beee..62ef8f16b1 100644 --- a/_sips/process-specification.md +++ b/_sips/process-specification.md @@ -244,15 +244,8 @@ Any further changes would have to come as an entirely new SIP. ## The SIP Committee -The current committee members are: - -- Martin Odersky ([@odersky](https://github.com/odersky)), EPFL -- Sébastien Doeraene ([@sjrd](https://github.com/sjrd)), Scala Center - -The current Chairperson is: - -- Julien Richard-Foy ([@julienrf](https://github.com/julienrf)), Scala Center - +The list of committee members is not yet known. We will update this section +as soon as the full committee is defined. ### Committee Meetings From 908fd75d2594e82db9d38cafdb0b6320b215fad3 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Mon, 13 Jun 2022 16:03:23 +0000 Subject: [PATCH 1920/3075] Update SIPs state --- _sips/sips/interpolation-quote-escape.md | 264 +++++++++++------------ 1 file changed, 132 insertions(+), 132 deletions(-) diff --git a/_sips/sips/interpolation-quote-escape.md b/_sips/sips/interpolation-quote-escape.md index 1fade0f6ff..4639fc615f 100644 --- a/_sips/sips/interpolation-quote-escape.md +++ b/_sips/sips/interpolation-quote-escape.md @@ -1,132 +1,132 @@ ---- -layout: sip -title: SIP-37 - Quote escapes for interpolations -stage: completed -status: shipped -permalink: /sips/:title.html -redirect_from: /sips/pending/interpolation-quote-escape.html ---- - -> This proposal has been implemented in Scala 2.13.6 and Scala 3.0.0. - -**By: Martijn Hoekstra** - -## History - -| Date | Version | -|---------------|-----------------------| -| Jul 31th 2018 | Initial Draft | -| Aug 1st 2018 | Process lead comments | -| Nov 2nd 2019 | Link dotty impl | - -## Introduction - -It's not straight-forward how to have a quote character (`"`) in an -interpolation. Parsing interpolations does not process backslash escapes, but -rather passes the raw string to the interpolator, which then has the option to -process escapes itself as it sees fit. That means there are no lexing rules that -process the escape, and the sequence `\"` simply terminates the interpolation. - -Interpolations have a different meta-character -- the `$` character -- which is -treated specially. Interpolations use this escape to splice in arguments, and it -can also be used to escape itself as the sequence `$$` to represent a literal -`$` character. - -Because of its special handling during the parse, the `$` could be used to -escape a `"` character to represent a literal `"` withing a string. - -## Motivating Example - -That the `"` character can't be easily escaped in interpolations has been an -open issue since at least 2012[^1], and how to deal with this issue is a -somewhat common SO question[^2][^3] - -{% highlight Scala %} -s"A common question for Scala programmers is "How can I represent a literal " character in Scala interpolations?"" -{% endhighlight %} - -Doesn't work. - -Neither does - -{% highlight Scala %} -s"A common question for Scala programmers is \"How can I represent a literal \" character in Scala interpolations?\"" -{% endhighlight %} - -### Examples - -{% highlight Scala %} -s"A common question for Scala programmers is $"How can I represent a literal $" character in Scala interpolations?$"" -{% endhighlight %} - -### Comparison Examples - -There are a number of ways to work around the current restriction. - -The simplest is triple-quoting the interpolation: -{% highlight Scala %} -s"""A common question for Scala programmers is "How can I represent a literal " character in Scala interpolations?"""" -{% endhighlight %} - -Another common workaround is splicing in a separate string in one way or another. - -{% highlight Scala %} -//with a normal escape in a string in a block -s"A common question for Scala programmers is ${"\""}How can I represent a literal ${"\""} character in Scala interpolations?${"\""}" -//with a quote character as a block -s"A common question for Scala programmers is ${'"'}How can I represent a literal ${'"'} character in Scala interpolations?${'"'}" -//with an identifier referencing a string that contains a single quote -val quote = "\"" -s"A common question for Scala programmers is ${q}How can I represent a literal $q character in Scala interpolations?$q" -{% endhighlight %} - -The second set of workarounds is dependent on the actual interpolator, and the -quote becomes an argument. The `s`, `f` and `raw` interpolators splice their -arguments in to the string, as is the obvious use and implementation of an -interpolator. But it's not the only possible use and implementation for an -interpolator and this way of inserting quotes may not work for any given -interpolator. - -## Design - -This is a non-breaking change. Currently the sequence `$"` within an -interpolation is a syntax error, as has already been noted[^4] -on the original ticket. - -## Implementation - -The implementation is simple to the point of being trivial: see -the implementation [^5] for the actual change in functionality and the rest of -that PR for the spec and test changes. - -There is also an implementation for Dotty.[^7] - -## Drawbacks - -Adding this feature makes the language just a bit more irregular. There already -is some amount of irregularity around string literals and interpolations in -the language. An argument could be made that this change makes that worse rather -than better. - -Because it affects parsing, this change may affect syntax highlighters. Syntax -highlighters tend to already struggle around "funky" strings and interpolations. - -## Alternatives - -More ambitious proposals around interpolations are possible, and have been -proposed in different forms before. For example, there was a PR thatshows more options -around using `\` as a meta character in interpolations[^6]. It stranded somewhere -between red tape, ambition and changing processes. - -I suspect the last word about interpolations hasn't been spoken, and that later -proposals may still make interpolations more regular. This proposal is -deliberately small, and intends not to be in the way of any potential further -proposals. - -[^1]: https://github.com/Scala/bug/issues/6476 "\\\" escape does not work with string interpolation" -[^2]: https://stackoverflow.com/questions/31366563/string-interpolation-escaping-quotation-mark/31366588 "" -[^3]: https://stackoverflow.com/questions/17085354/escaping-quotation-marks-in-f-string-interpolation "" -[^4]: https://github.com/scala/bug/issues/6476#issuecomment-292412577 "@retronym said: +1 to s"$"". Because it doesn't compile today, we don't risk changing the meaning of existing programs." -[^5]: https://github.com/Scala/Scala/pull/6953/files#diff-0023b3bfa053fb16603156b785efa7ad "" -[^6]: https://github.com/Scala/Scala/pull/4308 "SI-6476 Accept escaped quotes in interp strings" -[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" +--- +layout: sip +title: SIP-37 - Quote escapes for interpolations +stage: completed +status: shipped +permalink: /sips/:title.html +redirect_from: /sips/pending/interpolation-quote-escape.html +--- + +> This proposal has been implemented in Scala 2.13.6 and Scala 3.0.0. + +**By: Martijn Hoekstra** + +## History + +| Date | Version | +|---------------|-----------------------| +| Jul 31th 2018 | Initial Draft | +| Aug 1st 2018 | Process lead comments | +| Nov 2nd 2019 | Link dotty impl | + +## Introduction + +It's not straight-forward how to have a quote character (`"`) in an +interpolation. Parsing interpolations does not process backslash escapes, but +rather passes the raw string to the interpolator, which then has the option to +process escapes itself as it sees fit. That means there are no lexing rules that +process the escape, and the sequence `\"` simply terminates the interpolation. + +Interpolations have a different meta-character -- the `$` character -- which is +treated specially. Interpolations use this escape to splice in arguments, and it +can also be used to escape itself as the sequence `$$` to represent a literal +`$` character. + +Because of its special handling during the parse, the `$` could be used to +escape a `"` character to represent a literal `"` withing a string. + +## Motivating Example + +That the `"` character can't be easily escaped in interpolations has been an +open issue since at least 2012[^1], and how to deal with this issue is a +somewhat common SO question[^2][^3] + +{% highlight Scala %} +s"A common question for Scala programmers is "How can I represent a literal " character in Scala interpolations?"" +{% endhighlight %} + +Doesn't work. + +Neither does + +{% highlight Scala %} +s"A common question for Scala programmers is \"How can I represent a literal \" character in Scala interpolations?\"" +{% endhighlight %} + +### Examples + +{% highlight Scala %} +s"A common question for Scala programmers is $"How can I represent a literal $" character in Scala interpolations?$"" +{% endhighlight %} + +### Comparison Examples + +There are a number of ways to work around the current restriction. + +The simplest is triple-quoting the interpolation: +{% highlight Scala %} +s"""A common question for Scala programmers is "How can I represent a literal " character in Scala interpolations?"""" +{% endhighlight %} + +Another common workaround is splicing in a separate string in one way or another. + +{% highlight Scala %} +//with a normal escape in a string in a block +s"A common question for Scala programmers is ${"\""}How can I represent a literal ${"\""} character in Scala interpolations?${"\""}" +//with a quote character as a block +s"A common question for Scala programmers is ${'"'}How can I represent a literal ${'"'} character in Scala interpolations?${'"'}" +//with an identifier referencing a string that contains a single quote +val quote = "\"" +s"A common question for Scala programmers is ${q}How can I represent a literal $q character in Scala interpolations?$q" +{% endhighlight %} + +The second set of workarounds is dependent on the actual interpolator, and the +quote becomes an argument. The `s`, `f` and `raw` interpolators splice their +arguments in to the string, as is the obvious use and implementation of an +interpolator. But it's not the only possible use and implementation for an +interpolator and this way of inserting quotes may not work for any given +interpolator. + +## Design + +This is a non-breaking change. Currently the sequence `$"` within an +interpolation is a syntax error, as has already been noted[^4] +on the original ticket. + +## Implementation + +The implementation is simple to the point of being trivial: see +the implementation [^5] for the actual change in functionality and the rest of +that PR for the spec and test changes. + +There is also an implementation for Dotty.[^7] + +## Drawbacks + +Adding this feature makes the language just a bit more irregular. There already +is some amount of irregularity around string literals and interpolations in +the language. An argument could be made that this change makes that worse rather +than better. + +Because it affects parsing, this change may affect syntax highlighters. Syntax +highlighters tend to already struggle around "funky" strings and interpolations. + +## Alternatives + +More ambitious proposals around interpolations are possible, and have been +proposed in different forms before. For example, there was a PR thatshows more options +around using `\` as a meta character in interpolations[^6]. It stranded somewhere +between red tape, ambition and changing processes. + +I suspect the last word about interpolations hasn't been spoken, and that later +proposals may still make interpolations more regular. This proposal is +deliberately small, and intends not to be in the way of any potential further +proposals. + +[^1]: https://github.com/Scala/bug/issues/6476 "\\\" escape does not work with string interpolation" +[^2]: https://stackoverflow.com/questions/31366563/string-interpolation-escaping-quotation-mark/31366588 "" +[^3]: https://stackoverflow.com/questions/17085354/escaping-quotation-marks-in-f-string-interpolation "" +[^4]: https://github.com/scala/bug/issues/6476#issuecomment-292412577 "@retronym said: +1 to s"$"". Because it doesn't compile today, we don't risk changing the meaning of existing programs." +[^5]: https://github.com/Scala/Scala/pull/6953/files#diff-0023b3bfa053fb16603156b785efa7ad "" +[^6]: https://github.com/Scala/Scala/pull/4308 "SI-6476 Accept escaped quotes in interp strings" +[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" From 9d099fab2e0a9e59ed72c15aeb960c898c023b82 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Tue, 14 Jun 2022 00:25:50 +0000 Subject: [PATCH 1921/3075] Update SIPs state --- _sips/sips/adding-prefix-types.md | 4 ++-- ...llow-referring-to-other-arguments-in-default-parameters.md | 4 ++-- _sips/sips/curried-varargs.md | 4 ++-- _sips/sips/name-based-xml-literals.md | 4 ++-- _sips/sips/sealed-types.md | 4 ++-- _sips/sips/support-binary-integer-literals.md | 4 ++-- _sips/sips/uncluttering-abuse-of-match.md | 4 ++-- 7 files changed, 14 insertions(+), 14 deletions(-) diff --git a/_sips/sips/adding-prefix-types.md b/_sips/sips/adding-prefix-types.md index f2e30207ca..72e59c79ed 100644 --- a/_sips/sips/adding-prefix-types.md +++ b/_sips/sips/adding-prefix-types.md @@ -1,7 +1,7 @@ --- title: SIP-36 - Adding prefix types -status: under-review +status: submitted pull-request-number: 35 -stage: design +stage: pre-sip --- diff --git a/_sips/sips/allow-referring-to-other-arguments-in-default-parameters.md b/_sips/sips/allow-referring-to-other-arguments-in-default-parameters.md index 6ee5776d76..b5f01bf4e8 100644 --- a/_sips/sips/allow-referring-to-other-arguments-in-default-parameters.md +++ b/_sips/sips/allow-referring-to-other-arguments-in-default-parameters.md @@ -1,7 +1,7 @@ --- title: SIP-32 - Allow referring to other arguments in default parameters -status: under-review +status: submitted pull-request-number: 29 -stage: design +stage: pre-sip --- diff --git a/_sips/sips/curried-varargs.md b/_sips/sips/curried-varargs.md index 4772fd1adb..3733c8b704 100644 --- a/_sips/sips/curried-varargs.md +++ b/_sips/sips/curried-varargs.md @@ -1,7 +1,7 @@ --- title: SIP-NN - Curried varargs -status: under-review +status: submitted pull-request-number: 41 -stage: design +stage: pre-sip --- diff --git a/_sips/sips/name-based-xml-literals.md b/_sips/sips/name-based-xml-literals.md index bf471045af..4f18c4a711 100644 --- a/_sips/sips/name-based-xml-literals.md +++ b/_sips/sips/name-based-xml-literals.md @@ -1,7 +1,7 @@ --- title: SIP-NN - Name Based XML Literals -status: under-review +status: submitted pull-request-number: 42 -stage: design +stage: pre-sip --- diff --git a/_sips/sips/sealed-types.md b/_sips/sips/sealed-types.md index f9f5a8b70a..874e8f8ffa 100644 --- a/_sips/sips/sealed-types.md +++ b/_sips/sips/sealed-types.md @@ -1,7 +1,7 @@ --- title: SIP-NN - Sealed Types -status: under-review +status: submitted pull-request-number: 43 -stage: design +stage: pre-sip --- diff --git a/_sips/sips/support-binary-integer-literals.md b/_sips/sips/support-binary-integer-literals.md index a6d750722a..3b5d3e86b2 100644 --- a/_sips/sips/support-binary-integer-literals.md +++ b/_sips/sips/support-binary-integer-literals.md @@ -1,7 +1,7 @@ --- title: SIP-NN - Support Binary Integer Literals -status: under-review +status: submitted pull-request-number: 40 -stage: design +stage: pre-sip --- diff --git a/_sips/sips/uncluttering-abuse-of-match.md b/_sips/sips/uncluttering-abuse-of-match.md index 8d481a92a9..c870f4ecd7 100644 --- a/_sips/sips/uncluttering-abuse-of-match.md +++ b/_sips/sips/uncluttering-abuse-of-match.md @@ -1,7 +1,7 @@ --- title: SIP-NN - Uncluttering Abuse of Match -status: under-review +status: submitted pull-request-number: 37 -stage: design +stage: pre-sip --- From c52e4b4ca1b294ded85ac62c8c8d94f3db24d06a Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Tue, 14 Jun 2022 01:50:43 -0700 Subject: [PATCH 1922/3075] Squeeze out a few more words per review --- _overviews/scala3-book/control-structures.md | 1 + 1 file changed, 1 insertion(+) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index 224183497b..8b0500243e 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -400,6 +400,7 @@ i match case N => println("42") case n => println(s"You gave me: $n" ) ``` +If `i` is equal to `42`, then `case N` will match, and it will print the string `"42"`. It won't reach the default case. ### Handling multiple possible matches on one line From bb57b4954b62e9e26a81bcc46da82c609ca4913b Mon Sep 17 00:00:00 2001 From: SewonYun Date: Wed, 15 Jun 2022 00:10:43 +0900 Subject: [PATCH 1923/3075] Typo fix --- _ko/tutorials/scala-for-java-programmers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ko/tutorials/scala-for-java-programmers.md b/_ko/tutorials/scala-for-java-programmers.md index b3f3d1b6d3..1dc0358edb 100644 --- a/_ko/tutorials/scala-for-java-programmers.md +++ b/_ko/tutorials/scala-for-java-programmers.md @@ -464,7 +464,7 @@ Scala로 나타내는 것은 어렵지 않다: **와일드카드**이다. 밑줄 문자 `_`로 쓰며, 모든 값과 매치 되고 따로 이름을 붙이지 않는다. -매턴 매칭의 뛰어난 기능들을 모두 살펴보지는 못했지만, 문서를 너무 +패턴 매칭의 뛰어난 기능들을 모두 살펴보지는 못했지만, 문서를 너무 지루하게 만들지 않기 위하여 이쯤에서 멈추기로 한다. 이제 위에서 정의한 두 개의 예제 함수가 실제로 동작하는 모습을 보자. 산술 표현식 `(x+x)+(7+y)`에 대해 몇가지의 연산을 실행하는 간단한 `main` 함수를 From 8f7269b09a9fe77a295bdca23c0f5c95a0a41d49 Mon Sep 17 00:00:00 2001 From: Artem Korsakov Date: Wed, 15 Jun 2022 08:47:55 +0300 Subject: [PATCH 1924/3075] Update static-site.md --- _overviews/scala3-scaladoc/static-site.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index 127f6c59e7..0d6e22e0f5 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -186,7 +186,7 @@ Blog feature is described in [a separate document]({% link _overviews/scala3-sca ``` . └── / - ├── _layouts_/ + ├── _layouts/ │ └── ... ├── _docs/ │ └── ... From 76e08bfb94094dcd1ec132f9f845bb43f4fe6248 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Thu, 16 Jun 2022 21:04:46 +0800 Subject: [PATCH 1925/3075] add all scala-for-* files. Finish all files in Scala3-book. --- .../scala3-book/scala-for-java-devs.md | 1273 ++++++++++++++++ .../scala3-book/scala-for-javascript-devs.md | 1330 ++++++++++++++++ .../scala3-book/scala-for-python-devs.md | 1354 +++++++++++++++++ 3 files changed, 3957 insertions(+) create mode 100644 _zh-cn/overviews/scala3-book/scala-for-java-devs.md create mode 100644 _zh-cn/overviews/scala3-book/scala-for-javascript-devs.md create mode 100644 _zh-cn/overviews/scala3-book/scala-for-python-devs.md diff --git a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md new file mode 100644 index 0000000000..af719abbab --- /dev/null +++ b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md @@ -0,0 +1,1273 @@ +--- +title: 为 Java 开发者介绍Scala +type: chapter +description: This page is for Java developers who are interested in learning about Scala 3. +num: 73 +previous-page: interacting-with-java +next-page: scala-for-javascript-devs +--- + + +{% include_relative scala4x.css %} +

      + +此页面通过共享每种语言的并排示例，对 Java 和 Scala 编程语言进行了比较。 +它适用于了解 Java 并希望了解 Scala 的程序员，特别是通过 Scala 特性与 Java 特性的对比来了解。 + +## 概述 + +在进入示例之前，第一部分提供了以下部分的相对简短的介绍和总结。 +它从高层次上介绍了 Java 和 Scala 之间的异同，然后介绍了您在每天编写代码时会遇到的差异。 + +### 高层次的相似性 + +在高层次上，Scala 与 Java 有以下相似之处： + +- Scala代码编译成_.class_文件，打包成JAR文件，运行在JVM上 +- 这是一种[面向对象编程][modeling-oop] (OOP) 语言 +- 它是静态类型的 +- 两种语言都支持 lambdas 和 [高阶函数][hofs] +- 它们都可以与 IntelliJ IDEA 和 Microsoft VS Code 等 IDE 一起使用 +- 可以使用 Gradle、Ant 和 Maven 等构建工具构建项目 +- 它具有用于构建服务器端、网络密集型应用程序的出色库和框架，包括 Web 服务器应用程序、微服务、机器学习等（参见 [“Awesome Scala” 列表](https://github.com/lauris/awesome-scala)） +- Java 和 Scala 都可以使用 Scala 库： + - 他们可以使用 [Akka actor 库](https://akka.io) 来构建基于 actor 的并发系统，并使用 Apache Spark 来构建数据密集型应用程序 + - 他们可以使用 [Play Framework](https://www.playframework.com) 开发服务器端应用程序 +- 您可以使用 [GraalVM](https://www.graalvm.org) 将您的项目编译为本机可执行文件 +- Scala 可以无缝使用为 Java 开发的大量库 + +### 高层次的差异 + +同样在高层次上，Java 和 Scala 之间的区别是： + +- Scala 语法简洁易读；我们称之为_表现力_ +- 虽然它是静态类型的，但 Scala 经常感觉像是一门动态语言 +- Scala 是一种纯 OOP 语言，因此每个对象都是类的一个实例，而像运算符一样的符号 `+` 和 `+=` 是真正的方法；这意味着您可以创建自己的运算符 +- 除了是纯OOP语言，Scala还是纯FP语言；实际上，它鼓励 OOP 和 FP 的融合，具有用于逻辑的函数和用于模块化的对象 +- Scala 拥有一整套不可变集合，包括 `List`、`Vector` 和不可变的 `Map` 和 `Set` 实现 +- Scala 中的一切都是一个_表达式_：像 `if` 语句、`for` 循环、`match` 表达式，甚至 `try`/`catch` 表达式都有返回值 +- Scala 习惯上倾向缺省使用不可变性：鼓励您使用不可变（`final`）变量和不可变集合 +- 惯用的 Scala 代码不使用 `null`，因此不会遭受 `NullPointerException` +- Scala 生态系统在 sbt、Mill 等中还有其他 [构建工具][tools] +- 除了在 JVM 上运行之外，[Scala.js](https://www.scala-js.org) 项目允许您使用 Scala 作为 JavaScript 替代品 +- [Scala Native](http://www.scala-native.org) 项目添加了低级结构，让您可以编写“系统”级代码，也可以编译为本机可执行文件 + +{% comment %} +These are several notes that came up early in the writing process, and I (Alvin) can’t really address them: +TODO: Need a good, simple way to state that Scala has a sound type system +TODO: Points to make about Scala’s consistency? +TODO: Add a point about how the type system lets you express details as desired +{% endcomment %} + +### 编程层次差异 + +最后，这些是您在编写代码时每天都会看到的一些差异： + +- Scala 的语法极其一致 +- 变量和参数被定义为`val`（不可变，如Java中的`final`）或`var`（可变） +- _类型推导_ 让您的代码感觉是动态类型的，并有助于保持您的代码简洁 +- 除了简单的 `for` 循环之外，Scala 还具有强大的 `for` comprehensions，可以根据您的算法产生结果 +- 模式匹配和 `match` 表达式将改变你编写代码的方式 +- 默认情况下编写不可变代码会导致编写_表达式_而不是_语句_；随着时间的推移，您会发​​现编写表达式可以简化您的代码（和您的测试） +- [顶层定义][toplevel] 让您可以将方法、字段和其他定义放在任何地方，同时也带来简洁、富有表现力的代码 +- 您可以通过将多个 traits “混合”到类和对象中来创建_混搭_（特征类似于 Java 8 和更新版本中的接口） +- 默认情况下类是封闭的，支持 Joshua Bloch 在 _Effective Java_ 的习惯用法，“Design and document for inheritance or else forbid it” +- Scala 的 [上下文抽象][contextual] 和 _术语推导_ 提供了一系列特性： + - [扩展方法][extension-methods] 让您向封闭类添加新功能 + - [_给_实例][givens] 让您定义编译器可以在 _using_ 点合成的术语，从而使您的代码不那么冗长，实质上让编译器为您编写代码 + - [多元等式][multiversal] 允许您在编译时将相等比较限制为仅那些有意义的比较 +- Scala 拥有最先进的第三方开源函数式编程库 +- Scala 样例类就像 Java 14 中的记录；它们可以帮助您在编写 FP 代码时对数据进行建模，并内置对模式匹配和克隆等概念的支持 +- 由于名称参数、中缀符号、可选括号、扩展方法和 [高阶函数][hofs] 等功能，您可以创建自己的“控制结构”和 DSL +- Scala 文件不必根据它们包含的类或 trait 来命名 +- 许多其他好东西：伴生类和对象、宏、[联合][union-types] 和 [交集][intersection-types]、数字字面量、多参数列表、参数的默认值、命名参数等 + +### 用例子来进行特性对比 + +鉴于该介绍，以下部分提供了 Java 和 Scala 编程语言功能的并排比较。 + +## OOP 风格的类和方法 + +本节提供了与 OOP 风格的类和方法相关的特性的比较。 + +### 注释： + + + + + + + + + + +
      + // +
      /* ... */ +
      /** ... */       +
      + // +
      /* ... */ +
      /** ... */       +
      + +### OOP 风格类，主构造函数： + +Scala不遵循JavaBeans标准，因此我们在这里展示的Java代码 +与它后面的Scala代码等效，而不是显示以JavaBeans风格编写 +的Java代码。 + + + + + + + + + + +
      + class Person { +
        public String firstName; +
        public String lastName; +
        public int age; +
        public Person( +
          String firstName, +
          String lastName, +
          int age +
        ) { +
          this.firstName = firstName; +
          this.lastName = lastName; +
          this.age = age; +
        } +
        public String toString() { +
          return String.format("%s %s is %d years old.", firstName, lastName, age); +
        } +
      }       +
      + class Person ( +
        var firstName: String, +
        var lastName: String, +
        var age: Int +
      ):   +
        override def toString = s"$firstName $lastName is $age years old." +       +
      + +### 辅助构造函数： + + + + + + + + + + +
      + public class Person { +
        public String firstName; +
        public String lastName; +
        public int age; +
      +
        // primary constructor +
        public Person( +
          String firstName, +
          String lastName, +
          int age +
        ) { +
          this.firstName = firstName; +
          this.lastName = lastName; +
          this.age = age; +
        } +
      +
        // zero-arg constructor +
        public Person() { +
          this("", "", 0); +
        } +
      +
        // one-arg constructor +
        public Person(String firstName) { +
          this(firstName, "", 0); +
        } +
      +
        // two-arg constructor +
        public Person( +
          String firstName, +
          String lastName +
        ) { +
          this(firstName, lastName, 0); +
        } +
      +
      }       +
      + class Person ( +
        var firstName: String, +
        var lastName: String, +
        var age: Int +
      ): +
          // zero-arg auxiliary constructor +
          def this() = this("", "", 0) +
      +
          // one-arg auxiliary constructor +
          def this(firstName: String) = +
            this(firstName, "", 0) +
      +
          // two-arg auxiliary constructor +
          def this( +
            firstName: String, +
            lastName: String +
          ) = +
            this(firstName, lastName, 0) +
      +
      end Person       +
      + +### 类默认是封闭的： +“Plan for inheritance or else forbid it.” + + + + + + + + + + +
      + final class Person +
      + class Person +
      + +### 为扩展开放的类： + + + + + + + + + + +
      + class Person +
      + open class Person +
      + +### 单行方法： + + + + + + + + + + +
      + public int add(int a, int b) { +
        return a + b; +
      }       +
      + def add(a: Int, b: Int): Int = a + b +
      + +### 多行方法： + + + + + + + + + + +
      + public void walkThenRun() { +
        System.out.println("walk"); +
        System.out.println("run"); +
      }       +
      + def walkThenRun() = +
        println("walk") +
        println("run")       +
      + +### 不可变字段： + + + + + + + + + + +
      + final int i = 1; +
      + val i = 1 +
      + +### 可变字段： + + + + + + + + + + +
      + int i = 1; +
      var i = 1;       +
      + var i = 1 +
      + +## 接口、trait 和继承 + +本节将Java接口与Scala trait 进行比较，包括类如何扩展接口和 trait。 + +### 接口/trait： + + + + + + + + + + +
      + public interface Marker; +
      + trait Marker +
      + +### 简单接口： + + + + + + + + + + +
      + public interface Adder { +
        public int add(int a, int b); +
      }       +
      + trait Adder: +
        def add(a: Int, b: Int): Int       +
      + +### 有实体方法的接口： + + + + + + + + + + +
      + public interface Adder { +
        int add(int a, int b); +
        default int multiply( +
          int a, int b +
        ) { +
          return a * b; +
        } +
      }       +
      + trait Adder: +
        def add(a: Int, b: Int): Int +
        def multiply(a: Int, b: Int): Int = +
          a * b       +
      + +### 继承： + + + + + + + + + + +
      + class Dog extends Animal implements HasLegs, HasTail +
      + class Dog extends Animal, HasLegs, HasTail +
      + +### 扩展多个接口 + +这些接口和特征具有具体的、已实现的方法（默认方法）： + + + + + + + + + + +
      + interface Adder { +
        default int add(int a, int b) { +
          return a + b; +
        } +
      } +
      +
      interface Multiplier { +
        default int multiply ( +
          int a, +
          int b) +
        { +
          return a * b; +
        } +
      } +
      +
      public class JavaMath
      implements Adder, Multiplier {} +
      +
      JavaMath jm = new JavaMath(); +
      jm.add(1,1); +
      jm.multiply(2,2);       +
      + trait Adder: +
        def add(a: Int, b: Int) = a + b +
      +
      trait Multiplier: +
        def multiply(a: Int, b: Int) = a * b +
      +
      class ScalaMath extends Adder, Multiplier +
      +
      val sm = new ScalaMath +
      sm.add(1,1) +
      sm.multiply(2,2)       +
      + +### 混搭： + + + + + + + + + + +
      + N/A +
      + class DavidBanner +
      +
      trait Angry: +
        def beAngry() = +
          println("You won’t like me ...") +
      +
      trait Big: +
        println("I’m big") +
      +
      trait Green: +
        println("I’m green") +
      +
      // mix in the traits as DavidBanner +
      // is created +
      val hulk = new DavidBanner with Big, +
        Angry, Green       +
      + +## 控制结构 + +本节比较在 Java 和 Scala 中的[控制结构][control]。 + +### `if` 语句，单行： + + + + + + + + + + +
      + if (x == 1) { System.out.println(1); } +
      + if x == 1 then println(x) +
      + +### `if` 语句，多行： + + + + + + + + + + +
      + if (x == 1) { +
        System.out.println("x is 1, as you can see:") +
        System.out.println(x) +
      }       +
      + if x == 1 then +
        println("x is 1, as you can see:") +
        println(x)       +
      + +### if, else if, else: + + + + + + + + + + +
      + if (x < 0) { +
        System.out.println("negative") +
      } else if (x == 0) { +
        System.out.println("zero") +
      } else { +
        System.out.println("positive") +
      }       +
      + if x < 0 then +
        println("negative") +
      else if x == 0 +
        println("zero") +
      else +
        println("positive")       +
      + +### `if` 作为方法体： + + + + + + + + + + +
      + public int min(int a, int b) { +
        return (a < b) ? a : b; +
      }       +
      + def min(a: Int, b: Int): Int = +
        if a < b then a else b       +
      + +### 从 `if` 返回值： + +在 Java 中调用_三元运算符_： + + + + + + + + + + +
      + int minVal = (a < b) ? a : b; +
      + val minValue = if a < b then a else b +
      + +### `while` 循环： + + + + + + + + + + +
      + while (i < 3) { +
        System.out.println(i); +
        i++; +
      }       +
      + while i < 3 do +
        println(i) +
        i += 1       +
      + +### `for` 循环，单行： + + + + + + + + + + +
      + for (int i: ints) { +
        System.out.println(i); +
      }       +
      + //preferred +
      for i <- ints do println(i) +
      +
      // also available +
      for (i <- ints) println(i)       +
      + +### `for` 循环，多行： + + + + + + + + + + +
      + for (int i: ints) { +
        int x = i * 2; +
        System.out.println(x); +
      }       +
      + for +
        i <- ints +
      do +
        val x = i * 2 +
        println(s"i = $i, x = $x")       +
      + +### `for` 循环，多生成器： + + + + + + + + + + +
      + for (int i: ints1) { +
        for (int j: chars) { +
          for (int k: ints2) { +
            System.out.printf("i = %d, j = %d, k = %d\n", i,j,k); +
          } +
        } +
      }       +
      + for +
        i <- 1 to 2 +
        j <- 'a' to 'b' +
        k <- 1 to 10 by 5 +
      do +
        println(s"i = $i, j = $j, k = $k")       +
      + +### 带守卫（`if`）表达式的生成器： + + + + + + + + + + +
      + List ints = +
        ArrayList(1,2,3,4,5,6,7,8,9,10); +
      +
      for (int i: ints) { +
        if (i % 2 == 0 && i < 5) { +
          System.out.println(x); +
        } +
      }       +
      + for +
        i <- 1 to 10 +
        if i % 2 == 0 +
        if i < 5 +
      do +
        println(i)       +
      + +### `for` comprehension: + + + + + + + + + + +
      + N/A +
      + val list = +
        for +
          i <- 1 to 3 +
        yield +
          i * 10 +
      // list: Vector(10, 20, 30)       +
      + +### switch/match: + + + + + + + + + + +
      + String monthAsString = ""; +
      switch(day) { +
        case 1: monthAsString = "January"; +
                break; +
        case 2: monthAsString = "February"; +
                break; +
        default: monthAsString = "Other"; +
                break; +
      }       +
      + val monthAsString = day match +
        case 1 => "January" +
        case 2 => "February" +
        _ => "Other" +       +
      + +### switch/match, 每个情况下多个条件： + + + + + + + + + + +
      + String numAsString = ""; +
      switch (i) { +
        case 1: case 3: +
        case 5: case 7: case 9: +
          numAsString = "odd"; +
          break; +
        case 2: case 4: +
        case 6: case 8: case 10: +
          numAsString = "even"; +
          break; +
        default: +
          numAsString = "too big"; +
          break; +
      }       +
      + val numAsString = i match +
        case 1 | 3 | 5 | 7 | 9 => "odd" +
        case 2 | 4 | 6 | 8 | 10 => "even" +
        case _ => "too big" +       +
      + +### try/catch/finally: + + + + + + + + + + +
      + try { +
        writeTextToFile(text); +
      } catch (IOException ioe) { +
        println(ioe.getMessage()) +
      } catch (NumberFormatException nfe) { +
        println(nfe.getMessage()) +
      } finally { +
        println("Clean up resources here.") +
      }       +
      + try +
        writeTextToFile(text) +
      catch +
        case ioe: IOException => +
          println(ioe.getMessage) +
        case nfe: NumberFormatException => +
          println(nfe.getMessage) +
      finally +
        println("Clean up resources here.")       +
      + +## 集合类 + +本节比较 Java 和 Scala 里的[集合类][collections-classes]。 + +### 不可变集合类 + +如何创建不可变集合实例的例子。 + +### Sequences: + + + + + + + + + + +
      + List strings = List.of("a", "b", "c"); +
      + val strings = List("a", "b", "c") +
      val strings = Vector("a", "b", "c")       +
      + +### Sets: + + + + + + + + + + +
      + Set set = Set.of("a", "b", "c"); +
      + val set = Set("a", "b", "c") +
      + +### Maps: + + + + + + + + + + +
      + Map map = Map.of( +
        "a", 1, +
        "b", 2, +
        "c", 3 +
      );       +
      + val map = Map( +
        "a" -> 1, +
        "b" -> 2, +
        "c" -> 3 +
      )       +
      + +### 可变集合类 + +Scala 在其 _scala.collection.mutable_ 包中有可变集合类，例如 `ArrayBuffer`、`Map` 和 `Set`。 +在 [导入它们][imports] 到当前作用域之后，创建它们就像刚刚显示的不可变 `List`、`Vector`、`Map` 和 `Set` 示例一样。 + +Scala 还有一个 `Array` 类，您可以将其视为 Java `array` 原始类型的包装器。 +一个 Scala `Array[A]` 映射到一个 Java `A[]`，所以你可以认为这个是 Scala `Array[String]`： + +```scala +val a = Array("a", "b") +``` + +这个追溯到 Java 的 `String[]`: + +```scala +String[] a = ["a", "b"]; +``` + +但是，Scala `Array` 还具有您期望在 Scala 集合中使用的所有函数方法，包括 `map` 和 `filter`： + +```scala +val nums = Array(1, 2, 3, 4, 5) +val doubledNums = nums.map(_ * 2) +val 过滤Nums = nums.filter(_ > 2) +``` + +因为 Scala `Array` 的表示方式与 Java `array` 相同，所以您可以轻松地在 Scala 代码中使用返回数组的 Java 方法。 + +> 尽管讨论了 `Array`，但请记住，在 Scala 中通常有可能更适合的 `Array` 替代品。 +> 数组对于与其他语言（Java、JavaScript）的互操作很有用，并且在编写需要从底层平台获得最大性能的低级代码时也很有用。但总的来说，当你需要使用序列时，Scala 的习惯用法是更喜欢像 `Vector` 和 `List` 这样的不可变序列，然后在你真的需要可变序列时使用 `ArrayBuffer`。 + +您还可以使用 Scala `CollectionConverters` 对象在 Java 和 Scala 集合类之间进行转换。 +在不同的包中有两个对象，一个用于从 Java 转换为 Scala，另一个用于从 Scala 转换为 Java。 +下表显示了可能的转换： + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      JavaScala
      java.util.Collectionscala.collection.Iterable
      java.util.Listscala.collection.mutable.Buffer
      java.util.Setscala.collection.mutable.Set
      java.util.Mapscala.collection.mutable.Map
      java.util.concurrent.ConcurrentMapscala.collection.mutable.ConcurrentMap
      java.util.Dictionaryscala.collection.mutable.Map
      + +## 集合类的方法 + +由于能够将 Java 集合视为流，Java 和 Scala 现在可以使用许多相同的通用函数方法： + +- `map` +- `filter` +- `forEach`/`foreach` +- `findFirst`/`find` +- `reduce` + +如果您习惯在 Java 中将这些方法与 lambda 表达式一起使用，您会发现在 Scala 的 [集合类][collections-classes] 上使用相同的方法很容易。 + +Scala 也有_数十个_其他 [集合方法][collections-methods]，包括 `head`、`tail`、`drop`、`take`、`distinct`、`flatten` 等等。 +起初你可能想知道为什么会有这么多方法，但是在使用 Scala 之后你会意识到_因为_有这些方法，你很少需要再编写自定义的 `for` 循环了。 + +（这也意味着你也很少需要_读_自定义的 `for` 循环。 +因为开发人员倾向于在_读_代码上花费的时间是_编写_代码的十倍，这很重要。） + +## 元组 + +Java 元组是这样创建的： + +```scala +Pair pair = + new Pair("Eleven", 11); + +Triplet triplet = + Triplet.with("Eleven", 11, 11.0); +Quartet triplet = + Quartet.with("Eleven", 11, 11.0, new Person("Eleven")); +``` + +其他 Java 元组名称是 Quintet、Sextet、Septet、Octet、Ennead、Decade。 + +Scala 中任何大小的元组都是通过将值放在括号内来创建的，如下所示： + +```scala +val a = ("eleven") +val b = ("eleven", 11) +val c = ("eleven", 11, 11.0) +val d = ("eleven", 11, 11.0, Person("Eleven")) +``` + +## 枚举 + +本节比较 Java 和 Scala 中的枚举。 + +### 基本枚举： + + + + + + + + + + +
      + enum Color { +
        RED, GREEN, BLUE +
      }       +
      + enum Color: +
        case Red, Green, Blue       +
      + +### 参数化的枚举： + + + + + + + + + + +
      + enum Color { +
        Red(0xFF0000), +
        Green(0x00FF00), +
        Blue(0x0000FF); +
      +
        private int rgb; +
      +
        Color(int rgb) { +
          this.rgb = rgb; +
        } +
      }       +
      + enum Color(val rgb: Int): +
        case Red   extends Color(0xFF0000) +
        case Green extends Color(0x00FF00) +
        case Blue  extends Color(0x0000FF)       +
      + +### 用户定义的枚举成员： + + + + + + + + + + +
      + enum Planet { +
        MERCURY (3.303e+23, 2.4397e6), +
        VENUS   (4.869e+24, 6.0518e6), +
        EARTH   (5.976e+24, 6.37814e6); +
        // more planets ... +
      +
        private final double mass; +
        private final double radius; +
      +
        Planet(double mass, double radius) { +
          this.mass = mass; +
          this.radius = radius; +
        } +
      +
        public static final double G = +
          6.67300E-11; +
      +
        private double mass() { +
          return mass; +
        } +
      +
        private double radius() { +
          return radius; +
        } +
      +
        double surfaceGravity() { +
          return G * mass / +
            (radius * radius); +
        } +
      +
        double surfaceWeight( +
          double otherMass +
        ) { +
          return otherMass * +
            surfaceGravity(); +
        } +
      +
      }       +
      + enum Planet( +
        mass: Double, +
        radius: Double +
      ): +
        case Mercury extends
          Planet(3.303e+23, 2.4397e6) +
        case Venus extends
          Planet(4.869e+24, 6.0518e6) +
        case Earth extends
          Planet(5.976e+24, 6.37814e6) +
          // more planets ... +
      +
        private final val G = 6.67300E-11 +
      +
        def surfaceGravity =
          G * mass / (radius * radius) +
      +
        def surfaceWeight(otherMass: Double) +
          = otherMass * surfaceGravity       +
      + +## 异常和错误处理 + +本节介绍 Java 和 Scala 中的异常处理之间的差异。 + +### Java 使用检查异常 + +Java 使用检查的异常，因此在 Java 代码中，您历来编写过 `try`/`catch`/`finally` 块，以及方法上的 `throws` 子句： + +```scala +public int makeInt(String s) +throws NumberFormatException { + // code here to convert a String to an int +} +``` + +### Scala 不使用检查异常 + +Scala 的习惯用法是_不_使用这样的检查异常。 +在处理可能抛出异常的代码时，您可以使用 `try`/`catch`/`finally` 块从抛出异常的代码中捕获异常，但是如何从那里开始的方式是不同的。 + +解释这一点的最好方法是说 Scala 代码是由具有返回值的_表达式_组成的。 +其结果是，最终你写代就像写一系列代数表达式： + +```scala +val a = f(x) +val b = g(a,z) +val c = h(b,y) +``` + +这很好，它只是代数。 +您创建方程来解决小问题，然后组合方程来解决更大的问题。 + +非常重要的是——正如你在代数课程中所记得的那样——代数表达式不会短路——它们不会抛出会破坏一系列方程的异常。 + +因此，在 Scala 中，我们的方法不会抛出异常。 +相反，它们返回像 `Option` 这样的类型。 +例如，这个 `makeInt` 方法捕获一个可能的异常并返回一个 `Option` 值： + +```scala +def makeInt(s: String): Option[Int] = + try + Some(s.toInt) + catch + case e: NumberFormatException => None +``` + +Scala `Option` 类似于 Java `Optional` 类。 +如图所示，如果 string 到 int 的转换成功，则在 `Some` 值中返回 `Int`，如果失败，则返回 `None` 值。 +`Some` 和 `None` 是 `Option` 的子类型，因此该方法被声明为返回 `Option[Int]` 类型。 + +当您有一个 `Option` 值时，例如 `makeInt` 返回的值，有很多方法可以使用它，具体取决于您的需要。 +此代码显示了一种可能的方法： + +```scala +makeInt(aString) match + case Some(i) => println(s"Int i = $i") + case None => println(s"Could not convert $aString to an Int.") +``` + +`Option` 在 Scala 中很常用，它内置在标准库的许多类中。 +其他类似的类的集合，例如 Try/Success/Failure 和 Either/Left/Right，提供了更大的灵活性。 + +有关在 Scala 中处理错误和异常的更多信息，请参阅 [函数式错误处理][error-handling] 部分。 + +## Scala 独有的概念 + +以上就是 Java 和 Scala 语言的比较。 + +Scala 中还有其他一些概念目前在 Java 11 中是没有的。 +这包括： + +- 与 Scala 的 [上下文抽象][contextual] 相关的一切 +- 几个 Scala 方法特性： + - 多参数列表 + - 默认参数值 + - 调用方法时使用命名参数 +- 样例类（如 Java 14 中的“记录”）、样例对象以及伴生类和对象（参见 [领域建模][modeling-intro]）一章 +- 创建自己的控制结构和 DSL 的能力 +- [顶级定义][toplevel] +- 模式匹配 +- `match` 表达式的高级特性 +- 类型 lambdas +- trait参数 +- [不透明类型别名][opaque] +- [多元相等性][equality] +- [类型类][type-classes] +- 中缀方法 +- 宏和元编程 + + +[collections-classes]: {% link _overviews/scala3-book/collections-classes.md %} +[collections-methods]: {% link _overviews/scala3-book/collections-methods.md %} +[control]: {% link _overviews/scala3-book/control-structures.md %} +[equality]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} +[error-handling]: {% link _overviews/scala3-book/fp-functional-error-handling.md %} +[extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[hofs]: {% link _overviews/scala3-book/fun-hofs.md %} +[imports]: {% link _overviews/scala3-book/packaging-imports.md %} +[modeling-intro]: {% link _overviews/scala3-book/domain-modeling-intro.md %} +[modeling-oop]: {% link _overviews/scala3-book/domain-modeling-oop.md %} +[opaque]: {% link _overviews/scala3-book/types-opaque-types.md %} +[tools]: {% link _overviews/scala3-book/scala-tools.md %} +[toplevel]: {% link _overviews/scala3-book/taste-toplevel-definitions.md %} +[type-classes]: {% link _overviews/scala3-book/ca-type-classes.md %} + +[concurrency]: {% link _overviews/scala3-book/concurrency.md %} +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} +[control]: {% link _overviews/scala3-book/control-structures.md %} +[fp-intro]: {% link _overviews/scala3-book/fp-intro.md %} +[intersection-types]: {% link _overviews/scala3-book/types-intersection.md %} +[modeling-fp]: {% link _overviews/scala3-book/domain-modeling-fp.md %} +[multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} +[union-types]: {% link _overviews/scala3-book/types-union.md %} + +
      diff --git a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md new file mode 100644 index 0000000000..13cb85cec2 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md @@ -0,0 +1,1330 @@ +--- +title: Scala for JavaScript Developers +type: chapter +description: This chapter provides an introduction to Scala 3 for JavaScript developers +num: 74 +previous-page: scala-for-java-devs +next-page: scala-for-python-devs +--- + + +{% include_relative scala4x.css %} +
      + +此页面提供了 JavaScript 和 Scala 编程语言之间的比较。 +它适用于了解 JavaScript 并希望了解 Scala 的程序员，特别是通过查看 JavaScript 语言功能与 Scala 比较的示例。 + +## 概述 + +本节对以下各节进行了相对简短的介绍和总结。 +它从高层次上介绍了 JavaScript 和 Scala 之间的异同，然后介绍了您在每天编写代码时会遇到的差异。 + +### 高层次的相似性 + +在高层次上，Scala 与 JavaScript 有以下相似之处： + +- 两者都被认为是高级编程语言，您不必关心指针和手动内存管理等低级概念 +- 两者都有一个相对简单、简洁的语法 +- 两者都支持 C/C++/Java 风格的花括号语法，用于编写方法和其他代码块 +- 两者都包括面向对象编程 (OOP) 的特性（如类） +- 两者都包含用于 [函数式编程][fp-intro] (FP) 的（如 lambda） +- JavaScript 在浏览器和 Node.js 等其他环境中运行。 + Scala 的 [Scala.js](https://www.scala-js.org) 风格以 JavaScript 为目标，因此 Scala 程序可以在相同的环境中运行。 +- 开发人员使用 [Node.js](https://nodejs.org) 在 JavaScript 和 Scala 中编写服务器端应用程序； [Play Framework](https://www.playframework.com/) 之类的项目也可以让您在 Scala 中编写服务器端应用程序 +- 两种语言都有相似的 `if` 语句、`while` 循环和 `for` 循环 +- 从 [在这个 Scala.js 页面](https://www.scala-js.org/libraries/index.html) 开始，您会发现许多支持 React、Angular、jQuery 和许多其他 JavaScript 和Scala 库 +- JavaScript 对象是可变的；以命令式风格编写时，Scala 对象_可以_是可变的 +- JavaScript 和 Scala 都支持 _promises_ 作为处理异步计算结果的一种方式（[Scala concurrency][concurrency] 使用期货和承诺） + +### 高层次差异 + +同样在高层次上，JavaScript 和 Scala 之间的一些区别是： + +- JavaScript 是动态类型的，Scala 是静态类型的 + - 尽管 Scala 是静态类型的，但类型推断之类的特性让它感觉像是一种动态语言（正如您将在下面的示例中看到的那样） +- Scala 惯用语默认支持不变性：鼓励您使用不可变变量和不可变集合 +- Scala 语法简洁易读；我们称之为_表现力_ +- Scala 是一种纯 OOP 语言，因此每个对象都是类的一个实例，而像运算符一样的符号 `+` 和 `+=` 是真正的方法；这意味着您可以创建自己的方法作为运算符 +- 作为一种纯 OOP 语言和纯 FP 语言，Scala 鼓励 OOP 和 FP 的融合，具有用于逻辑的函数和用于模块化的不可变对象 +- Scala 拥有最先进的第三方开源函数式编程库 +- Scala 中的一切都是一个_表达式_：像 `if` 语句、`for` 循环、`match` 表达式，甚至 `try`/`catch` 表达式都有返回值 +- [Scala Native](https://scala-native.readthedocs.io/en/v0.3.9-docs) 项目让您可以编写“系统”级代码，也可以编译为本机可执行文件 + +### 编程层次差异 + +在较低的层次上，这些是您在编写代码时每天都会看到的一些差异： + +- Scala 变量和参数使用 `val`（不可变，如 JavaScript `const`）或 `var`（可变，如 JavaScript `var` 或 `let`）定义 +- Scala 不在行尾使用分号 +- Scala 是静态类型的，尽管在许多情况下您不需要声明类型 +- Scala 使用 trait 作为接口并创建_混搭_ +- 除了简单的 `for` 循环之外，Scala 还具有强大的 `for` comprehensions，可以根据您的算法产生结果 +- 模式匹配和 `match` 表达式将改变你编写代码的方式 +- Scala 的 Scala 的 [上下文抽象][contextual] 和 _术语推导_ 提供了一系列特性： + - [扩展方法][extension-methods] 允许您在不破坏模块化的情况下向封闭类添加新功能，方法是仅在特定范围内可用（与猴子补丁相反，它会污染代码的其他区域） + - [给实例][givens] 让您定义编译器可以用来为您合成代码的术语 + - 类型安全和[多元等式][multiversal]让您将相等比较——在编译时——仅限于那些有意义的比较 +- 由于名称参数、中缀符号、可选括号、扩展方法和 [高阶函数][hofs] 等功能，您可以创建自己的“控制结构”和 DSL +- 您可以在本书中阅读到许多其他好东西：样例类、伴生类和对象、宏、[联合][union-type]和[交集][intersection-types]类型、多参数列表、命名参数等 + +## 变量和类型 + +### 注释 + + + + + + + + + + +
      + // +
      /* ... */ +
      /** ... */       +
      + // +
      /* ... */ +
      /** ... */       +
      + +### 可变变量 + + + + + + + + + + +
      + let   // now preferred for mutable +
      var   // old mutable style       +
      + var  // used for mutable variables +
      + +### 不可变变量 + + + + + + + + + + +
      + const +
      + val +
      + +Scala 的经验法则是使用 `val` 声明变量，除非有特定原因需要可变变量。 + +## 命名标准 + +JavaScript 和 Scala 通常使用相同的 _CamelCase_ 命名标准。 +变量命名为 `myVariableName`，方法命名为 `lastIndexOf`，类和对象命名为 `Animal` 和 `PrintedBook` 。 + +## 字符串 + +JavaScript 和 Scala 中字符串的许多用法相似，但 Scala 仅对简单字符串使用双引号，对多行字符串使用三引号。 + +### 字符串基础 + + + + + + + + + + +
      + // use single- or double-quotes +
      let msg = 'Hello, world'; +
      let msg = "Hello, world";       +
      + // use only double-quotes +
      val msg = "Hello, world"       +
      + +### 插入 + + + + + + + + + + +
      + let name = 'Joe'; +
      +
      // JavaScript uses backticks +
      let msg = `Hello, ${name}`;       +
      + val name = "Joe" +
      val age = 42 +
      val weight = 180.5 +
      +
      // use `s` before a string for simple interpolation +
      println(s"Hi, $name")   // "Hi, Joe" +
      println(s"${1 + 1}")    // "2" +
      +
      // `f` before a string allows printf-style formatting. +
      // this example prints: +
      // "Joe is 42 years old, and weighs" +
      // "180.5 pounds." +
      println(f"$name is $age years old, and weighs $weight%.1f pounds.")       +
      + +### 带插入的多行字符串 + + + + + + + + + + +
      + let name = "joe"; +
      let str = ` +
      Hello, ${name}. +
      This is a multiline string. +
      `; +       +
      + val name = "Martin Odersky" +
      +
      val quote = s""" +
      |$name says +
      |Scala is a fusion of +
      |OOP and FP. +
      """.stripMargin.replaceAll("\n", " ").trim +
      +
      // result: +
      // "Martin Odersky says Scala is a fusion of OOP and FP." +       +
      + +JavaScript 和 Scala 也有类似的处理字符串的方法，包括 `charAt`、`concat`、`indexOf` 等等。 +`\n`、`\f`、`\t` 等转义字符在两种语言中也是相同的。 + +## 数字和算术 + +JavaScript 和 Scala 之间的数字运算符很相似。 +最大的不同是 Scala 不提供 `++` 和 `--` 运算符。 + +### 数字运算符： + + + + + + + + + + +
      + let x = 1; +
      let y = 2.0; +
        +
      let a = 1 + 1; +
      let b = 2 - 1; +
      let c = 2 * 2; +
      let d = 4 / 2; +
      let e = 5 % 2; +       +
      + val x = 1 +
      val y = 2.0 +
        +
      val a = 1 + 1 +
      val b = 2 - 1 +
      val c = 2 * 2 +
      val d = 4 / 2 +
      val e = 5 % 2 +       +
      + +### 自增和自减： + + + + + + + + + + +
      + i++; +
      i += 1; +
      +
      i--; +
      i -= 1;       +
      + i += 1; +
      i -= 1;       +
      + +或许最大的区别在于像`+`和`-`这样的“操作符”在Scala中实际上是_方法_，而不是操作符。 +Scala 数字也有这些相关的方法： + +```scala +var a = 2 +a *= 2 // 4 +a /= 2 // 2 +``` + +Scala 的 `Double` 类型最接近于 JavaScript 的默认 `number` 类型， +`Int` 表示有符号的 32 位整数值，而 `BigInt` 对应于 JavaScript 的 `bigint`。 + +这些是 Scala `Int` 和 `Double` 值。 +请注意，类型不必显式声明： + +```scala +val i = 1 // Int +val d = 1.1 // Double +``` + +你可以按需要使用其它数字类型： + +```scala +val a: Byte = 0 // Byte = 0 +val a: Double = 0 // Double = 0.0 +val a: Float = 0 // Float = 0.0 +val a: Int = 0 // Int = 0 +val a: Long = 0 // Long = 0 +val a: Short = 0 // Short = 0 + +val x = BigInt(1_234_456_789) +val y = BigDecimal(1_234_456.890) +``` + +### 布尔值 + +两个语言都在布尔值中用 `true` 和 `false`。 + + + + + + + + + + +
      + let a = true; +
      let b = false;       +
      + val a = true +
      val b = false       +
      + +## 日期 + +日期是两种语言中另一种常用的类型。 + +### 获取当前日期： + + + + + + + + + + +
      + let d = new Date();
      +
      // result: +
      // Sun Nov 29 2020 18:47:57 GMT-0700 (Mountain Standard Time) +       +
      + // different ways to get the current date and time +
      import java.time.* +
      +
      val a = LocalDate.now +
          // 2020-11-29 +
      val b = LocalTime.now +
          // 18:46:38.563737 +
      val c = LocalDateTime.now +
          // 2020-11-29T18:46:38.563750 +
      val d = Instant.now +
          // 2020-11-30T01:46:38.563759Z       +
      + +### 指定不同的日期： + + + + + + + + + + +
      + let d = Date(2020, 1, 21, 1, 0, 0, 0); +
      let d = Date(2020, 1, 21, 1, 0, 0); +
      let d = Date(2020, 1, 21, 1, 0); +
      let d = Date(2020, 1, 21, 1); +
      let d = Date(2020, 1, 21);       +
      + val d = LocalDate.of(2020, 1, 21) +
      val d = LocalDate.of(2020, Month.JANUARY, 21) +
      val d = LocalDate.of(2020, 1, 1).plusDays(20) +       +
      + +在这种情况下，Scala 使用 Java 附带的日期和时间类。 +JavaScript 和 Scala 之间的许多日期/时间方法是相似的。 +有关详细信息，请参阅 [_java.time_ 包](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/package-summary.html)。 + +## 函数 + +在 JavaScript 和 Scala 中，函数都是对象，因此它们的功能相似，但它们的语法和术语略有不同。 + +### 命名函数，一行： + + + + + + + + + + +
      + function add(a, b) { +
        return a + b; +
      } +
      add(2, 2);   // 4       +
      + // technically this is a method, not a function +
      def add(a: Int, b: Int) = a + b +
      add(2, 2)   // 4       +
      + +### 命名函数，多行： + + + + + + + + + + +
      + function addAndDouble(a, b) { +
        // imagine this requires +
        // multiple lines +
        return (a + b) * 2 +
      }       +
      + def addAndDouble(a: Int, b: Int): Int = +
        // imagine this requires +
        // multiple lines +
        (a + b) * 2       +
      + +在 Scala 中，显示 `Int` 返回类型是可选的。 +它_不_显示在 `add` 示例中，而_是_显示在 `addAndDouble` 示例中，因此您可以看到这两种方法。 + +## 匿名函数 + +JavaScript 和 Scala 都允许您定义匿名函数，您可以将其传递给其他函数和方法。 + +### 箭头和匿名函数 + + + + + + + + + + +
      + // arrow function +
      let log = (s) => console.log(s) +
      +
      // anonymous function +
      let log = function(s) { +
        console.log(s); +
      } +
      +
      // use either of those functions here +
      function printA(a, log) { +
        log(a); +
      }       +
      + // a function (an anonymous function assigned to a variable) +
      val log = (s: String) => console.log(s) +
      +
      // a scala method. methods tend to be used much more often, +
      // probably because they’re easier to read. +
      def log(a: Any) = console.log(a) +
      +
      // a function or a method can be passed into another +
      // function or method +
      def printA(a: Any, f: log: Any => Unit) = log(a) +       +
      + +在 Scala 中，您很少使用所示的第一种语法来定义函数。 +相反，您经常在使用点定义匿名函数。 +许多集合方法是 [高阶函数][hofs]并接受函数参数，因此您编写如下代码： + +```scala +// map method, long form +List(1,2,3).map(i => i * 10) // List(10,20,30) + +// map, short form (which is more commonly used) +List(1,2,3).map(_ * 10) // List(10,20,30) + +// filter, short form +List(1,2,3).filter(_ < 3) // List(1,2) + +// filter and then map +List(1,2,3,4,5).filter(_ < 3).map(_ * 10) // List(10, 20) +``` + +## 类 + +Scala 既有类也有样例类。 +_类_ 与 JavaScript 类相似，通常用于 [OOP 风格应用程序][modeling-oop]（尽管它们也可以在 FP 代码中使用），并且 _样例类_有附加的特性，这让它在 [FP 风格应用][modeling-fp]中很有用。 + +下面的例子展示了如何创建几个类型作为枚举，然后定义一个 OOP 风格的 `Pizza` 类。 +最后，创建并使用了一个 `Pizza` 实例： + +```scala +// create some enumerations that the Pizza class will use +enum CrustSize: + case Small, Medium, Large + +enum CrustType: + case Thin, Thick, Regular + +enum Topping: + case Cheese, Pepperoni, BlackOlives, GreenOlives, Onions + +// import those enumerations and the ArrayBuffer, +// so the Pizza class can use them +import CrustSize.* +import CrustType.* +import Topping.* +import scala.collection.mutable.ArrayBuffer + +// define an OOP style Pizza class +class Pizza( + var crustSize: CrustSize, + var crustType: CrustType +): + + private val toppings = ArrayBuffer[Topping]() + + def addTopping(t: Topping): Unit = + toppings += t + + def removeTopping(t: Topping): Unit = + toppings -= t + + def removeAllToppings(): Unit = + toppings.clear() + + override def toString(): String = + s""" + |Pizza: + | Crust Size: ${crustSize} + | Crust Type: ${crustType} + | Toppings: ${toppings} + """.stripMargin + +end Pizza + +// create a Pizza instance +val p = Pizza(Small, Thin) + +// change the crust +p.crustSize = Large +p.crustType = Thick + +// add and remove toppings +p.addTopping(Cheese) +p.addTopping(Pepperoni) +p.addTopping(BlackOlives) +p.removeTopping(Pepperoni) + +// print the pizza, which uses its `toString` method +println(p) +``` + +## 接口、trait 和继承 + +Scala 使用 trait 作为接口，也可以创建混搭。 +trait 可以有抽象和具体的成员，包括方法和字段。 + +这个例子展示了如何定义两个 traits，创建一个扩展和实现这些 traits 的类，然后创建和使用该类的一个实例： + +```scala +trait HasLegs: + def numLegs: Int + def walk(): Unit + def stop() = println("Stopped walking") + +trait HasTail: + def wagTail(): Unit + def stopTail(): Unit + +class Dog(var name: String) extends HasLegs, HasTail: + val numLegs = 4 + def walk() = println("I’m walking") + def wagTail() = println("⎞⎜⎛ ⎞⎜⎛") + def stopTail() = println("Tail is stopped") + override def toString = s"$name is a Dog" + +// create a Dog instance +val d = Dog("Rover") + +// use the class’s attributes and behaviors +println(d.numLegs) // 4 +d.wagTail() // "⎞⎜⎛ ⎞⎜⎛" +d.walk() // "I’m walking" +``` + +## 控制结构 + +除了在 JavaScript 中使用 `===` 和 `!==` 之外，比较和逻辑运算符在 JavaScript 和 Scala 中几乎相同。 + +{% comment %} +TODO: Sébastien mentioned that `===` is closest to `eql` in Scala. Update this area. +{% endcomment %} + +### 比较运算符 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      JavaScriptScala
      + == + ==
      + === + ==
      + != + !=
      + !== + !=
      + > + >
      + < + <
      + >= + >=
      + <= + <=
      + +### 逻辑运算符 + + + + + + + + + + + + +
      JavaScriptScala
      + && +
      || +
      !       +       		+ && +
      || +
      !       +
      + +## if/then/else 表达式 + +JavaScript和 Scala if/then/else 语句相似。 +在 Scala 2 中它们几乎相同，但在 Scala 3 中，花括号不再是必需的（尽管它们仍然可以使用）。 + +### `if` 语句，单行： + + + + + + + + + + +
      + if (x == 1) { console.log(1); } +
      + if x == 1 then println(x) +
      + +### `if` 语句，多行： + + + + + + + + + + +
      + if (x == 1) { +
        console.log("x is 1, as you can see:") +
        console.log(x) +
      }       +
      + if x == 1 then +
        println("x is 1, as you can see:") +
        println(x)       +
      + +### if, else if, else: + + + + + + + + + + +
      + if (x < 0) { +
        console.log("negative") +
      } else if (x == 0) { +
        console.log("zero") +
      } else { +
        console.log("positive") +
      }       +
      + if x < 0 then +
        println("negative") +
      else if x == 0 +
        println("zero") +
      else +
        println("positive")       +
      + +### 从 `if` 返回值： + +JavaScript 使用三元运算符，Scala 像往常一样使用它的 `if` 表达式： + + + + + + + + + + +
      + let minVal = a < b ? a : b; +
      + val minValue = if a < b then a else b +
      + +### `if` 作为方法体： + +Scala 方法往往很短，您可以轻松地使用 `if` 作为方法体： + + + + + + + + + + +
      + function min(a, b) { +
        return (a < b) ? a : b; +
      }       +
      + def min(a: Int, b: Int): Int = +
        if a < b then a else b       +
      + +在 Scala 3 中，如果您愿意，您仍然可以使用“花括号”样式。 +例如，您可以像这样编写 if/else-if/else 表达式： + +```scala +if (i == 0) { + println(0) +} else if (i == 1) { + println(1) +} else { + println("other") +} +``` + +## 循环 + +JavaScript 和 Scala 都有 `while` 循环和 `for` 循环。 +Scala 曾经有 do/while 循环，但它们已从语言中删除。 + +### `while` 循环： + + + + + + + + + + +
      + let i = 0; +
      while (i < 3) { +
        console.log(i); +
        i++; +
      }       +
      + var i = 0; +
      while i < 3 do +
        println(i) +
        i += 1       +
      + +如果你愿意，Scala 代码也可以写成这样： + +```scala +var i = 0 +while (i < 3) { + println(i) + i += 1 +} +``` + +以下示例展示了 JavaScript 和 Scala 中的“for”循环。 +他们假设您可以使用这些集合： + +```scala +// JavaScript +let nums = [1, 2, 3]; + +// Scala +val nums = List(1, 2, 3) +``` + +### `for` 循环，单行： + + + + + + + + + + +
      + // newer syntax +
      for (let i of nums) { +
        console.log(i); +
      } +
      +
      // older +
      for (i=0; i<nums.length; i++) { +
        console.log(nums[i]); +
      }       +
      + // preferred +
      for i <- ints do println(i) +
      +
      // also available +
      for (i <- ints) println(i)       +
      + +### `for` 循环，在循环体内多行 + + + + + + + + + + +
      + // preferred +
      for (let i of nums) { +
        let j = i * 2; +
        console.log(j); +
      } +
      +
      // also available +
      for (i=0; i<nums.length; i++) { +
        let j = nums[i] * 2; +
        console.log(j); +
      }       +
      + // preferred +
      for i <- ints do +
        val i = i * 2 +
        println(j) +
      +
      // also available +
      for (i <- nums) { +
        val j = i * 2 +
        println(j) +
      }       +
      + +### 在 `for` 循环中有多个生成器 + + + + + + + + + + +
      + let str = "ab"; +
      for (let i = 1; i < 3; i++) { +
        for (var j = 0; j < str.length; j++) { +
          for (let k = 1; k < 11; k++) { +
            let c = str.charAt(j); +
            console.log(`i: ${i} j: ${c} k: ${k}`); +
          } +
        } +
      }       +
      + for +
        i <- 1 to 2 +
        j <- 'a' to 'b' +
        k <- 1 to 10 by 5 +
      do +
        println(s"i: $i, j: $j, k: $k")       +
      + +### 带守卫的生成器 + +_守卫_是 `for` 表达式中的 `if` 表达式的名称。 + + + + + + + + + + +
      + for (let i = 0; i < 10; i++) { +
        if (i % 2 == 0 && i < 5) { +
          console.log(i); +
        } +
      }       +
      + for +
        i <- 1 to 10 +
        if i % 2 == 0 +
        if i < 5 +
      do +
        println(i)       +
      + +### `for` comprehension + +`for` comprehension 是一个 `for` 循环，它使用 `yield` 返回（产生）一个值。 它们经常在 Scala 中使用。 + + + + + + + + + + +
      + N/A +
      + val list = +
        for +
          i <- 1 to 3 +
        yield +
          i * 10 +
      // result: Vector(10, 20, 30)       +
      + +## switch & match + +JavaScript 有 `switch` 语句，Scala 有 `match` 表达式。 +就像 Scala 中的所有其他东西一样，这些确实是_表达式_，这意味着它们返回一个结果： + +```scala +val day = 1 + +// later in the code ... +val monthAsString = day match + case 1 => "January" + case 2 => "February" + case _ => "Other" +``` + +`match` 表达式可以在每个 `case` 语句中处理多个匹配项： + +```scala +val numAsString = i match + case 1 | 3 | 5 | 7 | 9 => "odd" + case 2 | 4 | 6 | 8 | 10 => "even" + case _ => "too big" +``` + +它们也可以用于方法体： + +```scala +def isTruthy(a: Matchable) = a match + case 0 | "" => false + case _ => true + +def isPerson(x: Matchable): Boolean = x match + case p: Person => true + case _ => false +``` + +`match` 表达式有许多其他模式匹配选项。 + +## 集合类 + +Scala 有不同的 [集合类][collections-classes] 来满足不同的需求。 + +常见的_不可变_序列是： + +- `List` +- `Vector` + +常见的_可变_序列是： + +- `Array` +- `ArrayBuffer` + +Scala 还有可变和不可变的 Map 和 Set。 + +这是创建常见 Scala 集合类型的方式： + +```scala +val strings = List("a", "b", "c") +val strings = Vector("a", "b", "c") +val strings = ArrayBuffer("a", "b", "c") + +val set = Set("a", "b", "a") // result: Set("a", "b") +val map = Map( + "a" -> 1, + "b" -> 2, + "c" -> 3 +) +``` + +### 集合上的方法 + +以下示例展示了使用 Scala 集合的许多不同方法。 + +### 填充列表： + +```scala +// to, until +(1 to 5).toList // List(1, 2, 3, 4, 5) +(1 until 5).toList // List(1, 2, 3, 4) + +(1 to 10 by 2).toList // List(1, 3, 5, 7, 9) +(1 until 10 by 2).toList // List(1, 3, 5, 7, 9) +(1 to 10).by(2).toList // List(1, 3, 5, 7, 9) + +('d' to 'h').toList // List(d, e, f, g, h) +('d' until 'h').toList // List(d, e, f, g) +('a' to 'f').by(2).toList // List(a, c, e) + +// range method +List.range(1, 3) // List(1, 2) +List.range(1, 6, 2) // List(1, 3, 5) + +List.fill(3)("foo") // List(foo, foo, foo) +List.tabulate(3)(n => n * n) // List(0, 1, 4) +List.tabulate(4)(n => n * n) // List(0, 1, 4, 9) +``` + +### 序列上的函数式方法： + +```scala +// these examples use a List, but they’re the same with Vector +val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) +a.contains(20) // true +a.distinct // List(10, 20, 30, 40) +a.drop(2) // List(30, 40, 10) +a.dropRight(2) // List(10, 20, 30) +a.dropWhile(_ < 25) // List(30, 40, 10) +a.filter(_ < 25) // List(10, 20, 10) +a.filter(_ > 100) // List() +a.find(_ > 20) // Some(30) +a.head // 10 +a.headOption // Some(10) +a.init // List(10, 20, 30, 40) +a.last // 10 +a.lastOption // Some(10) +a.slice(2,4) // List(30, 40) +a.tail // List(20, 30, 40, 10) +a.take(3) // List(10, 20, 30) +a.takeRight(2) // List(40, 10) +a.takeWhile(_ < 30) // List(10, 20) + +// map, flatMap +val fruits = List("apple", "pear") +fruits.map(_.toUpperCase) // List(APPLE, PEAR) +fruits.flatMap(_.toUpperCase) // List(A, P, P, L, E, P, E, A, R) + +val nums = List(10, 5, 8, 1, 7) +nums.sorted // List(1, 5, 7, 8, 10) +nums.sortWith(_ < _) // List(1, 5, 7, 8, 10) +nums.sortWith(_ > _) // List(10, 8, 7, 5, 1) + +List(1,2,3).updated(0,10) // List(10, 2, 3) +List(2,4).union(List(1,3)) // List(2, 4, 1, 3) + +// zip +val women = List("Wilma", "Betty") // List(Wilma, Betty) +val men = List("Fred", "Barney") // List(Fred, Barney) +val couples = women.zip(men) // List((Wilma,Fred), (Betty,Barney)) +``` + +Scala 有_很多_更多可供您使用的方法。 +所有这些方法的好处是： + +- 您不必编写自定义的 `for` 循环来解决问题 +- 当你阅读别人的代码时，你不必阅读他们自定义的 `for` 循环； 你只会找到像这样的常用方法，因此更容易阅读来自不同项目的代码 + +### 元组 + +当您想将多个数据类型放在同一个列表中时，JavaScript 允许您这样做： + +```javascript +stuff = ["Joe", 42, 1.0]; +``` + +在 Scala 中你这样做： + +```scala +val a = ("eleven") +val b = ("eleven", 11) +val c = ("eleven", 11, 11.0) +val d = ("eleven", 11, 11.0, Person("Eleven")) +``` + +在 Scala 中，这些类型称为元组，如图所示，它们可以包含一个或多个元素，并且元素可以具有不同的类型。 +访问它们的元素就像访问 `List`、`Vector` 或 `Array` 的元素一样： + +```scala +d(0) // "eleven" +d(1) // 11 +``` + +### 枚举 + +JavaScript 没有枚举，但你可以这样做： + +```javascript +let Color = { + RED: 1, + GREEN: 2, + BLUE: 3 +}; +Object.freeze(Color); +``` + +在 Scala 3 中，您可以使用枚举做很多事情。 +您可以创建该代码的等效代码： + +```scala +enum Color: + case Red, Green, Blue +``` + +你可以创建带参数的枚举： + +```scala +enum Color(val rgb: Int): + case Red extends Color(0xFF0000) + case Green extends Color(0x00FF00) + case Blue extends Color(0x0000FF) +``` + +你也可以创建用户自定义的枚举成员： + +```scala +enum Planet(mass: Double, radius: Double): + case Mercury extends Planet(3.303e+23, 2.4397e6) + case Venus extends Planet(4.869e+24,6.0518e6) + case Earth extends Planet(5.976e+24,6.37814e6) + // more planets here ... + + private final val G = 6.67300E-11 + def surfaceGravity = G * mass / (radius * radius) + def surfaceWeight(otherMass: Double) = otherMass * surfaceGravity +``` + +## Scala.js DOM 代码 + +Scala.js 允许您编写 Scala 代码，这些代码编译为 JavaScript 代码，然后可以在浏览器中使用。 +该方法类似于 TypeScript、ReScript 和其他编译为 JavaScript 的语言。 + +包含必要的库并在项目中导入必要的包后，编写 Scala.js 代码看起来与编写 JavaScript 代码非常相似： + +```scala +// show an alert dialog on a button click +jQuery("#hello-button").click{() => + dom.window.alert("Hello, world") +} + +// define a button and what should happen when it’s clicked +val btn = button( + "Click me", + onclick := { () => + dom.window.alert("Hello, world") + }) + +// create two divs with css classes, an h2 element, and the button +val content = + div(cls := "foo", + div(cls := "bar", + h2("Hello"), + btn + ) + ) + +// add the content to the DOM +val root = dom.document.getElementById("root") +root.innerHTML = "" +root.appendChild(content.render) +``` + +请注意，尽管 Scala 是一种类型安全的语言，但在上面的代码中没有声明任何类型。 +Scala 强大的类型推断能力通常使 Scala 代码看起来像是动态类型的。 +但它是类型安全的，因此您可以在开发周期的早期捕获许多类错误。 + +## 其他 Scala.js 资源 + +Scala.js 网站为对使用 Scala.js 感兴趣的 JavaScript 开发人员提供了极好的教程集。 +以下是他们的一些初始教程： + +- [基础教程（创建第一个 Scala.js 项目）](https://www.scala-js.org/doc/tutorial/basic/) +- [适用于 JavaScript 开发人员的 Scala.js](https://www.scala-js.org/doc/sjs-for-js/) +- [从 ES6 到 Scala：基础](https://www.scala-js.org/doc/sjs-for-js/es6-to-scala-part1.html) +- [从 ES6 到 Scala：集合](https://www.scala-js.org/doc/sjs-for-js/es6-to-scala-part2.html) +- [从 ES6 到 Scala：高级](https://www.scala-js.org/doc/sjs-for-js/es6-to-scala-part3.html) + +## Scala 独有的概念 + +Scala 中还有其他一些概念目前在 JavaScript 中没有等效的概念： + +- 几乎所有与[上下文抽象][contextual]相关的东西 +- 方法特性： + - 多个参数列表 + - 调用方法时使用命名参数 +- 使用 trait 作为接口 +- 样例类 +- 伴生类和对象 +- 创建自己的[控制结构][control]和 DSL 的能力 +- `match` 表达式和模式匹配的高级功能 +- `for` comprehension +- 中缀方法 +- 宏和元编程 +- 更多的 ... + + +[collections-classes]: {% link _overviews/scala3-book/collections-classes.md %} +[concurrency]: {% link _overviews/scala3-book/concurrency.md %} +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} +[control]: {% link _overviews/scala3-book/control-structures.md %} +[extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[fp-intro]: {% link _overviews/scala3-book/fp-intro.md %} +[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[hofs]: {% link _overviews/scala3-book/fun-hofs.md %} +[intersection-types]: {% link _overviews/scala3-book/types-intersection.md %} +[modeling-fp]: {% link _overviews/scala3-book/domain-modeling-fp.md %} +[modeling-oop]: {% link _overviews/scala3-book/domain-modeling-oop.md %} +[multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} +[union-types]: {% link _overviews/scala3-book/types-union.md %} + +
      diff --git a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md new file mode 100644 index 0000000000..30b39a06ef --- /dev/null +++ b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md @@ -0,0 +1,1354 @@ +--- +title: Scala for Python Developers +type: chapter +description: This page is for Python developers who are interested in learning about Scala 3. +num: 75 +previous-page: scala-for-javascript-devs +next-page: +--- + +{% include_relative scala4x.css %} + +
      + +{% comment %} + +NOTE: Hopefully someone with more Python experience can give this a thorough review. + +NOTE: On this page (https://contributors.scala-lang.org/t/feedback-sought-optional-braces/4702/10), Li Haoyi comments: “Python’s success also speaks for itself; beginners certainly don’t pick Python because of performance, ease of installation, packaging, IDE support, or simplicity of the language’s runtime semantics!” I’m not a Python expert, so these points are good to know, though I don’t want to go negative in any comparisons. +It’s more like thinking, “Python developers will appreciate Scala’s performance, ease of installation, packaging, IDE support, etc.” +{% endcomment %} + +{% comment %} +TODO: We should probably go through this document and add links to our other detail pages, when time permits. +{% endcomment %} + +本节提供了 Python 和 Scala 编程语言之间的比较。 +它适用于懂得 Python 并希望了解 Scala 的程序员，特别是通过查看 Python 语言特性与 Scala 比较的示例。 + +## 介绍 + +在进入示例之前，第一部分提供了以下部分的相对简短的介绍和总结。 +这两种语言首先在高层次上进行比较，然后在日常编程层次上进行比较。 + +### 高层次相似性 + +在高层次上，Scala 与 Python 有这些*相似之处*： + +- 两者都是高级编程语言，您不必关心指针和手动内存管理等低级概念 +- 两者都有一个相对简单、简洁的语法 +- 两者都支持[函数式编程][fp-intro] +- 两者都是面向对象的编程 (OOP) 语言 +- 两者都有推导：Python 有列表推导，Scala 有 `for` 推导 +- 两种语言都支持 lambdas 和 [高阶函数][hofs] +- 两者都可以与 [Apache Spark](https://spark.apache.org) 一起用于大数据处理 +- 两者都有很多很棒的库 + +### 高层次差异 + +同样在高层次上，Python 和 Scala 之间的_差异_是： + +- Python 是动态类型的，Scala 是静态类型的 + - 虽然它是静态类型的，但 Scala 的类型推断等特性让它感觉像是一门动态语言 +- Python 被解释，Scala 代码被编译成 _.class_ 文件，并在 Java 虚拟机 (JVM) 上运行 +- 除了在 JVM 上运行之外，[Scala.js](https://www.scala-js.org) 项目允许您使用 Scala 作为 JavaScript 替代品 +- [Scala Native](https://scala-native.readthedocs.io/en/v0.3.9-docs) 项目可让您编写“系统”级代码，并编译为本机可执行文件 +- Scala 中的一切都是一个_表达式_：像 `if` 语句、`for` 循环、`match` 表达式，甚至 `try`/`catch` 表达式都有返回值 +- Scala 习惯默认不变性：鼓励您使用不可变变量和不可变集合 +- Scala 对[并发和并行编程][concurrency]有很好的支持 + +### 编程层次相似性 + +本节介绍您在日常编写代码时会看到 Python 和 Scala 之间的相似之处： + +- Scala 的类型推断常常让人感觉像是一种动态类型语言 +- 两种语言都不使用分号来结束表达式 +- 两种语言都支持使用重要的缩进而不是大括号和圆括号 +- 定义方法的语法类似 +- 两者都有列表、字典（映射）、集合和元组 +- 两者都有映射和过滤的推导 +- 使用 Scala 3 的[顶级定义][toplevel]，您可以将方法、字段和其他定义放在任何地方 + - 一个区别是 Python 甚至可以在不声明单个方法的情况下运行，而 Scala 3 不能在顶层做_所有事_；例如，启动 Scala 应用程序需要一个 [main 方法][main-method] (`@main def`) + +### 编程层次差异 + +同样在编程级别，这些是您在编写代码时每天都会看到的一些差异： + +- 在 Scala 中编程感觉非常一致： + - `val` 和 `var` 字段用于定义字段和参数 + - 列表、映射、集合和元组都以类似方式创建和访问；例如，括号用于创建所有类型---`List(1,2,3)`, `Set(1,2,3)`, `Map(1->"one")`---就像创建任何其他 Scala 类 + - [集合类][collections-classes] 通常具有大部分相同的高阶函数 + - 模式匹配在整个语言中一致使用 + - 用于定义传递给方法的函数的语法与用于定义匿名函数的语法相同 +- Scala 变量和参数使用 `val`（不可变）或 `var`（可变）关键字定义 +- Scala 习惯用法更喜欢不可变的数据结构 +- Scala 通过 IntelliJ IDEA 和 Microsoft VS Code 提供了极好的 IDE 支持 +- 注释：Python 使用 `#` 表示注释； Scala 使用 C、C++ 和 Java 样式：`//`、`/*...*/` 和 `/**...*/` +- 命名约定：Python 标准是使用下划线，例如 `my_list`； Scala 使用 `myList` +- Scala 是静态类型的，因此您可以声明方法参数、方法返回值和其他地方的类型 +- 模式匹配和 `match` 表达式在 Scala 中被广泛使用（并且会改变你编写代码的方式） +- Scala 中大量使用 trait；接口和抽象类在 Python 中使用较少 +- Scala 的 [上下文抽象][contextual] 和 _术语推导_提供了一系列不同的特性： + - [扩展方法][extension-method]让您使用清晰的语法轻松地向类添加新功能 + - [多元等式][multiversal] 让您限制相等比较---在编译时——只有那些有意义的比较 +- Scala 拥有最先进的开源函数式编程库（参见 [“Awesome Scala” 列表](https://github.com/lauris/awesome-scala)） +- 借助对象、按名称参数、中缀表示法、可选括号、扩展方法、高阶函数等功能，您可以创建自己的“控制结构”和 DSL +- Scala 代码可以在 JVM 中运行，甚至可以编译为原生代码（使用 [Scala Native](https://github.com/scala-native/scala-native) 和 [GraalVM](https://www.graalvm) .org)) 实现高性能 +- 许多其他好东西：样例类、伴生类和对象、宏、[联合][union-types] 和 [交集][intersection-types] 类型、[顶级定义][toplevel]、数字字面量、多参数列表和更多的 + +### 特性比较示例 + +鉴于该介绍，以下部分提供了 Python 和 Scala 编程语言功能的并排比较。 + +{% comment %} +TODO: Update the Python examples to use four spaces. I started to do this, but then thought it would be better to do that in a separate PR. +{% endcomment %} + +## 注释 + +Python 使用 `#` 表示注释，而 Scala 的注释语法与 C、C++ 和 Java 等语言相同： + + + + + + + + + + +
      + # a comment +
      + // a comment +
      /* ... */ +
      /** ... */       +
      + +## 变量赋值 + +这些例子演示了如何在 Python 和 Scala 中创建变量。 + +### 创建整数和字符串变量： + + + + + + + + + + +
      + x = 1 +
      x = "Hi" +
      y = """foo +
             bar +
             baz"""       +
      + val x = 1 +
      val x = "Hi" +
      val y = """foo +
                 bar +
                 baz"""       +
      + +### 列表： + + + + + + + + + + +
      + x = [1,2,3] +
      + val x = List(1,2,3) +
      + +### 字典/映射： + + + + + + + + + + +
      + x = { +
        "Toy Story": 8.3, +
        "Forrest Gump": 8.8, +
        "Cloud Atlas": 7.4 +
      }       +
      + val x = Map( +
        "Toy Story" -> 8.3, +
        "Forrest Gump" -> 8.8, +
        "Cloud Atlas" -> 7.4 +
      )       +
      + +### 集合： + + + + + + + + + + +
      + x = {1,2,3} +
      + val x = Set(1,2,3) +
      + +### 元组： + + + + + + + + + + +
      + x = (11, "Eleven") +
      + val x = (11, "Eleven") +
      + +如果 Scala 字段是可变的，请使用 `var` 而不是 `val` 来定义变量： + +```scala +var x = 1 +x += 1 +``` + +然而，Scala 中的经验法则是始终使用 `val`，除非变量确实需要被改变。 + +## OOP 风格的类和方法 + +本节比较了与 OOP 风格的类和方法相关的特性。 + +### OOP 风格类，主构造函数： + + + + + + + + + + +
      + class Person(object): +
        def __init__(self, name): +
          self.name = name +
      +
        def speak(self): +
          print(f'Hello, my name is {self.name}')       +
      + class Person (var name: String): +
        def speak() = println(s"Hello, my name is $name")       +
      + +### 创建和使用实例： + + + + + + + + + + +
      + p = Person("John") +
      p.name   # John +
      p.name = 'Fred' +
      p.name   # Fred +
      p.speak()       +
      + val p = Person("John") +
      p.name   // John +
      p.name = "Fred" +
      p.name   // Fred +
      p.speak()       +
      + +### 单行方法： + + + + + + + + + + +
      + def add(a, b): return a + b +
      + def add(a: Int, b: Int): Int = a + b +
      + +### 多行方法： + + + + + + + + + + +
      + def walkThenRun(): +
        print('walk') +
        print('run')       +
      + def walkThenRun() = +
        println("walk") +
        println("run")       +
      + +## 接口，traits，和继承 + +如果您熟悉 Java 8 和更新版本，Scala trait 类似于那些 Java 接口。 +Traits 在 Scala 中一直使用，而 Python 接口和抽象类的使用频率要低得多。 +因此，与其试图比较两者，不如用这个例子来展示如何使用 Scala trait来构建一个模拟数学问题的小解决方案： + +```scala +trait Adder: + def add(a: Int, b: Int) = a + b + +trait Multiplier: + def multiply(a: Int, b: Int) = a * b + +// create a class from the traits +class SimpleMath extends Adder, Multiplier +val sm = new SimpleMath +sm.add(1,1) // 2 +sm.multiply(2,2) // 4 +``` + +还有[许多其他方法可以将 trait 与类和对象一起使用][modeling-intro]，但这让您了解如何使用它们将概念组织成行为的逻辑组，然后根据需要将它们合并以创建一个完整的解决方案。 + +## 控制结构 + +本节比较 Python 和 Scala 中的[控制结构][control-structures]。 +两种语言都有类似 `if`/`else`、`while`、`for` 循环和 `try` 的结构。 +Scala 也有 `match` 表达式。 + +### `if` 语句，单行： + + + + + + + + + + +
      + if x == 1: print(x) +
      + if x == 1 then println(x) +
      + +### `if` 语句，多行： + + + + + + + + + + +
      + if x == 1: +
        print("x is 1, as you can see:") +
        print(x)       +
      + if x == 1 then +
        println("x is 1, as you can see:") +
        println(x)       +
      + +### if, else if, else: + + + + + + + + + + +
      + if x < 0: +
        print("negative") +
      elif x == 0: +
        print("zero") +
      else: +
        print("positive")       +
      + if x < 0 then +
        println("negative") +
      else if x == 0 then +
        println("zero") +
      else +
        println("positive")       +
      + +### 从 `if` 返回值： + + + + + + + + + + +
      + min_val = a if a < b else b +
      + val minValue = if a < b then a else b +
      + +### `if` 作为方法体： + + + + + + + + + + +
      + def min(a, b): +
        return a if a < b else b       +
      + def min(a: Int, b: Int): Int = +
        if a < b then a else b       +
      + +### `while` 循环： + + + + + + + + + + +
      + i = 1 +
      while i < 3: +
        print(i) +
        i += 1       +
      + var i = 1 +
      while i < 3 do +
        println(i) +
        i += 1       +
      + +### 有范围的 `for` 循环： + + + + + + + + + + +
      + for i in range(0,3): +
        print(i)       +
      + // preferred +
      for i <- 0 until 3 do println(i) +
      +
      // also available +
      for (i <- 0 until 3) println(i) +
      +
      // multiline syntax +
      for +
        i <- 0 until 3 +
      do +
        println(i)       +
      + +### 列表的 `for` 循环： + + + + + + + + + + +
      + for i in ints: print(i) +
      +
      for i in ints: +
        print(i)       +
      + for i <- ints do println(i) +
      + +### `for` 循环，多行： + + + + + + + + + + +
      + for i in ints: +
        x = i * 2 +
        print(f"i = {i}, x = {x}")       +
      + for +
        i <- ints +
      do +
        val x = i * 2 +
        println(s"i = $i, x = $x")       +
      + +### 多“范围”生成器： + + + + + + + + + + +
      + for i in range(1,3): +
        for j in range(4,6): +
          for k in range(1,10,3): +
            print(f"i = {i}, j = {j}, k = {k}")       +
      + for +
        i <- 1 to 2 +
        j <- 4 to 5 +
        k <- 1 until 10 by 3 +
      do +
        println(s"i = $i, j = $j, k = $k")       +
      + +### 带守卫（`if` 表达式）的生成器： + + + + + + + + + + +
      + for i in range(1,11): +
        if i % 2 == 0: +
          if i < 5: +
            print(i)       +
      + for +
        i <- 1 to 10 +
        if i % 2 == 0 +
        if i < 5 +
      do +
        println(i)       +
      + +### 每行有多个 `if` 条件： + + + + + + + + + + +
      + for i in range(1,11): +
        if i % 2 == 0 and i < 5: +
          print(i)       +
      + for +
        i <- 1 to 10 +
        if i % 2 == 0 && i < 5 +
      do +
        println(i)       +
      + +### 推导： + + + + + + + + + + +
      + xs = [i * 10 for i in range(1, 4)] +
      # xs: [10,20,30]       +
      + val xs = for i <- 1 to 3 yield i * 10 +
      // xs: Vector(10, 20, 30)       +
      + +### `match` 表达式： + + + + + + + + + + +
      + # From 3.10, Python supports structural pattern matching +
      # You can also use dictionaries for basic “switch” functionality +
      match month: +
        case 1: +
          monthAsString = "January" +
        case 2: +
          monthAsString = "February" +
        case _: +
          monthAsString = "Other"       +
      + val monthAsString = month match +
        case 1 => "January" +
        case 2 => "February" +
        _ => "Other"       +
      + +### switch/match: + + + + + + + + + + +
      + # Only from Python 3.10 +
      match i: +
        case 1 | 3 | 5 | 7 | 9: +
          numAsString = "odd" +
        case 2 | 4 | 6 | 8 | 10: +
          numAsString = "even" +
        case _: +
          numAsString = "too big"       +
      + val numAsString = i match +
        case 1 | 3 | 5 | 7 | 9 => "odd" +
        case 2 | 4 | 6 | 8 | 10 => "even" +
        case _ => "too big"       +
      + +### try, catch, finally: + + + + + + + + + + +
      + try: +
        print(a) +
      except NameError: +
        print("NameError") +
      except: +
        print("Other") +
      finally: +
        print("Finally")       +
      + try +
        writeTextToFile(text) +
      catch +
        case ioe: IOException => +
          println(ioe.getMessage) +
        case fnf: FileNotFoundException => +
          println(fnf.getMessage) +
      finally +
        println("Finally")       +
      + +匹配表达式和模式匹配是 Scala 编程体验的重要组成部分，但这里只展示了几个 `match` 表达式功能。 有关更多示例，请参见 [控制结构][control-structures] 页面。 + +## 集合类 + +本节比较 Python 和 Scala 中可用的 [集合类][collections-classes]，包括列表、字典/映射、集合和元组。 + +### 列表 + +Python 有它的列表，Scala 有几个不同的专门的可变和不可变序列类，具体取决于您的需要。 +因为 Python 列表是可变的，所以它最直接地与 Scala 的 `ArrayBuffer` 进行比较。 + +### Python 列表 & Scala序列： +Match expressions and pattern matching are a big part of the Scala programming experience, but only a few `match` expression features are shown here. See the [Control Structures][control-structures] page for many more examples. + +## Collections classes + +This section compares the [collections classes][collections-classes] that are available in Python and Scala, including lists, dictionaries/maps, sets, and tuples. + +### Lists + +Where Python has its list, Scala has several different specialized mutable and immutable sequence classes, depending on your needs. +Because the Python list is mutable, it most directly compares to Scala’s `ArrayBuffer`. + +### Python list & Scala sequences: + + + + + + + + + + +
      + a = [1,2,3] +
      + // use different sequence classes +
      // as needed +
      val a = List(1,2,3) +
      val a = Vector(1,2,3) +
      val a = ArrayBuffer(1,2,3)       +
      + +### 获取列表元素： + + + + + + + + + +
      + a[0]
      a[1]       +
      + a(0)
      a(1)       // just like all other method calls +
      + +### 更新列表元素： + + + + + + + + + + +
      + a[0] = 10 +
      a[1] = 20       +
      + // ArrayBuffer is mutable +
      a(0) = 10 +
      a(1) = 20       +
      + +### 合并两个列表： + + + + + + + + + + +
      + c = a + b +
      + val c = a ++ b +
      + +### 遍历列表： + + + + + + + + + + +
      + for i in ints: print(i) +
      +
      for i in ints: +
        print(i)       +
      + // preferred +
      for i <- ints do println(i) +
      +
      // also available +
      for (i <- ints) println(i)       +
      + +Scala 的主要序列类是 `List`、`Vector` 和 `ArrayBuffer`。 +`List` 和 `Vector` 是当你想要一个不可变序列时使用的主要类，而 `ArrayBuffer` 是当你想要一个可变序列时使用的主要类。 +（Scala 中的“缓冲区”是一个可以增长和缩小的序列。） + +### 字典/映射 + +Python 字典就像_可变的_ Scala `Map` 类。 +但是，默认的 Scala 映射是_不可变的_，并且有许多转换方法可以让您轻松创建新映射。 + +#### 字典/映射 创建： + + + + + + + + + + +
      + my_dict = { +
        'a': 1, +
        'b': 2, +
        'c': 3 +
      }       +
      + val myMap = Map( +
        "a" -> 1, +
        "b" -> 2, +
        "c" -> 3 +
      )       +
      + +#### 获取字典/映射元素： + + + + + + + + + + +
      + my_dict['a']   # 1 +
      + myMap("a")   // 1 +
      + +#### 带 `for` 循环的字典/映射： + + + + + + + + + + +
      + for key, value in my_dict.items(): +
        print(key) +
        print(value)       +
      + for (key,value) <- myMap do +
        println(key) +
        println(value)       +
      + +Scala 有其他专门的 `Map` 类来满足不同的需求。 + +### 集合 + +Python 集合类似于_可变的_ Scala `Set` 类。 + +#### 集合创建： + + + + + + + + + + +
      + set = {"a", "b", "c"} +
      + val set = Set(1,2,3) +
      + +#### 重复元素： + + + + + + + + + + +
      + set = {1,2,1} +
      # set: {1,2}       +
      + val set = Set(1,2,1) +
      // set: Set(1,2)       +
      + +Scala 有其他专门的 `Set` 类来满足不同的需求。 + +### 元组 + +Python 和 Scala 元组也很相似。 + +#### 元组创建： + + + + + + + + + + +
      + t = (11, 11.0, "Eleven") +
      + val t = (11, 11.0, "Eleven") +
      + +#### 获取元组元素： + + + + + + + + + + +
      + t[0]   # 11 +
      t[1]   # 11.0       +
      + t(0)   // 11 +
      t(1)   // 11.0       +
      + +## 集合类上的方法 + +Python 和 Scala 有几个相同的常用函数方法可供它们使用： + +- `map` +- `filter` +- `reduce` + +如果您习惯于在 Python 中将这些方法与 lambda 表达式一起使用，您会发现 Scala 在其集合类中使用了类似的方法。 +为了演示此功能，这里有两个示例列表： + +```scala +numbers = (1,2,3) // python +val numbers = List(1,2,3) // scala +``` + +下表中使用了这些列表，显示了如何对其应用映射和过滤算法。 + +### 映射与推导： + + + + + + + + + + +
      + x = [i * 10 for i in numbers] +
      + val x = for i <- numbers yield i * 10 +
      + +### 有推导的过滤： + + + + + + + + + + +
      + evens = [i for i in numbers if i % 2 == 0] +
      + val evens = numbers.filter(_ % 2 == 0) +
      // or +
      val evens = for i <- numbers if i % 2 == 0 yield i       +
      + +### 映射 & 有推导的过滤： + + + + + + + + + + +
      + x = [i * 10 for i in numbers if i % 2 == 0] +
      + val x = numbers.filter(_ % 2 == 0).map(_ * 10) +
      // or +
      val x = for i <- numbers if i % 2 == 0 yield i * 10       +
      + +### 映射： + + + + + + + + + + +
      + x = map(lambda x: x * 10, numbers) +
      + val x = numbers.map(_ * 10) +
      + +### 过滤： + + + + + + + + + + +
      + f = lambda x: x > 1 +
      x = filter(f, numbers)       +
      + val x = numbers.filter(_ > 1) +
      + + +### Scala 集合方法： + +Scala 集合类有超过 100 种功能方法来简化您的代码。 +除了 `map`、`filter` 和 `reduce`，下面列出了其他常用的方法。 +在这些方法示例中： + +- `c` 指的是一个集合 +- `p` 是谓词 +- `f` 是一个函数、匿名函数或方法 +- `n` 指的是一个整数值 + +以下是一些可用的过滤方法： + +| 方法 | 说明 | +| -------------- | ------------- | +| `c1.diff(c2) ` | 返回 `c1` 和 `c2` 中元素的差异。 | +| `c.distinct` | 返回 `c` 中的唯一元素。 | +| `c.drop(n)` | 返回集合中除前 `n` 个元素之外的所有元素。 | +| `c.filter(p) ` | 返回集合中谓词为 `true` 的所有元素。 | +| `c.head` | 返回集合的第一个元素。 （如果集合为空，则抛出 `NoSuchElementException`。） | +| `c.tail` | 返回集合中除第一个元素之外的所有元素。 （如果集合为空，则抛出 `UnsupportedOperationException`。） | +| `c.take(n)` | 返回集合 `c` 的前 `n` 个元素。 | + +以下是一些转换方法： + +| 方法 | 说明 | +| --------------- | ------------- | +| `c.flatten` | 将集合的集合（例如列表列表）转换为单个集合（单个列表）。 | +| `c.flatMap(f)` | 通过将 `f` 应用于集合 `c` 的所有元素（如 `map`）返回一个新集合，然后将结果集合的元素展平。 | +| `c.map(f)` | 通过将 `f` 应用于集合 `c` 的所有元素来创建一个新集合。 | +| `c.reduce(f)` | 将 `reduction` 函数 `f` 应用于 `c` 中的连续元素以产生单个值。 | +| `c.sortWith(f)` | 返回由比较函数 `f` 排序的 `c` 版本。 | + +一些常见的分组方法： + +| 方法 | 说明 | +| ---------------- | ------------- | +| `c.groupBy(f)` | 根据 `f` 将集合划分为集合的 `Map`。 | +| `c.partition(p)` | 根据谓词 `p` 返回两个集合。 | +| `c.span(p)` | 返回两个集合的集合，第一个由 `c.takeWhile(p)` 创建，第二个由 `c.dropWhile(p)` 创建。 | +| `c.splitAt(n)` | 通过在元素 `n` 处拆分集合 `c` 来返回两个集合的集合。 | + +一些信息和数学方法： + +| 方法 | 说明 | +| -------------- | ------------- | +| `c1.containsSlice(c2)` | 如果 `c1` 包含序列 `c2`，则返回 `true`。 | +| `c.count(p)` | 计算 `c` 中元素的数量，其中 `p` 为 `true`。 | +| `c.distinct` | 返回 `c` 中的不重复的元素。 | +| `c.exists(p)` | 如果集合中任何元素的 `p` 为 `true` ，则返回 `true` 。 | +| `c.find(p)` | 返回匹配 `p` 的第一个元素。该元素以 `Option[A]` 的形式返回。 | +| `c.min` | 返回集合中的最小元素。 （可以抛出_java.lang.UnsupportedOperationException_。）| +| `c.max` | 返回集合中的最大元素。 （可以抛出_java.lang.UnsupportedOperationException_。）| +| `c slice(from, to)` | 返回从元素 `from` 开始到元素 `to` 结束的元素间隔。 | +| `c.sum` | 返回集合中所有元素的总和。 （需要为集合中的元素定义 `Ordering`。） | + +以下是一些示例，展示了这些方法如何在列表上工作： + +```scala +val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) +a.distinct // List(10, 20, 30, 40) +a.drop(2) // List(30, 40, 10) +a.dropRight(2) // List(10, 20, 30) +a.dropWhile(_ < 25) // List(30, 40, 10) +a.filter(_ < 25) // List(10, 20, 10) +a.filter(_ > 100) // List() +a.find(_ > 20) // Some(30) +a.head // 10 +a.headOption // Some(10) +a.init // List(10, 20, 30, 40) +a.intersect(List(19,20,21)) // List(20) +a.last // 10 +a.lastOption // Some(10) +a.slice(2,4) // List(30, 40) +a.tail // List(20, 30, 40, 10) +a.take(3) // List(10, 20, 30) +a.takeRight(2) // List(40, 10) +a.takeWhile(_ < 30) // List(10, 20) +``` + +这些方法展示了 Scala 中的一个常见模式：对象上可用的函数式方法。 +这些方法都不会改变初始列表“a”； 相反，它们都返回的数据在注释后显示。 + +还有更多可用的方法，但希望这些描述和示例能让您体验到预建集合方法的强大功能。 + +## 枚举 + +本节比较 Python 和 Scala 3 中的枚举。 + +### 创建枚举： + + + + + + + + + + +
      + from enum import Enum, auto +
      class Color(Enum): +
          RED = auto() +
          GREEN = auto() +
          BLUE = auto()       +
      + enum Color: +
        case Red, Green, Blue       +
      + +### 值和比较： + + + + + + + + + + +
      + Color.RED == Color.BLUE  # False +
      + Color.Red == Color.Blue  // false +
      + +### 参数化枚举： + + + + + + + + + + +
      + N/A +
      + enum Color(val rgb: Int): +
        case Red   extends Color(0xFF0000) +
        case Green extends Color(0x00FF00) +
        case Blue  extends Color(0x0000FF)       +
      + +### 用户定义枚举成员： + + + + + + + + + + +
      + N/A +
      + enum Planet( +
          mass: Double, +
          radius: Double +
        ): +
        case Mercury extends +
          Planet(3.303e+23, 2.4397e6) +
        case Venus extends +
          Planet(4.869e+24, 6.0518e6) +
        case Earth extends +
          Planet(5.976e+24, 6.37814e6) +
        // more planets ... +
      +
        // fields and methods +
        private final val G = 6.67300E-11 +
        def surfaceGravity = G * mass / +
          (radius * radius) +
        def surfaceWeight(otherMass: Double) +
          = otherMass * surfaceGravity       +
      + +## Scala 独有的概念 + +Scala 中的有些概念目前在 Python 中没有等效的功能。 +请点击以下链接了解更多详情： + +- 大多数与[上下文抽象][contextual]相关的概念，如[扩展方法][extension-methods]、[类型类][type-classes]、隐式值 +- Scala 允许多参数列表，从而实现部分应用函数等特性，以及创建自己的 DSL 的能力 +- 样例类，对于函数式编程和模式匹配非常有用 +- 创建自己的控制结构和 DSL 的能力 +- 模式匹配和 `match` 表达式 +- [多重等式][multiversal]：在编译时控制哪些等式比较有意义的能力 +- 中缀方法 +- 宏和元编程 + +## Scala 和虚拟环境 + +在 Scala 中，无需显式设置 Python 虚拟环境的等价物。默认情况下，Scala 构建工具管理项目依赖项，因此用户不必考虑手动安装包。例如，使用 `sbt` 构建工具，我们在 `libraryDependencies` 设置下的 `build.sbt` 文件中指定依赖关系，然后执行 + +``` +cd myapp +sbt compile +``` + +自动解析该特定项目的所有依赖项。 下载依赖的位置很大程度上是构建工具的一个实现细节，用户不必直接与这些下载的依赖交互。 例如，如果我们删除整个 sbt 依赖项缓存，则在项目的下一次编译时，sbt 会自动重新解析并再次下载所有必需的依赖项。 + +这与 Python 不同，默认情况下，依赖项安装在系统范围或用户范围的目录中，因此要在每个项目的基础上获得隔离环境，必须创建相应的虚拟环境。 例如，使用 `venv` 模块，我们可以像这样为特定项目创建一个 + +``` +cd myapp +python3 -m venv myapp-env +source myapp-env/bin/activate +pip install -r requirements.txt +``` + +这会在项目的 `myapp/myapp-env` 目录下安装所有依赖项，并更改 shell 环境变量 `PATH` 以从 `myapp-env` 查找依赖项。 +在 Scala 中，这些手动过程都不是必需的。 + + +[collections-classes]: {% link _overviews/scala3-book/collections-classes.md %} +[concurrency]: {% link _overviews/scala3-book/concurrency.md %} +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} +[control-structures]: {% link _overviews/scala3-book/control-structures.md %} +[extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[fp-intro]: {% link _overviews/scala3-book/fp-intro.md %} +[hofs]: {% link _overviews/scala3-book/fun-hofs.md %} +[intersection-types]: {% link _overviews/scala3-book/types-intersection.md %} +[main-method]: {% link _overviews/scala3-book/methods-main-methods.md %} +[modeling-intro]: {% link _overviews/scala3-book/domain-modeling-intro.md %} +[multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} +[toplevel]: {% link _overviews/scala3-book/taste-toplevel-definitions.md %} +[type-classes]: {% link _overviews/scala3-book/types-type-classes.md %} +[union-types]: {% link _overviews/scala3-book/types-union.md %} +
      From d3637fbdcb1d2b500defcd9a4d3888b1ea566bbb Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Thu, 16 Jun 2022 21:25:13 +0800 Subject: [PATCH 1926/3075] corrected broken link in concurrency.md --- _zh-cn/overviews/scala3-book/concurrency.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/concurrency.md b/_zh-cn/overviews/scala3-book/concurrency.md index 02b3234842..5eafd6face 100644 --- a/_zh-cn/overviews/scala3-book/concurrency.md +++ b/_zh-cn/overviews/scala3-book/concurrency.md @@ -8,7 +8,7 @@ next-page: scala-tools --- -当您想在 Scala 中编写并行和并发应用程序时，您_可以_使用本机 Java `Thread` --- 但 Scala [Future](https://www.scala-lang.org/api/current/scala/concurrent /Future$.html) 提供了一种更高级和惯用的方法，因此它是首选，本章将对此进行介绍。 +当您想在 Scala 中编写并行和并发应用程序时，您_可以_使用本机 Java `Thread` --- 但 Scala [Future](https://www.scala-lang.org/api/current/scala/concurrent/Future$.html) 提供了一种更高级和惯用的方法，因此它是首选，本章将对此进行介绍。 ## 介绍 From 80e20598b90351f7840d53396cd0fa303f9c9fec Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Thu, 26 May 2022 19:07:08 +0300 Subject: [PATCH 1927/3075] Add Ukrainian cheatsheet --- _cheatsheets/index.md | 3 +- _uk/cheatsheets/index.md | 624 +++++++++++++++++++++++++++++++++++++++ _uk/index.md | 2 +- 3 files changed, 626 insertions(+), 3 deletions(-) create mode 100644 _uk/cheatsheets/index.md diff --git a/_cheatsheets/index.md b/_cheatsheets/index.md index 2b4cc489ec..41e35e3eb2 100644 --- a/_cheatsheets/index.md +++ b/_cheatsheets/index.md @@ -7,7 +7,7 @@ partof: cheatsheet by: Brendan O'Connor about: Thanks to Brendan O'Connor, this cheatsheet aims to be a quick reference of Scala syntactic constructions. Licensed by Brendan O'Connor under a CC-BY-SA 3.0 license. -languages: [ba, fr, ja, pl, pt-br, zh-cn, th, ru] +languages: [ba, fr, ja, pl, pt-br, zh-cn, th, ru, uk] --- @@ -220,7 +220,6 @@ languages: [ba, fr, ja, pl, pt-br, zh-cn, th, ru] 
      import scala.util.control.Breaks._
-
 breakable {
   for (x <- xs) {
     if (Math.random < 0.1)
diff --git a/_uk/cheatsheets/index.md b/_uk/cheatsheets/index.md
new file mode 100644
index 0000000000..80caabc188
--- /dev/null
+++ b/_uk/cheatsheets/index.md
@@ -0,0 +1,624 @@
+---
+layout: cheatsheet
+title: Scala Cheatsheet
+
+partof: cheatsheet
+
+by: Dmytro Kazanzhy
+about: Ця шпаргалка створена завдяки Brendan O'Connor, та призначена для швидкого ознайомлення з синтаксичними конструкціями Scala. Ліцензовано Brendan O'Connor за ліцензією CC-BY-SA 3.0.
+
+language: uk
+---
+
+###### Contributed by {{ page.by }}
+
+{{ page.about }}
+
+
+  
+    
+    
+  
+  
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+     
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+    
+      
+      
+    
+  
+
      змінні 
      var x = 5

       Вірно
      x = 6
      		Змінна.
      val x = 5

       Невірно
      x = 6
      		Константа (значення).
      var x: Double = 5
      		Явне вказання типу.
      функції 
      Вірно
       
      def f(x: Int) = { x * x }

       Невірно
       
      def f(x: Int)   { x * x }
      		Визначення функції.
      Прихована помилка: без = це процедура, що повертає Unit та може ввести в оману. Не підтримується зі Scala 2.13.
      Вірно
       
      def f(x: Any) = println(x)

       Невірно
       
      def f(x) = println(x)
      		Визначення функції.
      Синтаксична помилка: для кожного аргументу має бути вказано тип.
      type R = Double
      		Псевдонім (синонім) типу.
      def f(x: R)
       vs.
       
      def f(x: => R)
      		Виклик-за-значенням.

      Виклик-за-іменем (розрахунок параметру відкладено).
      (x: R) => x * x
      		Анонімна функція.
      (1 to 5).map(_ * 2)
       vs.
       
      (1 to 5).reduceLeft(_ + _)
      		Анонімна функція: підкреслення це позиційний аргумент, тобто місце, куди буде підставлено аргумент функції.
      (1 to 5).map(x => x * x)
      		Анонімна функція: зліва від => задається ім'я змінної, якій буде присвоєно аргумент та яку можна використати справа.
      (1 to 5).map { x =>
+  val y = x * 2
+  println(y)
+  y
+}
      		Анонімна функція: блоковий стиль (фігурні дужки означають блок) повертає останній вираз.
      (1 to 5) filter {
+  _ % 2 == 0
+} map {
+  _ * 2
+}
      		Анонімна функція: конвеєрний стиль.
      def compose(g: R => R, h: R => R) =
+  (x: R) => g(h(x))
       
       
      val f = compose(_ * 2, _ - 1)
      		Анонімна функція: для передачі кількох блоків потрібні зовнішні дужки.
      val zscore =
+  (mean: R, sd: R) =>
+    (x: R) =>
+      (x - mean) / sd
      		Каррування, явний синтакси.
      def zscore(mean: R, sd: R) =
+  (x: R) =>
+    (x - mean) / sd
      		Каррування, явний синтаксис.
      def zscore(mean: R, sd: R)(x: R) =
+  (x - mean) / sd
      		Каррування, синтаксичний цукор. Але:
      val normer =
+  zscore(7, 0.4) _
      		Потрібне кінцеве підкреслення, щоб отримати частково застосовану функцію (лише для версії з синтаксичним цукром).
      def mapmake[T](g: T => T)(seq: List[T]) =
+  seq.map(g)
      		Узагальнений тип (параметричний поліморфізм).
      5.+(3); 5 + 3
       
       
      (1 to 5) map (_ * 2)
      		Інфіксний цукор (метод з одним аргументом може бути викликано як оператор).
      def sum(args: Int*) =
+  args.reduceLeft(_+_)
      		Varargs (аргументи змінної довжини).
      пакети 
      import scala.collection._
      		Імпорт всього вмісту пакету.
      import scala.collection.Vector
       
       
      import scala.collection.{Vector, Sequence}
      		Вибірковий імпорт.
      import scala.collection.{Vector => Vec28}
      		Імпорт з перейменуванням.
      import java.util.{Date => _, _}
      		Імпорт всього з java.util окрім Date.
      На початку файлу: 
      package pkg

       Пакет в певних межах:  
      package pkg {
+  ...
+}

      Пакет одиночка (singleton):  
      package object pkg {
+  ...
+}
      		Оголошення пакету.
      структури даних 
      (1, 2, 3)
      		Кортеж (Tuple). Трансформується у виклик Tuple3.
      var (x, y, z) = (1, 2, 3)
      		Деструктивна прив'язка: кортеж розпаковується через зіставлення зі зразком (pattern matching).
      Невірно
      var x, y, z = (1, 2, 3)
      		Прихована помилка: кожна змінна прив'язана до всього кортежу.
      var xs = List(1, 2, 3)
      		Список (немутабельний).
      xs(2)
      		Індексація через дужки (slides).
      1 :: List(2, 3)
      		Додавання елементу до голови списку.
      1 to 5
       так само, як і 
      1 until 6
       
       
      1 to 10 by 2
      		Синтаксичний цукор для діапазонів.
      ()
      		Пусті дужки це єдине значення для типу Unit.
      Еквівалентно до void у C та Java.
      управляючі конструкти 
      if (check) happy else sad
      		Умовний конструкт.
      if (check) happy
      
+      
      так само, як і
      
+      
      if (check) happy else ()
      		Умовний конструкт (синтаксичний цукор).
      while (x < 5) {
+  println(x)
+  x += 1
+}
      		Цикл while.
      do {
+  println(x)
+  x += 1
+} while (x < 5)
      		Цикл do-while.
      import scala.util.control.Breaks._
+breakable {
+  for (x <- xs) {
+    if (Math.random < 0.1)
+      break
+  }
+}
      		Break (slides).
      for (x <- xs if x % 2 == 0)
+  yield x * 10
      
+      
      так само, як і
      
+      
      xs.filter(_ % 2 == 0).map(_ * 10)
      		Цикл for: filter/map.
      for ((x, y) <- xs zip ys)
+  yield x * y
      
+      
      так само, як і
      
+      
      (xs zip ys) map {
+  case (x, y) => x * y
+}
      		Цикл for: деструктивна прив'язка.
      for (x <- xs; y <- ys)
+  yield x * y
      
+      
      так само, як і
      
+      
      xs flatMap { x =>
+  ys map { y =>
+    x * y
+  }
+}
      		Цикл for: декартів добуток.
      for (x <- xs; y <- ys) {
+  val div = x / y.toFloat
+  println("%d/%d = %.1f".format(x, y, div))
+}
      		Цикл for: імперативність.
      стильsprintf.
      for (i <- 1 to 5) {
+  println(i)
+}
      		Цикл for: ітерація з включенням верхньої межі.
      for (i <- 1 until 5) {
+  println(i)
+}
      		Цикл for: ітерація без включення верхньої межі.
      зіставлення із зразком (pattern matching) 
      Вірно
       
      (xs zip ys) map {
+  case (x, y) => x * y
+}

       Невірно
       
      (xs zip ys) map {
+  (x, y) => x * y
+}
      		Для зіставлення зі зразком необхідно використати case перед аргументами анонімної функції.
      Невірно
      
+      
      val v42 = 42
+24 match {
+  case v42 => println("42")
+  case _   => println("Not 42")
+}
      		v42 буде інтерпретовано так само як ім'я змінної, яка буде вірно зіставлена з будь-яким Int значенням, і буде виведено “42”.
      Вірно
      
+      
      val v42 = 42
+24 match {
+  case `v42` => println("42")
+  case _     => println("Not 42")
+}
      		`v42` у зворотних галочках буде інтерпретовано як значення змінної v42, і буде виведено “Not 42”.
      Вірно
      
+      
      val UppercaseVal = 42
+24 match {
+  case UppercaseVal => println("42")
+  case _            => println("Not 42")
+}
      		UppercaseVal буде інтерпретовано так само як наявна змінна, а не патерн, тому що починається з великої літери. Тому значення, що міститься в UppercaseVal буде порівняно з 24, і буде виведено “Not 42”.
      об'єктна орієнтація 
      class C(x: R)
      		Параметри конструктора - тільки x доступний в тілі класу.
      class C(val x: R)

      var c = new C(4)

      c.x
      		Параметри конструктора - автоматичне створення публічного об'єкта.
      class C(var x: R) {
+  assert(x > 0, "positive please")
+  var y = x
+  val readonly = 5
+  private var secret = 1
+  def this = this(42)
+}
      		Тіло класу є конструктором.
      Оголосити відкритий (public) атрибут.
      Оголосити атрибут, доступний тільки на читання.
      Оголосити закритий (private) атрибут.
      Альтернативний конструктор.
      new {
+  ...
+}
      		Анонімний клас.
      abstract class D { ... }
      		Визначити абстрактний клас (без можливості створення об'єкту).
      class C extends D { ... }
      		Визначити клас, що наслідує інший.
      class D(var x: R)

      class C(x: R) extends D(x)
      		Наслідування та параметри конструктора (за замовчуванням відбувається передача аргументів).
      object O extends D { ... }
      		Визначити єдиний екземпляр (singleton).
      trait T { ... }

      class C extends T { ... }

      class C extends D with T { ... }
      		Риси - трейти (traits).
      Інтерфейси-з-імплементацією. У трейту немає параметрів конструктора. композиція з домішками (mixin).
      trait T1; trait T2

      class C extends T1 with T2

      class C extends D with T1 with T2
      		Множинні трейти.
      class C extends D { override def f = ...}
      		При реалізації вже наявного методу необхідно вказати overrides.
      new java.io.File("f")
      		Створення об'єкту.
      Невірно
       
      new List[Int]

       Вірно
       
      List(1, 2, 3)
      		Помилка типу: абстрактний тип.
      Натомість, необхідно використати виклик конструктора, що приховує тип.
      classOf[String]
      		Визначити клас (Class[String] = class java.lang.String).
      x.isInstanceOf[String]
      		Перевірка типу під час виконання (runtime).
      x.asInstanceOf[String]
      		Приведення типу під час виконання (runtime).
      x: String
      		Приписування типу під час компіляції (compile time). 
      опції (options) 
      Some(42)
      		Конструктор для непустого опціонального значення (тип Some[T]).
      None
      		Конструктор для пустого опціонального значення (тип None).
      Option(null) == None
+Option(24) == Some(24)
      
+      
      obj.unsafeMethod // number or null
+Option(obj.unsafeMethod) // Some or None
      
+      проте
+      
      Some(null) != None
      		Null-safe конструктор опціональних значень.
      val optStr: Option[String] = None
      
+      так само, як і
+      
      val optStr = Option.empty[String]
      		Явна типізація опціонального значення.
       Конструктор пустих опціональних значень.
      val name: Option[String] =
+  request.getParameter("name")
+val upper = name.map {
+  _.trim
+} filter {
+  _.length != 0
+} map {
+  _.toUpperCase
+}
+println(upper.getOrElse(""))
      		Конвеєрний стиль.
      val upper = for {
+  name <- request.getParameter("name")
+  trimmed <- Some(name.trim)
+    if trimmed.length != 0
+  upper <- Some(trimmed.toUpperCase)
+} yield upper
+println(upper.getOrElse(""))
      		Синтаксис у циклі for.
      option.map(f(_))
      
+      так само, як і
+      
      option match {
+  case Some(x) => Some(f(x))
+  case None    => None
+}
      		Застосування функції до опціонального значення.
      option.flatMap(f(_))
      
+      так само, як і
+      
      option match {
+  case Some(x) => f(x)
+  case None    => None
+}
      		Так само, як і mapб але функція має повернути опціональне значення.
      optionOfOption.flatten
      
+      так само, як і
+      
      optionOfOption match {
+  case Some(Some(x)) => Some(x)
+  case _             => None
+}
      		Екстракція вкладених опціональних значень.
      option.foreach(f(_))
      
+      так само, як і
+      
      option match {
+  case Some(x) => f(x)
+  case None    => ()
+}
      		Застосувати процедуру на опціональному значенні.
      option.fold(y)(f(_))
      
+      так само, як і
+      
      option match {
+  case Some(x) => f(x)
+  case None    => y
+}
      		Застосувати функцію на опціональному значенні та повернути значення, якщо воно порожнє.
      option.collect {
+  case x => ...
+}
      
+      так само, як і
+      
      option match {
+  case Some(x) if f.isDefinedAt(x) => ...
+  case Some(_)                     => None
+  case None                        => None
+}
      		Виконати часткове зіставлення зі зразком опціонального значення.
      option.isDefined
      
+      так само, як і
+      
      option match {
+  case Some(_) => true
+  case None    => false
+}
      		true якщо не порожнє.
      option.isEmpty
      
+      так само, як і
+      
      option match {
+  case Some(_) => false
+  case None    => true
+}
      		true якщо порожнє.
      option.nonEmpty
      
+      так само, як і
+      
      option match {
+  case Some(_) => true
+  case None    => false
+}
      		true якщо не порожнє.
      option.size
      
+      так само, як і
+      
      option match {
+  case Some(_) => 1
+  case None    => 0
+}
      		0 якщо порожнє, інакше 1.
      option.orElse(Some(y))
      
+      так само, як і
+      
      option match {
+  case Some(x) => Some(x)
+  case None    => Some(y)
+}
      		Оцінити та повернути альтернативне опціональне значення, якщо порожнє.
      option.getOrElse(y)
      
+      так само, як і
+      
      option match {
+  case Some(x) => x
+  case None    => y
+}
      		Оцінити та повернути значення за замовчуванням, якщо порожнє.
      option.get
      
+      так само, як і
+      
      option match {
+  case Some(x) => x
+  case None    => throw new Exception
+}
      		Повернути значення, або помилку, якщо порожнє.
      option.orNull
      
+      так само, як і
+      
      option match {
+  case Some(x) => x
+  case None    => null
+}
      		Повернути значення, null якщо порожнє.
      option.filter(f)
      
+      так само, як і
+      
      option match {
+  case Some(x) if f(x) => Some(x)
+  case _               => None
+}
      		Фільтрація опціонального значення. Повернути значення, якщо предикат істинний.
      option.filterNot(f(_))
      
+      так само, як і
+      
      option match {
+  case Some(x) if !f(x) => Some(x)
+  case _                => None
+}
      		Фільтрація опціонального значення. Повернути значення, якщо предикат хибний.
      option.exists(f(_))
      
+      так само, як і
+      
      option match {
+  case Some(x) if f(x) => true
+  case Some(_)         => false
+  case None            => false
+}
      		Повернути значення предикату на опціональному значенні або false якщо порожнє.
      option.forall(f(_))
      
+      так само, як і
+      
      option match {
+  case Some(x) if f(x) => true
+  case Some(_)         => false
+  case None            => true
+}
      		Повернути значення предикату на опціональному значенні або true якщо порожнє..
      option.contains(y)
      
+      так само, як і
+      
      option match {
+  case Some(x) => x == y
+  case None    => false
+}
      		Перевіряє чи дорівнює опціональне значення параметру, false якщо порожнє.
      
diff --git a/_uk/index.md b/_uk/index.md
index 211050d3f1..298a5b8a18 100644
--- a/_uk/index.md
+++ b/_uk/index.md
@@ -105,7 +105,7 @@ scala2-sections:
       - title: "Шпаргалка"
         description: "Зручна шпаргалка з основ синтаксису Scala."
         icon: "fa fa-list"
-        link: /cheatsheets/index.html
+        link: /uk/cheatsheets/index.html
       - title: "Питання-Відповіді"
         description: "Відповіді на часті запитання про Scala."
         icon: "fa fa-question-circle"

From 337d5c66e7bd8298b42176d7bf23b16ec5192267 Mon Sep 17 00:00:00 2001
From: Dmytro Kazanzhy 
Date: Wed, 1 Jun 2022 20:09:35 +0300
Subject: [PATCH 1928/3075] Fix of some mistakes

---
 _uk/cheatsheets/index.md | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/_uk/cheatsheets/index.md b/_uk/cheatsheets/index.md
index 80caabc188..24412df349 100644
--- a/_uk/cheatsheets/index.md
+++ b/_uk/cheatsheets/index.md
@@ -54,7 +54,7 @@ language: uk
     
     
       
      def f(x: R)
       vs.
       
      def f(x: => R)
      
-      Виклик-за-значенням.

      Виклик-за-іменем (розрахунок параметру відкладено).
+      Виклик-за-значенням.

      Виклик-за-іменем (аргумент обчислюється кожен раз як до нього звертаються).
     
     
       
      (x: R) => x * x
      
@@ -66,7 +66,7 @@ language: uk
     
     
       
      (1 to 5).map(x => x * x)
      
-      Анонімна функція: зліва від => задається ім'я змінної, якій буде присвоєно аргумент та яку можна використати справа.
+      Анонімна функція: щоб використати аргумент двічі, треба його назвати. Зліва від => задається ім'я змінної, якій буде присвоєно аргумент та яку можна використати справа.
     
     
       
      (1 to 5).map { x =>
@@ -172,7 +172,7 @@ language: uk
     
     
       
      var xs = List(1, 2, 3)
      
-      Список (немутабельний).
+      Список (імутабельний, тобто такий, що не змінюється).
     
     
       
      xs(2)
      
@@ -260,7 +260,7 @@ breakable {
   val div = x / y.toFloat
   println("%d/%d = %.1f".format(x, y, div))
 }
      
-      Цикл for: імперативність.
      стильsprintf.
+      Цикл for: імперативізм.
      стильsprintf.
     
     
       
      for (i <- 1 to 5) {
@@ -293,7 +293,7 @@ breakable {
   case v42 => println("42")
   case _   => println("Not 42")
 }
      
-      v42 буде інтерпретовано так само як ім'я змінної, яка буде вірно зіставлена з будь-яким Int значенням, і буде виведено “42”.
+      v42 буде інтерпретовано як ім'я змінної у зразку, яка буде вірно зіставлена з будь-яким Int значенням, і буде виведено “42”.
     
     
       Вірно
      
@@ -302,7 +302,7 @@ breakable {
   case `v42` => println("42")
   case _     => println("Not 42")
 }
      - `v42` у зворотних галочках буде інтерпретовано як значення змінної v42, і буде виведено “Not 42”. + `v42` у зворотних галочках буде інтерпретовано як значення наявної змінної v42, і буде виведено “Not 42”. Вірно
      @@ -311,7 +311,7 @@ breakable { case UppercaseVal => println("42") case _ => println("Not 42") } - UppercaseVal буде інтерпретовано так само як наявна змінна, а не патерн, тому що починається з великої літери. Тому значення, що міститься в UppercaseVal буде порівняно з 24, і буде виведено “Not 42”. + UppercaseVal буде інтерпретовано так само як наявна змінна, а не нова змінна в патерні. Тому значення, що міститься в UppercaseVal буде порівняно з 24, і буде виведено “Not 42”. об'єктна орієнтація @@ -375,11 +375,11 @@ breakable { Невірно
      new List[Int]

      Вірно
      List(1, 2, 3)
      - Помилка типу: абстрактний тип.
      Натомість, необхідно використати виклик конструктора, що приховує тип. + Помилка типу: абстрактний тип.
      Натомість, існує конвенція у таких випадках використовувати фабричний метод обʼєкту компаньйону, що приховує конкретний тип. 
      classOf[String]
      - Визначити клас (Class[String] = class java.lang.String). + Літерал класу (Class[String] = class java.lang.String). 
      x.isInstanceOf[String]
      @@ -404,7 +404,7 @@ breakable { 
      None
      - Конструктор для пустого опціонального значення (тип None). + Одинак (Singleton) пустого опціонального значення (тип None). 
      Option(null) == None
@@ -413,13 +413,13 @@ Option(24) == Some(24)
      Option(obj.unsafeMethod) // Some or None проте 
      Some(null) != None
      - Null-safe конструктор опціональних значень. + Null-safe фабрика опціональних значень. 
      val optStr: Option[String] = None
      так само, як і 
      val optStr = Option.empty[String]
      - Явна типізація опціонального значення.
      Конструктор пустих опціональних значень. + Явна типізація опціонального значення.
      Фабричний метод для створення пустих опціональних значень. 
      val name: Option[String] =
@@ -442,7 +442,7 @@ println(upper.getOrElse(""))
      upper <- Some(trimmed.toUpperCase) } yield upper println(upper.getOrElse("")) - Синтаксис у циклі for. + Синтаксис for-виразу. 
      option.map(f(_))
      @@ -469,7 +469,7 @@ println(upper.getOrElse("")) case Some(Some(x)) => Some(x) case _ => None } - Екстракція вкладених опціональних значень. + Вилучення вкладених опціональних значень. 
      option.foreach(f(_))
      @@ -544,7 +544,7 @@ println(upper.getOrElse("")) case Some(x) => Some(x) case None => Some(y) } - Оцінити та повернути альтернативне опціональне значення, якщо порожнє. + Обчислити та повернути альтернативне опціональне значення, якщо порожнє. 
      option.getOrElse(y)
      @@ -553,7 +553,7 @@ println(upper.getOrElse("")) case Some(x) => x case None => y } - Оцінити та повернути значення за замовчуванням, якщо порожнє. + Обчислити та повернути значення за замовчуванням, якщо порожнє. 
      option.get
      @@ -562,7 +562,7 @@ println(upper.getOrElse("")) case Some(x) => x case None => throw new Exception } - Повернути значення, або помилку, якщо порожнє. + Повернути значення, або згенерувати виключення, якщо порожнє. 
      option.orNull
      From d355ae7dd6d322abcbbd03e4b0be6240d4aa633c Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Wed, 15 Jun 2022 22:14:01 +0300 Subject: [PATCH 1929/3075] Add Ukrainian getting started --- _getting-started/index.md | 2 +- ...g-a-scala-project-with-intellij-and-sbt.md | 2 +- .../getting-started-with-scala-in-intellij.md | 2 +- ...esting-scala-in-intellij-with-scalatest.md | 2 +- ...-with-scala-and-sbt-on-the-command-line.md | 2 +- ...ting-scala-with-sbt-on-the-command-line.md | 2 +- _includes/_uk/getting-started.md | 210 ++++++++++++++++++ _uk/getting-started/index.md | 9 + ...g-a-scala-project-with-intellij-and-sbt.md | 101 +++++++++ .../getting-started-with-scala-in-intellij.md | 77 +++++++ ...esting-scala-in-intellij-with-scalatest.md | 73 ++++++ ...-with-scala-and-sbt-on-the-command-line.md | 84 +++++++ ...ting-scala-with-sbt-on-the-command-line.md | 104 +++++++++ _uk/index.md | 4 +- _uk/scala3/getting-started.md | 8 + scala3/getting-started.md | 2 +- 16 files changed, 675 insertions(+), 9 deletions(-) create mode 100644 _includes/_uk/getting-started.md create mode 100644 _uk/getting-started/index.md create mode 100644 _uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md create mode 100644 _uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md create mode 100644 _uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md create mode 100644 _uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md create mode 100644 _uk/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md create mode 100644 _uk/scala3/getting-started.md diff --git a/_getting-started/index.md b/_getting-started/index.md index 03af9270c4..a26af28495 100644 --- a/_getting-started/index.md +++ b/_getting-started/index.md @@ -2,7 +2,7 @@ layout: singlepage-overview title: Getting Started partof: getting-started -languages: [fr, ja] +languages: [fr, ja, uk] includeTOC: true redirect_from: "/getting-started.html" diff --git a/_getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md b/_getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md index 8d625bad57..c335e94af2 100644 --- a/_getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md +++ b/_getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md @@ -2,7 +2,7 @@ title: Building a Scala Project with IntelliJ and sbt layout: singlepage-overview partof: building-a-scala-project-with-intellij-and-sbt -languages: [ja] +languages: [ja, uk] disqus: true previous-page: getting-started/intellij-track/getting-started-with-scala-in-intellij next-page: testing-scala-in-intellij-with-scalatest diff --git a/_getting-started/intellij-track/getting-started-with-scala-in-intellij.md b/_getting-started/intellij-track/getting-started-with-scala-in-intellij.md index 6bab3d3d14..1d06687401 100644 --- a/_getting-started/intellij-track/getting-started-with-scala-in-intellij.md +++ b/_getting-started/intellij-track/getting-started-with-scala-in-intellij.md @@ -2,7 +2,7 @@ title: Getting Started with Scala in IntelliJ layout: singlepage-overview partof: getting-started-with-scala-in-intellij -languages: [ja] +languages: [ja, uk] disqus: true next-page: building-a-scala-project-with-intellij-and-sbt diff --git a/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index fb34580984..bfc23717f8 100644 --- a/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -2,7 +2,7 @@ title: Testing Scala in IntelliJ with ScalaTest layout: singlepage-overview partof: testing-scala-in-intellij-with-scalatest -languages: [ja] +languages: [ja, uk] disqus: true previous-page: building-a-scala-project-with-intellij-and-sbt diff --git a/_getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md b/_getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md index 5c7bc37325..47ffcbf72e 100644 --- a/_getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md +++ b/_getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md @@ -2,7 +2,7 @@ title: Getting Started with Scala and sbt on the Command Line layout: singlepage-overview partof: getting-started-with-scala-and-sbt-on-the-command-line -languages: [ja] +languages: [ja, uk] disqus: true next-page: testing-scala-with-sbt-on-the-command-line diff --git a/_getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md b/_getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md index accc081592..6a2db51a93 100644 --- a/_getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md +++ b/_getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md @@ -2,7 +2,7 @@ title: Testing Scala with sbt and ScalaTest on the Command Line layout: singlepage-overview partof: testing-scala-with-sbt-on-the-command-line -languages: [ja] +languages: [ja, uk] disqus: true previous-page: getting-started-with-scala-and-sbt-on-the-command-line diff --git a/_includes/_uk/getting-started.md b/_includes/_uk/getting-started.md new file mode 100644 index 0000000000..7146ff7300 --- /dev/null +++ b/_includes/_uk/getting-started.md @@ -0,0 +1,210 @@ +Інструкції нижче стосуються як Scala 2 так, і та Scala 3. + +## Спробуйте Scala без інсталяції + +Щоб швидко почати експериментувати зі Scala, відкрийте “Scastie” у вашому браузері. +_Scastie_ це онлайн “пісочниця” де ви можете експериментувати з прикладами на Scala та подивитись як все працює, з доступом до всіх компіляторів Scala та доступних бібліотек. + +> Scastie підтримує як Scala 2 так, і Scala 3, але за замовчування +> використовується Scala 3. Якщо ж ви шукаєте приклади на Scala 2, +> [натисніть тут](https://scastie.scala-lang.org/MHc7C9iiTbGfeSAvg8CKAA). + +## Встановіть Scala на ваш комп'ютер + +Інсталяція Scala означає встановлення різних command-line інструментів, таких як компілятор Scala та інструменти для збірки. +Ми радимо використовувати інсталятор "Coursier" який автоматично встановить всі необхідні залежності, але ви можете встановити окремо кожен інструмент. + +### За допомогою інсталятора Scala (рекомендовано) + +Інсталятор Scala називається [Coursier](https://get-coursier.io/docs/cli-overview), а його основна команда має назву `cs`. +Він гарантує, що JVM та стандартні інструменти Scala встановлені на вашій системі. +Щоб встановити його на вашій системі виконайте наступні інструкції. + + +{% tabs install-cs-setup-tabs class=platform-os-options %} + + +{% tab macOS for=install-cs-setup-tabs %} +Виконайте наступну команду в терміналі, виконуючи всі спливаючі інструкції: +{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} +{% altDetails cs-setup-macos-nobrew "Якщо ви не використовуєте Homebrew:" %} +{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +{% endaltDetails %} +{% endtab %} + + + +{% tab Linux for=install-cs-setup-tabs %} +Виконайте наступну команду в терміналі, виконуючи всі спливаючі інструкції: +{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +{% endtab %} + + + +{% tab Windows for=install-cs-setup-tabs %} +Завантажте та запустіть [the Scala installer for Windows]({{site.data.setup-scala.windows-link}}) +інсталятор на основі Coursier, виконуючи всі спливаючі інструкції. +{% endtab %} + + + +{% tab Other for=install-cs-setup-tabs defaultTab %} + +Дотримуйтесь документації від Coursier з того, +[як встановити і запустити `cs setup`](https://get-coursier.io/docs/cli-installation). +{% endtab %} + + +{% endtabs %} + + + +{% altDetails testing-your-setup 'Перевірити налаштування' %} +Перевірте ваші налаштування виконавши команду `scala -version`, яка має вивести: +```bash +$ scala -version +Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL +``` +Якщо це не спрацювало, необхідно завершити сеанс та зайти в систему знову (або перезавантажити) щоб зміни застосувались на вашій системі. +{% endaltDetails %} + + + +Разом з менеджментом JVM-ів, `cs setup` також встановлює корисні command-line інструменти: + +| Команда | Опис | +|---------------|----------------------------------------------------------------------------------------| +| `scalac` | компілятор Scala | +| `scala` | інтерактивне середовище Scala та інструмент для запуску скриптів | +| `scala-cli` | [Scala CLI](https://scala-cli.virtuslab.org), інтерактивні інструменти для Scala | +| `sbt`, `sbtn` | Інструмент збірки [sbt](https://www.scala-sbt.org/) | +| `amm` | [Ammonite](https://ammonite.io/) розширене інтерактивне середовище (REPL) | +| `scalafmt` | [Scalafmt](https://scalameta.org/scalafmt/) призначений для форматування коду на Scala | + +Для більш детальної інформації про `cs`, прочитайте +[документацію coursier-cli](https://get-coursier.io/docs/cli-overview). + +> `cs setup` встановлює компілятор Scala 3 та інтерактивне середовище за замовчування (команди `scalac` та +> `scala` відповідно). Незалежно від того, чи збираєтеся ви використовувати Scala 2 чи 3, +> тому що більшість проєктів використовує інструменти для збірки, +> які використовують правильні версії Scala незалежно від того, яка встановлена "глобально". +> Тим не менш, ви завжди можете запустити певну версію Scala за допомогою +> ``` +> $ cs launch scala:{{ site.scala-version }} +> $ cs launch scalac:{{ site.scala-version }} +> ``` +> Якщо ви надаєте перевагу Scala 2 за замовчуванням, ви можете примусово встановити певну версію: +> ``` +> $ cs install scala:{{ site.scala-version }} scalac:{{ site.scala-version }} +> ``` + +### ...або вручну + +Вам необхідно лише два інструменти, для того, щоб скомпілювати, запустити, протестувати й упакувати Scala проєкт: Java 8 або 11, і sbt. +Щоб встановити їх вручну: + +1. якщо Java 8 або 11 не встановлені, необхідно завантажити + Java з [Oracle Java 8](https://www.oracle.com/java/technologies/javase-jdk8-downloads.html), [Oracle Java 11](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html), + або [AdoptOpenJDK 8/11](https://adoptopenjdk.net/). Перевірте [сумісність JDK](/overviews/jdk-compatibility/overview.html) для Scala/Java. +1. Встановіть [sbt](https://www.scala-sbt.org/download.html) + +## Створити проєкт "Hello World" з sbt + +Коли ви вже встановили sbt, ви готові, щоб створити проект на Scala, який +ми розглянемо у подальших розділах. + +Щоб створити проєкт, ви можете використати або термінал, або IDE. +Якщо ви знайомі з командним рядком, ми рекомендуємо такий підхід. + +### За допомогою командного рядка + +Інструмент sbt призначений для збірки проєкту на Scala. sbt компілює, запускає, +та тестує ваш код на Scala. (Також, він публікує бібліотеки та виконує багато інших задач.) + +Щоб створити новий Scala проєкт за допомогою sbt: + +1. `cd` в пусту директорію. +1. Виконайте команду `sbt new scala/scala3.g8` щоб створити проєкт на Scala 3, або `sbt new scala/hello-world.g8` щоб створити проєкт на Scala 2. + Команда завантажує шаблон проєкту з GitHub. + Також, створює директорію `target`, яку ви можете проігнорувати. +1. Коли буде запропоновано, оберіть назву програми `hello-world`. В результаті буде створено проєкт "hello-world". +1. Подивимося, що щойно було створено: + +``` +- hello-world + - project (sbt uses this for its own files) + - build.properties + - build.sbt (sbt's build definition file) + - src + - main + - scala (весь ваш код на Scala буде тут) + - Main.scala (Точка входу в програму) <-- це все, що потрібно наразі +``` + +Більше документації про sbt можна знайти у [Книзі по Scala](/scala3/book/tools-sbt.html) (див. [тут](/overviews/scala-book/scala-build-tool-sbt.html) версію для Scala 2) +та в офіційній [документації](https://www.scala-sbt.org/1.x/docs/index.html) sbt + +### За допомогою IDE + +Ви можете пропустити подальші кроки та перейти до [Створення Scala проєкту з IntelliJ і sbt](/uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.html) + + +## Відкрити проєкт hello-world + +Використаймо IDE, щоб відкрити. Найбільш популярними є IntelliJ та VSCode. +Обидва з них мають багатий функціонал, але ви також можете використати [багато інших редакторів.](https://scalameta.org/metals/docs/editors/overview.html) + +### За допомогою IntelliJ + +1. Завантажте та встановіть [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/) +1. Встановіть плагін Scala дотримуючись [інструкції з встановлення плагінів в IntelliJ](https://www.jetbrains.com/help/idea/managing-plugins.html) +1. Відкрийте файл `build.sbt` та оберіть *Відкрити як проєкт* (*Open as a project*) + +### За допомогою VSCode та metals + +1. Завантажте [VSCode](https://code.visualstudio.com/Download) +1. Встановіть розширення Metals з [the Marketplace](https://marketplace.visualstudio.com/items?itemName=scalameta.metals) +1. Наступне, відкрийте директорію, що містить файл `build.sbt` (це має бути директорія `hello-world` якщо ви виконали попередні інструкції). Коли буде запропоновано, оберіть *Імпортувати збірку* (*Import build*). + +>[Metals](https://scalameta.org/metals) це “Сервер мови Scala” який забезпечує можливість написання коду на Scala в VS Code та інших редакторах на кшталт [Atom, Sublime Text, and more](https://scalameta.org/metals/docs/editors/overview.html), використовуючи Language Server Protocol. +> +> Під капотом, Metals комунікує з інструментом збірки використовуючи +> [Build Server Protocol (BSP)](https://build-server-protocol.github.io/). Більш детально про те, як працює Metals, можна подивитись на [“Write Scala in VS Code, Vim, Emacs, Atom and Sublime Text with Metals”](https://www.scala-lang.org/2019/04/16/metals.html). + +### Внесення змін в початковий код + +Перегляньте ці два файли у вашому IDE: + +- _build.sbt_ +- _src/main/scala/Main.scala_ + +Коли ви будете запускати ваш проєкт у наступному кроці, то будуть використані конфігурації з _build.sbt_ для запуску коду в _src/main/scala/Main.scala_. + +## Запустити Hello World + +Якщо вам зручно користуватися IDE, ви можете запустити код в _Main.scala_ з вашого IDE. + +В іншому випадку ви можете запустити програму через термінал, виконавши такі дії: + +1. `cd` в `hello-world`. +1. Запустіть `sbt`. Це відкриє консоль sbt. +1. Наберіть `~run`. Символ `~` опціональний і змушує sbt повторно запускатися після кожного збереження файлу, + що забезпечує швидкий цикл редагування/запуск/налагодження. sbt також створить директорію `target`б яку ви можете проігнорувати. + +Коли ви закінчите експериментувати з вашим проєктом, натисніть `[Enter]` щоб перервати команду `run`. +Потім наберіть `exit` або затисніть `[Ctrl+D]` щоб вийти з sbt та повернутись до вашого командного рядка. + +## Наступні кроки + +Після того, як ви закінчите наведені вище посібники, спробуйте пройти: + +* [Книга по Scala](/scala3/book/introduction.html) (версія по Scala 2 [тут](/overviews/scala-book/introduction.html)), яка містить набір коротких ознайомчих уроків по основних можливостях Scala. +* [Тур по Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. +* [Навчальні ресурси](/learn.html), що містять інтерактивні онлайн путівники та курси. +* [Наш список деяких популярних книжок по Scala](/books.html). +* [Посібник з міграції](/scala3/guides/migration/compatibility-intro.html) допомагає перевести ваш наявний проєкт зі Scala 2 на Scala 3. + +## Отримати допомогу +Існує безліч поштових розсилок та чатів в режимі реального часу, якщо ви захочете зв'язатися з іншими користувачами Scala. Перейдіть на сторінку нашої [спільноти](https://scala-lang.org/community/), щоб побачити перелік можливих способів та попросити про допомогу. diff --git a/_uk/getting-started/index.md b/_uk/getting-started/index.md new file mode 100644 index 0000000000..0079a2128f --- /dev/null +++ b/_uk/getting-started/index.md @@ -0,0 +1,9 @@ +--- +layout: singlepage-overview +title: Перші кроки +partof: getting-started +language: uk +includeTOC: true +--- + +{% include _uk/getting-started.md %} diff --git a/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md b/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md new file mode 100644 index 0000000000..135a9d8676 --- /dev/null +++ b/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md @@ -0,0 +1,101 @@ +--- +title: Створення проєкту на Scala з IntelliJ і sbt +layout: singlepage-overview +partof: building-a-scala-project-with-intellij-and-sbt +language: uk +disqus: true +previous-page: /uk/getting-started/intellij-track/getting-started-with-scala-in-intellij +next-page: /uk/testing-scala-in-intellij-with-scalatest +--- + +В цьому туторіалі ми побачимо як будувати Scala проєкти використовуючи [sbt](https://www.scala-sbt.org/1.x/docs/index.html). +sbt — популярний інструмент для компіляції, запуску та тестування проєктів Scala будь-якої складності. +Використання інструменту збірки, такого як sbt (або Maven/Gradle), стає необхідним, коли ви створюєте проєкти із залежностями або кількома файлами коду. +Ми припускаємо, що ви завершили [перший туторіал](./getting-started-with-scala-in-intellij.html). + +## Створення проєкту +У цьому розділі ми покажемо вам, як створити проєкт в IntelliJ. Однак, якщо вам +комфортніше працювати у терміналі, ми рекомендуємо подивитись [початок роботи зі Scala і sbt у командному рядку](/uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) + і потім повернутися сюди до розділу «Написання коду на Scala». + +1. Якщо ви ще не створили проєкт у терміналі запустіть IntelliJ та оберіть "Створити новий проєкт (Create New Project)" + * На панелі зліва оберіть Scala, а на панелі справа оберіть sbt + * Натисніть **Next** + * Назвіть ваш проєкт "SbtExampleProject" +1. Якщо ви вже створили проєкт через термінал, запустіть IntelliJ, оберіть *Імпортувати проєкт (Import Project)* та відкрийте файл `build.sbt` вашого проєкту +1. Впевніться, що **версія JDK** 1.8 або вище, та **версія sbt** 0.13.13 та вище +1. Натисніть **Use auto-import**, щоб залежності автоматично завантажились +1. Натисніть **Finish** + +## Розуміння структури директорій +Завдяки sbt створюються директорії, які можуть бути корисні у разі якщо ви почнете робити складніші проєкти. +Поки що ви можете проігнорувати більшість із них, але ось для чого це все: + +``` +- .idea (IntelliJ files) +- project (plugins and additional settings for sbt) +- src (source files) + - main (application code) + - java (Java source files) + - scala (Scala source files) <-- This is all we need for now + - scala-2.12 (Scala 2.12 specific files) + - test (unit tests) +- target (generated files) +- build.sbt (build definition file for sbt) +``` + + +## Написання коду на Scala +1. На панелі **Project** зліва розкрийте `SbtExampleProject` => `src` => `main` +1. Натисніть праву кнопку миші, `scala` та оберіть **New** => **Package** +1. Назвіть пакет `example` та натисніть **OK** (або просто натисніть клавішу Enter або Return). +1. Натисніть праву кнопку миші на пакет `example` та оберіть **New** => **Scala class** (якщо ви не бачите цю опцію, натисніть праву кнопку миші на `SbtExampleProject`, натисніть **Add Frameworks Support**, оберіть **Scala** та продовжить) +1. Назвіть клас `Main` та змініть **Kind** на `Object`. +1. Змініть код у класі на такий: + +``` +object Main extends App { + val ages = Seq(42, 75, 29, 64) + println(s"The oldest person is ${ages.max}") +} +``` + +Примітка: IntelliJ має власну реалізацію компілятора Scala, тому іноді ваш код є правильним, навіть якщо IntelliJ вказує інше. +Ви завжди можете перевірити у командному рядку, чи може sbt запустити ваш проєкт. + +## Запуск проєкту +1. З меню **Run** оберіть **Edit configurations** +1. Натисніть кнопку **+** та оберіть **sbt Task**. +1. Назвіть його `Run the program`. +1. В полі **Tasks** наберіть `~run`. Опція `~` змушує sbt пере-збирати та перезапускати проєкт, коли ви зберігаєте зміни у файлі проєкту. +1. Натисніть **OK**. +1. В меню **Run** натисніть **Run 'Run the program'**. +1. В коді змініть `75` на `61` та подивіться оновлений результат в консолі. + +## Додавання залежностей +Трохи змінивши фокус уваги, подивімось, як використовувати опубліковані бібліотеки, щоб додати додаткову функціональність до наших програм. +1. Відкрийте `build.sbt` та додайте наступний рядок: + +``` +libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % "1.1.2" +``` + +Тут `libraryDependencies` є набором залежностей та використовуючи `+=`, +ми додаємо залежність [scala-parser-combinators](https://github.com/scala/scala-parser-combinators) до набору залежностей, +які необхідні для sbt та які завантажаться при його запуску. Тепер в будь-якому Scala файлі ви можете використати +класи, об'єкти, тощо з scala-parser-combinators через звичайний "import". + +Більше опублікованих бібліотек можна знайти на +[Scaladex](https://index.scala-lang.org/) - індекс бібліотек Scala, місце куди ви можете зайти, щоб скопіювати інформацію про бібліотеку +та додати у ваш `build.sbt` файл. + +## Наступні кроки + +Перейдіть до наступного туторіалу з серії _початок роботи з IntelliJ_, та дізнайтесь про [тестування Scala в IntelliJ зі ScalaTest](testing-scala-in-intellij-with-scalatest.html). + +**або** + +* [Книга по Scala](/overviews/scala-book/introduction.html), що є набором коротких вступних уроків по основних особливостях Scala. +* [Тур по Scala](/tour/tour-of-scala.html) серія коротких оглядових статей про можливості Scala. +* Продовжить вчити Scala інтерактивно виконуючи + [вправи зі Scala](https://www.scala-exercises.org/scala_tutorial). diff --git a/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md b/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md new file mode 100644 index 0000000000..9bd525c1b3 --- /dev/null +++ b/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md @@ -0,0 +1,77 @@ +--- +title: Перші кроки зі Scala в IntelliJ +layout: singlepage-overview +partof: getting-started-with-scala-in-intellij +language: uk +disqus: true +next-page: /uk/building-a-scala-project-with-intellij-and-sbt +--- + +У цьому туторіалі буде розглянемо як створити мінімальний проєкт Scala за допомогою IntelliJ IDE з плагіном Scala. +У цьому посібнику IntelliJ завантажить для вас Scala. + +## Встановлення +1. Впевніться, що ви вже встановили Java 8 JDK (також відому як 1.8) + * Запустіть `javac -version` у командному рядку і впевніться, що бачите + `javac 1.8.___` + * Якщо у вас не встановлена версія 1.8 або вище, [встановіть JDK](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) +1. Далі, завантажте та встановіть [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/) +1. Після того, як ви запустили IntelliJ, ви можете завантажити й встановити плагін Scala за інструкцією +[як встановлювати плагіни IntelliJ](https://www.jetbrains.com/help/idea/installing-updating-and-uninstalling-repository-plugins.html) (шукайте "Scala" в меню плагінів.) + +Коли ми створимо проект, ми встановимо останню версію Scala. +Примітка: якщо ви хочете відкрити існуючий проект Scala, ви можете натиснути **Open** під час запуску IntelliJ. + +## Створення проєкту +1. Запустіть IntelliJ та натисніть **File** => **New** => **Project** +1. На панелі зліва оберіть Scala, а на панелі справа - IDEA. +1. Назвіть проєкт **HelloWorld** +1. Припускаємо, що ви вперше створюєте проект Scala за допомогою IntelliJ, + вам потрібно буде встановити Scala SDK. В полі праворуч від Scala SDK натисніть **Create**. +1. Оберіть останню версію (наприклад, {{ site.scala-version }}) та натисніть **Download**. Це може зайняти декілька хвилин, але наступні проєкти зможуть використати той же SDK. +1. Після того як створена SDK та ви повернулись до вікна "New Project", натисніть **Finish**. + + +## Написання коду + +1. Зліва, на панелі **Project** клацніть кнопкою миші на `src` та оберіть **New** => **Scala class**. + Якщо ви не бачите **Scala class**, клацніть правою кнопкою миші на **HelloWorld** та оберіть **Add Framework Support...**, натисніть **Scala** та продовжіть. + Якщо ви бачите **Error: library is not specified**, ви можете або натиснути на кнопку завантаження або обрати шлях бібліотеки вручну. + Якщо ви бачите тільки **Scala Worksheet** спробуйте розкрити директорію `src` та піддиректорію `main` та клацніть правою кнопкою миші на теку `scala`. +1. Назвіть клас `Hello` та змініть його **Kind** на `object`. +1. Змініть код класу на наступний: + +``` +object Hello extends App { + println("Hello, World!") +} +``` + +## Запуск +* Клацніть правою кнопкою миші `Hello` та оберіть **Run 'Hello'**. +* Готово! + +## Експерименти зі Scala +Хорошим способом випробувати код є Scala Worksheets + +1. Зліва, на панелі проєкту, клацніть правою кнопкою миші на `src` та оберіть **New** => **Scala Worksheet**. +2. Назвіть робочий лист Scala "Mathematician". +3. Впишіть наступний код в робочий лист: + +``` +def square(x: Int) = x * x + +square(2) +``` + +Коли ви змінюєте свій код, ви побачите, як він виконується на панелі справа. +Якщо ви не бачите правої панелі, клацніть правою кнопкою миші на робочому аркуші Scala на панелі проєкту та натисніть Evaluate Worksheet. + + +## Наступні кроки + +Тепер ви знаєте, як створити простий проєкт Scala, який можна використовувати, +щоб почати вивчати мову. У наступному уроці ми познайомимося з важливим інструментом збірки під назвою sbt, +який можна використовувати як для простих проєктів, так і продакшн програм. + +Наступне: [Створення проєкту на Scala з IntelliJ і sbt](building-a-scala-project-with-intellij-and-sbt.html) diff --git a/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md new file mode 100644 index 0000000000..4e570f3987 --- /dev/null +++ b/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -0,0 +1,73 @@ +--- +title: Тестування Scala в IntelliJ зі ScalaTest +layout: singlepage-overview +partof: testing-scala-in-intellij-with-scalatest +language: uk +disqus: true +previous-page: /uk/building-a-scala-project-with-intellij-and-sbt +--- + +Існує кілька бібліотек і методологій тестування для Scala, +але в цьому туторіалі ми продемонструємо один популярний варіант для фреймворку ScalaTest, +що називається [FunSuite](https://www.scalatest.org/getting_started_with_fun_suite). + +Ми припускаємо, що ви знаєте [як створити проєкт з IntelliJ](building-a-scala-project-with-intellij-and-sbt.html). + +## Налаштування +1. Створіть sbt проєкт в IntelliJ. +1. Додайте залежність ScalaTest: + 1. Додайте залежність ScalaTest у файл `build.sbt` вашого проєкту: + ``` + libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.11" % Test + ``` + 1. Ви побачите сповіщення "build.sbt was changed", оберіть **auto-import**. + 1. Ці дві дії призведуть до того, що `sbt` завантажить бібліотеку ScalaTest. + 1. Зачекайте завершення синхронізації `sbt`; інакше `AnyFunSuite` та `test()` не будуть розпізнані. +1. На панелі проєкту розкрийте `src` => `main`. +1. Клацніть правою кнопкою миші на `scala` та оберіть **New** => **Scala class**. +1. Назвіть його `CubeCalculator` та змініть **Kind** на `object` та натисніть Enter або двічі клацніть на `object`. +1. Замініть код на наступний: + ``` + object CubeCalculator extends App { + def cube(x: Int) = { + x * x * x + } + } + ``` + +## Створення тесту +1. Зліва на панелі проєкту розкрийте `src` => `test`. +1. Клацніть правою кнопкою миші на `scala` та оберіть **New** => **Scala class**. +1. Назвіть клас `CubeCalculatorTest` та натисніть Enter або двічі клацніть на `class`. +1. Замініть код на наступний: + ``` + import org.scalatest.funsuite.AnyFunSuite + + class CubeCalculatorTest extends AnyFunSuite { + test("CubeCalculator.cube") { + assert(CubeCalculator.cube(3) === 27) + } + } + ``` +1. У початковому коді клацніть правою кнопкою миші на `CubeCalculatorTest` та оберіть **Run 'CubeCalculatorTest'**. + +## Розуміння коду + +Переглянемо кожний рядок окремо. + +* `class CubeCalculatorTest` означає, що ми тестуємо об'єкт `CubeCalculator` +* `extends AnyFunSuite` використовуємо функціональність класу AnyFunSuite з ScalaTest, насамперед функцію `test` +* `test` функція з AnyFunSuite, що збирає результати тверджень (assertions) у тілі функції. +* `"CubeCalculator.cube"` назва тесту. Ви можете обрати будь-яку назву, але існує домовленість називати "ClassName.methodName". +* `assert` приймає булеву умову і визначає, пройшов тест чи не пройшов. +* `CubeCalculator.cube(3) === 27` перевіряє чи дорівнює результат функції `cube` значенню 27. + Оператор `===` є частиною ScalaTest та надає чисті повідомлення про помилки. + +## Додати інший тест-кейс +1. Додайте інший тестовий блок з власним `assert`, що перевіряє значення кубу `0`. +1. Виконайте `sbt test` знову, двічі клацнувши правою кнопкою миші на `CubeCalculatorTest` та обравши 'Run **CubeCalculatorTest**'. + +## Висновок +Ви побачили один шлях тестування вашого Scala коду. Більше про +FunSuite ScalaTest на [офіційному вебсайті](https://www.scalatest.org/getting_started_with_fun_suite). +Ви можете проглянути інші фреймворки для тестування такі як [ScalaCheck](https://www.scalacheck.org/) та [Specs2](https://etorreborre.github.io/specs2/). diff --git a/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md b/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md new file mode 100644 index 0000000000..0689bceed6 --- /dev/null +++ b/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md @@ -0,0 +1,84 @@ +--- +title: Початок роботи зі Scala і sbt у командному рядку +layout: singlepage-overview +partof: getting-started-with-scala-and-sbt-on-the-command-line +language: uk +disqus: true +next-page: /uk/testing-scala-with-sbt-on-the-command-line +--- + +У цьому туторіалі ви дізнаєтесь, як створити проєкт Scala шаблон. +Ви можете використовувати це як відправну точку для власного проєкту. +Ми використаємо [sbt](https://www.scala-sbt.org/1.x/docs/index.html), що де-факто є основним інструментом збірки для Scala. +sbt компілює, запускає, та тестує ваші проєкти поміж інших корисних задач. +Ми припускаємо, що ви знаєте, як користуватися терміналом. + +## Встановлення +1. Впевніться, що ви вже встановили Java 8 JDK (також відому як 1.8) + * Запустіть `javac -version` у командному рядку і впевніться, що бачите + `javac 1.8.___` + * Якщо у вас не встановлена версія 1.8 або вище, [встановіть JDK](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) +1. Встановіть sbt + * [Mac](https://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Mac.html) + * [Windows](https://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Windows.html) + * [Linux](https://www.scala-sbt.org/1.x/docs/Installing-sbt-on-Linux.html) + +## Створити проєкт +1. Перейдіть (`cd`) у пусту директорію. +1. Виконайте наступну команду `sbt new scala/hello-world.g8`. +Це завантажує шаблон 'hello-world' з GitHub. +Також буде створена директорія `target`, яку можна ігнорувати. +1. Коли буде запропоновано, назвіть застосунок `hello-world`. Це створить проєкт з назвою "hello-world". +1. А тепер подивимось що було згенеровано: + +``` +- hello-world + - project (sbt uses this to install and manage plugins and dependencies) + - build.properties + - src + - main + - scala (All of your scala code goes here) + - Main.scala (Entry point of program) <-- this is all we need for now + - build.sbt (sbt's build definition file) +``` + +Після збірки вашого проєкту, sbt створить більше `target` директорій для згенерованих файлів. + +## Запуск проєкту +1. Перейдіть (`cd`) у `hello-world`. +1. Виконайте `sbt`. Це запустить sbt консоль. +1. Наберіть `~run`. Символ `~` є опціональним та означає пере-збірку при кожному збереженні файлу, +що дає можливість пришвидшити цикл редагування/запуск/відлагодження. + +## Модифікація коду +1. Відкрийте файл `src/main/scala/Main.scala` у вашому текстовому редакторі. +1. Змініть "Hello, World!" на "Hello, New York!" +1. Якщо ви не зупинили роботу sbt, ви побачите як на консолі з'явиться "Hello, New York!". +1. Ви можете продовжити робити зміни та бачити результати на консолі. + +## Додання залежностей +Трохи змінивши фокус уваги, подивімось, як використовувати опубліковані бібліотеки, щоб додати додаткову функціональність до наших програм. + +1. Відкрийте `build.sbt` та додайте наступний рядок: + +``` +libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % "1.1.2" +``` + +Тут `libraryDependencies` є набором залежностей та використовуючи `+=`, +ми додаємо залежність [scala-parser-combinators](https://github.com/scala/scala-parser-combinators) до набору залежностей, +які необхідні для sbt та які завантажаться при його запуску. Тепер в будь-якому Scala файлі ви можете використати +класи, об'єкти, тощо з scala-parser-combinators через звичайний "import". + +Більше опублікованих бібліотек можна знайти на +[Scaladex](https://index.scala-lang.org/) - індекс бібліотек Scala, місце куди ви можете зайти, щоб скопіювати інформацію про бібліотеку +та додати у ваш `build.sbt` файл. + +## Наступні кроки + +Перейдіть до наступного туторіалу з серії _початок роботи з sbt_, та дізнайтесь про [тестування Scala з sbt та ScalaTest в командному рядку](testing-scala-with-sbt-on-the-command-line.html). + +**або** + +- Продовжить вивчати Scala інтерактивно нам [Вправи зі Scala](https://www.scala-exercises.org/scala_tutorial). +- Дізнайтеся про можливості Scala у коротких статтях, переглянувши наш [Тур по Scala]({{ site.baseurl }}/tour/tour-of-scala.html). diff --git a/_uk/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md b/_uk/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md new file mode 100644 index 0000000000..3d8b0c539c --- /dev/null +++ b/_uk/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md @@ -0,0 +1,104 @@ +--- +title: Тестування Scala з sbt та ScalaTest в командному рядку +layout: singlepage-overview +partof: testing-scala-with-sbt-on-the-command-line +language: uk +disqus: true +previous-page: /uk/getting-started-with-scala-and-sbt-on-the-command-line +--- + +Існує кілька бібліотек і методологій тестування для Scala, +але в цьому туторіалі ми продемонструємо один популярний варіант для фреймворку ScalaTest, +що називається [AnyFunSuite](https://www.scalatest.org/scaladoc/3.2.2/org/scalatest/funsuite/AnyFunSuite.html). + +Ми припускаємо, що ви знаєте [як створити проєкт Scala за допомогою sbt](getting-started-with-scala-and-sbt-on-the-command-line.html). + +## Налаштування +1. Створіть десь новий каталог через командний рядок. +1. Перейдіть (`cd`) в директорію та запустіть `sbt new scala/scalatest-example.g8` +1. Назвіть проєкт `ScalaTestTutorial`. +1. Проєкт вже має ScalaTest як залежність у файлі `build.sbt`. +1. Перейдіть (`cd`) в директорію та запустіть `sbt test`. Це запустить тестове середовище `CubeCalculatorTest` з єдиним тестом `CubeCalculator.cube`. + +``` +sbt test +[info] Loading global plugins from /Users/username/.sbt/0.13/plugins +[info] Loading project definition from /Users/username/workspace/sandbox/my-something-project/project +[info] Set current project to scalatest-example (in build file:/Users/username/workspace/sandbox/my-something-project/) +[info] CubeCalculatorTest: +[info] - CubeCalculator.cube +[info] Run completed in 267 milliseconds. +[info] Total number of tests run: 1 +[info] Suites: completed 1, aborted 0 +[info] Tests: succeeded 1, failed 0, canceled 0, ignored 0, pending 0 +[info] All tests passed. +[success] Total time: 1 s, completed Feb 2, 2017 7:37:31 PM +``` + +## Розуміння тестів +1. Відкрийте два файли в текстовому редакторі: + * `src/main/scala/CubeCalculator.scala` + * `src/test/scala/CubeCalculatorTest.scala` +1. У файлі `CubeCalculator.scala`, визначте функцію `cube`. +1. У файлі `CubeCalculatorTest.scala`, ви побачите, що клас, що названий так само як і об'єкт, що ми тестуємо. + +``` + import org.scalatest.funsuite.AnyFunSuite + + class CubeCalculatorTest extends AnyFunSuite { + test("CubeCalculator.cube") { + assert(CubeCalculator.cube(3) === 27) + } + } +``` + +Переглянемо кожний рядок окремо. + +* `class CubeCalculatorTest` означає, що ми тестуємо об'єкт `CubeCalculator` +* `extends AnyFunSuite` використовуємо функціональність класу AnyFunSuite з ScalaTest, насамперед функцію `test` +* `test` функція з AnyFunSuite, що збирає результати тверджень (assertions) у тілі функції. +* `"CubeCalculator.cube"` назва тесту. Ви можете обрати будь-яку назву, але існує домовленість називати "ClassName.methodName". +* `assert` приймає булеву умову і визначає, пройшов тест чи не пройшов. +* `CubeCalculator.cube(3) === 27` перевіряє чи дорівнює результат функції `cube` значенню 27. + Оператор `===` є частиною ScalaTest та надає чисті повідомлення про помилки. + +## Додати інший тест-кейс +1. Додайте інший тестовий блок з власним `assert`, що перевіряє значення кубу `0`. + + ``` + import org.scalatest.funsuite.AnyFunSuite + + class CubeCalculatorTest extends AnyFunSuite { + test("CubeCalculator.cube 3 should be 27") { + assert(CubeCalculator.cube(3) === 27) + } + + test("CubeCalculator.cube 0 should be 0") { + assert(CubeCalculator.cube(0) === 0) + } + } + ``` + +1. Виконайте `sbt test` знову, щоб побачити результати. + + ``` + sbt test + [info] Loading project definition from C:\projects\scalaPlayground\scalatestpractice\project + [info] Loading settings for project root from build.sbt ... + [info] Set current project to scalatest-example (in build file:/C:/projects/scalaPlayground/scalatestpractice/) + [info] Compiling 1 Scala source to C:\projects\scalaPlayground\scalatestpractice\target\scala-2.13\test-classes ... + [info] CubeCalculatorTest: + [info] - CubeCalculator.cube 3 should be 27 + [info] - CubeCalculator.cube 0 should be 0 + [info] Run completed in 257 milliseconds. + [info] Total number of tests run: 2 + [info] Suites: completed 1, aborted 0 + [info] Tests: succeeded 2, failed 0, canceled 0, ignored 0, pending 0 + [info] All tests passed. + [success] Total time: 3 s, completed Dec 4, 2019 10:34:04 PM + ``` + +## Висновок +Ви побачили один шлях тестування вашого Scala коду. Більше про +FunSuite ScalaTest на [офіційному вебсайті](https://www.scalatest.org/getting_started_with_fun_suite). +Ви можете проглянути інші фреймворки для тестування такі як [ScalaCheck](https://www.scalacheck.org/) та [Specs2](https://etorreborre.github.io/specs2/). diff --git a/_uk/index.md b/_uk/index.md index 211050d3f1..32d183c077 100644 --- a/_uk/index.md +++ b/_uk/index.md @@ -20,7 +20,7 @@ scala3-sections: - title: "Початок роботи" description: "Встанови Scala 3 на свій комп'ютер і почни писати код Scala!" icon: "fa fa-rocket" - link: /scala3/getting-started.html + link: /uk/scala3/getting-started.html - title: "Книга по Scala 3" description: "Вивчи Scala, прочитавши серію коротких уроків." icon: "fa fa-book-open" @@ -66,7 +66,7 @@ scala2-sections: - title: "Початок роботи" description: "Встанови Scala на свій комп'ютер і почни писати код Scala!" icon: "fa fa-rocket" - link: /getting-started.html + link: /uk/getting-started/index.html - title: "Екскурсія по Скала" description: "Короткі введення в основні особливості мови." icon: "fa fa-flag" diff --git a/_uk/scala3/getting-started.md b/_uk/scala3/getting-started.md new file mode 100644 index 0000000000..4c2acc6bf7 --- /dev/null +++ b/_uk/scala3/getting-started.md @@ -0,0 +1,8 @@ +--- +layout: singlepage-overview +title: Перші кроки з Scala 3 +scala3: true +language: uk +--- + +{% include _uk/getting-started.md %} diff --git a/scala3/getting-started.md b/scala3/getting-started.md index b82ed44938..67e36bd2d7 100644 --- a/scala3/getting-started.md +++ b/scala3/getting-started.md @@ -1,7 +1,7 @@ --- layout: singlepage-overview title: Getting Started -languages: ["ja"] +languages: ["ja", "uk"] --- {% include getting-started.md %} From 9c7eaed4fa3718a0f411eade4a31dec5a17265df Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Thu, 16 Jun 2022 23:09:47 +0300 Subject: [PATCH 1930/3075] Add @mazhara's suggestions --- _includes/_uk/getting-started.md | 21 +++++++++---------- ...g-a-scala-project-with-intellij-and-sbt.md | 12 +++++------ .../getting-started-with-scala-in-intellij.md | 4 ++-- ...esting-scala-in-intellij-with-scalatest.md | 2 +- ...-with-scala-and-sbt-on-the-command-line.md | 2 +- 5 files changed, 20 insertions(+), 21 deletions(-) diff --git a/_includes/_uk/getting-started.md b/_includes/_uk/getting-started.md index 7146ff7300..2b80e59070 100644 --- a/_includes/_uk/getting-started.md +++ b/_includes/_uk/getting-started.md @@ -3,7 +3,7 @@ ## Спробуйте Scala без інсталяції Щоб швидко почати експериментувати зі Scala, відкрийте “Scastie” у вашому браузері. -_Scastie_ це онлайн “пісочниця” де ви можете експериментувати з прикладами на Scala та подивитись як все працює, з доступом до всіх компіляторів Scala та доступних бібліотек. +_Scastie_ це онлайн “пісочниця”, де ви можете експериментувати з прикладами на Scala та подивитись як все працює, з доступом до всіх компіляторів Scala та доступних бібліотек. > Scastie підтримує як Scala 2 так, і Scala 3, але за замовчування > використовується Scala 3. Якщо ж ви шукаєте приклади на Scala 2, @@ -12,7 +12,7 @@ _Scastie_ це онлайн “пісочниця” де ви можете ек ## Встановіть Scala на ваш комп'ютер Інсталяція Scala означає встановлення різних command-line інструментів, таких як компілятор Scala та інструменти для збірки. -Ми радимо використовувати інсталятор "Coursier" який автоматично встановить всі необхідні залежності, але ви можете встановити окремо кожен інструмент. +Ми радимо використовувати інсталятор "Coursier", який автоматично встановить всі необхідні залежності, але ви можете встановити окремо кожен інструмент. ### За допомогою інсталятора Scala (рекомендовано) @@ -67,7 +67,7 @@ _Scastie_ це онлайн “пісочниця” де ви можете ек $ scala -version Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL ``` -Якщо це не спрацювало, необхідно завершити сеанс та зайти в систему знову (або перезавантажити) щоб зміни застосувались на вашій системі. +Якщо це не спрацювало, необхідно завершити сеанс та зайти в систему знову (або перезавантажити), щоб зміни застосувались на вашій системі. {% endaltDetails %} @@ -105,15 +105,14 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ Вам необхідно лише два інструменти, для того, щоб скомпілювати, запустити, протестувати й упакувати Scala проєкт: Java 8 або 11, і sbt. Щоб встановити їх вручну: -1. якщо Java 8 або 11 не встановлені, необхідно завантажити +1. Якщо Java 8 або 11 не встановлені, необхідно завантажити Java з [Oracle Java 8](https://www.oracle.com/java/technologies/javase-jdk8-downloads.html), [Oracle Java 11](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html), або [AdoptOpenJDK 8/11](https://adoptopenjdk.net/). Перевірте [сумісність JDK](/overviews/jdk-compatibility/overview.html) для Scala/Java. 1. Встановіть [sbt](https://www.scala-sbt.org/download.html) ## Створити проєкт "Hello World" з sbt -Коли ви вже встановили sbt, ви готові, щоб створити проект на Scala, який -ми розглянемо у подальших розділах. +Після встановлення sbt ви готові до створення проєкту на Scala, який ми розглянемо в подальших розділах. Щоб створити проєкт, ви можете використати або термінал, або IDE. Якщо ви знайомі з командним рядком, ми рекомендуємо такий підхід. @@ -121,7 +120,7 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ ### За допомогою командного рядка Інструмент sbt призначений для збірки проєкту на Scala. sbt компілює, запускає, -та тестує ваш код на Scala. (Також, він публікує бібліотеки та виконує багато інших задач.) +та тестує ваш код на Scala. (Також він публікує бібліотеки та виконує багато інших задач.) Щоб створити новий Scala проєкт за допомогою sbt: @@ -153,7 +152,7 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ ## Відкрити проєкт hello-world -Використаймо IDE, щоб відкрити. Найбільш популярними є IntelliJ та VSCode. +Використаймо IDE, щоб відкрити проєкт. Найбільш популярними є IntelliJ та VSCode. Обидва з них мають багатий функціонал, але ви також можете використати [багато інших редакторів.](https://scalameta.org/metals/docs/editors/overview.html) ### За допомогою IntelliJ @@ -166,7 +165,7 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ 1. Завантажте [VSCode](https://code.visualstudio.com/Download) 1. Встановіть розширення Metals з [the Marketplace](https://marketplace.visualstudio.com/items?itemName=scalameta.metals) -1. Наступне, відкрийте директорію, що містить файл `build.sbt` (це має бути директорія `hello-world` якщо ви виконали попередні інструкції). Коли буде запропоновано, оберіть *Імпортувати збірку* (*Import build*). +1. Відкрийте директорію, що містить файл `build.sbt` (це має бути директорія `hello-world` якщо ви виконали попередні інструкції). Коли буде запропоновано, оберіть *Імпортувати збірку* (*Import build*). >[Metals](https://scalameta.org/metals) це “Сервер мови Scala” який забезпечує можливість написання коду на Scala в VS Code та інших редакторах на кшталт [Atom, Sublime Text, and more](https://scalameta.org/metals/docs/editors/overview.html), використовуючи Language Server Protocol. > @@ -191,7 +190,7 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ 1. `cd` в `hello-world`. 1. Запустіть `sbt`. Це відкриє консоль sbt. 1. Наберіть `~run`. Символ `~` опціональний і змушує sbt повторно запускатися після кожного збереження файлу, - що забезпечує швидкий цикл редагування/запуск/налагодження. sbt також створить директорію `target`б яку ви можете проігнорувати. + що забезпечує швидкий цикл редагування/запуск/налагодження. sbt також створить директорію `target`, яку ви можете проігнорувати. Коли ви закінчите експериментувати з вашим проєктом, натисніть `[Enter]` щоб перервати команду `run`. Потім наберіть `exit` або затисніть `[Ctrl+D]` щоб вийти з sbt та повернутись до вашого командного рядка. @@ -200,7 +199,7 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ Після того, як ви закінчите наведені вище посібники, спробуйте пройти: -* [Книга по Scala](/scala3/book/introduction.html) (версія по Scala 2 [тут](/overviews/scala-book/introduction.html)), яка містить набір коротких ознайомчих уроків по основних можливостях Scala. +* [Книга по Scala](/scala3/book/introduction.html) (версія по Scala 2 [тут](/overviews/scala-book/introduction.html)), яка містить коротких ознайомчих уроків з основних можливостей Scala. * [Тур по Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. * [Навчальні ресурси](/learn.html), що містять інтерактивні онлайн путівники та курси. * [Наш список деяких популярних книжок по Scala](/books.html). diff --git a/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md b/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md index 135a9d8676..be6606e90e 100644 --- a/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md +++ b/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md @@ -18,7 +18,7 @@ sbt — популярний інструмент для компіляції, комфортніше працювати у терміналі, ми рекомендуємо подивитись [початок роботи зі Scala і sbt у командному рядку](/uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) і потім повернутися сюди до розділу «Написання коду на Scala». -1. Якщо ви ще не створили проєкт у терміналі запустіть IntelliJ та оберіть "Створити новий проєкт (Create New Project)" +1. Якщо ви ще не створили проєкт у терміналі, запустіть IntelliJ та оберіть "Створити новий проєкт (Create New Project)" * На панелі зліва оберіть Scala, а на панелі справа оберіть sbt * Натисніть **Next** * Назвіть ваш проєкт "SbtExampleProject" @@ -28,7 +28,7 @@ sbt — популярний інструмент для компіляції, 1. Натисніть **Finish** ## Розуміння структури директорій -Завдяки sbt створюються директорії, які можуть бути корисні у разі якщо ви почнете робити складніші проєкти. +Завдяки sbt створюються директорії, які можуть бути корисні у разі розробки складніших проєктів. Поки що ви можете проігнорувати більшість із них, але ось для чого це все: ``` @@ -51,7 +51,7 @@ sbt — популярний інструмент для компіляції, 1. Назвіть пакет `example` та натисніть **OK** (або просто натисніть клавішу Enter або Return). 1. Натисніть праву кнопку миші на пакет `example` та оберіть **New** => **Scala class** (якщо ви не бачите цю опцію, натисніть праву кнопку миші на `SbtExampleProject`, натисніть **Add Frameworks Support**, оберіть **Scala** та продовжить) 1. Назвіть клас `Main` та змініть **Kind** на `Object`. -1. Змініть код у класі на такий: +1. Змініть код у класі на наступний: ``` object Main extends App { @@ -73,7 +73,7 @@ object Main extends App { 1. В коді змініть `75` на `61` та подивіться оновлений результат в консолі. ## Додавання залежностей -Трохи змінивши фокус уваги, подивімось, як використовувати опубліковані бібліотеки, щоб додати додаткову функціональність до наших програм. +Давайте ненадовго змістимо фокус на використання опублікованих бібліотек для забезпечення додаткової функціональності ваших програм. 1. Відкрийте `build.sbt` та додайте наступний рядок: ``` @@ -91,11 +91,11 @@ libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % ## Наступні кроки -Перейдіть до наступного туторіалу з серії _початок роботи з IntelliJ_, та дізнайтесь про [тестування Scala в IntelliJ зі ScalaTest](testing-scala-in-intellij-with-scalatest.html). +Перейдіть до наступного навчального матеріалу з серії _початок роботи з IntelliJ_, та дізнайтесь про [тестування Scala в IntelliJ зі ScalaTest](testing-scala-in-intellij-with-scalatest.html). **або** -* [Книга по Scala](/overviews/scala-book/introduction.html), що є набором коротких вступних уроків по основних особливостях Scala. +* [Книга по Scala](/overviews/scala-book/introduction.html), що є набором коротких вступних уроків з основних особливостей. * [Тур по Scala](/tour/tour-of-scala.html) серія коротких оглядових статей про можливості Scala. * Продовжить вчити Scala інтерактивно виконуючи [вправи зі Scala](https://www.scala-exercises.org/scala_tutorial). diff --git a/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md b/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md index 9bd525c1b3..6b819667aa 100644 --- a/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md +++ b/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md @@ -19,8 +19,8 @@ next-page: /uk/building-a-scala-project-with-intellij-and-sbt 1. Після того, як ви запустили IntelliJ, ви можете завантажити й встановити плагін Scala за інструкцією [як встановлювати плагіни IntelliJ](https://www.jetbrains.com/help/idea/installing-updating-and-uninstalling-repository-plugins.html) (шукайте "Scala" в меню плагінів.) -Коли ми створимо проект, ми встановимо останню версію Scala. -Примітка: якщо ви хочете відкрити існуючий проект Scala, ви можете натиснути **Open** під час запуску IntelliJ. +Під час створення проєкту встановиться остання версія Scala. +Примітка: якщо ви хочете відкрити наявний проєкт Scala, ви можете натиснути **Open** під час запуску IntelliJ. ## Створення проєкту 1. Запустіть IntelliJ та натисніть **File** => **New** => **Project** diff --git a/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index 4e570f3987..819fd9db65 100644 --- a/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -22,7 +22,7 @@ previous-page: /uk/building-a-scala-project-with-intellij-and-sbt ``` 1. Ви побачите сповіщення "build.sbt was changed", оберіть **auto-import**. 1. Ці дві дії призведуть до того, що `sbt` завантажить бібліотеку ScalaTest. - 1. Зачекайте завершення синхронізації `sbt`; інакше `AnyFunSuite` та `test()` не будуть розпізнані. + 1. Зачекайте завершення синхронізації `sbt`; інакше `AnyFunSuite` та `test()` не розпізнаються. 1. На панелі проєкту розкрийте `src` => `main`. 1. Клацніть правою кнопкою миші на `scala` та оберіть **New** => **Scala class**. 1. Назвіть його `CubeCalculator` та змініть **Kind** на `object` та натисніть Enter або двічі клацніть на `object`. diff --git a/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md b/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md index 0689bceed6..82a4ac6ae3 100644 --- a/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md +++ b/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md @@ -57,7 +57,7 @@ sbt компілює, запускає, та тестує ваші проєкт 1. Ви можете продовжити робити зміни та бачити результати на консолі. ## Додання залежностей -Трохи змінивши фокус уваги, подивімось, як використовувати опубліковані бібліотеки, щоб додати додаткову функціональність до наших програм. +Давайте ненадовго змістимо фокус на використання опублікованих бібліотек для забезпечення додаткової функціональності ваших програм. 1. Відкрийте `build.sbt` та додайте наступний рядок: From 49a691a875371f2fcaea117b9a826b612e7cda71 Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Thu, 16 Jun 2022 23:57:04 +0300 Subject: [PATCH 1931/3075] Add @dmytro-altsyvanovych-depop's suggestions --- _includes/_uk/getting-started.md | 8 ++++---- ...ding-a-scala-project-with-intellij-and-sbt.md | 14 +++++++------- .../getting-started-with-scala-in-intellij.md | 14 +++++++------- .../testing-scala-in-intellij-with-scalatest.md | 6 +++--- ...ted-with-scala-and-sbt-on-the-command-line.md | 16 ++++++++-------- ...testing-scala-with-sbt-on-the-command-line.md | 6 +++--- 6 files changed, 32 insertions(+), 32 deletions(-) diff --git a/_includes/_uk/getting-started.md b/_includes/_uk/getting-started.md index 2b80e59070..c4f1d6f546 100644 --- a/_includes/_uk/getting-started.md +++ b/_includes/_uk/getting-started.md @@ -27,7 +27,7 @@ _Scastie_ це онлайн “пісочниця”, де ви можете е {% tab macOS for=install-cs-setup-tabs %} Виконайте наступну команду в терміналі, виконуючи всі спливаючі інструкції: {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} -{% altDetails cs-setup-macos-nobrew "Якщо ви не використовуєте Homebrew:" %} +{% altDetails cs-setup-macos-nobrew "Якщо ви не використовуєте Homebrew:" %} {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} {% endaltDetails %} {% endtab %} @@ -90,7 +90,7 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ > `scala` відповідно). Незалежно від того, чи збираєтеся ви використовувати Scala 2 чи 3, > тому що більшість проєктів використовує інструменти для збірки, > які використовують правильні версії Scala незалежно від того, яка встановлена "глобально". -> Тим не менш, ви завжди можете запустити певну версію Scala за допомогою +> Однак, ви завжди можете запустити певну версію Scala за допомогою > ``` > $ cs launch scala:{{ site.scala-version }} > $ cs launch scalac:{{ site.scala-version }} @@ -124,8 +124,8 @@ Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/ Щоб створити новий Scala проєкт за допомогою sbt: -1. `cd` в пусту директорію. -1. Виконайте команду `sbt new scala/scala3.g8` щоб створити проєкт на Scala 3, або `sbt new scala/hello-world.g8` щоб створити проєкт на Scala 2. +1. Перейдіть (`cd`) в пусту директорію. +1. Виконайте команду `sbt new scala/scala3.g8`, щоб створити проєкт на Scala 3, або `sbt new scala/hello-world.g8`, щоб створити проєкт на Scala 2. Команда завантажує шаблон проєкту з GitHub. Також, створює директорію `target`, яку ви можете проігнорувати. 1. Коли буде запропоновано, оберіть назву програми `hello-world`. В результаті буде створено проєкт "hello-world". diff --git a/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md b/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md index be6606e90e..18da5a8ea5 100644 --- a/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md +++ b/_uk/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md @@ -8,15 +8,15 @@ previous-page: /uk/getting-started/intellij-track/getting-started-with-scala-in- next-page: /uk/testing-scala-in-intellij-with-scalatest --- -В цьому туторіалі ми побачимо як будувати Scala проєкти використовуючи [sbt](https://www.scala-sbt.org/1.x/docs/index.html). +В цьому посібнику ми побачимо як будувати Scala проєкти використовуючи [sbt](https://www.scala-sbt.org/1.x/docs/index.html). sbt — популярний інструмент для компіляції, запуску та тестування проєктів Scala будь-якої складності. Використання інструменту збірки, такого як sbt (або Maven/Gradle), стає необхідним, коли ви створюєте проєкти із залежностями або кількома файлами коду. -Ми припускаємо, що ви завершили [перший туторіал](./getting-started-with-scala-in-intellij.html). +Ми припускаємо, що ви завершили [перший посібник](./getting-started-with-scala-in-intellij.html). ## Створення проєкту У цьому розділі ми покажемо вам, як створити проєкт в IntelliJ. Однак, якщо вам комфортніше працювати у терміналі, ми рекомендуємо подивитись [початок роботи зі Scala і sbt у командному рядку](/uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) - і потім повернутися сюди до розділу «Написання коду на Scala». +і потім повернутися сюди до розділу «Написання коду на Scala». 1. Якщо ви ще не створили проєкт у терміналі, запустіть IntelliJ та оберіть "Створити новий проєкт (Create New Project)" * На панелі зліва оберіть Scala, а на панелі справа оберіть sbt @@ -60,14 +60,14 @@ object Main extends App { } ``` -Примітка: IntelliJ має власну реалізацію компілятора Scala, тому іноді ваш код є правильним, навіть якщо IntelliJ вказує інше. +Примітка: IntelliJ має власну реалізацію компілятора Scala, тому іноді ваш код є правильним, навіть якщо IntelliJ вказує інше. Ви завжди можете перевірити у командному рядку, чи може sbt запустити ваш проєкт. ## Запуск проєкту 1. З меню **Run** оберіть **Edit configurations** 1. Натисніть кнопку **+** та оберіть **sbt Task**. 1. Назвіть його `Run the program`. -1. В полі **Tasks** наберіть `~run`. Опція `~` змушує sbt пере-збирати та перезапускати проєкт, коли ви зберігаєте зміни у файлі проєкту. +1. В полі **Tasks** наберіть `~run`. Опція `~` змушує sbt перебудовувати та перезапускати проєкт, коли ви зберігаєте зміни у файлі проєкту. 1. Натисніть **OK**. 1. В меню **Run** натисніть **Run 'Run the program'**. 1. В коді змініть `75` на `61` та подивіться оновлений результат в консолі. @@ -83,7 +83,7 @@ libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % Тут `libraryDependencies` є набором залежностей та використовуючи `+=`, ми додаємо залежність [scala-parser-combinators](https://github.com/scala/scala-parser-combinators) до набору залежностей, які необхідні для sbt та які завантажаться при його запуску. Тепер в будь-якому Scala файлі ви можете використати -класи, об'єкти, тощо з scala-parser-combinators через звичайний "import". +класи, об'єкти тощо з scala-parser-combinators через звичайний "import". Більше опублікованих бібліотек можна знайти на [Scaladex](https://index.scala-lang.org/) - індекс бібліотек Scala, місце куди ви можете зайти, щоб скопіювати інформацію про бібліотеку @@ -98,4 +98,4 @@ libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % * [Книга по Scala](/overviews/scala-book/introduction.html), що є набором коротких вступних уроків з основних особливостей. * [Тур по Scala](/tour/tour-of-scala.html) серія коротких оглядових статей про можливості Scala. * Продовжить вчити Scala інтерактивно виконуючи - [вправи зі Scala](https://www.scala-exercises.org/scala_tutorial). + [вправи зі Scala](https://www.scala-exercises.org/scala_tutorial). \ No newline at end of file diff --git a/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md b/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md index 6b819667aa..2d44b3ef34 100644 --- a/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md +++ b/_uk/getting-started/intellij-track/getting-started-with-scala-in-intellij.md @@ -7,7 +7,7 @@ disqus: true next-page: /uk/building-a-scala-project-with-intellij-and-sbt --- -У цьому туторіалі буде розглянемо як створити мінімальний проєкт Scala за допомогою IntelliJ IDE з плагіном Scala. +У цьому посібнику буде розглянемо як створити мінімальний проєкт Scala за допомогою IntelliJ IDE з плагіном Scala. У цьому посібнику IntelliJ завантажить для вас Scala. ## Встановлення @@ -16,8 +16,8 @@ next-page: /uk/building-a-scala-project-with-intellij-and-sbt `javac 1.8.___` * Якщо у вас не встановлена версія 1.8 або вище, [встановіть JDK](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) 1. Далі, завантажте та встановіть [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/) -1. Після того, як ви запустили IntelliJ, ви можете завантажити й встановити плагін Scala за інструкцією -[як встановлювати плагіни IntelliJ](https://www.jetbrains.com/help/idea/installing-updating-and-uninstalling-repository-plugins.html) (шукайте "Scala" в меню плагінів.) +1. Після того, як ви запустили IntelliJ, ви можете завантажити й встановити плагін Scala за інструкцією + [як встановлювати плагіни IntelliJ](https://www.jetbrains.com/help/idea/installing-updating-and-uninstalling-repository-plugins.html) (шукайте "Scala" в меню плагінів.) Під час створення проєкту встановиться остання версія Scala. Примітка: якщо ви хочете відкрити наявний проєкт Scala, ви можете натиснути **Open** під час запуску IntelliJ. @@ -26,7 +26,7 @@ next-page: /uk/building-a-scala-project-with-intellij-and-sbt 1. Запустіть IntelliJ та натисніть **File** => **New** => **Project** 1. На панелі зліва оберіть Scala, а на панелі справа - IDEA. 1. Назвіть проєкт **HelloWorld** -1. Припускаємо, що ви вперше створюєте проект Scala за допомогою IntelliJ, +1. Припускаємо, що ви вперше створюєте проєкт Scala за допомогою IntelliJ, вам потрібно буде встановити Scala SDK. В полі праворуч від Scala SDK натисніть **Create**. 1. Оберіть останню версію (наприклад, {{ site.scala-version }}) та натисніть **Download**. Це може зайняти декілька хвилин, але наступні проєкти зможуть використати той же SDK. 1. Після того як створена SDK та ви повернулись до вікна "New Project", натисніть **Finish**. @@ -35,8 +35,8 @@ next-page: /uk/building-a-scala-project-with-intellij-and-sbt ## Написання коду 1. Зліва, на панелі **Project** клацніть кнопкою миші на `src` та оберіть **New** => **Scala class**. - Якщо ви не бачите **Scala class**, клацніть правою кнопкою миші на **HelloWorld** та оберіть **Add Framework Support...**, натисніть **Scala** та продовжіть. - Якщо ви бачите **Error: library is not specified**, ви можете або натиснути на кнопку завантаження або обрати шлях бібліотеки вручну. + Якщо ви не бачите **Scala class**, клацніть правою кнопкою миші на **HelloWorld** та оберіть **Add Framework Support...**, натисніть **Scala** та продовжить. + Якщо ви бачите **Error: library is not specified**, ви можете або натиснути на кнопку завантаження або обрати шлях бібліотеки вручну. Якщо ви бачите тільки **Scala Worksheet** спробуйте розкрити директорію `src` та піддиректорію `main` та клацніть правою кнопкою миші на теку `scala`. 1. Назвіть клас `Hello` та змініть його **Kind** на `object`. 1. Змініть код класу на наступний: @@ -71,7 +71,7 @@ square(2) ## Наступні кроки Тепер ви знаєте, як створити простий проєкт Scala, який можна використовувати, -щоб почати вивчати мову. У наступному уроці ми познайомимося з важливим інструментом збірки під назвою sbt, +щоб почати вивчати мову. У наступному уроці ми познайомимося з важливим інструментом збірки під назвою sbt, який можна використовувати як для простих проєктів, так і продакшн програм. Наступне: [Створення проєкту на Scala з IntelliJ і sbt](building-a-scala-project-with-intellij-and-sbt.html) diff --git a/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index 819fd9db65..87c8c09bdd 100644 --- a/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -8,7 +8,7 @@ previous-page: /uk/building-a-scala-project-with-intellij-and-sbt --- Існує кілька бібліотек і методологій тестування для Scala, -але в цьому туторіалі ми продемонструємо один популярний варіант для фреймворку ScalaTest, +але в цьому посібнику ми продемонструємо один популярний варіант для фреймворку ScalaTest, що називається [FunSuite](https://www.scalatest.org/getting_started_with_fun_suite). Ми припускаємо, що ви знаєте [як створити проєкт з IntelliJ](building-a-scala-project-with-intellij-and-sbt.html). @@ -64,10 +64,10 @@ previous-page: /uk/building-a-scala-project-with-intellij-and-sbt Оператор `===` є частиною ScalaTest та надає чисті повідомлення про помилки. ## Додати інший тест-кейс -1. Додайте інший тестовий блок з власним `assert`, що перевіряє значення кубу `0`. +1. Додайте інший тестовий блок з власним `assert`, що перевіряє значення куба `0`. 1. Виконайте `sbt test` знову, двічі клацнувши правою кнопкою миші на `CubeCalculatorTest` та обравши 'Run **CubeCalculatorTest**'. ## Висновок Ви побачили один шлях тестування вашого Scala коду. Більше про -FunSuite ScalaTest на [офіційному вебсайті](https://www.scalatest.org/getting_started_with_fun_suite). +FunSuite ScalaTest на [офіційному вебсайті](https://www.scalatest.org/getting_started_with_fun_suite). Ви можете проглянути інші фреймворки для тестування такі як [ScalaCheck](https://www.scalacheck.org/) та [Specs2](https://etorreborre.github.io/specs2/). diff --git a/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md b/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md index 82a4ac6ae3..58adf6baf9 100644 --- a/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md +++ b/_uk/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.md @@ -7,8 +7,8 @@ disqus: true next-page: /uk/testing-scala-with-sbt-on-the-command-line --- -У цьому туторіалі ви дізнаєтесь, як створити проєкт Scala шаблон. -Ви можете використовувати це як відправну точку для власного проєкту. +У цьому посібнику ви дізнаєтесь, як створити проєкт Scala шаблон. +Ви можете використовувати це як відправну точку для власного проєкту. Ми використаємо [sbt](https://www.scala-sbt.org/1.x/docs/index.html), що де-факто є основним інструментом збірки для Scala. sbt компілює, запускає, та тестує ваші проєкти поміж інших корисних задач. Ми припускаємо, що ви знаєте, як користуватися терміналом. @@ -47,8 +47,8 @@ sbt компілює, запускає, та тестує ваші проєкт ## Запуск проєкту 1. Перейдіть (`cd`) у `hello-world`. 1. Виконайте `sbt`. Це запустить sbt консоль. -1. Наберіть `~run`. Символ `~` є опціональним та означає пере-збірку при кожному збереженні файлу, -що дає можливість пришвидшити цикл редагування/запуск/відлагодження. +1. Наберіть `~run`. Символ `~` є опціональним та означає перебудову при кожному збереженні файлу, + що дає можливість пришвидшити цикл редагування/запуск/відлагодження. ## Модифікація коду 1. Відкрийте файл `src/main/scala/Main.scala` у вашому текстовому редакторі. @@ -68,15 +68,15 @@ libraryDependencies += "org.scala-lang.modules" %% "scala-parser-combinators" % Тут `libraryDependencies` є набором залежностей та використовуючи `+=`, ми додаємо залежність [scala-parser-combinators](https://github.com/scala/scala-parser-combinators) до набору залежностей, які необхідні для sbt та які завантажаться при його запуску. Тепер в будь-якому Scala файлі ви можете використати -класи, об'єкти, тощо з scala-parser-combinators через звичайний "import". +класи, об'єкти тощо з scala-parser-combinators через звичайний "import". -Більше опублікованих бібліотек можна знайти на -[Scaladex](https://index.scala-lang.org/) - індекс бібліотек Scala, місце куди ви можете зайти, щоб скопіювати інформацію про бібліотеку +Більше опублікованих бібліотек можна знайти на +[Scaladex](https://index.scala-lang.org/) - індекс бібліотек Scala, місце куди ви можете зайти, щоб скопіювати інформацію про бібліотеку та додати у ваш `build.sbt` файл. ## Наступні кроки -Перейдіть до наступного туторіалу з серії _початок роботи з sbt_, та дізнайтесь про [тестування Scala з sbt та ScalaTest в командному рядку](testing-scala-with-sbt-on-the-command-line.html). +Перейдіть до наступного посібника з серії _початок роботи з sbt_, та дізнайтесь про [тестування Scala з sbt та ScalaTest в командному рядку](testing-scala-with-sbt-on-the-command-line.html). **або** diff --git a/_uk/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md b/_uk/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md index 3d8b0c539c..fc0a6e62ac 100644 --- a/_uk/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md +++ b/_uk/getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md @@ -8,7 +8,7 @@ previous-page: /uk/getting-started-with-scala-and-sbt-on-the-command-line --- Існує кілька бібліотек і методологій тестування для Scala, -але в цьому туторіалі ми продемонструємо один популярний варіант для фреймворку ScalaTest, +але в цьому посібнику ми продемонструємо один популярний варіант для фреймворку ScalaTest, що називається [AnyFunSuite](https://www.scalatest.org/scaladoc/3.2.2/org/scalatest/funsuite/AnyFunSuite.html). Ми припускаємо, що ви знаєте [як створити проєкт Scala за допомогою sbt](getting-started-with-scala-and-sbt-on-the-command-line.html). @@ -63,7 +63,7 @@ sbt test Оператор `===` є частиною ScalaTest та надає чисті повідомлення про помилки. ## Додати інший тест-кейс -1. Додайте інший тестовий блок з власним `assert`, що перевіряє значення кубу `0`. +1. Додайте інший тестовий блок з власним `assert`, що перевіряє значення куба '0'. ``` import org.scalatest.funsuite.AnyFunSuite @@ -100,5 +100,5 @@ sbt test ## Висновок Ви побачили один шлях тестування вашого Scala коду. Більше про -FunSuite ScalaTest на [офіційному вебсайті](https://www.scalatest.org/getting_started_with_fun_suite). +FunSuite ScalaTest на [офіційному вебсайті](https://www.scalatest.org/getting_started_with_fun_suite). Ви можете проглянути інші фреймворки для тестування такі як [ScalaCheck](https://www.scalacheck.org/) та [Specs2](https://etorreborre.github.io/specs2/). From 14c4cb4294d9d8c0ffb593752ce7245a716d2804 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Fri, 17 Jun 2022 00:20:49 +0000 Subject: [PATCH 1932/3075] Update SIPs state --- _sips/sips/sip-for-pattern-matching-with-named-fields.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/sip-for-pattern-matching-with-named-fields.md diff --git a/_sips/sips/sip-for-pattern-matching-with-named-fields.md b/_sips/sips/sip-for-pattern-matching-with-named-fields.md new file mode 100644 index 0000000000..d116fdfde0 --- /dev/null +++ b/_sips/sips/sip-for-pattern-matching-with-named-fields.md @@ -0,0 +1,7 @@ +--- +title: SIP for pattern matching with named fields +status: submitted +pull-request-number: 44 +stage: pre-sip + +--- From b2f5b31204c823be8806de1e87f0f2292d93436a Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Thu, 16 Jun 2022 00:13:25 +0300 Subject: [PATCH 1933/3075] Add Ukrainian overviews --- _data/overviews-uk.yml | 328 +++++++++++++++++++++++++++++++++++++++++ _overviews/index.md | 2 +- _uk/index.md | 2 +- _uk/overviews/index.md | 8 + 4 files changed, 338 insertions(+), 2 deletions(-) create mode 100644 _data/overviews-uk.yml create mode 100644 _uk/overviews/index.md diff --git a/_data/overviews-uk.yml b/_data/overviews-uk.yml new file mode 100644 index 0000000000..571202bc6d --- /dev/null +++ b/_data/overviews-uk.yml @@ -0,0 +1,328 @@ + +- category: Стандартна бібліотека + description: "Посібники та огляди стандартної бібліотеки Scala." + overviews: + - title: Scala колекції + by: Martin Odersky та Julien Richard-Foy + icon: sitemap + url: "collections-2.13/introduction.html" + description: "Бібліотека колекцій Scala." + subdocs: + - title: Вступ + url: "collections-2.13/introduction.html" + - title: Змінювані та незмінювані колекції + url: "collections-2.13/overview.html" + - title: Трейт Iterable + url: "collections-2.13/trait-iterable.html" + - title: Трейти послідовностей. Seq, IndexedSeq та LinearSeq + url: "collections-2.13/seqs.html" + - title: Реалізація незмінюваних колекцій + url: "collections-2.13/concrete-immutable-collection-classes.html" + - title: Реалізація змінюваних колекцій + url: "collections-2.13/concrete-mutable-collection-classes.html" + - title: Масиви + url: "collections-2.13/arrays.html" + - title: Строки + url: "collections-2.13/strings.html" + - title: Показники продуктивності + url: "collections-2.13/performance-characteristics.html" + - title: Рівність + url: "collections-2.13/equality.html" + - title: Відображення + url: "collections-2.13/views.html" + - title: Ітератори + url: "collections-2.13/iterators.html" + - title: Створення колекцій з нуля + url: "collections-2.13/creating-collections-from-scratch.html" + - title: Перетворення між колекціями Java та Scala + url: "collections-2.13/conversions-between-java-and-scala-collections.html" + - title: Міграція проєкту до колекцій Scala 2.13 + icon: sitemap + url: "core/collections-migration-213.html" + description: "Ця сторінка описує основні зміни для користувачів колекції, які переходять на Scala 2.13 і показує, як перехресно побудувати проєкти за допомогою Scala 2.11 / 2.12 і 2.13." + - title: Архітектура колекцій Scala + icon: sitemap + url: "core/architecture-of-scala-213-collections.html" + by: Julien Richard-Foy + description: "Ці сторінки описують архітектуру фреймворку колекцій, представленого в Scala 2.13. У порівнянні з Collections API ви дізнаєтеся більше про внутрішню роботу фреймворка." + - title: Реалізація користувацьких колекцій + icon: building + url: "core/custom-collections.html" + by: Martin Odersky, Lex Spoon та Julien Richard-Foy + description: "У цьому документі ви дізнаєтеся, як фреймворк колекцій допомагає вам визначати власні колекції за допомогою кількох рядків коду, повторно використовуючи переважну частину функцій колекції з фреймворку." + - title: Додавання спеціальних операцій до колекцій + icon: building + url: "core/custom-collection-operations.html" + by: Julien Richard-Foy + description: "У цьому посібнику показано, як писати операції, які можна застосувати до будь-якого типу колекції та повернути той самий тип колекції, а також як писати операції, які можна параметризувати за типом колекції для створення." + +- category: Мова + description: "Посібники та огляди, що охоплюють функції на мові Scala." + overviews: + - title: Інтерполяція строк + icon: dollar-sign + url: "core/string-interpolation.html" + description: > + Інтерполяція рядків дозволяє користувачам вбудовувати посилання на змінні безпосередньо в оброблені рядкові літерали. Ось приклад: + 
      val name = "James"
+          println(s"Hello, $name")  // Hello, James
      + Літерал s"Hello, $name" є рядковим літералом, що буде додатково оброблено. Це означає, що компілятор виконує додаткову роботу над цим літералом. Оброблений рядковий літерал позначається набором символів, що передують ". Інтерполяція рядка була введена в SIP-11 і яка містить усі деталі реалізації. + - title: Неявні класи + by: Josh Suereth + description: "Scala 2.10 представила нову функцію під назвою неявні класи. Неявний клас — це клас, позначений неявним ключовим словом. Це ключове слово робить основний конструктор класу доступним для неявних перетворень, коли клас знаходиться в області дії." + url: "core/implicit-classes.html" + - title: Класи значень та універсальні трейти + by: Mark Harrah + description: "Класи значень – це новий механізм у Scala, який дозволяє уникнути виділення об'єктів часу виконання. Це досягається за допомогою визначення нових підкласів AnyVal." + icon: gem + url: "core/value-classes.html" + +- category: Створення бібліотек + description: "Посібники щодо розробки бібліотек з відкритим кодом для екосистеми Scala." + overviews: + - title: Посібник для авторів бібліотек + by: Julien Richard-Foy + icon: tasks + url: "contributors/index.html" + description: "Перелічує всі інструменти, які автори бібліотек мають налаштувати для публікації та документування своїх бібліотек." + +- category: Паралельне та конкурентне програмування + description: "Повні посібники, що охоплюють деякі бібліотеки Scala для паралельного та конкурентного програмування." + overviews: + - title: Future та Promise + by: Philipp Haller, Aleksandar Prokopec, Heather Miller, Viktor Klang, Roland Kuhn та Vojin Jovanovic + icon: tasks + url: "core/futures.html" + description: "Ф'ючерси дають можливість міркувати про паралельне виконання багатьох операцій – ефективним і не блокувальним способом. Ф'ючерс — це об’єкт-заповнювач для значення, яке може ще не існувати. Як правило, вартість Ф'ючерсу надається одночасно і може згодом використовуватися. Складання одночасних завдань таким чином, як правило, призводить до швидшого, асинхронного, не блокувального паралельного коду." + - title: Паралельні колекції + by: Aleksandar Prokopec та Heather Miller + icon: rocket + url: "parallel-collections/overview.html" + description: "Бібліотека паралельних колекцій Scala." + subdocs: + - title: Огляд + url: "parallel-collections/overview.html" + - title: Реалізація паралельних колекцій + url: "parallel-collections/concrete-parallel-collections.html" + - title: Перетворення паралельних колекцій + url: "parallel-collections/conversions.html" + - title: Конкурентні Try + url: "parallel-collections/ctries.html" + - title: Архітектура бібліотеки паралельних колекцій + url: "parallel-collections/architecture.html" + - title: Створення користувацьких паралельних колекцій + url: "parallel-collections/custom-parallel-collections.html" + - title: Configuring Parallel Collections + url: "parallel-collections/configuration.html" + - title: Вимірювання продуктивності + url: "parallel-collections/performance.html" + +- category: Сумісність + description: "Що з чим працює (чи ні)." + overviews: + - title: Сумісність версій JDK + description: "Які версії Scala працюють на яких версіях JDK" + icon: coffee + url: "jdk-compatibility/overview.html" + - title: Бінарна сумісність релізів Scala + description: "Якщо дві версії Scala бінарно сумісні, можна безпечно скомпілювати свій проєкт на одній версії Scala та зв'язати з іншою версією Scala під час виконання. Безпечне зв'язування під час виконання (тільки!) означає, що JVM не генерує (підклас) LinkageError під час виконання вашої програми у змішаному сценарії, припускаючи, що вона не виникає при компіляції та запуску в одній версії Scala. Конкретно це означає, що ви можете мати зовнішні залежності від вашого шляху до класу під час виконання, які використовують іншу версію Scala, ніж та, з якою ви компілюєте, за умови, що вони сумісні з бінарними файлами. Іншими словами, окрема компіляція в різних версіях, сумісних з бінарними файлами, не створює проблем у порівнянні з компіляцією та запуском всього в одній версії Scala." + icon: puzzle-piece + url: "core/binary-compatibility-of-scala-releases.html" + - title: Бінарна сумісність для авторів бібліотек + description: "Різноманітний і повний набір бібліотек важливий для будь-якої продуктивної екосистеми програмного забезпечення. Хоча розробляти та розповсюджувати бібліотеки Scala легко, добре авторство бібліотеки виходить за рамки простого написання коду та його публікації. У цьому посібнику ми розглянемо важливу тему бінарної сумісності." + icon: puzzle-piece + url: "core/binary-compatibility-for-library-authors.html" + +- category: Інструменти + description: "Довідковий матеріал про основні інструменти Scala, такі як покоління Scala REPL і Scaladoc." + overviews: + - title: Scala REPL + icon: terminal + url: "repl/overview.html" + description: | + Scala REPL це інструмент (scala) для виконання виразів в Scala. +

      + Команда scala виконає скрипт шляхом обгортання його в шаблон, а потім компіляції та виконання отриманої програми + - title: Scaladoc + url: "scaladoc/overview.html" + icon: book + description: "Інструмент Scala для генерації документації для API." + subdocs: + - title: Огляд + url: "scaladoc/overview.html" + - title: Scaladoc для авторів бібліотек + url: "scaladoc/for-library-authors.html" + - title: Використання інтерфейсу Scaladoc + url: "scaladoc/interface.html" + +- category: Компілятор + description: "Посібники та огляди компілятора Scala: плагіни компілятора, інструменти відображення та метапрограмування, такі як макроси." + overviews: + - title: Відображення + by: Heather Miller, Eugene Burmako та Philipp Haller + icon: binoculars + url: "reflection/overview.html" + description: Фреймворк Scala для відображення під час виконання/компіляції. + label-text: experimental + subdocs: + - title: Огляд + url: "reflection/overview.html" + - title: Environment, Universe та Mirror + url: "reflection/environment-universes-mirrors.html" + - title: Symbol, Tree та Type + url: "reflection/symbols-trees-types.html" + - title: Annotation, Name, Scope та More + url: "reflection/annotations-names-scopes.html" + - title: TypeTag та Manifest + url: "reflection/typetags-manifests.html" + - title: Безпека потоків + url: "reflection/thread-safety.html" + - title: Зміни в Scala 2.11 + url: "reflection/changelog211.html" + - title: Макроси + by: Eugene Burmako + icon: magic + url: "macros/usecases.html" + description: "Фреймворк метапрограмування Scala." + label-text: experimental + subdocs: + - title: Випадки використання + url: "macros/usecases.html" + - title: Blackbox проти Whitebox + url: "macros/blackbox-whitebox.html" + - title: Макроси Def + url: "macros/overview.html" + - title: Quasiquotes + url: "quasiquotes/intro.html" + - title: Пакети макросів + url: "macros/bundles.html" + - title: Неявні макроси + url: "macros/implicits.html" + - title: Макроси-екстрактори + url: "macros/extractors.html" + - title: Провайдери типів + url: "macros/typeproviders.html" + - title: Анотації макросів + url: "macros/annotations.html" + - title: Макрос Paradise + url: "macros/paradise.html" + - title: Дорожня карта + url: "macros/roadmap.html" + - title: Зміни в 2.11 + url: "macros/changelog211.html" + - title: Quasiquotes + by: Denys Shabalin + icon: quote-left + url: "quasiquotes/setup.html" + description: "Quasiquotes — це зручний спосіб маніпулювати синтаксичними деревами Scala." + label-text: experimental + subdocs: + - title: Залежності та налаштування + url: "quasiquotes/setup.html" + - title: Вступ + url: "quasiquotes/intro.html" + - title: Підіймання + url: "quasiquotes/lifting.html" + - title: Опускання + url: "quasiquotes/unlifting.html" + - title: Гігієна + url: "quasiquotes/hygiene.html" + - title: Випадки використання + url: "quasiquotes/usecases.html" + - title: Резюме синтаксису + url: "quasiquotes/syntax-summary.html" + - title: Деталі виразів + url: "quasiquotes/expression-details.html" + - title: Деталі типів + url: "quasiquotes/type-details.html" + - title: Деталі патернів + url: "quasiquotes/pattern-details.html" + - title: Деталі визначення та імпорту + url: "quasiquotes/definition-details.html" + - title: Резюме термінології + url: "quasiquotes/terminology.html" + - title: Майбутні перспективи + url: "quasiquotes/future.html" + - title: Плагіни компілятора + by: Lex Spoon та Seth Tisue + icon: puzzle-piece + url: "plugins/index.html" + description: "Плагіни компілятора дозволяють налаштовувати та розширювати компілятор Scala. У цьому підручнику описується функція плагіну та пояснюється, як створити простий плагін." + - title: Параметри компілятора + by: Community + icon: cog + url: "compiler-options/index.html" + description: "Різні параметри того як scalac компілює ваш код." + - title: Форматування помилок + by: Torsten Schmits + icon: cog + url: "compiler-options/errors.html" + description: "Новий механізм для більш зручних повідомлень про помилки, друку ланцюжків залежних неявних параметрів та кольорових відмінностей знайдених/потрібних типів." + - title: Оптимізатор + by: Lukas Rytz та Andrew Marki + icon: cog + url: "compiler-options/optimizer.html" + description: "Компілятор може виконувати різні оптимізації." + +- category: Спадщина (legacy) + description: "Посібники, що охоплюють функції, які більше не стосуються останніх версій Scala (2.12+)." + overviews: + - title: Посібник для міграції фреймворку Scala Actors + by: Vojin Jovanovic та Philipp Haller + icon: truck + url: "core/actors-migration-guide.html" + description: "Щоб полегшити перехід від Scala Actors до Akka, ми надали набір Actor Migration Kit (AMK). AMK складається з розширення для Scala Actors, яке вмикається шляхом включення scala-actors-migration.jar до шляху до класу проєкт. Крім того, Akka 2.1 включає такі функції, як одинак ActorDSL, які дозволяють спростити перетворення коду за допомогою Scala Actors в Akka. Метою цього документа є керівництво користувачами через процес міграції та пояснення використання AMK." + - title: API фреймворку Scala Actors + by: Philipp Haller та Stephen Tu + icon: users + url: "core/actors.html" + description: "У цьому посібнику описано API пакету scala.actors Scala 2.8/2.9. Організація слідує за групами типів, які логічно належать один до одного. Для структурування окремих розділів враховується ієрархія ознак. Основна увага приділяється поведінці під час виконання різних методів, що визначаються цими ознаками, тим самим доповнюючи документацію API, що існує на основі Scaladoc." + label-color: "#899295" + label-text: deprecated + - title: Колекції Scala з 2.8 до 2.12 + by: Martin Odersky + icon: sitemap + url: "collections/introduction.html" + description: "Бібліотека колекцій Scala." + subdocs: + - title: Вступ + url: "collections/introduction.html" + - title: Змінювані та незмінювані колекції + url: "collections/overview.html" + - title: Трейт Traversable + url: "collections/trait-traversable.html" + - title: Трейт Iterable + url: "collections/trait-iterable.html" + - title: Трейти послідовностей. Seq, IndexedSeq та LinearSeq + url: "collections/seqs.html" + - title: Множини + url: "collections/sets.html" + - title: Асоціативні масиви + url: "collections/maps.html" + - title: Реалізація незмінюваних колекцій + url: "collections/concrete-immutable-collection-classes.html" + - title: Реалізація змінюваних колекцій + url: "collections/concrete-mutable-collection-classes.html" + - title: Масиви + url: "collections/arrays.html" + - title: Строки + url: "collections/strings.html" + - title: Показники продуктивності + url: "collections/performance-characteristics.html" + - title: Рівність + url: "collections/equality.html" + - title: Відображення + url: "collections/views.html" + - title: Ітератори + url: "collections/iterators.html" + - title: Створення колекцій з нуля + url: "collections/creating-collections-from-scratch.html" + - title: Перетворення між колекціями Java та Scala + url: "collections/conversions-between-java-and-scala-collections.html" + - title: Міграція з версії Scala 2.7 + url: "collections/migrating-from-scala-27.html" + - title: Архітектура колекцій Scala з 2.8 до 2.12 + icon: building + url: "core/architecture-of-scala-collections.html" + by: Martin Odersky та Lex Spoon + description: "На цих сторінках детально описується архітектура фреймворку колекцій Scala. У порівнянні з Collections API ви дізнаєтеся більше про внутрішню роботу фреймворку. Ви також дізнаєтеся, як ця архітектура допомагає вам визначати власні колекції за допомогою кількох рядків коду, повторно використовуючи переважну частину функцій колекції з фреймворку." diff --git a/_overviews/index.md b/_overviews/index.md index 32a2fcbb7f..8e4a815f06 100644 --- a/_overviews/index.md +++ b/_overviews/index.md @@ -2,7 +2,7 @@ layout: overviews partof: overviews title: Guides and Overviews -languages: [ja, zh-cn, ru] +languages: [ja, zh-cn, ru, uk] permalink: /overviews/:title.html --- diff --git a/_uk/index.md b/_uk/index.md index 211050d3f1..a1abe28d65 100644 --- a/_uk/index.md +++ b/_uk/index.md @@ -97,7 +97,7 @@ scala2-sections: - title: "Посібники та огляди" description: "Поглиблена документація, що покриває багато особливостей Scala." icon: "fa fa-database" - link: /overviews/index.html + link: /uk/overviews/index.html - title: "Довідник по стилю" description: "Поглиблений посібник з написання ідіоматичного коду на Scala." icon: "fa fa-bookmark" diff --git a/_uk/overviews/index.md b/_uk/overviews/index.md new file mode 100644 index 0000000000..355fc560fa --- /dev/null +++ b/_uk/overviews/index.md @@ -0,0 +1,8 @@ +--- +layout: overviews +partof: overviews +title: Документація +language: uk +--- + + From 74714f0e63162dd92ea5001c2c1b1a4abe9a8af5 Mon Sep 17 00:00:00 2001 From: Artem Korsakov Date: Sat, 18 Jun 2022 11:58:36 +0300 Subject: [PATCH 1934/3075] Update settings.md --- _overviews/scala3-scaladoc/settings.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index c7f7935ac3..e359624270 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -42,7 +42,7 @@ Currently we support two syntaxes: `markdown` or `wiki` If setting is not present, scaladoc defaults `markdown` ##### -revision -Revision (branch or ref) used to build project project. Useful with sourcelinks to prevent them from pointing always to the newest master that is subject to changes. +Revision (branch or ref) used to build project. Useful with sourcelinks to prevent them from pointing always to the newest main that is subject to changes. ##### -source-links Source links provide a mapping between file in documentation and code repository. @@ -66,7 +66,7 @@ where \ is one of following: \ is a format for `doc-source-url` parameter from old scaladoc. NOTE: We only supports `€{FILE_PATH_EXT}`, `€{TPL_NAME}`, `€{FILE_EXT}`, - €{FILE_PATH}, and €{FILE_LINE} patterns. + `€{FILE_PATH}`, and `€{FILE_LINE}` patterns. Template can defined only by subset of sources defined by path prefix represented by ``. From 2f4eed59670a5bc10710a50d758bc010994dfdee Mon Sep 17 00:00:00 2001 From: Artem Korsakov Date: Sat, 18 Jun 2022 12:02:52 +0300 Subject: [PATCH 1935/3075] Update settings.md --- _overviews/scala3-scaladoc/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index c7f7935ac3..042704bdf6 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -89,7 +89,7 @@ Links to social sites. For example: `-social-links:github::https://github.com/lampepfl/dotty,discord::https://discord.com/invite/scala,twitter::https://twitter.com/scala_lang` -Valid values are of the form: '\[github|twitter|gitter|discord]::link'. Scaladoc also supports 'custom::link::white_icon_name::black_icon_name'. In this case icons must be present in 'images/' directory. +Valid values are of the form: `\[github|twitter|gitter|discord]::link`. Scaladoc also supports `custom::link::white_icon_name::black_icon_name`. In this case icons must be present in `images/` directory. ##### -skip-by-id From dec20359004dbfe08c1e6f0d3239c3a6cbbca6ec Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Sat, 18 Jun 2022 13:53:32 +0300 Subject: [PATCH 1936/3075] Add @VladKopanev's suggestion --- _data/overviews-uk.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_data/overviews-uk.yml b/_data/overviews-uk.yml index 571202bc6d..7704b6a395 100644 --- a/_data/overviews-uk.yml +++ b/_data/overviews-uk.yml @@ -158,11 +158,11 @@ - category: Компілятор description: "Посібники та огляди компілятора Scala: плагіни компілятора, інструменти відображення та метапрограмування, такі як макроси." overviews: - - title: Відображення + - title: Віддзеркалення by: Heather Miller, Eugene Burmako та Philipp Haller icon: binoculars url: "reflection/overview.html" - description: Фреймворк Scala для відображення під час виконання/компіляції. + description: Фреймворк Scala для віддзеркалення під час виконання/компіляції. label-text: experimental subdocs: - title: Огляд From f2f04a963eb84a2b25c03ced664d41dfe6b43ece Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Sat, 18 Jun 2022 15:55:51 +0300 Subject: [PATCH 1937/3075] Add @Orhideous's suggestion --- _data/overviews-uk.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_data/overviews-uk.yml b/_data/overviews-uk.yml index 7704b6a395..686192749f 100644 --- a/_data/overviews-uk.yml +++ b/_data/overviews-uk.yml @@ -22,7 +22,7 @@ url: "collections-2.13/concrete-mutable-collection-classes.html" - title: Масиви url: "collections-2.13/arrays.html" - - title: Строки + - title: Рядки url: "collections-2.13/strings.html" - title: Показники продуктивності url: "collections-2.13/performance-characteristics.html" @@ -192,7 +192,7 @@ url: "macros/blackbox-whitebox.html" - title: Макроси Def url: "macros/overview.html" - - title: Quasiquotes + - title: Квазіцитати url: "quasiquotes/intro.html" - title: Пакети макросів url: "macros/bundles.html" @@ -305,7 +305,7 @@ url: "collections/concrete-mutable-collection-classes.html" - title: Масиви url: "collections/arrays.html" - - title: Строки + - title: Рядки url: "collections/strings.html" - title: Показники продуктивності url: "collections/performance-characteristics.html" From d651896b08c02a0227cd9a035c24d9d7d54118f4 Mon Sep 17 00:00:00 2001 From: Dmytro Kazanzhy Date: Sat, 18 Jun 2022 16:13:37 +0300 Subject: [PATCH 1938/3075] Add @CoolDalek's suggestions --- _data/overviews-uk.yml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/_data/overviews-uk.yml b/_data/overviews-uk.yml index 686192749f..f263aea9f5 100644 --- a/_data/overviews-uk.yml +++ b/_data/overviews-uk.yml @@ -39,7 +39,7 @@ - title: Міграція проєкту до колекцій Scala 2.13 icon: sitemap url: "core/collections-migration-213.html" - description: "Ця сторінка описує основні зміни для користувачів колекції, які переходять на Scala 2.13 і показує, як перехресно побудувати проєкти за допомогою Scala 2.11 / 2.12 і 2.13." + description: "Ця сторінка описує основні зміни в колекціях для користувачів, які переходять на Scala 2.13. Також, розглянуто варіанти побудови проєкти з перехресною сумісністю для Scala 2.11/2.12 і 2.13." - title: Архітектура колекцій Scala icon: sitemap url: "core/architecture-of-scala-213-collections.html" @@ -54,7 +54,7 @@ icon: building url: "core/custom-collection-operations.html" by: Julien Richard-Foy - description: "У цьому посібнику показано, як писати операції, які можна застосувати до будь-якого типу колекції та повернути той самий тип колекції, а також як писати операції, які можна параметризувати за типом колекції для створення." + description: "У цьому посібнику показано, як писати перетворення, що застосовуються до всіх типів колекцій і повертати той самий тип колекції. Також, як писати операції, які параметризуються типом колекції." - category: Мова description: "Посібники та огляди, що охоплюють функції на мові Scala." @@ -66,10 +66,10 @@ Інтерполяція рядків дозволяє користувачам вбудовувати посилання на змінні безпосередньо в оброблені рядкові літерали. Ось приклад: 
      val name = "James"
           println(s"Hello, $name")  // Hello, James
      - Літерал s"Hello, $name" є рядковим літералом, що буде додатково оброблено. Це означає, що компілятор виконує додаткову роботу над цим літералом. Оброблений рядковий літерал позначається набором символів, що передують ". Інтерполяція рядка була введена в SIP-11 і яка містить усі деталі реалізації. + Літерал s"Hello, $name" є рядковим літералом, який буде додатково оброблено. Це означає, що компілятор виконує додаткову роботу над цим літералом. Оброблений рядковий літерал позначається набором символів, що передують ". Інтерполяція рядків була введена в SIP-11. - title: Неявні класи by: Josh Suereth - description: "Scala 2.10 представила нову функцію під назвою неявні класи. Неявний клас — це клас, позначений неявним ключовим словом. Це ключове слово робить основний конструктор класу доступним для неявних перетворень, коли клас знаходиться в області дії." + description: "Scala 2.10 представила нову функцію під назвою неявні класи. Неявний клас — це клас, позначений ключовим словом implicit. Це ключове слово робить основний конструктор класу доступним для неявних перетворень, коли клас знаходиться в області видимості." url: "core/implicit-classes.html" - title: Класи значень та універсальні трейти by: Mark Harrah @@ -93,7 +93,7 @@ by: Philipp Haller, Aleksandar Prokopec, Heather Miller, Viktor Klang, Roland Kuhn та Vojin Jovanovic icon: tasks url: "core/futures.html" - description: "Ф'ючерси дають можливість міркувати про паралельне виконання багатьох операцій – ефективним і не блокувальним способом. Ф'ючерс — це об’єкт-заповнювач для значення, яке може ще не існувати. Як правило, вартість Ф'ючерсу надається одночасно і може згодом використовуватися. Складання одночасних завдань таким чином, як правило, призводить до швидшого, асинхронного, не блокувального паралельного коду." + description: "Ф'ючери дають можливість міркувати про паралельне виконання багатьох операцій – ефективним і не блокуючим способом. Ф'ючер — це об’єкт-заповнювач для значення, яке може ще не існувати. Як правило, вартість Ф'ючеру надається одночасно і може згодом використовуватися. Складання одночасних завдань таким чином, як правило, призводить до швидшого, асинхронного, не блокувального паралельного коду." - title: Паралельні колекції by: Aleksandar Prokopec та Heather Miller icon: rocket @@ -112,7 +112,7 @@ url: "parallel-collections/architecture.html" - title: Створення користувацьких паралельних колекцій url: "parallel-collections/custom-parallel-collections.html" - - title: Configuring Parallel Collections + - title: Конфігурація паралельних колекцій url: "parallel-collections/configuration.html" - title: Вимірювання продуктивності url: "parallel-collections/performance.html" @@ -156,13 +156,13 @@ url: "scaladoc/interface.html" - category: Компілятор - description: "Посібники та огляди компілятора Scala: плагіни компілятора, інструменти відображення та метапрограмування, такі як макроси." + description: "Посібники та огляди компілятора Scala: плагіни компілятора, інструменти рефлексії та метапрограмування, такі як макроси." overviews: - - title: Віддзеркалення + - title: Рефлексія by: Heather Miller, Eugene Burmako та Philipp Haller icon: binoculars url: "reflection/overview.html" - description: Фреймворк Scala для віддзеркалення під час виконання/компіляції. + description: Фреймворк Scala для рефлексії під час виконання/компіляції. label-text: experimental subdocs: - title: Огляд From 1ad64721bc05cf776508dadf8afea202473c4b2c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= Date: Tue, 21 Jun 2022 17:36:33 +0200 Subject: [PATCH 1939/3075] Update Scala version to 3.1.3 --- _config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_config.yml b/_config.yml index 034b324714..8009b6357a 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.8 scala-212-version: 2.12.16 -scala-3-version: 3.1.2 +scala-3-version: 3.1.3 collections: contribute_resources: From 2037f2de586e329587399f06c50de3ebfea49334 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 8 Jun 2022 17:42:04 +0200 Subject: [PATCH 1940/3075] merge navbars --- _data/doc-nav-header.yml | 28 +++++++++++++++++++--------- _data/scala3-doc-nav-header.yml | 24 ------------------------ _includes/navbar-inner.html | 9 +-------- 3 files changed, 20 insertions(+), 41 deletions(-) delete mode 100644 _data/scala3-doc-nav-header.yml diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index 52b66be1da..63e6db5534 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -1,11 +1,20 @@ - title: Getting Started url: "/getting-started/index.html" +- title: Migration + url: "#" + submenu: + - title: New in Scala 3 + url: "/scala3/new-in-scala3.html" + - title: Scala 3 Migration Guide + url: "/scala3/guides/migration/compatibility-intro.html" - title: Learn url: "#" submenu: - title: Tour of Scala url: "/tour/tour-of-scala.html" - - title: Scala Book + - title: Scala 3 Book + url: "/scala3/book/introduction.html" + - title: Scala 2 Book url: "/overviews/scala-book/introduction.html" - title: Online Courses url: "/online-courses.html" @@ -29,14 +38,20 @@ submenu: - title: "Guides & Overviews" url: "/overviews/index.html" + - title: Scala 3 Guides + url: '/scala3/guides.html' - title: Books url: "/books.html" - title: Scala FAQ url: "/tutorials/FAQ/index.html" - - title: Language Specification + - title: Scala Language Specification url: http://scala-lang.org/files/archive/spec/2.13/ - - title: Contribution Guide + - title: Scala 3 Language Reference + url: "https://docs.scala-lang.org/scala3/reference" + - title: Scala Contribution Guide url: "/contribute/" + - title: Scala 3 Compiler Contributing Guide + url: "/scala3/guides/contribution/contribution-intro.html" - title: Style Guide url: "/style/index.html" - title: Cheatsheet @@ -44,11 +59,6 @@ - title: Glossary url: "/glossary/index.html" - title: API - url: "#" - submenu: - - title: Current - url: https://www.scala-lang.org/api/current/ - - title: All Versions - url: "/api/all.html" + url: "/api/all.html" - title: SIPs url: "/sips/index.html" diff --git a/_data/scala3-doc-nav-header.yml b/_data/scala3-doc-nav-header.yml deleted file mode 100644 index 3493bd4de3..0000000000 --- a/_data/scala3-doc-nav-header.yml +++ /dev/null @@ -1,24 +0,0 @@ -- title: Getting Started - url: "/scala3/getting-started.html" -- title: Learn - url: "#" - submenu: - - title: New in Scala 3 - url: "/scala3/new-in-scala3.html" - - title: Scala 3 Book - url: "/scala3/book/introduction.html" - - title: Online Courses - url: "/online-courses.html" -- title: Migrate - url: "/scala3/guides/migration/compatibility-intro.html" -- title: Reference - url: '#' - submenu: - - title: Guides - url: '/scala3/guides.html' - - title: Language Specification - url: "https://docs.scala-lang.org/scala3/reference" - - title: Scala Library API - url: "https://scala-lang.org/api/3.x/" -- title: Contributing Guide - url: "/scala3/guides/contribution/contribution-intro.html" diff --git a/_includes/navbar-inner.html b/_includes/navbar-inner.html index 171d00924e..8ce1227e62 100644 --- a/_includes/navbar-inner.html +++ b/_includes/navbar-inner.html @@ -1,8 +1,4 @@ -{% if page.scala3 %} - {% assign navdata = site.data.scala3-doc-nav-header %} -{% else %} - {% assign navdata = site.data.doc-nav-header %} -{% endif %} +{% assign navdata = site.data.doc-nav-header %} {% include site-header.html %} @@ -18,9 +14,6 @@ docs - - — Scala {% if page.scala3 %} 3 {% else %} 2 {% endif %} -
      From c18b6dab6218a2c207f00f402bf3aa3ae5dfc02e Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 8 Jun 2022 17:42:24 +0200 Subject: [PATCH 1941/3075] single get-started page --- _getting-started/index.md | 4 +++- _ja/getting-started/index.md | 2 ++ _ja/scala3/getting-started.md | 8 -------- 3 files changed, 5 insertions(+), 9 deletions(-) delete mode 100644 _ja/scala3/getting-started.md diff --git a/_getting-started/index.md b/_getting-started/index.md index a26af28495..5db17b403c 100644 --- a/_getting-started/index.md +++ b/_getting-started/index.md @@ -5,7 +5,9 @@ partof: getting-started languages: [fr, ja, uk] includeTOC: true -redirect_from: "/getting-started.html" +redirect_from: + - /getting-started.html + - /scala3/getting-started.html # we deleted the scala 3 version of this page --- {% include getting-started.md %} diff --git a/_ja/getting-started/index.md b/_ja/getting-started/index.md index 3a20db86c6..e1d4101870 100644 --- a/_ja/getting-started/index.md +++ b/_ja/getting-started/index.md @@ -4,6 +4,8 @@ title: 入門 partof: getting-started language: ja includeTOC: true +redirect_from: + - /ja/scala3/getting-started.html # we deleted the scala 3 version of this page --- {% include _ja/getting-started.md %} diff --git a/_ja/scala3/getting-started.md b/_ja/scala3/getting-started.md deleted file mode 100644 index 120647c4c2..0000000000 --- a/_ja/scala3/getting-started.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -layout: singlepage-overview -title: Getting Started with Scala 3 -scala3: true -language: ja ---- - -{% include _ja/getting-started.md %} From 9a932fe6d0a8a852c14252da28ea47c3ec76dd9d Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 8 Jun 2022 20:29:39 +0200 Subject: [PATCH 1942/3075] ensure only books do not have sticky toc --- _includes/sidebar-toc-multipage-overview.html | 15 +++++++-------- _sass/layout/toc.scss | 10 +++++----- 2 files changed, 12 insertions(+), 13 deletions(-) diff --git a/_includes/sidebar-toc-multipage-overview.html b/_includes/sidebar-toc-multipage-overview.html index 168f4b5950..e82f7bc8d5 100644 --- a/_includes/sidebar-toc-multipage-overview.html +++ b/_includes/sidebar-toc-multipage-overview.html @@ -1,13 +1,12 @@ +{% assign pagetype = page.type %}
      -
      +
      Contents
      - {% assign type = page.type %} - {% if type %} -
    - {% elsif page.language %} - {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} - {% assign engPg = site.overviews | where: 'partof', page.partof | first %} + {% elsif page.language and page.orphanTranslation == false %} + + {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} + {% assign engPg = site.overviews | where: 'partof', page.partof | first %} - {% elsif page.language %} - {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} - {% assign engPg = site.overviews | where: 'partof', page.partof | first %} + {% elsif page.language and page.orphanTranslation == false %} + + {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} + {% assign engPg = site.overviews | where: 'partof', page.partof | first %}
    - - diff --git a/_ja/scala3/index.md b/_ja/scala3/index.md index 5940a8babb..31d285d6a5 100644 --- a/_ja/scala3/index.md +++ b/_ja/scala3/index.md @@ -1,5 +1,5 @@ --- -layout: inner-page-documentation +layout: landing-page title: Documentation for Scala 3 language: ja namespace: root @@ -41,4 +41,4 @@ sections: description: "Scala 3 の言語仕様" icon: "fa fa-book" link: https://docs.scala-lang.org/scala3/reference ---- \ No newline at end of file +--- diff --git a/_layouts/inner-page.html b/_layouts/basic-index.html similarity index 87% rename from _layouts/inner-page.html rename to _layouts/basic-index.html index e0cc813293..901f1a4453 100644 --- a/_layouts/inner-page.html +++ b/_layouts/basic-index.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent +layout: root-index-layout ---
    diff --git a/_layouts/blog-detail.html b/_layouts/blog-detail.html deleted file mode 100644 index 8e6419da3b..0000000000 --- a/_layouts/blog-detail.html +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: inner-page-parent ---- - - -{% include inner-page-blog-detail-main-content.html %} \ No newline at end of file diff --git a/_layouts/blog-list.html b/_layouts/blog-list.html deleted file mode 100644 index d06c97051a..0000000000 --- a/_layouts/blog-list.html +++ /dev/null @@ -1,9 +0,0 @@ ---- -layout: inner-page-parent-dropdown ---- - -{% if page.category %} - {% include blog-list.html category=page.category %} -{% else %} - {% include blog-list.html %} -{% endif %} diff --git a/_layouts/cheatsheet.html b/_layouts/cheatsheet.html index 9ee9695c01..8809f9cc3e 100644 --- a/_layouts/cheatsheet.html +++ b/_layouts/cheatsheet.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent-dropdown +layout: root-content-layout ---
    @@ -7,6 +7,9 @@
    + {% if page.new-version %} + {% include outdated-notice.html new-version=page.new-version %} + {% endif %} {{content}}
    diff --git a/_layouts/contribute.html b/_layouts/contribute.html deleted file mode 100644 index 8cd5f886e5..0000000000 --- a/_layouts/contribute.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -layout: inner-page-no-masthead -includeTOC: true ---- - -
    -
    -
    -
    -
    - {{ content }} -
    -
    -
    -
    -
    -
    diff --git a/_layouts/events.html b/_layouts/events.html deleted file mode 100644 index 4959010ad3..0000000000 --- a/_layouts/events.html +++ /dev/null @@ -1,13 +0,0 @@ ---- -layout: inner-page-parent ---- - -{% include events-training-list-top.html collection=paginator.events %} -
    - {{content}} -
    - -
    - - {% include paginator.html urlPath="events" %} -
    \ No newline at end of file diff --git a/_layouts/frontpage.html b/_layouts/frontpage.html deleted file mode 100644 index 29fa5825fe..0000000000 --- a/_layouts/frontpage.html +++ /dev/null @@ -1,386 +0,0 @@ ---- ---- - -{% include headertop.html %} -{% include headerbottom.html %} - -
    - - - - -
    - -
    -
    -

    {{site.data.common.texts.scalaBackendsTitle}}

    -
      - {% for backend in page.scalaBackends %} -
    • - - {{backend.description}} - -
      • - {% unless forloop.last %}
    • {% endunless %} - {% endfor %} -
    -

    - {{site.data.common.texts.scalaBackendsMore}} -

    -
    -
    - - -
    -
    -
    -

    IDEs for Scala

    -
    - -
    -
    - - -
    -
    -
    -

    Scala in a Nutshell

    -
    -

    click the boxes below to see Scala in action!

    -
    -
    -
    -
    -
    - {% for scalaItem in site.scala_items %} - {% assign loopIndexMod = forloop.index | minus: 1 | modulo: 3 %} - - {% if loopIndexMod == 0 %} - {% assign codeSnippets = '' | split: ',' %} -
    - {% endif %} - {% assign codeSnippets = codeSnippets | push: scalaItem.content %} -
    -

    {{scalaItem.shortTitle}}

    -

    {{scalaItem.shortDescription}}

    -
    - {% if loopIndexMod == 2 or forloop.last %} -
    -
    - {% for snippet in codeSnippets %} -
    {{snippet}}
    - {% endfor %} -
    - {% endif %} - {% endfor %} -
    -
    - {{page.headerButtonTitle}} -

    or visit the Scala Documentation

    -
    -
    -
    - - - - - -
    -
    - {% include online-courses.html %} - {% include upcoming-training.html %} -
    -
    - - -
    -
    -
    -

    Upcoming Events

    -
    -
    - {% assign upcomingEvents = '' | split: ',' %} - {% capture now %}{{site.time | date: '%s' | plus: 0}}{% endcapture %} - {% for event in site.events %} - {% capture date %}{{event.date|date: '%s'|plus: 86400}}{% endcapture %} - {% if now <= date %} - {% assign upcomingEvents = upcomingEvents | push: event %} - {% endif %} - {% endfor %} - {% for event in upcomingEvents limit: 6 %} -
    - - {{event.title}} -
    -

    {{event.title}}

    -
      -
    • {{event.location}}
      • -
    -
      -
    • {{event.start | date_to_string}} {% if event.start != event.end %}- {{event.end | date_to_string}}{% endif %}
      • -
    -
    -     -
    - {% endfor %} -
    -
    -

    See more events or add one to our feed

    -
    -
    -
    - -
    -
    -
    -

    {{page.ecosystemTitle}}

    -

    {{page.ecosystemDescription}}

    -
    -
    -
    - - -
    -
    -

    The Scala Library Index

    -
    - - -
    -
    -
    -
    -
    -
    -
    -
    -
    - -
    -
    -
    -
    -

    What’s New

    -
    - {% assign firstPost = site.posts | first %} -
    -

    {{firstPost.post-type|upcase}}

    -

    {{firstPost.title}}

    - {{firstPost.date | date: "%A, %B %-d, %Y"}} -

    {{firstPost.content}}

    -
    -
    -
    -
    -

    Recently

    -
    - {% for post in site.posts limit:3 offset:1 %} - -

    {{post.title}}

    -
      -
    • {{post.date | date: "%A, %B %-d, %Y"}}
      • -
    • •
      • -
    • {{post.by}}
      • -
    • {{post.post-type|upcase}}
      • -
    -

    {{post.content| strip_html | truncate:140}}

    -     - {% endfor %} -
    -
    -
    - View our blog -
    -
    - -
    -
    -
    -

    Talk to us!

    -
    -
    -

    Mailing lists / forums

    - {% for forum in site.data.chats-forums.discourseForums %} - - {{forum.title}} -

    {{forum.title}}

    -

    {{forum.subtitle}}

    -     - {% endfor %} -
    -
    -

    Real-time chat

    - {% assign modLimit = site.data.chats-forums.discordServers.size | modulo: 2 %} - {% capture channelLimit %} - {% if modLimit != 0 %} - {{site.data.chats-forums.discordServers.size | minus: 1}} - {% else %} - {{site.data.chats-forums.discordServers.size}} - {% endif %} - {% endcapture %} - {% for server in site.data.chats-forums.discordServers limit: channelLimit %} - {% if forloop.first %} -
      - {% endif %} -
    • - - - {{server.name}} - -
      • - - {% assign halfLength = forloop.length | divided_by: 2 | floor %} - {% if forloop.index == halfLength %} -
    -
      - {% endif %} - - {% if forloop.last %} -
    - {% endif %} - {% endfor %} -
    - {% if page.communities %} -
    -

    Communities

    -
      - {% for community in page.communities %} -
    • - {{community.name}} -
      • - {% endfor %} -
    -
    - {% endif %} - -
    -
    - - -{% include twitter-feed.html %} - - -
    - - -
    -
    -
    -

    {{site.data.common.texts.scalaMaintainersTitle}}

    -
    -
      - {% for maintainer in site.data.scala-supporters.maintainers %} -
    • {{maintainer.name}}
      • - {% endfor %} -
    -

    {{site.data.common.texts.scalaSupportersTitle}}

    -
    - {% for supporter in site.data.scala-supporters.supporters %} - {{supporter.name}} - {% endfor %} -
    -
    -
    -
    - -{% include footer.html %} diff --git a/_layouts/glossary.html b/_layouts/glossary.html index 59a14bf8f9..bd15a6274e 100644 --- a/_layouts/glossary.html +++ b/_layouts/glossary.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent-dropdown +layout: root-content-layout includeTOC: true --- @@ -8,6 +8,9 @@
    + {% if page.new-version %} + {% include outdated-notice.html new-version=page.new-version %} + {% endif %} {{content}}
    {% if page.languages %} diff --git a/_layouts/inner-page-community.html b/_layouts/inner-page-community.html deleted file mode 100644 index f5cdb3afdb..0000000000 --- a/_layouts/inner-page-community.html +++ /dev/null @@ -1,9 +0,0 @@ ---- -layout: inner-page-parent ---- - - -{% include masthead-community.html %} - - -{% include inner-page-main-content.html %} \ No newline at end of file diff --git a/_layouts/inner-page-no-masthead.html b/_layouts/inner-page-no-masthead.html deleted file mode 100644 index 28c8fe1663..0000000000 --- a/_layouts/inner-page-no-masthead.html +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: inner-page-parent ---- - - -{% include inner-page-main-content.html %} \ No newline at end of file diff --git a/_layouts/documentation.html b/_layouts/landing-page-deprecated.html similarity index 96% rename from _layouts/documentation.html rename to _layouts/landing-page-deprecated.html index f578b644d1..929cb01207 100644 --- a/_layouts/documentation.html +++ b/_layouts/landing-page-deprecated.html @@ -1,5 +1,6 @@ --- --- + {% include headertop.html %} {% include headerbottom.html %} {% if page.new-version %}This page has a new version.{% endif %} diff --git a/_layouts/inner-page-documentation.html b/_layouts/landing-page.html similarity index 72% rename from _layouts/inner-page-documentation.html rename to _layouts/landing-page.html index 5c420b46c3..5dfce6e343 100644 --- a/_layouts/inner-page-documentation.html +++ b/_layouts/landing-page.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent +layout: root-index-layout --- diff --git a/_layouts/multipage-overview.html b/_layouts/multipage-overview.html index ca65e57101..a9162e4d3d 100644 --- a/_layouts/multipage-overview.html +++ b/_layouts/multipage-overview.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent-dropdown +layout: root-content-layout includeTOC: true includeCollectionTOC: true --- @@ -9,6 +9,9 @@
    + {% if page.new-version %} + {% include outdated-notice.html new-version=page.new-version %} + {% endif %} {% if page.versionSpecific %} {% if page.scala3 %} {% assign versionSpecificLang = 'scala3' %} diff --git a/_layouts/overview.html b/_layouts/overview.html deleted file mode 100644 index 2d255c52bf..0000000000 --- a/_layouts/overview.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -layout: inner-page-parent -includeTOC: true -includeCollectionTOC: true ---- - -{% for pg in site.posts %} - {% if pg.overview == page.overview and pg.languages %} - {% assign languages = pg.languages %} - {% endif %} -{% endfor %} - -{% for pg in site.pages %} - {% if pg.overview == page.overview and pg.languages %} - {% assign languages = pg.languages %} - {% endif %} -{% endfor %} - -{% if page.language %} - {% capture intermediate %}{{ page.url | remove_first: page.language }}{% endcapture %} - {% capture rootTutorialURL %}{{ intermediate | remove_first: '/' }}{% endcapture %} -{% else %} - {% assign rootTutorialURL = page.url %} -{% endif %} - - -{% include inner-page-main-content.html %} diff --git a/_layouts/overviews.html b/_layouts/overviews.html index 73b4afb478..2568640141 100644 --- a/_layouts/overviews.html +++ b/_layouts/overviews.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent +layout: root-index-layout --- {% if page.language %} diff --git a/_layouts/inner-page-parent-dropdown.html b/_layouts/root-content-layout.html similarity index 81% rename from _layouts/inner-page-parent-dropdown.html rename to _layouts/root-content-layout.html index bd5b2c4e24..1828666a99 100644 --- a/_layouts/inner-page-parent-dropdown.html +++ b/_layouts/root-content-layout.html @@ -1,8 +1,6 @@ {% include headertop.html %} {% include headerbottom.html %} - -
    {% include navbar-inner.html %} @@ -12,12 +10,6 @@
    - {% if page.new-version %} -
    -

    Outdated Notice

    -

      This page has a new version.

    -
    - {% endif %}
    {% if page.overview-name %}
    {{ page.overview-name }}
    diff --git a/_layouts/inner-page-parent.html b/_layouts/root-index-layout.html similarity index 78% rename from _layouts/inner-page-parent.html rename to _layouts/root-index-layout.html index 2dc28bb539..97304053e1 100644 --- a/_layouts/inner-page-parent.html +++ b/_layouts/root-index-layout.html @@ -1,5 +1,4 @@ - {% include headertop.html %} {% include headerbottom.html %} - {% if page.new-version %}This page has a new version.{% endif %} +{% include headertop.html %} {% include headerbottom.html %}
    diff --git a/_layouts/singlepage-overview.html b/_layouts/singlepage-overview.html index b39eafc05e..867e4af164 100644 --- a/_layouts/singlepage-overview.html +++ b/_layouts/singlepage-overview.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent-dropdown +layout: root-content-layout includeTOC: true --- @@ -8,6 +8,9 @@
    + {% if page.new-version %} + {% include outdated-notice.html new-version=page.new-version %} + {% endif %} {% if page.versionSpecific %} {% if page.scala3 %} {% assign versionSpecificLang = 'scala3' %} diff --git a/_layouts/sip.html b/_layouts/sip.html index 688adf4d46..90174048d9 100644 --- a/_layouts/sip.html +++ b/_layouts/sip.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent-dropdown +layout: root-content-layout includeTOC: true --- diff --git a/_layouts/sips.html b/_layouts/sips.html index 328980a408..b7da7039b5 100644 --- a/_layouts/sips.html +++ b/_layouts/sips.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent-dropdown +layout: root-content-layout ---
    diff --git a/_layouts/style-guide.html b/_layouts/style-guide.html index b5e7741522..41e39d8709 100644 --- a/_layouts/style-guide.html +++ b/_layouts/style-guide.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent-dropdown +layout: root-content-layout includeCollectionTOC: true includeTOC: true --- @@ -9,6 +9,9 @@
    + {% if page.new-version %} + {% include outdated-notice.html new-version=page.new-version %} + {% endif %} {{content}}
    diff --git a/_layouts/tour.html b/_layouts/tour.html index ce65fd5098..33e67984de 100644 --- a/_layouts/tour.html +++ b/_layouts/tour.html @@ -1,5 +1,5 @@ --- -layout: inner-page-parent-dropdown +layout: root-content-layout includeTOC: true includeCollectionTOC: true --- @@ -9,6 +9,15 @@
    + {% if page.new-version %} + {% include outdated-notice.html new-version=page.new-version %} + {% endif %} + {{content}}
    diff --git a/_layouts/training.html b/_layouts/training.html deleted file mode 100644 index 3274549b11..0000000000 --- a/_layouts/training.html +++ /dev/null @@ -1,9 +0,0 @@ ---- -layout: inner-page-parent ---- - -{% include events-training-list-top.html collection=paginator.trainings %} -
    - - {% include paginator.html urlPath="training" %} -
    \ No newline at end of file diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md index ea2de8d132..7598ad5f63 100644 --- a/_overviews/contribute/add-guides.md +++ b/_overviews/contribute/add-guides.md @@ -273,7 +273,7 @@ Once the tutorial is written, to aid user navigation their link must be added to the metadata of `/tutorials.md`. e.g. it could look like --- - layout: inner-page-parent + layout: root-index-layout title: Tutorials tutorials: diff --git a/_overviews/index.md b/_overviews/index.md index 572296a85d..53ad207975 100644 --- a/_overviews/index.md +++ b/_overviews/index.md @@ -6,6 +6,7 @@ languages: [ja, zh-cn, ru, uk] permalink: /overviews/:title.html redirect_from: - /scala3/guides.html + - /guides.html --- diff --git a/_overviews/scaladoc/basics.md b/_overviews/scaladoc/basics.md deleted file mode 100644 index 4dc91dad79..0000000000 --- a/_overviews/scaladoc/basics.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: inner-page-no-masthead -sitemap: false -permalink: /overviews/scaladoc/basics.html -redirect_to: /overviews/scaladoc/for-library-authors.html ---- diff --git a/_overviews/scaladoc/for-library-authors.md b/_overviews/scaladoc/for-library-authors.md index 5d0d29a146..332cbffd17 100644 --- a/_overviews/scaladoc/for-library-authors.md +++ b/_overviews/scaladoc/for-library-authors.md @@ -7,6 +7,8 @@ overview-name: Scaladoc num: 3 permalink: /overviews/scaladoc/:title.html +redirect_from: + - /overviews/scaladoc/basics.html --- Scaladoc is a documentation system that lives in the comments of Scala source code @@ -106,13 +108,13 @@ scalacOptions in (Compile, doc) ++= Seq( ``` Each section should have a single-word identifier that is used in all of -these tags, shown as `` below. By default, that identifier is -shown as the title of that documentation section, but you can use +these tags, shown as `` below. By default, that identifier is +shown as the title of that documentation section, but you can use `@groupname` to provide a longer title. Typically, you should put `@groupprio` (and optionally `@groupname` and `@groupdesc`) in the Scaladoc for the package/trait/class/object itself, -describing what all the groups are, and their order. Then put `@group` +describing what all the groups are, and their order. Then put `@group` in the Scaladoc for each member, saying which group it is in. Members that do not have a `@group` tag will be listed as "Ungrouped" in @@ -207,12 +209,12 @@ Some types of markup available: with no interruptions from other block styles. Unordered lists can be bulleted using `-`; numbered lists can be denoted using `1.`, `i.`, `I.`, or `a.` for the various numbering styles. In both cases, you must have extra space in front, and - more space makes a sub-level. - + more space makes a sub-level. + The markup for list blocks looks like: /** Here is an unordered list: - * + * * - First item * - Second item * - Sub-item to the second diff --git a/_overviews/scaladoc/interface.md b/_overviews/scaladoc/interface.md index 3f2908182e..e985de9c3c 100644 --- a/_overviews/scaladoc/interface.md +++ b/_overviews/scaladoc/interface.md @@ -7,6 +7,8 @@ overview-name: Scaladoc num: 2 permalink: /overviews/scaladoc/:title.html +redirect_from: + - /overviews/scaladoc/usage.html --- Many Scala developers, including those with a great deal of experience, are diff --git a/_overviews/scaladoc/usage.md b/_overviews/scaladoc/usage.md deleted file mode 100644 index e1efd956f5..0000000000 --- a/_overviews/scaladoc/usage.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: inner-page-no-masthead -sitemap: false -permalink: /overviews/scaladoc/usage.html -redirect_to: /overviews/scaladoc/interface.html ---- diff --git a/_overviews/tutorials/partest-guide.md b/_overviews/tutorials/partest-guide.md index 36fa8c74c7..a5542ad9a4 100644 --- a/_overviews/tutorials/partest-guide.md +++ b/_overviews/tutorials/partest-guide.md @@ -1,5 +1,4 @@ --- -layout: inner-page-no-masthead sitemap: false permalink: /tutorials/partest-guide.html redirect_to: https://github.com/scala/scala-partest diff --git a/_overviews/tutorials/scala-for-csharp-programmers.disabled.html b/_overviews/tutorials/scala-for-csharp-programmers.disabled.html index 7641a4ec65..6dfc4969ec 100644 --- a/_overviews/tutorials/scala-for-csharp-programmers.disabled.html +++ b/_overviews/tutorials/scala-for-csharp-programmers.disabled.html @@ -1,5 +1,5 @@ --- -layout: overview +layout: singlepage-overview title: A Scala Tutorial for C# Programmers --- @@ -7,10 +7,10 @@ ## Introduction -Scala is a hybrid of functional and object-oriented languages. -Its functional aspects make it very expressive when writing algorithmic -code, and play nicely with the brave new world of concurrency; its -object-oriented aspects keep it familiar and convenient when creating +Scala is a hybrid of functional and object-oriented languages. +Its functional aspects make it very expressive when writing algorithmic +code, and play nicely with the brave new world of concurrency; its +object-oriented aspects keep it familiar and convenient when creating business objects or other stateful models. ## The same concepts @@ -109,9 +109,9 @@ You can see the same principle in action for the return type of the function. `reticulate` returns a `String`. -Finally, the body of the method has been placed after an equals sign, -rather than inside braces. (Braces are only necessary when the method -body consists of multiple expressions/statements.) What's more, +Finally, the body of the method has been placed after an equals sign, +rather than inside braces. (Braces are only necessary when the method +body consists of multiple expressions/statements.) What's more, the body of the method is an expression -- that is, something with a value -- rather than a set of statements amongst which is a `return`. I'll come back to this when we look at a more realistic @@ -139,7 +139,7 @@ ### Base Types Scala's base types are pretty much the same as C#'s, except that they -are named with initial capitals, e.g. `Int` instead of `int`. (In fact +are named with initial capitals, e.g. `Int` instead of `int`. (In fact every type in Scala starts with an uppercase letter.) There are no unsigned variants, and booleans are called `Boolean` instead of `bool`. @@ -154,8 +154,8 @@ Scala has the same concept, but the function types are built into the language, rather than being library types. Function types are -spelled `(T1, T2, ...) => TR`. For example, a predicate of integers -would be type `(Int) => Boolean`. If there is only one input type, +spelled `(T1, T2, ...) => TR`. For example, a predicate of integers +would be type `(Int) => Boolean`. If there is only one input type, the parens can be left out like this: `Int => Boolean`. Effectively, Scala gets rid of all those weird custom delegate types @@ -220,7 +220,7 @@ ### Tuples -Everybody hates out parameters. We all know that code like this just +Everybody hates out parameters. We all know that code like this just isn't nice: Widget widget; @@ -229,21 +229,21 @@ widget.ReticulateSplines(); } -And once you start composing higher-level functions into the mix, it gets -positively nasty. Suppose I want to make a HTTP request. Well, that's -going to produce two outputs in itself, the success code and the response -data. But now suppose I want to time it. Writing the timing code isn't a -problem, but now I have *three* outputs, and to paraphrase *Was Not Was*, +And once you start composing higher-level functions into the mix, it gets +positively nasty. Suppose I want to make a HTTP request. Well, that's +going to produce two outputs in itself, the success code and the response +data. But now suppose I want to time it. Writing the timing code isn't a +problem, but now I have *three* outputs, and to paraphrase *Was Not Was*, I feel worse than Jamie Zawinski. -You can get around this in specific situations by creating custom types -like `DictionaryLookupResult` or `TimedHttpRequestResult`, but eventually +You can get around this in specific situations by creating custom types +like `DictionaryLookupResult` or `TimedHttpRequestResult`, but eventually the terrible allure wears off, and you just want it to work. -Enter tuples. A tuple is just a small number of values -- a single value, -a pair of values, a triplet of values, that sort of thing. You can tell -that tuples were named by mathematicians because the name only makes sense -when you look at the cases you hardly ever use (quadruple, quintuple, +Enter tuples. A tuple is just a small number of values -- a single value, +a pair of values, a triplet of values, that sort of thing. You can tell +that tuples were named by mathematicians because the name only makes sense +when you look at the cases you hardly ever use (quadruple, quintuple, sextuple, etc.). Using tuples, our timed HTTP request might look like this: public Tuple Time(Func> action) @@ -253,27 +253,27 @@ TimeSpan howLong = StopTimer(); return Tuple.Create(result.First, result.Second, howLong); } - + var result = Time(() => MakeRequest(uri)); var succeeded = result.First; var response = result.Second; var howLong = result.Third. Console.WriteLine("it took " + howLong); -The reason this keeps getting verbose on us is that C# doesn’t provide any -syntatical support for tuples. To C#, a `Tuple<>` is just another generic -type. To us, the readers, a `Tuple<>` is just another generic type with +The reason this keeps getting verbose on us is that C# doesn’t provide any +syntatical support for tuples. To C#, a `Tuple<>` is just another generic +type. To us, the readers, a `Tuple<>` is just another generic type with particularly unhelpful member names. -Really, what we're really trying to articulate by returning a `Tuple<>` is, -"this method has several outputs." So what do we want to do with those -outputs? We want to access them, for example to stash them in variables, -without having to construct and pick apart the tuple one value at a time. -That means the language has to provide some kind of syntax-level support -for tuples, instead of treating them like every other class the compiler +Really, what we're really trying to articulate by returning a `Tuple<>` is, +"this method has several outputs." So what do we want to do with those +outputs? We want to access them, for example to stash them in variables, +without having to construct and pick apart the tuple one value at a time. +That means the language has to provide some kind of syntax-level support +for tuples, instead of treating them like every other class the compiler doesn’t know about. -Many functional languages have exactly this kind of syntactical support, +Many functional languages have exactly this kind of syntactical support, and Scala is no exception. Here’s how the above pseudo-C# looks in Scala: def time(action: => (Boolean, Stream)): (Boolean, Stream, TimeSpan) = { @@ -281,23 +281,23 @@ val (succeeded, response) = action (succeeded, response, stopTimer()) } - + val (succeeded, response, timeTaken) = time(makeRequest) Console.WriteLine("it took " + timeTaken) -Notice the multiple variables on the left hand side of the time call? -Notice the `(Boolean, Stream, TimeSpan)` return type of the time method? -That return value is effectively a tuple type, but instead of having to -capture the returned tuple in a `Tuple<>` variable and extract its various -bits by hand, we are getting the Scala compiler to (in the time function) -compose the tuple implicitly for us, without us having to write the -constructor call, and (in the calling code) unpick the tuple into -meaningful, named variables for us without us having to explicitly copy +Notice the multiple variables on the left hand side of the time call? +Notice the `(Boolean, Stream, TimeSpan)` return type of the time method? +That return value is effectively a tuple type, but instead of having to +capture the returned tuple in a `Tuple<>` variable and extract its various +bits by hand, we are getting the Scala compiler to (in the time function) +compose the tuple implicitly for us, without us having to write the +constructor call, and (in the calling code) unpick the tuple into +meaningful, named variables for us without us having to explicitly copy the values one by one and by name. -(By the way, a proper implementation of the `time()` method wouldn’t be -restricted to `(Boolean, Stream)` results: we’d be looking to write a -method that could time anything. I’ve skipped that because it would +(By the way, a proper implementation of the `time()` method wouldn’t be +restricted to `(Boolean, Stream)` results: we’d be looking to write a +method that could time anything. I’ve skipped that because it would distract from the point at hand.) How would this play with the dictionary example? @@ -306,60 +306,60 @@ if (found) widget.reticulateSplines() -We don’t actually save any lines of code, what with having to now capture -the “found” value into a variable and test it separately; and it’s not as -if the original C# version was horribly unreadable anyway. So maybe this is -a matter of taste, but I find this a lot easier to read and to write: all -the outputs are on the left of the equals sign where they belong, instead -of being spread between the assignment result and the parameter list, and +We don’t actually save any lines of code, what with having to now capture +the “found” value into a variable and test it separately; and it’s not as +if the original C# version was horribly unreadable anyway. So maybe this is +a matter of taste, but I find this a lot easier to read and to write: all +the outputs are on the left of the equals sign where they belong, instead +of being spread between the assignment result and the parameter list, and we don’t have that odd Widget declaration at the top. ## New and different concepts -Scala's primary platform is the Java virtual machine, and some of the -interest in Scala comes from Java programmers' interest in features such -as type inference, comprehensions and lambdas, with which C# programmers -are already familiar. So what's left that might be of interest +Scala's primary platform is the Java virtual machine, and some of the +interest in Scala comes from Java programmers' interest in features such +as type inference, comprehensions and lambdas, with which C# programmers +are already familiar. So what's left that might be of interest specifically to C# programmers? ### Mixins and Traits #### Motivation -Interfaces in C# and Java play a dual role. -First, they are a set of capabilities that an implementer has to, well, -implement. Second, they are a feature set that a client can use. +Interfaces in C# and Java play a dual role. +First, they are a set of capabilities that an implementer has to, well, +implement. Second, they are a feature set that a client can use. -These two roles can be conflicting: The first means that interfaces want -to be minimal, so that implementers don't have to implement a whole lot -of superfluous and redundant guff. The second means that interfaces want -to be maximal, so that clients don't have to clog themselves up with +These two roles can be conflicting: The first means that interfaces want +to be minimal, so that implementers don't have to implement a whole lot +of superfluous and redundant guff. The second means that interfaces want +to be maximal, so that clients don't have to clog themselves up with boilerplate utility methods. Consider, for example, `IEnumerable` (and its sister interface `IEnumerator`). -This is a very minimal interface: implementers just need to be able to -produce values in sequence. But this minimalism means that clients of -`IEnumerable` need to write the same old boilerplate again and again and -again: foreach loops to filter, foreach loops to call a method on each -element of the sequence, foreach loops to aggregate, foreach loops to -check whether all elements meet a criterion, or to find the first member -that meets a criterion, or... - -This is frustrating because the implementations of "filter," "apply", -"aggregate," and so on are always the same. Of course, we could put -these methods into concrete types (`List` includes several), but then -those concrete types will contain duplicate code, and users who only have -an `IEnumerable` will still miss out. And yet we can't put these methods -into the interface because then every implementer of `IEnumerable` would -have to implement them -- and they'd end up writing the same boilerplate, +This is a very minimal interface: implementers just need to be able to +produce values in sequence. But this minimalism means that clients of +`IEnumerable` need to write the same old boilerplate again and again and +again: foreach loops to filter, foreach loops to call a method on each +element of the sequence, foreach loops to aggregate, foreach loops to +check whether all elements meet a criterion, or to find the first member +that meets a criterion, or... + +This is frustrating because the implementations of "filter," "apply", +"aggregate," and so on are always the same. Of course, we could put +these methods into concrete types (`List` includes several), but then +those concrete types will contain duplicate code, and users who only have +an `IEnumerable` will still miss out. And yet we can't put these methods +into the interface because then every implementer of `IEnumerable` would +have to implement them -- and they'd end up writing the same boilerplate, just now in all the zillions of `IEnumerable` classes instead of their clients. #### The C# and Scala Solutions -We could resolve this tension if we had a way for interfaces to contain -implementation: for example, if `IEnumerable` required the implementer -to provide the class-specific iteration functionality, but then provided -the standard implementations of "filter," "apply", "aggregate" and so on +We could resolve this tension if we had a way for interfaces to contain +implementation: for example, if `IEnumerable` required the implementer +to provide the class-specific iteration functionality, but then provided +the standard implementations of "filter," "apply", "aggregate" and so on automatically: public pseudo_interface IEnumerable @@ -373,24 +373,24 @@ } } -C# 3 addresses this using extension methods: the methods mentioned above -are all in fact included as extension methods on `IEnumerable` as -part of LINQ. +C# 3 addresses this using extension methods: the methods mentioned above +are all in fact included as extension methods on `IEnumerable` as +part of LINQ. -This has some advantages over the approach described above: specifically, -the "standard methods" aren't bound up in the interface, so you can add -your own methods instead of being limited to the ones that the interface +This has some advantages over the approach described above: specifically, +the "standard methods" aren't bound up in the interface, so you can add +your own methods instead of being limited to the ones that the interface author has included. -On the other hand, it means that method implementations have to be packaged +On the other hand, it means that method implementations have to be packaged in a different class from the interface, which feels less than modular. -Scala takes a different approach. A Scala trait can contain a mix of -abstract methods without implementation as well as concrete methods with -an implementation. (It can also be a pure interface, with only abstract +Scala takes a different approach. A Scala trait can contain a mix of +abstract methods without implementation as well as concrete methods with +an implementation. (It can also be a pure interface, with only abstract members.) -Here's a Scala trait that represents objects that can be compared +Here's a Scala trait that represents objects that can be compared and ordered: trait Ord { @@ -400,14 +400,14 @@ def >=(that: Any): Boolean = !(this < that) } -Orderable objects can extend `Ord`, but only need to implement the -method `<`. They then get the other operators for free, implemented +Orderable objects can extend `Ord`, but only need to implement the +method `<`. They then get the other operators for free, implemented automatically by Ord in terms of `<`. class Date extends Ord { def < (that: Any): Boolean = /* implementation */ } - + // can now write: myDate >= yourDate A similar trait, called `Ordered` already exists in Scala, so there is no @@ -415,13 +415,13 @@ #### Scala Traits vs. C# Extension Methods -Okay, so Scala has a different way of packaging standard implementations -from C#'s extension methods. It's different, but why is it interesting? -Well, there are a couple of things that you can do with Scala traits that +Okay, so Scala has a different way of packaging standard implementations +from C#'s extension methods. It's different, but why is it interesting? +Well, there are a couple of things that you can do with Scala traits that don't fall nicely out of the extension methods approach. -First, you can override the default implementations of trait members, -to take advantage of additional information or capabilities available +First, you can override the default implementations of trait members, +to take advantage of additional information or capabilities available in the implementing type. Let's look at another `IEnumerable` example, recast as a Scala trait: @@ -437,12 +437,12 @@ } } -This (ignoring style issues for now) is the only fully general -implementation we can provide for count: it will work with any `Enumerable`. -But for collections that know their sizes, such as `arrays` or `List`, -it's gruesomely inefficient. It iterates over the entire collection, -counting elements one by one, when it could just consult the `size` member -and return that. +This (ignoring style issues for now) is the only fully general +implementation we can provide for count: it will work with any `Enumerable`. +But for collections that know their sizes, such as `arrays` or `List`, +it's gruesomely inefficient. It iterates over the entire collection, +counting elements one by one, when it could just consult the `size` member +and return that. Let's fix that: @@ -452,68 +452,68 @@ override def count: Int = _size } -The `count` member of the `Enumerable` trait works like a virtual method: +The `count` member of the `Enumerable` trait works like a virtual method: it can be overridden in classes which implement/derive from `Enumerable`. -Compare this to the `Count()` extension method on `IEnumerable` in LINQ. -This achieves the same effect by trying to cast to `ICollection`, which is -fine as far as it goes but isn't extensible. +Compare this to the `Count()` extension method on `IEnumerable` in LINQ. +This achieves the same effect by trying to cast to `ICollection`, which is +fine as far as it goes but isn't extensible. -Suppose you create an enumerable class that can count itself quickly but -isn't a collection -- for example a natural numbers range object. -With a Scala trait, the `NumberRange` type could provide an efficient -override of `count`, just like any other virtual method; with C# extension -methods, `Enumerable.Count()` would have to somehow know about the +Suppose you create an enumerable class that can count itself quickly but +isn't a collection -- for example a natural numbers range object. +With a Scala trait, the `NumberRange` type could provide an efficient +override of `count`, just like any other virtual method; with C# extension +methods, `Enumerable.Count()` would have to somehow know about the `NumberRange` type in advance, or fall back on counting elements one by one. -Second, with Scala you can choose a trait implementation when you -instantiate an object, rather than having it baked in at the class level +Second, with Scala you can choose a trait implementation when you +instantiate an object, rather than having it baked in at the class level once and for all. This is called mixin-composition. -Suppose you're creating a `MyList` instance, but you want it to puff itself -up to look bigger so as to frighten other `MyList` instances off its territory. -(This example would probably work better with fish, but we're stuck with -`Enumerable`s now. Work with me here.) In C#, you'd need to create a -`PuffedUpMyList` class and override the `Count` property. +Suppose you're creating a `MyList` instance, but you want it to puff itself +up to look bigger so as to frighten other `MyList` instances off its territory. +(This example would probably work better with fish, but we're stuck with +`Enumerable`s now. Work with me here.) In C#, you'd need to create a +`PuffedUpMyList` class and override the `Count` property. In Scala, you can just mix in a `PuffedUp` version of the trait: trait PuffedUp extends Enumerable { override def count: Int = super.count + 100 } - + val normal = new MyList Console.WriteLine(normal.count) // meh val puffedUp = new MyList with PuffedUp Console.WriteLine(puffedUp.count) // eek! -As you can imagine this gives us much better granularity and composability -of traits and implementations than we get from the extension methods -approach, or indeed from single implementation inheritance type systems +As you can imagine this gives us much better granularity and composability +of traits and implementations than we get from the extension methods +approach, or indeed from single implementation inheritance type systems in general. -So Scala traits have some distinct advantages over extension methods. -The only downside appears to be the inability for clients to add their -own methods to a trait after the fact. +So Scala traits have some distinct advantages over extension methods. +The only downside appears to be the inability for clients to add their +own methods to a trait after the fact. -Fortunately, you can work around this in Scala using so-called implicit +Fortunately, you can work around this in Scala using so-called implicit conversions. They enable Scala programmers to enrich existing types with new functionality. ### Singletons -In C#, if you want to create a singleton object, you have to create a class, -then stop evildoers creating their own instances of that class, then create +In C#, if you want to create a singleton object, you have to create a class, +then stop evildoers creating their own instances of that class, then create and provide an instance of that class yourself. -While this is hardly a Burma Railway of the programming craft, it does -feel like pushing against the grain of the language. Nor is it great for -maintainers, who have to be able to recognise a singleton by its pattern -(private constructor, public static readonly field, ...), or for clients, -who have to use a slightly clumsy multipart syntax to refer to the +While this is hardly a Burma Railway of the programming craft, it does +feel like pushing against the grain of the language. Nor is it great for +maintainers, who have to be able to recognise a singleton by its pattern +(private constructor, public static readonly field, ...), or for clients, +who have to use a slightly clumsy multipart syntax to refer to the singleton (e.g. `Universe.Instance`). -What would be easier for all concerned would be if you could just declare -objects *as* singletons. That is, instead of writing class `Universe` and a +What would be easier for all concerned would be if you could just declare +objects *as* singletons. That is, instead of writing class `Universe` and a `public static readonly` instance of it, you could just write `object Universe`. And that's exactly what Scala allows you to do: @@ -521,99 +521,99 @@ object Universe { def contains(obj: Any): Boolean = true } - + val v = Universe.contains(42) -What's going on behind the scenes here? It pretty much goes without saying -that the Scala compiler is creating a new type for the singleton object. -In fact it creates two types, one for the implementation and one for the -interface. The interface looks like a .NET static class (actually, the -.NET 1.x equivalent, a sealed class with only static members). +What's going on behind the scenes here? It pretty much goes without saying +that the Scala compiler is creating a new type for the singleton object. +In fact it creates two types, one for the implementation and one for the +interface. The interface looks like a .NET static class (actually, the +.NET 1.x equivalent, a sealed class with only static members). Thus, a C# program would call the example above as `Universe.contains(42)`. -Singleton objects are first-class citizens in Scala, so they can for -example derive from classes. This is a nice way of creating special values -with custom behaviour: you don't need to create a whole new type, you just +Singleton objects are first-class citizens in Scala, so they can for +example derive from classes. This is a nice way of creating special values +with custom behaviour: you don't need to create a whole new type, you just define an instance and override methods in it: abstract class Cat { def humiliateSelf() } - + object Slats extends Cat { def humiliateSelf() { savage(this.tail) } } -Obviously this is a frivolous example, but "special singletons" turn out to -be an important part of the functional idiom, for example for bottoming out -recursion. *Scala by Example (PDF)* describes an implementation of a Set class -which is implemented as a tree-like structure ("left subset - member - right -subset"), and methods such as `contains()` work by recursing down to the -child sets. For this to work requires an `EmptySet` whose implementation -(state) and behaviour are quite different from non-empty sets -- e.g. -`contains()` just returns `false` instead of trying to delegate to -non-existent child sets. Since `EmptySet` is logically unique it is both -simpler and more efficient to represent it as a singleton: i.e. to declare +Obviously this is a frivolous example, but "special singletons" turn out to +be an important part of the functional idiom, for example for bottoming out +recursion. *Scala by Example (PDF)* describes an implementation of a Set class +which is implemented as a tree-like structure ("left subset - member - right +subset"), and methods such as `contains()` work by recursing down to the +child sets. For this to work requires an `EmptySet` whose implementation +(state) and behaviour are quite different from non-empty sets -- e.g. +`contains()` just returns `false` instead of trying to delegate to +non-existent child sets. Since `EmptySet` is logically unique it is both +simpler and more efficient to represent it as a singleton: i.e. to declare `object EmptySet` instead of `class EmptySet`. -In fact the whole thing can become alarmingly deep: *Scala by Example* -also includes a description of `Boolean` as an `abstract class`, and -`True` and `False` as singleton objects which extend `Boolean` and provide -appropriate implementations of the `ifThenElse` method. +In fact the whole thing can become alarmingly deep: *Scala by Example* +also includes a description of `Boolean` as an `abstract class`, and +`True` and `False` as singleton objects which extend `Boolean` and provide +appropriate implementations of the `ifThenElse` method. -And fans of Giuseppe Peano should definitely check out the hypothetical +And fans of Giuseppe Peano should definitely check out the hypothetical implementation of `Int`... ### Pass by Name -> You're only on chapter 3 and you're already reduced to writing about -> *calling conventions*? You suck! Do another post about chimney sweeps +> You're only on chapter 3 and you're already reduced to writing about +> *calling conventions*? You suck! Do another post about chimney sweeps > being hunted by jars of marmalade!" -Silence, cur. Pass by name is not as other calling conventions are. -Pass by name, especially in conjunction with some other rather -theoretical-sounding Scala features, is your gateway to the wonderful +Silence, cur. Pass by name is not as other calling conventions are. +Pass by name, especially in conjunction with some other rather +theoretical-sounding Scala features, is your gateway to the wonderful world of language extensibility. #### What is Passing By Name? -First, let's talk about what we mean by *calling convention*. A calling -convention describes how stuff gets passed to a method by its caller. -In the good old days, this used to mean exciting things like which -arguments got passed in registers and who was responsible for resetting -the stack pointer. Sadly, the days of being able to refer to "naked fun -calls" are consigned to history: In modern managed environments, the -runtime takes care of all this guff and the main distinction is pass -data by value or by reference. (The situation on the CLR is slightly -complicated by the need to differentiate passing values by value, values -by reference, references by value and references by reference, but I'm -not going to go into that because (a) it's irrelevant to the subject at -hand and (b) that's -[Jon Skeet](http://www.yoda.arachsys.com/csharp/parameters.html)'s turf +First, let's talk about what we mean by *calling convention*. A calling +convention describes how stuff gets passed to a method by its caller. +In the good old days, this used to mean exciting things like which +arguments got passed in registers and who was responsible for resetting +the stack pointer. Sadly, the days of being able to refer to "naked fun +calls" are consigned to history: In modern managed environments, the +runtime takes care of all this guff and the main distinction is pass +data by value or by reference. (The situation on the CLR is slightly +complicated by the need to differentiate passing values by value, values +by reference, references by value and references by reference, but I'm +not going to go into that because (a) it's irrelevant to the subject at +hand and (b) that's +[Jon Skeet](http://www.yoda.arachsys.com/csharp/parameters.html)'s turf and I don't want him to shank me. Again.) -In *pass by value*, the called method gets a copy of whatever the caller -passed in. Arguments passed by value therefore work like local variables -that are initialised before the method runs: when you do anything to them, +In *pass by value*, the called method gets a copy of whatever the caller +passed in. Arguments passed by value therefore work like local variables +that are initialised before the method runs: when you do anything to them, you're doing it to your own copy. -In *pass by reference*, the called method gets a reference to the caller's -value. When you do anything to a pass-by-reference argument, you're doing -it to the caller's data. +In *pass by reference*, the called method gets a reference to the caller's +value. When you do anything to a pass-by-reference argument, you're doing +it to the caller's data. -In *pass by name*, the called method gets... well, it's a bit messy to -explain what the called method gets. But when the called method does -anything to the argument, the argument gets evaluated and the "anything" -is done to that. Crucially, evaluation happens every time the argument +In *pass by name*, the called method gets... well, it's a bit messy to +explain what the called method gets. But when the called method does +anything to the argument, the argument gets evaluated and the "anything" +is done to that. Crucially, evaluation happens every time the argument gets mentioned, and only when the argument gets mentioned. #### Not Just Another Calling Convention -Why does this matter? It matters because there are functions you can't -implement using pass by value or pass by reference, but you can implement +Why does this matter? It matters because there are functions you can't +implement using pass by value or pass by reference, but you can implement using pass by name. -Suppose, for example, that C# didn't have the `while` keyword. +Suppose, for example, that C# didn't have the `while` keyword. You'd probably want to write a method that did the job instead: public static void While(bool condition, Action body) @@ -630,30 +630,30 @@ long x = 0; While(x < 10, () => x = x + 1); -C# evaluates the arguments to `While` and invokes the `While` method with -the arguments `true` and `() => x = x + 1`. After watching the CPU sit -on 100% for a while you might check on the value of `x` and find it's -somewhere north of a trillion. *Why?* Because the condition argument was -*passed by value*, so whenever the `While` method tests the value of -condition, it's always `true`. The `While` method doesn't know that -condition originally came from the expression `x < 10`; all `While` knows +C# evaluates the arguments to `While` and invokes the `While` method with +the arguments `true` and `() => x = x + 1`. After watching the CPU sit +on 100% for a while you might check on the value of `x` and find it's +somewhere north of a trillion. *Why?* Because the condition argument was +*passed by value*, so whenever the `While` method tests the value of +condition, it's always `true`. The `While` method doesn't know that +condition originally came from the expression `x < 10`; all `While` knows is that condition is `true`. -For the `While` method to work, we need it to re-evaluate `x < 10` every -time it hits the condition argument. While needs not the value of the -argument at the call site, nor a reference to the argument at the call -site, but the actual expression that the caller wants it to use to generate +For the `While` method to work, we need it to re-evaluate `x < 10` every +time it hits the condition argument. While needs not the value of the +argument at the call site, nor a reference to the argument at the call +site, but the actual expression that the caller wants it to use to generate a value. -Same goes for short-circuit evaluation. If you want short-circuit -evaluation in C#, your only hope if to get on the blower to Anders +Same goes for short-circuit evaluation. If you want short-circuit +evaluation in C#, your only hope if to get on the blower to Anders Hejlsberg and persuade him to bake it into the language: bool result = (a > 0 && Math.Sqrt(a) < 10); double result = (a < 0 ? Math.Sqrt(-a) : Math.Sqrt(a)); -You can't write a function like `&&` or `?:` yourself, because C# will -always try to evaluate all the arguments before calling your function. +You can't write a function like `&&` or `?:` yourself, because C# will +always try to evaluate all the arguments before calling your function. Consider a VB exile who wants to reproduce his favourite keywords in C#: @@ -675,24 +675,24 @@ bool result = AndAlso(a > 0, Math.Sqrt(a) < 10); double result = IIf(a < 0, Math.Sqrt(-a), Math.Sqrt(a)); -it would try to evaluate all the arguments at the call site, and pass the -results of those evaluations to `AndAlso` or `IIf`. There's no -short-circuiting. So the `AndAlso` call would crash if a were negative, -and the `IIf` call if a were anything other than 0. Again, what you want is -for the `condition1`, `condition2`, `ifTrue` and `ifFalse` arguments to be -evaluated by the callee if it needs them, not for the caller to evaluate +it would try to evaluate all the arguments at the call site, and pass the +results of those evaluations to `AndAlso` or `IIf`. There's no +short-circuiting. So the `AndAlso` call would crash if a were negative, +and the `IIf` call if a were anything other than 0. Again, what you want is +for the `condition1`, `condition2`, `ifTrue` and `ifFalse` arguments to be +evaluated by the callee if it needs them, not for the caller to evaluate them before making the call. -And that's what *pass by name* does. A parameter passed by name is not -evaluated when it is passed to a method. It is evaluated -- and -re-evaluated -- when the called method evaluates the parameter; -specifically when the called method requests the value of the parameter by -mentioning its name. This might sound weird and academic, but it's the key +And that's what *pass by name* does. A parameter passed by name is not +evaluated when it is passed to a method. It is evaluated -- and +re-evaluated -- when the called method evaluates the parameter; +specifically when the called method requests the value of the parameter by +mentioning its name. This might sound weird and academic, but it's the key to being able to define your own control constructs. #### Using Pass By Name in Scala -Let's see the custom while implementation again, this time with Scala +Let's see the custom while implementation again, this time with Scala *pass by name* parameters: def myWhile(condition: => Boolean)(body: => Unit): Unit = @@ -709,26 +709,26 @@ i += 1 } -Unlike the C# attempt, this prints out the numbers from 0 to 9 and then +Unlike the C# attempt, this prints out the numbers from 0 to 9 and then terminates as you'd wish. Pass by name also works for short-circuiting: import math._ - + def andAlso(condition1: => Boolean, condition2: => Boolean): Boolean = condition1 && condition2 - + val d = -1.234 val result = andAlso(d > 0, sqrt(d) < 10) -The `andAlso` call returns `false` rather than crashing, because +The `andAlso` call returns `false` rather than crashing, because `sqrt(d) < 10` never gets evaluated. -What's going on here? What's the weird colon-and-pointy-sticks syntax? +What's going on here? What's the weird colon-and-pointy-sticks syntax? What is actually getting passed to `myWhile` and `andAlso` to make this work? -The answer is a bit surprising. Nothing is going on here. This is the +The answer is a bit surprising. Nothing is going on here. This is the normal Scala function parameter syntax. There is no *pass by name* in Scala. Here's a bog-standard *pass by value* Scala function declaration: @@ -739,9 +739,9 @@ def myFunc2(f: Int => Boolean): Unit = ... -Even if you've not seen this kind of expression before, it's probably not -too hard to guess what this means. This function takes a *function from -`Int` to `Boolean`* as its argument. In C# terms, +Even if you've not seen this kind of expression before, it's probably not +too hard to guess what this means. This function takes a *function from +`Int` to `Boolean`* as its argument. In C# terms, `void MyFunc2(Func f)`. We could call this as follows: myFunc2 { (i: Int) => i > 0 } @@ -750,46 +750,46 @@ def myFunc3(f: => Boolean) : Unit = ... -Well, if `myFunc2` took an *Int-to-Boolean* function, `myFunc3` must be -taking a "blank-to-Boolean" function -- a function that takes no arguments -and returns a `Boolean`. In short, a conditional expression. So we can +Well, if `myFunc2` took an *Int-to-Boolean* function, `myFunc3` must be +taking a "blank-to-Boolean" function -- a function that takes no arguments +and returns a `Boolean`. In short, a conditional expression. So we can call `myFunc3` as follows: val j = 123 myFunc3 { j > 0 } -The squirly brackets are what we'd expect from an anonymous function, and -because the function has no arguments Scala doesn't make us write -`{ () => j > 0 }`, even though that's what it means really. The anonymous -function has no arguments because `j` is a captured local variable, not an -argument to the function. But there's more. Scala also lets us call +The squirly brackets are what we'd expect from an anonymous function, and +because the function has no arguments Scala doesn't make us write +`{ () => j > 0 }`, even though that's what it means really. The anonymous +function has no arguments because `j` is a captured local variable, not an +argument to the function. But there's more. Scala also lets us call `myFunc3` like this: val j = 123 myFunc3(j > 0) -This is normal function call syntax, but the Scala compiler realises that -`myFunc3` expects a nullary function (a function with no arguments) rather -than a `Boolean`, and therefore treats `myFunc3(j > 0)` as shorthand for -`myFunc3(() => j > 0)`. This is the same kind of logic that the C# compiler -uses when it decides whether to compile a lambda expression to a delegate +This is normal function call syntax, but the Scala compiler realises that +`myFunc3` expects a nullary function (a function with no arguments) rather +than a `Boolean`, and therefore treats `myFunc3(j > 0)` as shorthand for +`myFunc3(() => j > 0)`. This is the same kind of logic that the C# compiler +uses when it decides whether to compile a lambda expression to a delegate or an expression tree. You can probably figure out where it goes from here: def myFunc4(f1: => Boolean)(f2: => Unit): Unit = ... -This takes two functions: a conditional expression, and a function that -takes no arguments and returns no value (in .NET terms, an `Action`). -Using our powers of anticipation, we can imagine how this might be called -using some unholy combination of the two syntaxes we saw for calling +This takes two functions: a conditional expression, and a function that +takes no arguments and returns no value (in .NET terms, an `Action`). +Using our powers of anticipation, we can imagine how this might be called +using some unholy combination of the two syntaxes we saw for calling `myFunc3`: val j = 123; myFunc4(j > 0) { println(j); j -= 1; } -We can mix and match the `()` and `{}` bracketing at whim, except that we -have to use `{}` bracketing if we want to batch up multiple expressions. +We can mix and match the `()` and `{}` bracketing at whim, except that we +have to use `{}` bracketing if we want to batch up multiple expressions. For example, you could legally equally well write the following: myFunc4 { j > 0 } { println(j); j -= 1; } @@ -804,9 +804,9 @@ myFunc5(f1)(f2) } -Written like this, it's clear that `f1` is getting evaluated each time we -execute the if statement, but is getting passed (as a function) when -`myFunc5` recurses. But Scala allows us to leave the parentheses off +Written like this, it's clear that `f1` is getting evaluated each time we +execute the if statement, but is getting passed (as a function) when +`myFunc5` recurses. But Scala allows us to leave the parentheses off function calls with no arguments, so we can write the above as: def myFunc5(f1: => Boolean)(f2: => Unit): Unit = @@ -815,18 +815,18 @@ myFunc5(f1)(f2) } -Again, type inference allows Scala to distinguish the *evaluation of -`f1`* in the if statement from the *passing of `f1`* in the `myFunc5` +Again, type inference allows Scala to distinguish the *evaluation of +`f1`* in the if statement from the *passing of `f1`* in the `myFunc5` recursion. -And with a bit of renaming, that's `myWhile`. There's no separate -*pass by name* convention: just the usual closure behaviour of capturing -local variables in an anonymous method or lambda, a bit of syntactic sugar -for nullary functions (functions with no arguments), just like C#'s -syntactic sugar for property getters, and the Scala compiler's ability to +And with a bit of renaming, that's `myWhile`. There's no separate +*pass by name* convention: just the usual closure behaviour of capturing +local variables in an anonymous method or lambda, a bit of syntactic sugar +for nullary functions (functions with no arguments), just like C#'s +syntactic sugar for property getters, and the Scala compiler's ability to recognise when a closure is required instead of a value. -In fact, armed with this understanding of the Scala "syntax," we can +In fact, armed with this understanding of the Scala "syntax," we can easily map it back to C#: void While(Func condition, Action body) @@ -837,7 +837,7 @@ While(condition, body); } } - + int i = 0; While(() => i < 10, () => { @@ -845,67 +845,67 @@ ++i; }); -The implementation of the `While` method in C# is, to my eyes, a bit -clearer than the Scala version. However, the syntax for *calling* the -`While` method in C# is clearly way more complicated and less natural than -the syntax for calling `myWhile` in Scala. Calling `myWhile` in Scala was -like using a native language construct. Calling While in C# required a -great deal of clutter at the call site to prevent C# from trying to treat +The implementation of the `While` method in C# is, to my eyes, a bit +clearer than the Scala version. However, the syntax for *calling* the +`While` method in C# is clearly way more complicated and less natural than +the syntax for calling `myWhile` in Scala. Calling `myWhile` in Scala was +like using a native language construct. Calling While in C# required a +great deal of clutter at the call site to prevent C# from trying to treat `i < 10` as a once-and-for-all value, and to express the body at all. -So that's so-called "pass by name" demystified: The Scala Web site, with -crushing mundanity, demotes it to "automatic type-dependent closure -construction," which is indeed exactly how it works. As we've seen, -however, this technical-sounding feature is actually essential to -creating nice syntax for your own control constructs. We'll shortly see -how this works together with other Scala features to give you even more +So that's so-called "pass by name" demystified: The Scala Web site, with +crushing mundanity, demotes it to "automatic type-dependent closure +construction," which is indeed exactly how it works. As we've seen, +however, this technical-sounding feature is actually essential to +creating nice syntax for your own control constructs. We'll shortly see +how this works together with other Scala features to give you even more flexibility in defining your construct's syntax. ### Implicits -Scala implicits offer some features which will be familiar to the C# -programmer, but are much more general in nature and go far beyond what can +Scala implicits offer some features which will be familiar to the C# +programmer, but are much more general in nature and go far beyond what can be done in C#. #### Enriching types in C# and Scala -Scala, like C#, is statically typed: a class’ methods are compiled into the -class definition and are not open for renegotiation. You cannot, as you -might in Ruby or Python, just go ahead and declare additional methods on an +Scala, like C#, is statically typed: a class’ methods are compiled into the +class definition and are not open for renegotiation. You cannot, as you +might in Ruby or Python, just go ahead and declare additional methods on an existing class. -This is of course very inconvenient. You end up declaring a load of -`FooHelper` or `FooUtils` classes full of static methods, and having to -write verbose calling code such as `if (EnumerableUtils.IsEmpty(sequence))` +This is of course very inconvenient. You end up declaring a load of +`FooHelper` or `FooUtils` classes full of static methods, and having to +write verbose calling code such as `if (EnumerableUtils.IsEmpty(sequence))` rather than the rather more readable `if (sequence.IsEmpty())`. -C# 3 tries to address this problem by introducing extension methods. -Extension methods are static methods in a `FooHelper` or `FooUtils` kind -of class, except you’re allowed to write them using member syntax. -By defining `IsEmpty` as an extension method on `IEnumerable`, you can +C# 3 tries to address this problem by introducing extension methods. +Extension methods are static methods in a `FooHelper` or `FooUtils` kind +of class, except you’re allowed to write them using member syntax. +By defining `IsEmpty` as an extension method on `IEnumerable`, you can write `if (sequence.IsEmpty())` after all. -Scala disapproves of static classes and global methods, so it plumps for -an alternative approach. You’ll still write a `FooHelper` or `FooUtils` -kind of class, but instead of taking the `Foo` to be Helped or Utilised as -a method parameter, your class will wrap `Foo` and enrich it with -additional methods. Let’s see this in action as we try to add a method to +Scala disapproves of static classes and global methods, so it plumps for +an alternative approach. You’ll still write a `FooHelper` or `FooUtils` +kind of class, but instead of taking the `Foo` to be Helped or Utilised as +a method parameter, your class will wrap `Foo` and enrich it with +additional methods. Let’s see this in action as we try to add a method to the `Double` type: - class RicherDouble(d : Double) { + class RicherDouble(d : Double) { def toThe(exp: Double): Double = System.Math.Pow(d, exp) } -(We call the class `RicherDouble` because Scala already has a `RichDouble` +(We call the class `RicherDouble` because Scala already has a `RichDouble` class defined which provides further methods to `Double`.) -Notice that `toThe` is an instance method, and that `RicherDouble` takes a -`Double` as a constructor parameter. This seems pretty grim, because we’d +Notice that `toThe` is an instance method, and that `RicherDouble` takes a +`Double` as a constructor parameter. This seems pretty grim, because we’d normally have to access the function like this: val result = new DoubleExtensions(2.0).toThe(7.0) -Hardly readable. To make it look nice, Scala requires us to define an +Hardly readable. To make it look nice, Scala requires us to define an *implicit conversion* from `Double` to `RicherDouble`: object Implicits { @@ -920,31 +920,31 @@ val twoToTheSeven = 2.0.toThe(7.0) -and all will be well. The `Double` type has apparently been successfully +and all will be well. The `Double` type has apparently been successfully enriched with the `toThe` method. -This is, of course, just as much an illusion as the C# equivalent. -C# extension methods don’t add methods to a type, and nor do Scala -implicit conversions. What has happened here is that the Scala compiler -has looked around for implicit methods that are applicable to the type of -`2.0` (namely `Double`), and return a type that has a `toThe` method. -Our `Implicits.richerDouble` method fits the bill, so the Scala compiler -silently inserts a call to that method. At runtime, therefore, Scala calls -`Implicits.richerDouble(2.0)` and calls the `toThe` of the resulting +This is, of course, just as much an illusion as the C# equivalent. +C# extension methods don’t add methods to a type, and nor do Scala +implicit conversions. What has happened here is that the Scala compiler +has looked around for implicit methods that are applicable to the type of +`2.0` (namely `Double`), and return a type that has a `toThe` method. +Our `Implicits.richerDouble` method fits the bill, so the Scala compiler +silently inserts a call to that method. At runtime, therefore, Scala calls +`Implicits.richerDouble(2.0)` and calls the `toThe` of the resulting `RicherDouble`. -If setting this up seems a bit verbose, well, maybe. C# extension methods -are designed to be easily – one might even say implicitly – brought into -scope. That’s very important for operators like the LINQ standard query -operators, but it can result in unwanted extension methods being dragged -into scope and causing havoc. Scala requires the caller to be a bit more -explicit about implicits, which results in a slightly higher setup cost but +If setting this up seems a bit verbose, well, maybe. C# extension methods +are designed to be easily – one might even say implicitly – brought into +scope. That’s very important for operators like the LINQ standard query +operators, but it can result in unwanted extension methods being dragged +into scope and causing havoc. Scala requires the caller to be a bit more +explicit about implicits, which results in a slightly higher setup cost but gives the caller finer control over which implicit methods are considered. -But as it happens you can avoid the need for separate definitions of -`Implicits` and `RicherDouble`, and get back to a more concise -representation by using an anonymous class. (As you’d expect, Scala -anonymous classes are fully capable, like Java ones, rather than the +But as it happens you can avoid the need for separate definitions of +`Implicits` and `RicherDouble`, and get back to a more concise +representation by using an anonymous class. (As you’d expect, Scala +anonymous classes are fully capable, like Java ones, rather than the neutered C# version.) Here’s how it looks: object Implicits { @@ -953,69 +953,69 @@ } } -Well, big deal. Scala can enrich existing types with new methods just like -C#, but using a different syntax. In related news, Lisp uses a different -kind of bracket: film at eleven. Why should we be interested in Scala +Well, big deal. Scala can enrich existing types with new methods just like +C#, but using a different syntax. In related news, Lisp uses a different +kind of bracket: film at eleven. Why should we be interested in Scala implicits if they’re just another take on extension methods? #### Implicit Parameters -What we saw above was an implicit method – a method which, like a C# -implicit conversion operator, the compiler is allowed to insert a call to -without the programmer writing that call. Scala also has the idea of -implicit parameters – that is, parameters which the compiler is allowed to +What we saw above was an implicit method – a method which, like a C# +implicit conversion operator, the compiler is allowed to insert a call to +without the programmer writing that call. Scala also has the idea of +implicit parameters – that is, parameters which the compiler is allowed to insert a value for without the programmer specifying that value. -That’s just optional parameters with default values, right? Like C++ and -Visual Basic have had since “visual” meant ASCII art on a teletype, and +That’s just optional parameters with default values, right? Like C++ and +Visual Basic have had since “visual” meant ASCII art on a teletype, and like C# is about to get? Well, no. -C++, Visual Basic and C# optional parameters have fixed defaults specified +C++, Visual Basic and C# optional parameters have fixed defaults specified by the called function. For example, if you have a method like this: public void Fie(int a, int b = 123) { … } -and you call `Fie(456)`, it’s always going to be equivalent to calling +and you call `Fie(456)`, it’s always going to be equivalent to calling `Fie(456, 123)`. -A Scala implicit parameter, on the other hand, gets its value from the -calling context. That allows programmer calling the method to control the -implicit parameter value, creating an extensibility point that optional +A Scala implicit parameter, on the other hand, gets its value from the +calling context. That allows programmer calling the method to control the +implicit parameter value, creating an extensibility point that optional parameters don’t provide. -This probably all sounds a bit weird, so let’s look at an example. Consider +This probably all sounds a bit weird, so let’s look at an example. Consider the following `Concatenate` method: public T Concatenate(IEnumerable sequence, T seed, Func concatenator); -We pass this guy a sequence, a start value and a function that combines two -values into one, and it returns the result of calling that function across -the sequence. For example, you could pass a sequence of strings, a start -value of `String.Empty`, and `(s1, s2) => s1 + s2`, and it would return you +We pass this guy a sequence, a start value and a function that combines two +values into one, and it returns the result of calling that function across +the sequence. For example, you could pass a sequence of strings, a start +value of `String.Empty`, and `(s1, s2) => s1 + s2`, and it would return you all the strings concatenated together: IEnumerable sequence = new string[] { “mog”, “bites”, “man” }; string result = Concatenate(sequence, String.Empty, (s1, s2) => s1 + s2); // result is “mogbitesman” -But this is a unpleasantly verbose. We’re having to pass in `String.Empty` -and `(s1, s2) => s1 + s2` every time we want to concatenate a sequence of -strings. Not only is this tedious, it also creates the opportunity for -error when the boss decides to “help” and passes the literal -`"String.Empty"` as the seed value instead. (“Oh, and I upgraded all the -semi-colons to colons while I was in there. No, don’t thank me!”) We’d -like to just tell the Concatenate function, “Look, this is how you +But this is a unpleasantly verbose. We’re having to pass in `String.Empty` +and `(s1, s2) => s1 + s2` every time we want to concatenate a sequence of +strings. Not only is this tedious, it also creates the opportunity for +error when the boss decides to “help” and passes the literal +`"String.Empty"` as the seed value instead. (“Oh, and I upgraded all the +semi-colons to colons while I was in there. No, don’t thank me!”) We’d +like to just tell the Concatenate function, “Look, this is how you concatenate strings,” once and for all. -Let’s start out by redefining the `Concatenate` method in Scala. -I’m going to factor out the seed and the concatenator method into a trait +Let’s start out by redefining the `Concatenate` method in Scala. +I’m going to factor out the seed and the concatenator method into a trait because we’ll typically be defining them together. trait Concatenator[T] { def startValue: T def concat(x: T, y: T): T } - + object implicitParameters { def concatenate[T](xs: List[T])(c: Concatenator[T]): T = if (xs.isEmpty) c.startValue @@ -1028,7 +1028,7 @@ def startValue: String = "" def concat(x: String, y: String) = x.concat(y) } - + object implicitParameters { def main(args: Array[String]) = { val result = concatenate(List("mog", "bites", "man"))(stringConcatenator) @@ -1036,21 +1036,21 @@ } } -So far, this looks like the C# version except for the factoring out of the -`Concatenator` trait. We’re still having to pass in the +So far, this looks like the C# version except for the factoring out of the +`Concatenator` trait. We’re still having to pass in the `stringConcatenator` at the point of the call. Let’s fix that: def concatenate[T](xs: List[T])(implicit c: Concatenator[T]): T = if (xs.isEmpty) c.startValue else c.concat(xs.head, concatenate(xs.tail)) -We’ve changed two things here. First, we’ve declared c to be an *implicit -parameter*, meaning the caller can leave it out. Second, we’ve left +We’ve changed two things here. First, we’ve declared c to be an *implicit +parameter*, meaning the caller can leave it out. Second, we’ve left it out ourselves, in the recursive call to `concatenate(xs.tail)`. -Well, okay, it’s nice that `concatenate` now doesn’t have to pass the -`Concatenator` explicitly to the recursive call, but we’re still having to -pass in the `stringConcatenator` object to get things started. If only +Well, okay, it’s nice that `concatenate` now doesn’t have to pass the +`Concatenator` explicitly to the recursive call, but we’re still having to +pass in the `stringConcatenator` object to get things started. If only there were some way to make the `stringConcatenator` object itself implicit… object Implicits { @@ -1060,16 +1060,16 @@ } } -Again, we’ve done two things here. First, we’ve declared the -`stringConcatenator` object implicit. Consequently, we’ve had to move it -out of the top level, because Scala doesn’t allow implicits at the top -level (because they’d pollute the global namespace, being in scope even +Again, we’ve done two things here. First, we’ve declared the +`stringConcatenator` object implicit. Consequently, we’ve had to move it +out of the top level, because Scala doesn’t allow implicits at the top +level (because they’d pollute the global namespace, being in scope even without an explicit import statement). Now we can call `concatenate` like this: import Implicits._ - + object implicitParameters { def main(args: Array[String]) = { val result = concatenate(List("mog", "bites", "man")) @@ -1079,10 +1079,10 @@ And we’ll still get “mogbitesman” as the output. -Let’s review what’s going on here. The implicit parameter of concatenate -has been set to our `stringConcatenator`, a default value that the -`concatenate` method knew nothing about when it was compiled. This is -somewhere north of what classical optional parameters are capable of, +Let’s review what’s going on here. The implicit parameter of concatenate +has been set to our `stringConcatenator`, a default value that the +`concatenate` method knew nothing about when it was compiled. This is +somewhere north of what classical optional parameters are capable of, and we’re not finished yet. Let’s build a `listConcatenator`. object Implicits { @@ -1093,14 +1093,14 @@ implicit object stringListConcatenator extends ListConcatenator[String] { } } -This is a bit vexing. `List` in Scala is a generic type, and has a generic -concatenation method called `:::`. But we can’t create a generic object, -because an object is an instance. And implicit parameters have to be objects. -So the best we can do is build a generic `ListConcatenator` class, and then -create trivial implicit objects for each generic parameter type we might +This is a bit vexing. `List` in Scala is a generic type, and has a generic +concatenation method called `:::`. But we can’t create a generic object, +because an object is an instance. And implicit parameters have to be objects. +So the best we can do is build a generic `ListConcatenator` class, and then +create trivial implicit objects for each generic parameter type we might need. -However, let’s not worry about the implementation, and see how this is used +However, let’s not worry about the implementation, and see how this is used at the calling end: val result = concatenate(List( @@ -1108,109 +1108,109 @@ List("on", "beard") )) -This displays `List(mog, bites, man, on, beard)`; that is, it concatenates -the two `List[String]`s into one. Once again, we have not had to pass -`stringListConcatenator` explicitly: the Scala compiler has gone and found -it for us. We can use the exact same calling code to concatenate lists and +This displays `List(mog, bites, man, on, beard)`; that is, it concatenates +the two `List[String]`s into one. Once again, we have not had to pass +`stringListConcatenator` explicitly: the Scala compiler has gone and found +it for us. We can use the exact same calling code to concatenate lists and strings. #### Why Should I Care? -Isn’t this pointless? At the call site, I have access to -`stringConcatenator` and `listStringConcatenator`. I can easily pass them +Isn’t this pointless? At the call site, I have access to +`stringConcatenator` and `listStringConcatenator`. I can easily pass them in rather than relying on spooky compiler magic to do it for me. Aren’t implicit parameters just job security for compiler writers? -Yes, implicit parameters are technically unnecessary. But if we’re going -to play that game, C# is technically unnecessary. You could write all that -code in IL. Extension methods are unnecessary because you could write the -static method out longhand. Optional parameters are unnecessary because -you could read the documentation and pass them in explicitly. -Post-It notes are unnecessary because you could fire up Outlook and create +Yes, implicit parameters are technically unnecessary. But if we’re going +to play that game, C# is technically unnecessary. You could write all that +code in IL. Extension methods are unnecessary because you could write the +static method out longhand. Optional parameters are unnecessary because +you could read the documentation and pass them in explicitly. +Post-It notes are unnecessary because you could fire up Outlook and create a Note instead. -Implicit parameters are about convenience and expressiveness. Implicit -parameters give you a way of describing how a function should handle -different situations, without needing to bake those situations into the +Implicit parameters are about convenience and expressiveness. Implicit +parameters give you a way of describing how a function should handle +different situations, without needing to bake those situations into the function logic or to specify them every time you call the function. -You don’t want to have to tell the `concatenate` function whether to use -the `List` or `String` concatenator every time you call it: the compiler -knows what you’re concatenating; specifying how to concatenate it just +You don’t want to have to tell the `concatenate` function whether to use +the `List` or `String` concatenator every time you call it: the compiler +knows what you’re concatenating; specifying how to concatenate it just gives you a chance to get it wrong! -Consequently, implicit parameters – like implicit conversions – contribute -to Scala’s ability to support internal DSLs. By setting up appropriate -implicits, you can write code that reads much more naturally than if you +Consequently, implicit parameters – like implicit conversions – contribute +to Scala’s ability to support internal DSLs. By setting up appropriate +implicits, you can write code that reads much more naturally than if you had to pepper it with function objects or callbacks. #### Conclusion -Scala’s `implicit` keyword goes beyond C#’s equivalent. As in C#, it is -used for implicit conversions; unlike C#, this is the idiomatic way to add -operations to an existing type, removing the need for the separate -extension method syntax. Implicit parameters have no equivalent in C#. -They are like being able to add default values to a method: just as a C# -using statement bring implicit methods into scope, a Scala import statement -can bring default values into scope. If implicit conversions are a way of -extending classes, then implicit parameters are a way of extending methods, -creating simple, reliable shorthands for complex generic methods, and +Scala’s `implicit` keyword goes beyond C#’s equivalent. As in C#, it is +used for implicit conversions; unlike C#, this is the idiomatic way to add +operations to an existing type, removing the need for the separate +extension method syntax. Implicit parameters have no equivalent in C#. +They are like being able to add default values to a method: just as a C# +using statement bring implicit methods into scope, a Scala import statement +can bring default values into scope. If implicit conversions are a way of +extending classes, then implicit parameters are a way of extending methods, +creating simple, reliable shorthands for complex generic methods, and making up another piece of the Scala DSL jigsaw. #### Method Call Syntax -C#, like most object-oriented programming languages, is pretty strict about -how you call methods: you use the dot notation, unless the method is a -special ‘operator’ method such as `operator+`, `operator==` or a conversion -operator. The special operator methods are predefined by the compiler: you -can write your own implementation, but you can’t create your own operator -names. You can teach the `+` operator how to handle your custom type, but +C#, like most object-oriented programming languages, is pretty strict about +how you call methods: you use the dot notation, unless the method is a +special ‘operator’ method such as `operator+`, `operator==` or a conversion +operator. The special operator methods are predefined by the compiler: you +can write your own implementation, but you can’t create your own operator +names. You can teach the `+` operator how to handle your custom type, but you can’t add an exponentiation operator: int a = b ** c; -C# has three problems with this: first, it doesn’t like the method name -`**`; second, it doesn’t like that there’s no `.` before the name; and +C# has three problems with this: first, it doesn’t like the method name +`**`; second, it doesn’t like that there’s no `.` before the name; and third, it doesn’t like that there’s no brackets around the method argument. -To get around the objection to the name, let’s compromise and call it +To get around the objection to the name, let’s compromise and call it `ToThe` for now. So what C# insists on seeing is `a.ToThe(b)`. -Scala, like many functional languages, isn’t so strict. Scala allows you -to use any method with a single argument in an infix position. Before we -can see this in the exponentiation example, we will enrich the `Double` +Scala, like many functional languages, isn’t so strict. Scala allows you +to use any method with a single argument in an infix position. Before we +can see this in the exponentiation example, we will enrich the `Double` type with the `toThe` method as we learned earlier: import Implicits._ import math._ - + class RicherDouble(d: Double) { def toThe(exp: Double): Double = pow(d, exp) } - + object Implicits { implicit def richerDouble(d: Double) = new RicherDouble(d) } -Recall that this is just the Scala idiom for extension methods – it’s the -equivalent of writing -`public static ToThe(this double first, double second) { … }` in C#. -(If we were wanting to use infix notation with our own class, we wouldn’t +Recall that this is just the Scala idiom for extension methods – it’s the +equivalent of writing +`public static ToThe(this double first, double second) { … }` in C#. +(If we were wanting to use infix notation with our own class, we wouldn’t need all this malarkey.) So now we can write: val raised = 2.0.toThe(7.0) -Okay, so what do we need to do to get this to work in infix position? +Okay, so what do we need to do to get this to work in infix position? Nothing, it turns out. val raised = 2.0 toThe 8.0 // it just works -This still doesn’t look much like a built-in operator, but it turns out +This still doesn’t look much like a built-in operator, but it turns out Scala is less fussy than C# about method names too. - class DoubleExtensions(d : Double) { + class DoubleExtensions(d : Double) { def **(exp: Double): Double = Pow(d, exp) } - + val raised = 2.0 ** 9.0 // it still just works Much nicer. @@ -1220,16 +1220,15 @@ class RicherString(s: String) { def twice: String = s + s } - + val drivel = "bibble" twice -Calling methods in infix and postfix nodadion is obviously fairly simple -syntactic sugar over normal dot notation. But this seemingly minor feature -is very important in constructing DSLs, allowing Scala to do in internal -DSLs what many languages can do only using external tools. For example, -where most languages do parsing via an external file format and a tool to -translate that file format into native code (a la `lex` and `yacc`), -Scala’s parser library makes extensive use of infix and postfix methods to -provide a “traditional” syntax for describing a parser, but manages it +Calling methods in infix and postfix nodadion is obviously fairly simple +syntactic sugar over normal dot notation. But this seemingly minor feature +is very important in constructing DSLs, allowing Scala to do in internal +DSLs what many languages can do only using external tools. For example, +where most languages do parsing via an external file format and a tool to +translate that file format into native code (a la `lex` and `yacc`), +Scala’s parser library makes extensive use of infix and postfix methods to +provide a “traditional” syntax for describing a parser, but manages it entirely within the Scala language. - diff --git a/_ru/index.md b/_ru/index.md index 9a3ba61e88..3a3cf3a918 100644 --- a/_ru/index.md +++ b/_ru/index.md @@ -1,5 +1,5 @@ --- -layout: inner-page-documentation +layout: landing-page title: Изучаем Scala language: ru partof: documentation @@ -93,4 +93,4 @@ sections: description: "От начала до конца: узнайте, как вы можете помочь открытой экосистеме Scala." icon: "fa fa-code-branch" link: /contribute/ ---- \ No newline at end of file +--- diff --git a/_sass/base/helper.scss b/_sass/base/helper.scss index 5a53ee033a..8b6f9c46d2 100755 --- a/_sass/base/helper.scss +++ b/_sass/base/helper.scss @@ -20,10 +20,14 @@ background: #fff; -webkit-box-shadow: 0 0 18px 20px #fff; -moz-box-shadow: 0 0 18px 20px #fff; - box-shadow: 0 7px 15px 5px #fff; + box-shadow: 0 0 18px 20px #fff; z-index: 5; } +.inline-sticky-top.inline-sticky-top-higher { + z-index: 7; +} + .wrap-inline { // add vertical padding @include outer-container; diff --git a/_sass/components/wip-notice.scss b/_sass/components/wip-notice.scss index b4a011e9fa..3c84c75ac0 100644 --- a/_sass/components/wip-notice.scss +++ b/_sass/components/wip-notice.scss @@ -2,7 +2,8 @@ position: relative; top: 1em; padding: 1em; - background: rgba(255,255,255,0.7); + border-radius: 5px; + background: $gray-light; a { color: $brand-primary; diff --git a/_sips/sips/fewer-braces.md b/_sips/sips/fewer-braces.md index 4d1f9c1091..d3aac00417 100644 --- a/_sips/sips/fewer-braces.md +++ b/_sips/sips/fewer-braces.md @@ -293,4 +293,3 @@ This is a tradeoff between conciseness and consistency. In the interest of minim - Latest discussion on contributors (there were several before when we discussed indentation in general): https://contributors.scala-lang.org/t/make-fewerbraces-available-outside-snapshot-releases/5024/166 ## FAQ - diff --git a/_tour/basics.md b/_tour/basics.md index 8118507637..5230a0e482 100644 --- a/_tour/basics.md +++ b/_tour/basics.md @@ -83,7 +83,7 @@ val x: Int = 1 + 1 {% endtab %} {% endtabs %} -Notice how the type declaration `Int` comes after the identifier `x`. You also need a `:`. +Notice how the type declaration `Int` comes after the identifier `x`. You also need a `:`. ### Variables @@ -236,7 +236,7 @@ println(getSquareString(2.5)) // 6.25 def getSquareString(input: Double): String = val square = input * input square.toString - + println(getSquareString(2.5)) // 6.25 ``` {% endtab %} diff --git a/_uk/index.md b/_uk/index.md index 81ea875030..375daaba5d 100644 --- a/_uk/index.md +++ b/_uk/index.md @@ -1,5 +1,5 @@ --- -layout: inner-page-documentation +layout: landing-page title: Документація language: uk partof: documentation diff --git a/_zh-cn/index.md b/_zh-cn/index.md index 4b0b3d0e34..fedb5b7c5b 100644 --- a/_zh-cn/index.md +++ b/_zh-cn/index.md @@ -1,5 +1,5 @@ --- -layout: inner-page-documentation +layout: landing-page language: zh-cn title: 学习 Scala namespace: root diff --git a/_zh-cn/overviews/index.md b/_zh-cn/overviews/index.md index 38b8dc4ba2..a051fef550 100644 --- a/_zh-cn/overviews/index.md +++ b/_zh-cn/overviews/index.md @@ -3,6 +3,8 @@ layout: overviews language: zh-cn partof: overviews title: 目录 +redirect_from: + - /zh-cn/scala3/guides.html --- diff --git a/_zh-cn/overviews/thanks.md b/_zh-cn/overviews/thanks.md index e1429b74f0..e2fac4be7a 100644 --- a/_zh-cn/overviews/thanks.md +++ b/_zh-cn/overviews/thanks.md @@ -1,7 +1,8 @@ --- -layout: inner-page-no-masthead +layout: singlepage-overview language: zh-cn title: 致谢名单 +orphanTranslation: true --- 2013年10月份起，CSDN CODE开始组织志愿者翻译Scala官方文档。计划翻译的文档主要为Scala官网上overview部分的内容，包含以下部分： diff --git a/_zh-cn/scala3/guides.md b/_zh-cn/scala3/guides.md deleted file mode 100644 index 5a656b5a4d..0000000000 --- a/_zh-cn/scala3/guides.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -layout: inner-page-parent -title: Guides on Scala 3 -language: zh-cn -scala3: true - -guides: - - title: "从 Scala 2 到 Scala 3 的迁移" - icon: suitcase - url: "/scala3/guides/migration/compatibility-intro.html" - description: "迁移至 Scala 3 的兼容性须知" - - title: 宏 - by: Nicolas Stucki - icon: magic - url: "/scala3/guides/macros" - description: "覆盖 Scala 3 中涉及到编写宏的所有特性的详细导引" - label-text: 特性 - - title: TASTy 概览 - by: Alvin Alexander - icon: birthday-cake - url: "/scala3/guides/tasty-overview.html" - description: "针对 Scala 语言最终用户的 TASTy 格式概览" - - title: "贡献指南" - by: Jamie Thompson, Anatolii Kmetiuk - icon: cogs - url: "/scala3/guides/contribution/contribution-intro.html" - description: "Scala 3 编译器指南及如何贡献代码" - - title: Scaladoc - by: Krzysztof Romanowski, Aleksander Boruch-Gruszecki, Andrzej Ratajczak, Kacper Korban, Filip Zybała - icon: book - url: "/scala3/guides/scaladoc" - description: "Scala 的 API 文档生成工具" ---- - -
    -
    -
    -
    -

    概览与导引

    -

    - Scala 3 语言及其特性的详细导引 -

    -{% include scala3-guides-card-group.html %} -
    -
    -
    -
    diff --git a/_zh-cn/thanks.md b/_zh-cn/thanks.md index e1429b74f0..e2fac4be7a 100644 --- a/_zh-cn/thanks.md +++ b/_zh-cn/thanks.md @@ -1,7 +1,8 @@ --- -layout: inner-page-no-masthead +layout: singlepage-overview language: zh-cn title: 致谢名单 +orphanTranslation: true --- 2013年10月份起，CSDN CODE开始组织志愿者翻译Scala官方文档。计划翻译的文档主要为Scala官网上overview部分的内容，包含以下部分： diff --git a/api/all.md b/api/all.md index df590222cb..b9ced56bf8 100644 --- a/api/all.md +++ b/api/all.md @@ -2,6 +2,8 @@ layout: singlepage-overview title: Scala API Docs includeTOC: true +redirect_from: + - /reference.html --- ## Latest releases diff --git a/books.md b/books.md index 0bdfff3358..8e38462300 100644 --- a/books.md +++ b/books.md @@ -1,6 +1,6 @@ --- title: Books -layout: inner-page +layout: basic-index redirect_from: - /documentation/books.html --- diff --git a/guides.md b/guides.md deleted file mode 100644 index 98700b64b3..0000000000 --- a/guides.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: inner-page-no-masthead -title: Guides and Overviews -languages: [ja, zh-cn, es, ru] - ---- diff --git a/index.md b/index.md index bf1dda539c..4f97d4d051 100644 --- a/index.md +++ b/index.md @@ -1,6 +1,7 @@ --- -layout: inner-page-documentation +layout: landing-page languages: [ja, zh-cn, ru, uk] + title: Learn Scala namespace: root discourse: true diff --git a/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md b/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md index c52618024d..c6c40c21ca 100644 --- a/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md +++ b/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md @@ -1,5 +1,5 @@ --- -layout: inner-page-no-masthead +layout: singlepage-overview title: "Functional Programming Principles in Scala: Impressions and Statistics" --- ###### By Heather Miller and Martin Odersky diff --git a/reference.md b/reference.md deleted file mode 100644 index e7a837825e..0000000000 --- a/reference.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -layout: inner-page-no-masthead -sitemap: false -permalink: /reference.html -redirect_to: /api/all.html ---- diff --git a/scala3/contribute-to-docs.md b/scala3/contribute-to-docs.md index 2a9795cada..ca9201c5b4 100644 --- a/scala3/contribute-to-docs.md +++ b/scala3/contribute-to-docs.md @@ -2,7 +2,7 @@ layout: singlepage-overview overview-name: "Scala 3 Documentation" title: Contributing to the Docs -languages: ["ru"] +languages: ["ja", "ru"] --- ## Overview There are several ongoing efforts to produce high quality documentation for diff --git a/tutorials.md b/tutorials.md index 7cffa28385..17ade963ba 100644 --- a/tutorials.md +++ b/tutorials.md @@ -1,5 +1,5 @@ --- -layout: inner-page-parent +layout: root-index-layout title: Tutorials tutorials: From 847b6bffa01e592c29628886e6b90c9ee78b810f Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Fri, 18 Nov 2022 00:28:03 +0000 Subject: [PATCH 2393/3075] Update SIPs state --- _sips/sips/fewer-braces.md | 1 + 1 file changed, 1 insertion(+) diff --git a/_sips/sips/fewer-braces.md b/_sips/sips/fewer-braces.md index d3aac00417..4d1f9c1091 100644 --- a/_sips/sips/fewer-braces.md +++ b/_sips/sips/fewer-braces.md @@ -293,3 +293,4 @@ This is a tradeoff between conciseness and consistency. In the interest of minim - Latest discussion on contributors (there were several before when we discussed indentation in general): https://contributors.scala-lang.org/t/make-fewerbraces-available-outside-snapshot-releases/5024/166 ## FAQ + From 3e44f15cb2b9ac6633f5745df6aaccd6eebe23b0 Mon Sep 17 00:00:00 2001 From: Artem Korsakov Date: Fri, 18 Nov 2022 11:46:46 +0300 Subject: [PATCH 2394/3075] Fix orphan translation (#2638) --- _includes/sidebar-toc-multipage-overview.html | 3 ++- _includes/sidebar-toc-singlepage-overview.html | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/_includes/sidebar-toc-multipage-overview.html b/_includes/sidebar-toc-multipage-overview.html index 9f1feb5636..ce42167c98 100644 --- a/_includes/sidebar-toc-multipage-overview.html +++ b/_includes/sidebar-toc-multipage-overview.html @@ -40,6 +40,7 @@
    Contents
    {% endfor %} + {% assign orphanTranslation = page.orphanTranslation | default: false %} {% if page.languages %} - {% elsif page.language and page.orphanTranslation == false %} + {% elsif page.language and orphanTranslation == false %} {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} {% assign engPg = site.overviews | where: 'partof', page.partof | first %} diff --git a/_includes/sidebar-toc-singlepage-overview.html b/_includes/sidebar-toc-singlepage-overview.html index 49d2a6971c..cead129be1 100644 --- a/_includes/sidebar-toc-singlepage-overview.html +++ b/_includes/sidebar-toc-singlepage-overview.html @@ -3,6 +3,7 @@
    Contents
    diff --git a/_overviews/scala3-book/scala-tools.md b/_overviews/scala3-book/scala-tools.md index 1b6badd809..230f7b74ae 100644 --- a/_overviews/scala3-book/scala-tools.md +++ b/_overviews/scala3-book/scala-tools.md @@ -3,7 +3,7 @@ title: Scala Tools type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. languages: [zh-cn] -num: 69 +num: 68 previous-page: concurrency next-page: tools-sbt --- diff --git a/_overviews/scala3-book/tools-sbt.md b/_overviews/scala3-book/tools-sbt.md index 8735cbce68..6fd9897a29 100644 --- a/_overviews/scala3-book/tools-sbt.md +++ b/_overviews/scala3-book/tools-sbt.md @@ -3,7 +3,7 @@ title: Building and Testing Scala Projects with sbt type: section description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. languages: [zh-cn] -num: 70 +num: 69 previous-page: scala-tools next-page: tools-worksheets --- diff --git a/_overviews/scala3-book/tools-worksheets.md b/_overviews/scala3-book/tools-worksheets.md index 5c8dacf3e5..92f7fd66ca 100644 --- a/_overviews/scala3-book/tools-worksheets.md +++ b/_overviews/scala3-book/tools-worksheets.md @@ -3,7 +3,7 @@ title: Worksheets type: section description: This section looks at worksheets, an alternative to Scala projects. languages: [zh-cn] -num: 71 +num: 70 previous-page: tools-sbt next-page: interacting-with-java --- diff --git a/_overviews/scala3-book/types-type-classes.md b/_overviews/scala3-book/types-type-classes.md deleted file mode 100644 index 19c20fba89..0000000000 --- a/_overviews/scala3-book/types-type-classes.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Type Classes -type: section -description: This section introduces type classes in Scala 3. -languages: [zh-cn] -num: 60 -previous-page: ca-given-using-clauses -next-page: ca-context-bounds ---- - -A _type class_ is an abstract, parameterized type that lets you add new behavior to any closed data type without using sub-typing. -If you are coming from Java, you can think of type classes as something like [`java.util.Comparator[T]`][comparator]. - -> The paper [“Type Classes as Objects and Implicits”][typeclasses-paper] (2010) by Oliveira et al. discusses the basic ideas behind type classes in Scala. -> Even though the paper uses an older version of Scala, the ideas still hold to the current day. - -This style of programming is useful in multiple use-cases, for example: - -- Expressing how a type you don’t own---such as from the standard library or a third-party library---conforms to such behavior -- Adding behavior to multiple types without introducing sub-typing relationships between those types (i.e., one `extends` another) - -In Scala 3, _type classes_ are just _traits_ with one or more type parameters, like the following: -``` -trait Show[A]: - def show(a: A): String -``` -Instances of `Show` for a particular type `A` witness that we can show (i.e., produce a text representation of) an instance of type `A`. -For example, let’s look at the following `Show` instance for `Int` values: - -```scala -class ShowInt extends Show[Int]: - def show(a: Int) = s"The number is ${a}!" -``` -We can write methods that work on arbitrary types `A` _constrained_ by `Show` as follows: - -```scala -def toHtml[A](a: A)(showA: Show[A]): String = - "

    " + showA.show(a) + "

    " -``` -That is, `toHtml` can be called with arbitrary `A` _as long_ as you can also provide an instance of `Show[A]`. -For example, we can call it like: -```scala -toHtml(42)(ShowInt()) -// results in "

    The number is 42!

    " -``` - -#### Automatically passing type class instances -Since type classes are a very important way to structure software, Scala 3 offers additional features that make working with them very convenient. -We discuss these additional features (which fall into the category of *Contextual Abstractions*) in a [later chapter][typeclasses-chapter] of this book. - -[typeclasses-paper]: https://infoscience.epfl.ch/record/150280/files/TypeClasses.pdf -[typeclasses-chapter]: {% link _overviews/scala3-book/ca-type-classes.md %} -[comparator]: https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html diff --git a/_overviews/scala3-book/where-next.md b/_overviews/scala3-book/where-next.md index 43e9ec8424..41bdf27255 100644 --- a/_overviews/scala3-book/where-next.md +++ b/_overviews/scala3-book/where-next.md @@ -3,9 +3,9 @@ title: Where To Go Next type: chapter description: Where to go next after reading the Scala Book languages: [zh-cn] -num: 76 +num: 75 previous-page: scala-for-python-devs -next-page: +next-page: --- We hope you enjoyed this introduction to the Scala programming language, and we also hope we were able to share some of the beauty of the language. From d8f1ca2c570ddd3bbf8b28c722419c5360322099 Mon Sep 17 00:00:00 2001 From: Yael Bakker Date: Fri, 16 Dec 2022 14:09:43 +0100 Subject: [PATCH 2422/3075] fix a typo --- _overviews/scala3-book/domain-modeling-fp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/domain-modeling-fp.md b/_overviews/scala3-book/domain-modeling-fp.md index f141548bb0..6942cd124c 100644 --- a/_overviews/scala3-book/domain-modeling-fp.md +++ b/_overviews/scala3-book/domain-modeling-fp.md @@ -748,7 +748,7 @@ implicit class PizzaOps(p: Pizza) { ``` In the above code, we define the different methods on pizzas as methods in an _implicit class_. With `implicit class PizzaOps(p: Pizza)` then wherever `PizzaOps` is imported its methods will be available on -instances of `Pizza`. The reciever in this case is `p`. +instances of `Pizza`. The receiver in this case is `p`. {% endtab %} {% tab 'Scala 3' for=module_7 %} From 033e75b380cb64fcc73434be4e78109f9567d6fd Mon Sep 17 00:00:00 2001 From: Doehyun Baek Date: Tue, 20 Dec 2022 21:22:46 +0900 Subject: [PATCH 2423/3075] fix link to correct address. Two links in scala-for-java-programmers.md were misconfigured. I tested the change locally. --- _overviews/tutorials/scala-for-java-programmers.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index 8a2e67084f..e6678ef729 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -26,11 +26,11 @@ next_resources: - title: Scala Book description: Learn Scala by reading a series of short lessons. icon: "fa fa-book-open" - link: /scala3/book/scala-for-java-devs.html + link: /scala3/book/introduction.html - title: Online Courses description: MOOCs to learn Scala, for beginners and experienced programmers. icon: "fa fa-cloud" - link: /scala3/book/scala-for-java-devs.html + link: /online-courses.html --- If you are coming to Scala with some Java experience already, this page should give a good overview of From e9c624b7de50e12a39ad9c9e4987f4b88e110631 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Thu, 22 Dec 2022 00:21:42 +0000 Subject: [PATCH 2424/3075] Update SIPs state --- ...nary-compatibility-of-the-scala-213-standard-library.md | 7 +++++++ _sips/sips/struct-classes.md | 3 +-- 2 files changed, 8 insertions(+), 2 deletions(-) create mode 100644 _sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md diff --git a/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md b/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md new file mode 100644 index 0000000000..0e1f095a3d --- /dev/null +++ b/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md @@ -0,0 +1,7 @@ +--- +title: SIP-51 - Drop Forwards Binary Compatibility of the Scala 2.13 Standard Library +status: under-review +pull-request-number: 54 +stage: design + +--- diff --git a/_sips/sips/struct-classes.md b/_sips/sips/struct-classes.md index a17dca1324..a9109fd45b 100644 --- a/_sips/sips/struct-classes.md +++ b/_sips/sips/struct-classes.md @@ -1,7 +1,6 @@ --- title: SIP-50 - Struct Classes -status: under-review +status: withdrawn pull-request-number: 50 -stage: design --- From 8f3d3df1602a4e07df2e9b26e91771ac6683496c Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Thu, 29 Dec 2022 22:38:09 +0800 Subject: [PATCH 2425/3075] add languages field in scala3-book. --- .../scala3-book/ca-context-bounds.md | 1 + .../ca-contextual-abstractions-intro.md | 1 + .../scala3-book/ca-extension-methods.md | 1 + .../overviews/scala3-book/ca-given-imports.md | 1 + .../scala3-book/ca-given-using-clauses.md | 1 + .../scala3-book/ca-implicit-conversions.md | 1 + .../scala3-book/ca-multiversal-equality.md | 1 + _zh-cn/overviews/scala3-book/ca-summary.md | 1 + .../overviews/scala3-book/ca-type-classes.md | 1 + .../scala3-book/collections-classes.md | 3 + .../scala3-book/collections-intro.md | 1 + .../scala3-book/collections-methods.md | 1 + .../scala3-book/collections-summary.md | 1 + _zh-cn/overviews/scala3-book/concurrency.md | 1 + .../scala3-book/control-structures.md | 1 + .../scala3-book/domain-modeling-fp.md | 1 + .../scala3-book/domain-modeling-intro.md | 1 + .../scala3-book/domain-modeling-oop.md | 1 + .../scala3-book/domain-modeling-tools.md | 1 + .../scala3-book/first-look-at-types.md | 2 +- .../fp-functional-error-handling.md | 1 + .../scala3-book/fp-functions-are-values.md | 7 + .../scala3-book/fp-immutable-values.md | 1 + _zh-cn/overviews/scala3-book/fp-intro.md | 1 + .../scala3-book/fp-pure-functions.md | 1 + _zh-cn/overviews/scala3-book/fp-summary.md | 1 + _zh-cn/overviews/scala3-book/fp-what-is-fp.md | 1 + .../scala3-book/fun-anonymous-functions.md | 1 + .../scala3-book/fun-eta-expansion.md | 1 + .../scala3-book/fun-function-variables.md | 1 + _zh-cn/overviews/scala3-book/fun-hofs.md | 1 + _zh-cn/overviews/scala3-book/fun-intro.md | 1 + _zh-cn/overviews/scala3-book/fun-summary.md | 1 + .../scala3-book/fun-write-map-function.md | 1 + .../fun-write-method-returns-function.md | 1 + .../scala3-book/interacting-with-java.md | 1 + _zh-cn/overviews/scala3-book/introduction.md | 1 + _zh-cn/overviews/scala3-book/methods-intro.md | 1 + .../scala3-book/methods-main-methods.md | 2 +- _zh-cn/overviews/scala3-book/methods-most.md | 1 + .../overviews/scala3-book/methods-summary.md | 1 + .../scala3-book/packaging-imports.md | 1 + .../overviews/scala3-book/scala-features.md | 436 +----------------- .../scala3-book/scala-for-java-devs.md | 1 + .../scala3-book/scala-for-javascript-devs.md | 1 + .../scala3-book/scala-for-python-devs.md | 1 + _zh-cn/overviews/scala3-book/scala-tools.md | 1 + .../scala3-book/taste-collections.md | 1 + .../taste-contextual-abstractions.md | 1 + .../scala3-book/taste-control-structures.md | 1 + .../overviews/scala3-book/taste-functions.md | 1 + .../scala3-book/taste-hello-world.md | 3 +- _zh-cn/overviews/scala3-book/taste-intro.md | 1 + _zh-cn/overviews/scala3-book/taste-methods.md | 1 + .../overviews/scala3-book/taste-modeling.md | 1 + _zh-cn/overviews/scala3-book/taste-objects.md | 1 + _zh-cn/overviews/scala3-book/taste-repl.md | 1 + _zh-cn/overviews/scala3-book/taste-summary.md | 1 + .../scala3-book/taste-toplevel-definitions.md | 1 + .../scala3-book/taste-vars-data-types.md | 3 +- _zh-cn/overviews/scala3-book/tools-sbt.md | 1 + .../overviews/scala3-book/tools-worksheets.md | 1 + .../overviews/scala3-book/types-adts-gadts.md | 1 + .../scala3-book/types-dependent-function.md | 1 + .../overviews/scala3-book/types-generics.md | 1 + .../overviews/scala3-book/types-inferred.md | 1 + .../scala3-book/types-intersection.md | 1 + .../scala3-book/types-introduction.md | 1 + .../scala3-book/types-opaque-types.md | 1 + _zh-cn/overviews/scala3-book/types-others.md | 1 + .../overviews/scala3-book/types-structural.md | 1 + .../scala3-book/types-type-classes.md | 1 + _zh-cn/overviews/scala3-book/types-union.md | 1 + .../overviews/scala3-book/types-variance.md | 1 + _zh-cn/overviews/scala3-book/where-next.md | 1 + _zh-cn/overviews/scala3-book/why-scala-3.md | 1 + 76 files changed, 90 insertions(+), 435 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index 72b55ca94d..b47b9f5907 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -2,6 +2,7 @@ title: 上下文绑定 type: section description: This page demonstrates Context Bounds in Scala 3. +languages:[en] num: 61 previous-page: types-type-classes next-page: ca-given-imports diff --git a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md index 0cb7bd80c1..65fb42fb01 100644 --- a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -2,6 +2,7 @@ title: 上下文抽象 type: chapter description: This chapter provides an introduction to the Scala 3 concept of Contextual Abstractions. +languages:[en] num: 58 previous-page: types-others next-page: ca-given-using-clauses diff --git a/_zh-cn/overviews/scala3-book/ca-extension-methods.md b/_zh-cn/overviews/scala3-book/ca-extension-methods.md index 8565811725..8a7f3154ef 100644 --- a/_zh-cn/overviews/scala3-book/ca-extension-methods.md +++ b/_zh-cn/overviews/scala3-book/ca-extension-methods.md @@ -2,6 +2,7 @@ title: 扩展方法 type: section description: This page demonstrates how Extension Methods work in Scala 3. +languages:[en] num: 63 previous-page: ca-given-imports next-page: ca-type-classes diff --git a/_zh-cn/overviews/scala3-book/ca-given-imports.md b/_zh-cn/overviews/scala3-book/ca-given-imports.md index 245cd1feec..63721bf920 100644 --- a/_zh-cn/overviews/scala3-book/ca-given-imports.md +++ b/_zh-cn/overviews/scala3-book/ca-given-imports.md @@ -2,6 +2,7 @@ title: Given 导入 type: section description: This page demonstrates how 'given' import statements work in Scala 3. +languages:[en] num: 62 previous-page: ca-context-bounds next-page: ca-extension-methods diff --git a/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md b/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md index f6c56c3897..888b749309 100644 --- a/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md +++ b/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md @@ -2,6 +2,7 @@ title: Given 实例和 Using 语句 type: section description: This page demonstrates how to use 'given' instances and 'using' clauses in Scala 3. +languages:[en] num: 59 previous-page: ca-contextual-abstractions-intro next-page: types-type-classes diff --git a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md index e79c252822..3108f639c4 100644 --- a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md +++ b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md @@ -2,6 +2,7 @@ title: 隐式转换 type: section description: This page demonstrates how to implement Implicit Conversions in Scala 3. +languages:[en] num: 66 previous-page: ca-multiversal-equality next-page: ca-summary diff --git a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md index 02170a260a..6878ecb2b1 100644 --- a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md +++ b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md @@ -2,6 +2,7 @@ title: 多元相等性 type: section description: This page demonstrates how to implement Multiversal Equality in Scala 3. +languages:[en] num: 65 previous-page: ca-type-classes next-page: ca-implicit-conversions diff --git a/_zh-cn/overviews/scala3-book/ca-summary.md b/_zh-cn/overviews/scala3-book/ca-summary.md index 04381a0ede..d66b9baa13 100644 --- a/_zh-cn/overviews/scala3-book/ca-summary.md +++ b/_zh-cn/overviews/scala3-book/ca-summary.md @@ -2,6 +2,7 @@ title: 总结 type: section description: This page provides a summary of the Contextual Abstractions lessons. +languages:[en] num: 67 previous-page: ca-implicit-conversions next-page: concurrency diff --git a/_zh-cn/overviews/scala3-book/ca-type-classes.md b/_zh-cn/overviews/scala3-book/ca-type-classes.md index 5cef98e383..46e36e4c4d 100644 --- a/_zh-cn/overviews/scala3-book/ca-type-classes.md +++ b/_zh-cn/overviews/scala3-book/ca-type-classes.md @@ -2,6 +2,7 @@ title: 实现类型类 type: section description: This page demonstrates how to create and use type classes in Scala 3. +languages:[en] num: 64 previous-page: ca-extension-methods next-page: ca-multiversal-equality diff --git a/_zh-cn/overviews/scala3-book/collections-classes.md b/_zh-cn/overviews/scala3-book/collections-classes.md index 2b494d7791..0a56e4e0ed 100644 --- a/_zh-cn/overviews/scala3-book/collections-classes.md +++ b/_zh-cn/overviews/scala3-book/collections-classes.md @@ -2,6 +2,7 @@ title: 集合类型 type: section description: This page introduces the common Scala 3 collections types and some of their methods. +languages:[en] num: 37 previous-page: collections-intro next-page: collections-methods @@ -371,7 +372,9 @@ val people = ArrayBuffer( ```scala val nums = ArrayBuffer(1, 2, 3) // ArrayBuffer(1, 2, 3) +languages:[en] nums += 4 // ArrayBuffer(1, 2, 3, 4) +languages:[en] nums ++= List(5, 6) // ArrayBuffer(1, 2, 3, 4, 5, 6) ``` diff --git a/_zh-cn/overviews/scala3-book/collections-intro.md b/_zh-cn/overviews/scala3-book/collections-intro.md index 2b8f83481e..41e596f14e 100644 --- a/_zh-cn/overviews/scala3-book/collections-intro.md +++ b/_zh-cn/overviews/scala3-book/collections-intro.md @@ -2,6 +2,7 @@ title: Scala 集合 type: chapter description: This page provides and introduction to the common collections classes and their methods in Scala 3. +languages:[en] num: 36 previous-page: packaging-imports next-page: collections-classes diff --git a/_zh-cn/overviews/scala3-book/collections-methods.md b/_zh-cn/overviews/scala3-book/collections-methods.md index 518754ad37..3dd16e82a6 100644 --- a/_zh-cn/overviews/scala3-book/collections-methods.md +++ b/_zh-cn/overviews/scala3-book/collections-methods.md @@ -2,6 +2,7 @@ title: 集合方法 type: section description: This page demonstrates the common methods on the Scala 3 collections classes. +languages:[en] num: 38 previous-page: collections-classes next-page: collections-summary diff --git a/_zh-cn/overviews/scala3-book/collections-summary.md b/_zh-cn/overviews/scala3-book/collections-summary.md index 45456d2557..63269efe24 100644 --- a/_zh-cn/overviews/scala3-book/collections-summary.md +++ b/_zh-cn/overviews/scala3-book/collections-summary.md @@ -2,6 +2,7 @@ title: 总结 type: section description: This page provides a summary of the Collections chapter. +languages:[en] num: 39 previous-page: collections-methods next-page: fp-intro diff --git a/_zh-cn/overviews/scala3-book/concurrency.md b/_zh-cn/overviews/scala3-book/concurrency.md index cd2b7e8fde..bbbeca4b0d 100644 --- a/_zh-cn/overviews/scala3-book/concurrency.md +++ b/_zh-cn/overviews/scala3-book/concurrency.md @@ -2,6 +2,7 @@ title: 并发 type: chapter description: This page discusses how Scala concurrency works, with an emphasis on Scala Futures. +languages:[en] num: 68 previous-page: ca-summary next-page: scala-tools diff --git a/_zh-cn/overviews/scala3-book/control-structures.md b/_zh-cn/overviews/scala3-book/control-structures.md index d552145c19..bc5bfc06ff 100644 --- a/_zh-cn/overviews/scala3-book/control-structures.md +++ b/_zh-cn/overviews/scala3-book/control-structures.md @@ -2,6 +2,7 @@ title: 控制结构 type: chapter description: This page provides an introduction to Scala's control structures, including if/then/else, 'for' loops, 'for' expressions, 'match' expressions, try/catch/finally, and 'while' loops. +languages:[en, ru] num: 18 previous-page: first-look-at-types next-page: domain-modeling-intro diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md index c218cb5439..4ba980d9d0 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md @@ -2,6 +2,7 @@ title: 函数式领域建模 type: section description: This chapter provides an introduction to FP domain modeling with Scala 3. +languages:[en, ru] num: 22 previous-page: domain-modeling-oop next-page: methods-intro diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-intro.md b/_zh-cn/overviews/scala3-book/domain-modeling-intro.md index f2924f69a7..9a36b2894b 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-intro.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-intro.md @@ -2,6 +2,7 @@ title: 领域建模 type: chapter description: This chapter provides an introduction to domain modeling in Scala 3. +languages:[en, ru] num: 19 previous-page: control-structures next-page: domain-modeling-tools diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md index 47a238c169..204e1ce3c1 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md @@ -2,6 +2,7 @@ title: OOP 领域建模 type: section description: This chapter provides an introduction to OOP domain modeling with Scala 3. +languages:[en, ru] num: 21 previous-page: domain-modeling-tools next-page: domain-modeling-fp diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md index 1cfcaab10d..42deec841b 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md @@ -2,6 +2,7 @@ title: 工具 type: section description: This chapter provides an introduction to the available domain modeling tools in Scala 3, including classes, traits, enums, and more. +languages:[en, ru] num: 20 previous-page: domain-modeling-intro next-page: domain-modeling-oop diff --git a/_zh-cn/overviews/scala3-book/first-look-at-types.md b/_zh-cn/overviews/scala3-book/first-look-at-types.md index 5cc496806c..692e7707b8 100644 --- a/_zh-cn/overviews/scala3-book/first-look-at-types.md +++ b/_zh-cn/overviews/scala3-book/first-look-at-types.md @@ -2,6 +2,7 @@ title: 类型初探 type: chapter description: This page provides a brief introduction to Scala's built-in data types, including Int, Double, String, Long, Any, AnyRef, Nothing, and Null. +languages:[en, ru] num: 17 previous-page: taste-summary next-page: control-structures @@ -13,7 +14,6 @@ permalink: "/zh-cn/scala3/book/:title.html" --- - ## 所有值都有一个类型 在 Scala 中，所有值都有一个类型，包括数值和函数。 diff --git a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md index d0c2dd8749..7cb70257ff 100644 --- a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md +++ b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md @@ -2,6 +2,7 @@ title: 函数式错误处理 type: section description: This section provides an introduction to functional error handling in Scala 3. +languages:[en] num: 45 previous-page: fp-functions-are-values next-page: fp-summary diff --git a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md index e6ad2bcac3..1e5a571c9d 100644 --- a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md +++ b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md @@ -2,6 +2,7 @@ title: 函数是值 type: section description: This section looks at the use of functions as values in functional programming. +languages:[en] num: 44 previous-page: fp-pure-functions next-page: fp-functional-error-handling @@ -91,12 +92,18 @@ fruits.map(_.toUpperCase) // List(APPLE, PEAR) fruits.flatMap(_.toUpperCase) // List(A, P, P, L, E, P, E, A, R) val nums = List(5, 1, 3, 11, 7) +languages:[en] nums.map(_ * 2) // List(10, 2, 6, 22, 14) +languages:[en] nums.filter(_ > 3) // List(5, 11, 7) +languages:[en] nums.takeWhile(_ < 6) // List(5, 1, 3) +languages:[en] nums.sortWith(_ < _) // List(1, 3, 5, 7, 11) +languages:[en] nums.sortWith(_ > _) // List(11, 7, 5, 3, 1) +languages:[en] nums.takeWhile(_ < 6).sortWith(_ < _) // List(1, 3, 5) ``` diff --git a/_zh-cn/overviews/scala3-book/fp-immutable-values.md b/_zh-cn/overviews/scala3-book/fp-immutable-values.md index 085161228f..27a192d7e6 100644 --- a/_zh-cn/overviews/scala3-book/fp-immutable-values.md +++ b/_zh-cn/overviews/scala3-book/fp-immutable-values.md @@ -2,6 +2,7 @@ title: 不可变值 type: section description: This section looks at the use of immutable values in functional programming. +languages:[en] num: 42 previous-page: fp-what-is-fp next-page: fp-pure-functions diff --git a/_zh-cn/overviews/scala3-book/fp-intro.md b/_zh-cn/overviews/scala3-book/fp-intro.md index 5af0f94021..39e500d187 100644 --- a/_zh-cn/overviews/scala3-book/fp-intro.md +++ b/_zh-cn/overviews/scala3-book/fp-intro.md @@ -2,6 +2,7 @@ title: 函数式编程 type: chapter description: This chapter provides an introduction to functional programming in Scala 3. +languages:[en] num: 40 previous-page: collections-summary next-page: fp-what-is-fp diff --git a/_zh-cn/overviews/scala3-book/fp-pure-functions.md b/_zh-cn/overviews/scala3-book/fp-pure-functions.md index 6e53e0f705..135a0c48bc 100644 --- a/_zh-cn/overviews/scala3-book/fp-pure-functions.md +++ b/_zh-cn/overviews/scala3-book/fp-pure-functions.md @@ -2,6 +2,7 @@ title: 纯函数 type: section description: This section looks at the use of pure functions in functional programming. +languages:[en] num: 43 previous-page: fp-immutable-values next-page: fp-functions-are-values diff --git a/_zh-cn/overviews/scala3-book/fp-summary.md b/_zh-cn/overviews/scala3-book/fp-summary.md index 5eb64f228a..6541bc074e 100644 --- a/_zh-cn/overviews/scala3-book/fp-summary.md +++ b/_zh-cn/overviews/scala3-book/fp-summary.md @@ -2,6 +2,7 @@ title: 总结 type: section description: This section summarizes the previous functional programming sections. +languages:[en] num: 46 previous-page: fp-functional-error-handling next-page: types-introduction diff --git a/_zh-cn/overviews/scala3-book/fp-what-is-fp.md b/_zh-cn/overviews/scala3-book/fp-what-is-fp.md index c7f05298a1..a4f5164926 100644 --- a/_zh-cn/overviews/scala3-book/fp-what-is-fp.md +++ b/_zh-cn/overviews/scala3-book/fp-what-is-fp.md @@ -2,6 +2,7 @@ title: 什么是函数式编程？ type: section description: This section provides an answer to the question, what is functional programming? +languages:[en] num: 41 previous-page: fp-intro next-page: fp-immutable-values diff --git a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md index 25de7d14c7..88f92897d5 100644 --- a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md +++ b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md @@ -2,6 +2,7 @@ title: 匿名函数 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. +languages:[en, ru] num: 28 previous-page: fun-intro next-page: fun-function-variables diff --git a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md index bca25ec8fd..7db5c96729 100644 --- a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md +++ b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md @@ -2,6 +2,7 @@ title: Eta 扩展 type: section description: This page discusses Eta Expansion, the Scala technology that automatically and transparently converts methods into functions. +languages:[en, ru] num: 30 previous-page: fun-function-variables next-page: fun-hofs diff --git a/_zh-cn/overviews/scala3-book/fun-function-variables.md b/_zh-cn/overviews/scala3-book/fun-function-variables.md index 75d164d0e9..078467197b 100644 --- a/_zh-cn/overviews/scala3-book/fun-function-variables.md +++ b/_zh-cn/overviews/scala3-book/fun-function-variables.md @@ -2,6 +2,7 @@ title: 函数变量 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. +languages:[en, ru] num: 29 previous-page: fun-anonymous-functions next-page: fun-eta-expansion diff --git a/_zh-cn/overviews/scala3-book/fun-hofs.md b/_zh-cn/overviews/scala3-book/fun-hofs.md index b20c6212da..241f854966 100644 --- a/_zh-cn/overviews/scala3-book/fun-hofs.md +++ b/_zh-cn/overviews/scala3-book/fun-hofs.md @@ -2,6 +2,7 @@ title: 高阶函数 type: section description: This page demonstrates how to create and use higher-order functions in Scala. +languages:[en, ru] num: 31 previous-page: fun-eta-expansion next-page: fun-write-map-function diff --git a/_zh-cn/overviews/scala3-book/fun-intro.md b/_zh-cn/overviews/scala3-book/fun-intro.md index 4a84ebf631..f42b272885 100644 --- a/_zh-cn/overviews/scala3-book/fun-intro.md +++ b/_zh-cn/overviews/scala3-book/fun-intro.md @@ -2,6 +2,7 @@ title: 函数 type: chapter description: This chapter looks at all topics related to functions in Scala 3. +languages:[en, ru] num: 27 previous-page: methods-summary next-page: fun-anonymous-functions diff --git a/_zh-cn/overviews/scala3-book/fun-summary.md b/_zh-cn/overviews/scala3-book/fun-summary.md index f05694ee42..fb382d2bee 100644 --- a/_zh-cn/overviews/scala3-book/fun-summary.md +++ b/_zh-cn/overviews/scala3-book/fun-summary.md @@ -2,6 +2,7 @@ title: 总结 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. +languages:[en, ru] num: 34 previous-page: fun-write-method-returns-function next-page: packaging-imports diff --git a/_zh-cn/overviews/scala3-book/fun-write-map-function.md b/_zh-cn/overviews/scala3-book/fun-write-map-function.md index 8240830912..bb8e82b056 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-map-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-map-function.md @@ -2,6 +2,7 @@ title: 自定义 map 函数 type: section description: This page demonstrates how to create and use higher-order functions in Scala. +languages:[en, ru] num: 32 previous-page: fun-hofs next-page: fun-write-method-returns-function diff --git a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md index 5e223041d5..fa93960616 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md @@ -2,6 +2,7 @@ title: 创建可以返回函数的方法 type: section description: This page demonstrates how to create and use higher-order functions in Scala. +languages:[en, ru] num: 33 previous-page: fun-write-map-function next-page: fun-summary diff --git a/_zh-cn/overviews/scala3-book/interacting-with-java.md b/_zh-cn/overviews/scala3-book/interacting-with-java.md index dae978ba6e..0498d7919b 100644 --- a/_zh-cn/overviews/scala3-book/interacting-with-java.md +++ b/_zh-cn/overviews/scala3-book/interacting-with-java.md @@ -2,6 +2,7 @@ title: 与 Java 交互 type: chapter description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. +languages:[en] num: 72 previous-page: tools-worksheets next-page: scala-for-java-devs diff --git a/_zh-cn/overviews/scala3-book/introduction.md b/_zh-cn/overviews/scala3-book/introduction.md index 003e2e3987..06fb982d8e 100644 --- a/_zh-cn/overviews/scala3-book/introduction.md +++ b/_zh-cn/overviews/scala3-book/introduction.md @@ -2,6 +2,7 @@ title: 导言 type: chapter description: This page begins the overview documentation of the Scala 3 language. +languages:[en, ru] num: 1 previous-page: next-page: scala-features diff --git a/_zh-cn/overviews/scala3-book/methods-intro.md b/_zh-cn/overviews/scala3-book/methods-intro.md index f6d66d0686..fd6e1a6006 100644 --- a/_zh-cn/overviews/scala3-book/methods-intro.md +++ b/_zh-cn/overviews/scala3-book/methods-intro.md @@ -2,6 +2,7 @@ title: 方法 type: chapter description: This section introduces methods in Scala 3. +languages:[en, ru] num: 23 previous-page: domain-modeling-fp next-page: methods-most diff --git a/_zh-cn/overviews/scala3-book/methods-main-methods.md b/_zh-cn/overviews/scala3-book/methods-main-methods.md index fda3199aca..42cccddfd1 100644 --- a/_zh-cn/overviews/scala3-book/methods-main-methods.md +++ b/_zh-cn/overviews/scala3-book/methods-main-methods.md @@ -2,6 +2,7 @@ title: main 方法 type: section description: This page describes how 'main' methods and the '@main' annotation work in Scala 3. +languages:[en, ru] num: 25 previous-page: methods-most next-page: methods-summary @@ -13,7 +14,6 @@ permalink: "/zh-cn/scala3/book/:title.html" --- - Scala 3 提供了一种定义可以从命令行调用的程序的新方法：在方法中添加 `@main` 注释会将其变成可执行程序的入口点： ```scala diff --git a/_zh-cn/overviews/scala3-book/methods-most.md b/_zh-cn/overviews/scala3-book/methods-most.md index d9ad8e194d..c73453fd90 100644 --- a/_zh-cn/overviews/scala3-book/methods-most.md +++ b/_zh-cn/overviews/scala3-book/methods-most.md @@ -2,6 +2,7 @@ title: 方法特性 type: section description: This section introduces Scala 3 methods, including main methods, extension methods, and more. +languages:[en, ru] num: 24 previous-page: methods-intro next-page: methods-main-methods diff --git a/_zh-cn/overviews/scala3-book/methods-summary.md b/_zh-cn/overviews/scala3-book/methods-summary.md index c74f976cd2..20fd7cb68b 100644 --- a/_zh-cn/overviews/scala3-book/methods-summary.md +++ b/_zh-cn/overviews/scala3-book/methods-summary.md @@ -2,6 +2,7 @@ title: 总结 type: section description: This section summarizes the previous sections on Scala 3 methods. +languages:[en, ru] num: 26 previous-page: methods-main-methods next-page: fun-intro diff --git a/_zh-cn/overviews/scala3-book/packaging-imports.md b/_zh-cn/overviews/scala3-book/packaging-imports.md index c87cc51b3d..190796573a 100644 --- a/_zh-cn/overviews/scala3-book/packaging-imports.md +++ b/_zh-cn/overviews/scala3-book/packaging-imports.md @@ -2,6 +2,7 @@ title: 打包和导入 type: chapter description: A discussion of using packages and imports to organize your code, build related modules of code, control scope, and help prevent namespace collisions. +languages:[en] num: 35 previous-page: fun-summary next-page: collections-intro diff --git a/_zh-cn/overviews/scala3-book/scala-features.md b/_zh-cn/overviews/scala3-book/scala-features.md index 6d9362cf6b..0b9761fe17 100644 --- a/_zh-cn/overviews/scala3-book/scala-features.md +++ b/_zh-cn/overviews/scala3-book/scala-features.md @@ -2,6 +2,7 @@ title: Scala 3 特性 type: chapter description: This page discusses the main features of the Scala 3 programming language. +languages:[en, ru] num: 2 previous-page: introduction next-page: why-scala-3 @@ -13,24 +14,10 @@ permalink: "/zh-cn/scala3/book/:title.html" --- -{% comment %} -The name _Scala_ comes from the word _scalable_, and true to that name, the Scala language is used to power busy websites and analyze huge data sets. -This section introduces the features that make Scala a scalable language. -These features are split into three sections: -{% endcomment %} - _Scala_ 这个名字来源于 _scalable_ 一词。正如其名，Scala 语言被用于支撑高流量网站以及分析庞大的数据集。 本节介绍了使 Scala 成为一门可扩展语言的特性。 这些特性分为三个部分： -{% comment %} - -- High-level language features -- Lower-level language features -- Scala ecosystem features - -{% endcomment %} - - 高级语言特性 - 底层语言特性 - Scala 生态系统特性 @@ -39,36 +26,10 @@ _Scala_ 这个名字来源于 _scalable_ 一词。正如其名，Scala 语言被 I think of this section as being like an “elevator pitch.” {% endcomment %} -{% comment %} - -## High-level features - -{% endcomment %} - ## 高级特性 -{% comment %} -Looking at Scala from the proverbial “30,000 foot view,” you can make the following statements about it: -{% endcomment %} - 从宏观视角来看 Scala，您可以对它做出以下陈述： -{% comment %} - -- It’s a high-level programming language -- It has a concise, readable syntax -- It’s statically-typed (but feels dynamic) -- It has an expressive type system -- It’s a functional programming (FP) language -- It’s an object-oriented programming (OOP) language -- It supports the fusion of FP and OOP -- Contextual abstractions provide a clear way to implement _term inference_ -- It runs on the JVM (and in the browser) -- It interacts seamlessly with Java code -- It’s used for server-side applications (including microservices), big data applications, and can also be used in the browser with Scala.js - -{% endcomment %} - - 它是一种高级编程语言 - 它具有简明易读的语法 - 它是静态类型的（但使人感觉是动态的） @@ -81,34 +42,13 @@ Looking at Scala from the proverbial “30,000 foot view,” you can make the fo - 它与 Java 代码无缝交互 - 它可被用于服务器端应用（包括微服务）、大数据应用，也可以在浏览器中与 Scala.js 共同使用 -{% comment %} -The following sections take a quick look at these features. -{% endcomment %} - 以下部分将对这些特性进行简要介绍。 -{% comment %} - -### A high-level language - -{% endcomment %} - ### 一门高级语言 -{% comment %} -Scala is considered a high-level language in at least two ways. -First, like Java and many other modern languages, you don’t deal with low-level concepts like pointers and memory management. -{% endcomment %} - Scala 至少在两个方面被认为是一门高级语言。 首先，像 Java 和许多其他现代语言一样，您不需要与指针和内存管理等底层概念打交道。 -{% comment %} -Second, with the use of lambdas and higher-order functions, you write your code at a very high level. -As the functional programming saying goes, in Scala you write _what_ you want, not _how_ to achieve it. -That is, we don’t write imperative code like this: -{% endcomment %} - 其次，通过使用 lambda 与高阶函数，您可以在非常高的层次上编写代码。 正如函数式编程的说法，在 Scala 中，您编写您想要 _“什么”_，而不是 _“如何”_ 去实现它。 也就是说，我们不会像这样编写命令式代码： @@ -146,11 +86,6 @@ val newNumbers = double(oldNumbers) {% endtab %} {% endtabs %} -{% comment %} -That code instructs the compiler what to do on a step-by-step basis. -Instead, we write high-level, functional code using higher-order functions and lambdas like this to compute the same result: -{% endcomment %} - 这段代码指示编译器逐步执行特定操作。 相反，我们使用像这样的高阶函数与 lambda 来编写高层次的函数式代码以计算出相同的结果： @@ -162,25 +97,10 @@ val newNumbers = oldNumbers.map(_ * 2) {% endtab %} {% endtabs %} -{% comment %} -As you can see, that code is much more concise, easier to read, and easier to maintain. -{% endcomment %} - 如您所见，该代码更简洁、更容易阅读且更易于维护。 -{% comment %} - -### Concise syntax - -{% endcomment %} - ### 简明的语法 -{% comment %} -Scala has a concise, readable syntax. -For instance, variables are created concisely, and their types are clear: -{% endcomment %} - Scala 具有简明易读的语法。例如，变量的创建十分简洁，其类型也很明确。 {% tabs scala-features-3 %} @@ -192,29 +112,24 @@ val p = Person("Martin", "Odersky") {% endtab %} {% endtabs %} - -{% comment %} -Higher-order functions and lambdas make for concise code that’s readable: -{% endcomment %} - 高阶函数与 lambda 使代码简明易读： {% tabs scala-features-4 %} {% tab 'Scala 2 and 3' for=scala-features-4 %} ```scala +languages:[en] nums.map(i => i * 2) // long form +languages:[en] nums.map(_ * 2) // short form +languages:[en] nums.filter(i => i > 1) +languages:[en] nums.filter(_ > 1) ``` {% endtab %} {% endtabs %} -{% comment %} -Traits, classes, and methods are defined with a clean, light syntax: -{% endcomment %} - 特质（Traits）、类（Class）和方法（Method）都是用简洁、轻巧的语法定义的。 {% tabs scala-features-5 class=tabs-scala-version %} @@ -249,26 +164,10 @@ class Dog extends Animal, HasTail: {% endtab %} {% endtabs %} - -{% comment %} -Studies have shown that the time a developer spends _reading_ code to _writing_ code is at least a 10:1 ratio, so writing code that is concise _and_ readable is important. -{% endcomment %} - 研究表明，开发人员花在 _阅读_ 代码和 _编写_ 代码上的时间比例至少为 10:1。因此，编写简洁 _并_ 易读的代码非常重要。 -{% comment %} - -### A dynamic feel - -{% endcomment %} - ### 动态感受 -{% comment %} -Scala is a statically-typed language, but thanks to its type inference capabilities it feels dynamic. -All of these expressions look like a dynamically-typed language like Python or Ruby, but they’re all Scala: -{% endcomment %} - Scala 是一种静态类型的语言，但由于其类型推断能力，它使人感觉是动态的。所有这些表达式看起来都像 Python 或 Ruby 这样的动态类型语言代码，但其实它们都是 Scala 代码： {% tabs scala-features-6 class=tabs-scala-version %} @@ -298,26 +197,8 @@ val z = nums {% endtab %} {% endtabs %} -{% comment %} -As Heather Miller states, Scala is considered to be a [strong, statically-typed language](https://heather.miller.am/blog/types-in-scala.html), and you get all the benefits of static types: -{% endcomment %} - 正如 Heather Miller 所说，Scala 被认为是一种[强静态类型语言](https://heather.miller.am/blog/types-in-scala.html)。您可以获得静态类型的全部益处： -{% comment %} - -- Correctness: you catch most errors at compile-time -- Great IDE support - - Reliable code completion - - Catching errors at compile-time means catching mistakes as you type - - Easy and reliable refactoring -- You can refactor your code with confidence -- Method type declarations tell readers what the method does, and help serve as documentation -- Scalability and maintainability: types help ensure correctness across arbitrarily large applications and development teams -- Strong typing in combination with excellent inference enables mechanisms like [contextual abstraction]({{ site.scala3ref }}/contextual) that allows you to omit boilerplate code. Often, this boilerplate code can be inferred by the compiler, based on type definitions and a given context. - -{% endcomment %} - - 正确性：您可以在编译时捕获大多数错误 - 强大的 IDE 支持 - 可靠的代码补全 @@ -337,12 +218,6 @@ In that list: - Reliable code completion {% endcomment %} -{% comment %} - -### Expressive type system - -{% endcomment %} - ### 富有表现力的类型系统 {% comment %} @@ -355,36 +230,8 @@ In that list: * [Explicitly typed self references](/tour/self-types.html) {% endcomment %} -{% comment %} -Scala’s type system enforces, at compile-time, that abstractions are used in a safe and coherent manner. -In particular, the type system supports: -{% endcomment %} - Scala 的类型系统在编译时强制要求以安全与连贯的方式使用抽象概念。特别是，该类型系统支持： -{% comment %} -- [Inferred types]({% link _overviews/scala3-book/types-inferred.md %}) -- [Generic classes]({% link _overviews/scala3-book/types-generics.md %}) -- [Variance annotations]({% link _overviews/scala3-book/types-variance.md %}) -- [Upper](/tour/upper-type-bounds.html) and [lower](/tour/lower-type-bounds.html) type bounds -- [Polymorphic methods](/tour/polymorphic-methods.html) -- [Intersection types]({% link _overviews/scala3-book/types-intersection.md %}) -- [Union types]({% link _overviews/scala3-book/types-union.md %}) -- [Type lambdas]({{ site.scala3ref }}/new-types/type-lambdas.html) -- [`given` instances and `using` clauses]({% link _overviews/scala3-book/ca-given-using-clauses.md %}) -- [Extension methods]({% link _overviews/scala3-book/ca-extension-methods.md %}) -- [Type classes]({% link _overviews/scala3-book/ca-type-classes.md %}) -- [Multiversal equality]({% link _overviews/scala3-book/ca-multiversal-equality.md %}) -- [Opaque type aliases]({% link _overviews/scala3-book/types-opaque-types.md %}) -- [Open classes]({{ site.scala3ref }}/other-new-features/open-classes.html) -- [Match types]({{ site.scala3ref }}/new-types/match-types.html) -- [Dependent function types]({{ site.scala3ref }}/new-types/dependent-function-types.html) -- [Polymorphic function types]({{ site.scala3ref }}/new-types/polymorphic-function-types.html) -- [Context bounds]({{ site.scala3ref }}/contextual/context-bounds.html) -- [Context functions]({{ site.scala3ref }}/contextual/context-functions.html) -- [Inner classes](/tour/inner-classes.html) and [abstract type members](/tour/abstract-type-members.html) as object members -{% endcomment %} - - [推断类型]({% link _zh-cn/overviews/scala3-book/types-inferred.md %}) - [泛型类]({% link _zh-cn/overviews/scala3-book/types-generics.md %}) - [型变]({% link _zh-cn/overviews/scala3-book/types-variance.md %}) @@ -406,38 +253,12 @@ Scala 的类型系统在编译时强制要求以安全与连贯的方式使用 - [上下文函数]({{ site.scala3ref }}/contextual/context-functions.html) - 作为对象成员的[内部类](/tour/inner-classes.html) 与 [抽象类型](/tour/abstract-type-members.html) -{% comment %} -In combination, these features provide a powerful basis for the safe reuse of programming abstractions and for the type-safe extension of software. -{% endcomment %} - 通过结合使用，这些特性为编程抽象的安全重用及软件的类型安全扩展提供了强大的基础。 -{% comment %} - -### A functional programming language - -{% endcomment %} - ### 一门函数式编程语言 -{% comment %} -Scala is a functional programming (FP) language, meaning: -{% endcomment %} - Scala 是一门函数式编程（FP）语言，也就是说： -{% comment %} - -- Functions are values, and can be passed around like any other value -- Higher-order functions are directly supported -- Lambdas are built in -- Everything in Scala is an expression that returns a value -- Syntactically it’s easy to use immutable variables, and their use is encouraged -- It has a wealth of immutable collection classes in the standard library -- Those collection classes come with dozens of functional methods: they don’t mutate the collection, but instead return an updated copy of the data - -{% endcomment %} - - 函数是值，可以像任何其他值一样被传递 - 直接支持高阶函数 - 原生地支持 Lambda @@ -446,28 +267,11 @@ Scala 是一门函数式编程（FP）语言，也就是说： - 在标准库中有大量的不可变集合类 - 这些集合类带有许多函数式方法：它们不改变集合本身，而是返回数据的更新副本 -{% comment %} - -### An object-oriented language - -{% endcomment %} - ### 一门面向对象语言 -{% comment %} -Scala is an object-oriented programming (OOP) language. -Every value is an instance of a class and every “operator” is a method. -{% endcomment %} - Scala 是一门面向对象编程（OOP）语言。 每个值都是一个类的实例，每个“运算符”都是一个方法。 -{% comment %} -In Scala, all types inherit from a top-level class `Any`, whose immediate children are `AnyVal` (_value types_, such as `Int` and `Boolean`) and `AnyRef` (_reference types_, as in Java). -This means that the Java distinction between primitive types and boxed types (e.g. `int` vs. `Integer`) isn’t present in Scala. -Boxing and unboxing is completely transparent to the user. -{% endcomment %} - 在 Scala 中，所有类型都继承自顶层类 `Any`，其直接子类是 `AnyVal`（_值类型_，例如 `Int` 与 `Boolean`）和 `AnyRef`（_引用类型_，与 Java 中相同）。 这意味着 Scala 中不存在 Java 中原始类型和包装类型的区别（例如 `int` 与 `Integer`）。 装箱与拆箱对用户来说是完全透明的。 @@ -478,27 +282,12 @@ Boxing and unboxing is completely transparent to the user. - Add the “types hierarchy” image here? {% endcomment %} -{% comment %} - -### Supports FP/OOP fusion - -{% endcomment %} - ### 支持 FP 与 OOP 融合 {% comment %} NOTE: This text in the first line comes from this slide: https://twitter.com/alexelcu/status/996408359514525696 {% endcomment %} -{% comment %} -The essence of Scala is the fusion of functional programming and object-oriented programming in a typed setting: - -- Functions for the logic -- Objects for the modularity - -As [Martin Odersky has stated](https://jaxenter.com/current-state-scala-odersky-interview-129495.html), “Scala was designed to show that a fusion of functional and object-oriented programming is possible and practical.” -{% endcomment %} - Scala 的本质是函数式编程和面向对象编程的融合： - 函数用于代表逻辑 @@ -506,27 +295,8 @@ Scala 的本质是函数式编程和面向对象编程的融合： 正如 [Martin Odersky 所说](https://jaxenter.com/current-state-scala-odersky-interview-129495.html)，“Scala 旨在表明函数式编程与面向对象编程的融合是切实可行的。” -{% comment %} - -### Term inference, made clearer - -{% endcomment %} - ### 表达式推断，更加清晰 -{% comment %} -Following Haskell, Scala was the second popular language to have some form of _implicits_. -In Scala 3 these concepts have been completely re-thought and more clearly implemented. - -The core idea is _term inference_: Given a type, the compiler synthesizes a “canonical” term that has that type. -In Scala, a context parameter directly leads to an inferred argument term that could also be written down explicitly. - -Use cases for this concept include implementing [type classes]({% link _overviews/scala3-book/ca-type-classes.md %}), establishing context, dependency injection, expressing capabilities, computing new types, and proving relationships between them. - -Scala 3 makes this process more clear than ever before. -Read about contextual abstractions in the [Reference documentation]({{ site.scala3ref }}/contextual). -{% endcomment %} - 继 Haskell 之后，Scala 是第二种具有某种形式的 _隐式_ 的流行语言。 在 Scala 3 中，这些概念经过了重新考虑并更清晰地实现。 @@ -538,26 +308,8 @@ Read about contextual abstractions in the [Reference documentation]({{ site.scal Scala 3 使此过程比以往任何时候都更加清晰。 请在[参考文档]({{ site.scala3ref }}/contextual)中阅读关于上下文抽象的内容。 -{% comment %} - -### Client & server - -{% endcomment %} - ### 客户端与服务器 -{% comment %} -Scala code runs on the Java Virtual Machine (JVM), so you get all of its benefits: - -- Security -- Performance -- Memory management -- Portability and platform independence -- The ability to use the wealth of existing Java and JVM libraries - -In addition to running on the JVM, Scala also runs in the browser with Scala.js (and open source third-party tools to integrate popular JavaScript libraries), and native executables can be built with Scala Native and GraalVM. -{% endcomment %} - Scala 代码在 Java 虚拟机（JVM）上运行，因此您可以获得它的全部益处： - 安全性 @@ -568,27 +320,11 @@ Scala 代码在 Java 虚拟机（JVM）上运行，因此您可以获得它的 除了在 JVM 上运行外，Scala 还可以通过 Scala.js （以及开源的第三方工具以集成流行的 JavaScript 库）在浏览器中运行，并且可以使用Scala Native 与 GraalVM 构建原生可执行文件。 -{% comment %} - -### Seamless Java interaction - -{% endcomment %} - ### 与 Java 无缝交互 -{% comment %} -You can use Java classes and libraries in your Scala applications, and you can use Scala code in your Java applications. -In regards to the second point, large libraries like [Akka](https://akka.io) and the [Play Framework](https://www.playframework.com) are written in Scala, and can be used in Java applications. -{% endcomment %} - 您可以在 Scala 应用程序中使用 Java 类和库，也可以在 Java 应用程序中使用 Scala 代码。 对于第二点来说，诸如 [Akka](https://akka.io) 和 [Play Framework](https://www.playframework.com) 之类的大型库是用 Scala 编写的，并且它们可以在 Java 应用程序中使用。 -{% comment %} -In regards to the first point, Java classes and libraries are used in Scala applications every day. -For instance, in Scala you can read files with a Java `BufferedReader` and `FileReader`: -{% endcomment %} - 对于第一点来说，Scala 应用程序中每天都会用到 Java 类和库。 例如，在 Scala 中，您可以使用 Java 的 `BufferedReader` 和 `FileReader` 来读取文件： @@ -602,12 +338,6 @@ val br = BufferedReader(FileReader(filename)) {% endtab %} {% endtabs %} -{% comment %} -Using Java code in Scala is generally seamless. - -Java collections can also be used in Scala, and if you want to use Scala’s rich collection class methods with them, you can convert them with just a few lines of code: -{% endcomment %} - 在 Scala 中使用 Java 代码通常是无缝衔接的。 Java 集合也可以在 Scala 中使用， 如果您想将 Scala 丰富的集合类方法与其一起使用，只需几行代码即可转换它们： @@ -621,26 +351,8 @@ val scalaList: Seq[Integer] = JavaClass.getJavaList().asScala.toSeq {% endtab %} {% endtabs %} -{% comment %} - -### Wealth of libraries - -{% endcomment %} - ### 丰富的库 -{% comment %} -As you’ll see in the third section of this page, Scala libraries and frameworks like these have been written to power busy websites and work with huge datasets: - -1. The [Play Framework](https://www.playframework.com) is a lightweight, stateless, developer-friendly, web-friendly architecture for creating highly-scalable applications -2. [Lagom](https://www.lagomframework.com) is a microservices framework that helps you decompose your legacy monolith and build, test, and deploy entire systems of reactive microservices -3. [Apache Spark](https://spark.apache.org) is a unified analytics engine for big data processing, with built-in modules for streaming, SQL, machine learning and graph processing - -The [Awesome Scala list](https://github.com/lauris/awesome-scala) shows dozens of additional open source tools that developers have created to build Scala applications. - -In addition to server-side programming, [Scala.js](https://www.scala-js.org) is a strongly-typed replacement for writing JavaScript, with open source third-party libraries that include tools to integrate with Facebook’s React library, jQuery, and more. -{% endcomment %} - 正如您将在本页的第三部分中所看到的那样，已经有诸如此类的 Scala 库和框架被编写出来用于支撑高流量网站以及分析庞大的数据集： 1. [Play Framework](https://www.playframework.com) 是一种用于创建高度可扩展应用程序的轻量级、无状态、对开发者及Web友好的架构 @@ -656,50 +368,11 @@ The Lower-Level Features section is like the second part of an elevator pitch. Assuming you told someone about the previous high-level features and then they say, “Tell me more,” this is what you might tell them. {% endcomment %} -{% comment %} - -## Lower-level language features - -{% endcomment %} - ## 底层语言特性 -{% comment %} -Where the previous section covered high-level features of Scala 3, it’s interesting to note that at a high level you can make the same statements about both Scala 2 and Scala 3. -A decade ago Scala started with a strong foundation of desirable features, and as you’ll see in this section, those benefits have been improved with Scala 3. -{% endcomment %} - 上一节介绍了 Scala 3 的高级特性，有趣的是，您可以从高层次上对 Scala 2 和 Scala 3 作出相同的表述。 十年前，Scala 就为各种理想特性打下了坚实基础，正如您在本节中即将看到的那样，这些效益在 Scala 3 中得到了提高。 -{% comment %} -At a “sea level” view of the details---i.e., the language features programmers use everyday---Scala 3 has significant advantages over Scala 2: - -- The ability to create algebraic data types (ADTs) more concisely with enums -- An even more concise and readable syntax: - - The “quiet” control structure syntax is easier to read - - Optional braces - - Fewer symbols in the code creates less visual noise, making it easier to read - - The `new` keyword is generally no longer needed when creating class instances - - The formality of package objects have been dropped in favor of simpler “top level” definitions -- A grammar that’s more clear: - - Multiple different uses of the `implicit` keyword have been removed; those uses are replaced by more obvious keywords like `given`, `using`, and `extension`, focusing on intent over mechanism (see the [Givens][givens] section for details) - - [Extension methods][extension] replace implicit classes with a clearer and simpler mechanism - - The addition of the `open` modifier for classes makes the developer intentionally declare that a class is open for modification, thereby limiting ad-hoc extensions to a code base - - [Multiversal equality][multiversal] rules out nonsensical comparisons with `==` and `!=` (i.e., attempting to compare a `Person` to a `Planet`) - - Macros are implemented much more easily - - Union and intersection offer a flexible way to model types - - Trait parameters replace and simplify early initializers - - [Opaque type aliases][opaque_types] replace most uses of value classes, while guaranteeing the absence of boxing - - Export clauses provide a simple and general way to express aggregation, which can replace the previous facade pattern of package objects inheriting from classes - - The procedure syntax has been dropped, and the varargs syntax has been changed, both to make the language more consistent - - The `@infix` annotation makes it obvious how you want a method to be applied - - The [`@targetName`]({{ site.scala3ref }}/other-new-features/targetName.html) method annotation defines an alternate name for the method, improving Java interoperability, and letting you provide aliases for symbolic operators - -It would take too much space to demonstrate all of those features here, but follow the links in the items above to see those features in action. -All of these features are discussed in detail in the *New*, *Changed*, and *Dropped* features pages in the [Overview documentation][reference]. -{% endcomment %} - 以小见大，从程序员日常使用的语言特性来看，Scala 3 比 Scala 2 具有显著优势： - 可以用枚举更简洁地创建代数数据类型（ADT） @@ -789,52 +462,14 @@ DROPPED FEATURES and will be phased out {% endcomment %} - -{% comment %} - -## Scala ecosystem - -{% endcomment %} - ## Scala 生态系统 -{% comment %} -TODO: I didn’t put much work into this section because I don’t know if you want - to add many tools because (a) that can be seen as an endorsement and - (b) it creates a section that can need more maintenance than average - since tool popularity can wax and wane. One way to avoid the first - point is to base the lists on Github stars and activity. -{% endcomment %} - -{% comment %} -Scala has a vibrant ecosystem, with libraries and frameworks for every need. -The [“Awesome Scala” list](https://github.com/lauris/awesome-scala) provides a list of hundreds of open source projects that are available to Scala developers, and the [Scaladex](https://index.scala-lang.org) provides a searchable index of Scala libraries. -Some of the more notable libraries are listed below. -{% endcomment %} - Scala 拥有一个充满活力的生态系统，有满足各种需求的库和框架。 [Awesome Scala 列表](https://github.com/lauris/awesome-scala)提供了数百个可供 Scala 开发者使用的开源项目，[Scaladex](https://index.scala-lang.org) 则提供了 Scala 库的可搜索索引。 以下列出了一些比较著名的库： -{% comment %} - -### Web development - -{% endcomment %} - ### Web 开发 -{% comment %} - -- The [Play Framework](https://www.playframework.com) followed the Ruby on Rails model to become a lightweight, stateless, developer-friendly, web-friendly architecture for highly-scalable applications -- [Scalatra](https://scalatra.org) is a tiny, high-performance, async web framework, inspired by Sinatra -- [Finatra](https://twitter.github.io/finatra) is Scala services built on TwitterServer and Finagle -- [Scala.js](https://www.scala-js.org) is a strongly-typed replacement for JavaScript that provides a safer way to build robust front-end web applications -- [ScalaJs-React](https://github.com/japgolly/scalajs-react) lifts Facebook’s React library into Scala.js, and endeavours to make it as type-safe and Scala-friendly as possible -- [Lagom](https://www.lagomframework.com) is a microservices framework that helps you decompose your legacy monolith and build, test, and deploy entire systems of Reactive microservices -- -{% endcomment %} - - [Play Framework](https://www.playframework.com) 遵循 Ruby on Rails 模型，是一种用于高度可扩展应用程序的轻量级、无状态、对开发者及Web友好的架构 - [Scalatra](https://scalatra.org) 是一个小型的、高性能的、异步的网络框架，其灵感来自于 Sinatra - [Finatra](https://twitter.github.io/finatra) 是基于 TwitterServer 和 Finagle 构建的 Scala 服务 @@ -842,10 +477,6 @@ Scala 拥有一个充满活力的生态系统，有满足各种需求的库和 - [ScalaJs-React](https://github.com/japgolly/scalajs-react) 将 Facebook 的 React 库整合至 Scala.js，并努力使其尽可能类型安全和 Scala 友好 - [Lagom](https://www.lagomframework.com) 是一种微服务框架，可帮助您分解遗留的单体应用并构建、测试和部署整个响应式微服务系统 -{% comment %} -HTTP(S) libraries: -{% endcomment %} - HTTP(S) 库： - [Akka-http](https://akka.io) @@ -853,10 +484,6 @@ HTTP(S) 库： - [Http4s](https://github.com/http4s/http4s) - [Sttp](https://github.com/softwaremill/sttp) -{% comment %} -JSON libraries: -{% endcomment %} - JSON 库： - [Argonaut](https://github.com/argonaut-io/argonaut) @@ -864,97 +491,44 @@ JSON 库： - [Json4s](https://github.com/json4s/json4s) - [Play-JSON](https://github.com/playframework/play-json) -{% comment %} -Serialization: -{% endcomment %} - 序列化： - [ScalaPB](https://github.com/scalapb/ScalaPB) -{% comment %} - -### Science and data analysis: - -{% endcomment %} - ### 科学和数据分析 - [Algebird](https://github.com/twitter/algebird) - [Spire](https://github.com/typelevel/spire) - [Squants](https://github.com/typelevel/squants) -{% comment %} - -### Big data - -{% endcomment %} - ### 大数据 - [Apache Spark](https://github.com/apache/spark) - [Apache Flink](https://github.com/apache/flink) -{% comment %} - -### AI, machine learning - -- [BigDL](https://github.com/intel-analytics/BigDL) (Distributed Deep Learning Framework for Apache Spark) for Apache Spark -- [TensorFlow Scala](https://github.com/eaplatanios/tensorflow_scala) - -{% endcomment %} - ### 人工智能，机器学习 - [BigDL](https://github.com/intel-analytics/BigDL) （用于 Apache Spark 的分布式深度学习框架） - [TensorFlow Scala](https://github.com/eaplatanios/tensorflow_scala) -{% comment %} - -### Functional Programming & Functional Reactive Programming - -{% endcomment %} - ### 函数式编程 & 函数式响应式编程 -{% comment %} -FP: -{% endcomment %} - 函数式编程： - [Cats](https://github.com/typelevel/cats) - [Zio](https://github.com/zio/zio) -{% comment %} -Functional reactive programming (FRP): -{% endcomment %} - 函数式响应式编程（FRP） - [fs2](https://github.com/typelevel/fs2) - [monix](https://github.com/monix/monix) -{% comment %} - -### Build tools - -{% endcomment %} - ### 构建工具 - [sbt](https://www.scala-sbt.org) - [Gradle](https://gradle.org) - [Mill](https://github.com/lihaoyi/mill) -{% comment %} - -## Summary - -As this page shows, Scala has many terrific programming language features at a high level, at an everyday programming level, and through its developer ecosystem. - -{% endcomment %} - ## 总结 如此页所示，Scala 在高层、日常编程层面以及贯穿开发者生态系统都具有许多出色的编程语言特性。 diff --git a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md index c659559bb2..de7b4eea7a 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md @@ -2,6 +2,7 @@ title: 向 Java 开发者介绍Scala type: chapter description: This page is for Java developers who are interested in learning about Scala 3. +languages:[en] num: 73 previous-page: interacting-with-java next-page: scala-for-javascript-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md index 3e80ad15e9..c5f4b907bd 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md @@ -2,6 +2,7 @@ title: Scala for JavaScript Developers type: chapter description: This chapter provides an introduction to Scala 3 for JavaScript developers +languages:[en] num: 74 previous-page: scala-for-java-devs next-page: scala-for-python-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md index f3e17233f1..4ee6dee030 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md @@ -2,6 +2,7 @@ title: Scala for Python Developers type: chapter description: This page is for Python developers who are interested in learning about Scala 3. +languages:[en] num: 75 previous-page: scala-for-javascript-devs next-page: diff --git a/_zh-cn/overviews/scala3-book/scala-tools.md b/_zh-cn/overviews/scala3-book/scala-tools.md index 0362ffcc0e..4cd1637244 100644 --- a/_zh-cn/overviews/scala3-book/scala-tools.md +++ b/_zh-cn/overviews/scala3-book/scala-tools.md @@ -2,6 +2,7 @@ title: Scala 工具 type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. +languages:[en] num: 69 previous-page: concurrency next-page: tools-sbt diff --git a/_zh-cn/overviews/scala3-book/taste-collections.md b/_zh-cn/overviews/scala3-book/taste-collections.md index bd5f02cb01..589a498f0a 100644 --- a/_zh-cn/overviews/scala3-book/taste-collections.md +++ b/_zh-cn/overviews/scala3-book/taste-collections.md @@ -2,6 +2,7 @@ title: Collections type: section description: This page provides a high-level overview of the main features of the Scala 3 programming language. +languages:[en, ru] num: 13 previous-page: taste-objects next-page: taste-contextual-abstractions diff --git a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md index b354a6a9f5..6d181d09fa 100644 --- a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md +++ b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md @@ -2,6 +2,7 @@ title: Contextual Abstractions type: section description: This section provides an introduction to Contextual Abstractions in Scala 3. +languages:[en, ru] num: 14 previous-page: taste-collections next-page: taste-toplevel-definitions diff --git a/_zh-cn/overviews/scala3-book/taste-control-structures.md b/_zh-cn/overviews/scala3-book/taste-control-structures.md index 5efa015ee3..e45fbd3849 100644 --- a/_zh-cn/overviews/scala3-book/taste-control-structures.md +++ b/_zh-cn/overviews/scala3-book/taste-control-structures.md @@ -2,6 +2,7 @@ title: 控制结构 type: section description: This section demonstrates Scala 3 control structures. +languages:[en, ru] num: 8 previous-page: taste-vars-data-types next-page: taste-modeling diff --git a/_zh-cn/overviews/scala3-book/taste-functions.md b/_zh-cn/overviews/scala3-book/taste-functions.md index 6947dfcb69..637dd40216 100644 --- a/_zh-cn/overviews/scala3-book/taste-functions.md +++ b/_zh-cn/overviews/scala3-book/taste-functions.md @@ -2,6 +2,7 @@ title: First-Class Functions type: section description: This page provides an introduction to functions in Scala 3. +languages:[en, ru] num: 11 previous-page: taste-methods next-page: taste-objects diff --git a/_zh-cn/overviews/scala3-book/taste-hello-world.md b/_zh-cn/overviews/scala3-book/taste-hello-world.md index 686e2187fc..2b8a8bd1b6 100644 --- a/_zh-cn/overviews/scala3-book/taste-hello-world.md +++ b/_zh-cn/overviews/scala3-book/taste-hello-world.md @@ -2,6 +2,7 @@ title: Hello, World! type: section description: This section demonstrates a Scala 3 'Hello, World!' example. +languages:[en, ru] num: 5 previous-page: taste-intro next-page: taste-repl @@ -198,4 +199,4 @@ import scala.io.StdIn.readLine - 您可以使用包含有用功能的代码库，该库可能是由其他人编写 - 您可以知道某个定义的来源（特别是如果它没有写入当前文件）。 -[scala_tools]: {% link _zh-cn/overviews/scala3-book/scala-tools.md %} \ No newline at end of file +[scala_tools]: {% link _zh-cn/overviews/scala3-book/scala-tools.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-intro.md b/_zh-cn/overviews/scala3-book/taste-intro.md index 1aa0b92bcb..fc975520c5 100644 --- a/_zh-cn/overviews/scala3-book/taste-intro.md +++ b/_zh-cn/overviews/scala3-book/taste-intro.md @@ -2,6 +2,7 @@ title: Scala 的味道 type: chapter description: This chapter provides a high-level overview of the main features of the Scala 3 programming language. +languages:[en, ru] num: 4 previous-page: why-scala-3 next-page: taste-hello-world diff --git a/_zh-cn/overviews/scala3-book/taste-methods.md b/_zh-cn/overviews/scala3-book/taste-methods.md index fb1da65c2f..1743286235 100644 --- a/_zh-cn/overviews/scala3-book/taste-methods.md +++ b/_zh-cn/overviews/scala3-book/taste-methods.md @@ -2,6 +2,7 @@ title: Methods type: section description: This section provides an introduction to defining and using methods in Scala 3. +languages:[en, ru] num: 10 previous-page: taste-modeling next-page: taste-functions diff --git a/_zh-cn/overviews/scala3-book/taste-modeling.md b/_zh-cn/overviews/scala3-book/taste-modeling.md index 2ade36d68d..79fb6fa964 100644 --- a/_zh-cn/overviews/scala3-book/taste-modeling.md +++ b/_zh-cn/overviews/scala3-book/taste-modeling.md @@ -2,6 +2,7 @@ title: 领域建模 type: section description: This section provides an introduction to data modeling in Scala 3. +languages:[en, ru] num: 9 previous-page: taste-control-structures next-page: taste-methods diff --git a/_zh-cn/overviews/scala3-book/taste-objects.md b/_zh-cn/overviews/scala3-book/taste-objects.md index 10b5e80d47..f018639a04 100644 --- a/_zh-cn/overviews/scala3-book/taste-objects.md +++ b/_zh-cn/overviews/scala3-book/taste-objects.md @@ -2,6 +2,7 @@ title: 单例对象 type: section description: This section provides an introduction to the use of singleton objects in Scala 3. +languages:[en, ru] num: 12 previous-page: taste-functions next-page: taste-collections diff --git a/_zh-cn/overviews/scala3-book/taste-repl.md b/_zh-cn/overviews/scala3-book/taste-repl.md index 8e8599db9f..f79e289ee3 100644 --- a/_zh-cn/overviews/scala3-book/taste-repl.md +++ b/_zh-cn/overviews/scala3-book/taste-repl.md @@ -2,6 +2,7 @@ title: The REPL type: section description: This section provides an introduction to the Scala REPL. +languages:[en, ru] num: 6 previous-page: taste-hello-world next-page: taste-vars-data-types diff --git a/_zh-cn/overviews/scala3-book/taste-summary.md b/_zh-cn/overviews/scala3-book/taste-summary.md index dd320bea58..de94900bac 100644 --- a/_zh-cn/overviews/scala3-book/taste-summary.md +++ b/_zh-cn/overviews/scala3-book/taste-summary.md @@ -2,6 +2,7 @@ title: Summary type: section description: This page provides a summary of the previous 'Taste of Scala' sections. +languages:[en, ru] num: 16 previous-page: taste-toplevel-definitions next-page: first-look-at-types diff --git a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md index e36a35adc6..f1999743c3 100644 --- a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md +++ b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md @@ -2,6 +2,7 @@ title: Toplevel Definitions type: section description: This page provides an introduction to top-level definitions in Scala 3 +languages:[en, ru] num: 15 previous-page: taste-contextual-abstractions next-page: taste-summary diff --git a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md index 9ac7ab79b0..c1d0642427 100644 --- a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md +++ b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md @@ -2,6 +2,7 @@ title: 变量和数据类型 type: section description: This section demonstrates val and var variables, and some common Scala data types. +languages:[en, ru] num: 7 previous-page: taste-repl next-page: taste-control-structures @@ -289,4 +290,4 @@ val quote = """The essence of Scala: > 有关字符串插值器和多行字符串的更多详细信息，请参阅[“类型初探”章节][first-look]。 -[first-look]: {% link _zh-cn/overviews/scala3-book/first-look-at-types.md %} \ No newline at end of file +[first-look]: {% link _zh-cn/overviews/scala3-book/first-look-at-types.md %} diff --git a/_zh-cn/overviews/scala3-book/tools-sbt.md b/_zh-cn/overviews/scala3-book/tools-sbt.md index 7e19cb629f..6e7c588fd3 100644 --- a/_zh-cn/overviews/scala3-book/tools-sbt.md +++ b/_zh-cn/overviews/scala3-book/tools-sbt.md @@ -2,6 +2,7 @@ title: 使用 sbt 构建和测试 Scala 项目 type: section description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. +languages:[en] num: 70 previous-page: scala-tools next-page: tools-worksheets diff --git a/_zh-cn/overviews/scala3-book/tools-worksheets.md b/_zh-cn/overviews/scala3-book/tools-worksheets.md index 811bc2763e..1de7f8a891 100644 --- a/_zh-cn/overviews/scala3-book/tools-worksheets.md +++ b/_zh-cn/overviews/scala3-book/tools-worksheets.md @@ -2,6 +2,7 @@ title: worksheet type: section description: This section looks at worksheets, an alternative to Scala projects. +languages:[en] num: 71 previous-page: tools-sbt next-page: interacting-with-java diff --git a/_zh-cn/overviews/scala3-book/types-adts-gadts.md b/_zh-cn/overviews/scala3-book/types-adts-gadts.md index 367e77394d..e311fb7a33 100644 --- a/_zh-cn/overviews/scala3-book/types-adts-gadts.md +++ b/_zh-cn/overviews/scala3-book/types-adts-gadts.md @@ -2,6 +2,7 @@ title: 代数数据类型 type: section description: This section introduces and demonstrates algebraic data types (ADTs) in Scala 3. +languages:[en] num: 52 previous-page: types-union next-page: types-variance diff --git a/_zh-cn/overviews/scala3-book/types-dependent-function.md b/_zh-cn/overviews/scala3-book/types-dependent-function.md index 1b9c29ebcf..d19e7abb6c 100644 --- a/_zh-cn/overviews/scala3-book/types-dependent-function.md +++ b/_zh-cn/overviews/scala3-book/types-dependent-function.md @@ -2,6 +2,7 @@ title: 依赖函数类型 type: section description: This section introduces and demonstrates dependent function types in Scala 3. +languages:[en] num: 56 previous-page: types-structural next-page: types-others diff --git a/_zh-cn/overviews/scala3-book/types-generics.md b/_zh-cn/overviews/scala3-book/types-generics.md index 484327c62c..bc7eb8f379 100644 --- a/_zh-cn/overviews/scala3-book/types-generics.md +++ b/_zh-cn/overviews/scala3-book/types-generics.md @@ -2,6 +2,7 @@ title: 泛型 type: section description: This section introduces and demonstrates generics in Scala 3. +languages:[en] num: 49 previous-page: types-inferred next-page: types-intersection diff --git a/_zh-cn/overviews/scala3-book/types-inferred.md b/_zh-cn/overviews/scala3-book/types-inferred.md index 8954a93cc4..db6c282662 100644 --- a/_zh-cn/overviews/scala3-book/types-inferred.md +++ b/_zh-cn/overviews/scala3-book/types-inferred.md @@ -2,6 +2,7 @@ title: 类型推断 type: section description: This section introduces and demonstrates inferred types in Scala 3 +languages:[en] num: 48 previous-page: types-introduction next-page: types-generics diff --git a/_zh-cn/overviews/scala3-book/types-intersection.md b/_zh-cn/overviews/scala3-book/types-intersection.md index 711ad81a01..870e0b6aac 100644 --- a/_zh-cn/overviews/scala3-book/types-intersection.md +++ b/_zh-cn/overviews/scala3-book/types-intersection.md @@ -2,6 +2,7 @@ title: 相交类型 type: section description: This section introduces and demonstrates intersection types in Scala 3. +languages:[en] num: 50 previous-page: types-generics next-page: types-union diff --git a/_zh-cn/overviews/scala3-book/types-introduction.md b/_zh-cn/overviews/scala3-book/types-introduction.md index 6a425da596..9c6e492976 100644 --- a/_zh-cn/overviews/scala3-book/types-introduction.md +++ b/_zh-cn/overviews/scala3-book/types-introduction.md @@ -2,6 +2,7 @@ title: 类型和类型系统 type: chapter description: This chapter provides an introduction to Scala 3 types and the type system. +languages:[en] num: 47 previous-page: fp-summary next-page: types-inferred diff --git a/_zh-cn/overviews/scala3-book/types-opaque-types.md b/_zh-cn/overviews/scala3-book/types-opaque-types.md index eab037e2c3..349a7272d7 100644 --- a/_zh-cn/overviews/scala3-book/types-opaque-types.md +++ b/_zh-cn/overviews/scala3-book/types-opaque-types.md @@ -2,6 +2,7 @@ title: 不透明类型 type: section description: This section introduces and demonstrates opaque types in Scala 3. +languages:[en] num: 54 previous-page: types-variance next-page: types-structural diff --git a/_zh-cn/overviews/scala3-book/types-others.md b/_zh-cn/overviews/scala3-book/types-others.md index 8861090281..61f3a14a57 100644 --- a/_zh-cn/overviews/scala3-book/types-others.md +++ b/_zh-cn/overviews/scala3-book/types-others.md @@ -2,6 +2,7 @@ title: 其他类型 type: section description: This section mentions other advanced types in Scala 3. +languages:[en] num: 57 previous-page: types-dependent-function next-page: ca-contextual-abstractions-intro diff --git a/_zh-cn/overviews/scala3-book/types-structural.md b/_zh-cn/overviews/scala3-book/types-structural.md index 3ea74afdda..bb7904c2c8 100644 --- a/_zh-cn/overviews/scala3-book/types-structural.md +++ b/_zh-cn/overviews/scala3-book/types-structural.md @@ -2,6 +2,7 @@ title: 结构化类型 type: section description: This section introduces and demonstrates structural types in Scala 3. +languages:[en] num: 55 previous-page: types-opaque-types next-page: types-dependent-function diff --git a/_zh-cn/overviews/scala3-book/types-type-classes.md b/_zh-cn/overviews/scala3-book/types-type-classes.md index 331b83f2ab..4a7007d9ab 100644 --- a/_zh-cn/overviews/scala3-book/types-type-classes.md +++ b/_zh-cn/overviews/scala3-book/types-type-classes.md @@ -2,6 +2,7 @@ title: Type Classes type: section description: This section introduces type classes in Scala 3. +languages:[en] num: 60 previous-page: ca-given-using-clauses next-page: ca-context-bounds diff --git a/_zh-cn/overviews/scala3-book/types-union.md b/_zh-cn/overviews/scala3-book/types-union.md index 826fc63acd..192c23fdee 100644 --- a/_zh-cn/overviews/scala3-book/types-union.md +++ b/_zh-cn/overviews/scala3-book/types-union.md @@ -2,6 +2,7 @@ title: 联合类型 type: section description: This section introduces and demonstrates union types in Scala 3. +languages:[en] num: 51 previous-page: types-intersection next-page: types-adts-gadts diff --git a/_zh-cn/overviews/scala3-book/types-variance.md b/_zh-cn/overviews/scala3-book/types-variance.md index 9b6274d6ec..e24949842f 100644 --- a/_zh-cn/overviews/scala3-book/types-variance.md +++ b/_zh-cn/overviews/scala3-book/types-variance.md @@ -2,6 +2,7 @@ title: 型变 type: section description: This section introduces and demonstrates variance in Scala 3. +languages:[en] num: 53 previous-page: types-adts-gadts next-page: types-opaque-types diff --git a/_zh-cn/overviews/scala3-book/where-next.md b/_zh-cn/overviews/scala3-book/where-next.md index 3cd5a6e729..c4e79341d0 100644 --- a/_zh-cn/overviews/scala3-book/where-next.md +++ b/_zh-cn/overviews/scala3-book/where-next.md @@ -2,6 +2,7 @@ title: 下一步去哪 type: chapter description: Where to go next after reading the Scala Book +languages:[en] num: 76 previous-page: scala-for-python-devs next-page: diff --git a/_zh-cn/overviews/scala3-book/why-scala-3.md b/_zh-cn/overviews/scala3-book/why-scala-3.md index ce9eba7084..207acf248e 100644 --- a/_zh-cn/overviews/scala3-book/why-scala-3.md +++ b/_zh-cn/overviews/scala3-book/why-scala-3.md @@ -2,6 +2,7 @@ title: 为什么是 Scala 3 ？ type: chapter description: This page describes the benefits of the Scala 3 programming language. +languages:[en, ru] num: 3 previous-page: scala-features next-page: taste-intro From 470973607a3913ef7fd2adbe5d850d8f859d2c38 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Sat, 31 Dec 2022 00:21:11 +0000 Subject: [PATCH 2426/3075] Update SIPs state --- _sips/sips/wildcard-context-bounds.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/wildcard-context-bounds.md diff --git a/_sips/sips/wildcard-context-bounds.md b/_sips/sips/wildcard-context-bounds.md new file mode 100644 index 0000000000..bdbcb76ebd --- /dev/null +++ b/_sips/sips/wildcard-context-bounds.md @@ -0,0 +1,7 @@ +--- +title: SIP-52 - Wildcard context bounds +status: under-review +pull-request-number: 55 +stage: design + +--- From 50701f2d7749630a45b784236d7fff95ea2b67d0 Mon Sep 17 00:00:00 2001 From: Mohammad Hossein Ghaffari <13206657+mhghaffari@users.noreply.github.com> Date: Mon, 2 Jan 2023 17:03:33 +0330 Subject: [PATCH 2427/3075] Update pattern-matching.md The `VoiceRecording` case was not existed in the code to cause the warning. --- _tour/pattern-matching.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index 4ef988529b..60c00669a1 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -255,6 +255,8 @@ def showNotification(notification: Notification): String = { s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" + case VoiceRecording(contactName: String, link: String) => + s"You received a Voice Recording from $name! Click the link to hear it: $link" } } ``` @@ -267,6 +269,8 @@ def showNotification(notification: Notification): String = s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" + case VoiceRecording(contactName: String, link: String) => + s"You received a Voice Recording from $name! Click the link to hear it: $link" ``` {% endtab %} {% endtabs %} From 5af3d5ee7fd11585f92a0d660f8306a2e72fa116 Mon Sep 17 00:00:00 2001 From: Mohammad Hossein Ghaffari <13206657+mhghaffari@users.noreply.github.com> Date: Mon, 2 Jan 2023 18:04:44 +0330 Subject: [PATCH 2428/3075] Update _tour/pattern-matching.md Co-authored-by: Philippus Baalman --- _tour/pattern-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index 60c00669a1..8e3374c837 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -255,7 +255,7 @@ def showNotification(notification: Notification): String = { s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" - case VoiceRecording(contactName: String, link: String) => + case VoiceRecording(name, link) => s"You received a Voice Recording from $name! Click the link to hear it: $link" } } From 50c97d5d800e106f160e5bcc3a63b52fe0a64385 Mon Sep 17 00:00:00 2001 From: Mohammad Hossein Ghaffari <13206657+mhghaffari@users.noreply.github.com> Date: Mon, 2 Jan 2023 18:04:53 +0330 Subject: [PATCH 2429/3075] Update _tour/pattern-matching.md Co-authored-by: Philippus Baalman --- _tour/pattern-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index 8e3374c837..8086f51b06 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -269,7 +269,7 @@ def showNotification(notification: Notification): String = s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" - case VoiceRecording(contactName: String, link: String) => + case VoiceRecording(name, link) => s"You received a Voice Recording from $name! Click the link to hear it: $link" ``` {% endtab %} From 0b40560157bc4d94ac6e8f4eb4a438d4eb843d64 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 3 Jan 2023 20:57:56 +0800 Subject: [PATCH 2430/3075] corrected to "language: zh-cn" --- _zh-cn/overviews/scala3-book/ca-context-bounds.md | 2 +- .../scala3-book/ca-contextual-abstractions-intro.md | 2 +- _zh-cn/overviews/scala3-book/ca-extension-methods.md | 2 +- _zh-cn/overviews/scala3-book/ca-given-imports.md | 2 +- _zh-cn/overviews/scala3-book/ca-given-using-clauses.md | 2 +- _zh-cn/overviews/scala3-book/ca-implicit-conversions.md | 2 +- _zh-cn/overviews/scala3-book/ca-multiversal-equality.md | 2 +- _zh-cn/overviews/scala3-book/ca-summary.md | 2 +- _zh-cn/overviews/scala3-book/ca-type-classes.md | 2 +- _zh-cn/overviews/scala3-book/collections-classes.md | 6 +++--- _zh-cn/overviews/scala3-book/collections-intro.md | 2 +- _zh-cn/overviews/scala3-book/collections-methods.md | 2 +- _zh-cn/overviews/scala3-book/collections-summary.md | 2 +- _zh-cn/overviews/scala3-book/concurrency.md | 2 +- _zh-cn/overviews/scala3-book/control-structures.md | 2 +- _zh-cn/overviews/scala3-book/domain-modeling-fp.md | 2 +- _zh-cn/overviews/scala3-book/domain-modeling-intro.md | 2 +- _zh-cn/overviews/scala3-book/domain-modeling-oop.md | 2 +- _zh-cn/overviews/scala3-book/domain-modeling-tools.md | 2 +- _zh-cn/overviews/scala3-book/first-look-at-types.md | 2 +- .../overviews/scala3-book/fp-functional-error-handling.md | 2 +- _zh-cn/overviews/scala3-book/fp-functions-are-values.md | 8 +------- _zh-cn/overviews/scala3-book/fp-immutable-values.md | 2 +- _zh-cn/overviews/scala3-book/fp-intro.md | 2 +- _zh-cn/overviews/scala3-book/fp-pure-functions.md | 2 +- _zh-cn/overviews/scala3-book/fp-summary.md | 2 +- _zh-cn/overviews/scala3-book/fp-what-is-fp.md | 2 +- _zh-cn/overviews/scala3-book/fun-anonymous-functions.md | 2 +- _zh-cn/overviews/scala3-book/fun-eta-expansion.md | 2 +- _zh-cn/overviews/scala3-book/fun-function-variables.md | 2 +- _zh-cn/overviews/scala3-book/fun-hofs.md | 2 +- _zh-cn/overviews/scala3-book/fun-intro.md | 2 +- _zh-cn/overviews/scala3-book/fun-summary.md | 2 +- _zh-cn/overviews/scala3-book/fun-write-map-function.md | 2 +- .../scala3-book/fun-write-method-returns-function.md | 2 +- _zh-cn/overviews/scala3-book/interacting-with-java.md | 2 +- _zh-cn/overviews/scala3-book/introduction.md | 2 +- _zh-cn/overviews/scala3-book/methods-intro.md | 2 +- _zh-cn/overviews/scala3-book/methods-main-methods.md | 2 +- _zh-cn/overviews/scala3-book/methods-most.md | 2 +- _zh-cn/overviews/scala3-book/methods-summary.md | 2 +- _zh-cn/overviews/scala3-book/packaging-imports.md | 2 +- _zh-cn/overviews/scala3-book/scala-features.md | 6 +----- _zh-cn/overviews/scala3-book/scala-for-java-devs.md | 2 +- _zh-cn/overviews/scala3-book/scala-for-javascript-devs.md | 2 +- _zh-cn/overviews/scala3-book/scala-for-python-devs.md | 2 +- _zh-cn/overviews/scala3-book/scala-tools.md | 2 +- _zh-cn/overviews/scala3-book/taste-collections.md | 2 +- .../scala3-book/taste-contextual-abstractions.md | 2 +- _zh-cn/overviews/scala3-book/taste-control-structures.md | 2 +- _zh-cn/overviews/scala3-book/taste-functions.md | 2 +- _zh-cn/overviews/scala3-book/taste-hello-world.md | 2 +- _zh-cn/overviews/scala3-book/taste-intro.md | 2 +- _zh-cn/overviews/scala3-book/taste-methods.md | 2 +- _zh-cn/overviews/scala3-book/taste-modeling.md | 2 +- _zh-cn/overviews/scala3-book/taste-objects.md | 2 +- _zh-cn/overviews/scala3-book/taste-repl.md | 2 +- _zh-cn/overviews/scala3-book/taste-summary.md | 2 +- .../overviews/scala3-book/taste-toplevel-definitions.md | 2 +- _zh-cn/overviews/scala3-book/taste-vars-data-types.md | 2 +- _zh-cn/overviews/scala3-book/tools-sbt.md | 2 +- _zh-cn/overviews/scala3-book/tools-worksheets.md | 2 +- _zh-cn/overviews/scala3-book/types-adts-gadts.md | 2 +- _zh-cn/overviews/scala3-book/types-dependent-function.md | 2 +- _zh-cn/overviews/scala3-book/types-generics.md | 2 +- _zh-cn/overviews/scala3-book/types-inferred.md | 2 +- _zh-cn/overviews/scala3-book/types-intersection.md | 2 +- _zh-cn/overviews/scala3-book/types-introduction.md | 2 +- _zh-cn/overviews/scala3-book/types-opaque-types.md | 2 +- _zh-cn/overviews/scala3-book/types-others.md | 2 +- _zh-cn/overviews/scala3-book/types-structural.md | 2 +- _zh-cn/overviews/scala3-book/types-type-classes.md | 2 +- _zh-cn/overviews/scala3-book/types-union.md | 2 +- _zh-cn/overviews/scala3-book/types-variance.md | 2 +- _zh-cn/overviews/scala3-book/where-next.md | 2 +- _zh-cn/overviews/scala3-book/why-scala-3.md | 2 +- 76 files changed, 78 insertions(+), 88 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index b47b9f5907..2227899378 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -2,7 +2,7 @@ title: 上下文绑定 type: section description: This page demonstrates Context Bounds in Scala 3. -languages:[en] +language: zh-cn num: 61 previous-page: types-type-classes next-page: ca-given-imports diff --git a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md index 65fb42fb01..80136106d6 100644 --- a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -2,7 +2,7 @@ title: 上下文抽象 type: chapter description: This chapter provides an introduction to the Scala 3 concept of Contextual Abstractions. -languages:[en] +language: zh-cn num: 58 previous-page: types-others next-page: ca-given-using-clauses diff --git a/_zh-cn/overviews/scala3-book/ca-extension-methods.md b/_zh-cn/overviews/scala3-book/ca-extension-methods.md index 8a7f3154ef..43738e53d2 100644 --- a/_zh-cn/overviews/scala3-book/ca-extension-methods.md +++ b/_zh-cn/overviews/scala3-book/ca-extension-methods.md @@ -2,7 +2,7 @@ title: 扩展方法 type: section description: This page demonstrates how Extension Methods work in Scala 3. -languages:[en] +language: zh-cn num: 63 previous-page: ca-given-imports next-page: ca-type-classes diff --git a/_zh-cn/overviews/scala3-book/ca-given-imports.md b/_zh-cn/overviews/scala3-book/ca-given-imports.md index 63721bf920..4c95c35d52 100644 --- a/_zh-cn/overviews/scala3-book/ca-given-imports.md +++ b/_zh-cn/overviews/scala3-book/ca-given-imports.md @@ -2,7 +2,7 @@ title: Given 导入 type: section description: This page demonstrates how 'given' import statements work in Scala 3. -languages:[en] +language: zh-cn num: 62 previous-page: ca-context-bounds next-page: ca-extension-methods diff --git a/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md b/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md index 888b749309..9a492c25aa 100644 --- a/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md +++ b/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md @@ -2,7 +2,7 @@ title: Given 实例和 Using 语句 type: section description: This page demonstrates how to use 'given' instances and 'using' clauses in Scala 3. -languages:[en] +language: zh-cn num: 59 previous-page: ca-contextual-abstractions-intro next-page: types-type-classes diff --git a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md index 3108f639c4..5ab40c8064 100644 --- a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md +++ b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md @@ -2,7 +2,7 @@ title: 隐式转换 type: section description: This page demonstrates how to implement Implicit Conversions in Scala 3. -languages:[en] +language: zh-cn num: 66 previous-page: ca-multiversal-equality next-page: ca-summary diff --git a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md index 6878ecb2b1..9c6d2f422c 100644 --- a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md +++ b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md @@ -2,7 +2,7 @@ title: 多元相等性 type: section description: This page demonstrates how to implement Multiversal Equality in Scala 3. -languages:[en] +language: zh-cn num: 65 previous-page: ca-type-classes next-page: ca-implicit-conversions diff --git a/_zh-cn/overviews/scala3-book/ca-summary.md b/_zh-cn/overviews/scala3-book/ca-summary.md index d66b9baa13..60b1fd01a5 100644 --- a/_zh-cn/overviews/scala3-book/ca-summary.md +++ b/_zh-cn/overviews/scala3-book/ca-summary.md @@ -2,7 +2,7 @@ title: 总结 type: section description: This page provides a summary of the Contextual Abstractions lessons. -languages:[en] +language: zh-cn num: 67 previous-page: ca-implicit-conversions next-page: concurrency diff --git a/_zh-cn/overviews/scala3-book/ca-type-classes.md b/_zh-cn/overviews/scala3-book/ca-type-classes.md index 46e36e4c4d..1cd49103a3 100644 --- a/_zh-cn/overviews/scala3-book/ca-type-classes.md +++ b/_zh-cn/overviews/scala3-book/ca-type-classes.md @@ -2,7 +2,7 @@ title: 实现类型类 type: section description: This page demonstrates how to create and use type classes in Scala 3. -languages:[en] +language: zh-cn num: 64 previous-page: ca-extension-methods next-page: ca-multiversal-equality diff --git a/_zh-cn/overviews/scala3-book/collections-classes.md b/_zh-cn/overviews/scala3-book/collections-classes.md index 0a56e4e0ed..307395fba9 100644 --- a/_zh-cn/overviews/scala3-book/collections-classes.md +++ b/_zh-cn/overviews/scala3-book/collections-classes.md @@ -2,7 +2,7 @@ title: 集合类型 type: section description: This page introduces the common Scala 3 collections types and some of their methods. -languages:[en] +language: zh-cn num: 37 previous-page: collections-intro next-page: collections-methods @@ -372,9 +372,9 @@ val people = ArrayBuffer( ```scala val nums = ArrayBuffer(1, 2, 3) // ArrayBuffer(1, 2, 3) -languages:[en] +language: zh-cn nums += 4 // ArrayBuffer(1, 2, 3, 4) -languages:[en] +language: zh-cn nums ++= List(5, 6) // ArrayBuffer(1, 2, 3, 4, 5, 6) ``` diff --git a/_zh-cn/overviews/scala3-book/collections-intro.md b/_zh-cn/overviews/scala3-book/collections-intro.md index 41e596f14e..6d21b2f59b 100644 --- a/_zh-cn/overviews/scala3-book/collections-intro.md +++ b/_zh-cn/overviews/scala3-book/collections-intro.md @@ -2,7 +2,7 @@ title: Scala 集合 type: chapter description: This page provides and introduction to the common collections classes and their methods in Scala 3. -languages:[en] +language: zh-cn num: 36 previous-page: packaging-imports next-page: collections-classes diff --git a/_zh-cn/overviews/scala3-book/collections-methods.md b/_zh-cn/overviews/scala3-book/collections-methods.md index 3dd16e82a6..93ca03d15a 100644 --- a/_zh-cn/overviews/scala3-book/collections-methods.md +++ b/_zh-cn/overviews/scala3-book/collections-methods.md @@ -2,7 +2,7 @@ title: 集合方法 type: section description: This page demonstrates the common methods on the Scala 3 collections classes. -languages:[en] +language: zh-cn num: 38 previous-page: collections-classes next-page: collections-summary diff --git a/_zh-cn/overviews/scala3-book/collections-summary.md b/_zh-cn/overviews/scala3-book/collections-summary.md index 63269efe24..465f339f19 100644 --- a/_zh-cn/overviews/scala3-book/collections-summary.md +++ b/_zh-cn/overviews/scala3-book/collections-summary.md @@ -2,7 +2,7 @@ title: 总结 type: section description: This page provides a summary of the Collections chapter. -languages:[en] +language: zh-cn num: 39 previous-page: collections-methods next-page: fp-intro diff --git a/_zh-cn/overviews/scala3-book/concurrency.md b/_zh-cn/overviews/scala3-book/concurrency.md index bbbeca4b0d..169e1f1684 100644 --- a/_zh-cn/overviews/scala3-book/concurrency.md +++ b/_zh-cn/overviews/scala3-book/concurrency.md @@ -2,7 +2,7 @@ title: 并发 type: chapter description: This page discusses how Scala concurrency works, with an emphasis on Scala Futures. -languages:[en] +language: zh-cn num: 68 previous-page: ca-summary next-page: scala-tools diff --git a/_zh-cn/overviews/scala3-book/control-structures.md b/_zh-cn/overviews/scala3-book/control-structures.md index bc5bfc06ff..a639686f9c 100644 --- a/_zh-cn/overviews/scala3-book/control-structures.md +++ b/_zh-cn/overviews/scala3-book/control-structures.md @@ -2,7 +2,7 @@ title: 控制结构 type: chapter description: This page provides an introduction to Scala's control structures, including if/then/else, 'for' loops, 'for' expressions, 'match' expressions, try/catch/finally, and 'while' loops. -languages:[en, ru] +language: zh-cn num: 18 previous-page: first-look-at-types next-page: domain-modeling-intro diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md index 4ba980d9d0..e9f6933cad 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md @@ -2,7 +2,7 @@ title: 函数式领域建模 type: section description: This chapter provides an introduction to FP domain modeling with Scala 3. -languages:[en, ru] +language: zh-cn num: 22 previous-page: domain-modeling-oop next-page: methods-intro diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-intro.md b/_zh-cn/overviews/scala3-book/domain-modeling-intro.md index 9a36b2894b..db31d9c528 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-intro.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-intro.md @@ -2,7 +2,7 @@ title: 领域建模 type: chapter description: This chapter provides an introduction to domain modeling in Scala 3. -languages:[en, ru] +language: zh-cn num: 19 previous-page: control-structures next-page: domain-modeling-tools diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md index 204e1ce3c1..a04c1fba41 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md @@ -2,7 +2,7 @@ title: OOP 领域建模 type: section description: This chapter provides an introduction to OOP domain modeling with Scala 3. -languages:[en, ru] +language: zh-cn num: 21 previous-page: domain-modeling-tools next-page: domain-modeling-fp diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md index 42deec841b..eb37e8e7f4 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md @@ -2,7 +2,7 @@ title: 工具 type: section description: This chapter provides an introduction to the available domain modeling tools in Scala 3, including classes, traits, enums, and more. -languages:[en, ru] +language: zh-cn num: 20 previous-page: domain-modeling-intro next-page: domain-modeling-oop diff --git a/_zh-cn/overviews/scala3-book/first-look-at-types.md b/_zh-cn/overviews/scala3-book/first-look-at-types.md index 692e7707b8..03604b8180 100644 --- a/_zh-cn/overviews/scala3-book/first-look-at-types.md +++ b/_zh-cn/overviews/scala3-book/first-look-at-types.md @@ -2,7 +2,7 @@ title: 类型初探 type: chapter description: This page provides a brief introduction to Scala's built-in data types, including Int, Double, String, Long, Any, AnyRef, Nothing, and Null. -languages:[en, ru] +language: zh-cn num: 17 previous-page: taste-summary next-page: control-structures diff --git a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md index 7cb70257ff..d16d0eb80c 100644 --- a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md +++ b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md @@ -2,7 +2,7 @@ title: 函数式错误处理 type: section description: This section provides an introduction to functional error handling in Scala 3. -languages:[en] +language: zh-cn num: 45 previous-page: fp-functions-are-values next-page: fp-summary diff --git a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md index 1e5a571c9d..472abcead3 100644 --- a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md +++ b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md @@ -2,7 +2,7 @@ title: 函数是值 type: section description: This section looks at the use of functions as values in functional programming. -languages:[en] +language: zh-cn num: 44 previous-page: fp-pure-functions next-page: fp-functional-error-handling @@ -92,18 +92,12 @@ fruits.map(_.toUpperCase) // List(APPLE, PEAR) fruits.flatMap(_.toUpperCase) // List(A, P, P, L, E, P, E, A, R) val nums = List(5, 1, 3, 11, 7) -languages:[en] nums.map(_ * 2) // List(10, 2, 6, 22, 14) -languages:[en] nums.filter(_ > 3) // List(5, 11, 7) -languages:[en] nums.takeWhile(_ < 6) // List(5, 1, 3) -languages:[en] nums.sortWith(_ < _) // List(1, 3, 5, 7, 11) -languages:[en] nums.sortWith(_ > _) // List(11, 7, 5, 3, 1) -languages:[en] nums.takeWhile(_ < 6).sortWith(_ < _) // List(1, 3, 5) ``` diff --git a/_zh-cn/overviews/scala3-book/fp-immutable-values.md b/_zh-cn/overviews/scala3-book/fp-immutable-values.md index 27a192d7e6..eb39d3daec 100644 --- a/_zh-cn/overviews/scala3-book/fp-immutable-values.md +++ b/_zh-cn/overviews/scala3-book/fp-immutable-values.md @@ -2,7 +2,7 @@ title: 不可变值 type: section description: This section looks at the use of immutable values in functional programming. -languages:[en] +language: zh-cn num: 42 previous-page: fp-what-is-fp next-page: fp-pure-functions diff --git a/_zh-cn/overviews/scala3-book/fp-intro.md b/_zh-cn/overviews/scala3-book/fp-intro.md index 39e500d187..f0862626d2 100644 --- a/_zh-cn/overviews/scala3-book/fp-intro.md +++ b/_zh-cn/overviews/scala3-book/fp-intro.md @@ -2,7 +2,7 @@ title: 函数式编程 type: chapter description: This chapter provides an introduction to functional programming in Scala 3. -languages:[en] +language: zh-cn num: 40 previous-page: collections-summary next-page: fp-what-is-fp diff --git a/_zh-cn/overviews/scala3-book/fp-pure-functions.md b/_zh-cn/overviews/scala3-book/fp-pure-functions.md index 135a0c48bc..ef4803036a 100644 --- a/_zh-cn/overviews/scala3-book/fp-pure-functions.md +++ b/_zh-cn/overviews/scala3-book/fp-pure-functions.md @@ -2,7 +2,7 @@ title: 纯函数 type: section description: This section looks at the use of pure functions in functional programming. -languages:[en] +language: zh-cn num: 43 previous-page: fp-immutable-values next-page: fp-functions-are-values diff --git a/_zh-cn/overviews/scala3-book/fp-summary.md b/_zh-cn/overviews/scala3-book/fp-summary.md index 6541bc074e..f9c4dfce8f 100644 --- a/_zh-cn/overviews/scala3-book/fp-summary.md +++ b/_zh-cn/overviews/scala3-book/fp-summary.md @@ -2,7 +2,7 @@ title: 总结 type: section description: This section summarizes the previous functional programming sections. -languages:[en] +language: zh-cn num: 46 previous-page: fp-functional-error-handling next-page: types-introduction diff --git a/_zh-cn/overviews/scala3-book/fp-what-is-fp.md b/_zh-cn/overviews/scala3-book/fp-what-is-fp.md index a4f5164926..6411b55c41 100644 --- a/_zh-cn/overviews/scala3-book/fp-what-is-fp.md +++ b/_zh-cn/overviews/scala3-book/fp-what-is-fp.md @@ -2,7 +2,7 @@ title: 什么是函数式编程？ type: section description: This section provides an answer to the question, what is functional programming? -languages:[en] +language: zh-cn num: 41 previous-page: fp-intro next-page: fp-immutable-values diff --git a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md index 88f92897d5..f86a953bae 100644 --- a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md +++ b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md @@ -2,7 +2,7 @@ title: 匿名函数 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. -languages:[en, ru] +language: zh-cn num: 28 previous-page: fun-intro next-page: fun-function-variables diff --git a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md index 7db5c96729..1c9ec31128 100644 --- a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md +++ b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md @@ -2,7 +2,7 @@ title: Eta 扩展 type: section description: This page discusses Eta Expansion, the Scala technology that automatically and transparently converts methods into functions. -languages:[en, ru] +language: zh-cn num: 30 previous-page: fun-function-variables next-page: fun-hofs diff --git a/_zh-cn/overviews/scala3-book/fun-function-variables.md b/_zh-cn/overviews/scala3-book/fun-function-variables.md index 078467197b..3113b83a37 100644 --- a/_zh-cn/overviews/scala3-book/fun-function-variables.md +++ b/_zh-cn/overviews/scala3-book/fun-function-variables.md @@ -2,7 +2,7 @@ title: 函数变量 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. -languages:[en, ru] +language: zh-cn num: 29 previous-page: fun-anonymous-functions next-page: fun-eta-expansion diff --git a/_zh-cn/overviews/scala3-book/fun-hofs.md b/_zh-cn/overviews/scala3-book/fun-hofs.md index 241f854966..3b5128e73f 100644 --- a/_zh-cn/overviews/scala3-book/fun-hofs.md +++ b/_zh-cn/overviews/scala3-book/fun-hofs.md @@ -2,7 +2,7 @@ title: 高阶函数 type: section description: This page demonstrates how to create and use higher-order functions in Scala. -languages:[en, ru] +language: zh-cn num: 31 previous-page: fun-eta-expansion next-page: fun-write-map-function diff --git a/_zh-cn/overviews/scala3-book/fun-intro.md b/_zh-cn/overviews/scala3-book/fun-intro.md index f42b272885..4bc7aceab3 100644 --- a/_zh-cn/overviews/scala3-book/fun-intro.md +++ b/_zh-cn/overviews/scala3-book/fun-intro.md @@ -2,7 +2,7 @@ title: 函数 type: chapter description: This chapter looks at all topics related to functions in Scala 3. -languages:[en, ru] +language: zh-cn num: 27 previous-page: methods-summary next-page: fun-anonymous-functions diff --git a/_zh-cn/overviews/scala3-book/fun-summary.md b/_zh-cn/overviews/scala3-book/fun-summary.md index fb382d2bee..f5bcecaaa2 100644 --- a/_zh-cn/overviews/scala3-book/fun-summary.md +++ b/_zh-cn/overviews/scala3-book/fun-summary.md @@ -2,7 +2,7 @@ title: 总结 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. -languages:[en, ru] +language: zh-cn num: 34 previous-page: fun-write-method-returns-function next-page: packaging-imports diff --git a/_zh-cn/overviews/scala3-book/fun-write-map-function.md b/_zh-cn/overviews/scala3-book/fun-write-map-function.md index bb8e82b056..0a48d583ec 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-map-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-map-function.md @@ -2,7 +2,7 @@ title: 自定义 map 函数 type: section description: This page demonstrates how to create and use higher-order functions in Scala. -languages:[en, ru] +language: zh-cn num: 32 previous-page: fun-hofs next-page: fun-write-method-returns-function diff --git a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md index fa93960616..0272c5242e 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md @@ -2,7 +2,7 @@ title: 创建可以返回函数的方法 type: section description: This page demonstrates how to create and use higher-order functions in Scala. -languages:[en, ru] +language: zh-cn num: 33 previous-page: fun-write-map-function next-page: fun-summary diff --git a/_zh-cn/overviews/scala3-book/interacting-with-java.md b/_zh-cn/overviews/scala3-book/interacting-with-java.md index 0498d7919b..f2263d0bd2 100644 --- a/_zh-cn/overviews/scala3-book/interacting-with-java.md +++ b/_zh-cn/overviews/scala3-book/interacting-with-java.md @@ -2,7 +2,7 @@ title: 与 Java 交互 type: chapter description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. -languages:[en] +language: zh-cn num: 72 previous-page: tools-worksheets next-page: scala-for-java-devs diff --git a/_zh-cn/overviews/scala3-book/introduction.md b/_zh-cn/overviews/scala3-book/introduction.md index 06fb982d8e..2e82050a0e 100644 --- a/_zh-cn/overviews/scala3-book/introduction.md +++ b/_zh-cn/overviews/scala3-book/introduction.md @@ -2,7 +2,7 @@ title: 导言 type: chapter description: This page begins the overview documentation of the Scala 3 language. -languages:[en, ru] +language: zh-cn num: 1 previous-page: next-page: scala-features diff --git a/_zh-cn/overviews/scala3-book/methods-intro.md b/_zh-cn/overviews/scala3-book/methods-intro.md index fd6e1a6006..4c72c7e549 100644 --- a/_zh-cn/overviews/scala3-book/methods-intro.md +++ b/_zh-cn/overviews/scala3-book/methods-intro.md @@ -2,7 +2,7 @@ title: 方法 type: chapter description: This section introduces methods in Scala 3. -languages:[en, ru] +language: zh-cn num: 23 previous-page: domain-modeling-fp next-page: methods-most diff --git a/_zh-cn/overviews/scala3-book/methods-main-methods.md b/_zh-cn/overviews/scala3-book/methods-main-methods.md index 42cccddfd1..82d711b231 100644 --- a/_zh-cn/overviews/scala3-book/methods-main-methods.md +++ b/_zh-cn/overviews/scala3-book/methods-main-methods.md @@ -2,7 +2,7 @@ title: main 方法 type: section description: This page describes how 'main' methods and the '@main' annotation work in Scala 3. -languages:[en, ru] +language: zh-cn num: 25 previous-page: methods-most next-page: methods-summary diff --git a/_zh-cn/overviews/scala3-book/methods-most.md b/_zh-cn/overviews/scala3-book/methods-most.md index c73453fd90..b1aa18a6fc 100644 --- a/_zh-cn/overviews/scala3-book/methods-most.md +++ b/_zh-cn/overviews/scala3-book/methods-most.md @@ -2,7 +2,7 @@ title: 方法特性 type: section description: This section introduces Scala 3 methods, including main methods, extension methods, and more. -languages:[en, ru] +language: zh-cn num: 24 previous-page: methods-intro next-page: methods-main-methods diff --git a/_zh-cn/overviews/scala3-book/methods-summary.md b/_zh-cn/overviews/scala3-book/methods-summary.md index 20fd7cb68b..d406f100c0 100644 --- a/_zh-cn/overviews/scala3-book/methods-summary.md +++ b/_zh-cn/overviews/scala3-book/methods-summary.md @@ -2,7 +2,7 @@ title: 总结 type: section description: This section summarizes the previous sections on Scala 3 methods. -languages:[en, ru] +language: zh-cn num: 26 previous-page: methods-main-methods next-page: fun-intro diff --git a/_zh-cn/overviews/scala3-book/packaging-imports.md b/_zh-cn/overviews/scala3-book/packaging-imports.md index 190796573a..b121f8b99c 100644 --- a/_zh-cn/overviews/scala3-book/packaging-imports.md +++ b/_zh-cn/overviews/scala3-book/packaging-imports.md @@ -2,7 +2,7 @@ title: 打包和导入 type: chapter description: A discussion of using packages and imports to organize your code, build related modules of code, control scope, and help prevent namespace collisions. -languages:[en] +language: zh-cn num: 35 previous-page: fun-summary next-page: collections-intro diff --git a/_zh-cn/overviews/scala3-book/scala-features.md b/_zh-cn/overviews/scala3-book/scala-features.md index 0b9761fe17..3674c522e5 100644 --- a/_zh-cn/overviews/scala3-book/scala-features.md +++ b/_zh-cn/overviews/scala3-book/scala-features.md @@ -2,7 +2,7 @@ title: Scala 3 特性 type: chapter description: This page discusses the main features of the Scala 3 programming language. -languages:[en, ru] +language: zh-cn num: 2 previous-page: introduction next-page: why-scala-3 @@ -117,14 +117,10 @@ val p = Person("Martin", "Odersky") {% tabs scala-features-4 %} {% tab 'Scala 2 and 3' for=scala-features-4 %} ```scala -languages:[en] nums.map(i => i * 2) // long form -languages:[en] nums.map(_ * 2) // short form -languages:[en] nums.filter(i => i > 1) -languages:[en] nums.filter(_ > 1) ``` {% endtab %} diff --git a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md index de7b4eea7a..39e9761c61 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md @@ -2,7 +2,7 @@ title: 向 Java 开发者介绍Scala type: chapter description: This page is for Java developers who are interested in learning about Scala 3. -languages:[en] +language: zh-cn num: 73 previous-page: interacting-with-java next-page: scala-for-javascript-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md index c5f4b907bd..aaaaf68bba 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md @@ -2,7 +2,7 @@ title: Scala for JavaScript Developers type: chapter description: This chapter provides an introduction to Scala 3 for JavaScript developers -languages:[en] +language: zh-cn num: 74 previous-page: scala-for-java-devs next-page: scala-for-python-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md index 4ee6dee030..f04d664894 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md @@ -2,7 +2,7 @@ title: Scala for Python Developers type: chapter description: This page is for Python developers who are interested in learning about Scala 3. -languages:[en] +language: zh-cn num: 75 previous-page: scala-for-javascript-devs next-page: diff --git a/_zh-cn/overviews/scala3-book/scala-tools.md b/_zh-cn/overviews/scala3-book/scala-tools.md index 4cd1637244..822c3d428a 100644 --- a/_zh-cn/overviews/scala3-book/scala-tools.md +++ b/_zh-cn/overviews/scala3-book/scala-tools.md @@ -2,7 +2,7 @@ title: Scala 工具 type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. -languages:[en] +language: zh-cn num: 69 previous-page: concurrency next-page: tools-sbt diff --git a/_zh-cn/overviews/scala3-book/taste-collections.md b/_zh-cn/overviews/scala3-book/taste-collections.md index 589a498f0a..d6b987a7a6 100644 --- a/_zh-cn/overviews/scala3-book/taste-collections.md +++ b/_zh-cn/overviews/scala3-book/taste-collections.md @@ -2,7 +2,7 @@ title: Collections type: section description: This page provides a high-level overview of the main features of the Scala 3 programming language. -languages:[en, ru] +language: zh-cn num: 13 previous-page: taste-objects next-page: taste-contextual-abstractions diff --git a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md index 6d181d09fa..d5610c6872 100644 --- a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md +++ b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md @@ -2,7 +2,7 @@ title: Contextual Abstractions type: section description: This section provides an introduction to Contextual Abstractions in Scala 3. -languages:[en, ru] +language: zh-cn num: 14 previous-page: taste-collections next-page: taste-toplevel-definitions diff --git a/_zh-cn/overviews/scala3-book/taste-control-structures.md b/_zh-cn/overviews/scala3-book/taste-control-structures.md index e45fbd3849..ea26f0ff42 100644 --- a/_zh-cn/overviews/scala3-book/taste-control-structures.md +++ b/_zh-cn/overviews/scala3-book/taste-control-structures.md @@ -2,7 +2,7 @@ title: 控制结构 type: section description: This section demonstrates Scala 3 control structures. -languages:[en, ru] +language: zh-cn num: 8 previous-page: taste-vars-data-types next-page: taste-modeling diff --git a/_zh-cn/overviews/scala3-book/taste-functions.md b/_zh-cn/overviews/scala3-book/taste-functions.md index 637dd40216..9c52d09213 100644 --- a/_zh-cn/overviews/scala3-book/taste-functions.md +++ b/_zh-cn/overviews/scala3-book/taste-functions.md @@ -2,7 +2,7 @@ title: First-Class Functions type: section description: This page provides an introduction to functions in Scala 3. -languages:[en, ru] +language: zh-cn num: 11 previous-page: taste-methods next-page: taste-objects diff --git a/_zh-cn/overviews/scala3-book/taste-hello-world.md b/_zh-cn/overviews/scala3-book/taste-hello-world.md index 2b8a8bd1b6..cebe30f7fa 100644 --- a/_zh-cn/overviews/scala3-book/taste-hello-world.md +++ b/_zh-cn/overviews/scala3-book/taste-hello-world.md @@ -2,7 +2,7 @@ title: Hello, World! type: section description: This section demonstrates a Scala 3 'Hello, World!' example. -languages:[en, ru] +language: zh-cn num: 5 previous-page: taste-intro next-page: taste-repl diff --git a/_zh-cn/overviews/scala3-book/taste-intro.md b/_zh-cn/overviews/scala3-book/taste-intro.md index fc975520c5..df7fed74bd 100644 --- a/_zh-cn/overviews/scala3-book/taste-intro.md +++ b/_zh-cn/overviews/scala3-book/taste-intro.md @@ -2,7 +2,7 @@ title: Scala 的味道 type: chapter description: This chapter provides a high-level overview of the main features of the Scala 3 programming language. -languages:[en, ru] +language: zh-cn num: 4 previous-page: why-scala-3 next-page: taste-hello-world diff --git a/_zh-cn/overviews/scala3-book/taste-methods.md b/_zh-cn/overviews/scala3-book/taste-methods.md index 1743286235..10e57ece93 100644 --- a/_zh-cn/overviews/scala3-book/taste-methods.md +++ b/_zh-cn/overviews/scala3-book/taste-methods.md @@ -2,7 +2,7 @@ title: Methods type: section description: This section provides an introduction to defining and using methods in Scala 3. -languages:[en, ru] +language: zh-cn num: 10 previous-page: taste-modeling next-page: taste-functions diff --git a/_zh-cn/overviews/scala3-book/taste-modeling.md b/_zh-cn/overviews/scala3-book/taste-modeling.md index 79fb6fa964..57981e10d3 100644 --- a/_zh-cn/overviews/scala3-book/taste-modeling.md +++ b/_zh-cn/overviews/scala3-book/taste-modeling.md @@ -2,7 +2,7 @@ title: 领域建模 type: section description: This section provides an introduction to data modeling in Scala 3. -languages:[en, ru] +language: zh-cn num: 9 previous-page: taste-control-structures next-page: taste-methods diff --git a/_zh-cn/overviews/scala3-book/taste-objects.md b/_zh-cn/overviews/scala3-book/taste-objects.md index f018639a04..e24d759a24 100644 --- a/_zh-cn/overviews/scala3-book/taste-objects.md +++ b/_zh-cn/overviews/scala3-book/taste-objects.md @@ -2,7 +2,7 @@ title: 单例对象 type: section description: This section provides an introduction to the use of singleton objects in Scala 3. -languages:[en, ru] +language: zh-cn num: 12 previous-page: taste-functions next-page: taste-collections diff --git a/_zh-cn/overviews/scala3-book/taste-repl.md b/_zh-cn/overviews/scala3-book/taste-repl.md index f79e289ee3..2b043bef03 100644 --- a/_zh-cn/overviews/scala3-book/taste-repl.md +++ b/_zh-cn/overviews/scala3-book/taste-repl.md @@ -2,7 +2,7 @@ title: The REPL type: section description: This section provides an introduction to the Scala REPL. -languages:[en, ru] +language: zh-cn num: 6 previous-page: taste-hello-world next-page: taste-vars-data-types diff --git a/_zh-cn/overviews/scala3-book/taste-summary.md b/_zh-cn/overviews/scala3-book/taste-summary.md index de94900bac..14c44c9bde 100644 --- a/_zh-cn/overviews/scala3-book/taste-summary.md +++ b/_zh-cn/overviews/scala3-book/taste-summary.md @@ -2,7 +2,7 @@ title: Summary type: section description: This page provides a summary of the previous 'Taste of Scala' sections. -languages:[en, ru] +language: zh-cn num: 16 previous-page: taste-toplevel-definitions next-page: first-look-at-types diff --git a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md index f1999743c3..11b577896f 100644 --- a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md +++ b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md @@ -2,7 +2,7 @@ title: Toplevel Definitions type: section description: This page provides an introduction to top-level definitions in Scala 3 -languages:[en, ru] +language: zh-cn num: 15 previous-page: taste-contextual-abstractions next-page: taste-summary diff --git a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md index c1d0642427..2c5a80e5a0 100644 --- a/_zh-cn/overviews/scala3-book/taste-vars-data-types.md +++ b/_zh-cn/overviews/scala3-book/taste-vars-data-types.md @@ -2,7 +2,7 @@ title: 变量和数据类型 type: section description: This section demonstrates val and var variables, and some common Scala data types. -languages:[en, ru] +language: zh-cn num: 7 previous-page: taste-repl next-page: taste-control-structures diff --git a/_zh-cn/overviews/scala3-book/tools-sbt.md b/_zh-cn/overviews/scala3-book/tools-sbt.md index 6e7c588fd3..3d4e78f4a1 100644 --- a/_zh-cn/overviews/scala3-book/tools-sbt.md +++ b/_zh-cn/overviews/scala3-book/tools-sbt.md @@ -2,7 +2,7 @@ title: 使用 sbt 构建和测试 Scala 项目 type: section description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. -languages:[en] +language: zh-cn num: 70 previous-page: scala-tools next-page: tools-worksheets diff --git a/_zh-cn/overviews/scala3-book/tools-worksheets.md b/_zh-cn/overviews/scala3-book/tools-worksheets.md index 1de7f8a891..214b744d8b 100644 --- a/_zh-cn/overviews/scala3-book/tools-worksheets.md +++ b/_zh-cn/overviews/scala3-book/tools-worksheets.md @@ -2,7 +2,7 @@ title: worksheet type: section description: This section looks at worksheets, an alternative to Scala projects. -languages:[en] +language: zh-cn num: 71 previous-page: tools-sbt next-page: interacting-with-java diff --git a/_zh-cn/overviews/scala3-book/types-adts-gadts.md b/_zh-cn/overviews/scala3-book/types-adts-gadts.md index e311fb7a33..9d3e469333 100644 --- a/_zh-cn/overviews/scala3-book/types-adts-gadts.md +++ b/_zh-cn/overviews/scala3-book/types-adts-gadts.md @@ -2,7 +2,7 @@ title: 代数数据类型 type: section description: This section introduces and demonstrates algebraic data types (ADTs) in Scala 3. -languages:[en] +language: zh-cn num: 52 previous-page: types-union next-page: types-variance diff --git a/_zh-cn/overviews/scala3-book/types-dependent-function.md b/_zh-cn/overviews/scala3-book/types-dependent-function.md index d19e7abb6c..fa5c8d8c82 100644 --- a/_zh-cn/overviews/scala3-book/types-dependent-function.md +++ b/_zh-cn/overviews/scala3-book/types-dependent-function.md @@ -2,7 +2,7 @@ title: 依赖函数类型 type: section description: This section introduces and demonstrates dependent function types in Scala 3. -languages:[en] +language: zh-cn num: 56 previous-page: types-structural next-page: types-others diff --git a/_zh-cn/overviews/scala3-book/types-generics.md b/_zh-cn/overviews/scala3-book/types-generics.md index bc7eb8f379..45fb52865b 100644 --- a/_zh-cn/overviews/scala3-book/types-generics.md +++ b/_zh-cn/overviews/scala3-book/types-generics.md @@ -2,7 +2,7 @@ title: 泛型 type: section description: This section introduces and demonstrates generics in Scala 3. -languages:[en] +language: zh-cn num: 49 previous-page: types-inferred next-page: types-intersection diff --git a/_zh-cn/overviews/scala3-book/types-inferred.md b/_zh-cn/overviews/scala3-book/types-inferred.md index db6c282662..ba52c8a9ce 100644 --- a/_zh-cn/overviews/scala3-book/types-inferred.md +++ b/_zh-cn/overviews/scala3-book/types-inferred.md @@ -2,7 +2,7 @@ title: 类型推断 type: section description: This section introduces and demonstrates inferred types in Scala 3 -languages:[en] +language: zh-cn num: 48 previous-page: types-introduction next-page: types-generics diff --git a/_zh-cn/overviews/scala3-book/types-intersection.md b/_zh-cn/overviews/scala3-book/types-intersection.md index 870e0b6aac..085c92c893 100644 --- a/_zh-cn/overviews/scala3-book/types-intersection.md +++ b/_zh-cn/overviews/scala3-book/types-intersection.md @@ -2,7 +2,7 @@ title: 相交类型 type: section description: This section introduces and demonstrates intersection types in Scala 3. -languages:[en] +language: zh-cn num: 50 previous-page: types-generics next-page: types-union diff --git a/_zh-cn/overviews/scala3-book/types-introduction.md b/_zh-cn/overviews/scala3-book/types-introduction.md index 9c6e492976..2acc837a59 100644 --- a/_zh-cn/overviews/scala3-book/types-introduction.md +++ b/_zh-cn/overviews/scala3-book/types-introduction.md @@ -2,7 +2,7 @@ title: 类型和类型系统 type: chapter description: This chapter provides an introduction to Scala 3 types and the type system. -languages:[en] +language: zh-cn num: 47 previous-page: fp-summary next-page: types-inferred diff --git a/_zh-cn/overviews/scala3-book/types-opaque-types.md b/_zh-cn/overviews/scala3-book/types-opaque-types.md index 349a7272d7..f68f798641 100644 --- a/_zh-cn/overviews/scala3-book/types-opaque-types.md +++ b/_zh-cn/overviews/scala3-book/types-opaque-types.md @@ -2,7 +2,7 @@ title: 不透明类型 type: section description: This section introduces and demonstrates opaque types in Scala 3. -languages:[en] +language: zh-cn num: 54 previous-page: types-variance next-page: types-structural diff --git a/_zh-cn/overviews/scala3-book/types-others.md b/_zh-cn/overviews/scala3-book/types-others.md index 61f3a14a57..cb09102805 100644 --- a/_zh-cn/overviews/scala3-book/types-others.md +++ b/_zh-cn/overviews/scala3-book/types-others.md @@ -2,7 +2,7 @@ title: 其他类型 type: section description: This section mentions other advanced types in Scala 3. -languages:[en] +language: zh-cn num: 57 previous-page: types-dependent-function next-page: ca-contextual-abstractions-intro diff --git a/_zh-cn/overviews/scala3-book/types-structural.md b/_zh-cn/overviews/scala3-book/types-structural.md index bb7904c2c8..694da0c635 100644 --- a/_zh-cn/overviews/scala3-book/types-structural.md +++ b/_zh-cn/overviews/scala3-book/types-structural.md @@ -2,7 +2,7 @@ title: 结构化类型 type: section description: This section introduces and demonstrates structural types in Scala 3. -languages:[en] +language: zh-cn num: 55 previous-page: types-opaque-types next-page: types-dependent-function diff --git a/_zh-cn/overviews/scala3-book/types-type-classes.md b/_zh-cn/overviews/scala3-book/types-type-classes.md index 4a7007d9ab..88c39a5631 100644 --- a/_zh-cn/overviews/scala3-book/types-type-classes.md +++ b/_zh-cn/overviews/scala3-book/types-type-classes.md @@ -2,7 +2,7 @@ title: Type Classes type: section description: This section introduces type classes in Scala 3. -languages:[en] +language: zh-cn num: 60 previous-page: ca-given-using-clauses next-page: ca-context-bounds diff --git a/_zh-cn/overviews/scala3-book/types-union.md b/_zh-cn/overviews/scala3-book/types-union.md index 192c23fdee..204b1fcccb 100644 --- a/_zh-cn/overviews/scala3-book/types-union.md +++ b/_zh-cn/overviews/scala3-book/types-union.md @@ -2,7 +2,7 @@ title: 联合类型 type: section description: This section introduces and demonstrates union types in Scala 3. -languages:[en] +language: zh-cn num: 51 previous-page: types-intersection next-page: types-adts-gadts diff --git a/_zh-cn/overviews/scala3-book/types-variance.md b/_zh-cn/overviews/scala3-book/types-variance.md index e24949842f..f4b9ce2fa3 100644 --- a/_zh-cn/overviews/scala3-book/types-variance.md +++ b/_zh-cn/overviews/scala3-book/types-variance.md @@ -2,7 +2,7 @@ title: 型变 type: section description: This section introduces and demonstrates variance in Scala 3. -languages:[en] +language: zh-cn num: 53 previous-page: types-adts-gadts next-page: types-opaque-types diff --git a/_zh-cn/overviews/scala3-book/where-next.md b/_zh-cn/overviews/scala3-book/where-next.md index c4e79341d0..66c3afe639 100644 --- a/_zh-cn/overviews/scala3-book/where-next.md +++ b/_zh-cn/overviews/scala3-book/where-next.md @@ -2,7 +2,7 @@ title: 下一步去哪 type: chapter description: Where to go next after reading the Scala Book -languages:[en] +language: zh-cn num: 76 previous-page: scala-for-python-devs next-page: diff --git a/_zh-cn/overviews/scala3-book/why-scala-3.md b/_zh-cn/overviews/scala3-book/why-scala-3.md index 207acf248e..2259ad6c01 100644 --- a/_zh-cn/overviews/scala3-book/why-scala-3.md +++ b/_zh-cn/overviews/scala3-book/why-scala-3.md @@ -2,7 +2,7 @@ title: 为什么是 Scala 3 ？ type: chapter description: This page describes the benefits of the Scala 3 programming language. -languages:[en, ru] +language: zh-cn num: 3 previous-page: scala-features next-page: taste-intro From 83add6d74bb508e28545c5f98ee966d23c40c71b Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 3 Jan 2023 21:12:25 +0800 Subject: [PATCH 2431/3075] delete types-type-classes.md in zh-cn. --- .../scala3-book/types-type-classes.md | 58 ------------------- 1 file changed, 58 deletions(-) delete mode 100644 _zh-cn/overviews/scala3-book/types-type-classes.md diff --git a/_zh-cn/overviews/scala3-book/types-type-classes.md b/_zh-cn/overviews/scala3-book/types-type-classes.md deleted file mode 100644 index 88c39a5631..0000000000 --- a/_zh-cn/overviews/scala3-book/types-type-classes.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Type Classes -type: section -description: This section introduces type classes in Scala 3. -language: zh-cn -num: 60 -previous-page: ca-given-using-clauses -next-page: ca-context-bounds - -partof: scala3-book -overview-name: "Scala 3 — Book" -layout: multipage-overview -permalink: "/zh-cn/scala3/book/:title.html" ---- - -A _type class_ is an abstract, parameterized type that lets you add new behavior to any closed data type without using sub-typing. -If you are coming from Java, you can think of type classes as something like [`java.util.Comparator[T]`][comparator]. - -> The paper [“Type Classes as Objects and Implicits”][typeclasses-paper] (2010) by Oliveira et al. discusses the basic ideas behind type classes in Scala. -> Even though the paper uses an older version of Scala, the ideas still hold to the current day. - -This style of programming is useful in multiple use-cases, for example: - -- Expressing how a type you don’t own---such as from the standard library or a third-party library---conforms to such behavior -- Adding behavior to multiple types without introducing sub-typing relationships between those types (i.e., one `extends` another) - -In Scala 3, _type classes_ are just _traits_ with one or more type parameters, like the following: -``` -trait Show[A]: - def show(a: A): String -``` -Instances of `Show` for a particular type `A` witness that we can show (i.e., produce a text representation of) an instance of type `A`. -For example, let’s look at the following `Show` instance for `Int` values: - -```scala -class ShowInt extends Show[Int]: - def show(a: Int) = s"The number is ${a}!" -``` -We can write methods that work on arbitrary types `A` _constrained_ by `Show` as follows: - -```scala -def toHtml[A](a: A)(showA: Show[A]): String = - "

    " + showA.show(a) + "

    " -``` -That is, `toHtml` can be called with arbitrary `A` _as long_ as you can also provide an instance of `Show[A]`. -For example, we can call it like: -```scala -toHtml(42)(ShowInt()) -// results in "

    The number is 42!

    " -``` - -#### Automatically passing type class instances -Since type classes are a very important way to structure software, Scala 3 offers additional features that make working with them very convenient. -We discuss these additional features (which fall into the category of *Contextual Abstractions*) in a [later chapter][typeclasses-chapter] of this book. - -[typeclasses-paper]: https://infoscience.epfl.ch/record/150280/files/TypeClasses.pdf -[typeclasses-chapter]: {% link _zh-cn/overviews/scala3-book/ca-type-classes.md %} -[comparator]: https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html From e6a6226b9da56c0bb3de21576711025634cf4645 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 3 Jan 2023 21:42:58 +0800 Subject: [PATCH 2432/3075] change zh-cn files structure according to latest english version. --- _zh-cn/overviews/scala3-book/ca-extension-methods.md | 6 +++--- _zh-cn/overviews/scala3-book/ca-given-imports.md | 2 +- _zh-cn/overviews/scala3-book/ca-given-using-clauses.md | 6 +++--- _zh-cn/overviews/scala3-book/ca-implicit-conversions.md | 2 +- _zh-cn/overviews/scala3-book/ca-multiversal-equality.md | 2 +- _zh-cn/overviews/scala3-book/ca-summary.md | 2 +- _zh-cn/overviews/scala3-book/ca-type-classes.md | 4 ++-- _zh-cn/overviews/scala3-book/concurrency.md | 2 +- _zh-cn/overviews/scala3-book/interacting-with-java.md | 2 +- _zh-cn/overviews/scala3-book/scala-for-java-devs.md | 2 +- _zh-cn/overviews/scala3-book/scala-for-javascript-devs.md | 2 +- _zh-cn/overviews/scala3-book/scala-for-python-devs.md | 4 ++-- _zh-cn/overviews/scala3-book/scala-tools.md | 2 +- _zh-cn/overviews/scala3-book/tools-sbt.md | 2 +- _zh-cn/overviews/scala3-book/tools-worksheets.md | 2 +- _zh-cn/overviews/scala3-book/where-next.md | 2 +- 16 files changed, 22 insertions(+), 22 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/ca-extension-methods.md b/_zh-cn/overviews/scala3-book/ca-extension-methods.md index 43738e53d2..7d780cae1f 100644 --- a/_zh-cn/overviews/scala3-book/ca-extension-methods.md +++ b/_zh-cn/overviews/scala3-book/ca-extension-methods.md @@ -3,9 +3,9 @@ title: 扩展方法 type: section description: This page demonstrates how Extension Methods work in Scala 3. language: zh-cn -num: 63 -previous-page: ca-given-imports -next-page: ca-type-classes +num: 59 +previous-page: ca-contextual-abstractions-intro +next-page: ca-given-using-clauses partof: scala3-book overview-name: "Scala 3 — Book" diff --git a/_zh-cn/overviews/scala3-book/ca-given-imports.md b/_zh-cn/overviews/scala3-book/ca-given-imports.md index 4c95c35d52..faf1e8569d 100644 --- a/_zh-cn/overviews/scala3-book/ca-given-imports.md +++ b/_zh-cn/overviews/scala3-book/ca-given-imports.md @@ -5,7 +5,7 @@ description: This page demonstrates how 'given' import statements work in Scala language: zh-cn num: 62 previous-page: ca-context-bounds -next-page: ca-extension-methods +next-page: ca-type-classes partof: scala3-book overview-name: "Scala 3 — Book" diff --git a/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md b/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md index 9a492c25aa..c562e5d167 100644 --- a/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md +++ b/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md @@ -3,9 +3,9 @@ title: Given 实例和 Using 语句 type: section description: This page demonstrates how to use 'given' instances and 'using' clauses in Scala 3. language: zh-cn -num: 59 -previous-page: ca-contextual-abstractions-intro -next-page: types-type-classes +num: 60 +previous-page: ca-extension-methods +next-page: ca-context-bounds partof: scala3-book overview-name: "Scala 3 — Book" diff --git a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md index 5ab40c8064..69a12cba3e 100644 --- a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md +++ b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md @@ -3,7 +3,7 @@ title: 隐式转换 type: section description: This page demonstrates how to implement Implicit Conversions in Scala 3. language: zh-cn -num: 66 +num: 65 previous-page: ca-multiversal-equality next-page: ca-summary diff --git a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md index 9c6d2f422c..aff8f1d53e 100644 --- a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md +++ b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md @@ -3,7 +3,7 @@ title: 多元相等性 type: section description: This page demonstrates how to implement Multiversal Equality in Scala 3. language: zh-cn -num: 65 +num: 64 previous-page: ca-type-classes next-page: ca-implicit-conversions diff --git a/_zh-cn/overviews/scala3-book/ca-summary.md b/_zh-cn/overviews/scala3-book/ca-summary.md index 60b1fd01a5..c492e8f993 100644 --- a/_zh-cn/overviews/scala3-book/ca-summary.md +++ b/_zh-cn/overviews/scala3-book/ca-summary.md @@ -3,7 +3,7 @@ title: 总结 type: section description: This page provides a summary of the Contextual Abstractions lessons. language: zh-cn -num: 67 +num: 66 previous-page: ca-implicit-conversions next-page: concurrency diff --git a/_zh-cn/overviews/scala3-book/ca-type-classes.md b/_zh-cn/overviews/scala3-book/ca-type-classes.md index 1cd49103a3..3543f68a34 100644 --- a/_zh-cn/overviews/scala3-book/ca-type-classes.md +++ b/_zh-cn/overviews/scala3-book/ca-type-classes.md @@ -3,8 +3,8 @@ title: 实现类型类 type: section description: This page demonstrates how to create and use type classes in Scala 3. language: zh-cn -num: 64 -previous-page: ca-extension-methods +num: 63 +previous-page: ca-given-imports next-page: ca-multiversal-equality partof: scala3-book diff --git a/_zh-cn/overviews/scala3-book/concurrency.md b/_zh-cn/overviews/scala3-book/concurrency.md index 169e1f1684..1906f158ab 100644 --- a/_zh-cn/overviews/scala3-book/concurrency.md +++ b/_zh-cn/overviews/scala3-book/concurrency.md @@ -3,7 +3,7 @@ title: 并发 type: chapter description: This page discusses how Scala concurrency works, with an emphasis on Scala Futures. language: zh-cn -num: 68 +num: 67 previous-page: ca-summary next-page: scala-tools diff --git a/_zh-cn/overviews/scala3-book/interacting-with-java.md b/_zh-cn/overviews/scala3-book/interacting-with-java.md index f2263d0bd2..12682a9303 100644 --- a/_zh-cn/overviews/scala3-book/interacting-with-java.md +++ b/_zh-cn/overviews/scala3-book/interacting-with-java.md @@ -3,7 +3,7 @@ title: 与 Java 交互 type: chapter description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. language: zh-cn -num: 72 +num: 71 previous-page: tools-worksheets next-page: scala-for-java-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md index 39e9761c61..f4e20aa4c2 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md @@ -3,7 +3,7 @@ title: 向 Java 开发者介绍Scala type: chapter description: This page is for Java developers who are interested in learning about Scala 3. language: zh-cn -num: 73 +num: 72 previous-page: interacting-with-java next-page: scala-for-javascript-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md index aaaaf68bba..4563c43af4 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md @@ -3,7 +3,7 @@ title: Scala for JavaScript Developers type: chapter description: This chapter provides an introduction to Scala 3 for JavaScript developers language: zh-cn -num: 74 +num: 73 previous-page: scala-for-java-devs next-page: scala-for-python-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md index f04d664894..e56d017fb0 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md @@ -3,9 +3,9 @@ title: Scala for Python Developers type: chapter description: This page is for Python developers who are interested in learning about Scala 3. language: zh-cn -num: 75 +num: 74 previous-page: scala-for-javascript-devs -next-page: +next-page: where-next partof: scala3-book overview-name: "Scala 3 — Book" diff --git a/_zh-cn/overviews/scala3-book/scala-tools.md b/_zh-cn/overviews/scala3-book/scala-tools.md index 822c3d428a..d773d0f837 100644 --- a/_zh-cn/overviews/scala3-book/scala-tools.md +++ b/_zh-cn/overviews/scala3-book/scala-tools.md @@ -3,7 +3,7 @@ title: Scala 工具 type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. language: zh-cn -num: 69 +num: 68 previous-page: concurrency next-page: tools-sbt diff --git a/_zh-cn/overviews/scala3-book/tools-sbt.md b/_zh-cn/overviews/scala3-book/tools-sbt.md index 3d4e78f4a1..362de902b4 100644 --- a/_zh-cn/overviews/scala3-book/tools-sbt.md +++ b/_zh-cn/overviews/scala3-book/tools-sbt.md @@ -3,7 +3,7 @@ title: 使用 sbt 构建和测试 Scala 项目 type: section description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. language: zh-cn -num: 70 +num: 69 previous-page: scala-tools next-page: tools-worksheets diff --git a/_zh-cn/overviews/scala3-book/tools-worksheets.md b/_zh-cn/overviews/scala3-book/tools-worksheets.md index 214b744d8b..2e8270c996 100644 --- a/_zh-cn/overviews/scala3-book/tools-worksheets.md +++ b/_zh-cn/overviews/scala3-book/tools-worksheets.md @@ -3,7 +3,7 @@ title: worksheet type: section description: This section looks at worksheets, an alternative to Scala projects. language: zh-cn -num: 71 +num: 70 previous-page: tools-sbt next-page: interacting-with-java diff --git a/_zh-cn/overviews/scala3-book/where-next.md b/_zh-cn/overviews/scala3-book/where-next.md index 66c3afe639..e1d6052b6b 100644 --- a/_zh-cn/overviews/scala3-book/where-next.md +++ b/_zh-cn/overviews/scala3-book/where-next.md @@ -3,7 +3,7 @@ title: 下一步去哪 type: chapter description: Where to go next after reading the Scala Book language: zh-cn -num: 76 +num: 75 previous-page: scala-for-python-devs next-page: From 2f8cd56e32d65c880dce3c052d481669e6ee5b95 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 3 Jan 2023 21:51:08 +0800 Subject: [PATCH 2433/3075] correct pre link in ca-context-bounds.md --- _zh-cn/overviews/scala3-book/ca-context-bounds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index 2227899378..56d948bad0 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -4,7 +4,7 @@ type: section description: This page demonstrates Context Bounds in Scala 3. language: zh-cn num: 61 -previous-page: types-type-classes +previous-page: ca-given-using-clauses next-page: ca-given-imports partof: scala3-book From 002ce463990ab984d5dfbdfbbb92e51191fb7e7b Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Tue, 3 Jan 2023 14:57:35 +0100 Subject: [PATCH 2434/3075] remove link to type classes page --- _zh-cn/overviews/scala3-book/scala-for-python-devs.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md index e56d017fb0..b1142e25d5 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md @@ -1310,7 +1310,9 @@ a.takeWhile(_ < 30) // List(10, 20) Scala 中的有些概念目前在 Python 中没有等效的功能。 请点击以下链接了解更多详情： -- 大多数与[上下文抽象][contextual]相关的概念，如[扩展方法][extension-methods]、[类型类][type-classes]、隐式值 + + +- 大多数与[上下文抽象][contextual]相关的概念，如[扩展方法][extension-methods]、类型类、隐式值 - Scala 允许多参数列表，从而实现部分应用函数等特性，以及创建自己的 DSL 的能力 - 样例类，对于函数式编程和模式匹配非常有用 - 创建自己的控制结构和 DSL 的能力 @@ -1355,6 +1357,6 @@ pip install -r requirements.txt [modeling-intro]: {% link _zh-cn/overviews/scala3-book/domain-modeling-intro.md %} [multiversal]: {% link _zh-cn/overviews/scala3-book/ca-multiversal-equality.md %} [toplevel]: {% link _zh-cn/overviews/scala3-book/taste-toplevel-definitions.md %} -[type-classes]: {% link _zh-cn/overviews/scala3-book/types-type-classes.md %} + [union-types]: {% link _zh-cn/overviews/scala3-book/types-union.md %}
    From 9d7607b256c0ebea131c13b25cebf93913b56ee5 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 3 Jan 2023 21:59:36 +0800 Subject: [PATCH 2435/3075] delete invalid link in scala-for-python-devs.md --- _zh-cn/overviews/scala3-book/scala-for-python-devs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md index b1142e25d5..2ea3bacf3d 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md @@ -1357,6 +1357,5 @@ pip install -r requirements.txt [modeling-intro]: {% link _zh-cn/overviews/scala3-book/domain-modeling-intro.md %} [multiversal]: {% link _zh-cn/overviews/scala3-book/ca-multiversal-equality.md %} [toplevel]: {% link _zh-cn/overviews/scala3-book/taste-toplevel-definitions.md %} - [union-types]: {% link _zh-cn/overviews/scala3-book/types-union.md %}
    From 3aec13d88f2dce42ec3f49f2ccc1c405f28145bd Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Tue, 3 Jan 2023 16:17:06 +0100 Subject: [PATCH 2436/3075] find the corresponding english page to list languages --- _includes/sidebar-toc-multipage-overview.html | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/_includes/sidebar-toc-multipage-overview.html b/_includes/sidebar-toc-multipage-overview.html index 6b89191dd6..cf614c8da0 100644 --- a/_includes/sidebar-toc-multipage-overview.html +++ b/_includes/sidebar-toc-multipage-overview.html @@ -52,9 +52,12 @@
    Contents
    {% endfor %} {% elsif page.language and orphanTranslation == false %} + {% comment %} - {% assign engPath = page.id | remove_first: "/" | remove_first: page.language | append: '.html' %} - {% assign engPg = site.overviews | where: 'partof', page.partof | first %} + {% endcomment %} + {% assign engId = page.id | remove_first: "/" | remove_first: page.language %} + {% assign engPath = engId | append: '.html' %} + {% assign engPg = site.overviews | where: 'partof', page.partof | find: 'id', engId %}
    -

    scala/docs.scala-lang.org

    +

    scala/docs.scala-lang.org

    Scala documentation site.

    diff --git a/_overviews/scala3-contribution/procedures-areas.md b/_overviews/scala3-contribution/procedures-areas.md index 3d15216da4..12a6255828 100644 --- a/_overviews/scala3-contribution/procedures-areas.md +++ b/_overviews/scala3-contribution/procedures-areas.md @@ -66,7 +66,7 @@ See `tryCompiletimeConstantFold` in [Types]. [Synthesizer]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/typer/Synthesizer.scala [SyntheticMembers]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/SyntheticMembers.scala [quotes-impl]: https://github.com/lampepfl/dotty/tree/master/compiler/src/scala/quoted/runtime/impl -[Inliner]: https://github.com/lampepfl/dotty/tree/master/compiler/src/dotty/tools/dotc/typer/Inliner.scala +[Inliner]: https://github.com/lampepfl/dotty/blob/main/compiler/src/dotty/tools/dotc/inlines/Inliner.scala [Types]: https://github.com/lampepfl/dotty/tree/master/compiler/src/dotty/tools/dotc/core/Types.scala [Completion]: https://github.com/lampepfl/dotty/tree/master/compiler/src/dotty/tools/dotc/interactive/Completion.scala [DesugarEnums]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/ast/DesugarEnums.scala diff --git a/_overviews/tutorials/scala-on-android.md b/_overviews/tutorials/scala-on-android.md index c3557908ea..ba6e891798 100644 --- a/_overviews/tutorials/scala-on-android.md +++ b/_overviews/tutorials/scala-on-android.md @@ -82,7 +82,7 @@ In the `pom.xml` of HelloScala you will find a list of plugins and dependencies ### The code -[HelloScala](https://github.com/makingthematrix/scalaonandroid/tree/main/helloscala) is just a simple example app — the actual Scala code only sets up a few widgets and displays them. The [`Main`](https://github.com/makingthematrix/scalaonandroid/blob/main/hellogluon/src/main/scala/hellogluon/Main.scala) class extends `MobileApplication` from the Glisten library and then construct the main view programmatically, in two methods: `init()` for creating the widgets, and `postInit(Scene)` for decorating them. Since we want to test the app on our laptop before we install it on a mobile, we use `postInit` also to check on which platform the app is being run, and if it's a desktop, we set the dimensions on the app's window. In the case of a mobile it's not necessary — our app will take the whole available space on the screen. +[HelloScala](https://github.com/makingthematrix/scalaonandroid/tree/main/helloscala) is just a simple example app — the actual Scala code only sets up a few widgets and displays them. The [`Main`](https://github.com/makingthematrix/scalaonandroid/blob/main/helloscala/src/main/scala/helloscala/Main.scala) class extends `MobileApplication` from the Glisten library and then construct the main view programmatically, in two methods: `init()` for creating the widgets, and `postInit(Scene)` for decorating them. Since we want to test the app on our laptop before we install it on a mobile, we use `postInit` also to check on which platform the app is being run, and if it's a desktop, we set the dimensions on the app's window. In the case of a mobile it's not necessary — our app will take the whole available space on the screen. Another way to set up and display widgets in JavaFX is to use a WYSIWYG editor called [Scene Builder](https://gluonhq.com/products/scene-builder/) which generates FXML files, a version of XML, that you can then load into your app. You can see how it is done in another example: [HelloFXML](https://github.com/makingthematrix/scalaonandroid/tree/main/HelloFXML). For more complex applications, you will probably mix those two approaches: FXML for more-or-less static views and programmatically set up widgets in places where the UI within one view changes in reaction to events (think, for example, of a scrollable list of incoming messages). From 86ce6d873066bc666beba91923fc767f1a48136e Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Thu, 12 Jan 2023 21:08:06 +0800 Subject: [PATCH 2446/3075] add code tables in num8 node in _zh_cn. (#2670) * add code tables in num8 node in _zh_cn. * correct code example. --- .../scala3-book/taste-control-structures.md | 321 ++++++++++++++++-- 1 file changed, 296 insertions(+), 25 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/taste-control-structures.md b/_zh-cn/overviews/scala3-book/taste-control-structures.md index ea26f0ff42..a6d0196ee5 100644 --- a/_zh-cn/overviews/scala3-book/taste-control-structures.md +++ b/_zh-cn/overviews/scala3-book/taste-control-structures.md @@ -28,6 +28,23 @@ Scala 具有您在其他编程语言中可以找到的控制结构，并且还 Scala 的 `if`/`else` 控制结构看起来与其他语言相似： +{% tabs if-else class=tabs-scala-version %} +{% tab 'Scala 2' for=if-else %} + +```scala +if (x < 0) { + println("negative") +} else if (x == 0) { + println("zero") +} else { + println("positive") +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=if-else %} + ```scala if x < 0 then println("negative") @@ -37,52 +54,66 @@ else println("positive") ``` +{% endtab %} +{% endtabs %} + 请注意，这确实是一个 _表达式_ ---不是一个 _语句_。 这意味着它返回一个值，因此您可以将结果赋值给一个变量： +{% tabs if-else-expression class=tabs-scala-version %} +{% tab 'Scala 2' for=if-else-expression %} + +```scala +val x = if (a < b) { a } else { b } +``` + +{% endtab %} + +{% tab 'Scala 3' for=if-else-expression %} + ```scala val x = if a < b then a else b ``` +{% endtab %} +{% endtabs %} + 正如您将在本书中看到的那样，_所有_ Scala 控制结构都可以用作表达式。 > 表达式返回结果，而语句不返回。 > 语句通常用于它们的副作用，例如使用 `println` 打印到控制台。 -在 Scala 2 中 `if`/`else` 控制结构的构造不同，需要括号和大括号，而不是关键字 `then`。 - -```scala -// Scala 2 syntax -if (test1) { - doX() -} else if (test2) { - doY() -} else { - doZ() -} -``` - ## `for` 循环和表达式 `for` 关键字用于创建 `for` 循环。 这个例子展示了如何打印 `List` 中的每个元素： +{% tabs for-loop class=tabs-scala-version %} +{% tab 'Scala 2' for=for-loop %} + ```scala val ints = List(1, 2, 3, 4, 5) -for i <- ints do println(i) +for (i <- ints) println(i) ``` -代码 `i <- ints` 被称为 _生成器_，紧随 `do` 关键字的代码是 _循环体_。 +> 代码 `i <- ints` 被称为_生成器_，在括号内的生成器后面是_循环体_。 + +{% endtab %} + +{% tab 'Scala 3' for=for-loop %} -Scala 2 中这种控制结构的旧语法是： ```scala -// Scala 2 语法 -for (i <- ints) println(i) +val ints = List(1, 2, 3, 4, 5) + +for i <- ints do println(i) ``` -再次注意括号的使用和 Scala 3 中新的 `for`-`do`。 +> 代码 `i <- ints` 被称为 _生成器_，紧随 `do` 关键字的代码是 _循环体_。 + +{% endtab %} +{% endtabs %} ### 守卫 @@ -90,6 +121,18 @@ for (i <- ints) println(i) 这些被称为 _守卫_。 此示例打印 `ints` 中大于 `2` 的所有数字： +{% tabs for-guards class=tabs-scala-version %} +{% tab 'Scala 2' for=for-guards %} + +```scala +for (i <- ints if i > 2) + println(i) +``` + +{% endtab %} + +{% tab 'Scala 3' for=for-guards %} + ```scala for i <- ints @@ -98,10 +141,31 @@ do println(i) ``` +{% endtab %} +{% endtabs %} + 您可以使用多个生成器和守卫。 此循环遍历数字 `1` 到 `3`，并且对于每个数字，它还遍历字符 `a` 到 `c`。 然而，它也有两个守卫，所以唯一一次调用 print 语句是当 `i` 的值为 `2` 并且 `j` 是字符 `b` 时： +{% tabs for-guards-multi class=tabs-scala-version %} +{% tab 'Scala 2' for=for-guards-multi %} + +```scala +for { + i <- 1 to 3 + j <- 'a' to 'c' + if i == 2 + if j == 'b' +} { + println(s"i = $i, j = $j") // prints: "i = 2, j = b" +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=for-guards-multi %} + ```scala for i <- 1 to 3 @@ -112,20 +176,51 @@ do println(s"i = $i, j = $j") // prints: "i = 2, j = b" ``` +{% endtab %} +{% endtabs %} + ### `for` 表达式 -`for` 关键字更强大：当您使用 `yield` 关键字代替 `do` 时，您会创建 `for` _表达式_ 用于计算和产生结果。 +`for` 关键字更强大：当您使用 `yield` 关键字代替 `do` 时，您会创建 `for` _表达式_用于计算和产生结果。 几个例子演示了这一点。 使用与上一个示例相同的 `ints` 列表，此代码创建一个新列表，其中新列表中每个元素的值是原始列表中元素值的两倍： +{% tabs for-expression_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=for-expression_1 %} + +```` +scala> val doubles = for (i <- ints) yield i * 2 +val doubles: List[Int] = List(2, 4, 6, 8, 10) +```` + +{% endtab %} + +{% tab 'Scala 3' for=for-expression_1 %} + ```` scala> val doubles = for i <- ints yield i * 2 val doubles: List[Int] = List(2, 4, 6, 8, 10) ```` +{% endtab %} +{% endtabs %} + Scala 的控制结构语法很灵活，`for` 表达式可以用其他几种方式编写，具体取决于您的偏好： +{% tabs for-expressioni_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=for-expressioni_2 %} + +```scala +val doubles = for (i <- ints) yield i * 2 +val doubles = for (i <- ints) yield (i * 2) +val doubles = for { i <- ints } yield (i * 2) +``` + +{% endtab %} + +{% tab 'Scala 3' for=for-expressioni_2 %} + ```scala val doubles = for i <- ints yield i * 2 // 如上所示的风格 val doubles = for (i <- ints) yield i * 2 @@ -133,15 +228,49 @@ val doubles = for (i <- ints) yield (i * 2) val doubles = for { i <- ints } yield (i * 2) ``` +{% endtab %} +{% endtabs %} + 此示例显示如何将列表中每个字符串的第一个字符大写： +{% tabs for-expressioni_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=for-expressioni_3 %} + +```scala +val names = List("chris", "ed", "maurice") +val capNames = for (name <- names) yield name.capitalize +``` + +{% endtab %} + +{% tab 'Scala 3' for=for-expressioni_3 %} + ```scala val names = List("chris", "ed", "maurice") val capNames = for name <- names yield name.capitalize ``` +{% endtab %} +{% endtabs %} + 最后，这个 `for` 表达式遍历一个字符串列表，并返回每个字符串的长度，但前提是该长度大于 `4`： +{% tabs for-expressioni_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=for-expressioni_4 %} + +```scala +val fruits = List("apple", "banana", "lime", "orange") + +val fruitLengths = + for (f <- fruits if f.length > 4) yield f.length + +// fruitLengths: List[Int] = List(5, 6, 6) +``` + +{% endtab %} + +{% tab 'Scala 3' for=for-expressioni_4 %} + ```scala val fruits = List("apple", "banana", "lime", "orange") @@ -156,12 +285,33 @@ yield //fruitLengths: List[Int] = List(5, 6, 6) ``` +{% endtab %} +{% endtabs %} + `for` 循环和表达式更多细节在本书的 [控制结构部分][control] 中，和 [参考文档]({{ site.scala3ref }}/other-new-features/control-syntax.html) 中。 ## `match` 表达式 Scala 有一个 `match` 表达式，它最基本的用途类似于 Java `switch` 语句： +{% tabs match class=tabs-scala-version %} +{% tab 'Scala 2' for=match %} + +```scala +val i = 1 + +// later in the code ... +i match { + case 1 => println("one") + case 2 => println("two") + case _ => println("other") +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=match %} + ```scala val i = 1 @@ -172,8 +322,27 @@ i match case _ => println("other") ``` +{% endtab %} +{% endtabs %} + 但是，`match` 确实是一个表达式，这意味着它会根据模式匹配返回一个结果，您可以将其绑定到一个变量： +{% tabs match-expression_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=match-expression_1 %} + +```scala +val result = i match { + case 1 => "one" + case 2 => "two" + case _ => "other" +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=match-expression_1 %} + + ```scala val result = i match case 1 => "one" @@ -181,8 +350,33 @@ val result = i match case _ => "other" ``` +{% endtab %} +{% endtabs %} + `match` 不仅限于使用整数值，它可以用于任何数据类型： +{% tabs match-expression_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=match-expression_2 %} + +```scala +val p = Person("Fred") + +// later in the code +p match { + case Person(name) if name == "Fred" => + println(s"$name says, Yubba dubba doo") + + case Person(name) if name == "Bam Bam" => + println(s"$name says, Bam bam!") + + case _ => println("Watch the Flintstones!") +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=match-expression_2 %} + ```scala val p = Person("Fred") @@ -197,9 +391,37 @@ p match case _ => println("Watch the Flintstones!") ``` +{% endtab %} +{% endtabs %} + 事实上，`match` 表达式可以用许多模式的不同类型来测试变量。 此示例显示 (a) 如何使用 `match` 表达式作为方法的主体，以及 (b) 如何匹配显示的所有不同类型： +{% tabs match-expression_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=match-expression_3 %} + +```scala +// getClassAsString is a method that takes a single argument of any type. +def getClassAsString(x: Any): String = x match { + case s: String => s"'$s' is a String" + case i: Int => "Int" + case d: Double => "Double" + case l: List[_] => "List" + case _ => "Unknown" +} + +// examples +getClassAsString(1) // Int +getClassAsString("hello") // 'hello' is a String +getClassAsString(List(1, 2, 3)) // List +``` + +因为 `getClassAsString` 方法获取 `Any` 类型的参数值，所以它可以解耦任意模式类型。 + +{% endtab %} + +{% tab 'Scala 3' for=match-expression_3 %} + ```scala // getClassAsString 是一个接受任何类型的单个参数的方法。 def getClassAsString(x: Matchable): String = x match @@ -218,6 +440,9 @@ getClassAsString(List(1, 2, 3)) // List `getClassAsString` 方法将 [Matchable]({{ site.scala3ref }}/other-new-features/matchable.html) 类型的值作为参数，它可以是 任何支持模式匹配的类型（某些类型不支持模式匹配，因为这可能打破封装）。 +{% endtab %} +{% endtabs %} + Scala 中的模式匹配还有 _更多_ 内容。 模式可以嵌套，模式的结果可以绑定，模式匹配甚至可以是用户自定义的。 有关详细信息，请参阅 [控制结构章节][control] 中的模式匹配示例。 @@ -227,6 +452,24 @@ Scala 中的模式匹配还有 _更多_ 内容。 Scala 的 `try`/`catch`/`finally` 控制结构让你捕获异常。 它类似于 Java，但其语法与 `match` 表达式一致： +{% tabs try class=tabs-scala-version %} +{% tab 'Scala 2' for=try %} + +```scala +try { + writeTextToFile(text) +} catch { + case ioe: IOException => println("Got an IOException.") + case nfe: NumberFormatException => println("Got a NumberFormatException.") +} finally { + println("Clean up your resources here.") +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=try %} + ```scala try writeTextToFile(text) @@ -237,26 +480,51 @@ finally println("Clean up your resources here.") ``` +{% endtab %} +{% endtabs %} + ## `while` 循环 Scala 还有一个 `while` 循环结构。 它的单行语法如下所示： +{% tabs while_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=while_1 %} + ```scala -while x >= 0 do x = f(x) +while (x >= 0) { x = f(x) } ``` -在 Scala 2 中，语法有点不同。条件用括号括起来，并且 -没有 `do` 关键字： +{% endtab %} + +{% tab 'Scala 3' for=while_1 %} ```scala -while (x >= 0) { x = f(x) } +while x >= 0 do x = f(x) ``` - 为了兼容性，Scala 3 仍然支持 Scala 2 语法。 +{% endtab %} +{% endtabs %} + `while` 循环多行语法如下所示： +{% tabs while_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=while_2 %} + +```scala +var x = 1 + +while (x < 3) { + println(x) + x += 1 +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=while_2 %} + ```scala var x = 1 @@ -267,6 +535,9 @@ do x += 1 ``` +{% endtab %} +{% endtabs %} + ## 自定义控制结构 由于传名参数、中缀表示法、流畅接口、可选括号、扩展方法和高阶函数等功能，您还可以创建自己的代码，就像控制结构一样工作。 From 5694c91ba82d3422845223f7be296fa9a4da4717 Mon Sep 17 00:00:00 2001 From: Ondra Pelech Date: Fri, 13 Jan 2023 12:01:43 +0100 Subject: [PATCH 2447/3075] Document the pattern for evolving case classes in a compatible manner (#2662) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Jakub Kozłowski Co-authored-by: Julien Richard-Foy --- ...inary-compatibility-for-library-authors.md | 135 ++++++++++++++++++ 1 file changed, 135 insertions(+) diff --git a/_overviews/tutorials/binary-compatibility-for-library-authors.md b/_overviews/tutorials/binary-compatibility-for-library-authors.md index ad0d34f913..47261847d6 100644 --- a/_overviews/tutorials/binary-compatibility-for-library-authors.md +++ b/_overviews/tutorials/binary-compatibility-for-library-authors.md @@ -173,6 +173,141 @@ You can find detailed explanations, runnable examples and tips to maintain binar Again, we recommend using MiMa to double-check that you have not broken binary compatibility after making changes. +### Changing a case class definition in a backwards-compatible manner + +Sometimes, it is desirable to change the definition of a case class (adding and/or removing fields) while still staying backwards-compatible with the existing usage of the case class, i.e. not breaking the so-called _binary compatibility_. The first question you should ask yourself is “do you need a _case_ class?” (as opposed to a regular class, which can be easier to evolve in a binary compatible way). A good reason for using a case class is when you need a structural implementation of `equals` and `hashCode`. + +To achieve that, follow this pattern: + * make the primary constructor private (this makes the `copy` method of the class private as well) + * define a private `unapply` function in the companion object (note that by doing that the case class loses the ability to be used as an extractor in match expressions) + * for all the fields, define `withXXX` methods on the case class that create a new instance with the respective field changed (you can use the private `copy` method to implement them) + * create a public constructor by defining an `apply` method in the companion object (it can use the private constructor) + +Example: + +{% tabs case_class_compat_1 %} +{% tab 'Scala 3 Only' %} + +```scala +// Mark the primary constructor as private +case class Person private (name: String, age: Int): + // Create withXxx methods for every field, implemented by using the copy method + def withName(name: String): Person = copy(name = name) + def withAge(age: Int): Person = copy(age = age) + +object Person: + // Create a public constructor (which uses the primary constructor) + def apply(name: String, age: Int): Person = new Person(name, age) + // Make the extractor private + private def unapply(p: Person) = p +``` +{% endtab %} +{% endtabs %} +This class can be published in a library and used as follows: + +{% tabs case_class_compat_2 %} +{% tab 'Scala 2 and 3' %} +~~~ scala +// Create a new instance +val alice = Person("Alice", 42) +// Transform an instance +println(alice.withAge(alice.age + 1)) // Person(Alice, 43) +~~~ +{% endtab %} +{% endtabs %} + +If you try to use `Person` as an extractor in a match expression, it will fail with a message like “method unapply cannot be accessed as a member of Person.type”. Instead, you can use it as a typed pattern: + +{% tabs case_class_compat_3 class=tabs-scala-version %} +{% tab 'Scala 2' %} +~~~ scala +alice match { + case person: Person => person.name +} +~~~ +{% endtab %} +{% tab 'Scala 3' %} +~~~ scala +alice match + case person: Person => person.name +~~~ +{% endtab %} +{% endtabs %} + +Later in time, you can amend the original case class definition to, say, add an optional `address` field. You + * add a new field `address` and a custom `withAddress` method, + * update the public `apply` method in the companion object to initialize all the fields, + * tell MiMa to [ignore](https://github.com/lightbend/mima#filtering-binary-incompatibilities) changes to the class constructor. This step is necessary because MiMa does not yet ignore changes in private class constructor signatures (see [#738](https://github.com/lightbend/mima/issues/738)). + +{% tabs case_class_compat_4 %} +{% tab 'Scala 3 Only' %} +```scala +case class Person private (name: String, age: Int, address: Option[String]): + ... + def withAddress(address: Option[String]) = copy(address = address) + +object Person: + // Update the public constructor to also initialize the address field + def apply(name: String, age: Int): Person = new Person(name, age, None) +``` +{% endtab %} +{% endtabs %} + +And, in your build definition: + +{% tabs case_class_compat_5 %} +{% tab 'sbt' %} +~~~ scala +import com.typesafe.tools.mima.core._ +mimaBinaryIssueFilters += ProblemFilters.exclude[DirectMissingMethodProblem]("Person.this") +~~~ +{% endtab %} +{% endtabs %} + +Otherwise, MiMa would fail with an error like “method this(java.lang.String,Int)Unit in class Person does not have a correspondent in current version”. + +> Note that an alternative solution, instead of adding a MiMa exclusion filter, consists of adding back the previous +> constructor signatures as secondary constructors: +> ~~~ scala +> case class Person private (name: String, age: Int, address: Option[String]): +> ... +> // Add back the former primary constructor signature +> private[Person] def this(name: String, age: Int) = this(name, age, None) +> ~~~ + +The original users can use the case class `Person` as before, all the methods that existed before are present unmodified after this change, thus the compatibility with the existing usage is maintained. + +The new field `address` can be used as follows: + +{% tabs case_class_compat_6 %} +{% tab 'Scala 2 and 3' %} +~~~ scala +// The public constructor sets the address to None by default. +// To set the address, we call withAddress: +val bob = Person("Bob", 21).withAddress(Some("Atlantic ocean")) +println(bob.address) +~~~ +{% endtab %} +{% endtabs %} + +A regular case class not following this pattern would break its usage, because by adding a new field changes some methods (which could be used by somebody else), for example `copy` or the constructor itself. + +Optionally, you can also add overloads of the `apply` method in the companion object to initialize more fields +in one call. In our example, we can add an overload that also initializes the `address` field: + +{% tabs case_class_compat_7 %} +{% tab 'Scala 3 Only' %} +~~~ scala +object Person: + // Original public constructor + def apply(name: String, age: Int): Person = new Person(name, age, None) + // Additional constructor that also sets the address + def apply(name: String, age: Int, address: String): Person = + new Person(name, age, Some(address)) +~~~ +{% endtab %} +{% endtabs %} + ## Versioning Scheme - Communicating compatibility breakages Library authors use versioning schemes to communicate compatibility guarantees between library releases to their users. Versioning schemes like [Semantic Versioning](https://semver.org/) (SemVer) allow From e8fefb9b9626a6cbe1ebc64da14531b6926d75f2 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Wed, 18 Jan 2023 17:10:01 +0800 Subject: [PATCH 2448/3075] add tabs in zh-cn/overview/scala3-book/num9 (#2673) * add tabs in zh-cn/overview/scala3-book/num9 * modified translation according review. * Update _zh-cn/overviews/scala3-book/taste-modeling.md remove redundant english Co-authored-by: Jamie Thompson --- .../overviews/scala3-book/taste-modeling.md | 231 +++++++++++++++++- 1 file changed, 219 insertions(+), 12 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/taste-modeling.md b/_zh-cn/overviews/scala3-book/taste-modeling.md index 57981e10d3..ca39aafe34 100644 --- a/_zh-cn/overviews/scala3-book/taste-modeling.md +++ b/_zh-cn/overviews/scala3-book/taste-modeling.md @@ -32,7 +32,7 @@ It’s more about modeling operations, imho.” How to resolve? Is there a good DDD term to use here? {% endcomment %} -### traits +### Traits Scala trait 可以用作简单的接口，但它们也可以包含抽象和具体的方法和字段，并且它们可以有参数，就像类一样。 它们为您提供了一种将行为组织成小型模块化单元的好方法。 @@ -40,9 +40,33 @@ Scala trait 可以用作简单的接口，但它们也可以包含抽象和具 作为如何将 traits 用作接口的示例，以下是三个 traits，它们为狗和猫等动物定义了结构良好并且模块化的行为： +{% tabs traits class=tabs-scala-version %} +{% tab 'Scala 2' for=traits %} + +```scala +trait Speaker { + def speak(): String // has no body, so it’s abstract +} + +trait TailWagger { + def startTail(): Unit = println("tail is wagging") + def stopTail(): Unit = println("tail is stopped") +} + +trait Runner { + def startRunning(): Unit = println("I’m running") + def stopRunning(): Unit = println("Stopped running") +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=traits %} + + ```scala trait Speaker: - def speak(): String // 没有函数体，这样它是抽象的。 + def speak(): String // has no body, so it’s abstract trait TailWagger: def startTail(): Unit = println("tail is wagging") @@ -53,17 +77,51 @@ trait Runner: def stopRunning(): Unit = println("Stopped running") ``` +{% endtab %} +{% endtabs %} + 鉴于这些特征，这里有一个 `Dog` 类，它扩展了所有这些特征，同时为抽象 `speak` 方法提供了一种行为： +{% tabs traits-class class=tabs-scala-version %} +{% tab 'Scala 2' for=traits-class %} + +```scala +class Dog(name: String) extends Speaker with TailWagger with Runner { + def speak(): String = "Woof!" +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=traits-class %} + ```scala class Dog(name: String) extends Speaker, TailWagger, Runner: def speak(): String = "Woof!" ``` +{% endtab %} +{% endtabs %} + 请注意该类如何使用 `extends` 关键字扩展 traits。 类似地，这里有一个 `Cat` 类，它实现了这些相同的 traits，同时还覆盖了它继承的两个具体方法： +{% tabs traits-override class=tabs-scala-version %} +{% tab 'Scala 2' for=traits-override %} + +```scala +class Cat(name: String) extends Speaker with TailWagger with Runner { + def speak(): String = "Meow" + override def startRunning(): Unit = println("Yeah ... I don’t run") + override def stopRunning(): Unit = println("No need to stop") +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=traits-override %} + ```scala class Cat(name: String) extends Speaker, TailWagger, Runner: def speak(): String = "Meow" @@ -71,8 +129,28 @@ class Cat(name: String) extends Speaker, TailWagger, Runner: override def stopRunning(): Unit = println("No need to stop") ``` +{% endtab %} +{% endtabs %} + 这些示例显示了如何使用这些类： +{% tabs traits-use class=tabs-scala-version %} +{% tab 'Scala 2' for=traits-use %} + +```scala +val d = new Dog("Rover") +println(d.speak()) // prints "Woof!" + +val c = new Cat("Morris") +println(c.speak()) // "Meow" +c.startRunning() // "Yeah ... I don’t run" +c.stopRunning() // "No need to stop" +``` + +{% endtab %} + +{% tab 'Scala 3' for=traits-use %} + ```scala val d = Dog("Rover") println(d.speak()) // prints "Woof!" @@ -83,6 +161,9 @@ c.startRunning() // "Yeah ... I don’t run" c.stopRunning() // "No need to stop" ``` +{% endtab %} +{% endtabs %} + 如果该代码有意义---太好了，您把 traits 作为接口感到舒服。 如果没有，请不要担心，它们在 [Domain Modeling][data-1] 章节中有更详细的解释。 @@ -91,6 +172,24 @@ c.stopRunning() // "No need to stop" Scala _classes_ 用于 OOP 风格的编程。 这是一个模拟“人”的类的示例。在 OOP 中，字段通常是可变的，所以 `firstName` 和 `lastName` 都被声明为 `var` 参数： +{% tabs class_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=class_1 %} + +```scala +class Person(var firstName: String, var lastName: String) { + def printFullName() = println(s"$firstName $lastName") +} + +val p = new Person("John", "Stephens") +println(p.firstName) // "John" +p.lastName = "Legend" +p.printFullName() // "John Legend" +``` + +{% endtab %} + +{% tab 'Scala 3' for=class_1 %} + ```scala class Person(var firstName: String, var lastName: String): def printFullName() = println(s"$firstName $lastName") @@ -101,13 +200,31 @@ p.lastName = "Legend" p.printFullName() // "John Legend" ``` +{% endtab %} +{% endtabs %} + 请注意，类声明创建了一个构造函数： -```斯卡拉 +{% tabs class_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=class_2 %} + +```scala +// this code uses that constructor +val p = new Person("John", "Stephens") +``` + +{% endtab %} + +{% tab 'Scala 3' for=class_2 %} + +```scala // 此代码使用该构造函数 val p = Person("约翰", "斯蒂芬斯") ``` +{% endtab %} +{% endtabs %} + [Domain Modeling][data-1] 章节中介绍了构造函数和其他与类相关的主题。 ## FP 领域建模 @@ -120,20 +237,57 @@ to replace the Scala2 “sealed trait + case class” pattern. How to resolve? 以 FP 风格编写代码时，您将使用以下结构： -- 枚举来定义 ADT -- 样例类 -- Traits +- 代数数据类型（ADT）来定义数据 +- Traits 来定义数据上的功能 + +### 枚举和 Sum Types -### 枚举 +Sum types 是在 Scala 中给代数数据类型（ADT）建模的一种方法。 `enum` 构造是在 Scala 3 中对代数数据类型 (ADT) 进行建模的好方法。 + 例如，披萨具有三个主要属性： - 面饼大小 - 面饼类型 - 馅料 -这些是用枚举简洁地建模的： +这些是用枚举简洁地建模的，它们是只包含单例值的 sum types： + +{% tabs enum_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=enum_1 %} + +在 Scala 2 中，用 `sealed` 类和 `case object` 组合在一起来定义枚举: + +```scala +sealed abstract class CrustSize +object CrustSize { + case object Small extends CrustSize + case object Medium extends CrustSize + case object Large extends CrustSize +} + +sealed abstract class CrustType +object CrustType { + case object Thin extends CrustType + case object Thick extends CrustType + case object Regular extends CrustType +} + +sealed abstract class Topping +object Topping { + case object Cheese extends Topping + case object Pepperoni extends Topping + case object BlackOlives extends Topping + case object GreenOlives extends Topping + case object Onions extends Topping +} +``` + +{% endtab %} +{% tab 'Scala 3' for=enum_1 %} + +Scala 3 提供了 `enum` 结构来定义枚举： ```scala enum CrustSize: @@ -146,8 +300,32 @@ enum Topping: case Cheese, Pepperoni, BlackOlives, GreenOlives, Onions ``` +{% endtab %} +{% endtabs %} + 一旦你有了一个枚举，你就可以按照你通常使用特征、类或对象的所有方式来使用枚举： +{% tabs enum_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=enum_2 %} + +```scala +import CrustSize._ +val currentCrustSize = Small + +// enums in a `match` expression +currentCrustSize match { + case Small => println("Small crust size") + case Medium => println("Medium crust size") + case Large => println("Large crust size") +} + +// enums in an `if` statement +if (currentCrustSize == Small) println("Small crust size") +``` + +{% endtab %} +{% tab 'Scala 3' for=enum_2 %} + ```scala import CrustSize.* val currentCrustSize = Small @@ -162,7 +340,26 @@ currentCrustSize match if currentCrustSize == Small then println("Small crust size") ``` -下面是另一个如何在 Scala 中创建和使用 ADT 的示例： +{% endtab %} +{% endtabs %} + +下面是另一个如何在 Scala 中创建 sum type 的示例，它不能被叫作枚举，因为 `succ` 样例类有参数：的示例： + +{% tabs enum_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=enum_3 %} + +```scala +sealed abstract class Nat +object Nat { + case object Zero extends Nat + case class Succ(pred: Nat) extends Nat +} +``` + +Sum Types 在本书的[领域建模]({% link _overviews/scala3-book/domain-modeling-tools.md %})部分有详细的介绍。 + +{% endtab %} +{% tab 'Scala 3' for=enum_3 %} ```scala enum Nat: @@ -170,11 +367,15 @@ enum Nat: case Succ(pred: Nat) ``` -枚举在本书的 [领域建模][data-1] 部分和 [参考文档]({{ site.scala3ref }}/enums/enums.html) 中有详细介绍。 +枚举在本书的 [领域建模]({% link _overviews/scala3-book/domain-modeling-tools.md %})部分和 [参考文档]({{ site.scala3ref }}/enums/enums.html) 中有详细介绍。 + +{% endtab %} +{% endtabs %} -### 样例类 +### Product Types + +product type 是代数数据类型（ADT），它只含有一个形状，例如一个单例对象，在Scala 中用 `case` 对象来代表；或者是一个可以获取字段的不可变结构，用 `case` 类来代表。 -Scala `case` 类允许您使用不可变数据结构对概念进行建模。 `case` 类具有 `class` 的所有功能，还包含其他功能，使它们对函数式编程很有用。 当编译器在 `class` 前面看到 `case` 关键字时，它具有以下效果和好处： @@ -193,6 +394,9 @@ NOTE: Julien had a comment about how he decides when to use case classes vs clas 这段代码演示了几个 `case` 类的特性： +{% tabs case-class %} +{% tab 'Scala 2 and 3' for=case-class %} + ```scala // define a case class case class Person( @@ -216,6 +420,9 @@ val p2 = p.copy(name = "Elton John") p2 // : Person = Person(Elton John,Singer) ``` +{% endtab %} +{% endtabs %} + 有关 `case` 类的更多详细信息，请参阅 [领域建模][data-1] 部分。 [data-1]: {% link _zh-cn/overviews/scala3-book/domain-modeling-tools.md %} From cbfaf0846b3550594c5ef1019ea079866a7abbb1 Mon Sep 17 00:00:00 2001 From: fsalvi Date: Wed, 18 Jan 2023 12:36:55 +0100 Subject: [PATCH 2449/3075] Do not install gems before bundler does it for us Fix problems when building the docker image --- Dockerfile | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/Dockerfile b/Dockerfile index d8908e57d7..5ec353962f 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,7 +1,6 @@ -FROM ruby:2.6.9 +FROM ruby:2.7.6 -RUN gem install rouge -v3.30.0 -RUN gem install bundler:2.3.10 jekyll +RUN gem install bundler:2.3.10 WORKDIR /srv/jekyll From 2f1eba7d3c979fb443a9a2f2d4a19fd9bdd5e58d Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Thu, 19 Jan 2023 00:23:20 +0000 Subject: [PATCH 2450/3075] Update SIPs state --- _sips/sips/wildcard-context-bounds.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_sips/sips/wildcard-context-bounds.md b/_sips/sips/wildcard-context-bounds.md index bdbcb76ebd..7ef71f1f61 100644 --- a/_sips/sips/wildcard-context-bounds.md +++ b/_sips/sips/wildcard-context-bounds.md @@ -1,7 +1,6 @@ --- title: SIP-52 - Wildcard context bounds -status: under-review +status: withdrawn pull-request-number: 55 -stage: design --- From 35ec471ab6327e5c865c95abf96c1c4ffdee6d2e Mon Sep 17 00:00:00 2001 From: Oliver <8238679+oliver-brm@users.noreply.github.com> Date: Thu, 19 Jan 2023 20:53:08 +0100 Subject: [PATCH 2451/3075] Update implicit-conversions.md (#2674) * Update implicit-conversions.md I'm not sure if it is intentional, but the Tour-of-Scala documentation does not mention how to bring implicit conversions into scope. In fact, that information is a bit hard to find anywhere else, so I thought I'll propose to add it here? * Update _tour/implicit-conversions.md from suggestion Co-authored-by: Jamie Thompson * Update implicit-conversions.md Improved Scala 3 description. Thanks for all the suggestions! * Fix import in _tour/implicit-conversions.md Co-authored-by: Jamie Thompson * describe Scala 2 implicit conversion in companion object * Remove mdoc from Scala 3 example * Update _tour/implicit-conversions.md * Update _tour/implicit-conversions.md * Remove mdoc from Scala 2 example as well Sorry for wasting your time, next time, I'll install the toolchain. * merge section "How are implicit conversions selected?" Co-authored-by: Jamie Thompson --- _tour/implicit-conversions.md | 64 +++++++++++++++++++++++++++++++++-- 1 file changed, 62 insertions(+), 2 deletions(-) diff --git a/_tour/implicit-conversions.md b/_tour/implicit-conversions.md index c7f58d8009..cf93a062f2 100644 --- a/_tour/implicit-conversions.md +++ b/_tour/implicit-conversions.md @@ -38,9 +38,69 @@ In the second case, a conversion `c` is searched for, which is applicable to `e` An example is to compare two strings `"foo" < "bar"`. In this case, `String` has no member `<`, so the implicit conversion `Predef.augmentString("foo") < "bar"` is inserted. (`scala.Predef` is automatically imported into all Scala programs.) -### How are implicit conversions selected? +### How are implicit conversions brought into scope? ### -See this [Scala FAQ Answer](https://docs.scala-lang.org/tutorials/FAQ/index.html#where-does-scala-look-for-implicits). +{% tabs implicit-conversion-scope class=tabs-scala-version %} +{% tab 'Scala 2' %} +In Scala 2, an implicit conversion is brought into scope by importing from the object that defined it, (e.g. `Conversions` in this case). If the implicit conversion is in the companion object of the argument type, (e.g. `Student` in this case), then no import is necessary. + +```scala +import scala.language.implicitConversions // required to define an implicit conversion + +case class Student(name: String) +object Student { + implicit def fromStudentToInt(student: Student): Int = student.name.length +} + +object Conversions { + implicit def fromStringToStudent(name: String): Student = Student(name) +} + +import Conversions._ +object Usage { + def main(args: Array[String]) = { + val reginald: Student = "Reginald" // applies the conversion Conversions.fromStringToStudent + println(reginald + 2) // applies the conversion Student.fromStudentToInt + } +} +``` +{% endtab %} +{% tab 'Scala 3' %} +In Scala 3, an implicit conversion is brought into scope by either importing `given` or the named conversion from the object that defined it, (e.g. `Conversions` in this case). + +Note that as of Scala 3, implicit conversions cannot be brought into scope anymore by means of a wildcard import (`*`). + +Given the example: + +```scala +case class Student(name: String): + def printName: Unit = println(name) +object Student: + given Conversion[Student, Int] = _.name.length + +object Conversions: + given fromStringToStudent: Conversion[String, Student] = Student(_) +``` + +The following imports would bring the `Conversion[String, Student]` into scope: + - `import Conversions.given` + - `import Conversions.{given Conversion[String, Student]}` + - `import Conversions.fromStringToStudent` + +If the implicit conversion is in the companion object of the argument type, (e.g. `Student` in this case), then no import is necessary. + +```scala +import Conversions.given +object Usage: + @main def run = + val reginald: Student = "Reginald" // applies the Conversion[String, Student] + println(reginald + 2) // applies the Conversion[Student, Int] +``` +{% endtab %} +{% endtabs %} + +Further reading: + - [Where does Scala look for implicits? (on StackOverflow)](https://docs.scala-lang.org/tutorials/FAQ/index.html#where-does-scala-look-for-implicits). ### Beware the power of implicit conversions From 00a343e9dc9bbed3846ae42eb9a7d7ae031dbe8d Mon Sep 17 00:00:00 2001 From: fsalvi Date: Tue, 24 Jan 2023 11:35:18 +0100 Subject: [PATCH 2452/3075] Improve documentation about Docker --- README.md | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index c0d4cbfe66..7e2ab822fb 100644 --- a/README.md +++ b/README.md @@ -15,19 +15,32 @@ To build and view the site locally: For more details, read on. -## Quickstart with Docker ## +## Quickstart with Docker Compose ## -To build and view site with Docker: +You need to have [Docker Engine](https://docs.docker.com/engine/) and [Docker Compose](https://docs.docker.com/compose/) installed on your machine. +Under macOS (Intel or Apple silicon), instead of installing [Docker Desktop](https://docs.docker.com/desktop/) you can also use [HomeBrew](https://brew.sh/) with [Colima](https://github.com/abiosoft/colima): `brew install colima docker`. +UID and GID environment variables are needed to avoid docker from writing files as root in your directory. - env UID="$(id -u)" GID="$(id -g)" docker-compose up +``` +env UID="$(id -u)" GID="$(id -g)" docker-compose up +``` -It will incrementally build and serve site at `http://localhost:4000`. +The generated site is available at `http://localhost:4000`. -In case the Dockerfile changed, re-build it with: +When the website dependencies change (the content of the `Gemfile`), +you have to re-build the Docker image: - env UID="$(id -u)" GID="$(id -g)" docker-compose up --build +``` +env UID="$(id -u)" GID="$(id -g)" docker-compose up --build +``` -For more details on the Docker option, see [this issue](https://github.com/scala/docs.scala-lang/issues/1286). +If you have problems with the Docker image or want to force the rebuild of the Docker image: +``` +env UID="$(id -u)" GID="$(id -g)" docker-compose build --no-cache +``` + + +For more details on the Docker option, see also [this issue](https://github.com/scala/docs.scala-lang/issues/1286). ## Contributing ## From fa3873701596ee9b0607ef5bf6aa9dab7beb2571 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 25 Jan 2023 00:59:23 -0800 Subject: [PATCH 2453/3075] remove various references to Eclipse and Scala IDE (#2676) --- _overviews/macros/overview.md | 6 +- _overviews/scala-book/oop-pizza-example.md | 2 +- _overviews/scala-book/preliminaries.md | 3 +- _overviews/scala-book/scala-repl.md | 1 - _overviews/scala3-migration/tooling-tour.md | 2 +- _overviews/tutorials/scala-with-maven.md | 79 ------------------- ...les-in-scala-impressions-and-statistics.md | 2 +- 7 files changed, 7 insertions(+), 88 deletions(-) diff --git a/_overviews/macros/overview.md b/_overviews/macros/overview.md index 87cf64ee8b..c66b1c6d48 100644 --- a/_overviews/macros/overview.md +++ b/_overviews/macros/overview.md @@ -223,15 +223,15 @@ The walkthrough in this guide uses the simplest possible command-line compilatio * Macros needs scala-reflect.jar in library dependencies. * The separate compilation restriction requires macros to be placed in a separate project. -### Using macros with Scala IDE or Intellij IDEA +### Using macros with Intellij IDEA -Both in Scala IDE and in Intellij IDEA macros are known to work fine, given they are moved to a separate project. +In Intellij IDEA, macros are known to work fine, given they are moved to a separate project. ### Debugging macros Debugging macros (i.e. the logic that drives macro expansion) is fairly straightforward. Since macros are expanded within the compiler, all that you need is to run the compiler under a debugger. To do that, you need to: 1) add all (!) the libraries from the lib directory in your Scala home (which include such jar files as `scala-library.jar`, `scala-reflect.jar` and `scala-compiler.jar`) to the classpath of your debug configuration, 2) set `scala.tools.nsc.Main` as an entry point, 3) provide the `-Dscala.usejavacp=true` system property for the JVM (very important!), 4) set command-line arguments for the compiler as `-cp Test.scala`, where `Test.scala` stands for a test file containing macro invocations to be expanded. After all that is done, you should be able to put a breakpoint inside your macro implementation and launch the debugger. -What really requires special support in tools is debugging the results of macro expansion (i.e. the code that is generated by a macro). Since this code is never written out manually, you cannot set breakpoints there, and you won't be able to step through it. Scala IDE and Intellij IDEA teams will probably add support for this in their debuggers at some point, but for now the only way to debug macro expansions are diagnostic prints: `-Ymacro-debug-lite` (as described below), which prints out the code emitted by macros, and println to trace the execution of the generated code. +What really requires special support in tools is debugging the results of macro expansion (i.e. the code that is generated by a macro). Since this code is never written out manually, you cannot set breakpoints there, and you won't be able to step through it. The Intellij IDEA team will probably add support for this in their debugger at some point, but for now the only way to debug macro expansions are diagnostic prints: `-Ymacro-debug-lite` (as described below), which prints out the code emitted by macros, and println to trace the execution of the generated code. ### Inspecting generated code diff --git a/_overviews/scala-book/oop-pizza-example.md b/_overviews/scala-book/oop-pizza-example.md index e3890b7c1d..a7d11f9ff5 100644 --- a/_overviews/scala-book/oop-pizza-example.md +++ b/_overviews/scala-book/oop-pizza-example.md @@ -216,4 +216,4 @@ To experiment with this on your own, please see the *PizzaOopExample* project in - [github.com/alvinj/HelloScalaExamples](https://github.com/alvinj/HelloScalaExamples) -To compile this project it will help to either (a) use IntelliJ IDEA or Eclipse, or (b) know how to use the [Scala Build Tool](http://www.scala-sbt.org). +To compile this project it will help to either (a) use IntelliJ IDEA or Metals, or (b) know how to use the [Scala Build Tool](http://www.scala-sbt.org). diff --git a/_overviews/scala-book/preliminaries.md b/_overviews/scala-book/preliminaries.md index c721907432..cbc5221dff 100644 --- a/_overviews/scala-book/preliminaries.md +++ b/_overviews/scala-book/preliminaries.md @@ -45,11 +45,10 @@ One good thing to know up front is that comments in Scala are just like comments ## IDEs -The three main IDEs (integrated development environments) for Scala are: +The two main IDEs (integrated development environments) for Scala are: - [IntelliJ IDEA](https://www.jetbrains.com/idea/download) - [Visual Studio Code](https://code.visualstudio.com) -- [Scala IDE for Eclipse](http://scala-ide.org) diff --git a/_overviews/scala-book/scala-repl.md b/_overviews/scala-book/scala-repl.md index dca6df5007..d3227b15b1 100644 --- a/_overviews/scala-book/scala-repl.md +++ b/_overviews/scala-book/scala-repl.md @@ -72,6 +72,5 @@ In addition to the REPL there are a couple of other, similar tools you can use: - [Scastie](https://scastie.scala-lang.org) is “an interactive playground for Scala” with several nice features, including being able to control build settings and share code snippets - IntelliJ IDEA has a Worksheet plugin that lets you do the same things inside your IDE -- The Scala IDE for Eclipse also has a Worksheet plugin For more information on the Scala REPL, see the [Scala REPL overview]({{site.baseurl}}/overviews/repl/overview.html) diff --git a/_overviews/scala3-migration/tooling-tour.md b/_overviews/scala3-migration/tooling-tour.md index 5270cb216e..dda576b594 100644 --- a/_overviews/scala3-migration/tooling-tour.md +++ b/_overviews/scala3-migration/tooling-tour.md @@ -68,7 +68,7 @@ Scala 3 support for Maven will soon land in the [scala-maven-plugin](https://git ### Metals -[Metals](https://scalameta.org/metals/) is a Scala language server that works with VS Code, Vim, Emacs, Sublime Text and Eclipse. +[Metals](https://scalameta.org/metals/) is a Scala language server that works with VS Code, Vim, Emacs, Sublime Text, and other editors. Scala 3 is already very well supported by Metals. Some minor adjustments for the new syntax changes and new features are coming. diff --git a/_overviews/tutorials/scala-with-maven.md b/_overviews/tutorials/scala-with-maven.md index 339d153e0f..0cdbfc990a 100644 --- a/_overviews/tutorials/scala-with-maven.md +++ b/_overviews/tutorials/scala-with-maven.md @@ -163,82 +163,6 @@ After adding this, `mvn package` will also create `[artifactId]-[version]-jar-wi - `mvn clean` - `mvn package`: compile, run tests, and create jar -### Integration with Eclipse ([Scala IDE][24]) -There are instructions at the [Scala Maven Plugin FAQs][23], but I thought I'd expand a bit. The [maven-eclipse-plugin][33] is a core plugin (all plugins prefixed with "maven" are, and are available by default) to generate Eclipse configuration files. However, this plugin does not know about our new Scala source files. We'll be using the [build-helper-maven-plugin][34] to add new source folders: - - ... - - org.codehaus.mojo - build-helper-maven-plugin - - - add-source - generate-sources - - add-source - - - - src/main/scala - - - - - add-test-source - generate-sources - - add-test-source - - - - src/test/scala - - - - - - ... - -After adding that to your `pom.xml`: - -1. Run `mvn eclipse:eclipse` - this generates the Eclipse project files (which are already ignored by our archetype's `.gitignore`) -2. Run `mvn -Declipse.workspace="path/to/your/eclipse/workspace" eclipse:configure-workspace` - this adds an `M2_REPO` classpath variable to Eclipse -3. Run `mvn package` to ensure you have all the dependencies in your local Maven repo - -Unfortunately, the integration isn't perfect. Firstly, open up the generated `.classpath` file (it will be hidden by default as it's a dotfile, but it should be in your project root directory; where you ran `mvn eclipse:eclipse`). You should see something like this near the top. - - - - -Change the `*.java` to `*.scala` (or duplicate the lines and change them to `*.scala` if you also have Java sources). - -Secondly, open the `.project` eclipse file (again, in the same folder). Change `` and `` to look like this. Now Eclipse knows to use the Scala editor, and it won't think that everything is a syntax error. - - - - org.scala-ide.sdt.core.scalabuilder - - - - org.scala-ide.sdt.core.scalanature - org.eclipse.jdt.core.javanature - - -Finally, in Eclipse, under "File" choose "Import..." and find your project. - -#### Using [m2eclipse-scala][35] for Eclipse integration -m2eclipse-scala is a work in progress, and their website/repository may have updated information. -It aims to ease integration between m2eclipse and Scala IDE for Eclipse. - -Under "Help -> Install New Software", enter "https://alchim31.free.fr/m2e-scala/update-site" and hit enter. -You should see "Maven Integration for Eclipse -> Maven Integration for Scala IDE". - -After it installs, go to "New -> Project -> Other" and select "Maven Project". -Search fo "scala-archetype" choose the one with the group "net.alchim31.maven". -The wizard will more or less guide you through what was done with `mvn archetype:generate` above, and you should end up with a new Scala project! - -To import an existing project, simply go to "File -> Import -> Existing Maven Project" and find the directory containing your project. - ## Adding Dependencies The first thing I do is look for "Maven" in the project page. For example, Google's [Guava] page includes [Maven Central links][28]. As you can see in the previous link, The Central Repository conveniently includes the snippet you have to add to your `pom.xml` on the left sidebar. @@ -277,7 +201,6 @@ I'm not going to explain all of Maven in this tutorial (though I hope to add mor [21]: https://search.maven.org/#search%7Cga%7C1%7Ca%3A%22maven-assembly-plugin%22 [22]: https://davidb.github.io/scala-maven-plugin [23]: https://davidb.github.io/scala-maven-plugin/faq.html -[24]: https://scala-ide.org [25]: https://scala-lang.org/api/current/index.html#scala.App [26]: https://docs.scala-lang.org/tutorials/tour/polymorphic-methods.html [27]: https://code.google.com/p/guava-libraries/ @@ -286,7 +209,5 @@ I'm not going to explain all of Maven in this tutorial (though I hope to add mor [30]: https://search.maven.org/#search%7Cga%7C1%7Cscopt [31]: https://mvnrepository.com [32]: https://docs.scala-lang.org/contribute.html -[33]: https://maven.apache.org/plugins/maven-eclipse-plugin/ [34]: https://www.mojohaus.org/build-helper-maven-plugin/ -[35]: https://github.com/sonatype/m2eclipse-scala [36]: https://github.com/scala/scala-module-dependency-sample diff --git a/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md b/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md index c6c40c21ca..c4722a5bb3 100644 --- a/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md +++ b/news/_posts/2012-12-12-functional-programming-principles-in-scala-impressions-and-statistics.md @@ -79,7 +79,7 @@ We also collected numbers about the used programming tools. First, we were inter
    Which editor do you normally use, and which editor did you use for the course?
     
    -The collected numbers are markedly different. In no small part this is due to the fact that the [Scala IDE for Eclipse](https://scala-ide.org) introduced a new [worksheet](https://github.com/scala-ide/scala-worksheet/wiki/Getting-Started) component used throughout the lectures. +The collected numbers are markedly different. In no small part this is due to the fact that the Scala IDE for Eclipse introduced a new [worksheet](https://github.com/scala-ide/scala-worksheet/wiki/Getting-Started) component used throughout the lectures. We'd like to close with some fun, and partially surprising, information on the demographics of those who took the course and completed our survey. Here is a world map showing the number of participants per country— darker colors indicate a larger number of students per-country: From 6b6c57fed6d266ade6235de3c5d2921770f248eb Mon Sep 17 00:00:00 2001 From: fsalvi Date: Wed, 25 Jan 2023 18:53:43 +0100 Subject: [PATCH 2454/3075] Add missing docker-compose in homebrew command --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7e2ab822fb..1f9c2dbd7d 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ For more details, read on. ## Quickstart with Docker Compose ## You need to have [Docker Engine](https://docs.docker.com/engine/) and [Docker Compose](https://docs.docker.com/compose/) installed on your machine. -Under macOS (Intel or Apple silicon), instead of installing [Docker Desktop](https://docs.docker.com/desktop/) you can also use [HomeBrew](https://brew.sh/) with [Colima](https://github.com/abiosoft/colima): `brew install colima docker`. +Under macOS (Intel or Apple silicon), instead of installing [Docker Desktop](https://docs.docker.com/desktop/) you can also use [HomeBrew](https://brew.sh/) with [Colima](https://github.com/abiosoft/colima): `brew install colima docker docker-compose`. UID and GID environment variables are needed to avoid docker from writing files as root in your directory. ``` From 2ab8aa3ee1c0cf06372645c39624b0f7d0c1af6d Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Mon, 30 Jan 2023 09:07:15 +0800 Subject: [PATCH 2455/3075] add code tabs in _zh-cn/overviews/scala3-book/taste-objects.md. --- _zh-cn/overviews/scala3-book/taste-objects.md | 76 +++++++++++++++++++ 1 file changed, 76 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/taste-objects.md b/_zh-cn/overviews/scala3-book/taste-objects.md index e24d759a24..3d3ec5457e 100644 --- a/_zh-cn/overviews/scala3-book/taste-objects.md +++ b/_zh-cn/overviews/scala3-book/taste-objects.md @@ -29,6 +29,20 @@ permalink: "/zh-cn/scala3/book/:title.html" 因为 `object` 是单例，所以它的方法可以像 Java 类中的 `static` 方法一样被访问。 例如，此 `StringUtils` 对象包含一个与字符串相关的方法的小型集合： +{% tabs object_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=object_1 %} + +```scala +object StringUtils { + def isNullOrEmpty(s: String): Boolean = s == null || s.trim.isEmpty + def leftTrim(s: String): String = s.replaceAll("^\\s+", "") + def rightTrim(s: String): String = s.replaceAll("\\s+$", "") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=object_1 %} + ```scala object StringUtils: def isNullOrEmpty(s: String): Boolean = s == null || s.trim.isEmpty @@ -36,13 +50,22 @@ object StringUtils: def rightTrim(s: String): String = s.replaceAll("\\s+$", "") ``` +{% endtab %} +{% endtabs %} + 由于 `StringUtils` 是一个单例，因此可以直接在对象上调用其方法： +{% tabs object_2 %} +{% tab 'Scala 2 and 3' for=object_2 %} + ```scala val x = StringUtils.isNullOrEmpty("") // true val x = StringUtils.isNullOrEmpty("a") // false ``` +{% endtab %} +{% endtabs %} + ## 伴生对象 伴生类或对象可以访问其伙伴的私有成员。 @@ -50,6 +73,29 @@ val x = StringUtils.isNullOrEmpty("a") // false 此示例演示了伴生类中的 `area` 方法如何访问其伴生对象中的私有 `calculateArea` 方法： +{% tabs object_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=object_3 %} + +```scala +import scala.math._ + +class Circle(radius: Double) { + import Circle._ + def area: Double = calculateArea(radius) +} + +object Circle { + private def calculateArea(radius: Double): Double = + Pi * pow(radius, 2.0) +} + +val circle1 = new Circle(5.0) +circle1.area // Double = 78.53981633974483 +``` + +{% endtab %} +{% tab 'Scala 3' for=object_3 %} + ```scala import scala.math.* @@ -65,11 +111,38 @@ val circle1 = Circle(5.0) circle1.area // Double = 78.53981633974483 ``` +{% endtab %} +{% endtabs %} + ## 从 traits 创建模块 对象还可用于实现创建模块的 trait。 这种技术需要两个traits，并将它们结合起来创建一个具体的 `object`： +{% tabs object_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=object_4 %} + +```scala +trait AddService { + def add(a: Int, b: Int) = a + b +} + +trait MultiplyService { + def multiply(a: Int, b: Int) = a * b +} + +// implement those traits as a concrete object +object MathService extends AddService with MultiplyService + +// use the object +import MathService._ +println(add(1,1)) // 2 +println(multiply(2,2)) // 4 +``` + +{% endtab %} +{% tab 'Scala 3' for=object_4 %} + ```scala trait AddService: def add(a: Int, b: Int) = a + b @@ -86,6 +159,9 @@ println(add(1,1)) // 2 println(multiply(2,2)) // 4 ``` +{% endtab %} +{% endtabs %} + {% comment %} NOTE: I don’t know if this is worth keeping, but I’m leaving it here as a comment for now. From a495b9184907c7ba1f7d1b92ee13496fd9b45bfb Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Mon, 30 Jan 2023 09:34:51 +0800 Subject: [PATCH 2456/3075] add code tabs in _zh-cn/overviews/scala3-book/taste-collections.md. --- .../scala3-book/taste-collections.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/taste-collections.md b/_zh-cn/overviews/scala3-book/taste-collections.md index d6b987a7a6..afff4ece2e 100644 --- a/_zh-cn/overviews/scala3-book/taste-collections.md +++ b/_zh-cn/overviews/scala3-book/taste-collections.md @@ -22,6 +22,9 @@ Scala 库具有一组丰富的集合类，这些类具有一组丰富的方法 为了让您了解这些类的工作原理，下面是一些使用 `List` 类的示例，该类是不可变的链接列表类。 这些示例显示了创建填充的 `List` 的不同方法： +{% tabs collection_1 %} +{% tab 'Scala 2 and 3' for=collection_1 %} + ```scala val a = List(1, 2, 3) // a: List[Int] = List(1, 2, 3) @@ -33,12 +36,18 @@ val f = List.range(1, 5) // f: List[Int] = List(1, 2, 3, 4) val g = List.range(1, 10, 3) // g: List[Int] = List(1, 4, 7) ``` +{% endtab %} +{% endtabs %} + ## `List`方法 拥有填充的列表后，以下示例将显示可以对其调用的一些方法。 请注意，这些都是函数式方法，这意味着它们不会改变调用的集合，而是返回包含更新元素的新集合。 每个表达式返回的结果显示在每行的注释中： +{% tabs collection_2 %} +{% tab 'Scala 2 and 3' for=collection_2 %} + ```scala // a sample list val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) @@ -61,8 +70,14 @@ nums.map(_.toUpperCase) // List("ONE", "TWO") nums.flatMap(_.toUpperCase) // List('O', 'N', 'E', 'T', 'W', 'O') ``` +{% endtab %} +{% endtabs %} + 这些示例显示了如何使用 `foldLeft` 和 `reduceLeft` 方法来对整数序列中的值求和： +{% tabs collection_3 %} +{% tab 'Scala 2 and 3' for=collection_3 %} + ```scala val firstTen = (1 to 10).toList // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) @@ -70,6 +85,9 @@ firstTen.reduceLeft(_ + _) // 55 firstTen.foldLeft(100)(_ + _) // 155 (100 is a “seed” value) ``` +{% endtab %} +{% endtabs %} + Scala 集合类还有更多可用的方法，它们在[集合章节][collections]和 [API 文档][api]中进行了演示。 ## 元组 @@ -77,26 +95,47 @@ Scala 集合类还有更多可用的方法，它们在[集合章节][collections Scala _元组_ 是一种类型，可让您轻松地将不同类型的集合放在同一个容器中。 例如，给定以下 `Person` 样例类： +{% tabs collection_4 %} +{% tab 'Scala 2 and 3' for=collection_4 %} + ```scala case class Person(name: String) ``` +{% endtab %} +{% endtabs %} + 这是演示你如创建一个元组，这个元组包含 `Int`, `String`, 和定制的 `Person` 值： +{% tabs collection_5 %} +{% tab 'Scala 2 and 3' for=collection_5 %} + ```scala val t = (11, "eleven", Person("Eleven")) ``` +{% endtab %} +{% endtabs %} + 有元组后，可以通过将其值绑定到变量来访问，也可以通过数字访问它们： +{% tabs collection_6 %} +{% tab 'Scala 2 and 3' for=collection_6 %} + ```scala t(0) // 11 t(1) // "eleven" t(2) // Person("Eleven") ``` +{% endtab %} +{% endtabs %} + 您还可以使用以下 _解构_ 的办法将元组字段分配变量名： +{% tabs collection_7 %} +{% tab 'Scala 2 and 3' for=collection_7 %} + ```scala val (num, str, person) = t @@ -106,6 +145,9 @@ val (num, str, person) = t // val person: Person = Person(Eleven) ``` +{% endtab %} +{% endtabs %} + 有些情况更适合使用元组， 那就是当你想要将异构类型的集合放在一个小的类似集合的结构中。 有关更多元组详细信息，请参阅 [参考文档][reference]。 From 4cdc803fcb86a25ca1ec37818e694a4a00cfbbc5 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Mon, 30 Jan 2023 10:00:37 +0800 Subject: [PATCH 2457/3075] add code tabs in _zh-cn/overviews/scala3-book/taste-contextual-abstractions.md. --- .../taste-contextual-abstractions.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md index d5610c6872..8c92b8e653 100644 --- a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md +++ b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md @@ -24,11 +24,16 @@ TODO: Now that this is a separate section, it needs a little more content. 例如，考虑一个程序，该程序按两个条件对地址列表进行排序：城市名称，然后是街道名称。 +{% tabs contextual_1 %} +{% tab 'Scala 2 and 3' for=contextual_1 %} + ```scala val addresses: List[Address] = ... addresses.sortBy(address => (address.city, address.street)) ``` +{% endtab %} +{% endtabs %} `sortBy` 方法调用一个函数，该函数为每个地址返回值，这个值会用来与其他地址比较。 在本例中，我们传递一个函数，该函数返回一对，该对包含城市名称和街道名称。 @@ -44,9 +49,21 @@ addresses.sortBy(address => (address.city, address.street)) 但是，也可以显式传递它： +{% tabs contextual_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=contextual_2 %} + +```scala +addresses.sortBy(address => (address.city, address.street))(Ordering.Tuple2(Ordering.String, Ordering.String)) +``` + +{% endtab %} +{% tab 'Scala 3' for=contextual_2 %} + ```scala addresses.sortBy(address => (address.city, address.street))(using Ordering.Tuple2(Ordering.String, Ordering.String)) ``` +{% endtab %} +{% endtabs %} 在本例中，`Ordering.Tuple2(Ordering.String, Ordering.String)` 实例正是编译器以其他方式推断的实例。 换句话说，这两个示例生成相同的程序。 From 88fb88463114332c8612f86d9ce0156058823bb8 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 30 Jan 2023 05:00:38 +0000 Subject: [PATCH 2458/3075] Bump webrick from 1.7.0 to 1.8.1 Bumps [webrick](https://github.com/ruby/webrick) from 1.7.0 to 1.8.1. - [Release notes](https://github.com/ruby/webrick/releases) - [Commits](https://github.com/ruby/webrick/compare/v1.7.0...v1.8.1) --- updated-dependencies: - dependency-name: webrick dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- Gemfile | 2 +- Gemfile.lock | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile b/Gemfile index 7b332fd508..3a99c6aa7d 100644 --- a/Gemfile +++ b/Gemfile @@ -13,4 +13,4 @@ gem 'kramdown-parser-gfm' # and do: # bundle exec jekyll liveserve --incremental -gem "webrick", "~> 1.7" +gem "webrick", "~> 1.8" diff --git a/Gemfile.lock b/Gemfile.lock index 4765006422..f70c5637e4 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -79,7 +79,7 @@ GEM typhoeus (1.4.0) ethon (>= 0.9.0) unicode-display_width (1.8.0) - webrick (1.7.0) + webrick (1.8.1) yell (2.2.2) PLATFORMS @@ -91,7 +91,7 @@ DEPENDENCIES html-proofer jekyll-redirect-from kramdown-parser-gfm - webrick (~> 1.7) + webrick (~> 1.8) BUNDLED WITH 2.3.10 From e1e3ce1f1764525c802a8db27119fdac286fe67f Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Mon, 30 Jan 2023 16:54:26 +0800 Subject: [PATCH 2459/3075] add code tabs in _zh-cn/overviews/scala3-book/taste-methods.md. (#2681) * add code tabs in _zh-cn/overviews/scala3-book/taste-methods.md. * add code table in _zh-cn/overviews/scala3-book/taste-methods.md * correct label from _9 to _10. --- .../overviews/scala3-book/taste-functions.md | 19 +++++ _zh-cn/overviews/scala3-book/taste-methods.md | 84 ++++++++++++++++++- 2 files changed, 102 insertions(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/taste-functions.md b/_zh-cn/overviews/scala3-book/taste-functions.md index 9c52d09213..ca6725f77d 100644 --- a/_zh-cn/overviews/scala3-book/taste-functions.md +++ b/_zh-cn/overviews/scala3-book/taste-functions.md @@ -26,13 +26,23 @@ Lambdas（也称为 _匿名函数_）是保持代码简洁但可读性的重要 这两个示例是等效的，并演示如何通过将 lambda 传递到 `map` 方法中，将列表中的每个数字乘以 `2`： + +{% tabs function_1 %} +{% tab 'Scala 2 and 3' for=function_1 %} + ```scala val a = List(1, 2, 3).map(i => i * 2) // List(2,4,6) val b = List(1, 2, 3).map(_ * 2) // List(2,4,6) ``` +{% endtab %} +{% endtabs %} + 这些示例也等效于以下代码，该代码使用 `double` 方法而不是lambda： +{% tabs function_2 %} +{% tab 'Scala 2 and 3' for=function_2 %} + ```scala def double(i: Int): Int = i * 2 @@ -40,6 +50,9 @@ val a = List(1, 2, 3).map(i => double(i)) // List(2,4,6) val b = List(1, 2, 3).map(double) // List(2,4,6) ``` +{% endtab %} +{% endtabs %} + > 如果您以前从未见过 `map` 方法，它会将给定的函数应用于列表中的每个元素，从而生成一个包含结果值的新列表。 将 lambda 传递给集合类上的高阶函数（如 `List`）是 Scala 体验的一部分，您每天都会这样做。 @@ -51,6 +64,9 @@ val b = List(1, 2, 3).map(double) // List(2,4,6) 例如，此示例演示如何对一个集合进行两次筛选，然后将其余集合中的每个元素乘某个数： +{% tabs function_3 %} +{% tab 'Scala 2 and 3' for=function_3 %} + ```scala // a sample list val nums = (1 to 10).toList // List(1,2,3,4,5,6,7,8,9,10) @@ -63,6 +79,9 @@ val x = nums.filter(_ > 3) // result: x == List(40, 50, 60) ``` +{% endtab %} +{% endtabs %} + 除了在整个标准库中使用的高阶函数外，您还可以[创建自己的][higher-order] 高阶函数。 [higher-order]: {% link _zh-cn/overviews/scala3-book/fun-hofs.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-methods.md b/_zh-cn/overviews/scala3-book/taste-methods.md index 10e57ece93..25b6017ba6 100644 --- a/_zh-cn/overviews/scala3-book/taste-methods.md +++ b/_zh-cn/overviews/scala3-book/taste-methods.md @@ -19,35 +19,73 @@ permalink: "/zh-cn/scala3/book/:title.html" Scala 类、样例类、traits、枚举和对象都可以包含方法。 简单方法的语法如下所示： +{% tabs method_1 %} +{% tab 'Scala 2 and 3' for=method_1 %} + ```scala def methodName(param1: Type1, param2: Type2): ReturnType = // the method body // goes here ``` +{% endtab %} +{% endtabs %} + 这有一些例子： +{% tabs method_2 %} +{% tab 'Scala 2 and 3' for=method_2 %} + ```scala def sum(a: Int, b: Int): Int = a + b def concatenate(s1: String, s2: String): String = s1 + s2 ``` +{% endtab %} +{% endtabs %} + 您不必声明方法的返回类型，因此如果您愿意，可以像这样编写这些方法： +{% tabs method_3 %} +{% tab 'Scala 2 and 3' for=method_3 %} + ```scala def sum(a: Int, b: Int) = a + b def concatenate(s1: String, s2: String) = s1 + s2 ``` +{% endtab %} +{% endtabs %} + 这是你如何调用这些方法： +{% tabs method_4 %} +{% tab 'Scala 2 and 3' for=method_4 %} + ```scala val x = sum(1, 2) val y = concatenate("foo", "bar") ``` +{% endtab %} +{% endtabs %} + 这是一个多行的方法： +{% tabs method_5 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_5 %} + +```scala +def getStackTraceAsString(t: Throwable): String = { + val sw = new StringWriter + t.printStackTrace(new PrintWriter(sw)) + sw.toString +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_5 %} + ```scala def getStackTraceAsString(t: Throwable): String = val sw = new StringWriter @@ -55,23 +93,41 @@ def getStackTraceAsString(t: Throwable): String = sw.toString ``` +{% endtab %} +{% endtabs %} + 方法参数也可以具有默认值。 在此示例中，`timeout` 参数的默认值为 `5000`： +{% tabs method_6 %} +{% tab 'Scala 2 and 3' for=method_6 %} + ```scala def makeConnection(url: String, timeout: Int = 5000): Unit = println(s"url=$url, timeout=$timeout") ``` +{% endtab %} +{% endtabs %} + 由于方法声明中提供了默认的 `超时` 值，因此可以通过以下两种方式调用该方法： +{% tabs method_7 %} +{% tab 'Scala 2 and 3' for=method_7 %} + ```scala makeConnection("https://localhost") // url=http://localhost, timeout=5000 makeConnection("https://localhost", 2500) // url=http://localhost, timeout=2500 ``` +{% endtab %} +{% endtabs %} + Scala 还支持在调用方法时使用 _命名参数_，因此如果您愿意，也可以像这样调用该方法： +{% tabs method_8 %} +{% tab 'Scala 2 and 3' for=method_8 %} + ```scala makeConnection( url = "https://localhost", @@ -79,15 +135,27 @@ makeConnection( ) ``` +{% endtab %} +{% endtabs %} + 当多个方法参数具有相同的类型时，命名参数特别有用。 乍一看，使用此方法，您可能想知道哪些参数设置为 `true` 或 `false`： +{% tabs method_9 %} +{% tab 'Scala 2 and 3' for=method_9 %} + ```scala engage(true, true, true, false) ``` +{% endtab %} +{% endtabs %} + 如果没有IDE的帮助，那段代码可能很难阅读，但这个代码要明显得多： +{% tabs method_10 %} +{% tab 'Scala 2 and 3' for=method_10 %} + ```scala engage( speedIsSet = true, @@ -96,12 +164,17 @@ engage( turnedOffParkingBrake = false ) ``` +{% endtab %} +{% endtabs %} ## 扩展方法 _扩展方法_ 允许您向封闭类添加新方法。 例如，如果要将两个名为 `hello` 和 `aloha` 的方法添加到 `String` 类中，请将它们声明为扩展方法： +{% tabs extension0 %} +{% tab 'Scala 3 Only' %} + ```scala extension (s: String) def hello: String = s"Hello, ${s.capitalize}!" @@ -111,6 +184,9 @@ extension (s: String) "friend".aloha // "Aloha, Friend!" ``` +{% endtab %} +{% endtabs %} + `extension` 关键字声明了括号内的参数将定义一个或多个扩展方法。 如此示例所示，可以在扩展方法体中使用 `String` 类型的参数 `s`。 @@ -118,6 +194,9 @@ extension (s: String) 在这里，`makeInt` 采用一个名为 `radix` 的参数。 该代码不考虑可能的字符串到整数转换错误，但跳过细节，示例显示了它的工作原理： +{% tabs extension %} +{% tab 'Scala 3 Only' %} + ```scala extension (s: String) def makeInt(radix: Int): Int = Integer.parseInt(s, radix) @@ -127,7 +206,10 @@ extension (s: String) "100".makeInt(2) // Int = 4 ``` -## See also +{% endtab %} +{% endtabs %} + +## 参见 Scala方法可以更强大：它们可以采用类型参数和上下文参数。 它们在[领域建模][data-1]一节中有详细介绍。 From a307e1f786ced0d379ac6ef24513b7c29ff1b7f2 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Mon, 30 Jan 2023 16:54:55 +0800 Subject: [PATCH 2460/3075] update latest translation. (#2679) --- _zh-cn/overviews/scala3-book/taste-intro.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/taste-intro.md b/_zh-cn/overviews/scala3-book/taste-intro.md index df7fed74bd..1c0a5a6c3d 100644 --- a/_zh-cn/overviews/scala3-book/taste-intro.md +++ b/_zh-cn/overviews/scala3-book/taste-intro.md @@ -17,6 +17,11 @@ permalink: "/zh-cn/scala3/book/:title.html" 本章提供的快速导览涉及 Scala 3 编程语言的主要特性。 在本导览之后，本书的其余部分提供了有关这些特性的更多详细信息，而[参考文档][reference]提供了_许多_ 细节。 -> 在本书中，我们建议您在[Scastie](https://scastie.scala-lang.org) 或 Scala REPL 中尝试一些示例，该示例稍后演示。 +## 设置 Scala + +在本章和本书的其余部分，我们鼓励您通过复制或手动键入来尝试这些示例。遵循示例所需的工具你可以按照我们的[入门指南][get-started]在自己的计算机上安装。 + +> 或者，您可以使用 [Scastie](https://scastie.scala-lang.org) 在 Web 浏览器中运行这些示例，这是一个完全在线的编辑器和 Scala 的代码运行器。 [reference]: {{ site.scala3ref }}/overview.html +[get-started]: {% link _overviews/getting-started/index.md %} From 0f3a88ba1a782c8e904bedb2f413e5bb54ec36f1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= Date: Mon, 30 Jan 2023 12:23:18 +0100 Subject: [PATCH 2461/3075] Update Scala version to 3.2.2 --- _config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_config.yml b/_config.yml index 6297a62d58..3439515b5d 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.10 scala-212-version: 2.12.17 -scala-3-version: 3.2.1 +scala-3-version: 3.2.2 collections: style: From 05463647ec8a93bb34908281ff2855d155a61957 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= Date: Mon, 30 Jan 2023 12:25:36 +0100 Subject: [PATCH 2462/3075] Add api link to 3.2.1 --- api/all.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/api/all.md b/api/all.md index b9ced56bf8..7b5bb49c36 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,8 @@ redirect_from: ## Latest releases -* Scala 3.2.1 - * [Library API](https://www.scala-lang.org/api/3.2.1/) +* Scala 3.2.2 + * [Library API](https://www.scala-lang.org/api/3.2.2/) * Scala 2.13.10 * [Library API](https://www.scala-lang.org/api/2.13.10/) * [Compiler API](https://www.scala-lang.org/api/2.13.10/scala-compiler/scala/) @@ -62,6 +62,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.2.1 + * [Library API](https://www.scala-lang.org/api/3.2.1/) * Scala 3.2.0 * [Library API](https://www.scala-lang.org/api/3.2.0/) * Scala 3.1.3 From c5e795b2e94ccceb8ba42a1618dedf615c4d4484 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 31 Jan 2023 17:19:25 +0100 Subject: [PATCH 2463/3075] Improve IDE section of getting started tutorial (#2688) * Add links to IntelliJ and VSCode (Metals) * Improve IDE section of getting started tutorial - Add links to IntelliJ and Metals/VSCode - Remove technical note about build servers - Update links to install IntelliJ and its Scala plugin --- _overviews/getting-started/index.md | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 7058dff991..5510d479cd 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -182,13 +182,14 @@ You can skip the rest of this page and go directly to [Building a Scala Project ## Open hello-world project -Let's use an IDE to open the project. The most popular ones are IntelliJ and VSCode. -They both offer rich IDE features, but you can still use [many other editors.](https://scalameta.org/metals/docs/editors/overview.html) +Let's use an IDE to open the project. The most popular ones are [IntelliJ](https://www.jetbrains.com/idea/) and +[VSCode](https://scalameta.org/metals/docs/editors/vscode). +They both offer rich IDE features, but you can still use [many other editors](https://scalameta.org/metals/docs/editors/overview.html). ### Using IntelliJ -1. Download and install [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/) -1. Install the Scala plugin by following [the instructions on how to install IntelliJ plugins](https://www.jetbrains.com/help/idea/managing-plugins.html) +1. Download and install [IntelliJ Community Edition](https://www.jetbrains.com/help/idea/installation-guide.html) +1. Install the Scala plugin by following [the instructions on how to install IntelliJ plugins](https://www.jetbrains.com/help/idea/discover-intellij-idea-for-scala.html) 1. Open the `build.sbt` file then choose *Open as a project* ### Using VSCode with metals @@ -197,11 +198,6 @@ They both offer rich IDE features, but you can still use [many other editors.](h 1. Install the Metals extension from [the Marketplace](https://marketplace.visualstudio.com/items?itemName=scalameta.metals) 1. Next, open the directory containing a `build.sbt` file (this should be the directory `hello-world` if you followed the previous instructions). When prompted to do so, select *Import build*. ->[Metals](https://scalameta.org/metals) is a “Scala language server” that provides support for writing Scala code in VS Code and other editors like [Atom, Sublime Text, and more](https://scalameta.org/metals/docs/editors/overview.html), using the Language Server Protocol. -> -> Under the hood, Metals communicates with the build tool by using -> the [Build Server Protocol (BSP)](https://build-server-protocol.github.io/). For details on how Metals works, see, [“Write Scala in VS Code, Vim, Emacs, Atom and Sublime Text with Metals”](https://www.scala-lang.org/2019/04/16/metals.html). - ### Play with the source code View these two files in your IDE: From d2fc35b15b074310b2f27f9949bda22c4fa86151 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Sat, 4 Feb 2023 00:22:09 +0000 Subject: [PATCH 2464/3075] Update SIPs state --- _sips/sips/clause-interleaving.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/clause-interleaving.md b/_sips/sips/clause-interleaving.md index 98ef6defd3..ceeb01fc25 100644 --- a/_sips/sips/clause-interleaving.md +++ b/_sips/sips/clause-interleaving.md @@ -2,7 +2,7 @@ layout: sip title: SIP-47 - Clause Interleaving stage: implementation -status: waiting-for-implementation +status: under-review permalink: /sips/:title.html --- From 8dc4ccee2840951d5306bb4e0598a1ef81c3ea22 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sun, 5 Feb 2023 21:03:21 +0800 Subject: [PATCH 2465/3075] add code tab in _zh-cn/overviews/scala3-book/taste-toplevel-definitions.md --- .../scala3-book/taste-toplevel-definitions.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md index 11b577896f..7deb81d9de 100644 --- a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md +++ b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md @@ -1,5 +1,5 @@ --- -title: Toplevel Definitions +title: 顶层定义 type: section description: This page provides an introduction to top-level definitions in Scala 3 language: zh-cn @@ -17,6 +17,9 @@ permalink: "/zh-cn/scala3/book/:title.html" 在 Scala 3 中，各种定义都可以在源代码文件的 “顶层” 编写。 例如，您可以创建一个名为 _MyCoolApp.scala_ 的文件，并将以下内容放入其中： +{% tabs toplevel_1 %} +{% tab 'Scala 3 only' for=toplevel_1 %} + ```scala import scala.collection.mutable.ArrayBuffer @@ -43,6 +46,9 @@ type Money = BigDecimal println("show me the code".capitalizeAllWords) ``` +{% endtab %} +{% endtabs %} + 如代码中展示的，无需将这些定义放在 `package`, `class` 或其他构造中。 ## 替换包对象 @@ -50,6 +56,9 @@ type Money = BigDecimal 如果你熟悉Scala 2，这种方法可以取代 _包对象_。 但是，虽然更易于使用，但它们的工作方式类似：当您将定义放在名为 _foo_ 的包中时，您可以在 _foo_ 包内的所有其他包内访问该定义，例如在此示例中的 _foo.bar_ 包中： +{% tabs toplevel_2 %} +{% tab 'Scala 3 only' for=toplevel_2 %} + ```scala package foo { def double(i: Int) = i * 2 @@ -63,6 +72,9 @@ package foo { } ``` +{% endtab %} +{% endtabs %} + 本示例中使用大括号来强调包嵌套。 这种方法的好处是，您可以将定义放在名为 _com.acme.myapp_ 的包下，然后可以在 _com.acme.myapp.model_、_com.acme.myapp.controller_ 等中引用这些定义。 From e720e7a9c552508b0e7809a3cf950d9f6b87f31c Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sun, 5 Feb 2023 22:16:45 +0800 Subject: [PATCH 2466/3075] translate some "untranslated" titles in Chinese. --- _zh-cn/overviews/scala3-book/taste-collections.md | 2 +- _zh-cn/overviews/scala3-book/taste-contextual-abstractions.md | 2 +- _zh-cn/overviews/scala3-book/taste-functions.md | 2 +- _zh-cn/overviews/scala3-book/taste-methods.md | 2 +- _zh-cn/overviews/scala3-book/taste-summary.md | 4 ++-- _zh-cn/overviews/scala3-book/taste-toplevel-definitions.md | 2 +- 6 files changed, 7 insertions(+), 7 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/taste-collections.md b/_zh-cn/overviews/scala3-book/taste-collections.md index afff4ece2e..966872f1a3 100644 --- a/_zh-cn/overviews/scala3-book/taste-collections.md +++ b/_zh-cn/overviews/scala3-book/taste-collections.md @@ -1,5 +1,5 @@ --- -title: Collections +title: 集合 type: section description: This page provides a high-level overview of the main features of the Scala 3 programming language. language: zh-cn diff --git a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md index 8c92b8e653..cfa5db2f45 100644 --- a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md +++ b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md @@ -1,5 +1,5 @@ --- -title: Contextual Abstractions +title: 上下文抽象 type: section description: This section provides an introduction to Contextual Abstractions in Scala 3. language: zh-cn diff --git a/_zh-cn/overviews/scala3-book/taste-functions.md b/_zh-cn/overviews/scala3-book/taste-functions.md index ca6725f77d..71cea44649 100644 --- a/_zh-cn/overviews/scala3-book/taste-functions.md +++ b/_zh-cn/overviews/scala3-book/taste-functions.md @@ -1,5 +1,5 @@ --- -title: First-Class Functions +title: 头等函数 type: section description: This page provides an introduction to functions in Scala 3. language: zh-cn diff --git a/_zh-cn/overviews/scala3-book/taste-methods.md b/_zh-cn/overviews/scala3-book/taste-methods.md index 25b6017ba6..521c093a8e 100644 --- a/_zh-cn/overviews/scala3-book/taste-methods.md +++ b/_zh-cn/overviews/scala3-book/taste-methods.md @@ -1,5 +1,5 @@ --- -title: Methods +title: 方法 type: section description: This section provides an introduction to defining and using methods in Scala 3. language: zh-cn diff --git a/_zh-cn/overviews/scala3-book/taste-summary.md b/_zh-cn/overviews/scala3-book/taste-summary.md index 14c44c9bde..1fee593727 100644 --- a/_zh-cn/overviews/scala3-book/taste-summary.md +++ b/_zh-cn/overviews/scala3-book/taste-summary.md @@ -1,5 +1,5 @@ --- -title: Summary +title: 总结 type: section description: This page provides a summary of the previous 'Taste of Scala' sections. language: zh-cn @@ -26,7 +26,7 @@ permalink: "/zh-cn/scala3/book/:title.html" - 如何将对象用于多种目的 - [上下文抽象][contextual]的介绍 -我们还提到，如果您更喜欢使用基于浏览器的游乐场环境而不是 Scala REPL，您还可以使用[Scastie.scala-lang.org](https://scastie.scala-lang.org/?target=dotty) 或 [ScalaFiddle.io](https://scalafiddle.io)。 +我们还提到，如果您更喜欢使用基于浏览器的游乐场环境而不是 Scala REPL，您还可以使用[Scastie](https://scastie.scala-lang.org)。 Scala还有更多功能在这次旋风之旅中没有涵盖。 有关更多详细信息，请参阅本书的其余部分和[参考文档][reference]。 diff --git a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md index 11b577896f..e42dca2c47 100644 --- a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md +++ b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md @@ -1,5 +1,5 @@ --- -title: Toplevel Definitions +title: 顶层定义 type: section description: This page provides an introduction to top-level definitions in Scala 3 language: zh-cn From f84fea6c43c061c96be538ea475dca5e2691b896 Mon Sep 17 00:00:00 2001 From: Alvin Alexander Date: Mon, 6 Feb 2023 02:07:53 -0700 Subject: [PATCH 2467/3075] =?UTF-8?q?Updated=20pages=20to=20be=20=E2=80=9C?= =?UTF-8?q?Scala=203=20Only=E2=80=9D=20(#2689)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Updated pages to be 'Scala 3 Only' * Cross-write page Context Bounds - remove tag “Scala 3 only” - add a link to the page that explains context parameters and inferred terms - remove paragraph that shows anonymous context parameters - fix link to the FAQ - also cross-write the FAQ entry * Updated 'New in Scala 3' approach --------- Co-authored-by: Julien Richard-Foy --- _overviews/FAQ/index.md | 4 +- _overviews/scala3-book/ca-context-bounds.md | 44 ++++++++++++------- _overviews/scala3-book/ca-given-imports.md | 17 +++++++ .../scala3-book/ca-given-using-clauses.md | 2 +- .../scala3-book/ca-multiversal-equality.md | 4 ++ 5 files changed, 51 insertions(+), 20 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 6179c57098..4c65c0b734 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -149,9 +149,9 @@ See [this]({{ site.baseurl }}/tutorials/FAQ/initialization-order.html). See the [Scala 2.13 Collections Guide](https://docs.scala-lang.org/overviews/collections-2.13/introduction.html). -### What are context bounds (`[T : Foo]`)? +### What are context bounds? -It's syntactic sugar for an `implicit` parameter of type `Foo[T]`. +It's syntactic sugar for a context parameter (an `implicit` parameter in Scala 2, or a `using` parameter in Scala 3). More details in this [Stack Overflow answer](https://stackoverflow.com/a/4467012). diff --git a/_overviews/scala3-book/ca-context-bounds.md b/_overviews/scala3-book/ca-context-bounds.md index 7d4faa3c4d..b95482a25e 100644 --- a/_overviews/scala3-book/ca-context-bounds.md +++ b/_overviews/scala3-book/ca-context-bounds.md @@ -1,20 +1,14 @@ --- title: Context Bounds type: section -description: This page demonstrates Context Bounds in Scala 3. +description: This page demonstrates Context Bounds in Scala. languages: [zh-cn] num: 61 previous-page: ca-given-using-clauses next-page: ca-given-imports --- - -{% comment %} -- TODO: define "context parameter" -- TODO: define "synthesized" and "synthesized arguments" -{% endcomment %} - -In many situations the name of a _context parameter_ doesn’t have to be mentioned explicitly, since it’s only used by the compiler in synthesized arguments for other context parameters. +In many situations the name of a [context parameter]({% link _overviews/scala3-book/ca-given-using-clauses.md %}#using-clauses) doesn’t have to be mentioned explicitly, since it’s only used by the compiler in synthesized arguments for other context parameters. In that case you don’t have to define a parameter name, and can just provide the parameter type. @@ -22,29 +16,45 @@ In that case you don’t have to define a parameter name, and can just provide t For example, this `maximum` method takes a _context parameter_ of type `Ord`, only to pass it on as an argument to `max`: +{% tabs context-bounds-max-named-param class=tabs-scala-version %} + +{% tab 'Scala 2' %} ```scala -def maximum[A](xs: List[A])(using ord: Ord[A]): A = +def maximum[A](xs: List[A])(implicit ord: Ord[A]): A = xs.reduceLeft(max(ord)) ``` +{% endtab %} -In that code the parameter name `ord` isn’t actually required; it can be passed on as an inferred argument to `max`, so you just state that `maximum` uses the type `Ord[A]` without giving it a name: - +{% tab 'Scala 3' %} ```scala -def maximum[A](xs: List[A])(using Ord[A]): A = - xs.reduceLeft(max) +def maximum[A](xs: List[A])(using ord: Ord[A]): A = + xs.reduceLeft(max(using ord)) ``` +{% endtab %} +{% endtabs %} ## Context bounds -Given that background, a _context bound_ is a shorthand syntax for expressing the pattern of, “a context parameter that depends on a type parameter.” +Given that background, a _context bound_ is a shorthand syntax for expressing the pattern of, “a context parameter applied to a type parameter.” Using a context bound, the `maximum` method can be written like this: +{% tabs context-bounds-max-rewritten %} + +{% tab 'Scala 2 and 3' %} + ```scala -def maximum[A: Ord](xs: List[A]): A = xs.reduceLeft(max) +def maximum[A: Ord](xs: List[A]): A = + xs.reduceLeft(max) ``` -A bound like `: Ord` on a type parameter `A` of a method or class indicates a context parameter with `Ord[A]`. +{% endtab %} + +{% endtabs %} + + +A bound like `: Ord` on a type parameter `A` of a method or class indicates a context parameter with type `Ord[A]`. +Under the hood, the compiler transforms this syntax into the one shown in the Background section. -For more information about context bounds, see the [“What are context bounds?”](https://docs.scala-lang.org/tutorials/FAQ/context-bounds.html) section of the Scala FAQ. +For more information about context bounds, see the [“What are context bounds?”]({% link _overviews/FAQ/index.md %}#what-are-context-bounds) section of the Scala FAQ. diff --git a/_overviews/scala3-book/ca-given-imports.md b/_overviews/scala3-book/ca-given-imports.md index 9b009001a9..b60e21f75d 100644 --- a/_overviews/scala3-book/ca-given-imports.md +++ b/_overviews/scala3-book/ca-given-imports.md @@ -7,11 +7,16 @@ num: 62 previous-page: ca-context-bounds next-page: ca-type-classes --- +Scala 3 only To make it more clear where givens in the current scope are coming from, a special form of the `import` statement is used to import `given` instances. The basic form is shown in this example: +{% tabs given-imports-basic-form %} + +{% tab 'Scala 3 Only' %} + ```scala object A: class TC @@ -23,15 +28,27 @@ object B: import A.given // import the given instance ``` +{% endtab %} + +{% endtabs %} + In this code the `import A.*` clause of object `B` imports all members of `A` *except* the `given` instance, `tc`. Conversely, the second import, `import A.given`, imports *only* that `given` instance. The two `import` clauses can also be merged into one: +{% tabs given-imports-merged %} + +{% tab 'Scala 3 Only' %} + ```scala object B: import A.{given, *} ``` +{% endtab %} + +{% endtabs %} + ## Discussion diff --git a/_overviews/scala3-book/ca-given-using-clauses.md b/_overviews/scala3-book/ca-given-using-clauses.md index d762e8719a..a0c747c450 100644 --- a/_overviews/scala3-book/ca-given-using-clauses.md +++ b/_overviews/scala3-book/ca-given-using-clauses.md @@ -63,7 +63,7 @@ def renderWidget(items: List[String])(using c: Config): String = ??? {% endtab %} {% endtabs %} -By starting a parameter section with the keyword `using`, we tell the Scala compiler that at the callsite it should automatically find an argument with the correct type. +By starting a parameter section with the keyword `using`, we tell the Scala compiler that at the call-site it should automatically find an argument with the correct type. The Scala compiler thus performs **term inference**. In our call to `renderWidget(List("cart"))` the Scala compiler will see that there is a term of type `Config` in scope (the `c`) and automatically provide it to `renderWidget`. diff --git a/_overviews/scala3-book/ca-multiversal-equality.md b/_overviews/scala3-book/ca-multiversal-equality.md index dc16effb35..54aed55fa4 100644 --- a/_overviews/scala3-book/ca-multiversal-equality.md +++ b/_overviews/scala3-book/ca-multiversal-equality.md @@ -7,7 +7,11 @@ num: 64 previous-page: ca-type-classes next-page: ca-implicit-conversions --- +New In Scala 3 +> Multiversal Equality is a new language feature that was introduced in Scala 3. +> Because it has no equivalent in Scala 2, all code examples +> in this lesson assume you are using Scala 3. Previously, Scala had *universal equality*: Two values of any types could be compared with each other using `==` and `!=`. This came from the fact that `==` and `!=` are implemented in terms of Java’s `equals` method, which can also compare values of any two reference types. From 345e01ebec3f2226a542b81f3836905e020f3188 Mon Sep 17 00:00:00 2001 From: Chris Kipp Date: Mon, 6 Feb 2023 15:48:47 +0100 Subject: [PATCH 2468/3075] docs: migrate CONTRIBUTING.md from Dotty repo This change adds the extra information that is found in https://github.com/lampepfl/dotty/blob/main/CONTRIBUTING.md into the actual Scala 3 Contributing guide in an effort to get all of this information in a single place. After this is merge I'll do a follow-up pr to the `CONTRIBUTING.md` in Dotty to then point to this guide. --- _overviews/contribute/index.md | 3 +- .../scala3-contribution/contribution-intro.md | 30 +++-- .../procedures-checklist.md | 119 ++++++++++++++++-- _overviews/scala3-contribution/start-intro.md | 35 +++++- 4 files changed, 158 insertions(+), 29 deletions(-) diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index 3187150645..4fcafa87a3 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -40,8 +40,7 @@ scala_resources: icon: fa fa-bug link: /contribute/guide.html - title: Code Reviews - description: "Review pull requests against scala/scala, lampepfl/dotty, scala/scala-lang, scala/docs.scala-lang, - and others." + description: "Review pull requests against scala/scala, lampepfl/dotty, scala/scala-lang, scala/docs.scala-lang, and others." icon: fa fa-eye link: /contribute/codereviews.html - title: Core Libraries diff --git a/_overviews/scala3-contribution/contribution-intro.md b/_overviews/scala3-contribution/contribution-intro.md index 66ed7cb7a2..e20377d74b 100644 --- a/_overviews/scala3-contribution/contribution-intro.md +++ b/_overviews/scala3-contribution/contribution-intro.md @@ -11,26 +11,32 @@ This guide is intended to give new contributors the knowledge they need to become productive and fix issues or implement new features in Scala 3. It also documents the inner workings of the Scala 3 compiler, `dotc`. -### A Note on Stability +### This is a living document -Keep in mind that the code for `dotc` is subject to change, with no -guarantees of stability, so the ideas discussed in this guide may -fall out of date, please consider contributing to this guide -on [GitHub](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-contribution). +Keep in mind that the code for `dotc` is continually changing, so the ideas +discussed in this guide may fall out of date. This is a living document, so +please consider contributing to it on +[GitHub](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-contribution) +if you notice anything out of date, or report any issues +[here](https://github.com/scala/docs.scala-lang/issues). ### Get the Most from This Guide -`dotc` is built with Scala 3, fully utilising its [new features](/scala3/new-in-scala3.html). -It is recommended that you first have some familiarity with Scala 3 -to get the most out of this guide. You can learn more in the [language reference]({{ site.scala3ref}}). +`dotc` is built with Scala 3, fully utilising its [new +features](/scala3/new-in-scala3.html). It is recommended that you first have +some familiarity with Scala 3 to get the most out of this guide. You can learn +more in the [language reference]({{ site.scala3ref }}). -Many code snippets in this guide make use of shell commands (a line beginning with `$`), and in this case -a `bash` compatible shell is assumed. You may have to look up how to translate commands to your shell. +Many code snippets in this guide make use of shell commands (a line beginning +with `$`), and in this case a `bash` compatible shell is assumed. You may have +to look up how to translate commands to your shell. ### What is a Compiler? -A compiler is a program that takes as input text, representing a program in one language -and produces as output the same program, written in another programming language. +Let's start at the beginning and first look at the question of "what is a +compiler?". A compiler is a program that takes as input text, representing a +program in one language and produces as output the same program, written in +another programming language. #### The Scala Compiler diff --git a/_overviews/scala3-contribution/procedures-checklist.md b/_overviews/scala3-contribution/procedures-checklist.md index df194f99e9..3c0dcc3e37 100644 --- a/_overviews/scala3-contribution/procedures-checklist.md +++ b/_overviews/scala3-contribution/procedures-checklist.md @@ -7,31 +7,124 @@ previous-page: procedures-testing next-page: arch-intro --- -Once you solved an issue, you likely want to see your change added to the [Scala 3 repo][lampepfl/dotty]. -To do that, you need to prepare a [pull request][pull-request] with your changes. We recommend you -follow these guidelines, [also consult the full requirements][full-list]: +Once you solved the issue you were working on, you'll likely want to see your +changes added to the [Scala 3 repo][lampepfl/dotty]. To do that, you need to +prepare a [pull request][pull-request] with your changes. Assuming that the team +is aware of what you've been working, here are some final steps that you'll want +to keep in mind as you create your PR. ### 1. Sign the CLA -Make sure you have signed the [Scala CLA][cla], if not, sign it. +Make sure you have signed the [Scala CLA][cla]. If you have any questions about +what this is and why it's required you can read further about it [here][cla]. -### 2: Is It Relevant? +### 2. Make sure your work is on its own branch -Before starting to work on a feature or a fix, it's good practice to ensure that: -1. There is a ticket for your work in the project's [issue tracker][issues]; -2. The ticket has been discussed and there is desire for it to be implemented by the -Scala 3 core maintainers. +When submitting your pull request it's always best to ensure the branch name is +unique to the changes you're working on. It's important not to submit your PR on +your `main` branch as this blocks maintainers from making any changes to your PR +if necessary. ### 3: Add Tests + Add at least one test that replicates the problem in the issue, and that shows it is now resolved. You may of course add variations of the test code to try and eliminate edge cases. [Become familiar with testing in Scala 3][testing]. ### 4: Add Documentation + Please ensure that all code is documented to explain its use, even if only internal -changes are made. +changes are made. This refers to scaladocs and also any changes that might be +necessary in the reference docs. + +### 5: Double check everything + +Here are a couple tips to keep in mind. + +- [DRY (Don't Repeat Yourself)][dry] +- [Scouts Rule][scouts] +- When adding new code try use [optional braces]. If you're rewriting old code, + you should also use optional braces unless it introduces more code changes + that necessary. + +### 6: Commit Messages + +Here are some guidelines when writing commits for Dotty. + +1. If your work spans multiple local commits (for example; if you do safe point + commits while working in a feature branch or work in a branch for long time + doing merges/rebases etc.) then please do not commit it all but rewrite the + history by squashing the commits into one large commit which is accompanied + by a detailed commit message for (as discussed in the following sections). + For more info, see the article: [Git Workflow][git-workflow]. Additionally, + every commit should be able to be used in isolation—that is, each commit must + build and pass all tests. + +2. The first line should be a descriptive sentence about what the commit is + doing. It should be possible to fully understand what the commit does by just + reading this single line. It is **not ok** to only list the ticket number, + type "minor fix" or similar. If the commit has a corresponding ticket, + include a reference to the ticket number, prefixed with "Closes #", at the + beginning of the first line followed by the title of the ticket, assuming + that it aptly and concisely summarizes the commit in a single line. If the + commit is a small fix, then you are done. If not, go to 3. + +3. Following the single line description (ideally no more than 70 characters + long) should be a blank line followed by an enumerated list with the details + of the commit. + +4. Add keywords for your commit (depending on the degree of automation we reach, + the list may change over time): + * ``Review by @githubuser`` - will notify the reviewer via GitHub. Everyone + is encouraged to give feedback, however. (Remember that @-mentions will + result in notifications also when pushing to a WIP branch, so please only + include this in your commit message when you're ready for your pull + request to be reviewed. Alternatively, you may request a review in the + pull request's description.) + * ``Fix/Fixing/Fixes/Close/Closing/Refs #ticket`` - if you want to mark the + ticket as fixed in the issue tracker (Assembla understands this). + * ``backport to _branch name_`` - if the fix needs to be cherry-picked to + another branch (like 2.9.x, 2.10.x, etc) + +Example: + +``` +fix: here is your pr title briefly mentioning the topic + +Here is the body of your pr with some more information + - Details 1 + - Details 2 + - Details 3 + +Closes #2 +``` + +### 7: Create your PR! + +When the feature or fix is completed you should open a [Pull +Request](https://help.github.com/articles/using-pull-requests) on GitHub. + +If you're not actually finished yet and are just looking for some initial input +on your approach, feel free to open a [Draft PR][draft]. This lets reviewers +know that you're not finished yet. It's also a good idea to put a [wip] in front +of your pr title to make this extra clear. + +Shortly after creating your pull request a maintainer should assign someone to +review it. If this doesn't happen after a few days, feel free to ping someone on +the [Scala Contributors Discor][discord] or tag someone on the PR. Depending on +the type of pull request there might be multiple people that take a look at your +changes. There might also be community input as we try to keep the review +process as open as possible. + +### 8: Addressing feedback + +More than likely you'll get feedback from the reviewers, so you'll want to make +sure to address everything. When in doubt, don't hesitate to ask for +clarification or more information. +Once you finally see the "LGTM" (Looks Good To Me or Let's Get This Merged) +you're PR will be merged in! [pull-request]: https://docs.github.com/en?query=pull+requests [lampepfl/dotty]: https://github.com/lampepfl/dotty @@ -39,3 +132,9 @@ changes are made. [issues]: https://github.com/lampepfl/dotty/issues [full-list]: https://github.com/lampepfl/dotty/blob/master/CONTRIBUTING.md [testing]: {% link _overviews/scala3-contribution/procedures-testing.md %} +[discord]: https://discord.gg/TSmY9zkHar +[dry]: https://www.oreilly.com/library/view/97-things-every/9780596809515/ch30.html +[scouts]: https://www.oreilly.com/library/view/97-things-every/9780596809515/ch08.html +[optional-braces]: https://docs.scala-lang.org/scala3/reference/other-new-features/indentation.html +[draft]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests +[git-workflow]: http://sandofsky.com/blog/git-workflow.html diff --git a/_overviews/scala3-contribution/start-intro.md b/_overviews/scala3-contribution/start-intro.md index 815e9a1a8a..94a34e705f 100644 --- a/_overviews/scala3-contribution/start-intro.md +++ b/_overviews/scala3-contribution/start-intro.md @@ -9,11 +9,29 @@ next-page: procedures-intro ## First Steps +### Scala CLA + +Sometime before submitting you're pull request you'll want to make sure you have +signed the [Scala CLA][scala-cla]. You can read more about why we require a CLA +and what exactly is included in it [here][scala-cla]. + +### Making sure the team is aware + +Before digging into an issue or starting on a new feature it's a good idea to +make sure an [issue][dotty-issue] or a [discussion][dotty-discussion] has been +created outlining what you plan to work on. This is both for your and the team's +benefit. It ensures you get the help you need, and also gives the compiler team +a heads up that someone is working on an issue. + +For some small changes like documentation, this isn't always necessary, but it's +never a bad idea to check. + ### Required Tools #### Essential -- [git] is essential for managing the Scala 3 code, and contributing to GitHub, where the code is hosted. +- [git] is essential for managing the Scala 3 code, and contributing to GitHub, + where the code is hosted. - A Java Virtual Machine (JDK 8 or higher), required for running the build tool. - download Java from [Oracle Java 8][java8], [Oracle Java 11][java11], or [AdoptOpenJDK 8/11][adopt]. Refer to [JDK Compatibility][compat] for Scala/Java compatibility detail. @@ -27,13 +45,16 @@ and with the [VS Code][vs-code] text editor you can even create interactive work iterative workflow. ### Clone the Code -The code of Scala 3 is hosted on GitHub at [lampepfl/dotty]. -Download the code with the following commands (shown using a `bash` compatible shell): +The code of Scala 3 is hosted on GitHub at [lampepfl/dotty]. It's best practice +to [fork] the repo you want to work on, and then send in pull requests from your +fork. + +Once you've forked the repo you'll want to clone the code with the following +commands (shown using a `bash` compatible shell): ```bash -$ cd workspace # or, replace `workspace` with any other directory you prefer -$ git clone https://github.com/lampepfl/dotty.git +$ git clone https://github.com//dotty.git $ cd dotty ``` @@ -58,3 +79,7 @@ hello world [java11]: https://www.oracle.com/java/technologies/javase-jdk11-downloads.html [adopt]: https://adoptopenjdk.net/ [compat]: /overviews/jdk-compatibility/overview.html +[scala-cla]: https://www.lightbend.com/contribute/cla/scala +[dotty-issue]: https://github.com/lampepfl/dotty/issues +[dotty-discussion]: https://github.com/lampepfl/dotty/discussions +[fork]: https://docs.github.com/en/get-started/quickstart/fork-a-repo From 3176e1d12406ae94b065b0ee70b5bfe25f16cb60 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 7 Feb 2023 17:58:35 +0800 Subject: [PATCH 2469/3075] translate some "untranslated" titles in Chinese. (#2691) --- _zh-cn/overviews/scala3-book/taste-collections.md | 2 +- _zh-cn/overviews/scala3-book/taste-contextual-abstractions.md | 2 +- _zh-cn/overviews/scala3-book/taste-functions.md | 2 +- _zh-cn/overviews/scala3-book/taste-methods.md | 2 +- _zh-cn/overviews/scala3-book/taste-summary.md | 4 ++-- _zh-cn/overviews/scala3-book/taste-toplevel-definitions.md | 2 +- 6 files changed, 7 insertions(+), 7 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/taste-collections.md b/_zh-cn/overviews/scala3-book/taste-collections.md index afff4ece2e..966872f1a3 100644 --- a/_zh-cn/overviews/scala3-book/taste-collections.md +++ b/_zh-cn/overviews/scala3-book/taste-collections.md @@ -1,5 +1,5 @@ --- -title: Collections +title: 集合 type: section description: This page provides a high-level overview of the main features of the Scala 3 programming language. language: zh-cn diff --git a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md index 8c92b8e653..cfa5db2f45 100644 --- a/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md +++ b/_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md @@ -1,5 +1,5 @@ --- -title: Contextual Abstractions +title: 上下文抽象 type: section description: This section provides an introduction to Contextual Abstractions in Scala 3. language: zh-cn diff --git a/_zh-cn/overviews/scala3-book/taste-functions.md b/_zh-cn/overviews/scala3-book/taste-functions.md index ca6725f77d..71cea44649 100644 --- a/_zh-cn/overviews/scala3-book/taste-functions.md +++ b/_zh-cn/overviews/scala3-book/taste-functions.md @@ -1,5 +1,5 @@ --- -title: First-Class Functions +title: 头等函数 type: section description: This page provides an introduction to functions in Scala 3. language: zh-cn diff --git a/_zh-cn/overviews/scala3-book/taste-methods.md b/_zh-cn/overviews/scala3-book/taste-methods.md index 25b6017ba6..521c093a8e 100644 --- a/_zh-cn/overviews/scala3-book/taste-methods.md +++ b/_zh-cn/overviews/scala3-book/taste-methods.md @@ -1,5 +1,5 @@ --- -title: Methods +title: 方法 type: section description: This section provides an introduction to defining and using methods in Scala 3. language: zh-cn diff --git a/_zh-cn/overviews/scala3-book/taste-summary.md b/_zh-cn/overviews/scala3-book/taste-summary.md index 14c44c9bde..1fee593727 100644 --- a/_zh-cn/overviews/scala3-book/taste-summary.md +++ b/_zh-cn/overviews/scala3-book/taste-summary.md @@ -1,5 +1,5 @@ --- -title: Summary +title: 总结 type: section description: This page provides a summary of the previous 'Taste of Scala' sections. language: zh-cn @@ -26,7 +26,7 @@ permalink: "/zh-cn/scala3/book/:title.html" - 如何将对象用于多种目的 - [上下文抽象][contextual]的介绍 -我们还提到，如果您更喜欢使用基于浏览器的游乐场环境而不是 Scala REPL，您还可以使用[Scastie.scala-lang.org](https://scastie.scala-lang.org/?target=dotty) 或 [ScalaFiddle.io](https://scalafiddle.io)。 +我们还提到，如果您更喜欢使用基于浏览器的游乐场环境而不是 Scala REPL，您还可以使用[Scastie](https://scastie.scala-lang.org)。 Scala还有更多功能在这次旋风之旅中没有涵盖。 有关更多详细信息，请参阅本书的其余部分和[参考文档][reference]。 diff --git a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md index 11b577896f..e42dca2c47 100644 --- a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md +++ b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md @@ -1,5 +1,5 @@ --- -title: Toplevel Definitions +title: 顶层定义 type: section description: This page provides an introduction to top-level definitions in Scala 3 language: zh-cn From ac10af28b94d81b38e57a219c23a40eb9697a5cf Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Tue, 7 Feb 2023 20:53:50 +0800 Subject: [PATCH 2470/3075] add code tab in _zh-cn/overviews/scala3-book/taste-toplevel-definitions.md. --- .../scala3-book/taste-toplevel-definitions.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md index e42dca2c47..7deb81d9de 100644 --- a/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md +++ b/_zh-cn/overviews/scala3-book/taste-toplevel-definitions.md @@ -17,6 +17,9 @@ permalink: "/zh-cn/scala3/book/:title.html" 在 Scala 3 中，各种定义都可以在源代码文件的 “顶层” 编写。 例如，您可以创建一个名为 _MyCoolApp.scala_ 的文件，并将以下内容放入其中： +{% tabs toplevel_1 %} +{% tab 'Scala 3 only' for=toplevel_1 %} + ```scala import scala.collection.mutable.ArrayBuffer @@ -43,6 +46,9 @@ type Money = BigDecimal println("show me the code".capitalizeAllWords) ``` +{% endtab %} +{% endtabs %} + 如代码中展示的，无需将这些定义放在 `package`, `class` 或其他构造中。 ## 替换包对象 @@ -50,6 +56,9 @@ type Money = BigDecimal 如果你熟悉Scala 2，这种方法可以取代 _包对象_。 但是，虽然更易于使用，但它们的工作方式类似：当您将定义放在名为 _foo_ 的包中时，您可以在 _foo_ 包内的所有其他包内访问该定义，例如在此示例中的 _foo.bar_ 包中： +{% tabs toplevel_2 %} +{% tab 'Scala 3 only' for=toplevel_2 %} + ```scala package foo { def double(i: Int) = i * 2 @@ -63,6 +72,9 @@ package foo { } ``` +{% endtab %} +{% endtabs %} + 本示例中使用大括号来强调包嵌套。 这种方法的好处是，您可以将定义放在名为 _com.acme.myapp_ 的包下，然后可以在 _com.acme.myapp.model_、_com.acme.myapp.controller_ 等中引用这些定义。 From 6fa21a5ab6096a51897603632f9f7deeeb02a7a4 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Sun, 12 Feb 2023 21:56:21 +0800 Subject: [PATCH 2471/3075] add code tab in _zh-cn/overviews/scala3-book/domain-modeling-tools.md correct code tab in _overviews/scala3-book/domain-modeling-tools.md --- .../scala3-book/domain-modeling-tools.md | 16 +- .../scala3-book/domain-modeling-tools.md | 651 +++++++++++++++++- 2 files changed, 650 insertions(+), 17 deletions(-) diff --git a/_overviews/scala3-book/domain-modeling-tools.md b/_overviews/scala3-book/domain-modeling-tools.md index 762dd1bc2e..df1a7a6fc8 100644 --- a/_overviews/scala3-book/domain-modeling-tools.md +++ b/_overviews/scala3-book/domain-modeling-tools.md @@ -48,7 +48,7 @@ If you want them to be immutable---read only---create them as `val` fields inste Prior to Scala 3, you used the `new` keyword to create a new instance of a class: {% tabs class_2 %} -{% tab 'Scala 2 and 3' %} +{% tab 'Scala 2 Only' %} ```scala val p = new Person("Robert Allen Zimmerman", "Harmonica Player") @@ -1200,8 +1200,16 @@ Technically, the specific type of pattern matching shown in these examples is kn To show how that code works, create an instance of `Student` and `Teacher`: -{% tabs case-classes_9 %} -{% tab 'Scala 2 and 3' %} +{% tabs case-classes_9 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val s = new Student("Al", 1) +val t = new Teacher("Bob Donnan", "Mathematics") +``` + +{% endtab %} +{% tab 'Scala 3' %} ```scala val s = Student("Al", 1) @@ -1263,7 +1271,7 @@ Because it defines an `unapply` method, and because that method returns a tuple, {% tab 'Scala 2' %} ```scala -val p = Person("Astrid", 33) +val p = new Person("Astrid", 33) p match { case Person(n,a) => println(s"name: $n, age: $a") diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md index eb37e8e7f4..5d58d08752 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md @@ -18,9 +18,10 @@ Scala 3提供了许多不同的结构，因此我们可以对周围的世界进 - 类 - 对象 - 伴生对象 -- traits +- Traits - 抽象类 - 枚举 +Scala 3 独有 - 样例类 - 样例对象 @@ -28,15 +29,21 @@ Scala 3提供了许多不同的结构，因此我们可以对周围的世界进 ## 类 -与其他语言一样，Scala中的 _类_是用于创建对象实例的模板。 +与其他语言一样，Scala中的_类_是用于创建对象实例的模板。 下面是一些类的示例： +{% tabs class_1 %} +{% tab 'Scala 2 and 3' %} + ```scala class Person(var name: String, var vocation: String) class Book(var title: String, var author: String, var year: Int) class Movie(var name: String, var director: String, var year: Int) ``` +{% endtab %} +{% endtabs %} + 这些例子表明，Scala有一种非常轻量级的方式来声明类。 我们的示例类的所有参数都定义为 `var` 字段，这意味着它们是可变的：您可以读取它们，也可以修改它们。 @@ -44,37 +51,84 @@ class Movie(var name: String, var director: String, var year: Int) 在Scala 3之前，您使用 `new` 关键字来创建类的新实例： +{% tabs class_2 %} +{% tab 'Scala 2 Only' %} + ```scala val p = new Person("Robert Allen Zimmerman", "Harmonica Player") // --- ``` -然而，通过[创造者应用][creator]，在 Scala 3 里面不要求使用 `new`： +{% endtab %} +{% endtabs %} + +然而，通过[通用 apply 方法][creator]，在 Scala 3 里面不要求使用 `new`： +Scala 3 独有 + +{% tabs class_3 %} +{% tab 'Scala 3 Only' %} ```scala val p = Person("Robert Allen Zimmerman", "Harmonica Player") ``` -一旦你有了一个类的实例，比如`p`，你就可以访问它的字段，在此示例中，这些字段都是构造函数的参数： +{% endtab %} +{% endtabs %} + +一旦你有了一个类的实例，比如 `p`，你就可以访问它的字段，在此示例中，这些字段都是构造函数的参数： + +{% tabs class_4 %} +{% tab 'Scala 2 and 3' %} ```scala p.name // "Robert Allen Zimmerman" p.vocation // "Harmonica Player" ``` +{% endtab %} +{% endtabs %} + 如前所述，所有这些参数都是作为 `var` 字段创建的，因此您也可以更改它们： +{% tabs class_5 %} +{% tab 'Scala 2 and 3' %} + ```scala p.name = "Bob Dylan" p.vocation = "Musician" ``` +{% endtab %} +{% endtabs %} + ### 字段和方法 类还可以具有不属于构造函数的方法和其他字段。 它们在类的主体中定义。 主体初始化为默认构造函数的一部分： +{% tabs method class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class Person(var firstName: String, var lastName: String) { + + println("initialization begins") + val fullName = firstName + " " + lastName + + // a class method + def printFullName: Unit = + // access the `fullName` field, which is created above + println(fullName) + + printFullName + println("initialization ends") +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala class Person(var firstName: String, var lastName: String): @@ -90,8 +144,26 @@ class Person(var firstName: String, var lastName: String): println("initialization ends") ``` +{% endtab %} +{% endtabs %} + 以下 REPL 会话演示如何使用这个类创建新的 `Person` 实例： +{% tabs demo-person class=tabs-scala-version %} +{% tab 'Scala 2' %} +```` +scala> val john = new Person("John", "Doe") +initialization begins +John Doe +initialization ends +val john: Person = Person@55d8f6bb + +scala> john.printFullName +John Doe +```` +{% endtab %} +{% tab 'Scala 3' %} + ```` scala> val john = Person("John", "Doe") initialization begins @@ -103,19 +175,51 @@ scala> john.printFullName John Doe ```` +{% endtab %} +{% endtabs %} + 类还可以扩展 traits和抽象类，我们将在下面专门部分中介绍这些内容。 ### 默认参数值 快速浏览一下其他功能，类构造函数参数也可以具有默认值： +{% tabs default-values_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class Socket(val timeout: Int = 5_000, val linger: Int = 5_000) { + override def toString = s"timeout: $timeout, linger: $linger" +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala class Socket(val timeout: Int = 5_000, val linger: Int = 5_000): override def toString = s"timeout: $timeout, linger: $linger" ``` +{% endtab %} +{% endtabs %} + 此功能的一大优点是，它允许代码的使用者以各种不同的方式创建类，就好像该类有别的构造函数一样： +{% tabs default-values_2 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val s = new Socket() // timeout: 5000, linger: 5000 +val s = new Socket(2_500) // timeout: 2500, linger: 5000 +val s = new Socket(10_000, 10_000) // timeout: 10000, linger: 10000 +val s = new Socket(timeout = 10_000) // timeout: 10000, linger: 5000 +val s = new Socket(linger = 10_000) // timeout: 5000, linger: 10000 +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala val s = Socket() // timeout: 5000, linger: 5000 val s = Socket(2_500) // timeout: 2500, linger: 5000 @@ -124,9 +228,29 @@ val s = Socket(timeout = 10_000) // timeout: 10000, linger: 5000 val s = Socket(linger = 10_000) // timeout: 5000, linger: 10000 ``` +{% endtab %} +{% endtabs %} + 创建类的新实例时，还可以使用命名参数。 当许多参数具有相同的类型时，这特别有用，如以下比较所示： +{% tabs default-values_3 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +// option 1 +val s = new Socket(10_000, 10_000) + +// option 2 +val s = new Socket( + timeout = 10_000, + linger = 10_000 +) +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala // option 1 val s = Socket(10_000, 10_000) @@ -138,6 +262,9 @@ val s = Socket( ) ``` +{% endtab %} +{% endtabs %} + ### 辅助构造函数 可以为类定义多个构造函数，以便类的使用者用不同的方式来生成这个类。 @@ -150,6 +277,47 @@ val s = Socket( 在 OOP 风格中处理这种情况的一种方法是使用以下代码： +{% tabs structor_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import java.time._ + +// [1] the primary constructor +class Student( + var name: String, + var govtId: String +) { + private var _applicationDate: Option[LocalDate] = None + private var _studentId: Int = 0 + + // [2] a constructor for when the student has completed + // their application + def this( + name: String, + govtId: String, + applicationDate: LocalDate + ) = { + this(name, govtId) + _applicationDate = Some(applicationDate) + } + + // [3] a constructor for when the student is approved + // and now has a student id + def this( + name: String, + govtId: String, + studentId: Int + ) = { + this(name, govtId) + _studentId = studentId + } +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala import java.time.* @@ -182,6 +350,9 @@ class Student( _studentId = studentId ``` +{% endtab %} +{% endtabs %} + {% comment %} // for testing that code override def toString = s""" @@ -200,12 +371,28 @@ override def toString = s""" 这些构造函数可以这样调用： +{% tabs structor_2 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val s1 = new Student("Mary", "123") +val s2 = new Student("Mary", "123", LocalDate.now) +val s3 = new Student("Mary", "123", 456) +``` + +{% endtab %} + +{% tab 'Scala 3' %} + ```scala val s1 = Student("Mary", "123") val s2 = Student("Mary", "123", LocalDate.now) val s3 = Student("Mary", "123", 456) ``` +{% endtab %} +{% endtabs %} + 虽然可以使用此技术，但请记住，构造函数参数也可以具有默认值，这使得一个类看起来具有多个构造函数。 这在前面的 `Socket` 示例中所示。 @@ -218,6 +405,20 @@ Scala 中的对象允许在一个命名空间下对方法和字段进行分组 声明 `object` 类似于声明 `class` 。 下面是一个“字符串实用程序”对象的示例，其中包含一组用于处理字符串的方法： +{% tabs object_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +object StringUtils { + def truncate(s: String, length: Int): String = s.take(length) + def containsWhitespace(s: String): Boolean = s.matches(".*\\s.*") + def isNullOrEmpty(s: String): Boolean = s == null || s.trim.isEmpty +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala object StringUtils: def truncate(s: String, length: Int): String = s.take(length) @@ -225,13 +426,35 @@ object StringUtils: def isNullOrEmpty(s: String): Boolean = s == null || s.trim.isEmpty ``` +{% endtab %} +{% endtabs %} + 我们可以这样使用对象： +{% tabs object_2 %} +{% tab 'Scala 2 and 3' %} + ```scala StringUtils.truncate("Chuck Bartowski", 5) // "Chuck" ``` -在 Scala 中导入非常灵活，并允许我们导入对象的 _所有_ 成员： +{% endtab %} +{% endtabs %} + +在 Scala 中导入非常灵活，并允许我们导入对象的_所有_ 成员： + +{% tabs object_3 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import StringUtils._ +truncate("Chuck Bartowski", 5) // "Chuck" +containsWhitespace("Sarah Walker") // true +isNullOrEmpty("John Casey") // false +``` + +{% endtab %} +{% tab 'Scala 3' %} ```scala import StringUtils.* @@ -240,8 +463,14 @@ containsWhitespace("Sarah Walker") // true isNullOrEmpty("John Casey") // false ``` +{% endtab %} +{% endtabs %} + 或者只是 _部分_ 成员： +{% tabs object_4 %} +{% tab 'Scala 2 and 3' %} + ```scala import StringUtils.{truncate, containsWhitespace} truncate("Charles Carmichael", 7) // "Charles" @@ -249,8 +478,26 @@ containsWhitespace("Captain Awesome") // true isNullOrEmpty("Morgan Grimes") // Not found: isNullOrEmpty (error) ``` +{% endtab %} +{% endtabs %} + 对象还可以包含字段，这些字段也可以像静态成员一样访问： +{% tabs object_5 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +object MathConstants { + val PI = 3.14159 + val E = 2.71828 +} + +println(MathConstants.PI) // 3.14159 +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala object MathConstants: val PI = 3.14159 @@ -259,16 +506,39 @@ object MathConstants: println(MathConstants.PI) // 3.14159 ``` +{% endtab %} +{% endtabs %} ## 伴生对象 -与类同名且在与类在相同的文件中声明的 `object` 称为 _“伴生对象”_。 +与类同名且在与类在相同的文件中声明的 `object` 称为_“伴生对象”_。 同样，相应的类称为对象的伴生类。 伴生类或对象可以访问其伴生的私有成员。 伴生对象用于不特定于伴生类实例的方法和值。 例如，在下面的示例中，类 `Circle` 具有一个名为 `area` 的成员，该成员特定于每个实例，其伴生对象具有一个名为 `calculateArea` 的方法，该方法(a)不特定于实例，并且(b)可用于每个实例： +{% tabs companion class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import scala.math._ + +class Circle(val radius: Double) { + def area: Double = Circle.calculateArea(radius) +} + +object Circle { + private def calculateArea(radius: Double): Double = Pi * pow(radius, 2.0) +} + +val circle1 = new Circle(5.0) +circle1.area +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala import scala.math.* @@ -282,6 +552,9 @@ val circle1 = Circle(5.0) circle1.area ``` +{% endtab %} +{% endtabs %} + 在此示例中，每个实例可用的 `area` 方法使用伴生对象中定义的 `calculateArea` 方法。 再一次， `calculateArea` 类似于Java中的静态方法。 此外，由于 `calculateArea` 是私有的，因此其他代码无法访问它，但如图所示，它可以被 `Circle` 类的实例看到。 @@ -298,6 +571,45 @@ circle1.area 下面快速了解如何将 `apply` 方法当作工厂方法来创建新对象： +{% tabs companion-use class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class Person { + var name = "" + var age = 0 + override def toString = s"$name is $age years old" +} + +object Person { + // a one-arg factory method + def apply(name: String): Person = { + var p = new Person + p.name = name + p + } + + // a two-arg factory method + def apply(name: String, age: Int): Person = { + var p = new Person + p.name = name + p.age = age + p + } +} + +val joe = Person("Joe") +val fred = Person("Fred", 29) + +//val joe: Person = Joe is 0 years old +//val fred: Person = Fred is 29 years old +``` + +此处不涉及 `unapply` 方法，但在[语言规范](https://scala-lang.org/files/archive/spec/2.13/08-pattern-matching.html#extractor-patterns)中对此进行了介绍。 + +{% endtab %} +{% tab 'Scala 3' %} + ```scala class Person: var name = "" @@ -328,11 +640,14 @@ val fred = Person("Fred", 29) //val fred: Person = Fred is 29 years old ``` +{% endtab %} +{% endtabs %} + 此处不涉及 `unapply` 方法，但在 [参考文档][unapply] 中对此进行了介绍。 ## Traits -如果你熟悉Java，Scala trait 类似于Java 8+中的接口。特质可以包含： +如果你熟悉Java，Scala trait 类似于Java 8+中的接口。Traits 可以包含： - 抽象方法和成员 - 具体方法和成员 @@ -346,9 +661,26 @@ trait Employee: def lastName: String ``` +{% endtab %} +{% endtabs %} + 但是，traits 也可以包含具体成员。 例如，以下 traits定义了两个抽象成员---`numLegs` 和 `walk()`---并且还具有`stop()`方法的具体实现： +{% tabs traits_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait Employee { + def id: Int + def firstName: String + def lastName: String +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala trait HasLegs: def numLegs: Int @@ -356,8 +688,25 @@ trait HasLegs: def stop() = println("Stopped walking") ``` +{% endtab %} +{% endtabs %} + 下面是另一个具有抽象成员和两个具体实现的 trait： +{% tabs traits_3 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait HasTail { + def tailColor: String + def wagTail() = println("Tail is wagging") + def stopTail() = println("Tail is stopped") +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala trait HasTail: def tailColor: String @@ -365,11 +714,29 @@ trait HasTail: def stopTail() = println("Tail is stopped") ``` -请注意，每个 trait 只处理非常特定的属性和行为： `HasLegs` 只处理腿，而 `HasTail` 只处理与尾部相关的功能。 +{% endtab %} +{% endtabs %} + +请注意，每个 trait 只处理非常特定的属性和行为：`HasLegs` 只处理腿，而 `HasTail` 只处理与尾部相关的功能。 Traits可以让你构建这样的小模块。 在代码的后面部分，类可以混合多个 traits 来构建更大的组件： +{% tabs traits_4 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class IrishSetter(name: String) extends HasLegs with HasTail { + val numLegs = 4 + val tailColor = "Red" + def walk() = println("I’m walking") + override def toString = s"$name is a Dog" +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala class IrishSetter(name: String) extends HasLegs, HasTail: val numLegs = 4 @@ -378,13 +745,29 @@ class IrishSetter(name: String) extends HasLegs, HasTail: override def toString = s"$name is a Dog" ``` +{% endtab %} +{% endtabs %} + 请注意，`IrishSetter` 类实现了在 `HasLegs` 和 `HasTail` 中定义的抽象成员。 现在，您可以创建新的 `IrishSetter` 实例： +{% tabs traits_5 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val d = new IrishSetter("Big Red") // "Big Red is a Dog" +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala val d = IrishSetter（“Big Red”） // “Big Red is a Dog” ``` +{% endtab %} +{% endtabs %} + 这只是你对 trait 可以完成的事情的一种体验。 有关更多详细信息，请参阅这些建模课程的其余部分。 @@ -407,7 +790,27 @@ LATER: If anyone wants to update this section, our comments about abstract class ### 使用构造函数参数的基类 -在 Scala 3 之前，当基类需要使用构造函数参数时，你可以将其声明为`abstract class`： +在 Scala 3 之前，当基类需要使用构造函数参数时，你可以将其声明为 `abstract class`： + +{% tabs abstract_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +abstract class Pet(name: String) { + def greeting: String + def age: Int + override def toString = s"My name is $name, I say $greeting, and I’m $age" +} + +class Dog(name: String, var age: Int) extends Pet(name) { + val greeting = "Woof" +} + +val d = new Dog("Fido", 1) +``` + +{% endtab %} +{% tab 'Scala 3' %} ```scala abstract class Pet(name: String): @@ -421,8 +824,16 @@ class Dog(name: String, age: Int) extends Pet(name): val d = Dog("Fido", 1) ``` +{% endtab %} +{% endtabs %} + +

    Trait 参数 Scala 3 独有

    + 但是，在 Scala 3 中，trait 现在可以具有[参数][trait-params]，因此您现在可以在相同情况下使用 trait： +{% tabs abstract_2 %} +{% tab 'Scala 3 Only' %} + ```scala trait Pet(name: String): def greeting: String @@ -435,16 +846,23 @@ class Dog(name: String, var age: Int) extends Pet(name): val d = Dog("Fido", 1) ``` +{% endtab %} +{% endtabs %} + trait 的组成更加灵活---您可以混合多个 trait，但只能扩展一个类---并且大多数时候应该优先于类和抽象类。 -经验法则是，每当要创建特定类型的实例时，就使用类;如果要分解和重用行为时，应使用trait。 +经验法则是，每当要创建特定类型的实例时，就使用类；如果要分解和重用行为时，应使用trait。 -## 枚举 +

    枚举Scala 3 独有

    枚举可用于定义由一组有限的命名值组成的类型（在[FP建模][fp-modeling]一节中，我们将看到枚举比这更灵活）。 基本枚举用于定义常量集，如一年中的月份、一周中的天数、北/南/东/西方向等。 例如，这些枚举定义了与披萨饼相关的属性集： +{% tabs enum_1 %} +{% tab 'Scala 3 Only' %} + + ```scala enum CrustSize: case Small, Medium, Large @@ -456,15 +874,27 @@ enum Topping: case Cheese, Pepperoni, BlackOlives, GreenOlives, Onions ``` +{% endtab %} +{% endtabs %} + 若要在其他代码中使用它们，请先导入它们，然后使用它们： +{% tabs enum_2 %} +{% tab 'Scala 3 Only' %} + ```scala import CrustSize.* val currentCrustSize = Small ``` +{% endtab %} +{% endtabs %} + 枚举值可以使用等于 （`==`） 进行比较，也可以用匹配的方式： +{% tabs enum_3 %} +{% tab 'Scala 3 Only' %} + ```scala // if/then if (currentCrustSize == Large) @@ -477,10 +907,16 @@ currentCrustSize match case Large => println("large") ``` -### 其他枚举特性 +{% endtab %} +{% endtabs %} + +### 更多枚举特性 枚举也可以参数化： +{% tabs enum_4 %} +{% tab 'Scala 3 Only' %} + ```scala enum Color(val rgb: Int): case Red extends Color(0xFF0000) @@ -488,8 +924,14 @@ enum Color(val rgb: Int): case Blue extends Color(0x0000FF) ``` +{% endtab %} +{% endtabs %} + 它们还可以具有成员（如字段和方法）： +{% tabs enum_5 %} +{% tab 'Scala 3 Only' %} + ```scala enum Planet(mass: Double, radius: Double): private final val G = 6.67300E-11 @@ -502,14 +944,23 @@ enum Planet(mass: Double, radius: Double): // more planets here ... ``` +{% endtab %} +{% endtabs %} + ### 与 Java 枚举的兼容性 如果要将 Scala 定义的枚举用作 Java 枚举，可以通过扩展类 `java.lang.Enum`（默认情况下导入）来实现，如下所示： +{% tabs enum_6 %} +{% tab 'Scala 3 Only' %} + ```scala enum Color extends Enum[Color] { case Red, Green, Blue } ``` +{% endtab %} +{% endtabs %} + 类型参数来自 Java `enum` 定义，并且应与枚举的类型相同。 在扩展时，无需向`java.lang.Enum`提供构造函数参数（如Java API文档中所定义的那样）---编译器会自动生成它们。 @@ -527,23 +978,41 @@ val res0： Int = -1 样例类用于对不可变数据结构进行建模。 举个例子： +{% tabs case-classes_1 %} +{% tab 'Scala 2 and 3' %} + ```scala case class Person(name: String, relation: String) ``` +{% endtab %} +{% endtabs %} + 由于我们将 `Person` 声明为样例类，因此默认情况下，字段 `name` 和 `relation` 是公共的和不可变的。 我们可以创建 样例类的实例，如下所示： +{% tabs case-classes_2 %} +{% tab 'Scala 2 and 3' %} + ```scala val christina = Person("Christina", "niece") ``` +{% endtab %} +{% endtabs %} + 请注意，这些字段不能发生更改： +{% tabs case-classes_3 %} +{% tab 'Scala 2 and 3' %} + ```scala christina.name = "Fred" // error: reassignment to val ``` +{% endtab %} +{% endtabs %} + 由于 样例类的字段被假定为不可变的，因此 Scala 编译器可以为您生成许多有用的方法： * 生成一个 `unapply` 方法，该方法允许您对样例类执行模式匹配（即，`case Person（n， r） => ...`）。 @@ -553,6 +1022,34 @@ christina.name = "Fred" // error: reassignment to val 以下示例演示了这些附加功能： +{% tabs case-classes_4 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +// Case classes can be used as patterns +christina match { + case Person(n, r) => println("name is " + n) +} + +// `equals` and `hashCode` methods generated for you +val hannah = Person("Hannah", "niece") +christina == hannah // false + +// `toString` method +println(christina) // Person(Christina,niece) + +// built-in `copy` method +case class BaseballTeam(name: String, lastWorldSeriesWin: Int) +val cubs1908 = BaseballTeam("Chicago Cubs", 1908) +val cubs2016 = cubs1908.copy(lastWorldSeriesWin = 2016) +// result: +// cubs2016: BaseballTeam = BaseballTeam(Chicago Cubs,2016) + +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala // Case classes can be used as patterns christina match @@ -573,6 +1070,9 @@ val cubs2016 = cubs1908.copy(lastWorldSeriesWin = 2016) // cubs2016: BaseballTeam = BaseballTeam(Chicago Cubs,2016) ``` +{% endtab %} +{% endtabs %} + ### 支持函数式编程 如前所述，样例类支持函数式编程 （FP）： @@ -593,20 +1093,56 @@ NOTE: We can use this following text, if desired. If it’s used, it needs to be 为了证明这一点，假设你有这个 trait： +{% tabs case-classes_5 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait Person { + def name: String +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala trait Person: def name: String ``` +{% endtab %} +{% endtabs %} + 然后，创建以下样例类以扩展该 trait： +{% tabs case-classes_6 %} +{% tab 'Scala 2 and 3' %} + ```scala case class Student(name: String, year: Int) extends Person case class Teacher(name: String, specialty: String) extends Person ``` +{% endtab %} +{% endtabs %} + 由于它们被定义为样例类---并且它们具有内置的 `unapply` 方法---因此您可以编写如下匹配表达式： +{% tabs case-classes_7 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +def getPrintableString(p: Person): String = p match { + case Student(name, year) => + s"$name is a student in Year $year." + case Teacher(name, whatTheyTeach) => + s"$name teaches $whatTheyTeach." +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala def getPrintableString(p: Person): String = p match case Student(name, year) => @@ -615,13 +1151,22 @@ def getPrintableString(p: Person): String = p match s"$name teaches $whatTheyTeach." ``` +{% endtab %} +{% endtabs %} + 请注意 `case` 语句中的以下两种模式： +{% tabs case-classes_8 %} +{% tab 'Scala 2 and 3' %} + ```scala case Student(name, year) => case Teacher(name, whatTheyTeach) => ``` +{% endtab %} +{% endtabs %} + 这些模式之所以有效，是因为 `Student` 和 `Teacher` 被定义为具有 `unapply` 方法的样例类，其类型签名符合特定标准。 从技术上讲，这些示例中显示的特定类型的模式匹配称为_结构模式匹配_。 @@ -630,13 +1175,30 @@ case Teacher(name, whatTheyTeach) => 要显示该代码的工作原理，请创建一个 `Student` 和 `Teacher` 的实例： +{% tabs case-classes_9 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val s = new Student("Al", 1) +val t = new Teacher("Bob Donnan", "Mathematics") +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala val s = Student("Al", 1) val t = Teacher("Bob Donnan", "Mathematics") ``` +{% endtab %} +{% endtabs %} + 接下来，这是当您使用这两个实例来调用 `getPrintableString` 时，REPL 中的输出如下所示： +{% tabs case-classes_10 %} +{% tab 'Scala 2 and 3' %} + ```scala scala> getPrintableString(s) res0: String = Al is a student in Year 1. @@ -645,6 +1207,9 @@ scala> getPrintableString(t) res1: String = Bob Donnan teaches Mathematics. ``` +{% endtab %} +{% endtabs %} + >所有这些关于 `unapply` 方法和提取器的内容对于这样的入门书来说都有些先进，但是因为样例类是一个重要的FP主题，所以似乎最好涵盖它们，而不是跳过它们。 #### 将模式匹配添加到任何具有 unapply 的类型 @@ -652,14 +1217,47 @@ res1: String = Bob Donnan teaches Mathematics. Scala 的一个很好的特性是，你可以通过编写自己的 `unapply` 方法来向任何类型添加模式匹配。 例如，此类在其伴生对象中定义了一个 `unapply` 方法： +{% tabs case-classes_11 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class Person(var name: String, var age: Int) +object Person { + def unapply(p: Person): Tuple2[String, Int] = (p.name, p.age) +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala class Person(var name: String, var age: Int) object Person: def unapply(p: Person): Tuple2[String, Int] = (p.name, p.age) ``` +{% endtab %} +{% endtabs %} + 因为它定义了一个 `unapply` 方法，并且因为该方法返回一个元组，所以您现在可以将 `Person` 与 `match` 表达式一起使用： +{% tabs case-classes_12 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val p = new Person("Astrid", 33) + +p match { + case Person(n,a) => println(s"name: $n, age: $a") + case null => println("No match") +} + +// that code prints: "name: Astrid, age: 33" +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala val p = Person("Astrid", 33) @@ -669,8 +1267,11 @@ p match // that code prints: "name: Astrid, age: 33" ``` -{% endcomment %} +{% endtab %} +{% endtabs %} + +{% endcomment %} ## 样例对象 @@ -680,6 +1281,9 @@ p match 当您需要传递不可变消息时，样例对象非常有用。 例如，如果您正在处理音乐播放器项目，您将创建一组命令或消息，如下所示： +{% tabs case-objects_1 %} +{% tab 'Scala 2 and 3' %} + ```scala sealed trait Message case class PlaySong(name: String) extends Message @@ -688,8 +1292,26 @@ case class DecreaseVolume(amount: Int) extends Message case object StopPlaying extends Message ``` +{% endtab %} +{% endtabs %} + 然后在代码的其他部分，你可以编写这样的方法，这些方法使用模式匹配来处理传入的消息（假设方法 `playSong` ， `changeVolume` 和 `stopPlayingSong` 在其他地方定义）： +{% tabs case-objects_2 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +def handleMessages(message: Message): Unit = message match { + case PlaySong(name) => playSong(name) + case IncreaseVolume(amount) => changeVolume(amount) + case DecreaseVolume(amount) => changeVolume(-amount) + case StopPlaying => stopPlayingSong() +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala def handleMessages(message: Message): Unit = message match case PlaySong(name) => playSong(name) @@ -698,6 +1320,9 @@ def handleMessages(message: Message): Unit = message match case StopPlaying => stopPlayingSong() ``` +{% endtab %} +{% endtabs %} + [ref-enums]: {{ site.scala3ref }}/enums/enums.html [adts]: {% link _zh-cn/overviews/scala3-book/types-adts-gadts.md %} [fp-modeling]: {% link _zh-cn/overviews/scala3-book/domain-modeling-fp.md %} From ae41b8adc3bb3c5b11076425b5d22726b429f3a9 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Mon, 13 Feb 2023 20:20:43 +0800 Subject: [PATCH 2472/3075] correct one missed code tab. --- .../overviews/scala3-book/domain-modeling-tools.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md index 5d58d08752..b14c9caadb 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md @@ -654,6 +654,20 @@ val fred = Person("Fred", 29) 在基本用法中，trait 可以用作接口，仅定义将由其他类实现的抽象成员： +{% tabs traits_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait Employee { + def id: Int + def firstName: String + def lastName: String +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala trait Employee: def id: Int From b6861fc2c948d73199a19f22a47e10059b395df4 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 14 Feb 2023 10:20:40 +0100 Subject: [PATCH 2473/3075] Fix setup instructions --- _data/setup-scala.yml | 6 ++++-- _overviews/getting-started/index.md | 13 ++++++++++--- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/_data/setup-scala.yml b/_data/setup-scala.yml index d1bb19a78d..4cce17dd0d 100644 --- a/_data/setup-scala.yml +++ b/_data/setup-scala.yml @@ -1,4 +1,6 @@ -linux: curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup -macOS-default: curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup +linux-x86-64: curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup +linux-arm64: curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup +macOS-x86-64: curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup +macOS-arm64: curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup macOS-brew: brew install coursier/formulas/coursier && cs setup windows-link: https://github.com/coursier/launchers/raw/master/cs-x86_64-pc-win32.zip diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 5510d479cd..4c2a4ac863 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -52,15 +52,22 @@ Install it on your system with the following instructions. Run the following command in your terminal, following the on-screen instructions: {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} {% altDetails cs-setup-macos-nobrew "Alternatively, if you don't use Homebrew:" %} - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} + On the Apple Silicon (M1, M2, …) architecture: + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-arm64 %} + Otherwise, on the x86-64 architecture: + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-x86-64 %} {% endaltDetails %} {% endtab %} {% tab Linux for=install-cs-setup-tabs %} - Run the following command in your terminal, following the on-screen instructions: - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} + Run the following command in your terminal, following the on-screen instructions. + + On the x86-64 architecture: + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux-x86-64 %} + Otherwise, on the ARM64 architecture: + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux-arm64 %} {% endtab %} From e91be159f70549dbbbab86e09afabbb2979f9544 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 14 Feb 2023 10:26:03 +0100 Subject: [PATCH 2474/3075] Update translated pages --- _fr/getting-started/index.md | 4 ++-- _ja/getting-started/index.md | 4 ++-- _ru/getting-started/index.md | 4 ++-- _uk/getting-started/index.md | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/_fr/getting-started/index.md b/_fr/getting-started/index.md index 4b73224c27..a94b708cb0 100644 --- a/_fr/getting-started/index.md +++ b/_fr/getting-started/index.md @@ -34,14 +34,14 @@ Installez-le sur votre système avec les instructions suivantes. {% tab macOS for=install-cs-setup-tabs %} {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} {% altDetails cs-setup-macos-nobrew "Alternativement, si vous n'utilisez pas Homebrew:" %} - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-x86-64 %} {% endaltDetails %} {% endtab %} {% tab Linux for=install-cs-setup-tabs %} - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux-x86-64 %} {% endtab %} diff --git a/_ja/getting-started/index.md b/_ja/getting-started/index.md index 40f6b384bd..a72dab82b9 100644 --- a/_ja/getting-started/index.md +++ b/_ja/getting-started/index.md @@ -34,14 +34,14 @@ Scala のインストーラーは[Coursier](https://get-coursier.io/docs/cli-ove {% tab macOS for=install-cs-setup-tabs %} {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} {% altDetails cs-setup-macos-nobrew "または、Homebrewを使用しない場合は" %} - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-x86-64 %} {% endaltDetails %} {% endtab %} {% tab Linux for=install-cs-setup-tabs %} - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux-x86-64 %} {% endtab %} diff --git a/_ru/getting-started/index.md b/_ru/getting-started/index.md index 4d49594778..e9d8e0beeb 100644 --- a/_ru/getting-started/index.md +++ b/_ru/getting-started/index.md @@ -53,7 +53,7 @@ newcomer_resources: Запустите в терминале следующую команду, следуя инструкциям на экране: {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} {% altDetails cs-setup-macos-nobrew "В качестве альтернативы, если вы не используете Homebrew:" %} - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-x86-64 %} {% endaltDetails %} {% endtab %} @@ -61,7 +61,7 @@ newcomer_resources: {% tab Linux for=install-cs-setup-tabs %} Запустите в терминале следующую команду, следуя инструкциям на экране: - {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} + {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux-x86-64 %} {% endtab %} diff --git a/_uk/getting-started/index.md b/_uk/getting-started/index.md index 5fd096359c..e8275ada94 100644 --- a/_uk/getting-started/index.md +++ b/_uk/getting-started/index.md @@ -38,7 +38,7 @@ _Scastie_ це онлайн “пісочниця”, де ви можете е Виконайте наступну команду в терміналі, виконуючи всі спливаючі інструкції: {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} {% altDetails cs-setup-macos-nobrew "Якщо ви не використовуєте Homebrew:" %} -{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-default %} +{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-x86-64 %} {% endaltDetails %} {% endtab %} @@ -46,7 +46,7 @@ _Scastie_ це онлайн “пісочниця”, де ви можете е {% tab Linux for=install-cs-setup-tabs %} Виконайте наступну команду в терміналі, виконуючи всі спливаючі інструкції: -{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux %} +{% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.linux-x86-64 %} {% endtab %} From 31da37beccfb6f0c8f1679bc07a4468e4bfdf073 Mon Sep 17 00:00:00 2001 From: Daniel Tinsley Date: Tue, 14 Feb 2023 19:32:34 -0600 Subject: [PATCH 2475/3075] Fix typo I fixed a misspelling of the word "its." --- _overviews/scala3-book/taste-control-structures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/taste-control-structures.md b/_overviews/scala3-book/taste-control-structures.md index a8cf7f8f49..3427c29399 100644 --- a/_overviews/scala3-book/taste-control-structures.md +++ b/_overviews/scala3-book/taste-control-structures.md @@ -480,7 +480,7 @@ finally ## `while` loops Scala also has a `while` loop construct. -It’s one-line syntax looks like this: +Its one-line syntax looks like this: {% tabs while_1 class=tabs-scala-version %} {% tab 'Scala 2' for=while_1 %} From 964f1a3d28351591893a25fb8291ea4b7809820a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rapha=C3=ABl=20Fromentin?= <42907886+Iltotore@users.noreply.github.com> Date: Wed, 15 Feb 2023 12:18:36 +0100 Subject: [PATCH 2476/3075] fix: Not compiling example in Quotes page (#2700) Fix the `mirrorFields[T]` example at line 351 --- _overviews/scala3-macros/tutorial/quotes.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/_overviews/scala3-macros/tutorial/quotes.md b/_overviews/scala3-macros/tutorial/quotes.md index 7609c9ea36..b57f60c23f 100644 --- a/_overviews/scala3-macros/tutorial/quotes.md +++ b/_overviews/scala3-macros/tutorial/quotes.md @@ -349,17 +349,23 @@ Note that the previous case could also be written as `case '{ ($ls: List[u]).map Types represented with `Type[T]` can be matched on using the patten `case '[...] =>`. ```scala -def mirrorFields[T: Type](using Quotes): List[String] = - Type.of[T] match +inline def mirrorFields[T]: List[String] = ${mirrorFieldsImpl[T]} + +def mirrorFieldsImpl[T: Type](using Quotes): Expr[List[String]] = + + def rec[A : Type]: List[String] = Type.of[A] match case '[field *: fields] => - Type.show[field] :: mirrorFields[fields] + Type.show[field] :: rec[fields] case '[EmptyTuple] => Nil case _ => - compiletime.error("Expected known tuple but got: " + Type.show[T]) + quotes.reflect.report.errorAndAbort("Expected known tuple but got: " + Type.show[A]) + Expr(rec) +``` +```scala mirrorFields[EmptyTuple] // Nil -mirrorFields[(Int, String, Int)] // List("Int", "String", "Int") +mirrorFields[(Int, String, Int)] // List("scala.Int", "java.lang.String", "scala.Int") mirrorFields[Tuple] // error: Expected known tuple but got: Tuple ``` From 8846ed45a4ca60d663521cbbe4c5e09c7fecada9 Mon Sep 17 00:00:00 2001 From: Ben Luo Date: Wed, 15 Feb 2023 20:23:57 +0800 Subject: [PATCH 2477/3075] add code tabs in _zh-cn/overviews/scala3-book/domain-modeling-oop.md. --- .../scala3-book/domain-modeling-oop.md | 281 +++++++++++++++++- 1 file changed, 273 insertions(+), 8 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md index a04c1fba41..48ef014953 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md @@ -32,19 +32,50 @@ Scala 为面向对象设计提供了所有必要的工具： 可能与支持 OOP 的其他语言（例如 Java）不同，Scala 中分解的主要工具不是类，而是trait。 它们可以用来描述抽象接口，例如： +{% tabs traits_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait Showable { + def show: String +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala trait Showable: def show: String ``` +{% endtab %} +{% endtabs %} + 并且还可以包含具体的实现： +{% tabs traits_2 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait Showable { + def show: String + def showHtml = "

    " + show + "

    " +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala trait Showable: def show: String def showHtml = "

    " + show + "

    " ``` +{% endtab %} +{% endtabs %} + 你可以看到我们用抽象方法 `show` 来定义方法 `showHtml`。 [Odersky and Zenger][scalable] 展示了 _面向服务的组件模型_ 和视图： @@ -54,12 +85,28 @@ trait Showable: 我们已经可以在 `Showable` 的示例中看到这一点：定义一个扩展 `Showable` 的类 `Document`，我们仍然必须定义 `show`，但我们提供了 `showHtml`： +{% tabs traits_3 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class Document(text: String) extends Showable { + def show = text +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala class Document(text: String) extends Showable: def show = text ``` +{% endtab %} +{% endtabs %} + #### 抽象成员 + 抽象方法并不是trait中唯一可以抽象的东西。 一个trait可以包含： @@ -67,6 +114,7 @@ class Document(text: String) extends Showable: - 抽象值定义（`val x: T`） - 抽象类型成员（`type T`），可能有界限（`type T <: S`） - 抽象given（`given t: T`） +Scala 3 only 上述每个特性都可用于指定对 trait 实现者的某种形式的要求。 @@ -76,6 +124,23 @@ traits 不仅可以包含抽象和具体的定义，Scala 还提供了一种组 让我们假设以下两个（可能独立定义的）traits： +{% tabs traits_4 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait GreetingService { + def translate(text: String): String + def sayHello = translate("Hello") +} + +trait TranslationService { + def translate(text: String): String = "..." +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala trait GreetingService: def translate(text: String): String @@ -85,12 +150,28 @@ trait TranslationService: def translate(text: String): String = "..." ``` +{% endtab %} +{% endtabs %} + 要组合这两个服务，我们可以简单地创建一个扩展它们的新trait： +{% tabs traits_5 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait ComposedService extends GreetingService with TranslationService +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala trait ComposedService extends GreetingService, TranslationService ``` +{% endtab %} +{% endtabs %} + 一个 trait 中的抽象成员（例如 `GreetingService` 中的 `translate`）会自动与另一个 trait 中的具体成员匹配。 这不仅适用于本例中的方法，而且适用于上述所有其他抽象成员（即类型、值定义等）。 @@ -104,10 +185,20 @@ Traits 非常适合模块化组件和描述接口（必需和提供）。 NOTE: I think “leaves” may technically be the correct word to use, but I prefer “leafs.” {% endcomment %} -|Traits | `T1`, `T2`, `T3` -|组合 traits | `S extends T1, T2`, `S extends T2, T3` -|类 | `C extends S, T3` -|实例 | `C()` +{% tabs table-traits-cls-summary class=tabs-scala-version %} +{% tab 'Scala 2' %} +| Traits | `T1`, `T2`, `T3` +| 组合traits | `S1 extends T1 with T2`, `S2 extends T2 with T3` +| 类 | `C extends S1 with T3` +| 实例 | `new C()` +{% endtab %} +{% tab 'Scala 3' %} +| Traits | `T1`, `T2`, `T3` +| 组合 traits | `S extends T1, T2`, `S extends T2, T3` +| 类 | `C extends S, T3` +| 实例 | `C()` +{% endtab %} +{% endtabs %} 在 Scala 3 中更是如此，trait 现在也可以接受参数，进一步消除了对类的需求。 @@ -115,21 +206,52 @@ NOTE: I think “leaves” may technically be the correct word to use, but I pre 像trait一样，类可以扩展多个trait（但只有一个超类）： +{% tabs class_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class MyService(name: String) extends ComposedService with Showable { + def show = s"$name says $sayHello" +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala class MyService(name: String) extends ComposedService, Showable: def show = s"$name says $sayHello" ``` +{% endtab %} +{% endtabs %} + #### 子类型化 我们可以创建一个 `MyService` 的实例，如下所示： +{% tabs class_2 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val s1: MyService = new MyService("Service 1") +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala val s1: MyService = MyService("Service 1") ``` +{% endtab %} +{% endtabs %} + 通过子类型化的方式，我们的实例 `s1` 可以在任何扩展了trait的地方使用： +{% tabs class_3 %} +{% tab 'Scala 2 and 3' %} + ```scala val s2: GreetingService = s1 val s3: TranslationService = s1 @@ -137,23 +259,38 @@ val s4: Showable = s1 // ... and so on ... ``` +{% endtab %} +{% endtabs %} + #### 扩展规划 如前所述，可以扩展另一个类： +{% tabs class_4 %} +{% tab 'Scala 2 and 3' %} + ```scala class Person(name: String) class SoftwareDeveloper(name: String, favoriteLang: String) extends Person(name) ``` +{% endtab %} +{% endtabs %} + 然而，由于 _traits_ 被设计为主要的分解手段，在一个文件中定义的类_不能_在另一个文件中扩展。 为了允许这样做，需要将基类标记为 `open`： +{% tabs class_5 %} +{% tab 'Scala 3 Only' %} + ```scala open class Person(name: String) ``` +{% endtab %} +{% endtabs %} + 用 [`open`][open] 标记类是 Scala 3 的一个新特性。必须将类显式标记为开放可以避免面向对象设计中的许多常见缺陷。 特别是，它要求库设计者明确计划扩展，例如用额外的扩展契约来记录那些被标记为开放的类。 @@ -167,6 +304,22 @@ I only mention this because I think that book and phrase is pretty well known in 与其他支持 OOP 的语言一样，Scala 中的trait和类可以定义可变字段： +{% tabs instance_6 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class Counter { + // can only be observed by the method `count` + private var currentCount = 0 + + def tick(): Unit = currentCount += 1 + def count: Int = currentCount +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala class Counter: // can only be observed by the method `count` @@ -176,8 +329,25 @@ class Counter: def count: Int = currentCount ``` +{% endtab %} +{% endtabs %} + `Counter` 类的每个实例都有自己的私有状态，只能通过方法 `count` 观察到，如下面的交互所示： +{% tabs instance_7 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val c1 = new Counter() +c1.count // 0 +c1.tick() +c1.tick() +c1.count // 2 +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala val c1 = Counter() c1.count // 0 @@ -186,6 +356,9 @@ c1.tick() c1.count // 2 ``` +{% endtab %} +{% endtabs %} + #### 访问修饰符 默认情况下，Scala 中的所有成员定义都是公开可见的。 @@ -203,25 +376,55 @@ c1.count // 2 我们的目标是定义一个_种类丰富_的软件组件，而对组件的细化，可以放到以后的实现中 具体来说，以下代码将组件 `SubjectObserver` 定义为具有两个抽象类型成员的trait， `S` （用于主题）和 `O` （用于观察者）： +{% tabs example_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + ```scala -trait SubjectObserver: +trait SubjectObserver { type S <: Subject type O <: Observer trait Subject { self: S => private var observers: List[O] = List() - def subscribe(obs: O): Unit = + def subscribe(obs: O): Unit = { observers = obs :: observers - def publish() = - for obs <- observers do obs.notify(this) + } + def publish() = { + for ( obs <- observers ) obs.notify(this) + } } trait Observer { def notify(sub: S): Unit } +} ``` +{% endtab %} +{% tab 'Scala 3' %} + +```scala +trait SubjectObserver: + + type S <: Subject + type O <: Observer + + trait Subject: + self: S => + private var observers: List[O] = List() + def subscribe(obs: O): Unit = + observers = obs :: observers + def publish() = + for obs <- observers do obs.notify(this) + + trait Observer: + def notify(sub: S): Unit +``` + +{% endtab %} +{% endtabs %} + 有几件事需要解释。 #### 抽象类型成员 @@ -253,6 +456,33 @@ trait SubjectObserver: 我们现在可以实现上述组件并将抽象类型成员定义为具体类型： +{% tabs example_2 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +object SensorReader extends SubjectObserver { + type S = Sensor + type O = Display + + class Sensor(val label: String) extends Subject { + private var currentValue = 0.0 + def value = currentValue + def changeValue(v: Double) = { + currentValue = v + publish() + } + } + + class Display extends Observer { + def notify(sub: Sensor) = + println(s"${sub.label} has value ${sub.value}") + } +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala object SensorReader extends SubjectObserver: type S = Sensor @@ -270,6 +500,9 @@ object SensorReader extends SubjectObserver: println(s"${sub.label} has value ${sub.value}") ``` +{% endtab %} +{% endtabs %} + 具体来说，我们定义了一个扩展 `SubjectObserver` 的_单例_对象 `SensorReader`。 在 `SensorReader` 的实现中，我们说 `S` 类型现在被定义为 `Sensor` 类型，`O` 类型被定义为等于 `Display` 类型。 `Sensor` 和 `Display` 都被定义为 `SensorReader` 中的嵌套类，相应地实现了 `Subject` 和 `Observer` 特性。 @@ -290,6 +523,35 @@ NOTE: You might say “the abstract method `notify`” in that last sentence, bu 最后，下面的代码说明了如何使用我们的 `SensorReader` 组件： +{% tabs example_3 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import SensorReader._ + +// setting up a network +val s1 = new Sensor("sensor1") +val s2 = new Sensor("sensor2") +val d1 = new Display() +val d2 = new Display() +s1.subscribe(d1) +s1.subscribe(d2) +s2.subscribe(d1) + +// propagating updates through the network +s1.changeValue(2) +s2.changeValue(3) + +// prints: +// sensor1 has value 2.0 +// sensor1 has value 2.0 +// sensor2 has value 3.0 + +``` + +{% endtab %} +{% tab 'Scala 3' %} + ```scala import SensorReader.* @@ -312,6 +574,9 @@ s2.changeValue(3) // sensor2 has value 3.0 ``` +{% endtab %} +{% endtabs %} + 借助我们掌握的所有面向对象的编程工具，在下一节中，我们将演示如何以函数式风格设计程序。 {% comment %} From 23dc8ba9e34af3451976496ec39057a780856f76 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Wed, 15 Feb 2023 16:44:38 +0100 Subject: [PATCH 2478/3075] Adjust suggestion for Apple Silicon users --- _overviews/getting-started/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 4c2a4ac863..8c33b915dd 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -51,7 +51,7 @@ Install it on your system with the following instructions. {% tab macOS for=install-cs-setup-tabs %} Run the following command in your terminal, following the on-screen instructions: {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} -{% altDetails cs-setup-macos-nobrew "Alternatively, if you don't use Homebrew:" %} +{% altDetails cs-setup-macos-nobrew "Alternatively for Apple Silicon, or if you don't use Homebrew:" %} On the Apple Silicon (M1, M2, …) architecture: {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-arm64 %} Otherwise, on the x86-64 architecture: From 524c7b0c63ab1441b0b29c25e0433f2b76a167a8 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Fri, 17 Feb 2023 15:57:04 +0100 Subject: [PATCH 2479/3075] Add result of SIP meeting --- _sips/results/2023-02-17-meeting.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 _sips/results/2023-02-17-meeting.md diff --git a/_sips/results/2023-02-17-meeting.md b/_sips/results/2023-02-17-meeting.md new file mode 100644 index 0000000000..a076d75c5b --- /dev/null +++ b/_sips/results/2023-02-17-meeting.md @@ -0,0 +1,9 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 18th November 2022 +partof: results +proposals: + - url: https://github.com/scala/improvement-proposals/pull/54 + name: SIP-51 - Drop Forwards Binary Compatibility of the Scala 2.13 Standard Library + result: accepted +--- From df46923924c0cdf2fa4d4988d187aea747ddcd78 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Sat, 18 Feb 2023 00:23:32 +0000 Subject: [PATCH 2480/3075] Update SIPs state --- ...ds-binary-compatibility-of-the-scala-213-standard-library.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md b/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md index 0e1f095a3d..893e9c177b 100644 --- a/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md +++ b/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md @@ -2,6 +2,6 @@ title: SIP-51 - Drop Forwards Binary Compatibility of the Scala 2.13 Standard Library status: under-review pull-request-number: 54 -stage: design +stage: implementation --- From 394b622a56862f33470dd197c67ef352eec111f2 Mon Sep 17 00:00:00 2001 From: Shubham Dighe Date: Sun, 19 Feb 2023 23:58:30 +0000 Subject: [PATCH 2481/3075] Update learn.md: Fix typo "begineer" -> "beginner" --- learn.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn.md b/learn.md index d7e3cfa9e8..5c4423c609 100644 --- a/learn.md +++ b/learn.md @@ -20,7 +20,7 @@ More details on [this page]({% link online-courses.md %}). [Scala Exercises](https://www.scala-exercises.org/) is a series of lessons and exercises created by [47 Degrees](https://www.47deg.com/). It's a great way to get a brief introduction to Scala while testing your knowledge along the way. -[Tour of Scala](https://tourofscala.com) gives you an introduction to Scala, step by step, from begineer to expert. +[Tour of Scala](https://tourofscala.com) gives you an introduction to Scala, step by step, from beginner to expert. ## Dr. Mark C Lewis's lectures from Trinity University From 9f8e6f85e780c632abd9646aee11360c92211038 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Wed, 22 Feb 2023 00:21:40 +0000 Subject: [PATCH 2482/3075] Update SIPs state --- _sips/sips/clause-interleaving.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_sips/sips/clause-interleaving.md b/_sips/sips/clause-interleaving.md index ceeb01fc25..120271e8d0 100644 --- a/_sips/sips/clause-interleaving.md +++ b/_sips/sips/clause-interleaving.md @@ -166,8 +166,8 @@ This might be the subject of a follow up proposal, if the concerns can be addres As discussed above, we may want to consider generalizing class parameter lists as well. However, we feel it is better to leave that extension to a follow-up proposal, if required. ## Related work -* Pre-SIP: https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525 -* An implementation of the proposal is available as a pull request at https://github.com/lampepfl/dotty/pull/14019 +* Pre-SIP: [https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525](https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525) +* An implementation of the proposal is available as a pull request at [https://github.com/lampepfl/dotty/pull/14019](https://github.com/lampepfl/dotty/pull/14019) ## FAQ Currently empty. From c065559c8ec20eae5192f5637bdf471ee93f4360 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Thu, 23 Feb 2023 16:53:31 +0100 Subject: [PATCH 2483/3075] Upgrade Gems dependencies --- Gemfile | 16 +--- Gemfile.lock | 251 +++++++++++++++++++++++++++++++++++++++++++-------- 2 files changed, 216 insertions(+), 51 deletions(-) diff --git a/Gemfile b/Gemfile index 3a99c6aa7d..02b8f29510 100644 --- a/Gemfile +++ b/Gemfile @@ -1,16 +1,4 @@ source 'https://rubygems.org' -gem 'jekyll-redirect-from' +gem 'github-pages' +gem 'webrick' gem 'html-proofer' -gem 'kramdown-parser-gfm' -# gem 'html-proofer' # link-checking: bundle exec htmlproofer ./_site/ --only-4xx --empty-alt-ignore --allow-hash-href - -# group :jekyll_plugins do -# gem 'hawkins' -# end - -# ^ Useful for live reloading the site in your -# browser during development. To use, uncomment -# and do: -# bundle exec jekyll liveserve --incremental - -gem "webrick", "~> 1.8" diff --git a/Gemfile.lock b/Gemfile.lock index f70c5637e4..9a1627c8b8 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,19 +1,91 @@ GEM remote: https://rubygems.org/ specs: - addressable (2.8.0) - public_suffix (>= 2.0.2, < 5.0) + activesupport (7.0.4.2) + concurrent-ruby (~> 1.0, >= 1.0.2) + i18n (>= 1.6, < 2) + minitest (>= 5.1) + tzinfo (~> 2.0) + addressable (2.8.1) + public_suffix (>= 2.0.2, < 6.0) + coffee-script (2.4.1) + coffee-script-source + execjs + coffee-script-source (1.11.1) colorator (1.1.0) - concurrent-ruby (1.1.10) + commonmarker (0.23.8) + concurrent-ruby (1.2.0) + dnsruby (1.61.9) + simpleidn (~> 0.1) em-websocket (0.5.3) eventmachine (>= 0.12.9) http_parser.rb (~> 0) - ethon (0.15.0) + ethon (0.16.0) ffi (>= 1.15.0) eventmachine (1.2.7) + execjs (2.8.1) + faraday (2.7.4) + faraday-net_http (>= 2.0, < 3.1) + ruby2_keywords (>= 0.0.4) + faraday-net_http (3.0.2) ffi (1.15.5) forwardable-extended (2.6.0) - html-proofer (3.19.4) + gemoji (3.0.1) + github-pages (228) + github-pages-health-check (= 1.17.9) + jekyll (= 3.9.3) + jekyll-avatar (= 0.7.0) + jekyll-coffeescript (= 1.1.1) + jekyll-commonmark-ghpages (= 0.4.0) + jekyll-default-layout (= 0.1.4) + jekyll-feed (= 0.15.1) + jekyll-gist (= 1.5.0) + jekyll-github-metadata (= 2.13.0) + jekyll-include-cache (= 0.2.1) + jekyll-mentions (= 1.6.0) + jekyll-optional-front-matter (= 0.3.2) + jekyll-paginate (= 1.1.0) + jekyll-readme-index (= 0.3.0) + jekyll-redirect-from (= 0.16.0) + jekyll-relative-links (= 0.6.1) + jekyll-remote-theme (= 0.4.3) + jekyll-sass-converter (= 1.5.2) + jekyll-seo-tag (= 2.8.0) + jekyll-sitemap (= 1.4.0) + jekyll-swiss (= 1.0.0) + jekyll-theme-architect (= 0.2.0) + jekyll-theme-cayman (= 0.2.0) + jekyll-theme-dinky (= 0.2.0) + jekyll-theme-hacker (= 0.2.0) + jekyll-theme-leap-day (= 0.2.0) + jekyll-theme-merlot (= 0.2.0) + jekyll-theme-midnight (= 0.2.0) + jekyll-theme-minimal (= 0.2.0) + jekyll-theme-modernist (= 0.2.0) + jekyll-theme-primer (= 0.6.0) + jekyll-theme-slate (= 0.2.0) + jekyll-theme-tactile (= 0.2.0) + jekyll-theme-time-machine (= 0.2.0) + jekyll-titles-from-headings (= 0.5.3) + jemoji (= 0.12.0) + kramdown (= 2.3.2) + kramdown-parser-gfm (= 1.1.0) + liquid (= 4.0.4) + mercenary (~> 0.3) + minima (= 2.5.1) + nokogiri (>= 1.13.6, < 2.0) + rouge (= 3.26.0) + terminal-table (~> 1.4) + github-pages-health-check (1.17.9) + addressable (~> 2.3) + dnsruby (~> 1.60) + octokit (~> 4.0) + public_suffix (>= 3.0, < 5.0) + typhoeus (~> 1.3) + html-pipeline (2.14.3) + activesupport (>= 2) + nokogiri (>= 1.4) + html-proofer (4.4.3) addressable (~> 2.3) mercenary (~> 0.3) nokogiri (~> 1.13) @@ -21,77 +93,182 @@ GEM rainbow (~> 3.0) typhoeus (~> 1.3) yell (~> 2.0) + zeitwerk (~> 2.5) http_parser.rb (0.8.0) - i18n (1.10.0) + i18n (1.12.0) concurrent-ruby (~> 1.0) - jekyll (4.2.2) + jekyll (3.9.3) addressable (~> 2.4) colorator (~> 1.0) em-websocket (~> 0.5) - i18n (~> 1.0) - jekyll-sass-converter (~> 2.0) + i18n (>= 0.7, < 2) + jekyll-sass-converter (~> 1.0) jekyll-watch (~> 2.0) - kramdown (~> 2.3) - kramdown-parser-gfm (~> 1.0) + kramdown (>= 1.17, < 3) liquid (~> 4.0) - mercenary (~> 0.4.0) + mercenary (~> 0.3.3) pathutil (~> 0.9) - rouge (~> 3.0) + rouge (>= 1.7, < 4) safe_yaml (~> 1.0) - terminal-table (~> 2.0) + jekyll-avatar (0.7.0) + jekyll (>= 3.0, < 5.0) + jekyll-coffeescript (1.1.1) + coffee-script (~> 2.2) + coffee-script-source (~> 1.11.1) + jekyll-commonmark (1.4.0) + commonmarker (~> 0.22) + jekyll-commonmark-ghpages (0.4.0) + commonmarker (~> 0.23.7) + jekyll (~> 3.9.0) + jekyll-commonmark (~> 1.4.0) + rouge (>= 2.0, < 5.0) + jekyll-default-layout (0.1.4) + jekyll (~> 3.0) + jekyll-feed (0.15.1) + jekyll (>= 3.7, < 5.0) + jekyll-gist (1.5.0) + octokit (~> 4.2) + jekyll-github-metadata (2.13.0) + jekyll (>= 3.4, < 5.0) + octokit (~> 4.0, != 4.4.0) + jekyll-include-cache (0.2.1) + jekyll (>= 3.7, < 5.0) + jekyll-mentions (1.6.0) + html-pipeline (~> 2.3) + jekyll (>= 3.7, < 5.0) + jekyll-optional-front-matter (0.3.2) + jekyll (>= 3.0, < 5.0) + jekyll-paginate (1.1.0) + jekyll-readme-index (0.3.0) + jekyll (>= 3.0, < 5.0) jekyll-redirect-from (0.16.0) jekyll (>= 3.3, < 5.0) - jekyll-sass-converter (2.2.0) - sassc (> 2.0.1, < 3.0) + jekyll-relative-links (0.6.1) + jekyll (>= 3.3, < 5.0) + jekyll-remote-theme (0.4.3) + addressable (~> 2.0) + jekyll (>= 3.5, < 5.0) + jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0) + rubyzip (>= 1.3.0, < 3.0) + jekyll-sass-converter (1.5.2) + sass (~> 3.4) + jekyll-seo-tag (2.8.0) + jekyll (>= 3.8, < 5.0) + jekyll-sitemap (1.4.0) + jekyll (>= 3.7, < 5.0) + jekyll-swiss (1.0.0) + jekyll-theme-architect (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-cayman (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-dinky (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-hacker (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-leap-day (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-merlot (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-midnight (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-minimal (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-modernist (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-primer (0.6.0) + jekyll (> 3.5, < 5.0) + jekyll-github-metadata (~> 2.9) + jekyll-seo-tag (~> 2.0) + jekyll-theme-slate (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-tactile (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-time-machine (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-titles-from-headings (0.5.3) + jekyll (>= 3.3, < 5.0) jekyll-watch (2.2.1) listen (~> 3.0) - kramdown (2.4.0) + jemoji (0.12.0) + gemoji (~> 3.0) + html-pipeline (~> 2.2) + jekyll (>= 3.0, < 5.0) + kramdown (2.3.2) rexml kramdown-parser-gfm (1.1.0) kramdown (~> 2.0) - liquid (4.0.3) - listen (3.7.1) + liquid (4.0.4) + listen (3.8.0) rb-fsevent (~> 0.10, >= 0.10.3) rb-inotify (~> 0.9, >= 0.9.10) - mercenary (0.4.0) - nokogiri (1.13.10-arm64-darwin) - racc (~> 1.4) - nokogiri (1.13.10-x86_64-darwin) - racc (~> 1.4) - nokogiri (1.13.10-x86_64-linux) + mercenary (0.3.6) + minima (2.5.1) + jekyll (>= 3.5, < 5.0) + jekyll-feed (~> 0.9) + jekyll-seo-tag (~> 2.1) + minitest (5.17.0) + nokogiri (1.14.2-x86_64-linux) racc (~> 1.4) + octokit (4.25.1) + faraday (>= 1, < 3) + sawyer (~> 0.9) parallel (1.22.1) pathutil (0.16.2) forwardable-extended (~> 2.6) public_suffix (4.0.7) - racc (1.6.1) + racc (1.6.2) rainbow (3.1.1) - rb-fsevent (0.11.1) + rb-fsevent (0.11.2) rb-inotify (0.10.1) ffi (~> 1.0) rexml (3.2.5) - rouge (3.29.0) + rouge (3.26.0) + ruby2_keywords (0.0.5) + rubyzip (2.3.2) safe_yaml (1.0.5) - sassc (2.4.0) - ffi (~> 1.9) - terminal-table (2.0.0) + sass (3.7.4) + sass-listen (~> 4.0.0) + sass-listen (4.0.0) + rb-fsevent (~> 0.9, >= 0.9.4) + rb-inotify (~> 0.9, >= 0.9.7) + sawyer (0.9.2) + addressable (>= 2.3.5) + faraday (>= 0.17.3, < 3) + simpleidn (0.2.1) + unf (~> 0.1.4) + terminal-table (1.8.0) unicode-display_width (~> 1.1, >= 1.1.1) typhoeus (1.4.0) ethon (>= 0.9.0) + tzinfo (2.0.6) + concurrent-ruby (~> 1.0) + unf (0.1.4) + unf_ext + unf_ext (0.0.8.2) unicode-display_width (1.8.0) webrick (1.8.1) yell (2.2.2) + zeitwerk (2.6.7) PLATFORMS - arm64-darwin-22 - x86_64-darwin-21 x86_64-linux DEPENDENCIES + github-pages html-proofer - jekyll-redirect-from - kramdown-parser-gfm - webrick (~> 1.8) + webrick BUNDLED WITH - 2.3.10 + 2.4.7 From 105b9d38dd327c8bcd4262a5472274c02857a926 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Thu, 23 Feb 2023 16:55:41 +0100 Subject: [PATCH 2484/3075] Add alternative docker-compose file to only build the website --- docker-compose_build-only.yml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 docker-compose_build-only.yml diff --git a/docker-compose_build-only.yml b/docker-compose_build-only.yml new file mode 100644 index 0000000000..615d0425a7 --- /dev/null +++ b/docker-compose_build-only.yml @@ -0,0 +1,9 @@ +version: '2' + +services: + jekyll: + user: "${UID}:${GID}" + build: . + command: sh -c "chown $UID / && bundle exec jekyll build" + volumes: + - .:/srv/jekyll From 190852673a135c3b86ae761d202a674df2936e9d Mon Sep 17 00:00:00 2001 From: fsalvi Date: Thu, 23 Feb 2023 17:02:52 +0100 Subject: [PATCH 2485/3075] Add information about the alternative docker-compose file --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 1f9c2dbd7d..49eb207f83 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,8 @@ For more details, read on. You need to have [Docker Engine](https://docs.docker.com/engine/) and [Docker Compose](https://docs.docker.com/compose/) installed on your machine. Under macOS (Intel or Apple silicon), instead of installing [Docker Desktop](https://docs.docker.com/desktop/) you can also use [HomeBrew](https://brew.sh/) with [Colima](https://github.com/abiosoft/colima): `brew install colima docker docker-compose`. UID and GID environment variables are needed to avoid docker from writing files as root in your directory. +By default, docker-compose will use the file docker-compose.yml which will build the website and serve it on 0.0.0.0:4000 . +If you just need to build the website, add ```-f docker-compose_build-only.yml``` ``` env UID="$(id -u)" GID="$(id -g)" docker-compose up From 3bd9016466cba48382bdcc5ce82eac7f5eca7390 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Thu, 23 Feb 2023 17:17:29 +0100 Subject: [PATCH 2486/3075] Add information about html proofer --- Gemfile | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Gemfile b/Gemfile index 02b8f29510..31cb37fbea 100644 --- a/Gemfile +++ b/Gemfile @@ -1,4 +1,6 @@ source 'https://rubygems.org' gem 'github-pages' gem 'webrick' +# gem 'html-proofer' +# gem 'html-proofer' # link-checking: bundle exec htmlproofer ./_site/ --only-4xx --ignore-empty-alt=true --allow-hash-href=true From 1761f9a03ff6efb8f6748662765e1913fab3d1c4 Mon Sep 17 00:00:00 2001 From: fsalvi Date: Fri, 24 Feb 2023 18:13:26 +0100 Subject: [PATCH 2487/3075] Update ruby to version 3.0 --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 185d285edc..15b09fb8f7 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -8,7 +8,7 @@ jobs: - name: Set up Ruby uses: ruby/setup-ruby@v1 with: - ruby-version: 2.6.9 + ruby-version: 3.0.5 bundler-cache: true - name: Set up coursier uses: coursier/setup-action@v1.2.0-M2 From 39d5fea198a7fd1364d98df8e79241ce33988199 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Sat, 25 Feb 2023 10:48:04 +0100 Subject: [PATCH 2488/3075] Update bundler and ruby in Dockerfile --- .bundle/config | 3 --- Dockerfile | 4 ++-- 2 files changed, 2 insertions(+), 5 deletions(-) delete mode 100644 .bundle/config diff --git a/.bundle/config b/.bundle/config deleted file mode 100644 index 9bc01b4c32..0000000000 --- a/.bundle/config +++ /dev/null @@ -1,3 +0,0 @@ ---- -BUNDLE_PATH: "vendor/bundle" -BUNDLE_DISABLE_SHARED_GEMS: "true" diff --git a/Dockerfile b/Dockerfile index 5ec353962f..53f6af08ff 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,6 +1,6 @@ -FROM ruby:2.7.6 +FROM ruby:3.0.5 -RUN gem install bundler:2.3.10 +RUN gem install bundler:2.4.7 WORKDIR /srv/jekyll From 8dfa47e06103fabe2402618db9441b7df45970a1 Mon Sep 17 00:00:00 2001 From: Denys Rybalka Date: Sun, 26 Feb 2023 17:09:27 +0100 Subject: [PATCH 2489/3075] Update concrete-immutable-collection-classes.md Fix a typo. --- .../collections-2.13/concrete-immutable-collection-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/concrete-immutable-collection-classes.md b/_overviews/collections-2.13/concrete-immutable-collection-classes.md index d853880915..f4d746de58 100644 --- a/_overviews/collections-2.13/concrete-immutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-immutable-collection-classes.md @@ -232,7 +232,7 @@ Ranges are represented in constant space, because they can be defined by just th Hash tries are a standard way to implement immutable sets and maps efficiently. [Compressed Hash-Array Mapped Prefix-trees](https://github.com/msteindorfer/oopsla15-artifact/) are a design for hash tries on the JVM which improves locality and makes sure the trees remain in a canonical and compact representation. They are supported by class [immutable.HashMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/HashMap.html). Their representation is similar to vectors in that they are also trees where every node has 32 elements or 32 subtrees. But the selection of these keys is now done based on hash code. For instance, to find a given key in a map, one first takes the hash code of the key. Then, the lowest 5 bits of the hash code are used to select the first subtree, followed by the next 5 bits and so on. The selection stops once all elements stored in a node have hash codes that differ from each other in the bits that are selected up to this level. -Hash tries strike a nice balance between reasonably fast lookups and reasonably efficient functional insertions (`+`) and deletions (`-`). That's why they underly Scala's default implementations of immutable maps and sets. In fact, Scala has a further optimization for immutable sets and maps that contain less than five elements. Sets and maps with one to four elements are stored as single objects that just contain the elements (or key/value pairs in the case of a map) as fields. The empty immutable set and the empty immutable map is in each case a single object - there's no need to duplicate storage for those because an empty immutable set or map will always stay empty. +Hash tries strike a nice balance between reasonably fast lookups and reasonably efficient functional insertions (`+`) and deletions (`-`). That's why they underlie Scala's default implementations of immutable maps and sets. In fact, Scala has a further optimization for immutable sets and maps that contain less than five elements. Sets and maps with one to four elements are stored as single objects that just contain the elements (or key/value pairs in the case of a map) as fields. The empty immutable set and the empty immutable map is in each case a single object - there's no need to duplicate storage for those because an empty immutable set or map will always stay empty. ## Red-Black Trees From fe78c6524258b784d4911789c23aef0093904175 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Mon, 27 Feb 2023 09:47:17 +0000 Subject: [PATCH 2490/3075] Update SIPs state --- ...ds-and-methods-in-scala-objects-si-4581.md | 6 - _sips/sips/static-members.md | 221 ++++++++++++++++++ 2 files changed, 221 insertions(+), 6 deletions(-) delete mode 100644 _sips/sips/static-fields-and-methods-in-scala-objects-si-4581.md create mode 100644 _sips/sips/static-members.md diff --git a/_sips/sips/static-fields-and-methods-in-scala-objects-si-4581.md b/_sips/sips/static-fields-and-methods-in-scala-objects-si-4581.md deleted file mode 100644 index 6b9e2d57ab..0000000000 --- a/_sips/sips/static-fields-and-methods-in-scala-objects-si-4581.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: SIP-30 - @static fields and methods in Scala objects (SI-4581) -status: withdrawn -pull-request-number: 25 - ---- diff --git a/_sips/sips/static-members.md b/_sips/sips/static-members.md new file mode 100644 index 0000000000..1c0df79d75 --- /dev/null +++ b/_sips/sips/static-members.md @@ -0,0 +1,221 @@ +--- +layout: sip +title: SIP-30 - @static fields and methods in Scala objects (SI-4581) +stage: completed +status: shipped +permalink: /sips/:title.html +redirect_from: /sips/pending/static-members.html +--- + +> This proposal has been implemented in Scala 3.0.0 + +**Authors: Dmitry Petrashko, Sébastien Doeraene and Martin Odersky** + +__first submitted 11 January 2016__ + +## Motivation ## + +We would like to allow methods and fields to be compiled as static. This is usable for interop with Java and other JVM languages, as well as with JavaScript, and is convenient for optimizations. + +## Use Cases + +Some JVM and JavaScript frameworks require classes to have specific static fields and/or methods. + +For example, classes extending `android.os.Parcelable` are required to have a static field named `CREATOR` of type `android.os.Parcelable$Creator`. + +Another example is using an [`AtomicReferenceFieldUpdater`](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.html). + +On the JavaScript side, one example is [Relay Route Definitions](https://web.archive.org/web/20180718024336/https://facebook.github.io/relay/docs/en/routing.html), whose subclasses must define static fields such as `queries`. +Static methods and fields for JavaScript classes are one of the very few things (if not the only thing) that Scala.js "cannot do" at the moment, at least not declaratively. + +## Overview ## + +In order for a method or field to be considered static it needs to be defined in an `object` and annotated `@static`. +There is no special syntax proposed to access these members, they are accessed as if they were a member of defining objects with all appropriate access requirements for accessing them. + +For example: + +{% highlight scala %} +class Foo + +object Foo { + @static val x = 5 + @static def bar(y: Int): Int = x + y +} + +println(Foo.x) +println(Foo.bar(12)) +{% endhighlight %} + +Intuitively, the presence of the `@static` annotation ensures that a field/method is declared as a static member of the companion class. +For the JVM, the above would therefore look to other Java code as if it had been declared with the following Java code: + +{% highlight java %} +class Foo { + public static int x = 5; + public static int bar(int y) { + return x + y; + } +} +{% endhighlight %} + +In Scala.js, the `@static` annotation has no semantic effect in Scala objects, as they are not visible from JavaScript anyway (it could be used for optimizations). +It has a semantic effect on Scala.js-defined JS classes, for example: + +{% highlight scala %} +@ScalaJSDefined +class Foo extends js.Object + +@ScalaJSDefined +object Foo extends js.Object { + @static val x = 5 + @static def bar(y: Int): Int = x + y +} +{% endhighlight %} + +would look to JavaScript code as if it had been declared with the following JavaScript code: + +{% highlight javascript %} +class Foo extends Object { + static bar(y) { + return x + y; + } +} +Foo.x = 5; // in ES6, there is no declarative syntax for static fields yet +{% endhighlight %} + +## Comparison with mirror classes ## + +Scalac currently generates static forwarders for fields and methods in top-level objects: + +{% highlight scala %} +object O { + val d = 1 + object I { + val f = 1 + } +} +{% endhighlight %} + +Under the proposed scheme users will be able to opt-in to have the field `f` defined in the inner object `I` emitted as a static field. +In case `O.d` is annotated with `@static` the field will be created as a static field `d` in `class O`. +If not annotated, it will be created in the companion module with a static forwarder `d` in `class O`. + +## Restrictions ## + +The following rules ensure that methods can be correctly compiled into static members on both JVM and JavaScript: + +1. Only objects can have members annotated with `@static` + +2. The fields annotated with `@static` should precede any non-`@static` fields. This ensures that we do not introduce surprises for users in initialization order of this class. + +3. The right hand side of a method or field annotated with `@static` can only refer to top-level classes, members of globally accessible objects and `@static` members. In particular, for non-static objects `this` is not accessible. `super` is never accessible. + +4. If a member `foo` of an `object C` is annotated with `@static`, the companion class `C` is not allowed to define term members with name `foo`. + +5. If a member `foo` of an `object C` is annotated with `@static`, the companion class `C` is not allowed to inherit classes that define a term member with name `foo`. + +6. Only `@static` methods and vals are supported in companions of traits. Java8 supports those, but not vars, and JavaScript does not have interfaces at all. + +Note that because of platform requirements for JavaScript interop, rules `3` and `4` would be lifted for objects that have a companion class that inherits `js.Any`. + +## Compilation scheme ## + +No modification of the typer is planned. The current proposed scheme piggybacks on already existing scoping restrictions in the typer, thus requiring `@static` methods to be defined in `object`s. + +If implemented in the dotty code base, the following modifications would be needed: + + - extend `RefChecks` to check restrictions 1, 2, 4, 5 and 6. This can be done in a separate mini-phase; + - extend `LambdaLift.CollectDependencies` to be aware that accessing a member annotated `@static` should not trigger capturing the object that contains this member; + - extend `LambdaLift` to trigger an error if a method annotated with `@static` method cannot be lifted to the top level scope; + - extend `GenBCode` to emit static fields and methods in companion classes and forwarders to them in companion modules. + +## Overriding & Hiding ## +Java allows classes to define static methods with the same name and signature as a static method of a superclass. In order to define the semantics of such cases, the Java Specification introduces the notion of [hiding](https://docs.oracle.com/javase/specs/jls/se8/html/jls-8.html#jls-8.4.8.2). + +This is required because in Java calling a `static` method on a class instance is supported. +This proposal does not need to introduce this notion as we do not support such calls. + +## Scala.js and @JSStatic ## +As Scala.js needs this feature fast, a decision has been made to ship it under a name of `@JSStatic` before waiting for this SIP to be accepted and implemented in `scalac`. When this SIP is accepted and implemented in `scalac` the `@JSStatic` would become a deprecated type alias to `scala.static`. + +## Comparison with [@lrytz's proposal](https://gist.github.com/lrytz/80f3141de8240f9629da) ## +Lukas Rytz has proposed a similar SIP, but his SIP requires changes to the typer to ensure that `@static` fields do not capture `this`, as in his proposal `@static` fields are defined in the class, rather than its companion object. +It also does not address the question of `@static` members in inner objects and inheritance/hiding of those methods in subclasses. + +## Open questions ## + - @static lazy val + +## Initialization order discussion ## +In general, emission of static fields could affect the initialization order and change semantics. +This SIP solves this by enforcing (rule `2`) that `@static` fields and expressions precede non-static fields. +This means that no code precedes the `@static` field initialization which makes it hard to observe the difference between if the field is initialized statically or not, +since fields are initialized in the order `as written`, similar to how normal fields are initialized. + +The `@static` proposal is similar to `@tailrec` in a sense that it fails compilation in the case where the user did not write code that follows the aforementioned rules. +These rules exist to enforce the unlikelihood of an observable difference in semantics if `@static` annotations are dropped; +The restrictions in this SIP make it hard to observe changes in initialization within the same object. +It is still possible to observe those changes using multiple classes and side effects within initializers: + +{% highlight scala %} +class C { + val x = {println("x"); 1 } +} + + +object O extends C { + val y = { println("y"); 2 } + // prints: + // x + // y +} + +object Os extends C { + @static val y = { println("y"); 2 } + // prints: + // y + // x +} +{% endhighlight %} + + +Static fields can be initialized earlier than they used to be initialized while being non-static, but never later. +By requiring `@static` first to be defined first inside the object, +we guarantee that you can't observe the changes in initialization withing the same object without resorting to code which either uses `Unsafe` or exhibits undefined behaviour under the JVM. + +## Could `@static` be a `@tailrec`-like annotation that doesn't affect code generation but only checks ## +Unlike `@tailrec` this annotation does affect the binary API and dropping such an annotation would be a binary incompatible change. This is why authors believe that developers should be in full control of what is static. + +## Alternative: Emitting fields of objects as static by default ## +An alternative to this proposal would be to emit all the fields defined in objects as static. +Unfortunately this gets us under dark waters when we try to figure out in the following example: + + +{% highlight scala %} +class Super { + val c = {println(1); 1} +} +object Object extends Super { + override val c = {println(2); 2} + val d = {println(3); 2} +} +{% endhighlight %} + +Let's consider possible options: + + - if the field `c` is emitted as `static` on the bytecode level, it will be initialized before the `c` in superclass is initialized, reordering side-effects in initializers; + - if the field `c` is _not_ emitted as `static` but the field `d` is, then the order of initialization would also be affected, reordering side-effects. + +Based on the previous study done in preparation for this SIP, the authors believe that the only reasonable way to maintain current semantics would be to say that such alternative would require these rules: + + - only the fields which were not declared by parents of the object can be emitted as static; + - only fields that are lexically defined before any non-static field or statement in the body can be emitted as static. + +Authors believe that the alternative would require the same effort to implement, but will be less intuitive to users and harder to control as, for example, reordering fields in object might not be binary compatible. + +## See Also ## + * [SI-4581](https://issues.scala-lang.org/browse/SI-4581) is a request for a `@static` annotation + * [Scala.js issue #1902](https://github.com/scala-js/scala-js/issues/1902) is a request for defining static fields in Scala.js-defined JS classes + * [Another proposal by @lrytz](https://gist.github.com/lrytz/80f3141de8240f9629da) + * [Old discussion on scala-internals mailing list](https://groups.google.com/forum/#!searchin/scala-internals/static/scala-internals/vOps4k8CADY/Dq1I3Ysvao0J) + * [Another discussion of scala-internals mailing list](https://groups.google.com/forum/#!searchin/scala-internals/static/scala-internals/Y3OlFWPvnyM/tGE5BQw4Pe0J) From 03a3fbd5a8edc2a3ebdd2d928729ac916affd16d Mon Sep 17 00:00:00 2001 From: Chris Kipp Date: Mon, 27 Feb 2023 11:43:49 +0100 Subject: [PATCH 2491/3075] fix(ci): update htmlproofer flags since it was updated --- .github/workflows/build.yml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 15b09fb8f7..0fc6596889 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -25,8 +25,9 @@ jobs: # # Checking for docs.scala-lang/blob/main leads to a chicken and egg problem because of the edit links of new pages. bundle exec htmlproofer ./_site/\ --only-4xx\ - --http-status-ignore "400,401,403,429"\ - --empty-alt-ignore\ + --ignore-status-codes "400,401,403,429"\ + --ignore-empty-alt\ --allow-hash-href\ - --url-ignore '/https://github.com/scala/docs.scala-lang/blob/main/.*/,/www.oracle.com/' + --enforce-https=false\ + --ignore-urls '/https://github.com/scala/docs.scala-lang/blob/main/.*/,/www.oracle.com/' From 2285d8d2ee0bd1a75e1087f16974a6e4ede67b93 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 27 Feb 2023 18:08:25 +0100 Subject: [PATCH 2492/3075] Fix missing alt and URL --- _overviews/parallel-collections/architecture.md | 2 +- _tour/implicit-parameters.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/parallel-collections/architecture.md b/_overviews/parallel-collections/architecture.md index 3ab2014f75..f98b628210 100644 --- a/_overviews/parallel-collections/architecture.md +++ b/_overviews/parallel-collections/architecture.md @@ -87,7 +87,7 @@ Scala's parallel collection's draws much inspiration from the design of Scala's (sequential) collections library-- as a matter of fact, it mirrors the regular collections framework's corresponding traits, as shown below. -[]({{ site.baseurl }}/resources/images/parallel-collections-hierarchy.png) +[Hierarchy of Scala Collections and Parallel Collections]({{ site.baseurl }}/resources/images/parallel-collections-hierarchy.png)
    Hierarchy of Scala's Collections and Parallel Collections Libraries

    diff --git a/_tour/implicit-parameters.md b/_tour/implicit-parameters.md index 69a85d3cde..4d5977f242 100644 --- a/_tour/implicit-parameters.md +++ b/_tour/implicit-parameters.md @@ -99,4 +99,4 @@ Scala will look for available given values in two places: * Scala will first look for given definitions and using parameters that can be accessed directly (without a prefix) at the call site of `max`. * Then it looks for members marked `given`/`implicit` in the companion objects associated with the implicit candidate type (for example: `object Comparator` for the candidate type `Comparator[Int]`). -A more detailed guide to where Scala looks for implicits can be found in [the FAQ](//docs.scala-lang.org/tutorials/FAQ/finding-implicits.html). +A more detailed guide to where Scala looks for implicits can be found in [the FAQ](/tutorials/FAQ/finding-implicits.html). From b5c7179228ed79156a24b926ed59a3fb14a16955 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 27 Feb 2023 18:27:53 +0100 Subject: [PATCH 2493/3075] Fix missing alt and URLs --- _es/overviews/parallel-collections/architecture.md | 2 +- _ja/overviews/macros/usecases.md | 2 +- _ja/overviews/parallel-collections/architecture.md | 2 +- _ja/tour/implicit-parameters.md | 2 +- _overviews/core/architecture-of-scala-collections.md | 2 +- _overviews/core/custom-collections.md | 2 +- _ru/overviews/parallel-collections/architecture.md | 2 +- _ru/tour/implicit-parameters.md | 2 +- _zh-cn/tour/implicit-parameters.md | 2 +- 9 files changed, 9 insertions(+), 9 deletions(-) diff --git a/_es/overviews/parallel-collections/architecture.md b/_es/overviews/parallel-collections/architecture.md index 8e60e87a59..138a5dee08 100644 --- a/_es/overviews/parallel-collections/architecture.md +++ b/_es/overviews/parallel-collections/architecture.md @@ -87,7 +87,7 @@ de la librería de colecciones secuenciales -- de hecho, "replican" los correspo traits presentes en el framework de colecciones secuenciales, tal y como se muestra a continuación. -[]({{ site.baseurl }}/resources/images/parallel-collections-hierarchy.png) +[Hierarchy of Scala Collections and Parallel Collections]({{ site.baseurl }}/resources/images/parallel-collections-hierarchy.png)
    Jerarquía de clases de las librerías de colecciones secuenciales y paralelas de Scala

    diff --git a/_ja/overviews/macros/usecases.md b/_ja/overviews/macros/usecases.md index 5e4c691242..9db3bc1398 100644 --- a/_ja/overviews/macros/usecases.md +++ b/_ja/overviews/macros/usecases.md @@ -20,7 +20,7 @@ Scala の商用ユーザと研究ユーザの両方がマクロを利用して ここ EPFL においても我々はマクロを活用して研究を行っている。Lightbend 社もマクロを数々のプロジェクトに採用している。 マクロはコミュニティー内でも人気があり、既にいくつかの興味深い応用が現れている。 -最近行われた講演の ["What Are Macros Good For?"](https://scalamacros.org/paperstalks/2013-07-17-WhatAreMacrosGoodFor.pdf) では Scala 2.10 ユーザのマクロの利用方法を説明し、システム化した。講演の大筋はマクロはコード生成、静的な検査、および DSL に有効であるということで、これを研究や産業からの例を交えながら説明した。 +最近行われた講演の ["What Are Macros Good For?"](https://scalamacros.org/paperstalks/2014-02-04-WhatAreMacrosGoodFor.pdf) では Scala 2.10 ユーザのマクロの利用方法を説明し、システム化した。講演の大筋はマクロはコード生成、静的な検査、および DSL に有効であるということで、これを研究や産業からの例を交えながら説明した。 Scala'13 ワークショップにおいて ["Scala Macros: Let Our Powers Combine!"](https://scalamacros.org/paperstalks/2013-04-22-LetOurPowersCombine.pdf) という論文を発表した。これは Scala 2.10 における最先端のマクロ論をより学問的な視点から説明した。 この論文では Scala のリッチな構文と静的な型がマクロと相乗することを示し、また既存の言語機能をマクロによって新しい方法で活用できることを考察する。 diff --git a/_ja/overviews/parallel-collections/architecture.md b/_ja/overviews/parallel-collections/architecture.md index c386beeb6b..146701cecc 100644 --- a/_ja/overviews/parallel-collections/architecture.md +++ b/_ja/overviews/parallel-collections/architecture.md @@ -56,7 +56,7 @@ language: ja Scala の並列コレクションは、Scala の（順次）コレクションライブラリの設計から多大な影響を受けている。 以下に示すよう、トレイト群は通常のコレクションフレームワーク内のトレイト群を鏡写しのように対応している。 -[]({{ site.baseurl }}/resources/images/parallel-collections-hierarchy.png) +[Hierarchy of Scala Collections and Parallel Collections]({{ site.baseurl }}/resources/images/parallel-collections-hierarchy.png)
    Scala のコレクションと並列コレクションライブラリの継承関係

    diff --git a/_ja/tour/implicit-parameters.md b/_ja/tour/implicit-parameters.md index db43cd76fc..4160583a0f 100644 --- a/_ja/tour/implicit-parameters.md +++ b/_ja/tour/implicit-parameters.md @@ -16,7 +16,7 @@ Scalaがこれらのパラメータを探す場所は2つのカテゴリに分 * Scalaはまず最初に暗黙のパラメータブロックを持つメソッドが呼び出されている箇所で、直接(プレフィックスなしに)アクセスできる暗黙の定義と暗黙のパラメータを探します。 * 次に、候補となる型に関連づけられた全てのコンパニオンオブジェクトの中でimplicitと宣言されているメンバーを探します。 -Scalaがimplicitをどこから見つけるかについてのより詳しいガイドは[FAQ](//docs.scala-lang.org/tutorials/FAQ/finding-implicits.html)で見ることができます。 +Scalaがimplicitをどこから見つけるかについてのより詳しいガイドは[FAQ](/tutorials/FAQ/finding-implicits.html)で見ることができます。 以下の例では、モノイドの`add`と`unit`の演算を使い、要素のリストの合計を計算するメソッド`sum`を定義しています。 implicitの値をトップレベルには置けないことに注意してください。 diff --git a/_overviews/core/architecture-of-scala-collections.md b/_overviews/core/architecture-of-scala-collections.md index 437ef8b015..1bc7d82915 100644 --- a/_overviews/core/architecture-of-scala-collections.md +++ b/_overviews/core/architecture-of-scala-collections.md @@ -789,7 +789,7 @@ storing the strings "abc", "abd", "al", "all" and "xy" would look like this: A sample patricia trie: - +Patricia trie To find the node corresponding to the string "abc" in this trie, simply follow the subtree labeled "a", proceed from there to the diff --git a/_overviews/core/custom-collections.md b/_overviews/core/custom-collections.md index 6ae55d4741..6164ec3af2 100644 --- a/_overviews/core/custom-collections.md +++ b/_overviews/core/custom-collections.md @@ -1218,7 +1218,7 @@ storing the strings "abc", "abd", "al", "all" and "xy" would look like this: A sample patricia trie: - +Patricia trie To find the node corresponding to the string "abc" in this trie, simply follow the subtree labeled "a", proceed from there to the diff --git a/_ru/overviews/parallel-collections/architecture.md b/_ru/overviews/parallel-collections/architecture.md index 9677440e9c..1e8fbbf37c 100644 --- a/_ru/overviews/parallel-collections/architecture.md +++ b/_ru/overviews/parallel-collections/architecture.md @@ -48,7 +48,7 @@ _Примечание:_ Если есть два `Combiner`а, `c1` и `c2` гд Параллельные коллекции Scala во многом созданы под влиянием дизайна библиотеки (последовательных) коллекций Scala. На рисунке ниже показано, что их дизайн фактически отражает соответствующие трейты фреймворка обычных коллекций. -[]({{ site.baseurl }}/resources/images/parallel-collections-hierarchy.png) +[parallel Collections Hierarchy]({{ site.baseurl }}/resources/images/parallel-collections-hierarchy.png)
    Иерархия библиотеки Scala: коллекции и параллельные коллекции

    diff --git a/_ru/tour/implicit-parameters.md b/_ru/tour/implicit-parameters.md index f6ca9b6fda..a04382022e 100644 --- a/_ru/tour/implicit-parameters.md +++ b/_ru/tour/implicit-parameters.md @@ -15,7 +15,7 @@ previous-page: self-types * Скала сначала будет искать неявные параметры, доступ к которым можно получить напрямую (без префикса) в месте вызова метода в котором запрошены неявные параметры. * Затем он ищет членов, помеченных как implicit во всех объектах компаньонах, связанных с типом неявного параметра. -Более подробное руководство, о том где scala ищет неявные значения можно найти в [FAQ](//docs.scala-lang.org/tutorials/FAQ/finding-implicits.html) +Более подробное руководство, о том где scala ищет неявные значения можно найти в [FAQ](/tutorials/FAQ/finding-implicits.html) В следующем примере мы определяем метод `sum`, который вычисляет сумму элементов списка, используя операции `add` и `unit` моноида. Обратите внимание, что неявные значения не могут находится выше уровнем. diff --git a/_zh-cn/tour/implicit-parameters.md b/_zh-cn/tour/implicit-parameters.md index aa264c086d..e8e89451e6 100644 --- a/_zh-cn/tour/implicit-parameters.md +++ b/_zh-cn/tour/implicit-parameters.md @@ -18,7 +18,7 @@ Scala 将查找这些参数的位置分为两类： * Scala 在调用包含有隐式参数块的方法时，将首先查找可以直接访问的隐式定义和隐式参数 (无前缀)。 * 然后，它在所有伴生对象中查找与隐式候选类型相关的有隐式标记的成员。 -更加详细的关于 Scala 到哪里查找隐式参数的指南请参考 [常见问题](//docs.scala-lang.org/tutorials/FAQ/finding-implicits.html) +更加详细的关于 Scala 到哪里查找隐式参数的指南请参考 [常见问题](/tutorials/FAQ/finding-implicits.html) 在下面的例子中，我们定义了一个方法 `sum`，它使用 Monoid 类的 `add` 和 `unit` 方法计算一个列表中元素的总和。 请注意，隐式值不能是顶级值。 From 430af02c53d772afa9a4db12a4572e831cd34023 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 27 Feb 2023 18:51:36 +0100 Subject: [PATCH 2494/3075] Add missing url --- _ja/overviews/collections/sets.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/overviews/collections/sets.md b/_ja/overviews/collections/sets.md index f5fab5cee4..47e7a40b62 100644 --- a/_ja/overviews/collections/sets.md +++ b/_ja/overviews/collections/sets.md @@ -104,7 +104,7 @@ language: ja 可変集合は `+=` と `-=` の別形として `add` と `remove` を提供する。違いは `add` と `remove` は集合に対して演算の効果があったかどうかを示す `Boolean` の戻り値を返すことだ。 -現在の可変集合のデフォルトの実装では要素を格納するのにハッシュテーブルを使っている。不変集合のデフォルトの実装は集合の要素数に応じて方法を変えている。空集合はシングルトンで表される。サイズが4つまでの集合は全要素をフィールドとして持つオブジェクトとして表される。それを超えたサイズの不変集合は[ハッシュトライ]()として表される。 +現在の可変集合のデフォルトの実装では要素を格納するのにハッシュテーブルを使っている。不変集合のデフォルトの実装は集合の要素数に応じて方法を変えている。空集合はシングルトンで表される。サイズが4つまでの集合は全要素をフィールドとして持つオブジェクトとして表される。それを超えたサイズの不変集合は[ハッシュトライ](concrete-immutable-collection-classes.html)として表される。 このような設計方針のため、(例えば 4以下の) 小さいサイズの集合を使う場合は、通常の場合、可変集合に比べて不変集合の方が、よりコンパクトで効率的だ。集合のサイズが小さいと思われる場合は、不変集合を試してみてはいかがだろうか。 From 8d52828f6fded214c330208a1bc6f955e770727b Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 27 Feb 2023 19:06:32 +0100 Subject: [PATCH 2495/3075] Remove useless a name --- _ja/overviews/macros/implicits.md | 1 - 1 file changed, 1 deletion(-) diff --git a/_ja/overviews/macros/implicits.md b/_ja/overviews/macros/implicits.md index 619997501d..9119b0a5a3 100644 --- a/_ja/overviews/macros/implicits.md +++ b/_ja/overviews/macros/implicits.md @@ -86,7 +86,6 @@ Scala implicit の標準機能である複数のパラメータや重複した この場合、必須のインスタンスである `Showable[Int]` は先に定義した具現化マクロによって生成される。つまり、マクロを implicit にすることで型クラスインスタンスの具現化を自動化すると同時にマクロを使わない implicit もシームレスに統合することができる。 -  ## 関数従属性の具現化 From ce15a93882f4e9231b8622070c0367480b163a81 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 27 Feb 2023 19:09:48 +0100 Subject: [PATCH 2496/3075] Remove useless a name in ja lang --- _ja/overviews/macros/overview.md | 2 -- _ja/overviews/reflection/overview.md | 1 - 2 files changed, 3 deletions(-) diff --git a/_ja/overviews/macros/overview.md b/_ja/overviews/macros/overview.md index 02997905c9..ff18d7f2b6 100644 --- a/_ja/overviews/macros/overview.md +++ b/_ja/overviews/macros/overview.md @@ -214,7 +214,6 @@ Scala コードの生成については[リフレクションの概要](https:// このシナリオは前節で説明したとおりだ。つまり、マクロとそれを使用するコードを別に呼び出した `scalac` によってコンパイルすることで、全てうまくいくはずだ。REPL をつかっているなら、さらに都合がいい。なぜなら REPL はそれぞれの行を独立したコンパイルとして扱うため、マクロを定義してすぐに使うことができる。 -  ### Maven か sbt を用いてマクロを使う 本稿での具体例では最もシンプルなコマンドラインのコンパイルを使っているが、マクロは Maven や sbt などのビルドツールからも使うことができる。完結した具体例としては [https://github.com/scalamacros/sbt-example](https://github.com/scalamacros/sbt-example) か [https://github.com/scalamacros/maven-example](https://github.com/scalamacros/maven-example) を見てほしいが、要点は以下の 2点だ: @@ -321,7 +320,6 @@ Scala コードの生成については[リフレクションの概要](https:// [SI-6910](https://issues.scala-lang.org/browse/SI-6910) に記述されているとおり、現時点ではある位置から複数の警告やエラーの報告はサポートされていないことに注意してほしい。そのため、ある位置で最初のエラーか警告だけが報告され他は失くなってしまう。(ただし、同じ位置で後から報告されてもエラーは警告よりも優先される) -  ### より大きなマクロを書く マクロ実装が実装メソッドの本文におさまりきらなくなって、モジュール化の必要性が出てくると、コンテキストパラメータを渡して回る必要があることに気付くだろう。マクロを定義するのに必要なもののほとんどがこのコンテキストにパス依存しているからだ。 diff --git a/_ja/overviews/reflection/overview.md b/_ja/overviews/reflection/overview.md index 92b0673a22..e7d28c55fd 100644 --- a/_ja/overviews/reflection/overview.md +++ b/_ja/overviews/reflection/overview.md @@ -54,7 +54,6 @@ Scala の式を抽象構文木へと**レイファイ** (reify) する機能 (3) ### 具体例 -  #### ランタイム型のインスペクション (実行時におけるジェネリック型も含む) 他の JVM言語同様に、Scala の型はコンパイル時に**消去** (erase) される。 From 4198643e2f87793016d6d8e5b485535ebd02b9ac Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 27 Feb 2023 19:42:51 +0100 Subject: [PATCH 2497/3075] Try to replace english name with ja name --- _ja/overviews/macros/blackbox-whitebox.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_ja/overviews/macros/blackbox-whitebox.md b/_ja/overviews/macros/blackbox-whitebox.md index 9fe6fd313e..30e582f473 100644 --- a/_ja/overviews/macros/blackbox-whitebox.md +++ b/_ja/overviews/macros/blackbox-whitebox.md @@ -33,7 +33,7 @@ Scala 2.11.x および Scala 2.12.x 系列では、マクロ機能が blackbox しかし、ときとして def マクロは「ただのメソッド呼び出し」という概念を超越することがある。例えば、展開されたマクロは、元のマクロの戻り値の型よりも特化された型を持つ式を返すことが可能だ。Scala 2.10 では、StackOverflow の [Static return type of Scala macros](https://stackoverflow.com/questions/13669974/static-return-type-of-scala-macros) で解説したように、そのような展開は特化された型を保持し続けることができる。 -この興味深い機能がもたらす柔軟性によって、[偽装型プロバイダ](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/)、[具現化の拡張](https://github.com/scala/improvement-proposals/pull/18)、[関数従属性の具現化](/ja/overviews/macros/implicits.html#fundep_materialization)、抽出子マクロなどを可能とするけども、書かれたコードの明確さ (人にとってもマシンにとっても) が犠牲になるという側面がある。 +この興味深い機能がもたらす柔軟性によって、[偽装型プロバイダ](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/)、[具現化の拡張](https://github.com/scala/improvement-proposals/pull/18)、[関数従属性の具現化](/ja/overviews/macros/implicits.html#関数従属性の具現化)、抽出子マクロなどを可能とするけども、書かれたコードの明確さ (人にとってもマシンにとっても) が犠牲になるという側面がある。 普通のメソッド同様に振る舞うマクロと戻り値の型を細別化 (refine) するマクロという決定的な区別を明確にするために、blackbox マクロと whitebox マクロという概念を導入することにした。型シグネチャに忠実に従うマクロは、振る舞いを理解するのに実装を知る必要が無い (ブラックボックスとして扱うことができる) ため、**blackbox マクロ** (blackbox macro) と呼ぶ。 Scala の型システムを使ってシグネチャを持つことができないマクロは **whitebox マクロ** (whitebox macro) と呼ぶ。(whitebox def マクロもシグネチャは持つが、これらのシグネチャは近似値でしかない) @@ -49,7 +49,7 @@ blackbox マクロと whitebox マクロの両方とも大切なことは認識 blackbox def マクロは Scala 2.10 の def マクロと異なる扱いとなる。Scala の型検査において以下の制限が加わる: 1. blackbox マクロが構文木 `x` に展開するとき、展開される式は型注釈 `(x: T)` でラップされる。この `T` は blackbox マクロの宣言された戻り値の型に、マクロ適用時に一貫性を持つように型引数やパス依存性を適用したものとなる。これによって、blackbox マクロを[型プロバイダ](https://meta.plasm.us/posts/2013/07/11/fake-type-providers-part-2/)のための手段としての利用は無効となる。 -1. Scala の型推論アルゴリズムが終わった後でも blackbox マクロの適用に未決定の型パラメータが残る場合、これらの型パラメータは普通のメソッドと同様に強制的に型推論が実行される。これによって blackbox マクロから型推論に影響を与えることが不可能となり、[関数従属性の具現化](/ja/overviews/macros/implicits.html#fundep_materialization)に使うことが無効となる。 +1. Scala の型推論アルゴリズムが終わった後でも blackbox マクロの適用に未決定の型パラメータが残る場合、これらの型パラメータは普通のメソッドと同様に強制的に型推論が実行される。これによって blackbox マクロから型推論に影響を与えることが不可能となり、[関数従属性の具現化](/ja/overviews/macros/implicits.html#関数従属性の具現化)に使うことが無効となる。 1. blackbox マクロの適用が implicit の候補として使われる場合、implicit 検索がそのマクロを選択するまでは展開は実行されない。これによって [implicit マクロの入手可能性を動的に計算する](https://github.com/scala/improvement-proposals/pull/18)ことが無効となる。 1. blackbox マクロの適用がパターンマッチの抽出子として使われる場合、無条件でコンパイラエラーを発生するようにして、マクロで実装されたパターンマッチングのカスタマイズを無効となる。 From c7de397d6afc9fbcc12ec79df4aec2c8f9b8d8db Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 27 Feb 2023 19:53:09 +0100 Subject: [PATCH 2498/3075] Try to replace english name with ja name --- _ja/overviews/macros/bundles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/overviews/macros/bundles.md b/_ja/overviews/macros/bundles.md index c62f99e2ef..b2c4809533 100644 --- a/_ja/overviews/macros/bundles.md +++ b/_ja/overviews/macros/bundles.md @@ -21,7 +21,7 @@ Scala 2.10.x においてマクロ実装は関数として表されている。
    1. 関数に制限されることで複雑なマクロのモジュール化がしづらくなる。マクロのロジックがマクロ実装外のヘルパートレイトに集中していて、マクロ実装がヘルパーをインスタンス化するだけのラッパーになってしまっているのは典型的な例だ。
      2. -
    2. さらに、マクロのパラメータがマクロのコンテキストにパス依存であるため、ヘルパーと実装をつなぐのに特殊なおまじないを必要とする。
      3. +
    3. さらに、マクロのパラメータがマクロのコンテキストにパス依存であるため、ヘルパーと実装をつなぐのに特殊なおまじないを必要とする。
    マクロバンドルは、マクロ実装を From 6b172d70c5f1b7913e9935a82506e20274f3074e Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 27 Feb 2023 20:04:36 +0100 Subject: [PATCH 2499/3075] Try to replace english name with ja name --- _ja/overviews/macros/paradise.md | 2 +- _ja/overviews/macros/roadmap.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_ja/overviews/macros/paradise.md b/_ja/overviews/macros/paradise.md index 93d610a649..7c897ff357 100644 --- a/_ja/overviews/macros/paradise.md +++ b/_ja/overviews/macros/paradise.md @@ -35,7 +35,7 @@ title: マクロパラダイス 詳細は[機能の一覧を](/ja/overviews/macros/roadmap.html)参照。 具体例に関しては [https://github.com/scalamacros/sbt-example-paradise](https://github.com/scalamacros/sbt-example-paradise) を参照してほしいが、要点をまとめると、マクロパラダイスを使うには以下の二行をビルド定義に加えるだけでいい -(すでに[sbt を使っている](/ja/overviews/macros/overview.html#using_macros_with_maven_or_sbt)ことが前提だが): +(すでに[sbt を使っている](/ja/overviews/macros/overview.html#maven-か-sbt-を用いてマクロを使う)ことが前提だが): resolvers += Resolver.sonatypeRepo("releases") diff --git a/_ja/overviews/macros/roadmap.md b/_ja/overviews/macros/roadmap.md index 5be65f30df..9300672ba6 100644 --- a/_ja/overviews/macros/roadmap.md +++ b/_ja/overviews/macros/roadmap.md @@ -27,7 +27,7 @@ title: ロードマップ | [def マクロ](/ja/overviews/macros/overview.html) | Yes | Yes 1 | Yes | Yes 1 | Yes | Yes 1 | | [マクロバンドル](/ja/overviews/macros/bundles.html) | No | No 1 | Yes | Yes 1 | Yes | Yes 1 | | [implicit マクロ](/ja/overviews/macros/implicits.html) | Yes (since 2.10.2) | Yes 1 | Yes | Yes 1 | Yes | Yes 1 | -| [関数従属性の具現化](/ja/overviews/macros/implicits.html#fundep_materialization) | No | Yes 2 | Yes | Yes 1 | Yes | Yes 1 | +| [関数従属性の具現化](/ja/overviews/macros/implicits.html#関数従属性の具現化) | No | Yes 2 | Yes | Yes 1 | Yes | Yes 1 | | [型プロバイダ](/ja/overviews/macros/typeproviders.html) | 一部サポート (see docs) | Yes 2 | 一部サポート (see docs) | Yes 2 | 一部サポート (see docs) | Yes 2 | | 準クォート | No | Yes 1 | Yes | Yes 1 | Yes | Yes 1 | | [型マクロ](/ja/overviews/macros/typemacros.html) | No | No | No | No | No | No | From ed499a3482f752ca973f7ce577dc4021da4a4b07 Mon Sep 17 00:00:00 2001 From: Lucas Date: Fri, 24 Feb 2023 15:53:16 +0100 Subject: [PATCH 2500/3075] Improve static site documentation, siteroot --- _overviews/scala3-scaladoc/static-site.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index df36e95557..0d0b492b59 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -37,6 +37,15 @@ getting-started.html Scaladoc can transform both files and directories (to organize your documentation into a tree-like structure). By default, directories have a title based on the file name and have empty content. It is possible to provide index pages for each section by creating `index.html` or `index.md` (not both) in the dedicated directory. +Before generating your static site you also need to set the `-siteroot` to the name of your ``,which means that when you generate documentation for your project, the root URL for the generated documentation will be ``. +The configuration is as follows: + +``` +Compile / doc / scalacOptions ++= Seq("-siteroot", "docs") +``` + +Note that the `Compile / doc` part of the line refers to the `doc` task in the `Compile` configuration, which generates documentation for the project's main sources. So, the `scalacOptions` set in this line will only be used during the generation of documentation for the main sources, not during compilation or testing. Refer to the settings page for more information + Keep in mind that viewing your site locally with all the features it offers, like search or snippets, require a local server. For example if your output directory was `output` you could use a python server to view everything by doing the following and opening `localhost:8080`: From ce8851f641fbf1b8c837833a94e8620f54901653 Mon Sep 17 00:00:00 2001 From: Lucas Date: Mon, 27 Feb 2023 09:20:00 +0100 Subject: [PATCH 2501/3075] Some corrections of nits --- _overviews/scala3-scaladoc/static-site.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index 0d0b492b59..ee5c579aa7 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -37,15 +37,13 @@ getting-started.html Scaladoc can transform both files and directories (to organize your documentation into a tree-like structure). By default, directories have a title based on the file name and have empty content. It is possible to provide index pages for each section by creating `index.html` or `index.md` (not both) in the dedicated directory. -Before generating your static site you also need to set the `-siteroot` to the name of your ``,which means that when you generate documentation for your project, the root URL for the generated documentation will be ``. +Before generating your static site you need to set the `-siteroot` value in your doc `scalacOptions`. The value of this is the directory that holds your docs. The root URL for the generated documentation will also be ``. The configuration is as follows: ``` Compile / doc / scalacOptions ++= Seq("-siteroot", "docs") ``` -Note that the `Compile / doc` part of the line refers to the `doc` task in the `Compile` configuration, which generates documentation for the project's main sources. So, the `scalacOptions` set in this line will only be used during the generation of documentation for the main sources, not during compilation or testing. Refer to the settings page for more information - Keep in mind that viewing your site locally with all the features it offers, like search or snippets, require a local server. For example if your output directory was `output` you could use a python server to view everything by doing the following and opening `localhost:8080`: From b8ef2d4050cbedf2d92dc8e89d11bf8f3536279b Mon Sep 17 00:00:00 2001 From: Lucas Date: Mon, 27 Feb 2023 10:43:23 +0100 Subject: [PATCH 2502/3075] Add an example --- _overviews/scala3-scaladoc/static-site.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index ee5c579aa7..d5d1ce6154 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -38,7 +38,18 @@ getting-started.html Scaladoc can transform both files and directories (to organize your documentation into a tree-like structure). By default, directories have a title based on the file name and have empty content. It is possible to provide index pages for each section by creating `index.html` or `index.md` (not both) in the dedicated directory. Before generating your static site you need to set the `-siteroot` value in your doc `scalacOptions`. The value of this is the directory that holds your docs. The root URL for the generated documentation will also be ``. -The configuration is as follows: + +For example if you have a directory called `docs` and you'd like that to be treated as your site root : + +``` +. +└── docs/ + └── _docs/ + ├── index.html + └── getting-started.html +``` + +Then the configuration would be as follows: ``` Compile / doc / scalacOptions ++= Seq("-siteroot", "docs") From 292e1d34664ea935937b2809ea91a6b86ac50b0f Mon Sep 17 00:00:00 2001 From: Lucas Date: Mon, 27 Feb 2023 11:20:24 +0100 Subject: [PATCH 2503/3075] correction --- _overviews/scala3-scaladoc/static-site.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index d5d1ce6154..4eda6f88da 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -39,7 +39,7 @@ Scaladoc can transform both files and directories (to organize your documentatio Before generating your static site you need to set the `-siteroot` value in your doc `scalacOptions`. The value of this is the directory that holds your docs. The root URL for the generated documentation will also be ``. -For example if you have a directory called `docs` and you'd like that to be treated as your site root : +For example if you have a directory called `docs` and you'd like that to be treated as your site root: ``` . From 8686bd03be6b76defab921bd05cb78716222dbdf Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Wed, 1 Mar 2023 00:27:30 +0000 Subject: [PATCH 2504/3075] Update SIPs state --- _sips/sips/binary-apis.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/binary-apis.md diff --git a/_sips/sips/binary-apis.md b/_sips/sips/binary-apis.md new file mode 100644 index 0000000000..0e73d27a14 --- /dev/null +++ b/_sips/sips/binary-apis.md @@ -0,0 +1,7 @@ +--- +title: SIP-52 - Binary APIs +status: under-review +pull-request-number: 58 +stage: design + +--- From 61c34978759c2b84a500bd4e717ed62f91a7e633 Mon Sep 17 00:00:00 2001 From: Lucas Date: Sun, 26 Feb 2023 12:53:05 +0100 Subject: [PATCH 2505/3075] Improve documentation for Built-in Blog doc, add Structure and special characters parts --- _overviews/scala3-scaladoc/blog.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index be9754820c..deb64df074 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -33,4 +33,28 @@ Scaladoc loads blog if the `_blog` directory exists. All the blogpost filenames should start with date in numeric format matching `YYYY-MM-DD`. Example name is `2015-10-23-dotty-compiler-bootstraps.md`. +## Structure +``` +--- +layout: A reference to the layout for the blog page +author: Name of the author of the page +title: Name of the author of the page +subTitle: Subtitle of the page +excerpt_separator: +date: Date of creation of the page +authorImg: Image of the author of the page +--- + +``` +Keep in mind that with the exception of the author's name and title, the fields are optional. + +## Special characters for structures + +```````` : For code + +`##Subtitle` : For subtitles + +`word` : To highlight + +`[word](Link to a website)`: If you want to put a link in a word \ No newline at end of file From 80560194df1956b00a72abaefb0dc60ca5756e4b Mon Sep 17 00:00:00 2001 From: Lucas Date: Wed, 1 Mar 2023 10:35:53 +0100 Subject: [PATCH 2506/3075] Corrections --- _overviews/scala3-scaladoc/blog.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index deb64df074..1aff76fb55 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -35,25 +35,26 @@ Example name is `2015-10-23-dotty-compiler-bootstraps.md`. ## Structure +When creating a blog page, you will have a first part to fill in with different fields. See the following example: + ``` --- -layout: A reference to the layout for the blog page -author: Name of the author of the page -title: Name of the author of the page -subTitle: Subtitle of the page +layout: +author: +title: +subTitle: <Subtitle of the page> excerpt_separator: <!--more--> -date: Date of creation of the page -authorImg: Image of the author of the page +date: <Date of the creation of the page> +authorImg: <Link to the author's image> --- <Content> ``` -Keep in mind that with the exception of the author's name and title, the fields are optional. -## Special characters for structures +## Special characters for the content -````<content>```` : For code +` ```<content>``` ` : For code -`##Subtitle` : For subtitles +`## Subtitle` : For subtitles `word` : To highlight From b8748bc418eeaba44869c4b93aed7d3a1ec02a39 Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Wed, 1 Mar 2023 16:14:20 +0100 Subject: [PATCH 2507/3075] To prevent the code text from sticking out of the div. --- _sass/layout/type-md.scss | 1 + 1 file changed, 1 insertion(+) diff --git a/_sass/layout/type-md.scss b/_sass/layout/type-md.scss index 4cf5c57b3a..9d3b252d1f 100755 --- a/_sass/layout/type-md.scss +++ b/_sass/layout/type-md.scss @@ -172,6 +172,7 @@ color: #859900; @include border-radius($border-radius-medium); padding: 2px 6px; + word-wrap: break-word; } } From de8a49c27ebdda809e354279f1e36d04a6e38c00 Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Thu, 2 Mar 2023 14:31:43 +0100 Subject: [PATCH 2508/3075] Corrections: Titles, explanation and nints --- _overviews/scala3-scaladoc/blog.md | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index 1aff76fb55..2f6b6b0f68 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -33,9 +33,9 @@ Scaladoc loads blog if the `_blog` directory exists. All the blogpost filenames should start with date in numeric format matching `YYYY-MM-DD`. Example name is `2015-10-23-dotty-compiler-bootstraps.md`. -## Structure +## Page metadata -When creating a blog page, you will have a first part to fill in with different fields. See the following example: +The blog pages in scaladoc support [Yaml Frontmatter](https://assemble.io/docs/YAML-front-matter.html) which allows you to specify different values which will be used for metadata in your page. Here are the possible fields: ``` --- @@ -43,19 +43,25 @@ layout: <A reference to the layout page for the blog page> author: <Name of the author of the page> title: <Title of the page> subTitle: <Subtitle of the page> -excerpt_separator: <!--more--> -date: <Date of the creation of the page> +date: <Date of the creation of the page>, e.g. 2016-12-05 authorImg: <Link to the author's image> --- -<Content> +<Content of your page> ``` +<!-- Here is an example of a blogpost page with the fields: +![Blog page](https://assets.digitalocean.com/articles/alligator/boo.svg "Scaladoc blog page") --> + ## Special characters for the content -` ```<content>``` ` : For code +` ```<content>``` ` : Multiline code block +You can also specify a language type. +` ```scala <content>``` ` + +`# Title` : For titles `## Subtitle` : For subtitles -`word` : To highlight +`word` : For inline code. `[word](Link to a website)`: If you want to put a link in a word \ No newline at end of file From 2fbf7171c7fae0b7228eab15ac19d7fa0b0a8ea6 Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Thu, 2 Mar 2023 14:55:44 +0100 Subject: [PATCH 2509/3075] Correction --- _overviews/scala3-scaladoc/blog.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index 2f6b6b0f68..6d04cbd889 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -55,8 +55,7 @@ authorImg: <Link to the author's image> ## Special characters for the content ` ```<content>``` ` : Multiline code block -You can also specify a language type. -` ```scala <content>``` ` +You can also specify a language type, ` ```scala <content>``` ` `# Title` : For titles From eb6c0cdfc5133b5bdab32a8a66528d83004e8ff7 Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Thu, 2 Mar 2023 16:50:04 +0100 Subject: [PATCH 2510/3075] Overflow instead of breakwork --- _sass/layout/documentation.scss | 1 + _sass/layout/type-md.scss | 1 - 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/_sass/layout/documentation.scss b/_sass/layout/documentation.scss index 66d4d33c7a..cf9f242996 100644 --- a/_sass/layout/documentation.scss +++ b/_sass/layout/documentation.scss @@ -46,6 +46,7 @@ p { line-height: 1.5; + overflow: scroll; } ol { diff --git a/_sass/layout/type-md.scss b/_sass/layout/type-md.scss index 9d3b252d1f..4cf5c57b3a 100755 --- a/_sass/layout/type-md.scss +++ b/_sass/layout/type-md.scss @@ -172,7 +172,6 @@ color: #859900; @include border-radius($border-radius-medium); padding: 2px 6px; - word-wrap: break-word; } } From 968df5cdcdba06fe806b25199d37f91bc89b2b60 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Fri, 3 Mar 2023 02:01:58 +0000 Subject: [PATCH 2511/3075] Update SIPs state --- _sips/sips/quote-pattern-explicit-type-variable-syntax.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/quote-pattern-explicit-type-variable-syntax.md diff --git a/_sips/sips/quote-pattern-explicit-type-variable-syntax.md b/_sips/sips/quote-pattern-explicit-type-variable-syntax.md new file mode 100644 index 0000000000..9b2f0dcb9d --- /dev/null +++ b/_sips/sips/quote-pattern-explicit-type-variable-syntax.md @@ -0,0 +1,7 @@ +--- +title: SIP-53 - Quote Pattern Explicit Type Variable Syntax +status: under-review +pull-request-number: 59 +stage: design + +--- From bf90820c967f64fe5abf02b89855191dff9f13f0 Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Mon, 6 Mar 2023 09:56:56 +0100 Subject: [PATCH 2512/3075] Increase the number of search results --- resources/js/functions.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/resources/js/functions.js b/resources/js/functions.js index c31e52b22e..ed735f6a96 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -338,7 +338,7 @@ $(document).ready(function() { resultsContainer: document.getElementById('result-container'), json: '/resources/json/search.json', searchResultTemplate: '<li><a href="{url}">{title}</a></li>', - limit: 5, + limit: 7, }); $("#blog-search-bar").on("change paste keyup", function() { From 41a99c236a16140e2207d139f102ad9288bbd5cd Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Mon, 6 Mar 2023 10:14:17 +0100 Subject: [PATCH 2513/3075] Delete comment --- _overviews/scala3-scaladoc/blog.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index 6d04cbd889..72175b09bf 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -49,9 +49,6 @@ authorImg: <Link to the author's image> <Content of your page> ``` -<!-- Here is an example of a blogpost page with the fields: -![Blog page](https://assets.digitalocean.com/articles/alligator/boo.svg "Scaladoc blog page") --> - ## Special characters for the content ` ```<content>``` ` : Multiline code block From 6e89d610128a6686fec9421b6818d4edec838bce Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Mon, 6 Mar 2023 11:19:15 +0100 Subject: [PATCH 2514/3075] Corrections of some nits Corrections of some nits Correction of nits Corrections text correction --- _overviews/scala3-scaladoc/blog.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index 72175b09bf..ca822c10d5 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -50,14 +50,16 @@ authorImg: <Link to the author's image> ``` ## Special characters for the content +Keep in mind that the writing of your blog `<content>` is done with regular markdowns but here are some useful examples: -` ```<content>``` ` : Multiline code block -You can also specify a language type, ` ```scala <content>``` ` +` ```<content>``` ` : Multiline code block. -`# Title` : For titles +You can also specify a language type, ` ```scala <content>``` `. -`## Subtitle` : For subtitles +`# Title` : For titles. + +`## Subtitle` : For subtitles. `word` : For inline code. -`[word](Link to a website)`: If you want to put a link in a word \ No newline at end of file +`[name](Link to a website)`: If you want to put a link in the word. \ No newline at end of file From bcb29e7577627699527701dc801804003cb8968b Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Mon, 6 Mar 2023 17:51:49 -0600 Subject: [PATCH 2515/3075] FAQ: add another link to the context bounds answer --- _overviews/FAQ/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 4c65c0b734..ca4538daae 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -153,7 +153,7 @@ See the [Scala 2.13 Collections Guide](https://docs.scala-lang.org/overviews/col It's syntactic sugar for a context parameter (an `implicit` parameter in Scala 2, or a `using` parameter in Scala 3). -More details in this [Stack Overflow answer](https://stackoverflow.com/a/4467012). +More details in this [section of the Scala 3 Book](https://docs.scala-lang.org/scala3/book/ca-context-bounds.html) and this [Stack Overflow answer](https://stackoverflow.com/a/4467012). ### How does `for / yield` work? From d7cd44870eae8dbdf67db7412340c6cbc316a08e Mon Sep 17 00:00:00 2001 From: Lucas Leblanc <44496264+Dedelweiss@users.noreply.github.com> Date: Wed, 8 Mar 2023 11:31:11 +0100 Subject: [PATCH 2516/3075] Remover border for code lines in comparison page (#2721) * Remove border for td and th * Supress border * Remove border style for code elements * Delete weird lines in gem locks --- _overviews/scala3-book/scala4x.css | 7 +------ _sass/layout/type-md.scss | 18 ++++++++++++------ 2 files changed, 13 insertions(+), 12 deletions(-) diff --git a/_overviews/scala3-book/scala4x.css b/_overviews/scala3-book/scala4x.css index c7d34705bb..1772c03ac8 100644 --- a/_overviews/scala3-book/scala4x.css +++ b/_overviews/scala3-book/scala4x.css @@ -10,12 +10,7 @@ background: #fdfdf7; border-collapse: collapse; } -.content-primary .scala3-comparison-page th, -.content-primary .scala3-comparison-page td -{ - border-top: 1px solid #E5EAEA; - border-bottom: 1px solid #E5EAEA; -} + .content-primary .scala3-comparison-page table td.python-block, .content-primary .scala3-comparison-page table td.java-block, .content-primary .scala3-comparison-page table td.javascript-block, diff --git a/_sass/layout/type-md.scss b/_sass/layout/type-md.scss index 4cf5c57b3a..88b98e8fd6 100755 --- a/_sass/layout/type-md.scss +++ b/_sass/layout/type-md.scss @@ -149,8 +149,6 @@ li, p, - tr, - td, dt, dd, pre { @@ -162,8 +160,6 @@ li, p, - tr, - td, dt, dd { code { @@ -175,6 +171,16 @@ } } + tr, + td{ + code { + font-family: 'Consolas'; + font-size: 0.9375rem; + } + } + + + pre { code { overflow-x: auto; @@ -195,8 +201,8 @@ td, th { - border-bottom: $base-border-gray; - padding: 6px 0; + border: $base-border-gray; + padding: 6px; } } From d97609cbc1315a1a7a02a765a4bbe5b4585c7482 Mon Sep 17 00:00:00 2001 From: Som Snytt <som.snytt@gmail.com> Date: Thu, 9 Mar 2023 01:12:57 -0800 Subject: [PATCH 2517/3075] Update some compiler options --- _overviews/scala3-migration/options-intro.md | 2 +- _overviews/scala3-migration/options-lookup.md | 32 +++++++++---------- 2 files changed, 17 insertions(+), 17 deletions(-) diff --git a/_overviews/scala3-migration/options-intro.md b/_overviews/scala3-migration/options-intro.md index be7223a02e..06b7c245a9 100644 --- a/_overviews/scala3-migration/options-intro.md +++ b/_overviews/scala3-migration/options-intro.md @@ -18,4 +18,4 @@ To do so you can refer to the [Lookup Table](options-lookup.html). You can also discover the new Scala 3 compiler options, that have no equivalent in Scala 2.13, in the [New Compiler Options](options-new.html) page. -For scaladoc settings reference and their compatibility with Scala2 scaladoc, read [Scaladoc settings compatibility between Scala2 and Scala3](scaladoc-settings-compatibility.html) page. +For Scaladoc settings reference and their compatibility with Scala2 Scaladoc, read [Scaladoc settings compatibility between Scala2 and Scala3](scaladoc-settings-compatibility.html) page. diff --git a/_overviews/scala3-migration/options-lookup.md b/_overviews/scala3-migration/options-lookup.md index 062166b176..ab82b28ead 100644 --- a/_overviews/scala3-migration/options-lookup.md +++ b/_overviews/scala3-migration/options-lookup.md @@ -14,19 +14,19 @@ Each Scala 2.13 option is associated with its status in Scala 3. |-|-| | <i class="fa fa-check fa-lg"></i> | it is available in Scala 3 | | `<new-name>` | It has been renamed to `<new-name>` | -| <i class="fa fa-times fa-lg"></i> | It is not available in 3.0.0 but it could be added later | +| <i class="fa fa-times fa-lg"></i> | It is not yet available could be added later | -> The current comparison is based on Scala 2.13.4 and 3.0.0-M3. +> The current comparison is based on Scala 2.13.10 and 3.3.0. ## Standard Settings -| 2.13.x | 3.0.x | +| 2.13.x | 3.3.x | |-|-| -| `-Dproperty=value` | <i class="fa fa-times fa-lg"></i> | -| `-J<flag>` | <i class="fa fa-times fa-lg"></i> | +| `-Dproperty=value` | <i class="fa fa-check fa-lg"></i> | +| `-J<flag>` | <i class="fa fa-check fa-lg"></i> | | `-P:<plugin>:<opt>` |<i class="fa fa-check fa-lg"></i>| -| `-V` | <i class="fa fa-times fa-lg"></i> | -| `-W` | <i class="fa fa-times fa-lg"></i> | +| `-V` | <i class="fa fa-check fa-lg"></i> | +| `-W` | <i class="fa fa-check fa-lg"></i> | | `-X` |<i class="fa fa-check fa-lg"></i>| | `-Y` |<i class="fa fa-check fa-lg"></i>| | `-bootclasspath` |<i class="fa fa-check fa-lg"></i>| @@ -186,9 +186,10 @@ Each Scala 2.13 option is associated with its status in Scala 3. Verbose settings were introduced in 2.13. Most of them are not yet implemented in Scala 3. -| 2.13.x | 3.0.x | +| 2.13.x | 3.3.x | |-|-| | `-Vbrowse:<phases>` | <i class="fa fa-times fa-lg"></i> | +| `-Vclasspath` | `-Ylog-classpath` | | `-Vdebug-tasty` | <i class="fa fa-times fa-lg"></i> | | `-Vdoc` | <i class="fa fa-times fa-lg"></i> | | `-Vfree-terms` | <i class="fa fa-times fa-lg"></i> | @@ -203,10 +204,9 @@ Most of them are not yet implemented in Scala 3. | `-Vmacro-lite` | <i class="fa fa-times fa-lg"></i> | | `-Vopt <package/Class.method>` | <i class="fa fa-times fa-lg"></i> | | `-Vpatmat` | <i class="fa fa-times fa-lg"></i> | +| `-Vphases` | <i class="fa fa-check fa-lg"></i> | | `-Vpos`| <i class="fa fa-times fa-lg"></i> | -| `-Vprint:<phases>` | `-Xprint:<phases>` | -| `-Vphases` | `-Xshow-phases` | -| `-Vclasspath` | `-Ylog-classpath` | +| `-Vprint:<phases>` | <i class="fa fa-check fa-lg"></i> | | `-Vlog:<phases>` | `-Ylog:<phases>`| | `-Vdebug` | `-Ydebug` | | `-Vprint-args <file>` | <i class="fa fa-times fa-lg"></i> | @@ -230,17 +230,17 @@ Most of them are not yet implemented in Scala 3. Warning settings were introduced in 2.13. Most of them are not yet implemented in Scala 3. -| 2.13.x | 3.0.x | +| 2.13.x | 3.3.x | |-|-| -| `-Wconf` | <i class="fa fa-times fa-lg"></i> | +| `-Wconf` | <i class="fa fa-check fa-lg"></i> | | `-Wdead-code` | <i class="fa fa-times fa-lg"></i> | -| `-Werror` | `-Xfatal-warnings` | +| `-Werror` | <i class="fa fa-check fa-lg"></i> | | `-Wextra-implicit` | <i class="fa fa-times fa-lg"></i> | | `-Wmacros:<mode>` | <i class="fa fa-times fa-lg"></i> | | `-Wnumeric-widen` | <i class="fa fa-times fa-lg"></i> | | `-Woctal-literal` | <i class="fa fa-times fa-lg"></i> | -| `-Wunused:<warnings>` | <i class="fa fa-times fa-lg"></i> | -| `-Wvalue-discard`| <i class="fa fa-times fa-lg"></i> | +| `-Wunused:<warnings>` | <i class="fa fa-check fa-lg"></i> | +| `-Wvalue-discard`| <i class="fa fa-check fa-lg"></i> | | `-Wself-implicit` | <i class="fa fa-times fa-lg"></i> | ## Compiler Plugins From c7fa31ee575b2fe55b3f7c52da7d56f1034a55da Mon Sep 17 00:00:00 2001 From: Som Snytt <som.snytt@gmail.com> Date: Thu, 9 Mar 2023 16:42:07 -0800 Subject: [PATCH 2518/3075] Additional tweaks and ordering --- _overviews/scala3-migration/options-intro.md | 2 +- _overviews/scala3-migration/options-lookup.md | 207 +++++++++--------- 2 files changed, 102 insertions(+), 107 deletions(-) diff --git a/_overviews/scala3-migration/options-intro.md b/_overviews/scala3-migration/options-intro.md index 06b7c245a9..e5a831917a 100644 --- a/_overviews/scala3-migration/options-intro.md +++ b/_overviews/scala3-migration/options-intro.md @@ -16,6 +16,6 @@ To do so you can refer to the [Lookup Table](options-lookup.html). > Passing an unavailable option to the Scala 3 compiler does not make it fail. > It just prints a warning and ignores the option. -You can also discover the new Scala 3 compiler options, that have no equivalent in Scala 2.13, in the [New Compiler Options](options-new.html) page. +You can also discover the new Scala 3 compiler options, which have no equivalent in Scala 2.13, in the [New Compiler Options](options-new.html) page. For Scaladoc settings reference and their compatibility with Scala2 Scaladoc, read [Scaladoc settings compatibility between Scala2 and Scala3](scaladoc-settings-compatibility.html) page. diff --git a/_overviews/scala3-migration/options-lookup.md b/_overviews/scala3-migration/options-lookup.md index ab82b28ead..3bca1de23a 100644 --- a/_overviews/scala3-migration/options-lookup.md +++ b/_overviews/scala3-migration/options-lookup.md @@ -7,14 +7,27 @@ previous-page: options-intro next-page: options-new --- -The compiler options are classified and ordered according to their Scala 2.13 name. -Each Scala 2.13 option is associated with its status in Scala 3. +This table lists the Scala 2.13 compiler options with their equivalent in Scala 3. +Some options have cross-version support, such as `-Vprint`. +Others have a close equivalent with a different name. A number of Scala 2 options +have no equivalent in Scala 3, such as options for debugging Scala 2 macros. + +The compiler options are shown as displayed by the help output `scalac -help`, `scalac -X`, etc. +A few aliases are shown here, but most older aliases, such as `-Xprint` for `-Vprint`, +or `-Ytyper-debug` for `-Vtyper`, are listed by the latest name. + +The option groups `-V` and `-W` were introduced in Scala 2.13, for "verbose" options that +request additional diagnostic output and "warnings" that request additional checks which +may or may not indicate errors in code. `-Werror` elevates warnings to errors, and `-Wconf` +allows precise control over warnings by either ignoring them or taking them as errors. +The configuration string for `-Wconf` will likely require adjustment when migrating to Scala 3, +since the configuration syntax and the error messages it matches are different. | Status | Meaning | |-|-| -| <i class="fa fa-check fa-lg"></i> | it is available in Scala 3 | -| `<new-name>` | It has been renamed to `<new-name>` | -| <i class="fa fa-times fa-lg"></i> | It is not yet available could be added later | +| <i class="fa fa-check fa-lg"></i> | It is available in Scala 3. | +| `<new-name>` | It has been renamed to `<new-name>`. | +| <i class="fa fa-times fa-lg"></i> | It is not yet available but could be added later. | > The current comparison is based on Scala 2.13.10 and 3.3.0. @@ -63,11 +76,74 @@ Each Scala 2.13 option is associated with its status in Scala 3. | `-verbose` |<i class="fa fa-check fa-lg"></i>| | `-version` |<i class="fa fa-check fa-lg"></i>| +## Verbose Settings + +| 2.13.x | 3.3.x | +|-|-| +| `-Vbrowse:<phases>` | <i class="fa fa-times fa-lg"></i> | +| `-Vclasspath` | `-Ylog-classpath` | +| `-Vdebug` | `-Ydebug` | +| `-Vdebug-tasty` | <i class="fa fa-times fa-lg"></i> | +| `-Vdebug-type-error` | <i class="fa fa-times fa-lg"></i> | +| `-Vdoc` | <i class="fa fa-times fa-lg"></i> | +| `-Vfree-terms` | <i class="fa fa-times fa-lg"></i> | +| `-Vfree-types` | <i class="fa fa-times fa-lg"></i> | +| `-Vhot-statistics`| <i class="fa fa-times fa-lg"></i> | +| `-Vide`| <i class="fa fa-times fa-lg"></i> | +| `-Vimplicit-conversions`| <i class="fa fa-times fa-lg"></i> | +| `-Vimplicits`| <i class="fa fa-times fa-lg"></i> | +| `-Vimplicits-max-refined`| <i class="fa fa-times fa-lg"></i> | +| `-Vimplicits-verbose-tree`| <i class="fa fa-times fa-lg"></i> | +| `-Vinline <package/Class.method>` | <i class="fa fa-times fa-lg"></i> | +| `-Vlog:<phases>` | `-Ylog:<phases>`| +| `-Vmacro` | <i class="fa fa-times fa-lg"></i> | +| `-Vmacro-lite` | <i class="fa fa-times fa-lg"></i> | +| `-Vopt <package/Class.method>` | <i class="fa fa-times fa-lg"></i> | +| `-Vpatmat` | <i class="fa fa-times fa-lg"></i> | +| `-Vphases` | <i class="fa fa-check fa-lg"></i> | +| `-Vpos`| <i class="fa fa-times fa-lg"></i> | +| `-Vprint:<phases>` | <i class="fa fa-check fa-lg"></i> | +| `-Vprint-args <file>` | <i class="fa fa-times fa-lg"></i> | +| `-Vprint-pos` | `-Yprint-pos` | +| `-Vprint-types` | `-Xprint-types` | +| `-Vquasiquote` | <i class="fa fa-times fa-lg"></i> | +| `-Vreflective-calls` | <i class="fa fa-times fa-lg"></i> | +| `-Vreify` | <i class="fa fa-times fa-lg"></i> | +| `-Vshow:<phases>` | <i class="fa fa-times fa-lg"></i> | +| `-Vshow-class <class>` | <i class="fa fa-times fa-lg"></i> | +| `-Vshow-member-pos <output style>` | <i class="fa fa-times fa-lg"></i> | +| `-Vshow-object <object>` | <i class="fa fa-times fa-lg"></i> | +| `-Vshow-symkinds` | <i class="fa fa-times fa-lg"></i> | +| `-Vshow-symowners` | <i class="fa fa-times fa-lg"></i> | +| `-Vstatistics <phases>` | <i class="fa fa-times fa-lg"></i> | +| `-Vsymbols` | <i class="fa fa-times fa-lg"></i> | +| `-Vtype-diffs` | <i class="fa fa-times fa-lg"></i> | +| `-Vtyper` | <i class="fa fa-times fa-lg"></i> | + +## Warning Settings + +| 2.13.x | 3.3.x | +|-|-| +| `-Wconf` | <i class="fa fa-check fa-lg"></i> | +| `-Wdead-code` | <i class="fa fa-times fa-lg"></i> | +| `-Werror` | <i class="fa fa-check fa-lg"></i> | +| `-Wextra-implicit` | <i class="fa fa-times fa-lg"></i> | +| `-Wmacros:<mode>` | <i class="fa fa-times fa-lg"></i> | +| `-Wnonunit-if` | <i class="fa fa-times fa-lg"></i> | +| `-Wnonunit-statement` | <i class="fa fa-check fa-lg"></i> | +| `-Wnumeric-widen` | <i class="fa fa-times fa-lg"></i> | +| `-Woctal-literal` | <i class="fa fa-times fa-lg"></i> | +| `-Wopt` | <i class="fa fa-times fa-lg"></i> | +| `-Wperformance` | <i class="fa fa-times fa-lg"></i> | +| `-Wself-implicit` | <i class="fa fa-times fa-lg"></i> | +| `-Wunused:<warnings>` | <i class="fa fa-check fa-lg"></i> | +| `-Wvalue-discard`| <i class="fa fa-check fa-lg"></i> | + ## Advanced Settings -| 2.13.x | 3.0.x | +| 2.13.x | 3.3.x | |-|-| -| `-X` |<i class="fa fa-check fa-lg"></i>| +| `-Xasync` | <i class="fa fa-times fa-lg"></i> | | `-Xcheckinit` | `-Ycheck-init` | | `-Xdev` | <i class="fa fa-times fa-lg"></i> | | `-Xdisable-assertions` | <i class="fa fa-times fa-lg"></i> | @@ -78,30 +154,25 @@ Each Scala 2.13 option is associated with its status in Scala 3. | `-Xjline` | <i class="fa fa-times fa-lg"></i> | | `-Xlint:deprecation` | `-deprecation` | | `-Xlint:<warnings>` | <i class="fa fa-times fa-lg"></i> | -| `-Xlog-implicit-conversion` | <i class="fa fa-times fa-lg"></i> | -| `-Xlog-implicits` | <i class="fa fa-times fa-lg"></i> | -| `-Xlog-reflective-calls` | <i class="fa fa-times fa-lg"></i> | | `-Xmacro-settings` | <i class="fa fa-times fa-lg"></i> | | `-Xmain-class` | <i class="fa fa-times fa-lg"></i> | | `-Xmaxerrs` | <i class="fa fa-times fa-lg"></i> | | `-Xmaxwarns` | <i class="fa fa-times fa-lg"></i> | -| `-Xmigration` |<i class="fa fa-check fa-lg"></i>| -| `-Xmixin-force-forwarders` |<i class="fa fa-check fa-lg"></i>| +| `-Xmigration` |<i class="fa fa-check fa-lg"></i>| +| `-Xmixin-force-forwarders` |<i class="fa fa-check fa-lg"></i>| | `-Xno-forwarders` |<i class="fa fa-check fa-lg"></i>| | `-Xno-patmat-analysis` | <i class="fa fa-times fa-lg"></i> | +| `-Xnon-strict-patmat-analysis` | <i class="fa fa-times fa-lg"></i> | | `-Xnojline` | <i class="fa fa-times fa-lg"></i> | -| `-Xplugin` |<i class="fa fa-check fa-lg"></i>| -| `-Xplugin-disable` |<i class="fa fa-check fa-lg"></i>| -| `-Xplugin-list` |<i class="fa fa-check fa-lg"></i>| -| `-Xplugin-require` |<i class="fa fa-check fa-lg"></i>| +| `-Xplugin` |<i class="fa fa-check fa-lg"></i>| +| `-Xplugin-disable` |<i class="fa fa-check fa-lg"></i>| +| `-Xplugin-list` |<i class="fa fa-check fa-lg"></i>| +| `-Xplugin-require` |<i class="fa fa-check fa-lg"></i>| | `-Xpluginsdir` |<i class="fa fa-check fa-lg"></i>| -| `-Xprint-args` | <i class="fa fa-times fa-lg"></i> | | `-Xprompt` |<i class="fa fa-check fa-lg"></i>| | `-Xreporter` | <i class="fa fa-times fa-lg"></i> | | `-Xresident` | <i class="fa fa-times fa-lg"></i> | | `-Xscript` | <i class="fa fa-times fa-lg"></i> | -| `-Xshow-class <class>` | <i class="fa fa-times fa-lg"></i> | -| `-Xshow-object <object>` | <i class="fa fa-times fa-lg"></i> | | `-Xsource` | `-source` | | `-Xsource-reader` | <i class="fa fa-times fa-lg"></i> | | `-Xverify` | `-Xverify-signatures` | @@ -121,14 +192,10 @@ Each Scala 2.13 option is associated with its status in Scala 3. | `-Ydelambdafy` | <i class="fa fa-times fa-lg"></i> | | `-Ydump-classes` |<i class="fa fa-check fa-lg"></i>| | `-Ygen-asmp` | <i class="fa fa-times fa-lg"></i> | -| `-Yhot-statistics` | <i class="fa fa-times fa-lg"></i> | -| `-Yide-debug` | <i class="fa fa-times fa-lg"></i> | | `-Yimports` | <i class="fa fa-times fa-lg"></i> | | `-Yissue-debug` | <i class="fa fa-times fa-lg"></i> | | `-Yjar-compression-level` | <i class="fa fa-times fa-lg"></i> | | `-YjarFactory` | <i class="fa fa-times fa-lg"></i> | -| `-Ymacro-debug-lite` | <i class="fa fa-times fa-lg"></i> | -| `-Ymacro-debug-verbose` | <i class="fa fa-times fa-lg"></i> | | `-Ymacro-annotations` | <i class="fa fa-times fa-lg"></i> | | `-Ymacro-classpath` | <i class="fa fa-times fa-lg"></i> | | `-Ymacro-expand` | <i class="fa fa-times fa-lg"></i> | @@ -139,109 +206,37 @@ Each Scala 2.13 option is associated with its status in Scala 3. | `-Yno-imports` |<i class="fa fa-check fa-lg"></i>| | `-Yno-predef` |<i class="fa fa-check fa-lg"></i>| | `-Yopt-inline-heuristics` | <i class="fa fa-times fa-lg"></i> | -| `-Yopt-log-inline <package/Class.method>` | <i class="fa fa-times fa-lg"></i> | -| `-Yopt-trace <package/Class.method>` | <i class="fa fa-times fa-lg"></i> | -| `-Ypatmat-debug` | <i class="fa fa-times fa-lg"></i> | | `-Ypatmat-exhaust-depth` | <i class="fa fa-times fa-lg"></i> | -| `-Ypos-debug` | <i class="fa fa-times fa-lg"></i> | | `-Ypresentation-any-thread` | <i class="fa fa-times fa-lg"></i> | | `-Ypresentation-debug` | <i class="fa fa-times fa-lg"></i> | | `-Ypresentation-delay` | <i class="fa fa-times fa-lg"></i> | | `-Ypresentation-locate-source-file` | <i class="fa fa-times fa-lg"></i> | | `-Ypresentation-log` | <i class="fa fa-times fa-lg"></i> | +| `-Ypresentation-replay` | <i class="fa fa-times fa-lg"></i> | | `-Ypresentation-strict` | <i class="fa fa-times fa-lg"></i> | | `-Ypresentation-verbose` | <i class="fa fa-times fa-lg"></i> | | `-Yprint-trees` | <i class="fa fa-times fa-lg"></i> | -| `-Yprofile-destination` |<i class="fa fa-check fa-lg"></i>| +| `-Yprofile-destination` |<i class="fa fa-check fa-lg"></i>| | `-Yprofile-enabled` |<i class="fa fa-check fa-lg"></i>| +| `-Yprofile-external-tool` |<i class="fa fa-check fa-lg"></i>| +| `-Yprofile-run-gc` |<i class="fa fa-check fa-lg"></i>| | `-Yprofile-trace` | <i class="fa fa-times fa-lg"></i> | -| `-Yquasiquote-debug` | <i class="fa fa-times fa-lg"></i> | | `-Yrangepos` | <i class="fa fa-times fa-lg"></i> | | `-Yrecursion` | <i class="fa fa-times fa-lg"></i> | | `-Yreify-copypaste` | <i class="fa fa-times fa-lg"></i> | -| `-Yreify-debug` | <i class="fa fa-times fa-lg"></i> | | `-Yrepl-class-based` | <i class="fa fa-times fa-lg"></i> | | `-Yrepl-outdir` | <i class="fa fa-times fa-lg"></i> | | `-Yrepl-use-magic-imports` | <i class="fa fa-times fa-lg"></i> | | `-Yresolve-term-conflict` |<i class="fa fa-check fa-lg"></i>| +| `-Yscala3-implicit-resolution` | <i class="fa fa-times fa-lg"></i> | | `-Yscriptrunner` | <i class="fa fa-times fa-lg"></i> | -| `-Yskip` |<i class="fa fa-check fa-lg"></i>| -| `-Yshow:<phases>` | <i class="fa fa-times fa-lg"></i> | -| `-Yshow-member-pos <output style>` | <i class="fa fa-times fa-lg"></i> | -| `-Yshow-symkinds` | <i class="fa fa-times fa-lg"></i> | -| `-Yshow-symowners` | <i class="fa fa-times fa-lg"></i> | -| `-Yshow-syms` | <i class="fa fa-times fa-lg"></i> | -| `-Ystatistics <phases>` | <i class="fa fa-times fa-lg"></i> | -| `-Ystop-after` |<i class="fa fa-check fa-lg"></i>| -| `-Ystop-before` |<i class="fa fa-check fa-lg"></i>| -| `-Ytyper-debug` | <i class="fa fa-times fa-lg"></i> | +| `-Yskip` |<i class="fa fa-check fa-lg"></i>| +| `-Ystop-after` |<i class="fa fa-check fa-lg"></i>| +| `-Ystop-before` |<i class="fa fa-check fa-lg"></i>| +| `-Ytasty-no-annotations` | <i class="fa fa-times fa-lg"></i> | +| `-Ytasty-reader` | <i class="fa fa-times fa-lg"></i> | +| `-Ytrack-dependencies` | <i class="fa fa-times fa-lg"></i> | | `-Yvalidate-pos` | <i class="fa fa-times fa-lg"></i> | -| `-Ywarn-dead-code` | <i class="fa fa-times fa-lg"></i> | -| `-Ywarn-numeric-widen` | <i class="fa fa-times fa-lg"></i> | -| `-Ywarn-unused:<warnings>` | <i class="fa fa-times fa-lg"></i> | -| `-Ywarn-value-discard` | <i class="fa fa-times fa-lg"></i> | - -## Verbose Settings - -Verbose settings were introduced in 2.13. -Most of them are not yet implemented in Scala 3. - -| 2.13.x | 3.3.x | -|-|-| -| `-Vbrowse:<phases>` | <i class="fa fa-times fa-lg"></i> | -| `-Vclasspath` | `-Ylog-classpath` | -| `-Vdebug-tasty` | <i class="fa fa-times fa-lg"></i> | -| `-Vdoc` | <i class="fa fa-times fa-lg"></i> | -| `-Vfree-terms` | <i class="fa fa-times fa-lg"></i> | -| `-Vfree-types` | <i class="fa fa-times fa-lg"></i> | -| `-Vhot-statistics`| <i class="fa fa-times fa-lg"></i> | -| `-Vide`| <i class="fa fa-times fa-lg"></i> | -| `-Vimplicit-conversions`| <i class="fa fa-times fa-lg"></i> | -| `-Vimplicits`| <i class="fa fa-times fa-lg"></i> | -| `-Vinline <package/Class.method>` | <i class="fa fa-times fa-lg"></i> | -| `-Vissue`| <i class="fa fa-times fa-lg"></i> | -| `-Vmacro` | <i class="fa fa-times fa-lg"></i> | -| `-Vmacro-lite` | <i class="fa fa-times fa-lg"></i> | -| `-Vopt <package/Class.method>` | <i class="fa fa-times fa-lg"></i> | -| `-Vpatmat` | <i class="fa fa-times fa-lg"></i> | -| `-Vphases` | <i class="fa fa-check fa-lg"></i> | -| `-Vpos`| <i class="fa fa-times fa-lg"></i> | -| `-Vprint:<phases>` | <i class="fa fa-check fa-lg"></i> | -| `-Vlog:<phases>` | `-Ylog:<phases>`| -| `-Vdebug` | `-Ydebug` | -| `-Vprint-args <file>` | <i class="fa fa-times fa-lg"></i> | -| `-Vprint-pos` | `-Yprint-pos` | -| `-Vprint-types` | `-Xprint-types` | -| `-Vquasiquote` | <i class="fa fa-times fa-lg"></i> | -| `-Vreflective-calls` | <i class="fa fa-times fa-lg"></i> | -| `-Vreify` | <i class="fa fa-times fa-lg"></i> | -| `-Vshow:<phases>` | <i class="fa fa-times fa-lg"></i> | -| `-Vshow-class <class>` | <i class="fa fa-times fa-lg"></i> | -| `-Vshow-member-pos <output style>` | <i class="fa fa-times fa-lg"></i> | -| `-Vshow-object <object>` | <i class="fa fa-times fa-lg"></i> | -| `-Vshow-symkinds` | <i class="fa fa-times fa-lg"></i> | -| `-Vshow-symowners` | <i class="fa fa-times fa-lg"></i> | -| `-Vstatistics <phases>` | <i class="fa fa-times fa-lg"></i> | -| `-Vsymbols` | <i class="fa fa-times fa-lg"></i> | -| `-Vtyper` | <i class="fa fa-times fa-lg"></i> | - -## Warning Settings - -Warning settings were introduced in 2.13. -Most of them are not yet implemented in Scala 3. - -| 2.13.x | 3.3.x | -|-|-| -| `-Wconf` | <i class="fa fa-check fa-lg"></i> | -| `-Wdead-code` | <i class="fa fa-times fa-lg"></i> | -| `-Werror` | <i class="fa fa-check fa-lg"></i> | -| `-Wextra-implicit` | <i class="fa fa-times fa-lg"></i> | -| `-Wmacros:<mode>` | <i class="fa fa-times fa-lg"></i> | -| `-Wnumeric-widen` | <i class="fa fa-times fa-lg"></i> | -| `-Woctal-literal` | <i class="fa fa-times fa-lg"></i> | -| `-Wunused:<warnings>` | <i class="fa fa-check fa-lg"></i> | -| `-Wvalue-discard`| <i class="fa fa-check fa-lg"></i> | -| `-Wself-implicit` | <i class="fa fa-times fa-lg"></i> | ## Compiler Plugins From 8273b8a8e8eb6b01f06b5b15c6300ca5772aca84 Mon Sep 17 00:00:00 2001 From: Lucas Leblanc <44496264+Dedelweiss@users.noreply.github.com> Date: Fri, 10 Mar 2023 08:32:30 +0100 Subject: [PATCH 2519/3075] Add code tabs to Syntactic Changes (#2722) --- .../scala3-migration/incompat-syntactic.md | 78 ++++++++++++------- 1 file changed, 48 insertions(+), 30 deletions(-) diff --git a/_overviews/scala3-migration/incompat-syntactic.md b/_overviews/scala3-migration/incompat-syntactic.md index 35846f886f..ddf046940d 100644 --- a/_overviews/scala3-migration/incompat-syntactic.md +++ b/_overviews/scala3-migration/incompat-syntactic.md @@ -38,18 +38,21 @@ It is composed of: - `=>>` - `?=>` -For instance, the following piece of code can be compiled with Scala 2.13 but not wtih Scala 3. +{% tabs scala-2-keywords_1 %} +{% tab 'Scala 2 Only' %} -```scala -object given { // Error: given is now a keyword - val enum = ??? // Error: enum is now a keyword +For instance, the following piece of code can be compiled with Scala 2.13 but not with Scala 3. +~~~ scala +object given { // In Scala 3, Error: given is now a keyword. + val enum = ??? // In Scala 3, Error: enum is now a keyword. - println(enum) // Error: enum is now a keyword + println(enum) // In Scala 3, Error: enum is now a keyword. } -``` +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites the code into: - {% highlight diff %} -object given { +object `given` { @@ -64,18 +67,22 @@ The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites the co ## Procedure Syntax Procedure syntax has been deprecated for a while and it is dropped in Scala 3. -The following pieces of code are now illegal: -```scala +{% tabs scala-2-procedure_1 %} +{% tab 'Scala 2 Only' %} + +The following pieces of code are now illegal: +~~~ scala object Bar { - def print() { // Error: Procedure syntax no longer supported; `: Unit =` should be inserted here + def print() { // In Scala 3, Error: Procedure syntax no longer supported; `: Unit =` should be inserted here. println("bar") } } -``` +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites the code into. - {% highlight diff %} object Bar { - def print() { @@ -90,12 +97,15 @@ object Bar { When followed by its type, the parameter of a lambda is now required to be enclosed in parentheses. The following piece of code is invalid. -```scala -val f = { x: Int => x * x } // Error: parentheses are required around the parameter of a lambda -``` +{% tabs scala-2-lambda_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala +val f = { x: Int => x * x } // In Scala 3, Error: parentheses are required around the parameter of a lambda. +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites the code into: - {% highlight diff %} -val f = { x: Int => x * x } +val f = { (x: Int) => x * x } @@ -106,16 +116,18 @@ The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites the co In Scala 2 it is possible to pass an argument after a new line by enclosing it into braces. Although valid, this style of coding is not encouraged by the [Scala style guide](https://docs.scala-lang.org/style) and is no longer supported in Scala 3. -This syntax is now invalid: -```scala +{% tabs scala-2-brace_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala test("my test") -{ // Error: This opening brace will start a new statement in Scala 3. +{ // In Scala 3, Error: This opening brace will start a new statement. assert(1 == 1) } -``` +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compiler](tooling-migration-mode.html) indents the first line of the block. - {% highlight diff %} test("my test") -{ @@ -135,7 +147,6 @@ type Bar = Foo {% endhighlight %} A preferable solution is to write: - {% highlight diff %} -test("my test") -{ @@ -149,16 +160,20 @@ A preferable solution is to write: The Scala 3 compiler now requires correct indentation. The following piece of code, that was compiled in Scala 2.13, does not compile anymore because of the indentation. -```scala +{% tabs scala-2-indentation_1 %} +{% tab 'Scala 2 Only' %} + +~~~ scala def bar: (Int, Int) = { val foo = 1.0 - val bar = foo // [E050] Type Error: value foo does not take parameters + val bar = foo // [E050] In Scala 3, type Error: value foo does not take parameters. (1, 1) -} // [E007] Type Mismatch Error: Found Unit, Required (Int, Int) -``` +} // [E007] In Scala 3, type Mismatch Error: Found Unit, Required (Int, Int). +~~~ +{% endtab %} +{% endtabs %} The indentation must be fixed. - {% highlight diff %} def bar: (Int, Int) = { val foo = 1.0 @@ -176,10 +191,13 @@ Beware that these tools may change the entire code style of your project. The usage of the `_` identifier as a type parameter is permitted in Scala 2.13, even if it has never been mentioned in the Scala 2 specification. It is used in the API of [fastparse](https://index.scala-lang.org/lihaoyi/fastparse), in combination with a context bound, to declare an implicit parameter. - -```scala +{% tabs scala-2-identifier_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala def foo[_: Foo]: Unit = ??? -``` +~~~ +{% endtab %} +{% endtabs %} Here, the method `foo` takes a type parameter `_` and an implicit parameter of type `Foo[_]` where `_` refers to the type parameter, not the wildcard symbol. From 741cd99f45b2783f4d42ceb15af658a3e0bdaec2 Mon Sep 17 00:00:00 2001 From: Lucas Leblanc <44496264+Dedelweiss@users.noreply.github.com> Date: Fri, 10 Mar 2023 11:21:42 +0100 Subject: [PATCH 2520/3075] Add code tabs to type checker page (#2726) --- .../scala3-migration/incompat-type-checker.md | 30 ++++++++++++++----- 1 file changed, 22 insertions(+), 8 deletions(-) diff --git a/_overviews/scala3-migration/incompat-type-checker.md b/_overviews/scala3-migration/incompat-type-checker.md index 8c111a199f..6c6728d4fa 100644 --- a/_overviews/scala3-migration/incompat-type-checker.md +++ b/_overviews/scala3-migration/incompat-type-checker.md @@ -18,7 +18,9 @@ It is unsound and might cause runtime failures, as demonstrated by this [test](h The Scala 3 compiler does not permit this anymore. -```scala +{% tabs scala-2-unsound_vc_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala class Foo[-A](x: List[A]) { def f[B](y: List[B] = x): Unit = ??? } @@ -26,8 +28,11 @@ class Foo[-A](x: List[A]) { class Outer[+A](x: A) { class Inner(y: A) } -``` +~~~ +{% endtab %} +{% endtabs %} +So if you compile in Scala 3, you will get the following error. {% highlight text %} -- Error: src/main/scala/variance.scala:2:8 2 | def f[B](y: List[B] = x): Unit = y @@ -75,7 +80,9 @@ Scala 3 fixes some unsoundness bugs in pattern matching, preventing some semanti For instance, the match expression in `combineReq` can be compiled with Scala 2.13 but not with Scala 3. -```scala +{% tabs scala-2-unsound_pm_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala trait Request case class Fetch[A](ids: Set[A]) extends Request @@ -88,9 +95,11 @@ object Request { } } } -``` +~~~ +{% endtab %} +{% endtabs %} -The error message is: +In Scala 3, the error message is: {% highlight text %} -- [E007] Type Mismatch Error: src/main/scala/pattern-match.scala:9:59 @@ -100,6 +109,7 @@ The error message is: | Required: Fetch[A$1] {% endhighlight %} + Which is right, there is no proof that `x` and `y` have the same type parameter `A`. Coming from Scala 2, this is clearly an improvement to help us locate mistakes in our code. @@ -108,9 +118,13 @@ It is not always easy and sometimes it is even not possible, in which case the c In this example, we can relax the constraint on `x` and `y` by stating that `A` is a common ancestor of both type arguments. This makes the compiler type-check the code successfully. - -```scala +{% tabs shared-unsound_pm_2 %} +{% tab 'Scala 2 and 3' %} +~~~ scala def combineFetch[A](x: Fetch[_ <: A], y: Fetch[_ <: A]): Fetch[A] = Fetch(x.ids ++ y.ids) -``` +~~~ +{% endtab %} +{% endtabs %} Alternatively, a general but unsafe solution is to cast. + From e08d0fda40eb759cea8c5a05c7289a1d1ff1b7a2 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 10 Mar 2023 11:33:03 +0100 Subject: [PATCH 2521/3075] fix indentation of diff blocks (#2728) there should be a 1 space margin even when there is no line change --- .../scala3-migration/incompat-syntactic.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/_overviews/scala3-migration/incompat-syntactic.md b/_overviews/scala3-migration/incompat-syntactic.md index ddf046940d..31517a5779 100644 --- a/_overviews/scala3-migration/incompat-syntactic.md +++ b/_overviews/scala3-migration/incompat-syntactic.md @@ -61,7 +61,7 @@ The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites the co - println(enum) + println(`enum`) -} + } {% endhighlight %} ## Procedure Syntax @@ -84,12 +84,12 @@ object Bar { The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites the code into. {% highlight diff %} -object Bar { + object Bar { - def print() { + def print(): Unit = { - println("bar") - } -} + println("bar") + } + } {% endhighlight %} ## Parentheses Around Lambda Parameter @@ -129,21 +129,21 @@ test("my test") The [Scala 3 migration compiler](tooling-migration-mode.html) indents the first line of the block. {% highlight diff %} -test("my test") + test("my test") -{ + { - assert(1 == 1) -} + assert(1 == 1) + } {% endhighlight %} This migration rule applies to other patterns as well, such as refining a type after a new line. {% highlight diff %} -type Bar = Foo -- { -+ { - def bar(): Int -} + type Bar = Foo +-{ ++ { + def bar(): Int + } {% endhighlight %} A preferable solution is to write: @@ -151,8 +151,8 @@ A preferable solution is to write: -test("my test") -{ +test("my test") { - assert(1 == 1) -} + assert(1 == 1) + } {% endhighlight %} ## Wrong indentation @@ -175,12 +175,12 @@ def bar: (Int, Int) = { The indentation must be fixed. {% highlight diff %} -def bar: (Int, Int) = { - val foo = 1.0 - val bar = foo + def bar: (Int, Int) = { + val foo = 1.0 + val bar = foo - (1, 1) + (1, 1) -} + } {% endhighlight %} These errors can be prevented by using a Scala formatting tool such as [scalafmt](https://scalameta.org/scalafmt/) or the [IntelliJ Scala formatter](https://www.jetbrains.com/help/idea/reformat-and-rearrange-code.html). From 8411c4469bcba7e240a7ab2f23023066f90e850f Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Fri, 10 Mar 2023 12:15:53 +0100 Subject: [PATCH 2522/3075] Use Coursier release assets rather than coursier/launchers The files in coursier/launchers happen to be less up to date than the release assets. --- _data/setup-scala.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_data/setup-scala.yml b/_data/setup-scala.yml index 4cce17dd0d..ad8db6f598 100644 --- a/_data/setup-scala.yml +++ b/_data/setup-scala.yml @@ -1,6 +1,6 @@ -linux-x86-64: curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup +linux-x86-64: curl -fL https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup linux-arm64: curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup -macOS-x86-64: curl -fL https://github.com/coursier/launchers/raw/master/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup +macOS-x86-64: curl -fL https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup macOS-arm64: curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup macOS-brew: brew install coursier/formulas/coursier && cs setup -windows-link: https://github.com/coursier/launchers/raw/master/cs-x86_64-pc-win32.zip +windows-link: https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-pc-win32.zip From 5b5ebe9232a5b53b12d75cec296c0738667e93ed Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Sat, 11 Mar 2023 19:44:57 +0100 Subject: [PATCH 2523/3075] Change the sentence line 53 --- _overviews/scala3-scaladoc/blog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index ca822c10d5..afcf00738e 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -50,7 +50,7 @@ authorImg: <Link to the author's image> ``` ## Special characters for the content -Keep in mind that the writing of your blog `<content>` is done with regular markdowns but here are some useful examples: +Keep in mind that the writing of your blog is done with classic markdown. So here are some useful examples: ` ```<content>``` ` : Multiline code block. From dece172ca39e82e4bc9f5637007e682c9b1d6a34 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sun, 12 Mar 2023 16:41:41 +0800 Subject: [PATCH 2524/3075] add code tab in _zh-cn/overviews/scala3-book/domain-modeling-fp.md --- .../scala3-book/domain-modeling-fp.md | 346 +++++++++++++++++- 1 file changed, 340 insertions(+), 6 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md index e9f6933cad..11d4779990 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md @@ -25,7 +25,7 @@ permalink: "/zh-cn/scala3/book/:title.html" ## 介绍 -在 FP 中，*数据* 和*对该数据的操作* 是两个独立的东西；您不必像使用 OOP 那样将它们封装在一起。 +在 FP 中，*数据*和*对该数据的操作*是两个独立的东西；您不必像使用 OOP 那样将它们封装在一起。 这个概念类似于数值代数。 当您考虑值大于或等于零的整数时，您有一*组*可能的值，如下所示： @@ -56,12 +56,47 @@ FP设计以类似的方式实现： 在 Scala 中，描述编程问题的数据模型很简单： -- 如果您想使用不同的替代方案对数据进行建模，请使用 枚举 +- 如果您想使用不同的替代方案对数据进行建模，请使用 `enum` 结构，（或者在 Scala 2 中用 `case object`）。 - 如果您只想对事物进行分组（或需要更细粒度的控制），请使用 样例类 ### 描述替代方案 -简单地由不同的选择组成的数据，如面饼大小、面饼类型和馅料，使用 Scala 3 枚举进行简洁的建模： +简单地由不同的选择组成的数据，如面饼大小、面饼类型和馅料，在 Scala 中使用枚举进行简洁的建模： + +{% tabs data_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=data_1 %} + +在 Scala 2 中，一个 `sealed class` 和若干个继承自该类的 `case object` 组合在一起来表示枚举： + +```scala +sealed abstract class CrustSize +object CrustSize { + case object Small extends CrustSize + case object Medium extends CrustSize + case object Large extends CrustSize +} + +sealed abstract class CrustType +object CrustType { + case object Thin extends CrustType + case object Thick extends CrustType + case object Regular extends CrustType +} + +sealed abstract class Topping +object Topping { + case object Cheese extends Topping + case object Pepperoni extends Topping + case object BlackOlives extends Topping + case object GreenOlives extends Topping + case object Onions extends Topping +} +``` + +{% endtab %} +{% tab 'Scala 3' for=data_1 %} + +在 Scala 3 中，用 `enum` 结构简洁地表示： ```scala enum CrustSize: @@ -74,6 +109,9 @@ enum Topping: case Cheese, Pepperoni, BlackOlives, GreenOlives, Onions ``` +{% endtab %} +{% endtabs %} + > 描述不同选择的数据类型（如 `CrustSize`）有时也称为_归纳类型_。 ### 描述复合数据 @@ -81,6 +119,24 @@ enum Topping: 可以将披萨饼视为上述不同属性的_组件_容器。 我们可以使用 样例类来描述 `Pizza` 由 `crustSize`、`crustType` 和可能的多个 `Topping` 组成： +{% tabs data_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=data_2 %} + +```scala +import CrustSize._ +import CrustType._ +import Topping._ + +case class Pizza( + crustSize: CrustSize, + crustType: CrustType, + toppings: Seq[Topping] +) +``` + +{% endtab %} +{% tab 'Scala 3' for=data_2 %} + ```scala import CrustSize.* import CrustType.* @@ -93,6 +149,9 @@ case class Pizza( ) ``` +{% endtab %} +{% endtabs %} + > 聚合多个组件的数据类型（如`Pizza`）有时也称为_乘积类型_。 就是这样。 @@ -101,16 +160,25 @@ case class Pizza( 数据模型易于阅读，就像声明关系数据库的设计一样。 创建数据模型的值并检查它们也很容易： +{% tabs data_3 %} +{% tab 'Scala 2 and 3' for=data_3 %} + ```scala val myFavPizza = Pizza(Small, Regular, Seq(Cheese, Pepperoni)) println(myFavPizza.crustType) // prints Regular ``` +{% endtab %} +{% endtabs %} + #### 更多数据模型 我们可能会以同样的方式对整个披萨订购系统进行建模。 下面是一些用于对此类系统建模的其他 样例类： +{% tabs data_4 %} +{% tab 'Scala 2 and 3' for=data_4 %} + ```scala case class Address( street1: String, @@ -132,6 +200,9 @@ case class Order( ) ``` +{% endtab %} +{% endtabs %} + #### “瘦领域对象（贫血模型）” Debasish Ghosh 在他的《*函数式和反应式领域建模*》一书中指出，OOP 从业者将他们的类描述为封装数据和行为的“富领域模型（充血模型）”，而 FP 数据模型可以被认为是“瘦领域对象”。 @@ -144,6 +215,23 @@ Debasish Ghosh 在他的《*函数式和反应式领域建模*》一书中指出 答案实际上很简单：您只需编写对我们刚刚建模的数据值进行操作的函数（或方法）。 例如，我们可以定义一个计算披萨价格的函数。 +{% tabs data_5 class=tabs-scala-version %} +{% tab 'Scala 2' for=data_5 %} + +```scala +def pizzaPrice(p: Pizza): Double = p match { + case Pizza(crustSize, crustType, toppings) => { + val base = 6.00 + val crust = crustPrice(crustSize, crustType) + val tops = toppings.map(toppingPrice).sum + base + crust + tops + } +} +``` + +{% endtab %} +{% tab 'Scala 3' for=data_5 %} + ```scala def pizzaPrice(p: Pizza): Double = p match case Pizza(crustSize, crustType, toppings) => @@ -153,17 +241,54 @@ def pizzaPrice(p: Pizza): Double = p match base + crust + tops ``` +{% endtab %} +{% endtabs %} + 您注意到函数的实现如何简单地遵循数据的样式：由于 `Pizza` 是一个样例类，我们使用模式匹配来提取组件并调用辅助函数来计算各个部分单独的价格。 +{% tabs data_6 class=tabs-scala-version %} +{% tab 'Scala 2' for=data_6 %} + +```scala +def toppingPrice(t: Topping): Double = t match { + case Cheese | Onions => 0.5 + case Pepperoni | BlackOlives | GreenOlives => 0.75 +} +``` + +{% endtab %} +{% tab 'Scala 3' for=data_6 %} + ```scala def toppingPrice(t: Topping): Double = t match case Cheese | Onions => 0.5 case Pepperoni | BlackOlives | GreenOlives => 0.75 ``` +{% endtab %} +{% endtabs %} + 同样，由于 `Topping` 是一个枚举，我们使用模式匹配来区分不同的变量。 奶酪和洋葱的价格为 50ct，其余的价格为 75ct。 +{% tabs data_7 class=tabs-scala-version %} +{% tab 'Scala 2' for=data_7 %} + +```scala +def crustPrice(s: CrustSize, t: CrustType): Double = + (s, t) match { + // if the crust size is small or medium, + // the type is not important + case (Small | Medium, _) => 0.25 + case (Large, Thin) => 0.50 + case (Large, Regular) => 0.75 + case (Large, Thick) => 1.00 + } +``` + +{% endtab %} +{% tab 'Scala 3' for=data_7 %} + ```scala def crustPrice(s: CrustSize, t: CrustType): Double = (s, t) match @@ -175,6 +300,9 @@ def crustPrice(s: CrustSize, t: CrustType): Double = case (Large, Thick) => 1.00 ``` +{% endtab %} +{% endtabs %} + 为了计算面饼的价格，我们同时对面饼的大小和类型进行模式匹配。 > 关于上面显示的所有函数的重要一点是它们是*纯函数*：它们不会改变任何数据或有其他副作用（如抛出异常或写入文件）。 @@ -229,6 +357,40 @@ Mine (Alvin, now modified, from fp-pure-functions.md): 使用这种方法，除了枚举或样例类之外，您还定义了一个包含该行为的同名伴生对象。 +{% tabs org_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=org_1 %} + +```scala +case class Pizza( + crustSize: CrustSize, + crustType: CrustType, + toppings: Seq[Topping] +) + +// the companion object of case class Pizza +object Pizza { + // the implementation of `pizzaPrice` from above + def price(p: Pizza): Double = ... +} + +sealed abstract class Topping + +// the companion object of enumeration Topping +object Topping { + case object Cheese extends Topping + case object Pepperoni extends Topping + case object BlackOlives extends Topping + case object GreenOlives extends Topping + case object Onions extends Topping + + // the implementation of `toppingPrice` above + def price(t: Topping): Double = ... +} +``` + +{% endtab %} +{% tab 'Scala 3' for=org_1 %} + ```scala case class Pizza( crustSize: CrustSize, @@ -252,13 +414,22 @@ object Topping: case Pepperoni | BlackOlives | GreenOlives => 0.75 ``` +{% endtab %} +{% endtabs %} + 使用这种方法，您可以创建一个 `Pizza` 并计算其价格，如下所示： +{% tabs org_2 %} +{% tab 'Scala 2 and 3' for=org_2 %} + ```scala val pizza1 = Pizza(Small, Thin, Seq(Cheese, Onions)) Pizza.price(pizza1) ``` +{% endtab %} +{% endtabs %} + 以这种方式对功能进行分组有几个优点： - 它将功能与数据相关联，让程序员（和编译器）更容易找到它。 @@ -282,6 +453,25 @@ Pizza.price(pizza1) 首先要考虑的是 `Pizza` 的“行为”。 执行此操作时，您可以像这样草拟一个 `PizzaServiceInterface` trait： +{% tabs module_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=module_1 %} + +```scala +trait PizzaServiceInterface { + + def price(p: Pizza): Double + + def addTopping(p: Pizza, t: Topping): Pizza + def removeAllToppings(p: Pizza): Pizza + + def updateCrustSize(p: Pizza, cs: CrustSize): Pizza + def updateCrustType(p: Pizza, ct: CrustType): Pizza +} +``` + +{% endtab %} +{% tab 'Scala 3' for=module_1 %} + ```scala trait PizzaServiceInterface: @@ -294,6 +484,9 @@ trait PizzaServiceInterface: def updateCrustType(p: Pizza, ct: CrustType): Pizza ``` +{% endtab %} +{% endtabs %} + 如图所示，每个方法都将 `Pizza` 作为输入参数——连同其他参数——然后返回一个 `Pizza` 实例作为结果 当你写一个像这样的纯接口时，你可以把它想象成一个约定，“所有扩展这个特性的非抽象类*必须*提供这些服务的实现。” @@ -301,6 +494,9 @@ trait PizzaServiceInterface: 此时您还可以做的是想象您是此 API 的使用者。 当你这样做时，它有助于草拟一些示例“消费者”代码，以确保 API 看起来像你想要的： +{% tabs module_2 %} +{% tab 'Scala 2 and 3' for=module_2 %} + ```scala val p = Pizza(Small, Thin, Seq(Cheese)) @@ -311,6 +507,9 @@ val p3 = updateCrustType(p2, Thick) val p4 = updateCrustSize(p3, Large) ``` +{% endtab %} +{% endtabs %} + 如果该代码看起来没问题，您通常会开始草拟另一个 API ——例如用于订单的 API ——但由于我们现在只关注披萨饼，我们将停止考虑接口，然后创建这个接口的具体实现。 > 请注意，这通常是一个两步过程。 @@ -322,6 +521,32 @@ val p4 = updateCrustSize(p3, Large) 现在您知道了 `PizzaServiceInterface` 的样子，您可以通过为接口中定义的所有方法体来创建它的具体实现： +{% tabs module_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=module_3 %} + +```scala +object PizzaService extends PizzaServiceInterface { + + def price(p: Pizza): Double = + ... // implementation from above + + def addTopping(p: Pizza, t: Topping): Pizza = + p.copy(toppings = p.toppings :+ t) + + def removeAllToppings(p: Pizza): Pizza = + p.copy(toppings = Seq.empty) + + def updateCrustSize(p: Pizza, cs: CrustSize): Pizza = + p.copy(crustSize = cs) + + def updateCrustType(p: Pizza, ct: CrustType): Pizza = + p.copy(crustType = ct) +} +``` + +{% endtab %} +{% tab 'Scala 3' for=module_3 %} + ```scala object PizzaService extends PizzaServiceInterface: @@ -343,10 +568,33 @@ object PizzaService extends PizzaServiceInterface: end PizzaService ``` +{% endtab %} +{% endtabs %} + 虽然创建接口和实现的两步过程并不总是必要的，但明确考虑 API 及其使用是一种好方法。 一切就绪后，您可以使用 `Pizza` 类和 `PizzaService`： +{% tabs module_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=module_4 %} + +```scala +import PizzaService._ + +val p = Pizza(Small, Thin, Seq(Cheese)) + +// use the PizzaService methods +val p1 = addTopping(p, Pepperoni) +val p2 = addTopping(p1, Onions) +val p3 = updateCrustType(p2, Thick) +val p4 = updateCrustSize(p3, Large) + +println(price(p4)) // prints 8.75 +``` + +{% endtab %} +{% tab 'Scala 3' for=module_4 %} + ```scala import PizzaService.* @@ -361,6 +609,9 @@ val p4 = updateCrustSize(p3, Large) println(price(p4)) // prints 8.75 ``` +{% endtab %} +{% endtabs %} + ### 函数对象 在 *Programming in Scala* 一书中，作者将术语“函数对象”定义为“不具有任何可变状态的对象”。 @@ -379,6 +630,38 @@ println(price(p4)) // prints 8.75 #### 例子 使用这种方法，您可以在样例类中直接实现披萨上的功能： + +{% tabs module_5 class=tabs-scala-version %} +{% tab 'Scala 2' for=module_5 %} + +```scala +case class Pizza( + crustSize: CrustSize, + crustType: CrustType, + toppings: Seq[Topping] +) { + + // the operations on the data model + def price: Double = + pizzaPrice(this) // implementation from above + + def addTopping(t: Topping): Pizza = + this.copy(toppings = this.toppings :+ t) + + def removeAllToppings: Pizza = + this.copy(toppings = Seq.empty) + + def updateCrustSize(cs: CrustSize): Pizza = + this.copy(crustSize = cs) + + def updateCrustType(ct: CrustType): Pizza = + this.copy(crustType = ct) +} +``` + +{% endtab %} +{% tab 'Scala 3' for=module_5 %} + ```scala case class Pizza( crustSize: CrustSize, @@ -403,11 +686,17 @@ case class Pizza( this.copy(crustType = ct) ``` +{% endtab %} +{% endtabs %} + 请注意，与之前的方法不同，因为这些是 `Pizza` 类上的方法，它们不会将 `Pizza` 引用作为输入参数。 相反，他们用 `this` 作为当前披萨实例的引用。 现在你可以像这样使用这个新设计： +{% tabs module_6 %} +{% tab 'Scala 2 and 3' for=module_6 %} + ```scala Pizza(Small, Thin, Seq(Cheese)) .addTopping(Pepperoni) @@ -415,6 +704,9 @@ Pizza(Small, Thin, Seq(Cheese)) .price ``` +{% endtab %} +{% endtabs %} + ### 扩展方法 最后，我们展示了一种介于第一个（在伴生对象中定义函数）和最后一个（将函数定义为类型本身的方法）之间的方法。 @@ -428,6 +720,9 @@ Pizza(Small, Thin, Seq(Cheese)) 让我们再次回顾一下我们的例子。 +{% tabs module_7 class=tabs-scala-version %} +{% tab 'Scala 2' for=module_7 %} + ```scala case class Pizza( crustSize: CrustSize, @@ -435,7 +730,7 @@ case class Pizza( toppings: Seq[Topping] ) -extension (p: Pizza) +implicit class PizzaOps(p: Pizza) { def price: Double = pizzaPrice(p) // implementation from above @@ -450,12 +745,48 @@ extension (p: Pizza) def updateCrustType(ct: CrustType): Pizza = p.copy(crustType = ct) +} ``` +在上面的代码中，我们将披萨上的不同方法定义为_implicit class_。 +用 `implicit class PizzaOps(p: Pizza)`，不管什么时候导入 `PizzaOps`，它的方法在 `Pizza` 的实例上都是可用的。 +在本例中接收者是 `p`。 + +{% endtab %} +{% tab 'Scala 3' for=module_7 %} +```scala +case class Pizza( + crustSize: CrustSize, + crustType: CrustType, + toppings: Seq[Topping] +) + +extension (p: Pizza) + def price: Double = + pizzaPrice(p) // implementation from above + + def addTopping(t: Topping): Pizza = + p.copy(toppings = p.toppings :+ t) + + def removeAllToppings: Pizza = + p.copy(toppings = Seq.empty) + + def updateCrustSize(cs: CrustSize): Pizza = + p.copy(crustSize = cs) + + def updateCrustType(ct: CrustType): Pizza = + p.copy(crustType = ct) +``` 在上面的代码中，我们将披萨上的不同方法定义为_扩展方法_。 -对于 `extension (p: Pizza)`，我们想在 `Pizza` 的实例上让方法可用，并在下文中把扩展的实例称为 `p`。 +对于 `extension (p: Pizza)`，我们想在 `Pizza` 的实例上让方法可用。在本例中接收者是 `p`。 + +{% endtab %} +{% endtabs %} -这样我们就可以获得和之前一样的 API，同时能够在任何其他模块中定义扩展。 +使用扩展方法，我们就可以获得和之前一样的 API： + +{% tabs module_8 %} +{% tab 'Scala 2 and 3' for=module_8 %} ```scala Pizza(Small, Thin, Seq(Cheese)) @@ -464,6 +795,9 @@ Pizza(Small, Thin, Seq(Cheese)) .price ``` +{% endtab %} +{% endtabs %} + 通常，如果您是数据模型的设计者，您将在伴生对象中定义您的扩展方法。 这样，它们已经可供所有用户使用。 否则，扩展方法需要显式导入才能使用。 From 0513751d852c5cfc2988ac0ea096a8d3d77eb810 Mon Sep 17 00:00:00 2001 From: Lucas Leblanc <44496264+Dedelweiss@users.noreply.github.com> Date: Mon, 13 Mar 2023 08:59:50 +0100 Subject: [PATCH 2525/3075] Add code tabs to Other changes page (#2725) --- .../incompat-other-changes.md | 153 +++++++++++------- 1 file changed, 97 insertions(+), 56 deletions(-) diff --git a/_overviews/scala3-migration/incompat-other-changes.md b/_overviews/scala3-migration/incompat-other-changes.md index 505df8c17f..90c04abab9 100644 --- a/_overviews/scala3-migration/incompat-other-changes.md +++ b/_overviews/scala3-migration/incompat-other-changes.md @@ -25,14 +25,18 @@ Some other features are simplified or restricted to make the language easier, sa An inherited member, from a parent trait or class, can shadow an identifier defined in an outer scope. That pattern is called inheritance shadowing. -```scala +{% tabs shared-inheritance_1 %} +{% tab 'Scala 2 and 3' %} +~~~ scala object B { val x = 1 class C extends A { println(x) } } -``` +~~~ +{% endtab %} +{% endtabs %} For instance, in this preceding piece of code, the `x` term in C can refer to the `x` member defined in the outer class `B` or it can refer to a `x` member of the parent class `A`. You cannot know until you go to the definition of `A`. @@ -42,8 +46,9 @@ This is known for being error prone. That's why, in Scala 3, the compiler requires disambiguation if the parent class `A` does actually have a member `x`. It prevents the following piece of code from compiling. - -```scala +{% tabs scala-2-inheritance_2 %} +{% tab 'Scala 2 Only' %} +~~~ scala class A { val x = 2 } @@ -54,8 +59,11 @@ object B { println(x) } } -``` +~~~ +{% endtab %} +{% endtabs %} +But if you try to compile with Scala 3 you should see an error of the same kind as: {% highlight text %} -- [E049] Reference Error: src/main/scala/inheritance-shadowing.scala:9:14 9 | println(x) @@ -72,21 +80,24 @@ The [Scala 3 migration compilation](tooling-migration-mode.html) can automatical The Scala 3 compiler requires the constructor of private classes to be private. For instance, in the example: - -```scala +{% tabs scala-2-constructor_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala package foo private class Bar private[foo] () {} -``` +~~~ +{% endtab %} +{% endtabs %} -The error message is: -``` +If you try to compile in scala 3 you should get the following error message: +{% highlight text %} -- Error: /home/piquerez/scalacenter/scala-3-migration-guide/incompat/access-modifier/src/main/scala-2.13/access-modifier.scala:4:19 4 | private class Bar private[foo] () | ^ | non-private constructor Bar in class Bar refers to private class Bar | in its type signature (): foo.Foo.Bar -``` +{% endhighlight %} The [Scala 3 migration compilation](tooling-migration-mode.html) warns about this but no automatic rewrite is provided. @@ -97,8 +108,9 @@ The solution is to make the constructor private, since the class is private. In Scala 3, overriding a concrete def with an abstract def causes subclasses to consider the def abstract, whereas in Scala 2 it was considered as concrete. In the following piece of code, the `bar` method in `C` is considered concrete by the Scala 2.13 compiler but abstract by the Scala 3 compiler, causing the following error. - -```scala +{% tabs scala-2-abstract_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala trait A { def bar(x: Int): Int = x + 3 } @@ -107,8 +119,10 @@ trait B extends A { def bar(x: Int): Int } -class C extends B // Error: class C needs to be abstract, since def bar(x: Int): Int is not defined -``` +class C extends B // In Scala 3, Error: class C needs to be abstract, since def bar(x: Int): Int is not defined +~~~ +{% endtab %} +{% endtabs %} This behavior was decided in [Dotty issue #4770](https://github.com/lampepfl/dotty/issues/4770). @@ -120,17 +134,20 @@ The companion object of a case class does not extend any of the `Function{0-23}` In particular, it does not inherit their methods: `tupled`, `curried`, `andThen`, `compose`... For instance, this is not permitted anymore: - -```scala +{% tabs scala-2-companion_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala case class Foo(x: Int, b: Boolean) Foo.curried(1)(true) Foo.tupled((2, false)) -``` +~~~ +{% endtab %} +{% endtabs %} A cross-compiling solution is to explicitly eta-expand the method `Foo.apply`. - {% highlight diff %} + -Foo.curried(1)(true) +(Foo.apply _).curried(1)(true) @@ -139,13 +156,16 @@ A cross-compiling solution is to explicitly eta-expand the method `Foo.apply`. {% endhighlight %} Or, for performance reasons, you can introduce an intermediate function value. - -```scala +{% tabs scala-3-companion_2 %} +{% tab 'Scala 2 and 3' %} +~~~ scala val fooCtr: (Int, Boolean) => Foo = (x, b) => Foo(x, b) fooCtr.curried(1)(true) fooCtr.tupled((2, false)) -``` +~~~ +{% endtab %} +{% endtabs %} ## Explicit Call to `unapply` In Scala, case classes have an auto-generated extractor method, called `unapply` in their companion object. @@ -156,36 +176,48 @@ The new signature is option-less (see the new [Pattern Matching]({{ site.scala3r Note that this problem does not affect user-defined extractors, whose signature stays the same across Scala versions. Given the following case class definition: - -```scala +{% tabs shared-unapply_1 %} +{% tab 'Scala 2 and 3' %} +~~~ scala case class Location(lat: Double, long: Double) -``` +~~~ +{% endtab %} +{% endtabs %} The Scala 2.13 compiler generates the following `unapply` method: - -```scala +{% tabs scala-2-unapply_2 %} +{% tab 'Scala 2 Only' %} +~~~ scala object Location { def unapply(location: Location): Option[(Double, Double)] = Some((location.lat, location.long)) } -``` +~~~ +{% endtab %} +{% endtabs %} Whereas the Scala 3 compiler generates: - -```scala +{% tabs scala-3-unapply_2 %} +{% tab 'Scala 3 Only' %} +~~~ scala object Location { def unapply(location: Location): Location = location } -``` - -Consequently the following code does not compile anymore. - -```scala +~~~ +{% endtab %} +{% endtabs %} + +Consequently the following code does not compile anymore in Scala 3. +{% tabs scala-2-unapply_3 %} +{% tab 'Scala 2 Only' %} +~~~ scala def tuple(location: Location): (Int, Int) = { - Location.unapply(location).get // [E008] Not Found Error: value get is not a member of Location + Location.unapply(location).get // [E008] In Scala 3, Not Found Error: value get is not a member of Location } -``` +~~~ +{% endtab %} +{% endtabs %} -A possible solution is to use pattern binding: +A possible solution, in Scala 3, is to use pattern binding: {% highlight diff %} def tuple(location: Location): (Int, Int) = { @@ -199,21 +231,24 @@ def tuple(location: Location): (Int, Int) = { The getter and setter methods generated by the `BeanProperty` annotation are now invisible in Scala 3 because their primary use case is the interoperability with Java frameworks. -For instance, in the below example: - -```scala +For instance, the below Scala 2 code would fail to compile in Scala 3: +{% tabs scala-2-bean_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala class Pojo() { @BeanProperty var fooBar: String = "" } val pojo = new Pojo() -pojo.setFooBar("hello") // [E008] Not Found Error: value setFooBar is not a member of Pojo +pojo.setFooBar("hello") // [E008] In Scala 3, Not Found Error: value setFooBar is not a member of Pojo -println(pojo.getFooBar()) // [E008] Not Found Error: value getFooBar is not a member of Pojo -``` +println(pojo.getFooBar()) // [E008] In Scala 3, Not Found Error: value getFooBar is not a member of Pojo +~~~ +{% endtab %} +{% endtabs %} -The solution is to call the more idiomatic `pojo.fooBar` getter and setter. +In Scala 3, the solution is to call the more idiomatic `pojo.fooBar` getter and setter. {% highlight diff %} val pojo = new Pojo() @@ -233,7 +268,7 @@ This decision is explained in [this comment](https://github.com/lampepfl/dotty/b For instance, it is not allowed to pass a function of type `Int => (=> Int) => Int` to the `uncurried` method since it would assign `=> Int` to the type parameter `T2`. -``` +{% highlight text %} -- [E134] Type Mismatch Error: src/main/scala/by-name-param-type-infer.scala:3:41 3 | val g: (Int, => Int) => Int = Function.uncurried(f) | ^^^^^^^^^^^^^^^^^^ @@ -244,7 +279,7 @@ For instance, it is not allowed to pass a function of type `Int => (=> Int) => I | [T1, T2, T3, R](f: T1 => T2 => T3 => R): (T1, T2, T3) => R | [T1, T2, R](f: T1 => T2 => R): (T1, T2) => R |match arguments ((Test.f : Int => (=> Int) => Int)) -``` +{% endhighlight %} The solution depends on the situation. In the given example, you can either: - define your own `uncurried` method with the appropriate signature @@ -254,15 +289,18 @@ The solution depends on the situation. In the given example, you can either: Scala 3 cannot reduce the application of a higher-kinded abstract type member to the wildcard argument. -For instance, the following example does not compile. - -```scala +For instance, the below Scala 2 code would fail to compile in Scala 3: +{% tabs scala-2-wildcard_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala trait Example { type Foo[A] - def f(foo: Foo[_]): Unit // [E043] Type Error: unreducible application of higher-kinded type Example.this.Foo to wildcard arguments + def f(foo: Foo[_]): Unit // [E043] In Scala 3, Type Error: unreducible application of higher-kinded type Example.this.Foo to wildcard arguments } -``` +~~~ +{% endtab %} +{% endtabs %} We can fix this by using a type parameter: @@ -272,10 +310,13 @@ We can fix this by using a type parameter: {% endhighlight %} But this simple solution does not work when `Foo` is itself used as a type argument. - -```scala +{% tabs scala-2-wildcard_2 %} +{% tab 'Scala 2 Only' %} +~~~ scala def g(foos: Seq[Foo[_]]): Unit -``` +~~~ +{% endtab %} +{% endtabs %} In such case, we can use a wrapper class around `Foo`: @@ -284,4 +325,4 @@ In such case, we can use a wrapper class around `Foo`: -def g(foos: Seq[Foo[_]]): Unit +def g(foos: Seq[FooWrapper[_]]): Unit -{% endhighlight %} +{% endhighlight %} \ No newline at end of file From 8e8e357086f60b544f5c3dd753e52c2fa07709d4 Mon Sep 17 00:00:00 2001 From: Lucas Leblanc <44496264+Dedelweiss@users.noreply.github.com> Date: Mon, 13 Mar 2023 09:03:31 +0100 Subject: [PATCH 2526/3075] Add code tabs to the Scala 3 Dropped Features (#2723) --- .../incompat-dropped-features.md | 119 ++++++++++++------ 1 file changed, 78 insertions(+), 41 deletions(-) diff --git a/_overviews/scala3-migration/incompat-dropped-features.md b/_overviews/scala3-migration/incompat-dropped-features.md index 26e4d84ced..ae7e3e3f1e 100644 --- a/_overviews/scala3-migration/incompat-dropped-features.md +++ b/_overviews/scala3-migration/incompat-dropped-features.md @@ -27,14 +27,17 @@ But the `scala.Symbol` class still exists so that each string literal can be saf This piece of code cannot be compiled with Scala 3: -```scala +{% tabs scala-2-literals_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala val values: Map[Symbol, Int] = Map('abc -> 1) -val abc = values('abc) // Migration Warning: symbol literal 'abc is no longer supported -``` +val abc = values('abc) // In Scala 3, Migration Warning: symbol literal 'abc is no longer supported +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites the code into: - {% highlight diff %} val values: Map[Symbol, Int] = Map(Symbol("abc") -> 1) @@ -54,19 +57,26 @@ It is recommended to use the equivalent `while ({ <body>; <cond> }) ()` that can The following piece of code cannot be compiled with Scala 3. -```scala -do { // Migration Warning: `do <body> while <cond>` is no longer supported +{% tabs scala-2-do_while_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala +do { // In Scala 3, Migration Warning: `do <body> while <cond>` is no longer supported i += 1 } while (f(i) == 0) -``` +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites it into. - -```scala +{% tabs scala-3-do_while_2 %} +{% tab 'Scala 3 Only' %} +~~~ scala while ({ { i += 1 } ; f(i) == 0}) () -``` +~~~ +{% endtab %} +{% endtabs %} ## Auto-application @@ -75,16 +85,19 @@ It is deprecated in Scala 2.13 and dropped in Scala 3. The following code is invalid in Scala 3: -```scala +{% tabs scala-2-auto_application_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala object Hello { def message(): String = "Hello" } -println(Hello.message) // Migration Warning: method message must be called with () argument -``` +println(Hello.message) // In Scala 3, Migration Warning: method message must be called with () argument +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites it into: - {% highlight diff %} object Hello { def message(): String = "Hello" @@ -103,13 +116,16 @@ Furthermore Scala 3 does not allow eta-expansion of values to nullary functions Thus, this piece of code is invalid in Scala 3: -```scala +{% tabs scala-2-eta_expansion_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala val x = 1 -val f: () => Int = x _ // Migration Warning: The syntax `<function> _` is no longer supported; -``` +val f: () => Int = x _ // In Scala 3, Migration Warning: The syntax `<function> _` is no longer supported; +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compilation](tooling-migration-mode.html) rewrites it into: - {% highlight diff %} val x = 1 -val f: () => Int = x _ @@ -120,14 +136,17 @@ val x = 1 The implicit `Predef.any2stringadd` conversion is deprecated in Scala 2.13 and dropped in Scala 3. -This piece of code does not compile anymore. +This piece of code does not compile anymore in Scala 3. -```scala -val str = new AnyRef + "foo" // Error: value + is not a member of Object -``` +{% tabs scala-2-any2stringadd_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala +val str = new AnyRef + "foo" // In Scala 3, Error: value + is not a member of Object +~~~ +{% endtab %} +{% endtabs %} The conversion to `String` must be applied explicitly, for instance with `String.valueOf`. - {% highlight diff %} -val str = new AnyRef + "foo" +val str = String.valueOf(new AnyRef) + "foo" @@ -140,9 +159,11 @@ This rewrite can be applied by the `fix.scala213.Any2StringAdd` Scalafix rule in Early initializers are deprecated in Scala 2.13 and dropped in Scala 3. They were rarely used, and mostly to compensate for the lack of [Trait parameters]({{ site.scala3ref }}/other-new-features/trait-parameters.html) which are now supported in Scala 3. -That is why the following piece of code does not compile anymore. +That is why the following piece of code does not compile anymore in Scala 3. -```scala +{% tabs scala-2-initializer_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala trait Bar { val name: String val size: Int = name.size @@ -151,7 +172,9 @@ trait Bar { object Foo extends { val name = "Foo" } with Bar -``` +~~~ +{% endtab %} +{% endtabs %} The Scala 3 compiler produces two error messages: @@ -161,7 +184,6 @@ The Scala 3 compiler produces two error messages: | ^ | `extends` must be followed by at least one parent {% endhighlight %} - {% highlight text %} -- [E009] Syntax Error: src/main/scala/early-initializer.scala:8:2 8 |} with Bar @@ -171,51 +193,66 @@ The Scala 3 compiler produces two error messages: It suggests to use trait parameters which would give us: -```scala +{% tabs scala-3-initializer_2 %} +{% tab 'Scala 3 Only' %} +~~~ scala trait Bar(name: String) { val size: Int = name.size } object Foo extends Bar("Foo") -``` +~~~ +{% endtab %} +{% endtabs %} Since trait parameters are not available in Scala 2.13, it does not cross-compile. If you need a cross-compiling solution you can use an intermediate class that carries the early initialized `val`s and `var`s as constructor parameters. -```scala +{% tabs shared-initializer_4 %} +{% tab 'Scala 2 and 3' %} +~~~ scala abstract class BarEarlyInit(val name: String) extends Bar object Foo extends BarEarlyInit("Foo") -``` +~~~ In the case of a class, it is also possible to use a secondary constructor with a fixed value, as shown by: - -```scala +~~~ scala class Fizz private (val name: String) extends Bar { def this() = this("Fizz") } -``` +~~~ +{% endtab %} +{% endtabs %} ## Existential Type Existential type is a [dropped feature]({{ site.scala3ref }}/dropped-features/existential-types.html), which makes the following code invalid. - -```scala -def foo: List[Class[T]] forSome { type T } // Error: Existential types are no longer supported -``` + +{% tabs scala-2-existential_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala +def foo: List[Class[T]] forSome { type T } // In Scala 3, Error: Existential types are no longer supported +~~~ +{% endtab %} +{% endtabs %} > Existential type is an experimental feature in Scala 2.13 that must be enabled explicitly either by importing `import scala.language.existentials` or by setting the `-language:existentials` compiler flag. -The proposed solution is to introduce an enclosing type that carries the dependent type: +In Scala 3, the proposed solution is to introduce an enclosing type that carries the dependent type: -```scala +{% tabs shared-existential_1 %} +{% tab 'Scala 2 and 3' %} +~~~ scala trait Bar { type T val value: List[Class[T]] } def foo: Bar -``` +~~~ +{% endtab %} +{% endtabs %} Note that using a wildcard argument, `_` or `?`, is often simpler but is not always possible. For instance you could replace `List[T] forSome { type T }` by `List[?]`. From 4947ff2358402e76944e7c9242d1f594260371b8 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 13 Mar 2023 16:14:16 +0800 Subject: [PATCH 2527/3075] add code tab in two files (#2696) --- _overviews/scala3-book/control-structures.md | 16 +- .../scala3-book/control-structures.md | 615 +++++++++++++++++- 2 files changed, 604 insertions(+), 27 deletions(-) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index ce62617865..198a4955d2 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -23,8 +23,6 @@ It also has two other powerful constructs that you may not have seen before, dep These are all demonstrated in the following sections. - - ## The if/then/else construct A one-line Scala `if` statement looks like this: @@ -118,6 +116,10 @@ else </blockquote> You can optionally include an `end if` statement at the end of each expression, if you prefer: + +{% tabs control-structures-5 %} +{% tab 'Scala 3 Only' %} + ```scala if x == 1 then println("x is 1, as you can see:") @@ -125,6 +127,9 @@ if x == 1 then end if ``` +{% endtab %} +{% endtabs %} + ### `if`/`else` expressions always return a result Note that `if`/`else` comparisons form _expressions_, meaning that they return a value which you can assign to a variable. @@ -143,7 +148,6 @@ val minValue = if a < b then a else b {% endtab %} {% endtabs %} - Because they return a value, you can use `if`/`else` expressions as the body of a method: {% tabs control-structures-7 class=tabs-scala-version %} @@ -633,7 +637,6 @@ val day = i match {% endtab %} {% endtabs %} - In this example, the variable `i` is tested against the cases shown. If it’s between `0` and `6`, `day` is bound to the string that represents that day of the week. Otherwise, it matches the catch-all case represented by the character, `_`, and `day` is bound to the string, `"invalid day"`. @@ -643,7 +646,6 @@ Since the cases are considered in the order they are written, and the first matc > When writing simple `match` expressions like this, it’s recommended to use the `@switch` annotation on the variable `i`. > This annotation provides a compile-time warning if the switch can’t be compiled to a `tableswitch` or `lookupswitch`, which are better for performance. - ### Using the default value When you need to access the catch-all, default value in a `match` expression, just provide a variable name on the left side of the `case` statement instead of `_`, and then use that variable name on the right side of the statement as needed: @@ -749,7 +751,6 @@ i match {% endtab %} {% endtabs %} - Here’s another example, which shows how to match a given value against ranges of numbers: {% tabs control-structures-27 class=tabs-scala-version %} @@ -774,8 +775,6 @@ i match {% endtab %} {% endtabs %} - - #### Case classes and match expressions You can also extract fields from `case` classes---and classes that have properly written `apply`/`unapply` methods---and use those in your guard conditions. @@ -856,6 +855,7 @@ isTruthy(2F) // true Using a `match` expression as the body of a method is a very common use. #### Match expressions support many different types of patterns + There are many different forms of patterns that can be used to write `match` expressions. Examples include: diff --git a/_zh-cn/overviews/scala3-book/control-structures.md b/_zh-cn/overviews/scala3-book/control-structures.md index a639686f9c..7babcabc6f 100644 --- a/_zh-cn/overviews/scala3-book/control-structures.md +++ b/_zh-cn/overviews/scala3-book/control-structures.md @@ -32,20 +32,64 @@ Scala具有您希望在编程语言中找到的控制结构，包括： 单行 Scala `if` 语句像这样： +{% tabs control-structures-1 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-1 %} + +```scala +if (x == 1) println(x) +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-1 %} + ```scala if x == 1 then println(x) ``` +{% endtab %} +{% endtabs %} + 如果要在 `if` 比较后运行多行代码，用这个语法： +{% tabs control-structures-2 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-2 %} + +```scala +if (x == 1) { + println("x is 1, as you can see:") + println(x) +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-2 %} + ```scala if x == 1 then println("x is 1, as you can see:") println(x) ``` +{% endtab %} +{% endtabs %} + `if`/`else` 语法像这样： +{% tabs control-structures-3 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-3 %} + +```scala +if (x == 1) { + println("x is 1, as you can see:") + println(x) +} else { + println("x was not 1") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-3 %} + ```scala if x == 1 then println("x is 1, as you can see:") @@ -54,8 +98,26 @@ else println("x was not 1") ``` +{% endtab %} +{% endtabs %} + 这是 `if`/`else if`/`else` 语法： +{% tabs control-structures-4 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-4 %} + +```scala +if (x < 0) + println("negative") +else if (x == 0) + println("zero") +else + println("positive") +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-4 %} + ```scala if x < 0 then println("negative") @@ -65,8 +127,20 @@ else println("positive") ``` +{% endtab %} +{% endtabs %} + +### `end if` 语句 + +<blockquote class="help-info"> +<i class="fa fa-info"></i>  这是 Scala 3 里的新东西，在 Scala 2 里不支持。 +</blockquote> + 如果您愿意，可以选择在每个表达式的末尾包含 `end if` 语句： +{% tabs control-structures-5 %} +{% tab 'Scala 3 Only' %} + ```scala if x == 1 then println("x is 1, as you can see:") @@ -74,17 +148,49 @@ if x == 1 then end if ``` +{% endtab %} +{% endtabs %} + ### `if`/`else` 表达式总是有返回值 请注意， `if` / `else` 比较形式为 _表达式_，这意味着它们返回一个可以分配给变量的值。 因此，不需要特殊的三元运算符： +{% tabs control-structures-6 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-6 %} + +```scala +val minValue = if (a < b) a else b +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-6 %} + ```scala val minValue = if a < b then a else b ``` +{% endtab %} +{% endtabs %} + 由于它们返回一个值，因此可以使用 `if`/`else` 表达式作为方法的主体： +{% tabs control-structures-7 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-7 %} + +```scala +def compare(a: Int, b: Int): Int = + if (a < b) + -1 + else if (a == b) + 0 + else + 1 +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-7 %} + ```scala def compare(a: Int, b: Int): Int = if a < b then @@ -95,23 +201,53 @@ def compare(a: Int, b: Int): Int = 1 ``` +{% endtab %} +{% endtabs %} + ### 题外话：面向表达式的编程 作为一般编程的简要说明，当您编写的每个表达式都返回一个值时，该样式称为面向 _面向表达式的编程_ 或 EOP。 例如，这是一个 _表达式_： +{% tabs control-structures-8 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-8 %} + +```scala +val minValue = if (a < b) a else b +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-8 %} + ```scala val minValue = if a < b then a else b ``` +{% endtab %} +{% endtabs %} + 相反，不返回值的代码行称为 _语句_，用它们的 _副作用_。 例如，这些代码行不返回值，因此用它们的副作用： +{% tabs control-structures-9 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-9 %} + +```scala +if (a == b) action() +println("Hello") +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-9 %} + ```scala if a == b then action() println("Hello") ``` +{% endtab %} +{% endtabs %} + 第一个示例在 `a` 等于 `b` 时将 `action` 方法作为副作用运行。 第二个示例用于将字符串打印到 STDOUT 的副作用。 随着你对Scala的了解越来越多，你会发现自己写的 _表达式_ 越来越多，_语句_ 也越来越少。 @@ -121,20 +257,42 @@ println("Hello") 在最简单的用法中，Scala `for` 循环可用于迭代集合中的元素。 例如，给定一个整数序列，您可以循环访问其元素并打印其值，如下所示： +{% tabs control-structures-10 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-10 %} + ```scala val ints = Seq(1, 2, 3) -for i <- ints do println(i) +for (i <- ints) println(i) ``` -代码 `i <- ints` 被称为 _生成器_，如果将括号从生成器中去掉，则必须在括号之后的代码前加上 `do` 关键字。 -否则，您可以像这样编写代码： +{% endtab %} +{% tab 'Scala 3' for=control-structures-10 %} ```scala -for (i <- ints) println(i) +val ints = Seq(1, 2, 3) +for i <- ints do println(i) ``` -无论您使用哪种方法，这都是 Scala REPL 中的结果： +{% endtab %} +{% endtabs %} + +代码 `i <- ints` 被称为 _生成器_。 +这是在 Scala REPL 中的结果： + +{% tabs control-structures-11 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-11 %} +```` +scala> val ints = Seq(1,2,3) +ints: Seq[Int] = List(1, 2, 3) + +scala> for (i <- ints) println(i) +1 +2 +3 +```` +{% endtab %} +{% tab 'Scala 3' for=control-structures-11 %} ```` scala> val ints = Seq(1,2,3) ints: Seq[Int] = List(1, 2, 3) @@ -145,7 +303,23 @@ scala> for i <- ints do println(i) 3 ```` -如果需要在 `for` 生成器后面显示多行代码块，请使用以下语法： +{% endtab %} +{% endtabs %} + +如果需要在 `for` 生成器后面显示多行代码块，请使用以下语法：ddu + +{% tabs control-structures-12 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-12 %} + +```scala +for (i <- ints) { + val x = i * 2 + println(s"i = $i, x = $x") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-12 %} ```scala for @@ -155,10 +329,29 @@ do println(s"i = $i, x = $x") ``` +{% endtab %} +{% endtabs %} + ### 多生成器 `for` 循环可以有多个生成器，如以下示例所示： +{% tabs control-structures-13 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-13 %} + +```scala +for { + i <- 1 to 2 + j <- 'a' to 'b' + k <- 1 to 10 by 5 +} { + println(s"i = $i, j = $j, k = $k") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-13 %} + ```scala for i <- 1 to 2 @@ -168,6 +361,9 @@ do println(s"i = $i, j = $j, k = $k") ``` +{% endtab %} +{% endtabs %} + 那个表达式的输出： ```` @@ -185,6 +381,21 @@ i = 2, j = b, k = 6 `for` 循环也可以包含 `if` 语句，这些语句称为 _守卫_： +{% tabs control-structures-14 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-14 %} + +```scala +for { + i <- 1 to 5 + if i % 2 == 0 +} { + println(i) +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-14 %} + ```scala for i <- 1 to 5 @@ -193,6 +404,9 @@ do println(i) ``` +{% endtab %} +{% endtabs %} + 以上循环的输出是： ```` @@ -203,6 +417,23 @@ do `for` 循环可以根据需要有任意数量的守卫。 此示例显示了打印数字`4`的一种方法： +{% tabs control-structures-15 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-15 %} + +```scala +for { + i <- 1 to 10 + if i > 3 + if i < 6 + if i % 2 == 0 +} { + println(i) +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-15 %} + ```scala for i <- 1 to 10 @@ -213,11 +444,17 @@ do println(i) ``` +{% endtab %} +{% endtabs %} + ### 把 `for` 用在 `Map` 上 您还可以将 `for` 循环与 `Map` 一起使用。 例如，给定州缩写及其全名的 `Map`： +{% tabs map %} +{% tab 'Scala 2 and 3' for=map %} + ```scala val states = Map( "AK" -> "Alaska", @@ -226,14 +463,43 @@ val states = Map( ) ``` +{% endtab %} +{% endtabs %} + 您可以使用 `for` 打印键和值，如下所示： +{% tabs control-structures-16 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-16 %} + +```scala +for ((abbrev, fullName) <- states) println(s"$abbrev: $fullName") +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-16 %} + ```scala for (abbrev, fullName) <- states do println(s"$abbrev: $fullName") ``` +{% endtab %} +{% endtabs %} + 以下是 REPL 中的样子： +{% tabs control-structures-17 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-17 %} + +```scala +scala> for ((abbrev, fullName) <- states) println(s"$abbrev: $fullName") +AK: Alaska +AL: Alabama +AR: Arizona +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-17 %} + ```scala scala> for (abbrev, fullName) <- states do println(s"$abbrev: $fullName") AK: Alaska @@ -241,12 +507,21 @@ AL: Alabama AR: Arizona ``` +{% endtab %} +{% endtabs %} + 当 `for` 循环遍历映射时，每个键/值对都绑定到变量 `abbrev` 和 `fullName` ，它们位于元组中： +{% tabs tuple %} +{% tab 'Scala 2 and 3' for=tuple %} + ```scala (abbrev, fullName) <- states ``` +{% endtab %} +{% endtabs %} + 当循环运行时，变量 `abbrev` 被分配给映射中的当前 _键_，变量 `fullName` 被分配给当前map 的 _值_。 ## `for` 表达式 @@ -256,22 +531,36 @@ AR: Arizona 重要的是要知道，您还可以创建有返回值的 `for` _表达式_。 您可以通过添加 `yield` 关键字和要返回的表达式来创建 `for` 表达式，如下所示： +{% tabs control-structures-18 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-18 %} + ```scala val list = - for - i <- 10 to 12 - yield - i * 2 + for (i <- 10 to 12) + yield i * 2 + +// list: IndexedSeq[Int] = Vector(20, 22, 24) +``` +{% endtab %} +{% tab 'Scala 3' for=control-structures-18 %} + +```scala +val list = + for i <- 10 to 12 + yield i * 2 // list: IndexedSeq[Int] = Vector(20, 22, 24) ``` +{% endtab %} +{% endtabs %} + 在 `for` 表达式运行后，变量 `list` 是包含所示值的 `Vector` 。 这是表达式的工作原理： 1. `for` 表达式开始循环访问范围 `(10, 11, 12)` 中的值。 它首先处理值`10`，将其乘以`2`，然后 _产生_ 结果为`20`的值。 -2. 接下来，它适用于`11`---范围中的第二个值。 +2. 接下来，它处理`11`---该范围中的第二个值。 它乘以`2`，然后产生值`22`。 您可以将这些产生的值看作它们累积在某个临时位置。 3. 最后，循环从范围中获取数字 `12`，将其乘以 `2`，得到数字 `24`。 @@ -283,14 +572,38 @@ NOTE: This is a place where it would be great to have a TIP or NOTE block: 虽然本节的目的是演示 `for` 表达式，但它可以帮助知道显示的 `for` 表达式等效于以下 `map` 方法调用： +{% tabs map-call %} +{% tab 'Scala 2 and 3' for=map-call %} + ```scala val list = (10 to 12).map(i => i * 2) ``` +{% endtab %} +{% endtabs %} + 只要您需要遍历集合中的所有元素，并将算法应用于这些元素以创建新列表，就可以使用 `for` 表达式。 下面是一个示例，演示如何在 `yield` 之后使用代码块： +{% tabs control-structures-19 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-19 %} + +```scala +val names = List("_olivia", "_walter", "_peter") + +val capNames = for (name <- names) yield { + val nameWithoutUnderscore = name.drop(1) + val capName = nameWithoutUnderscore.capitalize + capName +} + +// capNames: List[String] = List(Olivia, Walter, Peter) +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-19 %} + ```scala val names = List("_olivia", "_walter", "_peter") @@ -302,11 +615,31 @@ val capNames = for name <- names yield // capNames: List[String] = List(Olivia, Walter, Peter) ``` +{% endtab %} +{% endtabs %} + ### 使用 `for` 表达式作为方法的主体 由于 `for` 表达式产生结果，因此可以将其用作返回有用值的方法的主体。 此方法返回给定整数列表中介于`3`和`10`之间的所有值： +{% tabs control-structures-20 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-20 %} + +```scala +def between3and10(xs: List[Int]): List[Int] = + for { + x <- xs + if x >= 3 + if x <= 10 + } yield x + +between3and10(List(1, 3, 7, 11)) // : List[Int] = List(3, 7) +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-20 %} + ```scala def between3and10(xs: List[Int]): List[Int] = for @@ -318,29 +651,38 @@ def between3and10(xs: List[Int]): List[Int] = between3and10(List(1, 3, 7, 11)) // : List[Int] = List(3, 7) ``` +{% endtab %} +{% endtabs %} + ## `while` 循环 Scala `while` 循环语法如下： +{% tabs control-structures-21 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-21 %} + ```scala var i = 0 -while i < 3 do +while (i < 3) { println(i) i += 1 +} ``` -如果你把测试条件放在括号里，它可以写成这样： +{% endtab %} +{% tab 'Scala 3' for=control-structures-21 %} ```scala var i = 0 -while (i < 3) { +while i < 3 do println(i) i += 1 -} ``` +{% endtab %} +{% endtabs %} ## `match` 表达式 @@ -349,6 +691,26 @@ while (i < 3) { 在最简单的情况下，您可以使用 `match` 表达式，象Java `switch` 语句，根据整数值匹配。 请注意，这实际上是一个表达式，因为它计算出一个结果： +{% tabs control-structures-22 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-22 %} + +```scala +// `i` is an integer +val day = i match { + case 0 => "Sunday" + case 1 => "Monday" + case 2 => "Tuesday" + case 3 => "Wednesday" + case 4 => "Thursday" + case 5 => "Friday" + case 6 => "Saturday" + case _ => "invalid day" // the default, catch-all +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-22 %} + ```scala import scala.annotation.switch @@ -364,6 +726,9 @@ val day = i match case _ => "invalid day" // the default, catch-all ``` +{% endtab %} +{% endtabs %} + 在此示例中，变量 `i` 根据所示情况进行测试。 如果它介于`0`和`6`之间，则 `day` 绑定到一个字符串，该字符串表示一周中的某一天。 否则，捕获所有情况，这些情况用 `_` 字符表示，这样 `day` 绑定到字符串 `"invalid day"`。 @@ -373,7 +738,21 @@ val day = i match ### 使用缺省值 -当您需要访问 `match` 表达式中匹配所有情况，也就是默认值时，只需在 `case` 语句的左侧提供一个变量名称，然后根据需要在语句的右侧使用该变量名称： +当您需要访问 `match` 表达式中匹配所有情况，也就是默认值时，只需在 `case` 语句的左侧提供一个变量名而不是 `_`，然后根据需要在语句的右侧使用该变量名称： + +{% tabs control-structures-23 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-23 %} + +```scala +i match { + case 0 => println("1") + case 1 => println("2") + case what => println(s"You gave me: $what") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-23 %} ```scala i match @@ -382,14 +761,61 @@ i match case what => println(s"You gave me: $what" ) ``` -在此示例中，变量被命名为 `what` ，以表明可以为其指定任何合法名称。 -您还可以使用 `_` 作为名称来忽略该值。 +{% endtab %} +{% endtabs %} + +在模式中使用的名称必须以小写字母开头。 +以大写字母开头的名称并不引入变量，而是匹配该范围内的一个值： + +{% tabs control-structures-24 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-24 %} + +```scala +val N = 42 +i match { + case 0 => println("1") + case 1 => println("2") + case N => println("42") + case n => println(s"You gave me: $n" ) +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-24 %} + +```scala +val N = 42 +i match + case 0 => println("1") + case 1 => println("2") + case N => println("42") + case n => println(s"You gave me: $n" ) +``` + +{% endtab %} +{% endtabs %} + +如果 `i` 等于`42`，则 `case N` 将匹配，然后打印字符串`"42"`。它不会到达默认分支。 ### 在一行上处理多个可能的匹配项 如前所述，`match` 表达式具有许多功能。 此示例演示如何在每个 `case` 语句中使用多个可能的模式匹配： +{% tabs control-structures-25 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-25 %} + +```scala +val evenOrOdd = i match { + case 1 | 3 | 5 | 7 | 9 => println("odd") + case 2 | 4 | 6 | 8 | 10 => println("even") + case _ => println("some other number") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-25 %} + ```scala val evenOrOdd = i match case 1 | 3 | 5 | 7 | 9 => println("odd") @@ -397,11 +823,29 @@ val evenOrOdd = i match case _ => println("some other number") ``` +{% endtab %} +{% endtabs %} + ### 在 `case` 子句中使用 `if` 守卫 您还可以在匹配表达式的 `case` 中使用守卫装置。 在此示例中，第二个和第三个 `case` 都使用守卫来匹配多个整数值： +{% tabs control-structures-26 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-26 %} + +```scala +i match { + case 1 => println("one, a lonely number") + case x if x == 2 || x == 3 => println("two’s company, three’s a crowd") + case x if x > 3 => println("4+, that’s a party") + case _ => println("i’m guessing your number is zero or less") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-26 %} + ```scala i match case 1 => println("one, a lonely number") @@ -410,8 +854,26 @@ i match case _ => println("i’m guessing your number is zero or less") ``` +{% endtab %} +{% endtabs %} + 下面是另一个示例，它显示了如何将给定值与数字范围进行匹配： +{% tabs control-structures-27 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-27 %} + +```scala +i match { + case a if 0 to 9 contains a => println(s"0-9 range: $a") + case b if 10 to 19 contains b => println(s"10-19 range: $b") + case c if 20 to 29 contains c => println(s"20-29 range: $c") + case _ => println("Hmmm...") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-27 %} + ```scala i match case a if 0 to 9 contains a => println(s"0-9 range: $a") @@ -420,11 +882,33 @@ i match case _ => println("Hmmm...") ``` +{% endtab %} +{% endtabs %} + #### 样例类和 match 表达式 您还可以从 `case` 类中提取字段 —— 以及正确编写了 `apply`/`unapply` 方法的类 —— 并在守卫条件下使用这些字段。 下面是一个使用简单 `Person` 案例类的示例： +{% tabs control-structures-28 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-28 %} + +```scala +case class Person(name: String) + +def speak(p: Person) = p match { + case Person(name) if name == "Fred" => println(s"$name says, Yubba dubba doo") + case Person(name) if name == "Bam Bam" => println(s"$name says, Bam bam!") + case _ => println("Watch the Flintstones!") +} + +speak(Person("Fred")) // "Fred says, Yubba dubba doo" +speak(Person("Bam Bam")) // "Bam Bam says, Bam bam!" +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-28 %} + ```scala case class Person(name: String) @@ -437,23 +921,45 @@ speak(Person("Fred")) // "Fred says, Yubba dubba doo" speak(Person("Bam Bam")) // "Bam Bam says, Bam bam!" ``` +{% endtab %} +{% endtabs %} + ### 使用 `match` 表达式作为方法的主体 由于 `match` 表达式返回一个值，因此它们可以用作方法的主体。 此方法采用 `Matchable` 值作为输入参数，并根据 `match` 表达式的结果返回 `Boolean`： +{% tabs control-structures-29 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-29 %} + +```scala +def isTruthy(a: Matchable) = a match { + case 0 | "" | false => false + case _ => true +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-29 %} + ```scala def isTruthy(a: Matchable) = a match case 0 | "" | false => false case _ => true ``` -输入参数 `a` 被定义为[`Matchable`类型][matchable]---这是可以对其执行模式匹配的所有Scala类型的根。 +{% endtab %} +{% endtabs %} + +输入参数 `a` 被定义为 [`Matchable`类型][matchable]---这是可以对其执行模式匹配的所有Scala类型的根。 该方法通过在输入上进行匹配来实现，提供两种情况： 第一个检查给定值是整数`0`，空字符串还是 `false`，在这种情况下返回 `false`。 在默认情况下，我们为任何其他值返回 `true`。 以下示例演示此方法的工作原理： +{% tabs is-truthy-call %} +{% tab 'Scala 2 and 3' for=is-truthy-call %} + ```scala isTruthy(0) // false isTruthy(false) // false @@ -463,6 +969,9 @@ isTruthy(" ") // true isTruthy(2F) // true ``` +{% endtab %} +{% endtabs %} + 使用 `match` 表达式作为方法的主体是一种非常常见的用法。 #### 匹配表达式支持许多不同类型的模式 @@ -478,6 +987,49 @@ isTruthy(2F) // true 所有这些类型的模式匹配都展示在以下 `pattern` 方法中，该方法采用类型为 `Matchable` 的输入参数并返回 `String` ： +{% tabs control-structures-30 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-30 %} + +```scala +def pattern(x: Matchable): String = x match { + + // constant patterns + case 0 => "zero" + case true => "true" + case "hello" => "you said 'hello'" + case Nil => "an empty List" + + // sequence patterns + case List(0, _, _) => "a 3-element list with 0 as the first element" + case List(1, _*) => "list, starts with 1, has any number of elements" + case Vector(1, _*) => "vector, starts w/ 1, has any number of elements" + + // tuple patterns + case (a, b) => s"got $a and $b" + case (a, b, c) => s"got $a, $b, and $c" + + // constructor patterns + case Person(first, "Alexander") => s"Alexander, first name = $first" + case Dog("Zeus") => "found a dog named Zeus" + + // type test patterns + case s: String => s"got a string: $s" + case i: Int => s"got an int: $i" + case f: Float => s"got a float: $f" + case a: Array[Int] => s"array of int: ${a.mkString(",")}" + case as: Array[String] => s"string array: ${as.mkString(",")}" + case d: Dog => s"dog: ${d.name}" + case list: List[?] => s"got a List: $list" + case m: Map[?, ?] => m.toString + + // the default wildcard pattern + case _ => "Unknown" +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-30 %} + ```scala def pattern(x: Matchable): String = x match @@ -514,6 +1066,9 @@ def pattern(x: Matchable): String = x match case _ => "Unknown" ``` +{% endtab %} +{% endtabs %} + {% comment %} TODO: Add in the new Scala 3 syntax shown on this page: http://dotty.epfl.ch/docs/reference/changed-features/match-syntax.html @@ -526,6 +1081,25 @@ http://dotty.epfl.ch/docs/reference/changed-features/match-syntax.html 在下面的示例中，`openAndReadAFile` 是一个执行其名称含义的方法：它打开一个文件并读取其中的文本，将结果分配给可变变量 `text` ： +{% tabs control-structures-31 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-31 %} + +```scala +var text = "" +try { + text = openAndReadAFile(filename) +} catch { + case fnf: FileNotFoundException => fnf.printStackTrace() + case ioe: IOException => ioe.printStackTrace() +} finally { + // close your resources here + println("Came to the 'finally' clause.") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=control-structures-31 %} + ```scala var text = "" try @@ -538,6 +1112,9 @@ finally println("Came to the 'finally' clause.") ``` +{% endtab %} +{% endtabs %} + 假设 `openAndReadAFile` 方法使用 Java `java.io.*` 类来读取文件并且不捕获其异常，则尝试打开和读取文件可能会导致 `FileNotFoundException` 和 `IOException` 异常，本例中，这两个异常在 `catch` 块中被捕获。 [matchable]: {{ site.scala3ref }}/other-new-features/matchable.html From 8be8ac5cc0423adf4528ab6c89f0a7d0b3ffbd51 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 13 Mar 2023 16:14:38 +0800 Subject: [PATCH 2528/3075] add code tabs in _zh-cn/overviews/scala3-book/first-look-at-types.md (#2695) --- .../scala3-book/first-look-at-types.md | 102 ++++++++++++++++++ 1 file changed, 102 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/first-look-at-types.md b/_zh-cn/overviews/scala3-book/first-look-at-types.md index 03604b8180..666426ff87 100644 --- a/_zh-cn/overviews/scala3-book/first-look-at-types.md +++ b/_zh-cn/overviews/scala3-book/first-look-at-types.md @@ -46,12 +46,21 @@ Scala中的每个用户定义类型都是 `AnyRef` 的子类型。 在基于语句的编程语言中， `void` 用于没有返回值的方法。 如果您在Scala中编写没有返回值的方法，例如以下方法，则 `Unit` 用于相同的目的： +{% tabs unit %} +{% tab 'Scala 2 and 3' for=unit %} + ```scala def printIt(a: Any): Unit = println(a) ``` +{% endtab %} +{% endtabs %} + 下面是一个示例，它演示了字符串、整数、字符、布尔值和函数都是 `Any` 的实例，可以像对待其他所有对象一样处理： +{% tabs any %} +{% tab 'Scala 2 and 3' for=any %} + ```scala val list: List[Any] = List( "a string", @@ -64,6 +73,9 @@ val list: List[Any] = List( list.foreach(element => println(element)) ``` +{% endtab %} +{% endtabs %} + 该代码定义了一个类型为 `List[Any]` 的值 `list` 。 该列表使用各种类型的元素进行初始化，但每个元素都是 `scala.Any` 的实例，因此我们可以将它们添加到列表中。 @@ -82,6 +94,9 @@ true 如上所示，Scala的值类型扩展了 `AnyVal`，它们都是成熟的对象。 这些示例演示如何声明以下数值类型的变量： +{% tabs anyval %} +{% tab 'Scala 2 and 3' for=anyval %} + ```scala val b: Byte = 1 val i: Int = 1 @@ -91,31 +106,52 @@ val d: Double = 2.0 val f: Float = 3.0 ``` +{% endtab %} +{% endtabs %} + 在前四个示例中，如果未显式指定类型，则数字 `1` 将默认为 `Int` ，因此，如果需要其他数据类型之一 --- `Byte` 、`Long` 或 `Short` --- 则需要显式声明这些类型，如上面代码所示。 带有小数的数字（如2.0）将默认为 `Double` ，因此，如果您想要 `Float` ，则需要声明 `Float` ，如上一个示例所示。 由于 `Int` 和 `Double` 是默认数值类型，因此通常在不显式声明数据类型的情况下创建它们： +{% tabs anynum %} +{% tab 'Scala 2 and 3' for=anynum %} + ```scala val i = 123 // defaults to Int val x = 1.0 // defaults to Double ``` +{% endtab %} +{% endtabs %} + 在代码中，您还可以将字符 `L` 、 `D` 和 `F` （及其小写等效项）加到数字末尾，以指定它们是 `Long`, `Double`, 或 `Float` 值： +{% tabs type-post %} +{% tab 'Scala 2 and 3' for=type-post %} + ```scala val x = 1_000L // val x: Long = 1000 val y = 2.2D // val y: Double = 2.2 val z = 3.3F // val z: Float = 3.3 ``` +{% endtab %} +{% endtabs %} + Scala还具有 `String` 和 `Char` 类型，通常可以使用隐式形式声明： +{% tabs type-string %} +{% tab 'Scala 2 and 3' for=type-string %} + ```scala val s = "Bill" val c = 'a' ``` +{% endtab %} +{% endtabs %} + 如下面表格所示，将字符串括在双引号中 --- 或多行字符串括在三引号中 --- 或字符括在单引号中。 这些数据类型及其范围包括： @@ -136,21 +172,33 @@ val c = 'a' 当您需要非常大的数字时，请使用 `BigInt` 和 `BigDecimal` 类型： +{% tabs type-bigint %} +{% tab 'Scala 2 and 3' for=type-bigint %} + ```scala val a = BigInt(1_234_567_890_987_654_321L) val b = BigDecimal(123_456.789) ``` +{% endtab %} +{% endtabs %} + 其中 `Double` 和 `Float` 是近似的十进制数， `BigDecimal` 用于精确算术，例如在使用货币时。 `BigInt` 和 `BigDecimal` 的一个好处是，它们支持您习惯于用于数字类型的所有运算符： +{% tabs type-bigint2 %} +{% tab 'Scala 2 and 3' for=type-bigint2 %} + ```scala val b = BigInt(1234567890) // scala.math.BigInt = 1234567890 val c = b + b // scala.math.BigInt = 2469135780 val d = b * b // scala.math.BigInt = 1524157875019052100 ``` +{% endtab %} +{% endtabs %} + ## 关于字符串的两个注释 Scala字符串类似于Java字符串，但它们有两个很棒的附加特性： @@ -163,28 +211,46 @@ Scala字符串类似于Java字符串，但它们有两个很棒的附加特性 字符串插值提供了一种非常可读的方式在字符串中使用变量。 例如，给定以下三个变量： +{% tabs string-inside1 %} +{% tab 'Scala 2 and 3' for=string-inside1 %} + ```scala val firstName = "John" val mi = 'C' val lastName = "Doe" ``` +{% endtab %} +{% endtabs %} + 你可以把那些变量组合成这样的字符串： +{% tabs string-inside2 %} +{% tab 'Scala 2 and 3' for=string-inside2 %} + ```scala println(s"Name: $firstName $mi $lastName") // "Name: John C Doe" ``` +{% endtab %} +{% endtabs %} + 只需在字符串前面加上字母 `s` ，然后在字符串内的变量名称之前放置一个 `$` 符号。 如果要在字符串中使用可能较大的表达式时，请将它们放在大括号中： +{% tabs string-inside3 %} +{% tab 'Scala 2 and 3' for=string-inside3 %} + ```scala println(s"2 + 2 = ${2 + 2}") // prints "2 + 2 = 4" val x = -1 println(s"x.abs = ${x.abs}") // prints "x.abs = 1" ``` +{% endtab %} +{% endtabs %} + #### 其他插值器 放置在字符串前面的 `s` 只是一个可能的插值器。 @@ -196,36 +262,60 @@ println(s"x.abs = ${x.abs}") // prints "x.abs = 1" 多行字符串是通过将字符串包含在三个双引号内来创建的： +{% tabs string-mlines1 %} +{% tab 'Scala 2 and 3' for=string-mlines1 %} + ```scala val quote = """The essence of Scala: Fusion of functional and object-oriented programming in a typed setting.""" ``` +{% endtab %} +{% endtabs %} + 这种基本方法的一个缺点是，第一行之后的行是缩进的，如下所示： +{% tabs string-mlines2 %} +{% tab 'Scala 2 and 3' for=string-mlines2 %} + ```scala "The essence of Scala: Fusion of functional and object-oriented programming in a typed setting." ``` +{% endtab %} +{% endtabs %} + 当间距很重要时，在第一行之后的所有行前面放一个 `|` 符号，并在字符串之后调用 `stripMargin` 方法： +{% tabs string-mlines3 %} +{% tab 'Scala 2 and 3' for=string-mlines3 %} + ```scala val quote = """The essence of Scala: |Fusion of functional and object-oriented |programming in a typed setting.""".stripMargin ``` +{% endtab %} +{% endtabs %} + 现在字符串里所有行都是左对齐了： +{% tabs string-mlines4 %} +{% tab 'Scala 2 and 3' for=string-mlines4 %} + ```scala "The essence of Scala: Fusion of functional and object-oriented programming in a typed setting." ``` +{% endtab %} +{% endtabs %} + ## 类型转换 可以通过以下方式强制转换值类型： @@ -234,6 +324,9 @@ programming in a typed setting." 例如： +{% tabs cast1 %} +{% tab 'Scala 2 and 3' for=cast1 %} + ```scala val b: Byte = 127 val i: Int = b // 127 @@ -242,14 +335,23 @@ val face: Char = '☺' val number: Int = face // 9786 ``` +{% endtab %} +{% endtabs %} + 只有在没有丢失信息的情况下，才能强制转换为类型。否则，您需要明确说明强制转换： +{% tabs cast2 %} +{% tab 'Scala 2 and 3' for=cast2 %} + ```scala val x: Long = 987654321 val y: Float = x.toFloat // 9.8765434E8 (注意 `.toFloat` 是必须的，因为强制类型转换后的精度会损) val z: Long = y // Error ``` +{% endtab %} +{% endtabs %} + 还可以将引用类型强制转换为子类型。 这将在教程的后面部分介绍。 From 5a920c67a6d5b62063b25381ef6faef9ef4db437 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Mon, 13 Mar 2023 15:32:42 +0100 Subject: [PATCH 2529/3075] Revert 6fe99721c1c19ab52b4e97a906b9f3a59e4bb1a5 --- _sass/layout/documentation.scss | 1 - 1 file changed, 1 deletion(-) diff --git a/_sass/layout/documentation.scss b/_sass/layout/documentation.scss index cf9f242996..66d4d33c7a 100644 --- a/_sass/layout/documentation.scss +++ b/_sass/layout/documentation.scss @@ -46,7 +46,6 @@ p { line-height: 1.5; - overflow: scroll; } ol { From 0441525080dc43e07311d1f8a1379f7a2c473adb Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 14 Mar 2023 00:21:22 +0000 Subject: [PATCH 2530/3075] Update SIPs state --- _sips/sips/multi-source-extension-overloads.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/multi-source-extension-overloads.md diff --git a/_sips/sips/multi-source-extension-overloads.md b/_sips/sips/multi-source-extension-overloads.md new file mode 100644 index 0000000000..b8a1af4aa8 --- /dev/null +++ b/_sips/sips/multi-source-extension-overloads.md @@ -0,0 +1,7 @@ +--- +title: SIP-54 - Multi-Source Extension Overloads. +status: under-review +pull-request-number: 60 +stage: design + +--- From 2c756b19f035da780a2b615c5985db9211248c08 Mon Sep 17 00:00:00 2001 From: Rebekah <rwaterbury@gmail.com> Date: Tue, 14 Mar 2023 13:39:56 -0700 Subject: [PATCH 2531/3075] Make code example self-contained (#2732) --- _overviews/scala3-book/ca-context-bounds.md | 81 ++++++++++++++++++--- 1 file changed, 72 insertions(+), 9 deletions(-) diff --git a/_overviews/scala3-book/ca-context-bounds.md b/_overviews/scala3-book/ca-context-bounds.md index b95482a25e..2a692ed257 100644 --- a/_overviews/scala3-book/ca-context-bounds.md +++ b/_overviews/scala3-book/ca-context-bounds.md @@ -8,45 +8,108 @@ previous-page: ca-given-using-clauses next-page: ca-given-imports --- -In many situations the name of a [context parameter]({% link _overviews/scala3-book/ca-given-using-clauses.md %}#using-clauses) doesn’t have to be mentioned explicitly, since it’s only used by the compiler in synthesized arguments for other context parameters. +In many situations the name of a [context parameter]({% link _overviews/scala3-book/ca-given-using-clauses.md %}#using-clauses) does not have to be mentioned explicitly, since it is only used by the compiler in synthesized arguments for other context parameters. In that case you don’t have to define a parameter name, and can just provide the parameter type. ## Background -For example, this `maximum` method takes a _context parameter_ of type `Ord`, only to pass it on as an argument to `max`: +For example, consider a method `maxElement` that returns the maximum value in a collection: {% tabs context-bounds-max-named-param class=tabs-scala-version %} {% tab 'Scala 2' %} ```scala -def maximum[A](xs: List[A])(implicit ord: Ord[A]): A = - xs.reduceLeft(max(ord)) +def maxElement[A](as: List[A])(implicit ord: Ord[A]): A = + as.reduceLeft(max(_, _)(ord)) ``` {% endtab %} {% tab 'Scala 3' %} ```scala -def maximum[A](xs: List[A])(using ord: Ord[A]): A = - xs.reduceLeft(max(using ord)) +def maxElement[A](as: List[A])(using ord: Ord[A]): A = + as.reduceLeft(max(_, _)(using ord)) ``` {% endtab %} {% endtabs %} +The method `maxElement` takes a _context parameter_ of type `Ord[A]` only to pass it on as an argument to the method +`max`. + +For the sake of completeness, here are the definitions of `max` and `Ord` (note that in practice we would use the +existing method `max` on `List`, but we made up this example for illustration purpose): + +{% tabs context-bounds-max-ord class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +/** Defines how to compare values of type `A` */ +trait Ord[A] { + def greaterThan(a1: A, a2: A): Boolean +} + +/** Returns the maximum of two values */ +def max[A](a1: A, a2: A)(implicit ord: Ord[A]): A = + if (ord.greaterThan(a1, a2)) a1 else a2 +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +/** Defines how to compare values of type `A` */ +trait Ord[A]: + def greaterThan(a1: A, a2: A): Boolean + +/** Returns the maximum of two values */ +def max[A](a1: A, a2: A)(using ord: Ord[A]): A = + if ord.greaterThan(a1, a2) then a1 else a2 +``` +{% endtab %} + +{% endtabs %} + +Note that the method `max` takes a context parameter of type `Ord[A]`, like the method `maxElement`. + +## Omitting context arguments + +Since `ord` is a context parameter in the method `max`, the compiler can supply it for us in the implementation of `maxElement`, +when we call the method `max`: + +{% tabs context-bounds-context class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +def maxElement[A](as: List[A])(implicit ord: Ord[A]): A = + as.reduceLeft(max(_, _)) +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +def maxElement[A](as: List[A])(using Ord[A]): A = + as.reduceLeft(max(_, _)) +``` + +Note that, because we don’t need to explicitly pass it to the method `max`, we can leave out its name in the definition +of the method `maxElement`. This is an _anonymous context parameter_. +{% endtab %} + +{% endtabs %} + ## Context bounds Given that background, a _context bound_ is a shorthand syntax for expressing the pattern of, “a context parameter applied to a type parameter.” -Using a context bound, the `maximum` method can be written like this: +Using a context bound, the `maxElement` method can be written like this: {% tabs context-bounds-max-rewritten %} {% tab 'Scala 2 and 3' %} ```scala -def maximum[A: Ord](xs: List[A]): A = - xs.reduceLeft(max) +def maxElement[A: Ord](as: List[A]): A = + as.reduceLeft(max(_, _)) ``` {% endtab %} From 5a671d1c983ceff7db268ee8d0ca5cfc257883de Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Mon, 13 Mar 2023 17:47:27 +0100 Subject: [PATCH 2532/3075] Remove examples in Special characters part --- _overviews/scala3-scaladoc/blog.md | 16 +++------------- 1 file changed, 3 insertions(+), 13 deletions(-) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index afcf00738e..9069c9900d 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -49,17 +49,7 @@ authorImg: <Link to the author's image> <Content of your page> ``` -## Special characters for the content -Keep in mind that the writing of your blog is done with classic markdown. So here are some useful examples: +You can also find more details about the front matter on the [Jekyll documentation site](https://jekyllrb.com/docs/front-matter/). -` ```<content>``` ` : Multiline code block. - -You can also specify a language type, ` ```scala <content>``` `. - -`# Title` : For titles. - -`## Subtitle` : For subtitles. - -`word` : For inline code. - -`[name](Link to a website)`: If you want to put a link in the word. \ No newline at end of file +## Syntax of the content +Keep in mind that the writing of your blog is done with Markdown. You can find more information about the syntax in [Markdown Guide](https://www.markdownguide.org/basic-syntax/). From fda45ca4d6d0f16cd781c9e607205090cb8ac6c0 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Wed, 15 Mar 2023 22:44:14 +0800 Subject: [PATCH 2533/3075] Update _zh-cn/overviews/scala3-book/domain-modeling-fp.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: 梦境迷离 <568845948@qq.com> --- _zh-cn/overviews/scala3-book/domain-modeling-fp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md index 11d4779990..960eafddf4 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md @@ -783,7 +783,7 @@ extension (p: Pizza) {% endtab %} {% endtabs %} -使用扩展方法，我们就可以获得和之前一样的 API： +使用扩展方法，我们可以获得和之前一样的 API，同时也能够在任何其他模块中定义扩展： {% tabs module_8 %} {% tab 'Scala 2 and 3' for=module_8 %} From b094f1ecc5ec139584a5191f2f3436376981d89d Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 16 Mar 2023 01:27:31 +0000 Subject: [PATCH 2534/3075] Bump activesupport from 7.0.4.2 to 7.0.4.3 Bumps [activesupport](https://github.com/rails/rails) from 7.0.4.2 to 7.0.4.3. - [Release notes](https://github.com/rails/rails/releases) - [Changelog](https://github.com/rails/rails/blob/v7.0.4.3/activesupport/CHANGELOG.md) - [Commits](https://github.com/rails/rails/compare/v7.0.4.2...v7.0.4.3) --- updated-dependencies: - dependency-name: activesupport dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 9a1627c8b8..6e65062be0 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,7 +1,7 @@ GEM remote: https://rubygems.org/ specs: - activesupport (7.0.4.2) + activesupport (7.0.4.3) concurrent-ruby (~> 1.0, >= 1.0.2) i18n (>= 1.6, < 2) minitest (>= 5.1) @@ -14,7 +14,7 @@ GEM coffee-script-source (1.11.1) colorator (1.1.0) commonmarker (0.23.8) - concurrent-ruby (1.2.0) + concurrent-ruby (1.2.2) dnsruby (1.61.9) simpleidn (~> 0.1) em-websocket (0.5.3) @@ -218,7 +218,7 @@ GEM jekyll (>= 3.5, < 5.0) jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) - minitest (5.17.0) + minitest (5.18.0) nokogiri (1.14.2-x86_64-linux) racc (~> 1.4) octokit (4.25.1) From 3ec184c23db2256cfef4526e5b0857e98ea906ea Mon Sep 17 00:00:00 2001 From: Lucas Leblanc <44496264+Dedelweiss@users.noreply.github.com> Date: Thu, 16 Mar 2023 09:15:45 +0100 Subject: [PATCH 2535/3075] Fix: Increase the number of results of the doc search bar (#2719) --- _includes/footer.html | 2 +- resources/js/functions.js | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_includes/footer.html b/_includes/footer.html index 7e24a25d00..b00049db89 100644 --- a/_includes/footer.html +++ b/_includes/footer.html @@ -106,7 +106,7 @@ apiKey: 'fbc439670f5d4e3730cdcb715c359391', indexName: 'scala-lang', inputSelector: '#doc-search-bar', - algoliaOptions: { 'facetFilters': ["language:en"] }, + algoliaOptions: { 'facetFilters': ["language:en"], 'hitsPerPage': 6, 'distinct': 1}, debug: false // Set debug to true if you want to inspect the dropdown }); } diff --git a/resources/js/functions.js b/resources/js/functions.js index ed735f6a96..c31e52b22e 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -338,7 +338,7 @@ $(document).ready(function() { resultsContainer: document.getElementById('result-container'), json: '/resources/json/search.json', searchResultTemplate: '<li><a href="{url}">{title}</a></li>', - limit: 7, + limit: 5, }); $("#blog-search-bar").on("change paste keyup", function() { From b82fc75d7b65649f71e239ad71f204e010bf60bc Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 17 Mar 2023 09:33:27 +0800 Subject: [PATCH 2536/3075] corrected. --- _zh-cn/overviews/scala3-book/domain-modeling-fp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md index 960eafddf4..2e500de059 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md @@ -783,7 +783,7 @@ extension (p: Pizza) {% endtab %} {% endtabs %} -使用扩展方法，我们可以获得和之前一样的 API，同时也能够在任何其他模块中定义扩展： +使用扩展方法，我们可以获得和之前一样的 API： {% tabs module_8 %} {% tab 'Scala 2 and 3' for=module_8 %} From 9c750147162912412ef0c414e530758d60fe23e5 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Fri, 17 Mar 2023 16:46:38 +0100 Subject: [PATCH 2537/3075] Add result of SIP meeting of 17th of March 2023 --- _sips/results/2023-02-17-meeting.md | 2 +- _sips/results/2023-03-17-meeting.md | 9 +++++++++ 2 files changed, 10 insertions(+), 1 deletion(-) create mode 100644 _sips/results/2023-03-17-meeting.md diff --git a/_sips/results/2023-02-17-meeting.md b/_sips/results/2023-02-17-meeting.md index a076d75c5b..ede0dfc5bf 100644 --- a/_sips/results/2023-02-17-meeting.md +++ b/_sips/results/2023-02-17-meeting.md @@ -1,6 +1,6 @@ --- layout: sip-meeting-results -title: SIP Meeting Results - 18th November 2022 +title: SIP Meeting Results - 17th February 2023 partof: results proposals: - url: https://github.com/scala/improvement-proposals/pull/54 diff --git a/_sips/results/2023-03-17-meeting.md b/_sips/results/2023-03-17-meeting.md new file mode 100644 index 0000000000..fd973b4be3 --- /dev/null +++ b/_sips/results/2023-03-17-meeting.md @@ -0,0 +1,9 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 17th March 2023 +partof: results +proposals: + - url: https://docs.scala-lang.org/sips/scala-cli.html + name: SIP-46 - Drop Forwards Binary Compatibility of the Scala 2.13 Standard Library + result: accepted +--- From 0f03aeaa7c6478e8eed76777583e511052d89e35 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 18 Mar 2023 00:22:38 +0000 Subject: [PATCH 2538/3075] Update SIPs state --- _sips/sips/scala-cli.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_sips/sips/scala-cli.md b/_sips/sips/scala-cli.md index a667f11f7e..7a25af1001 100644 --- a/_sips/sips/scala-cli.md +++ b/_sips/sips/scala-cli.md @@ -1,8 +1,8 @@ --- layout: sip permalink: /sips/:title.html -stage: implementation -status: under-review +stage: completed +status: accepted title: SIP-46 - Scala CLI as default Scala command --- From 661479fadc5300d813092b3829d62c406a1e2e67 Mon Sep 17 00:00:00 2001 From: adpi2 <adrien.piquerez@gmail.com> Date: Mon, 27 Mar 2023 13:49:58 +0200 Subject: [PATCH 2539/3075] Add tutorial on how to debug the compiler (#2757) --- .../scala3-contribution/arch-context.md | 2 +- _overviews/scala3-contribution/arch-intro.md | 2 +- .../scala3-contribution/arch-lifecycle.md | 2 +- _overviews/scala3-contribution/arch-phases.md | 2 +- .../scala3-contribution/arch-symbols.md | 2 +- _overviews/scala3-contribution/arch-time.md | 2 +- _overviews/scala3-contribution/arch-types.md | 2 +- .../scala3-contribution/procedures-areas.md | 2 +- .../procedures-checklist.md | 2 +- .../procedures-debugging.md | 194 ++++++++++++++++++ .../procedures-efficiency.md | 2 +- .../procedures-inspection.md | 2 +- .../procedures-navigation.md | 2 +- .../scala3-contribution/procedures-testing.md | 2 +- _overviews/scala3-contribution/start-intro.md | 4 +- .../images/scala3-contribution/breakpoint.jpg | Bin 0 -> 137341 bytes .../images/scala3-contribution/call-stack.jpg | Bin 0 -> 305288 bytes .../conditional-breakpoint.jpg | Bin 0 -> 146193 bytes .../scala3-contribution/create-config.jpg | Bin 0 -> 112646 bytes .../scala3-contribution/debug-console.jpg | Bin 0 -> 157192 bytes .../scala3-contribution/import-build.jpg | Bin 0 -> 64305 bytes .../launch-config-file.jpg | Bin 0 -> 61631 bytes .../scala3-contribution/start-debugger.jpg | Bin 0 -> 102513 bytes .../images/scala3-contribution/toolbar.jpg | Bin 0 -> 111169 bytes 24 files changed, 209 insertions(+), 15 deletions(-) create mode 100644 _overviews/scala3-contribution/procedures-debugging.md create mode 100644 resources/images/scala3-contribution/breakpoint.jpg create mode 100644 resources/images/scala3-contribution/call-stack.jpg create mode 100644 resources/images/scala3-contribution/conditional-breakpoint.jpg create mode 100644 resources/images/scala3-contribution/create-config.jpg create mode 100644 resources/images/scala3-contribution/debug-console.jpg create mode 100644 resources/images/scala3-contribution/import-build.jpg create mode 100644 resources/images/scala3-contribution/launch-config-file.jpg create mode 100644 resources/images/scala3-contribution/start-debugger.jpg create mode 100644 resources/images/scala3-contribution/toolbar.jpg diff --git a/_overviews/scala3-contribution/arch-context.md b/_overviews/scala3-contribution/arch-context.md index 3586366480..6a33d9aa5a 100644 --- a/_overviews/scala3-contribution/arch-context.md +++ b/_overviews/scala3-contribution/arch-context.md @@ -2,7 +2,7 @@ title: Contexts type: section description: This page describes symbols in the Scala 3 compiler. -num: 14 +num: 15 previous-page: arch-lifecycle next-page: arch-phases --- diff --git a/_overviews/scala3-contribution/arch-intro.md b/_overviews/scala3-contribution/arch-intro.md index 91db84fc23..a0a9c5111a 100644 --- a/_overviews/scala3-contribution/arch-intro.md +++ b/_overviews/scala3-contribution/arch-intro.md @@ -2,7 +2,7 @@ title: High Level Architecture type: chapter description: This page introduces the high level architecture of the Scala 3 compiler. -num: 12 +num: 13 previous-page: procedures-checklist next-page: arch-lifecycle --- diff --git a/_overviews/scala3-contribution/arch-lifecycle.md b/_overviews/scala3-contribution/arch-lifecycle.md index 99e7c86d4b..df403c1204 100644 --- a/_overviews/scala3-contribution/arch-lifecycle.md +++ b/_overviews/scala3-contribution/arch-lifecycle.md @@ -2,7 +2,7 @@ title: Compiler Overview type: section description: This page describes the lifecycle for the Scala 3 compiler. -num: 13 +num: 14 previous-page: arch-intro next-page: arch-context --- diff --git a/_overviews/scala3-contribution/arch-phases.md b/_overviews/scala3-contribution/arch-phases.md index b4dff883cb..bc445816f5 100644 --- a/_overviews/scala3-contribution/arch-phases.md +++ b/_overviews/scala3-contribution/arch-phases.md @@ -2,7 +2,7 @@ title: Compiler Phases type: section description: This page describes the phases for the Scala 3 compiler. -num: 15 +num: 16 previous-page: arch-context next-page: arch-types --- diff --git a/_overviews/scala3-contribution/arch-symbols.md b/_overviews/scala3-contribution/arch-symbols.md index f81599fbc1..cbe3e1e075 100644 --- a/_overviews/scala3-contribution/arch-symbols.md +++ b/_overviews/scala3-contribution/arch-symbols.md @@ -2,7 +2,7 @@ title: Symbols type: section description: This page describes symbols in the Scala 3 compiler. -num: 18 +num: 19 previous-page: arch-time next-page: --- diff --git a/_overviews/scala3-contribution/arch-time.md b/_overviews/scala3-contribution/arch-time.md index 13e029e742..03894a241b 100644 --- a/_overviews/scala3-contribution/arch-time.md +++ b/_overviews/scala3-contribution/arch-time.md @@ -2,7 +2,7 @@ title: Time in the Compiler type: section description: This page describes the concepts of time in the Scala 3 compiler. -num: 17 +num: 18 previous-page: arch-types next-page: arch-symbols --- diff --git a/_overviews/scala3-contribution/arch-types.md b/_overviews/scala3-contribution/arch-types.md index 40ba8a5495..38cf0f3020 100644 --- a/_overviews/scala3-contribution/arch-types.md +++ b/_overviews/scala3-contribution/arch-types.md @@ -2,7 +2,7 @@ title: Compiler Types type: section description: This page discusses the representation of types in the compiler -num: 16 +num: 17 previous-page: arch-phases next-page: arch-time --- diff --git a/_overviews/scala3-contribution/procedures-areas.md b/_overviews/scala3-contribution/procedures-areas.md index 12a6255828..7d3e0e6ec5 100644 --- a/_overviews/scala3-contribution/procedures-areas.md +++ b/_overviews/scala3-contribution/procedures-areas.md @@ -2,7 +2,7 @@ title: Common Issue Locations type: section description: This page describes common areas of issues around the Scala 3 compiler. -num: 7 +num: 8 previous-page: procedures-navigation next-page: procedures-inspection --- diff --git a/_overviews/scala3-contribution/procedures-checklist.md b/_overviews/scala3-contribution/procedures-checklist.md index 3c0dcc3e37..5e1c34343e 100644 --- a/_overviews/scala3-contribution/procedures-checklist.md +++ b/_overviews/scala3-contribution/procedures-checklist.md @@ -2,7 +2,7 @@ title: Pull Request Checklist type: section description: This page describes a checklist before opening a Pull Request to the Scala 3 compiler. -num: 11 +num: 12 previous-page: procedures-testing next-page: arch-intro --- diff --git a/_overviews/scala3-contribution/procedures-debugging.md b/_overviews/scala3-contribution/procedures-debugging.md new file mode 100644 index 0000000000..c57ff07591 --- /dev/null +++ b/_overviews/scala3-contribution/procedures-debugging.md @@ -0,0 +1,194 @@ +--- +title: Debugging the Compiler +type: section +description: This page describes navigating around the Scala 3 compiler. +num: 7 +previous-page: procedures-navigation +next-page: procedures-areas +--- + +The debugger is a powerful tool to navigate the internals of the compiler and track bugs. + +You can start the Scala debugger in VSCode using [Metals](https://scalameta.org/metals/). +In this page you will learn how to configure it, and how to use it. + +## Importing the project in VSCode using Metals + +The first step is to import the build in Metals, if it has not yet been imported. + +To do so you can open the [lampefl/dotty][lampepfl/dotty] repository in VSCode and click `Import build` in Metals view. +It may take a few minutes to import, compile and index the full project. + +![Import build](/resources/images/scala3-contribution/import-build.jpg) + +If you have any trouble with importing, you can try to switch the build server from Bloop to sbt, +by running the `Metals: Switch build server` command from VSCode command palette. + +## Configuring the debugger + +To configure the debugger in VSCode, you can go to the `Run and Debug` view and click `create a launch.json file`. +It creates the `launch.json` file in the `.vscode` folder, in which we will define the debug configurations. + +![Create launch.json file](/resources/images/scala3-contribution/launch-config-file.jpg) + +To create a debug configuration: +- Open the `.vscode/launch.json` file +- Click the `Add Configuration` button +- Go down the list of templates and select `Scala: Run main class` + +![Create configuration](/resources/images/scala3-contribution/create-config.jpg) + +The added configuration should look like this: +```json +{ + "type": "scala", + "request": "launch", + "name": "Untitled", + "mainClass": "???", + "args": [], + "jvmOptions": [], + "env": {} +} +``` + +This is a template that you need to fill out. +First You can give a `name` to your configuration, for instance `Debug Scala 3 Compiler`. + +The two most important parameters, to debug the compiler, are `mainClass` and `args`. +The `mainClass` of the compiler is `dotty.tools.dotc.Main`. +In the `args` you need to specify the compiler arguments, which must contain at least a `.scala` file to compile and a `-classpath` option. + +To start with, we can compile the `../tests/pos/HelloWorld.scala` file. +In the classpath, we always need at least the `scala-library_2.13` and the bootstrapped `scala3-library_3`. +To locate them on your filesystem you can run the `show scala3-library-bootstrapped/fullClasspath` command in sbt. + +``` +$ sbt +> show scala3-library-bootstrapped/fullClasspath +[info] * Attributed(/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes) +[info] * Attributed(/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar) +[success] Total time: 1 s, completed Mar 10, 2023, 4:37:43 PM +``` + +Note that it is important to use the bootstrapped version of the `scala3-library` to get the correct TASTy version. + +Additionally you can add the `["-color", "never"]` arguments to prevent the compiler from printing ANSI codes as strings in the debug console. + +Here is the final configuration: +```json +{ + "type": "scala", + "request": "launch", + "name": "Debug Scala 3 Compiler", + "mainClass": "dotty.tools.dotc.Main", + "args": [ + "../tests/pos/HelloWorld.scala", + "-classpath", + // to replace with your own paths + "/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar", + "-color", + "never" + ], + "jvmOptions": [], + "env": {} +} +``` + +## Customizing the debug configurations + +### Compiling several files at once + +You can compile more than one Scala file, by adding them in the `args`: +```json +"args": [ + "file1.scala", + "file2.scala", + "-classpath", + "/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar" +] +``` + +### Depending on a library + +To add a dependency to an external library you need to download it and all its transitive dependencies, and to add them in the classpath. +The Coursier CLI can help you to do that. +For instance to add a dependency to cats you can run: +``` +$ cs fetch org.typelevel::cats-core:2.+ --classpath --scala-version 3 --exclude org.scala-lang:scala-library --exclude org.scala-lang:scala3-library +/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/typelevel/cats-core_3/2.9.0/cats-core_3-2.9.0.jar:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/typelevel/cats-kernel_3/2.9.0/cats-kernel_3-2.9.0.jar +``` + +And concatenate the output into the classpath argument, which should already contain the scala-library_2.13 and the bootstrapped scala3-library: + +```json +"args": [ + "using-cats.scala", + "-classpath", + "/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/typelevel/cats-core_3/2.9.0/cats-core_3-2.9.0.jar:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/typelevel/cats-kernel_3/2.9.0/cats-kernel_3-2.9.0.jar" +] +``` + +### Add more compiler options + +In the `args` you can add any additional compiler option you want. + +For instance you can add `-Xprint:all` to print all the generated trees after each mega phase. + +Run `scalac -help` to get an overview of the available compiler options. + +### Defining more than one launch configuration + +You can create as many debug configurations as you need: to compile different files, with different compiler options or different classpaths. + +## Starting the debugger + +Before starting the debugger you need to put a breakpoint in the part of the code that you want to debug. +If you don't know where to start, you can put a breakpoint in the `main` method of the `dotty.tools.dotc.Driver` trait. + +![First breakpoint](/resources/images/scala3-contribution/breakpoint.jpg) + +Now to start the debugger, open the debug view, find the drop-down list of all the debug configurations and click on yours. +The debugger should start and pause on your breakpoint. + +![Start debugger](/resources/images/scala3-contribution/start-debugger.jpg) + +## Using the debugger + +### Navigating the call stack + +When the debugger has paused, you can see the current call stack in the `Debug and Run` view. +Each frame of the call stack contains different variables, whose values you can see in the `Variables` section of the `Debug and Run` view. + +![Call stack](/resources/images/scala3-contribution/call-stack.jpg) + +Analysing the call stack and the variables can help you understand the path taken by the compiler to reach that state. + +### The debugging steps + +The debug toolbar contains the `Continue / Pause`, `Step Over`, `Step Into`, `Step Out`, `Restart` and `Stop` buttons. + +![Debugging steps](/resources/images/scala3-contribution/toolbar.jpg) + +You can use the step buttons to execute the code step by step and get a precise understanding of the program. + +### The debug console + +When the debugger has paused, you can evaluate any Scala 3 expression in the debug console. +This is useful to inspect some values or to execute some parts of the code. + +For instance, you can evaluate `tree.show` to pretty-print a tree. + +![Import build](/resources/images/scala3-contribution/debug-console.jpg) + +### Conditional breakpoints + +In a breakpoint you can define a condition, in the form of a Boolean expression written in Scala. +The program will stop on the breakpoint as soon as the condition is met. + +To add a condition, right-click on a breakpoint and pick `Edit breakpoint...`. + +For instance, if you know that a bug happens on typing a method `foo`, you can use the condition `tree.symbol.name.show == "foo"` in a breakpoint in the `Typer`. + +![Import build](/resources/images/scala3-contribution/conditional-breakpoint.jpg) + +[lampepfl/dotty]: https://github.com/lampepfl/dotty diff --git a/_overviews/scala3-contribution/procedures-efficiency.md b/_overviews/scala3-contribution/procedures-efficiency.md index 550a81926e..7db98f87ea 100644 --- a/_overviews/scala3-contribution/procedures-efficiency.md +++ b/_overviews/scala3-contribution/procedures-efficiency.md @@ -2,7 +2,7 @@ title: Improving Your Workflow type: section description: This page describes improving efficiency of debugging the Scala 3 compiler. -num: 9 +num: 10 previous-page: procedures-inspection next-page: procedures-testing --- diff --git a/_overviews/scala3-contribution/procedures-inspection.md b/_overviews/scala3-contribution/procedures-inspection.md index 8121065796..6876882e41 100644 --- a/_overviews/scala3-contribution/procedures-inspection.md +++ b/_overviews/scala3-contribution/procedures-inspection.md @@ -2,7 +2,7 @@ title: How to Inspect Values type: section description: This page describes inspecting semantic values in the Scala 3 compiler. -num: 8 +num: 9 previous-page: procedures-areas next-page: procedures-efficiency --- diff --git a/_overviews/scala3-contribution/procedures-navigation.md b/_overviews/scala3-contribution/procedures-navigation.md index 3a7cd43b63..28f605359c 100644 --- a/_overviews/scala3-contribution/procedures-navigation.md +++ b/_overviews/scala3-contribution/procedures-navigation.md @@ -4,7 +4,7 @@ type: section description: This page describes navigating around the Scala 3 compiler. num: 6 previous-page: procedures-reproduce -next-page: procedures-areas +next-page: procedures-debugging --- In this section, you will be able to answer questions such as: diff --git a/_overviews/scala3-contribution/procedures-testing.md b/_overviews/scala3-contribution/procedures-testing.md index 0e33c4452c..0d21a71e0a 100644 --- a/_overviews/scala3-contribution/procedures-testing.md +++ b/_overviews/scala3-contribution/procedures-testing.md @@ -2,7 +2,7 @@ title: Testing Your Changes type: section description: This page describes test procedures in the Scala 3 compiler. -num: 10 +num: 11 previous-page: procedures-efficiency next-page: procedures-checklist --- diff --git a/_overviews/scala3-contribution/start-intro.md b/_overviews/scala3-contribution/start-intro.md index 94a34e705f..4a2e111699 100644 --- a/_overviews/scala3-contribution/start-intro.md +++ b/_overviews/scala3-contribution/start-intro.md @@ -40,8 +40,8 @@ never a bad idea to check. #### Nice To Have -An IDE, such as [Metals] will help you develop in Scala 3 with features such as goto-definition, -and with the [VS Code][vs-code] text editor you can even create interactive worksheets for an +An IDE, such as [Metals] will help you develop in Scala 3 with features such as autocompletion or goto-definition, +and with the [VS Code][vs-code] text editor you can even use the Scala debugger, or create interactive worksheets for an iterative workflow. ### Clone the Code diff --git a/resources/images/scala3-contribution/breakpoint.jpg b/resources/images/scala3-contribution/breakpoint.jpg new file mode 100644 index 0000000000000000000000000000000000000000..748088c269c98ddff0acfc7968b4f6b1331f83cd GIT binary patch literal 137341 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Ǫp4{+(|HHM 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 ViKq^~LTvC}{fBjbN&nBv{{SdTgS`L% literal 0 HcmV?d00001 diff --git a/resources/images/scala3-contribution/call-stack.jpg b/resources/images/scala3-contribution/call-stack.jpg new file mode 100644 index 0000000000000000000000000000000000000000..8fac2371a6c18c490a680e5463722e442d2bc2e6 GIT binary patch literal 305288 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⁣_8sw^Rg9*WV#GhYJarKar^eygo67^>TN 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%0A6ygu8sOc9w>5cFu5`=)VgH zq;!nVS|vSOMrDhW_j^|xIo7LX(aJ&~WNa34i1;e=nb3}oY{oe8Ro{Z06aVgI4!X_x z$W}jAmAoBiNzg-y{1xU@X*$L$QH<&-xt)1eTYcqfu<G--bs_y6W-EXS#>ljXdH3-K zVCsq>joLTzCZ}Jz7^OA1`~(EQ0<9|n7__%OH5~XJ&knJ0dULN8PC}u66#*!NnXC0> zxQ93Cl5j%{+2;gn{B|zcNgrmct4p`W1Wa~nSuNz)(H1b-%^C{@rAo1N=J!Et7h4g3 zS9PQJz#$o>`d7oT!;+dlS(k4lTDiLT2m2QoQYiYW6JC@ig)99Qr#;T{x89gywE%lk z56bTI^U;BI*YXd~Es}AM{5oFNIbgLFyF$jigS8fCiQEf)D5Z%k@qBUd757sVbT3L- z)l+{Fh@`*&#oPbKw|))%EpkoJAiTGkJw6YqQH8YkLz#l+8ptjoIXb3Mi;B@eVOj?& zosN^d+Pc30oH7iC0mZmMkKmMDddMok04e)nhL^)wR=x4*-)#*7crYv5TB*)kIKW?X z)K`=|XGGSP2teX~R3v)0u<xk^6MLYTx`SVLXnKIZFVqbKbLFf5Ok$}={z;ZDX05ut zV0{}n=ZE=tZ+ba}3iwW1QvIPnzj7)IQFz_A06%+~0=}Ka-`WWPzX}pv$<KYXjgX^9 z-yRKW<E1X?7i>}NQ2Vzcg>^RIdUeGPjgo~|D}?=$AhMoykNDH)<rj-oR>RQdy)~4b z89SR;9pSvM$)+dw@4(7`Mzj}yQa=~A1T2<#7OPJ8zEz{p^2j`PNM%*=%sn%k1c|t3 z^-+E+xQ``4RRrCOs%BI4N;gni5?S*9z|B=Yj(ukE$(GWxSr~`w(i8pZKZR94%lm_+ ztl6e)q<O(kf`h+SD&Y!<Xw{3&4M%6PG!fZHlW5OacWM3$`Rhvwb!hXIqg%(D{fX=Q zfEGZK19=XO<uo<;e2oQ{&@T>1zX46o96meXo3Yq{)L#U*+Q*?x^PS_=m5+~ZfB9!X zc{0Ko0rJe=4t7ZT<tg2&c$`o983*K@?l`V7@iE*3d_wB;l*e6X{!jaABv@3)St||D zw~>SL6BDTF_o1QrJlKFtySot85I7K-Xg6dT7*E{8nHeRDn(ZZKZ5hfIj!x+D>wo}A z0SpzSQ3Vc}-A`WA^cgYLZl=VNY!(pK$ITkzxs7uAL|s$`5?3Fs&iw#3-Bp@=M&6wv zWS;3>xgHA%v73E~ZI{)10tQP)qcLe;DFW;7bbuJaFLm3KHr$z96KMIM!M;gz2$OtI znm+fp>f?JOf=iw6<aN|SQGB2%#<!Q~)u&Blyh;P91sZBNC99Xtl#&mKuDg8GyrsgH z4YC_{*SgkbJbzli_yHIZo1IdOC2nu|FF;ZRh*|k>YHf_{vdD9qQ+Oan&)jew3b&}~ zsRD@fs|OA}=F`Y6yYE|R<DK59Y{QVhoy(ynS52IySN4w9!xd9WqEg(E?Deuj1<;XI zBJ-#<J8FcsHg1pRykdf!!z-1hioj`L`Rb;O-uz~)tI?|upso<q${!V{Yhsk4HOcO? z$Jc;IWutbA!}O1a1HdobpliukDud>^PB-zw|2&3A+B2l9@KX&ydDNq&6-f}?IshU4 z84XY2(d|=Gto`=%NBeLx66Wp28{`7Uo+y&}1nb3>)PYHXWH*7^iT7;dlVbyWVJanp zUoYj~YTYIjm)?<CBLh0;<G*~U@x+|tJ0Bn2ihe$15OVH}`1I^0+8hB~GW$bz=;{wj zAtQY*{ue-s@F)5=1Xes*hd&zyFDYbwn}6;bk6ceMu{{6Z7}$Th)qjZI2JIx4<hyM8 z9cDsJBQ9+kw)~SC+;uLG6&n?-swa|f)d69Lzmn$9)l*;Xylyzj_QO8RD^I)A;F*7P zIc%0ye?d|rqpIy1z~1l4ff9b^HDsbe-rzx-_N}0Dz(5(0qVRqKbVdw_m;V~UkYDD7 zuIZ<&?8o*uZP?*}uut(|_3Z|@E-(<c!9?Y*KN^QTJQ5Nu6oBG%89i?7mn$0cu_XEm z3q*aj>>>kojxY`@90QsSZ6zI*<_F0Wq6EqUx5$_fW#zAQ=9`uwI}8qB$<sy2ul~ul z<v4p9b!yJAt>&#(y#wtTey+a&=cj+8WH%7d)P74;KIoKQ6Sk-JR=E)Le&DI_P>G6n zuDzL6pNdUmWknP~-J`qPJ-vVrMUr6tso=d!b{)WElhsf3#oh3-F$j_oB~KmX2t24t zNC;U=OQvAK^Y>9x)986I=RoSpOXEp-tg=^uaCSTPUhz68klJN;f*F0f5YEHGKBev$ zEzC~60*C^~e7d!tXOL<rY~rIM8^BgkR~nH}zjHIzwzMq@OkU2aDq7qDf+3~;zvr{F z^feM!vIwLzazTjIAuOOk9WwfAXeLD0K^v$mSlwcylLwZE$hQ0Tam!FG@mYdlcX~PV zs;~@w@EGKv;dUF_ZSK#XN5r(cJi&Bys&|QRF-UCA<d{KZ4-@SQUp%j8S;#U<KbF7q zdcRA97F&9o^Y7J%s}Nwg!YQg?=k29x-3pZWzz<M+U2KO$bo@;GI;>9}d8sJq)<)#z zH5C)$7##)<`_Hqv*}3NfLeXVFlN4RexJ22_ofTVA@j!m!2)con<s<fy8lyoM3tw)Q zoX(O_x_riM)?2tKDqilXadpYYFw|t>R=E7$?uL^P`s5nXHIKx~6b1OmG8$Z#=vBEn z;zCM!QoPbi2W83~-%IY-y3TLfrJ3jhZ$hFDdPxQPp`ZOuHLrAYTb8zcBpRFICF~61 zzRS!j&=&B-%yj+*=>K2W+dnXu<K@|uo=Ant)9f;brDKBE_|eKBMsc8ukpCFQ9B3iU z#k+Gm6rQ480x6f}t<@>em4`O<-2FnEjuNpn_#N`_X=-WAcS`pbIq?g>&KF8!8+MTl zuG?N3%+QkgDD`wdr5C!jR&xe`>;5sgS|ag}55_$_FAAc7wQS(L;pL|11K|FjJZXD; zBQ^auU5E82)!?acjx$4BKXeARGXtXprIMT2tq=a11)NCv$jth%W`O(NS}Z=66RQaU z%Ft)IcHmt-8@LU;987EJqbL9ZlqefrwP@e8=C>6R)t@rDmueWj^5ACXC0G87kbEw@ ziF#6L6Hy>Fm>NKEb0-D*(IZF_%|Z;MD6)vkET$i=5hmF2?ByP#f2at8D(1CtxcGQ- zpwheB6rVRV+9(sn-BN78U%1xlTqt-Gvv*SkdW_otrwyt^oxre_V7+lVb~}=1r?tp| zckO9rpV<|A$t>*D|NAa32|r62=)u@dYG$Un)~q=&x2!Mu<$;OKR)_Gk#n0o#P4epI z)F^<HnAlmc{`H4$u=RsdU;}tBH@^Ai2f^m0xM#+0uYnWeOA*vi=6;tJQNF9N4r6^m zG{rlZ1yagsr|NBoM?Bry+<}#>{qL%D2E~m!i4D3(-aTn-YNMHCfwDNzYrBcws@Odu zHA+*RweCzON?4KaJwR5B-E(e{Tpc0cFd};_2b|?@9PFERBysP&+$i8?*@z5dR%oxa z03TgmSXzmr61&#YJH~*_rlx?LNYV5WUw2p^!{;pEG?#nAGpolWQTga*GKunH=9B0F z@<b~;>^qSo$pQTZcEtn^`BUZ?dtLn@JNe`-j~4Tht>OIRqXAt;^JwJU8`$;04rI8Y ziNh!NDvjd)(l9lu@M_*c$~f)5d3Y<E8t7rZ(n`=z(F-~kj=lkBkFc9T8^1y3=QCms zsuh9;6*Rh<^-1$Zsz6`zALBHVYW!qNR^<l;K8t*yqVf=HE!K}TL(QT<9RlW$`nkO1 zi^F(26`r_r%Yh-&2L`kBKTrDt7^c*H@*RKgURXE=XOj-+^)a5Su5DO*^ztcxPVcpQ z7yC~>D#23E-C2%1H}J;1-6HPcePswT>izKcZEYza$?gn-V;**E#v%FmOOXH5LwOBt z7uTFWc})BlfN4;97r^^f@QUD<Tg&(cdd8H9Ao5y2eQ7#c{<u43oVI*HI>HsIByM-G zKT27K*FApBWZOnb0e^qm-|~a2t9m^#g|*rG01o(~?wfm$6AaVHV(kNw*gh#i1W<(d zB_5O*ES0$?+fzGMhc5!Nti)Z+qXA@Gs{Au_<YSD4XnR{W-@975fr_j#-zlDm+~Z`{ zW?o^uT*bC}GoG>9ag)7^tHvG#iXH%C>Vi2{x~eQ3Qbq5c!!8kg<Ph@jllf;4S&jdQ z^|-SzvM((|6IoS0mQa+fMVY-+p~KG()}GSdVv!LtsuX$3M8FG~la#ZDw=@GI>>9#m zFBqo2P}-wB{TWvTzy?3_i$i-uu60Yx1QC3@7WDHc0pv21$T4qUw_d&w^23KD=rl<g z3Xg0M-|y)=@^XvYoca1~w;2UR65n^iN4&HT3M4Me=#{gAXI1(doMc~&X9q~h(2CC~ znwKH1l?-Y0Pc`Ipzl?o_k9Aq2<~}0(cE_qM1WmmejXwY?J&m$gm{IY3(BlGb9ma>Z zc8-Z6A9VIH;|!dKDzlHI_(3WiAVlEnR0h2+wZ8yFMYkbuzK4as8J(+U9yC}{2o|xE zwNHE6XiqcsdGr$I9BPf5ThbFtmnIDmn2v#-h;ADZ2LLugZ$2w4T?y!Pd$elBzGS2v zkRDZ<MZ}&rv!Tdr=@|8Wl?LA;X3*;}O?i*K6|_*!GREUR)vtszfvAuatg7<MDYKT* zyDVWsDu?-S-v6hoGyjJ|jobeWGiK~F_H7tSjU|R;FN4Xh>`RvHCbDKkDr3f;HOjtc zUoyzChp{VR>=k2+qEI;$InSKe_xr<ho<HLL-1q0Yuj_gjE@+u$(v3x+<z!~!i18LJ z5yPh$0P?v=1%GyfvGZQg==?fcG#?4X2=6+TK$&(pkYz`hl4yUecV`zlSI&ya2ajrB z|9=nY<E-D2|3b@>)2h9C{^i*scIy~IDl;SHx!n)8fA_cce`HO5ZIe7clPtRWL~>h$ z*O=L}yFjsf*uvk#XEM}v^!<sBhCWDREFUlFv`n+Bca7)9F5a0%ZocY8KJAoLN*PKO z40OY$ByffAknl%MncWK%A1>*@>(BW8dBwr5%S7R<i91LI?Gu-?uy_O)Q0n7Gdvm_e zA6NpfrN80#?{*aupqig-n0oATp<C*`dIjm^5Zn7d3&yEosiROnaT&k%o2NJEY>Vf` zd;@gsv`l22xKN%Vfa8vTVYmgD#&R<o6yC9Ud4v#e4Z`Xl|MyJNH_lZ`#&ln>19C;5 zMKnPOFjXuBpLz{!RU&+giiJX$dSxNX<|^;uQu#z9Ii7NkW1rTlB9t5pZ+Z1MY+=|& z4pTRv;%DsyJNX49giWDOvedGGwN79r$|!81bI4?#NRz$=6wI_PEs5we*eficwTM;~ zem#G>dR|&Wqxhcnws*tA?(lb{^-X}M%>sS_BbQIuO#O??{dCh{l0ARYgio6n5-J$? zsRc)Gr6jtm^q;>$3()D<UOymflW#m@m<U2UyI`c0CJZZqq_<Q|a%KF%DUArN(rA2B zI=l;R<e4ytWjx}di3J`a0Qf+ceXui6?kNo&-hqR+9EfV=OVP=l`XOw+DQ+Qs7SpaG zWhIa)=e)r%+VG85jVn4Tj~;~K=}yc?9;aKPg3^yx-%3YWKDjgY^hf60wvgmyBTc$& zc<3i;=2(FLumXqgyO5meawg*&`lPcM(JravB_0L_ZQjx#$WPHzsWo8g`*C_&L+r#+ zE3!h(!hztDD^i*vLZRS;WictS{a<W(%NUy)fh%=8x$E3AfJ?Z*%J=_!L!1<M<KeJw zq-<hW#l|uYa<@1lS$`EVzU5LH&o?8DF2fY^ldYzsoaQ;dhG_>ypJU0*s!(qTX$idq z=2=%NX^QtTR!QyHc@Bf5S^PQR2l;4^SwUQv8O~{^D=Wm9TZ=IH23Xhu&1LF@X)zi+ z_41Zb@Kc$pU24^k8eUgi^-f)pg_n!Mb#$o6x?FwdVo&>CLHn&2fqF~MGZd3u6g(xL zs~SB}Zu>l)R<DQnp4VL*8Y%_q;$TomVpP_2Z%d9IWHGil^WQJLjKIB+MPxOI+L%O> z@Z@(_(S?BxD4l&NZ-K{^0nqm-U>LU&tBq&co`c%*)$%AfI6RINt7uiyE`MY9V!liw ztc%5d2$s;_mb^ybk7@&7n`3jze(f+o25;%)2sB`LHctL@2}ih@+R1Z<cP*x-cQbVu z))|P%br8QQ7upFqd=e%t#&2fV%@xaIm0cT+J^jqbVk$-1+Bwp33}d9cx9448U)9b` zAgC4|M8!w<BjrtI=idi(Qd5MGp;O_qJbCR-eg2bSlLuo=dS<4HfrZz$*5#;}?fZ^T zZeKTFc~}SqehqsAAd%RVToephLv||s{)+vm)JSzlT)F#2R8BzsE+klvV%c!d0oUj$ zT1Go>&TRRbJ;U@zH1n8@9#qBrLi)8AXe7VUcv=VSjuCIsKE%iX@wMuQ%Eg4xdO~mQ zM(;_NgDxw}$Pcp<0p1V^viOqUYAp@W>HFR{|9NAvSkSxZ%VuaEeP43^ZQijr6%w3= z0VMlAwy8>2G5ptfeO@*Vet&^z<vPV%{e(xuT6$A^jJMgAJ{I3*>O^?v48#rivS<6{ zyBV$nCtO4<Q#t;xaCJqmv_lf)^lS4>5ij(5oTT53>6IoxZl5Tw$1cGVeWL^aHp2)J zAOHX&^^D)4M=rJnI}be^vkvooNFu%X&G?SrC~bPr|Kj_z*Z<-zuK&3Pj+OeNq;FNW zaI(Rj>mYUVLU(V7Y%}hJjGFaccx-aFQFtb}Bev(gI{h)8<Q^??Pqab_6oWZ$Q^>2^ zb1SnHs-Cne@TuXW*(A)@th?CX(Zqux2{zR%<VbgWVii}Zah<5!65U4O@YeTr7M?XR z<&#uVlkDH5*6xw(hT$o!Ro!V)^FdjS*y*|c7^hOlkU^XWCd~ev8||g#ueHdGwt{;P zQ>pJ;*ljhPR`-?HU->Lr(76x~|K@g9Xa$t@yP6p%MsHbTTS7fUeQOxb*P61=IjXw~ z*24wD9bfLVXzyeE8YcTZ2I#}OC0qD5@H$MR;N^#<oUik@_iZzC>c~3VZOZIN!*$%? zU`vD9p++x_2)mo+HU)eepJD1&ad!L%sao(Sd&Rfr15JJT$30=`^Q6MXYfRawWUl(5 z;b!O%UVO~V4$5#4%{9m~b?rJ{PD)B2+LgwFR=1D+c#ayUzZE91-FfQ%Qmi~t&g+9& zj@$TVbe5XG7u9HoKT?p<qSD**AHb#2G$0SNw_&cU&R*N&xBd2AVylk$`*SyC>K>9j zO$y-51^)g^o5f0chq~jj)*;B2-|@yXL$8Io`0<X1^A<lx0sMP=#iz;Z&w#DGR8!5m zHWKkwfd!p&u+E2wQ&w6G^UF|%zYUFQ$-n6Ml!2&DW9iygMS@Pa`;kn8xK7gr?rb#w zTd`h*0xC|7rzn(?I%vDJMPF3htuM-3+iHK>k&-S87c~%`*Z7<(qI#W~&WQRuqv3Mx zTqrr^#TTdlCO-oHeoc+Dx562OX|u8)8`7wJhg)SfKd22nopDM(v932J^4GZCjEW)B zB?>gZCfHy444K5X)38|&cvKhB^x&t7^uh-rRObWRmjW2KJEQRFqudn%0eExoK7aO3 z`fo&vf)6<SyNJQs7z2OeI@IUOuqV?aiu4V3Z_~t9Lcjob6>v7N{}opqRsP-;2rga& zl=nqIy^S%-i#0;`MJ6Rl#3?-`M$O=7<XT;eI>TEA%5zqA)eH+RX-9N^$Uy8`$m2%= zatgx7zHibcX1E`^2`m{V-u(wa_pknlfL!PiFCkPue8bb5&7%gJ)=J{D-z8}5_35Pe z=@nSUxhEZSJBVYazyCSGv9ib3=^LD>46%02gcbAcMbdG*hq-~41hfIsnSDhCY#PNY zX|!9-Nzcf~C&Gbi$&^S}aZ{ICE%}6pSDOp~rq2sqCnRKSeU4EmAbE8J6@vjt6956* z*?$;IN_BY(?7LIUSQcR~7=REa+|3tXtU-<_i6PCO!%ao9$+x$5malFHtVUTp_IO9! z{B^5Plb+x!H(o-vJ(D#P2F?qn;!Ye{A&@$y1#E^3ipP%79>2r5QH=)pEBH^%|7QWc zjx_0<s`-vrOEm!$4pjpL-DIN{#>|nmAxxi`E!K3uUB-CYSXzd+=h+o}m$=D%7w{#e z&>gNOR&%R%b^zfClpF{tw5w)oHL=iX3u1d<AnO3_Wfskry;eyOtu_!G&fHuzflF*M zzi$OK3l<MHI2-4EgyLZI_D=lpfS1s@=gyW50#XKEi?T1>o#x2h&1^nEmN@T&tOC5o znOBA`MRiQ-esH|C+5PADl0vH<Do!LH$|aR+`nBHl5SOVGNH#BOJlZ`x@_aUDRt&?$ z;!J7drk7Y^K|9#N%p_)_j4cj)E~7{3j0^nje!~zmjG<e-*BrHGNK4?-Uo<Did6L#4 zHj)A05f9tDS$mHbV_M;ziL~Wt18~wMdGUy5ET>S^C`a}V{~B6qO@L=+T}XID;D++k zXmN_ct?9fG4GSrw>~>YbZxxep-7;HYvPohIn(zwc>fGy`S)trx-WVgXU!Ux#Z+<bj zQ3*lPLl<~lVa5f?C2#8FWsl1hO9y3O7tfb_G0ASpMC}--3tQJ*>0)HnRR)MV*@Ovc zr+JlC)n7dj%vrhrLfq^H@Sc-57cxJze$%$0cnQUlCSYch<Q2YOA1>@RYf6i!7=%Zr zXQ&pBU$E-HB`fubK>w;Wl2_@SDO65ysQk8u*w<S@Hh@1&?qrP%yv%2t&x+E2`2(%O z>H8~C{^;L}A(b(mm@ZGU+sBqZ0nbDx89S#L#mv}^zljKoOMU4{P_CUEDEbto0AEPG zSxtGL5zX)suR#}#NWzjMs^GA$by-ta;|yoE^{-ad8)2{e2{m0z)+GTfMbGAfRdf^L z&jL5Zt7J9Ww=&{vU+rJr7;bR=RL6z|>7AqY@g+Srk4m~!aXrK|Jm-_(C-G~&^6RkN zYeA#O;Qb$?l-i|#0OQH$p7kZ>>XReCMO?FgRB$71g+f<%zaX$aWe5%R)u-mP*{Vx* z^o|rkU-UL322AkfK1X=W0ibCn|97ULD#g$8156l-aoPaf=Tr`v@rqWAN*M5dd2mIe zjpDOqktY2?ZM$-7?uRbuxDS3+7JyP(BuyJ7l31Z=$w9L`1RyI}_G<H`f`vo2jag<d zoA|~ePzH%Ij_#&7u%k4mTHw*SpSXD3CGA|}49mFk0EV}&573Gv772(>^8;fI3p-!8 zzpi|<c8P{k(ms5oSfG+*Zn~#w*$ws)xBv`*r@p|v?batY(!%#i?2T7x>H#%d?w!T> zJLZj7$>BbeqQDS(-L10M%cOU*#FtzpS5%?`zqfW~Yx>$y)ZnD!=K8GQb<TcEW(Dr{ zT=@z`h&{0J{Iu8c(c4n<62~X^1Mh!zP%w>sid=4#C>Q7&DaP}sw9BNyJQ*SW1eI{e z_0Rp50$qiH{Rd0xRd`X8x}3poc2%0CU(U1#em^K}J+!zdyv<)*I}xZCHRN-RWWuz% zr~P1+AW84na(UuNV~t5t<(8}VYp)Djj5lWO71P|PT4Rx<yRi!{NK>YKIl*A;3EIMg zz+@2Lx=q1Y{qit3|HAKolyUoK57CxXn2#Ya>QlYSf^qf7#`WwS>Tk$R>eT4HiIG)q z4qcw7$dSLl2QkJYFZ35MU0BUSODYk$oq%1cS3vJbX2GCdnVfbrEJ24mF9@*7q-?=% zwaMR$$tIRHX`Hx)+C@XfAwxzAP6ViOMamid5z0Q>6sGX<(I?Xx?$WUEg~ty?j`c!f z)t^j7a58iEu4UetqBvXT_V?qEY5Hwh%*T#^-s$wJw?c!CP%`Sm3=9G9<>QQk8aPVo z%(e%6^#!-`$_99S*s`D4Fg05}9?t1iBs+;{mNYQ&$GSp1_T2(epM5=RSc%Gr!+w&v z)W}qE)ns!xHo<-hW2%=aaSguMFO3prdb8Y)?idL(4NgF^w`un&t2GH*_z&lYw?~{m zvi^`NBWBTq^hlhWI&rJuI#&@5X35nvjvBI6;`KHINzap*xCRN2$p+-bV3jO8JYT(o zXv#&_L;N^j0pl&l2!|SNCc+~1AVJ0$p{(~d;NcAH2;oU`xH4MD<yh5IAxT5sn-Kcy z+>9%~iyM8g8rZg3=~7t~d;UX7mG?4(Jm+2H(xraKuB@LfuVix>TAAMYR!FIe-c_T{ zkVR_8Crg7Z^8`|v<XwepS$P5QrS${LT;t!Ujo_&SH#sMuJbT{-53re3;-LDRJ@ovV zzp?6_O#+A5`j@B8Zse6y<8TT1UG}np{^-T(LhV;xy{vab`EMY&GA!!bI^_&Z+AEeA zF5w696Q!2NYLugY0A-1C<eXE|HSMCNA3YB{wY>GTqz5Av(SO<zKQ`^89{q|NLC1T0 zzW#soZrwjxbURufR_~&vYK<cB^!OGY<5NS58N9=8{cPmH#TaZOkFw_0dnHXC^tYsm z1uwF`i-_>tTE-R8S8z3%Hlx@q5O*9bqurEJ#{Bz&f^WFqDCc5gUySB{5Yg=FPM#Cm z$(d~8i7pV?Q&Z_Qbk08AHnVaDj`&t>#&i{xNio<Q!yqPr{9?@C*uEAr9tSS#m{T>> zfPuK6T+Gv+v(!k_kA>c{ZRKD2%76=?jzA7+;w;vjxBngyUAFf0*{{-HtFz|fD1h>s zh&yJq*@2jMyZ2FJlA8*R%{zU7-w&XgR<fHhuKEEJT+FaQP0lB%j0m-8uB#0z6I-lp zF5B7_HtgK9s)rir1jT)(JU6n=EuK(g83L_IF29*V^Fe7GG`sKAv3297d^WC*@n9Vg z;nKWvs7hw(hFA#X%}OC-w74dqW>Q$9b1SS&+h)Zaw=K7&cMc$_%|&I4W3w8!(lVF& zblIJWn4`&PE@F4HHqMGa?c%BFf+J52$Sp8u%;bj54ZrS&ds2xQq?ERO&tEF3*5Fy! zPiu-xujrrtRNvobRTG;h�Gz9SFe;)e9w2pMUgV!kIGL9z>L@RI!4-S07gHemr}Q zzFPMBY#?>%II`sIUvpjL4uoM>v$AdgFVk^MN1PW}UJ>&5JLlwnqgo2tyMkeavK7c) q2d(d}D=i@q+E12kcj##0Ke8?n`jLMUSb$bAeiG%U7PaV~#s2~5j>Odf literal 0 HcmV?d00001 diff --git a/resources/images/scala3-contribution/conditional-breakpoint.jpg b/resources/images/scala3-contribution/conditional-breakpoint.jpg new file mode 100644 index 0000000000000000000000000000000000000000..11bab89d3f477d75aeecc14aa2bb88822edb763b GIT binary patch literal 146193 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 literal 0 HcmV?d00001 diff --git a/resources/images/scala3-contribution/create-config.jpg b/resources/images/scala3-contribution/create-config.jpg new file mode 100644 index 0000000000000000000000000000000000000000..271dcc865c516b33152d1d533e31d99341f0f5af GIT binary patch literal 112646 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�Bde;BsmxreC{>|811xP2Fgr_5k7OXb1LK4lq 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 Lj;LwN|2_X-|Av7N literal 0 HcmV?d00001 diff --git a/resources/images/scala3-contribution/debug-console.jpg b/resources/images/scala3-contribution/debug-console.jpg new file mode 100644 index 0000000000000000000000000000000000000000..c9a669019d65f4222c92ebb201bf4fc997823371 GIT binary patch literal 157192 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�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 literal 0 HcmV?d00001 diff --git a/resources/images/scala3-contribution/import-build.jpg b/resources/images/scala3-contribution/import-build.jpg new file mode 100644 index 0000000000000000000000000000000000000000..79be8450cd4ad27f3364d13d47322ed6eedc6b0b GIT binary patch literal 64305 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 E0fs-rwEzGB literal 0 HcmV?d00001 diff --git a/resources/images/scala3-contribution/launch-config-file.jpg b/resources/images/scala3-contribution/launch-config-file.jpg new file mode 100644 index 0000000000000000000000000000000000000000..898987683f5887544a8c3a4c2227f659cfe8d198 GIT binary patch literal 61631 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 bjsy0=`2+6e(fx-Q0stOgq4h8Lzo-A%iaIm{ literal 0 HcmV?d00001 diff --git a/resources/images/scala3-contribution/start-debugger.jpg b/resources/images/scala3-contribution/start-debugger.jpg new file mode 100644 index 0000000000000000000000000000000000000000..edf17d700afc4ed9dc5f842667132af742fe1e4f GIT binary patch literal 102513 zcmdqJbzC0F(l9zW1PdM<g1fsXxCadq2=4Aq40m^T4GuvQ2!!D75ZocS1i3?!-R$l; zIq!Mz{oU`6ujiSW>h5Z(uI{SpshQ_?^7adGUs_yB9Dsm;03^W!xLqV<6mvB*1^_83 zS^ypZ09XJI0tSEpAvN&C{|W1WFf|0!_jE`QW`TeNkik1x5MTviOz`dqo@V~g-*Ey! zI0-z#Ccel2xJyXMDUz@<vM@8UGJ_?VS=o4**?3vmNmw{|+1Yv7I6!QOj34dX_2Djn zy@L2r>s?h4KjA_!2NLWN)Ex?#4)wEluwWGSFEG|m_zn*O@<%<eAU@<zn3&+Mg1c7k zj@!SE(OtbD=Ispd7=VX`g@c8Ghl7JdK!Cr8go%uVh=_!Xj)96vh(}CBh(|y`Le5A< z@{pd4fPk8dhMt*)ot>SSibsH(m7kG~o%OB~2m}NKBt)bK$jA>^NeM_<|JUKR4M2kj z3L!vZ9|DkQ5Kw3kw;cd6*iRUcqjyaG86Y5`pkZL);1TX2f(SMD??ws=5*i8y1{xZ~ z_5$+(XfzmfQWg<dj3;_<5A85nUqoiYlRc_<kEJy9m7GoA{w2aaY@7$UcodXW)HJm0 z9GqO-JiL!Z#l$5frKFWrRMpg<YG@i58X23InwdK|Iyt+zy1Bo4{l?EfATTH@Iwm$Q zJ|QtFD?2AQFTbF$sIscMrnauW;oXP!j*p#PpSnK}kBp9uPfSitFD@;wtgfwZY;GMK z9vz>Yo}FJ@-qCeO=O5t*VgH~D4WtVa8X5{3?v5@9NEh&gLW71OWr0N(c><?rhw+g0 z1w7`X$jplO2xM$ZU$OM<hwfpMvoBH{+>!R3vj2{-m;bLQ`;)L=bWH<DP!J&VpwIvz z;E)U8gGhmNAF=R}AGF-x(T}aMFr~7U3R3oM`eL}=I+9;1VURWRtj`5A=}i+Q5t%cU zWj^<pl>2<^xLxKzM^<f(9Nvt4(^LIXhP`Zh_1=JWqV@9fQXN6e8qUMsq_yP3$O`h9 zV%F4la-=U`xz}IyQ$xjPz2o}Y3!&ImV%Ash>mscVy*!hz+cObVY?Q4vr!%W1RiOEP zCHmWhPn0kU%E;^)R5OGFUeH|g*F#Os9@}?usl1)SQ<y6a{k)Joo#J*~t(fOcoK>6M zPROebHuR0+10h7V*-<ifvk;$F)?&xXR7h!h;%N6jt#6cm9L)A0rJ7b{Wb0)t4RILq zvv(y*l@KuJ7!o07_a%NV_qY^h^tf;(@r{CC^u^}IWLH+LPX)$}htG2BwY%<)<VA1S z&BZOSJ^IbvtM3*Vn;p3E@@BaO*sz0U<j@~(5ji79*1ztCYJlP&Mb7?|{W7%6SZF+{ z6mGOLPa<JtKKjDqLc1sbL&1@FC1-~*MDn0XsYX<%q@NBY;Ic)_L?a-iImCV<k*pN6 z*`gVkzn(cXcka`EFu<#I9(b=LSF!RXWYHcK$<@>b%R+dTkRQ8aBMU0#RJC*i8~iyB zEdb@Lpe8tZww!txJ#v!$SwUeu5l+Hmu@rql>S*zRqh!JY<MZH)iM`#B=jq85mG<ta zr6MMo8zW|iJwgE_VTR5hiU@ei++o`d4_*piDL|p#RS|yIEns%kQz%dC17*zwiEBH( zrJ?p>pk8{k9W7*(Evo8vJ)VpezUaG(n#h{mx-=EzSR>#<OXSOo2|ML5hnI91zv|i8 zyW+~yB!}UbvT+@j4_La7*_jBD9R1SUng{Bocl6`MaFiZTtg9!`YVW_=XT;$Ld|7Wn zB}X#Ecn^IzujKAs?IyK(IS41g`C@V71YSw#eollGe(fOas$K|<!<%(_53gAl*r?_9 zBmy-T1>(Tc)ier|5a_mO#MBHE9`YAy>B?>Eo;k<YrguY>1C6P2^GBs4koRbP?r7z| z%l><0uC!4bT2wX#DaDZ}FP))09@8E+bm$O5c`&TQxsZNUGT4UPNE}}K@B#6YO)36@ zHZk-Ucqy-5McJ~Arb`3;d?C5&g_aO%tHU+$&!QxyE3+lVPlTwq+{Y*flI&9Umaz<s zz7>_t#6ifzKKSz7<m-xe41~cq3>C!snF#K!E#76Qavd?mEOQ$?$+y<(Kp{F4&$IcK zlrgW%mziD@q*}#BZ|&JGU&`@HozOi;*RWoKwt`5E_hkuhBT$6du*|NKJ4-lXt20}H z+T62vv`XnWPWMKYMJj~T4f+_`8!OhVK!V;|ZXSij&-xb7^>J_Hx1SaF<7ua5yw5`q z9K-S7TXtT%UcZ9c$v#P3%&7E>vD&Aw_Bd(21rYJjTrD)3{dh8>JyGi%gWii8#V{kc z2|OTTJNYsu<;hVj9@W&tN-m2o?iPPf5^iGfmEv`yuD^bl8w-3<aiufFqZD5r0+iA5 z34YNCDeIBhYWwRi8tE<WE6ZuFWdZNJ=v^Nq@x<N&-uXvs^u!3dO@|~s0TXu7KKKs4 zw&FV&BVpdLh_2RaxJdR5K}M;hhQ_NhA%$NI9$+C_OkY5A%$*{1!%Fe23%1l?Y+d%2 zH>|yLK7wvAws(2qJLmqQ(|j)s)kqDbgsE$BPHLHTraDS21p)gxlt~`M`)+6g1O70c zLh)B65^DuVGNNe)WheSLX$~WGr6#Fb&l3GM_a@hEXZI&~2B=1(PYP!g51@}^$m3c4 z67<E{h!flih*HvM$rs1FoQdM}d}cd+=%UiAKa>o2-XpU#QG>QV{`4i?rn9)Ygf|HL zb-*m=@XB+j{UEZMn5dCYY5Ar?y`#!HGt*=YZ`GW6$n6Dl&Ps^seBRAo@(O9ap}H=c zsH_@RbGQZStV*wCM{Ky0o(4cHk#p0-!gJp^;m%fC8hqmBUrUgeSI`8h*?ng65fA&+ zUb~Adn*<?c<rb*yyNbDq8Ldtdov&E6OIdNe1s)dX9*LI}k_X`zD2IHNI3)L`Oi6m3 zL2pLi=6J8fCw|F?SNaTcXvEr=s+$~AgybdM#YbihZLHac<c8s!SLb;?X3r$(3gf;= zwp+kb2}w(gS-aeyz<9|m#6q0PjG*so$nq&y+X*&%U(O<R(q-PE&0v9eMbU7kk)?jx z*1j1T&}|r@stG0RHRLhESFkPWI<|Y_<+tuVKv9PlAz+T(oH&M?<_tu<j<RcmBlacE zr5<G@=Ru!kQPkoKY}+$8@bGAp9(SO7GZm%C{k~tEO)hTS6xJxD;4JSJFx4i^?@fsp zq9I>7{W3z)93^`(z~&I168-7&+D9`3m!`u~0yYteO#yS5&bI=oR^c$$*+fvO^Txmc zu`c=vOe(f2q;Pg1&@Y6i@Tq=^uiMnLE7N?qBPvHYTWswmrP8Bik_Z%WdzPf=8?;oP z&o7nrxMlnh(DY$Xc}S4b>fsKHkPEj2rG?Mxbd*R%Lq5-_qObx3z!y8ETfoKwSpTMZ z3+&t60^#xBrl<tmSEA383^Bw@R?);Y-U4TZ<o-R1A4DVF(fu=z*P^Dyf<z-<@G*ZD zP_X=_)XjM^U6Esv649`7Lp}(@*^u}oQv+UZs>{1!djfZzsHV(QuY@h$EQ{%7V^i!W zxPr|cA=0NdHx(^;$-?*yOI}i6!f=?`?Luf1;`4^<ufjJ~YvhdgpE`Q9(pO@WWI>#T zDQpicd07Ys0W{rYoimY%3I*JGL&Bpe&&F4)N6VsbG_8q3APU7R?5-yVzW8)jZ4@|W zToN81Svql;j>XUSv6OU&=_z@I(fHKr-nf=upJ+I$e8ck!3*Wu!x$$mozY0a&4G!NE zyC6O&SWtfF9for~q_UA$DB{SRW)q%NT`aR-w<0K&6SF2^+$Ec2gsB!+@t#K7CP{vW z27fO-mx0V{<TxYplxqUJOzB|(Ihg~xILn@3>!%aQYS=o@pke&i#!o-cIztKgF4rBF zG}_SZvbaqi)*)XE$R3R(Rq<3jg?~*a`9$2?8lOKh-Nt%(a1gSuL|6AwZ6(&>)Mx}Z zbjU3bDhHcipe4Z^8sSz6XApKVK=dl8|J98k*)8De!&`R?&<~9IXvWRG-y!ExXORyf zR6l#uLy&^bEbo4N<%2hZH@3}NU1$5;UiIlQ^rib3_mf+|y$a`A-%IT2$cUVoA#X}p zWQnZ7B*N^qKh*XH_ZFQfa;`pv3+sa9Hu>{?vk>292ZQaj^#|)oBfKA{JG*wrS0ntV zGY-ANJPf{Wa4#h@wEEk26E02`bVvpAcX~4m?#-oxg7(W3jyiv`M}yCLNTb-^N-OO3 zkFVAi+>m5AZArBebTe=s8$HNL>szi5GL?uYZ?xO4zVCYT^^3cH8E2-GofSFjeB1p@ zSy&#u!*rdilg;X|bC%hUnaNDN^NW2mK0U}e50M+TBotk@CuWkW$Gy>KNbyqlTq0ie z4D@s&TuA76b!G0&S{00J7=AXcb=}KOf;;@2MO*)ASwJZ9r1(@>%EXT0vpIG!nLNBc zmr23gi$T3`-E}2+e)c0i85erHi<u`3?RG@45B8M@%1{kn3`afX7eXq9Ru?p$Fk<a) zdU@}DjupY1=Q#%pAup2Dw$$0`m_)2?Y7o7~A3u4~VPLF!@RAE~aiKC@ua%HhHfl~0 zX2@!;bq(TwCfP>IGJ4j@v$=p7J#+5PlZox3tc|_UIB<a_KM>82Qex}2OdP6me^ZzS zhhFLv>5B_{6oj_jPP=_kbvDyPK64oxs9D~w2R&$#2TiW?Aq^Xn+sB3UN#ymRdE_K3 z%R<A!!F~w^ABw2%6$znkP~#?n)+GLxS@rrY@N_|0E(0=%`rn_CEt{80!(4Mh(twP? zgNA@!hydn!6nB@+KCL)8?rF)2PSF_^I>Tk2l^a$0xnaJ5d9m4`wzr-3g0aS0$;NfA z!!SrHFjl?<uO`a#k23BJ`gC>p?4z!OT5mP+GJIQ=1Qa&`x4=Ace<>RTZZ}lqwK+w- zz-tJ^0<RhFxw<le<}DjCNfoP+*}e4#Is*O*U$1#y7%H%!ERMS5zZb|ce(V4@4Wa$e zj|`5CisaI|>q&~Og~~B8M`;GtsiliLt!Fn03mPKYk<Bt(U9+^okdG_>b{VE6H!+(- z<Ve0kf2oYm;sL=2WQKNLETz@3ku5<VoA&hP6lkl*Vo|v0T95-RkD}<kHQHfjBFf-C zi!2j-LpPUQMQoh!^r}16jZUs|TRZ9yasFm+9&0iA%rv5Xb$;`3wwCzp#b<(uMpxtz z)a2t!mCHBl{;zuJ9oM)cn`)hHb8Urh_)p$n37`yOKOfSH*4>ap3Q2nM?XjeWeeZq7 zUaL0Gue0kHjwQSRbyg5C;YUNcL_PNjmsBOmGj5+iZ^oMY6I^6uWcr8P3fEW-LqqLY zGFMBxn_Y&TqWypsap;vD<Z#Qqb?yu#{~tWgukQ^V;K`?`uJrme*E;veXW+3g+7l&y zCgKG(-Lse=W4N<700m|}@jT{pA6G@lCo(Ut7sdaZM5Vjw;S6GuK~x`2`;xthr4)CX z%~&Zf)k?ZVV3_Bq3MD9jXoG?#l2fa7AndiqN+>p@Wr4niUn`r_mEuP#wcg^dc{X(m zSn%-sq?tm#ro!k{IP*U$e&nbcfwLG<HtV%KbI5;#r9_&jh_XW?%gAR^xSSSaxyQc4 z8syvwPf$254`mQC3}X!KEBPe)#h@Z7b?)>G)GnV?r(LHRHINlUWAFw##Uw}?pw2I0 zt^X{(!xr*}YCeK2ZW=4tfV+#k(<c`49ljV3TF&!=+=OGma2Si$w(V8Ok#K*L<_u>B zNwsfWeX=211@u+l8|~<@<tQIKqmPvc^V3VPeug*L&q_~-vZ@_v92*%NcHb3}KPo!? z{4CbRUq?#S;4tLvgZCs}w4wbO(bc?8Q599Su}M5e`g`qE4V`0T=fVVO_7;hczOJ|A zkE?Wf(A$iXi3|1#YH6vjd+nXcen`^_R`alGqxO1V8*+KF9d4b7mCqDX6DUGtNR8qu zsp@fGh(unnCcQYq1`}!s5K1h<swQ8>oI1LA1Fv_WO7qxoT0AbhY<?>ezDz?JZXSRu zliHH^2^hD+R87$n!&HR$=P9}1cuiw=r_}&XSUO(TPEd-FA^Dwlxi>htIMJh2&cNVf z;!L)^NY_3iaXK!F+v%~xr_E-5{-||MNVCy_;YfJtDQ8|A!uv%RB$pGYh450~$)8$k z@a3A;qhZmC3Nka)l;`2rt)V9GZvkSoTcAlORqGarGuaX<m79(-RZ>?oSQ)jUXnOgj zBjkC+r=S97L%ncfe-7vMj)^nQM|{D2#-W$pt8ZC}c*u#|6unsK_*kpOlt}9=LT4Jk z_WJBcz>uqR72hk7zR~Oo!(6srviBhf?+@gna+V&_z#*U5o0hUpn`Sse<EQV<H-n}o zN4nnQU2m4V1rP+fN7e(TMR(b_qfF?9kx&7XSFa`n0K%eZU0vC7rpVX`&ZpvbF9D%T z_`KO?^9!(nS>!LtX^ZRuLLV|Yd8wy(Yc8f?$l@{{iIkFA#*T-dJR`%{7WiL;XL4|l zTQAkSxGvLcbW34IAOb8Qr%+HMl&OrlKKNBVu<e6;;txJuo-CIu517AnD~p?K=cxU3 zwzBs~(5n9GppSx5=C$G85Z#sy`3IG1<sQP)I3>=|DJa~{ba{8Bz7ic=OxYlKICsv) zR%)EJ^+CIl!puD<U?-2@s;{1eLdvk+k(-AAv=vmO&+KMjt-Og5i%xm<mT4jkM$q|0 zUuAK!*6D)sjgpLHPhivBh9oyG_x{KQk}59aN<$rX54JG8E4{+!9QWl00q#rH*1D~* zZJSlXFSw9aBoXRq7n^D6Z-g25vtHwbHocwfDeRIpIKJ^dcIYm~f-lgGwKgxyh=yA4 zEUsU_C#d_`ui1~{A!hgK1FT1!_jnYiv>j&VQ}&2+%$uSQ*AGjYUo(0P4ID(iRM+m- zO6p0P&&5qmGco4TmzQHr`Ju*YDwa7{_Rj86XT5;Id?NfW=bd4en`86NI|i6UEZNW} z)h3RK0^kmo%C#vAYQv0YN#HX=%2?94iIxhr++MB;Q7_50n{~QfJ|CM&V2T<`lX#5% z5zd;|<VD*hxIY$0JwFe>UcA~`xT+F*a&4YNd~iVgt^H!G^}^UY`*Kvq)&rSREubhz zkF#>+WEn|e;sJ3kz4Dfj;r)+mZus~B)z|g3`5LOJeWTY2i$n@>@;j*SP&8U)y=WWi z8>(2f=o=rg(M<Cm-2&r9w$5YsliW#r1dgT0U-jO@d_^?>D#|<6eKe}e`wV@ST}$H( z_KN|46hbulFw?-%XE^v4DCI*yg7pd@EEd<2Q{%MN3+*s)V16!s@5S~kY8QcHVb#VP z8tQ%h(4iJXmH~`1Lo+Q}5o0p)$m5&pN{ZvR7nZpZSXM>ZJY;0~71v%{*Q+fB142m= z>}F)Jwlm7M$`Py*mNzvp?K+#ic%~0S=aN@QzS`#J*<H_iQCF9~jak}>7DW`yNuVXr zYa56YJO!Zgwe_=8_tA9)jf}k2>3vaBLJSBu<Q|zGRZ}swW(skY(!UECfh1IX>0&@& z0_~%GF=XNuT(u*}T|>Pl6@~ElMTJ7_21{7VffVb4+=HW-G+PK^{DuLAQl6UNJd&$d zgaC2+`oy-JmD*woCmFPdmruuyV=3c@i3-;1A&~dF?*wCNGL5)?sKP=*@zaY@hy5GO zWeXB+l2<7P79JiR;k}B`>?+%4Y+Y*)tEkRivJj=($yvClpv=;2NY|ong4$Akvh`@l zNB3*C{w**dcJ1@Q7hjC;4>%MYc>x^IoW2KGVebAJ;bgix)}6SbhNxDq{R#f8B?ETo z-&FWr^nSy+acA1T!3@dPyIx8YxCK7=62#S^bz2X$OvERAuJ{DDlD0N~$c>x(ZvKr* z<QmH?TidnN`h1}XT9RXc3B6s{1(v-PeY@q6+h^yZ+S%tRDL(0)QSW9O>g)E3nVRz9 zt~@1fzTP<5+-Rg1+|(%jF{kIb=*kXrX!H)(xvyN8*^?S8A5IK5T4is=W4Cx!Z@q1@ z=Um{k`CN~jHhb{#p&4)fOu4?GOw*INIE}XF!ccp0gx*G-0%C>;If{$gFG!}_TnOzh zRh(S(E4iq?uI@HB;+lj!5DnRkBb9#54Gq<ef|}pVVYQEB)v6q6@c3bCZwKTH*DHG= zh;uatIzB#YV|p*COb)9@-OW#`^bCr&)H-D>8W0x9c32~$IQ<0Nqp67l`(fk+-<0%W zmUDcHqn-^!l<mced44b&dFDE>+NV#^y9w16RUdeB2=#u2C|yyA^odIG3Ch#G$l7`A zQFQT;=9Uv5`WKYmR>>7@+cUE_P6XbBO>sDhI%w!Tp;MEgIi&XP_5fUduAx#@RZ0~$ zHxxN2t&j86;yCla)@GVlRNp8ClA|GUE<IQWmNPzey1N@^RSq)RWQ0ksgyPP{8#X9m z($?OjGPfULr8A6m3?q;yPJP&cP759(mRDF;96|BRx|^o??-Bdoli_loeB`w-vpQH~ zWV`XX_lVZ3%ycYE4gc}pw`>7-lQOn`UbVyn`K(#4s7W7YYuSjIS0)1PMF%OK8ER~| zK#5IZ-XLsEd>{uQ51EXF<S^?;%(Abn4ntLghXNN{a;&$&v*uAN?>;`N*fj*sqGco; z)2@szy^qHKMsnUs)4xhjGW7lccb4~SWdr#$V&;dXlP2&b7z9!B@V9_qY??2duRF%< zQjX~$DPKbu6xp~hKDOt|bV-+On@;|wS`E1cgZN=TPf8a-DY3RSaMm?k_(a*H&m(M6 z3{w^U&d&YoIsZ0^JNYc}o~;N`#)`>wx)Z<6JqaT2&PVI!%iNuA`wQTca7}o_)R&^U z$%M2r!BVA?M>wlC@7h*~yACptx_+9yLYJMFNmc;n6S04PhMp-5$K7pnz}5dd95CI+ z?5GQ>E=f>b)*3NNNHgiim57CaLVJI<w_^86+XL;CYYPGIjZ39Ln4dx>|9{yq&;9O) z8Cx9?Ne$QWLTAfY1Lvw*KIa#~*9TYI85v0FI}Nu$EAg7ohwwk4nu7n|(@}4yfZHX= zw^ENE>nbWKh)c<ef!;{albB&?VC4V}`ZKMp9qpAQ9+7~KF%r0S&^7r0bdvG{7<vW{ zwjzp(vVXYe{`G!3e&=ZffDwkfy8bo)Kc*lX8aWt%ZaoqZOW45H9(2S)JO^P;7f0JW zI01w)4NUb6LAV5j>FvP|g7D;By8aJ%=MFac4&V8A0Ze-prN<y`caB{WlfS_Fe}N55 z?X5r@b`Xc$(8?ODAM)uB*zgYayo0SQoxr|*4|fzI8Ck0;gLiW9Bmg7;DL@WT1V{jV zzzHw|EI}tS19-OvQyc&#F#pkS%Hw@6uLzdX2TPd&24D$Mzy`1a^uCt|?sx#=fZ^BJ zIvBIDeoulxdISJ4^S8H06aWAh4FJ~>x3}LiZ*Q-&Ku_{40JK^EDsPhk0Nf{Fdc?0Z z@^k<|eGLG$9lz4_;{l+~9{?Uq+3MNreQ)Q^=?rNMI>`_70RUM805Apt;GWixaRc-2 z@`3CL08jzPO12LG5<#aqr3qNK_HXD0o#DU6?LXrD9KY}0YbZ#_yB`>!!5<9#ogWzH z9vmDjJkmWRB*c4&h{!1D_mNT1P!JLCW8X)^z{JABLPEuPfQ|V89TN-lyZ0IjECUUL z00V=7iHwMh`M(agA3*Olq&id}6a?tF{lj}r08acLZr;1G_#VI>Lc&78!Gk_v0&s!- zBliy<@a<1e>V2sD;9S0f2i@TRZIA`I|F3~4Xsk8$VuWA&_=3^6B8pPdQdUoNU3#S} zKQNo4L5|s&PF7Vwthg{P%|u#6OU8YB)e5oGF3QX-b<aDTE6*LfG)Wi5VDxdH4FAu{ zA*R~?wHW~LjyK<A*xF8&JsVyiCJUR!TQ(7JDUA=UIpsONO1HeW+T1sDWstS3UAFY3 z#5d7wE#6K~%1fJ`8tt)?nK+W2UzYwN)*LhLH>KR}!DF`U&O949pY$H*n_ufdBe?Ls z2gpaDK>A%+_-7tUSljP#|0Nw_Uj`O;eL#d|Rw369si|-?k0fv?a3G-}&*5l4IhRi& zC2(jsDPd=Xo5pnafnV>q`Q&q%;ohft^|+UyqxN_;Ka)X#xFV<FQdb?2RBuIPdpXOs z|1sQ$GjE>XW$|Cy`<Z~HFw}>>B}A@JRl`-7Q*ab@;9uA*(CPB2N}P;w%wgZdlhyj* zs&Qz6X=s~kU-IF|y3c1OT?LL4o^KrWf?d6<CpZ;n-m5#l-|ItR7|^wWExQFc6tY(f z9k22^+kUq5j~iWF8$f{OdzT6wyD`3ajj9lQjC*+MTV5WmZUfoUBFgLfb#v{&o4UOH z&^G9b1SMOFX5$1;DjlSfrs_CvV4}{y)r86B-7$()C{cMx_ukb~xJ0in09Cc|x3<2^ zU5F`10OD!U_l&Cenyn_Ad6R*W3v10e9~_zd<$~j@67{8@#k>OR!Uq@DE_<}otr&?# zS-entuWo_d3u;jO-^p_@KrJ5s0C4@=Kmc)d(7IRKKRsA2p+pttB9M+IXvmC`hrU-t zqk#p_kY=Q6#5H}$Ya*L#=qlaBr!Onzz-4-ObDL%2vreOATi}|0ul!s#cGYns{kc}N z#cF=WaGG=N1;-ZEPAyZKINwKi5qM+1K!0NQv*gR&8=K<tg$sqy<6D5~u1m*6UjFIF zw9qR7#TbW=lt=*J+)Ds1U2pyR-pm^*2-6~IQ2@a8|8T;`WU!%keD3|h;M4d7CABZ| z!=YvtLK9vCaVl)ppp0YZvTLgjS`0HO*5T2v6n4%5nRJ_^RpsFA8#m%+eRtyc!Q)n% zGwoUDqw>Jry{Q?d!3M6u`NRgDx#F?nH>u|f43?bno~Db<=dLXwq+K@BrF~VelCw20 z`pVpDYNpL%)z{pWt*QEBR&{K)Z(J_@<h)JVzNPzio9~#oJBNIE$|n#W?&BYRO0y-i zYB3ZxtdrVjp>}M{u~s3Lk=s<dbw^lucqS3wWPY7`Kx=nE9##!cU>?J`dYQN8Mb98a zf+rXAsnbPsI_`$2&CWL?hiF%>9yKOPhl{k)>(=n>i`IMujI!XULUcd=Vk}{hbwFII zcWcK@$X+vUOE~B<<P#DIx&Q#|JoaKs9$zq@Ju{gEAXwbjIr4ed+IQkA7{B_!+kXvI z_k>_Jp17G~4ge6NW`L;mpaw>2{{lj=-BT?A7^e@0v4ZY007M=So#M{xHP357hQ8#9 z1GhOLe2M&3z1I78x!`=-k?ZyLy9Kz$%?`b4ngj#%FNqVu_c3G+6#+<xjPE!AioEZ4 z03zki0szJ-!FS1MzbAn!XaZb8TEWNoJRZX86WzsiFLZSuwxsdnxm7F#(S1GQe(Zf8 z?n%z*v3F;*$%dSQwB<D&?&ay%vz^u5Go2TG75!W1z1I8v)W@EmK+A*&e8tRJ7(vn( zI!AN`PNIF02JQG9;S+*n;3w4l4@xBFMw?IS$hq1i#la!yXanwbmUKAPUQJBs)aqM~ z>zC$;ZL4>%kEr*W*udoq1Daja;Lz1w+~oBO?xr+H{2=3F!`AMX;f1x0W6x5Q^q8eP zy9pjePNS?uXROMkr0R)4F^tJ4hH{RN@zupVKHOzf$+-e*E^D>lhQL_`d3@o%zV2g{ z=Vs^8FtgWik+Sc6(v@(=y@?W2XhcvRUglEOB9MKI%C~oAqT9W@zuupUw3fPUtifLA zQjS#{)8)?*=nH@hiqao5NtT#Qf4etyN@=htjs-Fl;0>iW+U`rw=MX?B-1G|WQ;^s( z1<)4!13%Dx?XsqJJhIqcZukDqK1ir2sZhx@G$n>cj-EhG-jY@6Zp_Y7l{GzorI!Yp zRfkVxb;P~hMcl_ZD6#4s2(oe%y45(t;KMSNRA2ZAZgDL&n0KSUwtuUZG*_BM5yw&@ zi}<NF<<n!@kBZ+%>K~UpaRjvL#4M{m&(|8vuyGh@6otse<kN&s`0i$hIFz#w`#29Y zzV0pf%kz9wt0{Njb?e_tUf|mHI%&At^70iRn1JCPONy<rsyuPEC~whtx?7RwZOtH{ zXOf+Cu{DoSGCIR}A&Z=iIW10W@nezvqX&>scPz9#>?Kb!fhpuDhn<70VGSc&JRkv0 zwUIui_z8tf!YyzSk>zGq1MIzRce52PUkvjjQp3+F`;Qu-;Ycnus9qo8q6v}14$yy) z$#dG3Ds|=Dz>uJ4k<>rU)^2w<K(AeTj{InGy_-EJNPXZrM;`6)=q_LuuOJ9f*j}dV z{Aj-6@jy%HHcJIdx|VtZWQEE<TKOI&;ejq#h~3hq9s2;_^H(7-CQj5))_j@CkRy2e zQGj3|+kAZnN_(}&%dS(?Em*C{AYrzKjqmD`$S1qebbNijOMxqWZL4R7SQUjmC#6}? z#<Dn`;n~x0+_+0YqC>Czf%VlPfvW7I`6ePiHev<e-*+S6UBV(##=mw#uy<h~JIBHF zQL0syyNS}ar~`)R*hYI1-D+))tTLLkYZ|GR_BAn=IQEnXhVANuA*)+}&b;LoNJqBP z72r5qEAE+M27cQvI0}Co;`_?fOHC<vJD8sV>S@BC%JPr2pZEI&FU>-yLiwxXPQLm= znZ)T)jPRc3j5pysBAzCll*LwOO3&%`jwDYnbgmhvI=^tsYB3fdoC?%;$a2X0Q3q@V z3oS)pF$vx8rj}&r>m$SwB7KI#=g4Uquj6I6r=vB$S`BhA+0;1E?3!)n2loWKU*Qe) z;Z0Sw)VN(~yML=f?-&Z~x!aL}0k5O8x1%Ou7dN&V<EH@rk@4ph0s@qB0H>QV`ZKn2 zb2*Fmb;3*aVpyvzVr_ro02Ua8(~TGNW7}(+=BGjbel7a0V91(BD~)Kj7*nnIPOT<L zIrcaISP`bHel(}XdtTt%pzhj_QnMe^t;paFRk4gJNT9K0?|j@e673AMu;dd4TLgQY z)A`0~ol@|(T!RichN-Vp)+NTiVE!BX?pBCgYN1Sg)tu5^nr8}E*zr+(xJ+m*#g|<? z@zml?Gs{pKlXM@tG6z{p^!fC(!{d<|60lK@z+lrT%GbUns$k?_0z8T^X#ZFBFsE*& zdZ=k>61reW@Y9N6m*e?@>32%+E+Fea2VnFIenkF$6}Csnqbm7Ck#aZAXjA4fNk>2V z^8@dHm}TJ-<}>XUNy}df%drdY)~QxyGWN0O-gn*iXG>uFh;a9VK<nktq+bBYW%`G% zX|Jn%?*`0kFTs8~<jD6|{@oCS#)x3J8w8}#{8lc3_*L+z{@s5q2Y{2fg>>}egOu*y zmP<1j?bYm(Eu~xYg<knvVeoN*tUKmIw;J2ceC*QSjUM8N#?m+)|8#vIATRv)^5Art z=2KwqQ0NYj{72SzM99Pk;GMl9LHbhE`ENzRexI^OrG<CeZLZ(zXdCy>qmlkVNA+0R zmC>uJI^%D+U<4jTguipsfN#9n^9umZZuxI^qq{4g*ESY*Rt~&P^0)1jVye)GN7SZn z!o@T%CiKZD6D~9g)6P5R&hvwm%1%wF#|tKOhmXt-oTNg_X6`YR(4@?FC<j!x)Dde7 zNx%saF$;+Vn_MguZrI+0kGa3*bJY+`UvcviqM+}>sx3?0UM+i5b;L2EIa=&`biOVA z)9(J&QIN?@n(v&F+3Rr16D03M5|cZBl0efa&slC-BL6i}7s4@ni0aA&KEa%z&*XxQ z0!qK~x`D1#8NZTeIFmEW#{RmwZgSU=2VRo><t~3n!gl5ycbZS`2AO|ilGQsk)3VYF zvfP7azNytq+LWfJZP$-KU4MwDnh`4xmnmOb$#<Gps1t8-8NYf=R=(u>t7m^ge=eoi z(-NHUz$HTfh%)AW!BNak^U)W8FiLU95_<+fYUJAy+N5wFcio5E@Zr0blc@W`a;?zW zs@39+FTiZEY2(^DNIlW{t+lUWCgsn{e*vHlP1B#19bD5O`BO4GSZ8@-?t4^cvOB&V z>*6o1hCFr5&TYdGvmB;2v!x%d+2<_8rom0t20*x6FF#Ftd1|N0XLFxtAKX(Ocr%$R z)d-+yo_jM5J9#dQUv-tAJDcc!{MG0$$ae+Xm}`w`xs-wJaOjs7mt3316>i^{@JYv2 zc>%tn#^@@bUZ*+#xw6A}Ge34`Vam>atmYyf(X)n&r+DexI}Wx1k9a1gi6Q%#H4XR8 zMn3`3O`|lyY0Z+yCd2My-CL%5*SPBf`)lbNe8cpdUp<T#k6Pz_N@owi*OQLC%a<+$ zTEB1ke)a4-1llapfmyEcVv2V{EeaHBN<4K>9)`v5k=Q45l%rqTr{_PxDz|VfQQ9Mr zJq}xh$*&JHcK08JUvm%GI8Rt*7iD7=6=QRbIZZ=7QBOY;O7&6M_-fF93&d!`)+Jt! zhr?~AsZU+u3+1o)esA*c7h!vpNP1~)G~YjzT4Y~VGQ9BuIVes?CD=$%GJD_bY)Z(y z5U_wLHI98b(mOCJrJ|OW#gj;!d9{DS;dSGHKYk@n=$Yvey<5v)K3%-fb8xeMl;8dD zngcbpTet#8P1wk0`isB|l0TH41n1yqSYq+Urv}BLv^wBk(#E8#TgmAHsjoD#=30W1 zqnugOqEt&gb7f%3v(<RU^TN)kNNvo5(_z`;lFRKdiY~HtXg;lOAXm-;v{M`{u=3}> zdPj35UT$KYU2M|KQF`aN+q$Kje5Jqk{CD;%$O!F(I7(NQSdw3ys7ZoVn|{_`^-(`r zad?78Cb8o{wwbdqXLB{xLQ9$cYu(IBjom=K!G7*%rH=+X&|@L;q1H;Nk6(`uJM(Ow zT8LkYnE8#Am>zi<$HQ&fukK!%sOPUZ2%z?Cnyruhoe@7`e=f=&Q=x|MZ%++iEB=E4 z1$~5{8?sNhz1sGNB9>g6V0&H3F+OKT@hnTT;%xY%MT4KlrB1)yL(<Bca^#5e+_cBl zsx_AqPO8H;Mrazbwee;$Dgk-MCC(+WDRZUPvFldG6oO<+-j5T1t5KTGH^(i92X$JU zseaiS1T&ARA9&$ynxqW~+D&m#bvy5uhbgIIjTnDpDNa+dD)Wx>JK{83Y6(tH?>TXD zF7s1aI`Bvva|)3=ZI(T?9pKXHks2F7Wg8oFPMpj!Jav@S=8<R*sAl_bOeYD>Qj2S{ zL;zq=su~A&3CNwpFlI#$u&ka7W*4N9Qw4RVQHm9fmzF@koBvOi!Wz3CgB46R`S(r5 zI}@GJwGo}OxRb#d0(qSbI0?#?164B}_FcS*)$V-N!p}Jtr<zF2+11}!`F#WWJM#>u z^x1iGgN_%?#g*1d+aLBmPt#?&^2>c4B9Gqv535@*>ESj`%YA#~uCL0UA68gRaNfhS zI6cTtd*Cots$)6h=!WN>@x86TY`VY4e_cT73r7C1012j3j{)5g0T^4hyKU{y@N>iY zNAxdu2#7<51C3IQaYL$vPk&pj`Cg!v#aaQgEtqiP|7@2bI8BovE`Kl#d~yzR&5@ZV z4B;bZY7&>2@SjXEcip6GrB>b8(A^uKja@BQtH@mD??%zxK1<$4@P;#9_Q=AANz1}4 zt;J=SnE{8AS%8TRvHyg#yd`COsbcx$22OiHq^l~I#dczF_+on1d<dCA+F+F_d}{0x zPAGkKyUsyt1lMhWuBsR#IecMLD^Y7T`-5mN0Q|<jM6F&}8MZLuR}j+>{?in9FdMTn zA4+9Wf=?d7+BVwmRp>h?#;TJ4TvKXVwx3uQpPi;!9F09EF(Zm5Byw2QB_X!sW|uX? zmFMU3foEf$-fbx^Ml5Fy0|0)zzW|3F+`3YD6~inqxq?&oSNLv{BEbJj_ysAGK_3x? z>CbD*xt|MvH;dgdOay!JzWV;cxw9w1Ckg=relg>cHKR)MMhqL(xzk#VLzdrIR<`*i z|B4F2!uE*crPI^yz2oHx!JY|sN}KmsX?ZG`K=`ki-x+K0NS}Ac+#-{ukPXYE*T_e? zl!Zw_J*>XAtTg-3efs;Os=pNavB6<n2?^TR`AhQuWU#Ms1Qwbx=(1rP3cD}B6?c2g zX8f)6e-w)_+v?_&^Db-02M0FMfQL}(_Cf38p2O$=eGMQcY#nTaz{TH+{CL9jy9G{2 zR-YcV@%ry20C4jLC3e4KG~zdt4@G2{o+@jlQ_Sig{kt0>1ABc}FL_US?T^2+%~ATp z`v1l925sv~ZBaXpUbEjy@PGF5?zxD7K(PehOpRH`^5@?@u=v+vU|Yi+0a*^@|7n*0 zqnO42uqgh&qC?uV`Tnmc=L)8Hh1C1MqJZdAKXiWL|E@@Njt1=mir=yFA5?=;WPN=D z(J#G%|4IJ|`2M{dlG1<BZXhb^^S|RmflfFU@cU6nNC*gc@Ctr73OX&Jpuul`VKC5P z@1tRou&^p(v5_*936ry9KYR|y!3lci;6c9~1Po;Qb^a|-!9maF)e<gl^(|Sxr>0n0 zV=8XWF{!pdZ)=v5uGDI)C>T|ncYKn=iE)-;lLU{lrjK;C(%&(8zJEb!t+i^mwN|FG z5sr|t;^WqbJf*3Mog?05wkerh?9pcFIarCu=Cdl#@<t{e*W3c_(|Ik|$<FUw#~Lg) zswL*$-2x_CS(X;litbkUS|dB(_^s?h!0*ud`yx>WD$317z!$`Ph!pB}Fd%d-Eoi3p zdU4$OZh;FpsTT2fE&cl<ytI3~9&A$uM5%484IJ0;R)nS`m+S1Q6>j>@wy4|w#XGOE z^XeO8Hm6DVMkUM&3=Zb9cKZ1HN2-%GEx(D?Il(bZg|^gBd&v*ykM7l)_u5DXobcrj z5}PzS+wwJx&l#8-1-Mjbc11Ee+Zf_+o7D+RIlnS~Fy<`v(L^^xL#J<tu1N|xcm~KV z+l~8TG6ufXA~TtL3oH)Lx0WevnQ7G8$^YMeFkOb{iE+HhgGCj-Q0Zf=On%&7VpV0` zr^0Q8yq({tlNDAhCpTx#URhf|4L6}EkZdh2KQN^xHg)|XM!BjHE<WLFs(H2B341)- z#}Q0_gGYxoS9B>2MdP~WJ%PE>jhP<W1Y_ne5Br^6U*$)#t6|U&L{NGQonLvo-7|?G za)Vg^eu>5*$izLrYH9uOt{Q5+Ah4X3Z(Qh{qE&vN+9Z~)PI{Hf6x?=I4utFMIzM_@ zT=iJT0awD2Cz~n0$;PQEZ#Lk|tn+Kx_Wq1#1BoIMIMdr#8_vaQ#1yi}3a@w1f~rc? zy%Q4iHl9>WI!CJ2Tx3kbkWs8~02Kh5DrqO;75G()^jNTA5lu3wcBN=YQlIyQ=J~5^ zUbgQ))`iP;9jAZyQ|^dj=eK{6agA;_!SEK#-dVMKN~=?seC3@~IGbnm^w31A8~B6X zOlR}-E5}$5Opk04A2`2?I4t#>()##q?ctzkp(pDE%3o`jI6A(nNcp!%;4Lt5g8!`z zk!T6|vG&2&ZUF;E{TW8OX#O%c?ZbvuhtKP=19WNXzlrv^8j)9jX5mp%o7>G@CVKbH zC!c6xQ=#<)lq9<K5tTInmMt92I3s?uO3)sLW?K&4IPRyXQ5?~1iK@s(V#S8FMr>4M zBehT9p1%LUz$cMIsS|lGGq)78gr}P~7kZO$EK+(&=Aw&fY7nzc%&(|6Y0vDc!d_U? z&uN!R)$vOVb)d#`_b%l7Z>YpSBjw|rs2FfcE@&Qaj4Qnq@gp_FbwMbz6uGjnZ>iIU zLxd;v!x4+y2gv8iI&Ea`t>`Zn?T%h|h{9@(=~|BFP%b}>NJaH}Wsag&gDTW<hLRF@ z(pAeCP+EX4!kCN)7c1o6b_Cr`?0fC7AH=X0G)$_EOBgvl=?s3EsP&rYO?HmPgevy5 zRzcSDjK18wj&_%=$p_eEq~<-CW)Wd;N(F0bY6|BvEdUt?`#N?lb<$VE>xf&qdZ9XR zQ{1W!zN)iBR;*YeKH?v~1-|*350vZ@)!vw>O4n76;lH0y!`z;nD%xsJ91J#dg3p;E zge}O7qEknorJ~v36D;eBul7`(w?09(A=XAEWC&Ibb+C+S%wW6)5}sz2<Tc$0)G@01 z*~5=i0EZ@>8t2qDjHBN|8%Zs3$wkW+gPPTYRXmD!lV~d9c8))hVZ9vD(Q;$f$?b^@ z;0}DA$a^1`U|tw_x717?m%w7$&g#^Rwi|rHGL=(G=j=gG=e9gj8aduZjew+xzN$?{ zw&`cdd@QGxuS**0{Nz}n#aw9DDs-vVx|$Cs-NtTF)fo%^eg;P}%Uh+>NROQbha-I1 zT;t}uPsH^eH4q0{aQeKrU6|!Nm=!B5H2=7baL{LEr%-Be;m};$n0Zr2Og6Oj@Qg!U zDPwPv1!KFs?zpF_>$SNgv9^cLld0&52|;jLYd-awRkhOXTt3nau3wmkn#4gXGG8sk zd1>Kq+0s<g6SRB_s4q}w+PoV7GIsyljLQcBr)pOx@&D!!%Wf}X`yUThFHiyK5<h7j z%-!L^{%io-*0T|TGG*mj8aFNxvTd_$h>Ss#RM93IsZ+5LkgNc~ip`MUjZdbn3qP*# z+CpMc6-vAGVd{}-3D&^~(jxLT=h=y(3neBFs@EI$ks&*6yIABs{;w$sU-y<;iDX?} zVsKC$gHH00xR_l0onY);f}eI5=}98avdq?=1TSxK(!Z?*EQMvC#Zt&>lIpUb^RErK zOVSFe=T{f!t9qyi9qlwy7mn@Xtn^%@jhDHzY-LjrsT*0AwW)o63u@YYi;t|@$i_3Y ztLY4t<H-XjS_>TJs_SD#<%EuL9t<m)WaLH42(Yz>26iv<UNODZ#7r7MSLFA+1;QXs zA+kDg%azbj59!J^3EXQToK~b{Sf|W-&0p;HY!4}#uQctnZ8>*P)keXjsRYs(%cz!g zcAz)%w&H*3g5h_woxZO;z+vvqW}!O9Izc^9ow3nLqm%nAEUsGgtrcubmvUPTSFpu| zfM^f|MCZHdKK<>tHLszcC_lw7e|dfxx*#*@a#SMsdhxxaQ^3on_gezNB0ZK`73;Rw z<yMUo4O4XLHwB3$V^QOJ%c3`uiTFaxhi>?!=iZWT7o_Ve{^?OfAZV51dZWNl*&4DV z!@`)PFXJI`HnRXLbMI`1!+ycEuWwC?6n5toa;@xa%@mtdYBsuO70z2TH^O!6(K!>O zL?jDlCFVy#wMpHleXI|ylBrGfKgN~y^bwxXe{<45fz>kZ>*()`r<SWSLgutodSDnD z^|a{~Q@!QO&??1yJE*F1m3k2`f=jLU`8$+MI#p~7pQXM+kyt@p+gS8_>m1@MXxYp@ z%gzU9{CPQV@f{+}!QL~Osx(pc4?%4$_<IN#oSP||DG#i*b~rw2A)&w&q*J_e$h$ji zeZNwnNcwbrj6n^puL_1Kt16%<s!ohyq^l?{8nbzZ*d@Ex4BMk+K`nE`oBhTQ3ZdDN zL8<%}fFZx?FR$8q>|veQx0g~pIjx^Ahi8Y!;XZ5$Jzwl^^L7H~>DIwh1B<D3T65D} ze-w&1C3e<9E_iPN??JPm%)UID<Dq=C4BpnB?V5Kza2~gSzcsTi(RzN!gN`GMw+nVQ zK3iP7-Phbq=}y~%0&Ho-!`Rk%4-cGrqpn^b7xl&PggPT`JUgT>FVQ91W?DnPda_Kw zL0NB8U)So=f~#NdU@@s}Fj}dd@HOqodp3RK<;9uq;_K7b2)sKoqNi<KIbqj(q=tTS z0)-{uQ^1DyHl1S*Im^|Wdx76p5ycw>1k#jS4?4<P8&p@b?Y^{d7nqZ#j6Y9Z`xfkR zhE$8Zz#f|Pi5|vhnRMfiZr<Qdoj|YknuPWToj{d3M|TBa6BUaYp^sxZjk*}vE9>Ph z$jOz1-wUmB1T&U}1}G(4_W+hQrp$XMjilQj<98+r9qh~(9_Kx1FM-^S$34`7p2;AX z#EiA5Y)(1dS@NxPf^F`b?=fOnH_Ok>WaOFN{se!IMbDbs0OnwTSgK`d{<^&>XvY#| zlzB5LkYh#g)t`jN@?euSPB@dARO7>rD|j9P%I=3sa?zA|(Js8}x^p~L8Fh>>n4EnU zEOIjipf*|;-^n@VHZSn{wo@)QlSPYfe3JNVd(<{LU;0Bh+S9qy)Y8PknYxlUoJbG* zxU55a_Ou$S1e7{EtSz8w%<Nu0cPgYu@47mgWC}0%8!x+Uh#I=92fi(Vi}MWoY!7o7 z{%bqK+uU;DVh!Sqg*vL^FD+glCWgP<d&&1^NGFUnqTrF)=F|6-l#cQi;^N!6E0*ux zeUiz~HNYGXj0jg^O`UV#UGm9c3PV!o=&w*qJM#M2{LO!4{9;_6aZ<FIlkR=~#WDWr z%1sK+K)p4S6Q+|9{76wU-b~n|y{(dPn##pzsUP~78R{XYXC7$a)TtUi&HGaL+QZzT zxyr!E=J?G)pV#vHg2QfAw2!iM!1oDu^0U5oi~aO9yav~cp7yO&Q9N@LrpyGx@9!qB z_o5QKcx1*jtxTUq8649egiV|qJ$9Ddi)^-?8nncG<^}t{rbZx*a)|sma>6OrsdT|a zrpWrzuTxe+asKnG5pH#c9OrU@e1~Uhj`%P*T2=e(E%{X))06^iZ!9n4CamV@+!w+3 z##^`}%uHPmmyQGlzRypTl=!KUc9fMjssxqUe-IDuvyg_PGH1t<pqxA)D9xU8&o@NW zdwGeH)P^qyPIJ)C_ZS`ym`{j`Pe8Ya^`6@0E(*A<U1w^)7~I}}PToJ+PFXIZH_L0m zn2<Y}w>cHebFF{Av@@smc6BoBZq#pqf`vK;)1|EttR;pq+%a4a2?-TFs`Hx~0$L=H zL*HkD_ZPn%wAUeJ_&Oh!%bJ6s25n|u>EN=wHwrzzlh=1s0)9_l1eVNoq^QX!w$5MO zt<_rhbU!Py@>0apW2?ai2kYbP-72?z@Gh4vS3hr(xox{bKLaH5OFhXx+d2V==kN*1 z)`^xy(B5yhj<X6Gto0^)+U;FFzo&PCF2NKKFCeVYDdk>Zy#0LfZrQx&@O|u>27XPh z&#wDqLul{P&eK7^Tim_crgJ-qg|M#Yu8KXW0M%%Ax~DU=^S+Ld>VrOW$4locP3Y_C zIxrIP$oUt06qgQh|0fUI=w+KN=Ir<&)|1WjT%4|l{3bycUDiiNQOznb`(hlL?{_e6 zfe!P+_fzlVrJgy*Iqq!LBxOQXoSJjejY-_R11YbeeMCzMZTQMAUo7c38T_M%Mi(31 z<;NB~c$}m;d1O;nO@-{IP#q&0;*G*Jg^ey%RI+-xSmRl5p1n8KAY1TnAhZz|Q}vLt z^1>OzN_95J#zz(?{W@LiA5+Yms8qDIvr57D!6Ki=5-pb#pW%&}l4Xs^Q<c$ak#gNa z@|siU+L1JT3k{?A=8GEhLF?S&F&s<lwUdYH!W66z=@#r%5{y<{E#-Q0#FNPUhIZGb zuN#&0Ey!wnk$ZM6c$1x97{3Qi6b#;h6o>87{n;2;4Z{PZ*taOrbQeq_t=5co!rN~l zU%M5=E(jpwUIb{VA%C{*GCgH?@@l8y9pWtNpUCguJmDjSQ|Vt++V$WcQ=Q_Eh}h{V zr+((XBt5+&(w6tyGL8(k`sqv@?D$8*w=h;n<L8+>^KE3gA<GX#4O}!n5<NFoR<eVB zMUDMLy`A-PR9Os-C4YRP2TF}R$a<Scf2(q(lvO*V*fAyWV8GMKTL_%Jpa@xnGwToR z&gnW<Iwd%RpU@7ecVW0Ddfr6F(5{cZR+nQ`Z*6?9FJLHCqdBj|PmXNBGu1o#YoiyU zrdcLEPwu;IcM%$Q$=%a&aLMF!@Z!KIl#sv*I0XrTbSrH3TnX1vD{J+oV<~BNs#MOM zDtgPbU?0c~Qs<U!%|A&yd2cL3w06Iv-F(R1T^13NFXE|H@@E&FIhV7(?T3Q-3e&JP zPo|&U>&{4RO_@}GA6{G6YTq-JeWXaQ*`!gBb8?CN&E7{|cgg1b@?-1!vOW`07-#eL z*OnpGo96s5<Vg{eJ=-M@@T)M{N)lh0+p*qnL#4eOZLpN<_;_TF|Ln-Ss6^&fR>#O_ z9kFS^j1%KlUA$Iq*&8*Aw&nn2{W`Auo<`9`JKLNL98RC7VkEhkLBD-?HIeLv>p`A{ zUtDt4w->p!I~!co8}UZjyiNukQ<c}ZfE6fuqZTW)c(xrPV&X!{en`L8kDZ=FAp<0= zbv636Ntz~|M%j`b_K@Q5#n?Hz><QjfXs~3HR*mYjKnNPXeU#vrOi)Wu>w$t`nh_>! z7<Jkp|F|zq3niZc4!T-VoP??uCq5-5)p^4Y@k!sVDcUEbgLGoS0XzRrg>G|BUZou; zgpI}+;@1Wf+XlO(`*WIoE14veUr07ZCexztRC4@z2p2sx*Yor-j)dbr<EmNqAjLB< z>3KY9v1VWXL*AUMw+N9M=_0RSf`i)k(Q9i(T}666F!|JhV$V`KY97r)HyJ~v2gTrn zN8fiYfSVd!75{Vfj+o--M0u&!^wjG7?_vr@9@sdFA#>vac31MfOG{rNyOG^1<37B? z@U2#C6!hb?hY9r@*ViMCuXN(*4M4(^q?vt<lrc14<GGSaE>!awq7F8}=-Q4(4AFf4 zLVPraF9#~6U|W8B9!{-?qHbnpp+Vd-v3G%<*!Xb>a-@g*k14VImIMAVUYZ1s^;XAD z_-MPL>jw^f{6m)%C`I)oeN6+3ZyNS2`f%EPXx-_!ot)Svh}EPtK~+Ww5<9H&pPE)D zHJ4gO<MU|yVkorUPCvgo(%6i)k~Bq`eDNl^vX+KN>g9Q0Fe+^yLrQhOrqN7^Q8#(? zANq&tc=bj|{106-9ZQOZ0m&*-f7LAN|6K{M-p~zaKi1?uT>3m!>_+!=?a^{3$7@1c zy2xP46xV0CXtk1|#)K0gP<aLM1y3sA#Qq=h-YTlDW{DrfCAiDMAy|Om2Mg{&g9H!m z?(Xg$;NZ@|-Q7L7ySqaOk~!b~?p^bLnR%R-dFj==t8MMwU0v0`s@jDWY2UDGWdoqU z6)Yis6Wu-0*dyj<5F-A;re<RgP!%5DJA{v7Fm+t*>y--`6g?f`gVZ|gGThPB=E#Yw zLfK0u9Ze>UGB2vMQn%pw=iqWwA~H!DU{~+qqjZ_={_m{#F|I@X_D*YI90;aa5M|F1 zh&+=ByN1M}Nni^Qi&9pk(N&gFE8XGQT=T6JndF0EP!C6H%(x*U?J2izkjl+yny+3Q zywjxrN1Ya22bIt~b^p#^jkc{LoHD2(6r+o1bEPY8dIr&DHF))D8lPiXR`3Q_+6n;# zSYz5GY5z>?U!kUZ=&6?3YV|MFFKShX!?0{~kHfH3*XC(XfjhA=e&w}E43-NSyD{y! zNeqEscmE`NOb2#$|B!pF-Dxl9Q}4tem0ycmUjHRuLp0(49I-{xVw9L1R#vj2YPnw! z-dcr9m^B-OWq{z&mLwh2>f@8_3)iYOEIdIj*|MLBg?;z0j(r+3>CsDPXtl->nKV>| z>MtLKvHWuX`*HVEergI)RS>hZ{DnH-^!c~PFRUBKTn_=eO?91SthTNEi|aj0hOg09 zDEd~1+hu&{bqLHOd$t=kzLkEzv879_QkL-BzZA*nQp+Y(O8tTPR|0u2_;-{3!O^!$ zhzT6Rc**~l5PoxsWZO$9J+{+$&cb%8$s*^j2oX>IVYWWLqFb@pgI_*rc1CyjUsN*G z61RJJOJJXCesmvwBU898DN4R<WFNt9yWH{ik%VXwr}-V)8r4ctPS{9nfT1kezfePB z5NRmskK-m8fQ4>$DYt8=Ep@iVRW{R0aLTH5@yt~GqH2u>zEJ?85o~07_AJm2)LqL{ zu-rD{Puo8fc`y0JiR2xlcaO2`g;{d*f0{>ctl_ygTC8eYm1fEF8RyCeWo@6U0sZ=k zjZ;Y*@5CECUuIA0#7n2{-P*<>v6PDZvHR4X#p(tYk-sb*Jp5O9_uQOMZ&(!`Twuuh zgvZ?*ib&fL_U}aJ=1?C)9{Y83vFD50?DRg5)PMe=Ke=J$dDi-D`W(N;RWZmNoj-9N z=cZXxVPvhLkDwnGJ%4ThbNZw<57!=sdU0ilmHo>apsDvuFyrJhQxv|<9u>#=M90l> zvq#b~y0F=ToACn)=coMTIUSp33#7R#Tfp*6=m{f+@kqi?6h;-#2f$yb(I374zSF-@ z%H6h@snKVdpouq%F2Q^WGd`&->Zyby>AOOYS%DKW=eYkb3UK<%TWA6>^U67S7?t6* zM&1zKT4=}8pY-F;ed8e;qOPy=6HG^(cDdmElx0QPCIl{di*ccCTHZ;S(woL}L0Pei zkmO|kR1R4bacUAPq2t<8Azk3jw^1EYlTZn|Pve6YwR&hm(-7_fQ>Ja?sGwUiivqdo zp}k<F(>;no=yfTpeAO$k;NS4dZEXy^Ksc6hTr!T^0q=(X%4yIVwy77a_ekg#{!^#^ z$qx+K{JOF2P9_%%LbCs3oj12wl(>?@q+Cm|KYx{`Iw?bh-GAkCX-<PwWCM1ip3s6+ zRo~d@M0G8{^gjmw`vR&LM9J@&|K0Tq6`QvF7_>=vI~_}Bkb4QT&cNPe_P76NDeAPd zGLiGCAlTn`I1hopw+&0H9R_A?To8^K^!EPI;>tXVD!%H`JT-b$<NfLNb~1a>(Yq3n zV6ZxSJ+=QwtE?j!#v|o+wzwU|=Gq#zQ;z#bOn;&Dc4X$t8N=2GVQ*#)L3Y|(e3xJW zq{H`-e`oa<%J_4feUF$)IcKv2gg5>397};^j}>2$5S=n!s|Dr={kIvfM^zOV$w>M} z*LAS>*O<ZoDqG3gG3awuAkA4g*&Hrd{dZV<$rh&i1ww^qq^0iv_4}{-TL(et6tSS7 zApvj^k>Ma=YLOrq9mJ^)5@Hl$(F+HUNhP9efPmuwiSJt5J43-PdW}!bs`O1CmqR#z zb_b7B)iJT|hK5Vb(AYk3_oIqYZr^|KJBZhv5cFTDMiqD4d$>T!0r^>+!9+Lx{1<-p zWyw8wKr~*{)co4=5osuY>gdd;cYxkS+0cY6)p$R!RGUsBZ_=q9)1racO%_yXtz2u! z4EJS--#vM{B3y1MZ8_uyppr#Mwd}R_Td6}DGQ_+sek4#&g)1m_|1-7_U65%d(3T-^ z)N5)6d8@1t5&1$KQQeF5a<y^KErWRR!cZ>%xJ>gEF?PUM@YfLDBqVf}Uw#lxj;EU3 zCr%sZ2YnFC=2?e|E$zZdTcZuXBXM9%`yTGL1U>Lf@tX(99iunLdKQyA^)A-QGB})M zjT`Ct?7OIuaR$qi4B~=TqejP$$<}c=Z4jt$UzfH>^1>XpkWq=XZ&dzGUJwS4C>{Y2 zSp>5t`F^Y_v;%wHl8jK0-egv$w&-HMil}>1Nbobxl?q2bvguKr9{RlWtmipd1oxqO zF}oV{C+Q(wojZXPkR;vN?{@Hb+O|CWK2@)QNS?-;?qLSdojV3q+Rxk|#B?P_z+m?H zc?x_{aVaSgPCTP7BJ72(T==pB)P~b7)x)wDoEm=#v~BD~nZa^UbP2HFtyNWdjyZJ^ z**aCivESQ>BwjSKCFTx|mTiHN5tjc0_fvC6kPHk$GhCd-mJ45_RGvs5Yp-YuY8!Cx zD;d=}eL`r<%BG2<lKn%FDFonGye@VmJt)W=gG8os^&SrVgYg$i<)!<D*6|Z18vZFy zcD2}USI8lRk-X2memd5(d$qeD@B4o#VQi*iAn=iQM8py_>h(eV3sv^E^_HS1VPdeQ zrdH^Xa0<Q^;#Gm3tUDX*IS1W9tL|^Q6t79f86ft6TM@n|HEmcbm~V=ZCor6{N&<f; zkGHn2SamIdi@?O_)0#6k4Z{<-sF)XXn{4t}<eP}ET@fw#S$FGSIBhgA<)1_@QpnNA zY23yLVuq;OSQImo_h7O1Gi}uH_`E;B%xUzy<Y=myocrF&Tz)7+_n<UPxBqE`@7eq) zEP96MQgy4Gy28A*=Wr<>3g8EX>D%3%&0Mw!c#n<Nli81_Jt-GTQ;4s#?YSA|jjV%< zjMO`Ye~I+n`RTV88NbF)Hgs!#J`s#BHMQPIk^+h}+b69WzYlBE<|T($^;{+}R@2t2 zeJ3DhRoIoXXRV7BpAlL(!<wb*6IfIp6*!XGF!vLA2+<1B$y)rx*>HpPtRAYU&FIG^ zQZyVm;z6LcEyP@A=HKzSvs))H8E*`nDWvnIYuH&hSDSk73jg@9=7#kp4g6X?nH*m8 z^$+5WXyv%4$d-z5!oYCCjT*02>Q6FTknkSeggfJU#Z)7yMK#(s)LkO@Hi~c2ChYqc zCH@|GKiMOU3&<M4dQfwGt){n$T+rDWNIIV@{iA?UtRFM}=R1#|x!><Na7ngP3>{)K zy_+Uo%X(L`ncw@>hF!iHQ+*UMv6v#Epg8>3)CV!&Hh;Q+IO^T>ah>o6r{r}E<vX$u zVf6KSO4dy^h|#fkjs?lT#w5TP=p?8o<&vpNYj_zXJezfw()+yf&q52?Gb_iUQ##q> z_13ME4U>D*ZeiqOn&n*Irxu>U-=QNmUY{@+K2c1za@&+l?q9?lS)2$7aGDUQp(Zqy zcW^p<`g9O0A$guvoOe$8^u$z<@;ugjx|0RtZPvq7z%o|XeTIk9rg)y43X&f*e$AWm z0JdvnXW0Q>@MXr$f{1ikn*NY@iH<yrfa=!L)zOc1U*nYdJVZuAJG+ZaAA1QKY>xN( zZO3n3?hP0nq*g$C;(zG7@M*^gMzkAH?)TF<>N@gT`5kD`BQ(*)#DGdff(jJq?{slf zA38lXnd#Ikj?FdaQXarbiWCcWyQ@9|p7`HWzJsri+U8>K7*fP8*YbwOWt7ot9JH-3 zL~plUr83q~jH~E>&^fZAGB>&A-6)LQX@A5)3KzYxGWdZP-$F0?ijyfOvx_H8eEX}0 zwP`3bOwi=HBi6F8*`dRarBpK~S(Do(QcAt}O6(xc`1ruoyy)v&SA3M-lfrvvr<C_w z5PV6m9DWw!%8HP6FL#Ndd81WWV*^IRsH5MkrA8wP!-%<3zTRq697a-J@h><Vafv~c zffplWu?=Fxwl4`+59Bm+_=<`a@>n>(!xBwbHVy@F3F!{cUcIq8S}%4EGlXmWI=3uP z0`|x(nZMP}MkHPqN=%V>2kwvlg*wz6QoQ7sVt!uZ6oP+i7Jra)Ij-6sW*gLSaYF?7 zU(9@8XRJB0)D3<vA#>cqc@NL2DC5~UVrYvkvAa%K3nZ>I@WsD6Zsm5FmdfamF=gC7 zLTmP8Tg{^3bGTBI6KwF_&7f!ldITFR(T&0^vUwuRX?I~Ef?R|m6>q;2rwFxe0p>7H z(Qo#Zetv^agUpD%9KJF9)j;SWh0ZSU_tmRl_*Uf56O%Kms?#cid>Izu)W~kS<w$en z0q_M}{VsG!jMPA>P~*DKk}Wv-c~SCOO=uCF7!YaN*S)je#YX5!`zqk;jfsQRD3^HI z7?4!MM4aVPs=*Ub<K_I$4fX@Hm=mlVi{U4=6vsJ}o*88A7#`l|+Op@v25dIVI<I_@ zewiZYdGRR!Gc>_naiZnu*snwe`=*#0P@Tk<E5B)i#r3%()a^9Hy0PQ&C~1A=QX)Sq z-kv3C1uciHv9{862?L8#ZOID6<52~{O$H{JpFGD1(Fmbm5M+}1X~u|>f%x(2Vn3Cp zI1!YS(h=JO_U;0!MN`#e=B>E3)SdT3EXC(XxIn*M<9?8(Xw#L6EPkqiaH~gz2cXm{ z3dn42#EI-jCemS9zZ)p*?ldL+nLo+26zl@FyC-vh9E$yJ=BXw;c`w)d)6?_vr2i4x zHNfrM9qBF2fEX&^1>bV2@lM{?HD!Aj5?bWT@R;ZbN2+{g*<Ct+iTf&_)HE8A<X169 zn~ZaG67h=agcUriTQ_2}2Dh!vx>#v5MxpYsd%~MI?7HYM#!;aP73LH2I)5GOX1t_Z zFWv*e3v50Yh&!$(9hIKkfs5_>mP(j`COO@mtArPW%%<JD7?|@mDEY$3Ph#>i(ZPOY zW;k~8=gzZasIvA)KYo$H5(p=@Q1<6wF0l%4c{JFr6S#{vSyBSixgyr=K{)XwQCAJ+ zJ-`q8OA8osBBV&ypzvYb$X1R-N^Gg<1PmyqU90iprG}B&7D(?=w_!w9jtZQ~FKYE% zQpE8vR?|6E;;*^DE+DpGf4^6^e}`D~U*|}Crx-it{`XuYo8+?tZ;u(uEED|SbVUv` z;wn^Ih07W#k5(T7NTWBQjxE(G$s>XWp43=u?|=_KsTfn=T<kHRzuXGo@Zu#PM7fYC zD%}b)hS53cDcEp_(?w_RITj=-jfP~PqLIK^lxw9bthr<o^Q_lhemCajS`k_#>s>qk zFr||>UZ31JRX5o`?H7iz?EV%;-mrIW|9E104z58rVqt6~P%5=($9f@Tb4r#J5}HKR z@Y1pGZ^Vxu2k3cq&!{aHx|5x#`HU5Wl3C_9D#7|gJ?X@@7Vb4{%^__m=Jl#|wY)!p zUC~Zdm=M=Sofhp!LNd6bU1Q7AG=-QQQ{TJd-6S^4=?;8t%Kwa-N#Cc42^^jm!YZ`e zZR$S~3e_%-nH%>lxP`{j;^}=m1S>Fe6~^>rUsIZpH02AG&(IYP2R}njg4U_#w(Y5a zGsZ^GR<X)O2Zvp=3x$Ilgc4GfKK>cvE8Bgp>K#EOD@`{=dwTuexn1?C+FT<?SA;Q- zg@sKl;zu`y(3hFjOno{ZP5X6>aAkBW^eq|1H$~+eh9?2psOsnEPJLs;SRg|r(=i#t zYEi%a^}lt*Htc>xNa))ta*I$({0x}e1_dFn9TpF=yXSnwx23QAxmQ4qU+1c`=lYwB z(xh+d+YM&OC8;kw=cW{#AjYeTORmG^a4#&?5}tE*jyPMV<Xk8F6EJSouxTpV8Fcev z=|V2kdq08Iz{q>WtK?F=<ffUuN2zk4?qU>_^=%0TF&?qghjWTNAS>*560iOBj2&Il z+wra7r<36~;FaI$e-3Ny;%(2kwCf-89Ddt=`tKj_=Ya2sj~KiE&js44_d#970n`zY z^S&$7Z_fAW9o)?9Sa(%c_={)s{#wn$AQQ|zZrvPCRv5eg{_V&zhMB9~{|ZJ;r~6aY z8XmZ{-+|_RK)gb^LliXLoabij&b*GROE&ZgkkGL@6Ecn$NZi64AD&=>^9c<=DNEc! zzfyn(bB?*tixS@=x>snjBCTIcCXAH0N2hQ}Caq(FQlm@}(xkp3x<|cw@&d7_6N@B7 z8YCl|`4-BEOWQOjP54YZw^VokD5mX9bgx)~$`URSXu~Nzqt{3a`s|Y!s&p9X@<|7E zI`JrT&)Tb~2VQBx02Seu^fiU?u*}M4tL<6!lzjGw{5p~<$XviC?%@ZHr&MgHm5RlV zr)f=09jM|LcfLzB-6^uTsP_tMm0wG>6XYmpo3ZcVZ-X&-GBbCJgj((dYUalDa%f1d z$S;}$R3q%q6&3>B-OH)n9}(O0TCko;R{^n!cHacYDiPG2^c*a$qDV;ARbonTF0gp= zP4CX5vaHIR&(}hu;e6ie)cMdh=Nf>dpPw3lxLgr{23aapa(%runYOupvCT!!)@69f z5`ms;DxZihT&bGR*~o1}f^IJ`=}ezjiVL2bRv9^8w&E4)sY?cOZ3I14d`>nl+Ql3o z=0#p&5+#kGu|{LHnEpYD$o%a7lSs2u(9#-1zSu^~uyYxU9S>U_hE91FGa+KYf+O+b zO8*p&+}xR<Y)+?2u6yyB7Jt>H=CEdRhHL8BK!XDreH*+;i>&|B%F3N*=Y03g+f{r% zsj35M!YQcYH$PnQS*qf0?7r@UnNOl;@4Ywz#Px?<CPi`2c3VKjPh+$DHu<x+y`qph zaN0Te?K^&m*5Nnu+uysHPrk8x{N4+$UF%zBfz>|f4#DN!RMs(sUbes1ox3-GK>_i2 zZp6OBW5yiLCVgC+w_c$r6H~v=f0lgG(v+Y~p5t6EjSL9N;_J2JpL4MnJqA>3n*jC# zSJC$$S1n-8gLUZCByMAC6Ju_ANe$p}Xl0L}OAOXn6-G~5Mv?C|?kvXot(T*I9w)oG z<&0KA25muB7Y%<MxN;QzovWW-zvddcS5(o+!UJ#8l#BaE-Fj%VNI9mY>0x5a(51nt zx+JAdp|ZbGd5naCEmzASdpB0o6qK#)WgEO+7{=QOGKITp<zRGRZW=-FmuZ#U8e5}8 zsTPAmAFzAO%4<2X@`sP@$6ewE?b`+)aW+<v^U%%1hcxHVSgm$R^P$VzEZFEDU#i|} zHKfZ0GIM*PCZ8u3lyxc8hYPT%vHQA~IrKE)p~lbIH!N;6+lB|*4a(2Fu%IWiqyS}s zzEb~8ek!n%!t9bjUs>7NTIy=opegx>ah^Y&W&i3w)b~e!;f~VP&?Y1+{gA6V_fqa4 zDOrcmF(C4G{_h!JACORThmj?jt44SV$?H)O*VaF_v_X};X`qi_qx}}K59E*-<_O%n z;Q#N!3vN0{jxxDvQe6WxT9c*GH%hClz1}F;A6=X;Ug_->Zi_mZl(uPG*^@;C4liVN zpOKPTG`EB(90}#R=Q$k(K8g8t2#7ivtL{>F%D3eg_nrirofbsg%5z(Wkq)?4yWDj! z2A$^G-K)vXJ3y`knf@90RTX!uVeeTxk|58QY)#l9&_K2LRFTQ;(9u9Z(*T})(e+XE zH(+5m>x%F(D<CCxn3vx+yZ5<JCuG@6pKD17K3Vk$Oc2*Pgp=!)2gG^q@QOK>9~`mO z@OhP~QAZC5IcdqsD!9D41m*#;BVFmPW<QczqyR?;QM#@OkTh75?OwMOlFoQkidX3L zf6Qq1zwkpsBl_Un*=oxaJ<zv6?rs<!;g5eXG<S`zt8i5~42R5?on>e8C2<wI((1uZ zA@<76B}6Abt~mP~DwOdji`0R_5!cF;R00~nF8OO)o!m9f;ho={z%5BU59YSD0W*g& zzuZdDw3|xe7sJj&j3;bV{Y^MD`&=<p|D+0HtCVvhBzSMfC@pH+2e0-dB87LdSM$~s zpYb$Hswq$C<G$_cGx93F2=S|!evwVFwSNhA25Tx+;%n(&sIezVpK%Vog{vXt6*cJ9 zf!819mgZ<=NVvgsNybN@F5qVAPtE2jZPKr_V?R_|cuR2FF7F-l%o{6c@hlTG{YSb> z!3%@f0Jx-9-=B&gF20tjgRk^>WSYi7gIpbpTEry!4ZAX{c$llXvsABA`2;OM-_*th z62e}ZiiMFIl0%2TP)K)zS><%2=EjxvA^`>dF}$wEBOLw$7hjATbi7<2#-;_b#yC_L zY#W(h+I;Mf(`JT6aNy;>Oac7ndZCRufreRTq$h2;Kz(s}LA!`AWm64iS5%qINFR(> z<@?vbOWHP)5g`+u7Y<aYV}+Ae5``{f`LjJIo6a2SZ+Ua;FgA;H`hv6s{WuNJbSSD! zHZVBrXi7Wn5VZ#fkzcsRaPEt?%1O3;OVi>da>FJ-oIH%IuRI9N{<kzED60I+%=I%^ z&Pk6#SpF$`C%=(6#fmcsy4}4XNzI0DzBZF}Es~Ha7F4EWMIKq1IB)MI&+8y~U(sd5 zH6PnV+Lcz(n4g8fsgL5VvMy#4s77peG^vd*?)u0`RY}m=WJ_!62F6_<o@ZJ0PE{Rl zVVl4)9%C;1R>>Gri^FiQ2b<IS7>1WL&*fOc6TU#=nlCaAA`ku@l6cCq!~+~+LGtQ% z%~o{uXl?8+G$B|JYJYvo&U5|5GWCpa3o#Hxbfv3dTyHKUec(hUk@FzOOLQEjs&rMF zlY5Lkdr2X_uS<1G)*<1c<7y<<xS^<0y7fLB_DvA|BlYC&Z2LvZ<2771MMxjnBB8K> zM=ajlrvKcdNvoNlWX?pyWLMOPNKR8f;DWc(Jq%gS$Rb=ncnsG9B&Uy<ClmhYp_pT7 z`g_z-1p}DW;+cKfitd!X`;`8X^-Z_rhsUL|bJKMl>Ou11SmvSJ@g_G}PWpPitIot; zVm*WD=3WC+{YO*nq;9&hps;DfF?yko6{mO(7I9sVvPeJNnl51R_<GBx>T}yrDQqmz zKMs~GH&&XhaMW_Hn!DA=Q56mpgY<rJSI<7-BkL^TO2f#GJ2oGzh}~wSwY<hwqPB(G z5ioIO7y!?Rb;EK*_tiCaw2CEtW|>{q`Cl6xyZnnXFXCcypFMo;<><l<Q1&jwHWAlc z10qc>Sxz<PkAIysE$?PC)s9}&kQ%V+p{V0wNM-ozoLSm%`Bw*`<E*Dal^VHa2cdDt zoI-nGC`4tHd39QX^5c)?TN<wJztN5%kX;tRW>^T|r4BGkovx<epfifEeCIu!Wz~W1 zHKaB!4lr*vECeil<jR{>cyP)*vzRp>)!749?8z@UGR`m4q_()37c;{=AxHCF<$RP| z{a83*u;gft^?BHJK!&GEcFyUp5y)vk^N6+U>^S$fJ$;Em;PVpJbOFt&X-ylR&1dK^ zV~jEbwHuCzE6h_$NCDL^kq}J<Jtz#MkH&=34-)R7UkyjZ13>cru<$S@lJoymqbH`2 zJEkCU*08-GIs;~|q;`e%haU^E&6kY>5bd1x%lb)V);0(&_D$`WieDiHMtJ=Nc7CC; zss}=aM?imLcEH)D;#S&QPy?#!7E=7$^to&Ba4kQlblR-kkBg&<@vj2kpg^B(5l3D( zR?&ZC+;*(K@QP8#_W$x#$ebJXE@2TkRDQ6&`T{%g1m@ICnzLaPC1ybpFoOoM1DDqP zPoBH;uyt(s$-83jPf!KaF)q%7C$z589yf9gL$2r?fgR|b=q^d~t&{6G$Z0bckEU)< zbl3`DbiNW#g9JVXSi*}>ngg3r6)j`dEBLjFPf8z?FYL7@nUi9}ye6NQm1){W)Eni_ z)khln;YukdlkSL7!{EPTWF6~(y+V*}(pRIVfdbxhy+`7te>`}{gl6`r#uZBXF4i&7 zhRr0A{KfIKlUl*;m2Li~3F}BGG?O0qB5!)}h`yV1zR~S0d7x5~0(w?NKj`5j_$;SN z?~5N<<@SVVThku50Z;3)z}>)A49G`h6|<8kNOZ;z6j^Vr#q^KCmjHbj`jxq%4K1$2 zi6GJnjh(q>iZn|I6--1-vL@YRpn+wAfO3E!@}DPd<6KHCDokU&7*>^#0(y%{ox-s@ z{lm9MTYf(DX>=6o19h9RMx8UncRL+^13y{FUGxR&UntB6#cAF)(AO!Y&0k(2XDkQV zigNh-)(wz5hw8v_$JYWLwIjzcnM+dGTaE@)KaM1@!U3jr@h06rTW9d5Rqz(jE#mx1 zi6-~P6C(@0w<Z6=^r76dDbOmyy3Z)8R%ct{mjUmhL_yxqMD@?dI@^N;B6U&uc(vG3 z{xr5Cca9jDoCFeM%Ml{mxz7+Pk60f|R7w}w6uBSnj=8W3?JPmUMZ55zN(X_ReCPgU zyV$_Fx{g+b7CcvT1To6z1~w%d&TM+%rd%3S@Tkp9BZ`87IY8Du$zJl89qy5)b#c?U zn3@2yodSqtYl=~@radf!B24SUctzInRDJCJ$3-(k$~iD4pRuMw>td1!a|3X!PS?^k zTx*IsA<%jG@ZCX;Rs?yHCXAjx&Niz)cQfWMRKi9s6F#}V_=UQ{gYgw4G373&^Q?0# z=V;XAU&v-0(5uKg9o>W^(|G@(8(&EzMf|U_;phM6{z8rX6yZ;{=E?JGy1<4%&>|c= zBH}i^f9j00-Md&ClR&JkBH(Z3ZY=2x+mSCFj<84`n?EHq3J{|QKk-(WBCx&7ELhAv zt;3A5ry8F(>@z|n%_St!0!!FQ9=xOlukkgN9eyE(B;<b8&<b5@lrg)uUsyv|7OPaY zjLEH&g}xZ^<!!%w3J@K~<P(QUK63T;N!6?cx*V7=;eDDjs-YY~Or6K*LNN;`XD>=& z<h^IDGaKc~s~pXQfAULF&Sz8w%LqQ+wJ;TzEa9uVBmhF*z;r;)A*@~S0U9UCDM3YY z!+~UfrRDRrswH=pXY#ro?Pc$?%PNB4_^NI|@FH*V*OJ>iEggeAECNyzrEZb-Ro8&H zWt5{pf;0tt{f2Wq#=b^Ddz7RV{XQFh(fOg!hR)u~K^{#9azlp1eigHZQ;7<UWoMM5 zuzf*U?zrPAC!go;QOCw)2`yW@E>rIW)@-Jlz_>GhFG}EM*5+Enk6I4<Ax!v-!y%4! zpU(<ZYq66NOM1#r85;+NBp*sDm@|!<-|ezfz7oX34yusrl91F#WXN0e#AAr(Iaaz` zY{EFbmo?kn%!nQ?xGvuSizCWNFcQ6rQ>xgu%iq*$HX@nSa39I#RD6cI{U#`@ZPxuV zcp8UYZaM{ZdbIC4bxg;`zKn^PBy2?@j9_ef?`Zy64RQk$Uv=w$Zwq(BS*A2ZWdzQE z`7m^j_1p4x1wQZ{6x!fCe@O9c<*)qaV6mN}{Ge-_msF@z^SF^uyBiQZ9#h#uudp=8 z|6^0~T1)jzYc>B_N@JC=lQLO_b1N{Hk;`9={X5SYH}@w=SU2+`6_87zn8%tJ%3Nbe zVx|odz2&xlG*-u|<Q@GcrR))GnT9JhhBzEUN4sa#0bw1WRbjvq`YXup$J9OxJ7$}E zX@A)ME-wA+ltLaOMW5-k^_TmHH2sPiADh~M`<Ld}h%TH)ZSxY#x)n9SYBJK3zR}>% z_(?8FF1^%-rftMMSWQxfLT-S$#$bl7nSYh73c<q0K-qDOB}{HlpS4gFltApIFz2WI zUuP60R$Lcbep=-ZLG^7oG5I=WmIFJj$f(|iiiy^2lK|FJxhJh*>sFONO%LhEQekg- zS>N2~yGF&J6c)m2#kqDSsIHN7CM9^j8h}maYSH)Yx|c_7J@_+}+0E|4!P{%F7%v^% zl>y}KAx|kWXW<$VubW?n@-72fffn+ETcAfx$+N&TMhd?_kZV*3ek}eU{1_4#76~2_ zBNiUw0{TDvSOgA}O4$I1g54n?uXYAk6apM4^j=f5atQChiy7KG-f$-N8O7(<?fwTe zhB%4-0~*T~7`IbI1VT?ra>UF3blEL2U6fv@sVG7j%nMAzuT#Xg<W8HA1?{PRzWfq1 zQXD0mkceQB5%iH7FCEZ`kfbp)sfEuRbDjUfTh>B)j8@YZ@RP@uv1Dh2Cm7=6Nr7vd zK2C-lld0rf2kP9nWmVPDu@`;Pghne5^c_!|NfV@B*MBA3u?>+l6>YSb&tPXS+tbKq zTaTcM(%Ve1$w7I6aYp&rBJLAnI!CWEE_48EnaOvya9N^A59+`e<wK!B0|^-g+MRy$ zcrt3_lPT$XR_s6l`n(0dfrUA@O-Q@+24`)@E=I&o`6g$VFXZ8V`3R6Yn*3Br<U?5U zfy5LQ{tM->2N(-t2lI^_q|ZhPO6><(e=A<x-?{JP3|+Dynz&Br<jVcPnUxg%fSJ8# zQM4SUXr>j#MaEM}jYzId#c`%~<@6&w;7&{NX{2kp6`L2*rTT>HaMo$;$jlMLc}oeb zLGrXTiOMj8?8pGoH(mMrHHY?h+%Q$2sG{1nr`<H+@~=VC7o(W2T8=_)uYwm%%RGJs z)hizhJ~Jq;;PK!;4QIFx@m1C7INk-*zKsq&Ny_KozJ*CaZ<Y3IkvOpi4<zr^&3-w) zWLTs9U}f_70X@UDzP+Qw+Aym=a*(TO0*;h3=0__p6?Z1k1D-8zy`bLGN5}WYMHhY; zDmW1eDIV1l$h|~(bF08jyQsVs=%Nn9j!jVXyf6Ozb-VNP>-Qod$NQ3MS<n9_c}1Ch z_uV&QUx`9a<d|K5vn_T~W#5y{*$cs_u6dQ9bRaIMt{xb%&+;=pGp;Fk5b}R7-A2E{ z3`e(0pZC?IyU>OhTexl=g7vm<S}>AN(@^kx+DNIvn9gE%=-KUgXkm6ZUv5j^QJx~c z+-A(KlKgz}iu715z42+i!dfqjU+o=6p>Tf&Gcy-2W{qH@246Fad2(1a9IW_F@|!OJ z#--1pkzC5X`K!rfW*-9`+`iT%J&-d?S%icIJb#up0kXSKo5voUpxNNh5@D@VlG5fW zfS(NgOp$GozL#={edP`2%rJo=4eKlF&6o8}xePw7_N7Z>=-9@b0poItrHe_}nxGM< ziH5Kx?ys~WaOxp)`rCd=GTpae-R~sJJ~*zB5+}ktuHKCK5JV$l%hyYFonF}4vYD<M z_gl6|L{3K0E8F-KjinbT;W4zoK@^0$$kl?e#uoxK&dT>H;)_}dUy|$wLw;~aA}y{% z2`jMN_8spp6r*jjEq<NkvG#AD?{KaT+Ks%um5r;}w~*M_I{J*Btb?a{`)jqG>=hu| zy|S35WA&oU++O{Ud}nN#PoiV0KTrZ$DNL0TY4O$T6bAjxgcP|lDb|z_7^)g@sy-HA zc4|wQ@WoCs<m-|k-(1RloWS^m#b_)$XqY1rH^7*ztMJ;WRAFoIn#EFoqJewk5K{Er z2T`RyfbH(k{`F7FCTFU$EyDeuY18CYO&+pKSMkf&;kKUS)mW!|E*=dUl6Vex$vu+0 z=+By~oo+67iee4!xI5fom|i&1VN&g+&CewVfcFr>__<J@?%_y6E{KN_!(XU9zj-<s zv0?ltQI~_-#0Dbum7Q(8G%G|5Fx*$&{!=xB-)P&^-Rcnpr?V{P0;2YOQqbTyIYzpq z0$(<)6_i{pM<_pr+|X~)pZ|!uu30*|Yr(mg<}{rKq%9-QaP~kV-sb!3tM=OPR`4P} zPY&;=2{T7i*Ow_{ui^|JXB(@G-7N)LH$8}l5)s0>sg{$ZQ%78h^rzT}{R((3{;K)4 za!Xnfz$FQ>y^WUyC?6J+zl-Lh*6;%$HWM^cAyn+7ugYy8>P<m-lo}14tuEr;`dF|o z&(_2IobiaT7z(hUk%YI+o9(`wB+l`@pm}t5bLV#c73a>9yxeb{@{ik|y<*qa_{naj z^)#GzkQY94K>D>_)2pm4b4rw!0$t8GhLZ`m4kWc<hT?CwCxTiv*^Np5o0*=*wn*y| znfevP5Lk8>$dDGZ^{qJ|lJrwE-f7L-&UEE3RqbXru*Vnnf(`q|`wx#ZCCQyz^fYuT z&1&-i5D}@{uqXNf?D~X1>`^0W{W9(_{o$VeZ@`}gp?-I^=$xO4_kM5Rt=trAsAuWa zSsdPiK<1)eD5$u|7V%{#)QFHM*^oDaN}oh`hjz)bbwKj8XvD@?WTx8Ati{F7J$)|! zC+5)4Ec1Q&zC^im?u9XVPz3%<tU*vIPcz&G!yaJHIh903Z%N<J`t*J+!}TX*6Hfcm z=@OIGzhg6_W2)T$a4z}g#YWPryayASq(lkfNyI8nNEV!9cqf@l^pnS5inl!q13YvJ zfCXwnTqn3s)v|_s8Y7=&efO>AdGo*4E<yw0CW$VG_Qz1o&Yj{$cAnFRIiLlm_%_sH zT9TKvu(@vD0&u*1e?OOH$C3&4F*nQi7=@p!htXT25>mMQg&NCeQadBP@hte0tVrSp zmK<c*l)mZ&UazSIQM#$F*EqE_vJMhJel~iF<6~Q))OyhI^v$Ri={SfgHb#kB=3>Bi z0)l(wDeZ@bJJFlZ_dx+MCVL1-Qqfq1ZO|!l5)lrw{z46B9Q&i+3d*ce_P=#rXE}lS z%X^rZ$%x}5-v^en3RzBUzl<YHy(t_|dH7t)W2;Ef6Aiq50LgzQ^60aBlQM^hA4Sw| zTaI7oN$_SG1FZ*--z&vhl4mTZaX#2^c9<L?-EVbWL4_KS#hj)!2-Aa9D;>xfHak4) z*Yh{@H_?RGI=StU#LsuYC34$k&M+?X(;7EQA3N=fHJ<DR8P?d{b(g{-c~*Arr6@ys zewP^3W!lvN6(?0&_}IwPS@Vy-h0GAqt7H%uR0%Qp+tSY#J4#8Fw0eFb$am0-c>g-{ zqto-#QvUyvUo+??o^;QY`9Sv2$ez{@Uhzf}+rA@&|A0edQU2>$?xc?SySQ77Y<s1f zH4Dj>17irEKVYp6%HL*KgT!!WjG0{IAM2H37y0sxN-qqv8Y6)P9x2II`>S$86?rHz zMFd!#fNfmYS`~!ZF?=el)#0r9fE+u|eK<F`v#9pgrj)`D$!tn_ydk|sS!I=}Z6}oY z?=;XqGtjK`Rwj9y0Pge9%FHWU>sbUtJG)isd-vj+1mO8$N`(UV*8>Z@7*dvSI+Iy` zN2&WwH`ubZ&&>Q|Wp&SEFdj8WBwgV^lcp}q%z1g2Jca~wS!~G9(b%q7`ah?PT{C4` z$7SZwT$|h^g#{*z*|+LJ%#uCSxPR~pD{_<U{hZOH;JogxL~CjR5;D3wk<JQm@fV{1 zg$fud-m7@m<+~~#RvCF4n{BZ4gjh0Hk-G&Ct(aR+^I)?ILs2-%@ACUGZ+u*=<+wQC zfmi^M+0U<g6afn2=2S5Q;G_=$nOa$OQlzRUZRP!hpBW2yfvIxC>@3Nscjyxi3M)3% z9Y$%KZ4jK+bW=E~#pU6wL~foHuhPk^62l+5UU|!difOKXfKDIK-Ji_`B(vbQ=zIx8 zL-*m`yH}4ozAXWC*ekxdJxZzSWI1JQ?0W48Ti{ONXVR5YNE>(z4LojU)f()vOF5TB zafJgw4{DyAe>S#pE}2Q_I?Vx8twfx|s&V-sCa-3gj9+?F92*~IoR|-DRmy!8INsMg zQf_3I+P8ou0458fw990O?Ae5Hn3FD2kZOD8u!4krN?U9+MX5SiwIw9}7iz{$+gqhc z18Ji8euGfT8+Rj@<omtVv0&Z_?^I5v`zN&fM5^PzP=m@$OlVkEku%*Ib6#$5YW3aQ zat96?caZlznfUp`XGBMSjeHr=!_eqtB((M7BfD^A?-Cos;$uirC2@0s;4f?rz!9E$ zuTzL%gmw#^jbY3k?>dCME%^XhglvmCvySW;bC?G}Q2^D5=(Z?<oT+~RwDJsj!HGhd z+&kck`n5T>W2sOriXEg^0LPj8#I@Ml>8bXkMi7k{6kC5oEwzj3d-;8(!9k6sabp@% zR`&~vg{PQ%hF<0ME6GQMHG3-#ag>jf9K<;@aK?f~JWxkC9i@S0l#HV^&>3yaK#fEe zm7jf^4Ofyc34;S>|LH<&o7p%h<R@$X_GxO1=z+n7{dnh>Sqk#(a&6(a!zv)@Z3IYH zDJXv$`44q4+P9Ep`Yu1KC<DNVvQI)Jf-fR5D31M0@Kn5fFOGM#64u3GgokAo$O!IA z1GRNe#o@5mrB^Nu>3lb<-a`R%Tvt}ureHp8O(7`IfQ7aAOgAI{MD&LKhXB5-^2#8; z8SYuSRT;`a@de=rsU!IW3w_UbsP`R8z8hmYvyT6Ki$a5?OF<OzWh-WT^{@1|Qh*Kz z^`K9JRZ?S=Twyc)9Qa-duaZz~7CCvU>i{L3L?b2;qQ_10-Iy=^vv=^rh9BISKV#8u zj^;J;njEY{vg_bCpJkE01-6!?4f3%%O{qkljlIY+A49*vvc3f>glli*HGNpBGV(zd z{(=@T6$2;fR#yLZ@hRc^Fct8XIg{EEXf&OtnA`$*r-xBND+#(4yYIeuE|~SReytKi zd0yp=jH!<X=j9g!p+*SO?Z(n?#{9m!H)9K3tNY~f$UDSE25OtDvFoY9#W2nWwatu@ zm>6Bm^g{6p*P0Z>Y@GZCR-c^T&ADmuS`vCW6Uwhp;p!UeXSv6jWtweAnP@W<`@~BV zq>OQRHudMQt}C~}*mK*UZF|p6CVXS>j|PKC6TX0pCp4$wUZT?0r6TL`m@=umaL|f_ zE_l|U6(*~y?k^+kkA4+ea;E#^S#l^>n6(Kumnbs_0ZA6@8Jfn8pqG3-bCg(nMQ+iS zY3DmO+(*q{M0qkje^t#PurTzn$8TQlycVl8XV|cB@7l)w7EO1mh|89qb)ERZa9*2P zV(owNWN9tp6mQU=+3G@vLLXHmNunNv4^D)xn;W{0YW@BbYb9`?M8{V;il^Y$Gku$? zp5(r5h-P0^C?meVjYJP>0`z?)s`jQ(u&sgbg*#)0f}F(Q@|nr^dYH2Bcr4SZ8^l4m zn7Nup3c7!xOi1(3+{W0&=xE;Zbyz+kN+_rVyU}uwi}@7d$p4g4Myq{tbQR#eCz+F; z^@uufJh$5W#O>Qx@oa8R@qnbZPPVPx;%@20+&LEj+me_$O!ke#`5{EUR(Yx(2BwJf zbjNw(sd&zQW_4oU9UQp9txBZh>xg5C!UR1-c%$I;l`$Z_{ryB$Kdk0YA5M>vMU#_| zgxaJNu-z}i6=sUBP&0T5`rFKU8f7l-*}5WjrX7EG@SI6gT)F3aHVas&r*x!*DEQUb zUa|8Q2p{$JdpU{s%&Jpcn4=$<?>(X?21>E}Uf9uDN3qiWPqHUmwBwRiV|yquNPhY_ z7^1Hz%;>RpVoD6^mo6T#@VtIl$9<PesNiY3R;JnXqr)AGD>O|HK59Ljo5*$^A_jji zSCx>$SyZOko18fgyWrIaV+_`;RoS_#`25sSIcdrbqigD~C~j#Ok*DmFYPt)d-|!Q# zM4qaL_4KOXY**PZ;M!TTY7#q7m|$5&J4}yCBDGdzn?kj4n4gtSq-5JqoMk;igr#<E zi)F@!Irwd9WX(MV{<*|LcJ^Ib(?0pC-zOrcL~9mg?^;PXDP#kcW+Q<2)^d8Oa7^Yt zPas?U&3A5fYD2A4W3wWjWY;c4-k<vyL7zSgRJ7;ZW$EVp8A};PA6}*ZCgWq{Hf>{I zX>I$snlLmAutY2ywkG(6GOvJ3a`zBSBkmyh3BZMLuLBKL7TM?KqpA?=<*j5z1ycas z<erSG=6o&DgZaUmIQ|u<Um`U&(q*y~5HiBaUIBD8A|yH4tl)YewF<OHC=^1H?}}<y zYbqwRr&Cig>5X9nCTx(aDQSjrioXfWMI<ij@J}Z~0pSbD`}rF5!kXDS0XIi6B5X}c zwll7!S+3d~NdD)_=0MC`EF?}K9N~;RaTKu~B_=xKxFID%=ypX!nmT~v0|I>mKQ0sj z95KLOU3`M-mmQ_>Af(Pnc!;sMX!MLZt+a9m1wW}epk0mbHYP<0vFq1(w`b|sp6K=? zoN8Hb5OIU+ppdQoYd|TLn1gs|giy_}cJ^YLK;QPd3jxAz&EgUwGRdi$JXN}KBkPii zw3R0?-*{AYWsL7j)8|%hlwKmrKTZo<k-q4*m+tdet6+o!_1~s%YUKJcO9dK(dF@>) zI%mR0D_}ichlz5NNozx;(lh8+yKDK6Q?3`Pt7i(`oHo1%xdT*R^`Lve;;l`PIOuTf z^W}<lj5u*iYSxGvYRK_385qnBB=+)NLAjTba~Z=)5yaq;Ky(8O@<J66!YtMCbor`e zy)!QK6EzWTyGdx6H??DhIhV)<1d9cd_k{T&g0v4=Y;wX7Z}1VNx>)ylJXZ0f3^ai} zhxtdu-B#|cL9SG%c>s1R1r<6{(>N2S>_1DeO40Hc;{;E;CwTV85T6(%2ZRZsjZrXn z4{YVdl-*y0Bl%T=FkdBZH-8uw&Nwug<Y{GnRH_W~xtA~Ac`MQhHkdXXtEvcLzLQ_d z>pSh+c%twAB;Igg+E9(~Z$e9QoT23pt~M@iCF@4nTyS?RR-$0}G{P*%O><)9x{j@U zDRML>c&@aC`!@R}L-KxUN;XCG#$B#dh6)P|4b+bjW+5oo=1$Tz*FplQp>JoJT$rCJ zfB^zHIi^@;Fw#1ub-Jxut92pzMv+{f{keF1OVu!C+Hfop341?GGAxLh1(qj;UT1DE zjFCIvIXqs=bL)N-=N{e|UB=|yQ<7Wt%36+H(AapGzoDX13*)V_IF~oh%G(6Vg<FOB zmZ+d}*DF}Xq;F;*l^(e;icH`miO%WR4t_1#DY(QkhFVUOZzA%g#|C^>6{)AgF1z5J zerZ)r<+|96l5a{;B0?vkmY>D|6>-mj5wSj`Ih{1tfVl=hRBtDbL9PyJ@E7)@P?p+X zbjL`Zz6O8#T*r_QHuIn6V9wTNy2j}+$q(pzckeEs0ZRgX|G0pmTz{DDf?FgyF5{O? zGTG6m4uO=UD|e4iB;Nnc&~0AdN+dZ5{!5HE*1-r%+^<f*zExN3+}W?l@#-Jd6nqLx ztn<0TpdliF{Xfe%FATi}{%!IP`Qtxhd`;{!`#+ler|bueNCTi#elZkj!`1tyEVrdc z7>BhLxY9^KTN_(=WGe7{Q=^lAjc;Egj*uoym<$&PF`d!e%w%ethQ3Zi4zty%F-eNq z82#Om?LI$@&%<L}zEZrz+r550@U&i9Hx7a|Wjohm{apBns_z~wVi7dqkeET4OJUtW zCL|gjsIldGmHvnJzAXBv)zA1L4o~S~7%F7ZfcwRUd><6Ch5TM^H=}x@HHO$<pmf;S z+Y+H*PX!eh77^`ogtY!2H9&}RjcpJRT+H^5k%fn1kzw^m>f`$0LrutyN<)U{M?v+H z*K6eBIg#+!pRA2}!-6i7#I|)V{KgG-zcKzKxG^BYzp=K|Od%o5ac5(UVn9sHnh&%5 zZT~`{yU&j_Fze?~TP!QS(visz6|0*yV-ParE?Y_2;f`MmpY!ff)G$*ws^X&s1iv+^ zJ&<<fz$?Au-jJ)k37Mt14{-Kb)aBHw^%$!eHIg9uFBDxsocm_d&MAkR_V-XP$l%#> z)tSd8p708MnZtOsJ{OE-+TQdEJ&-F>y4_~g8+6ch0`m`Jo)q>seqx^cMYZE?M}37j zS(cUp3C~AWyVf{hdt_ObO9pbFV*BAt{ZgDPTf27!jhRS33ciunCv`=^y=PIlk-v|& zqj7Y^-d1hwU8AHet?$r7&A@)gwfjdINSvd@{NOv!X~15@as7t@M2gF;L&B~EYi(S7 zEN0Rqi6RMhw#+P0)06AC)x~`x*xZ*dpi|GvCuOK~;V`*ipL<G}gt?UCTHX+%0@WGQ zMnNI$$1c*R59%}J+1G{4x|MdRNk#gTYY#swtPUC@9PqOSuR1kDO23DRY0r>5#?Heg zrc+#M|9&M|$Msf1SSIIUU(?*!1nXM0=j5x_-1y9X{1OUU@1wfgJKrSEKa*)!sKepj zFlO|N2(+r?<e_3}8*`}3s@a~+sik&wotRSI466?a-bl;`=<CO_Pz(Bo_8kQgz<k89 zm~z9}J70@syfw~;P1BzDmF8*S!=bD;YLQAT`0Yj}2+xWSwV-W<>Q){jYrGA817Y5} znbUT!bn8c*&6B6qyFAx0e0O3PRvPM<ST}Mu(2%V&guGcp<Yc8<U2u{d#=u-E9ZsMN zB=PmbgPTMDNguj0b-923lx_DQ`C*~Kk`Cs)wuR*O_lUVFyq$DRRh_S>zN=q(hw`YY zPqu9fJ<LJxI4n8AKT<P5D$?Z|r}IbDT>}JM!6uNN9^!%cx4uDO6a`42Ovvx)U_Kzh zAi*O31EfHnps?Vu*>EV~F>$HbA)a^+c@)&5jsXdYwMySuIXH#&4SQ$tXl4+^R08vN zuAQ83J|@?3C8hNJ3#dRtAqc^2<(>)+efw1Q9aRLabnAD&!M1yWi5R6tOfs|>K|}u@ zYw*F^j`39PA{o(c4kGSa@MM@FXZKJ+T+)PG$%1G7nE=0~PMXY?Nt;}4Qqpi;dd+Xm zT4)zGNv(MmjIdNU;tFYvxj}q<3loJz8sn53+}kP)%o#eF0m;4=AW7^rE%Sz}>+H~c zM+q7?IX6gSZ0l&SzQ3R5)>mV`wt|-UOW~a&%y<$V-w}9$01=l*N9@56x3XEUr0+Zf zc{hAAQB_|9z1K3KsBe;Z$g$OZWXuZ<KASEi%@jtWao7(31G^C@CBH)+iw3at0l8M% zq$ik0Jo<F$v|CMl7%?1$p$-S@DEo3XWetO|LOxMcX$8aJyeQS0>3U$5e@K{fSv-CW zPpzKy0=K2CmPdfw{jm&gPD@g6N69`>(zJgZ^kAtlf!=gps2rSGUpyl@arg5M{WO#- zQa4B%>ri?euELZ;LE9jT#~Q@Z-OZizK`IB0ll~1q0SO_4iM^WD)PrP2$t@$4D+eRa zqD>&;F{L&YnL6z+RJ$`}ml~N6=EqRi9Fv*^_RGdA>ARhx5c2$4N~rhC=W6faALK)9 z0FT}N@|`T$i52z3+D!8C?cv><M204!dMfB8&%UI-5AI)Z0T-R$veJJm=isnAcA<DE z5Fx+m`!L^BU`F8thY`WH%eHiU?N3Xpy8Jm*n~$ocf5Ty)YF#sKh#Qx!wS!9jI~7I; zu#fSXfwlHZk~F1{hYW3}uy@zPbScHqge^UBE4!xT^(*>5XJ+YSj6wJFw?|+Ve5{V4 zc#E}mL_AmKC$3AOMG$&R1?TkGojBDX(b~sGAb;6*Qs84tzjsTQQr|}A#-|W_s~83J zp<Nj3T5N8SmMfyRQrJGs3s4X*-=5f^>d$82L-nJlz;`66m;r;PKyNKU7orBDwln;e zD#Ae10Ru9gTC4DhQkiuWm+wf|v_Slpg&_)oe7aTC@oudgoSzn9=y=~A+gMJcx83<) zdC=q68d|$t!hEsP39x$6XGNpk#*o$#hq_m#1{8@69r(GGF06;yW@`x7)ddL#2P0yl zHJD^lX_YTb9_8%^Tcl9J3D*tfqTtdqnV;6bBa5H|F*uoOZym-~HMM<T$^^DTSU#hL z$GR6sD6(GZF4mrx&V{y!1>U651f@g#B)IS|!z*YAeQ}~tXaQDD{iEEH@i_KSkL5uv z!q>6*l!%BV9Q`z@NnGup0@PV>!-AekDjbx?S*9&N|AkUB)RQSl5E^P)V_jm(YC5kX z#IbJ>pkYh=WI!2nM;P)K>ZA&9dqUx(y%}LtqTBJh3vtSikQzm9I`o^t@Ibk76c=pI za(^5^Y#e!bKQi2MgY}M+v&V)@?`Z6fG>_U`u=s=#$m;Yj)E&6i3Y{7@A_$ABZhuf9 zG4?gA;QDP-%9Uj>g67oiFBF`7NWUQ}>*U-A1W4Sx?hu^fyY@Y;XZ0?%>J+Pk|6gXl z54@eB{*Lx8XS$9Eqy?}NTupvEidD8nKcMDE|7qU*J;pJmf0L>8j~JWYdfQs0NupC& zEWMVge)`nqS!66aYNC!+{8zJZsh{r!I(Q_t{PN+e>2TO(oej0KHUAfTUmX=k)Ab1n z?(XjH?(Ptr0S0$>3zpyxGq`Jzpo41&?yiFdPmmBG5D1c;=Xu`!zWsLhto*gR=WJJ> z)7>*Y)iqsJ_ujhpTmR|HPGdbe`%y8u1AXht+DmU=REi9vG-0f;A^0QU2XdxD#G@fO z?^V|}ki|=fV0iD&IN-(RL>ZTfnnUJQ&=6l_DSLGt*R~Mu?AH#Ct{9sJ(;Wy%4Wo>u zNP$P4bpCYnsjWdb$J?4c$0x>GT<+9~DF*KAuc<QvqV{&;u3AcG3<>Z#kr8TZ+XbLk zVy=lq!9VkQ2O53}0C+a3nFEM)DYH+uB%BSw<Q$F+_E;5mOl#!7o>=MEp*vLCTtlTU zyK$op5V{($s)d41&4<IlwUKdCE_tLkSvRIY1yZ~_1|HX{rp-60MEtmM!|h}oJf??< zqQXKK1mHbel3xB{dpuLxNzCMd%L>=Bxn7^xVml{~WaqY}>xSY?=apK+dXqNim8{Ln zkYBr|MLU8^*B>UBY%c7H+LWhM4mWR1p7VQ82b4$N)n?KJhQp_(?lb{hnS>19dnQsq zYG~|t-x@ewvwK=Fa;M#xm*it74q18OS`90)@&r|M5*>ds!%iilJsiH~yAMcaf`|gX zebDHfB{>?xk98E<qsR$}5R-BL(SRhIgwI5v*_vr%DZ1gz4G@`Sk&holMVbJm1m`E> zJ_i;l?!EZ|71&7{7#qAzjbMsF%(WH|;^``PFwf>2UF-AA;NL&UOi+Xb?u{p>?Q+(4 zLqrO=xG{SCTC8TV7H`eek6u~}c&Ye#`5CIvY+TQJffj0esy1UBX9+`-L<>z21^{`& zXV3ioByTG#eG$#v9zvomUq}PoZLSuXeNX_E<=oq0m6)%KyvW^8iY3h12j1QgHyCbt z&92UCn(-%!PJ2+<Ebim-DH{u~$hiHNyXZatA*(y*_x)Kz4Wkg(iX;bdbhORq0U8)c zV@Mzbci#s?iizkw6mfF5p&ZPr7sU+J_l|(@rA7QAwgPfec&iF?(2cCFlD1fwxzzVM zmCG4WSHQ20{gT{&5uC4|R!;U4j`kqBdI}5)gK<EpEK}F<_Fz}-SMu)fm-TBN@TO_S zWLsq`^}UF`$-bK>h8)9zzlDjBy4`LX@{QCdTM7Gw@7EM-E2RWyXzsn%6BD*)1S{<> zsN-(e%>4e#eeo&mCFfZ(rqI5wJk|gA)<78HY)0O<AXp{c<_3$`4cVE#y|o{X%(&V9 zXCD@ZwZG7H?HDvt1&+cDY|`Wwsk<qHff#k;<U+xEAbdHG3>;{6c_Qwx$gVAM4%bKl z3$<9ffIqasr`I<)_>{6BsC{js*Q33S{pfgDChRobhBP$q#KjNIRYuOraMHAC9xXB? z*xctG-`(YhjSnr3vYpao$|^(1q?tYq){>h$?H_UVgiI&cD*wR6mwZi-$0J_l+}MtI z{6<m_D){g?+Lq~CrrJaRMcP}_^N#gXIpFpyWdli(eB*Qa1Lw{{Gn4JO#|?d(j~zL7 zaph%y%cqzw*aqpUbo9KQtXX7<+Q`R8@X-`0b^r_Z3v-^n(SK>In)!OaY&-f{bzbOO zptjSGB^j(31@^b8#7U#q`k4u%M0AInCV@ZVnYg)P1egxmmydW_M3SJBqgobZBA@)% zGF<CdTsuDS?;X7p`s;@hRpb+z=Wua-r>^X2Go)=}W=gzIG(4TLz)i-uPujjSP_21c zj<0#Wjw<C7Kd$H8{2fhJ+Cl^-h;ldhkZ0SUvfQE@TcHL0Vqd;Oz0f=I>HE5(!dWkB zY=&ex9#Ef6vfB6tVzcbc6dW~c((R$E4_TWdZTl==YB7h&5U2}H%eD&uu`Th-_P~f= z7u2OA642`b+;lc~CP?m79Z11WS73WN6d~=W`CWZ_rqYE?=Ubxbnw{OU;r*>HU(bZv zs`#2KVJ`tK_@@dgrlf+^v!8sCZo^Npc<pw=cW=kOHlN^r@0+nVzMBbm&|<I~Vt0_G zE1QlU|K;(PZE)C~W*N_|EVP=LPFPg(Qfd3-as(b{j5ZBVBjOgfi8ww0O<a_ed)*l? zARX@tOCoGRSACR|Jm3BVYZ5E~Cb7;&!y}yO;#iy92|j~Ie?uCWWoU2IotV6NhIc;T zm83295*%y*?*z3A@=u|cd0OaU-4Q>vjZny=kAF6IFR*hQi!DT>KvLinF?(p0yd}bS z22Zu|QRYtLn5_1Bx|ZW(s1n$S@?lKPGMCq@Oi+<&tk+O5(S_#1Z9YU>x_7FQky7(! z1>5ef^oJMX6701Da;b~E3QZg1#aU~~$<TYO#$O-l(oIZ4xH!hKKU&=G!@L;In0G$x zaadowGU!R<Zf#1n!}+bg(qItDEh42n)ZiH4fcBNTJ=T)HP*Z@$*Po7AHs2;1N~5GS zAJ~4baI=55EnC~&1fpWm&08CyMqEf{GaS|0M8<3J9XPH@qUmdp*>s9-hIj+sZv-1c zI;9ZPdYCw}0J{YfZaXyOt5iNyOvM?vY_c@3=&(CB0pkY4j=ijN9^+MhXO!ez+$_0# zQfxBN+nu(_CK3JNL(!m9671p~2szPg2f|H@Pkn!QvM`Dze#YJj+L|H7klU9#BgF7n zQT-t>^8{nFl$+@ukev&2QYlc@yVZVM6Ua_JK0|KFrC+!<j_Jw7L^lzkArS1qZToto zf3OpCbpo3^qyBgFYSj<}AZtW9(LPIpV}SZWD}N-s6`xIrNS;9$xH+&Jx*t`2sDgQ8 zxI^L}IJ*3Zy3_yA-QZVxpreALn%M|y73@*ltj3sF9^Fzq`<S1&ybfvEm_~88Z2uiX zGu7-c8`N`o@byOuiD@zBiZ4ULm^BwM6XiSW0DCd_v;D9l3iQql$LG;T68}gC7erDL zP>rNtM8bKe5(?IflUUw}x|A1)q^!f>m#%EM0R?G=c{waU=W5d^Z8mng6GLQUcYamu zUE}#w*vFA$qHJH8fV?3NXi0Jo>ri`s_lT>P#A=oz?$|@H3khI{W6#EX?un|1PIAnK zC8XT{d&@51SEn938|QPw_7)&sdm`kcftC2WA)6o(Sj8yMkJ-;k9;2B9yQjruP&J-5 zWhI;c-n|cL*a3n5s6W=gYT`DX6z!Ftm?7H21wf);E)yxhKC?_*u(+ar1;C~EsI<AU z#vQ6<=X%6Is(QM%BuSOpVXScl>6b-@DUv;}NWPG$NYC(2#@mr!T3jeeN80n62fmu2 z+V|_9?T3EX-KiobqC;K3lZXwU3$^N`GL^X35J=(pY=O7=3%~nrv6GM&K%qsAlP}*s zDiXv%8sJ#2Ht1P#)qxUSXk}LWy0C4^;w5$vmihE$(o!+Srt|*FN^<E}wK)x?zoi9F zBMgCInN9Evu<|Aq=b5j=&fbhAf(uhfzVp^_f5OXcvtOp!b<rgl551-$N*;?0QMBEY zGx{-H70I*Q1}EP84qF3G$}cS4|H^gk;4zU+k-|7SUbgp&L)HMtqxrUYYr*>?on!4| zIs2<R(gy5Q0-`(y78E+Awy>p`KXAX;v2pyo-))t49#B_xF4Y+<U-`U)G16|sGeMt> z)a`DftA^lE!LES2A_)-8%OfW&(q!4Ntc|d`UeTFd$0Xr@_d;4N^x)UevG2rsHo)8d zzy=p=Y?*E1a6k9%d$Qv$D!LB7jaJMr&JR)szuO-SCV40i7Mh3!|2l7XyKaarbS~@Y zOZBWjUzw*SJANl2@?A4F)F<e;ZL%-&*XvAm0C3%rmA?UamJ{ezn@MXbzxlPsj)tdu zw=w<@-B$~AzQ2^}lyTVC;%Bj-ah5H1Ohut~q@uLY6Ie`lJkBrd`IDS2Ym%Sb4~u7t zTHrQaBl+W<*O4OEb^`bB*O%1&l`M)l&;ujc(53L5cJdD+=HI`3e{)3Hmhk19Fq4qP zyFYLuU)PX4)z_7yv<wouwnGEfUjImOwDm7g<b8j`dD$~rnAF>OJ^#MlDo8R_sna3~ zU7?`Z*Nxu}c&ML~(=ie^Brs`p;&Ik7+KG<mpBta4ZjHlG-_x)XWR=BUm(^|Z*j<aw zzIU%olt>QW{@$nbX%f+@G9PFCJx73MMGytnprquiOToK)!^g(B`dMk86C4R==viLW z{hIDQ+6i7rxH<usilO+0RuI>uh>a5(dwyScEh0~>b+fe)H;J|EB_R`iTK%G1mRUI< zwb;)yGDm0%H<hl3657kAN{<oGgj$K3bMxl6Au-H3GZ2>+xnU(zVI11xW)ok`?cZ~H zHQ2;`r2A&)LyE<ETUxQ@UCM9GQgM#0eZe-XSMt>KV2!SQP>TCOD5f<;8SRw}+<I+W zPI^t*1W9~2jc}V<%gbob4Ygf=_A?s_;0S9^wE;JULS)Fe-1L}v<E+jc)skhN9+vIL z+o;tENRm%D*POVzwR`D2Vl_)i@6X33V!!ij7XI*dkjqqSqUcTh_K_m4{OHgs`%mv* z%MnDJgbx*WhQw&r`W&DgODz|>2SeKZNN_91rv+hz&CoOA2mqP@3M_HLR^|nnA$G<l zH$AW`9zFl#T^WWt=4TpudsF{NU1g>xs^+Y_;IUA)*OoIbd3!(sfLm??ky)v=x(7i4 zHG~n$4I4$foIe*=1{QKaxuADx=`$xqztho)sAfo~+U-SCe^&79x`er#92=YOK=8}z z*G0;XwVq%!OuwAV?6;xdLPGamPJ~!%9WbXMc+kj!buDP|rzdEj8E|v6s?>E%^?T6T zJ3Jc~QUE;dKkIH9!?Pi`o1LD1$lh-1m@TnF$x?0kJvio<a<QzhOtC(=S)Mt$70w-M zwWA@mW86aCf<rXAx@{`DNRV5~$BMP7$tCPG{P*M}v9+!fju0edcRQM4X^j;<xxZTl zoPY&q@+OBpE^3f=-T-{0C2mqf`6lAB6m4=NMTI3>b9woh=Dh9Fl0Ff%Q0R}^Ey~kQ zO9?c1bw->m*sue2yGHlX8<OmV35%S}jh<%Lq{};n1ec`AzFF*<aC)T9_8Xm;uGA{k zleIc8)G9SN<L|rNhWX8COSnL(2$!yFiLJ%wzN>v5F%F1eW!!+LbDVq^exsved!pFK zQG$5yq)Fs%BjnAw2Iw6VqH`_Sf0w+%kj%NG0EKk4K(#@vNVv9=k<DP&Nd~QWeVu0! zF!}Gc9pX=!+1l=GLK}#@1yh*>a3P$E`ymzIB`p^~7ddz6`d*M@W<^IFS7ktDiYmO} zHy=1=7~1lOZjenUFy*G61M!mV+YB)^r4uzN`;F+Nb+Qlsf$r?@uBGNY9M>fG?I)d4 z+il9`f^wer{M$P4gkRq|0eW#XNuFs9k$Cj@rPy-Fkz3v&aJ;_fz*N<g-$@<w86aA} zJG{`^fx(xaVNXA10(A?@_5RB3K6M5x7J>Q`BJB{ifQA~Kbn;K?iIR@2Im37&4AF$$ zw~YkMiO^Ig-AlgTFV;1i87acSUlVwVJ_oJTiF4{&tz2NlocFag8<F#t*kO90FSF<S zGJWe&v&ZVnO(cTWUmmzE+Zc02?aY>b`bm$6jyTTsE=`=f5%*W>ZW72&wzfT@E~nMu zoNifX)R02{s!-F}k<BdUE27M%khYFT&qfW#6@za3kxpZ(pV9z6nBYVe+7s&RqGyt~ zyoB{a6MX-P!qRFqXyxHl%<#14AQN3H(Jxl8#SnpugaZaAS4<Y;WT+u{2w$4E8{k-T z1QbZcMOt(~lu$ZdUR~snW=Xjd-i3KP*?8VtQ`xa;o4?TLj?hq)@?49j%+4jNvjS_V z#;J>b53BJs3)qsY7peu|c9&!Zt3fX7g3N9dGas*SVUYwe%qOffosX4m0=zoPu)rX` z@jm?Srkpx~pcR9==}!~=7K2UebwX%Bps66U9o<nsz{(lCMa}SoRLrw!He;Qo3eRT{ znb}W0Cgb<`Op0E2`38Q=G=HEWJuZgv57TYCxTIVc<b*ipdv`@X6_v^MZ}yjU0*?|C zTwB=1LJ)KW<Kx3Ll@k9#7esWZSCDF^QhC_fuO(~xly&B*7SLOmxWfx@y!lvrksF#G z)*o#J0k{%$cD6ffO)5@>H4U!3sB$NyD9zwV?8m+#i$za@N8K`*^FMtCy_72NNQX&C zurEv${7N6eNQQwE@3wkje-Xagr(#b061Mf$u(%9_m>>etQ<q?x75AlYS`yOk5T5MD zR<%pz@>>#%p{CblNHSLv=6L%|VMr;LF$_mi7(o9086GwWQsC+9^nywIJ~RXZmTp?m z^*u*Ei99z>2gV*GG}9W=eK8E8Z@#@;8jVpj{8R)9U#<Ttor-fMVe$IzAa&^XRlCqx zvoV6<SzqHwTLi|!4m3An>z9Rzot3?wwIqgkD@Y2;|DN1@M{p_|7Xh+u079Lvxck13 zQg$8yuSse-9A+W=AYnY{n+LPk2+YrRF_<Y{e&ynKB9dpCV{#9ltSXXFAdbdJMrD?a z9o&iKu&%*%ttPn)+w_VXV#8lO9&EEHqz-((@6s6jDhBhRCid|Tg}-0-wXPEzvHT#h zPp7oI2BeKs0?)R$G@PZw8r3e&@crVa#aLWm5%>E?ud%)7z)XA1j~`p}rDx@Kmg5<; ztuj011jJFU-D%d)zGxv~NB{tbj)w{@4Q5<#FM)*FcVQ~I;@lTOtK<YZ0A7A;MnC&P z{^(bmwRlf?l=+&m(=A+X;LaY*-$sa26D8x<)_CJtMh0KM*Ffr{hX$m`Y|$2!2!T{( z0u5-xDAw^u$v5XVDA?lNkln|eml^H-#t3{(`d91ATyT^!a4sbGM0zCex^4R+O+y>6 z>iE<W*(lZwiIMZ1No^xA1R_b&h~M-1n07<%ov@KdLA5A`457_Uizi&afpT#9dgvps zQd}6br7j;n{j87CPNQ(`8bpT+EoR%p@QUWe8vyArl4jV8fdIgu!9lQURFP6FGe4gr z)Y*oL8be4P3tFn~lV8am!^4amn;;?JE#W;vWeDu6a8Z&+K<5a|Op@?Ibg>fy0b%a) zko4b%(!@+dPFOMp75HSkb??|CUR^tx$Y<l^_|ftA`|l%?JV=q@)OQY{$lufn$lvnr zmE+#q_3v~_`n!PkbQL=&mnTlsaZG)*a<jGzSDNxjf-dcK-=#+TB2T9F!ZbZku6(EB zir*BHs<;YZus>8^9J|o~jnjIblEnXcLU`SWn=@oF^Nv^UW$VbX9%E9u-sv0cZg%QK z0974ld!jdoPhD&<?h<~XO_E@vf75lXYF}t+vcurs{8Xu&(V06mk-tIL<i=}1v^SNh z|LRNA2Mq=2g63c}8uw;*3a%Xt_1R;Z4YRR6)j*m#ohB@ejfDDrjgTHd#fPssMmGf0 zyOOqoxv=~58p{AaE+xgP(6(j__Nno3wA+PFjB$IMV!SPI*Psy)M2sW9x8y+DbX+gZ zoJ|u3PJ>lcHG+D<pH%0ahzoUNtqPh_S;%R$T97n6t&~}fQPQK^G$mhU)HMV$)OYb! z3!Ne)c*SPZ^{cAIAfEusQ2EsRLu(+aLdH49&DC(Jm~0&8^Qik@`9{lj(M{sT@)B4< zUHTO3N0d(MA*?!#O=esr8_lCboR@vFkE`ol8@od8zn=r1(O)wDmKuJL-(O+lkNl8! z7q{?yLU<gz{FXX8I!~n4RN0gzi=h>#LTQkM9R;w7vrkbp4Z2-ckR`XmFfP29>)%}n zr=r~t{Dgcl>O~TNhjTpHyET#;?Fu%g6w9USlD=Lg!+EUwnu}9PMVG~5A7sy&O|J;9 zQn`}TP@v}@OZUHU4J?O;8^QZt?{<;3M*RTQ6SW(%Doc?V<~G(TsgrOLadbcg1N-v6 zS04?|OcGW=0hPLBRe&ow<1eIzd;s^=u|#pt7;>y|hTO)(HU{=V65y0;1sE3Ef+zJ8 zA0J&oD|`N)s()*)H|)t+M_t&mRweo`;xXr0801&&Z*N)_b;7cA@&=1STDs!e#eG0$ zUnSc$0ZG=i+w|Z5+}MPdoJKViwBI&12tny_i>k>MY4QSyT#6>(xE~LEBuxHL1UQ^! z9ESJW)+HRa!7YAXpsD%;M**Ovyz2}ieeBqLW+$qrNQ^FKY~JL{B#asdd%KD?5r4yb z`&Fsr!U(4YYi97nRQxEr^kbRq8*D7jyrCGcO(sgf(|8SYK4NT<o@+UmzQu!5Yh@5W z!d4t&W(e|k2N>62EuW<iBAOhHq1+Pax&Z_W<U8HD@9%l<<O!_=#{PTP@_5v{-2cT4 z;`FCM{OD&o6G^G7Rf77$DgjF>8yz@LuB=`pPctikz*6r)1HIgyGn}T@d==q>-@<N8 zB&`J>Rv-HEH}3u;O$D>8Nu;bAP};Z5kyU>(TdXC&f2|bcIbuV0No;{zT`B>vUMM^W z><Prwv_3&pnh1I~UUqz7TDX$n>T+H(Sj|Tg=j~BKX@CKwVj^uL$<{gPu8`3wodW?T zv+onX*QrT}YLS?mf@byuhDLJnefW8_rF`#g6D6v-R;?^0e5-%Nyq;trR_r{%req}x ztV`__YqAQ*{V$qOQAkJ5{IzAgHaxcu_@x@k&ErM@+;Z`G6QdG28F7)hTupU*p|e+n z#{`BFc+7+i8DF7Pb7%X09ECXnr@^Me2uCxpLheD?3_~qTT}Uo_`z!Y7;1>EVq^XXd z0n!dw5e2`t(L-fSFg_v;)uyu5RTo&0GPrewb9lIY%Y85`@rL;GbLYX2mtFv|KT0AW zc-j@|H-1rwQ`}rnoqYr0Sb;A|97JavGMXCTx&ibv>Ex#3owwQ_QYM=q?<@2^vs!z* zmvaZ&>oO_KT0Sx_ym-5Zg;q?6Mmor+MRj#dei5Fm9Q38=@mV4FLid1nWY0Dc=YRz- zY4ExHV{xP&0sog}T=AyYxNgcrA0Z+!BVz<0+$^MTs(XOymWKI#?Wj+WfK_Q!p)rXE zwCfm_WcM;fPeXDpLOjBBZl;WJ#DV3l)mc{slJ*b{@3=1^cjz_$y++d-tmM*Jex^#5 zI0Mqh1eL!(iDeV0&vYlDbcqU-3K$%}K4hC?g$j1JaC!>78Q+V<_!1eLFZRx~KE7sL z7;*OM;I}+%l}=>a{ya>HiP&6*ZG{+HBK>Z6EDrs$&&4De)5T=bgUqo1gYg$va6`=6 z^YlM-YEY>w=T`RuZ=jWC%WzR;vT>umj32yq9|(K-BiSw#;%(r^Z~LLMF=IdU{!#-- zlk3X{xP3OnM<ExhC@uUQ|Gfcc>)~2zO(=V2rcUZ)&UP}iAU9y4y(sejiu0pxoqGBl z(bwX$dsf)oneQH*7ME#w%Xgnbd%q6m&m1$WWj|`~NyBb)JxptUKC@*I<@AV6EqjrW znYBfe-b-9wGUf8`>qnHjdc4AHV6^e(&Sn*CP0?X9AM>l%uJh*Onh0QRQ?a!^RN>6o zjSGkW^wPcjf(4_?`?`=8jKq@fHApj!t>pD;4g<t&oJEK3^%>f6Y59e}`e9R6%r_>R zxQ>9NJRfJ#r$?@+98eLUB$G5j_6M$e(uE*GP@_vYS?dp+;!`-vUoBu!HB(aDA}eff z%y&e*(N|mSVHG1PAC@LpH5SSZ&EIGTjeZkyg>Go<E`ET1rUQGdO1V7M?1}ih-c9>w zE$w~nPu)X?5gi))AvX$i`&mVj2Wp;t7{;?iphkm$xLn|9F|G;s(*OOt!b|d#OXClp zzlPk!?SeGh*WzrFis4sOe6HS)$W8OZyeM_9?@qV(I~5a!c2Mp>)$?~d{nOJkD1)u% z3*TF?9U793m5xR*zG3SmksbYkJGqV*GWKC=@3&LPfqH2sf_WKB&@;I|Tmp$XSlI`} zVhV4t9HOmh)H73*bVB`}R7i2U!?fK1Mk!KS*AwZSmtnsPlwT{hAcEz>0q~G=YG!uF zDbkj2us4nm_{fId($z%xE`cJIzNUvMHWYbdgdwOoTi&zkQ<=Uiy*bAiA9!Z3C!QI9 z?*NM=8WbmF4qEIISdXJSj>YGvNWv;Kh{dz!*(6o+E#~Fz$UIeP*OoKoOvjwxLCTDC z*NG`?g2CUWFf*o4rqIr-atv2kwZ5)fvLKEfGJO%p4QCs+0*v8*{&46-o`>wF7&A17 z#d&xZogAC|xik)_L`_JwWOquEFFaZ7k~rj+{^3;@mqb0Fz`E61goD($YxKE5VVWC3 z#WpPfjU+@`&XlBa-M4YWGPBVd0#>=M+_1L9gAdKJ$-j_ykYJLpU`+97<6`<!8d}&r zP(zo&kOU%XYv9hh#hc3#@ad;Pm*Y|#xBc`qJr*!pYCAmSgJRv`()E2?XYxLd1`oX& zlsuPdz3v@EZm(tZ$?tWYdksL9LX|R6Al8rJHGMYl^mJ>nucK5XkF=Z<d_{g)c0`ZS z9Nk?)sq`V1#&{n|!RrF6$ysIJalVWcYoWf=>xULEdahTpl&3GL`QXajgW;aL<iUZ_ zildHQ3p+ZW)UDO7k}B3S92xvNi?vX&-K0TzUklpE9+kuxE^TO~dmPiDzAK3B%YvM@ z+lJ|l$t@G2)nt9#CejQn)m<6McTAxE71NA8UdHx{7m(-?dtHWTZVB>ZTW>C#X<_Q< zynkPHlAOcLHwP4_s@Bx%TmdkoEie4Q7g0-!oa^(cJVwGq(JP26*<YGl@hPxsXnIsI z11q%AnjNK<2}+*~TIcrgsxR;vp@Vb*zDzu`W2Wsg(83J%@HCe8in$C3j#Lf2<fx(q zo|Vk@S`(xFPYGY{NBOhW(K^Ad73L@YZCFwg7Ioqh>prC2>u>?zR)FF{Yb*QKesM<< z`zmcTn%7o<EQ=#azot~m7xMUxV<$fRR`aQZz4)jO)gPlGo2(~-+0QHvMz$a_A!uR~ zf{QFMejA?kz)Z94-5WQp&Ln5g45-`dIJC*Cz8)#R_@FA^QC4!2!SC)n94fZ>>a6H3 zE-CKa317NqN_h$zB914qPQ3*<oQ<tr$K7mx5Jp)g9sU@7Cq+%W^Y&-WL7^!)thKM> zRsRDlcyF6o6+06#^NxKL>fsC&W<5%w=4;pG!<xB`4by4KV(|~Aiw*5Ldlk3lctG3J zwIVkCD3HaJD%t3~hoZ2lS)vieO4@N*#{fJ=#`rM-ayL9&c5J@zu|~I`wQ%@UbnyJ+ zk!;v{*V~r2>V~(9<XaKSHD0A)-)6Pfk1)&ynL#&>Z3pq=KX6)HUTy9syEFBh_mNns zoA;PcfsJk}RbSof^uP5asp7Y~3)l(KMZS?pZ#n}dhQ->ng=Qbl^c)$35`>-e4IQj6 zHb!640=Ge9t(BuK>hzP_4QnNh?A<AqF7vv>)${&uX}EfUgjDQO*!b~rouk|$7J^+v z%^8!WU&2@R=|s!JUz=8wvH1$<pGuRVpfv`QqbXse)8`{4?S|Wl+b1XZu9zH!xbUgt z3jsHIwk}~KDK>szP$Igy&Zb2VD$8$6#L!{6A1p>A>usI}Zb)756;GwwX5^4Xo7CNT zUo4cG&ONm7N{OYf#5|7!df|50VN^n|1-fXMWNE&DK^Dg$%6+2+*%I%x|16)mXt3HF zrFYVB9i6i4^X=_S^zx)*NSGtwXec)j?fyE*x9^#{G&s#quTOF>|3%~E4ny{&G4T6U zSw9swZulse;hUh9wYCx!D?HawMX(EH5oIB0dE#LLrU~OA<f>Y`t?qy^Vfo=JvKVP+ zy*4Q_>@z@oUyY>h^BfVsBdTW6kIFF}01H?mt^7N}&MyJT8&;l+fRvfr_!N0|Wotai z<ji0W55T(;$OhNmRrMws)_fNpA+h8jgs;?>w=7FVuxqsmY<JSCA(O7VdGXd=C!eRl zH@Z8OfJeb@u&={7DD}Yj$I$8p3TPRaGC6F`5Tp=SwkKxav}hbD5qxvjXlA~uggSdV zZ^)1J=m1q-%v#-sYVxQLSB}*1ML_L^JKj|qSeLd@_HGzcsUk$mEiVF&*m^IcEpu3D z*nz2JP7&seLY#6MEVt3)pk)ur%%uFFQH-AP6ZlmZWQK_Kbn>k2{)W*kCvt%r!N}W< zmDrYXo4}ye`MXsNxnqfO)v2{lWg(n5Eg*W9uJ44H@65fAU)OY>-M+c5q}<ZBA?^PR zxlc7@0uyDd`@LUzn@vgm2hL<{=(HH0f|IcO26tQag&b)&3hf4x^Zs|sQ{uBzWsy>r z;Yz{Q{65v?!N10>F%wwv+@2{yAZbzn;X7dqzv!E({D6P@=6DJugH{`gD31fIrTl#> zp@2j~>9!`Dk!e**VJcaB4qJn}tppxA&Rys0u+o=`WxANR&^LEDil6b1&kofmpDwC> zN7fU(Z$_;^eefYSIPg!pt7&r+YHWRicB~xw`)rK<r03(6ElcliCaqwF-J&BiM!VwC zoieMG@&_(sqa}+G=G*sc<q%XMJ?$aKPftL`DqdYSK7jQR>y(A$P^|vfzg3#r`t;DT z8d~n~w6<%^Ptozo{3A3Ts1#bTS^a7_dL9-_IKHrZoo{g2-`?+-eI}vcXGk3B6}Y7h zmIm;;=SB!0wzt>4L9)Ec0iUd1r{yZtSE~D)rV4xDe&4=d$p99W8iIwA{=o6HAv;3# zzp89G9_g+U3sEKhwKyMknoNu$&5QC%n)RhFCnoAIx8?}G-!OnHyOh`q&n`Jqyv7(C zN>EaqriZ~{H4#g084@gXwy;7dlm_qC=FbItLjoVR77WXFxkpFGn?jMyT#zF(+Zz~r zZjbs~0AChcz$wNkTTw!%j)uf1gVUGUdTxVt0o1bp5P_%l*gtR;;X4qKl%^iRE9txa zH0)JmtpH0w3Xg^W(f4i3XnY7N42JCn*-};`HgF6m&n^8zZBh%?yr^jGYUffbNki2= zh%>nTqbsr6l2#hCA-?t80IP|tV_ch@8^1d7b_$Ja`z{V;Gkmh&hiMkuV*2qo&D=s6 z&8Wyn0zcw1DJ$9+k0CtDxXGo4bQ)`YJ%Nz$NB^2DyoPyYOT4=-!Kgs`ZNX<9x516e z>J833NQRQXhRW^%kd{FEaDtR{3Rw6A$Z+hM!WRk|%^<+gJol(PkY`}W?pA$V3|tkG zOi|V2zj*E9JfNJO%iuiCU2o%o)|XvZ_&9=BO;4TSWra(mlRz#jF061fYZ@Z86-u_n zIpQNzoPFTJ7Hw}aBR8*zZ~g%O^|;gkSnk)%bTu8#sp(s8_)GYP5z+(2xE+>x8p*yk z1QvI9v!}ohs4rLEdG8zGqrK}*tq9DnQW(<S`@x0O+>B9toV8$2#`LcFfYY4j{ju=p zbs;pRut1I}MR=007Bu^+ENPP?pkp*IwEl2XX^IngWmcY~3d3Sh7FkLHl}nxYnfrLz zYm*(Y8qOzpL&iYA1PqUty_0HMwmz2UA-b-z>;a+A0I}sr2b>_pJei(3B0Km7zDzfi zQVC~B(}KQxiNDUsAGk^us>$?~5pvZfTk;v@(|!L`?;gzkoOcZ*#+joBip^}{Y=7IG zYJH<!JjlLb7y8D|cJ-Vd|4ZvI9F726bNsfsYO<C4_8{A4WiIj{KE<Tb(f4@jMS)2) zO{5C*Y(^R_&9H1=(=}Ibzj)sHXRy2A^0P2(2y{LyO`ej8q(PA7p~I_erAqep^SUGC z71P^}0os1PxgJ?p`RhvsS1lzyqxG}q9FS6<ZNT^;Zwz2eBtLprr+k7+nHbL^&uLJT zvc;6?F_kSoE3m<4T5(Q%$WQr<ZjNRelC|SFKATqJ+L3lUA8oA41a0gt;<wh{^s`!H z*-#BaJ?k*gWM|<xr&quA%S&BVNTum6r##Nntni}C$2+b-X9&Xo!1>S$GQ;xn^9-tN zFN69V-Y*w5i;_v@mF}>b9VbW(@feDa@4FBxnw@`lMN~+bV4AnbsPd};@@YgJ!ScYr zO!^cF+wOd=pEdcn2S9XMy$T@wuVA(kfmODTJ<zT1gpc;r$Ki`G1?iJATUL8Jp{?#% zlc6@M`y@>w?lMf3@AN;C5wpVdayCO`v0nZ&Uym6IQ=HvldUprG4u4R7zEAW{(Q<1r zjnq-ea<?)j#ru4ZrdhC{(ltb&;_dXKrik=_TqY<VUFfCuii8p&4L_s<^03OQ-5e`J zAl1E!slQ#0nG@o4lHxita~GsJBDd)ZR;JR-)%(<h4^x|fSjUNjc6Gak>tuI%6I5<k z%U#A|I9Hb0?NB-D9`y4<`Vfz~-&OPM{s3QGQXV(07n~=3<ch}DzNoS8mzX5My1131 zGK9u+$Zy=yH91#I5D52dto5PT6uXXEZe}E}B&WL-8BOQ&bem^7409})-g1&oOJE9Z zZwOBHuzdPGY_*kvZBxK`;l44XG_6J<s^kJl+zqYKWfhfoQ;0fh+6LqvWQ;Gd!&8}> zJh#ORpV->z__Dl>byH(-O=Pg+H@U0%vcakh!OOY91~qPY7C*z1#~lCF8JaCZ(;O}m z_G4-rk#l{Q8kc>kI4`gNR*O#Y6WOdf+FQGITGaj|a>O&gn|a0zo4}rdEzkRHV_`z! zwnel2P5AfHd`#S?rXH!w-?eutVII#bj||enFQ?O;j+wClhnLf5Fm?VPI6op+4vn$8 z7TB5VoqEet*I~yWxXk}veT`7shyGtW_JhOIevHMB|Dn=ePX>nvv#~#L8!bX)Og5{= z|8-;PizfWTvn8_rz+L}SkI{MB)9$}2S^isNd|)Xaw|0Z8Gl7tA>p!tD>7jdmf;WME zhR^v)zxfT<lt?#Y!<&D2JODj?nWaQ&R?yUguoY+A=4mfL|JMd;c~aj1X(%N&5hLjQ zigR%D1HdWLp5Oj>Q=RM;poq^GtG&-27Fl7wCdZD=a9<_QcZ}9_-2MlS%q>b+qr4s` z4@%e6q1wF5$tHnE-=S!%!jzpM&tQ4WGpT817wJf3$LWM3wCl0;=5Kp~8!dT@-zrHC z6$OJ9XO7E`3&A2AN^|q**~<-YHDCn)OS_Cf6new=-G7AM&Sm}1BYK!{1-~BJ|8!Z0 zuZWsSVs<<mR8?mJ0dcGD+v#j7G5{L{siM?h#8VR{krZRSfBAk?nzil0FKl!FJ*E;f zTgiw0v@)=$WPni1t{jRx_k8A%!tA^r&CA|47t}zJoYQP;lTo;tV}#6Bp&6KZMvr+x zwXreq+WKU}I8DWf=2VDa>->Fk+u4M+V#*wm%f^Mvlk?(U7w^$)wk*!&U>8IV^+Gx& zEajHj=i$F~VgHy5<9;)K7-C{EEjvtwR4RN~r?n}s?HikZdHSd4tmuK$Z)^PHEjMu7 z*_{~dj4tHqYAxOX`p*o1QvYQyqyLR%+?vR=<d7~beFW9*rnQT+_gQCQON4A8x+b!^ z_fQVzG1+?eIl8mj1(n8%On<!SO<|0|ofV%Dk4Rb4=!#t5<og;fKS?$j1(jXtm1HS^ zmZzB+`|fMlt=TS;)UO3wB>khi13Vg4JZ<|{M||IWSI2}S<fkexev7{ir0u#n3~g}Z z&d>jkraaEy`j-PW5hAwQGgM<7SJ+hj<ZFmFLMpV8eEXlxwr2h2;_77R(PKv^xa?f@ zMGvMP!n2QbhZxw>kDr0`0fSi>y6ZIdynQ3%WMtf}pDC<WFl>-<;Ti#!iXSyx0SZ8k z(=vc7%8*4JR^5()xBw0+ZJvNJ9!<RqrKV?dTxkdh`DB>vX|K_-rfNK%CO+4Y0gc;z zK=!ktWJ*`Gkb*vuUZ#<M<j1DO=Gfv`q(@q>-fz&6!Di+&)D*s8g7omF27=)n>pT@5 zKDRUxVi!l3cV5WY6u|lm4i=8e8JEpZ=?L>yO+N}`H0B2h-}SXM5PmMeAPH=Oj4zDG zI{>?Zw>wQ~1Cc}Ot?%uesuD%LL!2oLe$Y96u$)Pj`wYJfhXhgdS7J_bH7n;+B)`20 z7ObP#qQ#=ppvPDns0S-vv~kgKDRSXUnKckm=D%JaEK3Tjr`70Z`~1bLw{RCPx7`K} z-MIBOyYGxNo+Qvd*9)D5f0Sx)v{OB57abv85v0pmTx)uJbZ_)(9|8cZvRZMn4N<-q zrn`I42Sgp}?)e<yThT%D?|A9}Znz8Cqj@^yBx_#5?u6*BG)4FA+Y(k|3Pz}EJuIGq zo)z&{o2G(wuh!mR|AD(=ef}415!TiJWiZioS<2wRp3-AzH02gRL+uQmptXBk90{|| ze-G1%!Hm;JWC?*4IksV0fED$?G&WZ*oLSr9qfJr{0@G^4SyBSV8{=}r-7CT=p*k<o zmJ6(o@+5v?R?d7!Ve&<{3Z-%A*hks^e*fRYQ|*jbaCH^$d|tnqI2@<0K#M{C;&c)N z1WVqyBar{n9udXl?uL6nV<KdWg-Yr-O)%M-iI)9=6H5}epgS_(8{XI7*sBDB$2P=! z&Y}!4_Kx8cMr0TI8l#mHgA(6RHVekW_>hjj#J;;G3F9yfHnP*KSF19M<m6U;!ALRW z6EXQmS&UU9VLLmFihHswKafB8=OtNM7%T!J!KqQedfYpa<;P-{=n)c+kFA0}@jY6K zD8a@4ad}GHxgdqtT({&zo}l$7goF^OaNX~eS=)Z}y*ER-Zl^ltFSNDTQY6jZfp^Z= zY+H9*PHSrE6M@THbR|0B@H$qdx{wr~td+bE0~HlkA4ChqHMz)ztBp1gJIqw$@qa^+ zjE)m|F3F74uwOQ~FUtScpTku032WOXFKB<!laZNEgiF$zzH>`v{6E(;o?(7L{|{U& zv|o*qludZpwbqdYE|Pu-HsN)5aI3`;!W~VhTi|n<5!%(kMR1GawGZf!`U4jZ;|h_A zw5jbYyc1c%qG_96l)DkdfzQvpYSSO&6Km*A9MIIb_E)!9#;|lU>>YgUbT*t>z=6DO z%*yFf&XLHpNxiF+r$OBt{X;EGn@%l#4;?jhF7`@nZt4>2Ndk)Lj<i9NR#b$OZ%`~T z#6Q#N_1<BwU`bw|+npj8h;yq8tS51iG@k$}vu2f}<sQla6^X94*50r&D0E8q&@;9- zepBN(dX0#o;H`FJKXXO^|Eo@34vgxs1#LCo)DHwRZqmI^Gv&(q%X-J5lZ&$B28bZ% zJ8pU+_=^xHh`6foS!um^sA4-Wj^Ld))hxU@4L&1}9^qHUVw1=>Af9xVQ06*{$0L4i zJr!_D7-?@fs2)9nj5clCo$kNutc9zEhZh+)yKoM)BV@RD4IB{w<EPtBWrR5Gjo2tj zoVyWl#?l^mgf)qXGL28gb21Cu7_~#z^~mKBK<A6z!zmu}`EJWO9b-axUO0wPgQkJ! zf{|aQ<%={dTfr>C@uNio1EwO#K3M%D@l*9q_o6Uc%o25Sa*gF*MqGxWliSpmDP}h< zS|^OOOVL*MO<k)*)k!mtd}v>zhcZbJPf7?Md%Quac%j>YR{tROKSBYXGH&Tge4DJ` z{`&9`gN_Q>AOv$#7XUT3QWSp}ef-9l=UB}4yA_WA>31I$!7vNP!hmH1SLHd<)!M!6 z-!1qYk}ZPc_pyZdN-{hO=ArV;d%qoXV><Fm>A<+Y=f@Ik!ceX<b%dSXf-)};sFT-S z<aj*X4j1v<-JJwKodufyeGA^~RGz~#K+^1IvyDT@Trb_3Gu{x_F2-g;{|4Bx-+<Z3 z>U^I%dCSH0;<}dHbg+3hV6O^hg<*+prZd$Kj8pP79L6eF5|uV)x8Sy{>eui21eCw8 zgLUl)8owQwbLV<Nfr(_zQ*m1vQ}7VM2Y6bUj!8O=A1v(Rg}vVbYb4<S<bv=FkG1De zeN{G#;R%xHmHPJ=mC^}wf4!_1_P@+W1)!GA>%^5DLdn>qa6;G&xc@M$(&L)nZgZ(% z#b~)Gd9hlS<&TWZ@$M~TMG?0_@W(#&$X`ZkZi5(y+5AI>jih5N?UC!F^9o1sV~gvY zffTdlylQdX+3?@bdD83dQ9H<knBQI2SEn=CWPB`SlTf+6sD<yntki5#={{mE-~QLF z#^u)a8>|O;oZT(<JFB~zV)(e?b=V|-H}tp7eIqOen;i!phK2eH0SN|R3J(v<WD5t6 z3rEW<tAk_Z^@BzmhJtzpgF)qy*|YpRV=e4vX<G019I{!NK7ZiWV=pH04Bv>jRuj<* zBfsru2`Lg$v-E8kFM)54#6;|NU}9d7rPK3@Q4ceSp;TN!L}W;VpJ)FvV?4kpq^-zh z4~Sr+Dl&x9`!#-aVX=sA*56Et)(~N(l>h}RzFA&GA{^GrH@F>RE(g>m(2J7_F>o~7 zM`-8^el8UK5lbq-^=dC9c#!~>fD>=W7jfO236WUhBSo0F_sCYBl{NlzbJ|LNCSA$P z8GH-Lw;Yd4y#jKf99NmyHUjIQJC%MRw%hMKw?L{^kNuUJuVf+c=mzS`LWO1*cv>Y# zc`_P1u_IsP3V@o@W;5k}eIf8-2I_y{=GNwFxkVD%4lE-~CM!6vhVsOEajlnf_{Qpq zzb%1zw#j*&Nof6KH;V?!L+!ihUUTn5@;ZR0Nx4k7l1EgBbaVan0)pAeF|<dlb<1Cz z$!Koi%L&Bh`>a(aw?-5_Y{{F|*jz~+;|5pM>R`Fq-AfRcXkG~opQs_<$}XV{U)PX- zT#GB8srXq7<d?OCDem*)H`Ncy+gY?|Am!|=6t4QJ3Vs3u(^?tb2O1SqaYY;Pxa_YE z@hZjcKVu{))5<do-ZD@cj>x`4=pBS}OLl&dl()o=6^n?JGOWAS{sZ^Dhlwf6X|^F^ zT*%ywVsL=YNQfv!U!0;9t=W<Pp+<F#JrT*MpG~$i@8PQyn+2MqydEPzA)1nUy0yIY zP1oyLT_cMZdIMSK@db3(2kq0DT$1iCs%;n0#p?e*{GWdXPAb8S^2mG<+NPV%vTxJB zwM(J&yam-Tjq}-YS*8%#p?LFAL*$YM1zdQP1zGSfz}r))Vk<8%Cse~<U<=~9#bK4U z=GLQ0d-?@4m)6KnM4wgNEJ1HAvyo2WUw7+F<PFJC8abO<M$^G%5cj<TC#u}gVObe( z;&+d&6C|N<B&#uEnh)W*%y!e=<k4w-zOCZbkEHuR(lYG=paHAk$mH7@=|#x$o8<$7 zejG=Uu++f>Un2vb5BbY4aRsA@>_=FbaG4S6`r_I1T(@8Ze9b5%R21upq8K(FP&fN| z@evWzb8y?{uQEL2pN-AZnRm+9pT=K|pwyGAQfY3jZ#5-*MVWfSZVTcD@$%(4o(!YZ zp>`#OgxE+#(C=+?NYYQ_hhb{Nf#^Jy?P_s0jGC?SiMDz0@TyJDkk0tMstS2llh$@~ z_Yx4AlA5d@7-R|8SL>382B2-Hz(Tcj*S6t`C!|o42}*bDly!#3ZzhOJ)>a{^hQk>n zM?!TyXQS8l#&~5#)W`Sb@=Q?4BhfwsuK}WyTF+I_+C*oLx_GzYyj|s(0Zzk>8Z>N4 zE2S`AUCGx@8JNp$T8v>9fKb(cbJD;d%x>mDBpr^3MT$kjP0Jf3swWRWwX|O)CM2OJ zLEHbfaQd@GR4nyKO-xlKky$|cDiy&WUytDpBdgB0_-YZc)C*yZJKU4;qHyqs$$u}9 z*&cn-<^MsMKXgWukt{dqfxFBeaOYGqAmlnQ;deYvu#2>L>n}T{p!)M&BgBXUZjs{j zpK||N_tS{pzLx8n^m)m<?7Z*`#q`c-96WBCm&GRHmK#}>o|*#^a!g>KkmN_%OoadH z;fqnr`v1+Q<6ZXOZ0VkBTm{|U-=<(Lk^g?UmS#@9`vdn0F;%Wkv!`|~0->7X3@G+l z<D2kt(`$Y#>7z}z_P=(kQkp!N<tR74R+h@1{S~uA96(;IP<n{^DW^MpEd3dlm3%)z zd#VUT;AX6fxN>Acc9>rv?Ll0D!kA8Kl@-aEodbrmpU}``pe$1_YEvh92X#Sg`G9d4 znw}LMlv)#CVr(re#8ATBM<R=7^?*vP_MXAu91OHtY%Dd3Q^@LINw!kT;!|JHEz)hV z!ProP!;x~a;4_JqeSfCeH49S&*ALpfrQGWDmObB!Pe4CMH@jEhgg6h-qMk)8Gn$I{ z;o#?G3S;cF+mzk)*?p5wJotFmX1r`wh-ZjyW?eBT`xYLSMU1mrkNPtzDMy>C0cm!L zhhR*v@d6{Y7_)vQ9$F^p{hidZr-9g(3PYDUNXJCB2eI1Yxh;-WXNZm%*H(u#1T*VS zQ5;f$ij;*Pu9hSVk`=XtC3K}K;gq+_WX>Z~q=9F*WF79Mpw}JjRUBm_U%ppzszUq` zlbd^VFgD=O9hZwy-uGs2)+a)+7*2;Q#YVt<K}$w+0}r3KX3S$G3nM&+tAHFw1YULE zEm7<dWm-IbL`3zv`<wTGq@o+@HH;-zWF#2;VETJ{UM4Y17R4;TIV6>)YzFzNN$~3u zTFUBM-B(C7irLKEXbI!eTp0HYS=MWH8%pox;P~kBl$X`cil{r1>pm9bc~kjs6htnf zp%P7J^D|P6>t{!~wlBR^wjJf>5gmQ2)oP?F#7N?ld8)tR1D61mv;iAFLgknMv|1Rs zEF2sSZf#f;ANG>mqZZ5YQIHbIK6REebQ0U+xM}fx=#|NUd*zZ?AS@2u2+n)<o7o1| zqccxi?hYv1xfw&qjhq=~%wCmmMdOj+$APP!c)G+{iO5ttWulrbKi`+vq05GBH)L3d z$>M!7a}J=)4@9y((TR9V)Y<YbWQhq66<(gBkF#Dw4h#|*b8^f|NA2V#>JV02R$)pM z8ERedHEu>l$cs=!qa=`1cc*(lLx8c;m&grKlT=`^r&sNx2X^>4o+(Fn!qw-ND>HI% ztk^hw`vNws<dq}l&lq6gn>y2}JM73y1JDiUWhMTBOQt0yG&3iu%azIR)bc}>W3(=p zB9L(-3lkhe`IL;ODym)MHGvx_P|G1OxIh88=Xdg^+o%22rogA@inkJM=!}8TTpw!Y zCBx$l@2T1iRLZai;Ccs(>Edx<29CYeX2n|hsCUka80kHs|D>q)wIgOR%&2^d;p=wS zxgN_f#AQ9)_nZNMGBZ$0RNJC#ecQeoa_{B)C6<j3#fFiNCMb#9{vZsq>FIUEK`^cn zw+@k}7_=&9$Ji)CTvsrT)=eO;q}S(#WgjsE=e<)0d2W#C;$aKErSA@lNK0b*6GR{Z z8x|*6Sid*%xlTTM99Y&yCCzq;PD{&?mXDy{LWII;(@az;xe-CQK$TzsQU3{VNdxMm zo#@?{n;;^7OO=ch4ato=qF|4JsNrOL{TRyr+y%Z+uIew818ON*It{^SP&4{RpFBA5 zCw2=yvP{+Y-_)xZR6#EY3vCT0c*S3)a6zmFHpRbjHeFT0L=XKbBu2SSBl2&H;f^!x za=smmy%-P2$hNIYiU<@!JQbS%z{PMCpJ09-v3_ueoxk}ha~q2?rG;X=JZkUK_6IIu z8Q~|^Q@F?Dp~)@V;bvZ8pd#YBrY-7s!*~ZJ>b%b!!yo#O5aHCm8j_;Mw`aNieECR3 zTpbua+)}#q1gC&)@_72cQevJ~e*G_$^k;FbOKMo=un0XEPN$T^g(0GN-97h6&16~W zmWwJxEW<$DhfyZQ=ePdngB+Jjzqtw8J)Vkr_Df$G)mg$F>J9C;h~XJilJRV><m(jK z>4W<P2+*5Sco}=k>cEG9Up22G4o}|q*Zqy!c0mR+GQ|e5NeL<5^DR`QSRYBOwO~Nh z(>WrHc=01GDj-@u2?l>-tFLbmjPOmbx~lO{n||a}W0;VpAXK0ecijxgutdg&k*g6( z%yLws!kLsLIQn`uZ<&rs|2P-#4R3$1kn1YMjO;4u?HUHk&AKe@<9x-ks2Jv$+^UT} z;0;-*WsA|N3TphS_l|RvqxnKW9SNy)j~ya)#Q*9VN%%+C+j$jxayGefff9Rts2^z= zJsSu_BTqDY%gl?Q7hQjIz(?o0Bl-1aoRLtFYe<b{>T}a$_$WbQcY<X?KDtt>wxY89 zx{K~efZj_`An%|%4F|=AT+_=ViyGvcDxj(SHN6kdP7`wT591X{eI`0nIK!`bJ;?Hw z@vAe=1ac+OQ!E@7a(Tw3j8UbGyC2(1;;Kxu%1|OV=3>cSUcn8#HoTf;Nh1;8^W*X6 zS48(~!ebklsBHRCdg`G&wq`)tm2H-<u&e{%LpL&sduy82M^`|s^Df)+`ba7JLk6E0 zby-E7HdxJ`Oc9Ac%LtUr@$kWXaemaG!rr&EVm;6V7{Z~w!Th6IrOA3DKX0?JX26dG z)gPNnA8jNvdOiSI4Gk<2*ZiNDd&{u6mL+U-(BQ${-QC?`a0u@1E<q9!+;wo53>F}` z1qn7d!3n{FOYk7U^G){7*~hZKd+wk6++jUKPj{{Ax2mnWR(CIag=z&Mw0;t!%`Rq| zx5}{4*PISH$_~fw^gPSLs9F&rndK;Vs*QS)mU)ywS|{XPCb|%!v&gqE)7@L|!?bJ_ z<Owg~++-l@(SSRXVy``w*|_R1GT$ki31>0=V59{?tntb*Nw{<y??(y49)j+^VqfN} z4uK=T1jsHtpQjvgZhUE-X$Z?PA3a3iGqkrvw7%f$2Ynv|p8ke=PCR>jk`%O=G1oOI zB=@8HPp%F1(ee0vUM*}C!Rjw*C!Ug>Tz~@|s2Zro1z>|peYu&u&=yNd8i;t%mJkfv zWNZ9?0C-T)<xBc5)pz0;MX0;-9;c-d<|WRdXXP3O1s!0Ssl9gEpEwE>dZ;OrXu8<F z3bpiR`Ea0A*QtYzu&f2Ew}3Y~3|%#ZXo}neE+RIh)o$N0ztI*k#D^Y9(3`=+s<V;u zZQ8q-lXWz{j`$g^1sof^{=Pb61hVR4Zg$&?An;DVAP2`Jrm~)IHNT`au+!+;^&1t! zfg;kiq;q_BzP#VZ1wbXGH!Q5@<*wrAX<8c1`{$UslFEu>@=*&^$#ZWI0lDyFSm8I* zik}b_d2B!1R{8KG7aeIFtif7Ddy%%PJUycn^r^PwRojF$b)n%RrZJCD(2by`l;^h` z2y{5gR|3ER@KIVudti0nJ$5`zJ>D+m{$9@a)g{14NL8HarD(b}C_u9>i1#_y{ac_F zk-Ha0o*ET*Ejf8=Tuhsx*^?k05Uhj25LHeGjPWNQ2hbE@sWdz{Rt)?_){7jp0NuyF z@B<E`>`5~rE$5O6IU-sbF3%*3eJv_krA4&hgTC71O)>6fX1obmGs6IXxW22KUczT3 zfpdX#K)wMPT~1i%WznxhNCpRCpS4<P?DOBe;cc^IZ~CtD^ADGwX?B*IDEazb*=n`c z_H~8p-E2$X9#s=#x8m|Rf>X1NTaRDa&>Jt}lEqji<}v{-;aL*%O=Btb_vKoOk`HBX zi)%x{^IsD;qIgpx{0rn1n^c7<suf70vL?N?QwYD87btP#ceQBd(QCWPrA-gt*0h!n ziB8K-RE?Y3AL{$SqeKm{V-t-vaj1m0`3_@&m}&){tJrLFUKA$`G3e&Jn2AMGtDKup z-@zemELF#c?wn2o+gS+XOe+zuA);rIE&|@@uzyY%8G9D(-JEFHF||<p6$uY3$(WWW z%K-&(z!2BdGEbONL+^<S<hk8(JH|1KqZ~o`T1$NkWy(_I(Rtj5-Sb?L=0S|jocJsE z^_U&83VFpJ01{Rv>#a-1&V|A>Yd+#}*I;aW&oji2hnOd@S`^Rf%X*!6=kbZ$9?2qo zv0yC;NN`%1$%IFc&y|gsH)uzpr7&PhS%_@HI3v^+i6>YB8!~FXG#}ekkNic6hBf{4 z<u1liU0>_Y<~c<MTA=+37yYW%09&sVEBFdbH=V<SG$jgW@gZx;NfW;~LmO6=RFu@n z+;PSTS%>y$4dAKdBMft*>vzB!&2H2qPAB6Kov%bqEjPzt^ct29w04_NR5@UF-i$mB z_4v>|CtK#|e^cA^iXt{6^d~UEHh#-@;TQEBN;87ySjahDX)cC7W6D=8HIci5zAg!5 zg8~$p_pOptyA@9jwc=%{Kr&ihT2GPn_ydPmi;4DgzdV171z?9@)i&^COMlK_jKATL z8NSx!&L!P7%$N$*RrZ#>0H<t46Y3M|+{ZZ4uk4u*8Kk*2**f=FktVS+%WgHm(|*-p zw%?|=HdGv!GNLd)0a2xMXq3;5M%osHllEM9#}S+0fheS<<}Hy|tIyr*2-9ks*)&;u z(s`+^yLbyv29_d%HtweBbyHO6x-R{upZgprvoc@;2`b~8mW?TChlrmYAAi*dGZCJ) za&(|9(4GdanHr2_uV#$RYbWX&Lf`_h+AlcD08sVd22~M?O0<0BK8tYJ3VOi{pJ{+1 zOt=l?AO&2osl{$-jTQ|4n`%^Ij*t}yt>1Bn7#&FFboV1ti$N+4u)9uB4@>lTU_C>g za#xeovzFTlH;D!^BbCyhrFSYt+XFIk^btSSz;JKPn(||v#UeX?S2+p;il<31rORL@ z8Bzx;E-4GrZF$a`Q^Ua^dW9Fc!eOKT09a<@`}Ww!ZjV#3PgG^n9I3?4$|NT{%ZY@b zP!@3plW57q!o`hKH<vFT0s~ldpW+E}b^~{xH8>|lZOIRhylbmOFN%w`Wb!}>3S=9v zm{U@ki;dtHIi1H;vX};^4t0<`Uh#?M>E6$cPX4qHpqlsrDER1pyhJLJ;L1e;<G4G? z`QiH&*{a0SE|Fhj?j*r{Xrr*!N?yP;F8XxDAZLXluS!qGTvLaHP+z;V`>{}Kl6<Nl z&~nr(TMBce>*lW1tUhSjXkrI!9g}oh&5IC>c}ckEjy%`?RI|Q>^egwZB(+X<bZAVs z`7w2|)u*^t*|yRW&2j;fL75;1AFjvsbCo@%SKr{__lhO4kI8!b%I*UrePPwKVYD{f zuO-}aZ8k{TGLR#g-Lu?7`06{k#K12If_fxv^1n*?CvD?`+popFBA+j;FMD~=3fqC; zV}@P6PR@D}o?wmGV{s>Q4-+WC7z*;JFy|Q(JYUQj<`MshNmy)LOTknKQ9?4O%v3qh z0Jrqd>ufS<6-sB8bna_3weV!Ae4PoR(RrnZj(Hf-a^QTat(A(@j-GgZhjC2Q5fUnx z?^CHO6leM7VqX!1Zn~jThV&=a9{`Em^_6BpU(#h4hjXlWmU`xO9_Ujji<Q3Jv__<K z2zOF2NIxQtJVb@q{h`YvBlc|;NG#Pt1J}f*NP~Gi6%I2_tB6`wP73XIT88}TKbXC; z`nFadG)9lYSYuxbL5{&U6zJX%SVrL_{v0%NQp<a~0+^zdCau+EI9%R^q;xE%HE=Wg z8xEYwC}tT6hL{$X^tjaWcJ%SsXUzl$nP=o;_lCdZe>fK;7@Ny2A`G!kjTOjF>qrX( zfxi{mym^U16WCoim;$%Z_)OWk)o8;Ua~E&Uc?6r1qtoO>5}lDSka*^*ho4d9b(zIV zcO@1*ZgaIZp`c1?jIPP*9}P}=z8K(Rn0`1L^l@Sw{lR!Gr?g#n<`H|rg7QF_`JZKW zlQ<gYbuKyEsFMQPD{%xZC|x%ktIhGB2c6k1#D6`Glt)A9ZZesY?pmM15|-nA)I#Zd zYnUQvT}Yl{05<Me+v+s@jKZ7x74b1)BRA}j2dAisB47ZL-anS&r0w8Cm>*m5+E5K= zz>G1S04w_!|5>�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 MuSYu!_&xW301&<VOaK4? literal 0 HcmV?d00001 diff --git a/resources/images/scala3-contribution/toolbar.jpg b/resources/images/scala3-contribution/toolbar.jpg new file mode 100644 index 0000000000000000000000000000000000000000..22ae60ba27e1d3db5aa9711d03014fe9a08dfde3 GIT binary patch literal 111169 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�tM1cF3_<_~>S~x|2va0z3ih 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 GuKzz@9W{gi literal 0 HcmV?d00001 From 3fc5bd9b56207f3b449d6dc1dd9d76ae3c477f27 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Mon, 27 Mar 2023 17:04:12 +0200 Subject: [PATCH 2540/3075] update JDK compat page now that JDK 20 is GA --- _overviews/jdk-compatibility/overview.md | 30 +++++++++++++++++------- 1 file changed, 22 insertions(+), 8 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 5401ca2210..8cb312c2f0 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,7 +12,7 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | JDK version | Minimum Scala versions | |:-----------:|:-------------------------------------------------------------| -| 20 (ea) | 3.3.0 (forthcoming), 2.13.11 (forthcoming), 2.12.18 (forthcoming) | +| 20 | 3.3.0 (soon), 2.13.11 (soon), 2.12.18 (soon) | | 19 | 3.2.0, 2.13.9, 2.12.16 | | 18 | 3.1.3, 2.13.7, 2.12.15 | | 17 (LTS) | 3.0.0, 2.13.6, 2.12.15 | @@ -29,21 +29,21 @@ Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platfo ## Running versus compiling -JDK 8, 11, and 17 are all reasonable choices both for *compiling* and *running* Scala code. +JDK 8, 11, 17, and 20 are all reasonable choices both for *compiling* and *running* Scala code. Since the JVM is normally backwards compatible, it is usually safe to use a newer JVM for *running* your code than the one it was compiled on, especially if you are not using JVM features designated "experimental" or "unsafe". -JDK 8 remains in use at many shops (as of early 2022), but usage is declining and some projects are dropping support. If you compile on JDK 11+ but want to allow your users to stay on 8, additional care is needed to avoid using APIs and features that don't exist in 8. (For this reason, some Scala developers use JDK 11 or 17 for their daily work but do release builds on JDK 8.) +JDK 8 remains in use at some shops (as of early 2023), but usage is declining and some projects are dropping support. If you compile on JDK 11+ but want to allow your users to stay on 8, additional care is needed to avoid using APIs and features that don't exist in 8. (For this reason, some Scala developers use a newer JDK for their daily work but do release builds on JDK 8.) ## Long Term Support (LTS) versions After Java 8, Oracle introduced the concept of LTS versions of the JDK. These versions will remain supported (by Oracle, and likely by the rest of the ecosystem, including Scala) for longer than the versions in between. See <https://www.oracle.com/technetwork/java/eol-135779.html>. -JDK 8, 11, and 17 are LTS versions. +JDK 8, 11, and 17 are LTS versions. (The next LTS version will be 21.) Scala provides experimental support for running the Scala compiler on non-LTS versions of the JDK. The current LTS versions are normally tested in our CI matrix and by the Scala community build. We may also test non-LTS versions, but any issues found there are considered lower priority, and will not be considered release blockers. (Lightbend may be able to offer faster resolution of issues like this under commercial support.) -As already mentioned, Scala code compiled on JDK 8 should run without problems in later JVMs. We will give higher priority to bugs that break this property. (For example, later in the 2.13.x series we hope to provide support for JPMS module access checks, to ensure your code won't incur `LinkageErrors` due to module access violations.) +As already mentioned, Scala code compiled on JDK 8 should run without problems in later JVMs. We will give higher priority to bugs that break this property. (For example, in 2.13.x we might eventually provide support for JPMS module access checks, to ensure your code won't incur `LinkageErrors` due to module access violations.) ## JDK vendors and distributions @@ -72,7 +72,7 @@ To track progress on JDK 11 related issues in Scala, watch: JDK 17 is an LTS release. -Scala 2.13.6 and 2.12.15 support JDK 17. +Scala 2.13.6+ and 2.12.15+ support JDK 17. The Scala test suite and Scala community build are green on JDK 17. @@ -94,11 +94,25 @@ Support for JDK 19 was included in Scala 2.13.9 and 2.12.16. ## JDK 20 compatibility notes -Early access builds of JDK 20, a non-LTS release, are already available. +JDK 20, a non-LTS release, came out in March 2023. + +Support for JDK 20 has already been merged and is available in +[nightly builds](https://stackoverflow.com/questions/40622878/how-do-i-tell-sbt-or-scala-cli-to-use-a-nightly-build-of-scala-2-12-or-2-13) +of Scala 2.12, 2.13, and 3. + +The support will be included in forthcoming Scala releases: 2.12.18, +2.13.11, and 3.3.0. We hope to release these in April 2023, or not +long after. + +<!-- +## JDK 21 compatibility notes + +Early access builds of JDK 21, a non-LTS release, are already available. Initial support for JDK 20 has been merged and is already available in nightly builds of Scala 2.12, 2.13, and 3. (The support will be -included in forthcoming Scala releases: 2.12.18, 2.13.11, and 3.3.0.) +included in forthcoming Scala releases: 2.12.19, 2.13.12, and 3.3.1.) +--> ## GraalVM Native Image compatibility notes From 20318c92903079881539e9ea4737d25fa55c26c9 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Thu, 30 Mar 2023 20:16:02 +0800 Subject: [PATCH 2541/3075] add code tabs in _zh-cn/overviews/scala3-book/methods-most.md (#2735) --- _overviews/scala3-book/methods-most.md | 1 + _zh-cn/overviews/scala3-book/methods-most.md | 324 ++++++++++++++++++- 2 files changed, 317 insertions(+), 8 deletions(-) diff --git a/_overviews/scala3-book/methods-most.md b/_overviews/scala3-book/methods-most.md index a1d17c318e..1cadaf3ebe 100644 --- a/_overviews/scala3-book/methods-most.md +++ b/_overviews/scala3-book/methods-most.md @@ -469,6 +469,7 @@ This makes them private to the current class, so they can’t be called nor over {% tabs method_20 class=tabs-scala-version %} {% tab 'Scala 2' for=method_20 %} + ```scala class Animal { private def breathe() = println("I’m breathing") diff --git a/_zh-cn/overviews/scala3-book/methods-most.md b/_zh-cn/overviews/scala3-book/methods-most.md index b1aa18a6fc..08991419b5 100644 --- a/_zh-cn/overviews/scala3-book/methods-most.md +++ b/_zh-cn/overviews/scala3-book/methods-most.md @@ -29,6 +29,19 @@ Scala 方法有很多特性，包括： 本节演示了其中一些功能，但是当您定义一个不使用这些功能的“简单”方法时，语法如下所示： +{% tabs method_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_1 %} + +```scala +def methodName(param1: Type1, param2: Type2): ReturnType = { + // the method body + // goes here +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_1 %} + ```scala def methodName(param1: Type1, param2: Type2): ReturnType = // the method body @@ -36,6 +49,9 @@ def methodName(param1: Type1, param2: Type2): ReturnType = end methodName // this is optional ``` +{% endtab %} +{% endtabs %} + 在该语法中： - 关键字 `def` 用于定义方法 @@ -48,11 +64,17 @@ end methodName // this is optional 下面是一个名为 `add` 的单行方法的两个示例，它接受两个 `Int` 输入参数。 第一个版本明确显示方法的 `Int` 返回类型，第二个版本没有： +{% tabs method_2 %} +{% tab 'Scala 2 and 3' for=method_2 %} + ```scala def add(a: Int, b: Int): Int = a + b def add(a: Int, b: Int) = a + b ``` +{% endtab %} +{% endtabs %} + 建议使用返回类型注释公开可见的方法。 声明返回类型可以让您在几个月或几年后查看它或查看其他人的代码时更容易理解它。 @@ -60,13 +82,22 @@ def add(a: Int, b: Int) = a + b 调用方法很简单： +{% tabs method_3 %} +{% tab 'Scala 2 and 3' for=method_3 %} + ```scala val x = add(1, 2) // 3 ``` +{% endtab %} +{% endtabs %} + Scala 集合类有几十个内置方法。 这些示例显示了如何调用它们： +{% tabs method_4 %} +{% tab 'Scala 2 and 3' for=method_4 %} + ```scala val x = List(1, 2, 3) @@ -75,16 +106,33 @@ x.contains(1) // true x.map(_ * 10) // List(10, 20, 30) ``` +{% endtab %} +{% endtabs %} + 注意： - `size` 不带参数，并返回列表中元素的数量 - `contains` 方法接受一个参数，即要搜索的值 -- `map` 接受一个参数，一个函数；在这种情况下，一个匿名函数被传递给它 +- `map` 接受一个函数参数；在上述情况下，传递给它的是一个匿名函数 ## 多行方法 当方法超过一行时，从第二行开始方法体，向右缩进： +{% tabs method_5 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_5 %} + +```scala +def addThenDouble(a: Int, b: Int): Int = { + // imagine that this body requires multiple lines + val sum = a + b + sum * 2 +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_5 %} + ```scala def addThenDouble(a: Int, b: Int): Int = // imagine that this body requires multiple lines @@ -92,6 +140,9 @@ def addThenDouble(a: Int, b: Int): Int = sum * 2 ``` +{% endtab %} +{% endtabs %} + 在那个方法中： - `sum` 是一个不可变的局部变量；它不能在方法之外访问 @@ -99,20 +150,32 @@ def addThenDouble(a: Int, b: Int): Int = 当您将该代码粘贴到 REPL 中时，您会看到它按预期工作： +{% tabs method_6 %} +{% tab 'Scala 2 and 3' for=method_6 %} + ```scala scala> addThenDouble(1, 1) res0: Int = 4 ``` +{% endtab %} +{% endtabs %} + 请注意，方法末尾不需要 `return` 语句。 因为在 Scala 中几乎所有的东西都是一个_表达式_——意味着每一行代码都返回（或_执行_）一个值——不需要使用 `return`。 当您压缩该方法并将其写在一行上时，这一点变得更加清晰： +{% tabs method_7 %} +{% tab 'Scala 2 and 3' for=method_7 %} + ```scala def addThenDouble(a: Int, b: Int): Int = (a + b) * 2 ``` +{% endtab %} +{% endtabs %} + 方法的主体可以使用语言的所有不同特性： - `if`/`else` 表达式 @@ -125,6 +188,20 @@ def addThenDouble(a: Int, b: Int): Int = (a + b) * 2 作为一个真实世界的多行方法的例子，这个 `getStackTraceAsString` 方法将它的 `Throwable` 输入参数转换成一个格式良好的 `String`： +{% tabs method_8 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_8 %} + +```scala +def getStackTraceAsString(t: Throwable): String = { + val sw = new StringWriter() + t.printStackTrace(new PrintWriter(sw)) + sw.toString +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_8 %} + ```scala def getStackTraceAsString(t: Throwable): String = val sw = StringWriter() @@ -132,6 +209,9 @@ def getStackTraceAsString(t: Throwable): String = sw.toString ``` +{% endtab %} +{% endtabs %} + 在那个方法中： - 第一行将 `StringWriter` 的新实例分配给值绑定器 `sw` @@ -143,20 +223,42 @@ def getStackTraceAsString(t: Throwable): String = 方法参数可以有默认值。 在此示例中，为 `timeout` 和 `protocol` 参数提供了默认值： +{% tabs method_9 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_9 %} + +```scala +def makeConnection(timeout: Int = 5_000, protocol: String = "http") = { + println(f"timeout = ${timeout}%d, protocol = ${protocol}%s") + // more code here ... +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_9 %} + ```scala def makeConnection(timeout: Int = 5_000, protocol: String = "http") = println(f"timeout = ${timeout}%d, protocol = ${protocol}%s") // more code here ... ``` +{% endtab %} +{% endtabs %} + 由于参数具有默认值，因此可以通过以下方式调用该方法： +{% tabs method_10 %} +{% tab 'Scala 2 and 3' for=method_10 %} + ```scala makeConnection() // timeout = 5000, protocol = http makeConnection(2_000) // timeout = 2000, protocol = http makeConnection(3_000, "https") // timeout = 3000, protocol = https ``` +{% endtab %} +{% endtabs %} + 以下是关于这些示例的一些要点： - 在第一个示例中，没有提供任何参数，因此该方法使用默认参数值 `5_000` 和 `http` @@ -170,6 +272,9 @@ makeConnection(3_000, "https") // timeout = 3000, protocol = https 如果您愿意，也可以在调用方法时使用方法参数的名称。 例如，`makeConnection` 也可以通过以下方式调用： +{% tabs method_11 %} +{% tab 'Scala 2 and 3' for=method_11 %} + ```scala makeConnection(timeout=10_000) makeConnection(protocol="https") @@ -177,15 +282,27 @@ makeConnection(timeout=10_000, protocol="https") makeConnection(protocol="https", timeout=10_000) ``` +{% endtab %} +{% endtabs %} + 在某些框架中，命名参数被大量使用。 当多个方法参数具有相同类型时，它们也非常有用： +{% tabs method_12 %} +{% tab 'Scala 2 and 3' for=method_12 %} + ```scala engage(true, true, true, false) ``` +{% endtab %} +{% endtabs %} + 如果没有 IDE 的帮助，代码可能难以阅读，但这段代码更加清晰和明显： +{% tabs method_13 %} +{% tab 'Scala 2 and 3' for=method_13 %} + ```scala engage( speedIsSet = true, @@ -195,6 +312,9 @@ engage( ) ``` +{% endtab %} +{% endtabs %} + ## 关于不带参数的方法的建议 当一个方法不带参数时，它的 _arity_ 级别为 _arity-0_。 @@ -206,17 +326,29 @@ engage( 例如，这个方法会产生副作用，所以它用空括号声明： +{% tabs method_14 %} +{% tab 'Scala 2 and 3' for=method_14 %} + ```scala def speak() = println("hi") ``` +{% endtab %} +{% endtabs %} + 这样做需要方法的调用者在调用方法时使用括号： +{% tabs method_15 %} +{% tab 'Scala 2 and 3' for=method_15 %} + ```scala speak // error: "method speak must be called with () argument" speak() // prints "hi" ``` +{% endtab %} +{% endtabs %} + 虽然这只是一个约定，但遵循它可以显着提高代码的可读性：它可以让您更容易一目了然地理解 arity-0 方法执行副作用。 {% comment %} @@ -228,6 +360,21 @@ Some of that wording comes from this page: https://docs.scala-lang.org/style/met 因为 `if`/`else` 表达式返回一个值，所以它们可以用作方法的主体。 这是一个名为 `isTruthy` 的方法，它实现了 Perl 对 `true` 和 `false` 的定义： +{% tabs method_16 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_16 %} + +```scala +def isTruthy(a: Any) = { + if (a == 0 || a == "" || a == false) + false + else + true +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_16 %} + ```scala def isTruthy(a: Any) = if a == 0 || a == "" || a == false then @@ -236,8 +383,14 @@ def isTruthy(a: Any) = true ``` +{% endtab %} +{% endtabs %} + 这些示例显示了该方法的工作原理： +{% tabs method_17 %} +{% tab 'Scala 2 and 3' for=method_17 %} + ```scala isTruthy(0) // false isTruthy("") // false @@ -245,25 +398,60 @@ isTruthy("hi") // true isTruthy(1.0) // true ``` +{% endtab %} +{% endtabs %} + ## 使用 `match` 作为方法体 `match` 表达式也可以用作整个方法体，而且经常如此。 这是 `isTruthy` 的另一个版本，用 `match` 表达式编写： +{% tabs method_18 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_18 %} + +```scala +def isTruthy(a: Any) = a match { + case 0 | "" | false => false + case _ => true +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_18 %} + ```scala def isTruthy(a: Matchable) = a match case 0 | "" | false => false case _ => true ``` -此方法的工作方式与之前使用 `if`/`else` 表达式的方法一样。我们使用 `Matchable` 而不是 `Any` 作为参数的类型来接受任何支持模式匹配的值。 +> 此方法的工作方式与之前使用 `if`/`else` 表达式的方法一样。我们使用 `Matchable` 而不是 `Any` 作为参数的类型来接受任何支持模式匹配的值。 -有关 `Matchable` trait 的更多详细信息，请参阅 [参考文档][reference_matchable]。 +> 有关 `Matchable` trait 的更多详细信息，请参阅 [参考文档][reference_matchable]。 + +[reference_matchable]: {{ site.scala3ref }}/other-new-features/matchable.html +{% endtab %} +{% endtabs %} ## 控制类中的可见性 在类、对象、trait和枚举中，Scala 方法默认是公共的，所以这里创建的 `Dog` 实例可以访问 `speak` 方法： +{% tabs method_19 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_19 %} + +```scala +class Dog { + def speak() = println("Woof") +} + +val d = new Dog +d.speak() // prints "Woof" +``` + +{% endtab %} +{% tab 'Scala 3' for=method_19 %} + ```scala class Dog: def speak() = println("Woof") @@ -272,9 +460,29 @@ val d = new Dog d.speak() // prints "Woof" ``` +{% endtab %} +{% endtabs %} + 方法也可以标记为 `private`。 这使得它们对当前类是私有的，因此它们不能在子类中被调用或重载： +{% tabs method_20 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_20 %} + +```scala +class Animal { + private def breathe() = println("I’m breathing") +} + +class Cat extends Animal { + // this method won’t compile + override def breathe() = println("Yo, I’m totally breathing") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_20 %} + ```scala class Animal: private def breathe() = println("I’m breathing") @@ -284,8 +492,37 @@ class Cat extends Animal: override def breathe() = println("Yo, I’m totally breathing") ``` +{% endtab %} +{% endtabs %} + 如果你想让一个方法对当前类私有，并且允许子类调用它或覆盖它，将该方法标记为 `protected`，如本例中的 `speak` 方法所示： +{% tabs method_21 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_21 %} + +```scala +class Animal { + private def breathe() = println("I’m breathing") + def walk() = { + breathe() + println("I’m walking") + } + protected def speak() = println("Hello?") +} + +class Cat extends Animal { + override def speak() = println("Meow") +} + +val cat = new Cat +cat.walk() +cat.speak() +cat.breathe() // won’t compile because it’s private +``` + +{% endtab %} +{% tab 'Scala 3' for=method_21 %} + ```scala class Animal: private def breathe() = println("I’m breathing") @@ -303,6 +540,9 @@ cat.speak() cat.breathe() // won’t compile because it’s private ``` +{% endtab %} +{% endtabs %} + `protected` 设置意味着： - 方法（或字段）可以被同一类的其他实例访问 @@ -316,6 +556,37 @@ Scala `object` 关键字用于创建单例类，对象也可以包含方法。 这是对一组“实用程序”方法进行分组的好方法。 例如，此对象包含一组处理字符串的方法： +{% tabs method_22 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_22 %} + +```scala +object StringUtils { + + /** + * Returns a string that is the same as the input string, but + * truncated to the specified length. + */ + def truncate(s: String, length: Int): String = s.take(length) + + /** + * Returns true if the string contains only letters and numbers. + */ + def lettersAndNumbersOnly_?(s: String): Boolean = + s.matches("[a-zA-Z0-9]+") + + /** + * Returns true if the given string contains any whitespace + * at all. Assumes that `s` is not null. + */ + def containsWhitespace(s: String): Boolean = + s.matches(".*\\s.*") + +} +``` + +{% endtab %} +{% tab 'Scala 3' for=method_22 %} + ```scala object StringUtils: @@ -341,35 +612,69 @@ object StringUtils: end StringUtils ``` +{% endtab %} +{% endtabs %} + ## 扩展方法 扩展方法在上下文抽象一章的[扩展方法部分][extension]中讨论。 -它们的主要目的是让您向封闭类添加新功能。 +有很多情况，你想向封闭类添加功能。 如该部分所示，假设您有一个 `Circle` 类，但您无法更改其源代码。 例如，它可以在第三方库中这样定义： +{% tabs method_23 %} +{% tab 'Scala 2 and 3' for=method_23 %} + ```scala case class Circle(x: Double, y: Double, radius: Double) ``` +{% endtab %} +{% endtabs %} + 当你想给这个类添加方法时，你可以将它们定义为扩展方法，像这样： +{% tabs method_24 class=tabs-scala-version %} +{% tab 'Scala 2' for=method_24 %} + +```scala +implicit class CircleOps(c: Circle) { + def circumference: Double = c.radius * math.Pi * 2 + def diameter: Double = c.radius * 2 + def area: Double = math.Pi * c.radius * c.radius +} +``` +在 Scala 2 中使用 `implicit class`，在[这](/overviews/core/implicit-classes.html)找到更多细节。 + +{% endtab %} +{% tab 'Scala 3' for=method_24 %} + ```scala extension (c: Circle) def circumference: Double = c.radius * math.Pi * 2 def diameter: Double = c.radius * 2 def area: Double = math.Pi * c.radius * c.radius ``` +在 Scala 3 中使用新的 `extension` 结构。更多细节可以看[本书][extension]的章节，或者 [Scala 3 参考][reference-ext]。 + +[reference-ext]: {{ site.scala3ref }}/contextual/extension-methods.html +[extension]: {% link _zh-cn/overviews/scala3-book/ca-extension-methods.md %} +{% endtab %} +{% endtabs %} 现在，当您有一个名为 `aCircle` 的 `Circle` 实例时，您可以像这样调用这些方法： +{% tabs method_25 %} +{% tab 'Scala 2 and 3' for=method_25 %} + ```scala aCircle.circumference aCircle.diameter aCircle.area ``` -请参阅本书的[扩展方法部分][reference_extension_methods]，以及[“扩展方法”参考页面][reference]了解更多详细信息。 +{% endtab %} +{% endtabs %} ## 更多 @@ -384,9 +689,12 @@ aCircle.area - 编写具有多个参数组的方法（部分应用的函数） - 创建具有泛型类型参数的方法 -有关这些功能的更多详细信息，请参阅 [参考文档][reference]。 +{% comment %} +Jamie: there really needs better linking here - previously it was to the Scala 3 Reference, which doesnt cover any +of this +{% endcomment %} + +有关这些特性的更多详细信息，请看本书其它章节。 -[extension]: {% link _zh-cn/overviews/scala3-book/ca-extension-methods.md %} [reference_extension_methods]: {{ site.scala3ref }}/contextual/extension-methods.html -[reference]: {{ site.scala3ref }}/overview.html [reference_matchable]: {{ site.scala3ref }}/other-new-features/matchable.html From f445e8d7c511069fbc43b79fb9d193fac9a5fabd Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Thu, 30 Mar 2023 16:33:17 +0200 Subject: [PATCH 2542/3075] Define the SIP Committee Secretary role (#2759) * Define the SIP Committee Secretary role * Update _sips/process-specification.md Co-authored-by: Seth Tisue <seth@tisue.net> --------- Co-authored-by: Seth Tisue <seth@tisue.net> --- _sips/process-specification.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/_sips/process-specification.md b/_sips/process-specification.md index a3697ded89..186709f245 100644 --- a/_sips/process-specification.md +++ b/_sips/process-specification.md @@ -28,13 +28,15 @@ from an idea to the inclusion in the language. language (additions, changes, and/or removals). - Committee: a group of experienced Scala practitioners and language designers, who evaluate changes to the Scala programming language. It consists of a - Chairperson and Members. + Secretary, a Chairperson, and Members. - Chairperson: person in charge of executing the process. They organize and chair the meetings of the Committee, and generally make sure the process is followed, but do not vote on proposals. The Chairperson is an appointed employee of the Scala Center. - Committee Member: member of the Committee with voting rights. The Chairperson cannot be a Member at the same time. +- Secretary: person attending the regular meetings and responsible for writing + notes of the discussions. - SIP Author: any individual or group of people who writes a SIP for submission to the Committee. The Chairperson and Committee Members may also be SIP Authors. Authors are responsible for building consensus within the community and @@ -268,6 +270,10 @@ The current Chairperson is: - Julien Richard-Foy ([@julienrf](https://github.com/julienrf)), Scala Center +The current Secretary is: + +- Seth Tisue ([@SethTisue](https://github.com/SethTisue)), Lightbend + ### Committee Meetings The plenary Committee Meetings are scheduled monthly by the Chairperson. They From 82bc07cfdfe961dabc7a33bcb040dd2b143c8efb Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Wed, 15 Mar 2023 22:35:27 +0800 Subject: [PATCH 2543/3075] add code tabs _zh-cn/overviews/scala3-book/methods-main-methods.md --- .../scala3-book/methods-main-methods.md | 57 ++++++++++++++----- 1 file changed, 43 insertions(+), 14 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/methods-main-methods.md b/_zh-cn/overviews/scala3-book/methods-main-methods.md index 82d711b231..4c1e9c57e8 100644 --- a/_zh-cn/overviews/scala3-book/methods-main-methods.md +++ b/_zh-cn/overviews/scala3-book/methods-main-methods.md @@ -16,10 +16,16 @@ permalink: "/zh-cn/scala3/book/:title.html" Scala 3 提供了一种定义可以从命令行调用的程序的新方法：在方法中添加 `@main` 注释会将其变成可执行程序的入口点： +{% tabs method_1 %} +{% tab 'Scala 3 Only' for=method_1 %} + ```scala @main def hello() = println("Hello, world") ``` +{% endtab %} +{% endtabs %} + 只需将该行代码保存在一个名为 *Hello.scala* 的文件中——文件名不必与方法名匹配——并使用 `scalac` 编译它： ```bash @@ -36,11 +42,20 @@ Hello, world `@main` 注释方法可以写在顶层（如图所示），也可以写在静态可访问的对象中。 在任何一种情况下，程序的名称都是方法的名称，没有任何对象前缀。 +学习更多 `@main` 注解，可以阅读以下章节，或者看这个视频： + +<div style="text-align: center"> + <iframe width="560" height="315" src="https://www.youtube.com/embed/uVMGPrH5_Uc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> +</div> + ### 命令行参数 使用这种方法，您的`@main` 方法可以处理命令行参数，并且这些参数可以有不同的类型。 例如，给定这个 `@main` 方法，它接受一个 `Int`、一个 `String` 和一个可变参数 `String*` 参数： +{% tabs method_2 %} +{% tab 'Scala 3 Only' for=method_2 %} + ```scala @main def happyBirthday(age: Int, name: String, others: String*) = val suffix = (age % 100) match @@ -56,6 +71,9 @@ Hello, world sb.toString ``` +{% endtab %} +{% endtabs %} + 当你编译该代码时，它会创建一个名为 `happyBirthday` 的主程序，它的调用方式如下： ``` @@ -64,7 +82,7 @@ Happy 23rd Birthday, Lisa and Peter! ``` 如图所示，`@main` 方法可以有任意数量的参数。 -对于每个参数类型，必须有一个 *scala.util.FromString* 类型类的实例，它将参数 `String` 转换为所需的参数类型。 +对于每个参数类型，必须是 `scala.util.CommandLineParser.FromString` 类型类的一个 [given实例](./ca-given-using-clauses.html)，它将参数 `String` 转换为所需的参数类型。 同样如图所示，主方法的参数列表可以以重复参数结尾，例如 `String*`，它接受命令行中给出的所有剩余参数。 从 `@main` 方法实现的程序检查命令行上是否有足够的参数来填充所有参数，以及参数字符串是否可以转换为所需的类型。 @@ -88,6 +106,9 @@ Scala 编译器从 `@main` 方法 `f` 生成程序，如下所示： 例如，上面的 `happyBirthday` 方法会生成与以下类等效的附加代码： +{% tabs method_3 %} +{% tab 'Scala 3 Only' for=method_3 %} + ```scala final class happyBirthday { import scala.util.{CommandLineParser as CLP} @@ -107,34 +128,42 @@ final class happyBirthday { > 此功能不适用于 Scala 中的用户程序。 > 常规“静态”成员在 Scala 中使用对象生成。 -## Scala 3 与 Scala 2 的比较 +{% endtab %} +{% endtabs %} + +## 与 Scala 2 的向后兼容性 `@main` 方法是在 Scala 3 中生成可以从命令行调用的程序的推荐方法。 它们取代了 Scala 2 中以前的方法，即创建一个扩展 `App` 类的 `object` ： -```scala -// scala 2 -object happyBirthday extends App { - // needs by-hand parsing of the command line arguments ... -} -``` - 之前依赖于“神奇”的 `DelayedInit` trait 的 `App` 功能不再可用。 `App` 目前仍以有限的形式存在，但它不支持命令行参数，将来会被弃用。 如果程序需要在 Scala 2 和 Scala 3 之间交叉构建，建议使用带有 `Array[String]` 参数的显式 `main` 方法： +{% tabs method_4 %} +{% tab 'Scala 2 and 3' %} + ```scala -object happyBirthday: - def main(args: Array[String]) = println("Hello, world") +object happyBirthday { + private def happyBirthday(age: Int, name: String, others: String*) = { + ... // same as before + } + def main(args: Array[String]): Unit = + happyBirthday(args(0).toInt, args(1), args.drop(2).toIndexedSeq:_*) +} ``` +> 注意我们用 `:_*` 来传递不定数量的参数。为了保持向后兼容性，Scala 3 保持了这种用法。 + +{% endtab %} +{% endtabs %} + 如果将该代码放在名为 *happyBirthday.scala* 的文件中，则可以使用 `scalac` 编译它并使用 `scala` 运行它，如前所示： ```bash $ scalac happyBirthday.scala -$ scala happyBirthday -Hello, world +$ scala happyBirthday 23 Lisa Peter +Happy 23rd Birthday, Lisa and Peter! ``` - From 4d3621655327cfedde02eef800be1c38b5476261 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 20 Mar 2023 10:02:10 +0800 Subject: [PATCH 2544/3075] add code tab in _zh-cn/overviews/scala3-book/fp-functional-error-handling.md --- .../fp-functional-error-handling.md | 180 ++++++++++++++++++ 1 file changed, 180 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md index d16d0eb80c..a58c8a463c 100644 --- a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md +++ b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md @@ -32,6 +32,19 @@ Scala 的解决方案是使用类似 `Option`/`Some`/`None` 类的结构。 想象一下，您想编写一个方法，可以轻松地将字符串转换为整数值，并且您想要一种优雅的方法来处理异常，这个是异常是该方法获取类似“Hello”而不是“1”的字符串时引发的。 对这种方法的初步猜测可能如下所示： +{% tabs fp-java-try class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def makeInt(s: String): Int = + try { + Integer.parseInt(s.trim) + } catch { + case e: Exception => 0 + } +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala def makeInt(s: String): Int = try @@ -39,6 +52,8 @@ def makeInt(s: String): Int = catch case e: Exception => 0 ``` +{% endtab %} +{% endtabs %} 如果转换成功，则此方法返回正确的 `Int` 值，但如果失败，则该方法返回 `0`。 出于某些目的，这可能是可以的，但它并不准确。 @@ -57,6 +72,19 @@ Scala 中这个问题的一个常见解决方案是使用三个类，称为 `Opt 这是 `makeInt` 的修订版： +{% tabs fp--try-option class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def makeInt(s: String): Option[Int] = + try { + Some(Integer.parseInt(s.trim)) + } catch { + case e: Exception => None + } +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala def makeInt(s: String): Option[Int] = try @@ -64,16 +92,22 @@ def makeInt(s: String): Option[Int] = catch case e: Exception => None ``` +{% endtab %} +{% endtabs %} 这段代码可以理解为，“当给定的字符串转换为整数时，返回包裹在 `Some` 中的 `Int`，例如 `Some(1)`。 当字符串无法转换为整数时，会抛出并捕获异常，并且该方法返回一个 `None` 值。” 这些示例展示了 `makeInt` 的工作原理： +{% tabs fp-try-option-example %} +{% tab 'Scala 2 and 3' %} ```scala val a = makeInt("1") // Some(1) val b = makeInt("one") // None ``` +{% endtab %} +{% endtabs %} 如图所示，字符串`"1"`产生一个 `Some(1)`，而字符串 `"one"` 产生一个 `None`。 这是错误处理的 `Option` 方法的本质。 @@ -99,11 +133,24 @@ val b = makeInt("one") // None 一种可能的解决方案是使用 `match` 表达式： +{% tabs fp-option-match class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +makeInt(x) match { + case Some(i) => println(i) + case None => println("That didn’t work.") +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala makeInt(x) match case Some(i) => println(i) case None => println("That didn’t work.") ``` +{% endtab %} +{% endtabs %} 在本例中，如果 `x` 可以转换为 `Int`，则计算第一个 `case` 子句右侧的表达式；如果 `x` 不能转换为 `Int`，则计算第二个 `case` 子句右侧的表达式。 @@ -113,6 +160,20 @@ makeInt(x) match 例如，假设您要将三个字符串转换为整数值，然后将它们相加。 这就是你使用 `for` 表达式和 `makeInt` 的方法： +{% tabs fp-for-comprehension class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val y = for { + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +} yield { + a + b + c +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala val y = for a <- makeInt(stringA) @@ -121,6 +182,8 @@ val y = for yield a + b + c ``` +{% endtab %} +{% endtabs %} 在该表达式运行后，`y` 将是以下两种情况之一： @@ -129,6 +192,24 @@ yield 你可以自己测试一下： +{% tabs fp-for-comprehension-evaluation class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val stringA = "1" +val stringB = "2" +val stringC = "3" + +val y = for { + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +} yield { + a + b + c +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala val stringA = "1" val stringB = "2" @@ -141,15 +222,21 @@ val y = for yield a + b + c ``` +{% endtab %} +{% endtabs %} 使用该样本数据，变量 `y` 的值将是 `Some(6)` 。 要查看失败案例，请将这些字符串中的任何一个更改为不会转换为整数的字符串。 当你这样做时，你会看到 `y` 是 `None`： +{% tabs fp-for-comprehension-failure-result %} +{% tab 'Scala 2 and 3' %} ```scala y: Option[Int] = None ``` +{% endtab %} +{% endtabs %} ## 将 Option 视为容器 @@ -171,10 +258,14 @@ They have many of the methods you’d expect from a collection class, including This raises an interesting question: What will these two values print, if anything? +{% tabs fp-option-methods-evaluation %} +{% tab 'Scala 2 and 3' %} ```scala makeInt("1").foreach(println) makeInt("x").foreach(println) ``` +{% endtab %} +{% endtabs %} Answer: The first example prints the number `1`, and the second example doesn’t print anything. The first example prints `1` because: @@ -196,12 +287,30 @@ Somewhere in Scala’s history, someone noted that the first example (the `Some` *But* despite having two different possible outcomes, the great thing with `Option` is that there’s really just one path: The code you write to handle the `Some` and `None` possibilities is the same in both cases. The `foreach` examples look like this: +{% tabs fp-another-option-method-example %} +{% tab 'Scala 2 and 3' %} ```scala makeInt(aString).foreach(println) ``` +{% endtab %} +{% endtabs %} And the `for` expression looks like this: +{% tabs fp-another-for-comprehension-example class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val y = for { + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +} yield { + a + b + c +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala val y = for a <- makeInt(stringA) @@ -210,16 +319,31 @@ val y = for yield a + b + c ``` +{% endtab %} +{% endtabs %} With exceptions you have to worry about handling branching logic, but because `makeInt` returns a value, you only have to write one piece of code to handle both the Happy and Unhappy Paths, and that simplifies your code. Indeed, the only time you have to think about whether the `Option` is a `Some` or a `None` is when you handle the result value, such as in a `match` expression: +{% tabs fp-option-match-handle class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +makeInt(x) match { + case Some(i) => println(i) + case None => println("That didn't work.") +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala makeInt(x) match case Some(i) => println(i) case None => println("That didn't work.") ``` +{% endtab %} +{% endtabs %} > There are several other ways to handle `Option` values. > See the reference documentation for more details. @@ -229,6 +353,8 @@ makeInt(x) match 回到 `null` 值，`null` 值可以悄悄地潜入你的代码的地方是这样的类： +{% tabs fp=case-class-nulls %} +{% tab 'Scala 2 and 3' %} ```scala class Address( var street1: String, @@ -238,10 +364,26 @@ class Address( var zip: String ) ``` +{% endtab %} +{% endtabs %} 虽然地球上的每个地址都有一个 `street1` 值，但 `street2` 值是可选的。 因此，`street2` 字段可以被分配一个 `null` 值： +{% tabs fp-case-class-nulls-example class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val santa = new Address( + "1 Main Street", + null, // <-- D’oh! A null value! + "North Pole", + "Alaska", + "99705" +) +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala val santa = Address( "1 Main Street", @@ -251,10 +393,14 @@ val santa = Address( "99705" ) ``` +{% endtab %} +{% endtabs %} 从历史上看，开发人员在这种情况下使用了空白字符串和空值，这两种方法都是使用技巧来解决基础性的问题，这个问题是：`street2` 是一个*可选*字段。 在 Scala 和其他现代语言中，正确的解决方案是预先声明 `street2` 是可选的： +{% tabs fp-case-class-with-options %} +{% tab 'Scala 2 and 3' %} ```scala class Address( var street1: String, @@ -264,9 +410,25 @@ class Address( var zip: String ) ``` +{% endtab %} +{% endtabs %} 现在开发人员可以编写更准确的代码，如下所示： +{% tabs fp-case-class-with-options-example-none class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val santa = new Address( + "1 Main Street", + None, // 'street2' has no value + "North Pole", + "Alaska", + "99705" +) +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala val santa = Address( "1 Main Street", @@ -276,9 +438,25 @@ val santa = Address( "99705" ) ``` +{% endtab %} +{% endtabs %} 或这个： +{% tabs fp-case-class-with-options-example-some class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val santa = new Address( + "123 Main Street", + Some("Apt. 2B"), + "Talkeetna", + "Alaska", + "99676" +) +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala val santa = Address( "123 Main Street", @@ -288,6 +466,8 @@ val santa = Address( "99676" ) ``` +{% endtab %} +{% endtabs %} ## `Option` 不是唯一的解决方案 From ab2f72088434ace76d47a18b5594d3a11fa13cfc Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 20 Mar 2023 10:08:53 +0800 Subject: [PATCH 2545/3075] add code tab in _zh-cn/overviews/scala3-book/types-introduction.md --- _zh-cn/overviews/scala3-book/types-introduction.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/types-introduction.md b/_zh-cn/overviews/scala3-book/types-introduction.md index 2acc837a59..e2e4df5b23 100644 --- a/_zh-cn/overviews/scala3-book/types-introduction.md +++ b/_zh-cn/overviews/scala3-book/types-introduction.md @@ -17,19 +17,27 @@ permalink: "/zh-cn/scala3/book/:title.html" Scala 是一种独特的语言，因为它是静态类型的，但通常_感觉_它灵活和动态。 例如，由于类型推断，您可以编写这样的代码而无需显式指定变量类型： +{% tabs hi %} +{% tab 'Scala 2 and 3' %} ```scala val a = 1 val b = 2.0 val c = "Hi!" ``` +{% endtab %} +{% endtabs %} 这使代码感觉是动态类型的。 并且由于新特性，例如 Scala 3 中的 [联合类型][union-types]，您还可以编写如下代码，非常简洁地表达出期望哪些值作为参数，哪些值作为返回的类型： +{% tabs union-example %} +{% tab 'Scala 3 Only' %} ```scala def isTruthy(a: Boolean | Int | String): Boolean = ??? def dogCatOrWhatever(): Dog | Plant | Car | Sun = ??? ``` +{% endtab %} +{% endtabs %} 正如例子所暗示的，当使用联合类型时，这些类型不必共享一个公共层次结构，您仍然可以接受它们作为参数或从方法中返回它们。 From 8858474bdb747ed53867ceb7bc2c23bb1b1f05ba Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 20 Mar 2023 09:37:14 +0800 Subject: [PATCH 2546/3075] add code tab in _zh-cn/overviews/scala3-book/fp-functions-are-values.md --- .../scala3-book/fp-functions-are-values.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md index 472abcead3..a157a8f6d8 100644 --- a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md +++ b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md @@ -19,12 +19,16 @@ permalink: "/zh-cn/scala3/book/:title.html" 这个特性有很多好处，其中最常见的是（a）您可以定义方法来接受函数参数，以及（b）您可以将函数作为参数传递给方法。 你已经在本书的多个地方看到了这一点，每当演示像 `map` 和 `filter` 这样的方法时： +{% tabs fp-function-as-values-anonymous %} +{% tab 'Scala 2 and 3' %} ```scala val nums = (1 to 10).toList val doubles = nums.map(_ * 2) // double each value val lessThanFive = nums.filter(_ < 5) // List(1,2,3,4) ``` +{% endtab %} +{% endtabs %} 在这些示例中，匿名函数被传递到 `map` 和 `filter` 中。 @@ -32,6 +36,8 @@ val lessThanFive = nums.filter(_ < 5) // List(1,2,3,4) 除了将匿名函数传递给 `filter` 和 `map` 之外，您还可以为它们提供 *方法*： +{% tabs fp-function-as-values-defined %} +{% tab 'Scala 2 and 3' %} ```scala // two methods def double(i: Int): Int = i * 2 @@ -40,6 +46,8 @@ def underFive(i: Int): Boolean = i < 5 // pass those methods into filter and map val doubles = nums.filter(underFive).map(double) ``` +{% endtab %} +{% endtabs %} 这种将方法和函数视为值的能力是函数式编程语言提供的强大特性。 @@ -50,29 +58,45 @@ val doubles = nums.filter(underFive).map(double) 正如您在这些示例中看到的，这是一个匿名函数： +{% tabs fp-anonymous-function-short %} +{% tab 'Scala 2 and 3' %} ```scala _ * 2 ``` +{% endtab %} +{% endtabs %} 如 [高阶函数][hofs] 讨论中所示，上面的写法是下面语法的简写版本： +{% tabs fp-anonymous-function-full %} +{% tab 'Scala 2 and 3' %} ```scala (i: Int) => i * 2 ``` +{% endtab %} +{% endtabs %} 像这样的函数被称为“匿名”，因为它们没有名字。 如果你想给一个名字，只需将它分配给一个变量： +{% tabs fp-function-assignement %} +{% tab 'Scala 2 and 3' %} ```scala val double = (i: Int) => i * 2 ``` +{% endtab %} +{% endtabs %} 现在你有了一个命名函数，一个分配给变量的函数。 您可以像使用方法一样使用此函数： +{% tabs fp-function-used-like-method %} +{% tab 'Scala 2 and 3' %} ```scala double(2) // 4 ``` +{% endtab %} +{% endtabs %} 在大多数情况下，`double` 是函数还是方法并不重要。 Scala 允许您以同样的方式对待它们。 在幕后，让您像对待函数一样对待方法的 Scala 技术被称为 [Eta 表达式][eta]。 @@ -82,6 +106,8 @@ double(2) // 4 如果您对将函数作为参数传递给其他函数的过程不适应，可以尝试以下几个示例： +{% tabs fp-function-as-values-example %} +{% tab 'Scala 2 and 3' %} ```scala List("bob", "joe").map(_.toUpperCase) // List(BOB, JOE) List("bob", "joe").map(_.capitalize) // List(Bob, Joe) @@ -100,6 +126,8 @@ nums.sortWith(_ > _) // List(11, 7, 5, 3, 1) nums.takeWhile(_ < 6).sortWith(_ < _) // List(1, 3, 5) ``` +{% endtab %} +{% endtabs %} [hofs]: {% link _zh-cn/overviews/scala3-book/fun-hofs.md %} [eta]: {% link _zh-cn/overviews/scala3-book/fun-eta-expansion.md %} From 46beedbf1e7d59dd1952dfb7642e5aea7e571a96 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sun, 19 Mar 2023 21:28:49 +0800 Subject: [PATCH 2547/3075] add code tab in _zh-cn/overviews/scala3-book/fp-immutable-values.md --- .../scala3-book/fp-immutable-values.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/fp-immutable-values.md b/_zh-cn/overviews/scala3-book/fp-immutable-values.md index eb39d3daec..5e4566bf92 100644 --- a/_zh-cn/overviews/scala3-book/fp-immutable-values.md +++ b/_zh-cn/overviews/scala3-book/fp-immutable-values.md @@ -28,11 +28,15 @@ permalink: "/zh-cn/scala3/book/:title.html" 例如，假设你有一个名字列表——一个 `List[String]`——都是小写的，你想找到所有以字母 `"j"` 开头的名字，并且把找出来的名字大写。 在 FP 中，您编写以下代码： +{% tabs fp-list %} +{% tab 'Scala 2 and 3' %} ```scala val a = List("jane", "jon", "mary", "joe") val b = a.filter(_.startsWith("j")) .map(_.capitalize) ``` +{% endtab %} +{% endtabs %} 如图所示，您不会改变原始列表 `a`。 相反，您将过滤和转换函数应用于 `a` 以创建一个新集合，并将该结果分配给新的不可变变量 `b` 。 @@ -40,32 +44,48 @@ val b = a.filter(_.startsWith("j")) 同样，在 FP 中，您不会创建具有可变 `var` 构造函数参数的类。 也就是说，你不要这样写： +{% tabs fp--class-variables %} +{% tab 'Scala 2 and 3' %} ```scala // don’t do this in FP class Person(var firstName: String, var lastName: String) --- --- ``` +{% endtab %} +{% endtabs %} 相反，您通常创建 `case` 类，其构造函数参数默认为 `val`： +{% tabs fp-immutable-case-class %} +{% tab 'Scala 2 and 3' %} ```scala case class Person(firstName: String, lastName: String) ``` +{% endtab %} +{% endtabs %} 现在你创建一个 `Person` 实例作为 `val` 字段： +{% tabs fp-case-class-creation %} +{% tab 'Scala 2 and 3' %} ```scala val reginald = Person("Reginald", "Dwight") ``` +{% endtab %} +{% endtabs %} 然后，当您需要对数据进行更改时，您可以使用 `case` 类附带的 `copy` 方法来“在制作副本时更新数据”，如下所示： +{% tabs fp-case-class-copy %} +{% tab 'Scala 2 and 3' %} ```scala val elton = reginald.copy( firstName = "Elton", // update the first name lastName = "John" // update the last name ) ``` +{% endtab %} +{% endtabs %} 还有其他处理不可变集合和变量的技术，但希望这些示例能让您尝试一下这些技术。 From 52bd30d6953d4a432bbc6710d52572c8816794c9 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sun, 19 Mar 2023 21:18:03 +0800 Subject: [PATCH 2548/3075] add code tab in _zh-cn/overviews/scala3-book/collections-methods.md --- .../scala3-book/collections-methods.md | 153 +++++++++++++++++- 1 file changed, 152 insertions(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/collections-methods.md b/_zh-cn/overviews/scala3-book/collections-methods.md index 93ca03d15a..47cc4338ae 100644 --- a/_zh-cn/overviews/scala3-book/collections-methods.md +++ b/_zh-cn/overviews/scala3-book/collections-methods.md @@ -39,6 +39,8 @@ Scala 集合的一大优势在于它们提供了许多开箱即用的方法， 为了让您大致了解在后面章节中将看到的内容，这些示例展示了一些最常用的集合方法。 首先，这里有一些不使用 lambda 的方法： +{% tabs common-method-examples %} +{% tab 'Scala 2 and 3' %} ```scala val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) @@ -56,12 +58,16 @@ a.tail // List(20, 30, 40, 10) a.take(3) // List(10, 20, 30) a.takeRight(2) // List(40, 10) ``` +{% endtab %} +{% endtabs %} ### 高阶函数和 lambda 接下来，我们将展示一些常用的接受 lambda（匿名函数）的高阶函数 (HOF)。 首先，这里有几个 lambda 语法的变体，从最长的形式开始，逐步过渡最简洁的形式： +{% tabs higher-order-functions-example %} +{% tab 'Scala 2 and 3' %} ```scala // these functions are all equivalent and return // the same data: List(10, 20, 10) @@ -71,6 +77,8 @@ a.filter((i) => i < 25) // 2. `Int` is not required a.filter(i => i < 25) // 3. the parens are not required a.filter(_ < 25) // 4. `i` is not required ``` +{% endtab %} +{% endtabs %} 在那些编号的例子中： @@ -84,6 +92,8 @@ a.filter(_ < 25) // 4. `i` is not required 现在您已经看到了简洁的形式，下面是使用短形式 lambda 语法的其他 HOF 的示例： +{% tabs anonymous-functions-example %} +{% tab 'Scala 2 and 3' %} ```scala a.dropWhile(_ < 25) // List(30, 40, 10) a.filter(_ > 100) // List() @@ -91,11 +101,15 @@ a.filterNot(_ < 25) // List(30, 40) a.find(_ > 20) // Some(30) a.takeWhile(_ < 30) // List(10, 20) ``` +{% endtab %} +{% endtabs %} 值得注意的是，HOF 也接受方法和函数作为参数——不仅仅是 lambda 表达式。 下面是一些使用名为 `double` 的方法的`map` HOF 示例。 再次显示了 lambda 语法的几种变体： +{% tabs method-as-parameter-example %} +{% tab 'Scala 2 and 3' %} ```scala def double(i: Int) = i * 2 @@ -104,26 +118,36 @@ a.map(i => double(i)) a.map(double(_)) a.map(double) ``` +{% endtab %} +{% endtabs %} 在最后一个示例中，当匿名函数由一个接受单个参数的函数调用组成时，您不必命名参数，因此甚至不需要 `_`。 最后，您可以根据需要组合 HOF 来解决问题： +{% tabs higher-order-functions-combination-example %} +{% tab 'Scala 2 and 3' %} ```scala // yields `List(100, 200)` a.filter(_ < 40) .takeWhile(_ < 30) .map(_ * 10) ``` +{% endtab %} +{% endtabs %} ## 例子数据 以下部分中的示例使用这些列表： +{% tabs sample-data %} +{% tab 'Scala 2 and 3' %} ```scala val oneToTen = (1 to 10).toList val names = List("adam", "brandy", "chris", "david") ``` +{% endtab %} +{% endtabs %} ## `map` @@ -132,22 +156,32 @@ val names = List("adam", "brandy", "chris", "david") 这是一个将 `map` 方法应用于 `oneToTen` 列表的示例： +{% tabs map-example %} +{% tab 'Scala 2 and 3' %} ```scala scala> val doubles = oneToTen.map(_ * 2) doubles: List[Int] = List(2, 4, 6, 8, 10, 12, 14, 16, 18, 20) ``` +{% endtab %} +{% endtabs %} 您还可以使用长格式编写匿名函数，如下所示： +{% tabs map-example-anonymous %} +{% tab 'Scala 2 and 3' %} ```scala scala> val doubles = oneToTen.map(i => i * 2) doubles: List[Int] = List(2, 4, 6, 8, 10, 12, 14, 16, 18, 20) ``` +{% endtab %} +{% endtabs %} 但是，在本课中，我们将始终使用第一种较短的形式。 以下是更多应用于 `oneToTen` 和 `names` 列表的 `map` 方法的示例： +{% tabs few-more-examples %} +{% tab 'Scala 2 and 3' %} ```scala scala> val capNames = names.map(_.capitalize) capNames: List[String] = List(Adam, Brandy, Chris, David) @@ -158,6 +192,8 @@ nameLengthsMap: Map[String, Int] = Map(adam -> 4, brandy -> 6, chris -> 5, david scala> val isLessThanFive = oneToTen.map(_ < 5) isLessThanFive: List[Boolean] = List(true, true, true, true, false, false, false, false, false, false) ``` +{% endtab %} +{% endtabs %} 如最后两个示例所示，使用 `map` 返回与原始类型不同类型的集合是完全合法的（并且很常见）。 @@ -167,6 +203,8 @@ isLessThanFive: List[Boolean] = List(true, true, true, true, false, false, false 谓词或条件是返回 `Boolean`（`true` 或 `false`）的函数。 这里有一些例子： +{% tabs filter-example %} +{% tab 'Scala 2 and 3' %} ```scala scala> val lessThanFive = oneToTen.filter(_ < 5) lessThanFive: List[Int] = List(1, 2, 3, 4) @@ -177,20 +215,30 @@ evens: List[Int] = List(2, 4, 6, 8, 10) scala> val shortNames = names.filter(_.length <= 4) shortNames: List[String] = List(adam) ``` +{% endtab %} +{% endtabs %} 集合上的函数式方法的一个优点是您可以将它们链接在一起以解决问题。 例如，这个例子展示了如何链接 `filter` 和 `map`： +{% tabs filter-example-anonymous %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.filter(_ < 4).map(_ * 10) ``` +{% endtab %} +{% endtabs %} REPL 显示结果： +{% tabs filter-example-anonymous-repl %} +{% tab 'Scala 2 and 3' %} ```scala scala> oneToTen.filter(_ < 4).map(_ * 10) val res1: List[Int] = List(10, 20, 30) ``` +{% endtab %} +{% endtabs %} ## `foreach` @@ -198,6 +246,8 @@ val res1: List[Int] = List(10, 20, 30) 请注意，`foreach` 用于副作用，例如打印信息。 这是一个带有 `names` 列表的示例： +{% tabs foreach-example %} +{% tab 'Scala 2 and 3' %} ```scala scala> names.foreach(println) adam @@ -205,37 +255,55 @@ brandy chris david ``` +{% endtab %} +{% endtabs %} ## `head` `head` 方法来自 Lisp 和其他早期的函数式编程语言。 它用于访问列表的第一个元素（头元素）： +{% tabs head-example %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.head // 1 names.head // adam ``` +{% endtab %} +{% endtabs %} 因为 `String` 可以看作是一个字符序列，所以你也可以把它当作一个列表。 这就是 `head` 在这些字符串上的工作方式： +{% tabs string-head-example %} +{% tab 'Scala 2 and 3' %} ```scala "foo".head // 'f' "bar".head // 'b' ``` +{% endtab %} +{% endtabs %} `head` 是一个很好的方法，但需要注意的是，在空集合上调用它时也会抛出异常： +{% tabs head-error-example %} +{% tab 'Scala 2 and 3' %} ```scala val emptyList = List[Int]() // emptyList: List[Int] = List() emptyList.head // java.util.NoSuchElementException: head of empty list ``` +{% endtab %} +{% endtabs %} 因此，您可能希望使用 `headOption` 而不是 `head`，尤其是在以函数式编程时： +{% tabs head-option-example %} +{% tab 'Scala 2 and 3' %} ```scala emptyList.headOption // None ``` +{% endtab %} +{% endtabs %} 如图所示，它不会抛出异常，它只是返回值为 `None` 的类型 `Option`。 您可以在 [函数式编程][fp-intro] 章节中了解有关这种编程风格的更多信息。 @@ -245,6 +313,8 @@ emptyList.headOption // None `tail` 方法也来自 Lisp，它用于打印列表头元素之后的每个元素。 几个例子展示了这一点： +{% tabs tail-example %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.head // 1 oneToTen.tail // List(2, 3, 4, 5, 6, 7, 8, 9, 10) @@ -252,43 +322,72 @@ oneToTen.tail // List(2, 3, 4, 5, 6, 7, 8, 9, 10) names.head // adam names.tail // List(brandy, chris, david) ``` +{% endtab %} +{% endtabs %} 就像 `head` 一样，`tail` 也适用于字符串： +{% tabs string-tail-example %} +{% tab 'Scala 2 and 3' %} ```scala "foo".tail // "oo" "bar".tail // "ar" ``` +{% endtab %} +{% endtabs %} 如果列表为空，`tail` 会抛出 _java.lang.UnsupportedOperationException_，所以就像 `head` 和 `headOption` 一样，还有一个 `tailOption` 方法，这是函数式编程的首选方法。 也可以匹配一个列表，因此您可以编写如下表达式： +{% tabs tail-match-example %} +{% tab 'Scala 2 and 3' %} ```scala val x :: xs = names ``` +{% endtab %} +{% endtabs %} 将该代码放在 REPL 中显示 `x` 分配给列表的头部，而 `xs` 分配给列表尾部： +{% tabs tail-match-example-repl %} +{% tab 'Scala 2 and 3' %} ```scala scala> val x :: xs = names val x: String = adam val xs: List[String] = List(brandy, chris, david) ``` +{% endtab %} +{% endtabs %} 像这样的模式匹配在许多情况下都很有用，例如使用递归编写一个 `sum` 方法： +{% tabs tail-match-sum-example class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def sum(list: List[Int]): Int = list match { + case Nil => 0 + case x :: xs => x + sum(xs) +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala def sum(list: List[Int]): Int = list match case Nil => 0 case x :: xs => x + sum(xs) ``` +{% endtab %} +{% endtabs %} ## `take`、`takeRight`、`takeWhile` `take`、`takeRight` 和 `takeWhile` 方法为您提供了一种从列表中“获取”要用于创建新列表的元素的好方法。 这是 `take` 和 `takeRight`： +{% tabs take-example %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.take(1) // List(1) oneToTen.take(2) // List(1, 2) @@ -296,28 +395,40 @@ oneToTen.take(2) // List(1, 2) oneToTen.takeRight(1) // List(10) oneToTen.takeRight(2) // List(9, 10) ``` +{% endtab %} +{% endtabs %} 注意这些方法是如何处理“临界”情况的，当我们要求比序列中更多的元素，或者要求零元素的时候： +{% tabs take-edge-cases-example %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.take(Int.MaxValue) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) oneToTen.takeRight(Int.MaxValue) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) oneToTen.take(0) // List() oneToTen.takeRight(0) // List() ``` +{% endtab %} +{% endtabs %} -这是`takeWhle`，它与谓词函数一起使用： +这是`takeWhile`，它与谓词函数一起使用： +{% tabs take-while-example %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.takeWhile(_ < 5) // List(1, 2, 3, 4) names.takeWhile(_.length < 5) // List(adam) ``` +{% endtab %} +{% endtabs %} ## `drop`、`dropRight`、`dropWhile` `drop`、`dropRight` 和 `dropWhile` 本质上与它们对应的“取”相反，从列表中删除元素。 这里有些例子： +{% tabs drop-example %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.drop(1) // List(2, 3, 4, 5, 6, 7, 8, 9, 10) oneToTen.drop(5) // List(6, 7, 8, 9, 10) @@ -325,22 +436,32 @@ oneToTen.drop(5) // List(6, 7, 8, 9, 10) oneToTen.dropRight(8) // List(1, 2) oneToTen.dropRight(7) // List(1, 2, 3) ``` +{% endtab %} +{% endtabs %} 再次注意这些方法如何处理临界情况： +{% tabs drop-edge-cases-example %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.drop(Int.MaxValue) // List() oneToTen.dropRight(Int.MaxValue) // List() oneToTen.drop(0) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) oneToTen.dropRight(0) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) ``` +{% endtab %} +{% endtabs %} 这是 `dropWhile`，它与谓词函数一起使用： +{% tabs drop-while-example %} +{% tab 'Scala 2 and 3' %} ```scala oneToTen.dropWhile(_ < 5) // List(5, 6, 7, 8, 9, 10) names.dropWhile(_ != "chris") // List(chris, david) ``` +{% endtab %} +{% endtabs %} ## `reduce` @@ -350,21 +471,41 @@ names.dropWhile(_ != "chris") // List(chris, david) 解释 `reduce` 的最好方法是创建一个可以传递给它的小辅助方法。 例如，这是一个将两个整数相加的 `add` 方法，还为我们提供了一些不错的调试输出： +{% tabs reduce-example class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def add(x: Int, y: Int): Int = { + val theSum = x + y + println(s"received $x and $y, their sum is $theSum") + theSum +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala def add(x: Int, y: Int): Int = val theSum = x + y println(s"received $x and $y, their sum is $theSum") theSum ``` +{% endtab %} +{% endtabs %} 有上面的方法和下面的列表： +{% tabs reduce-example-init %} +{% tab 'Scala 2 and 3' %} ```scala val a = List(1,2,3,4) ``` +{% endtab %} +{% endtabs %} 这就是将 `add` 方法传递给 `reduce` 时发生的情况： +{% tabs reduce-example-evaluation %} +{% tab 'Scala 2 and 3' %} ```scala scala> a.reduce(add) received 1 and 2, their sum is 3 @@ -372,22 +513,32 @@ received 3 and 3, their sum is 6 received 6 and 4, their sum is 10 res0: Int = 10 ``` +{% endtab %} +{% endtabs %} 如该结果所示，`reduce` 使用`add` 将列表 `a` 归约为单个值，在这种情况下，是列表中整数的总和。 一旦你习惯了 `reduce`，你会写一个像这样的“求和”算法： +{% tabs reduce-example-sum %} +{% tab 'Scala 2 and 3' %} ```scala scala> a.reduce(_ + _) res0: Int = 10 ``` +{% endtab %} +{% endtabs %} 类似地，“连乘”算法如下所示： +{% tabs reduce-example-multiply %} +{% tab 'Scala 2 and 3' %} ```scala scala> a.reduce(_ * _) res1: Int = 24 ``` +{% endtab %} +{% endtabs %} > 关于 `reduce` 的一个重要概念是——顾名思义——它用于将集合_归约_为单个值。 From 985834da96a76c7cc3d7750a883949ea9de1035c Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Thu, 16 Mar 2023 20:26:21 +0800 Subject: [PATCH 2549/3075] add code tab _zh-cn/overviews/scala3-book/fun-write-method-returns-function.md --- .../fun-write-method-returns-function.md | 78 +++++++++++++++++++ 1 file changed, 78 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md index 0272c5242e..401df2aa72 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md @@ -25,48 +25,74 @@ permalink: "/zh-cn/scala3/book/:title.html" 鉴于该声明，您可以开始构建 `greet`。 你知道这将是一种方法： +{% tabs fun-write-method-returns-function-1 %} +{% tab 'Scala 2 and 3' %} ```scala def greet() ``` +{% endtab %} +{% endtabs %} 您还知道此方法将返回一个函数，该函数 (a) 采用 `String` 参数，并且 (b) 使用 `println` 打印该字符串。 因此，该函数的类型为 `String => Unit`： +{% tabs fun-write-method-returns-function-2 %} +{% tab 'Scala 2 and 3' %} ```scala def greet(): String => Unit = ??? ---------------- ``` +{% endtab %} +{% endtabs %} 现在你只需要一个方法体。 您知道该方法需要返回一个函数，并且该函数接受一个“字符串”并打印它。 此匿名函数与该描述匹配： +{% tabs fun-write-method-returns-function-3 %} +{% tab 'Scala 2 and 3' %} ```scala (name: String) => println(s"Hello, $name") ``` +{% endtab %} +{% endtabs %} 现在您只需从方法中返回该函数： +{% tabs fun-write-method-returns-function-4 %} +{% tab 'Scala 2 and 3' %} ```scala // a method that returns a function def greet(): String => Unit = (name: String) => println(s"Hello, $name") ``` +{% endtab %} +{% endtabs %} 因为这个方法返回一个函数，所以你可以通过调用`greet()`来得到这个函数。 这是在 REPL 中做的一个很好的步骤，因为它验证了新函数的类型： +{% tabs fun-write-method-returns-function-5 %} +{% tab 'Scala 2 and 3' %} ```` +{% endtab %} +{% endtabs %} scala> val greetFunction = greet() val greetFunction: String => Unit = Lambda.... ----------------------------------------- ```` +{% endtab %} +{% endtabs %} 现在你可以调用`greetFunction`了： +{% tabs fun-write-method-returns-function-6 %} +{% tab 'Scala 2 and 3' %} ```scala greetFunction("Joe") // prints "Hello, Joe" ``` +{% endtab %} +{% endtabs %} 恭喜，您刚刚创建了一个返回函数的方法，然后执行了该函数。 @@ -75,29 +101,43 @@ greetFunction("Joe") // prints "Hello, Joe" 如果您可以传递问候语，我们的方法会更有用，所以让我们这样做。 您所要做的就是将问候语作为参数传递给 `greet` 方法，并在 `println` 中的字符串中使用它： +{% tabs fun-write-method-returns-function-7 %} +{% tab 'Scala 2 and 3' %} ```scala def greet(theGreeting: String): String => Unit = (name: String) => println(s"$theGreeting, $name") ``` +{% endtab %} +{% endtabs %} 现在，当您调用您的方法时，该过程更加灵活，因为您可以更改问候语。 当您从此方法创建函数时，它是这样的： +{% tabs fun-write-method-returns-function-8 %} +{% tab 'Scala 2 and 3' %} ```` scala> val sayHello = greet("Hello") val sayHello: String => Unit = Lambda..... ---------------------- ```` +{% endtab %} +{% endtabs %} REPL 类型签名输出显示 `sayHello` 是一个接受 `String` 输入参数并返回 `Unit`（无）的函数。 所以现在当你给 `sayHello` 一个 `String` 时，它会打印问候语： +{% tabs fun-write-method-returns-function-9 %} +{% tab 'Scala 2 and 3' %} ```scala sayHello("Joe") // prints "Hello, Joe" ``` +{% endtab %} +{% endtabs %} 您还可以根据需要更改问候语以创建新函数： +{% tabs fun-write-method-returns-function-10 %} +{% tab 'Scala 2 and 3' %} ```scala val sayCiao = greet("Ciao") val sayHola = greet("Hola") @@ -105,6 +145,8 @@ val sayHola = greet("Hola") sayCiao("Isabella") // prints "Ciao, Isabella" sayHola("Carlos") // prints "Hola, Carlos" ``` +{% endtab %} +{% endtabs %} ## 一个更真实的例子 @@ -117,27 +159,53 @@ sayHola("Carlos") // prints "Hola, Carlos" 此外，由于该函数会打印给定的字符串，因此您知道它的类型为 `String => Unit`。 使用该信息编写方法签名： +{% tabs fun-write-method-returns-function-11 %} +{% tab 'Scala 2 and 3' %} ```scala def createGreetingFunction(desiredLanguage: String): String => Unit = ??? ``` +{% endtab %} +{% endtabs %} 接下来，因为您知道可能返回的函数接受一个字符串并打印它，所以您可以为英语和法语编写两个匿名函数： +{% tabs fun-write-method-returns-function-12 %} +{% tab 'Scala 2 and 3' %} ```scala (name: String) => println(s"你好，$name") (name: String) => println(s"Bonjour, $name") ``` +{% endtab %} +{% endtabs %} 在方法内部，如果你给这些匿名函数起一些名字，它可能会更易读，所以让我们将它们分配给两个变量： +{% tabs fun-write-method-returns-function-13 %} +{% tab 'Scala 2 and 3' %} ```scala val englishGreeting = (name: String) => println(s"Hello, $name") val frenchGreeting = (name: String) => println(s"Bonjour, $name") ``` +{% endtab %} +{% endtabs %} 现在您需要做的就是 (a) 如果 `desiredLanguage` 是英语，则返回 `englishGreeting`，并且 (b) 如果 `desiredLanguage` 是法语，则返回 `frenchGreeting`。 一种方法是使用 `match` 表达式： +{% tabs fun-write-method-returns-function-14 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def createGreetingFunction(desiredLanguage: String): String => Unit = { + val englishGreeting = (name: String) => println(s"Hello, $name") + val frenchGreeting = (name: String) => println(s"Bonjour, $name") + desiredLanguage match { + case "english" => englishGreeting + case "french" => frenchGreeting + } +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala def createGreetingFunction(desiredLanguage: String): String => Unit = val englishGreeting = (name: String) => println(s"Hello, $name") @@ -146,23 +214,33 @@ def createGreetingFunction(desiredLanguage: String): String => Unit = case "english" => englishGreeting case "french" => frenchGreeting ``` +{% endtab %} +{% endtabs %} 这是最后的方法。 请注意，从方法返回函数值与返回字符串或整数没有什么不同呃值。 这就是 `createGreetingFunction` 构建法语问候函数的方式： +{% tabs fun-write-method-returns-function-15 %} +{% tab 'Scala 2 and 3' %} ```scala val greetInFrench = createGreetingFunction("french") greetInFrench("Jonathan") // prints "Bonjour, Jonathan" ``` +{% endtab %} +{% endtabs %} 这就是它构建英语问候功能的方式： +{% tabs fun-write-method-returns-function-16 %} +{% tab 'Scala 2 and 3' %} ```scala val greetInEnglish = createGreetingFunction("english") greetInEnglish("Joe") // prints "Hello, Joe" ``` +{% endtab %} +{% endtabs %} 如果你对这段代码感到满意——恭喜——你现在知道如何编写返回函数的方法了。 From 6f61983a3c988a7e047354fe40de178d7aa1dd1a Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Thu, 16 Mar 2023 20:53:47 +0800 Subject: [PATCH 2550/3075] corrected. --- .../overviews/scala3-book/fun-write-method-returns-function.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md index 401df2aa72..25647e6ca5 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md @@ -75,8 +75,6 @@ def greet(): String => Unit = {% tabs fun-write-method-returns-function-5 %} {% tab 'Scala 2 and 3' %} ```` -{% endtab %} -{% endtabs %} scala> val greetFunction = greet() val greetFunction: String => Unit = Lambda.... ----------------------------------------- From 60c2d30592848ec21606f5a07d4e9d4ba7a028fb Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Thu, 16 Mar 2023 20:12:13 +0800 Subject: [PATCH 2551/3075] add code tab _zh-cn/overviews/scala3-book/fun-write-map-function.md --- .../scala3-book/fun-write-map-function.md | 52 ++++++++++++++++++- 1 file changed, 50 insertions(+), 2 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/fun-write-map-function.md b/_zh-cn/overviews/scala3-book/fun-write-map-function.md index 0a48d583ec..b3eb86e248 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-map-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-map-function.md @@ -20,66 +20,112 @@ permalink: "/zh-cn/scala3/book/:title.html" 创建函数的第一步是准确地陈述问题。 只关注 `List[Int]`，你说： -> 我想编写一个 `map` 方法，该方法可用于将函数应用于给定的 `List[Int]` 中的每个元素， -> 并将转换后的元素作为新列表返回。 +> 我想编写一个 `map` 方法，该方法可用于将函数应用于给定的 `List[Int]` 中的每个元素，并将转换后的元素作为新列表返回。 鉴于该声明，您开始编写方法签名。 首先，您知道您想接受一个函数作为参数，并且该函数应该将 `Int` 转换为某种通用类型 `A`，因此您编写： +{% tabs map-accept-func-definition %} +{% tab 'Scala 2 and 3' %} ```scala def map(f: (Int) => A) ``` +{% endtab %} +{% endtabs %} 使用泛型类型的语法要求在参数列表之前声明该类型符号，因此您添加： +{% tabs map-type-symbol-definition %} +{% tab 'Scala 2 and 3' %} ```scala def map[A](f: (Int) => A) ``` +{% endtab %} +{% endtabs %} 接下来，您知道 `map` 也应该接受 `List[Int]`： +{% tabs map-list-int-param-definition %} +{% tab 'Scala 2 and 3' %} ```scala def map[A](f: (Int) => A, xs: List[Int]) ``` +{% endtab %} +{% endtabs %} 最后，您还知道 `map` 返回一个转换后的 `List`，其中包含泛型类型 `A` 的元素： +{% tabs map-with-return-type-definition %} +{% tab 'Scala 2 and 3' %} ```scala def map[A](f: (Int) => A, xs: List[Int]): List[A] = ??? ``` +{% endtab %} +{% endtabs %} 这负责方法签名。 现在您所要做的就是编写方法体。 `map` 方法将它赋予的函数应用于它赋予的列表中的每个元素，以生成一个新的、转换的列表。 一种方法是使用 `for` 表达式： +{% tabs for-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +for (x <- xs) yield f(x) +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala for x <- xs yield f(x) ``` +{% endtab %} +{% endtabs %} `for` 表达式通常使代码出奇地简单，对于我们的目的，它最终成为整个方法体。 把它和方法签名放在一起，你现在有了一个独立的 `map` 方法，它与 `List[Int]` 一起工作： +{% tabs map-function class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def map[A](f: (Int) => A, xs: List[Int]): List[A] = + for (x <- xs) yield f(x) +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala def map[A](f: (Int) => A, xs: List[Int]): List[A] = for x <- xs yield f(x) ``` +{% endtab %} +{% endtabs %} ### 使其泛型化 作为奖励，请注意 `for` 表达式不做任何取决于 `List` 中的类型为 `Int` 的事情。 因此，您可以将类型签名中的 `Int` 替换为泛型类型参数 `B`： +{% tabs map-function-full-generic class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def map[A, B](f: (B) => A, xs: List[B]): List[A] = + for (x <- xs) yield f(x) +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala def map[A, B](f: (B) => A, xs: List[B]): List[A] = for x <- xs yield f(x) ``` +{% endtab %} +{% endtabs %} 现在你有了一个适用于任何 `List` 的 `map` 方法。 这些示例表明 `map` 可以按需要工作： +{% tabs map-use-example %} +{% tab 'Scala 2 and 3' %} ```scala def double(i : Int) = i * 2 map(double, List(1, 2, 3)) // List(2, 4, 6) @@ -87,6 +133,8 @@ map(double, List(1, 2, 3)) // List(2, 4, 6) def strlen(s: String) = s.length map(strlen, List("a", "bb", "ccc")) // List(1, 2, 3) ``` +{% endtab %} +{% endtabs %} 现在您已经了解了如何编写接受函数作为输入参数的方法，让我们看看返回函数的方法。 From 3ee9257b17a07dd3fa9b7a1f504655513f7ff451 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Thu, 16 Mar 2023 15:20:25 +0800 Subject: [PATCH 2552/3075] add code tab in _zh-cn/overviews/scala3-book/fun-eta-expansion.md --- .../scala3-book/fun-eta-expansion.md | 29 +++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md index 1c9ec31128..8e169b4c22 100644 --- a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md +++ b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md @@ -16,18 +16,26 @@ permalink: "/zh-cn/scala3/book/:title.html" 当你查看 Scala 集合类的 `map` 方法的 Scaladoc 时，你会看到它被定义为接受一个_函数_： +{% tabs fun_1 %} +{% tab 'Scala 2 and 3' for=fun_1 %} ```scala def map[B](f: (A) => B): List[B] ------------ ``` +{% endtab %} +{% endtabs %} 事实上，Scaladoc 明确指出，“`f` 是应用于每个元素的_函数_。” 但尽管如此，你可以通过某种方式将_方法_传递给 `map`，它仍然有效： +{% tabs fun_2 %} +{% tab 'Scala 2 and 3' for=fun_2 %} ```scala def times10(i: Int) = i * 10 // a method List(1, 2, 3).map(times10) // List(10,20,30) ``` +{% endtab %} +{% endtabs %} 你有没有想过这是如何工作的——如何将_方法_传递给需要_函数_的`map`？ @@ -48,19 +56,28 @@ I’ve made a few changes to that description that I hope are more accurate and 它们的语法也不同。 此示例说明如何定义执行相同任务的方法和函数，确定给定整数是否为偶数： +{% tabs fun_3 %} +{% tab 'Scala 2 and 3' for=fun_3 %} ```scala def isEvenMethod(i: Int) = i % 2 == 0 // a method val isEvenFunction = (i: Int) => i % 2 == 0 // a function ``` +{% endtab %} +{% endtabs %} 该函数确实是一个对象，因此您可以像使用任何其他变量一样使用它，例如将其放入列表中： +{% tabs fun_4 %} +{% tab 'Scala 2 and 3' for=fun_4 %} ```scala val functions = List(isEvenFunction) ``` +{% endtab %} +{% endtabs %} -相反，从技术上讲，方法不是对象，因此在 Scala 2 中，您不能将方法放入 `List` 中，至少不能直接放入，如下例所示： +{% tabs fun_5 class=tabs-scala-version %} +{% tab 'Scala 2' for=fun_5 %} ```scala // this example shows the Scala 2 error message val methods = List(isEvenMethod) @@ -70,13 +87,21 @@ Unapplied methods are only converted to functions when a function type is expect You can make this conversion explicit by writing `isEvenMethod _` or `isEvenMethod(_)` instead of `isEvenMethod`. ``` -如该错误消息所示，在 Scala 2 中可以手动将方法转换为函数，但 Scala 3 的重要部分是改进了 Eta 扩展技术，所以现在当您尝试将方法当作变量用，它是可以工作的---您不必自己处理手动转换： +相反，从技术上讲，方法不是对象，因此在 Scala 2 中，您不能将方法放入 `List` 中，至少不能直接放入，如下例所示： + +{% endtab %} +{% tab 'Scala 3' for=fun_5 %} ```scala val functions = List(isEvenFunction) // works val methods = List(isEvenMethod) // works ``` +Scala 3 的重要部分是改进了 Eta 扩展技术，所以现在当您尝试将方法当作变量用，它是可以工作的---您不必自己处理手动转换： + +{% endtab %} +{% endtabs %} + 就这本入门书而言，需要了解的重要事项是： - Eta Expansion 是 Scala 技术，让您可以像使用函数一样使用方法 From 5fc921b39cbb35746c5399e717bccb3263cacb51 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Thu, 16 Mar 2023 14:51:10 +0800 Subject: [PATCH 2553/3075] add code tab in _zh-cn/overviews/scala3-book/fun-function-variables.md --- .../scala3-book/fun-function-variables.md | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/fun-function-variables.md b/_zh-cn/overviews/scala3-book/fun-function-variables.md index 3113b83a37..5df4d07536 100644 --- a/_zh-cn/overviews/scala3-book/fun-function-variables.md +++ b/_zh-cn/overviews/scala3-book/fun-function-variables.md @@ -16,76 +16,118 @@ permalink: "/zh-cn/scala3/book/:title.html" 从上一节回到这个例子： +{% tabs fun-function-variables-1 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map((i: Int) => i * 2) ``` +{% endtab %} +{% endtabs %} 我们注意到这部分表达式是一个匿名函数： +{% tabs fun-function-variables-2 %} +{% tab 'Scala 2 and 3' %} ```scala (i: Int) => i * 2 ``` +{% endtab %} +{% endtabs %} 它被称为 *匿名* 的原因是它没有分配给变量，因此没有名称。 但是，可以将匿名函数（也称为*函数字面量*）分配给变量以创建*函数变量*： +{% tabs fun-function-variables-3 %} +{% tab 'Scala 2 and 3' %} ```scala val double = (i: Int) => i * 2 ``` +{% endtab %} +{% endtabs %} 这将创建一个名为 `double` 的函数变量。 在这个表达式中，原始函数字面量在 `=` 符号的右侧： +{% tabs fun-function-variables-4 %} +{% tab 'Scala 2 and 3' %} ```scala val double = (i: Int) => i * 2 ----------------- ``` +{% endtab %} +{% endtabs %} 新变量名在左侧： +{% tabs fun-function-variables-5 %} +{% tab 'Scala 2 and 3' %} ```scala val double = (i: Int) => i * 2 ------ ``` +{% endtab %} +{% endtabs %} 并且函数的参数列表在此处加下划线： +{% tabs fun-function-variables-6 %} +{% tab 'Scala 2 and 3' %} ```scala val double = (i: Int) => i * 2 -------- ``` +{% endtab %} +{% endtabs %} 就像方法的参数列表一样，这意味着 `double` 函数有一个参数，一个名为 `i` 的 `Int`。 你可以在 REPL 中看到 `double` 的类型为 `Int => Int`，这意味着它接受一个 `Int` 参数并返回一个 `Int`： +{% tabs fun-function-variables-7 %} +{% tab 'Scala 2 and 3' %} ```scala scala> val double = (i: Int) => i * 2 val double: Int => Int = ... ``` +{% endtab %} +{% endtabs %} ### 调用函数 现在你可以像这样调用`double`函数： +{% tabs fun-function-variables-8 %} +{% tab 'Scala 2 and 3' %} ```scala val x = double(2) // 4 ``` +{% endtab %} +{% endtabs %} 您还可以将 `double` 传递给 `map` 调用： +{% tabs fun-function-variables-9 %} +{% tab 'Scala 2 and 3' %} ```scala List(1, 2, 3).map(double) // List(2, 4, 6) ``` +{% endtab %} +{% endtabs %} 此外，当您有 `Int => Int` 类型的其他函数时： +{% tabs fun-function-variables-10 %} +{% tab 'Scala 2 and 3' %} ```scala val triple = (i: Int) => i * 3 ``` +{% endtab %} +{% endtabs %} 您可以将它们存储在 `List` 或 `Map` 中： +{% tabs fun-function-variables-11 %} +{% tab 'Scala 2 and 3' %} ```scala val functionList = List(double, triple) @@ -94,9 +136,13 @@ val functionMap = Map( "3x" -> triple ) ``` +{% endtab %} +{% endtabs %} 如果将这些表达式粘贴到 REPL 中，您会看到它们具有以下类型： +{% tabs fun-function-variables-12 %} +{% tab 'Scala 2 and 3' %} ```` // a List that contains functions of the type `Int => Int` functionList: List[Int => Int] @@ -105,6 +151,8 @@ functionList: List[Int => Int] // values have the type `Int => Int` functionMap: Map[String, Int => Int] ```` +{% endtab %} +{% endtabs %} ## 关键点 From 1eb3108ea13168904f0bae95592ba170b6ceaaee Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Thu, 16 Mar 2023 14:39:33 +0800 Subject: [PATCH 2554/3075] add code tab in _zh-cn/overviews/scala3-book/fun-anonymous-functions.md --- .../scala3-book/fun-anonymous-functions.md | 65 ++++++++++++++++++- 1 file changed, 64 insertions(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md index f86a953bae..9b2c3c3dd3 100644 --- a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md +++ b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md @@ -13,28 +13,39 @@ layout: multipage-overview permalink: "/zh-cn/scala3/book/:title.html" --- - 匿名函数（也称为 *lambda*）是作为参数传递给高阶函数的代码块。 维基百科将 [匿名函数](https://en.wikipedia.org/wiki/Anonymous_function) 定义为“未绑定到标识符的函数定义”。 例如，给定这样的列表： +{% tabs fun-anonymous-1 %} +{% tab 'Scala 2 and 3' %} ```scala val ints = List(1, 2, 3) ``` +{% endtab %} +{% endtabs %} 您可以通过使用 `List` 类 `map` 方法和自定义匿名函数将 `ints` 中的每个元素加倍来创建一个新列表： +{% tabs fun-anonymous-2 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map(_ * 2) // List(2, 4, 6) ``` +{% endtab %} +{% endtabs %} 如注释所示，`doubledInts` 包含列表`List(2, 4, 6)`。 在该示例中，这部分代码是一个匿名函数： +{% tabs fun-anonymous-3 %} +{% tab 'Scala 2 and 3' %} ```scala _ * 2 ``` +{% endtab %} +{% endtabs %} 这是“将给定元素乘以 2”的简写方式。 @@ -43,43 +54,63 @@ _ * 2 一旦你熟悉了 Scala，你就会一直使用这种形式来编写匿名函数，这些函数在函数的一个位置使用一个变量。 但如果你愿意，你也可以用更长的形式来写它们，所以除了写这段代码： +{% tabs fun-anonymous-4 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map(_ * 2) ``` +{% endtab %} +{% endtabs %} 您也可以使用以下形式编写它： +{% tabs fun-anonymous-5 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map((i: Int) => i * 2) val doubledInts = ints.map((i) => i * 2) val doubledInts = ints.map(i => i * 2) ``` +{% endtab %} +{% endtabs %} 所有这些行的含义完全相同：将 `ints` 中的每个元素加倍以创建一个新列表 `doubledInts`。 （稍后会解释每种形式的语法。） 如果您熟悉 Java，了解这些 `map` 示例与以下 Java 代码等价可能会有所帮助： +{% tabs fun-anonymous-5-b %} +{% tab 'Java' %} ```java List<Integer> ints = List.of(1, 2, 3); List<Integer> doubledInts = ints.stream() .map(i -> i * 2) .collect(Collectors.toList()); ``` +{% endtab %} +{% endtabs %} ## 缩短匿名函数 当你想要明确时，你可以使用这个长格式编写一个匿名函数： +{% tabs fun-anonymous-6 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map((i: Int) => i * 2) ``` +{% endtab %} +{% endtabs %} 该表达式中的匿名函数是这样的： +{% tabs fun-anonymous-7 %} +{% tab 'Scala 2 and 3' %} ```scala (i: Int) => i * 2 ``` +{% endtab %} +{% endtabs %} 如果您不熟悉这种语法，将 `=>` 符号视为转换器会有所帮助，因为表达式使用 `=>` 符号右侧的算法（在这种情况下，一个将 `Int` 加倍的表达式）把符号左侧的参数列表（名为 `i` 的 `Int` 变量) *转换*为新结果。 @@ -88,52 +119,84 @@ val doubledInts = ints.map((i: Int) => i * 2) 这种长形式可以缩短，如以下步骤所示。 首先，这是最长和最明确的形式： +{% tabs fun-anonymous-8 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map((i: Int) => i * 2) ``` +{% endtab %} +{% endtabs %} 因为 Scala 编译器可以从 `ints` 中的数据推断 `i` 是一个 `Int`，所以可以删除 `Int` 声明： +{% tabs fun-anonymous-9 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map((i) => i * 2) ``` +{% endtab %} +{% endtabs %} 因为只有一个参数，所以不需要在参数 `i` 周围的括号： +{% tabs fun-anonymous-10 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map(i => i * 2) ``` +{% endtab %} +{% endtabs %} 因为当参数在函数中只出现一次时，Scala 允许您使用 `_` 符号而不是变量名，所以代码可以进一步简化： +{% tabs fun-anonymous-11 %} +{% tab 'Scala 2 and 3' %} ```scala val doubledInts = ints.map(_ * 2) ``` +{% endtab %} +{% endtabs %} ### 变得更短 在其他示例中，您可以进一步简化匿名函数。 例如，从最显式的形式开始，您可以使用带有 `List` 类 `foreach` 方法的匿名函数打印 `ints` 中的每个元素： +{% tabs fun-anonymous-12 %} +{% tab 'Scala 2 and 3' %} ```scala ints.foreach((i: Int) => println(i)) ``` +{% endtab %} +{% endtabs %} 和以前一样，不需要 `Int` 声明，因为只有一个参数，所以不需要 `i` 周围的括号： +{% tabs fun-anonymous-13 %} +{% tab 'Scala 2 and 3' %} ```scala ints.foreach(i => println(i)) ``` +{% endtab %} +{% endtabs %} 因为 `i` 在函数体中只使用一次，表达式可以进一步简化为 `_` 符号： +{% tabs fun-anonymous-14 %} +{% tab 'Scala 2 and 3' %} ```scala ints.foreach(println(_)) ``` +{% endtab %} +{% endtabs %} 最后，如果一个匿名函数由一个接受单个参数的方法调用组成，您不需要显式命名和指定参数，因此您最终可以只写方法的名称（此处为 `println`）： +{% tabs fun-anonymous-15 %} +{% tab 'Scala 2 and 3' %} ```scala ints.foreach(println) ``` +{% endtab %} +{% endtabs %} From 864d1a57bfbd55bb0caae24aa2b72cd2470b6d82 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Fri, 31 Mar 2023 13:52:07 +0200 Subject: [PATCH 2555/3075] Add Scala 2 version of case classes that can evolve (#2760) The same approach as with Scala 3 also works with Scala 2 if you add the `-Xsource:3` compiler option. --- ...inary-compatibility-for-library-authors.md | 58 ++++++++++++++++--- 1 file changed, 50 insertions(+), 8 deletions(-) diff --git a/_overviews/tutorials/binary-compatibility-for-library-authors.md b/_overviews/tutorials/binary-compatibility-for-library-authors.md index 47261847d6..a6d358ed14 100644 --- a/_overviews/tutorials/binary-compatibility-for-library-authors.md +++ b/_overviews/tutorials/binary-compatibility-for-library-authors.md @@ -182,21 +182,39 @@ To achieve that, follow this pattern: * define a private `unapply` function in the companion object (note that by doing that the case class loses the ability to be used as an extractor in match expressions) * for all the fields, define `withXXX` methods on the case class that create a new instance with the respective field changed (you can use the private `copy` method to implement them) * create a public constructor by defining an `apply` method in the companion object (it can use the private constructor) + * in Scala 2, you have to add the compiler option `-Xsource:3` Example: -{% tabs case_class_compat_1 %} -{% tab 'Scala 3 Only' %} +{% tabs case_class_compat_1 class=tabs-scala-version %} +{% tab 'Scala 2' %} +~~~ scala +// Mark the primary constructor as private +case class Person private (name: String, age: Int) { + // Create withXxx methods for every field, implemented by using the (private) copy method + def withName(name: String): Person = copy(name = name) + def withAge(age: Int): Person = copy(age = age) +} + +object Person { + // Create a public constructor (which uses the private primary constructor) + def apply(name: String, age: Int) = new Person(name, age) + // Make the extractor private + private def unapply(p: Person): Some[Person] = Some(p) +} +~~~ +{% endtab %} +{% tab 'Scala 3' %} ```scala // Mark the primary constructor as private case class Person private (name: String, age: Int): - // Create withXxx methods for every field, implemented by using the copy method + // Create withXxx methods for every field, implemented by using the (private) copy method def withName(name: String): Person = copy(name = name) def withAge(age: Int): Person = copy(age = age) object Person: - // Create a public constructor (which uses the primary constructor) + // Create a public constructor (which uses the private primary constructor) def apply(name: String, age: Int): Person = new Person(name, age) // Make the extractor private private def unapply(p: Person) = p @@ -239,8 +257,21 @@ Later in time, you can amend the original case class definition to, say, add an * update the public `apply` method in the companion object to initialize all the fields, * tell MiMa to [ignore](https://github.com/lightbend/mima#filtering-binary-incompatibilities) changes to the class constructor. This step is necessary because MiMa does not yet ignore changes in private class constructor signatures (see [#738](https://github.com/lightbend/mima/issues/738)). -{% tabs case_class_compat_4 %} -{% tab 'Scala 3 Only' %} +{% tabs case_class_compat_4 class=tabs-scala-version %} +{% tab 'Scala 2' %} +~~~ scala +case class Person private (name: String, age: Int, address: Option[String]) { + ... + def withAddress(address: Option[String]) = copy(address = address) +} + +object Person { + // Update the public constructor to also initialize the address field + def apply(name: String, age: Int): Person = new Person(name, age, None) +} +~~~ +{% endtab %} +{% tab 'Scala 3' %} ```scala case class Person private (name: String, age: Int, address: Option[String]): ... @@ -295,8 +326,19 @@ A regular case class not following this pattern would break its usage, because b Optionally, you can also add overloads of the `apply` method in the companion object to initialize more fields in one call. In our example, we can add an overload that also initializes the `address` field: -{% tabs case_class_compat_7 %} -{% tab 'Scala 3 Only' %} +{% tabs case_class_compat_7 class=tabs-scala-version %} +{% tab 'Scala 2' %} +~~~ scala +object Person { + // Original public constructor + def apply(name: String, age: Int): Person = new Person(name, age, None) + // Additional constructor that also sets the address + def apply(name: String, age: Int, address: String): Person = + new Person(name, age, Some(address)) +} +~~~ +{% endtab %} +{% tab 'Scala 3' %} ~~~ scala object Person: // Original public constructor From 36b824410bac680ea6d7809a719c22b37844a0bf Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 31 Mar 2023 21:08:03 +0800 Subject: [PATCH 2556/3075] add code tab in types-variance.md (#2756) --- _overviews/scala3-book/types-variance.md | 95 ++++++++++++++++++- .../overviews/scala3-book/types-variance.md | 84 +++++++++++++++- 2 files changed, 172 insertions(+), 7 deletions(-) diff --git a/_overviews/scala3-book/types-variance.md b/_overviews/scala3-book/types-variance.md index 568ce0e494..9fd69a2802 100644 --- a/_overviews/scala3-book/types-variance.md +++ b/_overviews/scala3-book/types-variance.md @@ -11,13 +11,41 @@ next-page: types-opaque-types Type parameter _variance_ controls the subtyping of parameterized types (like classes or traits). To explain variance, let us assume the following type definitions: + +{% tabs types-variance-1 %} +{% tab 'Scala 2 and 3' %} ```scala trait Item { def productNumber: String } trait Buyable extends Item { def price: Int } trait Book extends Buyable { def isbn: String } + ``` +{% endtab %} +{% endtabs %} Let us also assume the following parameterized types: + +{% tabs types-variance-2 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-2 %} +```scala +// an example of an invariant type +trait Pipeline[T] { + def process(t: T): T +} + +// an example of a covariant type +trait Producer[+T] { + def make: T +} + +// an example of a contravariant type +trait Consumer[-T] { + def take(t: T): Unit +} +``` +{% endtab %} + +{% tab 'Scala 3' for=types-variance-2 %} ```scala // an example of an invariant type trait Pipeline[T]: @@ -31,6 +59,9 @@ trait Producer[+T]: trait Consumer[-T]: def take(t: T): Unit ``` +{% endtab %} +{% endtabs %} + In general there are three modes of variance: - **invariant**---the default, written like `Pipeline[T]` @@ -45,6 +76,22 @@ This means that types like `Pipeline[Item]`, `Pipeline[Buyable]`, and `Pipeline[ And rightfully so! Assume the following method that consumes two values of type `Pipeline[Buyable]`, and passes its argument `b` to one of them, based on the price: +{% tabs types-variance-3 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-3 %} +```scala +def oneOf( + p1: Pipeline[Buyable], + p2: Pipeline[Buyable], + b: Buyable +): Buyable = { + val b1 = p1.process(b) + val b2 = p2.process(b) + if (b1.price < b2.price) b1 else b2 + } +``` +{% endtab %} + +{% tab 'Scala 3' for=types-variance-3 %} ```scala def oneOf( p1: Pipeline[Buyable], @@ -55,10 +102,19 @@ def oneOf( val b2 = p2.process(b) if b1.price < b2.price then b1 else b2 ``` +{% endtab %} +{% endtabs %} + Now, recall that we have the following _subtyping relationship_ between our types: + +{% tabs types-variance-4 %} +{% tab 'Scala 2 and 3' %} ```scala Book <: Buyable <: Item ``` +{% endtab %} +{% endtabs %} + We cannot pass a `Pipeline[Book]` to the method `oneOf` because in its implementation, we call `p1` and `p2` with a value of type `Buyable`. A `Pipeline[Book]` expects a `Book`, which can potentially cause a runtime error. @@ -68,7 +124,6 @@ We cannot pass a `Pipeline[Item]` because calling `process` on it only promises In fact, type `Pipeline` needs to be invariant since it uses its type parameter `T` _both_ as an argument _and_ as a return type. For the same reason, some types in the Scala collection library---like `Array` or `Set`---are also _invariant_. - ### Covariant Types In contrast to `Pipeline`, which is invariant, the type `Producer` is marked as **covariant** by prefixing the type parameter with a `+`. This is valid, since the type parameter is only used in a _return position_. @@ -78,33 +133,47 @@ And in fact, this is sound. The type of `Producer[Buyable].make` only promises t As a caller of `make`, we will be happy to also accept a `Book`, which is a subtype of `Buyable`---that is, it is _at least_ a `Buyable`. This is illustrated by the following example, where the function `makeTwo` expects a `Producer[Buyable]`: + +{% tabs types-variance-5 %} +{% tab 'Scala 2 and 3' %} ```scala def makeTwo(p: Producer[Buyable]): Int = p.make.price + p.make.price ``` +{% endtab %} +{% endtabs %} + It is perfectly fine to pass a producer for books: -``` + +{% tabs types-variance-6 %} +{% tab 'Scala 2 and 3' %} +```scala val bookProducer: Producer[Book] = ??? makeTwo(bookProducer) ``` -The call to `price` within `makeTwo` is still valid also for books. +{% endtab %} +{% endtabs %} +The call to `price` within `makeTwo` is still valid also for books. #### Covariant Types for Immutable Containers You will encounter covariant types a lot when dealing with immutable containers, like those that can be found in the standard library (such as `List`, `Seq`, `Vector`, etc.). For example, `List` and `Vector` are approximately defined as: +{% tabs types-variance-7 %} +{% tab 'Scala 2 and 3' %} ```scala class List[+A] ... class Vector[+A] ... ``` +{% endtab %} +{% endtabs %} This way, you can use a `List[Book]` where a `List[Buyable]` is expected. This also intuitively makes sense: If you are expecting a collection of things that can be bought, it should be fine to give you a collection of books. They have an additional ISBN method in our example, but you are free to ignore these additional capabilities. - ### Contravariant Types In contrast to the type `Producer`, which is marked as covariant, the type `Consumer` is marked as **contravariant** by prefixing the type parameter with a `-`. This is valid, since the type parameter is only used in an _argument position_. @@ -116,20 +185,34 @@ Remember, for type `Producer`, it was the other way around, and we had `Producer And in fact, this is sound. The method `Consumer[Item].take` accepts an `Item`. As a caller of `take`, we can also supply a `Buyable`, which will be happily accepted by the `Consumer[Item]` since `Buyable` is a subtype of `Item`---that is, it is _at least_ an `Item`. - #### Contravariant Types for Consumers Contravariant types are much less common than covariant types. As in our example, you can think of them as “consumers.” The most important type that you might come across that is marked contravariant is the one of functions: +{% tabs types-variance-8 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-8 %} +```scala +trait Function[-A, +B] { + def apply(a: A): B +} +``` +{% endtab %} + +{% tab 'Scala 3' for=types-variance-8 %} ```scala trait Function[-A, +B]: def apply(a: A): B ``` +{% endtab %} +{% endtabs %} + Its argument type `A` is marked as contravariant `A`---it consumes values of type `A`. In contrast, its result type `B` is marked as covariant---it produces values of type `B`. Here are some examples that illustrate the subtyping relationships induced by variance annotations on functions: +{% tabs types-variance-9 %} +{% tab 'Scala 2 and 3' %} ```scala val f: Function[Buyable, Buyable] = b => b @@ -139,6 +222,8 @@ val g: Function[Buyable, Item] = f // OK to provide a Book where a Buyable is expected val h: Function[Book, Buyable] = f ``` +{% endtab %} +{% endtabs %} ## Summary In this section, we have encountered three different kinds of variance: diff --git a/_zh-cn/overviews/scala3-book/types-variance.md b/_zh-cn/overviews/scala3-book/types-variance.md index f4b9ce2fa3..d6a682b404 100644 --- a/_zh-cn/overviews/scala3-book/types-variance.md +++ b/_zh-cn/overviews/scala3-book/types-variance.md @@ -18,14 +18,39 @@ permalink: "/zh-cn/scala3/book/:title.html" 为了解释型变，让我们假设以下类型定义： +{% tabs types-variance-1 %} +{% tab 'Scala 2 and 3' %} ```scala trait Item { def productNumber: String } trait Buyable extends Item { def price: Int } trait Book extends Buyable { def isbn: String } ``` +{% endtab %} +{% endtabs %} 我们还假设以下参数化类型： +{% tabs types-variance-2 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-2 %} +```scala +// an example of an invariant type +trait Pipeline[T] { + def process(t: T): T +} + +// an example of a covariant type +trait Producer[+T] { + def make: T +} + +// an example of a contravariant type +trait Consumer[-T] { + def take(t: T): Unit +} +``` +{% endtab %} + +{% tab 'Scala 3' for=types-variance-2 %} ```scala // an example of an invariant type trait Pipeline[T]: @@ -39,8 +64,10 @@ trait Producer[+T]: trait Consumer[-T]: def take(t: T): Unit ``` +{% endtab %} +{% endtabs %} -一般来说，方差有三种模式： +一般来说，型变有三种模式： - **不变的**---默认值，写成 `Pipeline[T]` - **协变**---用`+`注释，例如 `Producer[+T]` @@ -55,6 +82,25 @@ trait Consumer[-T]: 理所当然地！假设以下方法使用两个类型为`Pipeline[Buyable]` 的值，并根据价格将其参数 `b` 传递给其中一个： +{% tabs types-variance-3 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-3 %} +```scala +def oneOf( + p1: Pipeline[Buyable], + p2: Pipeline[Buyable], + b: Buyable +): Buyable = { + val b1 = p1.process(b) + val b2 = p2.process(b) + if (b1.price < b2.price) + b1 + else + b2 + } +``` +{% endtab %} + +{% tab 'Scala 3' for=types-variance-3 %} ```scala def oneOf( p1: Pipeline[Buyable], @@ -65,12 +111,18 @@ def oneOf( val b2 = p2.process(b) if b1.price < b2.price then b1 else b2 ``` +{% endtab %} +{% endtabs %} 现在，回想一下，我们的类型之间存在以下_子类型关系_： +{% tabs types-variance-4 %} +{% tab 'Scala 2 and 3' %} ```scala Book <: Buyable <: Item ``` +{% endtab %} +{% endtabs %} 我们不能将 `Pipeline[Book]` 传递给 `oneOf` 方法，因为在其实现中，我们调用的 `p1` 和 `p2` 是 `Buyable` 类型的值。 `Pipeline[Book]` 需要的是 `Book`，这可能会导致运行时错误。 @@ -93,17 +145,25 @@ Book <: Buyable <: Item 以下示例说明了这一点，其中函数 `makeTwo` 需要一个 `Producer[Buyable]`： +{% tabs types-variance-5 %} +{% tab 'Scala 2 and 3' %} ```scala def makeTwo(p: Producer[Buyable]): Int = p.make.price + p.make.price ``` +{% endtab %} +{% endtabs %} 通过书籍制作人是完全可以的： -``` +{% tabs types-variance-6 %} +{% tab 'Scala 2 and 3' %} +```scala val bookProducer: Producer[Book] = ??? makeTwo(bookProducer) ``` +{% endtab %} +{% endtabs %} 在 `makeTwo` 中调用 `price` 对书籍仍然有效。 @@ -113,10 +173,14 @@ makeTwo(bookProducer) 例如，`List` 和 `Vector` 大致定义为： +{% tabs types-variance-7 %} +{% tab 'Scala 2 and 3' %} ```scala class List[+A] ... class Vector[+A] ... ``` +{% endtab %} +{% endtabs %} 这样，您可以在需要 `List[Buyable]` 的地方使用 `List[Book]`。 这在直觉上也是有道理的：如果您期望收藏可以购买的东西，那么给您收藏书籍应该没问题。 @@ -139,16 +203,30 @@ class Vector[+A] ... 逆变类型比协变类型少得多。 在我们的示例中，您可以将它们视为“消费者”。你可能来的最重要的类型标记为逆变的 cross 是函数之一： +{% tabs types-variance-8 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-8 %} +```scala +trait Function[-A, +B] { + def apply(a: A): B +} +``` +{% endtab %} + +{% tab 'Scala 3' for=types-variance-8 %} ```scala trait Function[-A, +B]: def apply(a: A): B ``` +{% endtab %} +{% endtabs %} 它的参数类型 `A` 被标记为逆变的 `A` ——它消费 `A` 类型的值。 相反，它的结果类型 `B` 被标记为协变——它产生 `B` 类型的值。 以下是一些示例，这些示例说明了由函数上可变注释引起的子类型关系： +{% tabs types-variance-9 %} +{% tab 'Scala 2 and 3' %} ```scala val f: Function[Buyable, Buyable] = b => b @@ -158,6 +236,8 @@ val g: Function[Buyable, Item] = f // OK to provide a Book where a Buyable is expected val h: Function[Book, Buyable] = f ``` +{% endtab %} +{% endtabs %} ## 概括 From c3fd0a31e7e524121708171d2a4aa41dfe339106 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 31 Mar 2023 21:43:05 +0800 Subject: [PATCH 2557/3075] add code tab in _zh-cn/overviews/scala3-book/fun-hofs.md (#2742) --- _overviews/scala3-book/fun-hofs.md | 45 +++++++----- _zh-cn/overviews/scala3-book/fun-hofs.md | 90 ++++++++++++++++++++++++ 2 files changed, 118 insertions(+), 17 deletions(-) diff --git a/_overviews/scala3-book/fun-hofs.md b/_overviews/scala3-book/fun-hofs.md index 90ebba7396..45d764dee4 100644 --- a/_overviews/scala3-book/fun-hofs.md +++ b/_overviews/scala3-book/fun-hofs.md @@ -15,8 +15,6 @@ In Scala, HOFs are possible because functions are first-class values. As an important note, while we use the common industry term “higher-order function” in this document, in Scala this phrase applies to both *methods* and *functions*. Thanks to Scala’s [Eta Expansion technology][eta_expansion], they can generally be used in the same places. - - ## From consumer to creator In the examples so far in this book you’ve seen how to be a *consumer* of methods that take other functions as input parameters, such as using HOFs like `map` and `filter`. @@ -32,8 +30,6 @@ In the process you’ll see: As a beneficial side effect of this discussion, once you’re comfortable with this syntax, you’ll use it to define function parameters, anonymous functions, and function variables, and it also becomes easier to read the Scaladoc for higher-order functions. - - ## Understanding filter’s Scaladoc To understand how higher-order functions work, it helps to dig into an example. @@ -56,21 +52,27 @@ At this point, if you don’t know the purpose of the `filter` method, all you Looking specifically at the function parameter `p`, this part of `filter`’s description: +{% tabs filter-definition_1 %} +{% tab 'Scala 2 and 3' %} ```scala p: A => Boolean ``` +{% endtab %} +{% endtabs %} means that whatever function you pass in must take the type `A` as an input parameter and return a `Boolean`. So if your list is a `List[Int]`, you can replace the generic type `A` with `Int`, and read that signature like this: +{% tabs filter-definition_2 %} +{% tab 'Scala 2 and 3' %} ```scala p: Int => Boolean ``` +{% endtab %} +{% endtabs %} Because `isEven` has this type---it transforms an input `Int` into a resulting `Boolean`---it can be used with `filter`. - - {% comment %} NOTE: (A low-priority issue): The next several sections can be condensed. {% endcomment %} @@ -101,9 +103,13 @@ def sayHello(f: () => Unit): Unit = f() This portion of the code---the *type signature*---states that `f` is a function, and defines the types of functions the `sayHello` method will accept: +{% tabs sayHello-definition_1 %} +{% tab 'Scala 2 and 3' %} ```scala f: () => Unit ``` +{% endtab %} +{% endtabs %} Here’s how this works: @@ -125,7 +131,6 @@ def helloJoe(): Unit = println("Hello, Joe") {% endtab %} {% endtabs %} - Because the type signatures match, you can pass `helloJoe` into `sayHello`: {% tabs sayHello-usage %} @@ -139,7 +144,6 @@ sayHello(helloJoe) // prints "Hello, Joe" If you’ve never done this before, congratulations: You just defined a method named `sayHello` that takes a function as an input parameter, and then invokes that function in its method body. - ### sayHello can take many functions It’s important to know that the beauty of this approach is not that `sayHello` can take *one* function as an input parameter; the beauty is that it can take *any* function that matches `f`’s signature. @@ -167,8 +171,6 @@ Bonjour, Julien This is a good start. The only thing to do now is see a few more examples of how to define different type signatures for function parameters. - - ## The general syntax for defining function input parameters In this method: @@ -183,26 +185,38 @@ def sayHello(f: () => Unit): Unit We noted that the type signature for `f` is: +{% tabs sayHello-definition-2_1 %} +{% tab 'Scala 2 and 3' %} ```scala () => Unit ``` +{% endtab %} +{% endtabs %} We know that this means, “a function that takes no input parameters and returns nothing meaningful (given by `Unit`).” To demonstrate more type signature examples, here’s a function that takes a `String` parameter and returns an `Int`: +{% tabs sayHello-definition-2_2 %} +{% tab 'Scala 2 and 3' %} ```scala f: String => Int ``` +{% endtab %} +{% endtabs %} What kinds of functions take a string and return an integer? Functions like “string length” and checksum are two examples. Similarly, this function takes two `Int` parameters and returns an `Int`: +{% tabs sayHello-definition-2_3 %} +{% tab 'Scala 2 and 3' %} ```scala f: (Int, Int) => Int ``` +{% endtab %} +{% endtabs %} Can you imagine what sort of functions match that signature? @@ -220,15 +234,17 @@ def multiply(a: Int, b: Int): Int = a * b As you can infer from these examples, the general syntax for defining function parameter type signatures is: +{% tabs add-sub-mul-definitions_1 %} +{% tab 'Scala 2 and 3' %} ```scala variableName: (parameterTypes ...) => returnType ``` +{% endtab %} +{% endtabs %} > Because functional programming is like creating and combining a series of algebraic equations, it’s common to think about types a *lot* when designing functions and applications. > You might say that you “think in types.” - - ## Taking a function parameter along with other parameters For HOFs to be really useful, they also need some data to work on. @@ -279,11 +295,8 @@ Hello, world {% endtab %} {% endtabs %} - Excellent. The `executeNTimes` method executes the `helloWorld` function three times. - - ### As many parameters as needed Your methods can continue to get as complicated as necessary. @@ -298,7 +311,6 @@ def executeAndPrint(f: (Int, Int) => Int, i: Int, j: Int): Unit = {% endtab %} {% endtabs %} - Because these `sum` and `multiply` methods match that type signature, they can be passed into `executeAndPrint` along with two `Int` values: {% tabs executeAndPrint-usage %} @@ -313,7 +325,6 @@ executeAndPrint(multiply, 3, 9) // prints 27 {% endtab %} {% endtabs %} - ## Function type signature consistency A great thing about learning about Scala’s function type signatures is that the syntax you use to define function input parameters is the same syntax you use to write function literals. diff --git a/_zh-cn/overviews/scala3-book/fun-hofs.md b/_zh-cn/overviews/scala3-book/fun-hofs.md index 3b5128e73f..d0fbaa3582 100644 --- a/_zh-cn/overviews/scala3-book/fun-hofs.md +++ b/_zh-cn/overviews/scala3-book/fun-hofs.md @@ -41,9 +41,13 @@ permalink: "/zh-cn/scala3/book/:title.html" 例如，您可以通过查看 Scaladoc 来了解 `filter` 接受的函数类型。 这是 `List[A]` 类中的 `filter` 定义： +{% tabs filter-definition %} +{% tab 'Scala 2 and 3' %} ```scala def filter(p: (A) => Boolean): List[A] ``` +{% endtab %} +{% endtabs %} 这表明 `filter` 是一个接受名为 `p` 的函数参数的方法。 按照惯例，`p` 代表 *谓词（predicate）*，它只是一个返回 `Boolean` 值的函数。 @@ -53,16 +57,24 @@ def filter(p: (A) => Boolean): List[A] 具体看函数参数 `p`，这部分 `filter` 的描述： +{% tabs filter-definition_1 %} +{% tab 'Scala 2 and 3' %} ```scala p: (A) => Boolean ``` +{% endtab %} +{% endtabs %} 意味着您传入的任何函数都必须将类型 `A` 作为输入参数并返回一个 `Boolean` 。 因此，如果您的列表是 `List[Int]`，则可以将通用类型 `A` 替换为 `Int`，并像这样读取该签名： +{% tabs filter-definition_2 %} +{% tab 'Scala 2 and 3' %} ```scala p: (Int) => Boolean ``` +{% endtab %} +{% endtabs %} 因为 `isEven` 具有这种类型——它将输入 `Int` 转换为结果 `Boolean`——它可以与 `filter` 一起使用。 @@ -85,15 +97,23 @@ NOTE: (A low-priority issue): The next several sections can be condensed. 为了证明这一点，这里有一个方法，它接受一个名为 `f` 的输入参数，其中 `f` 是一个函数： +{% tabs sayHello-definition %} +{% tab 'Scala 2 and 3' %} ```scala def sayHello(f: () => Unit): Unit = f() ``` +{% endtab %} +{% endtabs %} 这部分代码---*类型签名*---声明 `f` 是一个函数，并定义了 `sayHello` 方法将接受的函数类型： +{% tabs sayHello-definition_1 %} +{% tab 'Scala 2 and 3' %} ```scala f: () => Unit ``` +{% endtab %} +{% endtabs %} 这是它的工作原理： @@ -107,15 +127,23 @@ f: () => Unit 现在我们已经定义了 `sayHello`，让我们创建一个函数来匹配 `f` 的签名，以便我们可以测试它。 以下函数不接受任何输入参数并且不返回任何内容，因此它匹配 `f` 的类型签名： +{% tabs helloJoe-definition %} +{% tab 'Scala 2 and 3' %} ```scala def helloJoe(): Unit = println("Hello, Joe") ``` +{% endtab %} +{% endtabs %} 因为类型签名匹配，你可以将 `helloJoe` 传递给 `sayHello`： +{% tabs sayHello-usage %} +{% tab 'Scala 2 and 3' %} ```scala sayHello(helloJoe) // prints "Hello, Joe" ``` +{% endtab %} +{% endtabs %} 如果您以前从未这样做过，那么恭喜您： 您刚刚定义了一个名为 `sayHello` 的方法，它接受一个函数作为输入参数，然后在其方法体中调用该函数。 @@ -125,16 +153,24 @@ sayHello(helloJoe) // prints "Hello, Joe" 重要的是要知道这种方法的美妙之处并不是说​​ `sayHello` 可以将 *一个* 函数作为输入参数；而在于它可以采用与 `f` 签名匹配的 *任意一个* 函数。 例如，因为下一个函数没有输入参数并且不返回任何内容，所以它也适用于 `sayHello`： +{% tabs bonjourJulien-definition %} +{% tab 'Scala 2 and 3' %} ```scala def bonjourJulien(): Unit = println("Bonjour, Julien") ``` +{% endtab %} +{% endtabs %} 它在 REPL 中： +{% tabs bonjourJulien-usage %} +{% tab 'Scala 2 and 3' %} ```` scala> sayHello(bonjourJulien) Bonjour, Julien ```` +{% endtab %} +{% endtabs %} 这是一个好的开始。 现在唯一要做的就是查看更多示例，了解如何为函数参数定义不同的类型签名。 @@ -143,48 +179,72 @@ Bonjour, Julien 在这种方法中： +{% tabs sayHello-definition-2 %} +{% tab 'Scala 2 and 3' %} ```scala def sayHello(f: () => Unit): Unit ``` +{% endtab %} +{% endtabs %} 我们注意到 `f` 的类型签名是： +{% tabs sayHello-definition-2_1 %} +{% tab 'Scala 2 and 3' %} ```scala () => Unit ``` +{% endtab %} +{% endtabs %} 我们知道这意味着，“一个没有输入参数并且不返回任何有意义的东西的函数（由 `Unit` 给出）。” 为了演示更多类型签名示例，这里有一个函数，它接受一个 `String` 参数并返回一个 `Int`： +{% tabs sayHello-definition-2_2 %} +{% tab 'Scala 2 and 3' %} ```scala f: (String) => Int ``` +{% endtab %} +{% endtabs %} 什么样的函数接受一个字符串并返回一个整数？ “字符串长度”和校验和等函数就是两个例子。 同样，此函数接受两个 `Int` 参数并返回一个 `Int`： +{% tabs sayHello-definition-2_3 %} +{% tab 'Scala 2 and 3' %} ```scala f: (Int, Int) => Int ``` +{% endtab %} +{% endtabs %} 你能想象什么样的函数匹配那个签名？ 答案是任何接受两个 `Int` 输入参数并返回 `Int` 的函数都与该签名匹配，因此所有这些“函数”（实际上是方法）都是匹配的： +{% tabs add-sub-mul-definitions %} +{% tab 'Scala 2 and 3' %} ```scala def add(a: Int, b: Int): Int = a + b def subtract(a: Int, b: Int): Int = a - b def multiply(a: Int, b: Int): Int = a * b ``` +{% endtab %} +{% endtabs %} 正如您可以从这些示例中推断出的，定义函数参数类型签名的一般语法是： +{% tabs add-sub-mul-definitions_1 %} +{% tab 'Scala 2 and 3' %} ```scala variableName: (parameterTypes ...) => returnType ``` +{% endtab %} +{% endtabs %} > 因为函数式编程就像创建和组合一系列代数方程，所以在设计函数和应用程序时通常会考虑*很多*类型。 > 你可能会说你“在类型中思考”。 @@ -197,29 +257,47 @@ variableName: (parameterTypes ...) => returnType 例如，这是一个名为 `executeNTimes` 的方法，它有两个输入参数：一个函数和一个 `Int`： +{% tabs executeNTimes-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def executeNTimes(f: () => Unit, n: Int): Unit = + for (i <- 1 to n) f() +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala def executeNTimes(f: () => Unit, n: Int): Unit = for i <- 1 to n do f() ``` +{% endtab %} +{% endtabs %} 如代码所示，`executeNTimes` 执行了`f` 函数 `n` 次。 因为像这样的简单 `for` 循环没有返回值，`executeNTimes` 返回 `Unit`。 要测试 `executeNTimes`，请定义一个匹配 `f` 签名的方法： +{% tabs helloWorld-definition %} +{% tab 'Scala 2 and 3' %} ```scala // a method of type `() => Unit` def helloWorld(): Unit = println("Hello, world") ``` +{% endtab %} +{% endtabs %} 然后将该方法与 `Int` 一起传递给`executeNTimes`： +{% tabs helloWorld-usage %} +{% tab 'Scala 2 and 3' %} ```` scala> executeNTimes(helloWorld, 3) Hello, world Hello, world Hello, world ```` +{% endtab %} +{% endtabs %} 优秀。 `executeNTimes` 方法执行 `helloWorld` 函数 3 次。 @@ -229,13 +307,19 @@ Hello, world 您的方法可以继续变得尽可能复杂。 例如，此方法采用类型为 `(Int, Int) => Int` 的函数，以及两个输入参数： +{% tabs executeAndPrint-definition %} +{% tab 'Scala 2 and 3' %} ```scala def executeAndPrint(f: (Int, Int) => Int, i: Int, j: Int): Unit = println(f(i, j)) ``` +{% endtab %} +{% endtabs %} 因为这些 `sum` 和 `multiply` 方法与该类型签名匹配，所以它们可以与两个 `Int` 值一起传递到 `executeAndPrint` 中： +{% tabs executeAndPrint-usage %} +{% tab 'Scala 2 and 3' %} ```scala def sum(x: Int, y: Int) = x + y def multiply(x: Int, y: Int) = x * y @@ -243,6 +327,8 @@ def multiply(x: Int, y: Int) = x * y executeAndPrint(sum, 3, 11) // prints 14 executeAndPrint(multiply, 3, 9) // prints 27 ``` +{% endtab %} +{% endtabs %} ## 函数类型签名一致性 @@ -250,9 +336,13 @@ executeAndPrint(multiply, 3, 9) // prints 27 例如，如果你要编写一个计算两个整数之和的函数，你可以这样写： +{% tabs f-val-definition %} +{% tab 'Scala 2 and 3' %} ```scala val f: (Int, Int) => Int = (a, b) => a + b ``` +{% endtab %} +{% endtabs %} 该代码由类型签名组成： From 31290137a3b8b96f118619b3f12d0abd17105ee1 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sun, 19 Mar 2023 21:35:11 +0800 Subject: [PATCH 2558/3075] add code tab in _zh-cn/overviews/scala3-book/fp-pure-functions.md --- .../scala3-book/fp-pure-functions.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/fp-pure-functions.md b/_zh-cn/overviews/scala3-book/fp-pure-functions.md index ef4803036a..b987b91275 100644 --- a/_zh-cn/overviews/scala3-book/fp-pure-functions.md +++ b/_zh-cn/overviews/scala3-book/fp-pure-functions.md @@ -39,7 +39,7 @@ Scala 提供的另一个帮助您编写函数式代码的特性是编写纯函 这些 `String` 方法也是纯函数： --`isEmpty` +- `isEmpty` - `length` - `substring` @@ -85,17 +85,34 @@ Scala 集合类上的大多数方法也可以作为纯函数工作，包括 `dro 要在 Scala 中编写纯函数，只需使用 Scala 的方法语法编写它们（尽管您也可以使用 Scala 的函数语法）。 例如，这是一个将给定输入值加倍的纯函数： +{% tabs fp-pure-function %} +{% tab 'Scala 2 and 3' %} ```scala def double(i: Int): Int = i * 2 ``` +{% endtab %} +{% endtabs %} 如果您对递归感到满意，这是一个计算整数列表之和的纯函数： +{% tabs fp-pure-recursive-function class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def sum(xs: List[Int]): Int = xs match { + case Nil => 0 + case head :: tail => head + sum(tail) +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala def sum(xs: List[Int]): Int = xs match case Nil => 0 case head :: tail => head + sum(tail) ``` +{% endtab %} +{% endtabs %} 如果您理解该代码，您会发现它符合纯函数定义。 From 33b9f864a213b4de3bfd0c878ffda4bd9948208a Mon Sep 17 00:00:00 2001 From: Quentin Bernet <quentin.bernet@epfl.ch> Date: Fri, 31 Mar 2023 17:08:28 +0200 Subject: [PATCH 2559/3075] Add explanation of, and link to TASTyViz (#2761) --- scala3/guides/tasty-overview.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/scala3/guides/tasty-overview.md b/scala3/guides/tasty-overview.md index bccfa992f5..245c822ee5 100644 --- a/scala3/guides/tasty-overview.md +++ b/scala3/guides/tasty-overview.md @@ -149,6 +149,11 @@ These articles provide more information about Scala 3 macros: - [The reference documentation on Quotes Reflect][quotes-reflect] - [The reference documentation on macros](macros) +<!-- Keep synced with https://docs.scala-lang.org/scala3/reference/metaprogramming/tasty-inspect.html# --> +TASTyViz is a tool to inspect TASTy files visually. +At the time of writing, it is still in the early stages of developement, therefore you can expect missing functionality and less-than-ideal user experience, but it could still prove useful when debugging. +You can check it out [here](https://github.com/shardulc/tastyviz). + [benefits]: https://www.scala-lang.org/blog/2018/04/30/in-a-nutshell.html [erasure]: https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#type-erasure [binary]: {% link _overviews/tutorials/binary-compatibility-for-library-authors.md %} From fd56889d96c2757dc6d7e8a949266bbdba500845 Mon Sep 17 00:00:00 2001 From: Lucas Leblanc <44496264+Dedelweiss@users.noreply.github.com> Date: Fri, 31 Mar 2023 17:23:23 +0200 Subject: [PATCH 2560/3075] Add code tabs to contextual abstractions page (#2724) --- .../incompat-contextual-abstractions.md | 44 +++++++++++++------ 1 file changed, 30 insertions(+), 14 deletions(-) diff --git a/_overviews/scala3-migration/incompat-contextual-abstractions.md b/_overviews/scala3-migration/incompat-contextual-abstractions.md index cd43809c28..ba88ed62f0 100644 --- a/_overviews/scala3-migration/incompat-contextual-abstractions.md +++ b/_overviews/scala3-migration/incompat-contextual-abstractions.md @@ -27,25 +27,31 @@ The Scalafix rule named `ExplicitImplicitTypes` in [ohze/scala-rewrites](https:/ Scala 3 does not support implicit conversion from an implicit function value, of the form `implicit val ev: A => B`. -The following piece of code is now invalid: +{% tabs scala-2-implicit_1 %} +{% tab 'Scala 2 Only' %} -```scala +The following piece of code is now invalid in Scala 3: +~~~ scala trait Pretty { val print: String } def pretty[A](a: A)(implicit ev: A => Pretty): String = - a.print // Error: value print is not a member of A -``` + a.print // In Scala 3, Error: value print is not a member of A +~~~ +{% endtab %} +{% endtabs %} The [Scala 3 migration compilation](tooling-migration-mode.html) can warn you about those cases, but it does not try to fix it. Be aware that this incompatibility can produce a runtime incompatibility and break your program. Indeed the compiler can find another implicit conversion from a broader scope, which would eventually cause an undesired behavior at runtime. -This example illustrates the case: +{% tabs shared-implicit_2 %} +{% tab 'Scala 2 and 3' %} -```scala +This example illustrates the case: +~~~ scala trait Pretty { val print: String } @@ -54,13 +60,15 @@ implicit def anyPretty(any: Any): Pretty = new Pretty { val print = "any" } def pretty[A](a: A)(implicit ev: A => Pretty): String = a.print // always print "any" -``` +~~~ +{% endtab %} +{% endtabs %} The resolved conversion depends on the compiler mode: - `-source:3.0-migration`: the compiler performs the `ev` conversion - `-source:3.0`: the compiler cannot perform the `ev` conversion but it can perform the `anyPretty`, which is undesired -One simple fix is to supply the right conversion explicitly: +In Scala 3, one simple fix is to supply the right conversion explicitly: {% highlight diff %} def pretty[A](a: A)(implicit ev: A => Pretty): String = @@ -73,11 +81,15 @@ def pretty[A](a: A)(implicit ev: A => Pretty): String = View bounds have been deprecated for a long time but they are still supported in Scala 2.13. They cannot be compiled with Scala 3 anymore. -```scala +{% tabs scala-2-bounds_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala def foo[A <% Long](a: A): Long = a -``` +~~~ +{% endtab %} +{% endtabs %} -In this example we get: +In this example, in Scala 3, we get this following error message: {% highlight text %} -- Error: src/main/scala/view-bound.scala:2:12 @@ -104,12 +116,16 @@ It is not the case in Scala 3 anymore, and leads to an ambiguous conversion. For instance, in this example: -```scala +{% tabs scala-2-ambiguous_1 %} +{% tab 'Scala 2 Only' %} +~~~ scala implicit def boolFoo(bool: Boolean): Foo = ??? implicit def lazyBoolFoo(lazyBool: => Boolean): Foo = ??? true.foo() -``` +~~~ +{% endtab %} +{% endtabs %} The Scala 2.13 compiler chooses the `boolFoo` conversion but the Scala 3 compiler fails to compile. @@ -131,4 +147,4 @@ implicit def lazyBoolFoo(lazyBool: => Boolean): Foo = ??? -true.foo() +boolFoo(true).foo() -{% endhighlight %} +{% endhighlight %} \ No newline at end of file From 2be10cddb2b71fcfdea218d0c96af99b57f91494 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 3 Apr 2023 16:15:10 +0800 Subject: [PATCH 2561/3075] add code tab in five files. (#2753) --- _overviews/scala3-book/types-generics.md | 5 ++- _overviews/scala3-book/types-intersection.md | 13 +++++++ .../overviews/scala3-book/types-generics.md | 39 +++++++++++++++++++ .../overviews/scala3-book/types-inferred.md | 12 ++++++ .../scala3-book/types-intersection.md | 17 +++++++- 5 files changed, 83 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/types-generics.md b/_overviews/scala3-book/types-generics.md index c175158c55..25ace5eca4 100644 --- a/_overviews/scala3-book/types-generics.md +++ b/_overviews/scala3-book/types-generics.md @@ -63,7 +63,7 @@ This is how you create and use a `Stack[Int]`: {% tabs stack-usage class=tabs-scala-version %} {% tab 'Scala 2' %} -``` +```scala val stack = new Stack[Int] stack.push(1) stack.push(2) @@ -71,8 +71,9 @@ println(stack.pop()) // prints 2 println(stack.pop()) // prints 1 ``` {% endtab %} + {% tab 'Scala 3' %} -``` +```scala val stack = Stack[Int] stack.push(1) stack.push(2) diff --git a/_overviews/scala3-book/types-intersection.md b/_overviews/scala3-book/types-intersection.md index 9336b7dd68..8c01dd9b33 100644 --- a/_overviews/scala3-book/types-intersection.md +++ b/_overviews/scala3-book/types-intersection.md @@ -41,10 +41,23 @@ Therefore, as shown, `Resettable & Growable[String]` has member methods `reset` Intersection types can be useful to describe requirements _structurally_. That is, in our example `f`, we directly express that we are happy with any value for `x` as long as it’s a subtype of both `Resettable` and `Growable`. We **did not** have to create a _nominal_ helper trait like the following: + +{% tabs normal-trait class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +trait Both[A] extends Resettable with Growable[A] +def f(x: Both[String]): Unit +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala trait Both[A] extends Resettable, Growable[A] def f(x: Both[String]): Unit ``` +{% endtab %} +{% endtabs %} + There is an important difference between the two alternatives of defining `f`: While both allow `f` to be called with instances of `Both`, only the former allows passing instances that are subtypes of `Resettable` and `Growable[String]`, but _not of_ `Both[String]`. > Note that `&` is _commutative_: `A & B` is the same type as `B & A`. diff --git a/_zh-cn/overviews/scala3-book/types-generics.md b/_zh-cn/overviews/scala3-book/types-generics.md index 45fb52865b..8e036c4b77 100644 --- a/_zh-cn/overviews/scala3-book/types-generics.md +++ b/_zh-cn/overviews/scala3-book/types-generics.md @@ -18,6 +18,29 @@ permalink: "/zh-cn/scala3/book/:title.html" Scala 约定是使用单个字母（如 `A`）来命名这些类型参数。 然后当需要时，该类型可以在类中用于方法实例参数，或返回类型： +{% tabs stack class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +// here we declare the type parameter A +// v +class Stack[A] { + private var elements: List[A] = Nil + // ^ + // Here we refer to the type parameter + // v + def push(x: A): Unit = + elements = elements.prepended(x) + def peek: A = elements.head + def pop(): A = { + val currentTop = peek + elements = elements.tail + currentTop + } +} +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala // here we declare the type parameter A // v @@ -33,19 +56,35 @@ class Stack[A]: elements = elements.tail currentTop ``` +{% endtab %} +{% endtabs %} `Stack` 类的这个实现采用任何类型作为参数。 泛型的美妙之处在于您现在可以创建一个 `Stack[Int]`、`Stack[String]` 等，允许您将 `Stack` 的实现重复用于任意元素类型。 这是创建和使用 `Stack[Int]` 的方式： +{% tabs stack-usage class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val stack = new Stack[Int] +stack.push(1) +stack.push(2) +println(stack.pop()) // prints 2 +println(stack.pop()) // prints 1 ``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala val stack = Stack[Int] stack.push(1) stack.push(2) println(stack.pop()) // prints 2 println(stack.pop()) // prints 1 ``` +{% endtab %} +{% endtabs %} > 有关如何用泛型类型表达可变的详细信息，请参阅[型变（Variance）部分][variance]。 diff --git a/_zh-cn/overviews/scala3-book/types-inferred.md b/_zh-cn/overviews/scala3-book/types-inferred.md index ba52c8a9ce..b524a03edd 100644 --- a/_zh-cn/overviews/scala3-book/types-inferred.md +++ b/_zh-cn/overviews/scala3-book/types-inferred.md @@ -16,22 +16,32 @@ permalink: "/zh-cn/scala3/book/:title.html" 与其他静态类型编程语言一样，在 Scala 中，您可以在创建新变量时_声明_类型： +{% tabs xy %} +{% tab 'Scala 2 and 3' %} ```scala val x: Int = 1 val y: Double = 1 ``` +{% endtab %} +{% endtabs %} 在这些示例中，类型分别_明确地_声明为 `Int` 和 `Double` 。 但是，在 Scala 中，您通常不必在定义值绑定器时声明类型： +{% tabs abm %} +{% tab 'Scala 2 and 3' %} ```scala val a = 1 val b = List(1, 2, 3) val m = Map(1 -> "one", 2 -> "two") ``` +{% endtab %} +{% endtabs %} 当你这样做时，Scala _推断_类型，如下面的 REPL 交互所示： +{% tabs abm2 %} +{% tab 'Scala 2 and 3' %} ```scala scala> val a = 1 val a: Int = 1 @@ -42,5 +52,7 @@ val b: List[Int] = List(1, 2, 3) scala> val m = Map(1 -> "one", 2 -> "two") val m: Map[Int, String] = Map(1 -> one, 2 -> two) ``` +{% endtab %} +{% endtabs %} 事实上，大多数变量都是这样定义的，而 Scala 自动推断类型的能力是使它_感觉_像一种动态类型语言的一个特性。 diff --git a/_zh-cn/overviews/scala3-book/types-intersection.md b/_zh-cn/overviews/scala3-book/types-intersection.md index 085c92c893..c61548e163 100644 --- a/_zh-cn/overviews/scala3-book/types-intersection.md +++ b/_zh-cn/overviews/scala3-book/types-intersection.md @@ -12,12 +12,14 @@ overview-name: "Scala 3 — Book" layout: multipage-overview permalink: "/zh-cn/scala3/book/:title.html" --- - +<span class="tag tag-inline">Scala 3 only</span> 用于类型，`&` 运算符创建一个所谓的_相交类型_。 `A & B` 类型表示同时是 `A` 类型和 `B` 类型**两者**的值。 例如，以下示例使用相交类型 `Resettable & Growable[String]`： +{% tabs intersection-reset-grow %} +{% tab 'Scala 3 Only' %} ```scala trait Resettable: def reset(): Unit @@ -29,6 +31,8 @@ def f(x: Resettable & Growable[String]): Unit = x.reset() x.add("first") ``` +{% endtab %} +{% endtabs %} 在本例中的方法 `f` 中，参数 `x` 必须*同时*既是 `Resettable` 也是 `Growable[String]`。 @@ -39,10 +43,21 @@ def f(x: Resettable & Growable[String]): Unit = 也就是说，在我们的示例 `f` 中，我们直接表示只要 `x` 是 `Resettable` 和 `Growable` 的子类型的任意值， 我们就感到满意。 我们**不**需要创建一个_通用_的辅助 trait，如下所示： +{% tabs normal-trait class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +trait Both[A] extends Resettable with Growable[A] +def f(x: Both[String]): Unit +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala trait Both[A] extends Resettable, Growable[A] def f(x: Both[String]): Unit ``` +{% endtab %} +{% endtabs %} 定义 `f` 的两种选择之间有一个重要区别：虽然两者都允许使用 `Both` 的实例调用 `f`，但只有前者允许传递属于 `Resettable` 和 `Growable[String]` 子类型的实例，后者 `Both[String]` _不允许_。 From 5c5ef70124cc71e15d731e0fd2a8fccd2ddacf07 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 3 Apr 2023 16:38:51 +0800 Subject: [PATCH 2562/3075] add code tab in packaging-imports.md (#2745) --- _overviews/scala3-book/packaging-imports.md | 273 ++++++++++++++++-- .../scala3-book/packaging-imports.md | 252 +++++++++++++++- 2 files changed, 501 insertions(+), 24 deletions(-) diff --git a/_overviews/scala3-book/packaging-imports.md b/_overviews/scala3-book/packaging-imports.md index 6cd3835078..56f3e86194 100644 --- a/_overviews/scala3-book/packaging-imports.md +++ b/_overviews/scala3-book/packaging-imports.md @@ -21,24 +21,25 @@ With Scala you can: These features are demonstrated in the following examples. - - ## Creating a package Packages are created by declaring one or more package names at the top of a Scala file. For example, when your domain name is _acme.com_ and you’re working in the _model_ package of an application named _myapp_, your package declaration looks like this: +{% tabs packaging-imports-1 %} +{% tab 'Scala 2 and 3' %} ```scala package com.acme.myapp.model class Person ... ``` +{% endtab %} +{% endtabs %} By convention, package names should be all lower case, and the formal naming convention is *\<top-level-domain>.\<domain-name>.\<project-name>.\<module-name>*. Although it’s not required, package names typically follow directory structure names, so if you follow this convention, a `Person` class in this project will be found in a *MyApp/src/main/scala/com/acme/myapp/model/Person.scala* file. - ### Using multiple packages in the same file The syntax shown above applies to the entire source file: all the definitions in the file @@ -48,6 +49,22 @@ at the beginning of the file. Alternatively, it is possible to write package clauses that apply only to the definitions they contain: +{% tabs packaging-imports-1 class=tabs-scala-version %} +{% tab 'Scala 2' %}```scala +package users { + + package administrators { // the full name of this package is users.administrators + class AdminUser // the full name of this class users.administrators.AdminUser + } + package normalusers { // the full name of this package is users.normalusers + class NormalUser // the full name of this class is users.normalusers.NormalUser + } +} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-1 %} + ```scala package users: @@ -57,14 +74,14 @@ package users: package normalusers: // the full name of this package is users.normalusers class NormalUser // the full name of this class is users.normalusers.NormalUser ``` +{% endtab %} +{% endtabs %} Note that the package names are followed by a colon, and that the definitions within a package are indented. The advantages of this approach are that it allows for package nesting, and provides more obvious control of scope and encapsulation, especially within the same file. - - ## Import statements, Part 1 Import statements are used to access entities in other packages. @@ -76,12 +93,27 @@ Import statements fall into two main categories: If you’re used to a language like Java, the first class of import statements is similar to what Java uses, with a slightly different syntax that allows for more flexibility. These examples demonstrate some of that flexibility: -```` +{% tabs packaging-imports-2 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import users._ // import everything from the `users` package +import users.User // import only the `User` class +import users.{User, UserPreferences} // import only two selected members +import users.{UserPreferences => UPrefs} // rename a member as you import it +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-2 %} + +```scala import users.* // import everything from the `users` package import users.User // import only the `User` class import users.{User, UserPreferences} // import only two selected members import users.{UserPreferences as UPrefs} // rename a member as you import it -```` +``` + +{% endtab %} +{% endtabs %} Those examples are meant to give you a taste of how the first class of `import` statements work. They’re explained more in the subsections that follow. @@ -93,90 +125,165 @@ A note before moving on: > Import clauses are not required for accessing members of the same package. - - ### Importing one or more members In Scala you can import one member from a package like this: +{% tabs packaging-imports-3 %} +{% tab 'Scala 2 and 3' %} ```scala import scala.concurrent.Future ``` +{% endtab %} +{% endtabs %} and multiple members like this: +{% tabs packaging-imports-4 %} +{% tab 'Scala 2 and 3' %} ```scala import scala.concurrent.Future import scala.concurrent.Promise import scala.concurrent.blocking ``` +{% endtab %} +{% endtabs %} When importing multiple members, you can import them more concisely like this: +{% tabs packaging-imports-5 %} +{% tab 'Scala 2 and 3' %} ```scala import scala.concurrent.{Future, Promise, blocking} ``` +{% endtab %} +{% endtabs %} When you want to import everything from the *scala.concurrent* package, use this syntax: +{% tabs packaging-imports-6 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import scala.concurrent._ +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-6 %} + ```scala import scala.concurrent.* ``` +{% endtab %} +{% endtabs %} ### Renaming members on import Sometimes it can help to rename entities when you import them to avoid name collisions. For instance, if you want to use the Scala `List` class and also the *java.util.List* class at the same time, you can rename the *java.util.List* class when you import it: +{% tabs packaging-imports-7 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.util.{List => JavaList} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-7 %} + ```scala import java.util.{List as JavaList} ``` +{% endtab %} +{% endtabs %} Now you use the name `JavaList` to refer to that class, and use `List` to refer to the Scala list class. You can also rename multiple members at one time using this syntax: +{% tabs packaging-imports-8 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.util.{Date => JDate, HashMap => JHashMap, _} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-8 %} + ```scala import java.util.{Date as JDate, HashMap as JHashMap, *} ``` -That line of code says, “Rename the `Date` and `HashMap` classes as shown, and import everything else in the _java.util_ package without renaming any other members.” +{% endtab %} +{% endtabs %} +That line of code says, “Rename the `Date` and `HashMap` classes as shown, and import everything else in the _java.util_ package without renaming any other members.” ### Hiding members on import You can also *hide* members during the import process. This `import` statement hides the *java.util.Random* class, while importing everything else in the *java.util* package: +{% tabs packaging-imports-9 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.util.{Random => _, _} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-9 %} + ```scala import java.util.{Random as _, *} ``` +{% endtab %} +{% endtabs %} If you try to access the `Random` class it won’t work, but you can access all other members from that package: +{% tabs packaging-imports-10 %} +{% tab 'Scala 2 and 3' %} ```scala val r = new Random // won’t compile new ArrayList // works ``` +{% endtab %} +{% endtabs %} #### Hiding multiple members To hide multiple members during the import process, list them before using the final wildcard import: +{% tabs packaging-imports-11 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.util.{List => _, Map => _, Set => _, _} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-11 %} + ```scala scala> import java.util.{List as _, Map as _, Set as _, *} ``` +{% endtab %} +{% endtabs %} Once again those classes are hidden, but you can use all other classes in *java.util*: +{% tabs packaging-imports-12 %} +{% tab 'Scala 2 and 3' %} ```scala scala> new ArrayList[String] val res0: java.util.ArrayList[String] = [] ``` +{% endtab %} +{% endtabs %} Because those Java classes are hidden, you can also use the Scala `List`, `Set`, and `Map` classes without having a naming collision: +{% tabs packaging-imports-13 %} +{% tab 'Scala 2 and 3' %} ```scala scala> val a = List(1, 2, 3) val a: List[Int] = List(1, 2, 3) @@ -187,13 +294,32 @@ val b: Set[Int] = Set(1, 2, 3) scala> val c = Map(1 -> 1, 2 -> 2) val c: Map[Int, Int] = Map(1 -> 1, 2 -> 2) ``` - +{% endtab %} +{% endtabs %} ### Use imports anywhere In Scala, `import` statements can be anywhere. They can be used at the top of a source code file: +{% tabs packaging-imports-14 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +package foo + +import scala.util.Random + +class ClassA { + def printRandom(): Unit = { + val r = new Random // use the imported class + // more code here... + } +} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-14 %} + ```scala package foo @@ -204,9 +330,33 @@ class ClassA: val r = new Random // use the imported class // more code here... ``` +{% endtab %} +{% endtabs %} You can also use `import` statements closer to the point where they are needed, if you prefer: +{% tabs packaging-imports-15 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +package foo + +class ClassA { + import scala.util.Random // inside ClassA + def printRandom(): Unit = { + val r = new Random + // more code here... + } +} + +class ClassB { + // the Random class is not visible here + val r = new Random // this code will not compile +} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-15 %} + ```scala package foo @@ -221,6 +371,8 @@ class ClassB: val r = new Random // this code will not compile ``` +{% endtab %} +{% endtabs %} ### “Static” imports @@ -228,19 +380,43 @@ When you want to import members in a way similar to the Java “static import” Use this syntax to import all static members of the Java `Math` class: +{% tabs packaging-imports-16 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.lang.Math._ +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-16 %} + ```scala import java.lang.Math.* ``` +{% endtab %} +{% endtabs %} Now you can access static `Math` class methods like `sin` and `cos` without having to precede them with the class name: +{% tabs packaging-imports-17 class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -import java.lang.Math.* +import java.lang.Math._ val a = sin(0) // 0.0 val b = cos(PI) // -1.0 ``` +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-17 %} + +```scala +import java.lang.Math.* + +val a = sin(0) // 0.0 +val b = cos(PI) // -1.0 +``` +{% endtab %} +{% endtabs %} ### Packages imported by default @@ -253,25 +429,36 @@ The members of the Scala object `Predef` are also imported by default. > If you ever wondered why you can use classes like `List`, `Vector`, `Map`, etc., without importing them, they’re available because of definitions in the `Predef` object. - - ### Handling naming conflicts In the rare event there’s a naming conflict and you need to import something from the root of the project, prefix the package name with `_root_`: -``` +{% tabs packaging-imports-18 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala package accounts -import _root_.accounts.* +import _root_.accounts._ ``` +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-18 %} + +```scala +package accounts +import _root_.accounts.* +``` +{% endtab %} +{% endtabs %} ## Importing `given` instances -As you’ll see in the [Contextual Abstractions][contextual] chapter, a special form of the `import` statement is used to import `given` instances. +As you’ll see in the [Contextual Abstractions][contextual] chapter, in Scala 3 a special form of the `import` statement is used to import `given` instances. The basic form is shown in this example: +{% tabs packaging-imports-19 %} +{% tab 'Scala 3 only' %} ```scala object A: class TC @@ -282,16 +469,22 @@ object B: import A.* // import all non-given members import A.given // import the given instance ``` +{% endtab %} +{% endtabs %} In this code, the `import A.*` clause of object `B` imports all members of `A` *except* the `given` instance `tc`. Conversely, the second import, `import A.given`, imports *only* that `given` instance. The two `import` clauses can also be merged into one: +{% tabs packaging-imports-20 %} +{% tab 'Scala 3 only' %} ```scala object B: import A.{given, *} ``` - +{% endtab %} +{% endtabs %} +In Scala 2, that style of import does not exist. Implicit definitions are always imported by the wildcard import. ### Discussion The wildcard selector `*` brings all definitions other than givens or extensions into scope, whereas a `given` selector brings all *givens*---including those resulting from extensions---into scope. @@ -303,26 +496,35 @@ These rules have two main benefits: - It enables importing all givens without importing anything else. This is particularly important since givens can be anonymous, so the usual use of named imports is not practical. - ### By-type imports Since givens can be anonymous, it’s not always practical to import them by their name, and wildcard imports are typically used instead. *By-type imports* provide a more specific alternative to wildcard imports, which makes it more clear what is imported: +{% tabs packaging-imports-21 %} +{% tab 'Scala 3 only' %} ```scala import A.{given TC} ``` +{% endtab %} +{% endtabs %} This imports any `given` in `A` that has a type which conforms to `TC`. Importing givens of several types `T1,...,Tn` is expressed by multiple `given` selectors: +{% tabs packaging-imports-22 %} +{% tab 'Scala 3 only' %} ```scala import A.{given T1, ..., given Tn} ``` +{% endtab %} +{% endtabs %} Importing all `given` instances of a parameterized type is expressed by wildcard arguments. For example, when you have this `object`: +{% tabs packaging-imports-23 %} +{% tab 'Scala 3 only' %} ```scala object Instances: given intOrd as Ordering[Int] @@ -330,26 +532,38 @@ object Instances: given ec as ExecutionContext = ... given im as Monoid[Int] ``` +{% endtab %} +{% endtabs %} This import statement imports the `intOrd`, `listOrd`, and `ec` instances, but leaves out the `im` instance because it doesn’t fit any of the specified bounds: +{% tabs packaging-imports-24 %} +{% tab 'Scala 3 only' %} ```scala import Instances.{given Ordering[?], given ExecutionContext} ``` +{% endtab %} +{% endtabs %} By-type imports can be mixed with by-name imports. If both are present in an import clause, by-type imports come last. For instance, this import clause imports `im`, `intOrd`, and `listOrd`, but leaves out `ec`: +{% tabs packaging-imports-25 %} +{% tab 'Scala 3 only' %} ```scala import Instances.{im, given Ordering[?]} ``` - +{% endtab %} +{% endtabs %} ### An example As a concrete example, imagine that you have this `MonthConversions` object that contains two `given` definitions: +{% tabs packaging-imports-26 %} +{% tab 'Scala 3 only' %} + ```scala object MonthConversions: trait MonthConverter[A]: @@ -369,31 +583,46 @@ object MonthConversions: case "feb" => "February" // more cases here ... ``` +{% endtab %} +{% endtabs %} To import those givens into the current scope, use these two `import` statements: +{% tabs packaging-imports-27 %} +{% tab 'Scala 3 only' %} + ```scala import MonthConversions.* import MonthConversions.{given MonthConverter[?]} ``` +{% endtab %} +{% endtabs %} Now you can create a method that uses those `given` instances: +{% tabs packaging-imports-28 %} +{% tab 'Scala 3 only' %} + ```scala def genericMonthConverter[A](a: A)(using monthConverter: MonthConverter[A]): String = monthConverter.convert(a) ``` +{% endtab %} +{% endtabs %} Then you can use that method in your application: +{% tabs packaging-imports-29 %} +{% tab 'Scala 3 only' %} + ```scala @main def main = println(genericMonthConverter(1)) // January println(genericMonthConverter("jan")) // January ``` +{% endtab %} +{% endtabs %} As mentioned, one of the key design benefits of the “import given” syntax is to make it clear where givens in scope come from, and it’s clear in these `import` statements that the givens come from the `MonthConversions` object. - - [contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} diff --git a/_zh-cn/overviews/scala3-book/packaging-imports.md b/_zh-cn/overviews/scala3-book/packaging-imports.md index b121f8b99c..4ef39fbf1a 100644 --- a/_zh-cn/overviews/scala3-book/packaging-imports.md +++ b/_zh-cn/overviews/scala3-book/packaging-imports.md @@ -31,11 +31,15 @@ Scala 导入成员的方法也类似于 Java，并且更灵活。 通过在 Scala 文件的顶部声明一个或多个包名称来创建包。 例如，当您的域名是 _acme.com_ 并且您正在使用名为 _myapp_ 的应用程序中的 _model_ 包中工作时，您的包声明如下所示： +{% tabs packaging-imports-1 %} +{% tab 'Scala 2 and 3' %} ```scala package com.acme.myapp.model class Person ... ``` +{% endtab %} +{% endtabs %} 按照约定，包名应全部小写，正式命名约定为 *\<top-level-domain>.\<domain-name>.\<project-name>.\<module-name>*。 @@ -50,6 +54,22 @@ class Person ... 或者，可以编写仅适用于定义的包子句 他们包含： +{% tabs packaging-imports-1 class=tabs-scala-version %} +{% tab 'Scala 2' %}```scala +package users { + + package administrators { // the full name of this package is users.administrators + class AdminUser // the full name of this class users.administrators.AdminUser + } + package normalusers { // the full name of this package is users.normalusers + class NormalUser // the full name of this class is users.normalusers.NormalUser + } +} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-1 %} + ```scala package users: @@ -59,6 +79,8 @@ package users: package normalusers: // the full name of this package is users.normalusers class NormalUser // the full name of this class is users.normalusers.NormalUser ``` +{% endtab %} +{% endtabs %} 请注意，包名称后跟一个冒号，并且其中的定义 一个包是缩进的。 @@ -76,12 +98,27 @@ package users: 如果您习惯于 Java 之类的语言，则第一类 import 语句与 Java 使用的类似，只是语法略有不同，因此具有更大的灵活性。 这些示例展示了其中的一些灵活性： -```` +{% tabs packaging-imports-2 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import users._ // import everything from the `users` package +import users.User // import only the `User` class +import users.{User, UserPreferences} // import only two selected members +import users.{UserPreferences as UPrefs} // rename a member as you import it +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-2 %} + +```scala import users.* // import everything from the `users` package import users.User // import only the `User` class import users.{User, UserPreferences} // import only two selected members import users.{UserPreferences as UPrefs} // rename a member as you import it -```` +``` + +{% endtab %} +{% endtabs %} 这些示例旨在让您了解第一类 `import` 语句的工作原理。 在接下来的小节中对它们进行了更多解释。 @@ -97,47 +134,93 @@ import users.{UserPreferences as UPrefs} // rename a member as you import it 在 Scala 中，您可以从包中导入一个成员，如下所示： +{% tabs packaging-imports-3 %} +{% tab 'Scala 2 and 3' %} ```scala import scala.concurrent.Future ``` +{% endtab %} +{% endtabs %} 和这样的多个成员： +{% tabs packaging-imports-4 %} +{% tab 'Scala 2 and 3' %} ```scala import scala.concurrent.Future import scala.concurrent.Promise import scala.concurrent.blocking ``` +{% endtab %} +{% endtabs %} 导入多个成员时，您可以像这样更简洁地导入它们： +{% tabs packaging-imports-5 %} +{% tab 'Scala 2 and 3' %} ```scala import scala.concurrent.{Future, Promise, blocking} ``` +{% endtab %} +{% endtabs %} 当您想从 *scala.concurrent* 包中导入所有内容时，请使用以下语法： +{% tabs packaging-imports-6 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import scala.concurrent._ +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-6 %} + ```scala import scala.concurrent.* ``` +{% endtab %} +{% endtabs %} ### 在导入时重命名成员 有时，在导入实体时重命名实体会有所帮助，以避免名称冲突。 例如，如果您想同时使用 Scala `List` 类和 *java.util.List* 类，可以在导入时重命名 *java.util.List* 类： +{% tabs packaging-imports-7 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.util.{List => JavaList} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-7 %} + ```scala import java.util.{List as JavaList} ``` +{% endtab %} +{% endtabs %} 现在您使用名称 `JavaList` 来引用该类，并使用 `List` 来引用 Scala 列表类。 您还可以使用以下语法一次重命名多个成员： +{% tabs packaging-imports-8 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.util.{Date => JDate, HashMap => JHashMap, _} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-8 %} + ```scala import java.util.{Date as JDate, HashMap as JHashMap, *} ``` +{% endtab %} +{% endtabs %} + 那行代码说，“重命名 `Date` 和 `HashMap` 类，如图所示，并导入 _java.util_ 包中的所有其他内容，而不重命名任何其他成员。” ### 在导入时隐藏成员 @@ -145,34 +228,66 @@ import java.util.{Date as JDate, HashMap as JHashMap, *} 您还可以在导入过程中*隐藏*成员。 这个 `import` 语句隐藏了 *java.util.Random* 类，同时导入 *java.util 中的所有其他内容* 包裹： +{% tabs packaging-imports-9 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.util.{Random => _, _} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-9 %} + ```scala import java.util.{Random as _, *} ``` +{% endtab %} +{% endtabs %} 如果您尝试访问 `Random` 类，它将无法正常工作，但您可以访问该包中的所有其他成员： +{% tabs packaging-imports-10 %} +{% tab 'Scala 2 and 3' %} ```scala val r = new Random // won’t compile new ArrayList // works ``` +{% endtab %} +{% endtabs %} #### 隐藏多个成员 要在导入过程中隐藏多个成员，请在使用最终通配符导入之前列出它们： +{% tabs packaging-imports-11 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +scala> import java.util.{List => _, Map => _, Set => _, _} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-11 %} + ```scala scala> import java.util.{List as _, Map as _, Set as _, *} ``` +{% endtab %} +{% endtabs %} 这些类再次被隐藏，但您可以使用 *java.util* 中的所有其他类： +{% tabs packaging-imports-12 %} +{% tab 'Scala 2 and 3' %} ```scala scala> new ArrayList[String] val res0: java.util.ArrayList[String] = [] ``` +{% endtab %} +{% endtabs %} 因为这些 Java 类是隐藏的，所以您也可以使用 Scala 的 `List`、`Set` 和 `Map` 类而不会发生命名冲突： +{% tabs packaging-imports-13 %} +{% tab 'Scala 2 and 3' %} ```scala scala> val a = List(1, 2, 3) val a: List[Int] = List(1, 2, 3) @@ -183,12 +298,32 @@ val b: Set[Int] = Set(1, 2, 3) scala> val c = Map(1 -> 1, 2 -> 2) val c: Map[Int, Int] = Map(1 -> 1, 2 -> 2) ``` +{% endtab %} +{% endtabs %} ### 在任何地方使用导入 在 Scala 中，`import` 语句可以在任何地方。 它们可以在源代码文件的顶部使用： +{% tabs packaging-imports-14 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +package foo + +import scala.util.Random + +class ClassA { + def printRandom(): Unit = { + val r = new Random // use the imported class + // more code here... + } +} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-14 %} + ```scala package foo @@ -199,9 +334,33 @@ class ClassA: val r = new Random // use the imported class // more code here... ``` +{% endtab %} +{% endtabs %} 如果您愿意，您还可以使用更接近需要它们的点的 `import` 语句： +{% tabs packaging-imports-15 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +package foo + +class ClassA { + import scala.util.Random // inside ClassA + def printRandom(): Unit = { + val r = new Random + // more code here... + } +} + +class ClassB { + // the Random class is not visible here + val r = new Random // this code will not compile +} +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-15 %} + ```scala package foo @@ -216,24 +375,52 @@ class ClassB: val r = new Random // this code will not compile ``` +{% endtab %} +{% endtabs %} + ### “静态”导入 当您想以类似于 Java “静态导入”方法的方式导入成员时——因此您可以直接引用成员名称，而不必在它们前面加上类名——使用以下方法。 使用此语法导入 Java `Math` 类的所有静态成员： +{% tabs packaging-imports-16 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.lang.Math._ +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-16 %} + ```scala import java.lang.Math.* ``` +{% endtab %} +{% endtabs %} 现在您可以访问静态的 `Math` 类方法，例如 `sin` 和 `cos`，而不必在它们前面加上类名： +{% tabs packaging-imports-17 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.lang.Math._ + +val a = sin(0) // 0.0 +val b = cos(PI) // -1.0 +``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-17 %} + ```scala import java.lang.Math.* val a = sin(0) // 0.0 val b = cos(PI) // -1.0 ``` +{% endtab %} +{% endtabs %} ### 默认导入的包 @@ -250,17 +437,32 @@ Scala 对象 `Predef` 的成员也是默认导入的。 在极少数情况下会出现命名冲突，您需要从项目的根目录导入一些东西，在包名前加上 `_root_`： +{% tabs packaging-imports-18 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +package accounts + +import _root_.accounts._ ``` + +{% endtab %} +{% tab 'Scala 3' for=packaging-imports-18 %} + +```scala package accounts import _root_.accounts.* ``` +{% endtab %} +{% endtabs %} ## 导入 `given` 实例 正如您将在 [上下文抽象][contextual] 一章中看到的，`import` 语句的一种特殊形式用于导入 `given` 实例。 基本形式如本例所示： +{% tabs packaging-imports-19 %} +{% tab 'Scala 3 only' %} ```scala object A: class TC @@ -271,15 +473,21 @@ object B: import A.* // import all non-given members import A.given // import the given instance ``` +{% endtab %} +{% endtabs %} 在此代码中，对象 `B` 的 `import A.*` 子句导入了 `A` 的所有成员 *除了* `given` 实例 `tc`。 相反，第二个导入，`import A.given`，*仅*导入那个 `given` 实例。 两个 `import` 子句也可以合并为一个： +{% tabs packaging-imports-20 %} +{% tab 'Scala 3 only' %} ```scala object B: import A.{given, *} ``` +{% endtab %} +{% endtabs %} ### 讨论 @@ -297,20 +505,30 @@ object B: 由于给定可以是匿名的，因此按名称导入它们并不总是可行的，通常使用通配符导入。 *按类型导入* 为通配符导入提供了更具体的替代方案，这使得导入的内容更加清晰： +{% tabs packaging-imports-21 %} +{% tab 'Scala 3 only' %} ```scala import A.{given TC} ``` +{% endtab %} +{% endtabs %} 这会在 `A` 中导入任何具有符合 `TC` 的类型的 `given`。 导入多种类型的给定 `T1,...,Tn` 由多个 `given` 选择器表示： +{% tabs packaging-imports-22 %} +{% tab 'Scala 3 only' %} ```scala import A.{given T1, ..., given Tn} ``` +{% endtab %} +{% endtabs %} 导入参数化类型的所有 `given` 实例由通配符参数表示。 例如，当你有这个 `object` 时： +{% tabs packaging-imports-23 %} +{% tab 'Scala 3 only' %} ```scala object Instances: given intOrd as Ordering[Int] @@ -318,25 +536,38 @@ object Instances: given ec as ExecutionContext = ... given im as Monoid[Int] ``` +{% endtab %} +{% endtabs %} 此导入语句导入 `intOrd`、`listOrd` 和 `ec` 实例，但省略了 `im` 实例，因为它不符合任何指定的边界： +{% tabs packaging-imports-24 %} +{% tab 'Scala 3 only' %} ```scala import Instances.{given Ordering[?], given ExecutionContext} ``` +{% endtab %} +{% endtabs %} 按类型导入可以与按名称导入混合。 如果两者都存在于导入子句中，则按类型导入排在最后。 例如，这个 import 子句导入了 `im`、`intOrd` 和 `listOrd`，但省略了 `ec`： +{% tabs packaging-imports-25 %} +{% tab 'Scala 3 only' %} ```scala import Instances.{im, given Ordering[?]} ``` +{% endtab %} +{% endtabs %} ### 一个例子 作为一个具体的例子，假设你有这个 `MonthConversions` 对象，它包含两个 `given` 定义： +{% tabs packaging-imports-26 %} +{% tab 'Scala 3 only' %} + ```scala object MonthConversions: trait MonthConverter[A]: @@ -356,28 +587,45 @@ object MonthConversions: case "feb" => "February" // more cases here ... ``` +{% endtab %} +{% endtabs %} 要将这些给定导入当前范围，请使用以下两个 `import` 语句： +{% tabs packaging-imports-27 %} +{% tab 'Scala 3 only' %} + ```scala import MonthConversions.* import MonthConversions.{given MonthConverter[?]} ``` +{% endtab %} +{% endtabs %} 现在您可以创建一个使用这些 `given` 实例的方法： +{% tabs packaging-imports-28 %} +{% tab 'Scala 3 only' %} + ```scala def genericMonthConverter[A](a: A)(using monthConverter: MonthConverter[A]): String = monthConverter.convert(a) ``` +{% endtab %} +{% endtabs %} 然后您可以在您的应用程序中使用该方法： +{% tabs packaging-imports-29 %} +{% tab 'Scala 3 only' %} + ```scala @main def main = println(genericMonthConverter(1)) // January println(genericMonthConverter("jan")) // January ``` +{% endtab %} +{% endtabs %} 如前所述， `import given` 语法的主要设计优势之一是明确范围内的给定来自何处，并且在这些 `import` 语句中，很清楚地表明给定是来自 `MonthConversions` 对象。 From 9c1537771d9c45ed3f811c2b47816a4d36a02d29 Mon Sep 17 00:00:00 2001 From: dtv <77131156+dtv27@users.noreply.github.com> Date: Mon, 10 Apr 2023 15:39:18 +0900 Subject: [PATCH 2563/3075] Update package-objects.md fix: update typo --- _tour/package-objects.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/package-objects.md b/_tour/package-objects.md index c13ff9115c..52484564a9 100644 --- a/_tour/package-objects.md +++ b/_tour/package-objects.md @@ -7,7 +7,7 @@ num: 36 previous-page: packages-and-imports --- -Often, it is convenient to have definitions accessible accross an entire package, and not need to invent a +Often, it is convenient to have definitions accessible across an entire package, and not need to invent a name for a wrapper `object` to contain them. {% tabs pkg-obj-vs-top-lvl_1 class=tabs-scala-version %} From 931ecb42c6d3d7a5177ca3040e5c971570f5da6e Mon Sep 17 00:00:00 2001 From: adpi2 <adrien.piquerez@gmail.com> Date: Tue, 11 Apr 2023 17:22:28 +0200 Subject: [PATCH 2564/3075] Fix images in debugging compiler guide (#2763) * Fix images in debbuging compiler guide * Use sbt export instead of sbt show --- .../procedures-debugging.md | 13 ++++++------- .../scala3-contribution/create-config.jpg | Bin 112646 -> 140865 bytes .../launch-config-file.jpg | Bin 61631 -> 61379 bytes 3 files changed, 6 insertions(+), 7 deletions(-) diff --git a/_overviews/scala3-contribution/procedures-debugging.md b/_overviews/scala3-contribution/procedures-debugging.md index c57ff07591..d9411040af 100644 --- a/_overviews/scala3-contribution/procedures-debugging.md +++ b/_overviews/scala3-contribution/procedures-debugging.md @@ -56,23 +56,22 @@ First You can give a `name` to your configuration, for instance `Debug Scala 3 C The two most important parameters, to debug the compiler, are `mainClass` and `args`. The `mainClass` of the compiler is `dotty.tools.dotc.Main`. -In the `args` you need to specify the compiler arguments, which must contain at least a `.scala` file to compile and a `-classpath` option. +In the `args` you need to specify the compiler arguments, which must contain at least a Scala file to compile and a `-classpath` option. To start with, we can compile the `../tests/pos/HelloWorld.scala` file. In the classpath, we always need at least the `scala-library_2.13` and the bootstrapped `scala3-library_3`. -To locate them on your filesystem you can run the `show scala3-library-bootstrapped/fullClasspath` command in sbt. +To locate them on your filesystem you can run the `export scala3-library-bootstrapped/fullClasspath` command in sbt. ``` $ sbt -> show scala3-library-bootstrapped/fullClasspath -[info] * Attributed(/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes) -[info] * Attributed(/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar) +> export scala3-library-bootstrapped/fullClasspath +/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar [success] Total time: 1 s, completed Mar 10, 2023, 4:37:43 PM ``` Note that it is important to use the bootstrapped version of the `scala3-library` to get the correct TASTy version. -Additionally you can add the `["-color", "never"]` arguments to prevent the compiler from printing ANSI codes as strings in the debug console. +Additionally you can add the `-color` and `never` arguments to prevent the compiler from printing ANSI codes as strings in the debug console. Here is the final configuration: ```json @@ -84,7 +83,7 @@ Here is the final configuration: "args": [ "../tests/pos/HelloWorld.scala", "-classpath", - // to replace with your own paths + // To replace with your own paths "/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar", "-color", "never" diff --git a/resources/images/scala3-contribution/create-config.jpg b/resources/images/scala3-contribution/create-config.jpg index 271dcc865c516b33152d1d533e31d99341f0f5af..60479233ee70fba759eb065f07c42d7c73176a3f 100644 GIT binary patch literal 140865 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%0AB)6~Y0L!?GRdW!!)=l&q9SRw^mV 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 Vu|>SIXIDO${2BarqrtzI{|`LDS8@OV literal 112646 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�Bde;BsmxreC{>|811xP2Fgr_5k7OXb1LK4lq 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 Lj;LwN|2_X-|Av7N diff --git a/resources/images/scala3-contribution/launch-config-file.jpg b/resources/images/scala3-contribution/launch-config-file.jpg index 898987683f5887544a8c3a4c2227f659cfe8d198..4270f6b2326a8d430f16f98acc43fde7740659f2 100644 GIT binary patch delta 42664 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 R0|*F>9c`aK&;L95e*j*x3k(1N delta 42983 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.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 a)N@Mw>&L`pEGwAMP;@AA(pB;2^M3%?im8VH From 66a5a6252bcbff2d7c3dcf96fc5c3932d05736bb Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Wed, 12 Apr 2023 11:32:52 +0200 Subject: [PATCH 2565/3075] Update 2023-03-17-meeting.md --- _sips/results/2023-03-17-meeting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/results/2023-03-17-meeting.md b/_sips/results/2023-03-17-meeting.md index fd973b4be3..7c1ef1e50f 100644 --- a/_sips/results/2023-03-17-meeting.md +++ b/_sips/results/2023-03-17-meeting.md @@ -4,6 +4,6 @@ title: SIP Meeting Results - 17th March 2023 partof: results proposals: - url: https://docs.scala-lang.org/sips/scala-cli.html - name: SIP-46 - Drop Forwards Binary Compatibility of the Scala 2.13 Standard Library + name: SIP-46 - Scala CLI as default Scala command result: accepted --- From 6e286c475aa1a16ad5f7240abb8dcb039c269b0b Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 12 Apr 2023 06:25:44 +0000 Subject: [PATCH 2566/3075] Bump nokogiri from 1.14.2 to 1.14.3 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.14.2 to 1.14.3. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.14.2...v1.14.3) --- updated-dependencies: - dependency-name: nokogiri dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 6e65062be0..8b8491d093 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -219,7 +219,7 @@ GEM jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) minitest (5.18.0) - nokogiri (1.14.2-x86_64-linux) + nokogiri (1.14.3-x86_64-linux) racc (~> 1.4) octokit (4.25.1) faraday (>= 1, < 3) From b0684410b7469d4a91554ea06fe338f5d0eca4c4 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 12 Apr 2023 05:30:26 +0000 Subject: [PATCH 2567/3075] Bump commonmarker from 0.23.8 to 0.23.9 Bumps [commonmarker](https://github.com/gjtorikian/commonmarker) from 0.23.8 to 0.23.9. - [Release notes](https://github.com/gjtorikian/commonmarker/releases) - [Changelog](https://github.com/gjtorikian/commonmarker/blob/main/CHANGELOG.md) - [Commits](https://github.com/gjtorikian/commonmarker/compare/v0.23.8...v0.23.9) --- updated-dependencies: - dependency-name: commonmarker dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 8b8491d093..e616818b6b 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -13,7 +13,7 @@ GEM execjs coffee-script-source (1.11.1) colorator (1.1.0) - commonmarker (0.23.8) + commonmarker (0.23.9) concurrent-ruby (1.2.2) dnsruby (1.61.9) simpleidn (~> 0.1) From 05f996744d5e6c43b5053f50ba84fb4414f00ba6 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Wed, 12 Apr 2023 20:15:36 +0800 Subject: [PATCH 2568/3075] add code tab in _zh-cn/overviews/scala3-book/collections-classes.md (#2746) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: 梦境迷离 <568845948@qq.com> --- .../scala3-book/collections-classes.md | 263 +++++++++++++++++- 1 file changed, 254 insertions(+), 9 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/collections-classes.md b/_zh-cn/overviews/scala3-book/collections-classes.md index 307395fba9..c102860b53 100644 --- a/_zh-cn/overviews/scala3-book/collections-classes.md +++ b/_zh-cn/overviews/scala3-book/collections-classes.md @@ -119,6 +119,8 @@ NOTE: those images come from this page: https://docs.scala-lang.org/overviews/co 这是创建初始“列表”的方式： +{% tabs list-creation %} +{% tab 'Scala 2 and 3' %} ```scala val ints = List(1, 2, 3) val names = List("Joel", "Chris", "Ed") @@ -126,19 +128,36 @@ val names = List("Joel", "Chris", "Ed") // another way to construct a List val namesAgain = "Joel" :: "Chris" :: "Ed" :: Nil ``` +{% endtab %} +{% endtabs %} 如果您愿意，也可以声明 `List` 的类型，但通常不是必需的： +{% tabs list-type %} +{% tab 'Scala 2 and 3' %} ```scala val ints: List[Int] = List(1, 2, 3) val names: List[String] = List("Joel", "Chris", "Ed") ``` +{% endtab %} +{% endtabs %} 一个例外是集合中有混合类型时。在这种情况下，您可能需要明确指定其类型： +{% tabs list-mixed-types class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala val things: List[Any] = List(1, "two", 3.0) ``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +val things: List[String | Int | Double] = List(1, "two", 3.0) // with union types +val thingsAny: List[Any] = List(1, "two", 3.0) // with any +``` +{% endtab %} +{% endtabs %} ### 将元素添加到列表 @@ -146,16 +165,24 @@ val things: List[Any] = List(1, "two", 3.0) 相反，您可以通过将元素添加到现有 `List` 来创建新列表。 例如，给定这个 `List`： +{% tabs adding-elements-init %} +{% tab 'Scala 2 and 3' %} ```scala val a = List(1, 2, 3) ``` +{% endtab %} +{% endtabs %} 使用 `List` 时，用 `::` 来_附加_一个元素，用 `:::` 把另一个 `List` 插在这个 `List` 之前，如下所示： +{% tabs adding-elements-example %} +{% tab 'Scala 2 and 3' %} ```scala val b = 0 :: a // List(0, 1, 2, 3) val c = List(-1, 0) ::: a // List(-1, 0, 1, 2, 3) ``` +{% endtab %} +{% endtabs %} 你也可以在 `List` 中添加元素，但是因为 `List` 是一个单链表，你通常应该只在它前面添加元素； 在它的后面添加元素是一个相对较慢的操作，尤其是在处理大型序列时。 @@ -170,15 +197,23 @@ val c = List(-1, 0) ::: a // List(-1, 0, 1, 2, 3) 现在 IDE 为我们提供了极大的帮助，但是记住这些方法名称的一种方法是，认为 `:` 字符代表序列所在的一侧，因此当您使用 `+:` 时，您知道列表需要在右边，像这样： +{% tabs list-prepending %} +{% tab 'Scala 2 and 3' %} ```scala 0 +： a ``` +{% endtab %} +{% endtabs %} 同样，当您使用 `:+` 时，您知道列表需要在左侧： +{% tabs list-appending %} +{% tab 'Scala 2 and 3' %} ```scala a ：+ 4 ``` +{% endtab %} +{% endtabs %} 有更多的技术方法可以考虑这一点，但这可能是记住方法名称的有用方法。 @@ -194,24 +229,51 @@ LATER: Add a discussion of `:` on method names, right-associativity, and infix o 给定一个名称 `List`： +{% tabs list-loop-init %} +{% tab 'Scala 2 and 3' %} ```scala val names = List("Joel", "Chris", "Ed") ``` +{% endtab %} +{% endtabs %} 您可以像这样打印每个字符串： +{% tabs list-loop-example class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +for (name <- names) println(name) +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala for name <- names do println(name) ``` +{% endtab %} +{% endtabs %} 这是它在 REPL 中的样子： +{% tabs list-loop-repl class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +scala> for (name <- names) println(name) +Joel +Chris +Ed +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala scala> for name <-names do println(name) Joel Chris Ed ``` +{% endtab %} +{% endtabs %} 将 `for` 循环与集合一起使用的一个好处是 Scala 是一致的，并且相同的方法适用于所有序列，包括 `Array`、`ArrayBuffer`、`List`、`Seq`、`Vector`、`Map` ，`Set` 等。 @@ -220,22 +282,34 @@ Ed 对于那些对历史感兴趣的人，Scala `List` 类似于 [Lisp 编程语言](https://en.wikipedia.org/wiki/Lisp_(programming_language)) 中的 `List`，它是最初于 1958 年确定的。 实际上，除了像这样创建一个 `List` 之外： +{% tabs list-history-init %} +{% tab 'Scala 2 and 3' %} ```scala val ints = List(1, 2, 3) ``` +{% endtab %} +{% endtabs %} 您也可以通过这种方式创建完全相同的列表： +{% tabs list-history-init2 %} +{% tab 'Scala 2 and 3' %} ```scala val list = 1 :: 2 :: 3 :: Nil ``` +{% endtab %} +{% endtabs %} REPL 展示了它是如何工作的： +{% tabs list-history-repl %} +{% tab 'Scala 2 and 3' %} ```scala scala> val list = 1 :: 2 :: 3 :: Nil list: List[Int] = List(1, 2, 3) ``` +{% endtab %} +{% endtabs %} 这是因为 `List` 是一个以 `Nil` 元素结尾的单链表，而 `::` 是一个 `List` 方法，其工作方式类似于 Lisp 的“cons”运算符。 @@ -246,22 +320,30 @@ Scala 集合还包括一个 [LazyList](https://www.scala-lang.org/api/current/sc 你可以看到 REPL 中的 `LazyList` 有多懒惰： +{% tabs lazylist-example %} +{% tab 'Scala 2 and 3' %} ```scala val x = LazyList.range(1, Int.MaxValue) x.take(1) // LazyList(<not computed>) x.take(5) // LazyList(<not computed>) x.map(_ + 1) // LazyList(<not computed>) ``` +{% endtab %} +{% endtabs %} 在所有这些例子中，什么都没有发生。 事实上，除非你强迫它发生，否则什么都不会发生，例如通过调用它的 `foreach` 方法： -```` +{% tabs lazylist-evaluation-example %} +{% tab 'Scala 2 and 3' %} +```scala scala> x.take(1).foreach(println) 1 -```` +``` +{% endtab %} +{% endtabs %} -有关严格和非严格的用途、好处和缺点的更多信息严格（惰性）集合，请参阅 [The Architecture of Scala 2.13's Collections][strict] 页面上的“严格”和“非严格”讨论。 +有关严格和非严格的用途、好处和缺点的更多信息严格（惰性）集合，请参阅 [Scala 2.13集合的架构][strict] 页面上的“严格”和“非严格”讨论。 <!-- Given that definition, collections can also be thought of in terms of being strict or lazy. In a _strict_ collection, memory for the elements is allocated immediately, and all of its elements are immediately evaluated when a transformer method is invoked. In a _lazy_ collection, memory for the elements is not allocated immediately, and transformer methods do not construct new elements until they are demanded. @@ -276,6 +358,8 @@ Given that definition, collections can also be thought of in terms of being stri 以下是创建“向量”的几种方法： +{% tabs vector-creation %} +{% tab 'Scala 2 and 3' %} ```scala val nums = Vector(1, 2, 3, 4, 5) @@ -288,24 +372,34 @@ val people = Vector( Person("Grover") ) ``` +{% endtab %} +{% endtabs %} 因为 `Vector` 是不可变的，所以你不能向它添加新元素。 相反，您通过将元素附加或插入头部到现有的 `Vector`，从而创建新序列。 这些示例展示了如何将元素_附加_到 `Vector`： +{% tabs vector-appending %} +{% tab 'Scala 2 and 3' %} ```scala val a = Vector(1,2,3) // Vector(1, 2, 3) val b = a :+ 4 // Vector(1, 2, 3, 4) val c = a ++ Vector(4, 5) // Vector(1, 2, 3, 4, 5) ``` +{% endtab %} +{% endtabs %} 这就是你_插入头部_元素的方式： +{% tabs vector-prepending %} +{% tab 'Scala 2 and 3' %} ```scala val a = Vector(1,2,3) // Vector(1, 2, 3) val b = 0 +: a // Vector(0, 1, 2, 3) val c = Vector(-1, 0) ++: a // Vector(-1, 0, 1, 2, 3) ``` +{% endtab %} +{% endtabs %} 除了快速的随机访问和更新之外，`Vector` 还提供了快速的追加和前置时间，因此您可以根据需要使用这些功能。 @@ -313,6 +407,20 @@ val c = Vector(-1, 0) ++: a // Vector(-1, 0, 1, 2, 3) 最后，您可以在 `for` 循环中使用 `Vector`，就像 `List`、`ArrayBuffer` 或任何其他序列一样： +{% tabs vector-loop class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +scala> val names = Vector("Joel", "Chris", "Ed") +val names: Vector[String] = Vector(Joel, Chris, Ed) + +scala> for (name <- names) println(name) +Joel +Chris +Ed +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala scala> val names = Vector("Joel", "Chris", "Ed") val names: Vector[String] = Vector(Joel, Chris, Ed) @@ -322,6 +430,8 @@ Joel Chris Ed ``` +{% endtab %} +{% endtabs %} ## 数组缓冲区 @@ -333,27 +443,41 @@ Ed 要使用 `ArrayBuffer`，首先导入它： +{% tabs arraybuffer-import %} +{% tab 'Scala 2 and 3' %} ```scala import scala.collection.mutable.ArrayBuffer ``` +{% endtab %} +{% endtabs %} 如果您需要从一个空的 `ArrayBuffer` 开始，只需指定其类型： +{% tabs arraybuffer-creation %} +{% tab 'Scala 2 and 3' %} ```scala var strings = ArrayBuffer[String]() var ints = ArrayBuffer[Int]() var people = ArrayBuffer[Person]() ``` +{% endtab %} +{% endtabs %} 如果您知道 `ArrayBuffer` 最终需要的大致大小，则可以使用初始大小创建它： +{% tabs list-creation-with-size %} +{% tab 'Scala 2 and 3' %} ```scala // ready to hold 100,000 ints val buf = new ArrayBuffer[Int](100_000) ``` +{% endtab %} +{% endtabs %} 要创建具有初始元素的新 `ArrayBuffer`，只需指定其初始元素，就像 `List` 或 `Vector` 一样： +{% tabs arraybuffer-init %} +{% tab 'Scala 2 and 3' %} ```scala val nums = ArrayBuffer(1, 2, 3) val people = ArrayBuffer( @@ -362,6 +486,8 @@ val people = ArrayBuffer( Person("Grover") ) ``` +{% endtab %} +{% endtabs %} ### 将元素添加到数组缓冲区 @@ -370,35 +496,45 @@ val people = ArrayBuffer( 以下是 `+=` 和 `++=` 的一些示例： +{% tabs arraybuffer-add %} +{% tab 'Scala 2 and 3' %} ```scala val nums = ArrayBuffer(1, 2, 3) // ArrayBuffer(1, 2, 3) -language: zh-cn nums += 4 // ArrayBuffer(1, 2, 3, 4) -language: zh-cn nums ++= List(5, 6) // ArrayBuffer(1, 2, 3, 4, 5, 6) ``` +{% endtab %} +{% endtabs %} ### 从数组缓冲区中移除元素 `ArrayBuffer` 是可变的，所以它有 `-=`、`--=`、`clear`、`remove` 等方法。 这些示例演示了 `-=` 和 `--=` 方法： +{% tabs arraybuffer-remove %} +{% tab 'Scala 2 and 3' %} ```scala val a = ArrayBuffer.range('a', 'h') // ArrayBuffer(a, b, c, d, e, f, g) a -= 'a' // ArrayBuffer(b, c, d, e, f, g) a --= Seq('b', 'c') // ArrayBuffer(d, e, f, g) a --= Set('d', 'e') // ArrayBuffer(f, g) ``` +{% endtab %} +{% endtabs %} ### 更新数组缓冲区元素 通过重新分配所需元素或使用 `update` 方法来更新 `ArrayBuffer` 中的元素： +{% tabs arraybuffer-update %} +{% tab 'Scala 2 and 3' %} ```scala val a = ArrayBuffer.range(1,5) // ArrayBuffer(1, 2, 3, 4) a(2) = 50 // ArrayBuffer(1, 2, 50, 4) a.update(0, 10) // ArrayBuffer(10, 2, 50, 4) ``` +{% endtab %} +{% endtabs %} ## 映射 @@ -409,6 +545,8 @@ Scala 有可变和不可变的 `Map` 类型，本节演示如何使用_不可变 像这样创建一个不可变的`Map`： +{% tabs map-init %} +{% tab 'Scala 2 and 3' %} ```scala val states = Map( "AK" -> "Alaska", @@ -416,30 +554,59 @@ val states = Map( "AZ" -> "Arizona" ) ``` +{% endtab %} +{% endtabs %} 一旦你有了一个`Map`，你可以像这样在`for`循环中遍历它的元素： +{% tabs map-loop class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +for ((k, v) <- states) println(s"key: $k, value: $v") +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala for (k, v) <- states do println(s"key: $k, value: $v") ``` +{% endtab %} +{% endtabs %} REPL 展示了它是如何工作的： -```` +{% tabs map-repl class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +scala> for ((k, v) <- states) println(s"key: $k, value: $v") +key: AK, value: Alaska +key: AL, value: Alabama +key: AZ, value: Arizona +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala scala> for (k, v) <- states do println(s"key: $k, value: $v") key: AK, value: Alaska key: AL, value: Alabama key: AZ, value: Arizona -```` +``` +{% endtab %} +{% endtabs %} ### 访问映射元素 通过在括号中指定所需的键值来访问映射元素： +{% tabs map-access-element %} +{% tab 'Scala 2 and 3' %} ```scala val ak = states("AK") // ak: String = Alaska val al = states("AL") // al: String = Alabama ``` +{% endtab %} +{% endtabs %} 在实践中，您还将使用诸如 `keys`、`keySet`、`keysIterator`、`for` 循环之类的方法以及 `map` 之类的高阶函数来处理 `Map` 键和值。 @@ -447,6 +614,8 @@ val al = states("AL") // al: String = Alabama 使用 `+` 和 `++` 将元素添加到不可变映射中，记住将结果分配给新变量： +{% tabs map-add-element %} +{% tab 'Scala 2 and 3' %} ```scala val a = Map(1 -> "one") // a: Map(1 -> one) val b = a + (2 -> "two") // b: Map(1 -> one, 2 -> two) @@ -456,11 +625,15 @@ val c = b ++ Seq( ) // c: Map(1 -> one, 2 -> two, 3 -> three, 4 -> four) ``` +{% endtab %} +{% endtabs %} ### 从映射中删除元素 使用 `-` 或 `--` 和要删除的键值从不可变映射中删除元素，记住将结果分配给新变量： +{% tabs map-remove-element %} +{% tab 'Scala 2 and 3' %} ```scala val a = Map( 1 -> "one", @@ -472,11 +645,15 @@ val a = Map( val b = a - 4 // b: Map(1 -> one, 2 -> two, 3 -> three) val c = a - 4 - 3 // c: Map(1 -> one, 2 -> two) ``` +{% endtab %} +{% endtabs %} ### 更新映射元素 要更新不可变映射中的元素，请在将结果分配给新变量时使用 `updated` 方法（或 `+` 运算符）： +{% tabs map-update-element %} +{% tab 'Scala 2 and 3' %} ```scala val a = Map( 1 -> "one", @@ -487,11 +664,27 @@ val a = Map( val b = a.updated(3, "THREE!") // b: Map(1 -> one, 2 -> two, 3 -> THREE!) val c = a + (2 -> "TWO...") // c: Map(1 -> one, 2 -> TWO..., 3 -> three) ``` +{% endtab %} +{% endtabs %} ### 遍历映射 如前所述，这是使用 `for` 循环手动遍历映射中元素的常用方法： +{% tabs map-traverse class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val states = Map( + "AK" -> "Alaska", + "AL" -> "Alabama", + "AZ" -> "Arizona" +) + +for ((k, v) <- states) println(s"key: $k, value: $v") +``` +{% endtab %} + +{% tab 'Scala 3' %} ```scala val states = Map( "AK" -> "Alaska", @@ -501,6 +694,8 @@ val states = Map( for (k, v) <- states do println(s"key: $k, value: $v") ``` +{% endtab %} +{% endtabs %} 话虽如此，有_许多_方法可以使用映射中的键和值。 常见的 `Map` 方法包括 `foreach`、`map`、`keys` 和 `values`。 @@ -518,27 +713,39 @@ Scala 有可变和不可变的 `Set` 类型。 像这样创建新的空集： +{% tabs set-creation %} +{% tab 'Scala 2 and 3' %} ```scala val nums = Set[Int]() val letters = Set[Char]() ``` +{% endtab %} +{% endtabs %} 使用初始数据创建集合，如下： +{% tabs set-init %} +{% tab 'Scala 2 and 3' %} ```scala val nums = Set(1, 2, 3, 3, 3) // Set(1, 2, 3) val letters = Set('a', 'b', 'c', 'c') // Set('a', 'b', 'c') ``` +{% endtab %} +{% endtabs %} ### 向集合中添加元素 使用 `+` 和 `++` 将元素添加到不可变的 `Set`，记住将结果分配给一个新变量： +{% tabs set-add-element %} +{% tab 'Scala 2 and 3' %} ```scala val a = Set(1, 2) // Set(1, 2) val b = a + 3 // Set(1, 2, 3) val c = b ++ Seq(4, 1, 5, 5) // HashSet(5, 1, 2, 3, 4) ``` +{% endtab %} +{% endtabs %} 请注意，当您尝试添加重复元素时，它们会被悄悄删除。 @@ -548,11 +755,15 @@ val c = b ++ Seq(4, 1, 5, 5) // HashSet(5, 1, 2, 3, 4) 使用 `-` 和 `--` 从不可变集合中删除元素，再次将结果分配给新变量： +{% tabs set-remove-element %} +{% tab 'Scala 2 and 3' %} ```scala val a = Set(1, 2, 3, 4, 5) // HashSet(5, 1, 2, 3, 4) val b = a - 5 // HashSet(1, 2, 3, 4) val c = b -- Seq(3, 4) // HashSet(1, 2) ``` +{% endtab %} +{% endtabs %} ## 范围 @@ -563,39 +774,66 @@ Scala `Range` 通常用于填充数据结构和迭代 `for` 循环。 LATER: the dotty repl currently shows results differently {% endcomment %} +{% tabs range-init %} +{% tab 'Scala 2 and 3' %} ```scala 1 to 5 // Range(1, 2, 3, 4, 5) 1 until 5 // Range(1, 2, 3, 4) 1 to 10 by 2 // Range(1, 3, 5, 7, 9) 'a' to 'c' // NumericRange(a, b, c) ``` +{% endtab %} +{% endtabs %} 您可以使用范围来填充集合： +{% tabs range-conversion %} +{% tab 'Scala 2 and 3' %} ```scala val x = (1 to 5).toList // List(1, 2, 3, 4, 5) val x = (1 to 5).toBuffer // ArrayBuffer(1, 2, 3, 4, 5) ``` +{% endtab %} +{% endtabs %} 它们也用于 `for` 循环： -```` +{% tabs range-iteration class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +scala> for (i <- 1 to 3) println(i) +1 +2 +3 +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala scala> for i <- 1 to 3 do println(i) 1 2 3 -```` +``` +{% endtab %} +{% endtabs %} 还有 `range` 方法： +{% tabs range-methods %} +{% tab 'Scala 2 and 3' %} ```scala Vector.range(1, 5) // Vector(1, 2, 3, 4) List.range(1, 10, 2) // List(1, 3, 5, 7, 9) Set.range(1, 10) // HashSet(5, 1, 6, 9, 2, 7, 3, 8, 4) ``` +{% endtab %} +{% endtabs %} 当您运行测试时，范围对于生成​​测试集合也很有用： +{% tabs range-tests %} +{% tab 'Scala 2 and 3' %} ```scala val evens = (0 to 10 by 2).toList // List(0, 2, 4, 6, 8, 10) val odds = (1 to 10 by 2).toList // List(1, 3, 5, 7, 9) @@ -605,6 +843,8 @@ val doubles = (1 to 5).map(_ * 2.0) // Vector(2.0, 4.0, 6.0, 8.0, 10.0) val map = (1 to 3).map(e => (e,s"$e")).toMap // map: Map[Int, String] = Map(1 -> "1", 2 -> "2", 3 -> "3") ``` +{% endtab %} +{% endtabs %} ## 更多细节 @@ -614,3 +854,8 @@ val map = (1 to 3).map(e => (e,s"$e")).toMap - [具体的可变集合类](https://docs.scala-lang.org/overviews/collections-2.13/concrete-mutable-collection-classes.html) - [集合是如何构造的？ 我应该选择哪一个？](https://docs.scala-lang.org/tutorials/FAQ/collections.html) + +[strict]: {% link _overviews/core/architecture-of-scala-213-collections.md %} +[collections1]: /resources/images/tour/collections-diagram-213.svg +[collections2]: /resources/images/tour/collections-immutable-diagram-213.svg +[collections3]: /resources/images/tour/collections-mutable-diagram-213.svg From b26b7c503b84611441892c34c5342a5d6d929848 Mon Sep 17 00:00:00 2001 From: Mike Lee <mlee@demandbase.com> Date: Wed, 15 Mar 2023 19:59:46 -0400 Subject: [PATCH 2569/3075] fix typo in `start-intro.md` --- _overviews/scala3-contribution/start-intro.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-contribution/start-intro.md b/_overviews/scala3-contribution/start-intro.md index 4a2e111699..1ad97dc2f6 100644 --- a/_overviews/scala3-contribution/start-intro.md +++ b/_overviews/scala3-contribution/start-intro.md @@ -11,7 +11,7 @@ next-page: procedures-intro ### Scala CLA -Sometime before submitting you're pull request you'll want to make sure you have +Sometime before submitting your pull request you'll want to make sure you have signed the [Scala CLA][scala-cla]. You can read more about why we require a CLA and what exactly is included in it [here][scala-cla]. @@ -21,7 +21,7 @@ Before digging into an issue or starting on a new feature it's a good idea to make sure an [issue][dotty-issue] or a [discussion][dotty-discussion] has been created outlining what you plan to work on. This is both for your and the team's benefit. It ensures you get the help you need, and also gives the compiler team -a heads up that someone is working on an issue. +a heads-up that someone is working on an issue. For some small changes like documentation, this isn't always necessary, but it's never a bad idea to check. From d66d7667f8951dd2dc393de39d83b0f22d596cb2 Mon Sep 17 00:00:00 2001 From: Quentin Bernet <quentin.bernet@epfl.ch> Date: Wed, 12 Apr 2023 14:31:15 +0200 Subject: [PATCH 2570/3075] Add links to debugger in inspection article (#2762) --- _overviews/scala3-contribution/procedures-inspection.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-contribution/procedures-inspection.md b/_overviews/scala3-contribution/procedures-inspection.md index 6876882e41..891f3ee5eb 100644 --- a/_overviews/scala3-contribution/procedures-inspection.md +++ b/_overviews/scala3-contribution/procedures-inspection.md @@ -13,7 +13,9 @@ while the compiler is running, and inspect produced artifacts of the compiler. ## Inspecting variables in-place Frequently you will need to inspect the content of a particular variable. -Often, it is sufficient to use `println`. +You can either use `println`s or the debugger, more info on how to setup the latter [here]({% link _overviews/scala3-contribution/procedures-debugging.md %}). + +In the remeainder of this article we'll use `println(<someUsefulExpression>)` inserted in the code, but the same effect can be accomplished by stopping at a breakpoint, and typing `<someUsefulExpression>` in the [debug console]({% link _overviews/scala3-contribution/procedures-debugging.md %}#the-debug-console) of the debugger. When printing a variable, it's always a good idea to call `show` on that variable: `println(x.show)`. Many objects of the compiler define `show`, returning a human-readable string. From d9d3bb1e8efa045ef7bc11e46e20ef76b49ecf87 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Wed, 12 Apr 2023 22:19:27 +0800 Subject: [PATCH 2571/3075] update Chinese translation according to latest English version (#2678) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Dongxu Wang <dongxu@apache.org> Co-authored-by: 梦境迷离 <568845948@qq.com> --- _zh-cn/overviews/core/futures.md | 1369 +++++++++++++++++++++++------- 1 file changed, 1066 insertions(+), 303 deletions(-) diff --git a/_zh-cn/overviews/core/futures.md b/_zh-cn/overviews/core/futures.md index c37b66efe5..97f64ed7aa 100644 --- a/_zh-cn/overviews/core/futures.md +++ b/_zh-cn/overviews/core/futures.md @@ -11,491 +11,1254 @@ language: zh-cn ## 简介 -Future提供了一套高效便捷的非阻塞并行操作管理方案。其基本思想很简单，所谓Future，指的是一类占位符对象，用于指代某些尚未完成的计算的结果。一般来说，由Future指代的计算都是并行执行的，计算完毕后可另行获取相关计算结果。以这种方式组织并行任务，便可以写出高效、异步、非阻塞的并行代码。 +Future提供了一套高效便捷的非阻塞并行操作管理方案。其基本思想很简单，所谓 [`Future`](https://www.scala-lang.org/api/current/scala/concurrent/Future.html)，指的是一类占位符对象，用于指代某些尚未完成的计算的结果。一般来说，由Future指代的计算都是并行执行的，计算完毕后可另行获取相关计算结果。以这种方式组织并行任务，便可以写出高效、异步、非阻塞的并行代码。 -默认情况下，future和promise并不采用一般的阻塞操作，而是依赖回调进行非阻塞操作。为了在语法和概念层面更加简明扼要地使用这些回调，Scala还提供了flatMap、foreach和filter等算子，使得我们能够以非阻塞的方式对future进行组合。当然，future仍然支持阻塞操作——必要时，可以阻塞等待future（不过并不鼓励这样做）。 +默认情况下，future和promise并不采用一般的阻塞操作，而是依赖回调进行非阻塞操作。为了在语法和概念层面更加简明扼要地使用这些回调，Scala还提供了 `flatMap`、`foreach` 和 `filter` 等算子，使得我们能够以非阻塞的方式对future进行组合。 +当然，future仍然支持阻塞操作——必要时，可以阻塞等待future（不过并不鼓励这样做）。 + +<!-- +The futures and promises API builds upon the notion of an +`ExecutionContext`, an execution environment designed to manage +resources such as thread pools between parallel frameworks and +libraries (detailed in an accompanying SIP, forthcoming). Futures and +promises are created through such `ExecutionContext`s. For example, this makes it possible, +in the case of an application which requires blocking futures, for an underlying execution +environment to resize itself if necessary to guarantee progress. +--> + +典型的 future 像这样： + +{% tabs futures-00 %} +{% tab 'Scala 2 and 3' for=futures-00 %} + +```scala +val inverseFuture: Future[Matrix] = Future { + fatMatrix.inverse() // non-blocking long lasting computation +}(executionContext) +``` + +{% endtab %} +{% endtabs %} + +或者更习惯的用法： + +{% tabs futures-01 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-01 %} + +```scala +implicit val ec: ExecutionContext = ... +val inverseFuture : Future[Matrix] = Future { + fatMatrix.inverse() +} // ec is implicitly passed +``` + +{% endtab %} + +{% tab 'Scala 3' for=futures-01 %} + +```scala +given ExecutionContext = ... +val inverseFuture : Future[Matrix] = Future { + fatMatrix.inverse() +} // execution context is implicitly passed +``` + +{% endtab %} +{% endtabs %} + +这两个代码片段都将 `fatMatrix.inverse()` 的执行委托给 `ExecutionContext`，并在 `inverseFuture` 中体现计算结果。 + +## 执行上下文 + +Future 和 Promises 围绕 [`ExecutionContext`s](https://www.scala-lang.org/api/current/scala/concurrent/ExecutionContext.html) 展开，负责执行计算。 + +`ExecutionContext` 类似于 [Executor](https://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Executor.html)： +它可以在新线程、线程池或当前线程中自由地执行计算（尽管不鼓励在当前线程中执行计算 -- 更多内容见下文）。 + +`scala.concurrent` 包是开箱即用的，它带有 `ExecutionContext` 实现，一个全局静态线程池。 +它也可以将 `Exector` 转换为 `ExecutionContext`。 +最后，用户可以自由扩展 `ExecutionContext` trait来实现自己的执行上下文，但只有极少数情况下需要这么做。 + +### 全局执行上下文 + +`ExecutionContext.global` 是由 [ForkJoinPool](https://docs.oracle.com/javase/tutorial/essential/concurrency/forkjoin.html) 支持的 `ExecutionContext`。 +它应该满足大部分情况，但有几点需要注意。 +`ForkJoinPool` 管理有限数量的线程（线程的最大数量由 *parallelism level* 指定）。 +仅当每个阻塞调用都包装在 `blocking` 调用中时（更多内容见下文），并发阻塞计算的数量才能超过并行度级别。 +否则，全局执行上下文中的线程池会有饥饿死锁风险，致使任何计算无法继续进行。 +缺省情况下，`ExecutionContext.global` 将其底层ForkJoin连接池的并行级别设置为可用处理器的数量([Runtime.availableProcessors](https://docs.oracle.com/javase/7/docs/api/java/lang/Runtime.html#availableProcessors%28%29))。 +通过设置以下一个（或多个） VM 属性，来重载这个设置： + + * scala.concurrent.context.minThreads - 缺省为 `Runtime.availableProcessors` + * scala.concurrent.context.numThreads - 可以是一个数字，或者是 “xN” 这样形式中的乘数（N）；缺省为 `Runtime.availableProcessors` + * scala.concurrent.context.maxThreads - 缺省为 `Runtime.availableProcessors` + +只要并行度的数值在 `[minThreads; maxThreads]` 范围内，它就可以给 `numThreads` 赋值。 + +如上所述，在存在阻塞计算的情况下，`ForkJoinPool` 可以将线程数增加到超过 `parallelismLevel`。 +如 `ForkJoinPool` API 中所述，这只有在明确通知 `ForkJoinPool` 时才有可能： + +{% tabs futures-02 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-02 %} + +```scala +import scala.concurrent.{ Future, ExecutionContext } +import scala.concurrent.forkjoin._ + +// the following is equivalent to `implicit val ec = ExecutionContext.global` +import ExecutionContext.Implicits.global + +Future { + ForkJoinPool.managedBlock( + new ManagedBlocker { + var done = false + + def block(): Boolean = { + try { + myLock.lock() + // ... + } finally { + done = true + } + true + } + + def isReleasable: Boolean = done + } + ) +} +``` + +{% endtab %} +{% tab 'Scala 3' for=futures-02 %} + +```scala +import scala.concurrent.{ Future, ExecutionContext } +import scala.concurrent.forkjoin.* + +// the following is equivalent to `given ExecutionContext = ExecutionContext.global` +import ExecutionContext.Implicits.global + +Future { + ForkJoinPool.managedBlock( + new ManagedBlocker { + var done = false + + def block(): Boolean = + try + myLock.lock() + // ... + finally + done = true + true + + def isReleasable: Boolean = done + } + ) +} +``` +{% endtab %} +{% endtabs %} + +幸运的是，并发包为这提供了便捷的方法： + +{% tabs blocking %} +{% tab 'Scala 2 and 3' for=blocking %} + +```scala +import scala.concurrent.Future +import scala.concurrent.blocking + +Future { + blocking { + myLock.lock() + // ... + } +} +``` + +{% endtab %} +{% endtabs %} + +注意 `blocking` 是一个通用结构，它将会在[下面](#future-内的阻塞)作深入探讨。 + +最后你必须记住 `ForkJoinPool` 不是设计用来长连接阻塞操作。 +即使收到 `blocking` 通知，池也可能无法像预期的那样生成新工作，而创建新工作线程时，它们的数量也可能多达 32767。 +为了给您有个概念，以下代码将使用 32000 个线程： + +{% tabs futures-03 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-03 %} + +```scala +implicit val ec = ExecutionContext.global + +for (i <- 1 to 32000) { + Future { + blocking { + Thread.sleep(999999) + } + } +} +``` + +{% endtab %} +{% tab 'Scala 3' for=futures-03 %} + +```scala +given ExecutionContext = ExecutionContext.global + +for i <- 1 to 32000 do + Future { + blocking { + Thread.sleep(999999) + } + } +``` + +{% endtab %} +{% endtabs %} + +如果您需要包装持久的阻塞操作，我们建议使用专用的 `ExecutionContext`，例如通过包装Java 的 `Executor`。 + +### 适配 Java Executor + +使用 `ExecutionContext.fromExecutor` 方法，你可以把 `Executor` 包装进 `ExecutionContext`。 +例如： + +{% tabs executor class=tabs-scala-version %} +{% tab 'Scala 2' for=executor %} + +```scala +ExecutionContext.fromExecutor(new ThreadPoolExecutor( /* your configuration */ )) +``` + +{% endtab %} +{% tab 'Scala 3' for=executor %} + +```scala +ExecutionContext.fromExecutor(ThreadPoolExecutor( /* your configuration */ )) +``` + +{% endtab %} +{% endtabs %} + +### 同步执行上下文 + +也许试图得到一个在当前线程中运行计算的 `ExecutionContext`： + +{% tabs bad-example %} +{% tab 'Scala 2 and 3' for=bad-example %} + +```scala +val currentThreadExecutionContext = ExecutionContext.fromExecutor( + new Executor { + // Do not do this! + def execute(runnable: Runnable) = runnable.run() + }) +``` + +{% endtab %} +{% endtabs %} + +应该避免这种情况，因为它会在执行 future 时引入不确定性。 + +{% tabs bad-example-2 %} +{% tab 'Scala 2 and 3' for=bad-example-2 %} + +```scala +Future { + doSomething +}(ExecutionContext.global).map { + doSomethingElse +}(currentThreadExecutionContext) +``` + +{% endtab %} +{% endtabs %} + +`doSomethingElse` 调用，可能在 `doSomething` 的线程中执行或者在主线程中执行，这样可以是同步的或者是异步的。 +正如[这里](https://blog.ometer.com/2011/07/24/callbacks-synchronous-and-asynchronous/)解释的，一个调用不能两者都是。 ## Future 所谓Future，是一种用于指代某个尚未就绪的值的对象。而这个值，往往是某个计算过程的结果： -- 若该计算过程尚未完成，我们就说该Future未就位； -- 若该计算过程正常结束，或中途抛出异常，我们就说该Future已就位。 +1. 若该计算过程尚未完成，我们就说该Future **未就位**； +2. 若该计算过程正常结束，或中途抛出异常，我们就说该Future **已就位**。 Future的就位分为两种情况： -- 当Future带着某个值就位时，我们就说该Future携带计算结果成功就位。 -- 当Future因对应计算过程抛出异常而就绪，我们就说这个Future因该异常而失败。 +1. 当 `Future` 带着某个值就位时，我们就说该 future 携带计算结果**成功就位**。 +2. 当 `Future` 因对应计算过程抛出异常而就绪，我们就说这个 future因该异常而**失败**。 -Future的一个重要属性在于它只能被赋值一次。一旦给定了某个值或某个异常，future对象就变成了不可变对象——无法再被改写。 +`Future` 的一个重要属性在于它只能被赋值一次。一旦给定了某个值或某个异常，`Future` 对象就变成了不可变对象——无法再被改写。 -创建future对象最简单的方法是调用future方法，该future方法启用异步(asynchronous)计算并返回保存有计算结果的futrue，一旦该future对象计算完成，其结果就变的可用。 +创建future对象最简单的方法是调用 `Future.apply` 方法，该future方法启用异步(asynchronous)计算并返回保存有计算结果的futrue，一旦该future对象计算完成，其结果就变的可用。 -注意_Future[T]_ 是表示future对象的类型，而future是方法，该方法创建和调度一个异步计算，并返回随着计算结果而完成的future对象。 +注意 _Future[T]_ 是表示future对象的类型，而 `Future.apply` 是方法，该方法创建和调度一个异步计算，并返回随着计算结果而完成的future对象。 这最好通过一个例子予以说明。 假设我们使用某些流行的社交网络的假定API获取某个用户的朋友列表，我们将打开一个新对话(session)，然后发送一个请求来获取某个特定用户的好友列表。 - import scala.concurrent._ - import ExecutionContext.Implicits.global +{% tabs futures-04 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-04 %} - val session = socialNetwork.createSessionFor("user", credentials) - val f: Future[List[Friend]] = Future { - session.getFriends() - } +```scala +import scala.concurrent._ +import ExecutionContext.Implicits.global -以上，首先导入scala.concurrent 包使得Future类型和future构造函数可见。我们将马上解释第二个导入。 +val session = socialNetwork.createSessionFor("user", credentials) +val f: Future[List[Friend]] = Future { + session.getFriends() +} +``` -然后我们初始化一个session变量来用作向服务器发送请求，用一个假想的 createSessionFor 方法来返回一个List[Friend]。为了获得朋友列表，我们必须通过网络发送一个请求，这个请求可能耗时很长。这能从调用getFriends方法得到解释。为了更好的利用CPU，响应到达前不应该阻塞(block)程序的其他部分执行，于是在计算中使用异步。future方法就是这样做的，它并行地执行指定的计算块，在这个例子中是向服务器发送请求和等待响应。 +{% endtab %} +{% tab 'Scala 3' for=futures-04 %} -一旦服务器响应，future f 中的好友列表将变得可用。 +```scala +import scala.concurrent.* +import ExecutionContext.Implicits.global -未成功的尝试可能会导致一个异常(exception)。在下面的例子中，session的值未被正确的初始化，于是在future的计算中将抛出NullPointerException，future f 不会圆满完成，而是以此异常失败。 +val session = socialNetwork.createSessionFor("user", credentials) +val f: Future[List[Friend]] = Future { + session.getFriends() +} +``` - val session = null - val f: Future[List[Friend]] = Future { - session.getFriends - } +{% endtab %} +{% endtabs %} -`import ExecutionContext.Implicits.global` 上面的线条导入默认的全局执行上下文(global execution context)，执行上下文执行执行提交给他们的任务，也可把执行上下文看作线程池，这对于future方法来说是必不可少的，因为这可以处理异步计算如何及何时被执行。我们可以定义自己的执行上下文，并在future上使用它，但是现在只需要知道你能够通过上面的语句导入默认执行上下文就足够了。 +以上，首先导入 `scala.concurrent` 包使得 `Future` 类型可见。 +我们将马上解释第二个导入。 -我们的例子是基于一个假定的社交网络API，此API的计算包含发送网络请求和等待响应。提供一个涉及到你能试着立即使用的异步计算的例子是公平的。假设你有一个文本文件，你想找出一个特定的关键字第一次出现的位置。当磁盘正在检索此文件内容时，这种计算可能会陷入阻塞，因此并行的执行该操作和程序的其他部分是合理的(make sense)。 +然后我们用一个假想的 `createSessionFor` 方法去初始化一个session变量，该变量用作向服务器发送请求。 +为了获得朋友列表，我们必须通过网络发送一个请求，这个请求可能耗时很长。 +这能从调用 `getFriends` 方法得到解释，该方法返回 `List[Friend]`。 +为了更好的利用CPU，响应到达前不应该阻塞(block)程序的其他部分执行，于是在计算中使用异步。`Future.apply` 方法就是这样做的，它并行地执行指定的计算块，在这个例子中是向服务器发送请求和等待响应。 - val firstOccurrence: Future[Int] = Future { - val source = scala.io.Source.fromFile("myText.txt") - source.toSeq.indexOfSlice("myKeyword") - } +一旦服务器响应，future `f` 中的好友列表将变得可用。 + +未成功的尝试可能会导致一个异常(exception)。在下面的例子中，`session` 的值未被正确的初始化，于是在 `Future` 阻塞中的计算将抛出 `NullPointerException`。 +该future `f` 不会圆满完成，而是以此异常失败： + +{% tabs futures-04b %} +{% tab 'Scala 2 and 3' for=futures-04b %} + +```scala +val session = null +val f: Future[List[Friend]] = Future { + session.getFriends +} +``` + +{% endtab %} +{% endtabs %} + +上面 `import ExecutionContext.Implicits.global` 这行，导入默认的全局执行上下文(global execution context)。 +执行上下文执行提交给他们的任务，也可把执行上下文看作线程池。 +这对于 `Future.apply` 方法来说是必不可少的，因为这可以处理异步计算如何及何时被执行。 +可以定义自己的执行上下文，并在 `Future` 上使用它，但是现在只需要知道你能够通过上面的语句导入默认执行上下文就足够了。 + +我们的例子是基于一个假定的社交网络 API，此 API 的计算包含发送网络请求和等待响应。 +提供一个涉及到你能试着立即使用的异步计算的例子是公平的。假设你有一个文本文件，你想找出一个特定的关键字第一次出现的位置。 +当磁盘正在检索此文件内容时，这种计算可能会陷入阻塞，因此并行的执行该操作和程序的其他部分是合理的(make sense)。 + +{% tabs futures-04c %} +{% tab 'Scala 2 and 3' for=futures-04c %} + +```scala +val firstOccurrence: Future[Int] = Future { + val source = scala.io.Source.fromFile("myText.txt") + source.toSeq.indexOfSlice("myKeyword") +} +``` + +{% endtab %} +{% endtabs %} ### Callbacks(回调函数) -现在我们知道如何开始一个异步计算来创建一个新的future值，但是我们没有展示一旦此结果变得可用后如何来使用，以便我们能够用它来做一些有用的事。我们经常对计算结果感兴趣而不仅仅是它的副作用。 +现在我们知道如何开始一个异步计算来创建一个新的future值，但是我们没有展示一旦此结果变得可用后如何来使用，以便我们能够用它来做一些有用的事。 +我们经常对计算结果感兴趣而不仅仅是它的副作用。 -在许多future的实现中，一旦future的client对future的结果感兴趣，它不得不阻塞它自己的计算直到future完成——然后才能使用future的值继续它自己的计算。虽然这在Scala的Future API（在后面会展示）中是允许的，但是从性能的角度来看更好的办法是一种完全非阻塞的方法，即在future中注册一个回调，future完成后这个回调称为异步回调。如果当注册回调时future已经完成，则回调可能是异步执行的，或在相同的线程中循序执行。 +在许多future的实现中，一旦future的client对future的结果感兴趣，它不得不阻塞它自己的计算直到future完成——然后才能使用future的值继续它自己的计算。 +虽然这在Scala的Future API（在后面会展示）中是允许的，但是从性能的角度来看更好的办法是一种完全非阻塞的方法，即在future中注册一个回调。 +future 完成后这个回调称为异步回调。如果当注册回调时 future 已经完成，则回调可能是异步执行的，或在相同的线程中循序执行。 -注册回调最通常的形式是使用OnComplete方法，即创建一个`Try[T] => U`类型的回调函数。如果future成功完成，回调则会应用到Success[T]类型的值中，否则应用到` Failure[T] `类型的值中。 +注册回调最通常的形式是使用 `OnComplete` 方法，即创建一个``Try[T] => U` 类型的回调函数。 +如果future成功完成，回调则会应用到 `Success[T]` 类型的值中，否则应用到 `Failure[T]` 类型的值中。 - `Try[T]` 和`Option[T]`或 `Either[T, S]`相似，因为它是一个可能持有某种类型值的单子。然而，它是特意设计来保持一个值或某个可抛出(throwable)对象。`Option[T]` 既可以是一个值（如：`Some[T]`）也可以是完全无值（如：`None`），如果`Try[T]`获得一个值则它为`Success[T]` ，否则为`Failure[T]`的异常。 `Failure[T]` 获得更多的关于为什么这儿没值的信息，而不仅仅是None。同时也可以把`Try[T]`看作一种特殊版本的`Either[Throwable, T]`，专门用于左值为可抛出类型(Throwable)的情形。 + `Try[T]` 和`Option[T]`或 `Either[T, S]`相似，因为它是一个可能持有某种类型值的单子。 + 然而，它是特意设计来保持一个值或某个可抛出(throwable)对象。 + `Option[T]` 既可以是一个值（如：`Some[T]`）也可以是完全无值（如：`None`），如果 `Try[T]` 获得一个值则它为 `Success[T]`，否则为 `Failure[T]` 的异常。`Failure[T]` 获得更多的关于为什么这儿没值的信息，而不仅仅是 `None`。 + 同时也可以把 `Try[T]` 看作一种特殊版本的 `Either[Throwable, T]`，专门用于左值为可抛出类型(Throwable)的情形。 -回到我们的社交网络的例子，假设我们想要获取我们最近的帖子并显示在屏幕上，我们通过调用getRecentPosts方法获得一个返回值List[String]——一个近期帖子的列表文本： +回到我们的社交网络的例子，假设我们想要获取我们最近的帖子并显示在屏幕上，我们通过调用 `getRecentPosts` 方法获得一个返回值 `List[String]` -- 一个近期帖子的列表文本： - val f: Future[List[String]] = Future { - session.getRecentPosts - } +{% tabs futures-05 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-05 %} - f onComplete { - case Success(posts) => for (post <- posts) println(post) - case Failure(t) => println("An error has occured: " + t.getMessage) - } +```scala +import scala.util.{Success, Failure} +val f: Future[List[String]] = Future { + session.getRecentPosts +} -onComplete方法一般在某种意义上它允许客户处理future计算出的成功或失败的结果。对于仅仅处理成功的结果，onSuccess 回调使用如下（该回调以一个偏函数(partial function)为参数）： +f.onComplete { + case Success(posts) => for (post <- posts) println(post) + case Failure(t) => println("An error has occured: " + t.getMessage) +} +``` - val f: Future[List[String]] = Future { - session.getRecentPosts - } +{% endtab %} +{% tab 'Scala 3' for=futures-05 %} - f onSuccess { - case posts => for (post <- posts) println(post) - } +```scala +import scala.util.{Success, Failure} -对于处理失败结果，onFailure回调使用如下： +val f: Future[List[String]] = Future { + session.getRecentPosts() +} - val f: Future[List[String]] = Future { - session.getRecentPosts - } +f.onComplete { + case Success(posts) => for post <- posts do println(post) + case Failure(t) => println("An error has occurred: " + t.getMessage) +} +``` - f onFailure { - case t => println("An error has occured: " + t.getMessage) - } +{% endtab %} +{% endtabs %} - f onSuccess { - case posts => for (post <- posts) println(post) - } +`onComplete` 方法一般在某种意义上它允许客户处理future计算出的成功或失败的结果。对于仅仅处理成功的结果，可以使用 `foreach` 回调： -如果future失败，即future抛出异常，则执行onFailure回调。 +{% tabs futures-06 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-06 %} -因为偏函数具有 isDefinedAt方法， onFailure方法只有在特定的Throwable类型对象中被定义才会触发。下面例子中的onFailure回调永远不会被触发： +```scala +val f: Future[List[String]] = Future { + session.getRecentPosts() +} - val f = Future { - 2 / 0 - } +for { + posts <- f + post <- posts +} println(post) +``` - f onFailure { - case npe: NullPointerException => - println("I'd be amazed if this printed out.") - } +{% endtab %} +{% tab 'Scala 3' for=futures-06 %} + +```scala +val f: Future[List[String]] = Future { + session.getRecentPosts() +} + +for + posts <- f + post <- posts +do println(post) +``` + +{% endtab %} +{% endtabs %} + +`Future` 提供了一个清晰的手段只用来处理失败的结果，这个手段是使用 `failed` 投影，这个投影把 `Failure[Throwable]` 转换成 `Success[Throwable]`。下面的[投影](#投影)章节提供了这样一个例子。 回到前面查找某个关键字第一次出现的例子，我们想要在屏幕上打印出此关键字的位置： - val firstOccurrence: Future[Int] = Future { - val source = scala.io.Source.fromFile("myText.txt") - source.toSeq.indexOfSlice("myKeyword") - } +{% tabs futures-oncomplete %} +{% tab 'Scala 2 and 3' for=futures-oncomplete %} - firstOccurrence onSuccess { - case idx => println("The keyword first appears at position: " + idx) - } +```scala +val firstOccurrence: Future[Int] = Future { + val source = scala.io.Source.fromFile("myText.txt") + source.toSeq.indexOfSlice("myKeyword") +} - firstOccurrence onFailure { - case t => println("Could not process file: " + t.getMessage) - } +firstOccurrence.onComplete { + case Success(idx) => println("The keyword first appears at position: " + idx) + case Failure(t) => println("Could not process file: " + t.getMessage) +} +``` - onComplete,、onSuccess 和 onFailure 方法都具有Unit的结果类型，这意味着不能链接使用这些方法的回调。注意这种设计是为了避免暗示而刻意为之的，因为链接回调也许暗示着按照一定的顺序执行注册回调（回调注册在同一个future中是无序的）。 +{% endtab %} +{% endtabs %} -也就是说，我们现在应讨论论何时调用callback。因为callback需要future的值是可用的，所有回调只能在future完成之后被调用。然而，不能保证callback在完成future的线程或创建callback的线程中被调用。反而， 回调(callback)会在future对象完成之后的一些线程和一段时间内执行。所以我们说回调(callback)最终会被执行。 +`onComplete` 和 `foreach` 方法都具有 `Unit` 的结果类型，这意味着不能链接使用这些方法的回调。注意这种设计是为了避免暗示而刻意为之的，因为链接回调也许暗示着按照一定的顺序执行注册回调（回调注册在同一个 future 中是无序的）。 -此外，回调(callback)执行的顺序不是预先定义的，甚至在相同的应用程序中callback的执行顺序也不尽相同。事实上，callback也许不是一个接一个连续的调用，但是可能会在同一时间同时执行。这意味着在下面的例子中，变量totalA也许不能在计算上下文中被设置为正确的大写或者小写字母。 +也就是说，我们现在应讨论**何时**正好在调用回调(callback)。因为回调需要 future 的值是可用的，所有回调只能在 future 完成之后被调用。 +然而，不能保证回调在完成 future 的线程或创建回调的线程中被调用。 +反而， 回调会在 future 对象完成之后的一些线程和一段时间内执行。所以我们说回调最终会被执行。 - @volatile var totalA = 0 +此外，回调(callback)执行的顺序不是预先定义的，甚至在相同的应用程序中回调的执行顺序也不尽相同。 +事实上，回调也许不是一个接一个连续的调用，但是可能会在同一时间同时执行。 +这意味着在下面的例子中，变量 `totalA` 也许不能在计算上下文中被设置为正确的大写或者小写字母 `a`。 - val text = Future { - "na" * 16 + "BATMAN!!!" - } +{% tabs volatile %} +{% tab 'Scala 2 and 3' for=volatile %} + +```scala +@volatile var totalA = 0 - text onSuccess { - case txt => totalA += txt.count(_ == 'a') - } +val text = Future { + "na" * 16 + "BATMAN!!!" +} - text onSuccess { - case txt => totalA += txt.count(_ == 'A') - } -以上，这两个回调(callbacks)可能是一个接一个地执行的，这样变量totalA得到的预期值为18。然而，它们也可能是并发执行的，于是totalA最终可能是16或2，因为+= 是一个不可分割的操作符（即它是由一个读和一个写的步骤组成，这样就可能使其与其他的读和写任意交错执行）。 +text.foreach { txt => + totalA += txt.count(_ == 'a') +} + +text.foreach { txt => + totalA += txt.count(_ == 'A') +} +``` + +{% endtab %} +{% endtabs %} + +以上，这两个回调(callbacks)可能是一个接一个地执行的，这样变量 `totalA` 得到的预期值为`18`。 +然而，它们也可能是并发执行的，于是 `totalA` 最终可能是`16`或`2`，因为 `+=` 不是一个原子性的操作符（即它是由一个读和一个写的步骤组成，这样就可能使其与其他的读和写任意交错执行）。 考虑到完整性，回调的使用情景列在这儿： -- 在future中注册onComplete回调的时候要确保最后future执行完成之后调用相应的终止回调。 +1. 在 future 中注册 `onComplete` 回调的时候要确保最后 future 执行完成之后调用相应的终止回调。 -- 注册onSuccess或者onFailure回调时也和注册onComplete一样，不同之处在于future执行成功或失败分别调用onSuccess或onSuccess的对应的闭包。 +2. 注册 `foreach` 回调时也和注册 `onComplete` 一样，不同之处在于 future 成功完成才会调用闭包。 -- 注册一个已经完成的future的回调最后将导致此回调一直处于执行状态（1所隐含的）。 +3. 在一个已经完成的 future 上注册回调将导致此该回调最终被执行（1所隐含的）。 -- 在future中注册多个回调的情况下，这些回调的执行顺序是不确定的。事实上，这些回调也许是同时执行的，然而，特定的ExecutionContext执行可能导致明确的顺序。 +4. 在 future 中注册多个回调的情况下，这些回调的执行顺序是不确定的。事实上，这些回调也许是同时执行的。然而，特定的 `ExecutionContext` 实现可能导致明确的顺序。 -- 在一些回调抛出异常的情况下，其他的回调的执行不受影响。 +5. 在一些回调抛出异常的情况下，其他的回调的执行不受影响。 -- 在一些情况下，回调函数永远不能结束（例如，这些回调处于无限循环中），其他回调可能完全不会执行。在这种情况下，对于那些潜在的阻塞回调要使用阻塞的构造（例子如下）。 +6. 在一些情况下，回调函数永远不能结束（例如，这些回调处于无限循环中），其他回调可能完全不会执行。在这种情况下，对于那些潜在的阻塞回调要使用 `blocking` 的构造（例子如下）。 -- 一旦执行完，回调将从future对象中移除，这样更适合JVM的垃圾回收机制(GC)。 +7. 一旦执行完，回调将从 future 对象中移除，这样更适合垃圾回收机制(GC)。 ### 函数组合(Functional Composition)和For解构(For-Comprehensions) -尽管前文所展示的回调机制已经足够把future的结果和后继计算结合起来的，但是有些时候回调机制并不易于使用，且容易造成冗余的代码。我们可以通过一个例子来说明。假设我们有一个用于进行货币交易服务的API，我们想要在有盈利的时候购进一些美元。让我们先来看看怎样用回调来解决这个问题： +尽管前文所展示的回调机制已经足够把future的结果和后继计算结合起来的。 +但是有些时候回调机制并不易于使用，且容易造成冗余的代码。 +我们可以通过一个例子来说明。假设我们有一个用于进行货币交易服务的 API，我们只想在有盈利的时候购进一些美元。让我们先来看看怎样用回调来解决这个问题： - val rateQuote = Future { - connection.getCurrentValue(USD) - } +{% tabs futures-07 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-07 %} + +```scala +val rateQuote = Future { + connection.getCurrentValue(USD) +} - rateQuote onSuccess { case quote => - val purchase = Future { - if (isProfitable(quote)) connection.buy(amount, quote) - else throw new Exception("not profitable") - } +for (quote <- rateQuote) { + val purchase = Future { + if (isProfitable(quote)) connection.buy(amount, quote) + else throw new Exception("not profitable") + } - purchase onSuccess { - case _ => println("Purchased " + amount + " USD") - } - } + for (amount <- purchase) + println("Purchased " + amount + " USD") +} +``` -首先，我们创建一个名为rateQuote的future对象并获得当前的汇率。在服务器返回了汇率且该future对象成功完成了之后，计算操作才会从onSuccess回调中执行，这时我们就可以开始判断买还是不买了。所以我们创建了另一个名为purchase的future对象，用来在可盈利的情况下做出购买决定，并在稍后发送一个请求。最后，一旦purchase运行结束，我们会在标准输出中打印一条通知消息。 +{% endtab %} +{% tab 'Scala 3' for=futures-07 %} -这确实是可行的，但是有两点原因使这种做法并不方便。其一，我们不得不使用onSuccess，且不得不在其中嵌套purchase future对象。试想一下，如果在purchase执行完成之后我们可能会想要卖掉一些其他的货币。这时我们将不得不在onSuccess的回调中重复这个模式，从而可能使代码过度嵌套，过于冗长，并且难以理解。 +```scala +val rateQuote = Future { + connection.getCurrentValue(USD) +} -其二，purchase只是定义在局部范围内--它只能被来自onSuccess内部的回调响应。这也就是说，这个应用的其他部分看不到purchase，而且不能为它注册其他的onSuccess回调，比如说卖掉些别的货币。 +for quote <- rateQuote do + val purchase = Future { + if isProfitable(quote) then connection.buy(amount, quote) + else throw Exception("not profitable") + } -为解决上述的两个问题，futures提供了组合器（combinators）来使之具有更多易用的组合形式。映射（map）是最基本的组合器之一。试想给定一个future对象和一个通过映射来获得该future值的函数，映射方法将创建一个新Future对象，一旦原来的Future成功完成了计算操作，新的Future会通过该返回值来完成自己的计算。你能够像理解容器(collections)的map一样来理解future的map。 + for amount <- purchase do + println("Purchased " + amount + " USD") +``` -让我们用map的方法来重构一下前面的例子： +{% endtab %} +{% endtabs %} - val rateQuote = Future { - connection.getCurrentValue(USD) - } +首先，我们创建一个名为 `rateQuote` 的 future 对象并获得当前的汇率。 +在服务器返回了汇率且该 future 对象成功完成了之后，计算操作才会从 `foreach` 回调中执行，这时我们就可以开始判断买还是不买了。 +所以我们创建了另一个名为 `purchase` 的 future 对象，用来只在可盈利的情况下做出购买决定，然后发送一个请求。 +最后，一旦purchase运行结束，我们会在标准输出中打印一条通知消息。 - val purchase = rateQuote map { quote => - if (isProfitable(quote)) connection.buy(amount, quote) - else throw new Exception("not profitable") - } +这确实是可行的，但是有两点原因使这种做法并不方便。其一，我们不得不使用 `foreach`，在其中嵌套第二个 `purchase` future 对象。试想一下，如果在 `purchase` 执行完成之后我们可能会想要卖掉一些其他的货币。这时我们将不得不在 `foreach` 回调中重复这个模式，从而可能使代码过度嵌套，过于冗长，并且难以理解。 - purchase onSuccess { - case _ => println("Purchased " + amount + " USD") - } +其二，`purchase` future 不在余下的代码范围内 -- 它只能被来自 `foreach` 内部的回调响应。这也就是说，这个应用的其他部分看不到 `purchase`，而且不能为它注册其他的 `foreach` 回调，比如说卖掉些别的货币。 -通过对rateQuote的映射我们减少了一次onSuccess的回调，更重要的是避免了嵌套。这时如果我们决定出售一些货币就可以再次使用purchase方法上的映射了。 +为解决上述的两个问题， futures提供了组合器（combinators）来使之具有更多易用的组合形式。映射（map）是最基本的组合器之一。试想给定一个 future 对象和一个通过映射来获得该 future 值的函数，映射方法将创建一个新 Future 对象，一旦原来的 Future 成功完成了计算操作，新的 Future 会通过该返回值来完成自己的计算。你能够像理解容器(collections)的map一样来理解 future 的map。 -可是如果isProfitable方法返回了false将会发生些什么？会引发异常？这种情况下，purchase的确会因为异常而失败。不仅仅如此，想象一下，链接的中断和getCurrentValue方法抛出异常会使rateQuote的操作失败。在这些情况下映射将不会返回任何值，而purchase也会会自动的以和rateQuote相同的异常而执行失败。 +让我们用 `map` 组合器来重构一下前面的例子： -总之，如果原Future的计算成功完成了，那么返回的Future将会使用原Future的映射值来完成计算。如果映射函数抛出了异常则Future也会带着该异常完成计算。如果原Future由于异常而计算失败，那么返回的Future也会包含相同的异常。这种异常的传导方式也同样适用于其他的组合器(combinators)。 +{% tabs futures-08 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-08 %} -使之能够在For-comprehensions原则下使用，是设计Future的目的之一。也正是因为这个原因，Future还拥有flatMap，filter和foreach等组合器。其中flatMap方法可以构造一个函数，它可以把值映射到一个姑且称为g的新future，然后返回一个随g的完成而完成的Future对象。 +```scala +val rateQuote = Future { + connection.getCurrentValue(USD) +} -让我们假设我们想把一些美元兑换成瑞士法郎。我们必须为这两种货币报价，然后再在这两个报价的基础上确定交易。下面是一个在for-comprehensions中使用flatMap和withFilter的例子： +val purchase = rateQuote map { quote => + if (isProfitable(quote)) connection.buy(amount, quote) + else throw new Exception("not profitable") +} - val usdQuote = Future { connection.getCurrentValue(USD) } - val chfQuote = Future { connection.getCurrentValue(CHF) } +purchase.foreach { amount => + println("Purchased " + amount + " USD") +} +``` - val purchase = for { - usd <- usdQuote - chf <- chfQuote - if isProfitable(usd, chf) - } yield connection.buy(amount, chf) +{% endtab %} +{% tab 'Scala 3' for=futures-08 %} - purchase onSuccess { - case _ => println("Purchased " + amount + " CHF") - } +```scala +val rateQuote = Future { + connection.getCurrentValue(USD) +} -purchase只有当usdQuote和chfQuote都完成计算以后才能完成-- 它以其他两个Future的计算值为前提所以它自己的计算不能更早的开始。 +val purchase = rateQuote.map { quote => + if isProfitable(quote) then connection.buy(amount, quote) + else throw Exception("not profitable") +} -上面的for-comprhension将被转换为： +purchase.foreach { amount => + println("Purchased " + amount + " USD") +} +``` - val purchase = usdQuote flatMap { - usd => - chfQuote - .withFilter(chf => isProfitable(usd, chf)) - .map(chf => connection.buy(amount, chf)) - } +{% endtab %} +{% endtabs %} + +通过在 `rateQuote` 上使用 `map`，我们减少了一次 `foreach` 的回调，更重要的是避免了嵌套。这时如果我们决定出售一些货币就可以再次在 `purchase` 上使用 `map` 了。 + +可是如果 `isProfitable` 方法返回了 `false` 将会发生些什么？会引发异常？ +这种情况下，`purchase` 的确会因为异常而失败。不仅仅如此，想象一下，链接的中断和 `getCurrentValue` 方法抛出异常会使 `rateQuote` 的操作失败。 +在这些情况下映射将不会返回任何值，而 `purchase` 也会自动的以和 `rateQuote` 相同的异常而失败。 + +总之，如果原 future 成功完成了，那么返回的 future 将会使用从原 future来的映射值完成。如果映射函数抛出了异常则返回的 future 也会带着一样的异常。如果原 future 由于异常而计算失败，那么返回的 future 也会包含相同的异常。这种异常的传导语义也存在于其余的组合器(combinators)。 + +使之能够在for-comprehensions 中使用，是设计 future 的目的之一。 +因为这个原因，future 还拥有 `flatMap` 和 `withFilter` 组合器。`flatMap` 方法获取一个函数，该函数把值映射到一个新 future `g`，然后返回一个随 `g` 的完成而完成的 future。 + +让我们假设我们想把一些美元兑换成瑞士法郎（CHF）。我们必须为这两种货币报价，然后再在这两个报价的基础上确定交易。 +下面是一个在 for-comprehensions 中使用 `flatMap` 和 `withFilter` 的例子： + +{% tabs futures-09 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-09 %} + +```scala +val usdQuote = Future { connection.getCurrentValue(USD) } +val chfQuote = Future { connection.getCurrentValue(CHF) } + +val purchase = for { + usd <- usdQuote + chf <- chfQuote + if isProfitable(usd, chf) +} yield connection.buy(amount, chf) -这的确是比for-comprehension稍微难以把握一些，但是我们这样分析有助于您更容易的理解flatMap的操作。FlatMap操作会把自身的值映射到其他future对象上，并随着该对象计算完成的返回值一起完成计算。在我们的例子里，flatMap用usdQuote的值把chfQuote的值映射到第三个futrue对象里，该对象用于发送一定量瑞士法郎的购入请求。只有当通过映射返回的第三个future对象完成了计算，purchase才能完成计算。 +purchase foreach { amount => + println("Purchased " + amount + " CHF") +} +``` + +{% endtab %} +{% tab 'Scala 3' for=futures-09 %} + +```scala +val usdQuote = Future { connection.getCurrentValue(USD) } +val chfQuote = Future { connection.getCurrentValue(CHF) } + +val purchase = for + usd <- usdQuote + chf <- chfQuote + if isProfitable(usd, chf) +yield connection.buy(amount, chf) + +purchase.foreach { amount => + println("Purchased " + amount + " CHF") +} +``` + +{% endtab %} +{% endtabs %} + +`purchase` 只有当 `usdQuote` 和 `chfQuote` 都完成计算以后才能完成-- 它以其他两个 future 的计算值为前提所以它自己的计算不能更早的开始。 + +上面的 for-comprhension 将被转换为： + +{% tabs for-translation %} +{% tab 'Scala 2 and 3' for=for-translation %} + +```scala +val purchase = usdQuote flatMap { + usd => + chfQuote + .withFilter(chf => isProfitable(usd, chf)) + .map(chf => connection.buy(amount, chf)) +} +``` + +{% endtab %} +{% endtabs %} + +这的确是比for-comprehension稍微难以把握一些，但是我们这样分析有助于您更容易的理解 `flatMap` 的操作。`flatMap` 操作会把自身的值映射到其他future对象上，并随着该对象计算完成的返回值一起完成计算。 +在我们的例子里，`flatMap` 用 `usdQuote` 的值把 `chfQuote` 的值映射到第三个 futrue 对象里，该对象用于发送一定量瑞士法郎的购入请求。 +只有当通过 `map` 返回的第三个 future 对象完成，结果 future `purchase` 才能完成。 这可能有些难以置信，但幸运的是faltMap操作在for-comprhensions模式以外很少使用，因为for-comprehensions本身更容易理解和使用。 -再说说filter，它可以用于创建一个新的future对象，该对象只有在满足某些特定条件的前提下才会得到原始future的计算值，否则就会抛出一个NoSuchElementException的异常而失败。调用了filter的future，其效果与直接调用withFilter完全一样。 +`filter` 组合器可以用于创建一个新的 future 对象，该对象只有在满足某些特定条件的前提下才会得到原始future的值。否则新 future 就会有 `NoSuchElementException` 的失败。调用了 `filter` 的future，其效果与直接调用 `withFilter` 完全一样。 -作为组合器的collect同filter之间的关系有些类似容器（collections）API里的那些方法之间的关系。 +作为组合器的 `collect` 同 `filter` 之间的关系有些类似容器（collections）API里的那些方法之间的关系。 -值得注意的是，调用foreach组合器并不会在计算值可用的时候阻塞当前的进程去获取计算值。恰恰相反，只有当future对象成功计算完成了，foreach所迭代的函数才能够被异步的执行。这意味着foreach与onSuccess回调意义完全相同。 +由于 `Future` trait(译注: trait有点类似java中的接口(interface)的概念)从概念上看可以包含两种类型的返回值（计算结果和异常），所以组合器会有一个处理异常的需求。 -由于Future trait(译注: trait有点类似java中的接口(interface)的概念)从概念上看包含两种类型的返回值（计算结果和异常），所以组合器会有一个处理异常的需求。 +比方说我们准备在 `rateQuote` 的基础上决定购入一定量的货币，那么 `connection.buy` 方法需要获取购入的 `amount` 和期望的 `quote`。它返回完成购买的数量。假如 `quote` 偏偏在这个节骨眼儿改变了，那buy方法将会抛出一个 `QuoteChangedExecption`，并且不会做任何交易。如果我们想让我们的 future 对象返回`0`而不是抛出那个异常，那我们需要使用 `recover` 组合器： -比方说我们准备在rateQuote的基础上决定购入一定量的货币，那么`connection.buy`方法需要知道购入的数量和期望的报价值，最终完成购买的数量将会被返回。假如报价值偏偏在这个节骨眼儿改变了，那buy方法将会抛出一个`QuoteChangedExecption`，并且不会做任何交易。如果我们想让我们的Future对象返回0而不是抛出那个该死的异常，那我们需要使用recover组合器： - val purchase: Future[Int] = rateQuote map { - quote => connection.buy(amount, quote) - } recover { - case QuoteChangedException() => 0 - } +{% tabs recover %} +{% tab 'Scala 2 and 3' for=recover %} -这里用到的recover能够创建一个新future对象，该对象当计算完成时持有和原future对象一样的值。如果执行不成功则偏函数的参数会被传递给使原Future失败的那个Throwable异常。如果它把Throwable映射到了某个值，那么新的Future就会成功完成并返回该值。如果偏函数没有定义在Throwable中，那么最终产生结果的future也会失败并返回同样的Throwable。 +```scala +val purchase: Future[Int] = rateQuote.map { + quote => connection.buy(amount, quote) +} recover { + case QuoteChangedException() => 0 +} +``` +{% endtab %} +{% endtabs %} -组合器recoverWith能够创建一个新future对象，当原future对象成功完成计算时，新future对象包含有和原future对象相同的计算结果。若原future失败或异常，偏函数将会返回造成原future失败的相同的Throwable异常。如果此时Throwable又被映射给了别的future，那么新Future就会完成并返回这个future的结果。recoverWith同recover的关系跟flatMap和map之间的关系很像。 +这里用到的 `recover` 能够创建一个新 future 对象，该对象当成功完成时持有和原 future 对象一样的值。如果执行不成功则偏函数的参数会被传递给使原 future 失败的那个 `Throwable` 异常。如果它把 `Throwable` 映射到了某个值，那么新的 future 就会成功完成并返回该值。 +如果偏函数没有定义在 `Throwable` 中，那么最终产生结果的 future 也会失败并返回同样的 `Throwable`。 -fallbackTo组合器生成的future对象可以在该原future成功完成计算时返回结果，如果原future失败或异常返回future参数对象的成功值。在原future和参数future都失败的情况下，新future对象会完成并返回原future对象抛出的异常。正如下面的例子中，本想打印美元的汇率，但是在获取美元汇率失败的情况下会打印出瑞士法郎的汇率： +组合器 `recoverWith` 能够创建一个新 future 对象，当原 future 对象成功完成计算时，新 future 包含有和原 future 相同的结果。若原 future 失败或异常，偏函数将会返回造成原 future 失败的相同的 `Throwable` 异常。如果此时 `Throwable` 又被映射给了别的 future ，那么新 future 就会完成并返回这个 future 的结果。 +`recoverWith` 同 `recover` 的关系跟 `flatMap` 和 `map` 之间的关系很像。 - val usdQuote = Future { - connection.getCurrentValue(USD) - } map { - usd => "Value: " + usd + "$" - } - val chfQuote = Future { - connection.getCurrentValue(CHF) - } map { - chf => "Value: " + chf + "CHF" - } +`fallbackTo` 组合器生成的 future 对象可以在该原 future 成功完成计算时返回结果，如果原 future 失败或异常返回 future 参数对象的成功值。在原 future 和参数 future 都失败的情况下，新 future 对象会完成并返回原 future 对象抛出的异常。正如下面的例子中，本想打印美元的汇率，但是在获取美元汇率失败的情况下会打印出瑞士法郎的汇率： - al anyQuote = usdQuote fallbackTo chfQuote +{% tabs fallback-to %} +{% tab 'Scala 2 and 3' for=fallback-to %} - anyQuote onSuccess { println(_) } +```scala +val usdQuote = Future { + connection.getCurrentValue(USD) +}.map { + usd => "Value: " + usd + "$" +} +val chfQuote = Future { + connection.getCurrentValue(CHF) +} map { + chf => "Value: " + chf + "CHF" +} -组合器andThen的用法是出于纯粹的side-effecting目的。经andThen返回的新Future无论原Future成功或失败都会返回与原Future一模一样的结果。一旦原Future完成并返回结果，andThen后跟的代码块就会被调用，且新Future将返回与原Future一样的结果，这确保了多个andThen调用的顺序执行。正如下例所示，这段代码可以从社交网站上把近期发出的帖子收集到一个可变集合里，然后把它们都打印在屏幕上： +val anyQuote = usdQuote.fallbackTo(chfQuote) - val allposts = mutable.Set[String]() +anyQuote.foreach { println(_) } +``` - Future { - session.getRecentPosts - } andThen { - case Success(posts) => allposts ++= posts - } andThen { - case _ => - clearAll() - for (post <- allposts) render(post) - } +{% endtab %} +{% endtabs %} -综上所述，Future的组合器功能是纯函数式的，每种组合器都会返回一个与原Future相关的新Future对象。 +组合器 `andThen` 的用法是出于纯粹的side-effecting目的。经 `andThen` 返回的新 future 无论原 future 成功或失败都会返回与原 future 一模一样的结果。 +一旦原 future 完成并返回结果，`andThen` 后跟的代码块就会被调用，且新 future 将返回与原 future 一样的结果，这确保了多个 `andThen` 调用的顺序执行。正如下例所示，这段代码可以从社交网站上把近期发出的帖子收集到一个可变集合里，然后把它们都打印在屏幕上： -### 投影(Projections) +{% tabs futures-10 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-10 %} -为了确保for解构(for-comprehensions)能够返回异常，futures也提供了投影(projections)。如果原future对象失败了，失败的投影(projection)会返回一个带有Throwable类型返回值的future对象。如果原Future成功了，失败的投影(projection)会抛出一个NoSuchElementException异常。下面就是一个在屏幕上打印出异常的例子： +```scala +val allposts = mutable.Set[String]() - val f = Future { - 2 / 0 - } - for (exc <- f.failed) println(exc) +Future { + session.getRecentPosts +} andThen { + case Success(posts) => allposts ++= posts +} andThen { + case _ => + clearAll() + for (post <- allposts) render(post) +} +``` + +{% endtab %} +{% tab 'Scala 3' for=futures-10 %} + +```scala +val allPosts = mutable.Set[String]() + +Future { + session.getRecentPosts() +}.andThen { + case Success(posts) => allPosts ++= posts +}.andThen { + case _ => + clearAll() + for post <- allPosts do render(post) +} +``` +{% endtab %} +{% endtabs %} + +综上所述，在 future 上的组合器功能是纯函数式的。 +每种组合器都会返回一个与原future相关的新 future 对象。 +### 投影 + +为了确保for解构(for-comprehensions)能够返回异常， future s也提供了投影(projections)。如果原 future 对象失败了，`failed` 的投影会返回一个带有 `Throwable` 类型返回值的 future 对象。如果原 future 成功了，`failed` 的投影失败并有一个 `NoSuchElementException`。下面就是一个在屏幕上打印出异常的例子： + +{% tabs futures-11 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-11 %} + +```scala +val f = Future { + 2 / 0 +} +for (exc <- f.failed) println(exc) +``` + +{% endtab %} +{% tab 'Scala 3' for=futures-11 %} + +```scala +val f = Future { + 2 / 0 +} +for exc <- f.failed do println(exc) +``` + +{% endtab %} +{% endtabs %} + +本例中的 for-comprehension 翻译成： + +{% tabs for-comp-tran %} +{% tab 'Scala 2 and 3' for=for-comp-tran %} + +```scala +f.failed.foreach(exc => println(exc)) +``` + +{% endtab %} +{% endtabs %} + +因为 `f` 在这没有成功，该闭包被注册到新成功的 `Future[Throwable]` 上的 `foreach`。 下面的例子不会在屏幕上打印出任何东西： - val f = Future { +{% tabs futures-12 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-12 %} + +```scala +val f = Future { + 4 / 2 +} +for (exc <- f.failed) println(exc) +``` + +{% endtab %} +{% tab 'Scala 3' for=futures-12 %} + +```scala +val g = Future { + 4 / 2 +} +for exc <- g.failed do println(exc) +``` + +{% endtab %} +{% endtabs %} + +<!-- +There is another projection called `timedout` which is specific to the +`FutureTimeoutException`. It works in exactly the same way as the +`failed` projection, but is triggered only for this exception type. In +all other cases, it fails with a `NoSuchElementException`. +--> + +<!-- +TODO: the `failed` projection can be extended to be parametric in +the throwable types it matches. +--> + +<!-- +Invoking the `Future.apply` construct uses a global execution context to start an asynchronous computation. In the case the client desires to use a custom execution context to start an asynchronous computation: + + val f = customExecutionContext Future { 4 / 2 } - for (exc <- f.failed) println(exc) +--> ### Future的扩展 -用更多的实用方法来对Futures API进行扩展支持已经被提上了日程，这将为很多外部框架提供更多专业工具。 +用更多的实用方法来对 Futures API 进行扩展支持已经被提上了日程，这将为很多外部框架提供更多专业工具。 -## Blocking +## 阻塞（Blocking） -正如前面所说的，在future的blocking非常有效地缓解性能和预防死锁。虽然在futures中使用这些功能方面的首选方式是Callbacks和combinators，但在某些处理中也会需要用到blocking，并且它也是被Futures and Promises API所支持的。 +Future 通常是异步的，不会阻塞底层执行线程。 +但是，在某些情况下，有必要阻塞。 +我们区分了两种形式的阻塞执行线程： +调用任意代码，从 future 来内部阻塞线程， +以及从另一个 future 外部阻塞，等待该 future 完成。 -在之前的并发交易(concurrency trading)例子中，在应用的最后有一处用到block来确定是否所有的futures已经完成。这有个如何使用block来处理一个future结果的例子： +### Future 内的阻塞 - import scala.concurrent._ - import scala.concurrent.duration._ +正如在全局 `ExecutionContext` 中看到的那样，可以使用 `blocking` 结构通知某个阻塞调用的 `ExecutionContext`。 +但是，实现完全由 `ExecutionContext`。一些 `ExecutionContext`，如 `ExecutionContext.global`，用 `MangedBlocker` 的办法实现 `blocking`，而另外一样通过执行上下文，如固定线程池来实现 `blocking`： +通过“ManagedBlocker”实现“阻塞”，一些执行上下文，如固定线程池： - def main(args: Array[String]): Unit = { - val rateQuote = Future { - connection.getCurrentValue(USD) - } +{% tabs fixed-thread-pool %} +{% tab 'Scala 2 and 3' for=fixed-thread-pool %} - val purchase = rateQuote map { quote => - if (isProfitable(quote)) connection.buy(amount, quote) - else throw new Exception("not profitable") - } +```scala +ExecutionContext.fromExecutor(Executors.newFixedThreadPool(x)) +``` - Await.result(purchase, 0 nanos) - } +{% endtab %} +{% endtabs %} -在这种情况下这个future是不成功的，这个调用者转发出了该future对象不成功的异常。它包含了失败的投影(projection)-- 阻塞(blocking)该结果将会造成一个NoSuchElementException异常在原future对象被成功计算的情况下被抛出。 +将不作任何事，就像下面演示的那样： -相反的，调用`Await.ready`来等待这个future直到它已完成，但获不到它的结果。同样的方式，调用那个方法时如果这个future是失败的，它将不会抛出异常。 +{% tabs futures-13 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-13 %} -The Future trait实现了Awaitable trait还有其`ready()`和`result()`方法。这些方法不能被客户端直接调用，它们只能通过执行环境上下文来进行调用。 +```scala +implicit val ec = + ExecutionContext.fromExecutor(Executors.newFixedThreadPool(4)) -为了允许程序调用可能是阻塞式的第三方代码，而又不必实现Awaitable特质，原函数可以用如下的方式来调用： +Future { + blocking { blockingStuff() } +} +``` - blocking { - potentiallyBlockingCall() - } +{% endtab %} +{% tab 'Scala 3' for=futures-13 %} -这段blocking代码也可以抛出一个异常。在这种情况下，这个异常会转发给调用者。 +```scala +given ExecutionContext = + ExecutionContext.fromExecutor(Executors.newFixedThreadPool(4)) -## 异常(Exceptions) +Future { + blocking { blockingStuff() } +} +``` -当异步计算抛出未处理的异常时，与那些计算相关的futures就失败了。失败的futures存储了一个Throwable的实例，而不是返回值。Futures提供onFailure回调方法，它用一个PartialFunction去表示一个Throwable。下列特殊异常的处理方式不同： +{% endtab %} +{% endtabs %} -`scala.runtime.NonLocalReturnControl[_]` --此异常保存了一个与返回相关联的值。通常情况下，在方法体中的返回结构被调用去抛出这个异常。相关联的值将会存储到future或一个promise中，而不是一直保存在这个异常中。 +和以下代码有一样的副作用： -ExecutionException-当因为一个未处理的中断异常、错误或者`scala.util.control.ControlThrowable`导致计算失败时会被存储起来。这种情况下，ExecutionException会为此具有未处理的异常。这些异常会在执行失败的异步计算线程中重新抛出。这样做的目的，是为了防止正常情况下没有被客户端代码处理过的那些关键的、与控制流相关的异常继续传播下去，同时告知客户端其中的future对象是计算失败的。 +{% tabs alternative %} +{% tab 'Scala 2 and 3' for=alternative %} -更精确的语义描述请参见 [NonFatal]。 +```scala +Future { blockingStuff() } +``` -## Promises +{% endtab %} +{% endtabs %} -到目前为止，我们仅考虑了通过异步计算的方式创建future对象来使用future的方法。尽管如此，futures也可以使用promises来创建。 +阻塞代码也可能抛出异常。这种情况下，异常被转发给调用者。 -如果说futures是为了一个还没有存在的结果，而当成一种只读占位符的对象类型去创建，那么promise就被认为是一个可写的，可以实现一个future的单一赋值容器。这就是说，promise通过这种success方法可以成功去实现一个带有值的future。相反的，因为一个失败的promise通过failure方法就会实现一个带有异常的future。 +### Future 外部的阻塞 -一个promise p通过p.future方式返回future。 这个futrue对象被指定到promise p。根据这种实现方式，可能就会出现p.future与p相同的情况。 +正如前面所说的，为了性能和防止死锁，强烈建议不要在future上用阻塞。 +虽然在futures中使用这些功能方面的首选方式是回调和组合器，但在某些处理中也会需要用到阻塞，并且 Futures API 和 Promises API也支持它。 -考虑下面的生产者 - 消费者的例子，其中一个计算产生一个值，并把它转移到另一个使用该值的计算。这个传递中的值通过一个promise来完成。 +在之前的并发交易(concurrency trading)例子中，在应用的最后有一处用到阻塞来确定是否所有的 futures已经完成。这有个如何使用阻塞来处理一个 future 结果的例子： - import scala.concurrent.{ Future, Promise } - import scala.concurrent.ExecutionContext.Implicits.global +{% tabs futures-14 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-14 %} - val p = Promise[T]() - val f = p.future +```scala +import scala.concurrent._ +import scala.concurrent.duration._ - val producer = Future { - val r = produceSomething() - p success r - continueDoingSomethingUnrelated() +object awaitPurchase { + def main(args: Array[String]): Unit = { + val rateQuote = Future { + connection.getCurrentValue(USD) } - val consumer = Future { - startDoingSomething() - f onSuccess { - case r => doSomethingWithResult() - } + val purchase = rateQuote map { quote => + if (isProfitable(quote)) connection.buy(amount, quote) + else throw new Exception("not profitable") } -在这里，我们创建了一个promise并利用它的future方法获得由它实现的Future。然后，我们开始了两种异步计算。第一种做了某些计算，结果值存放在r中，通过执行promise p，这个值被用来完成future对象f。第二种做了某些计算，然后读取实现了future f的计算结果值r。需要注意的是，在生产者完成执行`continueDoingSomethingUnrelated()` 方法这个任务之前，消费者可以获得这个结果值。 + Await.result(purchase, 0.nanos) + } +} +``` -正如前面提到的，promises具有单赋值语义。因此，它们仅能被实现一次。在一个已经计算完成的promise或者failed的promise上调用success方法将会抛出一个IllegalStateException异常。 +{% endtab %} +{% tab 'Scala 3' for=futures-14 %} -下面的这个例子显示了如何fail a promise。 +```scala +import scala.concurrent.* +import scala.concurrent.duration.* - val p = promise[T] - val f = p.future +@main def awaitPurchase = + val rateQuote = Future { + connection.getCurrentValue(USD) + } - val producer = Future { - val r = someComputation - if (isInvalid(r)) - p failure (new IllegalStateException) - else { - val q = doSomeMoreComputation(r) - p success q - } - } + val purchase = rateQuote.map { quote => + if isProfitable(quote) then connection.buy(amount, quote) + else throw Exception("not profitable") + } -如上，生产者计算出一个中间结果值r，并判断它的有效性。如果它不是有效的，它会通过返回一个异常实现promise p的方式fails the promise，关联的future f是failed。否则，生产者会继续它的计算，最终使用一个有效的结果值实现future f，同时实现 promise p。 + Await.result(purchase, 0.nanos) +``` -Promises也能通过一个complete方法来实现，这个方法采用了一个`potential value Try[T]`，这个值要么是一个类型为`Failure[Throwable]`的失败的结果值，要么是一个类型为`Success[T]`的成功的结果值。 +{% endtab %} +{% endtabs %} -类似success方法，在一个已经完成(completed)的promise对象上调用failure方法和complete方法同样会抛出一个IllegalStateException异常。 +在这种情况下这个 future 是不成功的，这个调用者转发出了该 future 对象不成功的异常。它包含了 `failed` 的投影(projection)-- 阻塞(blocking)该结果将会造成一个 `NoSuchElementException` 异常在原 future 对象被成功计算的情况下被抛出。 -应用前面所述的promises和futures方法的一个优点是，这些方法是单一操作的并且是没有副作用(side-effects)的，因此程序是具有确定性的(deterministic)。确定性意味着，如果该程序没有抛出异常(future的计算值被获得)，无论并行的程序如何调度，那么程序的结果将会永远是一样的。 +相反的，调用`Await.ready`来等待这个future直到它已完成，但获不到它的结果。同样的方式，调用那个方法时如果这个future是失败的，它将不会抛出异常。 -在一些情况下，客户端也许希望能够只在promise没有完成的情况下完成该promise的计算(例如，如果有多个HTTP请求被多个不同的futures对象来执行，并且客户端只关心第一个HTTP应答(response)，该应答对应于第一个完成该promise的future)。因为这个原因，future提供了tryComplete，trySuccess和tryFailure方法。客户端需要意识到调用这些的结果是不确定的，调用的结果将以来从程序执行的调度。 +The `Future` trait实现了 `Awaitable` trait 还有其 `ready()` 和 `result()` 方法。这些方法不能被客户端直接调用，它们只能通过执行环境上下文来进行调用。 -completeWith方法将用另外一个future完成promise计算。当该future结束的时候，该promise对象得到那个future对象同样的值，如下的程序将打印1： +## 异常(Exceptions) - val f = Future { 1 } - val p = promise[Int] +当异步计算抛出未处理的异常时，与那些计算相关的 futures 就失败了。失败的 futures 存储了一个 `Throwable` 的实例，而不是返回值。`Futures` 提供 `failed` 投影方法，它允许这个 `Throwable` 被当作另一个 `Future` 的成功值来处理。下列特殊异常的处理方式不同： +1. `scala.runtime.NonLocalReturnControl[_]` -- 此异常保存了一个与返回相关联的值。通常情况下，方法体中的 `return` 结构被翻译成带有异常的 `throw` 。相关联的值将会存储到future或一个promise中，而不是一直保存在这个异常中。 - p completeWith f +2. `ExecutionException` -- 当因为一个未处理的 `InterruptedException`, `Error` 或者 `scala.util.control.ControlThrowable` 导致计算失败时会被存储起来。这种情况下， `ExecutionException` 会为此具有未处理的异常。这些异常会在执行失败的异步计算线程中重新抛出。这样做的目的，是为了防止正常情况下没有被客户端代码处理过的那些关键的、与控制流相关的异常继续传播下去，同时告知客户端其中的 future 对象是计算失败的。 - p.future onSuccess { - case x => println(x) - } +致命异常（由 `NonFatal` 确定）在执行失败的异步计算的线程中重新引发。这会通知管理问题执行线程的代码，并允许它在必要时快速失败。更精确的语义描述请参见[`NonFatal`](https://www.scala-lang.org/api/current/scala/util/control/NonFatal$.html)。 + +## Promise + +到目前为止，我们仅考虑了通过异步计算的方式创建 `Future` 对象来使用 `Future` 的方法。尽管如此，futures也可以使用 *promises* 来创建。 + +如果说futures是为了一个还没有存在的结果，而当成一种只读占位符的对象类型去创建，那么promise就被认为是一个可写的，可以实现一个future的单一赋值容器。这就是说，promise通过这种 `success` 方法可以成功去实现一个带有值(通过 “实现” 该 promise)的future。相反的，用 `failure` 方法。 +一个 promise 也能用来实现带有异常的 future，通过这个失败的promise。 + +一个promise `p` 通过 `p.future` 方式返回future。 这个futrue对象被指定到promise `p`。根据这种实现方式，可能就会出现 `p.future eq p` 的情况。 + +考虑下面的生产者-消费者的例子，其中一个计算产生一个值，并把它转移到另一个使用该值的计算。这个传递中的值通过一个 promise 来完成。 + +{% tabs promises %} +{% tab 'Scala 2 and 3' for=promises %} + +```scala +import scala.concurrent.{ Future, Promise } +import scala.concurrent.ExecutionContext.Implicits.global + +val p = Promise[T]() +val f = p.future + +val producer = Future { + val r = produceSomething() + p.success(r) + continueDoingSomethingUnrelated() +} + +val consumer = Future { + startDoingSomething() + f.foreach { r => + doSomethingWithResult() + } +} +``` + +{% endtab %} +{% endtabs %} + +在这里，我们创建了一个promise并利用它的 `future` 方法获得由它实现的 `Future`。然后，我们开始了两种异步计算。第一种做了某些计算，结果值存放在r中，通过执行promise `p`，这个值被用来完成future对象 `f`。第二种做了某些计算，然后读取实现了 future `f` 的计算结果值 `r`。需要注意的是，在 `producer` 完成执行 `continueDoingSomethingUnrelated()` 方法这个任务之前，消费者可以获得这个结果值。 + +正如前面提到的，promises 具有单赋值语义。因此，它们仅能被完成一次。在一个已经计算完成的 promise 或者 failed 的promise上调用 `success` 方法将会抛出一个 `IllegalStateException` 异常。 + +下面的这个例子显示了如何使 promise 失败。 + +{% tabs futures-15 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-15 %} + +```scala +val p = Promise[T]() +val f = p.future + +val producer = Future { + val r = someComputation + if (isInvalid(r)) + p.failure(new IllegalStateException) + else { + val q = doSomeMoreComputation(r) + p.success(q) + } +} +``` + +{% endtab %} +{% tab 'Scala 3' for=futures-15 %} + +```scala +val p = Promise[T]() +val f = p.future + +val producer = Future { + val r = someComputation + if isInvalid(r) then + p.failure(new IllegalStateException) + else + val q = doSomeMoreComputation(r) + p.success(q) +} +``` + +{% endtab %} +{% endtabs %} + +如上， `producer` 计算出一个中间结果值 `r`，并判断它的有效性。如果它不是有效的，它会通过返回一个异常实现promise `p` 的方式fails the promise，关联的future `f` 是失败的。否则， `producer` 会继续它的计算，最终使用一个有效的结果值实现future f，同时实现 promise p。 + +Promises也能通过一个complete方法来实现，这个方法采用了一个 `potential value Try[T]`，这个值要么是一个类型为 `Failure[Throwable]` 的失败的结果值，要么是一个类型为 `Success[T]` 的成功的结果值。 + +类似 `success` 方法，在一个已经完成(completed)的promise对象上调用 `failure` 方法和 `complete` 方法同样会抛出一个 `IllegalStateException` 异常。 + +应用前面所述的 promises 和 futures 操作的一个优点是，这些方法是单一操作的并且是没有副作用(side-effects)的，因此程序是具有确定性的(deterministic)。确定性意味着，如果该程序没有抛出异常(future 的计算值被获得)，无论并行的程序如何调度，那么程序的结果将会永远是一样的。 + +在一些情况下，客户端也许希望能够只在 promise 没有完成的情况下完成该 promise 的计算(例如，如果有多个HTTP请求被多个不同的futures对象来执行，并且客户端只关心第一个HTTP应答(response)，该应答对应于第一个完成该 promise 的future)。因为这些原因，future提供了 `tryComplete`，`trySuccess` 和 `tryFailure` 方法。客户端需要意识到调用这些的结果是不确定的，调用的结果将以来从程序执行的调度。 + +`completeWith` 方法将用另外一个 future 完成 promise 计算。当该 future 结束的时候，该 promise 对象得到那个 future 对象同样的值，如下的程序将打印 `1`： -当让一个promise以异常失败的时候，三总子类型的Throwable异常被分别的处理。如果中断该promise的可抛出(Throwable)一场是`scala.runtime.NonLocalReturnControl`，那么该promise将以对应的值结束；如果是一个Error的实例，`InterruptedException`或者`scala.util.control.ControlThrowable`，那么该可抛出(Throwable)异常将会封装一个ExecutionException异常，该ExectionException将会让该promise以失败结束。 +{% tabs promises-2 %} +{% tab 'Scala 2 and 3' for=promises-2 %} -通过使用promises，futures的onComplete方法和future的构造方法，你能够实现前文描述的任何函数式组合组合器(compition combinators)。让我们来假设一下你想实现一个新的组合起，该组合器首先使用两个future对象f和，产生第三个future，该future能够用f或者g来完成，但是只在它能够成功完成的情况下。 +```scala +val f = Future { 1 } +val p = promise[Int]() + +p.completeWith(f) + +p.future.foreach { x => + println(x) +} +``` + +{% endtab %} +{% endtabs %} + +当让一个promise以异常失败的时候，三个子类型的 `Throwable` 异常被分别的处理。如果中断该promise的可抛出(Throwable)一场是`scala.runtime.NonLocalReturnControl`，那么该promise将以对应的值结束；如果是一个Error的实例，`InterruptedException` 或者 `scala.util.control.ControlThrowable`，那么该 `Throwable` 异常将会封装一个 `ExecutionException` 异常，该 `ExectionException` 将会让该 promise 以失败结束。 + +通过使用 promises，futures 的 `onComplete` 方法和 `future` 的构造方法，你能够实现前文描述的任何函数式组合组合器(compition combinators)。 +让我们来假设一下你想实现一个新的组合器 `first`，该组合器使用两个future `f` 和 `g`，然后生产出第三个 future，该future能够用 `f` 或者 `g` 来完成（看哪一个先到），但前提是它能够成功。 这里有个关于如何去做的实例： - def first[T](f: Future[T], g: Future[T]): Future[T] = { - val p = promise[T] +{% tabs futures-16 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-16 %} - f onSuccess { - case x => p.trySuccess(x) - } +```scala +def first[T](f: Future[T], g: Future[T]): Future[T] = { + val p = Promise[T] - g onSuccess { - case x => p.trySuccess(x) - } + f.foreach { x => + p.trySuccess(x) + } - p.future - } + g.foreach { x => + p.trySuccess(x) + } + + p.future +} +``` + +{% endtab %} +{% tab 'Scala 3' for=futures-16 %} + +```scala +def first[T](f: Future[T], g: Future[T]): Future[T] = + val p = Promise[T] + + f.foreach { x => + p.trySuccess(x) + } + + g.foreach { x => + p.trySuccess(x) + } + + p.future +``` -注意，在这种实现方式中，如果f与g都不是成功的，那么`first(f, g)`将不会实现（即返回一个值或者返回一个异常）。 +{% endtab %} +{% endtabs %} + +注意，在这种实现方式中，如果 `f` 和 `g` 都不成功，那么 `first(f, g)` 将不会完成（即返回一个值或者返回一个异常）。 + +<!-- +## Migration p + +scala.actor.Futures? +for clients + + +## Implementing custom futures and promises p +for library writers +--> ## 工具(Utilities) -为了简化在并发应用中处理时序(time)的问题，`scala.concurrent`引入了Duration抽象。Duration不是被作为另外一个通常的时间抽象存在的。他是为了用在并发(concurrency)库中使用的，Duration位于`scala.concurrent`包中。 +为了简化在并发应用中处理时序(time)的问题， `scala.concurrent` 引入了 `Duration` 抽象。`Duration` 不是被作为另外一个通常的时间抽象存在的。他是为了用在并发(concurrency)库中使用的，`Duration` 位于 `scala.concurrent` 包中。 + +`Duration` 是表示时间长短的基础类，其可以是有限的或者无限的。有限的duration用 `FiniteDuration` 类来表示，并通过 `Long` 长度和 `java.util.concurrent.TimeUnit` 来构造。无限的 durations，同样扩展自 `Duration`，只在两种情况下存在，`Duration.Inf` 和 `Duration.MinusInf`。库中同样提供了一些 `Duration` 的子类用来做隐式的转换，这些子类不应被直接使用。 + +抽象的 `Duration` 类包含了如下方法： + +1. 到不同时间单位的转换（`toNanos`，`toMicros`，`toMillis`，`toSeconds`，`toMinutes`，`toHours`，`toDays` 和 `toUnit(unit: TimeUnit)`）。 +2. durations的比较（`<`，`<=`，`>`和`>=`）。 +3. 算术运算符（`+`，`-`，`*`，`/`和 `unary_-`） +4. `this` duration 与提供的参数之间的最大和最小的方法（`min`，`max`）。 +5. 检查 duration是否有限（`isFinite`）。 + +`Duration` 能够用如下方法实例化（`instantiated`）： + +1. 通过 `Int` 和 `Long` 类型隐式转换，例如：`val d = 100 millis`。 +2. 通过传递一个 `Long` 长度和 `java.util.concurrent.TimeUnit`。例如：`val d = Duration(100, MILLISECONDS)`。 +3. 通过传递一个字符串来表示时间区间，例如： `val d = Duration("1.2 µs")`。 + +Duration 也提供了 `unapply` 方法，因此可以被用于模式匹配中，例如： + +{% tabs futures-17 class=tabs-scala-version %} +{% tab 'Scala 2' for=futures-17 %} + +```scala +import scala.concurrent.duration._ +import java.util.concurrent.TimeUnit._ -Duration是表示时间长短的基础类，其可以是有限的或者无限的。有限的duration用FiniteDuration类来表示，并通过时间长度`(length)`和`java.util.concurrent.TimeUnit`来构造。无限的durations，同样扩展了Duration，只在两种情况下存在，`Duration.Inf`和`Duration.MinusInf`。库中同样提供了一些Durations的子类用来做隐式的转换，这些子类不应被直接使用。 +// instantiation +val d1 = Duration(100, MILLISECONDS) // from Long and TimeUnit +val d2 = Duration(100, "millis") // from Long and String +val d3 = 100 millis // implicitly from Long, Int or Double +val d4 = Duration("1.2 µs") // from String -抽象的Duration类包含了如下方法： +// pattern matching +val Duration(length, unit) = 5 millis +``` -到不同时间单位的转换`(toNanos, toMicros, toMillis, toSeconds, toMinutes, toHours, toDays and toUnit(unit: TimeUnit))`。 -durations的比较`(<，<=，>和>=)`。 -算术运算符`（+, -, *, / 和单值运算_-）` -duration的最大最小方法`(min，max)`。 -测试duration是否是无限的方法`(isFinite)`。 -Duration能够用如下方法实例化`(instantiated)`： +{% endtab %} +{% tab 'Scala 3' for=futures-17 %} -隐式的通过Int和Long类型转换得来 `val d = 100 millis`。 -通过传递一个`Long length`和`java.util.concurrent.TimeUnit`。例如`val d = Duration(100, MILLISECONDS)`。 -通过传递一个字符串来表示时间区间，例如 `val d = Duration("1.2 µs")`。 -Duration也提供了unapply方法，因此可以i被用于模式匹配中，例如： +```scala +import scala.concurrent.duration.* +import java.util.concurrent.TimeUnit.* - import scala.concurrent.duration._ - import java.util.concurrent.TimeUnit._ +// instantiation +val d1 = Duration(100, MILLISECONDS) // from Long and TimeUnit +val d2 = Duration(100, "millis") // from Long and String +val d3 = 100.millis // implicitly from Long, Int or Double +val d4 = Duration("1.2 µs") // from String - // instantiation - val d1 = Duration(100, MILLISECONDS) // from Long and TimeUnit - val d2 = Duration(100, "millis") // from Long and String - val d3 = 100 millis // implicitly from Long, Int or Double - val d4 = Duration("1.2 µs") // from String +// pattern matching +val Duration(length, unit) = 5.millis +``` - // pattern matching - val Duration(length, unit) = 5 millis +{% endtab %} +{% endtabs %} From 86fe255d06face6b9dabee0786c922d89db53a01 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Thu, 13 Apr 2023 00:20:00 +0000 Subject: [PATCH 2572/3075] Update SIPs state --- _sips/sips/multi-source-extension-overloads.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_sips/sips/multi-source-extension-overloads.md b/_sips/sips/multi-source-extension-overloads.md index b8a1af4aa8..1e6be090a8 100644 --- a/_sips/sips/multi-source-extension-overloads.md +++ b/_sips/sips/multi-source-extension-overloads.md @@ -1,7 +1,8 @@ --- title: SIP-54 - Multi-Source Extension Overloads. -status: under-review +status: vote-requested pull-request-number: 60 stage: design +recommendation: accept --- From 0cb1c345de9fdc5767742cd75573e6683a9c8a7f Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Thu, 13 Apr 2023 12:01:21 +0200 Subject: [PATCH 2573/3075] Add more guidelines for labelling code examples for Scala 2/3 (#2768) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Clarify how to label entire pages of documentation that are specific to a Scala version * Add a note that all the code examples assume a specific version of Scala in the “version-specific-notice” * Use the new way of labelling pages in Multiversal Equality * Use the new way of labelling pages in Given Instances and Using Clauses, and adjust the “version-specific-notice”. * Label “types-union” * Also label the chinese version of types-union.md * Label the page types-adts-gadts.md as “New in Scala 3” --- _includes/version-specific-notice.html | 8 ++- _overviews/contribute/add-guides.md | 57 +++++++++++++++++-- .../scala3-book/ca-given-using-clauses.md | 41 +------------ .../scala3-book/ca-multiversal-equality.md | 7 +-- _overviews/scala3-book/types-adts-gadts.md | 2 + _overviews/scala3-book/types-union.md | 5 +- _zh-cn/overviews/scala3-book/types-union.md | 6 ++ 7 files changed, 75 insertions(+), 51 deletions(-) diff --git a/_includes/version-specific-notice.html b/_includes/version-specific-notice.html index b7a5a6f291..1a9ea6832b 100644 --- a/_includes/version-specific-notice.html +++ b/_includes/version-specific-notice.html @@ -3,10 +3,14 @@ <i class="fa fa-info"></i><span style="margin-left: 0.5rem"> {% if include.language == 'scala3' %} This doc page is specific to Scala 3, - and may cover new concepts not available in Scala 2. + and may cover new concepts not available in Scala 2. Unless + otherwise stated, all the code examples in this page assume + you are using Scala 3. {% else if include.language == 'scala2' %} This doc page is specific to features shipped in Scala 2, - which have either been removed in Scala 3 or replaced by an alternative. + which have either been removed in Scala 3 or replaced by an + alternative. Unless otherwise stated, all the code examples + in this page assume you are using Scala 2. {% endif %} </span> </blockquote> diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md index 7598ad5f63..5a4bed14f7 100644 --- a/_overviews/contribute/add-guides.md +++ b/_overviews/contribute/add-guides.md @@ -83,7 +83,7 @@ clarifications, etc. ## Code blocks It's common for various kinds of documents to require code examples. -You can contribute code in a markdown document by either +You can contribute code in a Markdown document by either - in-line by putting backticks around it, - surrounding by triple backticks, - or indenting it by 4 spaces, e.g.: @@ -92,6 +92,7 @@ You can contribute code in a markdown document by either inline example: `val x = 23` block example: + ```scala println("hello") ``` @@ -103,9 +104,31 @@ indented example: ### Scala 2 vs Scala 3 -Sometimes you would like to compare between Scala 2 and Scala 3 in a document, for example in -our [Hello World][hello-world] chapter of the Scala Book. Here is an example of how you -can generate the same tabs in markdown with the `tabs` directive and class `tabs-scala-version`: +Our goal is to have a unified documentation that covers both Scala 2 and Scala 3. In many cases, the +code examples are the same in both Scala 2 and Scala 3, but sometimes there are some syntactic +differences. In some less common cases, a page may explain a concept that is new in Scala 3 and has +no equivalent in Scala 2, or a concept that has been removed in Scala 3. In all the cases, the +documentation should clearly "label" the code examples so that the readers know in which versions +of Scala they are valid. + +The following sections explain how to properly "label" the code examples. + +#### Labelling the code snippets of a page documenting a concept available in both Scala 2 and Scala 3 + +When the content of a page not specific to Scala 2 or Scala 3, like for example our +[Hello World][hello-world] chapter of the Scala Book, the code snippets should show both the +Scala 2 and Scala 3 syntax. We achieve this by labelling the code snippets in tabs according +to the following rules: + +- if the idiomatic syntax is different in Scala 2 and Scala 3, we create two tabs, + “Scala 2” and “Scala 3”, showing the corresponding syntax +- if the code snippet is idiomatic in both Scala 2 and Scala 3, we create a single tab, + “Scala 2 and 3” +- if the code snippet is valid only in Scala 2 or Scala 3, we create a single tab, + “Scala 2 Only” or “Scala 3 Only” + +Here is an example of how you +can generate such tabs in Markdown with the `tabs` directive and class `tabs-scala-version`: <!-- {% raw %} --> ~~~liquid @@ -161,6 +184,32 @@ a parameter `for=tab-group` as in this example: ~~~ <!-- {% endraw %} --> +#### Labelling an entire page documenting a concept that is specific to a Scala version + +When the content of a page explains a concept that is new in Scala 3 and has no +equivalent in Scala 2 (e.g. [TASTy]({% link scala3/guides/tasty-overview.md %})), +or a concept that has been removed in Scala 3, we label the entire page instead +of labelling each code example. + +We achieve this by setting a couple of a attributes in the [YAML front +matter](https://jekyllrb.com/docs/front-matter/) of the Markdown file. For +instance, for a page that is specific to Scala 3: + +~~~ yaml +scala3: true +versionSpecific: true +~~~ + +Or, for a page that is specific to Scala 2: + +~~~ yaml +scala2: true +versionSpecific: true +~~~ + +Please note that when the entire page is labelled, its code examples do not +need to have tabs. + ### Typechecked Examples The site build process uses [mdoc](https://scalameta.org/mdoc/) to typecheck diff --git a/_overviews/scala3-book/ca-given-using-clauses.md b/_overviews/scala3-book/ca-given-using-clauses.md index a0c747c450..16169334c5 100644 --- a/_overviews/scala3-book/ca-given-using-clauses.md +++ b/_overviews/scala3-book/ca-given-using-clauses.md @@ -6,11 +6,10 @@ languages: [zh-cn] num: 60 previous-page: ca-extension-methods next-page: ca-context-bounds +scala3: true +versionSpecific: true --- - -<h5>Use contextual abstraction <span class="tag tag-inline">Scala 3 Only</span></h5> - Scala 3 offers two important feature for contextual abstraction: - **Using Clauses** allow you to specify parameters that, at the call site, can be omitted by the programmer and should be automatically provided by the context. @@ -23,9 +22,6 @@ One common way to achieve this is by passing the configuration as additional arg In the following example, we define a case class `Config` to model some website configuration and pass it around in the different methods. -{% tabs nonusing %} -{% tab 'Scala 2 and 3' %} - ```scala case class Config(port: Int, baseUrl: String) @@ -38,9 +34,6 @@ val config = Config(8080, "docs.scala-lang.org") renderWebsite("/home", config) ``` -{% endtab %} -{% endtabs %} - Let us assume that the configuration does not change throughout most of our code base. Passing `c` to each and every method call (like `renderWidget`) becomes very tedious and makes our program more difficult to read, since we need to ignore the `c` argument. @@ -48,9 +41,6 @@ Passing `c` to each and every method call (like `renderWidget`) becomes very ted In Scala 3, we can mark some parameters of our methods as _contextual_. -{% tabs using1 %} -{% tab 'Scala 3 Only' %} - ```scala def renderWebsite(path: String)(using c: Config): String = "<html>" + renderWidget(List("cart")) + "</html>" @@ -60,9 +50,6 @@ def renderWebsite(path: String)(using c: Config): String = def renderWidget(items: List[String])(using c: Config): String = ??? ``` -{% endtab %} -{% endtabs %} - By starting a parameter section with the keyword `using`, we tell the Scala compiler that at the call-site it should automatically find an argument with the correct type. The Scala compiler thus performs **term inference**. @@ -71,9 +58,6 @@ So the program is equivalent to the one above. In fact, since we do not need to refer to `c` in our implementation of `renderWebsite` anymore, we can even omit its name in the signature: -{% tabs using2 %} -{% tab 'Scala 3 Only' %} - ```scala // no need to come up with a parameter name // vvvvvvvvvvvvv @@ -81,9 +65,6 @@ def renderWebsite(path: String)(using Config): String = "<html>" + renderWidget(List("cart")) + "</html>" ``` -{% endtab %} -{% endtabs %} - #### Explicitly providing contextual arguments We have seen how to _abstract_ over contextual parameters and that the Scala compiler can provide arguments automatically for us. @@ -91,16 +72,10 @@ But how can we specify which configuration to use for our call to `renderWebsite Like we specified our parameter section with `using`, we can also explicitly provide contextual arguments with `using:` -{% tabs using3 %} -{% tab 'Scala 3 Only' %} - ```scala renderWebsite("/home")(using config) ``` -{% endtab %} -{% endtabs %} - Explicitly providing contextual parameters can be useful if we have multiple different values in scope that would make sense, and we want to make sure that the correct one is passed to the function. For all other cases, as we will see in the next Section, there is also another way to bring contextual values into scope. @@ -110,9 +85,6 @@ For all other cases, as we will see in the next Section, there is also another w We have seen that we can explicitly pass arguments as contextual parameters by marking the argument section of the _call_ with `using`. However, if there is _a single canonical value_ for a particular type, there is another preferred way to make it available to the Scala compiler: by marking it as `given`. -{% tabs given1 %} -{% tab 'Scala 3 Only' %} - ```scala val config = Config(8080, "docs.scala-lang.org") // this is the type that we want to provide the @@ -124,24 +96,15 @@ given Config = config // as argument to contextual parameters of type Config ``` -{% endtab %} -{% endtabs %} - In the above example we specify that whenever a contextual parameter of type `Config` is omitted in the current scope, the compiler should infer `config` as an argument. Having defined a given for `Config`, we can simply call `renderWebsite`: -{% tabs given2 %} -{% tab 'Scala 3 Only' %} - ```scala renderWebsite("/home") // ^^^^^ // again no argument ``` -{% endtab %} -{% endtabs %} - [reference]: {{ site.scala3ref }}/overview.html [blog-post]: /2020/11/06/explicit-term-inference-in-scala-3.html diff --git a/_overviews/scala3-book/ca-multiversal-equality.md b/_overviews/scala3-book/ca-multiversal-equality.md index 54aed55fa4..7d5d6d0c92 100644 --- a/_overviews/scala3-book/ca-multiversal-equality.md +++ b/_overviews/scala3-book/ca-multiversal-equality.md @@ -6,12 +6,9 @@ languages: [zh-cn] num: 64 previous-page: ca-type-classes next-page: ca-implicit-conversions +scala3: true +versionSpecific: true --- -<span class="tag tag-inline">New In Scala 3</span> - -> Multiversal Equality is a new language feature that was introduced in Scala 3. -> Because it has no equivalent in Scala 2, all code examples -> in this lesson assume you are using Scala 3. Previously, Scala had *universal equality*: Two values of any types could be compared with each other using `==` and `!=`. This came from the fact that `==` and `!=` are implemented in terms of Java’s `equals` method, which can also compare values of any two reference types. diff --git a/_overviews/scala3-book/types-adts-gadts.md b/_overviews/scala3-book/types-adts-gadts.md index 1ee8fb48a6..5cb2d0e550 100644 --- a/_overviews/scala3-book/types-adts-gadts.md +++ b/_overviews/scala3-book/types-adts-gadts.md @@ -6,6 +6,8 @@ languages: [zh-cn] num: 52 previous-page: types-union next-page: types-variance +scala3: true +versionSpecific: true --- diff --git a/_overviews/scala3-book/types-union.md b/_overviews/scala3-book/types-union.md index 1636556767..271c9a0148 100644 --- a/_overviews/scala3-book/types-union.md +++ b/_overviews/scala3-book/types-union.md @@ -6,6 +6,8 @@ languages: [zh-cn] num: 51 previous-page: types-intersection next-page: types-adts-gadts +scala3: true +versionSpecific: true --- Used on types, the `|` operator creates a so-called _union type_. @@ -43,7 +45,7 @@ case 1.0 => ??? // ERROR: this line won’t compile As shown, union types can be used to represent alternatives of several different types, without requiring those types to be part of a custom-crafted class hierarchy, or requiring explicit wrapping. #### Pre-planning the Class Hierarchy -Other languages would require pre-planning of the class hierarchy, like the following example illustrates: +Without union types, it would require pre-planning of the class hierarchy, like the following example illustrates: ```scala trait UsernameOrPassword @@ -51,6 +53,7 @@ case class Username(name: String) extends UsernameOrPassword case class Password(hash: Hash) extends UsernameOrPassword def help(id: UsernameOrPassword) = ... ``` + Pre-planning does not scale very well since, for example, requirements of API users might not be foreseeable. Additionally, cluttering the type hierarchy with marker traits like `UsernameOrPassword` also makes the code more difficult to read. diff --git a/_zh-cn/overviews/scala3-book/types-union.md b/_zh-cn/overviews/scala3-book/types-union.md index 204b1fcccb..51f61590f8 100644 --- a/_zh-cn/overviews/scala3-book/types-union.md +++ b/_zh-cn/overviews/scala3-book/types-union.md @@ -11,6 +11,8 @@ partof: scala3-book overview-name: "Scala 3 — Book" layout: multipage-overview permalink: "/zh-cn/scala3/book/:title.html" +scala3: true +versionSpecific: true --- @@ -54,12 +56,16 @@ case 1.0 => ??? // ERROR: this line won’t compile 其他语言需要预先规划类层次结构，如下例所示： +{% tabs pre-planning %} +{% tab 'Scala 2 and 3' %} ```scala trait UsernameOrPassword case class Username(name: String) extends UsernameOrPassword case class Password(hash: Hash) extends UsernameOrPassword def help(id: UsernameOrPassword) = ... ``` +{% endtab %} +{% endtabs %} 预先计划不能很好地扩展，例如，API 用户的需求可能无法预见。 此外，使用诸如 `UsernameOrPassword` 之类的标记 trait 使类型层次结构混乱也会使代码更难阅读。 From d42a8dbf25e6022211904aedcfa520790fbef325 Mon Sep 17 00:00:00 2001 From: QuentinCazelles <quentin.cazelles.taf@gmail.com> Date: Mon, 17 Apr 2023 19:05:58 +0200 Subject: [PATCH 2574/3075] Ambiguity in Tour of Scala : Case Classes. issue #2771 --- _tour/case-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/case-classes.md b/_tour/case-classes.md index 2386fb0ead..17aa73fc7c 100644 --- a/_tour/case-classes.md +++ b/_tour/case-classes.md @@ -28,7 +28,7 @@ val frankenstein = Book("978-0486282114") {% endtabs %} -Notice how the keyword `new` was not used to instantiate the `Book` case class. This is because case classes have an `apply` method by default which takes care of object construction. +Although that is usually left out, it is possible to explicitly use the `new` keyword, as `new Book()`. This is because case classes have an `apply` method by default which takes care of object construction. When you create a case class with parameters, the parameters are public `val`s. From 4ea83010f5f42c3e2553840d5e90ce7ef0288db6 Mon Sep 17 00:00:00 2001 From: Som Snytt <som.snytt@gmail.com> Date: Tue, 18 Apr 2023 18:13:46 -0700 Subject: [PATCH 2575/3075] Mention specialized --- .../scala3-migration/incompat-dropped-features.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/_overviews/scala3-migration/incompat-dropped-features.md b/_overviews/scala3-migration/incompat-dropped-features.md index ae7e3e3f1e..4d5b2d5d73 100644 --- a/_overviews/scala3-migration/incompat-dropped-features.md +++ b/_overviews/scala3-migration/incompat-dropped-features.md @@ -19,6 +19,7 @@ Most of these changes can be handled automatically during the [Scala 3 migration |[`any2stringadd` conversion](#any2stringadd-conversion)|Deprecation||[✅](https://github.com/scala/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/Any2StringAdd.scala)| |[Early initializer](#early-initializer)|Deprecation||| |[Existential type](#existential-type)|Feature warning||| +|[@specialized](#specialized)|Deprecation||| ## Symbol literals @@ -256,3 +257,12 @@ def foo: Bar Note that using a wildcard argument, `_` or `?`, is often simpler but is not always possible. For instance you could replace `List[T] forSome { type T }` by `List[?]`. + +## Specialized + +The `@specialized` annotation from Scala 2 is ignored in Scala 3. + +However, there is limited support for specialized `Function` and `Tuple`. + +Similar benefits can be derived from `inline` declarations. + From 733f081ee276365ad76897aaac020f7eea77b345 Mon Sep 17 00:00:00 2001 From: Matthew Hagemann <93575731+matthew-hagemann@users.noreply.github.com> Date: Wed, 19 Apr 2023 13:22:55 +0200 Subject: [PATCH 2576/3075] Fix wording error (#2770) --- _overviews/scala3-book/domain-modeling-fp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/domain-modeling-fp.md b/_overviews/scala3-book/domain-modeling-fp.md index 6942cd124c..f8ab2fb571 100644 --- a/_overviews/scala3-book/domain-modeling-fp.md +++ b/_overviews/scala3-book/domain-modeling-fp.md @@ -35,7 +35,7 @@ Ignoring the division of whole numbers, the possible *operations* on those value +, -, * ```` -An FP design is implemented in a similar way: +In FP, business domains are modeled in a similar way: - You describe your set of values (your data) - You describe operations that work on those values (your functions) From 5fa024b67b18b39948f7eda2c9730cd5c697a487 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Fri, 21 Apr 2023 00:20:34 +0000 Subject: [PATCH 2577/3075] Update SIPs state --- _sips/sips/quote-pattern-explicit-type-variable-syntax.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_sips/sips/quote-pattern-explicit-type-variable-syntax.md b/_sips/sips/quote-pattern-explicit-type-variable-syntax.md index 9b2f0dcb9d..a71cfa345e 100644 --- a/_sips/sips/quote-pattern-explicit-type-variable-syntax.md +++ b/_sips/sips/quote-pattern-explicit-type-variable-syntax.md @@ -1,7 +1,8 @@ --- title: SIP-53 - Quote Pattern Explicit Type Variable Syntax -status: under-review +status: vote-requested pull-request-number: 59 stage: design +recommendation: accept --- From 012cf86fc4d1c12758f04d1e99d3be0d7f76ad34 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Costa?= <jdpc557@gmail.com> Date: Sun, 18 Sep 2022 00:28:23 +0200 Subject: [PATCH 2578/3075] Add a mention to the provided Liquid variables I think it's a bit odd that the documentation specifies "[...] several custom filters and tags specific to Scala[...]" and then doesn't mention anything about that. From what I can tell from the [source code](https://github.com/lampepfl/dotty/blob/0632405ae487233709c9c6af6d83ff03db7f7bce/scaladoc/src/dotty/tools/scaladoc/site/StaticSiteContext.scala#L113-L115), the only Scala specific things being provided are the `projectTitle` and `projectVersion`. I think it's useful to document the existence of this variables. Especially `projectVersion`, which can be used to automatically generate `sbt`/`mill`/`maven`/... coordinates. --- _overviews/scala3-scaladoc/static-site.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index 4eda6f88da..12377e8901 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -70,6 +70,12 @@ Scaladoc uses the [Liquid](https://shopify.github.io/liquid/) templating engine and provides several custom filters and tags specific to Scala documentation. +The following project related variables are available and can be accessed using +double curly braces (e.g. `{{ projectTitle }}`): + +- **projectTitle** the project title defined with the `-project` flag. +- **projectVersion** the project version defined with the `-project-version` flag. + In Scaladoc, all templates can contain YAML front-matter. The front-matter is parsed and put into the `page` variable available in templates via Liquid. From be270a1cf6d8b7c6f594bb578b8bdfb58597d50e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=8BAndrzej=20Ressel?= <github@andrzejressel.pl> Date: Tue, 25 Apr 2023 22:33:54 +0200 Subject: [PATCH 2579/3075] Make buf final in string interpolation docs --- _overviews/core/string-interpolation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/core/string-interpolation.md b/_overviews/core/string-interpolation.md index 56fdae8f37..e2ad7b2366 100644 --- a/_overviews/core/string-interpolation.md +++ b/_overviews/core/string-interpolation.md @@ -232,7 +232,7 @@ implicit class JsonHelper(val sc: StringContext) extends AnyVal { def json(args: Any*): JSONObject = { val strings = sc.parts.iterator val expressions = args.iterator - var buf = new StringBuilder(strings.next()) + val buf = new StringBuilder(strings.next()) while (strings.hasNext) { buf.append(expressions.next()) buf.append(strings.next()) @@ -249,7 +249,7 @@ extension (sc: StringContext) def json(args: Any*): JSONObject = val strings = sc.parts.iterator val expressions = args.iterator - var buf = new StringBuilder(strings.next()) + val buf = new StringBuilder(strings.next()) while strings.hasNext do buf.append(expressions.next()) buf.append(strings.next()) From 69420dd35461f5fd0539672fa5d387172f1c1516 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Wed, 26 Apr 2023 00:21:21 +0000 Subject: [PATCH 2580/3075] Update SIPs state --- ...e-pattern-explicit-type-variable-syntax.md | 8 - .../quote-pattern-type-variable-syntax.md | 139 ++++++++++++++++++ 2 files changed, 139 insertions(+), 8 deletions(-) delete mode 100644 _sips/sips/quote-pattern-explicit-type-variable-syntax.md create mode 100644 _sips/sips/quote-pattern-type-variable-syntax.md diff --git a/_sips/sips/quote-pattern-explicit-type-variable-syntax.md b/_sips/sips/quote-pattern-explicit-type-variable-syntax.md deleted file mode 100644 index a71cfa345e..0000000000 --- a/_sips/sips/quote-pattern-explicit-type-variable-syntax.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: SIP-53 - Quote Pattern Explicit Type Variable Syntax -status: vote-requested -pull-request-number: 59 -stage: design -recommendation: accept - ---- diff --git a/_sips/sips/quote-pattern-type-variable-syntax.md b/_sips/sips/quote-pattern-type-variable-syntax.md new file mode 100644 index 0000000000..c84444767a --- /dev/null +++ b/_sips/sips/quote-pattern-type-variable-syntax.md @@ -0,0 +1,139 @@ +--- +layout: sip +permalink: /sips/:title.html +stage: implementation +status: waiting-for-implementation +title: SIP-53 - Quote pattern explicit type variable syntax +--- + +**By: Nicolas Stucki** + +## History + +| Date | Version | +|---------------|--------------------| +| Feb 28th 2022 | Initial Draft | + +## Summary + +This SIP proposes additions to the syntax of type variable definitions to bring quoted type matching to par with quoted expression matching. +Specifically, the ability to declare type variables explicitly and define them with bounds. + +It also proposes some enhancements to make the use of type variables simpler. +The idea is to reduce the number of cases where we need to write backticks around type variable name references. +Namely when using explicit type variable definitions. + +## Motivation + +### Background + +Quoted expressions support two ways of defining type variables: explicit and nested. + +##### Explicit type variables +The initial `type` declarations in the pattern with a type variable name (lowercase names as with normal pattern type variables) are type variable definitions. Type variable references need to be in backticks. Otherwise, we assume they are nested type variables and emit an error. These definitions can have bounds defined on them. +```scala +case '{ type t; $x: `t` } => f[t](x: Expr[t]) +case '{ type u; ($ls: List[`u`]).map($f: `u` => Int) } => g[u](ls: Expr[List[u]], f: Expr[u => Int]) +case '{ type tail <: Tuple; $x: *:[Int, `tail`] } => h[tail](x: Expr[*:[Int, tail]) +``` + +##### Nested type variable +Types with a type variable name introduce a new type variable. These cannot be references with a backticked reference due to their scope. We cannot add explicit bounds to them, but in certain cases we can infer their some bounds. These variables become explicit type variables in the internal representation after typing. +```scala +case '{ $x: t } => f[t](x: Expr[t]) +``` + + +##### Type Patterns +Quoted type patterns only support nested type variable definitions. Explicit type variables are not supported in the source due to an oversight. These variables become explicit type variables in the internal representation after typing. The bounds of the type variable are `Any` and `Nothing`. +```scala +case '[ t ] => f[t] +case '[ List[t] ] => g[t] +``` + +### Support type bounds in quoted type patterns + +We want to be able to set the bounds of type variables to be able to match against type constructors that have type bounds. For example, the tuple `*:` type. +```scala +case '[ head *: tail ] => h[tail] +``` +See https://github.com/lampepfl/dotty/issues/11738. + +### Support matching on any kind of type +We want to match against higher-kinded (or `AnyKind`) types. This is not possible due to the default upper bound of `Any`. +See https://github.com/lampepfl/dotty/issues/10864. + +### Support multiple references to the same type in quoted type patterns +We want to be able to match using several references to the same type variable. +```scala +case '[ (t, t, t) ] => f[t] // t is going to match the glb of the tuple T1, T2, T3 +``` + +### Simplify the use of explicit type variables +It is inconsistent to need to use backticks for references to explicit type variables in the quote but not outside. +We want to be able to refer to the variable by its non-backticked name uniformly. +```diff +- case '{ type u; ($ls: List[`u`]).map($f: `u` => Int) } => g[u](ls: Expr[List[u]], f: Expr[u => Int]) ++ case '{ type u; ($ls: List[u]).map($f: u => Int) } => g[u](ls: Expr[List[u]], f: Expr[u => Int]) +``` + +## Proposed solution + +### High-level overview + +We first want to introduce syntax for explicit type variable definitions in quoted type patterns that aligns with expression quoted patterns. We can use the syntax described in [explicit type variables](Explicit-type-variables). + +```scala +case '[ type t; List[`t`] ] => f[t] +case '[ type tail <: Tuple; *:[Int, `tail`] ] => g[tail] +``` + +Second, we want the remove the need for backticks for references to explicit type variable definitions. If we have an explicit type variable definition and a type variable with the same name, we can syntactically assume these are the same and not introduce a new nested type variable. +```scala +case '{ type t; $x: t } => f[t](x: Expr[t]) +case '{ type u; ($ls: List[u]).map($f: u => Int) } => g[u](ls: Expr[List[u]], f: Expr[u => Int]) +case '{ type tail <: Tuple; $x: *:[Int, tail] } => h[tail](x: Expr[*:[Int, tail]) +``` +```scala +case '[ type t; List[t] ] => f[t] +case '[ type tail <: Tuple; *:[Int, tail] ] => g[tail] +``` + +### Specification + +Adding the explicit type variable definition to quoted type patterns is relatively straightforward as nested type variables become explicit ones internally. We would only need to update the parser to accept a new kind of type in the syntax. This type would only be used in the quote type pattern syntax, which is self-contained in the language's grammar. + +```diff +Quoted ::= ‘'’ ‘{’ Block ‘}’ +- | ‘'’ ‘[’ Type ‘]’ ++ | ‘'’ ‘[’ TypeBlock ‘]’ ++TypeBlock ::= {TypeBlockStat semi} Type ++TypeBlockStat ::= ‘type’ {nl} TypeDcl +``` + +Allowing non-backticked references to explicit type variable definitions would not create any conflict, as these would currently cause a double definition error. The grammar would not need to change. This would only interact with the process of typing quoted patterns. + +### Compatibility + +There are no compatibility issues because the parser or typer rejected all these cases. + +TASTy only contains explicit type variable definitions, and this encoding would not change. Note that TASTy supports _type blocks_ using the regular `Block` AST. These contain type declaration in their statements and a type instead of the expression. + +### Other concerns + +* Tools that parse Scala code must be updated with this new grammar. +* Tools that use TASTy would not be affected. + +<!-- ### Open questions --> + +## Alternatives + +* We could find a different syntax for explicit type variables in quoted type patterns. The drawback is that we need to specify and explain a secondary syntax. +* Don't include the backticks improvements. + +## Related work + +* Proof of concept of type variable syntax: https://github.com/lampepfl/dotty/pull/16910 +* Proof of concept of backticks (only interested in the first bullet point): https://github.com/lampepfl/dotty/pull/16935 + +<!-- ## FAQ --> From 122bec2f28f287c0dbd308216de33b2a6c0167c1 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Wed, 26 Apr 2023 18:56:10 +0000 Subject: [PATCH 2581/3075] Update SIPs state --- .../sips/multi-source-extension-overloads.md | 235 +++++++++++++++++- 1 file changed, 230 insertions(+), 5 deletions(-) diff --git a/_sips/sips/multi-source-extension-overloads.md b/_sips/sips/multi-source-extension-overloads.md index 1e6be090a8..9812b8bbe3 100644 --- a/_sips/sips/multi-source-extension-overloads.md +++ b/_sips/sips/multi-source-extension-overloads.md @@ -1,8 +1,233 @@ --- -title: SIP-54 - Multi-Source Extension Overloads. -status: vote-requested -pull-request-number: 60 -stage: design -recommendation: accept +layout: sip +permalink: /sips/:title.html +stage: implementation +status: under-review +title: SIP-54 - Multi-Source Extension Overloads +--- + +**By: Sébastien Doeraene and Martin Odersky** + +## History + +| Date | Version | +|---------------|--------------------| +| Mar 10th 2023 | Initial Draft | + +## Summary + +We propose to allow overload resolution of `extension` methods with the same name but imported from several sources. +For example, given the following definitions: + +```scala +class Foo +class Bar + +object A: + extension (foo: Foo) def meth(): Foo = foo + def normalMeth(foo: Foo): Foo = foo + +object B: + extension (bar: Bar) def meth(): Bar = bar + def normalMeth(bar: Bar): Bar = bar +``` + +and the following use site: + +```scala +import A.* +import B.* + +val foo: Foo = ??? +foo.meth() // works with this SIP; "ambiguous import" without it + +// unchanged: +meth(foo)() // always ambiguous, just like +normalMeth(foo) // always ambiguous +``` + +## Motivation + +Extension methods are a great, straightforward way to extend external classes with additional methods. +One classical example is to add a `/` operation to `Path`: + +```scala +import java.nio.file.* + +object PathExtensions: + extension (path: Path) + def /(child: String): Path = path.resolve(child).nn + +def app1(): Unit = + import PathExtensions.* + val projectDir = Paths.get(".") / "project" +``` + +However, as currently specified, they do not compose, and effectively live in a single flat namespace. +This is understandable from the spec--the *mechanism**, which says that they are just regular methods, but is problematic from an intuitive point of view--the *intent*. + +For example, if we also use another extension that provides `/` for `URI`s, we can use it in a separate scope as follows: + +```scala +import java.net.URI + +object URIExtensions: + extension (uri: URI) + def /(child: String): URI = uri.resolve(child) + +def app2(): Unit = + import URIExtensions.* + val rootURI = new URI("https://www.example.com/") + val projectURI = rootURI / "project/" +``` + +The above does not work anymore if we need to use *both* extensions in the same scope. +The code below does not compile: + +```scala +def app(): Unit = + import PathExtensions.* + import URIExtensions.* + + val projectDir = Paths.get(".") / "project" + val rootURI = new URI("https://www.example.com/") + val projectURI = rootURI / "project/" + println(s"$projectDir -> $projectURI") +end app +``` + +*Both* attempts to use `/` result in error messages of the form + +``` +Reference to / is ambiguous, +it is both imported by import PathExtensions._ +and imported subsequently by import URIExtensions._ +``` + +### Workarounds + +The only workarounds that exist are unsatisfactory. + +We can avoid using extensions with the same name in the same scope. +In the above example, that would be annoying enough to defeat the purpose of the extensions in the first place. + +Another possibility is to *define* all extension methods of the same name in the same `object` (or as top-level definitions in the same file). +This is possible, although cumbersome, if they all come from the same library. +However, it is impossible to combine extension methods coming from separate libraries in this way. + +Finally, there exists a trick with `given`s of empty refinements: + +```scala +object PathExtensions: + given pathExtensions: {} with + extension (path: Path) + def /(child: String): Path = path.resolve(child).nn + +object URIExtensions: + given uriExtensions: {} with + extension (uri: URI) + def /(child: String): URI = uri.resolve(child) +``` + +The empty refinement `: {}` prevents those `given`s from polluting the actual implicit scope. +`extension`s defined inside `given`s that are in scope can be used, so this trick allows to use `/` with the imports of `PathExtensions.*` and `URIExtensions.*`. +The `given`s must still have different names for the trick to work. +This workaround is however quite obscure. +It hides intent behind a layer of magic (and an additional indirection at run-time). + +### Problem for migrating off of implicit classes + +Scala 2 implicit classes did not suffer from the above issues, because they were disambiguated by the name of the implicit class (not the name of the method). +This means that there are libraries that cannot migrate off of implicit classes to use `extension` methods without significantly degrading their usability. + +## Proposed solution + +We propose to relax the resolution of extension methods, so that they can be resolved from multiple imported sources. +Instead of rejecting the `/` call outright because of ambiguous imports, the compiler should try the resolution from all the imports, and keep the only one (if any) for which the receiver type matches. + +Practically speaking, this means that the above `app()` example would compile and behave as expected. + +### Non-goals + +It is *not* a goal of this proposal to allow resolution of arbitrary overloads of regular methods coming from multiple imports. +Only `extension` method calls are concerned by this proposal. +The complexity budget of relaxing *all* overloads in this way is deemed too high, whereas it is acceptable for `extension` method calls. + +For the same reason, we do not propose to change regular calls of methods that happen to be `extension` methods. + +### Specification + +We make two changes to the [specification of extension methods](https://docs.scala-lang.org/scala3/reference/contextual/extension-methods.html). + +In the section [Translation of Extension Methods](https://docs.scala-lang.org/scala3/reference/contextual/extension-methods.html#translation-of-extension-methods), we make it clearer that the "desugared" version of the call site may require an explicit qualifier. +This is not strictly a novelty of this SIP, since it could already happen with `given`s and implicit scopes, but this SIP adds one more case where this can happen. + +Previously: + +> So, the definition of circumference above translates to the following method, and can also be invoked as such: +> +> `<extension> def circumference(c: Circle): Double = c.radius * math.Pi * 2` +> +> `assert(circle.circumference == circumference(circle))` + +With this SIP: + +> So, the definition of circumference above translates to the following method, and can also be invoked as such: +> +> `<extension> def circumference(c: Circle): Double = c.radius * math.Pi * 2` +> +> `assert(circle.circumference == circumference(circle))` +> +> or +> +> `assert(circle.circumference == qualifierPath.circumference(circle))` +> +> for some `qualifierPath` in which `circumference` is actually declared. +> Explicit qualifiers may be required when the extension method is resolved through `given` instances, implicit scopes, or disambiguated from several imports. --- + +In the section [Translation of Calls to Extension Methods](https://docs.scala-lang.org/scala3/reference/contextual/extension-methods.html#translation-of-calls-to-extension-methods), we amend step 1. of "The precise rules for resolving a selection to an extension method are as follows." + +Previously: + +> Assume a selection `e.m[Ts]` where `m` is not a member of `e`, where the type arguments `[Ts]` are optional, and where `T` is the expected type. +> The following two rewritings are tried in order: +> +> 1. The selection is rewritten to `m[Ts](e)`. + +With this SIP: + +> 1. The selection is rewritten to `m[Ts](e)` and typechecked, using the following slight modification of the name resolution rules: +> +> - If `m` is imported by several imports which are all on the same nesting level, try each import as an extension method instead of failing with an ambiguity. +> If only one import leads to an expansion that typechecks without errors, pick that expansion. +> If there are several such imports, but only one import which is not a wildcard import, pick the expansion from that import. +> Otherwise, report an ambiguous reference error. + +### Compatibility + +The proposal only alters situations where the previous specification would reject the program with an ambiguous import. +Therefore, we expect it to be backward source compatible. + +The resolved calls could previously be spelled out by hand (with fully-qualified names), so binary compatibility and TASTy compatibility are not affected. + +### Other concerns + +With this SIP, some calls that would be reported as *ambiguous* in their "normal" form can actually be written without ambiguity if used as extensions. +That may be confusing to some users. +Although specific error messages are not specified and therefore outside the SIP scope, we encourage the compiler implementation to enhance the "ambiguous" error message to address this confusion. +If some or all of the involved ambiguous targets are `extension` methods, the compiler should point out that the call might be resolved unambiguously if used as an extension. + +## Alternatives + +A number of alternatives were mentioned in [the Contributors thread](https://contributors.scala-lang.org/t/change-shadowing-mechanism-of-extension-methods-for-on-par-implicit-class-behavior/5831), but none that passed the bar of "we think this is actually implementable". + +## Related work + +- [Contributors thread acting as de facto Pre-SIP](https://contributors.scala-lang.org/t/change-shadowing-mechanism-of-extension-methods-for-on-par-implicit-class-behavior/5831) +- [Pull Request in dotty](https://github.com/lampepfl/dotty/pull/17050) to support it under an experimental import + +## FAQ + +This section will probably initially be empty. As discussions on the proposal progress, it is likely that some questions will come repeatedly. They should be listed here, with appropriate answers. From 082440b3b4c181d8c08088ee9d3ebdd1298a21d1 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Tue, 25 Apr 2023 11:50:13 +0200 Subject: [PATCH 2582/3075] Add results of SIP meeting of 21st of April 2023 --- _sips/results/2023-04-21-meeting.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 _sips/results/2023-04-21-meeting.md diff --git a/_sips/results/2023-04-21-meeting.md b/_sips/results/2023-04-21-meeting.md new file mode 100644 index 0000000000..b522759d88 --- /dev/null +++ b/_sips/results/2023-04-21-meeting.md @@ -0,0 +1,12 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 21st April 2023 +partof: results +proposals: + - url: https://docs.scala-lang.org/sips/quote-pattern-type-variable-syntax.html + name: SIP-53 - Quote pattern explicit type variable syntax + result: accepted + - url: https://docs.scala-lang.org/sips/multi-source-extension-overloads.html + name: SIP-54 - Multi-Source Extension Overloads + result: accepted +--- From bfc2326e09d04038cf2f7eb363755bdb3ebf2772 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Thu, 27 Apr 2023 04:20:18 +0000 Subject: [PATCH 2583/3075] Update SIPs state --- _sips/sips/quote-pattern-type-variable-syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/quote-pattern-type-variable-syntax.md b/_sips/sips/quote-pattern-type-variable-syntax.md index c84444767a..93774b5373 100644 --- a/_sips/sips/quote-pattern-type-variable-syntax.md +++ b/_sips/sips/quote-pattern-type-variable-syntax.md @@ -81,7 +81,7 @@ We want to be able to refer to the variable by its non-backticked name uniformly ### High-level overview -We first want to introduce syntax for explicit type variable definitions in quoted type patterns that aligns with expression quoted patterns. We can use the syntax described in [explicit type variables](Explicit-type-variables). +We first want to introduce syntax for explicit type variable definitions in quoted type patterns that aligns with expression quoted patterns. We can use the syntax described in [explicit type variables](#explicit-type-variables). ```scala case '[ type t; List[`t`] ] => f[t] From 78edb5e1e08cff39c65d3c1142dcbe22ced38db6 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 26 Apr 2023 17:36:27 -0700 Subject: [PATCH 2584/3075] update Gemfile.lock for MacOS/Darwin --- Gemfile.lock | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Gemfile.lock b/Gemfile.lock index e616818b6b..db9a8aba70 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -219,6 +219,8 @@ GEM jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) minitest (5.18.0) + nokogiri (1.14.3-arm64-darwin) + racc (~> 1.4) nokogiri (1.14.3-x86_64-linux) racc (~> 1.4) octokit (4.25.1) @@ -263,6 +265,7 @@ GEM zeitwerk (2.6.7) PLATFORMS + arm64-darwin-22 x86_64-linux DEPENDENCIES From 05a1ae42c11fe34edd54bd3a38813f9b3ff09079 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Thu, 27 Apr 2023 11:32:30 +0300 Subject: [PATCH 2585/3075] Add "Functional programming" section in russian. (#2651) Co-authored-by: Dima Kotobotov <dima@kotobotov.ru> --- _overviews/scala3-book/collections-classes.md | 2 +- _overviews/scala3-book/collections-intro.md | 2 +- _overviews/scala3-book/collections-methods.md | 2 +- _overviews/scala3-book/collections-summary.md | 2 +- .../fp-functional-error-handling.md | 2 +- .../scala3-book/fp-functions-are-values.md | 2 +- _overviews/scala3-book/fp-immutable-values.md | 2 +- _overviews/scala3-book/fp-intro.md | 2 +- _overviews/scala3-book/fp-pure-functions.md | 2 +- _overviews/scala3-book/fp-summary.md | 2 +- _overviews/scala3-book/fp-what-is-fp.md | 2 +- _overviews/scala3-book/packaging-imports.md | 2 +- _ru/scala3/book/collections-classes.md | 971 ++++++++++++++++++ _ru/scala3/book/collections-intro.md | 22 + _ru/scala3/book/collections-methods.md | 662 ++++++++++++ _ru/scala3/book/collections-summary.md | 35 + _ru/scala3/book/control-structures.md | 4 +- .../book/fp-functional-error-handling.md | 436 ++++++++ _ru/scala3/book/fp-functions-are-values.md | 161 +++ _ru/scala3/book/fp-immutable-values.md | 109 ++ _ru/scala3/book/fp-intro.md | 31 + _ru/scala3/book/fp-pure-functions.md | 153 +++ _ru/scala3/book/fp-summary.md | 31 + _ru/scala3/book/fp-what-is-fp.md | 48 + _ru/scala3/book/fun-summary.md | 2 +- _ru/scala3/book/packaging-imports.md | 418 ++++++++ 26 files changed, 3092 insertions(+), 15 deletions(-) create mode 100644 _ru/scala3/book/collections-classes.md create mode 100644 _ru/scala3/book/collections-intro.md create mode 100644 _ru/scala3/book/collections-methods.md create mode 100644 _ru/scala3/book/collections-summary.md create mode 100644 _ru/scala3/book/fp-functional-error-handling.md create mode 100644 _ru/scala3/book/fp-functions-are-values.md create mode 100644 _ru/scala3/book/fp-immutable-values.md create mode 100644 _ru/scala3/book/fp-intro.md create mode 100644 _ru/scala3/book/fp-pure-functions.md create mode 100644 _ru/scala3/book/fp-summary.md create mode 100644 _ru/scala3/book/fp-what-is-fp.md create mode 100644 _ru/scala3/book/packaging-imports.md diff --git a/_overviews/scala3-book/collections-classes.md b/_overviews/scala3-book/collections-classes.md index b9ba20afc8..c68bc9e035 100644 --- a/_overviews/scala3-book/collections-classes.md +++ b/_overviews/scala3-book/collections-classes.md @@ -2,7 +2,7 @@ title: Collections Types type: section description: This page introduces the common Scala 3 collections types and some of their methods. -languages: [zh-cn] +languages: [ru, zh-cn] num: 37 previous-page: collections-intro next-page: collections-methods diff --git a/_overviews/scala3-book/collections-intro.md b/_overviews/scala3-book/collections-intro.md index 8a0ae572ba..befedef0e6 100644 --- a/_overviews/scala3-book/collections-intro.md +++ b/_overviews/scala3-book/collections-intro.md @@ -2,7 +2,7 @@ title: Scala Collections type: chapter description: This page provides and introduction to the common collections classes and their methods in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 36 previous-page: packaging-imports next-page: collections-classes diff --git a/_overviews/scala3-book/collections-methods.md b/_overviews/scala3-book/collections-methods.md index 35fcb72b70..f165a2c0e9 100644 --- a/_overviews/scala3-book/collections-methods.md +++ b/_overviews/scala3-book/collections-methods.md @@ -2,7 +2,7 @@ title: Collections Methods type: section description: This page demonstrates the common methods on the Scala 3 collections classes. -languages: [zh-cn] +languages: [ru, zh-cn] num: 38 previous-page: collections-classes next-page: collections-summary diff --git a/_overviews/scala3-book/collections-summary.md b/_overviews/scala3-book/collections-summary.md index 446c8b90c9..c8ac5512fa 100644 --- a/_overviews/scala3-book/collections-summary.md +++ b/_overviews/scala3-book/collections-summary.md @@ -2,7 +2,7 @@ title: Summary type: section description: This page provides a summary of the Collections chapter. -languages: [zh-cn] +languages: [ru, zh-cn] num: 39 previous-page: collections-methods next-page: fp-intro diff --git a/_overviews/scala3-book/fp-functional-error-handling.md b/_overviews/scala3-book/fp-functional-error-handling.md index edc5f8a5ed..829845eaf8 100644 --- a/_overviews/scala3-book/fp-functional-error-handling.md +++ b/_overviews/scala3-book/fp-functional-error-handling.md @@ -2,7 +2,7 @@ title: Functional Error Handling type: section description: This section provides an introduction to functional error handling in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 45 previous-page: fp-functions-are-values next-page: fp-summary diff --git a/_overviews/scala3-book/fp-functions-are-values.md b/_overviews/scala3-book/fp-functions-are-values.md index b4df001cce..48f7e4ca3a 100644 --- a/_overviews/scala3-book/fp-functions-are-values.md +++ b/_overviews/scala3-book/fp-functions-are-values.md @@ -2,7 +2,7 @@ title: Functions Are Values type: section description: This section looks at the use of functions as values in functional programming. -languages: [zh-cn] +languages: [ru, zh-cn] num: 44 previous-page: fp-pure-functions next-page: fp-functional-error-handling diff --git a/_overviews/scala3-book/fp-immutable-values.md b/_overviews/scala3-book/fp-immutable-values.md index 6202943906..413d2d0495 100644 --- a/_overviews/scala3-book/fp-immutable-values.md +++ b/_overviews/scala3-book/fp-immutable-values.md @@ -2,7 +2,7 @@ title: Immutable Values type: section description: This section looks at the use of immutable values in functional programming. -languages: [zh-cn] +languages: [ru, zh-cn] num: 42 previous-page: fp-what-is-fp next-page: fp-pure-functions diff --git a/_overviews/scala3-book/fp-intro.md b/_overviews/scala3-book/fp-intro.md index 56c43362c8..7d6e6f4114 100644 --- a/_overviews/scala3-book/fp-intro.md +++ b/_overviews/scala3-book/fp-intro.md @@ -2,7 +2,7 @@ title: Functional Programming type: chapter description: This chapter provides an introduction to functional programming in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 40 previous-page: collections-summary next-page: fp-what-is-fp diff --git a/_overviews/scala3-book/fp-pure-functions.md b/_overviews/scala3-book/fp-pure-functions.md index fd7c356421..754d6f46a5 100644 --- a/_overviews/scala3-book/fp-pure-functions.md +++ b/_overviews/scala3-book/fp-pure-functions.md @@ -2,7 +2,7 @@ title: Pure Functions type: section description: This section looks at the use of pure functions in functional programming. -languages: [zh-cn] +languages: [ru, zh-cn] num: 43 previous-page: fp-immutable-values next-page: fp-functions-are-values diff --git a/_overviews/scala3-book/fp-summary.md b/_overviews/scala3-book/fp-summary.md index 7a9caff971..55233f851c 100644 --- a/_overviews/scala3-book/fp-summary.md +++ b/_overviews/scala3-book/fp-summary.md @@ -2,7 +2,7 @@ title: Summary type: section description: This section summarizes the previous functional programming sections. -languages: [zh-cn] +languages: [ru, zh-cn] num: 46 previous-page: fp-functional-error-handling next-page: types-introduction diff --git a/_overviews/scala3-book/fp-what-is-fp.md b/_overviews/scala3-book/fp-what-is-fp.md index 034f2ecc16..1e37279ae0 100644 --- a/_overviews/scala3-book/fp-what-is-fp.md +++ b/_overviews/scala3-book/fp-what-is-fp.md @@ -2,7 +2,7 @@ title: What is Functional Programming? type: section description: This section provides an answer to the question, what is functional programming? -languages: [zh-cn] +languages: [ru, zh-cn] num: 41 previous-page: fp-intro next-page: fp-immutable-values diff --git a/_overviews/scala3-book/packaging-imports.md b/_overviews/scala3-book/packaging-imports.md index 56f3e86194..562fc69a46 100644 --- a/_overviews/scala3-book/packaging-imports.md +++ b/_overviews/scala3-book/packaging-imports.md @@ -2,7 +2,7 @@ title: Packaging and Imports type: chapter description: A discussion of using packages and imports to organize your code, build related modules of code, control scope, and help prevent namespace collisions. -languages: [zh-cn] +languages: [ru, zh-cn] num: 35 previous-page: fun-summary next-page: collections-intro diff --git a/_ru/scala3/book/collections-classes.md b/_ru/scala3/book/collections-classes.md new file mode 100644 index 0000000000..53f169249f --- /dev/null +++ b/_ru/scala3/book/collections-classes.md @@ -0,0 +1,971 @@ +--- +layout: multipage-overview +title: Типы коллекций +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: На этой странице представлены общие типы коллекций Scala 3 и некоторые из их методов. +language: ru +num: 37 +previous-page: collections-intro +next-page: collections-methods +--- + + +На этой странице показаны общие коллекции Scala 3 и сопутствующие им методы. +Scala поставляется с большим количеством типов коллекций, на изучение которых может уйти время, +поэтому желательно начать с нескольких из них, а затем использовать остальные по мере необходимости. +Точно так же у каждого типа коллекции есть десятки методов, облегчающих разработку, +поэтому лучше начать изучение лишь с небольшого количества. + +В этом разделе представлены наиболее распространенные типы и методы коллекций, +которые вам понадобятся для начала работы. + +В конце этого раздела представлены дополнительные ссылки, для более глубокого изучения коллекций. + +## Три основные категории коллекций + +Для коллекций Scala можно выделить три основные категории: + +- **Последовательности** (**Sequences**/**Seq**) представляют собой последовательный набор элементов + и могут быть _индексированными_ (как массив) или _линейными_ (как связанный список) +- **Мапы** (**Maps**) содержат набор пар ключ/значение, например Java `Map`, Python dictionary или Ruby `Hash` +- **Множества** (**Sets**) — это неупорядоченный набор уникальных элементов + +Все они являются базовыми типами и имеют подтипы подходящие под конкретные задачи, +таких как параллелизм (concurrency), кэширование (caching) и потоковая передача (streaming). +В дополнение к этим трем основным категориям существуют и другие полезные типы коллекций, +включая диапазоны (ranges), стеки (stacks) и очереди (queues). + + +### Иерархия коллекций + +В качестве краткого обзора следующие три рисунка показывают иерархию классов и трейтов в коллекциях Scala. + +На первом рисунке показаны типы коллекций в пакете _scala.collection_. +Все это высокоуровневые абстрактные классы или трейты, которые обычно имеют _неизменяемые_ и _изменяемые_ реализации. + +![General collection hierarchy][collections1] + +На этом рисунке показаны все коллекции в пакете _scala.collection.immutable_: + +![Immutable collection hierarchy][collections2] + +А на этом рисунке показаны все коллекции в пакете _scala.collection.mutable_: + +![Mutable collection hierarchy][collections3] + +В следующих разделах представлены некоторые из распространенных типов. + +## Общие коллекции + +Основные коллекции, используемые чаще всего: + +| Тип коллекции | Неизменяемая | Изменяемая | Описание | +|----------------|--------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `List` | ✓ | | Линейная неизменяемая последовательность (связный список) | +| `Vector` | ✓ | | Индексированная неизменяемая последовательность | +| `LazyList` | ✓ | | Ленивый неизменяемый связанный список, элементы которого вычисляются только тогда, когда они необходимы; подходит для больших или бесконечных последовательностей. | +| `ArrayBuffer` | | ✓ | Подходящий тип для изменяемой индексированной последовательности | +| `ListBuffer` | | ✓ | Используется, когда вам нужен изменяемый список; обычно преобразуется в `List` | +| `Map` | ✓ | ✓ | Итерируемая коллекция, состоящая из пар ключей и значений | +| `Set` | ✓ | ✓ | Итерируемая коллекция без повторяющихся элементов | + +Как показано, `Map` и `Set` бывают как изменяемыми, так и неизменяемыми. + +Основы каждого типа демонстрируются в следующих разделах. + +> В Scala _буфер_ (_buffer_), такой как `ArrayBuffer` или `ListBuffer`, представляет собой последовательность, +> которая может увеличиваться и уменьшаться. + +### Примечание о неизменяемых коллекциях + +В последующих разделах всякий раз, когда используется слово _immutable_, можно с уверенностью сказать, +что тип предназначен для использования в стиле _функционального программирования_ (ФП). +С помощью таких типов коллекция не меняется, +а при вызове функциональных методов возвращается новый результат - новая коллекция. + +## Выбор последовательности + +При выборе _последовательности_ (последовательной коллекции элементов) нужно руководствоваться двумя основными вопросами: + +- должна ли последовательность индексироваться (как массив), обеспечивая быстрый доступ к любому элементу, + или она должна быть реализована как линейный связанный список? +- необходима изменяемая или неизменяемая коллекция? + +Рекомендуемые универсальные последовательности: + +| Тип\Категория | Неизменяемая | Изменяемая | +|-----------------------------|--------------|---------------| +| индексируемая | `Vector` | `ArrayBuffer` | +| линейная (связанный список) | `List` | `ListBuffer` | + +Например, если нужна неизменяемая индексированная коллекция, в общем случае следует использовать `Vector`. +И наоборот, если нужна изменяемая индексированная коллекция, используйте `ArrayBuffer`. + +> `List` и `Vector` часто используются при написании кода в функциональном стиле. +> `ArrayBuffer` обычно используется при написании кода в императивном стиле. +> `ListBuffer` используется тогда, когда стили смешиваются, например, при создании списка. + +Следующие несколько разделов кратко демонстрируют типы `List`, `Vector` и `ArrayBuffer`. + + +## `List` + +[List](https://www.scala-lang.org/api/current/scala/collection/immutable/List.html) +представляет собой линейную неизменяемую последовательность. +Каждый раз, когда в список добавляются или удаляются элементы, по сути создается новый список из существующего. + +### Создание списка + +`List` можно создать различными способами: + +{% tabs list-creation %} + +{% tab 'Scala 2 и 3' %} +```scala +val ints = List(1, 2, 3) +val names = List("Joel", "Chris", "Ed") + +// другой путь создания списка List +val namesAgain = "Joel" :: "Chris" :: "Ed" :: Nil +``` +{% endtab %} + +{% endtabs %} + +При желании тип списка можно объявить, хотя обычно в этом нет необходимости: + +{% tabs list-type %} + +{% tab 'Scala 2 и 3' %} +```scala +val ints: List[Int] = List(1, 2, 3) +val names: List[String] = List("Joel", "Chris", "Ed") +``` +{% endtab %} + +{% endtabs %} + +Одно исключение — когда в коллекции смешанные типы; в этом случае тип желательно указывать явно: + +{% tabs list-mixed-types class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +val things: List[Any] = List(1, "two", 3.0) +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +val things: List[String | Int | Double] = List(1, "two", 3.0) // с типами объединения +val thingsAny: List[Any] = List(1, "two", 3.0) // с Any +``` +{% endtab %} + +{% endtabs %} + +### Добавление элементов в список + +Поскольку `List` неизменяем, в него нельзя добавлять новые элементы. +Вместо этого создается новый список с добавленными к существующему списку элементами. +Например, учитывая этот `List`: + +{% tabs adding-elements-init %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = List(1, 2, 3) +``` +{% endtab %} + +{% endtabs %} + +Для _добавления_ (_prepend_) к началу списка одного элемента используется метод `::`, для добавления нескольких — `:::`, как показано здесь: + +{% tabs adding-elements-example %} + +{% tab 'Scala 2 и 3' %} +```scala +val b = 0 :: a // List(0, 1, 2, 3) +val c = List(-1, 0) ::: a // List(-1, 0, 1, 2, 3) +``` +{% endtab %} + +{% endtabs %} + +Также можно _добавить_ (_append_) элементы в конец `List`, но, поскольку `List` является односвязным, +следует добавлять к нему элементы только в начало; +добавление элементов в конец списка — относительно медленная операция, +особенно при работе с большими последовательностями. + +> Совет: если необходимо добавлять к неизменяемой последовательности элементы в начало и конец, используйте `Vector`. + +Поскольку `List` является связанным списком, +крайне нежелательно пытаться получить доступ к элементам больших списков по значению их индекса. +Например, если есть `List` с миллионом элементов, доступ к такому элементу, как `myList(999_999)`, +займет относительно много времени, потому что этот запрос должен пройти почти через все элементы. +Если есть большая коллекция и необходимо получать доступ к элементам по их индексу, то +вместо `List` используйте `Vector` или `ArrayBuffer`. + +### Как запомнить названия методов + +В методах Scala символ `:` представляет сторону, на которой находится последовательность, +поэтому, когда используется метод `+:`, список нужно указывать справа: + +{% tabs list-prepending %} + +{% tab 'Scala 2 и 3' %} +```scala +0 +: a +``` +{% endtab %} + +{% endtabs %} + +Аналогично, если используется `:+`, список должен быть слева: + +{% tabs list-appending %} + +{% tab 'Scala 2 и 3' %} +```scala +a :+ 4 +``` +{% endtab %} + +{% endtabs %} + +Хорошей особенностью таких символических имен у методов является то, что они стандартизированы. + +Те же имена методов используются с другими неизменяемыми последовательностями, такими как `Seq` и `Vector`. +Также можно использовать несимволические имена методов для добавления элементов в начало (`a.prepended(4)`) +или конец (`a.appended(4)`). + +### Как пройтись по списку + +Представим, что есть `List` имён: + +{% tabs list-loop-init %} + +{% tab 'Scala 2 и 3' %} +```scala +val names = List("Joel", "Chris", "Ed") +``` +{% endtab %} + +{% endtabs %} + +Напечатать каждое имя можно следующим способом: + +{% tabs list-loop-example class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +for (name <- names) println(name) +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +for name <- names do println(name) +``` +{% endtab %} + +{% endtabs %} + +Вот как это выглядит в REPL: + +{% tabs list-loop-repl class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +scala> for (name <- names) println(name) +Joel +Chris +Ed +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +scala> for name <- names do println(name) +Joel +Chris +Ed +``` +{% endtab %} + +{% endtabs %} + + +Преимуществом использования выражений вида `for` с коллекциями в том, что Scala стандартизирован, +и один и тот же подход работает со всеми последовательностями, +включая `Array`, `ArrayBuffer`, `List`, `Seq`, `Vector`, `Map`, `Set` и т.д. + +### Немного истории + +Список Scala подобен списку из языка программирования [Lisp](https://en.wikipedia.org/wiki/Lisp_(programming_language)), +который был впервые представлен в 1958 году. +Действительно, в дополнение к привычному способу создания списка: + +{% tabs list-history-init %} + +{% tab 'Scala 2 и 3' %} +```scala +val ints = List(1, 2, 3) +``` +{% endtab %} + +{% endtabs %} + +точно такой же список можно создать следующим образом: + +{% tabs list-history-init2 %} + +{% tab 'Scala 2 и 3' %} +```scala +val list = 1 :: 2 :: 3 :: Nil +``` +{% endtab %} + +{% endtabs %} + +REPL показывает, как это работает: + +{% tabs list-history-repl %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> val list = 1 :: 2 :: 3 :: Nil +list: List[Int] = List(1, 2, 3) +``` +{% endtab %} + +{% endtabs %} + +Это работает, потому что `List` — односвязный список, оканчивающийся элементом `Nil`, +а `::` — это метод `List`, работающий как оператор “cons” в Lisp. + + +### Отступление: LazyList + +Коллекции Scala также включают [LazyList](https://www.scala-lang.org/api/current/scala/collection/immutable/LazyList.html), +который представляет собой _ленивый_ неизменяемый связанный список. +Он называется «ленивым» — или нестрогим — потому что вычисляет свои элементы только тогда, когда они необходимы. + +Вы можете увидеть отложенное вычисление `LazyList` в REPL: + +{% tabs lazylist-example %} + +{% tab 'Scala 2 и 3' %} +```scala +val x = LazyList.range(1, Int.MaxValue) +x.take(1) // LazyList(<not computed>) +x.take(5) // LazyList(<not computed>) +x.map(_ + 1) // LazyList(<not computed>) +``` +{% endtab %} + +{% endtabs %} + +Во всех этих примерах ничего не происходит. +Действительно, ничего не произойдет, пока вы не заставите это произойти, например, вызвав метод `foreach`: + +{% tabs lazylist-evaluation-example %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> x.take(1).foreach(println) +1 +``` +{% endtab %} + +{% endtabs %} + +Дополнительные сведения об использовании, преимуществах и недостатках строгих и нестрогих (ленивых) коллекций +см. в обсуждениях “строгих” и “нестрогих” на странице [Архитектура коллекции в Scala 2.13][strict]. + +## Vector + +[Vector](https://www.scala-lang.org/api/current/scala/collection/immutable/Vector.html) - это индексируемая неизменяемая последовательность. +“Индексируемая” часть описания означает, что она обеспечивает произвольный доступ +и обновление за практически постоянное время, +поэтому можно быстро получить доступ к элементам `Vector` по значению их индекса, +например, получить доступ к `listOfPeople(123_456_789)`. + +В общем, за исключением той разницы, что (а) `Vector` индексируется, а `List` - нет, +и (б) `List` имеет метод `::`, эти два типа работают одинаково, +поэтому мы быстро пробежимся по следующим примерам. + +Вот несколько способов создания `Vector`: + +{% tabs vector-creation %} + +{% tab 'Scala 2 и 3' %} +```scala +val nums = Vector(1, 2, 3, 4, 5) + +val strings = Vector("one", "two") + +case class Person(name: String) +val people = Vector( + Person("Bert"), + Person("Ernie"), + Person("Grover") +) +``` +{% endtab %} + +{% endtabs %} + +Поскольку `Vector` неизменяем, в него нельзя добавить новые элементы. +Вместо этого создается новая последовательность, с добавленными к существующему `Vector` в начало или в конец элементами. + +Например, так элементы добавляются в конец: + +{% tabs vector-appending %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = Vector(1,2,3) // Vector(1, 2, 3) +val b = a :+ 4 // Vector(1, 2, 3, 4) +val c = a ++ Vector(4, 5) // Vector(1, 2, 3, 4, 5) +``` +{% endtab %} + +{% endtabs %} + +А так - в начало Vector-а: + +{% tabs vector-prepending %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = Vector(1,2,3) // Vector(1, 2, 3) +val b = 0 +: a // Vector(0, 1, 2, 3) +val c = Vector(-1, 0) ++: a // Vector(-1, 0, 1, 2, 3) +``` +{% endtab %} + +{% endtabs %} + +В дополнение к быстрому произвольному доступу и обновлениям, `Vector` обеспечивает быстрое добавление в начало и конец. + +> Подробную информацию о производительности `Vector` и других коллекций +> см. [в характеристиках производительности коллекций](https://docs.scala-lang.org/overviews/collections-2.13/performance-characteristics.html). + +Наконец, `Vector` в выражениях вида `for` используется точно так же, как `List`, `ArrayBuffer` или любая другая последовательность: + +{% tabs vector-loop class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +scala> val names = Vector("Joel", "Chris", "Ed") +val names: Vector[String] = Vector(Joel, Chris, Ed) + +scala> for (name <- names) println(name) +Joel +Chris +Ed +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +scala> val names = Vector("Joel", "Chris", "Ed") +val names: Vector[String] = Vector(Joel, Chris, Ed) + +scala> for name <- names do println(name) +Joel +Chris +Ed +``` +{% endtab %} + +{% endtabs %} + + +## ArrayBuffer + +`ArrayBuffer` используется тогда, когда нужна изменяемая индексированная последовательность общего назначения. +Поскольку `ArrayBuffer` индексирован, произвольный доступ к элементам выполняется быстро. + +### Создание ArrayBuffer + +Чтобы использовать `ArrayBuffer`, его нужно вначале импортировать: + +{% tabs arraybuffer-import %} + +{% tab 'Scala 2 и 3' %} +```scala +import scala.collection.mutable.ArrayBuffer +``` +{% endtab %} + +{% endtabs %} + +Если необходимо начать с пустого `ArrayBuffer`, просто укажите его тип: + +{% tabs arraybuffer-creation %} + +{% tab 'Scala 2 и 3' %} +```scala +var strings = ArrayBuffer[String]() +var ints = ArrayBuffer[Int]() +var people = ArrayBuffer[Person]() +``` +{% endtab %} + +{% endtabs %} + +Если известен примерный размер `ArrayBuffer`, его можно задать: + +{% tabs list-creation-with-size %} + +{% tab 'Scala 2 и 3' %} +```scala +// готов вместить 100 000 чисел +val buf = new ArrayBuffer[Int](100_000) +``` +{% endtab %} + +{% endtabs %} + +Чтобы создать новый `ArrayBuffer` с начальными элементами, +достаточно просто указать начальные элементы, как для `List` или `Vector`: + +{% tabs arraybuffer-init %} + +{% tab 'Scala 2 и 3' %} +```scala +val nums = ArrayBuffer(1, 2, 3) +val people = ArrayBuffer( + Person("Bert"), + Person("Ernie"), + Person("Grover") +) +``` +{% endtab %} + +{% endtabs %} + +### Добавление элементов в ArrayBuffer + +Новые элементы добавляются в `ArrayBuffer` с помощью методов `+=` и `++=`. +Также можно использовать текстовый аналог: `append`, `appendAll`, `insert`, `insertAll`, `prepend` и `prependAll`. +Вот несколько примеров с `+=` и `++=`: + +{% tabs arraybuffer-add %} + +{% tab 'Scala 2 и 3' %} +```scala +val nums = ArrayBuffer(1, 2, 3) // ArrayBuffer(1, 2, 3) +nums += 4 // ArrayBuffer(1, 2, 3, 4) +nums ++= List(5, 6) // ArrayBuffer(1, 2, 3, 4, 5, 6) +``` +{% endtab %} + +{% endtabs %} + +### Удаление элементов из ArrayBuffer + +`ArrayBuffer` является изменяемым, +поэтому у него есть такие методы, как `-=`, `--=`, `clear`, `remove` и другие. +Примеры с `-=` и `--=`: + +{% tabs arraybuffer-remove %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = ArrayBuffer.range('a', 'h') // ArrayBuffer(a, b, c, d, e, f, g) +a -= 'a' // ArrayBuffer(b, c, d, e, f, g) +a --= Seq('b', 'c') // ArrayBuffer(d, e, f, g) +a --= Set('d', 'e') // ArrayBuffer(f, g) +``` +{% endtab %} + +{% endtabs %} + +### Обновление элементов в ArrayBuffer + +Элементы в `ArrayBuffer` можно обновлять, либо переназначать: + +{% tabs arraybuffer-update %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = ArrayBuffer.range(1,5) // ArrayBuffer(1, 2, 3, 4) +a(2) = 50 // ArrayBuffer(1, 2, 50, 4) +a.update(0, 10) // ArrayBuffer(10, 2, 50, 4) +``` +{% endtab %} + +{% endtabs %} + + + +## Maps + +`Map` — это итерируемая коллекция, состоящая из пар ключей и значений. +В Scala есть как изменяемые, так и неизменяемые типы `Map`. +В этом разделе показано, как использовать _неизменяемый_ `Map`. + +### Создание неизменяемой Map + +Неизменяемая `Map` создается следующим образом: + +{% tabs map-init %} + +{% tab 'Scala 2 и 3' %} +```scala +val states = Map( + "AK" -> "Alaska", + "AL" -> "Alabama", + "AZ" -> "Arizona" +) +``` +{% endtab %} + +{% endtabs %} + +Перемещаться по элементам `Map` используя выражение `for` можно следующим образом: + +{% tabs map-loop class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +for ((k, v) <- states) println(s"key: $k, value: $v") +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +for (k, v) <- states do println(s"key: $k, value: $v") +``` +{% endtab %} + +{% endtabs %} + +REPL показывает, как это работает: + +{% tabs map-repl class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +scala> for ((k, v) <- states) println(s"key: $k, value: $v") +key: AK, value: Alaska +key: AL, value: Alabama +key: AZ, value: Arizona +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +scala> for (k, v) <- states do println(s"key: $k, value: $v") +key: AK, value: Alaska +key: AL, value: Alabama +key: AZ, value: Arizona +``` +{% endtab %} + +{% endtabs %} + +### Доступ к элементам Map + +Доступ к элементам `Map` осуществляется через указание в скобках значения ключа: + +{% tabs map-access-element %} + +{% tab 'Scala 2 и 3' %} +```scala +val ak = states("AK") // ak: String = Alaska +val al = states("AL") // al: String = Alabama +``` +{% endtab %} + +{% endtabs %} + +На практике также используются такие методы, как `keys`, `keySet`, `keysIterator`, `for` выражения +и функции высшего порядка, такие как `map`, для работы с ключами и значениями `Map`. + +### Добавление элемента в Map + +При добавлении элементов в неизменяемую мапу с помощью `+` и `++`, создается новая мапа: + +{% tabs map-add-element %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = Map(1 -> "one") // a: Map(1 -> one) +val b = a + (2 -> "two") // b: Map(1 -> one, 2 -> two) +val c = b ++ Seq( + 3 -> "three", + 4 -> "four" +) +// c: Map(1 -> one, 2 -> two, 3 -> three, 4 -> four) +``` +{% endtab %} + +{% endtabs %} + +### Удаление элементов из Map + +Элементы удаляются с помощью методов `-` или `--`. +В случае неизменяемой `Map` создается новый экземпляр, который нужно присвоить новой переменной: + +{% tabs map-remove-element %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = Map( + 1 -> "one", + 2 -> "two", + 3 -> "three", + 4 -> "four" +) + +val b = a - 4 // b: Map(1 -> one, 2 -> two, 3 -> three) +val c = a - 4 - 3 // c: Map(1 -> one, 2 -> two) +``` +{% endtab %} + +{% endtabs %} + +### Обновление элементов в Map + +Чтобы обновить элементы на неизменяемой `Map`, используется метод `update` (или оператор `+`): + +{% tabs map-update-element %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = Map( + 1 -> "one", + 2 -> "two", + 3 -> "three" +) + +val b = a.updated(3, "THREE!") // b: Map(1 -> one, 2 -> two, 3 -> THREE!) +val c = a + (2 -> "TWO...") // c: Map(1 -> one, 2 -> TWO..., 3 -> three) +``` +{% endtab %} + +{% endtabs %} + +### Перебор элементов в Map + +Элементы в `Map` можно перебрать с помощью выражения `for`, как и для остальных коллекций: + +{% tabs map-traverse class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +val states = Map( + "AK" -> "Alaska", + "AL" -> "Alabama", + "AZ" -> "Arizona" +) + +for ((k, v) <- states) println(s"key: $k, value: $v") +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +val states = Map( + "AK" -> "Alaska", + "AL" -> "Alabama", + "AZ" -> "Arizona" +) + +for (k, v) <- states do println(s"key: $k, value: $v") +``` +{% endtab %} + +{% endtabs %} + +Существует _много_ способов работы с ключами и значениями на `Map`. +Общие методы `Map` включают `foreach`, `map`, `keys` и `values`. + +В Scala есть много других специализированных типов `Map`, +включая `CollisionProofHashMap`, `HashMap`, `LinkedHashMap`, `ListMap`, `SortedMap`, `TreeMap`, `WeakHashMap` и другие. + + +## Работа с множествами + +Множество ([Set]({{site.baseurl}}/overviews/collections-2.13/sets.html)) - итерируемая коллекция без повторяющихся элементов. + +В Scala есть как изменяемые, так и неизменяемые типы `Set`. +В этом разделе демонстрируется _неизменяемое_ множество. + +### Создание множества + +Создание нового пустого множества: + +{% tabs set-creation %} + +{% tab 'Scala 2 и 3' %} +```scala +val nums = Set[Int]() +val letters = Set[Char]() +``` +{% endtab %} + +{% endtabs %} + +Создание множества с исходными данными: + +{% tabs set-init %} + +{% tab 'Scala 2 и 3' %} +```scala +val nums = Set(1, 2, 3, 3, 3) // Set(1, 2, 3) +val letters = Set('a', 'b', 'c', 'c') // Set('a', 'b', 'c') +``` +{% endtab %} + +{% endtabs %} + + +### Добавление элементов в множество + +В неизменяемое множество новые элементы добавляются с помощью `+` и `++`, результат присваивается новой переменной: + +{% tabs set-add-element %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = Set(1, 2) // Set(1, 2) +val b = a + 3 // Set(1, 2, 3) +val c = b ++ Seq(4, 1, 5, 5) // HashSet(5, 1, 2, 3, 4) +``` +{% endtab %} + +{% endtabs %} + +Стоит отметить, что повторяющиеся элементы не добавляются в множество, +а также, что порядок элементов произвольный. + + +### Удаление элементов из множества + +Элементы из множества удаляются с помощью методов `-` и `--`, результат также должен присваиваться новой переменной: + +{% tabs set-remove-element %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = Set(1, 2, 3, 4, 5) // HashSet(5, 1, 2, 3, 4) +val b = a - 5 // HashSet(1, 2, 3, 4) +val c = b -- Seq(3, 4) // HashSet(1, 2) +``` +{% endtab %} + +{% endtabs %} + + + +## Диапазон (Range) + +`Range` часто используется для заполнения структур данных и для `for` выражений. +Эти REPL примеры демонстрируют, как создавать диапазоны: + +{% tabs range-init %} + +{% tab 'Scala 2 и 3' %} +```scala +1 to 5 // Range(1, 2, 3, 4, 5) +1 until 5 // Range(1, 2, 3, 4) +1 to 10 by 2 // Range(1, 3, 5, 7, 9) +'a' to 'c' // NumericRange(a, b, c) +``` +{% endtab %} + +{% endtabs %} + +Range можно использовать для заполнения коллекций: + +{% tabs range-conversion %} + +{% tab 'Scala 2 и 3' %} +```scala +val x = (1 to 5).toList // List(1, 2, 3, 4, 5) +val x = (1 to 5).toBuffer // ArrayBuffer(1, 2, 3, 4, 5) +``` +{% endtab %} + +{% endtabs %} + +Они также используются в `for` выражениях: + +{% tabs range-iteration class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +scala> for (i <- 1 to 3) println(i) +1 +2 +3 +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +scala> for i <- 1 to 3 do println(i) +1 +2 +3 +``` +{% endtab %} + +{% endtabs %} + +Во многих коллекциях есть метод `range`: + +{% tabs range-methods %} + +{% tab 'Scala 2 и 3' %} +```scala +Vector.range(1, 5) // Vector(1, 2, 3, 4) +List.range(1, 10, 2) // List(1, 3, 5, 7, 9) +Set.range(1, 10) // HashSet(5, 1, 6, 9, 2, 7, 3, 8, 4) +``` +{% endtab %} + +{% endtabs %} + +Диапазоны также полезны для создания тестовых коллекций: + +{% tabs range-tests %} + +{% tab 'Scala 2 и 3' %} +```scala +val evens = (0 to 10 by 2).toList // List(0, 2, 4, 6, 8, 10) +val odds = (1 to 10 by 2).toList // List(1, 3, 5, 7, 9) +val doubles = (1 to 5).map(_ * 2.0) // Vector(2.0, 4.0, 6.0, 8.0, 10.0) + +// Создание Map +val map = (1 to 3).map(e => (e,s"$e")).toMap +// map: Map[Int, String] = Map(1 -> "1", 2 -> "2", 3 -> "3") +``` +{% endtab %} + +{% endtabs %} + + +## Больше деталей + +Если вам нужна дополнительная информация о специализированных коллекциях, см. следующие ресурсы: + +- [Конкретные неизменяемые классы коллекций](https://docs.scala-lang.org/overviews/collections-2.13/concrete-immutable-collection-classes.html) +- [Конкретные изменяемые классы коллекций](https://docs.scala-lang.org/overviews/collections-2.13/concrete-mutable-collection-classes.html) +- [Как устроены коллекции? Какую из них следует выбрать?](https://docs.scala-lang.org/tutorials/FAQ/collections.html) + + + +[strict]: {% link _overviews/core/architecture-of-scala-213-collections.md %} +[collections1]: /resources/images/tour/collections-diagram-213.svg +[collections2]: /resources/images/tour/collections-immutable-diagram-213.svg +[collections3]: /resources/images/tour/collections-mutable-diagram-213.svg diff --git a/_ru/scala3/book/collections-intro.md b/_ru/scala3/book/collections-intro.md new file mode 100644 index 0000000000..92793002fe --- /dev/null +++ b/_ru/scala3/book/collections-intro.md @@ -0,0 +1,22 @@ +--- +layout: multipage-overview +title: Коллекции в Scala +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: chapter +description: На этой странице представлено введение в общие классы коллекций и их методы в Scala 3. +language: ru +num: 36 +previous-page: packaging-imports +next-page: collections-classes +--- + +В этой главе представлены наиболее распространенные коллекции Scala 3 и сопутствующие им методы. +Scala поставляется с множеством типов коллекций, +Вы можете многого добиться, начав использовать лишь небольшое количество типов, а затем, по мере необходимости, начать применять остальные. +Точно так же у каждого типа есть десятки методов, +облегчающих разработку, но можно многого добиться, начав лишь с нескольких. + +Поэтому в этом разделе представлены наиболее распространенные типы и методы коллекций, +которые вам понадобятся для начала работы. diff --git a/_ru/scala3/book/collections-methods.md b/_ru/scala3/book/collections-methods.md new file mode 100644 index 0000000000..503b52d705 --- /dev/null +++ b/_ru/scala3/book/collections-methods.md @@ -0,0 +1,662 @@ +--- +layout: multipage-overview +title: Методы в коллекциях +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: На этой странице показаны общие методы классов коллекций Scala 3. +language: ru +num: 38 +previous-page: collections-classes +next-page: collections-summary +--- + + + +Важным преимуществом коллекций Scala является то, что они поставляются с десятками методов “из коробки”, +которые доступны как для неизменяемых, так и для изменяемых типов коллекций. +Больше нет необходимости писать пользовательские циклы `for` каждый раз, когда нужно работать с коллекцией. +При переходе от одного проекта к другому, можно обнаружить, что используются одни и те же методы. + +В коллекциях доступны _десятки_ методов, поэтому здесь показаны не все из них. +Показаны только некоторые из наиболее часто используемых методов, в том числе: + +- `map` +- `filter` +- `foreach` +- `head` +- `tail` +- `take`, `takeWhile` +- `drop`, `dropWhile` +- `reduce` + +Следующие методы работают со всеми типами последовательностей, включая `List`, `Vector`, `ArrayBuffer` и т.д. +Примеры рассмотрены на `List`-е, если не указано иное. + +> Важно напомнить, что ни один из методов в `List` не изменяет список. +> Все они работают в функциональном стиле, то есть возвращают новую коллекцию с измененными результатами. + +## Примеры распространенных методов + +Для общего представления в примерах ниже показаны некоторые из наиболее часто используемых методов коллекций. +Вот несколько методов, которые не используют лямбда-выражения: + +{% tabs common-method-examples %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) + +a.distinct // List(10, 20, 30, 40) +a.drop(2) // List(30, 40, 10) +a.dropRight(2) // List(10, 20, 30) +a.head // 10 +a.headOption // Some(10) +a.init // List(10, 20, 30, 40) +a.intersect(List(19,20,21)) // List(20) +a.last // 10 +a.lastOption // Some(10) +a.slice(2,4) // List(30, 40) +a.tail // List(20, 30, 40, 10) +a.take(3) // List(10, 20, 30) +a.takeRight(2) // List(40, 10) +``` +{% endtab %} + +{% endtabs %} + + +### Функции высшего порядка и лямбда-выражения + +Далее будут показаны некоторые часто используемые функции высшего порядка (HOF), +которые принимают лямбды (анонимные функции). +Для начала приведем несколько вариантов лямбда-синтаксиса, +начиная с самой длинной формы, поэтапно переходящей к наиболее сжатой: + +{% tabs higher-order-functions-example %} + +{% tab 'Scala 2 и 3' %} +```scala +// все эти функции одинаковые и возвращают +// одно и тоже: List(10, 20, 10) + +a.filter((i: Int) => i < 25) // 1. наиболее расширенная форма +a.filter((i) => i < 25) // 2. `Int` необязателен +a.filter(i => i < 25) // 3. скобки можно опустить +a.filter(_ < 25) // 4. `i` необязателен +``` +{% endtab %} + +{% endtabs %} + +В этих примерах: + +1. Первый пример показывает самую длинную форму. + Такое многословие требуется _редко_, только в самых сложных случаях. +2. Компилятор знает, что `a` содержит `Int`, поэтому нет необходимости повторять это в функции. +3. Если в функции только один параметр, например `i`, то скобки не нужны. +4. В случае одного параметра, если он появляется в анонимной функции только раз, его можно заменить на `_`. + +В главе [Анонимные функции][lambdas] представлена более подробная информация +и примеры правил, связанных с сокращением лямбда-выражений. + +Примеры других HOF, использующих краткий лямбда-синтаксис: + +{% tabs anonymous-functions-example %} + +{% tab 'Scala 2 и 3' %} +```scala +a.dropWhile(_ < 25) // List(30, 40, 10) +a.filter(_ > 100) // List() +a.filterNot(_ < 25) // List(30, 40) +a.find(_ > 20) // Some(30) +a.takeWhile(_ < 30) // List(10, 20) +``` +{% endtab %} + +{% endtabs %} + +Важно отметить, что HOF также принимают в качестве параметров методы и функции, а не только лямбда-выражения. +Вот несколько примеров, в которых используется метод с именем `double`. +Снова показаны несколько вариантов лямбда-выражений: + +{% tabs method-as-parameter-example %} + +{% tab 'Scala 2 и 3' %} +```scala +def double(i: Int) = i * 2 + +// these all return `List(20, 40, 60, 80, 20)` +a.map(i => double(i)) +a.map(double(_)) +a.map(double) +``` +{% endtab %} + +{% endtabs %} + +В последнем примере, когда анонимная функция состоит из одного вызова функции, принимающей один аргумент, +нет необходимости указывать имя аргумента, поэтому даже `_` не требуется. + +Наконец, HOF можно комбинировать: + +{% tabs higher-order-functions-combination-example %} + +{% tab 'Scala 2 и 3' %} +```scala +// выдает `List(100, 200)` +a.filter(_ < 40) + .takeWhile(_ < 30) + .map(_ * 10) +``` +{% endtab %} + +{% endtabs %} + + +## Пример данных + +В следующих разделах используются такие списки: + +{% tabs sample-data %} + +{% tab 'Scala 2 и 3' %} +```scala +val oneToTen = (1 to 10).toList +val names = List("adam", "brandy", "chris", "david") +``` +{% endtab %} + +{% endtabs %} + + +## `map` + +Метод `map` проходит через каждый элемент в списке, применяя переданную функцию к элементу, по одному за раз; +затем возвращается новый список с измененными элементами. + +Вот пример применения метода `map` к списку `oneToTen`: + +{% tabs map-example %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> val doubles = oneToTen.map(_ * 2) +doubles: List[Int] = List(2, 4, 6, 8, 10, 12, 14, 16, 18, 20) +``` +{% endtab %} + +{% endtabs %} + +Также можно писать анонимные функции, используя более длинную форму, например: + +{% tabs map-example-anonymous %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> val doubles = oneToTen.map(i => i * 2) +doubles: List[Int] = List(2, 4, 6, 8, 10, 12, 14, 16, 18, 20) +``` +{% endtab %} + +{% endtabs %} + +Однако в этом документе будет всегда использоваться первая, более короткая форма. + +Вот еще несколько примеров применения метода `map` к `oneToTen` и `names`: + +{% tabs few-more-examples %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> val capNames = names.map(_.capitalize) +capNames: List[String] = List(Adam, Brandy, Chris, David) + +scala> val nameLengthsMap = names.map(s => (s, s.length)).toMap +nameLengthsMap: Map[String, Int] = Map(adam -> 4, brandy -> 6, chris -> 5, david -> 5) + +scala> val isLessThanFive = oneToTen.map(_ < 5) +isLessThanFive: List[Boolean] = List(true, true, true, true, false, false, false, false, false, false) +``` +{% endtab %} + +{% endtabs %} + +Как показано в последних двух примерах, совершенно законно (и распространено) использование `map` для возврата коллекции, +которая имеет тип, отличный от исходного типа. + + +## `filter` + +Метод `filter` создает новый список, содержащий только те элементы, которые удовлетворяют предоставленному предикату. +Предикат или условие — это функция, которая возвращает `Boolean` (`true` или `false`). +Вот несколько примеров: + +{% tabs filter-example %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> val lessThanFive = oneToTen.filter(_ < 5) +lessThanFive: List[Int] = List(1, 2, 3, 4) + +scala> val evens = oneToTen.filter(_ % 2 == 0) +evens: List[Int] = List(2, 4, 6, 8, 10) + +scala> val shortNames = names.filter(_.length <= 4) +shortNames: List[String] = List(adam) +``` +{% endtab %} + +{% endtabs %} + +Отличительной особенностью функциональных методов коллекций является то, +что их можно объединять вместе для решения задач. +Например, в этом примере показано, как связать `filter` и `map`: + +{% tabs filter-example-anonymous %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.filter(_ < 4).map(_ * 10) +``` +{% endtab %} + +{% endtabs %} + +REPL показывает результат: + +{% tabs filter-example-anonymous-repl %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> oneToTen.filter(_ < 4).map(_ * 10) +val res1: List[Int] = List(10, 20, 30) +``` +{% endtab %} + +{% endtabs %} + + +## `foreach` + +Метод `foreach` используется для перебора всех элементов коллекции. +Стоит обратить внимание, что `foreach` используется для побочных эффектов, таких как печать информации. +Вот пример с `names`: + +{% tabs foreach-example %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> names.foreach(println) +adam +brandy +chris +david +``` +{% endtab %} + +{% endtabs %} + + + +## `head` + +Метод `head` взят из Lisp и других более ранних языков функционального программирования. +Он используется для доступа к первому элементу (головному (_head_) элементу) списка: + +{% tabs head-example %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.head // 1 +names.head // adam +``` +{% endtab %} + +{% endtabs %} + +`String` можно рассматривать как последовательность символов, т.е. строка также является коллекцией, +а значит содержит соответствующие методы. +Вот как `head` работает со строками: + +{% tabs string-head-example %} + +{% tab 'Scala 2 и 3' %} +```scala +"foo".head // 'f' +"bar".head // 'b' +``` +{% endtab %} + +{% endtabs %} + +`head` — отличный метод для работы, но в качестве предостережения следует помнить, что +он также может генерировать исключение при вызове для пустой коллекции: + +{% tabs head-error-example %} + +{% tab 'Scala 2 и 3' %} +```scala +val emptyList = List[Int]() // emptyList: List[Int] = List() +emptyList.head // java.util.NoSuchElementException: head of empty list +``` +{% endtab %} + +{% endtabs %} + +Чтобы не натыкаться на исключение вместо `head` желательно использовать `headOption`, +особенно при разработке в функциональном стиле: + +{% tabs head-option-example %} + +{% tab 'Scala 2 и 3' %} +```scala +emptyList.headOption // None +``` +{% endtab %} + +{% endtabs %} + +`headOption` не генерирует исключение, а возвращает тип `Option` со значением `None`. +Более подробно о функциональном стиле программирования будет рассказано [в соответствующей главе][fp-intro]. + + +## `tail` + +Метод `tail` также взят из Lisp и используется для вывода всех элементов в списке после `head`. + +{% tabs tail-example %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.head // 1 +oneToTen.tail // List(2, 3, 4, 5, 6, 7, 8, 9, 10) + +names.head // adam +names.tail // List(brandy, chris, david) +``` +{% endtab %} + +{% endtabs %} + +Так же, как и `head`, `tail` можно использовать со строками: + +{% tabs string-tail-example %} + +{% tab 'Scala 2 и 3' %} +```scala +"foo".tail // "oo" +"bar".tail // "ar" +``` +{% endtab %} + +{% endtabs %} + +`tail` выбрасывает исключение _java.lang.UnsupportedOperationException_, если список пуст, +поэтому, как и в случае с `head` и `headOption`, существует также метод `tailOption`, +который предпочтительнее в функциональном программировании. + +Список матчится, поэтому можно использовать такие выражения: + +{% tabs tail-match-example %} + +{% tab 'Scala 2 и 3' %} +```scala +val x :: xs = names +``` +{% endtab %} + +{% endtabs %} + +Помещение этого кода в REPL показывает, что `x` назначается заглавному элементу списка, а `xs` назначается "хвосту": + +{% tabs tail-match-example-repl %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> val x :: xs = names +val x: String = adam +val xs: List[String] = List(brandy, chris, david) +``` +{% endtab %} + +{% endtabs %} + +Подобное сопоставление с образцом полезно во многих случаях, например, при написании метода `sum` с использованием рекурсии: + +{% tabs tail-match-sum-example class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +def sum(list: List[Int]): Int = list match { + case Nil => 0 + case x :: xs => x + sum(xs) +} +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +def sum(list: List[Int]): Int = list match + case Nil => 0 + case x :: xs => x + sum(xs) +``` +{% endtab %} + +{% endtabs %} + + + +## `take`, `takeRight`, `takeWhile` + +Методы `take`, `takeRight` и `takeWhile` предоставляют удобный способ “брать” (_taking_) элементы из списка для создания нового. +Примеры `take` и `takeRight`: + +{% tabs take-example %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.take(1) // List(1) +oneToTen.take(2) // List(1, 2) + +oneToTen.takeRight(1) // List(10) +oneToTen.takeRight(2) // List(9, 10) +``` +{% endtab %} + +{% endtabs %} + +Обратите внимание, как эти методы работают с «пограничными» случаями, +когда запрашивается больше элементов, чем есть в последовательности, +или запрашивается ноль элементов: + +{% tabs take-edge-cases-example %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.take(Int.MaxValue) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +oneToTen.takeRight(Int.MaxValue) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +oneToTen.take(0) // List() +oneToTen.takeRight(0) // List() +``` +{% endtab %} + +{% endtabs %} + +А это `takeWhile`, который работает с функцией-предикатом: + +{% tabs take-while-example %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.takeWhile(_ < 5) // List(1, 2, 3, 4) +names.takeWhile(_.length < 5) // List(adam) +``` +{% endtab %} + +{% endtabs %} + + +## `drop`, `dropRight`, `dropWhile` + +`drop`, `dropRight` и `dropWhile` удаляют элементы из списка +и, по сути, противоположны своим аналогам “take”. +Вот некоторые примеры: + +{% tabs drop-example %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.drop(1) // List(2, 3, 4, 5, 6, 7, 8, 9, 10) +oneToTen.drop(5) // List(6, 7, 8, 9, 10) + +oneToTen.dropRight(8) // List(1, 2) +oneToTen.dropRight(7) // List(1, 2, 3) +``` +{% endtab %} + +{% endtabs %} + +Пограничные случаи: + +{% tabs drop-edge-cases-example %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.drop(Int.MaxValue) // List() +oneToTen.dropRight(Int.MaxValue) // List() +oneToTen.drop(0) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +oneToTen.dropRight(0) // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +``` +{% endtab %} + +{% endtabs %} + +А это `dropWhile`, который работает с функцией-предикатом: + +{% tabs drop-while-example %} + +{% tab 'Scala 2 и 3' %} +```scala +oneToTen.dropWhile(_ < 5) // List(5, 6, 7, 8, 9, 10) +names.dropWhile(_ != "chris") // List(chris, david) +``` +{% endtab %} + +{% endtabs %} + + +## `reduce` + +Метод `reduce` позволяет свертывать коллекцию до одного агрегируемого значения. +Он принимает функцию (или анонимную функцию) и последовательно применяет эту функцию к элементам в списке. + +Лучший способ объяснить `reduce` — создать небольшой вспомогательный метод. +Например, метод `add`, который складывает вместе два целых числа, +а также предоставляет хороший вывод отладочной информации: + +{% tabs reduce-example class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +def add(x: Int, y: Int): Int = { + val theSum = x + y + println(s"received $x and $y, their sum is $theSum") + theSum +} +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +def add(x: Int, y: Int): Int = + val theSum = x + y + println(s"received $x and $y, their sum is $theSum") + theSum +``` +{% endtab %} + +{% endtabs %} + +Рассмотрим список: + +{% tabs reduce-example-init %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = List(1,2,3,4) +``` +{% endtab %} + +{% endtabs %} + +вот что происходит, когда в `reduce` передается метод `add`: + +{% tabs reduce-example-evaluation %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> a.reduce(add) +received 1 and 2, their sum is 3 +received 3 and 3, their sum is 6 +received 6 and 4, their sum is 10 +res0: Int = 10 +``` +{% endtab %} + +{% endtabs %} + +Как видно из результата, функция `reduce` использует `add` для сокращения списка `a` до единственного значения, +в данном случае — суммы всех чисел в списке. + +`reduce` можно использовать с анонимными функциями: + +{% tabs reduce-example-sum %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> a.reduce(_ + _) +res0: Int = 10 +``` +{% endtab %} + +{% endtabs %} + +Аналогично можно использовать другие функции, например, умножение: + +{% tabs reduce-example-multiply %} + +{% tab 'Scala 2 и 3' %} +```scala +scala> a.reduce(_ * _) +res1: Int = 24 +``` +{% endtab %} + +{% endtabs %} + +> Важная концепция, которую следует знать о `reduce`, заключается в том, что, как следует из ее названия +> (_reduce_ - сокращать), она используется для сокращения коллекции до одного значения. + + +## Дальнейшее изучение коллекций + +В коллекциях Scala есть десятки дополнительных методов, которые избавляют от необходимости писать еще один цикл `for`. +Более подробную информацию о коллекциях Scala см. +в разделе [Изменяемые и неизменяемые коллекции][mut-immut-colls] +и [Архитектура коллекций Scala][architecture]. + +> В качестве последнего примечания, при использовании Java-кода в проекте Scala, +> коллекции Java можно преобразовать в коллекции Scala. +> После этого, их можно использовать в выражениях `for`, +> а также воспользоваться преимуществами методов функциональных коллекций Scala. +> Более подробную информацию можно найти в разделе [Взаимодействие с Java][interacting]. + + +[interacting]: {% link _overviews/scala3-book/interacting-with-java.md %} +[lambdas]: {% link _overviews/scala3-book/fun-anonymous-functions.md %} +[fp-intro]: {% link _overviews/scala3-book/fp-intro.md %} +[mut-immut-colls]: {% link _overviews/collections-2.13/overview.md %} +[architecture]: {% link _overviews/core/architecture-of-scala-213-collections.md %} + diff --git a/_ru/scala3/book/collections-summary.md b/_ru/scala3/book/collections-summary.md new file mode 100644 index 0000000000..6e852ad359 --- /dev/null +++ b/_ru/scala3/book/collections-summary.md @@ -0,0 +1,35 @@ +--- +layout: multipage-overview +title: Обзор +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: На этой странице представлен краткий итог главы «Коллекции». +language: ru +num: 39 +previous-page: collections-methods +next-page: fp-intro +--- + +В этой главе представлен обзор общих коллекций Scala 3 и сопутствующих им методов. +Как было показано, Scala поставляется с множеством коллекций и методов. + +Если вам нужно увидеть более подробную информацию о типах коллекций, +показанных в этой главе, см. их Scaladoc страницы: + +- [List](https://www.scala-lang.org/api/current/scala/collection/immutable/List.html) +- [Vector](https://www.scala-lang.org/api/current/scala/collection/immutable/Vector.html) +- [ArrayBuffer](https://www.scala-lang.org/api/current/scala/collection/mutable/ArrayBuffer.html) +- [Range](https://www.scala-lang.org/api/current/scala/collection/immutable/Range.html) + +Также упоминавшиеся неизменяемые `Map` и `Set`: + +- [Map](https://www.scala-lang.org/api/current/scala/collection/immutable/Map.html) +- [Set](https://www.scala-lang.org/api/current/scala/collection/immutable/Set.html) + +и изменяемые `Map` и `Set`: + +- [Map](https://www.scala-lang.org/api/current/scala/collection/mutable/Map.html) +- [Set](https://www.scala-lang.org/api/current/scala/collection/mutable/Set.html) + diff --git a/_ru/scala3/book/control-structures.md b/_ru/scala3/book/control-structures.md index b72b476278..37e78c1633 100644 --- a/_ru/scala3/book/control-structures.md +++ b/_ru/scala3/book/control-structures.md @@ -450,14 +450,14 @@ AR: Arizona {% endtab %} {% endtabs %} -Когда цикл `for` перебирает карту, каждая пара ключ/значение привязывается +Когда цикл `for` перебирает мапу, каждая пара ключ/значение привязывается к переменным `abbrev` и `fullName`, которые находятся в кортеже: ```scala (abbrev, fullName) <- states ``` -По мере выполнения цикла переменная `abbrev` принимает значение текущего _ключа_ в карте, +По мере выполнения цикла переменная `abbrev` принимает значение текущего _ключа_ в мапе, а переменная `fullName` - соответствующему ключу _значению_. ## Выражение `for` diff --git a/_ru/scala3/book/fp-functional-error-handling.md b/_ru/scala3/book/fp-functional-error-handling.md new file mode 100644 index 0000000000..bf6d299fbd --- /dev/null +++ b/_ru/scala3/book/fp-functional-error-handling.md @@ -0,0 +1,436 @@ +--- +layout: multipage-overview +title: Функциональная обработка ошибок +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлено введение в функциональную обработку ошибок в Scala 3. +language: ru +num: 45 +previous-page: fp-functions-are-values +next-page: fp-summary +--- + + + +Функциональное программирование похоже на написание ряда алгебраических уравнений, +и поскольку алгебра не имеет null значений или исключений, они не используются и в ФП. +Что поднимает интересный вопрос: как быть в ситуациях, в которых вы обычно используете null значение или исключение программируя в ООП стиле? + +Решение Scala заключается в использовании конструкций, основанных на классах типа `Option`/`Some`/`None`. +Этот урок представляет собой введение в использование такого подхода. + +Примечание: + +- классы `Some` и `None` являются подклассами `Option` +- вместо того чтобы многократно повторять “`Option`/`Some`/`None`”, + следующий текст обычно просто ссылается на “`Option`” или на “классы `Option`” + + +## Первый пример + +Хотя этот первый пример не имеет дело с `null` значениями, это хороший способ познакомиться с классами `Option`. + +Представим, что нужно написать метод, который упрощает преобразование строк в целочисленные значения. +И нужен элегантный способ обработки исключения, которое возникает, +когда метод получает строку типа `"Hello"` вместо `"1"`. +Первое предположение о таком методе может выглядеть следующим образом: + +{% tabs fp-java-try class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +def makeInt(s: String): Int = + try { + Integer.parseInt(s.trim) + } catch { + case e: Exception => 0 + } +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +def makeInt(s: String): Int = + try + Integer.parseInt(s.trim) + catch + case e: Exception => 0 +``` +{% endtab %} + +{% endtabs %} + +Если преобразование работает, метод возвращает правильное значение `Int`, но в случае сбоя метод возвращает `0`. +Для некоторых целей это может быть хорошо, но не совсем точно. +Например, метод мог получить `"0"`, но мог также получить `"foo"`, `"bar"` +или бесконечное количество других строк, которые выдадут исключение. +Это реальная проблема: как определить, когда метод действительно получил `"0"`, а когда получил что-то еще? +При таком подходе нет способа узнать правильный ответ наверняка. + + +## Использование Option/Some/None + +Распространенным решением этой проблемы в Scala является использование классов, +известных как `Option`, `Some` и `None`. +Классы `Some` и `None` являются подклассами `Option`, поэтому решение работает следующим образом: + +- объявляется, что `makeInt` возвращает тип `Option` +- если `makeInt` получает строку, которую он _может_ преобразовать в `Int`, ответ помещается внутрь `Some` +- если `makeInt` получает строку, которую _не может_ преобразовать, то возвращает `None` + +Вот доработанная версия `makeInt`: + +{% tabs fp--try-option class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +def makeInt(s: String): Option[Int] = + try { + Some(Integer.parseInt(s.trim)) + } catch { + case e: Exception => None + } +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +def makeInt(s: String): Option[Int] = + try + Some(Integer.parseInt(s.trim)) + catch + case e: Exception => None +``` +{% endtab %} + +{% endtabs %} + +Этот код можно прочитать следующим образом: +“Когда данная строка преобразуется в целое число, верните значение `Int`, заключенное в `Some`, например `Some(1)`. +Когда строка не может быть преобразована в целое число и генерируется исключение, метод возвращает значение `None`.” + +Эти примеры показывают, как работает `makeInt`: + +{% tabs fp-try-option-example %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = makeInt("1") // Some(1) +val b = makeInt("one") // None +``` +{% endtab %} + +{% endtabs %} + +Как показано, строка `"1"` приводится к `Some(1)`, а строка `"one"` - к `None`. +В этом суть альтернативного подхода к обработке ошибок. +Данная техника используется для того, чтобы методы могли возвращать _значения_ вместо _исключений_. +В других ситуациях значения `Option` также используются для замены `null` значений. + +Примечание: + +- этот подход используется во всех классах библиотеки Scala, а также в сторонних библиотеках Scala. +- ключевым моментом примера является то, что функциональные методы не генерируют исключения; + вместо этого они возвращают такие значения, как `Option`. + + +## Потребитель makeInt + +Теперь представим, что мы являемся потребителем метода `makeInt`. +Известно, что он возвращает подкласс `Option[Int]`, поэтому возникает вопрос: +как работать с такими возвращаемыми типами? + +Есть два распространенных ответа, в зависимости от потребностей: + +- использование `match` выражений +- использование `for` выражений + +## Использование `match` выражений + +Одним из возможных решений является использование выражения `match`: + +{% tabs fp-option-match class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +makeInt(x) match { + case Some(i) => println(i) + case None => println("That didn’t work.") +} +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +makeInt(x) match + case Some(i) => println(i) + case None => println("That didn’t work.") +``` +{% endtab %} + +{% endtabs %} + +В этом примере, если `x` можно преобразовать в `Int`, вычисляется первый вариант в правой части предложения `case`; +если `x` не может быть преобразован в `Int`, вычисляется второй вариант в правой части предложения `case`. + + +## Использование `for` выражений + +Другим распространенным решением является использование выражения `for`, то есть комбинации `for`/`yield`. +Например, представим, что необходимо преобразовать три строки в целочисленные значения, а затем сложить их. +Решение задачи с использованием выражения `for`: + +{% tabs fp-for-comprehension class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +val y = for { + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +} yield { + a + b + c +} +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +val y = for + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +yield + a + b + c +``` +{% endtab %} + +{% endtabs %} + +После выполнения этого выражения `y` может принять одно из двух значений: + +- если _все_ три строки конвертируются в значения `Int`, `y` будет равно `Some[Int]`, т.е. целым числом, обернутым внутри `Some` +- если _какая-либо_ из трех строк не может быть преобразована в `Int`, `y` равен `None` + +Это можно проверить на примере: + +{% tabs fp-for-comprehension-evaluation class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +val stringA = "1" +val stringB = "2" +val stringC = "3" + +val y = for { + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +} yield { + a + b + c +} +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +val stringA = "1" +val stringB = "2" +val stringC = "3" + +val y = for + a <- makeInt(stringA) + b <- makeInt(stringB) + c <- makeInt(stringC) +yield + a + b + c +``` +{% endtab %} + +{% endtabs %} + +С этими демонстрационными данными переменная `y` примет значение `Some(6)`. + +Чтобы увидеть негативный кейс, достаточно изменить любую из строк на что-то, что нельзя преобразовать в целое число. +В этом случае `y` равно `None`: + +{% tabs fp-for-comprehension-failure-result %} + +{% tab 'Scala 2 и 3' %} +```scala +y: Option[Int] = None +``` +{% endtab %} + +{% endtabs %} + + +## Восприятие Option, как контейнера + +Для лучшего восприятия `Option`, его можно представить как _контейнер_: + +- `Some` представляет собой контейнер с одним элементом +- `None` не является контейнером, в нем ничего нет + +Если предпочтительнее думать об `Option` как о ящике, то `None` подобен пустому ящику. +Что-то в нём могло быть, но нет. + + +## Использование `Option` для замены `null` + +Возвращаясь к значениям `null`, место, где `null` значение может незаметно проникнуть в код, — класс, подобный этому: + +{% tabs fp=case-class-nulls %} + +{% tab 'Scala 2 и 3' %} +```scala +class Address( + var street1: String, + var street2: String, + var city: String, + var state: String, + var zip: String +) +``` +{% endtab %} + +{% endtabs %} + +Хотя каждый адрес имеет значение `street1`, значение `street2` не является обязательным. +В результате полю `street2` можно присвоить значение `null`: + +{% tabs fp-case-class-nulls-example class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +val santa = new Address( + "1 Main Street", + null, // <-- О! Значение null! + "North Pole", + "Alaska", + "99705" +) +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +val santa = Address( + "1 Main Street", + null, // <-- О! Значение null! + "North Pole", + "Alaska", + "99705" +) +``` +{% endtab %} + +{% endtabs %} + +Исторически сложилось так, что в этой ситуации разработчики использовали пустые строки и значения `null`, +оба варианта это “костыль” для решения основной проблемы: `street2` - _необязательное_ поле. +В Scala и других современных языках правильное решение состоит в том, +чтобы заранее объявить, что `street2` является необязательным: + + +{% tabs fp-case-class-with-options %} + +{% tab 'Scala 2 и 3' %} +```scala +class Address( + var street1: String, + var street2: Option[String], // необязательное значение + var city: String, + var state: String, + var zip: String +) +``` +{% endtab %} + +{% endtabs %} + +Теперь можно написать более точный код: + +{% tabs fp-case-class-with-options-example-none class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +val santa = new Address( + "1 Main Street", + None, // 'street2' не имеет значения + "North Pole", + "Alaska", + "99705" +) +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +val santa = Address( + "1 Main Street", + None, // 'street2' не имеет значения + "North Pole", + "Alaska", + "99705" +) +``` +{% endtab %} + +{% endtabs %} + +или так: + +{% tabs fp-case-class-with-options-example-some class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +val santa = new Address( + "123 Main Street", + Some("Apt. 2B"), + "Talkeetna", + "Alaska", + "99676" +) +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +val santa = Address( + "123 Main Street", + Some("Apt. 2B"), + "Talkeetna", + "Alaska", + "99676" +) +``` +{% endtab %} + +{% endtabs %} + + + +## `Option` — не единственное решение + +В этом разделе основное внимание уделялось `Option` классам, но у Scala есть несколько других альтернатив. + +Например, три класса, известные как `Try`/`Success`/`Failure`, работают также, +но (а) эти классы в основном используются, когда код может генерировать исключения, +и (б) когда желательно использовать класс `Failure`, потому что он дает доступ к сообщению об исключении. +Например, классы `Try` обычно используются при написании методов, которые взаимодействуют с файлами, +базами данных или интернет-службами, поскольку эти функции могут легко создавать исключения. + + +## Краткое ревью + +Этот раздел был довольно большим, поэтому давайте подведем краткое ревью: + +- функциональные программисты не используют `null` значения +- основной заменой `null` значениям является использование классов `Option` +- функциональные методы не выдают исключений; вместо этого они возвращают такие значения, как `Option`, `Try` или `Either` +- распространенными способами работы со значениями `Option` являются выражения `match` и `for` +- `Option` можно рассматривать как контейнеры с одним элементом (`Some`) и без элементов (`None`) +- `Option` также можно использовать для необязательных параметров конструктора или метода diff --git a/_ru/scala3/book/fp-functions-are-values.md b/_ru/scala3/book/fp-functions-are-values.md new file mode 100644 index 0000000000..62cacc4540 --- /dev/null +++ b/_ru/scala3/book/fp-functions-are-values.md @@ -0,0 +1,161 @@ +--- +layout: multipage-overview +title: Функции — это значения +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе рассматривается использование функций в качестве значений в функциональном программировании. +language: ru +num: 44 +previous-page: fp-pure-functions +next-page: fp-functional-error-handling +--- + + +Хотя каждый когда-либо созданный язык программирования, вероятно, позволяет писать чистые функции, +вторая важная особенность ФП на Scala заключается в том, что _функции можно создавать как значения_, +точно так же, как создаются значения `String` и `Int`. + +Эта особенность даёт много преимуществ, опишем наиболее распространенные из них: +(a) можно определять методы, принимающие в качестве параметров функции +и (b) можно передавать функции в качестве параметров в методы. + +Такой подход можно было наблюдать в предыдущих главах, когда демонстрировались такие методы, как `map` и `filter`: + +{% tabs fp-function-as-values-anonymous %} + +{% tab 'Scala 2 и 3' %} +```scala +val nums = (1 to 10).toList + +val doubles = nums.map(_ * 2) // удваивает каждое значение +val lessThanFive = nums.filter(_ < 5) // List(1,2,3,4) +``` +{% endtab %} + +{% endtabs %} + +В этих примерах анонимные функции передаются в `map` и `filter`. + +> Анонимные функции также известны как _лямбды_ (_lambdas_). + +Помимо передачи анонимных функций в `filter` и `map`, в них также можно передать _методы_: + +{% tabs fp-function-as-values-defined %} + +{% tab 'Scala 2 и 3' %} +```scala +// два метода +def double(i: Int): Int = i * 2 +def underFive(i: Int): Boolean = i < 5 + +// передача этих методов в filter и map +val doubles = nums.filter(underFive).map(double) +``` +{% endtab %} + +{% endtabs %} + +Возможность обращаться с методами и функциями как со значениями — мощное свойство, +предоставляемое языками функционального программирования. + +> Технически функция, которая принимает другую функцию в качестве входного параметра, известна как _функция высшего порядка_. +> (Если вам нравится юмор, как кто-то однажды написал, это все равно, что сказать, +> что класс, который принимает экземпляр другого класса в качестве параметра конструктора, +> является классом высшего порядка.) + + +## Функции, анонимные функции и методы + +В примерах выше анонимная функция это: + +{% tabs fp-anonymous-function-short %} + +{% tab 'Scala 2 и 3' %} +```scala +_ * 2 +``` +{% endtab %} + +{% endtabs %} + +Как было показано в обсуждении [функций высшего порядка][hofs], `_ * 2` - сокращенная версия синтаксиса: + +{% tabs fp-anonymous-function-full %} + +{% tab 'Scala 2 и 3' %} +```scala +(i: Int) => i * 2 +``` +{% endtab %} + +{% endtabs %} + +Такие функции называются “анонимными”, потому что им не присваивается определенное имя. +Для того чтобы это имя задать, достаточно просто присвоить его переменной: + +{% tabs fp-function-assignement %} + +{% tab 'Scala 2 и 3' %} +```scala +val double = (i: Int) => i * 2 +``` +{% endtab %} + +{% endtabs %} + +Теперь появилась именованная функция, назначенная переменной `double`. +Можно использовать эту функцию так же, как используется метод: + +{% tabs fp-function-used-like-method %} + +{% tab 'Scala 2 и 3' %} +```scala +double(2) // 4 +``` +{% endtab %} + +{% endtabs %} + +В большинстве случаев не имеет значения, является ли `double` функцией или методом; +Scala позволяет обращаться с ними одинаково. +За кулисами технология Scala, которая позволяет обращаться с методами так же, +как с функциями, известна как [Eta Expansion][eta]. + +Эта способность беспрепятственно передавать функции в качестве переменных +является отличительной чертой функциональных языков программирования, таких как Scala. +И, как было видно на примерах `map` и `filter`, +возможность передавать функции в другие функции помогает создавать код, +который является кратким и при этом читабельным — _выразительным_. + +Вот еще несколько примеров: + +{% tabs fp-function-as-values-example %} + +{% tab 'Scala 2 и 3' %} +```scala +List("bob", "joe").map(_.toUpperCase) // List(BOB, JOE) +List("bob", "joe").map(_.capitalize) // List(Bob, Joe) +List("plum", "banana").map(_.length) // List(4, 6) + +val fruits = List("apple", "pear") +fruits.map(_.toUpperCase) // List(APPLE, PEAR) +fruits.flatMap(_.toUpperCase) // List(A, P, P, L, E, P, E, A, R) + +val nums = List(5, 1, 3, 11, 7) +nums.map(_ * 2) // List(10, 2, 6, 22, 14) +nums.filter(_ > 3) // List(5, 11, 7) +nums.takeWhile(_ < 6) // List(5, 1, 3) +nums.sortWith(_ < _) // List(1, 3, 5, 7, 11) +nums.sortWith(_ > _) // List(11, 7, 5, 3, 1) + +nums.takeWhile(_ < 6).sortWith(_ < _) // List(1, 3, 5) +``` +{% endtab %} + +{% endtabs %} + + +[hofs]: {% link _overviews/scala3-book/fun-hofs.md %} +[eta]: {% link _overviews/scala3-book/fun-eta-expansion.md %} diff --git a/_ru/scala3/book/fp-immutable-values.md b/_ru/scala3/book/fp-immutable-values.md new file mode 100644 index 0000000000..24ffaf8613 --- /dev/null +++ b/_ru/scala3/book/fp-immutable-values.md @@ -0,0 +1,109 @@ +--- +layout: multipage-overview +title: Неизменяемые значения +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе рассматривается использование неизменяемых значений в функциональном программировании. +language: ru +num: 42 +previous-page: fp-what-is-fp +next-page: fp-pure-functions +--- + +В чистом функциональном программировании используются только неизменяемые значения. +В Scala это означает: + +- все переменные создаются как поля `val` +- используются только неизменяемые классы коллекций, такие как `List`, `Vector` и неизменяемые классы `Map` и `Set` + +Использование только неизменяемых переменных поднимает интересный вопрос: если все статично, как вообще что-то меняется? + +Когда дело доходит до использования коллекций, один из ответов заключается в том, +что существующая коллекция не меняется; вместо этого функция применяется к коллекции, чтобы создать новую. +Именно здесь вступают в действие функции высшего порядка, такие как `map` и `filter`. + +Например, представим, что есть список имен в нижнем регистре — `List[String]`, +и необходимо найти все имена, начинающиеся с буквы `"j"`, чтобы затем сделать первые буквы заглавными. +В ФП код будет выглядеть так: + +{% tabs fp-list %} + +{% tab 'Scala 2 и 3' %} +```scala +val a = List("jane", "jon", "mary", "joe") +val b = a.filter(_.startsWith("j")) + .map(_.capitalize) +``` +{% endtab %} + +{% endtabs %} + +Как показано, исходный список `a` не меняется. +Вместо этого к `a` применяется функция фильтрации и преобразования, чтобы создать новую коллекцию, +и результат присваивается неизменяемой переменной `b`. + +Точно так же в ФП не используются классы с изменяемыми параметрами конструктора `var`. +В ФП создание такого класса не привествуется: + +{% tabs fp--class-variables %} + +{% tab 'Scala 2 и 3' %} +```scala +// не стоит этого делать в ФП +class Person(var firstName: String, var lastName: String) + --- --- +``` +{% endtab %} + +{% endtabs %} + +Вместо этого обычно создаются `case` классы, чьи параметры конструктора по умолчанию неизменяемые (`val`): + +{% tabs fp-immutable-case-class %} + +{% tab 'Scala 2 и 3' %} +```scala +case class Person(firstName: String, lastName: String) +``` +{% endtab %} + +{% endtabs %} + +Теперь можно создать экземпляр `Person` как поле `val`: + +{% tabs fp-case-class-creation %} + +{% tab 'Scala 2 и 3' %} +```scala +val reginald = Person("Reginald", "Dwight") +``` +{% endtab %} + +{% endtabs %} + +Затем, при необходимости внести изменения в данные, используется метод `copy`, +который поставляется с `case` классом, чтобы “обновлять данные через создание копии”, +например так: + +{% tabs fp-case-class-copy %} + +{% tab 'Scala 2 и 3' %} +```scala +val elton = reginald.copy( + firstName = "Elton", // обновить имя + lastName = "John" // обновить фамилию +) +``` +{% endtab %} + +{% endtabs %} + +Существуют множество других приёмов работы с неизменяемыми коллекциями и переменными. + +> В зависимости от задач вместо `case` классов можно создавать перечисления, trait-ы или классы. +> Для более подробной информации см. главу [“Моделирование данных”][modeling]. + + +[modeling]: {% link _overviews/scala3-book/domain-modeling-intro.md %} diff --git a/_ru/scala3/book/fp-intro.md b/_ru/scala3/book/fp-intro.md new file mode 100644 index 0000000000..7961b13a83 --- /dev/null +++ b/_ru/scala3/book/fp-intro.md @@ -0,0 +1,31 @@ +--- +layout: multipage-overview +title: Функциональное программирование +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: chapter +description: В этой главе представлено введение в функциональное программирование в Scala 3. +language: ru +num: 40 +previous-page: collections-summary +next-page: fp-what-is-fp +--- + + +Scala позволяет писать код в стиле объектно-ориентированного программирования (ООП), +в стиле функционального программирования (ФП), а также в гибридном стиле, используя оба подхода в комбинации. +По словам [Martin Odersky](https://twitter.com/alexelcu/status/996408359514525696), +сущность Scala — это слияние функционального и объектно-ориентированного программирования в типизированной среде: + +- Функции для логики +- Объекты для модульности + +В этой главе предполагается, что вы знакомы с ООП и менее знакомы с ФП, +поэтому в ней представлено краткое введение в несколько основных концепций функционального программирования: + +- Что такое функциональное программирование? +- Неизменяемые значения +- Чистые функции +- Функции — это значения +- Функциональная обработка ошибок diff --git a/_ru/scala3/book/fp-pure-functions.md b/_ru/scala3/book/fp-pure-functions.md new file mode 100644 index 0000000000..fd70cc5694 --- /dev/null +++ b/_ru/scala3/book/fp-pure-functions.md @@ -0,0 +1,153 @@ +--- +layout: multipage-overview +title: Чистые функции +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе рассматривается использование чистых функций в функциональном программировании. +language: ru +num: 43 +previous-page: fp-immutable-values +next-page: fp-functions-are-values +--- + + +Еще одна концепция, которую Scala предлагает для помощи в написании функционального кода, — это возможность писать чистые функции. +_Чистая функция_ (_pure function_) может быть определена следующим образом: + +- функция `f` является чистой, если при одних и тех же входных данных `x` она всегда возвращает один и тот же результат `f(x)` +- результат функции зависит _только_ от входных данных и её реализации +- чистые функции только вычисляют результат, ничего не меняя за пределами этих функций + +Из этого следует: + +- чистая функция не изменяет свои входные параметры +- она не мутирует какое-либо скрытое состояние +- у неё нет “черных ходов”: он не читает данные из внешнего мира (включая консоль, веб-сервисы, базы данных, файлы и т.д.) + и не записывает данные вовне + +В результате этого определения каждый раз, когда вызывается чистая функция с одним и тем же входным значением (значениями), +всегда будет выдаваться один и тот же результат. +Например, можно вызывать функцию `double` бесконечное число раз с входным значением `2`, и всегда получать результат `4`. + + +## Примеры чистых функций + +Учитывая это определение, методы в пакете `scala.math._` являются чистыми функциями: + +- `abs` +- `ceil` +- `max` + +Эти методы `String` также являются чистыми функциями: + +- `isEmpty` +- `length` +- `substring` + +Большинство методов в классах коллекций Scala также работают как чистые функции, +включая `drop`, `filter`, `map` и многие другие. + +> В Scala _функции_ и _методы_ почти полностью взаимозаменяемы, +> поэтому, хотя здесь используется общепринятый отраслевой термин “чистая функция”, +> этот термин можно использовать как для описания функций, так и методов. +> Как методы могут использоваться подобно функциям описано в главе [Eta расширение][eta]. + + +## Примеры “грязных” функций + +И наоборот, следующие функции “_грязные_” (_impure_), потому что они нарушают определение pure function: + +- `println` — методы, взаимодействующие с консолью, файлами, базами данных, веб-сервисами и т.д., “грязные” +- `currentTimeMillis` — все методы, связанные с датой и временем, “грязные”, + потому что их вывод зависит от чего-то другого, кроме входных параметров +- `sys.error` — методы генерации исключений “грязные”, потому что они не “просто возвращают результат” + +“Грязные” функции часто делают одно из следующего: + +- читают из скрытого состояния, т.е. обращаются к параметрам и данным, + не переданным в функцию явным образом в качестве входных параметров +- запись в скрытое состояние +- изменяют заданные им параметры или изменяют скрытые переменные, например, поля в содержащем их классе +- выполняют какой-либо ввод-вывод с внешним миром + +> В общем, следует остерегаться функций с возвращаемым типом `Unit`. +> Поскольку эти функции ничего не возвращают, логически единственная причина, по которой они когда-либо вызываются, - +> это достижение какого-то побочного эффекта. +> Как следствие, часто использование этих функций является “грязным”. + + +## Но грязные функции все же необходимы ... + +Конечно, приложение не очень полезно, если оно не может читать или писать во внешний мир, поэтому рекомендуется следующее: + +> Напишите ядро вашего приложения, используя только “чистые” функции, +> а затем напишите “грязную” “оболочку” вокруг этого ядра для взаимодействия с внешним миром. +> Как кто-то однажды сказал, это все равно, что положить слой нечистой глазури на чистый торт. + +Важно отметить, что есть способы сделать “нечистое” взаимодействие с внешним миром более “чистым”. +Например, можно услышать об использовании `IO` монады для обработки ввода-вывода. +Эти темы выходят за рамки данного документа, поэтому для простоты можно думать, +что ФП приложения имеют ядро из “чистых” функций, +которые объединены с другими функциями для взаимодействия с внешним миром. + + +## Написание “чистых” функций + +**Примечание**: в этом разделе для обозначения методов Scala часто используется общепринятый в отрасли термин “чистая функция”. + +Для написания чистых функций на Scala, достаточно писать их, +используя синтаксис методов Scala (хотя также можно использовать и синтаксис функций Scala). +Например, вот чистая функция, которая удваивает заданное ей входное значение: + +{% tabs fp-pure-function %} + +{% tab 'Scala 2 и 3' %} +```scala +def double(i: Int): Int = i * 2 +``` +{% endtab %} + +{% endtabs %} + +Вот чистая функция, которая вычисляет сумму списка целых чисел с использованием рекурсии: + +{% tabs fp-pure-recursive-function class=tabs-scala-version %} + +{% tab 'Scala 2' %} +```scala +def sum(xs: List[Int]): Int = xs match { + case Nil => 0 + case head :: tail => head + sum(tail) +} +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +def sum(xs: List[Int]): Int = xs match + case Nil => 0 + case head :: tail => head + sum(tail) +``` +{% endtab %} + +{% endtabs %} + +Вышеописанные функции соответствуют определению “чистых”. + + +## Ключевые моменты + +Первым ключевым моментом этого раздела является определение чистой функции: + +> _Чистая функция_ — это функция, которая зависит только от своих объявленных входных данных +> и своей реализации для получения результата. +> Она только вычисляет свой результат, не завися от внешнего мира и не изменяя его. + +Второй ключевой момент заключается в том, что каждое реальное приложение взаимодействует с внешним миром. +Таким образом, упрощенный способ представления о функциональных программах состоит в том, +что они состоят из ядра чистых функций, которые обернуты другими функциями, взаимодействующими с внешним миром. + + +[eta]: {% link _overviews/scala3-book/fun-eta-expansion.md %} diff --git a/_ru/scala3/book/fp-summary.md b/_ru/scala3/book/fp-summary.md new file mode 100644 index 0000000000..eea013a88a --- /dev/null +++ b/_ru/scala3/book/fp-summary.md @@ -0,0 +1,31 @@ +--- +layout: multipage-overview +title: Обзор +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: Этот раздел суммирует предыдущие разделы функционального программирования. +language: ru +num: 46 +previous-page: fp-functional-error-handling +next-page: +--- + + +В этой главе представлено общее введение в функциональное программирование на Scala. +Охвачены следующие темы: + +- Что такое функциональное программирование? +- Неизменяемые значения +- Чистые функции +- Функции — это значения +- Функциональная обработка ошибок + +Как уже упоминалось, функциональное программирование — обширная тема, +поэтому все, что мы можем сделать в этой книге, — это коснуться перечисленных вводных понятий. +Дополнительные сведения см. [в справочной документации][reference]. + + +[reference]: {{ site.scala3ref }}/overview.html + diff --git a/_ru/scala3/book/fp-what-is-fp.md b/_ru/scala3/book/fp-what-is-fp.md new file mode 100644 index 0000000000..9e3f046542 --- /dev/null +++ b/_ru/scala3/book/fp-what-is-fp.md @@ -0,0 +1,48 @@ +--- +layout: multipage-overview +title: Что такое функциональное программирование? +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: Этот раздел дает ответ на вопрос, что такое функциональное программирование? +language: ru +num: 41 +previous-page: fp-intro +next-page: fp-immutable-values +--- + + +[Wikipedia](https://ru.wikipedia.org/wiki/%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5) +определяет _функциональное программирование_ следующим образом: + +<blockquote> +<p> +Функциональное программирование — парадигма программирования, +в которой процесс вычисления трактуется как вычисление значений функций в математическом понимании последних. +Функциональное программирование предполагает обходиться вычислением результатов функций от исходных данных +и результатов других функций, и не предполагает явного хранения состояния программы. +Соответственно, не предполагает оно и изменяемость этого состояния. +</p> +<p> </p> +<p> +В функциональном программировании функции рассматриваются как “граждане первого класса”, +что означает, что они могут быть привязаны к именам (включая локальные идентификаторы), +передаваться в качестве аргументов и возвращаться из других функций, как и любой другой тип данных. +Это позволяет писать программы в декларативном и составном стиле, где небольшие функции объединяются модульным образом. +</p> +</blockquote> + +Также полезно знать, что опытные функциональные программисты рассматривают свой код математически, +что объединение чистых функций вместе похоже на объединение ряда алгебраических уравнений. + +Когда пишется функциональный код, вы чувствуете себя математиком, и как только понимаете парадигму, +то хотите писать только чистые функции, которые всегда возвращают _значения_, а не исключения или null, +чтобы можно было комбинировать чистые функции вместе. +Ощущение, что вы пишете математические уравнения (выражения), является движущим желанием, +заставляющим использовать _только_ чистые функции и неизменяемые значения - +это то, что используется в алгебре и других формах математики. + +Функциональное программирование - это большая тема, и нет простого способа сжать её всю в одну главу. +В следующих разделах будет представлен обзор основных тем и показаны некоторые инструменты, +предоставляемые Scala для написания функционального кода. diff --git a/_ru/scala3/book/fun-summary.md b/_ru/scala3/book/fun-summary.md index 497e4d4c5e..77a72a05b2 100644 --- a/_ru/scala3/book/fun-summary.md +++ b/_ru/scala3/book/fun-summary.md @@ -9,7 +9,7 @@ description: На этой странице представлен обзор п language: ru num: 34 previous-page: fun-write-method-returns-function -next-page: +next-page: packaging-imports --- Это была длинная глава, поэтому давайте рассмотрим ключевые моменты, которые мы прошли. diff --git a/_ru/scala3/book/packaging-imports.md b/_ru/scala3/book/packaging-imports.md new file mode 100644 index 0000000000..bde9efdd30 --- /dev/null +++ b/_ru/scala3/book/packaging-imports.md @@ -0,0 +1,418 @@ +--- +layout: multipage-overview +title: Пакеты и импорт +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: chapter +description: Обсуждение использования пакетов и импорта для организации кода, создания связанных модулей кода, управления областью действия и предотвращения конфликтов пространств имен. +language: ru +num: 35 +previous-page: fun-summary +next-page: collections-intro +--- + + +Scala использует _packages_ для создания пространств имен, которые позволяют модульно разбивать программы. +Scala поддерживает стиль именования пакетов, используемый в Java, а также нотацию пространства имен “фигурные скобки”, +используемую такими языками, как C++ и C#. + +Подход Scala к импорту похож на Java, но более гибкий. +С помощью Scala можно: + +- импортировать пакеты, классы, объекты, trait-ы и методы +- размещать операторы импорта в любом месте +- скрывать и переименовывать участников при импорте + +Эти особенности демонстрируются в следующих примерах. + + +## Создание пакета + +Пакеты создаются путем объявления одного или нескольких имен пакетов в начале файла Scala. +Например, если ваше доменное имя _acme.com_ и вы работаете с пакетом _model_ приложения с именем _myapp_, +объявление пакета выглядит следующим образом: + +```scala +package com.acme.myapp.model + +class Person ... +``` + +По соглашению все имена пакетов должны быть строчными, +а формальным соглашением об именах является _\<top-level-domain>.\<domain-name>.\<project-name>.\<module-name>_. + +Хотя это и не обязательно, имена пакетов обычно совпадают с именами иерархии каталогов. +Поэтому, если следовать этому соглашению, класс `Person` в этом проекте будет найден +в файле _MyApp/src/main/scala/com/acme/myapp/model/Person.scala_. + + +### Использование нескольких пакетов в одном файле + +Показанный выше синтаксис применяется ко всему исходному файлу: +все определения в файле `Person.scala` принадлежат пакету `com.acme.myapp.model` +в соответствии с предложением `package` в начале файла. + +В качестве альтернативы можно написать `package`, которые применяются только к содержащимся в них определениям: + +```scala +package users: + + package administrators: // полное имя пакета - users.administrators + class AdminUser // полное имя класса - users.administrators.AdminUser + + package normalusers: // полное имя пакета - users.normalusers + class NormalUser // полное имя класса - users.normalusers.NormalUser +``` + +Обратите внимание, что за именами пакетов следует двоеточие, а определения внутри пакета имеют отступ. + +Преимущество этого подхода заключается в том, что он допускает вложение пакетов +и обеспечивает более очевидный контроль над областью видимости и инкапсуляцией, особенно в пределах одного файла. + + +## Операторы импорта + +Операторы импорта используются для доступа к сущностям в других пакетах. +Операторы импорта делятся на две основные категории: + +- импорт классов, трейтов, объектов, функций и методов +- импорт `given` предложений + +Первая категория операторов импорта аналогична тому, что использует Java, +с немного другим синтаксисом, обеспечивающим большую гибкость. +Пример: + +```` +import users.* // импортируется все из пакета `users` +import users.User // импортируется только класс `User` +import users.{User, UserPreferences} // импортируются только два члена пакета +import users.{UserPreferences as UPrefs} // переименование импортированного члена +```` + +Эти примеры предназначены для того, чтобы дать представление о том, как работает первая категория операторов `import`. +Более подробно они объясняются в следующих подразделах. + +Операторы импорта также используются для импорта `given` экземпляров в область видимости. +Они обсуждаются в конце этой главы. + +> import не требуется для доступа к членам одного и того же пакета. + + +### Импорт одного или нескольких членов + +В Scala импортировать один элемент из пакета можно следующим образом: + +```scala +import scala.concurrent.Future +``` + +несколько: + +```scala +import scala.concurrent.Future +import scala.concurrent.Promise +import scala.concurrent.blocking +``` + +При импорте нескольких элементов их можно импортировать более лаконично: + +```scala +import scala.concurrent.{Future, Promise, blocking} +``` + +Если необходимо импортировать все из пакета _scala.concurrent_, используется такой синтаксис: + +```scala +import scala.concurrent.* +``` + + +### Переименование элементов при импорте + +Иногда необходимо переименовать объекты при их импорте, чтобы избежать конфликтов имен. +Например, если нужно использовать Scala класс `List` вместе с `java.util.List`, +то можно переименовать `java.util.List` при импорте: + +```scala +import java.util.{List as JavaList} +``` + +Теперь имя `JavaList` можно использовать для ссылки на класс `java.util.List` +и использовать `List` для ссылки на Scala класс `List`. + +Также можно переименовывать несколько элементов одновременно, используя следующий синтаксис: + +```scala +import java.util.{Date as JDate, HashMap as JHashMap, *} +``` + +В этой строке кода говорится следующее: “Переименуйте классы `Date` и `HashMap`, как показано, +и импортируйте все остальное из пакета `java.util`, не переименовывая”. + + +### Скрытие членов при импорте + +При импорте часть объектов можно _скрывать_. +Следующий оператор импорта скрывает класс `java.util.Random`, +в то время как все остальное в пакете `java.util` импортируется: + +```scala +import java.util.{Random as _, *} +``` + +Если попытаться получить доступ к классу `Random`, то выдается ошибка, +но есть доступ ко всем остальным членам пакета `java.util`: + +```scala +val r = new Random // не скомпилируется +new ArrayList // доступ есть +``` + +#### Скрытие нескольких элементов + +Чтобы скрыть в import несколько элементов, их можно перечислить перед использованием постановочного знака: + +```scala +scala> import java.util.{List as _, Map as _, Set as _, *} +``` + +Перечисленные классы скрыты, но можно использовать все остальное в _java.util_: + +```scala +scala> new ArrayList[String] +val res0: java.util.ArrayList[String] = [] +``` + +Поскольку эти Java классы скрыты, можно использовать классы Scala `List`, `Set` и `Map` без конфликта имен: + +```scala +scala> val a = List(1, 2, 3) +val a: List[Int] = List(1, 2, 3) + +scala> val b = Set(1, 2, 3) +val b: Set[Int] = Set(1, 2, 3) + +scala> val c = Map(1 -> 1, 2 -> 2) +val c: Map[Int, Int] = Map(1 -> 1, 2 -> 2) +``` + + +### Импорт можно использовать в любом месте + +В Scala операторы `import` могут быть объявлены где угодно. +Их можно использовать в верхней части файла исходного кода: + +```scala +package foo + +import scala.util.Random + +class ClassA: + def printRandom(): Unit = + val r = new Random // класс Random здесь доступен + // ещё код... +``` + +Также операторы `import` можно использовать ближе к тому месту, где они необходимы: + +```scala +package foo + +class ClassA: + import scala.util.Random // внутри ClassA + def printRandom(): Unit = + val r = new Random + // ещё код... + +class ClassB: + // класс Random здесь невидим + val r = new Random // этот код не скомпилится +``` + + +### “Статический” импорт + +Если необходимо импортировать элементы способом, аналогичным подходу “статического импорта” в Java, +то есть для того, чтобы напрямую обращаться к членам класса, не добавляя к ним префикс с именем класса, +используется следующий подход. + +Синтаксис для импорта всех статических членов Java класса `Math`: + +```scala +import java.lang.Math.* +``` + +Теперь можно получить доступ к статическим методам класса `Math`, +таким как `sin` и `cos`, без необходимости предварять их именем класса: + +```scala +import java.lang.Math.* + +val a = sin(0) // 0.0 +val b = cos(PI) // -1.0 +``` + + +### Пакеты, импортированные по умолчанию + +Два пакета неявно импортируются во все файлы исходного кода: + +- `java.lang.*` +- `scala.*` + +Члены object `Predef` также импортируются по умолчанию. + +> Например, такие классы, как `List`, `Vector`, `Map` и т.д. можно использовать явно, не импортируя их - +> они доступны, потому что определены в object `Predef` + + +### Обработка конфликтов имен + +Если необходимо импортировать что-то из корня проекта и возникает конфликт имен, +достаточно просто добавить к имени пакета префикс `_root_`: + +``` +package accounts + +import _root_.accounts.* +``` + + +## Импорт экземпляров `given` + +Как будет показано в главе [“Контекстные абстракции”][contextual], +для импорта экземпляров `given` используется специальная форма оператора `import`. +Базовая форма показана в этом примере: + +```scala +object A: + class TC + given tc as TC + def f(using TC) = ??? + +object B: + import A.* // импорт всех non-given членов + import A.given // импорт экземпляров given +``` + +В этом коде предложение `import A.*` объекта `B` импортирует все элементы `A`, _кроме_ `given` экземпляра `tc`. +И наоборот, второй импорт, `import A.given`, импортирует _только_ `given` экземпляр. +Два предложения импорта также могут быть объединены в одно: + +```scala +object B: + import A.{given, *} +``` + +### Обсуждение + +Селектор с подстановочным знаком `*` помещает в область видимости все определения, кроме `given`, +тогда как селектор выше помещает в область действия все данные, включая те, которые являются результатом расширений. + +Эти правила имеют два основных преимущества: + +- более понятно, откуда берутся данные given. + В частности, невозможно скрыть импортированные given в длинном списке других импортируемых подстановочных знаков. +- есть возможность импортировать все given, не импортируя ничего другого. + Это особенно важно, поскольку given могут быть анонимными, поэтому обычное использование именованного импорта нецелесообразно. + + +### Импорт по типу + +Поскольку given-ы могут быть анонимными, не всегда практично импортировать их по имени, +и вместо этого обычно используется импорт подстановочных знаков. +_Импорт по типу_ предоставляет собой более конкретную альтернативу импорту с подстановочными знаками, +делая понятным то, что импортируется. + +```scala +import A.{given TC} +``` + +Этот код импортирует из `A` любой `given` тип, соответствующий `TC`. +Импорт данных нескольких типов `T1,...,Tn` выражается несколькими `given` селекторами: + +```scala +import A.{given T1, ..., given Tn} +``` + +Импорт всех `given` экземпляров параметризованного типа достигается аргументами с подстановочными знаками. +Например, есть такой `объект`: + +```scala +object Instances: + given intOrd as Ordering[Int] + given listOrd[T: Ordering] as Ordering[List[T]] + given ec as ExecutionContext = ... + given im as Monoid[Int] +``` + +Оператор `import` ниже импортирует экземпляры `intOrd`, `listOrd` и `ec`, но пропускает экземпляр `im`, +поскольку он не соответствует ни одному из указанных шаблонов: + +```scala +import Instances.{given Ordering[?], given ExecutionContext} +``` + +Импорт по типу можно смешивать с импортом по имени. +Если оба присутствуют в предложении import, импорт по типу идет последним. +Например, это предложение импорта импортирует `im`, `intOrd` и `listOrd`, но не включает `ec`: + +```scala +import Instances.{im, given Ordering[?]} +``` + + +### Пример + +В качестве конкретного примера представим, что у нас есть объект `MonthConversions`, +который содержит два определения `given`: + +```scala +object MonthConversions: + trait MonthConverter[A]: + def convert(a: A): String + + given intMonthConverter: MonthConverter[Int] with + def convert(i: Int): String = + i match + case 1 => "January" + case 2 => "February" + // остальные случаи здесь ... + + given stringMonthConverter: MonthConverter[String] with + def convert(s: String): String = + s match + case "jan" => "January" + case "feb" => "February" + // остальные случаи здесь ... +``` + +Чтобы импортировать эти given-ы в текущую область, используем два оператора `import`: + +```scala +import MonthConversions.* +import MonthConversions.{given MonthConverter[?]} +``` + +Теперь создаем метод, использующий эти экземпляры: + +```scala +def genericMonthConverter[A](a: A)(using monthConverter: MonthConverter[A]): String = + monthConverter.convert(a) +``` + +Вызов метода: + +```scala +@main def main = + println(genericMonthConverter(1)) // January + println(genericMonthConverter("jan")) // January +``` + +Как уже упоминалось ранее, одно из ключевых преимуществ синтаксиса “import given” состоит в том, +чтобы прояснить, откуда берутся данные в области действия, +и в `import` операторах выше ясно, что данные поступают из объекта `MonthConversions`. + + +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} From af8b8940b16d65ea277f750a8d7ecb9c93538585 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 29 Apr 2023 00:21:06 +0000 Subject: [PATCH 2586/3075] Update SIPs state --- _sips/sips/quote-pattern-type-variable-syntax.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_sips/sips/quote-pattern-type-variable-syntax.md b/_sips/sips/quote-pattern-type-variable-syntax.md index 93774b5373..a0aed079b9 100644 --- a/_sips/sips/quote-pattern-type-variable-syntax.md +++ b/_sips/sips/quote-pattern-type-variable-syntax.md @@ -27,6 +27,8 @@ Namely when using explicit type variable definitions. ### Background +* [Reference Documentation](http://dotty.epfl.ch/docs/reference/metaprogramming/macros.html#type-variables) + Quoted expressions support two ways of defining type variables: explicit and nested. ##### Explicit type variables From 4f3329665a09c5a2660e492b462ed66410ee7021 Mon Sep 17 00:00:00 2001 From: DespiteDeath <Kogut_nikita@mail.ru> Date: Mon, 1 May 2023 10:08:05 +0300 Subject: [PATCH 2587/3075] Update variances.md due to the language rules (#2730) Co-authored-by: n.kogut <n.kogut@kryptonite.ru> --- _ru/overviews/collections-2.13/overview.md | 2 +- _ru/tour/implicit-conversions.md | 2 +- _ru/tour/variances.md | 12 ++++++------ 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/_ru/overviews/collections-2.13/overview.md b/_ru/overviews/collections-2.13/overview.md index 361d8f5551..6eb7087c63 100644 --- a/_ru/overviews/collections-2.13/overview.md +++ b/_ru/overviews/collections-2.13/overview.md @@ -41,7 +41,7 @@ language: ru scala.collection.immutable.List // Полное объявление scala.List // объявление через псевдоним - List // тк scala._ всегда автоматически импортируется + List // т.к. scala._ всегда автоматически импортируется // можно просто указать имя коллекции Другие псевдонимы для типов diff --git a/_ru/tour/implicit-conversions.md b/_ru/tour/implicit-conversions.md index 02c5319fae..77eb2c9c46 100644 --- a/_ru/tour/implicit-conversions.md +++ b/_ru/tour/implicit-conversions.md @@ -48,7 +48,7 @@ implicit def int2Integer(x: Int) = java.lang.Integer.valueOf(x) ``` -Компилятор предупреждает при компиляции об обнаружении неявных преобразований, тк неявные преобразования могут иметь разные подводные камни (особенно если использовать их без разбора). +Компилятор предупреждает при компиляции об обнаружении неявных преобразований, т.к. неявные преобразования могут иметь разные подводные камни (особенно если использовать их без разбора). Чтоб отключить предупреждения выполните одно из следующих действий: diff --git a/_ru/tour/variances.md b/_ru/tour/variances.md index 17dd06b74c..3a56ae2e6d 100644 --- a/_ru/tour/variances.md +++ b/_ru/tour/variances.md @@ -8,12 +8,12 @@ next-page: upper-type-bounds previous-page: generic-classes --- -Вариантность (Variances) - это указание определенной специфики взаимосвязи между связанными типам. Scala поддерживает вариантную аннотацию типов у [обобщенных классов](generic-classes.html), что позволяет им быть ковариантными, контрвариантными или инвариантными (если нет никакого указание на вариантность). Использование вариантности в системе типов позволяет устанавливать понятные взаимосвязи между сложными типами, в то время как отсутствие вариантности может ограничить повторное использование абстракции класса. +Вариантность (Variances) - это указание определенной специфики взаимосвязи между связанными типам. Scala поддерживает вариантную аннотацию типов у [обобщенных классов](generic-classes.html), что позволяет им быть ковариантными, контрвариантными или инвариантными (если нет никакого указания на вариантность). Использование вариантности в системе типов позволяет устанавливать понятные взаимосвязи между сложными типами, в то время как отсутствие вариантности может ограничить повторное использование абстракции класса. ```scala mdoc class Foo[+A] // ковариантный класс -class Bar[-A] // контрвариантный класс -class Baz[A] // инвариантными класс +class Bar[-A] // контравариантный класс +class Baz[A] // инвариантный класс ``` ### Ковариантность @@ -135,15 +135,15 @@ val cat: Cat = catContainer.getValue // Ой, мы бы закончили пр Другим примером, который может помочь понять вариантность, является трейт `Function1[-T, +R]` из стандартной библиотеки Scala. `Function1` представляет собой функцию с одним параметром, где первый тип `T` представляет собой тип параметра, а второй тип `R` представляет собой тип результата. Функция `Function1` является контрвариантной в рамках типа принимаемого аргумента, а ковариантной - в рамках возвращаемого типа. Для этого примера мы будем использовать явное обозначение типа `A =>B` чтоб продемонстрировать `Function1[A, B]`. -Рассмотрим схожий пример `Cat`, `Dog`, `Animal` в той же взаимосвязи что и раньше, плюс следующее: +Рассмотрим схожий пример `Cat`, `Dog`, `Animal` в той же взаимосвязи, что и раньше, плюс следующее: ```scala mdoc abstract class SmallAnimal extends Animal case class Mouse(name: String) extends SmallAnimal ``` -Предположим, мы работаем с функциями, которые принимают типы животных и возвращают типы еды, которую они едят. Если мы хотим `Cat => SmallAnimal` (потому что кошки едят маленьких животных), но вместо этого мы получим функцию `Animal => Mouse`, то наша программа все равно будет работать. Интуитивно функция `Animal => Mouse` все равно будет принимать `Cat` в качестве аргумента, тк `Cat` является `Animal`, и возвращать `Mouse` - который также является и `SmallAnimal`. Поскольку мы можем безопасно заменить первое вторым, можно сказать, что `Animal => Mouse` аналогично `Cat => SmallAnimal`. +Предположим, что мы работаем с функциями, которые принимают типы животных и возвращают типы еды. Если мы хотим `Cat => SmallAnimal` (потому что кошки едят маленьких животных), но вместо этого мы получим функцию `Animal => Mouse`, то наша программа все равно будет работать. Интуитивно функция `Animal => Mouse` все равно будет принимать `Cat` в качестве аргумента, т.к. `Cat` является `Animal`, и возвращать `Mouse` - который также является и `SmallAnimal`. Поскольку мы можем безопасно заменить первое вторым, можно сказать, что `Animal => Mouse` аналогично `Cat => SmallAnimal`. ### Сравнение с другими языками -В языках, похожих на Scala, разные способы поддержи вариантности. Например, указания вариантности в Scala очень похожи на то, как это делается в C#, где такие указания добавляются при объявлении абстракции класса (вариантность при объявлении). Однако в Java, указание вариантности задается непосредственно при использовании абстракции класса (вариантность при использовании). +В языках, похожих на Scala, разные способы поддержки вариантности. Например, указания вариантности в Scala очень похожи на то, как это делается в C#, где такие указания добавляются при объявлении абстракции класса (вариантность при объявлении). Однако в Java, указание вариантности задается непосредственно при использовании абстракции класса (вариантность при использовании). From 521e91bd3eaacbb782e108e2be15feacd96ac4f6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Tue, 2 May 2023 09:09:39 +0300 Subject: [PATCH 2588/3075] update Gemfile.lock for Windows 10, x64 --- Gemfile.lock | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Gemfile.lock b/Gemfile.lock index db9a8aba70..ed3ff1d122 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -221,6 +221,8 @@ GEM minitest (5.18.0) nokogiri (1.14.3-arm64-darwin) racc (~> 1.4) + nokogiri (1.14.3-x64-mingw-ucrt) + racc (~> 1.4) nokogiri (1.14.3-x86_64-linux) racc (~> 1.4) octokit (4.25.1) @@ -266,6 +268,7 @@ GEM PLATFORMS arm64-darwin-22 + x64-mingw-ucrt x86_64-linux DEPENDENCIES From 17a1915aaf5d0b16616f4b6738ae285a5ebd50f6 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Tue, 2 May 2023 11:12:20 +0300 Subject: [PATCH 2589/3075] Refresh tour/basic.md (#2780) --- _ru/tour/basics.md | 300 ++++++++++++++++++++++++++++++++++++++++++++- _tour/basics.md | 2 +- 2 files changed, 299 insertions(+), 3 deletions(-) diff --git a/_ru/tour/basics.md b/_ru/tour/basics.md index 8af52f18fe..ecd5595830 100644 --- a/_ru/tour/basics.md +++ b/_ru/tour/basics.md @@ -26,11 +26,22 @@ previous-page: tour-of-scala ## Выражения Выражения — это вычислимые утверждения. + +{% tabs expression %} +{% tab 'Scala 2 и 3' for=expression %} + ```scala mdoc 1 + 1 ``` + +{% endtab %} +{% endtabs %} + Вы можете выводить результаты выражений, используя `println`. +{% tabs println %} +{% tab 'Scala 2 и 3' for=println %} + ```scala mdoc println(1) // 1 println(1 + 1) // 2 @@ -38,48 +49,80 @@ println("Hello!") // Hello! println("Hello," + " world!") // Hello, world! ``` +{% endtab %} +{% endtabs %} + ### Значения Результаты выражений можно присваивать именам с помощью ключевого слова `val`. +{% tabs val %} +{% tab 'Scala 2 и 3' for=val %} + ```scala mdoc val x = 1 + 1 println(x) // 2 ``` +{% endtab %} +{% endtabs %} + Названные результаты, такие как `x` в примере, называются значениями. Вызов значения не приводит к его повторному вычислению. Значения не изменяемы и не могут быть переназначены. +{% tabs val-error %} +{% tab 'Scala 2 и 3' for=val-error %} + ```scala mdoc:fail x = 3 // Не компилируется. ``` +{% endtab %} +{% endtabs %} + Типы значений могут быть выведены автоматически, но можно и явно указать тип, как показано ниже: +{% tabs type-inference %} +{% tab 'Scala 2 и 3' for=type-inference %} + ```scala mdoc:nest val x: Int = 1 + 1 ``` +{% endtab %} +{% endtabs %} + Обратите внимание, что объявление типа `Int` происходит после идентификатора `x`, следующим за `:`. ### Переменные Переменные похожи на значения константы, за исключением того, что их можно присваивать заново. Вы можете объявить переменную с помощью ключевого слова `var`. +{% tabs var %} +{% tab 'Scala 2 и 3' for=var %} + ```scala mdoc:nest var x = 1 + 1 x = 3 // Компилируется потому что "x" объявлен с ключевым словом "var". println(x * x) // 9 ``` +{% endtab %} +{% endtabs %} + Как и в случае со значениями, вы можете явно указать тип, если захотите: +{% tabs type-inference-2 %} +{% tab 'Scala 2 и 3' for=type-inference-2 %} + ```scala mdoc:nest var x: Int = 1 + 1 ``` +{% endtab %} +{% endtabs %} ## Блоки @@ -87,6 +130,9 @@ var x: Int = 1 + 1 Результат последнего выражения в блоке будет результатом всего блока в целом. +{% tabs blocks %} +{% tab 'Scala 2 и 3' for=blocks %} + ```scala mdoc println({ val x = 1 + 1 @@ -94,70 +140,119 @@ println({ }) // 3 ``` +{% endtab %} +{% endtabs %} + ## Функции Функции — это выражения, которые принимают параметры. Вы можете определить анонимную функцию (т.е. без имени), которая возвращает переданное число, прибавив к нему единицу: +{% tabs anonymous-function %} +{% tab 'Scala 2 и 3' for=anonymous-function %} + ```scala mdoc (x: Int) => x + 1 ``` +{% endtab %} +{% endtabs %} + Слева от `=>` находится список параметров. Справа — выражение, связанное с параметрами. Вы также можете назвать функции. +{% tabs named-function %} +{% tab 'Scala 2 и 3' for=named-function %} + ```scala mdoc val addOne = (x: Int) => x + 1 println(addOne(1)) // 2 ``` +{% endtab %} +{% endtabs %} + Функции могут принимать множество параметров. +{% tabs multiple-parameters %} +{% tab 'Scala 2 и 3' for=multiple-parameters %} + ```scala mdoc val add = (x: Int, y: Int) => x + y println(add(1, 2)) // 3 ``` +{% endtab %} +{% endtabs %} + Или вообще не принимать никаких параметров. +{% tabs no-parameters %} +{% tab 'Scala 2 и 3' for=no-parameters %} + ```scala mdoc val getTheAnswer = () => 42 println(getTheAnswer()) // 42 ``` +{% endtab %} +{% endtabs %} + ## Методы Методы выглядят и ведут себя очень похоже на функции, но между ними есть несколько принципиальных различий. -Методы задаются ключевым словом `def`. За `def` следует имя, список параметров, возвращаемый тип и тело. +Методы задаются ключевым словом `def`. За `def` следует имя, список параметров, возвращаемый тип и тело. + +{% tabs method %} +{% tab 'Scala 2 и 3' for=method %} ```scala mdoc:nest def add(x: Int, y: Int): Int = x + y println(add(1, 2)) // 3 ``` +{% endtab %} +{% endtabs %} + Обратите внимание, как объявлен возвращаемый тип сразу _после_ списка параметров и двоеточия `: Int`. Методы могут принимать несколько списков параметров. +{% tabs multiple-parameter-lists %} +{% tab 'Scala 2 и 3' for=multiple-parameter-lists %} + ```scala mdoc def addThenMultiply(x: Int, y: Int)(multiplier: Int): Int = (x + y) * multiplier println(addThenMultiply(1, 2)(3)) // 9 ``` +{% endtab %} +{% endtabs %} + Или вообще ни одного списка параметров. +{% tabs no-parameter-lists %} +{% tab 'Scala 2 и 3' for=no-parameter-lists %} + ```scala mdoc def name: String = System.getProperty("user.name") println("Hello, " + name + "!") ``` +{% endtab %} +{% endtabs %} + Есть некоторые отличия от функций, но пока что их можно рассматривать как нечто похожее. Методы также могут иметь многострочные выражения. +{% tabs get-square-string class=tabs-scala-version %} + +{% tab 'Scala 2' for=get-square-string %} + ```scala mdoc def getSquareString(input: Double): String = { val square = input * input @@ -166,47 +261,115 @@ def getSquareString(input: Double): String = { println(getSquareString(2.5)) // 6.25 ``` +{% endtab %} + +{% tab 'Scala 3' for=get-square-string %} + +```scala +def getSquareString(input: Double): String = + val square = input * input + square.toString + +println(getSquareString(2.5)) // 6.25 +``` + +{% endtab %} + +{% endtabs %} + Последнее выражение в теле становится возвращаемым значением метода (у Scala есть ключевое слово `return`, но оно практически не используется). ## Классы Вы можете объявлять классы используя ключевое слово `class`, за которым следует его имя и параметры конструктора. +{% tabs greeter-definition class=tabs-scala-version %} + +{% tab 'Scala 2' for=greeter-definition %} + ```scala mdoc class Greeter(prefix: String, suffix: String) { def greet(name: String): Unit = println(prefix + name + suffix) } ``` + +{% endtab %} + +{% tab 'Scala 3' for=greeter-definition %} + +```scala +class Greeter(prefix: String, suffix: String): + def greet(name: String): Unit = + println(prefix + name + suffix) +``` + +{% endtab %} + +{% endtabs %} + Возвращаемый тип метода `greet` это `Unit`, используется тогда, когда не имеет смысла что-либо возвращать. Аналогично `void` в Java и C. Поскольку каждое выражение Scala должно иметь какое-то значение, то при отсутствии возвращающегося значения возвращается экземпляр типа Unit. Явным образом его можно задать как `()`, он не несет какой-либо информации. Вы можете создать экземпляр класса, используя ключевое слово `new`. -```scala mdoc +{% tabs greeter-usage class=tabs-scala-version %} + +{% tab 'Scala 2' for=greeter-usage %} + +```scala mdoc:nest val greeter = new Greeter("Hello, ", "!") greeter.greet("Scala developer") // Hello, Scala developer! ``` +{% endtab %} + +{% tab 'Scala 3' for=greeter-usage %} + +```scala +val greeter = Greeter("Hello, ", "!") +greeter.greet("Scala developer") // Hello, Scala developer! +``` + +{% endtab %} + +{% endtabs %} + Позже мы рассмотрим классы [подробнее](classes.html). ## Классы-образцы (Case Class) В Scala есть специальный тип класса, который называется классом-образцом (case class). По умолчанию такие классы неизменны и сравниваются по значению из конструктора. Вы можете объявлять классы-образцы с помощью ключевых слов `case class`. +{% tabs case-class-definition %} +{% tab 'Scala 2 и 3' for=case-class-definition %} + ```scala mdoc case class Point(x: Int, y: Int) ``` +{% endtab %} +{% endtabs %} + Можно создавать экземпляры класса-образца без использования ключевого слова `new`. +{% tabs case-class-creation %} +{% tab 'Scala 2 и 3' for=case-class-creation %} + ```scala mdoc val point = Point(1, 2) val anotherPoint = Point(1, 2) val yetAnotherPoint = Point(2, 2) ``` +{% endtab %} +{% endtabs %} + Они сравниваются по значению. +{% tabs compare-case-class-equality class=tabs-scala-version %} + +{% tab 'Scala 2' for=compare-case-class-equality %} + ```scala mdoc if (point == anotherPoint) { println(s"$point and $anotherPoint are the same.") @@ -221,6 +384,28 @@ if (point == yetAnotherPoint) { } // Point(1,2) и Point(2,2) разные. ``` +{% endtab %} + +{% tab 'Scala 3' for=compare-case-class-equality %} + +```scala +if point == anotherPoint then + println(s"$point and $anotherPoint are the same.") +else + println(s"$point and $anotherPoint are different.") +// Point(1,2) и Point(1,2) одни и те же. + +if point == yetAnotherPoint then + println(s"$point and $yetAnotherPoint are the same.") +else + println(s"$point and $yetAnotherPoint are different.") +// Point(1,2) и Point(2,2) разные. +``` + +{% endtab %} + +{% endtabs %} + Есть еще много деталей, которые мы бы хотели рассказать про классы-образцы; мы уверены, что вы влюбитесь в них! Обязательно рассмотрим их [позже](case-classes.html). ## Объекты @@ -229,6 +414,10 @@ if (point == yetAnotherPoint) { Вы можете задать объекты при помощи ключевого слова `object`. +{% tabs id-factory-definition class=tabs-scala-version %} + +{% tab 'Scala 2' for=id-factory-definition %} + ```scala mdoc object IdFactory { private var counter = 0 @@ -239,8 +428,27 @@ object IdFactory { } ``` +{% endtab %} + +{% tab 'Scala 3' for=id-factory-definition %} + +```scala +object IdFactory: + private var counter = 0 + def create(): Int = + counter += 1 + counter +``` + +{% endtab %} + +{% endtabs %} + Вы можете сразу получить доступ к объекту, ссылаясь на его имя. +{% tabs id-factory-usage %} +{% tab 'Scala 2 и 3' for=id-factory-usage %} + ```scala mdoc val newId: Int = IdFactory.create() println(newId) // 1 @@ -248,6 +456,9 @@ val newerId: Int = IdFactory.create() println(newerId) // 2 ``` +{% endtab %} +{% endtabs %} + Позже мы рассмотрим объекты [подробнее](singleton-objects.html). ## Трейты @@ -256,14 +467,35 @@ println(newerId) // 2 Объявить трейт можно с помощью ключевого слова `trait`. +{% tabs greeter-trait-def class=tabs-scala-version %} + +{% tab 'Scala 2' for=greeter-trait-def %} + ```scala mdoc:nest trait Greeter { def greet(name: String): Unit } ``` +{% endtab %} + +{% tab 'Scala 3' for=greeter-trait-def %} + +```scala +trait Greeter: + def greet(name: String): Unit +``` + +{% endtab %} + +{% endtabs %} + Трейты также могут иметь реализации методов и полей, которые предполагается использовать умолчанию. +{% tabs greeter-trait-def-impl class=tabs-scala-version %} + +{% tab 'Scala 2' for=greeter-trait-def-impl %} + ```scala mdoc:reset trait Greeter { def greet(name: String): Unit = @@ -271,8 +503,26 @@ trait Greeter { } ``` +{% endtab %} + +{% tab 'Scala 3' for=greeter-trait-def-impl %} + +```scala +trait Greeter: + def greet(name: String): Unit = + println("Hello, " + name + "!") +``` + +{% endtab %} + +{% endtabs %} + Вы можете наследовать свойства трейтов, используя ключевое слово `extends` и переопределять реализацию с помощью ключевого слова `override`. +{% tabs greeter-implementations class=tabs-scala-version %} + +{% tab 'Scala 2' for=greeter-implementations %} + ```scala mdoc class DefaultGreeter extends Greeter @@ -289,6 +539,28 @@ val customGreeter = new CustomizableGreeter("How are you, ", "?") customGreeter.greet("Scala developer") // How are you, Scala developer? ``` +{% endtab %} + +{% tab 'Scala 3' for=greeter-implementations %} + +```scala +class DefaultGreeter extends Greeter + +class CustomizableGreeter(prefix: String, postfix: String) extends Greeter: + override def greet(name: String): Unit = + println(prefix + name + postfix) + +val greeter = DefaultGreeter() +greeter.greet("Scala developer") // Hello, Scala developer! + +val customGreeter = CustomizableGreeter("How are you, ", "?") +customGreeter.greet("Scala developer") // How are you, Scala developer? +``` + +{% endtab %} + +{% endtabs %} + Здесь `DefaultGreeter` наследуется только от одного трейта, но можно наследоваться от нескольких. Позже мы рассмотрим трейты [подробнее](traits.html). @@ -300,9 +572,33 @@ customGreeter.greet("Scala developer") // How are you, Scala developer? Используя объект, можно задать главный метод следующим образом: +{% tabs hello-world-demo class=tabs-scala-version %} + +{% tab 'Scala 2' for=hello-world-demo %} + +In Scala 2 you must define a main method manually. Using an object, you can define the main method as follows: + ```scala mdoc object Main { def main(args: Array[String]): Unit = println("Hello, Scala developer!") } ``` + +{% endtab %} + +{% tab 'Scala 3' for=hello-world-demo %} + +In Scala 3, with the `@main` annotation, a main method is automatically generated from a method as follows: + +```scala +@main def hello() = println("Hello, Scala developer!") +``` + +{% endtab %} + +{% endtabs %} + +## Дополнительные ресурсы + +- Обзор [Scala book](/ru/scala3/book/taste-intro.html) diff --git a/_tour/basics.md b/_tour/basics.md index 540cd9e4a6..f7cb96c667 100644 --- a/_tour/basics.md +++ b/_tour/basics.md @@ -532,4 +532,4 @@ In Scala 3, with the `@main` annotation, a main method is automatically generate ## More resources -* [Scala book](/overviews/scala-book/prelude-taste-of-scala.html) overview +* [Scala book](/scala3/book/taste-intro.html) overview From 8b6021608da782cc3668514181fe9894a802fc59 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Wed, 3 May 2023 08:18:06 +0300 Subject: [PATCH 2590/3075] Add types-introduction.md in russian --- _overviews/scala3-book/types-introduction.md | 2 +- _ru/scala3/book/fp-summary.md | 2 +- _ru/scala3/book/types-introduction.md | 68 ++++++++++++++++++++ 3 files changed, 70 insertions(+), 2 deletions(-) create mode 100644 _ru/scala3/book/types-introduction.md diff --git a/_overviews/scala3-book/types-introduction.md b/_overviews/scala3-book/types-introduction.md index f2fe4c245e..f5267d7eb2 100644 --- a/_overviews/scala3-book/types-introduction.md +++ b/_overviews/scala3-book/types-introduction.md @@ -2,7 +2,7 @@ title: Types and the Type System type: chapter description: This chapter provides an introduction to Scala 3 types and the type system. -languages: [zh-cn] +languages: [ru, zh-cn] num: 47 previous-page: fp-summary next-page: types-inferred diff --git a/_ru/scala3/book/fp-summary.md b/_ru/scala3/book/fp-summary.md index eea013a88a..3a3cc5498d 100644 --- a/_ru/scala3/book/fp-summary.md +++ b/_ru/scala3/book/fp-summary.md @@ -9,7 +9,7 @@ description: Этот раздел суммирует предыдущие ра language: ru num: 46 previous-page: fp-functional-error-handling -next-page: +next-page: types-introduction --- diff --git a/_ru/scala3/book/types-introduction.md b/_ru/scala3/book/types-introduction.md new file mode 100644 index 0000000000..656b821de4 --- /dev/null +++ b/_ru/scala3/book/types-introduction.md @@ -0,0 +1,68 @@ +--- +layout: multipage-overview +title: Типы и система типов +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этой главе представлено введение в типы и систему типов Scala 3. +language: ru +num: 47 +previous-page: fp-summary +next-page: +--- + +Scala — уникальный язык, поскольку он статически типизирован, но часто кажется гибким и динамичным. +Например, благодаря выводу типов можно писать код без явного указания типов переменных: + +{% tabs hi %} +{% tab 'Scala 2 и 3' %} + +```scala +val a = 1 +val b = 2.0 +val c = "Hi!" +``` + +{% endtab %} +{% endtabs %} + +Это делает код динамически типизированным. +А благодаря новым функциям в Scala 3, таким как [объединение типов][union-types], +также можно писать код, подобный следующему, +который кратко выражает, какие значения ожидаются в качестве аргументов и какие типы возвращаются: + +{% tabs union-example %} +{% tab 'Только в Scala 3' %} + +```scala +def isTruthy(a: Boolean | Int | String): Boolean = ??? +def dogCatOrWhatever(): Dog | Plant | Car | Sun = ??? +``` + +{% endtab %} +{% endtabs %} + +Как видно из примера, при использовании объединения типы необязательно должны иметь общую иерархию, +и их по-прежнему можно принимать в качестве аргументов или возвращать из метода. + +При разработке приложений такие функции, как вывод типов, +используются каждый день, а generics - каждую неделю. +При чтении Scaladoc для классов и методов, также необходимо иметь некоторое представление о _ковариантности_. +Использование типов может быть относительно простым, +а также обеспечивает большую выразительность, гибкость и контроль для разработчиков библиотек. + +## Преимущества типов + +Языки программирования со статической типизацией предлагают ряд преимуществ, в том числе: + +- помощь IDE в обеспечении надежной поддержки +- устранение многих классов потенциальных ошибок во время компиляции +- помощь в рефакторинге +- предоставление надежной документации, которая не может быть нерелевантной, поскольку проверена на тип + +## Знакомство с особенностями системы типов в Scala + +Учитывая это краткое введение, в следующих разделах представлен обзор особенностей системы типов в Scala. + +[union-types]: {% link _overviews/scala3-book/types-union.md %} From 4c6a3c71da5248eec3e1f3b0c737a084c7c2cf10 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Wed, 3 May 2023 10:08:29 +0300 Subject: [PATCH 2591/3075] Refresh _ru\tour\named-argument.md (#2784) --- _ru/tour/named-arguments.md | 33 ++++++++++++++++++++++++++------- 1 file changed, 26 insertions(+), 7 deletions(-) diff --git a/_ru/tour/named-arguments.md b/_ru/tour/named-arguments.md index 463480e547..5b2376cf4b 100644 --- a/_ru/tour/named-arguments.md +++ b/_ru/tour/named-arguments.md @@ -11,19 +11,38 @@ prerequisite-knowledge: function-syntax При вызове методов можно конкретно указывать название задаваемого аргумента следующим образом: +{% tabs named-arguments-when-good %} + +{% tab 'Scala 2 и 3' for=named-arguments-when-good %} + ```scala mdoc -def printName(first: String, last: String): Unit = { +def printName(first: String, last: String): Unit = println(first + " " + last) -} -printName("John", "Smith") // Prints "John Smith" -printName(first = "John", last = "Smith") // Prints "John Smith" -printName(last = "Smith", first = "John") // Prints "John Smith" +printName("John", "Smith") // выводит "John Smith" +printName(first = "John", last = "Smith") // выводит "John Smith" +printName(last = "Smith", first = "John") // выводит "John Smith" ``` -Обратите внимание, что при указании имени параметра, порядок аргумента может быть изменен. Однако если какие-то аргументы именованные, а другие нет, то аргументы без имени должны стоять на первом месте и располагаться в том порядке, в котором описаны параметры метода. + +{% endtab %} + +{% endtabs %} + +Обратите внимание, что при указании имени параметра, порядок аргумента может быть изменен. +Однако если какие-то аргументы именованные, а другие нет, +то аргументы без имени должны стоять на первом месте и располагаться в том порядке, в котором описаны параметры метода. + +{% tabs named-arguments-when-error %} + +{% tab 'Scala 2 и 3' for=named-arguments-when-error %} ```scala mdoc:fail printName(last = "Smith", "john") // ошибка: позиция после именованного аргумента ``` -Обратите внимание, что именованные аргументы не работают при вызове Java методов. +{% endtab %} + +{% endtabs %} + +Именованные аргументы работают при вызове Java методов, но только в том случае, +если используемая Java библиотека была скомпилирована с `-parameters`. From 0b6ecb94bba8738428d87d0c2f26b1f486847d2f Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Wed, 3 May 2023 10:08:57 +0300 Subject: [PATCH 2592/3075] Refresh /tour/unified-types.md (#2781) --- _ru/tour/unified-types.md | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/_ru/tour/unified-types.md b/_ru/tour/unified-types.md index 7b692d363e..e5f947ed89 100644 --- a/_ru/tour/unified-types.md +++ b/_ru/tour/unified-types.md @@ -13,7 +13,7 @@ prerequisite-knowledge: classes, basics <a href="{{ site.baseurl }}/resources/images/tour/unified-types-diagram.svg"><img style="width:100%" src="{{ site.baseurl }}/resources/images/tour/unified-types-diagram.svg" alt="Scala Type Hierarchy"></a> -## Иерархия типов Scala ## +## Иерархия типов Scala [`Any`](https://www.scala-lang.org/api/2.12.1/scala/Any.html) это супертип всех типов, также называемый верхним типом. Он определяет несколько универсальных методов, таких как `equals`, `hashCode` и `toString`. У `Any` есть два прямых подкласса: `AnyVal` и `AnyRef`. @@ -23,6 +23,9 @@ prerequisite-knowledge: classes, basics Вот пример, демонстрирующий, что строки, целые числа, символы, логические значения и функции являются объектами, как и любой другой объект: +{% tabs unified-types-1 %} +{% tab 'Scala 2 и 3' for=unified-types-1 %} + ```scala mdoc val list: List[Any] = List( "a string", @@ -35,6 +38,9 @@ val list: List[Any] = List( list.foreach(element => println(element)) ``` +{% endtab %} +{% endtabs %} + Объявляем переменную `list` типа `List[Any]`. Список инициализируется элементами различных типов, но все они являются экземпляром `scala.Any`, так что вы можете добавить их в список. Ниже приведен вывод программы: @@ -48,11 +54,15 @@ true ``` ## Приведение типа + Числовые типы могут быть приведены следующим образом: <a href="{{ site.baseurl }}/resources/images/tour/type-casting-diagram.svg"><img style="width:100%" src="{{ site.baseurl }}/resources/images/tour/type-casting-diagram.svg" alt="Scala Type Hierarchy"></a> Например: +{% tabs unified-types-2 %} +{% tab 'Scala 2 и 3' for=unified-types-2 %} + ```scala mdoc val x: Long = 987654321 val y: Float = x.toFloat // 9.8765434E8 (заметьте, что некоторая точность теряется в этом случае.) @@ -61,17 +71,27 @@ val face: Char = '☺' val number: Int = face // 9786 ``` +{% endtab %} +{% endtabs %} + Приведение типа - однонаправленно. Следующий пример не скомпилируется: +{% tabs unified-types-3 %} +{% tab 'Scala 2 и 3' for=unified-types-3 %} + ``` val x: Long = 987654321 val y: Float = x.toFloat // 9.8765434E8 val z: Long = y // обратно не подходит ``` +{% endtab %} +{% endtabs %} + Вы также можете приводить к своему подтипу. Об этом мы поговорим позже в ходе нашего обзора. ## Nothing и Null -`Nothing` является подтипом всех типов, также называемым нижним типом. Нет значения, которое имеет тип `Nothing`. Обычно он используется чтоб дать сигнал о не вычислимости, например брошено исключение, выход из программы, бесконечное зацикливание (т.е. это тип выражения, которое не вычисляется). + +`Nothing` является подтипом всех типов, также называемым нижним типом. Нет значения, которое имеет тип `Nothing`. Обычно он используется чтоб дать сигнал о не вычислимости, например брошено исключение, выход из программы, бесконечное зацикливание (т.е. это тип выражения, которое не вычисляется). `Null` подтип всех ссылочных типов (т.е. любой подтип AnyRef). Он имеет одно значение, определяемое ключевым словом литерала `null`. `Null` предоставляется в основном для функциональной совместимости с другими языками JVM и почти никогда не должен использоваться в коде Scala. Об альтернативах `null` мы поговорим позднее. From a2f2239bb640d1b0534d7897ada9f10b3f00d3e3 Mon Sep 17 00:00:00 2001 From: som-snytt <som.snytt@gmail.com> Date: Wed, 3 May 2023 00:48:45 -0700 Subject: [PATCH 2593/3075] Add example for error handling in ExecutionContext (#2777) --- _overviews/core/futures.md | 245 ++++++++++++++++++++++++++++++++++--- 1 file changed, 230 insertions(+), 15 deletions(-) diff --git a/_overviews/core/futures.md b/_overviews/core/futures.md index 9704cd57af..aac3aa4b4f 100644 --- a/_overviews/core/futures.md +++ b/_overviews/core/futures.md @@ -14,7 +14,8 @@ permalink: /overviews/core/:title.html ## Introduction Futures provide a way to reason about performing many operations -in parallel-- in an efficient and non-blocking way. +in parallel -- in an efficient and non-blocking way. + A [`Future`](https://www.scala-lang.org/api/current/scala/concurrent/Future.html) is a placeholder object for a value that may not yet exist. Generally, the value of the Future is supplied concurrently and can subsequently be used. @@ -283,7 +284,7 @@ Completion can take one of two forms: A `Future` has an important property that it may only be assigned once. Once a `Future` object is given a value or an exception, it becomes -in effect immutable-- it can never be overwritten. +in effect immutable -- it can never be overwritten. The simplest way to create a future object is to invoke the `Future.apply` method which starts an asynchronous computation and returns a @@ -335,8 +336,8 @@ To obtain the list of friends of a user, a request has to be sent over a network, which can take a long time. This is illustrated with the call to the method `getFriends` that returns `List[Friend]`. To better utilize the CPU until the response arrives, we should not -block the rest of the program-- this computation should be scheduled -asynchronously. The `Future.apply` method does exactly that-- it performs +block the rest of the program -- this computation should be scheduled +asynchronously. The `Future.apply` method does exactly that -- it performs the specified computation block concurrently, in this case sending a request to the server and waiting for a response. @@ -396,7 +397,7 @@ We are often interested in the result of the computation, not just its side-effects. In many future implementations, once the client of the future becomes interested -in its result, it has to block its own computation and wait until the future is completed-- +in its result, it has to block its own computation and wait until the future is completed -- only then can it use the value of the future to continue its own computation. Although this is allowed by the Scala `Future` API as we will show later, from a performance point of view a better way to do it is in a completely @@ -428,7 +429,7 @@ value is a `Throwable`. Coming back to our social network example, let's assume we want to fetch a list of our own recent posts and render them to the screen. We do so by calling a method `getRecentPosts` which returns -a `List[String]`-- a list of recent textual posts: +a `List[String]` -- a list of recent textual posts: {% tabs futures-05 class=tabs-scala-version %} {% tab 'Scala 2' for=futures-05 %} @@ -650,7 +651,7 @@ some other currency. We would have to repeat this pattern within the to reason about. Second, the `purchase` future is not in the scope with the rest of -the code-- it can only be acted upon from within the `foreach` +the code -- it can only be acted upon from within the `foreach` callback. This means that other parts of the application do not see the `purchase` future and cannot register another `foreach` callback to it, for example, to sell some other currency. @@ -760,7 +761,7 @@ Here is an example of `flatMap` and `withFilter` usage within for-comprehensions {% endtabs %} The `purchase` future is completed only once both `usdQuote` -and `chfQuote` are completed-- it depends on the values +and `chfQuote` are completed -- it depends on the values of both these futures so its own computation cannot begin earlier. @@ -1086,7 +1087,7 @@ Here is an example of how to block on the result of a future: In the case that the future fails, the caller is forwarded the exception that the future is failed with. This includes the `failed` -projection-- blocking on it results in a `NoSuchElementException` +projection -- blocking on it results in a `NoSuchElementException` being thrown if the original future is completed successfully. Alternatively, calling `Await.ready` waits until the future becomes @@ -1095,7 +1096,7 @@ that method will not throw an exception if the future is failed. The `Future` trait implements the `Awaitable` trait with methods `ready()` and `result()`. These methods cannot be called directly -by the clients-- they can only be called by the execution context. +by the clients -- they can only be called by the execution context. @@ -1105,8 +1106,8 @@ When asynchronous computations throw unhandled exceptions, futures associated with those computations fail. Failed futures store an instance of `Throwable` instead of the result value. `Future`s provide the `failed` projection method, which allows this `Throwable` to be -treated as the success value of another `Future`. The following special -exceptions are treated differently: +treated as the success value of another `Future`. +The following exceptions receive special treatment: 1. `scala.runtime.NonLocalReturnControl[_]` -- this exception holds a value associated with the return. Typically, `return` constructs in method @@ -1121,11 +1122,225 @@ behind this is to prevent propagation of critical and control-flow related exceptions normally not handled by the client code and at the same time inform the client in which future the computation failed. -Fatal exceptions (as determined by `NonFatal`) are rethrown in the thread executing +Fatal exceptions (as determined by `NonFatal`) are rethrown from the thread executing the failed asynchronous computation. This informs the code managing the executing threads of the problem and allows it to fail fast, if necessary. See [`NonFatal`](https://www.scala-lang.org/api/current/scala/util/control/NonFatal$.html) -for a more precise description of the semantics. +for a more precise description of which exceptions are considered fatal. + +`ExecutionContext.global` handles fatal exceptions by printing a stack trace, by default. + +A fatal exception means that the `Future` associated with the computation will never complete. +That is, "fatal" means that the error is not recoverable for the `ExecutionContext` +and is also not intended to be handled by user code. By contrast, application code may +attempt recovery from a "failed" `Future`, which has completed but with an exception. + +An execution context can be customized with a reporter that handles fatal exceptions. +See the factory methods [`fromExecutor`](https://www.scala-lang.org/api/current/scala/concurrent/ExecutionContext$.html#fromExecutor(e:java.util.concurrent.Executor,reporter:Throwable=%3EUnit):scala.concurrent.ExecutionContextExecutor) +and [`fromExecutorService`](https://www.scala-lang.org/api/current/scala/concurrent/ExecutionContext$.html#fromExecutorService(e:java.util.concurrent.ExecutorService,reporter:Throwable=%3EUnit):scala.concurrent.ExecutionContextExecutorService). + +Since it is necessary to set the [`UncaughtExceptionHandler`](https://docs.oracle.com/en/java/javase/20/docs/api/java.base/java/lang/Thread.UncaughtExceptionHandler.html) +for executing threads, as a convenience, when passed a `null` executor, +`fromExecutor` will create a context that is configured the same as `global`, +but with the supplied reporter for handling exceptions. + +The following example demonstrates how to obtain an `ExecutionContext` with custom error handling +and also shows the result of different exceptions, as described above: + +{% tabs exceptions class=tabs-scala-version %} +{% tab 'Scala 2' for=exceptions %} +~~~ scala +import java.util.concurrent.{ForkJoinPool, TimeoutException} +import scala.concurrent.{Await, ExecutionContext, Future} +import scala.concurrent.duration.DurationInt +import scala.util.{Failure, Success} + +object Test extends App { + def crashing(): Int = throw new NoSuchMethodError("test") + def failing(): Int = throw new NumberFormatException("test") + def interrupt(): Int = throw new InterruptedException("test") + def erroring(): Int = throw new AssertionError("test") + + // computations can fail in the middle of a chain of combinators, after the initial Future job has completed + def testCrashes()(implicit ec: ExecutionContext): Future[Int] = + Future.unit.map(_ => crashing()) + def testFails()(implicit ec: ExecutionContext): Future[Int] = + Future.unit.map(_ => failing()) + def testInterrupted()(implicit ec: ExecutionContext): Future[Int] = + Future.unit.map(_ => interrupt()) + def testError()(implicit ec: ExecutionContext): Future[Int] = + Future.unit.map(_ => erroring()) + + // Wait for 1 second for the the completion of the passed `future` value and print it + def check(future: Future[Int]): Unit = + try { + Await.ready(future, 1.second) + for (completion <- future.value) { + println(s"completed $completion") + // In case of failure, also print the cause of the exception, when defined + completion match { + case Failure(exception) if exception.getCause != null => + println(s" caused by ${exception.getCause}") + _ => () + } + } + } catch { + // If the future value did not complete within 1 second, the call + // to `Await.ready` throws a TimeoutException + case _: TimeoutException => println(s"did not complete") + } + + def reporter(t: Throwable) = println(s"reported $t") + + locally { + // using the `global` implicit context + import ExecutionContext.Implicits._ + // a successful Future + check(Future(42)) // completed Success(42) + // a Future that completes with an application exception + check(Future(failing())) // completed Failure(java.lang.NumberFormatException: test) + // same, but the exception is thrown somewhere in the chain of combinators + check(testFails()) // completed Failure(java.lang.NumberFormatException: test) + // a Future that does not complete because of a linkage error; + // the trace is printed to stderr by default + check(testCrashes()) // did not complete + // a Future that completes with an operational exception that is wrapped + check(testInterrupted()) // completed Failure(java.util.concurrent.ExecutionException: Boxed Exception) + // caused by java.lang.InterruptedException: test + // a Future that completes due to a failed assert, which is bad for the app, + // but is handled the same as interruption + check(testError()) // completed Failure(java.util.concurrent.ExecutionException: Boxed Exception) + // caused by java.lang.AssertionError: test + } + locally { + // same as `global`, but adds a custom reporter that will handle uncaught + // exceptions and errors reported to the context + implicit val ec: ExecutionContext = ExecutionContext.fromExecutor(null, reporter) + check(testCrashes()) // reported java.lang.NoSuchMethodError: test + // did not complete + } + locally { + // does not handle uncaught exceptions; the executor would have to be + // configured separately + val executor = ForkJoinPool.commonPool() + implicit val ec: ExecutionContext = ExecutionContext.fromExecutor(executor, reporter) + // the reporter is not invoked and the Future does not complete + check(testCrashes()) // did not complete + } + locally { + // sample minimal configuration for a context and underlying pool that + // use the reporter + val handler: Thread.UncaughtExceptionHandler = + (_: Thread, t: Throwable) => reporter(t) + val executor = new ForkJoinPool( + Runtime.getRuntime.availableProcessors, + ForkJoinPool.defaultForkJoinWorkerThreadFactory, // threads use the pool's handler + handler, + /*asyncMode=*/ false + ) + implicit val ec: ExecutionContext = ExecutionContext.fromExecutor(executor, reporter) + check(testCrashes()) // reported java.lang.NoSuchMethodError: test + // did not complete + } +} +~~~ +{% endtab %} + +{% tab 'Scala 3' for=exceptions %} +~~~ scala +import java.util.concurrent.{ForkJoinPool, TimeoutException} +import scala.concurrent.{Await, ExecutionContext, Future} +import scala.concurrent.duration.DurationInt +import scala.util.{Failure, Success} + +def crashing(): Int = throw new NoSuchMethodError("test") +def failing(): Int = throw new NumberFormatException("test") +def interrupt(): Int = throw new InterruptedException("test") +def erroring(): Int = throw new AssertionError("test") + +// computations can fail in the middle of a chain of combinators, +// after the initial Future job has completed +def testCrashes()(using ExecutionContext): Future[Int] = + Future.unit.map(_ => crashing()) +def testFails()(using ExecutionContext): Future[Int] = + Future.unit.map(_ => failing()) +def testInterrupted()(using ExecutionContext): Future[Int] = + Future.unit.map(_ => interrupt()) +def testError()(using ExecutionContext): Future[Int] = + Future.unit.map(_ => erroring()) + +// Wait for 1 second for the the completion of the passed `future` value and print it +def check(future: Future[Int]): Unit = + try + Await.ready(future, 1.second) + for completion <- future.value do + println(s"completed $completion") + // In case of failure, also print the cause of the exception, when defined + completion match + case Failure(exception) if exception.getCause != null => + println(s" caused by ${exception.getCause}") + case _ => () + catch + // If the future value did not complete within 1 second, the call + // to `Await.ready` throws a TimeoutException + case _: TimeoutException => println(s"did not complete") + +def reporter(t: Throwable) = println(s"reported $t") + +@main def test(): Unit = + locally: + // using the `global` implicit context + import ExecutionContext.Implicits.given + // a successful Future + check(Future(42)) // completed Success(42) + // a Future that completes with an application exception + check(Future(failing())) // completed Failure(java.lang.NumberFormatException: test) + // same, but the exception is thrown somewhere in the chain of combinators + check(testFails()) // completed Failure(java.lang.NumberFormatException: test) + // a Future that does not complete because of a linkage error; + // the trace is printed to stderr by default + check(testCrashes()) // did not complete + // a Future that completes with an operational exception that is wrapped + check(testInterrupted()) // completed Failure(java.util.concurrent.ExecutionException: Boxed Exception) + // caused by java.lang.InterruptedException: test + // a Future that completes due to a failed assert, which is bad for the app, + // but is handled the same as interruption + check(testError()) // completed Failure(java.util.concurrent.ExecutionException: Boxed Exception) + // caused by java.lang.AssertionError: test + + locally: + // same as `global`, but adds a custom reporter that will handle uncaught + // exceptions and errors reported to the context + given ExecutionContext = ExecutionContext.fromExecutor(null, reporter) + check(testCrashes()) // reported java.lang.NoSuchMethodError: test + // did not complete + + locally: + // does not handle uncaught exceptions; the executor would have to be + // configured separately + val executor = ForkJoinPool.commonPool() + given ExecutionContext = ExecutionContext.fromExecutor(executor, reporter) + // the reporter is not invoked and the Future does not complete + check(testCrashes()) // did not complete + + locally: + // sample minimal configuration for a context and underlying pool that + // use the reporter + val handler: Thread.UncaughtExceptionHandler = + (_: Thread, t: Throwable) => reporter(t) + val executor = new ForkJoinPool( + Runtime.getRuntime.availableProcessors, + ForkJoinPool.defaultForkJoinWorkerThreadFactory, // threads use the pool's handler + handler, + /*asyncMode=*/ false + ) + given ExecutionContext = ExecutionContext.fromExecutor(executor, reporter) + check(testCrashes()) // reported java.lang.NoSuchMethodError: test + // did not complete +end test +~~~ +{% endtab %} +{% endtabs %} ## Promises @@ -1226,7 +1441,7 @@ continues its computation, and finally completes the future `f` with a valid result, by completing promise `p`. Promises can also be completed with a `complete` method which takes -a potential value `Try[T]`-- either a failed result of type `Failure[Throwable]` or a +a potential value `Try[T]` -- either a failed result of type `Failure[Throwable]` or a successful result of type `Success[T]`. Analogous to `success`, calling `failure` and `complete` on a promise that has already From 441d8a991d19a3962b9944af2fea3b48b64dbec9 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Wed, 3 May 2023 11:03:41 +0300 Subject: [PATCH 2594/3075] Refresh _ru/tour/default-parameter-values.md (#2783) --- _ru/tour/default-parameter-values.md | 58 +++++++++++++++++++++++++++- 1 file changed, 57 insertions(+), 1 deletion(-) diff --git a/_ru/tour/default-parameter-values.md b/_ru/tour/default-parameter-values.md index ac8c04eda4..c45b5dd419 100644 --- a/_ru/tour/default-parameter-values.md +++ b/_ru/tour/default-parameter-values.md @@ -9,7 +9,10 @@ previous-page: classes prerequisite-knowledge: named-arguments, function syntax --- -Scala предоставляет возможность задавать значения параметров по умолчанию, что позволяет лишний раз не указывать параметры. +Scala предоставляет возможность задавать значения параметров по умолчанию, что позволяет лишний раз не указывать параметры. + +{% tabs default-parameter-values-1 %} +{% tab 'Scala 2 и 3' for=default-parameter-values-1 %} ```scala mdoc def log(message: String, level: String = "INFO") = println(s"$level: $message") @@ -18,22 +21,41 @@ log("System starting") // выведет "INFO: System starting" log("User not found", "WARNING") // выведет "WARNING: User not found" ``` +{% endtab %} +{% endtabs %} + У параметра `level` есть значение по умолчанию, поэтому он необязателен. В последней строке аргумент `"WARNING"` переназначает аргумент по умолчанию `"INFO"`. Вместо того чтоб использовать перегруженные методы в Java, вы можете просто указать дополнительные параметры как параметры по умолчанию для достижения того же эффекта. Однако, если при вызове пропущен хотя бы один аргумент, все остальные аргументы должны вызываться с указанием конкретного имени аргумента. +{% tabs default-parameter-values-2 %} +{% tab 'Scala 2 и 3' for=default-parameter-values-2 %} + ```scala mdoc class Point(val x: Double = 0, val y: Double = 0) val point1 = new Point(y = 1) ``` + +{% endtab %} +{% endtabs %} + Так мы можем указать что `y = 1`. Обратите внимание, что параметры по умолчанию в Scala, при вызове из Java кода, являются обязательными: +{% tabs default-parameter-values-3 %} +{% tab 'Scala 2 и 3' for=default-parameter-values-3 %} + ```scala mdoc:reset // Point.scala class Point(val x: Double = 0, val y: Double = 0) ``` +{% endtab %} +{% endtabs %} + +{% tabs default-parameter-values-4 %} +{% tab 'Java' for=default-parameter-values-4 %} + ```java // Main.java public class Main { @@ -42,3 +64,37 @@ public class Main { } } ``` + +{% endtab %} +{% endtabs %} + +### Параметры по умолчанию для перегруженных методов + +Scala не позволяет определять два метода с параметрами по умолчанию и с одинаковым именем (перегруженные методы). +Важная причина этого - избежание двусмысленности, которая может быть вызвана наличием параметров по умолчанию. +Чтобы проиллюстрировать проблему, давайте рассмотрим определение методов, представленных ниже: + +{% tabs default-parameter-values-5 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala mdoc:fail +object A { + def func(x: Int = 34): Unit + def func(y: String = "abc"): Unit +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +object A: + def func(x: Int = 34): Unit + def func(y: String = "abc"): Unit +``` + +{% endtab %} +{% endtabs %} + +Если мы вызываем `A.func()`, компилятор не может узнать, +намеревался ли программист вызвать `func(x: Int = 34)` или `func(y: String = "abc")`. From 6a074247f8880784fb8872689d40c7bcfb2acda4 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Wed, 3 May 2023 11:06:42 +0300 Subject: [PATCH 2595/3075] Refresh _ru/tour/classes.md (#2782) --- _ru/tour/classes.md | 218 ++++++++++++++++++++++++++++++++++++++++---- _tour/classes.md | 4 +- 2 files changed, 203 insertions(+), 19 deletions(-) diff --git a/_ru/tour/classes.md b/_ru/tour/classes.md index d7e66a84c0..75701bb107 100644 --- a/_ru/tour/classes.md +++ b/_ru/tour/classes.md @@ -13,13 +13,41 @@ prerequisite-knowledge: no-return-keyword, type-declaration-syntax, string-inter Классы в Scala являются основами для создания объектов. Они могут содержать методы, константы, переменные, типы, объекты, трейты и классы, которые в совокупности называются _членами_. Типы, объекты и трейты будут рассмотрены позже в ходе нашего обзора. ## Объявление класса + Минимальное объявление класса - это просто ключевое слово `class` и его имя. Имена классов должны быть написаны с заглавной буквы. + +{% tabs class-minimal-user class=tabs-scala-version %} + +{% tab 'Scala 2' for=class-minimal-user %} + ```scala mdoc class User val user1 = new User ``` -Ключевое слово `new` используется для создания экземпляра класса. `User` имеет конструктор по умолчанию, который не принимает аргументов, так как конструктор не был определен. Однако обычно используется и конструктор, и тело класса. Пример объявления класса Point приведен ниже: + +Ключевое слово `new` используется для создания экземпляра класса. +{% endtab %} + +{% tab 'Scala 3' for=class-minimal-user %} + +```scala +class User + +val user1 = User() +``` + +Чтобы создать экземпляр класса, мы вызываем его как функцию: `User()`. +Также можно явно использовать ключевое слово `new`: `new User()` - хотя обычно это опускается. +{% endtab %} + +{% endtabs %} + +`User` имеет конструктор по умолчанию, который не принимает аргументов, так как конструктор не был определен. Однако обычно используется и конструктор, и тело класса. Пример объявления класса Point приведен ниже: + +{% tabs class-point-example class=tabs-scala-version %} + +{% tab 'Scala 2' for=class-point-example %} ```scala mdoc class Point(var x: Int, var y: Int) { @@ -34,10 +62,34 @@ class Point(var x: Int, var y: Int) { } val point1 = new Point(2, 3) -point1.x // 2 -println(point1) // prints (2, 3) +println(point1.x) // выводит 2 +println(point1) // выводит (2, 3) +``` + +{% endtab %} + +{% tab 'Scala 3' for=class-point-example %} + +```scala +class Point(var x: Int, var y: Int): + + def move(dx: Int, dy: Int): Unit = + x = x + dx + y = y + dy + + override def toString: String = + s"($x, $y)" +end Point + +val point1 = Point(2, 3) +println(point1.x) // выводит 2 +println(point1) // выводит (2, 3) ``` +{% endtab %} + +{% endtabs %} + В этом классе у `Point` есть четыре члена: переменные `x` и `y` и методы `move` и `toString`. В отличие от многих других языков, основной конструктор находится в сигнатуре класса `(var x: Int, var y: Int)`. Метод `move` принимает два целочисленных аргумента и возвращает значение Unit `()` - это пустое множество, которое не содержит никакой информации. Примерно соответствует `void` в Java-подобных языках. С другой стороны, `toString` не принимает никаких аргументов, а возвращает значение `String`. Поскольку `toString` переопределяет `toString` из [`AnyRef`](unified-types.html), он помечается ключевым словом `override`. @@ -45,61 +97,193 @@ println(point1) // prints (2, 3) Конструкторы могут иметь необязательные параметры, если указать их значения по умолчанию как в примере: +{% tabs class-point-with-default-values class=tabs-scala-version %} + +{% tab 'Scala 2' for=class-point-with-default-values %} + ```scala mdoc:nest class Point(var x: Int = 0, var y: Int = 0) -val origin = new Point // x и y оба равны 0 -val point1 = new Point(1) -println(point1.x) // выводит 1 +val origin = new Point // x и y оба равны 0 +val point1 = new Point(1) // x равен 1, а y равен 0 +println(point1) // выводит (1, 0) +``` + +{% endtab %} + +{% tab 'Scala 3' for=class-point-with-default-values %} + +```scala +class Point(var x: Int = 0, var y: Int = 0) +val origin = Point() // x и y оба равны 0 +val point1 = Point(1) // x равен 1, а y равен 0 +println(point1) // выводит (1, 0) ``` +{% endtab %} + +{% endtabs %} + В этой версии класса `Point`, `x` и `y` имеют значение по умолчанию `0`, поэтому аргументов не требуется. Однако, поскольку конструктор считывает аргументы слева направо, если вы просто хотите передать значение `y`, то вам нужно будет указать задаваемый параметр. + +{% tabs class-point-named-argument class=tabs-scala-version %} + +{% tab 'Scala 2' for=class-point-named-argument %} + ```scala mdoc:nest class Point(var x: Int = 0, var y: Int = 0) -val point2 = new Point(y=2) -println(point2.y) // выводит 2 +val point2 = new Point(y = 2) +println(point2) // выводит (0, 2) ``` +{% endtab %} + +{% tab 'Scala 3' for=class-point-named-argument %} + +```scala +class Point(var x: Int = 0, var y: Int = 0) +val point2 = Point(y = 2) +println(point2) // выводит (0, 2) +``` + +{% endtab %} + +{% endtabs %} + Что также является хорошей практикой для повышения ясности кода. ## Скрытые члены и синтаксис Геттер/Сеттер (получатель/установщик значений) + По умолчанию члены класса являются открытыми для внешнего доступа (публичными). Используйте модификатор `private`, чтобы скрыть их от внешнего доступа. -```scala mdoc:nest + +{% tabs class-point-private-getter-setter class=tabs-scala-version %} + +{% tab 'Scala 2' for=class-point-private-getter-setter %} + +```scala mdoc:reset class Point { private var _x = 0 private var _y = 0 private val bound = 100 - def x = _x - def x_= (newValue: Int): Unit = { - if (newValue < bound) _x = newValue else printWarning + def x: Int = _x + def x_=(newValue: Int): Unit = { + if (newValue < bound) + _x = newValue + else + printWarning() } - def y = _y - def y_= (newValue: Int): Unit = { - if (newValue < bound) _y = newValue else printWarning + def y: Int = _y + def y_=(newValue: Int): Unit = { + if (newValue < bound) + _y = newValue + else + printWarning() } - private def printWarning = println("WARNING: Out of bounds") + private def printWarning(): Unit = + println("WARNING: Out of bounds") } val point1 = new Point point1.x = 99 point1.y = 101 // выводит предупреждение (printWarning) ``` -В данной версии класса `Point` данные хранятся в скрытых переменных `_x` и `_y`. Существуют методы `def x` и `def y` для доступа к скрытым данным. Методы `def x_=` и `def y_=` (сеттеры) предназначены для проверки и установки значения `_x` и `_y`. Обратите внимание на специальный синтаксис для сеттеров: метод `_=` применяется к имени геттера. + +{% endtab %} + +{% tab 'Scala 3' for=class-point-private-getter-setter %} + +```scala +class Point: + private var _x = 0 + private var _y = 0 + private val bound = 100 + + def x: Int = _x + def x_=(newValue: Int): Unit = + if newValue < bound then + _x = newValue + else + printWarning() + + def y: Int = _y + def y_=(newValue: Int): Unit = + if newValue < bound then + _y = newValue + else + printWarning() + + private def printWarning(): Unit = + println("WARNING: Out of bounds") +end Point + +val point1 = Point() +point1.x = 99 +point1.y = 101 // выводит предупреждение (printWarning) +``` + +{% endtab %} + +{% endtabs %} + +В данной версии класса `Point` данные хранятся в скрытых переменных `_x` и `_y`. Существуют методы `def x` и `def y` для доступа к скрытым данным. Методы `def x_=` и `def y_=` (сеттеры) предназначены для проверки и установки значения `_x` и `_y`. Обратите внимание на специальный синтаксис для сеттеров: метод `_=` применяется к имени геттера. Первичные параметры конструктора с параметрами `val` и `var` являются общедоступными. Однако, поскольку `val` - это константа, то нельзя писать следующее. + +{% tabs class-point-cannot-set-val class=tabs-scala-version %} + +{% tab 'Scala 2' for=class-point-cannot-set-val %} + ```scala mdoc:fail class Point(val x: Int, val y: Int) val point = new Point(1, 2) point.x = 3 // <-- не компилируется ``` +{% endtab %} + +{% tab 'Scala 3' for=class-point-cannot-set-val %} + +```scala +class Point(val x: Int, val y: Int) +val point = Point(1, 2) +point.x = 3 // <-- не компилируется +``` + +{% endtab %} + +{% endtabs %} + Параметры без `val` или `var` являются скрытыми от внешнего доступа и видимы только внутри класса. + +{% tabs class-point-non-val-ctor-param class=tabs-scala-version %} + +{% tab 'Scala 2' for=class-point-non-val-ctor-param %} + ```scala mdoc:fail class Point(x: Int, y: Int) val point = new Point(1, 2) point.x // <-- не компилируется ``` + +{% endtab %} + +{% tab 'Scala 3' for=class-point-non-val-ctor-param %} + +```scala +class Point(x: Int, y: Int) +val point = Point(1, 2) +point.x // <-- не компилируется +``` + +{% endtab %} + +{% endtabs %} + +## Дополнительные ресурсы + +- Узнайте больше о классах в [Scala Book](/ru/scala3/book/domain-modeling-tools.html#классы) +- Как использовать [вспомогательные конструкторы классов](/ru/scala3/book/domain-modeling-tools.html#вспомогательные-конструкторы) diff --git a/_tour/classes.md b/_tour/classes.md index be64ca7284..683ae049cf 100644 --- a/_tour/classes.md +++ b/_tour/classes.md @@ -262,5 +262,5 @@ point.x // <-- does not compile ## More resources -* Learn more about Classes in the [Scala Book](/overviews/scala-book/classes.html) -* How to use [Auxiliary Class Constructors](/overviews/scala-book/classes-aux-constructors.html) +* Learn more about Classes in the [Scala Book](/scala3/book/domain-modeling-tools.html#classes) +* How to use [Auxiliary Class Constructors](/scala3/book/domain-modeling-tools.html#auxiliary-constructors) From 9492c50fa08cade8ac0f0fd2456c40f64c3be6fb Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Fri, 5 May 2023 12:46:27 +0300 Subject: [PATCH 2596/3075] Refresh _ru\tour\traits.md (#2790) --- _ru/tour/traits.md | 104 ++++++++++++++++++++++++++++++++++++++++++++- _tour/traits.md | 4 +- 2 files changed, 104 insertions(+), 4 deletions(-) diff --git a/_ru/tour/traits.md b/_ru/tour/traits.md index ab7f6a5ade..97e2cec5bb 100644 --- a/_ru/tour/traits.md +++ b/_ru/tour/traits.md @@ -13,13 +13,25 @@ prerequisite-knowledge: expressions, classes, generics, objects, companion-objec Трейты (Traits) используются, чтобы обмениваться между классами информацией о структуре и полях. Они похожи на интерфейсы из Java 8. Классы и объекты могут расширять трейты, но трейты не могут быть созданы и поэтому не имеют параметров. ## Объявление трейта + Минимальное объявление трейта - это просто ключевое слово `trait` и его имя: +{% tabs trait-hair-color %} +{% tab 'Scala 2 и 3' for=trait-hair-color %} + ```scala mdoc trait HairColor ``` +{% endtab %} +{% endtabs %} + Трейты наиболее полезны в качестве обобщенного типа с абстрактными методами. + +{% tabs trait-iterator-definition class=tabs-scala-version %} + +{% tab 'Scala 2' for=trait-iterator-definition %} + ```scala mdoc trait Iterator[A] { def hasNext: Boolean @@ -27,10 +39,30 @@ trait Iterator[A] { } ``` +{% endtab %} + +{% tab 'Scala 3' for=trait-iterator-definition %} + +```scala +trait Iterator[A]: + def hasNext: Boolean + def next(): A +``` + +{% endtab %} + +{% endtabs %} + При наследовании от трейта `Iterator[A]` требует указание типа `A` а также реализация методов `hasNext` и `next`. ## Использование трейтов + Чтобы использовать трейты, необходимо наследовать класс от него, используя ключевое слово `extends`. Затем необходимо реализовать все абстрактные члены трейта, используя ключевое слово `override`: + +{% tabs trait-intiterator-definition class=tabs-scala-version %} + +{% tab 'Scala 2' for=trait-intiterator-definition %} + ```scala mdoc:nest trait Iterator[A] { def hasNext: Boolean @@ -40,7 +72,7 @@ trait Iterator[A] { class IntIterator(to: Int) extends Iterator[Int] { private var current = 0 override def hasNext: Boolean = current < to - override def next(): Int = { + override def next(): Int = { if (hasNext) { val t = current current += 1 @@ -49,15 +81,51 @@ class IntIterator(to: Int) extends Iterator[Int] { } } +val iterator = new IntIterator(10) +iterator.next() // вернет 0 +iterator.next() // вернет 1 +``` + +{% endtab %} + +{% tab 'Scala 3' for=trait-intiterator-definition %} + +```scala +trait Iterator[A]: + def hasNext: Boolean + def next(): A + +class IntIterator(to: Int) extends Iterator[Int]: + private var current = 0 + override def hasNext: Boolean = current < to + override def next(): Int = + if hasNext then + val t = current + current += 1 + t + else + 0 +end IntIterator val iterator = new IntIterator(10) iterator.next() // вернет 0 iterator.next() // вернет 1 ``` + +{% endtab %} + +{% endtabs %} + Этот класс `IntIterator` использует параметр `to` в качестве верхней границы. Он наследуется от `Iterator[Int]`, что означает, что метод `next` должен возвращать Int. ## Подтипы -Туда, где требуется определенный тип трейта, мы можем передавать любой наследованный от требуемого трейта класс + +Туда, где требуется определенный тип трейта, мы можем передавать любой наследованный от требуемого трейта класс + +{% tabs trait-pet-example class=tabs-scala-version %} + +{% tab 'Scala 2' for=trait-pet-example %} + ```scala mdoc import scala.collection.mutable.ArrayBuffer @@ -76,4 +144,36 @@ animals.append(dog) animals.append(cat) animals.foreach(pet => println(pet.name)) // выведет "Harry" и "Sally" ``` + +{% endtab %} + +{% tab 'Scala 3' for=trait-pet-example %} + +```scala +import scala.collection.mutable.ArrayBuffer + +trait Pet: + val name: String + +class Cat(val name: String) extends Pet +class Dog(val name: String) extends Pet + +val dog = Dog("Harry") +val cat = Cat("Sally") + +val animals = ArrayBuffer.empty[Pet] +animals.append(dog) +animals.append(cat) +animals.foreach(pet => println(pet.name)) // выведет "Harry" и "Sally" +``` + +{% endtab %} + +{% endtabs %} + У трейта `Pet` есть абстрактное поле `name`, которое реализовано в классах `Cat` and `Dog`. В последней строке мы вызываем `pet.name`, который должен быть реализован в любом подтипе, унаследованном от трейта `Pet`. + +## Дополнительные ресурсы + +- Узнайте больше о трейтах в [Scala Book](/scala3/book/domain-modeling-tools.html#traits) +- Использование трейтов для определения [Enum](/scala3/book/domain-modeling-fp.html#modeling-the-data) diff --git a/_tour/traits.md b/_tour/traits.md index cf12b763be..3ead3d3974 100644 --- a/_tour/traits.md +++ b/_tour/traits.md @@ -161,5 +161,5 @@ The `trait Pet` has an abstract field `name` that gets implemented by Cat and Do ## More resources -* Learn more about traits in the [Scala Book](/overviews/scala-book/traits-intro.html) -* Use traits to define [Enum](/overviews/scala-book/enumerations-pizza-class.html) +* Learn more about traits in the [Scala Book](/scala3/book/domain-modeling-tools.html#traits) +* Use traits to define [Enum](/scala3/book/domain-modeling-fp.html#modeling-the-data) From 3c120bd3d3d1410e2a7b9c879c1828c6190babb4 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Fri, 5 May 2023 12:51:44 +0300 Subject: [PATCH 2597/3075] Add types-inferred.md and types-generics.md in russian (#2789) --- _overviews/scala3-book/types-generics.md | 2 +- _overviews/scala3-book/types-inferred.md | 2 +- _ru/scala3/book/types-generics.md | 103 +++++++++++++++++++++++ _ru/scala3/book/types-inferred.md | 65 ++++++++++++++ _ru/scala3/book/types-introduction.md | 4 +- 5 files changed, 172 insertions(+), 4 deletions(-) create mode 100644 _ru/scala3/book/types-generics.md create mode 100644 _ru/scala3/book/types-inferred.md diff --git a/_overviews/scala3-book/types-generics.md b/_overviews/scala3-book/types-generics.md index 25ace5eca4..c44c29c9ac 100644 --- a/_overviews/scala3-book/types-generics.md +++ b/_overviews/scala3-book/types-generics.md @@ -2,7 +2,7 @@ title: Generics type: section description: This section introduces and demonstrates generics in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 49 previous-page: types-inferred next-page: types-intersection diff --git a/_overviews/scala3-book/types-inferred.md b/_overviews/scala3-book/types-inferred.md index 733a8d540c..828907d048 100644 --- a/_overviews/scala3-book/types-inferred.md +++ b/_overviews/scala3-book/types-inferred.md @@ -2,7 +2,7 @@ title: Inferred Types type: section description: This section introduces and demonstrates inferred types in Scala 3 -languages: [zh-cn] +languages: [ru, zh-cn] num: 48 previous-page: types-introduction next-page: types-generics diff --git a/_ru/scala3/book/types-generics.md b/_ru/scala3/book/types-generics.md new file mode 100644 index 0000000000..799a85e3d5 --- /dev/null +++ b/_ru/scala3/book/types-generics.md @@ -0,0 +1,103 @@ +--- +layout: multipage-overview +title: Параметризованные типы +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлены параметризованные типы в Scala 3. +language: ru +num: 49 +previous-page: types-inferred +next-page: +--- + +Универсальные (_generic_) классы (или trait-ы) принимают тип в качестве _параметра_ в квадратных скобках `[...]`. +Для обозначения параметров типа согласно конвенции Scala используется одна заглавная буква (например, `A`). +Затем этот тип можно использовать внутри класса по мере необходимости +для параметров экземпляра метода или для возвращаемых типов: + +{% tabs stack class=tabs-scala-version %} + +{% tab 'Scala 2' %} + +```scala +// здесь мы объявляем параметр типа A +// v +class Stack[A] { + private var elements: List[A] = Nil + // ^ + // здесь мы ссылаемся на этот тип + // v + def push(x: A): Unit = + elements = elements.prepended(x) + def peek: A = elements.head + def pop(): A = { + val currentTop = peek + elements = elements.tail + currentTop + } +} +``` + +{% endtab %} + +{% tab 'Scala 3' %} + +```scala +// здесь мы объявляем параметр типа A +// v +class Stack[A]: + private var elements: List[A] = Nil + // ^ + // здесь мы ссылаемся на этот тип + // v + def push(x: A): Unit = + elements = elements.prepended(x) + def peek: A = elements.head + def pop(): A = + val currentTop = peek + elements = elements.tail + currentTop +``` + +{% endtab %} +{% endtabs %} + +Эта реализация класса `Stack` принимает любой тип в качестве параметра. +Прелесть параметризованных типов состоит в том, +что теперь можно создавать `Stack[Int]`, `Stack[String]` и т.д., +что позволяет повторно использовать реализацию `Stack` для произвольных типов элементов. + +Пример создания и использования `Stack[Int]`: + +{% tabs stack-usage class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val stack = new Stack[Int] +stack.push(1) +stack.push(2) +println(stack.pop()) // выводит 2 +println(stack.pop()) // выводит 1 +``` + +{% endtab %} + +{% tab 'Scala 3' %} + +```scala +val stack = Stack[Int] +stack.push(1) +stack.push(2) +println(stack.pop()) // выводит 2 +println(stack.pop()) // выводит 1 +``` + +{% endtab %} +{% endtabs %} + +> Подробности о том, как выразить вариантность с помощью универсальных типов, +> см. в разделе ["Вариантность"][variance]. + +[variance]: {% link _overviews/scala3-book/types-variance.md %} diff --git a/_ru/scala3/book/types-inferred.md b/_ru/scala3/book/types-inferred.md new file mode 100644 index 0000000000..70c44fcc9d --- /dev/null +++ b/_ru/scala3/book/types-inferred.md @@ -0,0 +1,65 @@ +--- +layout: multipage-overview +title: Определение типов +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлены и демонстрируются выводимые типы в Scala 3. +language: ru +num: 48 +previous-page: types-introduction +next-page: types-generics +--- + +Как и в других статически типизированных языках программирования, +в Scala тип можно _объявить_ при создании новой переменной: + +{% tabs xy %} +{% tab 'Scala 2 и 3' %} + +```scala +val x: Int = 1 +val y: Double = 1 +``` + +{% endtab %} +{% endtabs %} + +В этих примерах типы _явно_ объявлены как `Int` и `Double` соответственно. +Однако в Scala обычно необязательно указывать тип при объявлении переменной: + +{% tabs abm %} +{% tab 'Scala 2 и 3' %} + +```scala +val a = 1 +val b = List(1, 2, 3) +val m = Map(1 -> "one", 2 -> "two") +``` + +{% endtab %} +{% endtabs %} + +Когда вы это сделаете, Scala сама _выведет_ типы, как показано в следующей сессии REPL: + +{% tabs abm2 %} +{% tab 'Scala 2 и 3' %} + +```scala +scala> val a = 1 +val a: Int = 1 + +scala> val b = List(1, 2, 3) +val b: List[Int] = List(1, 2, 3) + +scala> val m = Map(1 -> "one", 2 -> "two") +val m: Map[Int, String] = Map(1 -> one, 2 -> two) +``` + +{% endtab %} +{% endtabs %} + +Действительно, большинство переменных определяются без указания типа, +и способность Scala автоматически определять его — это одна из особенностей, +которая делает Scala _похожим_ на язык с динамической типизацией. diff --git a/_ru/scala3/book/types-introduction.md b/_ru/scala3/book/types-introduction.md index 656b821de4..49b3cbfb49 100644 --- a/_ru/scala3/book/types-introduction.md +++ b/_ru/scala3/book/types-introduction.md @@ -4,12 +4,12 @@ title: Типы и система типов scala3: true partof: scala3-book overview-name: "Scala 3 — Book" -type: section +type: chapter description: В этой главе представлено введение в типы и систему типов Scala 3. language: ru num: 47 previous-page: fp-summary -next-page: +next-page: types-inferred --- Scala — уникальный язык, поскольку он статически типизирован, но часто кажется гибким и динамичным. From 3d6e5b76e55767b1f8aa970146ab31c2418a2e18 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 6 May 2023 00:19:44 +0000 Subject: [PATCH 2598/3075] Update SIPs state --- ...ility-of-the-scala-213-standard-library.md | 7 - _sips/sips/drop-stdlib-forwards-bin-compat.md | 315 ++++++++++++++++++ 2 files changed, 315 insertions(+), 7 deletions(-) delete mode 100644 _sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md create mode 100644 _sips/sips/drop-stdlib-forwards-bin-compat.md diff --git a/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md b/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md deleted file mode 100644 index 893e9c177b..0000000000 --- a/_sips/sips/drop-forwards-binary-compatibility-of-the-scala-213-standard-library.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-51 - Drop Forwards Binary Compatibility of the Scala 2.13 Standard Library -status: under-review -pull-request-number: 54 -stage: implementation - ---- diff --git a/_sips/sips/drop-stdlib-forwards-bin-compat.md b/_sips/sips/drop-stdlib-forwards-bin-compat.md new file mode 100644 index 0000000000..fc17c0df58 --- /dev/null +++ b/_sips/sips/drop-stdlib-forwards-bin-compat.md @@ -0,0 +1,315 @@ +--- +layout: sip +permalink: /sips/:title.html +stage: implementation +status: under-review +title: SIP-51 - Drop Forwards Binary Compatibility of the Scala 2.13 Standard Library +--- + +**By: Lukas Rytz** + + +## History + +| Date | Version | +|----------------|--------------------| +| Dec 8, 2022 | Initial Version | + + +## Summary + +I propose to drop the forwards binary compatibility requirement that build tools enforce on the Scala 2.13 standard library. +This will allow implementing performance optimizations of collection operations that are currently not possible. +It also unblocks adding new classes and new members to existing classes in the standard library. + + +## Backwards and Forwards Compatibility + +A library is backwards binary compatible if code compiled against an old version works with a newer version on the classpath. +Forwards binary compatibility requires the opposite: code compiled against a new version of a library needs to work with an older version on the classpath. +A more in-depth explanation of binary compatibility is available on the [Scala documentation site](https://docs.scala-lang.org/overviews/core/binary-compatibility-of-scala-releases.html). + +Scala build tools like sbt automatically update dependencies on the classpath to the latest patch version that any other dependency on the classpath requires. +For example, with the following definition + +~~~ scala +libraryDependencies ++= List( + "com.softwaremill.sttp.client3" %% "core" % "3.8.3", // depends on ws 1.3.10 + "com.softwaremill.sttp.shared" %% "ws" % "1.2.7", // for demonstration +) +~~~ + +sbt updates the `ws` library to version 1.3.10. +Running the `evicted` command in sbt displays all dependencies whose version were changed. + +This build tool feature allows library authors to only maintain backwards binary compatibility in new versions, they don't need to maintain forwards binary compatibility. +Backwards binary compatible changes include the addition of new methods in existing classes and the addition of new classes. +Such additions don't impact existing code that was compiled against an older version, all definitions that were previously present are still there. + +### The Standard Library + +The Scala standard library is treated specially by sbt and other build tools, its version is always pinned to the `scalaVersion` of the build definition and never updated automatically. + +For example, the `"com.softwaremill.sttp.client3" %% "core" % "3.8.3"` library has a dependency on `"org.scala-lang" % "scala-library" % "2.13.10"` in its POM file. +When a project uses this version of the sttp client in a project with `scalaVersion` 2.13.8, sbt will put the Scala library version 2.13.8 on the classpath. + +This means that the standard library is required to remain both backwards and forwards binary compatible. +The implementation of sttp client 3.8.3 can use any feature available in Scala 2.13.10, and that compiled code needs to work correctly with the Scala 2.13.8 standard library. + +The suggested change of this SIP is to drop this special handling of the Scala standard library and therefore lift the forwards binary compatibility requirement. + + +## Motivation + +### Adding Overrides for Performance + +The forwards binary compatibility constraint regularly prevents adding optimized overrides to collection classes. +The reason is that the bytecode signature of an overriding method is not necessarily identical to the signature of the overridden method. +Example: + +~~~ scala +class A { def f: Object = "" } +class B extends A { override def f: String = "" } +~~~ + +The bytecode signature of `B.f` has return type `String`. +(In order to implement dynamic dispatch at run time (overriding), the compiler generates a "bridge" method `B.f` with return type `Object` which forwards to the other `B.f` method.) +Adding such an override is not forwards binary compatible, because code compiled against `B` can link to the `B.f` method with return type `String`, which would not exist in the previous version. + +It's common that forwards binary compatibility prevents adding optimizing overrides, most recently in [LinkedHashMap](https://github.com/scala/scala/pull/10235#issuecomment-1336781619). + +Sometimes, if an optimization is considered important, a type test is added to the existing implementation to achieve the same effect. +These workarounds could be cleaned up. +Examples are [`mutable.Map.mapValuesInPlace`](https://github.com/scala/scala/blob/v2.13.10/src/library/scala/collection/mutable/Map.scala#L201-L204), [`IterableOnce.foldLeft`](https://github.com/scala/scala/blob/v2.13.10/src/library/scala/collection/IterableOnce.scala#L669-L670), [`Set.concat`](https://github.com/scala/scala/blob/v2.13.10/src/library/scala/collection/Set.scala#L226-L227), and many more. + +### Adding Functionality + +Dropping forwards binary compatiblity allows adding new methods to existing classes, as well as adding new classes. +While this opens a big door in principle, I am certain that stability, consistency and caution will remain core considerations when discussing additions to the standard library. +However, I believe that allowing to (carefully) evolve the standard library is greatly beneficial for the Scala community. + +Examples that came up in the past + - various proposals for new operations are here: https://github.com/scala/scala-library-next/issues and https://github.com/scala/scala-library-next/pulls + - addition of `ExecutionContext.opportunistic` in 2.13.4, which could not be made public: https://github.com/scala/scala/pull/9270 + - adding `ByteString`: https://contributors.scala-lang.org/t/adding-akkas-bytestring-as-a-scala-module-and-or-stdlib/5967 + - new string interpolators: https://github.com/scala/scala/pull/8654 + +## Alternatives and Related Work + +For binary compatible overrides, it was considered to add an annotation that would enforce the existing signature in bytecode. +However, this approach turned out to be too complex in the context of further overrides and Java compatibility. +Details are in the [corresponding pull request](https://github.com/scala/scala/pull/9141). + +Extensions to the standard library can be implemented in a separate library, and such a library exists since 2020 as [scala-library-next](https://github.com/scala/scala-library-next). +This library has seen very little adoption so far, and I personally don't think this is likely going (or possible) to change. +One serious drawback of an external library is that operations on existing classes can only be added as extension methods, which makes them less discoverable and requires adding an import. +This drawback could potentially be mitigated with improvements in Scala IDEs. + +An alternative to `scala-library-next` would be to use the Scala 3 library (`"org.scala-lang" % "scala3-library_3"`) which is published with Scala 3 releases. +This library is handled by build tools like any other library and therefore open for backwards binary compatible additions. +Until now, the Scala 3 library is exclusively used as a "runtime" library for Scala 3, i.e., it contanis definitions that are required for running code compiled with Scala 3. +Additions to the Scala 3 library would not be available to the still very large userbase of Scala 2.13. +Like for `scala-library-next`, additions to existing classes can again only be done in the form of extension methods. +Also, I believe that there is great value in keeping the Scala 2.13 and 3 standard libraries aligned for now. + + +## Implications + +### Possible Linkage Errors + +The policy change can only be implemented in new build tool releases, which makes it possible that projects run into linkage errors at run time. +Concretely, a project might update one of its dependencies to a new version which requires a more recent Scala library than the one defined in the project's `scalaVersion`. +If the project continues using an old version of sbt, the build tool will keep the Scala library pinned. +The new library might reference definitions that don't exist in the older Scala library, leading to linkage errors. + +### Scala.js and Scala Native + +Scala.js distributes a JavaScript version of the Scala library. +This artifact is currently released once per Scala.js version. +When a new Scala version comes out, a new Scala.js compiler is released, but the Scala library artifact continues to be used until the next Scala.js version. +This scheme does not work if the new Scala version has new definitions, so it needs to be adjusted. +Finding a solution for this problem is necessary and part of the implementation phase. + +A similar situation might exist for Scala Native. + +### Compiler and Library Version Mismatch + +Defining the `scalaVersion` in a project would no longer pin the standard library to that exact version. +The Scala compiler on the other hand would be kept at the specified version. +This means that Scala compilers will need to be able to run with a newer version of the Scala library, e.g., the Scala compiler 2.13.10 needs to be able to run with a 2.13.11 standard library on the compilation classpath. +I think this will not cause any issues. + +Note that there are two classpaths at play here: the runtime classpath of the JVM that is running the Scala compiler, and the compilation classpath in which the compiler looks up symbols that are referenced in the source code being compiled. +The Scala library on the JVM classpath could remain in sync with the compiler version. +The Scala library on the compilation classpath would be updated by the build tool according to the dependency graph. + +### Newer than Expected Library + +Because the build tool can update the Scala library version, a project might accidentally use / link to new API that does not yet exist in the `scalaVersion` that is defined in the build definition. +This is safe, as the project's POM file will have a dependency on the newer version of the Scala library. +The same situation can appear with any other dependency of a project. + +### Applications with Plugin Systems + +In applications where plugins are dynamically loaded, plugins compiled with a new Scala library could fail to work correctly if the application is running with an older Scala library. + +This is however not a new issue, the proposed change would just extend the existing problem to the Scala library. + +## Limitations + +Adding new methods or fields to existing traits remains a binary incompatible change. +This is unrelated to the Standard library, the same is true for other libraries. +[MiMa](https://github.com/lightbend/mima) is a tool for ensuring changes are binary compatible. + + +## Build Tools + +### Mill + +In my testing, Mill has the same behavior as sbt, the Scala library version is pinned to the project's `scalaVersion`. + +<details> + +~~~ +$> cat build.sc +import mill._, scalalib._ +object proj extends ScalaModule { + def scalaVersion = "2.13.8" + def ivyDeps = Agg( + ivy"com.softwaremill.sttp.client3::core:3.8.3", + ivy"com.softwaremill.sttp.shared::ws:1.2.7", + ) +} +$> mill show proj.runClasspath +[1/1] show > [37/37] proj.runClasspath +[ + "qref:868554b6:/Users/luc/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/com/softwaremill/sttp/client3/core_2.13/3.8.3/core_2.13-3.8.3.jar", + "qref:f3ba6af6:/Users/luc/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/com/softwaremill/sttp/shared/ws_2.13/1.3.10/ws_2.13-1.3.10.jar", + "qref:438104da:/Users/luc/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.8/scala-library-2.13.8.jar", + "qref:0c9ef1ab:/Users/luc/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/com/softwaremill/sttp/model/core_2.13/1.5.2/core_2.13-1.5.2.jar", + "qref:9b3d3f7d:/Users/luc/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/com/softwaremill/sttp/shared/core_2.13/1.3.10/core_2.13-1.3.10.jar" +] +~~~ + +</details> + +### Gradle + +Gradle handles the Scala library the same as other dependencies, so it already implements the behavior proposed by this SIP. + +<details> + +~~~ +$> cat build.gradle +plugins { + id 'scala' +} +repositories { + mavenCentral() +} +dependencies { + implementation 'org.scala-lang:scala-library:2.13.8' + implementation 'com.softwaremill.sttp.client3:core_2.13:3.8.3' + implementation 'com.softwaremill.sttp.shared:ws_2.13:1.2.7' +} +$> gradle dependencies --configuration runtimeClasspath + +> Task :dependencies + +------------------------------------------------------------ +Root project 'proj' +------------------------------------------------------------ + +runtimeClasspath - Runtime classpath of source set 'main'. ++--- org.scala-lang:scala-library:2.13.8 -> 2.13.10 ++--- com.softwaremill.sttp.client3:core_2.13:3.8.3 +| +--- org.scala-lang:scala-library:2.13.10 +| +--- com.softwaremill.sttp.model:core_2.13:1.5.2 +| | \--- org.scala-lang:scala-library:2.13.8 -> 2.13.10 +| +--- com.softwaremill.sttp.shared:core_2.13:1.3.10 +| | \--- org.scala-lang:scala-library:2.13.9 -> 2.13.10 +| \--- com.softwaremill.sttp.shared:ws_2.13:1.3.10 +| +--- org.scala-lang:scala-library:2.13.9 -> 2.13.10 +| +--- com.softwaremill.sttp.shared:core_2.13:1.3.10 (*) +| \--- com.softwaremill.sttp.model:core_2.13:1.5.2 (*) +\--- com.softwaremill.sttp.shared:ws_2.13:1.2.7 -> 1.3.10 (*) + +(*) - dependencies omitted (listed previously) +~~~ + +</details> + +### Maven + +Maven [does not update](https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html) versions of dependencies that are explicitly listed in the `pom.xml` file, so it's possible to run into linkage errors at run time already now. +The maven versions plugin can display and update dependencies to newer versions. + +<details> + +~~~ +$> cat pom.xml +<?xml version="1.0" encoding="UTF-8"?> +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + <modelVersion>4.0.0</modelVersion> + <groupId>a.b</groupId> + <artifactId>proj</artifactId> + <version>1.0.0-SNAPSHOT</version> + <properties> + <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> + <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> + <java.version>1.8</java.version> + <scala.version>2.13.8</scala.version> + </properties> + <dependencies> + <dependency> + <groupId>org.scala-lang</groupId> + <artifactId>scala-library</artifactId> + <version>${scala.version}</version> + </dependency> + <dependency> + <groupId>com.softwaremill.sttp.client3</groupId> + <artifactId>core_2.13</artifactId> + <version>3.8.3</version> + </dependency> + <dependency> + <groupId>com.softwaremill.sttp.shared</groupId> + <artifactId>ws_2.13</artifactId> + <version>1.2.7</version> + </dependency> + </dependencies> + <build> + <plugins> + <plugin> + <groupId>net.alchim31.maven</groupId> + <artifactId>scala-maven-plugin</artifactId> + <version>4.8.0</version> + </plugin> + </plugins> + </build> +</project> +$> mvn dependency:build-classpath +[INFO] --- maven-dependency-plugin:2.8:build-classpath (default-cli) @ proj --- +[INFO] Dependencies classpath: +/Users/luc/.m2/repository/org/scala-lang/scala-library/2.13.8/scala-library-2.13.8.jar:/Users/luc/.m2/repository/com/softwaremill/sttp/client3/core_2.13/3.8.3/core_2.13-3.8.3.jar:/Users/luc/.m2/repository/com/softwaremill/sttp/model/core_2.13/1.5.2/core_2.13-1.5.2.jar:/Users/luc/.m2/repository/com/softwaremill/sttp/shared/core_2.13/1.3.10/core_2.13-1.3.10.jar:/Users/luc/.m2/repository/com/softwaremill/sttp/shared/ws_2.13/1.2.7/ws_2.13-1.2.7.jar +$> mvn versions:display-dependency-updates +[INFO] --- versions-maven-plugin:2.13.0:display-dependency-updates (default-cli) @ proj --- +[INFO] The following dependencies in Dependencies have newer versions: +[INFO] com.softwaremill.sttp.client3:core_2.13 ............... 3.8.3 -> 3.8.5 +[INFO] com.softwaremill.sttp.shared:ws_2.13 ................. 1.2.7 -> 1.3.12 +[INFO] org.scala-lang:scala-library ....................... 2.13.8 -> 2.13.10 +~~~ + +</details> + +### Bazel + +I have never used bazel and did not manage set up / find a sample build definition to test its behavior. +Help from someone knowing bazel would be appreciated. + +### Pants + +As with bazel, I did not yet manage to set up / find an example project. + +### Other Tools + +The SIP might also require changes in other tools such as scala-cli, coursier or bloop. From 8d227befeb56a7461848292e56a7e87e3ab1dd29 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Mon, 8 May 2023 13:59:07 +0200 Subject: [PATCH 2599/3075] Add code tabs to Contextual Abstractions (#2787) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add missing redirection from https://docs.scala-lang.org/scala3/book/types-type-classes.html to https://docs.scala-lang.org/scala3/book/ca-type-classes.html * Follow the standard way of labelling a page to be Scala 3 only * Mark “Extension Methods” as Scala 3 specific, and add cross-references with “Implicit Classes”. * Add Scala 2 tabs and explanations in the Implicit Conversions page Remove the detailed explanation from the Tour page in favor of the Book. * Add code tabs to page 'Context Parameters' * Add tabs to Type Classes page * Update intro * Address feedback from review --- _overviews/core/implicit-classes.md | 6 + _overviews/scala3-book/ca-context-bounds.md | 4 +- .../scala3-book/ca-context-parameters.md | 157 +++++++++++++ .../ca-contextual-abstractions-intro.md | 27 ++- .../scala3-book/ca-extension-methods.md | 7 +- _overviews/scala3-book/ca-given-imports.md | 20 +- .../scala3-book/ca-given-using-clauses.md | 110 --------- .../scala3-book/ca-implicit-conversions.md | 220 ++++++++++++++++-- _overviews/scala3-book/ca-summary.md | 17 +- _overviews/scala3-book/ca-type-classes.md | 111 +++++++-- .../scala3-book/methods-main-methods.md | 2 +- _overviews/scala3-book/scala-features.md | 4 +- _overviews/scala3-book/scala-for-java-devs.md | 2 +- .../scala3-book/scala-for-javascript-devs.md | 2 +- _overviews/scala3-book/why-scala-3.md | 2 +- _ru/scala3/book/methods-main-methods.md | 2 +- _ru/scala3/book/scala-features.md | 4 +- _ru/scala3/book/why-scala-3.md | 2 +- _tour/implicit-conversions.md | 91 +------- .../scala3-book/ca-context-bounds.md | 2 +- ...ng-clauses.md => ca-context-parameters.md} | 0 .../ca-contextual-abstractions-intro.md | 4 +- .../scala3-book/ca-extension-methods.md | 2 +- .../scala3-book/methods-main-methods.md | 2 +- .../overviews/scala3-book/scala-features.md | 4 +- .../scala3-book/scala-for-java-devs.md | 2 +- .../scala3-book/scala-for-javascript-devs.md | 2 +- _zh-cn/overviews/scala3-book/why-scala-3.md | 2 +- 28 files changed, 504 insertions(+), 306 deletions(-) create mode 100644 _overviews/scala3-book/ca-context-parameters.md delete mode 100644 _overviews/scala3-book/ca-given-using-clauses.md rename _zh-cn/overviews/scala3-book/{ca-given-using-clauses.md => ca-context-parameters.md} (100%) diff --git a/_overviews/core/implicit-classes.md b/_overviews/core/implicit-classes.md index d809dc6217..eca05c593d 100644 --- a/_overviews/core/implicit-classes.md +++ b/_overviews/core/implicit-classes.md @@ -7,6 +7,12 @@ partof: implicit-classes languages: [zh-cn] permalink: /overviews/core/:title.html +versionSpecific: true +scala2: true +--- + +In Scala 3, implicit classes are still supported for compatibility reasons but the recommended way to achieve the same result is to use [extension methods]({% link _overviews/scala3-book/ca-extension-methods.md %}). + --- **Josh Suereth** diff --git a/_overviews/scala3-book/ca-context-bounds.md b/_overviews/scala3-book/ca-context-bounds.md index 2a692ed257..fee7cbd146 100644 --- a/_overviews/scala3-book/ca-context-bounds.md +++ b/_overviews/scala3-book/ca-context-bounds.md @@ -4,11 +4,11 @@ type: section description: This page demonstrates Context Bounds in Scala. languages: [zh-cn] num: 61 -previous-page: ca-given-using-clauses +previous-page: ca-context-parameters next-page: ca-given-imports --- -In many situations the name of a [context parameter]({% link _overviews/scala3-book/ca-given-using-clauses.md %}#using-clauses) does not have to be mentioned explicitly, since it is only used by the compiler in synthesized arguments for other context parameters. +In many situations the name of a [context parameter]({% link _overviews/scala3-book/ca-context-parameters.md %}#context-parameters) does not have to be mentioned explicitly, since it is only used by the compiler in synthesized arguments for other context parameters. In that case you don’t have to define a parameter name, and can just provide the parameter type. diff --git a/_overviews/scala3-book/ca-context-parameters.md b/_overviews/scala3-book/ca-context-parameters.md new file mode 100644 index 0000000000..81ca5f7023 --- /dev/null +++ b/_overviews/scala3-book/ca-context-parameters.md @@ -0,0 +1,157 @@ +--- +title: Context Parameters +type: section +description: This page demonstrates how to declare context parameters, and how the compiler infers them at call-site. +languages: [zh-cn] +num: 60 +previous-page: ca-extension-methods +next-page: ca-context-bounds +redirect_from: /scala3/book/ca-given-using-clauses.html +--- + +Scala offers two important features for contextual abstraction: + +- **Context Parameters** allow you to specify parameters that, at the call-site, can be omitted by the programmer and should be automatically provided by the context. +- **Given Instances** (in Scala 3) or **Implicit Definitions** (in Scala 2) are terms that can be used by the Scala compiler to fill in the missing arguments. + +## Context Parameters + +When designing a system, often context information like _configuration_ or settings need to be provided to the different components of your system. +One common way to achieve this is by passing the configuration as additional argument to your methods. + +In the following example, we define a case class `Config` to model some website configuration and pass it around in the different methods. + +{% tabs example %} +{% tab 'Scala 2 and 3' %} +```scala +case class Config(port: Int, baseUrl: String) + +def renderWebsite(path: String, config: Config): String = + "<html>" + renderWidget(List("cart"), config) + "</html>" + +def renderWidget(items: List[String], config: Config): String = ??? + +val config = Config(8080, "docs.scala-lang.org") +renderWebsite("/home", config) +``` +{% endtab %} +{% endtabs %} + +Let us assume that the configuration does not change throughout most of our code base. +Passing `config` to each and every method call (like `renderWidget`) becomes very tedious and makes our program more difficult to read, since we need to ignore the `config` argument. + +### Marking parameters as contextual + +We can mark some parameters of our methods as _contextual_. + +{% tabs 'contextual-parameters' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def renderWebsite(path: String)(implicit config: Config): String = + "<html>" + renderWidget(List("cart")) + "</html>" + // ^ + // no argument config required anymore + +def renderWidget(items: List[String])(implicit config: Config): String = ??? +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +def renderWebsite(path: String)(using config: Config): String = + "<html>" + renderWidget(List("cart")) + "</html>" + // ^ + // no argument config required anymore + +def renderWidget(items: List[String])(using config: Config): String = ??? +``` +{% endtab %} +{% endtabs %} + +By starting a parameter section with the keyword `using` in Scala 3 or `implicit` in Scala 2, we tell the compiler that at the call-site it should automatically find an argument with the correct type. +The Scala compiler thus performs **term inference**. + +In our call to `renderWidget(List("cart"))` the Scala compiler will see that there is a term of type `Config` in scope (the `config`) and automatically provide it to `renderWidget`. +So the program is equivalent to the one above. + +In fact, since we do not need to refer to `config` in our implementation of `renderWebsite` anymore, we can even omit its name in the signature in Scala 3: + +{% tabs 'anonymous' %} +{% tab 'Scala 3 Only' %} +```scala +// no need to come up with a parameter name +// vvvvvvvvvvvvv +def renderWebsite(path: String)(using Config): String = + "<html>" + renderWidget(List("cart")) + "</html>" +``` +{% endtab %} +{% endtabs %} + +In Scala 2, the name of implicit parameters is still mandatory. + +### Explicitly providing contextual arguments + +We have seen how to _abstract_ over contextual parameters and that the Scala compiler can provide arguments automatically for us. +But how can we specify which configuration to use for our call to `renderWebsite`? + +{% tabs 'explicit' class=tabs-scala-version %} +{% tab 'Scala 2' %} +We explicitly supply the argument value as if it was a regular argument: +```scala +renderWebsite("/home")(config) +``` +{% endtab %} +{% tab 'Scala 3' %} +Like we specified our parameter section with `using`, we can also explicitly provide contextual arguments with `using`: +```scala +renderWebsite("/home")(using config) +``` +{% endtab %} +{% endtabs %} + +Explicitly providing contextual parameters can be useful if we have multiple different values in scope that would make sense, and we want to make sure that the correct one is passed to the function. + +For all other cases, as we will see in the next section, there is also another way to bring contextual values into scope. + +## Given Instances (Implicit Definitions in Scala 2) + +We have seen that we can explicitly pass arguments as contextual parameters. +However, if there is _a single canonical value_ for a particular type, there is another preferred way to make it available to the Scala compiler: by marking it as `given` in Scala 3 or `implicit` in Scala 2. + +{% tabs 'instances' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +implicit val config: Config = Config(8080, "docs.scala-lang.org") +// ^^^^^^ +// this is the value the Scala compiler will infer +// as argument to contextual parameters of type Config +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +val config = Config(8080, "docs.scala-lang.org") + +// this is the type that we want to provide the +// canonical value for +// vvvvvv +given Config = config +// ^^^^^^ +// this is the value the Scala compiler will infer +// as argument to contextual parameters of type Config +``` +{% endtab %} +{% endtabs %} + +In the above example we specify that whenever a contextual parameter of type `Config` is omitted in the current scope, the compiler should infer `config` as an argument. + +Having defined a canonical value for the type `Config`, we can call `renderWebsite` as follows: + +```scala +renderWebsite("/home") +// ^ +// again no argument +``` + +A detailed guide to where Scala looks for canonical values can be found in [the FAQ]({% link _overviews/FAQ/index.md %}#where-does-scala-look-for-implicits). + +[reference]: {{ site.scala3ref }}/overview.html +[blog-post]: /2020/11/06/explicit-term-inference-in-scala-3.html diff --git a/_overviews/scala3-book/ca-contextual-abstractions-intro.md b/_overviews/scala3-book/ca-contextual-abstractions-intro.md index 4174bcf5ee..5b703e5e6f 100644 --- a/_overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -11,8 +11,7 @@ next-page: ca-extension-methods ## Background -Implicits in Scala 2 were a major distinguishing design feature. -They are *the* fundamental way to abstract over context. +Contextual abstractions are a way to abstract over context. They represent a unified paradigm with a great variety of use cases, among them: - Implementing type classes @@ -21,24 +20,24 @@ They represent a unified paradigm with a great variety of use cases, among them: - Expressing capabilities - Computing new types, and proving relationships between them -Since then, other languages have followed suit, e.g., Rust’s traits or Swift’s protocol extensions. +Other languages have been influenced by Scala in this regard. E.g., Rust’s traits or Swift’s protocol extensions. Design proposals are also on the table for Kotlin as compile time dependency resolution, for C# as Shapes and Extensions or for F# as Traits. -Implicits are also a common feature of theorem provers such as Coq or Agda. +Contextual abstractions are also a common feature of theorem provers such as Coq or Agda. -Even though these designs use different terminology, they’re all variants of the core idea of *term inference*: -Given a type, the compiler synthesizes a “canonical” term that has that type. +Even though these designs use different terminology, they’re all variants of the core idea of **term inference**: given a type, the compiler synthesizes a “canonical” term that has that type. +## Scala 3 Redesign -## Redesign +In Scala 2, contextual abstractions are supported by marking definitions (methods and values) or parameters as `implicit` (see [Context Parameters]({% link _overviews/scala3-book/ca-context-parameters.md %})). -Scala 3 includes a redesign of contextual abstractions in Scala. +Scala 3 includes a redesign of contextual abstractions. While these concepts were gradually “discovered” in Scala 2, they’re now well known and understood, and the redesign takes advantage of that knowledge. The design of Scala 3 focuses on **intent** rather than **mechanism**. Instead of offering one very powerful feature of implicits, Scala 3 offers several use-case oriented features: - **Retroactively extending classes**. - In Scala 2, extension methods had to be encoded using implicit conversions or implicit classes. + In Scala 2, extension methods are encoded by using [implicit conversions][implicit-conversions] or [implicit classes]({% link _overviews/core/implicit-classes.md %}). In contrast, in Scala 3 [extension methods][extension-methods] are now directly built into the language, leading to better error messages and improved type inference. - **Abstracting over contextual information**. @@ -46,11 +45,11 @@ Instead of offering one very powerful feature of implicits, Scala 3 offers sever As an improvement over Scala 2 implicits, using clauses can be specified by type, freeing function signatures from term variable names that are never explicitly referred to. - **Providing Type-class instances**. - [Given instances][type-classes] allow programmers to define the _canonical value_ of a certain type. - This makes programming with type-classes more straightforward without leaking implementation details. + [Given instances][givens] allow programmers to define the _canonical value_ of a certain type. + This makes programming with [type-classes][type-classes] more straightforward without leaking implementation details. - **Viewing one type as another**. - Implicit conversion have been [redesigned][implicit-conversions] from the ground up as instances of a type-class `Conversion`. + Implicit conversions have been [redesigned][implicit-conversions] from the ground up as instances of a type-class `Conversion`. - **Higher-order contextual abstractions**. The _all-new_ feature of [context functions][contextual-functions] makes contextual abstractions a first-class citizen. @@ -78,11 +77,11 @@ Benefits of these changes include: This chapter introduces many of these new features in the following sections. -[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _overviews/scala3-book/ca-context-parameters.md %} [given-imports]: {% link _overviews/scala3-book/ca-given-imports.md %} [implicit-conversions]: {% link _overviews/scala3-book/ca-implicit-conversions.md %} [extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} [context-bounds]: {% link _overviews/scala3-book/ca-context-bounds.md %} [type-classes]: {% link _overviews/scala3-book/ca-type-classes.md %} [equality]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} -[contextual-functions]: {% link _overviews/scala3-book/types-dependent-function.md %} +[contextual-functions]: {{ site.scala3ref }}/contextual/context-functions.html diff --git a/_overviews/scala3-book/ca-extension-methods.md b/_overviews/scala3-book/ca-extension-methods.md index 354bf8939e..6c3bcb735c 100644 --- a/_overviews/scala3-book/ca-extension-methods.md +++ b/_overviews/scala3-book/ca-extension-methods.md @@ -5,9 +5,14 @@ description: This page demonstrates how Extension Methods work in Scala 3. languages: [zh-cn] num: 59 previous-page: ca-contextual-abstractions-intro -next-page: ca-given-using-clauses +next-page: ca-context-parameters +scala3: true +versionSpecific: true --- +In Scala 2, a similar result could be achieved with [implicit classes]({% link _overviews/core/implicit-classes.md %}). + +--- Extension methods let you add methods to a type after the type is defined, i.e., they let you add new methods to closed classes. For example, imagine that someone else has created a `Circle` class: diff --git a/_overviews/scala3-book/ca-given-imports.md b/_overviews/scala3-book/ca-given-imports.md index b60e21f75d..37a5a9e626 100644 --- a/_overviews/scala3-book/ca-given-imports.md +++ b/_overviews/scala3-book/ca-given-imports.md @@ -6,17 +6,14 @@ languages: [zh-cn] num: 62 previous-page: ca-context-bounds next-page: ca-type-classes +scala3: true +versionSpecific: true --- -<span class="tag tag-inline">Scala 3 only</span> To make it more clear where givens in the current scope are coming from, a special form of the `import` statement is used to import `given` instances. The basic form is shown in this example: -{% tabs given-imports-basic-form %} - -{% tab 'Scala 3 Only' %} - ```scala object A: class TC @@ -28,28 +25,15 @@ object B: import A.given // import the given instance ``` -{% endtab %} - -{% endtabs %} - In this code the `import A.*` clause of object `B` imports all members of `A` *except* the `given` instance, `tc`. Conversely, the second import, `import A.given`, imports *only* that `given` instance. The two `import` clauses can also be merged into one: -{% tabs given-imports-merged %} - -{% tab 'Scala 3 Only' %} - ```scala object B: import A.{given, *} ``` -{% endtab %} - -{% endtabs %} - - ## Discussion The wildcard selector `*` brings all definitions other than givens or extensions into scope, whereas a `given` selector brings all *givens*---including those resulting from extensions---into scope. diff --git a/_overviews/scala3-book/ca-given-using-clauses.md b/_overviews/scala3-book/ca-given-using-clauses.md deleted file mode 100644 index 16169334c5..0000000000 --- a/_overviews/scala3-book/ca-given-using-clauses.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Given Instances and Using Clauses -type: section -description: This page demonstrates how to use 'given' instances and 'using' clauses in Scala 3. -languages: [zh-cn] -num: 60 -previous-page: ca-extension-methods -next-page: ca-context-bounds -scala3: true -versionSpecific: true ---- - -Scala 3 offers two important feature for contextual abstraction: - -- **Using Clauses** allow you to specify parameters that, at the call site, can be omitted by the programmer and should be automatically provided by the context. -- **Given Instances** let you define terms that can be used by the Scala compiler to fill in the missing arguments. - -## Using Clauses - -When designing a system, often context information like _configuration_ or settings need to be provided to the different components of your system. -One common way to achieve this is by passing the configuration as additional argument to your methods. - -In the following example, we define a case class `Config` to model some website configuration and pass it around in the different methods. - -```scala -case class Config(port: Int, baseUrl: String) - -def renderWebsite(path: String, c: Config): String = - "<html>" + renderWidget(List("cart"), c) + "</html>" - -def renderWidget(items: List[String], c: Config): String = ??? - -val config = Config(8080, "docs.scala-lang.org") -renderWebsite("/home", config) -``` - -Let us assume that the configuration does not change throughout most of our code base. -Passing `c` to each and every method call (like `renderWidget`) becomes very tedious and makes our program more difficult to read, since we need to ignore the `c` argument. - -#### Using `using` to mark parameters as contextual - -In Scala 3, we can mark some parameters of our methods as _contextual_. - -```scala -def renderWebsite(path: String)(using c: Config): String = - "<html>" + renderWidget(List("cart")) + "</html>" - // ^^^ - // no argument c required anymore - -def renderWidget(items: List[String])(using c: Config): String = ??? -``` - -By starting a parameter section with the keyword `using`, we tell the Scala compiler that at the call-site it should automatically find an argument with the correct type. -The Scala compiler thus performs **term inference**. - -In our call to `renderWidget(List("cart"))` the Scala compiler will see that there is a term of type `Config` in scope (the `c`) and automatically provide it to `renderWidget`. -So the program is equivalent to the one above. - -In fact, since we do not need to refer to `c` in our implementation of `renderWebsite` anymore, we can even omit its name in the signature: - -```scala -// no need to come up with a parameter name -// vvvvvvvvvvvvv -def renderWebsite(path: String)(using Config): String = - "<html>" + renderWidget(List("cart")) + "</html>" -``` - -#### Explicitly providing contextual arguments - -We have seen how to _abstract_ over contextual parameters and that the Scala compiler can provide arguments automatically for us. -But how can we specify which configuration to use for our call to `renderWebsite`? - -Like we specified our parameter section with `using`, we can also explicitly provide contextual arguments with `using:` - -```scala -renderWebsite("/home")(using config) -``` - -Explicitly providing contextual parameters can be useful if we have multiple different values in scope that would make sense, and we want to make sure that the correct one is passed to the function. - -For all other cases, as we will see in the next Section, there is also another way to bring contextual values into scope. - -## Given Instances - -We have seen that we can explicitly pass arguments as contextual parameters by marking the argument section of the _call_ with `using`. -However, if there is _a single canonical value_ for a particular type, there is another preferred way to make it available to the Scala compiler: by marking it as `given`. - -```scala -val config = Config(8080, "docs.scala-lang.org") -// this is the type that we want to provide the -// canonical value for -// vvvvvv -given Config = config -// ^^^^^^ -// this is the value the Scala compiler will infer -// as argument to contextual parameters of type Config -``` - -In the above example we specify that whenever a contextual parameter of type `Config` is omitted in the current scope, the compiler should infer `config` as an argument. - -Having defined a given for `Config`, we can simply call `renderWebsite`: - -```scala -renderWebsite("/home") -// ^^^^^ -// again no argument -``` - -[reference]: {{ site.scala3ref }}/overview.html -[blog-post]: /2020/11/06/explicit-term-inference-in-scala-3.html diff --git a/_overviews/scala3-book/ca-implicit-conversions.md b/_overviews/scala3-book/ca-implicit-conversions.md index 6294ffd64a..2318323b95 100644 --- a/_overviews/scala3-book/ca-implicit-conversions.md +++ b/_overviews/scala3-book/ca-implicit-conversions.md @@ -1,49 +1,223 @@ --- title: Implicit Conversions type: section -description: This page demonstrates how to implement Implicit Conversions in Scala 3. +description: This page demonstrates how to implement Implicit Conversions in Scala. languages: [zh-cn] num: 65 previous-page: ca-multiversal-equality next-page: ca-summary --- +Implicit conversions are a powerful Scala feature that allows users to supply an argument +of one type as if it were another type, to avoid boilerplate. -Implicit conversions are defined by `given` instances of the `scala.Conversion` class. -For example, not accounting for possible conversion errors, this code defines an implicit conversion from `String` to `Int`: +> Note that in Scala 2, implicit conversions were also used to provide additional members +> to closed classes (see [Implicit Classes]({% link _overviews/core/implicit-classes.md %})). +> In Scala 3, we recommend to address this use-case by defining [extension methods] instead +> of implicit conversions (although the standard library still relies on implicit conversions +> for historical reasons). + +## Example + +Consider for instance a method `findUserById` that takes a parameter of type `Long`: + +{% tabs implicit-conversions-1 %} +{% tab 'Scala 2 and 3' %} +~~~ scala +def findUserById(id: Long): Option[User] +~~~ +{% endtab %} +{% endtabs %} + +We omit the definition of the type `User` for the sake of brevity, it does not matter for +our example. + +In Scala, it is possible to call the method `findUserById` with an argument of type `Int` +instead of the expected type `Long`, because the argument will be implicitly converted +into the type `Long`: + +{% tabs implicit-conversions-2 %} +{% tab 'Scala 2 and 3' %} +~~~ scala +val id: Int = 42 +findUserById(id) // OK +~~~ +{% endtab %} +{% endtabs %} + +This code does not fail to compile with an error like “type mismatch: expected `Long`, +found `Int`” because there is an implicit conversion that converts the argument `id` +to a value of type `Long`. + +## Detailed Explanation + +This section describes how to define and use implicit conversions. + +### Defining an Implicit Conversion + +{% tabs implicit-conversions-3 class=tabs-scala-version %} + +{% tab 'Scala 2' %} +In Scala 2, an implicit conversion from type `S` to type `T` is defined by an +[implicit class]({% link _overviews/core/implicit-classes.md %}) `T` that takes +a single constructor parameter of type `S`, an +[implicit value]({% link _overviews/scala3-book/ca-context-parameters.md %}) of +function type `S => T`, or by an implicit method convertible to a value of that type. + +For example, the following code defines an implicit conversion from `Int` to `Long`: + +~~~ scala +import scala.language.implicitConversions + +implicit def int2long(x: Int): Long = x.toLong +~~~ + +This is an implicit method convertible to a value of type `Int => Long`. + +See the section “Beware the Power of Implicit Conversions” below for an +explanation of the clause `import scala.language.implicitConversions` +at the beginning. +{% endtab %} + +{% tab 'Scala 3' %} +In Scala 3, an implicit conversion from type `S` to type `T` is defined by a +[`given` instance]({% link _overviews/scala3-book/ca-context-parameters.md %}) +of type `scala.Conversion[S, T]`. For compatibility with Scala 2, it can also +be defined by an implicit method (read more in the Scala 2 tab). + +For example, this code defines an implicit conversion from `Int` to `Long`: ```scala -given Conversion[String, Int] with - def apply(s: String): Int = Integer.parseInt(s) +given int2long: Conversion[Int, Long] with + def apply(x: Int): Long = x.toLong ``` -Using an alias this can be expressed more concisely as: +Like other given definitions, implicit conversions can be anonymous: + +~~~ scala +given Conversion[Int, Long] with + def apply(x: Int): Long = x.toLong +~~~ + +Using an alias, this can be expressed more concisely as: ```scala -given Conversion[String, Int] = Integer.parseInt(_) +given Conversion[Int, Long] = (x: Int) => x.toLong ``` +{% endtab %} -Using either of those conversions, you can now use a `String` in places where an `Int` is expected: +{% endtabs %} -```scala +### Using an Implicit Conversion + +Implicit conversions are applied in two situations: + +1. If an expression `e` is of type `S`, and `S` does not conform to the expression's expected type `T`. +2. In a selection `e.m` with `e` of type `S`, if the selector `m` does not denote a member of `S` + (to support Scala-2-style [extension methods]). + +In the first case, a conversion `c` is searched for, which is applicable to `e` and whose result type conforms to `T`. + +In our example above, when we pass the argument `id` of type `Int` to the method `findUserById`, +the implicit conversion `int2long(id)` is inserted. + +In the second case, a conversion `c` is searched for, which is applicable to `e` and whose result contains a member named `m`. + +An example is to compare two strings `"foo" < "bar"`. In this case, `String` has no member `<`, so the implicit conversion `Predef.augmentString("foo") < "bar"` is inserted. (`scala.Predef` is automatically imported into all Scala programs.) + +### How Are Implicit Conversions Brought Into Scope? + +When the compiler searches for applicable conversions: + +- first, it looks into the current lexical scope + - implicit conversions defined in the current scope or the outer scopes + - imported implicit conversions + - implicit conversions imported by a wildcard import (Scala 2 only) +- then, it looks into the [companion objects] _associated_ with the argument + type `S` or the expected type `T`. The companion objects associated with + a type `X` are: + - the companion object `X` itself + - the companion objects associated with any of `X`’s inherited types + - the companion objects associated with any type argument in `X` + - if `X` is an inner class, the outer objects in which it is embedded + +For instance, consider an implicit conversion `fromStringToUser` defined in an +object `Conversions`: + +{% tabs implicit-conversions-4 class=tabs-scala-version %} +{% tab 'Scala 2' %} +~~~ scala import scala.language.implicitConversions -// a method that expects an Int -def plus1(i: Int) = i + 1 +object Conversions { + implicit def fromStringToUser(name: String): User = (name: String) => User(name) +} +~~~ +{% endtab %} +{% tab 'Scala 3' %} +~~~ scala +object Conversions: + given fromStringToUser: Conversion[String, User] = (name: String) => User(name) +~~~ +{% endtab %} +{% endtabs %} -// pass it a String that converts to an Int -plus1("1") -``` +The following imports would equivalently bring the conversion into scope: -> Note the clause `import scala.language.implicitConversions` at the beginning, -> to enable implicit conversions in the file. +{% tabs implicit-conversions-5 class=tabs-scala-version %} +{% tab 'Scala 2' %} +~~~ scala +import Conversions.fromStringToUser +// or +import Conversions._ +~~~ +{% endtab %} +{% tab 'Scala 3' %} +~~~ scala +import Conversions.fromStringToUser +// or +import Conversions.given +// or +import Conversions.{given Conversion[String, User]} +~~~ -## Discussion +Note that in Scala 3, a wildcard import (ie `import Conversions.*`) does not import given +definitions. +{% endtab %} +{% endtabs %} -The Predef package contains “auto-boxing” conversions that map primitive number types to subclasses of `java.lang.Number`. -For instance, the conversion from `Int` to `java.lang.Integer` can be defined as follows: +In the introductory example, the conversion from `Int` to `Long` does not require an import +because it is defined in the object `Int`, which is the companion object of the type `Int`. -```scala -given int2Integer: Conversion[Int, java.lang.Integer] = - java.lang.Integer.valueOf(_) -``` +Further reading: +[Where does Scala look for implicits? (on Stackoverflow)](https://stackoverflow.com/a/5598107). + +### Beware the Power of Implicit Conversions + +{% tabs implicit-conversions-6 class=tabs-scala-version %} +{% tab 'Scala 2' %} +Because implicit conversions can have pitfalls if used indiscriminately the compiler warns when compiling the implicit conversion definition. + +To turn off the warnings take either of these actions: + +* Import `scala.language.implicitConversions` into the scope of the implicit conversion definition +* Invoke the compiler with `-language:implicitConversions` + +No warning is emitted when the conversion is applied by the compiler. +{% endtab %} +{% tab 'Scala 3' %} +Because implicit conversions can have pitfalls if used indiscriminately the compiler warns in two situations: +- when compiling a Scala 2 style implicit conversion definition. +- at the call site where a given instance of `scala.Conversion` is inserted as a conversion. + +To turn off the warnings take either of these actions: + +- Import `scala.language.implicitConversions` into the scope of: + - a Scala 2 style implicit conversion definition + - call sites where a given instance of `scala.Conversion` is inserted as a conversion. +- Invoke the compiler with `-language:implicitConversions` +{% endtab %} +{% endtabs %} + +[extension methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[companion objects]: {% link _overviews/scala3-book/domain-modeling-tools.md %}#companion-objects diff --git a/_overviews/scala3-book/ca-summary.md b/_overviews/scala3-book/ca-summary.md index ede541abe2..e3f3da3cad 100644 --- a/_overviews/scala3-book/ca-summary.md +++ b/_overviews/scala3-book/ca-summary.md @@ -10,16 +10,19 @@ next-page: concurrency This chapter provides an introduction to most Contextual Abstractions topics, including: -- Given Instances and Using Clauses -- Context Bounds -- Given Imports -- Extension Methods -- Implementing Type Classes -- Multiversal Equality -- Implicit Conversions +- [Extension Methods]({% link _overviews/scala3-book/ca-extension-methods.md %}) +- [Given Instances and Using Clauses]({% link _overviews/scala3-book/ca-context-parameters.md %}) +- [Context Bounds]({% link _overviews/scala3-book/ca-context-bounds.md %}) +- [Given Imports]({% link _overviews/scala3-book/ca-given-imports.md %}) +- [Type Classes]({% link _overviews/scala3-book/ca-type-classes.md %}) +- [Multiversal Equality]({% link _overviews/scala3-book/ca-multiversal-equality.md %}) +- [Implicit Conversions]({% link _overviews/scala3-book/ca-implicit-conversions.md %}) + +These features are all variants of the core idea of **term inference**: given a type, the compiler synthesizes a “canonical” term that has that type. A few more advanced topics aren’t covered here, including: +- Conditional Given Instances - Type Class Derivation - Context Functions - By-Name Context Parameters diff --git a/_overviews/scala3-book/ca-type-classes.md b/_overviews/scala3-book/ca-type-classes.md index e0e81c8d50..18f5ef3f72 100644 --- a/_overviews/scala3-book/ca-type-classes.md +++ b/_overviews/scala3-book/ca-type-classes.md @@ -1,14 +1,14 @@ --- title: Type Classes type: section -description: This page demonstrates how to create and use type classes in Scala 3. +description: This page demonstrates how to create and use type classes. languages: [zh-cn] num: 63 previous-page: ca-given-imports next-page: ca-multiversal-equality +redirect_from: /scala3/book/types-type-classes.html --- - A _type class_ is an abstract, parameterized type that lets you add new behavior to any closed data type without using sub-typing. If you are coming from Java, you can think of type classes as something like [`java.util.Comparator[T]`][comparator]. @@ -20,69 +20,115 @@ A type class is useful in multiple use-cases, for example: - Expressing how a type you don’t own---from the standard library or a third-party library---conforms to such behavior - Expressing such a behavior for multiple types without involving sub-typing relationships between those types -In Scala 3, type classes are just traits with one or more parameters whose implementations are provided by `given` instances. - - +Type classes are traits with one or more parameters whose implementations are provided as `given` instances in Scala 3 or `implicit` values in Scala 2. ## Example -For example, `Show` is a well-known type class in Haskell, and the following code shows one way to implement it in Scala 3. -If you imagine that Scala classes don’t have a `toString` method, you can define a `Show` type class to add this behavior to any class that you want to be able to convert to a custom string. +For example, `Show` is a well-known type class in Haskell, and the following code shows one way to implement it in Scala. +If you imagine that Scala classes don’t have a `toString` method, you can define a `Show` type class to add this behavior to any type that you want to be able to convert to a custom string. ### The type class The first step in creating a type class is to declare a parameterized trait that has one or more abstract methods. Because `Showable` only has one method named `show`, it’s written like this: +{% tabs 'definition' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +// a type class +trait Showable[A] { + def show(a: A): String +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala // a type class trait Showable[A]: - extension(a: A) def show: String + extension (a: A) def show: String ``` +{% endtab %} +{% endtabs %} -This is the Scala 3 way of saying that any type that implements this trait must define how the `show` method works. -Notice that the syntax is very close to a normal trait: +Notice that this approach is close to the usual object-oriented approach, where you would typically define a trait `Show` as follows: +{% tabs 'trait' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +// a trait +trait Show { + def show: String +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala // a trait trait Show: def show: String ``` +{% endtab %} +{% endtabs %} There are a few important things to point out: -1. Type-classes like `Showable` take a type parameter `A` to say which type we provide the implementation of `show` for; in contrast, normal traits like `Show` do not. -2. To add the show functionality to a certain type `A`, the normal trait requires that `A extends Show`, while for type-classes we require to have an implementation of `Showable[A]`. -3. To allow the same method calling syntax in both `Showable` that mimics the one of `Show`, we define `Showable.show` as an extension method. +1. Type-classes like `Showable` take a type parameter `A` to say which type we provide the implementation of `show` for; in contrast, classic traits like `Show` do not. +2. To add the show functionality to a certain type `A`, the classic trait requires that `A extends Show`, while for type-classes we require to have an implementation of `Showable[A]`. +3. In Scala 3, to allow the same method calling syntax in both `Showable` that mimics the one of `Show`, we define `Showable.show` as an extension method. ### Implement concrete instances The next step is to determine what classes in your application `Showable` should work for, and then implement that behavior for them. For instance, to implement `Showable` for this `Person` class: +{% tabs 'person' %} +{% tab 'Scala 2 and 3' %} ```scala case class Person(firstName: String, lastName: String) ``` +{% endtab %} +{% endtabs %} -you’ll define a `given` value for `Showable[Person]`. -This code provides a concrete instance of `Showable` for the `Person` class: +you’ll define a single _canonical value_ of type `Showable[Person]`, ie an instance of `Showable` for the type `Person`, as the following code example demonstrates: +{% tabs 'instance' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +implicit val showablePerson: Showable[Person] = new Showable[Person] { + def show(p: Person): String = + s"${p.firstName} ${p.lastName}" +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala given Showable[Person] with - extension(p: Person) def show: String = + extension (p: Person) def show: String = s"${p.firstName} ${p.lastName}" ``` - -As shown, this is defined as an extension method on the `Person` class, and it uses the reference `p` inside the body of the `show` method. +{% endtab %} +{% endtabs %} ### Using the type class Now you can use this type class like this: +{% tabs 'usage' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val person = Person("John", "Doe") +println(showablePerson.show(person)) +``` + +Not that in practice, type classes are typically used with values whose type is unknown, unlike the type `Person`, as shown in the next section. +{% endtab %} +{% tab 'Scala 3' %} ```scala val person = Person("John", "Doe") println(person.show) ``` +{% endtab %} +{% endtabs %} Again, if Scala didn’t have a `toString` method available to every class, you could use this technique to add `Showable` behavior to any class that you want to be able to convert to a `String`. @@ -90,29 +136,52 @@ Again, if Scala didn’t have a `toString` method available to every class, you As with inheritance, you can define methods that use `Showable` as a type parameter: +{% tabs 'method' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def showAll[A](as: List[A])(implicit showable: Showable[A]): Unit = + as.foreach(a => println(showable.show(a))) + +showAll(List(Person("Jane"), Person("Mary"))) +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala -def showAll[S: Showable](xs: List[S]): Unit = - xs.foreach(x => println(x.show)) +def showAll[A: Showable](as: List[A]): Unit = + as.foreach(a => println(a.show)) showAll(List(Person("Jane"), Person("Mary"))) ``` +{% endtab %} +{% endtabs %} ### A type class with multiple methods Note that if you want to create a type class that has multiple methods, the initial syntax looks like this: +{% tabs 'multiple-methods' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +trait HasLegs[A] { + def walk(a: A): Unit + def run(a: A): Unit +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala trait HasLegs[A]: extension (a: A) def walk(): Unit def run(): Unit ``` +{% endtab %} +{% endtabs %} ### A real-world example For a real-world example of how type classes are used in Scala 3, see the `CanEqual` discussion in the [Multiversal Equality section][multiversal]. - [typeclasses-paper]: https://infoscience.epfl.ch/record/150280/files/TypeClasses.pdf [typeclasses-chapter]: {% link _overviews/scala3-book/ca-type-classes.md %} [comparator]: https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index 3415ef3496..407c124d2c 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -72,7 +72,7 @@ Happy 23rd Birthday, Lisa and Peter! ``` As shown, the `@main` method can have an arbitrary number of parameters. -For each parameter type there must be a [given instance](./ca-given-using-clauses.html) of the `scala.util.CommandLineParser.FromString` type class that converts an argument `String` to the required parameter type. +For each parameter type there must be a [given instance]({% link _overviews/scala3-book/ca-context-parameters.md %}) of the `scala.util.CommandLineParser.FromString` type class that converts an argument `String` to the required parameter type. Also as shown, a main method’s parameter list can end in a repeated parameter like `String*` that takes all remaining arguments given on the command line. The program implemented from an `@main` method checks that there are enough arguments on the command line to fill in all parameters, and that the argument strings can be converted to the required types. diff --git a/_overviews/scala3-book/scala-features.md b/_overviews/scala3-book/scala-features.md index 0e5b94f0db..d6f72d1873 100644 --- a/_overviews/scala3-book/scala-features.md +++ b/_overviews/scala3-book/scala-features.md @@ -244,7 +244,7 @@ In particular, the type system supports: - [Intersection types]({% link _overviews/scala3-book/types-intersection.md %}) - [Union types]({% link _overviews/scala3-book/types-union.md %}) - [Type lambdas]({{ site.scala3ref }}/new-types/type-lambdas.html) -- [`given` instances and `using` clauses]({% link _overviews/scala3-book/ca-given-using-clauses.md %}) +- [`given` instances and `using` clauses]({% link _overviews/scala3-book/ca-context-parameters.md %}) - [Extension methods]({% link _overviews/scala3-book/ca-extension-methods.md %}) - [Type classes]({% link _overviews/scala3-book/ca-type-classes.md %}) - [Multiversal equality]({% link _overviews/scala3-book/ca-multiversal-equality.md %}) @@ -572,7 +572,7 @@ As this page shows, Scala has many terrific programming language features at a h [reference]: {{ site.scala3ref }}/overview.html [multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} [extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} -[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _overviews/scala3-book/ca-context-parameters.md %} [opaque_types]: {% link _overviews/scala3-book/types-opaque-types.md %} diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index 61b2d558d2..b6c707f038 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -1306,7 +1306,7 @@ This includes: [equality]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} [error-handling]: {% link _overviews/scala3-book/fp-functional-error-handling.md %} [extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} -[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _overviews/scala3-book/ca-context-parameters.md %} [hofs]: {% link _overviews/scala3-book/fun-hofs.md %} [imports]: {% link _overviews/scala3-book/packaging-imports.md %} [modeling-intro]: {% link _overviews/scala3-book/domain-modeling-intro.md %} diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index 478a0b028d..f2ecd821e4 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -1366,7 +1366,7 @@ There are other concepts in Scala which currently have no equivalent in JavaScri [control]: {% link _overviews/scala3-book/control-structures.md %} [extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} [fp-intro]: {% link _overviews/scala3-book/fp-intro.md %} -[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _overviews/scala3-book/ca-context-parameters.md %} [hofs]: {% link _overviews/scala3-book/fun-hofs.md %} [intersection-types]: {% link _overviews/scala3-book/types-intersection.md %} [modeling-fp]: {% link _overviews/scala3-book/domain-modeling-fp.md %} diff --git a/_overviews/scala3-book/why-scala-3.md b/_overviews/scala3-book/why-scala-3.md index 44b14845d5..639c04691e 100644 --- a/_overviews/scala3-book/why-scala-3.md +++ b/_overviews/scala3-book/why-scala-3.md @@ -490,7 +490,7 @@ Several surveys have shown that different groups of developers love different fe Hopefully you’ll discover more great Scala features as you use the language. [java]: {% link _overviews/scala3-book/interacting-with-java.md %} -[given]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[given]: {% link _overviews/scala3-book/ca-context-parameters.md %} [contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} [reference]: {{ site.scala3ref }} [dropped]: {{ site.scala3ref }}/dropped-features diff --git a/_ru/scala3/book/methods-main-methods.md b/_ru/scala3/book/methods-main-methods.md index 3faca33023..79fc169c54 100644 --- a/_ru/scala3/book/methods-main-methods.md +++ b/_ru/scala3/book/methods-main-methods.md @@ -175,4 +175,4 @@ $ scala happyBirthday 23 Lisa Peter Happy 23rd Birthday, Lisa and Peter! ``` -[given]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[given]: {% link _overviews/scala3-book/ca-context-parameters.md %} diff --git a/_ru/scala3/book/scala-features.md b/_ru/scala3/book/scala-features.md index 84dedb717f..c5f6308ac9 100644 --- a/_ru/scala3/book/scala-features.md +++ b/_ru/scala3/book/scala-features.md @@ -230,7 +230,7 @@ val z = nums - [Типы пересечения]({% link _overviews/scala3-book/types-intersection.md %}) - [Типы объединения]({% link _overviews/scala3-book/types-union.md %}) - [Лямбда-типы]({{ site.scala3ref }}/new-types/type-lambdas.html) -- [Экземпляры `given` и предложения `using`]({% link _overviews/scala3-book/ca-given-using-clauses.md %}) +- [Экземпляры `given` и предложения `using`]({% link _overviews/scala3-book/ca-context-parameters.md %}) - [Методы расширения]({% link _overviews/scala3-book/ca-extension-methods.md %}) - [Типовые классы]({% link _overviews/scala3-book/ca-type-classes.md %}) - [Многостороннее равенство]({% link _overviews/scala3-book/ca-multiversal-equality.md %}) @@ -482,6 +482,6 @@ JSON библиотеки: [reference]: {{ site.scala3ref }}/overview.html [multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} [extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} -[givens]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _overviews/scala3-book/ca-context-parameters.md %} [opaque_types]: {% link _overviews/scala3-book/types-opaque-types.md %} diff --git a/_ru/scala3/book/why-scala-3.md b/_ru/scala3/book/why-scala-3.md index 02e260d668..6f2d7eb1a1 100644 --- a/_ru/scala3/book/why-scala-3.md +++ b/_ru/scala3/book/why-scala-3.md @@ -481,7 +481,7 @@ Scala обладает множеством замечательных функ Надеемся, вы откроете для себя больше замечательных возможностей Scala по мере использования языка. [java]: {% link _overviews/scala3-book/interacting-with-java.md %} -[given]: {% link _overviews/scala3-book/ca-given-using-clauses.md %} +[given]: {% link _overviews/scala3-book/ca-context-parameters.md %} [contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} [reference]: {{ site.scala3ref }} [dropped]: {{ site.scala3ref }}/dropped-features diff --git a/_tour/implicit-conversions.md b/_tour/implicit-conversions.md index cf93a062f2..7c0b5840e4 100644 --- a/_tour/implicit-conversions.md +++ b/_tour/implicit-conversions.md @@ -38,95 +38,6 @@ In the second case, a conversion `c` is searched for, which is applicable to `e` An example is to compare two strings `"foo" < "bar"`. In this case, `String` has no member `<`, so the implicit conversion `Predef.augmentString("foo") < "bar"` is inserted. (`scala.Predef` is automatically imported into all Scala programs.) -### How are implicit conversions brought into scope? ### - -{% tabs implicit-conversion-scope class=tabs-scala-version %} -{% tab 'Scala 2' %} -In Scala 2, an implicit conversion is brought into scope by importing from the object that defined it, (e.g. `Conversions` in this case). If the implicit conversion is in the companion object of the argument type, (e.g. `Student` in this case), then no import is necessary. - -```scala -import scala.language.implicitConversions // required to define an implicit conversion - -case class Student(name: String) -object Student { - implicit def fromStudentToInt(student: Student): Int = student.name.length -} - -object Conversions { - implicit def fromStringToStudent(name: String): Student = Student(name) -} - -import Conversions._ -object Usage { - def main(args: Array[String]) = { - val reginald: Student = "Reginald" // applies the conversion Conversions.fromStringToStudent - println(reginald + 2) // applies the conversion Student.fromStudentToInt - } -} -``` -{% endtab %} -{% tab 'Scala 3' %} -In Scala 3, an implicit conversion is brought into scope by either importing `given` or the named conversion from the object that defined it, (e.g. `Conversions` in this case). - -Note that as of Scala 3, implicit conversions cannot be brought into scope anymore by means of a wildcard import (`*`). - -Given the example: - -```scala -case class Student(name: String): - def printName: Unit = println(name) -object Student: - given Conversion[Student, Int] = _.name.length - -object Conversions: - given fromStringToStudent: Conversion[String, Student] = Student(_) -``` - -The following imports would bring the `Conversion[String, Student]` into scope: - - `import Conversions.given` - - `import Conversions.{given Conversion[String, Student]}` - - `import Conversions.fromStringToStudent` - -If the implicit conversion is in the companion object of the argument type, (e.g. `Student` in this case), then no import is necessary. - -```scala -import Conversions.given -object Usage: - @main def run = - val reginald: Student = "Reginald" // applies the Conversion[String, Student] - println(reginald + 2) // applies the Conversion[Student, Int] -``` -{% endtab %} -{% endtabs %} - -Further reading: - - [Where does Scala look for implicits? (on StackOverflow)](https://docs.scala-lang.org/tutorials/FAQ/index.html#where-does-scala-look-for-implicits). - -### Beware the power of implicit conversions - -{% tabs implicit-conversion-warning class=tabs-scala-version %} -{% tab 'Scala 2' %} -Because implicit conversions can have pitfalls if used indiscriminately the compiler warns when compiling the implicit conversion definition. - -To turn off the warnings take either of these actions: - -* Import `scala.language.implicitConversions` into the scope of the implicit conversion definition -* Invoke the compiler with `-language:implicitConversions` - -No warning is emitted when the conversion is applied by the compiler. -{% endtab %} -{% tab 'Scala 3' %} -Because implicit conversions can have pitfalls if used indiscriminately the compiler warns in two situations: -- when compiling a Scala 2 style implicit conversion definition. -- at the call site where a given instance of `scala.Conversion` is inserted as a conversion. - -To turn off the warnings take either of these actions: - -- Import `scala.language.implicitConversions` into the scope of: - - a Scala 2 style implicit conversion definition - - call sites where a given instance of `scala.Conversion` is inserted as a conversion. -- Invoke the compiler with `-language:implicitConversions` -{% endtab %} -{% endtabs %} +Further reading: [Implicit Conversions (in the Scala book)]({% link _overviews/scala3-book/ca-implicit-conversions.md %}). [exts]: {% link _overviews/scala3-book/ca-extension-methods.md %} diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index 56d948bad0..c7b81b6d12 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -4,7 +4,7 @@ type: section description: This page demonstrates Context Bounds in Scala 3. language: zh-cn num: 61 -previous-page: ca-given-using-clauses +previous-page: ca-context-parameters next-page: ca-given-imports partof: scala3-book diff --git a/_zh-cn/overviews/scala3-book/ca-given-using-clauses.md b/_zh-cn/overviews/scala3-book/ca-context-parameters.md similarity index 100% rename from _zh-cn/overviews/scala3-book/ca-given-using-clauses.md rename to _zh-cn/overviews/scala3-book/ca-context-parameters.md diff --git a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md index 80136106d6..d8f0f1a4d6 100644 --- a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -5,7 +5,7 @@ description: This chapter provides an introduction to the Scala 3 concept of Con language: zh-cn num: 58 previous-page: types-others -next-page: ca-given-using-clauses +next-page: ca-extension-methods partof: scala3-book overview-name: "Scala 3 — Book" @@ -78,7 +78,7 @@ Scala 3 中的这些更改实现了术语推理与语言其余部分的更好分 本章将在以下各节中介绍其中的许多新功能。 -[givens]: {% link _zh-cn/overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _zh-cn/overviews/scala3-book/ca-context-parameters.md %} [given-imports]: {% link _zh-cn/overviews/scala3-book/ca-given-imports.md %} [implicit-conversions]: {% link _zh-cn/overviews/scala3-book/ca-implicit-conversions.md %} [extension-methods]: {% link _zh-cn/overviews/scala3-book/ca-extension-methods.md %} diff --git a/_zh-cn/overviews/scala3-book/ca-extension-methods.md b/_zh-cn/overviews/scala3-book/ca-extension-methods.md index 7d780cae1f..2a8d4588ea 100644 --- a/_zh-cn/overviews/scala3-book/ca-extension-methods.md +++ b/_zh-cn/overviews/scala3-book/ca-extension-methods.md @@ -5,7 +5,7 @@ description: This page demonstrates how Extension Methods work in Scala 3. language: zh-cn num: 59 previous-page: ca-contextual-abstractions-intro -next-page: ca-given-using-clauses +next-page: ca-context-parameters partof: scala3-book overview-name: "Scala 3 — Book" diff --git a/_zh-cn/overviews/scala3-book/methods-main-methods.md b/_zh-cn/overviews/scala3-book/methods-main-methods.md index 4c1e9c57e8..f0b43aab6c 100644 --- a/_zh-cn/overviews/scala3-book/methods-main-methods.md +++ b/_zh-cn/overviews/scala3-book/methods-main-methods.md @@ -82,7 +82,7 @@ Happy 23rd Birthday, Lisa and Peter! ``` 如图所示，`@main` 方法可以有任意数量的参数。 -对于每个参数类型，必须是 `scala.util.CommandLineParser.FromString` 类型类的一个 [given实例](./ca-given-using-clauses.html)，它将参数 `String` 转换为所需的参数类型。 +对于每个参数类型，必须是 `scala.util.CommandLineParser.FromString` 类型类的一个 [given实例]({% link _overviews/scala3-book/ca-context-parameters.md %})，它将参数 `String` 转换为所需的参数类型。 同样如图所示，主方法的参数列表可以以重复参数结尾，例如 `String*`，它接受命令行中给出的所有剩余参数。 从 `@main` 方法实现的程序检查命令行上是否有足够的参数来填充所有参数，以及参数字符串是否可以转换为所需的类型。 diff --git a/_zh-cn/overviews/scala3-book/scala-features.md b/_zh-cn/overviews/scala3-book/scala-features.md index 3674c522e5..e86815acda 100644 --- a/_zh-cn/overviews/scala3-book/scala-features.md +++ b/_zh-cn/overviews/scala3-book/scala-features.md @@ -236,7 +236,7 @@ Scala 的类型系统在编译时强制要求以安全与连贯的方式使用 - [交叉类型]({% link _zh-cn/overviews/scala3-book/types-intersection.md %}) - [联合类型]({% link _zh-cn/overviews/scala3-book/types-union.md %}) - [类型 Lambda]({{ site.scala3ref }}/new-types/type-lambdas.html) -- [`given` 实例与 `using` 子句]({% link _zh-cn/overviews/scala3-book/ca-given-using-clauses.md %}) +- [`given` 实例与 `using` 子句]({% link _zh-cn/overviews/scala3-book/ca-context-parameters.md %}) - [扩展方法]({% link _zh-cn/overviews/scala3-book/ca-extension-methods.md %}) - [类型类]({% link _zh-cn/overviews/scala3-book/ca-type-classes.md %}) - [多元相等]({% link _zh-cn/overviews/scala3-book/ca-multiversal-equality.md %}) @@ -533,5 +533,5 @@ JSON 库： [reference]: {{ site.scala3ref }}/overview.html [multiversal]: {% link _zh-cn/overviews/scala3-book/ca-multiversal-equality.md %} [extension]: {% link _zh-cn/overviews/scala3-book/ca-extension-methods.md %} -[givens]: {% link _zh-cn/overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _zh-cn/overviews/scala3-book/ca-context-parameters.md %} [opaque_types]: {% link _zh-cn/overviews/scala3-book/types-opaque-types.md %} diff --git a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md index f4e20aa4c2..dc620ce53f 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md @@ -1257,7 +1257,7 @@ Scala 中还有其他一些概念目前在 Java 11 中是没有的。 [equality]: {% link _zh-cn/overviews/scala3-book/ca-multiversal-equality.md %} [error-handling]: {% link _zh-cn/overviews/scala3-book/fp-functional-error-handling.md %} [extension-methods]: {% link _zh-cn/overviews/scala3-book/ca-extension-methods.md %} -[givens]: {% link _zh-cn/overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _zh-cn/overviews/scala3-book/ca-context-parameters.md %} [hofs]: {% link _zh-cn/overviews/scala3-book/fun-hofs.md %} [imports]: {% link _zh-cn/overviews/scala3-book/packaging-imports.md %} [modeling-intro]: {% link _zh-cn/overviews/scala3-book/domain-modeling-intro.md %} diff --git a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md index 4563c43af4..e7a74b8757 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md @@ -1325,7 +1325,7 @@ Scala 中还有其他一些概念目前在 JavaScript 中没有等效的概念 [control]: {% link _zh-cn/overviews/scala3-book/control-structures.md %} [extension-methods]: {% link _zh-cn/overviews/scala3-book/ca-extension-methods.md %} [fp-intro]: {% link _zh-cn/overviews/scala3-book/fp-intro.md %} -[givens]: {% link _zh-cn/overviews/scala3-book/ca-given-using-clauses.md %} +[givens]: {% link _zh-cn/overviews/scala3-book/ca-context-parameters.md %} [hofs]: {% link _zh-cn/overviews/scala3-book/fun-hofs.md %} [intersection-types]: {% link _zh-cn/overviews/scala3-book/types-intersection.md %} [modeling-fp]: {% link _zh-cn/overviews/scala3-book/domain-modeling-fp.md %} diff --git a/_zh-cn/overviews/scala3-book/why-scala-3.md b/_zh-cn/overviews/scala3-book/why-scala-3.md index 2259ad6c01..b07b567fe7 100644 --- a/_zh-cn/overviews/scala3-book/why-scala-3.md +++ b/_zh-cn/overviews/scala3-book/why-scala-3.md @@ -493,7 +493,7 @@ Scala 有许多很棒的特性，选择十大列表可能是主观的。 多项调查表明，不同的开发人员群体喜欢不同的特性。 [java]: {% link _zh-cn/overviews/scala3-book/interacting-with-java.md %} -[given]: {% link _zh-cn/overviews/scala3-book/ca-given-using-clauses.md %} +[given]: {% link _zh-cn/overviews/scala3-book/ca-context-parameters.md %} [contextual]: {% link _zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md %} [reference]: {{ site.scala3ref }} [dropped]: {{ site.scala3ref }}/dropped-features From 6efe33551d231137d829d3de01308b792e62dd2f Mon Sep 17 00:00:00 2001 From: adpi2 <adrien.piquerez@gmail.com> Date: Tue, 9 May 2023 11:35:20 +0200 Subject: [PATCH 2600/3075] Add the Toolkit tutorials: MUnit, OS-Lib, UPickle and sttp (#2795) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Init tutorials about MUnit in the Scala Toolkit * Tutorial for MUnit async tests. * Small imprvements - Use you instead of we - Remove Scala-CLI tab on Scala code - Add info about InvalidTestClassError * Add tutorial on writing assertions * +you -we * complete tutorial for running individual tests * Improve intro and “next steps” * Make munit-test-suite tutorial more concise * Adding small tutorial about testing exceptions * Remove explanations * Init tutorials about sttp * Fix munit -> sttp * Navigate from munit * Fix next page on sttp-request-body * Tutorial on uploading files * Fixing some typos * Apply suggestions from code review Co-authored-by: Adrien Piquerez <adrien.piquerez@gmail.com> * Rename dynamic urls tutorialg * Fix address & change the link * Split into lines * Fix some URLs * Add tutorial about flaky tests * Add tutorial about resource management in MUnit * Review & structure fixes to sttp tutorials * Missing .html * Fix links * Shorter sentences and other changes * Apply suggestions from code review Co-authored-by: Simon R <dev.jaca@gmail.com> * WIP: os-lib tutorial * wip * wip * wip * wip * wip * wip * wip * apply review feedback from Szymon * Reworking tutorials to have two tabs * Add scala versions to snippets * Fix Scala-cli installation * Explain testOnly * Init upicle tutorials * Reading jsons lesson * Fixes to the tutorial * More work on reading JSONs tutorial * 3 tutorials in total for upickle * More tutorials on upickle * Update links to prev/next * Fixes in the upickle tutorials * Fix links * Review JSON tutorials * Add scala versions to snippets * Tutorials on STTP x UPickle * Use real examples from the Github REST API * Add snippets for different versions of Scala * Fix pages of toolkit tutorials * Restructuring the Toolkit tutorials * Fix title of upickle-parse-json * Fix titles of upickle-parse-json and sttp-query-parameters * OS-Lib adjustments * what else can OS-Lib do * oslib: take Julien's suggestion * revise OS-Lib examples to not be REPL based * Add short introduction * Add MUnit intro * Add uPickle intro * Add uPickle what else * Add a word about why testing is useful * expand overall intro * expand introduction * Add sttp intro * Link build tool tab together * Add checks for class=tabs-build-tool * Fix function.js * fix default build tool tab * Rework introduction * Review MUnit * Review install boxes in intros * Review OS-Lib * Review upickle * Review sttp * Update nums and pages * Finishing touches * update Gemfile.lock for use on MacOS * make overall intro a bit more concise * proofread MUnit sections * proofread uPickle sections * rewrite the sttp intro pretty heavily * proofread entire sttp tutorial * avoid talk of 'install'ing libraries * fix broken link * Update versions * small fixes in munit * small fixes in uPickle * Rename files * Run mdoc in http-client tutos * Run mdoc on JSON tutorials * Run mdoc in OS tutorials * run mdoc in testing tutorials * fix mdoc * using dep, not using lib * Add toolkit in the index page and nav bar * Use toolkit lib in all build tools * Add index in intro * Use dep toolkit-test * Fix install munit --------- Co-authored-by: Sébastien Doeraene <sjrdoeraene@gmail.com> Co-authored-by: Julien Richard-Foy <julien@richard-foy.fr> Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> Co-authored-by: Szymon Rodziewicz <szymonrodant@gmail.com> Co-authored-by: Szymon R <dev.jaca@gmail.com> Co-authored-by: Seth Tisue <seth@tisue.net> --- _config.yml | 10 +- _data/doc-nav-header.yml | 2 + _includes/_markdown/install-munit.md | 51 +++++++ _includes/_markdown/install-os-lib.md | 46 +++++++ _includes/_markdown/install-sttp.md | 47 +++++++ _includes/_markdown/install-upickle.md | 46 +++++++ _includes/markdown.html | 3 + _overviews/toolkit/OrderedListOfMdFiles | 29 ++++ _overviews/toolkit/http-client-intro.md | 20 +++ _overviews/toolkit/http-client-json.md | 128 ++++++++++++++++++ .../toolkit/http-client-request-body.md | 61 +++++++++ _overviews/toolkit/http-client-request.md | 123 +++++++++++++++++ _overviews/toolkit/http-client-upload-file.md | 80 +++++++++++ _overviews/toolkit/http-client-uris.md | 128 ++++++++++++++++++ _overviews/toolkit/http-client-what-else.md | 112 +++++++++++++++ _overviews/toolkit/introduction.md | 77 +++++++++++ _overviews/toolkit/json-deserialize.md | 121 +++++++++++++++++ _overviews/toolkit/json-files.md | 72 ++++++++++ _overviews/toolkit/json-intro.md | 16 +++ _overviews/toolkit/json-modify.md | 33 +++++ _overviews/toolkit/json-parse.md | 82 +++++++++++ _overviews/toolkit/json-serialize.md | 95 +++++++++++++ _overviews/toolkit/json-what-else.md | 74 ++++++++++ _overviews/toolkit/os-intro.md | 20 +++ _overviews/toolkit/os-read-directory.md | 59 ++++++++ _overviews/toolkit/os-read-file.md | 64 +++++++++ _overviews/toolkit/os-run-process.md | 79 +++++++++++ _overviews/toolkit/os-what-else.md | 18 +++ _overviews/toolkit/os-write-file.md | 54 ++++++++ _overviews/toolkit/testing-asynchronous.md | 87 ++++++++++++ _overviews/toolkit/testing-exceptions.md | 65 +++++++++ _overviews/toolkit/testing-intro.md | 21 +++ _overviews/toolkit/testing-resources.md | 101 ++++++++++++++ _overviews/toolkit/testing-run-only.md | 106 +++++++++++++++ _overviews/toolkit/testing-run.md | 91 +++++++++++++ _overviews/toolkit/testing-suite.md | 128 ++++++++++++++++++ _overviews/toolkit/testing-what-else.md | 83 ++++++++++++ .../jekyll-tabs-lib/jekyll-tabs-4scala.rb | 68 ++++++---- _plugins/mdoc_replace.rb | 1 + index.md | 4 + resources/js/functions.js | 45 +++--- scripts/run-mdoc.sh | 9 +- 42 files changed, 2505 insertions(+), 54 deletions(-) create mode 100644 _includes/_markdown/install-munit.md create mode 100644 _includes/_markdown/install-os-lib.md create mode 100644 _includes/_markdown/install-sttp.md create mode 100644 _includes/_markdown/install-upickle.md create mode 100644 _includes/markdown.html create mode 100644 _overviews/toolkit/OrderedListOfMdFiles create mode 100644 _overviews/toolkit/http-client-intro.md create mode 100644 _overviews/toolkit/http-client-json.md create mode 100644 _overviews/toolkit/http-client-request-body.md create mode 100644 _overviews/toolkit/http-client-request.md create mode 100644 _overviews/toolkit/http-client-upload-file.md create mode 100644 _overviews/toolkit/http-client-uris.md create mode 100644 _overviews/toolkit/http-client-what-else.md create mode 100644 _overviews/toolkit/introduction.md create mode 100644 _overviews/toolkit/json-deserialize.md create mode 100644 _overviews/toolkit/json-files.md create mode 100644 _overviews/toolkit/json-intro.md create mode 100644 _overviews/toolkit/json-modify.md create mode 100644 _overviews/toolkit/json-parse.md create mode 100644 _overviews/toolkit/json-serialize.md create mode 100644 _overviews/toolkit/json-what-else.md create mode 100644 _overviews/toolkit/os-intro.md create mode 100644 _overviews/toolkit/os-read-directory.md create mode 100644 _overviews/toolkit/os-read-file.md create mode 100644 _overviews/toolkit/os-run-process.md create mode 100644 _overviews/toolkit/os-what-else.md create mode 100644 _overviews/toolkit/os-write-file.md create mode 100644 _overviews/toolkit/testing-asynchronous.md create mode 100644 _overviews/toolkit/testing-exceptions.md create mode 100644 _overviews/toolkit/testing-intro.md create mode 100644 _overviews/toolkit/testing-resources.md create mode 100644 _overviews/toolkit/testing-run-only.md create mode 100644 _overviews/toolkit/testing-run.md create mode 100644 _overviews/toolkit/testing-suite.md create mode 100644 _overviews/toolkit/testing-what-else.md diff --git a/_config.yml b/_config.yml index 3439515b5d..02ccc1703c 100644 --- a/_config.yml +++ b/_config.yml @@ -192,6 +192,14 @@ defaults: overview-name: "Scaladoc" layout: multipage-overview permalink: "/scala3/guides/scaladoc/:title.html" + - + scope: + path: "_overviews/toolkit" + values: + partof: toolkit + overview-name: "The Scala Toolkit" + layout: multipage-overview + permalink: "/toolkit/:title.html" - scope: path: "scala3" @@ -203,6 +211,6 @@ highlighter: rouge permalink: /:categories/:title.html:output_ext baseurl: scala3ref: "https://docs.scala-lang.org/scala3/reference" -exclude: ["vendor"] +exclude: ["vendor", ".metals"] plugins: - jekyll-redirect-from diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index 392012e3b5..6eddea4ed7 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -37,6 +37,8 @@ url: "/tutorials/scala-on-android.html" - title: Scala with Maven url: "/tutorials/scala-with-maven.html" + - title: Using the Scala Toolkit + url: "/toolkit/introduction.html" - title: Reference url: "#" submenu: diff --git a/_includes/_markdown/install-munit.md b/_includes/_markdown/install-munit.md new file mode 100644 index 0000000000..e79aca2e44 --- /dev/null +++ b/_includes/_markdown/install-munit.md @@ -0,0 +1,51 @@ +{% altDetails install-info-box 'Getting MUnit' %} + +{% tabs munit-unit-test-1 class=tabs-build-tool %} +{% tab 'Scala CLI' %} +You can require the entire toolkit in a single line: +```scala +//> using dep "org.scala-lang::toolkit-test:0.1.7" +``` + +Alternatively, you can require just a specific version of MUnit: +```scala +//> using dep "org.scalameta::munit:1.0.0-M7" +``` +{% endtab %} +{% tab 'sbt' %} +In your build.sbt file, you can add the dependency on toolkit-test: +```scala +lazy val example = project.in(file("example")) + .settings( + scalaVersion := "3.2.2", + libraryDependencies += "org.scala-lang" %% "toolkit-test" % "0.1.7" % Test + ) +``` +Here the `Test` configuration means that the dependency is only used by the source files in `example/src/test`. + +Alternatively, you can require just a specific version of MUnit: +```scala +libraryDependencies += "org.scalameta" %% "munit" % "1.0.0-M7" % Test +``` +{% endtab %} +{% tab 'Mill' %} +In your build.sc file, you can add a `test` object extending `Tests` and `TestModule.Munit`: +```scala +object example extends ScalaModule { + def scalaVersion = "3.2.2" + object test extends Tests with TestModule.Munit { + def ivyDeps = + Agg( + ivy"org.scala-lang::toolkit-test:0.1.7" + ) + } +} +``` + +Alternatively, you can require just a specific version of MUnit: +```scala +ivy"org.scalameta::munit:1.0.0-M7" +``` +{% endtab %} +{% endtabs %} +{% endaltDetails %} diff --git a/_includes/_markdown/install-os-lib.md b/_includes/_markdown/install-os-lib.md new file mode 100644 index 0000000000..0d3057c0e9 --- /dev/null +++ b/_includes/_markdown/install-os-lib.md @@ -0,0 +1,46 @@ +{% altDetails require-info-box 'Getting OS-Lib' %} + +{% tabs oslib-install class=tabs-build-tool %} +{% tab 'Scala CLI' %} +You can require the entire toolkit in a single line: +```scala +//> using toolkit "latest" +``` + +Alternatively, you can require just a specific version of OS-Lib: +```scala +//> using dep "com.lihaoyi::os-lib:0.9.1" +``` +{% endtab %} +{% tab 'sbt' %} +In your `build.sbt`, you can add a dependency on the toolkit: +```scala +lazy val example = project.in(file("example")) + .settings( + scalaVersion := "3.2.2", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" + ) +``` +Alternatively, you can require just a specific version of OS-Lib: +```scala +libraryDependencies += "com.lihaoyi" %% "os-lib" % "0.9.1" +``` +{% endtab %} +{% tab 'Mill' %} +In your `build.sc` file, you can add a dependency on the Toolkit: +```scala +object example extends ScalaModule { + def scalaVersion = "3.2.2" + def ivyDeps = + Agg( + ivy"org.scala-lang::toolkit:0.1.7" + ) +} +``` +Alternatively, you can require just a specific version of OS-Lib: +```scala +ivy"com.lihaoyi::os-lib:0.9.1" +``` +{% endtab %} +{% endtabs %} +{% endaltDetails %} diff --git a/_includes/_markdown/install-sttp.md b/_includes/_markdown/install-sttp.md new file mode 100644 index 0000000000..16cd90f485 --- /dev/null +++ b/_includes/_markdown/install-sttp.md @@ -0,0 +1,47 @@ +{% altDetails install-info-box 'Getting sttp' %} + +{% tabs sttp-install-methods class=tabs-build-tool%} +{% tab 'Scala CLI' %} +You can require the entire toolkit in a single line: +```scala +//> using toolkit "latest" +``` + +Alternatively, you can require just a specific version of sttp: +```scala +//> using dep "com.softwaremill.sttp.client4::core:4.0.0-M1" +``` +{% endtab %} +{% tab 'sbt' %} +In your build.sbt file, you can add a dependency on the Toolkit: +```scala +lazy val example = project.in(file("example")) + .settings( + scalaVersion := "3.2.2", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" + ) +``` + +Alternatively, you can require just a specific version of sttp: +```scala +libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-M1" +``` +{% endtab %} +{% tab 'Mill' %} +In your build.sc file, you can add a dependency on the Toolkit: +```scala +object example extends ScalaModule { + def scalaVersion = "3.2.2" + def ivyDeps = + Agg( + ivy"org.scala-lang::toolkit:0.1.7" + ) +} +``` +Alternatively, you can require just a specific version of sttp: +```scala +ivy"com.softwaremill.sttp.client4::core:4.0.0-M1" +``` +{% endtab %} +{% endtabs %} +{% endaltDetails %} diff --git a/_includes/_markdown/install-upickle.md b/_includes/_markdown/install-upickle.md new file mode 100644 index 0000000000..2160f4dc91 --- /dev/null +++ b/_includes/_markdown/install-upickle.md @@ -0,0 +1,46 @@ +{% altDetails install-info-box 'Getting upickle' %} + +{% tabs upickle-install-methods class=tabs-build-tool %} +{% tab 'Scala CLI' %} +Using Scala CLI, you can require the entire toolkit in a single line: +```scala +//> using toolkit "latest" +``` + +Alternatively, you can require just a specific version of UPickle: +```scala +//> using dep "com.lihaoyi::upickle:3.1.0 +``` +{% endtab %} +{% tab 'sbt' %} +In your build.sbt file, you can add the dependency on the Toolkit: +```scala +lazy val example = project.in(file("example")) + .settings( + scalaVersion := "3.2.2", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" + ) +``` +Alternatively, you can require just a specific version of UPickle: +```scala +libraryDependencies += "com.lihaoyi" %% "upickle" % "3.1.0" +``` +{% endtab %} +{% tab 'Mill' %} +In your build.sc file, you can add the dependency to the upickle library: +```scala +object example extends ScalaModule { + def scalaVersion = "3.2.2" + def ivyDeps = + Agg( + ivy"org.scala-lang::toolkit:0.1.7" + ) +} +``` +Alternatively, you can require just a specific version of UPickle: +```scala +ivy"com.lihaoyi::upickle:3.1.0" +``` +{% endtab %} +{% endtabs %} +{% endaltDetails %} diff --git a/_includes/markdown.html b/_includes/markdown.html new file mode 100644 index 0000000000..cd79243a41 --- /dev/null +++ b/_includes/markdown.html @@ -0,0 +1,3 @@ +{%if include.selector%}<{{include.selector}} {%if include.classes%}class="{{include.classes}}"{%endif%} {%if include.id%}id="{{include.id}}{%endif%}">{%endif%} + {% capture markdown %}{% include {{include.path}} %}{% endcapture %}{{ markdown | markdownify }} +{%if include.selector%}</{{include.selector}}>{%endif%} diff --git a/_overviews/toolkit/OrderedListOfMdFiles b/_overviews/toolkit/OrderedListOfMdFiles new file mode 100644 index 0000000000..ea248772fe --- /dev/null +++ b/_overviews/toolkit/OrderedListOfMdFiles @@ -0,0 +1,29 @@ +introduction.md +testing-intro.md +testing-suite.md +testing-run.md +testing-run-only.md +testing-exceptions.md +testing-asynchronous.md +testing-resources.md +testing-what-else.md +os-intro.md +os-read-directory.md +os-read-file.md +os-write-file.md +os-run-process.md +os-what-else.md +json-intro.md +json-parse.md +json-modify.md +json-deserialize.md +json-serialize.md +json-files.md +json-what-else.md +http-client-intro.md +http-client-request.md +http-client-uris.md +http-client-request-body.md +http-client-json.md +http-client-upload-file.md +http-client-what-else.md diff --git a/_overviews/toolkit/http-client-intro.md b/_overviews/toolkit/http-client-intro.md new file mode 100644 index 0000000000..fd2e132c54 --- /dev/null +++ b/_overviews/toolkit/http-client-intro.md @@ -0,0 +1,20 @@ +--- +title: Sending HTTP requests with sttp +type: chapter +description: The introduction of the sttp library +num: 23 +previous-page: json-what-else +next-page: http-client-request +--- + +sttp is a popular and feature-rich library for making HTTP requests to web servers. + +It provides both a synchronous API and an asynchronous `Future`-based API. It also supports WebSockets. + +Extensions are available that add capabilities such as streaming, logging, telemetry, and serialization. + +sttp offers the same APIs on all platforms (JVM, Scala.js, and Scala Native). + +sttp is a good choice for small synchronous scripts as well as large-scale, highly concurrent, asynchronous applications. + +{% include markdown.html path="_markdown/install-sttp.md" %} diff --git a/_overviews/toolkit/http-client-json.md b/_overviews/toolkit/http-client-json.md new file mode 100644 index 0000000000..4fca18f91f --- /dev/null +++ b/_overviews/toolkit/http-client-json.md @@ -0,0 +1,128 @@ +--- +title: How to send and receive JSON? +type: section +description: How to send JSON in a request and to parse JSON from the response. +num: 27 +previous-page: http-client-request-body +next-page: http-client-upload-file +--- + +{% include markdown.html path="_markdown/install-sttp.md" %} + +## HTTP and JSON + +JSON is a common format for HTTP request and response bodies. + +In the examples below, we use the [GitHub REST API](https://docs.github.com/en/rest/users/users?apiVersion=2022-11-28). +You will need a secret [GitHub authentication token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) to run the programs. +Do not share your token with anyone. + +## Sending and receiving JSON + +To send a JSON request and parse a JSON response we use sttp in combination with uJson. + +### Sending JSON + +To send JSON, you can construct a `uJson.Value` and write it as a string in the body of the request. + +In the following example we use [GitHub users endpoint](https://docs.github.com/en/rest/users/users?apiVersion=2022-11-28) to update the profile of the authenticated user. +We provide the new location and bio of the profile in a JSON object. + +{% tabs 'json' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:compile-only +import sttp.client4.quick._ + +val json = ujson.Obj( + "location" -> "hometown", + "bio" -> "Scala programmer" +) + +val response = quickRequest + .patch(uri"https://api.github.com/user") + .auth.bearer(sys.env("GITHUB_TOKEN")) + .header("Content-Type", "application/json") + .body(ujson.write(json)) + .send() + +println(response.code) +// prints: 200 + +println(response.body) +// prints the full updated profile in JSON +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* + +val json = ujson.Obj( + "location" -> "hometown", + "bio" -> "Scala programmer" +) + +val response = quickRequest + .patch(uri"https://api.github.com/user") + .auth.bearer(sys.env("GITHUB_TOKEN")) + .header("Content-Type", "application/json") + .body(ujson.write(json)) + .send() + +println(response.code) +// prints: 200 + +println(response.body) +// prints the full updated profile in JSON +``` +{% endtab %} +{% endtabs %} + +Before running the program, set the `GITHUB_TOKEN` environment variable. +After running it, you should see your new bio and location on your GitHub profile. + +### Parsing JSON from the response + +To parse JSON from the response of a request, you can use `ujson.read`. + +Again we use the GitHub user endpoint, this time to get the authenticated user. + +{% tabs 'json-2' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:compile-only +import sttp.client4.quick._ + +val response = quickRequest + .get(uri"https://api.github.com/user") + .auth.bearer(sys.env("GITHUB_TOKEN")) + .send() + +val json = ujson.read(response.body) + +println(json("login").str) +// prints your login +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* + +val response = quickRequest + .get(uri"https://api.github.com/user") + .auth.bearer(sys.env("GITHUB_TOKEN")) + .send() + +val json = ujson.read(response.body) + +println(json("login").str) +// prints your login +``` +{% endtab %} +{% endtabs %} + +Before running the program, set the `GITHUB_TOKEN` environment variable. +Running the program should print your own login. + +## Sending and receiving Scala objects using JSON + +Alternatively, you can use uPickle to send or receive Scala objects using JSON. +Read the following to learn [*How to serialize an object to JSON*](/toolkit/json-serialize) and [*How to deserialize JSON to an object*](/toolkit/json-deserialize). diff --git a/_overviews/toolkit/http-client-request-body.md b/_overviews/toolkit/http-client-request-body.md new file mode 100644 index 0000000000..b54357e1cb --- /dev/null +++ b/_overviews/toolkit/http-client-request-body.md @@ -0,0 +1,61 @@ +--- +title: How to send a request with a body? +type: section +description: Sending a string body with sttp +num: 26 +previous-page: http-client-uris +next-page: http-client-json +--- + +{% include markdown.html path="_markdown/install-sttp.md" %} + +## Sending a request with a string body + +To send a POST request with a string body, you can chain `post` and `body` on a `quickRequest`: +{% tabs 'body' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import sttp.client4.quick._ + +val response = quickRequest + .post(uri"https://example.com/") + .body("Lorem ipsum") + .send() + +println(response.code) +// prints: 200 +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* + +val response = quickRequest + .post(uri"https://example.com/") + .body("Lorem ipsum") + .send() + +println(response.code) +// prints: 200 +``` +{% endtab %} +{% endtabs %} + +In a request with string body, sttp adds the `Content-Type: text/plain; charset=utf-8` header and computes the `Content-Length` header. + +## Binary data + +The `body` method can also take a `Array[Byte]`, a `ByteBuffer` or an `InputStream`. + +{% tabs 'binarydata' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val bytes: Array[Byte] = "john".getBytes +val request = quickRequest.post(uri"https://example.com/").body(bytes) +``` +{% endtab %} +{% endtabs %} + +The binary body of a request is sent with `Content-Type: application/octet-stream`. + +Learn more in the [sttp documentation chapter about request bodies](https://sttp.softwaremill.com/en/latest/requests/body.html). diff --git a/_overviews/toolkit/http-client-request.md b/_overviews/toolkit/http-client-request.md new file mode 100644 index 0000000000..3a63e29c45 --- /dev/null +++ b/_overviews/toolkit/http-client-request.md @@ -0,0 +1,123 @@ +--- +title: How to send a request? +type: section +description: Sending a simple HTTP request with sttp. +num: 24 +previous-page: http-client-intro +next-page: http-client-uris +--- + +{% include markdown.html path="_markdown/install-sttp.md" %} + +## Sending an HTTP request + +The simplest way to send a request with sttp is `quickRequest`. + +You can define a GET request with `.get` and send it with `.send`. + +{% tabs 'request' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import sttp.client4.quick._ +import sttp.client4.Response + +val response: Response[String] = quickRequest + .get(uri"https://httpbin.org/get") + .send() + +println(response.code) +// prints: 200 + +println(response.body) +// prints some JSON string +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* +import sttp.client4.Response + +val response: Response[String] = quickRequest + .get(uri"https://httpbin.org/get") + .send() + +println(response.code) +// prints: 200 + +println(response.body) +// prints some JSON string +``` +{% endtab %} +{% endtabs %} + +A `Response[String]` contains a status code and a string body. + +## The request definition + +### The HTTP method and URI + +To specify the HTTP method and URI of a `quickRequest`, you can use `get`, `post`, `put`, or `delete`. + +To construct a URI you can use the `uri` interpolator, for e.g. `uri"https://example.com"`. +To learn more about that, see [*How to construct URIs and query parameters?*](/toolkit/http-client-uris). + +### The headers + +By default, the `quickRequest` contains the "Accept-Encoding" and the "deflate" headers. +To add more headers, you can call one of the `header` or `headers` overloads: + +{% tabs 'headers' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:reset +import sttp.client4.quick._ + +val request = quickRequest + .get(uri"https://example.com") + .header("Origin", "https://scala-lang.org") + +println(request.headers) +// prints: Vector(Accept-Encoding: gzip, deflate, Origin: https://scala-lang.org) +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* + +val request = quickRequest + .get(uri"https://example.com") + .header("Origin", "https://scala-lang.org") + +println(request.headers) +// prints: Vector(Accept-Encoding: gzip, deflate, Origin: https://scala-lang.org) +``` +{% endtab %} +{% endtabs %} + +sttp can also add "Content-Type" and "Content-Length" automatically if the request contains a body. + +## Authentication + +If you need authentication to access a resource, you can use one of the `auth.basic`, `auth.basicToken`, `auth.bearer` or `auth.digest` methods. + +{% tabs 'auth' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:reset +import sttp.client4.quick._ + +// a request with a authentication +val request = quickRequest + .get(uri"https://example.com") + .auth.basic(user = "user", password = "***") +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* + +// a request with a authentication +val request = quickRequest + .get(uri"https://example.com") + .auth.basic(user = "user", password = "***") +``` +{% endtab %} +{% endtabs %} diff --git a/_overviews/toolkit/http-client-upload-file.md b/_overviews/toolkit/http-client-upload-file.md new file mode 100644 index 0000000000..a67af28fbd --- /dev/null +++ b/_overviews/toolkit/http-client-upload-file.md @@ -0,0 +1,80 @@ +--- +title: How to upload a file over HTTP? +type: section +description: Uploading a file over HTTP with sttp. +num: 28 +previous-page: http-client-json +next-page: http-client-what-else +--- + +{% include markdown.html path="_markdown/install-sttp.md" %} + +## Uploading a file + +To upload a file, you can put a Java `Path` in the body of a request. + +You can get a `Path` directly using `Paths.get("path/to/file")` or by converting an OS-Lib path to a Java path with `toNIO`. + +{% tabs 'file' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:compile-only +import sttp.client4.quick._ + +val file: java.nio.file.Path = (os.pwd / "image.png").toNIO +val response = quickRequest.post(uri"https://example.com/").body(file).send() + +println(response.code) +// prints: 200 +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* + +val file: java.nio.file.Path = (os.pwd / "image.png").toNIO +val response = quickRequest.post(uri"https://example.com/").body(file).send() + +println(response.code) +// prints: 200 +``` +{% endtab %} +{% endtabs %} + +## Multi-part requests + +If the web server can receive multiple files at once, you can use a multipart body, as follows: + +{% tabs 'multipart' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import sttp.client4.quick._ + +val file1 = (os.pwd / "avatar1.png").toNIO +val file2 = (os.pwd / "avatar2.png").toNIO +val response = quickRequest + .post(uri"https://example.com/") + .multipartBody( + multipartFile("avatar1.png", file1), + multipartFile("avatar2.png", file2) + ) + .send() +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* + +val file1 = (os.pwd / "avatar1.png").toNIO +val file2 = (os.pwd / "avatar2.png").toNIO +val response = quickRequest + .post(uri"https://example.com/") + .multipartBody( + multipartFile("avatar1.png", file1), + multipartFile("avatar2.png", file2) + ) + .send() +``` +{% endtab %} +{% endtabs %} + +Learn more about multipart requests in the [sttp documention](https://sttp.softwaremill.com/en/latest/requests/multipart.html). diff --git a/_overviews/toolkit/http-client-uris.md b/_overviews/toolkit/http-client-uris.md new file mode 100644 index 0000000000..bfb9beb332 --- /dev/null +++ b/_overviews/toolkit/http-client-uris.md @@ -0,0 +1,128 @@ +--- +title: How to construct URIs and query parameters? +type: section +description: Using interpolation to construct URIs +num: 25 +previous-page: http-client-request +next-page: http-client-request-body +--- + +{% include markdown.html path="_markdown/install-sttp.md" %} + +## The `uri` interpolator + +`uri` is a custom [string interpolator](/overviews/core/string-interpolation.html) that allows you to create valid web addresses, also called URIs. For example, you can write `uri"https://example.com/"`. + +You can insert any variable or expression in your URI with the usual `$` or `${}` syntax. +For instance `uri"https://example.com/$name"`, interpolates the value of the variable `name` into an URI. +If `name` contains `"peter"`, the result is `https://example.com/peter`. + +`uri` escapes special characters automatically, as seen in this example: + +{% tabs 'uri' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import sttp.client4.quick._ +import sttp.model.Uri + +val book = "programming in scala" +val bookUri: Uri = uri"https://example.com/books/$book" + +println(bookUri) +// prints: https://example.com/books/programming%20in%20scala +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import sttp.client4.quick.* +import sttp.model.Uri + +val book = "programming in scala" +val bookUri: Uri = uri"https://example.com/books/$book" + +println(bookUri) +// prints: https://example.com/books/programming%20in%20scala +``` +{% endtab %} +{% endtabs %} + +## Query parameters + +A query parameter is a key-value pair that is appended to the end of a URI in an HTTP request to specify additional details about the request. +The web server can use those parameters to compute the appropriate response. + +For example, consider the following URL: + +``` +https://example.com/search?q=scala&limit=10&page=1 +``` + +It contains three query parameters: `q=scala`, `limit=10` and `page=1`. + +### Using a map of query parameters + +The `uri` interpolator can interpolate a `Map[String, String]` as query parameters: + +{% tabs 'queryparams' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val queryParams = Map( + "q" -> "scala", + "limit" -> "10", + "page" -> "1" +) +val uriWithQueryParams = uri"https://example.com/search?$queryParams" +println(uriWithQueryParams) +// prints: https://example.com/search?q=scala&limit=10&page=1 +``` +{% endtab %} +{% endtabs %} + +For safety, special characters in the parameters are automatically escaped by the interpolator. + +## Using an optional query parameter + +A query parameter might be optional. +The `uri` interpolator can interpolate `Option`s: + +{% tabs 'optional' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +def getUri(limit: Option[Int]): Uri = + uri"https://example.com/all?limit=$limit" + +println(getUri(Some(10))) +// prints: https://example.com/all?limit=100 + +println(getUri(None)) +// prints: https://example.com/all +``` +{% endtab %} +{% endtabs %} + +Notice that the query parameter disappears entirely when `limit` is `None`. + +## Using a sequence as values of a single query parameter + +A query parameter can be repeated in a URI to represent a list of values. +For example, the `version` parameter in `?version=1.0.0&version=1.0.1&version=1.1.0` contains 3 values: `1.0.0`, `1.0.1` and `1.1.0`. + +To build such query parameter in a URI, you can interpolate a `Seq` (or `List`, `Array`, etc) in a `uri"..."`. + +{% tabs 'seq' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:nest +def getUri(versions: Seq[String]): Uri = + uri"https://example.com/scala?version=$versions" + +println(getUri(Seq("3.2.2"))) +// prints: https://example.com/scala?version=3.2.2 + +println(getUri(Seq("2.13.8", "2.13.9", "2.13.10"))) +// prints: https://example.com/scala?version=2.13.8&version=2.13.9&version=2.13.10 + +println(getUri(Seq.empty)) +// prints: https://example.com/scala +``` +{% endtab %} +{% endtabs %} diff --git a/_overviews/toolkit/http-client-what-else.md b/_overviews/toolkit/http-client-what-else.md new file mode 100644 index 0000000000..11b577449d --- /dev/null +++ b/_overviews/toolkit/http-client-what-else.md @@ -0,0 +1,112 @@ +--- +title: What else can sttp do? +type: section +description: An incomplete list of features of sttp +num: 29 +previous-page: http-client-upload-file +next-page: +--- + +{% include markdown.html path="_markdown/install-upickle.md" %} + +## Asynchronous requests + +To send a request asynchronously you can use a `DefaultFutureBackend`: + +{% tabs 'async' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import scala.concurrent.Future +import sttp.client4._ + +val asyncBackend = DefaultFutureBackend() +val response: Future[Response[String]] = quickRequest + .get(uri"https://example.com") + .send(asyncBackend) +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import scala.concurrent.Future +import sttp.client4.* + +val asyncBackend = DefaultFutureBackend() +val response: Future[Response[String]] = quickRequest + .get(uri"https://example.com") + .send(asyncBackend) +``` +{% endtab %} +{% endtabs %} + +You can learn more about `Future`-based backends in the [sttp documentation](https://sttp.softwaremill.com/en/latest/backends/future.html). + +sttp supports other asynchronous wrappers such as Monix `Task`s, cats-effect `Effect`s, ZIO's `ZIO` type, and more. +You can see the full list of supported backends [here](https://sttp.softwaremill.com/en/latest/backends/summary.html). + +## Websockets + +You can use a `DefaultFutureBackend` to open a websocket, as follows. + +{% tabs 'ws' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:reset +import scala.concurrent.duration.Duration +import scala.concurrent.{Await, Future} +import scala.concurrent.ExecutionContext.Implicits.global + +import sttp.client4._ +import sttp.ws.WebSocket + +val asyncBackend = DefaultFutureBackend() + +def useWebSocket(ws: WebSocket[Future]): Future[Unit] = + for { + _ <- ws.sendText("Hello") + text <- ws.receiveText() + } yield { + println(text) + } + +val response = quickRequest + .get(uri"wss://ws.postman-echo.com/raw") + .response(asWebSocketAlways(useWebSocket)) + .send(asyncBackend) + +Await.result(response, Duration.Inf) +// prints: Hello +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import scala.concurrent.duration.Duration +import scala.concurrent.{Await, Future} +import scala.concurrent.ExecutionContext.Implicits.global + +import sttp.client4.* +import sttp.ws.WebSocket + +val asyncBackend = DefaultFutureBackend() + +def useWebSocket(ws: WebSocket[Future]): Future[Unit] = + for + _ <- ws.sendText("Hello") + text <- ws.receiveText() + yield + println(text) + +val response = quickRequest + .get(uri"wss://ws.postman-echo.com/raw") + .response(asWebSocketAlways(useWebSocket)) + .send(asyncBackend) + +Await.result(response, Duration.Inf) +// prints: Hello +``` +{% endtab %} +{% endtabs %} + +Learn more about WebSockets in [sttp documentation](https://sttp.softwaremill.com/en/latest/websockets.html). + +## More features + +You can discover many more features such as streaming, logging, timeouts, and more in [sttp documentation](https://sttp.softwaremill.com/en/latest/quickstart.html#). diff --git a/_overviews/toolkit/introduction.md b/_overviews/toolkit/introduction.md new file mode 100644 index 0000000000..1656ed9662 --- /dev/null +++ b/_overviews/toolkit/introduction.md @@ -0,0 +1,77 @@ +--- +title: Introduction +type: chapter +description: Introducing the Scala Toolkit tutorials +num: 1 +previous-page: +next-page: testing-intro +toolkit-index: + - title: Tests + description: Testing code with MUnit. + icon: "fa fa-vial-circle-check" + link: /toolkit/testing-intro.html + - title: Files and Processes + description: Writing files and running processes with OS-Lib. + icon: "fa fa-folder-open" + link: /toolkit/os-intro.html + - title: JSON + description: Parsing JSON and serializing objects to JSON with uPickle. + icon: "fa fa-file-code" + link: /toolkit/json-intro.html + - title: HTTP Requests + description: Sending HTTP requests and uploading files with sttp. + icon: "fa fa-globe" + link: /toolkit/http-client-intro.html +--- + +## What is the Scala Toolkit? + +The Scala Toolkit is a set of libraries designed to effectively perform common programming tasks. It includes tools for working with files and processes, parsing JSON, sending HTTP requests, and unit testing. + +The Toolkit supports: +* Scala 3 and Scala 2 +* JVM, Scala.js, and Scala Native + +Use cases for the Toolkit include: + +- short-lived programs running on the JVM, to scrape a website, to collect and transform data, or to fetch and process some files, +- frontend scripts that run on the browser and power your websites, +- command-line tools packaged as native binaries for instant startup + +{% include inner-documentation-sections.html links=page.toolkit-index %} + +## What are these tutorials? + +This series of tutorials focuses on short code examples, to help you get started quickly. + +If you need more in-depth information, the tutorials include links to further documentation for all of the libraries in the toolkit. + +## How to run the code? + +You can follow the tutorials regardless of how you choose to run your +Scala code. The tutorials focus on the code itself, not on the process +of running it. + +Ways to run Scala code include: +* in your **browser** with [Scastie](https://scastie.scala-lang.org) + * pros: zero installation, online sharing + * cons: single-file only, online-only +* interactively in the Scala **REPL** (Read/Eval/Print Loop) + * pros: interactive exploration in the terminal + * cons: doesn't save your code anywhere +* interactively in a **worksheet** in your IDE such as [IntelliJ](https://www.jetbrains.com/help/idea/discover-intellij-idea-for-scala.html) or [Metals](http://scalameta.org/metals/) + * pros: interactive exploration in a GUI + * cons: requires worksheet environment to run +* in **scripts**, using [Scala CLI](https://scala-cli.virtuslab.com) + * pros: terminal-based workflow with little setup + * cons: may not be suitable for large projects +* using a **build tool** (such as [sbt](https://www.scala-sbt.org) or [mill](https://com-lihaoyi.github.io/mill/)) + * pros: terminal-based workflow for projects of any size + * cons: requires some additional setup and learning +* using an **IDE** such as [IntelliJ](https://www.jetbrains.com/help/idea/discover-intellij-idea-for-scala.html) or [Metals](http://scalameta.org/metals/) + * pros: GUI based workflow for projects of any size + * cons: requires some additional setup and learning + +These choices, with their pros and cons, are common to most programing +languages. +Feel free to use whichever option you're most comfortable with. diff --git a/_overviews/toolkit/json-deserialize.md b/_overviews/toolkit/json-deserialize.md new file mode 100644 index 0000000000..23fd6391d1 --- /dev/null +++ b/_overviews/toolkit/json-deserialize.md @@ -0,0 +1,121 @@ +--- +title: How to deserialize JSON to an object? +type: section +description: Parsing JSON to a custom data type +num: 19 +previous-page: json-modify +next-page: json-serialize +--- + +{% include markdown.html path="_markdown/install-upickle.md" %} + +## Parsing vs. deserialization + +Parsing with uJson only accepts valid JSON, but it does not validate that the names and types of fields are as expected. + +Deserialization, on the other hand, transforms a JSON string to some user-specified Scala data type, if required fields are present and have the correct types. + +In this tutorial, we show how to deserialize to a `Map` and also to a custom `case class`. + +## Deserializing JSON to a `Map` + +For a type `T`, uPickle can deserialize JSON to a `Map[String, T]`, checking that all fields conform to `T`. + +We can for instance, deserialize to a `Map[String, List[Int]]`: + +{% tabs 'parsemap' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val json = """{"primes": [2, 3, 5], "evens": [2, 4, 6]} """ +val map: Map[String, List[Int]] = + upickle.default.read[Map[String, List[Int]]](json) + +println(map("primes")) +// prints: List(2, 3, 5) +``` +{% endtab %} +{% endtabs %} + +If a value is the wrong type, uPickle throws a `upickle.core.AbortException`. + +{% tabs 'parsemap-error' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:reset:crash +val json = """{"name": "Peter"} """ +upickle.default.read[Map[String, List[Int]]](json) +// throws: upickle.core.AbortException: expected sequence got string at index 9 +``` +{% endtab %} +{% endtabs %} + +### Deserializing JSON to a custom data type + +In Scala, you can use a `case class` to define your own data type. +For example, to represent a pet owner, you might: +```scala mdoc:reset +case class PetOwner(name: String, pets: List[String]) +``` + +To read a `PetOwner` from JSON, we must provide a `ReadWriter[PetOwner]`. +uPickle can do that automatically: + +{% tabs 'given' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import upickle.default._ + +implicit val ownerRw: ReadWriter[PetOwner] = macroRW[PetOwner] +``` +Some explanations: +- An `implicit val` is a value that can be automatically provided as an argument to a method or function call, without having to explicitly pass it. +- `macroRW` is a method provided by uPickle that can generate a instances of `ReadWriter` for case classes, using the information about its fields. +{% endtab %} +{% tab 'Scala 3' %} +```scala +import upickle.default.* + +case class PetOwner(name: String, pets: List[String]) + derives ReadWriter +``` +The `derives` keyword is used to automatically generate given instances. +Using the compiler's knowledge of the fields in `PetOwner`, it generates a `ReadWriter[PetOwner]`. +{% endtab %} +{% endtabs %} + +This means that you can now read (and write) `PetOwner` objects from JSON with `upickle.default.read(petOwner)`. + +Notice that you do not need to pass the instance of `ReadWriter[PetOwner]` explicitly to the `read` method. But it does, nevertheless, get it from the context, as "given" value. You may find more information about contextual abstractions in the [Scala 3 Book](https://docs.scala-lang.org/scala3/book/ca-contextual-abstractions-intro.html). + +Putting everything together you should get: + +{% tabs 'full' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:reset +import upickle.default._ + +case class PetOwner(name: String, pets: List[String]) +implicit val ownerRw: ReadWriter[PetOwner] = macroRW + +val json = """{"name": "Peter", "pets": ["Toolkitty", "Scaniel"]}""" +val petOwner: PetOwner = read[PetOwner](json) + +val firstPet = petOwner.pets.head +println(s"${petOwner.name} has a pet called $firstPet") +// prints: Peter has a pet called Toolkitty +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import upickle.default.* + +case class PetOwner(name: String, pets: List[String]) derives ReadWriter + +val json = """{"name": "Peter", "pets": ["Toolkitty", "Scaniel"]}""" +val petOwner: PetOwner = read[PetOwner](json) + +val firstPet = petOwner.pets.head +println(s"${petOwner.name} has a pet called $firstPet") +// prints: Peter has a pet called Toolkitty +``` +{% endtab %} +{% endtabs %} diff --git a/_overviews/toolkit/json-files.md b/_overviews/toolkit/json-files.md new file mode 100644 index 0000000000..63fd2759ec --- /dev/null +++ b/_overviews/toolkit/json-files.md @@ -0,0 +1,72 @@ +--- +title: How to read and write JSON files? +type: section +description: Reading and writing JSON files using UPickle and OSLib +num: 21 +previous-page: json-serialize +next-page: json-what-else +--- + +{% include markdown.html path="_markdown/install-upickle.md" %} + +## Read and write raw JSON + +To read and write JSON files, you can use uJson and OS-Lib as follows: + +{% tabs 'raw' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:compile-only +// read a JSON file +val json = ujson.read(os.read(os.pwd / "raw.json")) + +// modify the JSON content +json("updated") = "now" + +//write to a new file +os.write(os.pwd / "raw-updated.json", ujson.write(json)) +``` +{% endtab %} +{% endtabs %} + +## Read and write Scala objects using JSON + +To read and write Scala objects to and from JSON files, you can use uPickle and OS-Lib as follows: + +{% tabs 'object' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:compile-only +import upickle.default._ + +case class PetOwner(name: String, pets: List[String]) +implicit val ownerRw: ReadWriter[PetOwner] = macroRW + +// read a PetOwner from a JSON file +val petOwner: PetOwner = read[PetOwner](os.read(os.pwd / "pet-owner.json")) + +// create a new PetOwner +val petOwnerUpdated = petOwner.copy(pets = "Toolkitty" :: petOwner.pets) + +// write to a new file +os.write(os.pwd / "pet-owner-updated.json", write(petOwnerUpdated)) +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import upickle.default.* + +case class PetOwner(name: String, pets: List[String]) derives ReadWriter + +// read a PetOwner from a JSON file +val petOwner: PetOwner = read[PetOwner](os.read(os.pwd / "pet-owner.json")) + +// create a new PetOwner +val petOwnerUpdated = petOwner.copy(pets = "Toolkitty" :: petOwner.pets) + +// write to a new file +os.write(os.pwd / "pet-owner-updated.json", write(petOwnerUpdated)) +``` +{% endtab %} +{% endtabs %} + +To serialize and deserialize Scala case classes (or enums) to JSON we need an instance of `ReadWriter`. +To understand how uPickle generates it for you, you can read the [*How to deserialize JSON to an object?*](/toolkit/json-deserialize) or the [*How to serialize an object to JSON?*](/toolkit/json-serialize) tutorials. diff --git a/_overviews/toolkit/json-intro.md b/_overviews/toolkit/json-intro.md new file mode 100644 index 0000000000..7fb3e890de --- /dev/null +++ b/_overviews/toolkit/json-intro.md @@ -0,0 +1,16 @@ +--- +title: Handling JSON with uPickle +type: chapter +description: Description of the uPickle library. +num: 16 +previous-page: os-what-else +next-page: json-parse +--- + +uPickle is a lightweight serialization library for Scala. + +It includes uJson, a JSON manipulation library that can parse JSON strings, access or mutate their values in memory, and write them back out again. + +uPickle can serialize and deserialize Scala objects directly to and from JSON. It knows how to handle the Scala collections such as `Map` and `Seq`, as well as your own data types, such as `case class`s and Scala 3 `enum`s. + +{% include markdown.html path="_markdown/install-upickle.md" %} diff --git a/_overviews/toolkit/json-modify.md b/_overviews/toolkit/json-modify.md new file mode 100644 index 0000000000..8f1cd63e6d --- /dev/null +++ b/_overviews/toolkit/json-modify.md @@ -0,0 +1,33 @@ +--- +title: How to modify JSON? +type: section +description: Modifying JSON with uPickle. +num: 18 +previous-page: json-parse +next-page: json-deserialize +--- + +{% include markdown.html path="_markdown/install-upickle.md" %} + +`ujson.read` returns a mutable representation of JSON that you can update. Fields and elemnts can be added, modified, or removed. + +First you read the JSON string, then you update it in memory, and finally you write it back out again. + +{% tabs 'modify' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +// Parse the JSON string +val json: ujson.Value = ujson.read("""{"name":"John","pets":["Toolkitty","Scaniel"]}""") + +// Update it +json("name") = "Peter" +json("nickname") = "Pete" +json("pets").arr.remove(1) + +// Write it back to a String +val result: String = ujson.write(json) +println(result) +// prints: {"name":"Peter","pets":["Toolkitty"],"nickname":"Pete"} +``` +{% endtab %} +{% endtabs %} diff --git a/_overviews/toolkit/json-parse.md b/_overviews/toolkit/json-parse.md new file mode 100644 index 0000000000..71b1fab391 --- /dev/null +++ b/_overviews/toolkit/json-parse.md @@ -0,0 +1,82 @@ +--- +title: How to access values inside JSON? +type: section +description: Accessing JSON values using ujson. +num: 17 +previous-page: json-intro +next-page: json-modify +--- + +{% include markdown.html path="_markdown/install-upickle.md" %} + +## Accessing values inside JSON + +To parse a JSON string and access fields inside it, you can use uJson, which is part of uPickle. + +The method `ujson.read` parses a JSON string into memory: +{% tabs 'read' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val jsonString = """{"name": "Peter", "age": 13, "pets": ["Toolkitty", "Scaniel"]}""" +val json: ujson.Value = ujson.read(jsonString) +println(json("name").str) +// prints: Peter +``` +{% endtab %} +{% endtabs %} + +To access the `"name"` field, we do `json("name")` and then call `str` to type it as a string. + +To access the elements by index in a JSON array, + +{% tabs 'array' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val pets: ujson.Value = json("pets") + +val firstPet: String = pets(0).str +val secondPet: String = pets(1).str + +println(s"The pets are $firstPet and $secondPet") +// prints: The pets are Toolkitty and Scaniel +``` +{% endtab %} +{% endtabs %} + +You can traverse the JSON structure as deeply as you want, to extract any nested value. +For instance, `json("field1")(0)("field2").str` is the string value of `field2` in the first element of the array in `field1`. + +## JSON types + +In the previous examples we used `str` to type a JSON value as a string. +Similar methods exist for other types of values, namely: + - `num` for numeric values, returning `Double` + - `bool` for boolean values, returning `Boolean` + - `arr` for arrays, returning a mutable `Buffer[ujson.Value]` + - `obj` for objects, returning a mutable `Map[String, ujson.Value]` + +{% tabs 'typing' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:reset +import scala.collection.mutable + +val jsonString = """{"name": "Peter", "age": 13, "pets": ["Toolkitty", "Scaniel"]}""" +val json = ujson.read(jsonString) + +val person: mutable.Map[String, ujson.Value] = json.obj +val age: Double = person("age").num +val pets: mutable.Buffer[ujson.Value] = person("pets").arr +``` +{% endtab %} +{% endtabs %} + +If a JSON value does not conform to the expected type, uJson throws a `ujson.Value.InvalidData` exception. + +{% tabs 'exception' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:crash +val name: Boolean = person("name").bool +// throws a ujson.Value.InvalidData: Expected ujson.Bool (data: "Peter") +``` +{% endtab %} +{% endtabs %} diff --git a/_overviews/toolkit/json-serialize.md b/_overviews/toolkit/json-serialize.md new file mode 100644 index 0000000000..bd3049def0 --- /dev/null +++ b/_overviews/toolkit/json-serialize.md @@ -0,0 +1,95 @@ +--- +title: How to serialize an object to JSON? +type: section +description: How to write JSON with Scala Toolkit. +num: 20 +previous-page: json-deserialize +next-page: json-files +--- + +{% include markdown.html path="_markdown/install-upickle.md" %} + +## Serializing a Map to JSON + +uPickle can serialize your Scala objects to JSON, so that you can save them in files or send them over the network. + +By default it can serialize primitive types such as `Int` or `String`, as well as standard collections such as `Map` and `List`. + +{% tabs 'array' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val map: Map[String, Int] = + Map("Toolkitty" -> 3, "Scaniel" -> 5) +val jsonString: String = upickle.default.write(map) +println(jsonString) +// prints: {"Toolkitty":3,"Scaniel":5} +``` +{% endtab %} +{% endtabs %} + +## Serializing a custom object to JSON + +In Scala, you can use a `case class` to define your own data type. +For example, to represent a pet owner with the name of its pets, you can +```scala mdoc:reset +case class PetOwner(name: String, pets: List[String]) +``` + +To be able to write a `PetOwner` to JSON we need to provide a `ReadWriter` instance for the case class `PetOwner`. +Luckily, `upickle` is able to fully automate that: + +{% tabs 'given' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import upickle.default._ + +implicit val ownerRw: ReadWriter[PetOwner] = macroRW[PetOwner] +``` +Some explanations: +- An `implicit val` is a value that can be automatically provided as an argument to a method or function call, without having to explicitly pass it. +- `macroRW` is a method provided by uPickle that can generate a instances of `ReadWriter` for case classes, using the information about its fields. +{% endtab %} +{% tab 'Scala 3' %} +```scala +import upickle.default.* + +case class PetOwner(name: String, pets: List[String]) derives ReadWriter +``` +The `derives` keyword is used to automatically generate given instances. +Using the compiler's knowledge of the fields in `PetOwner`, it generates a `ReadWriter[PetOwner]`. +{% endtab %} +{% endtabs %} + +This means that you can now write (and read) `PetOwner` objects to JSON with `upickle.default.write(petOwner)`. + +Notice that you do not need to pass the instance of `ReadWriter[PetOwner]` explicitly to the `write` method. But it does, nevertheless, get it from the context, as "given" value. You may find more information about contextual abstractions in the [Scala 3 Book](https://docs.scala-lang.org/scala3/book/ca-contextual-abstractions-intro.html). + +Putting everything together you should get: + +{% tabs 'full' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import upickle.default._ + +case class PetOwner(name: String, pets: List[String]) +implicit val ownerRw: ReadWriter[PetOwner] = macroRW + +val petOwner = PetOwner("Peter", List("Toolkitty", "Scaniel")) +val json: String = write(petOwner) +println(json) +// prints: {"name":"Peter","pets":["Toolkitty","Scaniel"]}" +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import upickle.default._ + +case class PetOwner(name: String, pets: List[String]) derives ReadWriter + +val petOwner = PetOwner("Peter", List("Toolkitty", "Scaniel")) +val json: String = write(petOwner) +println(json) +// prints: {"name":"Peter","pets":["Toolkitty","Scaniel"]}" +``` +{% endtab %} +{% endtabs %} diff --git a/_overviews/toolkit/json-what-else.md b/_overviews/toolkit/json-what-else.md new file mode 100644 index 0000000000..1f34daffe4 --- /dev/null +++ b/_overviews/toolkit/json-what-else.md @@ -0,0 +1,74 @@ +--- +title: What else can uPickle do? +type: section +description: An incomplete list of features of uPickle +num: 22 +previous-page: json-files +next-page: http-client-intro +--- + +{% include markdown.html path="_markdown/install-upickle.md" %} +## Construct a new JSON structure with uJson + +{% tabs construct%} +{% tab 'Scala 2 and Scala 3' %} +```scala mdoc +val obj: ujson.Value = ujson.Obj( + "library" -> "upickle", + "versions" -> ujson.Arr("1.6.0", "2.0.0", "3.1.0"), + "documentation" -> "https://com-lihaoyi.github.io/upickle/", +) +``` +{% endtab %} +{% endtabs %} + +Learn more about constructing JSON in the [uJson documentation](https://com-lihaoyi.github.io/upickle/#Construction). + +## Defining custom JSON serialization + +You can customize the `ReadWriter` of your data type by mapping the `ujson.Value`, like this: + +{% tabs custom-serializer class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import upickle.default._ + +case class Bar(i: Int, s: String) + +object Bar { + implicit val barReadWriter: ReadWriter[Bar] = readwriter[ujson.Value] + .bimap[Bar]( + x => ujson.Arr(x.s, x.i), + json => new Bar(json(1).num.toInt, json(0).str) + ) +} + +val bar = Bar(5, "bar") +val json = upickle.default.write(bar) +println(json) +// prints: [5, "bar"] +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import upickle.default.* + +case class Bar(i: Int, s: String) + +object Bar: + given ReadWriter[Bar] = readwriter[ujson.Value] + .bimap[Bar]( + x => ujson.Arr(x.s, x.i), + json => new Bar(json(1).num.toInt, json(0).str) + ) + +val bar = Bar(5, "bar") +val json = upickle.default.write(bar) +println(json) +// prints: [5, "bar"] +``` +{% endtab %} +{% endtabs %} + +Learn more about custom JSON serialization in the [uPickle documentation](https://com-lihaoyi.github.io/upickle/#Customization). + diff --git a/_overviews/toolkit/os-intro.md b/_overviews/toolkit/os-intro.md new file mode 100644 index 0000000000..71d30f0c49 --- /dev/null +++ b/_overviews/toolkit/os-intro.md @@ -0,0 +1,20 @@ +--- +title: Working with files and processes with OS-Lib +type: chapter +description: The introduction of the OS-lib library +num: 10 +previous-page: testing-what-else +next-page: os-read-directory +--- + +OS-Lib is a library for manipulating files and processes. It is part of the Scala Toolkit. + +OS-Lib aims to replace the `java.nio.file` and `java.lang.ProcessBuilder` APIs. You should not need to use any underlying Java APIs directly. + +OS-lib also aims to supplant the older `scala.io` and `scala.sys` APIs in the Scala standard library. + +OS-Lib has no dependencies. + +All of OS-Lib is in the `os.*` namespace. + +{% include markdown.html path="_markdown/install-os-lib.md" %} diff --git a/_overviews/toolkit/os-read-directory.md b/_overviews/toolkit/os-read-directory.md new file mode 100644 index 0000000000..b24b664a49 --- /dev/null +++ b/_overviews/toolkit/os-read-directory.md @@ -0,0 +1,59 @@ +--- +title: How to read a directory? +type: section +description: Reading a directory's contents with OS-Lib +num: 11 +previous-page: os-intro +next-page: os-read-file +--- + +{% include markdown.html path="_markdown/install-os-lib.md" %} + +## Paths + +A fundamental data type in OS-Lib is `os.Path`, representing a path +on the filesystem. An `os.Path` is always an absolute path. + +OS-Lib also provides `os.RelPath` (relative paths) and `os.SubPath` (a +relative path which cannot ascend to parent directories). + +Typical starting points for making paths are `os.pwd` (the +current working directory), `os.home` (the current user's home +directory), `os.root` (the root of the filesystem), or +`os.temp.dir()` (a new temporary directory). + +Paths have a `/` method for adding path segments. For example: + +{% tabs 'etc' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val etc: os.Path = os.root / "etc" +``` +{% endtab %} +{% endtabs %} + +## Reading a directory + +`os.list` returns the contents of a directory: + +{% tabs 'list-etc' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val entries: Seq[os.Path] = os.list(os.root / "etc") +``` +{% endtab %} +{% endtabs %} + +Or if we only want subdirectories: + +{% tabs 'subdirs' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val dirs: Seq[os.Path] = os.list(os.root / "etc").filter(os.isDir) +``` +{% endtab %} +{% endtabs %} + +To recursively descend an entire subtree, change `os.list` to +`os.walk`. To process results on the fly rather than reading them all +into memory first, substitute `os.walk.stream`. diff --git a/_overviews/toolkit/os-read-file.md b/_overviews/toolkit/os-read-file.md new file mode 100644 index 0000000000..bc23ca2588 --- /dev/null +++ b/_overviews/toolkit/os-read-file.md @@ -0,0 +1,64 @@ +--- +title: How to read a file? +type: section +description: Reading files from disk with OS-Lib +num: 12 +previous-page: os-read-directory +next-page: os-write-file +--- + +{% include markdown.html path="_markdown/install-os-lib.md" %} + +## Reading a file + +Supposing we have the path to a file: + +{% tabs 'path' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val path: os.Path = os.root / "usr" / "share" / "dict" / "words" +``` +{% endtab %} +{% endtabs %} + +Then we can slurp the entire file into a string with `os.read`: + +{% tabs slurp %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:compile-only +val content: String = os.read(path) +``` +{% endtab %} +{% endtabs %} + +To read the file as line at a time, substitute `os.read.lines`. + +We can find the longest word in the dictionary: + +{% tabs lines %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:compile-only +val lines: Seq[String] = os.read.lines(path) +println(lines.maxBy(_.size)) +// prints: antidisestablishmentarianism +``` +{% endtab %} +{% endtabs %} + +There's also `os.read.lines.stream` if you want to process the lines +on the fly rather than read them all into memory at once. For example, +if we just want to read the first line, the most efficient way is: + +{% tabs lines-stream %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:compile-only +val lineStream: geny.Generator[String] = os.read.lines.stream(path) +val firstLine: String = lineStream.head +println(firstLine) +// prints: A +``` +{% endtab %} +{% endtabs %} + +OS-Lib takes care of closing the file once the generator returned +by `stream` is exhausted. diff --git a/_overviews/toolkit/os-run-process.md b/_overviews/toolkit/os-run-process.md new file mode 100644 index 0000000000..7bbe4ace58 --- /dev/null +++ b/_overviews/toolkit/os-run-process.md @@ -0,0 +1,79 @@ +--- +title: How to run a process? +type: section +description: Starting external subprocesses with OS-Lib +num: 14 +previous-page: os-write-file +next-page: os-what-else +--- + +{% include markdown.html path="_markdown/install-os-lib.md" %} + +## Starting an external process + +To set up a process, use `os.proc`, then to actually start it, +`call()`: + +{% tabs 'touch' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:compile-only +val path: os.Path = os.pwd / "output.txt" +println(os.exists(path)) +// prints: false +val result: os.CommandResult = os.proc("touch", path).call() +println(result.exitCode) +// prints: 0 +println(os.exists(path)) +// prints: true +``` +{% endtab %} +{% endtabs %} + +Note that `proc` accepts both strings and `os.Path`s. + +## Reading the output of a process + +(The particular commands in the following examples might not exist on all +machines.) + +Above we saw that `call()` returned an `os.CommandResult`. We can +access the result's entire output with `out.text()`, or as lines +with `out.lines()`. + +For example, we could use `bc` to do some math for us: + +{% tabs 'bc' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:compile-only +val res: os.CommandResult = os.proc("bc", "-e", "2 + 2").call() +val text: String = res.out.text() +println(text.trim.toInt) +// prints: 4 +``` +{% endtab %} +{% endtabs %} + +Or have `cal` show us a calendar: + +{% tabs 'cal' %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:compile-only +val res: os.CommandResult = os.proc("cal", "-h", "2", "2023").call() +res.out.lines().foreach(println) +// prints: +// February 2023 +// Su Mo Tu We Th Fr Sa +// 1 2 3 4 +// ... +``` +{% endtab %} +{% endtabs %} + +## Customizing the process + +`call()` takes various optional arguments, too many to explain +individually here. For example, you can set the working directory +(`cwd = ...`), set environment variables (`env = ...`), or redirect +input and output (`stdin = ...`, `stdout = ...`, `stderr = ...`). +Find more information about the `call` method on [the README of OS-Lib](https://github.com/com-lihaoyi/os-lib#osproccall). + diff --git a/_overviews/toolkit/os-what-else.md b/_overviews/toolkit/os-what-else.md new file mode 100644 index 0000000000..1671540845 --- /dev/null +++ b/_overviews/toolkit/os-what-else.md @@ -0,0 +1,18 @@ +--- +title: What else can OS-Lib do? +type: section +description: An incomplete list of features of OS-Lib +num: 15 +previous-page: os-run-process +next-page: json-intro +--- + +{% include markdown.html path="_markdown/install-os-lib.md" %} + +[OS-Lib on GitHub](https://github.com/com-lihaoyi/os-lib) has many additional examples of how to perform common tasks: +- creating, moving, copying, removing files and folders, +- reading filesystem metadata and permissions, +- spawning subprocesses, +- watching changes in folders. + +See also Chapter 7 of Li Haoyi's book [_Hands-On Scala Programming_](https://www.handsonscala.com). (Li Haoyi is the author of OS-Lib.) diff --git a/_overviews/toolkit/os-write-file.md b/_overviews/toolkit/os-write-file.md new file mode 100644 index 0000000000..2bef6fff0c --- /dev/null +++ b/_overviews/toolkit/os-write-file.md @@ -0,0 +1,54 @@ +--- +title: How to write a file? +type: section +description: Writing files to disk with OS-Lib +num: 13 +previous-page: os-read-file +next-page: os-run-process +--- + +{% include markdown.html path="_markdown/install-os-lib.md" %} + +## Writing a file all at once + +`os.write` writes the supplied string to a new file: + +{% tabs write %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +val path: os.Path = os.temp.dir() / "output.txt" +os.write(path, "hello\nthere\n") +println(os.read.lines(path).size) +// prints: 2 +``` +{% endtab %} +{% endtabs %} + +## Overwriting or appending + +`os.write` throws an exception if the file already exists: + +{% tabs already-exists %} +{% tab 'Scala 2 and 3' %} +```scala mdoc:crash +os.write(path, "this will fail") +// this exception is thrown: +// java.nio.file.FileAlreadyExistsException +``` +{% endtab %} +{% endtabs %} + +To avoid this, use `os.write.over` to replace the existing +contents. + +You can also use `os.write.append` to add more to the end: + +{% tabs append %} +{% tab 'Scala 2 and 3' %} +```scala mdoc +os.write.append(path, "two more\nlines\n") +println(os.read.lines(path).size) +// prints: 4 +``` +{% endtab %} +{% endtabs %} diff --git a/_overviews/toolkit/testing-asynchronous.md b/_overviews/toolkit/testing-asynchronous.md new file mode 100644 index 0000000000..68862cc1cc --- /dev/null +++ b/_overviews/toolkit/testing-asynchronous.md @@ -0,0 +1,87 @@ +--- +title: How to write asynchronous tests? +type: section +description: Writing asynchronous tests using MUnit +num: 7 +previous-page: testing-exceptions +next-page: testing-resources +--- + +{% include markdown.html path="_markdown/install-munit.md" %} + +## Asynchronous tests + +In Scala, it's common for an *asynchronous* method to return a `Future`. +MUnit offers special support for `Future`s. + +For example, consider an asynchronous variant of a `square` method: + +{% tabs 'async-1' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import scala.concurrent.{ExecutionContext, Future} + +object AsyncMathLib { + def square(x: Int)(implicit ec: ExecutionContext): Future[Int] = + Future(x * x) +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import scala.concurrent.{ExecutionContext, Future} + +object AsyncMathLib: + def square(x: Int)(using ExecutionContext): Future[Int] = + Future(x * x) +``` +{% endtab %} +{% endtabs %} + +A test itself can return a `Future[Unit]`. +MUnit will wait behind the scenes for the resulting `Future` to complete, failing the test if any assertion fails. + +You can therefore write the test as follows: + +{% tabs 'async-3' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +// Import the global execution context, required to call async methods +import scala.concurrent.ExecutionContext.Implicits.global + +class AsyncMathLibTests extends munit.FunSuite { + test("square") { + for { + squareOf3 <- AsyncMathLib.square(3) + squareOfMinus4 <- AsyncMathLib.square(-4) + } yield { + assertEquals(squareOf3, 9) + assertEquals(squareOfMinus4, 16) + } + } +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +// Import the global execution context, required to call async methods +import scala.concurrent.ExecutionContext.Implicits.global + +class AsyncMathLibTests extends munit.FunSuite: + test("square"): + for + squareOf3 <- AsyncMathLib.square(3) + squareOfMinus4 <- AsyncMathLib.square(-4) + yield + assertEquals(squareOf3, 9) + assertEquals(squareOfMinus4, 16) +``` +{% endtab %} +{% endtabs %} + +The test first asynchronously computes `square(3)` and `square(-4)`. +Once both computations are completed, and if they are both successful, it proceeds with the calls to `assertEquals`. +If any of the assertion fails, the resulting `Future[Unit]` fails, and MUnit will cause the test to fail. + +You may read more about asynchronous tests [in the MUnit documentation](https://scalameta.org/munit/docs/tests.html#declare-async-test). +It shows how to use other asynchronous types besides `Future`. diff --git a/_overviews/toolkit/testing-exceptions.md b/_overviews/toolkit/testing-exceptions.md new file mode 100644 index 0000000000..0e26e51bd5 --- /dev/null +++ b/_overviews/toolkit/testing-exceptions.md @@ -0,0 +1,65 @@ +--- +title: How to test exceptions? +type: section +description: Describe the intercept assertion +num: 6 +previous-page: testing-run-only +next-page: testing-asynchronous +--- + +{% include markdown.html path="_markdown/install-munit.md" %} + +## Intercepting an exception + +In a test, you can use `intercept` to check that your code throws an exception. + +{% tabs 'intercept-1' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +import java.nio.file.NoSuchFileException + +class FileTests extends munit.FunSuite { + test("read missing file") { + val missingFile = os.pwd / "missing.txt" + + intercept[NoSuchFileException] { + os.read(missingFile) + } + } +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import java.nio.file.NoSuchFileException + +class FileTests extends munit.FunSuite: + test("read missing file"): + val missingFile = os.pwd / "missing.txt" + intercept[NoSuchFileException]: + // the code that should throw an exception + os.read(missingFile) +``` +{% endtab %} +{% endtabs %} + +The type parameter of the `intercept` assertion is the expected exception. +Here it is `NoSuchFileException`. +The body of the `intercept` assertion contains the code that should throw the exception. + +The test passes if the code throws the expected exception and it fails otherwise. + +The `intercept` method returns the exception that is thrown. +You can check more assertions on it. + +{% tabs 'intercept-2' %} +{% tab 'Scala 2 and 3' %} +```scala +val exception = intercept[NoSuchFileException](os.read(missingFile)) +assert(clue(exception.getMessage).contains("missing.txt")) +``` +{% endtab %} +{% endtabs %} + +You can also use the more concise `interceptMessage` method to test the exception and its message in a single assertion. +Learn more about it in the [MUnit documentation](https://scalameta.org/munit/docs/assertions.html#interceptmessage). diff --git a/_overviews/toolkit/testing-intro.md b/_overviews/toolkit/testing-intro.md new file mode 100644 index 0000000000..8aa5021b76 --- /dev/null +++ b/_overviews/toolkit/testing-intro.md @@ -0,0 +1,21 @@ +--- +title: Testing with MUnit +type: chapter +description: The introduction of the MUnit library +num: 2 +previous-page: introduction +next-page: testing-suite +--- + +MUnit is a lightweight testing library. It provides a single style for writing tests, a style that can be learned quickly. + +Despite its simplicity, MUnit has useful features such as: +- assertions to verify the behavior of the program +- fixtures to ensure that the tests have access to all the necessary resources +- asynchronous support, for testing concurrent and distributed applications. + +MUnit produces actionable error reports, with diff and source location, to help you quickly understand failures. + +Testing is essential for any software development process because it helps catch bugs early, improves code quality and facilitates collaboration. + +{% include markdown.html path="_markdown/install-munit.md" %} diff --git a/_overviews/toolkit/testing-resources.md b/_overviews/toolkit/testing-resources.md new file mode 100644 index 0000000000..9e0d45f51f --- /dev/null +++ b/_overviews/toolkit/testing-resources.md @@ -0,0 +1,101 @@ +--- +title: How to manage the resources of a test? +type: section +description: Describe the functional fixtures +num: 8 +previous-page: testing-asynchronous +next-page: testing-what-else +--- + +{% include markdown.html path="_markdown/install-munit.md" %} + +## `FunFixture` + +In MUnit, we use functional fixtures to manage resources in a concise and safe way. +A `FunFixture` creates one resource for each test, ensuring that each test runs in isolation from the others. + +In a test suite, you can define and use a `FunFixture` as follows: + +{% tabs 'resources-1' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +class FileTests extends munit.FunSuite { + val usingTempFile: FunFixture[os.Path] = FunFixture( + setup = _ => os.temp(prefix = "file-tests"), + teardown = tempFile => os.remove(tempFile) + ) + usingTempFile.test("overwrite on file") { tempFile => + os.write.over(tempFile, "Hello, World!") + val obtained = os.read(tempFile) + assertEquals(obtained, "Hello, World!") + } +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +class FileTests extends munit.FunSuite: + val usingTempFile: FunFixture[os.Path] = FunFixture( + setup = _ => os.temp(prefix = "file-tests"), + teardown = tempFile => os.remove(tempFile) + ) + usingTempFile.test("overwrite on file") { tempFile => + os.write.over(tempFile, "Hello, World!") + val obtained = os.read(tempFile) + assertEquals(obtained, "Hello, World!") + } +``` +{% endtab %} +{% endtabs %} + +`usingTempFile` is a fixture of type `FunFixture[os.Path]`. +It contains two functions: + - The `setup` function, of type `TestOptions => os.Path`, creates a new temporary file. + - The `teardown` function, of type `os.Path => Unit`, deletes this temporary file. + +We use the `usingTempFile` fixture to define a test that needs a temporary file. +Notice that the body of the test takes a `tempFile`, of type `os.Path`, as parameter. +The fixture automatically creates this temporary file, calls its `setup` function, and cleans it up after the test by calling `teardown`. + +In the example, we used a fixture to manage a temporary file. +In general, fixtures can manage other kinds of resources, such as a temporary folder, a temporary table in a database, a connection to a local server, and so on. + +## Composing `FunFixture`s + +In some tests, you may need more than one resource. +You can use `FunFixture.map2` to compose two functional fixtures into one. + +{% tabs 'resources-2' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val using2TempFiles: FunFixture[(os.Path, os.Path)] = + FunFixture.map2(usingTempFile, usingTempFile) + +using2TempFiles.test("merge two files") { + (file1, file2) => + // body of the test +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +val using2TempFiles: FunFixture[(os.Path, os.Path)] = + FunFixture.map2(usingTempFile, usingTempFile) + +using2TempFiles.test("merge two files"): + (file1, file2) => + // body of the test +``` +{% endtab %} +{% endtabs %} + +Using `FunFixture.map2` on a `FunFixture[A]` and a `FunFixture[B]` returns a `FunFixture[(A, B)]`. + +## Other fixtures + +`FunFixture` is the recommended type of fixture because: +- it is explicit: each test declares the resource they need, +- it is safe to use: each test uses its own resource in isolation. + +For more flexibility, `MUnit` contains other types of fixtures: the reusable fixture, the ad-hoc fixture and the asynchronous fixture. +Learn more about them in the [MUnit documentation](https://scalameta.org/munit/docs/fixtures.html). diff --git a/_overviews/toolkit/testing-run-only.md b/_overviews/toolkit/testing-run-only.md new file mode 100644 index 0000000000..af6ba02cd7 --- /dev/null +++ b/_overviews/toolkit/testing-run-only.md @@ -0,0 +1,106 @@ +--- +title: How to run a single test? +type: section +description: About testOnly in the build tool and .only in MUnit +num: 5 +previous-page: testing-run +next-page: testing-exceptions +--- + +{% include markdown.html path="_markdown/install-munit.md" %} + +## Running a single test suite + +{% tabs munit-unit-test-only class=tabs-build-tool %} +{% tab 'Scala CLI' %} +To run a single `example.MyTests` suite with Scala CLI, use the `--test-only` option of the `test` command. +``` +scala-cli test example --test-only example.MyTests +``` + +{% endtab %} +{% tab 'sbt' %} +To run a single `example.MyTests` suite in sbt, use the `testOnly` task: +``` +sbt:example> example/testOnly example.MyTests +``` +{% endtab %} +{% tab 'Mill' %} +To run a single `example.MyTests` suite in Mill, use the `testOnly` task: +``` +./mill example.test.testOnly example.MyTests +``` +{% endtab %} +{% endtabs %} + +## Running a single test in a test suite + +Within a test suite file, you can select individual tests to run by temporarily appending `.only`, e.g. + +{% tabs 'only-demo' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc +class MathSuite extends munit.FunSuite { + test("addition") { + assert(1 + 1 == 2) + } + test("multiplication".only) { + assert(3 * 7 == 21) + } +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +class MathSuite extends munit.FunSuite: + test("addition"): + assert(1 + 1 == 2) + test("multiplication".only): + assert(3 * 7 == 21) +``` +{% endtab %} +{% endtabs %} + +In the above example, only the `"multiplication"` tests will run (i.e. `"addition"` is ignored). +This is useful to quickly debug a specific test in a suite. + +## Alternative: excluding specific tests + +You can exclude specific tests from running by appending `.ignore` to the test name. +For example the following ignores the `"addition"` test, and run all the others: + +{% tabs 'ignore-demo' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala mdoc:reset +class MathSuite extends munit.FunSuite { + test("addition".ignore) { + assert(1 + 1 == 2) + } + test("multiplication") { + assert(3 * 7 == 21) + } + test("remainder") { + assert(13 % 5 == 3) + } +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +class MathSuite extends munit.FunSuite: + test("addition".ignore): + assert(1 + 1 == 2) + test("multiplication"): + assert(3 * 7 == 21) + test("remainder"): + assert(13 % 5 == 3) +``` +{% endtab %} +{% endtabs %} + +## Use tags to group tests, and run specific tags + +MUnit lets you group and run tests across suites by tags, which are textual labels. +[The MUnit docs][munit-tags] have instructions on how to do this. + +[munit-tags]: https://scalameta.org/munit/docs/filtering.html#include-and-exclude-tests-based-on-tags diff --git a/_overviews/toolkit/testing-run.md b/_overviews/toolkit/testing-run.md new file mode 100644 index 0000000000..cb3fde0ade --- /dev/null +++ b/_overviews/toolkit/testing-run.md @@ -0,0 +1,91 @@ +--- +title: How to run tests? +type: section +description: Running the MUnit tests +num: 4 +previous-page: testing-suite +next-page: testing-run-only +--- + +{% include markdown.html path="_markdown/install-munit.md" %} + +## Running the tests + +You can run all of your test suites with a single command. + +{% tabs munit-unit-test-4 class=tabs-build-tool %} +{% tab 'Scala CLI' %} +Using Scala CLI, the following command runs all the tests in the folder `example`: +``` +scala-cli test example +# Compiling project (test, Scala 3.2.1, JVM) +# Compiled project (test, Scala 3.2.1, JVM) +# MyTests: +# + sum of two integers 0.009s +``` +{% endtab %} +{% tab 'sbt' %} +In the sbt shell, the following command runs all the tests of the project `example`: +``` +sbt:example> example/test +# MyTests: +# + sum of two integers 0.006s +# [info] Passed: Total 1, Failed 0, Errors 0, Passed 1 +# [success] Total time: 0 s, completed Nov 11, 2022 12:54:08 PM +``` +{% endtab %} +{% tab 'Mill' %} +In Mill, the following command runs all the tests of the module `example`: +``` +./mill example.test.test +# [71/71] example.test.test +# MyTests: +# + sum of two integers 0.008s +``` +{% endtab %} +{% endtabs %} + +The test report, printed in the console, shows the status of each test. +The `+` symbol before a test name shows that the test passed successfully. + +Add and run a failing test to see how a failure looks: + +{% tabs assertions-1 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +test("failing test") { + val obtained = 2 + 3 + val expected = 4 + assertEquals(obtained, expected) +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +test("failing test"): + val obtained = 2 + 3 + val expected = 4 + assertEquals(obtained, expected) +``` +{% endtab %} +{% endtabs %} + +``` +# MyTests: +# + sum of two integers 0.008s +# ==> X MyTests.failing test 0.015s munit.ComparisonFailException: ./example/MyTests.test.scala:13 +# 12: val expected = 4 +# 13: assertEquals(obtained, expected) +# 14: } +# values are not the same +# => Obtained +# 5 +# => Diff (- obtained, + expected) +# -5 +# +4 +# at munit.Assertions.failComparison(Assertions.scala:274) +``` + +The line starting with `==> X` indicates that the test named `failing test` fails. +The following lines show where and how it failed. +Here it shows that the obtained value is 5, where 4 was expected. diff --git a/_overviews/toolkit/testing-suite.md b/_overviews/toolkit/testing-suite.md new file mode 100644 index 0000000000..8b17de43a6 --- /dev/null +++ b/_overviews/toolkit/testing-suite.md @@ -0,0 +1,128 @@ +--- +title: How to write tests? +type: section +description: The basics of writing a test suite with MUnit +num: 3 +previous-page: testing-intro +next-page: testing-run +--- + +{% include markdown.html path="_markdown/install-munit.md" %} + +## Writing a test suite + +A group of tests in a single class is called a test class or test suite. + +Each test suite validates a particular component or feature of the software. +Typically we define one test suite for each source file or class that we want to test. + +{% tabs munit-unit-test-2 class=tabs-build-tool %} +{% tab 'Scala CLI' %} +In Scala CLI, the test file can live in the same folder as the actual code, but the name of the file must end with `.test.scala`. +In the following, `MyTests.test.scala` is a test file. +``` +example/ +├── MyApp.scala +└── MyTests.test.scala +``` +Other valid structures and conventions are described in the [Scala CLI documentation](https://scala-cli.virtuslab.org/docs/commands/test/#test-sources). +{% endtab %} +{% tab 'sbt' %} +In sbt, test sources go in the `src/test/scala` folder. + +For instance, the following is the file structure of a project `example`: +``` +example +└── src + ├── main + │ └── scala + │ └── MyApp.scala + └── test + └── scala + └── MyTests.scala +``` +{% endtab %} +{% tab 'Mill' %} +In Mill, test sources go in the `test/src` folder. + +For instance, the following is the file structure of a module `example`: +``` +example +└── src +| └── MyApp.scala +└── test + └── src + └── MyTests.scala +``` +{% endtab %} +{% endtabs %} + +In the test source file, define a suite containing a single test: + +{% tabs munit-unit-test-3 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +package example + +class MyTests extends munit.FunSuite { + test("sum of two integers") { + val obtained = 2 + 2 + val expected = 4 + assertEquals(obtained, expected) + } +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +package example + +class MyTests extends munit.FunSuite: + test("sum of two integers"): + val obtained = 2 + 2 + val expected = 4 + assertEquals(obtained, expected) +``` +{% endtab %} +{% endtabs %} + +A test suite is a Scala class that extends `munit.FunSuite`. +It contains one or more tests, each defined by a call to the `test` method. + +In the previous example, we have a single test `"sum of integers"` that checks that `2 + 2` equals `4`. +We use the assertion method `assertEquals` to check that two values are equal. +The test passes if all the assertions are correct and fails otherwise. + +## Assertions + +It is important to use assertions in each and every test to describe what to check. +The main assertion methods in MUnit are: +- `assertEquals` to check that what you obtain is equal to what you expected +- `assert` to check a boolean condition + +The following is an example of a test that use `assert` to check a boolean condition on a list. + +{% tabs assertions-1 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +test("all even numbers") { + val input: List[Int] = List(1, 2, 3, 4) + val obtainedResults: List[Int] = input.map(_ * 2_) + // check that obtained values are all even numbers + assert(obtainedResults.forall(x => x % 2 == 0)) +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +test("all even numbers"): + val input: List[Int] = List(1, 2, 3, 4) + val obtainedResults: List[Int] = input.map(_ * 2_) + // check that obtained values are all even numbers + assert(obtainedResults.forall(x => x % 2 == 0)) +``` +{% endtab %} +{% endtabs %} + +MUnit contains more assertion methods that you can discover in its [documentation](https://scalameta.org/munit/docs/assertions.html): +`assertNotEquals`, `assertNoDiff`, `fail`, and `compileErrors`. diff --git a/_overviews/toolkit/testing-what-else.md b/_overviews/toolkit/testing-what-else.md new file mode 100644 index 0000000000..305765ec30 --- /dev/null +++ b/_overviews/toolkit/testing-what-else.md @@ -0,0 +1,83 @@ +--- +title: What else can MUnit do? +type: section +description: A incomplete list of features of MUnit +num: 9 +previous-page: testing-resources +next-page: os-intro +--- + +{% include markdown.html path="_markdown/install-munit.md" %} + +## Adding clues to get better error report + +Use `clue` inside an `assert` to a get a better error report when the assertion fails. + +{% tabs clues %} +{% tab 'Scala 2 and 3' %} +```scala +assert(clue(List(a).head) > clue(b)) +// munit.FailException: assertion failed +// Clues { +// List(a).head: Int = 1 +// b: Int = 2 +// } +``` +{% endtab %} +{% endtabs %} + +Learn more about clues in the [MUnit documentation](https://scalameta.org/munit/docs/assertions.html#assert). + +## Writing environment-specific tests + +Use `assume` to write environment-specific tests. +`assume` can contain a boolean condition. You can check the operating system, the Java version, a Java property, an environment variable, or anything else. +A test is skipped if one of its assumptions isn't met. + +{% tabs assumption class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import scala.util.Properties + +test("home directory") { + assume(Properties.isLinux, "this test runs only on Linux") + assert(os.home.toString.startsWith("/home/")) +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import scala.util.Properties + +test("home directory"): + assume(Properties.isLinux, "this test runs only on Linux") + assert(os.home.toString.startsWith("/home/")) +``` +{% endtab %} +{% endtabs %} + +Learn more about filtering tests in the [MUnit documentation](https://scalameta.org/munit/docs/filtering.html). + +## Tagging flaky tests + +You can tag a test with `flaky` to mark it as being flaky. +Flaky tests can be skipped by setting the `MUNIT_FLAKY_OK` environment variable to `true`. + +{% tabs flaky class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +test("requests".flaky) { + // I/O heavy tests that sometimes fail +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +test("requests".flaky): + // I/O heavy tests that sometimes fail +``` +{% endtab %} +{% endtabs %} + +Learn more about flaky tests in the [MUnit documentation](https://scalameta.org/munit/docs/tests.html#tag-flaky-tests) + diff --git a/_plugins/jekyll-tabs-lib/jekyll-tabs-4scala.rb b/_plugins/jekyll-tabs-lib/jekyll-tabs-4scala.rb index eee013d138..b592fcc7f9 100644 --- a/_plugins/jekyll-tabs-lib/jekyll-tabs-4scala.rb +++ b/_plugins/jekyll-tabs-lib/jekyll-tabs-4scala.rb @@ -4,6 +4,7 @@ module Jekyll module Tabs ScalaVersions = ['Scala 2', 'Scala 3'] + BuildTools = ['Scala CLI', 'sbt', 'Mill'] def self.unquote(string) string.gsub(/^['"]|['"]$/, '') @@ -25,13 +26,11 @@ def initialize(block_name, markup, tokens) if markup =~ SYNTAX @name = Tabs::unquote($1) @css_classes = "" - @is_scala_tabs = false + @tab_class = "" if $2 css_class = Tabs::unquote($2) css_class.strip! - if css_class == "tabs-scala-version" - @is_scala_tabs = true - end + @tab_class = css_class # append $2 to @css_classes @css_classes = " #{css_class}" end @@ -56,36 +55,36 @@ def render(context) seenTabs = [] - def joinScalaVersions() - Tabs::ScalaVersions.to_a.map{|item| "'#{item}'"}.join(", ") + def joinTabs(tabs) + tabs.to_a.map{|item| "'#{item}'"}.join(", ") end - def errorNonScalaVersion(tab) + def errorInvalidTab(tab, expectedTabs) SyntaxError.new( - "Scala version tab label '#{tab.label}' is not valid for tabs '#{@name}' with " + - "class=tabs-scala-version. Valid tab labels are: #{joinScalaVersions()}") + "Tab label '#{tab.label}' is not valid for tabs '#{@name}' with " + + "class=#{@tab_class}. Valid tab labels are: #{joinTabs(expectedTabs)}") end - def errorScalaVersionWithoutClass(tab) + def errorTabWithoutClass(tab, tabClass) SyntaxError.new( - "Scala version tab label '#{tab.label}' is not valid for tabs '#{@name}' without " + - "class=tabs-scala-version") + "Tab label '#{tab.label}' is not valid for tabs '#{@name}' without " + + "class=#{tabClass}") end - def errorMissingScalaVersion() + def errorMissingTab(expectedTabs) SyntaxError.new( - "Tabs '#{@name}' with class=tabs-scala-version must have exactly the following " + - "tab labels: #{joinScalaVersions()}") + "Tabs '#{@name}' with class=#{@tab_class} must have exactly the following " + + "tab labels: #{joinTabs(expectedTabs)}") end def errorDuplicateTab(tab) SyntaxError.new("Duplicate tab label '#{tab.label}' in tabs '#{@name}'") end - def errorScalaVersionDefault(tab) + def errorTabDefault(tab) SyntaxError.new( - "Scala version tab label '#{tab.label}' should not be default for tabs '#{@name}' " + - "with class=tabs-scala-version") + "Tab label '#{tab.label}' should not be default for tabs '#{@name}' " + + "with class=#{@tab_class}") end allTabs.each do | tab | @@ -97,25 +96,34 @@ def errorScalaVersionDefault(tab) foundDefault = true end - isScalaTab = Tabs::ScalaVersions.include? tab.label - - if @is_scala_tabs - if !isScalaTab - raise errorNonScalaVersion(tab) - elsif tab.defaultTab - raise errorScalaVersionDefault(tab) + def checkTab(tab, tabClass, expectedTabs, raiseIfMissingClass) + isValid = expectedTabs.include? tab.label + if @tab_class == tabClass + if !isValid + raise errorInvalidTab(tab, expectedTabs) + elsif tab.defaultTab + raise errorTabDefault(tab) + end + elsif raiseIfMissingClass and isValid + raise errorTabWithoutClass(tab, tabClass) end - elsif !@is_scala_tabs and isScalaTab - raise errorScalaVersionWithoutClass(tab) end + + checkTab(tab, "tabs-scala-version", Tabs::ScalaVersions, true) + checkTab(tab, "tabs-build-tool", Tabs::BuildTools, false) end - if @is_scala_tabs and seenTabs != Tabs::ScalaVersions - raise errorMissingScalaVersion() + def checkExhaustivity(seenTabs, tabClass, expectedTabs) + if @tab_class == tabClass and seenTabs != expectedTabs + raise errorMissingTab(expectedTabs) + end end + checkExhaustivity(seenTabs, "tabs-scala-version", Tabs::ScalaVersions) + checkExhaustivity(seenTabs, "tabs-build-tool", Tabs::BuildTools) + if !foundDefault and allTabs.length > 0 - if @is_scala_tabs + if @tab_class == "tabs-scala-version" # set last tab to default ('Scala 3') allTabs[-1].defaultTab = true else diff --git a/_plugins/mdoc_replace.rb b/_plugins/mdoc_replace.rb index 0b62828227..a4d8bf6e11 100644 --- a/_plugins/mdoc_replace.rb +++ b/_plugins/mdoc_replace.rb @@ -12,6 +12,7 @@ def output_ext(ext) end def convert(content) + content = content.gsub("```scala mdoc:compile-only\n", "```scala\n") content = content.gsub("```scala mdoc:fail\n", "```scala\n") content = content.gsub("```scala mdoc:crash\n", "```scala\n") content = content.gsub("```scala mdoc:nest\n", "```scala\n") diff --git a/index.md b/index.md index 4f97d4d051..2ec3031c68 100644 --- a/index.md +++ b/index.md @@ -26,6 +26,10 @@ sections: description: "Learn Scala by reading a series of short lessons." icon: "fa fa-book-open" link: /scala3/book/introduction.html + - title: "Scala Toolkit" + description: "Sending HTTP requests, writing files, running processes, parsing JSON..." + icon: "fa fa-toolbox" + link: /toolkit/introduction.html - title: Online Courses description: "MOOCs to learn Scala, for beginners and experienced programmers." icon: "fa fa-cloud" diff --git a/resources/js/functions.js b/resources/js/functions.js index c31e52b22e..8dd9e9ec76 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -415,37 +415,36 @@ $(document).ready(function() { }); }; - /** Links all tabs created in Liquid templates with class ".tabs-scala-version" + function activateTab(tabs, value) { + // check the code tab corresponding to the preferred value + tabs.find('input[data-target=' + value + ']').prop("checked", true); + } + + /** Links all tabs created in Liquid templates with class ".tabs-$namespace" * on the page together, such that - * changing a tab to `Scala 2` will activate all other tab sections to - * also change to "Scala 2". - * Also records a preference for the Scala version in localStorage, so + * changing a tab to some value will activate all other tab sections to + * also change to that value. + * Also records a preference for the tab in localStorage, so * that when the page is refreshed, the same tab will be selected. - * On page load, selects the tab corresponding to stored Scala version. + * On page load, selects the tab corresponding to stored value. */ - function setupScalaVersionTabs(scalaVersionTabs) { - const DocsPreferences = Storage('org.scala-lang.docs.preferences'); - const Scala3 = 'scala-3'; - const scalaVersion = DocsPreferences.getPreference('scalaVersion', Scala3); - - function activateTab(tabs, scalaVersion) { - // click the code tab corresponding to the preferred Scala version. - tabs.find('input[data-target=' + scalaVersion + ']').prop("checked", true); - } - - activateTab(scalaVersionTabs, scalaVersion); + function setupTabs(tabs, namespace, defaultValue) { + const PreferenceStorage = Storage('org.scala-lang.docs.preferences'); + const preferredValue = PreferenceStorage.getPreference(namespace, defaultValue); + + activateTab(tabs, preferredValue) // setup listeners to record new preferred Scala version. - scalaVersionTabs.find('input').on('change', function() { + tabs.find('input').on('change', function() { // if checked then set the preferred version, and activate the other tabs on page. if ($(this).is(':checked')) { const parent = $(this).parent(); - const scalaVersion = $(this).data('target'); + const newValue = $(this).data('target'); - DocsPreferences.setPreference('scalaVersion', scalaVersion, oldValue => { + PreferenceStorage.setPreference(namespace, newValue, oldValue => { // when we set a new scalaVersion, find scalaVersionTabs except current one // and activate those tabs. - activateTab(scalaVersionTabs.not(parent), scalaVersion); + activateTab(tabs.not(parent), newValue); }); } @@ -456,7 +455,11 @@ $(document).ready(function() { if (storageAvailable('localStorage')) { var scalaVersionTabs = $(".tabsection.tabs-scala-version"); if (scalaVersionTabs.length) { - setupScalaVersionTabs(scalaVersionTabs); + setupTabs(scalaVersionTabs, "scalaVersion", "scala-3"); + } + var buildToolTabs = $(".tabsection.tabs-build-tool"); + if (buildToolTabs.length) { + setupTabs(buildToolTabs, "buildTool", "scala-cli"); } } diff --git a/scripts/run-mdoc.sh b/scripts/run-mdoc.sh index 32e7d23d2c..a4f4acbe2a 100755 --- a/scripts/run-mdoc.sh +++ b/scripts/run-mdoc.sh @@ -1,10 +1,15 @@ #!/bin/bash set -eux -cs launch org.scalameta:mdoc_2.13:2.3.3 -- \ +cs launch --scala-version 2.13.10 org.scalameta::mdoc:2.3.3 -- \ --in . \ --out /tmp/mdoc-out/ \ - --classpath $(cs fetch -p com.chuusai:shapeless_2.13:2.3.10) \ + --classpath \ + $(cs fetch --scala-version 2.13.10 -p \ + com.chuusai::shapeless:2.3.10 \ + org.scala-lang::toolkit:0.1.7 \ + org.scala-lang::toolkit-test:0.1.7 \ + ) \ --scalac-options "-Xfatal-warnings -feature" \ --no-link-hygiene \ --include '**.md' From d47c4a9615e12c649ceb3a19d566e7f736dbfa8a Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Wed, 10 May 2023 11:16:22 +0300 Subject: [PATCH 2601/3075] Refresh _ru/tour/higher-order-functions.md (#2794) --- _ru/tour/higher-order-functions.md | 156 +++++++++++++++++++++++++++-- 1 file changed, 147 insertions(+), 9 deletions(-) diff --git a/_ru/tour/higher-order-functions.md b/_ru/tour/higher-order-functions.md index 2b029a6ca1..b55b4d9b24 100644 --- a/_ru/tour/higher-order-functions.md +++ b/_ru/tour/higher-order-functions.md @@ -8,34 +8,73 @@ next-page: nested-functions previous-page: mixin-class-composition --- -Функции высшего порядка могут принимать другие функции в качестве параметров или возвращать функцию в качестве результата. -Такое возможно поскольку функции являются объектами первого класса в Scala. -На текущем этапе терминология может казаться немного запутанной, мы используем следующую фразу "функция высшего порядка" как для методов, так и для функций, которые могут принимать другие функции в качестве параметров, или возвращать функции в качестве результата. +Функции высшего порядка могут принимать другие функции в качестве параметров или возвращать функцию в качестве результата. +Такое возможно поскольку функции являются объектами первого класса в Scala. +На текущем этапе терминология может казаться немного запутанной, мы используем следующую фразу "функция высшего порядка" как для методов, так и для функций, которые могут принимать другие функции в качестве параметров, или возвращать функции в качестве результата. -Одним из наиболее распространенных примеров функции высшего порядка +В чисто объектно-ориентированном мире рекомендуется избегать раскрытия методов, +параметризованных функциями, которые могут привести к утечке внутреннего состояния объекта. +Утечка внутреннего состояния может нарушить инварианты самого объекта, тем самым нарушив инкапсуляцию. + +Одним из наиболее распространенных примеров функции высшего порядка является функция `map`, которая доступна в коллекциях Scala. -```scala mdoc -val salaries = Seq(20000, 70000, 40000) + +{% tabs map_example_1 %} + +{% tab 'Scala 2 и 3' for=map_example_1 %} + +```scala mdoc:nest +val salaries = Seq(20_000, 70_000, 40_000) val doubleSalary = (x: Int) => x * 2 val newSalaries = salaries.map(doubleSalary) // List(40000, 140000, 80000) ``` + +{% endtab %} + +{% endtabs %} + `doubleSalary` - это функция, которая принимает один Int `x` и возвращает `x * 2`. В общем случае, кортеж (список имен в скобках) слева от стрелки `=>` - это список параметров, а значение выражения следует справа. Это же значение возвращается в качестве результата. В строке 3 к каждому элементу списка зарплат (salaries) применяется функция `doubleSalary`. Чтобы сократить код, мы можем сделать функцию анонимной и передать ее напрямую в качестве аргумента в map: + +{% tabs map_example_2 %} + +{% tab 'Scala 2 и 3' for=map_example_2 %} + ```scala mdoc:nest -val salaries = Seq(20000, 70000, 40000) +val salaries = Seq(20_000, 70_000, 40_000) val newSalaries = salaries.map(x => x * 2) // List(40000, 140000, 80000) ``` + +{% endtab %} + +{% endtabs %} + Обратите внимание, что в приведенном выше примере `x`не объявлен как `Int`. Это потому, что компилятор может вывести тип, основываясь на типе который ожидает функция map. Еще более элегантным способом написания этого же кода было бы таким: +{% tabs map_example_3 %} + +{% tab 'Scala 2 и 3' for=map_example_3 %} + ```scala mdoc:nest -val salaries = Seq(20000, 70000, 40000) +val salaries = Seq(20_000, 70_000, 40_000) val newSalaries = salaries.map(_ * 2) ``` + +{% endtab %} + +{% endtabs %} + Поскольку компилятор Scala уже знает тип параметров (Int), вам нужно только указать правую часть функции. Единственное условие заключается в том, что вместо имени параметра необходимо использовать `_` (в предыдущем примере это было `x`). ## Преобразование методов в функции + Также возможно передавать методы в качестве аргументов функциям более высокого порядка, поскольку компилятор Scala может преобразовать метод в функцию. + +{% tabs Coercing_methods_into_functions class=tabs-scala-version %} + +{% tab 'Scala 2' for=Coercing_methods_into_functions %} + ```scala mdoc case class WeeklyWeatherForecast(temperatures: Seq[Double]) { @@ -44,11 +83,33 @@ case class WeeklyWeatherForecast(temperatures: Seq[Double]) { def forecastInFahrenheit: Seq[Double] = temperatures.map(convertCtoF) // <-- передается метод convertCtoF } ``` + +{% endtab %} + +{% tab 'Scala 3' for=Coercing_methods_into_functions %} + +```scala +case class WeeklyWeatherForecast(temperatures: Seq[Double]): + + private def convertCtoF(temp: Double) = temp * 1.8 + 32 + + def forecastInFahrenheit: Seq[Double] = temperatures.map(convertCtoF) // <-- передается метод convertCtoF +``` + +{% endtab %} + +{% endtabs %} + Здесь метод `convertCtoF` передается в `forecastInFahrenheit`. Это возможно, потому что компилятор преобразовывает `convertCtoF` в функцию `x => ConvertCtoF(x)` (примечание: `x` будет сгенерированным именем, которое гарантированно будет уникальным в рамках своей области видимости). ## Функции, которые принимают функции + Одной из причин использования функций высшего порядка является сокращение избыточного кода. Допустим, вам нужны какие-то методы, которые могли бы повышать чью-то зарплату по разным условиям. Без создания функции высшего порядка это могло бы выглядеть примерно так: +{% tabs Functions_that_accept_functions_1 class=tabs-scala-version %} + +{% tab 'Scala 2' for=Functions_that_accept_functions_1 %} + ```scala mdoc object SalaryRaiser { @@ -63,8 +124,33 @@ object SalaryRaiser { } ``` +{% endtab %} + +{% tab 'Scala 3' for=Functions_that_accept_functions_1 %} + +```scala +object SalaryRaiser: + + def smallPromotion(salaries: List[Double]): List[Double] = + salaries.map(salary => salary * 1.1) + + def greatPromotion(salaries: List[Double]): List[Double] = + salaries.map(salary => salary * math.log(salary)) + + def hugePromotion(salaries: List[Double]): List[Double] = + salaries.map(salary => salary * salary) +``` + +{% endtab %} + +{% endtabs %} + Обратите внимание, что каждый из этих трех методов отличается только коэффициентом умножения. Для упрощения можно перенести повторяющийся код в функцию высшего порядка: +{% tabs Functions_that_accept_functions_2 class=tabs-scala-version %} + +{% tab 'Scala 2' for=Functions_that_accept_functions_2 %} + ```scala mdoc:nest object SalaryRaiser { @@ -74,7 +160,7 @@ object SalaryRaiser { def smallPromotion(salaries: List[Double]): List[Double] = promotion(salaries, salary => salary * 1.1) - def bigPromotion(salaries: List[Double]): List[Double] = + def greatPromotion(salaries: List[Double]): List[Double] = promotion(salaries, salary => salary * math.log(salary)) def hugePromotion(salaries: List[Double]): List[Double] = @@ -82,12 +168,44 @@ object SalaryRaiser { } ``` +{% endtab %} + +{% tab 'Scala 3' for=Functions_that_accept_functions_2 %} + +```scala +object SalaryRaiser: + + private def promotion(salaries: List[Double], promotionFunction: Double => Double): List[Double] = + salaries.map(promotionFunction) + + def smallPromotion(salaries: List[Double]): List[Double] = + promotion(salaries, salary => salary * 1.1) + + def greatPromotion(salaries: List[Double]): List[Double] = + promotion(salaries, salary => salary * math.log(salary)) + + def hugePromotion(salaries: List[Double]): List[Double] = + promotion(salaries, salary => salary * salary) +``` + +{% endtab %} + +{% endtabs %} + Новый метод, `promotion`, берет зарплату и функцию типа `Double => Double` (т.е. функция, которая берет Double и возвращает Double) и возвращает их произведение. +Методы и функции обычно выражают поведение или преобразование данных, поэтому наличие функций, +которые компонуются на основе других функций, может помочь в создании общих механизмов. +Эти типовые функции откладывают блокировку всего поведения операции, +предоставляя клиентам возможность контролировать или дополнительно настраивать части самой операции. ## Функции, возвращающие функции Есть определенные случаи, когда вы хотите сгенерировать функцию. Вот пример метода, который возвращает функцию. +{% tabs Functions_that_return_functions class=tabs-scala-version %} + +{% tab 'Scala 2' for=Functions_that_return_functions %} + ```scala mdoc def urlBuilder(ssl: Boolean, domainName: String): (String, String) => String = { val schema = if (ssl) "https://" else "http://" @@ -101,4 +219,24 @@ val query = "id=1" val url = getURL(endpoint, query) // "https://www.example.com/users?id=1": String ``` +{% endtab %} + +{% tab 'Scala 3' for=Functions_that_return_functions %} + +```scala +def urlBuilder(ssl: Boolean, domainName: String): (String, String) => String = + val schema = if ssl then "https://" else "http://" + (endpoint: String, query: String) => s"$schema$domainName/$endpoint?$query" + +val domainName = "www.example.com" +def getURL = urlBuilder(ssl=true, domainName) +val endpoint = "users" +val query = "id=1" +val url = getURL(endpoint, query) // "https://www.example.com/users?id=1": String +``` + +{% endtab %} + +{% endtabs %} + Обратите внимание, что возвращаемый тип urlBuilder`(String, String) => String`. Это означает, что возвращаемая анонимная функция принимает две строки и возвращает строку. В нашем случае возвращаемая анонимная функция `(endpoint: String, query: String) => s"https://www.example.com/$endpoint?$query"`. From 5f67b8dba5aafd5a1b767360fdaaf54073c613ae Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Wed, 10 May 2023 11:18:27 +0300 Subject: [PATCH 2602/3075] Refresh _ru/tour/mixin-class-composition.md (#2793) --- _ru/tour/mixin-class-composition.md | 142 +++++++++++++++++++++++++--- 1 file changed, 131 insertions(+), 11 deletions(-) diff --git a/_ru/tour/mixin-class-composition.md b/_ru/tour/mixin-class-composition.md index c27a2edea1..d8cbb24f30 100644 --- a/_ru/tour/mixin-class-composition.md +++ b/_ru/tour/mixin-class-composition.md @@ -1,6 +1,6 @@ --- layout: tour -title: Композиция классов с примесями +title: Композиция классов с трейтами partof: scala-tour num: 7 language: ru @@ -8,8 +8,13 @@ next-page: higher-order-functions previous-page: tuples prerequisite-knowledge: inheritance, traits, abstract-classes, unified-types --- + Примеси (Mixin) - это трейты, которые используются для создания класса. +{% tabs mixin-first-exemple class=tabs-scala-version %} + +{% tab 'Scala 2' for=mixin-first-exemple %} + ```scala mdoc abstract class A { val message: String @@ -26,10 +31,44 @@ val d = new D println(d.message) // I'm an instance of class B println(d.loudMessage) // I'M AN INSTANCE OF CLASS B ``` -У класса `D` есть суперкласс `B` и примесь `C`. Классы могут иметь только один суперкласс, но много примесей (используя ключевыое слово `extends` и `with` соответственно). Примеси и суперкласс могут иметь один и тот же супертип. + +У класса `D` есть суперкласс `B` и трейт `C`. +Классы могут иметь только один суперкласс, но много трейтов (используя ключевое слово `extends` и `with` соответственно). +Трейты и суперкласс могут иметь один и тот же супертип. + +{% endtab %} + +{% tab 'Scala 3' for=mixin-first-exemple %} + +```scala +abstract class A: + val message: String +class B extends A: + val message = "I'm an instance of class B" +trait C extends A: + def loudMessage = message.toUpperCase() +class D extends B, C + +val d = D() +println(d.message) // I'm an instance of class B +println(d.loudMessage) // I'M AN INSTANCE OF CLASS B +``` + +У класса `D` есть суперкласс `B` и трейт `C`. +Классы могут иметь только один суперкласс, но много трейтов +(используя ключевое слово `extends` и разделитель `,` соответственно). +Трейты и суперкласс могут иметь один и тот же супертип. + +{% endtab %} + +{% endtabs %} Теперь давайте рассмотрим более интересный пример, начиная с абстрактного класса: +{% tabs mixin-abstract-iterator class=tabs-scala-version %} + +{% tab 'Scala 2' for=mixin-abstract-iterator %} + ```scala mdoc abstract class AbsIterator { type T @@ -37,10 +76,30 @@ abstract class AbsIterator { def next(): T } ``` + +{% endtab %} + +{% tab 'Scala 3' for=mixin-abstract-iterator %} + +```scala +abstract class AbsIterator: + type T + def hasNext: Boolean + def next(): T +``` + +{% endtab %} + +{% endtabs %} + Класс имеет абстрактный тип `T` и методы стандартного итератора. Далее создаем конкретную реализацию класса (все абстрактные члены `T`, `hasNext`, и `next` должны быть реализованы): +{% tabs mixin-concrete-string-iterator class=tabs-scala-version %} + +{% tab 'Scala 2' for=mixin-concrete-string-iterator %} + ```scala mdoc class StringIterator(s: String) extends AbsIterator { type T = Char @@ -53,26 +112,87 @@ class StringIterator(s: String) extends AbsIterator { } } ``` + +{% endtab %} + +{% tab 'Scala 3' for=mixin-concrete-string-iterator %} + +```scala +class StringIterator(s: String) extends AbsIterator: + type T = Char + private var i = 0 + def hasNext = i < s.length + def next() = + val ch = s charAt i + i += 1 + ch +``` + +{% endtab %} + +{% endtabs %} + `StringIterator` принимает `String` и может быть использован для обхода по строке (например, чтоб проверить содержит ли строка определенный символ). Теперь давайте создадим трейт который тоже наследуется от `AbsIterator`. +{% tabs mixin-extended-abstract-iterator class=tabs-scala-version %} + +{% tab 'Scala 2' for=mixin-extended-abstract-iterator %} + ```scala mdoc trait RichIterator extends AbsIterator { def foreach(f: T => Unit): Unit = while (hasNext) f(next()) } ``` -У этого трейта реализован метод `foreach` который постоянно вызывает переданную ему функцию `f: T => Unit` на каждом новом элементе (`next()`) до тех пор пока в итераторе содержатся элементы (`while (hasNext)`). Поскольку `RichIterator` это трейт, ему не нужно реализовывать членов абстрактного класса `AbsIterator`. -Мы бы хотели объединить функциональность `StringIterator` и `RichIterator` в один класс. +У этого трейта реализован метод `foreach`, который постоянно вызывает переданную ему функцию `f: T => Unit` +на каждом новом элементе (`next()`) до тех пор пока в итераторе содержатся элементы (`while (hasNext)`). +Поскольку `RichIterator` - это трейт, ему не нужно реализовывать элементы абстрактного класса `AbsIterator`. + +{% endtab %} + +{% tab 'Scala 3' for=mixin-extended-abstract-iterator %} + +```scala +trait RichIterator extends AbsIterator: + def foreach(f: T => Unit): Unit = while hasNext do f(next()) +``` + +У этого трейта реализован метод `foreach`, который постоянно вызывает переданную ему функцию `f: T => Unit` +на каждом новом элементе (`next()`) до тех пор пока в итераторе содержатся элементы (`while hasNext`). +Поскольку `RichIterator` - это трейт, ему не нужно реализовывать элементы абстрактного класса `AbsIterator`. + +{% endtab %} + +{% endtabs %} + +Мы бы хотели объединить функциональность `StringIterator` и `RichIterator` в один класс. + +{% tabs mixin-combination-class class=tabs-scala-version %} + +{% tab 'Scala 2' for=mixin-combination-class %} ```scala mdoc -object StringIteratorTest extends App { - class RichStringIter extends StringIterator("Scala") with RichIterator - val richStringIter = new RichStringIter - richStringIter foreach println -} +class RichStringIter extends StringIterator("Scala") with RichIterator +val richStringIter = new RichStringIter +richStringIter.foreach(println) +``` + +{% endtab %} + +{% tab 'Scala 3' for=mixin-combination-class %} + +```scala +class RichStringIter extends StringIterator("Scala"), RichIterator +val richStringIter = RichStringIter() +richStringIter.foreach(println) ``` -Новый класс `RichStringIter` включает `StringIterator` как суперкласс и `RichIterator` как примесь. -Используя только одиночное наследование мы бы не могли добиться того же уровня гибкости. +{% endtab %} + +{% endtabs %} + +Новый класс `RichStringIter` включает `StringIterator` как суперкласс и `RichIterator` как трейт. + +Используя только одиночное наследование мы бы не смогли добиться того же уровня гибкости. From 2cfc4b06ff40171b123183bbd820491fbbc71504 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Wed, 10 May 2023 11:20:29 +0300 Subject: [PATCH 2603/3075] Refresh _ru/tour/tuples.md (#2791) --- _ru/tour/tuples.md | 132 +++++++++++++++++++++++++++++++-------------- _tour/tuples.md | 2 +- 2 files changed, 93 insertions(+), 41 deletions(-) diff --git a/_ru/tour/tuples.md b/_ru/tour/tuples.md index 8af61d5102..8f1550c473 100644 --- a/_ru/tour/tuples.md +++ b/_ru/tour/tuples.md @@ -9,82 +9,134 @@ previous-page: traits topics: tuples --- -В Scala, кортеж (Тuple) это класс контейнер содержащий упорядоченный набор элементов различного типа. -Кортежи неизменяемы. +В Scala, кортеж (Тuple) - это контейнер содержащий упорядоченный набор элементов различного типа. +Кортежи неизменяемы. Кортежи могут пригодиться, когда нам нужно вернуть сразу несколько значений из функции. Кортеж может быть создан как: +{% tabs tuple-construction %} + +{% tab 'Scala 2 и 3' for=tuple-construction %} + ```scala mdoc -val ingredient = ("Sugar" , 25):Tuple2[String, Int] +val ingredient = ("Sugar", 25) ``` -Такая запись создает кортеж размерности 2, содержащий пару элементов String и Int. -Кортежи в Скале - представлены серией классов: Tuple2, Tuple3 и т.д., до Tuple22. -Таким образом, создавая кортеж с n элементами (n лежащими между 2 и 22), Скала просто создает один из соответствующих классов, который параметризован типом входящих в состав элементов. +{% endtab %} + +{% endtabs %} -В нашем примере, составляющие тип Tuple2[String, Int]. +Такая запись создает кортеж, содержащий пару элементов `String` и `Int`. + +Выводимый тип `ingredient` - это `(String, Int)`. ## Доступ к элементам -Доступ к элементам кортежа осуществляется при помощи синтаксиса подчеркивания. -'tuple._n' дает n-ый элемент (столько, сколько существует элементов). +{% tabs tuple-indexed-access class=tabs-scala-version %} + +{% tab 'Scala 2' for=tuple-indexed-access %} + +Один из способов доступа к элементам кортежа — по их позиции. +`tuple._n` дает n-ый элемент (столько, сколько существует элементов). ```scala mdoc println(ingredient._1) // Sugar - println(ingredient._2) // 25 ``` -## Распаковка данных кортежа +{% endtab %} -Scala кортежи также поддерживают [распаковку](extractor-objects.html). +{% tab 'Scala 3' for=tuple-indexed-access %} -```scala mdoc -val (name, quantity) = ingredient +Один из способов доступа к элементам кортежа — по их позиции. +Доступ к отдельным элементам осуществляется с помощью `tuple(0)`, `tuple(1)` и так далее. + +```scala +println(ingredient(0)) // Sugar +println(ingredient(1)) // 25 +``` + +{% endtab %} + +{% endtabs %} + +## Сопоставление с образцом для кортежей + +Кортеж также можно распаковать с помощью сопоставления с образцом: -println(name) // Sugar +{% tabs tuple-extraction %} +{% tab 'Scala 2 и 3' for=tuple-extraction %} + +```scala mdoc +val (name, quantity) = ingredient +println(name) // Sugar println(quantity) // 25 ``` -Распаковка данных кортежа может быть использована в [сопоставлении с примером](pattern-matching.html) +{% endtab %} + +{% endtabs %} + +Здесь выводимый тип `name` - `String` и выводимый тип `quantity` - `Int`. + +Вот еще один пример сопоставления с образцом кортежа: + +{% tabs tuple-foreach-patmat %} + +{% tab 'Scala 2 и 3' for=tuple-foreach-patmat %} ```scala mdoc -val planetDistanceFromSun = List(("Mercury", 57.9), ("Venus", 108.2), ("Earth", 149.6 ), ("Mars", 227.9), ("Jupiter", 778.3)) - -planetDistanceFromSun.foreach{ tuple => { - - tuple match { - - case ("Mercury", distance) => println(s"Mercury is $distance millions km far from Sun") - - case p if(p._1 == "Venus") => println(s"Venus is ${p._2} millions km far from Sun") - - case p if(p._1 == "Earth") => println(s"Blue planet is ${p._2} millions km far from Sun") - - case _ => println("Too far....") - - } - - } - +val planets = + List(("Mercury", 57.9), ("Venus", 108.2), ("Earth", 149.6), + ("Mars", 227.9), ("Jupiter", 778.3)) +planets.foreach { + case ("Earth", distance) => + println(s"Our planet is $distance million kilometers from the sun") + case _ => } ``` -Или в ['for' выражении](for-comprehensions.html). +{% endtab %} + +{% endtabs %} + +Или, в _for-comprehension_: + +{% tabs tuple-for-extraction class=tabs-scala-version %} + +{% tab 'Scala 2' for=tuple-for-extraction %} ```scala mdoc val numPairs = List((2, 5), (3, -7), (20, 56)) - for ((a, b) <- numPairs) { - println(a * b) - } ``` -Значение () типа Unit по свой сути совпадает со значением () типа Tuple0. Может быть только одно значение такого типа, так как в нём нет элементов. +{% endtab %} + +{% tab 'Scala 3' for=tuple-for-extraction %} + +```scala +val numPairs = List((2, 5), (3, -7), (20, 56)) +for (a, b) <- numPairs do + println(a * b) +``` + +{% endtab %} + +{% endtabs %} + +## Кортежи и кейс-классы + +Иногда бывает трудно выбирать между кортежами и кейс-классами. +Кейс-классы содержат именованные элементы. Имена могут улучшить читаемость некоторых типов кода. +В приведенном выше примере мы могли бы определить планеты, как `case class Planet(name: String, distance: Double)`, +а не использовать кортежи. + +## Дополнительные ресурсы -Иногда бывает трудно выбирать между кортежами и классами образцами. Как правило, классы образцы являются предпочтительным выбором, если класс-контейнер содержащий элементы сам по себе имеет значимый смысл. +- Дополнительная информация о кортежах - в книге [Scala Book](/ru/scala3/book/taste-collections.html#кортежи) diff --git a/_tour/tuples.md b/_tour/tuples.md index cebd7945ce..19166098fb 100644 --- a/_tour/tuples.md +++ b/_tour/tuples.md @@ -126,4 +126,4 @@ Users may sometimes find it hard to choose between tuples and case classes. Case ## More resources -* Learn more about tuples in the [Scala Book](/overviews/scala-book/tuples.html) +* Learn more about tuples in the [Scala Book](/scala3/book/taste-collections.html#tuples) From 0eeb790b212bcd12a4fbeffdc7e1bccc07582cf3 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Thu, 11 May 2023 00:21:10 +0000 Subject: [PATCH 2604/3075] Update SIPs state --- _sips/sips/multi-source-extension-overloads.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_sips/sips/multi-source-extension-overloads.md b/_sips/sips/multi-source-extension-overloads.md index 9812b8bbe3..5e9fa17958 100644 --- a/_sips/sips/multi-source-extension-overloads.md +++ b/_sips/sips/multi-source-extension-overloads.md @@ -2,7 +2,8 @@ layout: sip permalink: /sips/:title.html stage: implementation -status: under-review +status: vote-requested +recommendation: accept title: SIP-54 - Multi-Source Extension Overloads --- From 11d3ce4418ce977101924a9c057b5f9710462928 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Thu, 11 May 2023 11:00:48 +0200 Subject: [PATCH 2605/3075] use dotty website code highlighting (#2798) * use dotty website code highlighting * handle better words with 'def' --- _includes/footer.html | 3 + _overviews/scala3-book/first-look-at-types.md | 19 +- resources/js/functions.js | 3 +- resources/js/hljs-scala3.js | 476 ++++++++++++++++++ 4 files changed, 499 insertions(+), 2 deletions(-) create mode 100644 resources/js/hljs-scala3.js diff --git a/_includes/footer.html b/_includes/footer.html index b00049db89..82d0ba252d 100644 --- a/_includes/footer.html +++ b/_includes/footer.html @@ -53,6 +53,9 @@ <!-- Blog search --> <script src="{{ site.baseurl }}/resources/js/vendor/jekyll.search.min.js" type="text/javascript"></script> +<!-- Custom Syntax Highlight --> +<script src="{{ site.baseurl }}/resources/js/hljs-scala3.js" type="text/javascript"></script> + <!-- Custom JavaScript --> <script src="{{ site.baseurl }}/resources/js/functions.js" type="text/javascript"></script> diff --git a/_overviews/scala3-book/first-look-at-types.md b/_overviews/scala3-book/first-look-at-types.md index 4a822d6edf..1a795c8922 100644 --- a/_overviews/scala3-book/first-look-at-types.md +++ b/_overviews/scala3-book/first-look-at-types.md @@ -58,6 +58,7 @@ val list: List[Any] = List( "a string", 732, // an integer 'c', // a character + '\'', // a character with a backslash escape true, // a boolean value () => "an anonymous function returning a string" ) @@ -76,6 +77,7 @@ Here’s the output of the program: a string 732 c +' true <function> ``` @@ -119,7 +121,22 @@ In your code you can also append the characters `L`, `D`, and `F` (and their low ```scala val x = 1_000L // val x: Long = 1000 val y = 2.2D // val y: Double = 2.2 -val z = 3.3F // val z: Float = 3.3 +val z = -3.3F // val z: Float = -3.3 +``` + +You may also use hexadecimal notation to format integer numbers (normally `Int`, but which also support the +`L` suffix to specify that they are `Long`): + +```scala +val a = 0xACE // val a: Int = 2766 +val b = 0xfd_3aL // val b: Long = 64826 +``` + +Scala supports many different ways to format the same floating point number, e.g. +```scala +val q = .25 // val q: Double = 0.25 +val r = 2.5e-1 // val r: Double = 0.25 +val s = .0025e2F // val s: Float = 0.25 ``` {% endtab %} {% endtabs %} diff --git a/resources/js/functions.js b/resources/js/functions.js index 8dd9e9ec76..b0b0dd6d68 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -67,6 +67,7 @@ $(document).ready(function() { hljs.configure({ languages: ["scala", "bash"] }) + hljs.registerLanguage("scala", highlightDotty); hljs.highlightAll(); }); @@ -431,7 +432,7 @@ $(document).ready(function() { function setupTabs(tabs, namespace, defaultValue) { const PreferenceStorage = Storage('org.scala-lang.docs.preferences'); const preferredValue = PreferenceStorage.getPreference(namespace, defaultValue); - + activateTab(tabs, preferredValue) // setup listeners to record new preferred Scala version. diff --git a/resources/js/hljs-scala3.js b/resources/js/hljs-scala3.js new file mode 100644 index 0000000000..0ba80087ef --- /dev/null +++ b/resources/js/hljs-scala3.js @@ -0,0 +1,476 @@ +function highlightDotty(hljs) { + + // identifiers + const capitalizedId = /\b[A-Z][$\w]*\b/ + const alphaId = /[a-zA-Z$_][$\w]*/ + const op1 = /[^\s\w\d,;"'()[\]{}=:]/ + const op2 = /[^\s\w\d,;"'()[\]{}]/ + const compound = `[a-zA-Z$][a-zA-Z0-9$]*_${op2.source}` // e.g. value_= + const id = new RegExp(`(${compound}|${alphaId.source}|${op2.source}{2,}|${op1.source}+|\`.+?\`)`) + + // numbers + const hexDigit = '[a-fA-F0-9]' + const hexNumber = `0[xX](${hexDigit})+(_(${hexDigit})+)*[lL]?` + const wholePart = `(\\d+)(_\\d+)*` + const decPoint = `\\.\\d+` + const floatingSuffix = `([eE][-+]?\\d+)?[fFdD]?` + const intOrFloat = `${decPoint}${floatingSuffix}|\\b${wholePart}([lLfFdD]|(${decPoint})?${floatingSuffix})` + const number = new RegExp(`(-?)((\\b(${hexNumber})|${intOrFloat}))`) + + // Regular Keywords + // The "soft" keywords (e.g. 'using') are added later where necessary + const alwaysKeywords = { + $pattern: /(\w+|\?=>|\?{1,3}|=>>|=>|<:|>:|_|#|<-|\.nn)/, + keyword: + 'abstract case catch class def do else enum export extends final finally for given ' + + 'if implicit import lazy match new object package private protected override return ' + + 'sealed then throw trait true try type val var while with yield =>> => ?=> <: >: _ ? <- #', + literal: 'true false null this super', + built_in: '??? asInstanceOf isInstanceOf assert implicitly locally summon valueOf .nn' + } + const modifiers = 'abstract|final|implicit|override|private|protected|sealed' + + // End of class, enum, etc. header + const templateDeclEnd = /(\/[/*]|{|:(?= *\n)|\n(?! *(extends|with|derives)))/ + + // all the keywords + soft keywords, separated by spaces + function withSoftKeywords(kwd) { + return { + $pattern: alwaysKeywords.$pattern, + keyword: kwd + ' ' + alwaysKeywords.keyword, + literal: alwaysKeywords.literal, + built_in: alwaysKeywords.built_in + } + } + + // title inside of a complex token made of several parts, but colored as a type (e.g. class) + const TP_TITLE = { + className: 'type', + begin: id, + returnEnd: true, + keywords: alwaysKeywords.keyword, + literal: alwaysKeywords.literal, + built_in: alwaysKeywords.built_in + } + + // title inside of a complex token made of several parts (e.g. class) + const TITLE = { + className: 'title', + begin: id, + returnEnd: true, + keywords: alwaysKeywords.keyword, + literal: alwaysKeywords.literal, + built_in: alwaysKeywords.built_in + } + + // title that goes to the end of a simple token (e.g. val) + const TITLE2 = { + className: 'title', + begin: id, + excludeEnd: true, + endsWithParent: true + } + + const TYPED = { + begin: /: (?=[a-zA-Z()?])/, + end: /\/\/|\/\*|\n/, + endsWithParent: true, + returnEnd: true, + contains: [ + { + // works better than the usual way of defining keyword, + // in this specific situation + className: 'keyword', + begin: /\?\=>|=>>|[=:][><]|\?/, + }, + { + className: 'type', + begin: alphaId + } + ] + } + + const PROBABLY_TYPE = { + className: 'type', + begin: capitalizedId, + relevance: 0 + } + + const NUMBER = { + className: 'number', + begin: number, + relevance: 0, + } + + const CHAR = { + className: 'string', + begin: /\'([^'\\]|\\[\s\S])\'/, + relevance: 0, + } + + // type parameters within [square brackets] + const TPARAMS = { + begin: /\[/, end: /\]/, + keywords: { + $pattern: /<:|>:|[+-?_:]/, + keyword: '<: >: : + - ? _' + }, + contains: [ + hljs.C_BLOCK_COMMENT_MODE, + { + className: 'type', + begin: alphaId + }, + ], + relevance: 3 + } + + // Class or method parameters declaration + const PARAMS = { + className: 'params', + begin: /\(/, end: /\)/, + excludeBegin: true, + excludeEnd: true, + keywords: withSoftKeywords('inline using'), + contains: [ + hljs.C_BLOCK_COMMENT_MODE, + hljs.QUOTE_STRING_MODE, + PROBABLY_TYPE + ] + } + + // (using T1, T2, T3) + const CTX_PARAMS = { + className: 'params', + begin: /\(using (?!\w+:)/, end: /\)/, + excludeBegin: false, + excludeEnd: true, + relevance: 5, + keywords: withSoftKeywords('using'), + contains: [ + PROBABLY_TYPE + ] + } + + // String interpolation + const SUBST = { + className: 'subst', + variants: [ + { begin: /\$[a-zA-Z_]\w*/ }, + { + begin: /\${/, end: /}/, + contains: [ + NUMBER, + hljs.QUOTE_STRING_MODE + ] + } + ] + } + + // "string" or """string""", with or without interpolation + const STRING = { + className: 'string', + variants: [ + hljs.QUOTE_STRING_MODE, + { + begin: '"""', end: '"""', + contains: [hljs.BACKSLASH_ESCAPE], + relevance: 10 + }, + { + begin: alphaId.source + '"', end: '"', + contains: [hljs.BACKSLASH_ESCAPE, SUBST], + illegal: /\n/, + relevance: 5 + }, + { + begin: alphaId.source + '"""', end: '"""', + contains: [hljs.BACKSLASH_ESCAPE, SUBST], + relevance: 10 + } + ] + } + + // Class or method apply + const APPLY = { + begin: /\(/, end: /\)/, + excludeBegin: true, excludeEnd: true, + keywords: { + $pattern: alwaysKeywords.$pattern, + keyword: 'using ' + alwaysKeywords.keyword, + literal: alwaysKeywords.literal, + built_in: alwaysKeywords.built_in + }, + contains: [ + STRING, + NUMBER, + CHAR, + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + PROBABLY_TYPE, + ] + } + + // @annot(...) or @my.package.annot(...) + const ANNOTATION = { + className: 'meta', + begin: `@${id.source}(\\.${id.source})*`, + contains: [ + APPLY, + hljs.C_BLOCK_COMMENT_MODE + ] + } + + // Documentation + const SCALADOC = hljs.COMMENT('/\\*\\*', '\\*/', { + contains: [ + { + className: 'doctag', + begin: /@[a-zA-Z]+/ + }, + // markdown syntax elements: + { + className: 'code', + variants: [ + { begin: /```.*\n/, end: /```/ }, + { begin: /`/, end: /`/ } + ], + }, + { + className: 'bold', + variants: [ + { begin: /\*\*/, end: /\*\*/ }, + { begin: /__/, end: /__/ } + ], + }, + { + className: 'emphasis', + variants: [ + { begin: /\*(?!([\*\s/])|([^\*]*\*[\*/]))/, end: /\*/ }, + { begin: /_/, end: /_/ } + ], + }, + { + className: 'bullet', // list item + begin: /- (?=\S)/, end: /\s/, + }, + { + begin: /\[.*?\]\(/, end: /\)/, + contains: [ + { + // mark as "link" only the URL + className: 'link', + begin: /.*?/, + endsWithParent: true + } + ] + } + ] + }) + + // Methods + const METHOD = { + className: 'function', + begin: `((${modifiers}|transparent|inline|infix) +)*def `, end: / =\s|\n/, + excludeEnd: true, + relevance: 5, + keywords: withSoftKeywords('inline infix transparent'), + contains: [ + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + TPARAMS, + CTX_PARAMS, + PARAMS, + TYPED, // prevents the ":" (declared type) to become a title + PROBABLY_TYPE, + TITLE + ] + } + + // Variables & Constants + const VAL = { + beginKeywords: 'val var', end: /[=:;\n/]/, + excludeEnd: true, + contains: [ + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + TITLE2 + ] + } + + // Type declarations + const TYPEDEF = { + className: 'typedef', + begin: `((${modifiers}|opaque) +)*type `, end: /[=;\n]| ?[<>]:/, + excludeEnd: true, + keywords: withSoftKeywords('opaque'), + contains: [ + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + PROBABLY_TYPE, + TITLE, + ] + } + + // Given instances + const GIVEN = { + begin: `((${modifiers}|transparent|inline) +)*given `, end: / =|[=;\n]/, + excludeEnd: true, + keywords: withSoftKeywords('inline transparent given using with'), + contains: [ + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + PARAMS, + CTX_PARAMS, + PROBABLY_TYPE, + TITLE + ] + } + + // Extension methods + const EXTENSION = { + begin: /extension/, end: /(\n|def)/, + returnEnd: true, + keywords: 'extension implicit using', + contains: [ + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + CTX_PARAMS, + PARAMS, + PROBABLY_TYPE + ] + } + + // 'end' soft keyword + const END = { + begin: `end(?= (if|while|for|match|try|given|extension|this|val|${id.source})\\n)`, end: /\s/, + keywords: 'end' + } + + // Classes, traits, enums, etc. + const EXTENDS_PARENT = { + begin: ' extends ', end: /( with | derives |\/[/*])/, + endsWithParent: true, + returnEnd: true, + keywords: 'extends', + contains: [APPLY, PROBABLY_TYPE] + } + const WITH_MIXIN = { + begin: ' with ', end: / derives |\/[/*]/, + endsWithParent: true, + returnEnd: true, + keywords: 'with', + contains: [APPLY, PROBABLY_TYPE], + relevance: 10 + } + const DERIVES_TYPECLASS = { + begin: ' derives ', end: /\n|\/[/*]/, + endsWithParent: true, + returnEnd: true, + keywords: 'derives', + contains: [PROBABLY_TYPE], + relevance: 10 + } + + const CLASS = { + className: 'class', + begin: `((${modifiers}|open|case|transparent) +)*(class|trait|enum|object|package object)`, end: templateDeclEnd, + keywords: withSoftKeywords('open transparent'), + excludeEnd: true, + contains: [ + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + TPARAMS, + CTX_PARAMS, + PARAMS, + EXTENDS_PARENT, + WITH_MIXIN, + DERIVES_TYPECLASS, + TITLE, + PROBABLY_TYPE + ] + } + + // package declaration with a content + const PACKAGE = { + className: 'package', + begin: /package (?=\w+ *[:{\n])/, end: /[:{\n]/, + excludeEnd: true, + keywords: alwaysKeywords, + contains: [ + TITLE + ] + } + + // Case in enum + const ENUM_CASE = { + begin: /case (?!.*=>)/, end: /\n/, + keywords: 'case', + excludeEnd: true, + contains: [ + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + PARAMS, + EXTENDS_PARENT, + WITH_MIXIN, + DERIVES_TYPECLASS, + TP_TITLE, + PROBABLY_TYPE + ] + } + + // Case in pattern matching + const MATCH_CASE = { + begin: /case/, end: /=>|\n/, + keywords: 'case', + excludeEnd: true, + contains: [ + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + { + begin: /[@_]/, + keywords: { + $pattern: /[@_]/, + keyword: '@ _' + } + }, + NUMBER, + STRING, + PROBABLY_TYPE + ] + } + + // inline someVar[andMaybeTypeParams] match + const INLINE_MATCH = { + begin: /inline [^\n:]+ match/, + keywords: 'inline match' + } + + return { + name: 'Scala3', + aliases: ['scala', 'dotty'], + keywords: alwaysKeywords, + contains: [ + NUMBER, + CHAR, + STRING, + SCALADOC, + hljs.C_LINE_COMMENT_MODE, + hljs.C_BLOCK_COMMENT_MODE, + METHOD, + VAL, + TYPEDEF, + PACKAGE, + CLASS, + GIVEN, + EXTENSION, + ANNOTATION, + ENUM_CASE, + MATCH_CASE, + INLINE_MATCH, + END, + APPLY, + PROBABLY_TYPE + ] + } +} From e7c52933fbee6838fba97dc0d7afe929a25344ca Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Thu, 11 May 2023 11:22:28 +0200 Subject: [PATCH 2606/3075] fix lambda in munit test (#2799) --- _overviews/toolkit/testing-suite.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/toolkit/testing-suite.md b/_overviews/toolkit/testing-suite.md index 8b17de43a6..23c717a414 100644 --- a/_overviews/toolkit/testing-suite.md +++ b/_overviews/toolkit/testing-suite.md @@ -107,7 +107,7 @@ The following is an example of a test that use `assert` to check a boolean condi ```scala test("all even numbers") { val input: List[Int] = List(1, 2, 3, 4) - val obtainedResults: List[Int] = input.map(_ * 2_) + val obtainedResults: List[Int] = input.map(_ * 2) // check that obtained values are all even numbers assert(obtainedResults.forall(x => x % 2 == 0)) } @@ -117,7 +117,7 @@ test("all even numbers") { ```scala test("all even numbers"): val input: List[Int] = List(1, 2, 3, 4) - val obtainedResults: List[Int] = input.map(_ * 2_) + val obtainedResults: List[Int] = input.map(_ * 2) // check that obtained values are all even numbers assert(obtainedResults.forall(x => x % 2 == 0)) ``` From 34022d747300cfcc2b7294c8284a8b8df153db4a Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Tue, 9 May 2023 13:57:02 +0200 Subject: [PATCH 2607/3075] Add a documentation for the blog.yaml feature --- _overviews/scala3-scaladoc/blog.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/_overviews/scala3-scaladoc/blog.md b/_overviews/scala3-scaladoc/blog.md index 9069c9900d..ba845fc913 100644 --- a/_overviews/scala3-scaladoc/blog.md +++ b/_overviews/scala3-scaladoc/blog.md @@ -53,3 +53,24 @@ You can also find more details about the front matter on the [Jekyll documentati ## Syntax of the content Keep in mind that the writing of your blog is done with Markdown. You can find more information about the syntax in [Markdown Guide](https://www.markdownguide.org/basic-syntax/). + +## Blog configuration +When creating your blog, Scaladoc also allows you to configure it. + +In order to modify the default settings of the blog documentation, users need to create a file named `blog.yml` in the **root directory of the blog**. The file should contain the parameters that the user wants to change. For example, if a user wants to change the input directory to "my_posts", the output directory to "my_docs", and temporarily hide the blog, they can create a file with the following content: + +``` +input: my_posts +output: my_docs +hidden: true +``` + +### Parameters: + +`input`: specifies the directory containing markdown files for the blog posts (default: "_posts" in "docs"). + +`output`: specifies the folder where HTML pages will be generated (default: "blog" in "target/docs"). + +`hidden`: allows users to temporarily hide the blog (default: "false"). + +To change these settings, create a file with the parameters and save it in the blog's root directory. The next time the blog is built, the new settings will be used. \ No newline at end of file From 877d0d952a8194d37702de0cb4cd401ee00cf693 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Fri, 12 May 2023 00:20:21 +0000 Subject: [PATCH 2608/3075] Update SIPs state --- _sips/sips/quote-pattern-type-variable-syntax.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_sips/sips/quote-pattern-type-variable-syntax.md b/_sips/sips/quote-pattern-type-variable-syntax.md index a0aed079b9..92d1ce83fa 100644 --- a/_sips/sips/quote-pattern-type-variable-syntax.md +++ b/_sips/sips/quote-pattern-type-variable-syntax.md @@ -59,11 +59,11 @@ We want to be able to set the bounds of type variables to be able to match again ```scala case '[ head *: tail ] => h[tail] ``` -See https://github.com/lampepfl/dotty/issues/11738. +See [https://github.com/lampepfl/dotty/issues/11738](https://github.com/lampepfl/dotty/issues/11738). ### Support matching on any kind of type We want to match against higher-kinded (or `AnyKind`) types. This is not possible due to the default upper bound of `Any`. -See https://github.com/lampepfl/dotty/issues/10864. +See [https://github.com/lampepfl/dotty/issues/10864](https://github.com/lampepfl/dotty/issues/10864). ### Support multiple references to the same type in quoted type patterns We want to be able to match using several references to the same type variable. @@ -135,7 +135,7 @@ TASTy only contains explicit type variable definitions, and this encoding would ## Related work -* Proof of concept of type variable syntax: https://github.com/lampepfl/dotty/pull/16910 -* Proof of concept of backticks (only interested in the first bullet point): https://github.com/lampepfl/dotty/pull/16935 +* Proof of concept of type variable syntax: [https://github.com/lampepfl/dotty/pull/16910](https://github.com/lampepfl/dotty/pull/16910) +* Proof of concept of backticks (only interested in the first bullet point): [https://github.com/lampepfl/dotty/pull/16935](https://github.com/lampepfl/dotty/pull/16935) <!-- ## FAQ --> From 3cfebc98022d6c0843d885835d286ac51a42881c Mon Sep 17 00:00:00 2001 From: adpi2 <adrien.piquerez@gmail.com> Date: Fri, 12 May 2023 13:07:25 +0200 Subject: [PATCH 2609/3075] Some fixes in the rendering of the Toolkit tutorials (#2800) * fix mdoc converter * Fix links --- _overviews/toolkit/http-client-json.md | 2 +- _overviews/toolkit/json-files.md | 2 +- _plugins/mdoc_replace.rb | 1 + 3 files changed, 3 insertions(+), 2 deletions(-) diff --git a/_overviews/toolkit/http-client-json.md b/_overviews/toolkit/http-client-json.md index 4fca18f91f..731c0cf0ff 100644 --- a/_overviews/toolkit/http-client-json.md +++ b/_overviews/toolkit/http-client-json.md @@ -125,4 +125,4 @@ Running the program should print your own login. ## Sending and receiving Scala objects using JSON Alternatively, you can use uPickle to send or receive Scala objects using JSON. -Read the following to learn [*How to serialize an object to JSON*](/toolkit/json-serialize) and [*How to deserialize JSON to an object*](/toolkit/json-deserialize). +Read the following to learn [*How to serialize an object to JSON*](/toolkit/json-serialize.html) and [*How to deserialize JSON to an object*](/toolkit/json-deserialize.html). diff --git a/_overviews/toolkit/json-files.md b/_overviews/toolkit/json-files.md index 63fd2759ec..53072bb2b5 100644 --- a/_overviews/toolkit/json-files.md +++ b/_overviews/toolkit/json-files.md @@ -69,4 +69,4 @@ os.write(os.pwd / "pet-owner-updated.json", write(petOwnerUpdated)) {% endtabs %} To serialize and deserialize Scala case classes (or enums) to JSON we need an instance of `ReadWriter`. -To understand how uPickle generates it for you, you can read the [*How to deserialize JSON to an object?*](/toolkit/json-deserialize) or the [*How to serialize an object to JSON?*](/toolkit/json-serialize) tutorials. +To understand how uPickle generates it for you, you can read the [*How to deserialize JSON to an object?*](/toolkit/json-deserialize.html) or the [*How to serialize an object to JSON?*](/toolkit/json-serialize.html) tutorials. diff --git a/_plugins/mdoc_replace.rb b/_plugins/mdoc_replace.rb index a4d8bf6e11..7cecf73aa6 100644 --- a/_plugins/mdoc_replace.rb +++ b/_plugins/mdoc_replace.rb @@ -16,6 +16,7 @@ def convert(content) content = content.gsub("```scala mdoc:fail\n", "```scala\n") content = content.gsub("```scala mdoc:crash\n", "```scala\n") content = content.gsub("```scala mdoc:nest\n", "```scala\n") + content = content.gsub("```scala mdoc:reset:crash\n", "```scala\n") content = content.gsub("```scala mdoc:reset\n", "```scala\n") content.gsub("```scala mdoc\n", "```scala\n") end From 3457006e531bc2bc0116b13f2099d11a15372f9a Mon Sep 17 00:00:00 2001 From: Simon R <szymonrodant@gmail.com> Date: Mon, 15 May 2023 14:42:38 +0200 Subject: [PATCH 2610/3075] Remove fewer braces syntax for now (#2801) --- _overviews/toolkit/testing-asynchronous.md | 3 ++- _overviews/toolkit/testing-exceptions.md | 6 ++++-- _overviews/toolkit/testing-resources.md | 3 ++- _overviews/toolkit/testing-run-only.md | 15 ++++++++++----- _overviews/toolkit/testing-run.md | 3 ++- _overviews/toolkit/testing-suite.md | 6 ++++-- _overviews/toolkit/testing-what-else.md | 6 ++++-- 7 files changed, 28 insertions(+), 14 deletions(-) diff --git a/_overviews/toolkit/testing-asynchronous.md b/_overviews/toolkit/testing-asynchronous.md index 68862cc1cc..1311af6b9b 100644 --- a/_overviews/toolkit/testing-asynchronous.md +++ b/_overviews/toolkit/testing-asynchronous.md @@ -68,13 +68,14 @@ class AsyncMathLibTests extends munit.FunSuite { import scala.concurrent.ExecutionContext.Implicits.global class AsyncMathLibTests extends munit.FunSuite: - test("square"): + test("square") { for squareOf3 <- AsyncMathLib.square(3) squareOfMinus4 <- AsyncMathLib.square(-4) yield assertEquals(squareOf3, 9) assertEquals(squareOfMinus4, 16) + } ``` {% endtab %} {% endtabs %} diff --git a/_overviews/toolkit/testing-exceptions.md b/_overviews/toolkit/testing-exceptions.md index 0e26e51bd5..f2a880d68f 100644 --- a/_overviews/toolkit/testing-exceptions.md +++ b/_overviews/toolkit/testing-exceptions.md @@ -34,11 +34,13 @@ class FileTests extends munit.FunSuite { import java.nio.file.NoSuchFileException class FileTests extends munit.FunSuite: - test("read missing file"): + test("read missing file") { val missingFile = os.pwd / "missing.txt" - intercept[NoSuchFileException]: + intercept[NoSuchFileException] { // the code that should throw an exception os.read(missingFile) + } + } ``` {% endtab %} {% endtabs %} diff --git a/_overviews/toolkit/testing-resources.md b/_overviews/toolkit/testing-resources.md index 9e0d45f51f..50733256e7 100644 --- a/_overviews/toolkit/testing-resources.md +++ b/_overviews/toolkit/testing-resources.md @@ -82,9 +82,10 @@ using2TempFiles.test("merge two files") { val using2TempFiles: FunFixture[(os.Path, os.Path)] = FunFixture.map2(usingTempFile, usingTempFile) -using2TempFiles.test("merge two files"): +using2TempFiles.test("merge two files") { (file1, file2) => // body of the test +} ``` {% endtab %} {% endtabs %} diff --git a/_overviews/toolkit/testing-run-only.md b/_overviews/toolkit/testing-run-only.md index af6ba02cd7..fcd56fde3c 100644 --- a/_overviews/toolkit/testing-run-only.md +++ b/_overviews/toolkit/testing-run-only.md @@ -53,10 +53,12 @@ class MathSuite extends munit.FunSuite { {% tab 'Scala 3' %} ```scala class MathSuite extends munit.FunSuite: - test("addition"): + test("addition") { assert(1 + 1 == 2) - test("multiplication".only): + } + test("multiplication".only) { assert(3 * 7 == 21) + } ``` {% endtab %} {% endtabs %} @@ -88,12 +90,15 @@ class MathSuite extends munit.FunSuite { {% tab 'Scala 3' %} ```scala class MathSuite extends munit.FunSuite: - test("addition".ignore): + test("addition".ignore) { assert(1 + 1 == 2) - test("multiplication"): + } + test("multiplication") { assert(3 * 7 == 21) - test("remainder"): + } + test("remainder") { assert(13 % 5 == 3) + } ``` {% endtab %} {% endtabs %} diff --git a/_overviews/toolkit/testing-run.md b/_overviews/toolkit/testing-run.md index cb3fde0ade..12b0871289 100644 --- a/_overviews/toolkit/testing-run.md +++ b/_overviews/toolkit/testing-run.md @@ -62,10 +62,11 @@ test("failing test") { {% endtab %} {% tab 'Scala 3' %} ```scala -test("failing test"): +test("failing test") { val obtained = 2 + 3 val expected = 4 assertEquals(obtained, expected) +} ``` {% endtab %} {% endtabs %} diff --git a/_overviews/toolkit/testing-suite.md b/_overviews/toolkit/testing-suite.md index 23c717a414..7c068edfe7 100644 --- a/_overviews/toolkit/testing-suite.md +++ b/_overviews/toolkit/testing-suite.md @@ -78,10 +78,11 @@ class MyTests extends munit.FunSuite { package example class MyTests extends munit.FunSuite: - test("sum of two integers"): + test("sum of two integers") { val obtained = 2 + 2 val expected = 4 assertEquals(obtained, expected) + } ``` {% endtab %} {% endtabs %} @@ -115,11 +116,12 @@ test("all even numbers") { {% endtab %} {% tab 'Scala 3' %} ```scala -test("all even numbers"): +test("all even numbers") { val input: List[Int] = List(1, 2, 3, 4) val obtainedResults: List[Int] = input.map(_ * 2) // check that obtained values are all even numbers assert(obtainedResults.forall(x => x % 2 == 0)) +} ``` {% endtab %} {% endtabs %} diff --git a/_overviews/toolkit/testing-what-else.md b/_overviews/toolkit/testing-what-else.md index 305765ec30..4c0672af1a 100644 --- a/_overviews/toolkit/testing-what-else.md +++ b/_overviews/toolkit/testing-what-else.md @@ -49,9 +49,10 @@ test("home directory") { ```scala import scala.util.Properties -test("home directory"): +test("home directory") { assume(Properties.isLinux, "this test runs only on Linux") assert(os.home.toString.startsWith("/home/")) +} ``` {% endtab %} {% endtabs %} @@ -73,8 +74,9 @@ test("requests".flaky) { {% endtab %} {% tab 'Scala 3' %} ```scala -test("requests".flaky): +test("requests".flaky) { // I/O heavy tests that sometimes fail +} ``` {% endtab %} {% endtabs %} From ad238cd2374c1010285d7a000d0f29c73e096747 Mon Sep 17 00:00:00 2001 From: languagelawyer <38548419+languagelawyer@users.noreply.github.com> Date: Wed, 17 May 2023 09:23:15 +0500 Subject: [PATCH 2611/3075] Fix typo --- _overviews/scala3-book/ca-type-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/ca-type-classes.md b/_overviews/scala3-book/ca-type-classes.md index 18f5ef3f72..d79680a8be 100644 --- a/_overviews/scala3-book/ca-type-classes.md +++ b/_overviews/scala3-book/ca-type-classes.md @@ -120,7 +120,7 @@ val person = Person("John", "Doe") println(showablePerson.show(person)) ``` -Not that in practice, type classes are typically used with values whose type is unknown, unlike the type `Person`, as shown in the next section. +Note that in practice, type classes are typically used with values whose type is unknown, unlike the type `Person`, as shown in the next section. {% endtab %} {% tab 'Scala 3' %} ```scala From cc4d0b9e116d7756315c671b9771bba2b3bd48f0 Mon Sep 17 00:00:00 2001 From: Lucas Leblanc <44496264+Dedelweiss@users.noreply.github.com> Date: Wed, 17 May 2023 17:03:32 +0200 Subject: [PATCH 2612/3075] WIP: Sync Contributing section from Dotty website to Scala-lang Guide (#2769) --- _data/doc-nav-header.yml | 2 - _data/overviews.yml | 6 - _overviews/contribute/guide.md | 2 +- _overviews/contribute/scala3.md | 21 ++ .../scala3-contribution/arch-context.md | 57 +---- _overviews/scala3-contribution/arch-intro.md | 17 +- .../scala3-contribution/arch-lifecycle.md | 95 +-------- _overviews/scala3-contribution/arch-phases.md | 112 +--------- .../scala3-contribution/arch-symbols.md | 75 +------ _overviews/scala3-contribution/arch-time.md | 75 +------ _overviews/scala3-contribution/arch-types.md | 151 +------------ .../scala3-contribution/contribution-intro.md | 45 +--- .../scala3-contribution/procedures-areas.md | 73 +------ .../procedures-cheatsheet.md | 34 +-- .../procedures-checklist.md | 139 +----------- .../procedures-debugging.md | 190 +---------------- .../procedures-efficiency.md | 27 +-- .../procedures-inspection.md | 187 +---------------- .../scala3-contribution/procedures-intro.md | 25 +-- .../procedures-navigation.md | 120 +---------- .../procedures-reproduce.md | 135 +----------- .../scala3-contribution/procedures-testing.md | 198 +----------------- _overviews/scala3-contribution/start-intro.md | 82 +------- .../images/scala3-contribution/breakpoint.jpg | Bin 137341 -> 0 bytes .../images/scala3-contribution/call-stack.jpg | Bin 305288 -> 0 bytes .../conditional-breakpoint.jpg | Bin 146193 -> 0 bytes .../scala3-contribution/create-config.jpg | Bin 140865 -> 0 bytes .../scala3-contribution/debug-console.jpg | Bin 157192 -> 0 bytes .../scala3-contribution/import-build.jpg | Bin 64305 -> 0 bytes .../launch-config-file.jpg | Bin 61379 -> 0 bytes .../scala3-contribution/start-debugger.jpg | Bin 102513 -> 0 bytes .../images/scala3-contribution/toolbar.jpg | Bin 111169 -> 0 bytes 32 files changed, 56 insertions(+), 1812 deletions(-) create mode 100644 _overviews/contribute/scala3.md delete mode 100644 resources/images/scala3-contribution/breakpoint.jpg delete mode 100644 resources/images/scala3-contribution/call-stack.jpg delete mode 100644 resources/images/scala3-contribution/conditional-breakpoint.jpg delete mode 100644 resources/images/scala3-contribution/create-config.jpg delete mode 100644 resources/images/scala3-contribution/debug-console.jpg delete mode 100644 resources/images/scala3-contribution/import-build.jpg delete mode 100644 resources/images/scala3-contribution/launch-config-file.jpg delete mode 100644 resources/images/scala3-contribution/start-debugger.jpg delete mode 100644 resources/images/scala3-contribution/toolbar.jpg diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index 6eddea4ed7..708c232a0c 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -54,8 +54,6 @@ url: "https://docs.scala-lang.org/scala3/reference" - title: Scala Contribution Guide url: "/contribute/" - - title: Scala 3 Compiler Contributing Guide - url: "/scala3/guides/contribution/contribution-intro.html" - title: Style Guide url: "/style/index.html" - title: Cheatsheet diff --git a/_data/overviews.yml b/_data/overviews.yml index 1e40bdfea3..cc1534263e 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -194,12 +194,6 @@ - category: Compiler description: "Guides and overviews covering the Scala compiler: compiler plugins, reflection, and metaprogramming tools such as macros." overviews: - - title: "Scala 3 Contributing Guide" - by: Jamie Thompson, Anatolii Kmetiuk - icon: cogs - root: "scala3/guides/" - url: "contribution/contribution-intro.html" - description: "Guide to the Scala 3 Compiler and fixing an issue" - title: Scala 2 Reflection by: Heather Miller, Eugene Burmako, and Philipp Haller icon: binoculars diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index 9fa69a410c..056bfcded9 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -68,7 +68,7 @@ the Scala project source tree. The hacker's guides ([Scala 2][hackers], or [Scal [community-tickets]: {% link _overviews/contribute/index.md %}#community-tickets [bug-reporting-guide]: {% link _overviews/contribute/bug-reporting-guide.md %} [bug-report-check-dupes]: {% link _overviews/contribute/bug-reporting-guide.md %}#please-check-before-reporting-a-bug -[scala3-hackers]: {% link _overviews/scala3-contribution/procedures-intro.md %} +[scala3-hackers]: {% link _overviews/contribute/scala3.md %} [contrib-forum]: https://contributors.scala-lang.org/ [why-its-a-good-idea]: {% link _overviews/contribute/scala-internals.md %}#why-its-a-good-idea [hackers-connect]: {% link _overviews/contribute/hacker-guide.md %}#1-connect diff --git a/_overviews/contribute/scala3.md b/_overviews/contribute/scala3.md new file mode 100644 index 0000000000..27be4f00a4 --- /dev/null +++ b/_overviews/contribute/scala3.md @@ -0,0 +1,21 @@ +--- +title: Contribute to Scala 3 +description: This page describes the format of the contribution guide for the Scala 3 compiler. +num: 14 +redirect_from: /scala3/guides/contribution/contribution-intro.html +--- +Thank you for wanting to contribute to Scala 3! + +Dotty is an open-source project, and as such, we welcome contributions from the community to help us make it even better. + +If you are interested in contributing to Scala 3, please visit the project [developer website](https://dotty.epfl.ch/docs/contributing/index.html), where you will find all the information you need to get started. We encourage everyone, regardless of their level of expertise, to contribute to Scala 3, as there are many ways to help, from fixing bugs and implementing new features to improving documentation and testing. + +If you have any questions, please feel free to ask them on the [Contributors Forum](https://contributors.scala-lang.org/c/scala-3/scala-3-contributors/9). + +Summary of the contribution guide on Scala 3: + +- [Getting-Started](https://dotty.epfl.ch/docs/contributing/getting-started.html) +- [Workflow](https://dotty.epfl.ch/docs/contributing/workflow/index.html) +- [IDEs and Tools](https://dotty.epfl.ch/docs/contributing/tools/index.html) +- [Procedures](https://dotty.epfl.ch/docs/contributing/procedures/index.html) +- [High Level Architecture](https://dotty.epfl.ch/docs/contributing/architecture/index.html) \ No newline at end of file diff --git a/_overviews/scala3-contribution/arch-context.md b/_overviews/scala3-contribution/arch-context.md index 6a33d9aa5a..cbf342703f 100644 --- a/_overviews/scala3-contribution/arch-context.md +++ b/_overviews/scala3-contribution/arch-context.md @@ -1,58 +1,5 @@ --- title: Contexts -type: section description: This page describes symbols in the Scala 3 compiler. -num: 15 -previous-page: arch-lifecycle -next-page: arch-phases ---- - -`dotc` has almost no global state (with the exception of the name table, -which hashes strings into unique names). Instead, all -essential bits of information that can vary over a compiler [run] are collected -in a `Context` (defined in [Contexts]). - -Most methods in the compiler depend on an implicit anonymous `Context` parameter, -and a typical definition looks like the following: -```scala -import dotty.tools.dotc.Contexts.{Context, ctx} - -def doFoo(using Context): Unit = - val current = ctx.run // access the Context parameter with `ctx` -``` - -## Memory Leaks -> **Careful:** Contexts can be heavy so beware of memory leaks - -It is good practice to ensure that implicit contexts are not -captured in closures or other long-lived objects, in order to avoid space leaks -in the case where a closure can survive several compiler runs (e.g. a -lazy completer for a library class that is never required). In that case, the -convention is that the `Context` be an explicit parameter, to track its usage. - -## Context Properties - -| Context property | description | -|-------------------|----------------------------------------| -| `compilationUnit` | current compilation unit | -| `phase` | current phase | -| `run` | current run | -| `period` | current period | -| `settings` | the config passed to the compiler | -| `reporter` | operations for logging errors/warnings | -| `definitions` | the standard built in definitions | -| `platform` | operations for the underlying platform | -| `tree` | current tree | -| `scope` | current scope | -| `typer` | current typer | -| `owner` | current owner symbol | -| `outer` | outer Context | -| `mode` | type checking mode | -| `typerState` | | -| `searchHistory` | | -| `implicits` | | -| ... | and so on | - - -[Contexts]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Contexts.scala -[run]: {% link _overviews/scala3-contribution/arch-lifecycle.md %}#runs +redirect_to: https://dotty.epfl.ch/docs/contributing/architecture/context.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/arch-intro.md b/_overviews/scala3-contribution/arch-intro.md index a0a9c5111a..8b306a4e5c 100644 --- a/_overviews/scala3-contribution/arch-intro.md +++ b/_overviews/scala3-contribution/arch-intro.md @@ -1,18 +1,5 @@ --- title: High Level Architecture -type: chapter description: This page introduces the high level architecture of the Scala 3 compiler. -num: 13 -previous-page: procedures-checklist -next-page: arch-lifecycle ---- - -This chapter of the guide describes the architecture and concepts of `dotc`, -the Scala 3 compiler, including answers to questions such as: -- "What are the transformations that happen to my code?" -- "How do I run a compiler programatically?" -- "What are symbols, denotations, names and types?" -- "What is a compiler phase?" -- "What is the compiler Context?" - -and many more. +redirect_to: https://dotty.epfl.ch/docs/contributing/architecture/index.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/arch-lifecycle.md b/_overviews/scala3-contribution/arch-lifecycle.md index df403c1204..917e5a7824 100644 --- a/_overviews/scala3-contribution/arch-lifecycle.md +++ b/_overviews/scala3-contribution/arch-lifecycle.md @@ -1,96 +1,5 @@ --- title: Compiler Overview -type: section description: This page describes the lifecycle for the Scala 3 compiler. -num: 14 -previous-page: arch-intro -next-page: arch-context ---- - -At a high level, `dotc` is an interactive compiler (see [what is a compiler?][whats-a-compiler]), -and can be invoked frequently, for example to answer questions for an IDE, provide REPL completions, -or to manage incremental builds and more. Each of these use cases requires a customised -workflow, but sharing a common core. - -## Introducing the Compiler's Lifecycle - -#### Core -Customisation is provided by extending the [Compiler] class, which maintains an ordered -list of [phases][Phases], and how to [run][Run] them. Each interaction with a compiler -creates a new run, which is a complete iteration of the compiler's phases over a list -of input sources. Each run has the capability to create new definitions or -invalidate older ones, and `dotc` can [track these changes over time][time]. - -#### Runs -During a run, the input sources are converted to [compilation units][CompilationUnit] (i.e. the abstraction of -compiler state associated with each input source); then iteratively: a single phase is applied to -every compilation unit before progressing to the next phase. - -#### Phases -A phase is an abstract transformation over a compilation unit, it is usually responsible -for transforming the trees and types representing the code of a source file. Some phases of -the compiler are: -- `parser`, which converts text that matches Scala's - [syntax] into abstract syntax trees, ASTs -- `typer`, which checks that trees conform to expected types -- `erasure`, which retypes a more simplified program into one that has the same types as the JVM. -- `genBCode`, the JVM backend, which converts erased compiler trees into Java bytecode format. - -[You can read more about phases here][phase-categories]. - -#### Drivers - -The core compiler also requires a lot of state to be initialised before use, such as [settings][ScalaSettings] -and the [Context][contexts]. For convenience, the [Driver] class contains high level functions for -configuring the compiler and invoking it programatically. The object [Main] inherits from `Driver` -and is invoked by the `scalac` script. - -## Code Structure - -The code of the compiler is found in the package [dotty.tools], -containing the following sub-packages: -```scala -tools // contains helpers and the `scala` generic runner -├── backend // Compiler backends (currently JVM and JS) -├── dotc // The main compiler, with subpackages: -│ ├── ast // Abstract syntax trees -│   ├── classpath -│   ├── config // Compiler configuration, settings, platform specific definitions. -│   ├── core // Core data structures and operations, with specific subpackages for: -│   │   ├── classfile // Reading of Java classfiles into core data structures -│   │   ├── tasty // Reading and writing of TASTY files to/from core data structures -│   │   └── unpickleScala2 // Reading of Scala2 symbol information into core data structures -│   ├── decompiler // pretty printing TASTY as code -│   ├── fromtasty // driver for recompilation from TASTY -│   ├── interactive // presentation compiler and code completions -│   ├── parsing // Scanner and parser -│   ├── plugins // compile plugin definitions -│   ├── printing // Pretty-printing trees, types and other data -│   ├── profile // internals for profiling the compiler -│   ├── quoted // internals for quoted reflection -│   ├── reporting // Reporting of error messages, warnings and other info. -│   ├── rewrites // Helpers for rewriting Scala 2's constructs into Scala 3's. -│   ├── sbt // Helpers for communicating with the Zinc compiler. -│   ├── semanticdb // Helpers for exporting semanticdb from trees. -│   ├── transform // Miniphases and helpers for tree transformations. -│   ├── typer // Type-checking -│   └── util // General purpose utility classes and modules. -├── io // Helper modules for file access and classpath handling. -├── repl // REPL driver and interaction with the terminal -├── runner // helpers for the `scala` generic runner script -└── scripting // scala runner for the -script argument -``` - -[whats-a-compiler]: {% link _overviews/scala3-contribution/contribution-intro.md %}#what-is-a-compiler -[Phases]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Phases.scala -[CompilationUnit]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/CompilationUnit.scala -[time]: {% link _overviews/scala3-contribution/arch-time.md %} -[dotty.tools]: https://github.com/lampepfl/dotty/tree/master/compiler/src/dotty/tools -[ScalaSettings]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/config/ScalaSettings.scala -[phase-categories]: {% link _overviews/scala3-contribution/arch-phases.md %}#phase-categories -[syntax]: {{ site.scala3ref }}/syntax.html -[Main]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Main.scala -[Driver]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Driver.scala -[Compiler]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Compiler.scala -[Run]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Run.scala -[contexts]: {% link _overviews/scala3-contribution/arch-context.md %} +redirect_to: https://dotty.epfl.ch/docs/contributing/architecture/lifecycle.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/arch-phases.md b/_overviews/scala3-contribution/arch-phases.md index bc445816f5..25db11e6a3 100644 --- a/_overviews/scala3-contribution/arch-phases.md +++ b/_overviews/scala3-contribution/arch-phases.md @@ -1,113 +1,5 @@ --- title: Compiler Phases -type: section description: This page describes the phases for the Scala 3 compiler. -num: 16 -previous-page: arch-context -next-page: arch-types ---- - -As described in the [compiler overview][lifecycle], `dotc` is divided into a list of [phases][Phase], -specified in the [Compiler] class. - -#### Printing the phases of the Compiler - -a flattened list of all the phases can be displayed by invoking -the compiler with the `-Xshow-phases` flag: -``` -$ scalac -Xshow-phases -``` - -## Phase Groups - -In class [Compiler] you can access the list of phases with the method `phases`: - -```scala -def phases: List[List[Phase]] = - frontendPhases ::: picklerPhases ::: transformPhases ::: backendPhases -``` - -You can see that phases are actually grouped into sublists, given by the signature -`List[List[Phase]]`; that is, each sublist forms a phase group that is then *fused* into a -single tree traversal when a [Run] is executed. - -Phase fusion allows each phase of a group to be small and modular, -(each performing a single function), while reducing the number of tree traversals -and increasing performance. - -Phases are able to be grouped together if they inherit from [MiniPhase]. - -## Phase Categories - -Phases fall into four categories, allowing customisation by sub-classes of [Compiler]: - -### `frontendPhases` -In the main compiler these include [parser], [typer], [posttyper], -[prepjsinterop] and phases for producing SemanticDB and communicating with the -incremental compiler Zinc. -The [parser] reads source programs and generates untyped abstract syntax trees, which -in [typer] are then typechecked and transformed into typed abstract syntax trees. -Following is [posttyper], performing checks and cleanups that require a fully typed program. -In particular, it -- creates super accessors representing `super` calls in traits -- creates implementations of compiler-implemented methods, -such as `equals` and `hashCode` for case classes. -- marks [compilation units][CompilationUnit] that require inline expansion, or quote pickling -- simplifies trees of erased definitions -- checks variance of type parameters -- mark parameters passed unchanged from subclass to superclass for later pruning. - -### `picklerPhases` -These phases start with [pickler], which serializes typed trees -produced by the `frontendPhases` into TASTy format. Following is [inlining], -which expand calls to inline methods, and [postInlining] providing implementations -of the [Mirror] framework for inlined calls. -Finally are [staging], which ensures that quotes conform to the -[Phase Consistency Principle (PCP)][PCP], and [pickleQuotes] which converts quoted -trees to embedded TASTy strings. - -### `transformPhases` -These phases are concerned with tranformation into lower-level forms -suitable for the runtime system, with two sub-groupings: -- High-level transformations: All phases from [firstTransform] to [erasure]. - Most of these phases transform syntax trees, expanding high-level constructs - to more primitive ones. - - An important transform phase is [patternMatcher], which converts match - trees and patterns into lower level forms, as well as checking the - exhaustivity of sealed types, and unreachability of pattern cases. - - Some phases perform further checks on more primitive trees, - e.g. [refchecks] verifies that no abstract methods exist in concrete classes, - and [initChecker] checks that fields are not used before initialisation. - - The last phase in the group, [erasure] translates all - types into types supported directly by the JVM. To do this, it performs - another type checking pass, but using the rules of the JVM's type system - instead of Scala's. -- Low-level transformations: All phases from `ElimErasedValueType` to - `CollectSuperCalls`. These further transform trees until they are essentially a - structured version of Java bytecode. - -### `backendPhases` -These map the transformed trees to Java classfiles or SJSIR files. - -[lifecycle]: {% link _overviews/scala3-contribution/arch-lifecycle.md %}#phases -[CompilationUnit]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/CompilationUnit.scala -[Compiler]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Compiler.scala -[Phase]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Phases.scala -[MiniPhase]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/MegaPhase.scala -[Run]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/Run.scala -[parser]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/parsing/ParserPhase.scala -[typer]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/typer/TyperPhase.scala -[posttyper]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/PostTyper.scala -[prepjsinterop]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/sjs/PrepJSInterop.scala -[pickler]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/Pickler.scala -[inlining]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/Inlining.scala -[postInlining]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/PostInlining.scala -[staging]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/Staging.scala -[pickleQuotes]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/PickleQuotes.scala -[refchecks]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/typer/RefChecks.scala -[initChecker]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/init/Checker.scala -[firstTransform]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/FirstTransform.scala -[patternMatcher]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/PatternMatcher.scala -[erasure]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/Erasure.scala -[Mirror]: https://github.com/lampepfl/dotty/blob/master/library/src/scala/deriving/Mirror.scala -[PCP]: {{ site.scala3ref }}/metaprogramming/macros.html#the-phase-consistency-principle +redirect_to: https://dotty.epfl.ch/docs/contributing/architecture/phases.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/arch-symbols.md b/_overviews/scala3-contribution/arch-symbols.md index cbe3e1e075..5ec3408b51 100644 --- a/_overviews/scala3-contribution/arch-symbols.md +++ b/_overviews/scala3-contribution/arch-symbols.md @@ -1,76 +1,5 @@ --- title: Symbols -type: section description: This page describes symbols in the Scala 3 compiler. -num: 19 -previous-page: arch-time -next-page: ---- - -As discussed previously, `dotc` [maintains time-indexed views][arch-time] of various -compiler artifacts. The following sections discuss how they are managed in the compiler. - -## Symbols - -Defined in [Symbols], a `Symbol` is a unique identifier for a definition (e.g. a method, -type, or field). A `ClassSymbol` extends `Symbol` and represents either a -`class`, or a `trait`, or an `object`. A `Symbol` can even refer to non-Scala entities, -such as from the Java standard library. - -## Definitions are Dynamic - -Traditionally, compilers store context-dependent data in a _symbol table_. -Where a symbol then is the central reference to address context-dependent data. -`dotc` instead uses a phase-indexed function (known as -a [Denotation][Denotations]) to compute views of definitions across phases, -as many of attributes associated with definitions are phase-dependent. For example: -- types are gradually simplified by several phases, -- owners change in [lambdaLift] (local methods are lifted to an enclosing class) - and [flatten] (when inner classes are moved to the top level) -- Names are changed when private members need to be accessed from outside - their class (for instance from a nested class or a class implementing - a trait). - -Additionally, symbols are not suitable to be used as a reference to -a definition in another [compilation unit][CompilationUnit]. -In the context of incremental compilation, a symbol from -an external compilation unit may be deleted or changed, making the reference -stale. To counter this, `dotc` types trees of cross-module references with either -a `TermRef` or `TypeRef`. A reference type contains a prefix type and a name. -The denotation that the type refers to is established dynamically based on -these fields. - -## Denotations - -On its own a `Symbol` has no structure. Its semantic meaning is given by being associated -with a [Denotation][Denotations]. - -A denotation is the result of resolving a name during a given period, containing the information -describing some entity (either a term or type), indexed by phase. Denotations usually have a -reference to a selected symbol, but not always, for example if the denotation is overloaded, -i.e. a `MultiDenotation`. - -### SymDenotations -All definition symbols will contain a `SymDenotation`. The denotation, in turn, contains: -- a reverse link to the source symbol -- a reference to the enclosing symbol that defined the source symbol: - - for a local variable, the enclosing method - - for a field or class, the enclosing class -- a set of [flags], describing the definition (e.g. whether it's a trait or mutable). -- the type of the definition (through the `info` method) -- a [signature][Signature1], which uniquely identifies overloaded methods (or else `NotAMethod`). -- and more. - -A class symbol will instead be associated with a `ClassDenotation`, which extends `SymDenotation` -with some additional fields specific for classes. - -[Signature1]: https://github.com/lampepfl/dotty/blob/a527f3b1e49c0d48148ccfb2eb52e3302fc4a349/compiler/src/dotty/tools/dotc/core/Signature.scala#L9-L33 -[Symbols]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Symbols.scala -[lifecycle]: {% link _overviews/scala3-contribution/arch-lifecycle.md %}#introducing-the-compilers-lifecycle -[arch-time]: {% link _overviews/scala3-contribution/arch-time.md %} -[flatten]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/Flatten.scala -[lambdaLift]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/LambdaLift.scala -[CompilationUnit]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/CompilationUnit.scala -[Denotations]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Denotations.scala -[SymDenotations]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/SymDenotations.scala -[flags]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Flags.scala +redirect_to: https://dotty.epfl.ch/docs/contributing/architecture/symbols.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/arch-time.md b/_overviews/scala3-contribution/arch-time.md index 03894a241b..a56fed21a5 100644 --- a/_overviews/scala3-contribution/arch-time.md +++ b/_overviews/scala3-contribution/arch-time.md @@ -1,76 +1,5 @@ --- title: Time in the Compiler -type: section description: This page describes the concepts of time in the Scala 3 compiler. -num: 18 -previous-page: arch-types -next-page: arch-symbols ---- - -In the [compiler overview][lifecycle] section, we saw that `dotc` is an interactive compiler, -and so can answer questions about entities as they come into existance and change throughout time, -for example: -- which new definitions were added in a REPL session? -- which definitions were replaced in an incremental build? -- how are definitions simplified as they are adapted to the runtime system? - -## Hours, Minutes, and Periods - -For the compiler to be able to resolve the above temporal questions, and more, it maintains -a concept of time. Additionally, because interactions are frequent, it is important to -persist knowledge of entities between interactions, allowing the compiler to remain performant. -Knowing about time allows the compiler to efficiently mark entities as being outdated. - -Conceptually, `dotc` works like a clock, where its minutes are represented by [phases], -and its hours by [runs]. Like a clock, each run passes once each of its phases have completed -sequentially, and then a new run can begin. Phases are further grouped into [periods], where -during a period certain entities of the compiler remain stable. - -## Time Travel - -During a run, each phase can rewrite the world as the compiler sees it, for example: -- to transform trees, -- to gradually simplify type from Scala types to JVM types, -- to move definitions out of inner scopes to outer ones, fitting the JVM's model, -- and so on. - -Because definitions can [change over time][dynamic], various artifacts associated with them -are stored non-destructively, and views of the definition created earlier, or later -in the compiler can be accessed by using the `atPhase` method, defined in [Contexts]. - -As an example, assume the following definitions are available in a [Context]: -```scala -class Box { type X } - -def foo(b: Box)(x: b.X): List[b.X] = List(x) -``` - -You can compare the type of definition `foo` after the [typer] phase and after the [erasure] phase -by using `atPhase`: -```scala -import dotty.tools.dotc.core.Contexts.{Context, atPhase} -import dotty.tools.dotc.core.Phases.{typerPhase, erasurePhase} -import dotty.tools.dotc.core.Decorators.i - -given Context = … - -val fooDef: Symbol = … // `def foo(b: Box)(x: b.X): List[b.X]` - -println(i"$fooDef after typer => ${atPhase(typerPhase.next)(fooDef.info)}") -println(i"$fooDef after erasure => ${atPhase(erasurePhase.next)(fooDef.info)}") -``` -and see the following output: -``` -method foo after typer => (b: Box)(x: b.X): scala.collection.immutable.List[b.X] -method foo after erasure => (b: Box, x: Object): scala.collection.immutable.List -``` - -[runs]: https://github.com/lampepfl/dotty/blob/a527f3b1e49c0d48148ccfb2eb52e3302fc4a349/compiler/src/dotty/tools/dotc/Run.scala -[periods]: https://github.com/lampepfl/dotty/blob/a527f3b1e49c0d48148ccfb2eb52e3302fc4a349/compiler/src/dotty/tools/dotc/core/Periods.scala -[lifecycle]: {% link _overviews/scala3-contribution/arch-lifecycle.md %} -[phases]: {% link _overviews/scala3-contribution/arch-phases.md %} -[dynamic]: {% link _overviews/scala3-contribution/arch-symbols.md %}#definitions-are-dynamic -[Contexts]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Contexts.scala -[Context]: {% link _overviews/scala3-contribution/arch-context.md %} -[typer]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/typer/TyperPhase.scala -[erasure]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/Erasure.scala +redirect_to: https://dotty.epfl.ch/docs/contributing/architecture/time.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/arch-types.md b/_overviews/scala3-contribution/arch-types.md index 38cf0f3020..cadcee16f2 100644 --- a/_overviews/scala3-contribution/arch-types.md +++ b/_overviews/scala3-contribution/arch-types.md @@ -1,152 +1,5 @@ --- title: Compiler Types -type: section description: This page discusses the representation of types in the compiler -num: 17 -previous-page: arch-phases -next-page: arch-time ---- - -## Common Types and their Representation - -Type representations in `dotc` derive from the class `dotty.tools.dotc.core.Types.Type`, -defined in [Types.scala]. The `toString` method on `Type` will display types in a -format corresponding to the backing data structure, e.g. `ExprType(...)` -corresponds to `class ExprType`, defined in [Types.scala]. - -> You can inspect the representation of any type using the [dotty.tools.printTypes][DottyTypeStealer] -> script, its usage and integration into your debugging workflow is [described here][inspecting-types]. - -### Types of Definitions - -The following table describes definitions in Scala 3, followed by the `dotc` representation -of two types - a reference to the definition, and then its underlying type. - -**Note**: in the following types, `p` refers to the self-type of the enclosing scope of -the definition, or `NoPrefix` for local definitions and parameters. - -Definition | Reference | Underlying Type -------------------------|-----------------|------------------------- -`type Z >: A <: B` | `TypeRef(p, Z)` | `RealTypeBounds(A, B)` -`type Z = A` | `TypeRef(p, Z)` | `TypeAlias(A)` -`type F[T] = T match …` | `TypeRef(p, F)` | `MatchAlias([T] =>> T match …)` -`class C` | `TypeRef(p, C)` | `ClassInfo(p, C, …)` -`trait T` | `TypeRef(p, T)` | `ClassInfo(p, T, …)` -`object o` | `TermRef(p, o)` | `TypeRef(p, o$)` where `o$` is a class -`def f(x: A): x.type` | `TermRef(p, f)` | `MethodType(x, A, TermParamRef(x))` -`def f[T <: A]: T` | `TermRef(p, f)` | `PolyType(T, <: A, TypeParamRef(T))` -`def f: A` | `TermRef(p, f)` | `ExprType(A)` -`(x: => A)` | `TermRef(p, x)` | `ExprType(A)` where `x` is a parameter -`val x: A` | `TermRef(p, x)` | `A` - -### Types of Values - -The following types may appear in part of the type of an expression: - -Type | Representation ---------------------------|------------------------------ -`x.y.type` | `TermRef(x, y)` -`X#T` | `TypeRef(X, T)` -`x.y.T` and `x.y.type#T` | `TypeRef(TermRef(x, y), T)` -`this.type` | `ThisType(C)` where `C` is the enclosing class -`"hello"` | `ConstantType(Constant("hello"))` -`A & B` | `AndType(A, B)` -`A | B` | `OrType(A, B)` -`A @foo` | `AnnotatedType(A, @foo)` -`[T <: A] =>> T` | `HKTypeLambda(T, <: A, TypeParamRef(T))` -`x.C[A, B]` | `AppliedType(x.C, List(A, B))` -`C { type A = T }` | `RefinedType(C, A, T)`<br/>when `T` is not a member of `C` -`C { type X = Y }` | `RecType(RefinedType(C, X, z.Y))`<br/>when `X` and `Y` are members of `C`<br/>and `z` is a `RecThis` over the enclosing `RecType` -`super.x.type` | `TermRef(SuperType(…), x)` - -## Constructing Types - -### Method Definition Types - -You can see above that method definitions can have an underlying type of -either `PolyType`, `MethodType`, or `ExprType`. `PolyType` and `MethodType` -may be mixed recursively however, and either can appear as the result type of the other. - -Take this example as given: - -```scala -def f[A, B <: Seq[A]](x: A, y: B): Unit -``` -it can be constructed by the following code: - -```scala -import dotty.tools.dotc.core.Types.* -import dotty.tools.dotc.core.Symbols.* -import dotty.tools.dotc.core.Contexts.* -import dotty.tools.dotc.core.Decorators.* - -given Context = … // contains the definitions of the compiler - -val f: Symbol = … // def f[A, B <: Seq[A]](x: A, y: B): Unit - -f.info = PolyType( - List("A".toTypeName, "B".toTypeName))( - pt => List( - TypeBounds(defn.NothingType, defn.AnyType), - TypeBounds(defn.NothingType, AppliedType(defn.SeqType, List(pt.newParamRef(0)))) - ), - pt => MethodType( - List("x".toTermName, "y".toTermName))( - mt => List(pt.newParamRef(0), pt.newParamRef(1)), - mt => defn.UnitType - ) -) -``` - -Note that `pt.newParamRef(0)` and `pt.newParamRef(1)` refers to the -type parameters `A` and `B` respectively. - -## Proxy Types and Ground Types -Types in `dotc` are divided into two semantic kinds: -- Ground Types (inheriting from either `CachedGroundType` or `UncachedGroundType`) -- Proxy Types (inheriting from `TypeProxy` via either `CachedProxyType` or `UncachedProxyType`) - -A Proxy Type is anything that can be considered to be an abstraction of another type, -which can be accessed by the `underlying` method of the `TypeProxy` class. It's dual, the -Ground Type has no meaningful underlying type, typically it is the type of method and class -definitions, but also union types and intersection types, along with utility types of the -compiler. - -Here's a diagram, serving as the mental model of the most important and distinct types available after the `typer` phase, derived from [dotty/tools/dotc/core/Types.scala][1]: - -``` -Type -+- proxy_type --+- NamedType --------+- TypeRef - | | \ - | +- SingletonType ----+- TermRef - | | +- ThisType - | | +- SuperType - | | +- ConstantType - | | +- TermParamRef - | | +- RecThis - | | +- SkolemType - | +- TypeParamRef - | +- RefinedOrRecType -+-- RefinedType - | | -+-- RecType - | +- AppliedType - | +- TypeBounds - | +- ExprType - | +- AnnotatedType - | +- TypeVar - | +- HKTypeLambda - | +- MatchType - | - +- ground_type -+- AndType - +- OrType - +- MethodOrPoly -----+-- PolyType - | +-- MethodType - +- ClassInfo - +- NoType - +- NoPrefix - +- ErrorType - +- WildcardType - -``` - -[Types.scala]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Types.scala -[DottyTypeStealer]: https://github.com/lampepfl/dotty/blob/master/compiler/test/dotty/tools/DottyTypeStealer.scala -[inspecting-types]: {% link _overviews/scala3-contribution/procedures-inspection.md %}#inspecting-the-representation-of-types +redirect_to: https://dotty.epfl.ch/docs/contributing/architecture/types.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/contribution-intro.md b/_overviews/scala3-contribution/contribution-intro.md index e20377d74b..45e96f7be0 100644 --- a/_overviews/scala3-contribution/contribution-intro.md +++ b/_overviews/scala3-contribution/contribution-intro.md @@ -1,45 +1,4 @@ --- -title: About This Guide -type: chapter +title: Contribute to Scala 3 description: This page describes the format of the contribution guide for the Scala 3 compiler. -num: 1 -previous-page: -next-page: start-intro ---- - -This guide is intended to give new contributors the knowledge they need to -become productive and fix issues or implement new features in Scala 3. It -also documents the inner workings of the Scala 3 compiler, `dotc`. - -### This is a living document - -Keep in mind that the code for `dotc` is continually changing, so the ideas -discussed in this guide may fall out of date. This is a living document, so -please consider contributing to it on -[GitHub](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-contribution) -if you notice anything out of date, or report any issues -[here](https://github.com/scala/docs.scala-lang/issues). - -### Get the Most from This Guide - -`dotc` is built with Scala 3, fully utilising its [new -features](/scala3/new-in-scala3.html). It is recommended that you first have -some familiarity with Scala 3 to get the most out of this guide. You can learn -more in the [language reference]({{ site.scala3ref }}). - -Many code snippets in this guide make use of shell commands (a line beginning -with `$`), and in this case a `bash` compatible shell is assumed. You may have -to look up how to translate commands to your shell. - -### What is a Compiler? - -Let's start at the beginning and first look at the question of "what is a -compiler?". A compiler is a program that takes as input text, representing a -program in one language and produces as output the same program, written in -another programming language. - -#### The Scala Compiler - -As an example, `dotc` takes text input, verifies that it is a valid Scala program -and then produces as output the same program, but written in Java bytecode, and optionally -in SJSIR when producing Scala.js output. +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-areas.md b/_overviews/scala3-contribution/procedures-areas.md index 7d3e0e6ec5..74d593b4ac 100644 --- a/_overviews/scala3-contribution/procedures-areas.md +++ b/_overviews/scala3-contribution/procedures-areas.md @@ -1,74 +1,5 @@ --- title: Common Issue Locations -type: section description: This page describes common areas of issues around the Scala 3 compiler. -num: 8 -previous-page: procedures-navigation -next-page: procedures-inspection ---- - -Many issues are localised to small domains of the compiler and are self-contained, -here is a non-exhaustive list of such domains, and the files associated with them: - -### Pretty Printing of Types and Trees - -Objects in the compiler that inherit from [Showable] can be pretty printed. -The pretty-printing of objects is used in many places, from debug output, -to user-facing error messages and printing of trees after each phase. - -Look in [RefinedPrinter] (or its parent class [PlainPrinter]) for the implementation of pretty printing. - -### Content of Error Messages - -You can find the definitions of most error messages in [messages] (with IDs -defined in [ErrorMessageID]). If the message is not defined there, try the -`-Ydebug-error` compiler flag, which will print a stack trace leading to the -production of the error, and the contents of the message. - -### Compiler Generated Given Instances - -If the issue lies in given instances provided by the compiler, such as `scala.reflect.ClassTag`, -`scala.deriving.Mirror`, `scala.reflect.TypeTest`, `scala.CanEqual`, `scala.ValueOf`, -`scala.reflect.Manifest`, etc, look in [Synthesizer], which provides factories for -given instances. - -### Compiler Generated Methods - -Members can be generated for many classes, such as `equals` and `hashCode` -for case classes and value classes, and `ordinal` and `fromProduct` for Mirrors. -To change the implementation, see [SyntheticMembers]. - -### Code Completions -For suggestions to auto-complete method selections, see [Completion]. - -### Enum Desugaring -See [Desugar] and [DesugarEnums]. - -### Pattern Match Exhaustivity -See [Space]. - -### Metaprogramming - -#### Quotes Reflection -See the [quoted runtime package][quotes-impl]. - -#### Inline match -See [Inliner]. - -#### Compiletime Ops Types -See `tryCompiletimeConstantFold` in [Types]. - -[Showable]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/printing/Showable.scala -[PlainPrinter]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/printing/PlainPrinter.scala -[RefinedPrinter]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/printing/RefinedPrinter.scala -[ErrorMessageID]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/reporting/ErrorMessageID.scala -[messages]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/reporting/messages.scala -[Synthesizer]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/typer/Synthesizer.scala -[SyntheticMembers]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/SyntheticMembers.scala -[quotes-impl]: https://github.com/lampepfl/dotty/tree/master/compiler/src/scala/quoted/runtime/impl -[Inliner]: https://github.com/lampepfl/dotty/blob/main/compiler/src/dotty/tools/dotc/inlines/Inliner.scala -[Types]: https://github.com/lampepfl/dotty/tree/master/compiler/src/dotty/tools/dotc/core/Types.scala -[Completion]: https://github.com/lampepfl/dotty/tree/master/compiler/src/dotty/tools/dotc/interactive/Completion.scala -[DesugarEnums]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/ast/DesugarEnums.scala -[Desugar]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/ast/Desugar.scala -[Space]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/patmat/Space.scala +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/areas.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-cheatsheet.md b/_overviews/scala3-contribution/procedures-cheatsheet.md index c3c114e97b..0eee11a1fe 100644 --- a/_overviews/scala3-contribution/procedures-cheatsheet.md +++ b/_overviews/scala3-contribution/procedures-cheatsheet.md @@ -1,35 +1,5 @@ --- title: Cheatsheets -type: section description: This page describes a cheatsheet for working with the Scala 3 compiler. -num: 4 -previous-page: procedures-intro -next-page: procedures-reproduce ---- - -This page is a quick-reference guide for common tasks while working with the compiler. -For more in-depth explanations, see the rest of this chapter. - -## sbt Commands - -The following commands can be run within `sbt` in the dotty directory: - -| Commands | -|-----------------------------------------------------------------------------------------------| -| `testCompilation` Run compilation tests on files that match the first argument. | -| `scala3/scalac` Run the compiler directly, with any current changes. | -| `scala3/scala` Run the main method of a given class name. | -| `repl` Start a REPL with the bootstrapped compiler. | -| `testOnly *CompilationTests -- *pos` Run test `pos` from the compilation test suite. | -| `scala3-compiler/Test/runMain dotty.tools.printTypes` Print types underlying representation | -| `scala3/scalac -print-tasty Foo.tasty` Print the TASTy of top-level class `Foo` | -| `scala3-bootstrapped/test` Run all tests for Scala 3. (Slow, recommended for CI only) | -| `scala3-bootstrapped/publishLocal` Build Scala 3 locally. (Use to debug a specific project) | - -## Shell Commands - -| Command | Description | -|--------------------------------------|------------------------------------------------------------------| -| `rm -rv *.tasty *.class out || true` | clean all compiled artifacts, from root dotty directory | - -<!-- Todo: add cheatsheet for compiler flags, and places to go in code for certain issues --> +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/index.html#sbt-commands-cheat-sheet-1 +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-checklist.md b/_overviews/scala3-contribution/procedures-checklist.md index 5e1c34343e..6908332d2d 100644 --- a/_overviews/scala3-contribution/procedures-checklist.md +++ b/_overviews/scala3-contribution/procedures-checklist.md @@ -1,140 +1,5 @@ --- title: Pull Request Checklist -type: section description: This page describes a checklist before opening a Pull Request to the Scala 3 compiler. -num: 12 -previous-page: procedures-testing -next-page: arch-intro ---- - -Once you solved the issue you were working on, you'll likely want to see your -changes added to the [Scala 3 repo][lampepfl/dotty]. To do that, you need to -prepare a [pull request][pull-request] with your changes. Assuming that the team -is aware of what you've been working, here are some final steps that you'll want -to keep in mind as you create your PR. - -### 1. Sign the CLA - -Make sure you have signed the [Scala CLA][cla]. If you have any questions about -what this is and why it's required you can read further about it [here][cla]. - -### 2. Make sure your work is on its own branch - -When submitting your pull request it's always best to ensure the branch name is -unique to the changes you're working on. It's important not to submit your PR on -your `main` branch as this blocks maintainers from making any changes to your PR -if necessary. - -### 3: Add Tests - -Add at least one test that replicates the problem in the issue, and that shows it is now resolved. - -You may of course add variations of the test code to try and eliminate edge cases. -[Become familiar with testing in Scala 3][testing]. - -### 4: Add Documentation - -Please ensure that all code is documented to explain its use, even if only internal -changes are made. This refers to scaladocs and also any changes that might be -necessary in the reference docs. - -### 5: Double check everything - -Here are a couple tips to keep in mind. - -- [DRY (Don't Repeat Yourself)][dry] -- [Scouts Rule][scouts] -- When adding new code try use [optional braces]. If you're rewriting old code, - you should also use optional braces unless it introduces more code changes - that necessary. - -### 6: Commit Messages - -Here are some guidelines when writing commits for Dotty. - -1. If your work spans multiple local commits (for example; if you do safe point - commits while working in a feature branch or work in a branch for long time - doing merges/rebases etc.) then please do not commit it all but rewrite the - history by squashing the commits into one large commit which is accompanied - by a detailed commit message for (as discussed in the following sections). - For more info, see the article: [Git Workflow][git-workflow]. Additionally, - every commit should be able to be used in isolation—that is, each commit must - build and pass all tests. - -2. The first line should be a descriptive sentence about what the commit is - doing. It should be possible to fully understand what the commit does by just - reading this single line. It is **not ok** to only list the ticket number, - type "minor fix" or similar. If the commit has a corresponding ticket, - include a reference to the ticket number, prefixed with "Closes #", at the - beginning of the first line followed by the title of the ticket, assuming - that it aptly and concisely summarizes the commit in a single line. If the - commit is a small fix, then you are done. If not, go to 3. - -3. Following the single line description (ideally no more than 70 characters - long) should be a blank line followed by an enumerated list with the details - of the commit. - -4. Add keywords for your commit (depending on the degree of automation we reach, - the list may change over time): - * ``Review by @githubuser`` - will notify the reviewer via GitHub. Everyone - is encouraged to give feedback, however. (Remember that @-mentions will - result in notifications also when pushing to a WIP branch, so please only - include this in your commit message when you're ready for your pull - request to be reviewed. Alternatively, you may request a review in the - pull request's description.) - * ``Fix/Fixing/Fixes/Close/Closing/Refs #ticket`` - if you want to mark the - ticket as fixed in the issue tracker (Assembla understands this). - * ``backport to _branch name_`` - if the fix needs to be cherry-picked to - another branch (like 2.9.x, 2.10.x, etc) - -Example: - -``` -fix: here is your pr title briefly mentioning the topic - -Here is the body of your pr with some more information - - Details 1 - - Details 2 - - Details 3 - -Closes #2 -``` - -### 7: Create your PR! - -When the feature or fix is completed you should open a [Pull -Request](https://help.github.com/articles/using-pull-requests) on GitHub. - -If you're not actually finished yet and are just looking for some initial input -on your approach, feel free to open a [Draft PR][draft]. This lets reviewers -know that you're not finished yet. It's also a good idea to put a [wip] in front -of your pr title to make this extra clear. - -Shortly after creating your pull request a maintainer should assign someone to -review it. If this doesn't happen after a few days, feel free to ping someone on -the [Scala Contributors Discor][discord] or tag someone on the PR. Depending on -the type of pull request there might be multiple people that take a look at your -changes. There might also be community input as we try to keep the review -process as open as possible. - -### 8: Addressing feedback - -More than likely you'll get feedback from the reviewers, so you'll want to make -sure to address everything. When in doubt, don't hesitate to ask for -clarification or more information. - -Once you finally see the "LGTM" (Looks Good To Me or Let's Get This Merged) -you're PR will be merged in! - -[pull-request]: https://docs.github.com/en?query=pull+requests -[lampepfl/dotty]: https://github.com/lampepfl/dotty -[cla]: http://typesafe.com/contribute/cla/scala -[issues]: https://github.com/lampepfl/dotty/issues -[full-list]: https://github.com/lampepfl/dotty/blob/master/CONTRIBUTING.md -[testing]: {% link _overviews/scala3-contribution/procedures-testing.md %} -[discord]: https://discord.gg/TSmY9zkHar -[dry]: https://www.oreilly.com/library/view/97-things-every/9780596809515/ch30.html -[scouts]: https://www.oreilly.com/library/view/97-things-every/9780596809515/ch08.html -[optional-braces]: https://docs.scala-lang.org/scala3/reference/other-new-features/indentation.html -[draft]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests -[git-workflow]: http://sandofsky.com/blog/git-workflow.html +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/checklist.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-debugging.md b/_overviews/scala3-contribution/procedures-debugging.md index d9411040af..6fe158614d 100644 --- a/_overviews/scala3-contribution/procedures-debugging.md +++ b/_overviews/scala3-contribution/procedures-debugging.md @@ -1,193 +1,5 @@ --- title: Debugging the Compiler -type: section description: This page describes navigating around the Scala 3 compiler. -num: 7 -previous-page: procedures-navigation -next-page: procedures-areas +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/debugging.html --- - -The debugger is a powerful tool to navigate the internals of the compiler and track bugs. - -You can start the Scala debugger in VSCode using [Metals](https://scalameta.org/metals/). -In this page you will learn how to configure it, and how to use it. - -## Importing the project in VSCode using Metals - -The first step is to import the build in Metals, if it has not yet been imported. - -To do so you can open the [lampefl/dotty][lampepfl/dotty] repository in VSCode and click `Import build` in Metals view. -It may take a few minutes to import, compile and index the full project. - -![Import build](/resources/images/scala3-contribution/import-build.jpg) - -If you have any trouble with importing, you can try to switch the build server from Bloop to sbt, -by running the `Metals: Switch build server` command from VSCode command palette. - -## Configuring the debugger - -To configure the debugger in VSCode, you can go to the `Run and Debug` view and click `create a launch.json file`. -It creates the `launch.json` file in the `.vscode` folder, in which we will define the debug configurations. - -![Create launch.json file](/resources/images/scala3-contribution/launch-config-file.jpg) - -To create a debug configuration: -- Open the `.vscode/launch.json` file -- Click the `Add Configuration` button -- Go down the list of templates and select `Scala: Run main class` - -![Create configuration](/resources/images/scala3-contribution/create-config.jpg) - -The added configuration should look like this: -```json -{ - "type": "scala", - "request": "launch", - "name": "Untitled", - "mainClass": "???", - "args": [], - "jvmOptions": [], - "env": {} -} -``` - -This is a template that you need to fill out. -First You can give a `name` to your configuration, for instance `Debug Scala 3 Compiler`. - -The two most important parameters, to debug the compiler, are `mainClass` and `args`. -The `mainClass` of the compiler is `dotty.tools.dotc.Main`. -In the `args` you need to specify the compiler arguments, which must contain at least a Scala file to compile and a `-classpath` option. - -To start with, we can compile the `../tests/pos/HelloWorld.scala` file. -In the classpath, we always need at least the `scala-library_2.13` and the bootstrapped `scala3-library_3`. -To locate them on your filesystem you can run the `export scala3-library-bootstrapped/fullClasspath` command in sbt. - -``` -$ sbt -> export scala3-library-bootstrapped/fullClasspath -/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar -[success] Total time: 1 s, completed Mar 10, 2023, 4:37:43 PM -``` - -Note that it is important to use the bootstrapped version of the `scala3-library` to get the correct TASTy version. - -Additionally you can add the `-color` and `never` arguments to prevent the compiler from printing ANSI codes as strings in the debug console. - -Here is the final configuration: -```json -{ - "type": "scala", - "request": "launch", - "name": "Debug Scala 3 Compiler", - "mainClass": "dotty.tools.dotc.Main", - "args": [ - "../tests/pos/HelloWorld.scala", - "-classpath", - // To replace with your own paths - "/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar", - "-color", - "never" - ], - "jvmOptions": [], - "env": {} -} -``` - -## Customizing the debug configurations - -### Compiling several files at once - -You can compile more than one Scala file, by adding them in the `args`: -```json -"args": [ - "file1.scala", - "file2.scala", - "-classpath", - "/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar" -] -``` - -### Depending on a library - -To add a dependency to an external library you need to download it and all its transitive dependencies, and to add them in the classpath. -The Coursier CLI can help you to do that. -For instance to add a dependency to cats you can run: -``` -$ cs fetch org.typelevel::cats-core:2.+ --classpath --scala-version 3 --exclude org.scala-lang:scala-library --exclude org.scala-lang:scala3-library -/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/typelevel/cats-core_3/2.9.0/cats-core_3-2.9.0.jar:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/typelevel/cats-kernel_3/2.9.0/cats-kernel_3-2.9.0.jar -``` - -And concatenate the output into the classpath argument, which should already contain the scala-library_2.13 and the bootstrapped scala3-library: - -```json -"args": [ - "using-cats.scala", - "-classpath", - "/home/user/lampepfl/dotty/out/bootstrap/scala3-library-bootstrapped/scala-3.3.1-RC1-bin-SNAPSHOT-nonbootstrapped/classes:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.10/scala-library-2.13.10.jar:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/typelevel/cats-core_3/2.9.0/cats-core_3-2.9.0.jar:/home/user/.cache/coursier/v1/https/repo1.maven.org/maven2/org/typelevel/cats-kernel_3/2.9.0/cats-kernel_3-2.9.0.jar" -] -``` - -### Add more compiler options - -In the `args` you can add any additional compiler option you want. - -For instance you can add `-Xprint:all` to print all the generated trees after each mega phase. - -Run `scalac -help` to get an overview of the available compiler options. - -### Defining more than one launch configuration - -You can create as many debug configurations as you need: to compile different files, with different compiler options or different classpaths. - -## Starting the debugger - -Before starting the debugger you need to put a breakpoint in the part of the code that you want to debug. -If you don't know where to start, you can put a breakpoint in the `main` method of the `dotty.tools.dotc.Driver` trait. - -![First breakpoint](/resources/images/scala3-contribution/breakpoint.jpg) - -Now to start the debugger, open the debug view, find the drop-down list of all the debug configurations and click on yours. -The debugger should start and pause on your breakpoint. - -![Start debugger](/resources/images/scala3-contribution/start-debugger.jpg) - -## Using the debugger - -### Navigating the call stack - -When the debugger has paused, you can see the current call stack in the `Debug and Run` view. -Each frame of the call stack contains different variables, whose values you can see in the `Variables` section of the `Debug and Run` view. - -![Call stack](/resources/images/scala3-contribution/call-stack.jpg) - -Analysing the call stack and the variables can help you understand the path taken by the compiler to reach that state. - -### The debugging steps - -The debug toolbar contains the `Continue / Pause`, `Step Over`, `Step Into`, `Step Out`, `Restart` and `Stop` buttons. - -![Debugging steps](/resources/images/scala3-contribution/toolbar.jpg) - -You can use the step buttons to execute the code step by step and get a precise understanding of the program. - -### The debug console - -When the debugger has paused, you can evaluate any Scala 3 expression in the debug console. -This is useful to inspect some values or to execute some parts of the code. - -For instance, you can evaluate `tree.show` to pretty-print a tree. - -![Import build](/resources/images/scala3-contribution/debug-console.jpg) - -### Conditional breakpoints - -In a breakpoint you can define a condition, in the form of a Boolean expression written in Scala. -The program will stop on the breakpoint as soon as the condition is met. - -To add a condition, right-click on a breakpoint and pick `Edit breakpoint...`. - -For instance, if you know that a bug happens on typing a method `foo`, you can use the condition `tree.symbol.name.show == "foo"` in a breakpoint in the `Typer`. - -![Import build](/resources/images/scala3-contribution/conditional-breakpoint.jpg) - -[lampepfl/dotty]: https://github.com/lampepfl/dotty diff --git a/_overviews/scala3-contribution/procedures-efficiency.md b/_overviews/scala3-contribution/procedures-efficiency.md index 7db98f87ea..755424b138 100644 --- a/_overviews/scala3-contribution/procedures-efficiency.md +++ b/_overviews/scala3-contribution/procedures-efficiency.md @@ -1,28 +1,5 @@ --- title: Improving Your Workflow -type: section description: This page describes improving efficiency of debugging the Scala 3 compiler. -num: 10 -previous-page: procedures-inspection -next-page: procedures-testing ---- - -In the previous sections of this chapter, you saw some techniques for -working with the compiler. Some of these techniques can be used -repetitively, e.g.: - -- Navigating stack frames -- Printing variables in certain ways -- Instrumenting variable definitions with tracers - -The above procedures often take a lot of time when done manually, reducing productivity: -as the cost (in terms of time and effort) is high, you may avoid attempting to do so, -and possibly miss valuable information. - -If you're doing those things really frequently, it is recommended to script your editor -to reduce the number of steps. E.g. navigating to the definition of a stack frame -part when you click it, or instrumenting variables for printing. - -An example of how it is done for Sublime Text 3 is [here](https://github.com/anatoliykmetyuk/scala-debug-sublime). - -True, it takes some time to script your editor, but if you spend a lot of time with issues, it pays off. +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/efficiency.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-inspection.md b/_overviews/scala3-contribution/procedures-inspection.md index 891f3ee5eb..40ec4e2f92 100644 --- a/_overviews/scala3-contribution/procedures-inspection.md +++ b/_overviews/scala3-contribution/procedures-inspection.md @@ -1,188 +1,5 @@ --- title: How to Inspect Values -type: section description: This page describes inspecting semantic values in the Scala 3 compiler. -num: 9 -previous-page: procedures-areas -next-page: procedures-efficiency ---- - -In this section, you will find out how to debug the contents of certain objects -while the compiler is running, and inspect produced artifacts of the compiler. - -## Inspecting variables in-place - -Frequently you will need to inspect the content of a particular variable. -You can either use `println`s or the debugger, more info on how to setup the latter [here]({% link _overviews/scala3-contribution/procedures-debugging.md %}). - -In the remeainder of this article we'll use `println(<someUsefulExpression>)` inserted in the code, but the same effect can be accomplished by stopping at a breakpoint, and typing `<someUsefulExpression>` in the [debug console]({% link _overviews/scala3-contribution/procedures-debugging.md %}#the-debug-console) of the debugger. - -When printing a variable, it's always a good idea to call `show` on that variable: `println(x.show)`. -Many objects of the compiler define `show`, returning a human-readable string. -e.g. if called on a tree, the output will be the tree's representation as source code, rather than -the underlying raw data. - -Sometimes you need to print flags. Flags are metadata attached to [symbols] containing information such as whether a -class is abstract, comes from Java, what modifiers a variable has (private, protected etc) and so on. -Flags are stored in a single `Long` value, each bit of which represents whether a particular flag is set. - -To print flags, you can use the `flagsString` method, e.g. `println(x.flagsString)`. - -## Pretty Printing with a String Interpolator - -You can also pretty print objects with string interpolators, -these default to call `.show` when possible, avoiding boilerplate -and also helping format error messages. - -Import them with the following: - -```scala -import dotty.tools.dotc.core.Decorators.* -``` - -Here is a table of explanations for their use: - -| Usage | Description | -|--------|-----------------------------------| -|`i""` | General purpose string formatting. It calls `.show` on objects <br/> mixing in Showable, `String.valueOf` otherwise | -|`em""` | Formatting for error messages: Like `i` but suppress <br/>follow-on, error messages after the first one if some <br/>of their arguments are "non-sensical". | -|`ex""` | Formatting with added explanations: Like `em`, but add <br/>explanations to give more info about type variables<br/>and to disambiguate where needed. | - - -## Obtaining debug output from the compiler - -As explained in [navigation], we can debug the code being generated as it is transformed -through the compiler. As well as plain tree output, there are many compiler options that -add extra debug information to trees when compiling a file; you can find the full list -in [ScalaSettings]. - -## Stopping the compiler early -Sometimes you may want to stop the compiler after a certain phase, for example to prevent -knock-on errors from occurring from a bug in an earlier phase. Use the flag -`-Ystop-after:<phase-name>` to prevent any phases executing afterwards. - -> e.g. `-Xprint:<phase>` where `phase` is a miniphase, will print after -> the whole phase group is complete, which may be several miniphases after `phase`. -> Instead you can use `-Ystop-after:<phase> -Xprint:<phase>` to stop -> immediately after the miniphase and see the trees that you intended. - -## Printing TASTy of a Class - -If you are working on an issue related to TASTy, it is good to know how to inspect -the contents of a TASTy file, produced from compilation of Scala files. - -The next example uses an [issue directory][reproduce] to compile a class and print its TASTy. -In the directory, you should create a file `tasty/Foo.scala` (with contents of `class Foo`), -and create a file `tasty/launch.iss` with the following contents: - -``` -$ (rm -rv out || true) && mkdir out # clean up compiler output, create `out` dir. - -scala3/scalac -d $here/out $here/Foo.scala - -scala3/scalac -print-tasty $here/out/Foo.tasty -``` - -With sbt command `issue tasty` you will see output such as the following: - -``` --------------------------------------------------------------------------------- -local/foo/out/Foo.tasty --------------------------------------------------------------------------------- -Names: - 0: ASTs - 1: <empty> - 2: Foo - 3: <init> -... -``` -and so on. - -## Inspecting The Representation of Types - -> [learn more about types][types] in `dotc`. - -If you are curious about the representation of a type, say `[T] =>> List[T]`, -you can use a helper program [dotty.tools.printTypes][DottyTypeStealer], -it prints the internal representation of types, along with their class. It can be -invoked from the sbt shell with three arguments as follows: -```bash -sbt:scala3> scala3-compiler/Test/runMain - dotty.tools.printTypes - <source> - <kind> - <typeStrings*> -``` - -- The first argument, `source`, is an arbitrary string that introduces some Scala definitions. -It may be the empty string `""`. -- The second argument, `kind`, determines the format of the following arguments, -accepting one of the following options: - - `rhs` - accept return types of definitions - - `class` - accept signatures for classes - - `method` - accept signatures for methods - - `type` - accept signatures for type definitions - - The empty string `""`, in which case `rhs` will be assumed. -- The remaining arguments are type signature strings, accepted in the format determined by -`kind`, and collected into a sequence `typeStrings`. Signatures are the part of a definition -that comes after its name, (or a simple type in the case of `rhs`) and may reference -definitions introduced by the `source` argument. - -Each one of `typeStrings` is then printed, displaying their internal structure, alongside their class. - -### Examples - -Here, given a previously defined `class Box { type X }`, you can inspect the return type `Box#X`: -```bash -sbt:scala3> scala3-compiler/Test/runMain -> dotty.tools.printTypes -> "class Box { type X }" -> "rhs" -> "Box#X" -[info] running (fork) dotty.tools.printTypes "class Box { type X }" rhs Box#X -TypeRef(TypeRef(ThisType(TypeRef(NoPrefix,module class <empty>)),class Box),type X) [class dotty.tools.dotc.core.Types$CachedTypeRef] -``` - -Here are some other examples you can try: -- `...printTypes "" "class" "[T] extends Seq[T] {}"` -- `...printTypes "" "method" "(x: Int): x.type"` -- `...printTypes "" "type" "<: Int" "= [T] =>> List[T]"` - -### Don't just print: extracting further information - -`dotty.tools.printTypes` is useful to to see the representation -of a type at a glance, but sometimes you want to extract more. Instead, you can use the -method `dotty.tools.DottyTypeStealer.stealType`. With the same inputs as `printTypes`, -it returns both a `Context` containing the definitions passed, along with the list of types. - -As a worked example let's create a test case to verify the structure of `Box#X` that you saw earlier: -```scala -import dotty.tools.dotc.core.Contexts.Context -import dotty.tools.dotc.core.Types.* - -import org.junit.Test - -import dotty.tools.DottyTypeStealer, DottyTypeStealer.Kind - -class StealBox: - - @Test - def stealBox: Unit = - val (ictx, List(rhs)) = - DottyTypeStealer.stealType("class Box { type X }", Kind.rhs, "Box#X") - - given Context = ictx - - rhs match - case X @ TypeRef(Box @ TypeRef(ThisType(empty), _), _) => - assert(Box.name.toString == "Box") - assert(X.name.toString == "X") - assert(empty.name.toString == "<empty>") -``` - -[DottyTypeStealer]: https://github.com/lampepfl/dotty/blob/master/compiler/test/dotty/tools/DottyTypeStealer.scala -[types]: {% link _overviews/scala3-contribution/arch-types.md %} -[ScalaSettings]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/config/ScalaSettings.scala -[symbols]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/SymDenotations.scala -[reproduce]: {% link _overviews/scala3-contribution/procedures-reproduce.md %}#dotty-issue-workspace -[navigation]: {% link _overviews/scala3-contribution/procedures-navigation.md %}#what-phase-generated-a-particular-tree +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/inspection.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-intro.md b/_overviews/scala3-contribution/procedures-intro.md index 8e23a97d4b..090ceada46 100644 --- a/_overviews/scala3-contribution/procedures-intro.md +++ b/_overviews/scala3-contribution/procedures-intro.md @@ -1,26 +1,5 @@ --- title: Contributing to Scala 3 -type: chapter description: This page introduces the compiler procedures for the Scala 3 compiler. -num: 3 -previous-page: start-intro -next-page: procedures-cheatsheet ---- - -Thank you for wanting to contribute to Scala 3! - -This chapter introduces instructions -on how to do basic tasks when fixing compiler issues. The tasks include: -- how to [reproduce an issue][reproduce] -- how to [navigate to where the issue manifests][navigation] itself in the compiler -- find shortcuts to [common issue areas][areas] of the compiler -- how to [inspect various values][inspection] encountered in the compiler -- how to [create a test][testing] for your fix. - -You can find the instructions of how to do the above in the following sections of this guide. - -[reproduce]: {% link _overviews/scala3-contribution/procedures-reproduce.md %} -[navigation]: {% link _overviews/scala3-contribution/procedures-navigation.md %} -[areas]: {% link _overviews/scala3-contribution/procedures-areas.md %} -[inspection]: {% link _overviews/scala3-contribution/procedures-inspection.md %} -[testing]: {% link _overviews/scala3-contribution/procedures-testing.md %} +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/index.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-navigation.md b/_overviews/scala3-contribution/procedures-navigation.md index 28f605359c..a0e869970c 100644 --- a/_overviews/scala3-contribution/procedures-navigation.md +++ b/_overviews/scala3-contribution/procedures-navigation.md @@ -1,123 +1,5 @@ --- title: Finding the Cause of an Issue -type: section description: This page describes navigating around the Scala 3 compiler. -num: 6 -previous-page: procedures-reproduce -next-page: procedures-debugging +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/cause.html --- - -In this section, you will be able to answer questions such as: -- where does an error happen in a codebase? -- when during compilation was a particular tree introduced? -- where is a particular object created? -- where is a particular value assigned to a variable? - -> You may be able to quickly find the source responsible for an issue by consulting [common issue locations][areas] - -## What phase generated a particular tree? - -As described in the [compiler lifecycle][lifecycle], each phase transforms the trees -and types that represent your code in a certain way. - -To print the code as it is transformed through the compiler, use the compiler flag `-Xprint:all`. -After each phase group is completed, you will see the resulting trees representing the code. - -> It is recommended to test `-Xprint:all` on a single, small file, otherwise a lot of unnecessary -> output will be generated. - -### Trace a Tree Creation Site - -When you see a problematic tree appear after a certain phase group, you know to isolate the rest of -your search to the code of that phase. For example if you found a problematic tree after phase -`posttyper`, the problem most likely appears in the code of [PostTyper]. We can trace the exact point -the tree was generated by looking for its unique ID, and then generating a stack trace at its creation: - -1. Run the compiler with `-Xprint:posttyper` and `-Yshow-tree-ids` flags. - This will only print the trees of the `posttyper` phase. This time you should see the tree - in question be printed alongside its ID. You'll see something like `println#223("Hello World"#37)`. -2. Copy the ID of the desired tree. -3. Run the compiler with `-Ydebug-tree-with-id <tree-id>` flag. The compiler will print a stack trace - pointing to the creation site of the tree with the provided ID. - -### Enhanced Tree Printing - -As seen above `-Xprint:<phase>` can be enhanced with further configuration flags, found in -[ScalaSettings]. For example, you can additionally print the type of a tree with `-Xprint-types`. - -## Increasing Logging Output -Once you have identified the phase that generated a certain tree, you can then increase -logging in that phase, to try and detect erroneous states: - -- general logging within a phase can be enabled with the `-Ylog` compiler flag, such as - - `-Ylog:<phase1>,<phase2>,...` for individual phases - - `-Ylog:all` for all phases. -- Additionally, various parts of the compiler have specialised logging objects, defined in [Printers]. - Change any of the printers of interest from `noPrinter` to `default` and increase output specialised - to that domain. - -## Navigating to Where an Error is Generated - -The compiler issues user facing errors for code that is not valid, such as the type mismatch -of assigning an `Int` to a `Boolean` value. Sometimes these errors do not match what is expected, which could be a bug. - -To discover why such a *spurious* error is generated, you can trace the code that generated the error by -adding the `-Ydebug-error` compiler flag, e.g. `scala3/scalac -Ydebug-error Test.scala`. -This flag forces a stack trace to be printed each time an error happens, from the site where it occurred. - -Analysing the trace will give you a clue about the objects involved in producing the error. -For example, you can add some debug statements before the error is issued to discover -the state of the compiler. [See some useful ways to debug values.][inspect] - -### Where was a particular object created? - -If you navigate to the site of the error, and discover a problematic object, you will want to know -why it exists in such a state, as it could be the cause of the error. You can discover the -creation site of that object to understand the logic that created it. - -You can do this by injecting a *tracer* into the class of an instance in question. -A tracer is the following variable: -```scala -val tracer = Thread.currentThread.getStackTrace.mkString("\n") -``` -When placed as a member definition at a class, it will contain a stack trace pointing at where exactly -its particular instance was created. - -Once you've injected a tracer into a class, you can `println` that tracer from the error site or -other site you've found the object in question. - -#### Procedure - -1. Determine the type of the object in question. You can use one of the following techniques to do so: - - Use an IDE to get the type of an expression, or save the expression to a `val` - and see its inferred type. - - Use `println` to print the object or use `getClass` on that object. -2. Locate the type definition for the type of that object. -3. Add a field `val tracer = Thread.currentThread.getStackTrace.mkString("\n")` to that type definition. -4. `println(x.tracer)` (where `x` is the name of the object in question) from the original site where you - encountered the object. This will give you the stack trace pointing to the place where the - constructor of that object was invoked. - -### Where was a particular value assigned to a variable? - -Say you have a certain [type][types] assigned to a [Denotation] and you would like to know why it has that -specific type. The type of a denotation is defined by `var myInfo: Type`, and can be assigned multiple times. -In this case, knowing the creation site of that `Type`, as described above, is not useful; instead, you need to -know the *assignment* (not *creation*) site. - -This is done similarly to how you trace the creation site. Conceptually, you need to create a proxy for that variable that will log every write operation to it. Practically, if you are trying to trace the assignments to a variable `myInfo` of type `Type`, first, rename it to `myInfo_debug`. Then, insert the following at the same level as that variable: - -```scala -var tracer = "", -def myInfo: Type = myInfo_debug, -def myInfo_=(x: Type) = { tracer = Thread.currentThread.getStackTrace.mkString("\n"); myInfo_debug = x } -``` - -[Printers]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/config/Printers.scala -[areas]: {% link _overviews/scala3-contribution/procedures-areas.md %} -[Denotation]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/core/Denotations.scala -[types]: {% link _overviews/scala3-contribution/arch-types.md %} -[lifecycle]: {% link _overviews/scala3-contribution/arch-lifecycle.md %}#phases -[PostTyper]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/transform/PostTyper.scala -[ScalaSettings]: https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/config/ScalaSettings.scala -[inspect]: {% link _overviews/scala3-contribution/procedures-inspection.md %} diff --git a/_overviews/scala3-contribution/procedures-reproduce.md b/_overviews/scala3-contribution/procedures-reproduce.md index d567adac23..aa31ecedde 100644 --- a/_overviews/scala3-contribution/procedures-reproduce.md +++ b/_overviews/scala3-contribution/procedures-reproduce.md @@ -1,136 +1,5 @@ --- title: Reproducing an Issue -type: section description: This page describes reproducing an issue in the Scala 3 compiler. -num: 5 -previous-page: procedures-cheatsheet -next-page: procedures-navigation ---- - -An issue found in the [GitHub repo][lampepfl/dotty] usually describes some code that -manifests undesired behaviour. - -To try fixing it, you will first need to reproduce the issue, so that -- you can understand its cause -- you can verify that any changes made to the codebase have a positive impact on the issue. - -Say you want to reproduce locally issue [#7710], you would first copy the code from the *"Minimised Code"* -section of the issue to a file named e.g. `local/i7710.scala`, -and then try to compile it from the sbt console opened in the dotty root directory: -```bash -$ sbt -sbt:scala3> scala3/scalac -d local/out local/i7710.scala -``` -> Here, the `-d` flag specifies a directory `local/out` where generated code will be output. - -You can then verify that the local reproduction has the same behaviour as originally reported in the issue. -If so, then you can start to try and fix it. Otherwise, perhaps the issue is out of date, or -is missing information about how to accurately reproduce the issue. - -## Dotty Issue Workspace - -Sometimes you will need more complex commands to reproduce an issue, and it is useful to script these, which -can be done with [dotty-issue-workspace]. It allows to bundle sbt commands for issue reproduction in one -file and then run them from the Dotty project's sbt console. - -### Try an Example Issue - -Let's use [dotty-issue-workspace] to reproduce issue [#7710]: -1. Follow [the steps in the README][workspace-readme] to install the plugin. -2. In your Issue Workspace directory (as defined in the plugin's README file, - "Getting Started" section, step 2), create a subdirectory for the - issue: `mkdir i7710`. -3. Create a file for the reproduction: `cd i7710; touch Test.scala`. In that file, - insert the code from the issue. -4. In the same directory, create a file `launch.iss` with the following content: - ```bash - $ (rm -rv out || true) && mkdir out # clean up compiler output, create `out` dir. - - scala3/scalac -d $here/out $here/Test.scala - ``` - - - The first line, `$ (rm -rv out || true) && mkdir out` specifies a shell command - (it starts with `$`), in this case to ensure that there is a fresh `out` - directory to hold compiler output. - - The next line, `scala3/scalac -d $here/out $here/Test.scala` specifies an sbt - command, which will compile `Test.scala` and place any output into `out`. - `$here` is a special variable that will be replaced by the path of the parent - directory of `launch.iss` when executing the commands. -5. Now, from a terminal you can run the issue from sbt in the dotty directory - ([See here][clone] for a reminder if you have not cloned the repo.): - ```bash - $ sbt - sbt:scala3> issue i7710 - ``` - This will execute all the commands in the `i7710/launch.iss` file one by one. - If you've set up `dotty-issue-workspace` as described in its README, - the `issue` task will know where to find the folder by its name. - -### Using Script Arguments - -You can use script arguments inside `launch.iss` to reduce the number of steps when -working with issues. - -Say you have an issue `foo`, with two alternative files that are very similar: -`original.scala`, which reproduces the issue, and `alt.scala`, which does not, -and you want to compile them selectively? - -You can achieve this via the following `launch.iss`: - -```bash -$ (rm -rv out || true) && mkdir out # clean up compiler output, create `out` dir. - -scala3/scalac -d $here/out $here/$1.scala # compile the first argument following `issue foo <arg>` -``` - -It is similar to the previous example, except now you will compile a file `$1.scala`, referring -to the first argument passed after the issue name. The command invoked would look like -`issue foo original` to compile `original.scala`, and `issue foo alt` for `alt.scala`. - -In general, you can refer to arguments passed to the `issue <issue_name>` command using -the dollar notation: `$1` for the first argument, `$2` for the second and so on. - -### Multiline Commands - -Inside a `launch.iss` file, one command can be spread accross multiple lines. For example, -if your command has multiple arguments, you can put each argument on a new line. - -Multiline commands can even have comments inbetween lines. This is useful -if you want to try variants of a command with optional arguments (such as configuration). -You can put the optional arguments on separate lines, and then decide when they are passed to -the command by placing `#` in front to convert it to a comment (i.e. the argument will -not be passed). This saves typing the same arguments each time you want to use them. - -The following `launch.iss` file is an example of how you can use multiline commands as a -template for solving issues that [run compiled code][run]. It demonstrates configuring the -`scala3/scalac` command using compiler flags, which are commented out. -Put your favourite flags there for quick usage. - -```bash -$ (rm -rv out || true) && mkdir out # clean up compiler output, create `out` dir. - -scala3/scalac # Invoke the compiler task defined by the Dotty sbt project - -d $here/out # All the artefacts go to the `out` folder created earlier - # -Xprint:typer # Useful debug flags, commented out and ready for quick usage. Should you need one, you can quickly access it by uncommenting it. - # -Ydebug-error - # -Yprint-debug - # -Yprint-debug-owners - # -Yshow-tree-ids - # -Ydebug-tree-with-id 340 - # -Ycheck:all - $here/$1.scala # Invoke the compiler on the file passed as the second argument to the `issue` command. E.g. `issue foo Hello` will compile `Hello.scala` assuming the issue folder name is `foo`. - -scala3/scala -classpath $here/out Test # Run main method of `Test` generated by the compiler run. -``` - -## Conclusion - -In this section, you have seen how to reproduce an issue locally, and next you will see -how to try and detect its root cause. - -[lampepfl/dotty]: https://github.com/lampepfl/dotty/issues -[#7710]: https://github.com/lampepfl/dotty/issues/7710 -[dotty-issue-workspace]: https://github.com/anatoliykmetyuk/dotty-issue-workspace -[workspace-readme]: https://github.com/anatoliykmetyuk/dotty-issue-workspace#getting-started -[clone]: {% link _overviews/scala3-contribution/start-intro.md %}#clone-the-code -[run]: {% link _overviews/scala3-contribution/procedures-testing.md %}#checking-program-output +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/reproduce.html +--- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-testing.md b/_overviews/scala3-contribution/procedures-testing.md index 0d21a71e0a..7c68dc18af 100644 --- a/_overviews/scala3-contribution/procedures-testing.md +++ b/_overviews/scala3-contribution/procedures-testing.md @@ -1,201 +1,5 @@ --- title: Testing Your Changes -type: section description: This page describes test procedures in the Scala 3 compiler. -num: 11 -previous-page: procedures-efficiency -next-page: procedures-checklist +redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/testing.html --- - -It is important to add tests before a pull request, to verify that everything is working as expected, -and act as proof of what is valid/invalid Scala code (in case it is broken in the future). -In this section you will see the testing procedures in Scala 3. - -## Running all Tests - -To run all tests of Scala 3, including for compiler, REPL, libraries and more, run the following in sbt: - -```bash -$ sbt -sbt:scala3> scala3-bootstrapped/test -``` - -Often however it is not necessary to test everything if your changes are localised to one area, -you will see in the following sections the different kinds of tests, and how -to run individual tests. - -## Compilation Tests - -Compilation tests run the compiler over input files, using various settings. Input files -are found within the `tests/` directory at the root of the compiler repo. - -Test input files are categorised further by placing them in the subdirectories -of the `tests/` directory. A small selection of test categories include: - -- `tests/pos` – tests that should compile: pass if compiles successfully. -- `tests/neg` – should not compile: pass if fails compilation. Useful, e.g., to test an expected compiler error. -- `tests/run` – these tests not only compile but are also run. - -### Naming and Running a Test Case - -Tests are, by convention, named after the number of the issue they are fixing. -e.g. if you are fixing issue 101, then the test should be named `i101.scala`, for a single-file test, -or be within a directory called `i101/` for a multi-file test. - -To run the test, invoke the sbt command `testCompilation i101` (this will match all tests with `"i101"` in -the name, so it is useful to use a unique name) - -The test groups – `pos`, `neg`, etc. – are defined in [CompilationTests]. If you want to run a group -of tests, e.g. `pos`, you can do so via `testOnly *CompilationTests -- *pos` command. - -### Testing a Single Input File - -If your issue is reproducible by only one file, put that file under an appropriate category. -For example, if your issue is about getting rid of a spurious compiler error (that is a code that doesn't compile should, in fact, compile), you can create a file `tests/pos/i101.scala`. - -### Testing Multiple Input Files - -If you need more than one file to reproduce an issue, create a directory instead of a file -e.g. `tests/pos/i101/`, and put all the Scala files that are needed to reproduce the issue there. -There are two ways to organise the input files within: - -**1: Requiring classpath dependency:** Sometimes issues require one file to be compiled after the other, -(e.g. if the issue only happens with a library dependency, like with Java interop). In this case, -the outputs of the first file compiled will be available to the next file compiled, available via the classpath. -This is called *separate compilation*. - -To achieve this, within `tests/pos/i101/`, add a suffix `_n` to each file name, where `n` is an integer defining the -order in which the file will compile. E.g. if you have two files, `Lib.scala` and `Main.scala`, and you need them -compiled separately – Lib first, Main second, then name them `Lib_1.scala` and `Main_2.scala`. - -**2: Without classpath dependency:** If your issue does not require a classpath dependency, your files can be compiled -in a single run, this is called *joint compilation*. In this case use file names without the `_n` suffix. - -### Checking Program Output - -`tests/run` tests verify the run-time behaviour of a test case. The output is checked by invoking a main method -on a class `Test`, this can be done with either -```scala -@main def Test: Unit = assert(1 > 0) -``` -or -```scala -object Test extends scala.App: - assert(1 > 0) -``` - -If your program also prints output, this can be compared against `*.check` files. -These contain the expected output of a program. Checkfiles are named after the issue they are checking, -e.g. `tests/run/i101.check` will check either `tests/run/i101.scala` or `tests/run/i101/`. - -### Checking Compilation Errors - -`tests/neg` tests verify that a file does not compile, and user-facing errors are produced. There are other neg -categories such as `neg-custom-args`, i.e. with `neg` prefixing the directory name. Test files in the `neg*` -categories require annotations for the lines where errors are expected. To do this add one `// error` token to the -end of a line for each expected error. For example, if there are three expected errors, the end of the line should contain -`// error // error // error`. - -You can verify the content of the error messages with a `*.check` file. These contain the expected output of the -compiler. Checkfiles are named after the issue they are checking, -e.g. `i101.check` will check either `tests/neg/i101.scala` or `tests/neg/i101/`. -*Note:* checkfiles are not required for the test to pass, however they do add stronger constraints that the errors -are as expected. - -### If Checkfiles do not Match Output - -If the actual output mismatches the expected output, the test framework will dump the actual output in the file -`*.check.out` and fail the test suite. It will also output the instructions to quickly replace the expected output -with the actual output, in the following format: - -``` -Test output dumped in: tests/neg/Sample.check.out - See diff of the checkfile - > diff tests/neg/Sample.check tests/neg/Sample.check.out - Replace checkfile with current output - > mv tests/neg/Sample.check.out tests/neg/Sample.check -``` - -### Tips for creating Checkfiles - -To create a checkfile for a test, you can do one of the following: - -1. Create an empty checkfile - - then add arbitrary content - - run the test - - when it fails, use the `mv` command reported by the test to replace the initial checkfile with the actual output. -2. Manually compile the file you are testing with `scala3/scalac` - - copy-paste whatever console output the compiler produces to the checkfile. - -### Automatically Updating Checkfiles - -When complex or many checkfiles must be updated, `testCompilation` can run in a mode where it overrides the -checkfiles with the test outputs. -```bash -$ sbt -> testCompilation --update-checkfiles -``` - -Use `--help` to see all the options -```bash -$ sbt -> testCompilation --help -``` - -### Bootstrapped-only tests - -To run `testCompilation` on a bootstrapped Dotty compiler, use -`scala3-compiler-bootstrapped/testCompilation` (with the same syntax as above). -Some tests can only be run in bootstrapped compilers; that includes all tests -with `with-compiler` in their name. - -### From TASTy tests - -`testCompilation` has an additional mode to run tests that compile code from a `.tasty` file. -Modify the lists in [compiler/test/dotc] to enable or disable tests from `.tasty` files. - -```bash -$ sbt -> testCompilation --from-tasty -``` - -## Unit Tests - -Unit tests cover the other areas of the compiler, such as interactions with the REPL, scripting tools and more. -They are defined in [compiler/test], so if your use case isn't covered by this guide, -you may need to consult the codebase. Some common areas are highlighted below: - -### SemanticDB tests - -To test the SemanticDB output from the `extractSemanticDB` phase (enabled with the `-Xsemanticdb` flag), run the following sbt command: -```bash -$ sbt -sbt:scala3> scala3-compiler-bootstrapped/testOnly - dotty.tools.dotc.semanticdb.SemanticdbTests -``` - -[SemanticdbTests] uses source files in `tests/semanticdb/expect` to generate "expect files": -these verify both -- SemanticDB symbol occurrences inline in sourcecode (`*.expect.scala`) -- complete output of all SemanticDB information (`metac.expect`). - -Expect files are used as regression tests to detect changes in the compiler. -Their correctness is determined by human inspection. - -If expect files change then [SemanticdbTests] will fail, and generate new expect files, providing instructions for -comparing the differences and replacing the outdated expect files. - -If you are planning to update the SemanticDB output, you can do it in bulk by running the command -```bash -$ sbt -sbt:scala3> scala3-compiler/Test/runMain - dotty.tools.dotc.semanticdb.updateExpect -``` - -then compare the changes via version control. - - -[CompilationTests]: https://github.com/lampepfl/dotty/blob/master/compiler/test/dotty/tools/dotc/CompilationTests.scala -[compiler/test]: https://github.com/lampepfl/dotty/blob/master/compiler/test/ -[compiler/test/dotc]: https://github.com/lampepfl/dotty/tree/master/compiler/test/dotc -[SemanticdbTests]: https://github.com/lampepfl/dotty/blob/master/compiler/test/dotty/tools/dotc/semanticdb/SemanticdbTests.scala diff --git a/_overviews/scala3-contribution/start-intro.md b/_overviews/scala3-contribution/start-intro.md index 1ad97dc2f6..48e6100fbd 100644 --- a/_overviews/scala3-contribution/start-intro.md +++ b/_overviews/scala3-contribution/start-intro.md @@ -1,85 +1,5 @@ --- title: Getting Started -type: Chapter description: This page describes the high level architecture for the Scala 3 compiler. -num: 2 -previous-page: contribution-intro -next-page: procedures-intro +redirect_to: https://dotty.epfl.ch/docs/contributing/getting-started.html --- - -## First Steps - -### Scala CLA - -Sometime before submitting your pull request you'll want to make sure you have -signed the [Scala CLA][scala-cla]. You can read more about why we require a CLA -and what exactly is included in it [here][scala-cla]. - -### Making sure the team is aware - -Before digging into an issue or starting on a new feature it's a good idea to -make sure an [issue][dotty-issue] or a [discussion][dotty-discussion] has been -created outlining what you plan to work on. This is both for your and the team's -benefit. It ensures you get the help you need, and also gives the compiler team -a heads-up that someone is working on an issue. - -For some small changes like documentation, this isn't always necessary, but it's -never a bad idea to check. - -### Required Tools - -#### Essential - -- [git] is essential for managing the Scala 3 code, and contributing to GitHub, - where the code is hosted. -- A Java Virtual Machine (JDK 8 or higher), required for running the build tool. - - download Java from [Oracle Java 8][java8], [Oracle Java 11][java11], - or [AdoptOpenJDK 8/11][adopt]. Refer to [JDK Compatibility][compat] for Scala/Java compatibility detail. - - Verify that the JVM is installed by running the following command in a terminal: `java -version`. -- [sbt][sbt-download], the build tool required to build the Scala 3 compiler and libraries. - -#### Nice To Have - -An IDE, such as [Metals] will help you develop in Scala 3 with features such as autocompletion or goto-definition, -and with the [VS Code][vs-code] text editor you can even use the Scala debugger, or create interactive worksheets for an -iterative workflow. - -### Clone the Code - -The code of Scala 3 is hosted on GitHub at [lampepfl/dotty]. It's best practice -to [fork] the repo you want to work on, and then send in pull requests from your -fork. - -Once you've forked the repo you'll want to clone the code with the following -commands (shown using a `bash` compatible shell): - -```bash -$ git clone https://github.com/<your-user-name-on-github>/dotty.git -$ cd dotty -``` - -## Verify your installation - -To verify that you can build the code, you can use `scala3/scalac` and `scala3/scala` to build -and run a test case, as shown in the next snippet: -```bash -$ sbt -sbt:scala3> scala3/scalac tests/pos/HelloWorld.scala -sbt:scala3> scala3/scala HelloWorld -hello world -``` - - -[git]: https://git-scm.com -[Metals]: https://scalameta.org/metals/ -[vs-code]: https://code.visualstudio.com -[lampepfl/dotty]: https://github.com/lampepfl/dotty -[sbt-download]: https://www.scala-sbt.org/download.html -[java8]: https://www.oracle.com/java/technologies/javase-jdk8-downloads.html -[java11]: https://www.oracle.com/java/technologies/javase-jdk11-downloads.html -[adopt]: https://adoptopenjdk.net/ -[compat]: /overviews/jdk-compatibility/overview.html -[scala-cla]: https://www.lightbend.com/contribute/cla/scala -[dotty-issue]: https://github.com/lampepfl/dotty/issues -[dotty-discussion]: https://github.com/lampepfl/dotty/discussions -[fork]: https://docs.github.com/en/get-started/quickstart/fork-a-repo diff --git a/resources/images/scala3-contribution/breakpoint.jpg b/resources/images/scala3-contribution/breakpoint.jpg deleted file mode 100644 index 748088c269c98ddff0acfc7968b4f6b1331f83cd..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 137341 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Ǫp4{+(|HHM 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 ViKq^~LTvC}{fBjbN&nBv{{SdTgS`L% diff --git a/resources/images/scala3-contribution/call-stack.jpg b/resources/images/scala3-contribution/call-stack.jpg deleted file mode 100644 index 8fac2371a6c18c490a680e5463722e442d2bc2e6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 305288 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⁣_8sw^Rg9*WV#GhYJarKar^eygo67^>TN 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%0A6ygu8sOc9w>5cFu5`=)VgH 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�Gz9SFe;)e9w2pMUgV!kIGL9z>L@RI!4-S07gHemr}Q zzFPMBY#?>%II`sIUvpjL4uoM>v$AdgFVk^MN1PW}UJ>&5JLlwnqgo2tyMkeavK7c) q2d(d}D=i@q+E12kcj##0Ke8?n`jLMUSb$bAeiG%U7PaV~#s2~5j>Odf diff --git a/resources/images/scala3-contribution/conditional-breakpoint.jpg b/resources/images/scala3-contribution/conditional-breakpoint.jpg deleted file mode 100644 index 11bab89d3f477d75aeecc14aa2bb88822edb763b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 146193 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 diff --git a/resources/images/scala3-contribution/create-config.jpg b/resources/images/scala3-contribution/create-config.jpg deleted file mode 100644 index 60479233ee70fba759eb065f07c42d7c73176a3f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 140865 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%0AB)6~Y0L!?GRdW!!)=l&q9SRw^mV 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 Vu|>SIXIDO${2BarqrtzI{|`LDS8@OV diff --git a/resources/images/scala3-contribution/debug-console.jpg b/resources/images/scala3-contribution/debug-console.jpg deleted file mode 100644 index c9a669019d65f4222c92ebb201bf4fc997823371..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 157192 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�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 diff --git a/resources/images/scala3-contribution/import-build.jpg b/resources/images/scala3-contribution/import-build.jpg deleted file mode 100644 index 79be8450cd4ad27f3364d13d47322ed6eedc6b0b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 64305 zcmd43bzD_X_b9v%bx3IhY3c4xk&x~#rMp{7MHD0?r9lu52#7RDcL*XOEuB)*4evha zx1QhgJoml#bN{#l`^?%iYpq$cX3d(}v-UaH<JWTlj)JVbEC7K(fCu0oa6M1%A>(6f z1pxB$%m69?04Ts62r>WxAsz4{{SBLdFe3!<rW^r;xgZDt7MO#C05=E|fVl^F*}g!! z!FdV7Dc}V*adZDiE+?<7M#as}#mUai2~u)$^9XbD2y^pNaq$Uratm_`g4mF(U+utU zfG1EY$S<yNR*>KDI#`1MN`weU0m~78ONRp9qWlde{0+nLAPB$spn&)YzhNsfI0JYq z@W1Q7>j=&l#JrvY?gOYOC{Pq+R45dRhK7ocNq~ikfq_YahmTD_eut8R{0<oz6)igh z)m>H^GBQR1CRR=^US3{G1|cy)Zc%m~UT!!O2pSq1CI%)k78Wr#H5oPc|8}}=25?b< zbqLtmy8r?%1Q8c<-40NKaw3Bx3Ln(p34(x#gp2}3MMK8`5h`)unnFZCLPSPJLISY^ zz<K})7a5P5>mCZe`XlIFR|4)QF>g_6q)J-|H3omu@|d|jMMEdLO-yo!j-G*$iJ6y= zUqDbu_`bA^tlR^61x+n&9bG+r19J;YD{C8DJ9iIHFK-`Tzh@!OLtnfM3y+P9Pe^=| zl$?^C^DZ|JmS6C`th}PKs=B83Q)^p$M`u@ePw&w1$hXn4@rlX#g~g@imDRQNAG>?| z2Zu+;C#Prde!=_sNBY&Vf9V%4*e?VmBt#@Ayk8ImZ}39IMM9?LLczPI4t?Z`f0z3S zDuGnY+tL;^8Xk?Ggl2Ao=tQ)<^K`rLuHE$P|6j+R{vY-1&yM}ouSozC5dsb#A}$~S z>@%^i#(XBxv;HUulgT$}$)w-**&nkAv3kGc7tSpvqXlDf>WQEsk9mA<u6Ye)Mb2Jc zIq$;gYYW?_a=vkBofU0L6kGqoRSxHqn5P|+SmVhLnp3<6A}N2y+Gie+j7a>Xy9PST z_QYgJD6$iRhpvH;XZri116%f6C!ISL;;yH|P5&UY{KZfNQg98R(brxB_tNiQ0|=%U zw%9K#%UYsJgJQm3=AK;I^U#c_$NXUYcqj88O%>fM^hsGEv3#L9G9y@8`@HR#3NjWK zD_A5Nt!|J=LDewqs9cXlnP}+US1Wd}YmKoCVXkRcU%B;MhsM^4Au#y4*yRI4qm3DA zeIovEm2_U6h(>~6g6`<<@@)<|C3Q|<7HK((D5A_AQ9XHf@uTvpMC|f=U;E2ZH?(`t zf`u`MKHlMYywI+^74+WR)hHmhr<<07C!=dGPp-fx+ZV|`=zVOLGfy|v$W8umAt{4- zM8_(=f>j};#e@?=(YSP}Eaq=oz$g;<1r5MoK99?2=*ezz{W^2<{sG~9<H#gyym2*l z58`W~qdb}SKG|kccET`J3)(Mpj)=5NnF>$G+6BB`qnhDt-ZEV=TBUj_{8MO46;yi0 zHL$sY+4iwzi83y>rZcdHcM~b{z0X^Ao#`LKu#`S^EhC}nd!10xD}v&Hh0t0>tHzPO z+@pM+TGAJdt{wL!!VWRQ=8|WqzSerSdNM=>ly=BthaX~iMp6^)c9Dpvn>V-gbPdxE zeZ>9z;UpZT{nLkc$zOO}E-r;ua=`ZEj6e(e^7a~d!g0k%lv8B%BMf1>jFQgl!(f!y zH9)Ne8XOU#<`tf@`_(hy7gtD4CqtAt8#2$xO)km~=;!w&4Enkc2`v1=z5a<c_%CK+ z&v9cHOnO+VC-Qs)XP7@IPw=jRMY#*wl+{ZVPwWe{pxvVSXmyPaPg?ZPq+6Jr)3<Cs z-X3^)*vjddexLGi55(5&De{RTCbIsv(@NgJK^zkk^O}@~Cc_?|W<)#8IX4A@QRYDE z$B48=Od_TN$!<1{Zl|D1l!+2ERkt>OuI_fqu%BnNai>n9Ai&p?N3L5jjHEPXXQ(_o z;cbG2EM#PfqK3Cz<ruG`tZ~&zks>cWc&*}<Dz^M12j`W$>l1y!J<qj~9#XiW^}IK@ zj7l}<RfHLn2G6|_iHY}vJXI|*qF@oQJJY%b9;S5~-G7a;_!JFsjNAq>KU(HzS2_mY z!fBx1%$*;iPE6_3{5}qtE&-)RE2WN>j=p%~Ju6aQJ3B(cXSvjCT!+(s+P%t0ZNKHJ z?JZCYcnz=3km@a`h-~uEoVt*{9H-vft4k7K@IH1ETrCzj$8HPb?fn#|l=Z2=c0om| z09w#3<PgB=V*hG-rozeD0NA3G`njTi4O9V|$J(?ib@ARykhrlA+=4}76r-&h>h|{M zne;@ORgTTbRI3a>Ae1kQ0{S;(R}Qmo4SED&PIqDEXxaw}Ai<JCWI7)>q_-cEVOmGA z;B616R*&fnu?+C{JqSNWgg%RiiB{<R-RO@)F-p0otqTh?SJd3W=1<s(OcxMig=izH z$+`M@q=pYf`h`umNZXvfj6;Iz(K&&QOgFzXzcG&51{;tCWXR4y<&A9~8r6u7eKQTm zoo>)Rk}&-!4lap4-)|W1Zc5+UmQKQ?SFiPoYj%Kq#f%GI5fCUQO&tvuJ{YX$R|@`7 zhE??b-6!|-T8Vo#*T5|OyF1t~R+7CoaNBd!YW8&jl!tZh2hg~$yOT99V%l6f<NAYk z?f~l+6+;8z$RCq6mDy`!XuHw1C}1-cnsPtqOY!rv_msXi(s)a^o%(9DdCB$pVIHg& zyNcUi13rT*O~;Xd^T{)n%ArHK%8Hu(K@{RdOzkH$BxGLD-44rd_gO=hYU!i-u7P?R zgzto!@a9Cvu6DC9JhWABO7~6AJA>H<wc({XH_}wgXu%8rmqh%I01sX-shtQQD=QVt zd`9y8=cn)oi8K{Lc#O@95!RFCcN6Ac3zKm!=GpEUE3!T&&ew30$|t$VM?m{29pbT4 zpxq<!t$HZiUdNF46B4gO2lhGJ7-a(B@OdHGGRlMhO8>R^9VY(QhRzI8fopl67c^ZF z+gxoMETHaa58PBqdY~T>VRj#{kVbW6C8^BN5$?YhH<NRnA`x%*?7v4D!bg($Z9aD9 z!M1*)0CKR1w-W<1Dx$4uv;xpKQt~Cot(<^a3P~i@RdDBP5Hrje{X{@Rq^%ye!qxXf zanmvh;6@OU7R7VeVQJ@QF{!*d0kgE8By~fqc((R{gkmuqfXNW3LBI>?qsq}vEdqYm ztYq6$?4VqJc>|5yr;+ao9MuFbnBvutGy;A&3ad6KXCZ_${?`l3pe)g;w>Fl~i$u$6 zxhd<yRZWgmkxH7x{Hx9rqG4lLKh1++lu49PD$g%IluzDPR9Z^mrN!U<Fp*3}t*?h8 zhoq5P+~02V++uG`<UScBWnyn3GDQPrL7vsF=u^~?v|9Oj2D1CPt)ha>naz@q5vx}D zo#~QOosz?gMvGGVtXlJeX&Ro}juE~LWS2ga35r)K@(dbvJ;Z|kuCYM{7wZKJNRgk} zU*QrPp~R#jS&R9to@vgu_b-2;9?A(@mZ}SRfv%81i|Hq@0?COj{~o)WOvgqorLpfc zTe2pq=z}6r;mq}v)ADfXn_()oFGI4ct7t4hz*F^rBEe1K_V-Q*zmlolv-2Z#g%5*! zXXft@_*hO>)xB-8LP)zG-V!8X_VcD<B!O+d58{%TtTmrSZTiV^g2FYJy~PsUd?!?y zd@SDO>N}Q0&q6tC(bii7x8=H}r*8KoJ`cTDE-uP+SJ3-1O{UP5X<$^D_+^<@R>n|% zC|-29>BludLu6?E?9#%G@vw{VcF)x}51bh}iQZndjQ+1zd<Of9x*A6tmDfPs_;93E zdR~zV4Ry%6@Ckax5R2!xAX6HerE9=0I_~nlcO1hp76bgl$$tW=X13FHM+w%OYl_L~ zs`Ot+A8s931`T<O+<tR`rmKW1ym$&P^%$)XUDw2Zte0hA#4V980}Ql?0}j@4o6O8| zDQx7mPE3!u)Jo_)iTF?CSD7The!MsvIdh(PS%b%2+&M6vjF7aS;T|(a&NOJ$A-pAs zbf}X@&i_5R$5xXjvN(+_Du^|@vlOO(&rMnHc=wcdcQ}y)nNMAQX6&19kPbsa5vlqs zxBPp!_yiIx@)dhEh=_uPh0a;>P3BwUwWmu|0)6+k#)u^%Evh03-nh~VM3Z5{9)Ir9 z9Dte3rVF0fIX(}~b?hSMc2k+Y(qH8JR0u5>MXz<@j;mOg_fO8I`Fhu8Ttoqbv5o7z zVSKmci_by+T=aw3VaK*2w-+uX#QOu}joUl}L-{2y7|yj4OT5It;_%ufQ}-}Lb^$Js z3tP>$*rXY`2DP`zw;8~P$c&JK?#{pjqtCSio6HRarqd3c85D*uZ~O7O_9{Ac&(xBu z2+i@i6FPdJV7tYdW+xq;I>21wm{rX?IiZ2dvL0r!pDMSPDLrFU8Fo7qi;?Su*Omo; zOiIO_7oWb?NyrZ>|8NbMzFC)dguT<Z#HLn{?Mg$>ef%CkH%yEBb}61PpaH8oHjB<_ zewY(m9p0&>pfkku<1(nwH;m(K74+H%c{<)n;Nsx?C35HT=whQ-goTn)!)V`an{MaA zKM<jCc!{=Ao?%1jous-90q|cgNGaZn1l%O%azO9sxR`XK<gTuwr#5?5Im%~j(2-gW zN@B%b8U`?yr|d52J&b8I6W)W?4&0N@{4upIZ<()XR_6O4H<OZUfOr5l)<npyYj_*| z8<V)5hV7}y9S&Dt<Vl01p#>d81kUEzfR|SZ43kdURpOa0l!C1V5<{h1&U6)Zit*Ix zZk!jPNDrTFJ(aO(Sum`#(P8m%T#(TSN7)bdcKuAT>ARu-2`2zs=M9dP*0+Y@OO2qn z5>u4X2P_|CgT5Ud!Y;GjmlrxWxcNtV&0RObUtHn!E8=5+f5J#IRqGlIMG~kUdi$nb z*R7u*Pw;*hR}yYhqL^Rx{WGr)j>6`(Ye0XWW7X7+;kLJiLaE#%CNE4a0i-Pw!NoMQ zxB8xj1@-xkz2cIc)1HEeE64AgagEET;>ZMpIkit~G3!)RHV+PH#)_4}4W#AO){J)J zWv`;6Lwa$o9B9BAImlm^i!)XTwR5#EDlUrDd=5Ej5)$WpQ>)CWUPBoWtFSk;`_qRC z%pExai`W;rwwZV{q%ZTh?tkKY6rGAy1GoveAIp)86%6?lswXZ8rGD;nZnB-$N;5~o z^I6SWs4O$2FoH2P+KQAj6|<}1jqc?m(#F#uj=n86Y{Ho}nIfitsMSfsz!nRE);5b` z&bjMr;mI(}<PE<&ADILgv%~+*6%lRlXX#{hn5EauvbI(!mBp2|E1Q}0be$C|;hR1Y zaTE8>fCjsU_*N35Hxsq!p`9*vn{Q&cfiaVZxZDJLSNk|FLF%V!D8>ufJ=|T#5E0)2 zLjD&4$nj+rdu1$;*1WAbPeL8lL&t-Hic}x#{S+l4C3BWKyZyweS*Xp0ou$1UAGXcu zJr0Mas>Jo8*2$$6Dnu{Qxu33M<boYG9r->!_o@~~ZS&}=71)ME4?7VWp-wXmcJHc) z_BLV+c5rB-Q?puD5n}-c#1F#X%IA~%OFunMtW-YtFVNyC5%HyZlD2;UBY&#C?4QMl zee1cyc%NQR!sS<pt`pbs>1xKrQJ(P+Kemn$jaRoxYGUQXO!W1W^3TT?X`+NZ3$lL} z-8)te%*DyuDrkGQ=002%;Pd{dk=(HI76%a@>zw61M0?0n_c5r1q%s#?Uhe$TUbSrr zHOVanM`+BH?^fM<n)@g$TIVa9G>?qcf{xPbuwz38A-cvi^W81Awt0&TUYkQ;+YGP5 zmgoVJHR8(Bl{VMU;_{C3x~0BAbA|b5DCqgJVvx`7{iG->I+eaK<9cP-6t7^<>$160 z!E3-~wFzd>`ys;=<6a%^?CC?NffVR*5`v2l5@VN9tguxnp9tab_C<WUmB!m=Poi>$ z>4TXDWe6YynSQA%aXXqeKz2CeKd-0+jK*!K0-zfwdMkmPKn-zJO6-S>%Qs{Kh*kI# z3z})I_w$VvkP;a}m@Cd5A9V!Qm-)s|=k~$p#st7p{;Ie!!CY!s7WViq$qWZG4ZE7f zPszoY4Q+7k)0tK9N<7{jps}4h&Cti*D<E|fUX7|L+F+{TgIZ~c)4ioziD4C9N^wx3 zdrev2&e$n{ColTY^Gu`h+2iG+kI1zzVM!J*FS490ccQmb9QN$O3R(Ajvrj+vYGHLn zU_!Q3gjWiP)*@S?!J`(tnw9}2*B*)FLzrr6jJwFk*otJbGxi*ZC%KiDDEDw$psaqk zu!9WzPJ*<oAdZTbRZGG#Y4~G;n?W?nwWEAY<6+yTE-ojNw=sn&pu`2Fdf%$VtvqFd zQgNR{UW$@oA2%74$<aS4lr=nN!)eiRT+HM4vxw<FT1j@#vg6-J;$MCya+muWzy&fS zXrhg@nx<0PCgv@i*+^a~(2$&#zE%<TSe#u~GqO9&=|Qcj3F3z0$<<0S`#l@p%|Zqr zg@d#aQ<<PtZgL-HO$}mAZ`rArJr5SNkj4B^BNE&U6+P^t2+g^g{U&ebY(ZBV>pDez zb$>&pdiNI0X)vK?ng;!SQPxEcF-4Y(uo_~}M?O*fBh3mjqL~^pYoRY(QJ2ic-y*-g zd2^IxAi?LI_c*-9U*>%R(^1Lmw9WB4KXc+PRi^}%?X#7WPA5xl;*q;ckS8Z<$V}pg z{OO>3`3m3I{(0RKB;gGS=C&hp>zWLPy3Hy${;g8=)edDYcjoOG2?by_ge#dp?*hl` zY_uS8F46p!H)4Wq7}>c;;hiU?p=W!Byn9=BtZm+qg|K=>e<n=vq)dI;XnI_jI{8I) z+JI91GA6iHiiPw2$V`>7n1?0C%NaULPiEJdWJ^(8wsvm}YI!w|?QSHT=HoM+&!{Di zFMq(IJ^AA75|1Xs6n`o)qdtT(L~*SJU>OUior#gGuJ~Gy)Y@yj5fgH_24qz}73rKs zR`%Dk_8`e}mI*LC73vzTh<>Ghv^@;^W4*$;Dp}!0s-poTfQ6lMb9Ky}fACSP50Y!e zoVm~!*V)}--Qf$)O%je}jirmX!P<*aS(&OPHN_fbqG9qq-(UAEyk4h1C)rQ`9Ck-z z>Q-wGnQO#KGPtmC?U&Hmdj(ZG(wQg)OFoLq^j=xtWEx8}K=SIXs&<p7KRFhuAx4`2 z2&}G8&E_g1M~8;ti7nN+$#%uNeu2uY(xmN1`<bEaT3AVa&Xaww$Yp%l1060U(^B_I z#@qH?D%JO&z-{(kuk_k;?b+G1YwegHeM;)}nuU{Y89Nqrl7H2CEORK8@Wl)BQ2xiQ zd*xU^thyzMJw#-E7^(%gByodUHP4$nTZyzO?+VD!C6%sEb5REK$?1;X%GYAWKwx<@ z2`iww<+IUc>euLT4cuC!zcQ*uba)p1Mu^6lY&YVHFS6jiBl1Pe#OIZ%2nRPe6-hA{ zk*~-GjM>3=<94*1=H(jX8D`$YgoHLEA+%|6s`6ZIfu7_ye#fX}C{G7dFbnye6*{*q z$<y$VQu8=TL@x7wy5DxDSh2-W`5@-lxi_6*niqmhpe~6l&QTv2-|KJcbIFJ}EXwxC zyx^osrTUvixR@A*B3E*2Au>q|!z|?!z73)bij&6yZ1p;cX90a>ys<^DWw9;pBZ#eM z*ttG=#d-C&b%`_*_KTNoJ~MSszk7D#s#URmsC@TIWD1S;>5Ax94C*2cbn5K~Kc4W& zj70G_FF6In%*lOZdU?u~Sq=<rlxf4yzJo3j?>=rqZ|5_J>^4BDF!)uJv5|RfxjI%Z zoN?>8JZp(8&5NdVE=GT?C{KUYWvIJj$vLnx@zb}%;?45$@BL1Cj(twLG_!{n>-YAx z-3&?1-?Gvxt7022#+NvKKD+qr*A==ld|}A{f@0w_S0skTMQ!JTS40GY4>2qg)il|Q z_VwPf>{j#QhXt<YBKucUg>?n&PVBUazGxgYrL68_ne9Vt%R`P6?%Z3%#BN;1485e> zJ{mujaIIdDXwikuheO36izVXUkY-5hLzf*V?X42ta&O5C;6NQ9Y3JIMTP(9|YQ_o( zvCW|^J;WPhFha`7ZEuuw>AI&|P~UEfOa)*fwN<w?dBW;>cBoE7?KC#YDsc~)dBmW= zb68{&Mp7_(lmN<kE=kxN#S`#6vLw9wJYbb_-TkMVgpUvJY?ZMi%Te-2S=1R{%B2)w zOq^f@2u`M=2>hCC^+TRm)HTAp=vAFnd0pc783CK|0-Gtf%(uDco-@F?)&&6F!FEc( z;1NmmVr^fFb(7CR0@ptT(4$GO*TszH!dFCuQsNC6l{MnWBeXa!HV~$JR7)D_lIZdb z^szTfrQ2KQT!0EW3Rx-t_J#tW{zOp{nP0WWc4R_)J_{AT+hW=cSUkwnTsZGqmn6Sy zszm2Y>y_}%?2B<2Z3axd(oOMA7~u>GdNYoDjF!Vz$G6`0fsZ)y4%Wdux~p6UePzB^ z7OHm^IGg-$0YYb<7llF^A?cH1O6=}Yt!)!S1vW>6S5^VbQv>*nq`Ksg4Si29H)0`l z0<zaoyIgJJ{6d;nxM77a^MB|hOrbMo=QscB4lo=%XMo8c7gPXR8ZpBSEIm=sRrNnT zIYI<tcfZOz+z#Dbq=N1&3<6E<wgB4^K-1zpG+jAv`ws9FenfHO%q?#w7^IFY8h<Bp zLeE?CnIh{@UrVl+n;?l8c&veFakJ>dbZLL(k~gywJ~RJz;mRMshX%I7;&!xkG+-%! z0_YFW;aV1=8DKlrs(>IeX>KVO(jsu$L8Y1$07p3OgIF);FFD!4tizyK*}5#-%(B!u zv}#Da>M{VqN#pLB=FKQ%VSNI*kuscBooNf#{>uK`_x@ckpiY#iI9p&npjsekkxv#= z{A6#(^}q&yiArvh9Zc;p)xEA%$cNt*C8q#H!Icm(2)6cr-s103_?O2w2!7Z1Am*r| z5oZctavKC@xH=effsCiYc<)~A+|hn@-kAZABLntux(WF4Si!fOQ?i18uE>8JJ^k0C zB@|(&CC~gLfm~G?K(^FxBp5REYeR^5J#oE&@KOH$eN#0JRato@88D^^#v`*F%pKj4 zz^JIBlZTszoD>xpUZaApf&orqFw`mx;6E~Vce$sgru0XU?|<e;qwsho01UIidHv7& z|5}1&Vd-uT1_!A?EJ<@0H!z$Fc?iP%-X1P+I0=La%xxZ7fN&8Av$}x-g77%J-0T;; z35Tt3V0e@mAaK*txDWOX9v-H${u^xeH`v_9%@M@m1#xIC9GyV^2ztL@3pnf#haDX} zLD_B+yoZ>UPTHDaP77XSfE*wXC<AH$6<`K<0=9qy7>Z^Cb0@IG9nb*lrTzo`of~>J zkjf0CvIWdR3TeO@a0DLR&;#%>0CB+dmu}syc(`whAed4BfIM@3y-x=K&^Q3Ne0_a= z{`UI%G8>FXPXj=+(_i$?SpXn-2$sM8tBf`i0I)*<psM|^GP5@TQ2hb`h$mbgxjnjR z2OhdcumVHvdoTdN(gy(iuK;-B@k?)D9lRdM83O<<P*+O*0FVrZ-s!DD-bVkS-(X1n zFTMR&oZtGpiGd>`Ai)2@garO0qr#)f$mmcg3MwW#CME_t1_stGJRGcBxVJDcaENfg zV=F>JLQL%2#6$$dcm#w5H!*NTkOm1E4H+4Y01E?);D0+^w}LTn1TBO}L<kuE{UZiW z1{(gaU@=@5Hwlyw0R;j@1tZC1-~<ET6!<GX4w~)n2>JEzcq|Sg4p?~6H0WFOp``K@ zpN*rmbtM>i$OZs<E9|5%g8}r!SDvrooDpa*D(Q=Z0f@$+QyHk_=NPijK|@8HKOjT% z2B5?2nkJ%YUEMdhH<Cc*sK9)44)AaTe!(}z005t3e<bJzkEv+t#7z1I^|BRve*lq) z(G)A|L3!R|U)wpa&*P(CtsNR@zP2Cg?S>t^DMB!JW)tQ8SgdwKkI_!&;t)p+ygurB z{s%)a$JTpE*I^~(aKF9VS;|m)kjm^1Y$PCTOTwy_u&Q`tTG>M$KOzM_k>CmPFe&?1 z)XSFUo4fz`AtI7gX{eC|*hodx0u|cAwA283ABz+H4FQA;m5opm{Qo;SO5;gjYS)qu z_kQ*2o#8`!O<|6zXo-X-i6IFsP?NbzocZ_iTo)UQhW8$erHwsSm|WcI*oamP4D!2r z&R0#;9Ja?pS-tfpp)KaEfiFoWm(8U<e*4l^!j-^XEEcO$!khty&dm2ai7;&cbj{JG zSh!32Ga-!@hfj{ssStD?wD0n6NH`M1-X%qqn+%F7ea&UT3GRHOdFN{>z5zX{tZOk} z9nnD1iUEg`L+f)#l|iLXwgg+I$uo~z3*AZNvrH;%HO$Jts?W3j$sGg`ngKwQ=C2Ym zoZ!E1ZXiencK)ccp2q8J>Az|OssDn1L5MDA(f92ZElcvoB-qmDE7b2oi;^Zn$rrW_ zB(;V`jdpat-XPlaUdUn^CP$%4{ws%Rkp_VR2R{?zvS@O<nTiKb-iO5*m@PYsc1Wug zzX!ebO_~E;&OZ}YTiviOn@EGBj{gszr2nOqk-=6nZ<7cf1pmneibVA%{2OoreIvdy ziMq43|E6`GW%fiWmtQ$j<=b>apYxF$9K@$M|4JkPsxz#BD_QZe;!t0I{g%REB14_D zb}C`YFl7e(B_eR1{d=m?X5_TGFxTyKm?fLgu=PZM5q4afz(#fx^wnXh<B-l6=sN*G zN*n(9_k`#|uH-aoo-_dJhgml!C~WJXCS!7&B1OTi8N@>n*=2HGarX^m;CZt^Qw_c> z^lyf@27|viq9P}kuY5_a`7G)MbnQ~tjZcUoP}%=m@h5|GkH$C?SjQLA>NyUI@KV!T zpT&K-=O?YEz{lS;?vDqRr8}o#E92(wjjk`o{p(&m{I`9C<Z`){_Y3VETmyco6h~DJ z>~bQjzWz<vx6*y!9fI%&gu?Kr?SBS_S+oE6@cnkeb|41U2>@w<d;5PR(%`{Rk7~c5 zI)jCC%*M}4BXu0fmlcN6yF#Ep6PDv*^70n~P}6VKt*4Nij@s{C1WI`Sd=2F4C`<l> z57=l8ASRK1sjQo@#90>|qUh}vZ7d&p*qWCSt(5oK#Hxv|ztCKa+p}}jFuRT@4EMC* z9e~m#fBaZf)pYezVEI2XrM!Qpx#|4ud!YYm_xf4l5N*-iL<wKCm_V`8$YoLiQMkQZ zRoP3rM-)~T09{wj#9Gt6i!{!L+bbXcgP82D0ik2+$EtBrx{vlTqr3+KO`j9r^ajng ze{Aj&L$~BCXnd;Q>l(nw{k%H|!DJ5pADzWY4nIsg)nD{0&M4f%v!3)%5u%Xq+dX-+ z|7kiZG~weqFP$CDroktH2n@OLNQFI{#qYb(@9Nr*bOo<UHchaEn*=5=OkObb1_S?Q z5;i+$$2ZWiEjUt|%bx`9%RS$5p8p{({lr|Qq`_~Bog=v#`>Sn+BS(RWgKKZ@8_Q$y zuLz8LqV;J5$V<MB*vWmszvtTLU!0#KE)|B$CsZwXm9k9{^~HF4;>c|*oj)LYyoQqg z_4=5M6Q;0dLghM>^D5JxXrI75*!Nri#=)Rmbl6SNKSZaMj-eQiY~LmOV3pQRSjiNO zbX3x}BbFVLXGIiaD}mYkA17)U?in`rvt?hhv`D^V9wOyWeL7zvE57!c4NLHJ%?`Pp zT)KMq%(8tlt#m(#uG#3U+3cwA^s}8wS&fnld+_gOAGpta5N38a`Oo3{Pe_pwdp(V5 zeZc^cLNnmaWmT>s`LAN)rp1zjd=Om_d?SVXHN~|aL_g|W*j$ZXnVxBz?$hBnbI*3P zO&2{pc<)13b@0WAe{f9rYe_D<WwD*%{uU!RCH_9&5a;!l5TrCef^SlWJ}+<=bC?xm z^2y`Mm410};`;M&G`FOX%Z^qKEsv%Bko6?>s6;!7E{Cs>s01wn+~)x<;0E)L1f_F- z4L~ir9s*cxDkG(d)x}1O6yTt`r5xkmSCae#?eEJ9SweI$xHGkQ7mVogwUXVsc)bXk z1};K=R}8j4_ohEof1Qk9aEeL0^K+jlk}>164Ge#zIHxS)?JI*KU&DVIfFKLFSp}I% zw+DkeTXb5v;svj?K3@}E{q;N!yrIFFoGk{t-CTSp1|FpbdJ*%<PhLgZ4J<myMOM4s z!T<1Rvbs0ILMAM3I7!~z!9V`y+7a&lDn-m5tbvbj^oYNNJ$cSPhvT;`C8MH6#hmP? z9Axwpda*=#+zWnh7-NKYh1^Zz(0;}jpyvKH1gH-rZx}%aZKk0kM#?sF)Y30672CW% zu2UwTo0LrSdFmewMZg>``aP#!4yX8@+y5vpMj9W=&=nKouk{~L@fZ*hbIg9kSBw9~ zW?!p1z2dJy!NL6{B;a8n06C<n`nF$duX6Z%U98dqZNVWQ_-koIUwZfpAKod9IAi9i zkOd`BlkXPyS6-c_p9nZ65NFT{0SpX`iD8hNtpeB<v~BH%N=NW_V{mG0Wv+JRnoJr_ z#u$nh(E~4(c(8rD7o05fXh%2o{dc)$8+dAS#a)jQ4{Pn_G#vEH9?qoV^4We6V_7^1 zhA(00OV%>avOtd5&)tK6Glt6KxF8svtA@+Lj2L4`$M+dNWOzGadll{DOLsod3>k{S z$u!eMO{V)<6u?UOh#(lWPdGV52yXU2i`?LRkU}1URswQrYCS${a2^$biORvWV<!C{ z-%eOu_}vnik>O;bcToXo7$9kn-U++{X(^WzG=l8Ga|y(?E9auK3qQ|;Qxld=d-qpc zekBb3N3%G+%O@o=b~ctJkqrTdh2PlFWX(<37I&0WOlyp%SS|wgDhD{f7nc|7-5p~h zaN4H=rz7~nE@;ZHppuABYk$Jq@lf$Xe|RJ0L6F#4Y~J@<x7~lTvvuNGkMA5bWi^hy zS*)AwALVEzP@a-aXW%zCVG!3pD(*EoP%>CHBzIhwR_c(C%I<9)V1@T11_$IxDc=KW zF}mpnErWP4d`~URM)~%1c4RzYpe0Co=~Sq<D_wLJx_0N%bfSLMcDEi}gCs$;UuiCc zu)7&l1=EBPya267637E{4+Dw&`%ML<V%W>GJNg6JwHGG7MRl3?2LmHpHv{$0y3F^! zsJ3C9>r`@#bk=ij-7c_kB*^1mu!%|e7+h$xKrdCVV$=-xNk~YNaK>Q5&VBX~K>nra zGfHsrPMEoJJ@h*`iXO#oRiY3mo?dU<e=^~pdPe&3^iA8T|KaeRgOo{Kjl__?#P_1l zGh*ZT<KKpk9Sq!I<6E!O?=pxq(fE4ftf>Fk(~>7*X8{l;u(h>{z!$4Qn%4V`?w}F) z8w&BB1${DHIOm}Ie&v_jlmP&22{&SakH^%&AJZOCg46!iV)?<W-@d=Ie&(0cZxqhK z=Xcgz0;9cOY;)H(V)T185&b3yGx*eu_;7PisR(@t0>6|f*5FI-N$FA9c_@i)G=Q-p zVjAAYcY}8G0Vg9P90&$)5X)K)zziV?91GB8h__EI`mO&wu+0s)=vPrq{MW59_H*;s zAUcE#ROcU!2|(xy*WDWl3i{A#CE>+43GUl&TsU|KwR{Gj(@entKu#3dY*1<WS<ztC zRAkkFG3EyO<^#U`E*1ITz>tHFULf#GA*3PurpAUkToFD0(!d`U_*<agM((n0?nVDj zMXUK=Hte_w%{RP3A>gC+2R8Vk|38GdcjM%QMQ$AOjaGk45ez`2U;gF*W-d}UejVxE zT*%Gy1zK3}ZzHRLJMiE?F`-Dba9b3Qiv>`B(Z5bR`%kT_D0DT0?&Mh(fMn?cXCa<= ztM}nA5A#1Hh5Hd&a8CX)n1G5Tcmq0T_)`TA2>woUA&9ZH-3;KV4e+OiLGa%p0{(&` z;=y1gq{nCp%;4$PE7>^!P`^>gO~GH!1b=uzuvnOl^nYmR7d8N#=nDP@*D9RA=OjF; zKWhHIefV>|_-{xMqljO${|yPC`Xwyfq~VLV<e$y`ZOH|Gua$VQ>Hk@B0Juv95<`ci z%-2xn{(}}k1PBS}$HZe}GbMrl(jovwcAtX|X=sAe;XmsEWalPz3-pNa$Bln6B`UD; zA1Met@8Q4!AV}ah1EAoG_6XqH_TbV2p7$UFxOgb|T#`5hghW)F+-lUkP@cOqe6-*Z z5Gr^y1VKii-HOu4HQMK1vR1~w?0J;2^l`vV&$^bCXF8FDlGvbi)^BRH!Et}4>U77@ z|G2pE@#rkwf(X;_-wVVxoHGuq2SChEn->HBg8f(Jzpd!;>73M?UpRko_ZRbjgYHeF zUz7Pi#rP9*$zR=)Z045$|F#XdWH%Kj+dS3o`kh{z&i}xhS!DBheI7$a&0u#8WE>Xj za*T|!TrqyrI;nmCZAaHTK;DSY_sKA7PS#zhvgp0?7kD9_%`9l;o>HA`pGM2FyvL;d z%QRbKgu{s@B6WJ(eh^rV6LHs16t;-GoKWa_mgFj(S5XwIxwVmm^sW(|3tDhX?`<v_ zKdH(TOJT~9?(OkrG&+9QT*4W`FUy^$Bku=LzZp`$l@k1ZGOh4n5E>|{hUF`Y8MUAT z7{}iq^3nT_Ym06o|K63v#M0+w0>`w)>DzGiFy<pSL%xH(MB{_yibm?Rmdj3s_<)cq zp2&9mW?nK`B`l(YCo%O>3Pk$iPEMl;mW0D;^2$H$6QbnFzWtm|uH|vFTI%mfjT4}E zQu=@AR+P9);rO|zi$8q{tv8Ey;UZO82MUe$L{D7YPjhmXnJ(F@mXF;h7pO$)fw-?& zKL+7tUIWGUk5)<uP?Gr8JUPSSt$f*uyc2A0e=U=*8S=^Wj6ZUsg)kLLp`h2Wru3$~ z!n4IBlE05aYOo-U)VyiWQajPQSGkOhKKhFM0j?Y&-J|IGe2RRflJrA=9%6Tj4Odx% zP1wF_ZUdS8bNUMOJ)dAfBo68Y774o^O%29<6ijzqawDm6?PdagzJ%#Dn@)p9x=YJ= z;K48p(%reFr{P7Dy{qXLf|ee5rxW!%g^8t^UY2P-Sn~;OUG3H#w8zMCq0_g`i7?uA zAX03nEp6m2uRFwc->KBgJz9ZPvxbuT2Sjkxu*>g$&=E{^>-%`;WZsy()b)`UEm<GJ z$otA5oN>|e&7Sf=(e+tG!NiW(ekXlm`PihIP^BkTC!?VocTIUVU&b<hz@VmdF^W5n zYU_>lU+#!Y=VBq>9ZagGD=hKJf5im8+nHyZVwDVjSY#Hv8;$Yx|JRQ$=Ji^4x0U7o z+&*qw}~YyYp@cHnCt#O}GQkciS=9!IZV?Am`P0b_t4sa+Ha`j-1+123qHBf@n? z(1(mahg4(oY?&GoSbUQfEsgDnh;F>M_%I_wpn&7VC`fgc=a}OfaL7D@Tmvp8M{cUK zAzqrTgT=X|bZjMl#&{iy>tlGWyspyqts(*kSMCzl4@&h<-@fz3i^5fPYdB@tsRx;y zrPPTj(j^Sb&)?ktkUz(?iHPji5w3eN$6n8l7a!Z4vyX$(7G@rzMdL6qUm#m9o==T8 z_I#n}^Cv;uI);O*cbOkE1p88~V;Iwv={#wTG@c^J;pij>n_?++JF`45cP8SA5o<7% zs&7D;Vs(~IOf3yk{UP-7!*ZV6u#oLb{BHrmN{;r22Ym|T2M6Q(!{!6Z(L_~ZVm#yq zmtd7z#;eatzi`tkz8F}u@gyeyQ4m{gACxg#m`+>#L1)~3<n2YpNs&ivm(j5~B&=qX zFVj6~Y_TP5g3f&^+C0bf?WIHp&k#53UA<TK+S_H<KzDw-lJs!9aI3@J(8^_@Z-d<S z!fqo1+P;R3giMVkx>(Nx3g>wZ3`MAN%3~g)4pEbZ_cSBucA|cu7uG<P#?yVhQb-<U zCq!SO<gOicDgoPXznvakE>9SGm(?{#lrH`CQWbM8?ZBIlQPv$XdhabX%bd}=9JUe} zq^^NiXF;N|wZ$!q%jNV8_!lRbw4I_UL-(EgL6`kZZ<WTN#56+MN15WtAN(>{$(eMm zArXVLvQ9UHuCB{|j>hM3K~w_4o)12J#ZSH=V)NK$C78V@?!XPsVX9(VhlDF}kF>X0 znw3^cp(De3kw+zBf)1|%nW&jD0e8zVGdGWxsOZo2r4OU2%Hw^e{iA{(Cl(TI2XSp^ zyvrW1mpAA7nxb638mc&989i#H+Y-Pl!MLbTSWro}6?yUoe2Mo!E;YWvRh=vjbu-2? z%v&L1RYGXsi~D}s#eV@JEfXH$o`hvHuRSL&6Zsoz!jF|}K%8+tMDw8oN4K@!ZnQi; zA)kynC5DBELj~zIFwKWRs8+E-i#3008T2k@Nwz@FIECQBJwhAa%J?4gEJAzp__>O6 z?IPk&d$uMbFG?o3p%^A%*%syeM6V5Drg3LM;$_C$tEbu5!0{&snPI$^K7T72dS=_7 zws@6$Nz&WloqD5^hAf@j>N$jwI8ADFy<F~4eEbB4mK7Na{$>U)ZKEb|9tH5Szb^34 z+F`7u=~SKJ*6oTE*ICfdEB+WZJ~Z#Pzu0c9*`X`F+7-o4R9JM^i7mx$aoI~;x96}4 zw!b*3#?M_PFKThQc&Ef&?hc-d@Q?%NTRL>p5YC#gys)nd4`R{gQ587_c`3}y?x{bI zpo?u<2WN}?dG~yZAOn~FJQAM%&r3Z^M0}&QsFLJWMMz*a*5((R)td3mlZ0FQ?W}v9 zK`DD_qPb@p;MdgzA-T66PT`gHI0PWRzzJ*q;Qi)9{5ndOe(Dl>GWD(Lp6n01H|)V> zsl?+db0qFKvViF%zt}Wwv75DtsM2H=jo0N;b^QYCw6EQ($phDY<uN33IcnUW_HtD; zRPhn8B=cJ7><cBDMR}sakNF}3;=&GC30Z_Xaxv;xl)GORxQNx?zJlzd;G%ym9C9su z#v3C?Z~`Nw#~T-JnLjffZqyzo^gN+C0J*DS%45cU4Q<$wX18lK<%_<;>XGmzpUR1d z&1F}*)t7Rh*k;J_f#gg0T6b>f$vEd@w~o&5#6w~9Qp*7?ZV@trxotl}_U)X=aNWNX zOMU8oBdgtF)p5`S^DE3_-q@G3eYq7FK6|{hXViKDV{2=nrN9gP=}OOJjpCX*-30T2 zV;#~|v<EgZAJbsPzRP|6X^1v5yPG%=FL2K%nfi5S!b<NKt*61fo>xX@VG3xq8`5%V zjw0`pn4|7Nkg4~}l81WZd1@-=t81xqVjl#sE#7lLGO5Nw;A>1;mu616m&NfSj}Ww? z?ddJ?C9kCDvv-$^^0tl+`FEIq<WTS?H0vXqz)V_IWV|uB8%OL43_b7YX_GZugYPt& zvv)q#+g!9MS0eF5Hj&j7Yi3RmTg!bdHX_Nb*+wSx;caZ!%2oPsI?U|bH6S6K*|>Wt z@<yagrAa!oKF7l4mB%;?iunF@w?^(uiCCJ?r+EIKbcxn*`Se+OL*+uGHP3|3vw+xi zRJ#lD>dym$d*RmrllZ|MUD_uxm|uq<ye_LRppB}i%_MgJED)cWxxVZhX6Db)b+Apg z-7kD08bf^YowT0za+&l^w=r`SjB0s8BMe^}r;gukBaJF2{4q^w4m~wHL<TjuCqlpB zUXPTS@2HByt=I0dkGw+~WuH0lLf)FA`n;39J2c+PyBVXlL>P`4jg#|$|2Cn{3L5#m zDs6p`%J(l@_$4h2aT$gQODFQ@=LT94q-(YsoX)S#yuNrfy!YJ2@nn2jyTjZ|P7W?< zqy{{)6d&=dV(KWwTrErcbwo&!qN7`FOhn${J?Q8TjrAfXZAnyH3UMyI6wwtinGimC zfs~K^ro6k8Sr4@F<>)is%uC;EU<d7^#EYd+q0Rb^p!_PKjk#Rh+Pf8ZROnK){qa8& zl1F;5lD(z2QV<s1=rI;kG=CJoB4dIn6Wa_;EV`HbY0tHzeTas&QFZ;Nd*x4=Vcf~f zbS~o(r}RKF*ecr$ci<jN7|oM6WwOU2k84ZxUJsGp)lZ81xL}^a!b8=iOp~;T>W?!X z&+9_SS>hYly(1*dgrZ_ruq^16p-AOl5<|%wTcz2P!DQ*b=bt&;md8?g0)E{_<3mzm z$@J*PA%iKZ>};eNPsd>8Ddz@}{P_;$Fri0>aiC*hrqnN_0NXLadenyt5$=<Hu8~T% zjz;z|J!6=J=0<tm+>dSab@+94s}yW~T;J)HU^L_*%d9R%g;K2s>kvMaq4h7w&#@u` zVs4Y&M`BG7w_F^%rS3W;MH^APFR7}2o9YW?IC5#erOP!SaL^+jZ_IVuG`vn}<0#wy z<#+M+jo1h47AYp0WXpah+%l2oeh<d@C??F8<<VlJF)$OJF0xsKH;pBgSF{)yo<wH~ z9=(oGqU+>~_u3$EH|g9A=+k)QHDhCC>gZ3jcx%kGOe)!PIXh#9UAj80Epdik$A5O1 zBGb^g<W)KhR7Se^$i|%FvAljWUa~Uy9^IWx3r5r3T^$Bjxm(qt;kaiatjX^hrp|nX zJ_R@i3eCFfAHz%`k2Ep;X<CUbIp-xAeapimT&HEw*V*+~F<cIxH7{&amcBH~FFcgb zE~GbGDPTt1Sf@zrF_J3crN@cUB;j0uat*zbVcnug%8ob4j<o+lB>67)u{|A(nYg=v zQ9Cid+lsp)7=Ps|gWcIF>;sL*CVokXW@BUPROFVEY;^S2JoJi*jkahZcm^9M{QJ;y z3ixbCCWw0C{>lMJ$)PGG5KeZypW+e){p{BqL#T0|s^m#)S-R7r2O*Lhnnt1aA>CL= zECJoi*M_LQ1v5;1Ja-6=O{y4ekmg79r;_`gtz2b71uA7XQf$XzrU=>78Hl$9HB_W? zdqs_^9=YvXpLS~vbxbtDI{L@T?L~Mu(iF(}s!tj7H(hp|c&+R1l90^VidKOe+C6vA zO<cZqr}S*k&-T6_9Ol#MR6~{=dV&HL&-|yq2QE3)gu(36{e{gH9=m^8P4B`x_PH^~ z6}b03s=O@o+_gUS%`nh-Ky>d-tLm)JRVJM=m#%38dEVWPNd{A5>R1_J>G+Sd=~`>^ z;r?;QGZL^4T_x?YQuwSovK?zBaL?uTfd(XYy;~KQ1$_i)>vOBNla-gTo<FTpb6GXw zTXUEixdYF;4tCuuwgxB7*c+aDp55%n=T-x3zPt7fZ{1AM^|3WL|2#1d)q<j3_rR5= zZMZuHJuA0rLGkdy%4NS-^4R9@GA>Q6Q_!GOZn|mAMP4$R9vCJ8_S=WWvqM>&&8bN< zwPa@OQvMfLSa@Dd0qm9j5sPO(@78e1;LQd+s=ZxVd|BC5Q)NQ<5)UrpmNs99vWV8k z!A(!9Hp0J)NdLa6arfB#O{lWmKYZis;cg!$Q2JXYk!pb*Su^@frJLoTOTe_0<Yh{L z8=UWs(f7c3D_htUyj_*k{;|cpnuyICEzG{RPrc30P9wqu7e7b<Jd#nw1t8#0bb!B~ z0Yyi-Ig+{g5d<V^E@TwEyZ6)|;kd$orC|`Cid#zU$xrad8XlSr&4VX3oRV%&vs-t0 z?@Py)EofP|WZfLsfba51K+5&{jjbO(4~<$rB_!{uGEi=2(#TavVAd)CGXeNV0<(If z;NJ=pnAKcS?OvkaU?eckk`esE(kd?dlkhivf@rYhlf#DUHNh>$O!-wb$@|m%M#;}$ zepXe{rnSmH-z#!V=PaX*iwvve`1VEyP@sG2dFP#ZeD4tUVt%nSZSdZ%t5!r;^+^bl zQ1c>M*<7;#%d7iO9XE$(D&F1R)Q0BqBQ3HcKD|2^Q1#tJ)leQIj43569Tsm_EdxOi z=P=AM`%X%<HlAK&>6cqKIEtfQkK>i~$Z6g!^(_R$P9WAh$2UR3Nd8rCgpY5{(P@2< znv#h+ZuDj<Ltp2P+1M$}okf1oQ8~QyD__owLpE}}l?+)d>uUhp@1P=L9@UhxMj{vc zUVU46%sb74>V?Y6uvv1{OCm>qPd;<3)(7N_{)>`}*8pDHntk`V*jlyh+uY{a{)OZp zh!sIfdn(T+_d}scu&2GA#@lOMC8b)KOd9+&#qT=J3n|W{?@5ur+kHN`(^Pm%7L9|! z!h3c)m5<lC&hS*zGeu>QT(esYy1%%McGBo&b39-cMss}c8i)?>C<eptctT7VGXjvw zg4oO3O{2RibQOw6vm>fc*-quk*G^h*w}p<XUTBI*dPT1%C>qMT@XXGo?mHfXk7Ij5 zF+r1COvjA^yk1CLSCl`{Gk7NhY&J8^1fi(l6Fif!q53FodQH|tIa*Ve@YL1syI-HT zNxMNXY()keWe+?<2%JNllP90I;(QYHk+Y`8qk`EBNY6!X4+$2G4o^PsA0&2@*((K{ zG(Fs8I_k!bH2u#Tg^9YCZp)Kudb&s>d`Em5_s+QDtruy|^z*^CRuOzpPN{jan8LT^ z9i)B5WvTB0(wz6#z*W36+IT#llmI0kjO65#TC>XT7}`>0iu|G;C-p7&2h9VIb_|{6 zjv!B19xg<7O|l;-6g>5!6G7TkO}#DGU>Z%bCT+`GiO)Wy=kHwigQWp4jSk-<8@K64 zSksS+PR5r8x<Xw*<iMZ=Ue-F%wg$Z*!$qpaLT3JVjxd!Gs3Oisr<m`|>`gzURRr%^ z^2)|<iG9Y|VpSO8$*niZvQ<SKimJ5@Y9O6l$$-v8mAXgKGJT6e`&53&o+#JLmv*Q3 zR?`#2chmV+iCXVfQtt~5d{2<$F1DOy)6Q~<o1bg~NAoD?%~elw!XvCZo@A<Z%||6) z>oX5#hs1weV)R@C%9k|Tf0hJV>b+8VE{C`+)>aw#41Dgm1~@Jg9C|BX_($r*bjn5B zm89rv#N5HcUXk!4G>VS5si{05_ePL=P&ZY>IP>m#yPI11Xr)Atnyu?xQF5wdalqTw zq;)Y}&q99NrCy3u#R2?jnh)9-<SG61&p9WiflJTF<SD}_4V-H;5S_GP@QZ6Gi4@S9 z0WB62t0|jVYnOasY~$~C4H=aQR|<8Cs+10ONX`up^VJHC`*P&V7E3MqzC1+8Q{xVN zxg$<ar~X!<Z-7DOZO#j7Dm3OQm!(fonQtvCqt`%0p{(CTL7i;mUEl3p)d5BG_neyV zMxTA`5#tuYcZacP-PW#;`%(S9RD^YzMKbRi=p|<$?Izb{QBkWH^KrEM;Ld;`kGep% zBkQ~&ow(j)LD?c|Q!P0+D5mGp>ZDes79&*{Y=19U$%EO~nNiIhe07PFeotkZqYhbB zXs^zsv$15aYX572bwlYVj$--T>R0dF9mT>!{U*}(KFi#l=4_&Pt|-WDY@R(i=l<iU z)&5y%oXb+NR6=fsO8Na4gz@`AA$O8RTh172P7a<MJXhqquTcJ|&AM{8hLux?6w4vU zNG*%@@D`m#eY91N)<V*oEwAA@L9f(P?ohqbrIx*&CYP?9&Sj?o;T^gvdYj0V{W;-p zC5#4JosN7Mb;6vKAN9GPe`vMpSF0}1K`0VhH4fpQ?5D0b^2gTbIW_Bw@9Gx6?4pRq zsOA13TW)FKs&@ZK#AcUF1nbB5M<sEEsbX38$o=K8BLa%paeGpQSoK)V3cGs6_xnHk z>@I!w9bLt@?pZ+@3z#MImZgndWQYwiL#pW3#}}R+Vm+1Y9^YwLj5=*+UFk8KHRsb4 z*GOMXwfVU?u$A_sVx-(+%vVBhEd#iaYl@#veZuTvgnpNxjlx^*k+i)~T~pbej?xN+ zgKY7;2a8w?9-jH(pG3*tpNXNv@_xG3=a1UVh~#Q?W^Tt%9gum&Os%dI=jFoat9$)m z(yoXLVlxvxRin$KENpC3Q<Vmr6<ZbL)`e@emZEQLdbH~k9=SGeN|4sdj8nU2JgBMm zOScvYI##Z!c0pnrEXBQx%e^I5&?c|K;OA82a$i^O>7CNHFFncZg9-M&%n0*g<KhA= zbcyNV&m0aKh>CI@om9#ihqlt|#7a|Zo%glPRjT_%D4;>n^JpI&WnX;kW*)T4wa>E| zbBa^w)lZq{W4)DG_Bc9Pp>n*K|MsbfB8F-wc#vXNrdQ0rdMd($5#1@0sN6S3T;S{x z5HsU1tew#>+oPnO^_?hWl|NN+<{@&Luk(Jfx=M7vz%7QL7mF05w|m=F>1DrQ$SSxz z8qGcM7pFQbMA0l;X7=;)R>jIm^S>omnqZ)}OI2uMx3r;@C?J`cGyg)Gc_Pl%!WX?| zdQW_>V&zJ+yu}mGw`4Q^jL@cj_`}e!*Ih1?qTQ$g!WW$fPD7cx1gFlr1|FOyFKGy) z!WN)<ngQ#3Q#D-%xw5%-p$YVFM4q28lQbl-As9+WJ+9Lx>#1n;uY5T3(0D4lD7iS! z0Vdx+EMebvD_O~$iI?jsuvEP)!mbR1*?722`o3t^w-#h0(e8Mr^JZ}O<jL5U>pG-C z1bG9COo(YDfB`zpDf_iZXwm*HRwb{fhe%uDOi}XZIJTe_8_G&=6LK4zdA9vq3O(EP z6BAd1bMIG1<%{G!$-MD|pJ?x^(&^aRJaX7(2tA#~?d!`}q}y4i^b8DHTBA|EWSh8P znn;eD*}8jt5dA5CB~S6)_uHJGPU|z)&@&t@Qk;efgnPDF_O*kPFVZu&C@3C*&S)a7 zmcQr9DtUV9?B|Bg^ls%CU6og;Kp^{KTY*;o*%yv{i*(o&snknDD&MNdp6`3EDBe1A zY4KDuYorT6_oM636CYR9pjS}2h<z2&#@y*ikRPT?Tiou=Nz-Spt1vWryyW>B;bJ51 z8rUPbnqNpd(zbbw`D{gO^WD&K5+u+QboQs1;1Tn#cKIthHLq8N(H<EeQMLD*=rw30 z-|S;IpnrH=AsDVj>nis3v9|wKZ-V)~mbA7Vg$l!Bou*wvjM{;!jv*odTSC5FX;1lQ zPCtXRytGXci^U#B4_O^U1hp@X_sIXp+*<%g(j;qwVrFJ$W@s@pQwdruwHRB>%*@<k zrWP}ln3<WO#n9qj{r~K|H*fasp4r`*-C0;grDu3}W@S}nhJQ|IB9!y)BCWhDw=6^H zd`6PZ&F4wtnV*j#>3fMWvrt#wuCby?&6r%;6~58S-wqn&qr}v~-Y%tEriQh*I@w;z zakP~uB5x=$?0g;l*cO)ieiGOI{zBe<vK^mTYq1~aXlu`Rw~}<ns8@CIh;F~1cANy< zv4e7puf&KKXX*|{r&lS8XU>D0-Ru5><sOnBJ&--?!To*4)Dxk7O!7=n_&2*FeP2v} zg;1m$NDPBv$i=~&ORRJ_F)sP7vV^>l_@J(QIy%pkmiDV#^o-t>7#tigy?J97356p~ zW876L+o4tDfUCzOyvs=<MLdqzDWXVAKFV?@GufwGjAkfUSOkn>PgBvO^N0SnB=<<6 z(IbVA?~wYnQ`kr}U=P_b+nMN^?-2L-7`u|rKe^A3_NXd)>GoGDR83EV?=I?q*r!Mq zz&RG1%j3L2Du3nzF`6D^EeKH&zqs%Ez@HC|AVsv?iCiPMNNMM)0Yz5K-SdjvX=R*k zJ|v^WkAOCQ=$c>Y(!4_&5Fl+0)C3)Ngk#;ws$RdiQP#jyaE;nSCLV-_Q$B8&bBMhI z##@bSHIHFqT|;~?8Q0l@cqqdY**LdW+^cgSH|`x#SY+UfE?6yjw7(8kOv;r)x+f9F z0VNFoTF3`M8$$#Vn}SyZ?k)glns%Y9<A!`1_dzZUGIJC)9j>uEG4Igx`s8G6Na_{j zjy@CeMCuD;5JojB`OAZ={~_Nqf7m{PAgi^8X469fZHM=zjfEv<rO=gTGZMJYAplB@ z9b#~FwYxpC`IRcCr6jxz8LV6nx6|9DLO%<3s}>^*=hRQNl1SB6$@2j?h5cw89!k7L z9O-gdetD(9o$<nWsn8)z+_Yi@AB1#zbpzl+iKn)9cskYMXvxma{=%dPEwUl4!CYg4 zXdmZECGF+Q<4%gF_&&Q<H*4Mc0g9;F@BX{LZ_bSYglJxf`$}>65%v4cyL7wzD<EC` zYe7Bw(a&k6QLbXCfvM3xu8^EdL`=t5p~$jns@use-%-(LzBX2tkPD=(kUgJvR_b_@ zqfamoUh1hsBk%b1E_Tu4`S>n*Te7sHuB<D1KuT7y>gElltM|&@U1C7)=}oUt;(-Ta zyqrCQ>qwp7EB<~{NZgk$=R?sq;!3`&G1HAG>r&xfNytI{w{4edUo4;F(~3V;a<og* zCZmf=N7epJ_-uTg1p)N8W+6^9@Q<87AQytL&s^&=#Sb*CppQzK<7(-BilE@`qANS5 ztX;5|%#M!hqkSfk+*_Kf2iS&nfUVZ*gb}7b_&PnT5z$@nwP$3`Z98jQt}Y!fsQDc} zPq?2e49%!mo<?2WcM*rprj?kT#ACF9ZWpJ6W}TbWiQPIGbHzOt$2Y$^&dhDiubU*= zmpHi)-;|K>J?b?l^36sskeh@geOU%|*q6qpukWMUE^mIpP3F4N#nac--Nz9Xn>Ece z&)+t?S#t7Lm(2}FKz>8A&rZJ@qcM>FT$m!+4sW<6D@G)|FG&0W0Z(W-bqMxRX^hY< zw09CrjU-BPpEgqZLZ;Tl5!6i6$+=QW96!ewXDKeBr8shREqcAOE+Af54_dQ1fEIy> z#J_n)lA7&H$@K(nkz20N)vmu}g0GMtjRH3Aq1{F`dC2N<FE!NnWUCpaVEt80v!gNF z!-iLMHmM?V>2now{B)$vwXH;}on=wlg4%ldbgUUA!1t9}xr(wzbDjJbSK4ZY@%**V ziJlpJ?Lhz%v{e$x#f9WUu;huZ2<*PJsBcHM;x-22i{c>Gq!5(~+cBTt{$5D0<mkDs zDFcUzVQjK6NzBbciHzf*t>p$^KDXu{5bI-s#<kn1HKa;TsScvHJLfNJmb!#yRL8OP zPfA);9;=->^{M_$?&rh-#HwfNE?Sv!YziNCl4WPwl2b>-0Hh@7$|OOdc|Yv?=it7l zK0b{#nhi=HA_~_6VY}2pyfr@MC1BFhEMJ7Kk?pLQ1<!;F1amU8U1F~#xkF;1eben= z)-9ip6)OmSTg-mt<fJwCA+JJk1VWm-OTuXGgO1fqVI!EQF&}a|gv|Ep`@D~+tCCSL z&pT5Y;W_A=@S{6bK#6VxQ5=4f!r|2LeiMr@A|JoXkR}q+jwoYWA9~dXm6{91&6$75 z+?D{a&o6oC@<tJ_ggdreiEURcx;kv_c{5SL(=Tmquse<G4~Xj)!IquPK~hpxw`%Q_ z5D~cH&B^L$+69ot40_QhH7bndhRx>>NLl~x13dTbxKnX9TmG}={%~CE{^h|~TfXAV z6}=H@m?LnrBMZsQV)9q1`F&Z^Wc8|_Y=ildT9e4F4*A8`#W>ZG=UOT11pV1s<?qNu z&a<Q0&yLMsB!@+|X@2>R+z6y?x-GP0o~>FnH(`qfj<orPY8aZt#(Z6WibIex$VzKS z%n2z8i9gjiv)>1nIy&d53|_G*E%eIChnP)Om73#G_U&J|hYPTUdgF9YzimG#O^2oC zQGW}1o!{WoXyA29sl!S;iJ9!ECF&`^>@9R#M0XF?#PLz0H#^Z^PyK7dlriBC$cfS? z;v?}l;sXH*4F>`F88G(gg!4Dz^H<JM2oy3Eqfewq`4jTN5LGpF4CtHP{lt8n`XO0_ zjc>#p3Me?7e<uEz`y1;4`wQ!t<EWQ2Yb`8U+Uoq-e1AbzIe=CbVoFb{4L71GT8HUh z1!+hR3V;DwAqBwoYJ&Y^56KMZe-fX=|Anw}Xf&<-*L@^2)RF%o>2FpHn2^7u{+DTg z5kLRqcpQl0lgCRhX<UVpA`-hnILXIy07>qO92TgZyn6d!sUAouO0~#9?(#Phb|Hw} zr?}r_uHdcxce&gccTX;OS=beR>EJDNZjHIHEvblm>T3rh{d284)SjI@bqBe|`R0e_ zFeR)Z@>?SVB`~HpH25RuEw<Ab@@1<C8#zsA6}CKfc$1gSB{HrL3DBI~&ictmSq{NW z4z35ANu==M<do?<EjL|~78zZpA-$l9*j!`a%P7>4JdU5{(l|ek4HJEW8EOcGEunm% zK17Qf%LaA%cfU!iS&0Tk`#&IX;fIj0_g}9yqk{C<e=XcOL!Z5u+2Gm6CV%E6`I+Hp z{~`98WKVJ97F!ymR@i}zVUupLfowIg;H%zuBW23_<UjZMv-gEvR&nH8-wQIk@7uUM zk>^?&%Npre%XQVeNh<tMDQoP`N@pGLlA2Q^E7q|cF}QM@A5@K1On&b78<OeZ(tjh} zEJRv`w`>Mnrrce!?!hi9r><D^PCq@BN|5Yhe}V<0d}cSDO5qEBtPSoBVO?Y4YXxlI zpTaL`_>BEp<A@Vax_)i=wpSRK#MA~>FzA}_Z=mZC7U6k-U*|<ym*jBg@g35UjVqN% zeT*KPP2+wMI)rPU7-Eb=L5`LA1Cpn<CiH-p^#{bo_3?>Qb+riTH;;Rvy9JN#doj<r z{>@R|CZY5)Rt9Wd2$qw=DkAt~pK!(^8;IyG98)a&mE>=oFA+_V+);G)&@Ll388Bb@ zm0JVZo~rsbell)->-Kg5(=ny8!B-I0wlM6aS*cGO#oy3(T;vwTR>H)dD(4Dnfcfh1 zScdv7`t@UsyS0P8Y?}bR`9@?waAo)x$qe4o!3M_U+qbQMNK<Qmk>0W;{Co7k|K~b6 z#Cpw`8LCB=?&wv=`xs8icTuug1vb#5*6%j&qvTg>5nY3=+6mi!P9@-Z-&V?VVpX<H z-+z-cngk4>@O{uRp@i(eAoD<;I$ViWY0tr>O|loDJIbHL+Bx_0`&!fN!WK34^?@QH zY((S!b|ZBH6A=3*O@*U??H{n=A3#(VKvYRUL1KO#Wp6D>3C?j5ZQrpPnPB?Gu}>so zpIAfbhR_u@%dX)!&e*p--uzaK%~Gi733^pmAL%Rs0&l@G7!>r$O4j(N@-QwIVl!<N zs9yq+3hDbB?TF60d7)NDeH$btHcp0y^EB}9r?-1No~c%K=CMig<i#x{owcu8DMC)S zrL}aPe|5fxhkk3JsT=)x3Tz>o1TXinZSp$>%KK%l95RY?nP0d|EivJkm<IlU@bI*N zWfiHzwyP=09uN>vxQsh0w2FeMIHU<ts>$-OqA45$@|6#=3c4ndMm^}kiB8i=s88-s zyLzJ%ie(cjU^<u%#{2@sBp3WrqV$&T3l3J8iZ(9X==c<oa9aB=hJPNcecx2b2NoSe zSTt8hpi&9+^_U69unh|Yo?c3cS$eI^2i|G{tcR=<%F*%q$gayzrJ#R^1;@7Z-`01Q zcC!A|kPR&<QFD<;=TJGOs;@eUJ0TeADMG(jIVzoZ;dfE1I5R&O4vQePjmXhB({)2s zZ}j6mF{+HrJE^qTa^|#n;N_N-%J!U=vT%`mfPhFBzYryxhY=nl)9>qj`f+Og^^^fL z+nnE5`j<jgVHao<w4*?zc}flWUimR!TwoEC`My)rli7wzH>Q%%Lx>t&3@-TY^qda9 z>ZQjybu+N4q_uHG{R}Qp6ffpvv_pN1uvN;c;pft&VkZ%mx8`%Vrt_t+m<`phA7nga zR9Bv^i#1egA?5p1<;tpPYT5d>m<p*I_)`LA`e`&2#&yD}8F0C2N%L0F_y0ur|0htN zd=`*HmREc*aEy&hk13i)MX~o6mhU;R32JDfp+i>uTv|WD;$j$@pyr9EE0YGP*Z|X6 zii*hCeg3L)I;4yo`Ha5epV-TPFyc<(m%QrH21Xdj&G`qUC|P0-B@n(9eIsT`h9_OJ zi^W(grO`CTGg!RJg*Dd0zgz|5YPxz_JZH4EaE7b?>5K$F(l>H`Rxw|t%~?V!8qO|3 zr9?zwj*g3D_m+GwH1Q}L)WhV+(40^0duda%sB8S)D$FV7*9g(VA?VCCOu|IFNRXsR z5cn`X$x$_WUjAj)ngQ}cHJX#G$S<72F?d0gqdiW*jL3uSHaJcsX^TZTJgVE!7<sDt z>Ry-CZn%M@=`>XK3Z@kPrNDhqjx{tah!)pU8-KU-%f$qmjdT9bJWi{KeD5L@=<Mzy z-HyX*eUz~y$dOdq_1zx>d(gBdFoZuT3DczSkuT-JEL(4`QMWR@GREwC{4ixbM8@{% za(Z=!FgMzmfBW5N-5PHzN-YZ7aB;t(Vuc7#UtC56-*N5F`~kU-z73tCZ1J*J3NP(e z3iP=^cNtz$i#4_BeR-YlnK$bBwpZ~CoPTw5ztX687rY9l-d3JQ23>YMOQYF79@uGd zJny9hC)0%DjbEWC!G;gp9#<R1(qSR<T7Zh!^5>Js3EI3<1=k(&injqe2QN#PzV~a1 zqjyaa9&*U#bHJsLg9^eeR(RJobP4XO^3UHAW4Oxo$UnU$K?sC-gox{6d~<xSSo}fo z<*>CR1Ek~=SGra}0ioGCeRSrf?N+w11*&i24fapvJ0RkcI)tD^Bw2IVOTMb*(m8IU z?%#=-_4OgfgN#FnXPl?*WzE9eC$xW9XD{t#K6W6h>PA|G`p3zt^z;6R-%>%hEq)Kj zMT_QwG6VU^o)FBQm2WD`&AHD?L@F^*Ra7hMq-@SEdOi2~+O~1eKlW0J(6`5p!$doZ z+4GuNBV!lu&8|Ct<+39ajdB8sSTLG#hBK=lMCEF2_e#nioDYaSQDbCOaSr{&U+OI_ zUqj|loVxfdgu-J7mL(*6+$K`YdyA0v_iDMbZIvQ<1G>F5xmq&-scRcjR+fRY@oa_H z<J=ind5=<0S$V1r<(lPnb0kooi~N}1F`Jc7mgREN7_{muY>HDmK$qjWi$xTQ!r+_O zy}z~QUwid{bkR3XGy2KKxFg;mvSRz4R#Kln9w2r2l}a3Ba=y<lViigcB>S?^ARd4I z?$N}MQ2xaYsUITfnjr&M=o0Q%dEfc+ew$WP@@^HjX(J-&qlztqwr!uW7Rev@HJ6gV z1>JnNGi_3N+v4j>0IVH99mL0L?xk;nw^GP2o_y5Ba9^_Xy!0jQ>=y;^)DcDm52K2C zpxdXEhJOl5=wHA8Mw;-l7rux^6p~OpBXeun-^nCxChYlD$n`m~zWL}#YT>c4kr+4O zs#TUxJ|N-A8;c^hfsp;z6V-RAd#b1Go<#eI@#;WJc8e+mX9X!;MvHXGVqw^ZtxQ`G zO?X0p^%QFBP@zLgP?Q_FV{Dfzh?Se9o3rlo^lx{%ywoeBYxNh<FTdv>i81+@d?7j- z0*M?51Piy~B&UwO;eHA+hi#r@DU=R2Y*qL={{c}^u`0xK^Ons68tq*bRDKkB8mX^x z#{G7q_WjoCo}xB4cBq9NkV@=PPEh>>bFIFPWQ%P~<+F^mC}&f5^V-I-)_HSt9;=eI z*i7(TQ$%pC8iQh&wB{cGkI6j-gkVC!QYqVx<lfMN#1@@WC-<e<j@)ZV$$seiN;Wm_ zsOXgwv9uOz4yjs0r|0;<*5$>AxUj_gj<JckntXu?gg8n~r-zhmp>-Tq*Fmw{Z&N6Q zI(g0OAyh=s9w5eG=ZOdyG(8>TTh6j5oN>JtHL=A}Sg(`HE;+aD`*br^K0^Eh0)a4V z`b`L7wzW08uoD7eEGMXw2N@Hh&Hqwhv_n(6cO#;Grr%^I=jZL@roC()&B<TbR`oAr z6txw=2@TpjDeKa@CH?@px5I)=<1#`r4C9!ogXm#+k9U=hj_)q(l6;8`XAF^L?um*^ z=uS{UDUCoG7v9i|kWwO_W+~4ls4+>Et)jUym5!ot?80Uii6OH}op$H6cj<*ockDRB z(W!ju+G0Vwj#Rm!aKK~*Wte8fu`|O+$L2sumO>*+XTJdU6-e$O)ME5P6xXfd>Y$|c zWYZA8re>;YEVq#<F~&vGCE-c9OZH6Xs^}f4!p+isj-~(I_b>?o9g@~uBbWWKxD9If zTqp;xKAL@Ud?EDfuVlMj^?P~z>8{_twH*3c`GO!o$IYsDO*!0k?;?;I&+&{riX!!v zv>0a}kn-J-(}&qUmFkN<f$sGzlwBP35B9t9xR%^22<#e*A1=LcN^>D|b;;RvFsf@C zCA>w;zl7+dQP}}C1Sq0%v-GnX6l)dQD%wSSfQag}I$W_t#qk6r6^#n)z%0oCpUXa@ zGwViAJAIi!4{D4}!k7nvE|QSnaq7B`klc{5G@jY4YE4dk;{-lR1X`HcpO!xKPj&C} z{`pri2GGv}8Bh?Aps=6n-e-{sRESS~4;>N(<1Z6G8;7!ELcuHvISc!z(ie~~Z0wZy zS#N?uZCA`W@cQN_l(@<Fprpe7f2e(+AW%YJW0|>g*5}A|T1(ug*FXBj9JjD{^&R|D zd@+xqpSAwiO|yX&KQM3lsrP{=t(@10>sr3w=)3xEm(=~8R~t$p9^0*XaP(AcTB7#J zYuj_3=l|Sy*W)ONdF;FQ?^C~$7v(bPrHyoW{hww2@8<v8q5opT7+GmZ35iqj#YiZj z8Y$>C{hz1xe=UOI7|lHrE-1nE@qhc-{u?1R+_J8TtIj-XM!){MtMT8=_y?P-U&6m! z5*0$0I92L?|I=u1*?+y5|Cp}-*M<87@@9Em4BRtAs(2n;K>E1)s%POPb+H6?3_N-H zk*76EwT7Hx%;4>3cUEtpb+Mv1O>aUOJX-t{M8ZfHlcAD|F>;6u47dzP8LVWNiX6>F zVYl611yCmt$gkcux-M*As7~i9hRwDP)-Y#vSeXH(2I$Kdkk3_0=s3Pl0$m&(=u;>& zIlZ`{2=-ndU+I$yGc~~rpy1d7hg-F11-18h3^O!!4fJ26K|alCV47o^`*&Y->cP0o zW989#CavSl#2o{leAjw~r26hP(`l06IBZ=xXHE7c;d{^xg-)yJ3t3WaM8dxM*Qkdf z%+<$=Yq70+J!-O}My4u4z@+U4q;D1M^17QxONX>H87?{~@0n%_l8=5ldekJ+lN&|f z*9%WXVJqosqF7m__-V{TN7`K4qjQLB#t4jJ)_{S?azEAMIoKoB16s#{+pm0@UsE;K zPJ)-T3*583zO3irQmLCu+qKPbwx97?nST#wo5X=6Q{NDBxIR{eGVuxTI<qtmCJ-U! zL%f>3`UB#Z_5;=3VPv*OJz>78u>HOsB2qZ?#7r((5R;8fB0^i24|bVbx4WHO0-^pq zc_fY2_e@_2xQ9f}Zf-uBM)TTvJ<O$7kI1;bXGQSj&EHScDlDCbRc>w;DMA-wk>QzI zl3hg2;Z07YpRXem>`()E(qrk;>slN_9Xh^j-}FgAtB?qj&iYaWn{3csFc7{Q={|WU znL2r1mMnz;#=VCGw_d%iDmp8iEehXGnbGCKFi2)Z7vi2_7rHo*x`vRi4xlLt*b737 zIB=Zj(rH10ZornmdDj+lEkdZ@!;+lRbeUjxTewS!c=}93jL$eTn-oSM)Pc6@XFiEg zi*EbfT2s3oZLDK;BiCWfM)F4_1uMjf!tdh^&Ak@P*6Kk!dPm*J|Bs0M3>Az9);g88 zLiT}ioTOlxUv^hXG>Opqm<^`~+t!QW^*7I`@~0Mu-I7<$Z)@<&*yIkiX#$NsE+4W5 zwB{y;h0YQHOrw10hDYoKl}wJ?bVTgsX<|$^M-=I9Ixk=G20DG3>YR?+mV5_;yQG(y z{y!j*dpB^7`ML<F3F_Z|@mA&^(Ih(c#j$d8H7Sx<pkrcWs2F?T)Ll%b>wMH$8k8#e zceAZtpQh)QtVbp#-_X2OQ>-MRc%+y3BPzuH0m<>ZK*%vv-o5o7+P(sWFC!$3R58<- zcbxFsP6i*mVX@rWv7og%xv)ayFnPUlR*~OE1oI!ZhH6tF_;a?mNz|U#i1jz70sS&~ zn<v20-z(wjIz=vz01k1a2m$sTG51YQNrR&|gLpf+H;x2h3-;CTDPf?VG<nJ5+8Qer z(Om<}wAq3PJKJCqS>d`olc|%w+Zs+KNDRba@)QK7+0p|oNe&`h7e`s3w2gq1i7$`b zD}rkW6A=DIPZO%+EM4KktLlDgfKGjy{^g-gI#xDm5b!|}?uWT%>|>TX<M2$m9Ha59 zSC;a1Y8^eLXA|cK&7M!x>rRjxc5$$qI(S~U8t<?>XSpVCtacvL;TuXB-r$f;GgTeW z8@~W{>{mR3!H}i3sF&w9JO*akVShFm#@Va89J_PChfDZSUl<E|oJH05pNDIknOkix zQwT~#sQZ8dOB_%?l`e6IGm}VnG$UN@amN;px%<<n%1Cj<JmogU6gcCfU^y-VdGl{c zQ5hkF{<yY!aX~nolM&MTGEXsCRW27zCdUNHY5m6HxbAb>0o@%}#ZG5~*%aPjLA*0u z?Y}=<#?pD}ykS}59TOeN(Y6%&Al92p<i*|H>mx#VLPqH`yatDpnw&me#mKR_$q5vh zEX+<49?%f>o!8T~n2m2F$?D`WHO*ZVyc9)z#}0D?NZet7x#bk}dK>WPdikTXhEK?0 z{$uGO2@zbn4*~Nt5oGvZ2zsBE<)%MOgs=s=7q8T$hR(*RaT|#Y+%MlMsi-94^?&b{ z8GB1(^G`w`WmDN4>Qngmong{fmGLxBWn+xkzBV@*w<ejN^2&FqEHy7A>`|aWtQ_cV zXEaT-Ng#|xX4395nLTjUO41y4x=p5vYt>)jhNeJR@@fP;C9GJLE-O#Wg`|>a5b-R+ z2*no<IBJ+FYo4RQ2XzfLy`5B!F77#2MPgT58_4b|37U2rgN00ZO}4z9qq56+u)+f4 z4++iwfYeXm;G>ptu+A&wVZf07;^UetVV!)K%$4}Asp|Dhq7pk%uMmTg1;nKSGFOeP zH=C#Lm44zKPcPu!jD)SFija<9NxHGVMq(@yME@MrN^?LakLIU8SO^h_vk0tTmVXk? zYs*$iQY^f@NIZwE7||=L^%8vqlU=e%mdH}`B5p>*^^9b@O`)B6|M7FEBdM-W#Yv~~ zOvo7cP?hi{L{ubj%=CGJM<aU0Mf5^#XznX@QWQzuV#gm4odH<N$>H&Vvlypm&hU)l z&h+5j5vSPC7^amPXdH~)>lzciRlWwD2MDKbmk=kaAd$^UWYjwcWywq%s6|2AZ_lS6 zKhI$NbS?l%1H?zz3_r;Hr79M~0Tise6m?@NVyLzecpu$SLd{pYnHx(-Eu3xDlXlk5 z|4)eHy4rHVS>cfokz=7CV@3v%An+t1o#GF2<=t)8))CD$wXzj7-Z()Q=n`ymgDn;7 zxTOdGC~AycvPsuECdf0&B+!rsON%3O{3iip>_P^B9+lHBZu<@)R7rjRY5|I4KKC!K zmWT3&BBwn&9>+;i3G$Y&oaLB>JMq4?mmhr)g($V;NtyIk$t>@Jf{>lZw9N}HJ#j@^ z%LeZvpV2X>Wq#4>JwqOGf&`N8=3s-kZc7Dch1aX=wLZ@9_zRy{_zxQUJCCNvBtU9R zD>L8mx7eMRE_I%f^dulFI^*S-!oyO;363>!!}9!AX{Hk6<YW(MZB3D5d((M!5VlF} z6dql={!c=D-hyE#`w2g&&AMwopCbhYj~e`E+MFhnDL+^|iy+g%?W0T2+Sl%Oy8a0c zk_A9U{U&}CGbDCMmVvDaNuo=b|0=l7?slE}Q?w?DVckp%LI;ycR{LV~2_QG6cQkc& zUC>^C5ephQ9H$%*VqCe1_<oKY9H<h36IYoG556ryen=WVKyPL-K!I$_c0Wpyjsn7C zTxS2e++@l#MMa@=;~*P1+TjPD$v$dn4mAt3W#01Ur!7io;KNU};%CClWDrhn5LA|^ zfY}dl#EB)%v}7fF_w8q}#)g<NhC=gz*crAtd0eUof(}C|XOq*Ym2KT`<RjsUrw`a7 zsl>}|cP|FpMJ5<KG?+(=GK47Zdk#@yF-WJOogGJ{j+*$;N$%gqPuizby6cb6@8t7z ziZH-6GnDVHw{Hi$HDNwP8339-yI<BWH4UI=wN>x*V^*7$uGMRe=6?|ty)Wl3wU3<t z<olcXf9Vdv&+h%fo%Lu^bW{$d`(K_k^;8+ceP^(Y6bP?2yq>EHj@k#9&vnfomNi6Q zy0fbCyIh(LG+d<Z=c@XL=UMAlSU4$P6%D-xA;AvjhPsTy(P}=%<`sRJhy*Fznhhn4 z_kg1WPw6lOl=jTs!~ONj8SJBBeHrVtYf2peenmL&ejX!=Dr9@R2Q0?@SV38Uq%-Bu z+*&uEGy9y8Y4m8`_!Huv1^m_Iv}P{A#@i#f$8FCciE*?ek0Qm`M46mgAL(*OG&7tH z*j@2FKNc*Z)TVK@Ju+<*^nor%@BEgQ=2D=OuS_m1nZy97(_w7;5+8g>jsY%)k9dOt z+p|8@gFkSTe&DI|%Sdf2k{3OSA%PtdNw4I(PemexK12Pp9JcO@3Ire)IBCp8cXRsM zD1s%J#!Na6=b@mj58*DA*n#@ISl8-^PTZ_$OyBvKYghkPc{JFm;F6xV@})|`d#5M7 zru?m~X}kMp^GB-mzFvIo>dn>B4gadz`gAJJn%M5DNO5=taU&<u_74#Fq!r##IBC2r zSB+#W0pOu_SLYV_A+kZyWLs~UCclj{kal7$)B1fVd1jg?6jzHL`c`*WK0$6+<*~Pp zGe8xrv9%l5fwTD&EFILr<&ke&Ho#x+ukVyh*$qIG7!fwf+{TOjo+uJzp=095U^Wxk zF9R-HH_i>Y_)A;CDW)KOD8V{o$od!`-x472AG{9_#m%=wXTy!FgN-{-gdb>I?37HJ z$Arf=x?i@v4!HiB_m(Vq@#*<$WNb&jH}<WSoTPngo58#O{65}_WHGKKuh6)Ftsilr zyn(tR$Dyv<4OhM)UYZCz6GB5yj2YK{`_uWZG;%!k8ya`5L5xZ6_n4wY3W@0Qv89$r zj6}Mj$Os@x$eGy%RuvzGqj)@*O9be+A6`lzMWD(zDMB^5h!|8{T^5ytNQ+dQx|3t} z@PKn-{DmJtWGwZOJ4oJiFI!bs=@EBvh9XO&&(&gdx?v(<nQrXN8T8`WwZK>T;YD_M zlz)j&W6%CYLA&wCBQI>7wWaRTLzn%(b(&wTZn+QWfSIEOaZ4@L=bl?F)k;NJmhoeH zD>Ph1tlQ)@M!r+lc3q2(lhq80{zFv&(2_qOPem%BeF7mhH`Z#+L_+C|3*(!5X6AZE z2`NVQ%^=W9cn4dMYc|SWp<m$f{3XJH6F++pq@!){TTkU8>vl6*xh^Kfl8!PorxSAg znxsO3M)i)ya%Q99%{@PgV(Qb)jaPN)(UX=-@2jve^9PMeCe0PpSKJp12ZR%o%pyh+ zwu>tW7}`>_t5)60Z*WAy!~4hJCd8n696?lTr2}=dh;XTyPv2>EbiaUCAUBBzU(67V z&1e3yTBmj^enP6G@N7!AvEs^HwSx@pRUiNI2P7Hf(b8_**|JzW)JR{`VDFh`PYNk* ztoMw$i!=$9Ap_^jk&}(rxpEErw=tmH(WIX(djqdIH`Ncl4Sk4Cz(i)s^@EnQF#NgU zT7WY9#2i2O$W{5WCu$$LXpnwM?$*m5wW?BQ$6Fpf_w_=+6e-@jl!Th&9&@o?R-U|h z{Rk*zS$?3Z)Rwhs839k)sK}H@dzFN>`9tI)$HP*K0ic$_*X1GVqFPY$^Zt18Nof?X zFVKt6FY9Rgh_+8CmCO;biH;1!AN9^b+EIza8T1?wStHN2njlcdh0aNZn{#;~j;w7F zO!mgH7|=$*72a_I(;=-5B%xotlOs6YcqRC44@t+Y1W8&@A)?OsSE3aSAt)s}K9$p0 zv$*gCgNqTHg1QFt9s+c`bA0ucs{Yyb5`(WFM0xzP!gVZt3NXxU)!}@JN{^T2bx&?) z{aCm5J#icWZ)$yu67xh9&q<%Gq5Aq^V&oKtP|jBm-z5V)DJN(eCMe1Dn%$<RH(R~1 z@a&s!>?5I)8v)h^>oU|dJ-Eh0Lv7m*p}&c$=`4=>jgbh833ziQOuzaLrnMLNNRd~a zn9x3G+ZPMTv!&m)K!@8g`i>oxxF)obhoNLnE^O;A)B1(47y4axd}f#!-L*O-4Va#D zmarpEv9;Va&JolDl>s5IW_GJt9ATLVrIjK&SzjiR5mXD)Cqvtkwi#M}r$_%F&*LU! z`}RQCNz;cn9V(gl&PEuTB@|*fg#=q~XucoKABp)Hqh(|EMJIkYqwbuEN?Ak6EHveV zHQmuuNTS6a`?CfeqxTS+w-hyjK>JT-7|S+Xx1Ja$S3(N2fa|_Y)_UH!5+zoK!HBKn z>wu%!Ss$w-rL70|r@!vd(?3|piV5tH$KZZ65Q1QsS&aSg#ig$A=;BG(T8$|y=ZOlk z8;dEVD6BEc@->+ZiG<jP4zY*D{zPwm9tLu5{o9qihq*WYfb4nx0nxXp=TR)0n;50& zbxB=k4pE32a`+~_0F{I`@x#sIOJ*)Rkg_mlN2bV#sNlG|r{W=EV6V>O04Ej(n8vFn zcgbCrg$_kXHZY#bf7|Nid(qQ{TMWD(vJvZN=T*-4`PwwrT7GL57K&+R4qtXLUd=4# zFq;e+xDjGE!(2^GMMdBUE5TFZ?3HD0TbXPah2U@%q&m*z<P2D^J}(U8AsKYYA&(fa zPD<kTaZ(RL?vFzqKocccuY6emgx9^J77h&KL%5O#Je(oQgmr7!Y3y!ft;-Hd#-JIK zSxY4pF|3_u?rlxW4^%P1uBAiig8!B<EU~6F#Es#DfWV?~2{GCi)S*mwb0#v43(U}9 z%iI27MuwZFH|O*0(wiVjqU%X6f>L|N^Wcec!v#1j(-H%%)nvcou7Eg;huJnZDUf7d zaMk9BLA}MeP#VzlbXqy(A#%J`$S0nXPK=%5pl_R~8bfUJQN=A{*^gVX$=D2EmKmIi zLMMFzHTsV0|G{`N$gmp!{8bs=bJ`Y{C&!r>>RBquT6Yz|mEIr{#-O1NAGM%;_|iO; zuT0b96Cxj~ST#N1XmsfIq=jS&5!6F=B$QKon(h~wdE~X-s!7b6xgo%4TOk!v)ajW^ zLU5dZUC3-ZZTMqOQj{>=N}wmuh+@UOgp6tH2H;S?O$RumM<3G5@CX0;aLf-(y5q3$ zr!!j_-LhgJ$MR)XL&^K5f2HNa_6fL#vg6H}y3rCitX<enPNG6=;?e6r6@J>S=uzT0 zSQ+RDi$8M}yOQ;%f|%Hh4x)vgnZ7QU0B(3Z$i=7bpm;I7=#03L+&{}g)VEueDx8N9 zHcx2B1jgPeqN9hoCph!(#!9@?@rWm2CLly{+2wz#(UROSnkE*p&dUPpYBCJhMxtXz z&qspF4{(Q|9P|T0)VhMp0yz)iA*Nx_cp>Bh7j>7IaeDIQ=>6fNlv4_dFL1zc70N`J zHOd5>hsR$6$#YdRd#L#I*E-M0F-mvWaui^<68HpT0=YT-8{!!(PZQbPdp7%>L_if8 zj@fAj@*`CN+jBtzAasnjQ(;;xz(%@zZ>Sy?-nbAAay%TaQ{w7k{jSQTwR$L&XE7Uo z)7Hu5x{8g%ZWe(SC})dQlogpnl7!ip!C(r)5N^L(jh*VPPX`rJz{uDT_1jwY1~V7e z#3GM5#bgr@&2owyGC(tNDC}bReeMBFGV$JmG?A0hW&%KHomAMcjmR#&RT<NjLa`F` zMS@CDN*^!K75`kXfX61=5pRgQPVr?>{);5xvH0`K0(Nvv@3ILXpP8VKpOzR6D6q7) z_7IFh-y=1^k>kTu1PTauFm`f;FlPstfo%1!FViVv$)}fPpy(=p-(EePf1>b#J&FXd z?CeoUYPzOw+d^f!M|#Vzcq!&%YMXWc+B;U-II@gR*xgY}i(&^DwAW7$%ecc-m7u$D zTWb*qP=mkAhcP#|z7y#~zqBD4*gA&dnIOH1;ErEZA}Wvx;+eYLYQzU_RiJdDF$`Ob z5p0c(&p6_?w7`}J^LUuiA3})Q0s^Sq*Dx5<LX}$D>u$tyHB&JXmzEARWeVK$F56d@ z6cI9RkH?d@Ht&PQ52S5U4QQT}Bc&;16h}rxIHPUkop!fqS|e-P?3cisgRMhTa?)6o zLl4~Mi`=zy=EpRm6T914iqQChA9&@AziObN6uDnKJh#SnzFU4)A3Z(b?MhY^H+5{U zt0!(ceZ_eeQlY-ZYbaOSkm5b^FW_i%riW-6o|4?2RbWX#ke3A^ZmFgfdI{qIi0~^b zK}4^b+vNA%T-B%n1<AlE;>-1Zf+1!;_V|2{rs-?+Ar7;oHr%f?Ze#beQjLR>?5|5W z7;w466wph%x~}<jSZArk>&MdX4pQ@4aFYFWXas+sw?$NJFv(||hA&d9TJ3Mn${k;( z5EG=MHH$QNjhD$VQCrRY`8{Y5r?b!b+@@*#Qyq*DGbSSwqtW<6v^E$NE<-_(*Kg_U zW3pkp{jrFiVZ<*F5+WxM*a|M$Tu?Xjb2o4RNk5Jm-48z#XhOJH4=RbccQNWm|NK2a zC<-lu49KryEOHisue*I;BO8Vq8EKh>Ilx3QL9W0tsaMEE&2X9|z1i8_I-^NbLxo^Y zjFF!e!xK@x*&VD!ClNGQBf{@tma5k>^Iq{hT9}85g{j6amq6*e)l!kknTzu+39O!> zlF3Z7d$mg=7O234Cof(RA~(H2-sD{Vao;vTGK`~??!CY6>?ehs<WC^kK-1lEuDX%5 z#CMlh;tuXTA3xFjSLIx&=Tg!P+cg0SLD3;Tx2l^#62QG;`HJdv@{crCWTT5?{uwzz zmH{)|!0-mw_3lK9Lnx*r;E~X$qeM(uCysWBNQuQhg^DI5zz&&xq)e8wf!j?`8>0|_ zj~9hv3rvphN#m#rJjXk-b;UrFGp8d~++$W&TpH!P{m{=KCd~!S)JD<`I*8n||2UK* zqTtds*K+NO<2^dqewO+)4_8sY^{M)yR<Yz^QlWfrJ})r;MZ`JgG>y8qyDyv;Ef28G zT{Cz;=K<DrVlk{3rRaZXA-!rbxR4~uiSAI4<m<l`X<`>wNjN4Z08jEeY!7|%#*&Lz z8oJ4($47BY4559*vnh72jmZ>I+Rl)hx}2N_L*g)WETOc?rZ@Gf(k+13j<nYBDZ2P^ zwk98DP<jaRUplz8bTai}2IPpKxFfl+5p3Gmn-@nFZ;BM|y42+heb2^2V|j`q32q|{ z&$+MYKTCD)G*a&IIB2B7!BR7)3`}n8rB{Xme>Td|ABAI?q(6SBi-qj$*VB+%d$8I` zUv9t+^!1u%P=N6niF>%LG(D8p)dLY!#5eT`jFejDOb(u*SM_BcopUYrSauHqgJ}^c zCL&3Q!J7D}Fmn-nnW)EhINYN?%+h-v;6KKy2sWi03RwmfsmO*DNhdD~+4d;4vpm4F zhwn;u_m1OOJIvyvGGV?(f_oR8dZKXL;z-V>@k$*^^3=17hy5yyr{`yvfqy@+#&fki zFpt+BHCZC!#NC&1zZXk?@KHy&8)e1E#c6UtqEdr?@t86&!@)+S3H}2DL~?qi73*M8 zF>6~<rSISoF@yL;BSl4~O^#2_OQPaISmfNn+9sGp@SJ6LHlv%T;@P@r@#1ArNU*XP z$q@-Tn#wa67SG$nRSn8nJ*bC&_l-#E{)k5mS~}7PS1MV^ofuA!i)dbg8?g5WWZ{}{ z=}2Zi37JNIKACI!N8M{lJ#82hNeE^(*^Rc$E7|%oY_UT&5zlkd0C@+skFmTGy$EE@ zI4G0-YHEGL-nhdMc61!@oT>2Fwr3nNMsQIggqB(J2PU}@D>a&Ny!grN0XLtn8X$dd zFrpq{#z>*fz_B&_`L&;;V`hp6r%z}p*j8V?XnwJ5HC9YDLYxf_x>fyN#koaej3dI4 z$lzM{aTKjQ8J@zn&Eak{`PNdS8ih49D_rw4ctJ0&!Esx;hM@9>)ttgSjy?zK=+#~Q z)~McxVs~VZ8JXF(hVLAk05HWw4%c=NJ(#T9yFFBBp0TE-+zZnl`abC=i)8L*d^vO& zd$9QGMR%~ByH`U~zJN#PMF-gD6>nz+*LBm+L-y)FdX`@K9c$rmv&9{2LKDyJ|D;Kp z1;YbKA+T7ya3!{I(?Ty)0JdmIl2;-7T5D2_hfYK6iczCYF0LG1l}GNT@0P>`&vLY{ zKUJ$38;6JQ$MZyYJ>FCqsy7%@XoDM!)OQ)1M!}E`8mm_&ersL!LK<H}lkCq;f)W`( zv*`0?R2%Fc9~j7%xU=0=(FeIf;Fe5)_b_?YB%|n;W|@ba==5zGzS4bFpLjA}@h}45 z2~ss<)lb^PMX<~|v;tz|L$bIH=kLq+fkt0g2T%v?sO;8P+_Y$ndALqh(r=G$?d?P4 zg2RwbD4T8W%)vH)=qkw~`GJZh*Ygbai^PxGWW?&fXdk6GSglpGcIYkw(y#Ao#Y296 zFURT|*#a)B7`*@n#>O-J<;*TGs=D6BHuvYhyz?AKGOg+{H!dUg*AP(>Y4$RI&@qU+ z?T)mizArNHSepX5VGdXDZT0f${i@VGLxWyaU!Du!&WX~W{0~lcC&;o7HEr*pKz@O) z)v@l95$|3gIb%Sb;u5xn;|Frz968J*@JoN0t7~nWflES2*s{1vM}w^Hejs29&{0r6 z)+_y}u0#wQlDcyWl+=Xa3TxEFfw`LVtyEcBTG-%>`MI?pn})S5w~R~LuFG-`pRfgW z)ap>;+BDS+;(3k(Pc{x#-h%3smDlB^7M?;-X;znFrxe=$p?-nkqt3<f3&Ws8r`Lge zGCVCRuewzIl@39t9p(8B$_1<b*RoE`CZ>4mxChqDMe!NKjX|VMC>IjWZ%dVdS$%E9 z6wJlAlkY|Blqrv9hP@vqb3wVh`_1mAXpE1o+!#+D#Tp@RMKQLXQScZEg9MJ@$raXy zjDQt*eT}Se`|cm!^u*|KPZPie7Yu&hc-Lh{DS{PFBhU$!=f%%N6;s_~2O(@b#U`+H zthg&SJr1YOu@*Z!RCF=~qcl$AscSSdam1fKUK8X=s6iH6EJ%sAFU!<Y5u~kp)<>eE zNe4+=^oh0nPA~}Bl7VQE?Ct>dIT_az1OsHsM&tga$CYIyes708>Lu@!-z~-`O<}17 z@;H{e!BUCxOy;eGF;?cMsJnft$e8ezNPCQcU;L^F{DAPJV=ylHosAWHE8v<tmUKyH zq8z9R+4g7U45ct{B?;Pa4~-01EyS~nGTtvTg0`(u6lJAsF72fQ?wUkQ$!L1aC}uR< zyv~mHzpE&IzFlIP#26?ZJ}to?lV%S_u%U*Ag@UbZ0(E4Tu~=2Q&A7rhMeyU@%68<{ z(FfDJ0W5Fy#D*_l1(0~}kfwa8h%8AygVr%QOf$7I#X3foIrlswey#X`iQn-J<;t?_ zF;~vEe+==~r%Q8)llXfvfquL#f2AMosc3Ggsd3?7#dw%LeWGxdi%lm}psXQZ7qP$i zI=Ojk)82Al_(b9TY4-f;L0s)2RBdms#rlRODEe|Ho&Mbos&Cokyry;L7w{94hloqa zApZt(o~&Nefv!iP$l+7A?$@M)HPO{gFnle2Ec}DrK-kil%0l+s!Uj@=8~MmU^NTqr zP?$9AlKJ<sVA}E{=@h#Gvuzo!af0j#8{u#aW#R762g!D`XXtC`7xcdt*Y|dL3bpgd z`9gtGGkJaFCrYIcFQoU>{~Z22wcrm}V$si&`3FnC)OEreg&&yp{qQwbPaW|mZSd)| zLyz(qlK~3;nJM+NI?mr|R6#*dKLa#WjBZdI1FlI}gg-+xW)186cK?|qRfzN_izoRj z*SGN}#bx^XafWYu#Dd<>uVD*mHUHUCA1%H$c-oxOY%_oT&qjC1Qf}0AD)7DQ|InKG zBST8Gcy%nO|3%*4l1<<Pn{wOr|E+1hFv<1mqyIZ|&2^jSspqNlVTz$lA9_2(!`$EP zHlQ87a7eY+hFmce-J+`V_*|^K8SAYvLAen-E|?}qoW)y{a)AE4>;c~Tp|2MME0pk( z>?yvuvPYjhDu7ZG_Z^*peO?mFDN_NUBn_BG^pv%EaYR;O78R~Beka`9qZ?+Z^h%E1 zbZJV2KGGk+%wP}5O~F7?pLhmi+RD(hX%$S&0y}Mx|7z<r?7nvooG38_M}=fzF>&9M z)H|nZ3V;tT;AvjgZhtNf3<AZCiYRFI?41?ZSr1;(!wb?}y1<nTTVc0Dv3NKGx+wvO zlGrNwLvjQoWOPl)2ZP~;R3>>#hXN@I)I0+%deR3Gys@I_XP<6Z4bk!)b^CS`EWgBW zZ%(f;bYR=j&F(tg=ysJLX;kJf(SY88>ECcN>?6wRw@pV*`xj$tlvjzN5UFo}^_++i zY2=`L{47rKEMf4TY%;0v3?CSboo!1T`ps}QZ=c_;{q7G)!|ROh5G2}OL_v*CGb+qr z)E^LY#+hO&e?>hkefeQ=T#?q3+}x>qj)_8H1m1aU!tq`c{XF@U=!Q&3Q#8$)kvqA) zctRs-U<VBwQp^5!sc+7U+v)#b-mX~?ux4jq&M**Fbtdh1zo+_sV=-(Um8dJ-k-$CA z?6HTBqS2KMew%*h+i73l{Rel{CQ`B$^~}<cy)H-d@_sxn^oTcvz?@v=?JIMOV}{=o zkLZSN(A-xoBv3Uittlwi)tYn%mY4e7QoTDxJpB%Nv5c;>nx^zR&D+8m;}K4%F7d7@ zf};>*;p^|$DUJD!C+ITX9sA($`C8d>lwlV8X3Pb<8kG=|p%DOQ=SkTQ`PnlnN$dI? z%-kB!;Q*brDg?we?r=dg9(dH0`&y8E!;{5(*yqqJ<A!)P-ItQifvpxAw+`FAw=}Ii z&9kyL$r;*jQQ^nS+!CFFn0{*Gfv_8$_pyYkx9TJ=8uClG@y1|k)N~$9N^sGj9;g0H zaFTVl*=-B9r7AB0SfFAhGY08VtFfJ{V+Q`n@g3y%hRLEbT#aAL#yt<h#eX&BBS04! zu;FfI86+-!4{M*E{Q+NLKohh}?q82<AREm^uZZxXk)J*7xO?5FVIl_phPJ=E!cF(R zqG<`W<c^a<Tt8CI{q~2AnB+NT%PQ?fV@;3=<~__AT_s>G+AYIPQ$L)9gx|dqeZd<N zDSyN2R+CCvBpwne=M3FhANI+;CWYSh5epLIgx3I+0<p0@*}4I~qP>Z;uHiGy=REvU z`S+V5*&gv2J*|=((Q5M(P~CeLwD27tvJk^{bl&Hpp-9Mw##^RBc?}cETo~8|PMl`E z4Fy+vJCd&R5D&R;#&CoMhMS9;0(4NlAQ-lBuRGVpC1K*Vsx;L#6CG70dg^trrK&K< zVtvFj{us67UxLA7DEot_*=kIgBqy~Rh*FpWfkS<9;0ko`BqCkk0s0?2MCIV4X}OEp z45yjrH1Rrc?XxjD&h-7%*z-6wNh9qstQs+R@}ZY%gL(=snc=G)HI+&N{P=c;<Tiad zZrPp4St9lW-suvPB^dOHKOoxAq2LBHb$=!A{A-JV8E9enzt^}*kN)5N(_UeaH1(oQ z8@;B_{@4`)?qJR0FF^(sI}4nr@1&x)x7u4^nVQ}E;yCVzINb350TH7YqjzUCR%Wy< zn!`H_H=oP<x-YZ&^M?ej4y(@3k9DU7`x;c%gzO)6$WRz@DJohg(=!C*3Puh!zqvab zLKZcS!$mNVVm|hK3oKq6a~~!ir@l4cUH5UZHECYmu&i}RIP@w~b$cT(e>5^_KDSwH z)7ryYI)H(P$#`Yb0wj-WH++UcR8Bvjd<)cLRGhh@qFjOw(K267IW^_pzJM!a4sMj2 zOia+Me(Pb)YOwxbggIrS^@E0%l77M$ksg;KntHWmd6Otdx6$F{<dZ))qaSj~B4=x< z*eqO914Pm*+vZP^&;T7$+UC-&&Rx?KxH41lkm6%)XLP4<>N(|+uLI2mB>WJc1;`M* z^fk48+p1=C?dJ>*)tcTS?S{{Bkl+gDgdPdf#=-QtB_G>t4Wn4qowk?0GNfpjH%2); zR$ykp*r#WJ)`@70_dk!B$dT6{&c6|S?*jK5y)-!Z&3x;X_6!f{8TJ-*@zOI=g}*59 zej7NumGl{X{+6@xp?K*>83JuxesvYt*M%zZ2Sn=`AJLQgE%)$4$>|RWb(>$(M$dmr z5*YulBO@dkFS^gaL1gCwzn}9v1R@B_Ekxi(%3l)_LnH1{0k$|5zS4I%y;4@wA8Q#l z7Ecn=cQ`ZH;}w_O2zhX7NgY8R36YEp4^)7=bF#^_;|4>t1cM6`5D9#-30n+=RerFN zjnoUEVB82$t&I~kuB4w2k1*gZg-nAoqr@H5GLQ@Te*2SNwE%$x%sDhNI%e=ph@>Ix zx0KVhi%G=S{#mDu=&&LjOUdR7PdJV>-a%U$yH+4zs&jl3ZdOaB;&(>4UY*us&oc^p zIh<4<N|tFXW(y-R;3i1rwN*)P`}WHuqs+A@%u0@|$n5vP+q1JL;trrDL!ba4tmxwD z1ww$@egFXBS@*uBlM5T5t5_tAA>`)@)!5opbGQuDIPxZ17>c_?W3+X<c5>3yL(;Ms z6b)tGOEnmgoch6NOs+@_qTUQ&${;xZL+6bwCf(fVrsZL`*qPV^4z>n64v|(<#n!CA z-k&@sZB$oiCEN0e(G4$-0=3m6$n(@|@DX)&!hXrH;Z|-Fkq}Up`jw=WQG8guWRyYX zJH3mNwpZ8`$cjIYd-BvZH>$f(5Sos*|G}(Zc#~SV`2yV3YN|U!@eeLBUOmxq$6mu& zvkB1}xE7?(DAav<kM{$F$sJ27E0Fc%x$9z4=J%zA<m-V)SyU@jsazj^jJ-E}M_>+1 zBz<~GU&9wO0t!KG+)}*E#4*^4YKiKrtQgK?%BjhAXFM}qvX-A;vVq<WS%?*vU536V zY&zOZJn1(>IGLA*Ycz@R^&sap2&<eMvhX0Yqc_U(_?;rC`LKk@osgy1B!LqNBRXqH z??L7&m=7=&a0wZl%nNVRrn#d6iCz?sGQW~msedZ{S5lU&JAg$9>Ah}*hJ>sUR}(O$ z_4*$y(mZuNtxOSf!d6v!sMBAYlNXoB_99=l6{bN9Va`~|>H#EpwbXlH4yo3a*}V&x z&_prPdIyw<Py}h!vMV!2t_Gq}b^>C1@E+B6D`hN>OrBb$_;MOnuG;^Dxwnq0t5^Pq z5AIsr-Cc_ncPU=n-L+8M-QC^Y-5rX%w79z#iuHFYkKB8|>;3zMtT35;W+s!p*I}Pz z_N1|#<3q-jfX!mBikJx*fcnncykh$}uokcqS!g`>%<bSTab490892Cs`cfdV(1Kvm z;5WRSIp0vf02_V>Bm22eh7~QZci0sifB@DHu7%sB;B$0y^VFKTAC87Aj9v}e@=if= zs0M80;63=q#8H~)gnll=2of48R}ZID>>N3i)eGh&l?;49jW%9{`ZRhve_E(4yi9e$ zoCHM;P1RJWX4O_*lyKY?hRG_8{X!Kp=0k(ahuCb@n1B+i0bQ=@-fHb3c|=_iP@~SX zC^TRSLlFNE5ThAS)&3)<Aahm1rL8p3uhZMQn#<N$jGW|!3!Ou=37A{22i860(1+Oo z79V!?HHU=ez1KpO&Y{b&dxO~zn#;Cq5bcG->wT6a;4ZEE?<L<+5n+Bz7CWs}8&GS- z3AADJVB|kLrUD;2(xbYQyi8~yb+(uRJep-hvO?4dyA*D6nx15IA&h$=e+_YXPjUZB zG?1l4ukr)n6KZ#+252^vCi-55?~6VO+?bgzPGWL}xjU1GjY5m9(4{HdxaFR&sNWN5 z%A`%K0#y&2IG!C>Vew7el_~`_on~6YM3?1Bs2Vgl(cWA^-}?awEc3J4K$r3zKMGgv z&tGU;1tXH**U9aKI*J=q8_-qr*#iwc3c+)PqP|<>5eRRWEBGAM#x@{0uYAPLaZ>d( zyZ}b@Rz!uCT}fjuYS8A+-mO@n_N6vW@<uuaA!Bt%TbWj?IQPCzIfyQDF?(BtxK3^5 z=$y1kg{r_yR9x3d-Sp`pdt^qV1GQE)t@k5)cVoB$kI5$@k8KdWl~tm?IP}O(kD8kY zqC?D$cg61&#$D+w{g+Sq33T8JnL_-66DufD9pLs;^t29xVrIL+DyZ1h&&zar#_K;E z$3WBRJEw6I=Z)_hdzb8H%qoo`PP8WN<y;7ee7b=%nEYCx34ev=;oLZlXR(^oO#rWt z80MJEa;k4_6*ha-(Oe#8GnT8#R5gnzC|X`!L3mB0;gf3l?tOy~ebg)XvH!KN-kN4F zkpSU$sX~MV?Gt?UpjIzC^$6sz)ti1M)Ca867SYrbpYf~G!St-0c=<Qj-}(tdh%(4> zBT=W<`AwJ6pwCiZC`Q)#c@+@^j@&JDKPtg=61bs04m`<*LBY`%qi7moA@x8Dh?w{b z6cN-;&h+^giasuCb}k)$h`URHrLmvFOj`&6Q@M5oFsf=ayVGhjCnrkBCEB7C?z?rH z!4G_TSSmvjAI<M1U%Cr6lyQ&hG$!=H23@4x^7A!g-sgTpI4Iv0;rWGik)(N#3`%@} zIYQ$zQ<&Usy~MZu^}1-*66@Uu6DYq$pZfJRMk{-UG9;=cCClTv%8C`+307D+dtYN8 z3>=o)_pF-Rz_fD6N6jcp_86zDc-|*j^#aA_N<D8Z>T=sFz$$3ht;0&xI4E|9(`Xd; zWc{G+Q!=M%a6A3*B-$iYoL!62?eB%rF=89r78?^0aztrmGL8q=56Ip7^op4uGDU~z zCJnWd>S629#IYhLqVQq$z-T)^m9RQp7|Qrxt24FBVXchd%VM4emxfz+v$F{}5057k zRfpwjQz;c_QuMVe?5M*(0z-|oD){`FnbdqD5o_QBZ3c79)Ml4cI;*E;ML+B(?h(G9 zj!f$f<eFSI3s_T9FCyn*Q!tF&<7y?s{VIy0GesJT0dp)Bgve5hDQF&UC-QZ{S4w+z zkKGBdP(n0Uv0CP~yfE>`kYwbzrwxAjb5R7Lm)@8o&V_%9U|>-Y`Q21F2CmMTc>!!e zPHj*npROUBSiNqJfVYoO2F?rSg-1(afVR-2hV5*Nn6|@Ez!~~s7N$(y@Ssq2EFS%E zZpku}l;>ez&cYLEpp0#YU&fXKG+Gbt)ZE)$^wa`OiSAX(rhAM1GP;d|4L+=>_2V}N z=>3^$fmA^&G@$ye+SLOC{PJ&H?bTb>V@7;SM-wYH#E8f1@NRa4Qj=&7zMyD0N6t}) z9KuU~5)E)1Bev72-+L0_fH=zv54kdDWa3w~des$w+5l*Zsh>`L=dI-S!tP!THB&39 zQL2B})&Z8|<qhj<@n&B%Of^D1MoJ(kC@5}0BoDC{@lJW2{U#S-2t^I2wN=BwjP09~ z{yK!vwA#q6vc7{4H5cf1-LiHlGD%jX=o0DxI(xKR)$!)ZqC8HuMnClnlXZPnt^42- zVvb)(Q`}X>I0|dnjE9EKRjq24r5q=5rL8=KhGo)hQGfh=Q$*py)QG|AXf^vRU)eB6 z-TYA5T%q&~9Y`s?aOQnUSL%EA1&5Q8wgd&U_bxmo<!XB=*5p0rGZoA<UN~hqriScQ z8_JsgNBr)aI9B}})Cl+N(Q>{PSKh)@nJU<I=}RuVGu&mY#++3bi#W0<#j~&Xy>0aj z2+P8v<%79+2FfaZ4~CA98lVfie$SBgbjF|CW~3l|v*<{-U?E7iLWlD)d%Z|?s2XO~ zUMa$NGQQfrWPuZ$<i<5GG0cG<=v)RLWkAqRI&I7(Io>QrObOp^bY8N)Ajd2%WNp1f z+ckhZ9zH8_*5B~WrQDBXm2T;L3dQ3Of%&3UbW764I$x3-^yLh+>Wh!7FiaD+HWJZ9 z@32l#Xz<(8D~X}1c*%bMJzSjaZxJT)oZI%Etc2LcF2?NnND`X_7KJNOc&#V6DH{)2 zzSg37br{Je(0kWdA#0*X^^3ZNaR~nDqbiMJPL4_Fbw|{6;>z^YQDfsrARMhAg`CD5 zF10~9%}aaX3Ql^L+Du)>f>x$;M?V1WTjx|MrNMon;Lrk^3pbICrw(n*jm%bB3Xo%! z8v6v^5mu;|P6_1T4fcr>=tu8amLQ3kbu}uv3^)a)Fe)8cQtk-ELMvs`IwASxsWsi= zR@72AclCT)@oA&+_$X+WQ@r&3g@XF8OW54vlJ^ulVN;LrP%qh5?eX5+UepsC!1G9t zGmfEQOi5oNNHd*W`>f$VpDFq8dEG|}L$1ryFj7Xv-`TQ4DMi-^1rB=?_>MxpvN8jc z+N+CsBPBnrBTZ77?DhI{ZdxZe;C7L-f4G)H#U}yHh|N;j^bi4obz0`K3~Tod#WGMh znXzoUt%h3wt(~5RuTpF9xq6`&>>e`c7;Z!`vZb%CSp4j>3gX6dhA&MX9=6CdDoyW2 zzXH+Z{iSEi90en%t|<r%(&_pKASYSUXx6IH6PXt~7N7ympYoJp#x}xztHS_>DP`SB zU0gZ%WNO2)My`N~Qg#j{$U)0U$+X|YQnG7Z_+3OH1tqYFp|qAsSC^?v<&#IQnMZQ` z+XsoeuyQX8UZI=ksr5_QzK=7BYB0fI9Zlp*L&r<9DU`s?2iJ4xv{XTEJ<;G&x&1rv zT_}s_p0j8Wxq^B#6{qkV$icgH+#B_U=rT|R_hHFM@&&UB-fK(dNs1X~4jXkh>FKh4 zVYS=EVzSH72UDGRmJ&W*{!;_XXl%WzMs$}W-a(TQ*-qydk^Io6%H^OBT1Q~qy^3KJ zlTOk1iO`31)^rr>puHZL3yVr=;2+=-(7L%^DE75YFN1Ix+G+dM_csy@2ou=0%`!ba zWi-7kZjnKv)1THkjZd?`amyMFY>>*=kEb@7e~7OiJ7?@Ww<mUVHaM?6LVk;><X-8L zy~MKjcI4)AI;?#Do9Cx8w(m~*2}jkFU!LE2U%0LU&xVYCf~Xo>8TEt(uH35+($3tm zvMBi13S|>BsO_J9e$7QG2J2tH4QZE4aDa{NoHwgg`rfl9P5!C8=aR{a4V0kN`^${0 zL!zX-fXhdkPxP;|!4`dx{zb(s>j=?bn6nJ}dNVnSs-_K90-+Ws@P%j!Xnk<Xa(Fje z9Seo0okPD)763EKmzn#fyoh1W>aMb>fqZNLy@7tD)S|<6lMGf}d|LHgARf*k2A#br zAP>=s+NRut?EIX@PA7eI1MA?)O$WTXwxcf>c!qnJg8DQU^BxOsOBF~b(Gnc%78V28 zF_zCQalz#6D-V)2B|07uYk{7R;xL<P#go-oP#IjGO_JuVT}Sk1(=!#5MBq}It}LyK zbKnjkFD5l}%u8?a(osLFz`sTRo*;Tbde!r}*0@fww6rf*vvrcB+XvoKH@Hk?psTX9 zY^3J9HHh>Fz^bpNG<0tk9M93U4Fs$X%VHSp&L>Z)5q)lKcJE_qT~I)cesrH9_}4p> zAv%6)0|I<QbKu({*uJRslVLaux$a|%Es-jk6~&L=i!Qcqt7iq^J&`V4Z#cRc@c?PV z1V&2{dao7Zych3bsq3#1v{c?nHZS1h>*fQmY4m*u{g%5ntw#hOFPrF9!xz63r@UF0 zu<nNgpJpQ2Y$JBDTH1rWfp^WoPy2o}<p8!c^tFT>_EW<xFn!Pu4&BClGE(N>EBAbu zZ@W9UX;2E*A*4Pjt*qeTOuoH8Jp?rAes9o!v|WFIrX(Ten&I5`UZ%Sd+~qg*O^N2` z>!^Wz7k}RcAgW6&d8Y3hi}LB@uN+F*2Q%1od7^{A3#oiWQwuzJ<X^vX(9@qgup5v& zZ4D_@8{{PP^8yBNY@F8IF<Vc~T6yV;KCQDYsrIV~=A`UL!bwX{CvDz6(fxdWDDtWU z3{QLAuj<Pocxiqz$(h^F8(`$0dbwy2o*+y%(Wc14?GBz?e(rL)@XW)Bj>Fit$n?T> zu)Ikw@q_o6T7Qz^qMjPMKz@B!vS@yzV1Svu_j<poCte}?zQ4>)AfJ$OexP{&h;Dd~ zF#c)7!Z%~^)8(Q<vTllag<|o~kM}b>LDo$~{{!rhBj8j#?E;kWUl=buzrjeE7CydT zf4W6I$OZcN0{{prnLF%ue}+WgeZ=SIzofFsj?S$3pd~o-3WcCh{TVK!hK+D@dLeC~ zIs)@OI0E4o(;YK)@g_zzI7sn>5u)PUJ3!h#gm;uMaO(#ixH|+2_?g2C`D;U*Xw#ZP z(;9u#n)R>R21q;u=_hNBjp<*TNdKz9|3&`?2~tjK0FD`BjOO!;4JtqeD)5W?U7<?B z=#hvXHa!2uiva<|Ns|44lo$zs8h{8HK=fO}N8mqALxdtC(~7<dK_d468py|RhFX07 zQvLHUw4R<%+5{F{A_SI64(c);isHX}|C0v!pJB-1{cB+0|Dt~(C0>&x+5MD$(?+QO z?FD&DDA@+|?Qf}=|L!GAhWnQ}!GF=ek=z6SG6()I`Y)th7mjDbZ$9e(D36omu$aSR z`NjWV(?6vUyyA52evAKiE!~x1_VXUF(KCvZ{9n_kII26?DCQL**kzJrsQ+UcDf!}; zLdwp3vi~(5EA$!12Y9G35#VDF0OBuS{!xM*hs-+-%)clC0M`Sc{rAX#IKh-7JroHa zfG_}{_>b5hMKOaTzb`2xA^_xnduP($2lttm%<A*+#{KV%i&gjsJ+&hVpLNmwUv4uw zNH|hatU`AHC*}Wen?#Zn07J$m34<#6f4B`436U(1ZaMAMNT~Z?)BiEl|DAENI0@c3 z$$&WF-TyKT3iH$PwC@x(D)5su(6j$(+V9uJi*nrc>%s5>-4huF&fZV_p8}Kx7K$%% zx_@#0eX)UEKbyrY61Q=1dePslumA0}#4iyLU`?@z6J2&ciT0nSf0+P^|APIl|84pg z2NhUjGW+q9c}}vTzW-0~Pi<HZ61(77kKnzq?e26x!9NSpADx0^PQN)YKb`vfKKly> z9-B*+CAS*~^9%o%X}>>8$WR5q<EUh=yf8MD^nh;0{B|6u>K7nJl6+P|7!A7Lc?Pfw z^!m3r$j{!Nh6Ks1>;EACaDLAQu<NG=a5-z@Y>_1lEqbLZAQ=3Y&R_M<UNYo26lT6q zhw@x8{>nfwDo`g3;3wvnl^Ag%l+K^9-v#+6@ymtZCIs<Np`T*}lYB%|0YJgO?f$`o z8vscAq=sCEV{yX&DEwO$kU%*CoR0o-;U^ya?=I9|;xR&3%%Okm0=s@Q{~-j~tm}4x z&EMtcJiz><|C&<p$m@c?dw=@!+nrw+ARkp^;Gf=~rh$d*uNpWcimso{KLzz)WBbVz zBt0Abr#D8D2=zBo;x`jK#{8e&-**321tk7}e~bLq{73Mo)K5qLRepjcz<<`i%P%kf z(7(YF;Qw+Q{O_)xgdpITNB=NU|JL)900+($kmK`<2_*j8^zTvqZSim77aj=yJ=K5d z{KrZh5bziHZ=HX^fOdbH{#E}&{0;lf{~HYY%huo8e)s+ZhWRgTznXuU{>#MwHQ~S2 z{;L1FVScOnFEAPMzmPzM|Cs*8|1-S5G5<FGZ~6}a{O=(FiT~0J<e>ho=MTXTjGUoI z0iGBP2K)gB9xx0%Js6no1_kgda>m{_7CE<;NWS+{Z-!~>O5k57)*xd@+_Ryg-CN#O zGH}-?OC?GbDwZl2x|GfzJ9B5s6(~4<&jm*ZQpHN8vvDrs9>4j()?Y*cSw1Am-|Zx8 zDVKj*#j<^Kc(Olb|3a6}9}2$t-BijJAo6(<tG(Ud=&8PpMs)uGEu5v1Q3Wy1kg;7Y z!&_^!wv<$iAbEBn!AZC=0T)sJZA!yWOKD)!5oaFC7khg6;wewi;Ju>_l?03N{cw{R zOryA8C0_NczaVd>`JuKra&V^ztAq>tg{G6KwPi{9UhU4kut+LTYCfn<R)F}uOoZP6 z_Q9aK4CdE3FVqx#&{y7RfhF0lZ_r|p!lq$<Dt%+-Jo9ClUrvXp2Q0?T*+1QK)N+2i zIkB*RBA@}^{BZry$fYU-y)r7N9plI0REZF$$mysBu|Mw*y5gw0hPk+0r6Jw69jD|> z;v5DIJ;2LV)I-FiGNL~xr7xu($QG~B?aD(=CL0rOE#nj6%?v_@P7UMw{tffx3k6Ea zM`o{N-WT!#1H%raKDXqQIbJ#5{#&0oSW!^IXYys%thJ}dWGMJ2s;B5_t%!hcG2h?U zJtYs4N#{1nWwH;Y6q_WmdIBFv*djp!$3s{#0+K^MACV3vTYG0}?}*@wCi@WuJS%}q zQ2YRN{QzVHs?mRWX?p2wdjvGev|)kFLzy>88H6eH4!xoN^x-XZy;}&q5fZ}ZUgpq- zfq9KOl!-#tf*3J!8)aP5YPFuDE-<#jTxgew_HEY=k!eO(;ds^psWs-0_3ho<(Lr=s zzC-bwgc$BhoOGEIoi5ELz8LU`6?N;1)8Z`Ke%FiuTh@42TPe;@vm$MM+?g+cfjr25 z7v*3CRw-=oJGByL`*hh-l<E68u=y0HAwD!><EY5?-QbW?;aIHj9)-`0Pa<e*ok~wQ z$bHC@vue(vw?uonSN1lGrJ^jVPGlO4WYSzlK4FP*LH5v5t7XJ35*InotJD$5YF1U1 zRcl4L>R&f9#rrX&TAIikVgjO*qz@L>3Tg^T-^wM|nF`rr4#8NkTC=94WND8$PiWgm zuF;?6I9OM&pl7DDj~~BK@1Av3za6ShlaA)}Xubsmsb$R((sRlx;7g{sbloWKM#E{Y zY*$_qMsn+7-O|aLx*up<D0j5CcTB_SOV2L_7w9dQukCo5ewvWl7ZX<>n6v=E0Y1SX zC0DG+`HtZA`Z?msYMF$*<=?!Y%3)H^MSl>tU8-cSXPs=mP>k})j3ZzxrxSH=eYrY9 z)Nq9$)4-%}bS@+n{Qh}iV-_Px@w&$YM1iUmtb~bYm{rQf5Ex(Sn%A?La$bJkmFxiE zgM9DS&T|mD&a73TSytUP`?(*9Y-)1Bh)sBNxYpz519l!F(gWX(&_q3+%(!(j?jjOu zm(9~7alA{bF3m#xh+tt3X#td4r!-iM+@zG-<-1;lzzmV>Ni-NscKG*~cc2<aZcA+i z6Q93mut3d9N2GAaed6m`4BM&YMTL@AUo;KVV<U|8mUTBvTX%)=tZ+#1AyT$Rzz_JC z8~m2!tEqO#aJv|m#LM%+4*<mYNRO>~_8<-QM^tP6rI+v?WbAi4XE+Z?ew_=Z)y}tl z(jUgaE|o_UXBdDBDozrXiV|(&a+!K*7|2^nb>b5D=9KsMt4RjX03L9Hjh>f$wW#4< zIm(P_{lV@w#Sae-FbG(I1-NX5{DVHJJty^3h>w=$BJ%r@fSk^v5Nk8^WdY69Zv|31 z2jRmLB&Mb3<{LM%=lP~WF1q+eM6mZFn**PK(Pql%%Wv?`_`A%-hV;76=UG&1De^b& zr!GU-28*8UY^#E{xy-^w-sC{KC&Hptn=yGA^cG`V`OaIon^ac!j@M*h6qbbdEBAX| zpZb5a(CCHouZC&zJSseoB43)28ce4z$H*KF%>&gCh@_jk?2KV~@PVR1qlPH0pS_4F z(b<XTL%zSft%0tbAvyNz9cb$oXV403I4<Dz=ObR4-ExnTxdq$k3nXh~;r@Eb-Uj&| znQB+*q71^K$MNCiWvhj8kl6}hO4ytm#;qN)+)y=yaj-*Ggy5AbHWt1qO^p)FppYaw z@umX&2Ot&AgFchYAXFXovt^-=9S5`mLQ8YnsPD!g56rai{1+!_ZvIcGeJS}tw>e3P zwZJ%^F3=O7c7tL!9WzA83l2~<s?kXRR8v)zwkHZ1gzUo7t`9HgVsU(E3m<gGIWd9W zSXd3!p#KYLC6r7JGWfFeV4uoYGirFIltd!|QUSk3k|l+7NF6e@ri?*N4~Ufz&2Mi@ zg?H%m>^6#};WnX?AH)4S*=UL43YG(EjwFiw;Alh0Mc`6ha!pF1dt-V9>Ef6}%o^(g z+64-+lI}lt3X;a;6rHfV#pY_18GMu761ZvNpHm)c&q*jw&jrYOOyi<n58RL4vaz?T z>`OD$7omJ%cq<|8xqhOwS*{*@_BemP_St8$$JV(9*3Uv-7@Oh3j)>VnGt3>mPRHF2 zAI%|O65hQ8Au^?FAt6rR%76@I8R;2Yk^*v{M1`;SXJ;AxL`c^BM_S_smtCCFy~8vn z0lc6k3?)p1o@vxf$k4KD79!-Q>Rm2R(jKxjV~iM9qfu->T8`ZXEhm&k^&0u3J)6n} zXHR72O3*lOU!gM+rbpvQuY4pJd%Dn4wPuRaVg-D%^yu7o0KLx%8Y8mt01~Bp-~3Px z*v=h(C$|!MI8FMj)%R~4^F6}g`@PblVN5N#)e?{{_KPb^<cm6{G#_-Dpquw+Y}4q5 z%2*4?Zmg7v6Sz~}O_Uytax|ECSzy^-Q*(pm^gFIE<v2rmpMR@}eEL+y;P1!$j<K2T z;24K1UXL<#_$&XXdMg_%Iv!Hom=n?G0Ook$>oxjxU+6WqV7Ayfq@`LZLb~E?f+^p| zoA9pYmdaQ;P7M=;I?ZJDX-?43r+93w2T=P)hh#MugN{n#wz}^WzS*JbD57pyGR(-N zir^S-q*vnNJJ@dvA?6YB(6}p@4JKvbGnL3UB#BwQ*|sHAO#yw-)?U11=+DXZ1_9su zY5=3IiK(fwW@zZF|21?u`F#f}deEqopQR=0Aq<rm0F;!36NN6+o~ptKX|yDbjMN^d zF8w1xinbqK+lrAKL7w19Atu_~4*=o`36nDuqB6~x)n`T-ictmxlnB6g=MO50HsxXf z*m3}-iWP{nnQ~sUWFe~%ou*#}mFJ?OndXfU$ie7gY;)n;^v^TtL-|BC;Lf1s_C}26 zZ8Or3*gQspZ;Y(wY*^F<av^5H^y!b8RBLre7_JpIBd|8WYo=ws!XlUh#s<j*gOKex z7K>0BsXqEH>Ptar5nWLcq_)1TUgtNMo6m(_aW*$`lLhAFF>^ZUKFg!<)whRUd|h1p zmJ`DwccFjG4vK+_x_!qhy0r_n@9T;No2d$Mw4ExBJh-7|5LC-!lAEry4@aQE6mOy& zSPLx<;wUD!3;-;{5rjnL3VP8+o^jyhx=F0b;|=Z|PwWWzN_sA<>4QCWQp`!w>CWK2 zKDjY^7>OJvQ|A-tI!Nct!c~>Av16<q+fKKK@%C||?wq8vjpfz5bUnA`U|52l0#4CJ z5^1T^gG_Lf($&e6SY?mQu!ERrM84(^TF$4`U7nU6>l3pWzKzVUn7*Q#82lpmR$@C< zCZ4sLmAB}o6I|_1BnFM!%&jZ$t8`02MZf<1F>`F{isb=GwMzSaXb_u8LT)*s#6ZV5 z5p@gGJ+4Ngq6RiT!}l~bw~%UMN)hLr5qi_Cxcfl?`w9QYkks38ql*9$*@607Y@R)N zFlQ?_lbD@!s5=x^!8na!eB(2qAat}nl%R8=GDgspW*12<BP+DuDILBaa7n*qA=@Hy zKKuLHu^M@iHijU*xqZh?RaQ)Gnmk<f^P?;?+EGg0=2o`xJMp<3n0utDyguCAz0gC; zLGUhHfa!Xh**mpY(3m#82hz-IK9We^r`Os;hz}CG(2`pnj%=VNW9@H<?n9%lBtXw) zzO=7XT%qNEg+3hRmZe7o=V&o(-Y(!9$m1sOFS@K}L%wn8Wv#gGn2lE*S^~b`r!G?$ zvHvXcu{?UfyJMIu?E>EUHMD4QTkMhO{kYE68(C7_o+62!-u4@)ekIcBkfFC{ih|_K z!E%h$LuRYVj!c|*VvDJ1^2%gdT7%k9-Y4#}`OI+em0QWyBqSAL@?PJVkhUeqTc!w4 z(oo2L03Zdw5KK(jmI~5B2$L#Ob`1C5kGzp6G4sL8dKa1$qIv9fRw)+R#ccfpP}J@Q zf>weDLyOmxMGf78*>LjpzL0o2Fg%`lk*=W<8oioRx3HrT%{WK*4eCw6W=XCUU|lqM zK!d%INr15i^-%V1h*3tis&;W*qUlD8=485+V{=eU<?Le}9FH);9yq$k*A}mOC1~~d zneTlx63HR=Au<jwB;8UFfCobcQyC3HOYNu6(wy(4z?j%c)RTJ>24vV!@W#G-`ACwR z7Rv#H6prAqiw;l4jg!|ipg<sJSfd(t_eq<+QbU-kWmbqWhbyY@O>wVRU<e`5qhQQZ z%OEB|r*zioauuX-L>ZcotA;<a9x#~0<4Bx-UJfHo`J7c{&Se)I|8|gqg1NK(<p5J@ zxAe<+V-Pd{nY;_JhbKJ?b7oW(EIaTO>ru+f?3C|R0ey}7>e<eiK7`%{bTQyeEiH?h zazbp>5SoHTD7dW-gY|u7%5%&h$MFOV4Ss-6FGuQd1xSz@cIOEwtt`&OY2nEj*1d__ z5jkT}4gND>nm&nowDQ^}YmgtpCOfup&*UkV>rQW~7#rl@n`Pa+u%p1l2^*!5Zs42j zAx5d6K-_#lu?y{kvaDBR7)K)O?daSer1Ce}ou6B&Z-j(I^EnoI*1fm{iP19<yMlY0 ziGx;QJ$;l5yG8$vS|zC%4p}Gn&5o20mpWrU`Q(7^N9s}aggr$*8Y*L6vXRU0C7@Cu z_$mD@>B_k)o%kY#4X#BtTwL=aZt8iHHKF}5h}+iksP|r=h(3xIa_=WLR+G_mqn}O` zouImuy9f;;h!WgGz)vmP(I|$DDb;0828o0Y+u1M9B-8?k%%te=1~77?m|okTT!G0Y zI9fx>aWLx3KBmFf3b3{@8vFo2-(rIrTo8T>oSmvcxlm^b`<$S%+?D`iZlGnWO3~M} zpDvwQhQ&hR89023IS9k$|H!RKMlE`Jcu@2(TM#U08f;PPQ{V!9kmr3S36>w_rWBjj zj=?^o3QvhQ%SGrQ-+lyh+hos7ilg;_Bhim|rf)lX*joWIJ0QLvYehO^KxrQK;lY-J zEOqrgg{@XdItQrYS}cLR7IKyW=GB>ek0cFF@X>w}TFjl4A9nrlAQA3ZkRGa*oV&CF zVr0g;{VHXnWX99V`(dpa4I9)=eK~sKg)j$AhV2?Rbw_7rF-UaxUOtMiWA-Z_;_~nd zI;BkE;@<kHS1@p9mISuKZ?zAMZkvs}I%(Cu!#EQ+l88y6<K`d}NLkEl&XUk4J1h8> zBg~|wL#{20+gX$c*<<ahDmPa|F)vw|fYVRvDH(miwsI-sqRP9u@)ReVRzqQYt*Z0` zfG}?soHI4`V3RMx2kGT?3e1mI>;KI{NxlE&{!uB{o-Q_(dPfTMv;wVTjw~xeJ{$u0 zY=fz{>aO;jRoL4nIjY*P%%|wZ2anhHja3x`Jd>Os-Hz?&S830?Ft*wa#)56LwMVaP zd)?D-A1<2BNkrm*04TbT(@DXCT##>!8;)Ah{n{A9CCgJBeZxTLW7*O%d06-J-~>2V zHZfmo6$FdkI1t;fR+_9V5_@=ENbMkdaa#(F1gfpXO~!js-N{`iF;d)$CEdW_uSC>J zny|kDAM>t1lP0|txHf5#$kZGidDdlTW)Qj6yOKwQ7RRImt}@K<Q8hI;u%@5nlR|*2 zmXGJ!E<E+X5LLQW(-7H|Ld~vch`>uTe99Fe|LmZuJllC8TEISKr3`JxEZgs77}laC zH8y{uxRKt`-l$KP1|yj!D9uh6*J?8<cL!#&66I2Az*dP%v%4Z1V)!(bMi0qw?|7iG z3}HRIL-<iXp~Y}!cczU3U^ZY6iwVh3)Kw5hZ-g~~Rc{_ShLXx`qS{OE0SQq@#@{zd zo%l3vm@iEiesr6T5-`@10-7i3H!G|0CZ&bBCEnCzI4srdE71fx@kj480;h&Fu7Hs~ zb;!Mv9uO2Vv60AFx=7Il*Rf2E^3qX)Fcj&Ky<+X`K|o<*{AYZ-YKbOu!OCew6dfnt z+38RadmP&ayest+R?A(7v#ta`_<?$}*Og%xDcD>hyES|nvNVqMz=_Qq3L%w4reRSk zV_yu`f`JRd`FSwjq|YF$!*4lD5b?w7nmT3MXJw3aSTKF)L@OL6kS(9AUrJM|A+19g zM<yC`*|$y-YF2k0O=hI~@`jS8&z%mZGyTCfPtZ-y$kI-NO{3d^>uMN)8b}|5_>@|4 zhB8dQQ;}66oR8mO@BIbXpy2^-<2^<lxCk=W#?a*1mvM??Lu@gz#4rjo$kC&9oOmJR zW3$t8`*J>^{c3mv-cw&x<}HMuhOz?CSqWk&4;qw1jiB4PIBPve7em2howJV%HPso( zCf2m<2TL0}DN|$d8$3(CtV*n>Xbh5;c%w+A_tZy{7`onfD94%kH<YiFuT~~y%{+e0 zNz`_MQ8*p?RAG?|%=Tj?e|NVOr*v~B#^VlOy_ZF*p{j!F)TMV&#Vm{mR@Hs5mex^T zipPp6duH8rK^jg$ys|!j47nk@yMp)wVBXn*fFyB9RGX-;GvK=OptX^fxsZ7N!Yr?| z4Av(11E3Ou$j|}b4Q|n3%gW?veg%G8jzEjMfnw7Le+m^t85F}O`6aZ;nfplbIFGA* zrZlQ*=mLU@xLh=<Xb0NM+)wq}k%unYN=52U)dJBnBbg?r?t?;ONihc0+l3c%WcxR3 z7#oe8s_<7!7R#b-8yFME@~4LR_08VxeYt2@bbPVa%(s0#sIJ6#5!`ZF!9kCQ!|mU^ z!bdxxw~*RA-W1aM(en{$@A6oSg7@vR^fjC8g(b`$f%zY}G!i$bJa*XoH?pQM^Wbzk z+gl$tl5(*lX>PN+S%{fZBzf7Ru?*CcIul=l;cON;U?Rps<X0TI>qLDWiIyb(&a+z3 zcio;FZz5hIBrKA!DsfIc|2jWH=OgPN?`Ek8&l0TIU7M6MS`+Yfe8a)&q7fOS%((%$ zYkqR?Xh;d5FeT6U!jcI08Z3&OOFVCK<6P5DN>LG_wgVnp07bZop~t%MfYKZGMHqw~ zR~?H8TS*i>wU|MV&Q@;|!03jdXUL$R;{uhgEFT*x;#T2Cee~X}l$9SW<_jpDFL}9m ziCC5KG#xhjlJ1rqb{$1_fHWxyRY)O1rTQVoxk%DJq!Gj|(tNCRzp<0F!J+6tZV$1F zvFdT<f=%^h|NCEG5*3=DiK)j!u1koW&z`%?LfBM5cCn8T8@UOIzvJG~eS9UDiA?K; zv2-5pBrj-v78rL(*gN%59&`A9CaK@we0eB(jFoq`5k1J@)X#(Q`ce|kzxLpfw^AYO zk2?d-ZFs}~3QR@tAM4jYm#=>=VE^~}^~|MS@75L5U+dRDPvJuT2=fgsNZ=#wHwdl< zcTW|?Z&f&3ze_QQBSAER-O{fz4F><->cd~H-@LzSdZS#Ki9fhsJWz!A)xCc+7!`=r zr!4;H{o4SLC|n8q!!0nn6)EU`>G%OS@bk*>2HmssNV&iVo~!MP6?3Il6BUZqb!Q`9 zTX0{!OzGGkG8?2J{pklFk&4OcCXOS+rLcSo2_k&P=t}9G5`xx7^L?#6Nc(1UClL<{ zQpD4C%*WUZ_KI;0d*0XmFe4RfT%%m?n)pwduDMOzr$=k+LDr~|S39=nt&06U<xgI% zUl$4i#<>d<FC}Ia*DV8?v(>E*R>GL)3Z(PVoSsK$W&;-$FX!_WAxcWw>*gSNDBMHy zLF6^glqLaUqQz=yb(z{X1W-HE3UMJPjQ*;?#Bs{!5+6f{)9CFIHarh|+YBc6aVCpe zw_Bxw3(Ss^u}S?!T^1LhBIa&edAMMO0>t_f=4=Asu^)LAAY>{RO7kWk7kUu-DAiWY z#ag&CaY#rc(=R#&Dh|GfQK8NgPxxg7NS}KGD$r^(*9S)DgNNs0$B|6*zj?By+2Pxd zn{azl<wy&N08et;vciOe(i&FlE_a%U_I-Gt*Q>900!IMx#Mn-iX+WXL+y0p|Z*Pb` zw6|fvz7b#8AB0S_%i3dnZI=2gj`#4r03>|CEHPwUMZ!*6e3IG*EsoZxCk4$=ZFtvx zS0-bGC=VybQP0SX;(d_atWnQ6t3{GEMC97`d>J@Bj!cT88iv|*p?MrUvH%p*cw1W8 z2a2fpiX|o5s0OonmGxc7#byq5DGvz|1JIcL8TT(v1=g-@By9&sIi&e%r!M}fMaD77 zLhGa=T*s{7$h@gvz%=X;a;}>-t^F0k^oDd#-6Rxp%nwQRG|od%mvMQvBlnTSkiW4t zw4Ebo_|7<SYXD#J?ZH6JC2xgpJQFLr)|{xM4561tle*nv-BhHhH**zupK@yzrQGVz z&zJ_4ZN)C2pMe<b$FK+veL`{mNQ#bMFR}`eWpERgqE+y<=M5GvYDP*Uspa4d`qEpA z$rj{RD)^Ix5?sT@$jZ*%@a^>PQ40_T&f!8Sd$U$x8S+LGu?7mGxKbYrYRE`M=q@<p zegKRhFB1n2U(5^+{AMzCyjlzC#Ow{8F>V#HD0l|G`w!|dvvx47eJlZ!Xpd)X-><G` zy+}7uo60wu<!BJg(D0$E5$vtmeVdCD6BQ-ySh4rDvS`2_SB!nt*AnnX0-N6NNjXi& zejxB3F-;kFfuipii(uYwT;e2tuPNo0=`xx6y}tUz(`Kz`A0j=5W0){QZj@b@H}~Qp ziB8JPx>i@5ackDo<-%YJ7-vkcXG0F0W|e)^P;ic*72p&$>v%Q_RH1K=Ba6h38{$i< z=eot#C?g$IkDCRjxNEjw7o(=Z-g1GgBkedo7N`$pPYlm8tCZq+`y6Atl`h&}<0uCP zmmN`s)Fuh@sH}@1Vep@8+qp?p1bqV7>rus2nXrCR@2cyv0BGR%vp&U5l%hEKw;5UZ zndlGw08E0Y@sXvx62SJ#py|FnT&khM;@}Z1Bu&efo&up1a3}g?F7O3PKIGJf5d{tA zI4aqGsY5VQbUH^|?;tAyp0j`Xy&>OGg1X7mfChpsYcjGD2=))ara-(=;_Ac8v!r{a zlauw*t85_^HKF}Igwbnbwcdw;XZEw`=tAA;P~EjP4gGp^@j%`4hS?ytM$w7R#qbLp zXEQDA_OjTM&~;cj?9_*E4eJi`(8u@cy8Jyaz3Lg=^su;C#euc0*Ye174|e(FnnF|x zaXy02YIN8#X+;MVMM{{&0J2C50cCFHG>Om{PGXyFo_WUCg(5fkBCbo3AAms+#PcoZ z$b8K1&~$ykJ@Pr_pxCB-X0Y1Jgf#z1^UJd`QA>i895An6%PR^K7yEa|dSSX6g(O%J zl^C}=(hv<Fcs$(CjBrz)7JHg24jnu~wQq{%TSCq4dWa9$EF3_%rKSvclBmGeH@E2V z*$CW}b=yKhqAif=ue$_o@%jQKwWZqXM7+HVykTLL_G@8p`I$u+89APp&iMCO)!bh# zBkrG<urIz>v2NUmETL@N=mP(FC-hxjc@LVP9eYvu#e9D{CQ><g^R+~6W#dNDXr%s# zL$6%^!Rw)d7N3@nPxqyMW~QQ?&tm?aZWoQ!=zS8Tw~0R`c_|v26I0@ADJ;f%Vw|pg zk^V%NK`{(D{-h2*;{*{R^Z@i;`13*=R(R)O_!oZ$Vnj#&N+F`KUAW$_4{2<c9(5Wn zKLBQ_%+7SF_uRAdv>|wx8LLhCSkxSGW4gh>oegwBoWLm4JQ{*Lb!)TaaU*9Jk}Ren z3TzVX>T1Eo1ZAOi5#`v1!Ro7<XceO%A7AUkK8ct0;Q^c1{r2oNrvf;r_Cb1g92|mh zP3zlS?axE}9;z8$z&x3~)r9S{Ra*yyUFMe7U0HGD)+Ib^=bh#)?RIV&<IFFQc-SAG zUwLN$1Tp<NB{IPGUwbgoNF)!JlUg6;CCp}U&mNv#Z$D{e&)pf`GvP8m-K@>Q`g~Qw zP$Rp5FAC3ZNE6lK8OY$KB*mDIFUJm9b3H1S!eeS5Q-3IpMm+=E*ALRjs9lYPspo_& z+TrP#zTMBkk{6G8(kYTwb5FG~v`9YOQ?v;tktDF<HVHTuUSXu-U8J<xx0#<{t1r{W zwZF^x>h%NAd~vsPPib5THvS<#XdyU<q)GZccCh=7qUJoza>IE)rI5!3#%<PjC{ac? zklYLx(3h|lk-C<K{5J0f)D8htL#&WUl2A(H06SLZeYbsoWzEr`c-l$F@$9eqng&+e zZiCe#3i={gvDuj=0{rt%@4s1c8ujChBDpRdFI5HI4wFilbgS|^tYCH%hKUM`5unyU zIbJ=@hNV&qAvT|d{oaZ%Q=$2rpwTPp{rc?Xp-7pSql`8Ydp5lPbGN=sx%?j50p{p~ zc=2$~NYllHQ1)<6nas3-G5DKY+VzvPteQ-IsR-?^kLkJv3h{m^I-sad4XHtP@&RfH z+7x@+i?7EwC^@^R!4%_0rR*(h%wBDFY&}U3U`#1dt#9*Cd9PkY#sit8M(PVYFAA&W zK!w2iVP*&-iDQlZnM{|n60QX<Q9YDGd}Gb(#<%G`iwY3#UpAyNN!@C%*vy3sf$_X! zD$>~!N)Ne#o*U8aRT4^*+zN~~-Q0>shi)K#QZdT!Hqth<8DD2fk!BL5A+@l$ad6}< z>*0|`HO&MKrlAihD_8OY{8nGh<#!RJ{ZP8ntR;yCWOsMFoX%%0h^Yl*Q^zkdW>8E> zg*T_Ta`c6<?L!_ve$e#pnnyP|F(15H^z}pP&|)ZXPY@)QZ$+B(O&frjd7dD%xUJCR zBOF(#d)U}+eZ>(K&dx!Hw9MYhH@az_Fa;dHQpB;lsp{!eZ_|Piy0c({J9Q=UR-e8| zgU_+}6QxV<f4WWlV&GF^4m{kXyFkn&z@F@T(NQ`f*kx8SMsYwVL61&t?&QML4(-RV z7IsP>@9s@%{Do*g{?5Z?!lj*QUneAl^<CYN0uZg?#$j_?jDh*Up<o<Be0o+iil(wV zB0fD{1;+@tK56&H8K;uXY3;-cP01<}X;J2`@C(-{QWUfOFnY8}_xm&sp@^%1kEvNV za+MvE%~uVp2DE{4ZZ;QaAJl2q3TIQTC(wtmB{twzp<?B(bOhuKQ26#EuOZ(%rVDHo z;v~b#k@JG3pJC+n=~M5evZEkWTixnaeuJ^G(@MhV#W!_p(gJsV`T_=ZMMj}z8hw+7 z(s~zAqgq;*IYj7PA_d+^M%@sf68in!cNQvW{UU|S?~fQ_#J0`Ar%b+<jmsrl5qjiS zBX<-VlR$OUs0tl;z3wLoL25>m3AR?KRSP2RmNp3z`cJmpSS3<l(oNOWo5a@8LxssN zkUi?TXeb#TMC{88mMQ5J$<8>``miHY*=pI5m&K{#Zpu+bp=GO0V)84p?rUYDW)VhP zt4@zTh;2qIGFww<A1fLeSp!Cr!~4f|a@zKygEDC}8e0rd)~}i8(~;J_ptfUWa^=BL z&R>;Ndlb<OpzOM*19r3Vx%NZ+XJt|*Fy4H0=@8k#XoRIPHgV28;Fc#gFl|pRFHhD$ z1I!LxrDU843^DB#YT?nft((|ZR34&6nv-+MY{jdx+~sh&WKp^f+<Z{2xHfXvVwMUr z8g}QKlO2J#pY9c@okGv&ntPf6_g7ziLG1qYKp2#7h^#8R`A`ZbGMrsZ8>Wc<^6U*W zyY)~cOr-KzgkX>br{G(5VT7^G?efuun;|`>#+q0ArxJvPPg<BhSlzTt_7Y=7)=x{B z<%&ZB`?j_gt-PuGq@PkrC`=;KLGeF;RK4Oj1c2V)*o9w+#Pk?{yH}$cn<iec!?~Dc zRGSH@uSZ@rGFkAYK*dc@GfPcHjp;L_l(Afl2?<U2kdS50d@u=U)|-sQ_bD2+f+Yy$ zUOrQV4)s7QFMxy-y;04;LkzzO-$CO})vl+$7T=iPl_oRqv#^$ygil&W_^PQ&YYu7` z&be#yyj@5hQCW(D$lj{vM-<f)a$iCL?()V(lCxh?FgzqfHr~XgJVOg`E66uIp{d<( zjYg?BBR56F+sER-vs%nCng!1JsbkGjp3eu#)@Pc5je#lsStAL4;9CpPwa1mbm_S#a z3?Ie}?<|(V8ytbyq9}85ID{xUo_FRrJ#rP$nvfs3a?^58`3~=Y0Io2niNI(HlmI)f z1{B3u0fO)p$iAB#9gj??l(@B7Ll1=*)ktLV!xQ>_mWXe(8FkFiA<fXZ*cPh_M>VfR zw}u`S<Ke%&ZO49K?-dM4*Xe(m#tueXJ+I<Ei|3i90X=)NJ$)!|#et;njUs<&loD~+ zshZcpvsHCKU%aho6?4sjA#4S$af9AD@=uRVAS)3ZsG_R&Nm3vU3tR*<@TABmVIQG{ z@2@N~V%L^HTSwtLo-2(zrADk-nWeW>SuRj_9(&?iCCPCQ;-!;#aNf@o!$BmLy-kmw zAX8<qB9W=}EaIJEEu1_Sum!{4EQFptXT*MRDHUjNy^UHr3KP^Mnl*sHkz(w$5E7e+ zllzwP5sE!=A8cS)^_3)rW0XFZ`jdw>Vus(Wm~fj|DDHHL*$32oM1uoYYDmm;WNjqs z&gRlHqLIBI@bU3FmMB}dSQAn|3F64@D^;Os*-8+IIts27v%(LuXQ1F~y3B3@2zyR( zz054%4fgQbHe|sbCo5h?6ymB8(MG<!<A1P<6y+{>xACxo6Xq=8*>x(K46zDX+Wmcd z0W4{S+dEs*Zcc5KN9p6VPT$8W6^dBY?Eq9a4!FRmD}JbQqdKO`G!?)3tl4bRqxgYf z7ecfzb+N~);!J#r{KXf!Ae9@3FGq*I7VT9BJ4Y|?(4S-%&ZfcuCIrb@Y37yN;h{04 zmMhdLldNp?`g9am=3m&cg_etgFclW@DYv=p6(MC-hQfH#bqA?%W%9;XGPbLdW_qXG zb$mcaGkG4xUvgO}=FdSWOQ^>Osj__DG8#rPOQN;Nh10oGN~VDrDm4a>Lf5!pd{430 zG*`$YZa9^7P9;SLmm3bK9=j`SMR5RSoz&4Q<V%o?<6?szCLc0?lOm2x)NI>f|D3=A z#`nGuyl<c%izpZU%~(hftPQ3#9>S}IP~w-H#c<T#DRyT)OEAfzM2Hrm&E@T?$k8x` z5&2wrWhM>N*5FdbF&As@L4XnC2b1GIZM3gR-WYt9vbz(VwL4NOj1+Ctknc`q+uJR~ zOzvi@qtOd=8M33dBI(-Noep-Ys6*aJ4Y<G3NE)8L@*TtX3zbq0zif1O$YXEnKH*PH zVHSc2!P^wq9pdOXgoQxFbi^<$HxEKn_z5`6^;q0S%=cM@>o{=>SiZFuxW*#6skjtx z1D}Jb04Dz67!tvkK9glxIY7ONO9wNBQcM4~7`HD&iLi{d3QX_hOX>m6`((WO6!3u# z`HRS*j;R!Rm$3CF$oTqIa+pBoo7Z;tS;p0#uCykr34?(08j=t0x)C~6yJU?RyBYme z*7EIrvil0w1?585!E*ci6U|R`<@E37RCC4&Y7U-{WV+A9a8Lsv8;!15Hze2DR=O-k zoF!i}@rJez%gK}~>R(0oeL*k~Lqg}<i-=~^Iczz?1+n%W3k8C%!a-wt>x|aFRSr?D zPM30~nI}(S$7j5EOaGkE9Es#@AsNaX(PTtv9*u5TRmW*S-vp)6iAAaY%}Y4|q3AHi zv|&eWKPzf<o3ZOrl&{k|mv@bgcF7KNd;QLZl(;M<In-%lm9&X`cIocogFp?7MUq5j zwY%>5rA_4z0KtX~$mkU?3;Nr{?=RkgzIyLsaO=;GUUWC6$sKAqnOrekE6aRuY?Ekq z)ZJHCme$+^e*nZ#j!vhi%?L*FH_aJ{rVyqwOsv!DIeHnv0+;trgv15a{Y}QhbrOp( zrrxohiT3tKx!JD9dgYv_b_=at&-%>B*~l36x@4wFa_8siJmMdcz%`$>YRB>lCfQ%e z?@n1yyk1OSgnP1zeS0}O3<{0j@XkenX3Uaip5~jW6m&!}cO@9<m?(pt264gNGeK6e zBnu2k@4jo574UOs$Wk~{V9{glc0%zj_}s`lJ+0mf`(@wWn);1=g!&>QpE#BU(J~l? zUVxIi(GJ}VA`1$8sx5ac&V@<Lyd2MXn%ynUw4HFSJ$y{eVV$KUQJcR4!8kX!a#So# ztHYS{Y>na@{1i~{z5;HzH!&j8CRnTUV?oe5OU6i$*)D6r_}&{uUxSZ5NfbU_ydsKz z`S=Qc9bWrz%SqhTeWpjexIi60eCj@**zI_@`_cXN2LN~uJDi;ZI~!yB&2284NB5+M zJSfsu2pL;JfD<snVikOSJ^M^&TgTh*;S;h8)u8m}xpxbkK~q-{tf9I1QxhT|FPhzC z+S0rcvmgYeQfi-W<i(Og5u2ZtIK88{F4HVJT31s)vA&4g{s83ujP#{J{u${D3J&=v z&iC(?Qe^wuD`18^ec#;JnM?V9rN~1z8VwI#hE5*AJ(8k53-fF~FD$J&+L6}};>gB; z$70e;F&abBUbqU1#9=d=7KDh8L6j5)hJW;6>G3+5&E$(kis7ge2-MJ`?yvj&Y6EdU z*|>oqQOJD~^>M-RgTw;TE^)uvIKIqZQAy}*Ft5daYMjYerp}d&lVAz+71Ha_9s47U zlj|Re!+CCy5sXn0XSf@m4OCtG!4542wg_9%ir8$ku%1Hd;x(OnwmhL^L0xyMvM(zo z8^UnRro_ZIF%sdKsrYC}8ue%kLa$wV%0MlYto|e(?h2O5oVW0~s|Dg!OtaeOOG6@* zFsiw9tZ2@9?AwpTezHsI#^orlCjn$|&_)!w9aba~=OCEw^RPoZ<M1Ox31$5hZ_*@v zgZ$k>2r*i6B%x)~g4LxU=X?_xha9H4<R=UwLCj_1aA(T(9>?;8JHO9R5GMK*Y)>RF zvD?a*#VKKOkg*j>3>q>x*I>VKlwu-ek%O?w12ZdSnE_BC<1xB^qr!rc(U4ujK!7E~ zYJsYRwn<m87G=RD&&B2}j7$Y<ikq0SHjkN>S0AeZw9)RsRfL3?o31BMfO~CXL96Ht zno2sCC{RNl<GN8cvNS?SK%zuDx{)fGs{lab$ewuY$z_d7VSoXMQfYVzv_?V|tif2Y zuRRhPh@=`M=MfZ}NqrMDzI?6|f}GGk^cXEOR8z^qL<#ku3K=XDjRK-any7<rQtA?5 zr1Ig}-xeEZ`g*3meZIsps{c@sh=mEOXXJNQEuDlJfD*NiGS(^+$~6~{xsZd*e8_a6 z5#g`ZsUEjH^akw*fIMtd)G9EtWOr8rLnKM*%1x-0#0M>LGtIbD*C!&Xkf`3xQC>7< znU=!PO^@OOuSK10YmV&YEO;-&_fmrz`1ZG&8E0Wq6*==|Flo82m4bvl34wS~34j!i z0J1&34b@y487UO=nhS54p`zK6QV24vZyfo+DM5yYM9X&ZqM$qiH4<rwYKV(g(1W#M zwVxtbsrvu@?`Fc=bSlu}5|Fg`e1Z|k9__ew_(f}hm>su(So$mVvN<rVcVIIU;J9`y zqREKZjC14I+R<(i8}CXXkB`D16ocOw1GH5Dta9&c+5#9zNZtiuZza)*k_f^`+7H@I zLvqFn_4KDdV50d8;z%0DBxQI<@Zq57#e{D81kEd;(I@&9Iac5lYE^>Wy^k5-i1jxK z_9gCYV*oQ6ucEKi7{!w>4H5z^qQk;MhYx|)z>S#;PB}MNnmKEMHHWXr?;)dW#w=8& z>4|HZ_sa#o>@F1!5+ESb2ijAhoG-NA3<)X%z$)1`%}AJ${(rT7c{p3$*Ju(!5F{}V z)r7<t#8^}jLL<hS=Z2D+DXL}>K}<Eztub0-TT`h{rkZN1(ihd1R#BZ)^+l)mroZ>Q z-}629kNezz?sLu`=bU}c-fOMB_StLLdo6?43wt*x?Tjv$%I(gDPRZavPzjWs?iNsE zdkq4CVPN6TH^qNReBzfQJUfVS%Y-uW8C`a9DN*G^ep#4^Cm9p$j}YB&T~A~UCoUvl z(&tp<^npI$LJo;#Q5RP5cCV9sM*cWq|EaWFb|E=nYX0uf=Zm&=z!M;2O3HTtNuLrd zZQc*LE~L;r*%08cIqvdCo9Z3LrO(wAj|`6@o$jz%8MD(s1xRC1LMnhvdVeiSKz3S_ zqXQsf6r!@-9AvS?pa~MB(P?hy7Zhk9Fc(3v*$V}NbCAINaMtpWOwasaB{WIeubk-* znZdz~jCx(T=L!lh$8)oBov5{sERz*w+TKadJooFn5D-omB{Ztoe2<KTixccC^>Jr_ z7=xC_J`0BGR3Zv?r%#xEUFYO&;Ve$Qk}$Ir2<^wyiK2AJ8O{>nueLMqvnA(TheQQw zLv6YH%b9h#RhwH77p1tssUww@i*m}OY<U{ZDTLnnS9FTL=<UHrpeP}+v+1}C?|?kA zvio&5oZ_Hif}?I(9#L3+If}RIQp$=Rj)QPXTp{vKIhBys7N(&rJD#i3Szg#D%VUos zT2({59?X~9W%Vw>Q7QTx0|LN-k4z&mh)hf&CTF1!A}Cl8oC#fRqqats3plx8X2Cuh zhf63$l@8&o;Y~oaw7PMB%i{Kp^tM8855jvbgHqv5Y-XyHv*Y@Qev#?$6r)F9G)pVA z572Brnca>Vcb@@ZMYcD(oNlMtU!m7N$9ImHPWLbYU1Uw`F8hj@{S=?vGNb1w0v$h) z9?R~ZVF+Q~BP=Uma-axCHNx~qQt5=xO-xn0ik(a489E8i@j~83$=!$^1CtMxUJy6% zS|r@bC%D^uIe9U9=i}n@)?Vk(8!w1MkXxf^mv%lczG{8woOI)t=l8qc{-17b=^Rmx zt3v;u4oN#UD#jULi${h<)CY+v9%H)1?0fRNXVe^R8?_9GKPg_EC$9fgI{LA#?j7LM zS!_)TE@&$NB}?k5WC&Lnr3@4sdvh7DT;4>L?Fv!UD|@e>C^Q6IiG@Ja&8AQIr2Msf zK1duE#||q5gu*J&AtnPb$Q@~@Q9;B?!Q@_5Pvbd6?>^^C^MM=~^!caVOozYHe|-3H z=jWMg;Xt6S?7=z<l79f>FCV7fH>`Q^FuU{Norf8wbFV*tuhUR48^F3!0wg~m#YjXh z*yM{gWGh%&l&0<XcS=Z|`Bmj2pZDw^tp+?FP%c1>jT*G6+wv9lo87Btd=|-h;5Gmh z0Q?YVss9gP_P5zLT1NmHTsbm;D84JX^5hrD=me%rNW9G$ucYdAOvL2b`quCGLL=Yk zK>u4_1VWQn9SF+!XrVg`i{R~k^Caq2s8sUKz9)CE+oYry(fUP&m<e}!M7b<ng7MDj zSV1I@7<6-}?05yDolJ9jhgl$dztB5l*4zCx<$1348uIp{t?OW16*Z~Y<}VFN3AZa< z0`kVC=P}Ps+RmV!O}<`hUWsbRIDf7Vhd&iw!BpP%1dZ?@z_U90I<fx%TAxHIz8<oh zn}tn~$GzC(gD7`N-OT-h8Dmyd_8Ep#8B>-`8@U3VLmih<NL%+ad+#mh$;Z<HfPqFu zr>!EENK|!RDi>LHo~-4`c~SsbD7F7_B+;`%3|wVblbR|a3<Yw$V+QHcx$Bu&avG!W zyCjQji{9DddoLdkbUs$WhnF0kGf`qQ`z8wenKp~o+eLvL^4Xtpo!%Pw^5zj(dn4rl zSu+bln(T?_r@S}ek}+NsL06D|7JPMb^(+0)S<R7(?26CZhhIpaY-2Z&0#5Q&k=68` z7G5^8RV&Y)i*b?UPG%cqCw8g%e0ucN2x8)wevv0}A<zK)8=0b8GC_>klDdRJ4Hqx$ zJRtl=<?9N9z#<;!@x3olf=@CJPAJ#N@f+?NWZVHgTLT;0>TT_5a$JdO9<-ymcCm6_ zs(m5hC*0Vy?e%;N{Ew_T_{X4jeQ|z*!nRbz;X&QeZk=<CrG#&8iATL7qE0%6?zBfv zUW-?jfr`RA?9Hkv<7o;;70-5ScxBBaYJ(-;xY5fwKH%nu2ATx@PUVK4BWXdGs-~e# zM2;WgHaaBG_!0!JXtp@6E^mXqu5N0YDIZa+{lLF@Vm9BK7bKV-4rxN=(>rh7bq@o( zvSW)d^_vov!_X}r7{kYpB2N4n&R!sq2Q5L4|I}n{8!tG&Bs3kVJ71tNdgjgW>@SYa zNSBWf9(I?#hBMVcYx(z4{DC0DT~<nLzZ0RG{{X(ynT&~e?HaKV+q3}in|!S4SIq(h zC744Re{K#;sK{1el(;q--=e8aYEzc7ii^ZTe4cJ$`b2fsRxkTKkN^1$zh=n`U-;s^ z^*grGhuzBCW9R0VfeDCjR|sQX?yJ5`;J8@LW-==wAIf2}YY2Mz?I9$-$)T)$_>(?; zHviaK9Unk_9*L(DPt#kj6(EV^V$5n=FZ~YSAsvAn&ylgr=@d!cOg_0=X`Bju6`@uB zb1eH^oZ-8f23)1&O`B>37ZjN0=`{F>wMIV2%|Q;!!4`wOPHexmPV~?xbIDd=io*R$ z9EjNba@pLbBf_UbdVYwCyxaVkl_qq;_d$Rv+T)EZzPw+v7Fh@FfsLXdg>H!G@^Ucw zB3-t}-x&xiSr<@1SiO7njgK7wI^a~i%Ck(?oZz_?8JOJH@{xNXjXJ*{Q|QWoTI9Qt z`+J)L##S>OOmSyPk*~{S#J6!*4fK;Op8NwKT2ZHhcM>#A=~oP1Zr%4Cj=&lwt=bY3 z`xbYk1?$b>_qoFW#R7`1foa*-=`)4;GQQUN=^wY9j0=M~z3WXo;%-Y+*sNl6(z@k^ zwHs{YZ5K&an<Jil7X@9*$QJ&1LA>XlODznNBBP})ZU6+iXqDa9P-N1W-ilyMd4tgL z9&QgW^OgJ?J?|^i^3`Oe7qCNzrT2{R1bvs6o{#xo_3-WDlD5YS%3sX=JbX~r@VkKI zfRX+6=H}>vHyCY3Xz*}x>Jdbh^C$8-C2Psq3)`SkGbI9>@;EvQ4;wjgbIs84C+E&X z>M!Tr<1N40zMUONYCYs%Oa^}czZ5m;Rdnh$b7)<64Ilf^EjezeDai{6Fe;yfakR`a zmFb@Gk`h5jssCp^4r-YM_Vs@Nc!J&bIG{^8E9+yAU|JYgC6S3$qm-DLT@+~kJ{mhW z$PhjY3do=m{K1)>_6aE7$zCynre`TQbsUgy7jgT(0rws94Kq1h7Duo2WX=lS7AYs6 zYb+}`C?Fkv`w>doPy>hLp?3%1Zgf`<iZ^OVo1T?DCfh0|uMW<_AwnimsFTdxfXSsP zF%m?(B+(t;`l)=p&x}x6_Sp0Wa#V%(u1EQ<IS>q(QqhDvNV*ScAUY_ePs0WJl`34i z<;ypP9ac*V4_Z@(K9FZjVh#4;;y^&Kq=fLI$Q$u@HYZUW-YtKXs&yakeq~_`C{cp@ z1*q|YvM)-Oii47NM8$?s6(V!FhsPC$jP2@)1&^U0-uvs$fkho3JvjWq3_XeB8gY=} zqBqX)R#=Et*h5=2GzG47{Q$}-d%mmf%g<-uW~YK5TAP#ZO)hi^j)U^a3fVM_v=O+9 zBc9oY>@t1g3h86q0wQ_Xl*L9?=5Yc6x8ZQYJD+Q^wyUmTdh^YW&ProKfjm$R^H;}t zOuxyaU9{OV#I4?+gho76Ey$?(&XYh=X%c9SSTuOG7Y`aPTCSZgU|e$EyRh9aiSqeN zv?h{&nw2||@zxLK-*6hm*F#fLwNYwLrB-nLq~6?m_z`SYOsvYIN^8~wUIZO|{y~sL zkK1fue6y?0%uFJmm{pTc1wj)=W>2;_g<Pon8<!9p!<rTAgk(f^d!k01j?>Fa6m(Su z)>!Rf8<&OA1OA`~kHA^Qk>l#yTo(vVt_>2R6C9jHwVh9i=<;$iwhxEqlfMCj%Gr%8 z!q!9h0ln3Lp=R$ss~oKMEGNu@)G0&59IaUup%_(c0x)+4OT(XxOxJtOjesc<RT8K= zTf##7zKBT*Rsaq|+8UW~F&BvhI2T}qdKYLs!k_A25Aw0Qz<XYK{JGDB@35QV&%CG4 z+n}vFRSO)Z04wkW=(T_CMy5)|Bw=15ydG^Yi;aTAPbjp|H|8Hp<Xj6d$f~=iVE4E7 z=t3B$tJG6~F`?#>M3l+*1)YmtrA`I1TyYG9y?`mk2AQvv`hpS&Gzm(xCX^|F*v{Nh z97JO$dMtFUpWby5C0E%F9$PWWkvk(=(zLp991yyRHun#+b-bYC0|B3LRmaBLe14fe z&yi5RXec4<oi!h5H&k))>OIka1rHrB=j+m$N-+T4xO;zO0v3%CTPPzgw=k~NY-r&c zY?}ivDYGFQVfz7Lww9D|y1b>74BEL3s<wU$H!lTHp6&f%Z2-7UqC4SuBb)P4n|tDw zqfvh*vq(Tl|LzGH=vm=<DjE3}Av|%NFS~A#rqW~wAI=v*Dzr-@BZPTCfY*bP>^|Q( zZ_8H@U8V#Jb84gywI%g#6wh<F0fu?U8=@9Y$~#r|c@Hu>=ljPr92;vzg8QG{c`Yh! z5^VuYb;_I>eB=*@SVRON|9%$X5(^igcUYU}khwUp>}s)<<?p4Nuec&`<U9D47*$T` z@mrNzIH_wN%fQUw9@W!^hS3-Kgoz~e!vYYkmSWf6J>YP0YmEyj>hX}p2R8|&t*=Kj zXba0-P8}KNCr`cg$r*MD1><a)vE%8*`7XDT<Zbf9xQ=H#MXY^Aa4V>N9<JXGw?E;a zC&8t`E`DqjMNPnR)&d9VBV}ydlm5(w(NB1XR^2mwr3_oblwY4EOg?C1VNb78M;KX~ z?^lfy$ixp~^hKAgN@reBHD7Ta+hs?BIKcL7<XjK{6_OQpP*o6tql1Y#4pXN;D#f%_ z&^ODH<3B`W2RiyG``ea-f<7BX#>zdMTq&N2C+b66(WPRLj^<0m-bcZ1#cdUv<L9>Y z+w^}$r5v7U9vgT*7E~U**zec1k$Bqdj&4r{McXk?T{&3wqP4O~zXb<5<md~FFJzu6 zWa?C-4@i`^X#aAd;sA}ETVKERF769vV)i;dRA~i<9gJmBjC6Qao__E+FO;PzLl7Ci zzpQ2hmvBK-ud0r*=;Ga}OH7yd7ZD#(2qMwsSzBMvP{2<(Y%{^Mq-Kse%s~1zP`@eL zuIcX3MQ~2AhG0rNbpYfVe^aQy{7||UiprmWtLcEMMkl(dMUbjNT*{&t5^E%VPB2tz zCE7iuY^~(_KY&KKZV(mYn|UAD>?m&;O+u-hG4Eth=V`*(s&R4XL2CE_`@q4qBj4Cj zP^St5j_FbP!t;Gwn{?s+&RQAwA%~K>dG-)~Z!BxRc-;bGpY@gpmW_ekgKHM(2!OFV z8gAwr-dpd%_)D~_h0fE{?Oj>DFTU3mT2$MZ&aFlLN+I`X6d!Qs&SyLpaPAxr;l8$j zJTLF(tc-9jMkPZ5nay_IvG#RjSG><V8)~%Q1u-_t=8q@i8wC!oW*eQ}Sg(eW<bnk6 z@G0yWir2!S8oO=9eYdtPnb<<#^eNdcyKE>Hk$o#$gK1Z#4|Z7*#uvC;`<r2Id&3)- z67d5j$)Ja4cgjckQ;qilBBQ6nL;F-o-G!PwI_5mm#CpkI8hOHOBJr!SkxuMWU-dN_ z!OgIlnXW*P6Nt!GgROc8M0mUOvVQ)pGDX))NSzO;OTo2&aQoI5`@Qu?|J7!{($96@ z`Q=zWifL8ULfAzQ{q5a(`STG}zG}5V68gwlo)~^=9eGzUC%7MO0&_xA6e3Xc!Fvgh zDUE+cLMc)a%hNcle?El=OkpjaU`RF(i1!?D+SKZbR;D{4EEt6AOSSS2VIQXA7oJQJ z?`J8_L<d>Y*c3)z&kZ&c@Ci*HCX7Q$ucp$2b;zQPQ2Hdt%bJ|*DThdZG>x`Uh$swm zUEJZK!5TZ*IpBSA5um}<g=u&T?h_YgTlursa<2<Sak~7G&vxc9BSKK%qHkS~n%|R{ ztWpcP+3xBuc6;Yc$dIor1-ALJdrd<kX9`4+402qrgS#l!hYu&65;38-G$KwqKsX(E z*FXPwyNvSX%h9f!vpiI<a2a>)YJ`@01V7uQcG27j)}$Vt{0)0Cugr&F7w`ld=7!xU z$)9fuVLb8C3Uxj-!Rk7PbQH7Oi7ZGgMVI>Q>-|OxPHln-_jeEj13pEyk6$P5Y=2{} z<}a#*UhcMH8;paMgAwDa3Z`G&;o~>7{dnwK?Q9({b{2u#<ACX0r=v**-z>z3ZkPJ& z#GPu9sXs-;sF&jrLkk%ef-=!!MguYmh=4eE#(Ud|1duo|%0hcK3S>NBIiELj$S2ce zB*6;7q4b(VchhNr_A<qq_hGFFlN~r;JD4KdN#+tG2MqHY+GIV55B&VjAa#JwP?sgm z5SJ^tS+OKE;gxkjU?LxjLNoV;*BG)e+Fa_1rxX9<`cX#BHCx32d+V{Yjo<mf^Yr2C z$%6-iS#xEG4}q^XuT_UP%v}l%Q<ciD8wkCv0WiDE&FyDq2Xqfwx(LTH#~vy0<rpd2 z;z|!1yJd%c&E9+*RvQ+4-j0F29r1r#F0MT(uv{0VLE59Ft5$O^ka`8c+F<hs3Y2JF z4`H4`*?nS$q9Zg!<@xmR?4vl8{?A=Mqaaf4?H9jJ%*7~w$d;`trspw&?kLuM0ts0( zgHGqMY!(j>e+2z-Z_!jiDYQyfq)eFZEul?=De~r`^{~sfyBeAVd5o~4%gU6dSQDY? zYeNM=bM`W-Z;;U=auZ4p#a5E16;A^<JiJiy-ongpYo{*>e_L`fHswfam;k%W+>@`G z`<8eTUlz*Kd8Oyr+{;QAXI$aiCZMR$;5eaz%w48R&|E;1uh`Z_2Ap%LR|p;))Py=e ztCfKfh7?4as*LE>c@Z*vxmIf+Jpo>vVr`C=FztioX+QTGDXAm?_bu`Hf*+Dn{m*r3 zmCxHxh37lXi=Hx^i#hi@tOW{GtmPkLk$dns&>Oo{VpPC+L{~BR#%}i-SyFmMVVMrR z0s;Ei%3sEV*3gIn+BflzV|P8I9t%d)v5lg+aDMaj`$n43BFDS7g*T}j<${Q}se#dL ziZa}|nKX4-r*~8N=SvLML63?Z?6T*K@4!pViM|~@gje37%SF+1(^45m+4=6GYGw`i zrh${3ih)?THG!z#1jANxr?WO<&EH)-qNrcf$`qn;1>D^3NlP=z^J%2Zrf)lLv6SU( zI<4XZE(Q)63c^dA>`rJN{BoZt=^wJC8e?BJ@tselgmRJp6yJkqfr^J5u#U`&N3R{U z;L<}BP7Ie?)zHC8^2PtyfD(XC+{N0O`T<9>jX-$8Ut`F~y8G67x%cKAz;|tp-weFn zOG>56%|}mJ-XV%OCGN<K36vF-Y3U=4$pVq8i>FI0J2)qjTclE3#=5#bS_6#XXp*c` z>fI58=Z1Vmc0K`Y7=2UqE5hmss{h@lREV_+O!J%Wmb)))z@Kf$u1F-Hg{okloHUo} zn?D(x5@lcB(W`%Xe3HqfJe1nK5*}^$7B+Re_7t!|u!FD`Gc6Xf5=5{(l77}amVYJX zB6`)2LzcF7JVr~m?N;uDhJ8Ce`FBH8E#T!X()5oqVRtGrv-x|J@q8OT`Lg_6LH#2; zihra~)r)=6xN8C^KQ*TySY1vwx#^Rd5IQiYm=)^OS5^V)ZqzCa#f|uy@8Q0#bv4#t zEIbyPK@YBH#9{^4F<;NIZ3W6Cu6jJMnG26938^pKX=yEK23##E+x|VRhF?6lwDk9D zu}eIv<3W}9Y^;VdNuA}PuQI+ml{djF{PoraZ-~0lhycD@PZDkJvx#u6hBmv`LM%x3 z*cqi)QqP+Lic?mrj(KG&ms{wq=uV5lzglkS`ug6m`$+tn3xtj8N?%LPMcDH$2G1y{ zh#zDZv=ma{={|X?d79agXwP$k(*7qyJS-K4(K79N?iYLnL_B<GZ07jeXUcQ=ny)JY z+1JqRZdeV?LNjbGTXbW#a%=1vu>6YevNpal@tzS~JvdA0mZdWe@*r(H(>laHM=san zl<B;2wV70c7++}u6Juf`ar`ucq1qd0=Hxuxckjgx4!NtFP*eN*`s9dp@=nOE<2s+Z z0(?y%5<FMmVPFoSZ=^M&0=T_u6HeLaWmaPI43j{1$k!0|1gV$d8tKp7k~tv+1iVD$ zA>{B|dF(D8b;s)DRRcHUcMle1Mcbnro!lRgmDpEkDh4utcpMY+rjT8^%R-UccfBOj zVx>qU{4GVl5ERCh#lF^+Guj+4B$2CT&N-eF?-1#o1RCDIXDK^5;F`qdf!0Jao;*EQ zk7Z}9DMV+0>1AqFp!w_tdK{9f*G`(QJqwWln~u3vbMU>u!UTkai1*<-x@N(6I^C~l zyJcNmJ_}d!T6%*qzjl^Xfq;baXg%b5+F)F`trAA6_G~vn3szQ9>c@!d@=yOp>M08@ zSUC1STbu3CA0N0SjakYM>`s)uF`QK?{C7I@T0bY1<TZ?AbEqA0n1tCs6|?$sW<BdY zw>KM>_+VPw3(mkp&D9Gpuq3cCt%T@>=TAp7W)>(v?!_9|%v~@5I{=grL~{}(A0?`E z)3lRDDLFw$)a_=cL=ao`whBEK%M@Nb2q@7cSpNKcRZEd@EeRYyX(-7tU7Ewq>Bx4> zona~jo<<dLxcD#S%dZO%Z6E+KUd?QjA6N?umJ!H7t6Ol3<u6b+8d50IUGbH+X2$lQ z1~sMd;WA}YQT0-3H)%^()V1C#lIESvBNVM@IH*lQN6%B-9(7C&-NQ2j>l-$8lDvFM zfOn{hU>AR0P@%`PlVatDPFVw?eY|0Xl`p<836BbUq>$P9SF&V5kKrhDJ6{tC6(bLv zXhoAq+=cVp*oNr&&Qk919OhCenR;)rKb$yt3fE0n&6D9bgzh>2HGh*|BaQ*l&rmJe zmvs4Ji*h=<_xW+J#9OWHI&(9uTU67SU+M*wn~$w-r*J`T{V4n$BUIDwpQ<J%e6|LO z4F*cRKMvS0k3GEEwsV4+E@42&v}vks++i{GdSVbZO(}Y$bD$)2etu_lqNY8m!~Q*4 zvU=CcKry8BE_`ZsQL*;PF_*c&sy<%ki&3h1XBiaRbN!k3)*G4B8wJwF0b2v~o|xEb z_dmSL2XOohv7k?uMD++6Ete)99Me~I@wMAJ@vwL6#geUJXPZ<nzaf&awtk&V|LSoi zw8=J4?eWGhP7!1#8)P9WoWtkTculon4i^tL<*lFtkYOUe8F|1`#Nt-<e`dnjHQRIf zwSgIC>E<f2m(R*=>vNES$IO-3f)F&eF}WG}yOe~)p;<4M%);^%yvf&{dwHFwptpMC zydSanKOpi0mtat_xoIoLYb^Wd+p~ci`Ohr7688fdQ!Yu+j9#(48Z6oP@MdcpOB>o( z$MA}YF2DUV{@+|l!O!4KKI6|S?`cH4cXTug;5?ksb=?y|Huv#IV=u;!o<C>F7k|Dc z;1j!Zn$McyCMdV&X7m3{Hd+2+m3+==&*WvA4Rx4Ws%Kt=yNk-yx&H%@j8n;IAD$gJ zEoY@z;+LpZw-I88k<0x<m7;$qv#_JBz}e!o_GYGtr~6T7qoD7(^O^sn93k@<p&cDK z2LQ2Ii#@KXWI6cl#^`^5-ut(1s^7eRF_JVl^m%UgRZZW^j?E=6>qQ;A3lT?#_>F%( zO&}9Kvw{?^H*}uBxzd@|HwsJdnRaNoD!sE3Pb7lZ{@^gN-OuVigA*m`;sn^CGs~Jf z2Se%?Al#GobI@{?iUk>Q5SM_W{{}n>!r^w(!6@R=8aJS1KGnS|Od|lQIe^+{nb7{L z)pSktLF-|xmH+vNR{@a?J!bq@S+ZN~zy0^F!PHoy(x7ZxzdF0_efZb?%@i5S1D8a( z|NX)apq}`S#C&Me@E;Y1#UsB+T)dM3p3A-U|NX@C$#eTK<MW08MT=)Pa)}9RilDQB z_jE$qIep`g{%!1i*nf=<J9+kKg{nSn4U-Y6v;S&JuSNCVA<%NUOWZ%4`ty7kRH?9k z3w8xk)34G521eNZ_pUG1k%1q#{-x$2$mFW{IpAU49;fz=y!=N1D%<n9|8nWQ`e*rn E0fs-rwEzGB diff --git a/resources/images/scala3-contribution/launch-config-file.jpg b/resources/images/scala3-contribution/launch-config-file.jpg deleted file mode 100644 index 4270f6b2326a8d430f16f98acc43fde7740659f2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 61379 zcmd431zZ;0(=fb*bVw;((g;X*iGXy25+dE*AfX6IcY}0?ARwTWNT+mnr_v4IUVz@- z_w(HE|9QXoz2Cvzot-l?=ggcrb7uEk>(%JhEO1v+OhOERf`S5`f`7o(9Dbvyvxy-9 zNJ!8D2mk=U0r*gN04NYr1rLH-_yq{lK*3z&p+T4#3K~EKuOK790>aqf)gC-d{9vzX z-hprecz{h@-~YObOUTHRvM@3~Vq|#)az0{V<$1)$^N53#nVE-;nTMGhq=rhpX$R5= zNCA5Vbt4rb3hEYK18bnc9>G9JKs?NC@8G~&xIbW=TNpwI1$`q24y1>^h0F0E0wAqG z{;vMC5kxLXc{Kru00?k!@Njn!;NjsB5fPA3uu)Nvkx}q4vCy%J@JWb?@CgY?DHy3q z$sax-B&6Y_efWr(jg5_jnwy`Cg^!VyjRhhE3K0<z1sMew6&06-jF61wf4f{Y02m0s z8WgB3IRK3T1%m-~)dY}${k#K?C}dD?3luaA>>W6G1Vkickf7oNQOurPP-z`}ym z?qEFti*W~&j9C~COF;*o+y<NFb$A-WgU6*`aTNQ0Qn2dUzClE~cOMrIpOT82hL(<v zor9B$n@8k{sF?Uu2}vbo6;-uo&(-zx4GfKpO-$|V9UPsUU0l82`uO_2^ACuKjEatl zjf+o6&&bTm&dJTo|5#RD@u{+^`g7yArskH`w)T$xfx)5Sk<qd7x%q{~rR9~?we_9d zz5Rp3qvMlPh+Ysqf0Y}>{-GBJs24OWEDS6>L@y|4C-8v5fW1S;42LPK0Iy?%Mb7dX z0sC=yTIpBB2ds)eadd6_knT~i%~9?^RJ+#ff2P=*|67{<R_rgm#sL%<C~)v#FaSYd zx4X-QVmT;9Nv7=pTi-PRa6G)+^RTzF`a#l@7`{#eVu7u#i-nWE+WHz#9!v4uj0c1A zFqM@@p(|pCmpkWc)x_yRp$bB1(=*e8$pjN;t$W#vt^q9kq5!X(r}L$QF0#~@ID;76 zMd$gJWxQ=6n90Qux?=I%A}RE{FV;R~Ps4?FGJILqe4o0oj}3(|;DDLvQ@&`y(D>fV zM=%e%ASzz}*(lE!J*bbY2?L&3FS@DLf-J&1n#BgnODxfK5pV^23bfbvW~L^)o(3C{ zM&WY7q;>-j)?6c~4l82`0v7VxD2RCu1*2K$3Dz<(GO_fNY!QGJ!uOLy`#Y-XWo%h# zy2?~YJ6;F}N7U;k8}k<u!V`zqPk|Js$)tmA89+WzdeHEl6i!XCPrw`A@b=aZA_~n0 zZp>t4v2R&0g<*{GsHw+`#*cls`=L-C6TR*{?@U^}EB*qWKko|o898&2^fk^Am(P3G zRt>jz1kQ`5B6?l3sM=SXJuW>LcAInoX5?p%r;#a%sfHD~6?@7{T)vbKl9ht~2gv@j z@zbQ=s~s90s6*UKn<dZ#4v-y!$?om6;_)izHGFMv9iaFQCtWHBqpK3mnq<Ux!EeeB z8Lgoy@n_XTn0Ko61thn$G6>x+ALrhV?#}t@^-ys>7*qfU7-|ACWEqg5vY!l95EIW$ zg})yCV2GRnTYga~oWU^qhgRi}zFBjp!d=(pM2s)fs2a_oO@|=j;o$*``gYx_Z3j5I z8f%7Lk2e$HrURgO#o*+Wyo{m33(KCCwpJ&H;0P}!sIpE-s(hml$-e@I<FSiS3dkR! z<&YkH%}Q{piq48Y;<bHtzy{T4a_>EHMC0g8m*_xQJX9o7K0*WEB37hw#TgMti*c;% zXHKZEj7|?|_F-UCUR3d^S`O{!U4G>bs`4X6ZH2{zFXs6UuRt6)7s_+bta<mmw1$1q zc~XhD%KYaj?(CUvb+_(#$M`N~X=ImAT5upDPMvOs^+FE!?9hFAjCX|d`P)|Nz*bIQ z4M%Awo71SF`0gwxMv2JMlG7tg*&o}BHofXrha`TOCeaR5@xl&@15HUjis(vVwxg#n zXGiW=*BVbwmqU#U_{?>cT><7m&UXIOWG9**Z7|dyH1%zsx$+nJ45tr|90^E2%rT$v zLK5zg8-y0bcy^XJ9NfJjM3laIiB}zhCzd^YX^AMuj1U+UHpc6}&V}1cs7g8YKE<lI zC{yjdMO-+}HXJ%U-UH(3;M+!r)?Ecc@Axz~*PcH%09v6nAJ#X)Q`k!2S@P&582aR_ zIwjcGk8}D?Z+=0z0-Uj5LX8M49_$|!YumZ@fihq+2g{Qg2c$8Da|=hj#9pw6KX)N{ zguBnbcFGXr=av)h$vZLW{|Hw)!*+|>YZN9Gj~b`T(n_6^vj}il%WyW2hZ@o+c&;L0 zzrt(l;casT)X6+$BSG(G*&2S}FU4)MTnwOmbzE6Rr%qd_ut9&|I~Poya0N`WLG`zr zWTjvu>#$@eXxWiVgkk6M%heiZht7S|rIrz0j8A(dw(ak?yPM^^85*~bx7MpZ|7zrN zC!^c*2R<;f1D9-;wH|6_VzZKt!u$}o09uTNYZHATpflh1Ibyr546zxg@Ao^O>2j`{ zbNO(wAarjv|2+iVw_JY|3}~e1L$KmE-LVYFgJAzNoB23kNEyX3=m-P_`B13rvm(zq zV23{xH@2lvc-@NITVW_l|Bck1OQ%(OVDWRzvqNV2%tar0))RSHtXY4AwQj{Cga#9U z6l2viXPn?H+;avxPgH#?Vxl(u^X0=Bskg~RYF*-!Z@CwiVMEXDkv`miCv7XaWq^f; zgFPD_obg7GkfiZr-S?Tvz{_K7_q6)z`xifH$N3v~H_fJ;!?!JnVayAvUe5JQr><BP zi)-7diU(?9C7Pi3){vAF?z&=y2yLxtUIDjlhn905k%Pl_hhDtug;wyV9bUFx>M_T1 zzZF_qco@e=HeXLd<aTo{UOhf6?Znhzils>G*gmy6CF%KRA85+me3nN0>qlOkc8w?6 zKWQ7ci+J?x3fP><(pRoGw%QiG0$w2r+;&_Y(&4+Zhd-*Jv07(@zP&;B%;JzxSIl}7 zoR4iG&vi~a^G}v7;yD*by7r^I3f&F(4vW-#(n%<u7$p4#gYC~pO{VT(D?HT^#g>Qq zmjkZoxfG{?W;^~Dlzdj(neQH4xetP~!pKodSLrr;O;!rZ+Iqa8u~7?!Htkv$jiEDN z7B*nKVL>PyA3)QuW^{fiQP@%WlPP6YZrre{d_cb)>yF9_*%jdT0Cv$~qhUW+|I@%Q z>&Ll37Z<{iD(Vw2LHuzo)^C9i-F^hpVZ&q6?m;=WTZ+Mb=OPRmR9JQ8+uaJ4r|jIq zco@)ho-YJXxcjtMIACZv@C>0_$!v?2fvm)TfeBpU+I7CbIN`4K+O<~jEE92wFN>2= z;1JwB{4ugql*h-JF_9YKcA~(^v&izQ3G)%_>+eSVyehQiTewn2*lJz{56UB4@{tLl zQx9L*a%XN(RlCSvB-Wn9vzlBIzLUUThf~~1{%Ax%@PMeUTtaW|CnJufnwj^~Q;M@f z#08TTBA$b8B{x(&rg5@YKP*dEx?x{+e<4J1wF_{cj?5A@pGOtduZG=%Q<?C(e+2|s zoh_HJlNe<if1D`j^?1-F?7s)+v=Ck%6hzFs@<CGN<M&RjobgiP2hNL(oJ<`PUJJ`B zRzzmW>0V45_YOHmreCD+%D{bhDuow}-Q^oXqDj3|eHP|9B6ty>U;FGYQ2FSro?NGL z=EMhEK~Y{o6dU-L1FArjhYeHm-7^|P7@Jl8^})~f1*{a>0^bqafj4dr8=ExH<=Pvf zMyf%Ovr7HzS69GewWfBDZZMkhQG!zgmBgUx3V4rs1<b&GHjO|y-*`9Q!&#zvsy~u- zkwUV}_hE~+{-bUEUsRzVCp~)+J%4z=NMrJrdw-|mRN@{>KlYr<gHrw$ff~pB;X3Su z?e%$zFF_QKSt#hNzYacHsD!WYFFP$FS>|vC*UR?f_cn(bp(k@p7e9^97+TMN#$Fz? zua-I6yc~G3Ipq?df=~WV=p^8vSH!o6XDH|A8_LeKTDtHsJpFfmXPdQf)@YM&oEH@i zB(=MbkvAMZEor+f|DniVU5vX#Puyb3bdp%g*y^Nh>uH1{uJTCUdB%Adtdpy$&T46_ zPb15mgm3dzDW)HLr$T4v$)ZQ+Z{vswD+<G64C1dBB-LI4p<|xYg{537VzfDSnv4v? zkuuNTtZWNk0bs;AG|WHH{qv@s|MExMrtggBGPZ)Kgz&%2TgZHdYmy{Z7JHfB1*JDJ zU2aue<FCaqr2P3!7r{e8O%Ih=Q9yv{Aib<WjO3s|zBzlc)4S{?|3rXoL=eu5=l6bJ z;tJOgw)DmG=+2Z0`Vbw#WReMbaCGHXB-x&QOX}IIt&`6=Nl0dMbDX6J@~E(4PuMsn z4i-RZmeKkuKCHcDTYuPb1@vN_^j&<c-)p*ba5jD_E6_?SD3)=C#z(R*;fzPUyl}p# zcsZ1JL1A*4rF?1ZIV*P_Ab8u3_$~jCU*D`IbOhOh2k)mV)Maq>jucZe&^KfZ%iKL- z=#uaP-h6%&n_1t}6u!}dr}}ikz=0c<*f&DPsXII~g40MZMt3q&0^W~t8yh=ef^YFY zH=!3->#NX>06(R^rT(-^*3a<<Q`Ps6nL}7-icCv~UgW)JH!qTprF_O!*RvXXX5hKv zf4;%u!nZapt!L9i$3sV_mZzXDtz5Fd#`_i7?uhgXDE2&KRdFr-1MYFVm<iA1IJ*KK zr3cVSBGIIK{r$*zF#H?CQ8fQttFl@}<>6C2!Dy|3{zvts&&L`+`thPo+qJmoS41`9 zX~vFKBl)&in~7RRD86H?3@4uYg3#V$ccR?A+gz3dFRa$|IM7ki#C;QUn!p7wqg7Fa zn0deO<lwDp6K(xPMneIo&XJh-<cgsBN&&uo)O^0g^h&>>OOa+>M#JpF<^qA4g?7q8 zUjL*C&j8-5oRB9$f^j-rNNNPH+j?AZuoJ|-SkSkkHU*_Mpc1yCIN=ao0ktVvYE@Ok znc>3{nNb`%T%_JT2(867KjbvJZE~~*+W5YaJQN$)Gw{@wb6r=aB*ONDS=!LcR~s%8 zXHv7pBOlU>E*f8#i?xzySNgJyyYjv|D}YFc2%mOEv9tQQ!GjRqP;(_qs=?yoVn&js zu<&K@t%nzINT{1ZpC^Jr-KDJZb<tYzbSBFR$y#bUkeiZQd&=1U=laXE2op`K-M*Se zmtLz@ww9XOviS7ykDXspSQTsV17XA3@O%kh2EDQNEHdiRXBA9NVdXME9aPJJt-HU+ z^QdZ4l-kvSVRftkuB5O*GEs0`DO}Y`=d$lLdcw2Ri!p{U_$<4M4;lWCxdqolrBBb) zQWO)is~6G^s$Uo>F(-W0d(e~RZjrxt1$b9St@c%m;l8vM<tSdylG)QMhV!V9{7ib1 z9>0hCna-EoKJs&*+4j9ZC;8uId?pyRAH)#2UjcCnqBxY`k}dStVV|pYWX&TFT@ycR zpSzmwMf?%tha$aiE=?*jn=&#P@qCsV>Om^1tBP(Ro-6`4TtxXcIgA_<sc1M3a)~Cf z-OO&PN%^*)hF0OIQj=ehBl`;rDm+Bv(H1$&^!(<_auwqbmShbQvi#`erP1&>-7=%6 zlFzpYpWqO-#PZkmAJ>0KV9UH561!u7`Ev0kT3yYM2xEGx<?}}f4``DxzV8=hVQ#@J z88Ugvs#zZpxx3B#>0vX`FX*B~ps)3Mq{J2bySoZvS}p4xSP~T#(e)6^cs5)}3%j`b zm(!vM1{!g-Fw3|lt_dsEc)y2sJ=pr8(Vs#`!v4CY`<Tc^PMLB6o>YLv=E$R*Tkl2E zhac2utW@e37Va}YrD?JUqr7p$JRA7EF5e`XGcjh)aEtP@*j&&X2)logoC|^546%DX zaembNq;avOr%p2WEOXoZ5;u!R&(wI~C_&5*U1x@EqgtR{WB)?3#N<(n$W!UJj(kXr z2e_#sgcNMaa6Am6>=lb65-^h}0&;i&)IQ-QUiKBBD-nCK>1qEFB{Jy|;ZCc1+$_Ds zwCgCn4KV?_On+zIF7;tb^Tn&Nn6Br6%<a?^{i@!pM~H+Gtm5y!Qh(rgwb^=pkh#`@ zFY)Z8ZBS{5H}H?B@@Irmn%O>o^I!b}c2>V16KKzU-brE#5OuoKmjB@}0!%d?Q5~<e zoiAu$9B?TDnneKNuRqj6vZa`rOD7RXJDTjap6|=U%wGZO^gQLd*O#Jm`ju16Ix1~^ zi!ohJM&&S1mjNPAI+y-p6uqO=FVM|)4S0N!DSFD?Q|+(>{!jVE_M~vOniLBI>0=aL z#|W-e7e%ekC|~Yz;@9F+^H{9(pa}@E#vZf?#^oflY)Qb0PE|U>9JXBunC2hFG9Bea z;`MM6I`r;ka>i0DPIk#@*Ln8poG7kjj9tuiDt&&K%&`Y7$=UdAB!!>M=UqQ<XP#-b z>CPC(Qs+&3_S&5c+CJT_b|FgcRn?0y<L+RZt+r7-du(OyU9~fipmqJ+Zk+ptu_@4o z?m>DrR13kHLZ2vVWmREVrJybP>B<#Q#;)Ro#J@h&JL!E{4QAxs&sVs)H)O%69+n2C zP_HSHBIP8Qzj-(i;ZWW)&c*4tpfh;+EdWp#dznEM9!HZab&s13V7<rJuOJG5Yc+uV zMYi8f*`LJmJg?vVo6ucI?xi$;*19I0(|i=#@5K{Lg=;jJCgrR0mZ-aGme8>{ot^>H zP&Al4Jg)4HQhST1<YHP`j6A{ihrA!Ev*i)vDlr5R5loN46!OFKjzaRyv9-Bfb4POG z{$!4kb`M9|QdH+9WtxZ98L5T&V{RrHiEghNBBYR7ij<>L6ZS691uBrr={`H?4rnz7 z&}0hzGa3BL63X^dZ5yiF9*ZOgy;p#t=?4`^77}N1bZMZ=JRFex{n1hGQ_|VNC`uX% z!T?DcC<%(i8?|MX8TM0QfzpP&Xy^+QA*4sN#z1!a5h_n2^&}hAbsYQCB}>25FmrOd z5G0jm)s_wIpE)yHlF`F<6ovrwZEdh2e(-6_g=?pe&0Np#DQX59cbRXI;WcPRzJ4zY zRdgXySS};R`)ROy$fr3;!@U2|jIj#A<2q*&C*IP1;yA?|v?t>Nf!tj?fdo7@xr4f! z5sv2}>f@`j2oKC&gRf?SJ<SeHF14#BKU7v2H|)q2!ar-m;CuU4Da>o-bwZ%}S;>Xm zexAai1EvORc9Bus5@wP1^M11zYZK>JzytCCn&QYM=m473Kac;Eh>Ow^@%Gom&3ZWC z{7&YegJ9aaWiv6F)v{po+ES6Rl~lgDn+yU<`e(k$GLhT(z#B*_Dfg!ZB@M2v2Q^j` z8&iqwq{kO79aw2^u2Q-ws$5q$=)fKQ!|?sQD1mZ&<m**_TAliaiAU5IX-e*OB&x0b z)p~ScnxCo<ssiv-brj}RJPnr$WE?JQ#h#DH^~O`9j=HLP<XM-=VxT>7fjt{qu4A0j zy(7*|oi|@n@Kh<%qu+>FFHXl~uD<N2daH}X0r(`T+S>cq;&c;t{z#ChJsOKAFWLk* zQZBoO-ghYP{q`f>>!pobzOp|ld?n^QUmbWIm3Npu6aj_H4wI&x1#m!A&XnNgTv6x~ zx@Ypy{hI=P^byX3yL}Nf(D;z#3KG<4qmJu#PUYdIz(o>0@WQxoz3=*b{R}F33|T<$ z{4e^a3xk4R_D8hM`*Gy)<eOFf9vO29pPk&(#$6Y-)7xB*r%x1kyjB_BAFpak9ZDDy z1w{l|neoyC02=V1-Em*o&%U1DLIn2U^uJBEAt`tMOhcV#8vQ(IFJ<iO(C{lnfLDg! z0Y_!M`42d!e(D4ZweAY&0>wvMd%&%)A-osZI8k;m%y8ao+YrLInZ`7*``AD<g|>5l zq4qS}Phgb>MjfPw2iJ5}2jlCr#_|2$eactTpu9JK%7ggtfAZV^?g6q@W-_FLxMe?Y zH5Fl)Nj(hUxmC;aYV2wrx<o=mL|a}_PE0~t6x<;KcXv|F^(^dQ!96AmOM6>I@yDd# zW(6ty3IGdka3KQJ0I`mqowcyMy!5XvlmB`>9ER-v0KfnPMAm<;|6gKI^$qOwz^xWi zkV;6;+7{d#gL(<V98UJu5I7EmvGt5~^g*}~gdf_19R%S~2wwLF-h{wL*Dz$y4ZyZl zRulnsgKV~u8vOz5{sHS5+ggA$Y#<GVzJ(<yANtu1tPg=-L0}7W2e5C~1)?E}fu)KP zc%=XjLO>jl0KnJo04bmgH~=Q#3sif60lZp*7&|}_tbhD3{P@@W@*tNk$YlcPfgDc& zE5HKKx#kBTV*t{C<uBXX8M3lmqrkWK0B~pe>S~V?0N^75;3Dkm>MZT*>LMN7-J1k} z2Ft(rtx^Gi>j1=u{e`1Q0RZ&30Pv~lFPv^H095(`0PdKzj;+phJCKb)XhU%0ayJJ6 zP@e+;)^`9v(zvl3SO=*GGDZME8MKvjHvq(g8<|u_plr>5(Hq>L{L60tOPX8zUGFHu zKtn_Rfdv-)cLxEoH+KgK9v%(>1qlTO83`E~6%F$)DjEhFGV<MfcQLTAad2=@(C_2k z!^XwL#=*YcQG@|`VDBK_xr2y}ij0c=zg?~x!5u|tW$0iSC~!0F*N!3q==j%LZxB=5 z6tIWTP;l_zwj3cizi#&Be$_$tRbe38jaRpuTX$jZg06fn9rP1gq~SN!e+3+k@!*Ai zqhT__K-ke5;Nb>t;M*#4&>?;mn1lEay;MiM1GV}Bs=Avat5t{96EXJ%VqEPemIh|s zY|rq=(HuM1NJOxP^cJx8V+*16tYYPSV{r1XML;>fEk=#d129R<U(x&$3SQlHNn>&1 zmP*n6!=~SU@=q6PVwY3clruRr3)e86u5B8563*401;&%>at|?pbagd|@b>m!E-+=) zfhrZWUT|+|I>V4fmC_&Ig_>;qH2?CN9_#L#K4s`W<-akT9nGCuy5j`ZIi4>R3944G zrk@#~T&jXeK&D5Ysf>nXoQ}MA4%hL~P=be?(O9?BXVqbk$rn}ol`BUdR+Tht%n?$; z<1XqenWE=19+#isrNotc6#CEGy4ltzJ|UtvEXB!KiQLIquRSr<`w=<BZ+61q^=A)c zOh=1~9xKmDTS?1d$(C(pV4q67+hE_qYU)N(EJZ*uabPY&#$Zp^DL29&&?q%O?J-E- zZ|R~@9o)k1%np|w+Dl%kp{rz$O1QHj7EMJj@Fw(a$)61%gPtKB^cTh&ob`V%aNqgG zKAJX0`CyX%u7LUqnPh(}1b(@v1Zo7a+SwbuOV!f^qL`%aQ){8E#Xn>{1*KNUsp~;A zwQsc=`C0NPNj{*{t<AwouAA@k_i%JRYN}=Sf(!c4^s>1+ZWfFge=n%tz6`j=v}P@B zbqMgAPM1G@on<<iRnWBOx~^)hUN(I4sW_PdC;jVJoC2xjEp=+KSG9#JPr)E?*X!?s z0H`V_SJU0KsSVSzy}Wr{e{f#>D*s)xgXS<S3@8nImI$=gzvuvXj-W|5q2ISR01R0F zU?{{_%j<Uq;(=ao=ih7%sp15q9sjdc1IWU{6Squ(HrMop3m{4Y0P3MoLB<9M&7TDf zv<L@!X|XS-4r(^=xm7#Ir$Y!uKR&W3wRC$il8h!>VzWjaySh43+=>gnIBq(hbJY`O z*-LPzH}1;1R2>533Wz=a=+%vEs4BE<PBZ2%qv0V2jP+I##;=}+X0BD@iJ2ynXj(je zwe%FN?1|iLXUqqKETnJrlbTUMyL$jwzrt4U*Cu&1RfOAr<QRtUVxOh=dcLnTdB zZ7GQh?O8U7$JtzZKN$j09)o$kg^sz`<o}{5TvT&M7nSg02E>fs`<CUWnnxKX*gSTX zy;-Mn$+W#MJYibvhwYbk$I7iXI~lcjIF?Qfvg1IR|0XerH4_L`<-v0VfCxRqPg^8{ zq&FS@7lvQ9z99n7(C*Lnb|LHj-wJ92a3dC3-BxNO?6wYp>*zzu(-c*{^Dlp+25)|Q zhxhvBhef9CJy5`P(LZ_7+I>DV;Q!zI3RD^Mi?S3ZsB2r2s2zBcc{;rZE=YR!Su$%` zT<r!|`jwT|u=Xrg#u6ud{TN5J_S{Sd<4&fyh42K_O7}cD_vimb1FQ6?x`>$LM4@Z@ zpckChht+@S1>EnW9dSEF;JWW!FuFh2+LP+7a{}K@3&$EdSrSL8j;uMS&mgb5q@twI zkDk;gp4tc$x}1RK{d<9%<y__~%FPgXeC_H2v1<Y^4u6}GrKVm3{_82mzp~P+j<Evb z1w<%+7!qr}H6`}t-<tuzBnW_YE&UFeW)Yt=i%VcR_p0AtQ~jHV0yoCou06E7kdD91 z9wBjUWioALk`Dt2CxVFh@~2*@yI(rSgvL6Zyw4^VT}=X0l7Ai4hrN|{tryzjOrvM_ ziDk$(<~7%rm?FQNyni6D-?x&}u^kwjq58fy<V6XV29t;1%Ax(G-Jbia53%L{RVWl* zJK1+oK~8`=ZlG`^_};4z<Hh=C!cyX0MyAK>_#U!3R`Bu5AO%HnVv<0l2<Nbg{+StJ zttVC7d%tB|fzYLw|79i+<AexNQ1XI7zRFlVmiwU0!=c)wa>?Uo_x?V|xnS>)^G`We z=<CaT{*@l~)sERODm*;J3AB#0NO(1Wv><5<66c-T<)l>MKlk|N)_w6}gv67;b9sh; z?eYom&mpl@;|B8uY0w)c*|wwzKTlVfo?HRBqkHu#o%{7PZHM&~U>rNG4s6XW(3mW| zVBa{goGjbVD&li5w`(-`Azj1!Q2RY+auw93#`>$!DSMU+&ki?jFZsSb;2*&hs{Pqd z&=8wZVSpw6y{sO0D;YBv&vKc-A9YqUm-^mT;b2G`Y-J`z%jWh6&<**)GgMCGmOx6| zMd$K`cJr>|Il@0CH_V&rSx_dh8W%?31tSH&hF@p2F?LqZ+k8}y)!UhC<tAW$;j(fv z{$Z<IO3>X(<ep%BT}v^GBJYNJ%@>W4Mpq@|j(r-#e$W*?3R*6<SJ2Z=NUToQQ#@1t z5rv^ysvs=^Xq{BEz#&7~;^mYR^@K{_UYvm6QuVlppty&i!FXx^wDf79I@i#`xJ03S zg(d&z8qKXnLiMsdn<=*q-LtJ4l3bbIzLOtvyALg{fJET$J`ZM)*9EH2coKja{ZyHF zI(06X;db9UCpM*Ek;eFh2Xyp$Z5l8>jV5Z=PQ+hEiU<xH8=PKlWb-aG?AKGYO@LPZ zd#rqXn;)PBip}ziHVwbE#dI7nYq?O8qn-pi0~2WEofD0-^UagBJ$Jiyv3Tv|ly&dG zJ@B<!rB8I(tSzU93sITZ-+c!P>h4Wf;YBm7i8D4Vw3C;Hlh?1;Q*X1%JTsEPJ-;>c z-NT%f^>!^qrDrf9)8-Gq+wX2T?2u0Ev7NnYz6WI`4y7b${dd7gi!W~k!=(3BAxCP_ zO}w3#zFAIB<viPCD!!BnGFzG9;eOiKYW81tCAe&jZ?+KONG8HlQ|z4)F*FshjLZJ6 zls%I3MnEmZ@RRH*zU?_v=f&My-*<MsmX8y1(+uc5<(4pO*<AjWSi7vh*ZJ#8HwL13 zRvWWhr&D{t^N<LFcUI&2#cQwrJ2_xn@105wOmH5a8)+=I9Cq7H{J>Sczf2@8D%Iba z3Sqb&m9KM}vw*B5c<ZbR&OLCwdi)3+O;A|?xLMXK)?E(S?EL&BwmR!}I4vDmoKzW2 z7vcl8E}o|q9k0BqC+W|IFkXx6MQSAl5Fr`i&GZ5g+a+Iu4}ajO{LXGDYF(eO-FWZq z>i8DS*Wg9HQ=z_Ug5CoD?o`$h>7QH>JfvJt<B#MZ1k-OTWUa;rL1JRP_kuj{@-Ps1 zow9yp36J`3V}G$2NP{TbF$-QGO5eFv^{GdbtF^~7qicm5AeGnUW-`FS3f<nLOToVc zeswHrfI=YX1cvW6Ik+Xcb#+(@(i;TK$FHjZ@T+UkBH!Np%G_=lZq@~8h(3@aEe)P- z$%lUAtXyWekxaGs4(v{v9iG(GOYP<h#J0%)krP7QE`dSC*ZjmWXbq5b9K2aA_wb&( z0z?m5Cqi>#HR^jLWQMuiIZMq2wRbj&Jd?ey86c<I>G>;qZI(b>@|O(1z52ni7qN@+ z6ITHH?n{}@(eYhD>y*$hyYEM4+1Oq+KqOq3TZe|4d$tI<zg7jH^#TB*d!cnd>oe<| zrY<ciW<oce4?Of-XVuGW4+XrxT?S^&EDOkupQBt0ft+q5H9VzV7~~e-!23IRxv>g~ z`<$o5s~=y^C#ol+Yg{WG3_E&f7I~Cb`9i0cy7%kR_enZuAzatxCUgDeivWC<cM0g> zaiDg6#%Di}PbK}nUjb~Fd!5-&<W~HTCzRdc(8pHx1g?NNkH8cCUt(^1^vgX#5xOtI zmp2Vy_ze`Fan|mC2EJ+A(_X9igk$mZF!zvpwT5Yp7(M8yK2hkmjGK|Z9VZZbZDz>K zu~!!q0#~`U-uFkIiB)w%aIq<;FFqumPE)6ygurK={GQ#nk?EZm$V5aG4xWK)m%O!1 z+WC(IHg~?RUXk67aRIZ>R`sDjtaQ&#r)uQF59{9_S3($W%Jqo1UC)E4q`P5WAQp=G z5pdHRfe-g*He6CZ9B2VZpFQN@XU^$4LrHHK!SnU37=y%HbcuEV_Q`d{Q(4zv6C)zg zV(E;Q`}DmWF7Nr2j3C2x>iL`fW*tk44u$vyniqf(-2kcEFLAted#~I4>K`255v8+0 z7&v^u?VN|U1>rveRl{$Fn|TXypX<Q(d-$)1{rA(*Z}QuC>TK<J9g2Us9as+uC;xqK zyl%LE`8s&_N9et&gPi}C_5Bs6!4Usf)_F_)Ya-v=LRaJ70ROQI0D#lha7_zYPl5lC z^m@I!CjDDHzQ%y3e<Vl<PlX^gm=VeU!3ZD`0z@p-8X5B{-0Xkq0wAUaaUBUcA>d!f z0+e=BAX5&eUr`AR0RNd7;3k9DPX!tO2c*~H(ZQErOrRs*fq{mDzWK#H1b_XTbPP;p zp}Sbvq>rA!$>ZE3V_{_@XMaEez7InH-<Cn$fmVtYob)(<h-%6l;VX$pqo4MF?gBgC z#<ue4U7<!(=AZ{f>d3eRE8`GFzuQn|ulti6v79bHv3E8dC{OK;#(hIWaNxM#VYjoh zE236a*kz}O6WK54d|o1oFj1ybQVNz5WpO86ph{z8E;buHW~~zopd<F(cP^zFlGJ1D zEf@%g8l%_s!{nzTC}I^2Ma42+%Tq02+gHlkeCAE1s2#MaVx2=DGd{zu+=CjQ)m{=G zO5jPb_)(7?t)3hUqad`zcLOaQ_H(4dY7!lL9*&q~)l%o8?dQl7?8w;D5IGfmg_cOV z&*xFKFWkp$H+nmz!G}r~!F6tGI(Ommz@0jwGmN+s!WgW3U&xuM7g;1VtNAr1R4KmT z$n`|h@?mB?_HU**))yhiyW8gbgoP{|<=y|Oo7uOtL&aEIrK1M|(hm4C)Xi<h<qZ@G zew00Ox_5I_%V{e%F*^gT-o7ht-n67IF5Qpvyf7^i$uA~^?F!cNlQ1Mr>sqaQSRDO` zzALS@&iG8K2#H@t@#T{YB^_bim}Uu@%zio+<4E$VO|FMSCjGj?@n{*+Id*={Q<6*K z`fH^cnGGhNa--S<ixnUArz5#-WStvSS;?uqc&L|yB&htE!I4iqy*;}jr~L$$gIo&b zJRs*(r9+15p;Ovdi#62#@j&^kQpAK{mgF8oKioA>%FD-@P4HMO@tC5zQt}B|-Pua9 zysKjl(!9g9!<R3fR|-_JWRH4l#><Axw5^mc9QfNl8E^U=_?W3J|89Jsb~0+r1{R*l z>HZjcO4~Y-(t(RD21l(xddCLl<SR-sABlp_c=_NL$v84YS>=?2`m#c=RidTX&wW#? z?bdBg&5)B$N5$JsX&lyTs-dM@4RL8hvDrqlv+?s4Rd?4F2~F0Us$oAjRgzqY%dhG8 zdT0or^h$7S3?#-m#2e=S=*Uz~IpsyZF7SfU&Hr8+gSNthg7ozs;NiBlh_NvLKe!>m zq)(YQ@SCf}t>QjE3LMy&9~hjB7hLsc@Kbjotn^Ol^<hcyznjw>(#5VsW~AWVCw8tU z7^p()r|uqC5|@nniHaZpp?@@Pa7!>tM5BBh3XxSbF&27xOk18pkKmKuMZtUDe$tip z;cM%KPdt%pZ8;CWY`LE^^5Epl6;Mfiao2N<{(`J`<tyuyMfuR6@OWZxRDNI?{)ISi zu8hj!Q@X}rrY>9Qc$`>b^dTfE%i&4uK6M9#P!$aZi5Od96)o!c!p|LOX1-k~J<9sW z*OGgz$MX&pk~IDF8lx)khY2s;n%54lfJk=qc6cqN9%}~%QvJ5}@W=;LV$wnJcq}aX z|D#)xJPT>}%p%VBIpdN8&Hf9`#!9BJKKO2kND5A_DJJx?2rU$tI#}{mg;kRQ8qyhQ zFNZMRyOqsn(+#gt@U(w!`s^lM1{W3oGe-f}m%e0PCbu*D)8acipX2;;Y~gUl*Y}`T zz9;G?a|9!z$yaNK8ZB&gd3=!8CE$ObGm=G>#kFqIlHkX;B)*n{Sw7p;%rc==7E5kZ zB`3p;NV|=-vzX74DZve;IGiJE=NpfC`X)z3J1bxG`N<=-=PvD{TCY-UbF-LPOqUa* zTVK$sG`H(G#3n^UXXe5>jPWbCo5Z+-?X*1SBv0+DV4!8s&ovlCRJX}(<gp(O3sK@P zAtzibkVPJKP0_|=;$qB}C3z9!TSIBmm^^fezjmI;)aK}V&m@KTz6hL-?73z{yaAuI zaAs1S1$Fqzk>vBH6N=VF75zcNpv^X>CO;0P4}%m>9H~PGPfu8?^ERV%Y;oQ!4n>_C z4C4%JUdWY4XYUQ3NvK;}vWDcOJKM{l`Oo$7@lg9c`MLU@2<zK_MA`V1wO$MGxzwtV zI^}Xrc`;yKcFzpa;FW<%<NXsi(gDoR{9*x}vg|wiv?_GAI^^*?;ID3*1BDC@<1;?J zn;|n1%zGa!<M;)6zNgK2&Ach2EtSx|Qiu~rKARPv#Nb+}wzLzw-D#fZ#o!U5y0y>c zi>BdZQ!>@Dl`p%nxr@E)q@pKuc#`zbxDq;LnFX>&RESQnJwCG=5D~hT>o;A9bVU+> zRHRl*3YZf7m~}zOFZUsXC5Mu?UtBZK=s{2smx#+9lJ}!4pSZU|-1PpZ03AA+#m@tQ z+8P7l+|RLu3-mH8d500@KP0hB+pKK~3H{*78uU#B1tCa8iNY%YyH3*NEfNfcrtdji zgaV;qlw?kMYW_=2YI!VZ$uYxZMiGU1!H4TVkrH{o44#QLYs}>`d_pMHMA;NO(~p&p z(QsiX;Wnn;{3=0<nxsU<>R#TWTu2V>Ug5~LJE~z-lzMapq*J#OOC4DLP+DarY>=#v z_pScHa92Y!w`n{fL}tfULk6Bs*mmj}D?5oly&^O<k5@oA+>A&KO0i<<<<xZcaZf|f z#oI5?D(CWdWu<NN$mrGEvf8rSIGL^h=qDdTh$0pyAAEZ|MR`hAw2Ey`$FdqIq(!#K zGt;WAuGgv@osDMt1m-z8US7YKC|<tplq5#Nq8QgjP>)SXSCn9*KHryGnYHBC$!G1V zum#7o^*`*=m!;OYEz&|TUtpHc5$jX-KR>}F?^dy)<Q|WD+Lxs=TP01&$Vm9MB;CbV zBUph#G*n*l?&2^7?BI42En>*|iAh9ABQK!@-#%inZOY~Wr>`TN(+*}KqSJOxZa8}f z_(_cxhe&WGQCrjfS4$?}uqt)JGtYv8si)-X<>|C%#?~zd3taqFVe5_qOZ^`jQeIA4 zbCNP9jIJqlx+25oj2f~~KkD*-q!ccQh-hLR*Z%04Vjc(WtDdx2GRhOBXVOk*cYU~Q zGWJ(7lUMjbX;B5{ik|hBul-Jvh(r9om1vq9<0UO1*t$mf<s&(iB~|d{Wq%5>?LN%> zB%QRdSe!ZEuLOQl>8>#7k0c@(@w_TNE*3U(*nA-9n+0V$7L~!&x}|baxY<;ysRGG; zJdv~xTkQLC4rB_G;(_vU#ku4OWe7RtVNsX}3?}ATGRya!@~RX+8GJAjC1t4KC`POM zB%*>HCz5Md`jpZ~)I=m*--A2tc(`>z12LyuypIKm_sJ7gM*4^Wo$>HE^})HL(?kb) zWA#I<ZM&u15$d-^T;fk!F$SxAkun1v3Pap<=q1lo)6EHEBE<P4D3v3ynAgzos&;;c zeQm|aNQ!l<mH8O$o@drVVHZuV#&4T1J*EkUuLrX2FQ=4oWhtN9cP8y^SVc=&h*@Rt z(utng2Hzbuk(IEXR^gu9H95jOWn!;H>nML?D<_zpv(kT-Yh$D!IXtRtAogxY&{80K zNV0CUVgc1p5?xLSwIynUkJ6+{d4S{iG&w-!7-JOk!{T@R50wnB!06q@sVyZ>;)2rP zvj5FXmeK~LG4Ds_2{IcaOgBS<?GSw?8;3OsRitcK_5j8Z>(T+2F{;{@<hdB=L3@;( zJNN3qU?Vvmj>=fFCK2Pe&>1t}L#&~%y$8n{sFT|fPSla3-tj^*L6^HjFV9j#BIaA+ ze($FNgT(_Vh>Q1saYorh`LQg?XYk>TYI2);qEaZs!no_}UPPkTL}xOp_$N<`5jl1t z%~<gZecZ`Xo6pkdikdW8VsLKFpdBsEl@pjyRwHpuLrATnG^sh@qUG4h(vjSwB(@## zHeTj3d8}^I=<-SPv5#<%c^@SHG)qi`YhqfIFgSC}l`kfg`#+`YimKQdVQdyIGc|@p z`%Oj1%)~$qUG>AXW;QeRBzXvOOVO%KlEWaEoSnc10n0=VhCU)AO?VjlJEU@3(W->J ziekc8Jw(GIm$oUDu>3A9YC+KPvO&!O?_lDIKPRl}cuWm(6#M){zB$_(&tpvwk;HnX z8Zek#Dt|Cn_wy_iC0G6s7LD%?=C-k-)@&;bx_YnL&gzw_AT+iruZa$Qa-B|_S&|u* z>ZxKTPmh`nm8Z1Z=auG^z3(sPeq@-*8#j7s<nB-On(mBckoUrVc*-$t7e9+5`oS_h zzLbh!L@h%Iif4+;x+AUXc$OPENMqBT?qT8Tr*5~1(-xi0WlA86;PQ<9%K=xO>O@2# z!jBS$$AJ`iRNk8by-40Odte3a3l^Eia4TA{l}p=^H{WG3=kZ_+^pRM72?8W$&(?I1 z6pA$J<sWXopvVY_T$Vg<&NY+;f}*rS>SEpw8M^h#bI(g!jAx!i6rjHH`2frC^bWH~ z5j^Lia&*C4FsVspsdft2#L%dfsE-S2i1x%Yn}wKo)})H1(p1S4Gt!esZ64yg)2>O< z#VAG1G`skg3>MWlWLpidacWxB;8Z7Wd`2cO`fK#3EYQ0WdzCD5*}x$>hWH65k_;FC zuCcb66Z*GEN!g}~pOOPEV8Bb^CdJVB2631gMXN;$XnN-*2wT3)ImK%;7Xt{~A#-M7 z{d5#UZ`D=&i23y!u?|Qx8=m0fvNQ(ddwm#$yRguRu;4f6kf&t;1{MSS@ca&(u!5qF zZ7JlbnVgkPNZtng0R3xYAIsy2{s%vC?mc4HP5(HzBci1I=A|`-{`~c`H2Av{L8vQW zl(zUy2xil{6o-sg#NZ?4wo;{*wmF5JO_LES7dAEjtmC({#O9F=a?eeySC>tG%G-SO z;56;&cn|07i7NVV&zli6&U-y7Xi0gF_DFVEDF1v~B$R|cIReEv`i5TkmPc?330_@I z%IGpV-lcnrItrBGUt#BXAG}F;2>Z64{S)m=bH#?ytk=<vtX5Gu1jKj4^`4Q=z0@Bq zQy$2dhD}7qZ|52vHXHzdQ6~{?kY#DH_4x?=q3=uSf`?CvmgA^vJ{9|THq+;&%V5_u z^aewpKChJ#^H-E@gh%u|*s}@<Pma*hEQinXYj~elphLlXTsl6<h{3fq*-DA4#spjO zQ6`eqsbm2Y&U5WymIVES<5#2EfsGr?9}1?zcVXVT8kO=OOLoT)r+3~#n=UB(JVPYC z>!#QKQm--dt;W|_3-PLwh`fi-mA{z%EYpED(4UP>_K=RR$<WedTGIa+A^U&{aTEQu zyW=68R>6BD0lUHeczp0n6uB?zQ3WK`1ZX~HxL(6O?OHe=mX8cDV=0}@eo~JGcw!j0 zA4MW9rukr9#)!9}VXP(c%qb-MdU$lbXW*|NbQJvl;kY73%PfW>SlFlj-~i6atUM(_ zJ?DD>)ML@u<H#(ZP=pBU@rE`jU6t;#@{JUum1>{I??$0z-X@uw#kI7)rFb?%#opum zOqrrF&+ss&=nWOcb4`jq4(1}|;35GWzK3)&7=}#+iRwVpK)wcMZVrK`Z?fIy`4I=A zIa0RRJvq1*Qta;>Y~AFAls>Auv3f{ZiR0?=e8{-Ul%<TQD8!p)tmdrxKZRhhYrrp( z#>7fG%1dT_*@;%EB%{lAO{)|eL?}jOr4QKhw{}qiw!U#Yx{XXWUE;NBzkVo==#sVE zDd;Dy`|wE&MsWDgH$58}NiLin-XZD}OWAhE%;g{HGg79a^tWSQeC)>_W^MOth_JB| zeftS2IaoYX<!6kG9$kM&X|&07M>=z9VPtSgFI$BhyMH>a3LU#t`@6V|lTYT-?ObDz zBaCNFMmTT)JU%=_9py5%{0A^tEV3LQpU1JMdi#_>4Imv$(a8Acn~UII0XyJ#`_w<~ zmAnDqROJA!7LE+8n3T+mZZT>GL5Z`3AX#;f$Rl>#r1A^uZBu4$lT*3LL0#K{{gmq5 zrlp)UK|2NiPPu-M<^SKX>F2G#@Uuc-g@-MSu?x-8v<bDZrCrHiqUlpD-!BMZ-j2-@ zEQ?F3j;NMoQz_!7TL^N?T9a*0JnC@bhVAIu`czC<^JImLnL}#joubH?nt!rr(VRrI zICH_LmML_DPk0JRWfN2$duGxrRKBmYDf%0p(@<Nu>U%KOnn%Co%khUwYN}Chkk4Ia zcPeG4=Uf?kSNx3fqN3Z!UeN}9O@BD{rEZEH`n%5iai+OGkMh`}1I!<?Hgm`V*8ayb zku8TLR7pz@sa{yn<<zRtiUm~UWIi;}GYK1O`F7oTUM9jj`ALg*EOVJlCZeYDM%Hr_ zv`-?FlfU_izsY#`jKGfkwbOeKR-<C?F*z6>dm`EDZtu5mY4MbHEPDLC6SRWXT84Ck z;*?Wsr0FDNIU3QJOdjP2l_<|Fbe91Avwa+FTkr2du<X8(x-qD`H+CW|z#Y+e)*l9= z(~5f})t|gfg_9qu?Rz5jE|Eq-L5}&hs|>m9F;;}vHXkG55M<hIou69_IcHE|>u-97 z&!$|1^fNCC;qeu)vBIHJFuobBH7^~nC_AEGE3moTM98JFI6EOIXy{32=qT4{erQju z8yjNiq7bGl2wlil5yM9v@a&`bGb0BJAsynFa=Am(n{oBZm2$lq$n)XGypPU&eVSSL zbi?nXZCd#I_jBGCL}iGo5A+vvwSImPwOJEjyW01>sPdJ7>ZhrnC+ZVU-<HfQX3(Sm zzd?-+isTHDZvMRwt-C%R)^=|3t;8QJqHUv$3)EeO)HurJoNv_V@}yB)fjj6d(Hua? zG)lSK)T>EBYi|uWsLZ$fWr=+e<{vmT3VEX#o!Ui0<>xoCe(ykKx@VH|spN2;B1;)x zqFo;nlXRxRc;ESb-w?73vJ}d1m1h#7Dr&x;?)sXgbQs7dT0r#^r_Gh*C|Gnq56=%K zOAbd<y(@g2Ge)J6>F1`4!?R>~xNOr}Fkx_G%rKI>xMQlET{L4K|Lo*GKiTjwbFY$R zn5wGM4kF2`?$4siO7gHyy;FhhpV4-(7MKj}u!+7Wco3c}PZ-Um;Zb?8>fOCB&A?96 zo0opSGB;7MDc<I(M)zkw<l=0p)2P@tcC1_abwWrIGGfnc<fba+&}?Trg34I5e}+XN zLh;&-_XgZuF_XpOHS%_|<60Qn`dF+OjAJJER0oxo0}(ZrP;ZJ!(orvoUuicp`{kz< z_b|6aySg_1?&=wR;^oO7AJOeBoyOp+D|t7)Cnu5*g|{tw&Pb0q{$C;-;qGkWqmz%; zpu6?Xe4Rqzc2@i&5|!8>V_@;8jVYHxJ8-TRq+J0-o)U*veQF|?JeQH1GwH>C=MERt zWA&n1=*JtUa%Fsum69~h6k;%4I2{V<MJ8)%H_8%Lx!ui2Q&hG?EazX>62Ag4p?P}C z$C?*;;jCsNSP`A$*NxQjY?HGC!c>wXm&j%t7bkyGR`>1u0#Ic2u1f>^-(Q8Ly&LYe zr0jl`fMostD-#BJ?~ljJ{Lz5IpvPL-S=%$%Do?&9sU|rk(HBDlKJnvuP?6d`btu9} zv>d)Tg9NOv@~9DJZr!|+_(*R%VEQ3d0OD~-fO%^Huh4W7EE%%faX_z;Q_UEHNakD8 zr>N0IXc4Mqq<9z8)nW5y9=u%I103$|BMki}WTNgO+mQtO)w5W_?(JvsYCoa#{R*Ty z0zGP;bGgZChc?c9;KQM}dw#BZ1<>=>J1Mulntki_kaaW4_Y>!uU29w2+!5=S^=f)i z^4;g}1cb^8KG@9w@)ztYSlg8@7)bLE6+FC(KYiwmncJw?#_3Zi7ArM!-Z4H)#<83J zVE=_YD$`mg--AK-E*it>O%NoPPH6G7-eoYcpJP?Xm$7Bi#RuR+kFEIN)vAAv1=mR> zLrW@umc+%<KHM?>a`>F(t%EAN8!~U_6K&K1|Kk*lp|3;QZhX#_`Si|)vRG%F7;<y| zjQ5oIp7{FKCFY=#s!5}yttjjmYaBX0NuRpw>01v&>lE|m^G`LgT&GB`LjG1AW0AqA zhtl`H#O6Y)VA-{*3(Qz<!g$>Hzj%I&d^lOKaUzd>RczWo8cT+fCcW?WLUnPa@4zCf zS>;_+`wt({P$g{_cJ3vFkXlq$!tN-KJl+zU65xMD_&Dw2%%~(`jZo3#4HS`9VZE;& zD}RJ!4^_suv;+_H_c(-ytRs2$RN2gILJ876=<Nni-VQxEV@dG}D}N(qI7Mv%MgG$N z<9yf~Q<i%%in;zB=4-2NJegv<E80)&(V^xhFy2j!x-XBgY&B{rP*X`ZSzKNuf4Sf8 zmiANG9(PVXEtIP_ltk;x&`m((S7oUq|2Fr-tn;<xr?#O$t_QuHt-7a{>v;qzD5fW& zIWu1fCvVmo>1MJJ8CuC_C}X-2`gpd_6+`fjOVkh;o@LEZIhfVY?HX+dHXvERSya@j zhh=qSEcWV{@G}8$&SRT&QHB7yVhm%plwWaf9%imY5Jij(c9>1MNcsV`;`bip^mHMt z=32?9En#C8vJZ}1m(jNJXTdVnErOo3ow_HaN>KL7vAPm!2#!~P%MX?7X}Nmvtb>)J z<k(<%B=)S<)kx8iy#Ih19rL`~j&&p1{5F0zE!DyjaL)FW*4JX!a!TJfOhq}Z@A||v zaP)=^uEOd@)Ea&FXIk3>YdQ2*b=RLq!5a5_t#R<KfNmc`X5-c*qwcrQwTfR$jWjH| zDwRokujF(2B~mfiYW_qV75g+1Ei-QG&HK*v@x5vZ>8*v<?67E(dw$M41Ld;H5;1P- zq-|dcka^!JC`?dLdLvVjZHDc<R8UI}(tY8T6RiOEe9L$&)?N&gy@IGn7?T9CH1e+2 z7yB))QmnirKBYlL`S9s)-vk1kiMV7a?^QXGagr0iU9NZ~-eyRWBrRRQ;AH9bSz+Uq z_tz2!bUW6GUl~nA7TL8iU5}OQBdh1>Tm=))7KqXd@K+}h2r?z7siXuSRaO$y{bc`M zYrM*cmG+66y>@y)7fA+3z0+5uQKGTk7l=rgZYt0hfu*4fXVF0mdz(S|mP;~^B0LcW z!Tv2JZqS%zjA~RMHFvT!S@WX`O#ODB$4?8}p5cBYO?%p6*h}P>3NzecAI%uwOf{K@ z_!M@?CoBQi=;PA2Q6G8Rh>SRyVuuw$_iw=}Q13K0`P7kC9#1aH`#!07Usn3csr57U z9av`)meOUs(j<P>+hJd0%aa|v=S_~ksBKr7%JZ2JE86Q|erT}G*)I>-(GaaktMg6h z654C7pGN`XjC*9n@!uY1ocM+BFkraem*~Aud4OjY^RahZ`4t00MTZxzftq{DM<BOP zrf`0Cip&2k7k>@OdZfq;eZ6*EpSNgxi+t+$_8Hy6j|ZGx7kMeS)roPM=!~m`o_0}| z;^3jf27e^ed9XJ<Vtaa@Fk0lXwbmS$T*=5Z=ladURMhd=#)*9o{CHZE{t+>fwTG0@ zOk(U?a%OD1fL4c$=CtA<Lj6kK@9EaEbsJ8hX-Q84n7(7P`j>6^*pb7=%<(6YtVMbh zOokqM#=qFKVp+j@lywwZQLnh|p?=mnK9lDp$l$)PWyG0cr<EU(N6#$KaPLB`nq>0| zV5uFukH5nE^r@emwE)$p$9LDr5HMj}u$&m}sd0}TRbTOq^IQ-=#1`hwNE&u49PXVb z5oNOQNY6+)M7rs`|NPl=)y=8};x$*LkJ~4DslnJy#MAex+tYrm(+G^u@JPPRQEsiv zcJL_i5e!-rS`Ocd8*Dsf6ee`qEg16|u3nV0f3S`+&w@`8HaDwWde^Dovo+(eR?+EW zpY*V}9ivLi<!TvrK{=fiuXv-%5peB{P*sV8Ss|P6{V~>PP|i(V`1*)V>s0)^f($mw zOX=e-XEv?jpumM`TH$ApoSuJNTb|%+kv>=+Owc&EP4VKHaTLs+9Ns*YjCqvvsK@xU zKP$boV~1@LI9EPT3ws=~T7RtXwpYTd4s!*5O4s?Mth_kPx`rxtr6L2Hi&h?!OD1Tu z9j(2D=A@kLxOL|qGSaJPL>S2~{=$kZ#^Kd-<(e@9b=~_?^T}FW+d<*t!O6~hy{xq3 zNZ7k7;D3rBNmwh1rR*ae&Q>Q?jUj#~PTlgUQ~46A^or>O+C+=oxkS40R^CJ%I%4H1 zAG&Y&_MrhKIgz3~ZQRGN&kQK(CSV1>i8p^5taW{}dY;psyrtwIzL4y^IZc0)WJC8m z-uc3KooVkyee+7qqKVi0Rd<_!7oAla1_YZ|#maW$+|!iGF_iqj*n7+1I+i6}RLruN znVH!_i_zjGX34UcWue7P7Be&B5;HT?5?ah`kp=t8_C9mZc`<S0#=JA}=EoDnitbh2 zRh{)^=9k&k*^IB0IRz9bTJs}b(B$<>Mwo~G=H@y!VF>WOT5QZobkvi1W8u=S`s6L# z>oPL%eFD&da(QJKCYXoxVT=Yj%)xI}LjHy0C$u}?%E^AhqNeqTs-=@Z`f6qVQSHnH zBo1T0w~bgP+U=FPlX$t1LEOTbh<>$g#*754Q@OQ6FQit19SLYE4Hm`toUrQDPU}u) zUC0p@>UOmQOc+(2?-^UKWc^{yeOH$uz^q@S9<LD~AU4q$pUe1wVq*AG_AgQ8iwq*V zl4&k2x=1qDp8)AUjYkD;{}0j1&EL*Y{de4z<?*+t=d-`2`tH2Pq1?U1e)A2?-5F_8 z`bKDdFZWy*i7_IX4$3Ie`|ecG@tBO0gp$_0GN0ws{y+ew67QTwP!_UF^;h~m`ziPh zr5ju>bMxO6(*5|)*ohpg<ON5ZfUT99>Va=X(!?e^LfcBA!AFUG9gNPg>Q63Psum<T z6Ejd85qUeUl3qhsKgUO+ZCGEK3W&`IwQ)d)LP-NJH@X8EqWuUlwBy4|<$aLVBZ&Y` z1AnwY=ycO~152!1jRCVJlTgp~mW@i%{L_Kn=klahrQ>q6nmhNECF0ZfZSTUTDJAl6 z{6aG&s{MCg!^7ivfq-l_P?_%4ABjb`cC~GDVwIc<vb*N7u|L3sVX2oEstu&$P#;$9 z4N#MDYdS>=uk!P2>*ol3NMZ7tHfG*$=T+_{N_tSt`h%F6C5?M8Nq-<wh<}<abj9WP zy`{wrhe9hzG&jchb~{jE%#}_)&w{Ve@TciiCe>3RpI$h+VEg}L1a*6ojj<~OWZLD1 zvTGCEPinm~r35^QNKH6`I|IvCW@2UGs+BZ<2crMz5?gJr#|mbV5!=LwG>vG(lN1XN zro}$pAAVj4mEok}0XXl|VrU?Q5DU+K(z7%5hw&dCHW8E&?SzefqiC1O%hm7cU^ak9 zdpzIR$Q)$BY1_t7dicb|r<cNUYi$rU2M%%2#+A0PEAUi%^AGV0?f2=?c<PFphi(x` z-DKw5y=R-D#`<8={N#4WaT4a7LGPczP@~u{&k?cQ8grOg70NqIw7m(_qEWDodR7}^ z4PZ%ry1Td5vnt!)ZC=&)lG?(ZYUDVe{`$BpHz4HkDc?@u58U&sh<-3b(*;Lt@ps$D zIFvVY3dof-8Qlb_$ZV{8?gY0uxn>cJYqm}$wyuyLitEu9Pi?Dn2zAqj2a~<p{3BNK zqO=xAxEnT0$ew5h4LlC<=aG=n6ZJp3@th3(1*Y@Z^<2Mt@1gp@48}M99NZY$sZ)rH zAbS`oQ$Dy!6!I_N{*&%e6#VyUqwF6qH1#)O`xBD=L!bV8x|I5rLzj5Vp+i7G!@|Qr z|9VvP&x$iJG^n>6x&tZ(`&$;h_AP_{mOwX(?G^Ql%k7zkrr?;lWZk-YOQ0LtJNk=> zJN-_cL;OjeH#2J{qjSL}=0ZGv#4Ig@GO*?=0$V2YMtDU}?mUc5*lOXWYNUA-u@aV6 zdLDSn$@0~R%wN%5HZs3nlcxss`IJC3in$hK!zmO(e$M#VXdO{5;a|&dJe?O%hHbhf zIb2RofHO+Kou`o^5=XObNFaRybUxUDnxvY610fvA+8@Y>8IIbhyJd_3mghe#5tvu; z6jxywCLm&B)nUwVpfZw1DOb2jZW0)4e@|V-&(Q>X`%kNZeKCeQ4_n`v_zR5q)uLvM zX>FRu8IoVhsEw(=*qn8lX05?zL0(zHaqa9cFx25m7@F4V0suX{($Ze+r+$>@4%YY3 z4P&zA2hXe#2tF?;Wf>1G<ikIGnC}gUG6sQNE9Zb=$YxD7b>Cg&PnuZ#T(#MJvq2 z&lGXt(^g@PJ5>Vl55>}@>v6RXOHEV?Uyn@b7;L0*HrPm3?8A6ZEasW+%by&A3)3yX zPG>(Xz#lGXpU1TiY&fCKDyT8Yf}SFq{T+E_Eh%-)UxjK)IWf)bq+X`0!uJ{!Lx+8o zIU3a4HcCvLQ}Gjp$PFmK_2A#0Wr-GU_+0sU*{4&AsdPu@=v{c?bj+tiS<zDH4v`m{ z+rToL#`?3bb78V&A0J7sgR;VtxabYe69i{6s^yz~-HwA^+frg4BEwDqHi}Svdf0v| zh3{Bx;9-tm;}JMy7X{;wlO3rfsEyGcRm#gSX5b+~t&}tZ@hK3{{>ltgJHlQB>YBUM zz)Kq}W7mMXVImARh>?fx8h<Wt6HR^!<&Sg184tTq1>>UcVd@MKO5t$el0}QESCGpX zcy=@6{7j#X0aKI{hLy(9Nl3<`>R#p-uejVL<yylw$$<>TUeKtmZ`EMF`+h@DI98b9 zTYc-$l5WNPCL32nQ5LzVb{JFiB;qfy&k$vn5xLx2WlsJK7&;ch{KDr-ooIQa;e+U( z!1uo~X8IebV*jA2@HP@tv8#~6%~<%<a~lM5Emhon(j-NhNGgX-K}~el$*O%4Gq&BI zT!u<IISpC{(hL&THL^eURxrB(9^vlFP*5@u11m!qtGApf6$ViDL)mP^%X`faU=_sr zZ@hCTJo^qH+m#E*syEQ`$as1=rMQ7Pe}M@nb=QE`Q5h0*giW}N6MU$&{*Fgm{^*<o z4;A$-Kv^BwUr}C$HA{IGq$5mngK(rc_>h^a{T&_*ri6R(D!}@qI9eGM-F+`-An7PN z69hO2Oj_<W7DCIiE|9bYU3zs}vagOo`5vWTXt`2qO&Imb7)WCOEOr(?@7;HW()d6B zE6k*X8EtTM3f+rrU(iPNXReS^J)oeTTd{xJ!Wm4>EyGVo_H1KC4Sl-rRkxlWDg<T6 zIA==EDk!m-zpOeWAn-fqjTQphdy<2Pch7{@U1^LUHgOA-(kvKafkJdmYfPxE6j%wf z=9=&idc64@S;{Gto+0A{Y<^PqR6M9ibUj(d(Q%T&BbEycJM0D)MZv)GBg}9Hg+@TY zmvH&#JkigYgHHE4z4kL4@)wmX)n^9~{aDED^2{G>F*<1V{b}0WL||GZ`)Fs?;v1FE zC@ra#6vZnn*&j!-=(Dc62g8)!`wBTY7Eb)Rgi8ol@dIaBdjUtmoJHb7GuwosnRHTG zw?52~SsjN}^lUQ3LOPj}Z|E#_#DzFL6|o%Ey7<~-K_G4MPL*H-#&KE04J4sQZ;@C! zcqw{)ca{_RP9-{9Dl!V?luOoI3c*wGKmrxzMw&T95c*+)4aegoa-r&?Im|RnpKwCX zN?v8HP@)6GXx)OfT%K~n)B*1T?JB=H`hIbFHRh#;8});NzY^58lQJLiv=xd<T>*ep zgezw`ZG+VPCXPW=!4Sph?+a<2!&z~U`88i!l5sToFSk#*B!x2@96#SukN9O5aO8~+ zw2Rr<4`Ke>tQuJ*@?8vk-d0|@P7@jX2}8JFXKTwfW|f>5w2!p*2JOdhyb1O`u?Nbw z>6l+%-S@c`&~CyvelssKxI&GNu*unE>+b#e!Sq<DRN~E^|Cn1?3U^~@XW`iI_$5WB zfmpBNH!Z5yF#TtsoRuD*3<zNT0hN|c{`<oUKf>VHwq8DDiZ6kV_>vcJyPQ!QXu}o+ z?G)c;dEBJP3T!W<#iZA_{vFN4B6%lMMzgBgReSV~?*cSE5|aWJ=AM^8Z>iZAvS_ti zm+dTs3rN#IU9<5&!2WQ2^lG)=d~kq?wSZ0_U{pM>vTjtMIA+j^C0(vPmVj}9+^kke zCMxc2^i$IKskUhp`)6EXV3CWDMfX=LSsjceOyYQ%>=;}dMY_maD>FXPQn7p{W7kwk zx8@xyYkd?nh*&-?>%Bm_%d{IDX%k+tG6tp!*^wKce;!cY$6<v_XJo6_7X9B4nD%J( zNqcO`(PenwpU-LuwK&5qMMH@{+E}BJ0JFQDvC5LbFUe3%QMiRy6(8(j(2&Ebq*6dH z4ljnhkBZ?%9a*zs*(C+1Do9#@XBotqr;<}Hk~lN+lRdLO<Jn052R7i749pa~7@4JW zr4CrDj(b<w*Kb4g9<5i3&|d;uscCqZI1+!G0w(zVJ~ArhY%4GKLGQ||1H8MYxAfP_ zCb7eR%Px{oft6KwnXG@zly#)O%>Hk+b)Ek+c^VD)ee>0aSWp`#yiv6olFO46*5+u9 z;4m}G7{4Lf@kfN{7+&<>R%|%}<lYD3iv@E;tiFIrH;A~H=pxAZL$iDi>|6m3^x9iv zu<a1f2KTxj{Q+)6nwW){u@n0(t{$0X>u?v-CBB2Cil3x?Sp@?9NWynzc$`(32;)#5 z6k)hsZ_Xm%TOQm{8NuJwF5}ntp9nJwp@9)Y?56T?mMJPV#Y_v&H^K9m!N-|s&%)9j zvJ@5vf2+M8FO0E$zN##tw_J^0A`+8*8ue9R&5DZ%n5J-%3YJ@t@+xZ?*_}KckV4wD z6~Dlf;qN2A6g|kKz+e~;zv@BeWF-jPxu_1OF$6->cN-y7wbjwf&=E*2Qhp%QuDloJ zEO5oR4)#+QKMS9e@Ns6z)#-gO3lft4SfcO_XpBvns$<*bOdeP`RseN=)%Vn=W_(-* z0Gm`{8&MrODOFK7X1YwE4&3%_kPq{#B2aLVbqq;Sg_56i1&!+wA+!!V6!LtPBuSRg z-Tgf~=RY>#XHcE<658V9qNf^5e(Tt1DShd(P%U2~mKA!hQUn%9&GQz9got3eVUcu6 zdNHqSe=ARC5$zOJ>#)7E8pZoje1`(XLYCOz(r)&o@PxEBt^wkV;8_NAq<yn96NCcx zW6Thm0yV*_u@mlCJsDEjv5Ihl5hK%b)0(SrGcuO>SZdLm814t}3Q*l?By%g%--h;0 zZqjig0foGU7Q6CgVPY%DM#lgxRGJCWg5ewAOn<n<kZhSG+qDF}cb0!NA(0LPYfzSd z!Gk`eOX1B8juwqo%zT6T(L6+IU72g0VCE*wW=a-Vn#fmyDsX@@qlq`q!<TQ{W`-H8 zmH(=o>B+i^xtQjDP&Qd-a~aN>Zl_azOm>V8E~}lI3IU9Joi5`*n54@46xF)-74>tZ zA}5V@#WQopS3*$$FjIz_0N|Qm&)v+@2e%vM@KK;+n*}mbMO%(JfpXkQEhm=aT}uYX z@F+dGRN5blx924=AtwPseG08}6{UkyzcaN>*)al>%jfgFK(&ZCoCoKUKV7}Z8g@)6 z#!#b#PX)ai&L$N$cRW2GAQs|aP!(V_>Cz_wnTB}!BVku3c*_}R!AS)qx@gte)Gf)# z-k)BE(3RWMN+T@AR`F@yw5&TOk1EZLS^^C|%c4nZqoQU?Hg)n@7L^vD=JQ!*@Rr@w zX_`?|Kj_gS!>P=7Fh;U5$F+?7QM5083C2v~da=xO_|zD(O0$8pN_M{6SPrkL?zL4| zveM0>r3^eDl+_>6<MPRnm5+ZU`Uw8vD2s6`fK^q{u^Mx@WF#Ge!cGdj!ZfkHRkYIn z@}69@TJxS<fQ<bRt&_F6MkC8URbkl{T;2sPJUlwd^dDb!g>Q~hKp}4S2cFq|fNRlS z#(Ow}t!{QAm}{woE;mkfOSX|U5FYT<KQ4WUhjTBuv=LJ7eU9=PD{Y8YFfI6A@SFwf z99*o@w<HbF_#41cQZm>l-AX=wS4{qUoZX@_nI<@Re|i~{vKSTnELJ&zpIHC6gSR*H zd1QiNMWgf30pWu?r^5T6)#Xng5mcTc@=law-d0o@TxX~dez0+F@DwecI!pLUoT#on zE#F_Ea3w9jAS3Hac}Xpd3d@^lNv8;o!mTXj0F*BPC%0|ado|(CyQjtHdRzEAt90j} zz-coftvI>t$@d7ln2Rm1e_@Y&^6OpZhB>$>L)s#p<$FJ06<cZB#vC?s%$||L!Lzvq zrUF5{$C0V$^9WaDe*CI<IBaxrm7(mEk#cRrx7w)kvhx>M&F)`dDrIJkTYPT4fO_c} zG8g3g%x^36L3I{V#hN>GR`<P{oF2Rqq|zG1Dj|=O7SHEVaiGHT_3^*CjC!{zAoA{y zaLyox^=M0>8ww~1_Wu6<5APgZ$68X=BOjJPyGPTbt0Ty5KNkJQa)l<DM`crLYssF_ zy@QZXn?Ti&TB7*46^W0rB_rQZ)gY>^9jl8-!{S9BdX0%HQQZIaavk3C3+G-E#`6MU zR=E{Dc9<1<(_<Nym^WNi0qA+b%aP_-qujK(?35*1{@jkAL2z^NpLxxgRx-#2K~E+1 znBTk%^#(yzvDA?kV#FF0$^0#-urgOX+Z|2D8<^W2?{RS6h$d~lApR0w+`C*6j+<YS z>Z|@^6)VLoXGKHk8xKJ)bB)Ev$}f1M#$$IM3hFaN=<7<M{LJbXE&?lyv>j?nS2A0R z5xsqP8Um|adg_T<D*|V=F@u-*A<SMuqPm}Fj@xsr>-tz7KyOQl%Kn+`Oo`5eDgr1F zwbwYbvd#W^{Qtts{*~-E{_#g1ziHjSc-g9zKPO+4mQD?!lidB_AltqR6(LS_Tdd1{ ztvmReuD1PcE1jZokS4_&3lBpv&5^JP@$*ijR3iMCs@1dkUOfM9<Edt6;Wf~h%o0Mt zlu8)clA#!5{b!WtcJii%3iAOCVkW!{l&c(rG&ZV6!`mET33^EMWkdhe>hu0$V%brj zsLXv98)@xaTOeg>W-1*mt?r%|Bn8{*9}du#K8Lz?qJ<S~zwn-0yxvYmbVQS_5oyWt zdM*QzR{Bo7)AT<E<>X<ELH8qH%YMTS1Y_oMxB1c%P2U=xTdO7F+W*I^?WPsr%KG;Y zamQWMWF!F2syvPVI0z5y0=!TOIvQEX%1nC;<S6?+%Cde?Y~xt4C>T6CQSBdt)v_XJ z8)xT_ARoikh`HCAt5Ddu3Xk6*^|$1|l)~#L;M2QEQT_#{hCsS##OX{!@yj`B*!<h3 z@DCYYRsAQ1^pA-v|L^Rot?MmgCiClkM{mW|;E-UzAYowMQf6;kzcOZQ7-XpAZy7Vk z+!<(0QjWKj+1sMi+8zp4QI)tYN={=eF+(T+OBgC~Rdwfp_};%C--Ho{sCzz1T2CDN zI(fX;W$xm*S>M`X16tQ@JUy?{as8sf)W%<)w4S*zX8YEl>8-))|KH$0l>_~Y<vwgq z_Qx6=p{cQLfA0+$?lpmOG?TL*XZ_V}b2TklfI&I<c$Ydb2_qdW#&T+=@Ii8jzD>=< zfpQM1@R2N34vVw>3XI`sYU@XBemkBQwfckj{%0L)?d``_&LUk-Ptmr?OCcb>alVxN zDvt&ZL^~bhOgX5L^#Erndr$vew1p-LCK9F@bc{$fypYy5uVE@c$G}H{5=@a&2b{r- z!QqO(QqzxsLy8(c;}dXbG>^B(OIXm5WZ?2E{Twv9k>vhnZZ%en4KDMO0@z<*MKx8C zy;`*}L_fjxF+-4MYoo<A*jIIK032xHNeY2*$soU!jXV&a+owqBARy3i!Cq<GG)*vn z<o*65fLK><1Y<`xG!B)$=+z_6+B!~)jQ|UE)%|EwA1z5`mACFn$ycVS$;Emn{&SEM zGP7XtMo=1|KwVX`ICb3wM*j+EagBF`J)d37Wzw&5NO?+?qu@i*=WaUmqTHXb^+D2j zQ9sD<OAEtM9iYB4@^nRPzP=LYNPzk%BwJLZKC(wg%=V+xK@j97GAljNo0>+T*EPCg zRN3+<xaCVA)n1I6$|ZD3umoH_1cZ)*QtQk{h3$~oCXyM&Tv}d=a;HN2#>pd0p~4(2 zlRjw{pqBu`lEW-5Mn#>Z>e%+Su?kY85cXos>JbOVW^{}QZGEgNm-dwD3pAa>>dQn@ zC4O2mN=M@sM{aUjSa19c6SwcC@XlGTY+mQ0WWt1RAZ^RjO5ao&SD{8P(FjXAw9%2V zX*NU1>ye;D!Ng7YD7nsIR&M>>lg)XGB%S7N-Y-c&bQm-`*%EA<mgQJ0v^gm`=FDjd z8bbMLtizK3DOe+{p_QwgaXHLP&-z>u&WxMFjXVtL1Aka&`}^>DKpqgQq*B6?L0S9% zqYZm{@}y7P2wa?>+)_=@t-}N+W_Cv@{g%wEpIUfkZ;ctfJH=JsYxCK~w%Sy~Y<aBg z+9X~dG@kr07*Ug89Jj`_{9F!E!Gr4F0llmCDT+@XX7B!T2q>Q}j?My96pm#aO%7); zw~aVD*2Q_={W;zH7Z}jNEr@rzGT3>zjN^uIVcR{NG7Fb&pL&0>v>zG5I4_=_QIP_h z@Ub4zV7-Uo;l~5w4pa8K)Ua)fl2QShFsaLicw_kw`^M?M1QXF+Zv>&A-N8>RWE7IX z$0an%euOZ*_d3|BbL*@L2BYVJ(dg2a6}`pLfek8iNl;+*1nw1$H6){PdW_QV8%z@p zE%4>`y8wfX7tcd{x_mdAuw`!r3#w;J5+TK~7^%+jj^1K5ynsGRH0=`9eZ=Qop{uH= z=kj+D4<*^X<cwvf>XQ2YR=wsZ0lYljv7c73CppaO4YJquF?$9AmSqA1tmDIQlXllo z6<QvsyJc;#-*dcs{qzERppVooji4Agz*vvC9EhAKHNVJ$6V3{}sz!*Ek9(_DT0;H$ z6VUrgjg6#?A>-6Z*wQ&p?>aJ=jPZ)Q_E>K4R*u7sgdlKxdlRG1qH-|Gar2AB$<Q<X zD{pxKZ;;3$Gly9%m*3FV)|Fn1^Jgb)934BH`%5=`MwY;xZam7Q!~5rtJQ5XOxk3kf zLRc|kK39Cvay+uNxvzfL(i67RD`17GKmo>b&QlUiB=4XIAx}a5Xv_IM&44)DvbjJ6 zbRRVOMU5^Z4UKWxfh{#lq3RP3HkcXEjRc0(Djoe>d;A#z5AMYQ(Byy^L2iqU9I4HM zv3v7t>v{FN3awtL8d{Fbo~DbVhovA^2g5sbBhppMZAq#Y9w-c3k5o3at?fZ-%xxUX zDzhUT!c2yq>=)c-0VD_BmfYk4ifu}~!QyPzY82xuN%9(bEWjrhh35m(E-p9oeo7Q@ zT&DrbAggpg@7pbux1v4ELd1~t#@LdSAiF`>FQw?>+|GP{cS}(Re}SQ8TV-vQ-IwOC zI+(><uZFM`ID0WrQ%ii)zXz2Vdlw*P!T7@}#B)1VqrX*L`57d8LXTWoUo^l@;8V0% z0hqPk;7Ax7AhfcOAtwJos_;%?;)=WFyL4`<vZ`Zd+`fU6_7CG|t06Ctse~tSY>I6O zh0JILN<(y?N4B>Zhb*>cw5i*U8tF4MGlgY2y?>MDH(erIrmh_c{g2FZHl|ALR@zVH zW&)3KkD&-SY)9NnJDOo>IwPS986mVgEHBYu-OEwmr-u}{y_85pYWC+`<W172xZSa4 zv}BHIu`Bdt93zz)y1@rau-)Y&Agp&_e^f(0G_*jTn~}0NwG%B6(+n~(TE#l%`Qqet zYbVyCn~yT)faOZnyn`cSd9X(}A!+<MKWo!t5y}n|CT%ij%;Yg(Lp8A@j@R^#tD$6k zBKwm+*Lq$QF9BlqC0>7!&Cl`y*W6sh1lTA|ziD_JtdN9}hZOsAyqfKx+2W{zRz>Q? z4@MoWo>r)o$=sXFbKyLDyNl$XlCF(0%*jT1$KKvH&`4mYYF^h8<z#v|VKt97`nZTS zoF2S2)AMfT##%`-y#Z1-8?*kE^VRVf&d1|OGroaj8;3E6+*hh~Ayku+ZHuyIR9Oto z2A<%_8{o~OJ-=84<SMOHu(VRuPWykcp@<yh9)E+06sksy@fR3OzqV!o3@r6mF1ban zcSJV?kwG@CnUcP--EQ`0+co2}(mg9Ob*Rt{n-_&{ZhwJoQ+}Y4jnJ-rdxcCOjwyxb zHR3yu-hKIa!pB!+K<(8QN#x1T_d>V+tN}n!{shsZ?8m%fA1s-!0Rb@%?mgliCAf>a zRDeijNf(!ieONHAYY3l|q={Dt4`&c-vsV$OO>W8=v&aiy=R!CnGCrd+tW>n_<i|6> z!I7pW`&W!SY@ICU4kIU{c1vr~gB><7#AR^HCB~NF&o(0uv)KNWAp?Oip{ovkI(M7J zAbrFb8g#SB=FTSmL+gj;#w3ySdtU7ArxQx61ncS56*Y|A9@>6};obf4)!AT@p`B%& z=Sfu?+KaBHMTU#&zraXKJqB}6!jr4qP~H(?kJUIH_vxg6Q43#oqm0V_Oku{Ydb+9k z?eXJUu!(JScwa%I5yYPAl%0(YcZLEt4nM!McFi1B?02Pd+ZY?^I-~C?0!6k$HvP|5 zw)+=t>GpSO1Ej&Q>5~G6>z$_4Z?=OOm3l5F-M;A@$PY&vZ7v^0ACR`##8>#t8#$bc z?bvQl&*^5|4>z&165#TP&ld}c!>o(E|0B*!EQu*vHJ_=nGw+#JUpgp1F*!03$-_FO zwPtaDeSU7t`V{*53A)3+^JnZ}*-{lZl3w(iyWv!4Z8zml=gS*XvFrBvzS>9(YqvJi zzVxWeb6MoNF%*QzP;2BpVe8}K-XffRt8c4#@S>3(|5idteSi1WXW@UsUTmdNG4PJ+ zxf4x~Y^S5@C4+pAMdISMSG}{g;^EQm@^>cPnve;W9s+S9l*ry$I=4%Q8^Dm#djYnw zdM(P>(6)#mh?-e5G@N8p5U0>eLQe*#l$(?11yGh_MS9>|&w69bN)DCXCXFe_Dza6- zGB!i|fUe0#D(O+rN%Nb{6_$TrX)Fhn0ATxM#*z)vak;LEi%g@Q?7)Su6H*oh&!)Mb z(VDNWG2}q=2r7D7s{YFL<*}=LDTv)B9t&(GqaV|TMMWVj4d9Q&`Ejw)#GVn_O=&lK zpk8cXlH=xP<(v5Uj2!-G>TT^&ejtInLm$&JTHHa}Vu#H8ikcA&`Z^hUp$<JEu9&`V zbKFRB^9eF&UE411GppV<`+cS~T}f+q<C-a`=w_Kb_m8unWahk|UY2-9-lx)^BS*-H zSF7V*Tz>LYfZ?Zs#LH%*)goECKw1vcb!0ChT0xv&x;`9z|0OMI_Hs(oO^RrbKF(B= zaBf01f}r>0l%FS@zB!g0gtH&K>^0BFft=_~Pk~&%hJAE^=~)ML2t+U-;<7#|*n?`+ z>h6j`&J*nhZC~czyd4)^@MdW0JEPT$3L&)X)12K^)r$(#Jyjt(1fjET;+RA{1o56c zO>J&{2HK+vaXKj0A#N1_>ld?!CridH$w@ZUv1vNQKJb2~%CJ$_^o9eV0!c&<HYi|t zCcu?qM{{Jf$V&y&d(~Hvgg(_(d4e#Xp&)0qW?q#xnhk$fGtn*8eW28FE4S~h)|%<t z3zIl@yY#+Boxm+0;^N0WAFv9N`};Y5rn;yX3GshJ(<Ay;YJJK?6$2KjbsN;AciY+h zb#7nqsF`7t!2H;>%^}M#+;z8yFw%`$j$Tsq@-gI+;0v*U1;re9n)IQlp1T?S1!iVo z2eiXQyZ#Go?y?#wB}s;@O=6VPzRv7m%-*W^D@#Z`a@3VN9uE$aLzjY8Pd@Ib0O`zV zToU<H4}AKnK1xI{+o{q{)fmlL&1p59PlJ<n;LO`fQJX4vt}VM)mVwoQ>&G@*U>Qe9 zuVPrYTN5s2L|sSIKAuZgV>{Y5&lOU66X+=I*?NH_(hOvS!V>@0>e=cqFz%bTWf&0$ zjW%wJe}O3&o5TU!wiEs7_!IQo5wVwxaLf=}og9JH?*wWSqqQ&xpQncQs}T%$y&g<^ z_cbTOMFSj^&or24pdz}Ie3*Wo{IJucbf}Wn`0?c7mGY*Od*zy3QKu{Ttdyu*c_yiW zq*opH)CJ*;+$6{iczSuNu0#Y=dBVS>|F0T+xenNFAp#DcRY}=6@>|8O>PD~Zx-L;P z{$K6fVQMz0>XN*z5L9g0Qj{XH#W|^-=`gI94_4Xl`2Zw~ek5{2ym3dp6*>qK$RM0~ zpnMRO(d(;W8E8x+K)6ib+HcoXNy6Xc;d)7Elm96FtU3q^{8H1Iwn(g5bQLLZEGwj2 z>`>cWad-pIIP{h9^xmiH)_*Drq!>XGoX$|yxM6pfE5w1ZJvxg!0}$Aat?sQwTMcV~ z=-X0pW9e_#wQ-dZaAYIB(Z!II!B=WiMO_v#n^UpLsrX1jz}=HKxVJ*-elhR>;7ko* zL@Ov!b008iTi3K3LWnb(q?R(fv4np-QZlxGhz|`1nC(b?^Jh8}6p}u%|BYkhfU*(d zyLx0~$vGXS?wV<YRC9w%Ut*iZ{U)T}0-=G%<O#c+oTNmqd`XPxgmY`8MJ`~VYVPyy zX*~P!B)}~_i7|jBpIp<~3P3@QXNlO~F-Uas=)>u)p9qQUuc$ZEv0Jb?tA=hIdQSe? z;$`(r+ZWMmvxCkVyBAMEb&CTO;xLcr*dOtTCxQ*QHo;9op#=42ePd)8sI})N!y3z{ zY{A8-W-GOy`@Zs7+oo>Cy1*9Lu&EiG{;oPWjSbCDhgqF49pBH`pSR{Dgx86f+-Cf( z&JN(X$B6Y2l7hdkU{yzdv;6JZxhBM4CcS3D<QoK{vKUlB%-Uk161M{j73}XzRnmlb zZ#Bs>*}naJ@^AS#gf>)o`~xn3u|{bv+&IEze38nAVL!PakH7FV_aDG}j;2q#*GRWZ zbZ>n8`$Ijn_6O`QC|dn83cNYlE(~XR<38&b<NQpz<}_;z@jmX=++8fgwK&8pjT2uX zn)JK}o2zfIM!H%f$3hbNxxSH&3UM_=AalmP{)mhf|9}*aRuUxx<OGX1QyskX^=kTk zcC03()@KE~oopN1txc`Q2pg`P2~L<@Fl;lEWlMpF6yCGsFj7xXh0-mrkA&PhgS|@1 z9f7ZD!7u|7sfno|?ZfmY#G85c1KkTUF{1mD_0B@&@X)<}YqfoBqo<d74#f~!9cJfL zgB_#JO$5B+pq}XgQlCP^_ZN4Mc=^V~AWbSswj#V6q>QI?E39|K&b_q*4PBv6Y~(j~ zPim2IjQR9P$F}gJ0>4LV9J>LEDk<fS2(Yz`F_mNV-{A&2bu_!Q9Afnw?CG|7mhG;+ z8eoM#mFsT&+$nv~z^d-)jF5W%bFBvGHO(}#hIrN}XITEJ6@|W^xF~k<Y!z-0B1xuO z+`t-*t=!kAc`<OpFxmtL`Nh9$cRPpoKBS)+^_QBOZ|^lR@U+%IZxHHZYx!eGt{LRa zjbTnJ;>J^0r^kA;wARif$!+m;zI<7AL7aec!oACbG0A4Cp3wrV=*H(@-ldV3v_xDq z%~k`W)Ed=42~@jq+K`JMJA#hIC_)Ql932`?3wHAAFT_ncO6Ux;77O?i7Y6#6vm{@6 z@0M`%1G@FN4v1BMVYoV^Qo%{^VwwRZWx^)wL`Qbwozt6Z3Lt;BeDgt<MHuJ~a3gGS zSEM}6MAS7!xS6ae&Yyetcdmd|KNjB^;16zZhs*CdV83zF&`V=;FR@_P6mUc2Q%0*^ z^g$ZjNaN*v@I-|k{tJaInXP`K)qzmPZtEEI-l5eQ#SHZ57W|d@BjTCBFk9Bfr`cZ9 zG{Qho?m-dso)k;^=e9A=W0&~PW!GnzB_&H%0&h#GFB`Zrd-y|}=RGa4kST*$T;o;u zG_Qxi8^3>f{Ou1r(G`L%jmZy=utE@tt_!2Dv`lr2^&!3Ol-{%?_-=h}cR7NDxnJ|q zvz6!a-QPqc{KrvGs>@+XYqnEgpc10K<Qmt03EX(@9;k+y;7GHmrClEEasG-d-U5BU z4b4QhGP8)D;0vXGF`-MU35w^HLIQv$5->x=cZBp|cfxL<dCUi>fWUE<2eo#s04&LC zPq(0$#NS~~Oo`Z&v>kQl7_lis<kzo_>!LCP20(Z9FREFeSe^J#k1|`X)GqnP7W4dJ zNT=?)gf<>lUkE*U(KJ}l>gmW6RX9T#%(o4+T|knl6U!xwMR8;98gw}^gtj81gwd>+ z*C40&ros$r6(IF-PtwrVCyRXPok*^Ftd0p`G^{nP0?0^9I_s8v-Mk2<rc%Av6}AY? z8mp%=z~>z!>N`;$gQDVRI3Fy>3w<e#kZ|~W^<6%1|BAddJdBS{b9=vh=5fy>w)aqR zNMz0uX5v}pq9u=5+x0!!!+8}4bmhI}wy)qCj){?ks^gCzk9NN}%Et>aV#SpB2mJa{ z)oCdtKE<QCZL4VZCkY2l5{gLh`z2B@9u0~{pyfh2pvv_=?akw+8zkCZ^E6kHudZ00 z+WL_Fa`6BZ8ZhptPs-juFG_7?c8J`Jj=iVeISc49j|<%b?Hi}!X)BMrpBR!s`VL=R z1`IbYC_j<e6&^oHJmBvctTBWKJ{?NoDvevyi(Iet-kDS*=x(yZR`{+u2$Svoa$(0k zyNo8;+Eauo&@qk<AN`ZO3ZdGD1%|SNf2qO{!Pa<<fm3O%ewqVRt1;X--#vh3K%y2e z0pv1fbC(~?Cq5_6;WLi;kkEwoj>!9YXiue;Gj-mPocmLS5~8^mE8oYab<IyN)L1yB zN@r%FV)naNET<KW$1JG910ifcqdT)kaOrru^=d)Iv<<RvyDyz%o>nNRc742_d;6WL zn%r@6G7Uxz2X6`WQA$aSl^deFb<JwrDenlgi5U+?oUU-|LF+VwtXrP9HJGW*bBW0y zF$<^AD+eP_!u4A)HUY;#?`wj3TkZ-56XYU{h)+vz3z0_EwbdV@Zlk&$^|H5C<4b_; zA-{~dra-V8jD;zmEea)|-sg#4^NOr)mAwsk`djJ+b(G2j=}wpgQ{R3u`EuCZzWJvt z^x<~p)?GiXSZ2Palk<w<w(4Y0@XjLk&C6jtC+N)!F1RSdhU5d7rz4mTLwtbocR#;0 zVIfD+*C-98^A-euq_&qPT~iwf8U?eBgd;eysNY`sdC}Aw5ZFw?x`Vj7uA`ezBV#Dc z_Xi9kzXK}q>r-uZ7pMS_J`ROC)^mo0i_Hn0CbrCiv1w!zN8nu?o!-icrdi86LB1Km z;%$)ilL*aJGuq6YYMDX<JFg*otc|4w{se&m9fiwd69E0Z0+rPSUlZ|(0RuNdT9>H; zML~$g!qx1C&;86U(a?Ygn-e^$VX<zCyw%sSNHtZlW?qM{u`ubJeU<F+?$zp-P0ihW zG`ao-&g4|ha_8{&=t&RF&6(dG+VJ@oJ^d3h*0>XV`6ijvnY{i16ew~-WYNnCDs7yO zvQV|i3~gC2hI(U7KbC$?29M7{G?sq6Wo@IxQK3V=9p-2n*_bNN&&r-RhwjbwTORMQ z9LmzeX~!Y54Czb&2$*JT^lC3!^=hL&E)QgHV=4ND@ZIxU-s`GJr5^zrpBOz9|91~G zKDp6|$d(t^m7}mQFSmsq3$q<u|8#N~kbkK+C~6Ak#`1t`^zkx84^w+1?a$mJ#~<w4 zKB^DFoXgD3k^CaShTrYJK#^WR4;Wvn4t65+_k&FO2ZfPacP>PXF+$hER6T^7FAe-U z(qGvAj2-6Qp0UR0QznI><^Y}*fCmkpn#VIDLb<yqgc!A_DWh*<f2i^8=1ra3dz%Wt z4ww^^t?$}1oC2z|P|BY{Kzf$HtC5Tw)isl0O31c3M#2yd^dg=v@y-qiuW(QIQE=nw zg@l0(C?=OFz!N|B5E5-yMZ|v)?s;3QponsOLi`o?Wz$FDYwHWaY|~HF?{+RyjYvil zL-3WQ21Nb?qBBUb5A^|=Fn-mV-bqMXW&xK;Q!XGUFE3xZiL<tUTsB2fg;&PGR!=<% ziTtlqEd&G)Hn*L`S;=`GpA8D&yuU%9yrB8r`Umo6X4g#!3}CLPiu2k-Coj*W)Zp*= z*5q|7T4;xS3qIC>l^tvUo8bL3d?I}IP=4uv(BISWO9iukU%*1ZZ}k11@i$}5`XBu8 zpAWD3D*qq&(iEnCvv5CugZEdS;?F57e?j>7N&YEH%Jw-B`$s?XZ7&f2$#Lbs?&&h1 zg8#m$3kwbYR#ErY4>%Ya8QTYCqbpQWRuKokT&39Bnadu-t-tTuf(w(W<>Pk<-<em} zDqgEWvoe8G+4*emMDzYv{;D*HQ-p`Hmx0i61vk0#tB78lu}Td%(TB?KLk%x9li@V7 z<aIYAreML8v~j;QM{J8GRXsmQ;Xue%a9qmUPbuJPjaqOS36hxzaP866AN33Ncfdom zMBIIe2rVb9t2|fXcbQz2CUN&f1(;64xT`7gsd5~`wRxCn)qQ`GwMHzOU~>VE5$#0G zq2S4P!;m8w8V+9dN489=TS4H!i`zFYX|+BU`v-vIMTF%wx_8eAeqZ&sW=8%{Zsi)8 zFLsL81cfi?QL{d`0b4L$Hub@rg|eWsHg?MhqBg<lBj??;c!I2*k^;^JZf=bKjG2ef zdJ!Xp8Z%ZqF&=h&De~J}sK5G|Ew|a1O9hP$*xse^0ji{Ub71G;J^SbDBf0224g|}E zAQJQdMYTvG?yBA{2kcxh)6?ZEDnF8suzXJQi7oB=nGsO+c~^wSCwuaR2i?|P-m?DY z7dcIl2vh?Y61qTZa<mAXmy{;agfwv8X2uS@=uq|mhY`V!%tMP*Nnc#2B4++%-@%Ud zIsp5mMei_WWp3<_+{!m1Bk8_2TK0EMt4qcDnI0}j|5H9rS&^`3rs0k;kyW%O>{^c) zpC?%jn@1#SikrhZmhe0ElChN<qu}qee}3t1U2QeQWy;S%!)Ya=omZsL!RxS|T{W;3 zF(vu1Ms}{EXYgglC$o?JFR)8{(KVZZ6+Ml2;HnxLi!iRBsuX+Hr&>_4?(Ii>{U>>` z)Q;mSU`h?(I)B=Dm<y((zhjbcM>M3y^}U<yiqeWBd_kw)m0!?w`6N|bUxPzk@`!!e zf<J|rcm?m;tx8usr)OAf+NrsOd3u(^cR*t~B&2K9HcDVLM8BCgLk+FwdoFK(@2#Tc zie03nXH|V;JDmjn^~S5Oa^+VHE^4~@pE2tP`khYF^EOb-4Cb%D`+s2($PZC#PlO{< zSLJFi!1YZS8O@>^0V(^k2(m(V7g)i7#xf;WTu4yKyJ?+Q5HHX?*_P7z<W9k_aZJCC zqld~+FGc|I>~v${GLss}eD5Om#rW&3erQjAyVv^33GO1d9V&#*i-?x^qomKc;rmpf zHs1Ja3~W8LdK41Mp<GOe;acfv*^;JY`uKb-ng<=z&Zu84GC>7kQ@prwwiP*2W0@kQ ztkT4iZG-*1qT`#0h}#u_ruhzmNUV8bw?h6~04V|y|2Xx2JI3jiZW-Y0lo5e$+CjgE z61kxz!KxmytQE*rQ$NbiIET1c>U=p%WsoOX#W3fV3#fMnt9-<LQ&FK<(HfhujOSSs z35drP4;<wp`r7=D{ZPmFkvhn>)NNQza4hay`YNDh|B%lqJTB@nmVPy0&;%wgr*0~9 zVsRQRn1H2EdW)*e^qSsdrBJZ7%Q1%{2pX}OqTqvZTcYNr8tga}pUOcomdPKCb_|D% ziV~r}k#4jyviK09sQDd^O<7K2J5M+zNHam}eIBgj9lZ=2xEo|h_`#enuWlk4Pu7-j zr2${%q)fo$v|w>kY+^GGWs|~DbraG3vjO`_Y9vs1#YnU{5sYd{lNG=?`zAaHRX@7! zgzvKURJ`aJaNi>39L$>Q*0gLHo3M2vm<E!z$Nukka2Id<dv*7Go)p-PKK1=EWhQ4! zc;`Fz48bCFK%ztT$_^oV?-vc^Gl=oXPDNLoct@lPz#$;g{;<RcWBsWID()_+JV|0H zu!@Omp)p`5&^9g4*<ACgEaMWL2KA>-*0TwjA8d(|^1ZEDfQ3o>%MEOz)n`r}rTJ2) z_w}L%>PgPA7TEJ<6Z8TP=hBSpC-`lhd?KG5+PzaM+|r!v?ouJ|SWL<*5w=5!J2>)P z1q&(pdS60^h<HV{((A4$((XT^71cCrc&2Y?^&Xeq_LGLgO8y0=EJXhK?XB60XAarp zJHqKhZG_patU|-GJoQ4Aq8@s3VGc7K`M%={m+*-V&(y|N^V3!avMKNDIU}|wRvmo} zL$J$uZ(DRlrfFe(IpGtdddwPHAxCqd#zHZPsd?oj!xLl6a0lT(ZlLy+E!G$x@0BxJ z67=G>&pEE^)!9TlbEnimDahlASqJU{88{cV2XoaqT-wb+kgWrloIWuXBxv-KB`xU^ z1Fb#RVG7>PY2{RJwQj(RCXCPNHE%f(xV2t(@Y=XLa+YzV=N;@bF$Dihzq}~JmF8r9 zud+0+;Gs>}F2O9#0RTvu<#4rW;}rwv$f%s5^3E5d&{9F{3^r{Yr*~BfpABs)e4=5& zc2RjkGq-Ez_2cSEB_$KppT{dOA^M_f<of)mMi@TKV&%NUw(*Q<zlEz@(4k!(uv)QT zSx1Z8PwdI<?so}<(Mpb-p3#;7B#I+|<#KILNXTVbzh!}<k@r%Ifp%6`_)ik_JZfux zemO80@==x-nl~#RNt}88v)GfkM*hA}krJ1*IKFuwYQdsbW-ZIq%oEDjsj|w&6d%{W z=5$k8eBg7*;w240MZY1JG>#X5%wLaCL4o59AHkk>5I<imyfDm}8CYcq_iHxby5a<< zQ_v{wWz|@yNnP~*iP*6eDKf`o1ageaP~u^)z3!&j=%iq9ozwsysb|N<LRMhvFcmaf z@IwUm0PZ*6;u?R(Y->jj!-L!pUjTGyIMATY>W3d_6{s8KkMknRgy?hoM{Alnll|ie z0|F5dP|gXHrrV1?Am3)gI9Sp5sp7m#$wb}R`@6o$6^x`1l@dWWet!t+lq+cinI<st z9qAV4NO!RtVwCI{`?KwdJI))GUgCKq+)pZa5C|-mq(Aj$kuFmQuAlcGtrnEA#a8i* zZm)heZ(R*<W#%>u4DLeJoP^WZghXWlJkIKPP%6zefe6&*(~4aA)h!s{W`bNQi*D(8 z{cI+C3Ak6_*_`S1UfR^<c&l%T2hpHep1XM&lH%hY1i|}6StMu|#%S-tAC(JT7axo{ zHG}})dHB==Pcz)?=5g_7w-?)zh0z(VJ1&F4yrOhxhX<M?*Y@Sx<0A1j5`1=3!hZIl zdBi7SJfW<;_T3BDyiA=6JN?%;-r-k8ZCc$1lRr<5?Y$yi-gPM%Ie(0UR5$(}?Qzyn zR8_kXaU;y)OzF^pb{?Xl&a~`ASGaE8U<BZP2Q6z*8TYW8ZdhC9K43Yi+28OTyZJ+) z)>1M|_$>bG74%109E06FxN=N&Nlyt+AZ1{Ob7~fsmAdc9MHLl<(W=>iKEXJiDXr*I zxXsUQFlUeW&}&<4{`~J<C|0*H9PKm40iTV5-!&kQFf**c1f+=gXTF;6ou9uPGP>I6 zp6_*8A1S&bt5&e+4)Y~jd`(bj4$+7M&@+t2mEf2N<yl#UWNd9$?(9xh2=-2JM?OeY zmQ@%uOi5LAl{V}3VCE{&>IUdi!ISFSQ~wmCT3kwkb&Bg^EjO95lx%Q{k<o%Y+{Ome zhitnv2m$^KfP{quH=XeY^qsK=TL4I!I<OwE2XrRWGkM<II<FnI%sCYuDEuEb$p%L6 zJPk@%6--5<?*(O!Xr_(7w)Sf@BU?CC9q3KAWqu)~<yItp(F-jNzr+!=6y|?LgxKO$ zrkC|nao+S((Is>Io<E(a_8PULD%brNn9P?vyX@C7>zD8-+eB2XW5{#VuN`^OE{t+3 zbU>7>r&|D$^ZW9j8;oR6Bn=Q?Fn%jYImiGlElKFFD-$1z8rJIqJVVn{)JU{pr)Y)v z_?4%(2c2l6F>q;^<0aGdulk)=<usBE8X8D(;X5=U-A^hQ2JzpS8BS5C2c0I|!)GxC zS8a)Q%(rK+S?3U5M^e{|^6O!nGqWFutNJ^2N_D<~2bE;j3!(}bgByZYNPFY3A~+3j zJw`87oCW!HCA+wpc5Yv&D}vTd2<dnX-rbN@mRa_zE61>A@vY77^-0y>LcEW}7dU>+ zyq~IpSiWe^nD!#o<X*g#MumM<DHSur@#ubHKfT?73e<x-odDOww=&pa1O7CrVd}$1 zbGOs_j5Q%Tzid>|*i)FG*L~P6=MwLtMnO16#rQt2jHrtF7A%WU9s$*avmSarJ;$=b z$(+2Pb^jsRvKP!ee=jv?uf;o9M<czBvu9ko@O$AHNop#hPRVTvyH<3$x&A)R?D11? zU2av=C&V41$NOx7o|G8D+x>u%?=u^5CwG0dMS?^6j-8fAxiPY*o~i^fLyqKkNSe?_ zmDD9QjXDYSUuV09ipv)!+ezaBU)0cVI>yVlvkb>mws7J*G~Tbab6R$rd1t^noe_#a z<Exw=i32rJ4NsHgTn0%Ww1iV+Xus*9#~M~^K><Fu&_&BP$5oAOAh6{l5^Ucqp%o0r zv!-WE3I>89_^o@Lz_|AV9%R5rHgE@-%u*z1w6zL6o$Pqe@1|>qn#{1P#yn$5wTTgo z&Npzt`Fm{8Mj_#jzx0iWbVzBRKCq0fd+iYKGc`Vx=0R5R??(*0wqf|=ZTl6{ak`#p zXM2w!&2LNZ3kUE$+9^wZoqpl?Zl<Lk_37(*POed54MwW(GJV;P1N@+n`~ak(oX<-( zAHMFtzcuqh<)ZQw^CjR?_jE`~k*>7XmIF1LuJLJ8l$0>dwx=|gK_KXl8c!Z3U509D z2Q6DvY_IWGr<;gdab3f`yDS^0WGjBW!&lA~ag;wgh<wSTLy!LipP>gm|HBNPqq;3I z#kH_^{Ho-tm53A0B1>fw@(XzWV@$cPs`{~gBycYvpGT$;ffz<XW7~#Yhv<SUOZ>f> zY??^LK?VkT2x$?@8VI@k2FrH<hq#<X5*!AS>{hEU%G2UaKRH?Nsra&|KFM9ibnk6= z&0&6D8u2=RC>v*Qx`aVaGWF!L+3DJ#^J)?YF`drcuzj?&oazch00S;3|2TOVpB8N# zgIm0@x}x{L!~)5*AGYt>USzWmPOb00ez9lDXME*&&PvJ@Y=lMj#G@zi!cfz0CA^2o zbwl)<{Tg#6T=z1NSo|%!bYW`#_~2M4TkePAX_q~CZa*s=7(T3%eX^RFFU|Pt?3~+_ z?_)4i&z{g1dy9Ic<pQ3yMZx#b<pcM5?S&1f`haISfd4Fy#ut*q0lb&wW9PNb9xJQ! z!wEg$o3)uwCKG~3*6m$D5NYmW7139dwI=jbBP-(WD3onqO8E;c^L~u2U<TjaAaiY9 zD;d%ib;k1QvlMP3mc8C#=!!?r7mNEaNx#)^lJ7(~bj|_avcEH_CmFn7TGX*e<#P5O zyGtZ}j}^jsoitu3am_P@hPDec#ueTfb|6Ei>Ak%w{1JwtSMRhKylYE!wX!msJwNkl znYnpc&PtBH8`YpHtJdK$>~`MR+$HHtZZWOKHmdj24o<-vOZ9QFU_LzL8&FSB*`oN_ z_}wsd8**;bt13srqWy#hPmH&0iKP1r@eQ`a)neq7$zJCdhwQ_^;Lg+6kaNM_Y1oVW z19A?w8s$EQt2NI^CW)DVTIb#?dPEZ;eS-tHSXjB5vrAxLRhc2{cikshzJuZbM(FSn z@9Ox5S;hcgNqUypL8l%QaCtFMQ0p_>P9-8rmBR(6DFhW_pp}J*D8Mqc_=;&j&b}D? z*f%<1czbk@6ia1Bd%E$-ZORG((HwY=EXR7X1>VSi1^kGD_|_#9?89INPrv7fl9ZyO z!TZt_&XF8?9J|Qwu^R#_6F^^<N6+M{l?aojShPGTLB#=TL)u}{$AYMt#8nBU9j3(u z(Pa4yDvudN=H+B*mBkbGg~#x_QEkIYrzAlQ9-;f|EB!%Q-7lNde59LR;}Uie75T#E zAvf)TqWujXGQgdhPOtLi-swwy`JGm&40WCD{C*aLu$#^(jO9VH%is(JjB2}<2)pq1 zKroYm$MtUP*_M`~G*ZOkf@S=9ro-EWLM6=In=8Qz%P4{OtfS6LgKJL$KAEe^#|F-Y zBGDr6<;cou;QLnq0oqcYp&q!x#9wKe2lxb98AWgJH(?K4=U?QS<5g-^n&s&U8?c}U z2i6=(N@y>LqZNfQ)=j>gURRHbAi0xdZu~ea4JW+S@p@Ktk5aCVf9ocD@{}99F%T&R zs=S7$;tpDb5O46DSN<R?R`8BXvX)^;BGl_5;c-1EBn;|Pub+>}T)oUAPn5|5yryAi zD7RMZDVcotDua)Z%O&nT8(r~$ojiC9!%dqiZxqQQeWJ~mGYtU;3r^g$81r_4PJx~8 ztPmidfqayt$MtNMhf`Kx+Qa?NrpP~OK|egZyQ+?#6%D3Lu-8eX$+hB~f`#p#Z(_Uy z*oeJce{|zsXY<$Zy@f1++54Dw#s(rMmB>;u-&Bc*Qp>aV1qWG(WP?5mW{k5PS-gIj z^v~wKPvMv(ZyL^fn~nJ2-K8Jl4ip7>3|7+UA*S<rlOo__f-Jv)1}2)sV9WJ>-Yr48 z8!)z?tedP2GzqDioL?LK?hq}srsmya`3CVO&t_tVj8gVTszRdZmz*3#y<(aX{bhRh zvjgHCd<w1Vq_2)(L*E|PQzuLR7jthJ6z8%v3J=2sm%-f!3+_&EcMAc6yStMN?(Xgy z+${tRgy0Y~xCaOx0s;0nNzUG9pLd_SRrjs?<E!cF?q_MQ)!j4Cv_2;beU|rC!P#0h zZvft6k`0spTZ0O^KkwDJczIMb`0cA_6DPH8ldk#<!lWE`0o9|ch#sQzB%XFGeu)F0 zMO}`~K2czdbt((-y_zI3`+DBvWg$tohGfCwwAwG0607X9bZn-+5!#+rZg|qcbDo|N zgyx+u)S@rPq85<Xn}xOadGj=1>RZDH6~C|NnD0Ijj|*$*h8~?gdQBJk>C#M4mv>b; zixrb&c0{U1mo!nh`%~mzS?6sdxZ&+Ly^wk7FCn~@Dr&SJKuq7+kDS-*PR@}Lm(TLE zRqtlNDS7R_f(i2PLRPS9fz`{ww5Ul)$FYC@#2vS4mYJ5#PR~#D3f|6z;H!5sk(V)! z`A#Idwe7*hFj5a#;|n9;uji(ai@Y4O9XEaMPoOf0PN5KadF+>wGW!`nZV;|~miiU6 zZ&c5!9><`!u3YLtARab&j0O)IX$Jf}XXhWcx&In>{xbpr|IGcFg8t0>&lK(rjVXvA z!2%ch3j-8`0L6agen;2}$i}dXpPTRhgeAZMlH?)(hmar#&;?L}0hGTvpkn{2`bi`P zm`VCk0s-6$Xr>({e%}uLQ}oXi$=Dd0HBN|{`h?K30DF-cOXKg@|IEYvqZlfre=8X1 zZ~0%8a*t{9e702Cj}5L#a^~3o(+b-5NXR?fy=Fx#I(bOK|HMMlQU9h+{BQZ+l!Ak? ztt$@y3WNVsHH^mR-z*pZ5S}Ez17n$S_(_xe;op>h%ArrhbI1LW88(fSr1}r6Vo#p( z!doo(9W#CjdEq}<{vyN1_hCtrhlQVzi+`xb6xi`bU2Q1%$@ovziSqPG^3*fGx&EnI z9+LNOf&Wwuvs&n1K4~-mr)rqhe>&~+KUF78(<kw+{IK*FPg-&Pr)rt%Jh>H5a>$FU zS%(k*RL$<{^RJ610dW6CHT5rt!%Y6KRww<mni7Eg%ZL9|4YQgR<j}eVp&&{6FAj$! z31+MAudwp&I{v4_fxiT1EiS<tSdyG^Eb@OiJV+h{D@@!g3Qmb*L65y8+`0d#YZxyq z(9Mb}qwWPh3zFxz{JZL(l40!S@jl#1Hjof`NNNY<-wv1iWe6N3;Vr}s^^>>pPC{A9 zKO7E9lFiB;zWMeYFVXtyKUBj?D-Xezry;t#hh;87BmcBIL7vc6k;F!sI+pi{^WRoe z!svenafrM8&TDyn$Asg=+kab){TnL}N-U&LY83dGdo#S!e(|TngZ_nuV2gqNYG%P7 zgcE)_>Zdn;5&Z0`KEemj+wVX8gk1dYo4>vsexiOp?i^l|q1yb!{<QkHH()4a7zFgI zuJM11N>YVA{s#WW!mR#}77lw%KnDDz`K2X6o-*if{rc=D?=O>os}P4kk#~Lxgux-n zBR}K61yIn>X7(rKPpkieVE?D;zr$hq1Zf=R+dp~#?eL!k{z)m$<g>r?7t2qpk$=Mf zbScQ^0~hCSN>~h2{o9;hG%zx-LP_R_zl6g&7wDI$-!UXX925rs7Z%pc{ssR<0}}=J zMV|Cu`JWD_#D=MWh2K7r2NBAXT>OT>;(u6;V*{D^@R#sk{rX>wKY<A{D?_P&VSlx7 zIS}?=(!{A9I?Q2Yzr(M(2K~)&P?&%DU)Us7SUrONH0>t~_J2AY<|`Nk`b!!tlK{*7 zt*$SAm+F__V7$MZ+0V?c08{<j)iB0i5SXI>QrACa{t7U%zgqa;Iv0%VC&B+z{U;aj zcjjjqc79XB;-6Okh9m#Zfc~rMzv!|5yXt=l`Dw-9t^O_f&lvnOv-6jzf2;mQ@T++L z#p<8*fBNmeS^ZP>FUkKW)k*Tteonn(!LG1{hX+3SIraW)?i~&b@N4Sbr4S6;KRr!p z+;?`aw#hE`YwG>y9X;S5N4j@zPW5$X@v@@Y{owtya;88x)N=kevzR(8yKjA4_-$2I z4-vM1+!nf|zGl9zpdAucLFA|r^Tx_Wd-Vrk8G;YF&32IxPiFJ?9EanrxOzH0`oO@A zGk2sa@r6G`XikzlJhLv>VLG>^wy5rn+3by^RHpFQbReIq1kGM1(US<S$<h}}1gl8_ zNf~6oM-gjEyR!9@AgsWIrLBTg=f*6R>!;;jLL5;p#7)G?h5_i+%0GO+FXy}(E)~l` zc{H3ae>x&gBEa~u5iB#2TG*%{^VJU8y_{gI&uZsqdbfi2QQpfyL&32`r9m8yFuXX+ z9ti)$AdHN=47W5xQ=aF|O>m=z)Dlwb+z8U}8YLvCl!^^`%Tgr2q@M?qhTza`;gFRE zhum58!<M0$(mDTi_#qqwHwyIZo_3KdpXJB*bVRgo>R+FUyK>^}Qhm+ex?!`GOP93I z6|{@xP#I^oyo-LcA%;iI1Y5Eovtgz8%f_-UKi+k{j}VMz1BoMlFGEUDez<*f#WQYm zyLI^C=WzySpXtsHUx6`epE87792`TZaZ&4xWqA$O8zCo24>H5CiL7Wbr^!~ZlBbMO z_*}s&YuFGt>yKcgC;`5V>Duz{mYQPomQ3a<QCQ*dZ0dR^7+;L93fPvvLY$dQ<#PQn z7rl_%#f?;N>|v31krpJ7j!Tf}4eyhaJ>aX}HIYO+k2QC?fj|r9CFv~Tx5-i)p|2W} zd=s<mAQu-tA&049GD~=-7Mdo=dzwT}U5X)P$_6LP{H|GCx%*2#jRc_t(Xt{&gD8l! zS(KG!*EU6y)=EOU=t8O~O%AE@1%nkh;^LD!dcSM{;@Y&5anOK;hlA%T56Z;X`!Av~ zFP?5Krp-uTi!8C_6F4UIr^IXu8h*${?lvN%tr%~fFg5k@qFUhbc+Y3w)*ASs_1zYe z5U*Y4r#sCLD?WxUu||4|@%lYA_W-Ii`cbphvcoExN-m6>HCuzkgO)Clr|WRvXG_oH zfrIm2Jsx#}rMs)Edr*B8!?JD>8iXOkb&^Y=3EStKoPrZ{ZfXEs_z^k3x0Y8a7-D;9 zI2l{E+uY)P_hgqFX!zFBudsISuFG02edZrM7!Htk63$Csm@@6{-^})tHlLx$HM8p5 z9x2EKU#7o#7sA3^x(odVEK+wxR5SL9vrPFqTr_`tRn)tYajE^ahrksef}nEk={1Sd zZQ7yRrfqnn$c84IEc!z`VH&eAZs>B{z%qjWS#Xc_i&nG9%-F_l-@dKq^QW&toQ_|g zf6{C8LE>%(xkHZ#Dve!{cXrC_;1{Xtn<A1=LxFnZk~rUd16kbP+I5zUf81jsf<IJ1 z2A~t6`P5z|jRP+6jsk2y-98~o<8;rAbv9%O*8hx&op-cvRQ0NmJoeCXdDt6k4tXb6 zaTo!N(eoDFR#-<RqP!$Y&3ay?DEUyJ<z-4SmxIRQ<DEu?lgo5=&D-xo2QRND`QKKF zL$C$$nbt=cq(UUk;%}qgJJGpAC32D0zLj9*_r~?f(e)AFgS}l?31_0KIDJ1}eIAQJ z_?CIEQIu{%H+%jN-3umqHhn_;4b!x%YVzg6ELmqhf3&YJ?7%uzjym+uGPWi_Zf<0w zP=pwTtBmh$Lq1ek)29T*!a%dgm(h+~-0{cBCBuT9)5^`%%cNSFZtqguhstt>`iH$# z^uA~yg2k6R59I~9M6!b+Gg`aJHF?R^8V#u;{QN~Dr|~>5HdDN>3-IOXOa{k(tZ~RE zsTj#sY8fIu{sCxM=7~7=!`<>3M<CVTOG*7901Atdm_g6d$Oq#kq_re@=0DUM_XQ)M z5wic!B*;_h1(ocJ@?wfF-`JWfL|_Xyg<kZm>o{EP#@|qWV<UDqZIEc}P7h+&q{Qe} zTJjjo8j@Fg%1MPB@?6<Zd)Ww7*k5EYoHAui=^Qqe%rPdd+sA;-mO@~did*+2BpYqO zjo%u+H#!!Y$WMxxD`=65h|;IYOaLFU3Z8&O&m^P+-Mm#A?<$59?B?wc7ny2IRe<Cs zN7BuuXQ0JPrOviG-O25fwNg~gX<WY)Xp^W^l4_cDHK7W+B>Ht?A*(}Q&of1>ZM*^( z#!kx4rPk~zf*_7LrCe$Xwrk@Gyf<)@D>pY`8}D$3>iL9)2x9nYsI@qns6{Psr%`L> zDc{Crpl}xiN#bNc51E^Rl!FnT8Cy2;F+w;ZXsWiP5Ut3>VLCDed}Kx)I%95l<qA-J z^4Dlzb>G&M>0Kx5N&r-hA>5`lsm09d`Zc?6C}9laO`H7lH<Ba}GEwr!6lz>)Otg{f z?5Y03<j;yV!KL^!$*V@5!Bs(|nD4W-G7TbLx{7e(ax{w1Zk`^BBRL`O4F1pzG%tyX ztJ6u7i@!FGG*MC?@KsZk@T2+z;19E)UKxVw93X!GsbkJC^6o9xYE&M#=Ik*cpI+XO z-q<sz`3RyYZHu#GLvB;wk+pFV&06kiUh7Ht0y9!2!)Ot{RnL3SiDDVh(LC4Gl0QqH zgWsWaw?&C?wTa@)=T!YG<F(S|=%cnVD?4YC%V#AUEZnrO<pFs*(!NXaT+MTs@35k4 z4l=iR3d`}^5|tP}E9UQL;*NHFQs@eSA8VVJFX|f*$#}gIe2ZaJ-Vop%q@)qTx#T_O z`$MNpH}c3TI&FA~-H%{di+pHX&#EvW?A?pAx_N)5>wJ_4tN#D}1EY?fbKd6TAWW>^ zGb`9BtG=)Ud6f|~to1J?;P&V4ga~4fAMzEt@|+=awr#e)y_*?YoSUQH!)}UGBOdD6 zGka>d@cb$`kou+4U5P49sf|0*l9_xto<jmt$6^u`tmmj!^b~@0Aq{rpIJR*y6If3| zP*-ILu%fz{X}2`lvFr^!f^347plM&k?PFG{8Qaq~3FXXWj`yhB47i|6&kOmtvzm;P zOuTbfWM|jj!ZyT-;}eQKp2|1RL=*IpK7KntHsovi7C>EHdcHxP$hDkc2G7nM#o``J z(0yvI32?Q_G9C!g4j##iriu4}7tl+DOLalp=QZQrx>WQ5Z)4SnP%e%!F2zWpH)q8u zLSqIoNVKj?k}08R;v6_Rv&&>s)Kr$FUu3z13DgsV&c<8SdeOK<ZZqk;veo-Hz9!Oz z1|g{JF)&kCfaD0o*jkQ_o~izJqDd@KDTD2B#IYe~L?D<ou=KU~xzUvW^D7Fx2gITO z{exy5zCrYdcdAz#Z(?7ZsCOpcU%=|=XVZY~w62(+j~wiaj4$W4UrO(BruHDoH|;w% z#4o4Ak~u?F<iO(ey2$Yjuc;8G3f7!!>x$xSGxa-BGj5n%WdMr>I4--xIbt!k57hqw z(A1x?MU~&LrYKRD(6ori)!4Y~(n?6hj+_`EFA`J>MMkd3#F42rw-sL%+e*;1nSB^x zPoKlZMiy8=GN2}gfO*%eNQ^9wis|hE0Q)ELIQ0Hi0LPjrq>R(_0__<Im#eN_{z4{M z^~1X@J38Xv-1<hTBTs>13+M)e;@tb8EgMTqunSA)$N~>NK)%JDs<oCxO@aGWNfhYY zS1VoeD9xuUz~{zEh#`5RfyJl^gkJdDAJCa;z-`8WK@GGfHhb|xeq?obY?Yzh(I?uy zB2JHkgg9~)Hr71wPpzQQZvZF-YI}N}ihB#p7rGKQ+co&0CiG)Xb>tRtUDBu$N9?Sc zt+5c3!9;`)*KgVUceKB>y}ncueI8eztS*5B^`B-M?Z}EsAP{@$DBgljO{RGO46CFU zMKG9(ptg@qO2SS5;NYdwl$jF4c2}?WqT{O?QD7zZSWl34wl2DMtG$Q4MT<f3$BXeF zK{HF{#l1$iVjSRL|9V0K1+@WWM5$ZLqbQm9khmc7qDRIjjjeW}9hq1yO;H)MNZ#oe z%Hx%Al-b0CcY5y~6c9>%;5&(XP*rH_?)Pd1kKsHFo?u&m#j<hwg%2yJfl%F3|1(9E zP#pH*EYXxIHz}#r@tNs;F%$@#$=;=dv1z8lhEz|5SA}sR($0c3+rmL4)OP7hc>z8! zA0qGIL4?Q{EtcHRO((hUH$89lSc}10-l5r%X@_R|`b*9et<D(5SVFNqtk5if|HbUu z!YSUywq6uZHe!q*!=P6-fOXpCn#3(;hwQm%>EURuAGULwWFR&JX|4>stnrE2=h?6| zZ_hp3YIqB%_?r{1i6zA?LhXyyx_eUU$ssdoiQ#k#2m&sYZO|X+(X%mf9cs;-VmGB^ z%)5}C0lLM43UCY;lJ(GL!FNt%agZ(fx*}98qMvq9G2*j=xk*v$H22#;ldxU}%M5rp zQ<)HBe5Ckm${)iWQgnE4P{wY&FCu%LoJ;q{J=qAQNb==4OYYKGr{Ey3+B4`UVC_cf zb<-#sSk7L|WDY6YB!&1z4*thv;z*WyR5*1NFwzqCz!n}Hfq{n>0xD5pP0}exH6X-@ z(&0$fy&Wp`BBo+H>NOIhixztmrBPVkjtm;Dp(V+=G$p4SZ<8zbgZWmx_JEy9bv49r zPz?eAWb%;;FP8MtMc6l5ni)uom55!)n6kVbRlZ7-u+^nqyX~37U42>)Kzr#`piWZA zo-vm_ko~~A4!~q|2Rhahsg;gNN#fwoeZcY1L5AW{G8WU(w!{o&K(oKZysmpPMJZ*1 zy+u3dJOz0&g-{43z}PrDI!TBGut!VuLqTPEDn{C;#;m2!Kxj1PN|A3lP70Fk41BXR zw9Q|{R^vHIKuh3vL~F>?z!@I|+JrSZq8a1`cl3{tCGjFMGKt<cuqaT|i^nWll@{<+ znpnVtm2(iX#|1|kW5eZ|SLAg|PzJ}8s+SkbLmOYTe~_R{bPl6m4o1rWDmg@`l%-6i z!m(9<88n!6B2!VKj@`g7y0bLWxx=Ud+eAjEvn$CnVGq_T!fnpViP-#LxBLUp6tn@R zW{-5i-r~cqM(73ZF{7S+=mKLi`BPIn(&i(FrkH@)^}=!R+&}e;$skMmSoh#$jKtzb z92i{JoX14$abd_jyAVam0DftQ_mv}cI9Bs7E0@6mB{!0rJ`<eWpwr3@gB(vq9#P5< zHl(LLqTLR4^;$Ti4k0PL;P@g_RyvIxlz$|y*0qVewIxBoGOp)<V{F3M*S?Uf9YP}U z@P!+T9pCkMPeL@vWB~}@P9vj$y28dQTQm%H>?Z)xgUT?pSI>7xCtpT*+|Rje=<9^m zPO?AO*5mZ-1t9e5-eEj1N~j}-%-SP2FW`fmWhBjn%A-7!tI`YWt?{{^Ee0i9RwHNn zrKZ4s3%NQnSQxT&DIjVi@QD^dU)(#EWLLux=iXIMg@#i+kwMJ~NK3>_ZK`GtVC*z` zLTy5XMiW5nSa1JqZf5Spaq!!6(Nutg2xWSuJOe=joOcI{#f7w9DsnPeN-xsXWJDMi zeNmhXAEwr`XGeV|_S3q3KX@3cH*YUty18?lQ{;j3V~0<n`q7d_buBDh)q{j0gt<0I z_&b?>HCv7@`i>NGDHUJ)8jDaJycAP~N*KGPLo63jPsE6K!gW;jGOR%8ZA8k$WeerJ zxWQTqbUW&hWVDZi9Q!;~$F`rARSBcqtjl%fa;e@_D=+!r^F}wc03iyfUdT=q(V8Yj zJ5J1(syLqX9HJpIOl2xwNcoJB717fH7MzhGFQnE|)bx=PqTjmNqFtoCC*v5i<S(e# z{NPMhsr-e@z04~A_OS$?VP-hb2zhY2ZD4!x-JLnoCN(0Cakta6W7y9qhfwGSUhFZu z#~V<YeFJ|A<z>{^j&f-0F&ch}aEm1~R?yLei&~OokyNnH{I|Hwf}~*PAoNYzi&EHX zbP4*;B@D$zrVAHYlT*k@NnzL?Ifg-vXh_UBHb{GJrQ*-WOd^*}=_5<hiwR9VGvcmY z-Hml~6u>_3OkldX5$TYq^|hMvhxEhd%&Em94W~<Hb3$rntg_UCxLiM)<Z+jm5Y7a` zIkHM$mu(_-kW|y*-p{G-IC6GU<?=+4CrwfIB{&P;6zN78<272O+bJqQ4N^>vO<Yej zcK~A%v{aeCKGO($pA81|&Gc}iG|a_qGL?oR5VKfehpoj@h_0K69~&7YL>we(dB;LU zdPaj6du9rL{{uRCifQ^o0S5S3(EL#iyYm}sJF>p!Tg4A>y{mh@ice^wbaBdDGd@}M zeN=(sZ(?WCx&%_ZN$yaliW-VEg=lm5RRVQ{2$tNj;OI>EH>}xRQ#IijMjZ!yNe8t= z$RgbDwcK6`BgIk1>kAb9?%G*W*gWp1I0oQs_{x;oZ<gp4J_3pC_Kukl`E>V-Hk~h> zJp$d9RyEY$`nZ)CN^gRTvE?FDoz=7)#MBbY)jql!Q_FXkEv2Mdihc~vOp#!-HBkt` zfrJx>T=$I&bm--`o^?%Ne34XK^hQpSAySg+heXa5it)wB9?DcZd^0CqjzuO@RL`y# z?xn9($PF)i%~5Bh!vK==K@HEZX+G8-<lSUciOiuTZyZMj`8~7f8~0|&VEKsn`iFQW z9K%?v)1aOxRg#>E!2r;vhd+Z61xvug_g!%5y>ZasvBB{jlE)8D4CAG=RKW2^@z$l3 zWwX@kG@{i2gPQwGyYIvT`fwgEQBvgaH9ZMzIEJi%=m~iqaFa`FUZBN{Bz4H(n7k0| zZfp$$`A|qgD!y~NXf~Z$Supa43bfBO0pu-6+^B6#p$Yh+AH~-mo}?~F!V?furq$q% z8NK?xhEp)4_+otEE-kaRM@lv$FWp5PuD{`6JqCCe$QY#*R=0)kjy|Q8tu0t*2CdhH zKdzw0#z*rdCB~QP4}D?=Cz2~QXF@{xK<lpDRuy~EFJ@yL2=5;5jc2B<QTpm*aMwtT z2wHH6Le!Hq3U&rx*?3e>M;_6j$0p6f3yQ>d8pBQ)L*G&n8v;sUZO%sR_g|m?3xLJc z>%Rt7fuLW5s=uaO{~A;cECm1D%0#JV+;{%xpz6=NTfq14;_uH?XXAU@YcVt98fNOQ zup%*^4u!bNmEOE@6+x%3@elG6&XGysoY9}W)d)tIBu#AIu3<6s_Qq$UO@<vOQbyeI zPIYZa4B<4<@d|n@CHmqtN_<(?r^eEBHgfxtTa)^Y^$IQOLrC`6QGeLtQE|D-6_<62 zQ#{K%k0C`&s^`16`(8RJaB1Oud?%9Pe5vmtUs3};CYutz(}*N5@mW2UE0&=TusZcD zHJ8ZBdF4`q5FvF$qCuF}H<z1*MTDPgYCG!YHRgj^4lSm|nm3}+5qPZpoN$N}FUaDY zvL0~I*J(PjM?6v1v1y<&{W`N`<fF+)Bf+lTL}J5sZb@VJ3J^0RI$Z=Hi8VYFtTno- zm&JTqV*vO}?Gam+Vi!2KGmV9<v>x!~iPf`=qCgf2(nZEWYQz00ls-kG)dQuR5&xc? zIAdQfOsfI;a<~OjGmejk(m*{RB>oY<&$-@h%q{wRo6_PfW>Ek>Dk>ts?ghc|+a;+Z zEY78^Bj&Z}=oo#RV4H}|7Se%WIEZwQga6n{KjY`D*A$%qc5}K!B<@u6att1N=7t_S zVuKF>bWh(mMAzQ*<kZDT3-RF}_Kr+z+=MyLnD>rx*`_%>iCx*6s{*kQD`jZt;_FV8 z+9aWY#Sq!YI<u;t)5RrMFK9Bwxm(X^uk9erw~;WHibAM4;N;w_-+mR;;O%~iWpEkZ zi#7eei_CbNd#n+AM}L%CGG0A{GH}nz8Qo@(H+aagbp@dqw=d@1)I~zE*le#%Z_6r} zww~8xh-8dhiR!?{#^W=U0DRJcYjYmB0m@7(q3D9taw1c9p+8<jAA(<jLhIw4dBBMG zqFES>vrmqmIGRq#b?JXV9#H=YF3ed_2B}LIOp}w{c@U%JIgVqE?=!TI$KD~|1*K!> zrRC3Pp|Km9#+&4~ooEMlFrXc!RFIgxkF9yz7rm8zJFF1YAUIU0<l>$U*vBQ}GS^LU zm6^$9WJX4sMim<0dA9`DP3xRXK}^`OqsNuwG|62WF~MvU==6jt$gEm5hg=&vIC0kH zFjIg|{YB~Rx?s=Pr2h)`dw&wT#FirNO<O=wA0oWTh;t!vLY#`MTh8ukP1&GxY%%eP zSPK-n1TC#Eph}sIf0N2DoaHI{mt+$UG)x6?ONiTtFDpvkgx-oN<@MFqw>!E;8^NJP z6E1QVa~#8{`|EnEAjOXqeCcc<nT}Sq_r&c@0Lu$Pw$>ClJC6yDsi`w07ARSuW@mFT zG{xDVY_^|)rr@P~de=lPY0|l|2>gJ0r{Lfn-l5M50qYR8U8W(st1${7FG%djc$`s@ z^GNCKis|<fd{bHByqe}ABmGhWc`50bMxy1~3rZi|$K3_Qkf;%>2>4KFkwizv_^##M z=<OV!Suo6MPm#AodIqC1u?jgeoaE6NrEe25ytz@0+b4Y)r|kIz9${FHyTncNkV#Y` zlbN+0UV%^?txkYEOM|OGU)*FF(K}lif(ALFIx>!>t~;0ISu5G<Qm3+WM4?aS=-ZQu zO=ha;&gxX(6(f-wm=3$Q$*X59Vi2~x@X;<b4kUmze1>M}N*vZhM}cM=9j?%RsS9P_ z8F?0g6f|Nnx{GltZBXX+WBL)^EByM<-N0~xo+-mXQpCRT{EJXjjx7b;T>{>8+AUN7 zX=r>YP&w(j-S&QSdgp>H-RD05$u<fovY-8e8ej3$_SVT?*|my@CX#6ILuzhEywxIB zF$xX`_jzEOm!HxI@A}M|C<2ZL_jA^Lu{>~uJr2v}b_`8D>#q>?6K!eSd(X@St!?BG zE;2pbd?RE&x(<`@joWK0QXDTp7$sl$7CGs?F+q2?%Cw}mHDQlFvUfI9AXSqUWg`>N zp1(X318s@rc<W_zH^OH6WlKxK7<60#J4`<=3Lv(1`D;Q!P5eDIC?tgCp$#2h)WEZ6 zn=%TmA!^06fZ!qB!9|21^2<K}wxKAv3~GfE|4fVt;DEDp0Si5k5ZGaEmpEu9&4*h! zre*#l*bn^lr%^(uk)GTPu$cr$CLG@pc2qQ0qR0&QEJC#cj&YFKTnC={+xIOY*vjJB z-~kz<XX<K1VA|}LMc^P^<E@b=tSCTr`D}U1Jw=`oMRvIqMXk}cnG(D{w%1>Cpao%6 zbEJtjL`~W1+=byFWY>;>3N$L8CzHuKA7WH&=;>RS3Kq9uTjHG^@D}B+Zz|bDq(hEV zWc&$mP&isXT0)h+DJo5na@SI;k1P0mikU0Zgu_o1GeX)IW>g!I--(f2dN$cvA%)Vt z<z<V{>vdDoX#V2tw1@U^465rPC6(($%1D|4(Cq>0cZ`1e1JGNPl%cJ&0EOo0Y<MH( zUJ}fs=%dz}ayw;g=W-X1AV4J1GGt`IQ<hMmF>=hC+N%;8L=I~lpP3teX(_Rf(lc~y zSf(R$`ZX33tX`TgfpufAi`$F)Z2hJX=A$pg$l=7f^Nf#GZ6!f#&R#s!A;Af5_O5YP zZ60h1`lDs0T+Fsdj)H?)<XF8krUHX51zD=>p7bru6MC|h^e2T~Lt&omHgF~C2v%RK z2#IdFi3C{W3MvRfVS|>2WH*DF9+DF=j7510ud4n4>`*vWY1p$RysHZJpg+UI7gg`N z<e9r~dul=LAdW8#t5jB^fHKX+INXGnjm!G&O4pGkRztentW^CLM^a9U4q>*#ggEb^ z5c%wgu4>D-&X)9C>(@r4-@T=z^q%fFHaX*`kzaDX$f`ve?hqW8Mt`}AcGN~#{hY#2 zBqDoX!Ka@~Zc2+^wSCH-gJWdvx+5B+ES<rWvD0#RG=SnQ!@ly+Y~a<+dbLJImg932 zNqGlRon0N;3Nv|*-SW++LZ@32aX+?Rmh6$&_+xhVAg&t0f2|9=dEWcu%|^hdGtn>K zDLno!5OdD&h4WRr8BTlXE3RMfALqq?o|BBAPkl+AmoFP|E+YHpPy&If<AwPQn)XzJ z3Nvmv+yIvn6*uZGkiXSTuQ7LgCy<)mSB(}3XHQivaXwKL1zaO^#wr{v$v80RMYS97 zB$1}~2vA_Pf&`)|Bms3>og@Px%m9Acg;||i@vw#tma`Q+2h(hN%IA43eR+7D5i$i- z{m1Tkczj@H%h7C-0FmVBA6cP;p~B~*k$xW6Gs*NcL+k#k>R;~kcY(-_cjF+Y5_NV7 zNx!AY)|8h(Ni3+8N<-%1a~v#^mvuxH>S1p5aF%lK*_4_YT;qiTcq<yHn<Gr+*>XMJ z445{>y!lbA3erPy;M~`J>ch<~7y41&^`(oXu6ex$UL^J2H8{M*Lg_<<42|_$h9EHl zLJ)06^jTKM4zv@+er-1QJiffq_nDizb7$h`B4m`%5r4na2+@$7!m1;qF~5aN^6UHI zx34))|Mw49fVuI^>6;%}!Boz&Ooy67uT-bkUt{BXt$!!1*f)5V`BxD8K)+EXbP6?Z z=U*s>dl+IL9?!SclM$ro+`eD`P6Od?j-Lpy<B#WBW~laYI(n#3B7a8nmH`!me}3dC z;gW(_JA4GkGk-M(=peU6xC4JbhmJle*Zv7^Rk|o;1($m8k>g245VeQCPqKt5og2He z?!rg!GX98WCoZ)9Y&*3PNBl_pcLAOSRn0HsKzz%0`V(1DNAx1N9yexvMP*_+mCIGo zgU0K6-?{46%`1QeGA52?&<LQ|<at=JGLuoSe0u|UerUK@0~Bbc$VB0-&dGpeQm9k_ zckp<m?3edyt%r{?*lTCnY7{mZ!34+ZRbU+a=v}$5t0CYYmH0&`&l{y=TsY6^-MhR$ z0G{dxqA5`pC{V(<)6N8MabN2Ye44bnkKTj{=35F%Zlv$Ozd7&u>d!wUs&?y}I27cb zMouDqI#Dn%(rRK<OjLklEy(P1{+<DRPLJC}o@&CkJR8pGq$~#1Him!RU}M7*r$7v^ zbyf7~6J2`)uc<wIDN<JuQ$&4c%gmLYg!D2lm@jp_ikC68Ju+$9IYC_k+gz}TF!#xc z6aa)rt)Pz~B}Gy6!z~<kQp|e)&`EI{hG9;_jWl`i!JNG*%7<?9ltDIv>kT!$tDA3^ zwLi9$Sj;AjSR`7go1_OF$5;0faS8<&^K=&!e5puBs7AUBfRMc>W^eWJEvz_ENY<RJ z89WJ<q!J>MEphPQteU8CGWQ?GT$RCo8=mM#Nig{>LxJ4zt{f1r&pizO*c+HMjD)Pp zba39(YJnrkHcgUE?qEC)<38S)G&i+3QoT%c_FeDY@6^Db7U&(x(VnKXP2{_)m-bzi zNm6Qmlp>27{`l=XcSaxHy1&$WvCTCu(w=m9<l<{;piUwc@^!-)%|7GV<m6Srssz;R zSsh@-`s7gqm+yNFwJwp;mc72tdp+@lW(8_iTSR19sx<UwWSeX(h30j0N?<RI%Y2eK z9CLzNh*Z5m&Y`L^?k+A8rC98VXKFuXz4VDBjoo<RHm*V-wu(2Xa$08`3-^-=90-t8 zlA3HQb%~{w>>q(Wqtr~&dJsv1%@B-=#@$OuO4ZvLs4p{JvKDEb2>hz8vx02=9IAzR z5H=w`Go!>&dG#TK@v1NW33KMFuZ3{vLXS@Q{8NC0dOo1e%1eFQaeYUZ;rxpbc?NyW zL^e3=vzQYh9-CH@#^}`sCB>j11tkl|Eyg`;O(wa<A6erSw*dTB!tVZ|QaVO&>`Y2R z2mh59l~@2>5G2RQwCYga6j#l{d32C@nE`1G#Hai<q|KOi9D!Q$6-_?uhn9K{8J;FL zBV*g?qR<;8*c%+;ek8GaAc;P-^U|qyN{t(triez8*MsMr(}2`=jy^75xH407)6{Ef z<>6{SzMDZzQm@yc?OmOqv}8Uy!)=RR$hX^Fz53h!VybszuRn;THPM$oFtLdA_-Nd{ zaw#jF3=v3+O!suS@c>kl1NqOH1y5@T=!HdJr>4gj9=eQXCSJd*@i#dUOGJF_yP5lN z6y|kPOc|Vb%5xsx@^tk6P@DBtOxNL&gd`vQ`mMSpW;X+_`I~{DOp@^O_<(cd<}#ur zF6`(TC*?M{90JU(utn9Jqb*h6?fa}rS*}AlIZ&FTL9(k<9y$yBMZBIKwqSmhBTec< zl_WEj@$Gz~4UT`~AW2)EAp;B74w8G8Db*ql8En^8G%IQ|y5{T4(NFMcO9HR+L~aI6 z`Y72`E%hTfdvmj5mZOva@v@HGq`evvU{j&Qeh0BZVu+0QP;Du3tmKlhOZw5=T$8aJ zlBIrZL^p<$Ex658&w-QwrCku^Dd-lWi7Z5A{iG!ArA}s%NZNOL`1f*Anx*6{C0-=k zE&6T!j>(v4?~}Q8_u$3AF1a=kXhx)pSZg}yRL2oztZ{)|PX{s|%kHB{9y5-v1Cj~y z9~|GyM?H>Bu_G=HS%%$`lpyf}B3WcA!I*#x38hK~ux6woSHxR#Ai!U#B$uk%=XoR; z8YqzPS&m4j#bLDlD1t)gPY-TC_5nY6iA*|?|M&w?pg~xXI23m7Y~jEcBzjTY^F0T3 zrjW6@<SL6tK*=DD3;1!$y0Ii^u*_K97mr$pQmMaj#rnN}B?Twa_>A08HVKn$5KkhA zaD0ems8BN@wGl$Ye<-1wwBnP4w2ga4i@(Fp=+hvV8I-bEvxVA(%7j1dQ>G4J`GAPZ z;DI7Lj{JhlBeA~*mk3g*+-D&`5m<5BLt{c63et+;>*gY4Q#gp`Y)X=DFQv+v1^3b( zQ_g&MX;Hm(vpnk}Rpi@L9tkaAP8qX6RkEJu1FI>rC%}&m4n29y0)x6kzvCz+ys-{V zs85NU4rNhK2#1m|0te~P4_@$~!nN;k(3!$E)j&BC`O;*8W4NKsWu&8oISp+J`C2BQ z1C6OHQa3a$30rPjPWsw56ogLa6;(Eh_q5*Bd@}q45DI(Ok3{+Xn)N-Q`1i|yXcQ^r z36;dk+|<~uk2ej3=Up5h?61R8Z0h=JR9u@&Nhfsc+qXo_r0X`7^IwhV64mwx80j!} zYPXp(iTBT1K++TBk88~U@hx-m&UtqX3bZ|<dq&w;zTW{KDAY>iz*qxFiPNTcN*&hS zNY?wk(^va)6>bK?E0Yhu$<RaKg|lbszvSY^s~3S*s)i-+dg?WS=DZrXyO-bQN&)hN zDMlQE8u*fDrDV59I!GC5WI=|jo^KV7qi`Zv^&{5YYG^c&Ol9<zln$x5!SXT0r19(e z-aD<&pUqQ*R-8`inHMRHZ|>N7t%Kb!xN3$W85`8oy}?6bY3-F~m1>!)H)o}!c$P6D zJsI*``A)BI`f%|%zUxJ5K7N7@tgOW*T({LI?UMLMO%1=k+`Z?%ebYk7fZ3mdV}HDs zLrOo}%%^2oT6=`nRgXx?{)(_50!KBI{&k+mMf^ADuE1;C8|?F2a<ZFqD%pU0IrZPK zH-n-7R{&JpUjut!*cwUL^)vq-+56YP9@wPtoRZxo@C-J_+t6n`{qKW{zza+L6@G}% zKVy7<E4z!i`FhPS&F~?;%RJP&F8h(uBJIWhA{YyV<C1GVe0Uaq7=7Tp{8~szK+%@O z@cEk?yPF3m6kpSTnC)FYEiSQLE6H~QxDPI6QCHu^bsdKG8yj%T@)wBfrApi>%KiYP zU-z<I2so}GT2>|;m?|?iGRz4Ls*pvP&^y$)?nV3o@aTsSV->pcz3-<b-@tJa4r*Au zM3^2{(l$v(-YX3zL-e8a*E<(Wp%M}xvtS@IK-YXFu-ofem^EsRt~Dy_ZM!JiqE2=C zt`^(mt{yj!)qUO2&9G2gp`ocLT**8}hs)|ET#=Wc3G_C}nW+UVn5on(h5|wiyAh5- zfSYAeSs}&<!$xaIY(er;S=3io#z<Bd5ZZb_7I;!w?)I^klNbeE_zi$W>4%9&A{H6< z?bdBU{AYMLyyuBIhpa6qw3H{ZMn!&_Oln$CQ?9Yo5L<_*1ptjm|GYIwWpyf*i%3?r zwX0f9B1%KIu<`S6K<O#(T<7Rc_S`<!&@L6wgZH>NA2MKWei&KCf0-DiW_5_wA=Onv zb;mBor2AN};%OB}oPlPON?%Ww_oF`o_iT1aDmyP;a1x0}w?Tb3WsILc{j6v*wTk<N z<y|`vK?D)gvwq61PG@Fm82SCP4;IeUUDOkcuC5SNskHL*Ziz}-z*GGo_uX~AUKv%5 zf;R8Hf@qE@ot%m9y_p8*RkQEhpxMVWpgzO<UDJBBw>fr4elC&PDa5G~Zd!a?6*S-R zsAQ+EdO-u$61mnw*RHhkNg<yaPT$RPR5n*V6<0vJ5HeZL)QbSY<Muec#=*G?<d#~D zH;|XDn0n&LXEqt%>b4?qlJjlC&q|~zZ)wtg|NqYbQDn);MyP`}Kw#9}Y#DBf#HKDd zXKxOf)Jq*w`+dT;x%X(`j6BYoY5`upY+xYi!6%$)@$y6NektYG)~44eYFqXNB-&ya zF2mys>gW*>@dvOoyrOAoK~JB@;|+)repO&5ynGkvBFBwYsW+9?{c22v7|S@34GqMn zF4bpWjmPH^uJvYg<C)ein#`Q>;na6*vXg0VjI{apoqN@ZLns*|V&+3(2u~y-AUz?P zIC8U&bR*fcGu#=X7qZaA(#5r>4LYFI_Z3gUeBn0g#wL`~5vWh-w5;{#H+t0p7@RI# z6Iusl`5e_g`dm6At&J<nJkeC|-xn~d^-g8APgZDxkiZI58+C@fcYI?M#r<}E-7Hcu z5s5e|nscb7aX8GS_U$GY;;xalt~ElL0|9gX$`}QP^!WhYKuBP?XUq#$8V~Pd0l0$R z*<w!oK1KUpIc!l<)*EeHO4i<lHn=;0g7?x?N|%ILRLb0!;uhV#5#2oxz|d#K4Q0t? zM8qNuAHs)f4;oJV6lt|g12`Py7BPtz?%QH^V7O*Po3>&mJ;OmMEV&Q`X#=Y{#vl+9 zEqF-b90?r3Ss?a3n&4jH1fjn<m9{1$7LI5e4ur(I3~Yv&my3kLMS4NYtyq;f)Fmz+ zl4XBfX(7dkM`V=F-sh|)xhIp(4m<(V8dc32*dgwzA%m#d_yVmJ-1<)1ZH)y!J$JXJ zqVhlA`7ofphIpv>c4XoxI?mc=6AeY&L?`a*Fdc!{>For#zV`eL*Tu`ZYu3(8<{}i7 z*2Nl+uN(BiEcIJKS45oe(2UOy;fP;&Md6;g6zIB3r*mG;p)$@|lex9^o{$kDMBI=v zx^;|+L1L}HE^paK%p7Urwj%dcn=>M}g*f(T<S>TnA0rh8J=j2X$q^l>0aGDfj7$Qf z8<c8V(bfs8nIkA|il9%`Op`$zMECaKRFW4wT;XGYV<}gO<*L1d+OX=BO+(0aM*uU= z*bK8^i*H?c(t#1rATCi4D{XbQ-v_`!>D)M`S1kZbrO>dA#{s3*{VAEX5VyRWLnVOw z03&*ScdYvwIO@KPXmB!GXR2e6eNYbOOs|%=C<2|)r=<5MzB(<Pv96g}t!33{w2`6K z0(%?=_315xX!@RD3>t*Rr?;pZOv%^gH~M-0{X>I97v|2j-t@ov)JwqoGT$Kh1&j3M zZA>~_wR3$Y`il1d7T{fi2+%eJ^ahEqeMGLdQTtXjJbY&~eYZwYcXA+B)hoD}@@cMk z;GXOJ;X4s~^R!+?cg7NpK_c)E06E3XV?5dOKqnh_P!40%gQeCXZ7dJ)AwvXqm5o&D zsy0fJlBlCf!uuH;G914NZ|-d0<8XO1{=Tgwpr0)Via02veX})CNZ;MKee+x!pbHI3 z>~B@=tBGPOuuRr9A7Maq>JG(mbs~1Bc@wH!6@q`$Wav!jjaQrGED6ZQ$kFAg(aJ_n zD;%9i7`BLH{FsA-6sZ0b5=qiG<g?^Ib0R*ck__}rREe%FtloKA{VeJnS0UXxmznA; z--jN^Pf1eua!{e{GvB0B_T+h3W-sW;PS<)k=E67Fr5aw7y*I<#KQ7PSX5LQx0l++b zEgQXs7~%DFkO#cm1__O_rUU{?3TsT&jUWd>0I9ejCEE-=Jc*aRKxIVXO^l*8f-)N? zeXm$I5z`91f_9|yEdOp3kX)}F<+O>6gd7;)&LNL{RLPr@-R@CMLwALYRe-TFi>sTc z1g2J|9@^SmH5m`W{vu&~RPEf<QX^ZZhSIqPJhf9`dRjmD$#aYF=+r>ysZ3<OJp09x zMGB$4D#JV~wuwXXOMFV<%dq~jCV0H4Cx<$4b;$$Q5AV*&E`u6u)v)(*019PG*KWmk zAgHG@8xhY7WR#Z2`)8#O6g8W7k83*#+<pSq^^Q`hG8dHMMIvS@ZiAwME9Frn*to%P z2Sy^V^|N8i7n>}{|B-wo<(IRPhh3@otn)7YK7Dqs$LPM!5tR+!{X2M6_Eo#5HzO%V z&78CD$Fc8Xe(41TOoeLe&u=F3O1JwQLZFg6+Ojfi*Y}pg=pd>$Jc(GsWt2#<H03#a zt{9=fIE!w3RwEgx>MP?Qy*u*@>jTnI)Ti6UArTB4yp`)@DXo<_^0h~!cACV1kf&i# za(gs2Gmh3MxUm|;j#u2y=5+mV+SJy)HE-jIzF?V|Tz!ZeU6}aH&>T;Mu#OU55>Lsi z>H7I9&nO>%y&RaxPH!O1P(qX#hkd+IpuksTIfgo;LCVf6=)P^0<qvfaWP=Z^;=>ce z>d^A=fR-T5=)E)nXyBz$2k1&<DM(=%Og}6Xv9f=z>Kz{F6_B(%z+f|QRlfoT4s$xe z_xGML-D8GVdS9zYl_^ruHK!x&I!Z=pztDb@O>2A1QdYZ(ItvO6<=`Dph;D^5#gq5U z*6aQ_TSobTQJHX1IatagHZy5FuHeL@PacCo=tIj9{R%%-En8J>Tw=$nblbTCK^kiE zOP2`sQ0jDZU;cE>LHCPxT_Dn$+fLk6*j}V0Y*7*6u!ztI(AFg=q8TLA<k8qd$F!gY zN_kp4LoP#Z#VidefHP5B2~V$H$H_z>-4~TRL2|TC;XMN7?GZ4@A*!IIr|@p($tmbt zOYlcgFLerLA>l22eJg_40o->6QZbNs{{f(Z+6-$86Vl}1QG8+k;q99q&%A4?Jr<K; z{mcNDz`itdsj$Zg+cqkKx^S$0Hx_Q5G2q#TFHdr=*-Fnl!RK38C7cL-lHP)jH1O+> zguA&~RX6@3io*+l!qC&Wg-SQe4Y6|5=4-lLZ0m@Y=B=n`>DeF}YUI>H^+h}4BZ^|z zT?RwS?OV8Zy&4Rz;%aX%d;V3j>%E#`ohn=Z50toAS%azL1dW(9gC4!B^3+jZmyaAv zJ9~Wr%BXo(P5Wh(EY_cBrh#OQV+~bM;+OinG4<WJAxi8X>!45mAPrkZm9K(qM+hBb z4YTC?r!O&FBJdngt*X{nHm}*@Db<0xyg-Jt!Ffo}J~|JL7?nP|7QkCA!Mcbz_uZDS z@2^hM?OUnK^epA!*?Pdue*~VA5#U4mO<Z2-9{`fiW<?RDvy{N)gAXrTOC`Dn_pupK z!)(s4*%Cju)LApD6*jbAxU}<_7O0`NBYbm9H|k&R;%@s+^qexGA`N;F;xpp+J~7dl zyXl3?&3a0(#x<5={HlF55TQ?7XPm2M;iWiWTU7}sHbn}20H<!2D*b_b5L!@GiDLG( zES&Nw;ibp&_M}v0WZ}#-S>%3Luyt7bw4VG^Ww%gH@+j644q}%deQ^<>ss{YpG+8*A z&NyWZXio<r(V(QcQ=!oJyY!K-5Y6VkFo4Z6a60R=<TU%7H9JTvqs^kU<akwe2e!T) z_>^ODw?|j>+jJivu+p4B$m~w<^7Sq1Zv2HqFWHl6DQ<OExh-aMblOXmZeu<(tSoTU zF+AZ|)XCOFiL;rcS9c|H0w`3h_4wArS}tNS3AcsBdM%f~Pib1v)`sZ)28iV)V_2l# z<C$5}I(BT;lP|~fMovHS`U-b0oVlzAMLs>MQfQp7GeYNQ6t5?T-+jLKd-#8ojJ%Wq z19<a|KHn)MM&I)|@MjL3B|ok7;bZIjVsv4os&PvpgX74CZ?(O?_e$jP&qN5#Ip6A$ zpuE!C3F)Im?q(!%7S6oGt&x_`M?!L(ciOM3sU2q0ze~>2+^%H~zyE}jgm}C?O`!Jr z1L;Qe#L@K%u-Z`Qd4*x#3&mllm4nyY<fn1daLDtWqjjqYZn}20my?L-1^5&O402F5 z_>vdj9xls<FuJ(|M|;0r_Mu6-bi?MGKlMgTfie2Fu!xJ`R$Vkq73Rmucv>a38Dq<K z7d@;U$~1FFj8C#hkF)zXL8RG8ZyAIe(l)$7hpUW51yXpCeTZ~2M;ePHCkJuz5*Od) zDnS7f0mfI0vO%j+8cn?LMw%g*RNPnvOnqeQY)~~$YjrG~5NWI#hRrY*dnND{xdI>N zN9Q&MZ9LE-yKr(0N-8(5@2knFC%RtF_Y^YlZyw#Ey_WX(iHed+Imf!Y_-KfFc!Gt> z(MJ+%)BXVL_V$VuYOJ5XW6cxs*m#qX9w@|03q(}55#nFZP8}!QxYcy~vM+?@`p#?j z!9dpNMH1Ax{8X;)(+HMHGiq(-vvj8Lj`c6HZvNjvGSDJVrGk~={#V|Qf)q{eQd#5M zvXUF01U=n!IF9d&*Pi3Lk#4qw`y_EDq<9q2i7~f9Nn92!eA`q<Vmno*U+&0B3S@ww zH?zL<Dw(Fm)4m>CU%wmF)NF;+T&r;GAf_bNAE$8ediK2xa;L&DKF2EB^v-;lU?Y!S z$jYU4r6u?^U72l`0n}T#gv^ewOc)juS$Yr{mIvP%__?z7SOAlx>Y~XKx-Jm#8DW(& zIyn_RBbA{>Y))%>65QWE3cv+ZR)pf)fr#W$UP=4`fR9fL8Z;@0$OeC><nHXe9A?`) zpT$CXiiA38b@KV_&Z>M(_($%m?#JPoz#n86+s8uwzFlNF3wp=*@p6wjcLFUfO-<ZB zBP~;_U%Kt+CFoEK=X~D2zUenTB<lLUe!dR-uC6tEImD>{Rd^>4WxAP?0Z9T=*zxTd zFC=J?Y3aR#?g!kE%nIx2Zj`Rq3}MrKtY@6}$+Of08fzu&>pfU-OI1{HIUY|tLDT;4 zS7r%QDp>IJ5#C>W#ILbz0lpk`YC4#v%d=Ln6Dvoj*V(3+dmu5|_ij>36!=oDolOMe zQWZzgKSQB&4v{Sq@HXVAE4i{N#RT@S3X?rkj_b*9a9?YiGKJKQZZCVfX`Sv54_S)w zlksjJ8@NS{annfgCHuL$L{GFdz}c$E_6Es3>0j;mVkqd7iV{+Ao$~k!Ppr3!FlBb< zUJd|zRo-HC=ax()7v*Gt9l%t4E4tp0aX?MtPk5aA%87TuDrVv2s;`vSUxm0*`NgLz z%<TcS7f6eOx$BdaF_a7u-+O!BX)j({Zp@X-kP>z>jL90{QzN3+yKtO%WP$)sZQ5eQ z*d_}C^{|Uf2hflt#Y8^!WHxq8P+lS`ACkF+&2LPlE~3)%yl3e-J)9!Lf4Vfwgq?~_ zFu3X0*asH@>`w&ksK?C9o*+6QThNuzbVV7ih3JVPV(IT}p@wr;jV48Lq;Fb2FMhx4 zN3uIgC}mk^RxSLa`$djvD;76wv7+ATyJIq>i`NF)Pd`1t)gOwB(jXN@3_8yM0^mPi zUfgrq@#Nr7%;x!Zn4N@f=NS!cmkC)(QH$if*wv*&<Q8Md6<}xfqza<2oJM;SY$t)= z(Be+IIhR5y5gV@Zocj-eJv<aTkuXM-2w`sKt@luzE#pC5fxR0dv{t@%mMebVfK~6# zo>;{wfGU$MaXs9isZmJ6Y(PJYoZX<NfW=2<QcEY1LgVT%+scW7u?cWRl}tzCj%tie z48ZL)d}RCe6`FWIi@Kj4T>iS1M|YR^L9s1;;OH?w@YB)N{`CXjw`-9GyO-|@uP|f! zDW?hJfCW&&j|*+rlY}5BLo7}&J`|M_q1XP=g<5+@ESEXJpx_KT?<FT<V2M=JoA&<g zE6rAS;G4xsF6sbcgOuh9Y(KjA&2iTHH-Se;*9J=Sb8vn~eT(JKCw0C2V@MZF>xERp zt2~!}Aj;3*J;okT0Kp8sD0N{W(#BQE17zRVljhd_L_c3fr1mc-`|e!t)5mh_3QwrM z>ouq;=)GCPA?3@wAJ{x+e<LTGXg9R|UcF>av=cMDKNW;0`sF#0ModfyvCox5HhBpp zv))TWH{W=j?=V7Ju+@hw_WbTK$MW*%&H7bd;29M)I!>~{2Qn^k>GgFWmlh=@-xTcS zf=o-3w^RA$hPmsMoIbXDGSXXdz>mrY@0Ugs*ONsF+ef10>rqw~Y_vEh@mgeXe*m7i zM7Ajy?O+=G5SV+Q?RZux6V<CNddU<P<BJ^ejd=4sGO0*h-6t7PD6K&qaP{CM4Xj49 zn|}BMpm;#>q!blX^>yD72VNmB-DeN4n~$pe>R04nC$3>dq0mBfId&Xke&)uqvIS^3 zjuEbx4WgV9&R$>?G+{)q$1*8ICVN#)ZDE&4|A~<1LXJUAFwnS*tJWNe6H25AAFfL+ zDN-ou7f)v=hbJacpw(qlCi@iBHL0C*^M3AZ>i-L;2Uz$z0p^i>uxtMSG{12-ZNVrC zV8AxiBKc$QyF8{!(pL^Cjt*lgIW}82yfpDC*HT|b9G6Cqpghl_Oev|+H9WodIZ2#; z3(9FH0H>}RD3s3NvNS1OU?{ban|`y2eCDwr8vF%ML`|K{wnIJP5v#R%=KQXkq+hSk z22>8Xsv7O@`fot^HSCKfyD1WVqn_l-hqwr;ZAcV+eM|KjrwF2gM2#~P6pKDbKnk!r z;*<XXM}ymIv&I3fJx`e7A)TZ+KTqf%C)B)m>ZH>a1T5%R7rViG<N&kC<5t27Kng-v zW{&u))S^J$33`g)dQj@X^1#~56xLp|Z3EpP?Bz1xdmphaZ$q{;cUsU?^8QQ=NnF~B zBEsEb0k}NoQr-bk=UBwTmeJQ!=1GW90gk$Cns_>9-4X!u5f3B!9*z<i&#>V55eUTV zfjWD-KPuq+cghEjhi{y|@W+?r`UlDNFC0FKR7FInG}$EH05hOKt{~`m6CZ3~E<&<9 z6HV4x!&76f%|vq@;xrZkl#_rRbiHtWz@p*-JaZ-0)*)Th8g&b=3&u9`8qN#><ezL+ z6k^sSyeWrAB(fjTphzy^+ToqUBj66JXxIeKl{4gFC3HBv;I4kdD+q=VhTUg7=>#a! z-~&2um(S=5xH6&9(D>8&CsP23(d+ThJoG!|(e~~0K~O8(0yaJem*n~f$@MRf-8x(8 zw3{%faRUcxpVRbP(&yx<t({DuTk3p0<hU`ySLVzQzicDFcZ<vNeFNnBm+StFho+yD zgs9-ok3-@j8}03g%GLS17wY%Pfe(S@`96X0C{<|)y~iO#%+0_hwCGXC(QY*If(y_k zvWsTE*of7Wi#DxT_L}eE>R+$=Ad%UPdq1zsNZNPpf@2lewkoyT^8r|G$W4#Ld45lz zc%!I2?Lq$G<*hn37s!Y0noCp>R}Awv_ss=$zKBuY332&ebG!XR!_>cE`g5DduBUI) z%@4n9GrxDo$@xBk<Hak*C?)cyA+skyY+h&IrU&kk#2Vesxyz)-V3+xLx(1`wDf}mg zseZ-uy)E_qD{%cz`5+<k9$%B_9~Q2Js$Hn(CTdptuKYbq_CKcfo}<1bW2f{XT;ajT z$$5THpm;d;Kw_Y|R)Nlx=cg0zjxq=V(K+YA<4+++?T75j94+?a(<*T$q>J3??VhFk zC(w@v_ryq%I(+ycT--lX<-ETq&^!PxGeW~CAwXKio&_sX)3IibTnr$WOgy(Sf&{QJ zt`*m=0U!z^MDR%`kFoq!e@~|$vUCx6JUHwTK5Lhb?1~fSJijN<JY4n1Q17wh&(Eeg z1XVR(8+yBFuQ}h1<Iq_YQJ>eJmUEmMTa=tt^uNMypV>N55XP&cq4QukdN?$u&zSQ3 zpFr^ZZ+C&CW9TGA>Sq!__(NsxefS8>D3|6<KuyL0D0mCD^vi2=&jBEX5u#yelA@&Q z{@=0mpn2$b%Z2nieD^0knMA4b-d~gG9v_YF@C<y*0Sd*Noa4AugMtW9h>6oVaG4d` z)LTNE+(2dK&6d}<3Qt(8d<tN1qHqPAemdaMK&+xi_AZ;&*9Ia={)UN144ig+r<dgV z2Z!T(vRexXK?w~=&`!9Sj!xM3A^^}3)*aFLI?+vrH(PO1sy+1w>gl6Yz9~dRMca-0 zNALR=K@i_=BPy@x#x&EMI63(bFUj-|561UmFJ?QE!VzWF!~@|FL~a(AR`a6|QyjZd z7RHD*TS?&L5dc+iK>;C(i`Czq#T0zgQQhZ1VCYAa`r@fpuj#c9(Cw5;pBu~aeFMX* zgR06*dcd(n1(dxt@Vl$zt-5~B-~8}3YlJ)vhwAU_cm01&{{XIgXFn+oYpKK=UatQD zHmOW9aoO=azbDW<Ru4oY?hj5e{)Str$7fx2gOF0|AIWi>B(M`*Lw=a}gn1h4w_dyS z@KBooyMOuJ{{Z2MomD#iyP`<>VosjUt^fcabnxddugwf;rz<`X^8BAb@NlU!sD7PK z>(53S;?Q;YZgHlpgWc)vhlLgp;XMHRe!rk=(tMO4Rl$wEgW=ylG2b}(x)<p7%Y{!D zm*n~finfm-!}U0M#!2Ebrn$U&XXWk2qoP>9h<|ug0}%}C&F9y{)W2W!Bsh5-Mg&ie zAZx3FYo4p|mFWKXibRR?ZkOA>5!<uD<@r8=@_kG852odz!-#@E3jYA~jsXG($q`L= z_rzf$e9=`H_rQ$~IX@@RK2NEB!}NgV(e080==bmi09EOM*7kP!ouoK%fJgNHf%1Jz z_AjK+r=D-&`dsK|pU!}J==RBj@89&^f%1Jz_dlf3kq*v}>3sv_`j_sXLqMa9`>r3- zdI!n%FWr8CQ7H7qRNwXeAE11nQvKWLf=6aGZS3v(FF^S|rTfRzX!X?X`V)SO<ocKI zKTFf!Uz`O%ua<5ccI$!ZJpNCqe)aU;)6{pwjCA~@P!;TBJ8<lCgUEcpQvL7fLxcO` zBuJkduq)-Abv%qB0QtV9`{&RF;PB(HMEDqiTs~FuFjxTc`TnK*@6br|(Z)Cr;|Jsq VtD8sk9AF3ld47k~zvBL%|JgR9limOT diff --git a/resources/images/scala3-contribution/start-debugger.jpg b/resources/images/scala3-contribution/start-debugger.jpg deleted file mode 100644 index edf17d700afc4ed9dc5f842667132af742fe1e4f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 102513 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�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 MuSYu!_&xW301&<VOaK4? diff --git a/resources/images/scala3-contribution/toolbar.jpg b/resources/images/scala3-contribution/toolbar.jpg deleted file mode 100644 index 22ae60ba27e1d3db5aa9711d03014fe9a08dfde3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 111169 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�tM1cF3_<_~>S~x|2va0z3ih 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 GuKzz@9W{gi From 8f5e04d79ea778340864cc2e8ce4c31613005fa4 Mon Sep 17 00:00:00 2001 From: Alin Gabriel Arhip <alynarhip@gmail.com> Date: Thu, 18 May 2023 04:42:54 +0300 Subject: [PATCH 2613/3075] Auxiliary constructor example needs non-implicit parameter list. The auxiliary constructor (zero-arg) "this" needs an empty parameter list. --- _cheatsheets/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_cheatsheets/index.md b/_cheatsheets/index.md index 41e35e3eb2..679e4ed242 100644 --- a/_cheatsheets/index.md +++ b/_cheatsheets/index.md @@ -331,7 +331,7 @@ breakable { var y = x val readonly = 5 private var secret = 1 - def this = this(42) + def this() = this(42) }</code></pre></td> <td>Constructor is class body.<br />Declare a public member.<br />Declare a gettable but not settable member.<br />Declare a private member.<br />Alternative constructor.</td> </tr> From e5e1d80a5bd09b86d670d4ae01384ba6cf4467aa Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 19 May 2023 10:34:16 +0200 Subject: [PATCH 2614/3075] Update contribution-intro.md --- _overviews/scala3-contribution/contribution-intro.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-contribution/contribution-intro.md b/_overviews/scala3-contribution/contribution-intro.md index 45e96f7be0..1708decf17 100644 --- a/_overviews/scala3-contribution/contribution-intro.md +++ b/_overviews/scala3-contribution/contribution-intro.md @@ -1,4 +1,5 @@ --- title: Contribute to Scala 3 description: This page describes the format of the contribution guide for the Scala 3 compiler. ---- \ No newline at end of file +redirect_to: https://dotty.epfl.ch/docs/contributing/index.html +--- From 7021bc89aa5a0949ae603427b5876e15303233b3 Mon Sep 17 00:00:00 2001 From: sangwoo <tkddn3367@gmail.com> Date: Sun, 21 May 2023 13:21:28 +0900 Subject: [PATCH 2615/3075] fix typo in `scala-for-java-devs.md` --- _overviews/scala3-book/scala-for-java-devs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index b6c707f038..78d86b289b 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -813,7 +813,7 @@ Called a _ternary operator_ in Java: <code>val monthAsString = day match <br>  case 1 => "January" <br>  case 2 => "February" - <br>  _ => "Other" + <br>  case _ => "Other" </code> </td> </tr> From 86d11098e0f6436d250a13f28326dd801a76fe6f Mon Sep 17 00:00:00 2001 From: TH Lim <sshark@gmail.com> Date: Mon, 22 May 2023 22:57:43 +0800 Subject: [PATCH 2616/3075] Remove if-else syntax for readability --- _overviews/scala3-book/ca-multiversal-equality.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/_overviews/scala3-book/ca-multiversal-equality.md b/_overviews/scala3-book/ca-multiversal-equality.md index 7d5d6d0c92..2e3308d25b 100644 --- a/_overviews/scala3-book/ca-multiversal-equality.md +++ b/_overviews/scala3-book/ca-multiversal-equality.md @@ -175,14 +175,12 @@ case class AudioBook( // override to allow AudioBook to be compared to PrintedBook override def equals(that: Any): Boolean = that match case a: AudioBook => - if this.author == a.author + this.author == a.author && this.title == a.title && this.year == a.year && this.lengthInMinutes == a.lengthInMinutes - then true else false case p: PrintedBook => - if this.author == p.author && this.title == p.title - then true else false + this.author == p.author && this.title == p.title case _ => false ``` From 367d09a76d8f25460278cf3b6110c4c4742854d7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= <sjrdoeraene@gmail.com> Date: Wed, 17 May 2023 16:04:57 +0200 Subject: [PATCH 2617/3075] Update the binary compatibility guarantees for Scala 3. In addition, be a more assertive that we strongly *intend* compatibility of produced artifacts to be preserved, while still making it clear that we cannot *guarantee* it as it is not mechanically checkable. --- .../binary-compatibility-of-scala-releases.md | 69 ++++++++++++++++--- 1 file changed, 59 insertions(+), 10 deletions(-) diff --git a/_overviews/core/binary-compatibility-of-scala-releases.md b/_overviews/core/binary-compatibility-of-scala-releases.md index cadac052e8..6e7135c3f6 100644 --- a/_overviews/core/binary-compatibility-of-scala-releases.md +++ b/_overviews/core/binary-compatibility-of-scala-releases.md @@ -7,31 +7,80 @@ partof: binary-compatibility permalink: /overviews/core/:title.html --- -When two versions of Scala are binary compatible, it is safe to compile your project on one Scala version and link against another Scala version at run time. Safe run-time linkage (only!) means that the JVM does not throw a (subclass of) [`LinkageError`](https://docs.oracle.com/javase/7/docs/api/java/lang/LinkageError.html) when executing your program in the mixed scenario, assuming that none arise when compiling and running on the same version of Scala. Concretely, this means you may have external dependencies on your run-time classpath that use a different version of Scala than the one you're compiling with, as long as they're binary compatible. In other words, separate compilation on different binary compatible versions does not introduce problems compared to compiling and running everything on the same version of Scala. +When two versions of Scala are binary compatible, it is safe to compile your project on one Scala version and link against another Scala version at run time. Safe run-time linkage (only!) means that the JVM does not throw a (subclass of) [`LinkageError`](https://docs.oracle.com/javase/8/docs/api/java/lang/LinkageError.html) when executing your program in the mixed scenario, assuming that none arise when compiling and running on the same version of Scala. Concretely, this means you may have external dependencies on your run-time classpath that use a different version of Scala than the one you're compiling with, as long as they're binary compatible. In other words, separate compilation on different binary compatible versions does not introduce problems compared to compiling and running everything on the same version of Scala. -We check binary compatibility automatically with [MiMa](https://github.com/lightbend/migration-manager). We strive to maintain a similar invariant for the `behavior` (as opposed to just linkage) of the standard library, but this is not checked mechanically (Scala is not a proof assistant so this is out of reach for its type system). +We check binary compatibility automatically with [MiMa](https://github.com/lightbend/mima). We strive to maintain a similar invariant for the `behavior` (as opposed to just linkage) of the standard library, but this is not checked mechanically (Scala is not a proof assistant so this is out of reach for its type system). + +Note that for Scala.js and Scala Native, binary compatibility issues result in errors at build time, as opposed to run-time exceptions. +They happen during their respective "linking" phases: `{fast,full}LinkJS` for Scala.js and `nativeLink` for Scala Native. #### Forward and Back We distinguish forward and backward compatibility (think of these as properties of a sequence of versions, not of an individual version). Maintaining backwards compatibility means code compiled on an older version will link with code compiled with newer ones. Forward compatibility allows you to compile on new versions and run on older ones. Thus, backwards compatibility precludes the removal of (non-private) methods, as older versions could call them, not knowing they would be removed, whereas forwards compatibility disallows adding new (non-private) methods, because newer programs may come to depend on them, which would prevent them from running on older versions (private methods are exempted here as well, as their definition and call sites must be in the same compilation unit). -These are strict constraints, but they have worked well for us since Scala 2.10.x. They didn't stop us from fixing large numbers of issues in minor releases. The advantages are clear, so we will maintain this policy for future Scala major releases. +#### Guarantees and Versioning +For Scala 2, the *minor* version is the *third* number in a version, e.g., 10 in v2.13.10. +The major version is the second number, which is 13 in our example. + +Scala 2 guarantees both backward and forward compatibility across *minor* releases within a single major release. + +These are strict constraints, but they have worked well for us since Scala 2.10.x. +They didn't stop us from fixing large numbers of issues in minor releases. +So far, that policy is still applicable for Scala 2, although [there exists a proposal to remove the forward compatibility guarantee](https://docs.scala-lang.org/sips/drop-stdlib-forwards-bin-compat.html). + +For Scala 3, the minor version is the *second* number in a version, e.g., 2 in v3.2.1. +The third number is the *patch* version. +The major version is always 3. + +Scala 3 guarantees both backward and forward compatibility across *patch* releases within a single minor release. +In particular, this applies within an entire [Long-Term-Support (LTS) series](https://www.scala-lang.org/blog/2022/08/17/long-term-compatibility-plans.html) (which will start with Scala 3.3.x). + +It also guarantees *backward* compatibility across *minor* releases in the entire 3.x series, but not forward compatibility. +This means that libraries compiled with any Scala 3.x version can be used in projects compiled with any Scala 3.y version with y >= x. + +In addition, Scala 3.x provides backward binary compatibility with respect to Scala 2.13.y. +Libraries compiled with Scala 2.13.y can be used in projects using Scala 3.x. +This policy does not apply to experimental Scala 2 features, which notably includes *macros*. -#### Meta -Note that so far we've only talked about the jars generated by scalac for the standard library and reflection. -Our policies do not extend to the meta-issue: ensuring binary compatibility for bytecode generated from identical sources, by different version of scalac? (The same problem exists for compiling on different JDKs.) While we strive to achieve this, it's not something we can test in general. Notable examples where we know meta-binary compatibility is hard to achieve: specialisation and the optimizer. +In general, none of those guarantees apply to *experimental* features and APIs. -In short, we recommend that library authors use [MiMa](https://github.com/lightbend/migration-manager) to verify compatibility of minor versions before releasing. -Compiling identical sources with different versions of the scala compiler (or on different JVM versions!) could result in binary incompatible bytecode. This is rare, and we try to avoid it, but we can't guarantee it will never happen. +#### Checking +For the Scala library artifacts (`scala-library`, `scala-reflect` and `scala3-library`), these guarantees are mechanically checked with [MiMa](https://github.com/lightbend/mima). + +The *policies* above extend to libraries compiled by particular Scala compiler versions. +Every effort is made to preserve the binary compatibility of artifacts produced by the compiler. +*However*, that cannot be mechanically checked. +It is therefore possible, due to bugs or unforeseen consequences, that recompiling a library with a different compiler version affects its binary API. +We cannot *guarantee* that it will never happen. + +We recommend that library authors use [MiMa](https://github.com/lightbend/mima) themselves to verify compatibility of minor versions before releasing. + +#### TASTy and Pickle Compatibility +*Binary* compatibility is a concept relevant at link time of the target platform (JVM, Scala.js or Scala Native). +TASTy and Pickle compatibility are similar but apply at *compile* time for the Scala compiler. +TASTy applies to Scala 3, Pickle to Scala 2. + +If a library was compiled with an older version of the compiler, we say that the library is backward TASTy/Pickle compatible if it can be used within an application compiled with a newer compiler version. +Likewise, forward TASTy/Pickle compatibility goes in the other direction. + +The same policies as for binary compatibility apply to TASTy/Pickle compatibility, although they are not mechanically checked. + +Library authors may automatically check TASTy/Pickle backward compatibility for their libraries using [TASTy-MiMa](https://github.com/scalacenter/tasty-mima). +Disclaimer: TASTy-MiMa is a young project. +At this point, you are likely going to run into bugs. +Please report issues you find to its issue tracker. #### Concretely -We guarantee forwards and backwards compatibility of the `"org.scala-lang" % "scala-library" % "2.N.x"` and `"org.scala-lang" % "scala-reflect" % "2.N.x"` artifacts, except for +We guarantee forwards and backwards compatibility of the `"org.scala-lang" % "scala-library" % "2.N.x"` and `"org.scala-lang" % "scala-reflect" % "2.N.x"` artifacts, except for - the `scala.reflect.internal` and `scala.reflect.io` packages, as scala-reflect is still experimental, and - the `scala.runtime` package, which contains classes used by generated code at runtime. We also strongly discourage relying on the stability of `scala.concurrent.impl`, `scala.sys.process.*Impl`, and `scala.reflect.runtime`, though we will only break compatibility for severe bugs here. -Note that we will only enforce *backwards* binary compatibility for modules (artifacts under the groupId `org.scala-lang.modules`). As they are opt-in, it's less of a burden to require having the latest version on the classpath. (Without forward compatibility, the latest version of the artifact must be on the run-time classpath to avoid linkage errors.) +We guarantee backward compatibility of the `"org.scala-lang" % "scala3-library_3" % "3.x.y"` artifact. +Forward compatibility is only guaranteed for `3.N.y` within a given `N`. + +We enforce *backward* (but not forward) binary compatibility for *modules* (artifacts under the groupId `org.scala-lang.modules`). As they are opt-in, it's less of a burden to require having the latest version on the classpath. (Without forward compatibility, the latest version of the artifact must be on the run-time classpath to avoid linkage errors.) Finally, from Scala 2.11 until Scala 2.13.0-M1, `scala-library-all` aggregates all modules that constitute a Scala release. Note that this means it does not provide forward binary compatibility, whereas the core `scala-library` artifact does. We consider the versions of the modules that `"scala-library-all" % "2.N.x"` depends on to be the canonical ones, that are part of the official Scala distribution. (The distribution itself is defined by the `scala-dist` maven artifact.) From e59c7e3a85f1bfe41c8fb13829346c2e0053cda9 Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Tue, 23 May 2023 15:20:03 +0200 Subject: [PATCH 2618/3075] Refactor: Add documentation for the Scastie configuration --- _overviews/scala3-scaladoc/settings.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index 6b062967f2..69ca8b5cdb 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -172,6 +172,14 @@ Which means: - all snippets in files under directory `my/path/f` should fail during compilation - all other snippets should compile successfully +#### -scastie-configuration + +Define the additional sbt configuration for your Scastie snippets. For example, when you import external libraries into your snippets, you need to add the related dependencies. + +``` +"-scastie-configuration", """libraryDependencies += "org.apache.commons" % "commons-lang3" % "3.12.0"""" +``` + ##### -Ysnippet-compiler-debug Setting this option makes snippet compiler print the snippet as it is compiled (after wrapping). From b4ce6a6b39bc3e1f6147bead642fead1ac0b8686 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Wed, 24 May 2023 13:08:47 +0200 Subject: [PATCH 2619/3075] Clarify how absent members are handled in the Scala Improvement Process (#2802) --- _sips/process-specification.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/_sips/process-specification.md b/_sips/process-specification.md index 186709f245..d602357e3b 100644 --- a/_sips/process-specification.md +++ b/_sips/process-specification.md @@ -199,12 +199,12 @@ the Implementation Stage. There are three possible outcomes: Committee. In order to be accepted for implementation and advance to the next stage, a SIP -must gather strictly more than 50% of "Advance" votes among the members present -(this means that an abstention is equivalent to "Do not advance" for this -purpose, biasing the process in favor of the status quo). The PR for the SIP is -then also Merged at this point. +must gather strictly more than 50% of "Advance" votes among the whole Committee. This means that an abstention is equivalent to "Do not advance" for this purpose, biasing the process in favor of the status quo. Furthermore, if more than half of the Committee members are absent at the meeting, the vote is cancelled. -If there was no strict majority in favor of "Advance", a second vote between +For instance, if the Committee is made of 11 members, at least 6 members have to vote "Advance" for the SIP to move to the next stage. + +If there was a strict majority in favor of "Advance", the PR for the SIP is Merged at this point. +Otherwise, a second vote between Reject and Keep will be used. A proposal needs more than 50% "Reject" votes to be rejected in that case. Otherwise, it is kept. @@ -288,6 +288,8 @@ have the following purposes: - Make any exception to the process that they judge necessary to unblock a situation. +If a Committee Member cannot attend a meeting, they are welcome to share their feedback about the proposals listed in the agenda of the meeting with the Chairperson, who will relate it during the meeting. A Committee Member cannot give their voting power to someone else. If a Committee Member misses more than 2 meetings within a year, they lose their seat. + ### Responsibilities of the Committee Members - Review the proposals they are assigned to: From 5820696126f4d3b959f66157d5fc36d1d0d66c5b Mon Sep 17 00:00:00 2001 From: Lukas Rytz <lukas.rytz@gmail.com> Date: Fri, 26 May 2023 11:45:04 +0200 Subject: [PATCH 2620/3075] Early init migration for another common use case --- .../incompat-dropped-features.md | 39 +++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/_overviews/scala3-migration/incompat-dropped-features.md b/_overviews/scala3-migration/incompat-dropped-features.md index 4d5b2d5d73..03b4d35f80 100644 --- a/_overviews/scala3-migration/incompat-dropped-features.md +++ b/_overviews/scala3-migration/incompat-dropped-features.md @@ -226,6 +226,45 @@ class Fizz private (val name: String) extends Bar { {% endtab %} {% endtabs %} +Another use case for early initializers in Scala 2 is private state in the subclass that is accessed (through an overridden method) by the constructor of the superclass: + +{% tabs scala-2-initializer_5 %} +{% tab 'Scala 2 Only' %} +~~~ scala +class Adder { + var sum = 0 + def add(x: Int): Unit = sum += x + add(1) +} +class LogAdder extends Adder { + private var added: Set[Int] = Set.empty + override def add(x: Int): Unit = { added += x; super.add(x) } +} +~~~ +{% endtab %} +{% endtabs %} + +This case can be refactored by moving the private state into a nested `object`, which is initialized on demand: + +{% tabs shared-initializer_6 %} +{% tab 'Scala 2 and 3' %} +~~~ scala +class Adder { + var sum = 0 + def add(x: Int): Unit = sum += x + add(1) +} +class LogAdder extends Adder { + private object state { + var added: Set[Int] = Set.empty + } + import state._ + override def add(x: Int): Unit = { added += x; super.add(x) } +} +~~~ +{% endtab %} +{% endtabs %} + ## Existential Type Existential type is a [dropped feature]({{ site.scala3ref }}/dropped-features/existential-types.html), which makes the following code invalid. From bc4c407e8ed348389967ab36ebef6b4c9a966f87 Mon Sep 17 00:00:00 2001 From: Lukas Rytz <lukas.rytz@gmail.com> Date: Fri, 26 May 2023 12:09:03 +0200 Subject: [PATCH 2621/3075] Update _overviews/scala3-migration/incompat-dropped-features.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Sébastien Doeraene <sjrdoeraene@gmail.com> --- _overviews/scala3-migration/incompat-dropped-features.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/incompat-dropped-features.md b/_overviews/scala3-migration/incompat-dropped-features.md index 03b4d35f80..afdbe00229 100644 --- a/_overviews/scala3-migration/incompat-dropped-features.md +++ b/_overviews/scala3-migration/incompat-dropped-features.md @@ -236,8 +236,9 @@ class Adder { def add(x: Int): Unit = sum += x add(1) } -class LogAdder extends Adder { +class LogAdder extends { private var added: Set[Int] = Set.empty +} with Adder { override def add(x: Int): Unit = { added += x; super.add(x) } } ~~~ From 7c3c3cb6eaeded04c584c65198fdc54655f81d37 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sat, 27 May 2023 13:49:59 +0800 Subject: [PATCH 2622/3075] add code tabs in English and Chinese ca-extension-methods.md --- .../scala3-book/ca-extension-methods.md | 35 +++++++++++++++++ .../scala3-book/ca-extension-methods.md | 38 +++++++++++++++++++ 2 files changed, 73 insertions(+) diff --git a/_overviews/scala3-book/ca-extension-methods.md b/_overviews/scala3-book/ca-extension-methods.md index 6c3bcb735c..4b9cf2ef24 100644 --- a/_overviews/scala3-book/ca-extension-methods.md +++ b/_overviews/scala3-book/ca-extension-methods.md @@ -17,33 +17,56 @@ In Scala 2, a similar result could be achieved with [implicit classes]({% link _ Extension methods let you add methods to a type after the type is defined, i.e., they let you add new methods to closed classes. For example, imagine that someone else has created a `Circle` class: +{% tabs ext1 %} +{% tab 'Scala 2 and 3' %} ```scala case class Circle(x: Double, y: Double, radius: Double) ``` +{% endtab %} +{% endtabs %} Now imagine that you need a `circumference` method, but you can’t modify their source code. Before the concept of term inference was introduced into programming languages, the only thing you could do was write a method in a separate class or object like this: +{% tabs ext2 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +object CircleHelpers { + def circumference(c: Circle): Double = c.radius * math.Pi * 2 +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala object CircleHelpers: def circumference(c: Circle): Double = c.radius * math.Pi * 2 ``` +{% endtab %} +{% endtabs %} Then you’d use that method like this: +{% tabs ext3 %} +{% tab 'Scala 2 and 3' %} ```scala val aCircle = Circle(2, 3, 5) // without extension methods CircleHelpers.circumference(aCircle) ``` +{% endtab %} +{% endtabs %} But with extension methods you can create a `circumference` method to work on `Circle` instances: +{% tabs ext4 %} +{% tab 'Scala 3 Only' %} ```scala extension (c: Circle) def circumference: Double = c.radius * math.Pi * 2 ``` +{% endtab %} +{% endtabs %} In this code: @@ -52,19 +75,27 @@ In this code: Then in your code you use `circumference` just as though it was originally defined in the `Circle` class: +{% tabs ext5 %} +{% tab 'Scala 3 Only' %} ```scala aCircle.circumference ``` +{% endtab %} +{% endtabs %} ### Import extension method Imagine, that `circumference` is defined in package `lib`, you can import it by +{% tabs ext6 %} +{% tab 'Scala 3 Only' %} ```scala import lib.circumference aCircle.circumference ``` +{% endtab %} +{% endtabs %} The compiler also supports you if the import is missing by showing a detailed compilation error message such as the following: @@ -81,11 +112,15 @@ The following import might fix the problem: The `extension` keyword declares that you’re about to define one or more extension methods on the type that’s put in parentheses. To define multiple extension methods on a type, use this syntax: +{% tabs ext7 %} +{% tab 'Scala 3 Only' %} ```scala extension (c: Circle) def circumference: Double = c.radius * math.Pi * 2 def diameter: Double = c.radius * 2 def area: Double = math.Pi * c.radius * c.radius ``` +{% endtab %} +{% endtabs %} diff --git a/_zh-cn/overviews/scala3-book/ca-extension-methods.md b/_zh-cn/overviews/scala3-book/ca-extension-methods.md index 2a8d4588ea..c0afeaa0bf 100644 --- a/_zh-cn/overviews/scala3-book/ca-extension-methods.md +++ b/_zh-cn/overviews/scala3-book/ca-extension-methods.md @@ -13,37 +13,63 @@ layout: multipage-overview permalink: "/zh-cn/scala3/book/:title.html" --- +在 Scala 2 中，用 [implicit classes]({% link _overviews/core/implicit-classes.md %}) 可以得到类似的结果。 + +--- 扩展方法允许您在定义类型后向类型添加方法，即它们允许您向封闭类添加新方法。 例如，假设其他人创建了一个 `Circle` 类： +{% tabs ext1 %} +{% tab 'Scala 2 and 3' %} ```scala case class Circle(x: Double, y: Double, radius: Double) ``` +{% endtab %} +{% endtabs %} 现在想象一下，你需要一个 `circumference` 方法，但是你不能修改它们的源代码。 在将术语推理的概念引入编程语言之前，您唯一能做的就是在单独的类或对象中编写一个方法，如下所示： +{% tabs ext2 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +object CircleHelpers { + def circumference(c: Circle): Double = c.radius * math.Pi * 2 +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala object CircleHelpers: def circumference(c: Circle): Double = c.radius * math.Pi * 2 ``` +{% endtab %} +{% endtabs %} 你可以像这样用该方法： +{% tabs ext3 %} +{% tab 'Scala 2 and 3' %} ```scala val aCircle = Circle(2, 3, 5) // without extension methods CircleHelpers.circumference(aCircle) ``` +{% endtab %} +{% endtabs %} 但是使用扩展方法，您可以创建一个 `circumference` 方法来处理 `Circle` 实例： +{% tabs ext4 %} +{% tab 'Scala 3 Only' %} ```scala extension (c: Circle) def circumference: Double = c.radius * math.Pi * 2 ``` +{% endtab %} +{% endtabs %} 在这段代码中： @@ -52,19 +78,27 @@ extension (c: Circle) 然后在您的代码中使用 `circumference`，就像它最初是在 `Circle` 类中定义的一样： +{% tabs ext5 %} +{% tab 'Scala 3 Only' %} ```scala aCircle.circumference ``` +{% endtab %} +{% endtabs %} ### 导入扩展方法 想象一下，`circumference` 定义在`lib` 包中，你可以通过以下方式导入它 +{% tabs ext6 %} +{% tab 'Scala 3 Only' %} ```scala import lib.circumference aCircle.circumference ``` +{% endtab %} +{% endtabs %} 如果缺少导入，编译器还会通过显示详细的编译错误消息来支持您，如下所示： @@ -81,9 +115,13 @@ The following import might fix the problem: `extension` 关键字声明您将要在括号中的类型上定义一个或多个扩展方法。 要在一个类型上定义多个扩展方法，请使用以下语法： +{% tabs ext7 %} +{% tab 'Scala 3 Only' %} ```scala extension (c: Circle) def circumference: Double = c.radius * math.Pi * 2 def diameter: Double = c.radius * 2 def area: Double = math.Pi * c.radius * c.radius ``` +{% endtab %} +{% endtabs %} From 7aebbd2d8633f4d298e983de138684d02f305447 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sat, 27 May 2023 15:24:32 +0800 Subject: [PATCH 2623/3075] modified Chinese ca-context-bounds.md --- .../scala3-book/ca-context-bounds.md | 90 +++++++++++++++---- 1 file changed, 75 insertions(+), 15 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index c7b81b6d12..d39a367ca0 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -14,41 +14,101 @@ permalink: "/zh-cn/scala3/book/:title.html" --- -{% comment %} -- TODO: define "context parameter" -- TODO: define "synthesized" and "synthesized arguments" -{% endcomment %} - - -在许多情况下，_上下文参数_的名称不必明确提及，因为它仅由编译器在其他上下文参数的合成参数中使用。 +在许多情况下，[上下文参数]({% link _overviews/scala3-book/ca-context-parameters.md %}#context-parameters) 的名称不必明确提及，因为它仅由编译器在其他上下文参数的合成参数中使用。 在这种情况下，您不必定义参数名称，只需提供参数类型即可。 ## 背景 -例如，这个 `maximum` 方法接受 `Ord` 类型的_上下文参数_，只是将它作为参数传递给 `max`： +例如，假设一个 `maxElement` 方法返回一个集合里的最大值： +{% tabs context-bounds-max-named-param class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -def maximum[A](xs: List[A])(using ord: Ord[A]): A = - xs.reduceLeft(max(ord)) +def maxElement[A](as: List[A])(implicit ord: Ord[A]): A = + as.reduceLeft(max(_, _)(ord)) ``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +def maxElement[A](as: List[A])(using ord: Ord[A]): A = + as.reduceLeft(max(_, _)(using ord)) +``` +{% endtab %} +{% endtabs %} + +`maxElement` 方法把一个 `Ord[A]` 类的 _上下文参数_ 当作参数只传给 `max` 方法。 -在该代码中，参数名称 `ord` 实际上不是必需的；它可以作为推断参数传递给 `max`，因此您只需声明 `maximum` 使用的类型 `Ord[A]` 而不必给它命名： +为了完整起见，以下是 `max` 和 `Ord` 的定义（请注意，在实践中我们会在 `List` 上使用现有的方法 `max`， +但我们为了说明目的而编造了这个例子）： +{% tabs context-bounds-max-ord class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -def maximum[A](xs: List[A])(using Ord[A]): A = - xs.reduceLeft(max) +/** Defines how to compare values of type `A` */ +trait Ord[A] { + def greaterThan(a1: A, a2: A): Boolean +} + +/** Returns the maximum of two values */ +def max[A](a1: A, a2: A)(implicit ord: Ord[A]): A = + if (ord.greaterThan(a1, a2)) a1 else a2 ``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +/** Defines how to compare values of type `A` */ +trait Ord[A]: + def greaterThan(a1: A, a2: A): Boolean + +/** Returns the maximum of two values */ +def max[A](a1: A, a2: A)(using ord: Ord[A]): A = + if ord.greaterThan(a1, a2) then a1 else a2 +``` +{% endtab %} +{% endtabs %} + +`max` 方法用了类 `Ord[A]` 的上下文参数, 就像 `maxElement` 方法。 + +## 省略上下文参数 + +因为 `ord` 是 `max` 方法的上下文参数，当我们调用方法 `max` 时， 编译器可以在 `maxElement` 的实现中为我们提供它： + +{% tabs context-bounds-context class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def maxElement[A](as: List[A])(implicit ord: Ord[A]): A = + as.reduceLeft(max(_, _)) +``` +{% endtab %} + +{% tab 'Scala 3' %} +```scala +def maxElement[A](as: List[A])(using Ord[A]): A = + as.reduceLeft(max(_, _)) +``` + +注意，因为我们不用显示传递给 `max` 方法，我们可以在 `maxElement` 定义里不命名。 +这是 _匿名上下文参数_ 。 +{% endtab %} +{% endtabs %} ## 上下文绑定 -鉴于此背景，_上下文绑定_是一种简写语法，用于表达“依赖于类型参数的上下文参数”模式。 +鉴于此背景，_上下文绑定_ 是一种简写语法，用于表达“依赖于类型参数的上下文参数”模式。 使用上下文绑定，`maximum` 方法可以这样写： +{% tabs context-bounds-max-rewritten %} +{% tab 'Scala 2 and 3' %} ```scala -def maximum[A: Ord](xs: List[A]): A = xs.reduceLeft(max) +def maxElement[A: Ord](as: List[A]): A = + as.reduceLeft(max(_, _)) ``` +{% endtab %} +{% endtabs %} 方法或类的类型参数 `A`，有类似 `:Ord` 的绑定，它表示有 `Ord[A]` 的上下文参数。 +在后台，编译器将此语法转换为“背景”部分中显示的语法。 有关上下文绑定的更多信息，请参阅 Scala 常见问题解答的 [“什么是上下文绑定？”](https://docs.scala-lang.org/tutorials/FAQ/context-bounds.html) 部分。 From 3644d11894ae497eee1238630ba9cf361bec40ab Mon Sep 17 00:00:00 2001 From: Simon R <szymonrodant@gmail.com> Date: Sat, 27 May 2023 09:26:32 +0200 Subject: [PATCH 2624/3075] Change installing munit to reflect changes in scala-cli (#2811) * Change installing munit to reflect changes in scala-cli * Adjust directives syntax * script -> source * Fix wording * Update _includes/_markdown/install-munit.md --------- Co-authored-by: adpi2 <adrien.piquerez@gmail.com> --- _includes/_markdown/install-munit.md | 5 +++-- _includes/_markdown/install-os-lib.md | 4 ++-- _includes/_markdown/install-sttp.md | 4 ++-- _includes/_markdown/install-upickle.md | 4 ++-- 4 files changed, 9 insertions(+), 8 deletions(-) diff --git a/_includes/_markdown/install-munit.md b/_includes/_markdown/install-munit.md index e79aca2e44..8b39dd0c0d 100644 --- a/_includes/_markdown/install-munit.md +++ b/_includes/_markdown/install-munit.md @@ -4,12 +4,13 @@ {% tab 'Scala CLI' %} You can require the entire toolkit in a single line: ```scala -//> using dep "org.scala-lang::toolkit-test:0.1.7" +//> using toolkit latest ``` +MUnit, being a testing framework, is only available in test files: files in a `test` directory or ones that have the `.test.scala` extension. Refer to the [Scala CLI documentation](https://scala-cli.virtuslab.org/docs/commands/test/) to learn more about the test scope. Alternatively, you can require just a specific version of MUnit: ```scala -//> using dep "org.scalameta::munit:1.0.0-M7" +//> using dep org.scalameta::munit:1.0.0-M7 ``` {% endtab %} {% tab 'sbt' %} diff --git a/_includes/_markdown/install-os-lib.md b/_includes/_markdown/install-os-lib.md index 0d3057c0e9..2eed875fd5 100644 --- a/_includes/_markdown/install-os-lib.md +++ b/_includes/_markdown/install-os-lib.md @@ -4,12 +4,12 @@ {% tab 'Scala CLI' %} You can require the entire toolkit in a single line: ```scala -//> using toolkit "latest" +//> using toolkit latest ``` Alternatively, you can require just a specific version of OS-Lib: ```scala -//> using dep "com.lihaoyi::os-lib:0.9.1" +//> using dep com.lihaoyi::os-lib:0.9.1 ``` {% endtab %} {% tab 'sbt' %} diff --git a/_includes/_markdown/install-sttp.md b/_includes/_markdown/install-sttp.md index 16cd90f485..e4eaf1b4a4 100644 --- a/_includes/_markdown/install-sttp.md +++ b/_includes/_markdown/install-sttp.md @@ -4,12 +4,12 @@ {% tab 'Scala CLI' %} You can require the entire toolkit in a single line: ```scala -//> using toolkit "latest" +//> using toolkit latest ``` Alternatively, you can require just a specific version of sttp: ```scala -//> using dep "com.softwaremill.sttp.client4::core:4.0.0-M1" +//> using dep com.softwaremill.sttp.client4::core:4.0.0-M1 ``` {% endtab %} {% tab 'sbt' %} diff --git a/_includes/_markdown/install-upickle.md b/_includes/_markdown/install-upickle.md index 2160f4dc91..e1f478bcc2 100644 --- a/_includes/_markdown/install-upickle.md +++ b/_includes/_markdown/install-upickle.md @@ -4,12 +4,12 @@ {% tab 'Scala CLI' %} Using Scala CLI, you can require the entire toolkit in a single line: ```scala -//> using toolkit "latest" +//> using toolkit latest ``` Alternatively, you can require just a specific version of UPickle: ```scala -//> using dep "com.lihaoyi::upickle:3.1.0 +//> using dep com.lihaoyi::upickle:3.1.0 ``` {% endtab %} {% tab 'sbt' %} From 97c9ca679d4431ffa497ff6dd35ee7ca2b61a134 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Mon, 29 May 2023 21:20:35 +0200 Subject: [PATCH 2625/3075] use border-collapse on tables (#2820) --- _sass/layout/type-md.scss | 1 + 1 file changed, 1 insertion(+) diff --git a/_sass/layout/type-md.scss b/_sass/layout/type-md.scss index 88b98e8fd6..6548b1ff60 100755 --- a/_sass/layout/type-md.scss +++ b/_sass/layout/type-md.scss @@ -194,6 +194,7 @@ table { width: 100%; text-align: left; + border-collapse: collapse; thead { font-weight: $font-bold; From bd96a1204c51675efc83a2d2137fba65dc1f693f Mon Sep 17 00:00:00 2001 From: Izmar Verhage <izmar.verhage@jetbrains.com> Date: Tue, 30 May 2023 11:06:21 +0200 Subject: [PATCH 2626/3075] Fix extension methods typo --- _ja/overviews/core/value-classes.md | 2 +- _overviews/core/value-classes.md | 2 +- _zh-cn/overviews/core/value-classes.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_ja/overviews/core/value-classes.md b/_ja/overviews/core/value-classes.md index 72df60ede9..6b10b762e5 100644 --- a/_ja/overviews/core/value-classes.md +++ b/_ja/overviews/core/value-classes.md @@ -51,7 +51,7 @@ language: ja def toHexString: String = java.lang.Integer.toHexString(self) } -実行時には、この `3.toHexString` という式は、新しくインスタンス化されるオブジェクトへのメソッド呼び出しではなく、静的なオブジェクトへのメソッド呼び出しと同様のコード (`RichInt$.MODULE$.extension$toHexString(3)`) へと最適化される。 +実行時には、この `3.toHexString` という式は、新しくインスタンス化されるオブジェクトへのメソッド呼び出しではなく、静的なオブジェクトへのメソッド呼び出しと同様のコード (`RichInt$.MODULE$.toHexString$extension(3)`) へと最適化される。 ## 正当性 diff --git a/_overviews/core/value-classes.md b/_overviews/core/value-classes.md index c50a867745..46d63f9e3a 100644 --- a/_overviews/core/value-classes.md +++ b/_overviews/core/value-classes.md @@ -53,7 +53,7 @@ The following fragment of `RichInt` shows how it extends `Int` to allow the expr } At runtime, this expression `3.toHexString` is optimised to the equivalent of a method call on a static object -(`RichInt$.MODULE$.extension$toHexString(3)`), rather than a method call on a newly instantiated object. +(`RichInt$.MODULE$.toHexString$extension(3)`), rather than a method call on a newly instantiated object. ## Correctness diff --git a/_zh-cn/overviews/core/value-classes.md b/_zh-cn/overviews/core/value-classes.md index a04b3a958b..9b9446a94b 100644 --- a/_zh-cn/overviews/core/value-classes.md +++ b/_zh-cn/overviews/core/value-classes.md @@ -43,7 +43,7 @@ Value class只能继承universal traits，但其自身不能再被继承。所 def toHexString: String = java.lang.Integer.toHexString(self) } -在运行时，表达式3.toHexString 被优化并等价于静态对象的方法调用 （RichInt$.MODULE$.extension$toHexString(3)），而不是创建一个新实例对象，再调用其方法。 +在运行时，表达式3.toHexString 被优化并等价于静态对象的方法调用 （RichInt$.MODULE$.toHexString$extension(3)），而不是创建一个新实例对象，再调用其方法。 ## 正确性 From 270360d91f6a8bbb500495214773cb74287e09ed Mon Sep 17 00:00:00 2001 From: Lucas <leblanc.lucas29@gmail.com> Date: Fri, 26 May 2023 12:17:10 +0200 Subject: [PATCH 2627/3075] Refactor: Add documentation for redirectTo/redirectFrom --- _overviews/scala3-scaladoc/static-site.md | 57 +++++++++++++++++++---- 1 file changed, 49 insertions(+), 8 deletions(-) diff --git a/_overviews/scala3-scaladoc/static-site.md b/_overviews/scala3-scaladoc/static-site.md index 12377e8901..763ea11fe0 100644 --- a/_overviews/scala3-scaladoc/static-site.md +++ b/_overviews/scala3-scaladoc/static-site.md @@ -97,6 +97,35 @@ Predefined properties: - **hasFrame** when set to `false` page will not include default layout (navigation, breadcrumbs, etc.) but only token HTML wrapper to provide metadata and resources (js and css files). **This setting is not exported to the template engine.** - **layout** - predefined layout to use, see below. **This setting is not exported to the template engine.** +Redirection properties: + +In addition to the predefined properties, Scaladoc also supports redirection properties, which allow you to redirect from one page to another. This can be useful when you move a page to a new location but want to keep the old URL working. + +- **redirectFrom** - Specifies the URL from which you want to redirect. By using the `redirectFrom` property, Scaladoc generates an empty page at the specified URL, which includes a browser-based redirection to the new location. + +Example: + +``` +--- +redirectFrom: /absolute/path/to/old/url.html +--- +``` + +In the above example, if you move the page from `/absolute/path/to/old/url.html` to a new location, you can use `redirectFrom` to ensure that the old URL still redirects to the new location. + +Please note that the `redirectFrom` property was inspired by the Jekyll plugin called [`jekyll-redirect-from`](https://github.com/jekyll/jekyll-redirect-from) . + +- **redirectTo** - Specifies the URL to which you want to redirect. This property is useful when you want to redirect to an external page or when you can't use `redirectFrom`. + +Example: + +``` +--- +redirectTo: https://docs.scala-lang.org/ +--- +``` + +In the above example, the page will be redirected to `https://docs.scala-lang.org/`. ## Using existing Templates and Layouts @@ -114,6 +143,7 @@ layout: main With a simple main template like this: {% raw %} + ```html <html> <head> @@ -142,6 +172,7 @@ Layouts must be placed in a `_layouts` directory in the site root: ## Assets In order to render assets along with static site, they need to be placed in the `_assets` directory in the site root: + ``` ├── _assets │ └── images @@ -149,6 +180,7 @@ In order to render assets along with static site, they need to be placed in the └── _docs └── getting-started.md ``` + To reference the asset on a page, one needs to create a link relative to the `_assets` directory ``` @@ -173,24 +205,27 @@ subsection: page: usage/sbt-projects.html hidden: false ``` + The root element needs to be a `subsection`. Nesting subsections will result in a tree-like structure of navigation. `subsection` properties are: - - `title` - Optional string - A default title of the subsection. + +- `title` - Optional string - A default title of the subsection. Front-matter titles have higher priorities. - - `index` - Optional string - A path to index page of a subsection. The path is relative to the `_docs` directory. - - `directory` - Optional string - A name of the directory that will contain the subsection in the generated site. +- `index` - Optional string - A path to index page of a subsection. The path is relative to the `_docs` directory. +- `directory` - Optional string - A name of the directory that will contain the subsection in the generated site. By default, the directory name is the subsection name converted to kebab case. - - `subsection` - Array of `subsection` or `page`. +- `subsection` - Array of `subsection` or `page`. Either `index` or `subsection` must be defined. The subsection defined with `index` and without `subsection` will contain pages and directories loaded recursively from the directory of the index page. `page` properties are: - - `title` - Optional string - A default title of the page. + +- `title` - Optional string - A default title of the page. Front-matter titles have higher priorities. - - `page` - String - A path to the page, relative to the `_docs` directory. - - `hidden` - Optional boolean - A flag that indicates whether the page should be visible in the navigation sidebar. By default, it is set to `false`. +- `page` - String - A path to the page, relative to the `_docs` directory. +- `hidden` - Optional boolean - A flag that indicates whether the page should be visible in the navigation sidebar. By default, it is set to `false`. **Note**: All the paths in the YAML configuration file are relative to `<static-root>/_docs`. @@ -213,10 +248,13 @@ If the title is specified multiple times, the priority is as follows (from highe Note that if you skip the `index` file in your tree structure or you don't specify the `title` in the frontmatter, there will be given a generic name `index`. The same applies when using `sidebar.yml` but not specifying `title` nor `index`, just a subsection. Again, a generic `index` name will appear. ## Blog + Blog feature is described in [a separate document]({% link _overviews/scala3-scaladoc/blog.md %}) ## Advanced configuration + ### Full structure of site root + ``` . └── <site-root>/ @@ -235,6 +273,7 @@ Blog feature is described in [a separate document]({% link _overviews/scala3-sca │ └── ... └── ... ``` + It results in a static site containing documents as well as a blog. It also contains custom layouts and assets. The structure of the rendered documentation can be based on the file system but it can also be overridden by YAML configuration. ### Mapping directory structure @@ -242,6 +281,7 @@ It results in a static site containing documents as well as a blog. It also cont Using the YAML configuration file, we can define how the source directory structure should be transformed into an outputs directory structure. Take a look at the following subsection definition: + ```yaml - title: Some other subsection index: abc/index.html @@ -250,7 +290,8 @@ Take a look at the following subsection definition: - page: abc2/page1.md - page: foo/page2.md ``` + This subsection shows the ability of YAML configuration to map the directory structure. Even though the index page and all defined children are in different directories, they will be rendered in `custom-directory`. -The source page `abc/index.html` will generate a page `custom-directory/index.html`, the source page `abc2/page1.md` will generate a page `custom-directory/page1.html`, +The source page `abc/index.html` will generate a page `custom-directory/index.html`, the source page `abc2/page1.md` will generate a page `custom-directory/page1.html`, and the source page `foo/page2.md` will generate a page `custom-directory/page2.html`. From 58320dfbaf998db060a925b176cf76d9d3f886e3 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Tue, 30 May 2023 13:23:20 +0200 Subject: [PATCH 2628/3075] Remove broken link --- _sips/minutes/2018-11-26-sip-minutes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/minutes/2018-11-26-sip-minutes.md b/_sips/minutes/2018-11-26-sip-minutes.md index a177b78833..6b9bc8f10f 100644 --- a/_sips/minutes/2018-11-26-sip-minutes.md +++ b/_sips/minutes/2018-11-26-sip-minutes.md @@ -105,7 +105,7 @@ Implicit Function Types (https://dotty.epfl.ch/docs/reference/instances/implicit [Type Lambdas](https://dotty.epfl.ch/docs/reference/new-types/type-lambdas.html) -[Type Checking](https://dotty.epfl.ch/docs/reference/changed-features/type-checking.html) +Type Checking [Type Inference](https://dotty.epfl.ch/docs/reference/changed-features/type-inference.html) From 95e1de9ec1b20935c2808892dc61eb1705f4425e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= <pmarks@virtuslab.com> Date: Tue, 30 May 2023 07:00:03 -0700 Subject: [PATCH 2629/3075] Update Scala to 3.3.0 (#2826) --- _config.yml | 2 +- api/all.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index 02ccc1703c..fcf35a3fac 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.10 scala-212-version: 2.12.17 -scala-3-version: 3.2.2 +scala-3-version: 3.3.0 collections: style: diff --git a/api/all.md b/api/all.md index 7b5bb49c36..3204c6a3c2 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,8 @@ redirect_from: ## Latest releases -* Scala 3.2.2 - * [Library API](https://www.scala-lang.org/api/3.2.2/) +* Scala 3.3.0 LTS + * [Library API](https://www.scala-lang.org/api/3.3.0/) * Scala 2.13.10 * [Library API](https://www.scala-lang.org/api/2.13.10/) * [Compiler API](https://www.scala-lang.org/api/2.13.10/scala-compiler/scala/) @@ -62,6 +62,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.2.2 + * [Library API](https://www.scala-lang.org/api/3.2.2/) * Scala 3.2.1 * [Library API](https://www.scala-lang.org/api/3.2.1/) * Scala 3.2.0 From 6a6509bc4ff3fc68ba99dfa660ee44f82714feec Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 31 May 2023 19:45:05 -0700 Subject: [PATCH 2630/3075] Scala 2.12.18 --- _config.yml | 2 +- api/all.md | 22 +++++++++++++++------- 2 files changed, 16 insertions(+), 8 deletions(-) diff --git a/_config.yml b/_config.yml index fcf35a3fac..ccb4c2c5f6 100644 --- a/_config.yml +++ b/_config.yml @@ -16,7 +16,7 @@ keywords: - Guide scala-version: 2.13.10 -scala-212-version: 2.12.17 +scala-212-version: 2.12.18 scala-3-version: 3.3.0 collections: diff --git a/api/all.md b/api/all.md index 3204c6a3c2..694c5a0df4 100644 --- a/api/all.md +++ b/api/all.md @@ -14,14 +14,14 @@ redirect_from: * [Library API](https://www.scala-lang.org/api/2.13.10/) * [Compiler API](https://www.scala-lang.org/api/2.13.10/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.10/scala-reflect/scala/reflect/) -* Scala 2.12.17 - * [Library API](https://www.scala-lang.org/api/2.12.17/) - * [Compiler API](https://www.scala-lang.org/api/2.12.17/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.12.17/scala-reflect/scala/reflect/) +* Scala 2.12.18 + * [Library API](https://www.scala-lang.org/api/2.12.18/) + * [Compiler API](https://www.scala-lang.org/api/2.12.18/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.12.18/scala-reflect/scala/reflect/) * Scala Modules - * [XML API](https://www.scala-lang.org/api/2.12.17/scala-xml/scala/xml/) - * [Parser Combinators API](https://www.scala-lang.org/api/2.12.17/scala-parser-combinators/scala/util/parsing/) - * [Swing API](https://www.scala-lang.org/api/2.12.17/scala-swing/scala/swing/) + * [XML API](https://www.scala-lang.org/api/2.12.18/scala-xml/scala/xml/) + * [Parser Combinators API](https://www.scala-lang.org/api/2.12.18/scala-parser-combinators/scala/util/parsing/) + * [Swing API](https://www.scala-lang.org/api/2.12.18/scala-swing/scala/swing/) * Scala 2.11.12 * [Library API](https://www.scala-lang.org/api/2.11.12/) * [Compiler API](https://www.scala-lang.org/api/2.11.12/scala-compiler/) @@ -122,6 +122,14 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/2.13.0/) * [Compiler API](https://www.scala-lang.org/api/2.13.0/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.0/scala-reflect/scala/reflect/) +* Scala 2.12.17 + * [Library API](https://www.scala-lang.org/api/2.12.17/) + * [Compiler API](https://www.scala-lang.org/api/2.12.17/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.12.17/scala-reflect/scala/reflect/) + * Scala Modules + * [XML API](https://www.scala-lang.org/api/2.12.17/scala-xml/scala/xml/) + * [Parser Combinators API](https://www.scala-lang.org/api/2.12.17/scala-parser-combinators/scala/util/parsing/) + * [Swing API](https://www.scala-lang.org/api/2.12.17/scala-swing/scala/swing/) * Scala 2.12.16 * [Library API](https://www.scala-lang.org/api/2.12.16/) * [Compiler API](https://www.scala-lang.org/api/2.12.16/scala-compiler/scala/) From fac4881552398775a2ed05e240c2b5517962d96e Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 31 May 2023 19:51:32 -0700 Subject: [PATCH 2631/3075] JDK compat page: Scala 3.3.0, JDK 21 --- _overviews/jdk-compatibility/overview.md | 25 +++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 8cb312c2f0..1cebf9dcda 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,7 +12,8 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | JDK version | Minimum Scala versions | |:-----------:|:-------------------------------------------------------------| -| 20 | 3.3.0 (soon), 2.13.11 (soon), 2.12.18 (soon) | +| 21 (ea) | 3.3.1 (soon), 2.13.11 (soon), 2.12.18 (soon) | +| 20 | 3.3.0, 2.13.11 (soon), 2.12.18 (soon) | | 19 | 3.2.0, 2.13.9, 2.12.16 | | 18 | 3.1.3, 2.13.7, 2.12.15 | | 17 (LTS) | 3.0.0, 2.13.6, 2.12.15 | @@ -96,23 +97,25 @@ Support for JDK 19 was included in Scala 2.13.9 and 2.12.16. JDK 20, a non-LTS release, came out in March 2023. +Support for JDK 20 is included in Scala 3.3.0. + Support for JDK 20 has already been merged and is available in [nightly builds](https://stackoverflow.com/questions/40622878/how-do-i-tell-sbt-or-scala-cli-to-use-a-nightly-build-of-scala-2-12-or-2-13) -of Scala 2.12, 2.13, and 3. +of Scala 2.12 and 2.13. -The support will be included in forthcoming Scala releases: 2.12.18, -2.13.11, and 3.3.0. We hope to release these in April 2023, or not -long after. +The support will be included in forthcoming Scala releases 2.12.18 +and 2.13.11. We expect to release these in June 2023. -<!-- ## JDK 21 compatibility notes -Early access builds of JDK 21, a non-LTS release, are already available. +Early access builds of JDK 21 are already available. JDK 21 will +be an LTS release. -Initial support for JDK 20 has been merged and is already available in -nightly builds of Scala 2.12, 2.13, and 3. (The support will be -included in forthcoming Scala releases: 2.12.19, 2.13.12, and 3.3.1.) ---> +Initial support for JDK 21 has been merged and is already available in +nightly builds of Scala 2.12, 2.13, and 3. + +The support will be included in forthcoming Scala releases: 2.12.18, +2.13.11, and 3.3.1. ## GraalVM Native Image compatibility notes From ee9a0b1eb9a88715d7d6fa215c0138c93cb70e4c Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 31 May 2023 20:07:33 -0700 Subject: [PATCH 2632/3075] update JDK compat page for 2.12.18 release --- _overviews/jdk-compatibility/overview.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 1cebf9dcda..2203b6dd31 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,8 +12,8 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | JDK version | Minimum Scala versions | |:-----------:|:-------------------------------------------------------------| -| 21 (ea) | 3.3.1 (soon), 2.13.11 (soon), 2.12.18 (soon) | -| 20 | 3.3.0, 2.13.11 (soon), 2.12.18 (soon) | +| 21 (ea) | 3.3.1 (soon), 2.13.11 (soon), 2.12.18 | +| 20 | 3.3.0, 2.13.11 (soon), 2.12.18 | | 19 | 3.2.0, 2.13.9, 2.12.16 | | 18 | 3.1.3, 2.13.7, 2.12.15 | | 17 (LTS) | 3.0.0, 2.13.6, 2.12.15 | @@ -97,14 +97,14 @@ Support for JDK 19 was included in Scala 2.13.9 and 2.12.16. JDK 20, a non-LTS release, came out in March 2023. -Support for JDK 20 is included in Scala 3.3.0. +Support for JDK 20 was included in Scala 3.3.0 and 2.12.18. Support for JDK 20 has already been merged and is available in [nightly builds](https://stackoverflow.com/questions/40622878/how-do-i-tell-sbt-or-scala-cli-to-use-a-nightly-build-of-scala-2-12-or-2-13) -of Scala 2.12 and 2.13. +of 2.13. -The support will be included in forthcoming Scala releases 2.12.18 -and 2.13.11. We expect to release these in June 2023. +The support will be included in the forthcoming Scala release +2.13.11. We expect to release it in June 2023. ## JDK 21 compatibility notes @@ -112,10 +112,10 @@ Early access builds of JDK 21 are already available. JDK 21 will be an LTS release. Initial support for JDK 21 has been merged and is already available in -nightly builds of Scala 2.12, 2.13, and 3. +Scala 2.12.18 and in nightly builds of Scala 2.13 and Scala 3. -The support will be included in forthcoming Scala releases: 2.12.18, -2.13.11, and 3.3.1. +The support will be included in the forthcoming Scala releases +2.13.11 and 3.3.1. ## GraalVM Native Image compatibility notes From 53019d79e7c861791c7022ac02689e03a07fc5d6 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 1 Jun 2023 16:32:46 -0700 Subject: [PATCH 2633/3075] Scala 2.13.11 --- _config.yml | 2 +- _overviews/FAQ/index.md | 6 +++--- _overviews/contribute/bug-reporting-guide.md | 2 +- api/all.md | 12 ++++++++---- scripts/run-mdoc.sh | 4 ++-- 5 files changed, 15 insertions(+), 11 deletions(-) diff --git a/_config.yml b/_config.yml index fcf35a3fac..10eda71ecd 100644 --- a/_config.yml +++ b/_config.yml @@ -15,7 +15,7 @@ keywords: - Document - Guide -scala-version: 2.13.10 +scala-version: 2.13.11 scala-212-version: 2.12.17 scala-3-version: 3.3.0 diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index ca4538daae..0420ecc64b 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -124,7 +124,7 @@ Welcome to Scala 3.2.0 (17.0.3, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. scala> util.Properties.versionNumberString -val res0: String = 2.13.10 +val res0: String = 2.13.11 ``` Note that Scala 3 offers @@ -312,14 +312,14 @@ setting in a multi-project build. For example, if you add this to your `build.sbt`: - scalaVersion := "2.13.10" + scalaVersion := "2.13.11" that's a "bare" setting, and you might expect it to apply build-wide. But it doesn't. _It only applies to the root project._ In many cases one should instead write: - ThisBuild / scalaVersion := "2.13.10" + ThisBuild / scalaVersion := "2.13.11" Other possibilities include: diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index c59279877e..9787238073 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -65,7 +65,7 @@ If you cannot find your issue in the issue tracker, create a new bug. The detail Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - 1. **Exact Scala version** that you are using. For example, `2.13.10` or `3.2.0`. If the bug happens in multiple versions indicate all of them. + 1. **Exact Scala version** that you are using. For example, `2.13.11` or `3.3.0`. If the bug happens in multiple versions indicate all of them. 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? diff --git a/api/all.md b/api/all.md index 3204c6a3c2..2512f5a4ab 100644 --- a/api/all.md +++ b/api/all.md @@ -10,10 +10,10 @@ redirect_from: * Scala 3.3.0 LTS * [Library API](https://www.scala-lang.org/api/3.3.0/) -* Scala 2.13.10 - * [Library API](https://www.scala-lang.org/api/2.13.10/) - * [Compiler API](https://www.scala-lang.org/api/2.13.10/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.13.10/scala-reflect/scala/reflect/) +* Scala 2.13.11 + * [Library API](https://www.scala-lang.org/api/2.13.11/) + * [Compiler API](https://www.scala-lang.org/api/2.13.11/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.11/scala-reflect/scala/reflect/) * Scala 2.12.17 * [Library API](https://www.scala-lang.org/api/2.12.17/) * [Compiler API](https://www.scala-lang.org/api/2.12.17/scala-compiler/scala/) @@ -82,6 +82,10 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.0.1/) * Scala 3.0.0 * [Library API](https://www.scala-lang.org/api/3.0.0/) +* Scala 2.13.10 + * [Library API](https://www.scala-lang.org/api/2.13.10/) + * [Compiler API](https://www.scala-lang.org/api/2.13.10/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.10/scala-reflect/scala/reflect/) * Scala 2.13.9 * [Library API](https://www.scala-lang.org/api/2.13.9/) * [Compiler API](https://www.scala-lang.org/api/2.13.9/scala-compiler/scala/) diff --git a/scripts/run-mdoc.sh b/scripts/run-mdoc.sh index a4f4acbe2a..d74316b9c0 100755 --- a/scripts/run-mdoc.sh +++ b/scripts/run-mdoc.sh @@ -1,11 +1,11 @@ #!/bin/bash set -eux -cs launch --scala-version 2.13.10 org.scalameta::mdoc:2.3.3 -- \ +cs launch --scala-version 2.13.11 org.scalameta::mdoc:2.3.3 -- \ --in . \ --out /tmp/mdoc-out/ \ --classpath \ - $(cs fetch --scala-version 2.13.10 -p \ + $(cs fetch --scala-version 2.13.11 -p \ com.chuusai::shapeless:2.3.10 \ org.scala-lang::toolkit:0.1.7 \ org.scala-lang::toolkit-test:0.1.7 \ From 689ff8f3c1ddc086240bd0c02786b6090640a145 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Thu, 1 Jun 2023 18:03:24 +0200 Subject: [PATCH 2634/3075] Update and fix the library author guide - Use plugin versions available on Maven Central - Fix a couple of rendering issues --- _overviews/contributors/index.md | 50 ++++++++++++++++++++------------ 1 file changed, 32 insertions(+), 18 deletions(-) diff --git a/_overviews/contributors/index.md b/_overviews/contributors/index.md index 24958703e2..113b27838d 100644 --- a/_overviews/contributors/index.md +++ b/_overviews/contributors/index.md @@ -146,8 +146,8 @@ and [sbt-pgp](https://www.scala-sbt.org/sbt-pgp/) plugins to publish your artifa dependencies to your `project/plugins.sbt` file: ~~~ scala -addSbtPlugin("org.xerial.sbt" % "sbt-sonatype" % "3.9.7") -addSbtPlugin("com.jsuereth" % "sbt-pgp" % "2.1.1") +addSbtPlugin("org.xerial.sbt" % "sbt-sonatype" % "3.9.21") +addSbtPlugin("com.github.sbt" % "sbt-pgp" % "2.2.1") ~~~ And make sure your build fulfills the [Sonatype requirements](https://central.sonatype.org/publish/requirements) @@ -189,7 +189,7 @@ Last, we recommend using the [sbt-dynver](https://github.com/dwijnand/sbt-dynver of your releases. Add the following dependency to your `project/plugins.sbt` file: ~~~ scala -addSbtPlugin("com.dwijnand" % "sbt-dynver" % "4.1.1") +addSbtPlugin("com.github.sbt" % "sbt-dynver" % "5.0.1") ~~~ And make sure your build does **not** define the `version` setting. @@ -234,6 +234,15 @@ Continuous publication addresses these issues by delegating the publication proc follows: any contributor with write access to the repository can cut a release by pushing a Git tag, the CI server first checks that the tests pass and then runs the publication commands. +We achieve this by replacing the plugins `sbt-pgp`, `sbt-sonatype`, and `sbt-dynver` with `sbt-ci-release`, in the file `project/plugins.sbt`: + +{% highlight diff %} +- addSbtPlugin("com.github.sbt" % "sbt-pgp" % "2.2.1") +- addSbtPlugin("org.xerial.sbt" % "sbt-sonatype" % "3.9.21") +- addSbtPlugin("com.github.sbt" % "sbt-dynver" % "5.0.1") ++ addSbtPlugin("com.github.sbt" % "sbt-ci-release" % "1.5.12") +{% endhighlight %} + The remaining sections show how to setup GitHub Actions for continuous publication on Sonatype. You can find instructions for Travis CI in the [sbt-ci-release](https://github.com/olafurpg/sbt-ci-release) plugin documentation. @@ -298,14 +307,14 @@ gpg --armor --export %LONG_ID% #### Publish From the CI Server -On GitHub Actions, you can define a workflow to publish the library when a tag is pushed: +On GitHub Actions, you can define a workflow to publish the library when a tag starting with “v” is pushed: -~~~ yaml +{% highlight yaml %} +{% raw %} # .github/workflows/publish.yml name: Continuous publication on: push: - branches: ['**'] tags: [v*] jobs: @@ -326,7 +335,8 @@ jobs: PGP_SECRET: ${{ secrets.PGP_SECRET }} SONATYPE_PASSWORD: ${{ secrets.SONATYPE_PASSWORD }} SONATYPE_USERNAME: ${{ secrets.SONATYPE_USERNAME }} -~~~ +{% endraw %} +{% endhighlight %} The `env` statement exposes the secrets you defined earlier to the publication process through environment variables. @@ -340,15 +350,17 @@ $ git tag v0.2.0 $ git push origin v0.2.0 ~~~ +This will trigger the workflow, which will ultimately invoke `sbt ci-release`, which will perform a `publishSigned` followed by a `sonatypeRelease`. + ## Cross-Publish -If you have written a library, you probably want it to be usable from several Scala major versions (e.g., 2.11.x, -2.12.x, 2.13.x, etc.). +If you have written a library, you probably want it to be usable from several Scala major versions (e.g., +2.12.x, 2.13.x, 3.x, etc.). Define the versions you want to support in the `crossScalaVersions` setting, in your `build.sbt` file: ~~~ scala -crossScalaVersions := Seq("2.13.6", "2.12.14") +crossScalaVersions := Seq("3.3.0", "2.13.11", "2.12.18") scalaVersion := crossScalaVersions.value.head ~~~ @@ -381,19 +393,17 @@ most other documentation generators, which are based on Ruby, Node.js or Python) To install Paradox and sbt-site, add the following lines to your `project/plugins.sbt` file: ~~~ scala -addSbtPlugin("com.typesafe.sbt" % "sbt-site" % "1.4.1") -addSbtPlugin("com.lightbend.paradox" % "sbt-paradox" % "0.9.2") +addSbtPlugin("com.github.sbt" % "sbt-site-paradox" % "1.5.0") ~~~ And then add the following configuration to your `build.sbt` file: {% highlight scala %} -enablePlugins(ParadoxPlugin, ParadoxSitePlugin) +enablePlugins(ParadoxSitePlugin, SitePreviewPlugin) Paradox / sourceDirectory := sourceDirectory.value / "documentation" {% endhighlight %} -The `ParadoxPlugin` is responsible for generating the website, and the `ParadoxSitePlugin` provides -integration with `sbt-site`. +The `ParadoxSitePlugin` provides a task `makeSite` that generates a website using [Paradox](https://developer.lightbend.com/docs/paradox/current/), and the `SitePreviewPlugin` provides handy tasks when working on the website content, to preview the result in your browser. The second line is optional, it defines the location of the website source files. In our case, in `src/documentation`. @@ -402,6 +412,7 @@ uses the library name as title, shows a short sentence describing the purpose of snippet for adding the library to a build definition: {% highlight markdown %} +{% raw %} # Library Example A library that does nothing. @@ -420,6 +431,7 @@ libraryDependencies += "ch.epfl.scala" %% "library-example" % "$project.version$ * [Getting Started](getting-started.md) * [Reference](reference.md) @@@ +{% endraw %} {% endhighlight %} Note that in our case we rely on a variable substitution mechanism to inject the correct version number @@ -482,11 +494,13 @@ You can embed the fragment surrounded by the `#do-nothing` identifiers with the as shown in the `src/documentation/reference.md` file: {% highlight markdown %} +{% raw %} # Reference The `doNothing` function takes anything as parameter and returns it unchanged: @@snip [Usage.scala]($root$/src/test/scala/ch/epfl/scala/Usage.scala) { #do-nothing } +{% endraw %} {% endhighlight %} The resulting documentation looks like the following: @@ -523,7 +537,7 @@ The `@scaladoc` directive will produce a link to the `/api/ch/epfl/scala/Example Add the `sbt-ghpages` plugin to your `project/plugins.sbt`: ~~~ scala -addSbtPlugin("com.typesafe.sbt" % "sbt-ghpages" % "0.6.3") +addSbtPlugin("com.github.sbt" % "sbt-ghpages" % "0.8.0") ~~~ And add the following configuration to your `build.sbt`: @@ -559,7 +573,7 @@ can browse it at [https://scalacenter.github.io/library-example/](https://scalac You can extend `.github/workflows/publish.yml` to automatically publish documentation to GitHub pages. To do so, add another job: -```yml +```yaml # .github/workflows/publish.yml name: Continuous publication @@ -651,7 +665,7 @@ break this versioning policy. Add the `sbt-mima-plugin` to your build with the f `project/plugins.sbt` file: ~~~ scala -addSbtPlugin("com.typesafe" % "sbt-mima-plugin" % "0.9.2") +addSbtPlugin("com.typesafe" % "sbt-mima-plugin" % "1.1.2") ~~~ Configure it as follows, in `build.sbt`: From 9172460ffef0cb965578229d831623ae19c5df16 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 7 Jun 2023 09:22:27 -0700 Subject: [PATCH 2635/3075] update JDK compat page for 2.13.11 --- _overviews/jdk-compatibility/overview.md | 18 +++++------------- 1 file changed, 5 insertions(+), 13 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 2203b6dd31..2f4bcf10d2 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,8 +12,8 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | JDK version | Minimum Scala versions | |:-----------:|:-------------------------------------------------------------| -| 21 (ea) | 3.3.1 (soon), 2.13.11 (soon), 2.12.18 | -| 20 | 3.3.0, 2.13.11 (soon), 2.12.18 | +| 21 (ea) | 3.3.1 (soon), 2.13.11, 2.12.18 | +| 20 | 3.3.0, 2.13.11, 2.12.18 | | 19 | 3.2.0, 2.13.9, 2.12.16 | | 18 | 3.1.3, 2.13.7, 2.12.15 | | 17 (LTS) | 3.0.0, 2.13.6, 2.12.15 | @@ -97,14 +97,7 @@ Support for JDK 19 was included in Scala 2.13.9 and 2.12.16. JDK 20, a non-LTS release, came out in March 2023. -Support for JDK 20 was included in Scala 3.3.0 and 2.12.18. - -Support for JDK 20 has already been merged and is available in -[nightly builds](https://stackoverflow.com/questions/40622878/how-do-i-tell-sbt-or-scala-cli-to-use-a-nightly-build-of-scala-2-12-or-2-13) -of 2.13. - -The support will be included in the forthcoming Scala release -2.13.11. We expect to release it in June 2023. +Support for JDK 20 was included in Scala 3.3.0, 2.13.11, and 2.12.18. ## JDK 21 compatibility notes @@ -112,10 +105,9 @@ Early access builds of JDK 21 are already available. JDK 21 will be an LTS release. Initial support for JDK 21 has been merged and is already available in -Scala 2.12.18 and in nightly builds of Scala 2.13 and Scala 3. +Scala 2.13.11 and 2.12.18 and in nightly builds of Scala 3. -The support will be included in the forthcoming Scala releases -2.13.11 and 3.3.1. +The support will be included in the forthcoming Scala 3.3.1 release. ## GraalVM Native Image compatibility notes From de7ee299824383acf05494a429cca04ba7c76c55 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 7 Jun 2023 09:28:41 -0700 Subject: [PATCH 2636/3075] fix mdoc errors --- _ba/tour/implicit-conversions.md | 4 ++-- _ja/tour/implicit-conversions.md | 4 ++-- _ko/tour/implicit-conversions.md | 4 ++-- _pl/tour/implicit-conversions.md | 4 ++-- _ru/tour/implicit-conversions.md | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/_ba/tour/implicit-conversions.md b/_ba/tour/implicit-conversions.md index d794590c45..5a1ea3b9fa 100644 --- a/_ba/tour/implicit-conversions.md +++ b/_ba/tour/implicit-conversions.md @@ -46,8 +46,8 @@ Možete, zato što `Predef` uključuje slj. implicitnu konverziju: ```scala mdoc import scala.language.implicitConversions -implicit def int2Integer(x: Int) = - java.lang.Integer.valueOf(x) +implicit def int2Integer(x: Int): Integer = + Integer.valueOf(x) ``` Pošto su implicitne konverzije opasne ako se koriste pogrešno, kompajler upozorava kada kompajlira definiciju implicitne konverzije. diff --git a/_ja/tour/implicit-conversions.md b/_ja/tour/implicit-conversions.md index d4de2375f3..dbf1440872 100644 --- a/_ja/tour/implicit-conversions.md +++ b/_ja/tour/implicit-conversions.md @@ -42,8 +42,8 @@ implicit def list2ordered[A](x: List[A]) ```scala mdoc import scala.language.implicitConversions -implicit def int2Integer(x: Int) = - java.lang.Integer.valueOf(x) +implicit def int2Integer(x: Int): Integer = + Integer.valueOf(x) ``` 暗黙の変換は見境なく使われると落とし穴になり得るため、暗黙の変換の定義をコンパイルしている時にコンパイラは警告を出します。 diff --git a/_ko/tour/implicit-conversions.md b/_ko/tour/implicit-conversions.md index 41aa47856e..d5af6dac66 100644 --- a/_ko/tour/implicit-conversions.md +++ b/_ko/tour/implicit-conversions.md @@ -43,8 +43,8 @@ previous-page: implicit-parameters ```scala mdoc import scala.language.implicitConversions -implicit def int2Integer(x: Int) = - java.lang.Integer.valueOf(x) +implicit def int2Integer(x: Int): Integer = + Integer.valueOf(x) ``` 암시적 변환이 무분별하게 사용될 경우 잠재적인 위험을 가질 수 있기 때문에, 컴파일러는 암시적 변환의 선언을 컴파일할 시 이를 경고한다. diff --git a/_pl/tour/implicit-conversions.md b/_pl/tour/implicit-conversions.md index d859139ee8..950bbd1458 100644 --- a/_pl/tour/implicit-conversions.md +++ b/_pl/tour/implicit-conversions.md @@ -43,8 +43,8 @@ Przykładowo, kiedy wywołujemy metodę Javy, która wymaga typu `java.lang.Inte ```scala mdoc import scala.language.implicitConversions -implicit def int2Integer(x: Int) = - java.lang.Integer.valueOf(x) +implicit def int2Integer(x: Int): Integer = + Integer.valueOf(x) ``` Aby zdefiniować własne konwersje niejawne, należy zaimportować `scala.language.implicitConversions` (albo uruchomić kompilator z opcją `-language:implicitConversions`). Ta funkcjonalność musi być włączona jawnie ze względu na problemy, jakie mogą się wiązać z ich nadmiernym stosowaniem. diff --git a/_ru/tour/implicit-conversions.md b/_ru/tour/implicit-conversions.md index 77eb2c9c46..069c9be697 100644 --- a/_ru/tour/implicit-conversions.md +++ b/_ru/tour/implicit-conversions.md @@ -44,8 +44,8 @@ implicit def list2ordered[A](x: List[A]) ```scala mdoc import scala.language.implicitConversions -implicit def int2Integer(x: Int) = - java.lang.Integer.valueOf(x) +implicit def int2Integer(x: Int): Integer = + Integer.valueOf(x) ``` Компилятор предупреждает при компиляции об обнаружении неявных преобразований, т.к. неявные преобразования могут иметь разные подводные камни (особенно если использовать их без разбора). From df72f7d160285af1a6213a617261cbc879d522bc Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 7 Jun 2023 09:32:53 -0700 Subject: [PATCH 2637/3075] oops --- _pt-br/tour/implicit-conversions.md | 4 ++-- _zh-cn/tour/implicit-conversions.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_pt-br/tour/implicit-conversions.md b/_pt-br/tour/implicit-conversions.md index cc96f99062..61ee6cac54 100644 --- a/_pt-br/tour/implicit-conversions.md +++ b/_pt-br/tour/implicit-conversions.md @@ -44,8 +44,8 @@ Por exemplo, ao chamar um método Java que espera um `java.lang.Integer`, você ```scala mdoc import scala.language.implicitConversions -implicit def int2Integer(x: Int) = - java.lang.Integer.valueOf(x) +implicit def int2Integer(x: Int): Integer = + Integer.valueOf(x) ``` Para definir suas próprias conversões implícitas, primeiro você deve importar `scala.language.implicitConversions` (ou invocar o compilador com a opção `-language: implicitConversions`). Tal recurso deve ser explicitamente habilitado porque pode se tornar complexo se usado indiscriminadamente. diff --git a/_zh-cn/tour/implicit-conversions.md b/_zh-cn/tour/implicit-conversions.md index 48049bc249..4c2d94cc0b 100644 --- a/_zh-cn/tour/implicit-conversions.md +++ b/_zh-cn/tour/implicit-conversions.md @@ -47,8 +47,8 @@ implicit def list2ordered[A](x: List[A]) ```scala mdoc import scala.language.implicitConversions -implicit def int2Integer(x: Int) = - java.lang.Integer.valueOf(x) +implicit def int2Integer(x: Int): Integer = + Integer.valueOf(x) ``` 因为如果不加选择地使用隐式转换可能会导致陷阱，编译器会在编译隐式转换定义时发出警告。 From aef0d4d786e609997919427e1505d2957fa4f239 Mon Sep 17 00:00:00 2001 From: Nick Brown <njbrown4@buffalo.edu> Date: Sun, 11 Jun 2023 14:50:37 -0400 Subject: [PATCH 2638/3075] repaired links to now dead `scalamacros.org`; the website `scalamacros.org` is no longer being used for what it was originally intended for when this documentation was written, so I have linked to the github repository which contains the original data. It may be worth it to look into `archive.org` for this purpose, if it is felt that the repository used is not sufficient. In the event the repository disapears, I have created a fork, and plan use it for archival purposes. This fork is welcome to use by the scala project in such an event. [https://github.com/bicknrown/scalamacros.github.com/](https://github.com/bicknrown/scalamacros.github.com/) --- _overviews/macros/paradise.md | 2 +- _overviews/macros/typemacros.md | 2 +- _overviews/macros/untypedmacros.md | 2 +- _overviews/macros/usecases.md | 4 ++-- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/_overviews/macros/paradise.md b/_overviews/macros/paradise.md index 1fb058c210..72637b0854 100644 --- a/_overviews/macros/paradise.md +++ b/_overviews/macros/paradise.md @@ -20,7 +20,7 @@ Macro paradise is a plugin for several versions of Scala compilers. It is designed to reliably work with production releases of <code>scalac</code>, making latest macro developments available way before they end up in future versions Scala. Refer to the roadmap for [the list of supported features and versions](roadmap.html) -and visit [the paradise announcement](https://scalamacros.org/news/2013/08/07/roadmap-for-macro-paradise.html) +and visit [the paradise announcement](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/news/_posts/2013-08-07-roadmap-for-macro-paradise.html) to learn more about our support guarantees. ~/210x $ scalac -Xplugin:paradise_*.jar -Xshow-phases diff --git a/_overviews/macros/typemacros.md b/_overviews/macros/typemacros.md index dbbf65995e..773819fa6d 100644 --- a/_overviews/macros/typemacros.md +++ b/_overviews/macros/typemacros.md @@ -12,7 +12,7 @@ permalink: /overviews/macros/:title.html Type macros used to be available in previous versions of ["Macro Paradise"](paradise.html), but are not supported anymore in macro paradise 2.0. -Visit [the paradise 2.0 announcement](https://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) +Visit [the paradise 2.0 announcement](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/news/_posts/2013-08-05-macro-paradise-2.0.0-snapshot.html) for an explanation and suggested migration strategy. ## Intuition diff --git a/_overviews/macros/untypedmacros.md b/_overviews/macros/untypedmacros.md index 340121f241..cccb85729b 100644 --- a/_overviews/macros/untypedmacros.md +++ b/_overviews/macros/untypedmacros.md @@ -12,7 +12,7 @@ permalink: /overviews/macros/:title.html Untyped macros used to be available in previous versions of ["Macro Paradise"](paradise.html), but are not supported anymore in macro paradise 2.0. -Visit [the paradise 2.0 announcement](https://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) +Visit [the paradise 2.0 announcement](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/news/_posts/2013-08-05-macro-paradise-2.0.0-snapshot.html) for an explanation and suggested migration strategy. ## Intuition diff --git a/_overviews/macros/usecases.md b/_overviews/macros/usecases.md index 335d3f6bd5..eed399f3b1 100644 --- a/_overviews/macros/usecases.md +++ b/_overviews/macros/usecases.md @@ -19,12 +19,12 @@ to the realm of possible. Both commercial and research users of Scala use macros At EPFL we are leveraging macros to power our research. Lightbend also employs macros in a number of projects. Macros are also popular in the community and have already given rise to a number of interesting applications. -The recent talk ["What Are Macros Good For?"](https://scalamacros.org/paperstalks/2014-02-04-WhatAreMacrosGoodFor.pdf) +The recent talk ["What Are Macros Good For?"](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/paperstalks/2014-02-04-WhatAreMacrosGoodFor.pdf) describes and systemizes uses that macros found among Scala 2.10 users. The thesis of the talk is that macros are good for code generation, static checking and DSLs, illustrated with a number of examples from research and industry. We have also published a paper in the Scala'13 workshop, -["Scala Macros: Let Our Powers Combine!"](https://scalamacros.org/paperstalks/2013-04-22-LetOurPowersCombine.pdf), +["Scala Macros: Let Our Powers Combine!"](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/paperstalks/2013-04-22-LetOurPowersCombine.pdf), covering the state of the art of macrology in Scala 2.10 from a more academic point of view. In the paper we show how the rich syntax and static types of Scala synergize with macros and explore how macros enable new and unique ways to use pre-existing language features. From f27cc06205e71b9c2a47c1c9350ef8da2708237d Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Tue, 6 Jun 2023 12:02:00 +0200 Subject: [PATCH 2639/3075] Update Scala 3 contributing guide and fix dead links --- _overviews/contribute/scala3.md | 8 -------- _overviews/scala3-contribution/procedures-cheatsheet.md | 2 +- _overviews/scala3-contribution/procedures-efficiency.md | 5 ----- _overviews/scala3-contribution/procedures-intro.md | 2 +- 4 files changed, 2 insertions(+), 15 deletions(-) delete mode 100644 _overviews/scala3-contribution/procedures-efficiency.md diff --git a/_overviews/contribute/scala3.md b/_overviews/contribute/scala3.md index 27be4f00a4..2501012a1e 100644 --- a/_overviews/contribute/scala3.md +++ b/_overviews/contribute/scala3.md @@ -11,11 +11,3 @@ Dotty is an open-source project, and as such, we welcome contributions from the If you are interested in contributing to Scala 3, please visit the project [developer website](https://dotty.epfl.ch/docs/contributing/index.html), where you will find all the information you need to get started. We encourage everyone, regardless of their level of expertise, to contribute to Scala 3, as there are many ways to help, from fixing bugs and implementing new features to improving documentation and testing. If you have any questions, please feel free to ask them on the [Contributors Forum](https://contributors.scala-lang.org/c/scala-3/scala-3-contributors/9). - -Summary of the contribution guide on Scala 3: - -- [Getting-Started](https://dotty.epfl.ch/docs/contributing/getting-started.html) -- [Workflow](https://dotty.epfl.ch/docs/contributing/workflow/index.html) -- [IDEs and Tools](https://dotty.epfl.ch/docs/contributing/tools/index.html) -- [Procedures](https://dotty.epfl.ch/docs/contributing/procedures/index.html) -- [High Level Architecture](https://dotty.epfl.ch/docs/contributing/architecture/index.html) \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-cheatsheet.md b/_overviews/scala3-contribution/procedures-cheatsheet.md index 0eee11a1fe..fdbf2a2435 100644 --- a/_overviews/scala3-contribution/procedures-cheatsheet.md +++ b/_overviews/scala3-contribution/procedures-cheatsheet.md @@ -1,5 +1,5 @@ --- title: Cheatsheets description: This page describes a cheatsheet for working with the Scala 3 compiler. -redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/index.html#sbt-commands-cheat-sheet-1 +redirect_to: https://dotty.epfl.ch/docs/contributing/cheatsheet.html --- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-efficiency.md b/_overviews/scala3-contribution/procedures-efficiency.md deleted file mode 100644 index 755424b138..0000000000 --- a/_overviews/scala3-contribution/procedures-efficiency.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: Improving Your Workflow -description: This page describes improving efficiency of debugging the Scala 3 compiler. -redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/efficiency.html ---- \ No newline at end of file diff --git a/_overviews/scala3-contribution/procedures-intro.md b/_overviews/scala3-contribution/procedures-intro.md index 090ceada46..2cb292caf4 100644 --- a/_overviews/scala3-contribution/procedures-intro.md +++ b/_overviews/scala3-contribution/procedures-intro.md @@ -1,5 +1,5 @@ --- title: Contributing to Scala 3 description: This page introduces the compiler procedures for the Scala 3 compiler. -redirect_to: https://dotty.epfl.ch/docs/contributing/workflow/index.html +redirect_to: https://dotty.epfl.ch/docs/contributing/procedures/index.html --- \ No newline at end of file From 78b8cb9748d6cfd1ae374a1686d2f70b1eab862a Mon Sep 17 00:00:00 2001 From: steve layland <stevieplayland@gmail.com> Date: Mon, 12 Jun 2023 04:21:34 -0700 Subject: [PATCH 2640/3075] update jp translation to match latest Future docs (#2838) --- _ja/overviews/core/futures.md | 123 +++++++++++++--------------------- 1 file changed, 48 insertions(+), 75 deletions(-) diff --git a/_ja/overviews/core/futures.md b/_ja/overviews/core/futures.md index 8796c37b4d..d83e2043e8 100644 --- a/_ja/overviews/core/futures.md +++ b/_ja/overviews/core/futures.md @@ -139,43 +139,19 @@ Future の実装の多くは、Future の結果を知りたくなったクライ } `onComplete` メソッドは、Future 計算の失敗と成功の両方の結果を扱えるため、汎用性が高い。 -成功した結果のみ扱う場合は、(部分関数を受け取る) `onSuccess` コールバックを使う: +成功した結果のみ扱う場合は、`foreach` コールバックを使う: val f: Future[List[String]] = Future { session.getRecentPosts } - f onSuccess { - case posts => for (post <- posts) println(post) + f foreach { posts => + for (post <- posts) println(post) } -失敗した結果のみ扱う場合は、`onFailure` コールバックを使う: - - val f: Future[List[String]] = Future { - session.getRecentPosts - } - - f onFailure { - case t => println("エラーが発生した: " + t.getMessage) - } - - f onSuccess { - case posts => for (post <- posts) println(post) - } - -`onFalure` コールバックは Future が失敗した場合、つまりそれが例外を保持する場合のみ実行される。 - -部分関数は `isDefinedAt` メソッドを持つため、`onFailure` メソッドはコールバックが特定の `Throwable` に対して定義されている場合のみ発火される。 -以下の例では、登録された `onFailure` コールバックは発火されない: - - val f = Future { - 2 / 0 - } - - f onFailure { - case npe: NullPointerException => - println("これが表示されているとしたらビックリ。") - } +`Future` は、失敗した結果のみを処理する方法を提供していて、 +`Failure[Throwable]` を `Success[Throwable]` へと変換する `failed` 投射を用いることができる。 +詳細は以下の[投射](#projections)を参照。 キーワードの初出の位置を検索する例に戻ると、キーワードの位置を画面に表示したいかもしれない: @@ -184,15 +160,12 @@ Future の実装の多くは、Future の結果を知りたくなったクライ source.toSeq.indexOfSlice("myKeyword") } - firstOccurence onSuccess { - case idx => println("キーワードの初出位置: " + idx) - } - - firstOccurence onFailure { - case t => println("ファイルの処理に失敗した: " + t.getMessage) + firstOccurence oncomplete { + case Success(idx) => println("キーワードの初出位置: " + idx) + case Failure(t) => println("処理失敗：" + t.getMessage) } -`onComplete`、`onSuccess`、および `onFailure` メソッドは全て `Unit` 型を返すため、これらの呼び出しを連鎖させることができない。 +`onComplete`、および `foreach` メソッドは全て `Unit` 型を返すため、これらの呼び出しを連鎖させることができない。 これは意図的な設計で、連鎖された呼び出しが登録されたコールバックの実行の順序を暗示しないようにしている (同じ Future に登録されたコールバックは順不同に発火される)。 @@ -212,12 +185,12 @@ Future 内の値が利用可能となることを必要とするため、Future "na" * 16 + "BATMAN!!!" } - text onSuccess { - case txt => totalA += txt.count(_ == 'a') + text.foreach { txt => + totalA += txt.count(_ == 'a') } - text onSuccess { - case txt => totalA += txt.count(_ == 'A') + text.foreach { txt => + totalA += txt.count(_ == 'A') } 2つのコールバックが順次に実行された場合は、変数 `totalA` は期待される値 `18` を持つ。 @@ -232,7 +205,7 @@ Future 内の値が利用可能となることを必要とするため、Future <ol> <li>Future に <code>onComplete</code> コールバックを登録することで、対応するクロージャが Future が完了した後に eventually に実行されることが保証される。</li> -<li><code>onSuccess</code> や <code>onFailure</code> コールバックを登録することは <code>onComplete</code> と同じ意味論を持つ。ただし、クロージャがそれぞれ成功したか失敗した場合のみに呼ばれるという違いがある。</li> +<li><code>foreach</code> コールバックを登録することは <code>onComplete</code> と同じ意味論を持つ。ただし、クロージャがそれぞれ成功したか失敗した場合のみに呼ばれるという違いがある。</li> <li>既に完了した Future にコールバックを登録することは (1 により) コールバックが eventually に実行されることとなる。</li> @@ -257,33 +230,32 @@ Future 内の値が利用可能となることを必要とするため、Future connection.getCurrentValue(USD) } - rateQuote onSuccess { case quote => + for (quote <- rateQuote) { val purchase = Future { if (isProfitable(quote)) connection.buy(amount, quote) else throw new Exception("有益ではない") } - purchase onSuccess { - case _ => println(amount + " USD を購入した") - } + for (amount <- purchase) + println(amount + " USD を購入した") } まずは現在の為替相場を取得する `rateQuote` という `Future` を作る。 この値がサーバから取得できて Future が成功した場合は、計算は -`onSuccess` コールバックに進み、ここで買うかどうかの決断をすることができる。 +`foreach` コールバックに進み、ここで買うかどうかの決断をすることができる。 ここでもう 1つの Future である `purchase` を作って、有利な場合のみ買う決定をしてリクエストを送信する。 最後に、`purchase` が完了すると、通知メッセージを標準出力に表示する。 これは動作するが、2つの理由により不便だ。 -第一に、`onSuccess` を使わなくてはいけなくて、2つ目の Future である +第一に、`foreach` を使わなくてはいけなくて、2つ目の Future である `purchase` をその中に入れ子にする必要があることだ。 例えば `purchase` が完了した後に別の貨幣を売却したいとする。 -それはまた `onSuccess` の中でこのパターンを繰り返すことになり、インデントしすぎで理解しづらく肥大化したコードとなる。 +それはまた `foreach` の中でこのパターンを繰り返すことになり、インデントしすぎで理解しづらく肥大化したコードとなる。 -第二に、`purchase` は他のコードのスコープ外にあり、`onSuccess` +第二に、`purchase` は他のコードのスコープ外にあり、`foreach` コールバック内においてのみ操作することができる。 そのため、アプリケーションの他の部分は `purchase` を見ることができず、他の貨幣を売るために別の -`onSuccess` コールバックを登録することもできない。 +`foreach` コールバックを登録することもできない。 これらの 2つの理由から Future はより自然な合成を行うコンビネータを提供する。 基本的なコンビネータの 1つが `map` で、これは与えられた Future @@ -301,11 +273,11 @@ Future の投射はコレクションの投射と同様に考えることがで else throw new Exception("有益ではない") } - purchase onSuccess { - case _ => println(amount + " USD を購入した") + purchase.foreach { amount => + println(amount + " USD を購入した") } -`rateQuote` に対して `map` を使うことで `onSuccess` コールバックを一切使わないようになった。 +`rateQuote` に対して `map` を使うことで `foreach` コールバックを一切使わないようになった。 それと、より重要なのが入れ子が無くなったことだ。 ここで他の貨幣を売却したいと思えば、`purchase` に再び `map` するだけでいい。 @@ -321,7 +293,7 @@ Future の投射はコレクションの投射と同様に考えることがで この例外を伝搬させる意味論は他のコンビネータにおいても同様だ。 Future の設計指針の 1つは for 内包表記から利用できるようにすることだった。 -このため、Future は `flatMap`、`filter` そして `foreach` コンビネータを持つ。 +このため、Future は `flatMap` そして `withFilter` コンビネータを持つ。 `flatMap` メソッドは値を新しい Future `g` に投射する関数を受け取り、`g` が完了したときに完了する新たな Future を返す。 @@ -338,8 +310,8 @@ Future の設計指針の 1つは for 内包表記から利用できるように if isProfitable(usd, chf) } yield connection.buy(amount, chf) - purchase onSuccess { - case _ => println(amount + " CHF を購入した") + purchase foreach { _ => + println(amount + " CHF を購入した") } この `purchase` は `usdQuote` と `chfQuote` が完了した場合のみ完了する。 @@ -370,10 +342,6 @@ Future に関しては、`filter` の呼び出しは `withFilter` の呼び出 `collect` と `filter` コンビネータの関係はコレクション API におけるこれらのメソッドの関係に似ている。 -`foreach` コンビネータで注意しなければいけないのは値が利用可能となった場合に走査するのにブロックしないということだ。 -かわりに、`foreach` のための関数は Future が成功した場合のみ非同期に実行される。 -そのため、`foreach` は `onSuccess` コールバックと全く同じ意味を持つ。 - `Future` トレイトは概念的に (計算結果と例外という) 2つの型の値を保持することができるため、例外処理のためのコンビネータが必要となる。 `rateQuote` に基いて何らかの額を買うとする。 @@ -418,7 +386,7 @@ Future は同じ `Throwable` とともに失敗する。 val anyQuote = usdQuote fallbackTo chfQuote - anyQuote onSuccess { println(_) } + anyQuote foreach { println(_) } `andThen` コンビネータは副作用の目的のためだけに用いられる。 これは、成功したか失敗したかに関わらず現在の Future と全く同一の結果を返す新たな Future を作成する。 @@ -454,12 +422,18 @@ Future は同じ `Throwable` とともに失敗する。 } for (exc <- f.failed) println(exc) +上の例での for 内包表記は以下のように書き換えることができる: + + f.failed.foreach( exc => println(exc)) + +`f` が失敗したため、クロージャは新規に成功値を持つ `Future[Throwable]` の +`foreach` コールバックに登録される。 以下の例は画面に何も表示しない: - val f = Future { + val g = Future { 4 / 2 } - for (exc <- f.failed) println(exc) + for (exc <- g.failed) println(exc) <!-- There is another projection called `timedout` which is specific to the @@ -536,8 +510,7 @@ Future が失敗した場合は、呼び出し元には Future が失敗した 非同期の計算が処理されない例外を投げた場合、その計算が行われた Future は失敗する。 失敗した Future は計算値のかわりに `Throwable` のインスタンスを格納する。 -`Future` は、`Throwable` に適用することができる `PartialFunction` を受け取る -`onFailure` コールバックメソッドを提供する。 +また、`Future` はこの `Throwable` インスタンスを別の `Future` の計算値として扱う `failed` 投射メソッドを提供する。 以下の特別な例外に対しては異なる処理が行われる: 1. `scala.runtime.NonLocalReturnControl[_]`。この例外は戻り値に関連する値を保持する。 @@ -576,14 +549,14 @@ Promise の `p` は `p.future` によって返される Future を完了させ val producer = Future { val r = produceSomething() - p success r + p.success(r) continueDoingSomethingUnrelated() } val consumer = Future { startDoingSomething() - f onSuccess { - case r => doSomethingWithResult() + f.foreach { r => + doSomethingWithResult() } } @@ -644,8 +617,8 @@ HTTP レスポンスにのみ興味がある場合で、これは最初に Promi p completeWith f - p.future onSuccess { - case x => println(x) + p.future.foreach { x => + println(x) } Promise を例外とともに失敗させる場合は、`Throwable` の 3つのサブタイプが特殊扱いされる。 @@ -664,12 +637,12 @@ Promise、Future の `onComplete` メソッド、そして `future` def first[T](f: Future[T], g: Future[T]): Future[T] = { val p = Promise[T]() - f onSuccess { - case x => p.tryComplete(x) + f.foreach { x => + p.tryComplete(x) } - g onSuccess { - case x => p.tryComplete(x) + g.foreach { x => + p.tryComplete(x) } p.future From 00c60261858d219c6d9e228414a902fda9ebca29 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Fri, 16 Jun 2023 10:30:21 +0300 Subject: [PATCH 2641/3075] Update scaladoc in ru (#2837) Co-authored-by: Dima Kotobotov <dima@kotobotov.ru> --- _ru/scala3/guides/scaladoc/blog.md | 64 ++++++++++- _ru/scala3/guides/scaladoc/settings.md | 97 +++++++++------- _ru/scala3/guides/scaladoc/static-site.md | 129 +++++++++++++++------- 3 files changed, 207 insertions(+), 83 deletions(-) diff --git a/_ru/scala3/guides/scaladoc/blog.md b/_ru/scala3/guides/scaladoc/blog.md index d631dde80f..540a05bd03 100644 --- a/_ru/scala3/guides/scaladoc/blog.md +++ b/_ru/scala3/guides/scaladoc/blog.md @@ -8,17 +8,16 @@ previous-page: static-site next-page: site-versioning --- -Scaladoc позволяет включить в документацию простой блог. -На данный момент предоставляются только основные функции. +Scaladoc позволяет включить в документацию простой блог. +На данный момент предоставляются только основные функции. В будущем мы планируем включить более продвинутые функции, такие как теги или авторские страницы. -К блогу относятся немного иначе, чем к обычным статическим сайтам. +К блогу относятся немного иначе, чем к обычным статическим сайтам. Эта статья поможет вам создать свой собственный блог. ## Правильная настройка каталога -Сообщения в блоге должны быть помещены в каталог `_blog/_posts`. - +Статьи в блоге должны быть помещены в каталог `_blog/_posts`. ``` ├── _blog @@ -31,5 +30,58 @@ Scaladoc загружает блог, если существует катало ## Соглашение об именовании -Все имена файлов сообщений блога должны начинаться с даты в числовом формате, соответствующем `YYYY-MM-DD`. +Все имена файлов сообщений блога должны начинаться с даты в числовом формате, соответствующем `YYYY-MM-DD`. Пример имени - `2022-06-17-dotty-compiler-bootstraps.md`. + +## Метаданные страницы + +Страницы блога в scaladoc поддерживают [Yaml Frontmatter](https://assemble.io/docs/YAML-front-matter.html), +что позволяет указывать различные значения, которые будут использоваться для метаданных на вашей странице. +Вот возможные поля: + +``` +--- +layout: <Ссылка на макет страницы для страницы блога> +author: <Автор страницы> +title: <Заголовок страницы> +subTitle: <Подзаголовок страницы> +date: <Дата создания страницы>, например, 2016-12-05 +authorImg: <Ссылка на картинку автора> +--- +<Содержимое страницы> +``` + +Вы также можете найти более подробную информацию о метаданных [на сайте документации Jekyll](https://jekyllrb.com/docs/front-matter/). + +## Синтаксис содержимого + +Имейте в виду, что для записи вашего блога необходимо использовать формат Markdown. +Более детальная информация о синтаксисе доступна в [Руководстве по Markdown](https://www.markdownguide.org/basic-syntax/). + +## Конфигурация блога + +Scaladoc позволяет настраивать блог, при его создании. + +Чтобы изменить настройки документации блога по умолчанию, +пользователям необходимо создать файл с именем `blog.yml` в **корневом каталоге блога**. +Этот файл должен содержать параметры, которые пользователь хочет изменить. +Например, если пользователь хочет изменить исходный каталог на "my_posts", +исходящий каталог на "my_docs" и временно скрыть блог, +то можно создать файл со следующим содержимым: + +``` +input: my_posts +output: my_docs +hidden: true +``` + +### Параметры: + +`input`: указывает каталог, содержащий markdown-файлы для постов блога (по умолчанию: "\_posts" в "docs"). + +`output`: указывает папку, в которой будут созданы HTML-страницы (по умолчанию: "blog" в "target/docs"). + +`hidden`: позволяет пользователям временно скрывать блог (по умолчанию: "false"). + +Чтобы изменить эти настройки, создайте файл с параметрами и сохраните его в корневом каталоге блога. +При следующей сборке блога будут использоваться новые параметры. diff --git a/_ru/scala3/guides/scaladoc/settings.md b/_ru/scala3/guides/scaladoc/settings.md index b7ec438ac8..c36dedb135 100644 --- a/_ru/scala3/guides/scaladoc/settings.md +++ b/_ru/scala3/guides/scaladoc/settings.md @@ -7,18 +7,18 @@ num: 9 previous-page: snippet-compiler --- -В этой главе перечислены параметры конфигурации, которые можно использовать при вызове scaladoc. +В этой главе перечислены параметры конфигурации, которые можно использовать при вызове scaladoc. Некоторую информацию, показанную здесь, можно получить, вызвав scaladoc с флагом `-help`. ## Изменения scaladoc по сравнению со Scala 2 -Scaladoc был переписан с нуля, и некоторые функции оказались бесполезными в новом контексте. +Scaladoc был переписан с нуля, и некоторые функции оказались бесполезными в новом контексте. Текущее состояние совместимости со старыми флагами scaladoc можно увидеть [здесь](https://github.com/lampepfl/dotty/issues/11907). ## Указание настроек -Настройки scaladoc можно указывать в качестве аргументов командной строки, -например, `scaladoc -d output -project my-project target/scala-3.0.0-RC2/classes`. +Настройки scaladoc можно указывать в качестве аргументов командной строки, +например, `scaladoc -d output -project my-project target/scala-3.0.0-RC2/classes`. При вызове из sbt, обновите значение `Compile / doc / scalacOptions` и `Compile / doc / target` соответственно, например ``` @@ -29,30 +29,37 @@ Compile / doc / scalacOptions ++= Seq("-project", "my-project"), ## Обзор всех доступных настроек ##### -project + Название проекта. Чтобы обеспечить совместимость с псевдонимами Scala2 с `-doc-title` ##### -project-version -Текущая версия проекта, которая отображается в верхнем левом углу. + +Текущая версия проекта, которая отображается в верхнем левом углу. Чтобы обеспечить совместимость с псевдонимами Scala2 с `-doc-version` ##### -project-logo -Логотип проекта, который появляется в верхнем левом углу. + +Логотип проекта, который появляется в верхнем левом углу. Чтобы обеспечить совместимость с псевдонимами Scala2 с `-doc-logo` ##### -project-footer -Строковое сообщение, которое отображается в разделе нижнего колонтитула. + +Строковое сообщение, которое отображается в разделе нижнего колонтитула. Чтобы обеспечить совместимость с псевдонимами Scala2 с `-doc-footer` ##### -comment-syntax -Язык стилей, используемый для разбора комментариев. -В настоящее время поддерживается два синтаксиса: `markdown` или `wiki`. + +Язык стилей, используемый для разбора комментариев. +В настоящее время поддерживается два синтаксиса: `markdown` или `wiki`. Если настройка отсутствует, по умолчанию - `markdown`. ##### -revision -Редакция (ветвь или ссылка), используемая для создания проекта. + +Редакция (ветвь или ссылка), используемая для создания проекта. Полезно с исходными ссылками, чтобы они не всегда указывали на последний `main`, который может быть изменен. ##### -source-links + Ссылки на источники обеспечивают сопоставление между файлом в документации и репозиторием кода. Примеры исходных ссылок: @@ -63,20 +70,20 @@ Compile / doc / scalacOptions ++= Seq("-project", "my-project"), `<sub-path>=<source-link>` где `<source-link>` является одним из следующих: - - `github://<organization>/<repository>[/revision][#subpath]` - будет соответствовать https://github.com/$organization/$repository/[blob|edit]/$revision[/$subpath]/$filePath[$lineNumber], - если редакция не указана, тогда требуется указать редакцию в качестве аргумента для Scaladoc - - `gitlab://<organization>/<repository>` - будет соответствовать https://gitlab.com/$organization/$repository/-/[blob|edit]/$revision[/$subpath]/$filePath[$lineNumber], - если редакция не указана, тогда требуется, чтобы редакция была указана как аргумент в Scaladoc - - `<scaladoc-template>` - -`<scaladoc-template>` — это формат параметра `doc-source-url` из старого scaladoc. -ПРИМЕЧАНИЕ. Поддерживаются только шаблоны `€{FILE_PATH_EXT}`, `€{TPL_NAME}`, `€{FILE_EXT}`, `€{FILE_PATH}` и `€{FILE_LINE}`. -Шаблон может быть определен только подмножеством источников, определенных префиксом пути, представленным `<sub-path>`. -В этом случае пути, используемые в шаблонах, будут относительными относительно `<sub-path>`. +- `github://<organization>/<repository>[/revision][#subpath]` + будет соответствовать https://github.com/$organization/$repository/[blob|edit]/$revision[/$subpath]/$filePath[$lineNumber], + если редакция не указана, тогда требуется указать редакцию в качестве аргумента для Scaladoc +- `gitlab://<organization>/<repository>` + будет соответствовать https://gitlab.com/$organization/$repository/-/[blob|edit]/$revision[/$subpath]/$filePath[$lineNumber], + если редакция не указана, тогда требуется, чтобы редакция была указана как аргумент в Scaladoc +- `<scaladoc-template>` +`<scaladoc-template>` — это формат параметра `doc-source-url` из старого scaladoc. +ПРИМЕЧАНИЕ. Поддерживаются только шаблоны `€{FILE_PATH_EXT}`, `€{TPL_NAME}`, `€{FILE_EXT}`, `€{FILE_PATH}` и `€{FILE_LINE}`. + +Шаблон может быть определен только подмножеством источников, определенных префиксом пути, представленным `<sub-path>`. +В этом случае пути, используемые в шаблонах, будут относительны к `<sub-path>`. ##### -external-mappings @@ -85,7 +92,7 @@ Compile / doc / scalacOptions ++= Seq("-project", "my-project"), Пример внешнего сопоставления: `-external-mappings:.*scala.*::scaladoc3::https://scala-lang.org/api/3.x/,.*java.*::javadoc::https://docs.oracle.com/javase/8/docs/api/` -Отображение имеет вид `<regex>::[scaladoc3|scaladoc|javadoc]::<path>`. +Отображение имеет вид `<regex>::[scaladoc3|scaladoc|javadoc]::<path>`. Можно указать несколько сопоставлений, разделенных запятыми, как показано в примере. ##### -social-links @@ -94,8 +101,8 @@ Compile / doc / scalacOptions ++= Seq("-project", "my-project"), `-social-links:github::https://github.com/lampepfl/dotty,discord::https://discord.com/invite/scala,twitter::https://twitter.com/scala_lang` -Допустимые значения имеют вид: `[github|twitter|gitter|discord]::link`. -Scaladoc также поддерживает `custom::link::white_icon_name::black_icon_name`. +Допустимые значения имеют вид: `[github|twitter|gitter|discord]::link`. +Scaladoc также поддерживает `custom::link::white_icon_name::black_icon_name`. В этом случае иконки должны находиться в каталоге `images/`. ##### -skip-by-id @@ -104,7 +111,7 @@ Scaladoc также поддерживает `custom::link::white_icon_name::bla ##### -skip-by-regex -Регулярные выражения, соответствующие полным именам пакетов или классов верхнего уровня, +Регулярные выражения, соответствующие полным именам пакетов или классов верхнего уровня, которые следует пропускать при создании документации. ##### -doc-root-content @@ -113,7 +120,7 @@ Scaladoc также поддерживает `custom::link::white_icon_name::bla ##### -author -Добавление авторов в строку документации `@author Name Surname` по умолчанию не будет включено в сгенерированную html-документацию. +Добавление авторов в строку документации `@author Name Surname` по умолчанию не будет включено в сгенерированную html-документацию. Если необходимо явно пометить классы авторами, scaladoc запускается с данным флагом. ##### -groups @@ -126,9 +133,9 @@ Scaladoc также поддерживает `custom::link::white_icon_name::bla ##### -doc-canonical-base-url -Базовый URL-адрес для использования в качестве префикса и добавления `canonical` URL-адресов на все страницы. -Канонический URL-адрес может использоваться поисковыми системами для выбора URL-адреса, -который вы хотите, чтобы люди видели в результатах поиска. +Базовый URL-адрес для использования в качестве префикса и добавления `canonical` URL-адресов на все страницы. +Канонический URL-адрес может использоваться поисковыми системами для выбора URL-адреса, +который вы хотите, чтобы люди видели в результатах поиска. Если не установлено, канонические URL-адреса не генерируются. ##### -siteroot @@ -137,17 +144,18 @@ Scaladoc также поддерживает `custom::link::white_icon_name::bla ##### -no-link-warnings -Подавить предупреждения для двусмысленных или невалидных ссылок. +Подавить предупреждения для двусмысленных или невалидных ссылок. Не влияет на предупреждения о некорректных ссылках ресурсов и т. д. ##### -versions-dictionary-url -URL-адрес, указывающий на документ JSON, содержащий словарь: `version label -> documentation location`. -Файл JSON имеет единственное свойство `versions`, которое содержит словарь, -связывающий метки определенных версий документации с URL-адресами, указывающими на их `index.html`. +URL-адрес, указывающий на документ JSON, содержащий словарь: `version label -> documentation location`. +Файл JSON имеет единственное поле `versions`, которое содержит словарь, +связывающий метки определенных версий документации с URL-адресами, указывающими на их `index.html`. Полезно для библиотек, которые поддерживают разные версии документации. Пример JSON-файла: + ``` { "versions": { @@ -161,19 +169,20 @@ URL-адрес, указывающий на документ JSON, содерж Аргументы компилятора фрагментов, позволяющие настроить проверку типа сниппета. -Этот параметр принимает список аргументов в формате: +Этот параметр принимает список аргументов в формате: `args := arg{,args} arg := [path=]flag` -, где `path` - префикс пути к исходным файлам, в которых находятся сниппеты, +, где `path` - префикс пути к исходным файлам, в которых находятся сниппеты, и `flag` - режим проверки типов. Если `path` отсутствует, аргумент будет использоваться по умолчанию для всех несопоставленных путей. Доступные флаги: + - `compile` — включает проверку фрагментов. - `nocompile` — отключает проверку сниппетов. - `fail` — включает проверку фрагмента, утверждает, что сниппет не компилируется. -Флаг `fail` удобен для фрагментов, которые показывают, +Флаг `fail` удобен для фрагментов, которые показывают, что какое-то действие в конечном итоге завершится ошибкой во время компиляции. Пример использования: @@ -186,12 +195,22 @@ URL-адрес, указывающий на документ JSON, содерж - все фрагменты в файлах в каталоге `my/path/f` не должны компилироваться во время компиляции - все остальные фрагменты должны компилироваться успешно +#### -scastie-configuration + +Определите дополнительную sbt конфигурацию для Scastie фрагментов кода. +Например, когда вы импортируете внешние библиотеки в свои фрагменты, +необходимо добавить соответствующие зависимости. + +``` +"-scastie-configuration", """libraryDependencies += "org.apache.commons" % "commons-lang3" % "3.12.0"""" +``` + ##### -Ysnippet-compiler-debug Установка этого параметра заставляет компилятор фрагментов печатать сниппет по мере его компиляции (после упаковки). ##### -Ydocument-synthetic-types -Включение в документацию страниц с документацией по встроенным типам (например, `Any`, `Nothing`). -Этот параметр полезен только для stdlib, поскольку scaladoc для Scala 3 использует файлы TASTy. +Включение в документацию страниц с документацией по встроенным типам (например, `Any`, `Nothing`). +Этот параметр полезен только для stdlib, поскольку scaladoc для Scala 3 использует файлы TASTy. Все остальные пользователи не должны касаться этой настройки. diff --git a/_ru/scala3/guides/scaladoc/static-site.md b/_ru/scala3/guides/scaladoc/static-site.md index 10486b8c20..2249f88ffe 100644 --- a/_ru/scala3/guides/scaladoc/static-site.md +++ b/_ru/scala3/guides/scaladoc/static-site.md @@ -8,14 +8,14 @@ previous-page: linking next-page: blog --- -Scaladoc умеет генерировать статические сайты, известные по [Jekyll](http://jekyllrb.com/) или [Docusaurus](https://docusaurus.io/). -Наличие комбинированного инструмента позволяет обеспечить взаимодействие между статической документацией +Scaladoc умеет генерировать статические сайты, известные по [Jekyll](http://jekyllrb.com/) или [Docusaurus](https://docusaurus.io/). +Наличие комбинированного инструмента позволяет обеспечить взаимодействие между статической документацией и API, что позволяет им естественным образом сочетаться. -Создать сайт так же просто, как и в Jekyll. Корень сайта содержит макет сайта, +Создать сайт так же просто, как и в Jekyll. Корень сайта содержит макет сайта, и все файлы, размещенные там, будут либо считаться статическими, либо обрабатываться для расширения шаблона. -Файлы, которые рассматриваются для расширения шаблона, должны заканчиваться на `*.{html,md}` +Файлы, которые рассматриваются для расширения шаблона, должны заканчиваться на `*.{html,md}` и в дальнейшем будут называться "файлами шаблонов" или "шаблонами". Простой сайт "Hello World" может выглядеть примерно так: @@ -35,12 +35,12 @@ index.html getting-started.html ``` -Scaladoc может преобразовывать как файлы, так и каталоги (чтобы организовать документацию в древовидную структуру). -По умолчанию каталоги имеют заголовок, основанный на имени файла, с пустым содержимым. +Scaladoc может преобразовывать как файлы, так и каталоги (чтобы организовать документацию в древовидную структуру). +По умолчанию каталоги имеют заголовок, основанный на имени файла, с пустым содержимым. Можно предоставить индексные страницы для каждого раздела, создав `index.html` или `index.md` (но не одновременно) в выделенном каталоге. -Имейте в виду, что для локального просмотра вашего сайта со всеми его функциями, такими как поиск или фрагменты, -требуется локальный сервер. Например, если ваш выходной каталог - `output`, +Имейте в виду, что для локального просмотра вашего сайта со всеми его функциями, такими как поиск или фрагменты, +требуется локальный сервер. Например, если ваш выходной каталог - `output`, вы можете использовать python сервер для просмотра всего, выполнив следующие действия и открыв `localhost:8080`: ```sh @@ -50,10 +50,10 @@ python3 -m http.server 8080 ## Характеристики -Scaladoc использует механизм шаблонов [Liquid](https://shopify.github.io/liquid/) +Scaladoc использует механизм шаблонов [Liquid](https://shopify.github.io/liquid/) и предоставляет несколько настраиваемых фильтров и тегов, характерных для документации Scala. -В Scaladoc все шаблоны могут содержать вступительную часть YAML. +В Scaladoc все шаблоны могут содержать вступительную часть YAML. Передняя часть анализируется и помещается в переменную `page`, доступную в шаблонах через Liquid. Пример вступительной статьи: @@ -69,17 +69,58 @@ Scaladoc использует некоторые предопределенны Предустановленные свойства: - **title** - обеспечивает заголовок страницы, который будет использоваться в навигации и метаданных HTML. -- **extraCss** - дополнительные файлы `.css`, которые будут включены в эту страницу. +- **extraCss** - дополнительные файлы `.css`, которые будут включены в эту страницу. Пути должны указываться относительно корня документации. **Этот параметр не экспортируется в механизм шаблонов.** -- **extraJs** - дополнительные файлы `.js`, которые будут включены в эту страницу. +- **extraJs** - дополнительные файлы `.js`, которые будут включены в эту страницу. Пути должны указываться относительно корня документации. **Этот параметр не экспортируется в механизм шаблонов.** -- **hasFrame** - если установлено значение `false`, страница не будет включать макет по умолчанию (навигацию, breadcrumbs и т.д.), +- **hasFrame** - если установлено значение `false`, страница не будет включать макет по умолчанию (навигацию, breadcrumbs и т.д.), а только токен-оболочку HTML для предоставления метаданных и ресурсов (файлы js и css). **Этот параметр не экспортируется в механизм шаблонов.** - **layout** - предопределенный макет для использования, см. ниже. **Этот параметр не экспортируется в механизм шаблонов.** +Свойства перенаправления: + +В дополнение к предустановленным свойствам, Scaladoc также поддерживает свойства перенаправления, +которые позволяют вам перенаправлять с одной страницы на другую. +Это может быть полезно, когда вы перемещаете страницу на новое место, +но хотите, чтобы старый URL-адрес работал. + +- **redirectFrom** - указывает на URL-адрес, с которого вы хотите выполнить перенаправление. + Используя свойство `redirectFrom`, Scaladoc создает пустую страницу по этому URL-адресу, + который включает браузерное перенаправление на текущую страницу. + +Пример: + +``` +--- +redirectFrom: /absolute/path/to/old/url.html +--- +``` + +В приведенном выше примере, +если вы перемещаете страницу из `/absolute/path/to/old/url.html` на новое место, +то вы можете использовать `redirectFrom`, чтобы убедиться, +что старый URL-адрес по-прежнему перенаправляет на новое место. + +Обратите внимание, что свойство `redirectFrom` было вдохновлено плагином Jekyll под названием +[`jekyll-redirect-from`](https://github.com/jekyll/jekyll-redirect-from). + +- **redirectTo** — указывает URL-адрес, на который вы хотите перенаправить с текущей страницы. + Это свойство полезно, когда вы хотите перенаправить на внешнюю страницу + или когда нельзя использовать `redirectFrom`. + +Пример: + +``` +--- +redirectTo: https://docs.scala-lang.org/ +--- +``` + +В приведенном выше примере страница будет перенаправлена на https://docs.scala-lang.org/. + ## Использование существующих шаблонов и макетов -Чтобы выполнить расширение шаблона, Dottydoc просматривает поле `layout` во вступительной части. +Чтобы выполнить расширение шаблона, Dottydoc просматривает поле `layout` во вступительной части. Вот простой пример системы шаблонов в действии `index.html`: ```html @@ -93,6 +134,7 @@ layout: main С таким простым основным шаблоном, как этот: {% raw %} + ```html <html> <head> @@ -120,6 +162,7 @@ layout: main ## Ресурсы Чтобы рендерить ассеты вместе со статическим сайтом, их нужно поместить в директорию `_assets` в корне сайта: + ``` ├── _assets │ └── images @@ -127,6 +170,7 @@ layout: main └── _docs └── getting-started.md ``` + Чтобы сослаться на ресурс на странице, необходимо создать ссылку относительно каталога `_assets`. ``` @@ -135,8 +179,8 @@ Take a look at the following image: [My image](images/myimage.png) ## Боковая панель -По умолчанию Scaladoc отображает структуру каталогов из каталога `_docs` на визуализируемом сайте. -Существует также возможность переопределить его, предоставив файл `sidebar.yml` в корневом каталоге сайта. +По умолчанию Scaladoc отображает структуру каталогов из каталога `_docs` на визуализируемом сайте. +Существует также возможность переопределить его, предоставив файл `sidebar.yml` в корневом каталоге сайта. Конфигурационный файл YAML описывает структуру отображаемого статического сайта и оглавление: ```yaml @@ -153,25 +197,28 @@ subsection: page: usage/sbt-projects.html hidden: false ``` -Корневой элемент должен быть `subsection`. + +Корневой элемент должен быть `subsection`. Вложенные подразделы приведут к древовидной структуре навигации. -Свойства `subsection`: - - `title` - Необязательная строка - заголовок подраздела по умолчанию. - Вступительные заголовки имеют более высокий приоритет. - - `index` - Необязательная строка - Путь к индексной странице подраздела. Путь указан относительно каталога `_docs`. - - `directory` - Необязательная строка - Имя каталога, в котором будет находиться подраздел сгенерированного сайта. - По умолчанию именем каталога является имя подраздела, преобразованное в kebab case. - - `subsection` - Массив `subsection` или `page`. +Свойства `subsection`: + +- `title` - Необязательная строка - заголовок подраздела по умолчанию. + Вступительные заголовки имеют более высокий приоритет. +- `index` - Необязательная строка - Путь к индексной странице подраздела. Путь указан относительно каталога `_docs`. +- `directory` - Необязательная строка - Имя каталога, в котором будет находиться подраздел сгенерированного сайта. + По умолчанию именем каталога является имя подраздела, преобразованное в kebab case. +- `subsection` - Массив `subsection` или `page`. -Либо `index`, либо `subsection` должны быть определены. Подраздел, определенный с `index` и без `subsection`, +Либо `index`, либо `subsection` должны быть определены. Подраздел, определенный с `index` и без `subsection`, будет содержать страницы и каталоги, загружаемые рекурсивно из каталога индексной страницы. Свойства `page`: - - `title` - Необязательная строка - заголовок страницы по умолчанию. Вступительные заголовки имеют более высокий приоритет. - - `page` - Строка - Путь к странице относительно каталога `_docs`. - - `hidden` - Необязательное логическое значение. Флаг, указывающий, должна ли страница отображаться на боковой панели навигации. - По умолчанию установлено значение `false`. + +- `title` - Необязательная строка - заголовок страницы по умолчанию. Вступительные заголовки имеют более высокий приоритет. +- `page` - Строка - Путь к странице относительно каталога `_docs`. +- `hidden` - Необязательное логическое значение. Флаг, указывающий, должна ли страница отображаться на боковой панели навигации. + По умолчанию установлено значение `false`. **Заметка**: Все пути в файле конфигурации YAML относятся к `<static-root>/_docs`. @@ -191,15 +238,18 @@ subsection: 2. `title` свойство из `sidebar.yml` 3. имя файла -Обратите внимание, что если пропустить `index` файл в древовидной структуре или не указать `title` во вступительной части, -ему будет присвоено общее имя `index`. То же самое относится к использованию `sidebar.yml`, +Обратите внимание, что если пропустить `index` файл в древовидной структуре или не указать `title` во вступительной части, +ему будет присвоено общее имя `index`. То же самое относится к использованию `sidebar.yml`, но не указанию ни `title`, ни `index`, а только подраздела. Снова появится общее имя `index`. ## Блог + Функция блога описана в [отдельном документе](/ru/scala3/guides/scaladoc/blog.html). ## Расширенная конфигурация + ### Полная структура корня сайта + ``` . └── <site-root>/ @@ -218,8 +268,9 @@ subsection: │ └── ... └── ... ``` -В результате получается статический сайт, содержащий документы, а также блог. -Он также содержит пользовательские макеты и ассеты. + +В результате получается статический сайт, содержащий документы, а также блог. +Он также содержит пользовательские макеты и ассеты. Структура визуализируемой документации может быть основана на файловой системе, но также может быть переопределена конфигурацией YAML. ### Структура каталогов сопоставления @@ -227,6 +278,7 @@ subsection: Используя файл конфигурации YAML, можно определить, как структура исходного каталога должна быть преобразована в структуру выходного каталога. Взглянем на следующее определение подраздела: + ```yaml - title: Some other subsection index: abc/index.html @@ -235,9 +287,10 @@ subsection: - page: abc2/page1.md - page: foo/page2.md ``` -В этом подразделе показана возможность конфигурации YAML отображать структуру каталогов. -Несмотря на то, что индексная страница и все определенные дочерние элементы находятся в разных каталогах, -они будут рендериться в `custom-directory`. -Исходная страница `abc/index.html` будет генерировать страницу `custom-directory/index.html`, -исходная страница `abc2/page1.md` - `custom-directory/page1.html`, + +В этом подразделе показана возможность конфигурации YAML отображать структуру каталогов. +Несмотря на то, что индексная страница и все определенные дочерние элементы находятся в разных каталогах, +они будут рендериться в `custom-directory`. +Исходная страница `abc/index.html` будет генерировать страницу `custom-directory/index.html`, +исходная страница `abc2/page1.md` - `custom-directory/page1.html`, а исходная страница `foo/page2.md` - `custom-directory/page2.html`. From 7e5b4637923c6dc6fe250bb679514dbf297392bf Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Fri, 16 Jun 2023 10:32:17 +0300 Subject: [PATCH 2642/3075] Add types-intersection.md and types-union.md in ru (#2834) --- _overviews/scala3-book/types-intersection.md | 2 +- _overviews/scala3-book/types-union.md | 2 +- _ru/scala3/book/types-generics.md | 2 +- _ru/scala3/book/types-intersection.md | 76 +++++++++++++ _ru/scala3/book/types-union.md | 111 +++++++++++++++++++ 5 files changed, 190 insertions(+), 3 deletions(-) create mode 100644 _ru/scala3/book/types-intersection.md create mode 100644 _ru/scala3/book/types-union.md diff --git a/_overviews/scala3-book/types-intersection.md b/_overviews/scala3-book/types-intersection.md index 8c01dd9b33..66a6f3ec0d 100644 --- a/_overviews/scala3-book/types-intersection.md +++ b/_overviews/scala3-book/types-intersection.md @@ -2,7 +2,7 @@ title: Intersection Types type: section description: This section introduces and demonstrates intersection types in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 50 previous-page: types-generics next-page: types-union diff --git a/_overviews/scala3-book/types-union.md b/_overviews/scala3-book/types-union.md index 271c9a0148..50c5919980 100644 --- a/_overviews/scala3-book/types-union.md +++ b/_overviews/scala3-book/types-union.md @@ -2,7 +2,7 @@ title: Union Types type: section description: This section introduces and demonstrates union types in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 51 previous-page: types-intersection next-page: types-adts-gadts diff --git a/_ru/scala3/book/types-generics.md b/_ru/scala3/book/types-generics.md index 799a85e3d5..653d6cacbd 100644 --- a/_ru/scala3/book/types-generics.md +++ b/_ru/scala3/book/types-generics.md @@ -9,7 +9,7 @@ description: В этом разделе представлены парамет language: ru num: 49 previous-page: types-inferred -next-page: +next-page: types-intersection --- Универсальные (_generic_) классы (или trait-ы) принимают тип в качестве _параметра_ в квадратных скобках `[...]`. diff --git a/_ru/scala3/book/types-intersection.md b/_ru/scala3/book/types-intersection.md new file mode 100644 index 0000000000..6fa78e33ab --- /dev/null +++ b/_ru/scala3/book/types-intersection.md @@ -0,0 +1,76 @@ +--- +layout: multipage-overview +title: Пересечение типов +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлены пересечение типов в Scala 3. +language: ru +num: 50 +previous-page: types-generics +next-page: types-union +--- + +<span class="tag tag-inline">Только в Scala 3</span> + +Используемый для типов оператор `&` создает так называемый _тип пересечения_ (_intersection type_). +Тип `A & B` представляет собой значения, которые **одновременно** относятся как к типу `A`, так и к типу `B`. +Например, в следующем примере используется тип пересечения `Resettable & Growable[String]`: + +{% tabs intersection-reset-grow %} + +{% tab 'Только в Scala 3' %} + +```scala +trait Resettable: + def reset(): Unit + +trait Growable[A]: + def add(a: A): Unit + +def f(x: Resettable & Growable[String]): Unit = + x.reset() + x.add("first") +``` + +{% endtab %} + +{% endtabs %} + +В методе `f` в этом примере параметр `x` должен быть _одновременно_ как `Resettable`, так и `Growable[String]`. + +Все _члены_ типа пересечения `A & B` являются типом `A` и типом `B`. +Следовательно, как показано, для `Resettable & Growable[String]` доступны методы `reset` и `add`. + +Пересечение типов может быть полезно для _структурного_ описания требований. +В примере выше для `f` мы прямо заявляем, что нас устраивает любое значение для `x`, +если оно является подтипом как `Resettable`, так и `Growable`. +**Нет** необходимости создавать _номинальный_ вспомогательный trait, подобный следующему: + +{% tabs normal-trait class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait Both[A] extends Resettable with Growable[A] +def f(x: Both[String]): Unit +``` + +{% endtab %} + +{% tab 'Scala 3' %} + +```scala +trait Both[A] extends Resettable, Growable[A] +def f(x: Both[String]): Unit +``` + +{% endtab %} +{% endtabs %} + +Существует важное различие между двумя вариантами определения `f`: +в то время как оба позволяют вызывать `f` с экземплярами `Both`, +только первый позволяет передавать экземпляры, +которые являются подтипами `Resettable` и `Growable[String]`, _но не_ `Both[String]`. + +> Обратите внимание, что `&` _коммутативно_: `A & B` имеет тот же тип, что и `B & A`. diff --git a/_ru/scala3/book/types-union.md b/_ru/scala3/book/types-union.md new file mode 100644 index 0000000000..35a0f440f6 --- /dev/null +++ b/_ru/scala3/book/types-union.md @@ -0,0 +1,111 @@ +--- +layout: multipage-overview +title: Объединение типов +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлены объединение типов в Scala 3. +language: ru +num: 51 +previous-page: types-intersection +next-page: +--- + +<span class="tag tag-inline">Только в Scala 3</span> + +Используемый для типов `|` оператор создает так называемый _тип объединения_ (_union type_). +Тип `А | B` представляет значения, которые относятся **либо** к типу `A`, **либо** к типу `B`. + +В следующем примере метод `help` принимает параметр с именем `id` типа объединения `Username | Password`, +который может быть либо `Username`, либо `Password`: + +```scala +case class Username(name: String) +case class Password(hash: Hash) + +def help(id: Username | Password) = + val user = id match + case Username(name) => lookupName(name) + case Password(hash) => lookupPassword(hash) + // дальнейший код ... +``` + +Мы реализуем метод `help`, разделяя две альтернативы с использованием сопоставления с образцом. + +Этот код является гибким и типобезопасным решением. +Если попытаться передать тип, отличный от `Username` или `Password`, компилятор пометит это как ошибку: + +```scala +help("hi") // error: Found: ("hi" : String) + // Required: Username | Password +``` + +Ошибка также будет получена, если попытаться добавить `case` в выражение `match`, +которое не соответствует типам `Username` или `Password`: + +```scala +case 1.0 => ??? // Ошибка: это строка не компилируется +``` + +### Альтернатива объединенным типам + +Как показано, объединенные типы могут использоваться для представления вариантов нескольких разных типов, +не требуя, чтобы эти типы были частью специально созданной иерархии классов. + +#### Предварительное планирование иерархии классов + +Другие языки требуют предварительного планирования иерархии классов, как показано в следующем примере: + +```scala +trait UsernameOrPassword +case class Username(name: String) extends UsernameOrPassword +case class Password(hash: Hash) extends UsernameOrPassword +def help(id: UsernameOrPassword) = ... +``` + +Предварительное планирование не очень хорошо масштабируется, +поскольку, например, требования пользователей API могут быть непредсказуемыми. +Кроме того, загромождение иерархии типов маркерами типа `UsernameOrPassword` затрудняет чтение кода. + +#### Теговые объединения + +Другой альтернативой является задание отдельного типа перечисления, например: + +```scala +enum UsernameOrPassword: + case IsUsername(u: Username) + case IsPassword(p: Password) +``` + +Перечисление `UsernameOrPassword` представляет собой _помеченное_ (_tagged_) объединение `Username` и `Password`. +Однако этот способ моделирования объединения требует _явной упаковки и распаковки_, +и, например, `Username` **не** является подтипом `UsernameOrPassword`. + +### Вывод типов объединения + +Компилятор присваивает типу объединения выражение, _только если_ такой тип явно задан. +Например, рассмотрим такие значения: + +```scala +val name = Username("Eve") // name: Username = Username(Eve) +val password = Password(123) // password: Password = Password(123) +``` + +В этом REPL примере показано, +как можно использовать тип объединения при привязке переменной к результату выражения `if`/`else`: + +``` +scala> val a = if true then name else password +val a: Object = Username(Eve) + +scala> val b: Password | Username = if true then name else password +val b: Password | Username = Username(Eve) +``` + +Типом `a` является `Object`, который является супертипом `Username` и `Password`, +но не _наименьшим_ супертипом, `Password | Username`. +Если необходим наименьший супертип, его нужно указать явно, как это делается для `b`. + +> Типы объединения являются двойственными типам пересечения. +> И как `&` с типами пересечения, `|` также коммутативен: `A | B` того же типа, что и `B | А`. From 7b755ce1b7dd7fb98aa5dbd8f646726c322e6a6c Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Fri, 16 Jun 2023 10:33:21 +0300 Subject: [PATCH 2643/3075] Refresh case-classes.md and nested-functions.md in russian (#2835) --- _ru/tour/case-classes.md | 59 +++++++++++++++++++++++++++++++++--- _ru/tour/nested-functions.md | 52 +++++++++++++++++++++++++------ _tour/case-classes.md | 2 +- 3 files changed, 98 insertions(+), 15 deletions(-) diff --git a/_ru/tour/case-classes.md b/_ru/tour/case-classes.md index 64fab9024e..467fc0655e 100644 --- a/_ru/tour/case-classes.md +++ b/_ru/tour/case-classes.md @@ -9,40 +9,82 @@ previous-page: multiple-parameter-lists prerequisite-knowledge: classes, basics, mutability --- -Классы образцы (Case classes) похожи на обычные классы с несколькими ключевыми отличиями, о которых мы поговорим ниже. Классы образцы хороши для моделирования неизменяемых данных. На следующей странице обзора вы увидите, насколько они полезны для участия в [сопоставлении с примером](pattern-matching.html). +Классы образцы (Case classes) похожи на обычные классы с несколькими ключевыми отличиями, о которых мы поговорим ниже. +Классы образцы хороши для моделирования неизменяемых данных. +На следующей странице обзора вы увидите, насколько они полезны для участия в [сопоставлении с примером](pattern-matching.html). ## Объявление класса образца + Минимальный вариант объявления класса образца: указание ключевого слова `case class`, название и список параметров (которые могут быть пустыми). Пример: + +{% tabs case-classe_Book %} + +{% tab 'Scala 2 и 3' for=case-classe_Book %} + ```scala mdoc case class Book(isbn: String) val frankenstein = Book("978-0486282114") ``` -Обратите внимание, что ключевое слово `new` не было использовано для создания экземпляра класса `Book`. Это связано с тем, что классы образцы по умолчанию имеют объект компаньон с методом `apply`, который берет на себя заботу о создании экземпляра класса. + +{% endtab %} + +{% endtabs %} + +Обратите внимание, что ключевое слово `new` не было использовано для создания экземпляра класса `Book`. +Это связано с тем, что классы образцы по умолчанию имеют объект компаньон с методом `apply`, +который берет на себя заботу о создании экземпляра класса. При создании класса образца с параметрами, эти параметры являются публичными и неизменяемыми. + +{% tabs case-classe_Message_define %} + +{% tab 'Scala 2 и 3' for=case-classe_Message_define %} + ``` case class Message(sender: String, recipient: String, body: String) val message1 = Message("guillaume@quebec.ca", "jorge@catalonia.es", "Ça va ?") -println(message1.sender) // prints guillaume@quebec.ca +println(message1.sender) // печатает guillaume@quebec.ca message1.sender = "travis@washington.us" // эта строка не компилируется ``` + +{% endtab %} + +{% endtabs %} + Вы не можете переназначить `message1.sender`, потому что это `val` (т.е. константа). Возможно использовать `var` в классах образцах, но это не рекомендуется. ## Сравнение + Классы образцы сравниваются по структуре, а не по ссылкам: -``` + +{% tabs case-classe_Message_compare %} + +{% tab 'Scala 2 и 3' for=case-classe_Message_compare %} + +```scala mdoc case class Message(sender: String, recipient: String, body: String) val message2 = Message("jorge@catalonia.es", "guillaume@quebec.ca", "Com va?") val message3 = Message("jorge@catalonia.es", "guillaume@quebec.ca", "Com va?") val messagesAreTheSame = message2 == message3 // true ``` + +{% endtab %} + +{% endtabs %} + Даже если `message2` и `message3` ссылаются на разные объекты, значения каждого из них равны. ## Копирование + Вы можете создать копию экземпляра класса образца, просто воспользовавшись методом `copy`. При этом по желанию можно изменить аргументы конструктора. + +{% tabs case-classe_Message_copy %} + +{% tab 'Scala 2 и 3' for=case-classe_Message_copy %} + ``` case class Message(sender: String, recipient: String, body: String) val message4 = Message("julien@bretagne.fr", "travis@washington.us", "Me zo o komz gant ma amezeg") @@ -51,4 +93,13 @@ message5.sender // travis@washington.us message5.recipient // claire@bourgogne.fr message5.body // "Me zo o komz gant ma amezeg" ``` + +{% endtab %} + +{% endtabs %} + Получатель `message4` использует в качестве отправителя `message5`, кроме параметра `body` который был скопирован из `message4`. + +## Дополнительные ресурсы + +- Дополнительная информация о классах образцах доступна в [Scala Book](/ru/scala3/book/domain-modeling-tools.html#case-class-ы) diff --git a/_ru/tour/nested-functions.md b/_ru/tour/nested-functions.md index f4b689dbd4..8bc05a9d70 100644 --- a/_ru/tour/nested-functions.md +++ b/_ru/tour/nested-functions.md @@ -10,22 +10,54 @@ previous-page: higher-order-functions В Scala возможно объявление метода вкладывать в тело другого метода. Это реализовано в следующем примере, в котором метод `factorial` используется для вычисления факториала заданного числа: +{% tabs Nested_functions_definition class=tabs-scala-version %} + +{% tab 'Scala 2' for=Nested_functions_definition %} + ```scala mdoc - def factorial(x: Int): Int = { - def fact(x: Int, accumulator: Int): Int = { - if (x <= 1) accumulator - else fact(x - 1, x * accumulator) - } - fact(x, 1) - } - - println("Factorial of 2: " + factorial(2)) - println("Factorial of 3: " + factorial(3)) +def factorial(x: Int): Int = { + def fact(x: Int, accumulator: Int): Int = { + if (x <= 1) accumulator + else fact(x - 1, x * accumulator) + } + fact(x, 1) +} + +println("Factorial of 2: " + factorial(2)) +println("Factorial of 3: " + factorial(3)) ``` +{% endtab %} + +{% tab 'Scala 3' for=Nested_functions_definition %} + +```scala +def factorial(x: Int): Int = + def fact(x: Int, accumulator: Int): Int = + if x <= 1 then accumulator + else fact(x - 1, x * accumulator) + fact(x, 1) + +println("Factorial of 2: " + factorial(2)) +println("Factorial of 3: " + factorial(3)) + +``` + +{% endtab %} + +{% endtabs %} + +{% tabs Nested_functions_result %} + +{% tab 'Scala 2 и 3' for=Nested_functions_result %} + Результат выполнения программы: ``` Factorial of 2: 2 Factorial of 3: 6 ``` + +{% endtab %} + +{% endtabs %} diff --git a/_tour/case-classes.md b/_tour/case-classes.md index 17aa73fc7c..889f8e98bc 100644 --- a/_tour/case-classes.md +++ b/_tour/case-classes.md @@ -89,4 +89,4 @@ The recipient of `message4` is used as the sender of `message5` but the `body` o ## More resources -* Learn more about case classes in the [Scala Book](/overviews/scala-book/case-classes.html) +* Learn more about case classes in the [Scala Book](/scala3/book/domain-modeling-tools.html#case-classes) From 27760cedb09303ded5031a079c1c8b232ecf0885 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Fri, 16 Jun 2023 10:33:55 +0300 Subject: [PATCH 2644/3075] Refresh multiple-parameter-lists.md in russian (#2836) --- _ru/tour/multiple-parameter-lists.md | 233 ++++++++++++++++++++++----- 1 file changed, 190 insertions(+), 43 deletions(-) diff --git a/_ru/tour/multiple-parameter-lists.md b/_ru/tour/multiple-parameter-lists.md index c93a6e31d1..99f84700d5 100644 --- a/_ru/tour/multiple-parameter-lists.md +++ b/_ru/tour/multiple-parameter-lists.md @@ -8,77 +8,224 @@ next-page: case-classes previous-page: nested-functions --- -Методы могут объявляться с несколькими списками параметров. При этом когда такой метод вызывается с меньшим количеством списков параметров, это приводит к созданию новой функции, которая ожидает на вход не достающий список параметров. Формально это называется [частичное применение](https://en.wikipedia.org/wiki/Partial_application). +Методы могут объявляться с несколькими списками параметров. -Например, - -```scala mdoc -val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) -val numberFunc = numbers.foldLeft(List[Int]()) _ +### Пример -val squares = numberFunc((xs, x) => xs :+ x*x) -print(squares) // List(1, 4, 9, 16, 25, 36, 49, 64, 81, 100) +Вот пример, определенный для трейта `Iterable` из API Scala коллекций: -val cubes = numberFunc((xs, x) => xs :+ x*x*x) -print(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) +{% tabs foldLeft_definition class=tabs-scala-version %} + +{% tab 'Scala 2' for=foldLeft_definition %} + +```scala +trait Iterable[A] { + ... + def foldLeft[B](z: B)(op: (B, A) => B): B + ... +} ``` -Рассмотрим такие примеры из класса [Traversable](/overviews/collections/trait-traversable.html) коллекции Scala: +{% endtab %} -```scala mdoc:fail +{% tab 'Scala 3' for=foldLeft_definition %} + +```scala +trait Iterable[A]: +... def foldLeft[B](z: B)(op: (B, A) => B): B +... ``` -`foldLeft` применяет бинарный оператор `op` к начальному значению `z` и ко всем остальным элементам коллекции слева направо. Ниже приведен пример его использования. +{% endtab %} -Начиная с начального значения 0, `foldLeft` применяет функцию `(m, n) => m + n` к каждому элементу списка и предыдущему накопленному значению. +{% endtabs %} -```scala mdoc:nest +`foldLeft` применяет бинарный оператор `op` к начальному значению `z` и ко всем остальным элементам коллекции слева направо. +Ниже приведен пример его использования. + +Начиная с начального значения `0`, `foldLeft` применяет функцию `(m, n) => m + n` к каждому элементу списка +и предыдущему накопленному значению. + +{% tabs foldLeft_use %} + +{% tab 'Scala 2 и 3' for=foldLeft_use %} + +```scala mdoc val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) val res = numbers.foldLeft(0)((m, n) => m + n) -print(res) // 55 +println(res) // 55 ``` -Множественные списки параметров имеют избыточный синтаксис, поэтому их следует использовать экономно. Можем предложить следующие варианты для использования множественных списков (каррирования): +{% endtab %} -#### Отдельный функциональный параметр - Функцию `op` можно выделить в отдельный функциональный параметр у `foldLeft`, благодаря такому выделению становится возможен более элегантный стиль передачи анонимной функции в метод. Без такого выделения код выглядел бы следующим образом: -```scala -numbers.foldLeft(0, {(m: Int, n: Int) => m + n}) +{% endtabs %} + +### Варианты для использования + +Предлагаемые варианты для использования множественных списков параметров включают: + +#### Вывод типа + +Исторически сложилось, что в Scala вывод типов происходит по одному списку параметров за раз. +Скажем, у вас есть следующий метод: + +{% tabs foldLeft1_definition %} + +{% tab 'Scala 2 и 3' for=foldLeft1_definition %} + +```scala mdoc +def foldLeft1[A, B](as: List[A], b0: B, op: (B, A) => B) = ??? +``` + +{% endtab %} + +{% endtabs %} + +Затем при желании вызвать его следующим образом, можно обнаружить, что метод не компилируется: + +{% tabs foldLeft1_wrong_use %} + +{% tab 'Scala 2 и 3' for=foldLeft1_wrong_use %} + +```scala mdoc:fail +def notPossible = foldLeft1(numbers, 0, _ + _) ``` - - Обратите внимание, что использование отдельного функционального параметра позволяет нам использовать автоматическое выведение типа для него, что делает код еще более кратким, это было бы невозможно без каррирования. - + +{% endtab %} + +{% endtabs %} + +вам нужно будет вызвать его одним из следующих способов: + +{% tabs foldLeft1_good_use %} + +{% tab 'Scala 2 и 3' for=foldLeft1_good_use %} + ```scala mdoc -numbers.foldLeft(0)(_ + _) +def firstWay = foldLeft1[Int, Int](numbers, 0, _ + _) +def secondWay = foldLeft1(numbers, 0, (a: Int, b: Int) => a + b) ``` - Если в утверждении `numbers.foldLeft(0)(_ + _)` зафиксировать отдельный параметр `z`, мы получим частично определенную функцию, которую можно переиспользовать, как показано ниже: -```scala mdoc:nest -val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) -val numberFunc = numbers.foldLeft(List[Int]())_ // z = Empty.List[Int] -val squares = numberFunc((xs, x) => xs:+ x*x) -print(squares.toString()) // List(1, 4, 9, 16, 25, 36, 49, 64, 81, 100) +{% endtab %} + +{% endtabs %} + +Это связано с тем, что Scala не может вывести тип функции `_ + _`, так как она все еще выводит `A` и `B`. +Путем перемещения параметра `op` в собственный список параметров, `A` и `B` выводятся в первом списке. +Затем эти предполагаемые типы будут доступны для второго списка параметров +и `_ + _` станет соответствовать предполагаемому типу `(Int, Int) => Int`. + +{% tabs foldLeft2_definition_and_use %} -val cubes = numberFunc((xs, x) => xs:+ x*x*x) -print(cubes.toString()) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) +{% tab 'Scala 2 и 3' for=foldLeft2_definition_and_use %} + +```scala mdoc +def foldLeft2[A, B](as: List[A], b0: B)(op: (B, A) => B) = ??? +def possible = foldLeft2(numbers, 0)(_ + _) ``` - `foldLeft` и `foldRight` может быть использован в любой из следующих вариаций, +{% endtab %} + +{% endtabs %} + +Последнее определение метода не нуждается в подсказках типа и может вывести все типы своих параметров. + +#### Неявные параметры + +Чтоб указать что параметр используется [_неявно_ (_implicit_)](/ru/tour/implicit-parameters.html) +необходимо задавать несколько списков параметров. +Примером может служить следующее: + +{% tabs execute_definition class=tabs-scala-version %} + +{% tab 'Scala 2' for=execute_definition %} + +```scala mdoc +def execute(arg: Int)(implicit ec: scala.concurrent.ExecutionContext) = ??? +``` + +{% endtab %} + +{% tab 'Scala 3' for=execute_definition %} + +```scala +def execute(arg: Int)(using ec: scala.concurrent.ExecutionContext) = ??? +``` + +{% endtab %} + +{% endtabs %} + +#### Частичное применение + +Методы могут объявляться с несколькими списками параметров. +При этом когда такой метод вызывается с меньшим количеством списков параметров, +это приводит к созданию новой функции, +которая ожидает на вход недостающий список параметров. +Формально это называется [частичное применение](https://ru.wikipedia.org/wiki/%D0%A7%D0%B0%D1%81%D1%82%D0%B8%D1%87%D0%BD%D0%BE%D0%B5_%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5). + +Например, + +{% tabs foldLeft_partial %} + +{% tab 'Scala 2 и 3' for=foldLeft_partial %} + ```scala mdoc:nest val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +val numberFunc = numbers.foldLeft(List[Int]()) _ -numbers.foldLeft(0)((sum, item) => sum + item) // Общая Форма -numbers.foldRight(0)((sum, item) => sum + item) // Общая Форма +val squares = numberFunc((xs, x) => xs :+ x*x) +println(squares) // List(1, 4, 9, 16, 25, 36, 49, 64, 81, 100) -numbers.foldLeft(0)(_+_) // Форма с каррированием -numbers.foldRight(0)(_+_) // Форма с каррированием +val cubes = numberFunc((xs, x) => xs :+ x*x*x) +println(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) ``` - -#### Неявные параметры - Чтоб указать что параметр используется неявно (`implicit`) необходимо задавать несколько списков параметров. Примером может служить следующее: +{% endtab %} -```scala -def execute(arg: Int)(implicit ec: ExecutionContext) = ??? +{% endtabs %} + +### Сравнение с «каррированием» + +Иногда можно встретить, что метод с несколькими списками параметров называется «каррированный». + +Как говорится [в статье на Википедии о каррировании](https://ru.wikipedia.org/wiki/%D0%9A%D0%B0%D1%80%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5), + +> Каррирование — преобразование функции от многих аргументов в набор вложенных функций, +> каждая из которых является функцией от одного аргумента. + +Мы не рекомендуем использовать слово «каррирование» в отношении множественных списков параметров Scala по двум причинам: + +1. В Scala множественные параметры и множественные списки параметров задаются + и реализуются непосредственно как часть языка, а не преобразуются из функций с одним параметром. + +2. Существует опасность путаницы с методами из стандартной Scala библиотеки + [`curried`](<https://www.scala-lang.org/api/current/scala/Function2.html#curried:T1=%3E(T2=%3ER)>) + и [`uncurried`](<https://www.scala-lang.org/api/current/scala/Function$.html#uncurried[T1,T2,R](f:T1=%3E(T2=%3ER)):(T1,T2)=%3ER>), + которые вообще не включают множественные списки параметров. + +Тем не менее, несомненно, есть сходство между множественными списками параметров и каррированием. +Хотя они различаются в месте определения, +в месте вызова могут тем не менее выглядеть одинаково, как в этом примере: + +{% tabs about_currying %} + +{% tab 'Scala 2 и 3' for=about_currying %} + +```scala mdoc +// версия с множественными списками параметров +def addMultiple(n1: Int)(n2: Int) = n1 + n2 +// два различных способа получить каррированную версию +def add(n1: Int, n2: Int) = n1 + n2 +val addCurried1 = (add _).curried +val addCurried2 = (n1: Int) => (n2: Int) => n1 + n2 +// независимо от определения, вызов всех трех идентичен +addMultiple(3)(4) // 7 +addCurried1(3)(4) // 7 +addCurried2(3)(4) // 7 ``` + +{% endtab %} + +{% endtabs %} From 5fc3303340a728af16f986e4d33c461cfe0e36c2 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Fri, 16 Jun 2023 09:53:03 +0200 Subject: [PATCH 2645/3075] Remove broken link --- _ja/overviews/core/futures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/overviews/core/futures.md b/_ja/overviews/core/futures.md index d83e2043e8..1d0575a723 100644 --- a/_ja/overviews/core/futures.md +++ b/_ja/overviews/core/futures.md @@ -151,7 +151,7 @@ Future の実装の多くは、Future の結果を知りたくなったクライ `Future` は、失敗した結果のみを処理する方法を提供していて、 `Failure[Throwable]` を `Success[Throwable]` へと変換する `failed` 投射を用いることができる。 -詳細は以下の[投射](#projections)を参照。 +詳細は以下の投射を参照。 キーワードの初出の位置を検索する例に戻ると、キーワードの位置を画面に表示したいかもしれない: From 4041df7e5dc3dffac1d715fd03982272a5e638e7 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Fri, 16 Jun 2023 16:55:10 +0200 Subject: [PATCH 2646/3075] Add result of SIP meeting --- _sips/results/2023-06-16-meeting.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 _sips/results/2023-06-16-meeting.md diff --git a/_sips/results/2023-06-16-meeting.md b/_sips/results/2023-06-16-meeting.md new file mode 100644 index 0000000000..0ad96e5ffb --- /dev/null +++ b/_sips/results/2023-06-16-meeting.md @@ -0,0 +1,9 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 16th June 2023 +partof: results +proposals: + - url: https://docs.scala-lang.org/sips/multi-source-extension-overloads.html + name: SIP-54 - Multi-Source Extension Overloads + result: accepted +--- From 9f0cebf2eb5f1de67b204de595ef2a611c235531 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 17 Jun 2023 00:23:08 +0000 Subject: [PATCH 2647/3075] Update SIPs state --- _sips/sips/multi-source-extension-overloads.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/_sips/sips/multi-source-extension-overloads.md b/_sips/sips/multi-source-extension-overloads.md index 5e9fa17958..a8a0637a7a 100644 --- a/_sips/sips/multi-source-extension-overloads.md +++ b/_sips/sips/multi-source-extension-overloads.md @@ -1,9 +1,8 @@ --- layout: sip permalink: /sips/:title.html -stage: implementation -status: vote-requested -recommendation: accept +stage: completed +status: accepted title: SIP-54 - Multi-Source Extension Overloads --- From 0e8d74620bba0e51e7d13bcd177e49145ad728a9 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 20 Jun 2023 00:22:16 +0000 Subject: [PATCH 2648/3075] Update SIPs state --- _sips/sips/concurrency-with-higher-order-coroutines.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/concurrency-with-higher-order-coroutines.md diff --git a/_sips/sips/concurrency-with-higher-order-coroutines.md b/_sips/sips/concurrency-with-higher-order-coroutines.md new file mode 100644 index 0000000000..837df46236 --- /dev/null +++ b/_sips/sips/concurrency-with-higher-order-coroutines.md @@ -0,0 +1,7 @@ +--- +title: SIP-55 - Concurrency with Higher-Order Coroutines +status: under-review +pull-request-number: 63 +stage: design + +--- From 8574b5de8ee992d7f0de1d5f52e15d1c2f179201 Mon Sep 17 00:00:00 2001 From: steve layland <slayland@tubi.tv> Date: Tue, 20 Jun 2023 04:35:03 -0700 Subject: [PATCH 2649/3075] Merge string-interpolation docs into scala3 book (#2839) Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> --- _overviews/core/string-interpolation.md | 262 ------------- .../scala-book/two-notes-about-strings.md | 2 +- _overviews/scala3-book/ca-context-bounds.md | 2 +- .../scala3-book/ca-context-parameters.md | 2 +- .../ca-contextual-abstractions-intro.md | 2 +- .../scala3-book/ca-extension-methods.md | 2 +- _overviews/scala3-book/ca-given-imports.md | 2 +- .../scala3-book/ca-implicit-conversions.md | 2 +- .../scala3-book/ca-multiversal-equality.md | 2 +- _overviews/scala3-book/ca-summary.md | 2 +- _overviews/scala3-book/ca-type-classes.md | 2 +- _overviews/scala3-book/collections-classes.md | 2 +- _overviews/scala3-book/collections-intro.md | 2 +- _overviews/scala3-book/collections-methods.md | 2 +- _overviews/scala3-book/collections-summary.md | 2 +- _overviews/scala3-book/concurrency.md | 2 +- _overviews/scala3-book/control-structures.md | 4 +- _overviews/scala3-book/domain-modeling-fp.md | 2 +- .../scala3-book/domain-modeling-intro.md | 2 +- _overviews/scala3-book/domain-modeling-oop.md | 2 +- .../scala3-book/domain-modeling-tools.md | 2 +- _overviews/scala3-book/first-look-at-types.md | 122 ++---- .../fp-functional-error-handling.md | 2 +- .../scala3-book/fp-functions-are-values.md | 2 +- _overviews/scala3-book/fp-immutable-values.md | 2 +- _overviews/scala3-book/fp-intro.md | 2 +- _overviews/scala3-book/fp-pure-functions.md | 2 +- _overviews/scala3-book/fp-summary.md | 2 +- _overviews/scala3-book/fp-what-is-fp.md | 2 +- .../scala3-book/fun-anonymous-functions.md | 2 +- _overviews/scala3-book/fun-eta-expansion.md | 2 +- .../scala3-book/fun-function-variables.md | 2 +- _overviews/scala3-book/fun-hofs.md | 2 +- _overviews/scala3-book/fun-intro.md | 2 +- _overviews/scala3-book/fun-summary.md | 2 +- .../scala3-book/fun-write-map-function.md | 2 +- .../fun-write-method-returns-function.md | 2 +- .../scala3-book/interacting-with-java.md | 2 +- _overviews/scala3-book/methods-intro.md | 2 +- .../scala3-book/methods-main-methods.md | 2 +- _overviews/scala3-book/methods-most.md | 2 +- _overviews/scala3-book/methods-summary.md | 2 +- _overviews/scala3-book/packaging-imports.md | 2 +- _overviews/scala3-book/scala-for-java-devs.md | 2 +- .../scala3-book/scala-for-javascript-devs.md | 2 +- .../scala3-book/scala-for-python-devs.md | 2 +- _overviews/scala3-book/scala-tools.md | 2 +- .../scala3-book/string-interpolation.md | 358 ++++++++++++++++++ _overviews/scala3-book/tools-sbt.md | 2 +- _overviews/scala3-book/tools-worksheets.md | 2 +- _overviews/scala3-book/types-adts-gadts.md | 2 +- .../scala3-book/types-dependent-function.md | 2 +- _overviews/scala3-book/types-generics.md | 2 +- _overviews/scala3-book/types-inferred.md | 2 +- _overviews/scala3-book/types-intersection.md | 2 +- _overviews/scala3-book/types-introduction.md | 2 +- _overviews/scala3-book/types-opaque-types.md | 2 +- _overviews/scala3-book/types-others.md | 2 +- _overviews/scala3-book/types-structural.md | 2 +- _overviews/scala3-book/types-union.md | 2 +- _overviews/scala3-book/types-variance.md | 2 +- _overviews/scala3-book/where-next.md | 2 +- _ru/scala3/book/first-look-at-types.md | 78 ++-- .../scala3-book/first-look-at-types.md | 2 +- 64 files changed, 494 insertions(+), 448 deletions(-) delete mode 100644 _overviews/core/string-interpolation.md create mode 100644 _overviews/scala3-book/string-interpolation.md diff --git a/_overviews/core/string-interpolation.md b/_overviews/core/string-interpolation.md deleted file mode 100644 index e2ad7b2366..0000000000 --- a/_overviews/core/string-interpolation.md +++ /dev/null @@ -1,262 +0,0 @@ ---- -layout: singlepage-overview -title: String Interpolation -partof: string-interpolation - -languages: [es, ja, zh-cn] - -permalink: /overviews/core/:title.html ---- - -**Josh Suereth** - -## Introduction - -Starting in Scala 2.10.0, Scala offers a new mechanism to create strings from your data: String Interpolation. -String Interpolation allows users to embed variable references directly in *processed* string literals. Here's an example: - -{% tabs example-1 %} -{% tab 'Scala 2 and 3' for=example-1 %} - val name = "James" - println(s"Hello, $name") // Hello, James -{% endtab %} -{% endtabs %} - -In the above, the literal `s"Hello, $name"` is a *processed* string literal. This means that the compiler does some additional -work to this literal. A processed string literal is denoted by a set of characters preceding the `"`. String interpolation -was introduced by [SIP-11](https://docs.scala-lang.org/sips/pending/string-interpolation.html), which contains all details of the implementation. - -## Usage - -Scala provides three string interpolation methods out of the box: `s`, `f` and `raw`. - -### The `s` String Interpolator - -Prepending `s` to any string literal allows the usage of variables directly in the string. You've already seen an example here: - -{% tabs example-2 %} -{% tab 'Scala 2 and 3' for=example-2 %} - val name = "James" - println(s"Hello, $name") // Hello, James -{% endtab %} -{% endtabs %} - -Here `$name` is nested inside an `s` processed string. The `s` interpolator knows to insert the value of the `name` variable at this location -in the string, resulting in the string `Hello, James`. With the `s` interpolator, any name that is in scope can be used within a string. - -String interpolators can also take arbitrary expressions. For example: - -{% tabs example-3 %} -{% tab 'Scala 2 and 3' for=example-3 %} - println(s"1 + 1 = ${1 + 1}") -{% endtab %} -{% endtabs %} - -will print the string `1 + 1 = 2`. Any arbitrary expression can be embedded in `${}`. - -For some special characters, it is necessary to escape them when embedded within a string. -To represent an actual dollar sign you can double it `$$`, like here: - -{% tabs example-4 %} -{% tab 'Scala 2 and 3' for=example-4 %} - println(s"New offers starting at $$14.99") -{% endtab %} -{% endtabs %} - -which will print the string `New offers starting at $14.99`. - -Double quotes also need to be escaped. This can be done by using triple quotes as shown: - -{% tabs example-5 %} -{% tab 'Scala 2 and 3' for=example-5 %} - val person = """{"name":"James"}""" -{% endtab %} -{% endtabs %} - -which will produce the string `{"name":"James"}` when printed. - -### The `f` Interpolator - -Prepending `f` to any string literal allows the creation of simple formatted strings, similar to `printf` in other languages. When using the `f` -interpolator, all variable references should be followed by a `printf`-style format string, like `%d`. Let's look at an example: - -{% tabs example-6 %} -{% tab 'Scala 2 and 3' for=example-6 %} - val height = 1.9d - val name = "James" - println(f"$name%s is $height%2.2f meters tall") // James is 1.90 meters tall -{% endtab %} -{% endtabs %} - -The `f` interpolator is typesafe. If you try to pass a format string that only works for integers but pass a double, the compiler will issue an -error. For example: - -{% tabs f-interpolator-error class=tabs-scala-version %} - -{% tab 'Scala 2' for=f-interpolator-error %} -```scala -val height: Double = 1.9d - -scala> f"$height%4d" -<console>:9: error: type mismatch; - found : Double - required: Int - f"$height%4d" - ^ -``` -{% endtab %} - -{% tab 'Scala 3' for=f-interpolator-error %} -```scala -val height: Double = 1.9d - -scala> f"$height%4d" --- Error: ---------------------------------------------------------------------- -1 |f"$height%4d" - | ^^^^^^ - | Found: (height : Double), Required: Int, Long, Byte, Short, BigInt -1 error found - -``` -{% endtab %} - -{% endtabs %} - -The `f` interpolator makes use of the string format utilities available from Java. The formats allowed after the `%` character are outlined in the -[Formatter javadoc](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Formatter.html#detail). If there is no `%` character after a variable -definition a formatter of `%s` (`String`) is assumed. - -### The `raw` Interpolator - -The raw interpolator is similar to the `s` interpolator except that it performs no escaping of literals within the string. Here's an example processed string: - -{% tabs example-7 %} -{% tab 'Scala 2 and 3' for=example-7 %} - scala> s"a\nb" - res0: String = - a - b -{% endtab %} -{% endtabs %} - -Here the `s` string interpolator replaced the characters `\n` with a return character. The `raw` interpolator will not do that. - -{% tabs example-8 %} -{% tab 'Scala 2 and 3' for=example-8 %} - scala> raw"a\nb" - res1: String = a\nb -{% endtab %} -{% endtabs %} - -The raw interpolator is useful when you want to avoid having expressions like `\n` turn into a return character. - -In addition to the three default string interpolators, users can define their own. - -## Advanced Usage - -In Scala, all processed string literals are simple code transformations. Anytime the compiler encounters a string literal of the form: - -{% tabs example-9 %} -{% tab 'Scala 2 and 3' for=example-9 %} - id"string content" -{% endtab %} -{% endtabs %} - -it transforms it into a method call (`id`) on an instance of [StringContext](https://www.scala-lang.org/api/current/scala/StringContext.html). -This method can also be available on implicit scope. -To define our own string interpolation, we need to create an implicit class (Scala 2) or an `extension` method (Scala 3) that adds a new method to `StringContext`. -Here's an example: - -{% tabs json-definition-and-usage class=tabs-scala-version %} - -{% tab 'Scala 2' for=json-definition-and-usage %} -```scala -// Note: We extends AnyVal to prevent runtime instantiation. See -// value class guide for more info. -implicit class JsonHelper(val sc: StringContext) extends AnyVal { - def json(args: Any*): JSONObject = sys.error("TODO - IMPLEMENT") -} - -def giveMeSomeJson(x: JSONObject): Unit = ... - -giveMeSomeJson(json"{ name: $name, id: $id }") -``` -{% endtab %} - -{% tab 'Scala 3' for=json-definition-and-usage %} -```scala -extension (sc: StringContext) - def json(args: Any*): JSONObject = sys.error("TODO - IMPLEMENT") - -def giveMeSomeJson(x: JSONObject): Unit = ... - -giveMeSomeJson(json"{ name: $name, id: $id }") -``` -{% endtab %} - -{% endtabs %} - -In this example, we're attempting to create a JSON literal syntax using string interpolation. The `JsonHelper` implicit class must be in scope to use this syntax, and the json method would need a complete implementation. However, the result of such a formatted string literal would not be a string, but a `JSONObject`. - -When the compiler encounters the literal `json"{ name: $name, id: $id }"` it rewrites it to the following expression: - -{% tabs extension-desugaring class=tabs-scala-version %} - -{% tab 'Scala 2' for=extension-desugaring %} -```scala -new StringContext("{ name: ", ", id: ", " }").json(name, id) -``` - -The implicit class is then used to rewrite it to the following: - -```scala -new JsonHelper(new StringContext("{ name: ", ", id: ", " }")).json(name, id) -``` -{% endtab %} - -{% tab 'Scala 3' for=extension-desugaring %} -```scala -StringContext("{ name: ", ", id: ", " }").json(name, id) -``` -{% endtab %} - -{% endtabs %} - -So, the `json` method has access to the raw pieces of strings and each expression as a value. A simplified (buggy) implementation of this method could be: - -{% tabs json-fake-implementation class=tabs-scala-version %} - -{% tab 'Scala 2' for=json-fake-implementation %} -```scala -implicit class JsonHelper(val sc: StringContext) extends AnyVal { - def json(args: Any*): JSONObject = { - val strings = sc.parts.iterator - val expressions = args.iterator - val buf = new StringBuilder(strings.next()) - while (strings.hasNext) { - buf.append(expressions.next()) - buf.append(strings.next()) - } - parseJson(buf) - } -} -``` -{% endtab %} - -{% tab 'Scala 3' for=json-fake-implementation %} -```scala -extension (sc: StringContext) - def json(args: Any*): JSONObject = - val strings = sc.parts.iterator - val expressions = args.iterator - val buf = new StringBuilder(strings.next()) - while strings.hasNext do - buf.append(expressions.next()) - buf.append(strings.next()) - parseJson(buf) -``` -{% endtab %} - -{% endtabs %} - -Each of the string portions of the processed string are exposed in the `StringContext`'s `parts` member. Each of the expression values is passed into the `json` method's `args` parameter. The `json` method takes this and generates a big string which it then parses into JSON. A more sophisticated implementation could avoid having to generate this string and simply construct the JSON directly from the raw strings and expression values. diff --git a/_overviews/scala-book/two-notes-about-strings.md b/_overviews/scala-book/two-notes-about-strings.md index 131c37f4f1..31a097f758 100644 --- a/_overviews/scala-book/two-notes-about-strings.md +++ b/_overviews/scala-book/two-notes-about-strings.md @@ -9,7 +9,7 @@ num: 11 outof: 54 previous-page: built-in-types next-page: command-line-io -new-version: /scala3/book/first-look-at-types.html#two-notes-about-strings +new-version: /scala3/book/first-look-at-types.html#strings --- diff --git a/_overviews/scala3-book/ca-context-bounds.md b/_overviews/scala3-book/ca-context-bounds.md index fee7cbd146..efafda98d8 100644 --- a/_overviews/scala3-book/ca-context-bounds.md +++ b/_overviews/scala3-book/ca-context-bounds.md @@ -3,7 +3,7 @@ title: Context Bounds type: section description: This page demonstrates Context Bounds in Scala. languages: [zh-cn] -num: 61 +num: 62 previous-page: ca-context-parameters next-page: ca-given-imports --- diff --git a/_overviews/scala3-book/ca-context-parameters.md b/_overviews/scala3-book/ca-context-parameters.md index 81ca5f7023..5ae6c43b39 100644 --- a/_overviews/scala3-book/ca-context-parameters.md +++ b/_overviews/scala3-book/ca-context-parameters.md @@ -3,7 +3,7 @@ title: Context Parameters type: section description: This page demonstrates how to declare context parameters, and how the compiler infers them at call-site. languages: [zh-cn] -num: 60 +num: 61 previous-page: ca-extension-methods next-page: ca-context-bounds redirect_from: /scala3/book/ca-given-using-clauses.html diff --git a/_overviews/scala3-book/ca-contextual-abstractions-intro.md b/_overviews/scala3-book/ca-contextual-abstractions-intro.md index 5b703e5e6f..33c10dd6cb 100644 --- a/_overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -3,7 +3,7 @@ title: Contextual Abstractions type: chapter description: This chapter provides an introduction to the Scala 3 concept of Contextual Abstractions. languages: [zh-cn] -num: 58 +num: 59 previous-page: types-others next-page: ca-extension-methods --- diff --git a/_overviews/scala3-book/ca-extension-methods.md b/_overviews/scala3-book/ca-extension-methods.md index 4b9cf2ef24..65b30183f4 100644 --- a/_overviews/scala3-book/ca-extension-methods.md +++ b/_overviews/scala3-book/ca-extension-methods.md @@ -3,7 +3,7 @@ title: Extension Methods type: section description: This page demonstrates how Extension Methods work in Scala 3. languages: [zh-cn] -num: 59 +num: 60 previous-page: ca-contextual-abstractions-intro next-page: ca-context-parameters scala3: true diff --git a/_overviews/scala3-book/ca-given-imports.md b/_overviews/scala3-book/ca-given-imports.md index 37a5a9e626..399ff6add0 100644 --- a/_overviews/scala3-book/ca-given-imports.md +++ b/_overviews/scala3-book/ca-given-imports.md @@ -3,7 +3,7 @@ title: Given Imports type: section description: This page demonstrates how 'given' import statements work in Scala 3. languages: [zh-cn] -num: 62 +num: 63 previous-page: ca-context-bounds next-page: ca-type-classes scala3: true diff --git a/_overviews/scala3-book/ca-implicit-conversions.md b/_overviews/scala3-book/ca-implicit-conversions.md index 2318323b95..16e9dec53a 100644 --- a/_overviews/scala3-book/ca-implicit-conversions.md +++ b/_overviews/scala3-book/ca-implicit-conversions.md @@ -3,7 +3,7 @@ title: Implicit Conversions type: section description: This page demonstrates how to implement Implicit Conversions in Scala. languages: [zh-cn] -num: 65 +num: 66 previous-page: ca-multiversal-equality next-page: ca-summary --- diff --git a/_overviews/scala3-book/ca-multiversal-equality.md b/_overviews/scala3-book/ca-multiversal-equality.md index 2e3308d25b..be63a600a3 100644 --- a/_overviews/scala3-book/ca-multiversal-equality.md +++ b/_overviews/scala3-book/ca-multiversal-equality.md @@ -3,7 +3,7 @@ title: Multiversal Equality type: section description: This page demonstrates how to implement Multiversal Equality in Scala 3. languages: [zh-cn] -num: 64 +num: 65 previous-page: ca-type-classes next-page: ca-implicit-conversions scala3: true diff --git a/_overviews/scala3-book/ca-summary.md b/_overviews/scala3-book/ca-summary.md index e3f3da3cad..2a9d281211 100644 --- a/_overviews/scala3-book/ca-summary.md +++ b/_overviews/scala3-book/ca-summary.md @@ -3,7 +3,7 @@ title: Summary type: section description: This page provides a summary of the Contextual Abstractions lessons. languages: [zh-cn] -num: 66 +num: 67 previous-page: ca-implicit-conversions next-page: concurrency --- diff --git a/_overviews/scala3-book/ca-type-classes.md b/_overviews/scala3-book/ca-type-classes.md index d79680a8be..36ae7634cf 100644 --- a/_overviews/scala3-book/ca-type-classes.md +++ b/_overviews/scala3-book/ca-type-classes.md @@ -3,7 +3,7 @@ title: Type Classes type: section description: This page demonstrates how to create and use type classes. languages: [zh-cn] -num: 63 +num: 64 previous-page: ca-given-imports next-page: ca-multiversal-equality redirect_from: /scala3/book/types-type-classes.html diff --git a/_overviews/scala3-book/collections-classes.md b/_overviews/scala3-book/collections-classes.md index c68bc9e035..8a91c05076 100644 --- a/_overviews/scala3-book/collections-classes.md +++ b/_overviews/scala3-book/collections-classes.md @@ -3,7 +3,7 @@ title: Collections Types type: section description: This page introduces the common Scala 3 collections types and some of their methods. languages: [ru, zh-cn] -num: 37 +num: 38 previous-page: collections-intro next-page: collections-methods --- diff --git a/_overviews/scala3-book/collections-intro.md b/_overviews/scala3-book/collections-intro.md index befedef0e6..9d99900c07 100644 --- a/_overviews/scala3-book/collections-intro.md +++ b/_overviews/scala3-book/collections-intro.md @@ -3,7 +3,7 @@ title: Scala Collections type: chapter description: This page provides and introduction to the common collections classes and their methods in Scala 3. languages: [ru, zh-cn] -num: 36 +num: 37 previous-page: packaging-imports next-page: collections-classes --- diff --git a/_overviews/scala3-book/collections-methods.md b/_overviews/scala3-book/collections-methods.md index f165a2c0e9..c805aac639 100644 --- a/_overviews/scala3-book/collections-methods.md +++ b/_overviews/scala3-book/collections-methods.md @@ -3,7 +3,7 @@ title: Collections Methods type: section description: This page demonstrates the common methods on the Scala 3 collections classes. languages: [ru, zh-cn] -num: 38 +num: 39 previous-page: collections-classes next-page: collections-summary --- diff --git a/_overviews/scala3-book/collections-summary.md b/_overviews/scala3-book/collections-summary.md index c8ac5512fa..0112990df4 100644 --- a/_overviews/scala3-book/collections-summary.md +++ b/_overviews/scala3-book/collections-summary.md @@ -3,7 +3,7 @@ title: Summary type: section description: This page provides a summary of the Collections chapter. languages: [ru, zh-cn] -num: 39 +num: 40 previous-page: collections-methods next-page: fp-intro --- diff --git a/_overviews/scala3-book/concurrency.md b/_overviews/scala3-book/concurrency.md index ff2151bd4b..173e0ff72a 100644 --- a/_overviews/scala3-book/concurrency.md +++ b/_overviews/scala3-book/concurrency.md @@ -3,7 +3,7 @@ title: Concurrency type: chapter description: This page discusses how Scala concurrency works, with an emphasis on Scala Futures. languages: [zh-cn] -num: 67 +num: 68 previous-page: ca-summary next-page: scala-tools --- diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index 198a4955d2..fe94b30dc1 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -3,8 +3,8 @@ title: Control Structures type: chapter description: This page provides an introduction to Scala's control structures, including if/then/else, 'for' loops, 'for' expressions, 'match' expressions, try/catch/finally, and 'while' loops. languages: [ru, zh-cn] -num: 18 -previous-page: first-look-at-types +num: 19 +previous-page: string-interpolation next-page: domain-modeling-intro --- diff --git a/_overviews/scala3-book/domain-modeling-fp.md b/_overviews/scala3-book/domain-modeling-fp.md index f8ab2fb571..ce72aca425 100644 --- a/_overviews/scala3-book/domain-modeling-fp.md +++ b/_overviews/scala3-book/domain-modeling-fp.md @@ -3,7 +3,7 @@ title: FP Modeling type: section description: This chapter provides an introduction to FP domain modeling with Scala 3. languages: [ru, zh-cn] -num: 22 +num: 23 previous-page: domain-modeling-oop next-page: methods-intro --- diff --git a/_overviews/scala3-book/domain-modeling-intro.md b/_overviews/scala3-book/domain-modeling-intro.md index 578cf001df..fada05d5f3 100644 --- a/_overviews/scala3-book/domain-modeling-intro.md +++ b/_overviews/scala3-book/domain-modeling-intro.md @@ -3,7 +3,7 @@ title: Domain Modeling type: chapter description: This chapter provides an introduction to domain modeling in Scala 3. languages: [ru, zh-cn] -num: 19 +num: 20 previous-page: control-structures next-page: domain-modeling-tools --- diff --git a/_overviews/scala3-book/domain-modeling-oop.md b/_overviews/scala3-book/domain-modeling-oop.md index 8a55131a20..948504139e 100644 --- a/_overviews/scala3-book/domain-modeling-oop.md +++ b/_overviews/scala3-book/domain-modeling-oop.md @@ -3,7 +3,7 @@ title: OOP Modeling type: section description: This chapter provides an introduction to OOP domain modeling with Scala 3. languages: [ru, zh-cn] -num: 21 +num: 22 previous-page: domain-modeling-tools next-page: domain-modeling-fp --- diff --git a/_overviews/scala3-book/domain-modeling-tools.md b/_overviews/scala3-book/domain-modeling-tools.md index df1a7a6fc8..9b6901504f 100644 --- a/_overviews/scala3-book/domain-modeling-tools.md +++ b/_overviews/scala3-book/domain-modeling-tools.md @@ -3,7 +3,7 @@ title: Tools type: section description: This chapter provides an introduction to the available domain modeling tools in Scala 3, including classes, traits, enums, and more. languages: [ru, zh-cn] -num: 20 +num: 21 previous-page: domain-modeling-intro next-page: domain-modeling-oop --- diff --git a/_overviews/scala3-book/first-look-at-types.md b/_overviews/scala3-book/first-look-at-types.md index 1a795c8922..5cdb32e57f 100644 --- a/_overviews/scala3-book/first-look-at-types.md +++ b/_overviews/scala3-book/first-look-at-types.md @@ -5,7 +5,7 @@ description: This page provides a brief introduction to Scala's built-in data ty languages: [ru, zh-cn] num: 17 previous-page: taste-summary -next-page: control-structures +next-page: string-interpolation --- @@ -21,8 +21,7 @@ The diagram below illustrates a subset of the type hierarchy. `Any` is the supertype of all types, also called the **top type**. It defines certain universal methods such as `equals`, `hashCode`, and `toString`. -The top-type `Any` has a subtype [`Matchable`][matchable], which is used to mark all types that we can perform pattern matching on. -It is important to guarantee a property call _"parametricity"_. +The top-type `Any` has a subtype [`Matchable`][matchable], which is used to mark all types that we can perform pattern matching on. It is important to guarantee a property call _"parametricity"_. We will not go into details here, but in summary, it means that we cannot pattern match on values of type `Any`, but only on values that are a subtype of `Matchable`. The [reference documentation][matchable] contains more information about `Matchable`. @@ -168,89 +167,10 @@ Those data types and their ranges are: | Char | 16-bit unsigned Unicode character (0 to 2^16-1, inclusive)<br/>0 to 65,535 | | String | a sequence of `Char` | -## `BigInt` and `BigDecimal` - -When you need really large numbers, use the `BigInt` and `BigDecimal` types: - -{% tabs type-bigint %} -{% tab 'Scala 2 and 3' for=type-bigint %} -```scala -val a = BigInt(1_234_567_890_987_654_321L) -val b = BigDecimal(123_456.789) -``` -{% endtab %} -{% endtabs %} - -Where `Double` and `Float` are approximate decimal numbers, `BigDecimal` is used for precise arithmetic, such as when working with currency. - -A great thing about `BigInt` and `BigDecimal` is that they support all the operators you’re used to using with numeric types: - -{% tabs type-bigint2 %} -{% tab 'Scala 2 and 3' for=type-bigint2 %} -```scala -val b = BigInt(1234567890) // scala.math.BigInt = 1234567890 -val c = b + b // scala.math.BigInt = 2469135780 -val d = b * b // scala.math.BigInt = 1524157875019052100 -``` -{% endtab %} -{% endtabs %} - -## Two notes about strings - -Scala strings are similar to Java strings, but they have two great additional features: - -- They support string interpolation -- It’s easy to create multiline strings - -### String interpolation - -String interpolation provides a very readable way to use variables inside strings. -For instance, given these three variables: - -{% tabs string-inside1 %} -{% tab 'Scala 2 and 3' for=string-inside1 %} -```scala -val firstName = "John" -val mi = 'C' -val lastName = "Doe" -``` -{% endtab %} -{% endtabs %} - -You can combine those variables in a string like this: - -{% tabs string-inside2 %} -{% tab 'Scala 2 and 3' for=string-inside2 %} -```scala -println(s"Name: $firstName $mi $lastName") // "Name: John C Doe" -``` -{% endtab %} -{% endtabs %} - -Just precede the string with the letter `s`, and then put a `$` symbol before your variable names inside the string. - -To enclose potentially larger expressions inside a string, put them in curly braces: - -{% tabs string-inside3 %} -{% tab 'Scala 2 and 3' for=string-inside3 %} -```scala -println(s"2 + 2 = ${2 + 2}") // prints "2 + 2 = 4" -val x = -1 -println(s"x.abs = ${x.abs}") // prints "x.abs = 1" -``` -{% endtab %} -{% endtabs %} - -#### Other interpolators +## Strings -The `s` that you place before the string is just one possible interpolator. -If you use an `f` instead of an `s`, you can use `printf`-style formatting syntax in the string. -Furthermore, a string interpolator is a just special method, and it is possible to define your own. -For instance, some database libraries define the very powerful `sql` interpolator. - -### Multiline strings - -Multiline strings are created by including the string inside three double-quotes: +Scala strings are similar to Java strings though unlike Java (at least before Java 15), +it's easy to create multiline strings with triple quotes: {% tabs string-mlines1 %} {% tab 'Scala 2 and 3' for=string-mlines1 %} @@ -298,6 +218,36 @@ programming in a typed setting." {% endtab %} {% endtabs %} +Scala strings also support powerful string interpolation methods, which we'll talk about +in the [next chapter][string-interpolation]. + +## `BigInt` and `BigDecimal` + +When you need really large numbers, use the `BigInt` and `BigDecimal` types: + +{% tabs type-bigint %} +{% tab 'Scala 2 and 3' for=type-bigint %} +```scala +val a = BigInt(1_234_567_890_987_654_321L) +val b = BigDecimal(123_456.789) +``` +{% endtab %} +{% endtabs %} + +Where `Double` and `Float` are approximate decimal numbers, `BigDecimal` is used for precise arithmetic, such as when working with currency. + +A great thing about `BigInt` and `BigDecimal` is that they support all the operators you’re used to using with numeric types: + +{% tabs type-bigint2 %} +{% tab 'Scala 2 and 3' for=type-bigint2 %} +```scala +val b = BigInt(1234567890) // scala.math.BigInt = 1234567890 +val c = b + b // scala.math.BigInt = 2469135780 +val d = b * b // scala.math.BigInt = 1524157875019052100 +``` +{% endtab %} +{% endtabs %} + ## Type casting Value types can be cast in the following way: @@ -347,7 +297,7 @@ Alternatives to `null` are discussed in the [Functional Programming chapter][fp] [reference]: {{ site.scala3ref }}/overview.html [matchable]: {{ site.scala3ref }}/other-new-features/matchable.html -[interpolation]: {% link _overviews/core/string-interpolation.md %} [fp]: {% link _overviews/scala3-book/fp-intro.md %} +[string-interpolation]: {% link _overviews/scala3-book/string-interpolation.md %} [option-api]: https://scala-lang.org/api/3.x/scala/Option.html [safe-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html diff --git a/_overviews/scala3-book/fp-functional-error-handling.md b/_overviews/scala3-book/fp-functional-error-handling.md index 829845eaf8..e22fc2b4bb 100644 --- a/_overviews/scala3-book/fp-functional-error-handling.md +++ b/_overviews/scala3-book/fp-functional-error-handling.md @@ -3,7 +3,7 @@ title: Functional Error Handling type: section description: This section provides an introduction to functional error handling in Scala 3. languages: [ru, zh-cn] -num: 45 +num: 46 previous-page: fp-functions-are-values next-page: fp-summary --- diff --git a/_overviews/scala3-book/fp-functions-are-values.md b/_overviews/scala3-book/fp-functions-are-values.md index 48f7e4ca3a..e656d3c9f9 100644 --- a/_overviews/scala3-book/fp-functions-are-values.md +++ b/_overviews/scala3-book/fp-functions-are-values.md @@ -3,7 +3,7 @@ title: Functions Are Values type: section description: This section looks at the use of functions as values in functional programming. languages: [ru, zh-cn] -num: 44 +num: 45 previous-page: fp-pure-functions next-page: fp-functional-error-handling --- diff --git a/_overviews/scala3-book/fp-immutable-values.md b/_overviews/scala3-book/fp-immutable-values.md index 413d2d0495..2226ceac95 100644 --- a/_overviews/scala3-book/fp-immutable-values.md +++ b/_overviews/scala3-book/fp-immutable-values.md @@ -3,7 +3,7 @@ title: Immutable Values type: section description: This section looks at the use of immutable values in functional programming. languages: [ru, zh-cn] -num: 42 +num: 43 previous-page: fp-what-is-fp next-page: fp-pure-functions --- diff --git a/_overviews/scala3-book/fp-intro.md b/_overviews/scala3-book/fp-intro.md index 7d6e6f4114..d99ec1d0e8 100644 --- a/_overviews/scala3-book/fp-intro.md +++ b/_overviews/scala3-book/fp-intro.md @@ -3,7 +3,7 @@ title: Functional Programming type: chapter description: This chapter provides an introduction to functional programming in Scala 3. languages: [ru, zh-cn] -num: 40 +num: 41 previous-page: collections-summary next-page: fp-what-is-fp --- diff --git a/_overviews/scala3-book/fp-pure-functions.md b/_overviews/scala3-book/fp-pure-functions.md index 754d6f46a5..641eee59ce 100644 --- a/_overviews/scala3-book/fp-pure-functions.md +++ b/_overviews/scala3-book/fp-pure-functions.md @@ -3,7 +3,7 @@ title: Pure Functions type: section description: This section looks at the use of pure functions in functional programming. languages: [ru, zh-cn] -num: 43 +num: 44 previous-page: fp-immutable-values next-page: fp-functions-are-values --- diff --git a/_overviews/scala3-book/fp-summary.md b/_overviews/scala3-book/fp-summary.md index 55233f851c..7695293e9d 100644 --- a/_overviews/scala3-book/fp-summary.md +++ b/_overviews/scala3-book/fp-summary.md @@ -3,7 +3,7 @@ title: Summary type: section description: This section summarizes the previous functional programming sections. languages: [ru, zh-cn] -num: 46 +num: 47 previous-page: fp-functional-error-handling next-page: types-introduction --- diff --git a/_overviews/scala3-book/fp-what-is-fp.md b/_overviews/scala3-book/fp-what-is-fp.md index 1e37279ae0..2eca848e60 100644 --- a/_overviews/scala3-book/fp-what-is-fp.md +++ b/_overviews/scala3-book/fp-what-is-fp.md @@ -3,7 +3,7 @@ title: What is Functional Programming? type: section description: This section provides an answer to the question, what is functional programming? languages: [ru, zh-cn] -num: 41 +num: 42 previous-page: fp-intro next-page: fp-immutable-values --- diff --git a/_overviews/scala3-book/fun-anonymous-functions.md b/_overviews/scala3-book/fun-anonymous-functions.md index faf32eb76d..428186b968 100644 --- a/_overviews/scala3-book/fun-anonymous-functions.md +++ b/_overviews/scala3-book/fun-anonymous-functions.md @@ -3,7 +3,7 @@ title: Anonymous Functions type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. languages: [ru, zh-cn] -num: 28 +num: 29 previous-page: fun-intro next-page: fun-function-variables --- diff --git a/_overviews/scala3-book/fun-eta-expansion.md b/_overviews/scala3-book/fun-eta-expansion.md index dcfc76acf5..e45f48cc68 100644 --- a/_overviews/scala3-book/fun-eta-expansion.md +++ b/_overviews/scala3-book/fun-eta-expansion.md @@ -3,7 +3,7 @@ title: Eta Expansion type: section description: This page discusses Eta Expansion, the Scala technology that automatically and transparently converts methods into functions. languages: [ru, zh-cn] -num: 30 +num: 31 previous-page: fun-function-variables next-page: fun-hofs --- diff --git a/_overviews/scala3-book/fun-function-variables.md b/_overviews/scala3-book/fun-function-variables.md index 70805a5240..04c612b7b7 100644 --- a/_overviews/scala3-book/fun-function-variables.md +++ b/_overviews/scala3-book/fun-function-variables.md @@ -3,7 +3,7 @@ title: Function Variables type: section description: This page shows how to use function variables in Scala. languages: [ru, zh-cn] -num: 29 +num: 30 previous-page: fun-anonymous-functions next-page: fun-eta-expansion --- diff --git a/_overviews/scala3-book/fun-hofs.md b/_overviews/scala3-book/fun-hofs.md index 45d764dee4..013f47a560 100644 --- a/_overviews/scala3-book/fun-hofs.md +++ b/_overviews/scala3-book/fun-hofs.md @@ -3,7 +3,7 @@ title: Higher-Order Functions type: section description: This page demonstrates how to create and use higher-order functions in Scala. languages: [ru, zh-cn] -num: 31 +num: 32 previous-page: fun-eta-expansion next-page: fun-write-map-function --- diff --git a/_overviews/scala3-book/fun-intro.md b/_overviews/scala3-book/fun-intro.md index aa4345a188..a3c82e51c7 100644 --- a/_overviews/scala3-book/fun-intro.md +++ b/_overviews/scala3-book/fun-intro.md @@ -3,7 +3,7 @@ title: Functions type: chapter description: This chapter looks at all topics related to functions in Scala 3. languages: [ru, zh-cn] -num: 27 +num: 28 previous-page: methods-summary next-page: fun-anonymous-functions --- diff --git a/_overviews/scala3-book/fun-summary.md b/_overviews/scala3-book/fun-summary.md index 99089f5dec..ffd7bb7bd7 100644 --- a/_overviews/scala3-book/fun-summary.md +++ b/_overviews/scala3-book/fun-summary.md @@ -3,7 +3,7 @@ title: Summary type: section description: This page provides a summary of the previous 'Functions' sections. languages: [ru, zh-cn] -num: 34 +num: 35 previous-page: fun-write-method-returns-function next-page: packaging-imports --- diff --git a/_overviews/scala3-book/fun-write-map-function.md b/_overviews/scala3-book/fun-write-map-function.md index c7c9234760..02ee9abf75 100644 --- a/_overviews/scala3-book/fun-write-map-function.md +++ b/_overviews/scala3-book/fun-write-map-function.md @@ -3,7 +3,7 @@ title: Write Your Own map Method type: section description: This page demonstrates how to create and use higher-order functions in Scala. languages: [ru, zh-cn] -num: 32 +num: 33 previous-page: fun-hofs next-page: fun-write-method-returns-function --- diff --git a/_overviews/scala3-book/fun-write-method-returns-function.md b/_overviews/scala3-book/fun-write-method-returns-function.md index 79795089ea..1e6fc8b304 100644 --- a/_overviews/scala3-book/fun-write-method-returns-function.md +++ b/_overviews/scala3-book/fun-write-method-returns-function.md @@ -3,7 +3,7 @@ title: Creating a Method That Returns a Function type: section description: This page demonstrates how to create and use higher-order functions in Scala. languages: [ru, zh-cn] -num: 33 +num: 34 previous-page: fun-write-map-function next-page: fun-summary --- diff --git a/_overviews/scala3-book/interacting-with-java.md b/_overviews/scala3-book/interacting-with-java.md index 18f5667446..06a5a8fa62 100644 --- a/_overviews/scala3-book/interacting-with-java.md +++ b/_overviews/scala3-book/interacting-with-java.md @@ -3,7 +3,7 @@ title: Interacting with Java type: chapter description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. languages: [zh-cn] -num: 71 +num: 72 previous-page: tools-worksheets next-page: scala-for-java-devs --- diff --git a/_overviews/scala3-book/methods-intro.md b/_overviews/scala3-book/methods-intro.md index 2bf6be1247..59e91c3c6c 100644 --- a/_overviews/scala3-book/methods-intro.md +++ b/_overviews/scala3-book/methods-intro.md @@ -3,7 +3,7 @@ title: Methods type: chapter description: This section introduces methods in Scala 3. languages: [ru, zh-cn] -num: 23 +num: 24 previous-page: domain-modeling-fp next-page: methods-most --- diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index 407c124d2c..cc26716f16 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -3,7 +3,7 @@ title: Main Methods in Scala 3 type: section description: This page describes how 'main' methods and the '@main' annotation work in Scala 3. languages: [ru, zh-cn] -num: 25 +num: 26 previous-page: methods-most next-page: methods-summary --- diff --git a/_overviews/scala3-book/methods-most.md b/_overviews/scala3-book/methods-most.md index 1cadaf3ebe..8af9552e6a 100644 --- a/_overviews/scala3-book/methods-most.md +++ b/_overviews/scala3-book/methods-most.md @@ -3,7 +3,7 @@ title: Method Features type: section description: This section introduces Scala 3 methods, including main methods, extension methods, and more. languages: [ru, zh-cn] -num: 24 +num: 25 previous-page: methods-intro next-page: methods-main-methods --- diff --git a/_overviews/scala3-book/methods-summary.md b/_overviews/scala3-book/methods-summary.md index 54abeef761..8d36108654 100644 --- a/_overviews/scala3-book/methods-summary.md +++ b/_overviews/scala3-book/methods-summary.md @@ -3,7 +3,7 @@ title: Summary type: section description: This section summarizes the previous sections on Scala 3 methods. languages: [ru, zh-cn] -num: 26 +num: 27 previous-page: methods-main-methods next-page: fun-intro --- diff --git a/_overviews/scala3-book/packaging-imports.md b/_overviews/scala3-book/packaging-imports.md index 562fc69a46..94126b7f32 100644 --- a/_overviews/scala3-book/packaging-imports.md +++ b/_overviews/scala3-book/packaging-imports.md @@ -3,7 +3,7 @@ title: Packaging and Imports type: chapter description: A discussion of using packages and imports to organize your code, build related modules of code, control scope, and help prevent namespace collisions. languages: [ru, zh-cn] -num: 35 +num: 36 previous-page: fun-summary next-page: collections-intro --- diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index 78d86b289b..4a1db9de24 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -3,7 +3,7 @@ title: Scala for Java Developers type: chapter description: This page is for Java developers who are interested in learning about Scala 3. languages: [zh-cn] -num: 72 +num: 73 previous-page: interacting-with-java next-page: scala-for-javascript-devs --- diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index f2ecd821e4..213b1bada7 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -3,7 +3,7 @@ title: Scala for JavaScript Developers type: chapter description: This chapter provides an introduction to Scala 3 for JavaScript developers languages: [zh-cn] -num: 73 +num: 74 previous-page: scala-for-java-devs next-page: scala-for-python-devs --- diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index e10b43ebdb..ddaa08584c 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -3,7 +3,7 @@ title: Scala for Python Developers type: chapter description: This page is for Python developers who are interested in learning about Scala 3. languages: [zh-cn] -num: 74 +num: 75 previous-page: scala-for-javascript-devs next-page: where-next --- diff --git a/_overviews/scala3-book/scala-tools.md b/_overviews/scala3-book/scala-tools.md index 230f7b74ae..1b6badd809 100644 --- a/_overviews/scala3-book/scala-tools.md +++ b/_overviews/scala3-book/scala-tools.md @@ -3,7 +3,7 @@ title: Scala Tools type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. languages: [zh-cn] -num: 68 +num: 69 previous-page: concurrency next-page: tools-sbt --- diff --git a/_overviews/scala3-book/string-interpolation.md b/_overviews/scala3-book/string-interpolation.md new file mode 100644 index 0000000000..7cfdc52369 --- /dev/null +++ b/_overviews/scala3-book/string-interpolation.md @@ -0,0 +1,358 @@ +--- +title: String Interpolation +type: chapter +description: This page provides more information about creating strings and using string interpolation. +languages: [] +num: 18 +previous-page: first-look-at-types +next-page: control-structures +redirect_from: + - /overviews/core/string-interpolation.html +--- + +## Introduction + +String interpolation provides a way to use variables inside strings. +For instance: + +{% tabs example-1 %} +{% tab 'Scala 2 and 3' for=example-1 %} +```scala +val name = "James" +val age = 30 +println(s"$name is $age years old") // "James is 30 years old" +``` +{% endtab %} +{% endtabs %} + +Using string interpolation consists of putting an `s` in front of your string +quotes, and prefixing any variable names with a `$` symbol. + +### Other interpolators + +The `s` that you place before the string is just one possible interpolator that Scala +provides. + +Scala provides three string interpolation methods out of the box: `s`, `f` and `raw`. +Further, a string interpolator is a just special method so it is possible to define your +own. For instance, some database libraries define a `sql` interpolator that returns a +database query. + +## The `s` Interpolator (`s`-Strings) + +Prepending `s` to any string literal allows the usage of variables directly in the string. You've already seen an example here: + +{% tabs example-2 %} +{% tab 'Scala 2 and 3' for=example-2 %} +```scala +val name = "James" +val age = 30 +println(s"$name is $age years old") // "James is 30 years old" +``` +{% endtab %} +{% endtabs %} + +Here, the `$name` and `$age` placeholders in the string are replaced by the results of +calling `name.toString` and `age.toString`, respectively. The `s`-String will have +access to all variables that are currently in scope. + +While it may seem obvious, it's important to note here that string interpolation will _not_ happen in normal string literals: + +{% tabs example-3 %} +{% tab 'Scala 2 and 3' for=example-3 %} +```scala +val name = "James" +val age = 30 +println("$name is $age years old") // "$name is $age years old" +``` +{% endtab %} +{% endtabs %} + +String interpolators can also take arbitrary expressions. For example: + +{% tabs example-4 %} +{% tab 'Scala 2 and 3' for=example-4 %} +```scala +println(s"2 + 2 = ${2 + 2}") // "2 + 2 = 4" +val x = -1 +println(s"x.abs = ${x.abs}") // "x.abs = 1" +``` +{% endtab %} +{% endtabs %} + +Any arbitrary expression can be embedded in `${}`. + +For some special characters, it is necessary to escape them when embedded within a string. +To represent an actual dollar sign you can double it `$$`, like here: + +{% tabs example-5 %} +{% tab 'Scala 2 and 3' for=example-5 %} +```scala +println(s"New offers starting at $$14.99") // "New offers starting at $14.99" +``` +{% endtab %} +{% endtabs %} + +Double quotes also need to be escaped. This can be done by using triple quotes as shown: + +{% tabs example-6 %} +{% tab 'Scala 2 and 3' for=example-6 %} +```scala +println(s"""{"name":"James"}""") // `{"name":"James"}` +``` +{% endtab %} +{% endtabs %} + +Finally, all multi-line string literals can also be interpolated + +{% tabs example-7 %} +{% tab 'Scala 2 and 3' for=example-7 %} +```scala +println(s"""name: "$name", + |age: $age""".stripMargin) +``` + +This will print as follows: + +``` +name: "James" +age: 30 +``` +{% endtab %} +{% endtabs %} + +## The `f` Interpolator (`f`-Strings) + +Prepending `f` to any string literal allows the creation of simple formatted strings, similar to `printf` in other languages. When using the `f` +interpolator, all variable references should be followed by a `printf`-style format string, like `%d`. Let's look at an example: + +{% tabs example-8 %} +{% tab 'Scala 2 and 3' for=example-8 %} +```scala +val height = 1.9d +val name = "James" +println(f"$name%s is $height%2.2f meters tall") // "James is 1.90 meters tall" +``` +{% endtab %} +{% endtabs %} + +The `f` interpolator is typesafe. If you try to pass a format string that only works for integers but pass a double, the compiler will issue an +error. For example: + +{% tabs f-interpolator-error class=tabs-scala-version %} + +{% tab 'Scala 2' for=f-interpolator-error %} +```scala +val height: Double = 1.9d + +scala> f"$height%4d" +<console>:9: error: type mismatch; + found : Double + required: Int + f"$height%4d" + ^ +``` +{% endtab %} + +{% tab 'Scala 3' for=f-interpolator-error %} +```scala +val height: Double = 1.9d + +scala> f"$height%4d" +-- Error: ---------------------------------------------------------------------- +1 |f"$height%4d" + | ^^^^^^ + | Found: (height : Double), Required: Int, Long, Byte, Short, BigInt +1 error found + +``` +{% endtab %} +{% endtabs %} + +The `f` interpolator makes use of the string format utilities available from Java. The formats allowed after the `%` character are outlined in the +[Formatter javadoc][java-format-docs]. If there is no `%` character after a variable +definition a formatter of `%s` (`String`) is assumed. + +Finally, as in Java, use `%%` to get a literal `%` character in the output string: + +{% tabs literal-percent %} +{% tab 'Scala 2 and 3' for=literal-percent %} +```scala +println(f"3/19 is less than 20%%") // "3/19 is less than 20%" +``` +{% endtab %} +{% endtabs %} + +### The `raw` Interpolator + +The raw interpolator is similar to the `s` interpolator except that it performs no escaping of literals within the string. Here's an example processed string: + +{% tabs example-9 %} +{% tab 'Scala 2 and 3' for=example-9 %} +```scala +scala> s"a\nb" +res0: String = +a +b +``` +{% endtab %} +{% endtabs %} + +Here the `s` string interpolator replaced the characters `\n` with a return character. The `raw` interpolator will not do that. + +{% tabs example-10 %} +{% tab 'Scala 2 and 3' for=example-10 %} +```scala +scala> raw"a\nb" +res1: String = a\nb +``` +{% endtab %} +{% endtabs %} + +The raw interpolator is useful when you want to avoid having expressions like `\n` turn into a return character. + +In addition to the three default string interpolators, users can define their own. + +## Advanced Usage + +The literal `s"Hi $name"` is parsed by Scala as a _processed_ string literal. +This means that the compiler does some additional work to this literal. The specifics +of processed strings and string interpolation are described in [SIP-11][sip-11], but +here's a quick example to help illustrate how they work. + +### Custom Interpolators + +In Scala, all processed string literals are simple code transformations. Anytime the compiler encounters a processed string literal of the form: + +{% tabs example-11 %} +{% tab 'Scala 2 and 3' for=example-11 %} +```scala +id"string content" +``` +{% endtab %} +{% endtabs %} + +it transforms it into a method call (`id`) on an instance of [StringContext](https://www.scala-lang.org/api/current/scala/StringContext.html). +This method can also be available on implicit scope. +To define our own string interpolation, we need to create an implicit class (Scala 2) or an `extension` method (Scala 3) that adds a new method to `StringContext`. + +As a trivial example, let's assume we have a simple `Point` class and want to create a custom interpolator that turns `p"a,b"` into a `Point` object. + +{% tabs custom-interpolator-1 %} +{% tab 'Scala 2 and 3' for=custom-interpolator-1 %} +```scala +case class Point(x: Double, y: Double) + +val pt = p"1,-2" // Point(1.0,-2.0) +``` +{% endtab %} +{% endtabs %} + +We'd create a custom `p`-interpolator by first implementing a `StringContext` extension +with something like: + +{% tabs custom-interpolator-2 class=tabs-scala-version %} + +{% tab 'Scala 2' for=custom-interpolator-2 %} +```scala +implicit class PointHelper(val sc: StringContext) extends AnyVal { + def p(args: Any*): Point = ??? +} +``` + +**Note:** It's important to extend `AnyVal` in Scala 2.x to prevent runtime instantiation on each interpolation. See the [value class]({% link _overviews/core/value-classes.md %}) documentation for more. + +{% endtab %} + +{% tab 'Scala 3' for=custom-interpolator-2 %} +```scala +extension (sc: StringContext) + def p(args: Any*): Point = ??? +``` +{% endtab %} + +{% endtabs %} + +Once this extension is in scope and the Scala compiler encounters `p"some string"`, it +will process `some string` to turn it into String tokens and expression arguments for +each embedded variable in the string. + +For example, `p"1, $someVar"` would turn into: + +{% tabs extension-desugaring class=tabs-scala-version %} + +{% tab 'Scala 2' for=extension-desugaring %} +```scala +new StringContext("1, ", "").p(someVar) +``` + +The implicit class is then used to rewrite it to the following: + +```scala +new PointHelper(new StringContext("1, ", "")).p(someVar) +``` +{% endtab %} + +{% tab 'Scala 3' for=extension-desugaring %} +```scala +StringContext("1, ","").p(someVar) +``` +{% endtab %} + +{% endtabs %} + +As a result, each of the fragments of the processed String are exposed in the +`StringContext.parts` member, while any expressions values in the string are passed in +to the method's `args` parameter. + +### Example Implementation + +A naive implementation of our Point interpolator method might look something like below, +though a more sophisticated method may choose to have more precise control over the +processing of the string `parts` and expression `args` instead of reusing the +`s`-Interpolator. + +{% tabs naive-implementation class=tabs-scala-version %} + +{% tab 'Scala 2' for=naive-implementation %} +```scala +implicit class PointHelper(val sc: StringContext) extends AnyVal { + def p(args: Double*): Point = { + // reuse the `s`-interpolator and then split on ',' + val pts = sc.s(args: _*).split(",", 2).map { _.toDoubleOption.getOrElse(0.0) } + Point(pts(0), pts(1)) + } +} + +val x=12.0 + +p"1, -2" // Point(1.0, -2.0) +p"${x/5}, $x" // Point(2.4, 12.0) +``` +{% endtab %} + +{% tab 'Scala 3' for=naive-implementation %} +```scala +extension (sc: StringContext) + def p(args: Double*): Point = { + // reuse the `s`-interpolator and then split on ',' + val pts = sc.s(args: _*).split(",", 2).map { _.toDoubleOption.getOrElse(0.0) } + Point(pts(0), pts(1)) + } + +val x=12.0 + +p"1, -2" // Point(1.0, -2.0) +p"${x/5}, $x" // Point(2.4, 12.0) +``` +{% endtab %} +{% endtabs %} + +While string interpolators were originally used to create some form of a String, the use +of custom interpolators as above can allow for powerful syntactic shorthand, and the +community has already made swift use of this syntax for things like ANSI terminal color +expansion, executing SQL queries, magic `$"identifier"` representations, and many others. + +[java-format-docs]: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Formatter.html#detail +[value-class]: {% link _overviews/core/value-classes.md %} +[sip-11]: {% link _sips/sips/string-interpolation.md %} diff --git a/_overviews/scala3-book/tools-sbt.md b/_overviews/scala3-book/tools-sbt.md index 6fd9897a29..8735cbce68 100644 --- a/_overviews/scala3-book/tools-sbt.md +++ b/_overviews/scala3-book/tools-sbt.md @@ -3,7 +3,7 @@ title: Building and Testing Scala Projects with sbt type: section description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. languages: [zh-cn] -num: 69 +num: 70 previous-page: scala-tools next-page: tools-worksheets --- diff --git a/_overviews/scala3-book/tools-worksheets.md b/_overviews/scala3-book/tools-worksheets.md index 92f7fd66ca..5c8dacf3e5 100644 --- a/_overviews/scala3-book/tools-worksheets.md +++ b/_overviews/scala3-book/tools-worksheets.md @@ -3,7 +3,7 @@ title: Worksheets type: section description: This section looks at worksheets, an alternative to Scala projects. languages: [zh-cn] -num: 70 +num: 71 previous-page: tools-sbt next-page: interacting-with-java --- diff --git a/_overviews/scala3-book/types-adts-gadts.md b/_overviews/scala3-book/types-adts-gadts.md index 5cb2d0e550..a4f31e0040 100644 --- a/_overviews/scala3-book/types-adts-gadts.md +++ b/_overviews/scala3-book/types-adts-gadts.md @@ -3,7 +3,7 @@ title: Algebraic Data Types type: section description: This section introduces and demonstrates algebraic data types (ADTs) in Scala 3. languages: [zh-cn] -num: 52 +num: 53 previous-page: types-union next-page: types-variance scala3: true diff --git a/_overviews/scala3-book/types-dependent-function.md b/_overviews/scala3-book/types-dependent-function.md index 1350477fcd..5a74b28dd0 100644 --- a/_overviews/scala3-book/types-dependent-function.md +++ b/_overviews/scala3-book/types-dependent-function.md @@ -3,7 +3,7 @@ title: Dependent Function Types type: section description: This section introduces and demonstrates dependent function types in Scala 3. languages: [zh-cn] -num: 56 +num: 57 previous-page: types-structural next-page: types-others --- diff --git a/_overviews/scala3-book/types-generics.md b/_overviews/scala3-book/types-generics.md index c44c29c9ac..c772ea65a4 100644 --- a/_overviews/scala3-book/types-generics.md +++ b/_overviews/scala3-book/types-generics.md @@ -3,7 +3,7 @@ title: Generics type: section description: This section introduces and demonstrates generics in Scala 3. languages: [ru, zh-cn] -num: 49 +num: 50 previous-page: types-inferred next-page: types-intersection --- diff --git a/_overviews/scala3-book/types-inferred.md b/_overviews/scala3-book/types-inferred.md index 828907d048..50cdb729e1 100644 --- a/_overviews/scala3-book/types-inferred.md +++ b/_overviews/scala3-book/types-inferred.md @@ -3,7 +3,7 @@ title: Inferred Types type: section description: This section introduces and demonstrates inferred types in Scala 3 languages: [ru, zh-cn] -num: 48 +num: 49 previous-page: types-introduction next-page: types-generics --- diff --git a/_overviews/scala3-book/types-intersection.md b/_overviews/scala3-book/types-intersection.md index 66a6f3ec0d..4d3f21aa31 100644 --- a/_overviews/scala3-book/types-intersection.md +++ b/_overviews/scala3-book/types-intersection.md @@ -3,7 +3,7 @@ title: Intersection Types type: section description: This section introduces and demonstrates intersection types in Scala 3. languages: [ru, zh-cn] -num: 50 +num: 51 previous-page: types-generics next-page: types-union --- diff --git a/_overviews/scala3-book/types-introduction.md b/_overviews/scala3-book/types-introduction.md index f5267d7eb2..ef21c8b4f3 100644 --- a/_overviews/scala3-book/types-introduction.md +++ b/_overviews/scala3-book/types-introduction.md @@ -3,7 +3,7 @@ title: Types and the Type System type: chapter description: This chapter provides an introduction to Scala 3 types and the type system. languages: [ru, zh-cn] -num: 47 +num: 48 previous-page: fp-summary next-page: types-inferred --- diff --git a/_overviews/scala3-book/types-opaque-types.md b/_overviews/scala3-book/types-opaque-types.md index cf25539c3f..0bc606d007 100644 --- a/_overviews/scala3-book/types-opaque-types.md +++ b/_overviews/scala3-book/types-opaque-types.md @@ -3,7 +3,7 @@ title: Opaque Types type: section description: This section introduces and demonstrates opaque types in Scala 3. languages: [zh-cn] -num: 54 +num: 55 previous-page: types-variance next-page: types-structural --- diff --git a/_overviews/scala3-book/types-others.md b/_overviews/scala3-book/types-others.md index 30447a4315..3e70eb46f6 100644 --- a/_overviews/scala3-book/types-others.md +++ b/_overviews/scala3-book/types-others.md @@ -3,7 +3,7 @@ title: Other Types type: section description: This section mentions other advanced types in Scala 3. languages: [zh-cn] -num: 57 +num: 58 previous-page: types-dependent-function next-page: ca-contextual-abstractions-intro --- diff --git a/_overviews/scala3-book/types-structural.md b/_overviews/scala3-book/types-structural.md index 8acdbc1725..5dfc73d1af 100644 --- a/_overviews/scala3-book/types-structural.md +++ b/_overviews/scala3-book/types-structural.md @@ -3,7 +3,7 @@ title: Structural Types type: section description: This section introduces and demonstrates structural types in Scala 3. languages: [zh-cn] -num: 55 +num: 56 previous-page: types-opaque-types next-page: types-dependent-function --- diff --git a/_overviews/scala3-book/types-union.md b/_overviews/scala3-book/types-union.md index 50c5919980..b61de27be9 100644 --- a/_overviews/scala3-book/types-union.md +++ b/_overviews/scala3-book/types-union.md @@ -3,7 +3,7 @@ title: Union Types type: section description: This section introduces and demonstrates union types in Scala 3. languages: [ru, zh-cn] -num: 51 +num: 52 previous-page: types-intersection next-page: types-adts-gadts scala3: true diff --git a/_overviews/scala3-book/types-variance.md b/_overviews/scala3-book/types-variance.md index 9fd69a2802..7aae5b5fac 100644 --- a/_overviews/scala3-book/types-variance.md +++ b/_overviews/scala3-book/types-variance.md @@ -3,7 +3,7 @@ title: Variance type: section description: This section introduces and demonstrates variance in Scala 3. languages: [zh-cn] -num: 53 +num: 54 previous-page: types-adts-gadts next-page: types-opaque-types --- diff --git a/_overviews/scala3-book/where-next.md b/_overviews/scala3-book/where-next.md index 41bdf27255..05bdad479a 100644 --- a/_overviews/scala3-book/where-next.md +++ b/_overviews/scala3-book/where-next.md @@ -3,7 +3,7 @@ title: Where To Go Next type: chapter description: Where to go next after reading the Scala Book languages: [zh-cn] -num: 75 +num: 76 previous-page: scala-for-python-devs next-page: --- diff --git a/_ru/scala3/book/first-look-at-types.md b/_ru/scala3/book/first-look-at-types.md index c1bbe20d4b..a0170478f5 100644 --- a/_ru/scala3/book/first-look-at-types.md +++ b/_ru/scala3/book/first-look-at-types.md @@ -15,35 +15,35 @@ next-page: control-structures ## Все значения имеют тип -В Scala все значения имеют тип, включая числовые значения и функции. +В Scala все значения имеют тип, включая числовые значения и функции. На приведенной ниже диаграмме показано подмножество иерархии типов. <a href="{{ site.baseurl }}/resources/images/scala3-book/hierarchy.svg"><img style="width:100%" src="{{ site.baseurl }}/resources/images/scala3-book/hierarchy.svg" alt="Scala 3 Type Hierarchy"></a> ## Иерархия типов Scala -`Any` - это супертип всех типов, также называемый **верхним типом** (**the top type**). +`Any` - это супертип всех типов, также называемый **верхним типом** (**the top type**). Он определяет универсальные методы, такие как `equals`, `hashCode` и `toString`. -У верхнего типа `Any` есть подтип [`Matchable`][matchable], который используется для обозначения всех типов, -для которых возможно выполнить pattern matching (сопоставление с образцом). -Важно гарантировать вызов свойства _“параметричность”_, что вкратце означает, -что мы не можем сопоставлять шаблоны для значений типа `Any`, а только для значений, которые являются подтипом `Matchable`. +У верхнего типа `Any` есть подтип [`Matchable`][matchable], который используется для обозначения всех типов, +для которых возможно выполнить pattern matching (сопоставление с образцом). +Важно гарантировать вызов свойства _“параметричность”_, что вкратце означает, +что мы не можем сопоставлять шаблоны для значений типа `Any`, а только для значений, которые являются подтипом `Matchable`. [Справочная документация][matchable] содержит более подробную информацию о `Matchable`. `Matchable` содержит два важных подтипа: `AnyVal` и `AnyRef`. -*`AnyVal`* представляет типы значений. -Существует несколько предопределенных типов значений, и они non-nullable: -`Double`, `Float`, `Long`, `Int`, `Short`, `Byte`, `Char`, `Unit` и `Boolean`. +*`AnyVal`* представляет типы значений. +Существует несколько предопределенных типов значений, и они non-nullable: +`Double`, `Float`, `Long`, `Int`, `Short`, `Byte`, `Char`, `Unit` и `Boolean`. `Unit` - это тип значения, который не несет никакой значимой информации. Существует ровно один экземпляр `Unit` - `()`. -*`AnyRef`* представляет ссылочные типы. Все типы, не являющиеся значениями, определяются как ссылочные типы. -Каждый пользовательский тип в Scala является подтипом `AnyRef`. +*`AnyRef`* представляет ссылочные типы. Все типы, не являющиеся значениями, определяются как ссылочные типы. +Каждый пользовательский тип в Scala является подтипом `AnyRef`. Если Scala используется в контексте среды выполнения Java, `AnyRef` соответствует `java.lang.Object`. -В языках, основанных на операторах, `void` используется для методов, которые ничего не возвращают. -В Scala для методов, которые не имеют возвращаемого значения, +В языках, основанных на операторах, `void` используется для методов, которые ничего не возвращают. +В Scala для методов, которые не имеют возвращаемого значения, такие как следующий метод, для той же цели используется `Unit`: {% tabs unit %} @@ -54,7 +54,7 @@ def printIt(a: Any): Unit = println(a) {% endtab %} {% endtabs %} -Вот пример, демонстрирующий, что строки, целые числа, символы, логические значения и функции являются экземплярами `Any` +Вот пример, демонстрирующий, что строки, целые числа, символы, логические значения и функции являются экземплярами `Any` и могут обрабатываться так же, как и любой другой объект: {% tabs any %} @@ -73,8 +73,8 @@ list.foreach(element => println(element)) {% endtab %} {% endtabs %} -Код определяет список значений типа `List[Any]`. -Список инициализируется элементами различных типов, но каждый из них является экземпляром `scala.Any`, +Код определяет список значений типа `List[Any]`. +Список инициализируется элементами различных типов, но каждый из них является экземпляром `scala.Any`, поэтому мы можем добавить их в список. Вот вывод программы: @@ -89,7 +89,7 @@ true ## Типы значений в Scala -Как показано выше, числовые типы Scala расширяют `AnyVal`, и все они являются полноценными объектами. +Как показано выше, числовые типы Scala расширяют `AnyVal`, и все они являются полноценными объектами. В этих примерах показано, как объявлять переменные этих числовых типов: {% tabs anyval %} @@ -105,9 +105,9 @@ val f: Float = 3.0 {% endtab %} {% endtabs %} -В первых четырех примерах, если явно не указать тип, то тип числа `1` по умолчанию будет равен `Int`, -поэтому, если нужен один из других типов данных — `Byte`, `Long` или `Short` — необходимо явно объявить эти типы. -Числа с десятичной дробью (например, `2.0`) по умолчанию будут иметь тип `Double`, +В первых четырех примерах, если явно не указать тип, то тип числа `1` по умолчанию будет равен `Int`, +поэтому, если нужен один из других типов данных — `Byte`, `Long` или `Short` — необходимо явно объявить эти типы. +Числа с десятичной дробью (например, `2.0`) по умолчанию будут иметь тип `Double`, поэтому, если необходим `Float`, нужно объявить `Float` явно, как показано в последнем примере. Поскольку `Int` и `Double` являются числовыми типами по умолчанию, их можно создавать без явного объявления типа данных: @@ -121,7 +121,7 @@ val x = 1.0 // по умолчанию Double {% endtab %} {% endtabs %} -Также можно добавить символы `L`, `D`, and `F` (или их эквивалент в нижнем регистре) +Также можно добавить символы `L`, `D`, and `F` (или их эквивалент в нижнем регистре) для того, чтобы задать `Long`, `Double` или `Float` значения: {% tabs type-post %} @@ -145,7 +145,7 @@ val c = 'a' {% endtab %} {% endtabs %} -Как показано, заключайте строки в двойные кавычки или тройные кавычки для многострочных строк, +Как показано, заключайте строки в двойные кавычки или тройные кавычки для многострочных строк, а одиночный символ заключайте в одинарные кавычки. Типы данных и их диапазоны: @@ -176,7 +176,7 @@ val b = BigDecimal(123_456.789) {% endtab %} {% endtabs %} -Где `Double` и `Float` являются приблизительными десятичными числами, +Где `Double` и `Float` являются приблизительными десятичными числами, а `BigDecimal` используется для точной арифметики, например, при работе с валютой. `BigInt` и `BigDecimal` поддерживают все привычные числовые операторы: @@ -200,7 +200,7 @@ val d = b * b // scala.math.BigInt = 1524157875019052100 ### Интерполяция строк -Интерполяция строк обеспечивает очень удобный способ использования переменных внутри строк. +Интерполяция строк обеспечивает очень удобный способ использования переменных внутри строк. Например, учитывая эти три переменные: {% tabs string-inside1 %} @@ -239,9 +239,9 @@ println(s"x.abs = ${x.abs}") // печатает "x.abs = 1" #### Другие интерполяторы -То `s`, что вы помещаете перед строкой, является лишь одним из возможных интерполяторов. -Если вы используете `f` вместо `s`, вы можете использовать `printf` - синтаксис форматирования стиля в строке. -Кроме того, строковый интерполятор — это всего лишь специальный метод, и вы можете определить свой собственный. +То `s`, что вы помещаете перед строкой, является лишь одним из возможных интерполяторов. +Если вы используете `f` вместо `s`, вы можете использовать `printf` - синтаксис форматирования стиля в строке. +Кроме того, строковый интерполятор — это всего лишь специальный метод, и вы можете определить свой собственный. Например, некоторые библиотеки баз данных определяют очень мощный интерполятор `sql`. ### Многострочные строки @@ -314,7 +314,7 @@ val number: Int = face // 9786 {% endtab %} {% endtabs %} -Вы можете привести к типу, только если нет потери информации. +Вы можете привести к типу, только если нет потери информации. В противном случае вам нужно четко указать приведение типов: {% tabs cast2 %} @@ -327,29 +327,29 @@ val z: Long = y // Ошибка {% endtab %} {% endtabs %} -Вы также можете привести ссылочный тип к подтипу. +Вы также можете привести ссылочный тип к подтипу. Это будет рассмотрено в книге позже. ## `Nothing` и `null` -`Nothing` является подтипом всех типов, также называемым **нижним типом** (**the bottom type**). -Нет значения, которое имело бы тип `Nothing`. -Он обычно сигнализирует о прекращении, таком как thrown exception, выходе из программы или бесконечном цикле - +`Nothing` является подтипом всех типов, также называемым **нижним типом** (**the bottom type**). +Нет значения, которое имело бы тип `Nothing`. +Он обычно сигнализирует о прекращении, таком как thrown exception, выходе из программы или бесконечном цикле - т.е. это тип выражения, который не вычисляется до определенного значения, или метод, который нормально не возвращается. -`Null` - это подтип всех ссылочных типов (т.е. любой подтип `AnyRef`). -Он имеет единственное значение, определяемое ключевым словом `null`. -В настоящее время применение `null` считается плохой практикой. -Его следует использовать в основном для взаимодействия с другими языками JVM. -Опция компилятора `opt-in` изменяет статус `Null`, делая все ссылочные типы non-nullable. +`Null` - это подтип всех ссылочных типов (т.е. любой подтип `AnyRef`). +Он имеет единственное значение, определяемое ключевым словом `null`. +В настоящее время применение `null` считается плохой практикой. +Его следует использовать в основном для взаимодействия с другими языками JVM. +Опция компилятора `opt-in` изменяет статус `Null`, делая все ссылочные типы non-nullable. Этот параметр может [стать значением по умолчанию][safe-null] в будущей версии Scala. -В то же время `null` почти никогда не следует использовать в коде Scala. +В то же время `null` почти никогда не следует использовать в коде Scala. Альтернативы `null` обсуждаются в главе о [функциональном программировании][fp] и в [документации API][option-api]. [reference]: {{ site.scala3ref }}/overview.html [matchable]: {{ site.scala3ref }}/other-new-features/matchable.html -[interpolation]: {% link _overviews/core/string-interpolation.md %} +[interpolation]: {% link _overviews/scala3-book/string-interpolation.md %} [fp]: {% link _overviews/scala3-book/fp-intro.md %} [option-api]: https://scala-lang.org/api/3.x/scala/Option.html [safe-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html diff --git a/_zh-cn/overviews/scala3-book/first-look-at-types.md b/_zh-cn/overviews/scala3-book/first-look-at-types.md index 666426ff87..a2c876654b 100644 --- a/_zh-cn/overviews/scala3-book/first-look-at-types.md +++ b/_zh-cn/overviews/scala3-book/first-look-at-types.md @@ -370,7 +370,7 @@ val z: Long = y // Error [reference]: {{ site.scala3ref }}/overview.html [matchable]: {{ site.scala3ref }}/other-new-features/matchable.html -[interpolation]: {% link _overviews/core/string-interpolation.md %} +[interpolation]: {% link _overviews/scala3-book/string-interpolation.md %} [fp]: {% link _zh-cn/overviews/scala3-book/fp-intro.md %} [option-api]: https://scala-lang.org/api/3.x/scala/Option.html [safe-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html From 8af7d5422ea5db7d26279331968fd4dc3b171470 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Thu, 22 Jun 2023 11:33:10 +0200 Subject: [PATCH 2650/3075] highlight using directives in code snippets (#2845) --- resources/js/hljs-scala3.js | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/resources/js/hljs-scala3.js b/resources/js/hljs-scala3.js index 0ba80087ef..e0be3758b8 100644 --- a/resources/js/hljs-scala3.js +++ b/resources/js/hljs-scala3.js @@ -221,6 +221,33 @@ function highlightDotty(hljs) { ] } + // glob all non-whitespace characters as a "string" + const DIRECTIVE_VALUE = { + className: 'string', + begin: /\S+/, + } + + // glob all non-whitespace characters as a "type", so that we can highlight differently to values + const DIRECTIVE_KEY = { + className: 'type', + begin: /\S+/, + } + + // directives + const USING_DIRECTIVE = hljs.COMMENT('//>', '\n', { + contains: [ + { + begin: /using /, + end: /\s/, + keywords: 'using', + contains: [ + DIRECTIVE_KEY + ] + }, + DIRECTIVE_VALUE, + ] + }) + // Documentation const SCALADOC = hljs.COMMENT('/\\*\\*', '\\*/', { contains: [ @@ -454,6 +481,7 @@ function highlightDotty(hljs) { NUMBER, CHAR, STRING, + USING_DIRECTIVE, SCALADOC, hljs.C_LINE_COMMENT_MODE, hljs.C_BLOCK_COMMENT_MODE, From dce2920f0e7f0951790aef5da7f4909aa1d64dd4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Tue, 27 Jun 2023 09:12:22 +0300 Subject: [PATCH 2651/3075] Update extractor-objects.md in russian --- _ru/tour/extractor-objects.md | 62 ++++++++++++++++++++++++++++++++--- 1 file changed, 58 insertions(+), 4 deletions(-) diff --git a/_ru/tour/extractor-objects.md b/_ru/tour/extractor-objects.md index 5be38a2c2f..f93981cd6c 100644 --- a/_ru/tour/extractor-objects.md +++ b/_ru/tour/extractor-objects.md @@ -10,6 +10,10 @@ previous-page: regular-expression-patterns Объект Экстрактор (объект распаковщик или extractor object) - это объект с методом `unapply`. В то время как метод `apply` обычно действует как конструктор, который принимает аргументы и создает объект, метод `unapply` действует обратным образом, он принимает объект и пытается извлечь и вернуть аргументы из которых он (возможно) был создан. Чаще всего этот метод используется в функциях сопоставления с примером и в частично определенных функциях. +{% tabs extractor-objects_definition class=tabs-scala-version %} + +{% tab 'Scala 2' for=extractor-objects_definition %} + ```scala mdoc import scala.util.Random @@ -29,32 +33,82 @@ customer1ID match { case _ => println("Could not extract a CustomerID") } ``` + +{% endtab %} + +{% tab 'Scala 3' for=extractor-objects_definition %} + +```scala +import scala.util.Random + +object CustomerID: + + def apply(name: String) = s"$name--${Random.nextLong()}" + + def unapply(customerID: String): Option[String] = + val stringArray: Array[String] = customerID.split("--") + if stringArray.tail.nonEmpty then Some(stringArray.head) else None + +val customer1ID = CustomerID("Sukyoung") // Sukyoung--23098234908 +customer1ID match + case CustomerID(name) => println(name) // выведет Sukyoung + case _ => println("Could not extract a CustomerID") +``` + +{% endtab %} + +{% endtabs %} + Метод `apply` создает `CustomerID` из строки `name`. `unapply` делает обратное, чтобы вернуть `name` обратно. Когда мы вызываем `CustomerID("Sukyoung")`, это сокращенный синтаксис вызова `CustomerID.apply("Sukyoung")`. Когда мы вызываем `case CustomerID(name) => println(name)`, мы на самом деле вызываем метод `unapply`. При объявлении нового значения можно использовать пример, в котором значение для инициализации переменной получается через извлечение, используя метод `unapply`. +{% tabs extractor-objects_use-case-1 %} + +{% tab 'Scala 2 и 3' for=extractor-objects_use-case-1 %} + ```scala mdoc val customer2ID = CustomerID("Nico") val CustomerID(name) = customer2ID println(name) // выведет Nico ``` +{% endtab %} + +{% endtabs %} + Что эквивалентно `val name = CustomerID.unapply(customer2ID).get`. +{% tabs extractor-objects_use-case-2 %} + +{% tab 'Scala 2 и 3' for=extractor-objects_use-case-2 %} + ```scala mdoc val CustomerID(name2) = "--asdfasdfasdf" ``` +{% endtab %} + +{% endtabs %} + Если совпадений нет, то бросается `scala.MatchError`: +{% tabs extractor-objects_use-case-3 %} + +{% tab 'Scala 2 и 3' for=extractor-objects_use-case-3 %} + ```scala mdoc:crash val CustomerID(name3) = "-asdfasdfasdf" ``` +{% endtab %} + +{% endtabs %} + Возвращаемый тип `unapply` выбирается следующим образом: -* Если это всего лишь тест, возвращается `Boolean`. Например `case even()`. -* Если в результате найдено одно значение типа `T`, то возвращается `Option[T]`. -* Если вы хотите получить несколько значений `T1,..., Tn`, то ответ необходимо группировать в дополнительный кортеж `Option[(T1,..., Tn)]`. +- Если это всего лишь тест, возвращается `Boolean`. Например `case even()`. +- Если в результате найдено одно значение типа `T`, то возвращается `Option[T]`. +- Если вы хотите получить несколько значений `T1,..., Tn`, то ответ необходимо группировать в дополнительный кортеж `Option[(T1,..., Tn)]`. -Иногда количество извлекаемых значений не является фиксированным. Если в зависимости от входа мы хотим вернуть произвольное количество значений, то для этого случая мы можем определить экстрактор методом `unapplySeq`, который возвращает `Option[Seq[T]]`. Характерным примером такого подхода является разложение `List` с помощью `case List(x, y, z) =>` и разложение `String` с помощью регулярного выражения `Regex`, такого как `case r(name, remainingFields @ _*) =>`. +Иногда количество извлекаемых значений не является фиксированным. Если в зависимости от входа мы хотим вернуть произвольное количество значений, то для этого случая мы можем определить экстрактор методом `unapplySeq`, который возвращает `Option[Seq[T]]`. Характерным примером такого подхода является разложение `List` с помощью `case List(x, y, z) =>` и разложение `String` с помощью регулярного выражения `Regex`, такого как `case r(name, remainingFields @ _*) =>`. From f5f8e7402c39a78bcac69703f6015382696fcb4a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Tue, 27 Jun 2023 09:03:39 +0300 Subject: [PATCH 2652/3075] Update reqular-expression-patterns.md in russian --- _ru/tour/regular-expression-patterns.md | 122 +++++++++++++++++++++++- 1 file changed, 121 insertions(+), 1 deletion(-) diff --git a/_ru/tour/regular-expression-patterns.md b/_ru/tour/regular-expression-patterns.md index 159921587c..2058d76ee7 100644 --- a/_ru/tour/regular-expression-patterns.md +++ b/_ru/tour/regular-expression-patterns.md @@ -10,6 +10,10 @@ previous-page: singleton-objects Регулярные выражения (Regular expression) - это специальный шаблон для поиска данных, задаваемый в виде текстовой строки. Любая строка может быть преобразована в регулярное выражение методом `.r`. +{% tabs regex-patterns_numberPattern class=tabs-scala-version %} + +{% tab 'Scala 2' for=regex-patterns_numberPattern %} + ```scala mdoc import scala.util.matching.Regex @@ -21,14 +25,36 @@ numberPattern.findFirstMatchIn("awesomepassword") match { } ``` +{% endtab %} + +{% tab 'Scala 3' for=regex-patterns_numberPattern %} + +```scala +import scala.util.matching.Regex + +val numberPattern: Regex = "[0-9]".r + +numberPattern.findFirstMatchIn("awesomepassword") match + case Some(_) => println("Password OK") + case None => println("Password must contain a number") +``` + +{% endtab %} + +{% endtabs %} + В приведенном выше примере `numberPattern` - это `Regex` (регулярное выражение), которое мы используем, чтобы убедиться, что пароль содержит число. Используя круглые скобки можно объединять сразу несколько групп регулярных выражений. +{% tabs regex-patterns_keyValPattern class=tabs-scala-version %} + +{% tab 'Scala 2' for=regex-patterns_keyValPattern %} + ```scala mdoc import scala.util.matching.Regex -val keyValPattern: Regex = "([0-9a-zA-Z-#() ]+): ([0-9a-zA-Z-#() ]+)".r +val keyValPattern: Regex = "([0-9a-zA-Z- ]+): ([0-9a-zA-Z-#()/. ]+)".r val input: String = """background-color: #A03300; @@ -43,7 +69,36 @@ val input: String = for (patternMatch <- keyValPattern.findAllMatchIn(input)) println(s"key: ${patternMatch.group(1)} value: ${patternMatch.group(2)}") ``` + +{% endtab %} + +{% tab 'Scala 3' for=regex-patterns_keyValPattern %} + +```scala +import scala.util.matching.Regex + +val keyValPattern: Regex = "([0-9a-zA-Z- ]+): ([0-9a-zA-Z-#()/. ]+)".r + +val input: String = + """background-color: #A03300; + |background-image: url(img/header100.png); + |background-position: top center; + |background-repeat: repeat-x; + |background-size: 2160px 108px; + |margin: 0; + |height: 108px; + |width: 100%;""".stripMargin + +for patternMatch <- keyValPattern.findAllMatchIn(input) do + println(s"key: ${patternMatch.group(1)} value: ${patternMatch.group(2)}") +``` + +{% endtab %} + +{% endtabs %} + Здесь мы обработали сразу и ключи и значения строки. В каждом совпадении есть подгруппа совпадений. Вот как выглядит результат: + ``` key: background-color value: #A03300 key: background-image value: url(img @@ -54,3 +109,68 @@ key: margin value: 0 key: height value: 108px key: width value: 100 ``` + +Кроме того, регулярные выражения можно использовать в качестве шаблонов (в выражениях `match`) +для удобного извлечения совпавших групп: + +{% tabs regex-patterns_saveContactInformation class=tabs-scala-version %} + +{% tab 'Scala 2' for=regex-patterns_saveContactInformation %} + +```scala mdoc +def saveContactInformation(contact: String): Unit = { + import scala.util.matching.Regex + + val emailPattern: Regex = """^(\w+)@(\w+(.\w+)+)$""".r + val phonePattern: Regex = """^(\d{3}-\d{3}-\d{4})$""".r + + contact match { + case emailPattern(localPart, domainName, _) => + println(s"Hi $localPart, we have saved your email address.") + case phonePattern(phoneNumber) => + println(s"Hi, we have saved your phone number $phoneNumber.") + case _ => + println("Invalid contact information, neither an email address nor phone number.") + } +} + +saveContactInformation("123-456-7890") +saveContactInformation("JohnSmith@sample.domain.com") +saveContactInformation("2 Franklin St, Mars, Milky Way") +``` + +{% endtab %} + +{% tab 'Scala 3' for=regex-patterns_saveContactInformation %} + +```scala +def saveContactInformation(contact: String): Unit = + import scala.util.matching.Regex + + val emailPattern: Regex = """^(\w+)@(\w+(.\w+)+)$""".r + val phonePattern: Regex = """^(\d{3}-\d{3}-\d{4})$""".r + + contact match + case emailPattern(localPart, domainName, _) => + println(s"Hi $localPart, we have saved your email address.") + case phonePattern(phoneNumber) => + println(s"Hi, we have saved your phone number $phoneNumber.") + case _ => + println("Invalid contact information, neither an email address nor phone number.") + +saveContactInformation("123-456-7890") +saveContactInformation("JohnSmith@sample.domain.com") +saveContactInformation("2 Franklin St, Mars, Milky Way") +``` + +{% endtab %} + +{% endtabs %} + +Вот как выглядит результат: + +``` +Hi, we have saved your phone number 123-456-7890. +Hi JohnSmith, we have saved your email address. +Invalid contact information, neither an email address nor phone number. +``` From 80a950cf71311e9c54c165d79653c5846cd5d840 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Tue, 27 Jun 2023 08:53:11 +0300 Subject: [PATCH 2653/3075] Update singleton-objects.md in russian --- _ru/tour/singleton-objects.md | 140 ++++++++++++++++++++++++++++++++-- _tour/singleton-objects.md | 2 +- 2 files changed, 134 insertions(+), 8 deletions(-) diff --git a/_ru/tour/singleton-objects.md b/_ru/tour/singleton-objects.md index 5b2f79dac8..3f58689062 100644 --- a/_ru/tour/singleton-objects.md +++ b/_ru/tour/singleton-objects.md @@ -8,30 +8,67 @@ next-page: regular-expression-patterns previous-page: pattern-matching prerequisite-knowledge: classes, methods, private-methods, packages, option --- + Все объекты являются одиночками (Singleton Object) - то есть существуют в единственном экземпляре. Он создается лениво, когда на него ссылаются, также как ленивые значения (lazy val). На самом верхнем уровне объект является одиночкой. Как член класса или как локальная переменная, он ведет себя точно так же как ленивое значение (lazy val). + # Объявление одиночного объекта + Объект - является значением. Объявление объекта происходит схожим с классом образом, но используется ключевое слово `object`: + +{% tabs object-definition-box %} + +{% tab 'Scala 2 и 3' for=object-definition-box %} + ```scala mdoc object Box ``` +{% endtab %} + +{% endtabs %} + Вот пример объекта с методом: -``` + +{% tabs singleton-logger-example class=tabs-scala-version %} + +{% tab 'Scala 2' for=singleton-logger-example %} + +```scala package logging object Logger { def info(message: String): Unit = println(s"INFO: $message") } ``` + +{% endtab %} + +{% tab 'Scala 3' for=singleton-logger-example %} + +```scala +package logging + +object Logger: + def info(message: String): Unit = println(s"INFO: $message") +``` + +{% endtab %} + +{% endtabs %} + Метод `info` может быть импортирован в любом месте программы. Создание подобных методов является распространенным вариантом использования одиночных объектов. Давайте посмотрим, как использовать `info` в другом пакете: -``` +{% tabs singleton-usage-example class=tabs-scala-version %} + +{% tab 'Scala 2' for=singleton-usage-example %} + +```scala import logging.Logger.info class Project(name: String, daysToComplete: Int) @@ -43,15 +80,44 @@ class Test { } ``` +{% endtab %} + +{% tab 'Scala 3' for=singleton-usage-example %} + +```scala +import logging.Logger.info + +class Project(name: String, daysToComplete: Int) + +class Test: + val project1 = Project("TPS Reports", 1) + val project2 = Project("Website redesign", 5) + info("Created projects") // Prints "INFO: Created projects" +``` + +{% endtab %} + +{% endtabs %} + Метод `info` виден благодаря указанию импорта `import logging.Logger.info`. +Для импорта требуется "постоянный путь" к импортируемому символу, а путь к объекту неизменен. -Замечание: Если `object` не является объектом верхнего уровня, но вложен в другой класс или объект, то объект, как и любой другой член, "зависим от пути". +Замечание: Если `object` не является объектом верхнего уровня, но вложен в другой класс или объект, +то объект, как и любой другой член, "зависим от пути". +Это означает, что для двух видов напитков, `class Milk` и `class OrangeJuice`, +элемент класса `object NutritionInfo` "зависит" от включающего его экземпляра, будь то `Milk` или `OrangeJuice`. +`milk.NutritionInfo` полностью отличается от `oj.NutritionInfo`. ## Объекты компаньоны Объект с тем же именем, что и класс называется _объект компаньон_ (companion object). И наоборот, класс является классом-компаньоном объекта. Класс или объект компаньон может получить доступ к приватным членам своего спутника. Используйте объект компаньон для методов и значений, которые не специфичны для экземпляров класса компаньона. -``` -import scala.math._ + +{% tabs companion-object-circle class=tabs-scala-version %} + +{% tab 'Scala 2' for=companion-object-circle %} + +```scala +import scala.math.pow case class Circle(radius: Double) { import Circle._ @@ -67,9 +133,37 @@ val circle1 = Circle(5.0) circle1.area ``` +{% endtab %} + +{% tab 'Scala 3' for=companion-object-circle %} + +```scala +import scala.math.pow + +case class Circle(radius: Double): + import Circle.* + def area: Double = calculateArea(radius) + +object Circle: + private def calculateArea(radius: Double): Double = Pi * pow(radius, 2.0) + + +val circle1 = Circle(5.0) + +circle1.area +``` + +{% endtab %} + +{% endtabs %} + Класс `Circle` имеет член `area`, который специфичен для каждого конкретного экземпляра, а метод `calculateArea` одиночного объекта `Circle`, доступен для каждого экземпляра класса `Circle`. Объект компаньон может также содержать методы создающие конкретные экземпляры класса спутника: +{% tabs companion-object-email class=tabs-scala-version %} + +{% tab 'Scala 2' for=companion-object-email %} + ```scala mdoc class Email(val username: String, val domainName: String) @@ -88,16 +182,48 @@ scalaCenterEmail match { s"""Registered an email |Username: ${email.username} |Domain name: ${email.domainName} - """) + """.stripMargin) case None => println("Error: could not parse email") } ``` + +{% endtab %} + +{% tab 'Scala 3' for=companion-object-email %} + +```scala +class Email(val username: String, val domainName: String) + +object Email: + def fromString(emailString: String): Option[Email] = + emailString.split('@') match + case Array(a, b) => Some(Email(a, b)) + case _ => None + +val scalaCenterEmail = Email.fromString("scala.center@epfl.ch") +scalaCenterEmail match + case Some(email) => println( + s"""Registered an email + |Username: ${email.username} + |Domain name: ${email.domainName} + """.stripMargin) + case None => println("Error: could not parse email") +``` + +{% endtab %} + +{% endtabs %} + `object Email` содержит производящий метод `fromString`, который создает экземпляр `Email` из строки. Мы возвращаем результат как `Option[Email]` на случай возникновения ошибок парсинга. Примечание: Если у класса или объекта есть компаньон, они должны быть размещены в одном и том же файле. Чтобы задать компаньонов в REPL, либо определите их на той же строке, либо перейдите в режим `:paste`. -## Примечания для Java-программистов ## +## Примечания для Java-программистов `static` члены в Java смоделированы как обычные члены объекта компаньона в Scala. При использовании объекта компаньона из Java-кода, члены будут определены в сопутствующем классе компаньоне с `static` модификатором. Это называется _пробрасывание статики_. Такое происходит, даже если вы сами не определили класс компаньон. + +## Дополнительные ресурсы + +- Узнайте больше об объектах компаньонах в [Scala Book](/scala3/book/domain-modeling-tools.html#companion-objects) diff --git a/_tour/singleton-objects.md b/_tour/singleton-objects.md index db2cd27de8..369402eee1 100644 --- a/_tour/singleton-objects.md +++ b/_tour/singleton-objects.md @@ -206,4 +206,4 @@ When using a companion object from Java code, the members will be defined in a c ## More resources -* Learn more about Companion objects in the [Scala Book](/overviews/scala-book/companion-objects.html) +* Learn more about Companion objects in the [Scala Book](/scala3/book/domain-modeling-tools.html#companion-objects) From f893876e55fac5dbcd02a0690958b4ddc823f3e0 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 3 Jul 2023 09:31:04 +0300 Subject: [PATCH 2654/3075] Add string interpolation in ru (#2846) --- .../scala3-book/string-interpolation.md | 2 +- _ru/scala3/book/collections-classes.md | 2 +- _ru/scala3/book/collections-intro.md | 2 +- _ru/scala3/book/collections-methods.md | 2 +- _ru/scala3/book/collections-summary.md | 2 +- _ru/scala3/book/control-structures.md | 4 +- _ru/scala3/book/domain-modeling-fp.md | 2 +- _ru/scala3/book/domain-modeling-intro.md | 2 +- _ru/scala3/book/domain-modeling-oop.md | 2 +- _ru/scala3/book/domain-modeling-tools.md | 2 +- _ru/scala3/book/first-look-at-types.md | 181 ++++---- .../book/fp-functional-error-handling.md | 2 +- _ru/scala3/book/fp-functions-are-values.md | 2 +- _ru/scala3/book/fp-immutable-values.md | 2 +- _ru/scala3/book/fp-intro.md | 2 +- _ru/scala3/book/fp-pure-functions.md | 2 +- _ru/scala3/book/fp-summary.md | 2 +- _ru/scala3/book/fp-what-is-fp.md | 2 +- _ru/scala3/book/fun-anonymous-functions.md | 2 +- _ru/scala3/book/fun-eta-expansion.md | 2 +- _ru/scala3/book/fun-function-variables.md | 2 +- _ru/scala3/book/fun-hofs.md | 2 +- _ru/scala3/book/fun-intro.md | 2 +- _ru/scala3/book/fun-summary.md | 2 +- _ru/scala3/book/fun-write-map-function.md | 2 +- .../book/fun-write-method-returns-function.md | 2 +- _ru/scala3/book/methods-intro.md | 2 +- _ru/scala3/book/methods-main-methods.md | 2 +- _ru/scala3/book/methods-most.md | 2 +- _ru/scala3/book/methods-summary.md | 2 +- _ru/scala3/book/packaging-imports.md | 2 +- _ru/scala3/book/string-interpolation.md | 413 ++++++++++++++++++ _ru/scala3/book/types-generics.md | 2 +- _ru/scala3/book/types-inferred.md | 2 +- _ru/scala3/book/types-intersection.md | 2 +- _ru/scala3/book/types-introduction.md | 2 +- _ru/scala3/book/types-union.md | 2 +- 37 files changed, 539 insertions(+), 127 deletions(-) create mode 100644 _ru/scala3/book/string-interpolation.md diff --git a/_overviews/scala3-book/string-interpolation.md b/_overviews/scala3-book/string-interpolation.md index 7cfdc52369..cf68d4eafd 100644 --- a/_overviews/scala3-book/string-interpolation.md +++ b/_overviews/scala3-book/string-interpolation.md @@ -2,7 +2,7 @@ title: String Interpolation type: chapter description: This page provides more information about creating strings and using string interpolation. -languages: [] +languages: [ru] num: 18 previous-page: first-look-at-types next-page: control-structures diff --git a/_ru/scala3/book/collections-classes.md b/_ru/scala3/book/collections-classes.md index 53f169249f..80fcf30248 100644 --- a/_ru/scala3/book/collections-classes.md +++ b/_ru/scala3/book/collections-classes.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице представлены общие типы коллекций Scala 3 и некоторые из их методов. language: ru -num: 37 +num: 38 previous-page: collections-intro next-page: collections-methods --- diff --git a/_ru/scala3/book/collections-intro.md b/_ru/scala3/book/collections-intro.md index 92793002fe..c29c5ecc29 100644 --- a/_ru/scala3/book/collections-intro.md +++ b/_ru/scala3/book/collections-intro.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: chapter description: На этой странице представлено введение в общие классы коллекций и их методы в Scala 3. language: ru -num: 36 +num: 37 previous-page: packaging-imports next-page: collections-classes --- diff --git a/_ru/scala3/book/collections-methods.md b/_ru/scala3/book/collections-methods.md index 503b52d705..a11cdd1738 100644 --- a/_ru/scala3/book/collections-methods.md +++ b/_ru/scala3/book/collections-methods.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице показаны общие методы классов коллекций Scala 3. language: ru -num: 38 +num: 39 previous-page: collections-classes next-page: collections-summary --- diff --git a/_ru/scala3/book/collections-summary.md b/_ru/scala3/book/collections-summary.md index 6e852ad359..7d89b4961c 100644 --- a/_ru/scala3/book/collections-summary.md +++ b/_ru/scala3/book/collections-summary.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице представлен краткий итог главы «Коллекции». language: ru -num: 39 +num: 40 previous-page: collections-methods next-page: fp-intro --- diff --git a/_ru/scala3/book/control-structures.md b/_ru/scala3/book/control-structures.md index 37e78c1633..fe9c7e4758 100644 --- a/_ru/scala3/book/control-structures.md +++ b/_ru/scala3/book/control-structures.md @@ -7,8 +7,8 @@ overview-name: "Scala 3 — Book" type: chapter description: На этой странице представлено введение в структуры управления Scala, включая if/then/else, циклы for, выражения for, выражения match, try/catch/finally и циклы while. language: ru -num: 18 -previous-page: first-look-at-types +num: 19 +previous-page: string-interpolation next-page: domain-modeling-intro --- diff --git a/_ru/scala3/book/domain-modeling-fp.md b/_ru/scala3/book/domain-modeling-fp.md index e085a0dc06..a5bdb326c5 100644 --- a/_ru/scala3/book/domain-modeling-fp.md +++ b/_ru/scala3/book/domain-modeling-fp.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этой главе представлено введение в моделирование предметной области с использованием ФП в Scala 3. language: ru -num: 22 +num: 23 previous-page: domain-modeling-oop next-page: methods-intro --- diff --git a/_ru/scala3/book/domain-modeling-intro.md b/_ru/scala3/book/domain-modeling-intro.md index 6202dec08d..79828b6d84 100644 --- a/_ru/scala3/book/domain-modeling-intro.md +++ b/_ru/scala3/book/domain-modeling-intro.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: chapter description: В этой главе показано, как можно моделировать предметную область с помощью Scala 3. language: ru -num: 19 +num: 20 previous-page: control-structures next-page: domain-modeling-tools --- diff --git a/_ru/scala3/book/domain-modeling-oop.md b/_ru/scala3/book/domain-modeling-oop.md index df09cdbdd2..f9de517ddd 100644 --- a/_ru/scala3/book/domain-modeling-oop.md +++ b/_ru/scala3/book/domain-modeling-oop.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этой главе представлено введение в моделирование предметной области с использованием ООП в Scala 3. language: ru -num: 21 +num: 22 previous-page: domain-modeling-tools next-page: domain-modeling-fp --- diff --git a/_ru/scala3/book/domain-modeling-tools.md b/_ru/scala3/book/domain-modeling-tools.md index b081a12d2a..ec35430443 100644 --- a/_ru/scala3/book/domain-modeling-tools.md +++ b/_ru/scala3/book/domain-modeling-tools.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этой главе представлено введение в доступные инструменты моделирования предметной области в Scala 3, включая классы, трейты, перечисления и многое другое. language: ru -num: 20 +num: 21 previous-page: domain-modeling-intro next-page: domain-modeling-oop --- diff --git a/_ru/scala3/book/first-look-at-types.md b/_ru/scala3/book/first-look-at-types.md index a0170478f5..5873df07f7 100644 --- a/_ru/scala3/book/first-look-at-types.md +++ b/_ru/scala3/book/first-look-at-types.md @@ -9,10 +9,9 @@ description: На этой странице представлено кратк language: ru num: 17 previous-page: taste-summary -next-page: control-structures +next-page: string-interpolation --- - ## Все значения имеют тип В Scala все значения имеют тип, включая числовые значения и функции. @@ -33,12 +32,12 @@ next-page: control-structures `Matchable` содержит два важных подтипа: `AnyVal` и `AnyRef`. -*`AnyVal`* представляет типы значений. +_`AnyVal`_ представляет типы значений. Существует несколько предопределенных типов значений, и они non-nullable: `Double`, `Float`, `Long`, `Int`, `Short`, `Byte`, `Char`, `Unit` и `Boolean`. `Unit` - это тип значения, который не несет никакой значимой информации. Существует ровно один экземпляр `Unit` - `()`. -*`AnyRef`* представляет ссылочные типы. Все типы, не являющиеся значениями, определяются как ссылочные типы. +_`AnyRef`_ представляет ссылочные типы. Все типы, не являющиеся значениями, определяются как ссылочные типы. Каждый пользовательский тип в Scala является подтипом `AnyRef`. Если Scala используется в контексте среды выполнения Java, `AnyRef` соответствует `java.lang.Object`. @@ -48,9 +47,11 @@ next-page: control-structures {% tabs unit %} {% tab 'Scala 2 и 3' for=unit %} + ```scala def printIt(a: Any): Unit = println(a) ``` + {% endtab %} {% endtabs %} @@ -59,17 +60,20 @@ def printIt(a: Any): Unit = println(a) {% tabs any %} {% tab 'Scala 2 и 3' for=any %} + ```scala val list: List[Any] = List( "a string", 732, // число 'c', // буква + '\'', // Экранированный символ true, // булево значение () => "an anonymous function returning a string" ) list.foreach(element => println(element)) ``` + {% endtab %} {% endtabs %} @@ -83,6 +87,7 @@ list.foreach(element => println(element)) a string 732 c +' true <function> ``` @@ -94,6 +99,7 @@ true {% tabs anyval %} {% tab 'Scala 2 и 3' for=anyval %} + ```scala val b: Byte = 1 val i: Int = 1 @@ -102,6 +108,7 @@ val s: Short = 1 val d: Double = 2.0 val f: Float = 3.0 ``` + {% endtab %} {% endtabs %} @@ -114,10 +121,12 @@ val f: Float = 3.0 {% tabs anynum %} {% tab 'Scala 2 и 3' for=anynum %} + ```scala val i = 123 // по умолчанию Int val x = 1.0 // по умолчанию Double ``` + {% endtab %} {% endtabs %} @@ -126,11 +135,30 @@ val x = 1.0 // по умолчанию Double {% tabs type-post %} {% tab 'Scala 2 и 3' for=type-post %} + ```scala val x = 1_000L // val x: Long = 1000 val y = 2.2D // val y: Double = 2.2 -val z = 3.3F // val z: Float = 3.3 +val z = -3.3F // val z: Float = -3.3 ``` + +Вы также можете использовать шестнадцатеричное представление для форматирования целых чисел +(обычно это `Int`, но также поддерживается суффикс `L` для указания `Long`): + +```scala +val a = 0xACE // val a: Int = 2766 +val b = 0xfd_3aL // val b: Long = 64826 +``` + +Scala поддерживает множество различных способов форматирования одного и того же числа с плавающей запятой, +например: + +```scala +val q = .25 // val q: Double = 0.25 +val r = 2.5e-1 // val r: Double = 0.25 +val s = .0025e2F // val s: Float = 0.25 +``` + {% endtab %} {% endtabs %} @@ -138,10 +166,12 @@ val z = 3.3F // val z: Float = 3.3 {% tabs type-string %} {% tab 'Scala 2 и 3' for=type-string %} + ```scala val s = "Bill" val c = 'a' ``` + {% endtab %} {% endtabs %} @@ -151,7 +181,7 @@ val c = 'a' Типы данных и их диапазоны: | Тип данных | Возможные значения | -|------------|--------------------------------------------------------------------------------------------------------------------------------| +| ---------- | ------------------------------------------------------------------------------------------------------------------------------ | | Boolean | `true` или `false` | | Byte | 8-битное целое число в дополнении до двух со знаком (от -2^7 до 2^7-1 включительно)<br/>от -128 до 127 | | Short | 16-битное целое число в дополнении до двух со знаком (от -2^15 до 2^15-1 включительно)<br/>от -32 768 до 32 767 | @@ -162,135 +192,100 @@ val c = 'a' | Char | 16-битный символ Unicode без знака (от 0 до 2^16-1 включительно)<br/>от 0 до 65 535 | | String | последовательность `Char` | +## Строки -## `BigInt` и `BigDecimal` +Строки Scala похожи на строки Java, +хотя в отличие от Java (по крайней мере, до Java 15) +в Scala легко создавать многострочные строки с тройными кавычками: -Для действительно больших чисел можно использовать типы `BigInt` и `BigDecimal`: +{% tabs string-mlines1 %} +{% tab 'Scala 2 и 3' for=string-mlines1 %} -{% tabs type-bigint %} -{% tab 'Scala 2 и 3' for=type-bigint %} ```scala -val a = BigInt(1_234_567_890_987_654_321L) -val b = BigDecimal(123_456.789) +val quote = """The essence of Scala: + Fusion of functional and object-oriented + programming in a typed setting.""" ``` + {% endtab %} {% endtabs %} -Где `Double` и `Float` являются приблизительными десятичными числами, -а `BigDecimal` используется для точной арифметики, например, при работе с валютой. +Одним из недостатков этого базового подхода является то, +что строки после первой строки содержат отступ и выглядят следующим образом: -`BigInt` и `BigDecimal` поддерживают все привычные числовые операторы: +{% tabs string-mlines2 %} +{% tab 'Scala 2 и 3' for=string-mlines2 %} -{% tabs type-bigint2 %} -{% tab 'Scala 2 и 3' for=type-bigint2 %} ```scala -val b = BigInt(1234567890) // scala.math.BigInt = 1234567890 -val c = b + b // scala.math.BigInt = 2469135780 -val d = b * b // scala.math.BigInt = 1524157875019052100 +"The essence of Scala: + Fusion of functional and object-oriented + programming in a typed setting." ``` + {% endtab %} {% endtabs %} -## Два замечания о строках - -Строки Scala похожи на строки Java, но у них есть две замечательные дополнительные функции: +Если важно исключить отступ, можно поставить символ `|` перед всеми строками после первой +и вызвать метод `stripMargin` после строки: -- Они поддерживают интерполяцию строк -- Легко создавать многострочные строки - -### Интерполяция строк - -Интерполяция строк обеспечивает очень удобный способ использования переменных внутри строк. -Например, учитывая эти три переменные: +{% tabs string-mlines3 %} +{% tab 'Scala 2 и 3' for=string-mlines3 %} -{% tabs string-inside1 %} -{% tab 'Scala 2 и 3' for=string-inside1 %} ```scala -val firstName = "John" -val mi = 'C' -val lastName = "Doe" +val quote = """The essence of Scala: + |Fusion of functional and object-oriented + |programming in a typed setting.""".stripMargin ``` -{% endtab %} -{% endtabs %} - -их комбинацию можно получить так: -{% tabs string-inside2 %} -{% tab 'Scala 2 и 3' for=string-inside2 %} -```scala -println(s"Name: $firstName $mi $lastName") // "Name: John C Doe" -``` {% endtab %} {% endtabs %} -Достаточно поставить перед строкой букву `s`, а затем - символ `$` перед именами переменных внутри строки. +Теперь все строки выравниваются по левому краю: -Чтобы вставить произвольные выражения в строку, они заключаются в фигурные скобки: +{% tabs string-mlines4 %} +{% tab 'Scala 2 и 3' for=string-mlines4 %} -{% tabs string-inside3 %} -{% tab 'Scala 2 и 3' for=string-inside3 %} ```scala -println(s"2 + 2 = ${2 + 2}") // печатает "2 + 2 = 4" -val x = -1 -println(s"x.abs = ${x.abs}") // печатает "x.abs = 1" +"The essence of Scala: +Fusion of functional and object-oriented +programming in a typed setting." ``` + {% endtab %} {% endtabs %} -#### Другие интерполяторы +Строки Scala также поддерживают мощные методы интерполяции строк, +о которых мы поговорим [в следующей главе][string-interpolation]. -То `s`, что вы помещаете перед строкой, является лишь одним из возможных интерполяторов. -Если вы используете `f` вместо `s`, вы можете использовать `printf` - синтаксис форматирования стиля в строке. -Кроме того, строковый интерполятор — это всего лишь специальный метод, и вы можете определить свой собственный. -Например, некоторые библиотеки баз данных определяют очень мощный интерполятор `sql`. +## `BigInt` и `BigDecimal` -### Многострочные строки +Для действительно больших чисел можно использовать типы `BigInt` и `BigDecimal`: -Многострочные строки создаются путем включения строки в три двойные кавычки: +{% tabs type-bigint %} +{% tab 'Scala 2 и 3' for=type-bigint %} -{% tabs string-mlines1 %} -{% tab 'Scala 2 и 3' for=string-mlines1 %} ```scala -val quote = """The essence of Scala: - Fusion of functional and object-oriented - programming in a typed setting.""" +val a = BigInt(1_234_567_890_987_654_321L) +val b = BigDecimal(123456.789) ``` -{% endtab %} -{% endtabs %} - -Одним из недостатков базового подхода является то, что строки после первой имеют отступ. -{% tabs string-mlines2 %} -{% tab 'Scala 2 и 3' for=string-mlines2 %} -```scala -"The essence of Scala: - Fusion of functional and object-oriented - programming in a typed setting." -``` {% endtab %} {% endtabs %} -Если важно исключить отступ, можно поставить символ `|` перед всеми строками после первой и вызвать метод `stripMargin` после строки: +Где `Double` и `Float` являются приблизительными десятичными числами, +а `BigDecimal` используется для точной арифметики, например, при работе с валютой. -{% tabs string-mlines3 %} -{% tab 'Scala 2 и 3' for=string-mlines3 %} -```scala -val quote = """The essence of Scala: - |Fusion of functional and object-oriented - |programming in a typed setting.""".stripMargin -``` -{% endtab %} -{% endtabs %} +`BigInt` и `BigDecimal` поддерживают все привычные числовые операторы: -Теперь все строки выравниваются по левому краю: +{% tabs type-bigint2 %} +{% tab 'Scala 2 и 3' for=type-bigint2 %} -{% tabs string-mlines4 %} -{% tab 'Scala 2 и 3' for=string-mlines4 %} ```scala -"The essence of Scala: -Fusion of functional and object-oriented -programming in a typed setting." +val b = BigInt(1234567890) // scala.math.BigInt = 1234567890 +val c = b + b // scala.math.BigInt = 2469135780 +val d = b * b // scala.math.BigInt = 1524157875019052100 ``` + {% endtab %} {% endtabs %} @@ -304,6 +299,7 @@ programming in a typed setting." {% tabs cast1 %} {% tab 'Scala 2 и 3' for=cast1 %} + ```scala val b: Byte = 127 val i: Int = b // 127 @@ -311,6 +307,7 @@ val i: Int = b // 127 val face: Char = '☺' val number: Int = face // 9786 ``` + {% endtab %} {% endtabs %} @@ -319,11 +316,13 @@ val number: Int = face // 9786 {% tabs cast2 %} {% tab 'Scala 2 и 3' for=cast2 %} + ```scala val x: Long = 987654321 val y: Float = x.toFloat // 9.8765434E8 (обратите внимание, что требуется `.toFloat`, потому что приведение приводит к потере точности) val z: Long = y // Ошибка ``` + {% endtab %} {% endtabs %} @@ -349,7 +348,7 @@ val z: Long = y // Ошибка [reference]: {{ site.scala3ref }}/overview.html [matchable]: {{ site.scala3ref }}/other-new-features/matchable.html -[interpolation]: {% link _overviews/scala3-book/string-interpolation.md %} [fp]: {% link _overviews/scala3-book/fp-intro.md %} +[string-interpolation]: {% link _overviews/scala3-book/string-interpolation.md %} [option-api]: https://scala-lang.org/api/3.x/scala/Option.html [safe-null]: {{ site.scala3ref }}/experimental/explicit-nulls.html diff --git a/_ru/scala3/book/fp-functional-error-handling.md b/_ru/scala3/book/fp-functional-error-handling.md index bf6d299fbd..ca3f7857eb 100644 --- a/_ru/scala3/book/fp-functional-error-handling.md +++ b/_ru/scala3/book/fp-functional-error-handling.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе представлено введение в функциональную обработку ошибок в Scala 3. language: ru -num: 45 +num: 46 previous-page: fp-functions-are-values next-page: fp-summary --- diff --git a/_ru/scala3/book/fp-functions-are-values.md b/_ru/scala3/book/fp-functions-are-values.md index 62cacc4540..9a6cd6c423 100644 --- a/_ru/scala3/book/fp-functions-are-values.md +++ b/_ru/scala3/book/fp-functions-are-values.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе рассматривается использование функций в качестве значений в функциональном программировании. language: ru -num: 44 +num: 45 previous-page: fp-pure-functions next-page: fp-functional-error-handling --- diff --git a/_ru/scala3/book/fp-immutable-values.md b/_ru/scala3/book/fp-immutable-values.md index 24ffaf8613..53f63d0b26 100644 --- a/_ru/scala3/book/fp-immutable-values.md +++ b/_ru/scala3/book/fp-immutable-values.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе рассматривается использование неизменяемых значений в функциональном программировании. language: ru -num: 42 +num: 43 previous-page: fp-what-is-fp next-page: fp-pure-functions --- diff --git a/_ru/scala3/book/fp-intro.md b/_ru/scala3/book/fp-intro.md index 7961b13a83..a8a44521a2 100644 --- a/_ru/scala3/book/fp-intro.md +++ b/_ru/scala3/book/fp-intro.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: chapter description: В этой главе представлено введение в функциональное программирование в Scala 3. language: ru -num: 40 +num: 41 previous-page: collections-summary next-page: fp-what-is-fp --- diff --git a/_ru/scala3/book/fp-pure-functions.md b/_ru/scala3/book/fp-pure-functions.md index fd70cc5694..47a277a858 100644 --- a/_ru/scala3/book/fp-pure-functions.md +++ b/_ru/scala3/book/fp-pure-functions.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе рассматривается использование чистых функций в функциональном программировании. language: ru -num: 43 +num: 44 previous-page: fp-immutable-values next-page: fp-functions-are-values --- diff --git a/_ru/scala3/book/fp-summary.md b/_ru/scala3/book/fp-summary.md index 3a3cc5498d..0e18a20356 100644 --- a/_ru/scala3/book/fp-summary.md +++ b/_ru/scala3/book/fp-summary.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: Этот раздел суммирует предыдущие разделы функционального программирования. language: ru -num: 46 +num: 47 previous-page: fp-functional-error-handling next-page: types-introduction --- diff --git a/_ru/scala3/book/fp-what-is-fp.md b/_ru/scala3/book/fp-what-is-fp.md index 9e3f046542..8b624b5415 100644 --- a/_ru/scala3/book/fp-what-is-fp.md +++ b/_ru/scala3/book/fp-what-is-fp.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: Этот раздел дает ответ на вопрос, что такое функциональное программирование? language: ru -num: 41 +num: 42 previous-page: fp-intro next-page: fp-immutable-values --- diff --git a/_ru/scala3/book/fun-anonymous-functions.md b/_ru/scala3/book/fun-anonymous-functions.md index d5d0046917..98b7158e8f 100644 --- a/_ru/scala3/book/fun-anonymous-functions.md +++ b/_ru/scala3/book/fun-anonymous-functions.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице показано, как использовать анонимные функции в Scala, включая примеры с функциями map и filter класса List. language: ru -num: 28 +num: 29 previous-page: fun-intro next-page: fun-function-variables --- diff --git a/_ru/scala3/book/fun-eta-expansion.md b/_ru/scala3/book/fun-eta-expansion.md index 9e2baf3810..1cbbc3255a 100644 --- a/_ru/scala3/book/fun-eta-expansion.md +++ b/_ru/scala3/book/fun-eta-expansion.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице обсуждается Eta Expansion, технология Scala, которая автоматически и прозрачно преобразует методы в функции. language: ru -num: 30 +num: 31 previous-page: fun-function-variables next-page: fun-hofs --- diff --git a/_ru/scala3/book/fun-function-variables.md b/_ru/scala3/book/fun-function-variables.md index bd41113ac1..667d4e7c30 100644 --- a/_ru/scala3/book/fun-function-variables.md +++ b/_ru/scala3/book/fun-function-variables.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице показано, как использовать параметры функции в Scala. language: ru -num: 29 +num: 30 previous-page: fun-anonymous-functions next-page: fun-eta-expansion --- diff --git a/_ru/scala3/book/fun-hofs.md b/_ru/scala3/book/fun-hofs.md index ae8445463c..805f243533 100644 --- a/_ru/scala3/book/fun-hofs.md +++ b/_ru/scala3/book/fun-hofs.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице показано, как создавать и использовать функции высшего порядка в Scala. language: ru -num: 31 +num: 32 previous-page: fun-eta-expansion next-page: fun-write-map-function --- diff --git a/_ru/scala3/book/fun-intro.md b/_ru/scala3/book/fun-intro.md index e28840f949..01d2080096 100644 --- a/_ru/scala3/book/fun-intro.md +++ b/_ru/scala3/book/fun-intro.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: chapter description: В этой главе рассматриваются темы, связанные с функциями в Scala 3. language: ru -num: 27 +num: 28 previous-page: methods-summary next-page: fun-anonymous-functions --- diff --git a/_ru/scala3/book/fun-summary.md b/_ru/scala3/book/fun-summary.md index 77a72a05b2..20391f5af9 100644 --- a/_ru/scala3/book/fun-summary.md +++ b/_ru/scala3/book/fun-summary.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице представлен обзор предыдущего раздела 'Функции'. language: ru -num: 34 +num: 35 previous-page: fun-write-method-returns-function next-page: packaging-imports --- diff --git a/_ru/scala3/book/fun-write-map-function.md b/_ru/scala3/book/fun-write-map-function.md index 020a2e61a8..f7b6a0f63e 100644 --- a/_ru/scala3/book/fun-write-map-function.md +++ b/_ru/scala3/book/fun-write-map-function.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице описано, как создать свой собственный метод map language: ru -num: 32 +num: 33 previous-page: fun-hofs next-page: fun-write-method-returns-function --- diff --git a/_ru/scala3/book/fun-write-method-returns-function.md b/_ru/scala3/book/fun-write-method-returns-function.md index a322162e58..a2bb66c69c 100644 --- a/_ru/scala3/book/fun-write-method-returns-function.md +++ b/_ru/scala3/book/fun-write-method-returns-function.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице показано, как создавать методы, возвращающие функции, в Scala. language: ru -num: 33 +num: 34 previous-page: fun-write-map-function next-page: fun-summary --- diff --git a/_ru/scala3/book/methods-intro.md b/_ru/scala3/book/methods-intro.md index b5192db1cb..de34fc1166 100644 --- a/_ru/scala3/book/methods-intro.md +++ b/_ru/scala3/book/methods-intro.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: chapter description: В этой главе представлены методы в Scala 3. language: ru -num: 23 +num: 24 previous-page: domain-modeling-fp next-page: methods-most --- diff --git a/_ru/scala3/book/methods-main-methods.md b/_ru/scala3/book/methods-main-methods.md index 79fc169c54..46844f6485 100644 --- a/_ru/scala3/book/methods-main-methods.md +++ b/_ru/scala3/book/methods-main-methods.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: На этой странице описывается, как основные методы и аннотация @main работают в Scala 3. language: ru -num: 25 +num: 26 previous-page: methods-most next-page: methods-summary --- diff --git a/_ru/scala3/book/methods-most.md b/_ru/scala3/book/methods-most.md index 0554fa9464..b3d8f6ed81 100644 --- a/_ru/scala3/book/methods-most.md +++ b/_ru/scala3/book/methods-most.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе представлены методы Scala 3, включая main методы, методы расширения и многое другое. language: ru -num: 24 +num: 25 previous-page: methods-intro next-page: methods-main-methods --- diff --git a/_ru/scala3/book/methods-summary.md b/_ru/scala3/book/methods-summary.md index e19748a8fc..029c4de687 100644 --- a/_ru/scala3/book/methods-summary.md +++ b/_ru/scala3/book/methods-summary.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: Эта страница подводит итог предыдущим разделам о методах в Scala 3. language: ru -num: 26 +num: 27 previous-page: methods-main-methods next-page: fun-intro --- diff --git a/_ru/scala3/book/packaging-imports.md b/_ru/scala3/book/packaging-imports.md index bde9efdd30..89bee0a428 100644 --- a/_ru/scala3/book/packaging-imports.md +++ b/_ru/scala3/book/packaging-imports.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: chapter description: Обсуждение использования пакетов и импорта для организации кода, создания связанных модулей кода, управления областью действия и предотвращения конфликтов пространств имен. language: ru -num: 35 +num: 36 previous-page: fun-summary next-page: collections-intro --- diff --git a/_ru/scala3/book/string-interpolation.md b/_ru/scala3/book/string-interpolation.md new file mode 100644 index 0000000000..9e37b526fa --- /dev/null +++ b/_ru/scala3/book/string-interpolation.md @@ -0,0 +1,413 @@ +--- +layout: multipage-overview +title: Интерполяция строк +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: chapter +description: На этой странице представлена дополнительная информация о создании строк и использовании интерполяции строк. +language: ru +num: 18 +previous-page: first-look-at-types +next-page: control-structures +--- + +## Введение + +Интерполяция строк позволяет использовать внутри строк переменные. +Например: + +{% tabs example-1 %} +{% tab 'Scala 2 и 3' for=example-1 %} + +```scala +val name = "James" +val age = 30 +println(s"$name is $age years old") // "James is 30 years old" +``` + +{% endtab %} +{% endtabs %} + +Использование интерполяции строк заключается в том, что перед строковыми кавычками ставится символ `s`, +а перед любыми именами переменных ставится символ `$`. + +### Другие интерполяторы + +То `s`, что вы помещаете перед строкой, является лишь одним из возможных интерполяторов, предоставляемых Scala. + +Scala по умолчанию предоставляет три метода интерполяции строк: `s`, `f` и `raw`. +Кроме того, строковый интерполятор — это всего лишь специальный метод, и вы можете определить свой собственный. +Например, некоторые библиотеки баз данных определяют интерполятор `sql`, возвращающий запрос к базе данных. + +## Интерполятор `s` (`s`-строки) + +Добавление `s` перед любым строковым литералом позволяет использовать переменные непосредственно в строке. +Вы уже здесь видели пример: + +{% tabs example-2 %} +{% tab 'Scala 2 и 3' for=example-2 %} + +```scala +val name = "James" +val age = 30 +println(s"$name is $age years old") // "James is 30 years old" +``` + +{% endtab %} +{% endtabs %} + +Здесь переменные `$name` и `$age` заменяются в строке результатами вызова `name.toString` и `age.toString` соответственно. +`s`-строка будет иметь доступ ко всем переменным, в настоящее время находящимся в области видимости. + +Хотя это может показаться очевидным, важно здесь отметить, +что интерполяция строк _не_ будет выполняться в обычных строковых литералах: + +{% tabs example-3 %} +{% tab 'Scala 2 и 3' for=example-3 %} + +```scala +val name = "James" +val age = 30 +println("$name is $age years old") // "$name is $age years old" +``` + +{% endtab %} +{% endtabs %} + +Строковые интерполяторы также могут принимать произвольные выражения. +Например: + +{% tabs example-4 %} +{% tab 'Scala 2 и 3' for=example-4 %} + +```scala +println(s"2 + 2 = ${2 + 2}") // "2 + 2 = 4" +val x = -1 +println(s"x.abs = ${x.abs}") // "x.abs = 1" +``` + +{% endtab %} +{% endtabs %} + +Любое произвольное выражение может быть встроено в `${}`. + +Некоторые специальные символы необходимо экранировать при встраивании в строку. +Чтобы указать символ "знак доллара", вы можете удвоить его `$$`, как показано ниже: + +{% tabs example-5 %} +{% tab 'Scala 2 и 3' for=example-5 %} + +```scala +println(s"New offers starting at $$14.99") // "New offers starting at $14.99" +``` + +{% endtab %} +{% endtabs %} + +Двойные кавычки также необходимо экранировать. +Это можно сделать с помощью тройных кавычек, как показано ниже: + +{% tabs example-6 %} +{% tab 'Scala 2 и 3' for=example-6 %} + +```scala +println(s"""{"name":"James"}""") // `{"name":"James"}` +``` + +{% endtab %} +{% endtabs %} + +Наконец, все многострочные строковые литералы также могут быть интерполированы. + +{% tabs example-7 %} +{% tab 'Scala 2 и 3' for=example-7 %} + +```scala +println(s"""name: "$name", + |age: $age""".stripMargin) +``` + +Строка будет напечатана следующим образом: + +``` +name: "James" +age: 30 +``` + +{% endtab %} +{% endtabs %} + +## Интерполятор `f` (`f`-строки) + +Добавление `f` к любому строковому литералу позволяет создавать простые отформатированные строки, +аналогичные `printf` в других языках. +При использовании интерполятора `f` за всеми ссылками на переменные должна следовать строка формата в стиле `printf`, например `%d`. +Давайте посмотрим на пример: + +{% tabs example-8 %} +{% tab 'Scala 2 и 3' for=example-8 %} + +```scala +val height = 1.9d +val name = "James" +println(f"$name%s is $height%2.2f meters tall") // "James is 1.90 meters tall" +``` + +{% endtab %} +{% endtabs %} + +Интерполятор `f` типобезопасен. +Если вы попытаетесь передать в строку формата, который работает только для целых чисел, +значение `double`, компилятор выдаст ошибку. Например: + +{% tabs f-interpolator-error class=tabs-scala-version %} + +{% tab 'Scala 2' for=f-interpolator-error %} + +```scala +val height: Double = 1.9d + +scala> f"$height%4d" +<console>:9: error: type mismatch; + found : Double + required: Int + f"$height%4d" + ^ +``` + +{% endtab %} + +{% tab 'Scala 3' for=f-interpolator-error %} + +```scala +val height: Double = 1.9d + +scala> f"$height%4d" +-- Error: ---------------------------------------------------------------------- +1 |f"$height%4d" + | ^^^^^^ + | Found: (height : Double), Required: Int, Long, Byte, Short, BigInt +1 error found + +``` + +{% endtab %} +{% endtabs %} + +Интерполятор `f` использует утилиты форматирования строк, доступные в Java. +Форматы, разрешенные после символа `%`, описаны в [Formatter javadoc][java-format-docs]. +Если после определения переменной нет символа `%`, предполагается форматирование `%s` (`String`). + +Наконец, как и в Java, используйте `%%` для получения буквенного символа `%` в итоговой строке: + +{% tabs literal-percent %} +{% tab 'Scala 2 и 3' for=literal-percent %} + +```scala +println(f"3/19 is less than 20%%") // "3/19 is less than 20%" +``` + +{% endtab %} +{% endtabs %} + +### Интерполятор `raw` + +Интерполятор `raw` похож на интерполятор `s`, +за исключением того, что он не выполняет экранирование литералов внутри строки. +Вот пример обработанной строки: + +{% tabs example-9 %} +{% tab 'Scala 2 и 3' for=example-9 %} + +```scala +scala> s"a\nb" +res0: String = +a +b +``` + +{% endtab %} +{% endtabs %} + +Здесь строковый интерполятор `s` заменил символы `\n` символом переноса строки. +Интерполятор `raw` этого не делает. + +{% tabs example-10 %} +{% tab 'Scala 2 и 3' for=example-10 %} + +```scala +scala> raw"a\nb" +res1: String = a\nb +``` + +{% endtab %} +{% endtabs %} + +Интерполятор `raw` полезен тогда, когда вы хотите избежать преобразования таких выражений, как `\n`, в символ переноса строки. + +В дополнение к трем строковым интерполяторам пользователи могут определить свои собственные. + +## Расширенное использование + +Литерал `s"Hi $name"` анализируется Scala как _обрабатываемый_ строковый литерал. +Это означает, что компилятор выполняет некоторую дополнительную работу с этим литералом. +Особенности обработанных строк и интерполяции строк описаны в [SIP-11][sip-11]. +Вот краткий пример, который поможет проиллюстрировать, как они работают. + +### Пользовательские интерполяторы + +В Scala все обрабатываемые строковые литералы представляют собой простые преобразования кода. +Каждый раз, когда компилятор встречает обрабатываемый строковый литерал вида: + +{% tabs example-11 %} +{% tab 'Scala 2 и 3' for=example-11 %} + +```scala +id"string content" +``` + +{% endtab %} +{% endtabs %} + +он преобразует его в вызов метода (`id`) для экземпляра [StringContext](https://www.scala-lang.org/api/current/scala/StringContext.html). +Этот метод также может быть доступен в неявной области видимости. +Чтобы определить собственную интерполяцию строк, нужно создать неявный класс (Scala 2) +или метод расширения (Scala 3), который добавляет новый метод для `StringContext`. + +В качестве простого примера предположим, что у нас есть простой класс `Point` +и мы хотим создать собственный интерполятор, который преобразует `p"a,b"` в объект `Point`. + +{% tabs custom-interpolator-1 %} +{% tab 'Scala 2 и 3' for=custom-interpolator-1 %} + +```scala +case class Point(x: Double, y: Double) + +val pt = p"1,-2" // Point(1.0,-2.0) +``` + +{% endtab %} +{% endtabs %} + +Мы бы создали собственный интерполятор `p`, +сначала внедрив расширение `StringContext`, например, так: + +{% tabs custom-interpolator-2 class=tabs-scala-version %} + +{% tab 'Scala 2' for=custom-interpolator-2 %} + +```scala +implicit class PointHelper(val sc: StringContext) extends AnyVal { + def p(args: Any*): Point = ??? +} +``` + +**Примечание**. Важно расширить `AnyVal` в Scala 2.x, +чтобы предотвратить создание экземпляра класса во время выполнения при каждой интерполяции. +Дополнительную информацию см. в документации по [value class]({% link _overviews/core/value-classes.md %}). + +{% endtab %} + +{% tab 'Scala 3' for=custom-interpolator-2 %} + +```scala +extension (sc: StringContext) + def p(args: Any*): Point = ??? +``` + +{% endtab %} + +{% endtabs %} + +Как только это расширение окажется в области видимости и компилятор Scala обнаружит `p"some string"`, +то превратит `some string` в токены String, а каждую встроенную переменную в аргументы выражения. + +Например, `p"1, $someVar"` превратится в: + +{% tabs extension-desugaring class=tabs-scala-version %} + +{% tab 'Scala 2' for=extension-desugaring %} + +```scala +new StringContext("1, ", "").p(someVar) +``` + +Затем неявный класс используется для перезаписи следующим образом: + +```scala +new PointHelper(new StringContext("1, ", "")).p(someVar) +``` + +{% endtab %} + +{% tab 'Scala 3' for=extension-desugaring %} + +```scala +StringContext("1, ", "").p(someVar) +``` + +{% endtab %} + +{% endtabs %} + +В результате каждый из фрагментов обработанной строки отображается в элементе `StringContext.parts`, +а любые значения выражений в строке передаются в параметр метода `args`. + +### Пример реализации + +Простая реализация метода интерполяции для нашего `Point` может выглядеть примерно так, как показано ниже, +хотя более детализированный метод может иметь более точный контроль +над обработкой строки `parts` и выражения `args` вместо повторного использования интерполятора `s`. + +{% tabs naive-implementation class=tabs-scala-version %} + +{% tab 'Scala 2' for=naive-implementation %} + +```scala +implicit class PointHelper(val sc: StringContext) extends AnyVal { + def p(args: Double*): Point = { + // переиспользование интерполятора `s` и затем разбиение по ',' + val pts = sc.s(args: _*).split(",", 2).map { _.toDoubleOption.getOrElse(0.0) } + Point(pts(0), pts(1)) + } +} + +val x=12.0 + +p"1, -2" // Point(1.0, -2.0) +p"${x/5}, $x" // Point(2.4, 12.0) +``` + +{% endtab %} + +{% tab 'Scala 3' for=naive-implementation %} + +```scala +extension (sc: StringContext) + def p(args: Double*): Point = { + // переиспользование интерполятора `s` и затем разбиение по ',' + val pts = sc.s(args: _*).split(",", 2).map { _.toDoubleOption.getOrElse(0.0) } + Point(pts(0), pts(1)) + } + +val x=12.0 + +p"1, -2" // Point(1.0, -2.0) +p"${x/5}, $x" // Point(2.4, 12.0) +``` + +{% endtab %} +{% endtabs %} + +Хотя строковые интерполяторы изначально использовались для создания нескольких строковых форм, +использование пользовательских интерполяторов, как указано выше, +может обеспечить более мощное синтаксическое сокращение, +и сообщество уже использует этот синтаксис для таких вещей, +как расширение цвета терминала ANSI, выполнение SQL-запросов, +магические представления `$"identifier"` и многие другие. + +[java-format-docs]: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Formatter.html#detail + +[value-class]: {% link _overviews/core/value-classes.md %} +[sip-11]: {% link _sips/sips/string-interpolation.md %} diff --git a/_ru/scala3/book/types-generics.md b/_ru/scala3/book/types-generics.md index 653d6cacbd..5ece10b356 100644 --- a/_ru/scala3/book/types-generics.md +++ b/_ru/scala3/book/types-generics.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе представлены параметризованные типы в Scala 3. language: ru -num: 49 +num: 50 previous-page: types-inferred next-page: types-intersection --- diff --git a/_ru/scala3/book/types-inferred.md b/_ru/scala3/book/types-inferred.md index 70c44fcc9d..cadedc1ca0 100644 --- a/_ru/scala3/book/types-inferred.md +++ b/_ru/scala3/book/types-inferred.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе представлены и демонстрируются выводимые типы в Scala 3. language: ru -num: 48 +num: 49 previous-page: types-introduction next-page: types-generics --- diff --git a/_ru/scala3/book/types-intersection.md b/_ru/scala3/book/types-intersection.md index 6fa78e33ab..759855824b 100644 --- a/_ru/scala3/book/types-intersection.md +++ b/_ru/scala3/book/types-intersection.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе представлены пересечение типов в Scala 3. language: ru -num: 50 +num: 51 previous-page: types-generics next-page: types-union --- diff --git a/_ru/scala3/book/types-introduction.md b/_ru/scala3/book/types-introduction.md index 49b3cbfb49..65ecf50ebf 100644 --- a/_ru/scala3/book/types-introduction.md +++ b/_ru/scala3/book/types-introduction.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: chapter description: В этой главе представлено введение в типы и систему типов Scala 3. language: ru -num: 47 +num: 48 previous-page: fp-summary next-page: types-inferred --- diff --git a/_ru/scala3/book/types-union.md b/_ru/scala3/book/types-union.md index 35a0f440f6..6c28497626 100644 --- a/_ru/scala3/book/types-union.md +++ b/_ru/scala3/book/types-union.md @@ -7,7 +7,7 @@ overview-name: "Scala 3 — Book" type: section description: В этом разделе представлены объединение типов в Scala 3. language: ru -num: 51 +num: 52 previous-page: types-intersection next-page: --- From 853bd54d399d5ca987e42180e889ea7a7998b36f Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 3 Jul 2023 14:20:18 +0300 Subject: [PATCH 2655/3075] Update pattern-matching.md in russian (#2847) --- _ru/tour/pattern-matching.md | 255 ++++++++++++++++++++++++++++++----- _tour/pattern-matching.md | 2 +- 2 files changed, 223 insertions(+), 34 deletions(-) diff --git a/_ru/tour/pattern-matching.md b/_ru/tour/pattern-matching.md index 15e58ff983..91c6cf0867 100644 --- a/_ru/tour/pattern-matching.md +++ b/_ru/tour/pattern-matching.md @@ -12,7 +12,12 @@ prerequisite-knowledge: case-classes, string-interpolation, subtyping Сопоставление с примером (Pattern matching) - это механизм сравнения значений с определенным примером. При успешном совпадении значение может быть разложено на составные части. Мы рассматриваем сопоставление с примером, как более мощную версию `switch` оператора из Java. Eго также можно использовать вместо серии if/else выражений. ## Синтаксис + Синтаксис сопоставления с примером состоит из значения, ключевого слова `match` (сопоставить) и по крайней мере, одного пункта с примером `case`, с которым мы хотим сопоставить наше значение. + +{% tabs pattern-matching-1 class=tabs-scala-version %} +{% tab 'Scala 2' for=pattern-matching-1 %} + ```scala mdoc import scala.util.Random @@ -22,50 +27,99 @@ x match { case 0 => "zero" case 1 => "one" case 2 => "two" - case _ => "many" + case _ => "other" } ``` -Значение константы `x` выше представляет собой случайное целое число от 0 до 10. `x` становится левым операндом оператора `match`, а справа - выражением с четырьмя примерами (называемые еще _вариантами_). Последний вариант `_` - позволяет "поймать все оставшиеся варианты" т. е. для любого числа больше 2. + +{% endtab %} +{% tab 'Scala 3' for=pattern-matching-1 %} + +```scala +import scala.util.Random + +val x: Int = Random.nextInt(10) + +x match + case 0 => "zero" + case 1 => "one" + case 2 => "two" + case _ => "other" +``` + +{% endtab %} +{% endtabs %} + +Значение константы `x` выше представляет собой случайное целое число от 0 до 10. `x` становится левым операндом оператора `match`, а справа - выражением с четырьмя примерами (называемые еще _вариантами_). Последний вариант `_` - позволяет "поймать все оставшиеся варианты" т. е. для любого числа больше 2. Сопоставление с примером возвращает значение. + +{% tabs pattern-matching-2 class=tabs-scala-version %} +{% tab 'Scala 2' for=pattern-matching-2 %} + ```scala mdoc def matchTest(x: Int): String = x match { case 1 => "one" case 2 => "two" - case _ => "many" + case _ => "other" } -matchTest(3) // many -matchTest(1) // one +matchTest(3) // выводит "other" +matchTest(1) // выводит "one" ``` + +{% endtab %} + +{% tab 'Scala 3' for=pattern-matching-2 %} + +```scala +def matchTest(x: Int): String = x match + case 1 => "one" + case 2 => "two" + case _ => "other" + +matchTest(3) // выводит "other" +matchTest(1) // выводит "one" +``` + +{% endtab %} +{% endtabs %} + Это сопоставляющее выражение имеет тип String, так как все варианты сопоставления возвращают String. Поэтому функция `matchTest` возвращает String. ## Сопоставление с классами образцами -Классы образцы особенно полезны для сопоставления. +Классы образцы особенно полезны для сопоставления. + +{% tabs notification %} +{% tab 'Scala 2 и 3' for=notification %} ```scala mdoc -abstract class Notification +sealed trait Notification case class Email(sender: String, title: String, body: String) extends Notification case class SMS(caller: String, message: String) extends Notification case class VoiceRecording(contactName: String, link: String) extends Notification +``` +{% endtab %} +{% endtabs %} -``` -`Notification` - абстрактный суперкласс, от которого наследуются три конкретных типа реализаций классов образцов `Email`, `SMS`, и `VoiceRecording`. Теперь мы можем делать сопоставление с примером используя в качестве примера один из этих классов образцов. +`Notification` - запечатанный трейт, от которого наследуются три конкретных типа реализаций классов образцов `Email`, `SMS`, и `VoiceRecording`. Теперь мы можем делать сопоставление с примером используя в качестве примера один из этих классов образцов. При сопоставлении с классом образцом мы можем сразу извлекать параметры из которых состоит класс (благодаря автоматическому использованию [объекта экстрактора](extractor-objects.html)): -``` +{% tabs pattern-matching-4 class=tabs-scala-version %} +{% tab 'Scala 2' for=pattern-matching-4 %} + +```scala def showNotification(notification: Notification): String = { notification match { - case Email(email, title, _) => - s"You got an email from $email with title: $title" + case Email(sender, title, _) => + s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" case VoiceRecording(name, link) => - s"you received a Voice Recording from $name! Click the link to hear it: $link" + s"You received a Voice Recording from $name! Click the link to hear it: $link" } } val someSms = SMS("12345", "Are you there?") @@ -73,17 +127,46 @@ val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") println(showNotification(someSms)) // выводит "You got an SMS from 12345! Message: Are you there?" -println(showNotification(someVoiceRecording)) // выводит "you received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" +println(showNotification(someVoiceRecording)) // выводит "You received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" ``` + +{% endtab %} +{% tab 'Scala 3' for=pattern-matching-4 %} + +```scala +def showNotification(notification: Notification): String = + notification match + case Email(sender, title, _) => + s"You got an email from $sender with title: $title" + case SMS(number, message) => + s"You got an SMS from $number! Message: $message" + case VoiceRecording(name, link) => + s"You received a Voice Recording from $name! Click the link to hear it: $link" + +val someSms = SMS("12345", "Are you there?") +val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") + +println(showNotification(someSms)) // выводит "You got an SMS from 12345! Message: Are you there?" + +println(showNotification(someVoiceRecording)) // выводит "You received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" +``` + +{% endtab %} +{% endtabs %} + Функция `showNotification` принимает в качестве параметра абстрактный тип `Notification` который проверяет по образцам (т.е. выясняет, является ли он классом `Email`, `SMS` или `VoiceRecording`). В `case Email(email, title, _)`поля `email` и `title` используются в возвращаемом значении, а вот поле `body` игнорируется благодаря символу `_`. ## Ограждения примеров + Ограждения примеров - это просто логические выражения, которые используются для того, чтобы сделать выбор более специфичным (убрать лишние варианты). Просто добавьте `if <логическое выражение>` после примера. -``` +{% tabs pattern-matching-5 class=tabs-scala-version %} +{% tab 'Scala 2' for=pattern-matching-5 %} + +```scala def showImportantNotification(notification: Notification, importantPeopleInfo: Seq[String]): String = { notification match { - case Email(email, _, _) if importantPeopleInfo.contains(email) => + case Email(sender, _, _) if importantPeopleInfo.contains(sender) => "You got an email from special someone!" case SMS(number, _) if importantPeopleInfo.contains(number) => "You got an SMS from special someone!" @@ -94,23 +177,59 @@ def showImportantNotification(notification: Notification, importantPeopleInfo: S val importantPeopleInfo = Seq("867-5309", "jenny@gmail.com") -val someSms = SMS("867-5309", "Are you there?") +val someSms = SMS("123-4567", "Are you there?") val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") val importantEmail = Email("jenny@gmail.com", "Drinks tonight?", "I'm free after 5!") val importantSms = SMS("867-5309", "I'm here! Where are you?") -println(showImportantNotification(someSms, importantPeopleInfo)) -println(showImportantNotification(someVoiceRecording, importantPeopleInfo)) -println(showImportantNotification(importantEmail, importantPeopleInfo)) -println(showImportantNotification(importantSms, importantPeopleInfo)) +println(showImportantNotification(someSms, importantPeopleInfo)) // выводит "You got an SMS from 123-4567! Message: Are you there?" +println(showImportantNotification(someVoiceRecording, importantPeopleInfo)) // выводит "You received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" +println(showImportantNotification(importantEmail, importantPeopleInfo)) // выводит "You got an email from special someone!" + +println(showImportantNotification(importantSms, importantPeopleInfo)) // выводит "You got an SMS from special someone!" ``` +{% endtab %} +{% tab 'Scala 3' for=pattern-matching-5 %} + +```scala +def showImportantNotification(notification: Notification, importantPeopleInfo: Seq[String]): String = + notification match + case Email(sender, _, _) if importantPeopleInfo.contains(sender) => + "You got an email from special someone!" + case SMS(number, _) if importantPeopleInfo.contains(number) => + "You got an SMS from special someone!" + case other => + showNotification(other) // в этом варианте считается подходящими параметры любого типа. Значит этот вариант выполняется во всех случаях и передает исходный параметр в функцию showNotification + +val importantPeopleInfo = Seq("867-5309", "jenny@gmail.com") + +val someSms = SMS("123-4567", "Are you there?") +val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") +val importantEmail = Email("jenny@gmail.com", "Drinks tonight?", "I'm free after 5!") +val importantSms = SMS("867-5309", "I'm here! Where are you?") + +println(showImportantNotification(someSms, importantPeopleInfo)) // выводит "You got an SMS from 123-4567! Message: Are you there?" +println(showImportantNotification(someVoiceRecording, importantPeopleInfo)) // выводит "You received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" +println(showImportantNotification(importantEmail, importantPeopleInfo)) // выводит "You got an email from special someone!" + +println(showImportantNotification(importantSms, importantPeopleInfo)) // выводит "You got an SMS from special someone!" +``` + +{% endtab %} +{% endtabs %} + В варианте `case Email(email, _, _) if importantPeopleInfo.contains(email)`, пример сравнивается только если `email` находится в списке `importantPeopleInfo`. ## Сопоставление только с типом + Вы можете сопоставлять только по типу как в примере: + +{% tabs pattern-matching-6 class=tabs-scala-version %} +{% tab 'Scala 2' for=pattern-matching-6 %} + ```scala mdoc -abstract class Device +sealed trait Device case class Phone(model: String) extends Device { def screenOff = "Turning screen off" } @@ -118,29 +237,99 @@ case class Computer(model: String) extends Device { def screenSaverOn = "Turning screen saver on..." } -def goIdle(device: Device) = device match { +def goIdle(device: Device): String = device match { case p: Phone => p.screenOff case c: Computer => c.screenSaverOn } ``` + +{% endtab %} +{% tab 'Scala 3' for=pattern-matching-6 %} + +```scala +sealed trait Device +case class Phone(model: String) extends Device: + def screenOff = "Turning screen off" + +case class Computer(model: String) extends Device: + def screenSaverOn = "Turning screen saver on..." + + +def goIdle(device: Device): String = device match + case p: Phone => p.screenOff + case c: Computer => c.screenSaverOn +``` + +{% endtab %} +{% endtabs %} + метод `goIdle` реализует изменение поведения в зависимости от типа `Device`. По соглашению в качестве названия варианта используется первая буква типа (в данном случае `p` и `c`). -## Запечатанные классы -Трейты и классы могут быть помечены как `sealed` это означает, что подтипы должны быть объявлены в одном файле, гарантируя тем самым, что все подтипы будут известны. +## Запечатанные типы -```scala mdoc -sealed abstract class Furniture -case class Couch() extends Furniture -case class Chair() extends Furniture +Вы могли заметить, что в приведенных выше примерах базовые типы уточняются с помощью ключевого слова `sealed`. +Это обеспечивает дополнительную безопасность, поскольку компилятор проверяет, +указаны ли все случаи в выражении `match`, если базовым типом является `sealed`. + +Например, в методе `showNotification`, определенном выше, +если мы "забудем" один пример, скажем, `VoiceRecording`, +компилятор выдаст предупреждение: -def findPlaceToSit(piece: Furniture): String = piece match { - case a: Couch => "Lie on the couch" - case b: Chair => "Sit on the chair" +{% tabs pattern-matching-7 class=tabs-scala-version %} +{% tab 'Scala 2' for=pattern-matching-7 %} + +```scala +def showNotification(notification: Notification): String = { + notification match { + case Email(sender, title, _) => + s"You got an email from $sender with title: $title" + case SMS(number, message) => + s"You got an SMS from $number! Message: $message" + } } ``` -Это полезно для сопоставления с примером, ведь мы будем заранее знать все доступные варианты и нам не нужен вариант "все остальные". + +{% endtab %} +{% tab 'Scala 3' for=pattern-matching-7 %} + +```scala +def showNotification(notification: Notification): String = + notification match + case Email(sender, title, _) => + s"You got an email from $sender with title: $title" + case SMS(number, message) => + s"You got an SMS from $number! Message: $message" +``` + +{% endtab %} +{% endtabs %} + +Это определение выдает следующее предупреждение: + +``` +match may not be exhaustive. + +It would fail on pattern case: VoiceRecording(_, _) +``` + +Компилятор даже предоставляет примеры входных данных, которые потерпят неудачу при сопоставлении! + +С другой стороны, проверка полноты требует, чтобы вы определили все подтипы базового типа в том же файле, +что и базовый тип (иначе бы компилятор не знал все возможные варианты). +Например, если вы попытаетесь определить новый тип `Notification` вне файла, +который определяет `sealed trait Notfication`, это приведет к ошибке компиляции: + +``` +case class Telepathy(message: String) extends Notification + ^ + Cannot extend sealed trait Notification in a different source file +``` ## Замечания Сопоставление с примером наиболее полезно для сопоставления алгебраических типов, выраженных через [классы образцы](case-classes.html). Scala также позволяет создавать образцы независимо от классов образцов, через использование метода `unapply` в [объектах экстракторах](extractor-objects.html). + +## Дополнительные ресурсы + +- Дополнительная информация о сопоставлении с примером доступна [в книге Scala](/scala3/book/control-structures.html#match-expressions). diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index 4ef988529b..d66bf843e0 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -300,4 +300,4 @@ Scala also allows the definition of patterns independently of case classes, usin ## More resources -* More details on match expressions in the [Scala Book](/overviews/scala-book/match-expressions.html) +* More details on match expressions in the [Scala Book](/scala3/book/control-structures.html#match-expressions) From 40a5a48ea6e2e2b8248ae4b13ae14e752d491822 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Tue, 4 Jul 2023 19:56:29 +0300 Subject: [PATCH 2656/3075] Update for-comprehensions.md in russian --- _ru/tour/for-comprehensions.md | 93 ++++++++++++++++++++++++++++++---- _tour/for-comprehensions.md | 18 +++++-- 2 files changed, 97 insertions(+), 14 deletions(-) diff --git a/_ru/tour/for-comprehensions.md b/_ru/tour/for-comprehensions.md index 5a2c538769..01da58caf6 100644 --- a/_ru/tour/for-comprehensions.md +++ b/_ru/tour/for-comprehensions.md @@ -8,42 +8,90 @@ next-page: generic-classes previous-page: extractor-objects --- -Scala предлагает простую запись для выражения *последовательных преобразований*. Эти преобразования можно упростить используя специальный синтаксис `for выражения` (for comprehension), который записывается как `for (enumerators) yield e`, где `enumerators` относятся к списку перечислителей, разделенных точкой с запятой. Где отдельный такой "перечислитель" (*enumerator*) является либо генератором, который вводит новые переменные, либо фильтром. For-выражение вычисляет тело `e` (которое связанно с тем что генерирует *enumerator*) и возвращает последовательность вычислений. +Scala предлагает простую запись для выражения _последовательных преобразований_. Эти преобразования можно упростить используя специальный синтаксис `for выражения` (for comprehension), который записывается как `for (enumerators) yield e`, где `enumerators` относятся к списку перечислителей, разделенных точкой с запятой. Где отдельный такой "перечислитель" (_enumerator_) является либо генератором, который вводит новые переменные, либо фильтром. For-выражение вычисляет тело `e` (которое связанно с тем что генерирует _enumerator_) и возвращает последовательность вычислений. Вот пример: +{% tabs for-comprehensions-01 class=tabs-scala-version %} +{% tab 'Scala 2' for=for-comprehensions-01 %} + ```scala mdoc case class User(name: String, age: Int) -val userBase = List(User("Travis", 28), +val userBase = List( + User("Travis", 28), User("Kelly", 33), User("Jennifer", 44), User("Dennis", 23)) -val twentySomethings = for (user <- userBase if (user.age >=20 && user.age < 30)) - yield user.name // т. е. добавить результат к списку +val twentySomethings = + for (user <- userBase if user.age >=20 && user.age < 30) + yield user.name // т. е. добавить результат к списку -twentySomethings.foreach(name => println(name)) // выводит "Travis Dennis" +twentySomethings.foreach(println) // выводит "Travis Dennis" ``` - `for`-выражение, используется с оператором `yield`, на самом деле создает `List`. Потому что мы указали `yield user.name` (то есть вывести имя пользователя), получаем `List[String]`. `user <- userBase` и есть наш генератор, а `if (user.age >=20 && user.age < 30)` - это фильтр который отфильтровывает пользователей, не достигших 30-летнего возраста. + +{% endtab %} +{% tab 'Scala 3' for=for-comprehensions-01 %} + +```scala +case class User(name: String, age: Int) + +val userBase = List( + User("Travis", 28), + User("Kelly", 33), + User("Jennifer", 44), + User("Dennis", 23)) + +val twentySomethings = + for user <- userBase if user.age >=20 && user.age < 30 + yield user.name // т. е. добавить результат к списку + +twentySomethings.foreach(println) // выводит "Travis Dennis" +``` + +{% endtab %} +{% endtabs %} + +`for`-выражение, используется с оператором `yield`, на самом деле создает `List`. Потому что мы указали `yield user.name` (то есть вывести имя пользователя), получаем `List[String]`. `user <- userBase` и есть наш генератор, а `if (user.age >=20 && user.age < 30)` - это фильтр который отфильтровывает пользователей, не достигших 30-летнего возраста. Ниже приведен более сложный пример использования двух генераторов. Он вычисляет все пары чисел между `0` и `n-1`, сумма которых равна заданному значению `v`: +{% tabs for-comprehensions-02 class=tabs-scala-version %} +{% tab 'Scala 2' for=for-comprehensions-02 %} + ```scala mdoc def foo(n: Int, v: Int) = for (i <- 0 until n; - j <- i until n if i + j == v) + j <- 0 until n if i + j == v) yield (i, j) -foo(10, 10) foreach { +foo(10, 10).foreach { case (i, j) => - println(s"($i, $j) ") // выводит (1, 9) (2, 8) (3, 7) (4, 6) (5, 5) + println(s"($i, $j) ") // выводит (1, 9) (2, 8) (3, 7) (4, 6) (5, 5) (6, 4) (7, 3) (8, 2) (9, 1) } +``` + +{% endtab %} +{% tab 'Scala 3' for=for-comprehensions-02 %} + +```scala +def foo(n: Int, v: Int) = + for i <- 0 until n + j <- 0 until n if i + j == v + yield (i, j) +foo(10, 10).foreach { + (i, j) => println(s"($i, $j) ") // выводит (1, 9) (2, 8) (3, 7) (4, 6) (5, 5) (6, 4) (7, 3) (8, 2) (9, 1) +} ``` + +{% endtab %} +{% endtabs %} + Здесь `n == 10` и `v == 10`. На первой итерации `i == 0` и `j == 0` так `i + j != v` и поэтому ничего не выдается. `j` увеличивается еще в 9 раз, прежде чем `i` увеличивается до `1`. Без фильтра `if` будет просто напечатано следующее: -```scala +```scala (0, 0) (0, 1) (0, 2) (0, 3) (0, 4) (0, 5) (0, 6) (0, 7) (0, 8) (0, 9) (1, 0) ... ``` @@ -51,11 +99,34 @@ foo(10, 10) foreach { Вы можете обойтись без `yield` в for-выражении. В таком случае, результатом будет `Unit`. Это может быть полезным для выполнения кода основанного на побочных эффектах. Вот программа, эквивалентная предыдущей, но без использования `yield`: +{% tabs for-comprehensions-03 class=tabs-scala-version %} +{% tab 'Scala 2' for=for-comprehensions-03 %} + ```scala mdoc:nest def foo(n: Int, v: Int) = for (i <- 0 until n; - j <- i until n if i + j == v) + j <- 0 until n if i + j == v) println(s"($i, $j)") foo(10, 10) ``` + +{% endtab %} + +{% tab 'Scala 3' for=for-comprehensions-03 %} + +```scala +def foo(n: Int, v: Int) = + for i <- 0 until n + j <- 0 until n if i + j == v + do println(s"($i, $j)") + +foo(10, 10) +``` + +{% endtab %} +{% endtabs %} + +## Дополнительные ресурсы + +- Другие примеры "For comprehension" доступны [в книге Scala](/scala3/book/control-structures.html#for-expressions) diff --git a/_tour/for-comprehensions.md b/_tour/for-comprehensions.md index c945055083..a211380230 100644 --- a/_tour/for-comprehensions.md +++ b/_tour/for-comprehensions.md @@ -7,17 +7,18 @@ num: 19 next-page: generic-classes previous-page: extractor-objects -redirect_from: +redirect_from: - "/tutorials/tour/for-comprehensions.html" - "/tutorials/tour/sequence-comprehensions.html" --- -Scala offers a lightweight notation for expressing *sequence comprehensions*. Comprehensions have the form `for (enumerators) yield e`, where `enumerators` refers to a semicolon-separated list of enumerators. An *enumerator* is either a generator which introduces new variables, or it is a filter. A comprehension evaluates the body `e` for each binding generated by the enumerators and returns a sequence of these values. +Scala offers a lightweight notation for expressing _sequence comprehensions_. Comprehensions have the form `for (enumerators) yield e`, where `enumerators` refers to a semicolon-separated list of enumerators. An _enumerator_ is either a generator which introduces new variables, or it is a filter. A comprehension evaluates the body `e` for each binding generated by the enumerators and returns a sequence of these values. Here's an example: {% tabs for-comprehensions-01 class=tabs-scala-version %} {% tab 'Scala 2' for=for-comprehensions-01 %} + ```scala mdoc case class User(name: String, age: Int) @@ -33,8 +34,10 @@ val twentySomethings = twentySomethings.foreach(println) // prints Travis Dennis ``` + {% endtab %} {% tab 'Scala 3' for=for-comprehensions-01 %} + ```scala case class User(name: String, age: Int) @@ -50,6 +53,7 @@ val twentySomethings = twentySomethings.foreach(println) // prints Travis Dennis ``` + {% endtab %} {% endtabs %} @@ -59,6 +63,7 @@ Here is a more complicated example using two generators. It computes all pairs o {% tabs for-comprehensions-02 class=tabs-scala-version %} {% tab 'Scala 2' for=for-comprehensions-02 %} + ```scala mdoc def foo(n: Int, v: Int) = for (i <- 0 until n; @@ -73,6 +78,7 @@ foo(10, 10).foreach { {% endtab %} {% tab 'Scala 3' for=for-comprehensions-02 %} + ```scala def foo(n: Int, v: Int) = for i <- 0 until n @@ -83,10 +89,12 @@ foo(10, 10).foreach { (i, j) => println(s"($i, $j) ") // prints (1, 9) (2, 8) (3, 7) (4, 6) (5, 5) (6, 4) (7, 3) (8, 2) (9, 1) } ``` + {% endtab %} {% endtabs %} Here `n == 10` and `v == 10`. On the first iteration, `i == 0` and `j == 0` so `i + j != v` and therefore nothing is yielded. `j` gets incremented 9 more times before `i` gets incremented to `1`. Without the `if` guard, this would simply print the following: + ```scala (0, 0) (0, 1) (0, 2) (0, 3) (0, 4) (0, 5) (0, 6) (0, 7) (0, 8) (0, 9) (1, 0) ... ``` @@ -97,6 +105,7 @@ You can omit `yield` in a comprehension. In that case, comprehension will return {% tabs for-comprehensions-03 class=tabs-scala-version %} {% tab 'Scala 2' for=for-comprehensions-03 %} + ```scala mdoc:nest def foo(n: Int, v: Int) = for (i <- 0 until n; @@ -105,9 +114,11 @@ def foo(n: Int, v: Int) = foo(10, 10) ``` + {% endtab %} {% tab 'Scala 3' for=for-comprehensions-03 %} + ```scala def foo(n: Int, v: Int) = for i <- 0 until n @@ -116,9 +127,10 @@ def foo(n: Int, v: Int) = foo(10, 10) ``` + {% endtab %} {% endtabs %} ## More resources -* Other examples of "For comprehension" in the [Scala Book](/overviews/scala-book/for-expressions.html) +- Other examples of "For comprehension" in the [Scala Book](/scala3/book/control-structures.html#for-expressions) From ea6e79e40c8c2db540016689d021505b3858d74f Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Wed, 5 Jul 2023 10:06:21 +0300 Subject: [PATCH 2657/3075] Add types-adts-gadts.md and types-variance.md in russian (#2853) --- _overviews/scala3-book/types-adts-gadts.md | 2 +- _overviews/scala3-book/types-variance.md | 2 +- _ru/scala3/book/types-adts-gadts.md | 222 ++++++++++++++++ _ru/scala3/book/types-union.md | 2 +- _ru/scala3/book/types-variance.md | 283 +++++++++++++++++++++ 5 files changed, 508 insertions(+), 3 deletions(-) create mode 100644 _ru/scala3/book/types-adts-gadts.md create mode 100644 _ru/scala3/book/types-variance.md diff --git a/_overviews/scala3-book/types-adts-gadts.md b/_overviews/scala3-book/types-adts-gadts.md index a4f31e0040..204519c030 100644 --- a/_overviews/scala3-book/types-adts-gadts.md +++ b/_overviews/scala3-book/types-adts-gadts.md @@ -2,7 +2,7 @@ title: Algebraic Data Types type: section description: This section introduces and demonstrates algebraic data types (ADTs) in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 53 previous-page: types-union next-page: types-variance diff --git a/_overviews/scala3-book/types-variance.md b/_overviews/scala3-book/types-variance.md index 7aae5b5fac..deb2492e80 100644 --- a/_overviews/scala3-book/types-variance.md +++ b/_overviews/scala3-book/types-variance.md @@ -2,7 +2,7 @@ title: Variance type: section description: This section introduces and demonstrates variance in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 54 previous-page: types-adts-gadts next-page: types-opaque-types diff --git a/_ru/scala3/book/types-adts-gadts.md b/_ru/scala3/book/types-adts-gadts.md new file mode 100644 index 0000000000..199d7f1f33 --- /dev/null +++ b/_ru/scala3/book/types-adts-gadts.md @@ -0,0 +1,222 @@ +--- +layout: multipage-overview +title: Алгебраические типы данных +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлены и демонстрируются алгебраические типы данных (ADT) в Scala 3. +language: ru +num: 53 +previous-page: types-union +next-page: types-variance +--- + +<span class="tag tag-inline">Только в Scala 3</span> + +Алгебраические типы данных (ADT) могут быть созданы с помощью конструкции `enum`, +поэтому кратко рассмотрим перечисления, прежде чем рассматривать ADT. + +## Перечисления + +_Перечисление_ используется для определения типа, состоящего из набора именованных значений: + +```scala +enum Color: + case Red, Green, Blue +``` + +который можно рассматривать как сокращение для: + +```scala +enum Color: + case Red extends Color + case Green extends Color + case Blue extends Color +``` + +#### Параметры + +Перечисления могут быть параметризованы: + +```scala +enum Color(val rgb: Int): + case Red extends Color(0xFF0000) + case Green extends Color(0x00FF00) + case Blue extends Color(0x0000FF) +``` + +Таким образом, каждый из различных вариантов содержит параметр `rgb`, +которому присваивается соответствующее значение: + +```scala +println(Color.Green.rgb) // выводит 65280 +``` + +#### Пользовательские определения + +Перечисления также могут содержать пользовательские определения: + +```scala +enum Planet(mass: Double, radius: Double): + + private final val G = 6.67300E-11 + def surfaceGravity = G * mass / (radius * radius) + def surfaceWeight(otherMass: Double) = otherMass * surfaceGravity + + case Mercury extends Planet(3.303e+23, 2.4397e6) + case Venus extends Planet(4.869e+24, 6.0518e6) + case Earth extends Planet(5.976e+24, 6.37814e6) + // остальные 5 или 6 планет ... +``` + +Подобно классам и `case` классам, вы также можете определить сопутствующий объект для перечисления: + +```scala +object Planet: + def main(args: Array[String]) = + val earthWeight = args(0).toDouble + val mass = earthWeight / Earth.surfaceGravity + for (p <- values) + println(s"Your weight on $p is ${p.surfaceWeight(mass)}") +``` + +## Алгебраические типы данных (ADTs) + +Концепция `enum` является достаточно общей, +чтобы также поддерживать _алгебраические типы данных_ (ADT) и их обобщенную версию (GADT). +Вот пример, показывающий, как тип `Option` может быть представлен в виде АТД: + +```scala +enum Option[+T]: + case Some(x: T) + case None +``` + +В этом примере создается перечисление `Option` с параметром ковариантного типа `T`, +состоящим из двух вариантов `Some` и `None`. +`Some` _параметризуется_ значением параметра `x`; +это сокращение для написания `case` класса, расширяющего `Option`. +Поскольку `None` не параметризуется, то он считается обычным enum значением. + +Предложения `extends`, которые были опущены в предыдущем примере, также могут быть указаны явно: + +```scala +enum Option[+T]: + case Some(x: T) extends Option[T] + case None extends Option[Nothing] +``` + +Как и в случае с обычным `enum` значениями, варианты enum определяются в его сопутствующем объекте, +поэтому они называются `Option.Some` и `Option.None` (если только определения не «вытягиваются» при импорте): + +```scala +scala> Option.Some("hello") +val res1: t2.Option[String] = Some(hello) + +scala> Option.None +val res2: t2.Option[Nothing] = None +``` + +Как и в других случаях использования перечисления, АТД могут определять дополнительные методы. +Например, вот снова `Option`, с методом `isDefined` и конструктором `Option(...)` в сопутствующем объекте: + +```scala +enum Option[+T]: + case Some(x: T) + case None + + def isDefined: Boolean = this match + case None => false + case Some(_) => true + +object Option: + def apply[T >: Null](x: T): Option[T] = + if (x == null) None else Some(x) +``` + +Перечисления и АТД используют одну и ту же синтаксическую конструкцию, +поэтому их можно рассматривать просто как два конца спектра, и вполне допустимо создавать гибриды. +Например, приведенный ниже код реализует `Color` либо с тремя значениями перечисления, +либо с параметризованным вариантом, принимающим значение RGB: + +```scala +enum Color(val rgb: Int): + case Red extends Color(0xFF0000) + case Green extends Color(0x00FF00) + case Blue extends Color(0x0000FF) + case Mix(mix: Int) extends Color(mix) +``` + +#### Рекурсивные перечисления + +До сих пор все перечисления, которые мы определяли, состояли из различных вариантов значений или case классов. +Перечисления также могут быть рекурсивными, как показано в приведенном ниже примере кодирования натуральных чисел: + +```scala +enum Nat: + case Zero + case Succ(n: Nat) +``` + +Например, значение `Succ(Succ(Zero))` представляет число `2` в унарной кодировке. +Списки могут быть определены похожим образом: + +```scala +enum List[+A]: + case Nil + case Cons(head: A, tail: List[A]) +``` + +## Обобщенные алгебраические типы данных (GADT) + +Приведенная выше нотация для перечислений очень краткая +и служит идеальной отправной точкой для моделирования ваших типов данных. +Поскольку мы всегда можем быть более подробными, то можем выразить гораздо более мощные типы: +обобщенные алгебраические типы данных (GADT). + +Вот пример GADT, в котором параметр типа (`T`) указывает на тип содержимого, хранящегося в `Box`: + +```scala +enum Box[T](contents: T): + case IntBox(n: Int) extends Box[Int](n) + case BoolBox(b: Boolean) extends Box[Boolean](b) +``` + +Сопоставление с образцом с конкретным конструктором (`IntBox` или `BoolBox`) восстанавливает информацию о типе: + +```scala +def extract[T](b: Box[T]): T = b match + case IntBox(n) => n + 1 + case BoolBox(b) => !b +``` + +Безопасно возвращать `Int` в первом случае, так как мы знаем из сопоставления с образцом, что ввод был `IntBox`. + +## Дешугаризация перечислений + +_Концептуально_ перечисления можно рассматривать как определение запечатанного класса вместе с сопутствующим ему объектом. +Давайте посмотрим на дешугаризацию нашего перечисления `Color`: + +```scala +sealed abstract class Color(val rgb: Int) extends scala.reflect.Enum +object Color: + case object Red extends Color(0xFF0000) { def ordinal = 0 } + case object Green extends Color(0x00FF00) { def ordinal = 1 } + case object Blue extends Color(0x0000FF) { def ordinal = 2 } + case class Mix(mix: Int) extends Color(mix) { def ordinal = 3 } + + def fromOrdinal(ordinal: Int): Color = ordinal match + case 0 => Red + case 1 => Green + case 2 => Blue + case _ => throw new NoSuchElementException(ordinal.toString) +``` + +Заметьте, что вышеописанная дешугаризация упрощена, и мы намеренно опускаем [некоторые детали][desugar-enums]. + +В то время как перечисления можно кодировать вручную с помощью других конструкций, +использование перечислений является более кратким, +а также включает несколько дополнительных утилит (таких, как метод `fromOrdinal`). + +[desugar-enums]: {{ site.scala3ref }}/enums/desugarEnums.html diff --git a/_ru/scala3/book/types-union.md b/_ru/scala3/book/types-union.md index 6c28497626..6185d59e12 100644 --- a/_ru/scala3/book/types-union.md +++ b/_ru/scala3/book/types-union.md @@ -9,7 +9,7 @@ description: В этом разделе представлены объедин language: ru num: 52 previous-page: types-intersection -next-page: +next-page: types-adts-gadts --- <span class="tag tag-inline">Только в Scala 3</span> diff --git a/_ru/scala3/book/types-variance.md b/_ru/scala3/book/types-variance.md new file mode 100644 index 0000000000..d4a4eaa7b7 --- /dev/null +++ b/_ru/scala3/book/types-variance.md @@ -0,0 +1,283 @@ +--- +layout: multipage-overview +title: Вариантность +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлена и демонстрируется вариантность в Scala 3. +language: ru +num: 54 +previous-page: types-adts-gadts +next-page: +--- + +_Вариантность_ (_variance_) параметра типа управляет подтипом параметризованных типов (таких, как классы или трейты). + +Чтобы объяснить вариантность, давайте рассмотрим следующие определения типов: + +{% tabs types-variance-1 %} +{% tab 'Scala 2 и 3' %} + +```scala +trait Item { def productNumber: String } +trait Buyable extends Item { def price: Int } +trait Book extends Buyable { def isbn: String } + +``` + +{% endtab %} +{% endtabs %} + +Предположим также следующие параметризованные типы: + +{% tabs types-variance-2 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-2 %} + +```scala +// пример инвариантного типа +trait Pipeline[T] { + def process(t: T): T +} + +// пример ковариантного типа +trait Producer[+T] { + def make: T +} + +// пример контрвариантного типа +trait Consumer[-T] { + def take(t: T): Unit +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=types-variance-2 %} + +```scala +// пример инвариантного типа +trait Pipeline[T]: + def process(t: T): T + +// пример ковариантного типа +trait Producer[+T]: + def make: T + +// пример контрвариантного типа +trait Consumer[-T]: + def take(t: T): Unit +``` + +{% endtab %} +{% endtabs %} + +В целом существует три режима вариантности (variance): + +- **инвариант** (invariant) — значение по умолчанию, написанное как `Pipeline[T]` +- **ковариантный** (covariant) — помечен знаком `+`, например `Producer[+T]` +- **контравариантный** (contravariant) — помечен знаком `-`, как в `Consumer[-T]` + +Подробнее рассмотрим, что означает и как используется эта аннотация. + +### Инвариантные типы + +По умолчанию такие типы, как `Pipeline`, инвариантны в своем аргументе типа (в данном случае `T`). +Это означает, что такие типы, как `Pipeline[Item]`, `Pipeline[Buyable]` и `Pipeline[Book]`, _не являются подтипами_ друг друга. + +И это правильно! Предположим, что следующий метод использует два значения (`b1`, `b2`) типа `Pipeline[Buyable]` +и передает свой аргумент `b` методу `process` при его вызове на `b1` и `b2`: + +{% tabs types-variance-3 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-3 %} + +```scala +def oneOf( + p1: Pipeline[Buyable], + p2: Pipeline[Buyable], + b: Buyable +): Buyable = { + val b1 = p1.process(b) + val b2 = p2.process(b) + if (b1.price < b2.price) b1 else b2 + } +``` + +{% endtab %} + +{% tab 'Scala 3' for=types-variance-3 %} + +```scala +def oneOf( + p1: Pipeline[Buyable], + p2: Pipeline[Buyable], + b: Buyable +): Buyable = + val b1 = p1.process(b) + val b2 = p2.process(b) + if b1.price < b2.price then b1 else b2 +``` + +{% endtab %} +{% endtabs %} + +Теперь вспомните, что у нас есть следующие _отношения подтипов_ между нашими типами: + +{% tabs types-variance-4 %} +{% tab 'Scala 2 и 3' %} + +```scala +Book <: Buyable <: Item +``` + +{% endtab %} +{% endtabs %} + +Мы не можем передать `Pipeline[Book]` методу `oneOf`, +потому что в реализации `oneOf` мы вызываем `p1` и `p2` со значением типа `Buyable`. +`Pipeline[Book]` ожидает `Book`, что потенциально может вызвать ошибку времени выполнения. + +Мы не можем передать `Pipeline[Item]`, потому что вызов `process` обещает вернуть `Item`; +однако мы должны вернуть `Buyable`. + +#### Почему Инвариант? + +На самом деле тип `Pipeline` должен быть инвариантным, +так как он использует свой параметр типа `T` _и в качестве_ аргумента, _и в качестве_ типа возвращаемого значения. +По той же причине некоторые типы в библиотеке коллекций Scala, такие как `Array` или `Set`, также являются _инвариантными_. + +### Ковариантные типы + +В отличие от `Pipeline`, который является инвариантным, +тип `Producer` помечается как **ковариантный** (covariant) путем добавления к параметру типа префикса `+`. +Это допустимо, так как параметр типа используется только в качестве типа _возвращаемого_ значения. + +Пометка типа как ковариантного означает, что мы можем передать (или вернуть) `Producer[Book]` там, +где ожидается `Producer[Buyable]`. И на самом деле, это разумно. +Тип `Producer[Buyable].make` только обещает _вернуть_ `Buyable`. +Но для пользователей `make`, так же допустимо принять `Book`, который является подтипом `Buyable`, +то есть это _по крайней мере_ `Buyable`. + +Это иллюстрируется следующим примером, где функция `makeTwo` ожидает `Producer[Buyable]`: + +{% tabs types-variance-5 %} +{% tab 'Scala 2 и 3' %} + +```scala +def makeTwo(p: Producer[Buyable]): Int = + p.make.price + p.make.price +``` + +{% endtab %} +{% endtabs %} + +Допустимо передать в `makeTwo` производителя книг: + +{% tabs types-variance-6 %} +{% tab 'Scala 2 и 3' %} + +```scala +val bookProducer: Producer[Book] = ??? +makeTwo(bookProducer) +``` + +{% endtab %} +{% endtabs %} + +Вызов `price` в рамках `makeTwo` по-прежнему действителен и для `Book`. + +#### Ковариантные типы для неизменяемых контейнеров + +Ковариантность чаще всего встречается при работе с неизменяемыми контейнерами, такими как `List`, `Seq`, `Vector` и т.д. + +Например, `List` и `Vector` определяются приблизительно так: + +{% tabs types-variance-7 %} +{% tab 'Scala 2 и 3' %} + +```scala +class List[+A] ... +class Vector[+A] ... +``` + +{% endtab %} +{% endtabs %} + +Таким образом, можно использовать `List[Book]` там, где ожидается `List[Buyable]`. +Это также интуитивно имеет смысл: если ожидается коллекция вещей, которые можно купить, +то вполне допустимо получить коллекцию книг. +В примере выше у книг есть дополнительный метод `isbn`, но дополнительные возможности можно игнорировать. + +### Контравариантные типы + +В отличие от типа `Producer`, который помечен как ковариантный, +тип `Consumer` помечен как **контравариантный** (contravariant) путем добавления к параметру типа префикса `-`. +Это допустимо, так как параметр типа используется только _в позиции аргумента_. + +Пометка его как контравариантного означает, что можно передать (или вернуть) `Consumer[Item]` там, +где ожидается `Consumer[Buyable]`. +То есть у нас есть отношение подтипа `Consumer[Item] <: Consumer[Buyable]`. +Помните, что для типа `Producer` все было наоборот, и у нас был `Producer[Buyable] <: Producer[Item]`. + +И в самом деле, это разумно. Метод `Consumer[Item].take` принимает `Item`. +Как вызывающий `take`, мы также можем предоставить `Buyable`, который будет с радостью принят `Consumer[Item]`, +поскольку `Buyable` — это подтип `Item`, то есть, _по крайней мере_, `Item`. + +#### Контравариантные типы для потребителей + +Контравариантные типы встречаются гораздо реже, чем ковариантные типы. +Как и в нашем примере, вы можете думать о них как о «потребителях». +Наиболее важным типом, помеченным как контравариантный, с которым можно столкнуться, является тип функций: + +{% tabs types-variance-8 class=tabs-scala-version %} +{% tab 'Scala 2' for=types-variance-8 %} + +```scala +trait Function[-A, +B] { + def apply(a: A): B +} +``` + +{% endtab %} + +{% tab 'Scala 3' for=types-variance-8 %} + +```scala +trait Function[-A, +B]: + def apply(a: A): B +``` + +{% endtab %} +{% endtabs %} + +Тип аргумента `A` помечен как контравариантный `A` — он использует значения типа `A`. +Тип результата `B`, напротив, помечен как ковариантный — он создает значения типа `B`. + +Вот несколько примеров, иллюстрирующих отношения подтипов, вызванные аннотациями вариантности функций: + +{% tabs types-variance-9 %} +{% tab 'Scala 2 и 3' %} + +```scala +val f: Function[Buyable, Buyable] = b => b + +// OK - допустимо вернуть Buyable там, где ожидается Item +val g: Function[Buyable, Item] = f + +// OK - допустимо передать аргумент Book туда, где ожидается Buyable +val h: Function[Book, Buyable] = f +``` + +{% endtab %} +{% endtabs %} + +## Резюме + +В этом разделе были рассмотрены три различных вида вариантности: + +- **Producers** обычно ковариантны и помечают свой параметр типа со знаком `+`. + Это справедливо и для неизменяемых коллекций. +- **Consumers** обычно контравариантны и помечают свой параметр типа со знаком `-`. +- Типы, которые являются **одновременно** производителями и потребителями, + должны быть инвариантными и не требуют какой-либо маркировки для параметра своего типа. + В эту категорию, в частности, попадают изменяемые коллекции, такие как `Array`. From 1b6d17f4ddbb578e1c09f0c585528fdd2bd2f6cd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Fri, 7 Jul 2023 19:38:16 +0300 Subject: [PATCH 2658/3075] Update lower-type-bounds.md and upper-type-bounds.md in russian --- _ru/tour/lower-type-bounds.md | 106 +++++++++++++++++++++++++--------- _ru/tour/upper-type-bounds.md | 46 +++++++++++++++ 2 files changed, 124 insertions(+), 28 deletions(-) diff --git a/_ru/tour/lower-type-bounds.md b/_ru/tour/lower-type-bounds.md index ac9e08bd59..3d3b22edb9 100644 --- a/_ru/tour/lower-type-bounds.md +++ b/_ru/tour/lower-type-bounds.md @@ -9,57 +9,107 @@ previous-page: upper-type-bounds prerequisite-knowledge: upper-type-bounds, generics, variance --- -В то время как [верхнее ограничение типа](upper-type-bounds.html) ограничивает тип до подтипа стороннего типа, *нижнее ограничение типа* объявляют тип супертипом стороннего типа. Термин `B >: A` выражает, то что параметр типа `B` или абстрактный тип `B` относится к супертипу типа `A`. В большинстве случаев `A` будет задавать тип класса, а `B` задавать тип метода. +В то время как [верхнее ограничение типа](upper-type-bounds.html) ограничивает тип до подтипа стороннего типа, _нижнее ограничение типа_ объявляют тип супертипом стороннего типа. Термин `B >: A` выражает, то что параметр типа `B` или абстрактный тип `B` относится к супертипу типа `A`. В большинстве случаев `A` будет задавать тип класса, а `B` задавать тип метода. Вот пример, где это полезно: +{% tabs upper-type-bounds_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=upper-type-bounds_1 %} + ```scala mdoc:fail -trait Node[+B] { - def prepend(elem: B): Node[B] +trait List[+A] { + def prepend(elem: A): NonEmptyList[A] = NonEmptyList(elem, this) } -case class ListNode[+B](h: B, t: Node[B]) extends Node[B] { - def prepend(elem: B): ListNode[B] = ListNode(elem, this) - def head: B = h - def tail: Node[B] = t -} +case class NonEmptyList[+A](head: A, tail: List[A]) extends List[A] -case class Nil[+B]() extends Node[B] { - def prepend(elem: B): ListNode[B] = ListNode(elem, this) -} +object Nil extends List[Nothing] +``` + +{% endtab %} +{% tab 'Scala 3' for=upper-type-bounds_1 %} + +```scala +trait List[+A]: + def prepend(elem: A): NonEmptyList[A] = NonEmptyList(elem, this) + +case class NonEmptyList[+A](head: A, tail: List[A]) extends List[A] + +object Nil extends List[Nothing] ``` -В данной программе реализован связанный список. `Nil` представляет пустой список. Класс `ListNode` - это узел, который содержит элемент типа `B` (`head`) и ссылку на остальную часть списка (`tail`). Класс `Node` и его подтипы ковариантны, потому что у нас указанно `+B`. +{% endtab %} +{% endtabs %} + +В данной программе реализован связанный список. `Nil` представляет пустой список. Класс `NonEmptyList` - это узел, который содержит элемент типа `A` (`head`) и ссылку на остальную часть списка (`tail`). `trait List` и его подтипы ковариантны, потому что у нас указанно `+A`. -Однако эта программа _не компилируется_, потому что параметр `elem` в `prepend` имеет тип `B`, который мы объявили *ко*вариантным. Так это не работает, потому что функции *контр*вариантны в типах своих параметров и *ко*вариантны в типах своих результатов. +Однако эта программа _не компилируется_, потому что параметр `elem` в `prepend` имеет тип `A`, который мы объявили *ко*вариантным. Так это не работает, потому что функции *контр*вариантны в типах своих параметров и *ко*вариантны в типах своих результатов. -Чтобы исправить это, необходимо перевернуть вариантность типа параметра `elem` в `prepend`. Для этого мы вводим новый тип для параметра `U`, у которого тип `B` указан в качестве нижней границы типа. +Чтобы исправить это, необходимо перевернуть вариантность типа параметра `elem` в `prepend`. Для этого мы вводим новый тип для параметра `B`, у которого тип `A` указан в качестве нижней границы типа. + +{% tabs upper-type-bounds_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=upper-type-bounds_2 %} ```scala mdoc -trait Node[+B] { - def prepend[U >: B](elem: U): Node[U] +trait List[+A] { + def prepend[B >: A](elem: B): NonEmptyList[B] = NonEmptyList(elem, this) } -case class ListNode[+B](h: B, t: Node[B]) extends Node[B] { - def prepend[U >: B](elem: U): ListNode[U] = ListNode(elem, this) - def head: B = h - def tail: Node[B] = t -} +case class NonEmptyList[+A](head: A, tail: List[A]) extends List[A] -case class Nil[+B]() extends Node[B] { - def prepend[U >: B](elem: U): ListNode[U] = ListNode(elem, this) -} +object Nil extends List[Nothing] +``` + +{% endtab %} +{% tab 'Scala 3' for=upper-type-bounds_2 %} + +```scala +trait List[+A]: + def prepend[B >: A](elem: B): NonEmptyList[B] = NonEmptyList(elem, this) + +case class NonEmptyList[+A](head: A, tail: List[A]) extends List[A] + +object Nil extends List[Nothing] ``` +{% endtab %} +{% endtabs %} + Теперь мы можем сделать следующее: + +{% tabs upper-type-bounds_3 %} +{% tab 'Scala 2 и 3' for=upper-type-bounds_3 %} + ```scala mdoc trait Bird case class AfricanSwallow() extends Bird case class EuropeanSwallow() extends Bird +val africanSwallows: List[AfricanSwallow] = Nil.prepend(AfricanSwallow()) +val swallowsFromAntarctica: List[Bird] = Nil +val someBird: Bird = EuropeanSwallow() + +// присвоить птицам (birds) африканских ласточек (swallows) +val birds: List[Bird] = africanSwallows -val africanSwallowList= ListNode[AfricanSwallow](AfricanSwallow(), Nil()) -val birdList: Node[Bird] = africanSwallowList -birdList.prepend(EuropeanSwallow()) +// добавляем новую птицу к африканским ласточкам, `B` - это `Bird` +val someBirds = africanSwallows.prepend(someBird) + +// добавляем европейскую ласточку к птицам +val moreBirds = birds.prepend(EuropeanSwallow()) + +// соединяем вместе различных ласточек, `B` - это `Bird`, потому что это общий супертип для обоих типов ласточек +val allBirds = africanSwallows.prepend(EuropeanSwallow()) + +// но тут ошибка! добавление списка птиц слишком расширяет тип аргументов. -Xlint предупредит! +val error = moreBirds.prepend(swallowsFromAntarctica) // List[Object] ``` -`Node[Bird]` может быть присвоен `africanSwallowList` , но затем может добавлять и `EuropeanSwallow`. + +{% endtab %} +{% endtabs %} + +Параметр ковариантного типа позволяет `birds` получать значение `africanSwallows`. + +Тип, связанный с параметром типа `prepend`, позволяет добавлять различные разновидности ласточек и получать более абстрактный тип: вместо `List[AfricanSwallow]`, мы получаем `List[Bird]`. + +Используйте `-Xlint`, чтобы предупредить, если аргумент предполагаемого типа слишком абстрактен. diff --git a/_ru/tour/upper-type-bounds.md b/_ru/tour/upper-type-bounds.md index 2bfe19f96e..7a9238016e 100644 --- a/_ru/tour/upper-type-bounds.md +++ b/_ru/tour/upper-type-bounds.md @@ -12,6 +12,9 @@ previous-page: variances В Scala [параметры типа](generic-classes.html) и [члены абстрактного типа](abstract-type-members.html) могут быть ограничены определенными диапазонами. Такие диапазоны ограничивают конкретные значение типа и, возможно, предоставляют больше информации о членах таких типов. _Верхнее ограничение типа_ `T <: A` указывает на то что тип `T` относится к подтипу типа `A`. Приведем пример, демонстрирующий верхнее ограничение для типа класса `PetContainer`: +{% tabs upper-type-bounds class=tabs-scala-version %} +{% tab 'Scala 2' for=upper-type-bounds %} + ```scala mdoc abstract class Animal { def name: String @@ -39,10 +42,53 @@ val dogContainer = new PetContainer[Dog](new Dog) val catContainer = new PetContainer[Cat](new Cat) ``` +{% endtab %} +{% tab 'Scala 3' for=upper-type-bounds %} + +```scala +abstract class Animal: + def name: String + +abstract class Pet extends Animal + +class Cat extends Pet: + override def name: String = "Cat" + +class Dog extends Pet: + override def name: String = "Dog" + +class Lion extends Animal: + override def name: String = "Lion" + +class PetContainer[P <: Pet](p: P): + def pet: P = p + +val dogContainer = PetContainer[Dog](Dog()) +val catContainer = PetContainer[Cat](Cat()) +``` + +{% endtab %} +{% endtabs %} + +{% tabs upper-type-bounds_error class=tabs-scala-version %} +{% tab 'Scala 2' for=upper-type-bounds_error %} + ```scala mdoc:fail // это не скомпилируется val lionContainer = new PetContainer[Lion](new Lion) ``` + +{% endtab %} +{% tab 'Scala 3' for=upper-type-bounds_error %} + +```scala +// это не скомпилируется +val lionContainer = PetContainer[Lion](Lion()) +``` + +{% endtab %} +{% endtabs %} + Класс `PetContainer` принимает тип `P`, который должен быть подтипом `Pet`. `Dog` и `Cat` - это подтипы `Pet`, поэтому мы можем создать новые `PetContainer[Dog]` и `PetContainer[Cat]`. Однако, если мы попытаемся создать `PetContainer[Lion]`, то получим следующую ошибку: `type arguments [Lion] do not conform to class PetContainer's type parameter bounds [P <: Pet]` From 501535e1c888fa88381ff5db5befe71eb5d1a119 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Fri, 7 Jul 2023 08:43:40 +0300 Subject: [PATCH 2659/3075] Update variances.md in russian --- _ru/tour/variances.md | 297 +++++++++++++++++++++++++++++++----------- 1 file changed, 221 insertions(+), 76 deletions(-) diff --git a/_ru/tour/variances.md b/_ru/tour/variances.md index 3a56ae2e6d..c122728f51 100644 --- a/_ru/tour/variances.md +++ b/_ru/tour/variances.md @@ -8,7 +8,14 @@ next-page: upper-type-bounds previous-page: generic-classes --- -Вариантность (Variances) - это указание определенной специфики взаимосвязи между связанными типам. Scala поддерживает вариантную аннотацию типов у [обобщенных классов](generic-classes.html), что позволяет им быть ковариантными, контрвариантными или инвариантными (если нет никакого указания на вариантность). Использование вариантности в системе типов позволяет устанавливать понятные взаимосвязи между сложными типами, в то время как отсутствие вариантности может ограничить повторное использование абстракции класса. +Вариантность (Variances) - это указание определенной специфики взаимосвязи между связанными типами. +Scala поддерживает вариантную аннотацию типов у [обобщенных классов](generic-classes.html), +что позволяет им быть ковариантными, контрвариантными или инвариантными (если нет никакого указания на вариантность). +Использование вариантности в системе типов позволяет устанавливать понятные взаимосвязи между сложными типами, +в то время как отсутствие вариантности может ограничить повторное использование абстракции класса. + +{% tabs variances_1 %} +{% tab 'Scala 2 и 3' for=variances_1 %} ```scala mdoc class Foo[+A] // ковариантный класс @@ -16,11 +23,28 @@ class Bar[-A] // контравариантный класс class Baz[A] // инвариантный класс ``` -### Ковариантность +{% endtab %} +{% endtabs %} -Параметр типа `A` обобщенного класса можно сделать ковариантным с помощью аннотации `+A`. Для некоторого класса `List[+A]`, указание `A` в виде коварианта подразумевает, что для двух типов `A` и `B`, где `A` является подтипом `B`, `List[A]` представляет собой подтип `List[B]`. Что позволяет нам создавать очень полезные и интуитивно понятные взаимоотношения между типами с использованием обобщений (generics). +### Инвариантность -Рассмотрим простую структуру классов: +По умолчанию параметры типа в Scala инвариантны: отношения подтипа между параметрами типа не отражаются в параметризованном типе. +Чтобы понять, почему это работает именно так, рассмотрим простой параметризованный тип, изменяемый контейнер. + +{% tabs invariance_1 %} +{% tab 'Scala 2 и 3' for=invariance_1 %} + +```scala mdoc +class Box[A](var content: A) +``` + +{% endtab %} +{% endtabs %} + +Мы собираемся поместить в него значения типа `Animal` (животное). Этот тип определяется следующим образом: + +{% tabs invariance_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=invariance_2 %} ```scala mdoc abstract class Animal { @@ -30,120 +54,241 @@ case class Cat(name: String) extends Animal case class Dog(name: String) extends Animal ``` -И `Cat` (кошка) и `Dog`(собака) являются подтипами `Animal`(животное). Стандартная библиотека Scala имеет обобщенный неизменяемый тип `List[+A]`, где параметр типа `A` является ковариантным. Это означает, что `List[Cat]` - это `List[Animal]`, а `List[Dog]` - это также `List[Animal]`. Интуитивно понятно, что список кошек и список собак - это список животных и вы должны быть в состоянии заменить любого из них на `List[Animal]`. +{% endtab %} +{% tab 'Scala 3' for=invariance_2 %} + +```scala +abstract class Animal: + def name: String + +case class Cat(name: String) extends Animal +case class Dog(name: String) extends Animal +``` + +{% endtab %} +{% endtabs %} -В следующем примере метод `printAnimalNames` принимает в качестве аргумента список животных и выводит их имена в новой строке. Если бы `List[A]` не был ковариантным, последние два вызова метода не компилировались бы, что сильно ограничило бы полезность метода `printAnimalNames`. +Можно сказать, что `Cat` (кот) - это подтип `Animal`, `Dog` (собака) - также подтип `Animal`. +Это означает, что следующее допустимо и пройдет проверку типов: + +{% tabs invariance_3 %} +{% tab 'Scala 2 и 3' for=invariance_3 %} ```scala mdoc -object CovarianceTest extends App { - def printAnimalNames(animals: List[Animal]): Unit = { - animals.foreach { animal => - println(animal.name) - } - } +val myAnimal: Animal = Cat("Felix") +``` - val cats: List[Cat] = List(Cat("Whiskers"), Cat("Tom")) - val dogs: List[Dog] = List(Dog("Fido"), Dog("Rex")) +{% endtab %} +{% endtabs %} - printAnimalNames(cats) - // Whiskers - // Tom +А контейнеры? +Является ли `Box[Cat]` подтипом `Box[Animal]`, как `Cat` подтип `Animal`? +На первый взгляд может показаться, что это правдоподобно, +но если мы попытаемся это сделать, компилятор сообщит об ошибке: - printAnimalNames(dogs) - // Fido - // Rex -} +{% tabs invariance_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=invariance_4 %} + +```scala mdoc:fail +val myCatBox: Box[Cat] = new Box[Cat](Cat("Felix")) +val myAnimalBox: Box[Animal] = myCatBox // не компилируется +val myAnimal: Animal = myAnimalBox.content ``` -### Контрвариантность +{% endtab %} +{% tab 'Scala 3' for=invariance_4 %} -Параметр типа `A` обобщенного класса можно сделать контрвариантным с помощью аннотации `-A`. Это создает схожее, но противоположное ковариантным, взаимоотношения между типом параметра и подтипами класса. То есть, для некого класса `Writer[-A]`, указание `A` контрвариантным подразумевает, что для двух типов `A` и `B` где `A` является подтипом `B`, `Writer[B]` является подтипом `Writer[A]`. +```scala +val myCatBox: Box[Cat] = Box[Cat](Cat("Felix")) +val myAnimalBox: Box[Animal] = myCatBox // не компилируется +val myAnimal: Animal = myAnimalBox.content +``` -Рассмотрим классы `Cat`, `Dog`, и `Animal`, описанные выше для следующего примера: +{% endtab %} +{% endtabs %} -```scala mdoc -abstract class Printer[-A] { - def print(value: A): Unit -} +Почему это может быть проблемой? +Мы можем достать из контейнера кота, и это все еще животное, не так ли? Ну да. +Но это не все, что мы можем сделать. Мы также можем заменить в контейнере кота другим животным. + +{% tabs invariance_5 %} +{% tab 'Scala 2 и 3' for=invariance_5 %} + +```scala + myAnimalBox.content = Dog("Fido") ``` -`Printer[A]` - это простой класс, который знает, как распечатать некоторый тип `A`. Давайте определим подклассы для конкретных типов: +{% endtab %} +{% endtabs %} -```scala mdoc -class AnimalPrinter extends Printer[Animal] { - def print(animal: Animal): Unit = - println("The animal's name is: " + animal.name) -} +Теперь в контейнере для животных есть собака. +Все в порядке, вы можете поместить собак в контейнеры для животных, потому что собаки — это животные. +Но наш контейнер для животных — это контейнер для котов! Нельзя поместить собаку в контейнер с котом. +Если бы мы могли, а затем попытались достать кота из нашего кошачьего контейнера, +он оказался бы собакой, нарушающей целостность типа. -class CatPrinter extends Printer[Cat] { - def print(cat: Cat): Unit = - println("The cat's name is: " + cat.name) -} +{% tabs invariance_6 %} +{% tab 'Scala 2 и 3' for=invariance_6 %} + +```scala + val myCat: Cat = myCatBox.content // myCat стал бы собакой Fido! ``` -Если `Printer[Cat]` знает, как распечатать любой класс `Cat` в консоли, а `Printer[Animal]` знает, как распечатать любое `Animal` в консоли, то разумно если `Printer[Animal]` также знает, как распечатать любое `Cat`. Обратного отношения нет, потому что `Printer[Cat]` не знает, как распечатать любой `Animal` в консоли. Чтоб иметь возможность заменить `Printer[Cat]` на `Printer[Animal]`, необходимо `Printer[A]` сделать контрвариантным. +{% endtab %} +{% endtabs %} -```scala mdoc -object ContravarianceTest extends App { - val myCat: Cat = Cat("Boots") +Из этого мы должны сделать вывод, что между `Box[Cat]` и `Box[Animal]` не может быть отношения подтипа, +хотя между `Cat` и `Animal` это отношение есть. - def printMyCat(printer: Printer[Cat]): Unit = { - printer.print(myCat) - } +### Ковариантность - val catPrinter: Printer[Cat] = new CatPrinter - val animalPrinter: Printer[Animal] = new AnimalPrinter +Проблема, с которой мы столкнулись выше, заключается в том, +что, поскольку мы можем поместить собаку в контейнер для животных, +контейнер для кошек не может быть контейнером для животных. - printMyCat(catPrinter) - printMyCat(animalPrinter) -} -``` +Но что, если мы не сможем поместить собаку в контейнер? +Тогда мы бы могли просто вернуть нашего кота, и это не проблема, чтобы можно было следовать отношениям подтипа. +Оказывается, это действительно то, что мы можем сделать. -Результатом работы этой программы будет: +{% tabs covariance_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=covariance_1 %} +```scala mdoc +class ImmutableBox[+A](val content: A) +val catbox: ImmutableBox[Cat] = new ImmutableBox[Cat](Cat("Felix")) +val animalBox: ImmutableBox[Animal] = catbox // теперь код компилируется ``` -The cat's name is: Boots -The animal's name is: Boots + +{% endtab %} +{% tab 'Scala 3' for=covariance_1 %} + +```scala +class ImmutableBox[+A](val content: A) +val catbox: ImmutableBox[Cat] = ImmutableBox[Cat](Cat("Felix")) +val animalBox: ImmutableBox[Animal] = catbox // теперь код компилируется ``` -### Инвариантность +{% endtab %} +{% endtabs %} + +Мы говорим, что `ImmutableBox` _ковариантен_ в `A` - на это указывает `+` перед `A`. + +Более формально это дает нам следующее отношение: +если задано некоторое `class Cov[+T]`, то если `A` является подтипом `B`, то `Cov[A]` является подтипом `Cov[B]`. +Это позволяет создавать очень полезные и интуитивно понятные отношения подтипов с помощью обобщения. -Обобщенные классы в Scala по умолчанию являются инвариантными. Это означает, что они не являются ни ковариантными, ни контрвариантными друг другу. В контексте следующего примера класс `Container` является инвариантным. Между `Container[Cat]` и `Container[Animal]`, нет ни прямой, ни обратной взаимосвязи. +В следующем менее надуманном примере метод `printAnimalNames` принимает список животных в качестве аргумента +и печатает их имена с новой строки. +Если бы `List[A]` не был бы ковариантным, последние два вызова метода не компилировались бы, +что сильно ограничивало бы полезность метода `printAnimalNames`. + +{% tabs covariance_2 %} +{% tab 'Scala 2 и 3' for=covariance_2 %} ```scala mdoc -class Container[A](value: A) { - private var _value: A = value - def getValue: A = _value - def setValue(value: A): Unit = { - _value = value +def printAnimalNames(animals: List[Animal]): Unit = + animals.foreach { + animal => println(animal.name) } -} + +val cats: List[Cat] = List(Cat("Whiskers"), Cat("Tom")) +val dogs: List[Dog] = List(Dog("Fido"), Dog("Rex")) + +// печатает: "Whiskers", "Tom" +printAnimalNames(cats) + +// печатает: "Fido", "Rex" +printAnimalNames(dogs) ``` -Может показаться что `Container[Cat]` должен также являться и `Container[Animal]`, но позволить мутабельному обобщенному классу быть ковариантным было бы небезопасно. В данном примере очень важно, чтобы `Container` был инвариантным. Предположим, что `Container` на самом деле был ковариантным, что-то вроде этого могло случиться: +{% endtab %} +{% endtabs %} + +### Контрвариантность + +Мы видели, что можем достичь ковариантности, убедившись, что не сможем поместить что-то в ковариантный тип, а только что-то получить. +Что, если бы у нас было наоборот, что-то, что можно положить, но нельзя вынуть? +Такая ситуация возникает, если у нас есть что-то вроде сериализатора, который принимает значения типа `A` +и преобразует их в сериализованный формат. +{% tabs contravariance_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=contravariance_1 %} + +```scala mdoc +abstract class Serializer[-A] { + def serialize(a: A): String +} + +val animalSerializer: Serializer[Animal] = new Serializer[Animal] { + def serialize(animal: Animal): String = s"""{ "name": "${animal.name}" }""" +} +val catSerializer: Serializer[Cat] = animalSerializer +catSerializer.serialize(Cat("Felix")) ``` -val catContainer: Container[Cat] = new Container(Cat("Felix")) -val animalContainer: Container[Animal] = catContainer -animalContainer.setValue(Dog("Spot")) -val cat: Cat = catContainer.getValue // Ой, мы бы закончили присвоением собаки к коту. + +{% endtab %} +{% tab 'Scala 3' for=contravariance_1 %} + +```scala +abstract class Serializer[-A]: + def serialize(a: A): String + +val animalSerializer: Serializer[Animal] = Serializer[Animal](): + def serialize(animal: Animal): String = s"""{ "name": "${animal.name}" }""" + +val catSerializer: Serializer[Cat] = animalSerializer +catSerializer.serialize(Cat("Felix")) ``` -К счастью, компилятор остановит нас прежде, чем мы зайдем так далеко. +{% endtab %} +{% endtabs %} -### Другие Примеры +Мы говорим, что `Serializer` _контравариантен_ в `A`, и на это указывает `-` перед `A`. +Более общий сериализатор является подтипом более конкретного сериализатора. -Другим примером, который может помочь понять вариантность, является трейт `Function1[-T, +R]` из стандартной библиотеки Scala. `Function1` представляет собой функцию с одним параметром, где первый тип `T` представляет собой тип параметра, а второй тип `R` представляет собой тип результата. Функция `Function1` является контрвариантной в рамках типа принимаемого аргумента, а ковариантной - в рамках возвращаемого типа. Для этого примера мы будем использовать явное обозначение типа `A =>B` чтоб продемонстрировать `Function1[A, B]`. +Более формально это дает нам обратное отношение: если задано некоторое `class Contra[-T]`, +то если `A` является подтипом `B`, `Contra[B]` является подтипом `Contra[A]`. -Рассмотрим схожий пример `Cat`, `Dog`, `Animal` в той же взаимосвязи, что и раньше, плюс следующее: +### Неизменность и вариантность -```scala mdoc -abstract class SmallAnimal extends Animal -case class Mouse(name: String) extends SmallAnimal +Неизменяемость является важной частью проектного решения, связанного с использованием вариантности. +Например, коллекции Scala систематически различают [изменяемые и неизменяемые коллекции](https://docs.scala-lang.org/ru/overviews/collections-2.13/overview.html). +Основная проблема заключается в том, что ковариантная изменяемая коллекция может нарушить безопасность типов. +Вот почему `List` - ковариантная коллекция, а `scala.collection.mutable.ListBuffer` - инвариантная коллекция. +`List` - это коллекция в `package scala.collection.immutable`, поэтому она гарантированно будет неизменяемой для всех. +Принимая во внимание, что `ListBuffer` изменяем, то есть вы можете обновлять, добавлять или удалять элементы `ListBuffer`. + +Чтобы проиллюстрировать проблему ковариантности и изменчивости, предположим, +что `ListBuffer` ковариантен, тогда следующий проблемный пример скомпилируется (на самом деле он не компилируется): + +{% tabs immutability_and_variance_2 %} +{% tab 'Scala 2 и 3' %} + +```scala mdoc:fail +import scala.collection.mutable.ListBuffer + +val bufInt: ListBuffer[Int] = ListBuffer[Int](1,2,3) +val bufAny: ListBuffer[Any] = bufInt +bufAny(0) = "Hello" +val firstElem: Int = bufInt(0) ``` -Предположим, что мы работаем с функциями, которые принимают типы животных и возвращают типы еды. Если мы хотим `Cat => SmallAnimal` (потому что кошки едят маленьких животных), но вместо этого мы получим функцию `Animal => Mouse`, то наша программа все равно будет работать. Интуитивно функция `Animal => Mouse` все равно будет принимать `Cat` в качестве аргумента, т.к. `Cat` является `Animal`, и возвращать `Mouse` - который также является и `SmallAnimal`. Поскольку мы можем безопасно заменить первое вторым, можно сказать, что `Animal => Mouse` аналогично `Cat => SmallAnimal`. +{% endtab %} +{% endtabs %} + +Если бы приведенный выше код был бы возможен, то вычисление `firstElem` завершилась бы ошибкой с `ClassCastException`, +потому что `bufInt(0)` теперь содержит `String`, а не `Int`. + +Инвариантность `ListBuffer` означает, что `ListBuffer[Int]` не является подтипом `ListBuffer[Any]`, +несмотря на то, что `Int` является подтипом `Any`, +и поэтому `bufInt` не может быть присвоен в качестве значения `bufAny`. ### Сравнение с другими языками -В языках, похожих на Scala, разные способы поддержки вариантности. Например, указания вариантности в Scala очень похожи на то, как это делается в C#, где такие указания добавляются при объявлении абстракции класса (вариантность при объявлении). Однако в Java, указание вариантности задается непосредственно при использовании абстракции класса (вариантность при использовании). +В языках, похожих на Scala, разные способы поддержки вариантности. +Например, указания вариантности в Scala очень похожи на то, как это делается в C#, +где такие указания добавляются при объявлении абстракции класса (вариантность при объявлении). +Однако в Java, указание вариантности задается непосредственно при использовании абстракции класса (вариантность при использовании). + +Тенденция Scala к неизменяемым типам делает ковариантные и контравариантные типы более распространенными, +чем в других языках, поскольку изменяемый универсальный тип должен быть инвариантным. From 1ebe20893c00de6fa02c0c922cbb15454d23d8b4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Thu, 6 Jul 2023 20:10:30 +0300 Subject: [PATCH 2660/3075] Add types pages in russian --- .../scala3-book/types-dependent-function.md | 2 +- _overviews/scala3-book/types-opaque-types.md | 2 +- _overviews/scala3-book/types-others.md | 2 +- _overviews/scala3-book/types-structural.md | 2 +- _ru/scala3/book/types-dependent-function.md | 178 ++++++++++++++++++ _ru/scala3/book/types-opaque-types.md | 174 +++++++++++++++++ _ru/scala3/book/types-others.md | 27 +++ _ru/scala3/book/types-structural.md | 114 +++++++++++ _ru/scala3/book/types-variance.md | 2 +- 9 files changed, 498 insertions(+), 5 deletions(-) create mode 100644 _ru/scala3/book/types-dependent-function.md create mode 100644 _ru/scala3/book/types-opaque-types.md create mode 100644 _ru/scala3/book/types-others.md create mode 100644 _ru/scala3/book/types-structural.md diff --git a/_overviews/scala3-book/types-dependent-function.md b/_overviews/scala3-book/types-dependent-function.md index 5a74b28dd0..92bae2d227 100644 --- a/_overviews/scala3-book/types-dependent-function.md +++ b/_overviews/scala3-book/types-dependent-function.md @@ -2,7 +2,7 @@ title: Dependent Function Types type: section description: This section introduces and demonstrates dependent function types in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 57 previous-page: types-structural next-page: types-others diff --git a/_overviews/scala3-book/types-opaque-types.md b/_overviews/scala3-book/types-opaque-types.md index 0bc606d007..b3a3edf0a7 100644 --- a/_overviews/scala3-book/types-opaque-types.md +++ b/_overviews/scala3-book/types-opaque-types.md @@ -2,7 +2,7 @@ title: Opaque Types type: section description: This section introduces and demonstrates opaque types in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 55 previous-page: types-variance next-page: types-structural diff --git a/_overviews/scala3-book/types-others.md b/_overviews/scala3-book/types-others.md index 3e70eb46f6..13ac06ed60 100644 --- a/_overviews/scala3-book/types-others.md +++ b/_overviews/scala3-book/types-others.md @@ -2,7 +2,7 @@ title: Other Types type: section description: This section mentions other advanced types in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 58 previous-page: types-dependent-function next-page: ca-contextual-abstractions-intro diff --git a/_overviews/scala3-book/types-structural.md b/_overviews/scala3-book/types-structural.md index 5dfc73d1af..246f9f1270 100644 --- a/_overviews/scala3-book/types-structural.md +++ b/_overviews/scala3-book/types-structural.md @@ -2,7 +2,7 @@ title: Structural Types type: section description: This section introduces and demonstrates structural types in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 56 previous-page: types-opaque-types next-page: types-dependent-function diff --git a/_ru/scala3/book/types-dependent-function.md b/_ru/scala3/book/types-dependent-function.md new file mode 100644 index 0000000000..43cfba3a7c --- /dev/null +++ b/_ru/scala3/book/types-dependent-function.md @@ -0,0 +1,178 @@ +--- +layout: multipage-overview +title: Зависимые типы функций +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлены и демонстрируются зависимые типы функций в Scala 3. +language: ru +num: 57 +previous-page: types-structural +next-page: types-others +--- + +_Зависимый тип функции_ (_dependent function type_) описывает типы функций, +где тип результата может зависеть от значений параметров функции. +Концепция зависимых типов и типов зависимых функций является более продвинутой, +и обычно с ней сталкиваются только при разработке собственных библиотек или использовании расширенных библиотек. + +## Зависимые типы методов + +Рассмотрим следующий пример гетерогенной базы данных, в которой могут храниться значения разных типов. +Ключ содержит информацию о типе соответствующего значения: + +```scala +trait Key { type Value } + +trait DB { + def get(k: Key): Option[k.Value] // зависимый метод +} +``` + +Получив ключ, метод `get` предоставляет доступ к карте и потенциально возвращает сохраненное значение типа `k.Value`. +Мы можем прочитать этот _path-dependent type_ как: +"в зависимости от конкретного типа аргумента `k` возвращается соответствующее значение". + +Например, у нас могут быть следующие ключи: + +```scala +object Name extends Key { type Value = String } +object Age extends Key { type Value = Int } +``` + +Вызовы метода `get` теперь будут возвращать такие типы: + +```scala +val db: DB = ... +val res1: Option[String] = db.get(Name) +val res2: Option[Int] = db.get(Age) +``` + +Вызов метода `db.get(Name)` возвращает значение типа `Option[String]`, +а вызов `db.get(Age)` возвращает значение типа `Option[Int]`. +Тип возвращаемого значения _зависит_ от конкретного типа аргумента, переданного для `get` — отсюда и название _dependent type_. + +## Зависимые типы функций + +Как видно выше, в Scala 2 уже была поддержка зависимых типов методов. +Однако создание значений типа `DB` довольно громоздко: + +```scala +// создание пользователя DB +def user(db: DB): Unit = + db.get(Name) ... db.get(Age) + +// создание экземпляра DB и передача его `user` +user(new DB { + def get(k: Key): Option[k.Value] = ... // реализация DB +}) +``` + +Необходимо вручную создать анонимный внутренний класс `DB`, реализующий метод `get`. +Для кода, основанного на создании множества различных экземпляров `DB`, это очень утомительно. + +Трейт `DB` имеет только один абстрактный метод `get`. +Было бы неплохо использовать в этом месте лямбда-синтаксис? + +```scala +user { k => + ... // реализация DB +} +``` + +На самом деле, в Scala 3 теперь это возможно! Можно определить `DB` как _зависимый тип функции_: + +```scala +type DB = (k: Key) => Option[k.Value] +// ^^^^^^^^^^^^^^^^^^^^^^^^^^^ +// зависимый тип функции +``` + +Учитывая это определение `DB`, можно использовать приведенный выше вызов `user`. + +Подробнее о внутреннем устройстве зависимых типов функций можно прочитать в [справочной документации][ref]. + +## Практический пример: числовые выражения + +Предположим, что необходимо определить модуль, который абстрагируется от внутреннего представления чисел. +Это может быть полезно, например, для реализации библиотек для автоматического дифференцирования. + +Начнем с определения модуля для чисел: + +```scala +trait Nums: + // тип Num оставлен абстрактным + type Num + + // некоторые операции над числами + def lit(d: Double): Num + def add(l: Num, r: Num): Num + def mul(l: Num, r: Num): Num +``` + +> Здесь опускается конкретная реализация `Nums`, но в качестве упражнения можно реализовать `Nums`, +> назначив тип `Num = Double` и реализуя соответствующие методы. + +Программа, использующая числовую абстракцию, теперь имеет следующий тип: + +```scala +type Prog = (n: Nums) => n.Num => n.Num + +val ex: Prog = nums => x => nums.add(nums.lit(0.8), x) +``` + +Тип функции, которая вычисляет производную, наподобие `ex`: + +```scala +def derivative(input: Prog): Double +``` + +Учитывая удобство зависимых типов функций, вызов этой функции в разных программах прост: + +```scala +derivative { nums => x => x } +derivative { nums => x => nums.add(nums.lit(0.8), x) } +// ... +``` + +Напомним, что та же программа в приведенной выше кодировке будет выглядеть так: + +```scala +derivative(new Prog { + def apply(nums: Nums)(x: nums.Num): nums.Num = x +}) +derivative(new Prog { + def apply(nums: Nums)(x: nums.Num): nums.Num = nums.add(nums.lit(0.8), x) +}) +// ... +``` + +#### Комбинация с контекстными функциями + +Комбинация методов расширения, [контекстных функций][ctx-fun] и зависимых функций обеспечивает мощный инструмент для разработчиков библиотек. +Например, мы можем уточнить нашу библиотеку, как указано выше, следующим образом: + +```scala +trait NumsDSL extends Nums: + extension (x: Num) + def +(y: Num) = add(x, y) + def *(y: Num) = mul(x, y) + +def const(d: Double)(using n: Nums): n.Num = n.lit(d) + +type Prog = (n: NumsDSL) ?=> n.Num => n.Num +// ^^^ +// prog теперь - контекстная функция, +// которая неявно предполагает NumsDSL в контексте вызова + +def derivative(input: Prog): Double = ... + +// теперь нам не нужно упоминать Nums в приведенных ниже примерах +derivative { x => const(1.0) + x } +derivative { x => x * x + const(2.0) } +// ... +``` + +[ref]: {{ site.scala3ref }}/new-types/dependent-function-types.html +[ctx-fun]: {{ site.scala3ref }}/contextual/context-functions.html diff --git a/_ru/scala3/book/types-opaque-types.md b/_ru/scala3/book/types-opaque-types.md new file mode 100644 index 0000000000..54522dafd9 --- /dev/null +++ b/_ru/scala3/book/types-opaque-types.md @@ -0,0 +1,174 @@ +--- +layout: multipage-overview +title: Непрозрачные типы +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлены и демонстрируются непрозрачные типы в Scala 3. +language: ru +num: 55 +previous-page: types-variance +next-page: types-structural +--- + +В Scala 3 _непрозрачные псевдонимы типов_ (_opaque type aliases_) обеспечивают абстракции типов без каких-либо **накладных расходов**. + +## Накладные расходы на абстракцию + +Предположим, что необходимо определить модуль, +предлагающий арифметические операции над числами, которые представлены их логарифмами. +Это может быть полезно для повышения точности, когда числовые значения очень большие или близкие к нулю. + +Поскольку важно отличать "обычные" `Double` от чисел, хранящихся в виде их логарифмов, введем класс `Logarithm`: + +```scala +class Logarithm(protected val underlying: Double): + def toDouble: Double = math.exp(underlying) + def + (that: Logarithm): Logarithm = + // здесь используется метод apply сопутствующего объекта + Logarithm(this.toDouble + that.toDouble) + def * (that: Logarithm): Logarithm = + new Logarithm(this.underlying + that.underlying) + +object Logarithm: + def apply(d: Double): Logarithm = new Logarithm(math.log(d)) +``` + +Метод `apply` сопутствующего объекта позволяет создавать значения типа `Logarithm`, +которые можно использовать следующим образом: + +```scala +val l2 = Logarithm(2.0) +val l3 = Logarithm(3.0) +println((l2 * l3).toDouble) // выводит 6.0 +println((l2 + l3).toDouble) // выводит 4.999... +``` + +В то время как класс `Logarithm` предлагает хорошую абстракцию для значений `Double`, +которые хранятся в этой конкретной логарифмической форме, +это накладывает серьезные накладные расходы на производительность: +для каждой отдельной математической операции нужно извлекать значение `underlying`, +а затем снова обернуть его в новый экземпляр `Logarithm`. + +## Модульные абстракции + +Рассмотрим другой подход к реализации той же библиотеки. +На этот раз вместо того, чтобы определять `Logarithm` как класс, определяем его с помощью _псевдонима типа_. +Во-первых, зададим абстрактный интерфейс модуля: + +```scala +trait Logarithms: + + type Logarithm + + // операции на Logarithm + def add(x: Logarithm, y: Logarithm): Logarithm + def mul(x: Logarithm, y: Logarithm): Logarithm + + // функции конвертации между Double и Logarithm + def make(d: Double): Logarithm + def extract(x: Logarithm): Double + + // методы расширения, для вызова `add` и `mul` в качестве "методов" на Logarithm + extension (x: Logarithm) + def toDouble: Double = extract(x) + def + (y: Logarithm): Logarithm = add(x, y) + def * (y: Logarithm): Logarithm = mul(x, y) +``` + +Теперь давайте реализуем этот абстрактный интерфейс, задав тип `Logarithm` равным `Double`: + +```scala +object LogarithmsImpl extends Logarithms: + + type Logarithm = Double + + // операции на Logarithm + def add(x: Logarithm, y: Logarithm): Logarithm = make(x.toDouble + y.toDouble) + def mul(x: Logarithm, y: Logarithm): Logarithm = x + y + + // функции конвертации между Double и Logarithm + def make(d: Double): Logarithm = math.log(d) + def extract(x: Logarithm): Double = math.exp(x) +``` + +В рамках реализации `LogarithmsImpl` уравнение `Logarithm = Double` позволяет реализовать различные методы. + +#### Дырявые абстракции + +Однако эта абстракция немного "дырява". +Мы должны убедиться, что всегда программируем _только_ с абстрактным интерфейсом `Logarithms` +и никогда не используем `LogarithmsImpl` напрямую. +Прямое использование `LogarithmsImpl` сделало бы равенство `Logarithm = Double` видимым для пользователя, +который может случайно использовать `Double` там, где ожидается логарифмическое удвоение. +Например: + +```scala +import LogarithmsImpl.* +val l: Logarithm = make(1.0) +val d: Double = l // проверка типов ДОЗВОЛЯЕТ равенство! +``` + +Необходимость разделения модуля на абстрактный интерфейс и реализацию может быть полезной, +но также требует больших усилий, чтобы просто скрыть детали реализации `Logarithm`. +Программирование с использованием абстрактного модуля `Logarithms` может быть очень утомительным +и часто требует использования дополнительных функций, таких как типы, зависящие от пути, как в следующем примере: + +```scala +def someComputation(L: Logarithms)(init: L.Logarithm): L.Logarithm = ... +``` + +#### Накладные расходы упаковки/распаковки + +Абстракции типов, такие как `type Logarithm`, [стираются](https://www.scala-lang.org/files/archive/spec/2.13/03-types.html#type-erasure) +в соответствии с их привязкой (`Any` - в нашем случае). +То есть, хотя нам не нужно вручную переносить и разворачивать значение `Double`, +все равно будут некоторые накладные расходы, связанные с упаковкой примитивного типа `Double`. + +## Непрозрачные типы + +Вместо того чтобы вручную разбивать компонент `Logarithms` на абстрактную часть и на конкретную реализацию, +можно просто использовать opaque типы для достижения аналогичного эффекта: + +```scala +object Logarithms: +//vvvvvv это важное различие! + opaque type Logarithm = Double + + object Logarithm: + def apply(d: Double): Logarithm = math.log(d) + + extension (x: Logarithm) + def toDouble: Double = math.exp(x) + def + (y: Logarithm): Logarithm = Logarithm(math.exp(x) + math.exp(y)) + def * (y: Logarithm): Logarithm = x + y +``` + +Тот факт, что `Logarithm` совпадает с `Double`, известен только в области, где он определен, +которая в приведенном выше примере соответствует объекту `Logarithms`. +Равенство `Logarithm = Double` может использоваться для реализации методов (например, `*` и `toDouble`). + +Однако вне модуля тип `Logarithm` полностью инкапсулирован или «непрозрачен». +Для пользователей `Logarithm`-а невозможно обнаружить, что `Logarithm` на самом деле реализован как `Double`: + +```scala +import Logarithms.* +val log2 = Logarithm(2.0) +val log3 = Logarithm(3.0) +println((log2 * log3).toDouble) // выводит 6.0 +println((log2 + log3).toDouble) // выводит 4.999... + +val d: Double = log2 // ERROR: Found Logarithm required Double +``` + +Несмотря на то, что мы абстрагировались от `Logarithm`, абстракция предоставляется бесплатно: +поскольку существует только одна реализация, во время выполнения не будет накладных расходов +на упаковку для примитивных типов, таких как `Double`. + +### Обзор непрозрачных типов + +Непрозрачные типы предлагают надежную абстракцию над деталями реализации, не накладывая расходов на производительность. +Как показано выше, непрозрачные типы удобны в использовании и очень хорошо интегрируются с [функцией методов расширения][extension]. + +[extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} diff --git a/_ru/scala3/book/types-others.md b/_ru/scala3/book/types-others.md new file mode 100644 index 0000000000..a1024a7970 --- /dev/null +++ b/_ru/scala3/book/types-others.md @@ -0,0 +1,27 @@ +--- +layout: multipage-overview +title: Другие типы +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе упоминаются другие расширенные типы в Scala 3. +language: ru +num: 58 +previous-page: types-dependent-function +next-page: +--- + +В Scala есть несколько других расширенных типов, которые не показаны в этой книге, в том числе: + +- Лямбда-типы +- Типы соответствия +- Экзистенциальные типы +- Типы высшего порядка +- Синглтон-типы +- Типы уточнения +- Вид полиморфизма + +Дополнительные сведения об этих типах см. в [Справочной документации][reference]. + +[reference]: {{ site.scala3ref }}/overview.html diff --git a/_ru/scala3/book/types-structural.md b/_ru/scala3/book/types-structural.md new file mode 100644 index 0000000000..911bc02cbe --- /dev/null +++ b/_ru/scala3/book/types-structural.md @@ -0,0 +1,114 @@ +--- +layout: multipage-overview +title: Структурные типы +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе представлены и демонстрируются структурные типы в Scala 3. +language: ru +num: 56 +previous-page: types-opaque-types +next-page: types-dependent-function +--- + +Некоторые варианты использования, такие как моделирование доступа к базе данных, +более удобны в динамически типизированных языках, чем в статически типизированных языках. +С динамически типизированными языками естественно моделировать строку как запись или объект +и выбирать записи с помощью простых точечных обозначений, например `row.columnName`. + +Достижение того же результата в статически типизированном языке требует определения класса для каждой возможной строки, +возникающей в результате манипуляций с базой данных, включая строки, возникающие в результате `join` и проектирования, +и настройки схемы для сопоставления между строкой и представляющим ее классом. + +Это требует большого количества шаблонов, +что заставляет разработчиков менять преимущества статической типизации на более простые схемы, +в которых имена столбцов представляются в виде строк и передаются другим операторам, например `row.select("columnName")`. +Этот подход лишен преимуществ статической типизации и все еще не так естественен, как динамически типизируемая версия. + +Структурные типы (structural types) помогают в ситуациях, +когда желательно поддерживать простую точечную нотацию в динамических контекстах, не теряя преимуществ статической типизации. +Они также позволяют разработчикам настраивать, как должны определяться поля и методы. + +## Пример + +Вот пример структурного типа `Person`: + +```scala +class Record(elems: (String, Any)*) extends Selectable: + private val fields = elems.toMap + def selectDynamic(name: String): Any = fields(name) + +type Person = Record { + val name: String + val age: Int +} +``` + +Тип `Person` добавляет _уточнение_ (_refinement_) к своему родительскому типу `Record`, которое определяет поля `name` и `age`. +Говорится, что уточнение носит _структурный_ (_structural_) характер, +поскольку `name` и `age` не определены в родительском типе. +Но тем не менее они существуют как члены класса `Person`. +Например, следующая программа напечатала бы `"Emma is 42 years old."`: + +```scala +val person = Record( + "name" -> "Emma", + "age" -> 42 +).asInstanceOf[Person] + +println(s"${person.name} is ${person.age} years old.") +``` + +Родительский тип `Record` в этом примере представляет собой универсальный класс, +который может в своем аргументе `elems` принимать произвольные записи. +Этот аргумент - последовательность пар ключей типа `String` и значений типа `Any`. +Когда создается `Person` как `Record`, необходимо с помощью приведения типов задать, +что запись определяет правильные поля правильных типов. +Сама `Record` слишком слабо типизирована, поэтому компилятор не может знать об этом без помощи пользователя. +На практике связь между структурным типом и его базовым общим представлением, скорее всего, +будет выполняться на уровне базы данных и, следовательно, не будет беспокоить конечного пользователя. + +`Record` расширяет маркер `trait scala.Selectable` и определяет метод `selectDynamic`, +который сопоставляет имя поля с его значением. +Выбор элемента структурного типа выполняется путем вызова соответствующего метода. +`person.name` и `person.age` преобразуются компилятором Scala в: + +```scala +person.selectDynamic("name").asInstanceOf[String] +person.selectDynamic("age").asInstanceOf[Int] +``` + +## Второй пример + +Чтобы закрепить сказанное, вот еще один структурный тип с именем `Book`, представляющий книгу, доступную в базе данных: + +```scala +type Book = Record { + val title: String + val author: String + val year: Int + val rating: Double +} +``` + +Как и в случае с `Person`, экземпляр `Book` создается следующим образом: + +```scala +val book = Record( + "title" -> "The Catcher in the Rye", + "author" -> "J. D. Salinger", + "year" -> 1951, + "rating" -> 4.5 +).asInstanceOf[Book] +``` + +## Класс Selectable + +Помимо `selectDynamic` класс `Selectable` иногда также определяет метод `applyDynamic`, +который можно использовать для замены вызовов функций на вызов структурных элементов. +Таким образом, если `a` является экземпляром `Selectable`, структурный вызов типа `a.f(b, c)` преобразуется в: + +```scala +a.applyDynamic("f")(b, c) +``` diff --git a/_ru/scala3/book/types-variance.md b/_ru/scala3/book/types-variance.md index d4a4eaa7b7..fa2d409364 100644 --- a/_ru/scala3/book/types-variance.md +++ b/_ru/scala3/book/types-variance.md @@ -9,7 +9,7 @@ description: В этом разделе представлена и демонс language: ru num: 54 previous-page: types-adts-gadts -next-page: +next-page: types-opaque-types --- _Вариантность_ (_variance_) параметра типа управляет подтипом параметризованных типов (таких, как классы или трейты). From cd240a8c5002f1ac3a3941e5a692cb44c1e5b166 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 10 Jul 2023 12:31:08 +0300 Subject: [PATCH 2661/3075] Update generic-classes.md in russian (#2856) --- _ru/tour/generic-classes.md | 79 ++++++++++++++++++++++++++++++++++--- 1 file changed, 74 insertions(+), 5 deletions(-) diff --git a/_ru/tour/generic-classes.md b/_ru/tour/generic-classes.md index 48d68a9733..591f810cfd 100644 --- a/_ru/tour/generic-classes.md +++ b/_ru/tour/generic-classes.md @@ -8,10 +8,16 @@ next-page: variances previous-page: for-comprehensions assumed-knowledge: classes unified-types --- + Обобщенные классы (Generic classes) - это классы, обладающие параметрическим полиморфизмом (т. е. классы, которые изменяют свое поведение в зависимости от приписываемого им типа. Этот тип указывается в квадратных скобках `[]` сразу после имени класса). Они особенно полезны для создания коллекций. ## Объявление обобщенного класса + Для объявления обобщенного класса необходимо после имени добавить тип в квадратных скобках `[]` как еще один параметр класса. По соглашению обычно используют заглавные буквы `A`, хотя можно использовать любые имена. + +{% tabs generic-classes-1 class=tabs-scala-version %} +{% tab 'Scala 2' for=generic-classes-1 %} + ```scala mdoc class Stack[A] { private var elements: List[A] = Nil @@ -25,20 +31,64 @@ class Stack[A] { } } ``` -Данная реализация класса `Stack` принимает в качестве параметра любой тип `A`. Это означает что список, `var elements: List[A] = Nil`, может хранить только элементы типа `A`. Процедура `def push` принимает только объекты типа `A` (примечание: `elements = x :: elements` переназначает `elements` в новый список, созданный путем добавления `x`а к текущим `elements`). + +{% endtab %} +{% tab 'Scala 3' for=generic-classes-1 %} + +```scala +class Stack[A]: + private var elements: List[A] = Nil + def push(x: A): Unit = + elements = x :: elements + def peek: A = elements.head + def pop(): A = + val currentTop = peek + elements = elements.tail + currentTop +``` + +{% endtab %} +{% endtabs %} + +Данная реализация класса `Stack` принимает в качестве параметра любой тип `A`. Это означает что список, `var elements: List[A] = Nil`, может хранить только элементы типа `A`. Процедура `def push` принимает только объекты типа `A` (примечание: `elements = x :: elements` переназначает `elements` в новый список, созданный путем добавления `x` к текущим `elements`). + +Здесь `Nil` — это пустой `List`, и его не следует путать с `null`. ## Использование Чтобы использовать обобщенный класс, поместите конкретный тип в квадратные скобки вместо `A`. -``` + +{% tabs generic-classes-2 class=tabs-scala-version %} +{% tab 'Scala 2' for=generic-classes-2 %} + +```scala mdoc val stack = new Stack[Int] stack.push(1) stack.push(2) -println(stack.pop) // выведет 2 -println(stack.pop) // выведет 1 +println(stack.pop()) // выведет 2 +println(stack.pop()) // выведет 1 ``` -Экземпляр `stack` может принимать только Intы. Однако, если тип имеет подтипы, то они также могут быть приняты: + +{% endtab %} +{% tab 'Scala 3' for=generic-classes-2 %} + +```scala +val stack = Stack[Int] +stack.push(1) +stack.push(2) +println(stack.pop()) // выведет 2 +println(stack.pop()) // выведет 1 ``` + +{% endtab %} +{% endtabs %} + +Экземпляр `stack` может принимать элементы типа `Int`. Однако, если тип имеет подтипы, то они также могут быть приняты: + +{% tabs generic-classes-3 class=tabs-scala-version %} +{% tab 'Scala 2' for=generic-classes-3 %} + +```scala mdoc:nest class Fruit class Apple extends Fruit class Banana extends Fruit @@ -50,6 +100,25 @@ val banana = new Banana stack.push(apple) stack.push(banana) ``` + +{% endtab %} +{% tab 'Scala 3' for=generic-classes-3 %} + +```scala +class Fruit +class Apple extends Fruit +class Banana extends Fruit + +val stack = Stack[Fruit] +val apple = Apple() +val banana = Banana() + +stack.push(apple) +stack.push(banana) +``` + +{% endtab %} +{% endtabs %} Классы `Apple` и `Banana` наследуются от `Fruit` так, что мы можем засунуть экземпляры `Apple` и `Banana` в пачку `Fruit`. _Примечание: подтипы обобщенных типов - *инвариантны*. Это означает, что если у нас есть стэк символов типа `Stack[Char]`, то он не может быть использован как стек интов типа `Stack[Int]`. Это нежелательное поведение, потому как позволило бы нам добавлять в стек символов целые числа. В заключение, `Stack[A]` является подтипом `Stack[B]` тогда и только тогда, когда `B = A`. Поскольку это может быть довольно строгим ограничением, Scala предлагает [механизм вариативного описания параметров типа](variances.html) для контроля за поведением подтипов._ From 1413c3a5dca9c00737180c1c440cece87312fe54 Mon Sep 17 00:00:00 2001 From: Jamie Willis <J_mie@hotmail.co.uk> Date: Thu, 13 Jul 2023 07:04:04 +0100 Subject: [PATCH 2662/3075] Ambiguous link guidance (#2860) --- _overviews/scaladoc/for-library-authors.md | 57 ++++++++++++++++++++++ 1 file changed, 57 insertions(+) diff --git a/_overviews/scaladoc/for-library-authors.md b/_overviews/scaladoc/for-library-authors.md index 332cbffd17..621861450e 100644 --- a/_overviews/scaladoc/for-library-authors.md +++ b/_overviews/scaladoc/for-library-authors.md @@ -239,6 +239,63 @@ The markup for list blocks looks like: - DRY - don't repeat yourself. Resist duplicating the method description in the `@return` tag and other forms of repetitive commenting. +## Resolving Ambiguous Links within Scaladoc Comments +When two methods are indistinguishable from each other lexically, it can cause Scaladoc to +report that there are ambiguous methods. As an example: + +```scala +import scala.collection.mutable.ListBuffer +class bar { + def foo(x: Int): Boolean = ??? + def foo(x: ListBuffer[Int], y: String): Int = ??? +} +``` + +If one references `foo` via `[[foo]]`, then the Scaladoc will complain and offer both +alternatives. Fixing this means elaborating the signature _enough_ so that it becomes unambiguous. +There are a few things to be aware of in general: + +* You must not use a space in the description of the signature: this will cause Scaladoc to + think the link has ended and move onto its description. +* You must fully qualify any types you are using: assume that you have written your program without + any import statements! + +Then, to disambiguate between objects and types, append `$` to designate a term name +and `!` for a type name. Term names include members which are not types, such as `val`, `def`, and +`object` definitions. For example: + - `[[scala.collection.immutable.List!.apply class List's apply method]]` and + - `[[scala.collection.immutable.List$.apply object List's apply method]]` + +When dealing with ambiguous overloads, however, it gets a bit more complex: + +* You must finish the signature, complete or otherwise, with a `*`, which serves as a wildcard + that allows you to cut off the signature when it is umambiguous. +* You must specify the names of the arguments and they must be _exactly_ as written in the + function definition: + - `[[bar.foo(Int)*]]` is **illegal** (no name) + - `[[bar.foo(y:Int)*]]` is **illegal** (wrong name) + - `[[bar.foo(x: Int)*]]` is **illegal** (space! Scaladoc sees this as `bar.foo(x:`) + - `[[bar.foo(x:Int):Boolean]]` is **illegal** (no `*`) + - `[[bar.foo(x:Int)*]]` is **legal** and unambiguous + - `[[bar.foo(x:Int*]]` is **legal**, the `Int` is enough to disambiguate so no closing paren needed +* The enclosing scope (package/class/object etc) of the method must use `.`, but within the arguments + and return type `\.` must be used instead to fully qualify types: + - `[[bar.foo(x:ListBuffer[Int],y:String)*]]` is **illegal** (no qualification on `ListBuffer`) + - `[[bar.foo(x:scala.collection.mutable.ListBuffer[Int],y:String)*]]` is **illegal** (non-escaped dots!) + - `[[bar\.foo(x:scala\.collection\.mutable\.ListBuffer[Int],y:String)*]]` is **illegal** (must not escape dots in the prefix) + - `[[bar.foo(x:scala\.collection\.mutable\.ListBuffer[Int],y:String)*]]` is **legal** + - `[[bar.foo(x:scala\.collection\.mutable\.ListBuffer[Int]*]]` is **legal**, the first argument is + enough to disambiguate. +* When generics are involved, additional square brackets may be used to avoid the + signature accidentally closing the link. Essentially, the number of leading left brackets + determines the number of right brackets required to complete the link: + - `[[baz(x:List[List[A]])*]]` is **illegal** (it is read as `baz(x:List[List[A`) + - `[[[baz(x:List[List[A]])*]]]` is **legal** (the `]]` is no longer a terminator, `]]]` is) + +### Known Limitations + * `#` syntax does not seem to be supported for parameters and return types. + * Spaces cannot be escaped with `\ `, so `implicit` parameters seem not to be supported either. + ## More details on writing Scaladoc Further information on the formatting and style recommendations can be found in From 80d547594dae0e9f983d36d4ad7a93370376a5ed Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 13 Jul 2023 13:59:46 -0700 Subject: [PATCH 2663/3075] fix typo --- _overviews/scala3-macros/tutorial/macros.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/macros.md b/_overviews/scala3-macros/tutorial/macros.md index 77ba07d45b..0768813b48 100644 --- a/_overviews/scala3-macros/tutorial/macros.md +++ b/_overviews/scala3-macros/tutorial/macros.md @@ -72,7 +72,7 @@ On the other hand, a macro executes user-written code that generates the code th Technically, compiling the inlined code `${ inspectCode('x) }` calls the method `inspectCode` _at compile time_ (through Java reflection), and the method `inspectCode` then executes as normal code. To be able to execute `inspectCode`, we need to compile its source code first. -As a technicaly consequence, we cannot define and use a macro in the **same class/file**. +As a technical consequence, we cannot define and use a macro in the **same class/file**. However, it is possible to have the macro definition and its call in the **same project** as long as the implementation of the macro can be compiled first. > ##### Suspended Files From 4c77b06ac94e399b1ee815802b60f4b62d89dd20 Mon Sep 17 00:00:00 2001 From: Kien Dang <mail@kien.ai> Date: Fri, 14 Jul 2023 20:38:04 +0800 Subject: [PATCH 2664/3075] Add anchors for headings in documentation (#2852) --- _sass/components/heading-anchor.scss | 12 ++++++++++++ _sass/layout/documentation.scss | 28 ++++++++++++++++++++++++++++ resources/css/style.scss | 1 + resources/js/functions.js | 12 ++++++++++++ 4 files changed, 53 insertions(+) create mode 100644 _sass/components/heading-anchor.scss diff --git a/_sass/components/heading-anchor.scss b/_sass/components/heading-anchor.scss new file mode 100644 index 0000000000..a38b6d96bf --- /dev/null +++ b/_sass/components/heading-anchor.scss @@ -0,0 +1,12 @@ +// HEADING ANCHOR +//------------------------------------------------ +//------------------------------------------------ + +.heading-anchor { + visibility: hidden; + padding-left: 0.5em; + + &:hover { + text-decoration: none; + } +} diff --git a/_sass/layout/documentation.scss b/_sass/layout/documentation.scss index 66d4d33c7a..c4e56bd3d4 100644 --- a/_sass/layout/documentation.scss +++ b/_sass/layout/documentation.scss @@ -66,6 +66,34 @@ .tag-inline { float: none; } + + h1, + h3, + h4, + h5, + h6 { + .heading-anchor { + color: $base-font-color; + } + + &:hover { + .heading-anchor { + visibility: visible; + } + } + } + + h2 { + .heading-anchor { + color: $brand-tertiary; + } + + &:hover { + .heading-anchor { + visibility: visible; + } + } + } } a.new-version-notice { diff --git a/resources/css/style.scss b/resources/css/style.scss index c7f0016ba9..938b0974e8 100755 --- a/resources/css/style.scss +++ b/resources/css/style.scss @@ -74,3 +74,4 @@ @import 'components/search'; @import 'components/dropdown'; @import 'components/wip-notice'; +@import 'components/heading-anchor.scss'; diff --git a/resources/js/functions.js b/resources/js/functions.js index b0b0dd6d68..efd41d00d5 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -662,3 +662,15 @@ $(document).ready(function () { $('#contributors').html(contributorsHtml); }); }); + +$(document).ready(function() { + const icon = '<i class="fa fa-link fa-2xs" aria-hidden="true"></i>' + const anchor = '<a class="heading-anchor" aria-hidden="true"></a>' + + $('.content-primary.documentation').find('h1, h2, h3, h4, h5, h6').each(function() { + const id = $(this).attr('id'); + if (id) { + $(this).append($(anchor).attr('href', '#' + id).html(icon)); + } + }); +}); From 1d5a68046723344b5322c8c1df3f4ec5bf74f5ba Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 14 Jul 2023 20:32:48 +0200 Subject: [PATCH 2665/3075] mark structural types as Scala 3 only --- _overviews/scala3-book/types-structural.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/_overviews/scala3-book/types-structural.md b/_overviews/scala3-book/types-structural.md index 246f9f1270..8dee33f301 100644 --- a/_overviews/scala3-book/types-structural.md +++ b/_overviews/scala3-book/types-structural.md @@ -6,12 +6,18 @@ languages: [ru, zh-cn] num: 56 previous-page: types-opaque-types next-page: types-dependent-function +scala3: true +versionSpecific: true --- {% comment %} NOTE: It would be nice to simplify this more. {% endcomment %} +_Scala 2 has a weaker form of structural types based on Java reflection, achieved with `import scala.language.reflectiveCalls`_. + +## Introduction + Some use cases, such as modeling database access, are more awkward in statically typed languages than in dynamically typed languages. With dynamically typed languages, it’s natural to model a row as a record or object, and to select entries with simple dot notation, e.g. `row.columnName`. From ab04353a864133e693101ab9f182376ff3069fa4 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 14 Jul 2023 20:37:17 +0200 Subject: [PATCH 2666/3075] mark dependent function types as Scala 3 only --- _overviews/scala3-book/types-dependent-function.md | 2 ++ _overviews/scala3-book/types-others.md | 4 +++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-book/types-dependent-function.md b/_overviews/scala3-book/types-dependent-function.md index 92bae2d227..f5b5cf2d37 100644 --- a/_overviews/scala3-book/types-dependent-function.md +++ b/_overviews/scala3-book/types-dependent-function.md @@ -6,6 +6,8 @@ languages: [ru, zh-cn] num: 57 previous-page: types-structural next-page: types-others +scala3: true +versionSpecific: true --- A *dependent function type* describes function types, where the result type may depend on the function’s parameter values. diff --git a/_overviews/scala3-book/types-others.md b/_overviews/scala3-book/types-others.md index 13ac06ed60..a5ae730b1e 100644 --- a/_overviews/scala3-book/types-others.md +++ b/_overviews/scala3-book/types-others.md @@ -6,6 +6,8 @@ languages: [ru, zh-cn] num: 58 previous-page: types-dependent-function next-page: ca-contextual-abstractions-intro +scala3: true +versionSpecific: true --- @@ -19,7 +21,7 @@ Scala has several other advanced types that are not shown in this book, includin - Refinement types - Kind polymorphism -For more details on these types, see the [Reference documentation][reference]. +For more details on these types, see the [Scala 3 Reference documentation][reference]. From 19b0ca8b22471f9ee2b3df9175e502130d391235 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 14 Jul 2023 20:11:12 +0200 Subject: [PATCH 2667/3075] mark value classes as scala 2 only --- _overviews/core/value-classes.md | 8 ++++++-- _overviews/scala3-book/types-opaque-types.md | 6 +++++- 2 files changed, 11 insertions(+), 3 deletions(-) diff --git a/_overviews/core/value-classes.md b/_overviews/core/value-classes.md index 46d63f9e3a..18c84f43fa 100644 --- a/_overviews/core/value-classes.md +++ b/_overviews/core/value-classes.md @@ -7,9 +7,11 @@ partof: value-classes languages: [ja, zh-cn] permalink: /overviews/core/:title.html +scala2: true +versionSpecific: true --- -**Mark Harrah** +In Scala 3, a similar result can be achieved with [opaque types][opaques]. ## Introduction @@ -212,7 +214,7 @@ Note that local classes, traits, and objects are not allowed either, as in the f ... } } - + Local.scala:3: error: implementation restriction: nested class is not allowed in value class class Local ^ @@ -272,3 +274,5 @@ but this is allowed because the enclosing object is top-level: object Outer { class Inner(val x: Int) extends AnyVal } + +[opaques]: {% link _overviews/scala3-book/types-opaque-types.md %} diff --git a/_overviews/scala3-book/types-opaque-types.md b/_overviews/scala3-book/types-opaque-types.md index b3a3edf0a7..1d7483630c 100644 --- a/_overviews/scala3-book/types-opaque-types.md +++ b/_overviews/scala3-book/types-opaque-types.md @@ -6,9 +6,12 @@ languages: [ru, zh-cn] num: 55 previous-page: types-variance next-page: types-structural +scala3: true +versionSpecific: true --- -Scala 3 _Opaque type aliases_ provide type abstractions without any **overhead**. +_Opaque type aliases_ provide type abstraction without any **overhead**. +In Scala 2, a similar result could be achieved with [value classes][value-classes]. ## Abstraction Overhead @@ -142,3 +145,4 @@ As illustrated above, opaque types are convenient to use, and integrate very wel [extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[value-classes]: {% link _overviews/core/value-classes.md %} From af9619d0c21b38d92be2b81ee6c1c876588f1ebe Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Sat, 15 Jul 2023 10:50:04 +0300 Subject: [PATCH 2668/3075] Update compound-types.md in russian --- _ru/tour/compound-types.md | 71 +++++++++++++++++++++++++++++++++----- 1 file changed, 63 insertions(+), 8 deletions(-) diff --git a/_ru/tour/compound-types.md b/_ru/tour/compound-types.md index 5d0a49aa0e..876bbaf42a 100644 --- a/_ru/tour/compound-types.md +++ b/_ru/tour/compound-types.md @@ -8,13 +8,19 @@ next-page: self-types previous-page: abstract-type-members --- -Иногда необходимо выразить, то что тип объекта является подтипом нескольких других типов. В Scala это можно выразить с помощью *составных типов*, которые являются объединением нескольких типов объектов. +Иногда необходимо выразить, то что тип объекта является подтипом нескольких других типов. + +В Scala это можно выразить с помощью _типов пересечений_ (или _составных типов_ в Scala 2), +которые являются объединением нескольких типов объектов. Предположим, у нас есть два трейта: `Cloneable` и `Resetable`: +{% tabs compound-types_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=compound-types_1 %} + ```scala mdoc trait Cloneable extends java.lang.Cloneable { - override def clone(): Cloneable = { + override def clone(): Cloneable = { // создает публичный метод 'clone' super.clone().asInstanceOf[Cloneable] } } @@ -23,9 +29,26 @@ trait Resetable { } ``` -Теперь предположим, что мы хотим написать функцию `cloneAndReset`, которая берет объект, клонирует его и сбрасывает (Reset) состояние исходного объекта: +{% endtab %} +{% tab 'Scala 3' for=compound-types_1 %} +```scala +trait Cloneable extends java.lang.Cloneable: + override def clone(): Cloneable = // создает публичный метод 'clone' + super.clone().asInstanceOf[Cloneable] +trait Resetable: + def reset: Unit ``` + +{% endtab %} +{% endtabs %} + +Теперь предположим, что мы хотим написать функцию `cloneAndReset`, которая берет объект, клонирует его и сбрасывает (Reset) состояние исходного объекта: + +{% tabs compound-types_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=compound-types_2 %} + +```scala mdoc:fail def cloneAndReset(obj: ?): Cloneable = { val cloned = obj.clone() obj.reset @@ -33,17 +56,49 @@ def cloneAndReset(obj: ?): Cloneable = { } ``` -Возникает вопрос, какой тип параметр `obj` должна принимать наша объединённая функция. Если это `Cloneable`, то объект может использовать метод `clone`, но не `reset`; если это `Resetable` мы можем использовать метод `reset`, но нет операции `clone`. Чтобы избежать приведения типа в такой ситуации, мы можем указать, что тип `obj` является и `Cloneable`, и `Resetable`. Этот совместный тип в Scala записывается как: `Cloneable with Resetable`. +{% endtab %} +{% tab 'Scala 3' for=compound-types_2 %} + +```scala +def cloneAndReset(obj: ?): Cloneable = + val cloned = obj.clone() + obj.reset + cloned +``` + +{% endtab %} +{% endtabs %} + +Возникает вопрос, какой тип параметра `obj` должна принимать наша объединённая функция. Если это `Cloneable`, то объект может использовать метод `clone`, но не `reset`; если это `Resetable` мы можем использовать метод `reset`, но нет операции `clone`. Чтобы избежать приведения типа в такой ситуации, мы можем указать, что тип `obj` является и `Cloneable`, и `Resetable`. + +{% tabs compound-types_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=compound-types_3 %} +Этот совместный тип в Scala записывается как: `Cloneable with Resetable`. Вот обновленная функция: -``` +```scala mdoc:fail def cloneAndReset(obj: Cloneable with Resetable): Cloneable = { //... } ``` -Составные типы могут состоять из нескольких типов объектов, и они могут содержать единый доработанный объект, в котором будут доработаны характеристики существующих членов объекта. -Общая форма записи: `A with B with C ... { доработанный объект }` +Обратите внимание, что у вас может быть более двух типов: `A with B with C with ...`. +Это означает то же самое, что и: `(...(A with B) with C) with ... )` + +{% endtab %} +{% tab 'Scala 3' for=compound-types_3 %} +Этот совместный тип в Scala записывается как: `Cloneable & Resetable`. + +Вот обновленная функция: + +```scala +def cloneAndReset(obj: Cloneable & Resetable): Cloneable = { + //... +} +``` -Пример использования таких доработок приведен на странице об [объединении классов с примесями](mixin-class-composition.html). +Обратите внимание, что у вас может быть более двух типов: `A & B & C & ...`. +`&` является ассоциативным, поэтому скобки могут быть добавлены вокруг любой части без изменения значения. +{% endtab %} +{% endtabs %} From 2caa1749ba262be7aeae968dbdc31f0e2a5483a5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Sat, 15 Jul 2023 09:12:38 +0300 Subject: [PATCH 2669/3075] Update inner-classes.md in russian --- _ru/tour/inner-classes.md | 65 ++++++++++++++++++++++++++++++++++++++- 1 file changed, 64 insertions(+), 1 deletion(-) diff --git a/_ru/tour/inner-classes.md b/_ru/tour/inner-classes.md index 5e1d075e90..15a1a2882d 100644 --- a/_ru/tour/inner-classes.md +++ b/_ru/tour/inner-classes.md @@ -12,6 +12,9 @@ previous-page: lower-type-bounds Чтобы проиллюстрировать суть подхода, мы быстро набросаем реализацию такого графа: +{% tabs inner-classes_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=inner-classes_1 %} + ```scala mdoc class Graph { class Node { @@ -30,8 +33,33 @@ class Graph { } } ``` + +{% endtab %} +{% tab 'Scala 3' for=inner-classes_1 %} + +```scala +class Graph: + class Node: + var connectedNodes: List[Node] = Nil + def connectTo(node: Node): Unit = + if !connectedNodes.exists(node.equals) then + connectedNodes = node :: connectedNodes + + var nodes: List[Node] = Nil + def newNode: Node = + val res = Node() + nodes = res :: nodes + res +``` + +{% endtab %} +{% endtabs %} + Данная программа представляет собой граф в составленного из списка узлов (`List[Node]`). Каждый узел имеет список других узлов, с которым он связан (`connectedNodes`). Класс `Node` является _зависимым от месторасположения типом_, поскольку он вложен в `Class Graph`. Поэтому все узлы в `connectedNodes` должны быть созданы с использованием `newNode` из одного и того же экземпляра `Graph`. +{% tabs inner-classes_2 %} +{% tab 'Scala 2 и 3' for=inner-classes_2 %} + ```scala mdoc val graph1: Graph = new Graph val node1: graph1.Node = graph1.newNode @@ -40,12 +68,19 @@ val node3: graph1.Node = graph1.newNode node1.connectTo(node2) node3.connectTo(node1) ``` + +{% endtab %} +{% endtabs %} + Мы явно объявили тип `node1`, `node2` и `node3` как `graph1.Node` для ясности, хотя компилятор мог определить это самостоятельно. Это потому, что когда мы вызываем `graph1.newNode`, вызывающий `new Node`, метод использует экземпляр `Node`, специфичный экземпляру `graph1`. Если у нас есть два графа, то система типов Scala не позволит смешивать узлы, определенные в рамках одного графа, с узлами другого, так как узлы другого графа имеют другой тип. Вот некорректная программа: -```scala:nest +{% tabs inner-classes_3 %} +{% tab 'Scala 2 и 3' for=inner-classes_3 %} + +```scala mdoc:fail val graph1: Graph = new Graph val node1: graph1.Node = graph1.newNode val node2: graph1.Node = graph1.newNode @@ -54,8 +89,15 @@ val graph2: Graph = new Graph val node3: graph2.Node = graph2.newNode node1.connectTo(node3) // не работает! ``` + +{% endtab %} +{% endtabs %} + Тип `graph1.Node` отличается от типа `graph2.Node`. В Java последняя строка в предыдущем примере программы была бы правильной. Для узлов обоих графов Java будет присваивать один и тот же тип `Graph.Node`, т.е. `Node` имеет префикс класса `Graph`. В Скале такой тип также может быть выражен, он записывается `Graph#Node`. Если мы хотим иметь возможность соединять узлы разных графов, то вам нужно изменить описание первоначальной реализации графов следующим образом: +{% tabs inner-classes_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=inner-classes_4 %} + ```scala mdoc:nest class Graph { class Node { @@ -74,3 +116,24 @@ class Graph { } } ``` + +{% endtab %} +{% tab 'Scala 3' for=inner-classes_4 %} + +```scala +class Graph: + class Node: + var connectedNodes: List[Graph#Node] = Nil + def connectTo(node: Graph#Node): Unit = + if !connectedNodes.exists(node.equals) then + connectedNodes = node :: connectedNodes + + var nodes: List[Node] = Nil + def newNode: Node = + val res = Node() + nodes = res :: nodes + res +``` + +{% endtab %} +{% endtabs %} From fed33f23d59bd4955aff2f1052c609ed93bcb91f Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 14 Jul 2023 20:59:01 +0200 Subject: [PATCH 2670/3075] fix packaging and imports --- _overviews/scala3-book/packaging-imports.md | 23 ++-- _ru/scala3/book/packaging-imports.md | 108 +++++++++--------- .../scala3-book/packaging-imports.md | 16 +-- 3 files changed, 74 insertions(+), 73 deletions(-) diff --git a/_overviews/scala3-book/packaging-imports.md b/_overviews/scala3-book/packaging-imports.md index 94126b7f32..4c5857cc53 100644 --- a/_overviews/scala3-book/packaging-imports.md +++ b/_overviews/scala3-book/packaging-imports.md @@ -47,10 +47,11 @@ The syntax shown above applies to the entire source file: all the definitions in at the beginning of the file. Alternatively, it is possible to write package clauses that apply only to the definitions -they contain: +they contain: -{% tabs packaging-imports-1 class=tabs-scala-version %} -{% tab 'Scala 2' %}```scala +{% tabs packaging-imports-0 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala package users { package administrators { // the full name of this package is users.administrators @@ -63,7 +64,7 @@ package users { ``` {% endtab %} -{% tab 'Scala 3' for=packaging-imports-1 %} +{% tab 'Scala 3' %} ```scala package users: @@ -462,7 +463,7 @@ The basic form is shown in this example: ```scala object A: class TC - given tc as TC + given tc: TC def f(using TC) = ??? object B: @@ -527,10 +528,10 @@ For example, when you have this `object`: {% tab 'Scala 3 only' %} ```scala object Instances: - given intOrd as Ordering[Int] - given listOrd[T: Ordering] as Ordering[List[T]] - given ec as ExecutionContext = ... - given im as Monoid[Int] + given intOrd: Ordering[Int] + given listOrd[T: Ordering]: Ordering[List[T]] + given ec: ExecutionContext = ... + given im: Monoid[Int] ``` {% endtab %} {% endtabs %} @@ -570,14 +571,14 @@ object MonthConversions: def convert(a: A): String given intMonthConverter: MonthConverter[Int] with - def convert(i: Int): String = + def convert(i: Int): String = i match case 1 => "January" case 2 => "February" // more cases here ... given stringMonthConverter: MonthConverter[String] with - def convert(s: String): String = + def convert(s: String): String = s match case "jan" => "January" case "feb" => "February" diff --git a/_ru/scala3/book/packaging-imports.md b/_ru/scala3/book/packaging-imports.md index 89bee0a428..49b5da759d 100644 --- a/_ru/scala3/book/packaging-imports.md +++ b/_ru/scala3/book/packaging-imports.md @@ -13,11 +13,11 @@ next-page: collections-intro --- -Scala использует _packages_ для создания пространств имен, которые позволяют модульно разбивать программы. -Scala поддерживает стиль именования пакетов, используемый в Java, а также нотацию пространства имен “фигурные скобки”, +Scala использует _packages_ для создания пространств имен, которые позволяют модульно разбивать программы. +Scala поддерживает стиль именования пакетов, используемый в Java, а также нотацию пространства имен “фигурные скобки”, используемую такими языками, как C++ и C#. -Подход Scala к импорту похож на Java, но более гибкий. +Подход Scala к импорту похож на Java, но более гибкий. С помощью Scala можно: - импортировать пакеты, классы, объекты, trait-ы и методы @@ -29,8 +29,8 @@ Scala поддерживает стиль именования пакетов, ## Создание пакета -Пакеты создаются путем объявления одного или нескольких имен пакетов в начале файла Scala. -Например, если ваше доменное имя _acme.com_ и вы работаете с пакетом _model_ приложения с именем _myapp_, +Пакеты создаются путем объявления одного или нескольких имен пакетов в начале файла Scala. +Например, если ваше доменное имя _acme.com_ и вы работаете с пакетом _model_ приложения с именем _myapp_, объявление пакета выглядит следующим образом: ```scala @@ -39,18 +39,18 @@ package com.acme.myapp.model class Person ... ``` -По соглашению все имена пакетов должны быть строчными, +По соглашению все имена пакетов должны быть строчными, а формальным соглашением об именах является _\<top-level-domain>.\<domain-name>.\<project-name>.\<module-name>_. -Хотя это и не обязательно, имена пакетов обычно совпадают с именами иерархии каталогов. -Поэтому, если следовать этому соглашению, класс `Person` в этом проекте будет найден +Хотя это и не обязательно, имена пакетов обычно совпадают с именами иерархии каталогов. +Поэтому, если следовать этому соглашению, класс `Person` в этом проекте будет найден в файле _MyApp/src/main/scala/com/acme/myapp/model/Person.scala_. ### Использование нескольких пакетов в одном файле -Показанный выше синтаксис применяется ко всему исходному файлу: -все определения в файле `Person.scala` принадлежат пакету `com.acme.myapp.model` +Показанный выше синтаксис применяется ко всему исходному файлу: +все определения в файле `Person.scala` принадлежат пакету `com.acme.myapp.model` в соответствии с предложением `package` в начале файла. В качестве альтернативы можно написать `package`, которые применяются только к содержащимся в них определениям: @@ -67,20 +67,20 @@ package users: Обратите внимание, что за именами пакетов следует двоеточие, а определения внутри пакета имеют отступ. -Преимущество этого подхода заключается в том, что он допускает вложение пакетов +Преимущество этого подхода заключается в том, что он допускает вложение пакетов и обеспечивает более очевидный контроль над областью видимости и инкапсуляцией, особенно в пределах одного файла. ## Операторы импорта -Операторы импорта используются для доступа к сущностям в других пакетах. +Операторы импорта используются для доступа к сущностям в других пакетах. Операторы импорта делятся на две основные категории: - импорт классов, трейтов, объектов, функций и методов - импорт `given` предложений -Первая категория операторов импорта аналогична тому, что использует Java, -с немного другим синтаксисом, обеспечивающим большую гибкость. +Первая категория операторов импорта аналогична тому, что использует Java, +с немного другим синтаксисом, обеспечивающим большую гибкость. Пример: ```` @@ -90,10 +90,10 @@ import users.{User, UserPreferences} // импортируются толь import users.{UserPreferences as UPrefs} // переименование импортированного члена ```` -Эти примеры предназначены для того, чтобы дать представление о том, как работает первая категория операторов `import`. +Эти примеры предназначены для того, чтобы дать представление о том, как работает первая категория операторов `import`. Более подробно они объясняются в следующих подразделах. -Операторы импорта также используются для импорта `given` экземпляров в область видимости. +Операторы импорта также используются для импорта `given` экземпляров в область видимости. Они обсуждаются в конце этой главы. > import не требуется для доступа к членам одного и того же пакета. @@ -130,15 +130,15 @@ import scala.concurrent.* ### Переименование элементов при импорте -Иногда необходимо переименовать объекты при их импорте, чтобы избежать конфликтов имен. -Например, если нужно использовать Scala класс `List` вместе с `java.util.List`, +Иногда необходимо переименовать объекты при их импорте, чтобы избежать конфликтов имен. +Например, если нужно использовать Scala класс `List` вместе с `java.util.List`, то можно переименовать `java.util.List` при импорте: ```scala import java.util.{List as JavaList} ``` -Теперь имя `JavaList` можно использовать для ссылки на класс `java.util.List` +Теперь имя `JavaList` можно использовать для ссылки на класс `java.util.List` и использовать `List` для ссылки на Scala класс `List`. Также можно переименовывать несколько элементов одновременно, используя следующий синтаксис: @@ -147,21 +147,21 @@ import java.util.{List as JavaList} import java.util.{Date as JDate, HashMap as JHashMap, *} ``` -В этой строке кода говорится следующее: “Переименуйте классы `Date` и `HashMap`, как показано, +В этой строке кода говорится следующее: “Переименуйте классы `Date` и `HashMap`, как показано, и импортируйте все остальное из пакета `java.util`, не переименовывая”. ### Скрытие членов при импорте -При импорте часть объектов можно _скрывать_. -Следующий оператор импорта скрывает класс `java.util.Random`, +При импорте часть объектов можно _скрывать_. +Следующий оператор импорта скрывает класс `java.util.Random`, в то время как все остальное в пакете `java.util` импортируется: ```scala import java.util.{Random as _, *} ``` -Если попытаться получить доступ к классу `Random`, то выдается ошибка, +Если попытаться получить доступ к классу `Random`, то выдается ошибка, но есть доступ ко всем остальным членам пакета `java.util`: ```scala @@ -200,7 +200,7 @@ val c: Map[Int, Int] = Map(1 -> 1, 2 -> 2) ### Импорт можно использовать в любом месте -В Scala операторы `import` могут быть объявлены где угодно. +В Scala операторы `import` могут быть объявлены где угодно. Их можно использовать в верхней части файла исходного кода: ```scala @@ -233,8 +233,8 @@ class ClassB: ### “Статический” импорт -Если необходимо импортировать элементы способом, аналогичным подходу “статического импорта” в Java, -то есть для того, чтобы напрямую обращаться к членам класса, не добавляя к ним префикс с именем класса, +Если необходимо импортировать элементы способом, аналогичным подходу “статического импорта” в Java, +то есть для того, чтобы напрямую обращаться к членам класса, не добавляя к ним префикс с именем класса, используется следующий подход. Синтаксис для импорта всех статических членов Java класса `Math`: @@ -243,7 +243,7 @@ class ClassB: import java.lang.Math.* ``` -Теперь можно получить доступ к статическим методам класса `Math`, +Теперь можно получить доступ к статическим методам класса `Math`, таким как `sin` и `cos`, без необходимости предварять их именем класса: ```scala @@ -263,13 +263,13 @@ val b = cos(PI) // -1.0 Члены object `Predef` также импортируются по умолчанию. -> Например, такие классы, как `List`, `Vector`, `Map` и т.д. можно использовать явно, не импортируя их - +> Например, такие классы, как `List`, `Vector`, `Map` и т.д. можно использовать явно, не импортируя их - > они доступны, потому что определены в object `Predef` ### Обработка конфликтов имен -Если необходимо импортировать что-то из корня проекта и возникает конфликт имен, +Если необходимо импортировать что-то из корня проекта и возникает конфликт имен, достаточно просто добавить к имени пакета префикс `_root_`: ``` @@ -281,14 +281,14 @@ import _root_.accounts.* ## Импорт экземпляров `given` -Как будет показано в главе [“Контекстные абстракции”][contextual], -для импорта экземпляров `given` используется специальная форма оператора `import`. +Как будет показано в главе [“Контекстные абстракции”][contextual], +для импорта экземпляров `given` используется специальная форма оператора `import`. Базовая форма показана в этом примере: ```scala object A: class TC - given tc as TC + given tc: TC def f(using TC) = ??? object B: @@ -296,8 +296,8 @@ object B: import A.given // импорт экземпляров given ``` -В этом коде предложение `import A.*` объекта `B` импортирует все элементы `A`, _кроме_ `given` экземпляра `tc`. -И наоборот, второй импорт, `import A.given`, импортирует _только_ `given` экземпляр. +В этом коде предложение `import A.*` объекта `B` импортирует все элементы `A`, _кроме_ `given` экземпляра `tc`. +И наоборот, второй импорт, `import A.given`, импортирует _только_ `given` экземпляр. Два предложения импорта также могут быть объединены в одно: ```scala @@ -307,23 +307,23 @@ object B: ### Обсуждение -Селектор с подстановочным знаком `*` помещает в область видимости все определения, кроме `given`, +Селектор с подстановочным знаком `*` помещает в область видимости все определения, кроме `given`, тогда как селектор выше помещает в область действия все данные, включая те, которые являются результатом расширений. Эти правила имеют два основных преимущества: -- более понятно, откуда берутся данные given. +- более понятно, откуда берутся данные given. В частности, невозможно скрыть импортированные given в длинном списке других импортируемых подстановочных знаков. -- есть возможность импортировать все given, не импортируя ничего другого. +- есть возможность импортировать все given, не импортируя ничего другого. Это особенно важно, поскольку given могут быть анонимными, поэтому обычное использование именованного импорта нецелесообразно. ### Импорт по типу -Поскольку given-ы могут быть анонимными, не всегда практично импортировать их по имени, -и вместо этого обычно используется импорт подстановочных знаков. -_Импорт по типу_ предоставляет собой более конкретную альтернативу импорту с подстановочными знаками, -делая понятным то, что импортируется. +Поскольку given-ы могут быть анонимными, не всегда практично импортировать их по имени, +и вместо этого обычно используется импорт подстановочных знаков. +_Импорт по типу_ предоставляет собой более конкретную альтернативу импорту с подстановочными знаками, +делая понятным то, что импортируется. ```scala import A.{given TC} @@ -336,26 +336,26 @@ import A.{given TC} import A.{given T1, ..., given Tn} ``` -Импорт всех `given` экземпляров параметризованного типа достигается аргументами с подстановочными знаками. +Импорт всех `given` экземпляров параметризованного типа достигается аргументами с подстановочными знаками. Например, есть такой `объект`: ```scala object Instances: - given intOrd as Ordering[Int] - given listOrd[T: Ordering] as Ordering[List[T]] - given ec as ExecutionContext = ... - given im as Monoid[Int] + given intOrd: Ordering[Int] + given listOrd[T: Ordering]: Ordering[List[T]] + given ec: ExecutionContext = ... + given im: Monoid[Int] ``` -Оператор `import` ниже импортирует экземпляры `intOrd`, `listOrd` и `ec`, но пропускает экземпляр `im`, +Оператор `import` ниже импортирует экземпляры `intOrd`, `listOrd` и `ec`, но пропускает экземпляр `im`, поскольку он не соответствует ни одному из указанных шаблонов: ```scala import Instances.{given Ordering[?], given ExecutionContext} ``` -Импорт по типу можно смешивать с импортом по имени. -Если оба присутствуют в предложении import, импорт по типу идет последним. +Импорт по типу можно смешивать с импортом по имени. +Если оба присутствуют в предложении import, импорт по типу идет последним. Например, это предложение импорта импортирует `im`, `intOrd` и `listOrd`, но не включает `ec`: ```scala @@ -365,7 +365,7 @@ import Instances.{im, given Ordering[?]} ### Пример -В качестве конкретного примера представим, что у нас есть объект `MonthConversions`, +В качестве конкретного примера представим, что у нас есть объект `MonthConversions`, который содержит два определения `given`: ```scala @@ -374,14 +374,14 @@ object MonthConversions: def convert(a: A): String given intMonthConverter: MonthConverter[Int] with - def convert(i: Int): String = + def convert(i: Int): String = i match case 1 => "January" case 2 => "February" // остальные случаи здесь ... given stringMonthConverter: MonthConverter[String] with - def convert(s: String): String = + def convert(s: String): String = s match case "jan" => "January" case "feb" => "February" @@ -410,8 +410,8 @@ def genericMonthConverter[A](a: A)(using monthConverter: MonthConverter[A]): Str println(genericMonthConverter("jan")) // January ``` -Как уже упоминалось ранее, одно из ключевых преимуществ синтаксиса “import given” состоит в том, -чтобы прояснить, откуда берутся данные в области действия, +Как уже упоминалось ранее, одно из ключевых преимуществ синтаксиса “import given” состоит в том, +чтобы прояснить, откуда берутся данные в области действия, и в `import` операторах выше ясно, что данные поступают из объекта `MonthConversions`. diff --git a/_zh-cn/overviews/scala3-book/packaging-imports.md b/_zh-cn/overviews/scala3-book/packaging-imports.md index 4ef39fbf1a..b85798e931 100644 --- a/_zh-cn/overviews/scala3-book/packaging-imports.md +++ b/_zh-cn/overviews/scala3-book/packaging-imports.md @@ -31,7 +31,7 @@ Scala 导入成员的方法也类似于 Java，并且更灵活。 通过在 Scala 文件的顶部声明一个或多个包名称来创建包。 例如，当您的域名是 _acme.com_ 并且您正在使用名为 _myapp_ 的应用程序中的 _model_ 包中工作时，您的包声明如下所示： -{% tabs packaging-imports-1 %} +{% tabs packaging-imports-0 %} {% tab 'Scala 2 and 3' %} ```scala package com.acme.myapp.model @@ -466,7 +466,7 @@ import _root_.accounts.* ```scala object A: class TC - given tc as TC + given tc: TC def f(using TC) = ??? object B: @@ -531,10 +531,10 @@ import A.{given T1, ..., given Tn} {% tab 'Scala 3 only' %} ```scala object Instances: - given intOrd as Ordering[Int] - given listOrd[T: Ordering] as Ordering[List[T]] - given ec as ExecutionContext = ... - given im as Monoid[Int] + given intOrd: Ordering[Int] + given listOrd[T: Ordering]: Ordering[List[T]] + given ec: ExecutionContext = ... + given im: Monoid[Int] ``` {% endtab %} {% endtabs %} @@ -574,14 +574,14 @@ object MonthConversions: def convert(a: A): String given intMonthConverter: MonthConverter[Int] with - def convert(i: Int): String = + def convert(i: Int): String = i match case 1 => "January" case 2 => "February" // more cases here ... given stringMonthConverter: MonthConverter[String] with - def convert(s: String): String = + def convert(s: String): String = s match case "jan" => "January" case "feb" => "February" From 5720006f746dd689d31ce1ca099b51d5c22f3537 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Sat, 15 Jul 2023 09:18:52 +0300 Subject: [PATCH 2671/3075] Update abstract-type-members.md in russian --- _ru/tour/abstract-type-members.md | 91 +++++++++++++++++++++++++++++-- 1 file changed, 86 insertions(+), 5 deletions(-) diff --git a/_ru/tour/abstract-type-members.md b/_ru/tour/abstract-type-members.md index 6da748d090..a56239034c 100644 --- a/_ru/tour/abstract-type-members.md +++ b/_ru/tour/abstract-type-members.md @@ -14,14 +14,33 @@ prerequisite-knowledge: variance, upper-type-bound Абстрактный означает, что только конкретный экземпляр определяет, каким именно будет тип. Вот пример: +{% tabs abstract-types_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=abstract-types_1 %} + ```scala mdoc trait Buffer { type T val element: T } ``` + +{% endtab %} +{% tab 'Scala 3' for=abstract-types_1 %} + +```scala +trait Buffer: + type T + val element: T +``` + +{% endtab %} +{% endtabs %} + Здесь мы определили абстрактный тип `T`, который используется для описания типа члена `element`. Мы можем расширить его в абстрактном классе, добавив верхнюю границу нового типа `U` связанного с `T`, делая описание типа более конкретным. +{% tabs abstract-types_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=abstract-types_2 %} + ```scala mdoc abstract class SeqBuffer extends Buffer { type U @@ -29,29 +48,69 @@ abstract class SeqBuffer extends Buffer { def length = element.length } ``` + +{% endtab %} +{% tab 'Scala 3' for=abstract-types_2 %} + +```scala +abstract class SeqBuffer extends Buffer: + type U + type T <: Seq[U] + def length = element.length +``` + +{% endtab %} +{% endtabs %} + Обратите внимание, как мы можем использовать новый абстрактный тип `U` в качестве верхней границы типа. Класс `SeqBuffer` позволяет хранить в буфере только последовательности, указывая, что тип `T` должен быть подтипом `Seq[U]` для нового абстрактного типа `U`. [Трейты](traits.html) или [классы](classes.html) с членами абстрактного типа часто используются в сочетании с анонимными экземплярами классов. Чтобы проиллюстрировать это рассмотрим программу, которая имеет дело с буфером, который ссылается на список целых чисел: +{% tabs abstract-types_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=abstract-types_3 %} + ```scala mdoc abstract class IntSeqBuffer extends SeqBuffer { type U = Int } - def newIntSeqBuf(elem1: Int, elem2: Int): IntSeqBuffer = new IntSeqBuffer { - type T = List[U] - val element = List(elem1, elem2) - } + type T = List[U] + val element = List(elem1, elem2) + } val buf = newIntSeqBuf(7, 8) println("length = " + buf.length) println("content = " + buf.element) ``` + +{% endtab %} +{% tab 'Scala 3' for=abstract-types_3 %} + +```scala +abstract class IntSeqBuffer extends SeqBuffer: + type U = Int + +def newIntSeqBuf(elem1: Int, elem2: Int): IntSeqBuffer = + new IntSeqBuffer: + type T = List[U] + val element = List(elem1, elem2) + +val buf = newIntSeqBuf(7, 8) +println("length = " + buf.length) +println("content = " + buf.element) +``` + +{% endtab %} +{% endtabs %} + Здесь класс `newIntSeqBuf` создает экземпляры `IntSeqBuffer`, используя анонимную реализацию класса `IntSeqBuffer` (т.е. `new IntSeqBuffer`), устанавливая тип `T` как `List[Int]`. Мы можем вывести тип класса из типа его членов и наоборот. Приведем версию кода, в которой выводится тип класса из типа его члена: +{% tabs abstract-types_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=abstract-types_4 %} + ```scala mdoc:nest abstract class Buffer[+T] { val element: T @@ -70,4 +129,26 @@ println("length = " + buf.length) println("content = " + buf.element) ``` -Обратите внимание, что здесь необходимо использовать [вариантность в описании типа](variances.html) (`+T <: Seq[U]`) для того, чтобы скрыть конкретный тип реализации списка, возвращаемого из метода `newIntSeqBuf`. +{% endtab %} +{% tab 'Scala 3' for=abstract-types_4 %} + +```scala +abstract class Buffer[+T]: + val element: T + +abstract class SeqBuffer[U, +T <: Seq[U]] extends Buffer[T]: + def length = element.length + +def newIntSeqBuf(e1: Int, e2: Int): SeqBuffer[Int, Seq[Int]] = + new SeqBuffer[Int, List[Int]]: + val element = List(e1, e2) + +val buf = newIntSeqBuf(7, 8) +println("length = " + buf.length) +println("content = " + buf.element) +``` + +{% endtab %} +{% endtabs %} + +Обратите внимание, что здесь необходимо использовать [вариантность в описании типа](variances.html) (`+T <: Seq[U]`) для того, чтобы скрыть конкретный тип реализации списка, возвращаемого из метода `newIntSeqBuf`. From 86c22b43f3209680a7da405e863c3bb0c818fc0f Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Mon, 17 Jul 2023 16:50:00 +0200 Subject: [PATCH 2672/3075] port java interaction to scala 2 (#2867) --- .../scala3-book/interacting-with-java.md | 334 ++++++++++++------ 1 file changed, 229 insertions(+), 105 deletions(-) diff --git a/_overviews/scala3-book/interacting-with-java.md b/_overviews/scala3-book/interacting-with-java.md index 06a5a8fa62..20eefda406 100644 --- a/_overviews/scala3-book/interacting-with-java.md +++ b/_overviews/scala3-book/interacting-with-java.md @@ -39,209 +39,282 @@ Note that the Java examples in this section assume that you’re using Java 11 o ## How to use Java collections in Scala -When you’re writing Scala code and need to use a Java collection class, you _can_ just use the class as-is. -However, if you want to use the class in a Scala `for` loop, or want to take advantage of the higher-order functions on the Scala collections classes, you’ll want to convert the Java collection to a Scala collection. +When you’re writing Scala code and an API either requires or produces a Java collection class (from the `java.util` package), then it is valid to directly use or create the collection as you would in Java. + +However, for idiomatic usage in Scala, such as `for` loops over the collection, or to apply higher-order functions such as `map` and `filter`, you can create a proxy that behaves like a Scala collection. Here’s an example of how this works. -Given this Java `ArrayList`: +Given this API that returns `java.util.List[String]`: +{% tabs foo-definition %} +{% tab Java %} ```java -// java -public class JavaClass { - public static List<String> getStrings() { - return new ArrayList<String>(List.of("a", "b", "c")); +public interface Foo { + static java.util.List<String> getStrings() { + return List.of("a", "b", "c"); } } ``` +{% endtab %} +{% endtabs %} + +You can convert that Java list to a Scala `Seq`, using the conversion utilities in the Scala `scala.jdk.CollectionConverters` object: -You can convert that Java list to a Scala `Seq`, using the conversion utilities in the Scala _scala.jdk.CollectionConverters_ package: +{% tabs foo-usage class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import scala.jdk.CollectionConverters._ +import scala.collection.mutable + +def testList() = { + println("Using a Java List in Scala") + val javaList: java.util.List[String] = Foo.getStrings() + val scalaSeq: mutable.Seq[String] = javaList.asScala + for (s <- scalaSeq) println(s) +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala -// scala import scala.jdk.CollectionConverters.* +import scala.collection.mutable -def testList() = +def testList() = println("Using a Java List in Scala") - val javaList: java.util.List[String] = JavaClass.getStrings() - val scalaSeq: Seq[String] = javaList.asScala.toSeq - scalaSeq.foreach(println) + val javaList: java.util.List[String] = Foo.getStrings() + val scalaSeq: mutable.Seq[String] = javaList.asScala for s <- scalaSeq do println(s) ``` +{% endtab %} +{% endtabs %} -Of course that code can be shortened, but the individual steps are shown here to demonstrate exactly how the conversion process works. - +In the above code `javaList.asScala` creates a wrapper that adapts a `java.util.List` to Scala's `mutable.Seq` collection. ## How to use Java `Optional` in Scala -When you need to use the Java `Optional` class in your Scala code, import the _scala.jdk.OptionConverters_ object, and then use the `toScala` method to convert the `Optional` value to a Scala `Option`. +When you are interacting with an API that uses the `java.util.Optional` class in your Scala code, it is fine to construct and use as in Java. -To demonstrate this, here’s a Java class with two `Optional<String>` values, one containing a string and the other one empty: +However, for idiomatic usage in Scala, such as use with `for`, you can convert it to a Scala `Option`. -```java -// java -import java.util.Optional; +To demonstrate this, here’s a Java API that returns an `Optional[String]` value: -public class JavaClass { - static Optional<String> oString = Optional.of("foo"); - static Optional<String> oEmptyString = Optional.empty(); +{% tabs bar-definition %} +{% tab Java %} +```java +public interface Bar { + static java.util.Optional<String> optionalString() { + return Optional.of("hello"); + } } ``` +{% endtab %} +{% endtabs %} -Now in your Scala code you can access those fields. -If you just access them directly, they’ll both be `Optional` values: +First import all members from the `scala.jdk.OptionConverters` object, and then use the `toScala` method to convert the `Optional` value to a Scala `Option`: +{% tabs bar-usage class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -// scala import java.util.Optional +import scala.jdk.OptionConverters._ -val optionalString = JavaClass.oString // Optional[foo] -val eOptionalString = JavaClass.oEmptyString // Optional.empty +val javaOptString: Optional[String] = Bar.optionalString +val scalaOptString: Option[String] = javaOptString.toScala ``` - -But by using the _scala.jdk.OptionConverters_ methods, you can convert them to Scala `Option` values: - +{% endtab %} +{% tab 'Scala 3' %} ```scala import java.util.Optional import scala.jdk.OptionConverters.* -val optionalString = JavaClass.oString // Optional[foo] -val optionString = optionalString.toScala // Some(foo) - -val eOptionalString = JavaClass.oEmptyString // Optional.empty -val eOptionString = eOptionalString.toScala // None +val javaOptString: Optional[String] = Bar.optionalString +val scalaOptString: Option[String] = javaOptString.toScala ``` - - +{% endtab %} +{% endtabs %} ## Extending Java interfaces in Scala If you need to use Java interfaces in your Scala code, extend them just as though they are Scala traits. For example, given these three Java interfaces: +{% tabs animal-definition %} +{% tab Java %} ```java -// java -interface Animal { +public interface Animal { void speak(); } -interface Wagging { +public interface Wagging { void wag(); } -interface Running { +public interface Running { // an implemented method default void run() { System.out.println("I’m running"); } } ``` +{% endtab %} +{% endtabs %} you can create a `Dog` class in Scala just as though you were using traits. -All you have to do is implement the `speak` and `wag` methods: +Because `run` has a default implementation, you only need to implement the `speak` and `wag` methods: +{% tabs animal-usage class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -// scala -class Dog extends Animal, Wagging, Running: +class Dog extends Animal with Wagging with Running { def speak = println("Woof") def wag = println("Tail is wagging") +} -@main def useJavaInterfaceInScala = - val d = new Dog +def useJavaInterfaceInScala = { + val d = new Dog() d.speak d.wag + d.run +} ``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +class Dog extends Animal, Wagging, Running: + def speak = println("Woof") + def wag = println("Tail is wagging") +def useJavaInterfaceInScala = + val d = Dog() + d.speak + d.wag + d.run +``` +{% endtab %} +{% endtabs %} +Also notice that in Scala, Java methods defined with empty parameter lists can be called either as in Java, `.wag()`, or you can choose to not use parentheses `.wag`. ## How to use Scala collections in Java When you need to use a Scala collection class in your Java code, use the methods of Scala’s `scala.jdk.javaapi.CollectionConverters` object in your Java code to make the conversions work. -For example, if you have a `List[String]` like this in a Scala class: +For example, suppose that a Scala API returns a `List[String]` like this: + +{% tabs baz-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -// scala -class ScalaClass: - val strings = List("a", "b") +object Baz { + val strings: List[String] = List("a", "b", "c") +} ``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +object Baz: + val strings: List[String] = List("a", "b", "c") +``` +{% endtab %} +{% endtabs %} You can access that Scala `List` in your Java code like this: +{% tabs baz-usage %} +{% tab Java %} ```java -// java import scala.jdk.javaapi.CollectionConverters; -// create an instance of the Scala class -ScalaClass sc = new ScalaClass(); - -// access the `strings` field as `sc.strings()` -scala.collection.immutable.List<String> xs = sc.strings(); +// access the `strings` method with `Baz.strings()` +scala.collection.immutable.List<String> xs = Baz.strings(); -// convert the Scala `List` a Java `List<String>` java.util.List<String> listOfStrings = CollectionConverters.asJava(xs); -listOfStrings.forEach(System.out::println); + +for (String s: listOfStrings) { + System.out.println(s); +} ``` +{% endtab %} +{% endtabs %} That code can be shortened, but the full steps are shown to demonstrate how the process works. -Here are a few things to notice in that code: - -- In your Java code, you create an instance of `ScalaClass` just like an instance of a Java class -- `ScalaClass` has a field named `strings`, but from Java you access that field as a method, i.e., as `sc.strings()` - +Be sure to notice that while `Baz` has a field named `strings`, from Java the field appears as a method, so must be called with parentheses `.strings()`. ## How to use Scala `Option` in Java When you need to use a Scala `Option` in your Java code, you can convert the `Option` to a Java `Optional` value using the `toJava` method of the Scala `scala.jdk.javaapi.OptionConverters` object. -To demonstrate this, create a Scala class with two `Option[String]` values, one containing a string and the other one empty: +For example, suppose that a Scala API returns an `Option[String]` like this: +{% tabs qux-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -// scala -object ScalaObject: - val someString = Option("foo") - val noneString: Option[String] = None +object Qux { + val optString: Option[String] = Option("hello") +} ``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +object Qux: + val optString: Option[String] = Option("hello") +``` +{% endtab %} +{% endtabs %} -Then in your Java code, convert those `Option[String]` values into `java.util.Optional[String]` using the `toJava` method from the `scala.jdk.javaapi.OptionConverters` object: +Then you can access that Scala `Option` in your Java code like this: +{% tabs qux-usage %} +{% tab Java %} ```java -// java import java.util.Optional; -import static scala.jdk.javaapi.OptionConverters.toJava; +import scala.Option; +import scala.jdk.javaapi.OptionConverters; -public class JUseScalaOptionInJava { - public static void main(String[] args) { - Optional<String> stringSome = toJava(ScalaObject.someString()); // Optional[foo] - Optional<String> stringNone = toJava(ScalaObject.noneString()); // Optional.empty - System.out.printf("stringSome = %s\n", stringSome); - System.out.printf("stringNone = %s\n", stringNone); - } -} +Option<String> scalaOptString = Qux.optString(); +Optional<String> javaOptString = OptionConverters.toJava(scalaOptString); ``` +{% endtab %} +{% endtabs %} -The two Scala `Option` fields are now available as Java `Optional` values. - - +That code can be shortened, but the full steps are shown to demonstrate how the process works. +Be sure to notice that while `Qux` has a field named `optString`, from Java the field appears as a method, so must be called with parentheses `.optString()`. ## How to use Scala traits in Java -With Java 11 you can use a Scala trait just like a Java interface, even if the trait has implemented methods. +From Java 8 you can use a Scala trait just like a Java interface, even if the trait has implemented methods. For example, given these two Scala traits, one with an implemented method and one with only an interface: +{% tabs scala-trait-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +trait ScalaAddTrait { + def sum(x: Int, y: Int) = x + y // implemented +} + +trait ScalaMultiplyTrait { + def multiply(x: Int, y: Int): Int // abstract +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala -// scala trait ScalaAddTrait: - def sum(x: Int, y: Int) = x + y // implemented + def sum(x: Int, y: Int) = x + y // implemented trait ScalaMultiplyTrait: def multiply(x: Int, y: Int): Int // abstract ``` +{% endtab %} +{% endtabs %} A Java class can implement both of those interfaces, and define the `multiply` method: +{% tabs scala-trait-usage %} +{% tab Java %} ```java -// java class JavaMath implements ScalaAddTrait, ScalaMultiplyTrait { public int multiply(int a, int b) { return a * b; @@ -252,6 +325,8 @@ JavaMath jm = new JavaMath(); System.out.println(jm.sum(3,4)); // 7 System.out.println(jm.multiply(3,4)); // 12 ``` +{% endtab %} +{% endtabs %} @@ -262,29 +337,45 @@ But if for some reason you have a Scala method that does throw an exception, and For example, this Scala `exceptionThrower` method is annotated to declare that it throws an `Exception`: +{% tabs except-throw-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -// scala -object SExceptionThrower: - @throws(classOf[Exception]) - def exceptionThrower = +object SExceptionThrower { + @throws[Exception] + def exceptionThrower = throw new Exception("Idiomatic Scala methods don’t throw exceptions") +} ``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +object SExceptionThrower: + @throws[Exception] + def exceptionThrower = + throw Exception("Idiomatic Scala methods don’t throw exceptions") +``` +{% endtab %} +{% endtabs %} As a result, you’ll need to handle the exception in your Java code. For instance, this code won’t compile because I don’t handle the exception: +{% tabs except-throw-usage %} +{% tab Java %} ```java -// java: won’t compile because the exception isn’t handled +// won’t compile because the exception isn’t handled public class ScalaExceptionsInJava { public static void main(String[] args) { SExceptionThrower.exceptionThrower(); } } ``` +{% endtab %} +{% endtabs %} The compiler gives this error: -```` +````plain [error] ScalaExceptionsInJava: unreported exception java.lang.Exception; must be caught or declared to be thrown [error] SExceptionThrower.exceptionThrower() @@ -303,28 +394,43 @@ This is probably not what you want, because the Java code may not account for th When a Scala method has a varargs parameter and you want to use that method in Java, mark the Scala method with the `@varargs` annotation. For example, the `printAll` method in this Scala class declares a `String*` varargs field: +{% tabs vararg-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import scala.annotation.varargs + +object VarargsPrinter { + @varargs def printAll(args: String*): Unit = args.foreach(println) +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala -// scala import scala.annotation.varargs object VarargsPrinter: - @varargs def printAll(args: String*): Unit = args.foreach(println) + @varargs def printAll(args: String*): Unit = args.foreach(println) ``` +{% endtab %} +{% endtabs %} Because `printAll` is declared with the `@varargs` annotation, it can be called from a Java program with a variable number of parameters, as shown in this example: -```scala -// java +{% tabs vararg-usage %} +{% tab Java %} +```java public class JVarargs { public static void main(String[] args) { VarargsPrinter.printAll("Hello", "world"); } } ``` +{% endtab %} +{% endtabs %} When this code is run, it results in the following output: -```` +````plain Hello world ```` @@ -335,25 +441,43 @@ world In Scala you might want to create a method name using a symbolic character: +{% tabs add-definition %} +{% tab 'Scala 2 and 3' %} ```scala def +(a: Int, b: Int) = a + b ``` +{% endtab %} +{% endtabs %} + +That method name won’t work well in Java, but what you can do in Scala is provide an “alternate” name for the method with the `targetName` annotation, which will be the name of the method when used from Java: -That method name won’t work well in Java, but what you can do in Scala 3 is provide an “alternate” name for the method---an alias---that will work in Java: +{% tabs add-2-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import scala.annotation.targetName +object Adder { + @targetName("add") def +(a: Int, b: Int) = a + b +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala import scala.annotation.targetName -class Adder: +object Adder: @targetName("add") def +(a: Int, b: Int) = a + b ``` +{% endtab %} +{% endtabs %} Now in your Java code you can use the aliased method name `add`: -```scala -var adder = new Adder(); -int x = adder.add(1,1); +{% tabs add-2-usage %} +{% tab Java %} +```java +int x = Adder.add(1,1); System.out.printf("x = %d\n", x); ``` - - +{% endtab %} +{% endtabs %} From a726a558eea712198a0be250b15545fc6c2232a2 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Mon, 17 Jul 2023 17:37:15 +0200 Subject: [PATCH 2673/3075] Update value-classes.md be more clear that values classes are still supported --- _overviews/core/value-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/core/value-classes.md b/_overviews/core/value-classes.md index 18c84f43fa..fc501fc4c7 100644 --- a/_overviews/core/value-classes.md +++ b/_overviews/core/value-classes.md @@ -11,7 +11,7 @@ scala2: true versionSpecific: true --- -In Scala 3, a similar result can be achieved with [opaque types][opaques]. +In Scala 3, value classes are still supported for compatibility reasons but the recommended way to achieve the same result is to use [opaque types][opaques]. ## Introduction From 5d4b11d9491324ec95649ecfc2db47b39c3ff46d Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Mon, 17 Jul 2023 17:43:59 +0200 Subject: [PATCH 2674/3075] port library authors guide to Scala 3 --- _overviews/contributors/index.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/_overviews/contributors/index.md b/_overviews/contributors/index.md index 113b27838d..0460e1c4d3 100644 --- a/_overviews/contributors/index.md +++ b/_overviews/contributors/index.md @@ -473,6 +473,8 @@ code fences have been updated to also include the result of evaluating the Scala Another approach consists in embedding fragments of Scala source files that are part of a module which is compiled by your build. For instance, given the following test in file `src/test/ch/epfl/scala/Usage.scala`: +{% tabs usage-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} ~~~ scala package ch.epfl.scala @@ -489,6 +491,25 @@ object Usage extends Scalaprops { } ~~~ +{% endtab %} +{% tab 'Scala 3' %} +~~~ scala +package ch.epfl.scala + +import scalaprops.{Property, Scalaprops} + +object Usage extends Scalaprops: + + val testDoNothing = +// #do-nothing + Property.forAll: (x: Int) => + Example.doNothing(x) == x +// #do-nothing + +end Usage +~~~ +{% endtab %} +{% endtabs %} You can embed the fragment surrounded by the `#do-nothing` identifiers with the `@@snip` Paradox directive, as shown in the `src/documentation/reference.md` file: From 525a480da46f21da84f6d05e6cad5eebfaf3d28c Mon Sep 17 00:00:00 2001 From: Evgenii Rybnikov <evgenii.chaser@gmail.com> Date: Fri, 21 Jul 2023 12:58:30 +0300 Subject: [PATCH 2675/3075] grammar corrections (#2861) Co-authored-by: evgeny-rybnikov <evgeny.chaser@gmail.com> --- _ru/overviews/collections-2.13/arrays.md | 9 ++++----- .../concrete-immutable-collection-classes.md | 10 +++++----- .../concrete-mutable-collection-classes.md | 6 +++--- .../creating-collections-from-scratch.md | 2 +- _ru/overviews/collections-2.13/equality.md | 2 +- _ru/overviews/collections-2.13/iterators.md | 8 ++++---- _ru/overviews/collections-2.13/overview.md | 2 +- .../collections-2.13/performance-characteristics.md | 2 +- _ru/overviews/collections-2.13/seqs.md | 2 +- _ru/overviews/collections-2.13/sets.md | 4 ++-- _ru/overviews/collections-2.13/strings.md | 2 +- _ru/overviews/collections-2.13/trait-iterable.md | 2 +- _ru/overviews/collections-2.13/views.md | 4 ++-- 13 files changed, 27 insertions(+), 28 deletions(-) diff --git a/_ru/overviews/collections-2.13/arrays.md b/_ru/overviews/collections-2.13/arrays.md index dba3fb4e08..856c08002c 100644 --- a/_ru/overviews/collections-2.13/arrays.md +++ b/_ru/overviews/collections-2.13/arrays.md @@ -10,8 +10,7 @@ language: ru --- [Массивы](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/Array.html) особый вид коллекций в Scala. -С одной стороны, Scala массивы соответствуют массивам из Java. Например, Scala массив `Array[Int]` реализован в виде Java `int[]`, а `Array[Double]` как Java `double[]` и `Array[String]` как Java `String[]` - С другой стороны, Scala массивы дают намного больше чем их Java аналоги. Во-первых Scala массивы могут быть обобщены (_generic_). То есть вы можете описать массив как `Array[T]`, где `T` дополнительный `параметр-тип` массива или же абстрактный тип. +С одной стороны, Scala массивы соответствуют массивам из Java. Например, Scala массив `Array[Int]` реализован в виде Java `int[]`, а `Array[Double]` как Java `double[]` и `Array[String]` как Java `String[]`. С другой стороны, Scala массивы дают намного больше чем их Java аналоги. Во-первых, Scala массивы могут быть обобщены (_generic_). То есть вы можете описать массив как `Array[T]`, где `T` дополнительный `параметр-тип` массива или же абстрактный тип. Во-вторых, Scala массивы совместимы со списками (`Seq`) Scala - вы можете передавать `Array[T]` на вход туда, где требуется `Seq[T]`. Ну и наконец, Scala массивы также поддерживают все операции, которые есть у списков. Вот пример: scala> val a1 = Array(1, 2, 3) @@ -23,7 +22,7 @@ language: ru scala> a3.reverse res0: Array[Int] = Array(9, 3) -Учитывая то что Scala массивы соответствуют массивам из Java, каким же образом реализованы остальные дополнительные возможности массивов в Scala? +Учитывая то, что Scala массивы соответствуют массивам из Java, каким же образом реализованы остальные дополнительные возможности массивов в Scala? Реализация массивов в Scala постоянно использует неявные преобразования. В Scala массив не пытается _притворяться_ последовательностью. Он и не может, потому что тип данных лежащий в основе массива не является подтипом `Seq`. Вместо этого, используя "упаковывание", происходит неявное преобразование между массивами и экземплярами класса `scala.collection.mutable.ArraySeq`, который является подклассом `Seq`. Вот как это работает: scala> val seq: collection.Seq[Int] = a1 @@ -50,7 +49,7 @@ language: ru Вы видите, что вызов `reverse` на `seq`, который является `ArraySeq`, даст снова `ArraySeq`. Это логично, потому что массивы - это `Seqs`, и вызов `reverse` на любом `Seq` даст снова `Seq`. С другой стороны, вызов `reverse` на экземпляре класса `ArrayOps` даст значение `Array`, а не `Seq`. -Пример `ArrayOps`, приведенный выше искусственный и используется лишь, чтоб показать разницу с `ArraySeq`. Обычно, вы никогда не создаете экземпляры класса `ArrayOps`. Вы просто вызываете методы `Seq` на массиве: +Пример `ArrayOps`, приведенный выше искусственный и используется лишь, чтобы показать разницу с `ArraySeq`. Обычно, вы никогда не создаете экземпляры класса `ArrayOps`. Вы просто вызываете методы `Seq` на массиве: scala> a1.reverse res4: Array[Int] = Array(3, 2, 1) @@ -62,7 +61,7 @@ language: ru где `intArrayOps` - неявное преобразование, которое было вставлено ранее. В связи с этим возникает вопрос, как компилятор выбрал `intArrayOps` вместо другого неявного преобразования в `ArraySeq` в строке выше. В конце концов, оба преобразования преобразуют массив в тип, поддерживающий метод reverse. Ответ на этот вопрос заключается в том, что два неявных преобразования имеют приоритет. Преобразование `ArrayOps` имеет больший приоритет, чем преобразование `ArraySeq`. Первый определяется в объекте `Predef`, а второй - в классе `scala.LowPriorityImplicits`, который `Predef` наследует. Неявные преобразования в дочерних классах и дочерних объектах имеют более высокий приоритет над преобразованиями в базовых классах. Таким образом, если оба преобразования применимы, выбирается вариант в `Predef`. Очень похожая схема используется для строк. -Итак, теперь вы знаете, как массивы могут быть совместимы с последовательностями и как они могут поддерживать все операции последовательностей. А как же обобщения? В Java нельзя написать `T[]`, где `T` является параметром типа. Как же представлен Scala `Array[T]`? На самом деле обобщенный массив типа `Array[T]` может быть любым из восьми примитивных типов массивов Java `byte[]`, `short[]`, `char[]`, `int[] `, `long[] `, `float[]`, `double ` или может быть массивом объектов. Единственным общим типом, включающим все эти типы, является `AnyRef` (или, равнозначно `java.lang.Object`), так что это тот тип в который компилятор Scala отобразит `Array[T]`. Во время исполнения, при обращении к элементу массива типа `Array[T]`, происходит последовательность проверок типов, которые определяют тип массива, за которыми следует подходящая операция на Java-массиве. Эти проверки типов замедляют работу массивов. Можно ожидать падения скорости доступа к обобщенным массивам в три-четыре раза, по сравнению с обычными массивами или массивами объектов. Это означает, что если вам нужна максимальная производительность, вам следует выбирать конкретные массивы, вместо обобщенных. Отображать обобщенный массив еще пол беды, нам нужен еще способ создания обобщенных массивов. Это куда более сложная задача, которая требует, от вас, небольшой помощи. Чтобы проиллюстрировать проблему, рассмотрим следующую попытку написания обобщенного метода, который создает массив. +Итак, теперь вы знаете, как массивы могут быть совместимы с последовательностями и как они могут поддерживать все операции последовательностей. А как же обобщения? В Java нельзя написать `T[]`, где `T` является параметром типа. Как же представлен Scala `Array[T]`? На самом деле обобщенный массив типа `Array[T]` может быть любым из восьми примитивных типов массивов Java `byte[]`, `short[]`, `char[]`, `int[] `, `long[] `, `float[]`, `double ` или может быть массивом объектов. Единственным общим типом, включающим все эти типы, является `AnyRef` (или, равнозначно `java.lang.Object`), так что это тот тип, в который компилятор Scala отобразит `Array[T]`. Во время исполнения, при обращении к элементу массива типа `Array[T]`, происходит последовательность проверок типов, которые определяют тип массива, за которыми следует подходящая операция на Java-массиве. Эти проверки типов замедляют работу массивов. Можно ожидать падения скорости доступа к обобщенным массивам в три-четыре раза, по сравнению с обычными массивами или массивами объектов. Это означает, что если вам нужна максимальная производительность, вам следует выбирать конкретные массивы, вместо обобщенных. Отображать обобщенный массив еще полбеды, нам нужен еще способ создания обобщенных массивов. Это куда более сложная задача, которая требует от вас небольшой помощи. Чтобы проиллюстрировать проблему, рассмотрим следующую попытку написания обобщенного метода, который создает массив. // это неправильно! def evenElems[T](xs: Vector[T]): Array[T] = { diff --git a/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md b/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md index dd9f2e5658..e2f94e3455 100644 --- a/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md +++ b/_ru/overviews/collections-2.13/concrete-immutable-collection-classes.md @@ -24,7 +24,7 @@ Scala предлагает множество конечных реализац scala> val lazyList = 1 #:: 2 #:: 3 #:: LazyList.empty lazyList: scala.collection.immutable.LazyList[Int] = LazyList(?) -На первом месте в этом ленивом списке - 1, а на втором - 2 и 3. Но ни один из элементов здесь не выводится, потому что список еще не вычислен! Ленивые списки задуманны обрабатываться лениво, поэтому метод `toString`, не выводит всех элементов, не заставляя производить дополнительные вычисления. +На первом месте в этом ленивом списке - 1, а на втором - 2 и 3. Но ни один из элементов здесь не выводится, потому что список еще не вычислен! Ленивые списки задуманы обрабатываться лениво, поэтому метод `toString` не выводит всех элементов, не заставляя производить дополнительные вычисления. Ниже приводится более сложный пример. Вычисления ленивого списка, содержащего последовательность Фибоначчи, которая начинается с заданных двух чисел. Последовательность Фибоначчи - это последовательность, в которой каждый элемент представляет собой сумму двух предыдущих элементов в серии. @@ -80,7 +80,7 @@ ArraySeqs хранят свои элементы в приватном [Масс [Вектор](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/Vector.html) - тип коллекции, который обеспечивает хорошую производительность для всех своих операций. Вектора позволяют получить доступ к любому элементу последовательности за "практически" постоянное время. Это значит что константа больше, чем при получении переднего (`head`) элемента списка или при чтения элемента из ArraySeq, но, тем не менее, это константа. Избегайте использование векторов в алгоритмах базирующихся на активной работе с передними (`head`) элементами. Вектора могут получать доступ к элементам и изменять их в произвольных местах, что делает разработку более простой и удобной. -Вектора создаются и модифицируются также как и другие последовательности. +Вектора создаются и модифицируются так же, как и другие последовательности. scala> val vec = scala.collection.immutable.Vector.empty vec: scala.collection.immutable.Vector[Nothing] = Vector() @@ -91,10 +91,10 @@ ArraySeqs хранят свои элементы в приватном [Масс scala> vec3(0) res1: Int = 100 -Вектора представленны деревьями с высоким уровнем ветвления (уровень ветвления дерева или графа - это количество дочерних элементов у каждого узла). Каждый узел дерева содержит до 32х элементов вектора или содержит до 32х других узлов. Вектора с размером до 32х элементов могут быть представленны одним узлом. Вектора `32 * 32 = 1024` элементы могут быть представлены одним витком. +Вектора представлены деревьями с высоким уровнем ветвления (уровень ветвления дерева или графа - это количество дочерних элементов у каждого узла). Каждый узел дерева содержит до 32х элементов вектора или содержит до 32х других узлов. Вектора с размером до 32х элементов могут быть представлены одним узлом. Вектора `32 * 32 = 1024` элементы могут быть представлены одним витком. Для векторов с 2<sup>15</sup> элементами достаточно двух переходов от корня дерева до конечного элемента узла, трех переходов для векторов с 2<sup>20</sup> элементами, четырех переходов для 2<sup>25</sup> элементами и пяти переходов для 2<sup>30</sup> элементами. Таким образом, для всех векторов разумных размеров выбор элемента включает до 5 простых выборок массивов. Именно это мы подразумевали, когда писали, что доступ к элементам осуществляется с "практически постоянным временем". -Также как и доступ к элементу, операция обновления в векторах занимает "практически" постоянное время. Добавление элемента в середину вектора может быть выполнено через копирование узла содержащего этот элемент и каждого ссылающегося на него узла, начиная от корня дерева. Это означает, что процесс обновления элемента создает от одного до пяти узлов, каждый из которых содержит до 32 элементов или поддеревьев. Это, конечно, дороже, чем просто обновление элемента в изменяемом массиве, но все же намного дешевле, чем копирование вообще всего вектора. +Так же как и доступ к элементу, операция обновления в векторах занимает "практически" постоянное время. Добавление элемента в середину вектора может быть выполнено через копирование узла содержащего этот элемент и каждого ссылающегося на него узла, начиная от корня дерева. Это означает, что процесс обновления элемента создает от одного до пяти узлов, каждый из которых содержит до 32 элементов или поддеревьев. Это, конечно, дороже, чем просто обновление элемента в изменяемом массиве, но все же намного дешевле, чем копирование вообще всего вектора. Поскольку вектора обладают хорошим балансом между быстрой случайной выборкой и быстрым случайным обновлением элементов, они используются в качестве реализации неизменяемых индексированных последовательностей: @@ -151,7 +151,7 @@ ArraySeqs хранят свои элементы в приватном [Масс Хэш деревья - это стандартный способ эффективного создания неизменяемых множеств и ассоциативных массивов (мап). [Compressed Hash-Array Mapped Prefix-trees](https://github.com/msteindorfer/oopsla15-artifact/) - это специальные хэш деревья для JVM, которые улучшают локальность и обеспечивают компактную и элегантную реализацию деревьев. Они базируются на классе [immutable.HashMap](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/HashMap.html). Их представление очень похоже на реализацию векторов, которые также являются деревьями, где каждый узел имеет либо 32 элемента либо 32 поддерева. Но в данном случае ключ выбирается на основе хэш-кода. Например, чтобы найти ключ на мапе, сначала берут хэш-код ключа. Затем самые младшие 5 бит хэш-кода используются для выбора первого поддерева, за которым следуют следующие 5 бит и так далее. Выбор прекращается, когда для всех битов будут найдены ключи. -Хэш деревья пытаются предоставить разумный баланс между достаточно быстрым поиском и достаточно эффективными операциями вставки (`+`) и удаления (`-`) элементов. Именно поэтому они лежат в основе стандартных реализаций Scala неизменяемых множеств и ассоциативных массивов (мап). На самом деле, в Scala есть дополнительная оптимизацию для неизменяемых множеств и мап, которые содержат менее пяти элементов. Множества и мапы от одного до четырех элементов хранятся как обычные объекты, которые содержат только элементы (или пары ключ/значение в случае мапы) как поля. Пустое неизменяемое множество и пустая неизменяемая мапа - это всегда объект-сингэлтон - нет необходимости размножать сущности для них, потому что пустое неизменяемое множество или мапа всегда будут оставаться пустыми. +Хэш деревья пытаются предоставить разумный баланс между достаточно быстрым поиском и достаточно эффективными операциями вставки (`+`) и удаления (`-`) элементов. Именно поэтому они лежат в основе стандартных реализаций Scala неизменяемых множеств и ассоциативных массивов (мап). На самом деле, в Scala есть дополнительная оптимизация для неизменяемых множеств и мап, которые содержат менее пяти элементов. Множества и мапы от одного до четырех элементов хранятся как обычные объекты, которые содержат только элементы (или пары ключ/значение в случае мапы) как поля. Пустое неизменяемое множество и пустая неизменяемая мапа - это всегда объект-сингэлтон - нет необходимости размножать сущности для них, потому что пустое неизменяемое множество или мапа всегда будут оставаться пустыми. ## Красно-Черные Деревья (Red-Black Trees) diff --git a/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md b/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md index d6f23a7024..1506db43ce 100644 --- a/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_ru/overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -13,7 +13,7 @@ language: ru ## Array Buffers -[ArrayBuffer](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayBuffer.html) - буферизированный массив в своем буфере хранит массив и его размер. Большинство операций с буферизированным массивом выполняются с той же скоростью, что и с массивом, так как операции просто обращаются и изменяют исходный массив. Кроме того он может эффективно добавлять данные к своему концу. Присоединение элемента к такому массиву занимает амортизированное константное время. Поэтому буферизированные массивы будут полезны, если вы строите большую коллекцию данных регулярно добавляя новые элементы в конец. +[ArrayBuffer](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayBuffer.html) - буферизированный массив в своем буфере хранит массив и его размер. Большинство операций с буферизированным массивом выполняются с той же скоростью, что и с массивом, так как операции просто обращаются и изменяют исходный массив. Кроме того, он может эффективно добавлять данные к своему концу. Присоединение элемента к такому массиву занимает амортизированное константное время. Поэтому буферизированные массивы будут полезны, если вы строите большую коллекцию данных регулярно добавляя новые элементы в конец. scala> val buf = scala.collection.mutable.ArrayBuffer.empty[Int] buf: scala.collection.mutable.ArrayBuffer[Int] = ArrayBuffer() @@ -39,7 +39,7 @@ language: ru ## StringBuilders -Так же, как буферизированный массив полезен для создания массивов, а буферизированный список полезен для построения списков, [StringBuilder](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/StringBuilder.html) полезен для создания строк. StringBuilders настолько широко используются, что они уже импортированы по умолчанию в стандартную область видимости. Можете создать их с помощью `new StringBuilder`, как в следующем примере: +Так же как буферизированный массив полезен для создания массивов, а буферизированный список полезен для построения списков, [StringBuilder](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/StringBuilder.html) полезен для создания строк. StringBuilders настолько широко используются, что они уже импортированы по умолчанию в стандартную область видимости. Можете создать их с помощью `new StringBuilder`, как в следующем примере: scala> val buf = new StringBuilder buf: StringBuilder = @@ -144,7 +144,7 @@ Scala предоставляет не только неизменяемые, н ## Mutable Bitsets (Изменяемый Битовый Набор) -Изменяемый набор типа [mutable.BitSet](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/BitSet.html) практически такойже как и неизменяемый набор, за исключением того, что он при изменении сам меняется. Изменяемые битовые наборы немного эффективнее при обновлении, чем неизменяемые, так как им не нужно копировать `Long`, которые не изменились. +Изменяемый набор типа [mutable.BitSet](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/BitSet.html) практически такой же, как и неизменяемый набор, за исключением того, что он при изменении сам меняется. Изменяемые битовые наборы немного эффективнее при обновлении, чем неизменяемые, так как им не нужно копировать `Long`, которые не изменились. scala> val bits = scala.collection.mutable.BitSet.empty bits: scala.collection.mutable.BitSet = BitSet() diff --git a/_ru/overviews/collections-2.13/creating-collections-from-scratch.md b/_ru/overviews/collections-2.13/creating-collections-from-scratch.md index 25c9cb21cf..5956c8e4a2 100644 --- a/_ru/overviews/collections-2.13/creating-collections-from-scratch.md +++ b/_ru/overviews/collections-2.13/creating-collections-from-scratch.md @@ -49,7 +49,7 @@ language: ru | `C.empty` | Пустая коллекция. | | `C(x, y, z)` | Коллекция состоящая из элементов `x, y, z`. | | `C.concat(xs, ys, zs)` | Коллекция, полученная путем объединения элементов `xs, ys, zs`. | -| `C.fill(n){e}` | Коллекция длины `n`, где каждый элемент вычисляется выражением`e`. | +| `C.fill(n){e}` | Коллекция длины `n`, где каждый элемент вычисляется выражением `e`. | | `C.fill(m, n){e}` | Коллекция коллекций размерности `m×n`, где каждый элемент вычисляется выражением `e`. (существует и в более высоких измерениях). | | `C.tabulate(n){f}` | Коллекция длины `n`, где элемент каждого индекса i вычисляется с помощью `f(i)`. | | `C.tabulate(m, n){f}` | Коллекция коллекций измерений `m×n`, где элемент каждого индекса `(i, j)` вычисляется с помощью `f(i, j)`. (существует также в более высоких измерениях). | diff --git a/_ru/overviews/collections-2.13/equality.md b/_ru/overviews/collections-2.13/equality.md index 179ae0bd71..e05ee5ee73 100644 --- a/_ru/overviews/collections-2.13/equality.md +++ b/_ru/overviews/collections-2.13/equality.md @@ -9,7 +9,7 @@ next-page: views language: ru --- -Коллекций придерживаются единого подхода к определению равенства и получению хэшей. Идея состоит, во-первых, в том, чтобы разделить коллекции на группы: множества, мапы и последовательности. Коллекции в разных группах всегда различаются. Например, `Set(1,2,3)` неравнозначен списку `List(1,2,3)`, хотя они содержат одни и те же элементы. С другой стороны, в рамках одной и той же группы коллекции равны тогда и только тогда, когда они имеют одинаковые элементы (для последовательностей: одни и те же элементы в одном порядке). Например `List(1, 2, 3) == Vector(1, 2, 3)`, и `HashSet(1, 2) == TreeSet(2, 1)`. +Коллекции придерживаются единого подхода к определению равенства и получению хэшей. Идея состоит, во-первых, в том, чтобы разделить коллекции на группы: множества, мапы и последовательности. Коллекции в разных группах всегда различаются. Например, `Set(1,2,3)` неравнозначен списку `List(1,2,3)`, хотя они содержат одни и те же элементы. С другой стороны, в рамках одной и той же группы коллекции равны тогда и только тогда, когда они имеют одинаковые элементы (для последовательностей: одни и те же элементы в одном порядке). Например `List(1, 2, 3) == Vector(1, 2, 3)`, и `HashSet(1, 2) == TreeSet(2, 1)`. Для проверки на равенство не важно, является ли коллекция изменяемой или неизменяемой. Для изменяемой коллекции достаточно просто рассмотреть ее текущие элементы на момент проведения проверки на равенство. Это означает, что коллекция в разные моменты может быть эквивалентна разным коллекциям, в зависимости от того, какие элементы в неё добавляются или удаляются. В этом кроится потенциальная опасность при использовании изменяемой коллекции в качестве ключа для хэшмапы. Пример: diff --git a/_ru/overviews/collections-2.13/iterators.md b/_ru/overviews/collections-2.13/iterators.md index a74e0bc860..3d43d76a8f 100644 --- a/_ru/overviews/collections-2.13/iterators.md +++ b/_ru/overviews/collections-2.13/iterators.md @@ -56,8 +56,8 @@ language: ru Обратите внимание еще раз, что сам итератор`it` был изменен вызовом `dropWhile`: теперь он указывает на второе слово `number` в списке. Фактически, `it` и результат `res4` возвращаемый после`dropWhile` возвращают одну и туже последовательность элементов. -Чтоб избежать такое поведение, как вариант можно использовать `duplicate` (дублировать используемый итератор), вызывая методы на разных итераторах. -Каждый из _двух_ итераторов будет обрабатывать точно такие же элементы, как и тот из которого состоит итераторатор `it`: +Чтобы избежать такое поведение, как вариант можно использовать `duplicate` (дублировать используемый итератор), вызывая методы на разных итераторах. +Каждый из _двух_ итераторов будет обрабатывать точно такие же элементы, как и тот, из которого состоит итераторатор `it`: scala> val (words, ns) = Iterator("a", "number", "of", "words").duplicate words: Iterator[String] = <iterator> @@ -73,7 +73,7 @@ language: ru Может создаться впечатление что итератор подвергается двойному обходу над элементами, но это не так, результат достигается за счет внутреннего буферизации. Как обычно, базовый итератор `it` не пригоден для прямого использования и должен быть исключен из дальнейших операций. -Обобщая вышесказанное, итераторы ведут себя как коллекции _если после вызова метода на них сам итератор больше не вызывается_. В библиотеке коллекции Scala это достигается явным образом с помощью абстракции [IterableOnce](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/IterableOnce.html), который является общим суперкласом для [Iterable](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterable.html) и [Iterator](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html). У `IterableOnce[A]` только два метода: `iterator: Iterator[A]` и `knownSize: Int`. +Обобщая вышесказанное, итераторы ведут себя как коллекции, _если после вызова метода на них сам итератор больше не вызывается_. В библиотеке коллекции Scala это достигается явным образом с помощью абстракции [IterableOnce](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/IterableOnce.html), который является общим суперкласом для [Iterable](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterable.html) и [Iterator](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/Iterator.html). У `IterableOnce[A]` только два метода: `iterator: Iterator[A]` и `knownSize: Int`. Если объект `IterableOnce` является `Iterator`, то его операция `iterator` всегда возвращает себя, в своем текущем состоянии, но если он `Iterable`, то операция `iterator` всегда возвращает новый `Iterator`. Типовой вариант использования `IterableOnce` - в качестве типа аргумента для методов, которые могут принимать или итератор или коллекцию в качестве аргумента. Примером может служить метод соединения `concat` в классе `Iterable`. Он принимает `IterableOnce` параметр, поэтому вы можете соединять элементы, поступающие или из итератора или коллекции. @@ -168,7 +168,7 @@ language: ru Поэтому выражение `(1 to 10).iterator.map(println)` не выведет ничего на экран. Метод `map` в данном случае не применяет функцию в аргументе к значениям в диапазоне, вместо этого будет возвращен новый `Iterator`, который будет выполнять операции тогда когда будет запрошен их результат. Добавление `.toList` в конец этого выражения фактически вызовет вывод элементов на печать. -Как следствие такие методы как `map` или `filter` не обязательно применят функцию в аргументе ко всем входным элементам. Выражение `(1 to 10).iterator.map(println).take(5).toList` выводит только значения от `1` до `5`, поскольку это те значения, которые запрашиваются у `Iterator`, возвращаемого из `map`. +Как следствие, такие методы как `map` или `filter` не обязательно применят функцию в аргументе ко всем входным элементам. Выражение `(1 to 10).iterator.map(println).take(5).toList` выводит только значения от `1` до `5`, поскольку это те значения, которые запрашиваются у `Iterator`, возвращаемого из `map`. Это одна из причин, того почему важно использовать только чистые функции в качестве аргументов для `map`, `filter`, `fold` и подобных методов. Помните, что чистая функция не имеет побочных эффектов, поэтому `println` обычно не используется в `map`. Здесь `println` используется лишь для демонстрации "ленивости", которую с чистыми функциями не заметно. diff --git a/_ru/overviews/collections-2.13/overview.md b/_ru/overviews/collections-2.13/overview.md index 6eb7087c63..c9205aeded 100644 --- a/_ru/overviews/collections-2.13/overview.md +++ b/_ru/overviews/collections-2.13/overview.md @@ -23,7 +23,7 @@ language: ru является _базовой_ для обоих коллекций [collection.immutable.IndexedSeq\[T\]](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/immutable/IndexedSeq.html) и [collection.mutable.IndexedSeq\[T\]](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/IndexedSeq.html) -Как правило, базовые коллекции пакета `scala.collection` поддерживают операции преобразования, затрагивающие всю коллекцию, неизменяемые коллекции пакета `scala.collection.immutable` обычно добавляют операции добавления или удаления отдельных элементов, а изменяемые коллекции пакета `scala.collection.mutable` обычно добавляют к базовому интерфейсу, операции модификации элементов основанные на побочных эфектах. +Как правило, базовые коллекции пакета `scala.collection` поддерживают операции преобразования, затрагивающие всю коллекцию, неизменяемые коллекции пакета `scala.collection.immutable` обычно добавляют операции добавления или удаления отдельных элементов, а изменяемые коллекции пакета `scala.collection.mutable` обычно добавляют к базовому интерфейсу операции модификации элементов, основанные на побочных эффектах. Еще одним отличием базовой коллекции от неизменяемой является то, что пользователи неизменяемой коллекции имеют гарантию, что никто не сможет изменить коллекцию, а пользователи базовой коллекции лишь обещают не менять ее самостоятельно. Даже если тип такой коллекции не предоставляет никаких операций для модификации коллекции, все равно возможно, что эта коллекция, может быть изменена какими-либо сторонними пользователями. diff --git a/_ru/overviews/collections-2.13/performance-characteristics.md b/_ru/overviews/collections-2.13/performance-characteristics.md index eb63206c02..281280075b 100644 --- a/_ru/overviews/collections-2.13/performance-characteristics.md +++ b/_ru/overviews/collections-2.13/performance-characteristics.md @@ -9,7 +9,7 @@ next-page: equality language: ru --- -Из предыдущих объяснений стало ясно, что разные типы коллекций имеют разные показатели производительности. Что зачастую является основной причиной, выбора одной коллекции вместо другой. Показатели для наиболее распространенных операций собраны в таблицах ниже. +Из предыдущих объяснений стало ясно, что разные типы коллекций имеют разные показатели производительности. Что зачастую является основной причиной выбора одной коллекции вместо другой. Показатели для наиболее распространенных операций собраны в таблицах ниже. Показатели производительности на последовательностях: diff --git a/_ru/overviews/collections-2.13/seqs.md b/_ru/overviews/collections-2.13/seqs.md index bf67f53cf0..49ef6d32b6 100644 --- a/_ru/overviews/collections-2.13/seqs.md +++ b/_ru/overviews/collections-2.13/seqs.md @@ -73,7 +73,7 @@ language: ru | `xs distinctBy f` |Подпоследовательность `xs`, которая не содержит дублирующего элемента после применения функции преобразования `f`. Например, `List("foo", "bar", "quux").distinctBy(_.length) == List("foo", "quux")`| У трейта [Seq](https://www.scala-lang.org/api/current/scala/collection/Seq.html) есть два дочерних трейта [LinearSeq](https://www.scala-lang.org/api/current/scala/collection/LinearSeq.html), и [IndexedSeq](https://www.scala-lang.org/api/current/scala/collection/IndexedSeq.html). -Они не добавляют никаких новых операций, но у каждого из них разные характеристики производительности: у LinearSeq эффективные операции `head` и `tail`, в то время как у IndexedSeq эффективные операции `apply`, `length` и (если мутабельная) `update`. Часто используемые варианты LinearSeq - это `scala.collection.immutable.List` и `scala.collection.immutable.LazyList`. А наиболее часто используемые IndexedSeq - это `scala.Array` и `scala.collection.mutable.ArrayBuffer`. Класс `Vector` представляет собой компромисс между IndexedSeq и LinearSeq. У него эффективные, как обращение по индексу, так и последовательный обход элементов. Поэтому вектора хорошая основа для смешанных моделей доступа, где используются как индексированный, так и последовательный доступ. Позже мы расскажем больше о [векторах]({% link _ru/overviews/collections-2.13/concrete-immutable-collection-classes.md %}). +Они не добавляют никаких новых операций, но у каждого из них разные характеристики производительности: у LinearSeq эффективные операции `head` и `tail`, в то время как у IndexedSeq эффективные операции `apply`, `length` и (если мутабельная) `update`. Часто используемые варианты LinearSeq - это `scala.collection.immutable.List` и `scala.collection.immutable.LazyList`. А наиболее часто используемые IndexedSeq - это `scala.Array` и `scala.collection.mutable.ArrayBuffer`. Класс `Vector` представляет собой компромисс между IndexedSeq и LinearSeq. У него эффективные как обращение по индексу, так и последовательный обход элементов. Поэтому вектора хорошая основа для смешанных моделей доступа, где используются как индексированный, так и последовательный доступ. Позже мы расскажем больше о [векторах]({% link _ru/overviews/collections-2.13/concrete-immutable-collection-classes.md %}). В мутабельном варианте `IndexedSeq` добавляет операции преобразования ее элементов в самой коллекции (в отличие от таких операций как `map` и `sort`, доступных на базовом трейте `Seq`, для которых результат - это новая коллекция). diff --git a/_ru/overviews/collections-2.13/sets.md b/_ru/overviews/collections-2.13/sets.md index 20becc4ffa..d57e891797 100644 --- a/_ru/overviews/collections-2.13/sets.md +++ b/_ru/overviews/collections-2.13/sets.md @@ -112,7 +112,7 @@ language: ru Два дочерних трейта множеств `SortedSet` и `BitSet`. ### Отсортированное Множество (SortedSet) ### -[SortedSet](https://www.scala-lang.org/api/current/scala/collection/SortedSet.html) это множество, которое отдает свои элементы (используя `iterator` или `foreach`) в заданном порядке (который можно свободно задать в момент создания множества). Стандартное представление [SortedSet](https://www.scala-lang.org/api/current/scala/collection/SortedSet.html) - это упорядоченное двоичное дерево, которое поддерживает свойство того, что все элементы левого поддерева меньше, чем все элементы правого поддерева. Таким образом, простой упорядоченный обход может вернуть все элементы дерева в возрастающем порядке. Scala класс [immutable.TreeSet](https://www.scala-lang.org/api/current/scala/collection/immutable/TreeSet.html) базируется на _красно-черном_ дереве, в котором сохраняется тоже свойство но при этом само дерево является _сбалансированным_ --, то есть все пути от корня дерева до листа имеют длину, которая может отличаться друг от друга максимум на еденицу. +[SortedSet](https://www.scala-lang.org/api/current/scala/collection/SortedSet.html) это множество, которое отдает свои элементы (используя `iterator` или `foreach`) в заданном порядке (который можно свободно задать в момент создания множества). Стандартное представление [SortedSet](https://www.scala-lang.org/api/current/scala/collection/SortedSet.html) - это упорядоченное двоичное дерево, которое поддерживает свойство того, что все элементы левого поддерева меньше, чем все элементы правого поддерева. Таким образом, простой упорядоченный обход может вернуть все элементы дерева в возрастающем порядке. Scala класс [immutable.TreeSet](https://www.scala-lang.org/api/current/scala/collection/immutable/TreeSet.html) базируется на _красно-черном_ дереве, в котором сохраняется тоже свойство но при этом само дерево является _сбалансированным_ --, то есть все пути от корня дерева до листа имеют длину, которая может отличаться друг от друга максимум на единицу. При создании пустого [TreeSet](https://www.scala-lang.org/api/current/scala/collection/immutable/TreeSet.html), можно сначала указать требуемый порядок: @@ -129,7 +129,7 @@ language: ru scala> TreeSet.empty[String] res2: scala.collection.immutable.TreeSet[String] = TreeSet() -Если вы создаете новое множество из существующего упорядоченного множества (например, путем объединения или фильтрации), оно будет иметь туже схему упорядочения элементов, что и исходное множество. Например +Если вы создаете новое множество из существующего упорядоченного множества (например, путем объединения или фильтрации), оно будет иметь ту же схему упорядочения элементов, что и исходное множество. Например scala> res2 + "one" + "two" + "three" + "four" res3: scala.collection.immutable.TreeSet[String] = TreeSet(four, one, three, two) diff --git a/_ru/overviews/collections-2.13/strings.md b/_ru/overviews/collections-2.13/strings.md index 17e13d1a14..141b537e76 100644 --- a/_ru/overviews/collections-2.13/strings.md +++ b/_ru/overviews/collections-2.13/strings.md @@ -9,7 +9,7 @@ next-page: performance-characteristics language: ru --- -Как и массивы, строки не являются непосредственно последовательностями, но могут быть преобразованы в них, а также поддерживают все операции которые есть у последовательностей. Ниже приведены некоторые примеры операций, которые можно вызывать на строках. +Как и массивы, строки не являются непосредственно последовательностями, но могут быть преобразованы в них, а также поддерживают все операции, которые есть у последовательностей. Ниже приведены некоторые примеры операций, которые можно вызывать на строках. scala> val str = "hello" str: java.lang.String = hello diff --git a/_ru/overviews/collections-2.13/trait-iterable.md b/_ru/overviews/collections-2.13/trait-iterable.md index b02ffd19a1..3af59d11d6 100644 --- a/_ru/overviews/collections-2.13/trait-iterable.md +++ b/_ru/overviews/collections-2.13/trait-iterable.md @@ -31,7 +31,7 @@ language: ru * **Строковая** операции `mkString`, `addString`, `className`, которые дают альтернативные способы преобразования коллекции в строку. * **Отображения** - это такая коллекция, которая лениво вычисляется. Позже мы расмотрим отображения [подробнее]({% link _ru/overviews/collections-2.13/views.md %}). -В `Iterable` есть два метода, которые возвращают итераторы: `grouped` и `sliding`. Правда эти итераторы возвращают не отдельные элементы, а целые подпоследовательности элементов исходной коллекции. Максимальный размер таких подпоследовательностей задается аргументом. Метод `grouped` возвращает свои элементы "нарезанные" на фиксированные части, тогда как `sliding` возвращает результат "прохода окна" (заданной длинны) над элементами. Разница между ними станет очевидной, если взглянуть на следующий результат в консоли: +В `Iterable` есть два метода, которые возвращают итераторы: `grouped` и `sliding`. Правда, эти итераторы возвращают не отдельные элементы, а целые подпоследовательности элементов исходной коллекции. Максимальный размер таких подпоследовательностей задается аргументом. Метод `grouped` возвращает свои элементы "нарезанные" на фиксированные части, тогда как `sliding` возвращает результат "прохода окна" (заданной длинны) над элементами. Разница между ними станет очевидной, если взглянуть на следующий результат в консоли: scala> val xs = List(1, 2, 3, 4, 5) xs: List[Int] = List(1, 2, 3, 4, 5) diff --git a/_ru/overviews/collections-2.13/views.md b/_ru/overviews/collections-2.13/views.md index 3b8a5f5d76..a26760f360 100644 --- a/_ru/overviews/collections-2.13/views.md +++ b/_ru/overviews/collections-2.13/views.md @@ -34,7 +34,7 @@ language: ru res5: scala.collection.immutable.Vector[Int] = Vector(4, 6, 8, 10, 12, 14, 16, 18, 20, 22) -В последней строчке выражение `v map (_ + 1)` создает новый вектор, который при втором вызове в `map (_ * 2)` превращается в третий вектор. Как правило построение промежуточного результата от первого вызова мапы расточительно. В приведенном выше примере было бы быстрее составить единую мапу, состоящую из двух функций `(_ + 1)` и `(_ * 2)`. Если у вас обе функции доступны в одном и том же выражении, вы можете объеденить их вручную. Но довольно часто последовательные преобразования структуры данных выполняются в различных модулях программы. Слияние этих преобразований отрицательно скажется на модульности. Более универсальным способом избежать промежуточных результатов - это превратить вектор сначало в отображение, затем примененить все преобразования к отображению и, наконец, преобразовать отображение в вектор: +В последней строчке выражение `v map (_ + 1)` создает новый вектор, который при втором вызове в `map (_ * 2)` превращается в третий вектор. Как правило, построение промежуточного результата от первого вызова мапы расточительно. В приведенном выше примере было бы быстрее составить единую мапу, состоящую из двух функций `(_ + 1)` и `(_ * 2)`. Если у вас обе функции доступны в одном и том же выражении, вы можете объединить их вручную. Но довольно часто последовательные преобразования структуры данных выполняются в различных модулях программы. Слияние этих преобразований отрицательно скажется на модульности. Более универсальным способом избежать промежуточных результатов - это превратить вектор сначало в отображение, затем применить все преобразования к отображению и, наконец, преобразовать отображение в вектор: scala> (v.view map (_ + 1) map (_ * 2)).to(Vector) res12: scala.collection.immutable.Vector[Int] = @@ -45,7 +45,7 @@ language: ru scala> val vv = v.view vv: scala.collection.IndexedSeqView[Int] = IndexedSeqView(<not computed>) -Применение `v.view` дает нам `IndexedSeqView[Int]`, тоесть лениво вычисляемым `IndexedSeq[Int]`. Также как и `LazyList`, +Применение `v.view` дает нам `IndexedSeqView[Int]`, тоесть лениво вычисляемым `IndexedSeq[Int]`. Так же как и `LazyList`, метод `toString` на отображении не принуждает выводить элементы, вот почему содержимое `vv` выводится как `View(?)`. Применение первого `map` к отображению дает: From 12c3de30ce2d4bd55deb322bc254747dc23bc90a Mon Sep 17 00:00:00 2001 From: James Ma <44740178+jamesma100@users.noreply.github.com> Date: Mon, 24 Jul 2023 06:16:52 -0700 Subject: [PATCH 2676/3075] minor fixes to concurrency page (#2874) * minor fixes to concurrency page If the user has been following along with a Scala REPL, `eventualInt` will have already been completed, and thus will return a result. Calling the function again and wrapping it in a Future will deterministically produce the intended result of an uncompleted Future. * same fix for callback section --- _overviews/scala3-book/concurrency.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/concurrency.md b/_overviews/scala3-book/concurrency.md index 173e0ff72a..6740910c4a 100644 --- a/_overviews/scala3-book/concurrency.md +++ b/_overviews/scala3-book/concurrency.md @@ -117,10 +117,10 @@ Therefore, when you work with the result of a future, you use the usual `Try`-ha ### Using `map` with futures `Future` has a `map` method, which you use just like the `map` method on collections. -This is what the result looks like when you call `map` right after creating the variable `f`: +This is what the result looks like when you call `map` right after creating the variable `a`: ```scala -scala> val a = eventualInt.map(_ * 2) +scala> val a = Future(longRunningAlgorithm()).map(_ * 2) a: scala.concurrent.Future[Int] = Future(<not completed>) ``` @@ -141,7 +141,7 @@ In addition to higher-order functions like `map`, you can also use callback meth One commonly used callback method is `onComplete`, which takes a *partial function* in which you handle the `Success` and `Failure` cases: ```scala -eventualInt.onComplete { +Future(longRunningAlgorithm()).onComplete { case Success(value) => println(s"Got the callback, value = $value") case Failure(e) => e.printStackTrace } From 81d3ed7c0d8a1a958e0161f4735b1bbbb4bcaaf9 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Wed, 26 Jul 2023 10:28:03 +0200 Subject: [PATCH 2677/3075] Introduce SIP Manager role (#2832) Co-authored-by: Philippus Baalman <philippus@gmail.com> Co-authored-by: Seth Tisue <seth@tisue.net> --- _sips/process-specification.md | 26 ++++++++++++++++---------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/_sips/process-specification.md b/_sips/process-specification.md index d602357e3b..c7380f68f2 100644 --- a/_sips/process-specification.md +++ b/_sips/process-specification.md @@ -48,6 +48,8 @@ from an idea to the inclusion in the language. - SIP Reviewers: a subset of Committee Members assigned by the Chairperson to review in detail a particular SIP. The same person cannot be both a SIP Author and a SIP Reviewer for the same SIP. +- SIP Manager: one of the SIP Reviewers who is responsible for all the + communications related to the SIP, throughout its entire life-cycle. This includes requesting a vote on the SIP from the whole Committee, presenting the SIP to the Committee at the plenary meetings, merging or closing the corresponding PR, reporting to the community on the vote outcome, and announcing when it is available for testing. ## Stages @@ -127,8 +129,9 @@ To submit a SIP, a SIP Author writes a pull request to the repository, following the [tutorial]({% link _sips/sip-tutorial.md %}), and pointing to the Pre-SIP discussion. If the proposal correctly follows the template, and the Pre-SIP discussion seems to show some community support, -the Chairperson will accept the SIP for review, assign a SIP number, and assign -3 reviewers to the SIP among the Committee Members. Since "community support" is +the Chairperson will accept the SIP for review, assign a SIP number, assign +3 reviewers to the SIP among the Committee Members, and assign one of the reviewers +to be the Manager of that SIP. Since "community support" is loosely defined, any Committee Member can also comment on the PR to accept the SIP for review (this is meant mostly as an escape hatch to prevent the Chairperson from unilaterally blocking a SIP from entering the process). From @@ -169,7 +172,7 @@ After each request for a new review, the reviewers have 3 weeks to do another round. When the reviewers are confident that the SIP is in good shape to be discussed -with the full Committee, they set its status to "Vote Requested" and decide on a +with the full Committee, the Manager sets its status to "Vote Requested" and decide on a Vote Recommendation that they will bring to the Committee. A Vote Recommendation is either "Recommend Accept" or "Recommend Reject". The proposal is then scheduled on the agenda of the next Committee meeting (which happens once a @@ -183,7 +186,7 @@ the SIP will automatically be considered to be Withdrawn. ### Design Stage -- Vote -During the Committee meeting, the reviewers of any scheduled SIP present the SIP +During the Committee meeting, the Managers of any scheduled SIP present the SIP to the Committee, their recommendation, and explain why they made that recommendation. After discussion, the Committee votes for advancing the SIP to the Implementation Stage. There are three possible outcomes: @@ -203,11 +206,13 @@ must gather strictly more than 50% of "Advance" votes among the whole Committee. For instance, if the Committee is made of 11 members, at least 6 members have to vote "Advance" for the SIP to move to the next stage. -If there was a strict majority in favor of "Advance", the PR for the SIP is Merged at this point. +If there was a strict majority in favor of "Advance", the PR for the SIP is Merged at this point by its Manager. Otherwise, a second vote between Reject and Keep will be used. A proposal needs more than 50% "Reject" votes to be rejected in that case. Otherwise, it is kept. +The SIP Manager shares the outcome of the vote with the community by posting a comment to proposal’s Pre-SIP discussion. + ### Implementation Stage Once in the implementation stage, the Committee is not concerned with the SIP @@ -216,16 +221,16 @@ The SIP is now a recommendation for the compiler team or any other individual or group of people to provide an implementation of the proposal, as a pull request to the Scala 3 compiler repository. There is no set timeline for this phase. -An implementation will be reviewed by the compiler team, and once the -implementation is deemed good enough, it can ship as an Experimental feature in -the following practical release of the compiler. - Often, proposals not only need to be implemented in the compiler, but also in several other tools (IDEs, syntax highlighters, code formatters, etc.). As soon -as a proposal reaches the implementation stage, the Committee notifies the +as a proposal reaches the implementation stage, the Chairperson notifies the impacted tools that they should start implementing support for it. A list of tools of the ecosystem is maintained in [this document][tooling ecosystem]. +An implementation will be reviewed by the compiler team, and once the +implementation is deemed good enough, it can ship as an Experimental feature in +the next release of the compiler where it's practical to do so. At that point, the SIP Manager posts a follow-up comment on the Pre-SIP discussion to invite the community to test the feature and provide feedback. + The implementers may hit challenges that were not foreseen by the Committee. Early users may also provide feedback based on practical experience with the Experimental feature. This feedback can be sent back to the Committee by @@ -299,6 +304,7 @@ If a Committee Member cannot attend a meeting, they are welcome to share their f 4. Explain the latest progress in every meeting. - Play a role in the discussions, learn in advance about the topic if needed, and make up their mind in the voting process. +- Establish communication channels with the community to share updates about the evolution of proposals and collect feedback. ### Guests From cd8f289f164a596fc228c49c38908bcd1b70fc77 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Thu, 27 Jul 2023 00:21:43 +0000 Subject: [PATCH 2678/3075] Update SIPs state --- _sips/sips/scala-cli.md | 44 +++++++++-------------------------------- 1 file changed, 9 insertions(+), 35 deletions(-) diff --git a/_sips/sips/scala-cli.md b/_sips/sips/scala-cli.md index 7a25af1001..2a3ba1577e 100644 --- a/_sips/sips/scala-cli.md +++ b/_sips/sips/scala-cli.md @@ -624,49 +624,26 @@ As a part of this SIP we propose to introduce Using Directives, a special commen Using directives can be place on only top of the file (above imports, package definition etx.) and can be proceed only by plain comments (e.g. to comment out an using directive) -Comments containing directives needs to start by `>`, for example: +Comments containing directives needs to start by `//>`, for example: ``` -//> using Scala 3 -/*> using - Scala 3 - option "-Xfatal-warning" -*/ +//> using scala 3 +//> using platform scala-js +//> using options -Xasync ``` We propose following sytax for Using Directives (within special comments described above): ``` -UsingDirective ::= "using" (Setting | Settings) -Settings ::= "{" Setting { ";" Setting } [";"] "}" -Setting ::= Ident [Values | Settings] -Ident ::= ScalaIdent { “.” ScalaIdent } -Values ::= Value { "," Value} [","] -Value ::= stringLiteral | ["-"] numericLiteral | true | false +UsingDirective ::= "using" Setting +Setting ::= Ident ( Value | Values ) +Ident ::= ScalaIdent { "." ScalaIdent } +Values ::= Value { " " [","] Values } +Value ::= Ident | stringLiteral | numericLiteral | true | false ``` Where: -- A Settings block is similar to the standard Scala code block. Braces and indentation syntax is allowed. e.g.: - - -``` -someSettings { setting1 value 1; setting2; } - -// or - -someSettings { - setting1 - setting2 -} - -// or - -someSettings: - setting1 - setting2 -``` - - Ident is the standard Scala identifier or list of identifiers separated by dots: ``` @@ -680,9 +657,6 @@ foo.bar - String literals and numeric literals are similar to Scala. - No value after the identifier is treated as true value: `using scalaSettings.fatalWarnings` - Specifying a setting with the same path more than once and specifying the same setting with a list of values are equivalent -- A path created using dot-separated idents is semantically equivalent to a path created by nesting idents: -`foo.bar` is equivalent to `foo { bar }` - The list of proposed directives split into MUST have and SHOULD have groups: From 5d69b1307ec0a62eabeb5ec5866456c23d6e95c8 Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy <julien@richard-foy.fr> Date: Thu, 27 Jul 2023 15:53:20 +0200 Subject: [PATCH 2679/3075] Update the SIP members for the next season --- _sips/process-specification.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/_sips/process-specification.md b/_sips/process-specification.md index c7380f68f2..a35aeaeef1 100644 --- a/_sips/process-specification.md +++ b/_sips/process-specification.md @@ -263,17 +263,16 @@ The current committee members are: - Chris Andrews ([@chrisandrews-ms](https://github.com/chrisandrews-ms)), Morgan Stanley - Gabriele Petronella ([@gabro](https://github.com/gabro)), buildo - Guillaume Martres ([@smarter](https://github.com/smarter)), EPFL -- Iulian Dragos ([@dragos](https://github.com/dragos)), Databricks +- Haoyi Li ([@lihaoyi](https://github.com/lihaoyi)), Databricks - Lukas Rytz ([@lrytz](https://github.com/lrytz)), Lightbend - Martin Odersky ([@odersky](https://github.com/odersky)), EPFL - Oron Port ([@soronpo](https://github.com/soronpo)), DFiant Inc - Paweł Marks ([@Kordyjan](https://github.com/Kordyjan)), VirtusLab -- Raúl Raja ([@raulraja](https://github.com/raulraja)), 47Degrees - Sébastien Doeraene ([@sjrd](https://github.com/sjrd)), Scala Center The current Chairperson is: -- Julien Richard-Foy ([@julienrf](https://github.com/julienrf)), Scala Center +- Anatolii Kmetiuk ([@Toli](https://github.com/anatoliykmetyuk)), Scala Center The current Secretary is: From c640e4deae6fad0f83fb4dfab42677192ba8b870 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 31 Jul 2023 12:19:14 +0300 Subject: [PATCH 2680/3075] Add contextual abstraction in ru (#2868) * Add ca-contextual-abstractions-intro.md in russian * Add ca-contextual-abstractions-intro.md in russian * Add ca-contextual-abstractions-intro.md in russian --- _includes/version-specific-notice.html | 30 +++- _layouts/multipage-overview.html | 7 +- .../ca-contextual-abstractions-intro.md | 2 +- .../scala3-book/ca-extension-methods.md | 2 +- .../book/ca-contextual-abstractions-intro.md | 96 ++++++++++++ _ru/scala3/book/ca-extension-methods.md | 145 ++++++++++++++++++ _ru/scala3/book/types-adts-gadts.md | 1 + _ru/scala3/book/types-others.md | 2 +- _ru/scala3/book/types-union.md | 3 +- 9 files changed, 274 insertions(+), 14 deletions(-) create mode 100644 _ru/scala3/book/ca-contextual-abstractions-intro.md create mode 100644 _ru/scala3/book/ca-extension-methods.md diff --git a/_includes/version-specific-notice.html b/_includes/version-specific-notice.html index 1a9ea6832b..4a92f84a6d 100644 --- a/_includes/version-specific-notice.html +++ b/_includes/version-specific-notice.html @@ -2,15 +2,29 @@ <blockquote class="help-info"> <i class="fa fa-info"></i><span style="margin-left: 0.5rem"> {% if include.language == 'scala3' %} - This doc page is specific to Scala 3, - and may cover new concepts not available in Scala 2. Unless - otherwise stated, all the code examples in this page assume - you are using Scala 3. + {% if include.page-language == 'ru' %} + Эта страница документа относится к Scala 3 и + может охватывать новые концепции, недоступные в Scala 2. + Если не указано явно, все примеры кода на этой странице + предполагают, что вы используете Scala 3. + {% else %} + This doc page is specific to Scala 3, + and may cover new concepts not available in Scala 2. Unless + otherwise stated, all the code examples in this page assume + you are using Scala 3. + {% endif %} {% else if include.language == 'scala2' %} - This doc page is specific to features shipped in Scala 2, - which have either been removed in Scala 3 or replaced by an - alternative. Unless otherwise stated, all the code examples - in this page assume you are using Scala 2. + {% if include.page-language == 'ru' %} + Эта страница документа относится к функциям, представленным в Scala 2, + которые либо были удалены в Scala 3, либо заменены альтернативными. + Если не указано явно, все примеры кода на этой странице предполагают, + что вы используете Scala 2. + {% else %} + This doc page is specific to features shipped in Scala 2, + which have either been removed in Scala 3 or replaced by an + alternative. Unless otherwise stated, all the code examples + in this page assume you are using Scala 2. + {% endif %} {% endif %} </span> </blockquote> diff --git a/_layouts/multipage-overview.html b/_layouts/multipage-overview.html index a9162e4d3d..6ff8b3aa85 100644 --- a/_layouts/multipage-overview.html +++ b/_layouts/multipage-overview.html @@ -18,7 +18,12 @@ {% else if page.scala2 %} {% assign versionSpecificLang = 'scala2' %} {% endif %} - {% include version-specific-notice.html language=versionSpecificLang %} + {% if page.language %} + {% assign pageLanguage = page.language %} + {% else %} + {% assign pageLanguage = 'en' %} + {% endif %} + {% include version-specific-notice.html language=versionSpecificLang page-language=pageLanguage %} {% endif %} <noscript> <blockquote> diff --git a/_overviews/scala3-book/ca-contextual-abstractions-intro.md b/_overviews/scala3-book/ca-contextual-abstractions-intro.md index 33c10dd6cb..c6ec74ec17 100644 --- a/_overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -2,7 +2,7 @@ title: Contextual Abstractions type: chapter description: This chapter provides an introduction to the Scala 3 concept of Contextual Abstractions. -languages: [zh-cn] +languages: [ru, zh-cn] num: 59 previous-page: types-others next-page: ca-extension-methods diff --git a/_overviews/scala3-book/ca-extension-methods.md b/_overviews/scala3-book/ca-extension-methods.md index 65b30183f4..9f54297f94 100644 --- a/_overviews/scala3-book/ca-extension-methods.md +++ b/_overviews/scala3-book/ca-extension-methods.md @@ -2,7 +2,7 @@ title: Extension Methods type: section description: This page demonstrates how Extension Methods work in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 60 previous-page: ca-contextual-abstractions-intro next-page: ca-context-parameters diff --git a/_ru/scala3/book/ca-contextual-abstractions-intro.md b/_ru/scala3/book/ca-contextual-abstractions-intro.md new file mode 100644 index 0000000000..eef3910c30 --- /dev/null +++ b/_ru/scala3/book/ca-contextual-abstractions-intro.md @@ -0,0 +1,96 @@ +--- +layout: multipage-overview +title: Контекстные абстракции +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: chapter +description: В этой главе представлено введение в концепцию контекстных абстракций Scala 3. +language: ru +num: 59 +previous-page: types-others +next-page: ca-extension-methods +--- + +## Предпосылка + +Контекстные абстракции — это способ абстрагироваться от контекста. +Они представляют собой единую парадигму с большим разнообразием вариантов использования, среди которых: + +- реализация тайп классов (_type classes_) +- установление контекста +- внедрение зависимости (_dependency injection_) +- выражение возможностей +- вычисление новых типов и доказательство взаимосвязей между ними + +В этом отношении Scala оказала влияние на другие языки. Например, трейты в Rust или protocol extensions Swift. +Предложения по дизайну также представлены для Kotlin в качестве разрешения зависимостей во время компиляции, +для C# в качестве Shapes и Extensions или для F# в качестве Traits. +Контекстные абстракции также являются общей особенностью средств доказательства теорем, таких как Coq или Agda. + +Несмотря на то, что в этих проектах используется разная терминология, +все они являются вариантами основной идеи вывода терминов (term inference): +учитывая тип, компилятор синтезирует "канонический" термин, который имеет этот тип. + +## Редизайн в Scala 3 + +В Scala 2 контекстные абстракции поддерживаются пометкой `implicit` определений (методов и значений) или параметров +(см. [Параметры контекста]({% link _overviews/scala3-book/ca-context-parameters.md %})). + +Scala 3 включает в себя переработку контекстных абстракций. +Хотя эти концепции постепенно "открывались" в Scala 2, теперь они хорошо известны и понятны, и редизайн использует эти знания. + +Дизайн Scala 3 фокусируется на **намерении**, а не на **механизме**. +Вместо того, чтобы предлагать одну очень мощную функцию имплицитов, +Scala 3 предлагает несколько функций, ориентированных на варианты использования: + +- **Расширение классов задним числом**. + В Scala 2 методы расширения должны были кодироваться с использованием [неявных преобразований][implicit-conversions] или [неявных классов]({% link _overviews/core/implicit-classes.md %}). + Напротив, в Scala 3 [методы расширения][extension-methods] теперь встроены непосредственно в язык, что приводит к улучшению сообщений об ошибках и улучшению вывода типов. + +- **Абстрагирование контекстной информации**. + [Предложения Using][givens] позволяют программистам абстрагироваться от информации, + которая доступна в контексте вызова и должна передаваться неявно. + В качестве улучшения по сравнению со Scala 2 подразумевается, что предложения using могут быть указаны по типу, + освобождая сигнатуры функций от имен переменных, на которые никогда не ссылаются явно. + +- **Предоставление экземпляров тайп-классов**. + [Given экземпляры][givens] позволяют программистам определять _каноническое значение_ определенного типа. + Это делает программирование с [тайп-классами][type-classes] более простым без утечек деталей реализации. + +- **Неявное преобразование одного типа в другой**. + Неявное преобразование было [переработано с нуля][implicit-conversions] как экземпляры тайп-класса `Conversion`. + +- **Контекстные абстракции высшего порядка**. + _Совершенно новая_ функция [контекстных функций][contextual-functions] делает контекстные абстракции объектами первого класса. + Они являются важным инструментом для авторов библиотек и позволяют выражать лаконичный DSL. + +- **Полезная обратная связь от компилятора**. + Если компилятор не может разрешить неявный параметр, теперь он предлагает [предложения по импорту](https://www.scala-lang.org/blog/2020/05/05/scala-3-import-suggestions.html), которые могут решить проблему. + +## Преимущества + +Эти изменения в Scala 3 обеспечивают лучшее разделение вывода терминов от остального языка: + +- существует единственный способ определить данные +- существует единственный способ ввести неявные параметры и аргументы +- существует отдельный способ [импорта givens][given-imports], который не позволяет им прятаться в море обычного импорта +- существует единственный способ определить [неявное преобразование][implicit-conversions], которое четко обозначено как таковое и не требует специального синтаксиса + +К преимуществам этих изменений относятся: + +- новый дизайн позволяет избежать взаимодействия функций и делает язык более согласованным +- implicits становятся более легкими для изучения и более сложными для злоупотреблений +- значительно улучшается ясность 95% программ Scala, использующих implicits +- есть потенциал, чтобы сделать вывод термов однозначным способом, который также доступен и удобен. + +В этой главе в следующих разделах представлены многие из этих новых функций. + +[givens]: {% link _overviews/scala3-book/ca-context-parameters.md %} +[given-imports]: {% link _overviews/scala3-book/ca-given-imports.md %} +[implicit-conversions]: {% link _overviews/scala3-book/ca-implicit-conversions.md %} +[extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[context-bounds]: {% link _overviews/scala3-book/ca-context-bounds.md %} +[type-classes]: {% link _overviews/scala3-book/ca-type-classes.md %} +[equality]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} +[contextual-functions]: {{ site.scala3ref }}/contextual/context-functions.html diff --git a/_ru/scala3/book/ca-extension-methods.md b/_ru/scala3/book/ca-extension-methods.md new file mode 100644 index 0000000000..672f7d54e3 --- /dev/null +++ b/_ru/scala3/book/ca-extension-methods.md @@ -0,0 +1,145 @@ +--- +layout: multipage-overview +title: Методы расширения +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этой главе представлена работа методов расширения в Scala 3. +language: ru +num: 60 +previous-page: ca-contextual-abstractions-intro +next-page: +versionSpecific: true +--- + +В Scala 2 аналогичного результата можно добиться с помощью [неявных классов]({% link _overviews/core/implicit-classes.md %}). + +--- + +Методы расширения позволяют добавлять методы к типу после того, как он был определен, +т.е. они позволяют добавлять новые методы в закрытые классы. +Например, представьте, что кто-то создал класс `Circle`: + +{% tabs ext1 %} +{% tab 'Scala 2 и 3' %} + +```scala +case class Circle(x: Double, y: Double, radius: Double) +``` + +{% endtab %} +{% endtabs %} + +Теперь представим, что необходим метод `circumference`, но нет возможности изменить исходный код `Circle`. +До того как концепция вывода терминов была введена в языки программирования, +единственное, что можно было сделать, это написать метод в отдельном классе или объекте, подобном этому: + +{% tabs ext2 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +object CircleHelpers { + def circumference(c: Circle): Double = c.radius * math.Pi * 2 +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +object CircleHelpers: + def circumference(c: Circle): Double = c.radius * math.Pi * 2 +``` + +{% endtab %} +{% endtabs %} + +Затем этот метод можно было использовать следующим образом: + +{% tabs ext3 %} +{% tab 'Scala 2 и 3' %} + +```scala +val aCircle = Circle(2, 3, 5) + +// без использования метода расширения +CircleHelpers.circumference(aCircle) +``` + +{% endtab %} +{% endtabs %} + +Но методы расширения позволяют создать метод `circumference` для работы с экземплярами `Circle`: + +{% tabs ext4 %} +{% tab 'Только в Scala 3' %} + +```scala +extension (c: Circle) + def circumference: Double = c.radius * math.Pi * 2 +``` + +{% endtab %} +{% endtabs %} + +В этом коде: + +- `Circle` — это тип, к которому будет добавлен метод расширения `circumference` +- Синтаксис `c: Circle` позволяет ссылаться на переменную `c` в методах расширения + +Затем в коде метод `circumference` можно использовать так же, как если бы он был изначально определен в классе `Circle`: + +{% tabs ext5 %} +{% tab 'Только в Scala 3' %} + +```scala +aCircle.circumference +``` + +{% endtab %} +{% endtabs %} + +### Импорт методов расширения + +Представим, что `circumference` определен в пакете `lib` - его можно импортировать с помощью + +{% tabs ext6 %} +{% tab 'Только в Scala 3' %} + +```scala +import lib.circumference + +aCircle.circumference +``` + +{% endtab %} +{% endtabs %} + +Если импорт отсутствует, то компилятор выводит подробное сообщение об ошибке, подсказывая возможный импорт, например так: + +```text +value circumference is not a member of Circle, but could be made available as an extension method. + +The following import might fix the problem: + + import lib.circumference +``` + +## Обсуждение + +Ключевое слово `extension` объявляет о намерении определить один или несколько методов расширения для типа, заключенного в круглые скобки. +Чтобы определить для типа несколько методов расширения, используется следующий синтаксис: + +{% tabs ext7 %} +{% tab 'Только в Scala 3' %} + +```scala +extension (c: Circle) + def circumference: Double = c.radius * math.Pi * 2 + def diameter: Double = c.radius * 2 + def area: Double = math.Pi * c.radius * c.radius +``` + +{% endtab %} +{% endtabs %} diff --git a/_ru/scala3/book/types-adts-gadts.md b/_ru/scala3/book/types-adts-gadts.md index 199d7f1f33..50091980e3 100644 --- a/_ru/scala3/book/types-adts-gadts.md +++ b/_ru/scala3/book/types-adts-gadts.md @@ -10,6 +10,7 @@ language: ru num: 53 previous-page: types-union next-page: types-variance +versionSpecific: true --- <span class="tag tag-inline">Только в Scala 3</span> diff --git a/_ru/scala3/book/types-others.md b/_ru/scala3/book/types-others.md index a1024a7970..25a0437b1d 100644 --- a/_ru/scala3/book/types-others.md +++ b/_ru/scala3/book/types-others.md @@ -9,7 +9,7 @@ description: В этом разделе упоминаются другие ра language: ru num: 58 previous-page: types-dependent-function -next-page: +next-page: ca-contextual-abstractions-intro --- В Scala есть несколько других расширенных типов, которые не показаны в этой книге, в том числе: diff --git a/_ru/scala3/book/types-union.md b/_ru/scala3/book/types-union.md index 6185d59e12..5c3a089488 100644 --- a/_ru/scala3/book/types-union.md +++ b/_ru/scala3/book/types-union.md @@ -10,10 +10,9 @@ language: ru num: 52 previous-page: types-intersection next-page: types-adts-gadts +versionSpecific: true --- -<span class="tag tag-inline">Только в Scala 3</span> - Используемый для типов `|` оператор создает так называемый _тип объединения_ (_union type_). Тип `А | B` представляет значения, которые относятся **либо** к типу `A`, **либо** к типу `B`. From f819c0e3f0b08bc342dc3697a0dbd676596e8b5a Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Thu, 3 Aug 2023 10:17:54 +0300 Subject: [PATCH 2681/3075] Ni mark scala 3 only in ru (#2879) * Update compound-types.md in russian * Add mark "Scala 3 Only" in ru --- _ru/scala3/book/types-dependent-function.md | 1 + _ru/scala3/book/types-opaque-types.md | 6 +++++- _ru/scala3/book/types-others.md | 3 ++- _ru/scala3/book/types-structural.md | 6 ++++++ 4 files changed, 14 insertions(+), 2 deletions(-) diff --git a/_ru/scala3/book/types-dependent-function.md b/_ru/scala3/book/types-dependent-function.md index 43cfba3a7c..88750e2ec5 100644 --- a/_ru/scala3/book/types-dependent-function.md +++ b/_ru/scala3/book/types-dependent-function.md @@ -10,6 +10,7 @@ language: ru num: 57 previous-page: types-structural next-page: types-others +versionSpecific: true --- _Зависимый тип функции_ (_dependent function type_) описывает типы функций, diff --git a/_ru/scala3/book/types-opaque-types.md b/_ru/scala3/book/types-opaque-types.md index 54522dafd9..f6942738a9 100644 --- a/_ru/scala3/book/types-opaque-types.md +++ b/_ru/scala3/book/types-opaque-types.md @@ -10,9 +10,12 @@ language: ru num: 55 previous-page: types-variance next-page: types-structural +versionSpecific: true --- -В Scala 3 _непрозрачные псевдонимы типов_ (_opaque type aliases_) обеспечивают абстракции типов без каких-либо **накладных расходов**. +_Непрозрачные псевдонимы типов_ (_opaque type aliases_) обеспечивают абстракцию типов без каких-либо **накладных расходов**. + +В Scala 2 аналогичный результат можно получить с помощью [классов значений][value-classes]. ## Накладные расходы на абстракцию @@ -172,3 +175,4 @@ val d: Double = log2 // ERROR: Found Logarithm required Double Как показано выше, непрозрачные типы удобны в использовании и очень хорошо интегрируются с [функцией методов расширения][extension]. [extension]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[value-classes]: {% link _overviews/core/value-classes.md %} diff --git a/_ru/scala3/book/types-others.md b/_ru/scala3/book/types-others.md index 25a0437b1d..5f01514837 100644 --- a/_ru/scala3/book/types-others.md +++ b/_ru/scala3/book/types-others.md @@ -10,6 +10,7 @@ language: ru num: 58 previous-page: types-dependent-function next-page: ca-contextual-abstractions-intro +versionSpecific: true --- В Scala есть несколько других расширенных типов, которые не показаны в этой книге, в том числе: @@ -22,6 +23,6 @@ next-page: ca-contextual-abstractions-intro - Типы уточнения - Вид полиморфизма -Дополнительные сведения об этих типах см. в [Справочной документации][reference]. +Дополнительные сведения об этих типах см. в [Справочной документации Scala 3][reference]. [reference]: {{ site.scala3ref }}/overview.html diff --git a/_ru/scala3/book/types-structural.md b/_ru/scala3/book/types-structural.md index 911bc02cbe..103e6db389 100644 --- a/_ru/scala3/book/types-structural.md +++ b/_ru/scala3/book/types-structural.md @@ -10,8 +10,14 @@ language: ru num: 56 previous-page: types-opaque-types next-page: types-dependent-function +versionSpecific: true --- +_Scala 2 содержит более слабую форму структурных типов, основанную на Java reflection, +достигаемую с помощью `import scala.language.reflectiveCalls`_. + +## Введение + Некоторые варианты использования, такие как моделирование доступа к базе данных, более удобны в динамически типизированных языках, чем в статически типизированных языках. С динамически типизированными языками естественно моделировать строку как запись или объект From 5d13fe8a69845f3a5f87db4dd794c519c93a3211 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Thu, 3 Aug 2023 10:18:31 +0300 Subject: [PATCH 2682/3075] Add context params in ru (#2878) * Update compound-types.md in russian * Add ca-context-bounds.md, ca-context-parameters.md in russian * Add ca-context-bounds.md, ca-context-parameters.md in russian --- _overviews/scala3-book/ca-context-bounds.md | 2 +- .../scala3-book/ca-context-parameters.md | 2 +- _ru/scala3/book/ca-context-bounds.md | 141 +++++++++++++ _ru/scala3/book/ca-context-parameters.md | 196 ++++++++++++++++++ _ru/scala3/book/ca-extension-methods.md | 2 +- 5 files changed, 340 insertions(+), 3 deletions(-) create mode 100644 _ru/scala3/book/ca-context-bounds.md create mode 100644 _ru/scala3/book/ca-context-parameters.md diff --git a/_overviews/scala3-book/ca-context-bounds.md b/_overviews/scala3-book/ca-context-bounds.md index efafda98d8..2d36d7b3cc 100644 --- a/_overviews/scala3-book/ca-context-bounds.md +++ b/_overviews/scala3-book/ca-context-bounds.md @@ -2,7 +2,7 @@ title: Context Bounds type: section description: This page demonstrates Context Bounds in Scala. -languages: [zh-cn] +languages: [ru, zh-cn] num: 62 previous-page: ca-context-parameters next-page: ca-given-imports diff --git a/_overviews/scala3-book/ca-context-parameters.md b/_overviews/scala3-book/ca-context-parameters.md index 5ae6c43b39..d91a3c0cc3 100644 --- a/_overviews/scala3-book/ca-context-parameters.md +++ b/_overviews/scala3-book/ca-context-parameters.md @@ -2,7 +2,7 @@ title: Context Parameters type: section description: This page demonstrates how to declare context parameters, and how the compiler infers them at call-site. -languages: [zh-cn] +languages: [ru, zh-cn] num: 61 previous-page: ca-extension-methods next-page: ca-context-bounds diff --git a/_ru/scala3/book/ca-context-bounds.md b/_ru/scala3/book/ca-context-bounds.md new file mode 100644 index 0000000000..17dbfedbc0 --- /dev/null +++ b/_ru/scala3/book/ca-context-bounds.md @@ -0,0 +1,141 @@ +--- +layout: multipage-overview +title: Контекстные границы +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этой главе представлены контекстные границы в Scala 3. +language: ru +num: 62 +previous-page: ca-context-parameters +next-page: +--- + +Во многих ситуациях имя [контекстного параметра]({% link _overviews/scala3-book/ca-context-parameters.md %}#context-parameters) +не нужно указывать явно, поскольку оно используется компилятором только в синтезированных аргументах для других параметров контекста. +В этом случае вам не нужно определять имя параметра, а можно просто указать тип. + +## Предыстория + +Например, рассмотрим метод `maxElement`, возвращающий максимальное значение в коллекции: + +{% tabs context-bounds-max-named-param class=tabs-scala-version %} + +{% tab 'Scala 2' %} + +```scala +def maxElement[A](as: List[A])(implicit ord: Ord[A]): A = + as.reduceLeft(max(_, _)(ord)) +``` + +{% endtab %} + +{% tab 'Scala 3' %} + +```scala +def maxElement[A](as: List[A])(using ord: Ord[A]): A = + as.reduceLeft(max(_, _)(using ord)) +``` + +{% endtab %} + +{% endtabs %} + +Метод `maxElement` принимает _контекстный параметр_ типа `Ord[A]` только для того, +чтобы передать его в качестве аргумента методу `max`. + +Для полноты приведем определения `max` и `Ord` +(обратите внимание, что на практике мы будем использовать существующий метод `max` для `List`, +но мы создали этот пример для иллюстрации): + +{% tabs context-bounds-max-ord class=tabs-scala-version %} + +{% tab 'Scala 2' %} + +```scala +/** Определяет, как сравнивать значения типа `A` */ +trait Ord[A] { + def greaterThan(a1: A, a2: A): Boolean +} + +/** Возвращает максимальное из двух значений */ +def max[A](a1: A, a2: A)(implicit ord: Ord[A]): A = + if (ord.greaterThan(a1, a2)) a1 else a2 +``` + +{% endtab %} + +{% tab 'Scala 3' %} + +```scala +/** Определяет, как сравнивать значения типа `A` */ +trait Ord[A]: + def greaterThan(a1: A, a2: A): Boolean + +/** Возвращает максимальное из двух значений */ +def max[A](a1: A, a2: A)(using ord: Ord[A]): A = + if ord.greaterThan(a1, a2) then a1 else a2 +``` + +{% endtab %} + +{% endtabs %} + +Обратите внимание, что метод `max` принимает контекстный параметр типа `Ord[A]`, как и метод `maxElement`. + +## Пропуск контекстных аргументов + +Так как `ord` - это контекстный параметр в методе `max`, +компилятор может предоставить его для нас в реализации `maxElement` при вызове `max`: + +{% tabs context-bounds-context class=tabs-scala-version %} + +{% tab 'Scala 2' %} + +```scala +def maxElement[A](as: List[A])(implicit ord: Ord[A]): A = + as.reduceLeft(max(_, _)) +``` + +{% endtab %} + +{% tab 'Scala 3' %} + +```scala +def maxElement[A](as: List[A])(using Ord[A]): A = + as.reduceLeft(max(_, _)) +``` + +Обратите внимание: поскольку нам не нужно явно передавать его методу `max`, +мы можем не указывать его имя в определении метода `maxElement`. +Это _анонимный параметр контекста_. + +{% endtab %} + +{% endtabs %} + +## Границы контекста + +Учитывая написанное выше, _привязка к контексту_ — это сокращенный синтаксис +для выражения шаблона "параметр контекста, применяемый к параметру типа". + +Используя привязку к контексту, метод `maxElement` можно записать следующим образом: + +{% tabs context-bounds-max-rewritten %} + +{% tab 'Scala 2 и 3' %} + +```scala +def maxElement[A: Ord](as: List[A]): A = + as.reduceLeft(max(_, _)) +``` + +{% endtab %} + +{% endtabs %} + +Привязка типа `: Ord` к параметру типа `A` метода или класса указывает на параметр контекста с типом `Ord[A]`. +Под капотом компилятор преобразует этот синтаксис в тот, который показан в разделе "Предыстория". + +Дополнительные сведения о границах контекста см. в разделе ["Что такое границы контекста?"]({% link _overviews/FAQ/index.md %}#what-are-context-bounds) раздел FAQ по Scala. diff --git a/_ru/scala3/book/ca-context-parameters.md b/_ru/scala3/book/ca-context-parameters.md new file mode 100644 index 0000000000..dc66f2fc98 --- /dev/null +++ b/_ru/scala3/book/ca-context-parameters.md @@ -0,0 +1,196 @@ +--- +layout: multipage-overview +title: Параметры контекста +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: На этой странице показано, как объявлять параметры контекста и как компилятор выводит их на стороне вызова. +language: ru +num: 61 +previous-page: ca-extension-methods +next-page: ca-context-bounds +--- + +Scala предлагает две важные функции для контекстной абстракции: + +- **Параметры контекста** позволяют указать параметры, которые на стороне вызова могут быть опущены программистом + и должны автоматически предоставляться контекстом. +- **Экземпляры given** (в Scala 3) или **неявные определения** (в Scala 2) — это термины, + которые компилятор Scala может использовать для заполнения отсутствующих аргументов. + +## Параметры контекста + +При проектировании системы зачастую необходимо предоставлять контекстную информацию, +такую как конфигурация или настройки, различным компонентам вашей системы. +Одним из распространенных способов добиться этого является передача конфигурации +в качестве дополнительного аргумента методам. + +В следующем примере мы определяем кейс класс `Config` для моделирования некоторой конфигурации веб-сайта +и передаем ее в различных методах. + +{% tabs example %} +{% tab 'Scala 2 и 3' %} + +```scala +case class Config(port: Int, baseUrl: String) + +def renderWebsite(path: String, config: Config): String = + "<html>" + renderWidget(List("cart"), config) + "</html>" + +def renderWidget(items: List[String], config: Config): String = ??? + +val config = Config(8080, "docs.scala-lang.org") +renderWebsite("/home", config) +``` + +{% endtab %} +{% endtabs %} + +Предположим, что конфигурация не меняется на протяжении большей части нашей кодовой базы. +Передача `config` каждому вызову метода (например `renderWidget`) становится очень утомительной +и делает нашу программу более трудной для чтения, поскольку нам нужно игнорировать аргумент `config`. + +### Установка параметров как контекстных + +Мы можем пометить некоторые параметры наших методов как _контекстные_. + +{% tabs 'contextual-parameters' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +def renderWebsite(path: String)(implicit config: Config): String = + "<html>" + renderWidget(List("cart")) + "</html>" + // ^ + // аргумент config больше не требуется + +def renderWidget(items: List[String])(implicit config: Config): String = ??? +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +def renderWebsite(path: String)(using config: Config): String = + "<html>" + renderWidget(List("cart")) + "</html>" + // ^ + // аргумент config больше не требуется + +def renderWidget(items: List[String])(using config: Config): String = ??? +``` + +{% endtab %} +{% endtabs %} + +Начав секцию параметров с ключевого слова `using` в Scala 3 или `implicit` в Scala 2, мы сообщаем компилятору, +что на стороне вызова он должен автоматически найти аргумент с необходимым типом. +Таким образом, компилятор Scala выполняет **вывод термов**. + +При вызове `renderWidget(List("cart"))` компилятор Scala увидит, что в области видимости есть терм типа `Config` +(в нашем случае - `config`) и автоматически предоставит его для `renderWidget`. +Таким образом, программа эквивалентна приведенной выше. + +На самом деле, поскольку в реализации `renderWebsite` больше не нужно ссылаться на `config`, +мы можем даже опустить его имя в подписи в Scala 3: + +{% tabs 'anonymous' %} +{% tab 'Только в Scala 3' %} + +```scala +// нет необходимости придумывать имя параметра +// vvvvvvvvvvvvv +def renderWebsite(path: String)(using Config): String = + "<html>" + renderWidget(List("cart")) + "</html>" +``` + +{% endtab %} +{% endtabs %} + +В Scala 2 именовать неявные параметры по-прежнему необходимо. + +### Явное указание контекстных параметров + +Мы увидели, как _абстрагироваться_ от контекстных параметров +и что компилятор Scala может автоматически предоставлять нам аргументы. +Но как мы можем указать, какую конфигурацию использовать для нашего вызова `renderWebsite`? + +{% tabs 'explicit' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +Мы явно указываем значение аргумента, как если бы это был обычный аргумент: + +```scala +renderWebsite("/home")(config) +``` + +{% endtab %} +{% tab 'Scala 3' %} + +Подобно тому, как мы указали наш раздел параметров с помощью `using`, +мы также можем явно указать контекстные параметры с помощью `using`: + +```scala +renderWebsite("/home")(using config) +``` + +{% endtab %} +{% endtabs %} + +Явное предоставление контекстных параметров может быть полезно, +когда у нас в области видимости есть несколько разных значений, +подходящих по типу, и мы хотим убедиться в корректности передачи параметра методу. + +Для всех остальных случаев, как мы увидим в следующем разделе, +есть еще один способ ввести контекстуальные значения в область видимости. + +## Экземпляры given (определения implicit в Scala 2) + +Мы видели, что можем явно передавать аргументы в качестве контекстных параметров. +Однако, если для определенного типа существует _единственное каноническое значение_, +есть другой предпочтительный способ сделать его доступным для компилятора Scala: +пометив его как `given` в Scala 3 или `implicit` в Scala 2. + +{% tabs 'instances' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +implicit val config: Config = Config(8080, "docs.scala-lang.org") +// ^^^^^^ +// это значение, которое выведет компилятор Scala +// в качестве аргумента контекстного параметра типа Config +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +val config = Config(8080, "docs.scala-lang.org") + +// это тип, который мы хотим предоставить для канонического значения +// vvvvvv +given Config = config +// ^^^^^^ +// это значение, которое выведет компилятор Scala +// в качестве аргумента контекстного параметра типа Config +``` + +{% endtab %} +{% endtabs %} + +В приведенном выше примере мы указываем, что всякий раз, +когда в текущей области видимости опущен контекстный параметр типа `Config`, +компилятор должен вывести `config` в качестве аргумента. + +Определив каноническое значение для типа `Config`, +мы можем вызвать `renderWebsite` следующим образом: + +```scala +renderWebsite("/home") +// ^ +// снова без аргумента +``` + +Подробное руководство о том, где Scala ищет канонические значения, можно найти в [FAQ]({% link _overviews/FAQ/index.md %}#where-does-scala-look-for-implicits). + +[reference]: {{ site.scala3ref }}/overview.html +[blog-post]: /2020/11/06/explicit-term-inference-in-scala-3.html diff --git a/_ru/scala3/book/ca-extension-methods.md b/_ru/scala3/book/ca-extension-methods.md index 672f7d54e3..6f530b141f 100644 --- a/_ru/scala3/book/ca-extension-methods.md +++ b/_ru/scala3/book/ca-extension-methods.md @@ -9,7 +9,7 @@ description: В этой главе представлена работа мет language: ru num: 60 previous-page: ca-contextual-abstractions-intro -next-page: +next-page: ca-context-parameters versionSpecific: true --- From 31fe9b8f77254c7d04691e312cb5c9b55425f465 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Thu, 3 Aug 2023 10:18:52 +0300 Subject: [PATCH 2683/3075] Add tabs in ru tour (#2880) * Update compound-types.md in russian * Add tabs in ru tour * Add tabs in ru tour * Add tabs in ru tour * Add tabs in ru tour --- _ru/tour/annotations.md | 163 ++++++++++++++++++++++++++++---- _ru/tour/by-name-parameters.md | 36 ++++++- _ru/tour/operators.md | 80 ++++++++++++++++ _ru/tour/polymorphic-methods.md | 24 ++++- _ru/tour/self-types.md | 32 ++++++- _ru/tour/type-inference.md | 53 ++++++++++- 6 files changed, 361 insertions(+), 27 deletions(-) diff --git a/_ru/tour/annotations.md b/_ru/tour/annotations.md index 46718f2d77..0af144139d 100644 --- a/_ru/tour/annotations.md +++ b/_ru/tour/annotations.md @@ -9,21 +9,44 @@ previous-page: by-name-parameters --- Аннотации используются для передачи метаданных при объявлении. Например, аннотация `@deprecated` перед объявлением метода, заставит компилятор вывести предупреждение, если этот метод будет использован. -``` + +{% tabs annotations_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=annotations_1 %} + +```scala mdoc:fail object DeprecationDemo extends App { @deprecated("deprecation message", "release # which deprecates method") def hello = "hola" - hello + hello } ``` + +{% endtab %} +{% tab 'Scala 3' for=annotations_1 %} + +```scala +object DeprecationDemo extends App: + @deprecated("deprecation message", "release # which deprecates method") + def hello = "hola" + + hello +``` + +{% endtab %} +{% endtabs %} + Такой код скомпилируется, но компилятор выдаст предупреждение: "there was one deprecation warning". Аннотация применяется к первому идущему после нее объявлению или определению. Допускается использование сразу нескольких аннотаций следующих друг за другом. Порядок, в котором приводятся аннотации, не имеет значения. ## Аннотации, обеспечивающие корректность работы кода + Некоторые аннотации приводят к невозможности компиляции, если условие (условия) не выполняется. Например, аннотация `@tailrec` гарантирует, что метод является [хвостовой рекурсией](https://ru.wikipedia.org/wiki/%D0%A5%D0%B2%D0%BE%D1%81%D1%82%D0%BE%D0%B2%D0%B0%D1%8F_%D1%80%D0%B5%D0%BA%D1%83%D1%80%D1%81%D0%B8%D1%8F). Хвостовая рекурсия помогает держать потребление памяти на постоянном уровне. Вот как она используется в методе, который вычисляет факториал: +{% tabs annotations_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=annotations_2 %} + ```scala mdoc import scala.annotation.tailrec @@ -36,8 +59,30 @@ def factorial(x: Int): Int = { factorialHelper(x, 1) } ``` -Метод `factorialHelper` имеет аннотацию `@tailrec`, которая гарантирует, что метод действительно является хвостовой рекурсией. Если бы мы изменили реализацию `factorialHelper` так как указано далее, то компиляция бы провалилась: + +{% endtab %} +{% tab 'Scala 3' for=annotations_2 %} + +```scala +import scala.annotation.tailrec + +def factorial(x: Int): Int = + + @tailrec + def factorialHelper(x: Int, accumulator: Int): Int = + if x == 1 then accumulator else factorialHelper(x - 1, accumulator * x) + factorialHelper(x, 1) ``` + +{% endtab %} +{% endtabs %} + +Метод `factorialHelper` имеет аннотацию `@tailrec`, которая гарантирует, что метод действительно является хвостовой рекурсией. Если бы мы изменили реализацию `factorialHelper` так как указано далее, то компиляция бы провалилась: + +{% tabs annotations_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=annotations_3 %} + +```scala mdoc:fail import scala.annotation.tailrec def factorial(x: Int): Int = { @@ -48,77 +93,155 @@ def factorial(x: Int): Int = { factorialHelper(x) } ``` -Мы бы получили сообщение "Recursive call not in tail position"(Рекурсивный вызов не в хвостовой позиции). +{% endtab %} +{% tab 'Scala 3' for=annotations_3 %} + +```scala +import scala.annotation.tailrec + +def factorial(x: Int): Int = + @tailrec + def factorialHelper(x: Int): Int = + if x == 1 then 1 else x * factorialHelper(x - 1) + factorialHelper(x) +``` + +{% endtab %} +{% endtabs %} + +Мы бы получили сообщение "Recursive call not in tail position"(Рекурсивный вызов не в хвостовой позиции). ## Аннотации, влияющие на генерацию кода + +{% tabs annotations_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=annotations_4 %} + Некоторые аннотации типа `@inline` влияют на сгенерированный код (т.е. в результате сам код вашего jar-файл может отличаться). Такая аннотация означает вставку всего кода в тело метода вместо вызова. Полученный байт-код длиннее, но, надеюсь, работает быстрее. Использование аннотации `@inline` не гарантирует, что метод будет встроен, но заставит компилятор сделать это, если и только если будут соблюдены некоторые разумные требования к размеру сгенерированного кода. -### Java аннотации ### +{% endtab %} +{% tab 'Scala 3' for=annotations_4 %} + +Некоторые аннотации типа `@main` влияют на сгенерированный код (т.е. в результате сам код вашего jar-файл может отличаться). +Аннотация `@main` к методу создает исполняемую программу, которая вызывает метод как точку входа. + +{% endtab %} +{% endtabs %} + +### Java аннотации + Есть некоторые отличия синтаксиса аннотаций, если пишется Scala код, который взаимодействует с Java. **Примечание:**Убедитесь, что вы используете опцию `-target:jvm-1.8` с аннотациями Java. Java имеет определяемые пользователем метаданные в виде [аннотаций](https://docs.oracle.com/javase/tutorial/java/annotations/). Ключевой особенностью аннотаций является то, что они задаются в виде пар ключ-значение для инициализации своих элементов. Например, если нам нужна аннотация для отслеживания источника какого-то класса, мы можем определить её как -``` +{% tabs annotations_5 %} +{% tab 'Java' for=annotations_5 %} + +```java @interface Source { - public String URL(); + public String url(); public String mail(); } ``` +{% endtab %} +{% endtabs %} + А затем использовать следующим образом -``` -@Source(URL = "https://coders.com/", +{% tabs annotations_6 %} +{% tab 'Java' for=annotations_6 %} + +```java +@Source(url = "https://coders.com/", mail = "support@coders.com") -public class MyClass extends HisClass ... +public class MyJavaClass extends TheirClass ... ``` +{% endtab %} +{% endtabs %} + Использование аннотации в Scala похоже на вызов конструктора. Для создания экземпляра из Java аннотации необходимо использовать именованные аргументы: -``` -@Source(URL = "https://coders.com/", +{% tabs annotations_7 %} +{% tab 'Scala 2 и 3' for=annotations_7 %} + +```scala +@Source(url = "https://coders.com/", mail = "support@coders.com") class MyScalaClass ... ``` +{% endtab %} +{% endtabs %} + Этот синтаксис достаточно перегруженный, если аннотация содержит только один элемент (без значения по умолчанию), поэтому, если имя указано как `value`, оно может быть применено в Java с помощью конструктора-подобного синтаксиса: -``` +{% tabs annotations_8 %} +{% tab 'Java' for=annotations_8 %} + +```java @interface SourceURL { public String value(); public String mail() default ""; } ``` +{% endtab %} +{% endtabs %} + А затем можно использовать следующим образом -``` +{% tabs annotations_9 %} +{% tab 'Java' for=annotations_9 %} + +```java @SourceURL("https://coders.com/") -public class MyClass extends HisClass ... +public class MyJavaClass extends TheirClass ... ``` +{% endtab %} +{% endtabs %} + В этом случае Scala предоставляет такую же возможность -``` +{% tabs annotations_10 %} +{% tab 'Scala 2 и 3' for=annotations_10 %} + +```scala @SourceURL("https://coders.com/") class MyScalaClass ... ``` +{% endtab %} +{% endtabs %} + Элемент `mail` был указан со значением по умолчанию, поэтому нам не нужно явно указывать его значение. Мы не можем смешивать эти два стиля в Java: -``` +{% tabs annotations_11 %} +{% tab 'Java' for=annotations_11 %} + +```java @SourceURL(value = "https://coders.com/", mail = "support@coders.com") -public class MyClass extends HisClass ... +public class MyJavaClass extends TheirClass ... ``` +{% endtab %} +{% endtabs %} + Scala обеспечивает большую гибкость в этом отношении -``` +{% tabs annotations_12 %} +{% tab 'Scala 2 и 3' for=annotations_12 %} + +```scala @SourceURL("https://coders.com/", mail = "support@coders.com") - class MyScalaClass ... +class MyScalaClass ... ``` + +{% endtab %} +{% endtabs %} diff --git a/_ru/tour/by-name-parameters.md b/_ru/tour/by-name-parameters.md index 3be9478fe8..06c9a32063 100644 --- a/_ru/tour/by-name-parameters.md +++ b/_ru/tour/by-name-parameters.md @@ -9,13 +9,24 @@ previous-page: operators --- _Вызов параметров по имени_ - это когда значение параметра вычисляется только в момент вызова параметра. Этот способ противоположен _вызову по значению_. Чтоб вызов параметра был по имени, необходимо просто указать `=>` перед его типом. + +{% tabs by-name-parameters_1 %} +{% tab 'Scala 2 и 3' for=by-name-parameters_1 %} + ```scala mdoc def calculate(input: => Int) = input * 37 ``` + +{% endtab %} +{% endtabs %} + Преимущество вызова параметров по имени заключается в том, что они не вычисляются если не используются в теле функции. С другой стороны плюсы вызова параметров по значению в том, что они вычисляются только один раз. Вот пример того, как мы можем реализовать условный цикл: +{% tabs by-name-parameters_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=by-name-parameters_2 %} + ```scala mdoc def whileLoop(condition: => Boolean)(body: => Unit): Unit = if (condition) { @@ -30,8 +41,29 @@ whileLoop (i > 0) { i -= 1 } // выведет 2 1 ``` -Метод `whileLoop` использует несколько списков параметров - условие и тело цикла. Если `condition` является верным, выполняется `body`, а затем выполняется рекурсивный вызов whileLoop. Если `condition` является ложным, то тело никогда не вычисляется, тк у нас стоит `=>` перед типом `body`. + +{% endtab %} +{% tab 'Scala 3' for=by-name-parameters_2 %} + +```scala +def whileLoop(condition: => Boolean)(body: => Unit): Unit = + if condition then + body + whileLoop(condition)(body) + +var i = 2 + +whileLoop (i > 0) { + println(i) + i -= 1 +} // выведет 2 1 +``` + +{% endtab %} +{% endtabs %} + +Метод `whileLoop` использует несколько списков параметров - условие и тело цикла. Если `condition` является верным, выполняется `body`, а затем выполняется рекурсивный вызов whileLoop. Если `condition` является ложным, то тело никогда не вычисляется, тк у нас стоит `=>` перед типом `body`. Теперь, когда мы передаем `i > 0` как наше условие `condition` и `println(i); i-= 1` как тело `body`, код ведет себя также как обычный цикл в большинстве языков программирования. -Такая возможность откладывать вычисления параметра до его использования может помочь повысить производительность, отсекая не нужные вычисления при определенных условиях. +Такая возможность откладывать вычисления параметра до его использования может помочь повысить производительность, отсекая не нужные вычисления при определенных условиях. diff --git a/_ru/tour/operators.md b/_ru/tour/operators.md index dd80f7905d..c8ec47bb3e 100644 --- a/_ru/tour/operators.md +++ b/_ru/tour/operators.md @@ -8,18 +8,38 @@ next-page: by-name-parameters previous-page: type-inference prerequisite-knowledge: case-classes --- + В Скале операторы - это обычные методы. В качестве _инфиксного оператора_ может быть использован любой метод с одним параметром. Например, `+` может вызываться с использованием точки: + +{% tabs operators_1 %} +{% tab 'Scala 2 и 3' for=operators_1 %} + ``` 10.+(1) ``` +{% endtab %} +{% endtabs %} + Однако легче воспринимать код, когда такие методы записаны как инфиксный оператор: + +{% tabs operators_2 %} +{% tab 'Scala 2 и 3' for=operators_2 %} + ``` 10 + 1 ``` +{% endtab %} +{% endtabs %} + ## Создание и использование операторов + В качестве оператора можно использовать любой допустимый символ. Включая имена на подобии `add` или символ (символы) типа `+`. + +{% tabs operators_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=operators_3 %} + ```scala mdoc case class Vec(x: Double, y: Double) { def +(that: Vec) = Vec(this.x + that.x, this.y + that.y) @@ -32,8 +52,30 @@ val vector3 = vector1 + vector2 vector3.x // 3.0 vector3.y // 3.0 ``` + +{% endtab %} +{% tab 'Scala 3' for=operators_3 %} + +```scala +case class Vec(x: Double, y: Double): + def +(that: Vec) = Vec(this.x + that.x, this.y + that.y) + +val vector1 = Vec(1.0, 1.0) +val vector2 = Vec(2.0, 2.0) + +val vector3 = vector1 + vector2 +vector3.x // 3.0 +vector3.y // 3.0 +``` + +{% endtab %} +{% endtabs %} + У класса Vec есть метод `+`, который мы использовали для добавления `vector1` и `vector2`. Используя круглые скобки, можно строить сложные выражения с читаемым синтаксисом. Пример создания класса `MyBool`, которое включает в себя методы `and` и `or` +{% tabs operators_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=operators_4 %} + ```scala mdoc case class MyBool(x: Boolean) { def and(that: MyBool): MyBool = if (x) that else this @@ -42,17 +84,38 @@ case class MyBool(x: Boolean) { } ``` +{% endtab %} +{% tab 'Scala 3' for=operators_4 %} + +```scala +case class MyBool(x: Boolean): + def and(that: MyBool): MyBool = if x then that else this + def or(that: MyBool): MyBool = if x then this else that + def negate: MyBool = MyBool(!x) +``` + +{% endtab %} +{% endtabs %} + Теперь можно использовать операторы `and` и `or` в качестве инфиксных операторов: +{% tabs operators_5 %} +{% tab 'Scala 2 и 3' for=operators_5 %} + ```scala mdoc def not(x: MyBool) = x.negate def xor(x: MyBool, y: MyBool) = (x or y) and not(x and y) ``` +{% endtab %} +{% endtabs %} + Это помогает сделать объявление `xor` более читабельным. ## Порядок очередности + Когда выражение использует несколько операторов, операторы оцениваются на основе приоритета первого символа. Таблица приоритетов символов: + ``` (символы которых нет снизу) * / % @@ -65,12 +128,29 @@ def xor(x: MyBool, y: MyBool) = (x or y) and not(x and y) | (буквы, $, _) ``` + Такой приоритет распространяется на любые функции, которые вы задаете. Например, следующее выражение: + +{% tabs operators_7 %} +{% tab 'Scala 2 и 3' for=operators_7 %} + ``` a + b ^? c ?^ d less a ==> b | c ``` + +{% endtab %} +{% endtabs %} + эквивалентно + +{% tabs operators_8 %} +{% tab 'Scala 2 и 3' for=operators_8 %} + ``` ((a + b) ^? (c ?^ d)) less ((a ==> b) | c) ``` + +{% endtab %} +{% endtabs %} + `?^` имеет высший приоритет, потому что начинается с символа `?`. Второй по старшинству приоритет имеет `+`, за которым следуют `==>`, `^?`, `|`, и `less`. diff --git a/_ru/tour/polymorphic-methods.md b/_ru/tour/polymorphic-methods.md index 9d54223100..115cec0d94 100644 --- a/_ru/tour/polymorphic-methods.md +++ b/_ru/tour/polymorphic-methods.md @@ -9,10 +9,13 @@ previous-page: implicit-conversions prerequisite-knowledge: unified-types --- -Также как и у обобщенных классов, у методов есть полиморфизм по типу, с таким же синтаксисом (параметр типа указывается в квадратных скобках сразу после названия метода). +Также как и у обобщенных классов, у методов есть полиморфизм по типу, с таким же синтаксисом (параметр типа указывается в квадратных скобках сразу после названия метода). Вот пример: +{% tabs polymorphic-methods_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=polymorphic-methods_1 %} + ```scala mdoc def listOfDuplicates[A](x: A, length: Int): List[A] = { if (length < 1) @@ -24,8 +27,25 @@ println(listOfDuplicates[Int](3, 4)) // List(3, 3, 3, 3) println(listOfDuplicates("La", 8)) // List(La, La, La, La, La, La, La, La) ``` +{% endtab %} +{% tab 'Scala 3' for=polymorphic-methods_1 %} + +```scala +def listOfDuplicates[A](x: A, length: Int): List[A] = + if length < 1 then + Nil + else + x :: listOfDuplicates(x, length - 1) + +println(listOfDuplicates[Int](3, 4)) // List(3, 3, 3, 3) +println(listOfDuplicates("La", 8)) // List(La, La, La, La, La, La, La, La) +``` + +{% endtab %} +{% endtabs %} + Метод `listOfDuplicates` принимает параметр типа `A` и параметры значений `x` и `length`. Значение `x` имеет тип `A`. Если `length < 1` мы возвращаем пустой список. В противном случае мы добавляем `x`к списку, которые возвращаем через рекурсивный вызовов. (Обратите внимание, что `::` означает добавление элемента слева к списку справа). В первом вызове метода мы явно указываем параметр типа, записывая `[Int]`. Поэтому первым аргументом должен быть `Int` и тип возвращаемого значения будет `List[Int]`. -Во втором вызове показано, что вам не всегда нужно явно указывать параметр типа. Часто компилятор сам может вывести тип исходя из контекста или типа передаваемых аргументов. В этом варианте `"La"` - это `String`, поэтому компилятор знает, что `A` должен быть `String`. +Во втором вызове показано, что вам не всегда нужно явно указывать параметр типа. Часто компилятор сам может вывести тип исходя из контекста или типа передаваемых аргументов. В этом варианте `"La"` - это `String`, поэтому компилятор знает, что `A` должен быть `String`. diff --git a/_ru/tour/self-types.md b/_ru/tour/self-types.md index 5ca4c91b22..06597bfe70 100644 --- a/_ru/tour/self-types.md +++ b/_ru/tour/self-types.md @@ -9,11 +9,16 @@ previous-page: compound-types topics: self-types prerequisite-knowledge: nested-classes, mixin-class-composition --- -Самоописываемый тип(Self type) - это способ объявить, что трейт должен быть смешан с другим трейтом, даже если он не расширяет его напрямую. Что открывает доступ к членам зависимости без импортирования. + +Самоописываемый тип (Self type) - это способ объявить, что трейт должен быть смешан с другим трейтом, даже если он не расширяет его напрямую. Что открывает доступ к членам зависимости без импортирования. Самоописываемый тип - это способ сузить тип `this` или другого идентификатора, который ссылается на `this`. Синтаксис похож на синтаксис обычной функции, но означает кое-что иное. Чтобы использовать самоописываемый тип в трейте напишите: идентификатор, тип другого трейта, который хотите добавить и `=>` (например, `someIdentifier: SomeOtherTrait =>`). + +{% tabs self-types_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=self-types_1 %} + ```scala mdoc trait User { def username: String @@ -25,7 +30,7 @@ trait Tweeter { } class VerifiedTweeter(val username_ : String) extends Tweeter with User { // Мы добавили User потому этого требует Tweeter - def username = s"real $username_" + def username = s"real $username_" } val realBeyoncé = new VerifiedTweeter("Beyoncé") @@ -33,3 +38,26 @@ realBeyoncé.tweet("Just spilled my glass of lemonade") // выведет "real ``` Поскольку мы указали `this: User =>` в трейте `Tweeter`, теперь переменная `username` находится в пределах видимости для метода `tweet`. Это также означает что `VerifiedTweeter` при наследовании от `Tweeter` должен быть смешан с `User` (используя `with User`). + +{% endtab %} +{% tab 'Scala 3' for=self-types_1 %} + +```scala +trait User: + def username: String + +trait Tweeter: + this: User => // переназначил this + def tweet(tweetText: String) = println(s"$username: $tweetText") + +class VerifiedTweeter(val username_ : String) extends Tweeter, User: // Мы добавили User потому этого требует Tweeter + def username = s"real $username_" + +val realBeyoncé = VerifiedTweeter("Beyoncé") +realBeyoncé.tweet("Just spilled my glass of lemonade") // выведет "real Beyoncé: Just spilled my glass of lemonade" +``` + +Поскольку мы указали `this: User =>` в трейте `Tweeter`, теперь переменная `username` находится в пределах видимости для метода `tweet`. Это также означает что `VerifiedTweeter` при наследовании от `Tweeter` должен быть смешан с `User` (используя `, User`). + +{% endtab %} +{% endtabs %} diff --git a/_ru/tour/type-inference.md b/_ru/tour/type-inference.md index 6709acf411..52f0836467 100644 --- a/_ru/tour/type-inference.md +++ b/_ru/tour/type-inference.md @@ -12,26 +12,56 @@ previous-page: polymorphic-methods ## Не указывая тип +{% tabs type-inference_1 %} +{% tab 'Scala 2 и 3' for=type-inference_1 %} + ```scala mdoc val businessName = "Montreux Jazz Café" ``` + +{% endtab %} +{% endtabs %} + Компилятор может определить, что тип константы `businessName` является `String`. Аналогичным образом это работает и для методов: +{% tabs type-inference_2 %} +{% tab 'Scala 2 и 3' for=type-inference_2 %} + ```scala mdoc def squareOf(x: Int) = x * x ``` + +{% endtab %} +{% endtabs %} + Компилятор может определить, что возвращаемый тип является `Int`, поэтому явного указания типа не требуется. Для рекурсивных методов компилятор не в состоянии вывести тип. Вот программа, которая не скомпилируется по этой причине: +{% tabs type-inference_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=type-inference_3 %} + ```scala mdoc:fail def fac(n: Int) = if (n == 0) 1 else n * fac(n - 1) ``` +{% endtab %} +{% tab 'Scala 3' for=type-inference_3 %} + +```scala +def fac(n: Int) = if n == 0 then 1 else n * fac(n - 1) +``` + +{% endtab %} +{% endtabs %} + Также необязательно указывать параметры типа при вызове [полиморфных методов](polymorphic-methods.html) или [обобщенных классов](generic-classes.html). Компилятор Scala определит тип параметра из контекста и из типов фактически передаваемых параметров метода/конструктора. Вот два примера: +{% tabs type-inference_4 %} +{% tab 'Scala 2 и 3' for=type-inference_4 %} + ```scala mdoc case class MyPair[A, B](x: A, y: B) val p = MyPair(1, "scala") // тип: MyPair[Int, String] @@ -40,32 +70,53 @@ def id[T](x: T) = x val q = id(1) // тип: Int ``` +{% endtab %} +{% endtabs %} + Компилятор использует типы аргументов `MyPair` для определения типа `A` и `B`. Тоже самое для типа `x`. ## Параметры Для параметров компилятор никогда не выводит тип. Однако, в некоторых случаях, он может вывести типы для параметров анонимной функции при передаче ее в качестве аргумента. +{% tabs type-inference_5 %} +{% tab 'Scala 2 и 3' for=type-inference_5 %} + ```scala mdoc Seq(1, 3, 4).map(x => x * 2) // List(2, 6, 8) ``` +{% endtab %} +{% endtabs %} + Параметр у map - `f: A => B` (функциональный параметр переводящий тип из A в B). Поскольку мы разместили целые числа в нашей последовательности `Seq`, компилятор знает, что элемент `A` является `Int` (т.е. `x` является целым числом). Поэтому компилятор может определить из выражения `x * 2`, что результат (`B`) является типом `Int`. ## Когда _не следует_ полагаться на выведение типа Обычно считается, наиболее удобочитаемым объявить тип членов, которые открыты для публичного использования через API. Поэтому мы рекомендуем вам явно указывать тип для любых API, которые будут доступны пользователям вашего кода. -Кроме того, выведение может иногда приводить к слишком специфичному типу. Предположим, мы напишем: +Кроме того, выведение может иногда приводить к слишком специфичному типу. Предположим, мы напишем: + +{% tabs type-inference_6 %} +{% tab 'Scala 2 и 3' for=type-inference_6 %} ```scala var obj = null ``` +{% endtab %} +{% endtabs %} + Тогда мы не сможем далее сделать это переназначение: +{% tabs type-inference_7 %} +{% tab 'Scala 2 и 3' for=type-inference_7 %} + ```scala mdoc:fail obj = new AnyRef ``` +{% endtab %} +{% endtabs %} + Такое не будет компилироваться, потому что для `obj` предполагался тип `Null`. Поскольку единственным значением этого типа является `null`, то невозможно присвоить другое значение. From 4c25b45982d4e16785ddbc17f66d075d7aaf97ff Mon Sep 17 00:00:00 2001 From: PhoenixmitX <39215472+PhoenixmitX@users.noreply.github.com> Date: Fri, 4 Aug 2023 09:21:38 +0200 Subject: [PATCH 2684/3075] correct behavior of Random --- _tour/pattern-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index d66bf843e0..aa870d133e 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -44,7 +44,7 @@ x match ``` {% endtab %} {% endtabs %} -The `val x` above is a random integer between 0 and 10. `x` becomes the left operand of the `match` operator and on the right is an expression with four cases. The last case `_` is a "catch all" case for any other possible `Int` values. Cases are also called _alternatives_. +The `val x` above is a random integer between 0 and 9. `x` becomes the left operand of the `match` operator and on the right is an expression with four cases. The last case `_` is a "catch all" case for any other possible `Int` values. Cases are also called _alternatives_. Match expressions have a value. {% tabs pattern-matching-2 class=tabs-scala-version %} From 24aad2ac260d4049682c848fb05f0edfe6a86b0e Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 8 Aug 2023 20:25:26 +0000 Subject: [PATCH 2685/3075] Bump commonmarker from 0.23.9 to 0.23.10 Bumps [commonmarker](https://github.com/gjtorikian/commonmarker) from 0.23.9 to 0.23.10. - [Release notes](https://github.com/gjtorikian/commonmarker/releases) - [Changelog](https://github.com/gjtorikian/commonmarker/blob/v0.23.10/CHANGELOG.md) - [Commits](https://github.com/gjtorikian/commonmarker/compare/v0.23.9...v0.23.10) --- updated-dependencies: - dependency-name: commonmarker dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index ed3ff1d122..f4e58d1543 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -13,7 +13,7 @@ GEM execjs coffee-script-source (1.11.1) colorator (1.1.0) - commonmarker (0.23.9) + commonmarker (0.23.10) concurrent-ruby (1.2.2) dnsruby (1.61.9) simpleidn (~> 0.1) From 4f4171d4f33a18c73e20b07a893d14af48dc104d Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Sun, 13 Aug 2023 16:15:25 -0700 Subject: [PATCH 2686/3075] Toolkit OS-Lib tutorial: small addition fixes #2883 --- _overviews/toolkit/os-what-else.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_overviews/toolkit/os-what-else.md b/_overviews/toolkit/os-what-else.md index 1671540845..886db4c81f 100644 --- a/_overviews/toolkit/os-what-else.md +++ b/_overviews/toolkit/os-what-else.md @@ -13,6 +13,7 @@ next-page: json-intro - creating, moving, copying, removing files and folders, - reading filesystem metadata and permissions, - spawning subprocesses, -- watching changes in folders. +- watching changes in folders, +- interoperating with `java.io.File` and `java.nio.Path`. See also Chapter 7 of Li Haoyi's book [_Hands-On Scala Programming_](https://www.handsonscala.com). (Li Haoyi is the author of OS-Lib.) From 791acfa0695273df4eee035834e3807964d4ff94 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 15 Aug 2023 00:19:28 +0000 Subject: [PATCH 2687/3075] Update SIPs state --- _sips/sips/proper-specification-for-match-types.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/proper-specification-for-match-types.md diff --git a/_sips/sips/proper-specification-for-match-types.md b/_sips/sips/proper-specification-for-match-types.md new file mode 100644 index 0000000000..6e5dfe596a --- /dev/null +++ b/_sips/sips/proper-specification-for-match-types.md @@ -0,0 +1,7 @@ +--- +title: SIP-56 - Proper Specification for Match Types. +status: under-review +pull-request-number: 65 +stage: design + +--- From 4a0dca4897c111483de4c5d04ec778eb11037538 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Tue, 15 Aug 2023 12:04:24 +0300 Subject: [PATCH 2688/3075] Add ca given imports in ru (#2884) * Update compound-types.md in russian * Add ca-given-imports.md in ru * Add ca-given-imports.md in ru * Add ca-type-classes.md in ru --- _overviews/scala3-book/ca-given-imports.md | 2 +- _overviews/scala3-book/ca-type-classes.md | 2 +- _ru/scala3/book/ca-context-bounds.md | 2 +- _ru/scala3/book/ca-given-imports.md | 54 +++++ _ru/scala3/book/ca-type-classes.md | 230 +++++++++++++++++++++ 5 files changed, 287 insertions(+), 3 deletions(-) create mode 100644 _ru/scala3/book/ca-given-imports.md create mode 100644 _ru/scala3/book/ca-type-classes.md diff --git a/_overviews/scala3-book/ca-given-imports.md b/_overviews/scala3-book/ca-given-imports.md index 399ff6add0..97ddde3374 100644 --- a/_overviews/scala3-book/ca-given-imports.md +++ b/_overviews/scala3-book/ca-given-imports.md @@ -2,7 +2,7 @@ title: Given Imports type: section description: This page demonstrates how 'given' import statements work in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 63 previous-page: ca-context-bounds next-page: ca-type-classes diff --git a/_overviews/scala3-book/ca-type-classes.md b/_overviews/scala3-book/ca-type-classes.md index 36ae7634cf..71af01513b 100644 --- a/_overviews/scala3-book/ca-type-classes.md +++ b/_overviews/scala3-book/ca-type-classes.md @@ -2,7 +2,7 @@ title: Type Classes type: section description: This page demonstrates how to create and use type classes. -languages: [zh-cn] +languages: [ru, zh-cn] num: 64 previous-page: ca-given-imports next-page: ca-multiversal-equality diff --git a/_ru/scala3/book/ca-context-bounds.md b/_ru/scala3/book/ca-context-bounds.md index 17dbfedbc0..91c18c5101 100644 --- a/_ru/scala3/book/ca-context-bounds.md +++ b/_ru/scala3/book/ca-context-bounds.md @@ -9,7 +9,7 @@ description: В этой главе представлены контекстн language: ru num: 62 previous-page: ca-context-parameters -next-page: +next-page: ca-given-imports --- Во многих ситуациях имя [контекстного параметра]({% link _overviews/scala3-book/ca-context-parameters.md %}#context-parameters) diff --git a/_ru/scala3/book/ca-given-imports.md b/_ru/scala3/book/ca-given-imports.md new file mode 100644 index 0000000000..41439a27be --- /dev/null +++ b/_ru/scala3/book/ca-given-imports.md @@ -0,0 +1,54 @@ +--- +layout: multipage-overview +title: Given импорты +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: На этой странице показано, как работают операторы импорта 'given' в Scala 3. +language: ru +num: 63 +previous-page: ca-context-bounds +next-page: ca-type-classes +versionSpecific: true +--- + +Для большей ясности, откуда берутся данные в текущей области видимости, +для импорта экземпляров `given` используется специальная форма оператора `import`. +Базовая форма показана в этом примере: + +```scala +object A: + class TC + given tc: TC = ??? + def f(using TC) = ??? + +object B: + import A.* // импорт всех не-given элементов + import A.given // импорт экземпляров given +``` + +В этом коде предложение `import A.*` объекта `B` импортирует все элементы `A`, _кроме_ `given` экземпляра `tc`. +И наоборот, второй импорт, `import A.given`, импортирует _только_ экземпляр `given`. +Два предложения импорта также могут быть объединены в одно: + +```scala +object B: + import A.{given, *} +``` + +## Обсуждение + +Селектор с подстановочным знаком `*` помещает в область видимости все определения, кроме given-ов или расширений, +тогда как селектор `given` помещает в область видимости _все_ given-ы, включая те, которые являются результатом расширений. + +Эти правила имеют два основных преимущества: + +- понятнее, откуда берутся данные в текущей области видимости. + В частности, невозможно скрыть импортированные given-ы в длинном списке других импортов. +- есть возможность импортировать все given, не импортируя ничего другого. + Это важно, потому что given-ы могут быть анонимными, поэтому обычное использование именованного импорта нецелесообразно. + +Дополнительные примеры синтаксиса "import given" показаны в главе ["Пакеты и импорт"][imports]. + +[imports]: {% link _overviews/scala3-book/packaging-imports.md %} diff --git a/_ru/scala3/book/ca-type-classes.md b/_ru/scala3/book/ca-type-classes.md new file mode 100644 index 0000000000..95b2d83ecb --- /dev/null +++ b/_ru/scala3/book/ca-type-classes.md @@ -0,0 +1,230 @@ +--- +layout: multipage-overview +title: Классы типов +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этой главе демонстрируется создание и использование классов типов. +language: ru +num: 64 +previous-page: ca-given-imports +next-page: +--- + +Класс типов (_type class_) — это абстрактный параметризованный тип, +который позволяет добавлять новое поведение к любому закрытому типу данных без использования подтипов. +Если вы пришли с Java, то можно думать о классах типов как о чем-то вроде [`java.util.Comparator[T]`][comparator]. + +> В статье ["Type Classes as Objects and Implicits"][typeclasses-paper] (2010 г.) обсуждаются основные идеи, +> лежащие в основе классов типов в Scala. +> Несмотря на то, что в статье используется более старая версия Scala, идеи актуальны и по сей день. + +Этот стиль программирования полезен во многих случаях, например: + +- выражение того, как тип, которым вы не владеете, например, из стандартной или сторонней библиотеки, соответствует такому поведению +- добавление поведения к нескольким типам без введения отношений подтипов между этими типами (например, когда один расширяет другой) + +Классы типов — это трейты с одним или несколькими параметрами, +реализации которых предоставляются в виде экземпляров `given` в Scala 3 или `implicit` значений в Scala 2. + +## Пример + +Например, `Show` - хорошо известный класс типов в Haskell, и в следующем коде показан один из способов его реализации в Scala. +Если предположить, что классы Scala не содержат метода `toString`, то можно определить класс типов `Show`, +чтобы добавить это поведение к любому типу, который вы хотите преобразовать в пользовательскую строку. + +### Класс типов + +Первым шагом в создании класса типов является объявление параметризованного trait, содержащего один или несколько абстрактных методов. +Поскольку `Showable` содержит только один метод с именем `show`, он записывается так: + +{% tabs 'definition' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +// класс типов +trait Showable[A] { + def show(a: A): String +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +// класс типов +trait Showable[A]: + extension (a: A) def show: String +``` + +{% endtab %} +{% endtabs %} + +Обратите внимание, что этот подход близок к обычному объектно-ориентированному подходу, +когда обычно trait `Show` определяется следующим образом: + +{% tabs 'trait' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +// a trait +trait Show { + def show: String +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +// a trait +trait Show: + def show: String +``` + +{% endtab %} +{% endtabs %} + +Следует отметить несколько важных моментов: + +1. Классы типов, например, `Showable` принимают параметр типа `A`, чтобы указать, для какого типа мы предоставляем реализацию `show`; + в отличие от классических трейтов, наподобие `Show`. +2. Чтобы добавить функциональность `show` к определенному типу `A`, классический трейт требует наследования `A extends Show`, + в то время как для классов типов нам требуется реализация `Showable[A]`. +3. В Scala 3, чтобы разрешить один и тот же синтаксис вызова метода в обоих случаях `Showable`, + который имитирует синтаксис `Show`, мы определяем `Showable.show` как метод расширения. + +### Реализация конкретных экземпляров + +Следующий шаг — определить, какие классы `Showable` должны работать в вашем приложении, а затем реализовать для них это поведение. +Например, для реализации `Showable` следующего класса `Person`: + +{% tabs 'person' %} +{% tab 'Scala 2 и 3' %} + +```scala +case class Person(firstName: String, lastName: String) +``` + +{% endtab %} +{% endtabs %} + +необходимо определить одно _каноническое значение_ типа `Showable[Person]`, т.е. экземпляр `Showable` для типа `Person`, +как показано в следующем примере кода: + +{% tabs 'instance' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +implicit val showablePerson: Showable[Person] = new Showable[Person] { + def show(p: Person): String = + s"${p.firstName} ${p.lastName}" +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +given Showable[Person] with + extension (p: Person) def show: String = + s"${p.firstName} ${p.lastName}" +``` + +{% endtab %} +{% endtabs %} + +### Использование класса типов + +Теперь вы можете использовать этот класс типов следующим образом: + +{% tabs 'usage' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +val person = Person("John", "Doe") +println(showablePerson.show(person)) +``` + +Обратите внимание, что на практике классы типов обычно используются со значениями, тип которых неизвестен, +в отличие от type `Person`, как показано в следующем разделе. + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +val person = Person("John", "Doe") +println(person.show) +``` + +{% endtab %} +{% endtabs %} + +Опять же, если бы в Scala не было метода `toString`, доступного для каждого класса, вы могли бы использовать эту технику, +чтобы добавить поведение `Showable` к любому классу, который вы хотите преобразовать в `String`. + +### Написание методов, использующих класс типов + +Как и в случае с наследованием, вы можете определить методы, которые используют `Showable` в качестве параметра типа: + +{% tabs 'method' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +def showAll[A](as: List[A])(implicit showable: Showable[A]): Unit = + as.foreach(a => println(showable.show(a))) + +showAll(List(Person("Jane"), Person("Mary"))) +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +def showAll[A: Showable](as: List[A]): Unit = + as.foreach(a => println(a.show)) + +showAll(List(Person("Jane"), Person("Mary"))) +``` + +{% endtab %} +{% endtabs %} + +### Класс типов с несколькими методами + +Обратите внимание: если вы хотите создать класс типов с несколькими методами, исходный синтаксис выглядит следующим образом: + +{% tabs 'multiple-methods' class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait HasLegs[A] { + def walk(a: A): Unit + def run(a: A): Unit +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +trait HasLegs[A]: + extension (a: A) + def walk(): Unit + def run(): Unit +``` + +{% endtab %} +{% endtabs %} + +### Пример из реального мира + +В качестве примера из реального мира, как классы типов используются в Scala 3, +см. обсуждение `CanEqual` в [разделе Multiversal Equality][multiversal]. + +[typeclasses-paper]: https://infoscience.epfl.ch/record/150280/files/TypeClasses.pdf + +[typeclasses-chapter]: {% link _overviews/scala3-book/ca-type-classes.md %} +[comparator]: https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html +[multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} From c9180b6ea4d62c22e0a9df49393e2c3209dd6bc8 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 23 Aug 2023 21:41:31 +0000 Subject: [PATCH 2689/3075] Bump activesupport from 7.0.4.3 to 7.0.7.2 Bumps [activesupport](https://github.com/rails/rails) from 7.0.4.3 to 7.0.7.2. - [Release notes](https://github.com/rails/rails/releases) - [Changelog](https://github.com/rails/rails/blob/v7.0.7.2/activesupport/CHANGELOG.md) - [Commits](https://github.com/rails/rails/compare/v7.0.4.3...v7.0.7.2) --- updated-dependencies: - dependency-name: activesupport dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index f4e58d1543..2da20b8237 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,7 +1,7 @@ GEM remote: https://rubygems.org/ specs: - activesupport (7.0.4.3) + activesupport (7.0.7.2) concurrent-ruby (~> 1.0, >= 1.0.2) i18n (>= 1.6, < 2) minitest (>= 5.1) @@ -95,7 +95,7 @@ GEM yell (~> 2.0) zeitwerk (~> 2.5) http_parser.rb (0.8.0) - i18n (1.12.0) + i18n (1.14.1) concurrent-ruby (~> 1.0) jekyll (3.9.3) addressable (~> 2.4) @@ -218,7 +218,7 @@ GEM jekyll (>= 3.5, < 5.0) jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) - minitest (5.18.0) + minitest (5.19.0) nokogiri (1.14.3-arm64-darwin) racc (~> 1.4) nokogiri (1.14.3-x64-mingw-ucrt) From 8c95e5e9b2b74bb94906e7e4fa84af722b7b7cc6 Mon Sep 17 00:00:00 2001 From: Matt Bovel <matthieu@bovel.net> Date: Mon, 28 Aug 2023 12:19:00 +0200 Subject: [PATCH 2690/3075] Update spree registration link (#2891) * Update spree registration link * Update _overviews/contribute/index.md Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> --------- Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> --- _overviews/contribute/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index 4fcafa87a3..ba05bf7e69 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -93,7 +93,7 @@ runs the **Scala Compiler Academy** project to onboard and educate new people in One of the Compiler Academy projects is an Issue Spree – an event that takes place every 3 weeks where people fix Scala 3 compiler issues in pair programming sessions while learning the compiler together. You can apply for the Spree participation -by [filling the form](https://forms.gle/DfoSuHFm3T6MA3L59). +by [filling this form](https://docs.google.com/forms/d/e/1FAIpQLSdhr5Y7QG9VGTGaPn5uS5v3Gz7VtnM5PW-vseZ9OpjseEiwYQ/viewform). Before you begin, you can learn more about the Scala 3 compiler from the following links: From 9f5088c13ae1ef29a19d4ba24678072152bec467 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Thu, 31 Aug 2023 14:22:03 +0200 Subject: [PATCH 2691/3075] improve clarity of contribution first steps --- _includes/inner-documentation-sections.html | 13 +++- _overviews/contribute/index.md | 83 +++++++++++++-------- _sass/layout/table-of-content.scss | 1 + 3 files changed, 65 insertions(+), 32 deletions(-) diff --git a/_includes/inner-documentation-sections.html b/_includes/inner-documentation-sections.html index c26ae1c606..944845c156 100644 --- a/_includes/inner-documentation-sections.html +++ b/_includes/inner-documentation-sections.html @@ -4,8 +4,19 @@ <div class="documentation"> {% for link in include.links %} + + <!-- check if link starts with '#' --> + {% assign first_char = link.link | slice: 0 %} + {% if first_char == '#' %} + {% assign is_url = false %} + {% else %} + {% assign is_url = true %} + {% endif %} + <a href="{% if link.link contains '://' %}{{link.link}}{% else %}{{site.baseurl}}{{link.link}}{% endif %}" - class="doc-item doc-item-link"> + class="doc-item doc-item-link" + {% if is_url %}target="_blank" rel="noopener noreferrer"{% endif %} + > <div class="doc-item-header"> <i class="{{link.icon}}"></i> <h4>{{link.title}}</h4> diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index ba05bf7e69..f319c29844 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -3,32 +3,46 @@ title: Becoming a Scala OSS Contributor num: 1 explore_resources: - - title: Who Can Contribute? + - title: Who can contribute? description: "Open source is for everyone! If you are reading this you are already a contributor..." icon: "fa fa-hand-sparkles" link: "#who-can-contribute-to-open-source" - - title: Why Should I Contribute? + - title: Why should I contribute? description: "Giving back to the community has many benefits..." icon: "fa fa-circle-question" link: "#why-should-i-contribute-to-open-source" - - title: How Can I Contribute? + - title: How can I contribute? description: "From friendly documentation to coding a bug-fix, there is lots to do..." icon: "fa fa-clipboard-list" link: "#how-can-i-contribute-to-open-source" - - title: Where Should I Contribute? + - title: Where should I contribute? description: "If you are already using OSS, or are curious about projects, you can begin right away..." icon: "fa fa-check-to-slot" link: "#how-do-i-choose-where-to-contribute" compiler_resources: - - title: "Scala 3 Contributing Guide" - description: "Guide to the Scala 3 Compiler and fixing an issue" - icon: "fa fa-code-merge" - link: /scala3/guides/contribution/contribution-intro.html - - title: "Compiler Academy Videos" - description: "In-depth tours of the Scala 3 compiler's internals" + - title: "Join the Compiler Issue Spree" + description: "A tri-weekly event where you can get mentored on the compiler. Register for participation here." + icon: "fa fa-clipboard-user" + link: https://docs.google.com/forms/d/e/1FAIpQLSdhr5Y7QG9VGTGaPn5uS5v3Gz7VtnM5PW-vseZ9OpjseEiwYQ/viewform + - title: "Compiler Academy videos" + description: "In-depth tours of the Scala 3 compiler's internals, aimed to help you get started." icon: "fa fa-circle-play" link: https://www.youtube.com/channel/UCIH0OgqE54-KEvYDg4LRhKQ + - title: "Scala 3 contributing guide" + description: "Guide to the Scala 3 Compiler and fixing an issue" + icon: "fa fa-code-merge" + link: https://dotty.epfl.ch/docs/contributing/index.html + +spree_resources: + - title: "Scala open source sprees" + description: "Learn about the next upcoming community spree" + icon: "fa fa-hand-holding-heart" + link: "https://github.com/scalacenter/sprees" + - title: "Upcoming conferences" + description: "See upcoming Scala conferences where you can meet open source maintainers." + icon: "fa-regular fa-calendar-check" + link: "https://www.scala-lang.org/events/" scala_resources: - title: Documentation @@ -84,29 +98,36 @@ open-source ecosystem. We have answered some common questions for you below: {% include inner-documentation-sections.html links=page.explore_resources %} -## Ways to Start Today +## Ways to start today -### The Scala Compiler Academy +### Join the nearest open source spree -The [Scala Center](https://scala.epfl.ch) -runs the **Scala Compiler Academy** project to onboard and educate new people in the Scala 3 compiler. -One of the Compiler Academy -projects is an Issue Spree – an event that takes place every 3 weeks where people fix Scala 3 compiler issues -in pair programming sessions while learning the compiler together. You can apply for the Spree participation -by [filling this form](https://docs.google.com/forms/d/e/1FAIpQLSdhr5Y7QG9VGTGaPn5uS5v3Gz7VtnM5PW-vseZ9OpjseEiwYQ/viewform). +The [Scala Center](https://scala.epfl.ch) hosts open source sprees, colocated with other Scala events. +In the spree, regular project maintainers will mentor you to create your first contribution to the project. -Before you begin, you can learn more about the Scala 3 compiler -from the following links: +{% include inner-documentation-sections.html links=page.spree_resources %} + +### So you want to improve the Scala 3 compiler... + +The [Scala 3 compiler](https://github.com/lampepfl/dotty) is an open source project. +If you are curious about contributing but don't know how to begin, the [Scala Center](https://scala.epfl.ch) +runs the **Scala Compiler Academy** project to onboard and educate new people to the project. You can join the regular +**Issue Spree**, watch in-depth videos, and read the contributing guide: {% include inner-documentation-sections.html links=page.compiler_resources %} -### So You Want To Write A Library... +#### Which areas are perfect for newcomers? +- Adding new linting options, which help enforce cleaner code. +- Improving the clarity of error messages, so that the user understands better what went wrong. +- Add IDE quick-fix actions to error messages, e.g. PR [lampepfl/dotty#18314](https://github.com/lampepfl/dotty/pull/18314). + +### So you want to write a library... Read these guides if you are a maintainer of a library, or are thinking of starting a new project: {% include inner-documentation-sections.html links=page.library_resources %} -### Want to Improve Scala Itself? +### Want to improve Scala itself? The Scala programming language is an open source project with a very diverse community, where people from all over the world contribute their work, with everyone benefiting from friendly help and advice, and @@ -115,7 +136,7 @@ kindly helping others in return. Read on to learn how to join the Scala community and help everyone make things better. -## Contributing to the Scala Project +## Contributing to the Scala project **What Can I Do?** That depends on what you want to contribute. Below are some getting started resources for different contribution domains. Please read all the documentation and follow all the links from the topic pages below before attempting to contribute, as many of the questions you have will already be answered. @@ -139,12 +160,12 @@ When contributing, please follow: * The [Scala Code of Conduct](https://scala-lang.org/conduct/) * The [Inclusive Language Guide][inclusive-language-guide] -### Community Tickets +### Community tickets All issues can be found in the [Scala bug tracker](https://github.com/scala/bug), or the [Scala 3 issue tracker](https://github.com/lampepfl/dotty/issues). Most issues are labeled to make it easier to find issues you are interested in. -### Tools and Libraries +### Tools and libraries The Scala ecosystem includes a great many diverse open-source projects with their own maintainers and community of contributors. Helping out @@ -154,7 +175,7 @@ other projects, see the [Libraries and Tools section](https://scala-lang.org/community/#community-libraries-and-tools) on our Community page. -### Scala Community Build +### Scala community build The Scala community build enables the Scala compiler team to build and test a corpus of @@ -171,7 +192,7 @@ open-source Scala library or tool, please visit the for guidelines on what projects are suitable for the community build and how projects can be added. -## Your Questions, Answered +## Your questions, answered {% capture backButton %} <p> @@ -182,7 +203,7 @@ and how projects can be added. </p> {% endcapture %} -### Who Can Contribute To Open Source? +### Who can contribute to open source? {{backButton}} - **Everyone:** No matter your skills or background, non-technical or otherwise, there is always [some way](#how-can-i-contribute-to-open-source) you can contribute to a project. @@ -194,7 +215,7 @@ and how projects can be added. - **Got a cool idea?** Perhaps you have gained confidence in your skills and are looking to give back to the community, start a new project that fills that perfect niche, or maybe is the life-changing tool everyone never knew they needed. -### Why Should I Contribute to Open Source? +### Why should I contribute to open source? {{backButton}} - **The world is built on OSS:** Open Source Software (OSS) libraries are the flesh on top of the bone structure of the core language itself. @@ -212,7 +233,7 @@ and how projects can be added. The above benefits are something good to achieve regardless of your level of experience. -### How Can I Contribute to Open Source? +### How can I contribute to open source? {{backButton}} - **Documentation:** Often it is outdated, incomplete, or with mistakes. If you see a way to improve the documentation for a project you are using, you should consider if the project is accepting contributions, @@ -242,7 +263,7 @@ The above benefits are something good to achieve regardless of your level of exp [Library Author's Guide](https://docs.scala-lang.org/overviews/contributors/index.html) is an excellent resource on how to get started. -### How Do I Choose Where To Contribute? +### How do I choose where to contribute? {{backButton}} - **Ask yourself, what am I using?** The best project to contribute to is the one that you are using yourself. Take an inventory of your work and hobby projects: what OSS libraries do they use? Have you ever encountered bugs in diff --git a/_sass/layout/table-of-content.scss b/_sass/layout/table-of-content.scss index 28cfc05ba1..e846256f73 100755 --- a/_sass/layout/table-of-content.scss +++ b/_sass/layout/table-of-content.scss @@ -66,6 +66,7 @@ margin-bottom: 10px; .fa, + .fa-regular, .fa-brands { font-size: 1.563rem; margin-right: 14px; From 022ac642346140f06e529411944cb24308c8941e Mon Sep 17 00:00:00 2001 From: OlegAlexander <42989765+OlegAlexander@users.noreply.github.com> Date: Fri, 1 Sep 2023 02:55:45 -0800 Subject: [PATCH 2692/3075] Update scala-for-python-devs.md (#2895) * Update scala-for-python-devs.md * Update scala-for-python-devs.md Putting intersection types back in because Python has union types but not intersection types. --- .../scala3-book/scala-for-python-devs.md | 63 ++++++++++++++++--- 1 file changed, 55 insertions(+), 8 deletions(-) diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index ddaa08584c..d55e6ed619 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -50,6 +50,7 @@ At a high level, Scala shares these *similarities* with Python: Also at a high level, the _differences_ between Python and Scala are: - Python is dynamically typed, and Scala is statically typed + - Though it's dynamically typed, Python supports "gradual typing" with type hints, which are checked by static type checkers, like `mypy` - Though it’s statically typed, Scala features like type inference make it feel like a dynamic language - Python is interpreted, and Scala code is compiled to _.class_ files, and runs on the Java Virtual Machine (JVM) - In addition to running on the JVM, the [Scala.js](https://www.scala-js.org) project lets you use Scala as a JavaScript replacement @@ -68,6 +69,7 @@ This section looks at the similarities you’ll see between Python and Scala whe - The syntax for defining methods is similar - Both have lists, dictionaries (maps), sets, and tuples - Both have comprehensions for mapping and filtering +- Both have terrific IDE support - With Scala 3’s [toplevel definitions][toplevel] you can put method, field, and other definitions anywhere - One difference is that Python can operate without even declaring a single method, while Scala 3 can’t do _everything_ at the toplevel; for instance, a [main method][main-method] (`@main def`) is required to start a Scala application @@ -83,7 +85,6 @@ Also at a programming level, these are some of the differences you’ll see ever - The syntax that’s used to define functions that are passed into methods is the same syntax that’s used to define anonymous functions - Scala variables and parameters are defined with the `val` (immutable) or `var` (mutable) keywords - Scala idioms prefer immutable data structures -- Scala has terrific IDE support with IntelliJ IDEA and Microsoft VS Code - Comments: Python uses `#` for comments; Scala uses the C, C++, and Java style: `//`, `/*...*/`, and `/**...*/` - Naming conventions: The Python standard is to use underscores like `my_list`; Scala uses `myList` - Scala is statically typed, so you declare types for method parameters, method return values, and in other places @@ -95,7 +96,7 @@ Also at a programming level, these are some of the differences you’ll see ever - Scala has state-of-the-art open source functional programming libraries (see the [“Awesome Scala” list](https://github.com/lauris/awesome-scala)) - You can create your own “control structures” and DSLs, thanks to features like objects, by-name parameters, infix notation, optional parentheses, extension methods, higher-order functions, and more - Scala code can run in the JVM and even be compiled to native images (using [Scala Native](https://github.com/scala-native/scala-native) and [GraalVM](https://www.graalvm.org)) for high performance -- Many other goodies: case classes, companion classes and objects, macros, [union][union-types] and [intersection][intersection-types] types, [toplevel definitions][toplevel], numeric literals, multiple parameter lists, and more +- Many other goodies: companion classes and objects, macros, numeric literals, multiple parameter lists, [intersection][intersection-types] types, type-level programming, and more ### Features compared with examples @@ -240,6 +241,53 @@ x += 1 However, the rule of thumb in Scala is to always use `val` unless the variable specifically needs to be mutated. +## FP style records + +Scala case classes are similar to Python frozen dataclasses. + +### Constructor definition: + +<table> + <tbody> + <tr> + <td class="python-block"> + <code>from dataclasses import dataclass, replace + <br> + <br>@dataclass(frozen=True) + <br>class Person: + <br>  name: str + <br>  age: int</code> + </td> + </tr> + <tr> + <td class="scala-block"> + <code>case class Person(name: String, age: Int)</code> + </td> + </tr> + </tbody> +</table> + +### Create and use an instance: + +<table> + <tbody> + <tr> + <td class="python-block"> + <code>p = Person("Alice", 42) + <br>p.name   # Alice + <br>p2 = replace(p, age=43)</code> + </td> + </tr> + <tr> + <td class="scala-block"> + <code>val p = Person("Alice", 42) + <br>p.name   // Alice + <br>val p2 = p.copy(age = 43)</code> + </td> + </tr> + </tbody> +</table> + ## OOP style classes and methods This section provides comparisons of features related to OOP-style classes and methods. @@ -333,7 +381,7 @@ This section provides comparisons of features related to OOP-style classes and m ## Interfaces, traits, and inheritance If you’re familiar with Java 8 and newer, Scala traits are similar to those Java interfaces. -Traits are used all the time in Scala, while Python interfaces and abstract classes are used much less often. +Traits are used all the time in Scala, while Python interfaces (Protocols) and abstract classes are used much less often. Therefore, rather than attempt to compare the two, this example shows how to use Scala traits to build a small solution to a simulated math problem: ```scala @@ -1010,7 +1058,7 @@ If you’re used to using these methods with lambda expressions in Python, you To demonstrate this functionality, here are two sample lists: ```scala -numbers = (1,2,3) // python +numbers = [1,2,3] // python val numbers = List(1,2,3) // scala ``` @@ -1110,7 +1158,8 @@ Those lists are used in the following table, that shows how to apply mapping and ### Scala collections methods Scala collections classes have over 100 functional methods to simplify your code. -In addition to `map`, `filter`, and `reduce`, other commonly-used methods are listed below. +In Python, some of these functions are available in the `itertools` module. +In addition to `map`, `filter`, and `reduce`, other commonly-used methods in Scala are listed below. In those method examples: - `c` refers to a collection @@ -1296,12 +1345,10 @@ Follow the links below for more details: - Most concepts related to [contextual abstractions][contextual], such as [extension methods][extension-methods], [type classes][type-classes], implicit values - Scala allows multiple parameter lists, which enables features like partially-applied functions, and the ability to create your own DSLs -- Case classes, which are extremely useful for functional programming and pattern matching - The ability to create your own control structures and DSLs -- Pattern matching and `match` expressions - [Multiversal equality][multiversal]: the ability to control at compile time what equality comparisons make sense - Infix methods -- Macros and metaprogramming +- Macros ## Scala and virtual environments From f44148dd0053d8745b9eb11aa8920af8995aea3b Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 1 Sep 2023 13:59:49 +0200 Subject: [PATCH 2693/3075] Update font awesome class in contributing (#2896) revert to regular `fa` class --- _overviews/contribute/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index f319c29844..574ec761a2 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -41,7 +41,7 @@ spree_resources: link: "https://github.com/scalacenter/sprees" - title: "Upcoming conferences" description: "See upcoming Scala conferences where you can meet open source maintainers." - icon: "fa-regular fa-calendar-check" + icon: "fa fa-calendar-check" link: "https://www.scala-lang.org/events/" scala_resources: From a6d3efbb8aeac7678d8f80decd9862c6b62a5d37 Mon Sep 17 00:00:00 2001 From: Alexander Shelepov <sasha.shelepov@gmail.com> Date: Fri, 8 Sep 2023 12:54:25 +0700 Subject: [PATCH 2694/3075] Fix typo in `overview/fun-hofs.md` --- _overviews/scala3-book/fun-hofs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/fun-hofs.md b/_overviews/scala3-book/fun-hofs.md index 013f47a560..638c761389 100644 --- a/_overviews/scala3-book/fun-hofs.md +++ b/_overviews/scala3-book/fun-hofs.md @@ -91,7 +91,7 @@ To create a method that takes a function parameter, all you have to do is: 1. In your method’s parameter list, define the signature of the function you want to accept 2. Use that function inside your method -To demonstrate this, here’s a method that that takes an input parameter named `f`, where `f` is a function: +To demonstrate this, here’s a method that takes an input parameter named `f`, where `f` is a function: {% tabs sayHello-definition %} {% tab 'Scala 2 and 3' %} From d7bc206fd251b05d354ca1c3a5f9bd621c852f9a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= <pmarks@virtuslab.com> Date: Fri, 8 Sep 2023 09:44:31 +0200 Subject: [PATCH 2695/3075] Update Scala version to 3.3.1 (#2899) --- _config.yml | 2 +- api/all.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index b2da9af505..c03134b823 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.11 scala-212-version: 2.12.18 -scala-3-version: 3.3.0 +scala-3-version: 3.3.1 collections: style: diff --git a/api/all.md b/api/all.md index f3dd4334bd..ef1924c385 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,8 @@ redirect_from: ## Latest releases -* Scala 3.3.0 LTS - * [Library API](https://www.scala-lang.org/api/3.3.0/) +* Scala 3.3.1 LTS + * [Library API](https://www.scala-lang.org/api/3.3.1/) * Scala 2.13.11 * [Library API](https://www.scala-lang.org/api/2.13.11/) * [Compiler API](https://www.scala-lang.org/api/2.13.11/scala-compiler/scala/) @@ -62,6 +62,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.3.0 LTS + * [Library API](https://www.scala-lang.org/api/3.3.0/) * Scala 3.2.2 * [Library API](https://www.scala-lang.org/api/3.2.2/) * Scala 3.2.1 From daeb986d50c4e4b271941842e3455ed51a950685 Mon Sep 17 00:00:00 2001 From: Floho <26029550+floh0@users.noreply.github.com> Date: Fri, 8 Sep 2023 14:09:41 +0200 Subject: [PATCH 2696/3075] fix outdated default value of minThreads (#2898) --- _overviews/core/futures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/core/futures.md b/_overviews/core/futures.md index aac3aa4b4f..9f01a43710 100644 --- a/_overviews/core/futures.md +++ b/_overviews/core/futures.md @@ -101,7 +101,7 @@ By default, the `ExecutionContext.global` sets the parallelism level of its unde ([Runtime.availableProcessors](https://docs.oracle.com/javase/7/docs/api/java/lang/Runtime.html#availableProcessors%28%29)). This configuration can be overridden by setting one (or more) of the following VM attributes: - * scala.concurrent.context.minThreads - defaults to `Runtime.availableProcessors` + * scala.concurrent.context.minThreads - defaults to `1` * scala.concurrent.context.numThreads - can be a number or a multiplier (N) in the form 'xN' ; defaults to `Runtime.availableProcessors` * scala.concurrent.context.maxThreads - defaults to `Runtime.availableProcessors` From 25d581495057b17b12e8417186b7fca65d0e7575 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 8 Sep 2023 20:15:24 +0800 Subject: [PATCH 2697/3075] add code tab and modified translation. (#2817) * add code tab and modified translation. * modified according to comments. --- .../overviews/scala3-book/ca-type-classes.md | 109 +++++++++++++++--- 1 file changed, 94 insertions(+), 15 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/ca-type-classes.md b/_zh-cn/overviews/scala3-book/ca-type-classes.md index 3543f68a34..869d104ad5 100644 --- a/_zh-cn/overviews/scala3-book/ca-type-classes.md +++ b/_zh-cn/overviews/scala3-book/ca-type-classes.md @@ -14,17 +14,22 @@ permalink: "/zh-cn/scala3/book/:title.html" --- -_类型类_是一种抽象的参数化类型，它允许您在不使用子类型的情况下向任何封闭数据类型添加新行为。 +_类型类_ 是一种抽象的参数化类型，它允许您在不使用子类型的情况下向任何封闭数据类型添加新行为。 +如果你从 Java 那边过来，你可以将类型类视为类似于 [`java.util.Comparator[T]`][comparator] 的东西。 + +> Oliveira 等人写的论文 [“Type Classes as Objects and Implicits”][typeclasses-paper] (2010) 讨论了在 Scala 中类型类背后的基本观点。 +> 虽然论文用了旧的 Scala 版本，但其中的观点至今依然有用。 + 这在多用例中很有用，例如： - 表达你不拥有的类型——来自标准库或第三方库——如何符合这种行为 - 为多种类型表达这种行为，而不涉及这些类型之间的子类型关系 -在 Scala 3 中，类型类只是具有一个或多个参数的 traits，其实现由 `given` 实例提供。 +类型类只是具有一个或多个参数的 traits，其实现在 Scala 3 中，由 `given` 实例提供，在 Scala 2 中用 `implicit` 值。 ## 例子 -例如，`Show` 是 Haskell 中众所周知的类型类，下面的代码显示了在 Scala 3 中实现它的一种方法。 +例如，`Show` 是 Haskell 中众所周知的类型类，下面的代码显示了在 Scala 中实现它的一种方法。 如果您认为 Scala 类没有 `toString` 方法，您可以定义一个 `Show` 类型类，然后把此行为添加到任意的类，这个类是能够转换为自定义字符串。 ### 类型类 @@ -32,55 +37,103 @@ _类型类_是一种抽象的参数化类型，它允许您在不使用子类型 创建类型类的第一步是声明具有一个或多个抽象方法的参数化 trait。 因为 `Showable` 只有一个名为 `show` 的方法，所以写成这样： +{% tabs 'definition' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +// a type class +trait Showable[A] { + def show(a: A): String +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala // a type class trait Showable[A]: extension(a: A) def show: String ``` +{% endtab %} +{% endtabs %} -这是 Scala 3 的说法，任何实现此 trait 的类型都必须定义 `show` 方法的工作方式。 -请注意，语法非常接近普通的 trait： +请注意，通常当你要定义 `Show` trait时，下面这样的办法接近普通的面向对象的办法： +{% tabs 'trait' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +// a trait +trait Show { + def show: String +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala // a trait trait Show: def show: String ``` +{% endtab %} +{% endtabs %} 有几件重要的事情需要指出： -1. 像 `Showable` 这样的类型类有一个类型参数 `A` 来说明我们为哪种类型提供了 `show` 的实现；相反，像 `Show` 这样的正常特征不会。 -2. 要将 show 功能添加到特定类型 `A`，正常 trait 需要 `A extends Show`，而对于类型类，我们需要实现 `Showable[A]`。 -3. 为了在两个 `Showable` 中允许相同的方法调用语法来模仿 `Show`，我们将 `Showable.show` 定义为扩展方法。 +1. 像 `Showable` 这样的类型类有一个类型参数 `A` 来说明我们为哪种类型提供了 `show` 的实现；相反，像 `Show` 这样的传统的 trait 不会。 +2. 要将 show 功能添加到特定类型 `A`，传统的 trait 需要 `A extends Show`，而对于类型类，我们需要实现 `Showable[A]`。 +3. 在 Scala 3 中，为了在两个 `Showable` 中允许相同的方法调用语法来模仿 `Show`，我们将 `Showable.show` 定义为扩展方法。 ### 实现具体实例 下一步是确定在应用程序中，`Showable` 适用于哪些类，然后为它们实现该行为。 例如，为这个 `Person` 类实现 `Showable`： +{% tabs 'person' %} +{% tab 'Scala 2 and 3' %} ```scala case class Person(firstName: String, lastName: String) ``` +{% endtab %} +{% endtabs %} -你将为 `Showable[Person]` 定义一个 `given` 值。 -这段代码为 `Person` 类提供了一个 `Showable` 的具体实例： +你将为 `Showable[Person]` 定义一个 _规范值_ ，例如下面的代码为 `Person` 类提供了一个 `Showable` 的实例： +{% tabs 'instance' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +implicit val showablePerson: Showable[Person] = new Showable[Person] { + def show(p: Person): String = + s"${p.firstName} ${p.lastName}" +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala given Showable[Person] with extension(p: Person) def show: String = s"${p.firstName} ${p.lastName}" ``` - -如图所示，这被定义为 `Person` 类的扩展方法，它使用 `show` 方法主体内的引用 `p`。 +{% endtab %} +{% endtabs %} ### 使用类型类 现在你可以像这样使用这个类型类： +{% tabs 'usage' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +val person = Person("John", "Doe") +println(showablePerson.show(person)) +``` + +注意，在实践中，类型类一般与类型未知的值一起使用，而不像下面章节展示的 `Person` 类。 +{% endtab %} +{% tab 'Scala 3' %} ```scala val person = Person("John", "Doe") println(person.show) ``` +{% endtab %} +{% endtabs %} 同样，如果 Scala 没有可用于每个类的 `toString` 方法，您可以使用此技术将 `Showable` 行为添加到您希望能够转换为 `String` 的任何类。 @@ -88,27 +141,53 @@ println(person.show) 与继承一样，您可以定义使用 `Showable` 作为类型参数的方法： +{% tabs 'method' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +def showAll[A](as: List[A])(implicit showable: Showable[A]): Unit = + as.foreach(a => println(showable.show(a))) + +showAll(List(Person("Jane"), Person("Mary"))) +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala -def showAll[S: Showable](xs: List[S]): Unit = - xs.foreach(x => println(x.show)) +def showAll[A: Showable](as: List[A]): Unit = + as.foreach(x => println(a.show)) showAll(List(Person("Jane"), Person("Mary"))) ``` +{% endtab %} +{% endtabs %} ### 具有多种方法的类型类 请注意，如果要创建具有多个方法的类型类，则初始语法如下所示： +{% tabs 'multiple-methods' class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +trait HasLegs[A] { + def walk(a: A): Unit + def run(a: A): Unit +} +``` +{% endtab %} +{% tab 'Scala 3' %} ```scala trait HasLegs[A]: extension (a: A) def walk(): Unit def run(): Unit ``` +{% endtab %} +{% endtabs %} ### 一个真实的例子 有关如何在 Scala 3 中使用类型类的真实示例，请参阅[多元相等性部分][multiversal]中的 `CanEqual` 讨论。 - +[typeclasses-paper]: https://infoscience.epfl.ch/record/150280/files/TypeClasses.pdf +[typeclasses-chapter]: {% link _overviews/scala3-book/ca-type-classes.md %} +[comparator]: https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html [multiversal]: {% link _zh-cn/overviews/scala3-book/ca-multiversal-equality.md %} From 751d11864c4a362929ec846c4f760e9bf240f31e Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 8 Sep 2023 16:16:52 +0200 Subject: [PATCH 2698/3075] add governance to footer (#2902) --- _data/footer.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_data/footer.yml b/_data/footer.yml index b810181f92..e725cef40a 100644 --- a/_data/footer.yml +++ b/_data/footer.yml @@ -21,6 +21,8 @@ links: - title: Community url: "http://scala-lang.org/community/" + - title: Governance + url: "http://scala-lang.org/community/index.html#governance" - title: Mailing Lists url: "http://scala-lang.org/community/index.html#mailing-lists" - title: Chat Rooms & More From 3d768e8de4a52f57b876142cfd110e034ffd838a Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 6 Sep 2023 12:19:42 -0700 Subject: [PATCH 2699/3075] Scala 2.13.12 --- _config.yml | 2 +- _overviews/FAQ/index.md | 2 +- _overviews/contribute/bug-reporting-guide.md | 2 +- _overviews/contributors/index.md | 2 +- api/all.md | 12 ++++++++---- scripts/run-mdoc.sh | 4 ++-- 6 files changed, 14 insertions(+), 10 deletions(-) diff --git a/_config.yml b/_config.yml index c03134b823..f9d9ded020 100644 --- a/_config.yml +++ b/_config.yml @@ -15,7 +15,7 @@ keywords: - Document - Guide -scala-version: 2.13.11 +scala-version: 2.13.12 scala-212-version: 2.12.18 scala-3-version: 3.3.1 diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 0420ecc64b..f46c239b1c 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -120,7 +120,7 @@ with only minor supplements. That's why `versionString` and `versionNumberString` report that Scala 2 is in use: ``` -Welcome to Scala 3.2.0 (17.0.3, Java OpenJDK 64-Bit Server VM). +Welcome to Scala 3.3.0 (17.0.3, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. scala> util.Properties.versionNumberString diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 9787238073..91aa784e2f 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -65,7 +65,7 @@ If you cannot find your issue in the issue tracker, create a new bug. The detail Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - 1. **Exact Scala version** that you are using. For example, `2.13.11` or `3.3.0`. If the bug happens in multiple versions indicate all of them. + 1. **Exact Scala version** that you are using. For example, `2.13.12` or `3.3.0`. If the bug happens in multiple versions indicate all of them. 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? diff --git a/_overviews/contributors/index.md b/_overviews/contributors/index.md index 0460e1c4d3..757f8b92da 100644 --- a/_overviews/contributors/index.md +++ b/_overviews/contributors/index.md @@ -360,7 +360,7 @@ If you have written a library, you probably want it to be usable from several Sc Define the versions you want to support in the `crossScalaVersions` setting, in your `build.sbt` file: ~~~ scala -crossScalaVersions := Seq("3.3.0", "2.13.11", "2.12.18") +crossScalaVersions := Seq("3.3.0", "2.13.12", "2.12.18") scalaVersion := crossScalaVersions.value.head ~~~ diff --git a/api/all.md b/api/all.md index ef1924c385..a39fc293da 100644 --- a/api/all.md +++ b/api/all.md @@ -10,10 +10,10 @@ redirect_from: * Scala 3.3.1 LTS * [Library API](https://www.scala-lang.org/api/3.3.1/) -* Scala 2.13.11 - * [Library API](https://www.scala-lang.org/api/2.13.11/) - * [Compiler API](https://www.scala-lang.org/api/2.13.11/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.13.11/scala-reflect/scala/reflect/) +* Scala 2.13.12 + * [Library API](https://www.scala-lang.org/api/2.13.12/) + * [Compiler API](https://www.scala-lang.org/api/2.13.12/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.12/scala-reflect/scala/reflect/) * Scala 2.12.18 * [Library API](https://www.scala-lang.org/api/2.12.18/) * [Compiler API](https://www.scala-lang.org/api/2.12.18/scala-compiler/scala/) @@ -84,6 +84,10 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.0.1/) * Scala 3.0.0 * [Library API](https://www.scala-lang.org/api/3.0.0/) +* Scala 2.13.11 + * [Library API](https://www.scala-lang.org/api/2.13.11/) + * [Compiler API](https://www.scala-lang.org/api/2.13.11/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.11/scala-reflect/scala/reflect/) * Scala 2.13.10 * [Library API](https://www.scala-lang.org/api/2.13.10/) * [Compiler API](https://www.scala-lang.org/api/2.13.10/scala-compiler/scala/) diff --git a/scripts/run-mdoc.sh b/scripts/run-mdoc.sh index d74316b9c0..ab2c1c6249 100755 --- a/scripts/run-mdoc.sh +++ b/scripts/run-mdoc.sh @@ -1,11 +1,11 @@ #!/bin/bash set -eux -cs launch --scala-version 2.13.11 org.scalameta::mdoc:2.3.3 -- \ +cs launch --scala-version 2.13.12 org.scalameta::mdoc:2.3.3 -- \ --in . \ --out /tmp/mdoc-out/ \ --classpath \ - $(cs fetch --scala-version 2.13.11 -p \ + $(cs fetch --scala-version 2.13.12 -p \ com.chuusai::shapeless:2.3.10 \ org.scala-lang::toolkit:0.1.7 \ org.scala-lang::toolkit-test:0.1.7 \ From 0e533cd5e27efdd6282dab06714d29c7ab8e0995 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Fri, 8 Sep 2023 19:04:44 +0200 Subject: [PATCH 2700/3075] FAQ: add note about release numbers --- _overviews/FAQ/index.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index f46c239b1c..c02e279807 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -120,14 +120,18 @@ with only minor supplements. That's why `versionString` and `versionNumberString` report that Scala 2 is in use: ``` -Welcome to Scala 3.3.0 (17.0.3, Java OpenJDK 64-Bit Server VM). +Welcome to Scala 3.3.1 (17.0.3, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. scala> util.Properties.versionNumberString -val res0: String = 2.13.11 +val res0: String = 2.13.10 ``` -Note that Scala 3 offers +Note that even the latest Scala 3 version might not use the very +latest Scala 2 standard library, since the 3 and 2 release schedules +aren't coordinated. + +So how do you ask for the Scala 3 version number? Scala 3 offers `dotty.tools.dotc.config.Properties.versionNumberString`, but only if you have scala3-compiler on the classpath. So that works in the Scala 3 REPL, but won't work in typical Scala 3 application code. From 4213baa8e7e32c0a165deca6aea1ba099715d0f5 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Sat, 9 Sep 2023 17:58:59 +0200 Subject: [PATCH 2701/3075] JDK compat page: 3.3.1 is out (#2903) --- _overviews/jdk-compatibility/overview.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 2f4bcf10d2..3535e2656a 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,7 +12,7 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | JDK version | Minimum Scala versions | |:-----------:|:-------------------------------------------------------------| -| 21 (ea) | 3.3.1 (soon), 2.13.11, 2.12.18 | +| 21 (ea) | 3.3.1, 2.13.11, 2.12.18 | | 20 | 3.3.0, 2.13.11, 2.12.18 | | 19 | 3.2.0, 2.13.9, 2.12.16 | | 18 | 3.1.3, 2.13.7, 2.12.15 | @@ -101,13 +101,11 @@ Support for JDK 20 was included in Scala 3.3.0, 2.13.11, and 2.12.18. ## JDK 21 compatibility notes -Early access builds of JDK 21 are already available. JDK 21 will +Early access builds of JDK 21 are available. JDK 21 will be an LTS release. Initial support for JDK 21 has been merged and is already available in -Scala 2.13.11 and 2.12.18 and in nightly builds of Scala 3. - -The support will be included in the forthcoming Scala 3.3.1 release. +Scala 3.3.1, 2.13.11, and 2.12.18. ## GraalVM Native Image compatibility notes From 0d91e97c819131650735694a7bd4a8043e92c04a Mon Sep 17 00:00:00 2001 From: adpi2 <adrien.piquerez@gmail.com> Date: Mon, 11 Sep 2023 08:20:31 +0200 Subject: [PATCH 2702/3075] Update migration guide (#2901) * Update migration guide - Updated to latest versions of Scala (3.3.0, 2.13.11) - sbt-scala3-migrate tuto moved to tutorials chapter - sbt-scala3-migrate tuto updated to 0.6.0 version * Bump to 3.3.1 * Bump sbt-scala3-migrate to 0.6.1 * fix CI --- .../compatibility-classpath.md | 30 +- .../compatibility-metaprogramming.md | 8 +- .../scala3-migration/external-resources.md | 4 +- _overviews/scala3-migration/scala3-migrate.md | 615 +++++++++++------- .../tooling-migration-mode.md | 7 +- _overviews/scala3-migration/tooling-tour.md | 43 +- _overviews/scala3-migration/tutorial-intro.md | 7 +- .../tutorial-macro-cross-building.md | 14 +- .../scala3-migration/tutorial-macro-mixing.md | 14 +- .../tutorial-prerequisites.md | 4 +- _overviews/scala3-migration/tutorial-sbt.md | 34 +- resources/js/functions.js | 3 +- 12 files changed, 449 insertions(+), 334 deletions(-) diff --git a/_overviews/scala3-migration/compatibility-classpath.md b/_overviews/scala3-migration/compatibility-classpath.md index fbe2684dc1..6b25280994 100644 --- a/_overviews/scala3-migration/compatibility-classpath.md +++ b/_overviews/scala3-migration/compatibility-classpath.md @@ -24,15 +24,16 @@ The Scala 3 unpickler has been extensively tested in the community build for man ![Scala 3 module depending on a Scala 2.13 artifact](/resources/images/scala3-migration/compatibility-3-to-213.svg) -As an sbt build it can be illustrated by (sbt 1.5.0 or higher is required): +As an sbt build, it looks like this: ```scala +// build.sbt (sbt 1.5 or higher) lazy val foo = project.in(file("foo")) - .settings(scalaVersion := "3.0.0") + .settings(scalaVersion := "3.3.1") .dependsOn(bar) lazy val bar = project.in(file("bar")) - .settings(scalaVersion := "2.13.6") + .settings(scalaVersion := "2.13.11") ``` Or, in case bar is a published Scala 2.13 library, we can have: @@ -40,7 +41,7 @@ Or, in case bar is a published Scala 2.13 library, we can have: ```scala lazy val foo = project.in(file("foo")) .settings( - scalaVersion := "3.0.0", + scalaVersion := "3.3.1", libraryDependencies += ("org.bar" %% "bar" % "1.0.0").cross(CrossVersion.for3Use2_13) ) ``` @@ -56,13 +57,11 @@ Let's note that the standard library is automatically provided by the build tool ## The Scala 2.13 TASTy Reader -The second piece of good news is that the Scala 2.13 TASTy reader, which enables consuming Scala 3 libraries has been shipped since Scala 2.13.4. - -> The TASTy reader is very new. That's why it is only available under the `-Ytasty-reader` flag. +The second piece of good news is that Scala 2.13 can consume Scala 3 libraries with `-Ytasty-reader`. ### Supported Features -The TASTy reader supports all the traditional language features as well as the following brand-new features: +The TASTy reader supports all the traditional language features as well as the following Scala 3 features: - [Enumerations]({{ site.scala3ref }}/enums/enums.html) - [Intersection Types]({{ site.scala3ref }}/new-types/intersection-types.html) - [Opaque Type Aliases]({{ site.scala3ref }}/other-new-features/opaques.html) @@ -71,11 +70,11 @@ The TASTy reader supports all the traditional language features as well as the f - [Open Classes]({{ site.scala3ref }}/other-new-features/open-classes.html) (and inheritance of super traits) - [Export Clauses]({{ site.scala3ref }}/other-new-features/export.html) -We have limited support on: +It partially supports: - [Top-Level Definitions]({{ site.scala3ref }}/dropped-features/package-objects.html) - [Extension Methods]({{ site.scala3ref }}/contextual/extension-methods.html) -More exotic features are not supported: +It does not support the more advanced features: - [Context Functions]({{ site.scala3ref }}/contextual/context-functions.html) - [Polymorphic Function Types]({{ site.scala3ref }}/new-types/polymorphic-function-types.html) - [Trait Parameters]({{ site.scala3ref }}/other-new-features/trait-parameters.html) @@ -94,18 +93,19 @@ By enabling the TASTy reader with `-Ytasty-reader`, a Scala 2.13 module can depe ![Scala 2 module depending on a Scala 3 artifact](/resources/images/scala3-migration/compatibility-213-to-3.svg) -As an sbt build it can be illustrated by: +As an sbt build, it looks like this: ```scala +// build.sbt (sbt 1.5 or higher) lazy val foo = project.in.file("foo") .settings( - scalaVersion := "2.13.6", + scalaVersion := "2.13.11", scalacOptions += "-Ytasty-reader" ) .dependsOn(bar) lazy val bar = project.in(file("bar")) - .settings(scalaVersion := "3.0.0") + .settings(scalaVersion := "3.3.1") ``` Or, in case `bar` is a published Scala 3 library: @@ -113,7 +113,7 @@ Or, in case `bar` is a published Scala 3 library: ```scala lazy val foo = project.in.file("foo") .settings( - scalaVersion := "2.13.6", + scalaVersion := "2.13.11", scalacOptions += "-Ytasty-reader", libraryDependencies += ("org.bar" %% "bar" % "1.0.0").cross(CrossVersion.for2_13Use3) ) @@ -137,7 +137,5 @@ The inverted pattern, with a 2.13 module in the middle, is also possible. > #### Disclaimer for library maintainers > -> Using the interoperability between Scala 2.13 and Scala 3 in a published library is generally not safe for your end-users. -> > Unless you know exactly what you are doing, it is discouraged to publish a Scala 3 library that depends on a Scala 2.13 library (the scala-library being excluded) or vice versa. > The reason is to prevent library users from ending up with two conflicting versions `foo_2.13` and `foo_3` of the same foo library in their classpath, this problem being unsolvable in some cases. diff --git a/_overviews/scala3-migration/compatibility-metaprogramming.md b/_overviews/scala3-migration/compatibility-metaprogramming.md index 6b0e55b537..aae66f0532 100644 --- a/_overviews/scala3-migration/compatibility-metaprogramming.md +++ b/_overviews/scala3-migration/compatibility-metaprogramming.md @@ -14,7 +14,7 @@ Therefore it is not possible for the Scala 3 compiler to expand any Scala 2.13 m In contrast, Scala 3 introduces a new principled approach of metaprogramming that is designed for stability. Scala 3 macros, and inline methods in general, will be compatible with future versions of the Scala 3 compiler. -While this is an uncontested improvement, it also means that all Scala 2.13 macros have to be rewritten from the ground up, by using the new metaprogramming features. +While this is an uncontested improvement, it also means that all Scala 2.13 macros have to be rewritten from the ground up, using the new metaprogramming features. ## Macro Dependencies @@ -54,16 +54,16 @@ They are comprised of: Before getting deep into reimplementing a macro you should ask yourself: - Can I use `inline` and the `scala.compiletime` operations to reimplement my logic? -- Can I use the simpler and safer expression based macros? +- Can I use the simpler and safer expression-based macros? - Do I really need to access the AST? - Can I use a [match type]({{ site.scala3ref }}/new-types/match-types.html) as return type? -You can learn all the new metaprogramming concepts by reading the [Macro Tutorial][scala3-macros]. +You can learn all the new metaprogramming concepts by reading the [Macros in Scala 3][scala3-macros] tutorial. ## Cross-building a Macro Library You have written a wonderful macro library and you would like it to be available in Scala 2.13 and Scala 3. -There are two different approaches, the traditional cross-building technique and the more recent mixing macro technique. +There are two different approaches, the traditional cross-building technique and the more experimental mixing macro technique. You can learn about them by reading these tutorials: - [Cross-Building a Macro Library](tutorial-macro-cross-building.html) - [Mixing Scala 2.13 and Scala 3 Macros](tutorial-macro-mixing.html) diff --git a/_overviews/scala3-migration/external-resources.md b/_overviews/scala3-migration/external-resources.md index 4915537176..9f968c6df9 100644 --- a/_overviews/scala3-migration/external-resources.md +++ b/_overviews/scala3-migration/external-resources.md @@ -1,8 +1,8 @@ --- title: External Resources -type: section +type: chapter description: This section lists external resources about the migration to Scala 3. -num: 27 +num: 28 previous-page: plugin-kind-projector next-page: --- diff --git a/_overviews/scala3-migration/scala3-migrate.md b/_overviews/scala3-migration/scala3-migrate.md index 4a6c0f98bb..554ca5f021 100644 --- a/_overviews/scala3-migration/scala3-migrate.md +++ b/_overviews/scala3-migration/scala3-migrate.md @@ -1,320 +1,443 @@ --- -title: Scala3-migrate plugin (sbt) -type: chapter +title: Porting an sbt Project (using sbt-scala3-migrate) +type: section description: This section shows how to use scala3-migrate to migrate a project -num: 7 -previous-page: tooling-tour -next-page: tooling-migration-mode +num: 10 +previous-page: tutorial-prerequisites +next-page: tutorial-sbt --- -## Context +`sbt-scala3-migrate` is an sbt plugin to assist you during the migration of your sbt project to Scala 3. +It consists of four sbt commands: +- `migrateDependencies` helps you update the list of `libraryDependencies` +- `migrateScalacOptions` helps you update the list of `scalacOptions` +- `migrateSyntax` fixes a number of syntax incompatibilities between Scala 2.13 and Scala 3 +- `migrateTypes` tries to compile your code to Scala 3 by infering types and resolving implicits where needed. -Scala3-migrate tool is part of a series of initiatives to make the migration to Scala 3 as easy as possible. -The goal is to provide a tool that will help you migrate both your build and your code to Scala 3. -The solution consists of 4 independent steps that are packaged into an sbt plugin: - -- **migrate-libs**: helps you update the list of `libraryDependencies` -- **migrate-scalacOptions**: helps you update the list of `scalacOptions` -- **migrate-syntax**: fixes a number of syntax incompatibilities in Scala 2.13 code -- **migrate**: tries to make your code compile with Scala 3 by adding the minimum required inferred types and implicit arguments. - -Each one of these steps is an sbt command that is described in details below. +Each one of these commands is described in details below. > #### Requirements -> - Scala 2.13, preferred 2.13.7 +> - Scala 2.13, preferred 2.13.11 > - sbt 1.5 or higher > - **Disclaimer:** This tool cannot migrate libraries containing macros. +> +> #### Recommendation +> Before the migration, add `-Xsource:3` to your scalac options to enable some Scala 3 syntax and behavior. -## Installation +In this tutorial, we will migrate the project in [scalacenter/scala3-migration-example](https://github.com/scalacenter/scala3-migration-example). +To learn about the migration, and train yourself, you can clone this repository and follow the tutorial steps. -Currently, you can use scala3-migrate via an sbt plugin. You can add it as follows to your build. +## 1. Installation + +Add `sbt-scala3-migrate` in the `project/plugins.sbt` file of your sbt project. ``` scala // project/plugins.sbt -addSbtPlugin("ch.epfl.scala" % "sbt-scala3-migrate" % "0.5.0") +addSbtPlugin("ch.epfl.scala" % "sbt-scala3-migrate" % "0.6.1") ``` -<div><p>The latest published version is <a href="https://index.scala-lang.org/scalacenter/scala3-migrate/scala3-migrate"> -<img src="https://index.scala-lang.org/scalacenter/scala3-migrate/scala3-migrate/latest-by-scala-version.svg" alt="scala3-migrate Scala version support" style="margin-bottom: 0px; max-width: 30%;"> + +<div><p>The latest published version is <a href="https://index.scala-lang.org/scalacenter/scala3-migrate/sbt-scala3-migrate"> +<img src="https://index.scala-lang.org/scalacenter/scala3-migrate/sbt-scala3-migrate/latest-by-scala-version.svg" alt="scala3-migrate Scala version support" style="margin-bottom: 0px; max-width: 30%;"> </a></p> </div> -## Choose a module +## 2. Choose a module + If your project contains more than one module, the first step is to choose which module to migrate first. -Follow [this section to choose the first module.](tutorial-sbt.html#2-choose-a-module) -> Scala3-migrate operates on one module at a time. -> Make sure the module you choose is not an aggregate of modules. +Thanks to the interoperability between Scala 2.13 and Scala 3 you can start with any module. +However it is probably simpler to start with the module that has the fewest dependencies. + +> `sbt-scala3-migrate` operates on one module at a time. +> Make sure the module you choose is not an aggregate. + +## 3. Migrate the dependencies -## Migrate library dependencies -> All the commands will be run in an sbt shell +> All the commands in this tutorial must be run in the sbt shell. -**Usage:** `migrate-libs projectId` where projectId is the name of the module to migrate. +**Usage:** `migrateDependencies <project>` + +For the purpose of this tutorial we will consider the following build configuration: -For example, let's migrate the following sbt build. ```scala //build.sbt lazy val main = project .in(file(".")) .settings( - name := "main", - scalaVersion := "2.13.7", - semanticdbEnabled := true, - scalacOptions ++= Seq("-explaintypes", "-Wunused"), + scalaVersion := "2.13.11", libraryDependencies ++= Seq( - "org.typelevel" %% "cats-core" % "2.2.0", - "ch.epfl.scala" % "scalafix-interfaces" % "0.9.26", - "com.softwaremill.scalamacrodebug" %% "macros" % "0.4.1" % Test, - "ch.epfl.scala" %% "scalafix-rules" % "0.9.26" % Test, - compilerPlugin("org.typelevel" %% "kind-projector" % "0.11.0" cross CrossVersion.full), - compilerPlugin("com.olegpy" %% "better-monadic-for" % "0.3.1") - ) + "org.typelevel" %% "cats-core" % "2.4.0", + "io.github.java-diff-utils" % "java-diff-utils" % "4.12", + "org.scalameta" %% "parsers" % "4.8.9", + "org.scalameta" %% "munit" % "0.7.23" % Test, + "com.softwaremill.scalamacrodebug" %% "macros" % "0.4.1" % Test + ), + addCompilerPlugin(("org.typelevel" %% "kind-projector" % "0.13.2").cross(CrossVersion.full)), + addCompilerPlugin("com.olegpy" %% "better-monadic-for" % "0.3.1") ) ``` -First, let's run the command and see the result. -``` -> migrate-libs main -[info] Starting to migrate libDependencies for main -[info] -[info] X : Cannot be updated to Scala 3 -[info] Valid : Already a valid version for Scala 3 -[info] To be updated : Need to be updated to the following version -[info] -[info] com.softwaremill.scalamacrodebug:macros:0.4.1:test -> X : Contains Macros and is not yet published for Scala 3. -[info] com.olegpy:better-monadic-for:0.3.1:plugin->default(compile) -> X : Scala 2 compiler plugins are not supported in Scala 3. You need to find an alternative. -[info] "ch.epfl.scala" % "scalafix-interfaces" % "0.9.26" -> Valid : Java libraries are compatible. -[info] ch.epfl.scala:scalafix-rules:0.9.26:test -> "ch.epfl.scala" %% "scalafix-rules" % "0.9.26" % "test" cross CrossVersion.for3Use2_13 : It's only safe to use the 2.13 version if it's inside an application. -[info] org.typelevel:cats-core:2.2.0 -> "org.typelevel" %% "cats-core" % "2.6.1" : Other versions are avaialble for Scala 3: "2.7.0" -[info] org.typelevel:kind-projector:0.11.0:plugin->default(compile) -> -Ykind-projector : This compiler plugin has a scalacOption equivalent. Add it to your scalacOptions. -``` - -### Valid libraries -``` -[info] ch.epfl.scala:scalafix-interfaces:0.9.26 -> Valid +Running `migrateDependencies main` outputs: + +<pre> +<code class="hljs hljs-skip"> +sbt:main> migrateDependencies main +[info] +[info] Starting migration of libraries and compiler plugins of project main +[info] +[info] <span style="color:green">Valid dependencies:</span> +[info] "io.github.java-diff-utils" % "java-diff-utils" % "4.12" + +[warn] +[warn] <span style="color:orange">Versions to update:</span> +[warn] "org.typelevel" %% "cats-core" % "<span style="color:orange">2.6.1</span>" <span style="color:orange">(Other versions: 2.7.0, ..., 2.10.0)</span> +[warn] "org.scalameta" %% "munit" % "<span style="color:orange">0.7.25</span>" % Test <span style="color:orange">(Other versions: 0.7.26, ..., 1.0.0-M8)</span> +[warn] +[warn] <span style="color:orange">For Scala 3 use 2.13:</span> +[warn] ("org.scalameta" %% "parsers" % "4.8.9")<span style="color:orange">.cross(CrossVersion.for3Use2_13)</span> +[warn] +[warn] <span style="color:orange">Integrated compiler plugins:</span> +[warn] addCompilerPlugin(("org.typelevel" %% "kind-projector" % "0.13.2").cross(CrossVersion.full)) +[warn] replaced by <span style="color:orange">scalacOptions += "-Ykind-projector"</span> +[error] +[error] <span style="color:red">Incompatible Libraries:</span> +[error] "com.softwaremill.scalamacrodebug" %% "macros" % "0.4.1" % Test <span style="color:red">(Macro Library)</span> +[error] addCompilerPlugin("com.olegpy" %% "better-monadic-for" % "0.3.1") <span style="color:red">(Compiler Plugin)</span> +[info] +[success] Total time: 0 s, completed Aug 28, 2023 9:18:04 AM +</code> +</pre> + +Let's take a closer look at each part of this output message. + +### Valid dependencies + +Valid dependencies are compatible with Scala 3, either because they are standard Java libraries or because they have been cross-published to Scala 3. + +<pre> +<code class="hljs hljs-skip"> +[info] <span style="color:green">Valid dependencies:</span> +[info] "io.github.java-diff-utils" % "java-diff-utils" % "4.12" +</code> +</pre> + +You can keep them as they are. + +### Versions to update + +These libraries have been cross-published to Scala 3 in later versions. +You need to update their versions. + +<pre> +<code class="hljs hljs-skip"> +[warn] <span style="color:orange">Versions to update:</span> +[warn] "org.typelevel" %% "cats-core" % "<span style="color:orange">2.6.1</span>" <span style="color:orange">(Other versions: 2.7.0, ..., 2.10.0)</span> +[warn] "org.scalameta" %% "munit" % "<span style="color:orange">0.7.25</span>" % Test <span style="color:orange">(Other versions: 0.7.26, ..., 1.0.0-M8)</span> +</code> +</pre> + +In the given example we need to bump the version of cats-core to 2.6.1 and the version of munit to 0.7.25. + +> The `Other versions` part of the output message indicates which other versions are available in Scala 3. +If you wish you can bump to one of the most recent version, but take care of choosing a source compatible version. +According to [the semantic versionning scheme](https://semver.org/), a patch or minor version bump is safe but not a major version bump. + + +### For Scala 3 use 2.13 + +These libraries are not yet cross-published to Scala 3 but they are cross-compatible. +You can use their 2.13 versions to compile to Scala 3. + +Add `.cross(CrossVersion.for3Use2_13)` on the libraries to tell sbt to use the `_2.13` suffix, instead of `_3`. + +<pre> +<code class="hljs hljs-skip"> +[warn] <span style="color:orange">For Scala 3 use 2.13:</span> +[warn] ("org.scalameta" %% "parsers" % "4.8.9")<span style="color:orange">.cross(CrossVersion.for3Use2_13)</span> +</code> +</pre> + +> #### Disclaimer about `CrossVersion.for3Use2_13`: +- It can cause a conflict on the `_2.13` and `_3` suffixes of a transitive dependency. +In such situation, sbt will fail to resolve the dependency, with a clear error message. +- It is generally not safe to publish a Scala 3 library which depends on a Scala 2.13 library. +Otherwise users of the library can have conflicting `_2.13` and `_3` suffixes on the same dependency. + +### Integrated compiler plugins + +Some compiler plugins were integrated into the Scala 3 compiler itself. +In Scala 3 you don't need to resolve them as dependencies but you can activate them with compiler flags. + +<pre> +<code class="hljs hljs-skip"> +[warn] <span style="color:orange">Integrated compiler plugins:</span> +[warn] addCompilerPlugin(("org.typelevel" %% "kind-projector" % "0.13.2").cross(CrossVersion.full)) +[warn] replaced by <span style="color:orange">scalacOptions += "-Ykind-projector"</span> +</code> +</pre> + +Here for instance you can activate kind-projector by adding `-Ykind-projector` to the list of `scalacOptions`. + +During the migration process, it is important to maintain the compatibility with Scala 2.13. +The later `migrateSyntax` and `migrateTypes` commands will use the Scala 2.13 compilation to rewrite some parts of the code automatically. + +You can configure kind-projector in a cross-compatible way like this: +```scala +// add kind-projector as a dependency on Scala 2 +libraryDependencies ++= { + if (scalaVersion.value.startsWith("3.")) Seq.empty + else Seq( + compilerPlugin(("org.typelevel" %% "kind-projector" % "0.13.2").cross(CrossVersion.full)) + ) +}, +// activate kind-projector in Scala 3 +scalacOptions ++= { + if (scalaVersion.value.startsWith("3.")) Seq("-Ykind-projector") + else Seq.empty +} ``` -Valid libraries are libraries that can be kept as they are. Those libraries are either already -compatible with Scala 3, or they are Java libraries. - -### Libraries that need to be updated -```text -org.typelevel:cats-core:2.2.0 -> "org.typelevel" %% "cats-core" % "2.6.1" : Other versions are avaialble for Scala 3: "2.7.0" -ch.epfl.scala:scalafix-rules:0.9.26:test -> "ch.epfl.scala" %% "scalafix-rules" % "0.9.26" % "test" cross CrossVersion.for3Use2_13 : It's only safe to use the 2.13 version if it's inside an application. -``` +### Incompatible libraries -- For `cats-core` there is a version that has been published for Scala 3 - which is the proposed version `2.6.1`. We can update the build with this new version. There is also - a more recent version available which is `2.7.0` (but we need to use at least version 2.6.1 to get Scala 3 compatibility). - -- For `scalafix-rules`, there is no available version for Scala 3, but the library does not contain macros, - and therefore the `2.13` version can be used as it is in Scala 3. The syntax still needs to be updated to - `"ch.epfl.scala" %% "scalafix-rules" % "0.9.26" % "test" cross CrossVersion.for3Use2_13`. - It’s not recommended to publish a Scala 3 library that depends on a Scala 2.13 library. - The reason is to prevent library users from ending up with two conflicting versions of - the same library in their classpath (one for Scala 2.13 and one for Scala 3), this problem can not be solved in some cases. - Read more about this topic in [the interoperability-overview](compatibility-classpath.html#interoperability-overview). - -### Macro library -```text -com.softwaremill.scalamacrodebug:macros:0.4.1:test -> X : Contains Macros and is not yet published for Scala 3. -``` -Scala 2 macros cannot be executed by the Scala 3 compiler. -So if you depend on a library that relies on macros, you will have to wait until this library is published for Scala 3. +Some macro libraries or compiler plugins are not compatible with Scala 3. -### Compiler plugins -```text -com.olegpy:better-monadic-for:0.3.1:plugin->default(compile) -> X : Scala 2 compiler plugins are not supported in Scala 3. You need to find an alternative. -org.typelevel:kind-projector:0.11.0:plugin->default(compile) -> -Ykind-projector : This compiler plugin has a scalacOption equivalent. Add it to your scalacOptions. -``` +<pre> +<code class="hljs hljs-skip"> +[error] <span style="color:red">Incompatible Libraries:</span> +[error] "com.softwaremill.scalamacrodebug" %% "macros" % "0.4.1" % Test <span style="color:red">(Macro Library)</span> +[error] addCompilerPlugin("com.olegpy" %% "better-monadic-for" % "0.3.1") <span style="color:red">(Compiler Plugin)</span> +</code> +</pre> -`better-monadic-for` is a Scala 2 compiler plugin. -As explained in this [section](tutorial-sbt.html#2-choose-a-module), Scala 2 compiler plugins are not -supported in Scala 3. -In this case, we need to remove `better-monadic-for` and fix the code manually to make it compile without the compiler plugin. +To solve these incompatibilities, you can either: +- Check with the maintainers if they plan to port them to Scala 3, and possibly help them to do so. +- Remove these dependencies from your build and adapt the code accordingly. -For `kind-projector`, which is also a Scala 2 compiler plugin, there is an equivalent compiler option, `-Ykind-projector` (as shown in the message), which -can be added to your `scalacOptions`. +### The updated build -### The new build file -To update the build, for all incompatible settings or libraries, we assign different `scalacOptions` and `libraryDependencies` depending on the `scalaVersion`. +After you updated the build, it should look like this: ```scala //build.sbt lazy val main = project .in(file(".")) .settings( - name := "main", - scalaVersion := "2.13.7", - semanticdbEnabled := true, - scalacOptions ++= { - if (scalaVersion.value.startsWith("3")) Seq("-Werror", "-Ykind-projector") - else Seq("-Werror", "-Wunused") - }, - libraryDependencies ++= ( - if (scalaVersion.value.startsWith("3")) Seq() - else - Seq(compilerPlugin("org.typelevel" %% "kind-projector" % "0.13.2" cross CrossVersion.full)) - ), + scalaVersion := "2.13.11", libraryDependencies ++= Seq( - "org.typelevel" %% "cats-core" % "2.6.1", - "ch.epfl.scala" % "scalafix-interfaces" % "0.9.26", - "ch.epfl.scala" %% "scalafix-rules" % "0.9.26" % "test" cross CrossVersion.for3Use2_13 - ) + "org.typelevel" %% "cats-core" % "2.6.1", + "io.github.java-diff-utils" % "java-diff-utils" % "4.12", + ("org.scalameta" %% "parsers" % "4.8.9").cross(CrossVersion.for3Use2_13), + "org.scalameta" %% "munit" % "0.7.25" % Test + ), + libraryDependencies ++= { + if (scalaVersion.value.startsWith("3.")) Seq.empty + else Seq( + compilerPlugin(("org.typelevel" %% "kind-projector" % "0.13.2").cross(CrossVersion.full)) + ) + }, + scalacOptions ++= { + if (scalaVersion.value.startsWith("3.")) Seq("-Ykind-projector") + else Seq.empty + } ) ``` -## Migrate `scalacOptions` -**Usage:** `migrate-scalacOptions projectId` where projectId is the name of the module chosen to be migrated. - -This command helps with the process of updating the compiler settings. It is based on -[the Compiler Options Table](options-lookup.html). -Between Scala 2.13 and Scala 3.1.0, the available compiler options are different: -- some Scala 2.13 settings have been removed -- others have been renamed -- some remain the same. - -The previous build file specifies two scalacOptions: `-Werror` and `-Wunused` -``` -> migrate-scalacOptions main -[info] X : the option is not available in Scala 3 -[info] Renamed : the option has been renamed -[info] Valid : the option is still valid -[info] Plugin : the option is related to a plugin, previously handled by migrate-libs -[info] -[info] -Wunused -> X -[info] -Werror -> -Xfatal-warnings - -[info] Plugins options -[info] -Yrangepos -> X -[info] -Xplugin:/Users/meriamlachkar/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/org/typelevel/kind-projector_2.13.3/0.13.2/kind-projector_2.13.3-0.13.2.jar -> Plugin -[info] -Xplugin:/Users/meriamlachkar/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/org/scalameta/semanticdb-scalac_2.13.3/4.4.20/semanticdb-scalac_2.13.3-4.4.20.jar -> Plugin -[info] -P:semanticdb:synthetics:on -> Plugin -[info] -P:semanticdb:sourceroot:/Users/meriamlachkar/perso/plugin-test -> Plugin -[info] -P:semanticdb:targetroot:/Users/meriamlachkar/perso/plugin-test/target/scala-2.13/meta -> Plugin -[info] -P:semanticdb:failures:warning -> Plugin - -``` +Reload sbt, check that the project compiles (to Scala 2.13), check that the tests run successfully, and commit your changes. +You are now ready to migrate the compiler options. -We see that `-Wunusued` is specific to Scala 2 and doesn't have an equivalent in scala3, so we need to -remove it, whereas `-Werror` exists under a different name: `-Xfatal-warnings`, and can be renamed. +## 4. Migrate the compiler options -The command also outputs information specific to sbt plugins. -There is no need to modify them, the plugins are supposed to adapt the settings for Scala 3. +**Usage:** `migrateScalacOptions <project>` -In this specific case: - - we don’t need to remove `-Yrangepos`. - - `kind-projector` plugin has been replaced in the previous step - - `Xplugin:semanticdb` and all the specific options of the `semanticdb` plugin starting by `-P:semanticdb:...` are -added through an sbt setting `semanticdbEnabled := true` that is set by scala3-migrate (this tool). -If `semanticdb` is added through `compilerPlugin` or `addCompilerPlugin`, it will be -listed as a library dependency when we execute migrate-libs. -The support of SemanticDB is now shipped into the Scala 3 compiler, and will be configured with the same setting: -`semanticdbEnabled := true`. Scala3-migrate doesn't enable SemanticDB in Scala 3 unless it's configured in the build. +The Scala 3 compiler does not contain the exact same set of options as the Scala 2 compiler. +You can check out the [the Compiler Options Table](options-lookup.html) to get a full comparison of all the compilers options. -To conclude, all the information specific to the sbt plugins displayed by `migrate-scalacOption` can be -ignored if the previous step has been followed successfully. +The `migrateScalacOptions` will help you update the list of `scalacOptions` in your build. -### The new build file -In the previous build file change, we have already introduce the distinction between scala verions, so this time we only need to update the values. +For the purpose of this tutorial we will consider the following build configuration: ```scala - scalacOptions ++= - (if (scalaVersion.value.startsWith("3")) - Seq("-Xfatal-warnings", "-Ykind-projector") - else Seq("-Werror", "-Wunused")) +lazy val main = project + .in(file(".")) + .settings( + scalaVersion := "2.13.11", + scalacOptions ++= Seq( + "-encoding", + "UTF-8", + "-target:jvm-1.8", + "-Xsource:3", + "-Wunused:imports,privates,locals", + "-explaintypes" + ) + ) ``` -> The build is now fully updated. -> You can change the `scalaVersion` in the sbt shell, and launch the compile task. -> Your project may already successfully compile in scala 3! - -## Fix some syntax incompatibilities -An incompatibility is a piece of code that compiles in Scala 2.13 but does not compile in Scala 3. -Migrating a code base involves finding and fixing all the incompatibilities of the source code. +Running `migrateScalacOptions main` outputs: + +<pre> +<code class="hljs hljs-skip"> +sbt:main> migrateScalacOptions main +[info] +[info] Starting migration of scalacOptions in main +[info] +[info] <span style="color:green">Valid scalacOptions:</span> +[info] -encoding UTF-8 +[info] -Wunused:imports,privates,locals +[warn] +[warn] <span style="color:orange">Renamed scalacOptions:</span> +[warn] -target:jvm-1.8 -> <span style="color:orange">-Xunchecked-java-output-version:8</span> +[warn] -explaintypes -> <span style="color:orange">-explain</span> +[warn] +[warn] <span style="color:orange">Removed scalacOptions:</span> +[warn] -Xsource:3 +[warn] -Yrangepos +[success] Total time: 0 s, completed Aug 29, 2023 2:00:57 PM +</code> +</pre> + +Some scalac options are still valid, some must be renamed and some must be removed. + +> Some options can appear in the output of `migrateScalacOptions` but not in your `build.sbt`. +> They are added by sbt or by some sbt plugins. +> Make sure to use up-to-date versions of sbt and sbt plugins. +> They should be able to adapt the added compiler options to the Scala version automatically. + +Once again, it is important to maintain the compatibility with Scala 2.13 because the `migrateSyntax` and `migrateTypes` commands will use the Scala 2.13 compilation to apply some patches automatically. + +Here is how we can update the list of scalacOptions: +```scala +lazy val main = project + .in(file(".")) + .settings( + scalaVersion := "2.13.11", + scalacOptions ++= { + if (scalaVersion.value.startsWith("3.")) scala3Options + else scala2Options + } + ) -This third command applies a number of scalafix rules that fix some of the deprecated syntaxes. -Once those changes are applied, the code still compiles in Scala 2.13 and you can -already commit those changes. +lazy val sharedScalacOptions = + Seq("-encoding", "UTF-8", "-Wunused:imports,privates,locals") -**Usage:** `migrate-syntax projectId` where projectId is the name of the module chosen to be migrated. +lazy val scala2Options = sharedScalacOptions ++ + Seq("-target:jvm-1.8", "-Xsource:3", "-explaintypes") -The list of scalafix rules applied are: -- ProcedureSyntax -- fix.scala213.ConstructorProcedureSyntax -- fix.scala213.ExplicitNullaryEtaExpansion -- fix.scala213.ParensAroundLambda -- fix.scala213.ExplicitNonNullaryApply -- fix.scala213.Any2StringAdd +lazy val scala3Options = sharedScalacOptions ++ + Seq("-Xunchecked-java-output-version:8", "-explain") +``` -For more information on the fixed incompatibilities, please refer to -[the Incompatibility Table](incompat-syntactic.html). +Reload sbt, check that the project compiles (to Scala 2.13), check that the tests run successfully, and commit your changes. +You are now ready to migrate the syntax. -> There are more incompatibilities listed in the migration guide. -> Most of them are not frequent and can easily be fixed by hand. -> If you want to contribute by developing automatic rewrite with scalafix, -> we will be happy to add your rule in the migrate-syntax command. +## 5. Migrate the syntax -This is the output of `migrate-syntax`. -``` -> migrate-syntax main -[info] We are going to fix some syntax incompatibilities -[info] -[info] Successfully run fixSyntaxForScala3 in 8839 milliseconds -[info] -[info] The syntax incompatibilities have been fixed on the project main -[info] You can now commit the change! -[info] You can also execute the next command to try to migrate to 3.1.0 -[info] -[info] migrate main -[info] -[success] Total time: 2 s, completed 9 Apr 2021, 11:12:05 -``` +**Usage:** `migrateSyntax <project>` -## Fix other Scala 3 incompatibilities -> First reload the build to take into account the modifications -> in scalacOptions and libraryDependencies. +This command runs a number of Scalafix rules to patch some discarded syntax. -**Usage:** `migrate projectId`: tries compiling your code in Scala 3 by adding the minimum required inferred types and implicit values. +The list of applied Scalafix rules are: +- [ProcedureSyntax](https://scalacenter.github.io/scalafix/docs/rules/ProcedureSyntax.html) +- [fix.scala213.ConstructorProcedureSyntax](https://github.com/ohze/scala-rewrites/tree/dotty/#fixscala213constructorproceduresyntax) +- [fix.scala213.ExplicitNullaryEtaExpansion](https://github.com/lightbend-labs/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/ExplicitNullaryEtaExpansion.scala) +- [fix.scala213.ParensAroundLambda](https://github.com/ohze/scala-rewrites/tree/dotty/#fixscala213parensaroundlambda) +- [fix.scala213.ExplicitNonNullaryApply](https://github.com/lightbend-labs/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/ExplicitNullaryEtaExpansion.scala) +- [fix.scala213.Any2StringAdd](https://github.com/lightbend-labs/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/Any2StringAdd.scala) -Scala 3 uses a new type inference algorithm, therefore the Scala 3 compiler -can infer a different type than the one inferred by the Scala 2.13. -The goal of this command is to find the minimal set of type ascriptions to add to make your code compile with Scala 3. +For more information about the syntax changes between Scala 2.13 and Scala 3, you can refer to [the Incompatibility Table](incompatibility-table.html). -If the libraries have not been ported correctly, running `migrate projectId` will -fail reporting the problematic libraries. +> Some incompatibilities listed in [the Incompatibility Table](incompatibility-table.html) are not fixed by migrateSyntax. +> Most of them are not frequent and can easily be fixed by hand. +> If you want to contribute with a Scalafix rewrite rule, we will be more than happy to add it in the `migrateSyntax` command. + +Running `migrateSyntax main` outputs: +<pre> +<code class="hljs hljs-skip"> +sbt:main> migrateSyntax main +[info] Starting migration of syntax in main +[info] Run syntactic rules in 7 Scala sources successfully +[info] Applied 3 patches in src/main/scala/example/SyntaxRewrites.scala +[info] Run syntactic rules in 8 Scala sources successfully +[info] Applied 1 patch in src/test/scala/example/SyntaxRewritesTests.scala +[info] Migration of syntax in main succeeded. +[success] Total time: 2 s, completed Aug 31, 2023 11:23:51 AM +</code> +</pre> + +Take a look at the applied changes, check that the project still compiles, check that the tests run successfully and commit the changes. +The next and final step is to migrate the types. + +## 6. Migrate the types + +**Usage:** `migrateTypes <project>` + +The Scala 3 compiler uses a slightly different type inference algorithm. +It can sometimes fail at infering the same types as the Scala 2 compiler, which can lead to compilation errors. +This final step will add the needed type ascriptions to make the code compile to Scala 3. + +Running `migrateTypes main` outputs: +<pre> +<code class="hljs hljs-skip"> +sbt:main> migrateTypes main +[info] compiling 8 Scala sources to /home/piquerez/github/scalacenter/scala3-migration-example/target/scala-2.13/classes ... +[warn] 1 deprecation; re-run with -deprecation for details +[warn] one warning found +[info] compiling 8 Scala sources to /home/piquerez/github/scalacenter/scala3-migration-example/target/scala-2.13/test-classes ... +[warn] 2 deprecations; re-run with -deprecation for details +[warn] one warning found +[success] Total time: 7 s, completed Aug 31, 2023 11:26:25 AM +[info] Defining scalaVersion +[info] The new value will be used by Compile / bspBuildTarget, Compile / dependencyTreeCrossProjectId and 68 others. +[info] Run `last` for details. +[info] Reapplying settings... +[info] set current project to main (in build file:/home/piquerez/github/scalacenter/scala3-migration-example/) +[info] +[info] Migrating types in main / Compile +[info] +[info] Found 3 patches in 1 Scala source +[info] Starting migration of src/main/scala/example/TypeIncompat.scala +[info] 3 remaining candidates +[info] 1 remaining candidate +[info] Found 1 required patch in src/main/scala/example/TypeIncompat.scala +[info] Compiling to Scala 3 with -source:3.0-migration -rewrite +[info] compiling 1 Scala source to /home/piquerez/github/scalacenter/scala3-migration-example/target/scala-3.3.1/classes ... +[info] +[info] Migrating types in main / Test +[info] +[info] Found 4 patches in 1 Scala source +[info] Starting migration of src/test/scala/example/TypeIncompatTests.scala.scala +[info] 4 remaining candidates +[info] 3 remaining candidates +[info] 2 remaining candidates +[info] Found 1 required patch in src/test/scala/example/TypeIncompatTests.scala.scala +[info] Compiling to Scala 3 with -source:3.0-migration -rewrite +[info] +[info] You can safely upgrade main to Scala 3: +[info] <span style="color:orange">scalaVersion := "3.3.1"</span> +[success] Total time: 18 s, completed Aug 31, 2023 11:26:45 AM +[info] Defining scalaVersion +[info] The new value will be used by Compile / bspBuildTarget, Compile / dependencyTreeCrossProjectId and 68 others. +[info] Run `last` for details. +[info] Reapplying settings... +[info] set current project to main (in build file:/home/piquerez/github/scalacenter/scala3-migration-example/) +sbt:main> +</code> +</pre> + +`migrateTypes main` found 2 required patches: one in `src/test/scala/example/TypeIncompatTests.scala.scala` and the other in `src/main/scala/example/TypeIncompat.scala`. +It applied them, then it compiled to Scala 3 with `-source:3.0-migration -rewrite` to finalize the migration. + +Congratulations! Your project can now compile to Scala 3. -The command will display the following output: -``` -> migrate main -[info] We are going to migrate main / [Compile, Test] to 3.1.0 -2022.01.06 21:56:39 [INFO] migrate:24 - Found 1 required patch(es) in Incompat4.scala after 823 milliseconds ms -2022.01.06 21:56:39 [INFO] compileWithRewrite:114 - Finalizing the migration: compiling in Scala 3 with -rewrite option -[info] -[info] main / Compile has been successfully migrated to Scala 3.1.0 -[info] -[info] You can now commit the change! -[info] Then you can permanently change the scalaVersion of main: -[info] -[info] crossScalaVersions += "3.1.0" // or -[info] scalaVersion := "3.1.0" -``` +## What to do next ? -In this example, a file has been modified by adding some implicit parameters, -implicit conversions or explicit result types. +If you project contains only one module, you can set `scalaVersion := 3.3.1`. -## What to do next ? -If you project contains only one module, you're done. Depending on the nature of your project, -you will either change permanently the `scalaVersion` of your project, or add Scala 3 to `crossScalaVerions`. +If you have more than one module, you can start again from [3. Migrate the dependencies](#3-migrate-the-dependencies) with another module. -If you have more than one module, you can start again with a second module `MODULE2`. -if `MODULE2` depends on the last module migrated which is now compiling in Scala 3, you can either keep this module in Scala 3 and add `-Ytasty-reader` to `MODULE2 scalacOptions`, -or `reload` the project to keep the migrated module on Scala 2 during the entire migration -which implies cross-compiling during the process of the migration. +Once you are done with all modules, you can remove `sbt-scala3-migrate` from `project/plugins.abt`, and all Scala 2.13 related settings. -Once you are done, you can remove scala3-migrate from your plugins. +## Feedback and contributions are welcome -## Contributions and feedback are welcome -The tool is still under development, and we would love to hear from you. -Every feedback will help us build a better tool: typos, clearer log messages, better documentation, -bug reports, ideas of features, so please open a [GitHub issue](https://github.com/scalacenter/scala3-migrate) -or contact us on [discord](https://discord.com/invite/scala). +Every feedback will help us improve `sbt-scala3-migrate`: typos, clearer log messages, better documentation, +bug reports, ideas of features. +Don't hesitate to open a [GitHub issue](https://github.com/scalacenter/scala3-migrate). diff --git a/_overviews/scala3-migration/tooling-migration-mode.md b/_overviews/scala3-migration/tooling-migration-mode.md index 96bd3597a9..183edeee7e 100644 --- a/_overviews/scala3-migration/tooling-migration-mode.md +++ b/_overviews/scala3-migration/tooling-migration-mode.md @@ -2,8 +2,8 @@ title: Scala 3 Migration Mode type: chapter description: This section describes the migration mode of the Scala 3 compiler -num: 8 -previous-page: scala3-migrate +num: 7 +previous-page: tooling-tour next-page: tutorial-intro --- @@ -22,7 +22,6 @@ where possible standard options include: ... -explain Explain errors in more detail. --explain-types Explain type errors in more detail. ... -rewrite When used in conjunction with a `...-migration` source version, rewrites sources to migrate to new version. ... @@ -45,7 +44,7 @@ Once your code compiles in the migration mode, almost all warnings can be resolv To do so you just need to compile again, this time with the `-source:3.0-migration` and the `-rewrite` options. > Beware that the compiler will modify the code! It is intended to be safe. -> However you may like to commit the initial state so that you can print the diff applied by the compiler and revert it if necessary. +> However you may want to commit the initial state so that you can print the diff applied by the compiler and revert it if necessary. > #### Good to know > - The rewrites are not applied if the code compiles in error. diff --git a/_overviews/scala3-migration/tooling-tour.md b/_overviews/scala3-migration/tooling-tour.md index dda576b594..eb8ec0a439 100644 --- a/_overviews/scala3-migration/tooling-tour.md +++ b/_overviews/scala3-migration/tooling-tour.md @@ -4,7 +4,7 @@ type: chapter description: This chapter is a tour of the migration tooling ecosystem num: 6 previous-page: compatibility-metaprogramming -next-page: scala3-migrate +next-page: tooling-migration-mode --- ## The Scala Compilers @@ -42,9 +42,9 @@ Once your code is compiled in Scala 3 you can convert it to the new and optional > The `sbt-dotty` plugin was needed in sbt 1.4 to get support for Scala 3. > It is not useful anymore since sbt 1.5. -sbt 1.5 supports Scala 3 out-of-the-box. +sbt supports Scala 3 out-of-the-box. All common tasks and settings are intended to work the same. -Many plugins should also work exactly the same. +Many sbt plugins should also work exactly the same. To help with the migration, sbt 1.5 introduces new Scala 3 specific cross versions: @@ -62,27 +62,24 @@ libraryDependency += ("org.bar" %% "bar" % "1.0.0").cross(CrossVersion.for2_13Us ### Maven -Scala 3 support for Maven will soon land in the [scala-maven-plugin](https://github.com/davidB/scala-maven-plugin). +The Scala Maven plugin supports Scala 3 since 4.5.1. ## Code editors and IDEs ### Metals -[Metals](https://scalameta.org/metals/) is a Scala language server that works with VS Code, Vim, Emacs, Sublime Text, and other editors. - -Scala 3 is already very well supported by Metals. -Some minor adjustments for the new syntax changes and new features are coming. +[Metals](https://scalameta.org/metals/) is the Scala extension for VS Code. +It also works with Vim, Emacs, Sublime Text, and other editors. ### IntelliJ IDEA -The Scala plugin for IntelliJ includes preliminary support for Scala 3. -Full-fledged support is being worked on by the team at JetBrains. +The [Scala plugin for IntelliJ](https://plugins.jetbrains.com/plugin/1347-scala) supports Scala 3. ## Formatting Tools ### Scalafmt -[Scalafmt](https://scalameta.org/scalafmt/) v3.0.0-RC3 supports both Scala 2.13 and Scala 3. +[Scalafmt](https://scalameta.org/scalafmt/) supports Scala 2.13 and Scala 3 since v3.0.0. To enable Scala 3 formatting you must set the `runner.dialect = scala3` in your `.scalafmt.conf` file. @@ -97,13 +94,13 @@ fileOverride { } ``` +Scalafmt can also enforce the new Scala 3 syntax with the [Scala 3 rewrites](https://scalameta.org/scalafmt/docs/configuration.html#scala3-rewrites). + ## Migration Tools ### Scalafix [Scalafix](https://scalacenter.github.io/scalafix/) is a refactoring tool for Scala. -At the time of writing, it only runs on Scala 2.13. -But it can be useful to prepare the code before jumping to Scala 3. The [Incompatibility Table](incompatibility-table.html) shows which incompatibility can be fixed by an existing Scalafix rule. So far the relevant rules are: @@ -117,21 +114,17 @@ So far the relevant rules are: You can apply these rules in sbt using the `sbt-scalafix` plugin. They are also used internally in `sbt-scala3-migrate` described below. -### The Scala 3 Migrate Plugin +### The Scala 3 Migration Plugin for sbt [Scala 3 Migrate](https://github.com/scalacenter/scala3-migrate) is an sbt plugin that can assist you during the migration to Scala 3. -It proposes an incremental approach that can be described as follows: -- Migrate the library dependencies: - For every library dependency it checks, if there are available versions for Scala 3. -- Migrate the Scala compiler options (`scalacOptions`): - Some Scala 2 compiler options have been removed or renamed, others remain the same. - This step helps you adapt the compiler options of your project. -- Migrate the syntax: - This step relies on Scalafix and existing rules to fix the deprecated syntax. -- Migrate the code by expliciting the types: - Scala 3 has a new type inference algorithm that may infer slightly different types than the Scala 2 inference. - This last step explicits a minimum set of types so that the project can be compiled with Scala 3 without altering its runtime behavior. +It proposes an incremental approach, based on four sbt commands: +- `migrateDependencies` helps you update the list of `libraryDependencies` +- `migrateScalacOptions` helps you update the list of `scalacOptions` +- `migrateSyntax` fixes a number of syntax incompatibilities between Scala 2.13 and Scala 3 +- `migrateTypes` tries to code compile your code to Scala 3 by infering types and resolving implicits where needed. + +The detailed instructions on how to use Scala 3 Migrate can be found [here](scala3-migrate.html). ## Scaladex diff --git a/_overviews/scala3-migration/tutorial-intro.md b/_overviews/scala3-migration/tutorial-intro.md index 90f75161c4..4f207f5b92 100644 --- a/_overviews/scala3-migration/tutorial-intro.md +++ b/_overviews/scala3-migration/tutorial-intro.md @@ -2,7 +2,7 @@ title: Migration Tutorial type: chapter description: This chapter contains the tutorials for porting a Scala 2.13 project to Scala 3 -num: 9 +num: 8 previous-page: tooling-migration-mode next-page: tutorial-prerequisites --- @@ -10,11 +10,12 @@ next-page: tutorial-prerequisites You are ready to port your project to Scala 3! The first step is to check that the [Prerequisites](tutorial-prerequisites.html) are met by your project. -Then you can go to the [Porting a sbt Project](tutorial-sbt.html) tutorial to learn about the migration workflow. + +If you use sbt we recommend you to go to [Porting an sbt Project (using sbt-scala3-migrate)](scala3-migrate.html), or you can go to [Porting an sbt Project (by hand)](tutorial-sbt.html). > **You are not using sbt?** > -> We still advise you to read the [Porting a sbt Project](tutorial-sbt.html) tutorial since the workflow should be very similar. +> We still advise you to read the [Porting a sbt Project (by hand)](tutorial-sbt.html) tutorial since the workflow is the same in other build tools. > Prior to that, make sure the version of your build tool is up-to-date to support Scala 3. diff --git a/_overviews/scala3-migration/tutorial-macro-cross-building.md b/_overviews/scala3-migration/tutorial-macro-cross-building.md index 6a27f616b1..f9eec72757 100644 --- a/_overviews/scala3-migration/tutorial-macro-cross-building.md +++ b/_overviews/scala3-migration/tutorial-macro-cross-building.md @@ -24,7 +24,7 @@ In order to exemplify this tutorial, we will consider the minimal macro library lazy val example = project .in(file("example")) .settings( - scalaVersion := "2.13.6", + scalaVersion := "2.13.11", libraryDependencies ++= Seq( "org.scala-lang" % "scala-reflect" % scalaVersion.value ) @@ -73,7 +73,7 @@ The main idea is to build the artifact twice and to publish two releases: You can add Scala 3 to the list of `crossScalaVersions` of your project: ```scala -crossScalaVersions := Seq("2.13.6", "3.0.0") +crossScalaVersions := Seq("2.13.11", "3.3.1") ``` The `scala-reflect` dependency won't be useful in Scala 3. @@ -91,15 +91,15 @@ libraryDependencies ++= { } ``` -After reloading sbt, you can switch to the Scala 3 context by running `++3.0.0`. -At any point you can go back to the Scala 2.13 context by running `++2.13.6`. +After reloading sbt, you can switch to the Scala 3 context by running `++3.3.1`. +At any point you can go back to the Scala 2.13 context by running `++2.13.11`. ## 2. Rearrange the code in version-specific source directories If you try to compile with Scala 3 you should see some errors of the same kind as: {% highlight text %} -sbt:example> ++3.0.0 +sbt:example> ++3.3.1 sbt:example> example / compile [error] -- Error: /example/src/main/scala/location/Location.scala:15:35 [error] 15 | val location = typeOf[Location] @@ -222,13 +222,13 @@ class MacrosSpec extends munit.FunSuite { You should now be able to run the tests in both versions. {% highlight text %} -sbt:example> ++2.13.6 +sbt:example> ++2.13.11 sbt:example> example / test location.MacrosSpec: + location [info] Passed: Total 1, Failed 0, Errors 0, Passed 1 [success] -sbt:example> ++3.0.0 +sbt:example> ++3.3.1 sbt:example> example / test location.MacrosSpec: + location diff --git a/_overviews/scala3-migration/tutorial-macro-mixing.md b/_overviews/scala3-migration/tutorial-macro-mixing.md index 10be2418a6..e7684adc7b 100644 --- a/_overviews/scala3-migration/tutorial-macro-mixing.md +++ b/_overviews/scala3-migration/tutorial-macro-mixing.md @@ -100,13 +100,13 @@ However, in many cases you will have to move the Scala 2.13 macro implementation lazy val example = project.in(file("example")) .settings( - scalaVersion := "3.0.0" + scalaVersion := "3.3.1" ) .dependsOn(`example-compat`) lazy val `example-compat` = project.in(file("example-compat")) .settings( - scalaVersion := "2.13.6", + scalaVersion := "2.13.11", libraryDependency += "org.scala-lang" % "scala-reflect" % scalaVersion.value ) ``` @@ -150,8 +150,8 @@ Since we want to execute the tests in Scala 2.13 and Scala 3, we create a cross- // build.sbt lazy val `example-test` = project.in(file("example-test")) .settings( - scalaVersion := "3.0.0", - crossScalaVersions := Seq("3.0.0", "2.13.6"), + scalaVersion := "3.3.1", + crossScalaVersions := Seq("3.3.1", "2.13.11"), scalacOptions ++= { CrossVersion.partialVersion(scalaVersion.value) match { case Some((2, 13)) => Seq("-Ytasty-reader") @@ -185,13 +185,13 @@ class MacrosSpec extends munit.FunSuite { You should now be able to run the tests in both versions. {% highlight text %} -sbt:example> ++2.13.6 +sbt:example> ++2.13.11 sbt:example> example-test / test location.MacrosSpec: + location [info] Passed: Total 1, Failed 0, Errors 0, Passed 1 [success] -sbt:example> ++3.0.0 +sbt:example> ++3.3.1 sbt:example> example-test / test location.MacrosSpec: + location @@ -213,7 +213,7 @@ You are now ready to publish your library. It can be used in Scala 3 projects, or in Scala 2.13 projects with these settings: ```scala -scalaVersion := "2.13.6" +scalaVersion := "2.13.11" libraryDependencies += ("org" %% "example" % "x.y.z").cross(CrossVersion.for2_13Use3) scalacOptions += "-Ytasty-reader" ``` diff --git a/_overviews/scala3-migration/tutorial-prerequisites.md b/_overviews/scala3-migration/tutorial-prerequisites.md index 1fcbb14d4c..cdd96da785 100644 --- a/_overviews/scala3-migration/tutorial-prerequisites.md +++ b/_overviews/scala3-migration/tutorial-prerequisites.md @@ -2,9 +2,9 @@ title: Prerequisites type: section description: This section details the prerequisites of migration to Scala 3 -num: 10 +num: 9 previous-page: tutorial-intro -next-page: tutorial-sbt +next-page: scala3-migrate --- The migration to Scala 3 is made easier thanks to the interoperability between Scala 2.13 and Scala 3, as described in the [Compatibility Reference](compatibility-intro.html) page. diff --git a/_overviews/scala3-migration/tutorial-sbt.md b/_overviews/scala3-migration/tutorial-sbt.md index c09f6e5e8d..78cd056d06 100644 --- a/_overviews/scala3-migration/tutorial-sbt.md +++ b/_overviews/scala3-migration/tutorial-sbt.md @@ -1,9 +1,9 @@ --- -title: Porting an sbt Project +title: Porting an sbt Project (by hand) type: section description: This section shows how to port an sbt project num: 11 -previous-page: tutorial-prerequisites +previous-page: scala3-migrate next-page: tutorial-macro-cross-building --- @@ -43,16 +43,16 @@ This is crucial to avoid bugs that could happen when fixing the incompatibilitie Configuring cross-building in sbt is as short as: ```scala -scalaVersion := "3.0.0" -crossScalaVersions ++= Seq("2.13.6", "3.0.0") +scalaVersion := "3.3.1" +crossScalaVersions ++= Seq("2.13.11", "3.3.1") ``` This configuration means: -- The default version is `3.0.0`. -- 2.13.6 can be loaded by running the `++2.13.6` command. -- 3.0.0 can be loaded by running the `++3.0.0` command. +- The default version is `3.3.1`. +- 2.13.11 can be loaded by running the `++2.13.11` command. +- 3.3.1 can be loaded by running the `++3.3.1` command. -Beware that the `reload` command will always load the default version---here it is 3.0.0. +Beware that the `reload` command will always load the default version---here it is 3.3.1. ## 4. Prepare the dependencies @@ -89,8 +89,8 @@ Or for a Scala.js dependencies: Once you have fixed all the unresolved dependencies, you can check that the tests are still passing in Scala 2.13: {% highlight text %} -sbt:example> ++2.13.6 -[info] Setting Scala version to 2.13.6 on 1 project. +sbt:example> ++2.13.11 +[info] Setting Scala version to 2.13.11 on 1 project. ... sbt:example> example / test ... @@ -138,8 +138,8 @@ Also you should disable `-Xfatal-warnings` to take full advantage of the migrati It is now time to try compiling in Scala 3: {% highlight text %} -sbt:example> ++3.0.0 -[info] Setting Scala version to 3.0.0 on 1 project. +sbt:example> ++3.3.1 +[info] Setting Scala version to 3.3.1 on 1 project. ... sbt:example> example / compile ... @@ -171,8 +171,8 @@ This is particularly crucial if your project is a published library. After fixing an incompatibility, you can validate the solution by running the tests in Scala 2.13. {% highlight text %} -sbt:example> ++2.13.6 -[info] Setting Scala version to 2.13.6 on 1 project. +sbt:example> ++2.13.11 +[info] Setting Scala version to 2.13.11 on 1 project. ... sbt:example> example / test ... @@ -186,7 +186,7 @@ Only the migration warnings are remaining. You can patch them automatically by compiling with the `-source:3.0-migration -rewrite` options. {% highlight text %} -sbt:example> ++3.0.0 +sbt:example> ++3.3.1 sbt:example> set example / scalacOptions += "-rewrite" sbt:example> example / compile ... @@ -206,11 +206,11 @@ Good tests are the only guarantee to prevent such bugs from going unnoticed. Make sure that the tests are passing in both Scala 2.13 and Scala 3. {% highlight text %} -sbt:example> ++2.13.6 +sbt:example> ++2.13.11 sbt:example> example / test ... [success] -sbt:example> ++3.0.0 +sbt:example> ++3.3.1 sbt:example> example / test ... [success] diff --git a/resources/js/functions.js b/resources/js/functions.js index efd41d00d5..322652b95a 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -65,7 +65,8 @@ $(document).ready(function() { // Highlight $(document).ready(function() { hljs.configure({ - languages: ["scala", "bash"] + languages: ["scala", "bash"], + noHighlightRe: /^hljs-skip$/i }) hljs.registerLanguage("scala", highlightDotty); hljs.highlightAll(); From 08cf5bc6bfbb8ec3d6006bce3769c0057f2c8106 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Mon, 11 Sep 2023 12:43:29 +0200 Subject: [PATCH 2703/3075] 2.13.12 followup --- _overviews/FAQ/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index c02e279807..0d6cb2eea7 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -316,14 +316,14 @@ setting in a multi-project build. For example, if you add this to your `build.sbt`: - scalaVersion := "2.13.11" + scalaVersion := "2.13.12" that's a "bare" setting, and you might expect it to apply build-wide. But it doesn't. _It only applies to the root project._ In many cases one should instead write: - ThisBuild / scalaVersion := "2.13.11" + ThisBuild / scalaVersion := "2.13.12" Other possibilities include: From 86c9d2f1b8a428995cbb77c5d942c9bd857f1366 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Fri, 15 Sep 2023 00:20:09 +0000 Subject: [PATCH 2704/3075] Update SIPs state --- _sips/sips/precise-type-modifier.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_sips/sips/precise-type-modifier.md b/_sips/sips/precise-type-modifier.md index b3561d1dae..9c316bbd8c 100644 --- a/_sips/sips/precise-type-modifier.md +++ b/_sips/sips/precise-type-modifier.md @@ -1,7 +1,6 @@ --- title: SIP-48 - Precise Type Modifier -status: under-review +status: withdrawn pull-request-number: 48 -stage: design --- From 7225c5ff2336b4a3a85788fdc017b640e926e860 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 15 Sep 2023 21:44:30 +0800 Subject: [PATCH 2705/3075] Update _zh-cn/overviews/scala3-book/ca-context-bounds.md Co-authored-by: Dongxu Wang <dongxu@apache.org> --- _zh-cn/overviews/scala3-book/ca-context-bounds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index d39a367ca0..d2725a637c 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -14,7 +14,7 @@ permalink: "/zh-cn/scala3/book/:title.html" --- -在许多情况下，[上下文参数]({% link _overviews/scala3-book/ca-context-parameters.md %}#context-parameters) 的名称不必明确提及，因为它仅由编译器在其他上下文参数的合成参数中使用。 +在许多情况下，[上下文参数]({% link _overviews/scala3-book/ca-context-parameters.md %}#context-parameters) 的名称不必显式提及，因为它仅在编译器为其他上下文参数合成实参的时候用到。 在这种情况下，您不必定义参数名称，只需提供参数类型即可。 ## 背景 From 72eccab0c9a3f3179e605c801f103e3551b2e51e Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 15 Sep 2023 21:46:53 +0800 Subject: [PATCH 2706/3075] Update _zh-cn/overviews/scala3-book/ca-context-bounds.md Co-authored-by: Dongxu Wang <dongxu@apache.org> --- _zh-cn/overviews/scala3-book/ca-context-bounds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index d2725a637c..97ff401a6c 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -36,7 +36,7 @@ def maxElement[A](as: List[A])(using ord: Ord[A]): A = {% endtab %} {% endtabs %} -`maxElement` 方法把一个 `Ord[A]` 类的 _上下文参数_ 当作参数只传给 `max` 方法。 +上面这个 `maxElement` 方法只接受一个类型为 `Ord[A]` 的 _上下文参数_ 并将其作为实参传给 `max` 方法。 为了完整起见，以下是 `max` 和 `Ord` 的定义（请注意，在实践中我们会在 `List` 上使用现有的方法 `max`， 但我们为了说明目的而编造了这个例子）： From f99e9e0793d0bc27b110c2cee6045f46a68b9fb8 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 15 Sep 2023 21:47:17 +0800 Subject: [PATCH 2707/3075] Update _zh-cn/overviews/scala3-book/ca-context-bounds.md Co-authored-by: Dongxu Wang <dongxu@apache.org> --- _zh-cn/overviews/scala3-book/ca-context-bounds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index 97ff401a6c..9f5e2e73c9 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -38,7 +38,7 @@ def maxElement[A](as: List[A])(using ord: Ord[A]): A = 上面这个 `maxElement` 方法只接受一个类型为 `Ord[A]` 的 _上下文参数_ 并将其作为实参传给 `max` 方法。 -为了完整起见，以下是 `max` 和 `Ord` 的定义（请注意，在实践中我们会在 `List` 上使用现有的方法 `max`， +完整起见，以下是 `max` 和 `Ord` 的定义（注意，在实践中我们会使用 `List` 中已有的 `max` 方法 ， 但我们为了说明目的而编造了这个例子）： {% tabs context-bounds-max-ord class=tabs-scala-version %} From 2cfb6fd4c06b6f780739a84872d9230826a45668 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 15 Sep 2023 21:47:26 +0800 Subject: [PATCH 2708/3075] Update _zh-cn/overviews/scala3-book/ca-context-bounds.md Co-authored-by: Dongxu Wang <dongxu@apache.org> --- _zh-cn/overviews/scala3-book/ca-context-bounds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index 9f5e2e73c9..0478a83036 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -68,7 +68,7 @@ def max[A](a1: A, a2: A)(using ord: Ord[A]): A = {% endtab %} {% endtabs %} -`max` 方法用了类 `Ord[A]` 的上下文参数, 就像 `maxElement` 方法。 +`max` 方法用了类型为 `Ord[A]` 的上下文参数, 就像 `maxElement` 方法一样。 ## 省略上下文参数 From b76d864dbb6eb46d5ae5c2e266df31be651c777f Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 15 Sep 2023 21:47:37 +0800 Subject: [PATCH 2709/3075] Update _zh-cn/overviews/scala3-book/ca-context-bounds.md Co-authored-by: Dongxu Wang <dongxu@apache.org> --- _zh-cn/overviews/scala3-book/ca-context-bounds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index 0478a83036..9e12eb219b 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -97,7 +97,7 @@ def maxElement[A](as: List[A])(using Ord[A]): A = 鉴于此背景，_上下文绑定_ 是一种简写语法，用于表达“依赖于类型参数的上下文参数”模式。 -使用上下文绑定，`maximum` 方法可以这样写： +使用上下文绑定，`maxElement` 方法可以这样写： {% tabs context-bounds-max-rewritten %} {% tab 'Scala 2 and 3' %} From 2aa27768604396d184799ecd5e56f59107160206 Mon Sep 17 00:00:00 2001 From: William Takeshi <williamtpereira@gmail.com> Date: Sat, 16 Sep 2023 23:52:07 -0300 Subject: [PATCH 2710/3075] fix typo --- _ru/tour/pattern-matching.md | 2 +- _tour/pattern-matching.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_ru/tour/pattern-matching.md b/_ru/tour/pattern-matching.md index 91c6cf0867..2d990cfb9b 100644 --- a/_ru/tour/pattern-matching.md +++ b/_ru/tour/pattern-matching.md @@ -317,7 +317,7 @@ It would fail on pattern case: VoiceRecording(_, _) С другой стороны, проверка полноты требует, чтобы вы определили все подтипы базового типа в том же файле, что и базовый тип (иначе бы компилятор не знал все возможные варианты). Например, если вы попытаетесь определить новый тип `Notification` вне файла, -который определяет `sealed trait Notfication`, это приведет к ошибке компиляции: +который определяет `sealed trait Notification`, это приведет к ошибке компиляции: ``` case class Telepathy(message: String) extends Notification diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index aa870d133e..1038e6be13 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -285,7 +285,7 @@ On the flip side, exhaustivity checking requires you to define all the subtypes of the base type in the same file as the base type (otherwise, the compiler would not know what are all the possible cases). For instance, if you try to define a new type of `Notification` outside of the file that defines -the `sealed trait Notfication`, it will produce a compilation error: +the `sealed trait Notification`, it will produce a compilation error: ~~~ case class Telepathy(message: String) extends Notification From 41a18feff42a9aa27bb28e538182c839c9ec3c33 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Tue, 19 Sep 2023 17:33:51 +0300 Subject: [PATCH 2711/3075] Tour packages actualization in ru (#2886) --- _ru/tour/package-objects.md | 119 ++++++++++++++++++++++++++++--- _ru/tour/packages-and-imports.md | 101 ++++++++++++++++++++++++-- _ru/tour/pattern-matching.md | 2 +- 3 files changed, 208 insertions(+), 14 deletions(-) diff --git a/_ru/tour/package-objects.md b/_ru/tour/package-objects.md index e7924e8de8..89c392ea46 100644 --- a/_ru/tour/package-objects.md +++ b/_ru/tour/package-objects.md @@ -7,18 +7,47 @@ language: ru previous-page: packages-and-imports --- -# Объекты Пакета +Часто бывает удобно иметь определения, доступные для всего пакета, +когда не нужно придумывать имя для оболочки `object`, которая их содержит. -У каждого пакета может существовать связанный с этим пакетом объект (package object), общий для всех членов пакета. Такой объект может быть только один. Любые выражения, содержащиеся в объекте пакета, считаются членами самого пакета. +{% tabs pkg-obj-vs-top-lvl_1 class=tabs-scala-version %} +{% tab 'Scala 2' for=pkg-obj-vs-top-lvl_1 %} -Объекты пакета могут содержать произвольные виды выражений, а не только переменные и методы. Например, они часто используются для хранения псевдонимов типа и наборов неявных преобразований доступных всему пакету. Объекты пакета могут также наследоваться от классов и трейтов Scala. +Scala 2 предоставляет _объекты пакета_ (_package objects_) в виде удобного контейнера, общего для всего пакета. + +Объекты пакета могут содержать произвольные виды выражений, а не только переменные и методы. +Например, они часто используются для хранения псевдонимов типа и наборов неявных преобразований доступных всему пакету. +Объекты пакета могут также наследоваться от классов и трейтов Scala. + +> В будущей версии Scala 3 объекты пакета будут удалены в пользу определений верхнего уровня. По соглашению, исходный код объекта пакета обычно помещается в файл под названием `package.scala`. +Каждому пакету разрешено иметь один объект пакета. +Любые выражения, содержащиеся в объекте пакета, считаются членами самого пакета. + +{% endtab %} +{% tab 'Scala 3' for=pkg-obj-vs-top-lvl_1 %} + +В Scala 3 любое определение может быть объявлено на верхнем уровне пакета. +Например, классы, перечисления, методы и переменные. + +Любые определения, размещенные на верхнем уровне пакета, считаются членами самого пакета. + +> В Scala 2 верхнеуровневый метод, определения типов и переменных должны были быть заключены в **объект пакета**. +> Их все еще можно использовать в Scala 3 для обратной совместимости. +> Вы можете увидеть, как они работают, переключая вкладки. + +{% endtab %} +{% endtabs %} + См. пример ниже. Предположим, есть старший класс `Fruit` и три наследуемых от него объекта `Fruit` в пакете. `gardening.fruits`: +{% tabs pkg-obj-vs-top-lvl_2 %} +{% tab 'Scala 2 и 3' for=pkg-obj-vs-top-lvl_2 %} + ``` // в файле gardening/fruits/Fruit.scala package gardening.fruits @@ -29,9 +58,15 @@ object Plum extends Fruit("Plum", "blue") object Banana extends Fruit("Banana", "yellow") ``` +{% endtab %} +{% endtabs %} + Теперь предположим, что мы хотим поместить переменную `planted` и метод `showFruit` непосредственно в пакет `gardening`. Вот как это делается: +{% tabs pkg-obj-vs-top-lvl_3 class=tabs-scala-version %} +{% tab 'Scala 2' for=pkg-obj-vs-top-lvl_3 %} + ``` // в файле gardening/fruits/package.scala package gardening @@ -43,11 +78,31 @@ package object fruits { } ``` -Для примера, следующий объект `PrintPlanted` импортирует `planted` и `showFruit` точно так же, как с вариантом импорта класса `Fruit`, используя групповой стиль импорта пакета gardening.fruits: +{% endtab %} +{% tab 'Scala 3' for=pkg-obj-vs-top-lvl_3 %} + +``` +// в файле gardening/fruits/package.scala +package gardening.fruits + +val planted = List(Apple, Plum, Banana) +def showFruit(fruit: Fruit): Unit = + println(s"${fruit.name}s are ${fruit.color}") +``` + +{% endtab %} +{% endtabs %} + +Для примера, следующий объект `PrintPlanted` импортирует `planted` и `showFruit` точно так же, как с вариантом импорта класса `Fruit`, +используя групповой стиль импорта пакета `gardening.fruits`: + +{% tabs pkg-obj-vs-top-lvl_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=pkg-obj-vs-top-lvl_4 %} ``` // в файле PrintPlanted.scala import gardening.fruits._ + object PrintPlanted { def main(args: Array[String]): Unit = { for (fruit <- planted) { @@ -57,10 +112,58 @@ object PrintPlanted { } ``` -Объекты пакета ведут себя также, как и любые другие объекты. Это означает, что вы можете использовать наследование, при этом сразу нескольких трейтов: +{% endtab %} +{% tab 'Scala 3' for=pkg-obj-vs-top-lvl_4 %} ``` -package object fruits extends FruitAliases with FruitHelpers { - // здесь располагаются вспомогательные классы и переменные -} +// в файле PrintPlanted.scala +import gardening.fruits.* + +@main def printPlanted(): Unit = + for fruit <- planted do + showFruit(fruit) +``` + +{% endtab %} +{% endtabs %} + +### Объединение нескольких определений на уровне пакета + +Часто в вашем проекте может быть несколько повторно используемых определений, +заданных в различных модулях, которые вы хотите агрегировать на верхнем уровне пакета. + +Например, некоторые вспомогательные методы в трейте `FruitHelpers` +и некоторые псевдонимы терминов/типов в свойстве `FruitAliases`. +Вот как вы можете разместить все их определения на уровне пакета `fruit`: + +{% tabs pkg-obj-vs-top-lvl_5 class=tabs-scala-version %} +{% tab 'Scala 2' for=pkg-obj-vs-top-lvl_5 %} + +Объекты пакета ведут себя также, как и любые другие объекты. +Это означает, что вы можете использовать наследование, при этом сразу нескольких трейтов: + +``` +package gardening + +// `fruits` наследует свои элементы от родителей. +package object fruits extends FruitAliases with FruitHelpers +``` + +{% endtab %} +{% tab 'Scala 3' for=pkg-obj-vs-top-lvl_5 %} + +В Scala 3 предпочтительно использовать `export` для объединения членов из нескольких объектов в единую область видимости. +Здесь мы определяем приватные объекты, которые смешиваются с вспомогательными трейтами, +а затем экспортируют их элементы на верхнем уровне: + ``` +package gardening.fruits + +private object FruitAliases extends FruitAliases +private object FruitHelpers extends FruitHelpers + +export FruitHelpers.*, FruitAliases.* +``` + +{% endtab %} +{% endtabs %} diff --git a/_ru/tour/packages-and-imports.md b/_ru/tour/packages-and-imports.md index a4d6710454..4624fa7238 100644 --- a/_ru/tour/packages-and-imports.md +++ b/_ru/tour/packages-and-imports.md @@ -8,18 +8,28 @@ previous-page: annotations next-page: package-objects --- -# Пакеты и Импорт +# Пакеты и Импорт + Scala использует пакеты для указания пространства имен, они позволяют создавать модульную структуру кода. ## Создание пакета + Пакеты создаются путем объявления одного или нескольких имен пакетов в верхней части файла Scala. +{% tabs packages-and-imports_1 %} +{% tab 'Scala 2 и 3' for=packages-and-imports_1 %} + ``` package users class User ``` + +{% endtab %} +{% endtabs %} + По соглашению пакеты называют тем же именем, что и каталог, содержащий файл Scala. Однако Scala не обращает внимания на расположение файлов. Структура каталогов sbt-проекта для `package users` может выглядеть следующим образом: + ``` - ExampleProject - build.sbt @@ -33,8 +43,15 @@ class User UserPreferences.scala - test ``` -Обратите внимание, что каталог `users` находится внутри каталога `scala` и как в пакете содержатся несколько файлов Scala. Каждый файл Scala в пакете может иметь одно и то же объявление пакета. Другой способ объявления пакетов - с помощью фигурных скобок: -``` + +Обратите внимание, что каталог `users` находится внутри каталога `scala` и как в пакете содержатся несколько файлов Scala. +Каждый файл Scala в пакете может иметь одно и то же объявление пакета. +Другой способ объявления пакетов - вложить их друг в друга:: + +{% tabs packages-and-imports_2 class=tabs-scala-version %} +{% tab 'Scala 2' for=packages-and-imports_2 %} + +```scala package users { package administrators { class NormalUser @@ -44,18 +61,47 @@ package users { } } ``` + +{% endtab %} +{% tab 'Scala 3' for=packages-and-imports_2 %} + +```scala +package users: + package administrators: + class NormalUser + + package normalusers: + class NormalUser +``` + +{% endtab %} +{% endtabs %} + Как видите, такой способ позволяет вкладывать пакеты друг в друга, а также обеспечивает отличный контроль за областью видимости и возможностью изоляции. Имя пакета должно быть все в нижнем регистре, и если код разрабатывается в организации имеющей сайт, то следует использовать имя следующего формата: `<домен-верхнего-уровня>.<доменное-имя>.<название-проекта>`. Например, если бы у Google был проект под названием `SelfDrivingCar`, название пакета выглядело бы следующим образом: -``` + +{% tabs packages-and-imports_3 %} +{% tab 'Scala 2 и 3' for=packages-and-imports_3 %} + +```scala package com.google.selfdrivingcar.camera class Lens ``` + +{% endtab %} +{% endtabs %} + Что может соответствовать следующей структуре каталога: `SelfDrivingCar/src/main/scala/com/google/selfdrivingcar/camera/Lens.scala`. ## Импорт + Указание `import` открывает доступ к членам (классам, трейтам, функциям и т.д.) в других пакетах. Указание `import` не требуется для доступа к членам одного и того же пакета. Указание `import` избирательны: + +{% tabs packages-and-imports_4 class=tabs-scala-version %} +{% tab 'Scala 2' for=packages-and-imports_4 %} + ``` import users._ // групповой импорт всего пакета users import users.User // импортировать только User @@ -63,20 +109,65 @@ import users.{User, UserPreferences} // импортировать только import users.{UserPreferences => UPrefs} // импортировать и переименовать ``` +{% endtab %} +{% tab 'Scala 3' for=packages-and-imports_4 %} + +``` +import users.* // групповой импорт всего пакета users, кроме given +import users.given // импорт всех given пакета users +import users.User // импортировать только User +import users.{User, UserPreferences} // импортировать только User, UserPreferences +import users.UserPreferences as UPrefs // импортировать и переименовать +``` + +{% endtab %} +{% endtabs %} + Одним из отличий Scala от Java является то, что импорт можно использовать где угодно: +{% tabs packages-and-imports_5 class=tabs-scala-version %} +{% tab 'Scala 2' for=packages-and-imports_5 %} + ```scala mdoc def sqrtplus1(x: Int) = { import scala.math.sqrt sqrt(x) + 1.0 } ``` -В случае возникновения конфликта имен и необходимости импортировать что-либо из корня проекта, имя пакета должно начинаться с префикса `_root_`: + +{% endtab %} +{% tab 'Scala 3' for=packages-and-imports_5 %} + +```scala +def sqrtplus1(x: Int) = + import scala.math.sqrt + sqrt(x) + 1.0 ``` + +{% endtab %} +{% endtabs %} + +В случае возникновения конфликта имен и необходимости импортировать что-либо из корня проекта, имя пакета должно начинаться с префикса `_root_`: + +{% tabs packages-and-imports_6 class=tabs-scala-version %} +{% tab 'Scala 2' for=packages-and-imports_6 %} + +```scala package accounts import _root_.users._ ``` +{% endtab %} +{% tab 'Scala 3' for=packages-and-imports_6 %} + +```scala +package accounts + +import _root_.users.* +``` + +{% endtab %} +{% endtabs %} Примечание: Пакеты `scala` и `java.lang`, а также `object Predef` импортируются по умолчанию. diff --git a/_ru/tour/pattern-matching.md b/_ru/tour/pattern-matching.md index 2d990cfb9b..da9ef90420 100644 --- a/_ru/tour/pattern-matching.md +++ b/_ru/tour/pattern-matching.md @@ -49,7 +49,7 @@ x match {% endtab %} {% endtabs %} -Значение константы `x` выше представляет собой случайное целое число от 0 до 10. `x` становится левым операндом оператора `match`, а справа - выражением с четырьмя примерами (называемые еще _вариантами_). Последний вариант `_` - позволяет "поймать все оставшиеся варианты" т. е. для любого числа больше 2. +Значение константы `x` выше представляет собой случайное целое число от 0 до 9. `x` становится левым операндом оператора `match`, а справа - выражением с четырьмя примерами (называемые еще _вариантами_). Последний вариант `_` - позволяет "поймать все оставшиеся варианты" т. е. для любого числа больше 2. Сопоставление с примером возвращает значение. From b41ee0e0404e7f6c7eaeca6a3e985251911c4041 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Tue, 19 Sep 2023 17:34:23 +0300 Subject: [PATCH 2712/3075] Update tour implicits in ru (#2887) --- _ru/tour/implicit-conversions.md | 60 +++++++--------- _ru/tour/implicit-parameters.md | 119 +++++++++++++++++++++---------- 2 files changed, 108 insertions(+), 71 deletions(-) diff --git a/_ru/tour/implicit-conversions.md b/_ru/tour/implicit-conversions.md index 069c9be697..0ac21bd31f 100644 --- a/_ru/tour/implicit-conversions.md +++ b/_ru/tour/implicit-conversions.md @@ -8,51 +8,45 @@ next-page: polymorphic-methods previous-page: implicit-parameters --- -Неявные преобразование типа `S` к типу `T` задается неявным значением функционального типа `S =>T`, или неявным методом, который способен преобразовывать к значению требуемого типа. +Неявные преобразования — это мощная функция Scala, применяемая в двух распространенных вариантах: -Неявное преобразование применяются в двух случаях: +- разрешить пользователям предоставлять аргумент одного типа так, как если бы это был другой тип, чтобы избежать шаблонного. +- в Scala 2 для предоставления дополнительных членов запечатанным классам (заменены [методами расширения][exts] в Scala 3). -* Если выражение `e` типа `S` не подходит под ожидаемый тип выражения `T`. -* Если мы выбирая член `e.m`, где `e` является представителем типа `S`, при этом выбранное имя `m` не найдено среди доступных селекторов принадлежащих типу `S`. - -В первом случае выполняется поиск приведения `c`, которое можно применить к `e` чтоб тип результата стал соответствовать ожидаемому `T`. -Во втором случае выполняется поиск преобразования `c`, которое применимо к `e` и результат которого бы содержал член с именем `m`. +### Детальный разбор -Если неявный метод `List[A] => Ordered[List[A]]` находится в области видимости, также как и неявный метод `Int => Ordered[Int]`, то следующая операция с двумя списками типа `List[Int]` является допустимой: +{% tabs implicit-conversion-defn class=tabs-scala-version %} +{% tab 'Scala 2' %} -``` -List(1, 2, 3) <= List(4, 5) -``` +В Scala 2 неявное преобразование из типа `S` в тип `T` определяется либо [неявным классом]({% link _overviews/core/implicit-classes.md %}) `T` +с одним параметром типа `S`, [неявным значением]({% link _tour/implicit-parameters.md %}), которое имеет тип функции `S => T`, +либо неявным методом, преобразуемым в значение этого типа. -Неявный метод `Int => Ordered[Int]` предоставляется автоматически через `scala.Predef.intWrapper`. Ниже приведен пример объявления неявного метода `List[A] => Ordered[List[A]]`. +{% endtab %} +{% tab 'Scala 3' %} -```scala mdoc -import scala.language.implicitConversions +В Scala 3 неявное преобразование из типа `S` в тип `T` определяется [экземпляром `given`]({% link _tour/implicit-parameters.md %}), который имеет тип `scala.Conversion[S, T]`. +Для совместимости со Scala 2 их также можно определить неявным методом (подробнее читайте во вкладке Scala 2). -implicit def list2ordered[A](x: List[A]) - (implicit elem2ordered: A => Ordered[A]): Ordered[List[A]] = - new Ordered[List[A]] { - //заменить на более полезную реализацию - def compare(that: List[A]): Int = 1 - } -``` +{% endtab %} +{% endtabs %} -Неявно импортируемый объект `scala.Predef` объявляет ряд псевдонимов для часто используемым типов (например, `scala.collection.immutable.Map` использует псевдоним `Map`) и методов (например, `assert`), а также делает доступным целую серию неявных преобразований. +Неявные преобразования применяются в двух случаях: -Например, при вызове Java метода, который ожидает `java.lang.Integer`, вместо него вы можете свободно использовать `scala.Int`. Потому что Predef включает в себя следующие неявные преобразования: +1. Если выражение `e` имеет тип `S` и `S` не соответствует ожидаемому типу выражения `T`. +2. При выборе `e.m`, где `e` типа `S`, если селектор `m` не указывает на элемент `S`. -```scala mdoc -import scala.language.implicitConversions +В первом случае ищется конверсия `c`, применимая к `e` и тип результата которой соответствует `T`. -implicit def int2Integer(x: Int): Integer = - Integer.valueOf(x) -``` +Примером является передача `scala.Int`, например `x`, методу, который ожидает `scala.Long`. +В этом случае вставляется неявное преобразование `Int.int2long(x)`. -Компилятор предупреждает при компиляции об обнаружении неявных преобразований, т.к. неявные преобразования могут иметь разные подводные камни (особенно если использовать их без разбора). +Во втором случае ищется преобразование `c`, применимое к `e` и результат которого содержит элемент с именем `m`. -Чтоб отключить предупреждения выполните одно из следующих действий: +Примером является сравнение двух строк `"foo" < "bar"`. +В этом случае `String` не имеет члена `<`, поэтому вставляется неявное преобразование `Predef.augmentString("foo") < "bar"` +(`scala.Predef` автоматически импортируется во все программы Scala). -* Импортируйте `scala.language.implicitConversions` в области видимости, где объявлены неявные преобразования. -* Вызывайте компилятор с ключом `-language:implicitConversions`. +Дополнительная литература: [Неявные преобразования (в книге Scala)]({% link _overviews/scala3-book/ca-implicit-conversions.md %}). -В таком случае при преобразовании компилятором не будет выдаваться никаких предупреждений. +[exts]: {% link _overviews/scala3-book/ca-extension-methods.md %} diff --git a/_ru/tour/implicit-parameters.md b/_ru/tour/implicit-parameters.md index a04382022e..14f11c299c 100644 --- a/_ru/tour/implicit-parameters.md +++ b/_ru/tour/implicit-parameters.md @@ -1,6 +1,6 @@ --- layout: tour -title: Неявные Параметры +title: Контекстные параметры, также известные, как неявные параметры partof: scala-tour num: 26 language: ru @@ -8,61 +8,104 @@ next-page: implicit-conversions previous-page: self-types --- -Метод может иметь список _неявных_ параметров, помеченный ключевым словом _implicit_ в начале списка параметров. Если параметры в этом списке не передаются как обычно, то Scala будет искать, где можно получить неявное значение требуемого типа, и если найдет, то передаст его автоматически. +Метод может иметь список _контекстных параметров_ (_contextual parameters_), +также называемых _неявными параметрами_ (_implicit parameters_) или, точнее, _имплицитами_ (_implicits_). +Списки параметров, начинающиеся с ключевого слова `using` (или `implicit` в Scala 2), задают контекстные параметры. +Если сторона вызова явно не предоставляет аргументы для таких параметров, +Scala будет искать неявно доступные `given` (или `implicit` в Scala 2) значения правильного типа. +Если можно найти подходящие значения, то они автоматически передаются. -Места, где Scala будет искать эти параметры, делятся на две категории: - -* Скала сначала будет искать неявные параметры, доступ к которым можно получить напрямую (без префикса) в месте вызова метода в котором запрошены неявные параметры. -* Затем он ищет членов, помеченных как implicit во всех объектах компаньонах, связанных с типом неявного параметра. +Лучше всего вначале показать это на небольшом примере. +Мы определяем интерфейс `Comparator[A]`, который может сравнивать элементы типа `A`, +и предоставляем две реализации для `Int`-ов и `String`-ов. +Затем мы определяем метод `max[A](x: A, y: A)`, который возвращает больший из двух аргументов. +Так как `x` и `y` имеют абстрактный тип, в общем случае мы не знаем, как их сравнивать, но можем запросить соответствующий компаратор. +Поскольку обычно для любого заданного типа существует канонический компаратор `A`, +то мы можем объявить их как _заданные_ (_given_) или _неявно_ (_implicitly_) доступные. -Более подробное руководство, о том где scala ищет неявные значения можно найти в [FAQ](/tutorials/FAQ/finding-implicits.html) +{% tabs implicits-comparator class=tabs-scala-version %} -В следующем примере мы определяем метод `sum`, который вычисляет сумму элементов списка, используя операции `add` и `unit` моноида. Обратите внимание, что неявные значения не могут находится выше уровнем. +{% tab 'Scala 2' for=implicits-comparator %} ```scala mdoc -abstract class Monoid[A] { - def add(x: A, y: A): A - def unit: A +trait Comparator[A] { + def compare(x: A, y: A): Int } -object ImplicitTest { - implicit val stringMonoid: Monoid[String] = new Monoid[String] { - def add(x: String, y: String): String = x concat y - def unit: String = "" +object Comparator { + implicit object IntComparator extends Comparator[Int] { + def compare(x: Int, y: Int): Int = Integer.compare(x, y) } - - implicit val intMonoid: Monoid[Int] = new Monoid[Int] { - def add(x: Int, y: Int): Int = x + y - def unit: Int = 0 - } - - def sum[A](xs: List[A])(implicit m: Monoid[A]): A = - if (xs.isEmpty) m.unit - else m.add(xs.head, sum(xs.tail)) - - def main(args: Array[String]): Unit = { - println(sum(List(1, 2, 3))) // использует intMonoid неявно - println(sum(List("a", "b", "c"))) // использует stringMonoid неявно + + implicit object StringComparator extends Comparator[String] { + def compare(x: String, y: String): Int = x.compareTo(y) } } + +def max[A](x: A, y: A)(implicit comparator: Comparator[A]): A = + if (comparator.compare(x, y) >= 0) x + else y + +println(max(10, 6)) // 10 +println(max("hello", "world")) // world +``` + +```scala mdoc:fail +// не компилируется: +println(max(false, true)) +// ^ +// error: could not find implicit value for parameter comparator: Comparator[Boolean] ``` -`Monoid` определяет здесь операцию под названием `add`, которая сочетает два элемента типа `A` и возвращает сумму типа `A`, операция `unit` позволяет вернуть отдельный (специфичный) элемент типа `A`. +Параметр `comparator` автоматически заполняется значением `Comparator.IntComparator` для `max(10, 6)` +и `Comparator.StringComparator` для `max("hello", "world")`. +Поскольку нельзя найти неявный `Comparator[Boolean]`, вызов `max(false, true)` не компилируется. -Чтобы показать, как работают неявные параметры, сначала определим моноиды `stringMonoid` и `intMonoid` для строк и целых чисел, соответственно. Ключевое слово `implicit` указывает на то, что этот объект может быть использован неявно. +{% endtab %} -Метод `sum` принимает `List[A]` и возвращает `A`, который берет начальное `A` из `unit` и объединяет каждое следующее `A` в списке используя `add` метод. Указание параметра `m` в качестве неявного параметра подразумевает, что `xs` параметр будет обеспечен тогда, когда при вызове параметра метода Scala сможет найти неявный `Monoid[A]` чтоб его передать в качестве параметра `m`. +{% tab 'Scala 3' for=implicits-comparator %} -В нашем `main` методе мы вызываем `sum` дважды и предоставляем только `xs` параметр. Теперь Scala будет искать неявное значение в указанных ранее областях видимости. Первый вызов `sum` проходит с использованием `List[Int]` в качестве `xs`, это означает, что элемент `A` имеет тип `Int`. Неявный список параметров с `m` опущен, поэтому Scala будет искать неявное значение типа `Monoid[Int]`. Первое правило поиска гласит +```scala +trait Comparator[A]: +def compare(x: A, y: A): Int -> Скала сначала будет искать неявные параметры, доступ к которым можно получить напрямую (без префикса) в месте вызова метода в котором запрошены неявные параметры. +object Comparator: +given Comparator[Int] with +def compare(x: Int, y: Int): Int = Integer.compare(x, y) -`intMonoid` - это задание неявного значения, доступ к которому можно получить непосредственно в `main`. Оно имеет подходящий тип, поэтому передается методу `sum` автоматически. +given Comparator[String] with +def compare(x: String, y: String): Int = x.compareTo(y) +end Comparator -Второй вызов `sum` проходит используя `List[String]`, что означает, что `A` - это `String`. Неявный поиск будет идти так же, как и в случае с `Int`, но на этот раз будет найден `stringMonoid`, и передан автоматически в качестве `m`. +def max[A](x: A, y: A)(using comparator: Comparator[A]): A = + if comparator.compare(x, y) >= 0 then x + else y -Программа выведет на экран +println(max(10, 6)) // 10 +println(max("hello", "world")) // world ``` -6 -abc + +```scala +// не компилируется: +println(max(false, true)) +-- Error: ---------------------------------------------------------------------- +1 |println(max(false, true)) + | ^ + |no given instance of type Comparator[Boolean] was found for parameter comparator of method max ``` + +Параметр `comparator` автоматически заполняется значением `given Comparator[Int]` для `max(10, 6)` +и `given Comparator[String]` для `max("hello", "world")`. +Поскольку нельзя найти `given Comparator[Boolean]`, вызов `max(false, true)` не компилируется. + +{% endtab %} + +{% endtabs %} + +Места, где Scala будет искать эти параметры, делятся на две категории: + +- Вначале Scala будет искать `given` параметры, доступ к которым можно получить напрямую (без префикса) в месте вызова `max`. +- Затем он ищет членов, помеченных как given/implicit во всех объектах компаньонах, + связанных с типом неявного параметра (например: `object Comparator` для типа-кандидата `Comparator[Int]`). + +Более подробное руководство, о том где scala ищет неявные значения можно найти в [FAQ](/tutorials/FAQ/finding-implicits.html) From d9cfa1622488a944d15bbd74311c730b2b4cc5ce Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Tue, 19 Sep 2023 17:35:00 +0300 Subject: [PATCH 2713/3075] =?UTF-8?q?Add=20ca-implicit-conversions.md,=20c?= =?UTF-8?q?a-multiversal-equality.md,=20ca-summar=E2=80=A6=20(#2888)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../scala3-book/ca-implicit-conversions.md | 2 +- .../scala3-book/ca-multiversal-equality.md | 2 +- _overviews/scala3-book/ca-summary.md | 2 +- _ru/scala3/book/ca-implicit-conversions.md | 236 ++++++++++++++++++ _ru/scala3/book/ca-multiversal-equality.md | 207 +++++++++++++++ _ru/scala3/book/ca-summary.md | 38 +++ _ru/scala3/book/ca-type-classes.md | 2 +- 7 files changed, 485 insertions(+), 4 deletions(-) create mode 100644 _ru/scala3/book/ca-implicit-conversions.md create mode 100644 _ru/scala3/book/ca-multiversal-equality.md create mode 100644 _ru/scala3/book/ca-summary.md diff --git a/_overviews/scala3-book/ca-implicit-conversions.md b/_overviews/scala3-book/ca-implicit-conversions.md index 16e9dec53a..b35902d71a 100644 --- a/_overviews/scala3-book/ca-implicit-conversions.md +++ b/_overviews/scala3-book/ca-implicit-conversions.md @@ -2,7 +2,7 @@ title: Implicit Conversions type: section description: This page demonstrates how to implement Implicit Conversions in Scala. -languages: [zh-cn] +languages: [ru, zh-cn] num: 66 previous-page: ca-multiversal-equality next-page: ca-summary diff --git a/_overviews/scala3-book/ca-multiversal-equality.md b/_overviews/scala3-book/ca-multiversal-equality.md index be63a600a3..062f23976f 100644 --- a/_overviews/scala3-book/ca-multiversal-equality.md +++ b/_overviews/scala3-book/ca-multiversal-equality.md @@ -2,7 +2,7 @@ title: Multiversal Equality type: section description: This page demonstrates how to implement Multiversal Equality in Scala 3. -languages: [zh-cn] +languages: [ru, zh-cn] num: 65 previous-page: ca-type-classes next-page: ca-implicit-conversions diff --git a/_overviews/scala3-book/ca-summary.md b/_overviews/scala3-book/ca-summary.md index 2a9d281211..f17ffc035a 100644 --- a/_overviews/scala3-book/ca-summary.md +++ b/_overviews/scala3-book/ca-summary.md @@ -2,7 +2,7 @@ title: Summary type: section description: This page provides a summary of the Contextual Abstractions lessons. -languages: [zh-cn] +languages: [ru, zh-cn] num: 67 previous-page: ca-implicit-conversions next-page: concurrency diff --git a/_ru/scala3/book/ca-implicit-conversions.md b/_ru/scala3/book/ca-implicit-conversions.md new file mode 100644 index 0000000000..f4703dc075 --- /dev/null +++ b/_ru/scala3/book/ca-implicit-conversions.md @@ -0,0 +1,236 @@ +--- +layout: multipage-overview +title: Неявное преобразование типов +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: На этой странице демонстрируется, как реализовать неявное преобразование типов в Scala 3. +language: ru +num: 66 +previous-page: ca-multiversal-equality +next-page: ca-summary +--- + +Неявные преобразования — это мощная функция Scala, позволяющая пользователям предоставлять аргумент одного типа, +как если бы он был другого типа, чтобы избежать шаблонного преобразования. + +> Обратите внимание, что в Scala 2 неявные преобразования также использовались для предоставления дополнительных членов +> запечатанным классам (см. [Неявные классы]({% link _overviews/core/implicit-classes.md %})). +> В Scala 3 мы рекомендуем использовать эту функциональность, определяя методы расширения вместо неявных преобразований +> (хотя стандартная библиотека по-прежнему полагается на неявные преобразования по историческим причинам). + +## Пример + +Рассмотрим, например, метод `findUserById`, принимающий параметр типа `Long`: + +{% tabs implicit-conversions-1 %} +{% tab 'Scala 2 и 3' %} + +```scala +def findUserById(id: Long): Option[User] +``` + +{% endtab %} +{% endtabs %} + +Для краткости опустим определение типа `User` - это не имеет значения для нашего примера. + +В Scala есть возможность вызвать метод `findUserById` с аргументом типа `Int` вместо ожидаемого типа `Long`, +потому что аргумент будет неявно преобразован в тип `Long`: + +{% tabs implicit-conversions-2 %} +{% tab 'Scala 2 и 3' %} + +```scala +val id: Int = 42 +findUserById(id) // OK +``` + +{% endtab %} +{% endtabs %} + +Этот код не упадет с ошибкой компиляции “type mismatch: expected `Long`, found `Int`”, +потому что есть неявное преобразование, которое преобразует аргумент `id` в значение типа `Long`. + +## Детальное объяснение + +В этом разделе описывается, как определять и использовать неявные преобразования. + +### Определение неявного преобразования + +{% tabs implicit-conversions-3 class=tabs-scala-version %} + +{% tab 'Scala 2' %} + +В Scala 2 неявное преобразование из типа `S` в тип `T` определяется [неявным классом]({% link _overviews/core/implicit-classes.md %}) `T`, +который принимает один параметр конструктора типа `S`, [неявное значение]({% link _overviews/scala3-book/ca-context-parameters.md %}) +типа функции `S => T` или неявный метод, преобразуемый в значение этого типа. + +Например, следующий код определяет неявное преобразование из `Int` в `Long`: + +```scala +import scala.language.implicitConversions + +implicit def int2long(x: Int): Long = x.toLong +``` + +Это неявный метод, преобразуемый в значение типа `Int => Long`. + +См. раздел "Остерегайтесь силы неявных преобразований" ниже для объяснения пункта `import scala.language.implicitConversions` в начале. +{% endtab %} + +{% tab 'Scala 3' %} +В Scala 3 неявное преобразование типа `S` в тип `T` определяется [`given` экземпляром]({% link _overviews/scala3-book/ca-context-parameters.md %}) +типа `scala.Conversion[S, T]`. +Для совместимости со Scala 2 его также можно определить неявным методом (подробнее читайте во вкладке Scala 2). + +Например, этот код определяет неявное преобразование из `Int` в `Long`: + +```scala +given int2long: Conversion[Int, Long] with + def apply(x: Int): Long = x.toLong +``` + +Как и другие given определения, неявные преобразования могут быть анонимными: + +```scala +given Conversion[Int, Long] with + def apply(x: Int): Long = x.toLong +``` + +Используя псевдоним, это можно выразить более кратко: + +```scala +given Conversion[Int, Long] = (x: Int) => x.toLong +``` + +{% endtab %} + +{% endtabs %} + +### Использование неявного преобразования + +Неявные преобразования применяются в двух случаях: + +1. Если выражение `e` имеет тип `S` и `S` не соответствует ожидаемому типу выражения `T`. +2. В выборе `e.m` с `e` типа `S`, где `S` не определяет `m` + (для поддержки [методов расширения][extension methods] в стиле Scala-2). + +В первом случае ищется конверсия `c`, применимая к `e` и тип результата которой соответствует `T`. + +В примере выше, когда мы передаем аргумент `id` типа `Int` в метод `findUserById`, +вставляется неявное преобразование `int2long(id)`. + +Во втором случае ищется преобразование `c`, применимое к `e` и результат которого содержит элемент с именем `m`. + +Примером является сравнение двух строк `"foo" < "bar"`. +В этом случае `String` не имеет члена `<`, поэтому вставляется неявное преобразование `Predef.augmentString("foo") < "bar"` +(`scala.Predef` автоматически импортируется во все программы Scala.). + +### Как неявные преобразования становятся доступными? + +Когда компилятор ищет подходящие преобразования: + +- во-первых, он смотрит в текущую лексическую область + - неявные преобразования, определенные в текущей области или во внешних областях + - импортированные неявные преобразования + - неявные преобразования, импортированные с помощью импорта подстановочных знаков (только в Scala 2) +- затем он просматривает [сопутствующие объекты][companion objects], _связанные_ с типом аргумента `S` или ожидаемым типом `T`. + Сопутствующие объекты, связанные с типом `X`: + - сам объект-компаньон `X` + - сопутствующие объекты, связанные с любым из унаследованных типов `X` + - сопутствующие объекты, связанные с любым аргументом типа в `X` + - если `X` - это внутренний класс, внешние объекты, в которые он встроен + +Например, рассмотрим неявное преобразование `fromStringToUser`, определенное в объекте `Conversions`: + +{% tabs implicit-conversions-4 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import scala.language.implicitConversions + +object Conversions { + implicit def fromStringToUser(name: String): User = (name: String) => User(name) +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +object Conversions: + given fromStringToUser: Conversion[String, User] = (name: String) => User(name) +``` + +{% endtab %} +{% endtabs %} + +Следующие операции импорта эквивалентно передают преобразование в область действия: + +{% tabs implicit-conversions-5 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import Conversions.fromStringToUser +// или +import Conversions._ +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +import Conversions.fromStringToUser +// или +import Conversions.given +// или +import Conversions.{given Conversion[String, User]} +``` + +Обратите внимание, что в Scala 3 импорт с подстановочными знаками (т.е. `import Conversions.*`) +не импортирует given определения. + +{% endtab %} +{% endtabs %} + +Во вводном примере преобразование из `Int` в `Long` не требует импорта, поскольку оно определено в объекте `Int`, +который является сопутствующим объектом типа `Int`. + +Дополнительная литература: +[Где Scala ищет неявные значения? (в Stackoverflow)](https://stackoverflow.com/a/5598107). + +### Остерегайтесь силы неявных преобразований + +{% tabs implicit-conversions-6 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +Поскольку неявные преобразования могут иметь подводные камни, если используются без разбора, +компилятор предупреждает при компиляции определения неявного преобразования. + +Чтобы отключить предупреждения, выполните одно из следующих действий: + +- Импорт `scala.language.implicitConversions` в область определения неявного преобразования +- Вызвать компилятор с командой `-language:implicitConversions` + +Предупреждение не выдается, когда компилятор применяет преобразование. +{% endtab %} +{% tab 'Scala 3' %} +Поскольку неявные преобразования могут иметь подводные камни, если они используются без разбора, +компилятор выдает предупреждение в двух случаях: + +- при компиляции определения неявного преобразования в стиле Scala 2. +- на стороне вызова, где given экземпляр `scala.Conversion` вставляется как конверсия. + +Чтобы отключить предупреждения, выполните одно из следующих действий: + +- Импортировать `scala.language.implicitConversions` в область: + - определения неявного преобразования в стиле Scala 2 + - стороны вызова, где given экземпляр `scala.Conversion` вставляется как конверсия. +- Вызвать компилятор с командой `-language:implicitConversions` + {% endtab %} + {% endtabs %} + +[extension methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[companion objects]: {% link _overviews/scala3-book/domain-modeling-tools.md %}#companion-objects diff --git a/_ru/scala3/book/ca-multiversal-equality.md b/_ru/scala3/book/ca-multiversal-equality.md new file mode 100644 index 0000000000..19960bc97a --- /dev/null +++ b/_ru/scala3/book/ca-multiversal-equality.md @@ -0,0 +1,207 @@ +--- +layout: multipage-overview +title: Многостороннее равенство +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: На этой странице демонстрируется, как реализовать многостороннее равенство в Scala 3. +language: ru +num: 65 +previous-page: ca-type-classes +next-page: ca-implicit-conversions +versionSpecific: true +--- + +Раньше в Scala было _универсальное равенство_ (_universal equality_): +два значения любых типов можно было сравнивать друг с другом с помощью `==` и `!=`. +Это произошло из-за того факта, что `==` и `!=` реализованы в терминах метода `equals` Java, +который также может сравнивать значения любых двух ссылочных типов. + +Универсальное равенство удобно, но оно также опасно, поскольку подрывает безопасность типов. +Например, предположим, что после некоторого рефакторинга осталась ошибочная программа, +в которой значение `y` имеет тип `S` вместо правильного типа `T`: + +```scala +val x = ... // типа T +val y = ... // типа S, но должно быть типа T +x == y // результат проверки типов всегда будет false +``` + +Если `y` сравнивается с другими значениями типа `T`, программа все равно будет проверять тип, +так как значения всех типов можно сравнивать друг с другом. +Но это, вероятно, даст неожиданные результаты и завершится ошибкой во время выполнения. + +Типобезопасный язык программирования может работать лучше, а многостороннее равенство — +это дополнительный способ сделать универсальное равенство более безопасным. +Он использует класс двоичного типа `CanEqual`, чтобы указать, что значения двух заданных типов можно сравнивать друг с другом. + +## Разрешение сравнения экземпляров класса + +По умолчанию в Scala 3 все ещё можно сравнивать на равенство следующим образом: + +```scala +case class Cat(name: String) +case class Dog(name: String) +val d = Dog("Fido") +val c = Cat("Morris") + +d == c // false, но он компилируется +``` + +Но в Scala 3 такие сравнения можно отключить. +При (а) импорте `scala.language.strictEquality` или (б) использовании флага компилятора `-language:strictEquality` +это сравнение больше не компилируется: + +```scala +import scala.language.strictEquality + +val rover = Dog("Rover") +val fido = Dog("Fido") +println(rover == fido) // ошибка компиляции + +// сообщение об ошибке компиляции: +// Values of types Dog and Dog cannot be compared with == or != +``` + +## Включение сравнений + +Есть два способа включить сравнение с помощью класса типов `CanEqual`. +Для простых случаев класс может _выводиться_ (_derive_) от класса `CanEqual`: + +```scala +// Способ 1 +case class Dog(name: String) derives CanEqual +``` + +Как вы вскоре увидите, когда нужна большая гибкость, вы также можете использовать следующий синтаксис: + +```scala +// Способ 2 +case class Dog(name: String) +given CanEqual[Dog, Dog] = CanEqual.derived +``` + +Любой из этих двух подходов позволяет сравнивать экземпляры `Dog` друг с другом. + +## Более реалистичный пример + +В более реалистичном примере представим, что есть книжный интернет-магазин +и мы хотим разрешить или запретить сравнение бумажных, печатных и аудиокниг. +В Scala 3 для начала необходимо включить многостороннее равенство: + +```scala +// [1] добавить этот импорт или command line flag: -language:strictEquality +import scala.language.strictEquality +``` + +Затем создать объекты домена: + +```scala +// [2] создание иерархии классов +trait Book: + def author: String + def title: String + def year: Int + +case class PrintedBook( + author: String, + title: String, + year: Int, + pages: Int +) extends Book + +case class AudioBook( + author: String, + title: String, + year: Int, + lengthInMinutes: Int +) extends Book +``` + +Наконец, используем `CanEqual`, чтобы определить, какие сравнения необходимо разрешить: + +```scala +// [3] создайте экземпляры класса типов, чтобы определить разрешенные сравнения. +// разрешено `PrintedBook == PrintedBook` +// разрешено `AudioBook == AudioBook` +given CanEqual[PrintedBook, PrintedBook] = CanEqual.derived +given CanEqual[AudioBook, AudioBook] = CanEqual.derived + +// [4a] сравнение двух печатных книг разрешено +val p1 = PrintedBook("1984", "George Orwell", 1961, 328) +val p2 = PrintedBook("1984", "George Orwell", 1961, 328) +println(p1 == p2) // true + +// [4b] нельзя сравнивать печатную книгу и аудиокнигу +val pBook = PrintedBook("1984", "George Orwell", 1961, 328) +val aBook = AudioBook("1984", "George Orwell", 2006, 682) +println(pBook == aBook) // ошибка компиляции +``` + +Последняя строка кода приводит к следующему сообщению компилятора об ошибке: + +``` +Values of types PrintedBook and AudioBook cannot be compared with == or != +``` + +Вот как многостороннее равенство отлавливает недопустимые сравнения типов во время компиляции. + +### Включение “PrintedBook == AudioBook” + +Если есть необходимость разрешить сравнение "печатной книги" (`PrintedBook`) с аудио-книгой (`AudioBook`), +то достаточно создать следующие два дополнительных сравнения равенства: + +```scala +// разрешить `PrintedBook == AudioBook` и `AudioBook == PrintedBook` +given CanEqual[PrintedBook, AudioBook] = CanEqual.derived +given CanEqual[AudioBook, PrintedBook] = CanEqual.derived +``` + +Теперь можно сравнивать печатную книгу с аудио-книгой без ошибки компилятора: + +```scala +println(pBook == aBook) // false +println(aBook == pBook) // false +``` + +#### Внедрите "equals", чтобы они действительно работали + +Хотя эти сравнения теперь разрешены, они всегда будут ложными, +потому что их методы `equals` не знают, как проводить подобные сравнения. +Чтобы доработать сравнение, можно переопределить методы `equals` для каждого класса. +Например, если переопределить метод `equals` для `AudioBook`: + +```scala +case class AudioBook( + author: String, + title: String, + year: Int, + lengthInMinutes: Int +) extends Book: + // переопределить, чтобы разрешить сравнение AudioBook с PrintedBook + override def equals(that: Any): Boolean = that match + case a: AudioBook => + this.author == a.author + && this.title == a.title + && this.year == a.year + && this.lengthInMinutes == a.lengthInMinutes + case p: PrintedBook => + this.author == p.author && this.title == p.title + case _ => + false +``` + +Теперь можно сравнить `AudioBook` с `PrintedBook`: + +```scala +println(aBook == pBook) // true (работает из-за переопределенного `equals` в `AudioBook`) +println(pBook == aBook) // false +``` + +Книга `PrintedBook` не имеет метода `equals`, поэтому второе сравнение возвращает `false`. +Чтобы включить это сравнение, достаточно переопределить метод `equals` в `PrintedBook`. + +Вы можете найти дополнительную информацию о [многостороннем равенстве][ref-equal] в справочной документации. + +[ref-equal]: {{ site.scala3ref }}/contextual/multiversal-equality.html diff --git a/_ru/scala3/book/ca-summary.md b/_ru/scala3/book/ca-summary.md new file mode 100644 index 0000000000..3c56a29139 --- /dev/null +++ b/_ru/scala3/book/ca-summary.md @@ -0,0 +1,38 @@ +--- +layout: multipage-overview +title: Обзор +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: На этой странице представлен краткий обзор уроков по контекстуальным абстракциям. +language: ru +num: 67 +previous-page: ca-implicit-conversions +next-page: +--- + +В этой главе представлено введение в большинство тем контекстных абстракций, в том числе: + +- [Методы расширения](ca-extension-methods.html) +- [Экземпляры given и параметры контекста](ca-context-parameters.html) +- [Контекстные границы](ca-context-bounds.html) +- [Импорт given](ca-given-imports.html) +- [Классы типов](ca-type-classes.html) +- [Многостороннее равенство](ca-multiversal-equality.html) +- [Неявные преобразования](ca-implicit-conversions.html) + +Все эти функции являются вариантами основной идеи **вывода термов**: +учитывая тип, компилятор синтезирует “канонический” терм, который имеет этот тип. + +Несколько более сложных тем здесь не рассматриваются, в том числе: + +- Условные given экземпляры +- Вывод класса типов +- Контекстные функции +- Контекстные параметры по имени +- Связь с имплицитами Scala 2 + +Эти темы подробно обсуждаются в [справочной документации][ref]. + +[ref]: {{ site.scala3ref }}/contextual diff --git a/_ru/scala3/book/ca-type-classes.md b/_ru/scala3/book/ca-type-classes.md index 95b2d83ecb..5da4f9468f 100644 --- a/_ru/scala3/book/ca-type-classes.md +++ b/_ru/scala3/book/ca-type-classes.md @@ -9,7 +9,7 @@ description: В этой главе демонстрируется создан language: ru num: 64 previous-page: ca-given-imports -next-page: +next-page: ca-multiversal-equality --- Класс типов (_type class_) — это абстрактный параметризованный тип, From f30bb535fb057ca9aa4470d414582a3c3e8d9d3c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= <sjrdoeraene@gmail.com> Date: Wed, 20 Sep 2023 16:06:46 +0200 Subject: [PATCH 2714/3075] Add links to the Scala 3 Language Specification. --- _data/doc-nav-header.yml | 6 ++++-- index.md | 8 ++++++-- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index 708c232a0c..9c2c921667 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -9,7 +9,7 @@ url: "/scala3/guides/migration/compatibility-intro.html" - title: New Features for Scaladoc url: "/scala3/scaladoc.html" - - title: Videos and Talks + - title: Videos and Talks url: "/scala3/talks.html" - title: Learn url: "#" @@ -48,8 +48,10 @@ url: "/books.html" - title: Scala FAQ url: "/tutorials/FAQ/index.html" - - title: Scala Language Specification + - title: Scala 2 Language Specification url: http://scala-lang.org/files/archive/spec/2.13/ + - title: Scala 3 Language Specification + url: http://scala-lang.org/files/archive/spec/3.4/ - title: Scala 3 Language Reference url: "https://docs.scala-lang.org/scala3/reference" - title: Scala Contribution Guide diff --git a/index.md b/index.md index 2ec3031c68..fc46058513 100644 --- a/index.md +++ b/index.md @@ -65,10 +65,14 @@ sections: description: "Answers to frequently-asked questions about Scala." icon: "fa fa-question-circle" link: /tutorials/FAQ/index.html - - title: "Language Spec" - description: "Scala's formal language specification." + - title: "Language Spec v2.x" + description: "Scala 2's formal language specification." icon: "fa fa-book" link: https://scala-lang.org/files/archive/spec/2.13/ + - title: "Language Spec v3.x" + description: "Scala 3's formal language specification." + icon: "fa fa-book" + link: https://scala-lang.org/files/archive/spec/3.4/ - title: "Scala 3 Language Reference" description: "The Scala 3 language reference." icon: "fa fa-book" From 1c6b019ab563be0835dfde7e1fdbbb27552295af Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 23 Sep 2023 00:19:17 +0000 Subject: [PATCH 2715/3075] Update SIPs state --- _sips/sips/binary-apis.md | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 _sips/sips/binary-apis.md diff --git a/_sips/sips/binary-apis.md b/_sips/sips/binary-apis.md deleted file mode 100644 index 0e73d27a14..0000000000 --- a/_sips/sips/binary-apis.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-52 - Binary APIs -status: under-review -pull-request-number: 58 -stage: design - ---- From 57b7aba60bf2314d7babe9ab50b0a3d75120a0b7 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 28 Sep 2023 13:57:55 +0200 Subject: [PATCH 2716/3075] update JDK compat page for JDK 21 (#2907) --- _overviews/jdk-compatibility/overview.md | 36 ++++++++---------------- 1 file changed, 11 insertions(+), 25 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 3535e2656a..fdcde855dc 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,7 +12,7 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | JDK version | Minimum Scala versions | |:-----------:|:-------------------------------------------------------------| -| 21 (ea) | 3.3.1, 2.13.11, 2.12.18 | +| 21 (LTS) | 3.3.1, 2.13.11, 2.12.18 | | 20 | 3.3.0, 2.13.11, 2.12.18 | | 19 | 3.2.0, 2.13.9, 2.12.16 | | 18 | 3.1.3, 2.13.7, 2.12.15 | @@ -20,7 +20,7 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | 11 (LTS) | 3.0.0, 2.13.0, 2.12.4, 2.11.12 | | 8 (LTS) | 3.0.0, 2.13.0, 2.12.0, 2.11.0 | -**Using latest patch version is always recommended** +**Using latest patch version of Scala is always recommended** Even when a version combination isn't listed as supported, most features may still work. @@ -30,17 +30,17 @@ Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platfo ## Running versus compiling -JDK 8, 11, 17, and 20 are all reasonable choices both for *compiling* and *running* Scala code. +JDK 8, 11, 17, and 21 are all reasonable choices both for *compiling* and *running* Scala code. Since the JVM is normally backwards compatible, it is usually safe to use a newer JVM for *running* your code than the one it was compiled on, especially if you are not using JVM features designated "experimental" or "unsafe". -JDK 8 remains in use at some shops (as of early 2023), but usage is declining and some projects are dropping support. If you compile on JDK 11+ but want to allow your users to stay on 8, additional care is needed to avoid using APIs and features that don't exist in 8. (For this reason, some Scala developers use a newer JDK for their daily work but do release builds on JDK 8.) +JDK 8 remains in use at some shops (as of 2023), but usage is declining and some projects are dropping support. If you compile on JDK 11+ but want to allow your users to stay on 8, additional care is needed to avoid using APIs and features that don't exist in 8. (For this reason, some Scala developers use a newer JDK for their daily work but do release builds on JDK 8.) ## Long Term Support (LTS) versions After Java 8, Oracle introduced the concept of LTS versions of the JDK. These versions will remain supported (by Oracle, and likely by the rest of the ecosystem, including Scala) for longer than the versions in between. See <https://www.oracle.com/technetwork/java/eol-135779.html>. -JDK 8, 11, and 17 are LTS versions. (The next LTS version will be 21.) +JDK 8, 11, 17, and 21 are LTS versions. (The next LTS version will be 25.) Scala provides experimental support for running the Scala compiler on non-LTS versions of the JDK. The current LTS versions are normally tested in our CI matrix and by the Scala community build. We may also test non-LTS versions, but any issues found there are considered lower priority, and will not be considered release blockers. (Lightbend may be able to offer faster resolution of issues like this under commercial support.) @@ -81,31 +81,17 @@ For sbt users, sbt 1.6.0-RC1 is the first version to support JDK 17, but in prac For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11) and [jdk17](https://github.com/scala/bug/labels/jdk17) labels in the Scala 2 bug tracker. -## JDK 18 compatibility notes - -JDK 18, a non-LTS release, came out in March 2022. - -Support for JDK 18 was included in Scala 2.13.7 and 2.12.15. - -## JDK 19 compatibility notes - -JDK 19, a non-LTS release, came out in September 2022. - -Support for JDK 19 was included in Scala 2.13.9 and 2.12.16. - -## JDK 20 compatibility notes +## JDK 21 compatibility notes -JDK 20, a non-LTS release, came out in March 2023. +JDK 21 is an LTS release. -Support for JDK 20 was included in Scala 3.3.0, 2.13.11, and 2.12.18. +Scala 3.3.1+, 2.13.11+, and 2.12.18+ support JDK 21. -## JDK 21 compatibility notes +The Scala test suite and Scala 2.13 community build are green on JDK 21. -Early access builds of JDK 21 are available. JDK 21 will -be an LTS release. +For sbt users, sbt 1.9.0 is the first version to support JDK 21. -Initial support for JDK 21 has been merged and is already available in -Scala 3.3.1, 2.13.11, and 2.12.18. +For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. ## GraalVM Native Image compatibility notes From dd03c27493c0e8c987c7004d1441f7f438b8723c Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 28 Sep 2023 14:54:32 +0200 Subject: [PATCH 2717/3075] JDK compat page: add build tool compat table --- _overviews/jdk-compatibility/overview.md | 30 +++++++++++++++++++----- 1 file changed, 24 insertions(+), 6 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index fdcde855dc..3c5f836b21 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -8,7 +8,7 @@ Scala's primary platform is the Java Virtual Machine (JVM). (Other supported pla Sometimes new JVM and JDK (Java Development Kit) versions require us to update Scala to remain compatible. -## Version compatibility table +## Scala compatibility table | JDK version | Minimum Scala versions | |:-----------:|:-------------------------------------------------------------| @@ -20,14 +20,30 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S | 11 (LTS) | 3.0.0, 2.13.0, 2.12.4, 2.11.12 | | 8 (LTS) | 3.0.0, 2.13.0, 2.12.0, 2.11.0 | -**Using latest patch version of Scala is always recommended** +Using latest patch version of Scala is always recommended. -Even when a version combination isn't listed as supported, most features may still work. - -In general, Scala works on JDK 11+, including GraalVM, but may not take special advantage of features that were added after JDK 8. See [below](#jdk-11-compatibility-notes). +Even when a version combination isn't listed as supported, most features might still work. Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platform-subscription) for Scala 2. The linked page includes contact information for inquiring about supported and recommended versions. +## Build tool compatibility table + +| JDK version | sbt | +|:-----------:|:----------------| +| 21 (LTS) | 1.9.0 | +| 20 | 1.9.0 | +| 19 | 1.7.0 | +| 18 | 1.6.0 | +| 17 (LTS) | 1.6.0 | +| 11 (LTS) | 1.0.3 | +| 8 (LTS) | 1.0.0 | + +Even when a version combination isn't listed as supported, most features might still work. + +Using a different build tool, not [sbt](https://www.scala-sbt.org)? +We'd happily accept pull requests adding additional columns to this +table. + ## Running versus compiling JDK 8, 11, 17, and 21 are all reasonable choices both for *compiling* and *running* Scala code. @@ -60,7 +76,9 @@ OpenJDK comes in various flavors, offered by different providers. We build and The Scala test suite and Scala community build are green on JDK 11. -The Scala compiler does not enforce the restrictions of the Java Platform Module System, which means that code that typechecks may incur linkage errors at runtime. Scala 2.13.x will eventually provide [rudimentary support](https://github.com/scala/scala/pull/7218) for this (perhaps only in nightlies built on JDK 11). +In general, Scala works on JDK 11+, including GraalVM, but may not take special advantage of features that were added after JDK 8. + +For example, the Scala compiler does not enforce the restrictions of the Java Platform Module System, which means that code that typechecks may incur linkage errors at runtime. Scala 2.13.x will eventually provide [rudimentary support](https://github.com/scala/scala/pull/7218) for this (perhaps only in nightlies built on JDK 11). For sbt users, JDK 11 support requires minimum sbt version 1.1.0. sbt 1.3.9 or newer is recommended. (If you are still on the 0.13.x series, use 0.13.18.) From 37b0ab6a318027e970e3c9a7bea01513e7cba124 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Thu, 5 Oct 2023 09:40:16 +0300 Subject: [PATCH 2718/3075] Update index.md in russian --- _ru/index.md | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/_ru/index.md b/_ru/index.md index 3a3cf3a918..df628955a5 100644 --- a/_ru/index.md +++ b/_ru/index.md @@ -19,7 +19,11 @@ sections: - title: "Книга по Scala 3" description: "Изучайте Scala используя серию коротких уроков." icon: "fa fa-book-open" - link: /scala3/book/introduction.html + link: /ru/scala3/book/introduction.html + - title: "Набор инструментов Scala" + description: "Отправка HTTP-запросов, запись файлов, запуск программ, обработка JSON..." + icon: "fa fa-toolbox" + link: /toolkit/introduction.html - title: Онлайн Курсы, Упражнения и Блоги description: "Обучающие курсы по Scala от новичка до продвинутого уровня." icon: "fa fa-cloud" @@ -55,10 +59,14 @@ sections: description: "Список по наиболее часто задаваемым вопросам с ответами по функционалу Scala." icon: "fa fa-question-circle" link: /tutorials/FAQ/index.html - - title: "Спецификация" - description: "Официальная спецификация языка Scala." + - title: "Спецификация v2.x" + description: "Официальная спецификация языка Scala 2." icon: "fa fa-book" link: https://scala-lang.org/files/archive/spec/2.13/ + - title: "Спецификация v3.x" + description: "Официальная спецификация языка Scala 3." + icon: "fa fa-book" + link: https://scala-lang.org/files/archive/spec/3.4/ - title: "Справочник по языку Scala 3" description: "Справочник по языку Scala 3." icon: "fa fa-book" @@ -73,15 +81,15 @@ sections: - title: "Новое в Scala 3" description: "Обзор новой функциональности в Scala 3." icon: "fa fa-star" - link: /scala3/new-in-scala3.html + link: /ru/scala3/new-in-scala3.html - title: "Новая функциональность Scaladoc для Scala 3" description: "Ключевые особенности новой функциональности Scaladoc." icon: "fa fa-star" - link: /scala3/scaladoc.html + link: /ru/scala3/scaladoc.html - title: "Выступления" description: "Доступные онлайн выступления о Scala 3." icon: "fa fa-play-circle" - link: /scala3/talks.html + link: /ru/scala3/talks.html - title: "Развитие Scala" links: From 2cac84a05f00dab552b7da95bb9c63643c2ee9da Mon Sep 17 00:00:00 2001 From: Volodymyr Myroniuk <vladimironiuk@gmail.com> Date: Fri, 6 Oct 2023 17:36:05 +0300 Subject: [PATCH 2719/3075] Fix code in 'Scala Tour / Singleton Objects / Companion Objects' --- _tour/singleton-objects.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_tour/singleton-objects.md b/_tour/singleton-objects.md index 369402eee1..fb985d4a17 100644 --- a/_tour/singleton-objects.md +++ b/_tour/singleton-objects.md @@ -104,6 +104,7 @@ An object with the same name as a class is called a _companion object_. Converse {% tab 'Scala 2' for=companion-object-circle %} ```scala +import scala.math.Pi import scala.math.pow case class Circle(radius: Double) { @@ -123,7 +124,7 @@ circle1.area {% tab 'Scala 3' for=companion-object-circle %} ```scala -import scala.math.pow +import scala.math.{Pi, pow} case class Circle(radius: Double): import Circle.* From 0c0907320a16839d5bbef5b6613c8da31ab28995 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Fri, 6 Oct 2023 19:58:51 +0300 Subject: [PATCH 2720/3075] Add concurrency.md in russian --- _overviews/scala3-book/concurrency.md | 2 +- _overviews/scala3-book/scala-tools.md | 2 +- _ru/scala3/book/ca-summary.md | 2 +- _ru/scala3/book/concurrency.md | 333 ++++++++++++++++++++++++++ _ru/scala3/book/scala-tools.md | 18 ++ 5 files changed, 354 insertions(+), 3 deletions(-) create mode 100644 _ru/scala3/book/concurrency.md create mode 100644 _ru/scala3/book/scala-tools.md diff --git a/_overviews/scala3-book/concurrency.md b/_overviews/scala3-book/concurrency.md index 6740910c4a..ef89e0a822 100644 --- a/_overviews/scala3-book/concurrency.md +++ b/_overviews/scala3-book/concurrency.md @@ -2,7 +2,7 @@ title: Concurrency type: chapter description: This page discusses how Scala concurrency works, with an emphasis on Scala Futures. -languages: [zh-cn] +languages: [ru, zh-cn] num: 68 previous-page: ca-summary next-page: scala-tools diff --git a/_overviews/scala3-book/scala-tools.md b/_overviews/scala3-book/scala-tools.md index 1b6badd809..7d6bb7a397 100644 --- a/_overviews/scala3-book/scala-tools.md +++ b/_overviews/scala3-book/scala-tools.md @@ -2,7 +2,7 @@ title: Scala Tools type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. -languages: [zh-cn] +languages: [ru, zh-cn] num: 69 previous-page: concurrency next-page: tools-sbt diff --git a/_ru/scala3/book/ca-summary.md b/_ru/scala3/book/ca-summary.md index 3c56a29139..f3b68b7211 100644 --- a/_ru/scala3/book/ca-summary.md +++ b/_ru/scala3/book/ca-summary.md @@ -9,7 +9,7 @@ description: На этой странице представлен кратки language: ru num: 67 previous-page: ca-implicit-conversions -next-page: +next-page: concurrency --- В этой главе представлено введение в большинство тем контекстных абстракций, в том числе: diff --git a/_ru/scala3/book/concurrency.md b/_ru/scala3/book/concurrency.md new file mode 100644 index 0000000000..ec43810bfa --- /dev/null +++ b/_ru/scala3/book/concurrency.md @@ -0,0 +1,333 @@ +--- +layout: multipage-overview +title: Параллелизм +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: chapter +description: На этой странице обсуждается, как работает параллелизм в Scala, с упором на Scala Futures. +language: ru +num: 68 +previous-page: ca-summary +next-page: scala-tools +--- + +Для написания параллельных приложений на Scala, _можно_ использовать нативный Java `Thread`, +но Scala [Future](https://www.scala-lang.org/api/current/scala/concurrent/Future$.html) предлагает более высокоуровневый +и идиоматический подход, поэтому он предпочтителен и рассматривается в этой главе. + +## Введение + +Вот описание Scala `Future` из его Scaladoc: + +> "`Future` представляет собой значение, которое может быть или не быть доступным _в настоящее время_, +> но будет доступно в какой-то момент, или вызовет исключение, если это значение не может быть сделано доступным". + +Чтобы продемонстрировать, что это значит, сначала рассмотрим однопоточное программирование. +В однопоточном мире результат вызова метода привязывается к переменной следующим образом: + +```scala +def aShortRunningTask(): Int = 42 +val x = aShortRunningTask() +``` + +В этом коде значение `42` сразу привязывается к `x`. + +При работе с `Future` процесс назначения выглядит примерно так: + +```scala +def aLongRunningTask(): Future[Int] = ??? +val x = aLongRunningTask() +``` + +Но главное отличие в этом случае заключается в том, что, поскольку `aLongRunningTask` возвращает неопределенное время, +значение `x` может быть доступно или недоступно _в данный момент_, но оно будет доступно в какой-то момент — в будущем. + +Другой способ взглянуть на это с точки зрения блокировки. +В этом однопоточном примере оператор `println` не печатается до тех пор, пока не завершится выполнение `aShortRunningTask`: + +```scala +def aShortRunningTask(): Int = + Thread.sleep(500) + 42 +val x = aShortRunningTask() +println("Here") +``` + +И наоборот, если `aShortRunningTask` создается как `Future`, оператор `println` печатается почти сразу, +потому что `aShortRunningTask` порождается в другом потоке — он не блокируется. + +В этой главе будет рассказано, как использовать `Future`, +в том числе как запускать несколько `Future` параллельно и объединять их результаты в выражении `for`. +Также будут показаны примеры методов, которые используются для обработки значения `Future` после его возврата. + +> О `Future`, важно знать, что они задуманы как одноразовая конструкция +> "Обработайте это относительно медленное вычисление в каком-нибудь другом потоке и верните мне результат, когда закончите". +> В отличие от этого, акторы [Akka](https://akka.io) предназначены для работы в течение длительного времени +> и отвечают на множество запросов в течение своей жизни. +> В то время как субъект может жить вечно, `Future` в конечном итоге содержит результат вычисления, +> которое выполнялось только один раз. + +## Пример в REPL + +`Future` используется для создания временного кармана параллелизма. +Например, можно использовать `Future`, когда нужно вызвать алгоритм, +который выполняется неопределенное количество времени — например, вызов удаленного микросервиса, — +поэтому его желательно запустить вне основного потока. + +Чтобы продемонстрировать, как это работает, начнем с примера `Future` в REPL. +Во-первых, вставим необходимые инструкции импорта: + +```scala +import scala.concurrent.Future +import scala.concurrent.ExecutionContext.Implicits.global +import scala.util.{Failure, Success} +``` + +Теперь можно создать `Future`. +Для этого примера сначала определим долговременный однопоточный алгоритм: + +```scala +def longRunningAlgorithm() = + Thread.sleep(10_000) + 42 +``` + +Этот причудливый алгоритм возвращает целочисленное значение `42` после десятисекундной задержки. +Теперь вызовем этот алгоритм, поместив его в конструктор `Future` и присвоив результат переменной: + +```scala +scala> val eventualInt = Future(longRunningAlgorithm()) +eventualInt: scala.concurrent.Future[Int] = Future(<not completed>) +``` + +Вычисления начинают выполняться после вызова `longRunningAlgorithm()`. +Если сразу проверить значение переменной `eventualInt`, то можно увидеть, что `Future` еще не завершен: + +```scala +scala> eventualInt +val res1: scala.concurrent.Future[Int] = Future(<not completed>) +``` + +Но если проверить через десять секунд ещё раз, то можно увидеть, что оно выполнено успешно: + +```scala +scala> eventualInt +val res2: scala.concurrent.Future[Int] = Future(Success(42)) +``` + +Хотя это относительно простой пример, он демонстрирует основной подход: +просто создайте новое `Future` с помощью своего долговременного алгоритма. + +Одна вещь, на которую следует обратить внимание - +это то, что ожидаемый результат `42` обернут в `Success`, который обернут в `Future`. +Это ключевая концепция для понимания: значение `Future` всегда является экземпляром одного из `scala.util.Try`: `Success` или `Failure`. +Поэтому, при работе с результатом `Future`, используются обычные методы обработки `Try`. + +### Использование `map` с `Future` + +`Future` содержит метод `map`, который используется точно так же, как метод `map` для коллекций. +Вот как выглядит результат, при вызове `map` сразу после создания переменной `a`: + +```scala +scala> val a = Future(longRunningAlgorithm()).map(_ * 2) +a: scala.concurrent.Future[Int] = Future(<not completed>) +``` + +Как показано, для `Future`, созданного с помощью `longRunningAlgorithm`, первоначальный вывод показывает `Future(<not completed>)`. +Но если проверить значение `a` через десять секунд, то можно увидеть, что оно содержит ожидаемый результат `84`: + +```scala +scala> a +res1: scala.concurrent.Future[Int] = Future(Success(84)) +``` + +Еще раз, успешный результат обернут внутри `Success` и `Future`. + +### Использование методов обратного вызова с `Future` + +В дополнение к функциям высшего порядка, таким как `map`, с `Future` также можно использовать методы обратного вызова. +Одним из часто используемых методов обратного вызова является `onComplete`, принимающий _частично определенную функцию_, +в которой обрабатываются случаи `Success` и `Failure`: + +```scala +Future(longRunningAlgorithm()).onComplete { + case Success(value) => println(s"Got the callback, value = $value") + case Failure(e) => e.printStackTrace +} +``` + +Если вставить этот код в REPL, то в конечном итоге придет результат: + +```scala +Got the callback, value = 42 +``` + +## Другие методы `Future` + +Класс `Future` содержит некоторые методы, которые можно найти в классах коллекций Scala, в том числе: + +- `filter` +- `flatMap` +- `map` + +Методы обратного вызова: + +- `onComplete` +- `andThen` +- `foreach` + +Другие методы трансформации: + +- `fallbackTo` +- `recover` +- `recoverWith` + +См. страницу [Futures and Promises][futures] для обсуждения дополнительных методов, доступных для `Future`. + +## Запуск нескольких `Future` и объединение результатов + +Чтобы запустить несколько вычислений параллельно и соединить их результаты после завершения всех `Future`, +можно использовать выражение `for`. + +Правильный подход такой: + +1. Запустить вычисления, которые возвращают `Future` результаты +2. Объединить их результаты в выражении `for` +3. Извлечь объединенный результат, используя `onComplete` или аналогичный метод + +### Пример + +Три шага правильного подхода показаны в следующем примере. +Ключевой момент - сначала запускаются вычисления, возвращающие `Future`, а затем они объединяются в выражении `for`: + +```scala +import scala.concurrent.Future +import scala.concurrent.ExecutionContext.Implicits.global +import scala.util.{Failure, Success} + +val startTime = System.currentTimeMillis() +def delta() = System.currentTimeMillis() - startTime +def sleep(millis: Long) = Thread.sleep(millis) + +@main def multipleFutures1 = + + println(s"creating the futures: ${delta()}") + + // (1) запуск вычислений, возвращающих Future + val f1 = Future { sleep(800); 1 } // в конце концов возвращается 1 + val f2 = Future { sleep(200); 2 } // в конце концов возвращается 2 + val f3 = Future { sleep(400); 3 } // в конце концов возвращается 3 + + // (2) объединение нескольких Future в выражении `for` + val result = + for + r1 <- f1 + r2 <- f2 + r3 <- f3 + yield + println(s"in the 'yield': ${delta()}") + (r1 + r2 + r3) + + // (3) обработка результата + result.onComplete { + case Success(x) => + println(s"in the Success case: ${delta()}") + println(s"result = $x") + case Failure(e) => + e.printStackTrace + } + + println(s"before the 'sleep(3000)': ${delta()}") + + // важно для небольшой параллельной демонстрации: не глушить jvm + sleep(3000) +``` + +После запуска этого приложения, вывод выглядит следующим образом: + +``` +creating the futures: 1 +before the 'sleep(3000)': 2 +in the 'yield': 806 +in the Success case: 806 +result = 6 +``` + +Как показывает вывод, `Future` создаются очень быстро, +и всего за две миллисекунды достигается оператор печати непосредственно перед операцией `sleep(3000)` в конце метода. +Весь этот код выполняется в основном потоке JVM. Затем, через 806 мс, три `Future` завершаются, и выполняется код в блоке `yield`. +Затем код немедленно переходит к варианту `Success` в методе `onComplete`. + +Вывод 806 мс является ключом к тому, чтобы убедиться, что три вычисления выполняются параллельно. +Если бы они выполнялись последовательно, общее время составило бы около 1400 мс — сумма времени ожидания трех вычислений. +Но поскольку они выполняются параллельно, общее время чуть больше, чем у самого продолжительного вычисления `f1`, +которое составляет 800 мс. + +> Обратите внимание, что если бы вычисления выполнялись в выражении `for`, +> они выполнялись бы последовательно, а не параллельно: +> +> ``` +> // последовательное выполнение (без параллелизма!) +> for +> r1 <- Future { sleep(800); 1 } +> r2 <- Future { sleep(200); 2 } +> r3 <- Future { sleep(400); 3 } +> yield +> r1 + r2 + r3 +> ``` +> +> Итак, если необходимо, чтобы вычисления выполнялись параллельно, не забудьте запустить их вне выражения `for`. + +### Метод, возвращающий Future + +Было показано, как передавать однопоточный алгоритм в конструктор `Future`. +Ту же технику можно использовать для создания метода, который возвращает `Future`: + +```scala +// моделируем медленно работающий метод +def slowlyDouble(x: Int, delay: Long): Future[Int] = Future { + sleep(delay) + x * 2 +} +``` + +Как и в предыдущих примерах, достаточно просто присвоить результат вызова метода новой переменной. +Тогда, если сразу проверить результат, то можно увидеть, что он не завершен, +но по истечении времени задержки в `Future` результат будет выдан: + +``` +scala> val f = slowlyDouble(2, 5_000L) +val f: concurrent.Future[Int] = Future(<not completed>) + +scala> f +val res0: concurrent.Future[Int] = Future(<not completed>) + +scala> f +val res1: concurrent.Future[Int] = Future(Success(4)) +``` + +## Ключевые моменты о Future + +Надеюсь, эти примеры дадут вам представление о том, как работает Scala `Future`. +Подводя итог, несколько ключевых моментов о `Future`: + +- `Future` создается для запуска задач вне основного потока +- `Future` предназначены для одноразовых, потенциально длительных параллельных задач, которые _в конечном итоге_ возвращают значение; + они создают временный карман параллелизма +- `Future` начинает работать в момент построения +- преимущество `Future` над потоками заключается в том, что они работают с выражениями `for` + и имеют множество методов обратного вызова, упрощающих процесс работы с параллельными потоками +- при работе с `Future` не нужно беспокоиться о низкоуровневых деталях управления потоками +- результат `Future` обрабатывается с помощью методов обратного вызова, таких как `onComplete` и `andThen`, + или методов преобразования, таких как `filter`, `map` и т.д. +- значение внутри `Future` всегда является экземпляром одного из типов `Try`: `Success` или `Failure` +- при использовании нескольких `Future` для получения одного результата, они объединяются в выражении `for` + +Кроме того, как было видно по операторам `import`, Scala `Future` зависит от `ExecutionContext`. + +Дополнительные сведения о `Future` см. в статье [Futures and Promises][futures], +в которой обсуждаются futures, promises и execution contexts. +В ней также обсуждается, как выражение `for` транслируется в операцию `flatMap`. + +[futures]: {% link _overviews/core/futures.md %} diff --git a/_ru/scala3/book/scala-tools.md b/_ru/scala3/book/scala-tools.md new file mode 100644 index 0000000000..640a67995d --- /dev/null +++ b/_ru/scala3/book/scala-tools.md @@ -0,0 +1,18 @@ +--- +layout: multipage-overview +title: Scala утилиты +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: chapter +description: В этой главе рассматриваются два широко используемых инструмента Scala sbt и ScalaTest. +language: ru +num: 69 +previous-page: concurrency +next-page: +--- + +В этой главе представлены два способа написания и запуска программ в Scala: + +- создавая Scala проекты, возможно, содержащие несколько файлов, и определяя точку входа в программу, +- путем взаимодействия с worksheet, который представляет собой программу, определенную в одном файле и выполняемую построчно. From 8a7f1b7c97e2a83a1ec58f6813a3d78dc2378276 Mon Sep 17 00:00:00 2001 From: Volodymyr Myroniuk <vladimironiuk@gmail.com> Date: Fri, 6 Oct 2023 20:11:08 +0300 Subject: [PATCH 2721/3075] Make the imports in the same style for Scala 2 and 3 --- _tour/singleton-objects.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_tour/singleton-objects.md b/_tour/singleton-objects.md index fb985d4a17..47a67ee175 100644 --- a/_tour/singleton-objects.md +++ b/_tour/singleton-objects.md @@ -104,8 +104,7 @@ An object with the same name as a class is called a _companion object_. Converse {% tab 'Scala 2' for=companion-object-circle %} ```scala -import scala.math.Pi -import scala.math.pow +import scala.math.{Pi, pow} case class Circle(radius: Double) { import Circle._ From 7b830efda30a60ad8ec3b401629431e0b2dedb15 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Sat, 7 Oct 2023 13:35:45 +0300 Subject: [PATCH 2722/3075] Change en links to ru links --- _ru/tour/for-comprehensions.md | 2 +- _ru/tour/implicit-conversions.md | 4 ++-- _ru/tour/pattern-matching.md | 2 +- _ru/tour/singleton-objects.md | 2 +- _ru/tour/tour-of-scala.md | 39 ++++++++++++++++++-------------- _ru/tour/traits.md | 4 ++-- 6 files changed, 29 insertions(+), 24 deletions(-) diff --git a/_ru/tour/for-comprehensions.md b/_ru/tour/for-comprehensions.md index 01da58caf6..8f6ae91bba 100644 --- a/_ru/tour/for-comprehensions.md +++ b/_ru/tour/for-comprehensions.md @@ -129,4 +129,4 @@ foo(10, 10) ## Дополнительные ресурсы -- Другие примеры "For comprehension" доступны [в книге Scala](/scala3/book/control-structures.html#for-expressions) +- Другие примеры "For comprehension" доступны [в книге Scala](/ru/scala3/book/control-structures.html#выражение-for) diff --git a/_ru/tour/implicit-conversions.md b/_ru/tour/implicit-conversions.md index 0ac21bd31f..d7fa354c1a 100644 --- a/_ru/tour/implicit-conversions.md +++ b/_ru/tour/implicit-conversions.md @@ -19,7 +19,7 @@ previous-page: implicit-parameters {% tab 'Scala 2' %} В Scala 2 неявное преобразование из типа `S` в тип `T` определяется либо [неявным классом]({% link _overviews/core/implicit-classes.md %}) `T` -с одним параметром типа `S`, [неявным значением]({% link _tour/implicit-parameters.md %}), которое имеет тип функции `S => T`, +с одним параметром типа `S`, [неявным значением](implicit-parameters.html), которое имеет тип функции `S => T`, либо неявным методом, преобразуемым в значение этого типа. {% endtab %} @@ -49,4 +49,4 @@ previous-page: implicit-parameters Дополнительная литература: [Неявные преобразования (в книге Scala)]({% link _overviews/scala3-book/ca-implicit-conversions.md %}). -[exts]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[exts]: /ru/scala3/book/ca-extension-methods.html diff --git a/_ru/tour/pattern-matching.md b/_ru/tour/pattern-matching.md index da9ef90420..b46810564b 100644 --- a/_ru/tour/pattern-matching.md +++ b/_ru/tour/pattern-matching.md @@ -332,4 +332,4 @@ Scala также позволяет создавать образцы незав ## Дополнительные ресурсы -- Дополнительная информация о сопоставлении с примером доступна [в книге Scala](/scala3/book/control-structures.html#match-expressions). +- Дополнительная информация о сопоставлении с примером доступна [в книге Scala](/ru/scala3/book/control-structures.html#match-выражения). diff --git a/_ru/tour/singleton-objects.md b/_ru/tour/singleton-objects.md index 3f58689062..5a0da42d5c 100644 --- a/_ru/tour/singleton-objects.md +++ b/_ru/tour/singleton-objects.md @@ -226,4 +226,4 @@ scalaCenterEmail match ## Дополнительные ресурсы -- Узнайте больше об объектах компаньонах в [Scala Book](/scala3/book/domain-modeling-tools.html#companion-objects) +- Узнайте больше об объектах компаньонах в [Scala Book](/ru/scala3/book/domain-modeling-tools.html#сопутствующие-объекты) diff --git a/_ru/tour/tour-of-scala.md b/_ru/tour/tour-of-scala.md index 321685dbb3..f60a84e0b5 100644 --- a/_ru/tour/tour-of-scala.md +++ b/_ru/tour/tour-of-scala.md @@ -8,48 +8,53 @@ next-page: basics --- ## Добро пожаловать к обзору + Здесь вы увидите вводное описание наиболее часто используемых возможностей Scala. Этот обзор предназначен для новичков в изучении языка. -Это лишь небольшая экскурсия, а не полный курс освоения языка. Для глубокого погружения рекомендуем почитать [книги](/books.html) или воспользоваться курсами +Это лишь небольшая экскурсия, а не полный курс освоения языка. Для глубокого погружения рекомендуем почитать [книги](/books.html) или воспользоваться курсами [на других ресурсах](/learn.html). ## Что такое Scala? + Scala - это современный мультипарадигмальный язык программирования, разработанный для выражения общих концепций программирования в простой, удобной и типобезопасной манере. Элегантно объединяя особенности объектно-ориентированных и функциональных языков. -## Scala объектно ориентированный ## +## Scala объектно ориентированный + Scala - это чистый объектно-ориентированный язык в том смысле, что [каждое значение - это объект](unified-types.html). Типы и поведение объектов описаны в [классах](classes.html) и [трейтах](traits.html)(характеристиках объектов). Классы расширяются за счет механизма наследования и гибкого [смешивания классов](mixin-class-composition.html), который используется для замены множественного наследования. -## Scala функциональный ## +## Scala функциональный + Scala также является функциональным языком в том смысле, что [каждая функция - это значение](unified-types.html). Scala предоставляет [легкий синтаксис](basics.html) для определения анонимных функций, поддерживает [функции высшего порядка](higher-order-functions.html), поддерживает [вложенные функции](nested-functions.html), а также [каррирование](multiple-parameter-lists.html). Scala имеют встроенную поддержку алгебраических типов данных, которые используются в большинстве функциональных языках программирования (эта поддержка базируется на механизме [сопоставления с примером](pattern-matching.html), где в качестве примера выступают [классы образцы](case-classes.html) ). [Объекты](singleton-objects.html) предоставляют удобный способ группировки функций, не входящих в класс. Вдобавок к этому, концепция сопоставления с примером логично переносится на [обработку XML-данных](https://github.com/scala/scala-xml/wiki/XML-Processing) используя в качестве примера [регулярные выражения](regular-expression-patterns.html), при поддержке функционала [объектов экстракторов](extractor-objects.html). Для еще большего удобства обработки данных представлена схема формирования запросов с использованием [for-выражения](for-comprehensions.html). Такие возможности делают Scala идеальным решением для разработки приложений по типу веб-сервисов. -## Scala статически типизированный ## +## Scala статически типизированный + Scala оснащен выразительной системой типов, которая обеспечивает безопасное и гармоничное использование абстракций. В частности, система типов поддерживает: -* [обобщенные классы](generic-classes.html) -* [вариантность типов](variances.html) -* [верхние](upper-type-bounds.html) и [нижние](lower-type-bounds.html) границы типов -* [внутренние классы](inner-classes.html) и [члены абстрактного типа](abstract-type-members.html), как часть объектов -* [составные типы](compound-types.html) -* [самоописываемые типы](self-types.html) -* [неявные параметры](implicit-parameters.html) и [неявные преобразования](implicit-conversions.html) -* [полиморфные методы](polymorphic-methods.html) +- [обобщенные классы](generic-classes.html) +- [вариантность типов](variances.html) +- [верхние](upper-type-bounds.html) и [нижние](lower-type-bounds.html) границы типов +- [внутренние классы](inner-classes.html) и [члены абстрактного типа](abstract-type-members.html), как часть объектов +- [составные типы](compound-types.html) +- [самоописываемые типы](self-types.html) +- [неявные параметры](implicit-parameters.html) и [неявные преобразования](implicit-conversions.html) +- [полиморфные методы](polymorphic-methods.html) -[Выведение типов](type-inference.html) означает, что разработчику не обязательно добавлять в код избыточную информацию о типах. +[Выведение типов](type-inference.html) означает, что разработчику не обязательно добавлять в код избыточную информацию о типах. Такой функционал обеспечивает основу для безопасного переиспользования абстракций и типобезопасного развития программного обеспечения. -## Scala расширяемый ## +## Scala расширяемый Зачастую разработка приложений для очень специфичных областей требует специфичных для этих областей языковых возможностей, либо отдельных специализированных языков программирования. Вместо этого Scala предлагает уникальные механизмы, для легкой модификации и расширения самого языка. Во многих случаях такое можно сделать без использования средств мета-программирования, таких как макросы. Например: -* [Неявные классы](https://docs.scala-lang.org/overviews/core/implicit-classes.html) позволяют добавлять новые методы к уже существующим. -* [Интерполяция строк](/overviews/core/string-interpolation.html) позволяет добавлять обработку строк (расширяется разработчиком с помощью интерполяторов). +- [Неявные классы](https://docs.scala-lang.org/overviews/core/implicit-classes.html) позволяют добавлять новые методы к уже существующим. +- [Интерполяция строк](/ru/scala3/book/string-interpolation.html) позволяет добавлять обработку строк (расширяется разработчиком с помощью интерполяторов). -## Scala совместимый +## Scala совместимый Scala полностью совместим с популярной средой Java Runtime Environment (JRE). Взаимодействие с основным объектно-ориентированным языком программирования Java происходит максимально гладко. Новые функции Java, такие как SAM, [лямбды](higher-order-functions.html), [аннотации](annotations.html) и [дженерики](generic-classes.html), имеют прямые аналоги в Scala. diff --git a/_ru/tour/traits.md b/_ru/tour/traits.md index 97e2cec5bb..ef958c94cf 100644 --- a/_ru/tour/traits.md +++ b/_ru/tour/traits.md @@ -175,5 +175,5 @@ animals.foreach(pet => println(pet.name)) // выведет "Harry" и "Sally" ## Дополнительные ресурсы -- Узнайте больше о трейтах в [Scala Book](/scala3/book/domain-modeling-tools.html#traits) -- Использование трейтов для определения [Enum](/scala3/book/domain-modeling-fp.html#modeling-the-data) +- Узнайте больше о трейтах в [Scala Book](/ru/scala3/book/domain-modeling-tools.html#трейты) +- Использование трейтов для определения [Enum](/ru/scala3/book/domain-modeling-fp.html#моделирование-данных) From fdd0100b9e70714287150b476be1119645a4f7f7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D1=80=D1=82=D1=91=D0=BC=20=D0=9A=D0=BE=D1=80=D1=81?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=B2?= <artemkorsakov@mail.ru> Date: Sat, 7 Oct 2023 13:46:12 +0300 Subject: [PATCH 2723/3075] Change en links to ru links --- _ru/tour/implicit-conversions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_ru/tour/implicit-conversions.md b/_ru/tour/implicit-conversions.md index d7fa354c1a..5e3001862d 100644 --- a/_ru/tour/implicit-conversions.md +++ b/_ru/tour/implicit-conversions.md @@ -25,7 +25,7 @@ previous-page: implicit-parameters {% endtab %} {% tab 'Scala 3' %} -В Scala 3 неявное преобразование из типа `S` в тип `T` определяется [экземпляром `given`]({% link _tour/implicit-parameters.md %}), который имеет тип `scala.Conversion[S, T]`. +В Scala 3 неявное преобразование из типа `S` в тип `T` определяется [экземпляром `given`](implicit-parameters.html), который имеет тип `scala.Conversion[S, T]`. Для совместимости со Scala 2 их также можно определить неявным методом (подробнее читайте во вкладке Scala 2). {% endtab %} @@ -47,6 +47,6 @@ previous-page: implicit-parameters В этом случае `String` не имеет члена `<`, поэтому вставляется неявное преобразование `Predef.augmentString("foo") < "bar"` (`scala.Predef` автоматически импортируется во все программы Scala). -Дополнительная литература: [Неявные преобразования (в книге Scala)]({% link _overviews/scala3-book/ca-implicit-conversions.md %}). +Дополнительная литература: [Неявные преобразования (в книге Scala)](/ru/scala3/book/ca-implicit-conversions.html). [exts]: /ru/scala3/book/ca-extension-methods.html From 472932a339d4b5600cd45b6e55dc5f0e72631720 Mon Sep 17 00:00:00 2001 From: John Duffell <john.duffell@guardian.co.uk> Date: Tue, 10 Oct 2023 08:56:52 +0100 Subject: [PATCH 2724/3075] fix typo and bump scala 2.13 version --- _overviews/scala3-migration/tutorial-macro-mixing.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_overviews/scala3-migration/tutorial-macro-mixing.md b/_overviews/scala3-migration/tutorial-macro-mixing.md index e7684adc7b..a0a88b17ce 100644 --- a/_overviews/scala3-migration/tutorial-macro-mixing.md +++ b/_overviews/scala3-migration/tutorial-macro-mixing.md @@ -106,8 +106,8 @@ lazy val example = project.in(file("example")) lazy val `example-compat` = project.in(file("example-compat")) .settings( - scalaVersion := "2.13.11", - libraryDependency += "org.scala-lang" % "scala-reflect" % scalaVersion.value + scalaVersion := "2.13.12", + libraryDependencies += "org.scala-lang" % "scala-reflect" % scalaVersion.value ) ``` @@ -151,7 +151,7 @@ Since we want to execute the tests in Scala 2.13 and Scala 3, we create a cross- lazy val `example-test` = project.in(file("example-test")) .settings( scalaVersion := "3.3.1", - crossScalaVersions := Seq("3.3.1", "2.13.11"), + crossScalaVersions := Seq("3.3.1", "2.13.12"), scalacOptions ++= { CrossVersion.partialVersion(scalaVersion.value) match { case Some((2, 13)) => Seq("-Ytasty-reader") @@ -185,7 +185,7 @@ class MacrosSpec extends munit.FunSuite { You should now be able to run the tests in both versions. {% highlight text %} -sbt:example> ++2.13.11 +sbt:example> ++2.13.12 sbt:example> example-test / test location.MacrosSpec: + location @@ -213,7 +213,7 @@ You are now ready to publish your library. It can be used in Scala 3 projects, or in Scala 2.13 projects with these settings: ```scala -scalaVersion := "2.13.11" +scalaVersion := "2.13.12" libraryDependencies += ("org" %% "example" % "x.y.z").cross(CrossVersion.for2_13Use3) scalacOptions += "-Ytasty-reader" ``` From a1fa41281936a0ac6b989558758d12d093a89b05 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Sun, 15 Oct 2023 19:31:08 -0600 Subject: [PATCH 2725/3075] fix Scala Native 404 links --- _overviews/jdk-compatibility/overview.md | 2 +- _overviews/scala3-book/scala-for-javascript-devs.md | 2 +- _overviews/scala3-book/scala-for-python-devs.md | 2 +- _overviews/scala3-migration/tutorial-prerequisites.md | 2 +- _zh-cn/overviews/scala3-book/scala-for-javascript-devs.md | 2 +- _zh-cn/overviews/scala3-book/scala-for-python-devs.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index fdcde855dc..230e1a1c14 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -4,7 +4,7 @@ title: JDK Compatibility permalink: /overviews/jdk-compatibility/overview.html --- -Scala's primary platform is the Java Virtual Machine (JVM). (Other supported platforms: [Scala.js](https://www.scala-js.org/), [Scala Native](https://scala-native.readthedocs.io/).) +Scala's primary platform is the Java Virtual Machine (JVM). (Other supported platforms: [Scala.js](https://www.scala-js.org/), [Scala Native](https://scala-native.org/).) Sometimes new JVM and JDK (Java Development Kit) versions require us to update Scala to remain compatible. diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index 213b1bada7..658b2a6539 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -51,7 +51,7 @@ Also at a high level, some of the differences between JavaScript and Scala are: - As a pure OOP language and a pure FP language, Scala encourages a fusion of OOP and FP, with functions for the logic and immutable objects for modularity - Scala has state of the art, third-party, open source functional programming libraries - Everything in Scala is an _expression_: constructs like `if` statements, `for` loops, `match` expressions, and even `try`/`catch` expressions all have return values -- The [Scala Native](https://scala-native.readthedocs.io/en/v0.3.9-docs) project lets you write “systems” level code, and also compiles to native executables +- The [Scala Native](https://scala-native.org/) project lets you write “systems” level code, and also compiles to native executables ### Programming level differences diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index d55e6ed619..5b0e8dec91 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -54,7 +54,7 @@ Also at a high level, the _differences_ between Python and Scala are: - Though it’s statically typed, Scala features like type inference make it feel like a dynamic language - Python is interpreted, and Scala code is compiled to _.class_ files, and runs on the Java Virtual Machine (JVM) - In addition to running on the JVM, the [Scala.js](https://www.scala-js.org) project lets you use Scala as a JavaScript replacement -- The [Scala Native](https://scala-native.readthedocs.io/en/v0.3.9-docs) project lets you write “systems” level code, and compiles to native executables +- The [Scala Native](https://scala-native.org/) project lets you write “systems” level code, and compiles to native executables - Everything in Scala is an _expression_: constructs like `if` statements, `for` loops, `match` expressions, and even `try`/`catch` expressions all have return values - Scala idioms favor immutability by default: you’re encouraged to use immutable variables and immutable collections - Scala has excellent support for [concurrent and parallel programming][concurrency] diff --git a/_overviews/scala3-migration/tutorial-prerequisites.md b/_overviews/scala3-migration/tutorial-prerequisites.md index cdd96da785..dabb242834 100644 --- a/_overviews/scala3-migration/tutorial-prerequisites.md +++ b/_overviews/scala3-migration/tutorial-prerequisites.md @@ -101,7 +101,7 @@ addSbtPlugin("org.scala-js" % "sbt-scalajs" % "1.5.0") ### Scala Native -Scala 3 is now supported in Scala Native starting with [v0.4.3](https://scala-native.readthedocs.io/en/latest/changelog/0.4.3.html) +Scala 3 is supported in [Scala Native](https://scala-native.org/) since v0.4.3. The minimal version of Scala 3 supported by Scala Native is 3.1.0, due to fatal blockers in Scala 3.0.x diff --git a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md index e7a74b8757..c94405f479 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md @@ -54,7 +54,7 @@ permalink: "/zh-cn/scala3/book/:title.html" - 作为一种纯 OOP 语言和纯 FP 语言，Scala 鼓励 OOP 和 FP 的融合，具有用于逻辑的函数和用于模块化的不可变对象 - Scala 拥有最先进的第三方开源函数式编程库 - Scala 中的一切都是一个_表达式_：像 `if` 语句、`for` 循环、`match` 表达式，甚至 `try`/`catch` 表达式都有返回值 -- [Scala Native](https://scala-native.readthedocs.io/en/v0.3.9-docs) 项目让您可以编写“系统”级代码，也可以编译为本机可执行文件 +- [Scala Native](https://scala-native.org/) 项目让您可以编写“系统”级代码，也可以编译为本机可执行文件 ### 编程层次差异 diff --git a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md index 2ea3bacf3d..fe53fd6b15 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md @@ -58,7 +58,7 @@ TODO: We should probably go through this document and add links to our other det - 虽然它是静态类型的，但 Scala 的类型推断等特性让它感觉像是一门动态语言 - Python 被解释，Scala 代码被编译成 _.class_ 文件，并在 Java 虚拟机 (JVM) 上运行 - 除了在 JVM 上运行之外，[Scala.js](https://www.scala-js.org) 项目允许您使用 Scala 作为 JavaScript 替代品 -- [Scala Native](https://scala-native.readthedocs.io/en/v0.3.9-docs) 项目可让您编写“系统”级代码，并编译为本机可执行文件 +- [Scala Native](https://scala-native.org/) 项目可让您编写“系统”级代码，并编译为本机可执行文件 - Scala 中的一切都是一个_表达式_：像 `if` 语句、`for` 循环、`match` 表达式，甚至 `try`/`catch` 表达式都有返回值 - Scala 习惯默认不变性：鼓励您使用不可变变量和不可变集合 - Scala 对[并发和并行编程][concurrency]有很好的支持 From 3c619b7931538c8eeab89ade411bd93198754e68 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 18 Oct 2023 08:20:30 -0600 Subject: [PATCH 2726/3075] respond to review feedback --- _overviews/jdk-compatibility/overview.md | 29 ++++++++++-------------- 1 file changed, 12 insertions(+), 17 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index ebed927e53..b19d61a17c 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -10,12 +10,10 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S ## Scala compatibility table -| JDK version | Minimum Scala versions | +| JDK | Minimum Scala versions | |:-----------:|:-------------------------------------------------------------| | 21 (LTS) | 3.3.1, 2.13.11, 2.12.18 | | 20 | 3.3.0, 2.13.11, 2.12.18 | -| 19 | 3.2.0, 2.13.9, 2.12.16 | -| 18 | 3.1.3, 2.13.7, 2.12.15 | | 17 (LTS) | 3.0.0, 2.13.6, 2.12.15 | | 11 (LTS) | 3.0.0, 2.13.0, 2.12.4, 2.11.12 | | 8 (LTS) | 3.0.0, 2.13.0, 2.12.0, 2.11.0 | @@ -28,21 +26,20 @@ Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platfo ## Build tool compatibility table -| JDK version | sbt | -|:-----------:|:----------------| -| 21 (LTS) | 1.9.0 | -| 20 | 1.9.0 | -| 19 | 1.7.0 | -| 18 | 1.6.0 | -| 17 (LTS) | 1.6.0 | -| 11 (LTS) | 1.0.3 | -| 8 (LTS) | 1.0.0 | +Minimum working versions: + +| JDK | sbt | mill | +|:-----------:|:---------------:|:-----------| +| 21 (LTS) | 1.9.0 | 0.11.5 | +| 20 | 1.9.0 | 0.11.0 | +| 17 (LTS) | 1.6.0 | 0.7.0 | +| 11 (LTS) | 1.1.0 | 0.1.5 | +| 8 (LTS) | 1.0.0 | 0.1.0 | Even when a version combination isn't listed as supported, most features might still work. -Using a different build tool, not [sbt](https://www.scala-sbt.org)? -We'd happily accept pull requests adding additional columns to this -table. +Using a different build tool, such as Gradle or Maven? We invite pull +requests adding additional columns to this table. ## Running versus compiling @@ -80,8 +77,6 @@ In general, Scala works on JDK 11+, including GraalVM, but may not take special For example, the Scala compiler does not enforce the restrictions of the Java Platform Module System, which means that code that typechecks may incur linkage errors at runtime. Scala 2.13.x will eventually provide [rudimentary support](https://github.com/scala/scala/pull/7218) for this (perhaps only in nightlies built on JDK 11). -For sbt users, JDK 11 support requires minimum sbt version 1.1.0. sbt 1.3.9 or newer is recommended. (If you are still on the 0.13.x series, use 0.13.18.) - To track progress on JDK 11 related issues in Scala, watch: * the ["Support JDK 11"](https://github.com/scala/scala-dev/issues/139 "scala/scala-dev #139") issue From f2888b92f5d964a0e0f24bdb829008622ad7fa5e Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 18 Oct 2023 08:25:04 -0600 Subject: [PATCH 2727/3075] improve format of top table --- _overviews/jdk-compatibility/overview.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index b19d61a17c..6ce1eb579e 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -10,13 +10,15 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S ## Scala compatibility table -| JDK | Minimum Scala versions | -|:-----------:|:-------------------------------------------------------------| -| 21 (LTS) | 3.3.1, 2.13.11, 2.12.18 | -| 20 | 3.3.0, 2.13.11, 2.12.18 | -| 17 (LTS) | 3.0.0, 2.13.6, 2.12.15 | -| 11 (LTS) | 3.0.0, 2.13.0, 2.12.4, 2.11.12 | -| 8 (LTS) | 3.0.0, 2.13.0, 2.12.0, 2.11.0 | +Minimum Scala versions: + +| JDK | 3 | 2.13 | 2.12 | 2.11 | +|:-----------:|:--------:|:---------:|:---------:|:----------:| +| 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | +| 20 | 3.3.0 | 2.13.11 | 2.12.18 | | +| 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | +| 11 (LTS) | 3.0.0 | 2.13.0 | 2.12.4 | 2.11.12 | +| 8 (LTS) | 3.0.0 | 2.13.0 | 2.12.0 | 2.11.0 | Using latest patch version of Scala is always recommended. From 3f1b869a1b1d19ad591ef63d4e40923d26495c2d Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 18 Oct 2023 10:00:58 -0600 Subject: [PATCH 2728/3075] JDK compat page: add JDK 22 (ea) (#2916) --- _overviews/jdk-compatibility/overview.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 6ce1eb579e..13ee6efc36 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,16 +14,19 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| +| 22 (ea) | 3.3.2* | 2.13.12* | 2.12.19* | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 20 | 3.3.0 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | | 11 (LTS) | 3.0.0 | 2.13.0 | 2.12.4 | 2.11.12 | | 8 (LTS) | 3.0.0 | 2.13.0 | 2.12.0 | 2.11.0 | -Using latest patch version of Scala is always recommended. +* = forthcoming; support available in [nightly builds](https://stackoverflow.com/q/40622878/86485) Even when a version combination isn't listed as supported, most features might still work. +Using latest patch version of Scala is always recommended. + Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platform-subscription) for Scala 2. The linked page includes contact information for inquiring about supported and recommended versions. ## Build tool compatibility table @@ -108,6 +111,16 @@ For sbt users, sbt 1.9.0 is the first version to support JDK 21. For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. +## JDK 22 compatibility notes + +Early access builds of JDK 22 are available. JDK 22 will be non-LTS. + +We are working on adding JDK 22 support to the 2.12.x, 2.13.x, and +3.3.x release series. + +<!-- Initial support for JDK 22 has been merged and is now available in +Scala 3.3.2, 2.13.12, and 2.12.19. --> + ## GraalVM Native Image compatibility notes There are several records of successfully using Scala with [GraalVM](https://www.graalvm.org) Native Image (i.e., ahead of time compiler) to produce directly executable binaries. From 732e5ef270685541f597e71bea8849c94692a10f Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 21 Oct 2023 00:19:44 +0000 Subject: [PATCH 2729/3075] Update SIPs state --- _sips/sips/binary-apis.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/binary-apis.md diff --git a/_sips/sips/binary-apis.md b/_sips/sips/binary-apis.md new file mode 100644 index 0000000000..4381689166 --- /dev/null +++ b/_sips/sips/binary-apis.md @@ -0,0 +1,7 @@ +--- +title: SIP-52 - Binary APIs +status: waiting-for-implementation +pull-request-number: 58 +stage: implementation + +--- From 00e31af7f99e309121668c1fbab041cef715d1c7 Mon Sep 17 00:00:00 2001 From: DespiteDeath <Kogut_nikita@mail.ru> Date: Sat, 21 Oct 2023 18:21:13 +0300 Subject: [PATCH 2730/3075] Rename en Guards to ru (#2917) Co-authored-by: n.kogut <n.kogut@kryptonite.ru> --- _ru/scala3/book/control-structures.md | 4 ++-- _ru/scala3/book/taste-control-structures.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_ru/scala3/book/control-structures.md b/_ru/scala3/book/control-structures.md index fe9c7e4758..41b5e0646f 100644 --- a/_ru/scala3/book/control-structures.md +++ b/_ru/scala3/book/control-structures.md @@ -334,9 +334,9 @@ i = 2, j = b, k = 1 i = 2, j = b, k = 6 ```` -### "Стражники" +### "Ограничители" -Циклы `for` также могут содержать операторы `if`, известные как _стражники_ (_guards_): +Циклы `for` также могут содержать операторы `if`, известные как _ограничители_ (_guards_): {% tabs control-structures-14 class=tabs-scala-version %} {% tab 'Scala 2' for=control-structures-14 %} diff --git a/_ru/scala3/book/taste-control-structures.md b/_ru/scala3/book/taste-control-structures.md index 0a3559fc21..7da0940a4f 100644 --- a/_ru/scala3/book/taste-control-structures.md +++ b/_ru/scala3/book/taste-control-structures.md @@ -117,7 +117,7 @@ for i <- ints do println(i) ### Guards Вы также можете использовать одно или несколько `if` выражений внутри цикла `for`. -Их называют _стражники_ (_guards_). +Их называют _ограничители_ (_guards_). В этом примере выводятся все числа `ints`, большие `2`: {% tabs for-guards class=tabs-scala-version %} From 7df470ae054ba6234ed1c090a2ee51a6dedddba0 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 24 Oct 2023 00:20:32 +0000 Subject: [PATCH 2731/3075] Update SIPs state --- _sips/sips/binary-api.md | 276 ++++++++++++++++++++++++++++++++++++++ _sips/sips/binary-apis.md | 7 - 2 files changed, 276 insertions(+), 7 deletions(-) create mode 100644 _sips/sips/binary-api.md delete mode 100644 _sips/sips/binary-apis.md diff --git a/_sips/sips/binary-api.md b/_sips/sips/binary-api.md new file mode 100644 index 0000000000..5b7ccdd9db --- /dev/null +++ b/_sips/sips/binary-api.md @@ -0,0 +1,276 @@ +--- +layout: sip +permalink: /sips/:title.html +stage: implementation +status: waiting-for-implementation +title: SIP-52 - Binary APIs +--- + +**By: Author Nicolas Stucki** + +## History + +| Date | Version | +|---------------|------------------------| +| Feb 27 2022 | Initial Draft | +| Aug 16 2022 | Single Annotation | +| Aug 24 2022 | Change Annotation Name | + +## Summary + +The purpose of binary APIs is to have publicly accessible definitions in generated bytecode for definitions that are package private or protected. +This proposal introduces the `@publicInBinary` annotation on term definitions and the `-WunstableInlineAccessors` linting flag. + + +## Motivation + +### Provide a sound way to refer to private members in inline definitions + +Currently, the compiler automatically generates accessors for references to private members in inline definitions. This scheme interacts poorly with binary compatibility. It causes the following three unsoundness in the system: +* Changing any definition from private to public is a binary incompatible change +* Changing the implementation of an inline definition can be a binary incompatible change +* Removing final from a class is a binary incompatible change + +You can find more details in [https://github.com/lampepfl/dotty/issues/16983](https://github.com/lampepfl/dotty/issues/16983) + +### Avoid duplication of inline accessors + +Ideally, private definitions should have a maximum of one inline accessor, which is not the case now. +When an inline method accesses a private/protected definition that is defined outside of its class, we generate an inline in the class of the inline method. This implies that accessors might be duplicated if a private/protected definition is accessed from different classes. + +### Removing deprecated APIs + +There is no precise mechanism to remove a deprecated method from a library without causing binary incompatibilities. We should have a straightforward way to indicate that a method is no longer publicly available but still available in the generated code for binary compatibility. + +```diff +- @deprecated(...) def myOldAPI: T = ... ++ private[C] def myOldAPI: T = ... +``` + +Related to discussion in [https://github.com/lightbend/mima/discussions/724](https://github.com/lightbend/mima/discussions/724). + +### No way to inline reference to private constructors + +It is currently impossible to refer to private constructors in inline methods. +```scala +class C private() +object C: + inline def newC: C = new C() // Implementation restriction: cannot use private constructors in inline methods +``` +If users want to access one of those, they must write an accessor explicitly. This extra indirection is undesirable. +```scala +class C private() +object C: + private def newCInternal: C = new C() + inline def newC: C = newCInternal +``` + +## Proposed solution + +### High-level overview + +This proposal introduces the `@publicInBinary` annotation, and adds a migration path to inline methods in libraries (requiring binary compatibility). + +#### `@publicInBinary` annotation + +A binary API is a definition that is annotated with `@publicInBinary` or overrides a definition annotated with `@publicInBinary`. +This annotation can be placed on `def`, `val`, `lazy val`, `var`, `object`, and `given` definitions. +A binary API will be publicly available in the bytecode. + +This annotation cannot be used on `private`/`private[this]` definitions. With the exception of class constructors. + +Removing this annotation from a non-public definition is a binary incompatible change. + +Example: + +~~~ scala +class C { + @publicInBinary private[C] def packagePrivateAPI: Int = ... + @publicInBinary protected def protectedAPI: Int = ... + @publicInBinary def publicAPI: Int = ... // warn: `@publicInBinary` has no effect on public definitions +} +~~~ +will generate the following bytecode signatures +~~~ java +public class C { + public C(); + public int packagePrivateAPI(); + public int protectedAPI(); + public int publicAPI(); +} +~~~ + +In the bytecode, `@publicInBinary` definitions will have the [ACC_PUBLIC](https://docs.oracle.com/javase/specs/jvms/se8/html/jvms-4.html#jvms-4.1-200-E.1) flag. +<!-- We can also set the [ACC_SYNTHETIC](https://docs.oracle.com/javase/specs/jvms/se8/html/jvms-4.html#jvms-4.1-200-E.1) to hide these definitions from javac and java IDEs. --> + +#### Binary API and inlining + +A non-public reference in an inline method is handled as follows: + - if the reference is a `@publicInBinary` the reference is used; + - otherwise, an accessor is automatically generated and used. + +Example: +~~~ scala +import scala.annotation.publicInBinary +class C { + @publicInBinary private[C] def a: Int = ... + private[C] def b: Int = ... + @publicInBinary protected def c: Int = ... + protected def d: Int = ... + inline def foo: Int = a + b + c + d +} +~~~ +before inlining the compiler will generate the accessors for inlined definitions +~~~ scala +class C { + @publicInBinary private[C] def a: Int = ... + private[C] def b: Int = ... + @publicInBinary protected def c: Int = ... + protected def d: Int = ... + final def C$$inline$b: Int = ... + final def C$$inline$d: Int = ... + inline def foo: Int = a + C$$inline$b + c + C$$inline$d +} +~~~ + +##### `-WunstableInlineAccessors` + +In addition we introduce the `-WunstableInlineAccessors` flag to allow libraries to detect when the compiler generates unstable accessors. +The previous code would show a linter warning that looks like this: + +~~~ +-- [E...] Compatibility Warning: C.scala ----------------------------- + | inline def foo: Int = a + b + c + d + | ^ + | Unstable inline accessor C$$inline$b was generated in class C. + | + | longer explanation available when compiling with `-explain` +-- [E...] Compatibility Warning: C.scala ----------------------------- + | inline def foo: Int = a + b + c + d + | ^ + | Unstable inline accessor C$$inline$d was generated in class C. + | + | longer explanation available when compiling with `-explain` +~~~ + +When an accessor is detected we can tell the user how to fix the issue. For example we could use the `-explain` flag to add the following details to the message. + +<details> +<summary>With `-WunstableInlineAccessors -explain`</summary> + +~~~ +-- [E...] Compatibility Warning: C.scala ----------------------------- + | inline def foo: Int = a + b + c + d + | ^ + | Unstable inline accessor C$$inline$b was generated in class C. + |----------------------------------------------------------------------------- + | Explanation (enabled by `-explain`) + |- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + | Access to non-public method b causes the automatic generation of an accessor. + | This accessor is not stable, its name may change or it may disappear + | if not needed in a future version. + | + | To make sure that the inlined code is binary compatible you must make sure that + | method b is public in the binary API. + | * Option 1: Annotate method b with @publicInBinary + | * Option 2: Make method b public + | + | This change may break binary compatibility if a previous version of this + | library was compiled with generated accessors. Binary compatibility should + | be checked using MiMa. If binary compatibility is broken, you should add the + | old accessor explicitly in the source code. The following code should be + | added to class C: + | @publicInBinary private[C] def C$$inline$b: Int = this.b + ----------------------------------------------------------------------------- +-- [E...] Compatibility Warning: C.scala ----------------------------- + | inline def foo: Int = a + b + c + d + | ^ + | Unstable inline accessor C$$inline$d was generated in class C. + |----------------------------------------------------------------------------- + | Explanation (enabled by `-explain`) + |- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + | Access to non-public method d causes the automatic generation of an accessor. + | This accessor is not stable, its name may change or it may disappear + | if not needed in a future version. + | + | To make sure that the inlined code is binary compatible you must make sure that + | method d is public in the binary API. + | * Option 1: Annotate method d with @publicInBinary + | * Option 2: Make method d public + | + | This change may break binary compatibility if a previous version of this + | library was compiled with generated accessors. Binary compatibility should + | be checked using MiMa. If binary compatibility is broken, you should add the + | old accessor explicitly in the source code. The following code should be + | added to class C: + | @publicInBinary private[C] def C$$inline$d: Int = this.d + ----------------------------------------------------------------------------- +~~~ + +</details> + +### Specification + +We must add `publicInBinary` to the standard library. + +```scala +package scala.annotation + +final class publicInBinary extends scala.annotation.StaticAnnotation +``` + +#### `@publicInBinary` annotation + +* Only valid on `def`, `val`, `lazy val`, `var`, `object`, and `given`. +* TASTy will contain references to non-public definitions that are out of scope but `@publicInBinary`. TASTy already allows those references. +* The annotated definitions will be public in the generated bytecode. Definitions should be made public as early as possible in the compiler phases, as this can remove the need to create other accessors. It should be done after we check the accessibility of references. + +#### Inline + +* Inlining will not require the generation of an inline accessor for binary APIs. +* The user will be warned if a new inline accessor is automatically generated under `-WunstableInlineAccessors`. + The message will suggest `@publicInBinary` and how to fix potential incompatibilities. + +### Compatibility + +The introduction of the `@publicInBinary` do not introduce any binary incompatibility. + +Using references to `@publicInBinary` in inline code can cause binary incompatibilities. These incompatibilities are equivalent to the ones that can occur due to the unsoundness we want to fix. When migrating to binary APIs, the compiler will show the implementation of accessors that the users need to add to keep binary compatibility with pre-publicInBinary code. + +### Other concerns + +* Tools that analyze inlined TASTy code will need to know about `@publicInBinary`. For example [MiMa](https://github.com/lightbend/mima/) and [TASTy MiMa](https://github.com/scalacenter/tasty-mima). + +## Alternatives + +### Add a `@binaryAccessor` +This annotation would generate an stable accessor. This annotation could be used on `private` definition. It would also mitigate [migration costs](https://gist.github.com/nicolasstucki/003f7293941836b08a0d53dbcb913e3c) for library authors that have published unstable accessors. + +* Implementation https://github.com/lampepfl/dotty/pull/16992 + + +### Make all `private[C]` part of the binary API + +Currently, we already make `private[C]` public in the binary API but do not have the same guarantees regarding binary compatibility. +For example, the following change is binary compatible but would remove the existence of the `private[C]` definition in the bytecode. +```diff +class C: +- private[C] def f: T = ... +``` +We could change the rules to make all `private[C]` part of binary compatible to flag such a change as binary incompatible. This would imply that all these +methods can be accessed directly from inline methods without generating an accessor. + +The drawback of this approach is that that we would need to force users to keep their `private[C]` methods even if they never used inline methods. + + +## Related work + +* Initial discussions: [https://github.com/lampepfl/dotty/issues/16983](https://github.com/lampepfl/dotty/issues/16983) +* Initial proof of concept (outdated): [https://github.com/lampepfl/dotty/pull/16992](https://github.com/lampepfl/dotty/pull/16992) +* Single annotation proof of concept: [https://github.com/lampepfl/dotty/pull/18402](https://github.com/lampepfl/dotty/pull/18402) +* Community migration analysis: [Gist](https://gist.github.com/nicolasstucki/003f7293941836b08a0d53dbcb913e3c) +* Kotlin: [PublishedApi](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-published-api/) plays the same role as `@publicInBinary` + but its interaction with (inline definitions)[https://kotlinlang.org/docs/inline-functions.html#restrictions-for-public-api-inline-functions] + is stricter as they do not support automatic accessor generation. + +<!-- ## FAQ --> diff --git a/_sips/sips/binary-apis.md b/_sips/sips/binary-apis.md deleted file mode 100644 index 4381689166..0000000000 --- a/_sips/sips/binary-apis.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-52 - Binary APIs -status: waiting-for-implementation -pull-request-number: 58 -stage: implementation - ---- From 5313b7cc9d6be5684e683c17a01db2b06e240618 Mon Sep 17 00:00:00 2001 From: Dongxu Wang <dongxu@apache.org> Date: Tue, 24 Oct 2023 21:02:45 +0800 Subject: [PATCH 2732/3075] Escaping asterisk(forthcoming) (#2918) --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 13ee6efc36..0e95e8cd20 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -21,7 +21,7 @@ Minimum Scala versions: | 11 (LTS) | 3.0.0 | 2.13.0 | 2.12.4 | 2.11.12 | | 8 (LTS) | 3.0.0 | 2.13.0 | 2.12.0 | 2.11.0 | -* = forthcoming; support available in [nightly builds](https://stackoverflow.com/q/40622878/86485) +\* = forthcoming; support available in [nightly builds](https://stackoverflow.com/q/40622878/86485) Even when a version combination isn't listed as supported, most features might still work. From 5af9a271b3985ebcba0deae2adb41d64882b7740 Mon Sep 17 00:00:00 2001 From: Anatolii Kmetiuk <anatoliykmetyuk@gmail.com> Date: Tue, 24 Oct 2023 16:59:04 +0200 Subject: [PATCH 2733/3075] Add SIP results for the past 3 SIP meetings (#2919) * Add SIP results for the past 3 SIP meetings * Update _sips/results/2023-07-21-meeting.md Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> * Update _sips/results/2023-09-11-meeting.md Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> * Update _sips/results/2023-10-20-meeting.md Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> --------- Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> --- _layouts/sip-meeting-results.html | 4 ++++ _sips/results/2023-07-21-meeting.md | 7 +++++++ _sips/results/2023-09-11-meeting.md | 7 +++++++ _sips/results/2023-10-20-meeting.md | 9 +++++++++ 4 files changed, 27 insertions(+) create mode 100644 _sips/results/2023-07-21-meeting.md create mode 100644 _sips/results/2023-09-11-meeting.md create mode 100644 _sips/results/2023-10-20-meeting.md diff --git a/_layouts/sip-meeting-results.html b/_layouts/sip-meeting-results.html index 2850739757..92ef1999f9 100644 --- a/_layouts/sip-meeting-results.html +++ b/_layouts/sip-meeting-results.html @@ -25,3 +25,7 @@ {% endfor %} </tbody> </table> + +<div> + {{content}} +</div> diff --git a/_sips/results/2023-07-21-meeting.md b/_sips/results/2023-07-21-meeting.md new file mode 100644 index 0000000000..6d873e6717 --- /dev/null +++ b/_sips/results/2023-07-21-meeting.md @@ -0,0 +1,7 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 21st July 2023 +partof: results +proposals: [] +--- +No voting was held on this meeting. \ No newline at end of file diff --git a/_sips/results/2023-09-11-meeting.md b/_sips/results/2023-09-11-meeting.md new file mode 100644 index 0000000000..c7231e6d9b --- /dev/null +++ b/_sips/results/2023-09-11-meeting.md @@ -0,0 +1,7 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 11th September 2023 +partof: results +proposals: [] +--- +No voting was held on this meeting. \ No newline at end of file diff --git a/_sips/results/2023-10-20-meeting.md b/_sips/results/2023-10-20-meeting.md new file mode 100644 index 0000000000..33abe5c90a --- /dev/null +++ b/_sips/results/2023-10-20-meeting.md @@ -0,0 +1,9 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 20th October 2023 +partof: results +proposals: + - url: https://docs.scala-lang.org/sips/binary-api.html + name: SIP-52 - Binary APIs + result: accepted +--- From 259fbb1f021f0c3359eeb08c1263021d0bcc4857 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Wed, 25 Oct 2023 00:20:13 +0000 Subject: [PATCH 2734/3075] Update SIPs state --- _sips/sips/pattern-matching-with-named-fields.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_sips/sips/pattern-matching-with-named-fields.md b/_sips/sips/pattern-matching-with-named-fields.md index 924079d9f1..c1c304a61f 100644 --- a/_sips/sips/pattern-matching-with-named-fields.md +++ b/_sips/sips/pattern-matching-with-named-fields.md @@ -1,7 +1,6 @@ --- title: SIP-43 - Pattern matching with named fields -status: under-review +status: withdrawn pull-request-number: 44 -stage: design --- From 2168ef94fdd8157da3e0b7be87afa65b13e648ca Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 27 Oct 2023 20:03:15 +0800 Subject: [PATCH 2735/3075] modified node number of each file. add string-interacting.md --- .../scala3-book/string-interpolation.md | 2 +- .../scala3-book/ca-context-bounds.md | 2 +- .../scala3-book/ca-context-parameters.md | 2 +- .../ca-contextual-abstractions-intro.md | 2 +- .../scala3-book/ca-extension-methods.md | 2 +- .../overviews/scala3-book/ca-given-imports.md | 2 +- .../scala3-book/ca-implicit-conversions.md | 2 +- .../scala3-book/ca-multiversal-equality.md | 2 +- _zh-cn/overviews/scala3-book/ca-summary.md | 2 +- .../overviews/scala3-book/ca-type-classes.md | 2 +- .../scala3-book/collections-classes.md | 2 +- .../scala3-book/collections-intro.md | 2 +- .../scala3-book/collections-methods.md | 2 +- .../scala3-book/collections-summary.md | 2 +- _zh-cn/overviews/scala3-book/concurrency.md | 2 +- .../scala3-book/control-structures.md | 4 +- .../scala3-book/domain-modeling-fp.md | 2 +- .../scala3-book/domain-modeling-intro.md | 4 +- .../scala3-book/domain-modeling-oop.md | 2 +- .../scala3-book/domain-modeling-tools.md | 2 +- .../fp-functional-error-handling.md | 2 +- .../scala3-book/fp-functions-are-values.md | 4 +- .../scala3-book/fp-immutable-values.md | 2 +- _zh-cn/overviews/scala3-book/fp-intro.md | 2 +- .../scala3-book/fp-pure-functions.md | 2 +- _zh-cn/overviews/scala3-book/fp-summary.md | 2 +- _zh-cn/overviews/scala3-book/fp-what-is-fp.md | 2 +- .../scala3-book/fun-anonymous-functions.md | 2 +- .../scala3-book/fun-eta-expansion.md | 2 +- .../scala3-book/fun-function-variables.md | 2 +- _zh-cn/overviews/scala3-book/fun-hofs.md | 2 +- _zh-cn/overviews/scala3-book/fun-intro.md | 2 +- _zh-cn/overviews/scala3-book/fun-summary.md | 2 +- .../scala3-book/fun-write-map-function.md | 2 +- .../fun-write-method-returns-function.md | 2 +- .../scala3-book/interacting-with-java.md | 2 +- _zh-cn/overviews/scala3-book/methods-intro.md | 2 +- .../scala3-book/methods-main-methods.md | 2 +- _zh-cn/overviews/scala3-book/methods-most.md | 2 +- .../overviews/scala3-book/methods-summary.md | 2 +- .../scala3-book/packaging-imports.md | 2 +- .../scala3-book/scala-for-java-devs.md | 2 +- .../scala3-book/scala-for-javascript-devs.md | 2 +- .../scala3-book/scala-for-python-devs.md | 2 +- _zh-cn/overviews/scala3-book/scala-tools.md | 2 +- .../scala3-book/string-interpolation.md | 356 ++++++++++++++++++ _zh-cn/overviews/scala3-book/tools-sbt.md | 2 +- .../overviews/scala3-book/tools-worksheets.md | 2 +- .../overviews/scala3-book/types-adts-gadts.md | 2 +- .../scala3-book/types-dependent-function.md | 2 +- .../overviews/scala3-book/types-generics.md | 2 +- .../overviews/scala3-book/types-inferred.md | 2 +- .../scala3-book/types-intersection.md | 2 +- .../scala3-book/types-introduction.md | 2 +- .../scala3-book/types-opaque-types.md | 2 +- _zh-cn/overviews/scala3-book/types-others.md | 2 +- .../overviews/scala3-book/types-structural.md | 2 +- _zh-cn/overviews/scala3-book/types-union.md | 2 +- .../overviews/scala3-book/types-variance.md | 2 +- _zh-cn/overviews/scala3-book/where-next.md | 2 +- 60 files changed, 417 insertions(+), 63 deletions(-) create mode 100644 _zh-cn/overviews/scala3-book/string-interpolation.md diff --git a/_overviews/scala3-book/string-interpolation.md b/_overviews/scala3-book/string-interpolation.md index cf68d4eafd..2e47a872b1 100644 --- a/_overviews/scala3-book/string-interpolation.md +++ b/_overviews/scala3-book/string-interpolation.md @@ -2,7 +2,7 @@ title: String Interpolation type: chapter description: This page provides more information about creating strings and using string interpolation. -languages: [ru] +languages: [ru, zh-cn] num: 18 previous-page: first-look-at-types next-page: control-structures diff --git a/_zh-cn/overviews/scala3-book/ca-context-bounds.md b/_zh-cn/overviews/scala3-book/ca-context-bounds.md index 9e12eb219b..9e9c84238c 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-bounds.md +++ b/_zh-cn/overviews/scala3-book/ca-context-bounds.md @@ -3,7 +3,7 @@ title: 上下文绑定 type: section description: This page demonstrates Context Bounds in Scala 3. language: zh-cn -num: 61 +num: 62 previous-page: ca-context-parameters next-page: ca-given-imports diff --git a/_zh-cn/overviews/scala3-book/ca-context-parameters.md b/_zh-cn/overviews/scala3-book/ca-context-parameters.md index c562e5d167..3742d36de1 100644 --- a/_zh-cn/overviews/scala3-book/ca-context-parameters.md +++ b/_zh-cn/overviews/scala3-book/ca-context-parameters.md @@ -3,7 +3,7 @@ title: Given 实例和 Using 语句 type: section description: This page demonstrates how to use 'given' instances and 'using' clauses in Scala 3. language: zh-cn -num: 60 +num: 61 previous-page: ca-extension-methods next-page: ca-context-bounds diff --git a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md index d8f0f1a4d6..4b6a82db3b 100644 --- a/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_zh-cn/overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -3,7 +3,7 @@ title: 上下文抽象 type: chapter description: This chapter provides an introduction to the Scala 3 concept of Contextual Abstractions. language: zh-cn -num: 58 +num: 59 previous-page: types-others next-page: ca-extension-methods diff --git a/_zh-cn/overviews/scala3-book/ca-extension-methods.md b/_zh-cn/overviews/scala3-book/ca-extension-methods.md index c0afeaa0bf..be1237733b 100644 --- a/_zh-cn/overviews/scala3-book/ca-extension-methods.md +++ b/_zh-cn/overviews/scala3-book/ca-extension-methods.md @@ -3,7 +3,7 @@ title: 扩展方法 type: section description: This page demonstrates how Extension Methods work in Scala 3. language: zh-cn -num: 59 +num: 60 previous-page: ca-contextual-abstractions-intro next-page: ca-context-parameters diff --git a/_zh-cn/overviews/scala3-book/ca-given-imports.md b/_zh-cn/overviews/scala3-book/ca-given-imports.md index faf1e8569d..ba56af52f0 100644 --- a/_zh-cn/overviews/scala3-book/ca-given-imports.md +++ b/_zh-cn/overviews/scala3-book/ca-given-imports.md @@ -3,7 +3,7 @@ title: Given 导入 type: section description: This page demonstrates how 'given' import statements work in Scala 3. language: zh-cn -num: 62 +num: 63 previous-page: ca-context-bounds next-page: ca-type-classes diff --git a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md index 69a12cba3e..5ab40c8064 100644 --- a/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md +++ b/_zh-cn/overviews/scala3-book/ca-implicit-conversions.md @@ -3,7 +3,7 @@ title: 隐式转换 type: section description: This page demonstrates how to implement Implicit Conversions in Scala 3. language: zh-cn -num: 65 +num: 66 previous-page: ca-multiversal-equality next-page: ca-summary diff --git a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md index aff8f1d53e..9c6d2f422c 100644 --- a/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md +++ b/_zh-cn/overviews/scala3-book/ca-multiversal-equality.md @@ -3,7 +3,7 @@ title: 多元相等性 type: section description: This page demonstrates how to implement Multiversal Equality in Scala 3. language: zh-cn -num: 64 +num: 65 previous-page: ca-type-classes next-page: ca-implicit-conversions diff --git a/_zh-cn/overviews/scala3-book/ca-summary.md b/_zh-cn/overviews/scala3-book/ca-summary.md index c492e8f993..60b1fd01a5 100644 --- a/_zh-cn/overviews/scala3-book/ca-summary.md +++ b/_zh-cn/overviews/scala3-book/ca-summary.md @@ -3,7 +3,7 @@ title: 总结 type: section description: This page provides a summary of the Contextual Abstractions lessons. language: zh-cn -num: 66 +num: 67 previous-page: ca-implicit-conversions next-page: concurrency diff --git a/_zh-cn/overviews/scala3-book/ca-type-classes.md b/_zh-cn/overviews/scala3-book/ca-type-classes.md index 869d104ad5..7adffa0594 100644 --- a/_zh-cn/overviews/scala3-book/ca-type-classes.md +++ b/_zh-cn/overviews/scala3-book/ca-type-classes.md @@ -3,7 +3,7 @@ title: 实现类型类 type: section description: This page demonstrates how to create and use type classes in Scala 3. language: zh-cn -num: 63 +num: 64 previous-page: ca-given-imports next-page: ca-multiversal-equality diff --git a/_zh-cn/overviews/scala3-book/collections-classes.md b/_zh-cn/overviews/scala3-book/collections-classes.md index c102860b53..47ccd58bbe 100644 --- a/_zh-cn/overviews/scala3-book/collections-classes.md +++ b/_zh-cn/overviews/scala3-book/collections-classes.md @@ -3,7 +3,7 @@ title: 集合类型 type: section description: This page introduces the common Scala 3 collections types and some of their methods. language: zh-cn -num: 37 +num: 38 previous-page: collections-intro next-page: collections-methods diff --git a/_zh-cn/overviews/scala3-book/collections-intro.md b/_zh-cn/overviews/scala3-book/collections-intro.md index 6d21b2f59b..0b2e1b77ff 100644 --- a/_zh-cn/overviews/scala3-book/collections-intro.md +++ b/_zh-cn/overviews/scala3-book/collections-intro.md @@ -3,7 +3,7 @@ title: Scala 集合 type: chapter description: This page provides and introduction to the common collections classes and their methods in Scala 3. language: zh-cn -num: 36 +num: 37 previous-page: packaging-imports next-page: collections-classes diff --git a/_zh-cn/overviews/scala3-book/collections-methods.md b/_zh-cn/overviews/scala3-book/collections-methods.md index 47cc4338ae..898619d144 100644 --- a/_zh-cn/overviews/scala3-book/collections-methods.md +++ b/_zh-cn/overviews/scala3-book/collections-methods.md @@ -3,7 +3,7 @@ title: 集合方法 type: section description: This page demonstrates the common methods on the Scala 3 collections classes. language: zh-cn -num: 38 +num: 39 previous-page: collections-classes next-page: collections-summary diff --git a/_zh-cn/overviews/scala3-book/collections-summary.md b/_zh-cn/overviews/scala3-book/collections-summary.md index 465f339f19..8a0c958712 100644 --- a/_zh-cn/overviews/scala3-book/collections-summary.md +++ b/_zh-cn/overviews/scala3-book/collections-summary.md @@ -3,7 +3,7 @@ title: 总结 type: section description: This page provides a summary of the Collections chapter. language: zh-cn -num: 39 +num: 40 previous-page: collections-methods next-page: fp-intro diff --git a/_zh-cn/overviews/scala3-book/concurrency.md b/_zh-cn/overviews/scala3-book/concurrency.md index 1906f158ab..169e1f1684 100644 --- a/_zh-cn/overviews/scala3-book/concurrency.md +++ b/_zh-cn/overviews/scala3-book/concurrency.md @@ -3,7 +3,7 @@ title: 并发 type: chapter description: This page discusses how Scala concurrency works, with an emphasis on Scala Futures. language: zh-cn -num: 67 +num: 68 previous-page: ca-summary next-page: scala-tools diff --git a/_zh-cn/overviews/scala3-book/control-structures.md b/_zh-cn/overviews/scala3-book/control-structures.md index 7babcabc6f..fa46f25a2c 100644 --- a/_zh-cn/overviews/scala3-book/control-structures.md +++ b/_zh-cn/overviews/scala3-book/control-structures.md @@ -3,8 +3,8 @@ title: 控制结构 type: chapter description: This page provides an introduction to Scala's control structures, including if/then/else, 'for' loops, 'for' expressions, 'match' expressions, try/catch/finally, and 'while' loops. language: zh-cn -num: 18 -previous-page: first-look-at-types +num: 19 +previous-page: string-interpolation next-page: domain-modeling-intro partof: scala3-book diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md index 2e500de059..46797dfc7e 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-fp.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-fp.md @@ -3,7 +3,7 @@ title: 函数式领域建模 type: section description: This chapter provides an introduction to FP domain modeling with Scala 3. language: zh-cn -num: 22 +num: 23 previous-page: domain-modeling-oop next-page: methods-intro diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-intro.md b/_zh-cn/overviews/scala3-book/domain-modeling-intro.md index db31d9c528..f2d91f71a3 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-intro.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-intro.md @@ -1,9 +1,7 @@ --- title: 领域建模 -type: chapter description: This chapter provides an introduction to domain modeling in Scala 3. -language: zh-cn -num: 19 +num: 20 previous-page: control-structures next-page: domain-modeling-tools diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md index 48ef014953..0c71a3f65c 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-oop.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-oop.md @@ -3,7 +3,7 @@ title: OOP 领域建模 type: section description: This chapter provides an introduction to OOP domain modeling with Scala 3. language: zh-cn -num: 21 +num: 22 previous-page: domain-modeling-tools next-page: domain-modeling-fp diff --git a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md index b14c9caadb..08aa972f0a 100644 --- a/_zh-cn/overviews/scala3-book/domain-modeling-tools.md +++ b/_zh-cn/overviews/scala3-book/domain-modeling-tools.md @@ -3,7 +3,7 @@ title: 工具 type: section description: This chapter provides an introduction to the available domain modeling tools in Scala 3, including classes, traits, enums, and more. language: zh-cn -num: 20 +num: 21 previous-page: domain-modeling-intro next-page: domain-modeling-oop diff --git a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md index a58c8a463c..b1cce269af 100644 --- a/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md +++ b/_zh-cn/overviews/scala3-book/fp-functional-error-handling.md @@ -3,7 +3,7 @@ title: 函数式错误处理 type: section description: This section provides an introduction to functional error handling in Scala 3. language: zh-cn -num: 45 +num: 46 previous-page: fp-functions-are-values next-page: fp-summary diff --git a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md index a157a8f6d8..5c82bf83c9 100644 --- a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md +++ b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md @@ -3,8 +3,8 @@ title: 函数是值 type: section description: This section looks at the use of functions as values in functional programming. language: zh-cn -num: 44 -previous-page: fp-pure-functions +num: 45 +previors-page: fp-pure-functions next-page: fp-functional-error-handling partof: scala3-book diff --git a/_zh-cn/overviews/scala3-book/fp-immutable-values.md b/_zh-cn/overviews/scala3-book/fp-immutable-values.md index 5e4566bf92..1d6b474daf 100644 --- a/_zh-cn/overviews/scala3-book/fp-immutable-values.md +++ b/_zh-cn/overviews/scala3-book/fp-immutable-values.md @@ -3,7 +3,7 @@ title: 不可变值 type: section description: This section looks at the use of immutable values in functional programming. language: zh-cn -num: 42 +num: 43 previous-page: fp-what-is-fp next-page: fp-pure-functions diff --git a/_zh-cn/overviews/scala3-book/fp-intro.md b/_zh-cn/overviews/scala3-book/fp-intro.md index f0862626d2..8b2563b97b 100644 --- a/_zh-cn/overviews/scala3-book/fp-intro.md +++ b/_zh-cn/overviews/scala3-book/fp-intro.md @@ -3,7 +3,7 @@ title: 函数式编程 type: chapter description: This chapter provides an introduction to functional programming in Scala 3. language: zh-cn -num: 40 +num: 41 previous-page: collections-summary next-page: fp-what-is-fp diff --git a/_zh-cn/overviews/scala3-book/fp-pure-functions.md b/_zh-cn/overviews/scala3-book/fp-pure-functions.md index b987b91275..25fa4398ff 100644 --- a/_zh-cn/overviews/scala3-book/fp-pure-functions.md +++ b/_zh-cn/overviews/scala3-book/fp-pure-functions.md @@ -3,7 +3,7 @@ title: 纯函数 type: section description: This section looks at the use of pure functions in functional programming. language: zh-cn -num: 43 +num: 44 previous-page: fp-immutable-values next-page: fp-functions-are-values diff --git a/_zh-cn/overviews/scala3-book/fp-summary.md b/_zh-cn/overviews/scala3-book/fp-summary.md index f9c4dfce8f..459b2d6f82 100644 --- a/_zh-cn/overviews/scala3-book/fp-summary.md +++ b/_zh-cn/overviews/scala3-book/fp-summary.md @@ -3,7 +3,7 @@ title: 总结 type: section description: This section summarizes the previous functional programming sections. language: zh-cn -num: 46 +num: 47 previous-page: fp-functional-error-handling next-page: types-introduction diff --git a/_zh-cn/overviews/scala3-book/fp-what-is-fp.md b/_zh-cn/overviews/scala3-book/fp-what-is-fp.md index 6411b55c41..79370d450b 100644 --- a/_zh-cn/overviews/scala3-book/fp-what-is-fp.md +++ b/_zh-cn/overviews/scala3-book/fp-what-is-fp.md @@ -3,7 +3,7 @@ title: 什么是函数式编程？ type: section description: This section provides an answer to the question, what is functional programming? language: zh-cn -num: 41 +num: 42 previous-page: fp-intro next-page: fp-immutable-values diff --git a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md index 9b2c3c3dd3..ec08a19e02 100644 --- a/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md +++ b/_zh-cn/overviews/scala3-book/fun-anonymous-functions.md @@ -3,7 +3,7 @@ title: 匿名函数 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. language: zh-cn -num: 28 +num: 29 previous-page: fun-intro next-page: fun-function-variables diff --git a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md index 8e169b4c22..562ed0074e 100644 --- a/_zh-cn/overviews/scala3-book/fun-eta-expansion.md +++ b/_zh-cn/overviews/scala3-book/fun-eta-expansion.md @@ -3,7 +3,7 @@ title: Eta 扩展 type: section description: This page discusses Eta Expansion, the Scala technology that automatically and transparently converts methods into functions. language: zh-cn -num: 30 +num: 31 previous-page: fun-function-variables next-page: fun-hofs diff --git a/_zh-cn/overviews/scala3-book/fun-function-variables.md b/_zh-cn/overviews/scala3-book/fun-function-variables.md index 5df4d07536..e4591ef2ee 100644 --- a/_zh-cn/overviews/scala3-book/fun-function-variables.md +++ b/_zh-cn/overviews/scala3-book/fun-function-variables.md @@ -3,7 +3,7 @@ title: 函数变量 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. language: zh-cn -num: 29 +num: 30 previous-page: fun-anonymous-functions next-page: fun-eta-expansion diff --git a/_zh-cn/overviews/scala3-book/fun-hofs.md b/_zh-cn/overviews/scala3-book/fun-hofs.md index d0fbaa3582..a0fda317b8 100644 --- a/_zh-cn/overviews/scala3-book/fun-hofs.md +++ b/_zh-cn/overviews/scala3-book/fun-hofs.md @@ -3,7 +3,7 @@ title: 高阶函数 type: section description: This page demonstrates how to create and use higher-order functions in Scala. language: zh-cn -num: 31 +num: 32 previous-page: fun-eta-expansion next-page: fun-write-map-function diff --git a/_zh-cn/overviews/scala3-book/fun-intro.md b/_zh-cn/overviews/scala3-book/fun-intro.md index 4bc7aceab3..90d45c4387 100644 --- a/_zh-cn/overviews/scala3-book/fun-intro.md +++ b/_zh-cn/overviews/scala3-book/fun-intro.md @@ -3,7 +3,7 @@ title: 函数 type: chapter description: This chapter looks at all topics related to functions in Scala 3. language: zh-cn -num: 27 +num: 28 previous-page: methods-summary next-page: fun-anonymous-functions diff --git a/_zh-cn/overviews/scala3-book/fun-summary.md b/_zh-cn/overviews/scala3-book/fun-summary.md index f5bcecaaa2..efc747c7ce 100644 --- a/_zh-cn/overviews/scala3-book/fun-summary.md +++ b/_zh-cn/overviews/scala3-book/fun-summary.md @@ -3,7 +3,7 @@ title: 总结 type: section description: This page shows how to use anonymous functions in Scala, including examples with the List class 'map' and 'filter' functions. language: zh-cn -num: 34 +num: 35 previous-page: fun-write-method-returns-function next-page: packaging-imports diff --git a/_zh-cn/overviews/scala3-book/fun-write-map-function.md b/_zh-cn/overviews/scala3-book/fun-write-map-function.md index b3eb86e248..3ba7e44c1b 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-map-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-map-function.md @@ -3,7 +3,7 @@ title: 自定义 map 函数 type: section description: This page demonstrates how to create and use higher-order functions in Scala. language: zh-cn -num: 32 +num: 33 previous-page: fun-hofs next-page: fun-write-method-returns-function diff --git a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md index 25647e6ca5..84e3460b6f 100644 --- a/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md +++ b/_zh-cn/overviews/scala3-book/fun-write-method-returns-function.md @@ -3,7 +3,7 @@ title: 创建可以返回函数的方法 type: section description: This page demonstrates how to create and use higher-order functions in Scala. language: zh-cn -num: 33 +num: 34 previous-page: fun-write-map-function next-page: fun-summary diff --git a/_zh-cn/overviews/scala3-book/interacting-with-java.md b/_zh-cn/overviews/scala3-book/interacting-with-java.md index 12682a9303..f2263d0bd2 100644 --- a/_zh-cn/overviews/scala3-book/interacting-with-java.md +++ b/_zh-cn/overviews/scala3-book/interacting-with-java.md @@ -3,7 +3,7 @@ title: 与 Java 交互 type: chapter description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. language: zh-cn -num: 71 +num: 72 previous-page: tools-worksheets next-page: scala-for-java-devs diff --git a/_zh-cn/overviews/scala3-book/methods-intro.md b/_zh-cn/overviews/scala3-book/methods-intro.md index 4c72c7e549..ec383b437e 100644 --- a/_zh-cn/overviews/scala3-book/methods-intro.md +++ b/_zh-cn/overviews/scala3-book/methods-intro.md @@ -3,7 +3,7 @@ title: 方法 type: chapter description: This section introduces methods in Scala 3. language: zh-cn -num: 23 +num: 24 previous-page: domain-modeling-fp next-page: methods-most diff --git a/_zh-cn/overviews/scala3-book/methods-main-methods.md b/_zh-cn/overviews/scala3-book/methods-main-methods.md index f0b43aab6c..60ffd9c028 100644 --- a/_zh-cn/overviews/scala3-book/methods-main-methods.md +++ b/_zh-cn/overviews/scala3-book/methods-main-methods.md @@ -3,7 +3,7 @@ title: main 方法 type: section description: This page describes how 'main' methods and the '@main' annotation work in Scala 3. language: zh-cn -num: 25 +num: 26 previous-page: methods-most next-page: methods-summary diff --git a/_zh-cn/overviews/scala3-book/methods-most.md b/_zh-cn/overviews/scala3-book/methods-most.md index 08991419b5..86d78f7960 100644 --- a/_zh-cn/overviews/scala3-book/methods-most.md +++ b/_zh-cn/overviews/scala3-book/methods-most.md @@ -3,7 +3,7 @@ title: 方法特性 type: section description: This section introduces Scala 3 methods, including main methods, extension methods, and more. language: zh-cn -num: 24 +num: 25 previous-page: methods-intro next-page: methods-main-methods diff --git a/_zh-cn/overviews/scala3-book/methods-summary.md b/_zh-cn/overviews/scala3-book/methods-summary.md index d406f100c0..472c6230a1 100644 --- a/_zh-cn/overviews/scala3-book/methods-summary.md +++ b/_zh-cn/overviews/scala3-book/methods-summary.md @@ -3,7 +3,7 @@ title: 总结 type: section description: This section summarizes the previous sections on Scala 3 methods. language: zh-cn -num: 26 +num: 27 previous-page: methods-main-methods next-page: fun-intro diff --git a/_zh-cn/overviews/scala3-book/packaging-imports.md b/_zh-cn/overviews/scala3-book/packaging-imports.md index b85798e931..bc928dbe67 100644 --- a/_zh-cn/overviews/scala3-book/packaging-imports.md +++ b/_zh-cn/overviews/scala3-book/packaging-imports.md @@ -3,7 +3,7 @@ title: 打包和导入 type: chapter description: A discussion of using packages and imports to organize your code, build related modules of code, control scope, and help prevent namespace collisions. language: zh-cn -num: 35 +num: 36 previous-page: fun-summary next-page: collections-intro diff --git a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md index dc620ce53f..c0072a95d0 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md @@ -3,7 +3,7 @@ title: 向 Java 开发者介绍Scala type: chapter description: This page is for Java developers who are interested in learning about Scala 3. language: zh-cn -num: 72 +num: 73 previous-page: interacting-with-java next-page: scala-for-javascript-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md index c94405f479..0ec0816eed 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-javascript-devs.md @@ -3,7 +3,7 @@ title: Scala for JavaScript Developers type: chapter description: This chapter provides an introduction to Scala 3 for JavaScript developers language: zh-cn -num: 73 +num: 74 previous-page: scala-for-java-devs next-page: scala-for-python-devs diff --git a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md index fe53fd6b15..618f8de44a 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-python-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-python-devs.md @@ -3,7 +3,7 @@ title: Scala for Python Developers type: chapter description: This page is for Python developers who are interested in learning about Scala 3. language: zh-cn -num: 74 +num: 75 previous-page: scala-for-javascript-devs next-page: where-next diff --git a/_zh-cn/overviews/scala3-book/scala-tools.md b/_zh-cn/overviews/scala3-book/scala-tools.md index d773d0f837..822c3d428a 100644 --- a/_zh-cn/overviews/scala3-book/scala-tools.md +++ b/_zh-cn/overviews/scala3-book/scala-tools.md @@ -3,7 +3,7 @@ title: Scala 工具 type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. language: zh-cn -num: 68 +num: 69 previous-page: concurrency next-page: tools-sbt diff --git a/_zh-cn/overviews/scala3-book/string-interpolation.md b/_zh-cn/overviews/scala3-book/string-interpolation.md new file mode 100644 index 0000000000..79c553b6f1 --- /dev/null +++ b/_zh-cn/overviews/scala3-book/string-interpolation.md @@ -0,0 +1,356 @@ +--- +title: 字符串插值 +type: chapter +description: This page provides more information about creating strings and using 字符串插值. +languages: zh-cn +num: 18 +previous-page: first-look-at-types +next-page: control-structures +redirect_from: + - /overviews/core/string-interpolation.html + +partof: scala3-book +overview-name: "Scala 3 — Book" +layout: multipage-overview +permalink: "/zh-cn/scala3/book/:title.html" +--- + +## 介绍 + +字符串插值提供了一种在字符串中使用变量的方法。 +比如： + +{% tabs example-1 %} +{% tab 'Scala 2 and 3' for=example-1 %} +```scala +val name = "James" +val age = 30 +println(s"$name is $age years old") // "James is 30 years old" +``` +{% endtab %} +{% endtabs %} + +字符串插值由在字符串引号前面的 `s` 和任何有前缀 `$` 的变量组成。 + +### 其它插值 + +把 `s` 放在字符串前，只是 Scala 提供的插值的一种可能。 + +Scala 内置三种字符串插值方法： `s`, `f` 和 raw`. +进一步，字符串插值器只是一种特殊的方法，所以你也可以定义自己的插值器。例如， +有些数据库的函数库定义了 `sql` 插值器，这个插值器可以返回数据库查询。 + +## `s` 插值器 (`s`-字符串) + +在任何字符串字面量加上 `s` 前缀，就可以让你在字符串中直接使用变量。你已经在这里见过这个例子： + +{% tabs example-2 %} +{% tab 'Scala 2 and 3' for=example-2 %} +```scala +val name = "James" +val age = 30 +println(s"$name is $age years old") // "James is 30 years old" +``` +{% endtab %} +{% endtabs %} + +这里字符串中的 `$name` 和 `$age` 占位符相应地被调用 `name.toString` 和 `age.toString` 的结果所替换。 +`s`-字符串可以获取当前作用域的所有变量。 + +虽然这看着很明显，但它很重要，需要在这指出来，字符串插值在普通字符串字面量中_不_起作用： + +{% tabs example-3 %} +{% tab 'Scala 2 and 3' for=example-3 %} +```scala +val name = "James" +val age = 30 +println("$name is $age years old") // "$name is $age years old" +``` +{% endtab %} +{% endtabs %} + +字符串插值器可以使用任何表达式。例如： + +{% tabs example-4 %} +{% tab 'Scala 2 and 3' for=example-4 %} +```scala +println(s"2 + 2 = ${2 + 2}") // "2 + 2 = 4" +val x = -1 +println(s"x.abs = ${x.abs}") // "x.abs = 1" +``` +{% endtab %} +{% endtabs %} + +任何表达式可以嵌入 `${}` 中. + +有些特殊字符在嵌入到字符串内时需要转义。 +当需要显示真实的美元符号时，你可以把美元符号双写 `$$`, 像这样： + +{% tabs example-5 %} +{% tab 'Scala 2 and 3' for=example-5 %} +```scala +println(s"New offers starting at $$14.99") // "New offers starting at $14.99" +``` +{% endtab %} +{% endtabs %} + +双引号一样需要转义。这个可以使用三引号来达到，如下： + +{% tabs example-6 %} +{% tab 'Scala 2 and 3' for=example-6 %} +```scala +println(s"""{"name":"James"}""") // `{"name":"James"}` +``` +{% endtab %} +{% endtabs %} + +最后，可以在所有多行字符串内插值 + +{% tabs example-7 %} +{% tab 'Scala 2 and 3' for=example-7 %} +```scala +println(s"""name: "$name", + |age: $age""".stripMargin) +``` + +This will print as follows: + +``` +name: "James" +age: 30 +``` +{% endtab %} +{% endtabs %} + +## `f` 插值器 (`f`-字符串) + +在任何字符串字面量加上 `f` 前缀，允许你创建简单的格式化字符串，像其它语言中的 `printf`。当使用 `f` 插值器时， +所有变量的引用应该遵循 `printf` 风格的格式化字符串，像 `%d`。让我们看以下例子： + +{% tabs example-8 %} +{% tab 'Scala 2 and 3' for=example-8 %} +```scala +val height = 1.9d +val name = "James" +println(f"$name%s is $height%2.2f meters tall") // "James is 1.90 meters tall" +``` +{% endtab %} +{% endtabs %} + +`f` 插值器是类型安全的。如果你尝试把一个双精度数传递给一个只能处理整数的格式化字符串，编译器会发出一个错误信息。 +例如： + +{% tabs f-inspector-error class=tabs-scala-version %} + +{% tab 'Scala 2' for=f-interpolator-error %} +```scala +val height: Double = 1.9d + +scala> f"$height%4d" +<console>:9: error: type mismatch; + found : Double + required: Int + f"$height%4d" + ^ +``` +{% endtab %} + +{% tab 'Scala 3' for=f-interpolator-error %} +```scala +val height: Double = 1.9d + +scala> f"$height%4d" +-- Error: ---------------------------------------------------------------------- +1 |f"$height%4d" + | ^^^^^^ + | Found: (height : Double), Required: Int, Long, Byte, Short, BigInt +1 error found + +``` +{% endtab %} +{% endtabs %} + +`f` 插值器使用来自 Java 的字符串格式化工具。格式化允许在 `%` 字符后，在[Formatter javadoc][java-format-docs] 中有说明。 +如果没有 `%` 字符在变量之后，那么 `%s` (`String`) 作为缺省的格式化工具。 + +最后，像在 Java 里，使用 `%%` 来让 `%` 字符出现在输出字符中： + +{% tabs literal-percent %} +{% tab 'Scala 2 and 3' for=literal-percent %} +```scala +println(f"3/19 is less than 20%%") // "3/19 is less than 20%" +``` +{% endtab %} +{% endtabs %} + +### `raw` 插值器 + +raw 插值器 和 `s` 插值器很像，除了它不动字符串内的转义符。这里有一个处理字符串的例子： + +{% tabs example-9 %} +{% tab 'Scala 2 and 3' for=example-9 %} +```scala +scala> s"a\nb" +res0: String = +a +b +``` +{% endtab %} +{% endtabs %} + +这里 `s` 字符串插值器把 `\n` 替换成回车字符。`raw` 插值器不会做那些。 + +{% tabs example-10 %} +{% tab 'Scala 2 and 3' for=example-10 %} +```scala +scala> raw"a\nb" +res1: String = a\nb +``` +{% endtab %} +{% endtabs %} + +当你希望避免像 `\n` 这样的表达式转义成回车符，raw 插值器会有用。 + +除了这三种自带的字符串插值器外，你还可以定义自己的插值器。 + +## 高级用法 + +字面量 `s"Hi $name"` 被 Scala 当成 _过程_ 字符串字面量来进行分析。 +这意味着编译器对这个字面量额外做了一些工作。具体的处理后的字符串 +和字符串插入器可以在 [SIP-11][sip-11] 中找到描述，但这里用一个快速的例子来展示它 +是如何工作的。 + +### 定制插值器 + +在 Scala 中，所有被处理过的字符串字面量都是简单的代码转换。任何时候当编译器遇到 +形式如下，处理过的字符串字面量时： + +{% tabs example-11 %} +{% tab 'Scala 2 and 3' for=example-11 %} +```scala +id"string content" +``` +{% endtab %} +{% endtabs %} + +编译器把这段代码转换成 在 [StringContext](https://www.scala-lang.org/api/current/scala/StringContext.html) 实例之上调用 (`id`) 方法. +该方法也在隐式作用域有效。 +为了定义我们自己的字符串插值器，我们需要创建一个 implicit class (Scala 2) 或者一个 `extension` 方法（Scala 3）方法，这样可以把新方法添加到 `StringContext` 中。 + +作为一个小例子，让我们假定 `Point` 类，并假定我们想创建一个定制化的插值器，它把 `p"a,b"` into a 转换成 `Point` 对象。 + +{% tabs custom-interpolator-1 %} +{% tab 'Scala 2 and 3' for=custom-interpolator-1 %} +```scala +case class Point(x: Double, y: Double) + +val pt = p"1,-2" // Point(1.0,-2.0) +``` +{% endtab %} +{% endtabs %} + +我们首先实现一个如下的 `StringContext` 扩展来创建一个定制的 `p`-插值器： + +{% tabs custom-interpolator-2 class=tabs-scala-version %} + +{% tab 'Scala 2' for=custom-interpolator-2 %} +```scala +implicit class PointHelper(val sc: StringContext) extends AnyVal { + def p(args: Any*): Point = ??? +} +``` + +**注意：** 在 Scala 2.x 中重要的一点是继承自 `AnyVal` ，从而防止运行时对每个插值器进行实例化。 +更多内容见 [值类]({% link _overviews/core/value-classes.md %}) 文档。 + +{% endtab %} + +{% tab 'Scala 3' for=custom-interpolator-2 %} +```scala +extension (sc: StringContext) + def p(args: Any*): Point = ??? +``` +{% endtab %} + +{% endtabs %} + +一旦这个扩展在作用域，当 Scala 编译器遇到 `p"some string"` 时，它将 +`some string` 中每一个嵌入到字符串中的变量转换为字符串和表达式参数。 + +例如 `p"1, $someVar"` 将转变成： + +{% tabs extension-desugaring class=tabs-scala-version %} + +{% tab 'Scala 2' for=extension-desugaring %} +```scala +new StringContext("1, ", "").p(someVar) +``` + +隐式类将用来重写成以下的样子： + +```scala +new PointHelper(new StringContext("1, ", "")).p(someVar) +``` +{% endtab %} + +{% tab 'Scala 3' for=extension-desugaring %} +```scala +StringContext("1, ","").p(someVar) +``` + +{% endtab %} + +{% endtabs %} + +作为结果，每一个处理过的字符串片段都暴露在 `StringContext.parts` 成员内，而在字符串中的任何 +表达式的值都传递给该方法的 `args` 参数。 + +### 实现的例子 + +我们这个天真的 Point 插值器方法的实现看着像以下的代码， +但是更复杂的方法可能会用更加精确的控制用于处理字符串 `parts` 和 表达式 `args`, +这样可以替代目前重用 `s`-插值器。 + +{% tabs naive-implementation class=tabs-scala-version %} + +{% tab 'Scala 2' for=naive-implementation %} +```scala +implicit class PointHelper(val sc: StringContext) extends AnyVal { + def p(args: Double*): Point = { + // reuse the `s`-interpolator and then split on ',' + val pts = sc.s(args: _*).split(",", 2).map { _.toDoubleOption.getOrElse(0.0) } + Point(pts(0), pts(1)) + } +} + +val x=12.0 + +p"1, -2" // Point(1.0, -2.0) +p"${x/5}, $x" // Point(2.4, 12.0) +``` +{% endtab %} + +{% tab 'Scala 3' for=naive-implementation %} +```scala +extension (sc: StringContext) + def p(args: Double*): Point = { + // reuse the `s`-interpolator and then split on ',' + val pts = sc.s(args: _*).split(",", 2).map { _.toDoubleOption.getOrElse(0.0) } + Point(pts(0), pts(1)) + } + +val x=12.0 + +p"1, -2" // Point(1.0, -2.0) +p"${x/5}, $x" // Point(2.4, 12.0) +``` +{% endtab %} +{% endtabs %} + +虽然字符串插值器刚开始是用来创建某种字符串形式，但使用上面的定制插值器可以有强大的句法简写， +并且社区已经制造了一些语法便捷的用途，如 ANSI 终端颜色扩展，可执行 SQL 查询，神奇的 +`$"identifier"` 表达，还有更多其它的。 + +[java-format-docs]: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Formatter.html#detail +[值类]: {% link _overviews/core/value-classes.md %} +[sip-11]: {% link _sips/sips/string-interpolation.md %} diff --git a/_zh-cn/overviews/scala3-book/tools-sbt.md b/_zh-cn/overviews/scala3-book/tools-sbt.md index 362de902b4..3d4e78f4a1 100644 --- a/_zh-cn/overviews/scala3-book/tools-sbt.md +++ b/_zh-cn/overviews/scala3-book/tools-sbt.md @@ -3,7 +3,7 @@ title: 使用 sbt 构建和测试 Scala 项目 type: section description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. language: zh-cn -num: 69 +num: 70 previous-page: scala-tools next-page: tools-worksheets diff --git a/_zh-cn/overviews/scala3-book/tools-worksheets.md b/_zh-cn/overviews/scala3-book/tools-worksheets.md index 2e8270c996..214b744d8b 100644 --- a/_zh-cn/overviews/scala3-book/tools-worksheets.md +++ b/_zh-cn/overviews/scala3-book/tools-worksheets.md @@ -3,7 +3,7 @@ title: worksheet type: section description: This section looks at worksheets, an alternative to Scala projects. language: zh-cn -num: 70 +num: 71 previous-page: tools-sbt next-page: interacting-with-java diff --git a/_zh-cn/overviews/scala3-book/types-adts-gadts.md b/_zh-cn/overviews/scala3-book/types-adts-gadts.md index 9d3e469333..4d1604e187 100644 --- a/_zh-cn/overviews/scala3-book/types-adts-gadts.md +++ b/_zh-cn/overviews/scala3-book/types-adts-gadts.md @@ -3,7 +3,7 @@ title: 代数数据类型 type: section description: This section introduces and demonstrates algebraic data types (ADTs) in Scala 3. language: zh-cn -num: 52 +num: 53 previous-page: types-union next-page: types-variance diff --git a/_zh-cn/overviews/scala3-book/types-dependent-function.md b/_zh-cn/overviews/scala3-book/types-dependent-function.md index fa5c8d8c82..37084f1647 100644 --- a/_zh-cn/overviews/scala3-book/types-dependent-function.md +++ b/_zh-cn/overviews/scala3-book/types-dependent-function.md @@ -3,7 +3,7 @@ title: 依赖函数类型 type: section description: This section introduces and demonstrates dependent function types in Scala 3. language: zh-cn -num: 56 +num: 57 previous-page: types-structural next-page: types-others diff --git a/_zh-cn/overviews/scala3-book/types-generics.md b/_zh-cn/overviews/scala3-book/types-generics.md index 8e036c4b77..cdea2a2c4c 100644 --- a/_zh-cn/overviews/scala3-book/types-generics.md +++ b/_zh-cn/overviews/scala3-book/types-generics.md @@ -3,7 +3,7 @@ title: 泛型 type: section description: This section introduces and demonstrates generics in Scala 3. language: zh-cn -num: 49 +num: 50 previous-page: types-inferred next-page: types-intersection diff --git a/_zh-cn/overviews/scala3-book/types-inferred.md b/_zh-cn/overviews/scala3-book/types-inferred.md index b524a03edd..aa6d3faf18 100644 --- a/_zh-cn/overviews/scala3-book/types-inferred.md +++ b/_zh-cn/overviews/scala3-book/types-inferred.md @@ -3,7 +3,7 @@ title: 类型推断 type: section description: This section introduces and demonstrates inferred types in Scala 3 language: zh-cn -num: 48 +num: 49 previous-page: types-introduction next-page: types-generics diff --git a/_zh-cn/overviews/scala3-book/types-intersection.md b/_zh-cn/overviews/scala3-book/types-intersection.md index c61548e163..db1d250a4c 100644 --- a/_zh-cn/overviews/scala3-book/types-intersection.md +++ b/_zh-cn/overviews/scala3-book/types-intersection.md @@ -3,7 +3,7 @@ title: 相交类型 type: section description: This section introduces and demonstrates intersection types in Scala 3. language: zh-cn -num: 50 +num: 51 previous-page: types-generics next-page: types-union diff --git a/_zh-cn/overviews/scala3-book/types-introduction.md b/_zh-cn/overviews/scala3-book/types-introduction.md index e2e4df5b23..dfe1b6b790 100644 --- a/_zh-cn/overviews/scala3-book/types-introduction.md +++ b/_zh-cn/overviews/scala3-book/types-introduction.md @@ -3,7 +3,7 @@ title: 类型和类型系统 type: chapter description: This chapter provides an introduction to Scala 3 types and the type system. language: zh-cn -num: 47 +num: 48 previous-page: fp-summary next-page: types-inferred diff --git a/_zh-cn/overviews/scala3-book/types-opaque-types.md b/_zh-cn/overviews/scala3-book/types-opaque-types.md index f68f798641..c8ba8405f5 100644 --- a/_zh-cn/overviews/scala3-book/types-opaque-types.md +++ b/_zh-cn/overviews/scala3-book/types-opaque-types.md @@ -3,7 +3,7 @@ title: 不透明类型 type: section description: This section introduces and demonstrates opaque types in Scala 3. language: zh-cn -num: 54 +num: 55 previous-page: types-variance next-page: types-structural diff --git a/_zh-cn/overviews/scala3-book/types-others.md b/_zh-cn/overviews/scala3-book/types-others.md index cb09102805..788814ea01 100644 --- a/_zh-cn/overviews/scala3-book/types-others.md +++ b/_zh-cn/overviews/scala3-book/types-others.md @@ -3,7 +3,7 @@ title: 其他类型 type: section description: This section mentions other advanced types in Scala 3. language: zh-cn -num: 57 +num: 58 previous-page: types-dependent-function next-page: ca-contextual-abstractions-intro diff --git a/_zh-cn/overviews/scala3-book/types-structural.md b/_zh-cn/overviews/scala3-book/types-structural.md index 694da0c635..4c12a87901 100644 --- a/_zh-cn/overviews/scala3-book/types-structural.md +++ b/_zh-cn/overviews/scala3-book/types-structural.md @@ -3,7 +3,7 @@ title: 结构化类型 type: section description: This section introduces and demonstrates structural types in Scala 3. language: zh-cn -num: 55 +num: 56 previous-page: types-opaque-types next-page: types-dependent-function diff --git a/_zh-cn/overviews/scala3-book/types-union.md b/_zh-cn/overviews/scala3-book/types-union.md index 51f61590f8..4e1ca79242 100644 --- a/_zh-cn/overviews/scala3-book/types-union.md +++ b/_zh-cn/overviews/scala3-book/types-union.md @@ -3,7 +3,7 @@ title: 联合类型 type: section description: This section introduces and demonstrates union types in Scala 3. language: zh-cn -num: 51 +num: 52 previous-page: types-intersection next-page: types-adts-gadts diff --git a/_zh-cn/overviews/scala3-book/types-variance.md b/_zh-cn/overviews/scala3-book/types-variance.md index d6a682b404..3c774c1d52 100644 --- a/_zh-cn/overviews/scala3-book/types-variance.md +++ b/_zh-cn/overviews/scala3-book/types-variance.md @@ -3,7 +3,7 @@ title: 型变 type: section description: This section introduces and demonstrates variance in Scala 3. language: zh-cn -num: 53 +num: 54 previous-page: types-adts-gadts next-page: types-opaque-types diff --git a/_zh-cn/overviews/scala3-book/where-next.md b/_zh-cn/overviews/scala3-book/where-next.md index e1d6052b6b..66c3afe639 100644 --- a/_zh-cn/overviews/scala3-book/where-next.md +++ b/_zh-cn/overviews/scala3-book/where-next.md @@ -3,7 +3,7 @@ title: 下一步去哪 type: chapter description: Where to go next after reading the Scala Book language: zh-cn -num: 75 +num: 76 previous-page: scala-for-python-devs next-page: From 084a409206598d8795ccd1783d4f41131d4e8db6 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Fri, 27 Oct 2023 20:48:30 +0800 Subject: [PATCH 2736/3075] correct tab label --- _zh-cn/overviews/scala3-book/string-interpolation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/string-interpolation.md b/_zh-cn/overviews/scala3-book/string-interpolation.md index 79c553b6f1..5458ca9cbf 100644 --- a/_zh-cn/overviews/scala3-book/string-interpolation.md +++ b/_zh-cn/overviews/scala3-book/string-interpolation.md @@ -36,7 +36,7 @@ println(s"$name is $age years old") // "James is 30 years old" 把 `s` 放在字符串前，只是 Scala 提供的插值的一种可能。 -Scala 内置三种字符串插值方法： `s`, `f` 和 raw`. +Scala 内置三种字符串插值方法： `s`, `f` 和 `raw`. 进一步，字符串插值器只是一种特殊的方法，所以你也可以定义自己的插值器。例如， 有些数据库的函数库定义了 `sql` 插值器，这个插值器可以返回数据库查询。 @@ -140,7 +140,7 @@ println(f"$name%s is $height%2.2f meters tall") // "James is 1.90 meters tall" `f` 插值器是类型安全的。如果你尝试把一个双精度数传递给一个只能处理整数的格式化字符串，编译器会发出一个错误信息。 例如： -{% tabs f-inspector-error class=tabs-scala-version %} +{% tabs f-interpolator-error class=tabs-scala-version %} {% tab 'Scala 2' for=f-interpolator-error %} ```scala From 203d90bdb5a4eb200bdc323d08cf41aeb117528c Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sun, 29 Oct 2023 21:37:14 +0800 Subject: [PATCH 2737/3075] correct link for "value-classes" --- _zh-cn/overviews/scala3-book/string-interpolation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/string-interpolation.md b/_zh-cn/overviews/scala3-book/string-interpolation.md index 5458ca9cbf..cbe6f8d2b2 100644 --- a/_zh-cn/overviews/scala3-book/string-interpolation.md +++ b/_zh-cn/overviews/scala3-book/string-interpolation.md @@ -261,7 +261,7 @@ implicit class PointHelper(val sc: StringContext) extends AnyVal { ``` **注意：** 在 Scala 2.x 中重要的一点是继承自 `AnyVal` ，从而防止运行时对每个插值器进行实例化。 -更多内容见 [值类]({% link _overviews/core/value-classes.md %}) 文档。 +更多内容见 [值类][value-classes] 文档。 {% endtab %} @@ -352,5 +352,5 @@ p"${x/5}, $x" // Point(2.4, 12.0) `$"identifier"` 表达，还有更多其它的。 [java-format-docs]: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Formatter.html#detail -[值类]: {% link _overviews/core/value-classes.md %} +[value-classes]: {% link _overviews/core/value-classes.md %} [sip-11]: {% link _sips/sips/string-interpolation.md %} From 009da6aa0cb92c46c5616479ccee583c2a68c6ec Mon Sep 17 00:00:00 2001 From: adpi2 <adrien.piquerez@gmail.com> Date: Tue, 31 Oct 2023 13:15:46 +0100 Subject: [PATCH 2738/3075] Fix typo in variances.md (#2922) We need the `new` keyword to create an anonymous class --- _tour/variances.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/variances.md b/_tour/variances.md index 7040a9caef..87fc6029a2 100644 --- a/_tour/variances.md +++ b/_tour/variances.md @@ -180,7 +180,7 @@ catSerializer.serialize(Cat("Felix")) abstract class Serializer[-A]: def serialize(a: A): String -val animalSerializer: Serializer[Animal] = Serializer[Animal](): +val animalSerializer: Serializer[Animal] = new Serializer[Animal](): def serialize(animal: Animal): String = s"""{ "name": "${animal.name}" }""" val catSerializer: Serializer[Cat] = animalSerializer From dfd8e4c6b1b4732027c894e43fc29b6cc8db4ba9 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Tue, 31 Oct 2023 08:15:18 -0700 Subject: [PATCH 2739/3075] Update books page (add Horstmann, update FPiS, reshuffle) (#2921) * add Scala for the Impatient back to the books page it used to be there, but was removed (in #1706) because it had fallen out of date. but there's a Scala 3 edition now. * shorten intro text on books page * books: update FPiS info * remove some outdated info, incidentally fixing 404 * bump bundler version and update Gemfile.lock * review feedback --- Dockerfile | 2 +- Gemfile.lock | 3 ++- _books/3-scala-for-the-impatient.md | 23 ++++++++++++++++++ ...-hands-on-scala.md => 4-hands-on-scala.md} | 0 ...et-programming.bd => 5-get-programming.md} | 0 ...d => 7-functional-programming-in-scala.md} | 12 ++++----- _overviews/compiler-options/optimizer.md | 2 +- books.md | 4 +-- resources/img/books/FPiS_93x116.jpg | Bin 0 -> 5079 bytes resources/img/books/FPiS_93x116.png | Bin 127494 -> 0 bytes .../img/books/scala_for_the_impatient.jpg | Bin 0 -> 108185 bytes .../img/books/scala_for_the_impatient.png | Bin 182723 -> 0 bytes 12 files changed, 34 insertions(+), 12 deletions(-) create mode 100644 _books/3-scala-for-the-impatient.md rename _books/{3-hands-on-scala.md => 4-hands-on-scala.md} (100%) rename _books/{5-get-programming.bd => 5-get-programming.md} (100%) rename _books/{4-functional-programming-in-scala.md => 7-functional-programming-in-scala.md} (64%) create mode 100644 resources/img/books/FPiS_93x116.jpg delete mode 100644 resources/img/books/FPiS_93x116.png create mode 100644 resources/img/books/scala_for_the_impatient.jpg delete mode 100644 resources/img/books/scala_for_the_impatient.png diff --git a/Dockerfile b/Dockerfile index 53f6af08ff..e5ef73f4be 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,6 +1,6 @@ FROM ruby:3.0.5 -RUN gem install bundler:2.4.7 +RUN gem install bundler:2.4.21 WORKDIR /srv/jekyll diff --git a/Gemfile.lock b/Gemfile.lock index 2da20b8237..75c5117a34 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -268,6 +268,7 @@ GEM PLATFORMS arm64-darwin-22 + arm64-darwin-23 x64-mingw-ucrt x86_64-linux @@ -277,4 +278,4 @@ DEPENDENCIES webrick BUNDLED WITH - 2.4.7 + 2.4.21 diff --git a/_books/3-scala-for-the-impatient.md b/_books/3-scala-for-the-impatient.md new file mode 100644 index 0000000000..72c7c01f6d --- /dev/null +++ b/_books/3-scala-for-the-impatient.md @@ -0,0 +1,23 @@ +--- +title: "Scala for the Impatient" +link: https://horstmann.com/scala/ +image: /resources/img/books/scala_for_the_impatient.jpg +status: Updated for Scala 3 +authors: ["Cay Horstmann"] +publisher: Addison-Wesley Professional +publisherLink: https://www.oreilly.com/publisher/addison-wesley-professional/ +--- + +What you get: + +* Up to date coverage of Scala 3 +* A rapid introduction to Scala for programmers who are competent in another language such as Java, C#, Python, JavaScript, or C++ +* Blog-length chunks of information that you can digest quickly +* An organization that you'll find useful as a quick reference + +What you don't get: + +* An introduction into programming or object-oriented design +* Religion about the superiority of one paradigm or another +* Cute or academic examples +* Mind-numbing details about syntax minutiae diff --git a/_books/3-hands-on-scala.md b/_books/4-hands-on-scala.md similarity index 100% rename from _books/3-hands-on-scala.md rename to _books/4-hands-on-scala.md diff --git a/_books/5-get-programming.bd b/_books/5-get-programming.md similarity index 100% rename from _books/5-get-programming.bd rename to _books/5-get-programming.md diff --git a/_books/4-functional-programming-in-scala.md b/_books/7-functional-programming-in-scala.md similarity index 64% rename from _books/4-functional-programming-in-scala.md rename to _books/7-functional-programming-in-scala.md index 27881827ba..0b878c6b15 100644 --- a/_books/4-functional-programming-in-scala.md +++ b/_books/7-functional-programming-in-scala.md @@ -1,15 +1,13 @@ --- title: "Functional Programming in Scala" -link: https://www.manning.com/books/functional-programming-in-scala -image: /resources/img/books/FPiS_93x116.png -status: Covers Scala 2; Scala 3 version in early-access -authors: ["Paul Chiusano", "Rúnar Bjarnason"] +link: https://www.manning.com/books/functional-programming-in-scala-second-edition +image: /resources/img/books/FPiS_93x116.jpg +status: Updated for Scala 3 +authors: ["Michael Pilquist", "Paul Chiusano", "Rúnar Bjarnason"] publisher: Manning publisherLink: https://www.manning.com/ --- "Functional programming (FP) is a style of software development emphasizing functions that don't depend on program state... Functional Programming in Scala is a serious tutorial for programmers looking to learn FP and apply it to the everyday business of coding. The book guides readers from basic techniques to advanced topics in a logical, concise, and clear progression. In it, you'll find concrete examples and exercises that open up the world of functional programming." -Foreword by Martin Odersky. - -The [Scala 3 version](https://www.manning.com/books/functional-programming-in-scala-second-edition), co-authored by Michael Pilquist, is in early-access as of February 2022. +Forewords by Daniel Spiewak and Martin Odersky. diff --git a/_overviews/compiler-options/optimizer.md b/_overviews/compiler-options/optimizer.md index cad7255280..52705558b5 100644 --- a/_overviews/compiler-options/optimizer.md +++ b/_overviews/compiler-options/optimizer.md @@ -28,7 +28,7 @@ The Scala compiler has included an inliner since version 2.0. Closure eliminatio The optimizer was re-written for Scala 2.12 to become more reliable and powerful – and to side-step the spelling issue by calling the new flag `-opt`. This post describes how to use the optimizer in Scala 2.12 and 2.13: what it does, how it works, and what are its limitations. -The options were simplified for 2.13.9, as described here. The [earlier version](https://www.lightbend.com/blog/scala-inliner-optimizer) of this article uses the traditional forms, which are still supported. +The options were simplified for 2.13.9. This page uses the simplified forms. ## Motivation diff --git a/books.md b/books.md index 8e38462300..3e33b863d5 100644 --- a/books.md +++ b/books.md @@ -5,8 +5,8 @@ redirect_from: - /documentation/books.html --- -More and more books being published about Scala every year. Here, you can find -just a small selection of the many available titles. +More books about Scala are published every year. This is +only a selection of the available titles. <br> diff --git a/resources/img/books/FPiS_93x116.jpg b/resources/img/books/FPiS_93x116.jpg new file mode 100644 index 0000000000000000000000000000000000000000..dac8f9d915bc42cb516a1f9f002f897c93f9abda GIT binary patch literal 5079 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 HaZ~>S$Cqz& literal 0 HcmV?d00001 diff --git a/resources/img/books/FPiS_93x116.png b/resources/img/books/FPiS_93x116.png deleted file mode 100644 index c942bd6babbad4028a8b539670166d063f481368..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 127494 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УievpJoCrVnA$=0OY3md!Dq*Ze4;3P6Z=1{%D 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 diff --git a/resources/img/books/scala_for_the_impatient.jpg b/resources/img/books/scala_for_the_impatient.jpg new file mode 100644 index 0000000000000000000000000000000000000000..c1dab910583e025f783ffceb83dba21193195f7e GIT binary patch literal 108185 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 literal 0 HcmV?d00001 diff --git a/resources/img/books/scala_for_the_impatient.png b/resources/img/books/scala_for_the_impatient.png deleted file mode 100644 index 012367038d18ae68f80788b9bfc2d0ad0cdd0e22..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 182723 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%0D;2`9A;10ny=7PGHm=r%U?gg#jH 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 Hu0mjfqq?rA From 168bfc1bab2b4b42e55cabd9a8dabbe6deecea4b Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 13 Nov 2023 22:00:41 +0800 Subject: [PATCH 2740/3075] Update _zh-cn/overviews/scala3-book/string-interpolation.md Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> --- _zh-cn/overviews/scala3-book/string-interpolation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/string-interpolation.md b/_zh-cn/overviews/scala3-book/string-interpolation.md index cbe6f8d2b2..0a594b23cf 100644 --- a/_zh-cn/overviews/scala3-book/string-interpolation.md +++ b/_zh-cn/overviews/scala3-book/string-interpolation.md @@ -7,7 +7,7 @@ num: 18 previous-page: first-look-at-types next-page: control-structures redirect_from: - - /overviews/core/string-interpolation.html + - /zh-cn/overviews/core/string-interpolation.html partof: scala3-book overview-name: "Scala 3 — Book" From 5f6168e8bd75f33df809274ebc1916425731712c Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Thu, 16 Nov 2023 00:21:29 +0000 Subject: [PATCH 2741/3075] Update SIPs state --- _sips/sips/proper-specification-for-match-types.md | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 _sips/sips/proper-specification-for-match-types.md diff --git a/_sips/sips/proper-specification-for-match-types.md b/_sips/sips/proper-specification-for-match-types.md deleted file mode 100644 index 6e5dfe596a..0000000000 --- a/_sips/sips/proper-specification-for-match-types.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-56 - Proper Specification for Match Types. -status: under-review -pull-request-number: 65 -stage: design - ---- From 7810d72121ca26e8be17951657006f9b02eec825 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 20 Nov 2023 06:13:53 +0300 Subject: [PATCH 2742/3075] Add learn.md in ru (#2926) --- _ru/learn.md | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++ learn.md | 1 + 2 files changed, 61 insertions(+) create mode 100644 _ru/learn.md diff --git a/_ru/learn.md b/_ru/learn.md new file mode 100644 index 0000000000..f6834b9fce --- /dev/null +++ b/_ru/learn.md @@ -0,0 +1,60 @@ +--- +title: Online ресурсы +layout: singlepage-overview +language: ru +--- + +## Попробуй Scala в своем браузере! + +Существует несколько веб-сайтов, на которых вы можете интерактивно запускать код Scala в своем браузере! +Взгляните на [Scastie](https://scastie.scala-lang.org/). + +## Онлайн-курсы от Scala Center + +[Scala Center](https://scala.epfl.ch) стремится создавать высококачественные и бесплатные онлайн-курсы +для изучения Scala и функционального программирования. +Уровни курса варьируются от начального до продвинутого. +Более подробная информация доступна [на следующей странице]({% link online-courses.md %}). + +## Упражнения на языке Scala + +[Scala Exercises](https://www.scala-exercises.org/) — это серия уроков и упражнений, созданных [47 Degrees](https://www.47deg.com/). +Это отличный способ получить краткое представление о Scala и одновременно проверить свои знания. + +[Tour of Scala](https://tourofscala.com) шаг за шагом знакомит вас со Scala, от новичка до эксперта. + +## Лекции доктора Mark C Lewis из Trinity University + +[Dr. Mark C Lewis](https://www.cs.trinity.edu/~mlewis/) из Университета Тринити, Сан-Антонио, Техас, +преподает курсы программирования с использованием языка Scala. +Видеокурсы доступны на YouTube бесплатно. Некоторые курсы ниже. + +- [Introduction to Programming and Problem Solving Using Scala](https://www.youtube.com/playlist?list=PLLMXbkbDbVt9MIJ9DV4ps-_trOzWtphYO) +- [Object-Orientation, Abstraction, and Data Structures Using Scala](https://www.youtube.com/playlist?list=PLLMXbkbDbVt8JLumqKj-3BlHmEXPIfR42) + +Вы можете посетить его [YouTube канал](https://www.youtube.com/user/DrMarkCLewis/featured), +чтобы найти больше видео. + +## Сообщество обучения Scala + +[Сообщество по изучению Scala в Discord](http://sca.la/learning-community) — растущее онлайн-сообщество, +объединяющее учащихся с онлайн-ресурсами для совместного изучения Scala. + +## allaboutscala + +[allaboutscala](https://allaboutscala.com/) предоставляет подробные руководства для начинающих. + +## DevInsideYou + +[DevInsideYou](https://youtube.com/devinsideyou) — это YouTube канал с сотнями часов бесплатного контента Scala. + +## Rock the JVM + +[Rock the JVM](https://rockthejvm.com) — это учебная платформа с бесплатными и платными курсами +по языку Scala, Akka, Cats Effect, ZIO, Apache Spark и другим инструментам экосистемы Scala. +Он также содержит сотни [бесплатных видеоуроков](https://youtube.com/rockthejvm) +и [статей](https://blog.rockthejvm.com) по различным темам, связанным со Scala. + +## Visual Scala Reference + +[Visual Scala Reference](https://superruzafa.github.io/visual-scala-reference/) — руководство по визуальному изучению концепций и функций Scala. diff --git a/learn.md b/learn.md index 5c4423c609..baf01b8488 100644 --- a/learn.md +++ b/learn.md @@ -1,6 +1,7 @@ --- title: Online Resources layout: singlepage-overview +languages: [ru] redirect_from: - /documentation/books.html --- From 6842fa0664d08def8d0ea034599f8ec69e776352 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 20 Nov 2023 11:41:03 +0300 Subject: [PATCH 2743/3075] Add tools-sbt.md, tools-worksheets.md in ru (#2925) * Add tools-sbt.md, tools-worksheets.md in ru * Fix the comment. --- _overviews/scala3-book/tools-sbt.md | 2 +- _overviews/scala3-book/tools-worksheets.md | 2 +- _ru/scala3/book/scala-tools.md | 2 +- _ru/scala3/book/tools-sbt.md | 488 +++++++++++++++++++++ _ru/scala3/book/tools-worksheets.md | 63 +++ 5 files changed, 554 insertions(+), 3 deletions(-) create mode 100644 _ru/scala3/book/tools-sbt.md create mode 100644 _ru/scala3/book/tools-worksheets.md diff --git a/_overviews/scala3-book/tools-sbt.md b/_overviews/scala3-book/tools-sbt.md index 8735cbce68..3c442fc962 100644 --- a/_overviews/scala3-book/tools-sbt.md +++ b/_overviews/scala3-book/tools-sbt.md @@ -2,7 +2,7 @@ title: Building and Testing Scala Projects with sbt type: section description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. -languages: [zh-cn] +languages: [ru, zh-cn] num: 70 previous-page: scala-tools next-page: tools-worksheets diff --git a/_overviews/scala3-book/tools-worksheets.md b/_overviews/scala3-book/tools-worksheets.md index 5c8dacf3e5..a1102841ae 100644 --- a/_overviews/scala3-book/tools-worksheets.md +++ b/_overviews/scala3-book/tools-worksheets.md @@ -2,7 +2,7 @@ title: Worksheets type: section description: This section looks at worksheets, an alternative to Scala projects. -languages: [zh-cn] +languages: [ru, zh-cn] num: 71 previous-page: tools-sbt next-page: interacting-with-java diff --git a/_ru/scala3/book/scala-tools.md b/_ru/scala3/book/scala-tools.md index 640a67995d..e58bfb2e64 100644 --- a/_ru/scala3/book/scala-tools.md +++ b/_ru/scala3/book/scala-tools.md @@ -9,7 +9,7 @@ description: В этой главе рассматриваются два шир language: ru num: 69 previous-page: concurrency -next-page: +next-page: tools-sbt --- В этой главе представлены два способа написания и запуска программ в Scala: diff --git a/_ru/scala3/book/tools-sbt.md b/_ru/scala3/book/tools-sbt.md new file mode 100644 index 0000000000..6dd330c28e --- /dev/null +++ b/_ru/scala3/book/tools-sbt.md @@ -0,0 +1,488 @@ +--- +layout: multipage-overview +title: Сборка и тестирование проектов Scala с помощью Sbt +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе рассматриваются широко используемый инструмент сборки sbt и библиотека тестирования ScalaTest. +language: ru +num: 70 +previous-page: scala-tools +next-page: tools-worksheets +--- + +В этом разделе будут показаны два инструмента, которые обычно используются в проектах Scala: + +- инструмент сборки [sbt](https://www.scala-sbt.org) +- [ScalaTest](https://www.scalatest.org) - среда тестирования исходного кода + +Начнем с использования sbt для создания Scala-проектов, а затем рассмотрим, как использовать sbt и ScalaTest вместе для тестирования. + +> Если вы хотите узнать об инструментах, которые помогут вам перенести код Scala 2 на Scala 3, +> ознакомьтесь с нашим [Руководством по миграции на Scala 3](/scala3/guides/migration/compatibility-intro.html). + +## Создание проектов Scala с помощью sbt + +Можно использовать несколько различных инструментов для создания проектов Scala, включая Ant, Maven, Gradle, Mill и другие. +Но инструмент под названием _sbt_ был первым инструментом сборки, специально созданным для Scala. + +> Чтобы установить sbt, см. [страницу загрузки](https://www.scala-sbt.org/download.html) или нашу страницу ["Начало работы"][getting_started]. + +### Создание проекта "Hello, world" + +Вы можете создать sbt проект "Hello, world" всего за несколько шагов. +Сначала создайте каталог для работы и перейдите в него: + +```bash +$ mkdir hello +$ cd hello +``` + +В каталоге `hello` создайте подкаталог `project`: + +```bash +$ mkdir project +``` + +Создайте файл с именем _build.properties_ в каталоге `project` со следующим содержимым: + +```text +sbt.version=1.6.1 +``` + +Затем создайте файл с именем _build.sbt_ в корневом каталоге проекта, содержащий следующую строку: + +```scala +scalaVersion := "{{ site.scala-3-version }}" +``` + +Теперь создайте файл с именем _Hello.scala_ (первая часть имени не имеет значения) со следующей строкой: + +```scala +@main def helloWorld = println("Hello, world") +``` + +Это все, что нужно сделать. + +Должна получиться следующая структура проекта: + +```bash +$ tree +. +├── build.sbt +├── Hello.scala +└── project + └── build.properties +``` + +Теперь запустите проект с помощью команды `sbt`: + +```bash +$ sbt run +``` + +Вы должны увидеть вывод, который выглядит следующим образом, включая `"Hello, world"` из программы: + +```bash +$ sbt run +[info] welcome to sbt 1.6.1 (AdoptOpenJDK Java 11.x) +[info] loading project definition from project ... +[info] loading settings for project from build.sbt ... +[info] compiling 1 Scala source to target/scala-3.0.0/classes ... +[info] running helloWorld +Hello, world +[success] Total time: 2 s +``` + +Программа запуска — средство командной строки `sbt` - загружает версию sbt, установленную в файле _project/build.properties_, +которая загружает версию компилятора Scala, установленную в файле _build.sbt_, +компилирует код в файле _Hello.scala_ и запускает результирующий байт-код. + +Если посмотреть на корневой каталог, то можно увидеть, что появилась папка с именем _target_. +Это рабочие каталоги, которые использует sbt. + +Создание и запуск небольшого проекта Scala с помощью sbt занимает всего несколько простых шагов. + +### Использование sbt в более крупных проектах + +Для небольшого проекта это все, что требует sbt для запуска. +Для более крупных проектов с большим количеством файлов исходного кода, зависимостей или плагинов, +потребуется создать организованную структуру каталогов. +Остальная часть этого раздела демонстрирует структуру, которую использует sbt. + +### Структура каталогов sbt + +Как и Maven, sbt использует стандартную структуру каталогов проекта. +Преимуществом стандартизации является то, что, как только структура станет привычной, +станет легко работать с другими проектами Scala/sbt. + +Первое, что нужно знать - это то, что под корневым каталогом проекта sbt ожидает структуру каталогов, +которая выглядит следующим образом: + +```text +. +├── build.sbt +├── project/ +│ └── build.properties +├── src/ +│ ├── main/ +│ │ ├── java/ +│ │ ├── resources/ +│ │ └── scala/ +│ └── test/ +│ ├── java/ +│ ├── resources/ +│ └── scala/ +└── target/ +``` + +Также в корневой каталог можно добавить каталог _lib_, +если необходимо в свой проект добавить внешние зависимости — файлы JAR. + +Если достаточно создать проект, который имеет только файлы исходного кода Scala и тесты, +но не будет использовать Java файлы и не нуждается в каких-либо "ресурсах" (встроенные изображения, файлы конфигурации и т.д.), +то в каталоге _src_ можно оставить только: + +```text +. +└── src/ + ├── main/ + │ └── scala/ + └── test/ + └── scala/ +``` + +### "Hello, world" со структурой каталогов sbt + +Создать такую структуру каталогов просто. +Существуют инструменты, которые сделают это за вас, но если вы используете систему Unix/Linux, +можно использовать следующие команды для создания структуры каталогов проекта sbt: + +```bash +$ mkdir HelloWorld +$ cd HelloWorld +$ mkdir -p src/{main,test}/scala +$ mkdir project target +``` + +После запуска этих команд, по запросу `find .` вы должны увидеть такой результат: + +```bash +$ find . +. +./project +./src +./src/main +./src/main/scala +./src/test +./src/test/scala +./target +``` + +Если вы это видите, отлично, вы готовы для следующего шага. + +> Существуют и другие способы создания файлов и каталогов для проекта sbt. +> Один из способов - использовать команду sbt new, которая [задокументирована на scala-sbt.org](https://www.scala-sbt.org/1.x/docs/Hello.html). +> Этот подход здесь не показан, поскольку некоторые из создаваемых им файлов более сложны, чем необходимо для такого введения. + +### Создание первого файла build.sbt + +На данный момент нужны еще две вещи для запуска проекта "Hello, world": + +- файл _build.sbt_ +- файл _Hello.scala_ + +Для такого небольшого проекта файлу _build.sbt_ нужна только запись `scalaVersion`, но мы добавим три строки: + +```scala +name := "HelloWorld" +version := "0.1" +scalaVersion := "{{ site.scala-3-version }}" +``` + +Поскольку проекты sbt используют стандартную структуру каталогов, sbt может найти все, что ему нужно. + +Теперь осталось просто добавить небольшую программу "Hello, world". + +### Программа "Hello, world" + +В больших проектах все файлы исходного кода будут находиться в каталогах _src/main/scala_ и _src/test/scala_, +но для небольшого примера, подобного этому, можно поместить файл исходного кода в корневой каталог. +Поэтому создайте файл с именем _HelloWorld.scala_ в корневом каталоге со следующим содержимым: + +```scala +@main def helloWorld = println("Hello, world") +``` + +Этот код определяет "main" метод, который печатает `"Hello, world"` при запуске. + +Теперь используйте команду `sbt run` для компиляции и запуска проекта: + +```bash +$ sbt run + +[info] welcome to sbt +[info] loading settings for project ... +[info] loading project definition +[info] loading settings for project root from build.sbt ... +[info] Compiling 1 Scala source ... +[info] running helloWorld +Hello, world +[success] Total time: 4 s +``` + +При первом запуске `sbt` загружает все, что ему нужно (это может занять несколько секунд), +но после первого раза запуск становится намного быстрее. + +Кроме того, после выполнения первого шага можно обнаружить, что гораздо быстрее запускать sbt в интерактивном режиме. +Для этого вначале отдельно запустите команду `sbt`: + +```bash +$ sbt + +[info] welcome to sbt +[info] loading settings for project ... +[info] loading project definition ... +[info] loading settings for project root from build.sbt ... +[info] sbt server started at + local:///${HOME}/.sbt/1.0/server/7d26bae822c36a31071c/sock +sbt:hello-world> _ +``` + +Затем внутри этой оболочки выполните команду `run`: + +``` +sbt:hello-world> run + +[info] running helloWorld +Hello, world +[success] Total time: 0 s +``` + +Так намного быстрее. + +Если вы наберете `help` в командной строке sbt, то увидите список других команд, доступных для запуска. +Введите `exit` (или нажмите `CTRL-D`), чтобы выйти из оболочки sbt. + +### Использование шаблонов проектов + +Ручное создание структуры проекта может быть утомительным. К счастью, sbt может создать структуру на основе шаблона. + +Чтобы создать проект Scala 3 из шаблона, выполните следующую команду в оболочке: + +``` +$ sbt new scala/scala3.g8 +``` + +Sbt загрузит шаблон, задаст несколько вопросов и создаст файлы проекта в подкаталоге: + +``` +$ tree scala-3-project-template +scala-3-project-template +├── build.sbt +├── project +│ └── build.properties +├── README.md +└── src + ├── main + │ └── scala + │ └── Main.scala + └── test + └── scala + └── Test1.scala +``` + +> Если вы хотите создать проект Scala 3, который кросс-компилируется со Scala 2, используйте шаблон `scala/scala3-cross.g8`: +> +> ``` +> $ sbt new scala/scala3-cross.g8 +> ``` + +Узнайте больше о `sbt new` и шаблонах проектов в [документации sbt](https://www.scala-sbt.org/1.x/docs/sbt-new-and-Templates.html#sbt+new+and+Templates). + +### Другие инструменты сборки для Scala + +Хотя sbt широко используется, есть и другие инструменты, которые можно использовать для создания проектов Scala: + +- [Ant](https://ant.apache.org/) +- [Gradle](https://gradle.org/) +- [Maven](https://maven.apache.org/) +- [Mill](https://com-lihaoyi.github.io/mill/) + +#### Coursier + +[Coursier](https://get-coursier.io/docs/overview) - это "преобразователь зависимостей", похожий по функциям на Maven и Ivy. +Он написан на Scala с нуля, "охватывает принципы функционального программирования" +и для быстроты параллельно загружает артефакты. +sbt использует Coursier для обработки большинства разрешений зависимостей, +а в качестве инструмента командной строки его можно использовать для простой установки таких инструментов, +как sbt, Java и Scala, как показано на странице ["С чего начать?"][getting_started]. + +Этот пример со страницы `launch` показывает, что команда `cs launch` может использоваться для запуска приложений из зависимостей: + +```scala +$ cs launch org.scalameta::scalafmt-cli:2.4.2 -- --help +scalafmt 2.4.2 +Usage: scalafmt [options] [<file>...] + + -h, --help prints this usage text + -v, --version print version + more ... +``` + +Подробнее см. на странице [запуска Coursier](https://get-coursier.io/docs/cli-launch). + +## Использование sbt со ScalaTest + +[ScalaTest](https://www.scalatest.org) — одна из основных библиотек тестирования для проектов Scala. +В этом разделе рассмотрим шаги, необходимые для создания проекта Scala/sbt, использующего ScalaTest. + +### 1) Создание структуры каталогов проекта + +Как и в предыдущем уроке, создаем структуру каталогов sbt для проекта с именем _HelloScalaTest_ с помощью следующих команд: + +```bash +$ mkdir HelloScalaTest +$ cd HelloScalaTest +$ mkdir -p src/{main,test}/scala +$ mkdir project +``` + +### 2) Создание файлов build.properties и build.sbt + +Затем создаем файл _build.properties_ в подкаталоге _project/_ проекта с такой строкой: + +```text +sbt.version=1.5.4 +``` + +Создаем файл _build.sbt_ в корневом каталоге проекта со следующим содержимым: + +```scala +name := "HelloScalaTest" +version := "0.1" +scalaVersion := "{{site.scala-3-version}}" + +libraryDependencies ++= Seq( + "org.scalatest" %% "scalatest" % "3.2.9" % Test +) +``` + +Первые три строки этого файла практически такие же, как и в первом примере. +Строки `libraryDependencies` сообщают sbt о включении зависимостей (файлов JAR), которые необходимы для добавления ScalaTest. + +> Документация по ScalaTest всегда была хорошей, и вы всегда можете найти актуальную информацию о том, +> как должны выглядеть эти строки, на странице ["Установка ScalaTest"](https://www.scalatest.org/install). + +### 3) Создание файла исходного кода Scala + +Затем создаем программу Scala, которую можно использовать для демонстрации ScalaTest. +Сначала создайте каталог в _src/main/scala_ с именем _math_: + +```bash +$ mkdir src/main/scala/math + ---- +``` + +Внутри этого каталога создайте файл _MathUtils.scala_ со следующим содержимым: + +```scala +package math + +object MathUtils: + def double(i: Int) = i * 2 +``` + +Этот метод обеспечивает простой способ демонстрации ScalaTest. + +### 4) Создание первых тестов ScalaTest + +ScalaTest очень гибок и предлагает несколько различных способов написания тестов. +Простой способ начать работу — написать тесты с помощью `AnyFunSuite`. +Для начала создайте каталог с именем _math_ в каталоге _src/test/scala_: + +```bash +$ mkdir src/test/scala/math + ---- +``` + +Затем создайте в этом каталоге файл с именем _MathUtilsTests.scala_ со следующим содержимым: + +```scala +package math + +import org.scalatest.funsuite.AnyFunSuite + +class MathUtilsTests extends AnyFunSuite: + + // test 1 + test("'double' should handle 0") { + val result = MathUtils.double(0) + assert(result == 0) + } + + // test 2 + test("'double' should handle 1") { + val result = MathUtils.double(1) + assert(result == 2) + } + + test("test with Int.MaxValue") (pending) + +end MathUtilsTests +``` + +Этот код демонстрирует `AnyFunSuite` подход. +Несколько важных моментов: + +- тестовый класс должен расширять `AnyFunSuite` +- тесты создаются, задавая каждому `test` уникальное имя +- в конце каждого теста необходимо вызвать `assert`, чтобы проверить, выполнено ли условие +- когда вы знаете, что хотите написать тест, но не хотите писать его прямо сейчас, + создайте тест как "pending" (ожидающий) с показанным синтаксисом + +Подобное использование ScalaTest напоминает JUnit, так что если вы переходите с Java на Scala, это должно показаться знакомым. + +Теперь можно запустить эти тесты с помощью команды `sbt test`. +Пропуская первые несколько строк вывода, результат выглядит следующим образом: + +``` +sbt:HelloScalaTest> test + +[info] Compiling 1 Scala source ... +[info] MathUtilsTests: +[info] - 'double' should handle 0 +[info] - 'double' should handle 1 +[info] - test with Int.MaxValue (pending) +[info] Total number of tests run: 2 +[info] Suites: completed 1, aborted 0 +[info] Tests: succeeded 2, failed 0, canceled 0, ignored 0, pending 1 +[info] All tests passed. +[success] Total time: 1 s +``` + +Если все работает хорошо, вы увидите примерно такой результат. +Добро пожаловать в мир тестирования приложений Scala с помощью sbt и ScalaTest. + +### Поддержка различных видов тестов + +В этом примере демонстрируется стиль тестирования, аналогичный стилю xUnit _Test-Driven Development_ (TDD), +с некоторыми преимуществами _Behavior-Driven Development_ (BDD). + +Как уже упоминалось, ScalaTest является гибким, и вы также можете писать тесты, используя другие стили, +такие как стиль, похожий на RSpec Ruby. +Вы также можете использовать моканные объекты, тестирование на основе свойств +и использовать ScalaTest для тестирования кода Scala.js. + +Дополнительные сведения о различных доступных стилях тестирования +см. в Руководстве пользователя на [веб-сайте ScalaTest](https://www.scalatest.org). + +## Что дальше? + +Дополнительные сведения о sbt и ScalaTest см. в следующих ресурсах: + +- [The sbt documentation](https://www.scala-sbt.org/1.x/docs/) +- [The ScalaTest website](https://www.scalatest.org/) + +[getting_started]: {{ site.baseurl }}/ru/getting-started/index.html diff --git a/_ru/scala3/book/tools-worksheets.md b/_ru/scala3/book/tools-worksheets.md new file mode 100644 index 0000000000..42223f1f39 --- /dev/null +++ b/_ru/scala3/book/tools-worksheets.md @@ -0,0 +1,63 @@ +--- +layout: multipage-overview +title: Рабочие листы +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: section +description: В этом разделе рассматриваются рабочие листы — альтернатива проектам Scala. +language: ru +num: 71 +previous-page: tools-sbt +next-page: +--- + +Worksheet - это файл Scala, который вычисляется при сохранении, +и результат каждого выражения отображается в столбце справа от программы. +Рабочие листы похожи на [сеанс REPL][REPL session] на стероидах +и имеют поддержку редактора 1-го класса: завершение, гиперссылки, интерактивные ошибки при вводе и т.д. +Рабочие листы используют расширение `.worksheet.sc`. + +Далее покажем, как использовать рабочие листы в IntelliJ и в VS Code (с расширением Metals). + +1. Откройте проект Scala или создайте его: + - чтобы создать проект в IntelliJ, выберите "File" -> "New" -> "Project...", + выберите "Scala" в левой колонке и нажмите "Далее", чтобы задать название проекта и каталог. + - чтобы создать проект в VS Code, выполните команду "Metals: New Scala project", + выберите начальный `scala/scala3.g8`, задайте местоположение проекта, + откройте его в новом окне VS Code и импортируйте сборку. +1. Создайте файл с именем `hello.worksheet.sc` в каталоге `src/main/scala/`. + - в IntelliJ щелкните правой кнопкой мыши на каталоге `src/main/scala/` и выберите "New", а затем "File". + - в VS Code щелкните правой кнопкой мыши на каталоге `src/main/scala/` и выберите "New File". +1. Вставьте следующее содержимое в редактор: + + ``` + println("Hello, world!") + + val x = 1 + x + x + ``` + +1. Запустите worksheet: + + - в IntelliJ щелкните зеленую стрелку в верхней части редактора, чтобы запустить worksheet. + - в VS Code сохраните файл. + + Вы должны увидеть результат выполнения каждой строки на правой панели (IntelliJ) или в виде комментариев (VS Code). + +![]({{ site.baseurl }}/resources/images/scala3-book/intellij-worksheet.png) + +Рабочий лист, выполненный в IntelliJ. + +![]({{ site.baseurl }}/resources/images/scala3-book/metals-worksheet.png) + +Рабочий лист, выполненный в VS Code (с расширением Metals). + +Обратите внимание, что worksheet будет использовать версию Scala, +определенную проектом (обычно задается ключом `scalaVersion` в файле `build.sbt`). + +Также обратите внимание, что worksheet не имеют [точек входа в программу][program entry point]. +Вместо этого операторы и выражения верхнего уровня оцениваются сверху вниз. + +[REPL session]: {{ site.baseurl }}/ru/scala3/book/taste-repl.html +[program entry point]: {{ site.baseurl }}/ru/scala3/book/methods-main-methods.html From 2531798f591a221c6453a8548e8c6dc00139466e Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 20 Nov 2023 21:25:43 +0300 Subject: [PATCH 2744/3075] Add online-courses.md in ru (#2927) --- _ru/online-courses.md | 166 ++++++++++++++++++++++++++++++++++++++++++ online-courses.md | 1 + 2 files changed, 167 insertions(+) create mode 100644 _ru/online-courses.md diff --git a/_ru/online-courses.md b/_ru/online-courses.md new file mode 100644 index 0000000000..0d8591ffa2 --- /dev/null +++ b/_ru/online-courses.md @@ -0,0 +1,166 @@ +--- +title: Онлайн курсы (MOOCs) от Scala Center +layout: singlepage-overview +language: ru +testimonials: +- /resources/images/online-courses/testimonial000.jpg +- /resources/images/online-courses/testimonial001.jpg +- /resources/images/online-courses/testimonial002.jpg +- /resources/images/online-courses/testimonial003.jpg +- /resources/images/online-courses/testimonial004.jpg +- /resources/images/online-courses/testimonial005.jpg +- /resources/images/online-courses/testimonial006.jpg +- /resources/images/online-courses/testimonial007.jpg +- /resources/images/online-courses/testimonial008.jpg +- /resources/images/online-courses/testimonial009.jpg +- /resources/images/online-courses/testimonial010.jpg +- /resources/images/online-courses/testimonial011.jpg +- /resources/images/online-courses/testimonial012.jpg +- /resources/images/online-courses/testimonial013.jpg +- /resources/images/online-courses/testimonial014.jpg +--- + +[Scala Center] создает онлайн-курсы (также известные как МООК) различного уровня: от начального до продвинутого. + +**Если вы программист и хотите изучить Scala**, рекомендуется использовать два подхода. +Быстрый путь состоит в прохождении курса ["Эффективное программирование на Scala"](#effective-programming-in-scala). +В противном случае вы можете пройти полную [специализацию Scala][Scala Specialization], +состоящую из четырех курсов (охватывающих сложные темы, такие как анализ больших данных и параллельное программирование) +и завершающего проекта. + +Подробнее о курсах вы можете узнать из следующего видео: + +<div style="text-align: center"> + <iframe width="560" height="315" src="https://www.youtube.com/embed/rRCdnTspE_k" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> +</div> + +## Путь обучения Scala + +На диаграмме ниже показаны возможные пути обучения на наших курсах: + +![](/resources/images/learning-path.png) + +"Базовые" курсы предназначены для программистов без предварительного опыта работы со Scala, +тогда как "углубленные" курсы направлены на укрепление навыков программирования на Scala в конкретной области +(например, параллельном программировании). + +Мы рекомендуем начать с "Эффективного программирования на Scala" (Effective Programming in Scala) +или "Принципов функционального программирования на Scala" (Functional Programming Principles in Scala), +а затем с "Проектирования функциональных программ" (Functional Program Design). +Затем вы можете дополнить свои навыки Scala, +пройдя любой из курсов "Программирование реактивных систем" (Programming Reactive Systems), +"Параллельное программирование" (Parallel Programming) +или "Анализ больших данных с помощью Scala и Spark" (Big Data Analysis with Scala and Spark). +Если вы выберете специализацию Scala, то последним проектом будет Scala Capstone. + +## Учебные платформы + +В настоящее время все наши МООК доступны на платформе [Coursera](https://coursera.org), +а некоторые из них доступны на [edX](https://edx.org) или [Extension School](https://extensionschool.ch). +В этом разделе объясняются различия между этими учебными платформами. + +На всех платформах полный материал всегда доступен онлайн. +Он включает в себя видеолекции, текстовые статьи, опросники и домашние задания с автоматической оценкой. +Все платформы также предоставляют дискуссионные форумы, где вы можете общаться с другими учащимися. + +Отличие Extension School от других платформ заключается в том, +что она проводит живые встречи с инструкторами и обзоры кода экспертами Scala. + +С другой стороны, на Coursera или edX наши курсы можно пройти бесплатно (режим "audit"). +При желании подписка дает вам доступ к сертификату об окончании, подтверждающему ваши результаты. + +Узнайте больше о [сертификатах Coursera](https://learners.coursera.help/hc/en-us/articles/209819053-Get-a-Course-Certificate), +[сертификатах edX](https://support.edx.org/hc/en-us/categories/115002269627-Certificates) +или [сертификатах Extension School](https://www.extensionschool.ch/faqs#certifying-coursework). +Обратите внимание, что ваши подписки также поддерживают работу [Scala Center], +миссией которого является создание качественных учебных материалов. + +Если вы предпочитаете самостоятельное обучение, мы рекомендуем вам выбрать платформу Coursera или edX, +но если вам нужна дополнительная поддержка, рекомендуем вам выбрать Extension School. +Ниже приведена таблица, в которой сравниваются платформы обучения: + +| | Coursera / edX (аудит) | Coursera / edX (подписка) | Extension School | +| ------------------------------------------------ | ---------------------- | ------------------------- | ---------------- | +| Видео-лекции, тесты | Да | Да | Да | +| Домашние задания с автоматической оценкой | Да | Да | Да | +| Дискуссионные форумы | Да | Да | Да | +| Самостоятельный темп | Да | Да | Да | +| Стоимость | $0 | от $50 до $100 за курс | $420 в месяц | +| Сертификат об окончании | Нет | Да | Да | +| Поддерживает Scala Center | Нет | Да | Да | +| 30 минут живого занятия с инструкторами в неделю | Нет | Нет | Да | +| Code reviews экспертами Scala | Нет | Нет | Да | + +## Effective Programming in Scala + +Этот курс доступен на [Coursera](https://coursera.org/learn/effective-scala) и [Extension School](https://extensionschool.ch/learn/effective-programming-in-scala). +Пожалуйста, обратитесь к [этому разделу](#учебные-платформы), чтобы узнать о различиях между обеими учебными платформами. + +["Эффективное программирование на Scala"][Effective Programming in Scala] обучает программистов, не владеющих Scala, +всему, что им нужно для подготовки к работе в Scala. +В конце этого практического курса вы узнаете, как решать общие задачи программирования на Scala +(например, моделирование бизнес-областей, реализацию бизнес-логики, +проектирование больших систем, состоящих из компонентов, +обработку ошибок, обработка данных, параллельное выполнение задач, тестирование вашего кода). +Подробнее об этом курсе вы можете узнать из следующего видео: + +<div style="text-align: center"> + <iframe width="560" height="315" src="https://www.youtube.com/embed/MSDJ7ehjrqo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> +</div> + +Этот курс также является хорошим способом улучшить свои знания Scala 2 до Scala 3. + +После прохождения этого курса вам может быть интересно улучшить свои навыки в конкретных областях, +пройдя курсы ["Параллельное программирование"][Parallel Programming], +["Анализ больших данных с помощью Scala и Spark"][Big Data Analysis with Scala and Spark] +или ["Программирование реактивных систем"][Programming Reactive Systems]. + +## Специализация Scala + +[Специализация Scala][Scala Specialization] обеспечивает практическое введение в функциональное программирование с использованием Scala. +Вы можете получить доступ к материалам и упражнениям курса, зарегистрировавшись на специализацию или прослушав курсы индивидуально. +Специализация состоит из следующих курсов: + +- [Принципы функционального программирования на Scala][Functional Programming Principles in Scala], +- [Функциональный дизайн программ на Scala][Functional Program Design in Scala], +- [Параллельное программирование][Parallel programming], +- [Анализ больших данных с помощью Scala и Spark][Big Data Analysis with Scala and Spark], +- [Функциональное программирование в Scala Capstone][Functional Programming in Scala Capstone]. + +Эти курсы обеспечивают глубокое понимание самого языка Scala, а также погружаются в более конкретные темы, +такие как параллельное программирование и Spark. + +## Программирование реактивных систем + +[Программирование реактивных систем][Programming Reactive Systems] +(также доступно на [edX](https://www.edx.org/course/scala-akka-reactive)) +обучает писать адаптивные, масштабируемые и отказоустойчивые системы с помощью библиотеки Akka. + +## Курсы по Скала 2 + +Все вышеперечисленные курсы используют Scala 3. +При необходимости вы можете найти (устаревшую) версию наших курсов Scala 2 здесь: + +- [Принципы функционального программирования на Scala (версия Scala 2)](https://www.coursera.org/learn/scala2-functional-programming) +- [Функциональный дизайн программ на Scala (версия Scala 2)](https://www.coursera.org/learn/scala2-functional-program-design) +- [Параллельное программирование (версия Scala 2)](https://www.coursera.org/learn/scala2-parallel-programming) +- [Анализ больших данных с помощью Scala и Spark (версия Scala 2)](https://www.coursera.org/learn/scala2-spark-big-data) +- [Программирование реактивных систем (версия Scala 2)](https://www.coursera.org/learn/scala2-akka-reactive) + +## Отзывы + +{% include carousel.html images=page.testimonials number=0 height="50" unit="%" duration="10" %} + +## Другие онлайн-ресурсы + +[На этой странице]({% link learn.md %}) вы можете найти другие онлайн-ресурсы, предоставленные сообществом. + +[Scala Center]: https://scala.epfl.ch +[Scala Specialization]: https://www.coursera.org/specializations/scala +[Effective Programming in Scala]: https://www.coursera.org/learn/effective-scala +[Functional Programming Principles in Scala]: https://www.coursera.org/learn/scala-functional-programming +[Functional Program Design in Scala]: https://www.coursera.org/learn/scala-functional-program-design +[Parallel programming]: https://www.coursera.org/learn/scala-parallel-programming +[Big Data Analysis with Scala and Spark]: https://www.coursera.org/learn/scala-spark-big-data +[Functional Programming in Scala Capstone]: https://www.coursera.org/learn/scala-capstone +[Programming Reactive Systems]: https://www.coursera.org/learn/scala-akka-reactive diff --git a/online-courses.md b/online-courses.md index e7cc17ef89..d31159ef6a 100644 --- a/online-courses.md +++ b/online-courses.md @@ -1,6 +1,7 @@ --- title: Online Courses (MOOCs) from The Scala Center layout: singlepage-overview +languages: [ru] testimonials: - /resources/images/online-courses/testimonial000.jpg - /resources/images/online-courses/testimonial001.jpg From a7f779276d2671535b9b8665948f105726cddc7c Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 22 Nov 2023 18:14:45 -0800 Subject: [PATCH 2745/3075] JDK compat page: 2.13.12 is out (#2928) --- _overviews/jdk-compatibility/overview.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 0e95e8cd20..80e4e50840 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| -| 22 (ea) | 3.3.2* | 2.13.12* | 2.12.19* | | +| 22 (ea) | 3.3.2* | 2.13.12 | 2.12.19* | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 20 | 3.3.0 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | @@ -115,11 +115,11 @@ For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/j Early access builds of JDK 22 are available. JDK 22 will be non-LTS. -We are working on adding JDK 22 support to the 2.12.x, 2.13.x, and -3.3.x release series. +Initial support for JDK 22 has been merged and is now available in +Scala 2.13.12. -<!-- Initial support for JDK 22 has been merged and is now available in -Scala 3.3.2, 2.13.12, and 2.12.19. --> +We are working on adding JDK 22 support to the 2.12.x and 3.3.x +release series. (Support may be available in nightly builds.) ## GraalVM Native Image compatibility notes From c1f9cda834f2ab8fde71a23180ff42f19a263600 Mon Sep 17 00:00:00 2001 From: Oliver Marienfeld <oliver.marienfeld@brandad.de> Date: Sun, 26 Nov 2023 20:08:30 +0100 Subject: [PATCH 2746/3075] Hint at the dark logo filename for -project-logo --- _overviews/scala3-scaladoc/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index 69ca8b5cdb..fe93ad639a 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -32,7 +32,7 @@ The name of the project. To provide compatibility with Scala2 aliases with `-doc The current version of your project that appears in a top left corner. To provide compatibility with Scala2 aliases with `-doc-version` ##### -project-logo -The logo of your project that appears in a top left corner. To provide compatibility with Scala2 aliases with `-doc-logo` +The logo of your project that appears in a top left corner. A separate logo for the dark theme can be provided with the suffix `_dark`. If the logo is, for example, `mylogo.png`, then `mylogo_dark.png` is assumed for the dark theme. To provide compatibility with Scala2 aliases with `-doc-logo` ##### -project-footer The string message that appears in a footer section. To provide compatibility with Scala2 aliases with `-doc-footer` From 207993ba46d8e771e8a2faf49a6d72e1437eba04 Mon Sep 17 00:00:00 2001 From: IZUMIRU <izumiruryousuke@gmail.com> Date: Tue, 28 Nov 2023 01:49:19 +0900 Subject: [PATCH 2747/3075] feat: Add toc scroll --- resources/js/functions.js | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/resources/js/functions.js b/resources/js/functions.js index 322652b95a..c28647c237 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -282,6 +282,10 @@ $(document).ready(function() { autoId: true, numerate: false }); + const target = $('#sidebar-toc .active'); + if (target.length) { + $('#sidebar-toc').scrollTop(target.offset().top); + }; } }); From e2d0fd425bb9b91cb9e69972415e67a952b6594c Mon Sep 17 00:00:00 2001 From: IZUMIRU <izumiruryousuke@gmail.com> Date: Tue, 28 Nov 2023 02:33:57 +0900 Subject: [PATCH 2748/3075] fix: Use animate() and position() --- _sass/layout/toc.scss | 1 + resources/js/functions.js | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/_sass/layout/toc.scss b/_sass/layout/toc.scss index e4e284bd64..73f54dc69f 100644 --- a/_sass/layout/toc.scss +++ b/_sass/layout/toc.scss @@ -28,6 +28,7 @@ .inner-toc { max-height: 60vh; overflow-y: auto; + position: relative; @include bp(large) { max-height: none; diff --git a/resources/js/functions.js b/resources/js/functions.js index c28647c237..747f70f5ef 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -284,7 +284,7 @@ $(document).ready(function() { }); const target = $('#sidebar-toc .active'); if (target.length) { - $('#sidebar-toc').scrollTop(target.offset().top); + $('#sidebar-toc').animate({scrollTop: target.position().top}, 200); }; } }); From 8d3ecf3bccb8f277b07a1920df20305145548553 Mon Sep 17 00:00:00 2001 From: IZUMIRU <izumiruryousuke@gmail.com> Date: Tue, 28 Nov 2023 22:18:49 +0900 Subject: [PATCH 2749/3075] fix: Adjust margin top --- resources/js/functions.js | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/resources/js/functions.js b/resources/js/functions.js index 747f70f5ef..4d7544020f 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -284,7 +284,8 @@ $(document).ready(function() { }); const target = $('#sidebar-toc .active'); if (target.length) { - $('#sidebar-toc').animate({scrollTop: target.position().top}, 200); + const marginTop = 10; + $('#sidebar-toc').animate({scrollTop: target.position().top - marginTop}, 200); }; } }); From 91c7fd700392af92bb78aa4407a20402ffc0d439 Mon Sep 17 00:00:00 2001 From: IZUMIRU <izumiruryousuke@gmail.com> Date: Tue, 28 Nov 2023 22:38:57 +0900 Subject: [PATCH 2750/3075] fix: Apply to book toc --- _includes/sidebar-toc-multipage-overview.html | 2 +- _sass/layout/toc.scss | 9 --------- resources/js/functions.js | 2 +- 3 files changed, 2 insertions(+), 11 deletions(-) diff --git a/_includes/sidebar-toc-multipage-overview.html b/_includes/sidebar-toc-multipage-overview.html index cf614c8da0..4f9d7cb75c 100644 --- a/_includes/sidebar-toc-multipage-overview.html +++ b/_includes/sidebar-toc-multipage-overview.html @@ -1,6 +1,6 @@ {% assign pagetype = page.type %} <div class="content-nav"> - <div class="inner-box sidebar-toc-wrapper {% if pagetype %}book{% endif %}" style=""> + <div class="inner-box sidebar-toc-wrapper" style=""> <h5 class="contents">Contents</h5> {% if pagetype %} <div class="inner-toc book" id="sidebar-toc"> diff --git a/_sass/layout/toc.scss b/_sass/layout/toc.scss index 73f54dc69f..22d9ada330 100644 --- a/_sass/layout/toc.scss +++ b/_sass/layout/toc.scss @@ -15,11 +15,6 @@ display: none; } - // disable floating for the book, since the TOC can become very large - &.book { - position: relative; - } - .contents { font-weight: 700; } @@ -33,10 +28,6 @@ @include bp(large) { max-height: none; } - - &.book { - max-height: none; - } } #toc { diff --git a/resources/js/functions.js b/resources/js/functions.js index 4d7544020f..91b018ef2b 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -284,7 +284,7 @@ $(document).ready(function() { }); const target = $('#sidebar-toc .active'); if (target.length) { - const marginTop = 10; + const marginTop = $('#sidebar-toc').find('.type-chapter').length ? 15 : 10; $('#sidebar-toc').animate({scrollTop: target.position().top - marginTop}, 200); }; } From 2850502428befb7052d54b7144d7350c8bc2732c Mon Sep 17 00:00:00 2001 From: IZUMIRU <izumiruryousuke@gmail.com> Date: Tue, 28 Nov 2023 22:59:03 +0900 Subject: [PATCH 2751/3075] refactor: Change selector --- resources/js/functions.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/resources/js/functions.js b/resources/js/functions.js index 91b018ef2b..ccbf9753ac 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -284,7 +284,7 @@ $(document).ready(function() { }); const target = $('#sidebar-toc .active'); if (target.length) { - const marginTop = $('#sidebar-toc').find('.type-chapter').length ? 15 : 10; + const marginTop = $('#sidebar-toc .type-chapter').length ? 15 : 10; $('#sidebar-toc').animate({scrollTop: target.position().top - marginTop}, 200); }; } From 3ea84c7fbf0470bfb480472c7c9f173e3e30cf20 Mon Sep 17 00:00:00 2001 From: som-snytt <som.snytt@gmail.com> Date: Tue, 28 Nov 2023 14:23:58 -0800 Subject: [PATCH 2752/3075] FAQ for type inference (#2924) --- _overviews/FAQ/index.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 0d6cb2eea7..96c5edd438 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -196,6 +196,22 @@ be written using the `_` syntax. See also [SLS 6.23.2](https://scala-lang.org/files/archive/spec/2.13/06-expressions.html#placeholder-syntax-for-anonymous-functions). +### Why couldn't Scala infer the correct type in my code? + +It is difficult to generalize about type inference, because various features of the language +affect how your code is construed. There may be several ways to rewrite your code to make +the types fall out naturally. + +The most straightforward workaround is to supply explicit types in your code. + +That may involve specifying an explicit type to a definition, or a type argument to a method. + +Type inference is greatly improved in Scala 3. If Scala 2 doesn't compile your code, it's worth trying with Scala 3. + +Sometimes, using multiple parameter lists helps inference, as explained in [this section of the language tour](https://docs.scala-lang.org/tour/multiple-parameter-lists.html#drive-type-inference). + +For common questions about type inference involving `toSet`, see the discussions on [this ticket](https://github.com/scala/bug/issues/7743) and a related [Q&A](https://stackoverflow.com/questions/5544536/in-scala-2-type-inference-fails-on-set-made-with-toset). + ### Can I chain or nest implicit conversions? Not really, but you can [make it work](https://stackoverflow.com/a/5332804). From d958a91d50bb646f4e40207eab825417f15e9fdc Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Mon, 11 Dec 2023 10:31:15 +0000 Subject: [PATCH 2753/3075] Update SIPs state --- _sips/sips/match-types-spec.md | 579 ++++++++++++++++++ ...lace-non-sensical-unchecked-annotations.md | 7 + 2 files changed, 586 insertions(+) create mode 100644 _sips/sips/match-types-spec.md create mode 100644 _sips/sips/replace-non-sensical-unchecked-annotations.md diff --git a/_sips/sips/match-types-spec.md b/_sips/sips/match-types-spec.md new file mode 100644 index 0000000000..ca20238e19 --- /dev/null +++ b/_sips/sips/match-types-spec.md @@ -0,0 +1,579 @@ +--- +layout: sip +permalink: /sips/:title.html +stage: implementation +status: waiting-for-implementation +title: SIP-56 - Proper Specification for Match Types +--- + +**By: Sébastien Doeraene** + +## History + +| Date | Version | +|---------------|--------------------| +| Aug 11th 2023 | Initial Draft | + +## Summary + +Currently, match type reduction is not specified, and its implementation is by nature not specifiable. +This is an issue because match type reduction spans across TASTy files (unlike, for example, type inference or GADTs), which can and will lead to old TASTy files not to be linked again in future versions of the compiler. + +This SIP proposes a proper specification for match types, which does not involve type inference. +It is based on `baseType` computations and subtype tests involving only fully-defined types. +That is future-proof, because `baseType` and subtyping are defined in the specification of the language. + +The proposed specification defines a subset of current match types that are considered legal. +Legal match types use the new, specified reduction rules. +Illegal match types are rejected, which is a breaking change, and can be recovered under `-source:3.3`. + +In addition, the proposal gives a specification for `provablyDisjoint` and for the reduction algorithm. + +## Motivation + +Currently, match type reduction is implementation-defined. +The core of the logic is matching a scrutinee type `X` against a pattern `P` with captures `ts`. +Captures are similar to captures in term-level pattern matching: in the type-level `case List[t] =>`, `t` is a (type) capture, just like in the term-level `case List(x) =>`, `x` is a (term) capture. +Matching works as follows: + +1. we create new type variables for the captures `ts'` giving a pattern `P'`, +2. we ask the compiler's `TypeComparer` (the type inference black box) to "try and make it so" that `X <:< P'`, +3. if it manages to do so, we get constraints for `ts'`; we then have a match, and we instantiate the body of the pattern with the received constraints for `ts`. + +The problem with this approach is that, by essence, type inference is an unspecified black box. +There are *guidelines* about how it should behave in common cases, but no actual guarantee. +This is fine everywhere else in the language, because what type inference comes up with is stored once and for all in TASTy. +When we read TASTy files, we do not have to perform the work of type inference again; we reuse what was already computed. +When a new version of the compiler changes type inference, it does not change what was computed and stored in TASTy files by previous versions of the compiler. + +For match types, this is a problem, because reduction spans across TASTy files. +Given some match type `type M[X] = X match { ... }`, two codebases may refer to `M[SomeType]`, and they must reduce it in the same way. +If they don't, hard incompatibilities can appear, such as broken subtyping, broken overriding relationships, or `AbstractMethodError`s due to inconsistent erasure. + +In order to guarantee compatibility, we must ensure that, for any given match type: + +* if it reduces in a given way in version 1 of the compiler, it still reduces in the same way in version 2, and +* if it does not reduce in version 1 of the compiler, it still does not reduce in version 2. +* (it is possible for version 1 to produce an *error* while version 2 successfully reduces or does not reduce) + +Reduction depends on two decision produces: + +* *matching* a scrutinee `X` against a pattern `P` (which we mentioned above), and +* deciding whether a scrutinee `X` is *provably disjoint* from a pattern `P`. + +When a scrutinee does not match a given pattern and cannot be proven disjoint from it either, the match type is "stuck" and does not reduce. + +If matching is delegated to the `TypeComparer` black box, then it is impossible in practice to guarantee the first compatibility property. + +In addition to the compatibility properties above, there is also a soundness property that we need to uphold: + +* if `X match { ... }` reduces to `R` and `Y <: X`, then `Y match { ... }` also reduces to `R`. + +This requires both that *matching* with a tighter scrutinee gives the same result, and that `provablyDisjoint(X, P)` implies `provablyDisjoint(Y, P)`. +(Those properties must be relaxed when `Y <: Nothing`, in order not to create more problems; see Olivier Blanvillain's thesis section 4.4.2 for details.) +With the existing implementation for `provablyDisjoint`, there are reasonable, non-contrived examples that violate this property. + +In order to solve these problems, this SIP provides a specification for match type reduction that is independent of the `TypeComparer` black box. +It defines a subset of match type cases that are considered legal. +Legal cases get a specification for when and how they should reduce for any scrutinee. +Illegal cases are rejected as being outside of the language. + +For compatibility reasons, such now-illegal cases will still be accepted under `-source:3.3`; in that case, they reduce using the existing, unspecified (and prone to breakage) implementation. +Due to practical reasons (see "Other concerns"), doing so does *not* emit any warning. +Eventually, support for this fallback may be removed if the compiler team decides that its maintenance burden is too high. +As usual, this SIP does not by itself provide any specific timeline. +In particular, there is no relationship with 3.3 being an "LTS"; it just happens to be the latest "Next" as well at the time of this writing (the changes in this SIP will only ever apply to 3.4 onwards, so the LTS is not affected in any way). + +For legal cases, the proposed reduction specification should reduce in the same way as the current implementation for all but the most obscure cases. +Our tests, including the entire dotty CI and its community build, did not surface any such incompatibility. +It is however not possible to guarantee that property for *all* cases, since the existing implementation is not specified in the first place. + +## Proposed solution + +### Specification + +#### Preamble + +Some of the concepts mentioned here are defined in the existing Scala 3 specification draft. +That draft can be found in the dotty repository at https://github.com/lampepfl/dotty/tree/main/docs/_spec. +It is not rendered anywhere yet, though. + +Here are some of the relevant concepts that are perhaps lesser-known: + +* Chapter 3, section "Internal types": concrete v abstract syntax of types. +* Chapter 3, section "Base Type": the `baseType` function. +* Chapter 3, section "Definitions": whether a type is concrete or abstract (unrelated to the concrete or abstract *syntax*). + +#### Syntax + +Syntactically, nothing changes. +The way that a pattern is parsed and type captures identified is kept as is. + +Once type captures are identified, we can represent the *abstract* syntax of a pattern as follows: + +``` +// Top-level pattern +MatchTypePattern ::= TypeWithoutCapture + | MatchTypeAppliedPattern + +// A type that does not contain any capture, such as `Int` or `List[String]` +TypeWithoutCapture ::= Type // `Type` is from the "Internal types" section of the spec + +// Applied type pattern with at least one capture, such as `List[Seq[t]]` or `*:[Int, t]` +MatchTypeAppliedPattern ::= TyconWithoutCapture ‘[‘ MatchTypeSubPattern { ‘,‘ MatchTypeSubPattern } ‘]‘ + +// The type constructor of a MatchTypeAppliedPattern never contains any captures +TyconWithoutCapture ::= Type + +// Type arguments can be captures, types without captures, or nested applied patterns +MatchTypeSubPattern ::= TypeCapture + | TypeWithoutCapture + | MatchTypeAppliedPattern + +TypeCapture ::= NamedTypeCapture // e.g., `t` + | WildcardTypeCapture // `_` (with inferred bounds) +``` + +In the concrete syntax, `MatchTypeAppliedPattern`s can take the form of `InfixType`s. +A common example is `case h *: t =>`, which is desugared into `case *:[h, t] =>`. + +The cases `MatchTypeAppliedPattern` are only chosen if they contain at least one `TypeCapture`. +Otherwise, they are considered `TypeWithoutCapture` instead. +Each named capture appears exactly once. + +#### Legal patterns + +A `MatchTypePattern` is legal if and only if one of the following is true: + +* It is a `TypeWithoutCapture`, or +* It is a `MatchTypeAppliedPattern` with a legal `TyconWithoutCapture` and each of its arguments is either: + * A `TypeCapture`, or + * A `TypeWithoutCapture`, or + * The type constructor is *covariant* in that parameter, and the argument is recursively a legal `MatchTypeAppliedPattern`. + +A `TyconWithoutCapture` is legal if one of the following is true: + +* It is a *class* type constructor, or +* It is the `scala.compiletime.ops.int.S` type constructor, or +* It is an *abstract* type constructor, or +* It is a refined type of the form `Base { type Y = t }` where: + * `Base` is a `TypeWithoutCapture`, + * There exists a type member `Y` in `Base`, and + * `t` is a `TypeCapture`. +* It is a type alias to a type lambda such that: + * Its bounds contain all possible values of its arguments, and + * When applied to the type arguments, it beta-reduces to a new legal `MatchTypeAppliedPattern` that contains exactly one instance of every type capture present in the type arguments. + +#### Examples of legal patterns + +Given the following definitions: + +```scala +class Inv[A] +class Cov[+A] +class Contra[-A] + +class Base { + type Y +} + +type YExtractor[t] = Base { type Y = t } +type ZExtractor[t] = Base { type Z = t } + +type IsSeq[t <: Seq[Any]] = t +``` + +Here are examples of legal patterns: + +```scala +// TypeWithoutCapture's +case Any => // also the desugaring of `case _ =>` when the _ is at the top-level +case Int => +case List[Int] => +case Array[String] => + +// Class type constructors with direct captures +case scala.collection.immutable.List[t] => // not Predef.List; it is a type alias +case Array[t] => +case Contra[t] => +case Either[s, t] => +case Either[s, Contra[Int]] => +case h *: t => +case Int *: t => + +// The S type constructor +case S[n] => + +// An abstract type constructor +// given a [F[_]] or `type F[_] >: L <: H` in scope +case F[t] => + +// Nested captures in covariant position +case Cov[Inv[t]] => +case Cov[Cov[t]] => +case Cov[Contra[t]] => +case Array[h] *: t => // sugar for *:[Array[h], t] +case g *: h *: EmptyTuple => + +// Type aliases +case List[t] => // which is Predef.List, itself defined as `type List[+A] = scala.collection.immutable.List[A]` + +// Refinements (through a type alias) +case YExtractor[t] => +``` + +The following patterns are *not* legal: + +```scala +// Type capture nested two levels below a non-covariant type constructor +case Inv[Cov[t]] => +case Inv[Inv[t]] => +case Contra[Cov[t]] => + +// Type constructor with bounds that do not contain all possible instantiations +case IsSeq[t] => + +// Type refinement where the refined type member is not a member of the parent +case ZExtractor[t] => +``` + +#### Matching + +Given a scrutinee `X` and a match type case `case P => R` with type captures `ts`, matching proceeds in three steps: + +1. Compute instantiations for the type captures `ts'`, and check that they are *specific* enough. +2. If successful, check that `X <:< [ts := ts']P`. +3. If successful, reduce to `[ts := ts']R`. + +The instantiations are computed by the recursive function `matchPattern(X, P, variance, scrutIsWidenedAbstract)`. +At the top level, `variance = 1` and `scrutIsWidenedAbstract = false`. + +`matchPattern` behaves according to what kind is `P`: + +* If `P` is a `TypeWithoutCapture`: + * Do nothing (always succeed). +* If `P` is a `WildcardCapture` `ti = _`: + * If `X` is of the form `_ >: L <: H`, instantiate `ti := H` (anything between `L` and `H` would work here), + * Otherwise, instantiate `ti := X`. +* If `P` is a `TypeCapture` `ti`: + * If `X` is of the form `_ >: L <: H`, + * If `scrutIsWidenedAbstract` is `true`, fail as not specific. + * Otherwise, if `variance = 1`, instantiate `ti := H`. + * Otherwise, if `variance = -1`, instantiate `ti := L`. + * Otherwise, fail as not specific. + * Otherwise, if `variance = 0` or `scrutIsWidenedAbstract` is `false`, instantiate `ti := X`. + * Otherwise, fail as not specific. +* If `P` is a `MatchTypeAppliedPattern` of the form `T[Qs]`: + * Assert: `variance = 1` (from the definition of legal patterns). + * If `T` is a class type constructor of the form `p.C`: + * If `baseType(X, C)` is not defined, fail as not matching. + * Otherwise, it is of the form `q.C[Us]`. + * If `p =:= q` is false, fail as not matching. + * Let `innerScrutIsWidenedAbstract` be true if either `scrutIsWidenedAbstract` or `X` is not a concrete type. + * For each pair of `(Ui, Qi)`, compute `matchPattern(Ui, Qi, vi, innerScrutIsWidenedAbstract)` where `vi` is the variance of the `i`th type parameter of `T`. + * If `T` is `scala.compiletime.ops.int.S`: + * If `n = natValue(X)` is undefined or `n <= 0`, fail as not matching. + * Otherwise, compute `matchPattern(n - 1, Q1, 1, scrutIsWidenedAbstract)`. + * If `T` is an abstract type constructor: + * If `X` is not of the form `F[Us]` or `F =:= T` is false, fail as not matching. + * Otherwise, for each pair of `(Ui, Qi)`, compute `matchPattern(Ui, Qi, vi, scrutIsWidenedAbstract)` where `vi` is the variance of the `i`th type parameter of `T`. + * If `T` is a refined type of the form `Base { type Y = ti }`: + * Let `q` be `X` if `X` is a stable type, or the skolem type `∃α:X` otherwise. + * If `q` does not have a type member `Y`, fail as not matching (that implies that `X <:< Base` is false, because `Base` must have a type member `Y` for the pattern to be legal). + * If `q.Y` is abstract, fail as not specific. + * If `q.Y` is a class member: + * If `q` is a skolem type `∃α:X`, fail as not specific. + * Otherwise, compute `matchPattern(ti, q.Y, 0, scrutIsWidenedAbstract)`. + * Otherwise, the underlying type definition of `q.Y` is of the form `= U`: + * If `q` is a skolem type `∃α:X` and `U` refers to `α`, fail as not specific. + * Otherwise, compute `matchPattern(ti, U, 0, scrutIsWidenedAbstract)`. + * If `T` is a concrete type alias to a type lambda: + * Let `P'` be the beta-reduction of `P`. + * Compute `matchPattern(P', X, variance, scrutIsWidenedAbstract)`. + +#### Disjointness + +This proposal initially did not include a discussion of disjointness. +After initial review, it became apparent that it should also provide a specification for the "provably disjoint" test involved in match type reduction. +Additional study revealed that, while *specifiable*, the current algorithm is very ad hoc and severely lacks desirable properties such as preservation along subtyping (see towards the end of this section). + +Therefore, this proposal now also includes a proposed specification for "provably disjoint". +To the best of our knowledge, it is strictly stronger than what is currently implemented, with one exception. + +The current implementation considers that `{ type A = Int }` is provably disjoint from `{ type A = Boolean }`. +However, it is not able to prove disjointness between any of the following: + +* `{ type A = Int }` and `{ type A = Boolean; type B = String }` (adding another type member) +* `{ type A = Int; type B = Int }` and `{ type B = String; type A = String }` (switching the order of type members) +* `{ type A = Int }` and class `C` that defines a member `type A = String`. + +Therefore, we drop the very ad hoc case of one-to-one type member refinements. + +On to the specification. + +A scrutinee `X` is *provably disjoint* from a pattern `P` iff it is provably disjoint from the type `P'` obtained by replacing every type capture in `P` by a wildcard type argument with the same bounds. + +We note `X ⋔ Y` to say that `X` and `Y` are provably disjoint. +Intuitively, that notion is based on the following properties of the Scala language: + +* Single inheritance of classes +* Final classes cannot be extended +* Sealed traits have a known set of direct children +* Constant types with distinct values are nonintersecting +* Singleton paths to distinct `enum` case values are nonintersecting + +However, a precise definition of provably-disjoint is complicated and requires some helpers. +We start with the notion of "simple types", which are a minimal subset of Scala types that capture the concepts mentioned above. + +A "simple type" is one of: + +* `Nothing` +* `AnyKind` +* `p.C[...Xi]` a possibly parameterized class type, where `p` and `...Xi` are arbitrary types (not just simple types) +* `c` a literal type +* `p.C.x` where `C` is an `enum` class and `x` is one of its value `case`s +* `X₁ & X₂` where `X₁` and `X₂` are both simple types +* `X₁ | X₂` where `X₁` and `X₂` are both simple types +* `[...ai] =>> X₁` where `X₁` is a simple type + +We define `⌈X⌉` a function from a full Scala type to a simple type. +Intuitively, it returns the "smallest" simple type that is a supertype of `X`. +It is defined as follows: + +* `⌈X⌉ = X` if `X` is a simple type +* `⌈X⌉ = ⌈U⌉` if `X` is a stable type but not a simple type and its underlying type is `U` +* `⌈X⌉ = ⌈H⌉` if `X` is a non-class type designator with upper bound `H` +* `⌈X⌉ = ⌈η(X)⌉` if `X` is a polymorphic class type designator, where `η(X)` is its eta-expansion +* `⌈X⌉ = ⌈Y⌉` if `X` is a match type that reduces to `Y` +* `⌈X⌉ = ⌈H⌉` if `X` is a match type that does not reduce and `H` is its upper bound +* `⌈X[...Ti]⌉ = ⌈Y⌉` where `Y` is the beta-reduction of `X[...Ti]` if `X` is a type lambda +* `⌈X[...Ti]⌉ = ⌈⌈X⌉[...Ti⌉` if `X` is neither a type lambda nor a class type designator +* `⌈X @a⌉ = ⌈X⌉` +* `⌈X { R }⌉ = ⌈X⌉` +* `⌈{ α => X } = ⌈X⌉⌉` +* `⌈X₁ & X₂⌉ = ⌈X₁⌉ & ⌈X₂⌉` +* `⌈X₁ | X₂⌉ = ⌈X₁⌉ | ⌈X₂⌉` +* `⌈[...ai] =>> X₁⌉ = [...ai] =>> ⌈X₁⌉` + +The following properties hold about `⌈X⌉` (we have paper proofs for those): + +* `X <: ⌈X⌉` for all type `X`. +* If `S <: T`, and the subtyping derivation does not use the "lower-bound rule" of `<:` anywhere, then `⌈S⌉ <: ⌈T⌉`. + +The "lower-bound rule" states that `S <: T` if `T = q.X `and `q.X` is a non-class type designator and `S <: L` where `L` is the lower bound of the underlying type definition of `q.X`". +That rule is known to break transitivy of subtyping in Scala already. + +Second, we define the relation `⋔` on *classes* (including traits and hidden classes of objects) as: + +* `C ⋔ D` if `C ∉ baseClasses(D)` and `D` is `final` +* `C ⋔ D` if `D ∉ baseClasses(C)` and `C` is `final` +* `C ⋔ D` if there exists `class`es `C' ∈ baseClasses(C)` and `D' ∈ baseClasses(D)` such that `C' ∉ baseClasses(D')` and `D' ∉ baseClasses(C')`. +* `C ⋔ D` if `C` is `sealed` without anonymous child and `Ci ⋔ D` for all direct children `Ci` of `C` +* `C ⋔ D` if `D` is `sealed` without anonymous child and `C ⋔ Di` for all direct children `Di` of `D` + +We can now define `⋔` for *types*. + +For arbitrary types `X` and `Y`, we define `X ⋔ Y` as `⌈X⌉ ⋔ ⌈Y⌉`. + +Two simple types `S` and `T` are provably disjoint if there is a finite derivation tree for `S ⋔ T` using the following rules. +Most rules go by pair, which makes the whole relation symmetric: + +* `Nothing` is disjoint from everything (including itself): + * `Nothing ⋔ T` + * `S ⋔ Nothing` +* A union type is disjoint from another type if both of its parts are disjoint from that type: + * `S ⋔ T1 | T2` if `S ⋔ T1` and `S ⋔ T2` + * `S1 | S2 ⋔ T` if `S1 ⋔ T` and `S2 ⋔ T` +* An intersection type is disjoint from another type if at least one of its parts is disjoint from that type: + * `S ⋔ T1 & T2` if `S ⋔ T1` or `S ⋔ T2` + * `S1 & S2 ⋔ T` if `S1 ⋔ T` or `S1 ⋔ T` +* A type lambda is disjoint from any other type that is not a type lambda with the same number of parameters: + * `[...ai] =>> S1 ⋔ q.D.y` + * `[...ai] =>> S1 ⋔ d` + * `[...ai] =>> S1 ⋔ q.D[...Ti]` + * `p.C.x ⋔ [...bi] =>> T1` + * `c ⋔ [...bi] =>> T1` + * `p.C[...Si] ⋔ [...bi] =>> T1` + * `[a1, ..., an] =>> S1 ⋔ [b1, ..., bm] =>> T1` if `m != n` +* Two type lambdas with the same number of type parameters are disjoint if their result types are disjoint: + * `[a1, ..., an] =>> S1 ⋔ [b1, ..., bn] =>> T1` if `S1 ⋔ T1` +* An `enum` value case is disjoint from any other `enum` value case (identified by either not being in the same `enum` class, or having a different name): + * `p.C.x ⋔ q.D.y` if `C != D` or `x != y` +* Two literal types are disjoint if they are different: + * `c ⋔ d` if `c != d` +* An `enum` value case is always disjoint from a literal type: + * `c ⋔ q.D.y` + * `p.C.x ⋔ d` +* An `enum` value case or a constant is disjoint from a class type if it does not extend that class (because it's essentially final): + * `p.C.x ⋔ q.D[...Ti]` if `baseType(p.C.x, D)` is not defined + * `p.C[...Si] ⋔ q.D.y` if `baseType(q.D.y, C)` is not defined + * `c ⋔ q.D[...Ti]` if `baseType(c, D)` is not defined + * `p.C[...Si] ⋔ d` if `baseType(d, C)` is not defined +* Two class types are disjoint if the classes themselves are disjoint, or if there exist a common super type with conflicting type arguments. + * `p.C[...Si] ⋔ q.D[...Ti]` if `C ⋔ D` + * `p.C[...Si] ⋔ q.D[...Ti]` if there exists a class `E` such that `baseType(p.C[...Si], E) = a.E[...Ai]` and `baseType(q.D[...Ti], E) = b.E[...Bi]` and there exists a pair `(Ai, Bi)` such that + * `Ai ⋔ Bi` and it is in invariant position, or + * `Ai ⋔ Bi` and it is in covariant position and there exists a field of that type parameter in `E` + +It is worth noting that this definition disregards prefixes entirely. +`p.C` and `q.C` are never provably disjoint, even if `p` could be proven disjoint from `q`. +It also disregards type members. + +We have a proof sketch of the following property for `⋔`: + +* If `S <: T` and `T ⋔ U`, then `S ⋔ U`. + +This is a very desirable property, which does not hold at all for the current implementation of match types. +It means that if we make the scrutinee of a match type more precise (a subtype) through substitution, and the match type previously reduced, then the match type will still reduce to the same case. + +Note: if `⋔` were a "true" disjointness relationship, and not a *provably*-disjoint relationship, that property would trivially hold based on elementary set theoretic properties. +It would amount to proving that if `S ⊆ T` and `T ⋂ U = ∅`, then `S ⋂ U = ∅`. + +#### Reduction + +The final piece of the match types puzzle is to define the reduction as a whole. + +In addition to matching and `provablyDisjoint`, the existing algorithm relies on a `provablyEmpty` property for a single type. +It was added a safeguard against matching an empty (`Nothing`) scrutinee. +The problem with doing so is that an empty scrutinee will be considered *both* as matching the pattern *and* as provably disjoint from the pattern. +This can result in the match type reducing to different cases depending on the context. +To sidestep this issue, the current algorithm refuses to consider a scrutinee that is `provablyEmpty`. + +If we wanted to keep that strategy, we would also have to specify `provablyEmpty` and prove some properties about it. +Instead, we choose a much simpler and safer strategy: we always test both matching *and* `provablyDisjoint`. +When both apply, we deduce that the scrutinee is empty is refuse to reduce the match type. + +Therefore, in summary, the whole reduction algorithm works as follows. +The result of reducing `X match { case P1 => R1; ...; case Pn => Rn }` can be a type, undefined, or a compile error. +For `n >= 1`, it is specified as: + +* If `X` matches `P1` with type capture instantiations `[...ts => ts']`: + * If `X ⋔ P1`, do not reduce. + * Otherwise, reduce as `[...ts => ts']R1`. +* Otherwise, + * If `X ⋔ P1`, the result of reducing `X match { case P2 => R2; ...; case Pn => Rn }` (i.e., proceed with subsequent cases). + * Otherwise, do not reduce. + +The reduction of an "empty" match type `X match { }` (which cannot be written in user programs) is a compile error. + +#### Subtyping + +As is already the case in the existing system, match types tie into subtyping as follows: + +* `X match { ... } <: T` if `X match { ... }` reduces to `S1` and `S1 <: T` +* `S <: X match { ... }` if `X match { ... }` reduces to `T1` and `S <: T1` +* `X match { ... } <: T` if `X match { ... }` has the upper bound `H` and `H <: T` +* `X match { case P1 => A1; ...; case Pn => An } <: Y match { case Q1 => B1; ...; Qn => Bn }` if `X =:= Y` and `Pi =:= Qi` for each `i` and `Ai <: Bi` for each `i` + +### Compatibility + +Compatibility is inherently tricky to evaluate for this proposal, and even to define. +One could argue that, from a pure specification point of view, it breaks nothing since it only specifies things that were unspecified before. +However, that is not very practical. +In practice, this proposal definitely breaks some code that compiled before, due to making some patterns illegal. +In exchange, it promises that all the patterns that are considered legal will keep working in the future; which is not the case with the current implementation, even for the legal subset. + +In order to evaluate the practical impact of this proposal, we conducted a quantitative analysis of *all* the match types found in Scala 3 libraries published on Maven Central. +We used [Scaladex](https://index.scala-lang.org/) to list all Scala 3 libraries, [coursier](https://get-coursier.io/docs/api) to resolve their classpaths, and [tasty-query](https://github.com/scalacenter/tasty-query) to semantically analyze the patterns of all the match types they contain. + +Out of 4,783 libraries, 49 contained at least one match type definition. +These 49 libraries contained a total of 779 match type `case`s. +Of those, there were 8 `case`s that would be flagged as not legal by the current proposal. + +These can be categorized as follows: + +* 2 libraries with 1 type member extractor each where the `Base` does not contain `Y`; they are both to extract `SomeEnumClass#Value` (from Scala 2 `scala.Enumeration`-based "enums"). + * https://github.com/iheartradio/ficus/blob/dcf39d6cd2dcde49b093ba5d1507ca478ec28dac/src/main/scala-3/net/ceedubs/ficus/util/EnumerationUtil.scala#L4-L8 + * https://github.com/json4s/json4s/blob/5e0b92a0ca59769f3130e081d0f53089a4785130/ext/src/main/scala-3/org/json4s/ext/package.scala#L4-L8 + * the maintainers of `json4s` already accepted a PR with a workaround at https://github.com/json4s/json4s/pull/1347 +* 1 library used to have 2 cases of the form `case HKExtractor[f] =>` with `type KHExtractor[f[_, _]] = Base { type Y[a, b] = f[a, b] }`. + * Those used to be at https://github.com/7mind/idealingua-v1/blob/48d35d53ce1c517f9f0d5341871e48749644c105/idealingua-v1/idealingua-v1-runtime-rpc-http4s/src/main/scala-3/izumi/idealingua/runtime/rpc/http4s/package.scala#L10-L15 but they do not exist in the latest version of the library. +* 1 library used to have 1 `&`-type extractor (which "worked" who knows how?): + https://github.com/Katrix/perspective/blob/f1643ac7a4e6a0d8b43546bf7b9e6219cc680dde/dotty/derivation/src/main/scala/perspective/derivation/Helpers.scala#L15-L18 + but the author already accepted a change with a workaround at + https://github.com/Katrix/perspective/pull/1 +* 1 library has 3 occurrences of using an abstract type constructor too "concretely": + https://github.com/kory33/s2mc-test/blob/d27c6e85ad292f8a96d7d51af7ddc87518915149/protocol-core/src/main/scala/io/github/kory33/s2mctest/core/generic/compiletime/Tuple.scala#L16 + defined at https://github.com/kory33/s2mc-test/blob/d27c6e85ad292f8a96d7d51af7ddc87518915149/protocol-core/src/main/scala/io/github/kory33/s2mctest/core/generic/compiletime/Generic.scala#L12 + It could be replaced by a concrete `class Lock[A](phantom: A)` instead. + +All the existing use cases therefore have either already disappeared or have a workaround. + +### Other concerns + +Ideally, this proposal would be first implemented as *warnings* about illegal cases, and only later made errors. +Unfortunately, the presence of the abstract type constructor case makes that impossible. +Indeed, because of it, a pattern that is legal at definition site may become illegal after some later substitution. + +Consider for example the standard library's very own `Tuple.InverseMap`: + +```scala +/** Converts a tuple `(F[T1], ..., F[Tn])` to `(T1, ... Tn)` */ +type InverseMap[X <: Tuple, F[_]] <: Tuple = X match { + case F[x] *: t => x *: InverseMap[t, F] + case EmptyTuple => EmptyTuple +} +``` + +If we instantiate `InverseMap` with a class type parameter, such as `InverseMap[X, List]`, the first case gets instantiated to +```scala +case List[x] *: t => x *: InverseMap[t, List] +``` +which is legal. + +However, nothing prevents us a priori to instantiate `InverseMap` with an illegal type constructor, for example +```scala +type IsSeq[t <: Seq[Any]] = t +InverseMap[X, IsSeq] +``` +which gives +```scala +case IsSeq[x] *: t => x *: InverseMap[t, IsSeq] +``` + +These instantiatiations happen deep inside the type checker, during type computations. +Since types are cached, shared and reused in several parts of the program, by construction, we do not have any source code position information at that point. +That means that we cannot report *warnings*. + +We can in fact report *errors* by reducing to a so-called `ErrorType`, which is aggressively propagated. +This is what we do in the proposed implementation (unless using `-source:3.3`). + +### Open questions + +None at this point. + +## Alternatives + +The specification is more complicated than we initially wanted. +At the beginning, we were hoping that we could restrict match cases to class type constructors only. +The quantitative study however revealed that we had to introduce support for abstract type constructors and for type member extractors. + +As already mentioned, the standard library itself contains an occurrence of an abstract type constructor in a pattern. +If we made that an error, we would have a breaking change to the standard library itself. +Some existing libraries would not be able to retypecheck again. +Worse, it might not be possible for them to change their code in a way that preserves their own public APIs. + +We tried to restrict abstract type constructors to never match on their own. +Instead, we wanted them to stay "stuck" until they could be instantiated to a concrete type constructor. +However, that led some existing tests to fail even for match types that were declared legal, because they did not reduce anymore in some places where they reduced before. + +Type member extractors are our biggest pain point. +Their specification is complicated, and the implementation as well. +Our quantitative study showed that they were however used at least somewhat often (10 occurrences spread over 4 libraries). +In each case, they seem to be a way to express what Scala 2 type projections (`A#T`) could express. +While not quite as powerful as type projections (which were shown to be unsound), match types with type member extractors delay things enough for actual use cases to be meaningful. + +As far as we know, those use cases have no workaround if we make type member extractors illegal. + +## Related work + +Notable prior work related to this proposal includes: + +- [Current reference page for Scala 3 match types](https://dotty.epfl.ch/docs/reference/new-types/match-types.html) +- [Abstractions for Type-Level Programming](https://infoscience.epfl.ch/record/294024), Olivier Blanvillain, Chapter 4 (Match Types) +- ["Pre-Sip" discussion in the Contributors forum](https://contributors.scala-lang.org/t/pre-sip-proper-specification-for-match-types/6265) (submitted at the same time as this SIP document) +- [PR with the proposed implementation](https://github.com/lampepfl/dotty/pull/18262) + +## FAQ + +None at this point. diff --git a/_sips/sips/replace-non-sensical-unchecked-annotations.md b/_sips/sips/replace-non-sensical-unchecked-annotations.md new file mode 100644 index 0000000000..56595d14fb --- /dev/null +++ b/_sips/sips/replace-non-sensical-unchecked-annotations.md @@ -0,0 +1,7 @@ +--- +title: SIP-57 - Replace non-sensical @unchecked annotations +status: submitted +pull-request-number: 67 +stage: pre-sip + +--- From ce4b78d66dcb068becc6a322954b38cf5e8cb3f7 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 12 Dec 2023 00:22:01 +0000 Subject: [PATCH 2754/3075] Update SIPs state --- _sips/sips/improved-lazy-vals-initialization.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_sips/sips/improved-lazy-vals-initialization.md b/_sips/sips/improved-lazy-vals-initialization.md index 24f129e8b6..efb891962b 100644 --- a/_sips/sips/improved-lazy-vals-initialization.md +++ b/_sips/sips/improved-lazy-vals-initialization.md @@ -1,6 +1,7 @@ --- title: SIP-20 - Improved Lazy Vals Initialization -status: withdrawn +status: shipped pull-request-number: 19 +stage: completed --- From 02acc3637561bec25d6596ee0ba310360762eeee Mon Sep 17 00:00:00 2001 From: John Duffell <john.duffell@guardian.co.uk> Date: Thu, 14 Dec 2023 09:44:36 +0000 Subject: [PATCH 2755/3075] Remove all references to unsupported rewrite rules (#2929) * Remove all references to unsupported rewrite rules * fix up formatting issues --- .../scala3-migration/incompat-contextual-abstractions.md | 6 +++--- _overviews/scala3-migration/incompat-syntactic.md | 2 +- _overviews/scala3-migration/incompatibility-table.md | 4 ++-- _overviews/scala3-migration/scala3-migrate.md | 4 ++-- _overviews/scala3-migration/tooling-tour.md | 1 - 5 files changed, 8 insertions(+), 9 deletions(-) diff --git a/_overviews/scala3-migration/incompat-contextual-abstractions.md b/_overviews/scala3-migration/incompat-contextual-abstractions.md index ba88ed62f0..502df62f89 100644 --- a/_overviews/scala3-migration/incompat-contextual-abstractions.md +++ b/_overviews/scala3-migration/incompat-contextual-abstractions.md @@ -11,7 +11,7 @@ The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual) bring |Incompatibility|Scala 2.13|Scala 3 Migration Rewrite|Scalafix Rule|Runtime Incompatibiltiy| |--- |--- |--- |--- |--- | -|[Type of implicit def](#type-of-implicit-definition)|||[✅](https://github.com/ohze/scala-rewrites#fixexplicittypesexplicitimplicittypes)|| +|[Type of implicit def](#type-of-implicit-definition)|||[✅](https://scalacenter.github.io/scalafix/docs/rules/ExplicitResultTypes.html)|| |[Implicit views](#implicit-views)||||**Possible**| |[View bounds](#view-bounds)|Deprecation|||| |[Ambiguous conversion on `A` and `=> A`](#ambiguous-conversion-on-a-and--a)||||| @@ -21,7 +21,7 @@ The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual) bring The type of implicit definitions (`val` or `def`) needs to be given explicitly in Scala 3. They cannot be inferred anymore. -The Scalafix rule named `ExplicitImplicitTypes` in [ohze/scala-rewrites](https://github.com/ohze/scala-rewrites#fixexplicittypesexplicitimplicittypes) repository can write the missing type annotations automatically. +The Scalafix rule named [ExplicitResultTypes](https://scalacenter.github.io/scalafix/docs/rules/ExplicitResultTypes.html) can write the missing type annotations automatically. ## Implicit Views @@ -147,4 +147,4 @@ implicit def lazyBoolFoo(lazyBool: => Boolean): Foo = ??? -true.foo() +boolFoo(true).foo() -{% endhighlight %} \ No newline at end of file +{% endhighlight %} diff --git a/_overviews/scala3-migration/incompat-syntactic.md b/_overviews/scala3-migration/incompat-syntactic.md index 31517a5779..7ce3b21104 100644 --- a/_overviews/scala3-migration/incompat-syntactic.md +++ b/_overviews/scala3-migration/incompat-syntactic.md @@ -18,7 +18,7 @@ It is worth noting that most of the changes can be automatically handled during |--- |--- |--- |--- | |[Restricted keywords](#restricted-keywords)||✅|| |[Procedure syntax](#procedure-syntax)|Deprecation|✅|[✅](https://scalacenter.github.io/scalafix/docs/rules/ProcedureSyntax.html)| -|[Parentheses around lambda parameter](#parentheses-around-lambda-parameter)||✅|[✅](https://github.com/ohze/scala-rewrites/tree/dotty/#fixscala213parensaroundlambda)| +|[Parentheses around lambda parameter](#parentheses-around-lambda-parameter)||✅|| |[Open brace indentation for passing an argument](#open-brace-indentation-for-passing-an-argument)||✅|| |[Wrong indentation](#wrong-indentation)|||| |[`_` as a type parameter](#_-as-a-type-parameter)|||| diff --git a/_overviews/scala3-migration/incompatibility-table.md b/_overviews/scala3-migration/incompatibility-table.md index a7aec7e25f..8148eb7dbc 100644 --- a/_overviews/scala3-migration/incompatibility-table.md +++ b/_overviews/scala3-migration/incompatibility-table.md @@ -37,7 +37,7 @@ Some of the old syntax is not supported anymore. |--- |--- |--- |--- | |[Restricted keywords](incompat-syntactic.html#restricted-keywords)||✅|| |[Procedure syntax](incompat-syntactic.html#procedure-syntax)|Deprecation|✅|[✅](https://scalacenter.github.io/scalafix/docs/rules/ProcedureSyntax.html)| -|[Parentheses around lambda parameter](incompat-syntactic.html#parentheses-around-lambda-parameter)||✅|[✅](https://github.com/ohze/scala-rewrites/tree/dotty/#fixscala213parensaroundlambda)| +|[Parentheses around lambda parameter](incompat-syntactic.html#parentheses-around-lambda-parameter)||✅|| |[Open brace indentation for passing an argument](incompat-syntactic.html#open-brace-indentation-for-passing-an-argument)||✅|| |[Wrong indentation](incompat-syntactic.html#wrong-indentation)|||| |[`_` as a type parameter](incompat-syntactic.html#_-as-a-type-parameter)|||| @@ -63,7 +63,7 @@ The redesign of [contextual abstractions]({{ site.scala3ref }}/contextual) bring |Incompatibility|Scala 2.13|Scala 3 Migration Rewrite|Scalafix Rule|Runtime Incompatibility| |--- |--- |--- |--- |--- | -|[Type of implicit def](incompat-contextual-abstractions.html#type-of-implicit-definition)|||[✅](https://github.com/ohze/scala-rewrites#fixexplicittypesexplicitimplicittypes)|| +|[Type of implicit def](incompat-contextual-abstractions.html#type-of-implicit-definition)|||[✅](https://scalacenter.github.io/scalafix/docs/rules/ExplicitResultTypes.html)|| |[Implicit views](incompat-contextual-abstractions.html#implicit-views)||||**Possible**| |[View bounds](incompat-contextual-abstractions.html#view-bounds)|Deprecation|||| |[Ambiguous conversion on `A` and `=> A`](incompat-contextual-abstractions.html#ambiguous-conversion-on-a-and--a)||||| diff --git a/_overviews/scala3-migration/scala3-migrate.md b/_overviews/scala3-migration/scala3-migrate.md index 554ca5f021..b21ad754a3 100644 --- a/_overviews/scala3-migration/scala3-migrate.md +++ b/_overviews/scala3-migration/scala3-migrate.md @@ -337,11 +337,11 @@ This command runs a number of Scalafix rules to patch some discarded syntax. The list of applied Scalafix rules are: - [ProcedureSyntax](https://scalacenter.github.io/scalafix/docs/rules/ProcedureSyntax.html) -- [fix.scala213.ConstructorProcedureSyntax](https://github.com/ohze/scala-rewrites/tree/dotty/#fixscala213constructorproceduresyntax) - [fix.scala213.ExplicitNullaryEtaExpansion](https://github.com/lightbend-labs/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/ExplicitNullaryEtaExpansion.scala) -- [fix.scala213.ParensAroundLambda](https://github.com/ohze/scala-rewrites/tree/dotty/#fixscala213parensaroundlambda) +- [migrate.ParensAroundLambda](https://github.com/scalacenter/scala3-migrate/blob/ebb4a4087ed11899b9010f4c75eb365532694c0a/scalafix/rules/src/main/scala/migrate/ParensAroundParam.scala#L9) - [fix.scala213.ExplicitNonNullaryApply](https://github.com/lightbend-labs/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/ExplicitNullaryEtaExpansion.scala) - [fix.scala213.Any2StringAdd](https://github.com/lightbend-labs/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/Any2StringAdd.scala) +- [ExplicitResultTypes](https://scalacenter.github.io/scalafix/docs/rules/ExplicitResultTypes.html) For more information about the syntax changes between Scala 2.13 and Scala 3, you can refer to [the Incompatibility Table](incompatibility-table.html). diff --git a/_overviews/scala3-migration/tooling-tour.md b/_overviews/scala3-migration/tooling-tour.md index eb8ec0a439..0c15849a15 100644 --- a/_overviews/scala3-migration/tooling-tour.md +++ b/_overviews/scala3-migration/tooling-tour.md @@ -107,7 +107,6 @@ So far the relevant rules are: - [Procedure Syntax](https://scalacenter.github.io/scalafix/docs/rules/ProcedureSyntax.html) - [Explicit Result Types](https://scalacenter.github.io/scalafix/docs/rules/ExplicitResultTypes.html) - Value Eta-Expansion: `fix.scala213.ExplicitNullaryEtaExpansion` in [scala/scala-rewrites](https://github.com/scala/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/ExplicitNullaryEtaExpansion.scala) -- Parentheses Around Lambda Parameter: `fix.scala213.ParensAroundLambda` in [ohze/scala-rewrites](https://github.com/ohze/scala-rewrites/blob/dotty/rewrites/src/main/scala/fix/scala213/ParensAroundLambda.scala) - Auto Application: `fix.scala213.ExplicitNonNullaryApply` in [scala/scala-rewrites](https://github.com/scala/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/ExplicitNonNullaryApply.scala) - `any2stringadd` Conversion: `fix.scala213.Any2StringAdd` in [scala/scala-rewrites](https://github.com/scala/scala-rewrites/blob/main/rewrites/src/main/scala/fix/scala213/Any2StringAdd.scala) From 6e715db2b37d5995fada9b9b627d2f0e94b19474 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 16 Dec 2023 00:21:45 +0000 Subject: [PATCH 2756/3075] Update SIPs state --- _sips/sips/replace-non-sensical-unchecked-annotations.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_sips/sips/replace-non-sensical-unchecked-annotations.md b/_sips/sips/replace-non-sensical-unchecked-annotations.md index 56595d14fb..e261b18e63 100644 --- a/_sips/sips/replace-non-sensical-unchecked-annotations.md +++ b/_sips/sips/replace-non-sensical-unchecked-annotations.md @@ -1,7 +1,7 @@ --- title: SIP-57 - Replace non-sensical @unchecked annotations -status: submitted +status: under-review pull-request-number: 67 -stage: pre-sip +stage: design --- From 218f6116c13c323c84ae4f9a764e8eafeb9f1e00 Mon Sep 17 00:00:00 2001 From: Taber Bain <taber@taberbain.com> Date: Tue, 19 Dec 2023 09:49:04 -0500 Subject: [PATCH 2757/3075] Update overview.md (#2935) fix typo --- _overviews/collections-2.13/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/collections-2.13/overview.md b/_overviews/collections-2.13/overview.md index e148e0493b..5ef0c9b0f3 100644 --- a/_overviews/collections-2.13/overview.md +++ b/_overviews/collections-2.13/overview.md @@ -16,7 +16,7 @@ Scala collections systematically distinguish between mutable and immutable collections. A _mutable_ collection can be updated, reduced or extended in place. This means you can change, add, or remove elements of a collection as a side effect. _Immutable_ collections, by -contrast, never change. You have still operations that simulate +contrast, never change. You still have operations that simulate additions, removals, or updates, but those operations will in each case return a new collection and leave the old collection unchanged. @@ -36,7 +36,7 @@ always yield a collection with the same elements. A collection in package `scala.collection.mutable` is known to have some operations that change the collection in place. So dealing with -mutable collection means you need to understand which code changes +a mutable collection means you need to understand which code changes which collection when. A collection in package `scala.collection` can be either mutable or From a778ca7b5c835a7645f9675ea2ae0a7fc0f109fd Mon Sep 17 00:00:00 2001 From: Philippus Baalman <philippus@gmail.com> Date: Wed, 20 Dec 2023 09:40:02 +0100 Subject: [PATCH 2758/3075] Fix 404s (#2937) --- .../reflection/annotations-names-scopes.md | 22 +++++++++---------- .../reflection/symbols-trees-types.md | 2 +- .../reflection/annotations-names-scopes.md | 22 +++++++++---------- _overviews/reflection/overview.md | 4 ++-- _sips/sips/scala-cli.md | 4 ++-- _zh-cn/overviews/reflection/overview.md | 4 ++-- 6 files changed, 29 insertions(+), 29 deletions(-) diff --git a/_ja/overviews/reflection/annotations-names-scopes.md b/_ja/overviews/reflection/annotations-names-scopes.md index dfe1312d4d..8101c9d772 100644 --- a/_ja/overviews/reflection/annotations-names-scopes.md +++ b/_ja/overviews/reflection/annotations-names-scopes.md @@ -53,7 +53,7 @@ Scala または Java アノテーションに対しては `scalaArgs` は空で ## 名前 **名前** (name) は文字列の簡単なラッパーだ。 -[`Name`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Names$NameApi.html) +[`Name`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Names$NameApi.html) には 2つのサブタイプ `TermName` と `TypeName` があり (オブジェクトやメンバーのような) 項の名前と (クラス、トレイト、型メンバのような) 型の名前を区別する。同じオブジェクト内に同名の項と型が共存することができる。別の言い方をすると、型と項は別の名前空間を持つ。 @@ -96,19 +96,19 @@ Scala のプログラムにおいて、「`_root_`」のような特定の名前 「`package`」のようないくつかの名前は型名と項名の両方が存在する。 標準名は `Universe` クラスの `termNames` と `typeNames` というメンバとして公開されている。 -全ての標準名の仕様は [API doc](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/StandardNames.html) を参照。 +全ての標準名の仕様は [API doc](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/StandardNames.html) を参照。 ## スコープ **スコープ** (scope) は一般にある構文スコープ内の名前をシンボルに関連付ける。 スコープは入れ子にすることもできる。リフレクション API -で公開されているスコープの基底型は [Symbol](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Symbols$Symbol.html) の iterable という最小限のインターフェイスのみを公開する。 +で公開されているスコープの基底型は [Symbol](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Symbols$Symbol.html) の iterable という最小限のインターフェイスのみを公開する。 追加機能は -[scala.reflect.api.Types#TypeApi](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Types$TypeApi.html) +[scala.reflect.api.Types#TypeApi](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Types$TypeApi.html) 内で定義されている `member` と `decls` が返す**メンバスコープ** (member scope) にて公開される。 -[scala.reflect.api.Scopes#MemberScope](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Scopes$MemberScope.html) +[scala.reflect.api.Scopes#MemberScope](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Scopes$MemberScope.html) は `sorted` メソッドをサポートしており、これはメンバを**宣言順に**ソートする。 以下に `List` クラスでオーバーライドされている全てのシンボルのリストを宣言順に返す具体例をみてみよう: @@ -119,7 +119,7 @@ Scala のプログラムにおいて、「`_root_`」のような特定の名前 ## Expr 構文木の基底型である `scala.reflect.api.Trees#Tree` の他に、型付けされた構文木は -[`scala.reflect.api.Exprs#Expr`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Exprs$Expr.html) 型によっても表すことができる。 +[`scala.reflect.api.Exprs#Expr`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Exprs$Expr.html) 型によっても表すことができる。 `Expr` は構文木と、その構文木の型に対するアクセスを提供するための型タグをラッピングする。 `Expr` は主にマクロのために便宜的に型付けられた構文木を作るために使われる。多くの場合、これは `reify` と `splice` メソッドが関わってくる。 @@ -175,8 +175,8 @@ Scala コンパイラによってコンパイル時に評価することがで 1. プリミティブ値クラスのリテラル ([Byte](https://www.scala-lang.org/api/current/index.html#scala.Byte)、 [Short](https://www.scala-lang.org/api/current/index.html#scala.Short)、 [Int](https://www.scala-lang.org/api/current/index.html#scala.Int)、 [Long](https://www.scala-lang.org/api/current/index.html#scala.Long)、 [Float](https://www.scala-lang.org/api/current/index.html#scala.Float)、 [Double](https://www.scala-lang.org/api/current/index.html#scala.Double)、 [Char](https://www.scala-lang.org/api/current/index.html#scala.Char)、 [Boolean](https://www.scala-lang.org/api/current/index.html#scala.Boolean) および [Unit](https://www.scala-lang.org/api/current/index.html#scala.Unit))。これは直接対応する型で表される。 2. 文字列リテラル。これは文字列のインスタンスとして表される。 -3. 一般に [scala.Predef#classOf](https://www.scala-lang.org/api/current/index.html#scala.Predef$@classOf[T]:Class[T]) で構築されるクラスへの参照。[型](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Types$Type.html)として表される。 -4. Java の列挙要素。[シンボル](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Symbols$Symbol.html)として表される。 +3. 一般に [scala.Predef#classOf](https://www.scala-lang.org/api/current/index.html#scala.Predef$@classOf[T]:Class[T]) で構築されるクラスへの参照。[型](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Types$Type.html)として表される。 +4. Java の列挙要素。[シンボル](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Symbols$Symbol.html)として表される。 定数式の用例としては @@ -264,8 +264,8 @@ Java の列挙要素への参照はシンボル (`scala.reflect.api.Symbols#Symb ## プリティプリンタ -[`Trees`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Trees.html) と -[`Types`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Types.html) +[`Trees`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Trees.html) と +[`Types`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Types.html) を整形して表示するユーティリティを説明しよう。 ### 構文木の表示 @@ -380,7 +380,7 @@ Java の列挙要素への参照はシンボル (`scala.reflect.api.Symbols#Symb ## 位置情報 -**位置情報** ([`Position`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Position.html)) +**位置情報** ([`Position`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Position.html)) はシンボルや構文木のノードの出処を追跡するのに使われる。警告やエラーの表示でよく使われ、プログラムのどこが間違ったのかを正確に表示することができる。位置情報はソースファイルの列と行を表す。 (ソースファイルの初めからのオフセットは「ポイント」と呼ばれるが、これは便利ではないことがある) 位置情報はそれが指す行の内容も保持する。全ての構文木やシンボルが位置情報を持つわけではなく、ない場合は diff --git a/_ja/overviews/reflection/symbols-trees-types.md b/_ja/overviews/reflection/symbols-trees-types.md index b02471883f..13247503b5 100644 --- a/_ja/overviews/reflection/symbols-trees-types.md +++ b/_ja/overviews/reflection/symbols-trees-types.md @@ -167,7 +167,7 @@ title: シンボル、構文木、型 scala> val intTpe = universe.definitions.IntTpe intTpe: scala.reflect.runtime.universe.Type = Int -標準型のリストは [`scala.reflect.api.StandardDefinitions`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/StandardDefinitions$StandardTypes.html) 内の `StandardTypes` +標準型のリストは [`scala.reflect.api.StandardDefinitions`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/StandardDefinitions$StandardTypes.html) 内の `StandardTypes` トレイトにて定義されている。 ### 型の一般的な演算 diff --git a/_overviews/reflection/annotations-names-scopes.md b/_overviews/reflection/annotations-names-scopes.md index 7bf66cafcf..a4d1bbcce0 100644 --- a/_overviews/reflection/annotations-names-scopes.md +++ b/_overviews/reflection/annotations-names-scopes.md @@ -58,7 +58,7 @@ represent different kinds of Java annotation arguments: ## Names Names are simple wrappers for strings. -[Name](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Names$NameApi.html) +[Name](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Names$NameApi.html) has two subtypes `TermName` and `TypeName` which distinguish names of terms (like objects or members) and types (like classes, traits, and type members). A term and a type of the same name can co-exist in the same object. In other words, @@ -104,19 +104,19 @@ There are both Some names, such as "package", exist both as a type name and a term name. Standard names are made available through the `termNames` and `typeNames` members of class `Universe`. For a complete specification of all standard names, see the -[API documentation](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/StandardNames.html). +[API documentation](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/StandardNames.html). ## Scopes A scope object generally maps names to symbols available in a corresponding lexical scope. Scopes can be nested. The base type exposed in the reflection API, however, only exposes a minimal interface, representing a scope as an -iterable of [Symbol](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Symbols$Symbol.html)s. +iterable of [Symbol](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Symbols$Symbol.html)s. Additional functionality is exposed in *member scopes* that are returned by `members` and `decls` defined in -[scala.reflect.api.Types#TypeApi](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Types$TypeApi.html). -[scala.reflect.api.Scopes#MemberScope](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Scopes$MemberScope.html) +[scala.reflect.api.Types#TypeApi](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Types$TypeApi.html). +[scala.reflect.api.Scopes#MemberScope](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Scopes$MemberScope.html) supports the `sorted` method, which sorts members *in declaration order*. The following example returns a list of the symbols of all final members @@ -129,7 +129,7 @@ of the `List` class, in declaration order: In addition to type `scala.reflect.api.Trees#Tree`, the base type of abstract syntax trees, typed trees can also be represented as instances of type -[`scala.reflect.api.Exprs#Expr`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Exprs$Expr.html). +[`scala.reflect.api.Exprs#Expr`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Exprs$Expr.html). An `Expr` wraps an abstract syntax tree and an internal type tag to provide access to the type of the tree. `Expr`s are mainly used to simply and conveniently create typed @@ -189,9 +189,9 @@ expressions are compile-time constants (see [section 6.24 of the Scala language 2. String literals - represented as instances of the string. -3. References to classes, typically constructed with [scala.Predef#classOf](https://www.scala-lang.org/api/current/index.html#scala.Predef$@classOf[T]:Class[T]) - represented as [types](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Types$Type.html). +3. References to classes, typically constructed with [scala.Predef#classOf](https://www.scala-lang.org/api/current/index.html#scala.Predef$@classOf[T]:Class[T]) - represented as [types](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Types$Type.html). -4. References to Java enumeration values - represented as [symbols](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Symbols$Symbol.html). +4. References to Java enumeration values - represented as [symbols](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Symbols$Symbol.html). Constant expressions are used to represent @@ -287,8 +287,8 @@ Example: ## Printers Utilities for nicely printing -[`Trees`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Trees.html) and -[`Types`](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Types.html). +[`Trees`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Trees.html) and +[`Types`](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Types.html). ### Printing Trees @@ -408,7 +408,7 @@ additionally shows the unique identifiers of symbols, as well as their kind ## Positions Positions (instances of the -[Position](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Position.html) trait) +[Position](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Position.html) trait) are used to track the origin of symbols and tree nodes. They are commonly used when displaying warnings and errors, to indicate the incorrect point in the program. Positions indicate a column and line in a source file (the offset diff --git a/_overviews/reflection/overview.md b/_overviews/reflection/overview.md index 25205074ec..d388e4016e 100644 --- a/_overviews/reflection/overview.md +++ b/_overviews/reflection/overview.md @@ -325,7 +325,7 @@ reflection, such as `Types`, `Trees`, and `Annotations`. For more details, see the section of this guide on [Universes]({{ site.baseurl}}/overviews/reflection/environment-universes-mirrors.html), or the -[Universes API docs](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Universe.html) +[Universes API docs](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Universe.html) in package `scala.reflect.api`. To use most aspects of Scala reflection, including most code examples provided @@ -345,5 +345,5 @@ different flavors of mirrors must be used. For more details, see the section of this guide on [Mirrors]({{ site.baseurl}}/overviews/reflection/environment-universes-mirrors.html), or the -[Mirrors API docs](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Mirrors.html) +[Mirrors API docs](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Mirrors.html) in package `scala.reflect.api`. diff --git a/_sips/sips/scala-cli.md b/_sips/sips/scala-cli.md index 2a3ba1577e..7c2692dc65 100644 --- a/_sips/sips/scala-cli.md +++ b/_sips/sips/scala-cli.md @@ -132,7 +132,7 @@ Last section of this proposal is the list of options that each sub-command MUST -Scala CLI can also be configured with ["using directives"](https://scala-cli.virtuslab.org/docs/guides/using-directives) - a comment-based configuration syntax that should be placed at the top of Scala files. This allows for self-containing examples within one file since most of the configuration can be provided either from the command line or via using directives (command line has precedence). This is a game changer for use cases like scripting, reproduction, or within the academic scope. +Scala CLI can also be configured with ["using directives"](https://scala-cli.virtuslab.org/docs/guides/introduction/using-directives/) - a comment-based configuration syntax that should be placed at the top of Scala files. This allows for self-containing examples within one file since most of the configuration can be provided either from the command line or via using directives (command line has precedence). This is a game changer for use cases like scripting, reproduction, or within the academic scope. We have described the motivation, syntax and implementation basis in the [dedicated pre-SIP](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700). Currently, we recommend to write using directives as comments, so making them part of the language specification is not necessary at this stage. Moreover, the new `scala` command could ignore using directives in the initial version, however we strongly suggest to include comment-based using directives from the start. @@ -149,7 +149,7 @@ Adopting Scala CLI as the new `scala` command, as is, will change some of the be ### Other concerns -Scala CLI brings [using directives](https://scala-cli.virtuslab.org/docs/guides/using-directives) and [conventions to mark the test files](https://scala-cli.virtuslab.org/docs/commands/test#test-sources). We suggest to accept both accepted as a part of this SIP but we are ready to open dedicated SIPs for both (we have opened a [pre-SIP for using directives](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700/15)) +Scala CLI brings [using directives](https://scala-cli.virtuslab.org/docs/guides/introduction/using-directives/) and [conventions to mark the test files](https://scala-cli.virtuslab.org/docs/commands/test#test-sources). We suggest to accept both accepted as a part of this SIP but we are ready to open dedicated SIPs for both (we have opened a [pre-SIP for using directives](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700/15)) Scala CLI is an ambitious project and may seem hard to maintain in the long-run. diff --git a/_zh-cn/overviews/reflection/overview.md b/_zh-cn/overviews/reflection/overview.md index 02adf8ecc2..fb80386e2a 100644 --- a/_zh-cn/overviews/reflection/overview.md +++ b/_zh-cn/overviews/reflection/overview.md @@ -279,7 +279,7 @@ Scala反射实现了允许在编译阶段就对程序进行修改的一种元编 `Universe`是Scala反射的切入点。 `universe`提供了使用反射所关联的很多核心概念，比如`Types`，`Trees`，以及`Annotations`。 -更多细节请参阅指南中[Universes](https://docs.scala-lang.org/overviews/reflection/environment-universes-mirrors.html)部分，或者看`scala.reflect.api`包的[Universes API文档](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Universe.html)。 +更多细节请参阅指南中[Universes](https://docs.scala-lang.org/overviews/reflection/environment-universes-mirrors.html)部分，或者看`scala.reflect.api`包的[Universes API文档](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Universe.html)。 本指南中提供了大多数情况下Scala反射要用到的部分，一般在使用运行时反射的场景下，直接导入所有`universe`成员去用即可： @@ -293,4 +293,4 @@ import scala.reflect.runtime.universe._ 反射所能提供的信息都是通过镜像去访问的。 根据不同的类型信息或不同的反射操作，必须要使用不同类型的镜像。 -更多细节请参阅指南中[Mirros](https://docs.scala-lang.org/overviews/reflection/environment-universes-mirrors.html)部分，或者看`scala.reflect.api`包的[Mirrors API文档](https://www.scala-lang.org/api/current/scala-reflect/scala/reflect/api/Mirrors.html)。 +更多细节请参阅指南中[Mirros](https://docs.scala-lang.org/overviews/reflection/environment-universes-mirrors.html)部分，或者看`scala.reflect.api`包的[Mirrors API文档](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Mirrors.html)。 From 1f6ddbf73067dcbe42d3c813b050a4d2cb38d843 Mon Sep 17 00:00:00 2001 From: Ivan Denysov <4324068+ivandenysov@users.noreply.github.com> Date: Wed, 20 Dec 2023 13:27:15 +0100 Subject: [PATCH 2759/3075] Remove a rotten link on https://docs.scala-lang.org/scala3/book/fp-intro.html (#2930) * Remove rotten link * Update _overviews/scala3-book/fp-intro.md --------- Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> --- _overviews/scala3-book/fp-intro.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/fp-intro.md b/_overviews/scala3-book/fp-intro.md index d99ec1d0e8..99f02ca759 100644 --- a/_overviews/scala3-book/fp-intro.md +++ b/_overviews/scala3-book/fp-intro.md @@ -10,7 +10,7 @@ next-page: fp-what-is-fp Scala lets you write code in an object-oriented programming (OOP) style, a functional programming (FP) style, and also in a hybrid style---using both approaches in combination. -[As Martin Odersky has stated](https://twitter.com/alexelcu/status/996408359514525696), the essence of Scala is a fusion of functional and object-oriented programming in a typed setting: +As stated by Martin Odersky, the creator of Scala, the essence of Scala is a fusion of functional and object-oriented programming in a typed setting: - Functions for the logic - Objects for the modularity From cab044d285977bfd582c84e3a436b831838e3676 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Thu, 21 Dec 2023 00:21:39 +0000 Subject: [PATCH 2760/3075] Update SIPs state --- _sips/sips/scala-cli.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_sips/sips/scala-cli.md b/_sips/sips/scala-cli.md index 7c2692dc65..2a3ba1577e 100644 --- a/_sips/sips/scala-cli.md +++ b/_sips/sips/scala-cli.md @@ -132,7 +132,7 @@ Last section of this proposal is the list of options that each sub-command MUST -Scala CLI can also be configured with ["using directives"](https://scala-cli.virtuslab.org/docs/guides/introduction/using-directives/) - a comment-based configuration syntax that should be placed at the top of Scala files. This allows for self-containing examples within one file since most of the configuration can be provided either from the command line or via using directives (command line has precedence). This is a game changer for use cases like scripting, reproduction, or within the academic scope. +Scala CLI can also be configured with ["using directives"](https://scala-cli.virtuslab.org/docs/guides/using-directives) - a comment-based configuration syntax that should be placed at the top of Scala files. This allows for self-containing examples within one file since most of the configuration can be provided either from the command line or via using directives (command line has precedence). This is a game changer for use cases like scripting, reproduction, or within the academic scope. We have described the motivation, syntax and implementation basis in the [dedicated pre-SIP](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700). Currently, we recommend to write using directives as comments, so making them part of the language specification is not necessary at this stage. Moreover, the new `scala` command could ignore using directives in the initial version, however we strongly suggest to include comment-based using directives from the start. @@ -149,7 +149,7 @@ Adopting Scala CLI as the new `scala` command, as is, will change some of the be ### Other concerns -Scala CLI brings [using directives](https://scala-cli.virtuslab.org/docs/guides/introduction/using-directives/) and [conventions to mark the test files](https://scala-cli.virtuslab.org/docs/commands/test#test-sources). We suggest to accept both accepted as a part of this SIP but we are ready to open dedicated SIPs for both (we have opened a [pre-SIP for using directives](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700/15)) +Scala CLI brings [using directives](https://scala-cli.virtuslab.org/docs/guides/using-directives) and [conventions to mark the test files](https://scala-cli.virtuslab.org/docs/commands/test#test-sources). We suggest to accept both accepted as a part of this SIP but we are ready to open dedicated SIPs for both (we have opened a [pre-SIP for using directives](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700/15)) Scala CLI is an ambitious project and may seem hard to maintain in the long-run. From 8a1f2768b7032f6ba3f9ad129fca5333dc6abfa8 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 9 Jan 2024 00:22:39 +0000 Subject: [PATCH 2761/3075] Update SIPs state --- _sips/sips/scala-cli.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/_sips/sips/scala-cli.md b/_sips/sips/scala-cli.md index 2a3ba1577e..f979104084 100644 --- a/_sips/sips/scala-cli.md +++ b/_sips/sips/scala-cli.md @@ -129,10 +129,8 @@ The subcommand that MAY be included in the specification of the new `scala` comm - update: Update scala-cli - only works when installed by the installation script Last section of this proposal is the list of options that each sub-command MUST HAVE and SHOULD HAVE for each sub-commands that MUST or SHOULD be included in the specification of the new `scala` command. The options that are specific to the implementation (MAY have) as well as options for implementation specific sub-commands (MAY have) are included in [full specification](https://romanowski.github.io/scala-cli/docs/reference/scala-command/runner-specification). - - -Scala CLI can also be configured with ["using directives"](https://scala-cli.virtuslab.org/docs/guides/using-directives) - a comment-based configuration syntax that should be placed at the top of Scala files. This allows for self-containing examples within one file since most of the configuration can be provided either from the command line or via using directives (command line has precedence). This is a game changer for use cases like scripting, reproduction, or within the academic scope. +Scala CLI can also be configured with ["using directives"](https://scala-cli.virtuslab.org/docs/guides/introduction/using-directives) - a comment-based configuration syntax that should be placed at the top of Scala files. This allows for self-containing examples within one file since most of the configuration can be provided either from the command line or via using directives (command line has precedence). This is a game changer for use cases like scripting, reproduction, or within the academic scope. We have described the motivation, syntax and implementation basis in the [dedicated pre-SIP](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700). Currently, we recommend to write using directives as comments, so making them part of the language specification is not necessary at this stage. Moreover, the new `scala` command could ignore using directives in the initial version, however we strongly suggest to include comment-based using directives from the start. @@ -149,7 +147,7 @@ Adopting Scala CLI as the new `scala` command, as is, will change some of the be ### Other concerns -Scala CLI brings [using directives](https://scala-cli.virtuslab.org/docs/guides/using-directives) and [conventions to mark the test files](https://scala-cli.virtuslab.org/docs/commands/test#test-sources). We suggest to accept both accepted as a part of this SIP but we are ready to open dedicated SIPs for both (we have opened a [pre-SIP for using directives](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700/15)) +Scala CLI brings [using directives](https://scala-cli.virtuslab.org/docs/guides/introduction/using-directives) and [conventions to mark the test files](https://scala-cli.virtuslab.org/docs/commands/test#test-sources). We suggest to accept both accepted as a part of this SIP but we are ready to open dedicated SIPs for both (we have opened a [pre-SIP for using directives](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700/15)) Scala CLI is an ambitious project and may seem hard to maintain in the long-run. From 6d20113cd945d01d08498d881df4fa297780a75f Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sun, 14 Jan 2024 21:11:47 +0800 Subject: [PATCH 2762/3075] correct minor errors. --- _zh-cn/overviews/scala3-book/fp-functions-are-values.md | 2 +- _zh-cn/overviews/scala3-book/string-interpolation.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md index 5c82bf83c9..ab802ed02a 100644 --- a/_zh-cn/overviews/scala3-book/fp-functions-are-values.md +++ b/_zh-cn/overviews/scala3-book/fp-functions-are-values.md @@ -4,7 +4,7 @@ type: section description: This section looks at the use of functions as values in functional programming. language: zh-cn num: 45 -previors-page: fp-pure-functions +previous-page: fp-pure-functions next-page: fp-functional-error-handling partof: scala3-book diff --git a/_zh-cn/overviews/scala3-book/string-interpolation.md b/_zh-cn/overviews/scala3-book/string-interpolation.md index 0a594b23cf..cbe6f8d2b2 100644 --- a/_zh-cn/overviews/scala3-book/string-interpolation.md +++ b/_zh-cn/overviews/scala3-book/string-interpolation.md @@ -7,7 +7,7 @@ num: 18 previous-page: first-look-at-types next-page: control-structures redirect_from: - - /zh-cn/overviews/core/string-interpolation.html + - /overviews/core/string-interpolation.html partof: scala3-book overview-name: "Scala 3 — Book" From 033b3f1956b97de39995bc44937cb7951b0c42a9 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sun, 14 Jan 2024 22:50:44 +0800 Subject: [PATCH 2763/3075] correct permalink in string-interpolation.md. --- _zh-cn/overviews/scala3-book/string-interpolation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/string-interpolation.md b/_zh-cn/overviews/scala3-book/string-interpolation.md index cbe6f8d2b2..46c89a27f1 100644 --- a/_zh-cn/overviews/scala3-book/string-interpolation.md +++ b/_zh-cn/overviews/scala3-book/string-interpolation.md @@ -12,7 +12,7 @@ redirect_from: partof: scala3-book overview-name: "Scala 3 — Book" layout: multipage-overview -permalink: "/zh-cn/scala3/book/:title.html" +permalink: "/scala3/book/:title.html" --- ## 介绍 From bd936fd11fe26364f1e267493a48a87faed8fc10 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Sun, 14 Jan 2024 23:15:03 +0800 Subject: [PATCH 2764/3075] modified back again. --- _zh-cn/overviews/scala3-book/string-interpolation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/string-interpolation.md b/_zh-cn/overviews/scala3-book/string-interpolation.md index 46c89a27f1..cbe6f8d2b2 100644 --- a/_zh-cn/overviews/scala3-book/string-interpolation.md +++ b/_zh-cn/overviews/scala3-book/string-interpolation.md @@ -12,7 +12,7 @@ redirect_from: partof: scala3-book overview-name: "Scala 3 — Book" layout: multipage-overview -permalink: "/scala3/book/:title.html" +permalink: "/zh-cn/scala3/book/:title.html" --- ## 介绍 From 57e9b8c3a0b9d529127c4813798b6bb5ca271495 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 16 Jan 2024 00:22:05 +0000 Subject: [PATCH 2765/3075] Update SIPs state --- _sips/sips/named-tuples.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/named-tuples.md diff --git a/_sips/sips/named-tuples.md b/_sips/sips/named-tuples.md new file mode 100644 index 0000000000..6e15896334 --- /dev/null +++ b/_sips/sips/named-tuples.md @@ -0,0 +1,7 @@ +--- +title: SIP-58 - Named Tuples +status: submitted +pull-request-number: 72 +stage: pre-sip + +--- From f2614aad66e02e64a4a55bdaa35a2f8f57785033 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Wed, 17 Jan 2024 00:22:25 +0000 Subject: [PATCH 2766/3075] Update SIPs state --- _sips/sips/binary-api.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/_sips/sips/binary-api.md b/_sips/sips/binary-api.md index 5b7ccdd9db..8997304831 100644 --- a/_sips/sips/binary-api.md +++ b/_sips/sips/binary-api.md @@ -12,9 +12,10 @@ title: SIP-52 - Binary APIs | Date | Version | |---------------|------------------------| -| Feb 27 2022 | Initial Draft | -| Aug 16 2022 | Single Annotation | -| Aug 24 2022 | Change Annotation Name | +| Feb 27 2023 | Initial Draft | +| Aug 16 2023 | Single Annotation | +| Aug 24 2023 | Change Annotation Name | +| Jan 09 2024 | Change Overload Rules | ## Summary @@ -73,7 +74,7 @@ This proposal introduces the `@publicInBinary` annotation, and adds a migration #### `@publicInBinary` annotation -A binary API is a definition that is annotated with `@publicInBinary` or overrides a definition annotated with `@publicInBinary`. +A binary API is a definition that is annotated with `@publicInBinary`. This annotation can be placed on `def`, `val`, `lazy val`, `var`, `object`, and `given` definitions. A binary API will be publicly available in the bytecode. @@ -222,6 +223,7 @@ final class publicInBinary extends scala.annotation.StaticAnnotation #### `@publicInBinary` annotation * Only valid on `def`, `val`, `lazy val`, `var`, `object`, and `given`. +* If a definition overrides a `@publicInBinary` definition, it must also be annotated with `@publicInBinary`. * TASTy will contain references to non-public definitions that are out of scope but `@publicInBinary`. TASTy already allows those references. * The annotated definitions will be public in the generated bytecode. Definitions should be made public as early as possible in the compiler phases, as this can remove the need to create other accessors. It should be done after we check the accessibility of references. From 22ecdf0474838d6fc1989eae501fb8705d600bb4 Mon Sep 17 00:00:00 2001 From: Vince <vince.reuter@gmail.com> Date: Fri, 19 Jan 2024 10:54:07 +0100 Subject: [PATCH 2767/3075] Add info pointer for singleton and refinement types, #2933 (#2934) * Add info pointer for singleton and refinement types, #2933 * Link to specific sections of the spec for literal and refined types --- _overviews/scala3-book/types-others.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-book/types-others.md b/_overviews/scala3-book/types-others.md index a5ae730b1e..f2db8a42be 100644 --- a/_overviews/scala3-book/types-others.md +++ b/_overviews/scala3-book/types-others.md @@ -21,7 +21,9 @@ Scala has several other advanced types that are not shown in this book, includin - Refinement types - Kind polymorphism -For more details on these types, see the [Scala 3 Reference documentation][reference]. +For more details on most of these types, refer to the [Scala 3 Reference documentation][reference]. +For singleton types see the [literal types](https://scala-lang.org/files/archive/spec/3.4/03-types.html#literal-types) section of the Scala 3 spec, +and for refinement types, see the [refined types](https://scala-lang.org/files/archive/spec/3.4/03-types.html) section. From 65b6c50e7295de5373f3b1cacf804c3fc7c288f7 Mon Sep 17 00:00:00 2001 From: rjolly <rjolly@users.sourceforge.net> Date: Fri, 19 Jan 2024 11:26:04 +0100 Subject: [PATCH 2768/3075] Fix checkinit option syntax in Scala 3 (#2948) --- _overviews/scala3-migration/options-lookup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/options-lookup.md b/_overviews/scala3-migration/options-lookup.md index 3bca1de23a..a80f79c806 100644 --- a/_overviews/scala3-migration/options-lookup.md +++ b/_overviews/scala3-migration/options-lookup.md @@ -144,7 +144,7 @@ since the configuration syntax and the error messages it matches are different. | 2.13.x | 3.3.x | |-|-| | `-Xasync` | <i class="fa fa-times fa-lg"></i> | -| `-Xcheckinit` | `-Ycheck-init` | +| `-Xcheckinit` | `-Ysafe-init` | | `-Xdev` | <i class="fa fa-times fa-lg"></i> | | `-Xdisable-assertions` | <i class="fa fa-times fa-lg"></i> | | `-Xelide-below` | <i class="fa fa-times fa-lg"></i> | From b89c074a94f528284b816b1703e2027cced344b5 Mon Sep 17 00:00:00 2001 From: Denys Rybalka <denys.rybalka@tuta.io> Date: Fri, 19 Jan 2024 11:26:42 +0100 Subject: [PATCH 2769/3075] Fix postfix operations (#2949) --- .../parallel-collections/concrete-parallel-collections.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/parallel-collections/concrete-parallel-collections.md b/_overviews/parallel-collections/concrete-parallel-collections.md index 2885e72bc9..428f142918 100644 --- a/_overviews/parallel-collections/concrete-parallel-collections.md +++ b/_overviews/parallel-collections/concrete-parallel-collections.md @@ -84,10 +84,10 @@ is an ordered sequence of elements equally spaced apart. A parallel range is created in a similar way as the sequential [Range](https://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html): - scala> 1 to 3 par + scala> (1 to 3).par res0: scala.collection.parallel.immutable.ParRange = ParRange(1, 2, 3) - scala> 15 to 5 by -2 par + scala> (15 to 5 by -2).par res1: scala.collection.parallel.immutable.ParRange = ParRange(15, 13, 11, 9, 7, 5) Just as sequential ranges have no builders, parallel ranges have no @@ -146,7 +146,7 @@ and scala> val phs = scala.collection.parallel.immutable.ParHashSet(1 until 1000: _*) phs: scala.collection.parallel.immutable.ParHashSet[Int] = ParSet(645, 892, 69, 809, 629, 365, 138, 760, 101, 479,... - scala> phs map { x => x * x } sum + scala> phs.map(x => x * x).sum res0: Int = 332833500 Similar to parallel hash tables, parallel hash trie From 6a9557b84b063d092b126e7e8a28af6e12dd36d1 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 19 Jan 2024 16:33:54 +0100 Subject: [PATCH 2770/3075] Apply suggestions from code review fix links and redirect --- _zh-cn/overviews/scala3-book/string-interpolation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/string-interpolation.md b/_zh-cn/overviews/scala3-book/string-interpolation.md index cbe6f8d2b2..372eccc5e0 100644 --- a/_zh-cn/overviews/scala3-book/string-interpolation.md +++ b/_zh-cn/overviews/scala3-book/string-interpolation.md @@ -2,12 +2,12 @@ title: 字符串插值 type: chapter description: This page provides more information about creating strings and using 字符串插值. -languages: zh-cn +language: zh-cn num: 18 previous-page: first-look-at-types next-page: control-structures redirect_from: - - /overviews/core/string-interpolation.html + - /zh-cn/overviews/core/string-interpolation.html partof: scala3-book overview-name: "Scala 3 — Book" From 3c0c052c4528832d31cc86b609dcba5062cef4fd Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 19 Jan 2024 16:39:41 +0100 Subject: [PATCH 2771/3075] remove old zh-cn string interpolation page --- _zh-cn/overviews/core/string-interpolation.md | 119 ------------------ 1 file changed, 119 deletions(-) delete mode 100644 _zh-cn/overviews/core/string-interpolation.md diff --git a/_zh-cn/overviews/core/string-interpolation.md b/_zh-cn/overviews/core/string-interpolation.md deleted file mode 100644 index eab9e4a742..0000000000 --- a/_zh-cn/overviews/core/string-interpolation.md +++ /dev/null @@ -1,119 +0,0 @@ ---- -layout: singlepage-overview -title: 字符串插值 - -partof: string-interpolation - -language: zh-cn ---- - -**Josh Suereth 著** - -## 简介 - -自2.10.0版本开始，Scala提供了一种新的机制来根据数据生成字符串：字符串插值。字符串插值允许使用者将变量引用直接插入处理过的字面字符中。如下例： - - val name="James" - println(s"Hello,$name")//Hello,James - -在上例中， s"Hello,$name" 是待处理字符串字面，编译器会对它做额外的工作。待处理字符串字面通过“号前的字符来标示（例如：上例中是s）。字符串插值的实现细节在 [SIP-11](https://docs.scala-lang.org/sips/pending/string-interpolation.html) 中有全面介绍。 - -## 用法 - -Scala 提供了三种创新的字符串插值方法：s,f 和 raw. - -### s 字符串插值器 - -在任何字符串前加上s，就可以直接在串中使用变量了。你已经见过这个例子： - - val name="James" - println(s"Hello,$name")//Hello,James -此例中，$name嵌套在一个将被s字符串插值器处理的字符串中。插值器知道在这个字符串的这个地方应该插入这个name变量的值，以使输出字符串为Hello,James。使用s插值器，在这个字符串中可以使用任何在处理范围内的名字。 - -字符串插值器也可以处理任意的表达式。例如： - - println(s"1+1=${1+1}") -将会输出字符串1+1=2。任何表达式都可以嵌入到${}中。 - -### f 插值器 - -在任何字符串字面前加上 f，就可以生成简单的格式化串，功能相似于其他语言中的 printf 函数。当使用 f 插值器的时候，所有的变量引用都应当后跟一个printf-style格式的字符串，如%d。看下面这个例子： - - val height=1.9d - val name="James" - println(f"$name%s is $height%2.2f meters tall")//James is 1.90 meters tall -f 插值器是类型安全的。如果试图向只支持 int 的格式化串传入一个double 值，编译器则会报错。例如： - - val height:Double=1.9d - - scala>f"$height%4d" - <console>:9: error: type mismatch; - found : Double - required: Int - f"$height%4d" - ^ -f 插值器利用了java中的字符串数据格式。这种以%开头的格式在 [Formatter javadoc] 中有相关概述。如果在具体变量后没有%，则格式化程序默认使用 %s（串型）格式。 - -### raw 插值器 - -除了对字面值中的字符不做编码外，raw 插值器与 s 插值器在功能上是相同的。如下是个被处理过的字符串： - - scala>s"a\nb" - res0:String= - a - b -这里，s 插值器用回车代替了\n。而raw插值器却不会如此处理。 - - scala>raw"a\nb" - res1:String=a\nb -当不想输入\n被转换为回车的时候，raw 插值器是非常实用的。 - -除了以上三种字符串插值器外，使用者可以自定义插值器。 - -### 高级用法 - -在Scala中，所有处理过的字符串字面值都进行了简单编码转换。任何时候编译器遇到一个如下形式的字符串字面值： - - id"string content" -它都会被转换成一个StringContext实例的call(id)方法。这个方法在隐式范围内仍可用。只需要简单得 -建立一个隐类，给StringContext实例增加一个新方法，便可以定义我们自己的字符串插值器。如下例： - - //注意：为了避免运行时实例化，我们从AnyVal中继承。 - //更多信息请见值类的说明 - implicit class JsonHelper(val sc:StringContext) extends AnyVal{ - def json(args:Any*):JSONObject=sys.error("TODO-IMPLEMENT") - } - - def giveMeSomeJson(x:JSONObject):Unit=... - - giveMeSomeJson(json"{name:$name,id:$id}") -在这个例子中，我们试图通过字符串插值生成一个JSON文本语法。隐类 JsonHelper 作用域内使用该语法，且这个JSON方法需要一个完整的实现。只不过，字符串字面值格式化的结果不是一个字符串，而是一个JSON对象。 - -当编译器遇到"{name:$name,id:$id"}"，它将会被重写成如下表达式： - - new StringContext("{name:",",id:","}").json(name,id) - -隐类则被重写成如下形式 - - new JsonHelper(new StringContext("{name:",",id:","}")).json(name,id) - -所以，JSON方法可以访问字符串的原生片段而每个表达式都是一个值。这个方法的一个简单但又令人迷惑的例子： - - implicit class JsonHelper(val sc:StringContext) extends AnyVal{ - def json(args:Any*):JSONObject={ - val strings=sc.parts.iterator - val expressions=args.iterator - var buf=new StringBuilder(strings.next()) - while(strings.hasNext){ - buf.append(expressions.next()) - buf.append(strings.next()) - } - parseJson(buf) - } - } - -被处理过的字符串的每部分都是StringContext的成员。每个表达式的值都将传入到JSON方法的args参数。JSON方法接受这些值并合成一个大字符串，然后再解析成JSON格式。有一种更复杂的实现可以避免合成字符串的操作，它只是简单的直接通过原生字符串和表达式值构建JSON。 - -## 限制 - -字符串插值目前对模式匹配语句不适用。此特性将在2.11版本中生效。 From b870861e24c5adf9cf2e06a54562a52783668c1d Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 19 Jan 2024 16:47:54 +0100 Subject: [PATCH 2772/3075] fix next page for first-look-at-types --- _zh-cn/overviews/scala3-book/first-look-at-types.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/first-look-at-types.md b/_zh-cn/overviews/scala3-book/first-look-at-types.md index a2c876654b..0c8fb09744 100644 --- a/_zh-cn/overviews/scala3-book/first-look-at-types.md +++ b/_zh-cn/overviews/scala3-book/first-look-at-types.md @@ -5,7 +5,7 @@ description: This page provides a brief introduction to Scala's built-in data ty language: zh-cn num: 17 previous-page: taste-summary -next-page: control-structures +next-page: string-interpolation partof: scala3-book overview-name: "Scala 3 — Book" From beea7fb1334dacf94e99b68c65a4f6b2b82a86a4 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 20 Jan 2024 00:21:31 +0000 Subject: [PATCH 2773/3075] Update SIPs state --- _sips/sips/42.type.md | 90 ++++++++++++------------- _sips/sips/alternative-bind-patterns.md | 7 ++ _sips/sips/multiple-assignments.md | 7 ++ _sips/sips/named-tuples.md | 4 +- 4 files changed, 61 insertions(+), 47 deletions(-) create mode 100644 _sips/sips/alternative-bind-patterns.md create mode 100644 _sips/sips/multiple-assignments.md diff --git a/_sips/sips/42.type.md b/_sips/sips/42.type.md index f143c9a8ab..c35552cf51 100644 --- a/_sips/sips/42.type.md +++ b/_sips/sips/42.type.md @@ -33,17 +33,17 @@ their role is to give the meaning of paths selecting types and terms from nested paths have an intuitive meaning to programmers from a wide range of backgrounds which belies their underpinning by a somewhat "advanced" concept in type theory. -Nevertheless, by pairing a type with it's unique inhabitant, singleton types bridge the gap between -types and values, and their presence in Scala has over the years allowed Scala programmers to explore -techniques which would typically only be available in languages, such as Agda or Idris, with support +Nevertheless, by pairing a type with its unique inhabitant, singleton types bridge the gap between +types and values, and their presence in Scala has, over the years, allowed Scala programmers to explore +techniques which would typically only be available in languages such as Agda or Idris, with support for full-spectrum dependent types. Scala's semantics have up until now been richer than its syntax. The only singleton types which are currently _directly_ expressible are those of the form `p.type` where `p` is a path pointing to a value of some subtype of `AnyRef`. Internally the Scala compiler also represents singleton types for -individual values of subtypes of `AnyVal`, such as `Int` or values of type `String` which don't +individual values of subtypes of `AnyVal`, such as `Int` or values of type `String`, which don't correspond to paths. These types are inferred in some circumstances, notably as the types of `final` -vals. Their primary purpose has been to represent compile time constants (see [6.24 Constant +vals. Their primary purpose has been to represent compile-time constants (see [6.24 Constant Expressions](https://scala-lang.org/files/archive/spec/2.12/06-expressions.html#constant-expressions) and the discussion of "constant value definitions" in [4.1 Value Declarations and Definitions](https://scala-lang.org/files/archive/spec/2.12/04-basic-declarations-and-definitions.html#value-declarations-and-definitions)). @@ -89,15 +89,15 @@ Lightbend Scala compiler. foo(1: 1) // type ascription ``` -+ The `.type` singleton type forming operator can be applied to values of all subtypes of `Any`. - To prevent the compiler from widening our return type we assign to a final val. ++ The `.type` singleton-type-forming operator can be applied to values of all subtypes of `Any`. + To prevent the compiler from widening our return type, we assign to a final val. ``` def foo[T](t: T): t.type = t final val bar = foo(23) // result is bar: 23 ``` + The presence of an upper bound of `Singleton` on a formal type parameter indicates that - singleton types should be inferred for type parameters at call sites. To help see this + singleton types should be inferred for type parameters at call sites. To help see this, we introduce type constructor `Id` to prevent the compiler from widening our return type. ``` type Id[A] = A @@ -118,7 +118,7 @@ Lightbend Scala compiler. ``` + A `scala.ValueOf[T]` type class and corresponding `scala.Predef.valueOf[T]` operator has been - added yielding the unique value of types with a single inhabitant. + added, yielding the unique value of types with a single inhabitant. ``` def foo[T](implicit v: ValueOf[T]): T = v.value foo[13] // result is 13: Int @@ -129,13 +129,13 @@ Lightbend Scala compiler. Many of the examples below use primitives provided by the Scala generic programming library [shapeless](https://github.com/milessabin/shapeless/). It provides a `Witness` type class and a -family of Scala macro based methods and conversions for working with singleton types and shifting +family of Scala-macro-based methods and conversions for working with singleton types and shifting from the value to the type level and vice versa. One of the goals of this SIP is to enable Scala programmers to achieve similar results without having to rely on a third party library or fragile and non-portable macros. The relevant parts of shapeless are excerpted in [Appendix 1](#appendix-1--shapeless-excerpts). -Given the definitions there, some of forms summarized above can be expressed in current Scala, +Given the definitions there, some of the forms summarized above can be expressed in current Scala, ``` val wOne = Witness(1) val one: wOne.T = wOne.value // wOne.T is the type 1 @@ -147,13 +147,13 @@ foo[wOne.T] // result is 1: 1 "foo" ->> 23 // shapeless record field constructor // result type is FieldType["foo", Int] ``` -The syntax is awkward and hiding it from library users is challenging. Nevertheless they enable many +The syntax is awkward, and hiding it from library users is challenging. Nevertheless they enable many constructs which have proven valuable in practice. #### shapeless records shapeless models records as HLists (essentially nested pairs) of record values with their types -tagged with the singleton types of their keys. The library provides user friendly mechanisms for +tagged with the singleton types of their keys. The library provides user-friendly mechanisms for constructing record _values_, however it is extremely laborious to express the corresponding _types_. Consider the following record value, ``` @@ -165,7 +165,7 @@ val book = HNil ``` -Using shapeless and current Scala the following would be required to give `book` an explicit type +Using shapeless and current Scala, the following would be required to give `book` an explicit type annotation, ``` val wAuthor = Witness("author") @@ -241,20 +241,20 @@ val c: Int Refined Greater[w6.T] = a ^ ``` -Under this proposal we can express these refinements much more succinctly, +Under this proposal, we can express these refinements much more succinctly, ``` val a: Int Refined Greater[5] = 10 val b: Int Refined Greater[4] = a ``` -Type level predicates of this kind have proved to be useful in practice and are supported by modules +Type-level predicates of this kind have proved to be useful in practice and are supported by modules of a [number of important libraries](https://github.com/fthomas/refined#external-modules). Experience with those libraries has led to a desire to compute directly over singleton types, in -effect to lift whole term-level expressions to the type-level which has resulted in the development +effect to lift whole term-level expressions to the type level, which has resulted in the development of the [singleton-ops](https://github.com/fthomas/singleton-ops) library. singleton-ops is built -with Typelevel Scala which allows it to use literal types as discussed in this SIP. +with Typelevel Scala, which allows it to use literal types, as discussed in this SIP. ``` import singleton.ops._ @@ -279,7 +279,7 @@ singleton-ops is used by a number of libraries, most notably our next motivating [Libra](https://github.com/to-ithaca/libra) is a a dimensional analysis library based on shapeless, spire and singleton-ops. It support SI units at the type level for all numeric types. Like -singleton-ops Libra is built using Typelevel Scala and so is able to use literal types as discussed +singleton-ops, Libra is built using Typelevel Scala and so is able to use literal types, as discussed in this SIP. Libra allows numeric computations to be checked for dimensional correctness as follows, @@ -324,7 +324,7 @@ case class Residue[M <: Int](n: Int) extends AnyVal { } ``` -Given this definition we can work with modular numbers without any danger of mixing numbers with +Given this definition, we can work with modular numbers without any danger of mixing numbers with different moduli, ``` @@ -342,7 +342,7 @@ fiveModTen + fourModEleven ``` Also note that the use of `ValueOf` as an implicit argument of `+` means that the modulus does not -need to be stored along with the `Int` in the `Residue` value which could be beneficial in +need to be stored along with the `Int` in the `Residue` value, which could be beneficial in applications which work with large datasets. ### Proposal details @@ -360,7 +360,7 @@ applications which work with large datasets. | ‘(’ Types ‘)’ ``` - Examples, + Examples: ``` val one: 1 = 1 // val declaration def foo(x: 1): Option[1] = Some(x) // param type, type arg @@ -368,7 +368,7 @@ applications which work with large datasets. foo(1: 1) // type ascription ``` -+ The restriction that the singleton type forming operator `.type` can only be appended to ++ The restriction that the singleton-type-forming operator `.type` can only be appended to stable paths designating a value which conforms to `AnyRef` is dropped -- the path may now conform to `Any`. Section [3.2.1](https://scala-lang.org/files/archive/spec/2.12/03-types.html#singleton-types) of the SLS is @@ -385,7 +385,7 @@ applications which work with large datasets. > denoted by `p` (i.e., the value `v` for which `v eq p`). Where the path does not conform to > `scala.AnyRef` the type denotes the set consisting of only the value denoted by `p`. - Example, + Example: ``` def foo[T](t: T): t.type = t final val bar = foo(23) // result is bar: 23 @@ -471,7 +471,7 @@ applications which work with large datasets. > corresponding to a singleton-apt definition, or (2) The upper bound Ui of Ti conforms to > `Singleton`. - Example, + Example: ``` type Id[A] = A def wide[T](t: T): Id[T] = t @@ -483,17 +483,17 @@ applications which work with large datasets. Note that we introduce the type constructor `Id` simply to avoid widening of the return type. + A `scala.ValueOf[T]` type class and corresponding `scala.Predef.valueOf[T]` operator has been - added yielding the unique value of types with a single inhabitant. + added, yielding the unique value of types with a single inhabitant. Type inference allows us to infer a singleton type from a literal value. It is natural to want to be able to go in the other direction and infer a value from a singleton type. This latter capability was exploited in the motivating `Residue` example given earlier, and is widely relied - on in current Scala in uses of shapeless's records, and `LabelledGeneric` based type class + on in current Scala in uses of shapeless's records, and `LabelledGeneric`-based type class derivation. - Implicit resolution is Scala's mechanism for inferring values from types and in current Scala + Implicit resolution is Scala's mechanism for inferring values from types, and in current Scala, shapeless provides a macro-based materializer for instances of its `Witness` type class. This SIP - adds a directly compiler supported type class as a replacement, + adds a directly compiler-supported type class as a replacement: ``` final class ValueOf[T](val value: T) extends AnyVal @@ -502,20 +502,20 @@ applications which work with large datasets. Instances are automatically provided for all types with a single inhabitant, which includes literal and non-literal singleton types and `Unit`. - Example, + Example: ``` def foo[T](implicit v: ValueOf[T]): T = v.value foo[13] // result is 13: Int ``` - A method `valueOf` is also added to `scala.Predef` analogously to existing operators such as + A method `valueOf` is also added to `scala.Predef`, analogously to existing operators such as `classOf`, `typeOf` etc. ``` def valueOf[T](implicit vt: ValueOf[T]): T = vt.value ``` - Example, + Example: ``` object Foo valueOf[Foo.type] // result is Foo: Foo.type @@ -531,11 +531,11 @@ applications which work with large datasets. where the `TypePat` is a literal type is translated as a match against the subsuming non-singleton type followed by an equality test with the value corresponding to the literal type. - Where applied to literal types `isInstanceOf` is translated to a test against + Where applied to literal types, `isInstanceOf` is translated to a test against the subsuming non-singleton type and an equality test with the value corresponding to the literal type. - Examples, + Examples: ``` (1: Any) match { case one: 1 => true @@ -544,28 +544,28 @@ applications which work with large datasets. (1: Any).isInstanceOf[1] // result is true: Boolean ``` - Importantly, that doesn't include `asInstanceOf` as that is a user assertion to the compiler, with + Importantly, that doesn't include `asInstanceOf`, as that is a user assertion to the compiler, with the compiler inserting in the generated code just enough code for the underlying runtime to not give a `ValidationError`. The compiler should not, for instance, generate code such that an expression like `(1: Any).asInstanceOf[2]` would throw a `ClassCastException`. + Default initialization for vars with literal types is forbidden. - The default initializer for a var is already mandated to be it's natural zero element (`0`, - `false`, `null` etc.). This is inconsistent with the var being given a non-zero literal type, + The default initializer for a var is already mandated to be its natural zero element (`0`, + `false`, `null` etc.). This is inconsistent with the var being given a non-zero literal type: ``` var bad: 1 = _ ``` - Whilst we could, in principle, provide an implicit non-default initializer for cases such as these + Whilst we could, in principle, provide an implicit non-default initializer for cases such as these, it is the view of the authors of this SIP that there is nothing to be gained from enabling this - construction and that default initializer should be forbidden. + construction, and that default initializer should be forbidden. -## Follow on work from this SIP +## Follow-on work from this SIP Whilst the authors of this SIP believe that it stands on its own merits, we think that there are two -areas where follow on work is desirable, and one area where another SIP might improve the implementation of SIP-23. +areas where follow-on work is desirable, and one area where another SIP might improve the implementation of SIP-23. ### Infix and prefix types @@ -573,7 +573,7 @@ areas where follow on work is desirable, and one area where another SIP might im has emerged from the work on refined types and computation over singleton types mentioned in the motivation section above. -Once literal types are available it is natural to want to lift entire expressions to the type level +Once literal types are available, it is natural to want to lift entire expressions to the type level as is done already in libraries such as [singleton-ops](https://github.com/fthomas/singleton-ops). However, the precedence and associativity of symbolic infix _type constructors_ don't match the precedence and associativity of symbolic infix _value operators_, and prefix type constructors don't @@ -583,12 +583,12 @@ terms. ### Byte and short literals `Byte` and `Short` have singleton types, but lack any corresponding syntax either at the type or at the term level. -These types are important in libraries which deal with low level numerics and protocol implementation +These types are important in libraries which deal with low-level numerics and protocol implementation (see eg. [Spire](https://github.com/non/spire) and [Scodec](https://github.com/scodec/scodec)) and elsewhere, and the ability to, for instance, index a type class by a byte or short literal would be valuable. -A prototype of this syntax extension existed at an early stage in the development of Typelevel Scala +A prototype of this syntax extension existed at an early stage in the development of Typelevel Scala, but never matured. The possibility of useful literal types adds impetus. ### Opaque types @@ -610,7 +610,7 @@ would be elided, and the `valueOf[A]` method would be compiled to an identity fu ## Appendix 1 -- shapeless excerpts -Extracts from shapeless relevant to the motivating examples for this SIP, +Extracts from shapeless relevant to the motivating examples for this SIP: ``` trait Witness { diff --git a/_sips/sips/alternative-bind-patterns.md b/_sips/sips/alternative-bind-patterns.md new file mode 100644 index 0000000000..871508d44f --- /dev/null +++ b/_sips/sips/alternative-bind-patterns.md @@ -0,0 +1,7 @@ +--- +title: SIP-60 - Alternative bind patterns +status: under-review +pull-request-number: 74 +stage: design + +--- diff --git a/_sips/sips/multiple-assignments.md b/_sips/sips/multiple-assignments.md new file mode 100644 index 0000000000..19335b3fe7 --- /dev/null +++ b/_sips/sips/multiple-assignments.md @@ -0,0 +1,7 @@ +--- +title: SIP-59 - Multiple assignments +status: under-review +pull-request-number: 73 +stage: design + +--- diff --git a/_sips/sips/named-tuples.md b/_sips/sips/named-tuples.md index 6e15896334..82bc141811 100644 --- a/_sips/sips/named-tuples.md +++ b/_sips/sips/named-tuples.md @@ -1,7 +1,7 @@ --- title: SIP-58 - Named Tuples -status: submitted +status: under-review pull-request-number: 72 -stage: pre-sip +stage: design --- From 16e46c2e3d90d749de70484b23303f7b2348920c Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 23 Jan 2024 00:22:35 +0000 Subject: [PATCH 2774/3075] Update SIPs state --- _sips/sips/match-types-spec.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_sips/sips/match-types-spec.md b/_sips/sips/match-types-spec.md index ca20238e19..6609d9312c 100644 --- a/_sips/sips/match-types-spec.md +++ b/_sips/sips/match-types-spec.md @@ -1,8 +1,8 @@ --- layout: sip permalink: /sips/:title.html -stage: implementation -status: waiting-for-implementation +stage: completed +status: accepted title: SIP-56 - Proper Specification for Match Types --- From cec537ccd240bb9b7c87338d322bfc6ca77300ad Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Wed, 24 Jan 2024 10:42:00 +0100 Subject: [PATCH 2775/3075] remove link in Scala on Android tutorial it was a Google Drive link to a pre built demo of the application. It's not critical to reading the tutorial. --- _overviews/tutorials/scala-on-android.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/_overviews/tutorials/scala-on-android.md b/_overviews/tutorials/scala-on-android.md index ba6e891798..459e485ce8 100644 --- a/_overviews/tutorials/scala-on-android.md +++ b/_overviews/tutorials/scala-on-android.md @@ -124,9 +124,7 @@ If everything works, and you see the app’s screen on your device, type `adb lo * [Log Viewer for Android Studio and IntelliJ](https://plugins.jetbrains.com/plugin/10015-log-viewer) * [Logcat plugin for VSCode](https://marketplace.visualstudio.com/items?itemName=abhiagr.logcat) -Here's a [screenshot](https://github.com/makingthematrix/scalaonandroid/blob/main/helloscala/helloscala.png) of what the app looks like when you open it. - -And [from here](https://drive.google.com/file/d/1SV5waXjyEYSSlo-mfj28WF34mcMFxoG7/view?usp=sharing) you can download the already compiled APK. +Here's a [screenshot](https://github.com/makingthematrix/scalaonandroid/blob/main/helloscala/helloscala.png) of what the app looks like when you open it. ## Next Steps and Other Useful Reading From 68e3b5ce9fe30c43a7249f4d3675ffd441cefab2 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Thu, 25 Jan 2024 17:37:56 +0800 Subject: [PATCH 2776/3075] upate translate according to latest English version. (#2954) --- _zh-cn/overviews/scala3-book/types-others.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_zh-cn/overviews/scala3-book/types-others.md b/_zh-cn/overviews/scala3-book/types-others.md index 788814ea01..eec6faada8 100644 --- a/_zh-cn/overviews/scala3-book/types-others.md +++ b/_zh-cn/overviews/scala3-book/types-others.md @@ -25,6 +25,8 @@ Scala还有其他几种高级类型，本书中没有介绍，包括： - 种类多态性 有关这些类型的更多详细信息，请参阅[参考文档][reference]。 +有关单例类型参见 Scala 3 规格中的[字面量类型](https://scala-lang.org/files/archive/spec/3.4/03-types.html#literal-types) 一节， +细化类型参见[细化类型](https://scala-lang.org/files/archive/spec/3.4/03-types.html) 一节。 [reference]: {{ site.scala3ref }}/overview.html From eacae04d6f121809bfd30cd7d2179e1e9c3dac10 Mon Sep 17 00:00:00 2001 From: Anatolii Kmetiuk <anatoliykmetyuk@gmail.com> Date: Fri, 26 Jan 2024 13:38:36 +0100 Subject: [PATCH 2777/3075] Following his resignation notice, remove Gabriele from the current SIP committee members. --- _sips/process-specification.md | 117 ++++++++++++++++----------------- 1 file changed, 58 insertions(+), 59 deletions(-) diff --git a/_sips/process-specification.md b/_sips/process-specification.md index a35aeaeef1..8263fae131 100644 --- a/_sips/process-specification.md +++ b/_sips/process-specification.md @@ -4,14 +4,14 @@ title: Process Specification redirect_from: /sips/sip-submission.html --- -The Scala Improvement Process (sometimes called SIP process) is a process for +The Scala Improvement Process (sometimes called SIP process) is a process for submitting changes to the Scala language. This process aims to evolve Scala openly and collaboratively. -The SIP process covers the Scala language (syntax, type system and semantics) +The SIP process covers the Scala language (syntax, type system and semantics) and the core of the Scala standard library. The core is anything that is referenced from the language spec (such as primitive types or the definition -of `Seq`). The SIP process is not concerned with compiler changes that do not +of `Seq`). The SIP process is not concerned with compiler changes that do not affect the language (including but not limited to linting warnings, optimizations, quality of error messages). @@ -19,19 +19,19 @@ A proposed change requires a design document, called a Scala Improvement Proposal (SIP). The committee meets monthly to discuss, and eventually vote upon, proposals. -The committee follows the following process when evaluating SIP documents, +The committee follows the following process when evaluating SIP documents, from an idea to the inclusion in the language. ## Definitions - SIP (Scala Improvement Proposal): a particular proposal for changing the Scala language (additions, changes, and/or removals). -- Committee: a group of experienced Scala practitioners and language designers, +- Committee: a group of experienced Scala practitioners and language designers, who evaluate changes to the Scala programming language. It consists of a Secretary, a Chairperson, and Members. -- Chairperson: person in charge of executing the process. They organize and +- Chairperson: person in charge of executing the process. They organize and chair the meetings of the Committee, and generally make sure the process is - followed, but do not vote on proposals. The Chairperson is an appointed + followed, but do not vote on proposals. The Chairperson is an appointed employee of the Scala Center. - Committee Member: member of the Committee with voting rights. The Chairperson cannot be a Member at the same time. @@ -53,7 +53,7 @@ from an idea to the inclusion in the language. ## Stages -From being an idea to being part of the language, a SIP goes through several +From being an idea to being part of the language, a SIP goes through several Stages that indicate the "maturity" level of the SIP. The following table summarizes the intent of the various stages. @@ -102,49 +102,49 @@ summarizes the intent of the various stages. ### Pre-SIP Stage -To initiate a discussion, any individual opens a "Pre-SIP" post in the Scala -Contributors forum. The post should be in the +To initiate a discussion, any individual opens a "Pre-SIP" post in the Scala +Contributors forum. The post should be in the [Scala Improvement Process](https://contributors.scala-lang.org/c/sip/13) category, and its title should start with "Pre-SIP:". The purpose of the Pre-SIP post is to present an idea to the Scala community: a Pre-SIP should present a -problem that needs solving (i.e., motivate the changes) and present possible +problem that needs solving (i.e., motivate the changes) and present possible solutions with pros and cons. The community is encouraged to engage in the discussions by voicing support, comments and concerns. -During the Pre-SIP stage, the Committee is not required to be involved. -Committee Members and the Chairperson are expected to follow Pre-SIP +During the Pre-SIP stage, the Committee is not required to be involved. +Committee Members and the Chairperson are expected to follow Pre-SIP discussions, but not required to engage. -Once at least one month has passed and the author has built some community -support for their Pre-SIP, they can Submit a SIP for discussion by the +Once at least one month has passed and the author has built some community +support for their Pre-SIP, they can Submit a SIP for discussion by the Committee. "Community support" is loosely defined. It involves a mix of positive -comments, likes, etc. Generally, the Chairperson or a Committee member will post -a comment on the thread suggesting to submit a SIP when they see that a Pre-SIP +comments, likes, etc. Generally, the Chairperson or a Committee member will post +a comment on the thread suggesting to submit a SIP when they see that a Pre-SIP is ready to enter the process. ### Entry into the process (SIP Submission) -To submit a SIP, a SIP Author writes a pull request to the -[scala/improvement-proposals](https://github.com/scala/improvement-proposals) -repository, following the [tutorial]({% link _sips/sip-tutorial.md %}), and -pointing to the Pre-SIP discussion. If the proposal correctly follows the +To submit a SIP, a SIP Author writes a pull request to the +[scala/improvement-proposals](https://github.com/scala/improvement-proposals) +repository, following the [tutorial]({% link _sips/sip-tutorial.md %}), and +pointing to the Pre-SIP discussion. If the proposal correctly follows the template, and the Pre-SIP discussion seems to show some community support, the Chairperson will accept the SIP for review, assign a SIP number, assign 3 reviewers to the SIP among the Committee Members, and assign one of the reviewers to be the Manager of that SIP. Since "community support" is loosely defined, any Committee Member can also comment on the PR to accept the -SIP for review (this is meant mostly as an escape hatch to prevent the -Chairperson from unilaterally blocking a SIP from entering the process). From +SIP for review (this is meant mostly as an escape hatch to prevent the +Chairperson from unilaterally blocking a SIP from entering the process). From that point onwards, the SIP has entered the Design Stage. If the template has not been correctly followed, or if none of the Committee -Members nor the Chairperson think that the Pre-SIP has gathered enough support, +Members nor the Chairperson think that the Pre-SIP has gathered enough support, the PR may be closed after 2 weeks. ### PR states and GitHub labels -As soon as a SIP PR is opened, the GitHub labels `stage:pre-sip` and -`status:submitted` are applied to it. At any given moment, a SIP PR will have as +As soon as a SIP PR is opened, the GitHub labels `stage:pre-sip` and +`status:submitted` are applied to it. At any given moment, a SIP PR will have as labels one of the following possibilities: | | | | @@ -167,21 +167,21 @@ labels one of the following possibilities: Once a SIP has entered the Design Stage, the assigned reviewers will review (as a GitHub Review on the SIP PR) the proposal within 3 weeks. The authors may then address the concerns by pushing additional commits and ask for a new review. -This phase is iterative, like any pull request to an implementation repository. -After each request for a new review, the reviewers have 3 weeks to do another +This phase is iterative, like any pull request to an implementation repository. +After each request for a new review, the reviewers have 3 weeks to do another round. -When the reviewers are confident that the SIP is in good shape to be discussed -with the full Committee, the Manager sets its status to "Vote Requested" and decide on a -Vote Recommendation that they will bring to the Committee. A Vote Recommendation +When the reviewers are confident that the SIP is in good shape to be discussed +with the full Committee, the Manager sets its status to "Vote Requested" and decide on a +Vote Recommendation that they will bring to the Committee. A Vote Recommendation is either "Recommend Accept" or "Recommend Reject". The proposal is then -scheduled on the agenda of the next Committee meeting (which happens once a +scheduled on the agenda of the next Committee meeting (which happens once a month). At any time, the SIP Author may voluntarily Withdraw their SIP, in which case it exits the process. It is possible for someone else (or the same person) to -become the new SIP Author for that SIP, and therefore bring it back to the -process. If a SIP Author does not follow up on Reviewers' comments for 2 months, +become the new SIP Author for that SIP, and therefore bring it back to the +process. If a SIP Author does not follow up on Reviewers' comments for 2 months, the SIP will automatically be considered to be Withdrawn. ### Design Stage -- Vote @@ -194,11 +194,11 @@ the Implementation Stage. There are three possible outcomes: - Accept for implementation: the proposal then advances to the Implementation Stage, and therefore becomes a formal recommendation to be implemented as an Experimental feature into the compiler. -- Reject: the proposal is rejected and the PR closed. It exits the process at - this point. The reviewers will communicate on the PR the reason(s) for the +- Reject: the proposal is rejected and the PR closed. It exits the process at + this point. The reviewers will communicate on the PR the reason(s) for the rejection. -- Keep: the proposal remains in the Design Stage for further iterations. The - reviewers will communicate on the PR the current concerns raised by the +- Keep: the proposal remains in the Design Stage for further iterations. The + reviewers will communicate on the PR the current concerns raised by the Committee. In order to be accepted for implementation and advance to the next stage, a SIP @@ -207,7 +207,7 @@ must gather strictly more than 50% of "Advance" votes among the whole Committee. For instance, if the Committee is made of 11 members, at least 6 members have to vote "Advance" for the SIP to move to the next stage. If there was a strict majority in favor of "Advance", the PR for the SIP is Merged at this point by its Manager. -Otherwise, a second vote between +Otherwise, a second vote between Reject and Keep will be used. A proposal needs more than 50% "Reject" votes to be rejected in that case. Otherwise, it is kept. @@ -231,10 +231,10 @@ An implementation will be reviewed by the compiler team, and once the implementation is deemed good enough, it can ship as an Experimental feature in the next release of the compiler where it's practical to do so. At that point, the SIP Manager posts a follow-up comment on the Pre-SIP discussion to invite the community to test the feature and provide feedback. -The implementers may hit challenges that were not foreseen by the Committee. -Early users may also provide feedback based on practical experience with the -Experimental feature. This feedback can be sent back to the Committee by -implementers. This is done with a PR to the SIP repository, amending the +The implementers may hit challenges that were not foreseen by the Committee. +Early users may also provide feedback based on practical experience with the +Experimental feature. This feedback can be sent back to the Committee by +implementers. This is done with a PR to the SIP repository, amending the previously merged SIP document or raising questions for challenges. In that case, the SIP Author and Reviewers will work together with the implementers to address the feedback. This is again an iterative process. Reviewers may merge @@ -249,10 +249,10 @@ rejected, with the same rules as in the "Design Stage -- Vote" section. ### Completed Stage -Once a SIP is accepted for shipping, it will be enabled by default (as +Once a SIP is accepted for shipping, it will be enabled by default (as non-Experimental) in the next practical Minor release of the language. -From this point onwards, the feature is stable and cannot be changed anymore. +From this point onwards, the feature is stable and cannot be changed anymore. Any further changes would have to come as an entirely new SIP. ## The SIP Committee @@ -261,7 +261,6 @@ The current committee members are: - Björn Regnell ([@bjornregnell](https://github.com/bjornregnell)), Lund University - Chris Andrews ([@chrisandrews-ms](https://github.com/chrisandrews-ms)), Morgan Stanley -- Gabriele Petronella ([@gabro](https://github.com/gabro)), buildo - Guillaume Martres ([@smarter](https://github.com/smarter)), EPFL - Haoyi Li ([@lihaoyi](https://github.com/lihaoyi)), Databricks - Lukas Rytz ([@lrytz](https://github.com/lrytz)), Lightbend @@ -280,16 +279,16 @@ The current Secretary is: ### Committee Meetings -The plenary Committee Meetings are scheduled monthly by the Chairperson. They +The plenary Committee Meetings are scheduled monthly by the Chairperson. They have the following purposes: - Vote to accept, keep or reject SIPs that are in a "Vote Requested" state -- Be aware of the list of SIPs that are "Under review". If a SIP stays too long - under review, Committee Members may request for it to be put to discussion +- Be aware of the list of SIPs that are "Under review". If a SIP stays too long + under review, Committee Members may request for it to be put to discussion and/or vote in a subsequent plenary meeting, even if the Reviewers do not - think it is ready. This is meant primarily as an escape hatch, preventing + think it is ready. This is meant primarily as an escape hatch, preventing Reviewers from blocking a SIP by infinitely stalling it. -- Make any exception to the process that they judge necessary to unblock a +- Make any exception to the process that they judge necessary to unblock a situation. If a Committee Member cannot attend a meeting, they are welcome to share their feedback about the proposals listed in the agenda of the meeting with the Chairperson, who will relate it during the meeting. A Committee Member cannot give their voting power to someone else. If a Committee Member misses more than 2 meetings within a year, they lose their seat. @@ -313,18 +312,18 @@ the current state of the proposal, both its design and implementation. ### On what basis are proposals evaluated? -The Committee ultimately decides how to evaluate proposals, and on what grounds. -The Committee does not need to justify its decisions, although it is highly +The Committee ultimately decides how to evaluate proposals, and on what grounds. +The Committee does not need to justify its decisions, although it is highly encouraged to provide reasons. -Nevertheless, here is a non-exhaustive list of things that the Reviewers and +Nevertheless, here is a non-exhaustive list of things that the Reviewers and Committee are encouraged to take into account: - The proposal follows the "spirit" of Scala - The proposal is well motivated; it solves a recurring problem -- The proposal evaluates the pros and cons of its solution; the solution put +- The proposal evaluates the pros and cons of its solution; the solution put forward is believed to be the best one -- The proposal can be implemented in a way that does not break backward binary +- The proposal can be implemented in a way that does not break backward binary nor TASTy compatibility - The proposal makes an effort not to break backward source compatibility - The proposal does not change the meaning of existing programs @@ -332,9 +331,9 @@ Committee are encouraged to take into account: ## Exceptions and changes -The present document tries to account for most situations that could occur in -the lifetime of SIPs. However, it does not pretend to be an ultimate solution to -all cases. At any time, the Committee can decide, by consensus, to make +The present document tries to account for most situations that could occur in +the lifetime of SIPs. However, it does not pretend to be an ultimate solution to +all cases. At any time, the Committee can decide, by consensus, to make exceptions to the process, or to refine the process. ## How do I submit? From 197e00acdd1e46ab7754ef5d0eb4f1a44640eef7 Mon Sep 17 00:00:00 2001 From: Anatolii Kmetiuk <anatoliykmetyuk@gmail.com> Date: Fri, 26 Jan 2024 13:43:27 +0100 Subject: [PATCH 2778/3075] Add SIP meeting results for November 17th, December 15th, and January 19th --- _sips/results/2023-11-17-meeting.md | 9 +++++++++ _sips/results/2023-12-15-meeting.md | 7 +++++++ _sips/results/2024-01-19-meeting.md | 9 +++++++++ 3 files changed, 25 insertions(+) create mode 100644 _sips/results/2023-11-17-meeting.md create mode 100644 _sips/results/2023-12-15-meeting.md create mode 100644 _sips/results/2024-01-19-meeting.md diff --git a/_sips/results/2023-11-17-meeting.md b/_sips/results/2023-11-17-meeting.md new file mode 100644 index 0000000000..fcb63c9e26 --- /dev/null +++ b/_sips/results/2023-11-17-meeting.md @@ -0,0 +1,9 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 17th November 2023 +partof: results +proposals: + - url: https://docs.scala-lang.org/sips/match-types-spec.html + name: SIP-56 - Proper Specification for Match Types + result: accepted +--- diff --git a/_sips/results/2023-12-15-meeting.md b/_sips/results/2023-12-15-meeting.md new file mode 100644 index 0000000000..647b689123 --- /dev/null +++ b/_sips/results/2023-12-15-meeting.md @@ -0,0 +1,7 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 12th December 2023 +partof: results +proposals: [] +--- +No voting was held on this meeting. \ No newline at end of file diff --git a/_sips/results/2024-01-19-meeting.md b/_sips/results/2024-01-19-meeting.md new file mode 100644 index 0000000000..23f2f49c6a --- /dev/null +++ b/_sips/results/2024-01-19-meeting.md @@ -0,0 +1,9 @@ +--- +layout: sip-meeting-results +title: SIP Meeting Results - 19th January 2024 +partof: results +proposals: + - url: https://docs.scala-lang.org/sips/match-types-spec.html + name: SIP-56 - Proper Specification for Match Types + result: accepted as completed +--- From 0a1660a67eb9052f9abbdc33d71f5ad5ba8d6bd4 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 29 Jan 2024 18:52:43 +0800 Subject: [PATCH 2779/3075] update translate according to English version. (#2952) --- _zh-cn/overviews/scala3-book/fp-intro.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_zh-cn/overviews/scala3-book/fp-intro.md b/_zh-cn/overviews/scala3-book/fp-intro.md index 8b2563b97b..4805401aec 100644 --- a/_zh-cn/overviews/scala3-book/fp-intro.md +++ b/_zh-cn/overviews/scala3-book/fp-intro.md @@ -15,7 +15,7 @@ permalink: "/zh-cn/scala3/book/:title.html" Scala 允许您以面向对象编程 (OOP) 风格、函数式编程 (FP) 风格以及混合风格编写代码——结合使用这两种方法。 -[正如 Martin Odersky 所说](https://twitter.com/alexelcu/status/996408359514525696)，Scala 的本质是在类型化设置中融合了函数式编程和面向对象编程： +正如 Scala 的创建者 Martin Odersky 所说，Scala 的本质是在类型化设置中融合了函数式编程和面向对象编程： - 逻辑函数 - 模块化的对象 From 7b5417e908523430fbfcc3e4924bc475d87bf59a Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Mon, 29 Jan 2024 18:52:56 +0800 Subject: [PATCH 2780/3075] update translate according to newest English version. (#2950) --- _zh-cn/index.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/_zh-cn/index.md b/_zh-cn/index.md index fedb5b7c5b..53df7a316e 100644 --- a/_zh-cn/index.md +++ b/_zh-cn/index.md @@ -1,6 +1,7 @@ --- layout: landing-page language: zh-cn + title: 学习 Scala namespace: root discourse: true @@ -25,8 +26,12 @@ sections: description: "通过一系列小课程来学习 Scala。" icon: "fa fa-book" link: /zh-cn/scala3/book/introduction.html + - title: "Scala 工具箱" + description: "发送 HTTP 请求，写文件，运行进程，解析 JSON... " + icon: "fa fa-toolbox" + link: /toolkit/introduction.html - title: "在线课程" - description: "新手和有经验的程序员在 moocs 学习 Scala。" + description: "新手和有经验的程序员在 MOOCS 学习 Scala。" icon: "fa fa-cloud" link: /online-courses.html - title: 书籍 @@ -60,10 +65,14 @@ sections: description: "Scala 语言特性的常见问题及答案。" icon: "fa fa-question-circle" link: /tutorials/FAQ/index.html - - title: "语言规范" - description: "语言规范" + - title: "语言规范 v2.x" + description: "Scala 2 正式的语言规范。" + icon: "fa fa-book" + link: https://scala-lang.org/files/archive/spec/2.13/ + - title: "语言规范 v3.x" + description: "Scala 3 正式的语言规范。" icon: "fa fa-book" - link: https://scala-lang.org/files/archive/spec/2.12/ + link: https://scala-lang.org/files/archive/spec/3.4/ - title: "Scala 3 语言参考" description: "Scala 3 语言参考" icon: "fa fa-book" From 4a14348c60b4b2134d907b8624c9b1db56166d4a Mon Sep 17 00:00:00 2001 From: Yubao Liu <yubao.liu@gmail.com> Date: Tue, 30 Jan 2024 18:16:23 +0800 Subject: [PATCH 2781/3075] Fix syntax error on Scala 3.3.1 (#2958) --- _overviews/scala3-book/scala-for-java-devs.md | 4 ++-- _zh-cn/overviews/scala3-book/scala-for-java-devs.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index 4a1db9de24..d7d921b060 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -513,8 +513,8 @@ These interfaces and traits have concrete, implemented methods (default methods) <br> <br>// mix in the traits as DavidBanner <br>// is created - <br>val hulk = new DavidBanner with Big, - <br>  Angry, Green</code> + <br>val hulk = new DavidBanner with Big with Angry with Green + </code> </td> </tr> </tbody> diff --git a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md index c0072a95d0..918c1779aa 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md @@ -499,8 +499,8 @@ Scala不遵循JavaBeans标准，因此我们在这里展示的Java代码 <br> <br>// mix in the traits as DavidBanner <br>// is created - <br>val hulk = new DavidBanner with Big, - <br>  Angry, Green</code> + <br>val hulk = new DavidBanner with Big with Angry with Green + </code> </td> </tr> </tbody> From 271374ebba2eb2140e4902a920a481a3dd425a53 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 31 Jan 2024 14:11:57 -0500 Subject: [PATCH 2782/3075] CI: bump actions versions --- .github/workflows/build.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 0fc6596889..628a2cd71a 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -4,14 +4,14 @@ jobs: build: runs-on: ubuntu-20.04 steps: - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Set up Ruby uses: ruby/setup-ruby@v1 with: ruby-version: 3.0.5 bundler-cache: true - name: Set up coursier - uses: coursier/setup-action@v1.2.0-M2 + uses: coursier/setup-action@v1.3.4 with: jvm: adopt:11 - name: Run mdoc From feec5a87526e50f683719c5de448d3e6613b7a87 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 31 Jan 2024 14:23:30 -0500 Subject: [PATCH 2783/3075] fix 404 (and change http to https) --- _overviews/scala-book/sbt-scalatest-bdd.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala-book/sbt-scalatest-bdd.md b/_overviews/scala-book/sbt-scalatest-bdd.md index 2699fd4244..29ba5e1eb6 100644 --- a/_overviews/scala-book/sbt-scalatest-bdd.md +++ b/_overviews/scala-book/sbt-scalatest-bdd.md @@ -113,5 +113,5 @@ If you want to have a little fun with this, change one or more of the tests so t For more information about sbt and ScalaTest, see the following resources: -- [The main sbt documentation](http://www.scala-sbt.org/documentation.html) -- [The ScalaTest documentation](http://www.scalatest.org/user_guide) +- [The main sbt documentation](https://www.scala-sbt.org/1.x/docs/) +- [The ScalaTest documentation](https://www.scalatest.org/user_guide) From e1fb738b4a56c7df7515c8ef7ff8616a103a0793 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 1 Feb 2024 09:03:13 -0500 Subject: [PATCH 2784/3075] bump coursier/setup-action version to 1.3.5 (was .4) (#2962) --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 628a2cd71a..4ba997628b 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -11,7 +11,7 @@ jobs: ruby-version: 3.0.5 bundler-cache: true - name: Set up coursier - uses: coursier/setup-action@v1.3.4 + uses: coursier/setup-action@v1.3.5 with: jvm: adopt:11 - name: Run mdoc From 5ea71db62efc6c3301ffd811ddb334d494921670 Mon Sep 17 00:00:00 2001 From: kenji yoshida <6b656e6a69@gmail.com> Date: Mon, 5 Feb 2024 19:43:18 +0900 Subject: [PATCH 2785/3075] remove lagom (#2963) --- _overviews/scala3-book/scala-features.md | 4 +--- _ru/scala3/book/scala-features.md | 4 +--- _zh-cn/overviews/scala3-book/scala-features.md | 4 +--- 3 files changed, 3 insertions(+), 9 deletions(-) diff --git a/_overviews/scala3-book/scala-features.md b/_overviews/scala3-book/scala-features.md index d6f72d1873..c1427e8a65 100644 --- a/_overviews/scala3-book/scala-features.md +++ b/_overviews/scala3-book/scala-features.md @@ -367,8 +367,7 @@ val scalaList: Seq[Integer] = JavaClass.getJavaList().asScala.toSeq As you’ll see in the third section of this page, Scala libraries and frameworks like these have been written to power busy websites and work with huge datasets: 1. The [Play Framework](https://www.playframework.com) is a lightweight, stateless, developer-friendly, web-friendly architecture for creating highly-scalable applications -2. [Lagom](https://www.lagomframework.com) is a microservices framework that helps you decompose your legacy monolith and build, test, and deploy entire systems of reactive microservices -3. [Apache Spark](https://spark.apache.org) is a unified analytics engine for big data processing, with built-in modules for streaming, SQL, machine learning and graph processing +2. [Apache Spark](https://spark.apache.org) is a unified analytics engine for big data processing, with built-in modules for streaming, SQL, machine learning and graph processing The [Awesome Scala list](https://github.com/lauris/awesome-scala) shows dozens of additional open source tools that developers have created to build Scala applications. @@ -503,7 +502,6 @@ Some of the more notable libraries are listed below. - [Finatra](https://twitter.github.io/finatra) is Scala services built on TwitterServer and Finagle - [Scala.js](https://www.scala-js.org) is a strongly-typed replacement for JavaScript that provides a safer way to build robust front-end web applications - [ScalaJs-React](https://github.com/japgolly/scalajs-react) lifts Facebook’s React library into Scala.js, and endeavours to make it as type-safe and Scala-friendly as possible -- [Lagom](https://www.lagomframework.com) is a microservices framework that helps you decompose your legacy monolith and build, test, and deploy entire systems of Reactive microservices HTTP(S) libraries: diff --git a/_ru/scala3/book/scala-features.md b/_ru/scala3/book/scala-features.md index c5f6308ac9..5a0f3b50e5 100644 --- a/_ru/scala3/book/scala-features.md +++ b/_ru/scala3/book/scala-features.md @@ -348,8 +348,7 @@ val scalaList: Seq[Integer] = JavaClass.getJavaList().asScala.toSeq были написаны для поддержки загруженных веб-сайтов и работы с огромными наборами данных: 1. [Play Framework](https://www.playframework.com) — это легкая, без сохранения состояния, удобная для web, удобная для разработчиков архитектура для создания масштабируемых приложений -2. [Lagom](https://www.lagomframework.com) — это инфраструктура микросервисов, которая помогает разделить устаревший монолит и создавать, тестировать и развертывать целые системы реактивных микросервисов -3. [Apache Spark](https://spark.apache.org) — это унифицированный аналитический механизм для обработки больших данных со встроенными модулями для потоковой передачи, SQL, машинного обучения и обработки графиков +2. [Apache Spark](https://spark.apache.org) — это унифицированный аналитический механизм для обработки больших данных со встроенными модулями для потоковой передачи, SQL, машинного обучения и обработки графиков В [списке Awesome Scala](https://github.com/lauris/awesome-scala) представлены десятки дополнительных инструментов с открытым исходным кодом, созданных разработчиками для создания приложений Scala. @@ -412,7 +411,6 @@ Scala 3 имеет значительные преимущества по сра - [Finatra](https://twitter.github.io/finatra) — это сервисы Scala, построенные на TwitterServer и Finagle - [Scala.js](https://www.scala-js.org) — это строго типизированная замена JavaScript, обеспечивающая более безопасный способ создания надежных интерфейсных web-приложений - [ScalaJs-React](https://github.com/japgolly/scalajs-react) поднимает библиотеку Facebook React на Scala.js и пытается сделать ее максимально безопасной для типов и удобной для Scala -- [Lagom](https://www.lagomframework.com) — это инфраструктура микросервисов, которая помогает разделить устаревший монолит и создавать, тестировать и развертывать целые системы реактивных микросервисов HTTP(S) библиотеки: diff --git a/_zh-cn/overviews/scala3-book/scala-features.md b/_zh-cn/overviews/scala3-book/scala-features.md index e86815acda..946b8e819f 100644 --- a/_zh-cn/overviews/scala3-book/scala-features.md +++ b/_zh-cn/overviews/scala3-book/scala-features.md @@ -352,8 +352,7 @@ val scalaList: Seq[Integer] = JavaClass.getJavaList().asScala.toSeq 正如您将在本页的第三部分中所看到的那样，已经有诸如此类的 Scala 库和框架被编写出来用于支撑高流量网站以及分析庞大的数据集： 1. [Play Framework](https://www.playframework.com) 是一种用于创建高度可扩展应用程序的轻量级、无状态、对开发者及Web友好的架构 -2. [Lagom](https://www.lagomframework.com) 是一种微服务框架，可帮助您分解遗留的单体应用并构建、测试和部署整个响应式微服务系统 -3. [Apache Spark](https://spark.apache.org) 是一种面向大规模数据处理的统一分析引擎，内置流、SQL、机器学习和图形处理等模块 +2. [Apache Spark](https://spark.apache.org) 是一种面向大规模数据处理的统一分析引擎，内置流、SQL、机器学习和图形处理等模块 [Awesome Scala 列表](https://github.com/lauris/awesome-scala)展示了开发人员为构建 Scala 应用程序而创建的许多其他开源工具。 @@ -471,7 +470,6 @@ Scala 拥有一个充满活力的生态系统，有满足各种需求的库和 - [Finatra](https://twitter.github.io/finatra) 是基于 TwitterServer 和 Finagle 构建的 Scala 服务 - [Scala.js](https://www.scala-js.org) 是 JavaScript 的强类型替代品，它提供了一种更安全的方式以构建稳健的前端 Web 应用程序 - [ScalaJs-React](https://github.com/japgolly/scalajs-react) 将 Facebook 的 React 库整合至 Scala.js，并努力使其尽可能类型安全和 Scala 友好 -- [Lagom](https://www.lagomframework.com) 是一种微服务框架，可帮助您分解遗留的单体应用并构建、测试和部署整个响应式微服务系统 HTTP(S) 库： From f3b233f234334757cb1db8dd386f51cfecba581f Mon Sep 17 00:00:00 2001 From: Lukas Rytz <lukas.rytz@gmail.com> Date: Mon, 12 Feb 2024 12:02:43 +0100 Subject: [PATCH 2786/3075] update ruby setup instructions --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 49eb207f83..6a32febe4c 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,15 @@ This repository contains the source for the Scala documentation website, as well as the source for "Scala Improvement Process" (SIP) documents. +## Dependencies ## + +This site uses a Jekyll, a Ruby framework. You'll need Ruby and Bundler installed; see [Jekyll installation instructions](https://jekyllrb.com/docs/installation/) for the details. + ## Quickstart ## To build and view the site locally: - gem install --user-install bundler jekyll + bundle install bundle exec jekyll serve -I ([Trouble on MacOS?](https://github.com/scala/docs.scala-lang/issues/1150)) @@ -53,10 +57,6 @@ Small changes, or corrected typos will generally be pulled in right away. Large existing documents will be thoroughly reviewed-- please keep in mind that, generally, new documents must be very well-polished, complete, and maintained in order to be accepted. -## Dependencies ## - -This site uses a Jekyll, a Ruby framework. You'll need Ruby and Bundler installed; see [Jekyll installation instructions](https://jekyllrb.com/docs/installation/) for the details. - ## Building & Viewing ## cd into the directory where you cloned this repository, then install the required gems with `bundle install`. This will automatically put the gems into `./vendor/bundle`. From 8cf713a234c5cc97a857b53d203562f65c453037 Mon Sep 17 00:00:00 2001 From: Lukas Rytz <lukas.rytz@gmail.com> Date: Mon, 12 Feb 2024 12:56:54 +0100 Subject: [PATCH 2787/3075] Add page about Scala 2 -Xsource:3 to migration guide --- .../scala3-migration/external-resources.md | 2 +- .../incompat-contextual-abstractions.md | 2 +- .../incompat-dropped-features.md | 2 +- .../incompat-other-changes.md | 2 +- .../scala3-migration/incompat-syntactic.md | 2 +- .../scala3-migration/incompat-type-checker.md | 2 +- .../incompat-type-inference.md | 2 +- .../scala3-migration/incompatibility-table.md | 2 +- _overviews/scala3-migration/options-intro.md | 2 +- _overviews/scala3-migration/options-lookup.md | 2 +- _overviews/scala3-migration/options-new.md | 2 +- _overviews/scala3-migration/plugin-intro.md | 2 +- .../scala3-migration/plugin-kind-projector.md | 2 +- _overviews/scala3-migration/scala3-migrate.md | 7 +- .../scaladoc-settings-compatibility.md | 2 +- .../tooling-migration-mode.md | 4 +- .../tooling-scala2-xsource3.md | 85 +++++++++++++++++++ .../tooling-syntax-rewriting.md | 2 +- _overviews/scala3-migration/tooling-tour.md | 10 +-- _overviews/scala3-migration/tutorial-intro.md | 2 +- .../tutorial-macro-cross-building.md | 2 +- .../scala3-migration/tutorial-macro-mixing.md | 2 +- .../tutorial-prerequisites.md | 2 +- _overviews/scala3-migration/tutorial-sbt.md | 2 +- 24 files changed, 115 insertions(+), 31 deletions(-) create mode 100644 _overviews/scala3-migration/tooling-scala2-xsource3.md diff --git a/_overviews/scala3-migration/external-resources.md b/_overviews/scala3-migration/external-resources.md index 9f968c6df9..1055f4bc95 100644 --- a/_overviews/scala3-migration/external-resources.md +++ b/_overviews/scala3-migration/external-resources.md @@ -2,7 +2,7 @@ title: External Resources type: chapter description: This section lists external resources about the migration to Scala 3. -num: 28 +num: 29 previous-page: plugin-kind-projector next-page: --- diff --git a/_overviews/scala3-migration/incompat-contextual-abstractions.md b/_overviews/scala3-migration/incompat-contextual-abstractions.md index 502df62f89..ea5947f2e4 100644 --- a/_overviews/scala3-migration/incompat-contextual-abstractions.md +++ b/_overviews/scala3-migration/incompat-contextual-abstractions.md @@ -2,7 +2,7 @@ title: Contextual Abstractions type: section description: This chapter details all incompatibilities caused by the redesign of contextual abstractions -num: 18 +num: 19 previous-page: incompat-dropped-features next-page: incompat-other-changes --- diff --git a/_overviews/scala3-migration/incompat-dropped-features.md b/_overviews/scala3-migration/incompat-dropped-features.md index afdbe00229..845a58b143 100644 --- a/_overviews/scala3-migration/incompat-dropped-features.md +++ b/_overviews/scala3-migration/incompat-dropped-features.md @@ -2,7 +2,7 @@ title: Dropped Features type: section description: This chapter details all the dropped features -num: 17 +num: 18 previous-page: incompat-syntactic next-page: incompat-contextual-abstractions --- diff --git a/_overviews/scala3-migration/incompat-other-changes.md b/_overviews/scala3-migration/incompat-other-changes.md index 90c04abab9..57dc8998da 100644 --- a/_overviews/scala3-migration/incompat-other-changes.md +++ b/_overviews/scala3-migration/incompat-other-changes.md @@ -2,7 +2,7 @@ title: Other Changed Features type: section description: This chapter details all incompatibilities caused by changed features -num: 19 +num: 20 previous-page: incompat-contextual-abstractions next-page: incompat-type-checker --- diff --git a/_overviews/scala3-migration/incompat-syntactic.md b/_overviews/scala3-migration/incompat-syntactic.md index 7ce3b21104..0e88e2b034 100644 --- a/_overviews/scala3-migration/incompat-syntactic.md +++ b/_overviews/scala3-migration/incompat-syntactic.md @@ -2,7 +2,7 @@ title: Syntactic Changes type: section description: This chapter details all the incompatibilities caused by syntactic changes -num: 16 +num: 17 previous-page: incompatibility-table next-page: incompat-dropped-features --- diff --git a/_overviews/scala3-migration/incompat-type-checker.md b/_overviews/scala3-migration/incompat-type-checker.md index 6c6728d4fa..09a6ea0bca 100644 --- a/_overviews/scala3-migration/incompat-type-checker.md +++ b/_overviews/scala3-migration/incompat-type-checker.md @@ -2,7 +2,7 @@ title: Type Checker type: section description: This chapter details the unsoundness fixes in the type checker -num: 20 +num: 21 previous-page: incompat-other-changes next-page: incompat-type-inference --- diff --git a/_overviews/scala3-migration/incompat-type-inference.md b/_overviews/scala3-migration/incompat-type-inference.md index 387bc918c7..a5f1552c06 100644 --- a/_overviews/scala3-migration/incompat-type-inference.md +++ b/_overviews/scala3-migration/incompat-type-inference.md @@ -2,7 +2,7 @@ title: Type Inference type: section description: This chapter details the incompatibilities caused by the new type inference algorithm -num: 21 +num: 22 previous-page: incompat-type-checker next-page: options-intro --- diff --git a/_overviews/scala3-migration/incompatibility-table.md b/_overviews/scala3-migration/incompatibility-table.md index 8148eb7dbc..9fc9f8bf18 100644 --- a/_overviews/scala3-migration/incompatibility-table.md +++ b/_overviews/scala3-migration/incompatibility-table.md @@ -2,7 +2,7 @@ title: Incompatibility Table type: chapter description: This chapter list all the known incompatibilities between Scala 2.13 and Scala 3 -num: 15 +num: 16 previous-page: tooling-syntax-rewriting next-page: incompat-syntactic --- diff --git a/_overviews/scala3-migration/options-intro.md b/_overviews/scala3-migration/options-intro.md index e5a831917a..9fc2d04d48 100644 --- a/_overviews/scala3-migration/options-intro.md +++ b/_overviews/scala3-migration/options-intro.md @@ -2,7 +2,7 @@ title: Compiler Options type: chapter description: This chapter shows the difference between Scala 2.13 and Scala 3 compiler options -num: 22 +num: 23 previous-page: incompat-type-inference next-page: options-lookup --- diff --git a/_overviews/scala3-migration/options-lookup.md b/_overviews/scala3-migration/options-lookup.md index a80f79c806..36db00ad8e 100644 --- a/_overviews/scala3-migration/options-lookup.md +++ b/_overviews/scala3-migration/options-lookup.md @@ -2,7 +2,7 @@ title: Compiler Options Lookup Table type: section description: This section contains the compiler options lookup tables -num: 23 +num: 24 previous-page: options-intro next-page: options-new --- diff --git a/_overviews/scala3-migration/options-new.md b/_overviews/scala3-migration/options-new.md index 61fd71c0e7..d101412f95 100644 --- a/_overviews/scala3-migration/options-new.md +++ b/_overviews/scala3-migration/options-new.md @@ -2,7 +2,7 @@ title: New Compiler Options type: section description: This chapter lists all the new compiler options in Scala 3 -num: 24 +num: 25 previous-page: options-lookup next-page: scaladoc-settings-compatibility --- diff --git a/_overviews/scala3-migration/plugin-intro.md b/_overviews/scala3-migration/plugin-intro.md index cd2155b626..96bfc18078 100644 --- a/_overviews/scala3-migration/plugin-intro.md +++ b/_overviews/scala3-migration/plugin-intro.md @@ -2,7 +2,7 @@ title: Compiler Plugins type: chapter description: This section shows how to migrate from using Scala 2 compiler plugins -num: 26 +num: 27 previous-page: options-new next-page: plugin-kind-projector --- diff --git a/_overviews/scala3-migration/plugin-kind-projector.md b/_overviews/scala3-migration/plugin-kind-projector.md index 471657b488..39639d1281 100644 --- a/_overviews/scala3-migration/plugin-kind-projector.md +++ b/_overviews/scala3-migration/plugin-kind-projector.md @@ -2,7 +2,7 @@ title: Kind Projector Migration type: section description: This section shows how to migrate from the kind-projector plugin to Scala 3 kind-projector syntax -num: 27 +num: 28 previous-page: plugin-intro next-page: external-resources --- diff --git a/_overviews/scala3-migration/scala3-migrate.md b/_overviews/scala3-migration/scala3-migrate.md index b21ad754a3..e4c66d9ac4 100644 --- a/_overviews/scala3-migration/scala3-migrate.md +++ b/_overviews/scala3-migration/scala3-migrate.md @@ -2,7 +2,7 @@ title: Porting an sbt Project (using sbt-scala3-migrate) type: section description: This section shows how to use scala3-migrate to migrate a project -num: 10 +num: 11 previous-page: tutorial-prerequisites next-page: tutorial-sbt --- @@ -17,12 +17,13 @@ It consists of four sbt commands: Each one of these commands is described in details below. > #### Requirements -> - Scala 2.13, preferred 2.13.11 +> - Scala 2.13, preferred 2.13.13 > - sbt 1.5 or higher > - **Disclaimer:** This tool cannot migrate libraries containing macros. > > #### Recommendation -> Before the migration, add `-Xsource:3` to your scalac options to enable some Scala 3 syntax and behavior. +> Before the migration, add `-Xsource:3` to your scalac options to enable Scala 3 migration warnings in the Scala 2 compiler. +> See the page [Scala 2 with -Xsource:3](tooling-scala2-xsource3.html) for more details. In this tutorial, we will migrate the project in [scalacenter/scala3-migration-example](https://github.com/scalacenter/scala3-migration-example). To learn about the migration, and train yourself, you can clone this repository and follow the tutorial steps. diff --git a/_overviews/scala3-migration/scaladoc-settings-compatibility.md b/_overviews/scala3-migration/scaladoc-settings-compatibility.md index 7bb96b90d8..8b1faf2102 100644 --- a/_overviews/scala3-migration/scaladoc-settings-compatibility.md +++ b/_overviews/scala3-migration/scaladoc-settings-compatibility.md @@ -2,7 +2,7 @@ title: Scaladoc settings compatibility between Scala2 and Scala3 type: section description: This chapter lists all the scaladoc options for Scala 2 and Scala 3, and explains the relations between them. -num: 25 +num: 26 previous-page: options-new next-page: plugin-intro --- diff --git a/_overviews/scala3-migration/tooling-migration-mode.md b/_overviews/scala3-migration/tooling-migration-mode.md index 183edeee7e..1bcc4d0b02 100644 --- a/_overviews/scala3-migration/tooling-migration-mode.md +++ b/_overviews/scala3-migration/tooling-migration-mode.md @@ -2,8 +2,8 @@ title: Scala 3 Migration Mode type: chapter description: This section describes the migration mode of the Scala 3 compiler -num: 7 -previous-page: tooling-tour +num: 8 +previous-page: tooling-scala2-xsource3 next-page: tutorial-intro --- diff --git a/_overviews/scala3-migration/tooling-scala2-xsource3.md b/_overviews/scala3-migration/tooling-scala2-xsource3.md new file mode 100644 index 0000000000..8ed543b497 --- /dev/null +++ b/_overviews/scala3-migration/tooling-scala2-xsource3.md @@ -0,0 +1,85 @@ +--- +title: Scala 2 with -Xsource:3 +type: chapter +description: This section describes the Scala 2 compiler's -Xsource:3 flag +num: 7 +previous-page: tooling-tour +next-page: tooling-migration-mode +--- + +The Scala 2.13 compiler issues helpful migration warnings with the `-Xsource:3` flag. +Before moving to the Scala 3 compiler, it's recommended to enable this flag in Scala 2 and address the new warnings. +In addition to new warnigns, the flag enables certain benign Scala 3 syntax such as `import p.*`. + +This page explains the details behind the flag, an overview is shown using `scalac -Xsource:help`. + +## Migration vs cross-building + +With Scala 2.13.13 and newer, the `-Xsource:3` flag comes in two variants: + + - `Xsource:3` enables warnings relevant for migrating a codebase to Scala 3. + - `Xsource:3-cross` is useful for projects that cross-build between Scala 2 and 3 for a longer period of time. + For certain language constructs that trigger a warning with `-Xsource:3`, the behavior changes to match Scala 3. + +Details about individual warnings are listed below on this page. + +## Fatal warnings and quick fixes + +By default, Scala 3 migration warnings emitted by Scala 2.13 are fatal, i.e., they are reported as errors. +This can be changed using `-Wconf`, for example `-Wconf:cat=scala3-migration:w` changes them to be reported as warnings. +Alternatively, `-Xmigration` has the same effect. + +The [`@nowarn` annotation](https://www.scala-lang.org/api/current/scala/annotation/nowarn.html) can be used to suppress individual warnings, which also works with fatal warnings enabled. + +The Scala 2.13 compiler implements quick fixes for many Scala 3 migration warnings. +Quick fixes are displayed in Metals-based IDEs (not yet in IntelliJ), and they can be applied directly to the source code using the `-quickfix` flag, for example `-quickfix:cat=scala3-migration`. +See also `scalac -quickfix:help`. + +## Enabled Scala 3 syntax + +The `-Xsource:3` flag enables the following Scala 3 syntax in Scala 2: + + - `import p.*` + - `import p.m as n` + - `import p.{given, *}` + - `case C(xs*)` as an alias for `case C(xs @ _*)` + - `A & B` type intersection as an alias for `A with B` + - Selecting a method `x.f` performs an eta-expansion (`x.f _`), even without an expected type + + +## Scala 3 migration warnings in detail + +Many Scala 3 migration warnings are easy to understand and identical under `-Xsource:3` and `-Xsource:3-cross`, e.g., for implicit definitions without an explicit type: + +{% highlight text %} +scala> object O { implicit val s = "" } + ^ + error: Implicit definition must have explicit type (inferred String) [quickfixable] +{% endhighlight %} + +The following table explains warnings where where the behavior changes between `-Xsource:3` and `-Xsource:3-cross`. + +| Feature | `-Xsource:3` | `-Xsource:3-cross` | +|--- |--- |--- | +| `(x: Any) + ""` is deprecated | deprecation warning | does not compile, implicit `any2stringadd` is not inferred | +| Unicode escapes in triple-quoted strings and raw interpolations (`"""\u0061"""`) | fatal warning, escape is processed | escape is not processed | +| Leading infix operators continue the previous line <sup>1</sup> | fatal warning, second line is a separate expression | operation continues the previous line | +| Desugaring of string interpolators using `StringContext` | fatal warning if the interpolation references a `StringContext` in scope different from `scala.StringContext` | desugaring always uses `scala.StringContext` | +| Modifiers of `apply` and `copy` methods of case classes with non-public constructors: `case class C private[p] (x: Int)` | fatal warning about the generated `apply` and `copy` being public | `apply` and `copy` inherit the access modifiers from the constructor | +| Inferred type of an overriding member <sup>2</sup> | fatal warning, the type of `B.f` is `String` | the type of `B.f` is `Object` | +| An implicit for type `p.A` is found in the package prefix `p` | fatal warning | the package prefix `p` is no longer part of the implicit search scope | + +Example 1: + +{% highlight text %} + def f = + 1 + + 2 +{% endhighlight %} + +Example 2: + +{% highlight text %} +trait A { def f: Object } +class B extends A { def f = "hi" } +{% endhighlight %} diff --git a/_overviews/scala3-migration/tooling-syntax-rewriting.md b/_overviews/scala3-migration/tooling-syntax-rewriting.md index e6cc2cba32..9ce122c1a0 100644 --- a/_overviews/scala3-migration/tooling-syntax-rewriting.md +++ b/_overviews/scala3-migration/tooling-syntax-rewriting.md @@ -2,7 +2,7 @@ title: Scala 3 Syntax Rewriting type: chapter description: This section describes the syntax rewriting capability of the Scala 3 compiler -num: 14 +num: 15 previous-page: tutorial-macro-mixing next-page: incompatibility-table --- diff --git a/_overviews/scala3-migration/tooling-tour.md b/_overviews/scala3-migration/tooling-tour.md index 0c15849a15..5a5f1fe686 100644 --- a/_overviews/scala3-migration/tooling-tour.md +++ b/_overviews/scala3-migration/tooling-tour.md @@ -4,7 +4,7 @@ type: chapter description: This chapter is a tour of the migration tooling ecosystem num: 6 previous-page: compatibility-metaprogramming -next-page: tooling-migration-mode +next-page: tooling-scala2-xsource3 --- ## The Scala Compilers @@ -13,12 +13,10 @@ The migration has been carefully prepared beforehand in each of the two compiler ### The Scala 2.13 Compiler -The Scala 2.13 compiler supports `-Xsource:3`, an option that enables some Scala 3 syntax and behavior: -- Most deprecated syntax generates an error. -- Infix operators can start a line in the middle of a multiline expression. -- Implicit search and overload resolution follow Scala 3 handling of contravariance when checking specificity. +The Scala 2.13 compiler supports `-Xsource:3`, an option that enables migration warnings and certain Scala 3 syntax and behavior. + +The [Scala 2 with -Xsource:3](tooling-scala2-xsource3.html) page explains the flag in detail. -The `-Xsource:3` option is intended to encourage early migration. ### The Scala 3 Compiler diff --git a/_overviews/scala3-migration/tutorial-intro.md b/_overviews/scala3-migration/tutorial-intro.md index 4f207f5b92..822bfa2319 100644 --- a/_overviews/scala3-migration/tutorial-intro.md +++ b/_overviews/scala3-migration/tutorial-intro.md @@ -2,7 +2,7 @@ title: Migration Tutorial type: chapter description: This chapter contains the tutorials for porting a Scala 2.13 project to Scala 3 -num: 8 +num: 9 previous-page: tooling-migration-mode next-page: tutorial-prerequisites --- diff --git a/_overviews/scala3-migration/tutorial-macro-cross-building.md b/_overviews/scala3-migration/tutorial-macro-cross-building.md index f9eec72757..b456b521aa 100644 --- a/_overviews/scala3-migration/tutorial-macro-cross-building.md +++ b/_overviews/scala3-migration/tutorial-macro-cross-building.md @@ -2,7 +2,7 @@ title: Cross-Building a Macro Library type: section description: This section shows how to cross-build a macro library -num: 12 +num: 13 previous-page: tutorial-sbt next-page: tutorial-macro-mixing --- diff --git a/_overviews/scala3-migration/tutorial-macro-mixing.md b/_overviews/scala3-migration/tutorial-macro-mixing.md index a0a88b17ce..12aa203ad1 100644 --- a/_overviews/scala3-migration/tutorial-macro-mixing.md +++ b/_overviews/scala3-migration/tutorial-macro-mixing.md @@ -2,7 +2,7 @@ title: Mixing Scala 2.13 and Scala 3 Macros type: section description: This section shows how to mix Scala 2.13 and Scala 3 macros in a single artifact -num: 13 +num: 14 previous-page: tutorial-macro-mixing next-page: tooling-syntax-rewriting --- diff --git a/_overviews/scala3-migration/tutorial-prerequisites.md b/_overviews/scala3-migration/tutorial-prerequisites.md index dabb242834..426377f669 100644 --- a/_overviews/scala3-migration/tutorial-prerequisites.md +++ b/_overviews/scala3-migration/tutorial-prerequisites.md @@ -2,7 +2,7 @@ title: Prerequisites type: section description: This section details the prerequisites of migration to Scala 3 -num: 9 +num: 10 previous-page: tutorial-intro next-page: scala3-migrate --- diff --git a/_overviews/scala3-migration/tutorial-sbt.md b/_overviews/scala3-migration/tutorial-sbt.md index 78cd056d06..67d1ffed36 100644 --- a/_overviews/scala3-migration/tutorial-sbt.md +++ b/_overviews/scala3-migration/tutorial-sbt.md @@ -2,7 +2,7 @@ title: Porting an sbt Project (by hand) type: section description: This section shows how to port an sbt project -num: 11 +num: 12 previous-page: scala3-migrate next-page: tutorial-macro-cross-building --- From 1df9d4bb0ae306d11f86bb5ce08c2d2a9093385b Mon Sep 17 00:00:00 2001 From: nicolasalberti00 <75423237+nicolasalberti00@users.noreply.github.com> Date: Mon, 12 Feb 2024 17:20:37 +0100 Subject: [PATCH 2788/3075] Fixed typos in Italian translation --- _it/tutorials/scala-for-java-programmers.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_it/tutorials/scala-for-java-programmers.md b/_it/tutorials/scala-for-java-programmers.md index 5e5e7d9209..180e5795bb 100644 --- a/_it/tutorials/scala-for-java-programmers.md +++ b/_it/tutorials/scala-for-java-programmers.md @@ -262,7 +262,7 @@ modo: `new Complex(1.5, 2.3)`. La classe ha due metodi, `re` e `im` che danno l’accesso rispettivamente alla parte reale e a quella immaginaria del numero complesso. -Da notare che il tipo di ritorno dei due metodi non è specificato esplicitamante. +Da notare che il tipo di ritorno dei due metodi non è specificato esplicitamente. Sarà il compilatore che lo dedurrà automaticamente osservando la parte a destra del segno uguale dei metodi e deducendo che per entrambi si tratta di valori di tipo `Double`. @@ -419,7 +419,7 @@ detto in Scala non è difficile: } Questa funzione di valutazione lavora effettuando un *pattern matching* -sull’albero `t`. Intuitivamente il significato della definizione precendente +sull’albero `t`. Intuitivamente il significato della definizione precedente dovrebbe esser chiaro: 1. prima controlla se l’albero `t` è un `Sum`; se lo è, esegue il bind del @@ -557,7 +557,7 @@ dichiarazione di un trait: } Questa definizione crea un nuovo tipo chiamato `Ord` che ha lo stesso -ruolo dell’interfaccia `Comparable` in Java e, fornisce l’implementazione +ruolo dell’interfaccia `Comparable` in Java e fornisce l’implementazione di default di tre predicati in termini del quarto astraendone uno. I predicati di uguaglianza e disuguaglianza non sono presenti in questa dichiarazione poichè sono presenti di default in tutti gli oggetti. @@ -646,7 +646,7 @@ restrittivo. I programmatori Java hanno fatto ricorso all’uso di `Object`, che è il super-tipo di tutti gli oggetti. Questa soluzione è in ogni caso ben lontana dall’esser ideale perché non funziona per i tipi base (`int`, `long`, `float`, -ecc.) ed implica che molto type casts dinamico deve esser fatto dal +ecc.) ed implica che molto type cast dinamico deve esser fatto dal programmatore. Scala rende possibile la definizione delle classi generiche (e metodi) per From fbdb689851e795ccd387d550ff078e4317cc9c4e Mon Sep 17 00:00:00 2001 From: Chris Kipp <ckipp@pm.me> Date: Wed, 24 Jan 2024 15:22:16 +0100 Subject: [PATCH 2789/3075] docs: show example usage of `CommandLineParser.FromString` This is covered in the video and briefly mentioned in the text above, but no example is given. This just provides a small example in written format to match what is covered in the video. --- .../scala3-book/methods-main-methods.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index cc26716f16..02d40cc225 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -86,6 +86,33 @@ $ scala happyBirthday sixty Fred Illegal command line: java.lang.NumberFormatException: For input string: "sixty" ``` +## User-defined types as parameters + +As mentioned up above, the compiler looks for a given instance of the +`scala.util.CommandLineParser.FromString` typeclass for the type of the +argument. For example, let's say you have a custom `Color` type that you want to +use as a parameter. You would do this like you see below: + +{% tabs method_3 %} +{% tab 'Scala 3 Only' for=method_3 %} + +```scala +enum Color: + case Red, Green, Blue + +given ComamndLineParser.FromString[Color] with + def fromString(value: String): Color = Color.valueOf(value) + +@main def run(color: Color): Unit = + println(s"The color is ${color.toString}") +``` + +{% endtab %} +{% endtabs %} + +This works the same for your own user types in your program as well as types you +might be using from another library. + ## The details The Scala compiler generates a program from an `@main` method `f` as follows: From 72ba4c1df8f7b6e7033463d5c37e9786d515bd38 Mon Sep 17 00:00:00 2001 From: John Duffell <john.duffell@guardian.co.uk> Date: Wed, 14 Feb 2024 10:50:20 +0000 Subject: [PATCH 2790/3075] document multi project build macro mixing benefits --- _overviews/scala3-migration/tutorial-macro-mixing.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-migration/tutorial-macro-mixing.md b/_overviews/scala3-migration/tutorial-macro-mixing.md index a0a88b17ce..bd5b2956b8 100644 --- a/_overviews/scala3-migration/tutorial-macro-mixing.md +++ b/_overviews/scala3-migration/tutorial-macro-mixing.md @@ -7,10 +7,10 @@ previous-page: tutorial-macro-mixing next-page: tooling-syntax-rewriting --- -This tutorial shows how to mix Scala 2.13 and Scala 3 macros in a single artifact. +This tutorial shows how to mix Scala 2.13 and Scala 3 macros in a single artifact. There are two main benefits of this: -It can be used to create a new Scala 3 macro library and make it available for Scala 2.13 users. -It can also be used to port an existing Scala 2.13 macro library to Scala 3, although it is probably easier to cross-build. +1. Making a new or existing scala 3 macro library available for Scala 2.13 users without having to provide a separate 2.13 version +2. Allowing multi-project builds to be upgraded module by module, even where macro libraries are used. ## Introduction From a2934a5e00c67ad005de4f969511719062747a05 Mon Sep 17 00:00:00 2001 From: John Duffell <john.duffell@guardian.co.uk> Date: Wed, 14 Feb 2024 11:04:52 +0000 Subject: [PATCH 2791/3075] make it clearer the benefits of macro mixing --- _overviews/scala3-migration/compatibility-metaprogramming.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/compatibility-metaprogramming.md b/_overviews/scala3-migration/compatibility-metaprogramming.md index aae66f0532..675f5fc4a3 100644 --- a/_overviews/scala3-migration/compatibility-metaprogramming.md +++ b/_overviews/scala3-migration/compatibility-metaprogramming.md @@ -63,7 +63,10 @@ You can learn all the new metaprogramming concepts by reading the [Macros in Sca ## Cross-building a Macro Library You have written a wonderful macro library and you would like it to be available in Scala 2.13 and Scala 3. -There are two different approaches, the traditional cross-building technique and the more experimental mixing macro technique. +There are two different approaches, the traditional cross-building technique and the more flexible macro mixing technique. + +The benefit of macro mixing is that consumers who take advantage of the `-Ytasty-reader` option can still use your macros. + You can learn about them by reading these tutorials: - [Cross-Building a Macro Library](tutorial-macro-cross-building.html) - [Mixing Scala 2.13 and Scala 3 Macros](tutorial-macro-mixing.html) From a59ef922f4ef733444630c6d36f163aa7ceeeacf Mon Sep 17 00:00:00 2001 From: John Duffell <john.duffell@guardian.co.uk> Date: Wed, 14 Feb 2024 11:10:04 +0000 Subject: [PATCH 2792/3075] mention -Ytasty-reader in connection with macro mixing --- _overviews/scala3-migration/tutorial-macro-mixing.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-migration/tutorial-macro-mixing.md b/_overviews/scala3-migration/tutorial-macro-mixing.md index bd5b2956b8..99514f6370 100644 --- a/_overviews/scala3-migration/tutorial-macro-mixing.md +++ b/_overviews/scala3-migration/tutorial-macro-mixing.md @@ -7,10 +7,12 @@ previous-page: tutorial-macro-mixing next-page: tooling-syntax-rewriting --- -This tutorial shows how to mix Scala 2.13 and Scala 3 macros in a single artifact. There are two main benefits of this: +This tutorial shows how to mix Scala 2.13 and Scala 3 macros in a single artifact. This means that consumers can use '-Ytasty-reader' from Scala 2.13 code that uses your macros. + +There are two main benefits of this: 1. Making a new or existing scala 3 macro library available for Scala 2.13 users without having to provide a separate 2.13 version -2. Allowing multi-project builds to be upgraded module by module, even where macro libraries are used. +2. Allowing your macros to be usable in multi-project builds that are being upgraded module by module. ## Introduction From e3729741237f1e5e6ee4be2e347db9975c3fe592 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 14 Feb 2024 07:10:28 -0800 Subject: [PATCH 2793/3075] Bump github-pages from 228 to 230 (#2968) Bumps [github-pages](https://github.com/github/pages-gem) from 228 to 230. - [Release notes](https://github.com/github/pages-gem/releases) - [Commits](https://github.com/github/pages-gem/compare/v228...v230) --- updated-dependencies: - dependency-name: github-pages dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- Gemfile.lock | 118 +++++++++++++++++++++++++++++---------------------- 1 file changed, 67 insertions(+), 51 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 75c5117a34..99a0baadc7 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,53 +1,64 @@ GEM remote: https://rubygems.org/ specs: - activesupport (7.0.7.2) + activesupport (7.1.3) + base64 + bigdecimal concurrent-ruby (~> 1.0, >= 1.0.2) + connection_pool (>= 2.2.5) + drb i18n (>= 1.6, < 2) minitest (>= 5.1) + mutex_m tzinfo (~> 2.0) - addressable (2.8.1) + addressable (2.8.6) public_suffix (>= 2.0.2, < 6.0) + base64 (0.2.0) + bigdecimal (3.1.6) coffee-script (2.4.1) coffee-script-source execjs - coffee-script-source (1.11.1) + coffee-script-source (1.12.2) colorator (1.1.0) commonmarker (0.23.10) - concurrent-ruby (1.2.2) - dnsruby (1.61.9) - simpleidn (~> 0.1) + concurrent-ruby (1.2.3) + connection_pool (2.4.1) + dnsruby (1.70.0) + simpleidn (~> 0.2.1) + drb (2.2.0) + ruby2_keywords em-websocket (0.5.3) eventmachine (>= 0.12.9) http_parser.rb (~> 0) ethon (0.16.0) ffi (>= 1.15.0) eventmachine (1.2.7) - execjs (2.8.1) - faraday (2.7.4) - faraday-net_http (>= 2.0, < 3.1) - ruby2_keywords (>= 0.0.4) - faraday-net_http (3.0.2) - ffi (1.15.5) + execjs (2.9.1) + faraday (2.9.0) + faraday-net_http (>= 2.0, < 3.2) + faraday-net_http (3.1.0) + net-http + ffi (1.16.3) + ffi (1.16.3-x64-mingw-ucrt) forwardable-extended (2.6.0) - gemoji (3.0.1) - github-pages (228) - github-pages-health-check (= 1.17.9) - jekyll (= 3.9.3) - jekyll-avatar (= 0.7.0) - jekyll-coffeescript (= 1.1.1) + gemoji (4.1.0) + github-pages (230) + github-pages-health-check (= 1.18.2) + jekyll (= 3.9.5) + jekyll-avatar (= 0.8.0) + jekyll-coffeescript (= 1.2.2) jekyll-commonmark-ghpages (= 0.4.0) - jekyll-default-layout (= 0.1.4) - jekyll-feed (= 0.15.1) + jekyll-default-layout (= 0.1.5) + jekyll-feed (= 0.17.0) jekyll-gist (= 1.5.0) - jekyll-github-metadata (= 2.13.0) + jekyll-github-metadata (= 2.16.1) jekyll-include-cache (= 0.2.1) jekyll-mentions (= 1.6.0) jekyll-optional-front-matter (= 0.3.2) jekyll-paginate (= 1.1.0) jekyll-readme-index (= 0.3.0) jekyll-redirect-from (= 0.16.0) - jekyll-relative-links (= 0.6.1) + jekyll-relative-links (= 0.7.0) jekyll-remote-theme (= 0.4.3) jekyll-sass-converter (= 1.5.2) jekyll-seo-tag (= 2.8.0) @@ -67,20 +78,20 @@ GEM jekyll-theme-tactile (= 0.2.0) jekyll-theme-time-machine (= 0.2.0) jekyll-titles-from-headings (= 0.5.3) - jemoji (= 0.12.0) - kramdown (= 2.3.2) + jemoji (= 0.13.0) + kramdown (= 2.4.0) kramdown-parser-gfm (= 1.1.0) liquid (= 4.0.4) mercenary (~> 0.3) minima (= 2.5.1) nokogiri (>= 1.13.6, < 2.0) - rouge (= 3.26.0) + rouge (= 3.30.0) terminal-table (~> 1.4) - github-pages-health-check (1.17.9) + github-pages-health-check (1.18.2) addressable (~> 2.3) dnsruby (~> 1.60) - octokit (~> 4.0) - public_suffix (>= 3.0, < 5.0) + octokit (>= 4, < 8) + public_suffix (>= 3.0, < 6.0) typhoeus (~> 1.3) html-pipeline (2.14.3) activesupport (>= 2) @@ -97,7 +108,7 @@ GEM http_parser.rb (0.8.0) i18n (1.14.1) concurrent-ruby (~> 1.0) - jekyll (3.9.3) + jekyll (3.9.5) addressable (~> 2.4) colorator (~> 1.0) em-websocket (~> 0.5) @@ -110,11 +121,11 @@ GEM pathutil (~> 0.9) rouge (>= 1.7, < 4) safe_yaml (~> 1.0) - jekyll-avatar (0.7.0) + jekyll-avatar (0.8.0) jekyll (>= 3.0, < 5.0) - jekyll-coffeescript (1.1.1) + jekyll-coffeescript (1.2.2) coffee-script (~> 2.2) - coffee-script-source (~> 1.11.1) + coffee-script-source (~> 1.12) jekyll-commonmark (1.4.0) commonmarker (~> 0.22) jekyll-commonmark-ghpages (0.4.0) @@ -122,15 +133,15 @@ GEM jekyll (~> 3.9.0) jekyll-commonmark (~> 1.4.0) rouge (>= 2.0, < 5.0) - jekyll-default-layout (0.1.4) - jekyll (~> 3.0) - jekyll-feed (0.15.1) + jekyll-default-layout (0.1.5) + jekyll (>= 3.0, < 5.0) + jekyll-feed (0.17.0) jekyll (>= 3.7, < 5.0) jekyll-gist (1.5.0) octokit (~> 4.2) - jekyll-github-metadata (2.13.0) + jekyll-github-metadata (2.16.1) jekyll (>= 3.4, < 5.0) - octokit (~> 4.0, != 4.4.0) + octokit (>= 4, < 7, != 4.4.0) jekyll-include-cache (0.2.1) jekyll (>= 3.7, < 5.0) jekyll-mentions (1.6.0) @@ -143,7 +154,7 @@ GEM jekyll (>= 3.0, < 5.0) jekyll-redirect-from (0.16.0) jekyll (>= 3.3, < 5.0) - jekyll-relative-links (0.6.1) + jekyll-relative-links (0.7.0) jekyll (>= 3.3, < 5.0) jekyll-remote-theme (0.4.3) addressable (~> 2.0) @@ -201,11 +212,11 @@ GEM jekyll (>= 3.3, < 5.0) jekyll-watch (2.2.1) listen (~> 3.0) - jemoji (0.12.0) - gemoji (~> 3.0) + jemoji (0.13.0) + gemoji (>= 3, < 5) html-pipeline (~> 2.2) jekyll (>= 3.0, < 5.0) - kramdown (2.3.2) + kramdown (2.4.0) rexml kramdown-parser-gfm (1.1.0) kramdown (~> 2.0) @@ -218,12 +229,15 @@ GEM jekyll (>= 3.5, < 5.0) jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) - minitest (5.19.0) - nokogiri (1.14.3-arm64-darwin) + minitest (5.22.2) + mutex_m (0.2.0) + net-http (0.4.1) + uri + nokogiri (1.16.2-arm64-darwin) racc (~> 1.4) - nokogiri (1.14.3-x64-mingw-ucrt) + nokogiri (1.16.2-x64-mingw-ucrt) racc (~> 1.4) - nokogiri (1.14.3-x86_64-linux) + nokogiri (1.16.2-x86_64-linux) racc (~> 1.4) octokit (4.25.1) faraday (>= 1, < 3) @@ -231,14 +245,14 @@ GEM parallel (1.22.1) pathutil (0.16.2) forwardable-extended (~> 2.6) - public_suffix (4.0.7) - racc (1.6.2) + public_suffix (5.0.4) + racc (1.7.3) rainbow (3.1.1) rb-fsevent (0.11.2) rb-inotify (0.10.1) ffi (~> 1.0) - rexml (3.2.5) - rouge (3.26.0) + rexml (3.2.6) + rouge (3.30.0) ruby2_keywords (0.0.5) rubyzip (2.3.2) safe_yaml (1.0.5) @@ -254,14 +268,16 @@ GEM unf (~> 0.1.4) terminal-table (1.8.0) unicode-display_width (~> 1.1, >= 1.1.1) - typhoeus (1.4.0) + typhoeus (1.4.1) ethon (>= 0.9.0) tzinfo (2.0.6) concurrent-ruby (~> 1.0) unf (0.1.4) unf_ext - unf_ext (0.0.8.2) + unf_ext (0.0.9.1) + unf_ext (0.0.9.1-x64-mingw-ucrt) unicode-display_width (1.8.0) + uri (0.13.0) webrick (1.8.1) yell (2.2.2) zeitwerk (2.6.7) From 0d8a969741a730180f32453c4201a60a487b0763 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Tue, 20 Feb 2024 22:41:51 +0800 Subject: [PATCH 2794/3075] correct some minor bugs. (#2953) --- _zh-cn/overviews/scala3-book/tools-sbt.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/tools-sbt.md b/_zh-cn/overviews/scala3-book/tools-sbt.md index 3d4e78f4a1..d77b8d6286 100644 --- a/_zh-cn/overviews/scala3-book/tools-sbt.md +++ b/_zh-cn/overviews/scala3-book/tools-sbt.md @@ -84,7 +84,7 @@ $ tree $ sbt run ``` -您应该会看到如下所示的输出，包括程序中的 “Hello, world”： +您应该会看到如下所示的输出，包括程序中的 `"Hello, world"`： ```bash $ sbt run @@ -215,7 +215,7 @@ scalaVersion := "{{ site.scala-3-version }}" @main def helloWorld = println("Hello, world") ``` -该代码定义了一个 Scala 3 “main” 方法，该方法在运行时打印 “Hello, world”。 +该代码定义了一个 Scala 3 “main” 方法，该方法在运行时打印 `"Hello, world"`。 现在，使用 `sbt run` 命令编译并运行您的项目： @@ -298,7 +298,7 @@ scala-3-project-template > $ sbt new scala/scala3-cross.g8 > ~~~ -在 [sbt 文档](https://www.scala-sbt.org/1.x/docs/sbt-new-and-Templates.html#sbt+new+) 中了解有关 `sbt new` 和项目模板的更多信息和+模板。 +在 [sbt 文档](https://www.scala-sbt.org/1.x/docs/sbt-new-and-Templates.html#sbt+new+) 中了解有关 `sbt new` 和项目模板的更多信息。 ### Scala 的其他构建工具 @@ -312,7 +312,7 @@ scala-3-project-template #### Coursier 在相关说明中，[Coursier](https://get-coursier.io/docs/overview) 是一个“依赖解析器”，在功能上类似于 Maven 和 Ivy。 -它是用 Scala 从头开始​​编写的，“包含函数式编程原则”，并且可以并行下载工件以实现快速下载。 +它是用 Scala 从头开始编写的，“包含函数式编程原则”，并且可以并行下载工件以实现快速下载。 sbt 使用它来处理大多数依赖关系解析，并且作为一个命令行工具，它可以用于在您的系统上轻松安装 sbt、Java 和 Scala 等工具，如我们的 [Getting Started][getting_started] 页面所示。 来自 `launch` 网页的这个示例显示了 `cs launch` 命令可用于从依赖项启动应用程序： @@ -347,8 +347,7 @@ $ mkdir project ### 2) 创建 build.properties 和 build.sbt 文件 -接下来，在项目的 _project/_ 子目录中创建一个 _build.properties_ 文件 -用这条线： +接下来，把下面这行代码用于在项目的 _project/_ 子目录中创建一个 _build.properties_ 文件： ```text sbt.version=1.5.4 @@ -449,7 +448,7 @@ end MathUtilsTests 此代码演示了 ScalaTest `AnyFunSuite` 方法。 几个重要的点： -- 你的测试类应该扩展 `AnyFunSuite` +- 你的测试类应该继承 `AnyFunSuite` - 如图所示，您可以通过为每个 `test` 指定一个唯一的名称来创建测试 - 在每个测试结束时，您应该调用 `assert` 来测试条件是否已满足 - 当你知道你想写一个测试，但你现在不想写它时，将测试创建为“待定”，语法如上例所示 From 38af45a4e1cdaaf7918687916c11b41d216ee026 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Wed, 21 Feb 2024 00:21:01 +0000 Subject: [PATCH 2795/3075] Update SIPs state --- _sips/sips/alternative-bind-patterns.md | 7 - _sips/sips/for-comprehension-improvements.md | 7 + _sips/sips/match-types-spec.md | 5 +- _sips/sips/multiple-assignments.md | 7 - ...lace-non-sensical-unchecked-annotations.md | 7 - ...eplace-nonsensical-unchecked-annotation.md | 260 ++++++++++++++++++ ...ault-arguments-for-binary-compatibility.md | 7 + 7 files changed, 277 insertions(+), 23 deletions(-) delete mode 100644 _sips/sips/alternative-bind-patterns.md create mode 100644 _sips/sips/for-comprehension-improvements.md delete mode 100644 _sips/sips/multiple-assignments.md delete mode 100644 _sips/sips/replace-non-sensical-unchecked-annotations.md create mode 100644 _sips/sips/replace-nonsensical-unchecked-annotation.md create mode 100644 _sips/sips/unroll-default-arguments-for-binary-compatibility.md diff --git a/_sips/sips/alternative-bind-patterns.md b/_sips/sips/alternative-bind-patterns.md deleted file mode 100644 index 871508d44f..0000000000 --- a/_sips/sips/alternative-bind-patterns.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-60 - Alternative bind patterns -status: under-review -pull-request-number: 74 -stage: design - ---- diff --git a/_sips/sips/for-comprehension-improvements.md b/_sips/sips/for-comprehension-improvements.md new file mode 100644 index 0000000000..e474776928 --- /dev/null +++ b/_sips/sips/for-comprehension-improvements.md @@ -0,0 +1,7 @@ +--- +title: SIP-62 - For comprehension improvements +status: submitted +pull-request-number: 79 +stage: pre-sip + +--- diff --git a/_sips/sips/match-types-spec.md b/_sips/sips/match-types-spec.md index 6609d9312c..1624e64cc5 100644 --- a/_sips/sips/match-types-spec.md +++ b/_sips/sips/match-types-spec.md @@ -253,8 +253,9 @@ At the top level, `variance = 1` and `scrutIsWidenedAbstract = false`. * If `P` is a `TypeWithoutCapture`: * Do nothing (always succeed). * If `P` is a `WildcardCapture` `ti = _`: - * If `X` is of the form `_ >: L <: H`, instantiate `ti := H` (anything between `L` and `H` would work here), - * Otherwise, instantiate `ti := X`. + * Instantiate `ti` so that the subtype test in Step (2) above always succeeds: + * If `X` is of the form `_ >: L <: H`, instantiate `ti := H` (resp. `L`, `X`) if `variance = 1` (resp. `-1`, `0`). + * Otherwise, instantiate `ti := X`. * If `P` is a `TypeCapture` `ti`: * If `X` is of the form `_ >: L <: H`, * If `scrutIsWidenedAbstract` is `true`, fail as not specific. diff --git a/_sips/sips/multiple-assignments.md b/_sips/sips/multiple-assignments.md deleted file mode 100644 index 19335b3fe7..0000000000 --- a/_sips/sips/multiple-assignments.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-59 - Multiple assignments -status: under-review -pull-request-number: 73 -stage: design - ---- diff --git a/_sips/sips/replace-non-sensical-unchecked-annotations.md b/_sips/sips/replace-non-sensical-unchecked-annotations.md deleted file mode 100644 index e261b18e63..0000000000 --- a/_sips/sips/replace-non-sensical-unchecked-annotations.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-57 - Replace non-sensical @unchecked annotations -status: under-review -pull-request-number: 67 -stage: design - ---- diff --git a/_sips/sips/replace-nonsensical-unchecked-annotation.md b/_sips/sips/replace-nonsensical-unchecked-annotation.md new file mode 100644 index 0000000000..def0ff658d --- /dev/null +++ b/_sips/sips/replace-nonsensical-unchecked-annotation.md @@ -0,0 +1,260 @@ +--- +layout: sip +permalink: /sips/:title.html +stage: implementation +status: waiting-for-implementation +presip-thread: https://contributors.scala-lang.org/t/pre-sip-replace-non-sensical-unchecked-annotations/6342 +title: SIP-57 - Replace non-sensical @unchecked annotations +--- + +**By: Martin Odersky and Jamie Thompson** + +## History + +| Date | Version | +|---------------|--------------------| +| Dec 8th 2023 | Initial Draft | +| Jan 19th 2024 | Clarification about current @unchecked behavior | + +## Summary + +We propose to replace the mechanism to silence warnings for "unchecked" patterns, in the cases where silencing the warning will still result in the pattern being checked at runtime. + +Currently, a user can silence warnings that a scrutinee may not be matched by a pattern, by annotating the scrutinee with the `@unchecked` annotation. This SIP proposes to use a new annotation `@RuntimeCheck` to replace `@unchecked` for this purpose. For convenience, an extension method will be added to `Predef` that marks the receiver with the annotation (used as follows: `foo.runtimeCheck`). Functionally it behaves the same as the old annotation, but improves readability at the callsite. + +## Motivation + +As described in [Scala 3 Reference: Pattern Bindings](https://docs.scala-lang.org/scala3/reference/changed-features/pattern-bindings.html), under `-source:future` it is an error for a pattern definition to be refutable. For instance, consider: +```scala +def xs: List[Any] = ??? +val y :: ys = xs +``` + +This compiled without warning in 3.0, became a warning in 3.2, and we would like to make it an error by default in a future 3.x version. +As an escape hatch we recommend to use `@unchecked`: +``` +-- Warning: ../../new/test.scala:6:16 ------------------------------------------ +6 | val y :: ys = xs + | ^^ + |pattern's type ::[Any] is more specialized than the right hand side expression's type List[Any] + | + |If the narrowing is intentional, this can be communicated by adding `: @unchecked` after the expression, + |which may result in a MatchError at runtime. +``` +Similarly for non-exhaustive `match` expressions, where we also recommend to put `@unchecked` on the scrutinee. + +But `@unchecked` has several problems. First, it is ergonomically bad. For instance to fix the exhaustivity warning in +```scala +xs match + case y :: ys => ... +``` +we'd have to write +``` +(xs: @unchecked) match + case y :: ys => ... +``` +Having to wrap the `@unchecked` in parentheses requires editing in two places, and arguably harms readability: both due to the churn in extra symbols, and because in this use case the `@unchecked` annotation poorly communicates intent. + +Nominally, the purpose of the annotation is to silence warnings (_from the [API docs](https://www.scala-lang.org/api/3.3.1/scala/unchecked.html#)_): +> An annotation to designate that the annotated entity should not be considered for additional compiler checks. + +_The exact meaning of this description is open to interpretation, leading to differences between Scala 2.13 and Scala 3.x. See the [misinterpretation](#misinterpretation-of-unchecked) annex for more._ + + +In the following code however, the word `unchecked` is a misnomer, so could be confused for another meaning by an inexperienced user: + +```scala +def xs: List[Any] = ??? +val y :: ys = xs: @unchecked +``` + After all, the pattern `y :: ys` _is_ checked, but it is done at runtime (by looking at the runtime class), rather than statically. + +As a direct contradiction, in the following usage of `unchecked`, the meaning is the opposite: +```scala +xs match + case ints: List[Int @unchecked] => +``` +Here, `@unchecked` means that the `Int` parameter will _not_ be checked at runtime: The compiler instead trusts the user that `ints` is a `List[Int]`. This could lead to a `ClassCastException` in an unrelated piece of code that uses `ints`, possibly without leaving a clear breadcrumb trail of where the faulty cast originally occurred. + +## Proposed solution + +### High-level overview + +This SIP proposes to fix the ergnomics and readability of `@unchecked` in the usage where it means "checked at runtime", by instead adding a new annotation `scala.internal.RuntimeCheck`. + +```scala +package scala.annotation.internal + +final class RuntimeCheck extends Annotation +``` + +In all usages where the compiler looks for `@unchecked` for this purpose, we instead change to look for `@RuntimeCheck`. + +By placing the annotation in the `internal` package, we communicate that the user is not meant to directly use the annotation. + +Instead, for convenience, we provide an extension method `Predef.runtimeCheck`, which can be applied to any expression. + +The new usage to assert that a pattern is checked at runtime then becomes as follows: +```scala +def xs: List[Any] = ??? +val y :: ys = xs.runtimeCheck +``` + +We also make `runtimeCheck` a transparent inline method. This ensures that the elaboration of the method defines its semantics. (i.e. `runtimeCheck` is not meaningful because it is immediately inlined at type-checking). + +### Specification + +The addition of a new `scala.Predef` method: + +```scala +package scala + +import scala.annotation.internal.RuntimeCheck + +object Predef: + extension [T](x: T) + transparent inline def runtimeCheck: x.type = + x: @RuntimeCheck +``` + +### Compatibility + +This change carries the usual backward binary and TASTy compatibility concerns as any other standard library addition to the Scala 3 only library. + +Considering backwards source compatibility, the following situation will change: + +```scala +// source A.scala +package example + +extension (predef: scala.Predef.type) + transparent inline def runtimeCheck[T](x: T): x.type = + println("fake runtimeCheck") + x +``` +```scala +// source B.scala +package example + +@main def Test = + val xs = List[Any](1,2,3) + val y :: ys = Predef.runtimeCheck(xs) + assert(ys == List(2, 3)) +``` + +Previously this code would print `fake runtimeCheck`, however with the proposed change then recompiling this code will _succeed_ and no longer will print. + +Potentially we could mitigate this if necessary with a migration warning when the new method is resolved (`@experimental` annotation would be a start) + + +In general however, the new `runtimeCheck` method will not change any previously linking method without causing an ambiguity compilation error. + +### Other concerns + +In 3.3 we already require the user to put `@unchecked` to avoid warnings, there is likely a significant amount of existing code that will need to migrate to the new mechanism. (We can leverage already exisiting mechanisms help migrate code automatically). + +### Open questions + +1) A large question was should the method or annotation carry semantic weight in the language. In this proposal we weigh towards the annotation being the significant element. +The new method elaborates to an annotated expression before the associated pattern exhaustivity checks occur. +2) Another point, where should the helper method go? In Predef it requires no import, but another possible location was the `compiletime` package. Requiring the extra import could discourage usage without consideration - however if the method remains in `Predef` the name itself (and documentation) should signal danger, like with `asInstanceOf`. + +3) Should the `RuntimeCheck` annotation be in the `scala.annotation.internal` package? + +### Misinterpretation of unchecked + +We would further like to highlight that the `unchecked` annotation is unspecified except for its imprecise API documentation. This leads to a crucial difference in its behavior between Scala 2.13 and the latest Scala 3.3.1 release. + +#### Scala 3 semantics + +Say you have the following: +```scala +val xs = List(1: Any) +``` + +The following expression in Scala 3.3.1 yields two warnings: +```scala +xs match { + case is: ::[Int] => is.head +} +``` + +```scala +2 warnings found +-- [E029] Pattern Match Exhaustivity Warning: ---------------------------------- +1 |xs match { + |^^ + |match may not be exhaustive. + | + |It would fail on pattern case: List(_, _*), Nil + | + | longer explanation available when compiling with `-explain` +val res0: Int = 1 +-- Unchecked Warning: ---------------------------------------------------------- +2 | case is: ::[Int] => is.head + | ^ + |the type test for ::[Int] cannot be checked at runtime because its type arguments can't be determined from List[Any] +``` + +using `@unchecked` on `xs` has the effect of silencing any warnings that depend on checking `xs`, so no warnings will be emitted for the following change: + +```scala +(xs: @unchecked) match { + case is: ::[Int] => is.head +} +``` + +#### Scala 2.13 semantics + +However, in Scala 2.13, this will only silence the `match may not be exhaustive` warning, and the user will still see the `type test for ::[Int] cannot be checked at runtime` warning: + +```scala +scala> (xs: @unchecked) match { + | case is: ::[Int] => is.head + | } ^ +On line 2: warning: non-variable type argument Int in type pattern scala.collection.immutable.::[Int] (the underlying of ::[Int]) is unchecked since it is eliminated by erasure +val res2: Int = 1 +``` + +#### Aligning to Scala 2.13 semantics with runtimeCheck + +with `xs.runtimeCheck` we should still produce an unchecked warning for `case is: ::[Int] =>` +```scala +scala> xs.runtimeChecked match { + | case is: ::[Int] => is.head + | } +1 warning found +-- Unchecked Warning: ---------------------------------------------------------- +2 | case is: ::[Int] => is.head + | ^ + |the type test for ::[Int] cannot be checked at runtime because its type arguments can't be determined from List[Any] +val res13: Int = 1 +``` +This is because `xs.runtimeChecked` means trust the user as long as the pattern can be checked at runtime. + +To fully avoid warnings, the `@unchecked` will be put on the type argument: +```scala +scala> xs.runtimeChecked match { + | case is: ::[Int @unchecked] => is.head + | } +val res14: Int = 1 +``` +This has a small extra migration cost because if the scrutinee changes from `(xs: @unchecked)` to `xs.runtimeCheck` now some individual cases might need to add `@unchecked` on type arguments to avoid creating new warnings - however this cost is offset by perhaps revealing unsafe patterns previously unaccounted for. + +Once again `@nowarn` can be used to fully restore any old behavior + +## Alternatives + +1) make `runtimeCheck` a method on `Any` that returns the receiver (not inline). The compiler would check for presence of a call to this method when deciding to perform static checking of pattern exhaustivity. This idea was criticised for being brittle with respect to refactoring, or automatic code transformations via macro. + +2) `runtimeCheck` should elaborate to code that matches the expected type, e.g. to heal `t: Any` to `Int` when the expected type is `Int`. The problem is that this is not useful for patterns that can not be runtime checked by type alone. Also, it implies a greater change to the spec, because now `runtimeCheck` would have to be specially treated. + +## Related work + +- [Pre SIP thread](https://contributors.scala-lang.org/t/pre-sip-replace-non-sensical-unchecked-annotations/6342) +- [Scala 3 Reference: Pattern Bindings](https://docs.scala-lang.org/scala3/reference/changed-features/pattern-bindings.html), +- None of OCaml, Rust, Swift, or Java offer explicit escape hatches for non-exhaustive pattern matches (Haskell does not even warn by default). Instead the user must add a default case, (making it exhaustive) or use the equivalent of `@nowarn` when they exist. + +## FAQ + +N/A so far. diff --git a/_sips/sips/unroll-default-arguments-for-binary-compatibility.md b/_sips/sips/unroll-default-arguments-for-binary-compatibility.md new file mode 100644 index 0000000000..0acee8e40b --- /dev/null +++ b/_sips/sips/unroll-default-arguments-for-binary-compatibility.md @@ -0,0 +1,7 @@ +--- +title: SIP-61 - Unroll Default Arguments for Binary Compatibility +status: under-review +pull-request-number: 78 +stage: design + +--- From 86170ba0b98eae0cb578a5462592bc750f5bd679 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Tue, 20 Feb 2024 21:00:27 -0800 Subject: [PATCH 2796/3075] Scala 2.12.19 --- _config.yml | 2 +- _overviews/jdk-compatibility/overview.md | 10 ++++------ api/all.md | 22 +++++++++++++++------- 3 files changed, 20 insertions(+), 14 deletions(-) diff --git a/_config.yml b/_config.yml index f9d9ded020..b9977c34b4 100644 --- a/_config.yml +++ b/_config.yml @@ -16,7 +16,7 @@ keywords: - Guide scala-version: 2.13.12 -scala-212-version: 2.12.18 +scala-212-version: 2.12.19 scala-3-version: 3.3.1 collections: diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 80e4e50840..e5da2f89b1 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,9 +14,8 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| -| 22 (ea) | 3.3.2* | 2.13.12 | 2.12.19* | | +| 22 (ea) | 3.3.2* | 2.13.12 | 2.12.19 | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | -| 20 | 3.3.0 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | | 11 (LTS) | 3.0.0 | 2.13.0 | 2.12.4 | 2.11.12 | | 8 (LTS) | 3.0.0 | 2.13.0 | 2.12.0 | 2.11.0 | @@ -36,7 +35,6 @@ Minimum working versions: | JDK | sbt | mill | |:-----------:|:---------------:|:-----------| | 21 (LTS) | 1.9.0 | 0.11.5 | -| 20 | 1.9.0 | 0.11.0 | | 17 (LTS) | 1.6.0 | 0.7.0 | | 11 (LTS) | 1.1.0 | 0.1.5 | | 8 (LTS) | 1.0.0 | 0.1.0 | @@ -116,10 +114,10 @@ For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/j Early access builds of JDK 22 are available. JDK 22 will be non-LTS. Initial support for JDK 22 has been merged and is now available in -Scala 2.13.12. +Scala 2.13.12 and 2.12.19. -We are working on adding JDK 22 support to the 2.12.x and 3.3.x -release series. (Support may be available in nightly builds.) +We are working on adding JDK 22 support to the 3.3.x release +series. (Support may be available in nightly builds.) ## GraalVM Native Image compatibility notes diff --git a/api/all.md b/api/all.md index a39fc293da..9ca77d72f8 100644 --- a/api/all.md +++ b/api/all.md @@ -14,14 +14,14 @@ redirect_from: * [Library API](https://www.scala-lang.org/api/2.13.12/) * [Compiler API](https://www.scala-lang.org/api/2.13.12/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.12/scala-reflect/scala/reflect/) -* Scala 2.12.18 - * [Library API](https://www.scala-lang.org/api/2.12.18/) - * [Compiler API](https://www.scala-lang.org/api/2.12.18/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.12.18/scala-reflect/scala/reflect/) +* Scala 2.12.19 + * [Library API](https://www.scala-lang.org/api/2.12.19/) + * [Compiler API](https://www.scala-lang.org/api/2.12.19/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.12.19/scala-reflect/scala/reflect/) * Scala Modules - * [XML API](https://www.scala-lang.org/api/2.12.18/scala-xml/scala/xml/) - * [Parser Combinators API](https://www.scala-lang.org/api/2.12.18/scala-parser-combinators/scala/util/parsing/) - * [Swing API](https://www.scala-lang.org/api/2.12.18/scala-swing/scala/swing/) + * [XML API](https://www.scala-lang.org/api/2.12.19/scala-xml/scala/xml/) + * [Parser Combinators API](https://www.scala-lang.org/api/2.12.19/scala-parser-combinators/scala/util/parsing/) + * [Swing API](https://www.scala-lang.org/api/2.12.19/scala-swing/scala/swing/) * Scala 2.11.12 * [Library API](https://www.scala-lang.org/api/2.11.12/) * [Compiler API](https://www.scala-lang.org/api/2.11.12/scala-compiler/) @@ -132,6 +132,14 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/2.13.0/) * [Compiler API](https://www.scala-lang.org/api/2.13.0/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.0/scala-reflect/scala/reflect/) +* Scala 2.12.18 + * [Library API](https://www.scala-lang.org/api/2.12.18/) + * [Compiler API](https://www.scala-lang.org/api/2.12.18/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.12.18/scala-reflect/scala/reflect/) + * Scala Modules + * [XML API](https://www.scala-lang.org/api/2.12.18/scala-xml/scala/xml/) + * [Parser Combinators API](https://www.scala-lang.org/api/2.12.18/scala-parser-combinators/scala/util/parsing/) + * [Swing API](https://www.scala-lang.org/api/2.12.18/scala-swing/scala/swing/) * Scala 2.12.17 * [Library API](https://www.scala-lang.org/api/2.12.17/) * [Compiler API](https://www.scala-lang.org/api/2.12.17/scala-compiler/scala/) From ffe509694421d686dead7e2237d59ff580cb616e Mon Sep 17 00:00:00 2001 From: Yubao Liu <yubao.liu@gmail.com> Date: Fri, 23 Feb 2024 18:09:05 +0800 Subject: [PATCH 2797/3075] Fixed broken "Scala 3" sub menu on mobile (#2971) CSS doesn't support id selector containing whitespace, see https://github.com/scala/docs.scala-lang/blob/d626b36e217a99ee078cdcfbc30d23386dc7fb00/resources/js/functions.js#L90 --- _includes/navbar-inner.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_includes/navbar-inner.html b/_includes/navbar-inner.html index 8ce1227e62..43de59b7e4 100644 --- a/_includes/navbar-inner.html +++ b/_includes/navbar-inner.html @@ -23,7 +23,7 @@ <li class="navigation-menu-item"> {% capture translatedPageId %}/{{page.language}}{{navItem.url | remove_first: '.html' }}{% endcapture %} {% assign navItemTranslated = site.documents | where: 'id', translatedPageId | first %} - <a href="{% if navItemTranslated.url %}{{navItemTranslated.url}}{% elsif navItem.url contains '://' or navItem.url == '#' %}{{navItem.url}}{% else %}{{site.baseurl}}{{navItem.url}}{% endif %}" id="{{ navItem.title | downcase | strip }}" {% if page.url contains navItem.url %}class="active"{% endif %}>{{navItem.title}}</a> + <a href="{% if navItemTranslated.url %}{{navItemTranslated.url}}{% elsif navItem.url contains '://' or navItem.url == '#' %}{{navItem.url}}{% else %}{{site.baseurl}}{{navItem.url}}{% endif %}" id="{{ navItem.title | downcase | strip | remove: ' ' }}" {% if page.url contains navItem.url %}class="active"{% endif %}>{{navItem.title}}</a> {% if navItem.submenu %} <ul class="navigation-dropdown"> {% for subItem in navItem.submenu %} @@ -42,7 +42,7 @@ <nav class="doc-navigation-submenus"> {% for navItem in navdata %} {% if navItem.submenu %} - <ul class="navigation-submenu" id="{{ navItem.title | downcase | strip }}" style="display: none;"> + <ul class="navigation-submenu" id="{{ navItem.title | downcase | strip | remove: ' ' }}" style="display: none;"> {% for subItem in navItem.submenu %} <li> <a href="{% if subItem.url contains '://' %}{{subItem.url}}{% else %}{{site.baseurl}}{{subItem.url}}{% endif %}">{{ subItem.title }}</a> From 862896c373dafb9db79ff08e3fc6a25388681104 Mon Sep 17 00:00:00 2001 From: Yubao Liu <yubao.liu@gmail.com> Date: Fri, 23 Feb 2024 18:10:14 +0800 Subject: [PATCH 2798/3075] Fixed wrong syntax for Java array (#2973) --- _overviews/scala3-book/scala-for-java-devs.md | 4 ++-- _zh-cn/overviews/scala3-book/scala-for-java-devs.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index d7d921b060..37482bdc49 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -978,8 +978,8 @@ val a = Array("a", "b") as being backed by this Java `String[]`: -```scala -String[] a = ["a", "b"]; +```java +String[] a = {"a", "b"}; ``` However, a Scala `Array` also has all of the functional methods you expect in a Scala collection, including `map` and `filter`: diff --git a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md index 918c1779aa..c8f449fd56 100644 --- a/_zh-cn/overviews/scala3-book/scala-for-java-devs.md +++ b/_zh-cn/overviews/scala3-book/scala-for-java-devs.md @@ -942,8 +942,8 @@ val a = Array("a", "b") 这个追溯到 Java 的 `String[]`: -```scala -String[] a = ["a", "b"]; +```java +String[] a = {"a", "b"}; ``` 但是，Scala `Array` 还具有您期望在 Scala 集合中使用的所有函数方法，包括 `map` 和 `filter`： From 60aea6541c670583586cd3fd16ccbf17afa4ad0f Mon Sep 17 00:00:00 2001 From: Yubao Liu <yubao.liu@gmail.com> Date: Fri, 23 Feb 2024 18:11:23 +0800 Subject: [PATCH 2799/3075] Always show TOC and move it to bottom on mobile (#2969) Fixed issue #925. --- _sass/layout/inner-main.scss | 4 ++++ _sass/layout/toc.scss | 4 ---- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_sass/layout/inner-main.scss b/_sass/layout/inner-main.scss index c76aff27b9..ca359a7355 100755 --- a/_sass/layout/inner-main.scss +++ b/_sass/layout/inner-main.scss @@ -43,6 +43,10 @@ order: 1; margin-bottom: 30px; } + + @include bp(medium) { + order: 3; // move TOC to the bottom on mobile + } } .content-nav-blog { diff --git a/_sass/layout/toc.scss b/_sass/layout/toc.scss index 22d9ada330..dfacedd379 100644 --- a/_sass/layout/toc.scss +++ b/_sass/layout/toc.scss @@ -11,10 +11,6 @@ position: relative; } - @include bp(medium) { - display: none; - } - .contents { font-weight: 700; } From 3ab320493127e2f89a68510f13fa0257112c8ecf Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 23 Feb 2024 11:49:57 +0100 Subject: [PATCH 2800/3075] Bump github-pages from 230 to 231 (#2974) Bumps [github-pages](https://github.com/github/pages-gem) from 230 to 231. - [Release notes](https://github.com/github/pages-gem/releases) - [Commits](https://github.com/github/pages-gem/compare/v230...v231) --- updated-dependencies: - dependency-name: github-pages dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- Gemfile.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 99a0baadc7..89227d9adf 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -42,7 +42,7 @@ GEM ffi (1.16.3-x64-mingw-ucrt) forwardable-extended (2.6.0) gemoji (4.1.0) - github-pages (230) + github-pages (231) github-pages-health-check (= 1.18.2) jekyll (= 3.9.5) jekyll-avatar (= 0.8.0) @@ -58,7 +58,7 @@ GEM jekyll-paginate (= 1.1.0) jekyll-readme-index (= 0.3.0) jekyll-redirect-from (= 0.16.0) - jekyll-relative-links (= 0.7.0) + jekyll-relative-links (= 0.6.1) jekyll-remote-theme (= 0.4.3) jekyll-sass-converter (= 1.5.2) jekyll-seo-tag (= 2.8.0) @@ -154,7 +154,7 @@ GEM jekyll (>= 3.0, < 5.0) jekyll-redirect-from (0.16.0) jekyll (>= 3.3, < 5.0) - jekyll-relative-links (0.7.0) + jekyll-relative-links (0.6.1) jekyll (>= 3.3, < 5.0) jekyll-remote-theme (0.4.3) addressable (~> 2.0) From 27cf89eced54eee3edb7f636330820552c16e1fe Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Mon, 26 Feb 2024 12:06:25 -0800 Subject: [PATCH 2801/3075] Scala 2.13.13 (#2978) --- _config.yml | 2 +- _overviews/FAQ/index.md | 8 ++++---- _overviews/contribute/bug-reporting-guide.md | 2 +- api/all.md | 12 ++++++++---- scripts/run-mdoc.sh | 4 ++-- 5 files changed, 16 insertions(+), 12 deletions(-) diff --git a/_config.yml b/_config.yml index b9977c34b4..479f4d3cc4 100644 --- a/_config.yml +++ b/_config.yml @@ -15,7 +15,7 @@ keywords: - Document - Guide -scala-version: 2.13.12 +scala-version: 2.13.13 scala-212-version: 2.12.19 scala-3-version: 3.3.1 diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 96c5edd438..3ef56d7866 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -120,11 +120,11 @@ with only minor supplements. That's why `versionString` and `versionNumberString` report that Scala 2 is in use: ``` -Welcome to Scala 3.3.1 (17.0.3, Java OpenJDK 64-Bit Server VM). +Welcome to Scala 3.3.2 (17.0.3, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. scala> util.Properties.versionNumberString -val res0: String = 2.13.10 +val res0: String = 2.13.12 ``` Note that even the latest Scala 3 version might not use the very @@ -332,14 +332,14 @@ setting in a multi-project build. For example, if you add this to your `build.sbt`: - scalaVersion := "2.13.12" + scalaVersion := "2.13.13" that's a "bare" setting, and you might expect it to apply build-wide. But it doesn't. _It only applies to the root project._ In many cases one should instead write: - ThisBuild / scalaVersion := "2.13.12" + ThisBuild / scalaVersion := "2.13.13" Other possibilities include: diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 91aa784e2f..9f0364c98f 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -65,7 +65,7 @@ If you cannot find your issue in the issue tracker, create a new bug. The detail Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - 1. **Exact Scala version** that you are using. For example, `2.13.12` or `3.3.0`. If the bug happens in multiple versions indicate all of them. + 1. **Exact Scala version** that you are using. For example, `2.13.13` or `3.3.2`. If the bug happens in multiple versions indicate all of them. 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? diff --git a/api/all.md b/api/all.md index 9ca77d72f8..e901a0dd43 100644 --- a/api/all.md +++ b/api/all.md @@ -10,10 +10,10 @@ redirect_from: * Scala 3.3.1 LTS * [Library API](https://www.scala-lang.org/api/3.3.1/) -* Scala 2.13.12 - * [Library API](https://www.scala-lang.org/api/2.13.12/) - * [Compiler API](https://www.scala-lang.org/api/2.13.12/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.13.12/scala-reflect/scala/reflect/) +* Scala 2.13.13 + * [Library API](https://www.scala-lang.org/api/2.13.13/) + * [Compiler API](https://www.scala-lang.org/api/2.13.13/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.13/scala-reflect/scala/reflect/) * Scala 2.12.19 * [Library API](https://www.scala-lang.org/api/2.12.19/) * [Compiler API](https://www.scala-lang.org/api/2.12.19/scala-compiler/scala/) @@ -84,6 +84,10 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.0.1/) * Scala 3.0.0 * [Library API](https://www.scala-lang.org/api/3.0.0/) +* Scala 2.13.12 + * [Library API](https://www.scala-lang.org/api/2.13.12/) + * [Compiler API](https://www.scala-lang.org/api/2.13.12/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.12/scala-reflect/scala/reflect/) * Scala 2.13.11 * [Library API](https://www.scala-lang.org/api/2.13.11/) * [Compiler API](https://www.scala-lang.org/api/2.13.11/scala-compiler/scala/) diff --git a/scripts/run-mdoc.sh b/scripts/run-mdoc.sh index ab2c1c6249..616960e771 100755 --- a/scripts/run-mdoc.sh +++ b/scripts/run-mdoc.sh @@ -1,11 +1,11 @@ #!/bin/bash set -eux -cs launch --scala-version 2.13.12 org.scalameta::mdoc:2.3.3 -- \ +cs launch --scala-version 2.13.13 org.scalameta::mdoc:2.3.3 -- \ --in . \ --out /tmp/mdoc-out/ \ --classpath \ - $(cs fetch --scala-version 2.13.12 -p \ + $(cs fetch --scala-version 2.13.13 -p \ com.chuusai::shapeless:2.3.10 \ org.scala-lang::toolkit:0.1.7 \ org.scala-lang::toolkit-test:0.1.7 \ From 42a6e8e942f482d3b08a181e982db336e94af3c0 Mon Sep 17 00:00:00 2001 From: Ben Luo <benluo@gmail.com> Date: Tue, 27 Feb 2024 21:14:20 +0800 Subject: [PATCH 2802/3075] update translation according to English. (#2979) * update translation according to Engish. * correct translation. Deleted English sentences. --- .../scala3-book/methods-main-methods.md | 39 ++++++++++++++----- 1 file changed, 29 insertions(+), 10 deletions(-) diff --git a/_zh-cn/overviews/scala3-book/methods-main-methods.md b/_zh-cn/overviews/scala3-book/methods-main-methods.md index 60ffd9c028..1b185854b1 100644 --- a/_zh-cn/overviews/scala3-book/methods-main-methods.md +++ b/_zh-cn/overviews/scala3-book/methods-main-methods.md @@ -13,6 +13,7 @@ layout: multipage-overview permalink: "/zh-cn/scala3/book/:title.html" --- +<h5>编写<span class="tag tag-inline">仅Scala 3 适用</span>的一行程序</h5> Scala 3 提供了一种定义可以从命令行调用的程序的新方法：在方法中添加 `@main` 注释会将其变成可执行程序的入口点： @@ -26,16 +27,10 @@ Scala 3 提供了一种定义可以从命令行调用的程序的新方法：在 {% endtab %} {% endtabs %} -只需将该行代码保存在一个名为 *Hello.scala* 的文件中——文件名不必与方法名匹配——并使用 `scalac` 编译它： +只需将该行代码保存在一个名为 *Hello.scala* 的文件中——文件名不必与方法名匹配——并使用 `scala` 运行它： ```bash -$ scalac Hello.scala -``` - -然后用 `scala` 运行它： - -```bash -$ scala hello +$ scala Hello.scala Hello, world ``` @@ -81,8 +76,8 @@ $ scala happyBirthday 23 Lisa Peter Happy 23rd Birthday, Lisa and Peter! ``` -如图所示，`@main` 方法可以有任意数量的参数。 -对于每个参数类型，必须是 `scala.util.CommandLineParser.FromString` 类型类的一个 [given实例]({% link _overviews/scala3-book/ca-context-parameters.md %})，它将参数 `String` 转换为所需的参数类型。 +如上所示，`@main` 方法可以有任意数量的参数。 +对于每个参数类型，必须是 `scala.util.CommandLineParser.FromString` 类型类的一个 [given实例]({% link _zh-cn/overviews/scala3-book/ca-context-parameters.md %})，它将参数 `String` 转换为所需的参数类型。 同样如图所示，主方法的参数列表可以以重复参数结尾，例如 `String*`，它接受命令行中给出的所有剩余参数。 从 `@main` 方法实现的程序检查命令行上是否有足够的参数来填充所有参数，以及参数字符串是否可以转换为所需的类型。 @@ -96,6 +91,30 @@ $ scala happyBirthday sixty Fred Illegal command line: java.lang.NumberFormatException: For input string: "sixty" ``` +## 用户自定义的类型作为参数 + +正如上面指出的，编译器为参数类型寻找 `scala.util.CommandLineParser.FromString` 类型类 的given 实例。 +例如，我们自定义了一个 `Color`类型，并希望当以参数使用。你可以像以下代码这样使用： + +{% tabs method_3 %} +{% tab 'Scala 3 Only' for=method_3 %} + +```scala +enum Color: + case Red, Green, Blue + +given ComamndLineParser.FromString[Color] with + def fromString(value: String): Color = Color.valueOf(value) + +@main def run(color: Color): Unit = + println(s"The color is ${color.toString}") +``` + +{% endtab %} +{% endtabs %} + +这对于您程序中的自定义类型以及可能使用的其他库中的类型，都是一样的。 + ## 细节 Scala 编译器从 `@main` 方法 `f` 生成程序，如下所示： From 96ced05a9f13ef8e5fe8578adb802a3c776aab7a Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Tue, 27 Feb 2024 17:53:31 -0800 Subject: [PATCH 2803/3075] Update _overviews/scala3-migration/tooling-scala2-xsource3.md --- _overviews/scala3-migration/tooling-scala2-xsource3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/tooling-scala2-xsource3.md b/_overviews/scala3-migration/tooling-scala2-xsource3.md index 8ed543b497..2812ef68c1 100644 --- a/_overviews/scala3-migration/tooling-scala2-xsource3.md +++ b/_overviews/scala3-migration/tooling-scala2-xsource3.md @@ -9,7 +9,7 @@ next-page: tooling-migration-mode The Scala 2.13 compiler issues helpful migration warnings with the `-Xsource:3` flag. Before moving to the Scala 3 compiler, it's recommended to enable this flag in Scala 2 and address the new warnings. -In addition to new warnigns, the flag enables certain benign Scala 3 syntax such as `import p.*`. +In addition to new warnings, the flag enables certain benign Scala 3 syntaxes such as `import p.*`. This page explains the details behind the flag, an overview is shown using `scalac -Xsource:help`. From 4297425c6cc08c2570f211475a3b514c4093d1e6 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Tue, 27 Feb 2024 17:57:38 -0800 Subject: [PATCH 2804/3075] small tweaks to -Xsource:3 doc page --- _overviews/scala3-migration/tooling-scala2-xsource3.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/_overviews/scala3-migration/tooling-scala2-xsource3.md b/_overviews/scala3-migration/tooling-scala2-xsource3.md index 2812ef68c1..7b8b98e614 100644 --- a/_overviews/scala3-migration/tooling-scala2-xsource3.md +++ b/_overviews/scala3-migration/tooling-scala2-xsource3.md @@ -8,16 +8,19 @@ next-page: tooling-migration-mode --- The Scala 2.13 compiler issues helpful migration warnings with the `-Xsource:3` flag. + Before moving to the Scala 3 compiler, it's recommended to enable this flag in Scala 2 and address the new warnings. -In addition to new warnings, the flag enables certain benign Scala 3 syntaxes such as `import p.*`. -This page explains the details behind the flag, an overview is shown using `scalac -Xsource:help`. +There is also a variant, `-Xsource:3-cross`; see below. + +This page explains the details behind the flags. An overview is shown using `scalac -Xsource:help`. ## Migration vs cross-building With Scala 2.13.13 and newer, the `-Xsource:3` flag comes in two variants: - `Xsource:3` enables warnings relevant for migrating a codebase to Scala 3. + In addition to new warnings, the flag enables certain benign Scala 3 syntaxes such as `import p.*`. - `Xsource:3-cross` is useful for projects that cross-build between Scala 2 and 3 for a longer period of time. For certain language constructs that trigger a warning with `-Xsource:3`, the behavior changes to match Scala 3. @@ -37,7 +40,7 @@ See also `scalac -quickfix:help`. ## Enabled Scala 3 syntax -The `-Xsource:3` flag enables the following Scala 3 syntax in Scala 2: +The `-Xsource:3` flag enables the following Scala 3 syntaxes in Scala 2: - `import p.*` - `import p.m as n` @@ -46,7 +49,6 @@ The `-Xsource:3` flag enables the following Scala 3 syntax in Scala 2: - `A & B` type intersection as an alias for `A with B` - Selecting a method `x.f` performs an eta-expansion (`x.f _`), even without an expected type - ## Scala 3 migration warnings in detail Many Scala 3 migration warnings are easy to understand and identical under `-Xsource:3` and `-Xsource:3-cross`, e.g., for implicit definitions without an explicit type: From 9671946f026a463bab61694795f29918da0f60c1 Mon Sep 17 00:00:00 2001 From: Som Snytt <som.snytt@gmail.com> Date: Tue, 27 Feb 2024 23:21:28 -0800 Subject: [PATCH 2805/3075] Tweak language for named args and example --- _tour/named-arguments.md | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/_tour/named-arguments.md b/_tour/named-arguments.md index 911982e83f..cec14a5ebf 100644 --- a/_tour/named-arguments.md +++ b/_tour/named-arguments.md @@ -20,26 +20,38 @@ When calling methods, you can label the arguments with their parameter names lik {% tab 'Scala 2 and 3' for=named-arguments-when-good %} ```scala mdoc def printName(first: String, last: String): Unit = - println(first + " " + last) + println(s"$first $last") -printName("John", "Smith") // Prints "John Smith" -printName(first = "John", last = "Smith") // Prints "John Smith" -printName(last = "Smith", first = "John") // Prints "John Smith" +printName("John", "Public") // Prints "John Public" +printName(first = "John", last = "Public") // Prints "John Public" +printName(last = "Public", first = "John") // Prints "John Public" +printName("Elton", last = "John") // Prints "Elton John" ``` {% endtab %} {% endtabs %} -Notice how the order of named arguments can be rearranged. However, if some arguments are named and others are not, the unnamed arguments must come first and in the order of their parameters in the method signature. +This is useful when two parameters have the same type and the arguments could be accidentally swapped. + +Notice that named arguments can be written in any order. However, once the arguments are not in parameter order, reading from left to right, then the rest of the arguments must be named. + +In the following example, named arguments enable the middle parameter to be omitted. But in the error case, the first argument is out of order, so the second argument must be named. {% tabs named-arguments-when-error %} {% tab 'Scala 2 and 3' for=named-arguments-when-error %} ```scala mdoc:fail -printName(last = "Smith", "john") // error: positional after named argument +def printFullName(first: String, middle: String = "Q.", last: String): Unit = + println(s"$first $middle $last") + +printFullName(first = "John", last = "Public") // Prints "John Q. Public" +printFullName("John", last = "Public") // Prints "John Q. Public" +printFullName("John", middle = "Quincy", "Public") // Prints "John Quincy Public" +printFullName(last = "Public", first = "John") // Prints "John Q. Public" +printFullName(last = "Public", "John") // error: positional after named argument ``` {% endtab %} {% endtabs %} -Named arguments work with calls to Java methods, but only if the Java library in question was compiled with `-parameters`. +Named arguments work with calls to Java methods, but only if the Java library in question was compiled with the `-parameters` flag. From c4566ebc9201d57a00fb6ffbc728d00ab43579b7 Mon Sep 17 00:00:00 2001 From: Lukas Rytz <lukas.rytz@gmail.com> Date: Wed, 28 Feb 2024 16:52:16 +0100 Subject: [PATCH 2806/3075] clarifications for -Xsource:3-cross in 2.13.13 --- .../tooling-scala2-xsource3.md | 39 +++++++++++++------ 1 file changed, 28 insertions(+), 11 deletions(-) diff --git a/_overviews/scala3-migration/tooling-scala2-xsource3.md b/_overviews/scala3-migration/tooling-scala2-xsource3.md index 7b8b98e614..42171c23dc 100644 --- a/_overviews/scala3-migration/tooling-scala2-xsource3.md +++ b/_overviews/scala3-migration/tooling-scala2-xsource3.md @@ -11,7 +11,7 @@ The Scala 2.13 compiler issues helpful migration warnings with the `-Xsource:3` Before moving to the Scala 3 compiler, it's recommended to enable this flag in Scala 2 and address the new warnings. -There is also a variant, `-Xsource:3-cross`; see below. +There is also a variant, `-Xsource:3-cross`; see below. **Note: Enabling `-Xsource:3-cross` in Scala 2.13.13 breaks binary compatibility, follow [scala/bug#12961](https://github.com/scala/bug/issues/12961) for details.** This page explains the details behind the flags. An overview is shown using `scalac -Xsource:help`. @@ -59,7 +59,33 @@ scala> object O { implicit val s = "" } error: Implicit definition must have explicit type (inferred String) [quickfixable] {% endhighlight %} -The following table explains warnings where where the behavior changes between `-Xsource:3` and `-Xsource:3-cross`. +The next paragraphs explain where the behavior changes between `-Xsource:3` and `-Xsource:3-cross`. + +### Changes affecting binary encoding + +As of Scala 2.13.13, there are 3 changes under `-Xsource:3-cross` that affect binary encoding of classfiles. For all of these changes a fatal warning is issued under `-Xsource:3`. + + 1. The constructor modifiers of case classes (`case class C private[p] (x: Int)`) are copied to the synthetic `apply` and `copy` methods. + 1. The synthetic companion objects of case classes no longer extend `FunctionN`. + 1. Overriding methods without an explicit return type inherit the return type from the parent (instead of using the inferred type of the method body). + +For projects that are already cross-building between Scala 2 and Scala 3 with existing releases for both, enabling `-Xsource:3-cross` breaks binary compatibility. For example, if a library defines + +{% highlight scala %} +trait A { def f: Object } +class B extends A { def f = "hi" } +{% endhighlight %} + + - enabling `-Xsource:3-cross` breaks binary compatibility on Scala 2.13: existing releases have `A.f: String`, the new version will have `A.f: Object` + - adding an explicit result type `A.f: String` breaks binary compatibility on Scala 3: existing releases have `A.f: Object` + +It is possible to work around this using version-dependent source files, see [scala/scala-xml#675](https://github.com/scala/scala-xml/pull/675) as an example. + +Working around the case companion `FunctionN` parent change is currently difficult (Scala 2.13.13), a solution is being discussed at [scala/bug#12961](https://github.com/scala/bug/issues/12961). + +### Changes in language semantics + +The following table shows cases where `-Xsource:3-cross` adopts language feature semantics from Scala 3. | Feature | `-Xsource:3` | `-Xsource:3-cross` | |--- |--- |--- | @@ -67,8 +93,6 @@ The following table explains warnings where where the behavior changes between ` | Unicode escapes in triple-quoted strings and raw interpolations (`"""\u0061"""`) | fatal warning, escape is processed | escape is not processed | | Leading infix operators continue the previous line <sup>1</sup> | fatal warning, second line is a separate expression | operation continues the previous line | | Desugaring of string interpolators using `StringContext` | fatal warning if the interpolation references a `StringContext` in scope different from `scala.StringContext` | desugaring always uses `scala.StringContext` | -| Modifiers of `apply` and `copy` methods of case classes with non-public constructors: `case class C private[p] (x: Int)` | fatal warning about the generated `apply` and `copy` being public | `apply` and `copy` inherit the access modifiers from the constructor | -| Inferred type of an overriding member <sup>2</sup> | fatal warning, the type of `B.f` is `String` | the type of `B.f` is `Object` | | An implicit for type `p.A` is found in the package prefix `p` | fatal warning | the package prefix `p` is no longer part of the implicit search scope | Example 1: @@ -78,10 +102,3 @@ Example 1: 1 + 2 {% endhighlight %} - -Example 2: - -{% highlight text %} -trait A { def f: Object } -class B extends A { def f = "hi" } -{% endhighlight %} From af7252c6110385ab3f7dcc8a2b935feffd98246d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= <pmarks@virtuslab.com> Date: Thu, 29 Feb 2024 17:20:16 +0100 Subject: [PATCH 2807/3075] Add api link to 3.3.3 --- _config.yml | 2 +- api/all.md | 8 ++++++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index 479f4d3cc4..53d97b4c0c 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.13 scala-212-version: 2.12.19 -scala-3-version: 3.3.1 +scala-3-version: 3.4.0 collections: style: diff --git a/api/all.md b/api/all.md index e901a0dd43..a1a31eb864 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,10 @@ redirect_from: ## Latest releases -* Scala 3.3.1 LTS - * [Library API](https://www.scala-lang.org/api/3.3.1/) +* Scala 3.4.0 + * [Library API](https://www.scala-lang.org/api/3.4.0/) +* Scala 3.3.3 LTS + * [Library API](https://www.scala-lang.org/api/3.3.3/) * Scala 2.13.13 * [Library API](https://www.scala-lang.org/api/2.13.13/) * [Compiler API](https://www.scala-lang.org/api/2.13.13/scala-compiler/scala/) @@ -62,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.3.1 LTS + * [Library API](https://www.scala-lang.org/api/3.3.1/) * Scala 3.3.0 LTS * [Library API](https://www.scala-lang.org/api/3.3.0/) * Scala 3.2.2 From 12375116ece890d0f5d5b4d1c9e760b2b81db3a7 Mon Sep 17 00:00:00 2001 From: Nicolas Stucki <nicolas.stucki@gmail.com> Date: Fri, 1 Mar 2024 15:36:38 +0100 Subject: [PATCH 2808/3075] Update varargs syntax in quote pattern examples (#2980) Issue found in https://github.com/lampepfl/dotty/issues/19709 --- _overviews/scala3-macros/tutorial/quotes.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_overviews/scala3-macros/tutorial/quotes.md b/_overviews/scala3-macros/tutorial/quotes.md index b57f60c23f..be34958958 100644 --- a/_overviews/scala3-macros/tutorial/quotes.md +++ b/_overviews/scala3-macros/tutorial/quotes.md @@ -156,11 +156,11 @@ given ToExpr[Boolean] with { given ToExpr[StringContext] with { def apply(stringContext: StringContext)(using Quotes) = val parts = Varargs(stringContext.parts.map(Expr(_))) - '{ StringContext($parts: _*) } + '{ StringContext($parts*) } } ``` The `Varargs` constructor just creates an `Expr[Seq[T]]` which we can efficiently splice as a varargs. -In general, any sequence can be spliced with `$mySeq: _*` to splice it as a varargs. +In general, any sequence can be spliced with `$mySeq*` to splice it as a varargs. ## Quoted patterns Quotes can also be used to check if an expression is equivalent to another or to deconstruct an expression into its parts. @@ -352,7 +352,7 @@ Types represented with `Type[T]` can be matched on using the patten `case '[...] inline def mirrorFields[T]: List[String] = ${mirrorFieldsImpl[T]} def mirrorFieldsImpl[T: Type](using Quotes): Expr[List[String]] = - + def rec[A : Type]: List[String] = Type.of[A] match case '[field *: fields] => Type.show[field] :: rec[fields] @@ -408,8 +408,8 @@ given FromExpr[Boolean] with { given FromExpr[StringContext] with { def unapply(x: Expr[StringContext])(using Quotes): Option[StringContext] = x match { - case '{ new StringContext(${Varargs(Exprs(args))}: _*) } => Some(StringContext(args: _*)) - case '{ StringContext(${Varargs(Exprs(args))}: _*) } => Some(StringContext(args: _*)) + case '{ new StringContext(${Varargs(Exprs(args))}*) } => Some(StringContext(args*)) + case '{ StringContext(${Varargs(Exprs(args))}*) } => Some(StringContext(args*)) case _ => None } } From 187863b06a51de88bb42a63a8dd4878d0a8eb247 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Fri, 1 Mar 2024 16:17:56 +0100 Subject: [PATCH 2809/3075] ignore more GitHub links in HTMLProofer (#2986) --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 4ba997628b..b800faa5b5 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -29,5 +29,5 @@ jobs: --ignore-empty-alt\ --allow-hash-href\ --enforce-https=false\ - --ignore-urls '/https://github.com/scala/docs.scala-lang/blob/main/.*/,/www.oracle.com/' + --ignore-urls '/https://github.com/scala/,/www.oracle.com/' From a68fdd6bfe4377628a3faca382588d29fb05e65c Mon Sep 17 00:00:00 2001 From: Hamza REMMAL <hamza@remmal.net> Date: Fri, 1 Mar 2024 19:18:28 +0100 Subject: [PATCH 2810/3075] Update links to use scala/scala3 instead of lampepfl/dotty --- _ja/scala3/contribute-to-docs.md | 4 ++-- _overviews/FAQ/index.md | 2 +- _overviews/compiler-options/optimizer.md | 2 +- _overviews/contribute/bug-reporting-guide.md | 2 +- _overviews/contribute/codereviews.md | 2 +- _overviews/contribute/guide.md | 2 +- _overviews/contribute/index.md | 8 ++++---- .../scala-standard-library-api-documentation.md | 2 +- .../scala3-migration/incompat-other-changes.md | 4 ++-- .../scala3-migration/incompat-type-checker.md | 2 +- .../scaladoc-settings-compatibility.md | 14 +++++++------- .../scala3-migration/tooling-migration-mode.md | 2 +- _overviews/scala3-scaladoc/docstrings.md | 2 +- _overviews/scala3-scaladoc/settings.md | 6 +++--- _ru/scala3/contribute-to-docs.md | 4 ++-- _ru/scala3/guides/scaladoc/docstrings.md | 2 +- _ru/scala3/guides/scaladoc/settings.md | 6 +++--- _ru/scala3/scaladoc.md | 2 +- .../minutes/2016-08-16-sip-10th-august-minutes.md | 2 +- _sips/minutes/2018-08-30-sip-minutes.md | 6 +++--- _sips/minutes/2018-11-26-sip-minutes.md | 12 ++++++------ _sips/minutes/2019-03-13-sip-minutes.md | 6 +++--- _sips/minutes/2019-06-08-sip-minutes.md | 4 ++-- _sips/minutes/2020-03-12-minutes.md | 6 +++--- _sips/minutes/2020-03-13-sip-minutes.md | 6 +++--- _sips/sips/binary-api.md | 10 +++++----- _sips/sips/byname-implicits.md | 4 ++-- _sips/sips/clause-interleaving.md | 2 +- _sips/sips/fewer-braces.md | 4 ++-- _sips/sips/interpolation-quote-escape.md | 2 +- _sips/sips/match-types-spec.md | 4 ++-- _sips/sips/multi-source-extension-overloads.md | 2 +- _sips/sips/polymorphic-eta-expansion.md | 2 +- _sips/sips/priority-based-infix-type-precedence.md | 2 +- _sips/sips/quote-pattern-type-variable-syntax.md | 8 ++++---- _sips/sips/trait-parameters.md | 2 +- _uk/scala3/scaladoc.md | 2 +- _zh-cn/scala3/reference/README.md | 4 ++-- scala3/contribute-to-docs.md | 4 ++-- scala3/reference/README.md | 4 ++-- scala3/scaladoc.md | 2 +- 41 files changed, 84 insertions(+), 84 deletions(-) diff --git a/_ja/scala3/contribute-to-docs.md b/_ja/scala3/contribute-to-docs.md index e95cc31b5f..90b123e08f 100644 --- a/_ja/scala3/contribute-to-docs.md +++ b/_ja/scala3/contribute-to-docs.md @@ -55,8 +55,8 @@ Scala 3 コンパイラとライブラリへの貢献と内部に関する包括 ## Scala 3 Language Reference The [Dotty reference]({{ site.scala3ref }}/overview.html) は Scala 3 になる予定である。これにはさまざまな言語仕様に関する公式のプレゼンテーションや技術的情報が含まれている。 -- [Sources](https://github.com/lampepfl/dotty/tree/main/docs/_docs) -- [Issues](https://github.com/lampepfl/dotty/issues) +- [Sources](https://github.com/scala/scala3/tree/main/docs/_docs) +- [Issues](https://github.com/scala/scala3/issues) [scala3-book]: {% link _overviews/scala3-book/introduction.md %} diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 3ef56d7866..d9d6b66d2d 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -321,7 +321,7 @@ tool you are using. For sbt, add it to `.jvmopts`. If the stack overflow doesn't go away no matter how much stack you give the compiler, then it's a compiler bug. Please report it on the [Scala 2 bug tracker](https://github.com/scala/bug/issues) or [Scala 3 -bug tracker](https://github.com/lampepfl/dotty/issues), but check +bug tracker](https://github.com/scala/scala3/issues), but check first if it's a duplicate of an existing ticket. ### I set a setting in sbt but nothing happened. Why? diff --git a/_overviews/compiler-options/optimizer.md b/_overviews/compiler-options/optimizer.md index 52705558b5..5f35867bb5 100644 --- a/_overviews/compiler-options/optimizer.md +++ b/_overviews/compiler-options/optimizer.md @@ -55,7 +55,7 @@ However, even when staying within these constraints, some changes performed by t - Inlined methods disappear from call stacks. - This can lead to unexpected behaviors when using a debugger. - - Related: line numbers (stored in bytecode) are discarded when a method is inlined into a different classfile, which also impacts debugging experience. (This [could be improved](https://github.com/scala/scala-dev/issues/3) and is expected to [progress](https://github.com/lampepfl/dotty/pull/11492).) + - Related: line numbers (stored in bytecode) are discarded when a method is inlined into a different classfile, which also impacts debugging experience. (This [could be improved](https://github.com/scala/scala-dev/issues/3) and is expected to [progress](https://github.com/scala/scala3/pull/11492).) - Inlining a method can delay class loading of the class where the method is defined. diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 9f0364c98f..303fd51d1a 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -3,7 +3,7 @@ title: Bug Reporting Guide num: 8 --- -The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug), and for Scala 3, it is located at [github.com/lampepfl/dotty](https://github.com/lampepfl/dotty/issues). Before you submit a bug make sure that it is certainly a bug by following instructions +The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug), and for Scala 3, it is located at [github.com/scala/scala3](https://github.com/scala/scala3/issues). Before you submit a bug make sure that it is certainly a bug by following instructions in [Is it a Bug?](#is-it-a-bug). ## Is it a Bug? diff --git a/_overviews/contribute/codereviews.md b/_overviews/contribute/codereviews.md index 619e91718d..cb49220627 100644 --- a/_overviews/contribute/codereviews.md +++ b/_overviews/contribute/codereviews.md @@ -28,7 +28,7 @@ own pull requests. <div class="container"> <div class="row"> <div class="span4 doc-block"> - <h4><a href="https://github.com/scala/scala/pulls">lampepfl/dotty</a></h4> + <h4><a href="https://github.com/scala/scala3/pulls">scala/scala3</a></h4> <p>Scala 3 bug fixes and changes in the language, core libs and included tools.</p> </div> <div class="span4 doc-block"> diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index 056bfcded9..beffb01868 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -34,7 +34,7 @@ unencumbered by copyrights or patents. ### Bug-fix Check List > Originally these steps cover the [Scala 2 compiler](https://github.com/scala/scala), but they also are relevant to -> the [Scala 3 compiler](https://github.com/lampepfl/dotty). +> the [Scala 3 compiler](https://github.com/scala/scala3). This is the impatient developer's checklist for the steps to submit a bug-fix pull request to the Scala project. For more information, description and justification for the steps, follow the links in that step. Further specific instructions for the release of Scala you are targeting can be found in the `CONTRIBUTING.md` file for that [GitHub branch](https://github.com/scala/scala) diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index 574ec761a2..73fdaaf478 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -54,7 +54,7 @@ scala_resources: icon: fa fa-bug link: /contribute/guide.html - title: Code Reviews - description: "Review pull requests against scala/scala, lampepfl/dotty, scala/scala-lang, scala/docs.scala-lang, and others." + description: "Review pull requests against scala/scala, scala/scala3, scala/scala-lang, scala/docs.scala-lang, and others." icon: fa fa-eye link: /contribute/codereviews.html - title: Core Libraries @@ -109,7 +109,7 @@ In the spree, regular project maintainers will mentor you to create your first c ### So you want to improve the Scala 3 compiler... -The [Scala 3 compiler](https://github.com/lampepfl/dotty) is an open source project. +The [Scala 3 compiler](https://github.com/scala/scala3) is an open source project. If you are curious about contributing but don't know how to begin, the [Scala Center](https://scala.epfl.ch) runs the **Scala Compiler Academy** project to onboard and educate new people to the project. You can join the regular **Issue Spree**, watch in-depth videos, and read the contributing guide: @@ -119,7 +119,7 @@ runs the **Scala Compiler Academy** project to onboard and educate new people to #### Which areas are perfect for newcomers? - Adding new linting options, which help enforce cleaner code. - Improving the clarity of error messages, so that the user understands better what went wrong. -- Add IDE quick-fix actions to error messages, e.g. PR [lampepfl/dotty#18314](https://github.com/lampepfl/dotty/pull/18314). +- Add IDE quick-fix actions to error messages, e.g. PR [scala/scala3#18314](https://github.com/scala/scala3/pull/18314). ### So you want to write a library... @@ -162,7 +162,7 @@ When contributing, please follow: ### Community tickets -All issues can be found in the [Scala bug tracker](https://github.com/scala/bug), or the [Scala 3 issue tracker](https://github.com/lampepfl/dotty/issues). Most issues are labeled +All issues can be found in the [Scala bug tracker](https://github.com/scala/bug), or the [Scala 3 issue tracker](https://github.com/scala/scala3/issues). Most issues are labeled to make it easier to find issues you are interested in. ### Tools and libraries diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md index 692cf00a76..27f2093d93 100644 --- a/_overviews/contribute/scala-standard-library-api-documentation.md +++ b/_overviews/contribute/scala-standard-library-api-documentation.md @@ -39,7 +39,7 @@ package objects for important packages (these often get overlooked for documenta and are a good place for API overviews). If you find an issue, please log it in the [Scala bug tracker](https://github.com/scala/bug), -(or else the [Scala 3 issue tracker](https://github.com/lampepfl/dotty/issues) for Scala 3 library additions) +(or else the [Scala 3 issue tracker](https://github.com/scala/scala3/issues) for Scala 3 library additions) **after making sure it is not already logged as an issue**. To help with disambiguation, please use the following format for issue title: diff --git a/_overviews/scala3-migration/incompat-other-changes.md b/_overviews/scala3-migration/incompat-other-changes.md index 57dc8998da..a7a003d8ec 100644 --- a/_overviews/scala3-migration/incompat-other-changes.md +++ b/_overviews/scala3-migration/incompat-other-changes.md @@ -124,7 +124,7 @@ class C extends B // In Scala 3, Error: class C needs to be abstract, since def {% endtab %} {% endtabs %} -This behavior was decided in [Dotty issue #4770](https://github.com/lampepfl/dotty/issues/4770). +This behavior was decided in [Dotty issue #4770](https://github.com/scala/scala3/issues/4770). An easy fix is simply to remove the abstract def, since in practice it had no effect in Scala 2. @@ -264,7 +264,7 @@ val pojo = new Pojo() A type of the form `=> T` cannot be used as an argument to a type parameter anymore. -This decision is explained in [this comment](https://github.com/lampepfl/dotty/blob/0f1a23e008148f76fd0a1c2991b991e1dad600e8/compiler/src/dotty/tools/dotc/core/ConstraintHandling.scala#L144-L152) of the Scala 3 source code. +This decision is explained in [this comment](https://github.com/scala/scala3/blob/0f1a23e008148f76fd0a1c2991b991e1dad600e8/compiler/src/dotty/tools/dotc/core/ConstraintHandling.scala#L144-L152) of the Scala 3 source code. For instance, it is not allowed to pass a function of type `Int => (=> Int) => Int` to the `uncurried` method since it would assign `=> Int` to the type parameter `T2`. diff --git a/_overviews/scala3-migration/incompat-type-checker.md b/_overviews/scala3-migration/incompat-type-checker.md index 09a6ea0bca..41afc5ebc7 100644 --- a/_overviews/scala3-migration/incompat-type-checker.md +++ b/_overviews/scala3-migration/incompat-type-checker.md @@ -14,7 +14,7 @@ Scala 3 being based on stronger theoretical foundations, these unsoundness bugs ## Unsoundness Fixes in Variance checks In Scala 2, default parameters and inner-classes are not subject to variance checks. -It is unsound and might cause runtime failures, as demonstrated by this [test](https://github.com/lampepfl/dotty/blob/10526a7d0aa8910729b6036ee51942e05b71abf6/tests/neg/variances.scala) in the Scala 3 repository. +It is unsound and might cause runtime failures, as demonstrated by this [test](https://github.com/scala/scala3/blob/10526a7d0aa8910729b6036ee51942e05b71abf6/tests/neg/variances.scala) in the Scala 3 repository. The Scala 3 compiler does not permit this anymore. diff --git a/_overviews/scala3-migration/scaladoc-settings-compatibility.md b/_overviews/scala3-migration/scaladoc-settings-compatibility.md index 8b1faf2102..7c6d63a59b 100644 --- a/_overviews/scala3-migration/scaladoc-settings-compatibility.md +++ b/_overviews/scala3-migration/scaladoc-settings-compatibility.md @@ -7,15 +7,15 @@ previous-page: options-new next-page: plugin-intro --- -The current page is stating the status of scaladoc settings. The related Github issue can be found here for [discussion](https://github.com/lampepfl/dotty/issues/11907) +The current page is stating the status of scaladoc settings. The related Github issue can be found here for [discussion](https://github.com/scala/scala3/issues/11907) | Scala2 | Scala3 | Description | Comment | Is implemented? | ------------- | ------------- | --- | --- | --- | | -doc-format | _ | Selects in which format documentation is rendered. | Actually, old scaladoc supports only html, so it is in some way consistent with new scaladoc, which provides only html | <i class="fa fa-times fa-lg"></i> | -| -doc-title | -project | The overall name of the Scaladoc site | Aliased in [#11965](https://github.com/lampepfl/dotty/issues/11965) | <i class="fa fa-check fa-lg"></i> | -| -doc-version | -project-version | | Aliased in [#11965](https://github.com/lampepfl/dotty/issues/11965) | <i class="fa fa-check fa-lg"></i> | -| -doc-footer | -project-footer | A footer on every Scaladoc page, by default the EPFL/Lightbend copyright notice. Can be overridden with a custom footer. | Fixed by [#11965](https://github.com/lampepfl/dotty/issues/11965) | <i class="fa fa-check fa-lg"></i> | +| -doc-title | -project | The overall name of the Scaladoc site | Aliased in [#11965](https://github.com/scala/scala3/issues/11965) | <i class="fa fa-check fa-lg"></i> | +| -doc-version | -project-version | | Aliased in [#11965](https://github.com/scala/scala3/issues/11965) | <i class="fa fa-check fa-lg"></i> | +| -doc-footer | -project-footer | A footer on every Scaladoc page, by default the EPFL/Lightbend copyright notice. Can be overridden with a custom footer. | Fixed by [#11965](https://github.com/scala/scala3/issues/11965) | <i class="fa fa-check fa-lg"></i> | | -doc-no-compile | _ | A directory containing sources which should be parsed for docstrings without compiling (e.g. AnyRef.scala) | We don't need this as we have completely different approach to that issue using -Ydocument-synthetic-types flag for synthetic types | <i class="fa fa-check fa-lg"></i> | | -doc-source-url | -source-links | A URL pattern used to link to the source file, with some variables supported... | Scala3 implementation provides richer syntax. You can find migration steps below this [table](#source-links). | <i class="fa fa-check fa-lg"></i> | | -doc-external-doc | -external-mappings | Links describing locations of external dependencies' documentations. | Scala3 implementation provides richer syntax. You can find migration steps below this [table](#external-mappings). | <i class="fa fa-check fa-lg"></i> | @@ -34,7 +34,7 @@ The current page is stating the status of scaladoc settings. The related Github | -diagrams-max-implicits | _ | | We don't need this in Scala3 | <i class="fa fa-times fa-lg"></i> | | -diagrams-dot-timeout | _ | | We don't need this in Scala3 | <i class="fa fa-times fa-lg"></i> | | -diagrams-dot-restart | _ | | We don't need this in Scala3 | <i class="fa fa-times fa-lg"></i> | -| -author | -author | | Fixed by [#11965](https://github.com/lampepfl/dotty/issues/11965) | <i class="fa fa-check fa-lg"></i> | +| -author | -author | | Fixed by [#11965](https://github.com/scala/scala3/issues/11965) | <i class="fa fa-check fa-lg"></i> | | -raw-output | _ | | We don't need this in Scala3 | <i class="fa fa-check fa-lg"></i> | | -no-prefixes | _ | | We don't need this in Scala3 | <i class="fa fa-check fa-lg"></i> | | -skip-packages | -skip-packages | | | <i class="fa fa-check fa-lg"></i> | @@ -42,8 +42,8 @@ The current page is stating the status of scaladoc settings. The related Github | -expand-all-types | _ | | Setting has been removed | <i class="fa fa-times fa-lg"></i> | | -groups | -groups | | | <i class="fa fa-check fa-lg"></i> | | -no-java-comments | _ | | We don't need this in Scala3 | <i class="fa fa-check fa-lg"></i> | -| -doc-canonical-base-url | -doc-canonical-base-url | A base URL to use as prefix and add `canonical` URLs to all pages. The canonical URL may be used by search engines to choose the URL that you want people to see in search results. If unset no canonical URLs are generated. | Fixed by [#11965](https://github.com/lampepfl/dotty/issues/11965) | <i class="fa fa-check fa-lg"></i> | -| -private | -private | Show all types and members. Unless specified, show only public and protected types and members. | Fixed by [#11965](https://github.com/lampepfl/dotty/issues/11965) | <i class="fa fa-check fa-lg"></i> | +| -doc-canonical-base-url | -doc-canonical-base-url | A base URL to use as prefix and add `canonical` URLs to all pages. The canonical URL may be used by search engines to choose the URL that you want people to see in search results. If unset no canonical URLs are generated. | Fixed by [#11965](https://github.com/scala/scala3/issues/11965) | <i class="fa fa-check fa-lg"></i> | +| -private | -private | Show all types and members. Unless specified, show only public and protected types and members. | Fixed by [#11965](https://github.com/scala/scala3/issues/11965) | <i class="fa fa-check fa-lg"></i> | | _ | -siteroot | | We don't backport it to old scaladoc | N/A | | _ | -project-logo | | Should we backport it to the old scaladoc? | N/A | | _ | -comment-syntax | | We don't backport it to the old scaladoc | N/A | diff --git a/_overviews/scala3-migration/tooling-migration-mode.md b/_overviews/scala3-migration/tooling-migration-mode.md index 1bcc4d0b02..82c79bc695 100644 --- a/_overviews/scala3-migration/tooling-migration-mode.md +++ b/_overviews/scala3-migration/tooling-migration-mode.md @@ -11,7 +11,7 @@ The Scala 3 compiler provides some helpful utilities to ease the migration. Try running `scalac` to have a glimpse of those utilities: -> `scalac` is the executable of the Scala compiler, it can be downloaded from [Github](https://github.com/lampepfl/dotty/releases/). +> `scalac` is the executable of the Scala compiler, it can be downloaded from [Github](https://github.com/scala/scala3/releases/). > > It can also be installed using Coursier with `cs install scala3-compiler`, in which case `scalac` is aliased `scala3-compiler`. diff --git a/_overviews/scala3-scaladoc/docstrings.md b/_overviews/scala3-scaladoc/docstrings.md index f1036b3d29..0aed8c373f 100644 --- a/_overviews/scala3-scaladoc/docstrings.md +++ b/_overviews/scala3-scaladoc/docstrings.md @@ -52,7 +52,7 @@ In the example above, this Scaladoc comment is associated with the method square Scaladoc comments can go before fields, methods, classes, traits, objects. For now, scaladoc doesn't support straightforward solution to document packages. There is a dedicated github -[issue](https://github.com/lampepfl/dotty/issues/11284), where you can check the current status of the problem. +[issue](https://github.com/scala/scala3/issues/11284), where you can check the current status of the problem. For class primary constructors which in Scala coincide with the definition of the class itself, a @constructor tag is used to target a comment to be put on the primary constructor documentation rather than the class overview. diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index fe93ad639a..9408e6d9ce 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -12,7 +12,7 @@ This chapter lists the configuration options that can be used when calling scala ## Parity with scaladoc for Scala 2 Scaladoc has been rewritten from scratch and some of the features turned out to be useless in the new context. -If you want to know what is current state of compatibility with scaladoc old flags, you can visit this issue for tracking [progress](https://github.com/lampepfl/dotty/issues/11907). +If you want to know what is current state of compatibility with scaladoc old flags, you can visit this issue for tracking [progress](https://github.com/scala/scala3/issues/11907). ## Providing settings @@ -49,7 +49,7 @@ Revision (branch or ref) used to build project. Useful with sourcelinks to preve Source links provide a mapping between file in documentation and code repository. Example source links is: -`-source-links:docs=github://lampepfl/dotty/master#docs` +`-source-links:docs=github://scala/scala3/main#docs` Accepted formats: @@ -87,7 +87,7 @@ A mapping is of the form `<regex>::[scaladoc3|scaladoc|javadoc]::<path>`. You ca Links to social sites. For example: -`-social-links:github::https://github.com/lampepfl/dotty,discord::https://discord.com/invite/scala,twitter::https://twitter.com/scala_lang` +`-social-links:github::https://github.com/scala/scala3,discord::https://discord.com/invite/scala,twitter::https://twitter.com/scala_lang` Valid values are of the form: `[github|twitter|gitter|discord]::link`. Scaladoc also supports `custom::link::white_icon_name::black_icon_name`. In this case icons must be present in `images/` directory. diff --git a/_ru/scala3/contribute-to-docs.md b/_ru/scala3/contribute-to-docs.md index a96a1a0fa6..d01570ac6e 100644 --- a/_ru/scala3/contribute-to-docs.md +++ b/_ru/scala3/contribute-to-docs.md @@ -61,8 +61,8 @@ language: ru ## Справочник по языку Scala 3 [Справочник по Scala 3]({{ site.scala3ref }}) содержит формальное представление и подробную техническую информацию о различных возможностях языка. -- [Исходники](https://github.com/lampepfl/dotty/tree/main/docs/_docs) -- [Вопросы](https://github.com/lampepfl/dotty/issues) +- [Исходники](https://github.com/scala/scala3/tree/main/docs/_docs) +- [Вопросы](https://github.com/scala/scala3/issues) [scala3-book]: {% link _overviews/scala3-book/introduction.md %} diff --git a/_ru/scala3/guides/scaladoc/docstrings.md b/_ru/scala3/guides/scaladoc/docstrings.md index c537b39da6..6ba32d082e 100644 --- a/_ru/scala3/guides/scaladoc/docstrings.md +++ b/_ru/scala3/guides/scaladoc/docstrings.md @@ -52,7 +52,7 @@ Scaladoc расширяет возможности Markdown дополнител Комментарии Scaladoc могут идти перед полями, методами, классами, трейтами, объектами. На данный момент scaladoc не поддерживает прямое решение для документирования пакетов. -На гитхабе есть специальный [issue](https://github.com/lampepfl/dotty/issues/11284), где вы можете проверить текущий статус проблемы. +На гитхабе есть специальный [issue](https://github.com/scala/scala3/issues/11284), где вы можете проверить текущий статус проблемы. Для первичных конструкторов класса, которые в Scala совпадают с определением самого класса, тег @constructor используется для указания комментария, помещаемого в документацию первичных конструкторов, а не в обзор класса. diff --git a/_ru/scala3/guides/scaladoc/settings.md b/_ru/scala3/guides/scaladoc/settings.md index c36dedb135..9ce45e154d 100644 --- a/_ru/scala3/guides/scaladoc/settings.md +++ b/_ru/scala3/guides/scaladoc/settings.md @@ -13,7 +13,7 @@ previous-page: snippet-compiler ## Изменения scaladoc по сравнению со Scala 2 Scaladoc был переписан с нуля, и некоторые функции оказались бесполезными в новом контексте. -Текущее состояние совместимости со старыми флагами scaladoc можно увидеть [здесь](https://github.com/lampepfl/dotty/issues/11907). +Текущее состояние совместимости со старыми флагами scaladoc можно увидеть [здесь](https://github.com/scala/scala3/issues/11907). ## Указание настроек @@ -63,7 +63,7 @@ Compile / doc / scalacOptions ++= Seq("-project", "my-project"), Ссылки на источники обеспечивают сопоставление между файлом в документации и репозиторием кода. Примеры исходных ссылок: -`-source-links:docs=github://lampepfl/dotty/master#docs` +`-source-links:docs=github://scala/scala3/main#docs` Принимаемые форматы: @@ -99,7 +99,7 @@ Compile / doc / scalacOptions ++= Seq("-project", "my-project"), Ссылки на социальные сети. Например: -`-social-links:github::https://github.com/lampepfl/dotty,discord::https://discord.com/invite/scala,twitter::https://twitter.com/scala_lang` +`-social-links:github::https://github.com/scala/scala3,discord::https://discord.com/invite/scala,twitter::https://twitter.com/scala_lang` Допустимые значения имеют вид: `[github|twitter|gitter|discord]::link`. Scaladoc также поддерживает `custom::link::white_icon_name::black_icon_name`. diff --git a/_ru/scala3/scaladoc.md b/_ru/scala3/scaladoc.md index 969b4a4688..9c3df2e7fe 100644 --- a/_ru/scala3/scaladoc.md +++ b/_ru/scala3/scaladoc.md @@ -97,7 +97,7 @@ extension [T](arr: IArray[T]) def span(p: T => Boolean): (IArray[T], IArray[T]) Обратите внимание, что эта функция все еще находится в разработке, поэтому в нее могут быть внесены значительные изменения. Если вы столкнулись с ошибкой или у вас есть идея для улучшения, не стесняйтесь создавать issue на -[Inkuire](https://github.com/VirtusLab/Inkuire/issues/new) или [dotty](https://github.com/lampepfl/dotty/issues/new). +[Inkuire](https://github.com/VirtusLab/Inkuire/issues/new) или [dotty](https://github.com/scala/scala3/issues/new). [scaladoc]: /ru/scala3/guides/scaladoc/index.html [scaladoc-docstrings]: /ru/scala3/guides/scaladoc/docstrings.html diff --git a/_sips/minutes/2016-08-16-sip-10th-august-minutes.md b/_sips/minutes/2016-08-16-sip-10th-august-minutes.md index f2fe71d34f..b0009109a0 100644 --- a/_sips/minutes/2016-08-16-sip-10th-august-minutes.md +++ b/_sips/minutes/2016-08-16-sip-10th-august-minutes.md @@ -164,7 +164,7 @@ proposal or study it further. **Conclusion**: The Committee asks Dale to explicitly summarize the potential conflicts with tuple syntax, review the initial [HList proposal in -Dotty](https://github.com/lampepfl/dotty/issues/964) to figure out potential +Dotty](https://github.com/scala/scala3/issues/964) to figure out potential conflicts with his proposal. Eugene also proposes Dale to consider whether the Committee can salvage non-controversial parts of this proposal and reduce this SIP just to them, as well as discussing the utility of having two ways of doing diff --git a/_sips/minutes/2018-08-30-sip-minutes.md b/_sips/minutes/2018-08-30-sip-minutes.md index 164bf6e3c1..218877a1db 100644 --- a/_sips/minutes/2018-08-30-sip-minutes.md +++ b/_sips/minutes/2018-08-30-sip-minutes.md @@ -68,7 +68,7 @@ Decision / voting / postponing the discussion **Miles Sabin** summarised discussion on Contributors thread. - Focuses on the Contributors discussion rather than on the proposal itself -- Underlines a lack of motivation in the light of a separate issue from [Dotty: Weak eta-expansion](https://github.com/lampepfl/dotty/issues/2570) +- Underlines a lack of motivation in the light of a separate issue from [Dotty: Weak eta-expansion](https://github.com/scala/scala3/issues/2570) - Concludes that this proposal should be aligned with eta-extension issue Summary: @@ -77,9 +77,9 @@ References + [Scala Contributors thread](https://contributors.scala-lang.org/t/proposal-to-remove-auto-application-from-the-language/2145). -+ [Dotty issue: Weak eta-expansion](https://github.com/lampepfl/dotty/issues/2570). ++ [Dotty issue: Weak eta-expansion](https://github.com/scala/scala3/issues/2570). -+ [Martin's comment on the issue above](https://github.com/lampepfl/dotty/issues/2570#issuecomment-306202339). ++ [Martin's comment on the issue above](https://github.com/scala/scala3/issues/2570#issuecomment-306202339). Comments diff --git a/_sips/minutes/2018-11-26-sip-minutes.md b/_sips/minutes/2018-11-26-sip-minutes.md index 6b9bc8f10f..776257508a 100644 --- a/_sips/minutes/2018-11-26-sip-minutes.md +++ b/_sips/minutes/2018-11-26-sip-minutes.md @@ -49,7 +49,7 @@ The SIP Committee gathered for the first time face-to-face, for an extensive 3-d - Outline an action plan within a set time-frame; - Other: Unanimously voted for Guillaume Martres to join the Committee. -*Better understanding* was enabled by in depth presentations and Q&As with the EPFL Dotty team; *the Approach* was agreed upon the first day which resulted in creating “FAQs about Scala 3” (see below) and *the Action Plan* was outlined and is still under construction; several issues were opened (please see the list at the end of this document) and a project plan ["Meta-programming in Scala 3"](https://github.com/lampepfl/dotty/issues/5489) has been developed. +*Better understanding* was enabled by in depth presentations and Q&As with the EPFL Dotty team; *the Approach* was agreed upon the first day which resulted in creating “FAQs about Scala 3” (see below) and *the Action Plan* was outlined and is still under construction; several issues were opened (please see the list at the end of this document) and a project plan ["Meta-programming in Scala 3"](https://github.com/scala/scala3/issues/5489) has been developed. As the most important points and summary is reflected in “FAQs about Scala 3”, it will stand as an official “minutes” for this unique SIP meeting. @@ -144,20 +144,20 @@ The dependency of Scala 2 macros and reflection on internal implementation detai We recognize that important parts of the Scala ecosystem have made essential use of the Scala 2 facilities and that it is vital that as many as possible of these use cases be accommodated in Scala 3 in some form or another. This will be disruptive, but we hope to mitigate the disruption by providing facilities which make the more straightforward and important scenarios simpler while still leaving others possible. Our direction is still evolving; however we believe that replacing the current excessively general and expressive macro system with a suite of less powerful but complementary tools is the way forward. Currently we are exploring options which range from improved support for type level programming in the language itself (eg. specialized inline, match types, stable definitions, GADT improvements); intrinsifying certain features currently supported by macros (eg. by-name implicits, generic programming primitives); through to less general forms of metaprogramming (quote/splice and staging) and portable reflection via Tasty (which we [recommend](https://github.com/scalacenter/advisoryboard/pull/40)) to support in both Scala 2/3 and via compiler-independent libraries and tools. We recommend that most current uses of Scala macros and reflection can be accommodated by some combination of these tools. -For more about the project's progress, please see https://github.com/lampepfl/dotty/issues/5489 +For more about the project's progress, please see https://github.com/scala/scala3/issues/5489 ### How do we plan to address language experimentation? We acknowledge that language experimentation is necessary for improving the language. We also believe it requires a different vehicle than stable Scala releases. We don’t have a concrete solution for now, but we’re working on one. ### Other “documents” created during the meetings: -[SIP: Structural Types](https://github.com/lampepfl/dotty/issues/5372) +[SIP: Structural Types](https://github.com/scala/scala3/issues/5372) -[SIP: TASTY changes](https://github.com/lampepfl/dotty/issues/5378) +[SIP: TASTY changes](https://github.com/scala/scala3/issues/5378) -[SIP: Underscore Syntax for Type Lambdas](https://github.com/lampepfl/dotty/issues/5379) +[SIP: Underscore Syntax for Type Lambdas](https://github.com/scala/scala3/issues/5379) -[Should we bring back rewrite methods?](https://github.com/lampepfl/dotty/issues/5381) +[Should we bring back rewrite methods?](https://github.com/scala/scala3/issues/5381) [Features work progress overview](https://docs.google.com/spreadsheets/d/1GWJUo0U3JbBtrfg5vqgb6H5S6wlU5HnTxebLcHwD1zw/edit?usp=sharing) diff --git a/_sips/minutes/2019-03-13-sip-minutes.md b/_sips/minutes/2019-03-13-sip-minutes.md index 7668b77208..80854b32e3 100644 --- a/_sips/minutes/2019-03-13-sip-minutes.md +++ b/_sips/minutes/2019-03-13-sip-minutes.md @@ -404,7 +404,7 @@ import implied Martin: there's a PR, not yet merged, that refines this rule considerably compared to what's on the Dotty feature page? -It's [https://github.com/lampepfl/dotty/pull/6041](https://github.com/lampepfl/dotty/pull/6041) -- it has the new impl as well as the changes to the web page. +It's [https://github.com/scala/scala3/pull/6041](https://github.com/scala/scala3/pull/6041) -- it has the new impl as well as the changes to the web page. Martin: we now have a custom error message so if something fails but changing import to import implied would fix it, the compiler will tell you. @@ -508,7 +508,7 @@ What's the metaprogramming status? Martin: quote and splice are stable, but don't support pattern matching yet. TASTY reflection is not complete yet and is still undergoing revisions based on use cases that are being tried. -No one has done any meaningful whitebox macros yet in the new system, but the door is now open. (<-- not sure if I should include this in the notes without understanding in what context we want to allow whitebox macros?) This only got merged "last week". The relevant PR is [https://github.com/lampepfl/dotty/pull/5846](https://github.com/lampepfl/dotty/pull/5846) "The main motivation for moving staging to typer is to support whitebox macros" but it's still very early days, no one has tried to actually use this. +No one has done any meaningful whitebox macros yet in the new system, but the door is now open. (<-- not sure if I should include this in the notes without understanding in what context we want to allow whitebox macros?) This only got merged "last week". The relevant PR is [https://github.com/scala/scala3/pull/5846](https://github.com/scala/scala3/pull/5846) "The main motivation for moving staging to typer is to support whitebox macros" but it's still very early days, no one has tried to actually use this. # **Kind polymorphism** @@ -554,7 +554,7 @@ Questions about the magic automatic extends clauses, how does the compiler know, "Generally, all covariant type parameters of the enum class are minimized in a compiler-generated extends clause whereas all contravariant type parameters are maximized", says the doc -There was some discussion of the details of the rules for type parameters -- this then erupted into a full-on debate. e.g. isn't it weird that if you add an extends clause, suddenly T isn't in scope any more? see [https://github.com/lampepfl/dotty/pull/6095](https://github.com/lampepfl/dotty/pull/6095) +There was some discussion of the details of the rules for type parameters -- this then erupted into a full-on debate. e.g. isn't it weird that if you add an extends clause, suddenly T isn't in scope any more? see [https://github.com/scala/scala3/pull/6095](https://github.com/scala/scala3/pull/6095) conclusion: Martin: I'll try to update the rules to reflect the behavior of the compiler. diff --git a/_sips/minutes/2019-06-08-sip-minutes.md b/_sips/minutes/2019-06-08-sip-minutes.md index 30072129bd..247472ece1 100644 --- a/_sips/minutes/2019-06-08-sip-minutes.md +++ b/_sips/minutes/2019-06-08-sip-minutes.md @@ -28,7 +28,7 @@ apart from the other implicits changes ### Auto-tupling -Implemented but not merged: [https://github.com/lampepfl/dotty/pull/4311](https://github.com/lampepfl/dotty/pull/4311) +Implemented but not merged: [https://github.com/scala/scala3/pull/4311](https://github.com/scala/scala3/pull/4311) The problem is when using infix (e.g. an operator method) there's confusion between a 1-argument tuple2 method and a 2-argument method, of which there are a few in the standard library. @@ -96,7 +96,7 @@ Adriaan: Also let's not forget the big Scaladoc impact, can't copy because of th ### Polymorphic function types -Merged but not documented: [https://github.com/lampepfl/dotty/pull/4672](https://github.com/lampepfl/dotty/pull/4672) +Merged but not documented: [https://github.com/scala/scala3/pull/4672](https://github.com/scala/scala3/pull/4672) Presented by Guillaume. diff --git a/_sips/minutes/2020-03-12-minutes.md b/_sips/minutes/2020-03-12-minutes.md index c83443462d..4e40af5e32 100644 --- a/_sips/minutes/2020-03-12-minutes.md +++ b/_sips/minutes/2020-03-12-minutes.md @@ -128,7 +128,7 @@ Run through https://dotty.epfl.ch/docs/reference/metaprogramming/inline.html * Gui: inline interacts with overriding * Nic: if in a subclass (say Range) you override a method (say foreach) with `inline` it only inlines if the type is cast * Seb: I need both, inline if statically the type is Range, and use the optimised override if it's a Seq that's a Range at runtime -* (After the meeting, this led to [lampepfl/dotty#8543](https://github.com/lampepfl/dotty/pull/8543) and [lampepfl/dotty#8564](https://github.com/lampepfl/dotty/issues/8564).) +* (After the meeting, this led to [scala/scala3#8543](https://github.com/scala/scala3/pull/8543) and [scala/scala3#8564](https://github.com/scala/scala3/issues/8564).) * Lukas: `inline` is perfect for macros, but it shouldn't exist for performance. The runtime is where performance should be fixed (and it's in a better position to do it) * Lukas: inlining isn't on by default (in Scala 2) because it interacts with binary compatibility in non-obvious ways, and `inline` in Dotty does the same @@ -144,7 +144,7 @@ Run through https://dotty.epfl.ch/docs/reference/metaprogramming/reflection.html ### Review match types -Review https://github.com/dotty-staging/dotty/blob/fix-6709/docs/docs/reference/new-types/match-types.md (part of https://github.com/lampepfl/dotty/pull/8024) +Review https://github.com/dotty-staging/dotty/blob/fix-6709/docs/docs/reference/new-types/match-types.md (part of https://github.com/scala/scala3/pull/8024) ```scala type LeafElem[X] = X match { @@ -157,7 +157,7 @@ type LeafElem[X] = X match { * Olivier: The order of match type definitions is significant * Olivier: The disjointness is between `X` and `String`, not between `String` and `Array` -* Olivier: See https://github.com/lampepfl/dotty/issues/8493 as an example of disjointness requirement (can't use traits) +* Olivier: See https://github.com/scala/scala3/issues/8493 as an example of disjointness requirement (can't use traits) * Martin: Currently the use-cases can be implemented like Generic * Olivier: Put at a very high level, the intent is to remove some of the computation that happens in implicits and do it (better) in match types * Olivier: another problem is that when you type-check a type you can stackoverflow, which has bad UX, particularly given we have recursive types diff --git a/_sips/minutes/2020-03-13-sip-minutes.md b/_sips/minutes/2020-03-13-sip-minutes.md index 405755918d..7e394ea557 100644 --- a/_sips/minutes/2020-03-13-sip-minutes.md +++ b/_sips/minutes/2020-03-13-sip-minutes.md @@ -285,8 +285,8 @@ Martin: - Used widely in compiler codebase for 6 months - Does find is necessary to have vertical bars in editor for indentation - Examples at: - - https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/semanticdb/ExtractSemanticDB.scala - - https://github.com/lampepfl/dotty/blob/master/compiler/src/dotty/tools/dotc/typer/Nullables.scala + - https://github.com/scala/scala3/blob/main/compiler/src/dotty/tools/dotc/semanticdb/ExtractSemanticDB.scala + - https://github.com/scala/scala3/blob/main/compiler/src/dotty/tools/dotc/typer/Nullables.scala - `then` in if expression was harder to get used to Guillaume: @@ -424,7 +424,7 @@ Sébastien: - Asks if the new rules allow to add an implicit definition of a priority in-between two other definitions while preserving binary compatability? Martin, in response: -- Shows a [demo](https://github.com/lampepfl/dotty/blob/master/tests/run/implied-priority.scala) of how to insert a new implicit in between existing definitions. +- Shows a [demo](https://github.com/scala/scala3/blob/main/tests/run/implied-priority.scala) of how to insert a new implicit in between existing definitions. - The new scheme of priorities is more simple to grow than before because inheritance is fragile Sébastien is satisfied with the demo, is fine either way to add to 3.0 or later. Someone should champion it. diff --git a/_sips/sips/binary-api.md b/_sips/sips/binary-api.md index 8997304831..ba3fc8f010 100644 --- a/_sips/sips/binary-api.md +++ b/_sips/sips/binary-api.md @@ -32,7 +32,7 @@ Currently, the compiler automatically generates accessors for references to priv * Changing the implementation of an inline definition can be a binary incompatible change * Removing final from a class is a binary incompatible change -You can find more details in [https://github.com/lampepfl/dotty/issues/16983](https://github.com/lampepfl/dotty/issues/16983) +You can find more details in [https://github.com/scala/scala3/issues/16983](https://github.com/scala/scala3/issues/16983) ### Avoid duplication of inline accessors @@ -248,7 +248,7 @@ Using references to `@publicInBinary` in inline code can cause binary incompatib ### Add a `@binaryAccessor` This annotation would generate an stable accessor. This annotation could be used on `private` definition. It would also mitigate [migration costs](https://gist.github.com/nicolasstucki/003f7293941836b08a0d53dbcb913e3c) for library authors that have published unstable accessors. -* Implementation https://github.com/lampepfl/dotty/pull/16992 +* Implementation https://github.com/scala/scala3/pull/16992 ### Make all `private[C]` part of the binary API @@ -267,9 +267,9 @@ The drawback of this approach is that that we would need to force users to keep ## Related work -* Initial discussions: [https://github.com/lampepfl/dotty/issues/16983](https://github.com/lampepfl/dotty/issues/16983) -* Initial proof of concept (outdated): [https://github.com/lampepfl/dotty/pull/16992](https://github.com/lampepfl/dotty/pull/16992) -* Single annotation proof of concept: [https://github.com/lampepfl/dotty/pull/18402](https://github.com/lampepfl/dotty/pull/18402) +* Initial discussions: [https://github.com/scala/scala3/issues/16983](https://github.com/scala/scala3/issues/16983) +* Initial proof of concept (outdated): [https://github.com/scala/scala3/pull/16992](https://github.com/scala/scala3/pull/16992) +* Single annotation proof of concept: [https://github.com/scala/scala3/pull/18402](https://github.com/scala/scala3/pull/18402) * Community migration analysis: [Gist](https://gist.github.com/nicolasstucki/003f7293941836b08a0d53dbcb913e3c) * Kotlin: [PublishedApi](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-published-api/) plays the same role as `@publicInBinary` but its interaction with (inline definitions)[https://kotlinlang.org/docs/inline-functions.html#restrictions-for-public-api-inline-functions] diff --git a/_sips/sips/byname-implicits.md b/_sips/sips/byname-implicits.md index 4e47f9765c..b9a33eb455 100644 --- a/_sips/sips/byname-implicits.md +++ b/_sips/sips/byname-implicits.md @@ -39,7 +39,7 @@ the knot" implicitly. ### Implementation status -Byname implicits have been implemented in [Dotty](https://github.com/lampepfl/dotty/issues/1998) +Byname implicits have been implemented in [Dotty](https://github.com/scala/scala3/issues/1998) with an earlier iteration of the divergence checking algorithm described below. A full implementation of this proposal exists as a [pull request](https://github.com/scala/scala/pull/6050) relative to the 2.13.x branch of the Lightbend Scala compiler and it is scheduled to be included in @@ -851,7 +851,7 @@ object Test { because the path `foo` in `foo.Out` is not stable. Full parity with shapeless's `Lazy` would require lazy (rather than byname) implicit parameters (see [this Dotty -ticket](https://github.com/lampepfl/dotty/issues/3005) for further discussion) and is orthogonal to +ticket](https://github.com/scala/scala3/issues/3005) for further discussion) and is orthogonal to this SIP in that they would drop out of support for lazy parameters more generally, as described in [this Scala ticket](https://github.com/scala/bug/issues/240). diff --git a/_sips/sips/clause-interleaving.md b/_sips/sips/clause-interleaving.md index 120271e8d0..65fb815f86 100644 --- a/_sips/sips/clause-interleaving.md +++ b/_sips/sips/clause-interleaving.md @@ -167,7 +167,7 @@ As discussed above, we may want to consider generalizing class parameter lists a ## Related work * Pre-SIP: [https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525](https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525) -* An implementation of the proposal is available as a pull request at [https://github.com/lampepfl/dotty/pull/14019](https://github.com/lampepfl/dotty/pull/14019) +* An implementation of the proposal is available as a pull request at [https://github.com/scala/scala3/pull/14019](https://github.com/scala/scala3/pull/14019) ## FAQ Currently empty. diff --git a/_sips/sips/fewer-braces.md b/_sips/sips/fewer-braces.md index 4d1f9c1091..e6541ac4cb 100644 --- a/_sips/sips/fewer-braces.md +++ b/_sips/sips/fewer-braces.md @@ -131,7 +131,7 @@ If there would be code using these idioms, it can be rewritten quite simply to a ### Tooling -Since this affects parsing, the scalameta parser and any other parser used in an IDE will also need to be updated. The necessary changes to the Scala 3 parser were made here: https://github.com/lampepfl/dotty/pull/15273/commits. The commit that embodies the core change set is here: https://github.com/lampepfl/dotty/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a. +Since this affects parsing, the scalameta parser and any other parser used in an IDE will also need to be updated. The necessary changes to the Scala 3 parser were made here: https://github.com/scala/scala3/pull/15273/commits. The commit that embodies the core change set is here: https://github.com/scala/scala3/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a. ### Handling Edge Cases @@ -288,7 +288,7 @@ This is a tradeoff between conciseness and consistency. In the interest of minim - Doc page for proposed change: https://dotty.epfl.ch/docs/reference/other-new-features/indentation.html#variant-indentation-marker--for-arguments - - Merged PR implementing the proposal under experimental flag: https://github.com/lampepfl/dotty/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a + - Merged PR implementing the proposal under experimental flag: https://github.com/scala/scala3/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a - Latest discussion on contributors (there were several before when we discussed indentation in general): https://contributors.scala-lang.org/t/make-fewerbraces-available-outside-snapshot-releases/5024/166 diff --git a/_sips/sips/interpolation-quote-escape.md b/_sips/sips/interpolation-quote-escape.md index 4639fc615f..8385ed17a8 100644 --- a/_sips/sips/interpolation-quote-escape.md +++ b/_sips/sips/interpolation-quote-escape.md @@ -129,4 +129,4 @@ proposals. [^4]: https://github.com/scala/bug/issues/6476#issuecomment-292412577 "@retronym said: +1 to s"$"". Because it doesn't compile today, we don't risk changing the meaning of existing programs." [^5]: https://github.com/Scala/Scala/pull/6953/files#diff-0023b3bfa053fb16603156b785efa7ad "" [^6]: https://github.com/Scala/Scala/pull/4308 "SI-6476 Accept escaped quotes in interp strings" -[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" +[^7]: https://github.com/scala/scala3/pull/7486 "PR in scala3" diff --git a/_sips/sips/match-types-spec.md b/_sips/sips/match-types-spec.md index 1624e64cc5..a48500f506 100644 --- a/_sips/sips/match-types-spec.md +++ b/_sips/sips/match-types-spec.md @@ -95,7 +95,7 @@ It is however not possible to guarantee that property for *all* cases, since the #### Preamble Some of the concepts mentioned here are defined in the existing Scala 3 specification draft. -That draft can be found in the dotty repository at https://github.com/lampepfl/dotty/tree/main/docs/_spec. +That draft can be found in the dotty repository at https://github.com/scala/scala3/tree/main/docs/_spec. It is not rendered anywhere yet, though. Here are some of the relevant concepts that are perhaps lesser-known: @@ -573,7 +573,7 @@ Notable prior work related to this proposal includes: - [Current reference page for Scala 3 match types](https://dotty.epfl.ch/docs/reference/new-types/match-types.html) - [Abstractions for Type-Level Programming](https://infoscience.epfl.ch/record/294024), Olivier Blanvillain, Chapter 4 (Match Types) - ["Pre-Sip" discussion in the Contributors forum](https://contributors.scala-lang.org/t/pre-sip-proper-specification-for-match-types/6265) (submitted at the same time as this SIP document) -- [PR with the proposed implementation](https://github.com/lampepfl/dotty/pull/18262) +- [PR with the proposed implementation](https://github.com/scala/scala3/pull/18262) ## FAQ diff --git a/_sips/sips/multi-source-extension-overloads.md b/_sips/sips/multi-source-extension-overloads.md index a8a0637a7a..ab41056aee 100644 --- a/_sips/sips/multi-source-extension-overloads.md +++ b/_sips/sips/multi-source-extension-overloads.md @@ -226,7 +226,7 @@ A number of alternatives were mentioned in [the Contributors thread](https://con ## Related work - [Contributors thread acting as de facto Pre-SIP](https://contributors.scala-lang.org/t/change-shadowing-mechanism-of-extension-methods-for-on-par-implicit-class-behavior/5831) -- [Pull Request in dotty](https://github.com/lampepfl/dotty/pull/17050) to support it under an experimental import +- [Pull Request in dotty](https://github.com/scala/scala3/pull/17050) to support it under an experimental import ## FAQ diff --git a/_sips/sips/polymorphic-eta-expansion.md b/_sips/sips/polymorphic-eta-expansion.md index bd64ea84bb..ce38bca4b1 100644 --- a/_sips/sips/polymorphic-eta-expansion.md +++ b/_sips/sips/polymorphic-eta-expansion.md @@ -420,7 +420,7 @@ No other alternatives have been imagined, the similarity between this proposal a - If there is already a proof-of-concept implementation, a link to it will be welcome here. --> * Pre-SIP: https://contributors.scala-lang.org/t/polymorphic-eta-expansion/5516 -* A naive implementation can be found at https://github.com/lampepfl/dotty/pull/14015 (it is more general than this proposal and thus breaks compatibility) +* A naive implementation can be found at https://github.com/scala/scala3/pull/14015 (it is more general than this proposal and thus breaks compatibility) * A compatibility-preserving implementation is in development. diff --git a/_sips/sips/priority-based-infix-type-precedence.md b/_sips/sips/priority-based-infix-type-precedence.md index 71d32c1ce7..2189130200 100644 --- a/_sips/sips/priority-based-infix-type-precedence.md +++ b/_sips/sips/priority-based-infix-type-precedence.md @@ -137,7 +137,7 @@ However, it is very unlikely that such interaction would occur. **Related Issues** -* [Dotty Issue #1961](https://github.com/lampepfl/dotty/issues/1961) +* [Dotty Issue #1961](https://github.com/scala/scala3/issues/1961) ## Backward Compatibility diff --git a/_sips/sips/quote-pattern-type-variable-syntax.md b/_sips/sips/quote-pattern-type-variable-syntax.md index 92d1ce83fa..a6080d7a00 100644 --- a/_sips/sips/quote-pattern-type-variable-syntax.md +++ b/_sips/sips/quote-pattern-type-variable-syntax.md @@ -59,11 +59,11 @@ We want to be able to set the bounds of type variables to be able to match again ```scala case '[ head *: tail ] => h[tail] ``` -See [https://github.com/lampepfl/dotty/issues/11738](https://github.com/lampepfl/dotty/issues/11738). +See [https://github.com/scala/scala3/issues/11738](https://github.com/scala/scala3/issues/11738). ### Support matching on any kind of type We want to match against higher-kinded (or `AnyKind`) types. This is not possible due to the default upper bound of `Any`. -See [https://github.com/lampepfl/dotty/issues/10864](https://github.com/lampepfl/dotty/issues/10864). +See [https://github.com/scala/scala3/issues/10864](https://github.com/scala/scala3/issues/10864). ### Support multiple references to the same type in quoted type patterns We want to be able to match using several references to the same type variable. @@ -135,7 +135,7 @@ TASTy only contains explicit type variable definitions, and this encoding would ## Related work -* Proof of concept of type variable syntax: [https://github.com/lampepfl/dotty/pull/16910](https://github.com/lampepfl/dotty/pull/16910) -* Proof of concept of backticks (only interested in the first bullet point): [https://github.com/lampepfl/dotty/pull/16935](https://github.com/lampepfl/dotty/pull/16935) +* Proof of concept of type variable syntax: [https://github.com/scala/scala3/pull/16910](https://github.com/scala/scala3/pull/16910) +* Proof of concept of backticks (only interested in the first bullet point): [https://github.com/scala/scala3/pull/16935](https://github.com/scala/scala3/pull/16935) <!-- ## FAQ --> diff --git a/_sips/sips/trait-parameters.md b/_sips/sips/trait-parameters.md index 93bcd8bf70..633f0c0b73 100644 --- a/_sips/sips/trait-parameters.md +++ b/_sips/sips/trait-parameters.md @@ -69,4 +69,4 @@ the evaluation order would be `e1`, initializer of `T`, `e2`, initializer of `V` ## See Also ## -[Dotty Issue #640](https://github.com/lampepfl/dotty/issues/640) +[Dotty Issue #640](https://github.com/scala/scala3/issues/640) diff --git a/_uk/scala3/scaladoc.md b/_uk/scala3/scaladoc.md index f9193aa1c6..66a6d12805 100644 --- a/_uk/scala3/scaladoc.md +++ b/_uk/scala3/scaladoc.md @@ -81,7 +81,7 @@ extension [T](arr: IArray[T]) def span(p: T => Boolean): (IArray[T], IArray[T]) Для отримання додаткової інформації дивіться [Посібники](/scala3/guides/scaladoc/search-engine.html) Зауважте, що ця функція все ще знаходиться на стадії розробки, тому вона може зазнати значних змін. -Якщо ви зіткнулися з помилкою або маєте ідею щодо покращення, не соромтеся створювати проблему на [Inkuire](https://github.com/VirtusLab/Inkuire/issues/new) або [dotty](https://github.com/lampepfl/dotty/issues/new). +Якщо ви зіткнулися з помилкою або маєте ідею щодо покращення, не соромтеся створювати проблему на [Inkuire](https://github.com/VirtusLab/Inkuire/issues/new) або [dotty](https://github.com/scala/scala3/issues/new). [scaladoc-docstrings]: {% link _overviews/scala3-scaladoc/docstrings.md %} [static-documentation]: {% link _overviews/scala3-scaladoc/static-site.md %} diff --git a/_zh-cn/scala3/reference/README.md b/_zh-cn/scala3/reference/README.md index 4606ed70d9..960554be5f 100644 --- a/_zh-cn/scala3/reference/README.md +++ b/_zh-cn/scala3/reference/README.md @@ -1,5 +1,5 @@ -https://docs.scala-lang.org/scala3/reference 的页面内容是从 [Scala 3 编译器库](https://github.com/lampepfl/dotty) 生成的。 +https://docs.scala-lang.org/scala3/reference 的页面内容是从 [Scala 3 编译器库](https://github.com/scala/scala3) 生成的。 请到这里为 Scala 3 参考文档做贡献： -https://github.com/lampepfl/dotty/tree/main/docs/_docs +https://github.com/scala/scala3/tree/main/docs/_docs diff --git a/scala3/contribute-to-docs.md b/scala3/contribute-to-docs.md index ca9201c5b4..3196600581 100644 --- a/scala3/contribute-to-docs.md +++ b/scala3/contribute-to-docs.md @@ -56,8 +56,8 @@ contains a comprehensive overview over contribution to and internals of the Scal ## Scala 3 Language Reference The [Scala 3 reference]({{ site.scala3ref }}) contains a formal presentation and detailed technical information about the various features of the language. -- [Sources](https://github.com/lampepfl/dotty/tree/main/docs/_docs) -- [Issues](https://github.com/lampepfl/dotty/issues) +- [Sources](https://github.com/scala/scala3/tree/main/docs/_docs) +- [Issues](https://github.com/scala/scala3/issues) [scala3-book]: {% link _overviews/scala3-book/introduction.md %} diff --git a/scala3/reference/README.md b/scala3/reference/README.md index b23145e7f2..418bdbe3e1 100644 --- a/scala3/reference/README.md +++ b/scala3/reference/README.md @@ -1,6 +1,6 @@ The content of the pages https://docs.scala-lang.org/scala3/reference is -generated from the [Scala 3 compiler repository](https://github.com/lampepfl/dotty). +generated from the [Scala 3 compiler repository](https://github.com/scala/scala3). Please go here to contribute to the Scala 3 reference documentation: -https://github.com/lampepfl/dotty/tree/main/docs/_docs +https://github.com/scala/scala3/tree/main/docs/_docs diff --git a/scala3/scaladoc.md b/scala3/scaladoc.md index 92ba09827f..5a735173e3 100644 --- a/scala3/scaladoc.md +++ b/scala3/scaladoc.md @@ -79,7 +79,7 @@ This feature is provided by the [Inkuire](https://github.com/VirtusLab/Inkuire) For more information see [Guides](/scala3/guides/scaladoc/search-engine.html) Note that this feature is still in development, so it can be subject to considerable change. -If you encounter a bug or have an idea for improvement, don't hesitate to create an issue on [Inkuire](https://github.com/VirtusLab/Inkuire/issues/new) or [dotty](https://github.com/lampepfl/dotty/issues/new). +If you encounter a bug or have an idea for improvement, don't hesitate to create an issue on [Inkuire](https://github.com/VirtusLab/Inkuire/issues/new) or [scala3](https://github.com/scala/scala3/issues/new). [scaladoc-docstrings]: {% link _overviews/scala3-scaladoc/docstrings.md %} [static-documentation]: {% link _overviews/scala3-scaladoc/static-site.md %} From 140a3ba189526ee8cfc1bd848e8139a8ddeaab1b Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Sat, 2 Mar 2024 10:25:58 +0100 Subject: [PATCH 2811/3075] the ASM 9.6 upgrade didn't make 3.3.2 or 3.3.3 (#2983) --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index e5da2f89b1..2bd457a303 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| -| 22 (ea) | 3.3.2* | 2.13.12 | 2.12.19 | | +| 22 (ea) | 3.3.4* | 2.13.12 | 2.12.19 | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | | 11 (LTS) | 3.0.0 | 2.13.0 | 2.12.4 | 2.11.12 | From bb0e4dea79bece06bdc7a479d34b716924137912 Mon Sep 17 00:00:00 2001 From: Tom Snee <351700+tsnee@users.noreply.github.com> Date: Sun, 3 Mar 2024 11:20:51 -0500 Subject: [PATCH 2812/3075] Fix numbering conflict in methods-main-methods.md. --- _overviews/scala3-book/methods-main-methods.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index 02d40cc225..b56fd5a2d9 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -123,8 +123,8 @@ The Scala compiler generates a program from an `@main` method `f` as follows: For instance, the `happyBirthday` method above generates additional code equivalent to the following class: -{% tabs method_3 %} -{% tab 'Scala 3 Only' for=method_3 %} +{% tabs method_4 %} +{% tab 'Scala 3 Only' for=method_4 %} ```scala final class happyBirthday { @@ -158,7 +158,7 @@ The previous functionality of `App`, which relied on the “magic” `DelayedIni If programs need to cross-build between Scala 2 and Scala 3, it’s recommended to use an `object` with an explicit `main` method and a single `Array[String]` argument instead: -{% tabs method_4 %} +{% tabs method_5 %} {% tab 'Scala 2 and 3' %} ```scala From 9ed8c388c798119b7cdba26b00e41146434e49f4 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 4 Mar 2024 11:53:35 +0300 Subject: [PATCH 2813/3075] Add interacting-with-java.html in ru (#2990) --- .../scala3-book/interacting-with-java.md | 2 +- _ru/scala3/book/interacting-with-java.md | 560 ++++++++++++++++++ _ru/scala3/book/tools-worksheets.md | 2 +- 3 files changed, 562 insertions(+), 2 deletions(-) create mode 100644 _ru/scala3/book/interacting-with-java.md diff --git a/_overviews/scala3-book/interacting-with-java.md b/_overviews/scala3-book/interacting-with-java.md index 20eefda406..7d9d9f2469 100644 --- a/_overviews/scala3-book/interacting-with-java.md +++ b/_overviews/scala3-book/interacting-with-java.md @@ -2,7 +2,7 @@ title: Interacting with Java type: chapter description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. -languages: [zh-cn] +languages: [ru, zh-cn] num: 72 previous-page: tools-worksheets next-page: scala-for-java-devs diff --git a/_ru/scala3/book/interacting-with-java.md b/_ru/scala3/book/interacting-with-java.md new file mode 100644 index 0000000000..86f3268d46 --- /dev/null +++ b/_ru/scala3/book/interacting-with-java.md @@ -0,0 +1,560 @@ +--- +layout: multipage-overview +title: Взаимодействие с Java +scala3: true +partof: scala3-book +overview-name: "Scala 3 — Book" +type: chapter +description: На этой странице показано, как код Scala может взаимодействовать с Java и как код Java может взаимодействовать с кодом Scala. +language: ru +num: 72 +previous-page: tools-worksheets +next-page: +--- + +## Введение + +В этом разделе рассматривается, как использовать код Java в Scala и, наоборот, как использовать код Scala в Java. + +В целом, использование Java-кода в Scala довольно простое. +Есть лишь несколько моментов, +когда может появиться желание использовать утилиты Scala для преобразования концепций Java в Scala, +в том числе: + +- Классы коллекций Java +- Java класс `Optional` + +Аналогично, если вы пишете код Java и хотите использовать концепции Scala, +вам потребуется преобразовать коллекции Scala и Scala класс `Option`. + +В следующих разделах демонстрируются наиболее распространенные преобразования, которые вам могут понадобиться: + +- Как использовать коллекции Java в Scala +- Как использовать Java `Optional` в Scala +- Расширение Java интерфейсов в Scala +- Как использовать коллекции Scala в Java +- Как использовать Scala `Option` в Java +- Как использовать трейты Scala в Java +- Как обрабатывать методы Scala, которые вызывают исключения в коде Java +- Как использовать vararg-параметры Scala в Java +- Создание альтернативных имен для использования методов Scala в Java + +> Обратите внимание: примеры Java в этом разделе предполагают, что вы используете Java 11 или более позднюю версию. + +## Как использовать коллекции Java в Scala + +Когда вы пишете код на Scala, а API либо требует, либо создает класс коллекции Java (из пакета `java.util`), +тогда допустимо напрямую использовать или создавать коллекцию, как в Java. + +Однако для идиоматического использования в Scala, например, для циклов `for` по коллекции +или для применения функций высшего порядка, таких как `map` и `filter`, +вы можете создать прокси, который будет вести себя как коллекция Scala. + +Вот пример того, как это работает. +Учитывая следующий API, который возвращает `java.util.List[String]`: + +{% tabs foo-definition %} +{% tab Java %} + +```java +public interface Foo { + static java.util.List<String> getStrings() { + return List.of("a", "b", "c"); + } +} +``` + +{% endtab %} +{% endtabs %} + +Вы можете преобразовать этот Java список в Scala `Seq`, +используя утилиты преобразования из Scala объекта `scala.jdk.CollectionConverters`: + +{% tabs foo-usage class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import scala.jdk.CollectionConverters._ +import scala.collection.mutable + +def testList() = { + println("Using a Java List in Scala") + val javaList: java.util.List[String] = Foo.getStrings() + val scalaSeq: mutable.Seq[String] = javaList.asScala + for (s <- scalaSeq) println(s) +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +import scala.jdk.CollectionConverters.* +import scala.collection.mutable + +def testList() = + println("Using a Java List in Scala") + val javaList: java.util.List[String] = Foo.getStrings() + val scalaSeq: mutable.Seq[String] = javaList.asScala + for s <- scalaSeq do println(s) +``` + +{% endtab %} +{% endtabs %} + +В приведенном выше коде создается оболочка `javaList.asScala`, +которая адаптирует `java.util.List` к коллекции Scala `mutable.Seq`. + +## Как использовать Java `Optional` в Scala + +Когда вы взаимодействуете с API, который использует класс `java.util.Optional` в коде Scala, +его можно создавать и использовать, как в Java. + +Однако для идиоматического использования в Scala, например использования в `for`, +вы можете преобразовать его в Scala `Option`. + +Чтобы продемонстрировать это, вот Java API, который возвращает значение типа `Optional[String]`: + +{% tabs bar-definition %} +{% tab Java %} + +```java +public interface Bar { + static java.util.Optional<String> optionalString() { + return Optional.of("hello"); + } +} +``` + +{% endtab %} +{% endtabs %} + +Сначала импортируйте всё из объекта `scala.jdk.OptionConverters`, +а затем используйте метод `toScala` для преобразования `Optional` значения в Scala `Option`: + +{% tabs bar-usage class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import java.util.Optional +import scala.jdk.OptionConverters._ + +val javaOptString: Optional[String] = Bar.optionalString +val scalaOptString: Option[String] = javaOptString.toScala +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +import java.util.Optional +import scala.jdk.OptionConverters.* + +val javaOptString: Optional[String] = Bar.optionalString +val scalaOptString: Option[String] = javaOptString.toScala +``` + +{% endtab %} +{% endtabs %} + +## Расширение Java интерфейсов в Scala + +Если вам нужно использовать Java интерфейсы в коде Scala, расширяйте их так, как если бы они были трейтами Scala. +Например, учитывая эти три Java интерфейса: + +{% tabs animal-definition %} +{% tab Java %} + +```java +public interface Animal { + void speak(); +} + +public interface Wagging { + void wag(); +} + +public interface Running { + // an implemented method + default void run() { + System.out.println("I’m running"); + } +} +``` + +{% endtab %} +{% endtabs %} + +вы можете создать класс `Dog` в Scala так же, как если бы вы использовали трейты. +Поскольку у `run` есть реализация по умолчанию, вам нужно реализовать только методы `speak` и `wag`: + +{% tabs animal-usage class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +class Dog extends Animal with Wagging with Running { + def speak = println("Woof") + def wag = println("Tail is wagging") +} + +def useJavaInterfaceInScala = { + val d = new Dog() + d.speak + d.wag + d.run +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +class Dog extends Animal, Wagging, Running: + def speak = println("Woof") + def wag = println("Tail is wagging") + +def useJavaInterfaceInScala = + val d = Dog() + d.speak + d.wag + d.run +``` + +{% endtab %} +{% endtabs %} + +Также обратите внимание, что в Scala методы Java, определенные с пустыми списками параметров, +можно вызывать либо так же, как в Java, `.wag()`, +либо вы можете отказаться от использования круглых скобок `.wag`. + +## Как использовать коллекции Scala в Java + +Если вам нужно использовать класс коллекции Scala в своем Java-коде, +используйте методы Scala объекта `scala.jdk.javaapi.CollectionConverters` в своем Java-коде, +для корректной работы конверсии. + +Например, предположим, что Scala API возвращает `List[String]`, как следующем примере: + +{% tabs baz-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +object Baz { + val strings: List[String] = List("a", "b", "c") +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +object Baz: + val strings: List[String] = List("a", "b", "c") +``` + +{% endtab %} +{% endtabs %} + +Вы можете получить доступ к Scala `List` в Java-коде следующим образом: + +{% tabs baz-usage %} +{% tab Java %} + +```java +import scala.jdk.javaapi.CollectionConverters; + +// получить доступ к методу `strings` с помощью `Baz.strings()` +scala.collection.immutable.List<String> xs = Baz.strings(); + +java.util.List<String> listOfStrings = CollectionConverters.asJava(xs); + +for (String s: listOfStrings) { + System.out.println(s); +} +``` + +{% endtab %} +{% endtabs %} + +Этот код можно сократить, но показаны полные шаги, чтобы продемонстрировать, как работает процесс. +Обязательно обратите внимание, что хотя `Baz` имеет поле с именем `strings`, +в Java оно отображается как метод, поэтому его следует вызывать в круглых скобках `.strings()`. + +## Как использовать Scala `Option` в Java + +Если вам нужно использовать Scala `Option` в коде Java, +вы можете преобразовать значение `Option` в значение Java `Optional`, +используя метод `toJava` объекта Scala `scala.jdk.javaapi.OptionConverters`. + +Например, предположим, что Scala API возвращает `Option[String]`, как следующем примере: + +{% tabs qux-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +object Qux { + val optString: Option[String] = Option("hello") +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +object Qux: + val optString: Option[String] = Option("hello") +``` + +{% endtab %} +{% endtabs %} + +Затем вы можете получить доступ к Scala `Option` в своем Java-коде следующим образом: + +{% tabs qux-usage %} +{% tab Java %} + +```java +import java.util.Optional; +import scala.Option; +import scala.jdk.javaapi.OptionConverters; + +Option<String> scalaOptString = Qux.optString(); +Optional<String> javaOptString = OptionConverters.toJava(scalaOptString); +``` + +{% endtab %} +{% endtabs %} + +Этот код можно сократить, но показаны полные шаги, чтобы продемонстрировать, как работает процесс. +Обязательно обратите внимание, что хотя `Qux` имеет поле с именем `optString`, +в Java оно отображается как метод, поэтому его следует вызывать в круглых скобках `.optString()`. + +## Как использовать трейты Scala в Java + +Начиная с Java 8, вы можете использовать трейт Scala точно так же, как Java интерфейс, +даже если этот трейт реализует методы. +Например, учитывая эти два трейта Scala, один с реализованным методом, а другой только с интерфейсом: + +{% tabs scala-trait-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +trait ScalaAddTrait { + def sum(x: Int, y: Int) = x + y // реализован +} + +trait ScalaMultiplyTrait { + def multiply(x: Int, y: Int): Int // абстрактный +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +trait ScalaAddTrait: + def sum(x: Int, y: Int) = x + y // реализован + +trait ScalaMultiplyTrait: + def multiply(x: Int, y: Int): Int // абстрактный +``` + +{% endtab %} +{% endtabs %} + +Класс Java может реализовать оба этих интерфейса и определить метод `multiply`: + +{% tabs scala-trait-usage %} +{% tab Java %} + +```java +class JavaMath implements ScalaAddTrait, ScalaMultiplyTrait { + public int multiply(int a, int b) { + return a * b; + } +} + +JavaMath jm = new JavaMath(); +System.out.println(jm.sum(3,4)); // 7 +System.out.println(jm.multiply(3,4)); // 12 +``` + +{% endtab %} +{% endtabs %} + +## Как обрабатывать методы Scala, которые вызывают исключения в коде Java + +Когда вы пишете код на Scala, используя идиомы программирования Scala, +вы никогда не напишете метод, который генерирует исключение. +Но если по какой-то причине у вас есть метод Scala, который генерирует исключение, +и вы хотите, чтобы разработчики Java могли использовать этот метод, +добавьте аннотацию `@throws` к вашему методу Scala, +чтобы Java потребители знали, какие исключения он может генерировать. + +Например, следующий Scala метод `exceptionThrower` аннотирован, чтобы объявить, что он выдает `Exception`: + +{% tabs except-throw-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +object SExceptionThrower { + @throws[Exception] + def exceptionThrower = + throw new Exception("Idiomatic Scala methods don’t throw exceptions") +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +object SExceptionThrower: + @throws[Exception] + def exceptionThrower = + throw Exception("Idiomatic Scala methods don’t throw exceptions") +``` + +{% endtab %} +{% endtabs %} + +В результате вам придется обрабатывать исключение в своем Java-коде. +Например, этот код не скомпилируется из-за необработанного исключения: + +{% tabs except-throw-usage %} +{% tab Java %} + +```java +// не скомпилируется, потому что исключение не обработано +public class ScalaExceptionsInJava { + public static void main(String[] args) { + SExceptionThrower.exceptionThrower(); + } +} +``` + +{% endtab %} +{% endtabs %} + +Компилятор выдает следующую ошибку: + +```plain +[error] ScalaExceptionsInJava: unreported exception java.lang.Exception; + must be caught or declared to be thrown +[error] SExceptionThrower.exceptionThrower() +``` + +Хорошо — это то, что вы хотите: аннотация сообщает компилятору Java, что `exceptionThrower` может выдать исключение. +Теперь, когда вы пишете код на Java, вы должны обрабатывать исключение с помощью блока `try` +или объявлять, что ваш Java метод генерирует исключение. + +И наоборот, если вы укажите аннотацию Scala метода `exceptionThrower`, код Java _будет скомпилирован_. +Вероятно, это не то, что вам нужно, поскольку Java код может не учитывать метод Scala, выдающий исключение. + +## Как использовать vararg-параметры Scala в Java + +Если метод Scala имеет неопределенное количество параметров и вы хотите использовать этот метод в Java, +отметьте Scala метод аннотацией `@varargs`. +Например, метод `printAll` в этом Scala классе объявляет vararg-поле `String*`: + +{% tabs vararg-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import scala.annotation.varargs + +object VarargsPrinter { + @varargs def printAll(args: String*): Unit = args.foreach(println) +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +import scala.annotation.varargs + +object VarargsPrinter: + @varargs def printAll(args: String*): Unit = args.foreach(println) +``` + +{% endtab %} +{% endtabs %} + +Поскольку `printAll` объявлен с аннотацией `@varargs`, его можно вызвать из Java программы +с переменным количеством параметров, как показано в этом примере: + +{% tabs vararg-usage %} +{% tab Java %} + +```java +public class JVarargs { + public static void main(String[] args) { + VarargsPrinter.printAll("Hello", "world"); + } +} +``` + +{% endtab %} +{% endtabs %} + +Запуск кода приводит к следующему выводу: + +```plain +Hello +world +``` + +## Создание альтернативных имен для использования методов Scala в Java + +В Scala вы можете создать имя метода, используя символический знак: + +{% tabs add-definition %} +{% tab 'Scala 2 и 3' %} + +```scala +def +(a: Int, b: Int) = a + b +``` + +{% endtab %} +{% endtabs %} + +Такое имя метода корректно работать в Java не будет, +но в Scala вы можете предоставить "альтернативное" имя метода с аннотацией `targetName`, +которая будет именем метода при использовании из Java: + +{% tabs add-2-definition class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import scala.annotation.targetName + +object Adder { + @targetName("add") def +(a: Int, b: Int) = a + b +} +``` + +{% endtab %} +{% tab 'Scala 3' %} + +```scala +import scala.annotation.targetName + +object Adder: + @targetName("add") def +(a: Int, b: Int) = a + b +``` + +{% endtab %} +{% endtabs %} + +Теперь в вашем Java-коде вы можете использовать псевдоним метода `add`: + +{% tabs add-2-usage %} +{% tab Java %} + +```java +int x = Adder.add(1,1); +System.out.printf("x = %d\n", x); +``` + +{% endtab %} +{% endtabs %} diff --git a/_ru/scala3/book/tools-worksheets.md b/_ru/scala3/book/tools-worksheets.md index 42223f1f39..5409c5ad40 100644 --- a/_ru/scala3/book/tools-worksheets.md +++ b/_ru/scala3/book/tools-worksheets.md @@ -9,7 +9,7 @@ description: В этом разделе рассматриваются рабо language: ru num: 71 previous-page: tools-sbt -next-page: +next-page: interacting-with-java --- Worksheet - это файл Scala, который вычисляется при сохранении, From 5bb982dd2f2867e27333cd33755badc3cee83191 Mon Sep 17 00:00:00 2001 From: Artem Korsakov <artemkorsakov@mail.ru> Date: Mon, 4 Mar 2024 11:53:55 +0300 Subject: [PATCH 2814/3075] Update ru pages (#2988) --- .../concrete-parallel-collections.md | 93 +++++++++---------- _ru/scala3/book/fp-intro.md | 9 +- _ru/scala3/book/methods-main-methods.md | 77 ++++++++++----- _ru/scala3/book/types-others.md | 2 + _ru/scala3/guides/scaladoc/settings.md | 2 + _ru/tour/named-arguments.md | 31 +++++-- 6 files changed, 128 insertions(+), 86 deletions(-) diff --git a/_ru/overviews/parallel-collections/concrete-parallel-collections.md b/_ru/overviews/parallel-collections/concrete-parallel-collections.md index b6170ffe1d..1bda571a82 100644 --- a/_ru/overviews/parallel-collections/concrete-parallel-collections.md +++ b/_ru/overviews/parallel-collections/concrete-parallel-collections.md @@ -43,10 +43,10 @@ num: 2 [ParRange](https://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/parallel/immutable/ParRange.html) представляет собой упорядоченную последовательность элементов, отстоящих друг от друга на одинаковые промежутки. Параллельный диапазон создается подобно последовательному [Range](https://www.scala-lang.org/api/{{ site.scala-212-version }}/scala/collection/immutable/Range.html): - scala> 1 to 3 par + scala> (1 to 3).par res0: scala.collection.parallel.immutable.ParRange = ParRange(1, 2, 3) - scala> 15 to 5 by -2 par + scala> (15 to 5 by -2).par res1: scala.collection.parallel.immutable.ParRange = ParRange(15, 13, 11, 9, 7, 5) Подобно тому, как последовательные диапазоны не имеют строителей, параллельные диапазоны не имеют [компоновщиков]({{ site.baseurl }}/ru/overviews/parallel-collections/architecture.html). При создании отображения (mapping) элементов параллельного диапазона получается параллельный вектор. Последовательные и параллельные диапазоны могут эффективно преобразовываться друг в друга вызовами методов `seq` и `par`. @@ -72,7 +72,7 @@ num: 2 scala> val phs = scala.collection.parallel.immutable.ParHashSet(1 until 1000: _*) phs: scala.collection.parallel.immutable.ParHashSet[Int] = ParSet(645, 892, 69, 809, 629, 365, 138, 760, 101, 479,... - scala> phs map { x => x * x } sum + scala> phs.map(x => x * x).sum res0: Int = 332833500 [Компоновщики]({{ site.baseurl }}/overviews/parallel-collections/architecture.html) параллельных хэш-деревьев действуют аналогично компоновщикам хэш-таблиц, а именно предварительно распределяют элементы по блокам, а после этого параллельно составляют результирующее хэш-дерево, назначая обработку различных блоков разным процессорам, каждый из которых независимо собирает свое поддерево. @@ -88,19 +88,19 @@ num: 2 scala> while (numbers.nonEmpty) { | numbers foreach { case (num, sqrt) => - | val nsqrt = 0.5 * (sqrt + num / sqrt) - | numbers(num) = nsqrt - | if (math.abs(nsqrt - sqrt) < 0.01) { - | println(num, nsqrt) - | numbers.remove(num) - | } - | } - | } - (1.0,1.0) + | val nsqrt = 0.5 * (sqrt + num / sqrt) + | numbers(num) = nsqrt + | if (math.abs(nsqrt - sqrt) < 0.01) { + | println(num, nsqrt) + | numbers.remove(num) + | } + | } + | } + (1.0,1.0) (2.0,1.4142156862745097) (7.0,2.64576704419029) (4.0,2.0000000929222947) - ... + ... [Компоновщики]({{ site.baseurl }}/ru/overviews/parallel-collections/architecture.html) реализованы как `TrieMap`-- так как эта структура является многопоточной, при вызове метода трансформации создается только один компоновщик, разделяемый всеми процессорами. @@ -110,53 +110,52 @@ num: 2 Характеристики производительности последовательных типов (sequence types): -| | head | tail | apply | update| prepend | append | insert | -| -------- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | -| `ParArray` | C | L | C | C | L | L | L | -| `ParVector` | eC | eC | eC | eC | eC | eC | - | -| `ParRange` | C | C | C | - | - | - | - | +| | head | tail | apply | update | prepend | append | insert | +| ----------- | ---- | ---- | ----- | ------ | ------- | ------ | ------ | +| `ParArray` | C | L | C | C | L | L | L | +| `ParVector` | eC | eC | eC | eC | eC | eC | - | +| `ParRange` | C | C | C | - | - | - | - | Характеристики производительности множеств (set) и ассоциативных массивов (map): -| | lookup | add | remove | -| -------- | ---- | ---- | ---- | -| **неизменяемые** | | | | -| `ParHashSet`/`ParHashMap`| eC | eC | eC | -| **изменяемые** | | | | -| `ParHashSet`/`ParHashMap`| C | C | C | -| `ParTrieMap` | eC | eC | eC | - +| | lookup | add | remove | +| ------------------------- | ------ | --- | ------ | +| **неизменяемые** | | | | +| `ParHashSet`/`ParHashMap` | eC | eC | eC | +| **изменяемые** | | | | +| `ParHashSet`/`ParHashMap` | C | C | C | +| `ParTrieMap` | eC | eC | eC | ### Расшифровка Обозначения в двух представленных выше таблицах означают следующее: -| | | -| --- | ---- | -| **C** | Операция (быстрая) выполняется за постоянное время. | -| **eC** | Операция выполняется за фактически постоянное время, но только при соблюдении некоторых предположений, например о максимальной длине вектора или распределении хэш-кодов.| +| | | +| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| **C** | Операция (быстрая) выполняется за постоянное время. | +| **eC** | Операция выполняется за фактически постоянное время, но только при соблюдении некоторых предположений, например о максимальной длине вектора или распределении хэш-кодов. | | **aC** | Операция выполняется за амортизированное постоянное время. Некоторые вызовы операции могут выполняться медленнее, но при подсчете времени выполнения большого количества операций выходит, что в среднем на операцию требуется постоянное время. | -| **Log** | Операция занимает время, пропорциональное логарифму размера коллекции. | -| **L** | Операция линейна, то есть занимает время, пропорциональное размеру коллекции. | -| **-** | Операция не поддерживается. | +| **Log** | Операция занимает время, пропорциональное логарифму размера коллекции. | +| **L** | Операция линейна, то есть занимает время, пропорциональное размеру коллекции. | +| **-** | Операция не поддерживается. | Первая таблица трактует последовательные типы-- изменяемые и неизменяемые-- в контексте выполнения следующих операций: -| | | -| --- | ---- | -| **head** | Получение первого элемента последовательности. | -| **tail** | Получение новой последовательности, состоящей из всех элементов исходной, кроме первого. | -| **apply** | Индексирование. | -| **update** | Функциональное обновление (с помощью `updated`) для неизменяемых последовательностей, обновление с побочными действиями (с помощью `update`) для изменяемых. | -| **prepend**| Добавление элемента в начало последовательности. Для неизменяемых последовательностей создается новая последовательность, для изменяемых-- модифицируется существующая. | -| **append** | Добавление элемента в конец последовательности. Для неизменяемых последовательностей создается новая последовательность, для изменяемых-- модифицируется существующая. | -| **insert** | Вставка элемента в выбранную позицию последовательности. Поддерживается только изменяемыми последовательностями. | +| | | +| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **head** | Получение первого элемента последовательности. | +| **tail** | Получение новой последовательности, состоящей из всех элементов исходной, кроме первого. | +| **apply** | Индексирование. | +| **update** | Функциональное обновление (с помощью `updated`) для неизменяемых последовательностей, обновление с побочными действиями (с помощью `update`) для изменяемых. | +| **prepend** | Добавление элемента в начало последовательности. Для неизменяемых последовательностей создается новая последовательность, для изменяемых-- модифицируется существующая. | +| **append** | Добавление элемента в конец последовательности. Для неизменяемых последовательностей создается новая последовательность, для изменяемых-- модифицируется существующая. | +| **insert** | Вставка элемента в выбранную позицию последовательности. Поддерживается только изменяемыми последовательностями. | Вторая таблица рассматривает изменяемые и неизменяемые множества и ассоциативные массивы в контексте следующих операций: -| | | -| --- | ---- | +| | | +| ---------- | ---------------------------------------------------------------------------------------------- | | **lookup** | Проверка принадлежности элемента множеству, или получение значения, ассоциированного с ключом. | -| **add** | Добавление нового элемента во множество или новой пары ключ/значение в ассоциативный массив. | -| **remove** | Удаление элемента из множества или ключа из ассоциативного массива. | -| **min** | Минимальный элемент множества или минимальный ключ ассоциативного массива. | +| **add** | Добавление нового элемента во множество или новой пары ключ/значение в ассоциативный массив. | +| **remove** | Удаление элемента из множества или ключа из ассоциативного массива. | +| **min** | Минимальный элемент множества или минимальный ключ ассоциативного массива. | diff --git a/_ru/scala3/book/fp-intro.md b/_ru/scala3/book/fp-intro.md index a8a44521a2..5c9b3f5fad 100644 --- a/_ru/scala3/book/fp-intro.md +++ b/_ru/scala3/book/fp-intro.md @@ -12,16 +12,15 @@ previous-page: collections-summary next-page: fp-what-is-fp --- - -Scala позволяет писать код в стиле объектно-ориентированного программирования (ООП), -в стиле функционального программирования (ФП), а также в гибридном стиле, используя оба подхода в комбинации. -По словам [Martin Odersky](https://twitter.com/alexelcu/status/996408359514525696), +Scala позволяет писать код в стиле объектно-ориентированного программирования (ООП), +в стиле функционального программирования (ФП), а также в гибридном стиле, используя оба подхода в комбинации. +По словам Martin Odersky, сущность Scala — это слияние функционального и объектно-ориентированного программирования в типизированной среде: - Функции для логики - Объекты для модульности -В этой главе предполагается, что вы знакомы с ООП и менее знакомы с ФП, +В этой главе предполагается, что вы знакомы с ООП и менее знакомы с ФП, поэтому в ней представлено краткое введение в несколько основных концепций функционального программирования: - Что такое функциональное программирование? diff --git a/_ru/scala3/book/methods-main-methods.md b/_ru/scala3/book/methods-main-methods.md index 46844f6485..cd6342216a 100644 --- a/_ru/scala3/book/methods-main-methods.md +++ b/_ru/scala3/book/methods-main-methods.md @@ -14,7 +14,7 @@ next-page: methods-summary <h5>Написание однострочных программ <span class="tag tag-inline">только в Scala 3</span></h5> -Scala 3 предлагает следующий способ определения программ, которые можно вызывать из командной строки: +Scala 3 предлагает следующий способ определения программ, которые можно вызывать из командной строки: добавление аннотации `@main` к методу превращает его в точку входа исполняемой программы: {% tabs method_1 %} @@ -27,7 +27,7 @@ Scala 3 предлагает следующий способ определен {% endtab %} {% endtabs %} -Для запуска программы достаточно сохранить эту строку кода в файле с именем, например, _Hello.scala_ +Для запуска программы достаточно сохранить эту строку кода в файле с именем, например, _Hello.scala_ (имя файла необязательно должно совпадать с именем метода) и запустить с помощью `scala`: ```bash @@ -35,8 +35,8 @@ $ scala Hello.scala Hello, World ``` -Аннотированный метод `@main` может быть написан либо на верхнем уровне (как показано), -либо внутри статически доступного объекта. +Аннотированный метод `@main` может быть написан либо на верхнем уровне (как показано), +либо внутри статически доступного объекта. В любом случае имя программы - это имя метода без каких-либо префиксов объектов. Узнайте больше об аннотации `@main`, прочитав следующие разделы или посмотрев это видео: @@ -47,7 +47,7 @@ Hello, World ### Аргументы командной строки -Метод `@main` может обрабатывать аргументы командной строки с различными типами. +Метод `@main` может обрабатывать аргументы командной строки с различными типами. Например, данный метод `@main`, который принимает параметры `Int`, `String` и дополнительные строковые параметры: {% tabs method_2 %} @@ -78,15 +78,15 @@ $ scala happyBirthday 23 Lisa Peter Happy 23rd Birthday, Lisa and Peter! ``` -Как показано, метод `@main` может иметь произвольное количество параметров. -Для каждого типа параметра должен существовать [given экземпляр][given] -класса типа `scala.util.CommandLineParser.FromString`, который преобразует аргумент из `String` в требуемый тип параметра. -Также, как показано, список параметров основного метода может заканчиваться повторяющимся параметром типа `String*`, +Как показано, метод `@main` может иметь произвольное количество параметров. +Для каждого типа параметра должен существовать [given экземпляр][given] +класса типа `scala.util.CommandLineParser.FromString`, который преобразует аргумент из `String` в требуемый тип параметра. +Также, как показано, список параметров основного метода может заканчиваться повторяющимся параметром типа `String*`, который принимает все оставшиеся аргументы, указанные в командной строке. -Программа, реализованная с помощью метода `@main`, проверяет, -что в командной строке достаточно аргументов для заполнения всех параметров, -и что строки аргументов могут быть преобразованы в требуемые типы. +Программа, реализованная с помощью метода `@main`, проверяет, +что в командной строке достаточно аргументов для заполнения всех параметров, +и что строки аргументов могут быть преобразованы в требуемые типы. Если проверка завершается неудачей, программа завершается с сообщением об ошибке: ``` @@ -97,20 +97,47 @@ $ scala happyBirthday sixty Fred Illegal command line: java.lang.NumberFormatException: For input string: "sixty" ``` +## Пользовательские типы как параметры + +Как упоминалось выше, компилятор ищет заданный экземпляр класса типов `scala.util.CommandLineParser.FromString` +для типа аргумента. Например, предположим, что у вас есть собственный тип `Color`, +который вы хотите использовать в качестве параметра. +Вы можете сделать это, как показано ниже: + +{% tabs method_3 %} +{% tab 'Только в Scala 3' for=method_3 %} + +```scala +enum Color: + case Red, Green, Blue + +given ComamndLineParser.FromString[Color] with + def fromString(value: String): Color = Color.valueOf(value) + +@main def run(color: Color): Unit = + println(s"The color is ${color.toString}") +``` + +{% endtab %} +{% endtabs %} + +Это работает одинаково для ваших собственных пользовательских типов в вашей программе, +а также для типов, которые можно использовать из другой библиотеки. + ## Детали Компилятор Scala генерирует программу из `@main` метода `f` следующим образом: - он создает класс с именем `f` в пакете, где был найден метод `@main`. -- класс имеет статический метод `main` с обычной сигнатурой Java `main` метода: +- класс имеет статический метод `main` с обычной сигнатурой Java `main` метода: принимает `Array[String]` в качестве аргумента и возвращает `Unit`. -- сгенерированный `main` метод вызывает метод `f` с аргументами, +- сгенерированный `main` метод вызывает метод `f` с аргументами, преобразованными с помощью методов в объекте `scala.util.CommandLineParser.FromString`. Например, приведенный выше метод `happyBirthday` генерирует дополнительный код, эквивалентный следующему классу: -{% tabs method_3 %} -{% tab 'Только в Scala 3' for=method_3 %} +{% tabs method_4 %} +{% tab 'Только в Scala 3' for=method_4 %} ```scala final class happyBirthday { @@ -127,9 +154,9 @@ final class happyBirthday { } ``` -> Примечание: В этом сгенерированном коде модификатор `<static>` выражает, -> что `main` метод генерируется как статический метод класса `happyBirthday`. -> Эта функция недоступна для пользовательских программ в Scala. +> Примечание: В этом сгенерированном коде модификатор `<static>` выражает, +> что `main` метод генерируется как статический метод класса `happyBirthday`. +> Эта функция недоступна для пользовательских программ в Scala. > Вместо неё обычные “статические” члены генерируются в Scala с использованием `object`. {% endtab %} @@ -137,16 +164,16 @@ final class happyBirthday { ## Обратная совместимость со Scala 2 -`@main` методы — это рекомендуемый способ создания программ, вызываемых из командной строки в Scala 3. +`@main` методы — это рекомендуемый способ создания программ, вызываемых из командной строки в Scala 3. Они заменяют предыдущий подход, который заключался в создании `object`, расширяющего класс `App`: -Прежняя функциональность `App`, основанная на "волшебном" `DelayedInit trait`, больше недоступна. +Прежняя функциональность `App`, основанная на "волшебном" `DelayedInit trait`, больше недоступна. `App` все еще существует в ограниченной форме, но не поддерживает аргументы командной строки и будет объявлен устаревшим в будущем. -Если программам необходимо выполнять перекрестную сборку между Scala 2 и Scala 3, +Если программам необходимо выполнять перекрестную сборку между Scala 2 и Scala 3, вместо этого рекомендуется использовать `object` с явным методом `main` и одним аргументом `Array[String]`: -{% tabs method_4 %} +{% tabs method_5 %} {% tab 'Scala 2 и 3' %} ```scala @@ -159,13 +186,13 @@ object happyBirthday { } ``` -> обратите внимание, что здесь мы используем `:_*` для передачи переменного числа аргументов, +> обратите внимание, что здесь мы используем `:_*` для передачи переменного числа аргументов, > который остается в Scala 3 для обратной совместимости. {% endtab %} {% endtabs %} -Если вы поместите этот код в файл с именем _happyBirthday.scala_, то сможете скомпилировать его с `scalac` +Если вы поместите этот код в файл с именем _happyBirthday.scala_, то сможете скомпилировать его с `scalac` и запустить с помощью `scala`, как показывалось ранее: ```bash diff --git a/_ru/scala3/book/types-others.md b/_ru/scala3/book/types-others.md index 5f01514837..131bdd403b 100644 --- a/_ru/scala3/book/types-others.md +++ b/_ru/scala3/book/types-others.md @@ -24,5 +24,7 @@ versionSpecific: true - Вид полиморфизма Дополнительные сведения об этих типах см. в [Справочной документации Scala 3][reference]. +Для singleton типов см. раздел [literal types](https://scala-lang.org/files/archive/spec/3.4/03-types.html#literal-types) +спецификации Scala 3, а для уточненных типов — раздел [refined types](https://scala-lang.org/files/archive/spec/3.4/03-types.html). [reference]: {{ site.scala3ref }}/overview.html diff --git a/_ru/scala3/guides/scaladoc/settings.md b/_ru/scala3/guides/scaladoc/settings.md index c36dedb135..e8d68554c9 100644 --- a/_ru/scala3/guides/scaladoc/settings.md +++ b/_ru/scala3/guides/scaladoc/settings.md @@ -40,6 +40,8 @@ Compile / doc / scalacOptions ++= Seq("-project", "my-project"), ##### -project-logo Логотип проекта, который появляется в верхнем левом углу. +Для темной темы можно выделить отдельный логотип с суффиксом `_dark`. +Например, если есть логотип `mylogo.png`, то для темной темы предполагается `mylogo_dark.png`. Чтобы обеспечить совместимость с псевдонимами Scala2 с `-doc-logo` ##### -project-footer diff --git a/_ru/tour/named-arguments.md b/_ru/tour/named-arguments.md index 5b2376cf4b..da9202a051 100644 --- a/_ru/tour/named-arguments.md +++ b/_ru/tour/named-arguments.md @@ -17,27 +17,40 @@ prerequisite-knowledge: function-syntax ```scala mdoc def printName(first: String, last: String): Unit = - println(first + " " + last) + println(s"$first $last") -printName("John", "Smith") // выводит "John Smith" -printName(first = "John", last = "Smith") // выводит "John Smith" -printName(last = "Smith", first = "John") // выводит "John Smith" +printName("John", "Public") // выводит "John Public" +printName(first = "John", last = "Public") // выводит "John Public" +printName(last = "Public", first = "John") // выводит "John Public" +printName("Elton", last = "John") // выводит "Elton John" ``` {% endtab %} {% endtabs %} -Обратите внимание, что при указании имени параметра, порядок аргумента может быть изменен. -Однако если какие-то аргументы именованные, а другие нет, -то аргументы без имени должны стоять на первом месте и располагаться в том порядке, в котором описаны параметры метода. +Это полезно, когда два параметра имеют один и тот же тип и аргументы могут быть случайно перепутаны. + +Обратите внимание, что именованные аргументы могут быть указаны в любом порядке. +Однако, если аргументы расположены не в порядке параметров метода (читается слева направо), +остальные аргументы должны быть названы. + +В следующем примере именованные аргументы позволяют опустить параметр `middle`. +В случае ошибки, если первый аргумент не на своем месте, необходимо будет указать второй аргумент. {% tabs named-arguments-when-error %} {% tab 'Scala 2 и 3' for=named-arguments-when-error %} ```scala mdoc:fail -printName(last = "Smith", "john") // ошибка: позиция после именованного аргумента +def printFullName(first: String, middle: String = "Q.", last: String): Unit = + println(s"$first $middle $last") + +printFullName(first = "John", last = "Public") // выводит "John Q. Public" +printFullName("John", last = "Public") // выводит "John Q. Public" +printFullName("John", middle = "Quincy", "Public") // выводит "John Quincy Public" +printFullName(last = "Public", first = "John") // выводит "John Q. Public" +printFullName(last = "Public", "John") // ошибка: позиция после именованного аргумента ``` {% endtab %} @@ -45,4 +58,4 @@ printName(last = "Smith", "john") // ошибка: позиция после и {% endtabs %} Именованные аргументы работают при вызове Java методов, но только в том случае, -если используемая Java библиотека была скомпилирована с `-parameters`. +если используемая Java библиотека была скомпилирована с флагом `-parameters`. From 01450a1fd9d6311bcde335f897fd5c99b45c067f Mon Sep 17 00:00:00 2001 From: ali hong <hongtron@users.noreply.github.com> Date: Mon, 4 Mar 2024 03:23:05 -0600 Subject: [PATCH 2815/3075] Link out to wiki page for the concept of a "generator" (#2985) * Remove version-specific syntax description about expressing a list of enumerators * Replace 'filter' with 'guard' for consistency * Link to the book for clarification of generator and guard control structures * Clarify what a 'generator' is in a couple of spots * Update _tour/for-comprehensions.md --------- Co-authored-by: Ali Hong <alih@netflix.com> Co-authored-by: Jamie Thompson <bishbashboshjt@gmail.com> --- _overviews/scala3-book/control-structures.md | 2 +- _overviews/scala3-book/taste-control-structures.md | 3 ++- _tour/for-comprehensions.md | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index fe94b30dc1..6598cb6047 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -236,7 +236,7 @@ for i <- ints do println(i) {% endtabs %} -The code `i <- ints` is referred to as a _generator_. +The code `i <- ints` is referred to as a _generator_. In any generator `p <- e`, the expression `e` can generate zero or many bindings to the pattern `p`. This is what the result looks like in the Scala REPL: diff --git a/_overviews/scala3-book/taste-control-structures.md b/_overviews/scala3-book/taste-control-structures.md index 3427c29399..4b58abbf00 100644 --- a/_overviews/scala3-book/taste-control-structures.md +++ b/_overviews/scala3-book/taste-control-structures.md @@ -92,7 +92,8 @@ val ints = List(1, 2, 3, 4, 5) for (i <- ints) println(i) ``` -> The code `i <- ints` is referred to as a _generator_, and the code that follows the closing parentheses of the generator is the _body_ of the loop. +> The code `i <- ints` is referred to as a _generator_. In any generator `p <- e`, the expression `e` can generate zero or many bindings to the pattern `p`. +> The code that follows the closing parentheses of the generator is the _body_ of the loop. {% endtab %} diff --git a/_tour/for-comprehensions.md b/_tour/for-comprehensions.md index a211380230..a97758d8b3 100644 --- a/_tour/for-comprehensions.md +++ b/_tour/for-comprehensions.md @@ -12,7 +12,7 @@ redirect_from: - "/tutorials/tour/sequence-comprehensions.html" --- -Scala offers a lightweight notation for expressing _sequence comprehensions_. Comprehensions have the form `for (enumerators) yield e`, where `enumerators` refers to a semicolon-separated list of enumerators. An _enumerator_ is either a generator which introduces new variables, or it is a filter. A comprehension evaluates the body `e` for each binding generated by the enumerators and returns a sequence of these values. +Scala offers a lightweight notation for expressing _sequence comprehensions_. Comprehensions have the form `for (enumerators) yield e`, where `enumerators` refers to a list of enumerators. An _enumerator_ is either a generator, or it is a guard (see: [Control Structures](/scala3/book/control-structures.html#for-loops)). A comprehension evaluates the body `e` for each binding generated by the enumerators and returns a sequence of these values. Here's an example: From 9da6b0066b28315d0ea3aa4654015e655c7b18d4 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Tue, 5 Mar 2024 12:07:56 +0100 Subject: [PATCH 2816/3075] Add banner to warn about scams (#2993) --- _data/messages.yml | 1 + _includes/alert-banner.html | 8 +++++ _layouts/root-content-layout.html | 2 ++ _layouts/root-index-layout.html | 38 ++++++++++++------------ _sass/layout/header.scss | 17 +++++++++++ _sass/utils/_variables.scss | 4 +++ resources/js/functions.js | 49 +++++++++++++++++++++++-------- 7 files changed, 89 insertions(+), 30 deletions(-) create mode 100644 _data/messages.yml create mode 100644 _includes/alert-banner.html diff --git a/_data/messages.yml b/_data/messages.yml new file mode 100644 index 0000000000..642a7ac557 --- /dev/null +++ b/_data/messages.yml @@ -0,0 +1 @@ +scam-banner: "**⚠️ Beware of Scams**: since Feb 2024, scammers are using [fake Scala websites to sell courses](https://www.scala-lang.org/blog/2024/03/01/fake-scala-courses.html), please check you are using an official source." diff --git a/_includes/alert-banner.html b/_includes/alert-banner.html new file mode 100644 index 0000000000..405cbd8fb0 --- /dev/null +++ b/_includes/alert-banner.html @@ -0,0 +1,8 @@ +{% comment %}use the variable 'message' to include markdown text to display in the alert.{% endcomment %} + +<header id="site-header" class="header-home"> + <div class="new-on-the-blog alert-warning" data-message_id="{{include.message_id}}"> + <p>{{include.message|markdownify}}</p> + <span class="hide"><i class="fa fa-close"></i></span> + </div> +</header> diff --git a/_layouts/root-content-layout.html b/_layouts/root-content-layout.html index 1828666a99..f8d99b1427 100644 --- a/_layouts/root-content-layout.html +++ b/_layouts/root-content-layout.html @@ -3,6 +3,8 @@ <div class="navigation-fade-screen"></div> +{% include alert-banner.html message=site.data.messages.scam-banner message_id='scam-courses-feb-2024' %} + {% include navbar-inner.html %} <main id="inner-main"> diff --git a/_layouts/root-index-layout.html b/_layouts/root-index-layout.html index 97304053e1..baf0558d44 100644 --- a/_layouts/root-index-layout.html +++ b/_layouts/root-index-layout.html @@ -2,28 +2,30 @@ <div class="navigation-fade-screen"></div> +{% include alert-banner.html message=site.data.messages.scam-banner message_id='scam-courses-feb-2024' %} + {% include navbar-inner.html %} <main id="inner-main"> - <!-- Title --> - <section class="title-page"> - <div class="wrap"> - <div class="content-title-documentation"> - - <h1>{{page.title}}</h1> - <div class="search-container"> - <div class="icon-search"> - <i class="fa fa-search"></i> - </div> - <input type="text" class="doc-search" id="doc-search-bar" placeholder="Search in doc..."> - <ul class="result-container" id="result-container" style="display: none;"></ul> - </div> - </div> - </div> - </section> - - {% comment %}Specific content from child layouts{% endcomment %} {{content}} + <!-- Title --> + <section class="title-page"> + <div class="wrap"> + <div class="content-title-documentation"> + + <h1>{{page.title}}</h1> + <div class="search-container"> + <div class="icon-search"> + <i class="fa fa-search"></i> + </div> + <input type="text" class="doc-search" id="doc-search-bar" placeholder="Search in doc..."> + <ul class="result-container" id="result-container" style="display: none;"></ul> + </div> + </div> + </div> + </section> + + {% comment %}Specific content from child layouts{% endcomment %} {{content}} </main> diff --git a/_sass/layout/header.scss b/_sass/layout/header.scss index ab392dfd77..ff1b4fdb70 100755 --- a/_sass/layout/header.scss +++ b/_sass/layout/header.scss @@ -18,6 +18,23 @@ padding: 10px 40px; } + &.alert-warning { + background: $warning-bg; + color: $warning-text; + + a { + color: $warning-link; + font-weight: bold; + text-decoration: underline; + + &:active, + &:focus, + &:hover { + text-decoration: none; + } + } + } + span { position: absolute; right: 20px; diff --git a/_sass/utils/_variables.scss b/_sass/utils/_variables.scss index 630716433a..d018dbae37 100755 --- a/_sass/utils/_variables.scss +++ b/_sass/utils/_variables.scss @@ -18,6 +18,10 @@ $gray-light: #E5EAEA; $gray-lighter: #F0F3F3; $apple-blue: #6dccf5; +$warning-bg: #FFA500; +$warning-link: #185eb3; +$warning-text: #000; + //------------------------------------------------- $headings-font-color: $gray-dark; $base-font-color: #4A5659; diff --git a/resources/js/functions.js b/resources/js/functions.js index ccbf9753ac..686a38f47b 100644 --- a/resources/js/functions.js +++ b/resources/js/functions.js @@ -72,11 +72,6 @@ $(document).ready(function() { hljs.highlightAll(); }); -// Show Blog -$(".hide").click(function() { - $(".new-on-the-blog").hide(); -}); - // Documentation menu dropdown toggle $(document).ready(function() { // DOM ready // If a link has a dropdown, add sub menu toggle. @@ -435,9 +430,8 @@ $(document).ready(function() { * that when the page is refreshed, the same tab will be selected. * On page load, selects the tab corresponding to stored value. */ - function setupTabs(tabs, namespace, defaultValue) { - const PreferenceStorage = Storage('org.scala-lang.docs.preferences'); - const preferredValue = PreferenceStorage.getPreference(namespace, defaultValue); + function setupTabs(tabs, namespace, defaultValue, storage) { + const preferredValue = storage.getPreference(namespace, defaultValue); activateTab(tabs, preferredValue) @@ -448,7 +442,7 @@ $(document).ready(function() { const parent = $(this).parent(); const newValue = $(this).data('target'); - PreferenceStorage.setPreference(namespace, newValue, oldValue => { + storage.setPreference(namespace, newValue, _ => { // when we set a new scalaVersion, find scalaVersionTabs except current one // and activate those tabs. activateTab(tabs.not(parent), newValue); @@ -459,17 +453,48 @@ $(document).ready(function() { }); } - if (storageAvailable('localStorage')) { + function setupAlertCancel(alert, storage) { + const messageId = alert.data('message_id'); + let onHide = () => {}; + if (messageId) { + const key = `alert.${messageId}`; + const isHidden = storage.getPreference(key, 'show') === 'hidden'; + if (isHidden) { + alert.hide(); + } + onHide = () => storage.setPreference(key, 'hidden', _ => {}); + } + + + alert.find('.hide').click(function() { + alert.hide(), onHide(); + }); + } + + function setupAllTabs(storage) { var scalaVersionTabs = $(".tabsection.tabs-scala-version"); if (scalaVersionTabs.length) { - setupTabs(scalaVersionTabs, "scalaVersion", "scala-3"); + setupTabs(scalaVersionTabs, "scalaVersion", "scala-3", storage); } var buildToolTabs = $(".tabsection.tabs-build-tool"); if (buildToolTabs.length) { - setupTabs(buildToolTabs, "buildTool", "scala-cli"); + setupTabs(buildToolTabs, "buildTool", "scala-cli", storage); + } + } + + function setupAllAlertCancels(storage) { + var alertBanners = $(".new-on-the-blog.alert-warning"); + if (alertBanners.length) { + setupAlertCancel(alertBanners, storage); } } + if (storageAvailable('localStorage')) { + const PreferenceStorage = Storage('org.scala-lang.docs.preferences'); + setupAllTabs(PreferenceStorage); + setupAllAlertCancels(PreferenceStorage); + } + }); // OS detection From a667ac3f4384da37d5502cabdc232a6b55a79d82 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Thu, 7 Mar 2024 00:17:26 +0000 Subject: [PATCH 2817/3075] Update SIPs state --- _sips/sips/binary-api.md | 10 +++++----- _sips/sips/byname-implicits.md | 4 ++-- _sips/sips/clause-interleaving.md | 2 +- _sips/sips/fewer-braces.md | 4 ++-- _sips/sips/interpolation-quote-escape.md | 2 +- _sips/sips/match-types-spec.md | 4 ++-- _sips/sips/multi-source-extension-overloads.md | 2 +- _sips/sips/polymorphic-eta-expansion.md | 2 +- _sips/sips/priority-based-infix-type-precedence.md | 2 +- _sips/sips/quote-pattern-type-variable-syntax.md | 8 ++++---- _sips/sips/trait-parameters.md | 2 +- 11 files changed, 21 insertions(+), 21 deletions(-) diff --git a/_sips/sips/binary-api.md b/_sips/sips/binary-api.md index ba3fc8f010..8997304831 100644 --- a/_sips/sips/binary-api.md +++ b/_sips/sips/binary-api.md @@ -32,7 +32,7 @@ Currently, the compiler automatically generates accessors for references to priv * Changing the implementation of an inline definition can be a binary incompatible change * Removing final from a class is a binary incompatible change -You can find more details in [https://github.com/scala/scala3/issues/16983](https://github.com/scala/scala3/issues/16983) +You can find more details in [https://github.com/lampepfl/dotty/issues/16983](https://github.com/lampepfl/dotty/issues/16983) ### Avoid duplication of inline accessors @@ -248,7 +248,7 @@ Using references to `@publicInBinary` in inline code can cause binary incompatib ### Add a `@binaryAccessor` This annotation would generate an stable accessor. This annotation could be used on `private` definition. It would also mitigate [migration costs](https://gist.github.com/nicolasstucki/003f7293941836b08a0d53dbcb913e3c) for library authors that have published unstable accessors. -* Implementation https://github.com/scala/scala3/pull/16992 +* Implementation https://github.com/lampepfl/dotty/pull/16992 ### Make all `private[C]` part of the binary API @@ -267,9 +267,9 @@ The drawback of this approach is that that we would need to force users to keep ## Related work -* Initial discussions: [https://github.com/scala/scala3/issues/16983](https://github.com/scala/scala3/issues/16983) -* Initial proof of concept (outdated): [https://github.com/scala/scala3/pull/16992](https://github.com/scala/scala3/pull/16992) -* Single annotation proof of concept: [https://github.com/scala/scala3/pull/18402](https://github.com/scala/scala3/pull/18402) +* Initial discussions: [https://github.com/lampepfl/dotty/issues/16983](https://github.com/lampepfl/dotty/issues/16983) +* Initial proof of concept (outdated): [https://github.com/lampepfl/dotty/pull/16992](https://github.com/lampepfl/dotty/pull/16992) +* Single annotation proof of concept: [https://github.com/lampepfl/dotty/pull/18402](https://github.com/lampepfl/dotty/pull/18402) * Community migration analysis: [Gist](https://gist.github.com/nicolasstucki/003f7293941836b08a0d53dbcb913e3c) * Kotlin: [PublishedApi](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-published-api/) plays the same role as `@publicInBinary` but its interaction with (inline definitions)[https://kotlinlang.org/docs/inline-functions.html#restrictions-for-public-api-inline-functions] diff --git a/_sips/sips/byname-implicits.md b/_sips/sips/byname-implicits.md index b9a33eb455..4e47f9765c 100644 --- a/_sips/sips/byname-implicits.md +++ b/_sips/sips/byname-implicits.md @@ -39,7 +39,7 @@ the knot" implicitly. ### Implementation status -Byname implicits have been implemented in [Dotty](https://github.com/scala/scala3/issues/1998) +Byname implicits have been implemented in [Dotty](https://github.com/lampepfl/dotty/issues/1998) with an earlier iteration of the divergence checking algorithm described below. A full implementation of this proposal exists as a [pull request](https://github.com/scala/scala/pull/6050) relative to the 2.13.x branch of the Lightbend Scala compiler and it is scheduled to be included in @@ -851,7 +851,7 @@ object Test { because the path `foo` in `foo.Out` is not stable. Full parity with shapeless's `Lazy` would require lazy (rather than byname) implicit parameters (see [this Dotty -ticket](https://github.com/scala/scala3/issues/3005) for further discussion) and is orthogonal to +ticket](https://github.com/lampepfl/dotty/issues/3005) for further discussion) and is orthogonal to this SIP in that they would drop out of support for lazy parameters more generally, as described in [this Scala ticket](https://github.com/scala/bug/issues/240). diff --git a/_sips/sips/clause-interleaving.md b/_sips/sips/clause-interleaving.md index 65fb815f86..120271e8d0 100644 --- a/_sips/sips/clause-interleaving.md +++ b/_sips/sips/clause-interleaving.md @@ -167,7 +167,7 @@ As discussed above, we may want to consider generalizing class parameter lists a ## Related work * Pre-SIP: [https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525](https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525) -* An implementation of the proposal is available as a pull request at [https://github.com/scala/scala3/pull/14019](https://github.com/scala/scala3/pull/14019) +* An implementation of the proposal is available as a pull request at [https://github.com/lampepfl/dotty/pull/14019](https://github.com/lampepfl/dotty/pull/14019) ## FAQ Currently empty. diff --git a/_sips/sips/fewer-braces.md b/_sips/sips/fewer-braces.md index e6541ac4cb..4d1f9c1091 100644 --- a/_sips/sips/fewer-braces.md +++ b/_sips/sips/fewer-braces.md @@ -131,7 +131,7 @@ If there would be code using these idioms, it can be rewritten quite simply to a ### Tooling -Since this affects parsing, the scalameta parser and any other parser used in an IDE will also need to be updated. The necessary changes to the Scala 3 parser were made here: https://github.com/scala/scala3/pull/15273/commits. The commit that embodies the core change set is here: https://github.com/scala/scala3/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a. +Since this affects parsing, the scalameta parser and any other parser used in an IDE will also need to be updated. The necessary changes to the Scala 3 parser were made here: https://github.com/lampepfl/dotty/pull/15273/commits. The commit that embodies the core change set is here: https://github.com/lampepfl/dotty/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a. ### Handling Edge Cases @@ -288,7 +288,7 @@ This is a tradeoff between conciseness and consistency. In the interest of minim - Doc page for proposed change: https://dotty.epfl.ch/docs/reference/other-new-features/indentation.html#variant-indentation-marker--for-arguments - - Merged PR implementing the proposal under experimental flag: https://github.com/scala/scala3/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a + - Merged PR implementing the proposal under experimental flag: https://github.com/lampepfl/dotty/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a - Latest discussion on contributors (there were several before when we discussed indentation in general): https://contributors.scala-lang.org/t/make-fewerbraces-available-outside-snapshot-releases/5024/166 diff --git a/_sips/sips/interpolation-quote-escape.md b/_sips/sips/interpolation-quote-escape.md index 8385ed17a8..4639fc615f 100644 --- a/_sips/sips/interpolation-quote-escape.md +++ b/_sips/sips/interpolation-quote-escape.md @@ -129,4 +129,4 @@ proposals. [^4]: https://github.com/scala/bug/issues/6476#issuecomment-292412577 "@retronym said: +1 to s"$"". Because it doesn't compile today, we don't risk changing the meaning of existing programs." [^5]: https://github.com/Scala/Scala/pull/6953/files#diff-0023b3bfa053fb16603156b785efa7ad "" [^6]: https://github.com/Scala/Scala/pull/4308 "SI-6476 Accept escaped quotes in interp strings" -[^7]: https://github.com/scala/scala3/pull/7486 "PR in scala3" +[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" diff --git a/_sips/sips/match-types-spec.md b/_sips/sips/match-types-spec.md index a48500f506..1624e64cc5 100644 --- a/_sips/sips/match-types-spec.md +++ b/_sips/sips/match-types-spec.md @@ -95,7 +95,7 @@ It is however not possible to guarantee that property for *all* cases, since the #### Preamble Some of the concepts mentioned here are defined in the existing Scala 3 specification draft. -That draft can be found in the dotty repository at https://github.com/scala/scala3/tree/main/docs/_spec. +That draft can be found in the dotty repository at https://github.com/lampepfl/dotty/tree/main/docs/_spec. It is not rendered anywhere yet, though. Here are some of the relevant concepts that are perhaps lesser-known: @@ -573,7 +573,7 @@ Notable prior work related to this proposal includes: - [Current reference page for Scala 3 match types](https://dotty.epfl.ch/docs/reference/new-types/match-types.html) - [Abstractions for Type-Level Programming](https://infoscience.epfl.ch/record/294024), Olivier Blanvillain, Chapter 4 (Match Types) - ["Pre-Sip" discussion in the Contributors forum](https://contributors.scala-lang.org/t/pre-sip-proper-specification-for-match-types/6265) (submitted at the same time as this SIP document) -- [PR with the proposed implementation](https://github.com/scala/scala3/pull/18262) +- [PR with the proposed implementation](https://github.com/lampepfl/dotty/pull/18262) ## FAQ diff --git a/_sips/sips/multi-source-extension-overloads.md b/_sips/sips/multi-source-extension-overloads.md index ab41056aee..a8a0637a7a 100644 --- a/_sips/sips/multi-source-extension-overloads.md +++ b/_sips/sips/multi-source-extension-overloads.md @@ -226,7 +226,7 @@ A number of alternatives were mentioned in [the Contributors thread](https://con ## Related work - [Contributors thread acting as de facto Pre-SIP](https://contributors.scala-lang.org/t/change-shadowing-mechanism-of-extension-methods-for-on-par-implicit-class-behavior/5831) -- [Pull Request in dotty](https://github.com/scala/scala3/pull/17050) to support it under an experimental import +- [Pull Request in dotty](https://github.com/lampepfl/dotty/pull/17050) to support it under an experimental import ## FAQ diff --git a/_sips/sips/polymorphic-eta-expansion.md b/_sips/sips/polymorphic-eta-expansion.md index ce38bca4b1..bd64ea84bb 100644 --- a/_sips/sips/polymorphic-eta-expansion.md +++ b/_sips/sips/polymorphic-eta-expansion.md @@ -420,7 +420,7 @@ No other alternatives have been imagined, the similarity between this proposal a - If there is already a proof-of-concept implementation, a link to it will be welcome here. --> * Pre-SIP: https://contributors.scala-lang.org/t/polymorphic-eta-expansion/5516 -* A naive implementation can be found at https://github.com/scala/scala3/pull/14015 (it is more general than this proposal and thus breaks compatibility) +* A naive implementation can be found at https://github.com/lampepfl/dotty/pull/14015 (it is more general than this proposal and thus breaks compatibility) * A compatibility-preserving implementation is in development. diff --git a/_sips/sips/priority-based-infix-type-precedence.md b/_sips/sips/priority-based-infix-type-precedence.md index 2189130200..71d32c1ce7 100644 --- a/_sips/sips/priority-based-infix-type-precedence.md +++ b/_sips/sips/priority-based-infix-type-precedence.md @@ -137,7 +137,7 @@ However, it is very unlikely that such interaction would occur. **Related Issues** -* [Dotty Issue #1961](https://github.com/scala/scala3/issues/1961) +* [Dotty Issue #1961](https://github.com/lampepfl/dotty/issues/1961) ## Backward Compatibility diff --git a/_sips/sips/quote-pattern-type-variable-syntax.md b/_sips/sips/quote-pattern-type-variable-syntax.md index a6080d7a00..92d1ce83fa 100644 --- a/_sips/sips/quote-pattern-type-variable-syntax.md +++ b/_sips/sips/quote-pattern-type-variable-syntax.md @@ -59,11 +59,11 @@ We want to be able to set the bounds of type variables to be able to match again ```scala case '[ head *: tail ] => h[tail] ``` -See [https://github.com/scala/scala3/issues/11738](https://github.com/scala/scala3/issues/11738). +See [https://github.com/lampepfl/dotty/issues/11738](https://github.com/lampepfl/dotty/issues/11738). ### Support matching on any kind of type We want to match against higher-kinded (or `AnyKind`) types. This is not possible due to the default upper bound of `Any`. -See [https://github.com/scala/scala3/issues/10864](https://github.com/scala/scala3/issues/10864). +See [https://github.com/lampepfl/dotty/issues/10864](https://github.com/lampepfl/dotty/issues/10864). ### Support multiple references to the same type in quoted type patterns We want to be able to match using several references to the same type variable. @@ -135,7 +135,7 @@ TASTy only contains explicit type variable definitions, and this encoding would ## Related work -* Proof of concept of type variable syntax: [https://github.com/scala/scala3/pull/16910](https://github.com/scala/scala3/pull/16910) -* Proof of concept of backticks (only interested in the first bullet point): [https://github.com/scala/scala3/pull/16935](https://github.com/scala/scala3/pull/16935) +* Proof of concept of type variable syntax: [https://github.com/lampepfl/dotty/pull/16910](https://github.com/lampepfl/dotty/pull/16910) +* Proof of concept of backticks (only interested in the first bullet point): [https://github.com/lampepfl/dotty/pull/16935](https://github.com/lampepfl/dotty/pull/16935) <!-- ## FAQ --> diff --git a/_sips/sips/trait-parameters.md b/_sips/sips/trait-parameters.md index 633f0c0b73..93bcd8bf70 100644 --- a/_sips/sips/trait-parameters.md +++ b/_sips/sips/trait-parameters.md @@ -69,4 +69,4 @@ the evaluation order would be `e1`, initializer of `T`, `e2`, initializer of `V` ## See Also ## -[Dotty Issue #640](https://github.com/scala/scala3/issues/640) +[Dotty Issue #640](https://github.com/lampepfl/dotty/issues/640) From e6578795d2cdd335ce609640af41ed3c3ae4670d Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 9 Mar 2024 00:20:08 +0000 Subject: [PATCH 2818/3075] Update SIPs state --- _sips/sips/scala-3-macro-annotations.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/scala-3-macro-annotations.md diff --git a/_sips/sips/scala-3-macro-annotations.md b/_sips/sips/scala-3-macro-annotations.md new file mode 100644 index 0000000000..76f747aa77 --- /dev/null +++ b/_sips/sips/scala-3-macro-annotations.md @@ -0,0 +1,7 @@ +--- +title: SIP-63 - Scala 3 Macro Annotations +status: submitted +pull-request-number: 80 +stage: pre-sip + +--- From f89818fb6a03967a38cd252b5b3c63545696f472 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Wed, 13 Mar 2024 00:20:55 +0000 Subject: [PATCH 2819/3075] Update SIPs state --- .../sips/mprove-the-syntax-of-context-bounds-and-givens.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md diff --git a/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md b/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md new file mode 100644 index 0000000000..d9573cc33c --- /dev/null +++ b/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md @@ -0,0 +1,7 @@ +--- +title: 'SIP-64: Improve the Syntax of Context Bounds and Givens' +status: submitted +pull-request-number: 81 +stage: pre-sip + +--- From c0cf7e5fa7805e71da6e52dc725b3a599976a9cb Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 16 Mar 2024 00:20:08 +0000 Subject: [PATCH 2820/3075] Update SIPs state --- _sips/sips/alternative-bind-patterns.md | 7 +++++++ _sips/sips/for-comprehension-improvements.md | 4 ++-- .../sips/mprove-the-syntax-of-context-bounds-and-givens.md | 4 ++-- _sips/sips/multiple-assignments.md | 7 +++++++ _sips/sips/scala-3-macro-annotations.md | 4 ++-- 5 files changed, 20 insertions(+), 6 deletions(-) create mode 100644 _sips/sips/alternative-bind-patterns.md create mode 100644 _sips/sips/multiple-assignments.md diff --git a/_sips/sips/alternative-bind-patterns.md b/_sips/sips/alternative-bind-patterns.md new file mode 100644 index 0000000000..dd6b1fd861 --- /dev/null +++ b/_sips/sips/alternative-bind-patterns.md @@ -0,0 +1,7 @@ +--- +title: SIP-60 - Alternative bind patterns +status: waiting-for-implementation +pull-request-number: 74 +stage: implementation + +--- diff --git a/_sips/sips/for-comprehension-improvements.md b/_sips/sips/for-comprehension-improvements.md index e474776928..0676734fb6 100644 --- a/_sips/sips/for-comprehension-improvements.md +++ b/_sips/sips/for-comprehension-improvements.md @@ -1,7 +1,7 @@ --- title: SIP-62 - For comprehension improvements -status: submitted +status: under-review pull-request-number: 79 -stage: pre-sip +stage: design --- diff --git a/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md b/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md index d9573cc33c..f7c2914164 100644 --- a/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md +++ b/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md @@ -1,7 +1,7 @@ --- title: 'SIP-64: Improve the Syntax of Context Bounds and Givens' -status: submitted +status: under-review pull-request-number: 81 -stage: pre-sip +stage: design --- diff --git a/_sips/sips/multiple-assignments.md b/_sips/sips/multiple-assignments.md new file mode 100644 index 0000000000..0eb30e241d --- /dev/null +++ b/_sips/sips/multiple-assignments.md @@ -0,0 +1,7 @@ +--- +title: SIP-59 - Multiple assignments +status: waiting-for-implementation +pull-request-number: 73 +stage: implementation + +--- diff --git a/_sips/sips/scala-3-macro-annotations.md b/_sips/sips/scala-3-macro-annotations.md index 76f747aa77..497a56896e 100644 --- a/_sips/sips/scala-3-macro-annotations.md +++ b/_sips/sips/scala-3-macro-annotations.md @@ -1,7 +1,7 @@ --- title: SIP-63 - Scala 3 Macro Annotations -status: submitted +status: under-review pull-request-number: 80 -stage: pre-sip +stage: design --- From 9a1b72b946c19d895ca32c66f50b65a1aebe86be Mon Sep 17 00:00:00 2001 From: Daan Hoogenboezem <daniel.hoogenboezem@gmail.com> Date: Thu, 21 Mar 2024 11:03:40 +0100 Subject: [PATCH 2821/3075] Update methods-main-methods.md Squat typo in example. --- _overviews/scala3-book/methods-main-methods.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index b56fd5a2d9..797d7d04a4 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -100,7 +100,7 @@ use as a parameter. You would do this like you see below: enum Color: case Red, Green, Blue -given ComamndLineParser.FromString[Color] with +given CommandLineParser.FromString[Color] with def fromString(value: String): Color = Color.valueOf(value) @main def run(color: Color): Unit = From 970c849111ed8096e6a0a940ac8cc522700e16af Mon Sep 17 00:00:00 2001 From: Shane Gannon <sgannon200@gmail.com> Date: Thu, 21 Mar 2024 10:10:27 +0000 Subject: [PATCH 2822/3075] Update scala-for-java-programmers.md by adding a missing 'is' (#2996) * Update scala-for-java-programmers.md by adding a missing 'is' * Update scala-for-java-programmers.md Let's use the plural instead --- _overviews/tutorials/scala-for-java-programmers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index e6678ef729..bc4a551d91 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -384,7 +384,7 @@ Note that in order to print the string, we used the predefined method #### Anonymous functions In Scala, lambda expressions are known as anonymous functions. -They are useful when a function so short it is perhaps unneccesary +They are useful when functions are so short it is perhaps unneccesary to give them a name. Here is a revised version of the timer From c66731afa7015d0156da91e7dcca9f010dd5d8a4 Mon Sep 17 00:00:00 2001 From: muzucode <79173451+muzucode@users.noreply.github.com> Date: Sat, 23 Mar 2024 21:20:50 -0400 Subject: [PATCH 2823/3075] Update taste-modeling.md Add a comma. --- _overviews/scala3-book/taste-modeling.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/taste-modeling.md b/_overviews/scala3-book/taste-modeling.md index 2fe2f8e490..3e391d745a 100644 --- a/_overviews/scala3-book/taste-modeling.md +++ b/_overviews/scala3-book/taste-modeling.md @@ -164,7 +164,7 @@ If not, don’t worry, they’re explained in more detail in the [Domain Modelin ### Classes Scala _classes_ are used in OOP-style programming. -Here’s an example of a class that models a “person.” In OOP fields are typically mutable, so `firstName` and `lastName` are both declared as `var` parameters: +Here’s an example of a class that models a “person.” In OOP, fields are typically mutable, so `firstName` and `lastName` are both declared as `var` parameters: {% tabs class_1 class=tabs-scala-version %} {% tab 'Scala 2' for=class_1 %} From 31e3aac6229eafb6afbb70ed2e786e2bcb07ad33 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Miko=C5=82aj=20Fornal?= <24961583+Florian3k@users.noreply.github.com> Date: Fri, 29 Mar 2024 18:11:08 +0100 Subject: [PATCH 2824/3075] Add description for dynamic-side-menu scaladoc option (#2942) --- _overviews/scala3-scaladoc/settings.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index 9408e6d9ce..e5118ab430 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -172,7 +172,7 @@ Which means: - all snippets in files under directory `my/path/f` should fail during compilation - all other snippets should compile successfully -#### -scastie-configuration +##### -scastie-configuration Define the additional sbt configuration for your Scastie snippets. For example, when you import external libraries into your snippets, you need to add the related dependencies. @@ -180,6 +180,10 @@ Define the additional sbt configuration for your Scastie snippets. For example, "-scastie-configuration", """libraryDependencies += "org.apache.commons" % "commons-lang3" % "3.12.0"""" ``` +##### -dynamic-side-menu + +Generate the side menu (the tree-like overview of the project structure on the left-hand side) dynamically in the browser using JavaScript instead of embedding it in every HTML file. This can greatly reduce outputted HTML file sizes. Recommended for projects with 1000+ pages. For more info see [issue 18543](https://github.com/lampepfl/dotty/issues/18543). + ##### -Ysnippet-compiler-debug Setting this option makes snippet compiler print the snippet as it is compiled (after wrapping). From 9eda4b8c127ba89ada75469b40d8f8d7eb6b4e15 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= <pmarks@virtuslab.com> Date: Fri, 29 Mar 2024 10:11:33 -0700 Subject: [PATCH 2825/3075] Add api link to 3.4.1 (#3003) --- _config.yml | 2 +- api/all.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index 53d97b4c0c..94b3f38a1b 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.13 scala-212-version: 2.12.19 -scala-3-version: 3.4.0 +scala-3-version: 3.4.1 collections: style: diff --git a/api/all.md b/api/all.md index a1a31eb864..e545c8f1e6 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,8 @@ redirect_from: ## Latest releases -* Scala 3.4.0 - * [Library API](https://www.scala-lang.org/api/3.4.0/) +* Scala 3.4.1 + * [Library API](https://www.scala-lang.org/api/3.4.1/) * Scala 3.3.3 LTS * [Library API](https://www.scala-lang.org/api/3.3.3/) * Scala 2.13.13 @@ -64,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.4.0 + * [Library API](https://www.scala-lang.org/api/3.4.0/) * Scala 3.3.1 LTS * [Library API](https://www.scala-lang.org/api/3.3.1/) * Scala 3.3.0 LTS From d51de182e37be49a86b8031637c7ae9a53753d32 Mon Sep 17 00:00:00 2001 From: Octavia Togami <otogami@gradle.com> Date: Fri, 29 Mar 2024 17:14:38 -0700 Subject: [PATCH 2826/3075] Correct 2.13 Java 22 compatibility The Java 22 compatibility was only merged into 2.13.13. --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 2bd457a303..039117aaad 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| -| 22 (ea) | 3.3.4* | 2.13.12 | 2.12.19 | | +| 22 (ea) | 3.3.4* | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | | 11 (LTS) | 3.0.0 | 2.13.0 | 2.12.4 | 2.11.12 | From 48354bdbd5433fb24b9872e97cdbddebdb5a7ab4 Mon Sep 17 00:00:00 2001 From: Dongxu Wang <dongxu@apache.org> Date: Tue, 2 Apr 2024 15:49:31 +0800 Subject: [PATCH 2827/3075] Update mima#sbt link for binary-compatibility-for-library-authors.md --- .../tutorials/binary-compatibility-for-library-authors.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/tutorials/binary-compatibility-for-library-authors.md b/_overviews/tutorials/binary-compatibility-for-library-authors.md index a6d358ed14..c3fd5467a9 100644 --- a/_overviews/tutorials/binary-compatibility-for-library-authors.md +++ b/_overviews/tutorials/binary-compatibility-for-library-authors.md @@ -147,7 +147,7 @@ How can we, as library authors, spare our users of runtime errors and dependency It works by comparing the class files of two provided JARs and report any binary incompatibilities found. Both backwards and forwards binary incompatibility can be detected by swapping input order of the JARs. -By incorporating MiMa's [sbt plugin](https://github.com/lightbend/mima/wiki/sbt-plugin) into your sbt build, you can easily check whether +By incorporating MiMa's [sbt plugin](https://github.com/lightbend/mima#sbt) into your sbt build, you can easily check whether you have accidentally introduced binary incompatible changes. Detailed instruction on how to use the sbt plugin can be found in the link. We strongly encourage every library author to incorporate MiMa into their continuous integration and release workflow. From b9f96f89e14f9412f45400e479f51ed35a67b161 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Mon, 8 Apr 2024 17:34:19 -0700 Subject: [PATCH 2828/3075] JDK 22 is now in General Availability --- _overviews/jdk-compatibility/overview.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 2bd457a303..5cb5f3038c 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| -| 22 (ea) | 3.3.4* | 2.13.12 | 2.12.19 | | +| 22 | 3.3.4* | 2.13.12 | 2.12.19 | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | | 11 (LTS) | 3.0.0 | 2.13.0 | 2.12.4 | 2.11.12 | @@ -111,14 +111,15 @@ For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/j ## JDK 22 compatibility notes -Early access builds of JDK 22 are available. JDK 22 will be non-LTS. +JDK 22 is non-LTS. -Initial support for JDK 22 has been merged and is now available in -Scala 2.13.12 and 2.12.19. +Scala 2.13.12+ and 2.12.19+ support JDK 22. We are working on adding JDK 22 support to the 3.3.x release series. (Support may be available in nightly builds.) +For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. + ## GraalVM Native Image compatibility notes There are several records of successfully using Scala with [GraalVM](https://www.graalvm.org) Native Image (i.e., ahead of time compiler) to produce directly executable binaries. From 0c369b9665a3d34c612993f084c90ab132cbaaf7 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Mon, 8 Apr 2024 17:38:52 -0700 Subject: [PATCH 2829/3075] JDK compat page: add JDK 23 (early access) --- _overviews/jdk-compatibility/overview.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 5cb5f3038c..fc57746f2e 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,6 +14,7 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| +| 23 (ea) | 3.3.5* | 2.13.14* | 2.12.20* | | | 22 | 3.3.4* | 2.13.12 | 2.12.19 | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | @@ -120,6 +121,15 @@ series. (Support may be available in nightly builds.) For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. +## JDK 23 compatibility notes + +Early access builds of JDK 23 are available. JDK 23 will be non-LTS. + +We are working on adding JDK 22 support to Scala 3 and Scala 2. +(Support may be available in nightly builds.) + +For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. + ## GraalVM Native Image compatibility notes There are several records of successfully using Scala with [GraalVM](https://www.graalvm.org) Native Image (i.e., ahead of time compiler) to produce directly executable binaries. From 84ca624acda454563c24b2b80bc02332921ad126 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Tue, 9 Apr 2024 07:50:19 -0700 Subject: [PATCH 2830/3075] Update _overviews/jdk-compatibility/overview.md Co-authored-by: Philippus Baalman <philippus@gmail.com> --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index fc57746f2e..506a93722c 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -125,7 +125,7 @@ For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/j Early access builds of JDK 23 are available. JDK 23 will be non-LTS. -We are working on adding JDK 22 support to Scala 3 and Scala 2. +We are working on adding JDK 23 support to Scala 3 and Scala 2. (Support may be available in nightly builds.) For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. From 1cdfcf44f8138ff385e40a6b61543bdd84b5d3f7 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Tue, 9 Apr 2024 09:27:08 -0700 Subject: [PATCH 2831/3075] same fix farther down --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 039117aaad..80610b94ed 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -114,7 +114,7 @@ For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/j Early access builds of JDK 22 are available. JDK 22 will be non-LTS. Initial support for JDK 22 has been merged and is now available in -Scala 2.13.12 and 2.12.19. +Scala 2.13.13 and 2.12.19. We are working on adding JDK 22 support to the 3.3.x release series. (Support may be available in nightly builds.) From ee2309452359a8c420ca721889c3cda5ec3a1cc1 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Tue, 9 Apr 2024 14:35:46 -0700 Subject: [PATCH 2832/3075] JDK 23 support won't make 2.13.14 --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index eef0eafb74..8d8849cc79 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| -| 23 (ea) | 3.3.5* | 2.13.14* | 2.12.20* | | +| 23 (ea) | 3.3.5* | 2.13.15* | 2.12.20* | | | 22 | 3.3.4* | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | From bd08d2b585a67cd666031d2158d30f56a0d8d19d Mon Sep 17 00:00:00 2001 From: Martin Chiquillo <63934927+gojideth@users.noreply.github.com> Date: Sun, 14 Apr 2024 19:04:39 -0500 Subject: [PATCH 2833/3075] Update named-arguments.md --- _es/tour/named-arguments.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/_es/tour/named-arguments.md b/_es/tour/named-arguments.md index 38dd0574d4..c5ebdd7363 100644 --- a/_es/tour/named-arguments.md +++ b/_es/tour/named-arguments.md @@ -11,24 +11,23 @@ previous-page: default-parameter-values En la invocación de métodos y funciones se puede usar el nombre de las variables explícitamente en la llamada, de la siguiente manera: - def imprimirNombre(nombre:String, apellido:String) = { + def imprimirNombre(nombre: String, apellido: String) = { println(nombre + " " + apellido) } imprimirNombre("John","Smith") // Imprime "John Smith" - imprimirNombre(first = "John",last = "Smith") + imprimirNombre(nombre = "John", apellido = "Smith") // Imprime "John Smith" - imprimirNombre(last = "Smith",first = "John") // Imprime "John Smith" Note que una vez que se utilizan parámetros nombrados en la llamada, el orden no importa, mientras todos los parámetros sean nombrados. Esta característica funciona bien en conjunción con valores de parámetros por defecto: - def imprimirNombre(nombre:String = "John", apellido:String = "Smith") = { + def imprimirNombre(nombre: String = "John", apellido: String = "Smith") = { println(nombre + " " + apellido) } - printName(apellido = "Jones") + imprimirNombre(apellido = "Jones") // Imprime "John Jones" language: es From ab5d7dc18aaa4db1f59c296346aceb1b6d94349e Mon Sep 17 00:00:00 2001 From: Martin Chiquillo <63934927+gojideth@users.noreply.github.com> Date: Sun, 14 Apr 2024 19:05:01 -0500 Subject: [PATCH 2834/3075] Updated method name --- _es/tour/named-arguments.md | 1 + 1 file changed, 1 insertion(+) diff --git a/_es/tour/named-arguments.md b/_es/tour/named-arguments.md index c5ebdd7363..fe38fe15d4 100644 --- a/_es/tour/named-arguments.md +++ b/_es/tour/named-arguments.md @@ -19,6 +19,7 @@ En la invocación de métodos y funciones se puede usar el nombre de las variabl // Imprime "John Smith" imprimirNombre(nombre = "John", apellido = "Smith") // Imprime "John Smith" + imprimirNombre(apellido = "Smith", nombre = "John") // Imprime "John Smith" Note que una vez que se utilizan parámetros nombrados en la llamada, el orden no importa, mientras todos los parámetros sean nombrados. Esta característica funciona bien en conjunción con valores de parámetros por defecto: From 4e77a6122352eb3cf706b4ab8dcf7c4d19de28c9 Mon Sep 17 00:00:00 2001 From: Martin Chiquillo <63934927+gojideth@users.noreply.github.com> Date: Sun, 14 Apr 2024 19:14:40 -0500 Subject: [PATCH 2835/3075] Update unified-types.md --- _es/tour/unified-types.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_es/tour/unified-types.md b/_es/tour/unified-types.md index 5f37f7b47d..3a1db1e651 100644 --- a/_es/tour/unified-types.md +++ b/_es/tour/unified-types.md @@ -17,7 +17,7 @@ A diferencia de Java, todos los valores en Scala son objetos (incluyendo valores ## Jerarquía de clases en Scala ## La superclase de todas las clases, `scala.Any`, tiene dos subclases directas, `scala.AnyVal` y `scala.AnyRef` que representan dos mundos de clases muy distintos: clases para valores y clases para referencias. Todas las clases para valores están predefinidas; se corresponden con los tipos primitivos de los lenguajes tipo Java. Todas las otras clases definen tipos referenciables. Las clases definidas por el usuario son definidas como tipos referenciables por defecto, es decir, siempre (indirectamente) extienden de `scala.AnyRef`. Toda clase definida por usuario en Scala extiende implicitamente el trait `scala.ScalaObject`. Clases pertenecientes a la infraestructura en la cual Scala esté corriendo (ejemplo, el ambiente de ejecución de Java) no extienden de `scala.ScalaObject`. Si Scala es usado en el contexto de un ambiente de ejecución de Java, entonces `scala.AnyRef` corresponde a `java.lang.Object`. -Por favor note que el diagrama superior también muestra conversiones implícitas llamadas viestas entre las clases para valores. +Por favor note que el diagrama superior también muestra conversiones implícitas llamadas vistas entre las clases para valores. Aquí se muestra un ejemplo que demuestra que tanto valores numéricos, de caracteres, buleanos y funciones son objetos, tal como cualquier otro objeto: From 401a09197a302d6dbc2defc9cd0d0378119ff83e Mon Sep 17 00:00:00 2001 From: kavskavs <165838614+kavskavs@users.noreply.github.com> Date: Wed, 17 Apr 2024 07:51:10 +0530 Subject: [PATCH 2836/3075] Update trait-iterable.md foldRight uses starting value as z. --- _overviews/collections-2.13/trait-iterable.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/trait-iterable.md b/_overviews/collections-2.13/trait-iterable.md index 3cf0410289..21b28e2282 100644 --- a/_overviews/collections-2.13/trait-iterable.md +++ b/_overviews/collections-2.13/trait-iterable.md @@ -133,7 +133,7 @@ res7: List[Int] = List(3, 4, 5) | `xs.count(p)` |The number of elements in `xs` that satisfy the predicate `p`.| | **Folds:** | | | `xs.foldLeft(z)(op)` |Apply binary operation `op` between successive elements of `xs`, going left to right and starting with `z`.| -| `xs.foldRight(z)(op)` |Apply binary operation `op` between successive elements of `xs`, going right to left and ending with `z`.| +| `xs.foldRight(z)(op)` |Apply binary operation `op` between successive elements of `xs`, going right to left and starting with `z`.| | `xs.reduceLeft(op)` |Apply binary operation `op` between successive elements of non-empty collection `xs`, going left to right.| | `xs.reduceRight(op)` |Apply binary operation `op` between successive elements of non-empty collection `xs`, going right to left.| | **Specific Folds:** | | From 50d11cb83f8a3beede38788a5d6a0b1c51ec110a Mon Sep 17 00:00:00 2001 From: Roberto Tyley <roberto.tyley@theguardian.com> Date: Thu, 18 Apr 2024 11:51:18 +0100 Subject: [PATCH 2837/3075] Update docs for `-release` to make it clear it accepts recent Java versions The old displayed values of `6, 7, 8, 9` are confusing for developers contemplating updating to recent Java versions like `21` - eg from https://github.com/guardian/mobile-save-for-later/pull/109/files#r1559390842 : > I was getting an error that -release:21 is not a valid compiler option when I ran the code. Looking at the docs: https://docs.scala-lang.org/overviews/compiler-options/ my understanding is that this is not supported for Java 21. That's wrong, as newer Java versions definitely are supported by the `-release` Scala compiler parameter - so it's best to clarify that! --- _data/compiler-options.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_data/compiler-options.yml b/_data/compiler-options.yml index 0490b25127..04b3471933 100644 --- a/_data/compiler-options.yml +++ b/_data/compiler-options.yml @@ -260,7 +260,7 @@ type: "String" arg: "release" default: - description: "Compile for a specific version of the Java platform. Supported targets: 6, 7, 8, 9" + description: "Compile for a specific version of the Java platform. Supported targets: 8, 11, or any higher version listed at https://docs.scala-lang.org/overviews/jdk-compatibility/overview.html" abbreviations: - "--release" - option: "-sourcepath" From 15f6e82e176952d881804b032768fd12c5827556 Mon Sep 17 00:00:00 2001 From: yixinyi <xinyitsenlin@gmail.com> Date: Fri, 19 Apr 2024 12:55:29 -0400 Subject: [PATCH 2838/3075] Update inline.md (#3006) Added missing val and removed type ascription as other examples don't have it. --- _overviews/scala3-macros/tutorial/inline.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/inline.md b/_overviews/scala3-macros/tutorial/inline.md index 79ce94e4ba..0fe620f162 100644 --- a/_overviews/scala3-macros/tutorial/inline.md +++ b/_overviews/scala3-macros/tutorial/inline.md @@ -404,7 +404,8 @@ Let us assume a call to `logged` on a concrete instance of `PrintLogger`: ```scala logged(new PrintLogger, "🥧") // inlined as -val logger: PrintLogger = new PrintLogger +val logger = new PrintLogger +val x = "🥧" logger.log(x) ``` After inlining, the call to `log` is de-virtualized and known to be on `PrintLogger`. From cc111ca2a2509e01911bd2d715f3f0ad66036aa6 Mon Sep 17 00:00:00 2001 From: Som Snytt <som.snytt@gmail.com> Date: Sat, 9 Mar 2024 18:32:11 -0800 Subject: [PATCH 2839/3075] Explain -Xsource-features --- .../tooling-scala2-xsource3.md | 44 +++++++++++++------ 1 file changed, 30 insertions(+), 14 deletions(-) diff --git a/_overviews/scala3-migration/tooling-scala2-xsource3.md b/_overviews/scala3-migration/tooling-scala2-xsource3.md index 42171c23dc..03a1b47dcb 100644 --- a/_overviews/scala3-migration/tooling-scala2-xsource3.md +++ b/_overviews/scala3-migration/tooling-scala2-xsource3.md @@ -21,18 +21,24 @@ With Scala 2.13.13 and newer, the `-Xsource:3` flag comes in two variants: - `Xsource:3` enables warnings relevant for migrating a codebase to Scala 3. In addition to new warnings, the flag enables certain benign Scala 3 syntaxes such as `import p.*`. - - `Xsource:3-cross` is useful for projects that cross-build between Scala 2 and 3 for a longer period of time. - For certain language constructs that trigger a warning with `-Xsource:3`, the behavior changes to match Scala 3. + - `Xsource:3-cross` is useful for projects that cross-build between Scala 2 and 3. + It is intended to reduce the maintenance burden of a cross-built project over time. + Certain language constructs have been backported from Scala 3 in order to improve compatibility. + Instead of warning about a behavior change in Scala 3, it adopts the new behavior. + These features can be selectively enabled using `-Xsource-features` (since 2.13.14). Details about individual warnings are listed below on this page. -## Fatal warnings and quick fixes +## Warnings as errors, and quick fixes -By default, Scala 3 migration warnings emitted by Scala 2.13 are fatal, i.e., they are reported as errors. -This can be changed using `-Wconf`, for example `-Wconf:cat=scala3-migration:w` changes them to be reported as warnings. -Alternatively, `-Xmigration` has the same effect. +By default, Scala 3 migration warnings emitted by Scala 2.13 are reported as errors, +using the default configuration, `-Wconf:cat=scala3-migration:e`. +That ensures that migration messaging is more visible. +Diagnostics can be emitted as warnings by specifying `-Wconf:cat=scala3-migration:w`. +Typically, emitting warnings instead of errors will cause more diagnostics to be reported. -The [`@nowarn` annotation](https://www.scala-lang.org/api/current/scala/annotation/nowarn.html) can be used to suppress individual warnings, which also works with fatal warnings enabled. +The [`@nowarn` annotation](https://www.scala-lang.org/api/current/scala/annotation/nowarn.html) can be used in program sources to suppress individual warnings. +Diagnostics are suppressed before they are promoted to errors, so that `@nowarn` takes precedence over `-Wconf` and `-Werror`. The Scala 2.13 compiler implements quick fixes for many Scala 3 migration warnings. Quick fixes are displayed in Metals-based IDEs (not yet in IntelliJ), and they can be applied directly to the source code using the `-quickfix` flag, for example `-quickfix:cat=scala3-migration`. @@ -81,19 +87,29 @@ class B extends A { def f = "hi" } It is possible to work around this using version-dependent source files, see [scala/scala-xml#675](https://github.com/scala/scala-xml/pull/675) as an example. -Working around the case companion `FunctionN` parent change is currently difficult (Scala 2.13.13), a solution is being discussed at [scala/bug#12961](https://github.com/scala/bug/issues/12961). +Working around the case companion `FunctionN` parent change is difficult in Scala 2.13.13. + +From Scala 2.13.14, binary incompatible features can be selectively enabled under `-Xsource-features`, where the features can be enumerated. ### Changes in language semantics The following table shows cases where `-Xsource:3-cross` adopts language feature semantics from Scala 3. +Optionally, they can be selected using `-Xsource-features`. +`-Xsource:3-cross` is a shorthand for `-Xsource:3 -Xsource-features:_`. +However, since the scope of available features may expand in future versions, +it is recommended to either specify them explicitly or fix them to the grouped features `-Xsource-features:v2.13.13` or `-Xsource-features:v2.13.14`. -| Feature | `-Xsource:3` | `-Xsource:3-cross` | +| `-Xsource-features` | `-Xsource:3` | `-Xsource:3-cross` | |--- |--- |--- | -| `(x: Any) + ""` is deprecated | deprecation warning | does not compile, implicit `any2stringadd` is not inferred | -| Unicode escapes in triple-quoted strings and raw interpolations (`"""\u0061"""`) | fatal warning, escape is processed | escape is not processed | -| Leading infix operators continue the previous line <sup>1</sup> | fatal warning, second line is a separate expression | operation continues the previous line | -| Desugaring of string interpolators using `StringContext` | fatal warning if the interpolation references a `StringContext` in scope different from `scala.StringContext` | desugaring always uses `scala.StringContext` | -| An implicit for type `p.A` is found in the package prefix `p` | fatal warning | the package prefix `p` is no longer part of the implicit search scope | +| `(x: Any) + ""` is deprecated (`any2stringadd`) | deprecation warning | does not compile, implicit `any2stringadd` is not inferred | +| Unicode escapes in triple-quoted strings and raw interpolations (`"""\u0061"""`) (`unicode-escapes-raw`) | fatal warning, escape is processed | escape is not processed | +| Leading infix operators continue the previous line <sup>1</sup> (`leading-infix`) | fatal warning, second line is a separate expression | operation continues the previous line | +| Desugaring of string interpolators using `StringContext` (`string-context-scope`) | fatal warning if the interpolation references a `StringContext` in scope different from `scala.StringContext` | desugaring always uses `scala.StringContext` | +| An implicit for type `p.A` is found in the package prefix `p` (`package-prefix-implicits`) | fatal warning | the package prefix `p` is no longer part of the implicit search scope | +| (`implicit-resolution`) | fatal warning | use Scala-3-style downwards comparisons for implicit search and overloading resolution | +| (`case-apply-copy-access`) | warning | constructor modifiers are used for apply / copy methods of case classes | +| (`case-companion-function`) | warning | synthetic case companion objects no longer extend FunctionN | +| (`infer-override`) | warning | inferred type of member uses type of overridden member | Example 1: From 874642244f3e264e08e84754ee794d683ca63456 Mon Sep 17 00:00:00 2001 From: Som Snytt <som.snytt@gmail.com> Date: Fri, 19 Apr 2024 11:52:32 -0700 Subject: [PATCH 2840/3075] More feature words, C.apply adaptation --- _overviews/scala3-migration/tooling-scala2-xsource3.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_overviews/scala3-migration/tooling-scala2-xsource3.md b/_overviews/scala3-migration/tooling-scala2-xsource3.md index 03a1b47dcb..5498ea9ce0 100644 --- a/_overviews/scala3-migration/tooling-scala2-xsource3.md +++ b/_overviews/scala3-migration/tooling-scala2-xsource3.md @@ -106,10 +106,10 @@ it is recommended to either specify them explicitly or fix them to the grouped f | Leading infix operators continue the previous line <sup>1</sup> (`leading-infix`) | fatal warning, second line is a separate expression | operation continues the previous line | | Desugaring of string interpolators using `StringContext` (`string-context-scope`) | fatal warning if the interpolation references a `StringContext` in scope different from `scala.StringContext` | desugaring always uses `scala.StringContext` | | An implicit for type `p.A` is found in the package prefix `p` (`package-prefix-implicits`) | fatal warning | the package prefix `p` is no longer part of the implicit search scope | -| (`implicit-resolution`) | fatal warning | use Scala-3-style downwards comparisons for implicit search and overloading resolution | -| (`case-apply-copy-access`) | warning | constructor modifiers are used for apply / copy methods of case classes | -| (`case-companion-function`) | warning | synthetic case companion objects no longer extend FunctionN | -| (`infer-override`) | warning | inferred type of member uses type of overridden member | +| Specificity during implicit search (`implicit-resolution`) | fatal warning | use Scala-3-style downwards comparisons for implicit search and overloading resolution | +| Modifiers of synthetic methods (`case-apply-copy-access`) | fatal warning | constructor modifiers are used for apply / copy methods of case classes | +| Companions are Functions (`case-companion-function`) | fatal warning at use site | synthetic case companion objects no longer extend FunctionN, but are adapted at use site with warning | +| Override type inference (`infer-override`) | fatal warning | inferred type of member uses type of overridden member | Example 1: From 609e47360ea1b7a63931e2ac5c1602405ca8b38c Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 20 Apr 2024 00:21:16 +0000 Subject: [PATCH 2841/3075] Update SIPs state --- _sips/sips/binary-api.md | 3 ++- _sips/sips/quote-pattern-type-variable-syntax.md | 8 ++++++-- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/_sips/sips/binary-api.md b/_sips/sips/binary-api.md index 8997304831..2e532ffc3f 100644 --- a/_sips/sips/binary-api.md +++ b/_sips/sips/binary-api.md @@ -2,7 +2,7 @@ layout: sip permalink: /sips/:title.html stage: implementation -status: waiting-for-implementation +status: under-review title: SIP-52 - Binary APIs --- @@ -16,6 +16,7 @@ title: SIP-52 - Binary APIs | Aug 16 2023 | Single Annotation | | Aug 24 2023 | Change Annotation Name | | Jan 09 2024 | Change Overload Rules | +| Feb 29 2024 | Experimental in [Scala 3.4.0](https://www.scala-lang.org/blog/2024/02/29/scala-3.4.0-and-3.3.3-released.html) | ## Summary diff --git a/_sips/sips/quote-pattern-type-variable-syntax.md b/_sips/sips/quote-pattern-type-variable-syntax.md index 92d1ce83fa..f8a624f971 100644 --- a/_sips/sips/quote-pattern-type-variable-syntax.md +++ b/_sips/sips/quote-pattern-type-variable-syntax.md @@ -1,8 +1,8 @@ --- layout: sip permalink: /sips/:title.html -stage: implementation -status: waiting-for-implementation +stage: completed +status: shipped title: SIP-53 - Quote pattern explicit type variable syntax --- @@ -13,6 +13,8 @@ title: SIP-53 - Quote pattern explicit type variable syntax | Date | Version | |---------------|--------------------| | Feb 28th 2022 | Initial Draft | +| Oct 6th 2022 | [Stabilize implementation](https://github.com/scala/scala3/pull/18574) | +| Feb 29th 2023 | Available in [Scala 3.4.0](https://www.scala-lang.org/blog/2024/02/29/scala-3.4.0-and-3.3.3-released.html) | ## Summary @@ -137,5 +139,7 @@ TASTy only contains explicit type variable definitions, and this encoding would * Proof of concept of type variable syntax: [https://github.com/lampepfl/dotty/pull/16910](https://github.com/lampepfl/dotty/pull/16910) * Proof of concept of backticks (only interested in the first bullet point): [https://github.com/lampepfl/dotty/pull/16935](https://github.com/lampepfl/dotty/pull/16935) +* Implementation: [https://github.com/scala/scala3/pull/17362](https://github.com/scala/scala3/pull/17362) +* Stabilized implementation: [https://github.com/scala/scala3/pull/18574](https://github.com/scala/scala3/pull/18574) <!-- ## FAQ --> From 23e24e843a49629977c4b88f330469c1eaf118ca Mon Sep 17 00:00:00 2001 From: Aleksander Rainko <aleksander.rainko99@gmail.com> Date: Sun, 21 Apr 2024 02:25:01 +0200 Subject: [PATCH 2842/3075] Add `Matching function expressions` It seems like no one on the internet knows how to do this properly, so after drunkenly stumbling upon the correct syntax I decided to throw this small section together. --- _overviews/scala3-macros/tutorial/quotes.md | 62 ++++++++++++++++++++- 1 file changed, 61 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/quotes.md b/_overviews/scala3-macros/tutorial/quotes.md index be34958958..904e4b8599 100644 --- a/_overviews/scala3-macros/tutorial/quotes.md +++ b/_overviews/scala3-macros/tutorial/quotes.md @@ -245,7 +245,67 @@ case ... ### Matching function expressions -*Coming soon* +Let's start with the most straightforward example, matching an identity function expression: + +```scala +def matchIdentityFunction[A: Type](func: Expr[A => A])(using Quotes): Unit = + func match + case '{ (arg: A) => arg } => +``` +The above matches function expressions that just return their arguments, like: + +```scala +(value: Int) => value +``` + +We can also match more complex expressions, like method call chains: + +```scala +def matchMethodCallChain(func: Expr[String => String])(using Quotes) = + func match + case '{ (arg: String) => arg.toLowerCase.strip.trim } => +``` + +But what about the cases where we want more flexibility (eg. we know the subset of methods that will be called but not neccessarily their order)? + +#### Iterative deconstruction of a function expression + +Let's imagine we need a macro that collects names of methods used in an expression of type `FieldName => FieldName`, for a definition of `FieldName` that looks like this: + +```scala +trait FieldName: + def uppercase: FieldName + def lowercase: FieldName +``` + +The implementation itself would look like this: + +```scala +def collectUsedMethods(func: Expr[FieldName => FieldName])(using Quotes): List[String] = + def recurse(current: Expr[FieldName => FieldName], acc: List[String])(using Quotes): List[String] = + current match + // $body is the next tree with the '.lowercase' call stripped away + case '{ (arg: FieldName) => ($body(arg): FieldName).lowercase } => + recurse(body, "lowercase" :: acc) // body: Expr[FieldName => FieldName] + + // $body is the next tree with the '.uppercase' call stripped away + case '{ (arg: FieldName) => ($body(arg): FieldName).uppercase } => + recurse(body, "uppercase" :: acc) // body: Expr[FieldName => FieldName] + + // this matches an identity function, i.e. the end of our loop + case '{ (arg: FieldName) => arg } => acc + end recurse + + recurse(func, Nil) +``` + +For more details on how patterns like `$body(arg)` work please refer to docs section on [the HOAS pattern](https://dotty.epfl.ch/docs/reference/metaprogramming/macros.html#hoas-patterns-1). + +If we were to use this on an expression like this one: +```scala +(name: FieldName) => name.lowercase.uppercase.lowercase +``` +the result would evaluate to `List("lowercase", "uppercase", "lowercase")`. ### Matching types From 21cfaebcf1265c2c87e5800c0ec9fccebc509323 Mon Sep 17 00:00:00 2001 From: Aleksander Rainko <aleksander.rainko99@gmail.com> Date: Sun, 21 Apr 2024 02:32:00 +0200 Subject: [PATCH 2843/3075] less repetition, add a missing 'a' --- _overviews/scala3-macros/tutorial/quotes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-macros/tutorial/quotes.md b/_overviews/scala3-macros/tutorial/quotes.md index 904e4b8599..c8f662605d 100644 --- a/_overviews/scala3-macros/tutorial/quotes.md +++ b/_overviews/scala3-macros/tutorial/quotes.md @@ -270,7 +270,7 @@ But what about the cases where we want more flexibility (eg. we know the subset #### Iterative deconstruction of a function expression -Let's imagine we need a macro that collects names of methods used in an expression of type `FieldName => FieldName`, for a definition of `FieldName` that looks like this: +Let's imagine we need a macro that collects names of methods used in an expression of type `FieldName => FieldName`, for a definition of `FieldName`: ```scala trait FieldName: @@ -299,7 +299,7 @@ def collectUsedMethods(func: Expr[FieldName => FieldName])(using Quotes): List[S recurse(func, Nil) ``` -For more details on how patterns like `$body(arg)` work please refer to docs section on [the HOAS pattern](https://dotty.epfl.ch/docs/reference/metaprogramming/macros.html#hoas-patterns-1). +For more details on how patterns like `$body(arg)` work please refer to a docs section on [the HOAS pattern](https://dotty.epfl.ch/docs/reference/metaprogramming/macros.html#hoas-patterns-1). If we were to use this on an expression like this one: ```scala From 27b65eccb342c9675428bd43f4b77891a9bf2d6d Mon Sep 17 00:00:00 2001 From: Lukas Rytz <lukas.rytz@gmail.com> Date: Mon, 22 Apr 2024 11:26:29 +0200 Subject: [PATCH 2844/3075] more adjustments to Xsource-features --- .../tooling-scala2-xsource3.md | 113 ++++++++++-------- 1 file changed, 65 insertions(+), 48 deletions(-) diff --git a/_overviews/scala3-migration/tooling-scala2-xsource3.md b/_overviews/scala3-migration/tooling-scala2-xsource3.md index 5498ea9ce0..63ecbb6e8b 100644 --- a/_overviews/scala3-migration/tooling-scala2-xsource3.md +++ b/_overviews/scala3-migration/tooling-scala2-xsource3.md @@ -11,29 +11,22 @@ The Scala 2.13 compiler issues helpful migration warnings with the `-Xsource:3` Before moving to the Scala 3 compiler, it's recommended to enable this flag in Scala 2 and address the new warnings. -There is also a variant, `-Xsource:3-cross`; see below. **Note: Enabling `-Xsource:3-cross` in Scala 2.13.13 breaks binary compatibility, follow [scala/bug#12961](https://github.com/scala/bug/issues/12961) for details.** - -This page explains the details behind the flags. An overview is shown using `scalac -Xsource:help`. +Usage information is shown with `scalac -Xsource:help`. ## Migration vs cross-building -With Scala 2.13.13 and newer, the `-Xsource:3` flag comes in two variants: +With Scala 2.13.14 and newer, the `-Xsource:3` flag supports two scenarios: - `Xsource:3` enables warnings relevant for migrating a codebase to Scala 3. In addition to new warnings, the flag enables certain benign Scala 3 syntaxes such as `import p.*`. - - `Xsource:3-cross` is useful for projects that cross-build between Scala 2 and 3. - It is intended to reduce the maintenance burden of a cross-built project over time. + - Adding the `-Xsource-features:<features>` flag is useful to reduce the maintenance burden of projects that cross-build between Scala 2 and 3. Certain language constructs have been backported from Scala 3 in order to improve compatibility. Instead of warning about a behavior change in Scala 3, it adopts the new behavior. - These features can be selectively enabled using `-Xsource-features` (since 2.13.14). - -Details about individual warnings are listed below on this page. ## Warnings as errors, and quick fixes -By default, Scala 3 migration warnings emitted by Scala 2.13 are reported as errors, -using the default configuration, `-Wconf:cat=scala3-migration:e`. -That ensures that migration messaging is more visible. +By default, Scala 3 migration warnings emitted by Scala 2.13 are reported as errors, using the default configuration, `-Wconf:cat=scala3-migration:e`. +This ensures that migration messaging is more visible. Diagnostics can be emitted as warnings by specifying `-Wconf:cat=scala3-migration:w`. Typically, emitting warnings instead of errors will cause more diagnostics to be reported. @@ -41,8 +34,8 @@ The [`@nowarn` annotation](https://www.scala-lang.org/api/current/scala/annotati Diagnostics are suppressed before they are promoted to errors, so that `@nowarn` takes precedence over `-Wconf` and `-Werror`. The Scala 2.13 compiler implements quick fixes for many Scala 3 migration warnings. -Quick fixes are displayed in Metals-based IDEs (not yet in IntelliJ), and they can be applied directly to the source code using the `-quickfix` flag, for example `-quickfix:cat=scala3-migration`. -See also `scalac -quickfix:help`. +Quick fixes are displayed in Metals-based IDEs (not yet in IntelliJ), or they can be applied directly to the source code using the `-quickfix` flag, for example `-quickfix:cat=scala3-migration`. +See also `scala -quickfix:help`. ## Enabled Scala 3 syntax @@ -57,64 +50,88 @@ The `-Xsource:3` flag enables the following Scala 3 syntaxes in Scala 2: ## Scala 3 migration warnings in detail -Many Scala 3 migration warnings are easy to understand and identical under `-Xsource:3` and `-Xsource:3-cross`, e.g., for implicit definitions without an explicit type: +Many Scala 3 migration warnings are easy to understand, e.g., for implicit definitions without an explicit type: -{% highlight text %} +{% highlight scala %} scala> object O { implicit val s = "" } ^ error: Implicit definition must have explicit type (inferred String) [quickfixable] {% endhighlight %} -The next paragraphs explain where the behavior changes between `-Xsource:3` and `-Xsource:3-cross`. +## Enabling Scala 3 features with `-Xsource-features` -### Changes affecting binary encoding +Certain Scala 3 language changes have been backported and can be enabled using `-Xsource-features`; usage and available features are shown with `-Xsource-features:help`. -As of Scala 2.13.13, there are 3 changes under `-Xsource:3-cross` that affect binary encoding of classfiles. For all of these changes a fatal warning is issued under `-Xsource:3`. +When enabling a feature, the corresponding migration warning is no longer issued. - 1. The constructor modifiers of case classes (`case class C private[p] (x: Int)`) are copied to the synthetic `apply` and `copy` methods. - 1. The synthetic companion objects of case classes no longer extend `FunctionN`. - 1. Overriding methods without an explicit return type inherit the return type from the parent (instead of using the inferred type of the method body). +{% highlight scala %} +scala> raw"\u0061" + ^ + warning: Unicode escapes in raw interpolations are deprecated; use literal characters instead +val res0: String = a -For projects that are already cross-building between Scala 2 and Scala 3 with existing releases for both, enabling `-Xsource:3-cross` breaks binary compatibility. For example, if a library defines +scala> :setting -Xsource:3 -{% highlight scala %} -trait A { def f: Object } -class B extends A { def f = "hi" } -{% endhighlight %} +scala> raw"\u0061" + ^ + error: Unicode escapes in raw interpolations are ignored in Scala 3 (or with -Xsource-features:unicode-escapes-raw); use literal characters instead + Scala 3 migration messages are errors under -Xsource:3. Use -Wconf / @nowarn to filter them or add -Xmigration to demote them to warnings. + Applicable -Wconf / @nowarn filters for this fatal warning: msg=<part of the message>, cat=scala3-migration, site=res1 - - enabling `-Xsource:3-cross` breaks binary compatibility on Scala 2.13: existing releases have `A.f: String`, the new version will have `A.f: Object` - - adding an explicit result type `A.f: String` breaks binary compatibility on Scala 3: existing releases have `A.f: Object` +scala> :setting -Xsource-features:unicode-escapes-raw -It is possible to work around this using version-dependent source files, see [scala/scala-xml#675](https://github.com/scala/scala-xml/pull/675) as an example. +scala> raw"\u0061" +val res1: String = \u0061 +{% endhighlight %} -Working around the case companion `FunctionN` parent change is difficult in Scala 2.13.13. +For every such language feature, a migration warning is issued under plain `-Xsource:3`. +Enabling the feature silences the warning and adopts the changed behavior. +To avoid silent language changes when upgrading to a new Scala 2.13 version, it is recommended to enable features explicitly or use a group (e.g., `-Xsource-features:v2.13.14`). -From Scala 2.13.14, binary incompatible features can be selectively enabled under `-Xsource-features`, where the features can be enumerated. +`-Xsource:3-cross` is a shorthand for `-Xsource:3 -Xsource-features:_`. ### Changes in language semantics -The following table shows cases where `-Xsource:3-cross` adopts language feature semantics from Scala 3. -Optionally, they can be selected using `-Xsource-features`. -`-Xsource:3-cross` is a shorthand for `-Xsource:3 -Xsource-features:_`. -However, since the scope of available features may expand in future versions, -it is recommended to either specify them explicitly or fix them to the grouped features `-Xsource-features:v2.13.13` or `-Xsource-features:v2.13.14`. +The following table shows backported Scala 3 language semantics available in `-Xsource-features` / `-Xsource:3-cross`. -| `-Xsource-features` | `-Xsource:3` | `-Xsource:3-cross` | +| Feature flag | `-Xsource:3` behavior | `-Xsource-features` / `-Xsource:3-cross` behavior | |--- |--- |--- | -| `(x: Any) + ""` is deprecated (`any2stringadd`) | deprecation warning | does not compile, implicit `any2stringadd` is not inferred | -| Unicode escapes in triple-quoted strings and raw interpolations (`"""\u0061"""`) (`unicode-escapes-raw`) | fatal warning, escape is processed | escape is not processed | -| Leading infix operators continue the previous line <sup>1</sup> (`leading-infix`) | fatal warning, second line is a separate expression | operation continues the previous line | -| Desugaring of string interpolators using `StringContext` (`string-context-scope`) | fatal warning if the interpolation references a `StringContext` in scope different from `scala.StringContext` | desugaring always uses `scala.StringContext` | -| An implicit for type `p.A` is found in the package prefix `p` (`package-prefix-implicits`) | fatal warning | the package prefix `p` is no longer part of the implicit search scope | -| Specificity during implicit search (`implicit-resolution`) | fatal warning | use Scala-3-style downwards comparisons for implicit search and overloading resolution | -| Modifiers of synthetic methods (`case-apply-copy-access`) | fatal warning | constructor modifiers are used for apply / copy methods of case classes | -| Companions are Functions (`case-companion-function`) | fatal warning at use site | synthetic case companion objects no longer extend FunctionN, but are adapted at use site with warning | -| Override type inference (`infer-override`) | fatal warning | inferred type of member uses type of overridden member | +| `any2stringadd`: `(x: Any) + ""` is deprecated | deprecation warning | does not compile, implicit `any2stringadd` is not inferred | +| `unicode-escapes-raw`: unicode escapes in triple-quoted strings and raw interpolations (`"""\u0061"""`) | fatal warning, escape is processed | escape is not processed | +| `leading-infix`: leading infix operators continue the previous line <sup>1</sup> | fatal warning, second line is a separate expression | operation continues the previous line | +| `string-context-scope`: desugaring of string interpolators using `StringContext` | fatal warning if the interpolation references a `StringContext` in scope different from `scala.StringContext` | desugaring always uses `scala.StringContext` | +| `package-prefix-implicits`: an implicit for type `p.A` is found in the package prefix `p` | fatal warning | the package prefix `p` is no longer part of the implicit search scope | +| `implicit-resolution`: specificity during implicit search | fatal warning | use Scala-3-style [downwards comparisons](https://github.com/scala/scala/pull/6037) for implicit search and overloading resolution | +| `case-apply-copy-access`: modifiers of synthetic methods | fatal warning | constructor modifiers are used for apply / copy methods of case classes | +| `case-companion-function`: companions are Functions | fatal warning at use site | synthetic case companion objects no longer extend FunctionN, but are adapted at use site with warning | +| `infer-override`: override type inference | fatal warning | inferred type of member uses type of overridden member | Example 1: -{% highlight text %} +{% highlight scala %} def f = 1 + 2 {% endhighlight %} + +### Changes affecting binary encoding + +As of Scala 2.13.14, there are 3 changes in `-Xsource-features` that affect binary encoding of classfiles: + + 1. `case-apply-copy-access`: the constructor modifiers of case classes (`case class C private[p] (x: Int)`) are copied to the synthetic `apply` and `copy` methods. + 1. `case-companion-function`: the synthetic companion objects of case classes no longer extend `FunctionN`. + 1. `infer-override`: overriding methods without an explicit return type inherit the return type from the parent (instead of using the inferred type of the method body). + +For projects that are already cross-building between Scala 2 and 3 with existing releases for both, enabling these changes breaks binary compatibility (make sure to use [MiMa to detect such changes](https://github.com/lightbend/mima)). For example, if a library defines + +{% highlight scala %} +trait A { def f: Object } +class B extends A { def f = "hi" } +{% endhighlight %} + + - enabling `-Xsource-features:infer-override` breaks binary compatibility on Scala 2.13: existing releases have `A.f: String`, the new version will have `A.f: Object` + - adding an explicit result type `A.f: String` breaks binary compatibility on Scala 3: existing releases have `A.f: Object` + +It is possible to work around this using version-dependent source files, see [scala/scala-xml#675](https://github.com/scala/scala-xml/pull/675) as an example. + +Instead of implementing such workarounds, it might be easier not to enable changes affecting binary encoding (`-Xsource-features:v2.13.14,-case-apply-copy-access,-case-companion-function,-infer-override`). From f767949807feba8b2ba4cab2fdbd442df1f9bbff Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 1 May 2024 14:27:16 -0700 Subject: [PATCH 2845/3075] Scala 2.13.14 (#3011) --- _config.yml | 2 +- _overviews/FAQ/index.md | 6 +++--- _overviews/contribute/bug-reporting-guide.md | 2 +- api/all.md | 12 ++++++++---- scripts/run-mdoc.sh | 4 ++-- 5 files changed, 15 insertions(+), 11 deletions(-) diff --git a/_config.yml b/_config.yml index 94b3f38a1b..e4a2ffeb7b 100644 --- a/_config.yml +++ b/_config.yml @@ -15,7 +15,7 @@ keywords: - Document - Guide -scala-version: 2.13.13 +scala-version: 2.13.14 scala-212-version: 2.12.19 scala-3-version: 3.4.1 diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index d9d6b66d2d..00f52f41ac 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -120,7 +120,7 @@ with only minor supplements. That's why `versionString` and `versionNumberString` report that Scala 2 is in use: ``` -Welcome to Scala 3.3.2 (17.0.3, Java OpenJDK 64-Bit Server VM). +Welcome to Scala 3.3.3 (17.0.3, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. scala> util.Properties.versionNumberString @@ -332,14 +332,14 @@ setting in a multi-project build. For example, if you add this to your `build.sbt`: - scalaVersion := "2.13.13" + scalaVersion := "2.13.14" that's a "bare" setting, and you might expect it to apply build-wide. But it doesn't. _It only applies to the root project._ In many cases one should instead write: - ThisBuild / scalaVersion := "2.13.13" + ThisBuild / scalaVersion := "2.13.14" Other possibilities include: diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 303fd51d1a..c7bc2636dc 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -65,7 +65,7 @@ If you cannot find your issue in the issue tracker, create a new bug. The detail Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - 1. **Exact Scala version** that you are using. For example, `2.13.13` or `3.3.2`. If the bug happens in multiple versions indicate all of them. + 1. **Exact Scala version** that you are using. For example, `2.13.14` or `3.3.3`. If the bug happens in multiple versions indicate all of them. 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? diff --git a/api/all.md b/api/all.md index e545c8f1e6..262c0779a0 100644 --- a/api/all.md +++ b/api/all.md @@ -12,10 +12,10 @@ redirect_from: * [Library API](https://www.scala-lang.org/api/3.4.1/) * Scala 3.3.3 LTS * [Library API](https://www.scala-lang.org/api/3.3.3/) -* Scala 2.13.13 - * [Library API](https://www.scala-lang.org/api/2.13.13/) - * [Compiler API](https://www.scala-lang.org/api/2.13.13/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.13.13/scala-reflect/scala/reflect/) +* Scala 2.13.14 + * [Library API](https://www.scala-lang.org/api/2.13.14/) + * [Compiler API](https://www.scala-lang.org/api/2.13.14/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.14/scala-reflect/scala/reflect/) * Scala 2.12.19 * [Library API](https://www.scala-lang.org/api/2.12.19/) * [Compiler API](https://www.scala-lang.org/api/2.12.19/scala-compiler/scala/) @@ -90,6 +90,10 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.0.1/) * Scala 3.0.0 * [Library API](https://www.scala-lang.org/api/3.0.0/) +* Scala 2.13.13 + * [Library API](https://www.scala-lang.org/api/2.13.13/) + * [Compiler API](https://www.scala-lang.org/api/2.13.13/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.13/scala-reflect/scala/reflect/) * Scala 2.13.12 * [Library API](https://www.scala-lang.org/api/2.13.12/) * [Compiler API](https://www.scala-lang.org/api/2.13.12/scala-compiler/scala/) diff --git a/scripts/run-mdoc.sh b/scripts/run-mdoc.sh index 616960e771..4f3a7da6ea 100755 --- a/scripts/run-mdoc.sh +++ b/scripts/run-mdoc.sh @@ -1,11 +1,11 @@ #!/bin/bash set -eux -cs launch --scala-version 2.13.13 org.scalameta::mdoc:2.3.3 -- \ +cs launch --scala-version 2.13.14 org.scalameta::mdoc:2.3.3 -- \ --in . \ --out /tmp/mdoc-out/ \ --classpath \ - $(cs fetch --scala-version 2.13.13 -p \ + $(cs fetch --scala-version 2.13.14 -p \ com.chuusai::shapeless:2.3.10 \ org.scala-lang::toolkit:0.1.7 \ org.scala-lang::toolkit-test:0.1.7 \ From a3ddf2fdc94c76981eb4befbba434cc9f030295a Mon Sep 17 00:00:00 2001 From: Lukas Rytz <lukas.rytz@gmail.com> Date: Tue, 7 May 2024 17:33:43 +0200 Subject: [PATCH 2846/3075] Updates to the page on binary compatibility --- .../binary-compatibility-of-scala-releases.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/_overviews/core/binary-compatibility-of-scala-releases.md b/_overviews/core/binary-compatibility-of-scala-releases.md index 6e7135c3f6..ebe205403c 100644 --- a/_overviews/core/binary-compatibility-of-scala-releases.md +++ b/_overviews/core/binary-compatibility-of-scala-releases.md @@ -15,28 +15,25 @@ Note that for Scala.js and Scala Native, binary compatibility issues result in e They happen during their respective "linking" phases: `{fast,full}LinkJS` for Scala.js and `nativeLink` for Scala Native. #### Forward and Back -We distinguish forward and backward compatibility (think of these as properties of a sequence of versions, not of an individual version). Maintaining backwards compatibility means code compiled on an older version will link with code compiled with newer ones. Forward compatibility allows you to compile on new versions and run on older ones. +We distinguish forward and backward compatibility (think of these as properties of a sequence of versions, not of an individual version). Maintaining backward compatibility means code compiled on an older version will link with code compiled with newer ones. Forward compatibility allows you to compile on new versions and run on older ones. -Thus, backwards compatibility precludes the removal of (non-private) methods, as older versions could call them, not knowing they would be removed, whereas forwards compatibility disallows adding new (non-private) methods, because newer programs may come to depend on them, which would prevent them from running on older versions (private methods are exempted here as well, as their definition and call sites must be in the same compilation unit). +Thus, backward compatibility precludes the removal of (non-private) methods, as older versions could call them, not knowing they would be removed, whereas forward compatibility disallows adding new (non-private) methods, because newer programs may come to depend on them, which would prevent them from running on older versions (private methods are exempted here as well, as their definition and call sites must be in the same source file). #### Guarantees and Versioning For Scala 2, the *minor* version is the *third* number in a version, e.g., 10 in v2.13.10. The major version is the second number, which is 13 in our example. -Scala 2 guarantees both backward and forward compatibility across *minor* releases within a single major release. - -These are strict constraints, but they have worked well for us since Scala 2.10.x. -They didn't stop us from fixing large numbers of issues in minor releases. -So far, that policy is still applicable for Scala 2, although [there exists a proposal to remove the forward compatibility guarantee](https://docs.scala-lang.org/sips/drop-stdlib-forwards-bin-compat.html). +Scala 2 up to 2.13.14 guarantees both backward and forward compatibility across *minor* releases within a single major release. +This is about to change now that [SIP-51 has been accepted](https://docs.scala-lang.org/sips/drop-stdlib-forwards-bin-compat.html), future Scala 2.13 releases may be backward compatible only. For Scala 3, the minor version is the *second* number in a version, e.g., 2 in v3.2.1. The third number is the *patch* version. The major version is always 3. -Scala 3 guarantees both backward and forward compatibility across *patch* releases within a single minor release. -In particular, this applies within an entire [Long-Term-Support (LTS) series](https://www.scala-lang.org/blog/2022/08/17/long-term-compatibility-plans.html) (which will start with Scala 3.3.x). +Scala 3 guarantees both backward and forward compatibility across *patch* releases within a single minor release (enforcing forward binary compatibility is helpful to maintain source compatibility). +In particular, this applies within an entire [Long-Term-Support (LTS) series](https://www.scala-lang.org/blog/2022/08/17/long-term-compatibility-plans.html) such as Scala 3.3.x. -It also guarantees *backward* compatibility across *minor* releases in the entire 3.x series, but not forward compatibility. +Scala 3 also guarantees *backward* compatibility across *minor* releases in the entire 3.x series, but not forward compatibility. This means that libraries compiled with any Scala 3.x version can be used in projects compiled with any Scala 3.y version with y >= x. In addition, Scala 3.x provides backward binary compatibility with respect to Scala 2.13.y. @@ -72,8 +69,8 @@ At this point, you are likely going to run into bugs. Please report issues you find to its issue tracker. #### Concretely -We guarantee forwards and backwards compatibility of the `"org.scala-lang" % "scala-library" % "2.N.x"` and `"org.scala-lang" % "scala-reflect" % "2.N.x"` artifacts, except for -- the `scala.reflect.internal` and `scala.reflect.io` packages, as scala-reflect is still experimental, and +We guarantee backward compatibility of the `"org.scala-lang" % "scala-library" % "2.N.x"` and `"org.scala-lang" % "scala-reflect" % "2.N.x"` artifacts, except for +- the `scala.reflect.internal` and `scala.reflect.io` packages, as scala-reflect is experimental, and - the `scala.runtime` package, which contains classes used by generated code at runtime. We also strongly discourage relying on the stability of `scala.concurrent.impl`, `scala.sys.process.*Impl`, and `scala.reflect.runtime`, though we will only break compatibility for severe bugs here. @@ -83,4 +80,7 @@ Forward compatibility is only guaranteed for `3.N.y` within a given `N`. We enforce *backward* (but not forward) binary compatibility for *modules* (artifacts under the groupId `org.scala-lang.modules`). As they are opt-in, it's less of a burden to require having the latest version on the classpath. (Without forward compatibility, the latest version of the artifact must be on the run-time classpath to avoid linkage errors.) -Finally, from Scala 2.11 until Scala 2.13.0-M1, `scala-library-all` aggregates all modules that constitute a Scala release. Note that this means it does not provide forward binary compatibility, whereas the core `scala-library` artifact does. We consider the versions of the modules that `"scala-library-all" % "2.N.x"` depends on to be the canonical ones, that are part of the official Scala distribution. (The distribution itself is defined by the `scala-dist` maven artifact.) +#### Build Tools +Build tools like sbt and mill have assumptions about backward binary compatibility built in. +They build a graph of a project's dependencies and select the most recent versions that are needed. +To learn more, see the page on [library dependencies](https://www.scala-sbt.org/1.x/docs/Library-Dependencies.html) in the sbt documentation. From 60514be13f4c6dec3512c4ba4166df0bb24ed06c Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 8 May 2024 00:19:27 -0700 Subject: [PATCH 2847/3075] Toolkit tutorials: update Scala version (#3014) --- _includes/_markdown/install-munit.md | 4 ++-- _includes/_markdown/install-os-lib.md | 4 ++-- _includes/_markdown/install-sttp.md | 4 ++-- _includes/_markdown/install-upickle.md | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/_includes/_markdown/install-munit.md b/_includes/_markdown/install-munit.md index 8b39dd0c0d..246716a112 100644 --- a/_includes/_markdown/install-munit.md +++ b/_includes/_markdown/install-munit.md @@ -18,7 +18,7 @@ In your build.sbt file, you can add the dependency on toolkit-test: ```scala lazy val example = project.in(file("example")) .settings( - scalaVersion := "3.2.2", + scalaVersion := "3.3.3", libraryDependencies += "org.scala-lang" %% "toolkit-test" % "0.1.7" % Test ) ``` @@ -33,7 +33,7 @@ libraryDependencies += "org.scalameta" %% "munit" % "1.0.0-M7" % Test In your build.sc file, you can add a `test` object extending `Tests` and `TestModule.Munit`: ```scala object example extends ScalaModule { - def scalaVersion = "3.2.2" + def scalaVersion = "3.3.3" object test extends Tests with TestModule.Munit { def ivyDeps = Agg( diff --git a/_includes/_markdown/install-os-lib.md b/_includes/_markdown/install-os-lib.md index 2eed875fd5..28bd2ae5e6 100644 --- a/_includes/_markdown/install-os-lib.md +++ b/_includes/_markdown/install-os-lib.md @@ -17,7 +17,7 @@ In your `build.sbt`, you can add a dependency on the toolkit: ```scala lazy val example = project.in(file("example")) .settings( - scalaVersion := "3.2.2", + scalaVersion := "3.3.3", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" ) ``` @@ -30,7 +30,7 @@ libraryDependencies += "com.lihaoyi" %% "os-lib" % "0.9.1" In your `build.sc` file, you can add a dependency on the Toolkit: ```scala object example extends ScalaModule { - def scalaVersion = "3.2.2" + def scalaVersion = "3.3.3" def ivyDeps = Agg( ivy"org.scala-lang::toolkit:0.1.7" diff --git a/_includes/_markdown/install-sttp.md b/_includes/_markdown/install-sttp.md index e4eaf1b4a4..6bc2812d4e 100644 --- a/_includes/_markdown/install-sttp.md +++ b/_includes/_markdown/install-sttp.md @@ -17,7 +17,7 @@ In your build.sbt file, you can add a dependency on the Toolkit: ```scala lazy val example = project.in(file("example")) .settings( - scalaVersion := "3.2.2", + scalaVersion := "3.3.3", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" ) ``` @@ -31,7 +31,7 @@ libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-M1" In your build.sc file, you can add a dependency on the Toolkit: ```scala object example extends ScalaModule { - def scalaVersion = "3.2.2" + def scalaVersion = "3.3.3" def ivyDeps = Agg( ivy"org.scala-lang::toolkit:0.1.7" diff --git a/_includes/_markdown/install-upickle.md b/_includes/_markdown/install-upickle.md index e1f478bcc2..26e6ecd5b4 100644 --- a/_includes/_markdown/install-upickle.md +++ b/_includes/_markdown/install-upickle.md @@ -17,7 +17,7 @@ In your build.sbt file, you can add the dependency on the Toolkit: ```scala lazy val example = project.in(file("example")) .settings( - scalaVersion := "3.2.2", + scalaVersion := "3.3.3", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" ) ``` @@ -30,7 +30,7 @@ libraryDependencies += "com.lihaoyi" %% "upickle" % "3.1.0" In your build.sc file, you can add the dependency to the upickle library: ```scala object example extends ScalaModule { - def scalaVersion = "3.2.2" + def scalaVersion = "3.3.3" def ivyDeps = Agg( ivy"org.scala-lang::toolkit:0.1.7" From e5be7bb622cda06b3bc20e0d9fd53b2eaca8c2a5 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 8 May 2024 00:20:09 -0700 Subject: [PATCH 2848/3075] Toolkit tutorial: use same sttp version as toolkit actually includes (#3015) --- _includes/_markdown/install-sttp.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_includes/_markdown/install-sttp.md b/_includes/_markdown/install-sttp.md index 6bc2812d4e..4a2b0f117b 100644 --- a/_includes/_markdown/install-sttp.md +++ b/_includes/_markdown/install-sttp.md @@ -9,7 +9,7 @@ You can require the entire toolkit in a single line: Alternatively, you can require just a specific version of sttp: ```scala -//> using dep com.softwaremill.sttp.client4::core:4.0.0-M1 +//> using dep com.softwaremill.sttp.client4::core:4.0.0-M6 ``` {% endtab %} {% tab 'sbt' %} @@ -24,7 +24,7 @@ lazy val example = project.in(file("example")) Alternatively, you can require just a specific version of sttp: ```scala -libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-M1" +libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-M6" ``` {% endtab %} {% tab 'Mill' %} @@ -40,7 +40,7 @@ object example extends ScalaModule { ``` Alternatively, you can require just a specific version of sttp: ```scala -ivy"com.softwaremill.sttp.client4::core:4.0.0-M1" +ivy"com.softwaremill.sttp.client4::core:4.0.0-M6" ``` {% endtab %} {% endtabs %} From 65288f12ee7ed2adf7a771764d71a7daa71a1bf8 Mon Sep 17 00:00:00 2001 From: Tamirrr <43725711+tamir61@users.noreply.github.com> Date: Thu, 9 May 2024 12:28:51 +0300 Subject: [PATCH 2849/3075] Update scala-for-javascript-devs.md Fix Javascript For loops comparison with Scala example --- _overviews/scala3-book/scala-for-javascript-devs.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index 658b2a6539..a087d02f88 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -938,10 +938,10 @@ val nums = List(1, 2, 3) <tr> <td class="scala-block"> <code>// preferred - <br>for i <- ints do println(i) + <br>for i <- nums do println(i) <br> <br>// also available - <br>for (i <- ints) println(i)</code> + <br>for (i <- nums) println(i)</code> </td> </tr> </tbody> From 4c3b3eda86ee77e3a37ce6ec82d80ddd986573b3 Mon Sep 17 00:00:00 2001 From: Tamirrr <43725711+tamir61@users.noreply.github.com> Date: Thu, 9 May 2024 12:32:26 +0300 Subject: [PATCH 2850/3075] Update scala-for-javascript-devs.md --- _overviews/scala3-book/scala-for-javascript-devs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index a087d02f88..0def7dcbc1 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -969,7 +969,7 @@ val nums = List(1, 2, 3) <tr> <td class="scala-block"> <code>// preferred - <br>for i <- ints do + <br>for i <- nums do <br>  val i = i * 2 <br>  println(j) <br> From df74be838aa36684518d6271eaf13c318bb0d173 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 13 May 2024 23:40:38 +0000 Subject: [PATCH 2851/3075] Bump nokogiri from 1.16.2 to 1.16.5 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.16.2 to 1.16.5. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.16.2...v1.16.5) --- updated-dependencies: - dependency-name: nokogiri dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 89227d9adf..1fb396593a 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -233,11 +233,11 @@ GEM mutex_m (0.2.0) net-http (0.4.1) uri - nokogiri (1.16.2-arm64-darwin) + nokogiri (1.16.5-arm64-darwin) racc (~> 1.4) - nokogiri (1.16.2-x64-mingw-ucrt) + nokogiri (1.16.5-x64-mingw-ucrt) racc (~> 1.4) - nokogiri (1.16.2-x86_64-linux) + nokogiri (1.16.5-x86_64-linux) racc (~> 1.4) octokit (4.25.1) faraday (>= 1, < 3) From 94d5643239d0e565d154e50c53105b083e373522 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Wed, 15 May 2024 00:22:21 +0000 Subject: [PATCH 2852/3075] Update SIPs state --- _sips/sips/for-comprehension-improvements.md | 7 ------- _sips/sips/named-tuples.md | 7 ------- 2 files changed, 14 deletions(-) delete mode 100644 _sips/sips/for-comprehension-improvements.md delete mode 100644 _sips/sips/named-tuples.md diff --git a/_sips/sips/for-comprehension-improvements.md b/_sips/sips/for-comprehension-improvements.md deleted file mode 100644 index 0676734fb6..0000000000 --- a/_sips/sips/for-comprehension-improvements.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-62 - For comprehension improvements -status: under-review -pull-request-number: 79 -stage: design - ---- diff --git a/_sips/sips/named-tuples.md b/_sips/sips/named-tuples.md deleted file mode 100644 index 82bc141811..0000000000 --- a/_sips/sips/named-tuples.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-58 - Named Tuples -status: under-review -pull-request-number: 72 -stage: design - ---- From 3334b9854c121ff82ef4cfe720982cb9b159e438 Mon Sep 17 00:00:00 2001 From: marcogalluzzi <galluzzi.m@gmail.com> Date: Thu, 16 May 2024 00:01:07 +0100 Subject: [PATCH 2853/3075] Update traits.md The `new` keyword is not needed in Scala 3 --- _tour/traits.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/traits.md b/_tour/traits.md index 3ead3d3974..f719f96744 100644 --- a/_tour/traits.md +++ b/_tour/traits.md @@ -98,7 +98,7 @@ class IntIterator(to: Int) extends Iterator[Int]: 0 end IntIterator -val iterator = new IntIterator(10) +val iterator = IntIterator(10) iterator.next() // returns 0 iterator.next() // returns 1 ``` From b6c92250f91827a84b3af6bd260c834484efc48c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Marks?= <pmarks@virtuslab.com> Date: Thu, 16 May 2024 17:32:47 +0200 Subject: [PATCH 2854/3075] Add api link to 3.4.2 --- _config.yml | 2 +- api/all.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index e4a2ffeb7b..f257fada05 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.14 scala-212-version: 2.12.19 -scala-3-version: 3.4.1 +scala-3-version: 3.4.2 collections: style: diff --git a/api/all.md b/api/all.md index 262c0779a0..334ecac392 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,8 @@ redirect_from: ## Latest releases -* Scala 3.4.1 - * [Library API](https://www.scala-lang.org/api/3.4.1/) +* Scala 3.4.2 + * [Library API](https://www.scala-lang.org/api/3.4.2/) * Scala 3.3.3 LTS * [Library API](https://www.scala-lang.org/api/3.3.3/) * Scala 2.13.14 @@ -64,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.4.1 + * [Library API](https://www.scala-lang.org/api/3.4.1/) * Scala 3.4.0 * [Library API](https://www.scala-lang.org/api/3.4.0/) * Scala 3.3.1 LTS From 3eb2610ef717d7bfddaefeb158e22055e9f519fd Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 16 May 2024 21:57:46 +0000 Subject: [PATCH 2855/3075] Bump rexml from 3.2.6 to 3.2.8 Bumps [rexml](https://github.com/ruby/rexml) from 3.2.6 to 3.2.8. - [Release notes](https://github.com/ruby/rexml/releases) - [Changelog](https://github.com/ruby/rexml/blob/master/NEWS.md) - [Commits](https://github.com/ruby/rexml/compare/v3.2.6...v3.2.8) --- updated-dependencies: - dependency-name: rexml dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 1fb396593a..06dccdc0b6 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -251,7 +251,8 @@ GEM rb-fsevent (0.11.2) rb-inotify (0.10.1) ffi (~> 1.0) - rexml (3.2.6) + rexml (3.2.8) + strscan (>= 3.0.9) rouge (3.30.0) ruby2_keywords (0.0.5) rubyzip (2.3.2) @@ -266,6 +267,7 @@ GEM faraday (>= 0.17.3, < 3) simpleidn (0.2.1) unf (~> 0.1.4) + strscan (3.1.0) terminal-table (1.8.0) unicode-display_width (~> 1.1, >= 1.1.1) typhoeus (1.4.1) From 039a32b44169471ae04e9ef38826a67de7bba4e7 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Fri, 31 May 2024 09:49:31 +0000 Subject: [PATCH 2856/3075] Update SIPs state --- _sips/sips/for-comprehension-improvements.md | 7 +++++++ _sips/sips/named-tuples.md | 7 +++++++ 2 files changed, 14 insertions(+) create mode 100644 _sips/sips/for-comprehension-improvements.md create mode 100644 _sips/sips/named-tuples.md diff --git a/_sips/sips/for-comprehension-improvements.md b/_sips/sips/for-comprehension-improvements.md new file mode 100644 index 0000000000..8fcaefe85e --- /dev/null +++ b/_sips/sips/for-comprehension-improvements.md @@ -0,0 +1,7 @@ +--- +title: SIP-62 - For comprehension improvements +status: waiting-for-implementation +pull-request-number: 79 +stage: implementation + +--- diff --git a/_sips/sips/named-tuples.md b/_sips/sips/named-tuples.md new file mode 100644 index 0000000000..0e6ad99d7f --- /dev/null +++ b/_sips/sips/named-tuples.md @@ -0,0 +1,7 @@ +--- +title: SIP-58 - Named Tuples +status: waiting-for-implementation +pull-request-number: 72 +stage: implementation + +--- From 29f39bf7fd42218f82669371477a60d78845f31e Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 11 Jun 2024 00:23:06 +0000 Subject: [PATCH 2857/3075] Update SIPs state --- ...s-amendment-extractors-follow-aliases-and-singletons.md | 7 +++++++ .../unroll-default-arguments-for-binary-compatibility.md | 4 ++-- 2 files changed, 9 insertions(+), 2 deletions(-) create mode 100644 _sips/sips/match-types-amendment-extractors-follow-aliases-and-singletons.md diff --git a/_sips/sips/match-types-amendment-extractors-follow-aliases-and-singletons.md b/_sips/sips/match-types-amendment-extractors-follow-aliases-and-singletons.md new file mode 100644 index 0000000000..ae8c984c54 --- /dev/null +++ b/_sips/sips/match-types-amendment-extractors-follow-aliases-and-singletons.md @@ -0,0 +1,7 @@ +--- +title: 'Match types amendment: extractors follow aliases and singletons' +status: under-review +pull-request-number: 84 +stage: implementation + +--- diff --git a/_sips/sips/unroll-default-arguments-for-binary-compatibility.md b/_sips/sips/unroll-default-arguments-for-binary-compatibility.md index 0acee8e40b..36c9e1e768 100644 --- a/_sips/sips/unroll-default-arguments-for-binary-compatibility.md +++ b/_sips/sips/unroll-default-arguments-for-binary-compatibility.md @@ -1,7 +1,7 @@ --- title: SIP-61 - Unroll Default Arguments for Binary Compatibility -status: under-review +status: waiting-for-implementation pull-request-number: 78 -stage: design +stage: implementation --- From 8a827657e81dd5183a7b8a697f020aaeb4fbdbbf Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Wed, 12 Jun 2024 00:23:02 +0000 Subject: [PATCH 2858/3075] Update SIPs state --- _sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md b/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md index f7c2914164..88b8c7b044 100644 --- a/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md +++ b/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md @@ -2,6 +2,6 @@ title: 'SIP-64: Improve the Syntax of Context Bounds and Givens' status: under-review pull-request-number: 81 -stage: design +stage: implementation --- From 8bec5d0d92a594034b20560ed01ea8f2524f91d0 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Mon, 24 Jun 2024 15:18:53 +0200 Subject: [PATCH 2859/3075] remove scam warning (#3030) --- _includes/alert-banner.html | 2 ++ _layouts/root-content-layout.html | 2 +- _layouts/root-index-layout.html | 2 +- 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/_includes/alert-banner.html b/_includes/alert-banner.html index 405cbd8fb0..94c5ac1273 100644 --- a/_includes/alert-banner.html +++ b/_includes/alert-banner.html @@ -1,8 +1,10 @@ {% comment %}use the variable 'message' to include markdown text to display in the alert.{% endcomment %} +{% unless include.message_id == 'disabled' %} <header id="site-header" class="header-home"> <div class="new-on-the-blog alert-warning" data-message_id="{{include.message_id}}"> <p>{{include.message|markdownify}}</p> <span class="hide"><i class="fa fa-close"></i></span> </div> </header> +{% endunless %} diff --git a/_layouts/root-content-layout.html b/_layouts/root-content-layout.html index f8d99b1427..b45513d346 100644 --- a/_layouts/root-content-layout.html +++ b/_layouts/root-content-layout.html @@ -3,7 +3,7 @@ <div class="navigation-fade-screen"></div> -{% include alert-banner.html message=site.data.messages.scam-banner message_id='scam-courses-feb-2024' %} +{% include alert-banner.html message_id='disabled' message=site.data.messages.scam-banner %} {% include navbar-inner.html %} diff --git a/_layouts/root-index-layout.html b/_layouts/root-index-layout.html index baf0558d44..d83b64596f 100644 --- a/_layouts/root-index-layout.html +++ b/_layouts/root-index-layout.html @@ -2,7 +2,7 @@ <div class="navigation-fade-screen"></div> -{% include alert-banner.html message=site.data.messages.scam-banner message_id='scam-courses-feb-2024' %} +{% include alert-banner.html message_id='disabled' message=site.data.messages.scam-banner %} {% include navbar-inner.html %} From 005ae2155b7df0d90b71443348ab870cf2d47b34 Mon Sep 17 00:00:00 2001 From: Abel Sen <19356702+neuroevolutus@users.noreply.github.com> Date: Tue, 25 Jun 2024 03:34:15 -0500 Subject: [PATCH 2860/3075] Grammar and wording (#3032) * Grammar: change "object's" to "an object's" and add commas Also change "parameterized" to "parameterised" to follow the British spelling convention used elsewhere. * Format `map` as code * Grammar: add missing coordinating conjunction "but" * Grammar: add comma after phrase to avoid semantic ambiguity * Remove comma splice and reword sentences to enhance clarity * Grammar: remove comma splices * Reword sentences to enhance clarity --- _tour/annotations.md | 2 +- _tour/higher-order-functions.md | 6 +++--- _tour/package-objects.md | 2 +- _tour/tour-of-scala.md | 2 +- _tour/variances.md | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/_tour/annotations.md b/_tour/annotations.md index 98f860ba34..a9876fab42 100644 --- a/_tour/annotations.md +++ b/_tour/annotations.md @@ -146,7 +146,7 @@ public class MyJavaClass extends TheirClass ... {% endtab %} {% endtabs %} -An annotation application in Scala looks like a constructor invocation, for instantiating a Java annotation one has to use named arguments: +An annotation application in Scala looks like a constructor invocation, but to instantiate a Java annotation one has to use named arguments: {% tabs annotations_7 %} {% tab 'Scala 2 and 3' for=annotations_7 %} diff --git a/_tour/higher-order-functions.md b/_tour/higher-order-functions.md index 9863069b66..7dc08ea005 100644 --- a/_tour/higher-order-functions.md +++ b/_tour/higher-order-functions.md @@ -16,7 +16,7 @@ The terminology can get a bit confusing at this point, and we use the phrase "higher order function" for both methods and functions that take functions as parameters or that return a function. -In a pure Object Oriented world a good practice is to avoid exposing methods parameterized with functions that might leak object's internal state. Leaking internal state might break the invariants of the object itself thus violating encapsulation. +In a pure Object Oriented world, a good practice is to avoid exposing methods parameterised with functions that might leak an object's internal state. Leaking internal state might break the invariants of the object itself, thus violating encapsulation. One of the most common examples is the higher-order function `map` which is available for collections in Scala. @@ -51,7 +51,7 @@ val newSalaries = salaries.map(x => x * 2) // List(40000, 140000, 80000) {% endtabs %} Notice how `x` is not declared as an Int in the above example. That's because the -compiler can infer the type based on the type of function map expects (see [Currying](/tour/multiple-parameter-lists.html)). An even more idiomatic way to write the same piece of code would be: +compiler can infer the type based on the type of function `map` expects (see [Currying](/tour/multiple-parameter-lists.html)). An even more idiomatic way to write the same piece of code would be: {% tabs map_example_3 %} @@ -187,7 +187,7 @@ object SalaryRaiser: The new method, `promotion`, takes the salaries plus a function of type `Double => Double` (i.e. a function that takes a Double and returns a Double) and returns the product. -Methods and functions usually express behaviours or data transformations, therefore having functions that compose based on other functions can help building generic mechanisms. Those generic operations defer to lock down the entire operation behaviour giving clients a way to control or further customize parts of the operation itself. +Methods and functions usually express behaviours or data transformations. Therefore, having functions that compose based on other functions can allow us to build more generic mechanisms. Such generic operations avoid completely locking down their behaviour in order to give clients a way to control or further customize parts of those operations. ## Functions that return functions diff --git a/_tour/package-objects.md b/_tour/package-objects.md index 52484564a9..8be239c933 100644 --- a/_tour/package-objects.md +++ b/_tour/package-objects.md @@ -33,7 +33,7 @@ methods and variables. Any definitions placed at the top level of a package are considered members of the package itself. -> In Scala 2 top-level method, type and variable definitions had to be wrapped in a **package object**. +> In Scala 2, top-level method, type and variable definitions had to be wrapped in a **package object**. > These are still usable in Scala 3 for backwards compatibility. You can see how they work by switching tabs. {% endtab %} diff --git a/_tour/tour-of-scala.md b/_tour/tour-of-scala.md index 59e4072e3a..49f0d2b7e2 100644 --- a/_tour/tour-of-scala.md +++ b/_tour/tour-of-scala.md @@ -28,7 +28,7 @@ Scala is a modern multi-paradigm programming language designed to express common Scala is a pure object-oriented language in the sense that [every value is an object](unified-types.html). Types and behaviors of objects are described by [classes](classes.html) and [traits](traits.html). Classes can be extended by subclassing, and by using a flexible [mixin-based composition](mixin-class-composition.html) mechanism as a clean replacement for multiple inheritance. ## Scala is functional ## -Scala is also a functional language in the sense that [every function is a value](unified-types.html). Scala provides a [lightweight syntax](basics.html#functions) for defining anonymous functions, it supports [higher-order functions](higher-order-functions.html), it allows functions to be [nested](nested-functions.html), and it supports [currying](multiple-parameter-lists.html). Scala's [case classes](case-classes.html) and its built-in support for [pattern matching](pattern-matching.html) provide the functionality of algebraic types, which are used in many functional languages. [Singleton objects](singleton-objects.html) provide a convenient way to group functions that aren't members of a class. +Scala is also a functional language in the sense that [every function is a value](unified-types.html). Scala provides a [lightweight syntax](basics.html#functions) for defining anonymous functions, supports [higher-order functions](higher-order-functions.html), allows functions to be [nested](nested-functions.html), and supports [currying](multiple-parameter-lists.html). Scala's [case classes](case-classes.html) and its built-in support for [pattern matching](pattern-matching.html) provide the functionality of algebraic types, which are used in many functional languages. [Singleton objects](singleton-objects.html) provide a convenient way to group functions that aren't members of a class. Furthermore, Scala's notion of pattern matching naturally extends to the [processing of XML data](https://github.com/scala/scala-xml/wiki/XML-Processing) with the help of [right-ignoring sequence patterns](regular-expression-patterns.html), by way of general extension via [extractor objects](extractor-objects.html). In this context, [for comprehensions](for-comprehensions.html) are useful for formulating queries. These features make Scala ideal for developing applications like web services. diff --git a/_tour/variances.md b/_tour/variances.md index 87fc6029a2..706a28ce14 100644 --- a/_tour/variances.md +++ b/_tour/variances.md @@ -112,7 +112,7 @@ From this, we have to conclude that `Box[Cat]` and `Box[Animal]` can't have a su The problem we ran in to above, is that because we could put a Dog in an Animal Box, a Cat Box can't be an Animal Box. -But what if we couldn't put a Dog in the box? Then we could just get our Cat back out and that's not a problem, so than it could follow the subtyping relationship. It turns out, that's indeed something we can do. +But what if we couldn't put a Dog in the box? Then, we could just get our Cat back out without a problem, and it would adhere to the subtyping relationship. It turns out that that's possible to do. {% tabs covariance_1 class=tabs-scala-version %} {% tab 'Scala 2' for=covariance_1 %} From b9c73e2b8b9fb7beffeadd1daa0be3ad622d7e6f Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Tue, 25 Jun 2024 14:57:02 +0200 Subject: [PATCH 2861/3075] add scala ambassadors to the footer (#3033) --- _data/footer.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_data/footer.yml b/_data/footer.yml index e725cef40a..43338e7b74 100644 --- a/_data/footer.yml +++ b/_data/footer.yml @@ -23,6 +23,8 @@ url: "http://scala-lang.org/community/" - title: Governance url: "http://scala-lang.org/community/index.html#governance" + - title: Scala Ambassadors + url: "http://scala-lang.org/ambassadors/" - title: Mailing Lists url: "http://scala-lang.org/community/index.html#mailing-lists" - title: Chat Rooms & More From c7ef1d67f3830573cfd20a6340c7889ef694abb3 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Wed, 11 Jan 2023 17:30:51 +0100 Subject: [PATCH 2862/3075] improve fun-eta-expanion.md wording --- _overviews/scala3-book/fun-eta-expansion.md | 102 +++++++++++--------- 1 file changed, 59 insertions(+), 43 deletions(-) diff --git a/_overviews/scala3-book/fun-eta-expansion.md b/_overviews/scala3-book/fun-eta-expansion.md index e45f48cc68..0854c09771 100644 --- a/_overviews/scala3-book/fun-eta-expansion.md +++ b/_overviews/scala3-book/fun-eta-expansion.md @@ -1,7 +1,7 @@ --- -title: Eta Expansion +title: Eta-Expansion type: section -description: This page discusses Eta Expansion, the Scala technology that automatically and transparently converts methods into functions. +description: This page discusses Eta-Expansion, the Scala technology that automatically and transparently converts methods into functions. languages: [ru, zh-cn] num: 31 previous-page: fun-function-variables @@ -9,14 +9,14 @@ next-page: fun-hofs --- -When you look at the Scaladoc for the `map` method on Scala collections classes, you see that it’s defined to accept a _function_: +When you look at the Scaladoc for the `map` method on Scala collections classes, you see that it’s defined to accept a _function_ value: {% tabs fun_1 %} {% tab 'Scala 2 and 3' for=fun_1 %} ```scala -def map[B](f: (A) => B): List[B] - ----------- +def map[B](f: A => B): List[B] +// ^^^^^^ function type from `A` to `B` ``` {% endtab %} @@ -26,7 +26,7 @@ Indeed, the Scaladoc clearly states, “`f` is the _function_ to apply to each e But despite that, somehow you can pass a _method_ into `map`, and it still works: {% tabs fun_2 %} -{% tab 'Scala 2 and 3' for=fun_2 %} +{% tab 'Scala 2 and 3' %} ```scala def times10(i: Int) = i * 10 // a method @@ -36,80 +36,96 @@ List(1, 2, 3).map(times10) // List(10,20,30) {% endtab %} {% endtabs %} -Have you ever wondered how this works---how you can pass a _method_ into `map`, which expects a _function_? - -The technology behind this is known as _Eta Expansion_. +Why does this work? The process behind this is known as _eta-expansion_. It converts an expression of _method type_ to an equivalent expression of _function type_, and it does so seamlessly and quietly. ## The differences between methods and functions -{% comment %} -NOTE: I got the following “method” definition from this page (https://dotty.epfl.ch/docs/reference/changed-features/eta-expansion-spec.html), but I’m not sure it’s 100% accurate now that methods can exist outside of classes/traits/objects. -I’ve made a few changes to that description that I hope are more accurate and up to date. -{% endcomment %} - -Historically, _methods_ have been a part of the definition of a class, although in Scala 3 you can now have methods outside of classes, such as [Toplevel definitions][toplevel] and [extension methods][extension]. +The key difference between methods and functions is that _a function is an object_, i.e. it is an instance of a class, and in turn has its own methods (e.g. try `f.apply` on a function `f`). -Unlike methods, _functions_ are complete objects themselves, making them first-class entities. +_Methods_ are not values that can be passed around, i.e. they can only be called via method application (e.g. `foo(arg1, arg2, ...)`). Methods can be _converted_ to a value by creating a function value that will call the method when supplied with the required arguments. This is known as eta-expansion. -Their syntax is also different. -This example shows how to define a method and a function that perform the same task, determining if the given integer is even: +More concretely: with automatic eta-expansion, the compiler automatically converts any _method reference_, without supplied arguments, to an equivalent _anonymous function_ that will call the method. For example, the reference to `times10` in the code above gets rewritten to `x => times10(x)`, as seen here: -{% tabs fun_3 %} -{% tab 'Scala 2 and 3' for=fun_3 %} +{% tabs fun_2_expanded %} +{% tab 'Scala 2 and 3' %} ```scala -def isEvenMethod(i: Int) = i % 2 == 0 // a method -val isEvenFunction = (i: Int) => i % 2 == 0 // a function +def times10(i: Int) = i * 10 +List(1, 2, 3).map(x => times10(x)) // eta expansion of `.map(times10)` ``` {% endtab %} {% endtabs %} -The function truly is an object, so you can use it just like any other variable, such as putting it in a list: +> For the curious, the term eta-expansion has its origins in the [Lambda Calculus](https://en.wikipedia.org/wiki/Lambda_calculus). + +## When does eta-expansion happen? -{% tabs fun_4 %} -{% tab 'Scala 2 and 3' for=fun_4 %} +Automatic eta-expansion is a desugaring that is context-dependent (i.e. the expansion conditionally activates, depending on the surrounding code of the method reference.) + +{% tabs fun_5 class=tabs-scala-version %} +{% tab 'Scala 2' %} +In Scala 2 eta-expansion only occurs automatically when the expected type is a function type. +For example, the following will fail: ```scala -val functions = List(isEvenFunction) +def isLessThan(x: Int, y: Int): Boolean = x < y + +val methods = List(isLessThan) +// ^^^^^^^^^^ +// error: missing argument list for method isLessThan +// Unapplied methods are only converted to functions when a function type is expected. +// You can make this conversion explicit by writing `isLessThan _` or `isLessThan(_,_)` instead of `isLessThan`. ``` +See [below](#manual-eta-expansion) for how to solve this issue with manual eta-expansion. {% endtab %} -{% endtabs %} -{% tabs fun_5 class=tabs-scala-version %} -{% tab 'Scala 2' for=fun_5 %} +{% tab 'Scala 3' %} + +New to Scala 3, method references can be used everywhere as a value, they will be automatically converted to a function object with a matching type. e.g. ```scala -// this example shows the Scala 2 error message -val methods = List(isEvenMethod) - ^ -error: missing argument list for method isEvenMethod -Unapplied methods are only converted to functions when a function type is expected. -You can make this conversion explicit by writing `isEvenMethod _` or `isEvenMethod(_)` instead of `isEvenMethod`. -``` +def isLessThan(x: Int, y: Int): Boolean = x < y -Conversely, a method technically isn’t an object, so in Scala 2 you couldn’t put a method in a `List`, at least not directly, as shown in this example: +val methods = List(isLessThan) // works +``` {% endtab %} +{% endtabs %} + +## Manual eta-expansion -{% tab 'Scala 3' for=fun_5 %} +You can always manually eta-expand a method to a function value, here are some examples how: + +{% tabs fun_6 class=tabs-scala-version %} +{% tab 'Scala 2' %} ```scala -val functions = List(isEvenFunction) // works -val methods = List(isEvenMethod) // works +val methodsA = List(isLessThan _) // way 1: expand all parameters +val methodsB = List(isLessThan(_, _)) // way 2: wildcard application +val methodsC = List((x, y) => isLessThan(x, y)) // way 3: anonymous function ``` -The important part for Scala 3 is that the Eta Expansion technology is improved, so now when you attempt to use a method as a variable, it just works---you don’t have to handle the manual conversion yourself. +{% endtab %} + +{% tab 'Scala 3' %} + +```scala +val methodsA = List(isLessThan(_, _)) // way 1: wildcard application +val methodsB = List((x, y) => isLessThan(x, y)) // way 2: anonymous function +``` {% endtab %} {% endtabs %} +## Summary + For the purpose of this introductory book, the important things to know are: -- Eta Expansion is the Scala technology that lets you use methods just like functions -- The technology has been improved in Scala 3 to be almost completely seamless +- eta-expansion is a helpful desugaring that lets you use methods just like functions, +- the automatic eta-expansion been improved in Scala 3 to be almost completely seamless. For more details on how this works, see the [Eta Expansion page][eta_expansion] in the Reference documentation. From 377ca8099fb6058d5cbb9529b3fa9cac462b0f25 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Tue, 25 Jun 2024 19:18:10 +0200 Subject: [PATCH 2863/3075] finish migration to code tabs in migration guide (#3035) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * finish migration to code tabs in migration guide * Update _overviews/scala3-migration/incompat-type-inference.md Co-authored-by: Sébastien Doeraene <sjrdoeraene@gmail.com> --------- Co-authored-by: Sébastien Doeraene <sjrdoeraene@gmail.com> --- .../incompat-type-inference.md | 47 ++++++++++------ .../scala3-migration/plugin-kind-projector.md | 54 +++++++++++++++++-- .../tutorial-macro-cross-building.md | 8 +-- .../scala3-migration/tutorial-macro-mixing.md | 2 +- 4 files changed, 85 insertions(+), 26 deletions(-) diff --git a/_overviews/scala3-migration/incompat-type-inference.md b/_overviews/scala3-migration/incompat-type-inference.md index a5f1552c06..bb6fc3052a 100644 --- a/_overviews/scala3-migration/incompat-type-inference.md +++ b/_overviews/scala3-migration/incompat-type-inference.md @@ -14,26 +14,15 @@ The new algorithm is better than the old one, but sometime it can fail where Sca > It is always good practice to write the result types of all public values and methods explicitly. > It prevents the public API of your library from changing with the Scala version, because of different inferred types. -> +> > This can be done prior to the Scala 3 migration by using the [ExplicitResultTypes](https://scalacenter.github.io/scalafix/docs/rules/ExplicitResultTypes.html) rule in Scalafix. ## Return Type of an Override Method In Scala 3 the return type of an override method is inferred by inheritance from the base method, whereas in Scala 2.13 it is inferred from the left hand side of the override method. -```scala -class Parent { - def foo: Foo = new Foo -} - -class Child extends Parent { - override def foo = new RichFoo(super.foo) -} -``` - -In this example, `Child#foo` returns a `RichFoo` in Scala 2.13 but a `Foo` in Scala 3. -It can lead to compiler errors as demonstrated below. - +{% tabs define_parent_child %} +{% tab 'Scala 2 and 3' %} ```scala class Foo @@ -48,13 +37,24 @@ class Parent { class Child extends Parent { override def foo = new RichFoo(super.foo) } +``` +{% endtab %} +{% endtabs %} + +In this example, `Child#foo` returns a `RichFoo` in Scala 2.13 but a `Foo` in Scala 3. +It can lead to compiler errors as demonstrated below. +{% tabs extend_parent_child %} +{% tab 'Scala 3 Only' %} +```scala (new Child).foo.show // Scala 3 error: value show is not a member of Foo ``` +{% endtab %} +{% endtabs %} In some rare cases involving implicit conversions and runtime casting it could even cause a runtime failure. -The solution is to make the return type of the override method explicit: +The solution is to make the return type of the override method explicit so that it matches what is inferred in 2.13: {% highlight diff %} class Child extends Parent { @@ -68,19 +68,32 @@ class Child extends Parent { Scala 2 reflective calls are dropped and replaced by the broader [Programmatic Structural Types]({{ site.scala3ref }}/changed-features/structural-types.html). Scala 3 can imitate Scala 2 reflective calls by making `scala.reflect.Selectable.reflectiveSelectable` available wherever `scala.language.reflectiveCalls` is imported. -However the Scala 3 compiler does not infer structural types by default, and thus fails at compiling: +{% tabs define_structural %} +{% tab 'Scala 2 and 3' %} ```scala import scala.language.reflectiveCalls val foo = new { def bar: Unit = ??? } +``` +{% endtab %} +{% endtabs %} +However the Scala 3 compiler does not infer structural types by default. +It infers the type `Object` for `foo` instead of `{ def bar: Unit }`. +Therefore, the following structural selection fails to compile: + +{% tabs use_structural %} +{% tab 'Scala 3 Only' %} +```scala foo.bar // Error: value bar is not a member of Object ``` +{% endtab %} +{% endtabs %} -The straightforward solution is to write down the structural type. +The straightforward solution is to explicitly write down the structural type. {% highlight diff %} import scala.language.reflectiveCalls diff --git a/_overviews/scala3-migration/plugin-kind-projector.md b/_overviews/scala3-migration/plugin-kind-projector.md index 39639d1281..ab996ec586 100644 --- a/_overviews/scala3-migration/plugin-kind-projector.md +++ b/_overviews/scala3-migration/plugin-kind-projector.md @@ -9,11 +9,11 @@ next-page: external-resources In the future, Scala 3 will use the `_` underscore symbol for placeholders in type lambdas---just as the underscore is currently used for placeholders in (ordinary) term-level lambdas. -The new type lambda syntax is not enabled by default, to enable it, use a compiler flag `-Ykind-projector:underscores`. Note that enabling underscore type lambdas will disable usage of `_` as a wildcard, you will only be able to write wildcards using the `?` symbol. +The new type lambda syntax is not enabled by default, to enable it, use a compiler flag `-Ykind-projector:underscores`. Note that enabling underscore type lambdas will disable usage of `_` as a wildcard, you will only be able to write wildcards using the `?` symbol. If you wish to cross-compile a project for Scala 2 & Scala 3 while using underscore type lambdas for both, you may do so starting with [kind-projector](https://github.com/typelevel/kind-projector) version `0.13.0` and up and Scala 2 versions `2.13.6` and `2.12.14`. To enable it, add the compiler flags `-Xsource:3 -P:kind-projector:underscore-placeholders` to your build. -As in Scala 3, this will disable usage of `_` as a wildcard, however, the flag `-Xsource:3` will allow you to replace it with the `?` symbol. +As in Scala 3, this will disable usage of `_` as a wildcard, however, the flag `-Xsource:3` will allow you to replace it with the `?` symbol. The following `sbt` configuration will set up the correct flags to cross-compile with new syntax: @@ -34,31 +34,49 @@ In turn, you will also have to rewrite all usages of `_` as the wildcard to use For example the following usage of the wildcard: +{% tabs wildcard_scala2 %} +{% tab 'Scala 2 Only' %} ```scala -def getWidget(widgets: Set[_ <: Widget], name: String): Option[Widget] = widgets.find(_.name == name) +def getWidget(widgets: Set[_ <: Widget], name: String): Option[Widget] = + widgets.find(_.name == name) ``` +{% endtab %} +{% endtabs %} Must be rewritten to: +{% tabs wildcard_scala3 %} +{% tab 'Scala 3 Only' %} ```scala -def getWidget(widgets: Set[? <: Widget], name: String): Option[Widget] = widgets.find(_.name == name) +def getWidget(widgets: Set[? <: Widget], name: String): Option[Widget] = + widgets.find(_.name == name) ``` +{% endtab %} +{% endtabs %} And the following usages of kind-projector's `*` placeholder: +{% tabs kind_projector_scala2 %} +{% tab 'Scala 2 Only' %} ```scala Tuple2[*, Double] // equivalent to: type R[A] = Tuple2[A, Double] Either[Int, +*] // equivalent to: type R[+A] = Either[Int, A] Function2[-*, Long, +*] // equivalent to: type R[-A, +B] = Function2[A, Long, B] ``` +{% endtab %} +{% endtabs %} Must be rewritten to: +{% tabs kind_projector_scala3 %} +{% tab 'Scala 3 Only' %} ```scala Tuple2[_, Double] // equivalent to: type R[A] = Tuple2[A, Double] Either[Int, +_] // equivalent to: type R[+A] = Either[Int, A] Function2[-_, Long, +_] // equivalent to: type R[-A, +B] = Function2[A, Long, B] ``` +{% endtab %} +{% endtabs %} ## Compiling Existing Code @@ -66,11 +84,15 @@ Even without migrating to underscore type lambdas, you will likely be able to co Use the flag `-Ykind-projector` to enable support for `*`-based type lambdas (without enabling underscore type lambdas), the following forms will now compile: +{% tabs kind_projector_cross %} +{% tab 'Scala 2 and 3' %} ```scala Tuple2[*, Double] // equivalent to: type R[A] = Tuple2[A, Double] Either[Int, +*] // equivalent to: type R[+A] = Either[Int, A] Function2[-*, Long, +*] // equivalent to: type R[-A, +B] = Function2[A, Long, B] ``` +{% endtab %} +{% endtabs %} ## Rewriting Incompatible Constructs @@ -82,6 +104,8 @@ Scala 3's `-Ykind-projector` & `-Ykind-projector:underscores` implement only a s You must rewrite ALL of the following forms: +{% tabs kind_projector_illegal_scala2 %} +{% tab 'Scala 2 Only' %} ```scala // classic EitherT[*[_], Int, *] // equivalent to: type R[F[_], B] = EitherT[F, Int, B] @@ -92,36 +116,58 @@ EitherT[_[_], Int, _] // equivalent to: type R[F[_], B] = EitherT[F, Int, B] // named Lambda Lambda[(F[_], A) => EitherT[F, Int, A]] ``` +{% endtab %} +{% endtabs %} Into the following long-form to cross-compile with Scala 3: +{% tabs kind_projector_illegal_cross %} +{% tab 'Scala 2 and 3' %} ```scala type MyLambda[F[_], A] = EitherT[F, Int, A] MyLambda ``` +{% endtab %} +{% endtabs %} Alternatively you may use Scala 3's [Native Type Lambdas]({{ site.scala3ref }}/new-types/type-lambdas.html) if you do not need to cross-compile: +{% tabs kind_projector_illegal_scala3 %} +{% tab 'Scala 3 Only' %} ```scala [F[_], A] =>> EitherT[F, Int, A] ``` +{% endtab %} +{% endtabs %} For `Lambda` you must rewrite the following form: +{% tabs kind_projector_illegal_lambda_scala2 %} +{% tab 'Scala 2 Only' %} ```scala Lambda[(`+E`, `+A`) => Either[E, A]] ``` +{% endtab %} +{% endtabs %} To the following to cross-compile: +{% tabs kind_projector_illegal_lambda_cross %} +{% tab 'Scala 2 and 3' %} ```scala λ[(`+E`, `+A`) => Either[E, A]] ``` +{% endtab %} +{% endtabs %} Or alternatively to Scala 3 type lambdas: +{% tabs kind_projector_illegal_lambda_scala3 %} +{% tab 'Scala 3 Only' %} ```scala [E, A] =>> Either[E, A] ``` +{% endtab %} +{% endtabs %} Note: Scala 3 type lambdas no longer need `-` or `+` variance markers on parameters, these are now inferred. diff --git a/_overviews/scala3-migration/tutorial-macro-cross-building.md b/_overviews/scala3-migration/tutorial-macro-cross-building.md index b456b521aa..8d45ed3f90 100644 --- a/_overviews/scala3-migration/tutorial-macro-cross-building.md +++ b/_overviews/scala3-migration/tutorial-macro-cross-building.md @@ -101,11 +101,11 @@ If you try to compile with Scala 3 you should see some errors of the same kind a {% highlight text %} sbt:example> ++3.3.1 sbt:example> example / compile -[error] -- Error: /example/src/main/scala/location/Location.scala:15:35 +[error] -- Error: /example/src/main/scala/location/Location.scala:15:35 [error] 15 | val location = typeOf[Location] [error] | ^ [error] | No TypeTag available for location.Location -[error] -- Error: /example/src/main/scala/location/Location.scala:18:4 +[error] -- Error: /example/src/main/scala/location/Location.scala:18:4 [error] 18 | q"new $location($path, $line)" [error] | ^ [error] |Scala 2 macro cannot be used in Dotty. See https://dotty.epfl.ch/docs/reference/dropped-features/macros.html @@ -165,7 +165,7 @@ They must have the exact same signature than their Scala 2.13 counterparts. package location object Macros: - def location: Location = ??? + inline def location: Location = ??? ``` {% endtab %} {% endtabs %} @@ -191,7 +191,7 @@ object Macros: private def locationImpl(using quotes: Quotes): Expr[Location] = import quotes.reflect.Position val pos = Position.ofMacroExpansion - val file = Expr(pos.sourceFile.jpath.toString) + val file = Expr(pos.sourceFile.path.toString) val line = Expr(pos.startLine + 1) '{new Location($file, $line)} ``` diff --git a/_overviews/scala3-migration/tutorial-macro-mixing.md b/_overviews/scala3-migration/tutorial-macro-mixing.md index 34389b9d1b..4a013b4284 100644 --- a/_overviews/scala3-migration/tutorial-macro-mixing.md +++ b/_overviews/scala3-migration/tutorial-macro-mixing.md @@ -7,7 +7,7 @@ previous-page: tutorial-macro-mixing next-page: tooling-syntax-rewriting --- -This tutorial shows how to mix Scala 2.13 and Scala 3 macros in a single artifact. This means that consumers can use '-Ytasty-reader' from Scala 2.13 code that uses your macros. +This tutorial shows how to mix Scala 2.13 and Scala 3 macros in a single artifact. This means that consumers can use `-Ytasty-reader` from Scala 2.13 code that uses your macros. There are two main benefits of this: From 6fb24325798e54cab9d51b077ec83a1a669e5d52 Mon Sep 17 00:00:00 2001 From: Luis Osio Chico <72286405+LOsioChico@users.noreply.github.com> Date: Sun, 30 Jun 2024 19:20:19 -0700 Subject: [PATCH 2864/3075] fix scala comparison for loop with js example --- _overviews/scala3-book/scala-for-javascript-devs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index 0def7dcbc1..fbad84e9fc 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -970,7 +970,7 @@ val nums = List(1, 2, 3) <td class="scala-block"> <code>// preferred <br>for i <- nums do - <br>  val i = i * 2 + <br>  val j = i * 2 <br>  println(j) <br> <br>// also available From 996ebac25c890d17897271958eac0efe5927d5ab Mon Sep 17 00:00:00 2001 From: Luis Osio Chico <72286405+LOsioChico@users.noreply.github.com> Date: Sun, 30 Jun 2024 19:38:06 -0700 Subject: [PATCH 2865/3075] fix scala comparison multiple generators for loop with js example --- _overviews/scala3-book/scala-for-javascript-devs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index 0def7dcbc1..285dc9998f 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -992,7 +992,7 @@ val nums = List(1, 2, 3) <code>let str = "ab"; <br>for (let i = 1; i < 3; i++) { <br>  for (var j = 0; j < str.length; j++) { - <br>    for (let k = 1; k < 11; k++) { + <br>    for (let k = 1; k < 11; k += 5) { <br>      let c = str.charAt(j); <br>      console.log(`i: ${i} j: ${c} k: ${k}`); <br>    } From 73615435605e2ea37928f6309d2fecbdc81205af Mon Sep 17 00:00:00 2001 From: Luis Osio Chico <losio@unal.edu.co> Date: Mon, 1 Jul 2024 05:33:59 -0500 Subject: [PATCH 2866/3075] update Fury link in Scala build tool overview --- _overviews/scala-book/scala-build-tool-sbt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala-book/scala-build-tool-sbt.md b/_overviews/scala-book/scala-build-tool-sbt.md index ebc04193a9..c329d06aa4 100644 --- a/_overviews/scala-book/scala-build-tool-sbt.md +++ b/_overviews/scala-book/scala-build-tool-sbt.md @@ -161,5 +161,5 @@ Here’s a list of other build tools you can use to build Scala projects: - [Ant](http://ant.apache.org/) - [Gradle](https://gradle.org/) - [Maven](https://maven.apache.org/) -- [Fury](https://propensive.com/opensource/fury) +- [Fury](https://github.com/propensive/fury) - [Mill](https://com-lihaoyi.github.io/mill/) From e879104db218e9284c08b1e0ad030a2de11fc9e1 Mon Sep 17 00:00:00 2001 From: Ivan Mashonskii <ivan.mashonsky@gmail.com> Date: Thu, 4 Jul 2024 14:25:21 +0300 Subject: [PATCH 2867/3075] Update maps.md --- _overviews/collections-2.13/maps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/maps.md b/_overviews/collections-2.13/maps.md index 81580815b7..0d11c535a8 100644 --- a/_overviews/collections-2.13/maps.md +++ b/_overviews/collections-2.13/maps.md @@ -64,7 +64,7 @@ Mutable maps support in addition the operations summarized in the following tabl | **Additions and Updates:** | | | `ms(k) = v` |(Or, written out, `ms.update(k, v)`). Adds mapping from key `k` to value `v` to map ms as a side effect, overwriting any previous mapping of `k`.| | `ms.addOne(k -> v)`<br>or `ms += (k -> v)` |Adds mapping from key `k` to value `v` to map `ms` as a side effect and returns `ms` itself.| -| `ms.addAll(xvs)`<br>or `ms ++= kvs` |Adds all mappings in `kvs` to `ms` as a side effect and returns `ms` itself.| +| `ms.addAll(kvs)`<br>or `ms ++= kvs` |Adds all mappings in `kvs` to `ms` as a side effect and returns `ms` itself.| | `ms.put(k, v)` |Adds mapping from key `k` to value `v` to `ms` and returns any value previously associated with `k` as an option.| | `ms.getOrElseUpdate(k, d)` |If key `k` is defined in map `ms`, return its associated value. Otherwise, update `ms` with the mapping `k -> d` and return `d`.| | **Removals:** | | From 8a7f949c136b009e7b9a17c944076a5f5331bb9b Mon Sep 17 00:00:00 2001 From: Ivan Mashonskii <ivan.mashonsky@gmail.com> Date: Thu, 4 Jul 2024 14:32:48 +0300 Subject: [PATCH 2868/3075] Update seqs.md --- _overviews/collections-2.13/seqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/seqs.md b/_overviews/collections-2.13/seqs.md index a5fe562ad5..c319fba5ba 100644 --- a/_overviews/collections-2.13/seqs.md +++ b/_overviews/collections-2.13/seqs.md @@ -103,7 +103,7 @@ Two often used implementations of buffers are `ListBuffer` and `ArrayBuffer`. A | ------ | ------ | | **Additions:** | | | `buf.append(x)`<br>or `buf += x` |Appends element `x` to buffer, and returns `buf` itself as result.| -| `buf.appendAll(xs)`<br>or`buf ++= xs` |Appends all elements in `xs` to buffer.| +| `buf.appendAll(xs)`<br>or `buf ++= xs` |Appends all elements in `xs` to buffer.| | `buf.prepend(x)`<br>or `x +=: buf` |Prepends element `x` to buffer.| | `buf.prependAll(xs)`<br>or `xs ++=: buf` |Prepends all elements in `xs` to buffer.| | `buf.insert(i, x)` |Inserts element `x` at index `i` in buffer.| From 95b599d368d6c47698ed398e0182ae3fba0c80a8 Mon Sep 17 00:00:00 2001 From: Ivan Mashonskii <ivan.mashonsky@gmail.com> Date: Thu, 4 Jul 2024 14:33:30 +0300 Subject: [PATCH 2869/3075] Update seqs.md --- _overviews/collections-2.13/seqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/seqs.md b/_overviews/collections-2.13/seqs.md index c319fba5ba..cabd0b8a0a 100644 --- a/_overviews/collections-2.13/seqs.md +++ b/_overviews/collections-2.13/seqs.md @@ -103,7 +103,7 @@ Two often used implementations of buffers are `ListBuffer` and `ArrayBuffer`. A | ------ | ------ | | **Additions:** | | | `buf.append(x)`<br>or `buf += x` |Appends element `x` to buffer, and returns `buf` itself as result.| -| `buf.appendAll(xs)`<br>or `buf ++= xs` |Appends all elements in `xs` to buffer.| +| `buf.appendAll(xs)`<br>or `buf ++= xs` |Appends all elements in `xs` to buffer.| | `buf.prepend(x)`<br>or `x +=: buf` |Prepends element `x` to buffer.| | `buf.prependAll(xs)`<br>or `xs ++=: buf` |Prepends all elements in `xs` to buffer.| | `buf.insert(i, x)` |Inserts element `x` at index `i` in buffer.| From cba80422e3234d0fdee6c0f595470480c9f78811 Mon Sep 17 00:00:00 2001 From: Aleksey Troitskiy <road21@users.noreply.github.com> Date: Thu, 2 May 2024 16:49:57 +0300 Subject: [PATCH 2870/3075] Fix illegal type of expr in scala3 macros overview --- _overviews/scala3-macros/tutorial/macros.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/macros.md b/_overviews/scala3-macros/tutorial/macros.md index 0768813b48..52c7a725d8 100644 --- a/_overviews/scala3-macros/tutorial/macros.md +++ b/_overviews/scala3-macros/tutorial/macros.md @@ -290,7 +290,7 @@ Note, that `matches` only performs a limited amount of normalization and while f ### Arbitrary Expressions Last but not least, it is possible to create an `Expr[T]` from arbitary Scala code by enclosing it in [quotes][quotes]. -For example, `'{ ${expr}; true }` will generate an `Expr[Int]` equivalent to `Expr.block(List(expr), Expr(true))`. +For example, `'{ ${expr}; true }` will generate an `Expr[Boolean]` equivalent to `Expr.block(List(expr), Expr(true))`. The subsequent section on [Quoted Code][quotes] presents quotes in more detail. [contributing]: {% link scala3/contribute-to-docs.md %} From bd56990e9e02d41df303c5b9bf78b35532e8fe7e Mon Sep 17 00:00:00 2001 From: Maciej Gorywoda <maciej.gorywoda@jetbrains.com> Date: Wed, 17 Jul 2024 19:23:03 +0200 Subject: [PATCH 2871/3075] A new page about Scala IDEs + reordering of Getting Started --- _data/doc-nav-header.yml | 7 ++- .../{index.md => install-scala.md} | 3 +- _overviews/getting-started/scala-ides.md | 45 ++++++++++++++++++ index.md | 2 +- .../images/getting-started/IntelliJScala.png | Bin 0 -> 582018 bytes .../images/getting-started/VSCodeMetals.png | Bin 0 -> 693496 bytes 6 files changed, 53 insertions(+), 4 deletions(-) rename _overviews/getting-started/{index.md => install-scala.md} (98%) create mode 100644 _overviews/getting-started/scala-ides.md create mode 100644 resources/images/getting-started/IntelliJScala.png create mode 100644 resources/images/getting-started/VSCodeMetals.png diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index 9c2c921667..4f2bbd82cf 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -1,5 +1,10 @@ - title: Getting Started - url: "/getting-started/index.html" + url: "#" + submenu: + - title: Install Scala + url: "/getting-started/install-scala.html" + - title: Scala IDEs + url: "/getting-started/scala-ides.html" - title: Scala 3 url: "#" submenu: diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/install-scala.md similarity index 98% rename from _overviews/getting-started/index.md rename to _overviews/getting-started/install-scala.md index 8c33b915dd..9eba9da32f 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/install-scala.md @@ -184,8 +184,7 @@ and in the official sbt [documentation](https://www.scala-sbt.org/1.x/docs/index ### With an IDE -You can skip the rest of this page and go directly to [Building a Scala Project with IntelliJ and sbt](/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.html) - +You can read a short summary of Scala IDEs on [a dedicated page](/getting-started/scala-ides.html) ## Open hello-world project diff --git a/_overviews/getting-started/scala-ides.md b/_overviews/getting-started/scala-ides.md new file mode 100644 index 0000000000..d8d7a32a2d --- /dev/null +++ b/_overviews/getting-started/scala-ides.md @@ -0,0 +1,45 @@ +--- +layout: singlepage-overview +title: Scala IDEs + +partof: scala-ides + +permalink: /tutorials/:title.html + +keywords: +- Scala +- IDE +- JetBrains +- IntelliJ +- VSCode +- Metals +--- + +By Maciej Gorywoda + +## Introduction + +Theoretically, you can write Scala code even in a notepad and compile and run the code from the terminal. When you do it, the compiler will tell you if it encounters any problems and suggest changes. You can apply that feedback in the notepad and try again. + +However, this way of software development will quickly prove to be unusable when you start coding anything more complicated than simple exercises. For larger projects, we highly recommend that you use one of the following IDEs (Integrated Development Environments): + +# IntelliJ IDEA + Scala Plugin + +[https://jetbrains.com/scala](https://jetbrains.com/scala) + +![](../../resources/images/getting-started/IntelliJScala.png) + +IntelliJ IDEA is a cross-platform IDE developed by JetBrains that provides a consistent experience for a wide range of programming languages and technologies. It also supports Scala through the IntelliJ Scala Plugin, which is being developed at JetBrains. First, install IntelliJ IDEA Community Edition (unless you don't already use the Ultimate edition) and then add the IntelliJ Scala Plugin. + +IntelliJ IDEA and Scala Plugin will assist you in virtually every part of a Scala software developer's work. Use it if you like a solid integrated experience, sane default settings, and tested solutions. + +For more information, check out our tutorial [Getting Started with Scala in IntelliJ](/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.html) + +# Visual Studio Code + Metals + +[https://scalameta.org/metals](https://scalameta.org/metals) + +![](../../resources/images/getting-started/VSCodeMetals.png) + +Visual Studio Code, commonly called VS Code, is a source code editor developed by Microsoft. Similar to how IntelliJ IDEA requires IntelliJ Scala Plugin to support Scala, you can get support for Scala in VS Code by installing an extension: Metals by Scalameta. In contrast to IntelliJ IDEA + Scala Plugin, VS Code + Metals is aimed at people who like to tinker with settings and try out experimental Scala features. Besides, Metals - the extension - is also available for a variety of other source-code editors, such as Vim, Sublime Text, and Emacs, which means that you will get a similar experience in any of them. + diff --git a/index.md b/index.md index fc46058513..22cbc790cc 100644 --- a/index.md +++ b/index.md @@ -17,7 +17,7 @@ sections: - title: "Getting Started" description: "Install Scala on your computer and start writing some Scala code!" icon: "fa fa-rocket" - link: /getting-started.html + link: /getting-started/install-scala.html - title: "Tour of Scala" description: "Bite-sized introductions to core language features." icon: "fa fa-flag" diff --git a/resources/images/getting-started/IntelliJScala.png b/resources/images/getting-started/IntelliJScala.png new file mode 100644 index 0000000000000000000000000000000000000000..c567da38df62bcf32b451b6ada8c34db04b3233b GIT binary patch literal 582018 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ℜ_W#rX>C%kVK&O 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�b;NtSmu6 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%0AOfwF=c0OuEQWorGl%y&DTwWWp?BeA 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 JCm*`3?-qy5R)F4>=5J@t?H$ch>fuv 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�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 B-JJjc literal 0 HcmV?d00001 diff --git a/resources/images/getting-started/VSCodeMetals.png b/resources/images/getting-started/VSCodeMetals.png new file mode 100644 index 0000000000000000000000000000000000000000..bdc50907266bf489dfe36cc429ebae204452d885 GIT binary patch literal 693496 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≠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 z%0A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⪼n5D!@66=bHZ-~c`t(oNN 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%0AaT0iTpgwqi<SnEOgeC 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%0DYuG;3}3z*$1NOUy!)u}R;9q8weRs+$G(7TR5ty# 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%0ApI0$~3@*B>! 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 literal 0 HcmV?d00001 From 1f6add369fd34cfa7544f98176b06a15795f2cb9 Mon Sep 17 00:00:00 2001 From: Maciej Gorywoda <maciej.gorywoda@jetbrains.com> Date: Wed, 17 Jul 2024 20:04:53 +0200 Subject: [PATCH 2872/3075] [Getting Started / Scala IDEs] fixing links --- _overviews/scala3-book/taste-intro.md | 2 +- _ru/scala3/book/taste-intro.md | 2 +- _zh-cn/overviews/scala3-book/taste-intro.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/taste-intro.md b/_overviews/scala3-book/taste-intro.md index 4820bdfe26..72f74faeed 100644 --- a/_overviews/scala3-book/taste-intro.md +++ b/_overviews/scala3-book/taste-intro.md @@ -23,4 +23,4 @@ can be installed by following our [getting started guide][get-started]. [reference]: {{ site.scala3ref }}/overview.html -[get-started]: {% link _overviews/getting-started/index.md %} +[get-started]: {% link _overviews/getting-started/install-scala.md %} diff --git a/_ru/scala3/book/taste-intro.md b/_ru/scala3/book/taste-intro.md index 74f5996a5b..58e15d8e22 100644 --- a/_ru/scala3/book/taste-intro.md +++ b/_ru/scala3/book/taste-intro.md @@ -28,4 +28,4 @@ next-page: taste-hello-world [reference]: {{ site.scala3ref }}/overview.html -[get-started]: {% link _overviews/getting-started/index.md %} +[get-started]: {% link _overviews/getting-started/install-scala.md %} diff --git a/_zh-cn/overviews/scala3-book/taste-intro.md b/_zh-cn/overviews/scala3-book/taste-intro.md index 1c0a5a6c3d..0d2f0fdf50 100644 --- a/_zh-cn/overviews/scala3-book/taste-intro.md +++ b/_zh-cn/overviews/scala3-book/taste-intro.md @@ -24,4 +24,4 @@ permalink: "/zh-cn/scala3/book/:title.html" > 或者，您可以使用 [Scastie](https://scastie.scala-lang.org) 在 Web 浏览器中运行这些示例，这是一个完全在线的编辑器和 Scala 的代码运行器。 [reference]: {{ site.scala3ref }}/overview.html -[get-started]: {% link _overviews/getting-started/index.md %} +[get-started]: {% link _overviews/getting-started/install-scala.md %} From 1a79116fdd512a23bc6d7e39453e4c6fc35caca4 Mon Sep 17 00:00:00 2001 From: Daan Dvl <143799110+ddvleeuwen@users.noreply.github.com> Date: Thu, 25 Jul 2024 10:42:35 +0200 Subject: [PATCH 2873/3075] Remove "-Xno-uescape" from compiler-options.yml --- _data/compiler-options.yml | 4 ---- 1 file changed, 4 deletions(-) diff --git a/_data/compiler-options.yml b/_data/compiler-options.yml index 0490b25127..67b898f1d8 100644 --- a/_data/compiler-options.yml +++ b/_data/compiler-options.yml @@ -469,10 +469,6 @@ schema: type: "Boolean" description: "Don't perform exhaustivity/unreachability analysis. Also, ignore @switch annotation." - - option: "-Xno-uescape" - schema: - type: "Boolean" - description: "Disable handling of \\u unicode escapes." - option: "-Xnojline" schema: type: "Boolean" From b38448062ddbb3a9d5c3fb9c472440da8096d21b Mon Sep 17 00:00:00 2001 From: Brian Wignall <BrianWignall@gmail.com> Date: Thu, 25 Jul 2024 07:26:02 -0400 Subject: [PATCH 2874/3075] Remove references to java.util.Date (#3029) --- _overviews/core/implicit-classes.md | 2 +- _style/scaladoc.md | 2 +- _zh-cn/overviews/core/implicit-classes.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/core/implicit-classes.md b/_overviews/core/implicit-classes.md index eca05c593d..ed141370c6 100644 --- a/_overviews/core/implicit-classes.md +++ b/_overviews/core/implicit-classes.md @@ -77,7 +77,7 @@ Implicit classes have the following restrictions: **2. They may only take one non-implicit argument in their constructor.** - implicit class RichDate(date: java.util.Date) // OK! + implicit class RichDate(date: java.time.LocalDate) // OK! implicit class Indexer[T](collection: Seq[T], index: Int) // BAD! implicit class Indexer[T](collection: Seq[T])(implicit index: Index) // OK! diff --git a/_style/scaladoc.md b/_style/scaladoc.md index 7a78bd713f..12dc9528a5 100644 --- a/_style/scaladoc.md +++ b/_style/scaladoc.md @@ -208,7 +208,7 @@ sure to indicate the actual method names: * @return a new Person instance with the age determined by the * birthdate and current date. */ - def apply(name: String, birthDate: java.util.Date) = {} + def apply(name: String, birthDate: java.time.LocalDate) = {} } If your object holds implicit conversions, provide an example in the diff --git a/_zh-cn/overviews/core/implicit-classes.md b/_zh-cn/overviews/core/implicit-classes.md index 6999f419aa..e7ec62cad1 100644 --- a/_zh-cn/overviews/core/implicit-classes.md +++ b/_zh-cn/overviews/core/implicit-classes.md @@ -61,7 +61,7 @@ Scala 2.10引入了一种叫做隐式类的新特性。隐式类指的是用impl 2. 构造函数只能携带一个非隐式参数。 ```` - implicit class RichDate(date: java.util.Date) // 正确！ + implicit class RichDate(date: java.time.LocalDate) // 正确！ implicit class Indexer[T](collecton: Seq[T], index: Int) // 错误！ implicit class Indexer[T](collecton: Seq[T])(implicit index: Index) // 正确！ ```` From 81ef285289550495d8e70d6d624b78d59be30a2f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sergen=20=C3=87epo=C4=9Flu?= <dev.csgn@gmail.com> Date: Fri, 26 Jul 2024 10:46:09 +0300 Subject: [PATCH 2875/3075] Update tooling-syntax-rewriting.md (#3047) --- _overviews/scala3-migration/tooling-syntax-rewriting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/tooling-syntax-rewriting.md b/_overviews/scala3-migration/tooling-syntax-rewriting.md index 9ce122c1a0..5cd51e0cc7 100644 --- a/_overviews/scala3-migration/tooling-syntax-rewriting.md +++ b/_overviews/scala3-migration/tooling-syntax-rewriting.md @@ -52,7 +52,7 @@ Each of the first four options corresponds to a specific syntax: | Syntax | Compiler Option | |-|-| | Significant Indentation | `-indent` | -| Classical Braces | `-noindent` | +| Classical Braces | `-no-indent` | As we will see in further detail these options can be used in combination with the `-rewrite` option to automate the conversion to a particular syntax. From c2dceed075306c842c92a956331ac18020147148 Mon Sep 17 00:00:00 2001 From: fengyi_ling <fengyi_ling@qq.com> Date: Mon, 5 Aug 2024 15:53:53 +0800 Subject: [PATCH 2876/3075] Update scala-for-java-programmers.md: Rename `l` to `left` for clarity The variable `l` was misleadingly similar to the constant `1` on the website, causing 30 minutes of confusion before realizing it was an alphabet 'L'. Renaming to `left` for the left sub-tree representation enhances readability and eliminates potential ambiguity. --- .../tutorials/scala-for-java-programmers.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index bc4a551d91..7da45df6c6 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -649,7 +649,7 @@ they can be used to define the type of the trees for our example: ```scala abstract class Tree object Tree { - case class Sum(l: Tree, r: Tree) extends Tree + case class Sum(left: Tree, right: Tree) extends Tree case class Var(n: String) extends Tree case class Const(v: Int) extends Tree } @@ -682,7 +682,7 @@ but also to implement ADTs. Here is how they can be used to define the type of the trees for our example: ```scala enum Tree: - case Sum(l: Tree, r: Tree) + case Sum(left: Tree, right: Tree) case Var(n: String) case Const(v: Int) ``` @@ -750,7 +750,7 @@ Scala as follows, using a pattern match on a tree value `t`: import Tree._ def eval(t: Tree, ev: Environment): Int = t match { - case Sum(l, r) => eval(l, ev) + eval(r, ev) + case Sum(left, right) => eval(left, ev) + eval(right, ev) case Var(n) => ev(n) case Const(v) => v } @@ -762,7 +762,7 @@ def eval(t: Tree, ev: Environment): Int = t match { import Tree.* def eval(t: Tree, ev: Environment): Int = t match - case Sum(l, r) => eval(l, ev) + eval(r, ev) + case Sum(left, right) => eval(left, ev) + eval(right, ev) case Var(n) => ev(n) case Const(v) => v ``` @@ -773,12 +773,12 @@ def eval(t: Tree, ev: Environment): Int = t match You can understand the precise meaning of the pattern match as follows: 1. it first checks if the tree `t` is a `Sum`, and if it - is, it binds the left sub-tree to a new variable called `l` and - the right sub-tree to a variable called `r`, and then proceeds + is, it binds the left sub-tree to a new variable called `left` and + the right sub-tree to a variable called `right`, and then proceeds with the evaluation of the expression following the arrow; this expression can (and does) make use of the variables bound by the - pattern appearing on the left of the arrow, i.e., `l` and - `r`, + pattern appearing on the left of the arrow, i.e., `left` and + `right`, 2. if the first check does not succeed, that is, if the tree is not a `Sum`, it goes on and checks if `t` is a `Var`; if it is, it binds the name contained in the `Var` node to a @@ -841,7 +841,7 @@ obtain the following definition: import Tree._ def derive(t: Tree, v: String): Tree = t match { - case Sum(l, r) => Sum(derive(l, v), derive(r, v)) + case Sum(left, right) => Sum(derive(left, v), derive(right, v)) case Var(n) if v == n => Const(1) case _ => Const(0) } @@ -853,7 +853,7 @@ def derive(t: Tree, v: String): Tree = t match { import Tree.* def derive(t: Tree, v: String): Tree = t match - case Sum(l, r) => Sum(derive(l, v), derive(r, v)) + case Sum(left, right) => Sum(derive(left, v), derive(right, v)) case Var(n) if v == n => Const(1) case _ => Const(0) ``` From c6c7578e7cbf7a280490293998545c69e7b1401f Mon Sep 17 00:00:00 2001 From: Maciej Gorywoda <makingthematrix@gmail.com> Date: Thu, 8 Aug 2024 13:18:49 +0200 Subject: [PATCH 2877/3075] Update _overviews/getting-started/scala-ides.md Co-authored-by: Tomasz Godzik <tgodzik@users.noreply.github.com> --- _overviews/getting-started/scala-ides.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/getting-started/scala-ides.md b/_overviews/getting-started/scala-ides.md index d8d7a32a2d..c8ddc2a20c 100644 --- a/_overviews/getting-started/scala-ides.md +++ b/_overviews/getting-started/scala-ides.md @@ -41,5 +41,5 @@ For more information, check out our tutorial [Getting Started with Scala in Inte ![](../../resources/images/getting-started/VSCodeMetals.png) -Visual Studio Code, commonly called VS Code, is a source code editor developed by Microsoft. Similar to how IntelliJ IDEA requires IntelliJ Scala Plugin to support Scala, you can get support for Scala in VS Code by installing an extension: Metals by Scalameta. In contrast to IntelliJ IDEA + Scala Plugin, VS Code + Metals is aimed at people who like to tinker with settings and try out experimental Scala features. Besides, Metals - the extension - is also available for a variety of other source-code editors, such as Vim, Sublime Text, and Emacs, which means that you will get a similar experience in any of them. +Visual Studio Code, commonly called VS Code, is a source code editor developed by Microsoft. Similar to how IntelliJ IDEA requires IntelliJ Scala Plugin to support Scala, you can get support for Scala in VS Code by installing an extension: Metals by Scalameta. In contrast to IntelliJ IDEA + Scala Plugin, VS Code + Metals is is aimed at people who like to get feedback and code intelligence straight from the compiler, which enables them to also try out experimental Scala features. Besides, Metals - as an [language server](https://microsoft.github.io/language-server-protocol/) - is also available to use with a variety of other source-code editors, such as Vim, Sublime Text, Zed, Helix and Emacs, which means that you will get a similar experience in any of them. From 235888efda85bb68b59e27ea2deb441116f2fb87 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 8 Aug 2024 19:52:37 -0700 Subject: [PATCH 2878/3075] compiler plugins page: fix a 404 Mill link (#3054) --- _overviews/plugins/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/plugins/index.md b/_overviews/plugins/index.md index ccbdad19e0..42cc5c9309 100644 --- a/_overviews/plugins/index.md +++ b/_overviews/plugins/index.md @@ -268,12 +268,12 @@ object foo extends ScalaModule { ``` Please notice, that compiler plugins are typically bound to the full -version of the compiler, hence you have to use the `:::` (instead of -normal `::`) between the organization and the artifact name, +version of the compiler, hence you have to use the `:::` (instead of +normal `::`) between the organization and the artifact name, to declare your dependency. For more information about plugin usage in Mill, please refer to the -[Mill documentation](https://com-lihaoyi.github.io/mill/mill/Configuring_Mill.html#_scala_compiler_plugins). +[Mill documentation](http://mill-build.org/mill/Scala_Module_Config.html#_scala_compiler_plugins). ## Developing compiler plugins with an IDE From 59460f2760218f2f53e37f50391bab78e54e2325 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 8 Aug 2024 17:03:29 -0700 Subject: [PATCH 2879/3075] rewrite style guide entry on `foo` vs `foo()` --- _style/naming-conventions.md | 58 ++++++++++++++++-------------------- 1 file changed, 25 insertions(+), 33 deletions(-) diff --git a/_style/naming-conventions.md b/_style/naming-conventions.md index 1e796b4145..d72278162c 100644 --- a/_style/naming-conventions.md +++ b/_style/naming-conventions.md @@ -195,44 +195,36 @@ getter and setter. For example: ### Parentheses -Unlike Ruby, Scala attaches significance to whether or not a method is -*declared* with parentheses (only applicable to methods of -[arity](https://en.wikipedia.org/wiki/Arity)-0). For example: +Scala allows a parameterless, zero-[arity](https://en.wikipedia.org/wiki/Arity) +method to be declared with an empty parameter list: def foo1() = ... +or with no parameter lists at all: + def foo2 = ... -These are different methods at compile-time. While `foo1` can be called -with or without the parentheses, `foo2` *may not* be called *with* -parentheses. - -Thus, it is actually quite important that proper guidelines be observed -regarding when it is appropriate to declare a method without parentheses -and when it is not. - -Methods which act as accessors of any sort (either encapsulating a field -or a logical property) should be declared *without* parentheses except -if they have side effects. While Ruby and Lift use a `!` to indicate -this, the usage of parens is preferred (please note that fluid APIs and -internal domain-specific languages have a tendency to break the -guidelines given below for the sake of syntax. Such exceptions should -not be considered a violation so much as a time when these rules do not -apply. In a DSL, syntax should be paramount over convention). - -Further, the callsite should follow the declaration; if declared with -parentheses, call with parentheses. While there is temptation to save a -few characters, if you follow this guideline, your code will be *much* -more readable and maintainable. - - // doesn't change state, call as birthdate - def birthdate = firstName - - // updates our internal state, call as age() - def age() = { - _age = updateAge(birthdate) - _age - } +By convention, parentheses are used to indicate that a method has +side effects. + +On the other hand, the absence of parentheses indicates that a +method is like an accessor: it returns a value without altering the +receiver, and on the same receiver in the same state, it always +returns the same answer. + +The callsite should follow the declaration; if declared with +parentheses, call with parentheses. + +These conventions are followed in the Scala standard library and +you should follow them in your own code as well. + +Additional notes: + +* Scala 3 errors if you leave out the parentheses at the call site. Scala 2 merely warns. +* Scala 3 and 2 both error if the call site has parentheses where the definition doesn't. +* Java-defined methods are exempt from this distinction and may be called either way. +* If a method _does_ take parameters, there isn't any convention for indicating whether it also has side effects. +* Creating an object isn't considered a side effect. So for example, Scala collections have an `iterator` method with no parens. Yes, you get a new iterator each time. And yes, iterators are mutable. But every fresh iterator is the same until it has been altered by calling a side-effecting method such as `Iterator#next()`, which _is_ declared with parentheses. See this [2018 design discussion](https://github.com/scala/collection-strawman/issues/520). ### Symbolic Method Names From bc1a682bd2c9317909c8e89a4097399d44dc9720 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 8 Aug 2024 16:30:49 -0700 Subject: [PATCH 2880/3075] add Scala FAQ entry about nilary vs nullary methods --- _overviews/FAQ/index.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 00f52f41ac..7d3966986e 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -273,6 +273,15 @@ for multiple reasons, most notoriously For an in-depth treatment of types vs. classes, see the blog post ["There are more types than classes"](https://typelevel.org/blog/2017/02/13/more-types-than-classes.html). +### Should I declare my parameterless method with or without parentheses? + +In other words, should one write `def foo()` or just `def foo`? + +Answer: by convention, the former is used to indicate that a method +has side effects. + +For more details, see the Scala Style Guide, [here](https://docs.scala-lang.org/style/naming-conventions.html#parentheses). + ### How can a method in a superclass return a value of the “current” type? First, note that using `this.type` won't work. People often try that, From b91f2a920a59631d66b23e8dbe6651e80d074570 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Thu, 8 Aug 2024 19:56:07 -0700 Subject: [PATCH 2881/3075] in Toolkit sbt example, use flat single-project style --- _includes/_markdown/install-munit.md | 5 +++-- _includes/_markdown/install-os-lib.md | 2 +- _includes/_markdown/install-sttp.md | 2 +- _includes/_markdown/install-upickle.md | 2 +- _overviews/toolkit/testing-run-only.md | 2 +- _overviews/toolkit/testing-run.md | 4 ++-- 6 files changed, 9 insertions(+), 8 deletions(-) diff --git a/_includes/_markdown/install-munit.md b/_includes/_markdown/install-munit.md index 246716a112..853d18e230 100644 --- a/_includes/_markdown/install-munit.md +++ b/_includes/_markdown/install-munit.md @@ -16,13 +16,14 @@ Alternatively, you can require just a specific version of MUnit: {% tab 'sbt' %} In your build.sbt file, you can add the dependency on toolkit-test: ```scala -lazy val example = project.in(file("example")) +lazy val example = project.in(file(".")) .settings( scalaVersion := "3.3.3", libraryDependencies += "org.scala-lang" %% "toolkit-test" % "0.1.7" % Test ) ``` -Here the `Test` configuration means that the dependency is only used by the source files in `example/src/test`. + +Here the `Test` configuration means that the dependency is only used by the source files in `src/test`. Alternatively, you can require just a specific version of MUnit: ```scala diff --git a/_includes/_markdown/install-os-lib.md b/_includes/_markdown/install-os-lib.md index 28bd2ae5e6..c35388e0a3 100644 --- a/_includes/_markdown/install-os-lib.md +++ b/_includes/_markdown/install-os-lib.md @@ -15,7 +15,7 @@ Alternatively, you can require just a specific version of OS-Lib: {% tab 'sbt' %} In your `build.sbt`, you can add a dependency on the toolkit: ```scala -lazy val example = project.in(file("example")) +lazy val example = project.in(file(".")) .settings( scalaVersion := "3.3.3", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" diff --git a/_includes/_markdown/install-sttp.md b/_includes/_markdown/install-sttp.md index 4a2b0f117b..43ad70f7d9 100644 --- a/_includes/_markdown/install-sttp.md +++ b/_includes/_markdown/install-sttp.md @@ -15,7 +15,7 @@ Alternatively, you can require just a specific version of sttp: {% tab 'sbt' %} In your build.sbt file, you can add a dependency on the Toolkit: ```scala -lazy val example = project.in(file("example")) +lazy val example = project.in(file(".")) .settings( scalaVersion := "3.3.3", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" diff --git a/_includes/_markdown/install-upickle.md b/_includes/_markdown/install-upickle.md index 26e6ecd5b4..58f3e23c9c 100644 --- a/_includes/_markdown/install-upickle.md +++ b/_includes/_markdown/install-upickle.md @@ -15,7 +15,7 @@ Alternatively, you can require just a specific version of UPickle: {% tab 'sbt' %} In your build.sbt file, you can add the dependency on the Toolkit: ```scala -lazy val example = project.in(file("example")) +lazy val example = project.in(file(".")) .settings( scalaVersion := "3.3.3", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" diff --git a/_overviews/toolkit/testing-run-only.md b/_overviews/toolkit/testing-run-only.md index fcd56fde3c..1469fbd577 100644 --- a/_overviews/toolkit/testing-run-only.md +++ b/_overviews/toolkit/testing-run-only.md @@ -22,7 +22,7 @@ scala-cli test example --test-only example.MyTests {% tab 'sbt' %} To run a single `example.MyTests` suite in sbt, use the `testOnly` task: ``` -sbt:example> example/testOnly example.MyTests +sbt:example> testOnly example.MyTests ``` {% endtab %} {% tab 'Mill' %} diff --git a/_overviews/toolkit/testing-run.md b/_overviews/toolkit/testing-run.md index 12b0871289..09bc23e73a 100644 --- a/_overviews/toolkit/testing-run.md +++ b/_overviews/toolkit/testing-run.md @@ -27,7 +27,7 @@ scala-cli test example {% tab 'sbt' %} In the sbt shell, the following command runs all the tests of the project `example`: ``` -sbt:example> example/test +sbt:example> test # MyTests: # + sum of two integers 0.006s # [info] Passed: Total 1, Failed 0, Errors 0, Passed 1 @@ -74,7 +74,7 @@ test("failing test") { ``` # MyTests: # + sum of two integers 0.008s -# ==> X MyTests.failing test 0.015s munit.ComparisonFailException: ./example/MyTests.test.scala:13 +# ==> X MyTests.failing test 0.015s munit.ComparisonFailException: ./MyTests.test.scala:13 # 12: val expected = 4 # 13: assertEquals(obtained, expected) # 14: } From 2e1a8d7cb70319835709283b1525352bcfd2d1da Mon Sep 17 00:00:00 2001 From: Tobias Roeser <le.petit.fou@web.de> Date: Mon, 12 Aug 2024 18:28:12 +0200 Subject: [PATCH 2882/3075] Update link to Mill documentation (#3057) --- _overviews/plugins/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/plugins/index.md b/_overviews/plugins/index.md index 42cc5c9309..0b1ea54d55 100644 --- a/_overviews/plugins/index.md +++ b/_overviews/plugins/index.md @@ -273,7 +273,7 @@ normal `::`) between the organization and the artifact name, to declare your dependency. For more information about plugin usage in Mill, please refer to the -[Mill documentation](http://mill-build.org/mill/Scala_Module_Config.html#_scala_compiler_plugins). +[Mill documentation for Scala compiler plugins](https://mill-build.org/mill/Scala_Module_Config.html#_scala_compiler_plugins). ## Developing compiler plugins with an IDE From 2f89e7c98a6814374f3ddbec999ea9955cc0d793 Mon Sep 17 00:00:00 2001 From: Maciej Gorywoda <maciej.gorywoda@jetbrains.com> Date: Wed, 14 Aug 2024 12:50:25 +0200 Subject: [PATCH 2883/3075] [Getting Started / Scala IDEs] removing the author tag --- _overviews/getting-started/scala-ides.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/_overviews/getting-started/scala-ides.md b/_overviews/getting-started/scala-ides.md index c8ddc2a20c..b01e8d14ba 100644 --- a/_overviews/getting-started/scala-ides.md +++ b/_overviews/getting-started/scala-ides.md @@ -15,8 +15,6 @@ keywords: - Metals --- -By Maciej Gorywoda - ## Introduction Theoretically, you can write Scala code even in a notepad and compile and run the code from the terminal. When you do it, the compiler will tell you if it encounters any problems and suggest changes. You can apply that feedback in the notepad and try again. From 017ae539e43e7ff78eaf3fc890bf2a3eac2b9c5a Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 14 Aug 2024 14:59:06 -0700 Subject: [PATCH 2884/3075] adjustment from review feedback --- _style/naming-conventions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_style/naming-conventions.md b/_style/naming-conventions.md index d72278162c..7cdbc493fb 100644 --- a/_style/naming-conventions.md +++ b/_style/naming-conventions.md @@ -205,7 +205,7 @@ or with no parameter lists at all: def foo2 = ... By convention, parentheses are used to indicate that a method has -side effects. +side effects, such as altering the receiver. On the other hand, the absence of parentheses indicates that a method is like an accessor: it returns a value without altering the From e240bcca20f7e584132b1395a6e6eaf0accbb18a Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Mon, 19 Aug 2024 08:27:49 +0000 Subject: [PATCH 2885/3075] Update SIPs state --- _sips/sips/alternative-bind-patterns.md | 7 - _sips/sips/alternative-bind-variables.md | 331 +++++++ _sips/sips/better-fors.md | 381 +++++++ _sips/sips/for-comprehension-improvements.md | 7 - ...xtractors-follow-aliases-and-singletons.md | 7 - _sips/sips/match-types-spec.md | 14 +- ...the-syntax-of-context-bounds-and-givens.md | 7 - _sips/sips/multiple-assignments.md | 332 ++++++- _sips/sips/named-tuples.md | 778 ++++++++++++++- _sips/sips/typeclasses-syntax.md | 685 +++++++++++++ ...ault-arguments-for-binary-compatibility.md | 7 - _sips/sips/unroll-default-arguments.md | 934 ++++++++++++++++++ 12 files changed, 3445 insertions(+), 45 deletions(-) delete mode 100644 _sips/sips/alternative-bind-patterns.md create mode 100644 _sips/sips/alternative-bind-variables.md create mode 100644 _sips/sips/better-fors.md delete mode 100644 _sips/sips/for-comprehension-improvements.md delete mode 100644 _sips/sips/match-types-amendment-extractors-follow-aliases-and-singletons.md delete mode 100644 _sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md create mode 100644 _sips/sips/typeclasses-syntax.md delete mode 100644 _sips/sips/unroll-default-arguments-for-binary-compatibility.md create mode 100644 _sips/sips/unroll-default-arguments.md diff --git a/_sips/sips/alternative-bind-patterns.md b/_sips/sips/alternative-bind-patterns.md deleted file mode 100644 index dd6b1fd861..0000000000 --- a/_sips/sips/alternative-bind-patterns.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-60 - Alternative bind patterns -status: waiting-for-implementation -pull-request-number: 74 -stage: implementation - ---- diff --git a/_sips/sips/alternative-bind-variables.md b/_sips/sips/alternative-bind-variables.md new file mode 100644 index 0000000000..e23c202e91 --- /dev/null +++ b/_sips/sips/alternative-bind-variables.md @@ -0,0 +1,331 @@ +--- +layout: sip +permalink: /sips/:title.html +stage: pre-sip +status: submitted +presip-thread: https://contributors.scala-lang.org/t/pre-sip-bind-variables-for-alternative-patterns/6321/13 +title: SIP-60 - Bind variables within alternative patterns +--- + +**By: Yilin Wei** + +## History + +| Date | Version | +|---------------|--------------------| +| Sep 17th 2023 | Initial Draft | +| Jan 16th 2024 | Amendments | + +## Summary + +Pattern matching is one of the most commonly used features in Scala by beginners and experts alike. Most of +the features of pattern matching compose beautifully — for example, a user who learns about bind variables +and guard patterns can mix the two features intuitively. + +One of the few outstanding cases where this is untrue, is when mixing bind variables and alternative patterns. The part of +current [specification](https://scala-lang.org/files/archive/spec/2.13/08-pattern-matching.html) which we are concerned with is under section **8.1.12** and is copied below, with the relevant clause +highlighted. + +> … All alternative patterns are type checked with the expected type of the pattern. **They may not bind variables other than wildcards**. The alternative … + +We propose that this restriction be lifted and this corner case be eliminated. + +Removing the corner case would make the language easier to teach, reduce friction and allow users to express intent in a more natural manner. + +## Motivation + +## Scenario + +The following scenario is shamelessly stolen from [PEP 636](https://peps.python.org/pep-0636), which introduces pattern matching to the +Python language. + +Suppose a user is writing classic text adventure game such as [Zork](https://en.wikipedia.org/wiki/Zork). For readers unfamiliar with +text adventure games, the player typically enters freeform text into the terminal in the form of commands to interact with the game +world. Examples of commands might be `"pick up rabbit"` or `"open door"`. + +Typically, the commands are tokenized and parsed. After a parsing stage we may end up with a encoding which is similar to the following: + +```scala +enum Word + case Get, North, Go, Pick, Up + case Item(name: String) + + case class Command(words: List[Word]) +``` + +In this encoding, the string `pick up jar`, would be parsed as `Command(List(Pick, Up, Item("jar")))`. + +Once the command is parsed, we want to actually *do* something with the command. With this particular encoding, +we would naturally reach for a pattern match — in the simplest case, we could get away with a single recursive function for +our whole program. + +Suppose we take the simplest example where we want to match on a command like `"north"`. The pattern match consists of +matching on a single stable identifier, `North` and the code would look like this: + +~~~ scala +import Command.* + +def loop(cmd: Command): Unit = + cmd match + case Command(North :: Nil) => // Code for going north +~~~ + +However as we begin play-testing the actual text adventure, we observe that users type `"go north"`. We decide +our program should treat the two distinct commands as synonyms. At this point we would reach for an alternative pattern `|` and +refactor the code like so: + +~~~ scala + case Command(North :: Nil | Go :: North :: Nil) => // Code for going north +~~~ + +This clearly expresses our intent that the two commands map to the same underlying logic. + +Later we decide that we want more complex logic in our game; perhaps allowing the user to pick up +items with a command like `pick up jar`. We would then extend our function with another case, binding the variable `name`: + +~~~ scala + case Command(Pick :: Up :: Item(name) :: Nil) => // Code for picking up items +~~~ + +Again, we might realise through our play-testing that users type `get` as a synonym for `pick up`. After playing around +with alternative patterns, we may reasonably write something like: + +~~~ scala + case Command(Pick :: Up :: Item(name) :: Nil | Get :: Item(name) :: Nil) => // Code for picking up items +~~~ + +Unfortunately at this point, we are stopped in our tracks by the compiler. The bind variable for `name` cannot be used in conjunction with alternative patterns. +We must either choose a different encoding. We carefully consult the specification and that this is not possible. + +We can, of course, work around it by hoisting the logic to a helper function to the nearest scope which function definitions: + +~~~ scala +def loop(cmd: Cmd): Unit = + def pickUp(item: String): Unit = // Code for picking up item + cmd match + case Command(Pick :: Up :: Item(name)) => pickUp(name) + case Command(Get :: Item(name)) => pickUp(name) +~~~ + +Or any number of different encodings. However, all of them are less intuitive and less obvious than the code we tried to write. + +## Commentary + +Removing the restriction leads to more obvious encodings in the case of alternative patterns. Arguably, the language +would be simpler and easier to teach — we do not have to remember that bind patterns and alternatives +do not mix and need to teach newcomers the workarounds. + +For languages which have pattern matching, a significant number also support the same feature. Languages such as [Rust](https://github.com/rust-lang/reference/pull/957) and [Python](https://peps.python.org/pep-0636/#or-patterns) have +supported it for some time. While +this is not a great reason for Scala to do the same, having the feature exist in other languages means that users +that are more likely to expect the feature. + +A smaller benefit for existing users, is that removing the corner case leads to code which is +easier to review; the absolute code difference between adding a bind variable within an alternative versus switching to a different +encoding entirely is smaller and conveys the intent of such changesets better. + +It is acknowledged, however, that such cases where we share the same logic with an alternative branches are relatively rare compared to +the usage of pattern matching in general. The current restrictions are not too arduous to workaround for experienced practitioners, which +can be inferred from the relatively low number of comments from the original [issue](https://github.com/scala/bug/issues/182) first raised in 2007. + +To summarize, the main arguments for the proposal are to make the language more consistent, simpler and easier to teach. The arguments +against a change are that it will be low impact for the majority of existing users. + +## Proposed solution + +Removing the alternative restriction means that we need to specify some additional constraints. Intuitively, we +need to consider the restrictions on variable bindings within each alternative branch, as well as the types inferred +for each binding within the scope of the pattern. + +## Bindings + +The simplest case of mixing an alternative pattern and bind variables, is where we have two `UnApply` methods, with +a single alternative pattern. For now, we specifically only consider the case where each bind variable is of the same +type, like so: + +~~~ scala +enum Foo: + case Bar(x: Int) + case Baz(y: Int) + + def fun = this match + case Bar(z) | Baz(z) => ... // z: Int +~~~ + +For the expression to make sense with the current semantics around pattern matches, `z` must be defined in both branches; otherwise the +case body would be nonsensical if `z` was referenced within it (see [missing variables](#missing-variables) for a proposed alternative). + +Removing the restriction would also allow recursive alternative patterns: + +~~~ scala +enum Foo: + case Bar(x: Int) + case Baz(x: Int) + +enum Qux: + case Quux(y: Int) + case Corge(x: Foo) + + def fun = this match + case Quux(z) | Corge(Bar(z) | Baz(z)) => ... // z: Int +~~~ + +Using an `Ident` within an `UnApply` is not the only way to introduce a binding within the pattern scope. +We also expect to be able to use an explicit binding using an `@` like this: + +~~~ scala +enum Foo: + case Bar() + case Baz(bar: Bar) + + def fun = this match + case Baz(x) | x @ Bar() => ... // x: Foo.Bar +~~~ + +## Types + +We propose that the type of each variable introduced in the scope of the pattern be the least upper-bound of the type +inferred within within each branch. + +~~~ scala +enum Foo: + case Bar(x: Int) + case Baz(y: String) + + def fun = this match + case Bar(x) | Baz(x) => // x: Int | String +~~~ + +We do not expect any inference to happen between branches. For example, in the case of a GADT we would expect the second branch of +the following case to match all instances of `Bar`, regardless of the type of `A`. + +~~~ scala +enum Foo[A]: + case Bar(a: A) + case Baz(i: Int) extends Foo[Int] + + def fun = this match + case Baz(x) | Bar(x) => // x: Int | A +~~~ + +### Given bind variables + +It is possible to introduce bindings to the contextual scope within a pattern match branch. + +Since most bindings will be anonymous but be referred to within the branches, we expect the _types_ present in the contextual scope for each branch to be the same rather than the _names_. + +~~~ scala + case class Context() + + def run(using ctx: Context): Unit = ??? + + enum Foo: + case Bar(ctx: Context) + case Baz(i: Int, ctx: Context) + + def fun = this match + case Bar(given Context) | Baz(_, given Context) => run // `Context` appears in both branches +~~~ + +This begs the question of what to do in the case of an explicit `@` binding where the user binds a variable to the same _name_ but to different types. We can either expose a `String | Int` within the contextual scope, or simply reject the code as invalid. + +~~~ scala + enum Foo: + case Bar(s: String) + case Baz(i: Int) + + def fun = this match + case Bar(x @ given String) | Baz(x @ given Int) => ??? +~~~ + +To be consistent with the named bindings, we argue that the code should compile and a contextual variable added to the scope with the type of `String | Int`. + +### Quoted patterns + +[Quoted patterns](https://docs.scala-lang.org/scala3/guides/macros/quotes.html#quoted-patterns) will not be supported in this SIP and the behaviour of quoted patterns will remain the same as currently i.e. any quoted pattern appearing in an alternative pattern binding a variable or type variable will be rejected as illegal. + +### Alternatives + +#### Enforcing a single type for a bound variable + +We could constrain the type for each bound variable within each alternative branch to be the same type. Notably, this is what languages such as Rust, which do not have sub-typing do. + +However, since untagged unions are part of Scala 3 and the fact that both are represented by the `|`, it felt more natural to discard this restriction. + +#### Type ascriptions in alternative branches + +Another suggestion is that an _explicit_ type ascription by a user ought to be defined for all branches. For example, in the currently proposed rules, the following code would infer the return type to be `Int | A` even though the user has written the statement `id: Int`. + +~~~scala +enum Foo[A]: + case Bar[A](a: A) + case Baz[A](a: A) + + def test = this match + case Bar(id: Int) | Baz(id) => id +~~~ + +In the author's subjective opinion, it is more natural to view the alternative arms as separate branches — which would be equivalent to the function below. + +~~~scala +def test = this match + case Bar(id: Int) => id + case Baz(id) => id +~~~ + +On the other hand, if it is decided that each bound variable ought to be the same type, then arguably "sharing" explicit type ascriptions across branches would reduce boilerplate. + +#### Missing variables + +Unlike in other languages, we could assign a type, `A | Null`, to a bind variable which is not present in all of the alternative branches. Rust, for example, is constrained by the fact that the size of a variable must be known and untagged unions do not exist. + +Arguably, missing a variable entirely is more likely to be an error — the absence of a requirement for `var` declarations before assigning variables in Python means that beginners can easily assign variables to the wrong variable. + +It may be, that the enforcement of having to have the same bind variables within each branch ought to be left to a linter rather thana a hard restriction within the language itself. + +## Specification + +We do not believe there are any syntax changes since the current specification already allows the proposed syntax. + +We propose that the following clauses be added to the specification: + +Let $`p_1 | \ldots | p_n`$ be an alternative pattern at an arbitrary depth within a case pattern and $`\Gamma_n`$ is the named scope associated with each alternative. + +If `p_i` is a quoted pattern binding a variable or type variable, the alternative pattern is considered invalid. Otherwise, let the named variables introduced within each alternative $`p_n`$, be $`x_i \in \Gamma_n`$ and the unnamed contextual variables within each alternative have the type $`T_i \in \Gamma_n`$. + +Each $`p_n`$ must introduce the same set of bindings, i.e. for each $`n`$, $`\Gamma_n`$ must have the same **named** members $`\Gamma_{n+1}`$ and the set of $`{T_0, ... T_n}`$ must be the same. + +If $`X_{n,i}`$, is the type of the binding $`x_i`$ within an alternative $`p_n`$, then the consequent type, $`X_i`$, of the +variable $`x_i`$ within the pattern scope, $`\Gamma`$ is the least upper-bound of all the types $`X_{n, i}`$ associated with +the variable, $`x_i`$ within each branch. + +## Compatibility + +We believe the changes would be backwards compatible. + +# Related Work + +The language feature exists in multiple languages. Of the more popular languages, Rust added the feature in [2021](https://github.com/rust-lang/reference/pull/957) and +Python within [PEP 636](https://peps.python.org/pep-0636/#or-patterns), the pattern matching PEP in 2020. Of course, Python is untyped and Rust does not have sub-typing +but the semantics proposed are similar to this proposal. + +Within Scala, the [issue](https://github.com/scala/bug/issues/182) first raised in 2007. The author is also aware of attempts to fix this issue by [Lionel Parreaux](https://github.com/dotty-staging/dotty/compare/main...LPTK:dotty:vars-in-pat-alts) and the associated [feature request](https://github.com/lampepfl/dotty-feature-requests/issues/12) which +was not submitted to the main dotty repository. + +The associated [thread](https://contributors.scala-lang.org/t/pre-sip-bind-variables-for-alternative-patterns/6321) has some extra discussion around semantics. Historically, there have been multiple similar suggestions — in [2023](https://contributors.scala-lang.org/t/qol-sound-binding-in-pattern-alternatives/6226) by Quentin Bernet and in [2021](https://contributors.scala-lang.org/t/could-it-be-possible-to-allow-variable-binging-in-patmat-alternatives-for-scala-3-x/5235) by Alexey Shuksto. + +## Implementation + +The author has a current in-progress implementation focused on the typer which compiles the examples with the expected types. Interested + parties are welcome to see the WIP [here](https://github.com/lampepfl/dotty/compare/main...yilinwei:dotty:main). + +### Further work + +#### Quoted patterns + +More investigation is needed to see how quoted patterns with bind variables in alternative patterns could be supported. + +## Acknowledgements + +Many thanks to **Zainab Ali** for proof-reading the draft, **Nicolas Stucki** and **Guillaume Martres** for their pointers on the dotty +compiler codebase. diff --git a/_sips/sips/better-fors.md b/_sips/sips/better-fors.md new file mode 100644 index 0000000000..b83faf60fc --- /dev/null +++ b/_sips/sips/better-fors.md @@ -0,0 +1,381 @@ +--- +layout: sip +permalink: /sips/:title.html +stage: design +status: submitted +title: SIP-62 - For comprehension improvements +--- + +**By: Kacper Korban (VirtusLab)** + +## History + +| Date | Version | +|---------------|--------------------| +| June 6th 2023 | Initial Draft | +| Feb 15th 2024 | Reviewed Version | + +## Summary + +`for`-comprehensions in Scala 3 improved their usability in comparison to Scala 2, but there are still some pain points relating both usability of `for`-comprehensions and simplicity of their desugaring. + +This SIP tries to address some of those problems, by changing the specification of `for`-comprehensions. From user perspective, the biggest change is allowing aliases at the start of the `for`-comprehensions. e.g. + +``` +for { + x = 1 + y <- Some(2) +} yield x + y +``` + +## Motivation + +There are some clear pain points related to Scala'3 `for`-comprehensions and those can be divided into two categories: + +1. User-facing and code simplicity problems + + Specifically, for the following example written in a Haskell-style do-comprehension + + ```haskell + do + a = largeExpr(arg) + b <- doSth(a) + combineM(a, b) + ``` + in Scala we would have to write + + ```scala + val a = largeExpr(b) + for + b <- doSth(a) + x <- combineM(a, b) + yield x + ``` + + This complicates the code, even in this simple example. +2. The simplicity of desugared code + + The second pain point is that the desugared code of `for`-comprehensions can often be surprisingly complicated. + + e.g. + ```scala + for + a <- doSth(arg) + b = a + yield a + b + ``` + + Intuition would suggest for the desugared code will be of the form + + ```scala + doSth(arg).map { a => + val b = a + a + b + } + ``` + + But because of the possibility of an `if` guard being immediately after the pure alias, the desugared code is of the form + + ```scala + doSth(arg).map { a => + val b = a + (a, b) + }.map { case (a, b) => + a + b + } + ``` + + These unnecessary assignments and additional function calls not only add unnecessary runtime overhead but can also block other optimizations from being performed. + +## Proposed solution + +This SIP suggests the following changes to `for` comprehensions: + +1. Allow `for` comprehensions to start with pure aliases + + e.g. + ```scala + for + a = 1 + b <- Some(2) + c <- doSth(a) + yield b + c + ``` +2. Simpler conditional desugaring of pure aliases. i.e. whenever a series of pure aliases is not immediately followed by an `if`, use a simpler way of desugaring. + + e.g. + ```scala + for + a <- doSth(arg) + b = a + yield a + b + ``` + + will be desugared to + + ```scala + doSth(arg).map { a => + val b = a + a + b + } + ``` + + but + + ```scala + for + a <- doSth(arg) + b = a + if b > 1 + yield a + b + ``` + + will be desugared to + + ```scala + doSth(arg).map { a => + val b = a + (a, b) + }.withFilter { case (a, b) => + b > 1 + }.map { case (a, b) => + a + b + } + ``` + +3. Avoiding redundant `map` calls if the yielded value is the same as the last bound value. + + e.g. + ```scala + for + a <- List(1, 2, 3) + yield a + ``` + + will just be desugared to + + ```scala + List(1, 2, 3) + ``` + +### Detailed description + +#### Ad 1. Allow `for` comprehensions to start with pure aliases + +Allowing `for` comprehensions to start with pure aliases is a straightforward change. + +The Enumerators syntax will be changed from: + +``` +Enumerators ::= Generator {semi Enumerator | Guard} +``` + +to + +``` +Enumerators ::= {Pattern1 `=' Expr semi} Generator {semi Enumerator | Guard} +``` + +Which will allow adding 0 or more aliases before the first generator. + +When desugaring is concerned, a for comprehension starting with pure aliases will generate a block with those aliases as `val` declarations and the rest of the desugared `for` as an expression. Unless the aliases are followed by a guard, then the desugaring should result in an error. + +New desugaring rule will be added: + +```scala +For any N: + for (P_1 = E_1; ... P_N = E_N; ...) + ==> + { + val x_2 @ P_2 = E_2 + ... + val x_N @ P_N = E_N + for (...) + } +``` + +e.g. + +```scala +for + a = 1 + b <- Some(2) + c <- doSth(a) +yield b + c +``` + +will desugar to + +```scala +{ + val a = 1 + for + b <- Some(2) + c <- doSth(a) + yield b + c +} +``` + +#### Ad 2. Simpler conditional desugaring of pure aliases. i.e. whenever a series of pure aliases is not immediately followed by an `if`, use a simpler way of desugaring. + +Currently, for consistency, all pure aliases are desugared as if they are followed by an `if` condition. Which makes the desugaring more complicated than expected. + +e.g. + +The following code: + +```scala +for + a <- doSth(arg) + b = a +yield a + b +``` + +will be desugared to: + +```scala +doSth(arg).map { a => + val b = a + (a, b) +}.map { case (a, b) => + a + b +} +``` + +The proposed change is to introduce a simpler desugaring for common cases, when aliases aren't followed by a guard, and keep the old desugaring method for the other cases. + +A new desugaring rules will be introduced for simple desugaring. + +```scala +For any N: + for (P <- G; P_1 = E_1; ... P_N = E_N; ...) + ==> + G.flatMap (P => for (P_1 = E_1; ... P_N = E_N; ...)) + +And: + + for () yield E ==> E + +(Where empty for-comprehensions are excluded by the parser) +``` + +It delegares desugaring aliases to the newly introduced rule from the previous impreovement. i.e. + +```scala +For any N: + for (P_1 = E_1; ... P_N = E_N; ...) + ==> + { + val x_2 @ P_2 = E_2 + ... + val x_N @ P_N = E_N + for (...) + } +``` + +One other rule also has to be changed, so that the current desugaring method, of passing all the aliases in a tuple with the result, will only be used when desugaring a generator, followed by some aliases, followed by a guard. + +```scala +For any N: + for (P <- G; P_1 = E_1; ... P_N = E_N; if E; ...) + ==> + for (TupleN(P, P_1, ... P_N) <- + for (x @ P <- G) yield { + val x_1 @ P_1 = E_2 + ... + val x_N @ P_N = E_N + TupleN(x, x_1, ..., x_N) + }; if E; ...) +``` + +This changes will make the desugaring work in the following way: + +```scala +for + a <- doSth(arg) + b = a +yield a + b +``` + +will be desugared to + +```scala +doSth(arg).map { a => + val b = a + a + b +} +``` + +but + +```scala +for + a <- doSth(arg) + b = a + if b > 1 +yield a + b +``` + +will be desugared to + +```scala +doSth(arg).map { a => + val b = a + (a, b) +}.withFilter { case (a, b) => + b > 1 +}.map { case (a, b) => + a + b +} +``` + +#### Ad 3. Avoiding redundant `map` calls if the yielded value is the same as the last bound value. + +This change is strictly an optimization. This allows for the compiler to get rid of the final `map` call, if the yielded value is the same as the last bound pattern. The pattern can be either a single variable binding or a tuple. + +One desugaring rule has to be modified for this purpose. + +```scala + for (P <- G) yield P ==> G +If P is a variable or a tuple of variables and G is not a withFilter. + + for (P <- G) yield E ==> G.map (P => E) +Otherwise +``` + +e.g. +```scala +for + a <- List(1, 2, 3) +yield a +``` + +will just be desugared to + +```scala +List(1, 2, 3) +``` + +### Compatibility + +This change may change the semantics of some programs. It may remove some `map` calls in the desugared code, which may change the program semantics (if the `map` implementation was side-effecting). + +For example the following code will now have only one `map` call, instead of two: +```scala +for + a <- doSth(arg) + b = a +yield a + b +``` + +### Other concerns + +As far as I know, there are no widely used Scala 3 libraries that depend on the desugaring specification of `for`-comprehensions. + +## Links + +1. Scala contributors discussion thread (pre-SIP): https://contributors.scala-lang.org/t/pre-sip-improve-for-comprehensions-functionality/3509/51 +2. Github issue discussion about for desugaring: https://github.com/lampepfl/dotty/issues/2573 +3. Scala 2 implementation of some of the improvements: https://github.com/oleg-py/better-monadic-for +4. Implementation of one of the simplifications: https://github.com/lampepfl/dotty/pull/16703 +5. Draft implementation branch: https://github.com/dotty-staging/dotty/tree/improved-fors \ No newline at end of file diff --git a/_sips/sips/for-comprehension-improvements.md b/_sips/sips/for-comprehension-improvements.md deleted file mode 100644 index 8fcaefe85e..0000000000 --- a/_sips/sips/for-comprehension-improvements.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-62 - For comprehension improvements -status: waiting-for-implementation -pull-request-number: 79 -stage: implementation - ---- diff --git a/_sips/sips/match-types-amendment-extractors-follow-aliases-and-singletons.md b/_sips/sips/match-types-amendment-extractors-follow-aliases-and-singletons.md deleted file mode 100644 index ae8c984c54..0000000000 --- a/_sips/sips/match-types-amendment-extractors-follow-aliases-and-singletons.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: 'Match types amendment: extractors follow aliases and singletons' -status: under-review -pull-request-number: 84 -stage: implementation - ---- diff --git a/_sips/sips/match-types-spec.md b/_sips/sips/match-types-spec.md index 1624e64cc5..aa868061d8 100644 --- a/_sips/sips/match-types-spec.md +++ b/_sips/sips/match-types-spec.md @@ -286,8 +286,18 @@ At the top level, `variance = 1` and `scrutIsWidenedAbstract = false`. * If `q` is a skolem type `∃α:X`, fail as not specific. * Otherwise, compute `matchPattern(ti, q.Y, 0, scrutIsWidenedAbstract)`. * Otherwise, the underlying type definition of `q.Y` is of the form `= U`: - * If `q` is a skolem type `∃α:X` and `U` refers to `α`, fail as not specific. - * Otherwise, compute `matchPattern(ti, U, 0, scrutIsWidenedAbstract)`. + * If `q` is not a skolem type `∃α:X`, compute `matchPattern(ti, U, 0, scrutIsWidenedAbstract)`. + * Otherwise, let `U' = dropSkolem(U)` be computed as follow: + * `dropSkolem(q)` is undefined. + * `dropSkolem(p.T) = p'.T` where `p' = dropSkolem(p)` if the latter is defined. Otherwise: + * If the underlying type of `p.T` is of the form `= V`, then `dropSkolem(V)`. + * Otherwise `dropSkolem(p.T)` is undefined. + * `dropSkolem(p.x) = p'.x` where `p' = dropSkolem(p)` if the latter is defined. Otherwise: + * If the dealiased underlying type of `p.x` is a singleton type `r.y`, then `dropSkolem(r.y)`. + * Otherwise `dropSkolem(p.x)` is undefined. + * For all other types `Y`, `dropSkolem(Y)` is the type formed by replacing each component `Z` of `Y` by `dropSkolem(Z)`. + * If `U'` is undefined, fail as not specific. + * Otherwise, compute `matchPattern(ti, U', 0, scrutIsWidenedAbstract)`. * If `T` is a concrete type alias to a type lambda: * Let `P'` be the beta-reduction of `P`. * Compute `matchPattern(P', X, variance, scrutIsWidenedAbstract)`. diff --git a/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md b/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md deleted file mode 100644 index 88b8c7b044..0000000000 --- a/_sips/sips/mprove-the-syntax-of-context-bounds-and-givens.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: 'SIP-64: Improve the Syntax of Context Bounds and Givens' -status: under-review -pull-request-number: 81 -stage: implementation - ---- diff --git a/_sips/sips/multiple-assignments.md b/_sips/sips/multiple-assignments.md index 0eb30e241d..17aef2a470 100644 --- a/_sips/sips/multiple-assignments.md +++ b/_sips/sips/multiple-assignments.md @@ -1,7 +1,331 @@ --- -title: SIP-59 - Multiple assignments -status: waiting-for-implementation -pull-request-number: 73 +layout: sip +permalink: /sips/:title.html stage: implementation - +status: waiting-for-implementation +presip-thread: https://contributors.scala-lang.org/t/pre-sip-multiple-assignments/6425 +title: SIP-59 - Multiple Assignments --- + +**By: Dimi Racordon** + +## History + +| Date | Version | +|---------------|--------------------| +| Jan 17th 2024 | Initial Draft | + +## Summary + +This proposal discusses the syntax and semantics of a construct to assign multiple variables with a single expression. +This feature would simplify the implementation of operations expressed in terms of relationships between multiple variables, such as [`std::swap`](https://en.cppreference.com/w/cpp/algorithm/swap) in C++. + +## Motivation + +It happens that one has to assign multiple variables "at once" in an algorithm. +For example, let's consider the Fibonacci sequence: + +```scala +class FibonacciIterator() extends Iterator[Int]: + + private var a: Int = 0 + private var b: Int = 1 + + def hasNext = true + def next() = + val r = a + val n = a + b + a = b + b = n + r +``` + +The same iterator could be rewritten more concisely if we could assign multiple variables at once. +For example, we can write the following in Swift: + +```swift +struct FibonacciIterator: IteratorProtocol { + + private var a: Int = 0 + private var b: Int = 1 + init() {} + + mutating func next() -> Int? { + defer { (a, b) = (b, a + b) } + return a + } + +} +``` + +Though the differences may seem frivolous at first glance, they are in fact important. +If we look at a formal definition of the Fibonacci sequence (e.g., on [Wikipedia](https://en.wikipedia.org/wiki/Fibonacci_sequence)), we might see something like: + +> The Fibonacci sequence is given by *F(n) = F(n-1) + F(n+1)* where *F(0) = 0* and *F(1) = 1*. + +Although this declarative description says nothing about an evaluation order, it becomes a concern in our Scala implementation as we must encode the relationship into multiple operational steps. +This decomposition offers opportunities to get things wrong: + +```scala +def next() = + val r = a + a = b + b = a + b // invalid semantics, the value of `a` changed "too early" + r +``` + +In contrast, our Swift implementation can remain closer to the formal definition and is therefore more legible and less error-prone. + +Multiple assignments show up in many general-purpose algorithms (e.g., insertion sort, partition, min-max element, ...). +But perhaps the most fundamental one is `swap`, which consists of exchanging two values. + +We often swap values that are stored in some collection. +In this particular case, all is well in Scala because we can ask the collection to swap elements at given positions: + +```scala +extension [T](self: mutable.ArrayBuffer[T]) + def swapAt(i: Int, j: Int) = + val t = self(i) + self(i) = self(j) + self(j) = t + +val a = mutable.ArrayBuffer(1, 2, 3) +a.swapAt(0, 2) +println(a) // ArrayBuffer(3, 2, 1) +``` + +Sadly, one can't implement a generic swap method that wouldn't rely on the ability to index a container. +The only way to express this operation in Scala is to "inline" the pattern implemented by `swapAt` every time we need to swap two values. + +Having to rewrite this boilerplate is unfortunate. +Here is an example in a realistic algorithm: + +```scala +extension [T](self: Seq[T])(using Ordering[T]) + def minMaxElements: Option[(T, T)] = + import math.Ordering.Implicits.infixOrderingOps + + // Return None for collections smaller than 2 elements. + var i = self.iterator + if (!i.hasNext) { return None } + var l = i.next() + if (!i.hasNext) { return None } + var h = i.next() + + // Confirm the initial bounds. + if (h < l) { val t = l; l = h; h = l } + + // Process the remaining elements. + def loop(): Option[(T, T)] = + if (i.hasNext) { + val n = i.next() + if (n < l) { l = n } else if (n > h) { h = n } + loop() + } else { + Some((l, h)) + } + loop() +``` + +*Note: implementation shamelessly copied from [swift-algorithms](https://github.com/apple/swift-algorithms/blob/main/Sources/Algorithms/MinMax.swift).* + +The swap occurs in the middle of the method with the sequence of expressions `val t = l; l = h; h = l`. +To borrow from the words of Edgar Dijskstra [1, Chapter 11]: + +> [that] is combersome and ugly compared with the [multiple] assignment. + +While `swap` is a very common operation, it's only an instance of a more general class of operations that are expressed in terms of relationships between multiple variables. +The definition of the Fibonacci sequence is another example. + +## Proposed solution + +The proposed solution is to add a language construct to assign multiple variables in a single expression. +Using this construct, swapping two values can be written as follows: + +```scala +var a = 2 +var b = 4 +(a, b) = (b, a) +println(s"$a$b") // 42 +``` + +The above Fibonacci iterator can be rewritten as follows: + +```scala +class FibonacciIterator() extends Iterator[Int]: + + private var a: Int = 0 + private var b: Int = 1 + + def hasNext = true + def next() = + val r = a + (a, b) = (b, a + b) + r +``` + +Multiple assignments also alleviate the need for a swap method on collections, as the same idiomatic pattern can be reused to exchange elements at given indices: + +```scala +val a = mutable.ArrayBuffer(1, 2, 3) +(a(0), a(2)) = (a(2), a(0)) +println(a) // ArrayBuffer(3, 2, 1) +``` + +### Specification + +A multiple assignment is an expression of the form `AssignTarget ‘=’ Expr` where: + +``` +AssignTarget ::= ‘(’ AssignTargetNode {‘,’ AssignTargetNode} ‘)’ +AssignTargetNode ::= Expr | AssignTarget +``` + +An assignment target describes a structural pattern that can only be matched by a compatible composition of tuples. +For example, the following program is legal. + +```scala +def f: (Boolean, Int) = (true, 42) +val a = mutable.ArrayBuffer(1, 2, 3) +def b = a +var x = false + +(x, a(0)) = (false, 1337) +(x, a(1)) = f +((x, a(1)), b(2)) = (f, 9000) +(x) = Tuple1(false) +``` + +A mismatch between the structure of a multiple assignment's target and the result of its RHS is a type error. +It cannot be detected during parsing because at this stage the compiler would not be able to determine the shape of an arbitrary expression's result. +For example, all multiple assignments in the following program are ill-typed: + +```scala +def f: (Boolean, Int) = (true, 42) +val a = mutable.ArrayBuffer(1, 2, 3) +def b = a +var x = false + +(a(1), x) = f // type mismatch +(x, a(1), b(2)) = (f, 9000) // structural mismatch +(x) = false // structural mismatch +(x) = (1, 2) // structural mismatch +``` + +Likewise, `(x) = Tuple1(false)` is _not_ equivalent to `x = Tuple1(false)`. +The former is a multiple assignment while the latter is a regular assignment, as described by the [current grammar](https://docs.scala-lang.org/scala3/reference/syntax.html) (see `Expr1`). +Though this distinction is subtle, multiple assignments involving unary tuples should be rare. + +The operational semantics of multiple assignments (aka concurrent assignments) have been studied extensively in scienific literature (e.g., [1, 2]). +A first intuition is that the most desirable semantics can be achieved by fully evaluating the RHS of the assignment before assigning any expression in the LHS [1]. +However, additional considerations must be given w.r.t. the independence of the variables on the LHS to guarantee deterministic results. +For example, consider the following expression: + +```scala +(x, x) = (1, 2) +``` + +While one may conclude that such an expression should be an error [1], it is in general difficult to guarantee value independence in a language with pervasive reference semantics. +Further, it is desirable to write expressions of the form `(a(0), a(2)) = (a(2), a(0))`, as shown in the previous section. +Another complication is that multiple assignments should uphold the general left-to-right evaluation semantics of the Scala language. +For example, `a.b = c` requires `a` to be evaluated _before_ `c`. + +Note that regular assignments desugar to function calls (e.g., `a(b) = c` is sugar for `a.update(b, c)`). +One property of these desugarings is always the last expression being evaluated before the method performing the assignment is called. +Given this observation, we address the abovementioned issues by defining the following algorithm: + +1. Traverse the LHS structure in inorder and for each leaf: + - Evaluate each outermost subexpression to its value + - Form a closure capturing these values and accepting a single argument to perform the desugared assignment + - Associate that closure to the leaf +2. Compute the value of the RHS, which forms a tree +3. Traverse the LHS and RHS structures pairwise in inorder and for each leaf: + - Apply the closure formerly associated to the LHS on RHS value + +For instance, consider the following definitions. + +```scala +def f: (Boolean, Int) = (true, 42) +val a = mutable.ArrayBuffer(1, 2, 3) +def b = a +var x = false +``` + +The evaluation of the expression `((x, a(a(0))), b(2)) = (f, 9000)` is as follows: + +1. form a closure `f0 = (rhs) => x_=(rhs)` +2. evaluate `a(0)`; result is `1` +3. form a closure `f1 = (rhs) => a.update(1, rhs)` +4. evaluate `b`; result is `a` +5. evaluate `2` +6. form a closure `f2 = (rhs) => a.update(2, rhs)` +7. evaluate `(f, 9000)`; result is `((true, 42), 9000)` +8. evaluate `f0(true)` +9. evaluate `f1(42)` +10. evaluate `f2(9000)` + +After the assignment, `x == true` and `a == List(1, 42, 9000)`. + +The compiler is allowed to ignore this procedure and generate different code for optimization purposes as long as it can guarantee that such a change is not observable. +For example, given two local variables `x` and `y`, their assignments in `(x, y) = (1, 2)` can be reordered or even performed in parallel. + +### Compatibility + +This proposal is purely additive and have no backward binary or TASTy compatibility consequences. +The semantics of the proposed new construct is fully expressible in terms of desugaring into current syntax, interpreteted with current semantics. + +The proposed syntax is not currently legal Scala. +Therefore no currently existing program could be interpreted with different semantics using a newer compiler version supporting multiple assignments. + +### Other concerns + +One understandable concern of the proposed syntax is that the semantics of multiple assignments resembles that of pattern matching, yet it has different semantics. +For example: + +```scala +val (a(x), b) = (true, "!") // 1 + +(a(x), b) = (true, "!") // 2 +``` + +If `a` is instance of a type with a companion extractor object, the two lines above have completely different semantics. +The first declares two local bindings `x` and `b`, applying pattern matching to determine their value from the tuple `(true, "!")`. +The second is assigning `a(x)` and `b` to the values `true` and `"!"`, respectively. + +Though possibly surprising, the difference in behavior is easy to explain. +The first line applies pattern matching because it starts with `val`. +The second doesn't because it involves no pattern matching introducer. +Further, note that a similar situation can already be reproduced in current Scala: + +```scala +val a(x) = true // 1 + +a(x) = true // 2 +``` + +## Alternatives + +The current proposal supports arbitrary tree structures on the LHS of the assignment. +A simpler alternative would be to only support flat sequences, allowing the syntax to dispense with parentheses. + +```scala +a, b = b, a +``` + +While this approach is more lightweight, the reduced expressiveness inhibits potentially interesting use cases. +Further, consistently using tuple syntax on both sides of the equality operator clearly distinguishes regular and multiple assignments. + +## Related work + +A Pre-SIP discussion took place prior to this proposal (see [here](https://contributors.scala-lang.org/t/pre-sip-multiple-assignments/6425/1)). + +Multiple assignments are present in many contemporary languages. +This proposal already illustrated them in Swift, but they are also commonly used in Python. +Multiple assigments have also been studied extensively in scienific literature (e.g., [1, 2]). + +## FAQ + +## References + +1. Edsger W. Dijkstra: A Discipline of Programming. Prentice-Hall 1976, ISBN 013215871X +2. Ralph-Johan Back, Joakim von Wright: Refinement Calculus - A Systematic Introduction. Graduate Texts in Computer Science, Springer 1998, ISBN 978-0-387-98417-9 diff --git a/_sips/sips/named-tuples.md b/_sips/sips/named-tuples.md index 0e6ad99d7f..bbe96e8b2d 100644 --- a/_sips/sips/named-tuples.md +++ b/_sips/sips/named-tuples.md @@ -1,7 +1,777 @@ --- -title: SIP-58 - Named Tuples -status: waiting-for-implementation -pull-request-number: 72 +layout: sip +permalink: /sips/named-tuples.html stage: implementation - +status: waiting-for-implementation +presip-thread: https://contributors.scala-lang.org/t/pre-sip-named-tuples/6403/164 +title: SIP-58 - Named Tuples --- + +**By: Martin Odersky** + +## History + +| Date | Version | +|---------------|--------------------| +| Jan 13th 2024 | Initial Draft | + +## Summary + +We propose to add new form of tuples where the elements are named. +Named tuples can be types, terms, or patterns. Syntax examples: +```scala +type Person = (name: String, age: Int) +val Bob: Person = (name = "Bob", age = 33) + +Bob match + case (name = n, age = 22) => ... +``` + +We also propose to revive SIP 43 to support patterns with named fields. Named pattern fields for case classes are analogous to named patterns for tuple elements. User-defined named pattern matching is supported since named tuples can be results of extractor methods. + +## Motivation + + 1. Named tuples are a convenient lightweight way to return multiple results from a function. But the absence of names obscures their meaning, and makes decomposition with _1, _2 ugly and hard to read. The existing alternative is to define a class instead. This does name fields, but is more heavy-weight, both in terms of notation and generated bytecode. Named tuples give the same convenience of definition as regular tuples at far better readability. + + 1. Named tuples are an almost ideal substrate on which to implement relational algebra and other database oriented operations. They are a good representation of database rows and allow the definition of generic operations such as projections and joins since they can draw on Scala 3’s existing generic machinery for tuples based on match types. + + 1. Named tuples make named pattern matching trivial to implement. The discussion on SIP 43 showed that without them it’s unclear how to implement named pattern matching at all. + +## Proposed solution + +The elements of a tuple can now be named. Example: +```scala +type Person = (name: String, age: Int) +val Bob: Person = (name = "Bob", age = 33) + +Bob match + case (name, age) => + println(s"$name is $age years old") + +val persons: List[Person] = ... +val minors = persons.filter: p => + p.age < 18 +``` +Named bindings in tuples are similar to function parameters and arguments. We use `name: Type` for element types and `name = value` for element values. It is illegal to mix named and unnamed elements in a tuple, or to use the same same +name for two different elements. + +Fields of named tuples can be selected by their name, as in the line `p.age < 18` above. + +Example: + +~~~ scala +// This is an @main method +@main def foo(x: Int): Unit = + println(x) +~~~ + +### Conformance and Convertibility + +The order of names in a named tuple matters. For instance, the type `Person` above and the type `(age: Int, name: String)` would be different, incompatible types. + +Values of named tuple types can also be be defined using regular tuples. For instance: +```scala +val Laura: Person = ("Laura", 25) + +def register(person: Person) = ... +register(person = ("Silvain", 16)) +register(("Silvain", 16)) +``` +This follows since a regular tuple `(T_1, ..., T_n)` is treated as a subtype of a named tuple `(N_1 = T_1, ..., N_n = T_n)` with the same element types. + +In the other direction, one can convert a named tuple to an unnamed tuple with the `toTuple` method. Example: +```scala +val x: (String, Int) = Bob.toTuple // ok +``` +`toTuple` is defined as an extension method in the `NamedTuple` object. +It returns the given tuple unchanged and simply "forgets" the names. + +A `.toTuple` selection is inserted implicitly by the compiler if it encounters a named tuple but the expected type is a regular tuple. So the following works as well: +```scala +val x: (String, Int) = Bob // works, expanded to Bob.toTuple +``` +The difference between subtyping in one direction and automatic `.toTuple` conversions in the other is relatively minor. The main difference is that `.toTuple` conversions don't work inside type constructors. So the following is OK: +```scala + val names = List("Laura", "Silvain") + val ages = List(25, 16) + val persons: List[Person] = names.zip(ages) +``` +But the following would be illegal. +```scala + val persons: List[Person] = List(Bob, Laura) + val pairs: List[(String, Int)] = persons // error +``` +We would need an explicit `_.toTuple` selection to express this: +```scala + val pairs: List[(String, Int)] = persons.map(_.toTuple) +``` +Note that conformance rules for named tuples are analogous to the rules for named parameters. One can assign parameters by position to a named parameter list. +```scala + def f(param: Int) = ... + f(param = 1) // OK + f(2) // Also OK +``` +But one cannot use a name to pass an argument to an unnamed parameter: +```scala + val f: Int => T + f(2) // OK + f(param = 2) // Not OK +``` +The rules for tuples are analogous. Unnamed tuples conform to named tuple types, but the opposite requires a conversion. + +### Pattern Matching + +When pattern matching on a named tuple, the pattern may be named or unnamed. +If the pattern is named it needs to mention only a subset of the tuple names, and these names can come in any order. So the following are all OK: +```scala +Bob match + case (name, age) => ... + +Bob match + case (name = x, age = y) => ... + +Bob match + case (age = x) => ... + +Bob match + case (age = x, name = y) => ... +``` + +### Expansion + +Named tuples are in essence just a convenient syntax for regular tuples. In the internal representation, a named tuple type is represented at compile time as a pair of two tuples. One tuple contains the names as literal constant string types, the other contains the element types. The runtime representation of a named tuples consists of just the element values, whereas the names are forgotten. This is achieved by declaring `NamedTuple` +in package `scala` as an opaque type as follows: +```scala + opaque type NamedTuple[N <: Tuple, +V <: Tuple] >: V = V +``` +For instance, the `Person` type would be represented as the type +```scala +NamedTuple[("name", "age"), (String, Int)] +``` +`NamedTuple` is an opaque type alias of its second, value parameter. The first parameter is a string constant type which determines the name of the element. Since the type is just an alias of its value part, names are erased at runtime, and named tuples and regular tuples have the same representation. + +A `NamedTuple[N, V]` type is publicly known to be a supertype (but not a subtype) of its value paramater `V`, which means that regular tuples can be assigned to named tuples but not _vice versa_. + +The `NamedTuple` object contains a number of extension methods for named tuples hat mirror the same functions in `Tuple`. Examples are +`apply`, `head`, `tail`, `take`, `drop`, `++`, `map`, or `zip`. +Similar to `Tuple`, the `NamedTuple` object also contains types such as `Elem`, `Head`, `Concat` +that describe the results of these extension methods. + +The translation of named tuples to instances of `NamedTuple` is fixed by the specification and therefore known to the programmer. This means that: + + - All tuple operations also work with named tuples "out of the box". + - Macro libraries can rely on this expansion. + +### Computed Field Names + +The `Selectable` trait now has a `Fields` type member that can be instantiated +to a named tuple. + +```scala +trait Selectable: + type Fields <: NamedTuple.AnyNamedTuple +``` + +If `Fields` is instantiated in a subclass of `Selectable` to some named tuple type, +then the available fields and their types will be defined by that type. Assume `n: T` +is an element of the `Fields` type in some class `C` that implements `Selectable`, +that `c: C`, and that `n` is not otherwise legal as a name of a selection on `c`. +Then `c.n` is a legal selection, which expands to `c.selectDynamic("n").asInstanceOf[T]`. + +It is the task of the implementation of `selectDynamic` in `C` to ensure that its +computed result conforms to the predicted type `T` + +As an example, assume we have a query type `Q[T]` defined as follows: + +```scala +trait Q[T] extends Selectable: + type Fields = NamedTuple.Map[NamedTuple.From[T], Q] + def selectDynamic(fieldName: String) = ... +``` + +Assume in the user domain: +```scala +case class City(zipCode: Int, name: String, population: Int) +val city: Q[City] +``` +Then +```scala +city.zipCode +``` +has type `Q[Int]` and it expands to +```scala +city.selectDynamic("zipCode").asInstanceOf[Q[Int]] +``` + +### The NamedTuple.From Type + +The `NamedTuple` object contains a type definition +```scala + type From[T] <: AnyNamedTuple +``` +`From` is treated specially by the compiler. When `NamedTuple.From` is applied to +an argument type that is an instance of a case class, the type expands to the named +tuple consisting of all the fields of that case class. +Here, _fields_ means: elements of the first parameter section. For instance, assuming +```scala +case class City(zip: Int, name: String, population: Int) +``` +then `NamedTuple.From[City]` is the named tuple +```scala +(zip: Int, name: String, population: Int) +``` +The same works for enum cases expanding to case classes, abstract types with case classes as upper bound, alias types expanding to case classes +and singleton types with case classes as underlying type (in terms of the implementation, the `classSymbol` of a type must be a case class). + +`From` is also defined on named tuples. If `NT` is a named tuple type, then `From[NT] = NT`. + +### Pattern Matching with Named Fields in General + +We allow named patterns not just for named tuples but also for case classes. For instance: +```scala +city match + case c @ City(name = "London") => println(p.population) + case City(name = n, zip = 1026, population = pop) => println(pop) +``` + +Named constructor patterns are analogous to named tuple patterns. In both cases + + - every name must match the name some field of the selector, + - names can come in any order, + - not all fields of the selector need to be matched. + +This revives SIP 43, with a much simpler desugaring than originally proposed. +Named patterns are compatible with extensible pattern matching simply because +`unapply` results can be named tuples. + +### Operations on Named Tuples + +The operations on named tuples are defined in object `scala.NamedTuple`. The current version of this object is listed in Appendix A. + +### Restrictions + +The following restrictions apply to named tuples and named pattern arguments: + + 1. Either all elements of a tuple or constructor pattern are named or none are named. It is illegal to mix named and unnamed elements in a tuple. For instance, the following is in error: + ```scala + val illFormed1 = ("Bob", age = 33) // error + ``` + 2. Each element name in a named tuple or constructor pattern must be unique. For instance, the following is in error: + ```scala + val illFormed2 = (name = "", age = 0, name = true) // error + ``` + 3. Named tuples and case classes can be matched with either named or regular patterns. But regular tuples and other selector types can only be matched with regular tuple patterns. For instance, the following is in error: + ```scala + (tuple: Tuple) match + case (age = x) => // error + ``` + +### Use Case + +As a a use case showing some advanced capabilities of named tuples (including computed field names and the `From` type), +we show an implementation of embedded queries in Scala. For expressions that look like working with collections are instead +used to directly generate a query AST that can be further optimized and mapped to a variety of query languages. The code +is given in Appendix B. + +### Syntax Changes + +The syntax of Scala is extended as follows to support named tuples and +named constructor arguments: +``` +SimpleType ::= ... + | ‘(’ NameAndType {‘,’ NameAndType} ‘)’ +NameAndType ::= id ':' Type + +SimpleExpr ::= ... + | '(' NamedExprInParens {‘,’ NamedExprInParens} ')' +NamedExprInParens ::= id '=' ExprInParens + +Patterns ::= Pattern {‘,’ Pattern} + | NamedPattern {‘,’ NamedPattern} +NamedPattern ::= id '=' Pattern +``` + +### Compatibility + +Named tuple types and expressions are simply desugared to types and trees already known to Scala. The desugaring happens before the checking, so does not influence Tasty generation. + +Pattern matching with named fields requires some small additions to Typer and the PatternMatcher phase. It does not change the Tasty format, though. + +Backward source compatibility is partially preserved since additions to types and patterns come with new syntax that was not expressible before. When looking at tuple expressions, we have two instances of a source incompatibility: + +```scala +var age: Int +(age = 1) +``` +This was an assignment in parentheses before, and is a named tuple of arity one now. It is however not idiomatic Scala code, since assignments are not usually enclosed in parentheses. + +Also, if we have +```scala +class C: + infix def f(age: Int) +val c: C +``` +then +```scala +c f (age = 1) +``` +will now construct a tuple as second operand instead of passing a named parameter. + +These problems can be detected and diagnosed fairly straightforwardly: When faced with a unary named tuple, try to interpret it as an assignment, and if that succeeds, issue a migration error and suggest a workaround of these kinds: +```scala + {age = 1} // ok + c.f(age = 1) // ok +``` + +### Open questions + + 1. What is the precise set of types and operations we want to add to `NamedTuple`. This could also evolve after this SIP is completed. + + 2. Should there be an implicit conversion from named tuples to ordinary tuples? + +## Alternatives + +### Structural Types + +We also considered to expand structural types. Structural types allow to abstract over existing classes, but require reflection or some other library-provided mechanism for element access. By contrast, named tuples have a separate representation as tuples, which can be manipulated directly. Since elements are ordered, traversals can be defined, and this allows the definition of type generic algorithms over named tuples. Structural types don’t allow such generic algorithms directly. Be could define mappings between structural types and named tuples, which could be used to implement such algorithms. These mappings would certainly become simpler if they map to/from named tuples than if they had to map to/from user-defined "HMap"s. + +By contrast to named tuples, structural types are unordered and have width subtyping. This comes with the price that no natural element ordering exist, and that one usually needs some kind of dictionary structure for access. We believe that the following advantages of named tuples over structural types outweigh the loss of subtyping flexibility: + + - Better integration since named tuples and normal tuples share the same representation. + - Better efficiency, since no dictionary is needed. + - Natural traversal order allows the formulation of generic algorithms such as projections and joins. + +### Conformance + +A large part of Pre-SIP discussion centered around subtyping rules, whether ordinary tuples should subtype named-tuples (as in this proposal) or _vice versa_ or maybe no subtyping at all. + +Looking at precedent in other languages it feels like we we do want some sort of subtyping for easy convertibility and an implicit conversion in the other direction. This proposal picks _unnamed_ <: _named_ for the subtyping and _named_ -> _unnamed_ for the conversion. + +The discussion established that both forms of subtyping are sound. My personal opinion is that the subtyping of this proposal is both more useful and safer than the one in the other direction. There is also the problem that changing the subtyping direction would be incompatible with the current structure of `Tuple` and `NamedTuple` since for instance `zip` is already an inline method on `Tuple` so it could not be overridden in `NamedTuple`. To make this work requires a refactoring of `Tuple` to use more extension methods, and the questions whether this is feasible and whether it can be made binary backwards compatible are unknown. I personally will not work on this, if others are willing to make the effort we can discuss the alternative subtyping as well. + +_Addendum:_ Turning things around, adopting _named_ <: _unnamed_ for the subtyping and `_unnamed_ -> _named_ for the conversion leads to weaker typing with undetected errors. Consider: +```scala +type Person = (name: String, age: Int) +val bob: Person +bob.zip((firstName: String, agee: Int)) +``` +This should report a type error. +But in the alternative scheme, we'd have `(firstName: String, agee: Int) <: (String, Int)` by subtyping and then +`(String, Int) -> (name: String, age: Int)` by implicit naming conversion. This is clearly not what we want. + +By contrast, in the implemented scheme, we will not convert `(firstName: String, agee: Int)` to `(String, Int)` since a conversion is only attempted if the expected type is a regular tuple, and in our scenario it is a named tuple instead. + +My takeaway is that these designs have rather subtle consequences and any alterations would need a full implementation before they can be judged. For instance, the situation with `zip` was a surprise to me, which came up since I first implemented `_.toTuple` as a regular implicit conversion instead of a compiler adaptation. + +A possibly simpler design would be to drop all conformance and conversion rules. The problem with this approach is worse usability and problems with smooth migration. Migration will be an issue since right now everything is a regular tuple. If we make it hard to go from there to named tuples, everything will tend to stay a regular tuple and named tuples will be much less used than we would hope for. + + +### Spread Operator + +An idea I was thinking of but that I did not include in this proposal highlights another potential problem with subtyping. Consider adding a _spread_ operator `*` for tuples and named tuples. if `x` is a tuple then `f(x*)` is `f` applied to all fields of `x` expanded as individual arguments. Likewise, if `y` is a named tuple, then `f(y*)` is `f` applied to all elements of `y` as named arguments. +Now, if named tuples would be subtypes of tuples, this would actually be ambiguous since widening `y` in `y*` to a regular tuple would yield a different call. But with the subtyping direction we have, this would work fine. + +I believe tuple spread is a potentially useful addition that would fit in well with Scala. But it's not immediately relevant to this proposal, so is left out for now. + + +## Related work + +This section should list prior work related to the proposal, notably: + +- [Pre-SIP Discussion](https://contributors.scala-lang.org/t/pre-sip-named-tuples/6403) + +- [SIP 43 on Pattern Matching with Named Fields](https://github.com/scala/improvement-proposals/pull/44) + +- [Experimental Implementation](https://github.com/lampepfl/dotty/pull/19174) + +## FAQ + +## Appendix A: NamedTuple Definition + +Here is the current definition of `NamedTuple`. This is part of the library and therefore subject to future changes and additions. + +```scala +package scala +import annotation.experimental +import compiletime.ops.boolean.* + +@experimental +object NamedTuple: + + opaque type AnyNamedTuple = Any + opaque type NamedTuple[N <: Tuple, +V <: Tuple] >: V <: AnyNamedTuple = V + + def apply[N <: Tuple, V <: Tuple](x: V): NamedTuple[N, V] = x + + def unapply[N <: Tuple, V <: Tuple](x: NamedTuple[N, V]): Some[V] = Some(x) + + extension [V <: Tuple](x: V) + inline def withNames[N <: Tuple]: NamedTuple[N, V] = x + + export NamedTupleDecomposition.{Names, DropNames} + + extension [N <: Tuple, V <: Tuple](x: NamedTuple[N, V]) + + /** The underlying tuple without the names */ + inline def toTuple: V = x + + /** The number of elements in this tuple */ + inline def size: Tuple.Size[V] = toTuple.size + + // This intentionally works for empty named tuples as well. I think NnEmptyTuple is a dead end + // and should be reverted, justy like NonEmptyList is also appealing at first, but a bad idea + // in the end. + + /** The value (without the name) at index `n` of this tuple */ + inline def apply(n: Int): Tuple.Elem[V, n.type] = + inline toTuple match + case tup: NonEmptyTuple => tup(n).asInstanceOf[Tuple.Elem[V, n.type]] + case tup => tup.productElement(n).asInstanceOf[Tuple.Elem[V, n.type]] + + /** The first element value of this tuple */ + inline def head: Tuple.Elem[V, 0] = apply(0) + + /** The tuple consisting of all elements of this tuple except the first one */ + inline def tail: Tuple.Drop[V, 1] = toTuple.drop(1) + + /** The last element value of this tuple */ + inline def last: Tuple.Last[V] = apply(size - 1).asInstanceOf[Tuple.Last[V]] + + /** The tuple consisting of all elements of this tuple except the last one */ + inline def init: Tuple.Init[V] = toTuple.take(size - 1).asInstanceOf[Tuple.Init[V]] + + /** The tuple consisting of the first `n` elements of this tuple, or all + * elements if `n` exceeds `size`. + */ + inline def take(n: Int): NamedTuple[Tuple.Take[N, n.type], Tuple.Take[V, n.type]] = + toTuple.take(n) + + /** The tuple consisting of all elements of this tuple except the first `n` ones, + * or no elements if `n` exceeds `size`. + */ + inline def drop(n: Int): NamedTuple[Tuple.Drop[N, n.type], Tuple.Drop[V, n.type]] = + toTuple.drop(n) + + /** The tuple `(x.take(n), x.drop(n))` */ + inline def splitAt(n: Int): NamedTuple[Tuple.Split[N, n.type], Tuple.Split[V, n.type]] = + toTuple.splitAt(n) + + /** The tuple consisting of all elements of this tuple followed by all elements + * of tuple `that`. The names of the two tuples must be disjoint. + */ + inline def ++ [N2 <: Tuple, V2 <: Tuple](that: NamedTuple[N2, V2])(using Tuple.Disjoint[N, N2] =:= true) + : NamedTuple[Tuple.Concat[N, N2], Tuple.Concat[V, V2]] + = toTuple ++ that.toTuple + + // inline def :* [L] (x: L): NamedTuple[Append[N, ???], Append[V, L] = ??? + // inline def *: [H] (x: H): NamedTuple[??? *: N], H *: V] = ??? + + /** The named tuple consisting of all element values of this tuple mapped by + * the polymorphic mapping function `f`. The names of elements are preserved. + * If `x = (n1 = v1, ..., ni = vi)` then `x.map(f) = `(n1 = f(v1), ..., ni = f(vi))`. + */ + inline def map[F[_]](f: [t] => t => F[t]): NamedTuple[N, Tuple.Map[V, F]] = + toTuple.map(f).asInstanceOf[NamedTuple[N, Tuple.Map[V, F]]] + + /** The named tuple consisting of all elements of this tuple in reverse */ + inline def reverse: NamedTuple[Tuple.Reverse[N], Tuple.Reverse[V]] = + toTuple.reverse + + /** The named tuple consisting of all elements values of this tuple zipped + * with corresponding element values in named tuple `that`. + * If the two tuples have different sizes, + * the extra elements of the larger tuple will be disregarded. + * The names of `x` and `that` at the same index must be the same. + * The result tuple keeps the same names as the operand tuples. + */ + inline def zip[V2 <: Tuple](that: NamedTuple[N, V2]): NamedTuple[N, Tuple.Zip[V, V2]] = + toTuple.zip(that.toTuple) + + /** A list consisting of all element values */ + inline def toList: List[Tuple.Union[V]] = toTuple.toList.asInstanceOf[List[Tuple.Union[V]]] + + /** An array consisting of all element values */ + inline def toArray: Array[Object] = toTuple.toArray + + /** An immutable array consisting of all element values */ + inline def toIArray: IArray[Object] = toTuple.toIArray + + end extension + + /** The size of a named tuple, represented as a literal constant subtype of Int */ + type Size[X <: AnyNamedTuple] = Tuple.Size[DropNames[X]] + + /** The type of the element value at position N in the named tuple X */ + type Elem[X <: AnyNamedTuple, N <: Int] = Tuple.Elem[DropNames[X], N] + + /** The type of the first element value of a named tuple */ + type Head[X <: AnyNamedTuple] = Elem[X, 0] + + /** The type of the last element value of a named tuple */ + type Last[X <: AnyNamedTuple] = Tuple.Last[DropNames[X]] + + /** The type of a named tuple consisting of all elements of named tuple X except the first one */ + type Tail[X <: AnyNamedTuple] = Drop[X, 1] + + /** The type of the initial part of a named tuple without its last element */ + type Init[X <: AnyNamedTuple] = + NamedTuple[Tuple.Init[Names[X]], Tuple.Init[DropNames[X]]] + + /** The type of the named tuple consisting of the first `N` elements of `X`, + * or all elements if `N` exceeds `Size[X]`. + */ + type Take[X <: AnyNamedTuple, N <: Int] = + NamedTuple[Tuple.Take[Names[X], N], Tuple.Take[DropNames[X], N]] + + /** The type of the named tuple consisting of all elements of `X` except the first `N` ones, + * or no elements if `N` exceeds `Size[X]`. + */ + type Drop[X <: AnyNamedTuple, N <: Int] = + NamedTuple[Tuple.Drop[Names[X], N], Tuple.Drop[DropNames[X], N]] + + /** The pair type `(Take(X, N), Drop[X, N]). */ + type Split[X <: AnyNamedTuple, N <: Int] = (Take[X, N], Drop[X, N]) + + /** Type of the concatenation of two tuples `X` and `Y` */ + type Concat[X <: AnyNamedTuple, Y <: AnyNamedTuple] = + NamedTuple[Tuple.Concat[Names[X], Names[Y]], Tuple.Concat[DropNames[X], DropNames[Y]]] + + /** The type of the named tuple `X` mapped with the type-level function `F`. + * If `X = (n1 : T1, ..., ni : Ti)` then `Map[X, F] = `(n1 : F[T1], ..., ni : F[Ti])`. + */ + type Map[X <: AnyNamedTuple, F[_ <: Tuple.Union[DropNames[X]]]] = + NamedTuple[Names[X], Tuple.Map[DropNames[X], F]] + + /** A named tuple with the elements of tuple `X` in reversed order */ + type Reverse[X <: AnyNamedTuple] = + NamedTuple[Tuple.Reverse[Names[X]], Tuple.Reverse[DropNames[X]]] + + /** The type of the named tuple consisting of all element values of + * named tuple `X` zipped with corresponding element values of + * named tuple `Y`. If the two tuples have different sizes, + * the extra elements of the larger tuple will be disregarded. + * The names of `X` and `Y` at the same index must be the same. + * The result tuple keeps the same names as the operand tuples. + * For example, if + * ``` + * X = (n1 : S1, ..., ni : Si) + * Y = (n1 : T1, ..., nj : Tj) where j >= i + * ``` + * then + * ``` + * Zip[X, Y] = (n1 : (S1, T1), ..., ni: (Si, Ti)) + * ``` + * @syntax markdown + */ + type Zip[X <: AnyNamedTuple, Y <: AnyNamedTuple] = + Tuple.Conforms[Names[X], Names[Y]] match + case true => + NamedTuple[Names[X], Tuple.Zip[DropNames[X], DropNames[Y]]] + + type From[T] <: AnyNamedTuple + +end NamedTuple + +/** Separate from NamedTuple object so that we can match on the opaque type NamedTuple. */ +@experimental +object NamedTupleDecomposition: + import NamedTuple.* + + /** The names of a named tuple, represented as a tuple of literal string values. */ + type Names[X <: AnyNamedTuple] <: Tuple = X match + case NamedTuple[n, _] => n + + /** The value types of a named tuple represented as a regular tuple. */ + type DropNames[NT <: AnyNamedTuple] <: Tuple = NT match + case NamedTuple[_, x] => x +``` + +## Appendix B: Embedded Queries Case Study + +```scala +import language.experimental.namedTuples +import NamedTuple.{NamedTuple, AnyNamedTuple} + +/* This is a demonstrator that shows how to map regular for expressions to + * internal data that can be optimized by a query engine. It needs NamedTuples + * and type classes but no macros. It's so far very provisional and experimental, + * intended as a basis for further exploration. + */ + +/** The type of expressions in the query language */ +trait Expr[Result] extends Selectable: + + /** This type is used to support selection with any of the field names + * defined by Fields. + */ + type Fields = NamedTuple.Map[NamedTuple.From[Result], Expr] + + /** A selection of a field name defined by Fields is implemented by `selectDynamic`. + * The implementation will add a cast to the right Expr type corresponding + * to the field type. + */ + def selectDynamic(fieldName: String) = Expr.Select(this, fieldName) + + /** Member methods to implement universal equality on Expr level. */ + def == (other: Expr[?]): Expr[Boolean] = Expr.Eq(this, other) + def != (other: Expr[?]): Expr[Boolean] = Expr.Ne(this, other) + +object Expr: + + /** Sample extension methods for individual types */ + extension (x: Expr[Int]) + def > (y: Expr[Int]): Expr[Boolean] = Gt(x, y) + def > (y: Int): Expr[Boolean] = Gt(x, IntLit(y)) + extension (x: Expr[Boolean]) + def &&(y: Expr[Boolean]): Expr[Boolean] = And(x, y) + def || (y: Expr[Boolean]): Expr[Boolean] = Or(x, y) + + // Note: All field names of constructors in the query language are prefixed with `$` + // so that we don't accidentally pick a field name of a constructor class where we want + // a name in the domain model instead. + + // Some sample constructors for Exprs + case class Gt($x: Expr[Int], $y: Expr[Int]) extends Expr[Boolean] + case class Plus(x: Expr[Int], y: Expr[Int]) extends Expr[Int] + case class And($x: Expr[Boolean], $y: Expr[Boolean]) extends Expr[Boolean] + case class Or($x: Expr[Boolean], $y: Expr[Boolean]) extends Expr[Boolean] + + // So far Select is weakly typed, so `selectDynamic` is easy to implement. + // Todo: Make it strongly typed like the other cases + case class Select[A]($x: Expr[A], $name: String) extends Expr + + case class Single[S <: String, A]($x: Expr[A]) + extends Expr[NamedTuple[S *: EmptyTuple, A *: EmptyTuple]] + + case class Concat[A <: AnyNamedTuple, B <: AnyNamedTuple]($x: Expr[A], $y: Expr[B]) + extends Expr[NamedTuple.Concat[A, B]] + + case class Join[A <: AnyNamedTuple](a: A) + extends Expr[NamedTuple.Map[A, StripExpr]] + + type StripExpr[E] = E match + case Expr[b] => b + + // Also weakly typed in the arguents since these two classes model universal equality */ + case class Eq($x: Expr[?], $y: Expr[?]) extends Expr[Boolean] + case class Ne($x: Expr[?], $y: Expr[?]) extends Expr[Boolean] + + /** References are placeholders for parameters */ + private var refCount = 0 + + case class Ref[A]($name: String = "") extends Expr[A]: + val id = refCount + refCount += 1 + override def toString = s"ref$id(${$name})" + + /** Literals are type-specific, tailored to the types that the DB supports */ + case class IntLit($value: Int) extends Expr[Int] + + /** Scala values can be lifted into literals by conversions */ + given Conversion[Int, IntLit] = IntLit(_) + + /** The internal representation of a function `A => B` + * Query languages are ususally first-order, so Fun is not an Expr + */ + case class Fun[A, B](param: Ref[A], f: B) + + type Pred[A] = Fun[A, Expr[Boolean]] + + /** Explicit conversion from + * (name_1: Expr[T_1], ..., name_n: Expr[T_n]) + * to + * Expr[(name_1: T_1, ..., name_n: T_n)] + */ + extension [A <: AnyNamedTuple](x: A) def toRow: Join[A] = Join(x) + + /** Same as _.toRow, as an implicit conversion */ + given [A <: AnyNamedTuple]: Conversion[A, Expr.Join[A]] = Expr.Join(_) + +end Expr + +/** The type of database queries. So far, we have queries + * that represent whole DB tables and queries that reify + * for-expressions as data. + */ +trait Query[A] + +object Query: + import Expr.{Pred, Fun, Ref} + + case class Filter[A]($q: Query[A], $p: Pred[A]) extends Query[A] + case class Map[A, B]($q: Query[A], $f: Fun[A, Expr[B]]) extends Query[B] + case class FlatMap[A, B]($q: Query[A], $f: Fun[A, Query[B]]) extends Query[B] + + // Extension methods to support for-expression syntax for queries + extension [R](x: Query[R]) + + def withFilter(p: Ref[R] => Expr[Boolean]): Query[R] = + val ref = Ref[R]() + Filter(x, Fun(ref, p(ref))) + + def map[B](f: Ref[R] => Expr[B]): Query[B] = + val ref = Ref[R]() + Map(x, Fun(ref, f(ref))) + + def flatMap[B](f: Ref[R] => Query[B]): Query[B] = + val ref = Ref[R]() + FlatMap(x, Fun(ref, f(ref))) +end Query + +/** The type of query references to database tables */ +case class Table[R]($name: String) extends Query[R] + +// Everything below is code using the model ----------------------------- + +// Some sample types +case class City(zipCode: Int, name: String, population: Int) +type Address = (city: City, street: String, number: Int) +type Person = (name: String, age: Int, addr: Address) + +@main def Test = + + val cities = Table[City]("cities") + + val q1 = cities.map: c => + c.zipCode + val q2 = cities.withFilter: city => + city.population > 10_000 + .map: city => + city.name + + val q3 = + for + city <- cities + if city.population > 10_000 + yield city.name + + val q4 = + for + city <- cities + alt <- cities + if city.name == alt.name && city.zipCode != alt.zipCode + yield + city + + val addresses = Table[Address]("addresses") + val q5 = + for + city <- cities + addr <- addresses + if addr.street == city.name + yield + (name = city.name, num = addr.number) + + val q6 = + cities.map: city => + (name = city.name, zipCode = city.zipCode) + + def run[T](q: Query[T]): Iterator[T] = ??? + + def x1: Iterator[Int] = run(q1) + def x2: Iterator[String] = run(q2) + def x3: Iterator[String] = run(q3) + def x4: Iterator[City] = run(q4) + def x5: Iterator[(name: String, num: Int)] = run(q5) + def x6: Iterator[(name: String, zipCode: Int)] = run(q6) +``` \ No newline at end of file diff --git a/_sips/sips/typeclasses-syntax.md b/_sips/sips/typeclasses-syntax.md new file mode 100644 index 0000000000..89703fe0ad --- /dev/null +++ b/_sips/sips/typeclasses-syntax.md @@ -0,0 +1,685 @@ +--- +layout: sip +stage: implementation +status: implemented +presip-thread: https://contributors.scala-lang.org/t/pre-sip-improve-syntax-for-context-bounds-and-givens/6576/97 +title: SIP-64 - Improve Syntax for Context Bounds and Givens +--- + +**By: Martin Odersky** + +## History + +| Date | Version | +|---------------|--------------------| +| March 11, 2024| Initial Draft | +| July 18, 2014 | Revised Draft | + +## Summary + +We propose some syntactic improvements that make context bounds and given clauses more +expressive and easier to read. The proposed additions and changes comprise: + + - naming context bounds, as in `A: Monoid as a`, + - a new syntax for multiple context bounds, as in `A: {Monoid, Ord}`, + - context bounds for type members, + - replacing abstract givens with a more powerful and convenient mechanism, + - a cleaner syntax for given definitions that eliminates some syntactic warts. + +## Motivation + +This SIP is part of an effort to get state-of-the art typeclasses and generic in Scala. It fixes several existing pain points: + + - The inability to name context bounds causes awkward and obscure workarounds in practice. + - The syntax for multiple context bounds is not very clear or readable. + - The existing syntax for givens is unfortunate, which hinders learning and adoption. + - Abstract givens are hard to specify and implement and their syntax is easily confused + with simple concrete givens. + +These pain points are worth fixing on their own, independently of any other proposed improvements to typeclass support. What's more, the changes +are time sensitive since they affect existing syntax that was introduced in 3.0, so it's better to make the change at a time when not that much code using the new syntax is written yet. + +## Proposed Solution + +### 1. Naming Context Bounds + +Context bounds are a convenient and legible abbreviation. A problem so far is that they are always anonymous, one cannot name the implicit parameter to which a context bound expands. For instance, consider the classical pair of type classes +```scala + trait SemiGroup[A]: + extension (x: A) def combine(y: A): A + + trait Monoid[A] extends SemiGroup[A]: + def unit: A +``` +and a `reduce` method defined like this: +```scala +def reduce[A : Monoid](xs: List[A]): A = ??? +``` +Since we don't have a name for the `Monoid` instance of `A`, we need to resort to `summon` in the body of `reduce`: +```scala +def reduce[A : Monoid](xs: List[A]): A = + xs.foldLeft(summon[Monoid[A]].unit)(_ `combine` _) +``` +That's generally considered too painful to write and read, hence people usually adopt one of two alternatives. Either, eschew context bounds and switch to using clauses: +```scala +def reduce[A](xs: List[A])(using m: Monoid[A]): A = + xs.foldLeft(m.unit)(_ `combine` _) +``` +Or, plan ahead and define a "trampoline" method in `Monoid`'s companion object: +```scala + trait Monoid[A] extends SemiGroup[A]: + def unit: A + object Monoid: + def unit[A](using m: Monoid[A]): A = m.unit + ... + def reduce[A : Monoid](xs: List[A]): A = + xs.foldLeft(Monoid.unit)(_ `combine` _) +``` +This is all accidental complexity which can be avoided by the following proposal. + +**Proposal:** Allow to name a context bound, like this: +```scala + def reduce[A : Monoid as m](xs: List[A]): A = + xs.foldLeft(m.unit)(_ `combine` _) +``` + +We use `as x` after the type to bind the instance to `x`. This is analogous to import renaming, which also introduces a new name for something that comes before. + +**Benefits:** The new syntax is simple and clear. It avoids the awkward choice between concise context bounds that can't be named and verbose using clauses that can. + +### 2. New Syntax for Aggregate Context Bounds + +Aggregate context bounds like `A : X : Y` are not obvious to read, and it becomes worse when we add names, e.g. `A : X as x : Y as y`. + +**Proposal:** Allow to combine several context bounds inside `{...}`, analogous +to import clauses. Example: + +```scala + trait: + def showMax[X : {Ordering, Show}](x: X, y: X): String + class B extends A: + def showMax[X : {Ordering as ordering, Show as show}](x: X, y: X): String = + show.asString(ordering.max(x, y)) +``` + +The old syntax with multiple `:` should be phased out over time. There's more about migration at the end of this SIP. + + +### 3. Expansion of Context Bounds + +With named context bounds, we need a revision to how the witness parameters of such bounds are added. Context bounds are currently translated to implicit parameters in the last parameter list of a method or class. This is a problem if a context bound is mentioned in one of the preceding parameter types. For example, consider a type class of parsers with associated type members `Input` and `Result` describing the input type on which the parsers operate and the type of results they produce: +```scala +trait Parser[P]: + type Input + type Result +``` +Here is a method `run` that runs a parser on an input of the required type: +```scala +def run[P : Parser as p](in: p.Input): p.Result +``` +With the current translation this does not work since it would be expanded to: +```scala + def run[P](x: p.Input)(using p: Parser[P]): p.Result +``` +Note that the `p` in `p.Input` refers to the `p` introduced in the using clause, which comes later. So this is ill-formed. + +This problem would be fixed by changing the translation of context bounds so that they expand to using clauses immediately after the type parameter. But such a change is infeasible, for two reasons: + + 1. It would be a source- and binary-incompatible change. We cannot simply change the expansion of existing using clauses because + then clients that pass explicit using arguments would no longer work. + 2. Putting using clauses earlier can impair type inference. A type in + a using clause can be constrained by term arguments coming before that + clause. Moving the using clause first would miss those constraints, which could cause ambiguities in implicit search. + +But there is an alternative which is feasible: + +**Proposal:** Map the context bounds of a method or class as follows: + + 1. If one of the bounds is referred to by its term name in a subsequent parameter clause, the context bounds are mapped to a using clause immediately preceding the first such parameter clause. + 2. Otherwise, if the last parameter clause is a using (or implicit) clause, merge all parameters arising from context bounds in front of that clause, creating a single using clause. + 3. Otherwise, let the parameters arising from context bounds form a new using clause at the end. + +Rules (2) and (3) are the status quo, and match Scala 2's rules. Rule (1) is new but since context bounds so far could not be referred to, it does not apply to legacy code. Therefore, binary compatibility is maintained. + +**Discussion** More refined rules could be envisaged where context bounds are spread over different using clauses so that each comes as late as possible. But it would make matters more complicated and the gain in expressiveness is not clear to me. + + +### 4. Context Bounds for Type Members, Deferred Givens + +It's not very orthogonal to allow subtype bounds for both type parameters and abstract type members, but context bounds only for type parameters. What's more, we don't even have the fallback of an explicit using clause for type members. The only alternative is to also introduce a set of abstract givens that get implemented in each subclass. This is extremely heavyweight and opaque to newcomers. + +**Proposal**: Allow context bounds for type members. Example: + +```scala + class Collection: + type Element : Ord +``` + +The question is how these bounds are expanded. Context bounds on type parameters +are expanded into using clauses. But for type members this does not work, since we cannot refer to a member type of a class in a parameter type of that class. What we are after is an equivalent of using parameter clauses but represented as class members. + +**Proposal:** +Introduce a new way to implement a given definition in a trait like this: +```scala +given T = deferred +``` +`deferred` is a new method in the `scala.compiletime` package, which can appear only as the right hand side of a given defined in a trait. Any class implementing that trait will provide an implementation of this given. If a definition is not provided explicitly, it will be synthesized by searching for a given of type `T` in the scope of the inheriting class. Specifically, the scope in which this given will be searched is the environment of that class augmented by its parameters but not containing its members (since that would lead to recursive resolutions). If an implementation _is_ provided explicitly, it counts as an override of a concrete definition and needs an `override` modifier. + +Deferred givens allow a clean implementation of context bounds in traits, +as in the following example: +```scala +trait Sorted: + type Element : Ord + +class SortedSet[A : Ord] extends Sorted: + type Element = A +``` +The compiler expands this to the following implementation. +```scala +trait Sorted: + type Element + given Ord[Element] = compiletime.deferred + +class SortedSet[A](using evidence$0: Ord[A]) extends Sorted: + type Element = A + override given Ord[Element] = evidence$0 +``` + +The using clause in class `SortedSet` provides an implementation for the deferred given in trait `Sorted`. + +**Benefits:** + + - Better orthogonality, type parameters and abstract type members now accept the same kinds of bounds. + - Better ergonomics, since deferred givens get naturally implemented in inheriting classes, no need for boilerplate to fill in definitions of abstract givens. + +**Alternative:** It was suggested that we use a modifier for a deferred given instead of a `= deferred`. Something like `deferred given C[T]`. But a modifier does not suggest the concept that a deferred given will be implemented automatically in subclasses unless an explicit definition is written. In a sense, we can see `= deferred` as the invocation of a magic macro that is provided by the compiler. So from a user's point of view a given with `deferred` right hand side is not abstract. +It is a concrete definition where the compiler will provide the correct implementation. And if users want to provide their own overriding +implementations, they will need an explicit `override` modifier. + +### 5. Abolish Abstract Givens + +With `deferred` givens there is no need anymore to also define abstract givens. The two mechanisms are very similar, but the user experience for +deferred givens is generally more ergonomic. Abstract givens also are uncomfortably close to concrete class instances. Their syntax clashes +with the quite common case where we want to establish a given without any nested definitions. For instance, consider a given that constructs a type tag: +```scala +class Tag[T] +``` +Then this works: +```scala +given Tag[String]() +given Tag[String] with {} +``` +But the following more natural syntax fails: +```scala +given Tag[String] +``` +The last line gives a rather cryptic error: +``` +1 |given Tag[String] + | ^ + | anonymous given cannot be abstract +``` +The underlying problem is that abstract givens are very rare (and should become completely unnecessary once deferred givens are introduced), yet occupy a syntax that looks very close to the more common case of concrete +typeclasses without nested definitions. + +**Proposal:** In the future, let the `= deferred` mechanism be the only way to deliver the functionality of abstract givens. Deprecate the current version of abstract givens, and remove them in a future Scala version. + +**Benefits:** + + - Simplification of the language since a feature is dropped + - Eliminate non-obvious and misleading syntax. + +The only downside is that deferred givens are restricted to be used in traits, whereas abstract givens are also allowed in abstract classes. But I would be surprised if actual code relied on that difference, and such code could in any case be easily rewritten to accommodate the restriction. + + +### 6. Context Bounds for Polymorphic Functions + +Currently, context bounds can be used in methods, but not in function types or function literals. It would be nice propose to drop this irregularity and allow context bounds also in these places. Example: + +```scala +type Comparer = [X: Ord] => (x: X, y: X) => Boolean +val less: Comparer = [X: Ord as ord] => (x: X, y: X) => + ord.compare(x, y) < 0 +``` + +The expansion of such context bounds is analogous to the expansion in method types, except that instead of adding a using clause in a method, we insert a context function type. + +For instance, the `type` and `val` definitions above would expand to +```scala +type Comparer = [X] => (x: X, y: X) => Ord[X] ?=> Boolean +val less: Comparer = [X] => (x: X, y: X) => (ord: Ord[X]) ?=> + ord.compare(x, y) < 0 +``` + +The expansion of using clauses does look inside alias types. For instance, +here is a variation of the previous example that uses a parameterized type alias: +```scala +type Cmp[X] = (x: X, y: X) => Ord[X] ?=> Boolean +type Comparer2 = [X: Ord] => Cmp[X] +``` +The expansion of the right hand side of `Comparer2` expands the `Cmp[X]` alias +and then inserts the context function at the same place as what's done for `Comparer`. + +### 7. Cleanup of Given Syntax + +A good language syntax is like a Bach fugue: A small set of motifs is combined in a multitude of harmonic ways. Dissonances and irregularities should be avoided. + +When designing Scala 3, I believe that, by and large, we achieved that goal, except in one area, which is the syntax of givens. There _are_ some glaring dissonances, as seen in this code for defining an ordering on lists: +```scala +given [A](using Ord[A]): Ord[List[A]] with + def compare(x: List[A], y: List[A]) = ... +``` +The `:` feels utterly foreign in this position. It's definitely not a type ascription, so what is its role? Just as bad is the trailing `with`. Everywhere else we use braces or trailing `:` to start a scope of nested definitions, so the need of `with` sticks out like a sore thumb. + +Sometimes unconventional syntax grows on you and becomes natural after a while. But here it was unfortunately the opposite. The longer I used given definitions in this style the more awkward they felt, in particular since the rest of the language seemed so much better put together by comparison. And I believe many others agree with me on this. Since the current syntax is unnatural and esoteric, this means it's difficult to discover and very foreign even after that. This makes it much harder to learn and apply givens than it need be. + +The previous conditional given syntax was inspired by method definitions. If we add the optional name to the previous example, we obtain something akin to an implicit method in Scala 2: +```scala +given listOrd[A](using Ord[A]): Ord[List[A]] with + def compare(x: List[A], y: List[A]) = ... +``` +The anonymous syntax was then obtained by simply dropping the name. +But without a name, the syntax looks weird and inconsistent. + +This is a problem since at least for typeclasses, anonymous givens should be the norm. +Givens are like extends clauses. We state a _fact_, that a +type implements a type class, or that a value can be used implicitly. We don't need a name for that fact. It's analogous to extends clauses, where we state that a class is a subclass of some other class or trait. We would not think it useful to name an extends clause, it's simply a fact that is stated. +It's also telling that every other language that defines type classes uses anonymous syntax. Somehow, nobody ever found it necessary to name these instances. + +A more intuitive and in my opinion cleaner alternative is to decree that a given should always look like it _implements a type_. Conditional givens should look like they implement function types. The `Ord` typeclass instances for `Int` and `List` would then look like this: +```scala +given Ord[String]: + def compare(x: String, y: String) = ... + +given [A : Ord] => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... +``` +The second, conditional instance looks like it implements the function type +```scala +[A : Ord] => Ord[List[A]] +``` +Another way to see this is as an implication: +If `A` is a type that is `Ord`, then `List[A]` is `Ord` (and the rest of the given clause gives the implementation that makes it so). +Equivalently, `A` is `Ord` _implies_ `List[A]` is `Ord`, hence the `=>`. + +Yet another related meaning is that the given clause establishes a _context function_ of type `[A: Ord] ?=> Ord[List[A]]` that is automatically applied to evidence arguments of type `Ord[A]` and that yields instances of type `Ord[List[A]]`. Since givens are in any case applied automatically to all their arguments, we don't need to specify that separately with `?=>`, a simple `=>` arrow is sufficiently clear and is easier to read. + +All these viewpoints are equivalent, in a deep sense. This is exactly the Curry Howard isomorphism, which equates function types and implications. + +**Proposal:** Change the syntax for given clauses so that a `given` clause consists of the following elements: + + - An optional name binding `id :` + - Zero or more _conditions_, which introduce type or value parameters. Each precondition ends in a `=>`. + - the implemented _type_, + - an implementation which consists of either an `=` and an expression, + or a template body. + +**Examples:** + +Here is an enumeration of common forms of given definitions in the new syntax. We show the following use cases: + + 1. A simple typeclass instance, such as `Ord[Int]`. + 2. A parameterized type class instance, such as `Ord` for lists. + 3. A type class instance with an explicit context parameter. + 4. A type class instance with a named eexplicit context parameter. + 4. A simple given alias. + 5. A parameterized given alias + 6. A given alias with an explicit context parameter. + 8. An abstract or deferred given + 9. A by-name given, e.g. if we have a given alias of a mutable variable, and we + want to make sure that it gets re-evaluated on each access. +```scala + // Simple typeclass + given Ord[Int]: + def compare(x: Int, y: Int) = ... + + // Parameterized typeclass with context bound + given [A: Ord] => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Parameterized typeclass with context parameter + given [A] => Ord[A] => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Parameterized typeclass with named context parameter + given [A] => (ord: Ord[A]) => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Simple alias + given Ord[Int] = IntOrd() + + // Parameterized alias with context bound + given [A: Ord] => Ord[List[A]] = + ListOrd[A] + + // Parameterized alias with context parameter + given [A] => Ord[A] => Ord[List[A]] = + ListOrd[A] + + // Abstract or deferred given + given Context = deferred + + // By-name given + given () => Context = curCtx +``` +Here are the same examples, with optional names provided: +```scala + // Simple typeclass + given intOrd: Ord[Int]: + def compare(x: Int, y: Int) = ... + + // Parameterized typeclass with context bound + given listOrd: [A: Ord] => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Parameterized typeclass with context parameter + given listOrd: [A] => Ord[A] => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Parameterized typeclass with named context parameter + given listOrd: [A] => (ord: Ord[A]) => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Simple alias + given intOrd: Ord[Int] = IntOrd() + + // Parameterized alias with context bound + given listOrd: [A: Ord] => Ord[List[A]] = + ListOrd[A] + + // Parameterized alias with context parameter + given listOrd: [A] => Ord[A] => Ord[List[A]] = + ListOrd[A] + + // Abstract or deferred given + given context: Context = deferred + + // By-name given + given context: () => Context = curCtx +``` + +**By Name Givens** + +We sometimes find it necessary that a given alias is re-evaluated each time it is called. For instance, say we have a mutable variable `curCtx` and we want to define a given that returns the current value of that variable. A normal given alias will not do since by default given aliases are mapped to +lazy vals. + +In general, we want to avoid re-evaluation of the given. But there are situations like the one above where we want to specify _by-name_ evaluation instead. The proposed new syntax for this is shown in the last clause above. This is arguably the a natural way to express by-name givens. We want to use a conditional given, since these map to methods, but the set of preconditions is empty, hence the `()` parameter. Equivalently, under the context function viewpoint, we are defining a context function of the form `() ?=> T`, and these are equivalent to by-name parameters. + +Compare with the current best way to do achieve this, which is to use a dummy type parameter. +```scala + given [DummySoThatItsByName]: Context = curCtx +``` +This has the same effect, but feels more like a hack than a clean solution. + +**Dropping `with`** + +In the new syntax, all typeclass instances introduce definitions like normal +class bodies, enclosed in braces `{...}` or following a `:`. The irregular +requirement to use `with` is dropped. In retrospect, the main reason to introduce `with` was since a definition like + +```scala +given [A](using Ord[A]): Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... +``` +was deemed to be too cryptic, with the double meaning of colons. But since that syntax is gone, we don't need `with` anymore. There's still a double meaning of colons, e.g. in +```scala +given intOrd: Ord[Int]: + ... +``` +but since now both uses of `:` are very familiar (type ascription _vs_ start of nested definitions), it's manageable. Besides, the problem occurs only for named typeclass instances, which should be the exceptional case anyway. + + +**Possible ambiguities** + +If one wants to define a given for an a actual function type (which is probably not advisable in practice), one needs to enclose the function type in parentheses, i.e. `given ([A] => F[A])`. This is true in the currently implemented syntax and stays true for all discussed change proposals. + +The double meaning of : with optional prefix names is resolved as usual. A : at the end of a line starts a nested definition block. If for some obscure reason one wants to define a named given on multiple lines, one has to format it as follows: +```scala + given intOrd + : Ord = ... +``` +**Comparison with Status Quo** + +To facilitate a systematic comparison, here is the listing of all 9x2 cases discussed previously with the current syntax. + +Unnamed: +```scala + // Simple typeclass + given Ord[Int] with + def compare(x: Int, y: Int) = ... + + // Parameterized typeclass with context bound + given [A: Ord]: Ord[List[A]] with + def compare(x: List[A], y: List[A]) = ... + + // Parameterized typeclass with context parameter + given [A](using Ord[A]): Ord[List[A]] with + def compare(x: List[A], y: List[A]) = ... + + // Parameterized typeclass with named context parameter + given [A](using ord: Ord[A]): Ord[List[A]] with + def compare(x: List[A], y: List[A]) = ... + + // Simple alias + given Ord[Int] = IntOrd() + + // Parameterized alias with context bound + given [A: Ord]: Ord[List[A]] = + ListOrd[A] + + // Parameterized alias with context parameter + given [A](using Ord[A]): Ord[List[A]] = + ListOrd[A] + + // Abstract or deferred given: no unnamed form possible + + // By-name given + given [DummySoItsByName]: Context = curCtx +``` +Named: +```scala + // Simple typeclass + given intOrd: Ord[Int] with + def compare(x: Int, y: Int) = ... + + // Parameterized typeclass with context bound + given listOrd[A: Ord]: Ord[List[A]] with + def compare(x: List[A], y: List[A]) = ... + + // Parameterized typeclass with context parameter + given listOrd[A](using Ord[A]): Ord[List[A]] with + def compare(x: List[A], y: List[A]) = ... + + // Parameterized typeclass with named context parameter + given listOrd[A](using ord: Ord[A]): Ord[List[A]] with + def compare(x: List[A], y: List[A]) = ... + + // Simple alias + given intOrd: Ord[Int] = IntOrd() + + // Parameterized alias with context bound + given listOrd[A: Ord]: Ord[List[A]] = + ListOrd[A] + + // Parameterized alias with context parameter + given listOrd[A](using Ord[A]): Ord[List[A]] = + ListOrd[A] + + // Abstract or deferred given + given context: Context + + // By-name given + given context[DummySoItsByName]: Context = curCtx +``` + +**Summary** + +This will be a fairly significant change to the given syntax. I believe there's still a possibility to do this. Not so much code has migrated to new style givens yet, and code that was written can be changed fairly easily. Specifically, there are about a 900K definitions of `implicit def`s +in Scala code on Github and about 10K definitions of `given ... with`. So about 1% of all code uses the Scala 3 syntax, which would have to be changed again. + +Changing something introduced just recently in Scala 3 is not fun, +but I believe these adjustments are preferable to let bad syntax +sit there and fester. The cost of changing should be amortized by improved developer experience over time, and better syntax would also help in migrating Scala 2 style implicits to Scala 3. But we should do it quickly before a lot more code +starts migrating. + +Migration to the new syntax is straightforward, and can be supported by automatic rewrites. For a transition period we can support both the old and the new syntax. It would be a good idea to backport the new given syntax to the LTS version of Scala so that code written in this version can already use it. The current LTS would then support old and new-style givens indefinitely, whereas new Scala 3.x versions would phase out the old syntax over time. + + +## Summary of Syntax Changes + +Here is the complete context-free syntax for all proposed features. +``` +TmplDef ::= 'given' GivenDef +GivenDef ::= [id ':'] GivenSig +GivenSig ::= GivenImpl + | '(' ')' '=>' GivenImpl + | GivenConditional '=>' GivenSig +GivenImpl ::= GivenType ([‘=’ Expr] | TemplateBody) + | ConstrApps TemplateBody +GivenConditional ::= DefTypeParamClause + | DefTermParamClause + | '(' FunArgTypes ')' + | GivenType +GivenType ::= AnnotType1 {id [nl] AnnotType1} + +TypeDef ::= id [TypeParamClause] TypeAndCtxBounds +TypeParamBounds ::= TypeAndCtxBounds +TypeAndCtxBounds ::= TypeBounds [‘:’ ContextBounds] +ContextBounds ::= ContextBound | '{' ContextBound {',' ContextBound} '}' +ContextBound ::= Type ['as' id] + +FunType ::= FunTypeArgs (‘=>’ | ‘?=>’) Type + | DefTypeParamClause '=>' Type +FunExpr ::= FunParams (‘=>’ | ‘?=>’) Expr + | DefTypeParamClause ‘=>’ Expr +``` + +## Compatibility + +All additions are fully compatible with existing Scala 3. The prototype implementation contains a parser that accepts both old and new idioms. That said, we would +want to deprecate and remove over time the following existing syntax: + + 1. Multiple context bounds of the form `X : A : B : C`. + 2. The previous syntax for given clauses which required a `:` in front of the implemented type and a `with` after it. + 3. Abstract givens + +The changes under (1) and (2) can be automated using existing rewrite technology in the compiler or Scalafix. The changes in (3) are more global in nature but are still straightforward. + +## Alternatives + +One alternative put forward in the Pre-SIP was to deprecate context bounds altogether and only promote using clauses. This would still be a workable system and arguably lead to a smaller language. On the other hand, dropping context bounds for using clauses worsens +some of the ergonomics of expressing type classes. First, it is longer. Second, it separates the introduction of a type name and the constraints on that type name. Typically, there can be many normal parameters between a type parameter and the using clause that characterized it. By contrast, context bounds follow the +general principle that an entity should be declared together with its type, and in a very concrete sense context bounds define types of types. So I think context bounds are here to stay, and improvements to the ergonomics of context bounds will be appreciated. + +The Pre-SIP also contained a proposal for a default naming convention of context bounds. If no explicit `as` clause is given, the name of the witness for +`X : C` would be `X`, instead of a synthesized name as is the case now. This led to extensive discussions how to accommodate multiple context bounds. +I believe that a default naming convention for witnesses will be very beneficial in the long run, but as of today there are several possible candidate solutions, including: + + 1. Use default naming for single bounds only. + 2. If there are multiple bounds, as in `X: {A, B, C}` create a synthetic companion object `X` where selections `X.m` translate into + witness selections `A.m`, `B.m`, or `C.m`. Disallow any references to the companion that remain after that expansion. + 3. Like (2), but use the synthetic companion approach also for single bounds. + 4. Create real aggregate given objects that represent multiple bounds. + +Since it is at present not clear what the best solution would be, I decided to defer the question of default names to a later SIP. + +This SIP proposed originally a different syntax for givens that made use +of postfix `as name` for optional names and still followed method syntax in some elements. The 9x2 variants of the original proposal are as follows. + +```scala + // Simple typeclass + given Ord[Int]: + def compare(x: Int, y: Int) = ... + + // Parameterized typeclass + given [A: Ord] => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Typeclass with context parameter + given [A](using Ord[A]) => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Typeclass with named context parameter + given [A](using ord: Ord[A]) => Ord[List[A]]: + def compare(x: List[A], y: List[A]) = ... + + // Simple alias + given Ord[Int] = IntOrd() + + // Parameterized alias + given [A: Ord] => Ord[List[A]] = + ListOrd[A] + + // Alias with explicit context parameter + given [A](using Ord[A]) => Ord[List[A]] = + ListOrd[A] + + // Abstract or deferred given + given Context = deferred + + // By-name given + given => Context = curCtx +``` +Named: + +```scala + // Simple typeclass + given Ord[Int] as intOrd: + def compare(x: Int, y: Int) = ... + + // Parameterized typeclass + given [A: Ord] => Ord[List[A]] as listOrd: + def compare(x: List[A], y: List[A]) = ... + + // Typeclass with context parameter + given [A](using Ord[A]) => Ord[List[A]] as listOrd: + def compare(x: List[A], y: List[A]) = ... + + // Typeclass with named context parameter + given [A](using ord: Ord[A]) => Ord[List[A]] as listOrd: + def compare(x: List[A], y: List[A]) = ... + + // Simple alias + given Ord[Int] as intOrd = IntOrd() + + // Parameterized alias + given [A: Ord] => Ord[List[A]] as listOrd = + ListOrd[A] + + // Alias with using clause + given [A](using Ord[A]) => Ord[List[A]] as listOrd = + ListOrd[A] + + // Abstract or deferred given + given Context as context = deferred + + // By-name given + given => Context as context = curCtx +``` + +The discussion on contributors raised some concerns with that original proposal. One concern was that changing to postfix `as` for optional names +would be too much of a change, in particular for simple given aliases. Another concern was that the `=>` felt unfamiliar in this place since it resembled a function type yet other syntactic elements followed method syntax. The revised proposal given here addresses these points by +going back to the usual `name:` syntax for optional names and doubling down +on function syntax to reinforce the intuition that givens implement types. + + +## Summary + +The proposed set of changes removes awkward syntax and makes dealing with context bounds and givens a lot more regular and pleasant. In summary, the main proposed changes are: + + 1. Allow to name context bounds with `as` clauses. + 2. Introduce a less cryptic syntax for multiple context bounds. + 3. Refine the rules how context bounds are expanded to account for explicit names. + 4. Allow context bounds on type members which expand to deferred givens. + 5. Drop abstract givens since they are largely redundant with deferred givens. + 6. Allow context bounds for polymorphic functions. + 7. Introduce a more regular and clearer syntax for givens. + +These changes were implemented under the experimental language import +```scala +import language.experimental.modularity +``` +which also covers some other prospective changes slated to be proposed future SIPs. The new system has proven to work well and to address several fundamental issues people were having with +existing implementation techniques for type classes. + +The changes proposed in this SIP are time-sensitive since we would like to correct some awkward syntax choices in Scala 3 before more code migrates to the new constructs (so far, it seems most code still uses Scala 2 style implicits, which will eventually be phased out). It is easy to migrate to the new syntax and to support both old and new for a transition period. diff --git a/_sips/sips/unroll-default-arguments-for-binary-compatibility.md b/_sips/sips/unroll-default-arguments-for-binary-compatibility.md deleted file mode 100644 index 36c9e1e768..0000000000 --- a/_sips/sips/unroll-default-arguments-for-binary-compatibility.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: SIP-61 - Unroll Default Arguments for Binary Compatibility -status: waiting-for-implementation -pull-request-number: 78 -stage: implementation - ---- diff --git a/_sips/sips/unroll-default-arguments.md b/_sips/sips/unroll-default-arguments.md new file mode 100644 index 0000000000..42ea8ac365 --- /dev/null +++ b/_sips/sips/unroll-default-arguments.md @@ -0,0 +1,934 @@ +--- +layout: sip +permalink: /sips/:title.html +stage: completed +status: under-review +title: SIP-61 - Unroll Default Arguments for Binary Compatibility +--- + +**By: Li Haoyi** + +## History + +| Date | Version | +|---------------|--------------------| +| Feb 14th 2024 | Initial Draft | + +## Summary + +This SIP proposes an `@unroll` annotation lets you add additional parameters +to method `def`s,`class` construtors, or `case class`es, without breaking binary +compatibility. `@unroll` works by generating "unrolled" or "telescoping" forwarders: + +```scala +// Original +def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = s + n + b + l + +// Generated +def foo(s: String, n: Int, b: Boolean) = foo(s, n, b, 0) +def foo(s: String, n: Int) = foo(s, n, true, 0) +``` + +In contrast to most existing or proposed alternatives that require you to contort your +code to become binary compatible (see [Major Alternatives](#major-alternatives)), +`@unroll` allows you to write Scala with vanilla `def`s/`class`es/`case class`es, add +a single annotation, and your code will maintain binary compatibility as new default +parameters and fields are added over time. + +`@unroll`'s only constraints are that: + +1. New parameters need to have a default value +2. New parameters can only be added on the right +3. The `@unroll`ed methods must be abstract or final + +These are both existing industry-wide standard when dealing with data and schema evolution +(e.g. [Schema evolution in Avro, Protocol Buffers and Thrift — Martin Kleppmann’s blog](https://martin.kleppmann.com/2012/12/05/schema-evolution-in-avro-protocol-buffers-thrift.html)), +and are also the way the new parameters interact with _source compatibility_ in +the Scala language. Thus these constraints should be immediately familiar to any +experienced programmers, and would be easy to follow without confusion. + +Prior Discussion can be found [here](https://contributors.scala-lang.org/t/can-we-make-adding-a-parameter-with-a-default-value-binary-compatible/6132) + +## Motivation + +Maintaining binary compatibility of Scala libraries as they evolve over time is +difficult. Although tools like https://github.com/lightbend/mima help _surface_ +issues, actually _resolving_ those issues is a different challenge. + +Some kinds of library changes are fundamentally impossible to make compatible, +e.g. removing methods or classes. But there is one big class of binary compatibility +issues that are "spurious": adding default parameters to methods, `class` constructors, +or `case class`es. + +Adding a default parameter is source-compatible, but not binary compatible: a user +downstream of a library that adds a default parameter does not need to make any +changes to their code, but _does_ need to re-compile it. This is "spurious" because +there is no _fundamental_ incompatibility here: semantically, a new default parameter +is meant to be optional! Old code invoking that method without a new default parameter +is exactly the user intent, and works just fine if the downstream code is re-compiled. + +Other languages, such as Python, have the same default parameter language feature but face +no such compatibility issues with their use. Even Scala codebases compiled from source +do not suffer these restrictions: adding a default parameter to the right side of a parameter +list is for all intents and purposes backwards compatible in a mono-repo setup. +The fact that such addition is binary incompatible is purely an implementation restriction +of Scala's binary artifact format and distribution strategy. + +**Binary compatibility is generally more important than Source compatibility**. When +you hit a source compatibility issue, you can always change the source code you are +compiling, whether manually or via your build tool. In contrast, when you hit binary +compatibility issues, it can come in the form of diamond dependencies that would require +_re-compiling all of your transitive dependencies_, a task that is far more difficult and +often impractical. + +There are many approaches to resolving these "spurious" binary compatibility issues, +but most of them involve either tremendous amounts of boilerplate writing +binary-compatibility forwarders, giving up on core language features like Case Classes +or Default Parameters, or both. Consider the following code snippet +([link](https://github.com/com-lihaoyi/mainargs/blob/1d04a6bd19aaca401d11fe26da31615a8bc9213c/mainargs/src/Parser.scala)) +from the [com-lihaoyi/mainargs](https://github.com/com-lihaoyi/mainargs) library, which +duplicates the parameters of `def constructEither` no less than five times in +order to maintain binary compatibility as the library evolves and more default +parameters are added to `def constructEither`: + +```scala + def constructEither( + args: Seq[String], + allowPositional: Boolean, + allowRepeats: Boolean, + totalWidth: Int, + printHelpOnExit: Boolean, + docsOnNewLine: Boolean, + autoPrintHelpAndExit: Option[(Int, PrintStream)], + customName: String, + customDoc: String, + sorted: Boolean, + ): Either[String, T] = constructEither( + args, + allowPositional, + allowRepeats, + totalWidth, + printHelpOnExit, + docsOnNewLine, + autoPrintHelpAndExit, + customName, + customDoc, + sorted, + ) + + def constructEither( + args: Seq[String], + allowPositional: Boolean = false, + allowRepeats: Boolean = false, + totalWidth: Int = 100, + printHelpOnExit: Boolean = true, + docsOnNewLine: Boolean = false, + autoPrintHelpAndExit: Option[(Int, PrintStream)] = Some((0, System.out)), + customName: String = null, + customDoc: String = null, + sorted: Boolean = true, + nameMapper: String => Option[String] = Util.kebabCaseNameMapper + ): Either[String, T] = ??? + + /** binary compatibility shim. */ + private[mainargs] def constructEither( + args: Seq[String], + allowPositional: Boolean, + allowRepeats: Boolean, + totalWidth: Int, + printHelpOnExit: Boolean, + docsOnNewLine: Boolean, + autoPrintHelpAndExit: Option[(Int, PrintStream)], + customName: String, + customDoc: String, + nameMapper: String => Option[String] + ): Either[String, T] = constructEither( + args, + allowPositional, + allowRepeats, + totalWidth, + printHelpOnExit, + docsOnNewLine, + autoPrintHelpAndExit, + customName, + customDoc, + sorted = true, + nameMapper = nameMapper + ) +``` + +Apart from being extremely verbose and full of boilerplate, like any boilerplate this is +also extremely error-prone. Bugs like [com-lihaoyi/mainargs#106](https://github.com/com-lihaoyi/mainargs/issues/106) +slip through when a mistake is made in that boilerplate. These bugs are impossible to catch +using a normal test suite, as they only appear in the presence of version skew. The above code +snippet actually _does_ have such a bug, that the test suite _did not_ catch. See if you can +spot it! + +Sebastien Doraene's talk [Designing Libraries for Source and Binary Compatibility](https://www.youtube.com/watch?v=2wkEX6MCxJs) +explores some of the challenges, and discusses the workarounds. + + +## Requirements + +### Backwards Compatibility + +Given: + +* Two libraries, **Upstream** and **Downstream**, where **Downstream** depends on **Upstream** + +* If we use a _newer_ version of **Upstream** which contains an added + default parameter together with an _older_ version of **Downstream** compiled + against an _older_ version of **Upstream** before that default parameter was added + +* The behavior should be binary compatible and semantically indistinguishable from using + a verion of **Downstream** compiled against the _newer_ version of **Upstream** + +**Note:** we do not aim for _Forwards_ compatibility. Using an _older_ +version of **Upstream** with a _newer_ version of **Downstream** compiled against a +_newer_ version of **Upstream** is not a use case we want to support. The vast majority +of OSS software does not promise forwards compatibility, including software such as +the JVM, so we should just follow suite + +### All Overrides Are Equivalent + +All versions of an `@unroll`ed method `def foo` should have the same semantics when called +with the same parameters. We must be careful to ensure: + +1. All our different method overrides point at the same underlying implementation +2. Abstract methods are properly implemented, and no method would fail with an + `AbstractMethodError` when called +3. We properly forward the necessary argument and default parameter values when + calling the respective implementation. + +## Proposed solution + + +The proposed solution is to provide a `scala.annotation.unroll` annotation, that +can be applied to methods `def`s, `class` constructors, or `case class`es to generate +"unrolled" or "telescoping" versions of a method that forward to the primary implementation: + +```scala + def constructEither( + args: Seq[String], + allowPositional: Boolean = false, + allowRepeats: Boolean = false, + totalWidth: Int = 100, + printHelpOnExit: Boolean = true, + docsOnNewLine: Boolean = false, + autoPrintHelpAndExit: Option[(Int, PrintStream)] = Some((0, System.out)), + customName: String = null, + customDoc: String = null, + @unroll sorted: Boolean = true, + @unroll nameMapper: String => Option[String] = Util.kebabCaseNameMapper + ): Either[String, T] = ??? +``` + +This allows the developer to write the minimal amount of code they _want_ to write, +and add a single annotation to allow binary compatibility to old versions. In this +case, we annotated `sorted` and `nameMapper` with `@unroll`, which generates forwarders that make +`def constructEither` binary compatible with older versions that have fewer parameters, +up to a version before `sorted` or `nameMapper` was added. Any existing method `def`, `class`, or +`case class` can be evolved in this way, by addition of `@unroll` the first time +a default argument is added to their signature after its initial definition. + +### Unrolling `def`s + +Consider a library that is written as follows: + +```scala +object Unrolled{ + def foo(s: String, n: Int = 1) = s + n + b + l +} +``` + +If over time a new default parameter is added: + +```scala +object Unrolled{ + def foo(s: String, n: Int = 1, b: Boolean = true) = s + n + b + l +} +``` + +And another + +```scala +object Unrolled{ + def foo(s: String, n: Int = 1, b: Boolean = true, l: Long = 0) = s + n + b + l +} +``` + +This is a source-compatible change, but not binary-compatible: JVM bytecode compiled against an +earlier version of the library would be expecting to call `def foo(String, Int)`, but will fail +because the signature is now `def foo(String, Int, Boolean)` or `def foo(String, Int, Boolean, Long)`. +On the JVM this will result in a `MethodNotFoundError` at runtime, a common experience for anyone +who upgrading the versions of their dependencies. Similar concerns are present with Scala.js and +Scala-Native, albeit the failure happens at link-time rather than run-time + +`@unroll` is an annotation that can be applied as follows, to the first "additional" default +parameter that was added in each published version of the library (in this case, +`b: Boolean = true` and `l: Long = 0`) + + +```scala +import scala.annotation.unroll + +object Unrolled{ + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = s + n + b + l +} +``` + +The `@unroll` annotation takes `def foo` and generates synthetic forwarders for the purpose +of maintaining binary compatibility for old callers who may be expecting the previous signature. +These forwarders do nothing but forward the call to the current implementation, using the +given default parameter values: + +```scala +object Unrolled{ + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = s + n + b + l + + def foo(s: String, n: Int, b: Boolean) = foo(s, n, b, 0) + def foo(s: String, n: Int) = foo(s, n, true, 0) +} +``` + +As a result, old callers who expect `def foo(String, Int, Boolean)` or `def foo(String, Int, Boolean, Long)` +can continue to work, even as new parameters are added to `def foo`. The only restriction is that +new parameters can only be added on the right, and they must be provided with a default value. + +If multiple default parameters are added at once (e.g. `b` and `l` below) you can also +choose to only `@unroll` the first default parameter of each batch, to avoid generating +unnecessary forwarders: + +```scala +object Unrolled{ + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, l: Long = 0) = s + n + b + l + + def foo(s: String, n: Int) = foo(s, n, true, 0) +} +``` + +If there are multiple parameter lists (e.g. for curried methods or methods taking implicits) only one +parameter list can be unrolled (though it does not need to be the first one). e.g. this works: + +```scala +object Unrolled{ + def foo(s: String, + n: Int = 1, + @unroll b: Boolean = true, + @unroll l: Long = 0) + (implicit blah: Blah) = s + n + b + l +} +``` + +As does this + +```scala +object Unrolled{ + def foo(blah: Blah) + (s: String, + n: Int = 1, + @unroll b: Boolean = true, + @unroll l: Long = 0) = s + n + b + l +} +``` + +`@unroll`ed methods can be defined in `object`s, `class`es, or `trait`s. Other cases are shown below. + +### Unrolling `class`es + +Class constructors and secondary constructors are treated by `@unroll` just like any +other method: + +```scala +class Unrolled(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0){ + def foo = s + n + b + l +} +``` + +Unrolls to: + +```scala +class Unrolled(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0){ + def foo = s + n + b + l + + def this(s: String, n: Int, b: Boolean) = this(s, n, b, 0) + def this(s: String, n: Int) = this(s, n, true, 0) +} +``` + +### Unrolling `class` secondary constructors + +```scala +class Unrolled() { + var foo = "" + + def this(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = { + this() + foo = s + n + b + l + } +} +``` + +Unrolls to: + +```scala +class Unrolled() { + var foo = "" + + def this(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = { + this() + foo = s + n + b + l + } + + def this(s: String, n: Int, b: Boolean) = this(s, n, b, 0) + def this(s: String, n: Int) = this(s, n, true, 0) +} +``` + +### Case Classes + +`case class`es can also be `@unroll`ed. Unlike normal `class` constructors +and method `def`s, `case class`es have several generated methods (`apply`, `copy`) +that need to be kept in sync with their primary constructor. `@unroll` thus +generates forwarders for those methods as well, based on the presence of the +`@unroll` annotation in the primary constructor: + +```scala +case class Unrolled(s: String, n: Int = 1, @unroll b: Boolean = true){ + def foo = s + n + b +} +``` + +Unrolls to: + +```scala +case class Unrolled(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0L){ + def this(s: String, n: Int) = this(s, n, true, 0L) + def this(s: String, n: Int, b: Boolean) = this(s, n, b, 0L) + + def copy(s: String, n: Int) = copy(s, n, this.b, this.l) + def copy(s: String, n: Int, b: Boolean) = copy(s, n, b, this.l) + + def foo = s + n + b +} +object Unrolled{ + def apply(s: String, n: Int) = apply(s, n, true, 0L) + def apply(s: String, n: Int, b: Boolean) = apply(s, n, b, 0L) +} +``` + +Notes: + +1. `@unroll`ed `case class`es are fully binary and backwards compatible in Scala 3, but not in Scala 2 + +2. `.unapply` does not need to be duplicated in Scala 3.x, as its signature + `def unapply(x: Unrolled): Unrolled` does not change when new `case class` fields are + added. + +3. Even in Scala 2.x, where `def unapply(x: Unrolled): Option[TupleN]` is not + binary compatible, pattern matching on `case class`es is already binary compatible + to addition of new fields due to + [Option-less Pattern Matching](https://docs.scala-lang.org/scala3/reference/changed-features/pattern-matching.html). + Thus, only calls to `.tupled` or `.curried` on the `case class` companion `object`, or direct calls + to `.unapply` on an unrolled `case class` in Scala 2.x (shown below) + will cause a crash if additional fields were added: + +```scala +def foo(t: (String, Int)) = println(t) +Unrolled.unapply(unrolled).map(foo) +``` + +In Scala 3, `@unroll`ing a `case class` also needs to generate a `fromProduct` +implementation in the companion object, as shown below: + +```scala +def fromProduct(p: Product): CaseClass = p.productArity match + case 2 => + CaseClass( + p.productElement(0).asInstanceOf[...], + p.productElement(1).asInstanceOf[...], + ) + case 3 => + CaseClass( + p.productElement(0).asInstanceOf[...], + p.productElement(1).asInstanceOf[...], + p.productElement(2).asInstanceOf[...], + ) + ... +``` + +This is not necessary for preserving binary compatibility - the method signature of +`def fromProduct` does not change depending on the number of fields - but it is +necessary to preserve semantic compatibility. `fromProduct` by default does not +take into account field default values, and this change is necessary to make it +use them when the given `p: Product` has a smaller `productArity` than the current +`CaseClass` implementation + + +### Hiding Generated Forwarder Methods + +As the generated forwarder methods are intended only for binary compatibility purposes, +we should generally hide them: IDEs, downstream compilers, ScalaDoc, etc. should behave as +if the generated methods do not exist. + +This is done in two different ways: + +1. In Scala 2, we generate the methods in a post-`pickler` phase. This ensures they do + not appear in the scala signature, and thus are not exposed to downstream tooling + +2. In Scala 3, the generated methods are flagged as `Invisible` + +## Limitations + +### Only the one parameter list of multi-parameter list methods can be `@unroll`ed. + +Unrolling multiple parameter lists would generate a number +of forwarder methods exponential with regard to the number of parameter lists unrolled, +and the generated forwarders may begin to conflict with each other. We can choose to spec +this out and implement it later if necessary, but for 99% of use cases `@unroll`ing one +parameter list should be enough. Typically, only one parameter list in a method has default +arguments, with other parameter lists being `implicit`s or a single callback/blocks, neither +of which usually has default values. + +### Unrolled forwarder methods can collide with manually-defined overrides + +This is similar to any other generated methods. We can raise an error to help users +debug such scenarios, but such name collisions are inevitably possible given how binary +compatibility on the JVM works. + +### `@unroll`ed case classes are only fully binary compatible in Scala 3 + + +They are _almost_ binary compatible in Scala 2. Direct calls to `unapply` are binary +incompatible, but most common pattern matching of `case class`es goes through a different +code path that _is_ binary compatible. There are also the `AbstractFunctionN` traits, from +which the companion object inherits `.curried` and `.tupled` members. Luckily, `unapply` +was made binary compatible in Scala 3, and `AbstractFunctionN`, `.curried`, and `.tupled` +were removed + +### While `@unroll`ed `case class`es are *not* fully _source_ compatible + +This is due to the fact that pattern matching requires all arguments to +be specified. This proposal does not change that. Future improvements related to +[Pattern Matching on Named Fields](https://github.com/scala/improvement-proposals/pull/44) +may bring improvements here. But as we discussed earlier, binary compatibility is generally +more important than source compatibility, and so we do not need to wait for any source +compatibility improvements to land before proceeding with these binary compatibility +improvements. + +### Binary and semantic compatibility for macro-derived derive typeclasses is out of scope + + +This propsosal does not have any opinion on whether or not macro-derivation is be binary/source/semantically +compatible. That is up to the +individual macro implementations to decide. e.g., [uPickle](https://github.com/com-lihaoyi/upickle) +has a very similar rule about adding `case class` fields, except that field ordering +does not matter. Trying to standardize this across all possible macros and all possible +typeclasses is out of scope + +### `@unroll` generates a quadratic amount of generated bytecode as more default parameters are added + +Each forwarder has `O(num-params)` size, and there are `O(num-default-params)` +forwarders. We do not expect this to be a problem in practice, as the small size of the +generated forwarder methods means the constant factor is small, but one could imagine +the `O(n^2)` asymptotic complexity becoming a problem if a method accumulates hundreds of +default parameters over time. In such extreme scenarios, some kind of builder pattern +(such as those listed in [Major Alternatives](#major-alternatives)) may be preferable. + +### `@unroll` only supports `final` methods. + +`object` methods and constructors are naturally +final, but `class` or `trait` methods that are `@unroll`ed need to be explicitly marked `final`. +It has proved difficult to implement the semantics of `@unroll` in the presence of downstream +overrides, `super`, etc. where the downstream overrides can be compiled against by different +versions of the upstream code. If we can come up with some implementation that works, we can +lift this restriction later, but for now I have not managed to do so and so this restriction +stays. + +### Challenges of Non-Final Methods and Overriding + +To elaborate a bit on the issues with non-final methods and overriding, consider the following +case with four classes, `Upstream`, `Downstream`, `Main1` and `Main2`, each of which is compiled +against different versions of each other (hence the varying number of parameters for `foo`): + +```scala +class Upstream{ // V2 + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = s + n + b + l +} +``` + +```scala +class Downstream extends Upstream{ // compiled against Upstream V1 + override def foo(s: String, n: Int = 1) = super.foo(s, n) + s + n +} +``` + +```scala +object Main1 { // compiled against Upstream V2 + def main(args: Array[String]): Unit = { + new Downstream().foo("hello", 123, false, 456L) + } +} +``` + +```scala +object Main2 { // compiled against Upstream V1 + def main(args: Array[String]): Unit = { + new Downstream().foo("hello", 123) + } +} +``` + + +The challenge here is: how do we make sure that `Main1` and `Main2`, who call +`new Downstream().foo`, correctly pick up the version of `def foo` that is +provided by `Downstream`? + +With the current implementation, the `override def foo` inside `Downstream` would only +override one of `Upstream`'s synthetic forwarders, but would not override the actual +primary implementation. As a result, we would see `Main1` calling the implementation +of `foo` from `Upstream`, while `Main2` calls the implementation of `foo` from +`Downstream`. So even though both `Main1` and `Main2` have the same +`Upstream` and `Downstream` code on the classpath, they end up calling different +implementations based on what they were compiled against. + +We cannot perform the method search and dispatch _within_ the `def foo` methods, +because it depends on exactly _how_ `foo` is called: the `InvokeVirtual` call from +`Main1` is meant to resolve to `Downstream#foo`, while the `InvokeSpecial` call +from `Downstream#foo`'s `super.foo` is meant to resolve to `Upstream#foo`. But a +method implementation cannot know how it was called, and thus it is impossible +for `def foo` to forward the call to the right place. + +Like our treatment of [Abstract Methods](#abstract-methods), this scenario can never +happen according to what version combinations are supported by our definition of +[Backwards Compatibility](#backwards-compatibility), but nevertheless is a real +concern due to the requirement that [All Overrides Are Equivalent](#all-overrides-are-equivalent). + +It may be possible to loosen this restriction to also allow abstract methods that +are implemented only once by a final method. See the section about +[Abstract Methods](#abstract-methods) for details. + +## Major Alternatives + +The major alternatives to `@unroll` are listed below: + +1. [data-class](https://index.scala-lang.org/alexarchambault/data-class) +2. [SBT Contrabad](https://www.scala-sbt.org/contraband/) +3. [Structural Data Structures](https://contributors.scala-lang.org/t/pre-sip-structural-data-structures-that-can-evolve-in-a-binary-compatible-way/5684) +4. Avoiding language features like `case class`es or default parameters, as suggested by the + [Binary Compatibility for Library Authors](https://docs.scala-lang.org/overviews/core/binary-compatibility-for-library-authors.html) documentation. + +While those alternate approaches _do work_ - `data-class` and `SBT Datatype` are used heavily +in various open-source projects - I believe they are inferior to the approach that `@unroll` +takes: + +### Case Class v.s. not-a-Case-Class + +The first major difference between `@unroll` and the above alternatives is that these alternatives +all introduce something new: some kind of _not-a-case-class_ `class` that is to be used +when binary compatibility is desired. This _not-a-case-class_ has different syntax from +`case class`es, different semantics, different methods, and so on. + +In contrast, `@unroll` does not introduce any new language-level or library-level constructs. +The `@unroll` annotation is purely a compiler-backend concern for maintaining binary +compatibility. At a language level, `@unroll` allows you to keep using normal method `def`s, +`class`es and `case class`es with exactly the same syntax and semantics you have been using +all along. + +Having people be constantly choosing between _case-class_ and _not-a-case-class_ when +designing their data types, is inferior to simply using `case class`es all the time + + +### Scala Syntax v.s. Java-esque Syntax + + +The alternatives linked above all build a +Java-esque "[inner platform](https://en.wikipedia.org/wiki/Inner-platform_effect)" +on top of the Scala language, with its own conventions like `.withFoo` methods. + +In contrast, `@unroll` makes use of the existing Scala language's default parameters +to achieve the same effect. + +If we think Scala is nicer to write then Java due to its language +features, then `@unroll`'s approach of leveraging those language features is nicer +to use than the alternative's Java-esque syntax. + +Having implementation-level problems - which is what binary compatibility across version +skew is - bleed into the syntax and semantics of the language is also inferior to having it +be controlled by an annotation. Martin Odersky has said that annotations are intended for +things that do not affect typechecking, and `@unroll` fits the bill perfectly. + + +### Evolving Any Class v.s. Evolving Pre-determined Classes + +The alternatives given require that the developer has to decide _up front_ whether their +data type needs to be evolved while maintaining binary compatibility. + +In contrast, `@unroll` allows you to evolve any existing `class` or `case class`. + +In general, trying to decide which classes _will need to evolve later on_ is a difficult +task that is easy to get wrong. `@unroll` totally removes that requirement, allowing +you to take _any_ `class` or `case class` and evolve it later in a binary compatible way. + + +### Binary Compatibility for Methods and Classes + +Lastly, the above alternatives only solve _half_ the problem: how to evolve `case class`es. +This is _schema evolution_. + +Binary compatility is not just a problem for `case class`es adding new fields: normal +`class` constructors, instance method `def`s, static method `def`s, etc. have default +parameters added all the time as well. + +In contrast, `@unroll` allows the evolution of `def`s and normal `class`es, in addition +to `case class`es, all using the same approach: + +1. `@unroll`ing `case class`es is about _schema evolution_ +2. `@unroll`ing concrete method `def`s is about _API evolution_ +3. `@unroll`ing abstract method `def`s is about _protocol evolution_ + +All three cases above have analogous best practices in the broader software engineering +world: whether you are adding an optional column to a database table, adding an +optional flag to a command-line tool, are extending an existing protocol with optional +fields that may need handling by both clients and servers implementing that protocol. + +`@unroll` solves all three problems at once - schema evolution, API evolution, and protocol +evolution. It does so with the same Scala-level syntax and semantics, with the same requirements +and limitations that common schema/API/protocol-evolution best-practices have in the broader +software engineering community. + +### Abstract Methods + +Apart from `final` methods, `@unroll` also supports purely abstract methods. Consider +the following example with a trait `Unrolled` and an implementation `UnrolledObj`: + +```scala +trait Unrolled{ // version 3 + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0): String +} +``` +```scala +object UnrolledObj extends Unrolled{ // version 3 + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = s + n + b +} +``` + +This unrolls to: +```scala +trait Unrolled{ // version 3 + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0): String = foo(s, n, b) + def foo(s: String, n: Int, b: Boolean): String = foo(s, n) + def foo(s: String, n: Int): String +} +``` +```scala +object UnrolledObj extends Unrolled{ // version 3 + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = s + n + b + l + def foo(s: String, n: Int, b: Boolean) = foo(s, n, b, 0) + def foo(s: String, n: Int) = foo(s, n, true) +} +``` + +Note that both the abstract methods from `trait Unrolled` and the concrete methods +from `object UnrolledObj` generate forwarders when `@unroll`ed, but the forwarders +are generated _in opposite directions_! Unrolled concrete methods forward from longer +parameter lists to shorter parameter lists, while unrolled abstract methods forward +from shorter parameter lists to longer parameter lists. For example, we may have a +version of `object UnrolledObj` that was compiled against an earlier version of `trait Unrolled`: + + +```scala +object UnrolledObj extends Unrolled{ // version 2 + def foo(s: String, n: Int = 1, @unroll b: Boolean = true) = s + n + b + def foo(s: String, n: Int) = foo(s, n, true) +} +``` + +But further downstream code calling `.foo` on `UnrolledObj` may expect any of the following signatures, +depending on what version of `Unrolled` and `UnrolledObj` it was compiled against: + +```scala +UnrolledObj.foo(String, Int) +UnrolledObj.foo(String, Int, Boolean) +UnrolledObj.foo(String, Int, Boolean, Long) +``` + +Because such downstream code cannot know which version of `Unrolled` that `UnrolledObj` +was compiled against, we need to ensure all such calls find their way to the correct +implementation of `def foo`, which may be at any of the above signatures. This "double +forwarding" strategy ensures that regardless of _which_ version of `.foo` gets called, +it ends up eventually forwarding to the actual implementation of `foo`, with +the correct combination of passed arguments and default arguments + +```scala +UnrolledObj.foo(String, Int) // forwards to UnrolledObj.foo(String, Int, Boolean) +UnrolledObj.foo(String, Int, Boolean) // actual implementation +UnrolledObj.foo(String, Int, Boolean, Long) // forwards to UnrolledObj.foo(String, Int, Boolean) +``` + +As is the case for `@unroll`ed methods on `trait`s and `class`es, `@unroll`ed +implementations of an abtract method must be final. + +#### Are Reverse Forwarders Really Necessary? + +This "double forwarding" strategy is not strictly necessary to support +[Backwards Compatibility](#backwards-compatibility): the "reverse" forwarders +generated for abstract methods are only necessary when a downstream callsite +of `UnrolledObj.foo` is compiled against a newer version of the original +`trait Unrolled` than the `object UnrolledObj` was, as shown below: + +```scala +trait Unrolled{ // version 3 + def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0): String = foo(s, n, b) + // generated + def foo(s: String, n: Int, b: Boolean): String = foo(s, n) + def foo(s: String, n: Int): String +} +``` +```scala +object UnrolledObj extends Unrolled{ // version 2 + def foo(s: String, n: Int = 1, @unroll b: Boolean = true) = s + n + b + // generated + def foo(s: String, n: Int) = foo(s, n, true) +} +``` +```scala +// version 3 +UnrolledObj.foo("hello", 123, true, 456L) +``` + +If we did not have the reverse forwarder from `foo(String, Int, Boolean, Long)` to +`foo(String, Int, Boolean)`, this call would fail at runtime with an `AbstractMethodError`. +It also will get caught by MiMa as a `ReversedMissingMethodProblem`. + +This configuration of version is not allowed given our definition of backwards compatibility: +that definition assumes that `Unrolled` must be of a greater or equal version than `UnrolledObj`, +which itself must be of a greater or equal version than the final call to `UnrolledObj.foo`. However, +the reverse forwarders are needed to fulfill our requirement +[All Overrides Are Equivalent](#all-overrides-are-equivalent): +looking at `trait Unrolled // version 3` and `object UnrolledObj // version 2` in isolation, +we find that without the reverse forwarders the signature `foo(String, Int, Boolean, Long)` +is defined but not implemented. Such an un-implemented abstract method is something +we want to avoid, even if our artifact version constraints mean it should technically +never get called. + +## Minor Alternatives: + + +### `@unrollAll` + +Currently, `@unroll` generates a forwarder only for the annotated default parameter; +if you want to generate multiple forwarders, you need to `@unroll` each one. In the +vast majority of scenarios, we want to unroll every default parameters we add, and in +many cases default parameters are added one at a time. In this case, an `@unrollAll` +annotation may be useful, a shorthand for applying `@unroll` to the annotated default +parameter and every parameter to the right of it: + +```scala +object Unrolled{ + def foo(s: String, n: Int = 1, @unrollAll b: Boolean = true, l: Long = 0) = s + n + b + l +} +``` +```scala +object Unrolled{ + def foo(s: String, n: Int = 1, b: Boolean = true, l: Long = 0) = s + n + b + l + + def foo(s: String, n: Int, b: Boolean) = foo(s, n, b, 0) + def foo(s: String, n: Int) = foo(s, n, true, 0) +} +``` + + + +### Generating Forwarders For Parameter Type Widening or Result Type Narrowing + +While this proposal focuses on generating forwarders for addition of default parameters, +you can also imagine similar forwarders being generated if method parameter types +are widened or if result types are narrowed: + +```scala +// Before +def foo(s: String, n: Int = 1, b: Boolean = true) = s + n + b + l + +// After +def foo(@unrollType[String] s: Object, n: Int = 1, b: Boolean = true) = s.toString + n + b + l + +// Generated +def foo(s: Object, n: Int = 1, b: Boolean = true) = s.toString + n + b + l +def foo(s: String, n: Int = 1, b: Boolean = true) = foo(s, n, b) +``` + +This would follow the precedence of how Java's and Scala's covariant method return +type overrides are implemented: when a class overrides a method with a new +implementation with a narrower return type, a forwarder method is generated to +allow anyone calling the original signature \to be forwarded to the narrower signature. + +This is not currently implemented in `@unroll`, but would be a straightforward addition. + +### Incremental Forwarders or Direct Forwarders + +Given this: + +```scala +def foo(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = s + n + b + l +``` + +There are two ways to do the forwarders. First option, which I used in above, is +to have each forwarder directly call the primary method: + +```scala +def foo(s: String, n: Int, b: Boolean) = foo(s, n, b, 0) +def foo(s: String, n: Int) = foo(s, n, true, 0) +``` + +Second option is to have each forwarder incrementally call the next forwarder, which +will eventually end up calling the primary method: + +```scala +def foo(s: String, n: Int, b: Boolean) = foo(s, n, b, 0) +def foo(s: String, n: Int) = foo(s, n, true) +``` + +The first option results in shorter stack traces, while the second option results in +roughly half as much generated bytecode in the method bodies (though it's still `O(n^2)`). + +In order to allow `@unroll`ing of [Abstract Methods](#abstract-methods), we had to go with +the second option. This is because when an abstract method is overriden, it is not necessarily +true that the longest override that contains the implementation. Thus we need to forward +between the different `def foo` overrides one at a time until the override containing the +implementation is found. + + + +## Implementation & Testing + +This SIP has a full implementation for Scala {2.12, 2.13, 3} X {JVM, JS, Native} +in the following repository, as a compiler plugin: + +- https://github.com/com-lihaoyi/unroll + +As the `@unroll` annotation is purely a compile-time construct and does not need to exist +at runtime, `@unroll` can be added to Scala 2.13.x without breaking forwards compatibility. + +The linked repo also contains an extensive test suite that uses both MIMA as well +as classpath-mangling to validate that it provides both the binary and semantic +compatibility benefits claimed in this document. In fact, it has even discovered +bugs in the upstream Scala implementation related to binary compatibility, e.g. +[scala-native/scala-native#3747](https://github.com/scala-native/scala-native/issues/3747) + +I have also opened pull requests to a number of popular OSS Scala libraries, +using `@unroll` as a replacement for manually writing binary compatibility stubs, +and the 100s of lines of boilerplate reduction can be seen in the links below: + +- https://github.com/com-lihaoyi/mainargs/pull/113/files +- https://github.com/com-lihaoyi/mill/pull/3008/files +- https://github.com/com-lihaoyi/upickle/pull/555/files +- https://github.com/com-lihaoyi/os-lib/pull/254 + +These pull requests all pass both the test suite as well as the MIMA +`check-binary-compatibility` job, demonstrating that this approach does work +in real-world codebases. At time of writing, these are published under the following +artifacts and can be used in your own projects already: + +- Compiler Plugin: `ivy"com.lihaoyi::unroll-plugin:0.1.12"` +- Annotation: `ivy"com.lihaoyi::unroll-annotation:0.1.12"` From d6f006812850ae4da06df37bf20aee8765389b11 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Mon, 19 Aug 2024 08:49:21 +0000 Subject: [PATCH 2886/3075] Update SIPs state --- _sips/sips/better-fors.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_sips/sips/better-fors.md b/_sips/sips/better-fors.md index b83faf60fc..093d9ca8ef 100644 --- a/_sips/sips/better-fors.md +++ b/_sips/sips/better-fors.md @@ -1,8 +1,8 @@ --- layout: sip permalink: /sips/:title.html -stage: design -status: submitted +stage: implementation +status: waiting-for-implementation title: SIP-62 - For comprehension improvements --- @@ -378,4 +378,4 @@ As far as I know, there are no widely used Scala 3 libraries that depend on the 2. Github issue discussion about for desugaring: https://github.com/lampepfl/dotty/issues/2573 3. Scala 2 implementation of some of the improvements: https://github.com/oleg-py/better-monadic-for 4. Implementation of one of the simplifications: https://github.com/lampepfl/dotty/pull/16703 -5. Draft implementation branch: https://github.com/dotty-staging/dotty/tree/improved-fors \ No newline at end of file +5. Draft implementation branch: https://github.com/dotty-staging/dotty/tree/improved-fors From 129ba07349b1d69915ad14b76eafe76a4d765c5c Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Mon, 19 Aug 2024 08:59:58 +0000 Subject: [PATCH 2887/3075] Update SIPs state --- _sips/sips/typeclasses-syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/typeclasses-syntax.md b/_sips/sips/typeclasses-syntax.md index 89703fe0ad..0beed4b3e1 100644 --- a/_sips/sips/typeclasses-syntax.md +++ b/_sips/sips/typeclasses-syntax.md @@ -1,7 +1,7 @@ --- layout: sip stage: implementation -status: implemented +status: under-review presip-thread: https://contributors.scala-lang.org/t/pre-sip-improve-syntax-for-context-bounds-and-givens/6576/97 title: SIP-64 - Improve Syntax for Context Bounds and Givens --- From 8d4e5b806c0899a2d78343e23a18565385050b48 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Mon, 19 Aug 2024 09:13:32 +0000 Subject: [PATCH 2888/3075] Update SIPs state --- _sips/sips/unroll-default-arguments.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_sips/sips/unroll-default-arguments.md b/_sips/sips/unroll-default-arguments.md index 42ea8ac365..5af8cddeb5 100644 --- a/_sips/sips/unroll-default-arguments.md +++ b/_sips/sips/unroll-default-arguments.md @@ -1,8 +1,8 @@ --- layout: sip permalink: /sips/:title.html -stage: completed -status: under-review +stage: implementation +status: waiting-for-implementation title: SIP-61 - Unroll Default Arguments for Binary Compatibility --- From 465813b5e8746734dc2704f739a8561e34dd4973 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Mon, 19 Aug 2024 09:24:47 +0000 Subject: [PATCH 2889/3075] Update SIPs state --- _sips/sips/alternative-bind-variables.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_sips/sips/alternative-bind-variables.md b/_sips/sips/alternative-bind-variables.md index e23c202e91..58cc4d4ddd 100644 --- a/_sips/sips/alternative-bind-variables.md +++ b/_sips/sips/alternative-bind-variables.md @@ -1,8 +1,8 @@ --- layout: sip permalink: /sips/:title.html -stage: pre-sip -status: submitted +stage: implementation +status: waiting-for-implementation presip-thread: https://contributors.scala-lang.org/t/pre-sip-bind-variables-for-alternative-patterns/6321/13 title: SIP-60 - Bind variables within alternative patterns --- From 98bb8174c4f721583ca8ae552321d58a2ad3de8c Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 20 Aug 2024 00:24:19 +0000 Subject: [PATCH 2890/3075] Update SIPs state --- _sips/sips/binary-integer-literals.md | 4 ++-- _sips/sips/clause-interleaving.md | 4 ++-- _sips/sips/multiple-assignments.md | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/_sips/sips/binary-integer-literals.md b/_sips/sips/binary-integer-literals.md index 0a854792f6..ef761601fb 100644 --- a/_sips/sips/binary-integer-literals.md +++ b/_sips/sips/binary-integer-literals.md @@ -1,8 +1,8 @@ --- layout: sip title: SIP-42 - Support Binary Integer Literals -stage: implementation -status: waiting-for-implementation +stage: completed +status: shipped permalink: /sips/:title.html --- diff --git a/_sips/sips/clause-interleaving.md b/_sips/sips/clause-interleaving.md index 120271e8d0..69619914d6 100644 --- a/_sips/sips/clause-interleaving.md +++ b/_sips/sips/clause-interleaving.md @@ -1,8 +1,8 @@ --- layout: sip title: SIP-47 - Clause Interleaving -stage: implementation -status: under-review +stage: completed +status: accepted permalink: /sips/:title.html --- diff --git a/_sips/sips/multiple-assignments.md b/_sips/sips/multiple-assignments.md index 17aef2a470..b55044b7d9 100644 --- a/_sips/sips/multiple-assignments.md +++ b/_sips/sips/multiple-assignments.md @@ -2,7 +2,7 @@ layout: sip permalink: /sips/:title.html stage: implementation -status: waiting-for-implementation +status: under-review presip-thread: https://contributors.scala-lang.org/t/pre-sip-multiple-assignments/6425 title: SIP-59 - Multiple Assignments --- From b1cef556a7a8336cc096ac2b55a88f65cfded2e3 Mon Sep 17 00:00:00 2001 From: rohantheman <rohantheman@users.noreply.github.com> Date: Mon, 19 Aug 2024 23:31:20 -0400 Subject: [PATCH 2891/3075] Update domain-modeling-fp.md Corrected the word "receiver" which was misspelt as "reciever" --- _overviews/scala3-book/domain-modeling-fp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/domain-modeling-fp.md b/_overviews/scala3-book/domain-modeling-fp.md index ce72aca425..bc08f034c2 100644 --- a/_overviews/scala3-book/domain-modeling-fp.md +++ b/_overviews/scala3-book/domain-modeling-fp.md @@ -777,7 +777,7 @@ extension (p: Pizza) p.copy(crustType = ct) ``` In the above code, we define the different methods on pizzas as _extension methods_. -With `extension (p: Pizza)` we say that we want to make the methods available on instances of `Pizza`. The reciever +With `extension (p: Pizza)` we say that we want to make the methods available on instances of `Pizza`. The receiver in this case is `p`. {% endtab %} From f8c066d6dfc8ca12b902190abf6fe838ef40cc49 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Tue, 20 Aug 2024 08:57:16 +0000 Subject: [PATCH 2892/3075] Update SIPs state --- _sips/sips/better-fors.md | 2 +- _sips/sips/named-tuples.md | 4 ++-- _sips/sips/replace-nonsensical-unchecked-annotation.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_sips/sips/better-fors.md b/_sips/sips/better-fors.md index 093d9ca8ef..ed614f712e 100644 --- a/_sips/sips/better-fors.md +++ b/_sips/sips/better-fors.md @@ -2,7 +2,7 @@ layout: sip permalink: /sips/:title.html stage: implementation -status: waiting-for-implementation +status: under-review title: SIP-62 - For comprehension improvements --- diff --git a/_sips/sips/named-tuples.md b/_sips/sips/named-tuples.md index bbe96e8b2d..fd20742737 100644 --- a/_sips/sips/named-tuples.md +++ b/_sips/sips/named-tuples.md @@ -2,7 +2,7 @@ layout: sip permalink: /sips/named-tuples.html stage: implementation -status: waiting-for-implementation +status: under-review presip-thread: https://contributors.scala-lang.org/t/pre-sip-named-tuples/6403/164 title: SIP-58 - Named Tuples --- @@ -774,4 +774,4 @@ type Person = (name: String, age: Int, addr: Address) def x4: Iterator[City] = run(q4) def x5: Iterator[(name: String, num: Int)] = run(q5) def x6: Iterator[(name: String, zipCode: Int)] = run(q6) -``` \ No newline at end of file +``` diff --git a/_sips/sips/replace-nonsensical-unchecked-annotation.md b/_sips/sips/replace-nonsensical-unchecked-annotation.md index def0ff658d..3bb8609940 100644 --- a/_sips/sips/replace-nonsensical-unchecked-annotation.md +++ b/_sips/sips/replace-nonsensical-unchecked-annotation.md @@ -2,7 +2,7 @@ layout: sip permalink: /sips/:title.html stage: implementation -status: waiting-for-implementation +status: under-review presip-thread: https://contributors.scala-lang.org/t/pre-sip-replace-non-sensical-unchecked-annotations/6342 title: SIP-57 - Replace non-sensical @unchecked annotations --- From 9e747560bfcb2e12ebee83b4e69ed9c441865533 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur <wmazur@virtuslab.com> Date: Wed, 21 Aug 2024 23:49:41 +0200 Subject: [PATCH 2893/3075] Add api link to 3.5.0 and 3.4.2 --- _config.yml | 2 +- api/all.md | 8 ++++++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index f257fada05..6c2949e151 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.14 scala-212-version: 2.12.19 -scala-3-version: 3.4.2 +scala-3-version: 3.5.0 collections: style: diff --git a/api/all.md b/api/all.md index 334ecac392..d67ee30084 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,8 @@ redirect_from: ## Latest releases -* Scala 3.4.2 - * [Library API](https://www.scala-lang.org/api/3.4.2/) +* Scala 3.5.0 + * [Library API](https://www.scala-lang.org/api/3.5.0/) * Scala 3.3.3 LTS * [Library API](https://www.scala-lang.org/api/3.3.3/) * Scala 2.13.14 @@ -64,6 +64,10 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.4.3 + * [Library API](https://www.scala-lang.org/api/3.4.3/) +* Scala 3.4.2 + * [Library API](https://www.scala-lang.org/api/3.4.2/) * Scala 3.4.1 * [Library API](https://www.scala-lang.org/api/3.4.1/) * Scala 3.4.0 From b833d693879803f06ebd8a18b069196a4c31c390 Mon Sep 17 00:00:00 2001 From: Philippus Baalman <philippus@gmail.com> Date: Thu, 22 Aug 2024 01:50:38 -0500 Subject: [PATCH 2894/3075] Remove obsolete version attribute (#3061) --- docker-compose.yml | 2 -- 1 file changed, 2 deletions(-) diff --git a/docker-compose.yml b/docker-compose.yml index 98cd0dda02..75b1876399 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1,5 +1,3 @@ -version: '2' - services: jekyll: user: "${UID}:${GID}" From 6531126ab568165835de5100f68b3a2d3fe1bb46 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 22 Aug 2024 20:38:36 +0000 Subject: [PATCH 2895/3075] Bump rexml from 3.2.8 to 3.3.6 Bumps [rexml](https://github.com/ruby/rexml) from 3.2.8 to 3.3.6. - [Release notes](https://github.com/ruby/rexml/releases) - [Changelog](https://github.com/ruby/rexml/blob/master/NEWS.md) - [Commits](https://github.com/ruby/rexml/compare/v3.2.8...v3.3.6) --- updated-dependencies: - dependency-name: rexml dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 06dccdc0b6..a08325d034 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -251,8 +251,8 @@ GEM rb-fsevent (0.11.2) rb-inotify (0.10.1) ffi (~> 1.0) - rexml (3.2.8) - strscan (>= 3.0.9) + rexml (3.3.6) + strscan rouge (3.30.0) ruby2_keywords (0.0.5) rubyzip (2.3.2) From 6e9494121d252879d412c2137226d35bf5012401 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 22 Aug 2024 21:15:31 +0000 Subject: [PATCH 2896/3075] Bump github-pages from 231 to 232 Bumps [github-pages](https://github.com/github/pages-gem) from 231 to 232. - [Release notes](https://github.com/github/pages-gem/releases) - [Commits](https://github.com/github/pages-gem/compare/v231...v232) --- updated-dependencies: - dependency-name: github-pages dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> --- Gemfile.lock | 81 ++++++++++++++++++++++++++-------------------------- 1 file changed, 41 insertions(+), 40 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index a08325d034..e6d0e2222a 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,32 +1,33 @@ GEM remote: https://rubygems.org/ specs: - activesupport (7.1.3) + activesupport (7.2.1) base64 bigdecimal - concurrent-ruby (~> 1.0, >= 1.0.2) + concurrent-ruby (~> 1.0, >= 1.3.1) connection_pool (>= 2.2.5) drb i18n (>= 1.6, < 2) + logger (>= 1.4.2) minitest (>= 5.1) - mutex_m - tzinfo (~> 2.0) - addressable (2.8.6) - public_suffix (>= 2.0.2, < 6.0) + securerandom (>= 0.3) + tzinfo (~> 2.0, >= 2.0.5) + addressable (2.8.7) + public_suffix (>= 2.0.2, < 7.0) base64 (0.2.0) - bigdecimal (3.1.6) + bigdecimal (3.1.8) coffee-script (2.4.1) coffee-script-source execjs coffee-script-source (1.12.2) colorator (1.1.0) commonmarker (0.23.10) - concurrent-ruby (1.2.3) + concurrent-ruby (1.3.4) connection_pool (2.4.1) - dnsruby (1.70.0) + csv (3.3.0) + dnsruby (1.72.2) simpleidn (~> 0.2.1) - drb (2.2.0) - ruby2_keywords + drb (2.2.1) em-websocket (0.5.3) eventmachine (>= 0.12.9) http_parser.rb (~> 0) @@ -34,20 +35,22 @@ GEM ffi (>= 1.15.0) eventmachine (1.2.7) execjs (2.9.1) - faraday (2.9.0) + faraday (2.10.1) faraday-net_http (>= 2.0, < 3.2) - faraday-net_http (3.1.0) + logger + faraday-net_http (3.1.1) net-http - ffi (1.16.3) - ffi (1.16.3-x64-mingw-ucrt) + ffi (1.17.0-arm64-darwin) + ffi (1.17.0-x64-mingw-ucrt) + ffi (1.17.0-x86_64-linux-gnu) forwardable-extended (2.6.0) gemoji (4.1.0) - github-pages (231) + github-pages (232) github-pages-health-check (= 1.18.2) - jekyll (= 3.9.5) + jekyll (= 3.10.0) jekyll-avatar (= 0.8.0) jekyll-coffeescript (= 1.2.2) - jekyll-commonmark-ghpages (= 0.4.0) + jekyll-commonmark-ghpages (= 0.5.1) jekyll-default-layout (= 0.1.5) jekyll-feed (= 0.17.0) jekyll-gist (= 1.5.0) @@ -84,9 +87,10 @@ GEM liquid (= 4.0.4) mercenary (~> 0.3) minima (= 2.5.1) - nokogiri (>= 1.13.6, < 2.0) + nokogiri (>= 1.16.2, < 2.0) rouge (= 3.30.0) terminal-table (~> 1.4) + webrick (~> 1.8) github-pages-health-check (1.18.2) addressable (~> 2.3) dnsruby (~> 1.60) @@ -106,11 +110,12 @@ GEM yell (~> 2.0) zeitwerk (~> 2.5) http_parser.rb (0.8.0) - i18n (1.14.1) + i18n (1.14.5) concurrent-ruby (~> 1.0) - jekyll (3.9.5) + jekyll (3.10.0) addressable (~> 2.4) colorator (~> 1.0) + csv (~> 3.0) em-websocket (~> 0.5) i18n (>= 0.7, < 2) jekyll-sass-converter (~> 1.0) @@ -121,6 +126,7 @@ GEM pathutil (~> 0.9) rouge (>= 1.7, < 4) safe_yaml (~> 1.0) + webrick (>= 1.0) jekyll-avatar (0.8.0) jekyll (>= 3.0, < 5.0) jekyll-coffeescript (1.2.2) @@ -128,9 +134,9 @@ GEM coffee-script-source (~> 1.12) jekyll-commonmark (1.4.0) commonmarker (~> 0.22) - jekyll-commonmark-ghpages (0.4.0) - commonmarker (~> 0.23.7) - jekyll (~> 3.9.0) + jekyll-commonmark-ghpages (0.5.1) + commonmarker (>= 0.23.7, < 1.1.0) + jekyll (>= 3.9, < 4.0) jekyll-commonmark (~> 1.4.0) rouge (>= 2.0, < 5.0) jekyll-default-layout (0.1.5) @@ -221,23 +227,23 @@ GEM kramdown-parser-gfm (1.1.0) kramdown (~> 2.0) liquid (4.0.4) - listen (3.8.0) + listen (3.9.0) rb-fsevent (~> 0.10, >= 0.10.3) rb-inotify (~> 0.9, >= 0.9.10) + logger (1.6.0) mercenary (0.3.6) minima (2.5.1) jekyll (>= 3.5, < 5.0) jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) - minitest (5.22.2) - mutex_m (0.2.0) + minitest (5.25.1) net-http (0.4.1) uri - nokogiri (1.16.5-arm64-darwin) + nokogiri (1.16.7-arm64-darwin) racc (~> 1.4) - nokogiri (1.16.5-x64-mingw-ucrt) + nokogiri (1.16.7-x64-mingw-ucrt) racc (~> 1.4) - nokogiri (1.16.5-x86_64-linux) + nokogiri (1.16.7-x86_64-linux) racc (~> 1.4) octokit (4.25.1) faraday (>= 1, < 3) @@ -245,16 +251,15 @@ GEM parallel (1.22.1) pathutil (0.16.2) forwardable-extended (~> 2.6) - public_suffix (5.0.4) - racc (1.7.3) + public_suffix (5.1.1) + racc (1.8.1) rainbow (3.1.1) rb-fsevent (0.11.2) - rb-inotify (0.10.1) + rb-inotify (0.11.1) ffi (~> 1.0) rexml (3.3.6) strscan rouge (3.30.0) - ruby2_keywords (0.0.5) rubyzip (2.3.2) safe_yaml (1.0.5) sass (3.7.4) @@ -265,8 +270,8 @@ GEM sawyer (0.9.2) addressable (>= 2.3.5) faraday (>= 0.17.3, < 3) - simpleidn (0.2.1) - unf (~> 0.1.4) + securerandom (0.3.1) + simpleidn (0.2.3) strscan (3.1.0) terminal-table (1.8.0) unicode-display_width (~> 1.1, >= 1.1.1) @@ -274,10 +279,6 @@ GEM ethon (>= 0.9.0) tzinfo (2.0.6) concurrent-ruby (~> 1.0) - unf (0.1.4) - unf_ext - unf_ext (0.0.9.1) - unf_ext (0.0.9.1-x64-mingw-ucrt) unicode-display_width (1.8.0) uri (0.13.0) webrick (1.8.1) From 26c1b8428bebb4a24598b074e2a522e5db5de677 Mon Sep 17 00:00:00 2001 From: Jamie Thompson <bishbashboshjt@gmail.com> Date: Thu, 29 Aug 2024 09:20:21 +0100 Subject: [PATCH 2897/3075] Merge scala-cli and scala in getting-started Acknowledging SIP 46 (does not update guide otherwise) --- _overviews/getting-started/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 8c33b915dd..4cb5b2f96f 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -111,8 +111,7 @@ Along with managing JVMs, `cs setup` also installs useful command-line tools: | Commands | Description | |----------|-------------| | `scalac` | the Scala compiler | -| `scala` | the Scala REPL and script runner | -| `scala-cli`| [Scala CLI](https://scala-cli.virtuslab.org), interactive toolkit for Scala | +| `scala`, `scala-cli` | [Scala CLI](https://scala-cli.virtuslab.org), interactive toolkit for Scala | | `sbt`, `sbtn` | The [sbt](https://www.scala-sbt.org/) build tool | | `amm` | [Ammonite](https://ammonite.io/) is an enhanced REPL | | `scalafmt` | [Scalafmt](https://scalameta.org/scalafmt/) is the Scala code formatter | From 482685d0b7ccba130bb586b07d5d33c4464c8b7c Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Sat, 31 Aug 2024 00:25:15 +0000 Subject: [PATCH 2898/3075] Update SIPs state --- _sips/sips/named-tuples.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/named-tuples.md b/_sips/sips/named-tuples.md index fd20742737..db240571a4 100644 --- a/_sips/sips/named-tuples.md +++ b/_sips/sips/named-tuples.md @@ -230,7 +230,7 @@ and singleton types with case classes as underlying type (in terms of the implem We allow named patterns not just for named tuples but also for case classes. For instance: ```scala city match - case c @ City(name = "London") => println(p.population) + case c @ City(name = "London") => println(c.population) case City(name = n, zip = 1026, population = pop) => println(pop) ``` From 3705459c7de75385a88c92bfa102ca9166762174 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Mon, 2 Sep 2024 17:40:48 +0200 Subject: [PATCH 2899/3075] Scala 2.12.20 --- _config.yml | 2 +- _overviews/jdk-compatibility/overview.md | 6 ++++-- api/all.md | 22 +++++++++++++++------- 3 files changed, 20 insertions(+), 10 deletions(-) diff --git a/_config.yml b/_config.yml index 6c2949e151..27de2801e5 100644 --- a/_config.yml +++ b/_config.yml @@ -16,7 +16,7 @@ keywords: - Guide scala-version: 2.13.14 -scala-212-version: 2.12.19 +scala-212-version: 2.12.20 scala-3-version: 3.5.0 collections: diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 8d8849cc79..d02b4e1455 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| -| 23 (ea) | 3.3.5* | 2.13.15* | 2.12.20* | | +| 23 (ea) | 3.3.5* | 2.13.15* | 2.12.20 | | | 22 | 3.3.4* | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | @@ -125,7 +125,9 @@ For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/j Early access builds of JDK 23 are available. JDK 23 will be non-LTS. -We are working on adding JDK 23 support to Scala 3 and Scala 2. +Scala 2.12.20+ supports JDK 23. + +We are working on adding JDK 23 support to Scala 3 and Scala 2.13. (Support may be available in nightly builds.) For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. diff --git a/api/all.md b/api/all.md index d67ee30084..64bfde9478 100644 --- a/api/all.md +++ b/api/all.md @@ -16,14 +16,14 @@ redirect_from: * [Library API](https://www.scala-lang.org/api/2.13.14/) * [Compiler API](https://www.scala-lang.org/api/2.13.14/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.14/scala-reflect/scala/reflect/) -* Scala 2.12.19 - * [Library API](https://www.scala-lang.org/api/2.12.19/) - * [Compiler API](https://www.scala-lang.org/api/2.12.19/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.12.19/scala-reflect/scala/reflect/) +* Scala 2.12.20 + * [Library API](https://www.scala-lang.org/api/2.12.20/) + * [Compiler API](https://www.scala-lang.org/api/2.12.20/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.12.20/scala-reflect/scala/reflect/) * Scala Modules - * [XML API](https://www.scala-lang.org/api/2.12.19/scala-xml/scala/xml/) - * [Parser Combinators API](https://www.scala-lang.org/api/2.12.19/scala-parser-combinators/scala/util/parsing/) - * [Swing API](https://www.scala-lang.org/api/2.12.19/scala-swing/scala/swing/) + * [XML API](https://www.scala-lang.org/api/2.12.20/scala-xml/scala/xml/) + * [Parser Combinators API](https://www.scala-lang.org/api/2.12.20/scala-parser-combinators/scala/util/parsing/) + * [Swing API](https://www.scala-lang.org/api/2.12.20/scala-swing/scala/swing/) * Scala 2.11.12 * [Library API](https://www.scala-lang.org/api/2.11.12/) * [Compiler API](https://www.scala-lang.org/api/2.11.12/scala-compiler/) @@ -152,6 +152,14 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/2.13.0/) * [Compiler API](https://www.scala-lang.org/api/2.13.0/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.0/scala-reflect/scala/reflect/) +* Scala 2.12.20 + * [Library API](https://www.scala-lang.org/api/2.12.19/) + * [Compiler API](https://www.scala-lang.org/api/2.12.19/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.12.19/scala-reflect/scala/reflect/) + * Scala Modules + * [XML API](https://www.scala-lang.org/api/2.12.19/scala-xml/scala/xml/) + * [Parser Combinators API](https://www.scala-lang.org/api/2.12.19/scala-parser-combinators/scala/util/parsing/) + * [Swing API](https://www.scala-lang.org/api/2.12.19/scala-swing/scala/swing/) * Scala 2.12.18 * [Library API](https://www.scala-lang.org/api/2.12.18/) * [Compiler API](https://www.scala-lang.org/api/2.12.18/scala-compiler/scala/) From 12bef6991162b24545c1b26366f5a7385d185e8a Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Mon, 2 Sep 2024 18:31:45 +0200 Subject: [PATCH 2900/3075] Update api/all.md Co-authored-by: Philippus Baalman <philippus@gmail.com> --- api/all.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/all.md b/api/all.md index 64bfde9478..3ca2a703fb 100644 --- a/api/all.md +++ b/api/all.md @@ -152,7 +152,7 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/2.13.0/) * [Compiler API](https://www.scala-lang.org/api/2.13.0/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.13.0/scala-reflect/scala/reflect/) -* Scala 2.12.20 +* Scala 2.12.19 * [Library API](https://www.scala-lang.org/api/2.12.19/) * [Compiler API](https://www.scala-lang.org/api/2.12.19/scala-compiler/scala/) * [Reflection API](https://www.scala-lang.org/api/2.12.19/scala-reflect/scala/reflect/) From d8dabb94384e24135ce416d77aed61bb8aec2bf6 Mon Sep 17 00:00:00 2001 From: Chi <37254334+ChimengSoso@users.noreply.github.com> Date: Wed, 4 Sep 2024 17:35:54 +0700 Subject: [PATCH 2901/3075] Update ca-implicit-conversions.md implicit def syntax in scala 2 was return type as User. not String => User. --- _overviews/scala3-book/ca-implicit-conversions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/ca-implicit-conversions.md b/_overviews/scala3-book/ca-implicit-conversions.md index b35902d71a..0fb665eda3 100644 --- a/_overviews/scala3-book/ca-implicit-conversions.md +++ b/_overviews/scala3-book/ca-implicit-conversions.md @@ -150,7 +150,7 @@ object `Conversions`: import scala.language.implicitConversions object Conversions { - implicit def fromStringToUser(name: String): User = (name: String) => User(name) + implicit def fromStringToUser(name: String): User = User(name) } ~~~ {% endtab %} From bd2f0e2321549bc1aeb0b800b89ee266d074b5a7 Mon Sep 17 00:00:00 2001 From: Matt Bovel <matthieu@bovel.net> Date: Wed, 4 Sep 2024 16:36:07 +0200 Subject: [PATCH 2902/3075] Update Mac installation instructions - Remove specialized message for Apple Silicon. - Use the `coursier` brew formula. --- _data/setup-scala.yml | 2 +- _overviews/getting-started/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_data/setup-scala.yml b/_data/setup-scala.yml index ad8db6f598..cda4c2361b 100644 --- a/_data/setup-scala.yml +++ b/_data/setup-scala.yml @@ -2,5 +2,5 @@ linux-x86-64: curl -fL https://github.com/coursier/coursier/releases/latest/down linux-arm64: curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup macOS-x86-64: curl -fL https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup macOS-arm64: curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup -macOS-brew: brew install coursier/formulas/coursier && cs setup +macOS-brew: brew install coursier && coursier setup windows-link: https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-pc-win32.zip diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 4cb5b2f96f..5a55cb1870 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -51,7 +51,7 @@ Install it on your system with the following instructions. {% tab macOS for=install-cs-setup-tabs %} Run the following command in your terminal, following the on-screen instructions: {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-brew %} -{% altDetails cs-setup-macos-nobrew "Alternatively for Apple Silicon, or if you don't use Homebrew:" %} +{% altDetails cs-setup-macos-nobrew "Alternatively, if you don't use Homebrew:" %} On the Apple Silicon (M1, M2, …) architecture: {% include code-snippet.html language='bash' codeSnippet=site.data.setup-scala.macOS-arm64 %} Otherwise, on the x86-64 architecture: From a1c93854aa555a4d014fd2f348c0d534cf362b82 Mon Sep 17 00:00:00 2001 From: Matt Bovel <matthieu@bovel.net> Date: Wed, 4 Sep 2024 16:58:59 +0200 Subject: [PATCH 2903/3075] Fix dead links in Japanese macros documentation --- _ja/overviews/macros/usecases.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_ja/overviews/macros/usecases.md b/_ja/overviews/macros/usecases.md index 9db3bc1398..5a6767e378 100644 --- a/_ja/overviews/macros/usecases.md +++ b/_ja/overviews/macros/usecases.md @@ -20,7 +20,7 @@ Scala の商用ユーザと研究ユーザの両方がマクロを利用して ここ EPFL においても我々はマクロを活用して研究を行っている。Lightbend 社もマクロを数々のプロジェクトに採用している。 マクロはコミュニティー内でも人気があり、既にいくつかの興味深い応用が現れている。 -最近行われた講演の ["What Are Macros Good For?"](https://scalamacros.org/paperstalks/2014-02-04-WhatAreMacrosGoodFor.pdf) では Scala 2.10 ユーザのマクロの利用方法を説明し、システム化した。講演の大筋はマクロはコード生成、静的な検査、および DSL に有効であるということで、これを研究や産業からの例を交えながら説明した。 +最近行われた講演の ["What Are Macros Good For?"](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/paperstalks/2014-02-04-WhatAreMacrosGoodFor.pdf) では Scala 2.10 ユーザのマクロの利用方法を説明し、システム化した。講演の大筋はマクロはコード生成、静的な検査、および DSL に有効であるということで、これを研究や産業からの例を交えながら説明した。 -Scala'13 ワークショップにおいて ["Scala Macros: Let Our Powers Combine!"](https://scalamacros.org/paperstalks/2013-04-22-LetOurPowersCombine.pdf) という論文を発表した。これは Scala 2.10 における最先端のマクロ論をより学問的な視点から説明した。 +Scala'13 ワークショップにおいて ["Scala Macros: Let Our Powers Combine!"](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/paperstalks/2013-04-22-LetOurPowersCombine.pdf) という論文を発表した。これは Scala 2.10 における最先端のマクロ論をより学問的な視点から説明した。 この論文では Scala のリッチな構文と静的な型がマクロと相乗することを示し、また既存の言語機能をマクロによって新しい方法で活用できることを考察する。 From 770d51bf676f530d23a7e6894e6e829223cbd247 Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 4 Sep 2024 21:53:45 +0200 Subject: [PATCH 2904/3075] add "Nightly Versions of Scala" to Overviews page (#3058) undefined --- _data/overviews.yml | 3 + _ja/overviews/macros/paradise.md | 2 +- _ja/overviews/macros/typemacros.md | 2 +- _ja/overviews/macros/untypedmacros.md | 2 +- _overviews/core/nightlies.md | 87 +++++++++++++++++++++++++++ 5 files changed, 93 insertions(+), 3 deletions(-) create mode 100644 _overviews/core/nightlies.md diff --git a/_data/overviews.yml b/_data/overviews.yml index cc1534263e..5756db5e3e 100644 --- a/_data/overviews.yml +++ b/_data/overviews.yml @@ -161,6 +161,9 @@ description: "A diverse and comprehensive set of libraries is important to any productive software ecosystem. While it is easy to develop and distribute Scala libraries, good library authorship goes beyond just writing code and publishing it. In this guide, we cover the important topic of Binary Compatibility." icon: puzzle-piece url: "core/binary-compatibility-for-library-authors.html" + - title: Nightly Versions of Scala + description: "We regularly publish 'nightlies' of both Scala 3 and Scala 2 so that users can preview and test the contents of upcoming releases. Here's how to find and use these versions." + url: "core/nightlies.html" - category: "Tools" description: "Reference material on core Scala tools like the Scala REPL and Scaladoc generation." diff --git a/_ja/overviews/macros/paradise.md b/_ja/overviews/macros/paradise.md index 7c897ff357..5fd8e5de7d 100644 --- a/_ja/overviews/macros/paradise.md +++ b/_ja/overviews/macros/paradise.md @@ -19,7 +19,7 @@ title: マクロパラダイス マクロパラダイス (Macro paradise) とは Scala の複数のバージョンをサポートするコンパイラプラグインで、一般向けにリリースされている <code>scalac</code> と共に正しく動作するように設計されている。 これによって、将来の Scala に取り込まれるよりもいち早く最新のマクロ機能を使えるようになっている。 [サポートされている機能とバージョンの一覧](/ja/overviews/macros/roadmap.html))に関してはロードマップページを、 -動作の保証に関しては[マクロパラダイスのアナウンスメント](https://scalamacros.org/news/2013/08/07/roadmap-for-macro-paradise.html)を参照してほしい。 +動作の保証に関しては[マクロパラダイスのアナウンスメント](hxxps://scalamacros.org/news/2013/08/07/roadmap-for-macro-paradise.html)を参照してほしい。 ~/210x $ scalac -Xplugin:paradise_*.jar -Xshow-phases phase name id description diff --git a/_ja/overviews/macros/typemacros.md b/_ja/overviews/macros/typemacros.md index 38dae43189..0ed863eb80 100644 --- a/_ja/overviews/macros/typemacros.md +++ b/_ja/overviews/macros/typemacros.md @@ -9,7 +9,7 @@ title: 型マクロ **Eugene Yokota 訳** 型マクロ (type macro) は[マクロパラダイス](/ja/overviews/macros/paradise.html)の以前のバージョンから利用可能だったが、マクロパラダイス 2.0 ではサポートされなくなった。 -[the paradise 2.0 announcement](https://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) に説明と移行のための戦略が書かれている。 +[the paradise 2.0 announcement](hxxps://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) に説明と移行のための戦略が書かれている。 ## 直観 diff --git a/_ja/overviews/macros/untypedmacros.md b/_ja/overviews/macros/untypedmacros.md index 08ad463cd9..7b857f783b 100644 --- a/_ja/overviews/macros/untypedmacros.md +++ b/_ja/overviews/macros/untypedmacros.md @@ -9,7 +9,7 @@ title: 型指定の無いマクロ **Eugene Yokota 訳** 型指定の無いマクロ (untyped macro) は[マクロパラダイス](/ja/overviews/macros/paradise.html)の以前のバージョンから利用可能だったが、マクロパラダイス 2.0 ではサポートされなくなった。 -[the paradise 2.0 announcement](https://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) に説明と移行のための戦略が書かれている。 +[the paradise 2.0 announcement](hxxps://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) に説明と移行のための戦略が書かれている。 ## 直観 diff --git a/_overviews/core/nightlies.md b/_overviews/core/nightlies.md new file mode 100644 index 0000000000..8155ea2bfe --- /dev/null +++ b/_overviews/core/nightlies.md @@ -0,0 +1,87 @@ +--- +layout: singlepage-overview +title: Nightly Versions of Scala +permalink: /overviews/core/:title.html +--- + +We regularly publish nightly versions of both Scala 3 and 2 so that users can preview and test the contents of upcoming releases. + +Here's how to find and use these versions. + +## Scala 3 + +Scala 3 nightly versions are published to Maven Central. If you know the full version number of the nightly you want to use, you can use it just like any other Scala 3 version. + +One quick way to get that version number is to visit [https://dotty.epfl.ch](https://dotty.epfl.ch) and look in the upper left corner. + +Another way is to scrape Maven Central, as shown in this script: [https://raw.githubusercontent.com/VirtusLab/community-build3/master/scripts/lastVersionNightly.sc](https://raw.githubusercontent.com/VirtusLab/community-build3/master/scripts/lastVersionNightly.sc) + +A third way is to use [scala-cli](https://scala-cli.virtuslab.org), as follows. (Since Scala 3.5.0, the `scala` command runs `scala-cli`.) + +### scala-cli + +You can run nightlies with commands such as: + + scala-cli -S 3.nightly + scala-cli -S 3.3.nightly + +The default command is `repl`, but all the other scala-cli subcommands such as `compile` and `run` work, too. It also works with `//>` directives in your script itself, for example: + + //> using scala 3.nightly + +See this [scala-cli doc page](https://scala-cli.virtuslab.org/docs/commands/compile#scala-nightlies) for details. + +## Scala 2.13 or 2.12 + +We informally refer to Scala 2 “nightly” versions, but technically it's a misnomer. A so-called “nightly” is built for every merged PR. + +Scala 2 nightly versions are published to a special resolver. Unless you are using scala-cli, you'll need to add that resolver to your build configuration in order to use these versions. + +### quick version (sbt) + + Global / resolvers += "scala-integration" at + "https://scala-ci.typesafe.com/artifactory/scala-integration/" + scalaVersion := "2.13.15-bin-abcd123" + +For a 2.12 nightly, substitute e.g. `2.12.20` for `2.13.15`; in either case, it's the version number of the _next_ release on that branch. + +For `abcd123`, substitute the first 7 characters of the SHA of the latest commit to the [2.13.x branch](https://github.com/scala/scala/commits/2.13.x) or [2.12.x branch](https://github.com/scala/scala/commits/2.12.x) that has a green checkmark. (Clicking the checkmark will show a CI job name with the whole version in its name.) + +A quick way to find out the full version number of a current nightly is to use [scala-cli](https://scala-cli.virtuslab.org), as follows. + +### quick version (scala-cli) + +You can run nightlies with: + + scala-cli -S 2.13.nightly + scala-cli -S 2.nightly # same as 2.13.nightly + scala-cli -S 2.12.nightly + +The default command is `repl`, but all the other scala-cli subcommands such as `compile` and `run` work, too. It also works with `//>` directives in your script itself, for example: + + //> using scala 2.nightly + +### Longer explanation + +We no longer publish `-SNAPSHOT` versions of Scala 2. + +But the team does publish nightly versions, each with its own fixed version number. The version number of a nightly looks like e.g. `2.13.1-bin-abcd123`. (`-bin-` signals binary compatibility to sbt; all 2.13.x releases since 2.13.0 are binary compatible with each other.) + +To tell sbt to use one of these nightlies, you need to do three things. + +First, add the resolver where the nightlies are kept: + + Global / resolvers += "scala-integration" at + "https://scala-ci.typesafe.com/artifactory/scala-integration/" + +Second, specify the Scala version: + + scalaVersion := "2.13.1-bin-abcd123" + +But that isn't a real version number. Manually substitute a version number containing the 7-character SHA of the last commit in the [scala/scala repository](https://github.com/scala/scala) for which a nightly version was published. Look at [https://travis-ci.org/scala/scala/branches](https://travis-ci.org/scala/scala/branches) and you'll see the SHA in the upper right corner of the 2.13.x (or 2.12.x) section. + +As soon as 2.13.1 is released, the version number in the nightly will bump to 2.13.2, and so on. + +If you have a multiproject build, be sure you set these settings across all projects when you modify your build definition. Or, you may set them temporarily in the sbt shell with `++2.13.1-bin-abcd123` (sbt 0.13.x) or `++2.13.1-bin-abcd123!` (sbt 1.x; the added exclamation point is necessary to force a version not included in `crossScalaVersions` to be used). + +Ideally, we would suggest an automated way to ask Travis-CI for the right SHA. This is presumably possible via Travis-CI's API, but as far as we know, nobody has looked into it yet. (Is there a volunteer?) From 050b75d40f05c9e75c5d4b0b99edef82af0f984c Mon Sep 17 00:00:00 2001 From: crunchyfrog <49813441+truecrunchyfrog@users.noreply.github.com> Date: Sun, 8 Sep 2024 00:58:06 +0200 Subject: [PATCH 2905/3075] Update string-interpolation.md Tiny grammatic fixes to a sentence. --- _overviews/scala3-book/string-interpolation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/string-interpolation.md b/_overviews/scala3-book/string-interpolation.md index 2e47a872b1..e1c4f10054 100644 --- a/_overviews/scala3-book/string-interpolation.md +++ b/_overviews/scala3-book/string-interpolation.md @@ -34,7 +34,7 @@ The `s` that you place before the string is just one possible interpolator that provides. Scala provides three string interpolation methods out of the box: `s`, `f` and `raw`. -Further, a string interpolator is a just special method so it is possible to define your +Further, a string interpolator is just a special method, so it is possible to define your own. For instance, some database libraries define a `sql` interpolator that returns a database query. From 07a0c4674e72ad76202929062949e7ba7f62eb03 Mon Sep 17 00:00:00 2001 From: gkepka <gkepka@virtuslab.com> Date: Sun, 8 Sep 2024 13:00:11 +0200 Subject: [PATCH 2906/3075] Examples for binding patterns to variables --- _overviews/scala3-book/control-structures.md | 47 ++++++++++++++++++++ _tour/pattern-matching.md | 37 +++++++++++++++ 2 files changed, 84 insertions(+) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index 6598cb6047..b982cf654a 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -810,6 +810,53 @@ speak(Person("Bam Bam")) // "Bam Bam says, Bam bam!" {% endtab %} {% endtabs %} +#### Binding matched patterns to variables + +You can bind the matched pattern to a variable to use type-specific behavior. + +{% tabs pattern-binding class=tabs-scala-version %} +{% tab 'Scala 2' for=pattern-binding %} +```scala +trait Animal { + val name: String +} +case class Cat(name: String) extends Animal { + def meow: String = "Meow" +} +case class Dog(name: String) extends Animal { + def bark: String = "Bark" +} + +def speak(animal: Animal) = animal match { + case c @ Cat(name) if name == "Felix" => println(s"$name says, ${c.meow}!") + case d @ Dog(name) if name == "Rex" => println(s"$name says, ${d.bark}!") + case _ => println("I don't know you!") +} + +speak(Cat("Felix")) // "Felix says, Meow!" +speak(Dog("Rex")) // "Rex says, Bark!" +``` +{% endtab %} +{% tab 'Scala 3' for=pattern-binding %} +```scala +trait Animal: + val name: String +case class Cat(name: String) extends Animal: + def meow: String = "Meow" +case class Dog(name: String) extends Animal: + def bark: String = "Bark" + +def speak(animal: Animal) = animal match + case c @ Cat(name) if name == "Felix" => println(s"$name says, ${c.meow}!") + case d @ Dog(name) if name == "Rex" => println(s"$name says, ${d.bark}!") + case _ => println("I don't know you!") + +speak(Cat("Felix")) // "Felix says, Meow!" +speak(Dog("Rex")) // "Rex says, Bark!" +``` +{% endtab %} +{% endtabs %} + ### Using a `match` expression as the body of a method Because `match` expressions return a value, they can be used as the body of a method. diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index 1038e6be13..bca07f0893 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -236,6 +236,43 @@ def goIdle(device: Device): String = device match `def goIdle` has a different behavior depending on the type of `Device`. This is useful when the case needs to call a method on the pattern. It is a convention to use the first letter of the type as the case identifier (`p` and `c` in this case). +## Binding matched patterns to variables +You can use variable binding to get type-dependent behavior while simultaneously extracting fields from the matched pattern. + +{% tabs pattern-matching-variable-binding class=tabs-scala-version %} +{% tab 'Scala 2' for=pattern-matching-variable-binding %} +```scala mdoc +sealed trait Device +case class Phone(model: String) extends Device { + def screenOff = "Turning screen off" +} +case class Computer(model: String) extends Device { + def screenSaverOn = "Turning screen saver on..." +} + +def goIdle(device: Device): String = device match { + case p @ Phone(model) => s"$model: ${p.screenOff}" + case c @ Computer(model) => s"$model: ${c.screenSaverOn}" +} +``` +{% endtab %} +{% tab 'Scala 3' for=pattern-matching-variable-binding %} +```scala +sealed trait Device +case class Phone(model: String) extends Device: + def screenOff = "Turning screen off" + +case class Computer(model: String) extends Device: + def screenSaverOn = "Turning screen saver on..." + + +def goIdle(device: Device): String = device match + case p @ Phone(model) => s"$model: ${p.screenOff}" + case c @ Computer(model) => s"$model: ${c.screenSaverOn}" +``` +{% endtab %} +{% endtabs %} + ## Sealed types You may have noticed that in the examples above the base types are qualified From f2a95300f7b02c7d7f2667a6d91e4d9bf56d2073 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot <scala.improvement@epfl.ch> Date: Thu, 12 Sep 2024 00:26:08 +0000 Subject: [PATCH 2907/3075] Update SIPs state --- _sips/sips/implicit-macro-conversions.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 _sips/sips/implicit-macro-conversions.md diff --git a/_sips/sips/implicit-macro-conversions.md b/_sips/sips/implicit-macro-conversions.md new file mode 100644 index 0000000000..82e7ab2ff5 --- /dev/null +++ b/_sips/sips/implicit-macro-conversions.md @@ -0,0 +1,7 @@ +--- +title: SIP-66 - Implicit macro conversions +status: under-review +pull-request-number: 86 +stage: design + +--- From 8ec1d34527adb813140a26254b47510ffddcf3aa Mon Sep 17 00:00:00 2001 From: gkepka <gkepka@virtuslab.com> Date: Sun, 15 Sep 2024 21:20:41 +0200 Subject: [PATCH 2908/3075] Fix double declaration of classes and functions --- _tour/pattern-matching.md | 20 ++------------------ 1 file changed, 2 insertions(+), 18 deletions(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index bca07f0893..a89c16775f 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -242,15 +242,7 @@ You can use variable binding to get type-dependent behavior while simultaneously {% tabs pattern-matching-variable-binding class=tabs-scala-version %} {% tab 'Scala 2' for=pattern-matching-variable-binding %} ```scala mdoc -sealed trait Device -case class Phone(model: String) extends Device { - def screenOff = "Turning screen off" -} -case class Computer(model: String) extends Device { - def screenSaverOn = "Turning screen saver on..." -} - -def goIdle(device: Device): String = device match { +def goIdleWithModel(device: Device): String = device match { case p @ Phone(model) => s"$model: ${p.screenOff}" case c @ Computer(model) => s"$model: ${c.screenSaverOn}" } @@ -258,15 +250,7 @@ def goIdle(device: Device): String = device match { {% endtab %} {% tab 'Scala 3' for=pattern-matching-variable-binding %} ```scala -sealed trait Device -case class Phone(model: String) extends Device: - def screenOff = "Turning screen off" - -case class Computer(model: String) extends Device: - def screenSaverOn = "Turning screen saver on..." - - -def goIdle(device: Device): String = device match +def goIdleWithModel(device: Device): String = device match case p @ Phone(model) => s"$model: ${p.screenOff}" case c @ Computer(model) => s"$model: ${c.screenSaverOn}" ``` From 23d6dda0ea91c92e705e385eed176a84af68e3b2 Mon Sep 17 00:00:00 2001 From: gkepka <gkepka@virtuslab.com> Date: Mon, 16 Sep 2024 10:04:10 +0200 Subject: [PATCH 2909/3075] Use scala-cli --- _overviews/getting-started/index.md | 148 ++++++++++++++++-- _overviews/scala-book/two-types-variables.md | 3 +- .../scala3-book/methods-main-methods.md | 18 +-- _overviews/scala3-book/taste-hello-world.md | 59 ++----- .../tutorials/scala-for-java-programmers.md | 37 +++-- 5 files changed, 187 insertions(+), 78 deletions(-) diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 8c33b915dd..6ffc8444b7 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -145,6 +145,144 @@ To install them manually: or [AdoptOpenJDK 8/11](https://adoptopenjdk.net/). Refer to [JDK Compatibility](/overviews/jdk-compatibility/overview.html) for Scala/Java compatibility detail. 1. Install [sbt](https://www.scala-sbt.org/download.html) +## Using the scala-cli command + +Create a file named `hello.scala` with following code: +```scala +@main +def hello(): Unit = + println("Hello, World!") +``` + +You can define a method with `def` keyword and mark it as a "main" method with the `@main` annotation, designating it as +the entry point in program execution. The method's type is `Unit`, which means it does not return a value. `Unit` +can be thought of as an analogue to `void` keyword found in other languages. The `println` method will print the `"Hello World!"` +string to standard output. + +To run the program, execute `scala-cli run hello.scala` command. The file will be compiled and executed, with console output +similar to following: +``` +$ scala-cli run hello.scala +Compiling project (Scala 3.4.2, JVM (20)) +Compiled project (Scala 3.4.2, JVM (20)) +Hello, World! +``` + +### Handling command-line arguments + +Let's rewrite the `hello.scala` file so that the program greets the person running it. +```scala +@main +def hello(name: String): Unit = + println(s"Hello, $name!") +``` + +The `name` argument is expected to be provided when executing the program and if it's not found, the execution will fail. +The `println` method receives an interpolated string, as indicated by the `s` letter preceding its content. `$name` will be substituted by +the content of `name` argument. + +To pass the arguments when executing the program, put them after `--`: +``` +$ scala-cli run hello.scala -- Gabriel +Compiling project (Scala 3.4.2, JVM (20)) +Compiled project (Scala 3.4.2, JVM (20)) +Hello, Gabriel! +``` + +You can read more about [main methods](/scala3/book/methods-main-methods.html) and [string interpolation]((/scala3/book/string-interpolation.html)) in the Scala Book. + +### Adding dependencies + +Let's write a program that will count the files and directories present in its working directory. While in Scala you have full access to Java API for +filesystem interaction, the [os-lib](https://github.com/com-lihaoyi/os-lib) library by Li Haoyi is much more convenient to use. A dependency on the library can +be added with `//> using` directive. Put the following code in `counter.scala`. +```scala +//> using dep "com.lihaoyi::os-lib:0.10.7" + +@main +def countFiles(): Unit = + val paths = os.list(os.pwd) + println(paths.length) +``` + +In the code above, the `os.pwd` returns current working directory, which then is passed to `os.list`, which returns a sequence +of paths directly within the directory passed as argument. `val` is used to declare an immutable value, in this example storing the +sequence of paths. + +Execute the program. The dependency will be automatically downloaded. The execution should result in a similar output: +``` +$ scala-cli run counter.scala +Compiling project (Scala 3.4.2, JVM (20)) +Compiled project (Scala 3.4.2, JVM (20)) +4 +``` +The printed number should be 4: `hello.scala`, `counter.scala` and two hidden directories created automatically when a program is executed: +`.bsp` containing information about project used by IDEs, and `.scala-build` containing the results of compilation. + +As it turns out, the `os-lib` library is part of Scala Toolkit, a collection of libraries recommended for tasks like testing, +operating system interaction or handling JSONs. You can read more about libraries included in the toolkit [here](/toolkit/introduction.html). +To include the toolkit libraries, use `//> using toolkit default` directive: +```scala +//> using toolkit default + +@main +def countFiles(): Unit = + val paths = os.list(os.pwd) + println(paths.length) +``` + +This program is identical to the one above with the only difference being that other toolkit libraries will also be available to use +and their downloaded versions, instead of being specified by hand, will be the newest ones included in toolkit. + +### Using scala-cli REPL + +You can execute code interactively using REPL provided by `scala-cli` command. Execute `scala-cli` in console without any arguments. +``` +$ scala-cli +Welcome to Scala 3.4.2 (20-ea, Java OpenJDK 64-Bit Server VM). +Type in expressions for evaluation. Or try :help. + +scala> +``` + +Write a line of code to be executed and press enter. +``` +scala> println("Hello, World!") +Hello, World! + +scala> +``` + +The result will be printed immediately after executing the line. You can declare values: +``` +scala> val i = 1 +val i: Int = 1 + +scala> +``` + +A new value of type `Int` has been created. If you provide an expression that can be evaluated, its result will be stored in an automatically created value. +``` +scala> i + 3 +val res0: Int = 4 + +scala> +``` +You can exit the REPL with `:exit`. + +### Next steps + +Now that you have tasted a little bit of Scala, you can either explore the language itself, or learn how to set up a project using the +sbt and an IDE using the tutorials below. If you want to familiarize yourself with the language more, consider checking out: + +* [The Scala Book](/scala3/book/introduction.html) (see the Scala 2 version [here](/overviews/scala-book/introduction.html)), which provides a set of short lessons introducing Scala’s main features. +* [The Tour of Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. +* [Learning Resources](/learn.html), which includes online interactive tutorials and courses. +* [Our list of some popular Scala books](/books.html). +* [The migration guide](/scala3/guides/migration/compatibility-intro.html) helps you to migrate your existing Scala 2 code base to Scala 3. + +The [Scala CLI documentation](https://scala-cli.virtuslab.org/) describes the available sub-commands and how to integrate the tool with an IDE of choice. + ## Create a "Hello World" project with sbt Once you have installed sbt, you are ready to create a Scala project, which @@ -229,15 +367,5 @@ Otherwise, you can run the application from a terminal with these steps: When you’re finished experimenting with this project, press `[Enter]` to interrupt the `run` command. Then type `exit` or press `[Ctrl+D]` to exit sbt and return to your command line prompt. -## Next Steps - -Once you've finished the above tutorials, consider checking out: - -* [The Scala Book](/scala3/book/introduction.html) (see the Scala 2 version [here](/overviews/scala-book/introduction.html)), which provides a set of short lessons introducing Scala’s main features. -* [The Tour of Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. -* [Learning Resources](/learn.html), which includes online interactive tutorials and courses. -* [Our list of some popular Scala books](/books.html). -* [The migration guide](/scala3/guides/migration/compatibility-intro.html) helps you to migrate your existing Scala 2 code base to Scala 3. - ## Getting Help There are a multitude of mailing lists and real-time chat rooms in case you want to quickly connect with other Scala users. Check out our [community](https://scala-lang.org/community/) page for a list of these resources, and for where to reach out for help. diff --git a/_overviews/scala-book/two-types-variables.md b/_overviews/scala-book/two-types-variables.md index 8c6a105c79..8aa67a439a 100644 --- a/_overviews/scala-book/two-types-variables.md +++ b/_overviews/scala-book/two-types-variables.md @@ -94,8 +94,7 @@ object Hello3 extends App { As before: - Save that code in a file named *Hello3.scala* -- Compile it with `scalac Hello3.scala` -- Run it with `scala Hello3` +- Compile and run it with `scala-cli run Hello3.scala` diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index 797d7d04a4..28db85ca6f 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -22,10 +22,10 @@ Scala 3 offers a new way to define programs that can be invoked from the command {% endtab %} {% endtabs %} -To run this program, save the line of code in a file named as e.g. *Hello.scala*---the filename doesn’t have to match the method name---and run it with `scala`: +To run this program, save the line of code in a file named as e.g. *Hello.scala*---the filename doesn’t have to match the method name---and run it with `scala-cli`: ```bash -$ scala Hello.scala +$ scala-cli run Hello.scala Hello, World ``` @@ -64,10 +64,10 @@ For example, given this `@main` method that takes an `Int`, a `String`, and a va {% endtab %} {% endtabs %} -When you compile that code, it creates a main program named `happyBirthday` that’s called like this: +Pass the arguments after `--`: ``` -$ scala happyBirthday 23 Lisa Peter +$ scala-cli run happyBirthday.scala -- 23 Lisa Peter Happy 23rd Birthday, Lisa and Peter! ``` @@ -79,10 +79,10 @@ The program implemented from an `@main` method checks that there are enough argu If a check fails, the program is terminated with an error message: ``` -$ scala happyBirthday 22 +$ scala-cli run happyBirthday.scala -- 22 Illegal command line after first argument: more arguments expected -$ scala happyBirthday sixty Fred +$ scala-cli run happyBirthday.scala -- sixty Fred Illegal command line: java.lang.NumberFormatException: For input string: "sixty" ``` @@ -176,11 +176,9 @@ object happyBirthday { {% endtab %} {% endtabs %} -If you place that code in a file named *happyBirthday.scala*, you can then compile it with `scalac` and run it with `scala`, as shown previously: +If you place that code in a file named *happyBirthday.scala*, you can then compile and run it with `scala-cli`, as shown previously: ```bash -$ scalac happyBirthday.scala - -$ scala happyBirthday 23 Lisa Peter +$ scala-cli run happyBirthday.scala -- 23 Lisa Peter Happy 23rd Birthday, Lisa and Peter! ``` diff --git a/_overviews/scala3-book/taste-hello-world.md b/_overviews/scala3-book/taste-hello-world.md index 4bdf996f08..df6771e023 100644 --- a/_overviews/scala3-book/taste-hello-world.md +++ b/_overviews/scala3-book/taste-hello-world.md @@ -47,53 +47,27 @@ object hello { {% endtabs %} <!-- End tabs --> -Next, compile the code with `scalac`: +Next, compile and run the code with `scala-cli`: ```bash -$ scalac hello.scala +$ scala-cli run hello.scala ``` -If you’re coming to Scala from Java, `scalac` is just like `javac`, so that command creates several files: +When you run the command for the first time, two hidden directories will be created: `.bsp` and `.scala-build`. The first +one contains the [Build Server Protocol](https://build-server-protocol.github.io/) information for IDEs, the second one contains the results +of compilation. -<!-- Display Hello World compiled outputs for each Scala Version --> -{% tabs hello-world-outputs class=tabs-scala-version %} - -{% tab 'Scala 2' for=hello-world-outputs %} -```bash -$ ls -1 -hello$.class -hello.class -hello.scala +The command should produce similar output: ``` -{% endtab %} - -{% tab 'Scala 3' for=hello-world-outputs %} -```bash -$ ls -1 -hello$package$.class -hello$package.class -hello$package.tasty -hello.scala -hello.class -hello.tasty -``` -{% endtab %} - -{% endtabs %} -<!-- End tabs --> - -Like Java, the _.class_ files are bytecode files, and they’re ready to run in the JVM. - -Now you can run the `hello` method with the `scala` command: - -```bash -$ scala hello +Compiling project (Scala 3.4.2, JVM (20)) +Compiled project (Scala 3.4.2, JVM (20)) Hello, World! ``` Assuming that worked, congratulations, you just compiled and ran your first Scala application. > More information about sbt and other tools that make Scala development easier can be found in the [Scala Tools][scala_tools] chapter. +> The Scala CLI documentation can be found [here](https://scala-cli.virtuslab.org/). ## Ask For User Input @@ -152,16 +126,13 @@ use the `+` operator on strings to join `"Hello, "` with `name` and `"!"`, makin > You can learn more about using `val` by reading [Variables and Data Types](/scala3/book/taste-vars-data-types.html). -Then compile the code with `scalac`: - -```bash -$ scalac helloInteractive.scala -``` -Then run it with `scala helloInteractive`, this time the program will pause after asking for your name, +Then run the code with `scala-cli`. This time the program will pause after asking for your name, and wait until you type a name and press return on the keyboard, looking like this: ```bash -$ scala helloInteractive +$ scala-cli run helloInteractive.scala +Compiling project (Scala 3.4.2, JVM (20)) +Compiled project (Scala 3.4.2, JVM (20)) Please enter your name: ▌ ``` @@ -169,7 +140,9 @@ Please enter your name: When you enter your name at the prompt, the final interaction should look like this: ```bash -$ scala helloInteractive +$ scala-cli run helloInteractive.scala +Compiling project (Scala 3.4.2, JVM (20)) +Compiled project (Scala 3.4.2, JVM (20)) Please enter your name: Alvin Alexander Hello, Alvin Alexander! diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index bc4a551d91..98cea7e7cb 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -160,38 +160,49 @@ package, so can be accessed from anywhere in a program. > **Note:** The following assumes you are using Scala on the command line +If we save the above program in a file called +`HelloWorld.scala`, we can run it by issuing the following +command (the greater-than sign `>` represents the shell prompt +and should not be typed): + +```shell +> scala-cli run HelloWorld.scala +``` + +The program will be automatically compiled (with compiled classes somewhere in the newly created `.scala-build` directory) +and executed, producing a similar output: +``` +Compiling project (Scala 3.4.2, JVM (20)) +Compiled project (Scala 3.4.2, JVM (20)) +Hello, World! +``` + #### Compiling From the Command Line -To compile the example, we use `scalac`, the Scala compiler. `scalac` +To compile the example, we use `scala-cli compile` command, which will invoke the Scala compiler, `scalac`. `scalac` works like most compilers: it takes a source file as argument, maybe some options, and produces one or several output files. The outputs it produces are standard Java class files. -If we save the above program in a file called -`HelloWorld.scala`, we can compile it by issuing the following -command (the greater-than sign `>` represents the shell prompt -and should not be typed): - ```shell -> scalac HelloWorld.scala +> scala-cli compile HelloWorld.scala -d . ``` -This will generate a few class files in the current directory. One of +This will generate a few class files in the current directory (`-d .` option sets the compilation output directory). One of them will be called `HelloWorld.class`, and contains a class -which can be directly executed using the `scala` command, as the +which can be directly executed using the `scala-cli` command, as the following section shows. #### Running From the Command Line -Once compiled, a Scala program can be run using the `scala` command. +Once compiled, the program can be run using the `scala-cli run` command. Its usage is very similar to the `java` command used to run Java -programs, and accepts the same options. The above example can be +programs, and accepts similar options. The above example can be executed using the following command, which produces the expected output: ```shell -> scala -classpath . HelloWorld - +> scala-cli run --main-class HelloWorld -classpath . Hello, World! ``` From 0ff5ba0f1ec0f34972283ca1a28bbf9eabbec950 Mon Sep 17 00:00:00 2001 From: gkepka <gkepka@virtuslab.com> Date: Tue, 17 Sep 2024 09:59:22 +0200 Subject: [PATCH 2910/3075] Change scala-cli to scala --- _overviews/getting-started/index.md | 34 +++++++++---------- _overviews/scala-book/two-types-variables.md | 2 +- .../scala3-book/methods-main-methods.md | 14 ++++---- _overviews/scala3-book/taste-hello-world.md | 22 ++++++------ .../tutorials/scala-for-java-programmers.md | 18 +++++----- 5 files changed, 45 insertions(+), 45 deletions(-) diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 6ffc8444b7..8d1a06b37e 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -145,7 +145,7 @@ To install them manually: or [AdoptOpenJDK 8/11](https://adoptopenjdk.net/). Refer to [JDK Compatibility](/overviews/jdk-compatibility/overview.html) for Scala/Java compatibility detail. 1. Install [sbt](https://www.scala-sbt.org/download.html) -## Using the scala-cli command +## Using the Scala CLI Create a file named `hello.scala` with following code: ```scala @@ -156,15 +156,15 @@ def hello(): Unit = You can define a method with `def` keyword and mark it as a "main" method with the `@main` annotation, designating it as the entry point in program execution. The method's type is `Unit`, which means it does not return a value. `Unit` -can be thought of as an analogue to `void` keyword found in other languages. The `println` method will print the `"Hello World!"` +can be thought of as an analogue to `void` keyword found in other languages. The `println` method will print the `"Hello, World!"` string to standard output. -To run the program, execute `scala-cli run hello.scala` command. The file will be compiled and executed, with console output +To run the program, execute `scala run hello.scala` command. The file will be compiled and executed, with console output similar to following: ``` -$ scala-cli run hello.scala -Compiling project (Scala 3.4.2, JVM (20)) -Compiled project (Scala 3.4.2, JVM (20)) +$ scala run hello.scala +Compiling project (Scala 3.5.0, JVM (20)) +Compiled project (Scala 3.5.0, JVM (20)) Hello, World! ``` @@ -183,9 +183,9 @@ the content of `name` argument. To pass the arguments when executing the program, put them after `--`: ``` -$ scala-cli run hello.scala -- Gabriel -Compiling project (Scala 3.4.2, JVM (20)) -Compiled project (Scala 3.4.2, JVM (20)) +$ scala run hello.scala -- Gabriel +Compiling project (Scala 3.5.0, JVM (20)) +Compiled project (Scala 3.5.0, JVM (20)) Hello, Gabriel! ``` @@ -211,15 +211,15 @@ sequence of paths. Execute the program. The dependency will be automatically downloaded. The execution should result in a similar output: ``` -$ scala-cli run counter.scala -Compiling project (Scala 3.4.2, JVM (20)) -Compiled project (Scala 3.4.2, JVM (20)) +$ scala run counter.scala +Compiling project (Scala 3.5.0, JVM (20)) +Compiled project (Scala 3.5.0, JVM (20)) 4 ``` The printed number should be 4: `hello.scala`, `counter.scala` and two hidden directories created automatically when a program is executed: `.bsp` containing information about project used by IDEs, and `.scala-build` containing the results of compilation. -As it turns out, the `os-lib` library is part of Scala Toolkit, a collection of libraries recommended for tasks like testing, +As it turns out, the `os-lib` library is a part of Scala Toolkit, a collection of libraries recommended for tasks like testing, operating system interaction or handling JSONs. You can read more about libraries included in the toolkit [here](/toolkit/introduction.html). To include the toolkit libraries, use `//> using toolkit default` directive: ```scala @@ -234,12 +234,12 @@ def countFiles(): Unit = This program is identical to the one above with the only difference being that other toolkit libraries will also be available to use and their downloaded versions, instead of being specified by hand, will be the newest ones included in toolkit. -### Using scala-cli REPL +### Using REPL -You can execute code interactively using REPL provided by `scala-cli` command. Execute `scala-cli` in console without any arguments. +You can execute code interactively using REPL provided by `scala` command. Execute `scala` in console without any arguments. ``` -$ scala-cli -Welcome to Scala 3.4.2 (20-ea, Java OpenJDK 64-Bit Server VM). +$ scala +Welcome to Scala 3.5.0 (20-ea, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. scala> diff --git a/_overviews/scala-book/two-types-variables.md b/_overviews/scala-book/two-types-variables.md index 8aa67a439a..3ce00a0e54 100644 --- a/_overviews/scala-book/two-types-variables.md +++ b/_overviews/scala-book/two-types-variables.md @@ -94,7 +94,7 @@ object Hello3 extends App { As before: - Save that code in a file named *Hello3.scala* -- Compile and run it with `scala-cli run Hello3.scala` +- Compile and run it with `scala run Hello3.scala` diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index 28db85ca6f..e2a30abfb1 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -22,10 +22,10 @@ Scala 3 offers a new way to define programs that can be invoked from the command {% endtab %} {% endtabs %} -To run this program, save the line of code in a file named as e.g. *Hello.scala*---the filename doesn’t have to match the method name---and run it with `scala-cli`: +To run this program, save the line of code in a file named as e.g. *Hello.scala*---the filename doesn’t have to match the method name---and run it with `scala`: ```bash -$ scala-cli run Hello.scala +$ scala run Hello.scala Hello, World ``` @@ -67,7 +67,7 @@ For example, given this `@main` method that takes an `Int`, a `String`, and a va Pass the arguments after `--`: ``` -$ scala-cli run happyBirthday.scala -- 23 Lisa Peter +$ scala run happyBirthday.scala -- 23 Lisa Peter Happy 23rd Birthday, Lisa and Peter! ``` @@ -79,10 +79,10 @@ The program implemented from an `@main` method checks that there are enough argu If a check fails, the program is terminated with an error message: ``` -$ scala-cli run happyBirthday.scala -- 22 +$ scala run happyBirthday.scala -- 22 Illegal command line after first argument: more arguments expected -$ scala-cli run happyBirthday.scala -- sixty Fred +$ scala run happyBirthday.scala -- sixty Fred Illegal command line: java.lang.NumberFormatException: For input string: "sixty" ``` @@ -176,9 +176,9 @@ object happyBirthday { {% endtab %} {% endtabs %} -If you place that code in a file named *happyBirthday.scala*, you can then compile and run it with `scala-cli`, as shown previously: +If you place that code in a file named *happyBirthday.scala*, you can then compile and run it with `scala`, as shown previously: ```bash -$ scala-cli run happyBirthday.scala -- 23 Lisa Peter +$ scala run happyBirthday.scala -- 23 Lisa Peter Happy 23rd Birthday, Lisa and Peter! ``` diff --git a/_overviews/scala3-book/taste-hello-world.md b/_overviews/scala3-book/taste-hello-world.md index df6771e023..adfdc7c25d 100644 --- a/_overviews/scala3-book/taste-hello-world.md +++ b/_overviews/scala3-book/taste-hello-world.md @@ -47,10 +47,10 @@ object hello { {% endtabs %} <!-- End tabs --> -Next, compile and run the code with `scala-cli`: +Next, compile and run the code with `scala`: ```bash -$ scala-cli run hello.scala +$ scala run hello.scala ``` When you run the command for the first time, two hidden directories will be created: `.bsp` and `.scala-build`. The first @@ -59,8 +59,8 @@ of compilation. The command should produce similar output: ``` -Compiling project (Scala 3.4.2, JVM (20)) -Compiled project (Scala 3.4.2, JVM (20)) +Compiling project (Scala 3.5.0, JVM (20)) +Compiled project (Scala 3.5.0, JVM (20)) Hello, World! ``` @@ -126,13 +126,13 @@ use the `+` operator on strings to join `"Hello, "` with `name` and `"!"`, makin > You can learn more about using `val` by reading [Variables and Data Types](/scala3/book/taste-vars-data-types.html). -Then run the code with `scala-cli`. This time the program will pause after asking for your name, +Then run the code with `scala`. This time the program will pause after asking for your name, and wait until you type a name and press return on the keyboard, looking like this: ```bash -$ scala-cli run helloInteractive.scala -Compiling project (Scala 3.4.2, JVM (20)) -Compiled project (Scala 3.4.2, JVM (20)) +$ scala run helloInteractive.scala +Compiling project (Scala 3.5.0, JVM (20)) +Compiled project (Scala 3.5.0, JVM (20)) Please enter your name: ▌ ``` @@ -140,9 +140,9 @@ Please enter your name: When you enter your name at the prompt, the final interaction should look like this: ```bash -$ scala-cli run helloInteractive.scala -Compiling project (Scala 3.4.2, JVM (20)) -Compiled project (Scala 3.4.2, JVM (20)) +$ scala run helloInteractive.scala +Compiling project (Scala 3.5.0, JVM (20)) +Compiled project (Scala 3.5.0, JVM (20)) Please enter your name: Alvin Alexander Hello, Alvin Alexander! diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index 98cea7e7cb..2bfda72ec6 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -166,43 +166,43 @@ command (the greater-than sign `>` represents the shell prompt and should not be typed): ```shell -> scala-cli run HelloWorld.scala +> scala run HelloWorld.scala ``` The program will be automatically compiled (with compiled classes somewhere in the newly created `.scala-build` directory) and executed, producing a similar output: ``` -Compiling project (Scala 3.4.2, JVM (20)) -Compiled project (Scala 3.4.2, JVM (20)) +Compiling project (Scala 3.5.0, JVM (20)) +Compiled project (Scala 3.5.0, JVM (20)) Hello, World! ``` #### Compiling From the Command Line -To compile the example, we use `scala-cli compile` command, which will invoke the Scala compiler, `scalac`. `scalac` +To compile the example, we use `scala compile` command, which will invoke the Scala compiler, `scalac`. `scalac` works like most compilers: it takes a source file as argument, maybe some options, and produces one or several output files. The outputs it produces are standard Java class files. ```shell -> scala-cli compile HelloWorld.scala -d . +> scala compile HelloWorld.scala -d . ``` -This will generate a few class files in the current directory (`-d .` option sets the compilation output directory). One of +This will generate a few class files in the current directory (`-d` option sets the compilation output directory). One of them will be called `HelloWorld.class`, and contains a class -which can be directly executed using the `scala-cli` command, as the +which can be directly executed using the `scala` command, as the following section shows. #### Running From the Command Line -Once compiled, the program can be run using the `scala-cli run` command. +Once compiled, the program can be run using the `scala run` command. Its usage is very similar to the `java` command used to run Java programs, and accepts similar options. The above example can be executed using the following command, which produces the expected output: ```shell -> scala-cli run --main-class HelloWorld -classpath . +> scala run --main-class HelloWorld -classpath . Hello, World! ``` From 09592752bebd599594fd50b9671ca6bcd85bc3d2 Mon Sep 17 00:00:00 2001 From: gkepka <gkepka@virtuslab.com> Date: Tue, 17 Sep 2024 10:34:31 +0200 Subject: [PATCH 2911/3075] Link and grammar fixes --- _overviews/getting-started/index.md | 30 ++++++++++----------- _overviews/scala3-book/taste-hello-world.md | 2 +- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 8d1a06b37e..19052399e3 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -147,16 +147,16 @@ To install them manually: ## Using the Scala CLI -Create a file named `hello.scala` with following code: +Create a file named `hello.scala` with the following code: ```scala @main def hello(): Unit = println("Hello, World!") ``` -You can define a method with `def` keyword and mark it as a "main" method with the `@main` annotation, designating it as +You can define a method with the `def` keyword and mark it as a "main" method with the `@main` annotation, designating it as the entry point in program execution. The method's type is `Unit`, which means it does not return a value. `Unit` -can be thought of as an analogue to `void` keyword found in other languages. The `println` method will print the `"Hello, World!"` +can be thought of as an analogue to the `void` keyword found in other languages. The `println` method will print the `"Hello, World!"` string to standard output. To run the program, execute `scala run hello.scala` command. The file will be compiled and executed, with console output @@ -177,9 +177,9 @@ def hello(name: String): Unit = println(s"Hello, $name!") ``` -The `name` argument is expected to be provided when executing the program and if it's not found, the execution will fail. +The `name` argument is expected to be provided when executing the program, and if it's not found, the execution will fail. The `println` method receives an interpolated string, as indicated by the `s` letter preceding its content. `$name` will be substituted by -the content of `name` argument. +the content of the `name` argument. To pass the arguments when executing the program, put them after `--`: ``` @@ -189,13 +189,13 @@ Compiled project (Scala 3.5.0, JVM (20)) Hello, Gabriel! ``` -You can read more about [main methods](/scala3/book/methods-main-methods.html) and [string interpolation]((/scala3/book/string-interpolation.html)) in the Scala Book. +You can read more about [main methods](/scala3/book/methods-main-methods.html) and [string interpolation](/scala3/book/string-interpolation.html) in the Scala Book. ### Adding dependencies -Let's write a program that will count the files and directories present in its working directory. While in Scala you have full access to Java API for +Let's write a program that will count the files and directories present in its working directory. While in Scala you have full access to the Java API for filesystem interaction, the [os-lib](https://github.com/com-lihaoyi/os-lib) library by Li Haoyi is much more convenient to use. A dependency on the library can -be added with `//> using` directive. Put the following code in `counter.scala`. +be added with the `//> using` directive. Put the following code in `counter.scala`. ```scala //> using dep "com.lihaoyi::os-lib:0.10.7" @@ -205,8 +205,8 @@ def countFiles(): Unit = println(paths.length) ``` -In the code above, the `os.pwd` returns current working directory, which then is passed to `os.list`, which returns a sequence -of paths directly within the directory passed as argument. `val` is used to declare an immutable value, in this example storing the +In the code above, the `os.pwd` returns the current working directory, which is then passed to `os.list`, which returns a sequence +of paths directly within the directory passed as an argument. `val` is used to declare an immutable value, in this example storing the sequence of paths. Execute the program. The dependency will be automatically downloaded. The execution should result in a similar output: @@ -220,8 +220,8 @@ The printed number should be 4: `hello.scala`, `counter.scala` and two hidden di `.bsp` containing information about project used by IDEs, and `.scala-build` containing the results of compilation. As it turns out, the `os-lib` library is a part of Scala Toolkit, a collection of libraries recommended for tasks like testing, -operating system interaction or handling JSONs. You can read more about libraries included in the toolkit [here](/toolkit/introduction.html). -To include the toolkit libraries, use `//> using toolkit default` directive: +operating system interaction or handling JSONs. You can read more about the libraries included in the toolkit [here](/toolkit/introduction.html). +To include the toolkit libraries, use the `//> using toolkit default` directive: ```scala //> using toolkit default @@ -231,12 +231,12 @@ def countFiles(): Unit = println(paths.length) ``` -This program is identical to the one above with the only difference being that other toolkit libraries will also be available to use -and their downloaded versions, instead of being specified by hand, will be the newest ones included in toolkit. +This program is identical to the one above, with the only difference being that other toolkit libraries will also be available to use +and their downloaded versions, instead of being specified by hand, will be the newest ones included in the toolkit. ### Using REPL -You can execute code interactively using REPL provided by `scala` command. Execute `scala` in console without any arguments. +You can execute code interactively using REPL provided by the `scala` command. Execute `scala` in console without any arguments. ``` $ scala Welcome to Scala 3.5.0 (20-ea, Java OpenJDK 64-Bit Server VM). diff --git a/_overviews/scala3-book/taste-hello-world.md b/_overviews/scala3-book/taste-hello-world.md index adfdc7c25d..ff585d9463 100644 --- a/_overviews/scala3-book/taste-hello-world.md +++ b/_overviews/scala3-book/taste-hello-world.md @@ -54,7 +54,7 @@ $ scala run hello.scala ``` When you run the command for the first time, two hidden directories will be created: `.bsp` and `.scala-build`. The first -one contains the [Build Server Protocol](https://build-server-protocol.github.io/) information for IDEs, the second one contains the results +one contains the [Build Server Protocol](https://build-server-protocol.github.io/) information for IDEs, and the second one contains the results of compilation. The command should produce similar output: From 7828e2cc280b568791aee747783d78109c5464aa Mon Sep 17 00:00:00 2001 From: Wojciech Mazur <wojciech.mazur95@gmail.com> Date: Thu, 19 Sep 2024 13:21:24 +0200 Subject: [PATCH 2912/3075] Add API links for Scala 3.5.1 --- _config.yml | 2 +- api/all.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index 27de2801e5..0d1ac45668 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.14 scala-212-version: 2.12.20 -scala-3-version: 3.5.0 +scala-3-version: 3.5.1 collections: style: diff --git a/api/all.md b/api/all.md index 3ca2a703fb..deb6ed30e2 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,8 @@ redirect_from: ## Latest releases -* Scala 3.5.0 - * [Library API](https://www.scala-lang.org/api/3.5.0/) +* Scala 3.5.1 + * [Library API](https://www.scala-lang.org/api/3.5.1/) * Scala 3.3.3 LTS * [Library API](https://www.scala-lang.org/api/3.3.3/) * Scala 2.13.14 @@ -64,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.5.0 + * [Library API](https://www.scala-lang.org/api/3.5.0/) * Scala 3.4.3 * [Library API](https://www.scala-lang.org/api/3.4.3/) * Scala 3.4.2 From 36590cb61043fb1cf1993eba466f4397bf085cb4 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur <wojciech.mazur95@gmail.com> Date: Fri, 20 Sep 2024 12:22:48 +0200 Subject: [PATCH 2913/3075] Fix ScalaFX links - scalafx.org domain is no longer available --- _overviews/tutorials/scala-on-android.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/tutorials/scala-on-android.md b/_overviews/tutorials/scala-on-android.md index 459e485ce8..49749aa85f 100644 --- a/_overviews/tutorials/scala-on-android.md +++ b/_overviews/tutorials/scala-on-android.md @@ -68,7 +68,7 @@ Make sure your `gcc` is at least version 6. [You can try following these steps]( #### The example app -if you reached this point and everything seems to work, it means you probably should be able to compile and run the example app called [HelloScala](https://github.com/makingthematrix/scalaonandroid/tree/main/helloscala). HelloScala is based on [HelloGluon](https://github.com/gluonhq/gluon-samples/tree/master/HelloGluon) from [Gluon samples](https://github.com/gluonhq/gluon-samples). Gluon is a company that maintains JavaFX and provides libraries that give us a layer of abstraction between our code and the device — be it desktop, Android, or iOS. It has some interesting implications: for example, you will see in the code that we check if we are on the desktop instead of Android, because if yes then we need to provide window size for our app. If we are on Android, we can just let the app’s window take the whole screen. If you decide to write something more complex with this tech stack, you will quickly see that you can use Gluon’s libraries and JavaFX (maybe together with [ScalaFX](http://www.scalafx.org/)) to achieve the same results other developers get by tinkering with Android SDK, while you are writing code that can be easily re-used on other platforms as well. +if you reached this point and everything seems to work, it means you probably should be able to compile and run the example app called [HelloScala](https://github.com/makingthematrix/scalaonandroid/tree/main/helloscala). HelloScala is based on [HelloGluon](https://github.com/gluonhq/gluon-samples/tree/master/HelloGluon) from [Gluon samples](https://github.com/gluonhq/gluon-samples). Gluon is a company that maintains JavaFX and provides libraries that give us a layer of abstraction between our code and the device — be it desktop, Android, or iOS. It has some interesting implications: for example, you will see in the code that we check if we are on the desktop instead of Android, because if yes then we need to provide window size for our app. If we are on Android, we can just let the app’s window take the whole screen. If you decide to write something more complex with this tech stack, you will quickly see that you can use Gluon’s libraries and JavaFX (maybe together with [ScalaFX](https://scalafx.github.io/)) to achieve the same results other developers get by tinkering with Android SDK, while you are writing code that can be easily re-used on other platforms as well. In the `pom.xml` of HelloScala you will find a list of plugins and dependencies our example app uses. Let’s take a look at some of them. @@ -136,7 +136,7 @@ If you managed to build one of the example apps and want to code something more - Install [Scene Builder](https://gluonhq.com/products/scene-builder/) and learn how to build GUI with it. Apart from the docs, you can find a lot of tutorials about it on YouTube. - Look through [Gluon’s documentation of Glisten and Attach](https://docs.gluonhq.com/) to learn how to make your app look better on a mobile device, and how to get access to your device’s features. - Download an example from [Gluon’s list of samples](https://docs.gluonhq.com/) and rewrite it to Scala. And when you do, let me know! -- Look into [ScalaFX](http://www.scalafx.org/) — a more declarative, Scala-idiomatic wrapper over JavaFX. +- Look into [ScalaFX](https://scalafx.github.io/) — a more declarative, Scala-idiomatic wrapper over JavaFX. - Download some other examples from [the “Scala on Android” repository on GitHub](https://github.com/makingthematrix/scalaonandroid). Contact me, if you write an example app of your own and want me to include it. - Join us on the official Scala discord — we have a [#scala-android channel](https://discord.gg/UuDawpq7) there. - There is also an [#android channel](https://discord.gg/XHMt6Yq4) on the “Learning Scala” discord. From 9a3105334014ee5a8b8c3481d6006805336cef9a Mon Sep 17 00:00:00 2001 From: Ren Fukaishi <40318528+jgvt5ti@users.noreply.github.com> Date: Mon, 23 Sep 2024 20:28:19 +0900 Subject: [PATCH 2914/3075] Fix typo (#3075) --- _ja/overviews/reflection/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/overviews/reflection/overview.md b/_ja/overviews/reflection/overview.md index e7d28c55fd..d884785fe5 100644 --- a/_ja/overviews/reflection/overview.md +++ b/_ja/overviews/reflection/overview.md @@ -81,7 +81,7 @@ Scala コンパイラが持つ型情報を全ては入手できない可能性 上の例では、まず `scala.reflect.runtime.universe` をインポートして (型タグを使うためには必ずインポートされる必要がある)、`l` という名前の `List[Int]` を作る。 -次に、context bound を持った型パラメータ `T` を持つ `getTypeTag` というメソッドは定義する +次に、context bound を持った型パラメータ `T` を持つ `getTypeTag` というメソッドを定義する (REPL が示すとおり、これは暗黙の evidence パラメータを定義することに等価であり、コンパイラは `T` に対する型タグを生成する)。 最後に、このメソッドに `l` を渡して呼び出し、`TypeTag` に格納される型を返す `tpe` を呼び出す。 見ての通り、正しい完全な型 (つまり、`List` の具象型引数を含むということ) である `List[Int]` が返ってきた。 From 0e67d61be08173c52bc5b7b7a815665cf1c9b24f Mon Sep 17 00:00:00 2001 From: Seth Tisue <seth@tisue.net> Date: Wed, 25 Sep 2024 10:52:58 -0600 Subject: [PATCH 2915/3075] add Scala 2.13.15 (#3076) --- _config.yml | 2 +- _overviews/FAQ/index.md | 4 ++-- _overviews/contribute/bug-reporting-guide.md | 2 +- .../core/binary-compatibility-of-scala-releases.md | 2 +- _overviews/jdk-compatibility/overview.md | 14 +++++++------- api/all.md | 12 ++++++++---- scripts/run-mdoc.sh | 4 ++-- 7 files changed, 22 insertions(+), 18 deletions(-) diff --git a/_config.yml b/_config.yml index 0d1ac45668..17af657e08 100644 --- a/_config.yml +++ b/_config.yml @@ -15,7 +15,7 @@ keywords: - Document - Guide -scala-version: 2.13.14 +scala-version: 2.13.15 scala-212-version: 2.12.20 scala-3-version: 3.5.1 diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 7d3966986e..18c901cdda 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -341,14 +341,14 @@ setting in a multi-project build. For example, if you add this to your `build.sbt`: - scalaVersion := "2.13.14" + scalaVersion := "2.13.15" that's a "bare" setting, and you might expect it to apply build-wide. But it doesn't. _It only applies to the root project._ In many cases one should instead write: - ThisBuild / scalaVersion := "2.13.14" + ThisBuild / scalaVersion := "2.13.15" Other possibilities include: diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index c7bc2636dc..d168797a2d 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -65,7 +65,7 @@ If you cannot find your issue in the issue tracker, create a new bug. The detail Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - 1. **Exact Scala version** that you are using. For example, `2.13.14` or `3.3.3`. If the bug happens in multiple versions indicate all of them. + 1. **Exact Scala version** that you are using. For example, `2.13.15` or `3.3.3`. If the bug happens in multiple versions indicate all of them. 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? diff --git a/_overviews/core/binary-compatibility-of-scala-releases.md b/_overviews/core/binary-compatibility-of-scala-releases.md index ebe205403c..e65407c926 100644 --- a/_overviews/core/binary-compatibility-of-scala-releases.md +++ b/_overviews/core/binary-compatibility-of-scala-releases.md @@ -23,7 +23,7 @@ Thus, backward compatibility precludes the removal of (non-private) methods, as For Scala 2, the *minor* version is the *third* number in a version, e.g., 10 in v2.13.10. The major version is the second number, which is 13 in our example. -Scala 2 up to 2.13.14 guarantees both backward and forward compatibility across *minor* releases within a single major release. +Scala 2 up to 2.13.15 guarantees both backward and forward compatibility across *minor* releases within a single major release. This is about to change now that [SIP-51 has been accepted](https://docs.scala-lang.org/sips/drop-stdlib-forwards-bin-compat.html), future Scala 2.13 releases may be backward compatible only. For Scala 3, the minor version is the *second* number in a version, e.g., 2 in v3.2.1. diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index d02b4e1455..99b953306f 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:---------:|:---------:|:----------:| -| 23 (ea) | 3.3.5* | 2.13.15* | 2.12.20 | | +| 23 | 3.3.5* | 2.13.15 | 2.12.20 | | | 22 | 3.3.4* | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | @@ -119,18 +119,18 @@ Scala 2.13.13+ and 2.12.19+ support JDK 22. We are working on adding JDK 22 support to the 3.3.x release series. (Support may be available in nightly builds.) -For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. +For possible Scala 2 issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. ## JDK 23 compatibility notes -Early access builds of JDK 23 are available. JDK 23 will be non-LTS. +JDK 23 is non-LTS. -Scala 2.12.20+ supports JDK 23. +Scala 2.13.15+ and Scala 2.12.20+ support JDK 23. -We are working on adding JDK 23 support to Scala 3 and Scala 2.13. -(Support may be available in nightly builds.) +We are working on adding JDK 23 support to Scala 3. +(Support may be available in nightly builds and/or release candidates.) -For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. +For possible Scala 2 issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. ## GraalVM Native Image compatibility notes diff --git a/api/all.md b/api/all.md index deb6ed30e2..0cf696bd4b 100644 --- a/api/all.md +++ b/api/all.md @@ -12,10 +12,10 @@ redirect_from: * [Library API](https://www.scala-lang.org/api/3.5.1/) * Scala 3.3.3 LTS * [Library API](https://www.scala-lang.org/api/3.3.3/) -* Scala 2.13.14 - * [Library API](https://www.scala-lang.org/api/2.13.14/) - * [Compiler API](https://www.scala-lang.org/api/2.13.14/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.13.14/scala-reflect/scala/reflect/) +* Scala 2.13.15 + * [Library API](https://www.scala-lang.org/api/2.13.15/) + * [Compiler API](https://www.scala-lang.org/api/2.13.15/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.15/scala-reflect/scala/reflect/) * Scala 2.12.20 * [Library API](https://www.scala-lang.org/api/2.12.20/) * [Compiler API](https://www.scala-lang.org/api/2.12.20/scala-compiler/scala/) @@ -98,6 +98,10 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.0.1/) * Scala 3.0.0 * [Library API](https://www.scala-lang.org/api/3.0.0/) +* Scala 2.13.14 + * [Library API](https://www.scala-lang.org/api/2.13.14/) + * [Compiler API](https://www.scala-lang.org/api/2.13.14/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.14/scala-reflect/scala/reflect/) * Scala 2.13.13 * [Library API](https://www.scala-lang.org/api/2.13.13/) * [Compiler API](https://www.scala-lang.org/api/2.13.13/scala-compiler/scala/) diff --git a/scripts/run-mdoc.sh b/scripts/run-mdoc.sh index 4f3a7da6ea..6d729df4f1 100755 --- a/scripts/run-mdoc.sh +++ b/scripts/run-mdoc.sh @@ -1,11 +1,11 @@ #!/bin/bash set -eux -cs launch --scala-version 2.13.14 org.scalameta::mdoc:2.3.3 -- \ +cs launch --scala-version 2.13.15 org.scalameta::mdoc:2.3.3 -- \ --in . \ --out /tmp/mdoc-out/ \ --classpath \ - $(cs fetch --scala-version 2.13.14 -p \ + $(cs fetch --scala-version 2.13.15 -p \ com.chuusai::shapeless:2.3.10 \ org.scala-lang::toolkit:0.1.7 \ org.scala-lang::toolkit-test:0.1.7 \ From b83cc72d3f3ca3d030b412a6a1f20d808fbe1b93 Mon Sep 17 00:00:00 2001 From: Lukas Rytz <lukas.rytz@gmail.com> Date: Wed, 25 Sep 2024 19:57:15 +0200 Subject: [PATCH 2916/3075] Document `Xsource-features:double-definitions` (#3059) --- .../scala3-migration/tooling-scala2-xsource3.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/tooling-scala2-xsource3.md b/_overviews/scala3-migration/tooling-scala2-xsource3.md index 63ecbb6e8b..e88f711c32 100644 --- a/_overviews/scala3-migration/tooling-scala2-xsource3.md +++ b/_overviews/scala3-migration/tooling-scala2-xsource3.md @@ -105,6 +105,7 @@ The following table shows backported Scala 3 language semantics available in `-X | `case-apply-copy-access`: modifiers of synthetic methods | fatal warning | constructor modifiers are used for apply / copy methods of case classes | | `case-companion-function`: companions are Functions | fatal warning at use site | synthetic case companion objects no longer extend FunctionN, but are adapted at use site with warning | | `infer-override`: override type inference | fatal warning | inferred type of member uses type of overridden member | +| `double-definitions`: definitions differing in empty parens <sup>2</sup> | fatal warning | double definition error | Example 1: @@ -114,9 +115,17 @@ Example 1: + 2 {% endhighlight %} +Example 2: + +{% highlight scala %} +class C(x: Int) { + def x(): Int = x // allowed in Scala 2, double definition error in Scala 3 +} +{% endhighlight %} + ### Changes affecting binary encoding -As of Scala 2.13.14, there are 3 changes in `-Xsource-features` that affect binary encoding of classfiles: +As of Scala 2.13.15, there are 3 changes in `-Xsource-features` that affect binary encoding of classfiles: 1. `case-apply-copy-access`: the constructor modifiers of case classes (`case class C private[p] (x: Int)`) are copied to the synthetic `apply` and `copy` methods. 1. `case-companion-function`: the synthetic companion objects of case classes no longer extend `FunctionN`. From 5cf3b51a10ea5c4c03967baa02dc78389d0efd17 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur <wojciech.mazur95@gmail.com> Date: Wed, 25 Sep 2024 22:45:45 +0200 Subject: [PATCH 2917/3075] Add Scala 3.3.4 to API links --- api/all.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/api/all.md b/api/all.md index 0cf696bd4b..c2bd36576f 100644 --- a/api/all.md +++ b/api/all.md @@ -10,8 +10,8 @@ redirect_from: * Scala 3.5.1 * [Library API](https://www.scala-lang.org/api/3.5.1/) -* Scala 3.3.3 LTS - * [Library API](https://www.scala-lang.org/api/3.3.3/) +* Scala 3.3.4 LTS + * [Library API](https://www.scala-lang.org/api/3.3.4/) * Scala 2.13.15 * [Library API](https://www.scala-lang.org/api/2.13.15/) * [Compiler API](https://www.scala-lang.org/api/2.13.15/scala-compiler/scala/) @@ -74,6 +74,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.4.1/) * Scala 3.4.0 * [Library API](https://www.scala-lang.org/api/3.4.0/) +* Scala 3.3.3 LTS + * [Library API](https://www.scala-lang.org/api/3.3.3/) * Scala 3.3.1 LTS * [Library API](https://www.scala-lang.org/api/3.3.1/) * Scala 3.3.0 LTS From 30c92bb690a41da13d42daba6f81ec321de69769 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur <wojciech.mazur95@gmail.com> Date: Thu, 26 Sep 2024 10:09:08 +0200 Subject: [PATCH 2918/3075] Fix links to git-scm.com/book --- _overviews/contribute/guide.md | 2 +- _overviews/contribute/hacker-guide.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md index beffb01868..f5307a325a 100644 --- a/_overviews/contribute/guide.md +++ b/_overviews/contribute/guide.md @@ -47,7 +47,7 @@ This is the impatient developer's checklist for the steps to submit a bug-fix pu 5. [Fix the bug, or implement the new small feature][hackers-implement], include new tests (yes, for bug fixes too). 6. [Test, rinse][hackers-test] and [test some more][partest-guide] until [all the tests pass][hackers-verify]. 7. [Commit your changes][hackers-commit] to your feature branch in your fork. Please choose your commit message based on the [Git Hygiene](https://github.com/scala/scala#user-content-git-hygiene) section of the Scala project README. -8. If necessary [re-write git history](https://git-scm.com/book/en/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( +8. If necessary [re-write git history](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) so that [commits are organized by major steps to the fix/feature]( https://github.com/scala/scala#git-hygiene). For bug fixes, a single commit is requested, for features several commits may be desirable (but each separate commit must compile and pass all tests) 9. [Submit a pull request][hackers-submit]. 10. [Work with a reviewer](https://github.com/scala/scala#reviewing) to [get your pull request merged in][hackers-review]. diff --git a/_overviews/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md index e78df88b12..ea77feee0d 100644 --- a/_overviews/contribute/hacker-guide.md +++ b/_overviews/contribute/hacker-guide.md @@ -51,7 +51,7 @@ Hacking Scala begins with creating a branch for your work item. To develop Scala and [GitHub](https://github.com/). This section of the guide provides a short walkthrough, but if you are new to Git, it probably makes sense to familiarize yourself with Git first. We recommend -* the [Git Pro](https://git-scm.com/book/en/) online book. +* the [Git Pro](https://git-scm.com/book/en/v2) online book. * the help page on [Forking a Git Repository](https://help.github.com/articles/fork-a-repo). * this great training tool [LearnGitBranching](https://pcottle.github.io/learnGitBranching/). One-hour hands-on training helps more than 1000 hours reading. @@ -96,7 +96,7 @@ Since in our example, we're going to fix an existing bug 16:39 ~/Projects/scala (master)$ git checkout -b ticket/6725 Switched to a new branch 'ticket/6725' -If you are new to Git and branching, read the [Branching Chapter](https://git-scm.com/book/en/Git-Branching) in the Git Pro book. +If you are new to Git and branching, read the [Branching Chapter](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell) in the Git Pro book. ### Build @@ -333,11 +333,11 @@ Let's go into each of these points in more detail. ### Commit -The [Git Basics](https://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. +The [Git Basics](https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository) chapter in the Git online book covers most of the basic workflow during this stage. There are two things you should know here: 1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policies](https://github.com/scala/scala/blob/2.12.x/CONTRIBUTING.md) for more information about the desired style of your commits. -2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](https://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. +2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on GitHub. From 83c838ba4f27bc194ab82b377ce560f528cf3db8 Mon Sep 17 00:00:00 2001 From: scarf <greenscarf005@gmail.com> Date: Mon, 30 Sep 2024 13:51:27 +0900 Subject: [PATCH 2919/3075] docs: correct to `removed` in `collections-2.13/maps.md` context: https://discord.com/channels/632150470000902164/632150470000902166/1290120539582500936 --- _overviews/collections-2.13/maps.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/collections-2.13/maps.md b/_overviews/collections-2.13/maps.md index 0d11c535a8..34d9696f19 100644 --- a/_overviews/collections-2.13/maps.md +++ b/_overviews/collections-2.13/maps.md @@ -51,8 +51,8 @@ Immutable maps support in addition operations to add and remove mappings by retu | **Additions and Updates:**| | | `ms.updated(k, v)`<br>or `ms + (k -> v)` |The map containing all mappings of `ms` as well as the mapping `k -> v` from key `k` to value `v`.| | **Removals:** | | -| `ms.remove(k)`<br>or `ms - k` |The map containing all mappings of `ms` except for any mapping of key `k`.| -| `ms.removeAll(ks)`<br>or `ms -- ks` |The map containing all mappings of `ms` except for any mapping with a key in `ks`.| +| `ms.removed(k)`<br>or `ms - k` |The map containing all mappings of `ms` except for any mapping of key `k`.| +| `ms.removedAll(ks)`<br>or `ms -- ks` |The map containing all mappings of `ms` except for any mapping with a key in `ks`.| Mutable maps support in addition the operations summarized in the following table. From 02c00cc4e5d4f629c48efba71fe5848f332a99e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gabriel=20K=C4=99pka?= <44374670+gkepka@users.noreply.github.com> Date: Tue, 1 Oct 2024 14:24:13 +0200 Subject: [PATCH 2920/3075] Add Cask tutorials (#3056) --- _includes/_markdown/install-cask.md | 37 +++ _overviews/toolkit/OrderedListOfMdFiles | 7 + _overviews/toolkit/http-client-what-else.md | 2 +- _overviews/toolkit/introduction.md | 4 + .../web-server-cookies-and-decorators.md | 188 ++++++++++++++ _overviews/toolkit/web-server-dynamic.md | 237 +++++++++++++++++ _overviews/toolkit/web-server-input.md | 243 ++++++++++++++++++ _overviews/toolkit/web-server-intro.md | 23 ++ .../toolkit/web-server-query-parameters.md | 74 ++++++ _overviews/toolkit/web-server-static.md | 159 ++++++++++++ _overviews/toolkit/web-server-websockets.md | 118 +++++++++ 11 files changed, 1091 insertions(+), 1 deletion(-) create mode 100644 _includes/_markdown/install-cask.md create mode 100644 _overviews/toolkit/web-server-cookies-and-decorators.md create mode 100644 _overviews/toolkit/web-server-dynamic.md create mode 100644 _overviews/toolkit/web-server-input.md create mode 100644 _overviews/toolkit/web-server-intro.md create mode 100644 _overviews/toolkit/web-server-query-parameters.md create mode 100644 _overviews/toolkit/web-server-static.md create mode 100644 _overviews/toolkit/web-server-websockets.md diff --git a/_includes/_markdown/install-cask.md b/_includes/_markdown/install-cask.md new file mode 100644 index 0000000000..afb2754321 --- /dev/null +++ b/_includes/_markdown/install-cask.md @@ -0,0 +1,37 @@ +{% altDetails require-info-box 'Getting Cask' %} + +{% tabs cask-install class=tabs-build-tool %} + +{% tab 'Scala CLI' %} +You can declare a dependency on Cask with the following `using` directive: +```scala +//> using dep "com.lihaoyi::cask::0.9.2" +``` +{% endtab %} + +{% tab 'sbt' %} +In your `build.sbt`, you can add a dependency on Cask: +```scala +lazy val example = project.in(file("example")) + .settings( + scalaVersion := "3.4.2", + libraryDependencies += "com.lihaoyi" %% "cask" % "0.9.2", + fork := true + ) +``` +{% endtab %} + +{% tab 'Mill' %} +In your `build.sc`, you can add a dependency on Cask: +```scala +object example extends RootModule with ScalaModule { + def scalaVersion = "3.3.3" + def ivyDeps = Agg( + ivy"com.lihaoyi::cask::0.9.2" + ) +} +``` +{% endtab %} + +{% endtabs %} +{% endaltDetails %} diff --git a/_overviews/toolkit/OrderedListOfMdFiles b/_overviews/toolkit/OrderedListOfMdFiles index ea248772fe..b2790bd58a 100644 --- a/_overviews/toolkit/OrderedListOfMdFiles +++ b/_overviews/toolkit/OrderedListOfMdFiles @@ -27,3 +27,10 @@ http-client-request-body.md http-client-json.md http-client-upload-file.md http-client-what-else.md +web-server-intro.md +web-server-static.md +web-server-dynamic.md +web-server-query-parameters.md +web-server-input.md +web-server-websockets.md +web-server-cookies-and-decorators.md diff --git a/_overviews/toolkit/http-client-what-else.md b/_overviews/toolkit/http-client-what-else.md index 11b577449d..865a031557 100644 --- a/_overviews/toolkit/http-client-what-else.md +++ b/_overviews/toolkit/http-client-what-else.md @@ -4,7 +4,7 @@ type: section description: An incomplete list of features of sttp num: 29 previous-page: http-client-upload-file -next-page: +next-page: web-server-intro --- {% include markdown.html path="_markdown/install-upickle.md" %} diff --git a/_overviews/toolkit/introduction.md b/_overviews/toolkit/introduction.md index 1656ed9662..9bc97cb2d1 100644 --- a/_overviews/toolkit/introduction.md +++ b/_overviews/toolkit/introduction.md @@ -22,6 +22,10 @@ toolkit-index: description: Sending HTTP requests and uploading files with sttp. icon: "fa fa-globe" link: /toolkit/http-client-intro.html + - title: Web servers + description: Building web servers with Cask. + icon: "fa fa-server" + link: /toolkit/web-server-intro.html --- ## What is the Scala Toolkit? diff --git a/_overviews/toolkit/web-server-cookies-and-decorators.md b/_overviews/toolkit/web-server-cookies-and-decorators.md new file mode 100644 index 0000000000..36caeac4de --- /dev/null +++ b/_overviews/toolkit/web-server-cookies-and-decorators.md @@ -0,0 +1,188 @@ +--- +title: How to use cookies and decorators? +type: section +description: Using cookies and decorators with Cask +num: 36 +previous-page: web-server-websockets +next-page: +--- + +{% include markdown.html path="_markdown/install-cask.md" %} + +## Using cookies + +Cookies are saved by adding them to the `cookies` parameter of the `cask.Response` constructor. + +In this example, we are building a rudimentary authentication service. The `getLogin` method provides a form where +the user can enter their username and password. The `postLogin` method reads the credentials. If they match the expected ones, it generates a session +identifier is generated, saves it in the application state, and sends back a cookie with the identifier. + +Cookies can be read either with a method parameter of `cask.Cookie` type or by accessing the `cask.Request` directly. +If using the former method, the names of parameters have to match the names of cookies. If a cookie with a matching name is not +found, an error response will be returned. In the `checkLogin` function, the former method is used, as the cookie is not +present before the user logs in. + +To delete a cookie, set its `expires` parameter to an instant in the past, for example `Instant.EPOCH`. + +{% tabs web-server-cookies-1 class=tabs-scala-version %} +{% tab 'Scala 2' %} + +```scala +import java.util.UUID +import java.util.concurrent.ConcurrentHashMap + +object Example extends cask.MainRoutes { + + val sessionIds = ConcurrentHashMap.newKeySet[String]() + + @cask.get("/login") + def getLogin(): cask.Response[String] = { + val html = + """<!doctype html> + |<html> + |<body> + |<form action="/login" method="post"> + | <label for="name">Username:</label><br> + | <input type="text" name="name" value=""><br> + | <label for="password">Password:</label><br> + | <input type="text" name="password" value=""><br><br> + | <input type="submit" value="Submit"> + |</form> + |</body> + |</html>""".stripMargin + + cask.Response(data = html, headers = Seq("Content-Type" -> "text/html")) + } + + @cask.postForm("/login") + def postLogin(name: String, password: String): cask.Response[String] = { + if (name == "user" && password == "password") { + val sessionId = UUID.randomUUID().toString + sessionIds.add(sessionId) + cask.Response(data = "Success!", cookies = Seq(cask.Cookie("sessionId", sessionId))) + } else { + cask.Response(data = "Authentication failed", statusCode = 401) + } + } + + @cask.get("/check") + def checkLogin(request: cask.Request): String = { + val sessionId = request.cookies.get("sessionId") + if (sessionId.exists(cookie => sessionIds.contains(cookie.value))) { + "You are logged in" + } else { + "You are not logged in" + } + } + + @cask.get("/logout") + def logout(sessionId: cask.Cookie) = { + sessionIds.remove(sessionId.value) + cask.Response(data = "Successfully logged out!", cookies = Seq(cask.Cookie("sessionId", "", expires = Instant.EPOCH))) + } + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import java.util.UUID +import java.util.concurrent.ConcurrentHashMap + +object Example extends cask.MainRoutes: + + val sessionIds = ConcurrentHashMap.newKeySet[String]() + + @cask.get("/login") + def getLogin(): cask.Response[String] = + val html = + """<!doctype html> + |<html> + |<body> + |<form action="/login" method="post"> + | <label for="name">Username:</label><br> + | <input type="text" name="name" value=""><br> + | <label for="password">Password:</label><br> + | <input type="text" name="password" value=""><br><br> + | <input type="submit" value="Submit"> + |</form> + |</body> + |</html>""".stripMargin + + cask.Response(data = html, headers = Seq("Content-Type" -> "text/html")) + + @cask.postForm("/login") + def postLogin(name: String, password: String): cask.Response[String] = + if name == "user" && password == "password" then + val sessionId = UUID.randomUUID().toString + sessionIds.add(sessionId) + cask.Response(data = "Success!", cookies = Seq(cask.Cookie("sessionId", sessionId))) + else + cask.Response(data = "Authentication failed", statusCode = 401) + + @cask.get("/check") + def checkLogin(request: cask.Request): String = + val sessionId = request.cookies.get("sessionId") + if sessionId.exists(cookie => sessionIds.contains(cookie.value)) then + "You are logged in" + else + "You are not logged in" + + @cask.get("/logout") + def logout(sessionId: cask.Cookie): cask.Response[String] = + sessionIds.remove(sessionId.value) + cask.Response(data = "Successfully logged out!", cookies = Seq(cask.Cookie("sessionId", "", expires = Instant.EPOCH))) + + initialize() +``` +{% endtab %} +{% endtabs %} + +## Using decorators + +Decorators can be used for extending endpoints functionality with validation or new parameters. They are defined by extending +`cask.RawDecorator` class. They are used as annotations. + +In this example, the `loggedIn` decorator is used to check if the user is logged in before accessing the `/decorated` +endpoint. + +The decorator class can pass additional arguments to the decorated endpoint using a map. The passed arguments are available +through the last argument group. Here we are passing the session identifier to an argument named `sessionId`. + +{% tabs web-server-cookies-2 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +class loggedIn extends cask.RawDecorator { + override def wrapFunction(ctx: cask.Request, delegate: Delegate): Result[Raw] = { + ctx.cookies.get("sessionId") match { + case Some(cookie) if sessionIds.contains(cookie.value) => delegate(Map("sessionId" -> cookie.value)) + case _ => cask.router.Result.Success(cask.model.Response("You aren't logged in", 403)) + } + } +} + +@loggedIn() +@cask.get("/decorated") +def decorated()(sessionId: String): String = { + s"You are logged in with id: $sessionId" +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +class loggedIn extends cask.RawDecorator: + override def wrapFunction(ctx: cask.Request, delegate: Delegate): Result[Raw] = + ctx.cookies.get("sessionId") match + case Some(cookie) if sessionIds.contains(cookie.value) => + delegate(Map("sessionId" -> cookie.value)) + case _ => + cask.router.Result.Success(cask.model.Response("You aren't logged in", 403)) + + +@loggedIn() +@cask.get("/decorated") +def decorated()(sessionId: String): String = s"You are logged in with id: $sessionId" +``` +{% endtab %} +{% endtabs %} \ No newline at end of file diff --git a/_overviews/toolkit/web-server-dynamic.md b/_overviews/toolkit/web-server-dynamic.md new file mode 100644 index 0000000000..49101505c7 --- /dev/null +++ b/_overviews/toolkit/web-server-dynamic.md @@ -0,0 +1,237 @@ +--- +title: How to serve a dynamic page? +type: section +description: Serving a dynamic page with Cask +num: 32 +previous-page: web-server-static +next-page: web-server-query-parameters +--- + +{% include markdown.html path="_markdown/install-cask.md" %} + +## Serving dynamically generated content + +You can create an endpoint returning dynamically generated content with the `@cask.get` annotation. + +{% tabs web-server-dynamic-1 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.time.ZonedDateTime + +object Example extends cask.MainRoutes { + @cask.get("/time") + def dynamic(): String = s"Current date is: ${ZonedDateTime.now()}" + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import java.time.ZonedDateTime + +object Example extends cask.MainRoutes: + @cask.get("/time") + def dynamic(): String = s"Current date is: ${ZonedDateTime.now()}" + + initialize() +``` +{% endtab %} +{% endtabs %} + +The example above creates an endpoint that returns the current date and time available at `/time`. The exact response will be +recreated every time you refresh the webpage. + +Since the endpoint method has the `String` output type, the result will be sent with the `text/plain` [content type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Type). +If you want an HTML output to be interpreted by the browser, you will need to set the `Content-Type` header manually +or [use the Scalatags templating library](/toolkit/web-server-dynamic.html#using-html-templates), supported by Cask. + +### Running the example + +Run the example the same way as before, assuming you use the same project structure as described in [the static file tutorial](/toolkit/web-server-static.html). + +{% tabs web-server-dynamic-2 class=tabs-build-tool %} +{% tab 'Scala CLI' %} +In the terminal, the following command will start the server: +``` +scala-cli run Example.scala +``` +{% endtab %} +{% tab 'sbt' %} +In the terminal, the following command will start the server: +``` +sbt example/run +``` +{% endtab %} +{% tab 'Mill' %} +In the terminal, the following command will start the server: +``` +./mill run +``` +{% endtab %} +{% endtabs %} + +Access the endpoint at [http://localhost:8080/time](http://localhost:8080/time). You should see a result similar to the one below. + +``` +Current date is: 2024-07-22T09:07:05.752534+02:00[Europe/Warsaw] +``` + +## Using path segments + +Cask gives you the ability to access segments of the URL path within the endpoint function. +Building on the example above, you can add a segment to specify that the endpoint should return the date and time +in a given city. + +{% tabs web-server-dynamic-3 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.time.{ZoneId, ZonedDateTime} + +object Example extends cask.MainRoutes { + + private def getZoneIdForCity(city: String): Option[ZoneId] = { + import scala.jdk.CollectionConverters._ + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + } + + @cask.get("/time/:city") + def dynamicWithCity(city: String): String = { + getZoneIdForCity(city) match { + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $city" + } + } + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import java.time.{ZoneId, ZonedDateTime} + +object Example extends cask.MainRoutes: + + private def getZoneIdForCity(city: String): Option[ZoneId] = + import scala.jdk.CollectionConverters.* + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + + @cask.get("/time/:city") + def dynamicWithCity(city: String): String = + getZoneIdForCity(city) match + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $city" + + initialize() +``` +{% endtab %} +{% endtabs %} + +In the example above, the `:city` segment in `/time/:city` is available through the `city` argument of the endpoint method. +The name of the argument must be identical to the segment name. The `getZoneIdForCity` helper method finds the timezone for +a given city, and then the current date and time are translated to that timezone. + +Accessing the endpoint at [http://localhost:8080/time/Paris](http://localhost:8080/time/Paris) will result in: +``` +Current date is: 2024-07-22T09:08:33.806259+02:00[Europe/Paris] +``` + +You can use more than one path segment in an endpoint by adding more arguments to the endpoint method. It's also possible to use paths +with an unspecified number of segments (for example `/path/foo/bar/baz/`) by giving the endpoint method an argument with `cask.RemainingPathSegments` type. +Consult the [documentation](https://com-lihaoyi.github.io/cask/index.html#variable-routes) for more details. + +## Using HTML templates + +To create an HTML response, you can combine Cask with the [Scalatags](https://com-lihaoyi.github.io/scalatags/) templating library. + +Import the Scalatags library: + +{% tabs web-server-dynamic-4 class=tabs-build-tool %} +{% tab 'Scala CLI' %} +Add the Scalatags dependency in `Example.sc` file: +```scala +//> using dep "com.lihaoyi::scalatags::0.13.1" +``` +{% endtab %} +{% tab 'sbt' %} +Add the Scalatags dependency in `build.sbt` file: +```scala +libraryDependencies += "com.lihaoyi" %% "scalatags" % "0.13.1" +``` +{% endtab %} +{% tab 'Mill' %} +Add the Scalatags dependency in `build.cs` file: +```scala +ivy"com.lihaoyi::scalatags::0.13.1" +``` +{% endtab %} +{% endtabs %} + +Now the example above can be rewritten to use a template. Cask will build a response out of the `doctype` automatically, +setting the `Content-Type` header to `text/html`. + +{% tabs web-server-dynamic-5 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.time.{ZoneId, ZonedDateTime} +import scalatags.Text.all._ + +object Example extends cask.MainRoutes { + + private def getZoneIdForCity(city: String): Option[ZoneId] = { + import scala.jdk.CollectionConverters._ + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + } + + @cask.get("/time/:city") + def dynamicWithCity(city: String): doctype = { + val text = getZoneIdForCity(city) match { + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $city" + } + + doctype("html")( + html( + body( + p(text) + ) + ) + ) + } + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import java.time.{ZoneId, ZonedDateTime} +import scalatags.Text.all.* + +object Example extends cask.MainRoutes: + + private def getZoneIdForCity(city: String): Option[ZoneId] = + import scala.jdk.CollectionConverters.* + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + + @cask.get("/time/:city") + def dynamicWithCity(city: String): doctype = + val text = getZoneIdForCity(city) match + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $city" + doctype("html")( + html( + body( + p(text) + ) + ) + ) + + initialize() +``` +{% endtab %} +{% endtabs %} + +Here we get the text of the response and wrap it in a Scalatags template. Notice that the return type changed from `String` +to `doctype`. \ No newline at end of file diff --git a/_overviews/toolkit/web-server-input.md b/_overviews/toolkit/web-server-input.md new file mode 100644 index 0000000000..8be4c659d3 --- /dev/null +++ b/_overviews/toolkit/web-server-input.md @@ -0,0 +1,243 @@ +--- +title: How to handle user input? +type: section +description: Handling user input with Cask +num: 34 +previous-page: web-server-query-parameters +next-page: web-server-websockets +--- + +{% include markdown.html path="_markdown/install-cask.md" %} + +## Handling form-encoded input + +To create an endpoint that handles the data provided in an HTML form, use the `@cask.postForm` annotation. Add arguments to the endpoint method +with names corresponding to names of fields in the form and set the form method to `post`. + +{% tabs web-server-input-1 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +object Example extends cask.MainRoutes { + + @cask.get("/form") + def getForm(): cask.Response[String] = { + val html = + """<!doctype html> + |<html> + |<body> + |<form action="/form" method="post"> + | <label for="name">First name:</label><br> + | <input type="text" name="name" value=""><br> + | <label for="surname">Last name:</label><br> + | <input type="text" name="surname" value=""><br><br> + | <input type="submit" value="Submit"> + |</form> + |</body> + |</html>""".stripMargin + + cask.Response(data = html, headers = Seq("Content-Type" -> "text/html")) + } + + @cask.postForm("/form") + def formEndpoint(name: String, surname: String): String = + "Hello " + name + " " + surname + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +object Example extends cask.MainRoutes: + + @cask.get("/form") + def getForm(): cask.Response[String] = + val html = + """<!doctype html> + |<html> + |<body> + |<form action="/form" method="post"> + | <label for="name">First name:</label><br> + | <input type="text" name="name" value=""><br> + | <label for="surname">Last name:</label><br> + | <input type="text" name="surname" value=""><br><br> + | <input type="submit" value="Submit"> + |</form> + |</body> + |</html>""".stripMargin + + cask.Response(data = html, headers = Seq("Content-Type" -> "text/html")) + + @cask.postForm("/form") + def formEndpoint(name: String, surname: String): String = + "Hello " + name + " " + surname + + initialize() +``` +{% endtab %} +{% endtabs %} + +In this example we create a form asking for name and surname of a user and then redirect the user to a greeting page. Notice the +use of `cask.Response`. The `cask.Response` type allows the user to set the status code, headers and cookies. The default +content type for an endpoint method returning a `String` is `text/plain`. Set it to `text/html` in order for the browser to display the form correctly. + +The `formEndpoint` endpoint reads the form data using the `name` and `surname` parameters. The names of parameters must +be identical to the field names of the form. + +## Handling JSON-encoded input + +JSON fields are handled in the same way as form fields, except that we use the `@cask.PostJson` annotation. The fields +will be read into the endpoint method arguments. + +{% tabs web-server-input-2 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +object Example extends cask.MainRoutes { + + @cask.postJson("/json") + def jsonEndpoint(name: String, surname: String): String = + "Hello " + name + " " + surname + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +object Example extends cask.MainRoutes: + + @cask.postJson("/json") + def jsonEndpoint(name: String, surname: String): String = + "Hello " + name + " " + surname + + initialize() +``` +{% endtab %} +{% endtabs %} + +Send the POST request using `curl`: + +```shell +curl --header "Content-Type: application/json" \ + --data '{"name":"John","surname":"Smith"}' \ + http://localhost:8080/json +``` + +The response will be: +``` +Hello John Smith +``` + +The endpoint will accept JSONs that have only the fields with names specified as the endpoint method arguments. If there +are more fields than expected, some fields are missing or have an incorrect data type, an error message +will be returned with the response code 400. + +To handle the case when the fields of the JSON are not known in advance, you can use an argument with the `ujson.Value` type, +from uPickle library. + +{% tabs web-server-input-3 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +object Example extends cask.MainRoutes { + + @cask.postJson("/json") + def jsonEndpoint(value: ujson.Value): String = + value.toString + + initialize() +} + +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +object Example extends cask.MainRoutes: + + @cask.postJson("/json") + def jsonEndpoint(value: ujson.Value): String = + value.toString + + initialize() + +``` +{% endtab %} +{% endtabs %} + +In this example the JSON is merely converted to `String`. Check the [*uPickle tutorial*](/toolkit/json-intro.html) for more information +on what can be done with the `ujson.Value` type. + +Send a POST request. +```shell +curl --header "Content-Type: application/json" \ + --data '{"value":{"name":"John","surname":"Smith"}}' \ + http://localhost:8080/json2 +``` + +The server will respond with: +``` +"{\"name\":\"John\",\"surname\":\"Smith\"}" +``` + +## Handling JSON-encoded output + +Cask endpoints can return JSON objects returned by uPickle library functions. Cask will automatically handle the `ujson.Value` +type and set the `Content-Type` header to `application/json`. + +In this example, the `TimeData` case class stores the information about the time zone and current time in a chosen +location. To serialize a case class into JSON, use type class derivation or define the serializer in its companion object in the case of Scala 2. + +{% tabs web-server-input-4 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.time.{ZoneId, ZonedDateTime} + +object Example extends cask.MainRoutes { + import upickle.default.{ReadWriter, macroRW, writeJs} + case class TimeData(timezone: Option[String], time: String) + object TimeData { + implicit val rw: ReadWriter[TimeData] = macroRW + } + + private def getZoneIdForCity(city: String): Option[ZoneId] = { + import scala.jdk.CollectionConverters._ + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + } + + @cask.get("/time_json/:city") + def timeJSON(city: String): ujson.Value = { + val timezone = getZoneIdForCity(city) + val time = timezone match { + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $city" + } + writeJs(TimeData(timezone.map(_.toString), time)) + } + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import java.time.{ZoneId, ZonedDateTime} + +object Example extends cask.MainRoutes: + import upickle.default.{ReadWriter, writeJs} + case class TimeData(timezone: Option[String], time: String) derives ReadWriter + + private def getZoneIdForCity(city: String): Option[ZoneId] = + import scala.jdk.CollectionConverters.* + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + + @cask.get("/time_json/:city") + def timeJSON(city: String): ujson.Value = + val timezone = getZoneIdForCity(city) + val time = timezone match + case Some(zoneId)=> s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $city" + writeJs(TimeData(timezone.map(_.toString), time)) + + initialize() +``` +{% endtab %} +{% endtabs %} \ No newline at end of file diff --git a/_overviews/toolkit/web-server-intro.md b/_overviews/toolkit/web-server-intro.md new file mode 100644 index 0000000000..4a1efcdc6a --- /dev/null +++ b/_overviews/toolkit/web-server-intro.md @@ -0,0 +1,23 @@ +--- +title: Building web servers with Cask +type: chapter +description: The introduction of the Cask library +num: 30 +previous-page: http-client-what-else +next-page: web-server-static +--- + +Cask is an HTTP micro-framework, providing a simple and flexible way to build web applications. + +Its main focus is on the ease of use, which makes it ideal for newcomers, at the cost of eschewing some features other +frameworks provide, like asynchronicity. + +To define an endpoint it's enough to annotate a function with an annotation specifying the request path. +Cask allows for building the response manually using tools that the library provides, specifying the content, headers, +status code, etc. An endpoint function can also return a string, a [uPickle](https://com-lihaoyi.github.io/upickle/) JSON type, or a [Scalatags](https://com-lihaoyi.github.io/scalatags/) +template. In that case, Cask will automatically create a response with the appropriate headers. + +Cask comes bundled with the uPickle library for handling JSONs, supports WebSockets and allows for extending endpoints with +decorators, which can be used to handle authentication or rate limiting. + +{% include markdown.html path="_markdown/install-cask.md" %} diff --git a/_overviews/toolkit/web-server-query-parameters.md b/_overviews/toolkit/web-server-query-parameters.md new file mode 100644 index 0000000000..8da1dc9ccc --- /dev/null +++ b/_overviews/toolkit/web-server-query-parameters.md @@ -0,0 +1,74 @@ +--- +title: How to handle query parameters? +type: section +description: Handling query parameters with Cask +num: 33 +previous-page: web-server-dynamic +next-page: web-server-input +--- + +{% include markdown.html path="_markdown/install-cask.md" %} + +Query parameters are the key-value pairs coming after the question mark in a URL. They can be used for filtering, +sorting or limiting the results provided by the server. For example, in the `<host>/time?city=Paris` URL, the `city` part +is the name of a parameter, and `Paris` is its value. Cask allows for reading the query parameters by defining an endpoint +method with arguments matching the names of the expected parameters and not matching any of the URL segments. + +In this example, we give an `Option` type and the default value `None` to the `city` parameter. This tells Cask that it is optional. +If not provided, the time for the current timezone will be returned. + +{% tabs web-server-query-1 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +import java.time.{ZoneId, ZonedDateTime} + +object Example extends cask.MainRoutes { + + private def getZoneIdForCity(city: String): Option[ZoneId] = { + import scala.jdk.CollectionConverters._ + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + } + + @cask.get("/time") + def dynamicWithParam(city: Option[String] = None): String = { + city match { + case Some(value) => getZoneIdForCity(value) match { + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $value" + } + case None => s"Current date is: ${ZonedDateTime.now()}" + } + } + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +import java.time.{ZoneId, ZonedDateTime} + +object Example extends cask.MainRoutes: + + private def getZoneIdForCity(city: String): Option[ZoneId] = + import scala.jdk.CollectionConverters.* + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + + @cask.get("/time") + def dynamicWithParam(city: Option[String] = None): String = + city match + case Some(value) => getZoneIdForCity(value) match + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $value" + case None => s"Current date is: ${ZonedDateTime.now()}" + + initialize() +``` +{% endtab %} +{% endtabs %} + +Run the example as before and access the endpoint at [http://localhost:8080/time?city=Paris](http://localhost:8080/time?city=Paris). +You should get a result similar to the following one. +``` +Current date is: 2024-07-22T10:08:18.218736+02:00[Europe/Paris] +``` diff --git a/_overviews/toolkit/web-server-static.md b/_overviews/toolkit/web-server-static.md new file mode 100644 index 0000000000..5e7f0c417f --- /dev/null +++ b/_overviews/toolkit/web-server-static.md @@ -0,0 +1,159 @@ +--- +title: How to serve a static file? +type: section +description: Serving a static file with Cask +num: 31 +previous-page: web-server-intro +next-page: web-server-dynamic +--- + +{% include markdown.html path="_markdown/install-cask.md" %} + +## Serving a static file + +An endpoint is a specific URL where a particular webpage can be accessed. In Cask, an endpoint is a function returning the +webpage data, together with an annotation describing its URL. + +To create an endpoint serving static files, we need two things: an HTML file with the page content and a function that +points to that file. + +Create a minimal HTML file named `hello.html` with the following contents. + +```html +<!doctype html> +<html> + <head> + <title>Hello World + + +

    Hello world

    + + +``` + +Place it in the `resources` directory. + +{% tabs web-server-static-1 class=tabs-build-tool %} +{% tab 'Scala CLI' %} +``` +example +├── Example.scala +└── resources + └── hello.html +``` +{% endtab %} +{% tab 'sbt' %} +``` +example +└──src + └── main + ├── resources + │ └── hello.html + └── scala + └── Example.scala +``` +{% endtab %} +{% tab 'Mill' %} +``` +example +├── src +│ └── Example.scala +└── resources + └── hello.html +``` +{% endtab %} +{% endtabs %} + +The `@cask.staticFiles` annotation specifies at which path the webpage will be available. The endpoint function returns +the location of the file. + +{% tabs web-server-static-2 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +object Example extends cask.MainRoutes { + @cask.staticFiles("/static") + def staticEndpoint(): String = "src/main/resources" // or "resources" if not using SBT + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +object Example extends cask.MainRoutes: + @cask.staticFiles("/static") + def staticEndpoint(): String = "src/main/resources" // or "resources" if not using SBT + + initialize() +``` +{% endtab %} +{% endtabs %} + +In the example above, `@cask.staticFiles` instructs the server to look for files accessed at the `/static` path in the +`src/main/resources` directory. Cask will match any subpath coming after `/static` and append it to the directory path. +If you access the `/static/hello.html` file, it will serve the file available at `src/main/resources/hello.html`. +The directory path can be any path available to the server, relative or not. If the requested file cannot be found in the +specified location, the server will return a 404 response with an error message. + +The `Example` object inherits from the `cask.MainRoutes` class. It provides the main function that starts the server. The `initialize()` +method call initializes the server routes, i.e., the association between URL paths and the code that handles them. + +### Using the resources directory + +The `@cask.staticResources` annotation works in the same way as the `@cask.staticFiles` used above, with the difference that +the path returned by the endpoint method describes the location of files _inside_ the resources directory. Since the +previous example conveniently used the resources directory, it can be simplified with `@cask.staticResources`. + +{% tabs web-server-static-3 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +object Example extends cask.MainRoutes { + @cask.staticResources("/static") + def staticEndpoint(): String = "." + + initialize() +} +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +object Example extends cask.MainRoutes: + @cask.staticResources("/static") + def staticEndpoint(): String = "." + + initialize() +``` +{% endtab %} +{% endtabs %} + +In the endpoint method, the location is set to `"."`, telling the server that the files are available directly in the +resources directory. In general, you can use any nested location within the resources directory. For instance, you could opt +for placing your HTML files in the `static` directory inside the resources directory or using different directories to sort out +files used by different endpoints. + +## Running the example + +Run the example with the build tool of your choice. + +{% tabs munit-unit-test-4 class=tabs-build-tool %} +{% tab 'Scala CLI' %} +In the terminal, the following command will start the server: +``` +scala-cli run Example.scala +``` +{% endtab %} +{% tab 'sbt' %} +In the terminal, the following command will start the server: +``` +sbt example/run +``` +{% endtab %} +{% tab 'Mill' %} +In the terminal, the following command will start the server: +``` +./mill run +``` +{% endtab %} +{% endtabs %} + +The example page will be available at [http://localhost:8080/static/hello.html](http://localhost:8080/static/hello.html). \ No newline at end of file diff --git a/_overviews/toolkit/web-server-websockets.md b/_overviews/toolkit/web-server-websockets.md new file mode 100644 index 0000000000..653bd7f154 --- /dev/null +++ b/_overviews/toolkit/web-server-websockets.md @@ -0,0 +1,118 @@ +--- +title: How to use websockets? +type: section +description: Using websockets with Cask +num: 35 +previous-page: web-server-input +next-page: web-server-cookies-and-decorators +--- + +{% include markdown.html path="_markdown/install-cask.md" %} + +You can create a WebSocket endpoint with the `@cask.websocket` annotation. The endpoint method should return a +`cask.WsHandler` instance defining how the communication should take place. It can also return a `cask.Response`, which rejects the +attempt at forming a WebSocket connection. + +The connection can also be closed by sending a `cask.Ws.close()` message through the WebSocket channel. + +Create an HTML file named `websockets.html` with the following content and place it in the `resources ` directory. + +```html + + + +
    + + +
    +
    + + + +``` + +The JavaScript code opens a WebSocket connection using the `ws://localhost:8080/websocket` endpoint. The `ws.onmessage` +event handler is executed when the server pushes a message to the browser and `ws.onclose` when the connection is closed. + +Create an endpoint for serving static files using the `@cask.staticResources` annotation and an endpoint for handling +the WebSocket connection. + +{% tabs web-server-websocket-1 class=tabs-scala-version %} +{% tab 'Scala 2' %} +```scala +@cask.staticResources("/static") +def static() = "." + +private def getZoneIdForCity(city: String): Option[ZoneId] = { + import scala.jdk.CollectionConverters._ + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) +} + +@cask.websocket("/websocket") +def websocket(): cask.WsHandler = { + cask.WsHandler { channel => + cask.WsActor { + case cask.Ws.Text("") => channel.send(cask.Ws.Close()) + case cask.Ws.Text(city) => + val text = getZoneIdForCity(city) match { + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $city" + } + channel.send(cask.Ws.Text(text)) + } + } +} + +initialize() +``` +{% endtab %} +{% tab 'Scala 3' %} +```scala +@cask.staticResources("/static") +def static() = "." + +private def getZoneIdForCity(city: String): Option[ZoneId] = + import scala.jdk.CollectionConverters.* + ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of) + +@cask.websocket("/websocket") +def websocket(): cask.WsHandler = + cask.WsHandler { channel => + cask.WsActor { + case cask.Ws.Text("") => channel.send(cask.Ws.Close()) + case cask.Ws.Text(city) => + val text = getZoneIdForCity(city) match + case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}" + case None => s"Couldn't find time zone for city $city" + channel.send(cask.Ws.Text(text)) + } + } + +initialize() +``` +{% endtab %} +{% endtabs %} + +In the `cask.WsHandler` we define a `cask.WsActor`. It reacts to events (of type `cask.util.Ws.Event`) and uses the +WebSocket channel to send messages. In this example, we receive the name of a city and return the current time there. If the server +receives an empty message, the connection is closed. \ No newline at end of file From dc10b8a1586bd59d40fbe08ec1ee19b4924fb2e8 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Wed, 2 Oct 2024 10:19:59 +0200 Subject: [PATCH 2921/3075] use scala instead of scala-cli in Cask tutorial --- _overviews/toolkit/web-server-static.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/toolkit/web-server-static.md b/_overviews/toolkit/web-server-static.md index 5e7f0c417f..780941efb0 100644 --- a/_overviews/toolkit/web-server-static.md +++ b/_overviews/toolkit/web-server-static.md @@ -139,7 +139,7 @@ Run the example with the build tool of your choice. {% tab 'Scala CLI' %} In the terminal, the following command will start the server: ``` -scala-cli run Example.scala +scala run Example.scala ``` {% endtab %} {% tab 'sbt' %} @@ -156,4 +156,4 @@ In the terminal, the following command will start the server: {% endtab %} {% endtabs %} -The example page will be available at [http://localhost:8080/static/hello.html](http://localhost:8080/static/hello.html). \ No newline at end of file +The example page will be available at [http://localhost:8080/static/hello.html](http://localhost:8080/static/hello.html). From 75ec52ffc87450989761513717efe1ebdbee346b Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Sun, 6 Oct 2024 10:43:34 -0700 Subject: [PATCH 2922/3075] add JDK 23 to build tool table --- _overviews/jdk-compatibility/overview.md | 1 + 1 file changed, 1 insertion(+) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 99b953306f..66341a75c4 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -35,6 +35,7 @@ Minimum working versions: | JDK | sbt | mill | |:-----------:|:---------------:|:-----------| +| 23 | ??? | ??? | | 21 (LTS) | 1.9.0 | 0.11.5 | | 17 (LTS) | 1.6.0 | 0.7.0 | | 11 (LTS) | 1.1.0 | 0.1.5 | From a85e51e16b8075b969532323e352c2f54fe3b71c Mon Sep 17 00:00:00 2001 From: gkepka Date: Tue, 8 Oct 2024 12:19:40 +0200 Subject: [PATCH 2923/3075] Grammar fixes + Scala 3 version update --- _config.yml | 2 +- _overviews/getting-started/index.md | 59 ++++++++++--------- _overviews/scala3-book/taste-hello-world.md | 18 +++--- .../tutorials/scala-for-java-programmers.md | 6 +- _ru/getting-started/index.md | 3 +- _uk/getting-started/index.md | 3 +- api/all.md | 4 +- 7 files changed, 48 insertions(+), 47 deletions(-) diff --git a/_config.yml b/_config.yml index f257fada05..170a1f41a0 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.14 scala-212-version: 2.12.19 -scala-3-version: 3.4.2 +scala-3-version: 3.5.1 collections: style: diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 19052399e3..11bc59e720 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -100,7 +100,8 @@ Run the following command in your terminal, following the on-screen instructions Check your setup with the command `scala -version`, which should output: ```bash $ scala -version -Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL +Scala code runner version: 1.4.3 +Scala version (default): {{site.scala-3-version}} ``` {% endaltDetails %} @@ -147,8 +148,10 @@ To install them manually: ## Using the Scala CLI -Create a file named `hello.scala` with the following code: +In a directory of your choice, which we will call ``, create a file named `hello.scala` with the following code: ```scala +//> using scala {{site.scala-3-version}} + @main def hello(): Unit = println("Hello, World!") @@ -159,19 +162,21 @@ the entry point in program execution. The method's type is `Unit`, which means i can be thought of as an analogue to the `void` keyword found in other languages. The `println` method will print the `"Hello, World!"` string to standard output. -To run the program, execute `scala run hello.scala` command. The file will be compiled and executed, with console output +To run the program, execute `scala run hello.scala` command from a terminal, within the `` directory. The file will be compiled and executed, with console output similar to following: ``` $ scala run hello.scala -Compiling project (Scala 3.5.0, JVM (20)) -Compiled project (Scala 3.5.0, JVM (20)) +Compiling project (Scala {{site.scala-3-version}}, JVM (20)) +Compiled project (Scala {{site.scala-3-version}}, JVM (20)) Hello, World! ``` ### Handling command-line arguments -Let's rewrite the `hello.scala` file so that the program greets the person running it. +Rewrite the `hello.scala` file so that the program greets the person running it. ```scala +//> using scala {{site.scala-3-version}} + @main def hello(name: String): Unit = println(s"Hello, $name!") @@ -184,8 +189,8 @@ the content of the `name` argument. To pass the arguments when executing the program, put them after `--`: ``` $ scala run hello.scala -- Gabriel -Compiling project (Scala 3.5.0, JVM (20)) -Compiled project (Scala 3.5.0, JVM (20)) +Compiling project (Scala {{site.scala-3-version}}, JVM (20)) +Compiled project (Scala {{site.scala-3-version}}, JVM (20)) Hello, Gabriel! ``` @@ -193,27 +198,28 @@ You can read more about [main methods](/scala3/book/methods-main-methods.html) a ### Adding dependencies -Let's write a program that will count the files and directories present in its working directory. While in Scala you have full access to the Java API for -filesystem interaction, the [os-lib](https://github.com/com-lihaoyi/os-lib) library by Li Haoyi is much more convenient to use. A dependency on the library can -be added with the `//> using` directive. Put the following code in `counter.scala`. +We now write a program that will count the files and directories present in its working directory. +We use the [os-lib](https://github.com/com-lihaoyi/os-lib) library from the [Scala toolkit](toolkit/introduction.html) +for that purpose. A dependency on the library can be added with the `//> using` directive. Put the following code in `counter.scala`. ```scala +//> using scala {{site.scala-3-version}} //> using dep "com.lihaoyi::os-lib:0.10.7" @main def countFiles(): Unit = - val paths = os.list(os.pwd) - println(paths.length) + val paths = os.list(os.pwd) + println(paths.length) ``` -In the code above, the `os.pwd` returns the current working directory, which is then passed to `os.list`, which returns a sequence -of paths directly within the directory passed as an argument. `val` is used to declare an immutable value, in this example storing the +In the code above, `os.pwd` returns the current working directory. We pass it to `os.list`, which returns a sequence +of paths directly within the directory passed as an argument. We use a `val` to declare an immutable value, in this example storing the sequence of paths. Execute the program. The dependency will be automatically downloaded. The execution should result in a similar output: ``` $ scala run counter.scala -Compiling project (Scala 3.5.0, JVM (20)) -Compiled project (Scala 3.5.0, JVM (20)) +Compiling project (Scala {{site.scala-3-version}}, JVM (20)) +Compiled project (Scala {{site.scala-3-version}}, JVM (20)) 4 ``` The printed number should be 4: `hello.scala`, `counter.scala` and two hidden directories created automatically when a program is executed: @@ -223,23 +229,23 @@ As it turns out, the `os-lib` library is a part of Scala Toolkit, a collection o operating system interaction or handling JSONs. You can read more about the libraries included in the toolkit [here](/toolkit/introduction.html). To include the toolkit libraries, use the `//> using toolkit default` directive: ```scala -//> using toolkit default +//> using scala {{site.scala-3-version}} +//> using toolkit 0.5.0 @main def countFiles(): Unit = - val paths = os.list(os.pwd) - println(paths.length) + val paths = os.list(os.pwd) + println(paths.length) ``` -This program is identical to the one above, with the only difference being that other toolkit libraries will also be available to use -and their downloaded versions, instead of being specified by hand, will be the newest ones included in the toolkit. +This program is identical to the one above. However, other toolkit libraries will also be available to use, should you need them. -### Using REPL +### Using the REPL -You can execute code interactively using REPL provided by the `scala` command. Execute `scala` in console without any arguments. +You can execute code interactively using the REPL provided by the `scala` command. Execute `scala` in the console without any arguments. ``` $ scala -Welcome to Scala 3.5.0 (20-ea, Java OpenJDK 64-Bit Server VM). +Welcome to Scala {{site.scala-3-version}} (20-ea, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. scala> @@ -279,9 +285,6 @@ sbt and an IDE using the tutorials below. If you want to familiarize yourself wi * [The Tour of Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. * [Learning Resources](/learn.html), which includes online interactive tutorials and courses. * [Our list of some popular Scala books](/books.html). -* [The migration guide](/scala3/guides/migration/compatibility-intro.html) helps you to migrate your existing Scala 2 code base to Scala 3. - -The [Scala CLI documentation](https://scala-cli.virtuslab.org/) describes the available sub-commands and how to integrate the tool with an IDE of choice. ## Create a "Hello World" project with sbt diff --git a/_overviews/scala3-book/taste-hello-world.md b/_overviews/scala3-book/taste-hello-world.md index ff585d9463..52fc532e5e 100644 --- a/_overviews/scala3-book/taste-hello-world.md +++ b/_overviews/scala3-book/taste-hello-world.md @@ -53,14 +53,10 @@ Next, compile and run the code with `scala`: $ scala run hello.scala ``` -When you run the command for the first time, two hidden directories will be created: `.bsp` and `.scala-build`. The first -one contains the [Build Server Protocol](https://build-server-protocol.github.io/) information for IDEs, and the second one contains the results -of compilation. - -The command should produce similar output: +The command should produce an output similar to: ``` -Compiling project (Scala 3.5.0, JVM (20)) -Compiled project (Scala 3.5.0, JVM (20)) +Compiling project (Scala {{site.scala-3-version}}, JVM (20)) +Compiled project (Scala {{site.scala-3-version}}, JVM (20)) Hello, World! ``` @@ -131,8 +127,8 @@ and wait until you type a name and press return on the keyboard, looking like th ```bash $ scala run helloInteractive.scala -Compiling project (Scala 3.5.0, JVM (20)) -Compiled project (Scala 3.5.0, JVM (20)) +Compiling project (Scala {{site.scala-3-version}}, JVM (20)) +Compiled project (Scala {{site.scala-3-version}}, JVM (20)) Please enter your name: ▌ ``` @@ -141,8 +137,8 @@ When you enter your name at the prompt, the final interaction should look like t ```bash $ scala run helloInteractive.scala -Compiling project (Scala 3.5.0, JVM (20)) -Compiled project (Scala 3.5.0, JVM (20)) +Compiling project (Scala {{site.scala-3-version}}, JVM (20)) +Compiled project (Scala {{site.scala-3-version}}, JVM (20)) Please enter your name: Alvin Alexander Hello, Alvin Alexander! diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index 2bfda72ec6..67e00799bd 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -170,10 +170,10 @@ and should not be typed): ``` The program will be automatically compiled (with compiled classes somewhere in the newly created `.scala-build` directory) -and executed, producing a similar output: +and executed, producing an output similar to: ``` -Compiling project (Scala 3.5.0, JVM (20)) -Compiled project (Scala 3.5.0, JVM (20)) +Compiling project (Scala {{site.scala-3-version}}, JVM (20)) +Compiled project (Scala {{site.scala-3-version}}, JVM (20)) Hello, World! ``` diff --git a/_ru/getting-started/index.md b/_ru/getting-started/index.md index e9d8e0beeb..f6968753f5 100644 --- a/_ru/getting-started/index.md +++ b/_ru/getting-started/index.md @@ -90,7 +90,8 @@ newcomer_resources: Проверьте корректность установки с помощью команды `scala -version`, которая должна вывести: ```bash $ scala -version -Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL +Scala code runner version: 1.4.3 +Scala version (default): {{site.scala-3-version}} ``` Если сообщение не выдано, возможно, необходимо перезайти в терминал (или перезагрузиться), чтобы изменения вступили в силу. diff --git a/_uk/getting-started/index.md b/_uk/getting-started/index.md index e8275ada94..9725b362e9 100644 --- a/_uk/getting-started/index.md +++ b/_uk/getting-started/index.md @@ -75,7 +75,8 @@ _Scastie_ це онлайн “пісочниця”, де ви можете е Перевірте ваші налаштування виконавши команду `scala -version`, яка має вивести: ```bash $ scala -version -Scala code runner version {{site.scala-3-version}} -- Copyright 2002-2022, LAMP/EPFL +Scala code runner version: 1.4.3 +Scala version (default): {{site.scala-3-version}} ``` Якщо це не спрацювало, необхідно завершити сеанс та зайти в систему знову (або перезавантажити), щоб зміни застосувались на вашій системі. {% endaltDetails %} diff --git a/api/all.md b/api/all.md index 334ecac392..2ca319f7c2 100644 --- a/api/all.md +++ b/api/all.md @@ -8,8 +8,8 @@ redirect_from: ## Latest releases -* Scala 3.4.2 - * [Library API](https://www.scala-lang.org/api/3.4.2/) +* Scala {{site.scala-3-version}} + * [Library API](https://www.scala-lang.org/api/{{site.scala-3-version}}/) * Scala 3.3.3 LTS * [Library API](https://www.scala-lang.org/api/3.3.3/) * Scala 2.13.14 From 10ac41706fdb98ad823f48863c947611f213f2c4 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Tue, 15 Oct 2024 00:27:44 +0000 Subject: [PATCH 2924/3075] Update SIPs state --- _sips/sips/typeclasses-syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/typeclasses-syntax.md b/_sips/sips/typeclasses-syntax.md index 0beed4b3e1..385bb7dc1f 100644 --- a/_sips/sips/typeclasses-syntax.md +++ b/_sips/sips/typeclasses-syntax.md @@ -95,7 +95,7 @@ Aggregate context bounds like `A : X : Y` are not obvious to read, and it become to import clauses. Example: ```scala - trait: + trait A: def showMax[X : {Ordering, Show}](x: X, y: X): String class B extends A: def showMax[X : {Ordering as ordering, Show as show}](x: X, y: X): String = From 4493ed1e18600a04fdfc8fe2d0cb61611c3fd498 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 14 Oct 2024 18:51:52 -0700 Subject: [PATCH 2925/3075] Update _overviews/getting-started/scala-ides.md Co-authored-by: Jamie Thompson --- _overviews/getting-started/scala-ides.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/getting-started/scala-ides.md b/_overviews/getting-started/scala-ides.md index b01e8d14ba..444e641181 100644 --- a/_overviews/getting-started/scala-ides.md +++ b/_overviews/getting-started/scala-ides.md @@ -4,7 +4,7 @@ title: Scala IDEs partof: scala-ides -permalink: /tutorials/:title.html +permalink: /getting-started/:title.html keywords: - Scala From f0e4215c093a826150d5a7a7bd0d3c984d1fd960 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 14 Oct 2024 19:11:23 -0700 Subject: [PATCH 2926/3075] as far as we know, sbt 1.9.0 works on JDK 23 works for me on a sample repo, anyway. if we discover otherwise we can change it --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 66341a75c4..73b52b624e 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -35,7 +35,7 @@ Minimum working versions: | JDK | sbt | mill | |:-----------:|:---------------:|:-----------| -| 23 | ??? | ??? | +| 23 | 1.9.0 | ??? | | 21 (LTS) | 1.9.0 | 0.11.5 | | 17 (LTS) | 1.6.0 | 0.7.0 | | 11 (LTS) | 1.1.0 | 0.1.5 | From 7de9d15fd02dd5c104192ddb4f5cc31530e1e8ab Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 15 Oct 2024 07:36:43 -0700 Subject: [PATCH 2927/3075] Update _overviews/jdk-compatibility/overview.md Co-authored-by: Tobias Roeser --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 73b52b624e..0ec03ced0b 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -35,7 +35,7 @@ Minimum working versions: | JDK | sbt | mill | |:-----------:|:---------------:|:-----------| -| 23 | 1.9.0 | ??? | +| 23 | 1.9.0 | 0.11.8 | | 21 (LTS) | 1.9.0 | 0.11.5 | | 17 (LTS) | 1.6.0 | 0.7.0 | | 11 (LTS) | 1.1.0 | 0.1.5 | From 8e84db6cdc0b7137dd7092396176a2ff7bd5bcad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gabriel=20K=C4=99pka?= <44374670+gkepka@users.noreply.github.com> Date: Wed, 16 Oct 2024 15:12:57 +0200 Subject: [PATCH 2928/3075] Use toolkit 0.5.0 version MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Sébastien Doeraene --- _overviews/getting-started/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/getting-started/index.md b/_overviews/getting-started/index.md index 11bc59e720..985b5222d4 100644 --- a/_overviews/getting-started/index.md +++ b/_overviews/getting-started/index.md @@ -227,7 +227,7 @@ The printed number should be 4: `hello.scala`, `counter.scala` and two hidden di As it turns out, the `os-lib` library is a part of Scala Toolkit, a collection of libraries recommended for tasks like testing, operating system interaction or handling JSONs. You can read more about the libraries included in the toolkit [here](/toolkit/introduction.html). -To include the toolkit libraries, use the `//> using toolkit default` directive: +To include the toolkit libraries, use the `//> using toolkit 0.5.0` directive: ```scala //> using scala {{site.scala-3-version}} //> using toolkit 0.5.0 From e4671da05599f011399ab37af2c5dca0de5078da Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Thu, 17 Oct 2024 00:25:32 +0200 Subject: [PATCH 2929/3075] Getting started manual install Scala CLI --- _overviews/getting-started/install-scala.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/getting-started/install-scala.md b/_overviews/getting-started/install-scala.md index 8ac7d57480..7d36f1c69f 100644 --- a/_overviews/getting-started/install-scala.md +++ b/_overviews/getting-started/install-scala.md @@ -137,13 +137,13 @@ For more information about `cs`, read ### ...or manually You only need two tools to compile, run, test, and package a Scala project: Java 8 or 11, -and sbt. +and Scala CLI. To install them manually: 1. if you don't have Java 8 or 11 installed, download Java from [Oracle Java 8](https://www.oracle.com/java/technologies/javase-jdk8-downloads.html), [Oracle Java 11](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html), or [AdoptOpenJDK 8/11](https://adoptopenjdk.net/). Refer to [JDK Compatibility](/overviews/jdk-compatibility/overview.html) for Scala/Java compatibility detail. -1. Install [sbt](https://www.scala-sbt.org/download.html) +1. Install [Scala CLI](https://scala-cli.virtuslab.org/install) ## Using the Scala CLI From bc18a0594a6302cb05b02996152849c2cb8a0799 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Thu, 17 Oct 2024 00:30:36 +0200 Subject: [PATCH 2930/3075] fix link to toolkit docs --- _overviews/getting-started/install-scala.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/getting-started/install-scala.md b/_overviews/getting-started/install-scala.md index 8ac7d57480..eeddfed422 100644 --- a/_overviews/getting-started/install-scala.md +++ b/_overviews/getting-started/install-scala.md @@ -198,7 +198,7 @@ You can read more about [main methods](/scala3/book/methods-main-methods.html) a ### Adding dependencies We now write a program that will count the files and directories present in its working directory. -We use the [os-lib](https://github.com/com-lihaoyi/os-lib) library from the [Scala toolkit](toolkit/introduction.html) +We use the [os-lib](https://github.com/com-lihaoyi/os-lib) library from the [Scala toolkit](/toolkit/introduction.html) for that purpose. A dependency on the library can be added with the `//> using` directive. Put the following code in `counter.scala`. ```scala //> using scala {{site.scala-3-version}} From de97948144e18a54eb49e08734d824b7a5fd2cca Mon Sep 17 00:00:00 2001 From: Dimi Racordon Date: Thu, 17 Oct 2024 13:12:46 +0200 Subject: [PATCH 2931/3075] Update the list of committee members --- _sips/process-specification.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_sips/process-specification.md b/_sips/process-specification.md index 8263fae131..93a15ce812 100644 --- a/_sips/process-specification.md +++ b/_sips/process-specification.md @@ -266,12 +266,11 @@ The current committee members are: - Lukas Rytz ([@lrytz](https://github.com/lrytz)), Lightbend - Martin Odersky ([@odersky](https://github.com/odersky)), EPFL - Oron Port ([@soronpo](https://github.com/soronpo)), DFiant Inc -- Paweł Marks ([@Kordyjan](https://github.com/Kordyjan)), VirtusLab - Sébastien Doeraene ([@sjrd](https://github.com/sjrd)), Scala Center The current Chairperson is: -- Anatolii Kmetiuk ([@Toli](https://github.com/anatoliykmetyuk)), Scala Center +- Dimi Racordon ([@kyouko-taiga](https://github.com/kyouko-taiga)), EPFL The current Secretary is: From 32fc8e0357b2f84781316cc8927d6131ea477153 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Thu, 17 Oct 2024 17:36:08 +0200 Subject: [PATCH 2932/3075] Remove sbt section from getting started (#3086) * Remove sbt section from getting started * add link to sbt and maven tutorials, reintroduce IDE sections --- _overviews/getting-started/install-scala.md | 127 ++++++++------------ 1 file changed, 50 insertions(+), 77 deletions(-) diff --git a/_overviews/getting-started/install-scala.md b/_overviews/getting-started/install-scala.md index 401f37af3f..9514530fa2 100644 --- a/_overviews/getting-started/install-scala.md +++ b/_overviews/getting-started/install-scala.md @@ -164,7 +164,7 @@ string to standard output. To run the program, execute `scala run hello.scala` command from a terminal, within the `` directory. The file will be compiled and executed, with console output similar to following: ``` -$ scala run hello.scala +$ scala run hello.scala Compiling project (Scala {{site.scala-3-version}}, JVM (20)) Compiled project (Scala {{site.scala-3-version}}, JVM (20)) Hello, World! @@ -187,7 +187,7 @@ the content of the `name` argument. To pass the arguments when executing the program, put them after `--`: ``` -$ scala run hello.scala -- Gabriel +$ scala run hello.scala -- Gabriel Compiling project (Scala {{site.scala-3-version}}, JVM (20)) Compiled project (Scala {{site.scala-3-version}}, JVM (20)) Hello, Gabriel! @@ -216,7 +216,7 @@ sequence of paths. Execute the program. The dependency will be automatically downloaded. The execution should result in a similar output: ``` -$ scala run counter.scala +$ scala run counter.scala Compiling project (Scala {{site.scala-3-version}}, JVM (20)) Compiled project (Scala {{site.scala-3-version}}, JVM (20)) 4 @@ -246,127 +246,100 @@ You can execute code interactively using the REPL provided by the `scala` comman $ scala Welcome to Scala {{site.scala-3-version}} (20-ea, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. - -scala> + +scala> ``` Write a line of code to be executed and press enter. ``` scala> println("Hello, World!") Hello, World! - -scala> + +scala> ``` The result will be printed immediately after executing the line. You can declare values: ``` scala> val i = 1 val i: Int = 1 - -scala> + +scala> ``` A new value of type `Int` has been created. If you provide an expression that can be evaluated, its result will be stored in an automatically created value. ``` scala> i + 3 val res0: Int = 4 - -scala> + +scala> ``` You can exit the REPL with `:exit`. -### Next steps - -Now that you have tasted a little bit of Scala, you can either explore the language itself, or learn how to set up a project using the -sbt and an IDE using the tutorials below. If you want to familiarize yourself with the language more, consider checking out: - -* [The Scala Book](/scala3/book/introduction.html) (see the Scala 2 version [here](/overviews/scala-book/introduction.html)), which provides a set of short lessons introducing Scala’s main features. -* [The Tour of Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. -* [Learning Resources](/learn.html), which includes online interactive tutorials and courses. -* [Our list of some popular Scala books](/books.html). - -## Create a "Hello World" project with sbt - -Once you have installed sbt, you are ready to create a Scala project, which -is explained in the following sections. +## Using an IDE -To create a project, you can either use the command line or an IDE. -If you are familiar with the command line, we recommend that approach. +> You can read a short summary of Scala IDEs on [a dedicated page](/getting-started/scala-ides.html). -### Using the command line - -sbt is a build tool for Scala. sbt compiles, runs, -and tests your Scala code. (It can also publish libraries and do many other tasks.) +Let's use an IDE to open the code we wrote above. The most popular ones are [IntelliJ](https://www.jetbrains.com/idea/) and +[VSCode](https://scalameta.org/metals/docs/editors/vscode). +They both offer rich IDE features, but you can still use [many other editors](https://scalameta.org/metals/docs/editors/overview.html). -To create a new Scala project with sbt: +### Prepare the project -1. `cd` to an empty folder. -1. Run the command `sbt new scala/scala3.g8` to create a Scala 3 project, or `sbt new scala/hello-world.g8` to create a Scala 2 project. - This pulls a project template from GitHub. - It will also create a `target` folder, which you can ignore. -1. When prompted, name the application `hello-world`. This will - create a project called "hello-world". -1. Let's take a look at what just got generated: +First, remove all the using directives, and put them in a single file `project.scala` in the `` directory. +This makes it easier to import as a project in an IDE: +```scala +//> using scala {{site.scala-3-version}} +//> using toolkit 0.5.0 ``` -- hello-world - - project (sbt uses this for its own files) - - build.properties - - build.sbt (sbt's build definition file) - - src - - main - - scala (all of your Scala code goes here) - - Main.scala (Entry point of program) <-- this is all we need for now -``` - -More documentation about sbt can be found in the [Scala Book](/scala3/book/tools-sbt.html) (see [here](/overviews/scala-book/scala-build-tool-sbt.html) for the Scala 2 version) -and in the official sbt [documentation](https://www.scala-sbt.org/1.x/docs/index.html) -### With an IDE - -You can read a short summary of Scala IDEs on [a dedicated page](/getting-started/scala-ides.html) - -## Open hello-world project - -Let's use an IDE to open the project. The most popular ones are [IntelliJ](https://www.jetbrains.com/idea/) and -[VSCode](https://scalameta.org/metals/docs/editors/vscode). -They both offer rich IDE features, but you can still use [many other editors](https://scalameta.org/metals/docs/editors/overview.html). +> Optionally, you can re-initialise the necessary IDE files from within the `` directory with the command `scala setup-ide .`, but these files will already exist if you have previously run the project with the Scala CLI `run` command. ### Using IntelliJ 1. Download and install [IntelliJ Community Edition](https://www.jetbrains.com/help/idea/installation-guide.html) 1. Install the Scala plugin by following [the instructions on how to install IntelliJ plugins](https://www.jetbrains.com/help/idea/discover-intellij-idea-for-scala.html) -1. Open the `build.sbt` file then choose *Open as a project* +1. Open the `` directory, which should be imported automatically as a BSP project. -### Using VSCode with metals +### Using VSCode with Metals 1. Download [VSCode](https://code.visualstudio.com/Download) 1. Install the Metals extension from [the Marketplace](https://marketplace.visualstudio.com/items?itemName=scalameta.metals) -1. Next, open the directory containing a `build.sbt` file (this should be the directory `hello-world` if you followed the previous instructions). When prompted to do so, select *Import build*. +1. Next, open the `` directory in VSCode. Metals should activate and begin importing the project automatically. ### Play with the source code -View these two files in your IDE: +View these three files in your IDE: + +- _project.scala_ +- _hello.scala_ +- _counter.scala_ + +You should notice the benefits of an IDE, such as syntax highlighting, and smart code interactions. +For example you can place the cursor over any part of the code, such as `os.pwd` in _counter.scala_ and documentation for the method will appear. + +When you run your project in the next step, the configuration in _project.scala_ will be used to run the code in the other source files. -- _build.sbt_ -- _src/main/scala/Main.scala_ +### Run the code -When you run your project in the next step, the configuration in _build.sbt_ will be used to run the code in _src/main/scala/Main.scala_. +If you’re comfortable using your IDE, you can run the code in _counter.scala_ from your IDE. +Attached to the `countFiles` method should be a prompt button. Click it to run the method. This should run without issue. +The `hello` method in _hello.scala_ needs arguments however, so will require extra configuration via the IDE to provide the argument. -## Run Hello World +Otherwise, you can run either application from the IDE's built-in terminal as described in above sections. -If you’re comfortable using your IDE, you can run the code in _Main.scala_ from your IDE. +## Next steps -Otherwise, you can run the application from a terminal with these steps: +Now that you have tasted a little bit of Scala, you can further explore the language itself, consider checking out: -1. `cd` into `hello-world`. -1. Run `sbt`. This opens up the sbt console. -1. Type `~run`. The `~` is optional and causes sbt to re-run on every file save, - allowing for a fast edit/run/debug cycle. sbt will also generate a `target` directory - which you can ignore. +* [The Scala Book](/scala3/book/introduction.html) (see the Scala 2 version [here](/overviews/scala-book/introduction.html)), which provides a set of short lessons introducing Scala’s main features. +* [The Tour of Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. +* [Learning Resources](/learn.html), which includes online interactive tutorials and courses. +* [Our list of some popular Scala books](/books.html). -When you’re finished experimenting with this project, press `[Enter]` to interrupt the `run` command. -Then type `exit` or press `[Ctrl+D]` to exit sbt and return to your command line prompt. +There are also other tutorials for other build-tools you can use with Scala: +* [Getting Started with Scala and sbt](/getting-started/sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html) +* [Using Scala and Maven](/tutorials/scala-with-maven.html) ## Getting Help There are a multitude of mailing lists and real-time chat rooms in case you want to quickly connect with other Scala users. Check out our [community](https://scala-lang.org/community/) page for a list of these resources, and for where to reach out for help. From 909c880cba71f9c1439c8e43f2218cefbeeae323 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 18 Oct 2024 18:07:38 -0700 Subject: [PATCH 2933/3075] update FAQ for governance page (#3089) --- _overviews/FAQ/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 18c901cdda..0a6f56c2d5 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -65,7 +65,7 @@ In short, the only officially sanctioned place is the \#jobs channel ### Who's behind Scala? -This is answered [on the community page](https://www.scala-lang.org/community/#whos-behind-scala). +This is answered [on the Governance page](https://www.scala-lang.org/governance/). ### Can I use the Scala logo? From cfa4a0d2b2321f37bafe0fed1dd3486fc3adf1ea Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 18 Oct 2024 18:08:14 -0700 Subject: [PATCH 2934/3075] add FAQ about IDEs (#3088) --- _overviews/FAQ/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 0a6f56c2d5..b8d96e5d8b 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -73,6 +73,10 @@ See [scala/scala-lang#1040](https://github.com/scala/scala-lang/issues/1040). ## Technical questions +### What IDEs are available for Scala? + +See [this doc page](https://docs.scala-lang.org/getting-started/scala-ides.html). + ### What compiler flags are recommended? The list of available options is From 0234fa46cc2ecba92239e4dae0279dce58736da8 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Sat, 19 Oct 2024 14:36:27 -0700 Subject: [PATCH 2935/3075] FAQ: minor improvements to functions vs methods (#3068) --- _overviews/FAQ/index.md | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index b8d96e5d8b..788c0c7f85 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -248,18 +248,22 @@ differ from a function value such as: val square: Int => Int = x => x * x -For Scala 2, there is a [complete answer on Stack Overflow](https://stackoverflow.com/a/2530007/4111404) +For **Scala 2**, there is a [complete answer on Stack Overflow](https://stackoverflow.com/a/2530007/4111404) and a [summary with practical differences](https://tpolecat.github.io/2014/06/09/methods-functions.html). -Note that in **Scala 3** the differences are fewer; -for example, they will be able to -[accept implicit parameters]({{ site.scala3ref }}/contextual/context-functions.html) -as well as [type parameters]({{ site.scala3ref }}/new-types/polymorphic-function-types.html). - -Nevertheless, it is still recommended to use methods most of the time, -unless you absolutely need a function. And, thanks to -[eta-expansion](https://stackoverflow.com/questions/39445018/what-is-the-eta-expansion-in-scala) -you rarely would need to define a function rather than a method. +In **Scala 3**, the differences are fewer. +[Context functions]({{ site.scala3ref }}/contextual/context-functions.html) +accept given parameters and +[polymorphic functions]({{ site.scala3ref }}/new-types/polymorphic-function-types.html) +have type parameters. + +It's standard to use methods most of the time, +except when function value is actually needed. +[Eta-expansion](https://stackoverflow.com/questions/39445018/what-is-the-eta-expansion-in-scala), +converts methods to functions when needed. +For example, a method such as `map` expects a function, +but even if you `def square` as shown above, you can +still `xs.map(square)`. ### What's the difference between types and classes? From cee9851ba1edaf550833031786593bbd0efe793d Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Sat, 19 Oct 2024 14:37:12 -0700 Subject: [PATCH 2936/3075] oops --- _overviews/FAQ/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 788c0c7f85..7c0b101dd2 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -258,7 +258,7 @@ accept given parameters and have type parameters. It's standard to use methods most of the time, -except when function value is actually needed. +except when a function value is actually needed. [Eta-expansion](https://stackoverflow.com/questions/39445018/what-is-the-eta-expansion-in-scala), converts methods to functions when needed. For example, a method such as `map` expects a function, From 21dc17d509e68db09edb9e3792381f71e24fa8dd Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Sat, 19 Oct 2024 15:36:25 -0700 Subject: [PATCH 2937/3075] fix broken links stemming from IDE page addition --- _ja/index.md | 2 +- _overviews/contribute/add-guides.md | 2 +- _overviews/scala-book/preliminaries.md | 2 +- _ru/index.md | 2 +- _ru/scala3/book/tools-sbt.md | 2 +- _uk/index.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_ja/index.md b/_ja/index.md index b94f171774..358ef903da 100644 --- a/_ja/index.md +++ b/_ja/index.md @@ -14,7 +14,7 @@ sections: - title: "入門" description: "あなたのコンピューターに Scala をインストールして、Scala コードを書きはじめよう！" icon: "fa fa-rocket" - link: /ja/getting-started/index.html + link: /ja/getting-started/install-scala.html - title: "Scala ツアー" description: "コア言語機能をひと口大で紹介" icon: "fa fa-flag" diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md index 5a4bed14f7..4840739cda 100644 --- a/_overviews/contribute/add-guides.md +++ b/_overviews/contribute/add-guides.md @@ -338,7 +338,7 @@ You must also add the tutorial to the drop-down list in the navigation bar. To d --- - title: Getting Started - url: "/getting-started/index.html" + url: "/getting-started/install-scala.html" - title: Learn ... - title: Tutorials diff --git a/_overviews/scala-book/preliminaries.md b/_overviews/scala-book/preliminaries.md index cbc5221dff..8308f59818 100644 --- a/_overviews/scala-book/preliminaries.md +++ b/_overviews/scala-book/preliminaries.md @@ -21,7 +21,7 @@ That being said, there are a few good things to know before you read this book. ## Installing Scala -First, to run the examples in this book you’ll need to install Scala on your computer. See our general [Getting Started]({{site.baseurl}}/getting-started/index.html) page for details on how to use Scala (a) in an IDE and (b) from the command line. +First, to run the examples in this book you’ll need to install Scala on your computer. See our general [Getting Started]({{site.baseurl}}/getting-started/install-scala.html) page for details on how to use Scala (a) in an IDE and (b) from the command line. diff --git a/_ru/index.md b/_ru/index.md index df628955a5..7ac8c2a455 100644 --- a/_ru/index.md +++ b/_ru/index.md @@ -11,7 +11,7 @@ sections: - title: "Приступая к работе" description: "Установите Scala на свой компьютер и начните писать код на Scala!" icon: "fa fa-rocket" - link: /ru/getting-started/index.html + link: /ru/getting-started/install-scala.html - title: "Тур по Scala" description: "Вступительный обзор по основным возможностям языка." icon: "fa fa-flag" diff --git a/_ru/scala3/book/tools-sbt.md b/_ru/scala3/book/tools-sbt.md index 6dd330c28e..be70b9b050 100644 --- a/_ru/scala3/book/tools-sbt.md +++ b/_ru/scala3/book/tools-sbt.md @@ -485,4 +485,4 @@ sbt:HelloScalaTest> test - [The sbt documentation](https://www.scala-sbt.org/1.x/docs/) - [The ScalaTest website](https://www.scalatest.org/) -[getting_started]: {{ site.baseurl }}/ru/getting-started/index.html +[getting_started]: {{ site.baseurl }}/ru/getting-started/install-scala.html diff --git a/_uk/index.md b/_uk/index.md index 375daaba5d..6242b6e807 100644 --- a/_uk/index.md +++ b/_uk/index.md @@ -16,7 +16,7 @@ sections: - title: "Початок роботи" description: "Встанови Scala на свій комп'ютер і почни писати код Scala!" icon: "fa fa-rocket" - link: /uk/getting-started/index.html + link: /uk/getting-started/install-scala.html - title: "Екскурсія по Скала" description: "Короткі введення в основні особливості мови." icon: "fa fa-flag" From 02ec810e40f531d9354397605686b61479c64a6b Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Sat, 19 Oct 2024 15:45:57 -0700 Subject: [PATCH 2938/3075] fix more broken links --- _fr/getting-started/{index.md => install-scala.md} | 0 _ja/getting-started/{index.md => install-scala.md} | 0 _ru/getting-started/{index.md => install-scala.md} | 0 _uk/getting-started/{index.md => install-scala.md} | 0 4 files changed, 0 insertions(+), 0 deletions(-) rename _fr/getting-started/{index.md => install-scala.md} (100%) rename _ja/getting-started/{index.md => install-scala.md} (100%) rename _ru/getting-started/{index.md => install-scala.md} (100%) rename _uk/getting-started/{index.md => install-scala.md} (100%) diff --git a/_fr/getting-started/index.md b/_fr/getting-started/install-scala.md similarity index 100% rename from _fr/getting-started/index.md rename to _fr/getting-started/install-scala.md diff --git a/_ja/getting-started/index.md b/_ja/getting-started/install-scala.md similarity index 100% rename from _ja/getting-started/index.md rename to _ja/getting-started/install-scala.md diff --git a/_ru/getting-started/index.md b/_ru/getting-started/install-scala.md similarity index 100% rename from _ru/getting-started/index.md rename to _ru/getting-started/install-scala.md diff --git a/_uk/getting-started/index.md b/_uk/getting-started/install-scala.md similarity index 100% rename from _uk/getting-started/index.md rename to _uk/getting-started/install-scala.md From 424c1500974165ead432abb1c2ba1f2d78768f8c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?TATSUNO=20=E2=80=9CTaz=E2=80=9D=20Yasuhiro?= Date: Sun, 20 Oct 2024 21:13:23 +0900 Subject: [PATCH 2939/3075] Replace build status badge (#3092) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6a32febe4c..013a66267c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Scala Documentation # -[![Build Status](https://ci.scala-lang.org/api/badges/scala/docs.scala-lang/status.svg)](https://platform-ci.scala-lang.org/scala/docs.scala-lang) +[![Build Status](https://github.com/scala/docs.scala-lang/actions/workflows/build.yml/badge.svg)](https://github.com/scala/docs.scala-lang/actions/workflows/build.yml?query=branch%3Amain) This repository contains the source for the Scala documentation website, as well as the source for "Scala Improvement Process" (SIP) documents. From d49338f30d47779b8fff16ec5090eaf855268668 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur Date: Tue, 22 Oct 2024 16:42:51 +0200 Subject: [PATCH 2940/3075] Add Scala 3.5.2 to API docs (#3093) * Add Scala 3.5.2 API docs --- _config.yml | 2 +- api/all.md | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/_config.yml b/_config.yml index 17af657e08..aed90af2e1 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.15 scala-212-version: 2.12.20 -scala-3-version: 3.5.1 +scala-3-version: 3.5.2 collections: style: diff --git a/api/all.md b/api/all.md index 48331c8571..db37824fc7 100644 --- a/api/all.md +++ b/api/all.md @@ -64,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.5.1 + * [Library API](https://www.scala-lang.org/api/3.5.1/) * Scala 3.5.0 * [Library API](https://www.scala-lang.org/api/3.5.0/) * Scala 3.4.3 From 05fd0783e080be304b7d97ad1d91b625e927ec86 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 23 Oct 2024 12:10:19 -0700 Subject: [PATCH 2941/3075] on IDEs page, give non-VS-Code editors their own section (#3090) I also did some copyediting and rewording of this and that --- _overviews/getting-started/scala-ides.md | 26 +++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/_overviews/getting-started/scala-ides.md b/_overviews/getting-started/scala-ides.md index 444e641181..9f210d4b1e 100644 --- a/_overviews/getting-started/scala-ides.md +++ b/_overviews/getting-started/scala-ides.md @@ -15,13 +15,11 @@ keywords: - Metals --- -## Introduction +It's of course possible to write Scala code in any editor and compile and run the code from the command line. But most developers prefer to use an IDE (Integrated Development Environment), especially for coding anything beyond simple exercises. -Theoretically, you can write Scala code even in a notepad and compile and run the code from the terminal. When you do it, the compiler will tell you if it encounters any problems and suggest changes. You can apply that feedback in the notepad and try again. +The following IDEs are available for Scala: -However, this way of software development will quickly prove to be unusable when you start coding anything more complicated than simple exercises. For larger projects, we highly recommend that you use one of the following IDEs (Integrated Development Environments): - -# IntelliJ IDEA + Scala Plugin +## IntelliJ IDEA + Scala plugin [https://jetbrains.com/scala](https://jetbrains.com/scala) @@ -33,11 +31,25 @@ IntelliJ IDEA and Scala Plugin will assist you in virtually every part of a Scal For more information, check out our tutorial [Getting Started with Scala in IntelliJ](/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.html) -# Visual Studio Code + Metals +## Visual Studio Code + Metals [https://scalameta.org/metals](https://scalameta.org/metals) ![](../../resources/images/getting-started/VSCodeMetals.png) -Visual Studio Code, commonly called VS Code, is a source code editor developed by Microsoft. Similar to how IntelliJ IDEA requires IntelliJ Scala Plugin to support Scala, you can get support for Scala in VS Code by installing an extension: Metals by Scalameta. In contrast to IntelliJ IDEA + Scala Plugin, VS Code + Metals is is aimed at people who like to get feedback and code intelligence straight from the compiler, which enables them to also try out experimental Scala features. Besides, Metals - as an [language server](https://microsoft.github.io/language-server-protocol/) - is also available to use with a variety of other source-code editors, such as Vim, Sublime Text, Zed, Helix and Emacs, which means that you will get a similar experience in any of them. +Visual Studio Code, commonly called VS Code, is a source code editor from Microsoft. To add Scala support, you install an extension called Metals. + +(Why "Metals"? Because the underlying technologies are Scalameta and LSP ([Language Server Protocol](https://microsoft.github.io/language-server-protocol/)), and "Meta" + "LS" equals "Metals".) + +In contrast to IntelliJ IDEA + Scala Plugin, VS Code + Metals is aimed at people who like to get feedback and code intelligence straight from the compiler, which enables them to also try out experimental Scala features. + +## Your favorite editor + Metals + +Metals is most commonly used with VS Code, but it's also available for the following popular editors: + +* Emacs +* Vim +* Sublime Text +* Helix +as documented [here](https://scalameta.org/metals/docs/#editor-support). From 905ed27514046a8427dff6aaee2d5894b99e927e Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Sat, 26 Oct 2024 12:36:51 -0700 Subject: [PATCH 2942/3075] language tour: remove old 'automatic closures' page (#3094) fixes #1691 --- _ba/tour/automatic-closures.md | 7 --- _es/tour/automatic-closures.md | 65 -------------------------- _es/tour/multiple-parameter-lists.md | 2 +- _es/tour/operators.md | 2 +- _es/tour/tour-of-scala.md | 1 - _fr/tour/automatic-closures.md | 7 --- _ja/tour/automatic-closures.md | 59 ------------------------ _ko/tour/annotations.md | 2 +- _ko/tour/automatic-closures.md | 67 --------------------------- _ko/tour/operators.md | 2 +- _pl/tour/automatic-closures.md | 66 --------------------------- _pt-br/tour/annotations.md | 2 +- _pt-br/tour/automatic-closures.md | 68 ---------------------------- _pt-br/tour/operators.md | 2 +- _pt-br/tour/tour-of-scala.md | 1 - _ru/tour/automatic-closures.md | 61 ------------------------- _th/tour/automatic-closures.md | 7 --- _tour/automatic-closures.md | 61 ------------------------- _tour/by-name-parameters.md | 1 + _zh-cn/tour/automatic-closures.md | 7 --- 20 files changed, 7 insertions(+), 483 deletions(-) delete mode 100644 _ba/tour/automatic-closures.md delete mode 100644 _es/tour/automatic-closures.md delete mode 100644 _fr/tour/automatic-closures.md delete mode 100644 _ja/tour/automatic-closures.md delete mode 100644 _ko/tour/automatic-closures.md delete mode 100644 _pl/tour/automatic-closures.md delete mode 100644 _pt-br/tour/automatic-closures.md delete mode 100644 _ru/tour/automatic-closures.md delete mode 100644 _th/tour/automatic-closures.md delete mode 100644 _tour/automatic-closures.md delete mode 100644 _zh-cn/tour/automatic-closures.md diff --git a/_ba/tour/automatic-closures.md b/_ba/tour/automatic-closures.md deleted file mode 100644 index 90f751ee2c..0000000000 --- a/_ba/tour/automatic-closures.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -layout: tour -title: Automatic Type-Dependent Closure Construction -partof: scala-tour - -language: ba ---- diff --git a/_es/tour/automatic-closures.md b/_es/tour/automatic-closures.md deleted file mode 100644 index 5d8cb2f998..0000000000 --- a/_es/tour/automatic-closures.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -layout: tour -title: Construcción de closures automáticas -partof: scala-tour - -num: 16 -language: es - -next-page: operators -previous-page: multiple-parameter-lists ---- - -Scala permite pasar funciones sin parámetros como parámetros de un método. Cuando un método así es invocado, los parámetros reales de la función enviada sin parámetros no son evaluados y una función "nularia" (de aridad cero, 0-aria, o sin parámetros) es pasada en su lugar. Esta función encapsula el comportamiento del parámetro correspondiente (comunmente conocido como "llamada por nombre"). - -Para aclarar un poco esto aquí se muestra un ejemplo: - - object TargetTest1 extends App { - def whileLoop(cond: => Boolean)(body: => Unit): Unit = - if (cond) { - body - whileLoop(cond)(body) - } - var i = 10 - whileLoop (i > 0) { - println(i) - i -= 1 - } - } - -La función `whileLoop` recibe dos parámetros `cond` y `body`. Cuando la función es llamada, los parámetros reales no son evaluados en ese momento. Pero cuando los parámetros son utilizados en el cuerpo de la función `whileLoop`, las funciones nularias creadas implícitamente serán evaluadas en su lugar. Así, nuestro método `whileLoop` implementa un bucle tipo Java mediante una implementación recursiva. - -Es posible combinar el uso de [operadores de infijo y postfijo (infix/postfix)](operators.html) con este mecanismo para crear declaraciones más complejas (con una sintaxis agradadable). - -Aquí mostramos la implementación de una declaración tipo repetir-a-menos-que (repetir el bucle a no ser que se cumpla X condición): - - object TargetTest2 extends App { - def loop(body: => Unit): LoopUnlessCond = - new LoopUnlessCond(body) - protected class LoopUnlessCond(body: => Unit) { - def unless(cond: => Boolean): Unit = { - body - if (!cond) unless(cond) - } - } - var i = 10 - loop { - println("i = " + i) - i -= 1 - } unless (i == 0) - } - -La función `loop` solo acepta el cuerpo de un bucle y retorna una instancia de la clase `LoopUnlessCond` (la cual encapsula el cuerpo del objeto). Es importante notar que en este punto el cuerpo del bucle no ha sido evaluado aún. La clase `LoopUnlessCond` tiene un método `unless` el cual puede ser usado como un *operador de infijo (infix)*. De esta manera podemos lograr una sintaxis muy natural para nuestro nuevo bucle `repetir { a_menos_que ( )`. - -A continuación se expone el resultado de la ejecución de `TargetTest2`: - - i = 10 - i = 9 - i = 8 - i = 7 - i = 6 - i = 5 - i = 4 - i = 3 - i = 2 - i = 1 diff --git a/_es/tour/multiple-parameter-lists.md b/_es/tour/multiple-parameter-lists.md index cdb652151d..83b7218c0b 100644 --- a/_es/tour/multiple-parameter-lists.md +++ b/_es/tour/multiple-parameter-lists.md @@ -6,7 +6,7 @@ partof: scala-tour num: 15 language: es -next-page: automatic-closures +next-page: operators previous-page: nested-functions --- diff --git a/_es/tour/operators.md b/_es/tour/operators.md index a2d3b5e4be..6aeb98e046 100644 --- a/_es/tour/operators.md +++ b/_es/tour/operators.md @@ -7,7 +7,7 @@ num: 17 language: es next-page: higher-order-functions -previous-page: automatic-closures +previous-page: multiple-parameter-lists --- En Scala, cualquier método el cual reciba un solo parámetro puede ser usado como un *operador de infijo (infix)*. Aquí se muestra la definición de la clase `MyBool`, la cual define tres métodos `and`, `or`, y `negate`. diff --git a/_es/tour/tour-of-scala.md b/_es/tour/tour-of-scala.md index 19b4f60af8..b742b271ab 100644 --- a/_es/tour/tour-of-scala.md +++ b/_es/tour/tour-of-scala.md @@ -37,7 +37,6 @@ El [mecanismo de inferencia de tipos locales](type-inference.html) se encarga de En la práctica, el desarrollo de aplicaciones específicas para un dominio generalmente requiere de "Lenguajes de dominio específico" (DSL). Scala provee una única combinación de mecanismos del lenguaje que simplifican la creación de construcciones propias del lenguaje en forma de bibliotecas: * cualquier método puede ser usado como un operador de [infijo o postfijo](operators.html) -* [las closures son construidas automáticamente dependiendo del tipo esperado](automatic-closures.html) (tipos objetivo). El uso conjunto de ambas características facilita la definición de nuevas sentencias sin tener que extender la sintaxis y sin usar facciones de meta-programación como tipo macros. diff --git a/_fr/tour/automatic-closures.md b/_fr/tour/automatic-closures.md deleted file mode 100644 index f5a06a5f5f..0000000000 --- a/_fr/tour/automatic-closures.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -layout: tour -title: Automatic Closures -partof: scala-tour - -language: fr ---- diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md deleted file mode 100644 index 80cb7edf7e..0000000000 --- a/_ja/tour/automatic-closures.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -layout: tour -title: 型依存クロージャの自動構築 -language: ja -partof: scala-tour ---- - -Scalaはメソッドのパラメータとしてパラメータ無しの関数名を渡せます。そのようなメソッドが呼ばれると、パラメータ無しの関数名は実際に評価されず、代わりに、対応するパラメーターの処理をカプセル化した、引数無しの関数が渡されます(いわゆる *名前渡し*評価です)。 - -以下のコードはこの仕組みを説明しています。 - - object TargetTest1 extends Application { - def whileLoop(cond: => Boolean)(body: => Unit): Unit = - if (cond) { - body - whileLoop(cond)(body) - } - var i = 10 - whileLoop (i > 0) { - println(i) - i -= 1 - } - } - -関数 whileLoop は2つのパラメータ`cond`と`body`を受け取ります。関数が適用される時、実際のパラメータは評価されません。しかし形式上のパラメータが`whileLoop`の本体内で使われる度に、暗黙に生成された引数の無い関数が代わりに評価されます。このようにメソッド`whileLoop`はJavaのようなwhileループを再帰的な方法で実装しています。 - -[中置/後置 演算子](operators.html)とこのメカニズムを組み合わせて利用し、より複雑な命令文を(より良い構文で)作れます。 - -こちらがloop-unless式の実装です。 - - object TargetTest2 extends Application { - def loop(body: => Unit): LoopUnlessCond = - new LoopUnlessCond(body) - protected class LoopUnlessCond(body: => Unit) { - def unless(cond: => Boolean): Unit = { - body - if (!cond) unless(cond) - } - } - var i = 10 - loop { - println("i = " + i) - i -= 1 - } unless (i == 0) - } -この`loop`関数はループ処理の本体を受け取り、クラス`LoopUnlessCond`(この処理の本体をカプセル化する)のインスタンスを返すだけです。処理の本体はまだ評価されていないことに気をつけてください。クラス`LoopUnlessCond`は *中置演算子* として使えるメソッド`unless`を持ちます。このように、新しいループ処理: `loop { < stats > } unless ( < cond > )`のとても自然な構文を作れます。 - -こちらが`TargetTest2`を実行した時の出力です。 - - i = 10 - i = 9 - i = 8 - i = 7 - i = 6 - i = 5 - i = 4 - i = 3 - i = 2 - i = 1 diff --git a/_ko/tour/annotations.md b/_ko/tour/annotations.md index 924664303d..11b5da4b50 100644 --- a/_ko/tour/annotations.md +++ b/_ko/tour/annotations.md @@ -7,7 +7,7 @@ num: 31 language: ko next-page: packages-and-imports -previous-page: automatic-closures +previous-page: operators --- 어노테이션은 메타 정보와 정의 내용을 연결해준다. diff --git a/_ko/tour/automatic-closures.md b/_ko/tour/automatic-closures.md deleted file mode 100644 index 639623c537..0000000000 --- a/_ko/tour/automatic-closures.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -layout: tour -title: 타입 의존 클로저의 자동 구성 -partof: scala-tour - -num: 30 -language: ko - -next-page: annotations -previous-page: operators ---- - -스칼라에선 파라미터가 없는 함수의 이름을 메소드의 파라미터로 사용할 수 있다. 이런 메소드가 호출되면 파라미터가 없는 함수의 이름에 해당하는 실제 파라미터를 찾지 않고, 대신 해당 파라미터의 계산을 캡슐화한 무항 함수를 전달하게 된다(소위 말하는 *이름에 의한 호출* 연산). - -다음 코드는 이 방식을 사용하는 방법을 보여준다. - - object TargetTest1 extends App { - def whileLoop(cond: => Boolean)(body: => Unit): Unit = - if (cond) { - body - whileLoop(cond)(body) - } - var i = 10 - whileLoop (i > 0) { - println(i) - i -= 1 - } - } - -`whileLoop` 함수는 `cond`와 `body`라는 두 파라미터를 받는다. 이 함수가 적용될 때 실제 파라미터는 계산되지 않는다. 대신 `whileLoop`의 내부에서 이 정형 파라미터를 사용할 때마다 암시적으로 생성된 무항 함수로 처리한다. 따라서 `whileLoop` 메소드는 재귀 구현의 방식에 맞춰 자바와 같은 while 반복문을 구현한다. - -[중위/후위 연산자](operators.html)와 이 기법을 함께 사용해 좀 더 복잡한 명령문(보기 좋게 작성된)을 생성할 수 있다. - -다음은 반복문을 제거한 명령문 구현이다. - - object TargetTest2 extends App { - def loop(body: => Unit): LoopUnlessCond = - new LoopUnlessCond(body) - protected class LoopUnlessCond(body: => Unit) { - def unless(cond: => Boolean): Unit = { - body - if (!cond) unless(cond) - } - } - var i = 10 - loop { - println("i = " + i) - i -= 1 - } unless (i == 0) - } - -`loop` 함수는 단순히 반복문의 내용을 받아서 `LoopUnlessCond` 클래스의 인스턴스(반복문 내용에 해당하는 객체를 캡슐화한)를 반환한다. 해당 내용이 아직 계산되지 않았음을 유념하자. `LoopUnlessCond` 클래스는 *중위 연산자*로 사용할 수 있는 `unless`라는 메소드를 포함하고 있다. 이런 접근을 통해 상당히 자연스럽게 표현된 새로운 반복문을 완성하게 된다: `loop { < stats > } unless ( < cond > )`. - -다음은 `TargetTest2`를 실행한 출력 결과다. - - i = 10 - i = 9 - i = 8 - i = 7 - i = 6 - i = 5 - i = 4 - i = 3 - i = 2 - i = 1 - -윤창석, 이한욱 옮김 diff --git a/_ko/tour/operators.md b/_ko/tour/operators.md index fd904bfdd7..4306b08744 100644 --- a/_ko/tour/operators.md +++ b/_ko/tour/operators.md @@ -6,7 +6,7 @@ partof: scala-tour num: 29 language: ko -next-page: automatic-closures +next-page: annotations previous-page: type-inference --- diff --git a/_pl/tour/automatic-closures.md b/_pl/tour/automatic-closures.md deleted file mode 100644 index 8251a6be35..0000000000 --- a/_pl/tour/automatic-closures.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -layout: tour -title: Automatyczna konstrukcja domknięć -partof: scala-tour - -num: 30 -language: pl -next-page: annotations -previous-page: operators ---- - -Scala pozwala na przekazywanie funkcji bezparametrycznych jako argumenty dla metod. Kiedy tego typu metoda jest wywołana, właściwe parametry dla funkcji bezparametrycznych nie są ewaluowane i przekazywana jest pusta funkcja, która enkapsuluje obliczenia odpowiadającego parametru (tzw. *wywołanie-przez-nazwę*). - -Poniższy kod demonstruje działanie tego mechanizmu: - -```scala mdoc -def whileLoop(cond: => Boolean)(body: => Unit): Unit = - if (cond) { - body - whileLoop(cond)(body) - } -var i = 10 -whileLoop (i > 0) { - println(i) - i -= 1 -} -``` - -Funkcja `whileLoop` pobiera dwa parametry: `cond` i `body`. Kiedy funkcja jest aplikowana, jej właściwe parametry nie są ewaluowane. Lecz gdy te parametry są wykorzystane w ciele `whileLoop`, zostanie ewaluowana niejawnie utworzona funkcja zwracająca ich prawdziwą wartość. Zatem metoda `whileLoop` implementuje rekursywnie pętlę while w stylu Javy. - -Możemy połączyć ze sobą wykorzystanie [operatorów infiksowych/postfiksowych](operators.html) z tym mechanizmem aby utworzyć bardziej złożone wyrażenia. - -Oto implementacja pętli w stylu wykonaj-dopóki: - -```scala mdoc:reset -def loop(body: => Unit): LoopUnlessCond = - new LoopUnlessCond(body) -protected class LoopUnlessCond(body: => Unit) { - def unless(cond: => Boolean): Unit = { - body - if (!cond) unless(cond) - } -} -var i = 10 -loop { - println("i = " + i) - i -= 1 -} unless (i == 0) -``` - -Funkcja `loop` przyjmuje ciało pętli oraz zwraca instancję klasy `LoopUnlessCond` (która enkapsuluje to ciało). Warto zwrócić uwagę, że ciało tej funkcji nie zostało jeszcze ewaluowane. Klasa `LoopUnlessCond` posiada metodę `unless`, którą możemy wykorzystać jako *operator infiksowy*. W ten sposób uzyskaliśmy całkiem naturalną składnię dla naszej nowej pętli: `loop { < stats > } unless ( < cond > )`. - -Oto wynik działania programu `TargetTest2`: - -``` -i = 10 -i = 9 -i = 8 -i = 7 -i = 6 -i = 5 -i = 4 -i = 3 -i = 2 -i = 1 -``` diff --git a/_pt-br/tour/annotations.md b/_pt-br/tour/annotations.md index 5d0842e42c..55d49cc441 100644 --- a/_pt-br/tour/annotations.md +++ b/_pt-br/tour/annotations.md @@ -5,7 +5,7 @@ partof: scala-tour num: 31 next-page: packages-and-imports -previous-page: automatic-closures +previous-page: operators language: pt-br --- diff --git a/_pt-br/tour/automatic-closures.md b/_pt-br/tour/automatic-closures.md deleted file mode 100644 index dfa5b9dd12..0000000000 --- a/_pt-br/tour/automatic-closures.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -layout: tour -title: Construção Automática de Closures de Tipo-Dependente -partof: scala-tour - -num: 30 -next-page: annotations -previous-page: operators -language: pt-br ---- - -_Nota de tradução: A palavra `closure` em pode ser traduzida como encerramento/fechamento, porém é preferível utilizar a notação original_ - -Scala permite funções sem parâmetros como parâmetros de métodos. Quando um tal método é chamado, os parâmetros reais para nomes de função sem parâmetros não são avaliados e uma função nula é passada em vez disso, tal função encapsula a computação do parâmetro correspondente (isso é conhecido por avaliação *call-by-name*). - -O código a seguir demonstra esse mecanismo: - -```scala mdoc -def whileLoop(cond: => Boolean)(body: => Unit): Unit = - if (cond) { - body - whileLoop(cond)(body) - } -var i = 10 -whileLoop (i > 0) { - println(i) - i -= 1 -} -``` - -A função `whileLoop` recebe dois parâmetros: `cond` e `body`. Quando a função é aplicada, os parâmetros reais não são avaliados. Mas sempre que os parâmetros formais são usados no corpo de `whileLoop`, as funções nulas criadas implicitamente serão avaliadas em seu lugar. Assim, o nosso método `whileLoop` implementa um while-loop Java-like com um esquema de implementação recursiva. - -Podemos combinar o uso de [operadores infix/postfix](operators.html) com este mecanismo para criar declarações mais complexas (com uma sintaxe agradável). - -Aqui está a implementação de uma instrução que executa loop a menos que uma condição seja satisfeita: - -```scala mdoc:reset -def loop(body: => Unit): LoopUnlessCond = - new LoopUnlessCond(body) -protected class LoopUnlessCond(body: => Unit) { - def unless(cond: => Boolean): Unit = { - body - if (!cond) unless(cond) - } -} -var i = 10 -loop { - println("i = " + i) - i -= 1 -} unless (i == 0) -``` - -A função `loop` aceita apenas um corpo e retorna uma instância da classe` LoopUnlessCond` (que encapsula este objeto de corpo). Note que o corpo ainda não foi avaliado. A classe `LoopUnlessCond` tem um método `unless` que podemos usar como um *operador infix*. Dessa forma, obtemos uma sintaxe bastante natural para nosso novo loop: `loop { } unless ( )`. - -Aqui está a saída de quando o `TargetTest2` é executado: - -``` -i = 10 -i = 9 -i = 8 -i = 7 -i = 6 -i = 5 -i = 4 -i = 3 -i = 2 -i = 1 -``` diff --git a/_pt-br/tour/operators.md b/_pt-br/tour/operators.md index b38e0e3105..627b968e73 100644 --- a/_pt-br/tour/operators.md +++ b/_pt-br/tour/operators.md @@ -4,7 +4,7 @@ title: Operadores partof: scala-tour num: 29 -next-page: automatic-closures +next-page: annotations previous-page: type-inference language: pt-br --- diff --git a/_pt-br/tour/tour-of-scala.md b/_pt-br/tour/tour-of-scala.md index a455ddd001..970b47d0c0 100644 --- a/_pt-br/tour/tour-of-scala.md +++ b/_pt-br/tour/tour-of-scala.md @@ -38,7 +38,6 @@ Um [mecanismo de inferência de tipo local](type-inference.html) se encarrega pa Na prática, o desenvolvimento de aplicações de um determinado domínio geralmente requer uma linguagem de domínio específico. Scala fornece uma combinação única de mecanismos de linguagem que facilitam a adição suave de novas construções de linguagem na forma de bibliotecas: * qualquer método pode ser utilizado como um [operador infix ou postfix](operators.html) -* [closures são construídas automaticamente dependendo do tipo esperado](automatic-closures.html) (tipo alvo). Uma utilização conjunta de ambos os recursos facilita a definição de novas instruções sem estender a sintaxe e sem usar meta-programação como macros. diff --git a/_ru/tour/automatic-closures.md b/_ru/tour/automatic-closures.md deleted file mode 100644 index 8f0a8d4451..0000000000 --- a/_ru/tour/automatic-closures.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -layout: tour -title: Конструкция Автоматического Замыкания Зависимого Типа -language: ru -partof: scala-tour -num: 14 ---- - -Scala допускает использование в качестве параметров методов имена беспараметрических функций. При вызове такого метода фактические параметры для беспараметрических функций не вычисляются, а передается функция с нулем аргументов, которая захватывает вычисление соответствующего параметра (так называемый *вызов по имени*). - -Следующий код демонстрирует этот механизм: - - object TargetTest1 extends Application { - def whileLoop(cond: => Boolean)(body: => Unit): Unit = - if (cond) { - body - whileLoop(cond)(body) - } - var i = 10 - whileLoop (i > 0) { - println(i) - i -= 1 - } - } - -Функция whileLoop принимает два параметра `cond` и `body`. При использовании функции значения этих параметров не вычисляются. Но всякий раз, когда параметры используются в теле `whileLoop`, их значение будет вычисляться заново через использование автоматически созданных неявно вызываемых функций. Таким образом, наш метод `whileLoop` реализует Java-подобный цикл while-loop со схемой рекурсивной реализации. - -Мы можем комбинировать использование [инфиксных/постфиксных операторов](operators.html) с этим механизмом для создания более сложных выражений (с хорошим синтаксисом). - -Вот реализация loop-unless выражения: - - object TargetTest2 extends Application { - def loop(body: => Unit): LoopUnlessCond = - new LoopUnlessCond(body) - protected class LoopUnlessCond(body: => Unit) { - def unless(cond: => Boolean): Unit = { - body - if (!cond) unless(cond) - } - } - var i = 10 - loop { - println("i = " + i) - i -= 1 - } unless (i == 0) - } -Функция `loop` принимает только тело цикла и возвращает экземпляр класса `LoopUnlessCond` (который захватывает это тело цикла). Обратите внимание, что тело еще не вычислено. Класс `LoopUnlessCond` имеет метод `unless`, который мы можем использовать как *инфиксный оператор*. Таким образом, мы получаем вполне естественный синтаксис для нашего нового цикла: `loop { < выражение > } unless ( < условие > )`. - - -Ниже приведен вывод выполнения `TargetTest2`: - - i = 10 - i = 9 - i = 8 - i = 7 - i = 6 - i = 5 - i = 4 - i = 3 - i = 2 - i = 1 diff --git a/_th/tour/automatic-closures.md b/_th/tour/automatic-closures.md deleted file mode 100644 index 1c30b693a9..0000000000 --- a/_th/tour/automatic-closures.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -layout: tour -title: Automatic Closures -partof: scala-tour - -language: th ---- diff --git a/_tour/automatic-closures.md b/_tour/automatic-closures.md deleted file mode 100644 index 2a3d889d35..0000000000 --- a/_tour/automatic-closures.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -layout: tour -title: Automatic Type-Dependent Closure Construction -partof: scala-tour - -redirect_from: "/tutorials/tour/automatic-closures.html" ---- - -Scala allows parameterless function names as parameters of methods. When such a method is called, the actual parameters for parameterless function names are not evaluated and a nullary function is passed instead which encapsulates the computation of the corresponding parameter (so-called *call-by-name* evaluation). - -The following code demonstrates this mechanism: - -```scala mdoc -def whileLoop(cond: => Boolean)(body: => Unit): Unit = - if (cond) { - body - whileLoop(cond)(body) - } -var i = 10 -whileLoop (i > 0) { - println(i) - i -= 1 -} -``` - -The function whileLoop takes two parameters `cond` and `body`. When the function is applied, the actual parameters do not get evaluated. But whenever the formal parameters are used in the body of `whileLoop`, the implicitly created nullary functions will be evaluated instead. Thus, our method `whileLoop` implements a Java-like while-loop with a recursive implementation scheme. - -We can combine the use of [infix/postfix operators](operators.html) with this mechanism to create more complex statements (with a nice syntax). - -Here is the implementation of a loop-unless statement: - -```scala mdoc:reset -def loop(body: => Unit): LoopUnlessCond = - new LoopUnlessCond(body) -protected class LoopUnlessCond(body: => Unit) { - def unless(cond: => Boolean): Unit = { - body - if (!cond) unless(cond) - } -} -var i = 10 -loop { - println("i = " + i) - i -= 1 -} unless (i == 0) -``` - -The `loop` function just accepts a body of a loop and returns an instance of class `LoopUnlessCond` (which encapsulates this body object). Note that the body didn't get evaluated yet. Class `LoopUnlessCond` has a method `unless` which we can use as a *infix operator*. This way, we achieve a quite natural syntax for our new loop: `loop { < stats > } unless ( < cond > )`. - -Here's the output when `TargetTest2` gets executed: - - i = 10 - i = 9 - i = 8 - i = 7 - i = 6 - i = 5 - i = 4 - i = 3 - i = 2 - i = 1 diff --git a/_tour/by-name-parameters.md b/_tour/by-name-parameters.md index b8318783f4..441aefa597 100644 --- a/_tour/by-name-parameters.md +++ b/_tour/by-name-parameters.md @@ -8,6 +8,7 @@ next-page: annotations previous-page: operators redirect_from: "/tutorials/tour/by-name-parameters.html" +redirect_from: "/tutorials/tour/automatic-closures.html" --- _By-name parameters_ are evaluated every time they are used. They won't be evaluated at all if they are unused. This is similar to replacing the by-name parameters with the passed expressions. They are in contrast to _by-value parameters_. To make a parameter called by-name, simply prepend `=>` to its type. diff --git a/_zh-cn/tour/automatic-closures.md b/_zh-cn/tour/automatic-closures.md deleted file mode 100644 index b51652c94e..0000000000 --- a/_zh-cn/tour/automatic-closures.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -layout: tour -title: Automatic Closures -partof: scala-tour - -language: zh-cn ---- From 0ab41a6001825bf38816dab0dbabd01570792d3c Mon Sep 17 00:00:00 2001 From: shitpoet Date: Sat, 26 Oct 2024 23:53:02 +0400 Subject: [PATCH 2943/3075] Update unified-types.md (#3046) Add phrase: > Note that `Long` to `Float` conversion is deprecated in new versions of Scala, because of the potential precision lost. --- _tour/unified-types.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_tour/unified-types.md b/_tour/unified-types.md index 191dc28c1e..a6f0e9c0dd 100644 --- a/_tour/unified-types.md +++ b/_tour/unified-types.md @@ -57,6 +57,8 @@ true Value types can be cast in the following way:     Scala Type Hierarchy +Note that `Long` to `Float` conversion is deprecated in new versions of Scala, because of the potential precision lost. + For example: {% tabs unified-types-2 %} From 18a1a933ba4a8e5055a7ace99f72973da8ab5a9b Mon Sep 17 00:00:00 2001 From: Sila Setthakan-anan Date: Sun, 27 Oct 2024 02:54:36 +0700 Subject: [PATCH 2944/3075] update translated word for the "print" word (#3026) --- _th/cheatsheets/index.md | 6 +++--- _th/tour/classes.md | 20 ++++++++++---------- _th/tour/traits.md | 4 ++-- 3 files changed, 15 insertions(+), 15 deletions(-) diff --git a/_th/cheatsheets/index.md b/_th/cheatsheets/index.md index 49861d3f0c..b59cf817a3 100644 --- a/_th/cheatsheets/index.md +++ b/_th/cheatsheets/index.md @@ -66,9 +66,9 @@ language: "th" | `for (i <- 1 until 5) {`
    `println(i)`
    `}` | ทำความเข้าใจ for : ทำซ้ำโดยละเว้นขอบเขตบน | | จับคู่รูปแบบ | | | Good
    `(xs zip ys) map { case (x,y) => x*y }`
    Bad
    `(xs zip ys) map( (x,y) => x*y )` | ใช้ case ใน arg ของฟังก์ชันสำหรับ จับคู่รูปแบบ (pattern maching) | -| Bad
    `val v42 = 42`
    `Some(3) match {`
    ` case Some(v42) => println("42")`
    ` case _ => println("Not 42")`
    `}` | "v42" ถูกตีความว่าเป็นชื่อที่ตรงกับค่า Int และพิมพ์ "42" | -| Good
    `val v42 = 42`
    `Some(3) match {`
    `` case Some(`v42`) => println("42")``
    `case _ => println("Not 42")`
    `}` | "v42" กับ backticks ถูกตีความว่าเป็น v42 val ที่มีอยู่และ
    พิมพ์ "Not 42" | -| Good
    `val UppercaseVal = 42`
    `Some(3) match {`
    ` case Some(UppercaseVal) => println("42")`
    ` case _ => println("Not 42")`
    `}` | UppercaseVal ถือว่าเป็น val ที่มีอยู่ไม่ใช่ตัวแปรรูปแบบใหม่
    เพราะมันเริ่มต้นด้วยตัวอักษรตัวพิมพ์ใหญ่ ดังนั้นค่าที่มีอยู่ใน
    UppercaseVal จะถูกตรวจสอบเทียบกับ 3 และพิมพ์ "Not 42" | +| Bad
    `val v42 = 42`
    `Some(3) match {`
    ` case Some(v42) => println("42")`
    ` case _ => println("Not 42")`
    `}` | "v42" ถูกตีความว่าเป็นชื่อที่ตรงกับค่า Int และแสดงค่า "42" | +| Good
    `val v42 = 42`
    `Some(3) match {`
    `` case Some(`v42`) => println("42")``
    `case _ => println("Not 42")`
    `}` | "v42" กับ backticks ถูกตีความว่าเป็น v42 val ที่มีอยู่และ
    แสดงค่า "Not 42" | +| Good
    `val UppercaseVal = 42`
    `Some(3) match {`
    ` case Some(UppercaseVal) => println("42")`
    ` case _ => println("Not 42")`
    `}` | UppercaseVal ถือว่าเป็น val ที่มีอยู่ไม่ใช่ตัวแปรรูปแบบใหม่
    เพราะมันเริ่มต้นด้วยตัวอักษรตัวพิมพ์ใหญ่ ดังนั้นค่าที่มีอยู่ใน
    UppercaseVal จะถูกตรวจสอบเทียบกับ 3 และแสดงค่า "Not 42" | | การใช้งาน object | | | `class C(x: R)` _เหมือนกับ_
    `class C(private val x: R)`
    `var c = new C(4)` | ตัวสร้างพารามิเตอร์ - x มีเฉพาะในคลาส body เท่านั้น | | `class C(val x: R)`
    `var c = new C(4)`
    `c.x` | ตัวสร้างพารามิเตอร์ - กำหนดสมาชิกสาธารณะโดยอัตโนมัติ | diff --git a/_th/tour/classes.md b/_th/tour/classes.md index 7800a5f492..3054dbcc8d 100644 --- a/_th/tour/classes.md +++ b/_th/tour/classes.md @@ -11,7 +11,7 @@ next-page: traits previous-page: unified-types --- -คลาสใน Scala เป็นพิมพ์เขียวสำหรับสร้าง object ในคลาสสามารถมี method, value, ตัวแปร, type, object, +คลาสใน Scala เป็นพิมพ์เขียวสำหรับสร้าง object ในคลาสสามารถมี method, value, ตัวแปร, type, object, trait และคลาส ซึ่งเรียกรวมๆ กันว่า _members_ หรือ _สมาชิก_ ของคลาส type, object และ trait จะกล่าวถึงภายหลัง ## การกำหนดคลาส @@ -22,7 +22,7 @@ class User val user1 = new User ``` -keyword `new` ใช้เพื่อสร้าง instance ของคลาส `User` มี constructor เริ่มต้นซึ่งไม่รับค่า argument เพราะว่าไม่ได้กำหนด constructor ไว้ตอนประกาสคลาส +keyword `new` ใช้เพื่อสร้าง instance ของคลาส `User` มี constructor เริ่มต้นซึ่งไม่รับค่า argument เพราะว่าไม่ได้กำหนด constructor ไว้ตอนประกาสคลาส อย่างไรก็ตาม, เราอาจจะมี constructor และ body ของคลาส ตัวอย่างดังนี้ เป็นการประกาศคลาสสำหรับจุด (point): @@ -41,11 +41,11 @@ class Point(var x: Int, var y: Int) { val point1 = new Point(2, 3) point1.x // 2 -println(point1) // พิมพ์ (2, 3) +println(point1) // แสดงค่า (2, 3) ``` คลาส `Point` นี้มีสมาชิก 4 ตัว คือ ตัวแปร `x` และ `y` และ method `move` และ `toString` -ไม่เหมือนภาษาอื่นๆ, ซึ่ง constructor หลักจะอยู่ใน class signature `(var x: Int, var y: Int)` +ไม่เหมือนภาษาอื่นๆ, ซึ่ง constructor หลักจะอยู่ใน class signature `(var x: Int, var y: Int)` method `move` รับ argument ชนิดตัวเลข 2 ตัว และ return เป็นค่า Unit `()` ซึ่งไม่มีค่า จะมีผลลัพธ์คลายกับ `void` ในภาษาที่เหมือน Java, `toString` ในทางกลับกัน ไม่รับ argument ใดๆ แต่ return เป็นค่า `String` ซึ่งแทนที่ method `toString` จาก [`AnyRef`](unified-types.html) โดยจะมี keyword `override` @@ -58,7 +58,7 @@ class Point(var x: Int = 0, var y: Int = 0) val origin = new Point // x and y are both set to 0 val point1 = new Point(1) -println(point1.x) // พิมพ์ 1 +println(point1.x) // แสดงค่า 1 ``` @@ -68,13 +68,13 @@ println(point1.x) // พิมพ์ 1 ```scala mdoc:nest class Point(var x: Int = 0, var y: Int = 0) val point2 = new Point(y=2) -println(point2.y) // พิมพ์ 2 +println(point2.y) // แสดงค่า 2 ``` นี้เป็นวิธีปฏิบัติที่ดีเพื่อจะทำให้โค้ดชัดเจนมากขึ้น ## Private Members และ Getter/Setter -สมาชิกของคลาสจะเป็น public โดยค่าเริ่มต้น ใช้ access modifier `private` +สมาชิกของคลาสจะเป็น public โดยค่าเริ่มต้น ใช้ access modifier `private` เพื่อซ่อนสมาชิกนั้นจากภายนอกของคลาส ```scala mdoc:reset class Point { @@ -97,10 +97,10 @@ class Point { val point1 = new Point point1.x = 99 -point1.y = 101 // พิมพ์คำเตือน warning +point1.y = 101 // แสดงค่า "WARNING: Out of bounds" ``` -คลาส `Point` เวอร์ชันนี้ ข้อมูลจะถูกเก็บไว้ในตัวแปรชนิด private ที่ชื่อว่า `_x` และ `_y` และมี method ที่ชื่อว่า `def x` และ `def y` ทีจะใช้ในการเข้าถึงข้อมูล private เป็น getter, `def x_=` และ `def y=` -เป็น method สำหรับตรวจสอบข้อมูลและ setting ค่าของตัวแปร `_x` และ `_y` +คลาส `Point` เวอร์ชันนี้ ข้อมูลจะถูกเก็บไว้ในตัวแปรชนิด private ที่ชื่อว่า `_x` และ `_y` และมี method ที่ชื่อว่า `def x` และ `def y` ทีจะใช้ในการเข้าถึงข้อมูล private เป็น getter, `def x_=` และ `def y=` +เป็น method สำหรับตรวจสอบข้อมูลและ setting ค่าของตัวแปร `_x` และ `_y` สังเกตว่า syntax พิเศษนี้สำหรับ setter: คือ method ที่ตามด้วย `_=` ไปยังตัวระบุของ setter และ parameter ตามหลังมา constructor หลักกำหนด parameter ด้วย `val` และ `var` เป็น public อย่างไรก็ตามเพราะว่า `val` เป็นตัวแปรที่เปลี่ยนแปลงไม่ได้ (immutable) เราไม่สามารถเขียบแบบนี้ได้ diff --git a/_th/tour/traits.md b/_th/tour/traits.md index dfc3b31a74..92dc07597c 100644 --- a/_th/tour/traits.md +++ b/_th/tour/traits.md @@ -75,7 +75,7 @@ val cat = new Cat("Sally") val animals = ArrayBuffer.empty[Pet] animals.append(dog) animals.append(cat) -animals.foreach(pet => println(pet.name)) // พิมพ์ Harry Sally +animals.foreach(pet => println(pet.name)) // แสดงค่า Harry Sally ``` -`trait Pet` มี abstract field `name` ซึ่ง implement โดย Cat และ Dog ใน constructor ของมัน +`trait Pet` มี abstract field `name` ซึ่ง implement โดย Cat และ Dog ใน constructor ของมัน ในบรรทัดสุดท้าย เราเรียก `pet.name` ซึ่งจะต้องถูก implement แล้วใน subtype ใดๆ ของ trait `Pet` From 246c742b30c22bfd7da60492a71d4e339664a779 Mon Sep 17 00:00:00 2001 From: Sila Setthakan-anan Date: Sun, 27 Oct 2024 02:59:28 +0700 Subject: [PATCH 2945/3075] Add content for `/th/tour/named-arguments` page (#3027) Co-authored-by: Seth Tisue --- _th/tour/named-arguments.md | 53 +++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/_th/tour/named-arguments.md b/_th/tour/named-arguments.md index 161b53b50e..0257732c5d 100644 --- a/_th/tour/named-arguments.md +++ b/_th/tour/named-arguments.md @@ -10,3 +10,56 @@ language: th next-page: packages-and-imports previous-page: default-parameter-values --- + +เมื่อเราเรียกใช้ method แล้วเราสามารถระบุชื่อ argument (label the argument) สำหรับ parameter ใดๆ ได้ดังนี้: + +{% tabs named-arguments-when-good %} + +{% tab 'Scala 2 and 3' for=named-arguments-when-good %} + +```scala mdoc +def printName(first: String, last: String): Unit = + println(s"$first $last") + +printName("John", "Public") // แสดงค่า "John Public" +printName(first = "John", last = "Public") // แสดงค่า "John Public" +printName(last = "Public", first = "John") // แสดงค่า "John Public" +printName("Elton", last = "John") // แสดงค่า "Elton John" +``` + +{% endtab %} + +{% endtabs %} + +named argument นั้นมีประโยชน์เมื่อ parameter 2 ตัวมี type เดียวกัน\ +ทำให้ argument ที่เราส่งไปให้ function อาจถูกสลับกันโดยไม่ได้ตั้งใจ + +สังเกตว่าเราจะเขียน argument ที่ระบุชื่อในลำดับใดก็ได้\ +แต่ถ้า argument ไม่ได้อยู่ในลำดับของ parameter ใน function จากซ้ายไปขวา แล้ว argument ที่เหลือจะต้องระบุชื่อทั้งหมด + +ในตัวอย่างข้างล่างนี้ named argument ทำให้เราสามารถเว้น parameter `middle` ได้\ +แต่ในกรณีที่เกิด `error: positional after named argument`\ +เนื่องจาก argument ตัวแรกไม่ได้เรียงตามลำดับของ parameter (ตัวแรกไม่ใช่ parameter `first` และ argument ตัวที่ 2 เป็นต้นไปก็ไม่ได้ระบุชื่อด้วย)\ +ดังนั้น เราจะต้องระบุชื่อ argument ตั้งแต่ตัวที่ 2 เป็นต้นไป + +{% tabs named-arguments-when-error %} + +{% tab 'Scala 2 and 3' for=named-arguments-when-error %} + +```scala mdoc:fail +def printFullName(first: String, middle: String = "Q.", last: String): Unit = + println(s"$first $middle $last") + +printFullName(first = "John", last = "Public") // แสดงค่า "John Q. Public" +printFullName("John", last = "Public") // แสดงค่า "John Q. Public" +printFullName("John", middle = "Quincy", "Public") // แสดงค่า "John Quincy Public" +printFullName(last = "Public", first = "John") // แสดงค่า "John Q. Public" +printFullName(last = "Public", "John") // error: positional after named argument +``` + +{% endtab %} + +{% endtabs %} + +เราสามารถใช้ Named Argument กับการเรียกใช้ method ของ Java ได้\ +แต่ทำได้เฉพาะในกรณีที่ Java library นั้นถูกคอมไพล์ด้วยออพชั่น `-parameters` เท่านั้น From b8e1b21074dbb095206c184e367aa45fe3125007 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 26 Oct 2024 12:59:45 -0700 Subject: [PATCH 2946/3075] Bump webrick from 1.8.1 to 1.8.2 (#3077) Bumps [webrick](https://github.com/ruby/webrick) from 1.8.1 to 1.8.2. - [Release notes](https://github.com/ruby/webrick/releases) - [Commits](https://github.com/ruby/webrick/compare/v1.8.1...v1.8.2) --- updated-dependencies: - dependency-name: webrick dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Seth Tisue --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index a08325d034..45a14bc109 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -280,7 +280,7 @@ GEM unf_ext (0.0.9.1-x64-mingw-ucrt) unicode-display_width (1.8.0) uri (0.13.0) - webrick (1.8.1) + webrick (1.8.2) yell (2.2.2) zeitwerk (2.6.7) From 6c8e71100bb80e84572f9a58813392d6bbb53a2d Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Tue, 29 Oct 2024 00:28:29 +0000 Subject: [PATCH 2947/3075] Update SIPs state --- _sips/sips/typeclasses-syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/typeclasses-syntax.md b/_sips/sips/typeclasses-syntax.md index 385bb7dc1f..3fb3b807fd 100644 --- a/_sips/sips/typeclasses-syntax.md +++ b/_sips/sips/typeclasses-syntax.md @@ -13,7 +13,7 @@ title: SIP-64 - Improve Syntax for Context Bounds and Givens | Date | Version | |---------------|--------------------| | March 11, 2024| Initial Draft | -| July 18, 2014 | Revised Draft | +| July 18, 2024 | Revised Draft | ## Summary From 69f64b1cbe75febf99d84f7f88a2074a760b84c8 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Thu, 31 Oct 2024 17:25:56 +0100 Subject: [PATCH 2948/3075] add governance to nav bar --- _data/nav-header.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_data/nav-header.yml b/_data/nav-header.yml index eeaa88291c..792c68fc1e 100644 --- a/_data/nav-header.yml +++ b/_data/nav-header.yml @@ -8,5 +8,7 @@ url: https://index.scala-lang.org - title: Community url: https://www.scala-lang.org/community/ +- title: Governance + url: https://www.scala-lang.org/governance/ - title: Blog url: https://www.scala-lang.org/blog/ From b3ac0a97f03b26c17a7afbf461d3fd16a9a28ad3 Mon Sep 17 00:00:00 2001 From: Jamie Thompson Date: Thu, 31 Oct 2024 17:36:57 +0100 Subject: [PATCH 2949/3075] add governance to footer, sync with scala-lang.org --- _data/footer.yml | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/_data/footer.yml b/_data/footer.yml index 43338e7b74..5e24e08b6d 100644 --- a/_data/footer.yml +++ b/_data/footer.yml @@ -21,13 +21,11 @@ links: - title: Community url: "http://scala-lang.org/community/" - - title: Governance - url: "http://scala-lang.org/community/index.html#governance" - title: Scala Ambassadors url: "http://scala-lang.org/ambassadors/" - - title: Mailing Lists - url: "http://scala-lang.org/community/index.html#mailing-lists" - - title: Chat Rooms & More + - title: Forums + url: "http://scala-lang.org/community/index.html#forums" + - title: Chat url: "http://scala-lang.org/community/index.html#chat-rooms" - title: Libraries and Tools url: "http://scala-lang.org/community/index.html#community-libraries-and-tools" @@ -43,16 +41,26 @@ - title: Scala class: scala links: + - title: Governance + url: "http://scala-lang.org/governance/" - title: Blog url: "http://scala-lang.org/blog/" - title: Code of Conduct url: "http://scala-lang.org/conduct/" - title: License url: "http://scala-lang.org/license/" + - title: Security Policy + url: "http://scala-lang.org/security/" - title: Social class: social links: - title: GitHub url: "https://github.com/scala/scala" + - title: Mastodon + url: https://fosstodon.org/@scala_lang - title: Twitter url: "https://twitter.com/scala_lang" + - title: Discord + url: "https://discord.com/invite/scala" + - title: LinkedIn + url: "https://www.linkedin.com/company/scala-center/" \ No newline at end of file From 821c88175be8e0d9c12c2982c2dc0e782fa30dbf Mon Sep 17 00:00:00 2001 From: Haocheng Zhang <50510911+code2828@users.noreply.github.com> Date: Wed, 6 Nov 2024 21:44:17 +0800 Subject: [PATCH 2950/3075] Rename a Quartet object from triplet to quartet A Quartet object should probably be named quartet accordingly. Might be a typo or copy and paste problem. --- _overviews/scala3-book/scala-for-java-devs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index 37482bdc49..7452e00cd7 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -1064,7 +1064,7 @@ Pair pair = Triplet triplet = Triplet.with("Eleven", 11, 11.0); -Quartet triplet = +Quartet quartet = Quartet.with("Eleven", 11, 11.0, new Person("Eleven")); ``` From 15356bf617c9a46ea8f8ee65e45608eb01191ec8 Mon Sep 17 00:00:00 2001 From: Haocheng Zhang <50510911+code2828@users.noreply.github.com> Date: Wed, 6 Nov 2024 21:51:01 +0800 Subject: [PATCH 2951/3075] Add a missing space after a comma --- _overviews/scala3-book/scala-for-java-devs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index 7452e00cd7..b80f3a427a 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -1064,7 +1064,7 @@ Pair pair = Triplet triplet = Triplet.with("Eleven", 11, 11.0); -Quartet quartet = +Quartet quartet = Quartet.with("Eleven", 11, 11.0, new Person("Eleven")); ``` From ec9081c2b83d433011e47c19860eaed863d65bed Mon Sep 17 00:00:00 2001 From: Cause Chung Date: Thu, 7 Nov 2024 01:33:08 +0800 Subject: [PATCH 2952/3075] Update doc domain-modeling-tools for Java method call (#3081) Add parentheses when calling `LocalDate.now` to get an instance of `LocalDate`. --- _overviews/scala3-book/domain-modeling-tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-book/domain-modeling-tools.md b/_overviews/scala3-book/domain-modeling-tools.md index 9b6901504f..c1475ce161 100644 --- a/_overviews/scala3-book/domain-modeling-tools.md +++ b/_overviews/scala3-book/domain-modeling-tools.md @@ -373,7 +373,7 @@ Those constructors can be called like this: ```scala val s1 = new Student("Mary", "123") -val s2 = new Student("Mary", "123", LocalDate.now) +val s2 = new Student("Mary", "123", LocalDate.now()) val s3 = new Student("Mary", "123", 456) ``` @@ -383,7 +383,7 @@ val s3 = new Student("Mary", "123", 456) ```scala val s1 = Student("Mary", "123") -val s2 = Student("Mary", "123", LocalDate.now) +val s2 = Student("Mary", "123", LocalDate.now()) val s3 = Student("Mary", "123", 456) ``` From 14d9d35ed57c028b3aae16f9ee4c21cf6e2f737a Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 6 Nov 2024 18:35:34 +0100 Subject: [PATCH 2953/3075] GitHub Pages upgrade requires newer Ruby --- .github/workflows/build.yml | 2 +- Dockerfile | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index b800faa5b5..973735cb51 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -8,7 +8,7 @@ jobs: - name: Set up Ruby uses: ruby/setup-ruby@v1 with: - ruby-version: 3.0.5 + ruby-version: 3.1.6 bundler-cache: true - name: Set up coursier uses: coursier/setup-action@v1.3.5 diff --git a/Dockerfile b/Dockerfile index e5ef73f4be..636e38037b 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,4 +1,4 @@ -FROM ruby:3.0.5 +FROM ruby:3.1.6 RUN gem install bundler:2.4.21 From d58155442479527159374135937cff0378f59462 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 7 Nov 2024 09:29:36 +0000 Subject: [PATCH 2954/3075] Bump webrick from 1.8.2 to 1.9.0 Bumps [webrick](https://github.com/ruby/webrick) from 1.8.2 to 1.9.0. - [Release notes](https://github.com/ruby/webrick/releases) - [Commits](https://github.com/ruby/webrick/compare/v1.8.2...v1.9.0) --- updated-dependencies: - dependency-name: webrick dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index d45b49dceb..487b93625e 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -281,7 +281,7 @@ GEM concurrent-ruby (~> 1.0) unicode-display_width (1.8.0) uri (0.13.0) - webrick (1.8.2) + webrick (1.9.0) yell (2.2.2) zeitwerk (2.6.7) From 38bf75fc2e789b3d7072b72081fecebaa7929f2d Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 11 Nov 2024 20:30:31 +0100 Subject: [PATCH 2955/3075] Bump rexml from 3.3.6 to 3.3.9 (#3098) Bumps [rexml](https://github.com/ruby/rexml) from 3.3.6 to 3.3.9. - [Release notes](https://github.com/ruby/rexml/releases) - [Changelog](https://github.com/ruby/rexml/blob/master/NEWS.md) - [Commits](https://github.com/ruby/rexml/compare/v3.3.6...v3.3.9) --- updated-dependencies: - dependency-name: rexml dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- Gemfile.lock | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 487b93625e..55d8b82a72 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -257,8 +257,7 @@ GEM rb-fsevent (0.11.2) rb-inotify (0.11.1) ffi (~> 1.0) - rexml (3.3.6) - strscan + rexml (3.3.9) rouge (3.30.0) rubyzip (2.3.2) safe_yaml (1.0.5) @@ -272,7 +271,6 @@ GEM faraday (>= 0.17.3, < 3) securerandom (0.3.1) simpleidn (0.2.3) - strscan (3.1.0) terminal-table (1.8.0) unicode-display_width (~> 1.1, >= 1.1.1) typhoeus (1.4.1) From fb0ba80784f034882488bad7862836a80a691818 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 11 Nov 2024 20:32:14 +0100 Subject: [PATCH 2956/3075] fix a 404 link in an old SIP (#3102) --- _sips/sips/scala-2-8-arrays.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/scala-2-8-arrays.md b/_sips/sips/scala-2-8-arrays.md index 7f5999d651..f96bb0239c 100644 --- a/_sips/sips/scala-2-8-arrays.md +++ b/_sips/sips/scala-2-8-arrays.md @@ -282,4 +282,4 @@ three language features will be described in more detail in separate notes. 3. David MacIver. Refactoring scala.array. Pre-SIP (Scala Improvement Proposal), October 2008. [1]: https://www.drmaciver.com/2008/06/scala-arrays - [2]: https://oldfashionedsoftware.com/2009/08/05/the-mystery-of-the-parameterized-array + [2]: http://web.archive.org/web/20090817050725/http://oldfashionedsoftware.com/2009/08/05/the-mystery-of-the-parameterized-array/ From 68a41e8458d3a5b49ef63d19f689c99963c4f968 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Tue, 12 Nov 2024 00:27:01 +0000 Subject: [PATCH 2957/3075] Update SIPs state --- _sips/sips/scala-2-8-arrays.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/scala-2-8-arrays.md b/_sips/sips/scala-2-8-arrays.md index f96bb0239c..7f5999d651 100644 --- a/_sips/sips/scala-2-8-arrays.md +++ b/_sips/sips/scala-2-8-arrays.md @@ -282,4 +282,4 @@ three language features will be described in more detail in separate notes. 3. David MacIver. Refactoring scala.array. Pre-SIP (Scala Improvement Proposal), October 2008. [1]: https://www.drmaciver.com/2008/06/scala-arrays - [2]: http://web.archive.org/web/20090817050725/http://oldfashionedsoftware.com/2009/08/05/the-mystery-of-the-parameterized-array/ + [2]: https://oldfashionedsoftware.com/2009/08/05/the-mystery-of-the-parameterized-array From fc1f78d8fad7303cf9cfb0c00399a479ff8fbd17 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 12 Nov 2024 15:13:06 +0100 Subject: [PATCH 2958/3075] FAQ: tweak answer about this.type this came up on Discord. a user only needed to return the same instance, so there was no need to send them down other paths besides `this.type` --- _overviews/FAQ/index.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 7c0b101dd2..e731fbda9c 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -292,14 +292,16 @@ For more details, see the Scala Style Guide, [here](https://docs.scala-lang.org/ ### How can a method in a superclass return a value of the “current” type? -First, note that using `this.type` won't work. People often try that, -but `this.type` means "the singleton type of this instance", a -different and too-specific meaning. Only `this` itself has the -type `this.type`; other instances do not. - -What does work? Possible solutions include F-bounded polymorphism -_(familiar to Java programmers)_, type members, -and the [typeclass pattern](http://tpolecat.github.io/2013/10/12/typeclass.html). +Using `this.type` will only work if you are returning `this` itself. +`this.type` means "the singleton type of this instance". Only `this` +itself has the type `this.type`; other instances of the same class do +not. + +What does work for returning other values of the same type? + +Possible solutions include F-bounded polymorphism _(familiar to Java +programmers)_, type members, and the [typeclass +pattern](http://tpolecat.github.io/2013/10/12/typeclass.html). This [blog post](http://tpolecat.github.io/2015/04/29/f-bounds.html) argues against F-bounds and in favor of typeclasses; From 3d172081f719992da89a0954e4add6a53b9851cf Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 13 Nov 2024 19:51:08 +0100 Subject: [PATCH 2959/3075] JDK compat page: add Scala 3 LTS column (#3083) --- _overviews/jdk-compatibility/overview.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 99b953306f..e843f6f61e 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -12,20 +12,20 @@ Sometimes new JVM and JDK (Java Development Kit) versions require us to update S Minimum Scala versions: -| JDK | 3 | 2.13 | 2.12 | 2.11 | -|:-----------:|:--------:|:---------:|:---------:|:----------:| -| 23 | 3.3.5* | 2.13.15 | 2.12.20 | | -| 22 | 3.3.4* | 2.13.13 | 2.12.19 | | -| 21 (LTS) | 3.3.1 | 2.13.11 | 2.12.18 | | -| 17 (LTS) | 3.0.0 | 2.13.6 | 2.12.15 | | -| 11 (LTS) | 3.0.0 | 2.13.0 | 2.12.4 | 2.11.12 | -| 8 (LTS) | 3.0.0 | 2.13.0 | 2.12.0 | 2.11.0 | +| JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | +|:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| +| 23 | 3.4.0 | 3.3.1 | 2.13.15 | 2.12.20 | | +| 22 | 3.4.0 | 3.3.1 | 2.13.13 | 2.12.19 | | +| 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | +| 17 (LTS) | 3.0.0 | 3.3.0 | 2.13.6 | 2.12.15 | | +| 11 (LTS) | 3.0.0 | 3.3.0 | 2.13.0 | 2.12.4 | 2.11.12 | +| 8 (LTS) | 3.0.0 | 3.3.0 | 2.13.0 | 2.12.0 | 2.11.0 | \* = forthcoming; support available in [nightly builds](https://stackoverflow.com/q/40622878/86485) Even when a version combination isn't listed as supported, most features might still work. -Using latest patch version of Scala is always recommended. +Using the latest patch version of your chosen Scala version line is always recommended. Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platform-subscription) for Scala 2. The linked page includes contact information for inquiring about supported and recommended versions. From dfb5b0471122ff9a9f24bec2b36cdb4c594d065b Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Fri, 15 Nov 2024 16:20:11 +0000 Subject: [PATCH 2960/3075] Update SIPs state --- ...e-for-better-compatibility-with-existing-code-bases.md | 8 ++++++++ _sips/sips/unroll-default-arguments.md | 2 +- 2 files changed, 9 insertions(+), 1 deletion(-) create mode 100644 _sips/sips/improve-strictequality-feature-for-better-compatibility-with-existing-code-bases.md diff --git a/_sips/sips/improve-strictequality-feature-for-better-compatibility-with-existing-code-bases.md b/_sips/sips/improve-strictequality-feature-for-better-compatibility-with-existing-code-bases.md new file mode 100644 index 0000000000..689849a3d6 --- /dev/null +++ b/_sips/sips/improve-strictequality-feature-for-better-compatibility-with-existing-code-bases.md @@ -0,0 +1,8 @@ +--- +title: SIP-67 - Improve strictEquality feature for better compatibility with existing + code bases +status: under-review +pull-request-number: 97 +stage: design + +--- diff --git a/_sips/sips/unroll-default-arguments.md b/_sips/sips/unroll-default-arguments.md index 5af8cddeb5..eb646d3c64 100644 --- a/_sips/sips/unroll-default-arguments.md +++ b/_sips/sips/unroll-default-arguments.md @@ -2,7 +2,7 @@ layout: sip permalink: /sips/:title.html stage: implementation -status: waiting-for-implementation +status: under-review title: SIP-61 - Unroll Default Arguments for Binary Compatibility --- From 6458adbb355a17a25b44484262ce15bec88ec653 Mon Sep 17 00:00:00 2001 From: gkepka Date: Mon, 18 Nov 2024 09:21:05 +0100 Subject: [PATCH 2961/3075] Fix Stack example --- .../concrete-mutable-collection-classes.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_overviews/collections-2.13/concrete-mutable-collection-classes.md b/_overviews/collections-2.13/concrete-mutable-collection-classes.md index 6978cd7486..0de0bb1996 100644 --- a/_overviews/collections-2.13/concrete-mutable-collection-classes.md +++ b/_overviews/collections-2.13/concrete-mutable-collection-classes.md @@ -16,7 +16,7 @@ You've now seen the most commonly used immutable collection classes that Scala p ## Array Buffers -An [ArrayBuffer](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayBuffer.html) buffer holds an array and a size. Most operations on an array buffer have the same speed as for an array, because the operations simply access and modify the underlying array. Additionally, array buffers can have data efficiently added to the end. Appending an item to an array buffer takes amortized constant time. Thus, array buffers are useful for efficiently building up a large collection whenever the new items are always added to the end. +An [ArrayBuffer](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/collection/mutable/ArrayBuffer.html) holds an array and a size. Most operations on an array buffer have the same speed as for an array, because the operations simply access and modify the underlying array. Additionally, array buffers can have data efficiently added to the end. Appending an item to an array buffer takes amortized constant time. Thus, array buffers are useful for efficiently building up a large collection whenever the new items are always added to the end. {% tabs ArrayBuffer_1 %} {% tab 'Scala 2 and 3' for=ArrayBuffer_1 %} @@ -148,11 +148,11 @@ res1: scala.collection.mutable.Stack[Int] = Stack(1) scala> stack.push(2) res0: stack.type = Stack(1, 2) scala> stack -res3: scala.collection.mutable.Stack[Int] = Stack(1, 2) +res3: scala.collection.mutable.Stack[Int] = Stack(2, 1) scala> stack.top res8: Int = 2 scala> stack -res9: scala.collection.mutable.Stack[Int] = Stack(1, 2) +res9: scala.collection.mutable.Stack[Int] = Stack(2, 1) scala> stack.pop res10: Int = 2 scala> stack @@ -170,11 +170,11 @@ res1: scala.collection.mutable.Stack[Int] = Stack(1) scala> stack.push(2) res0: stack.type = Stack(1, 2) scala> stack -res3: scala.collection.mutable.Stack[Int] = Stack(1, 2) +res3: scala.collection.mutable.Stack[Int] = Stack(2, 1) scala> stack.top res8: Int = 2 scala> stack -res9: scala.collection.mutable.Stack[Int] = Stack(1, 2) +res9: scala.collection.mutable.Stack[Int] = Stack(2, 1) scala> stack.pop res10: Int = 2 scala> stack From 21e4567ac5516769a815632bf56657b3dc304285 Mon Sep 17 00:00:00 2001 From: gkepka Date: Mon, 18 Nov 2024 09:25:06 +0100 Subject: [PATCH 2962/3075] Remove outdated mention of Java having no generics --- _overviews/tutorials/scala-for-java-programmers.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index ac31c42dd0..201feb2467 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -1150,11 +1150,7 @@ scope of this document. ## Genericity The last characteristic of Scala we will explore in this tutorial is -genericity. Java programmers should be well aware of the problems -posed by the lack of genericity in their language, a shortcoming which -is addressed in Java 1.5. - -Genericity is the ability to write code parametrized by types. For +genericity. Genericity is the ability to write code parametrized by types. For example, a programmer writing a library for linked lists faces the problem of deciding which type to give to the elements of the list. Since this list is meant to be used in many different contexts, it is From dfec3a3f4a4cb377a08b9cba6045090cc207f77b Mon Sep 17 00:00:00 2001 From: gkepka Date: Mon, 18 Nov 2024 11:08:57 +0100 Subject: [PATCH 2963/3075] Fix broken link --- _es/tour/case-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_es/tour/case-classes.md b/_es/tour/case-classes.md index c47a3b9428..7a4989bde5 100644 --- a/_es/tour/case-classes.md +++ b/_es/tour/case-classes.md @@ -19,7 +19,7 @@ A continuación se muestra un ejemplo para una jerarquía de clases la cual cons case class Fun(arg: String, body: Term) extends Term case class App(f: Term, v: Term) extends Term -Esta jerarquía de clases puede ser usada para representar términos de [cálculo lambda no tipado](https://www.ezresult.com/article/Lambda_calculus). Para facilitar la construcción de instancias de clases Case, Scala no requiere que se utilice la primitiva `new`. Simplemente es posible utilizar el nombre de la clase como una llamada a una función. +Esta jerarquía de clases puede ser usada para representar términos de [cálculo lambda no tipado](https://es.wikipedia.org/wiki/C%C3%A1lculo_lambda). Para facilitar la construcción de instancias de clases Case, Scala no requiere que se utilice la primitiva `new`. Simplemente es posible utilizar el nombre de la clase como una llamada a una función. Aquí un ejemplo: From 5233bd95cb9b8f8f5c608e4a6c6ec21b44385869 Mon Sep 17 00:00:00 2001 From: gkepka Date: Wed, 20 Nov 2024 11:07:57 +0100 Subject: [PATCH 2964/3075] Consistent terminology on type parameters --- _overviews/core/architecture-of-scala-collections.md | 2 +- _overviews/parallel-collections/performance.md | 2 +- _overviews/scala3-book/fun-hofs.md | 2 +- _overviews/scala3-book/fun-write-map-function.md | 8 ++++---- _overviews/scala3-book/methods-most.md | 4 ++-- _overviews/scala3-book/methods-summary.md | 2 +- _overviews/scala3-macros/tutorial/quotes.md | 8 ++++---- 7 files changed, 14 insertions(+), 14 deletions(-) diff --git a/_overviews/core/architecture-of-scala-collections.md b/_overviews/core/architecture-of-scala-collections.md index 1bc7d82915..74f2bd1b98 100644 --- a/_overviews/core/architecture-of-scala-collections.md +++ b/_overviews/core/architecture-of-scala-collections.md @@ -270,7 +270,7 @@ construct another `BitSet` provided the element type of the collection to build is `Int`. If this is not the case, the compiler will check the superclasses, and fall back to the implicit builder factory defined in `mutable.Set`'s companion object. The type of this more general builder -factory, where `A` is a generic type parameter, is: +factory, where `A` is a type parameter, is: CanBuildFrom[Set[_], A, Set[A]] diff --git a/_overviews/parallel-collections/performance.md b/_overviews/parallel-collections/performance.md index 96be271b44..2f7aa27f2f 100644 --- a/_overviews/parallel-collections/performance.md +++ b/_overviews/parallel-collections/performance.md @@ -45,7 +45,7 @@ garbage collections. One common cause of a performance deterioration is also boxing and unboxing that happens implicitly when passing a primitive type as an argument to a generic method. At runtime, primitive types are converted to objects which -represent them, so that they could be passed to a method with a generic type +represent them, so that they could be passed to a method with a type parameter. This induces extra allocations and is slower, also producing additional garbage on the heap. diff --git a/_overviews/scala3-book/fun-hofs.md b/_overviews/scala3-book/fun-hofs.md index 638c761389..513c520a54 100644 --- a/_overviews/scala3-book/fun-hofs.md +++ b/_overviews/scala3-book/fun-hofs.md @@ -61,7 +61,7 @@ p: A => Boolean {% endtabs %} means that whatever function you pass in must take the type `A` as an input parameter and return a `Boolean`. -So if your list is a `List[Int]`, you can replace the generic type `A` with `Int`, and read that signature like this: +So if your list is a `List[Int]`, you can replace the type parameter `A` with `Int`, and read that signature like this: {% tabs filter-definition_2 %} {% tab 'Scala 2 and 3' %} diff --git a/_overviews/scala3-book/fun-write-map-function.md b/_overviews/scala3-book/fun-write-map-function.md index 02ee9abf75..9799c97d52 100644 --- a/_overviews/scala3-book/fun-write-map-function.md +++ b/_overviews/scala3-book/fun-write-map-function.md @@ -18,7 +18,7 @@ Focusing only on a `List[Int]`, you state: > I want to write a `map` method that can be used to apply a function to each element in a `List[Int]` that it’s given, returning the transformed elements as a new list. Given that statement, you start to write the method signature. -First, you know that you want to accept a function as a parameter, and that function should transform an `Int` into some generic type `A`, so you write: +First, you know that you want to accept a function as a parameter, and that function should transform an `Int` into some type `A`, so you write: {% tabs map-accept-func-definition %} {% tab 'Scala 2 and 3' %} @@ -28,7 +28,7 @@ def map(f: (Int) => A) {% endtab %} {% endtabs %} -The syntax for using a generic type requires declaring that type symbol before the parameter list, so you add that: +The syntax for using a type parameter requires declaring it in square brackets `[]` before the parameter list, so you add that: {% tabs map-type-symbol-definition %} {% tab 'Scala 2 and 3' %} @@ -48,7 +48,7 @@ def map[A](f: (Int) => A, xs: List[Int]) {% endtab %} {% endtabs %} -Finally, you also know that `map` returns a transformed `List` that contains elements of the generic type `A`: +Finally, you also know that `map` returns a transformed `List` that contains elements of the type `A`: {% tabs map-with-return-type-definition %} {% tab 'Scala 2 and 3' %} @@ -98,7 +98,7 @@ def map[A](f: (Int) => A, xs: List[Int]): List[A] = ### Make it generic As a bonus, notice that the `for` expression doesn’t do anything that depends on the type inside the `List` being `Int`. -Therefore, you can replace `Int` in the type signature with the generic type parameter `B`: +Therefore, you can replace `Int` in the type signature with the type parameter `B`: {% tabs map-function-full-generic class=tabs-scala-version %} {% tab 'Scala 2' %} diff --git a/_overviews/scala3-book/methods-most.md b/_overviews/scala3-book/methods-most.md index 8af9552e6a..2a282cdf28 100644 --- a/_overviews/scala3-book/methods-most.md +++ b/_overviews/scala3-book/methods-most.md @@ -14,7 +14,7 @@ This section introduces the various aspects of how to define and call methods in Scala methods have many features, including these: -- Generic (type) parameters +- Type parameters - Default parameter values - Multiple parameter groups - Context-provided parameters @@ -690,7 +690,7 @@ There’s even more to know about methods, including how to: - Handle exceptions - Use vararg input parameters - Write methods that have multiple parameter groups (partially-applied functions) -- Create methods that have generic type parameters +- Create methods that have type parameters {% comment %} Jamie: there really needs better linking here - previously it was to the Scala 3 Reference, which doesnt cover any diff --git a/_overviews/scala3-book/methods-summary.md b/_overviews/scala3-book/methods-summary.md index 8d36108654..eafac85889 100644 --- a/_overviews/scala3-book/methods-summary.md +++ b/_overviews/scala3-book/methods-summary.md @@ -18,7 +18,7 @@ There’s even more to know about methods, including how to: - Handle exceptions - Use vararg input parameters - Write methods that have multiple parameter groups (partially-applied functions) -- Create methods that have generic type parameters +- Create methods that have type parameters See the [Reference documentation][reference] for more details on these features. diff --git a/_overviews/scala3-macros/tutorial/quotes.md b/_overviews/scala3-macros/tutorial/quotes.md index be34958958..e5862b3d9b 100644 --- a/_overviews/scala3-macros/tutorial/quotes.md +++ b/_overviews/scala3-macros/tutorial/quotes.md @@ -250,21 +250,21 @@ case ... ### Matching types So far, we assumed that the types within quote patterns would be statically known. -Quote patterns also allow for generic types and existential types, which we will see in this section. +Quote patterns also allow for type parameters, which we will see in this section. -#### Generic types in patterns +#### Type parameters in patterns Consider the function `exprOfOption` that we have already seen: ```scala def exprOfOption[T: Type](x: Expr[Option[T]])(using Quotes): Option[Expr[T]] = x match case '{ Some($x: T) } => Some(x) // x: Expr[T] - // ^^^ type ascription with generic type T + // ^^^ type ascription with type T ... ``` Note that this time we have added the `T` explicitly in the pattern, even though it could be inferred. -By referring to the generic type `T` in the pattern, we are required to have a given `Type[T]` in scope. +By referring to the type parameter `T` in the pattern, we are required to have a given `Type[T]` in scope. This implies that `$x: T` will only match if `x` is of type `Expr[T]`. In this particular case, this condition will always be true. From 2a23fcfb892823f6be2df0e12612568b6e0957d3 Mon Sep 17 00:00:00 2001 From: gkepka Date: Wed, 20 Nov 2024 12:06:04 +0100 Subject: [PATCH 2965/3075] Consistent Scala 3 specific page warnings --- _overviews/scala3-book/methods-main-methods.md | 4 +++- _overviews/scala3-book/types-intersection.md | 3 ++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/_overviews/scala3-book/methods-main-methods.md b/_overviews/scala3-book/methods-main-methods.md index e2a30abfb1..78071efb49 100644 --- a/_overviews/scala3-book/methods-main-methods.md +++ b/_overviews/scala3-book/methods-main-methods.md @@ -6,9 +6,11 @@ languages: [ru, zh-cn] num: 26 previous-page: methods-most next-page: methods-summary +scala3: true +versionSpecific: true --- -
    Writing one line programs Scala 3 Only
    +
    Writing one line programs
    Scala 3 offers a new way to define programs that can be invoked from the command line: Adding a `@main` annotation to a method turns it into entry point of an executable program: diff --git a/_overviews/scala3-book/types-intersection.md b/_overviews/scala3-book/types-intersection.md index 4d3f21aa31..6c7e015ba6 100644 --- a/_overviews/scala3-book/types-intersection.md +++ b/_overviews/scala3-book/types-intersection.md @@ -6,8 +6,9 @@ languages: [ru, zh-cn] num: 51 previous-page: types-generics next-page: types-union +scala3: true +versionSpecific: true --- -Scala 3 only Used on types, the `&` operator creates a so called _intersection type_. The type `A & B` represents values that are **both** of the type `A` and of the type `B` at the same time. From 311bcbd0a731ffc0f289353d6f658da92cc64781 Mon Sep 17 00:00:00 2001 From: gkepka Date: Wed, 20 Nov 2024 12:53:11 +0100 Subject: [PATCH 2966/3075] Remove mention of XML processing in the Tour of Scala --- _tour/tour-of-scala.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/_tour/tour-of-scala.md b/_tour/tour-of-scala.md index 49f0d2b7e2..d5ea08ff15 100644 --- a/_tour/tour-of-scala.md +++ b/_tour/tour-of-scala.md @@ -30,8 +30,6 @@ Scala is a pure object-oriented language in the sense that [every value is an ob ## Scala is functional ## Scala is also a functional language in the sense that [every function is a value](unified-types.html). Scala provides a [lightweight syntax](basics.html#functions) for defining anonymous functions, supports [higher-order functions](higher-order-functions.html), allows functions to be [nested](nested-functions.html), and supports [currying](multiple-parameter-lists.html). Scala's [case classes](case-classes.html) and its built-in support for [pattern matching](pattern-matching.html) provide the functionality of algebraic types, which are used in many functional languages. [Singleton objects](singleton-objects.html) provide a convenient way to group functions that aren't members of a class. -Furthermore, Scala's notion of pattern matching naturally extends to the [processing of XML data](https://github.com/scala/scala-xml/wiki/XML-Processing) with the help of [right-ignoring sequence patterns](regular-expression-patterns.html), by way of general extension via [extractor objects](extractor-objects.html). In this context, [for comprehensions](for-comprehensions.html) are useful for formulating queries. These features make Scala ideal for developing applications like web services. - ## Scala is statically typed ## Scala's expressive type system enforces, at compile-time, that abstractions are used in a safe and coherent manner. In particular, the type system supports: From 4bafe8aa1d828af47ba94c2f9c3e9f5c9a6aec47 Mon Sep 17 00:00:00 2001 From: gkepka Date: Fri, 22 Nov 2024 15:15:12 +0100 Subject: [PATCH 2967/3075] Update Getting Started with Scala in IntelliJ --- .../getting-started-with-scala-in-intellij.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/_overviews/getting-started/intellij-track/getting-started-with-scala-in-intellij.md b/_overviews/getting-started/intellij-track/getting-started-with-scala-in-intellij.md index 1e0f1d685c..8bbd163a00 100644 --- a/_overviews/getting-started/intellij-track/getting-started-with-scala-in-intellij.md +++ b/_overviews/getting-started/intellij-track/getting-started-with-scala-in-intellij.md @@ -13,28 +13,28 @@ In this tutorial, we'll see how to build a minimal Scala project using IntelliJ IDE with the Scala plugin. In this guide, IntelliJ will download Scala for you. ## Installation -1. Make sure you have the Java 8 JDK (also known as 1.8) - * Run `javac -version` on the command line and make sure you see - `javac 1.8.___` - * If you don't have version 1.8 or higher, [install the JDK](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) -1. Next, download and install [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/) +1. Make sure you have the Java 8 JDK (also known as 1.8) or newer: + * run `javac -version` on the command line to check the Java version, + * if you don't have version 1.8 or higher, [install the JDK](https://www.oracle.com/java/technologies/downloads/). +1. Next, download and install [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/). 1. Then, after starting up IntelliJ, you can download and install the Scala plugin by following the instructions on -[how to install IntelliJ plugins](https://www.jetbrains.com/help/idea/installing-updating-and-uninstalling-repository-plugins.html) (search for "Scala" in the plugins menu.) +[how to install IntelliJ plugins](https://www.jetbrains.com/help/idea/managing-plugins.html) (search for "Scala" in the plugins menu.) When we create the project, we'll install the latest version of Scala. Note: If you want to open an existing Scala project, you can click **Open** when you start IntelliJ. ## Creating the Project -1. Open up IntelliJ and click **File** => **New** => **Project** -1. On the left panel, select Scala. On the right panel, select IDEA. -1. Name the project **HelloWorld** +1. Open up IntelliJ and click **File** => **New** => **Project**. +1. Name the project **HelloWorld**. +1. Select **Scala** from the **Language** list. +1. Select **IntelliJ** from the **Build system** list. 1. Assuming this is your first time creating a Scala project with IntelliJ, you'll need to install a Scala SDK. To the right of the Scala SDK field, click the **Create** button. 1. Select the highest version number (e.g. {{ site.scala-version }}) and click **Download**. This might take a few minutes but subsequent projects can use the same SDK. -1. Once the SDK is created, and you're back to the "New Project" window, click **Finish**. +1. Once the SDK is created, and you're back to the "New Project" window, click **Create**. ## Writing code From 183ebbf7e16ce4f024faf168722b4ff0faafa191 Mon Sep 17 00:00:00 2001 From: "Jiahui (Jerry) Tan" <66892505+Friendseeker@users.noreply.github.com> Date: Sat, 23 Nov 2024 18:47:19 -0800 Subject: [PATCH 2968/3075] Add documentation for Pattern Matching on String --- _tour/pattern-matching.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index a89c16775f..b33ea88b54 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -138,6 +138,36 @@ println(showNotification(someVoiceRecording)) // prints You received a Voice Re The function `showNotification` takes as a parameter the abstract type `Notification` and matches on the type of `Notification` (i.e. it figures out whether it's an `Email`, `SMS`, or `VoiceRecording`). In the `case Email(sender, title, _)` the fields `sender` and `title` are used in the return value but the `body` field is ignored with `_`. +## Matching on String + +The `s`-interpolator allows embedding variables in strings and is also useful for pattern matching. + +{% tabs s-interpolator-pattern-matching class=tabs-scala-version %} +{% tab 'Scala 2' for=s-interpolator-pattern-matching %} +```scala +val input: String = "Alice is 25 years old" + +input match { + case s"$name is $age years old" => s"$name's age is $age" + case _ => "No match" +} +// Result: "Alice's age is 25" +``` +{% endtab %} +{% tab 'Scala 3' for=s-interpolator-pattern-matching %} +```scala +val input: String = "Alice is 25 years old" + +input match + case s"$name is $age years old" => s"$name's age is $age" + case _ => "No match" +// Result: "Alice's age is 25" +``` +{% endtab %} +{% endtabs %} + +In this example, name and age extract parts of the string based on the pattern. This is helpful for parsing structured text. + ## Pattern guards Pattern guards are boolean expressions which are used to make cases more specific. Just add `if ` after the pattern. From 484ff424d8ca52626da3ff11a33da5ce4b6efd58 Mon Sep 17 00:00:00 2001 From: "Jiahui (Jerry) Tan" <66892505+Friendseeker@users.noreply.github.com> Date: Sat, 23 Nov 2024 18:55:51 -0800 Subject: [PATCH 2969/3075] Change String -> string as other h2 headings use lower case --- _tour/pattern-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index b33ea88b54..51108b99e2 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -138,7 +138,7 @@ println(showNotification(someVoiceRecording)) // prints You received a Voice Re The function `showNotification` takes as a parameter the abstract type `Notification` and matches on the type of `Notification` (i.e. it figures out whether it's an `Email`, `SMS`, or `VoiceRecording`). In the `case Email(sender, title, _)` the fields `sender` and `title` are used in the return value but the `body` field is ignored with `_`. -## Matching on String +## Matching on string The `s`-interpolator allows embedding variables in strings and is also useful for pattern matching. From e4bbc9b776db084e780f6e035434919511dbf88a Mon Sep 17 00:00:00 2001 From: "Jiahui (Jerry) Tan" <66892505+Friendseeker@users.noreply.github.com> Date: Sat, 23 Nov 2024 20:18:02 -0800 Subject: [PATCH 2970/3075] Add note on extractor object --- _tour/pattern-matching.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index 51108b99e2..d104ed356f 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -168,6 +168,39 @@ input match In this example, name and age extract parts of the string based on the pattern. This is helpful for parsing structured text. +We can also use extractor objects for string pattern matching. + +{% tabs s-interpolator-pattern-matching-2 class=tabs-scala-version %} +{% tab 'Scala 2' for=s-interpolator-pattern-matching-2 %} +```scala +object Int { + def unapply(s: String): Option[Int] = s.toIntOption +} + +val input: String = "Alice is 25 years old" + +val (name, age) = input match { + case s"$name is ${Int(age)} years old" => (name, age) +} +// name: String = Alice +// age: Int = 25 +``` +{% endtab %} +{% tab 'Scala 3' for=s-interpolator-pattern-matching-2 %} +```scala +object Int: + def unapply(s: String): Option[Int] = s.toIntOption + +val input: String = "Alice is 25 years old" + +val (name, age) = input match + case s"$name is ${Int(age)} years old" => (name, age) +// name: String = Alice +// age: Int = 25 +``` +{% endtab %} +{% endtabs %} + ## Pattern guards Pattern guards are boolean expressions which are used to make cases more specific. Just add `if ` after the pattern. From 36c67cacf2cc118b2f542bb7a1ed457b69d534b1 Mon Sep 17 00:00:00 2001 From: "Jiahui (Jerry) Tan" <66892505+Friendseeker@users.noreply.github.com> Date: Sun, 24 Nov 2024 06:41:05 -0800 Subject: [PATCH 2971/3075] Fix CI via removing dead links (#3119) --- _overviews/contributors/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/contributors/index.md b/_overviews/contributors/index.md index 757f8b92da..c482c6f8dc 100644 --- a/_overviews/contributors/index.md +++ b/_overviews/contributors/index.md @@ -386,7 +386,7 @@ an sbt-site to GitHub Pages. ### Create the Documentation Site -In this example we choose to use [Paradox](https://developer.lightbend.com/docs/paradox/current/index.html) +In this example we choose to use [Paradox](https://github.com/lightbend/paradox) because it runs on the JVM and thus doesn't require setting up another VM on your system (in contrast with most other documentation generators, which are based on Ruby, Node.js or Python). @@ -403,7 +403,7 @@ enablePlugins(ParadoxSitePlugin, SitePreviewPlugin) Paradox / sourceDirectory := sourceDirectory.value / "documentation" {% endhighlight %} -The `ParadoxSitePlugin` provides a task `makeSite` that generates a website using [Paradox](https://developer.lightbend.com/docs/paradox/current/), and the `SitePreviewPlugin` provides handy tasks when working on the website content, to preview the result in your browser. +The `ParadoxSitePlugin` provides a task `makeSite` that generates a website using [Paradox](https://github.com/lightbend/paradox), and the `SitePreviewPlugin` provides handy tasks when working on the website content, to preview the result in your browser. The second line is optional, it defines the location of the website source files. In our case, in `src/documentation`. From 6b3d1f278cda68e799d5312f0328efacdd89caa3 Mon Sep 17 00:00:00 2001 From: "Jiahui (Jerry) Tan" <66892505+Friendseeker@users.noreply.github.com> Date: Mon, 25 Nov 2024 00:55:24 -0800 Subject: [PATCH 2972/3075] Adopt feedback from adpi2 --- _tour/pattern-matching.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index d104ed356f..e2a3929010 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -173,14 +173,14 @@ We can also use extractor objects for string pattern matching. {% tabs s-interpolator-pattern-matching-2 class=tabs-scala-version %} {% tab 'Scala 2' for=s-interpolator-pattern-matching-2 %} ```scala -object Int { +object Age { def unapply(s: String): Option[Int] = s.toIntOption } val input: String = "Alice is 25 years old" val (name, age) = input match { - case s"$name is ${Int(age)} years old" => (name, age) + case s"$name is ${Age(age)} years old" => (name, age) } // name: String = Alice // age: Int = 25 @@ -188,13 +188,13 @@ val (name, age) = input match { {% endtab %} {% tab 'Scala 3' for=s-interpolator-pattern-matching-2 %} ```scala -object Int: +object Age: def unapply(s: String): Option[Int] = s.toIntOption val input: String = "Alice is 25 years old" val (name, age) = input match - case s"$name is ${Int(age)} years old" => (name, age) + case s"$name is ${Age(age)} years old" => (name, age) // name: String = Alice // age: Int = 25 ``` From 727e3ba0ff903fb5c57d775ca7c9b6bca8f8a679 Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Tue, 26 Nov 2024 09:38:13 +0100 Subject: [PATCH 2973/3075] Re-order navbar links "Scala 3" is too vague and confusing. To learn Scala 3, one should click on "Learn" instead of "Scala 3". To learn the differences between Scala 2 and Scala 3, one should click on "Scala 3". To make things clearer: - Moved "Learn" before "Scala 3" - Renamed "Scala 3" to "Scala 3 Migration" --- _data/doc-nav-header.yml | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index 4f2bbd82cf..704fa69df6 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -5,17 +5,6 @@ url: "/getting-started/install-scala.html" - title: Scala IDEs url: "/getting-started/scala-ides.html" -- title: Scala 3 - url: "#" - submenu: - - title: What's New? - url: "/scala3/new-in-scala3.html" - - title: Migrating From Scala 2 - url: "/scala3/guides/migration/compatibility-intro.html" - - title: New Features for Scaladoc - url: "/scala3/scaladoc.html" - - title: Videos and Talks - url: "/scala3/talks.html" - title: Learn url: "#" submenu: @@ -29,6 +18,17 @@ url: "/online-courses.html" - title: Online Resources url: "/learn.html" +- title: Scala 3 Migration + url: "#" + submenu: + - title: What's New? + url: "/scala3/new-in-scala3.html" + - title: Migrating From Scala 2 + url: "/scala3/guides/migration/compatibility-intro.html" + - title: New Features for Scaladoc + url: "/scala3/scaladoc.html" + - title: Videos and Talks + url: "/scala3/talks.html" - title: Tutorials url: "#" submenu: From 19936feeb5cc12d12179a9dc7b5f3e020aae34ec Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 3 Dec 2024 05:46:06 +0000 Subject: [PATCH 2974/3075] Bump webrick from 1.9.0 to 1.9.1 Bumps [webrick](https://github.com/ruby/webrick) from 1.9.0 to 1.9.1. - [Release notes](https://github.com/ruby/webrick/releases) - [Commits](https://github.com/ruby/webrick/compare/v1.9.0...v1.9.1) --- updated-dependencies: - dependency-name: webrick dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 55d8b82a72..4f956e6336 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -279,7 +279,7 @@ GEM concurrent-ruby (~> 1.0) unicode-display_width (1.8.0) uri (0.13.0) - webrick (1.9.0) + webrick (1.9.1) yell (2.2.2) zeitwerk (2.6.7) From 077140ab43c3d621dd41301f722e777a5d47c571 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Sat, 7 Dec 2024 14:20:11 -0800 Subject: [PATCH 2975/3075] modernize using syntax, bump versions --- _includes/_markdown/install-cask.md | 4 ++-- _includes/_markdown/install-munit.md | 10 +++++----- _includes/_markdown/install-os-lib.md | 4 ++-- _includes/_markdown/install-sttp.md | 4 ++-- _includes/_markdown/install-upickle.md | 4 ++-- _overviews/FAQ/index.md | 4 ++-- _overviews/contribute/bug-reporting-guide.md | 2 +- _overviews/toolkit/web-server-dynamic.md | 4 ++-- _sips/sips/scala-cli.md | 6 +++--- 9 files changed, 21 insertions(+), 21 deletions(-) diff --git a/_includes/_markdown/install-cask.md b/_includes/_markdown/install-cask.md index afb2754321..0424ce4ae6 100644 --- a/_includes/_markdown/install-cask.md +++ b/_includes/_markdown/install-cask.md @@ -5,7 +5,7 @@ {% tab 'Scala CLI' %} You can declare a dependency on Cask with the following `using` directive: ```scala -//> using dep "com.lihaoyi::cask::0.9.2" +//> using dep com.lihaoyi::cask::0.9.2 ``` {% endtab %} @@ -25,7 +25,7 @@ lazy val example = project.in(file("example")) In your `build.sc`, you can add a dependency on Cask: ```scala object example extends RootModule with ScalaModule { - def scalaVersion = "3.3.3" + def scalaVersion = "3.3.4" def ivyDeps = Agg( ivy"com.lihaoyi::cask::0.9.2" ) diff --git a/_includes/_markdown/install-munit.md b/_includes/_markdown/install-munit.md index 853d18e230..e1ebf130c9 100644 --- a/_includes/_markdown/install-munit.md +++ b/_includes/_markdown/install-munit.md @@ -10,7 +10,7 @@ MUnit, being a testing framework, is only available in test files: files in a `t Alternatively, you can require just a specific version of MUnit: ```scala -//> using dep org.scalameta::munit:1.0.0-M7 +//> using dep org.scalameta::munit:1.0.3 ``` {% endtab %} {% tab 'sbt' %} @@ -18,7 +18,7 @@ In your build.sbt file, you can add the dependency on toolkit-test: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.3.3", + scalaVersion := "3.3.4", libraryDependencies += "org.scala-lang" %% "toolkit-test" % "0.1.7" % Test ) ``` @@ -27,14 +27,14 @@ Here the `Test` configuration means that the dependency is only used by the sour Alternatively, you can require just a specific version of MUnit: ```scala -libraryDependencies += "org.scalameta" %% "munit" % "1.0.0-M7" % Test +libraryDependencies += "org.scalameta" %% "munit" % "1.0.3" % Test ``` {% endtab %} {% tab 'Mill' %} In your build.sc file, you can add a `test` object extending `Tests` and `TestModule.Munit`: ```scala object example extends ScalaModule { - def scalaVersion = "3.3.3" + def scalaVersion = "3.3.4" object test extends Tests with TestModule.Munit { def ivyDeps = Agg( @@ -46,7 +46,7 @@ object example extends ScalaModule { Alternatively, you can require just a specific version of MUnit: ```scala -ivy"org.scalameta::munit:1.0.0-M7" +ivy"org.scalameta::munit:1.0.3" ``` {% endtab %} {% endtabs %} diff --git a/_includes/_markdown/install-os-lib.md b/_includes/_markdown/install-os-lib.md index c35388e0a3..b62c5ce102 100644 --- a/_includes/_markdown/install-os-lib.md +++ b/_includes/_markdown/install-os-lib.md @@ -17,7 +17,7 @@ In your `build.sbt`, you can add a dependency on the toolkit: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.3.3", + scalaVersion := "3.3.4", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" ) ``` @@ -30,7 +30,7 @@ libraryDependencies += "com.lihaoyi" %% "os-lib" % "0.9.1" In your `build.sc` file, you can add a dependency on the Toolkit: ```scala object example extends ScalaModule { - def scalaVersion = "3.3.3" + def scalaVersion = "3.3.4" def ivyDeps = Agg( ivy"org.scala-lang::toolkit:0.1.7" diff --git a/_includes/_markdown/install-sttp.md b/_includes/_markdown/install-sttp.md index 43ad70f7d9..d23cf1c09a 100644 --- a/_includes/_markdown/install-sttp.md +++ b/_includes/_markdown/install-sttp.md @@ -17,7 +17,7 @@ In your build.sbt file, you can add a dependency on the Toolkit: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.3.3", + scalaVersion := "3.3.4", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" ) ``` @@ -31,7 +31,7 @@ libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-M6" In your build.sc file, you can add a dependency on the Toolkit: ```scala object example extends ScalaModule { - def scalaVersion = "3.3.3" + def scalaVersion = "3.3.4" def ivyDeps = Agg( ivy"org.scala-lang::toolkit:0.1.7" diff --git a/_includes/_markdown/install-upickle.md b/_includes/_markdown/install-upickle.md index 58f3e23c9c..5ae9fb9024 100644 --- a/_includes/_markdown/install-upickle.md +++ b/_includes/_markdown/install-upickle.md @@ -17,7 +17,7 @@ In your build.sbt file, you can add the dependency on the Toolkit: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.3.3", + scalaVersion := "3.3.4", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" ) ``` @@ -30,7 +30,7 @@ libraryDependencies += "com.lihaoyi" %% "upickle" % "3.1.0" In your build.sc file, you can add the dependency to the upickle library: ```scala object example extends ScalaModule { - def scalaVersion = "3.3.3" + def scalaVersion = "3.3.4" def ivyDeps = Agg( ivy"org.scala-lang::toolkit:0.1.7" diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index e731fbda9c..d800d3dd82 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -124,11 +124,11 @@ with only minor supplements. That's why `versionString` and `versionNumberString` report that Scala 2 is in use: ``` -Welcome to Scala 3.3.3 (17.0.3, Java OpenJDK 64-Bit Server VM). +Welcome to Scala 3.3.4 (17.0.3, Java OpenJDK 64-Bit Server VM). Type in expressions for evaluation. Or try :help. scala> util.Properties.versionNumberString -val res0: String = 2.13.12 +val res0: String = 2.13.15 ``` Note that even the latest Scala 3 version might not use the very diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index d168797a2d..2f50958675 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -65,7 +65,7 @@ If you cannot find your issue in the issue tracker, create a new bug. The detail Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - 1. **Exact Scala version** that you are using. For example, `2.13.15` or `3.3.3`. If the bug happens in multiple versions indicate all of them. + 1. **Exact Scala version** that you are using. For example, `2.13.15` or `3.3.4`. If the bug happens in multiple versions indicate all of them. 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? diff --git a/_overviews/toolkit/web-server-dynamic.md b/_overviews/toolkit/web-server-dynamic.md index 49101505c7..c7bc84ac97 100644 --- a/_overviews/toolkit/web-server-dynamic.md +++ b/_overviews/toolkit/web-server-dynamic.md @@ -151,7 +151,7 @@ Import the Scalatags library: {% tab 'Scala CLI' %} Add the Scalatags dependency in `Example.sc` file: ```scala -//> using dep "com.lihaoyi::scalatags::0.13.1" +//> using dep com.lihaoyi::scalatags::0.13.1 ``` {% endtab %} {% tab 'sbt' %} @@ -234,4 +234,4 @@ object Example extends cask.MainRoutes: {% endtabs %} Here we get the text of the response and wrap it in a Scalatags template. Notice that the return type changed from `String` -to `doctype`. \ No newline at end of file +to `doctype`. diff --git a/_sips/sips/scala-cli.md b/_sips/sips/scala-cli.md index f979104084..9732fbbcf6 100644 --- a/_sips/sips/scala-cli.md +++ b/_sips/sips/scala-cli.md @@ -79,9 +79,9 @@ Currently, when reporting a bug in the compiler (or any other Scala-related) rep "Using directives", provided by Scala CLI give the ability to include the whole configuration in single file, for example: ```scala -//> using platform "native" -//> using "com.lihaoyi::os-lib:0.7.8" -//> using options "-Xfatal-warnings" +//> using platform native +//> using dep com.lihaoyi::os-lib:0.7.8 +//> using options -Xfatal-warnings def foo = println("") ``` From d13948f296561d422ffb4515f2667824a2431196 Mon Sep 17 00:00:00 2001 From: gkepka Date: Mon, 9 Dec 2024 12:45:01 +0100 Subject: [PATCH 2976/3075] Scala 2 Book migration - Prelude and Preliminaries --- _overviews/scala3-book/introduction.md | 6 ++--- _overviews/scala3-book/taste-intro.md | 36 ++++++++++++++++++++++++++ 2 files changed, 39 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/introduction.md b/_overviews/scala3-book/introduction.md index c1dd65583c..b3798aeabb 100644 --- a/_overviews/scala3-book/introduction.md +++ b/_overviews/scala3-book/introduction.md @@ -25,9 +25,9 @@ Scala’s syntax, grammar, and features have been re-thought, debated in an open The book begins with a whirlwind tour of many of Scala’s features in the [“A Taste of Scala” section][taste]. After that tour, the sections that follow it provide more details on those language features. -{% comment %} -We should have a link structure on the whole tour here -{% endcomment %} +## A bit of background + +Scala was created by [Martin Odersky](https://en.wikipedia.org/wiki/Martin_Odersky), who studied under [Niklaus Wirth](https://en.wikipedia.org/wiki/Niklaus_Wirth), who created Pascal and several other languages. Mr. Odersky is one of the co-designers of Generic Java, and is also known as the “father” of the `javac` compiler. [reference]: {{ site.scala3ref }}/overview.html [taste]: {% link _overviews/scala3-book/taste-intro.md %} diff --git a/_overviews/scala3-book/taste-intro.md b/_overviews/scala3-book/taste-intro.md index 72f74faeed..9d93b317cf 100644 --- a/_overviews/scala3-book/taste-intro.md +++ b/_overviews/scala3-book/taste-intro.md @@ -21,6 +21,42 @@ can be installed by following our [getting started guide][get-started]. > Alternatively you can run the examples in a web browser with [Scastie](https://scastie.scala-lang.org), a > fully online editor and code-runner for Scala. +## Comments + +One good thing to know up front is that comments in Scala are just like comments in Java (and many other languages): + +{% tabs comments %} +{% tab 'Scala 2 and 3' for=comments %} +```scala +// a single line comment + +/* + * a multiline comment + */ + +/** + * also a multiline comment + */ +``` +{% endtab %} +{% endtabs %} + +## IDEs + +The two main IDEs (integrated development environments) for Scala are: + +- [IntelliJ IDEA](/getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.html) +- [Visual Studio Code](https://scalameta.org/metals/docs/editors/vscode/) + +## Naming conventions + +Another good thing to know is that Scala naming conventions follow the same “camel case” style as Java: + +- Class names: `Person`, `StoreEmployee` +- Variable names: `name`, `firstName` +- Method names: `convertToInt`, `toUpper` + +More on conventions used while writing Scala code can be found in the [Style Guide](/style/index.html). [reference]: {{ site.scala3ref }}/overview.html [get-started]: {% link _overviews/getting-started/install-scala.md %} From 3d80ecd72146d3d8e91ba47d99abb2514ecfe843 Mon Sep 17 00:00:00 2001 From: gkepka Date: Tue, 10 Dec 2024 13:49:39 +0100 Subject: [PATCH 2977/3075] Scala 2 Book migration - Control Structures --- _overviews/scala3-book/ca-context-bounds.md | 2 +- .../scala3-book/ca-context-parameters.md | 2 +- .../ca-contextual-abstractions-intro.md | 2 +- .../scala3-book/ca-extension-methods.md | 2 +- _overviews/scala3-book/ca-given-imports.md | 2 +- .../scala3-book/ca-implicit-conversions.md | 2 +- .../scala3-book/ca-multiversal-equality.md | 2 +- _overviews/scala3-book/ca-summary.md | 2 +- _overviews/scala3-book/ca-type-classes.md | 2 +- _overviews/scala3-book/collections-classes.md | 2 +- _overviews/scala3-book/collections-intro.md | 2 +- _overviews/scala3-book/collections-methods.md | 2 +- _overviews/scala3-book/collections-summary.md | 2 +- _overviews/scala3-book/concurrency.md | 2 +- _overviews/scala3-book/control-structures.md | 59 +++++++++++-- _overviews/scala3-book/fun-eta-expansion.md | 2 +- .../scala3-book/fun-function-variables.md | 2 +- _overviews/scala3-book/fun-hofs.md | 2 +- _overviews/scala3-book/fun-intro.md | 2 +- .../scala3-book/fun-partial-functions.md | 82 +++++++++++++++++++ _overviews/scala3-book/fun-summary.md | 2 +- .../scala3-book/fun-write-map-function.md | 2 +- .../fun-write-method-returns-function.md | 2 +- .../scala3-book/interacting-with-java.md | 2 +- _overviews/scala3-book/packaging-imports.md | 2 +- _overviews/scala3-book/scala-for-java-devs.md | 2 +- .../scala3-book/scala-for-javascript-devs.md | 2 +- .../scala3-book/scala-for-python-devs.md | 2 +- _overviews/scala3-book/scala-tools.md | 2 +- _overviews/scala3-book/tools-sbt.md | 2 +- _overviews/scala3-book/tools-worksheets.md | 2 +- _overviews/scala3-book/types-adts-gadts.md | 2 +- .../scala3-book/types-dependent-function.md | 2 +- _overviews/scala3-book/types-generics.md | 2 +- _overviews/scala3-book/types-inferred.md | 2 +- _overviews/scala3-book/types-intersection.md | 2 +- _overviews/scala3-book/types-introduction.md | 2 +- _overviews/scala3-book/types-opaque-types.md | 2 +- _overviews/scala3-book/types-others.md | 2 +- _overviews/scala3-book/types-structural.md | 2 +- _overviews/scala3-book/types-union.md | 2 +- _overviews/scala3-book/types-variance.md | 2 +- _overviews/scala3-book/where-next.md | 2 +- 43 files changed, 174 insertions(+), 49 deletions(-) create mode 100644 _overviews/scala3-book/fun-partial-functions.md diff --git a/_overviews/scala3-book/ca-context-bounds.md b/_overviews/scala3-book/ca-context-bounds.md index 2d36d7b3cc..d4346ed94c 100644 --- a/_overviews/scala3-book/ca-context-bounds.md +++ b/_overviews/scala3-book/ca-context-bounds.md @@ -3,7 +3,7 @@ title: Context Bounds type: section description: This page demonstrates Context Bounds in Scala. languages: [ru, zh-cn] -num: 62 +num: 63 previous-page: ca-context-parameters next-page: ca-given-imports --- diff --git a/_overviews/scala3-book/ca-context-parameters.md b/_overviews/scala3-book/ca-context-parameters.md index d91a3c0cc3..d0ea350416 100644 --- a/_overviews/scala3-book/ca-context-parameters.md +++ b/_overviews/scala3-book/ca-context-parameters.md @@ -3,7 +3,7 @@ title: Context Parameters type: section description: This page demonstrates how to declare context parameters, and how the compiler infers them at call-site. languages: [ru, zh-cn] -num: 61 +num: 62 previous-page: ca-extension-methods next-page: ca-context-bounds redirect_from: /scala3/book/ca-given-using-clauses.html diff --git a/_overviews/scala3-book/ca-contextual-abstractions-intro.md b/_overviews/scala3-book/ca-contextual-abstractions-intro.md index c6ec74ec17..8f7f5f79af 100644 --- a/_overviews/scala3-book/ca-contextual-abstractions-intro.md +++ b/_overviews/scala3-book/ca-contextual-abstractions-intro.md @@ -3,7 +3,7 @@ title: Contextual Abstractions type: chapter description: This chapter provides an introduction to the Scala 3 concept of Contextual Abstractions. languages: [ru, zh-cn] -num: 59 +num: 60 previous-page: types-others next-page: ca-extension-methods --- diff --git a/_overviews/scala3-book/ca-extension-methods.md b/_overviews/scala3-book/ca-extension-methods.md index 9f54297f94..49f07b45be 100644 --- a/_overviews/scala3-book/ca-extension-methods.md +++ b/_overviews/scala3-book/ca-extension-methods.md @@ -3,7 +3,7 @@ title: Extension Methods type: section description: This page demonstrates how Extension Methods work in Scala 3. languages: [ru, zh-cn] -num: 60 +num: 61 previous-page: ca-contextual-abstractions-intro next-page: ca-context-parameters scala3: true diff --git a/_overviews/scala3-book/ca-given-imports.md b/_overviews/scala3-book/ca-given-imports.md index 97ddde3374..bc7c0754f4 100644 --- a/_overviews/scala3-book/ca-given-imports.md +++ b/_overviews/scala3-book/ca-given-imports.md @@ -3,7 +3,7 @@ title: Given Imports type: section description: This page demonstrates how 'given' import statements work in Scala 3. languages: [ru, zh-cn] -num: 63 +num: 64 previous-page: ca-context-bounds next-page: ca-type-classes scala3: true diff --git a/_overviews/scala3-book/ca-implicit-conversions.md b/_overviews/scala3-book/ca-implicit-conversions.md index 0fb665eda3..2c2884aa56 100644 --- a/_overviews/scala3-book/ca-implicit-conversions.md +++ b/_overviews/scala3-book/ca-implicit-conversions.md @@ -3,7 +3,7 @@ title: Implicit Conversions type: section description: This page demonstrates how to implement Implicit Conversions in Scala. languages: [ru, zh-cn] -num: 66 +num: 67 previous-page: ca-multiversal-equality next-page: ca-summary --- diff --git a/_overviews/scala3-book/ca-multiversal-equality.md b/_overviews/scala3-book/ca-multiversal-equality.md index 062f23976f..dfc6b4cdb0 100644 --- a/_overviews/scala3-book/ca-multiversal-equality.md +++ b/_overviews/scala3-book/ca-multiversal-equality.md @@ -3,7 +3,7 @@ title: Multiversal Equality type: section description: This page demonstrates how to implement Multiversal Equality in Scala 3. languages: [ru, zh-cn] -num: 65 +num: 66 previous-page: ca-type-classes next-page: ca-implicit-conversions scala3: true diff --git a/_overviews/scala3-book/ca-summary.md b/_overviews/scala3-book/ca-summary.md index f17ffc035a..bdd8c58537 100644 --- a/_overviews/scala3-book/ca-summary.md +++ b/_overviews/scala3-book/ca-summary.md @@ -3,7 +3,7 @@ title: Summary type: section description: This page provides a summary of the Contextual Abstractions lessons. languages: [ru, zh-cn] -num: 67 +num: 68 previous-page: ca-implicit-conversions next-page: concurrency --- diff --git a/_overviews/scala3-book/ca-type-classes.md b/_overviews/scala3-book/ca-type-classes.md index 71af01513b..2a56a5de47 100644 --- a/_overviews/scala3-book/ca-type-classes.md +++ b/_overviews/scala3-book/ca-type-classes.md @@ -3,7 +3,7 @@ title: Type Classes type: section description: This page demonstrates how to create and use type classes. languages: [ru, zh-cn] -num: 64 +num: 65 previous-page: ca-given-imports next-page: ca-multiversal-equality redirect_from: /scala3/book/types-type-classes.html diff --git a/_overviews/scala3-book/collections-classes.md b/_overviews/scala3-book/collections-classes.md index 8a91c05076..acf3a7ff87 100644 --- a/_overviews/scala3-book/collections-classes.md +++ b/_overviews/scala3-book/collections-classes.md @@ -3,7 +3,7 @@ title: Collections Types type: section description: This page introduces the common Scala 3 collections types and some of their methods. languages: [ru, zh-cn] -num: 38 +num: 39 previous-page: collections-intro next-page: collections-methods --- diff --git a/_overviews/scala3-book/collections-intro.md b/_overviews/scala3-book/collections-intro.md index 9d99900c07..e953b95302 100644 --- a/_overviews/scala3-book/collections-intro.md +++ b/_overviews/scala3-book/collections-intro.md @@ -3,7 +3,7 @@ title: Scala Collections type: chapter description: This page provides and introduction to the common collections classes and their methods in Scala 3. languages: [ru, zh-cn] -num: 37 +num: 38 previous-page: packaging-imports next-page: collections-classes --- diff --git a/_overviews/scala3-book/collections-methods.md b/_overviews/scala3-book/collections-methods.md index c805aac639..6a56814b5c 100644 --- a/_overviews/scala3-book/collections-methods.md +++ b/_overviews/scala3-book/collections-methods.md @@ -3,7 +3,7 @@ title: Collections Methods type: section description: This page demonstrates the common methods on the Scala 3 collections classes. languages: [ru, zh-cn] -num: 39 +num: 40 previous-page: collections-classes next-page: collections-summary --- diff --git a/_overviews/scala3-book/collections-summary.md b/_overviews/scala3-book/collections-summary.md index 0112990df4..4a7aa1c385 100644 --- a/_overviews/scala3-book/collections-summary.md +++ b/_overviews/scala3-book/collections-summary.md @@ -3,7 +3,7 @@ title: Summary type: section description: This page provides a summary of the Collections chapter. languages: [ru, zh-cn] -num: 40 +num: 41 previous-page: collections-methods next-page: fp-intro --- diff --git a/_overviews/scala3-book/concurrency.md b/_overviews/scala3-book/concurrency.md index ef89e0a822..4364239bd8 100644 --- a/_overviews/scala3-book/concurrency.md +++ b/_overviews/scala3-book/concurrency.md @@ -3,7 +3,7 @@ title: Concurrency type: chapter description: This page discusses how Scala concurrency works, with an emphasis on Scala Futures. languages: [ru, zh-cn] -num: 68 +num: 69 previous-page: ca-summary next-page: scala-tools --- diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index b982cf654a..a6b2ad6ad0 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -812,7 +812,7 @@ speak(Person("Bam Bam")) // "Bam Bam says, Bam bam!" #### Binding matched patterns to variables -You can bind the matched pattern to a variable to use type-specific behavior. +You can bind the matched pattern to a variable to use type-specific behavior: {% tabs pattern-binding class=tabs-scala-version %} {% tab 'Scala 2' for=pattern-binding %} @@ -992,10 +992,53 @@ def pattern(x: Matchable): String = x match {% endtab %} {% endtabs %} -{% comment %} -TODO: Add in the new Scala 3 syntax shown on this page: -http://dotty.epfl.ch/docs/reference/changed-features/match-syntax.html -{% endcomment %} +You can also write the code on the right side of the `=>` on multiple lines if you think is easier to read. Here’s one example: + +{% tabs control-structures-31 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-31 %} +```scala +count match { + case 1 => + println("one, a lonely number") + case x if x == 2 || x == 3 => + println("two's company, three's a crowd") + case x if x > 3 => + println("4+, that's a party") + case _ => + println("i'm guessing your number is zero or less") +} +``` +{% endtab %} +{% tab 'Scala 3' for=control-structures-31 %} +```scala +count match + case 1 => + println("one, a lonely number") + case x if x == 2 || x == 3 => + println("two's company, three's a crowd") + case x if x > 3 => + println("4+, that's a party") + case _ => + println("i'm guessing your number is zero or less") +``` +{% endtab %} +{% endtabs %} + +In Scala 3, `match` expressions can be chained: + +{% tabs 'control-structures-32' %} +{% tab 'Scala 3 Only' %} +```scala +i match + case odd: Int if odd % 2 == 1 => "odd" + case even: Int if even % 2 == 0 => "even" + case _ => "not an integer" +match + case "even" => true + case _ => false +``` +{% endtab %} +{% endtabs %} ## try/catch/finally @@ -1004,8 +1047,8 @@ For consistency, Scala uses the same syntax that `match` expressions use and sup In the following example, `openAndReadAFile` is a method that does what its name implies: it opens a file and reads the text in it, assigning the result to the mutable variable `text`: -{% tabs control-structures-31 class=tabs-scala-version %} -{% tab 'Scala 2' for=control-structures-31 %} +{% tabs control-structures-33 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-33 %} ```scala var text = "" try { @@ -1019,7 +1062,7 @@ try { } ``` {% endtab %} -{% tab 'Scala 3' for=control-structures-31 %} +{% tab 'Scala 3' for=control-structures-33 %} ```scala var text = "" try diff --git a/_overviews/scala3-book/fun-eta-expansion.md b/_overviews/scala3-book/fun-eta-expansion.md index 0854c09771..a435a4284b 100644 --- a/_overviews/scala3-book/fun-eta-expansion.md +++ b/_overviews/scala3-book/fun-eta-expansion.md @@ -3,7 +3,7 @@ title: Eta-Expansion type: section description: This page discusses Eta-Expansion, the Scala technology that automatically and transparently converts methods into functions. languages: [ru, zh-cn] -num: 31 +num: 32 previous-page: fun-function-variables next-page: fun-hofs --- diff --git a/_overviews/scala3-book/fun-function-variables.md b/_overviews/scala3-book/fun-function-variables.md index 04c612b7b7..248a334edf 100644 --- a/_overviews/scala3-book/fun-function-variables.md +++ b/_overviews/scala3-book/fun-function-variables.md @@ -5,7 +5,7 @@ description: This page shows how to use function variables in Scala. languages: [ru, zh-cn] num: 30 previous-page: fun-anonymous-functions -next-page: fun-eta-expansion +next-page: fun-partial-functions --- diff --git a/_overviews/scala3-book/fun-hofs.md b/_overviews/scala3-book/fun-hofs.md index 513c520a54..943845cfc6 100644 --- a/_overviews/scala3-book/fun-hofs.md +++ b/_overviews/scala3-book/fun-hofs.md @@ -3,7 +3,7 @@ title: Higher-Order Functions type: section description: This page demonstrates how to create and use higher-order functions in Scala. languages: [ru, zh-cn] -num: 32 +num: 33 previous-page: fun-eta-expansion next-page: fun-write-map-function --- diff --git a/_overviews/scala3-book/fun-intro.md b/_overviews/scala3-book/fun-intro.md index a3c82e51c7..66cb6bad81 100644 --- a/_overviews/scala3-book/fun-intro.md +++ b/_overviews/scala3-book/fun-intro.md @@ -10,5 +10,5 @@ next-page: fun-anonymous-functions Where the previous chapter introduced Scala *methods*, this chapter digs into *functions*. -The topics that are covered include anonymous functions, function variables, and higher-order functions (HOFs), including how to create your own HOFs. +The topics that are covered include anonymous functions, partial functions, function variables, and higher-order functions (HOFs), including how to create your own HOFs. diff --git a/_overviews/scala3-book/fun-partial-functions.md b/_overviews/scala3-book/fun-partial-functions.md new file mode 100644 index 0000000000..4a6c52d5ff --- /dev/null +++ b/_overviews/scala3-book/fun-partial-functions.md @@ -0,0 +1,82 @@ +--- +title: Partial Functions +type: section +description: This page shows how to use function variables in Scala. +languages: [ru, zh-cn] +num: 31 +previous-page: fun-function-variables +next-page: fun-eta-expansion +--- + +A partial function is a function that may not be defined for all values of its argument type. In Scala, partial functions +are unary functions implementing the `PartialFunction[A, B]` trait, where `A` is the argument type and `B` the result type. + +To define a partial function, use a `case` identical to those used in `match` expressions: + +{% tabs fun-partial-1 %} +{% tab 'Scala 2 and 3' %} +```scala +val doubledOdds: PartialFunction[Int, Int] = { + case i if i % 2 == 1 => i * 2 +} +``` +{% endtab %} +{% endtabs %} + +To check if a partial function is for an argument, use the `isDefinedAt` method: + +{% tabs fun-partial-2 %} +{% tab 'Scala 2 and 3' %} +```scala +doubledOdds.isDefinedAt(3) // true +doubledOdds.isDefinedAt(4) // false +``` +{% endtab %} +{% endtabs %} + +Trying to apply a partial function to an argument not belonging to its domain results in `MatchError`: + +{% tabs fun-partial-3 %} +{% tab 'Scala 2 and 3' %} +```scala +doubledOdds(4) // Exception in thread "main" scala.MatchError: 4 +``` +{% endtab %} +{% endtabs %} + +### Using partial functions + +A partial function can be passed as an argument to a method: + +{% tabs fun-partial-4 %} +{% tab 'Scala 2 and 3' %} +```scala +val res = List(1, 2, 3).collect({ case i if i % 2 == 1 => i * 2 }) // List(2, 6) +``` +{% endtab %} +{% endtabs %} + +You can define a default value for arguments not in domain with `applyOrElse`: + +{% tabs fun-partial-5 %} +{% tab 'Scala 2 and 3' %} +```scala +doubledOdds.applyOrElse(4, _ + 1) // 5 +``` +{% endtab %} +{% endtabs %} + +Two partial function can be composed with `orElse`, the second function will be applied for arguments where the first +one is not defined: + +{% tabs fun-partial-6 %} +{% tab 'Scala 2 and 3' %} +```scala +val incrementedEvens: PartialFunction[Int, Int] = { + case i if i % 2 == 0 => i + 1 +} + +val res2 = List(1, 2, 3).collect(doubledOdds.orElse(incrementedEvens)) // List(2, 3, 6) +``` +{% endtab %} +{% endtabs %} \ No newline at end of file diff --git a/_overviews/scala3-book/fun-summary.md b/_overviews/scala3-book/fun-summary.md index ffd7bb7bd7..50eb480c27 100644 --- a/_overviews/scala3-book/fun-summary.md +++ b/_overviews/scala3-book/fun-summary.md @@ -3,7 +3,7 @@ title: Summary type: section description: This page provides a summary of the previous 'Functions' sections. languages: [ru, zh-cn] -num: 35 +num: 36 previous-page: fun-write-method-returns-function next-page: packaging-imports --- diff --git a/_overviews/scala3-book/fun-write-map-function.md b/_overviews/scala3-book/fun-write-map-function.md index 9799c97d52..85fd13b248 100644 --- a/_overviews/scala3-book/fun-write-map-function.md +++ b/_overviews/scala3-book/fun-write-map-function.md @@ -3,7 +3,7 @@ title: Write Your Own map Method type: section description: This page demonstrates how to create and use higher-order functions in Scala. languages: [ru, zh-cn] -num: 33 +num: 34 previous-page: fun-hofs next-page: fun-write-method-returns-function --- diff --git a/_overviews/scala3-book/fun-write-method-returns-function.md b/_overviews/scala3-book/fun-write-method-returns-function.md index 1e6fc8b304..28c05b9cf2 100644 --- a/_overviews/scala3-book/fun-write-method-returns-function.md +++ b/_overviews/scala3-book/fun-write-method-returns-function.md @@ -3,7 +3,7 @@ title: Creating a Method That Returns a Function type: section description: This page demonstrates how to create and use higher-order functions in Scala. languages: [ru, zh-cn] -num: 34 +num: 35 previous-page: fun-write-map-function next-page: fun-summary --- diff --git a/_overviews/scala3-book/interacting-with-java.md b/_overviews/scala3-book/interacting-with-java.md index 7d9d9f2469..00a3c5aa8a 100644 --- a/_overviews/scala3-book/interacting-with-java.md +++ b/_overviews/scala3-book/interacting-with-java.md @@ -3,7 +3,7 @@ title: Interacting with Java type: chapter description: This page demonstrates how Scala code can interact with Java, and how Java code can interact with Scala code. languages: [ru, zh-cn] -num: 72 +num: 73 previous-page: tools-worksheets next-page: scala-for-java-devs --- diff --git a/_overviews/scala3-book/packaging-imports.md b/_overviews/scala3-book/packaging-imports.md index 4c5857cc53..f5665c28fa 100644 --- a/_overviews/scala3-book/packaging-imports.md +++ b/_overviews/scala3-book/packaging-imports.md @@ -3,7 +3,7 @@ title: Packaging and Imports type: chapter description: A discussion of using packages and imports to organize your code, build related modules of code, control scope, and help prevent namespace collisions. languages: [ru, zh-cn] -num: 36 +num: 37 previous-page: fun-summary next-page: collections-intro --- diff --git a/_overviews/scala3-book/scala-for-java-devs.md b/_overviews/scala3-book/scala-for-java-devs.md index b80f3a427a..0ba8361778 100644 --- a/_overviews/scala3-book/scala-for-java-devs.md +++ b/_overviews/scala3-book/scala-for-java-devs.md @@ -3,7 +3,7 @@ title: Scala for Java Developers type: chapter description: This page is for Java developers who are interested in learning about Scala 3. languages: [zh-cn] -num: 73 +num: 74 previous-page: interacting-with-java next-page: scala-for-javascript-devs --- diff --git a/_overviews/scala3-book/scala-for-javascript-devs.md b/_overviews/scala3-book/scala-for-javascript-devs.md index b488ed8a99..26c672ae99 100644 --- a/_overviews/scala3-book/scala-for-javascript-devs.md +++ b/_overviews/scala3-book/scala-for-javascript-devs.md @@ -3,7 +3,7 @@ title: Scala for JavaScript Developers type: chapter description: This chapter provides an introduction to Scala 3 for JavaScript developers languages: [zh-cn] -num: 74 +num: 75 previous-page: scala-for-java-devs next-page: scala-for-python-devs --- diff --git a/_overviews/scala3-book/scala-for-python-devs.md b/_overviews/scala3-book/scala-for-python-devs.md index 5b0e8dec91..147f5977f7 100644 --- a/_overviews/scala3-book/scala-for-python-devs.md +++ b/_overviews/scala3-book/scala-for-python-devs.md @@ -3,7 +3,7 @@ title: Scala for Python Developers type: chapter description: This page is for Python developers who are interested in learning about Scala 3. languages: [zh-cn] -num: 75 +num: 76 previous-page: scala-for-javascript-devs next-page: where-next --- diff --git a/_overviews/scala3-book/scala-tools.md b/_overviews/scala3-book/scala-tools.md index 7d6bb7a397..4469a7283d 100644 --- a/_overviews/scala3-book/scala-tools.md +++ b/_overviews/scala3-book/scala-tools.md @@ -3,7 +3,7 @@ title: Scala Tools type: chapter description: This chapter looks at two commonly-used Scala tools, sbt and ScalaTest. languages: [ru, zh-cn] -num: 69 +num: 70 previous-page: concurrency next-page: tools-sbt --- diff --git a/_overviews/scala3-book/tools-sbt.md b/_overviews/scala3-book/tools-sbt.md index 3c442fc962..b68ae6632f 100644 --- a/_overviews/scala3-book/tools-sbt.md +++ b/_overviews/scala3-book/tools-sbt.md @@ -3,7 +3,7 @@ title: Building and Testing Scala Projects with sbt type: section description: This section looks at a commonly-used build tool, sbt, and a testing library, ScalaTest. languages: [ru, zh-cn] -num: 70 +num: 71 previous-page: scala-tools next-page: tools-worksheets --- diff --git a/_overviews/scala3-book/tools-worksheets.md b/_overviews/scala3-book/tools-worksheets.md index a1102841ae..cf14935e46 100644 --- a/_overviews/scala3-book/tools-worksheets.md +++ b/_overviews/scala3-book/tools-worksheets.md @@ -3,7 +3,7 @@ title: Worksheets type: section description: This section looks at worksheets, an alternative to Scala projects. languages: [ru, zh-cn] -num: 71 +num: 72 previous-page: tools-sbt next-page: interacting-with-java --- diff --git a/_overviews/scala3-book/types-adts-gadts.md b/_overviews/scala3-book/types-adts-gadts.md index 204519c030..356d01c16d 100644 --- a/_overviews/scala3-book/types-adts-gadts.md +++ b/_overviews/scala3-book/types-adts-gadts.md @@ -3,7 +3,7 @@ title: Algebraic Data Types type: section description: This section introduces and demonstrates algebraic data types (ADTs) in Scala 3. languages: [ru, zh-cn] -num: 53 +num: 54 previous-page: types-union next-page: types-variance scala3: true diff --git a/_overviews/scala3-book/types-dependent-function.md b/_overviews/scala3-book/types-dependent-function.md index f5b5cf2d37..96f6d36210 100644 --- a/_overviews/scala3-book/types-dependent-function.md +++ b/_overviews/scala3-book/types-dependent-function.md @@ -3,7 +3,7 @@ title: Dependent Function Types type: section description: This section introduces and demonstrates dependent function types in Scala 3. languages: [ru, zh-cn] -num: 57 +num: 58 previous-page: types-structural next-page: types-others scala3: true diff --git a/_overviews/scala3-book/types-generics.md b/_overviews/scala3-book/types-generics.md index c772ea65a4..84ddd4599e 100644 --- a/_overviews/scala3-book/types-generics.md +++ b/_overviews/scala3-book/types-generics.md @@ -3,7 +3,7 @@ title: Generics type: section description: This section introduces and demonstrates generics in Scala 3. languages: [ru, zh-cn] -num: 50 +num: 51 previous-page: types-inferred next-page: types-intersection --- diff --git a/_overviews/scala3-book/types-inferred.md b/_overviews/scala3-book/types-inferred.md index 50cdb729e1..92333b3735 100644 --- a/_overviews/scala3-book/types-inferred.md +++ b/_overviews/scala3-book/types-inferred.md @@ -3,7 +3,7 @@ title: Inferred Types type: section description: This section introduces and demonstrates inferred types in Scala 3 languages: [ru, zh-cn] -num: 49 +num: 50 previous-page: types-introduction next-page: types-generics --- diff --git a/_overviews/scala3-book/types-intersection.md b/_overviews/scala3-book/types-intersection.md index 6c7e015ba6..2c533ffd09 100644 --- a/_overviews/scala3-book/types-intersection.md +++ b/_overviews/scala3-book/types-intersection.md @@ -3,7 +3,7 @@ title: Intersection Types type: section description: This section introduces and demonstrates intersection types in Scala 3. languages: [ru, zh-cn] -num: 51 +num: 52 previous-page: types-generics next-page: types-union scala3: true diff --git a/_overviews/scala3-book/types-introduction.md b/_overviews/scala3-book/types-introduction.md index ef21c8b4f3..77a79a0844 100644 --- a/_overviews/scala3-book/types-introduction.md +++ b/_overviews/scala3-book/types-introduction.md @@ -3,7 +3,7 @@ title: Types and the Type System type: chapter description: This chapter provides an introduction to Scala 3 types and the type system. languages: [ru, zh-cn] -num: 48 +num: 49 previous-page: fp-summary next-page: types-inferred --- diff --git a/_overviews/scala3-book/types-opaque-types.md b/_overviews/scala3-book/types-opaque-types.md index 1d7483630c..4076749050 100644 --- a/_overviews/scala3-book/types-opaque-types.md +++ b/_overviews/scala3-book/types-opaque-types.md @@ -3,7 +3,7 @@ title: Opaque Types type: section description: This section introduces and demonstrates opaque types in Scala 3. languages: [ru, zh-cn] -num: 55 +num: 56 previous-page: types-variance next-page: types-structural scala3: true diff --git a/_overviews/scala3-book/types-others.md b/_overviews/scala3-book/types-others.md index f2db8a42be..9419073f95 100644 --- a/_overviews/scala3-book/types-others.md +++ b/_overviews/scala3-book/types-others.md @@ -3,7 +3,7 @@ title: Other Types type: section description: This section mentions other advanced types in Scala 3. languages: [ru, zh-cn] -num: 58 +num: 59 previous-page: types-dependent-function next-page: ca-contextual-abstractions-intro scala3: true diff --git a/_overviews/scala3-book/types-structural.md b/_overviews/scala3-book/types-structural.md index 8dee33f301..afa74fe340 100644 --- a/_overviews/scala3-book/types-structural.md +++ b/_overviews/scala3-book/types-structural.md @@ -3,7 +3,7 @@ title: Structural Types type: section description: This section introduces and demonstrates structural types in Scala 3. languages: [ru, zh-cn] -num: 56 +num: 57 previous-page: types-opaque-types next-page: types-dependent-function scala3: true diff --git a/_overviews/scala3-book/types-union.md b/_overviews/scala3-book/types-union.md index b61de27be9..e685646608 100644 --- a/_overviews/scala3-book/types-union.md +++ b/_overviews/scala3-book/types-union.md @@ -3,7 +3,7 @@ title: Union Types type: section description: This section introduces and demonstrates union types in Scala 3. languages: [ru, zh-cn] -num: 52 +num: 53 previous-page: types-intersection next-page: types-adts-gadts scala3: true diff --git a/_overviews/scala3-book/types-variance.md b/_overviews/scala3-book/types-variance.md index deb2492e80..f2b8e3d931 100644 --- a/_overviews/scala3-book/types-variance.md +++ b/_overviews/scala3-book/types-variance.md @@ -3,7 +3,7 @@ title: Variance type: section description: This section introduces and demonstrates variance in Scala 3. languages: [ru, zh-cn] -num: 54 +num: 55 previous-page: types-adts-gadts next-page: types-opaque-types --- diff --git a/_overviews/scala3-book/where-next.md b/_overviews/scala3-book/where-next.md index 05bdad479a..8eed7a163f 100644 --- a/_overviews/scala3-book/where-next.md +++ b/_overviews/scala3-book/where-next.md @@ -3,7 +3,7 @@ title: Where To Go Next type: chapter description: Where to go next after reading the Scala Book languages: [zh-cn] -num: 76 +num: 77 previous-page: scala-for-python-devs next-page: --- From 38ac7a3f89839aedf44d27e2336f6689d140e623 Mon Sep 17 00:00:00 2001 From: gkepka Date: Tue, 10 Dec 2024 14:17:14 +0100 Subject: [PATCH 2978/3075] Add match following a period example and remove languages from Partial Functions page --- _overviews/scala3-book/control-structures.md | 18 +++++++++++++++--- .../scala3-book/fun-partial-functions.md | 1 - 2 files changed, 15 insertions(+), 4 deletions(-) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index a6b2ad6ad0..7dfa5c3dea 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -1040,6 +1040,18 @@ match {% endtab %} {% endtabs %} +The `match` expression can also follow a period, which simplifies matching on results returned by chained method calls: + +{% tabs 'control-structures-33' %} +{% tab 'Scala 3 Only' %} +```scala +List(1, 2, 3).map(_ * 2).headOption.match + case Some(value) => println(s"The head is: $value") + case None => println("The list is empty") +``` +{% endtab %} +{% endtabs %} + ## try/catch/finally Like Java, Scala has a `try`/`catch`/`finally` construct to let you catch and manage exceptions. @@ -1047,8 +1059,8 @@ For consistency, Scala uses the same syntax that `match` expressions use and sup In the following example, `openAndReadAFile` is a method that does what its name implies: it opens a file and reads the text in it, assigning the result to the mutable variable `text`: -{% tabs control-structures-33 class=tabs-scala-version %} -{% tab 'Scala 2' for=control-structures-33 %} +{% tabs control-structures-34 class=tabs-scala-version %} +{% tab 'Scala 2' for=control-structures-34 %} ```scala var text = "" try { @@ -1062,7 +1074,7 @@ try { } ``` {% endtab %} -{% tab 'Scala 3' for=control-structures-33 %} +{% tab 'Scala 3' for=control-structures-34 %} ```scala var text = "" try diff --git a/_overviews/scala3-book/fun-partial-functions.md b/_overviews/scala3-book/fun-partial-functions.md index 4a6c52d5ff..55ed352b23 100644 --- a/_overviews/scala3-book/fun-partial-functions.md +++ b/_overviews/scala3-book/fun-partial-functions.md @@ -2,7 +2,6 @@ title: Partial Functions type: section description: This page shows how to use function variables in Scala. -languages: [ru, zh-cn] num: 31 previous-page: fun-function-variables next-page: fun-eta-expansion From f05349a28826efbd70c196ae78123cb8df6b7f45 Mon Sep 17 00:00:00 2001 From: gkepka Date: Tue, 10 Dec 2024 14:20:33 +0100 Subject: [PATCH 2979/3075] Apply suggestions from review --- _overviews/scala3-book/control-structures.md | 2 +- _overviews/scala3-book/fun-partial-functions.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index 7dfa5c3dea..91cf661331 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -992,7 +992,7 @@ def pattern(x: Matchable): String = x match {% endtab %} {% endtabs %} -You can also write the code on the right side of the `=>` on multiple lines if you think is easier to read. Here’s one example: +You can also write the code on the right side of the `=>` on multiple lines if you think it is easier to read. Here is one example: {% tabs control-structures-31 class=tabs-scala-version %} {% tab 'Scala 2' for=control-structures-31 %} diff --git a/_overviews/scala3-book/fun-partial-functions.md b/_overviews/scala3-book/fun-partial-functions.md index 55ed352b23..fe8aaa50eb 100644 --- a/_overviews/scala3-book/fun-partial-functions.md +++ b/_overviews/scala3-book/fun-partial-functions.md @@ -1,7 +1,7 @@ --- title: Partial Functions type: section -description: This page shows how to use function variables in Scala. +description: This page shows how to use partial functions in Scala. num: 31 previous-page: fun-function-variables next-page: fun-eta-expansion @@ -22,7 +22,7 @@ val doubledOdds: PartialFunction[Int, Int] = { {% endtab %} {% endtabs %} -To check if a partial function is for an argument, use the `isDefinedAt` method: +To check if a partial function is defined for an argument, use the `isDefinedAt` method: {% tabs fun-partial-2 %} {% tab 'Scala 2 and 3' %} From e80347979cf4b34580a813e7f40e233aa01cf2ec Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gabriel=20K=C4=99pka?= <44374670+gkepka@users.noreply.github.com> Date: Tue, 10 Dec 2024 14:28:37 +0100 Subject: [PATCH 2980/3075] Update _overviews/scala3-book/control-structures.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Sébastien Doeraene --- _overviews/scala3-book/control-structures.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/_overviews/scala3-book/control-structures.md b/_overviews/scala3-book/control-structures.md index 91cf661331..9d44db59cb 100644 --- a/_overviews/scala3-book/control-structures.md +++ b/_overviews/scala3-book/control-structures.md @@ -1045,9 +1045,12 @@ The `match` expression can also follow a period, which simplifies matching on re {% tabs 'control-structures-33' %} {% tab 'Scala 3 Only' %} ```scala -List(1, 2, 3).map(_ * 2).headOption.match - case Some(value) => println(s"The head is: $value") - case None => println("The list is empty") +List(1, 2, 3) + .map(_ * 2) + .headOption + .match + case Some(value) => println(s"The head is: $value") + case None => println("The list is empty") ``` {% endtab %} {% endtabs %} From 58632a082fcc901d37504b60ea59fde2836429b7 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur Date: Tue, 10 Dec 2024 15:51:44 +0100 Subject: [PATCH 2981/3075] Add Scala 3.6.2 to docs config --- _config.yml | 2 +- api/all.md | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/_config.yml b/_config.yml index aed90af2e1..7c1596695a 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.15 scala-212-version: 2.12.20 -scala-3-version: 3.5.2 +scala-3-version: 3.6.2 collections: style: diff --git a/api/all.md b/api/all.md index db37824fc7..5c9c54ed88 100644 --- a/api/all.md +++ b/api/all.md @@ -64,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.5.2 + * [Library API](https://www.scala-lang.org/api/3.5.2/) * Scala 3.5.1 * [Library API](https://www.scala-lang.org/api/3.5.1/) * Scala 3.5.0 From 9c4b57832cc415a472104ec6ae2a7687c8b447d7 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur Date: Tue, 10 Dec 2024 15:52:08 +0100 Subject: [PATCH 2982/3075] Update JDK Scala compatibility table --- _overviews/jdk-compatibility/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index e843f6f61e..a5afff7055 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,8 +14,8 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 23 | 3.4.0 | 3.3.1 | 2.13.15 | 2.12.20 | | -| 22 | 3.4.0 | 3.3.1 | 2.13.13 | 2.12.19 | | +| 23 | 3.6.2 | 3.3.5 | 2.13.15 | 2.12.20 | | +| 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 3.3.0 | 2.13.6 | 2.12.15 | | | 11 (LTS) | 3.0.0 | 3.3.0 | 2.13.0 | 2.12.4 | 2.11.12 | From dbe095e0f8f4c86aed7b70ceaf14cb5ef9765976 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Wed, 11 Dec 2024 00:30:18 +0000 Subject: [PATCH 2983/3075] Update SIPs state --- _sips/sips/scala-cli.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_sips/sips/scala-cli.md b/_sips/sips/scala-cli.md index 9732fbbcf6..f979104084 100644 --- a/_sips/sips/scala-cli.md +++ b/_sips/sips/scala-cli.md @@ -79,9 +79,9 @@ Currently, when reporting a bug in the compiler (or any other Scala-related) rep "Using directives", provided by Scala CLI give the ability to include the whole configuration in single file, for example: ```scala -//> using platform native -//> using dep com.lihaoyi::os-lib:0.7.8 -//> using options -Xfatal-warnings +//> using platform "native" +//> using "com.lihaoyi::os-lib:0.7.8" +//> using options "-Xfatal-warnings" def foo = println("") ``` From 3b6db1d9377f3a2ef46f2fb6b9da5545dec20c21 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Thu, 12 Dec 2024 14:56:23 -0800 Subject: [PATCH 2984/3075] add our Bluesky, and change Twitter->X --- _data/footer.yml | 8 +++++--- _overviews/contribute/index.md | 2 +- _overviews/scala-book/scala-features.md | 4 ++-- _overviews/scala3-book/scala-features.md | 4 ++-- _overviews/scala3-scaladoc/settings.md | 2 +- _overviews/tutorials/scala-on-android.md | 2 +- _ru/scala3/guides/scaladoc/settings.md | 2 +- _ru/scala3/talks.md | 20 +++++++++---------- _uk/scala3/talks.md | 20 +++++++++---------- .../overviews/scala3-book/scala-features.md | 2 +- resources/js/tweetMachine-update.js | 12 +++++------ scala3/talks.md | 20 +++++++++---------- 12 files changed, 50 insertions(+), 48 deletions(-) diff --git a/_data/footer.yml b/_data/footer.yml index 5e24e08b6d..da38a4f118 100644 --- a/_data/footer.yml +++ b/_data/footer.yml @@ -57,9 +57,11 @@ - title: GitHub url: "https://github.com/scala/scala" - title: Mastodon - url: https://fosstodon.org/@scala_lang - - title: Twitter - url: "https://twitter.com/scala_lang" + url: "https://fosstodon.org/@scala_lang" + - title: Bluesky + url: "https://bsky.app/profile/scala-lang.bsky.social" + - title: X + url: "https://x.com/scala_lang" - title: Discord url: "https://discord.com/invite/scala" - title: LinkedIn diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index 73fdaaf478..329861a72f 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -276,7 +276,7 @@ The above benefits are something good to achieve regardless of your level of exp be improved. For best results, spend a lot of time with the library to get a feel of what's important and what can improve. - **Lookout for announcements:** You may want to keep an eye on the Scala Center - [LinkedIn](https://www.linkedin.com/company/scala-center/) and [Twitter](https://twitter.com/scala_lang) to stay up-to-date with the possible contribution opportunities. For example, every year, the Scala Center participates + [LinkedIn](https://www.linkedin.com/company/scala-center/) and [Bluesky](https://bsky.app/profile/scala-lang.bsky.social) or [X](https://x.com/scala_lang) to stay up-to-date with the possible contribution opportunities. For example, every year, the Scala Center participates in the Google Summer of Code program where you are paid to work on open source Scala projects over the course of summer. {{backButton}} diff --git a/_overviews/scala-book/scala-features.md b/_overviews/scala-book/scala-features.md index 79aefdc352..5973f1ea1a 100644 --- a/_overviews/scala-book/scala-features.md +++ b/_overviews/scala-book/scala-features.md @@ -13,11 +13,11 @@ new-version: /scala3/book/scala-features.html --- -The name *Scala* comes from the word *scalable*, and true to that name, it’s used to power the busiest websites in the world, including Twitter, Netflix, Tumblr, LinkedIn, Foursquare, and many more. +The name *Scala* comes from the word *scalable*, and true to that name, it’s used to power the busiest websites in the world, including X, Netflix, Tumblr, LinkedIn, Foursquare, and many more. Here are a few more nuggets about Scala: -- It’s a modern programming language created by [Martin Odersky](https://twitter.com/odersky?lang=en) (the father of `javac`), and influenced by Java, Ruby, Smalltalk, ML, Haskell, Erlang, and others. +- It’s a modern programming language created by [Martin Odersky](https://x.com/odersky?lang=en) (the father of `javac`), and influenced by Java, Ruby, Smalltalk, ML, Haskell, Erlang, and others. - It’s a high-level language. - It’s statically typed. - It has a sophisticated type inference system. diff --git a/_overviews/scala3-book/scala-features.md b/_overviews/scala3-book/scala-features.md index c1427e8a65..c1d1ca834c 100644 --- a/_overviews/scala3-book/scala-features.md +++ b/_overviews/scala3-book/scala-features.md @@ -292,7 +292,7 @@ Boxing and unboxing is completely transparent to the user. ### Supports FP/OOP fusion {% comment %} -NOTE: This text in the first line comes from this slide: https://twitter.com/alexelcu/status/996408359514525696 +NOTE: This text in the first line comes from this slide: https://x.com/alexelcu/status/996408359514525696 {% endcomment %} The essence of Scala is the fusion of functional programming and object-oriented programming in a typed setting: @@ -499,7 +499,7 @@ Some of the more notable libraries are listed below. - The [Play Framework](https://www.playframework.com) followed the Ruby on Rails model to become a lightweight, stateless, developer-friendly, web-friendly architecture for highly-scalable applications - [Scalatra](https://scalatra.org) is a tiny, high-performance, async web framework, inspired by Sinatra -- [Finatra](https://twitter.github.io/finatra) is Scala services built on TwitterServer and Finagle +- [Finatra](https://twitter.github.io/finatra) is Scala services built for X - [Scala.js](https://www.scala-js.org) is a strongly-typed replacement for JavaScript that provides a safer way to build robust front-end web applications - [ScalaJs-React](https://github.com/japgolly/scalajs-react) lifts Facebook’s React library into Scala.js, and endeavours to make it as type-safe and Scala-friendly as possible diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index e5118ab430..3b58df7bae 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -87,7 +87,7 @@ A mapping is of the form `::[scaladoc3|scaladoc|javadoc]::`. You ca Links to social sites. For example: -`-social-links:github::https://github.com/scala/scala3,discord::https://discord.com/invite/scala,twitter::https://twitter.com/scala_lang` +`-social-links:github::https://github.com/scala/scala3,discord::https://discord.com/invite/scala,twitter::https://x.com/scala_lang` Valid values are of the form: `[github|twitter|gitter|discord]::link`. Scaladoc also supports `custom::link::white_icon_name::black_icon_name`. In this case icons must be present in `images/` directory. diff --git a/_overviews/tutorials/scala-on-android.md b/_overviews/tutorials/scala-on-android.md index 49749aa85f..370eb72b39 100644 --- a/_overviews/tutorials/scala-on-android.md +++ b/_overviews/tutorials/scala-on-android.md @@ -140,5 +140,5 @@ If you managed to build one of the example apps and want to code something more - Download some other examples from [the “Scala on Android” repository on GitHub](https://github.com/makingthematrix/scalaonandroid). Contact me, if you write an example app of your own and want me to include it. - Join us on the official Scala discord — we have a [#scala-android channel](https://discord.gg/UuDawpq7) there. - There is also an [#android channel](https://discord.gg/XHMt6Yq4) on the “Learning Scala” discord. -- Finally, if you have any questions, [you can always find me on Twitter](https://twitter.com/makingthematrix). +- Finally, if you have any questions, [you can always find me on X](https://x.com/makingthematrix). diff --git a/_ru/scala3/guides/scaladoc/settings.md b/_ru/scala3/guides/scaladoc/settings.md index 83dd456425..942e88342b 100644 --- a/_ru/scala3/guides/scaladoc/settings.md +++ b/_ru/scala3/guides/scaladoc/settings.md @@ -101,7 +101,7 @@ Compile / doc / scalacOptions ++= Seq("-project", "my-project"), Ссылки на социальные сети. Например: -`-social-links:github::https://github.com/scala/scala3,discord::https://discord.com/invite/scala,twitter::https://twitter.com/scala_lang` +`-social-links:github::https://github.com/scala/scala3,discord::https://discord.com/invite/scala,twitter::https://x.com/scala_lang` Допустимые значения имеют вид: `[github|twitter|gitter|discord]::link`. Scaladoc также поддерживает `custom::link::white_icon_name::black_icon_name`. diff --git a/_ru/scala3/talks.md b/_ru/scala3/talks.md index 06467723c2..25fce82809 100644 --- a/_ru/scala3/talks.md +++ b/_ru/scala3/talks.md @@ -16,13 +16,13 @@ versionSpecific: true Обсуждения Scala 3 ---------------- -- (ScalaDays 2019, Lausanne) [Тур по Scala 3](https://www.youtube.com/watch?v=_Rnrx2lo9cw) от [Martin Odersky](http://twitter.com/odersky) +- (ScalaDays 2019, Lausanne) [Тур по Scala 3](https://www.youtube.com/watch?v=_Rnrx2lo9cw) от [Martin Odersky](http://x.com/odersky) -- (ScalaDays 2016, Berlin) [Развитие Scala](https://www.youtube.com/watch?v=GHzWqJKFCk4) от [Martin Odersky](http://twitter.com/odersky) [\[слайды\]](http://www.slideshare.net/Odersky/scala-days-nyc-2016) +- (ScalaDays 2016, Berlin) [Развитие Scala](https://www.youtube.com/watch?v=GHzWqJKFCk4) от [Martin Odersky](http://x.com/odersky) [\[слайды\]](http://www.slideshare.net/Odersky/scala-days-nyc-2016) -- (JVMLS 2015) [Компиляторы — это базы данных](https://www.youtube.com/watch?v=WxyyJyB_Ssc) от [Martin Odersky](http://twitter.com/odersky) [\[слайды\]](http://www.slideshare.net/Odersky/compilers-are-databases) +- (JVMLS 2015) [Компиляторы — это базы данных](https://www.youtube.com/watch?v=WxyyJyB_Ssc) от [Martin Odersky](http://x.com/odersky) [\[слайды\]](http://www.slideshare.net/Odersky/compilers-are-databases) -- (Scala World 2015) [Dotty: изучение будущего Scala](https://www.youtube.com/watch?v=aftdOFuVU1o) от [Dmitry Petrashko](http://twitter.com/darkdimius) [\[слайды\]](https://d-d.me/scalaworld2015/#/). +- (Scala World 2015) [Dotty: изучение будущего Scala](https://www.youtube.com/watch?v=aftdOFuVU1o) от [Dmitry Petrashko](http://x.com/darkdimius) [\[слайды\]](https://d-d.me/scalaworld2015/#/). Дмитрий рассказывает о многих новых функциях, которые предлагает Dotty, таких как типы пересечения и объединения, улучшенная инициализация lazy val и многое другое. Дмитрий также рассказывает о внутреннем устройстве Dotty и, в частности, о высоком уровне контекстных абстракций Dotty. @@ -35,17 +35,17 @@ versionSpecific: true - (ScalaDays 2019, Lausanne) [Scala, ориентированная на будущее: промежуточное представление TASTY](https://www.youtube.com/watch?v=zQFjC3zLYwo) от [Guillaume Martres](http://guillaume.martres.me/). -- (Mar 21, 2017) [Dotty Internals 1: Trees & Symbols](https://www.youtube.com/watch?v=yYd-zuDd3S8) от [Dmitry Petrashko](http://twitter.com/darkdimius) [\[заметки\]](https://dotty.epfl.ch/docs/internals/dotty-internals-1-notes.html). +- (Mar 21, 2017) [Dotty Internals 1: Trees & Symbols](https://www.youtube.com/watch?v=yYd-zuDd3S8) от [Dmitry Petrashko](http://x.com/darkdimius) [\[заметки\]](https://dotty.epfl.ch/docs/internals/dotty-internals-1-notes.html). Это записанная встреча между EPFL и Waterloo, на которой мы представляем первые понятия внутри Dotty: деревья и символы. -- (Mar 21, 2017) [Dotty Internals 2: Types](https://www.youtube.com/watch?v=3gmLIYlGbKc) от [Martin Odersky](http://twitter.com/odersky) и [Dmitry Petrashko](http://twitter.com/darkdimius). +- (Mar 21, 2017) [Dotty Internals 2: Types](https://www.youtube.com/watch?v=3gmLIYlGbKc) от [Martin Odersky](http://x.com/odersky) и [Dmitry Petrashko](http://x.com/darkdimius). Это записанная встреча между EPFL и Waterloo, на которой мы рассказываем, как типы представлены внутри Dotty. -- (Jun 15, 2017) [Dotty Internals 3: Denotations](https://youtu.be/9iPA7zMRGKY) от [Martin Odersky](http://twitter.com/odersky) и [Dmitry Petrashko](http://twitter.com/darkdimius). +- (Jun 15, 2017) [Dotty Internals 3: Denotations](https://youtu.be/9iPA7zMRGKY) от [Martin Odersky](http://x.com/odersky) и [Dmitry Petrashko](http://x.com/darkdimius). Это записанная встреча между EPFL и Waterloo, где мы вводим обозначения в Dotty. -- (JVM Language Summit) [How do we make the Dotty compiler fast](https://www.youtube.com/watch?v=9xYoSwnSPz0) от [Dmitry Petrashko](http://twitter.com/darkdimius). - [Dmitry Petrashko](http://twitter.com/darkdimius) в общих чертах рассказывает о том, что было сделано для создания Dotty. +- (JVM Language Summit) [How do we make the Dotty compiler fast](https://www.youtube.com/watch?v=9xYoSwnSPz0) от [Dmitry Petrashko](http://x.com/darkdimius). + [Dmitry Petrashko](http://x.com/darkdimius) в общих чертах рассказывает о том, что было сделано для создания Dotty. - (Typelevel Summit Oslo, May 2016) [Dotty and types: the story so far](https://www.youtube.com/watch?v=YIQjfCKDR5A) от Guillaume Martres [\[слайды\]](http://guillaume.martres.me/talks/typelevel-summit-oslo/). @@ -53,7 +53,7 @@ versionSpecific: true таких как новый алгоритм вывода параметров типа, который может принимать решения о безопасности типов в большем количестве ситуаций, чем scalac. -- (flatMap(Oslo) 2016) [AutoSpecialization in Dotty](https://vimeo.com/165928176) от [Dmitry Petrashko](http://twitter.com/darkdimius) [\[слайды\]](https://d-d.me/talks/flatmap2016/#/). +- (flatMap(Oslo) 2016) [AutoSpecialization in Dotty](https://vimeo.com/165928176) от [Dmitry Petrashko](http://x.com/darkdimius) [\[слайды\]](https://d-d.me/talks/flatmap2016/#/). Dotty Linker анализирует вашу программу и ее зависимости, чтобы применить новую схему специализации. Он основан на нашем опыте Specialization, Miniboxing и проекта Valhalla и значительно уменьшает размер создаваемого байт-кода. И, что лучше всего, он всегда включен, выполняется за кулисами без аннотаций и приводит к ускорению более чем в 20 раз. diff --git a/_uk/scala3/talks.md b/_uk/scala3/talks.md index 9aa70a4835..01087ab671 100644 --- a/_uk/scala3/talks.md +++ b/_uk/scala3/talks.md @@ -17,18 +17,18 @@ versionSpecific: true Talks on Scala 3 ---------------- - (ScalaDays 2019, Lausanne) [Тур по Scala 3](https://www.youtube.com/watch?v=_Rnrx2lo9cw) - від [Martin Odersky](http://twitter.com/odersky) + від [Martin Odersky](http://x.com/odersky) - (ScalaDays 2016, Berlin) [Попереду дорога Scala](https://www.youtube.com/watch?v=GHzWqJKFCk4) - від [Martin Odersky](http://twitter.com/odersky) + від [Martin Odersky](http://x.com/odersky) [\[слайди\]](http://www.slideshare.net/Odersky/scala-days-nyc-2016) - (JVMLS 2015) [Compilers are Databases](https://www.youtube.com/watch?v=WxyyJyB_Ssc) - від [Martin Odersky](http://twitter.com/odersky) + від [Martin Odersky](http://x.com/odersky) [\[слайди\]](http://www.slideshare.net/Odersky/compilers-are-databases) - (Scala World 2015) [Dotty: Досліджуємо майбутнє Scala](https://www.youtube.com/watch?v=aftdOFuVU1o) - від [Dmitry Petrashko](http://twitter.com/darkdimius) + від [Dmitry Petrashko](http://x.com/darkdimius) [\[слайди\]](https://d-d.me/scalaworld2015/#/). Розповідь Дмітрія охоплює багато нових функцій, які приносить Dotty, наприклад типи Intersection та Union, покращена ініціалізація lazy val тощо. Дмітрій також розповідає внутрішню архітектуру Dotty і, зокрема, високий рівень контекстуальних абстракцій Dotty. Ви @@ -43,20 +43,20 @@ Deep Dive with Scala 3 від [[Guillaume Martres](http://guillaume.martres.me/)](http://guillaume.martres.me/). - (Mar 21, 2017) [Dotty Internals 1: Trees та Symbols](https://www.youtube.com/watch?v=yYd-zuDd3S8) - від [Dmitry Petrashko](http://twitter.com/darkdimius) + від [Dmitry Petrashko](http://x.com/darkdimius) [\[meeting notes\]](https://dotty.epfl.ch/docs/internals/dotty-internals-1-notes.html). Це запис зустрічі EPFL та Waterloo, де були представлені перші нотатки про Dotty: Trees та Symbols. - (Mar 21, 2017) [Dotty Internals 2: Types](https://www.youtube.com/watch?v=3gmLIYlGbKc) - від [Martin Odersky](http://twitter.com/odersky) та [Dmitry Petrashko](http://twitter.com/darkdimius). + від [Martin Odersky](http://x.com/odersky) та [Dmitry Petrashko](http://x.com/darkdimius). Це запис зустрічі EPFL та Waterloo, де були представлено як представлені типи всередині Dotty. - (Jun 15, 2017) [Dotty Internals 3: Denotations](https://youtu.be/9iPA7zMRGKY) - від [Martin Odersky](http://twitter.com/odersky) та [Dmitry Petrashko](http://twitter.com/darkdimius). + від [Martin Odersky](http://x.com/odersky) та [Dmitry Petrashko](http://x.com/darkdimius). Це запис зустрічі EPFL та Waterloo, де були представлена денотація в Dotty. - (JVM Language Summit) [Як зробити компілятор Dotty швидким](https://www.youtube.com/watch?v=9xYoSwnSPz0) - від [Dmitry Petrashko](http://twitter.com/darkdimius). + від [Dmitry Petrashko](http://x.com/darkdimius). Дмітрій дає високорівневий вступ до того, що було зроблено для створення Dotty . - (Typelevel Summit Oslo, May 2016) [Dotty та типи: поки що історія](https://www.youtube.com/watch?v=YIQjfCKDR5A) @@ -66,7 +66,7 @@ Deep Dive with Scala 3 який здатний робити висновки про безпеку типів для більшої кількості ситуацій ніж scalac. - (flatMap(Oslo) 2016) [AutoSpecialization в Dotty](https://vimeo.com/165928176) - від [Dmitry Petrashko](http://twitter.com/darkdimius) + від [Dmitry Petrashko](http://x.com/darkdimius) [\[слайди\]](https://d-d.me/talks/flatmap2016/#/). Компонувальник Dotty аналізує вашу програму та її залежності, щоб застосувати нову схему спеціалізації. Віна ґрунтується на нашому досвіді з Specialization, Miniboxing та Valhalla Project, @@ -84,7 +84,7 @@ Deep Dive with Scala 3 Гійом демонструє високорівневе представлення пайплайну компіляції в Dotty. - (ScalaDays 2015, Amsterdam) [Як зробити ваші програми на Scala меншими та швидшими за допомогою компонувальника Dotty](https://www.youtube.com/watch?v=xCeI1ArdXM4) - від [Dmitry Petrashko](http://twitter.com/darkdimius) + від [Dmitry Petrashko](http://x.com/darkdimius) [\[слайди\]](https://d-d.me/scaladays2015/#/). Дмитрій представляє алгоритм аналізу графу виклик у Dotty та переваги продуктивності, які ми можемо отримати з точки зору кількості методів, розміру байт-коду, розміру коду JVM і кількість об'єктів, виділених в кінці. diff --git a/_zh-cn/overviews/scala3-book/scala-features.md b/_zh-cn/overviews/scala3-book/scala-features.md index 946b8e819f..9c8d02f085 100644 --- a/_zh-cn/overviews/scala3-book/scala-features.md +++ b/_zh-cn/overviews/scala3-book/scala-features.md @@ -281,7 +281,7 @@ Scala 是一门面向对象编程（OOP）语言。 ### 支持 FP 与 OOP 融合 {% comment %} -NOTE: This text in the first line comes from this slide: https://twitter.com/alexelcu/status/996408359514525696 +NOTE: This text in the first line comes from this slide: https://x.com/alexelcu/status/996408359514525696 {% endcomment %} Scala 的本质是函数式编程和面向对象编程的融合： diff --git a/resources/js/tweetMachine-update.js b/resources/js/tweetMachine-update.js index a7604d2ba7..0addd1b951 100755 --- a/resources/js/tweetMachine-update.js +++ b/resources/js/tweetMachine-update.js @@ -133,11 +133,11 @@ }); // Usernames text = text.replace(/@[A-Za-z0-9_]+/g, function (u) { - return '' + u + ''; + return '' + u + ''; }); // Hashtags text = text.replace(/#[A-Za-z0-9_\-]+/g, function (u) { - return '' + u + ''; + return '' + u + ''; }); return text; }, @@ -160,7 +160,7 @@ // Set the user screen name var usernameLink = "" + "@" @@ -170,7 +170,7 @@ // Set the username: var userLink = "" + actualTweet.user.name @@ -178,7 +178,7 @@ tweetObj.find('.user').html("" + userLink); // Set the timestamp - var dateLink = "" + tweetMachine.relativeTime(actualTweet.created_at) @@ -411,4 +411,4 @@ } }); }; -})(jQuery); \ No newline at end of file +})(jQuery); diff --git a/scala3/talks.md b/scala3/talks.md index 19539ba13d..0cdba8b2d0 100644 --- a/scala3/talks.md +++ b/scala3/talks.md @@ -16,13 +16,13 @@ advantage of the new language features, or how to migrate from Scala 2. Talks on Scala 3 ---------------- -- (ScalaDays 2019, Lausanne) [A Tour of Scala 3](https://www.youtube.com/watch?v=_Rnrx2lo9cw) by [Martin Odersky](http://twitter.com/odersky) +- (ScalaDays 2019, Lausanne) [A Tour of Scala 3](https://www.youtube.com/watch?v=_Rnrx2lo9cw) by [Martin Odersky](http://x.com/odersky) -- (ScalaDays 2016, Berlin) [Scala's Road Ahead](https://www.youtube.com/watch?v=GHzWqJKFCk4) by [Martin Odersky](http://twitter.com/odersky) [\[slides\]](http://www.slideshare.net/Odersky/scala-days-nyc-2016) +- (ScalaDays 2016, Berlin) [Scala's Road Ahead](https://www.youtube.com/watch?v=GHzWqJKFCk4) by [Martin Odersky](http://x.com/odersky) [\[slides\]](http://www.slideshare.net/Odersky/scala-days-nyc-2016) -- (JVMLS 2015) [Compilers are Databases](https://www.youtube.com/watch?v=WxyyJyB_Ssc) by [Martin Odersky](http://twitter.com/odersky) [\[slides\]](http://www.slideshare.net/Odersky/compilers-are-databases) +- (JVMLS 2015) [Compilers are Databases](https://www.youtube.com/watch?v=WxyyJyB_Ssc) by [Martin Odersky](http://x.com/odersky) [\[slides\]](http://www.slideshare.net/Odersky/compilers-are-databases) -- (Scala World 2015) [Dotty: Exploring the future of Scala](https://www.youtube.com/watch?v=aftdOFuVU1o) by [Dmitry Petrashko](http://twitter.com/darkdimius) [\[slides\]](https://d-d.me/scalaworld2015/#/). +- (Scala World 2015) [Dotty: Exploring the future of Scala](https://www.youtube.com/watch?v=aftdOFuVU1o) by [Dmitry Petrashko](http://x.com/darkdimius) [\[slides\]](https://d-d.me/scalaworld2015/#/). Dmitry covers many of the new features that Dotty brings on the table such as Intersection and Union types, improved lazy val initialization and more. Dmitry also covers dotty internals and in particular the high-level of contextual abstractions of Dotty. You will get to become familiar with many core concepts such as `Denotations`, their evolution through (compilation) time, their @@ -34,17 +34,17 @@ Deep Dive with Scala 3 - (ScalaDays 2019, Lausanne) [Future-proofing Scala: the TASTY intermediate representation](https://www.youtube.com/watch?v=zQFjC3zLYwo) by [Guillaume Martres](http://guillaume.martres.me/). -- (Mar 21, 2017) [Dotty Internals 1: Trees & Symbols](https://www.youtube.com/watch?v=yYd-zuDd3S8) by [Dmitry Petrashko](http://twitter.com/darkdimius) [\[meeting notes\]](https://dotty.epfl.ch/docs/internals/dotty-internals-1-notes.html). +- (Mar 21, 2017) [Dotty Internals 1: Trees & Symbols](https://www.youtube.com/watch?v=yYd-zuDd3S8) by [Dmitry Petrashko](http://x.com/darkdimius) [\[meeting notes\]](https://dotty.epfl.ch/docs/internals/dotty-internals-1-notes.html). This is a recorded meeting between EPFL and Waterloo, where we introduce first notions inside Dotty: Trees and Symbols. -- (Mar 21, 2017) [Dotty Internals 2: Types](https://www.youtube.com/watch?v=3gmLIYlGbKc) by [Martin Odersky](http://twitter.com/odersky) and [Dmitry Petrashko](http://twitter.com/darkdimius). +- (Mar 21, 2017) [Dotty Internals 2: Types](https://www.youtube.com/watch?v=3gmLIYlGbKc) by [Martin Odersky](http://x.com/odersky) and [Dmitry Petrashko](http://x.com/darkdimius). This is a recorded meeting between EPFL and Waterloo, where we introduce how types are represented inside Dotty. -- (Jun 15, 2017) [Dotty Internals 3: Denotations](https://youtu.be/9iPA7zMRGKY) by [Martin Odersky](http://twitter.com/odersky) and [Dmitry Petrashko](http://twitter.com/darkdimius). +- (Jun 15, 2017) [Dotty Internals 3: Denotations](https://youtu.be/9iPA7zMRGKY) by [Martin Odersky](http://x.com/odersky) and [Dmitry Petrashko](http://x.com/darkdimius). This is a recorded meeting between EPFL and Waterloo, where we introduce denotations in Dotty. -- (JVM Language Summit) [How do we make the Dotty compiler fast](https://www.youtube.com/watch?v=9xYoSwnSPz0) by [Dmitry Petrashko](http://twitter.com/darkdimius). - [Dmitry Petrashko](http://twitter.com/darkdimius) gives a high-level introduction on what was done to make Dotty . +- (JVM Language Summit) [How do we make the Dotty compiler fast](https://www.youtube.com/watch?v=9xYoSwnSPz0) by [Dmitry Petrashko](http://x.com/darkdimius). + [Dmitry Petrashko](http://x.com/darkdimius) gives a high-level introduction on what was done to make Dotty . - (Typelevel Summit Oslo, May 2016) [Dotty and types: the story so far](https://www.youtube.com/watch?v=YIQjfCKDR5A) by @@ -52,7 +52,7 @@ Deep Dive with Scala 3 Guillaume focused on some practical improvements to the type system that Dotty makes, like the new type parameter inference algorithm that is able to reason about the type safety of more situations than scalac. -- (flatMap(Oslo) 2016) [AutoSpecialization in Dotty](https://vimeo.com/165928176) by [Dmitry Petrashko](http://twitter.com/darkdimius) [\[slides\]](https://d-d.me/talks/flatmap2016/#/). +- (flatMap(Oslo) 2016) [AutoSpecialization in Dotty](https://vimeo.com/165928176) by [Dmitry Petrashko](http://x.com/darkdimius) [\[slides\]](https://d-d.me/talks/flatmap2016/#/). The Dotty Linker analyses your program and its dependencies to apply a new specialization scheme. It builds on our experience from Specialization, Miniboxing and the Valhalla Project, and drastically reduces the size of the emitted bytecode. And, best of all, it's always enabled, happens behind the From 0ed0073db25e86baec4d31b3929731480d48baad Mon Sep 17 00:00:00 2001 From: Erik Pohl <89852209+ErikPohl444@users.noreply.github.com> Date: Fri, 13 Dec 2024 09:52:43 -0500 Subject: [PATCH 2985/3075] Update pattern-matching.md Added a note about sealed traits because it is the first usage of them in the guide. --- _tour/pattern-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index a89c16775f..340742d1c9 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -92,7 +92,7 @@ case class VoiceRecording(contactName: String, link: String) extends Notificatio {% endtab %} {% endtabs %} -`Notification` is a sealed trait which has three concrete Notification types implemented with case classes `Email`, `SMS`, and `VoiceRecording`. Now we can do pattern matching on these case classes: +`Notification` is a sealed trait which has three concrete Notification types implemented with case classes `Email`, `SMS`, and `VoiceRecording`. (A sealed trait can be extended only in the same file as its declaration.) Now we can do pattern matching on these case classes: {% tabs pattern-matching-4 class=tabs-scala-version %} {% tab 'Scala 2' for=pattern-matching-4 %} From 98f7516e28b7138c2c17fa550577231bb7c6f786 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Fri, 13 Dec 2024 07:07:18 -0800 Subject: [PATCH 2986/3075] profile is verified now --- _data/footer.yml | 2 +- _overviews/contribute/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_data/footer.yml b/_data/footer.yml index da38a4f118..789017f8b9 100644 --- a/_data/footer.yml +++ b/_data/footer.yml @@ -59,7 +59,7 @@ - title: Mastodon url: "https://fosstodon.org/@scala_lang" - title: Bluesky - url: "https://bsky.app/profile/scala-lang.bsky.social" + url: "https://bsky.app/profile/scala-lang.org" - title: X url: "https://x.com/scala_lang" - title: Discord diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index 329861a72f..0e7906e0dc 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -276,7 +276,7 @@ The above benefits are something good to achieve regardless of your level of exp be improved. For best results, spend a lot of time with the library to get a feel of what's important and what can improve. - **Lookout for announcements:** You may want to keep an eye on the Scala Center - [LinkedIn](https://www.linkedin.com/company/scala-center/) and [Bluesky](https://bsky.app/profile/scala-lang.bsky.social) or [X](https://x.com/scala_lang) to stay up-to-date with the possible contribution opportunities. For example, every year, the Scala Center participates + [LinkedIn](https://www.linkedin.com/company/scala-center/) and [Bluesky](https://bsky.app/profile/scala-lang.org) or [X](https://x.com/scala_lang) to stay up-to-date with the possible contribution opportunities. For example, every year, the Scala Center participates in the Google Summer of Code program where you are paid to work on open source Scala projects over the course of summer. {{backButton}} From 6222097a13a25491428e6584c4e7604552f2e5be Mon Sep 17 00:00:00 2001 From: Erik Pohl <89852209+ErikPohl444@users.noreply.github.com> Date: Fri, 13 Dec 2024 10:13:59 -0500 Subject: [PATCH 2987/3075] Update pattern-matching.md Added a link to sealed types below --- _tour/pattern-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index 340742d1c9..d49f4492c4 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -92,7 +92,7 @@ case class VoiceRecording(contactName: String, link: String) extends Notificatio {% endtab %} {% endtabs %} -`Notification` is a sealed trait which has three concrete Notification types implemented with case classes `Email`, `SMS`, and `VoiceRecording`. (A sealed trait can be extended only in the same file as its declaration.) Now we can do pattern matching on these case classes: +`Notification` is a sealed trait which has three concrete Notification types implemented with case classes `Email`, `SMS`, and `VoiceRecording`. (A [sealed trait](#Sealed-types) can be extended only in the same file as its declaration.) Now we can do pattern matching on these case classes: {% tabs pattern-matching-4 class=tabs-scala-version %} {% tab 'Scala 2' for=pattern-matching-4 %} From c7a41586a2fdad2e5ba59cb12e5a13378536c359 Mon Sep 17 00:00:00 2001 From: Erik Pohl <89852209+ErikPohl444@users.noreply.github.com> Date: Fri, 13 Dec 2024 10:57:04 -0500 Subject: [PATCH 2988/3075] Update singleton-objects.md Added a note about 'Option', 'Some', and 'None' --- _tour/singleton-objects.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/_tour/singleton-objects.md b/_tour/singleton-objects.md index 47a67ee175..431347bdb0 100644 --- a/_tour/singleton-objects.md +++ b/_tour/singleton-objects.md @@ -196,6 +196,14 @@ scalaCenterEmail match The `object Email` contains a factory `fromString` which creates an `Email` instance from a String. We return it as an `Option[Email]` in case of parsing errors. +A note about `Option`, `Some`, and `None` in the code above: +* `Option` is a data type which allows for optionality. It has two cases: `Some` and `None` + * `Some` above represents a match: the emailString, when split by a @, returns an array with two components. This allows creation of a valid instance of class Email. + * `None` above represents no match: the emailString, when split by a @, did not return an array with two components. It could not allow creation of a valid instance of class Email. +* The `Option` return type can then be used in a match/case: + * For a `Some` result, the match knows the return type is a valid instance of Email and can populate the value email with that instance. + * For a `None` result, the match knows the return type is not a valid instance of Email, so it can print an appropriate error message. + Note: If a class or object has a companion, both must be defined in the same file. To define companions in the REPL, either define them on the same line or enter `:paste` mode. ## Notes for Java programmers ## From 6932023877c0b1ac1478fcb192cff681ddbc5ba4 Mon Sep 17 00:00:00 2001 From: Erik Pohl <89852209+ErikPohl444@users.noreply.github.com> Date: Mon, 16 Dec 2024 08:42:35 -0500 Subject: [PATCH 2989/3075] Update _tour/singleton-objects.md Thank you for the edit. Accepted. Co-authored-by: adpi2 --- _tour/singleton-objects.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_tour/singleton-objects.md b/_tour/singleton-objects.md index 431347bdb0..828d49a38a 100644 --- a/_tour/singleton-objects.md +++ b/_tour/singleton-objects.md @@ -201,8 +201,8 @@ A note about `Option`, `Some`, and `None` in the code above: * `Some` above represents a match: the emailString, when split by a @, returns an array with two components. This allows creation of a valid instance of class Email. * `None` above represents no match: the emailString, when split by a @, did not return an array with two components. It could not allow creation of a valid instance of class Email. * The `Option` return type can then be used in a match/case: - * For a `Some` result, the match knows the return type is a valid instance of Email and can populate the value email with that instance. - * For a `None` result, the match knows the return type is not a valid instance of Email, so it can print an appropriate error message. + * For a `Some` result, the match knows the returned value is an instance of `Email`, so it can access the inner `username` and `domainName`. + * For a `None` result, the match knows the returned value is not an instance of `Email`, so it prints an appropriate error message. Note: If a class or object has a companion, both must be defined in the same file. To define companions in the REPL, either define them on the same line or enter `:paste` mode. From 66a998f4832d967d5b15c1078110596f038c35b5 Mon Sep 17 00:00:00 2001 From: Erik Pohl <89852209+ErikPohl444@users.noreply.github.com> Date: Mon, 16 Dec 2024 08:44:07 -0500 Subject: [PATCH 2990/3075] Update _tour/pattern-matching.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Thanks for catching this. I learned a bit more about successful markdown links. I accept the edit. Co-authored-by: Gabriel Kępka <44374670+gkepka@users.noreply.github.com> --- _tour/pattern-matching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/pattern-matching.md b/_tour/pattern-matching.md index d49f4492c4..96426e0b06 100644 --- a/_tour/pattern-matching.md +++ b/_tour/pattern-matching.md @@ -92,7 +92,7 @@ case class VoiceRecording(contactName: String, link: String) extends Notificatio {% endtab %} {% endtabs %} -`Notification` is a sealed trait which has three concrete Notification types implemented with case classes `Email`, `SMS`, and `VoiceRecording`. (A [sealed trait](#Sealed-types) can be extended only in the same file as its declaration.) Now we can do pattern matching on these case classes: +`Notification` is a sealed trait which has three concrete Notification types implemented with case classes `Email`, `SMS`, and `VoiceRecording`. (A [sealed trait](/tour/pattern-matching.html#sealed-types) can be extended only in the same file as its declaration.) Now we can do pattern matching on these case classes: {% tabs pattern-matching-4 class=tabs-scala-version %} {% tab 'Scala 2' for=pattern-matching-4 %} From 618dceed3709fdaf3091c2e45a5c35758c2fba6e Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Sat, 21 Dec 2024 00:27:43 +0000 Subject: [PATCH 2991/3075] Update SIPs state --- _sips/sips/eference-able-package-objects.md | 7 +++++++ _sips/sips/xistential-containers.md | 7 +++++++ 2 files changed, 14 insertions(+) create mode 100644 _sips/sips/eference-able-package-objects.md create mode 100644 _sips/sips/xistential-containers.md diff --git a/_sips/sips/eference-able-package-objects.md b/_sips/sips/eference-able-package-objects.md new file mode 100644 index 0000000000..9c6152d290 --- /dev/null +++ b/_sips/sips/eference-able-package-objects.md @@ -0,0 +1,7 @@ +--- +title: 'SIP-68: Reference-able Package Objects' +status: under-review +pull-request-number: 100 +stage: design + +--- diff --git a/_sips/sips/xistential-containers.md b/_sips/sips/xistential-containers.md new file mode 100644 index 0000000000..a3f4764c3e --- /dev/null +++ b/_sips/sips/xistential-containers.md @@ -0,0 +1,7 @@ +--- +title: 'SIP-69: Existential containers' +status: under-review +pull-request-number: 101 +stage: design + +--- From a303021c325ef4ab286ec5fa0b6d837e1b71850d Mon Sep 17 00:00:00 2001 From: Artsiom Kashkou Date: Wed, 25 Dec 2024 15:15:11 +0100 Subject: [PATCH 2992/3075] Change the performance of the Queue prepend operation --- _overviews/collections-2.13/performance-characteristics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/collections-2.13/performance-characteristics.md b/_overviews/collections-2.13/performance-characteristics.md index 9d408add88..ed1885017a 100644 --- a/_overviews/collections-2.13/performance-characteristics.md +++ b/_overviews/collections-2.13/performance-characteristics.md @@ -23,7 +23,7 @@ Performance characteristics of sequence types: | `LazyList` | C | C | L | L | C | L | - | | `ArraySeq` | C | L | C | L | L | L | - | | `Vector` | eC | eC | eC | eC | eC | eC | - | -| `Queue` | aC | aC | L | L | L | C | - | +| `Queue` | aC | aC | L | L | C | C | - | | `Range` | C | C | C | - | - | - | - | | `String` | C | L | C | L | L | L | - | | **mutable** | | | | | | | | From 220dc0aa5a8020cc5286b3896933efa5932f862b Mon Sep 17 00:00:00 2001 From: Evgeny Veretennikov Date: Thu, 26 Dec 2024 12:50:16 +0300 Subject: [PATCH 2993/3075] rm redundant space --- _overviews/scala3-macros/tutorial/macros.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/macros.md b/_overviews/scala3-macros/tutorial/macros.md index 52c7a725d8..1c90c15928 100644 --- a/_overviews/scala3-macros/tutorial/macros.md +++ b/_overviews/scala3-macros/tutorial/macros.md @@ -216,7 +216,7 @@ inline def sumNow(inline nums: Int*): Int = def sumCode(nums: Expr[Seq[Int]])(using Quotes): Expr[Int] = import quotes.reflect.report nums match - case Varargs(numberExprs) => // numberExprs: Seq[Expr[Int]] + case Varargs(numberExprs) => // numberExprs: Seq[Expr[Int]] val numbers: Seq[Int] = numberExprs.map(_.valueOrAbort) Expr(numbers.sum) case _ => report.errorAndAbort( From d94c195ef5c2bbf079f1842c81d01adcbb9a8e8d Mon Sep 17 00:00:00 2001 From: Toxapex4096 <44519859+Toxapex4096@users.noreply.github.com> Date: Wed, 1 Jan 2025 09:33:43 +0900 Subject: [PATCH 2994/3075] Translated Scala Introduction for Python developers to Japanese (#3136) Translated docs to Japanese --- .../scala3-book/scala-for-python-devs.md | 1383 +++++++++++++++++ _ja/overviews/scala3-book/scala4x.css | 54 + 2 files changed, 1437 insertions(+) create mode 100644 _ja/overviews/scala3-book/scala-for-python-devs.md create mode 100644 _ja/overviews/scala3-book/scala4x.css diff --git a/_ja/overviews/scala3-book/scala-for-python-devs.md b/_ja/overviews/scala3-book/scala-for-python-devs.md new file mode 100644 index 0000000000..41b7fc9f38 --- /dev/null +++ b/_ja/overviews/scala3-book/scala-for-python-devs.md @@ -0,0 +1,1383 @@ +--- +title: Scala for Python Developers +type: chapter +description: This page is for Python developers who are interested in learning about Scala 3. +languages: [zh-cn, ja] +num: 76 +previous-page: scala-for-javascript-devs +next-page: where-next +--- + +{% include_relative scala4x.css %} + +
    + +{% comment %} + +NOTE: Hopefully someone with more Python experience can give this a thorough review. + +NOTE: On this page (https://contributors.scala-lang.org/t/feedback-sought-optional-braces/4702/10), Li Haoyi comments: “Python’s success also speaks for itself; beginners certainly don’t pick Python because of performance, ease of installation, packaging, IDE support, or simplicity of the language’s runtime semantics!” I’m not a Python expert, so these points are good to know, though I don’t want to go negative in any comparisons. +It’s more like thinking, “Python developers will appreciate Scala’s performance, ease of installation, packaging, IDE support, etc.” +{% endcomment %} + +{% comment %} +TODO: We should probably go through this document and add links to our other detail pages, when time permits. +{% endcomment %} + +このセクションでは、PythonとScalaのプログラミング言語を比較します。 +Pythonに詳しくて、Scalaについて学びたいと考えているプログラマーを対象としています。具体的には、Pythonの言語機能とScalaの比較例を挙げて説明します。 + +## はじめに + +例に入る前に、この最初のセクションでは、後に続くセクションの簡単な紹介と概要を提供します。 +まず、2つの言語の概要を高レベルで比較し、その後、実践的なプログラミングでの比較を行います。 + +### 高レベルでの類似点 + +高レベルで見ると、ScalaはPythonと以下のような *類似点* を共有しています。 + +- 高水準プログラミング言語であり、ポインタや手動でのメモリ管理といった低レベルの概念を気にする必要がありません。 +- 比較的シンプルで簡潔な構文を持ちます。 +- [関数型プログラミングスタイル][fp-intro]をサポートしています。 +- オブジェクト指向プログラミング（OOP）言語です。 +- 内包表記（comprehensions）をサポートしています。Pythonにはリスト内包表記があり、Scalaには`for`内包表記があります。 +- ラムダ式と[高階関数][hofs]をサポートしています。 +- [Apache Spark](https://spark.apache.org)を用いたビッグデータ処理に使用できます。 +- 優れたライブラリが豊富に使用できます。 + +### 高レベルでの相違点 + +高レベルで見ると、PythonとScalaの間には以下のような _相違点_ があります： + +- Python は動的型付け言語であり、Scala は静的型付け言語です。 + - Pythonは動的型付けですが、型ヒントによる「段階的型付け」をサポートしており、`mypy`のような静的型チェッカーで検証できます。 + - Scalaは静的型付けですが、型推論のような機能により動的言語のような感覚で書けます。 +- Pythonはインタプリタ型で実行され、Scalaのコードはコンパイルされて _.class_ ファイルになり、Java仮想マシン（JVM）上で動作します。 +- JVMでの実行に加えて、[Scala.js](https://www.scala-js.org)によりScalaをJavaScriptの代替として使用することもできます。 +- [Scala Native](https://scala-native.org/)では、「システムレベル」のコードを記述し、ネイティブ実行ファイルにコンパイルできます。 +- Scalaではすべてが _式_ である：`if`文、`for`ループ、`match`式、さらには`try`/`catch`式でさえも、戻り値を持ちます。 +- 慣用的に Scala では不変性を基本とする：不変変数や不変コレクションを使用することが推奨されています。 +- Scalaは[並行・並列プログラミング][concurrency]のサポートが優れています。 + +### プログラミングレベルでの類似点 + +このセクションでは、実際に Python と Scala でコードを書く際に見られる類似点を紹介します。 + +- Scalaの型推論により、動的型付け言語のような感覚でコーディングできます。 +- どちらの言語も式の末尾にセミコロンを使用しません。 +- 中括弧や括弧ではなく、インデントを重要視した記述がサポートされています。 +- メソッド定義の構文が似ています。 +- 両方ともリスト、辞書（マップ）、セット、タプルをサポートしています。 +- マッピングやフィルタリングに対応した内包表記を備えています。 +- 優れたIDEサポートがあります。 +- Scala 3の[トップレベル定義][toplevel]を利用することで、メソッドやフィールド、その他の定義をどこにでも記述できます。 + - 一方で、Pythonはメソッドを1つも宣言しなくても動作できますが、Scala 3ではトップレベルですべてを実現することはできません。たとえば、Scalaアプリケーションを開始するには[mainメソッド][main-method]（`@main def`）が必要です。 + +### プログラミングレベルでの違い + +プログラミングレベルでも、コードを書く際に日常的に見られるいくつかの違いがあります： + +- Scalaでのプログラミングは非常に一貫性があります： + - フィールドやパラメータを定義する際に、`val`と`var`が一貫して使用されます + - リスト、マップ、セット、タプルはすべて同様に作成・アクセスされます。たとえば、他のScalaクラスを作成するのと同様に、すべてのタイプを作成するために括弧が使用されます---`List(1,2,3)`, `Set(1,2,3)`, `Map(1->"one")` + - [コレクションクラス][collections-classes] は一般的にほとんど同じ高階関数を持っています + - パターンマッチングは言語全体で一貫して使用されます + - メソッドに渡される関数を定義するために使用される構文は、匿名関数を定義するために使用される構文と同じです +- Scalaの変数やパラメータは`val`（不変）または `var`（可変）キーワードで定義されます +- 慣用的に、Scala では不変データ構造を使うことを良しとします。 +- コメント： Pythonはコメントに `#` を使用しますが、ScalaはC、C++、Javaスタイルの `//`、`/*...*/`、および `/**...*/` を使用します +- 命名規則： Pythonの標準は `my_list` のようにアンダースコアを使用しますが、Scalaは `myList` を使用します +- Scalaは静的型付けであるため、メソッドパラメータ、メソッドの戻り値、その他の場所で型を宣言します +- パターンマッチングと `match` 式はScalaで広範に使用されており、コードの書き方を変えるでしょう +- トレイト（Traits）： Scalaではトレイトが多用され、Pythonではインターフェースや抽象クラスがあまり使用されません +- Scalaの[コンテキスト抽象][contextual]と _型推論_ は、さまざまな機能のコレクションを提供します： + - [拡張メソッド][extension-methods] により、明確な構文を使用してクラスに新しい機能を簡単に追加できます + - [多元的等価性][multiversal] により、コンパイル時に意味のある比較にのみ等価比較を制限できます +- Scalaには最先端のオープンソース関数型プログラミングライブラリがあります（[“Awesome Scala”リスト](https://github.com/lauris/awesome-scala)を参照） +- オブジェクト、名前渡しパラメータ、中置表記、オプションの括弧、拡張メソッド、高階関数などの機能により、独自の「制御構造」やDSLを作成できます +- ScalaコードはJVM上で実行でき、[Scala Native](https://github.com/scala-native/scala-native)や[GraalVM](https://www.graalvm.org)を使用してネイティブイメージにコンパイルすることも可能で、高性能を実現します +- その他多くの機能：コンパニオンクラスとオブジェクト、マクロ、数値リテラル、複数のパラメータリスト、[交差型][intersection-types]、型レベルプログラミングなど + +### 機能の比較と例 + +この導入に基づき、以下のセクションではPythonとScalaのプログラミング言語機能を並べて比較します。 + +{% comment %} TODO: Pythonの例をスペース四つに更新します。開始しましたが、別のPRで行う方が良いと思いました。 {% endcomment %} + +## コメント + +Pythonはコメントに # を使用しますが、Scalaのコメント構文はC、C++、Javaなどの言語と同じです。 + + + + + + + + + + +
    + # a comment +
    + // a comment +
    /* ... */ +
    /** ... */     +
    + +## 変数の割り当て + +これらの例は、PythonとScalaで変数を作成する方法を示しています。 + +### 整数変数,文字列変数 + + + + + + + + + + +
    + x = 1 +
    x = "Hi" +
    y = """foo +
           bar +
           baz"""     +
    + val x = 1 +
    val x = "Hi" +
    val y = """foo +
               bar +
               baz"""     +
    + +### リスト + + + + + + + + + + +
    + x = [1,2,3] +
    + val x = List(1,2,3) +
    + +### 辞書/マップ + + + + + + + + + + +
    + x = { +
      "Toy Story": 8.3, +
      "Forrest Gump": 8.8, +
      "Cloud Atlas": 7.4 +
    }     +
    + val x = Map( +
      "Toy Story" -> 8.3, +
      "Forrest Gump" -> 8.8, +
      "Cloud Atlas" -> 7.4 +
    )     +
    + +### 集合 + + + + + + + + + + +
    + x = {1,2,3} +
    + val x = Set(1,2,3) +
    + +### タプル + + + + + + + + + + +
    + x = (11, "Eleven") +
    + val x = (11, "Eleven") +
    + +Scalaのフィールドが可変になる場合は、変数定義に `val` の代わりに `var` を使います。 + +```scala +var x = 1 +x += 1 +``` + +しかし、Scalaの慣習として、特に変数を変更する必要がない限り、常に`val`を使います。 + +## 関数型プログラミングスタイルのレコード + +Scalaのケース・クラスはPythonのフローズン・データクラスに似ています。 + +### 構造体の定義 + + + + + + + + + + +
    + from dataclasses import dataclass, replace +
    +
    @dataclass(frozen=True) +
    class Person: +
      name: str +
      age: int     +
    + case class Person(name: String, age: Int) +
    + +### インスタンスを作成して使用する + + + + + + + + + + +
    + p = Person("Alice", 42) +
    p.name   # Alice +
    p2 = replace(p, age=43)     +
    + val p = Person("Alice", 42) +
    p.name   // Alice +
    val p2 = p.copy(age = 43)     +
    + +## オブジェクト指向プログラミングスタイルのクラスとメソッド + +このセクションでは、オブジェクト指向プログラミングスタイルのクラスとメソッドに関する機能の比較を行います。 + +### クラスとプライマリーコンストラクタ + + + + + + + + + + +
    + class Person(object): +
      def __init__(self, name): +
        self.name = name +
    +
      def speak(self): +
        print(f'Hello, my name is {self.name}')     +
    + class Person (var name: String): +
      def speak() = println(s"Hello, my name is $name")     +
    + +### インスタンスを作成して使用する + + + + + + + + + + +
    + p = Person("John") +
    p.name   # John +
    p.name = 'Fred' +
    p.name   # Fred +
    p.speak()     +
    + val p = Person("John") +
    p.name   // John +
    p.name = "Fred" +
    p.name   // Fred +
    p.speak()     +
    + +### 1行メソッド + + + + + + + + + + +
    + def add(a, b): return a + b +
    + def add(a: Int, b: Int): Int = a + b +
    + +### 複数行のメソッド + + + + + + + + + + +
    + def walkThenRun(): +
      print('walk') +
      print('run')     +
    + def walkThenRun() = +
      println("walk") +
      println("run")     +
    + +## インターフェース、トレイト、継承 + +Java 8以降に慣れていれば、ScalaのtraitはJavaのインターフェースに良く似ていることに気づくと思います。 +Pythonのインターフェース（プロトコル）や抽象クラスがあまり使われないのに対して、Scalaではトレイトが常に使われています。 +したがって、この例では両者を比較するのではなく、Scalaのトレイトを使って数学のちょっとした問題を解く方法を紹介します： + +```scala +trait Adder: + def add(a: Int, b: Int) = a + b + +trait Multiplier: + def multiply(a: Int, b: Int) = a * b + +// create a class from the traits +class SimpleMath extends Adder, Multiplier +val sm = new SimpleMath +sm.add(1,1) // 2 +sm.multiply(2,2) // 4 +``` + +クラスやオブジェクトでtraitを使う方法は他にも[たくさんあります][modeling-intro]。 +しかし、これは概念を論理的な動作のグループに整理して、完全な解答を作成するために必要に応じてそれらを統合するために、どのように使うことができるかのちょっとしたアイデアを与えてくれます。 + +## 制御構文 + +ここではPythonとScalaの[制御構文][control-structures]を比較します。 +どちらの言語にも `if`/`else`, `while`, `for` ループ、 `try` といった構文があります。 +加えて、Scala には `match` 式があります。 + +### `if` 文, 1行 + + + + + + + + + + +
    + if x == 1: print(x) +
    + if x == 1 then println(x) +
    + +### `if` 文, 複数行 + + + + + + + + + + +
    + if x == 1: +
      print("x is 1, as you can see:") +
      print(x)     +
    + if x == 1 then +
      println("x is 1, as you can see:") +
      println(x)     +
    + +### if, else if, else: + + + + + + + + + + +
    + if x < 0: +
      print("negative") +
    elif x == 0: +
      print("zero") +
    else: +
      print("positive")     +
    + if x < 0 then +
      println("negative") +
    else if x == 0 then +
      println("zero") +
    else +
      println("positive")     +
    + +### `if` 文からの戻り値 + + + + + + + + + + +
    + min_val = a if a < b else b +
    + val minValue = if a < b then a else b +
    + +### メソッドの本体としての`if` + + + + + + + + + + +
    + def min(a, b): +
      return a if a < b else b     +
    + def min(a: Int, b: Int): Int = +
      if a < b then a else b     +
    + +### `while` ループ + + + + + + + + + + +
    + i = 1 +
    while i < 3: +
      print(i) +
      i += 1     +
    + var i = 1 +
    while i < 3 do +
      println(i) +
      i += 1     +
    + +### rangeを指定した`for` ループ + + + + + + + + + + +
    + for i in range(0,3): +
      print(i)     +
    + // preferred +
    for i <- 0 until 3 do println(i) +
    +
    // also available +
    for (i <- 0 until 3) println(i) +
    +
    // multiline syntax +
    for +
      i <- 0 until 3 +
    do +
      println(i)     +
    + +### リスト範囲内の`for` ループ + + + + + + + + + + +
    + for i in ints: print(i) +
    +
    for i in ints: +
      print(i)     +
    + for i <- ints do println(i) +
    + +### 複数行での`for` ループ + + + + + + + + + + +
    + for i in ints: +
      x = i * 2 +
      print(f"i = {i}, x = {x}")     +
    + for +
      i <- ints +
    do +
      val x = i * 2 +
      println(s"i = $i, x = $x")     +
    + +### 複数の “range” ジェネレータ + + + + + + + + + + +
    + for i in range(1,3): +
      for j in range(4,6): +
        for k in range(1,10,3): +
          print(f"i = {i}, j = {j}, k = {k}")     +
    + for +
      i <- 1 to 2 +
      j <- 4 to 5 +
      k <- 1 until 10 by 3 +
    do +
      println(s"i = $i, j = $j, k = $k")     +
    + +### ガード付きジェネレータ (`if` 式) + + + + + + + + + + +
    + for i in range(1,11): +
      if i % 2 == 0: +
        if i < 5: +
          print(i)     +
    + for +
      i <- 1 to 10 +
      if i % 2 == 0 +
      if i < 5 +
    do +
      println(i)     +
    + +### 行ごとに複数の`if`条件 + + + + + + + + + + +
    + for i in range(1,11): +
      if i % 2 == 0 and i < 5: +
        print(i)     +
    + for +
      i <- 1 to 10 +
      if i % 2 == 0 && i < 5 +
    do +
      println(i)     +
    + +### 内包表記 + + + + + + + + + + +
    + xs = [i * 10 for i in range(1, 4)] +
    # xs: [10,20,30]     +
    + val xs = for i <- 1 to 3 yield i * 10 +
    // xs: Vector(10, 20, 30)     +
    + +### `match` 条件式 + + + + + + + + + + +
    + # From 3.10, Python supports structural pattern matching +
    # You can also use dictionaries for basic “switch” functionality +
    match month: +
      case 1: +
        monthAsString = "January" +
      case 2: +
        monthAsString = "February" +
      case _: +
        monthAsString = "Other"     +
    + val monthAsString = month match +
      case 1 => "January" +
      case 2 => "February" +
      _ => "Other"     +
    + +### switch/match + + + + + + + + + + +
    + # Only from Python 3.10 +
    match i: +
      case 1 | 3 | 5 | 7 | 9: +
        numAsString = "odd" +
      case 2 | 4 | 6 | 8 | 10: +
        numAsString = "even" +
      case _: +
        numAsString = "too big"     +
    + val numAsString = i match +
      case 1 | 3 | 5 | 7 | 9 => "odd" +
      case 2 | 4 | 6 | 8 | 10 => "even" +
      case _ => "too big"     +
    + +### try, catch, finally + + + + + + + + + + +
    + try: +
      print(a) +
    except NameError: +
      print("NameError") +
    except: +
      print("Other") +
    finally: +
      print("Finally")     +
    + try +
      writeTextToFile(text) +
    catch +
      case ioe: IOException => +
        println(ioe.getMessage) +
      case fnf: FileNotFoundException => +
        println(fnf.getMessage) +
    finally +
      println("Finally")     +
    + +マッチ式とパターンマッチは、Scalaプログラミングの大きな要素ですが、ここで紹介しているのは、マッチ式の機能の一部だけです。より多くの例については、[制御構造][control-structures]のページをご覧ください。 + +## コレクションクラス + +このセクションでは、PythonとScalaで利用可能なコレクションクラス[collections classes][collections-classes]を比較します。リスト、辞書/マップ、セット、タプルなどです。 + +### リスト + +Pythonにはリストがあるように、Scalaにはニーズに応じて、可変および不可変な列(Seq)のクラスがいくつか用意されています。 +Pythonのリストは変更可能であるため、Scalaの `ArrayBuffer` によく似ています。 + +### Pythonリスト & Scalaの列(Seq) + + + + + + + + + + +
    + a = [1,2,3] +
    + // use different sequence classes +
    // as needed +
    val a = List(1,2,3) +
    val a = Vector(1,2,3) +
    val a = ArrayBuffer(1,2,3)     +
    + +### リストの要素へのアクセス + + + + + + + + + + +
    + a[0]
    a[1]     +
    + a(0)
    a(1)     // just like all other method calls +
    + +### リストの要素の更新 + + + + + + + + + + +
    + a[0] = 10 +
    a[1] = 20     +
    + // ArrayBuffer is mutable +
    a(0) = 10 +
    a(1) = 20     +
    + +### 2つのリストの結合 + + + + + + + + + + +
    + c = a + b +
    + val c = a ++ b +
    + +### リストの反復処理 + + + + + + + + + + +
    + for i in ints: print(i) +
    +
    for i in ints: +
      print(i)     +
    + // preferred +
    for i <- ints do println(i) +
    +
    // also available +
    for (i <- ints) println(i)     +
    + +Scala の主な列(Seq)クラスは `List`、`Vector`、`ArrayBuffer` です。 +`List` と `Vector` は不変な列が必要なときに使うメインクラスで、 `ArrayBuffer` は可変な列が必要なときに使うメインクラスです。 +(Scala における 「バッファ」 とは、大きくなったり小さくなったりする配列のことです。) + +### 辞書/マップ + +Python の辞書はScala の `Map` クラスのようなものです。 +しかし、Scala のデフォルトのマップは _immutable_ であり、新しいマップを簡単に作成するための変換メソッドを持っています。 + +#### 辞書/マップ の作成 + + + + + + + + + + +
    + my_dict = { +
      'a': 1, +
      'b': 2, +
      'c': 3 +
    }     +
    + val myMap = Map( +
      "a" -> 1, +
      "b" -> 2, +
      "c" -> 3 +
    )     +
    + +#### 辞書/マップの要素へのアクセス + + + + + + + + + + +
    + my_dict['a']   # 1 +
    + myMap("a")   // 1 +
    + +#### `for` ループでの辞書/マップ + + + + + + + + + + +
    + for key, value in my_dict.items(): +
      print(key) +
      print(value)     +
    + for (key,value) <- myMap do +
      println(key) +
      println(value)     +
    + +Scalaには、さまざまなニーズに対応する他の専門的な `Map` クラスがあります。 + +### 集合 + +Pythonの集合は、_mutable_ Scalaの`Set`クラスに似ています。 + +#### 集合の作成 + + + + + + + + + + +
    + set = {"a", "b", "c"} +
    + val set = Set(1,2,3) +
    + +#### 重複する要素 + + + + + + + + + + +
    + set = {1,2,1} +
    # set: {1,2}     +
    + val set = Set(1,2,1) +
    // set: Set(1,2)     +
    + +Scalaには、他にも様々なニーズに特化した`Set`クラスがあります。 + +### タプル + +PythonとScalaのタプルも似ています。 + +#### タプルの作成 + + + + + + + + + + +
    + t = (11, 11.0, "Eleven") +
    + val t = (11, 11.0, "Eleven") +
    + +#### タプルの要素へのアクセス + + + + + + + + + + +
    + t[0]   # 11 +
    t[1]   # 11.0     +
    + t(0)   // 11 +
    t(1)   // 11.0     +
    + +## コレクションクラスでのメソッド + +PythonとScalaには、同じ関数型メソッドがいくつかあります。 + +- `map` +- `filter` +- `reduce` + +Pythonのラムダ式でこれらのメソッドを使うのに慣れていれば、Scalaがコレクション・クラスのメソッドで同じようなアプローチを持っていることがわかると思います。 +この機能を実証するために、ここに2つのサンプルリストを示します。 + +```scala +numbers = [1,2,3] // python +val numbers = List(1,2,3) // scala +``` + +これらのリストは以下の表で使用され、マップ処理とフィルター処理のアルゴリズムを適用する方法を示しています。 + +### マップ処理の内包表記 + + + + + + + + + + +
    + x = [i * 10 for i in numbers] +
    + val x = for i <- numbers yield i * 10 +
    + +### フィルター処理の内包表記 + + + + + + + + + + +
    + evens = [i for i in numbers if i % 2 == 0] +
    + val evens = numbers.filter(_ % 2 == 0) +
    // or +
    val evens = for i <- numbers if i % 2 == 0 yield i     +
    + +### マップ、フィルター処理の内包表記 + + + + + + + + + + +
    + x = [i * 10 for i in numbers if i % 2 == 0] +
    + val x = numbers.filter(_ % 2 == 0).map(_ * 10) +
    // or +
    val x = for i <- numbers if i % 2 == 0 yield i * 10     +
    + +### マップ処理 + + + + + + + + + + +
    + x = map(lambda x: x * 10, numbers) +
    + val x = numbers.map(_ * 10) +
    + +### フィルター処理 + + + + + + + + + + +
    + f = lambda x: x > 1 +
    x = filter(f, numbers)     +
    + val x = numbers.filter(_ > 1) +
    + + +### Scalaのコレクションメソッド + +Scalaのコレクションクラスには100以上の関数メソッドがあり、コードを簡単にすることができます。 +Python では、これらの関数の一部は `itertools` モジュールで利用できます。 +`map`、`filter`、`reduce` に加えて、Scala でよく使われるメソッドを以下に示します。 +これらのメソッドの例では + +- `c` はコレクションです。 +- `p` は述語です。 +- `f` は関数、無名関数、またはメソッドです。 +- `n` は整数値です。 + +これらは利用可能なフィルタリング方法の一部です。 + +|メソッド|説明| +| -------------- | ------------- | +| `c1.diff(c2)` | `c1` と `c2` の要素の差分を返します。| +| `c.distinct` | `c` の重複しない要素を返します。| +| `c.drop(n)` | 最初の `n` 要素を除くコレクションのすべての要素を返します。| +| `c.filter(p)` | コレクションから、その述語が `true` となるすべての要素を返します。| +| `c.head` | コレクションの最初の要素を返します。 (コレクションが空の場合は `NoSuchElementException` をスローします。)| +| `c.tail` | コレクションから最初の要素を除くすべての要素を返します。 (コレクションが空の場合は `UnsupportedOperationException` をスローします。)| +| `c.take(n)` | コレクション `c` の最初の `n` 個の要素を返します。 +以下に、いくつかのトランスフォーマメソッドを示します。| +|メソッド| 説明 | +| --------------- | ------------- +| `c.flatten` | コレクションのコレクション（リストのリストなど）を単一のコレクション（単一のリスト）に変換します。| +| `c.flatMap(f)` | コレクション `c` のすべての要素に `f` を適用し（`map` のような動作）、その結果のコレクションの要素を平坦化して、新しいコレクションを返します。| +| `c.map(f)` | コレクション `c` のすべての要素に `f` を適用して、新しいコレクションを作成します。| +| `c.reduce(f)` | 「リダクション」関数 `f` を `c` の連続する要素に適用し、単一の値を生成します。| +| `c.sortWith(f)` | 比較関数 `f` によってソートされた `c` のバージョンを返します。| +よく使われるグループ化メソッド： +| メソッド | 説明 | +| ---------------- | ------------- +| `c.groupBy(f)` | コレクションを `f` に従って分割し、コレクションの `Map` を作成します。| +| `c.partition(p)` | 述語 `p` に従って2つのコレクションを返します。| +| `c.span(p)` | 2つのコレクションからなるコレクションを返します。1つ目は `c.takeWhile(p)` によって作成され、2つ目は `c.dropWhile(p)` によって作成されます。| +| `c.splitAt(n)` | コレクション `c` を要素 `n` で分割して、2つのコレクションからなるコレクションを返します。| +情報および数学的なメソッド： +| メソッド | 説明 | +| -------------- | ------------- | +| `c1.containsSlice(c2)` | `c1` がシーケンス `c2` を含む場合に `true` を返します。| +| `c.count(p)` | `p` が `true` である `c` の要素数を数えます。| +| `c.distinct` | `c` の一意な要素を返します。| +| `c.exists(p)` | コレクション内のいずれかの要素に対して `p` が `true` であれば `true` を返します。| +| `c.find(p)` | `p` に一致する最初の要素を返します。 要素は `Option[A]` として返されます。| +| `c.min` | コレクションから最小の要素を返します。 (_java.lang.UnsupportedOperationException_例外が発生する場合があります。)| +| `c.max` | コレクションから最大の要素を返します。 (_java.lang.UnsupportedOperationException_例外が発生する場合があります。)| +| `c slice(from, to)` | 要素 `from` から始まり、要素 `to` で終わる要素の範囲を返します。| +| `c.sum` | コレクション内のすべての要素の合計を返しますw。 (コレクション内の要素に対して `Ordering` を定義する必要があります。)| + +以下に、これらのメソッドがリスト上でどのように機能するかを説明する例をいくつか示します。 + +```scala +val a = List(10, 20, 30, 40, 10) // List(10, 20, 30, 40, 10) +a.distinct // List(10, 20, 30, 40) +a.drop(2) // List(30, 40, 10) +a.dropRight(2) // List(10, 20, 30) +a.dropWhile(_ < 25) // List(30, 40, 10) +a.filter(_ < 25) // List(10, 20, 10) +a.filter(_ > 100) // List() +a.find(_ > 20) // Some(30) +a.head // 10 +a.headOption // Some(10) +a.init // List(10, 20, 30, 40) +a.intersect(List(19,20,21)) // List(20) +a.last // 10 +a.lastOption // Some(10) +a.slice(2,4) // List(30, 40) +a.tail // List(20, 30, 40, 10) +a.take(3) // List(10, 20, 30) +a.takeRight(2) // List(40, 10) +a.takeWhile(_ < 30) // List(10, 20) +``` + +これらのメソッドは、Scalaにおける共通のパターンを示しています。オブジェクト上で利用可能な機能メソッドです。 +これらの方法はいずれも、初期リスト `a` を変更しません。代わりに、コメントの後に示されているデータをすべて返します。 +利用可能なメソッドは他にもたくさんありますが、これらの説明と例が、組み込みのコレクションメソッドの持つ力を実感する一助となれば幸いです。 + +## 列挙 + +このセクションでは、PythonとScala 3の列挙型を比較します。 + +### 列挙型の作成 + + + + + + + + + + +
    + from enum import Enum, auto +
    class Color(Enum): +
        RED = auto() +
        GREEN = auto() +
        BLUE = auto()     +
    + enum Color: +
      case Red, Green, Blue     +
    + +### 値とその比較 + + + + + + + + + + +
    + Color.RED == Color.BLUE  # False +
    + Color.Red == Color.Blue  // false +
    + +### パラメータ化された列挙型 + + + + + + + + + + +
    + N/A +
    + enum Color(val rgb: Int): +
      case Red   extends Color(0xFF0000) +
      case Green extends Color(0x00FF00) +
      case Blue  extends Color(0x0000FF)     +
    + +### ユーザー定義による列挙メンバー + + + + + + + + + + +
    + N/A +
    + enum Planet( +
        mass: Double, +
        radius: Double +
      ): +
      case Mercury extends +
        Planet(3.303e+23, 2.4397e6) +
      case Venus extends +
        Planet(4.869e+24, 6.0518e6) +
      case Earth extends +
        Planet(5.976e+24, 6.37814e6) +
      // more planets ... +
    +
      // fields and methods +
      private final val G = 6.67300E-11 +
      def surfaceGravity = G * mass / +
        (radius * radius) +
      def surfaceWeight(otherMass: Double) +
        = otherMass * surfaceGravity     +
    + +## Scala 独自の概念 + +Scalaには、Pythonには現在同等の機能がない概念が他にもあります。 +詳細は以下のリンクを参照してください。 +- 拡張メソッド（extension methods）、型クラス（type classes）、暗黙的値（implicit values）など、文脈依存の抽象化（contextual abstractions）に関連するほとんどの概念 +- Scalaでは複数のパラメータリストを使用できるため、部分適用関数などの機能や独自のDSLを作成することが可能 +- 独自の制御構造や DSL を作成できる機能 +- [多様等価][多様等価]: どの等価比較が意味を持つかをコンパイル時に制御できる機能 +- インフィックスメソッド +- マクロ + +## Scala と仮想環境 + +Scalaでは、Pythonの仮想環境に相当するものを明示的に設定する必要はありません。デフォルトでは、Scalaのビルドツールがプロジェクトの依存関係を管理するため、ユーザーは手動でパッケージをインストールする必要がありません。例えば、`sbt`ビルドツールを使用する場合、`build.sbt`ファイルの`libraryDependencies`設定で依存関係を指定し、 + +``` +cd myapp +sbt compile +``` + +以上のコマンドを実行することで、その特定のプロジェクトに必要なすべての依存関係が自動的に解決されます。 +ダウンロードされた依存関係の場所は、主にビルドツールの実装の詳細であり、ユーザーはこれらのダウンロードされた依存関係と直接やりとりする必要はありません。 +例えば、sbtの依存関係キャッシュ全体を削除した場合、プロジェクトの次のコンパイル時には、sbtが自動的に必要な依存関係をすべて解決し、ダウンロードし直します。 +これはPythonとは異なります。Pythonではデフォルトで依存関係がシステム全体またはユーザー全体のディレクトリにインストールされるため、プロジェクトごとに独立した環境を取得するには、対応する仮想環境を作成する必要があります。 +例えば、`venv`モジュールを使用して、特定のプロジェクト用に次のように仮想環境を作成できます。 + +``` +cd myapp +python3 -m venv myapp-env +source myapp-env/bin/activate +pip install -r requirements.txt +``` + +これにより、プロジェクトの `myapp/myapp-env` ディレクトリにすべての依存関係がインストールされ、シェル環境変数 `PATH` が変更されて、依存関係が `myapp-env` から参照されるようになります。 +Scalaでは、このような手動での作業は一切必要ありません。 + +[collections-classes]: {% link _overviews/scala3-book/collections-classes.md %} +[concurrency]: {% link _overviews/scala3-book/concurrency.md %} +[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %} +[control-structures]: {% link _overviews/scala3-book/control-structures.md %} +[extension-methods]: {% link _overviews/scala3-book/ca-extension-methods.md %} +[fp-intro]: {% link _overviews/scala3-book/fp-intro.md %} +[hofs]: {% link _overviews/scala3-book/fun-hofs.md %} +[intersection-types]: {% link _overviews/scala3-book/types-intersection.md %} +[main-method]: {% link _overviews/scala3-book/methods-main-methods.md %} +[modeling-intro]: {% link _overviews/scala3-book/domain-modeling-intro.md %} +[multiversal]: {% link _overviews/scala3-book/ca-multiversal-equality.md %} +[toplevel]: {% link _overviews/scala3-book/taste-toplevel-definitions.md %} +[type-classes]: {% link _overviews/scala3-book/ca-type-classes.md %} +[union-types]: {% link _overviews/scala3-book/types-union.md %} +
    diff --git a/_ja/overviews/scala3-book/scala4x.css b/_ja/overviews/scala3-book/scala4x.css new file mode 100644 index 0000000000..1772c03ac8 --- /dev/null +++ b/_ja/overviews/scala3-book/scala4x.css @@ -0,0 +1,54 @@ + + + From 5c5126644d0191f0099d9561d466a89a6d066c6c Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 7 Jan 2025 12:20:17 -0800 Subject: [PATCH 2995/3075] add scala-cli to build tool table --- _overviews/jdk-compatibility/overview.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 5ac2a6d36a..3dfc339858 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -29,17 +29,17 @@ Using the latest patch version of your chosen Scala version line is always recom Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platform-subscription) for Scala 2. The linked page includes contact information for inquiring about supported and recommended versions. -## Build tool compatibility table +## Tooling compatibility table Minimum working versions: -| JDK | sbt | mill | -|:-----------:|:---------------:|:-----------| -| 23 | 1.9.0 | 0.11.8 | -| 21 (LTS) | 1.9.0 | 0.11.5 | -| 17 (LTS) | 1.6.0 | 0.7.0 | -| 11 (LTS) | 1.1.0 | 0.1.5 | -| 8 (LTS) | 1.0.0 | 0.1.0 | +| JDK | scala-cli | sbt | mill | +|:-----------:|:----------:|:---------:|:-----------| +| 23 | 1.4.1 | 1.9.0 | 0.11.8 | +| 21 (LTS) | 1.0.0 | 1.9.0 | 0.11.5 | +| 17 (LTS) | 1.0.0 | 1.6.0 | 0.7.0 | +| 11 (LTS) | 1.0.0 | 1.1.0 | 0.1.5 | +| 8 (LTS) | 1.0.0 | 1.0.0 | 0.1.0 | Even when a version combination isn't listed as supported, most features might still work. From 0eee0d6fd20ef19e31dc614b7ae8b0b8402a3ac2 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 7 Jan 2025 12:21:50 -0800 Subject: [PATCH 2996/3075] Lightbend -> Akka --- _overviews/jdk-compatibility/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 3dfc339858..b2f59d35f0 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -27,7 +27,7 @@ Even when a version combination isn't listed as supported, most features might s Using the latest patch version of your chosen Scala version line is always recommended. -Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platform-subscription) for Scala 2. The linked page includes contact information for inquiring about supported and recommended versions. +Akka offers [commercial support](https://akka.io/pricing) for Scala 2. The linked page includes contact information for inquiring about supported and recommended versions. ## Tooling compatibility table @@ -60,7 +60,7 @@ After Java 8, Oracle introduced the concept of LTS versions of the JDK. These ve JDK 8, 11, 17, and 21 are LTS versions. (The next LTS version will be 25.) -Scala provides experimental support for running the Scala compiler on non-LTS versions of the JDK. The current LTS versions are normally tested in our CI matrix and by the Scala community build. We may also test non-LTS versions, but any issues found there are considered lower priority, and will not be considered release blockers. (Lightbend may be able to offer faster resolution of issues like this under commercial support.) +Scala provides experimental support for running the Scala compiler on non-LTS versions of the JDK. The current LTS versions are normally tested in our CI matrix and by the Scala community build. We may also test non-LTS versions, but any issues found there are considered lower priority, and will not be considered release blockers. (The Scala team at Akka may be able to offer faster resolution of issues like this under commercial support.) As already mentioned, Scala code compiled on JDK 8 should run without problems in later JVMs. We will give higher priority to bugs that break this property. (For example, in 2.13.x we might eventually provide support for JPMS module access checks, to ensure your code won't incur `LinkageErrors` due to module access violations.) From fe25deadd1ad737df7e8d09836872c5f2fcfcf36 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 7 Jan 2025 15:09:33 -0600 Subject: [PATCH 2997/3075] add JDK 24 to compat page (#3140) --- _overviews/jdk-compatibility/overview.md | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index b2f59d35f0..b6aba75994 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,8 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 23 | 3.6.2 | 3.3.5 | 2.13.15 | 2.12.20 | | +| 24 (ea) | 3.6.x? 3.7.x?
    (forthcoming) | 3.3.5?
    (forthcoming) | 2.13.16
    (forthcoming) | 2.12.21
    (forthcoming) | | +| 23 | 3.6.2 | 3.3.5
    (forthcoming) | 2.13.15 | 2.12.20 | | | 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 3.3.0 | 2.13.6 | 2.12.15 | | @@ -115,10 +116,7 @@ For possible Scala issues, see the [jdk11](https://github.com/scala/bug/labels/j JDK 22 is non-LTS. -Scala 2.13.13+ and 2.12.19+ support JDK 22. - -We are working on adding JDK 22 support to the 3.3.x release -series. (Support may be available in nightly builds.) +Scala 2.13.13+, 2.12.19+, 3.3.4+, and 3.6.2+ support JDK 22. For possible Scala 2 issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. @@ -126,13 +124,21 @@ For possible Scala 2 issues, see the [jdk11](https://github.com/scala/bug/labels JDK 23 is non-LTS. -Scala 2.13.15+ and Scala 2.12.20+ support JDK 23. +Scala 2.13.15+, Scala 2.12.20+, and Scala 3.6.2+ support JDK 23. -We are working on adding JDK 23 support to Scala 3. +We are working on adding JDK 23 support to Scala 3.3.x. (Support may be available in nightly builds and/or release candidates.) For possible Scala 2 issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. +## JDK 24 compatibility notes + +JDK 24 will be non-LTS. + +Scala 2.13.16 (forthcoming) and Scala 2.12.21 (forthcoming) will support JDK 24. We are also working on adding JDK 24 support to Scala 3. (Support may be available in nightly builds and/or release candidates.) + +For possible Scala 2 issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. + ## GraalVM Native Image compatibility notes There are several records of successfully using Scala with [GraalVM](https://www.graalvm.org) Native Image (i.e., ahead of time compiler) to produce directly executable binaries. From 33034f007c17969d6d048288fde7b670e0ed3da6 Mon Sep 17 00:00:00 2001 From: keyno63 Date: Wed, 8 Jan 2025 07:33:52 +0900 Subject: [PATCH 2998/3075] update scalatest version to latest (3.2.19) in japanese --- .../intellij-track/testing-scala-in-intellij-with-scalatest.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_ja/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index 2af1906295..815760672c 100644 --- a/_ja/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_ja/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -16,7 +16,7 @@ Scala には複数のライブラリとテスト方法がありますが、こ 1. ScalaTest への依存を追加します。 1. `build.sbt` ファイルに ScalaTest への依存を追加します。 ``` - libraryDependencies += "org.scalatest" %% "scalatest" % "3.0.8" % Test + libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.19" % Test ``` 1. `build.sbt was changed` という通知が出たら、**auto-import** を選択します。 1. これらの2つのアクションにより、`sbt` が ScalaTest ライブラリをダウンロードします。 From d74b2c333b58985e369d5f9a3a3569aeadb2d5b3 Mon Sep 17 00:00:00 2001 From: keyno63 Date: Wed, 8 Jan 2025 07:34:05 +0900 Subject: [PATCH 2999/3075] update scalatest version --- .../testing-scala-in-intellij-with-scalatest.md | 2 +- _overviews/scala-book/sbt-scalatest-tdd.md | 4 ++-- _overviews/scala3-book/tools-sbt.md | 2 +- _overviews/scala3-migration/tutorial-prerequisites.md | 2 +- .../testing-scala-in-intellij-with-scalatest.md | 2 +- _ru/scala3/book/tools-sbt.md | 2 +- .../testing-scala-in-intellij-with-scalatest.md | 2 +- _zh-cn/overviews/scala3-book/tools-sbt.md | 2 +- 8 files changed, 9 insertions(+), 9 deletions(-) diff --git a/_overviews/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_overviews/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index e7af916a8d..8a51eca2e0 100644 --- a/_overviews/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_overviews/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -20,7 +20,7 @@ This assumes you know [how to build a project in IntelliJ](building-a-scala-proj 1. Add the ScalaTest dependency: 1. Add the ScalaTest dependency to your `build.sbt` file: ``` - libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.11" % Test + libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.19" % Test ``` 1. If you get a notification "build.sbt was changed", select **auto-import**. 1. These two actions will cause `sbt` to download the ScalaTest library. diff --git a/_overviews/scala-book/sbt-scalatest-tdd.md b/_overviews/scala-book/sbt-scalatest-tdd.md index 83776d3712..dbdbeeb53c 100644 --- a/_overviews/scala-book/sbt-scalatest-tdd.md +++ b/_overviews/scala-book/sbt-scalatest-tdd.md @@ -39,7 +39,7 @@ version := "1.0" scalaVersion := "{{site.scala-version}}" libraryDependencies += - "org.scalatest" %% "scalatest" % "3.2.11" % Test + "org.scalatest" %% "scalatest" % "3.2.19" % Test ``` @@ -47,7 +47,7 @@ The first three lines of this file are essentially the same as the first example ```scala libraryDependencies += - "org.scalatest" %% "scalatest" % "3.2.11" % Test + "org.scalatest" %% "scalatest" % "3.2.19" % Test ``` >The ScalaTest documentation has always been good, and you can always find the up to date information on what those lines should look like on the [Installing ScalaTest](http://www.scalatest.org/install) page. diff --git a/_overviews/scala3-book/tools-sbt.md b/_overviews/scala3-book/tools-sbt.md index b68ae6632f..34c471f546 100644 --- a/_overviews/scala3-book/tools-sbt.md +++ b/_overviews/scala3-book/tools-sbt.md @@ -369,7 +369,7 @@ version := "0.1" scalaVersion := "{{site.scala-3-version}}" libraryDependencies ++= Seq( - "org.scalatest" %% "scalatest" % "3.2.9" % Test + "org.scalatest" %% "scalatest" % "3.2.19" % Test ) ``` diff --git a/_overviews/scala3-migration/tutorial-prerequisites.md b/_overviews/scala3-migration/tutorial-prerequisites.md index 426377f669..31ae3e79d1 100644 --- a/_overviews/scala3-migration/tutorial-prerequisites.md +++ b/_overviews/scala3-migration/tutorial-prerequisites.md @@ -46,7 +46,7 @@ The dependency to `"scalatest" %% "scalatest" % "3.0.9"` must be upgraded becaus We can upgrade it to version `3.2.7`, which is cross-published in Scala 2.13 and Scala 3. ```scala -libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.7" +libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.19" ``` ## Compiler plugins diff --git a/_ru/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_ru/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index 6de67726fb..7a2ffef8fe 100644 --- a/_ru/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_ru/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -18,7 +18,7 @@ previous-page: /ru/building-a-scala-project-with-intellij-and-sbt 1. Добавьте зависимость ScalaTest: 1. Добавьте зависимость ScalaTest в свой файл `build.sbt`: ``` - libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.11" % Test + libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.19" % Test ``` 1. Если вы получили уведомление "build.sbt was changed", выберите **auto-import**. 1. Эти два действия заставят `sbt` подгрузить библиотеки ScalaTest. diff --git a/_ru/scala3/book/tools-sbt.md b/_ru/scala3/book/tools-sbt.md index be70b9b050..27c838ca80 100644 --- a/_ru/scala3/book/tools-sbt.md +++ b/_ru/scala3/book/tools-sbt.md @@ -365,7 +365,7 @@ version := "0.1" scalaVersion := "{{site.scala-3-version}}" libraryDependencies ++= Seq( - "org.scalatest" %% "scalatest" % "3.2.9" % Test + "org.scalatest" %% "scalatest" % "3.2.19" % Test ) ``` diff --git a/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md b/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md index de7135cf1b..b2e1a9f801 100644 --- a/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md +++ b/_uk/getting-started/intellij-track/testing-scala-in-intellij-with-scalatest.md @@ -18,7 +18,7 @@ previous-page: /uk/building-a-scala-project-with-intellij-and-sbt 1. Додайте залежність ScalaTest: 1. Додайте залежність ScalaTest у файл `build.sbt` вашого проєкту: ``` - libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.11" % Test + libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.19" % Test ``` 1. Ви побачите сповіщення "build.sbt was changed", оберіть **auto-import**. 1. Ці дві дії призведуть до того, що `sbt` завантажить бібліотеку ScalaTest. diff --git a/_zh-cn/overviews/scala3-book/tools-sbt.md b/_zh-cn/overviews/scala3-book/tools-sbt.md index d77b8d6286..0d9b5ab08d 100644 --- a/_zh-cn/overviews/scala3-book/tools-sbt.md +++ b/_zh-cn/overviews/scala3-book/tools-sbt.md @@ -361,7 +361,7 @@ version := "0.1" scalaVersion := "{{site.scala-3-version}}" libraryDependencies ++= Seq( - "org.scalatest" %% "scalatest" % "3.2.9" % Test + "org.scalatest" %% "scalatest" % "3.2.19" % Test ) ``` From 0527c98a56bf6df4b46c352d54a2e8c956f0d62a Mon Sep 17 00:00:00 2001 From: keyno63 Date: Wed, 8 Jan 2025 07:38:04 +0900 Subject: [PATCH 3000/3075] fix add-guide file link in contribute --- contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute.md b/contribute.md index 02a8e4b8d7..90f094359a 100644 --- a/contribute.md +++ b/contribute.md @@ -23,4 +23,4 @@ If you're interested in contributing to the Scala project in general, I argue th ## How Can I Contribute? -Please read: [Add New Guides/Tutorials](/contribute/add-guides.html) +Please read: [Add New Guides/Tutorials](/_overviews/contribute/add-guides.md) From 385efcf6b71da7552bffea3681a0b781f60d40c4 Mon Sep 17 00:00:00 2001 From: keyno63 Date: Wed, 8 Jan 2025 08:03:12 +0900 Subject: [PATCH 3001/3075] update scalatest version, in description --- _overviews/scala3-migration/tutorial-prerequisites.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-migration/tutorial-prerequisites.md b/_overviews/scala3-migration/tutorial-prerequisites.md index 31ae3e79d1..55c1c3fe42 100644 --- a/_overviews/scala3-migration/tutorial-prerequisites.md +++ b/_overviews/scala3-migration/tutorial-prerequisites.md @@ -43,7 +43,7 @@ The dependency to `"scalatest" %% "scalatest" % "3.0.9"` must be upgraded becaus - The `scalatest` API is based on some macro definitions. - The `3.0.9` version is not published for Scala 3. -We can upgrade it to version `3.2.7`, which is cross-published in Scala 2.13 and Scala 3. +We can upgrade it to version `3.2.19`, which is cross-published in Scala 2.13 and Scala 3. ```scala libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.19" From 2622032b76e9a0a7e87c4f1c2efda47fbe918638 Mon Sep 17 00:00:00 2001 From: keyno63 Date: Wed, 8 Jan 2025 11:41:03 +0900 Subject: [PATCH 3002/3075] change relative path to http url --- contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute.md b/contribute.md index 90f094359a..3ac938c17b 100644 --- a/contribute.md +++ b/contribute.md @@ -23,4 +23,4 @@ If you're interested in contributing to the Scala project in general, I argue th ## How Can I Contribute? -Please read: [Add New Guides/Tutorials](/_overviews/contribute/add-guides.md) +Please read: [Add New Guides/Tutorials](https://docs.scala-lang.org/contribute/add-guides.html) From f9e963c991224e343e545fa31a5f57a10078ab89 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 15 Jan 2025 15:54:37 -0800 Subject: [PATCH 3003/3075] Scala 2.13.16 (#3143) --- _config.yml | 2 +- _overviews/FAQ/index.md | 4 ++-- _overviews/contribute/bug-reporting-guide.md | 2 +- .../core/binary-compatibility-of-scala-releases.md | 4 ++-- _overviews/jdk-compatibility/overview.md | 4 ++-- api/all.md | 12 ++++++++---- scripts/run-mdoc.sh | 4 ++-- 7 files changed, 18 insertions(+), 14 deletions(-) diff --git a/_config.yml b/_config.yml index 7c1596695a..c1157bb0ab 100644 --- a/_config.yml +++ b/_config.yml @@ -15,7 +15,7 @@ keywords: - Document - Guide -scala-version: 2.13.15 +scala-version: 2.13.16 scala-212-version: 2.12.20 scala-3-version: 3.6.2 diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index d800d3dd82..66ace60490 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -351,14 +351,14 @@ setting in a multi-project build. For example, if you add this to your `build.sbt`: - scalaVersion := "2.13.15" + scalaVersion := "2.13.16" that's a "bare" setting, and you might expect it to apply build-wide. But it doesn't. _It only applies to the root project._ In many cases one should instead write: - ThisBuild / scalaVersion := "2.13.15" + ThisBuild / scalaVersion := "2.13.16" Other possibilities include: diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md index 2f50958675..20dd04546c 100644 --- a/_overviews/contribute/bug-reporting-guide.md +++ b/_overviews/contribute/bug-reporting-guide.md @@ -65,7 +65,7 @@ If you cannot find your issue in the issue tracker, create a new bug. The detail Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - 1. **Exact Scala version** that you are using. For example, `2.13.15` or `3.3.4`. If the bug happens in multiple versions indicate all of them. + 1. **Exact Scala version** that you are using. For example, `2.13.16` or `3.3.4`. If the bug happens in multiple versions indicate all of them. 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? diff --git a/_overviews/core/binary-compatibility-of-scala-releases.md b/_overviews/core/binary-compatibility-of-scala-releases.md index e65407c926..f72d3979fd 100644 --- a/_overviews/core/binary-compatibility-of-scala-releases.md +++ b/_overviews/core/binary-compatibility-of-scala-releases.md @@ -20,10 +20,10 @@ We distinguish forward and backward compatibility (think of these as properties Thus, backward compatibility precludes the removal of (non-private) methods, as older versions could call them, not knowing they would be removed, whereas forward compatibility disallows adding new (non-private) methods, because newer programs may come to depend on them, which would prevent them from running on older versions (private methods are exempted here as well, as their definition and call sites must be in the same source file). #### Guarantees and Versioning -For Scala 2, the *minor* version is the *third* number in a version, e.g., 10 in v2.13.10. +For Scala 2, the *minor* version is the *third* number in a version, e.g., 16 in v2.13.16. The major version is the second number, which is 13 in our example. -Scala 2 up to 2.13.15 guarantees both backward and forward compatibility across *minor* releases within a single major release. +Scala 2 up to 2.13.16 guarantees both backward and forward compatibility across *minor* releases within a single major release. This is about to change now that [SIP-51 has been accepted](https://docs.scala-lang.org/sips/drop-stdlib-forwards-bin-compat.html), future Scala 2.13 releases may be backward compatible only. For Scala 3, the minor version is the *second* number in a version, e.g., 2 in v3.2.1. diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index b6aba75994..cb5e677243 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 24 (ea) | 3.6.x? 3.7.x?
    (forthcoming) | 3.3.5?
    (forthcoming) | 2.13.16
    (forthcoming) | 2.12.21
    (forthcoming) | | +| 24 (ea) | 3.6.x? 3.7.x?
    (forthcoming) | 3.3.5?
    (forthcoming) | 2.13.16 | 2.12.21
    (forthcoming) | | | 23 | 3.6.2 | 3.3.5
    (forthcoming) | 2.13.15 | 2.12.20 | | | 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | @@ -135,7 +135,7 @@ For possible Scala 2 issues, see the [jdk11](https://github.com/scala/bug/labels JDK 24 will be non-LTS. -Scala 2.13.16 (forthcoming) and Scala 2.12.21 (forthcoming) will support JDK 24. We are also working on adding JDK 24 support to Scala 3. (Support may be available in nightly builds and/or release candidates.) +Scala 2.13.16+ supports, and Scala 2.12.21 (forthcoming) will support, JDK 24. We are also working on adding JDK 24 support to Scala 3. (Support may be available in nightly builds and/or release candidates.) For possible Scala 2 issues, see the [jdk11](https://github.com/scala/bug/labels/jdk11), [jdk17](https://github.com/scala/bug/labels/jdk17), and [jdk21](https://github.com/scala/bug/labels/jdk21) labels in the Scala 2 bug tracker. diff --git a/api/all.md b/api/all.md index 5c9c54ed88..024f88c005 100644 --- a/api/all.md +++ b/api/all.md @@ -12,10 +12,10 @@ redirect_from: * [Library API](https://www.scala-lang.org/api/{{site.scala-3-version}}/) * Scala 3.3.4 LTS * [Library API](https://www.scala-lang.org/api/3.3.4/) -* Scala 2.13.15 - * [Library API](https://www.scala-lang.org/api/2.13.15/) - * [Compiler API](https://www.scala-lang.org/api/2.13.15/scala-compiler/scala/) - * [Reflection API](https://www.scala-lang.org/api/2.13.15/scala-reflect/scala/reflect/) +* Scala 2.13.16 + * [Library API](https://www.scala-lang.org/api/2.13.16/) + * [Compiler API](https://www.scala-lang.org/api/2.13.16/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.16/scala-reflect/scala/reflect/) * Scala 2.12.20 * [Library API](https://www.scala-lang.org/api/2.12.20/) * [Compiler API](https://www.scala-lang.org/api/2.12.20/scala-compiler/scala/) @@ -104,6 +104,10 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.0.1/) * Scala 3.0.0 * [Library API](https://www.scala-lang.org/api/3.0.0/) +* Scala 2.13.15 + * [Library API](https://www.scala-lang.org/api/2.13.15/) + * [Compiler API](https://www.scala-lang.org/api/2.13.15/scala-compiler/scala/) + * [Reflection API](https://www.scala-lang.org/api/2.13.15/scala-reflect/scala/reflect/) * Scala 2.13.14 * [Library API](https://www.scala-lang.org/api/2.13.14/) * [Compiler API](https://www.scala-lang.org/api/2.13.14/scala-compiler/scala/) diff --git a/scripts/run-mdoc.sh b/scripts/run-mdoc.sh index 6d729df4f1..fc478f83d5 100755 --- a/scripts/run-mdoc.sh +++ b/scripts/run-mdoc.sh @@ -1,11 +1,11 @@ #!/bin/bash set -eux -cs launch --scala-version 2.13.15 org.scalameta::mdoc:2.3.3 -- \ +cs launch --scala-version 2.13.16 org.scalameta::mdoc:2.3.3 -- \ --in . \ --out /tmp/mdoc-out/ \ --classpath \ - $(cs fetch --scala-version 2.13.15 -p \ + $(cs fetch --scala-version 2.13.16 -p \ com.chuusai::shapeless:2.3.10 \ org.scala-lang::toolkit:0.1.7 \ org.scala-lang::toolkit-test:0.1.7 \ From 606cd7d7c3bc717f7bfd3daefc692e2296b7172b Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Thu, 16 Jan 2025 13:11:52 -0800 Subject: [PATCH 3004/3075] FAQ: add a sentence to stdlib version number question --- _overviews/FAQ/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 66ace60490..35b99ef0a0 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -143,6 +143,8 @@ REPL, but won't work in typical Scala 3 application code. For an alternative way to detect the Scala 3 version, see [this gist](https://gist.github.com/romanowski/de14691cab7340134e197419bc48919a). +There is a proposal to provide something easier at [scala/scala3#22144](https://github.com/scala/scala3/issues/22144). + ### Why is my (abstract or overridden) `val` null? -We propose to extend eta-expansion to polymorphic methods. +We propose to extend eta-expansion to polymorphic methods. This means automatically transforming polymorphic methods into corresponding polymorphic functions when required, for example: ~~~ scala @@ -44,10 +44,10 @@ This section should clearly express the scope of the proposal. It should make it Regular eta-expansion is so ubiquitous that most users are not aware of it, for them it is intuitive and obvious that methods can be passed where functions are expected. -When manipulating polymorphic methods, we wager that most users find it confusing not to be able to do the same. +When manipulating polymorphic methods, we wager that most users find it confusing not to be able to do the same. This is the main motivation of this proposal. -It however remains to be demonstrated that such cases appear often enough for time and maintenance to be devoted to fixing it. +It however remains to be demonstrated that such cases appear often enough for time and maintenance to be devoted to fixing it. To this end, the remainder of this section will show a manufactured example with tuples, as well as real-world examples taken from the [Shapeless-3](https://index.scala-lang.org/typelevel/shapeless-3) and [kittens](https://index.scala-lang.org/typelevel/kittens) libraries. @@ -89,7 +89,7 @@ There is however the following case, where a function is very large: case (acc, Some(t)) => Some((t, acc._1)) } } -~~~ +~~~ By factoring out the function, it is possible to make the code more readable: @@ -113,7 +113,7 @@ By factoring out the function, it is possible to make the code more readable: case (acc, Some(t)) => Some((t, acc._1)) } } -~~~ +~~~ It is natural at this point to want to transform the function into a method, as the syntax for the latter is more familiar, and more readable: @@ -139,7 +139,7 @@ It is natural at this point to want to transform the function into a method, as } ~~~ -However, this does not compile. +However, this does not compile. Only monomorphic eta-expansion is applied, leading to the same issue as with our previous `Tuple.map` example. #### Kittens ([source](https://github.com/typelevel/kittens/blob/e10a03455ac3dd52096a1edf0fe6d4196a8e2cad/core/src/main/scala-3/cats/derived/DerivedTraverse.scala#L44-L48)) @@ -251,7 +251,7 @@ For example, if the syntax of the language is changed, this section should list Before we go on, it is important to clarify what we mean by "polymorphic method", we do not mean, as one would expect, "a method taking at least one type parameter clause", but rather "a (potentially partially applied) method whose next clause is a type clause", here is an example to illustrate: -~~~ scala +~~~ scala extension (x: Int) def poly[T](x: T): T = x // signature: (Int)[T](T): T @@ -279,15 +279,15 @@ Note: Polymorphic functions always take term parameters (but `k` can equal zero 1. Copies of `T_i`s are created, and replaced in `U_i`s, `L_i`s, `A_i`s and `R`, noted respectively `T'_i`, `U'_i`, `L'_i`, `A'_i` and `R'`. 2. Is the expected type a polymorphic context function ? -* 1. If yes then `m` is replaced by the following: +* 1. If yes then `m` is replaced by the following: ~~~ scala -[T'_1 <: U'_1 >: L'_1, ... , T'_n <: U'_n >: L'_n] +[T'_1 <: U'_1 >: L'_1, ... , T'_n <: U'_n >: L'_n] => (a_1: A'_1 ..., a_k: A'_k) ?=> m[T'_1, ..., T'_n] ~~~ -* 2. If no then `m` is replaced by the following: +* 2. If no then `m` is replaced by the following: ~~~ scala -[T'_1 <: U'_1 >: L'_1, ... , T'_n <: U'_n >: L'_n] +[T'_1 <: U'_1 >: L'_1, ... , T'_n <: U'_n >: L'_n] => (a_1: A'_1 ..., a_k: A'_k) => m[T'_1, ..., T'_n](a_1, ..., a_k) ~~~ @@ -321,7 +321,7 @@ extension [A](x: A) def foo[B](y: B) = (x, y) val voo: [T] => T => [U] => U => (T, U) = foo -// foo expands to: +// foo expands to: // [T'] => (t: T') => ( foo[T'](t) with expected type [U] => U => (T', U) ) // [T'] => (t: T') => [U'] => (u: U') => foo[T'](t)[U'](u) ~~~ @@ -384,7 +384,7 @@ Not included in this proposal are: * Polymorphic SAM conversion * Polymorphic functions from wildcard: `foo[_](_)` -While all of the above could be argued to be valuable, we deem they are out of the scope of this proposal. +While all of the above could be argued to be valuable, we deem they are out of the scope of this proposal. We encourage the creation of follow-up proposals to motivate their inclusion. diff --git a/_sips/sips/priority-based-infix-type-precedence.md b/_sips/sips/priority-based-infix-type-precedence.md index 71d32c1ce7..55c8af6566 100644 --- a/_sips/sips/priority-based-infix-type-precedence.md +++ b/_sips/sips/priority-based-infix-type-precedence.md @@ -121,9 +121,9 @@ A PR for this SIP is available at: [https://github.com/scala/scala/pull/6147](ht ### Interactions with other language features -#### Star `*` infix type interaction with repeated parameters -The [repeated argument symbol `*`](https://www.scala-lang.org/files/archive/spec/2.12/04-basic-declarations-and-definitions.html#repeated-parameters) may create confusion with the infix type `*`. -Please note that this feature interaction already exists within the current specification. +#### Star `*` infix type interaction with repeated parameters +The [repeated argument symbol `*`](https://www.scala-lang.org/files/archive/spec/2.12/04-basic-declarations-and-definitions.html#repeated-parameters) may create confusion with the infix type `*`. +Please note that this feature interaction already exists within the current specification. ```scala trait +[N1, N2] @@ -141,7 +141,7 @@ However, it is very unlikely that such interaction would occur. ## Backward Compatibility -Changing infix type associativity and precedence affects code that uses type operations and conforms to the current specification. +Changing infix type associativity and precedence affects code that uses type operations and conforms to the current specification. Note: changing the infix precedence didn't fail any scalac test. diff --git a/_sips/sips/scala-cli.md b/_sips/sips/scala-cli.md index f979104084..de9aaece39 100644 --- a/_sips/sips/scala-cli.md +++ b/_sips/sips/scala-cli.md @@ -2,7 +2,7 @@ layout: sip permalink: /sips/:title.html stage: completed -status: accepted +status: shipped title: SIP-46 - Scala CLI as default Scala command --- @@ -16,7 +16,7 @@ title: SIP-46 - Scala CLI as default Scala command ## Summary -We propose to replace current script that is installed as `scala` with Scala CLI - a batteries included tool to interact with Scala. Scala CLI brings all the features that the commands above provide and expand them with incremental compilation, dependency management, packaging and much more. +We propose to replace current script that is installed as `scala` with Scala CLI - a batteries included tool to interact with Scala. Scala CLI brings all the features that the commands above provide and expand them with incremental compilation, dependency management, packaging and much more. Even though Scala CLI could replace `scaladoc` and `scalac` commands as well for now, we do not propose to replace them. @@ -25,30 +25,30 @@ Even though Scala CLI could replace `scaladoc` and `scalac` commands as well for The current default `scala` script is quite limited since it can only start repl or run pre-compile Scala code. -The current script are lacking basic features such as support for resolving dependencies, incremental compilation or support for outputs other than JVM. This forces any user that wants to do anything more than just basic things to learn and use SBT, Mill or an other build tool and that adds to the complexity of learning Scala. +The current script are lacking basic features such as support for resolving dependencies, incremental compilation or support for outputs other than JVM. This forces any user that wants to do anything more than just basic things to learn and use SBT, Mill or an other build tool and that adds to the complexity of learning Scala. -We observe that the current state of tooling in Scala is limiting creativity, with quite a high cost to create e.g. an application or a script with some dependencies that target Node.js. Many Scala developers are not choosing Scala for their personal projects, scripts, or small applications and we believe that the complexity of setting up a build tool is one of the reasons. +We observe that the current state of tooling in Scala is limiting creativity, with quite a high cost to create e.g. an application or a script with some dependencies that target Node.js. Many Scala developers are not choosing Scala for their personal projects, scripts, or small applications and we believe that the complexity of setting up a build tool is one of the reasons. With this proposal our main goal is to turn Scala into a language with "batteries included" that will also respect the community-first aspect of our ecosystem. ### Why decided to work on Scala CLI rather then improve existing tools like sbt or Mill? Firstly, Scala CLI is in no way an actual replacement for SBT or Mill - nor was it ever meant to be. We do not call it a build tool, even though it does share some similarities with build tools. It doesn't aim at supporting multi-module -projects, nor to be extended via a task system. The main advantages of SBT and Mill: multi-module support and plugin ecosystem in the use cases for Scala CLI and scala command can often be disadvantages as it affects performance: configuration needs to be compiled, plugins resolved etc. +projects, nor to be extended via a task system. The main advantages of SBT and Mill: multi-module support and plugin ecosystem in the use cases for Scala CLI and scala command can often be disadvantages as it affects performance: configuration needs to be compiled, plugins resolved etc. Mill and SBT uses turing complete configuration for build so the complexity of build scripts in theory is unlimited. Scala CLI is configuration-only and that limits the complexity what put a hard cap how complex Scala CLI builds can be. -`scala` command should be first and foremost a command line tool. Requirements for a certain project structure or presence configuration files limit SBT and Mill usability certain use cases related to command line. +`scala` command should be first and foremost a command line tool. Requirements for a certain project structure or presence configuration files limit SBT and Mill usability certain use cases related to command line. -One of the main requirements for the new `scala` commands was speed, flexibility and focus on command-line use cases. Initially, we were considering improving SBT or Mill as well as building Scala CLI on top one. We have quickly realized that getting Mill or SBT to reply within Milliseconds (for cases where no hard work like compilation is require) would be pretty much out of reach. Mill and SBT's codebases are too big to compile them to native image using GraalVM, not to mention problems with dynamic loading and reflection. Adding flexibility when in comes to input sources (e.g. support for Gists) and making the tool that can accept most of the configuration using simple command-line parameters would involve writhing a lot of glue code. That is why we decided to build the tool from scratch based on existing components like coursier, bloop or scalafmt. +One of the main requirements for the new `scala` commands was speed, flexibility and focus on command-line use cases. Initially, we were considering improving SBT or Mill as well as building Scala CLI on top one. We have quickly realized that getting Mill or SBT to reply within Milliseconds (for cases where no hard work like compilation is require) would be pretty much out of reach. Mill and SBT's codebases are too big to compile them to native image using GraalVM, not to mention problems with dynamic loading and reflection. Adding flexibility when in comes to input sources (e.g. support for Gists) and making the tool that can accept most of the configuration using simple command-line parameters would involve writhing a lot of glue code. That is why we decided to build the tool from scratch based on existing components like coursier, bloop or scalafmt. ## Proposed solution -We propose to gradually replace the current `scala`, `scalac` and `scaladoc` commands by single `scala` command that under the hood will be `scala-cli`. We could also add wrapper scripts for `scalac` and `scaladoc` that will mimic the functionality that will use `scala-cli` under the hood. +We propose to gradually replace the current `scala`, `scalac` and `scaladoc` commands by single `scala` command that under the hood will be `scala-cli`. We could also add wrapper scripts for `scalac` and `scaladoc` that will mimic the functionality that will use `scala-cli` under the hood. The complete set of `scala-cli` features can be found in [its documentation](https://scala-cli.virtuslab.org/docs/overview). -Scala CLI brings many features like testing, packaging, exporting to sbt / Mill or upcoming support for publishing micro-libraries. Initially, we propose to limit the set of features available in the `scala` command by default. Scala CLI is a relatively new project and we should battle-proof some of its features before we commit to support them as part of the official `scala` command. +Scala CLI brings many features like testing, packaging, exporting to sbt / Mill or upcoming support for publishing micro-libraries. Initially, we propose to limit the set of features available in the `scala` command by default. Scala CLI is a relatively new project and we should battle-proof some of its features before we commit to support them as part of the official `scala` command. Scala CLI offers [multiple native ways to be installed](https://scala-cli.virtuslab.org/install#advanced-installation) so most users should find a suitable method. We propose that these packages to become the default `scala` package in most repositories, often replacing existing `scala` packages but the fact how new `scala` command would be installed is not intended to be a part of this SIP. @@ -58,7 +58,7 @@ Let us show a few examples where adopting Scala CLI as `scala` command would be **Using REPL with a 3rd-party dependency** -Currently, to start a Scala REPL with a dependency on the class path, users need to resolve this dependency with all its transitive dependencies (coursier can help here) and pass those to the `scala` command using the `--cp` option. Alternatively, one can create an sbt project including a single dependency and use the `sbt console` task. Ammonite gives a better experience with its magic imports. +Currently, to start a Scala REPL with a dependency on the class path, users need to resolve this dependency with all its transitive dependencies (coursier can help here) and pass those to the `scala` command using the `--cp` option. Alternatively, one can create an sbt project including a single dependency and use the `sbt console` task. Ammonite gives a better experience with its magic imports. With Scala CLI, starting a REPL with a given dependency is as simple as running: @@ -82,7 +82,7 @@ Currently, when reporting a bug in the compiler (or any other Scala-related) rep //> using platform "native" //> using "com.lihaoyi::os-lib:0.7.8" //> using options "-Xfatal-warnings" - + def foo = println("") ``` @@ -132,7 +132,7 @@ Last section of this proposal is the list of options that each sub-command MUST Scala CLI can also be configured with ["using directives"](https://scala-cli.virtuslab.org/docs/guides/introduction/using-directives) - a comment-based configuration syntax that should be placed at the top of Scala files. This allows for self-containing examples within one file since most of the configuration can be provided either from the command line or via using directives (command line has precedence). This is a game changer for use cases like scripting, reproduction, or within the academic scope. -We have described the motivation, syntax and implementation basis in the [dedicated pre-SIP](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700). Currently, we recommend to write using directives as comments, so making them part of the language specification is not necessary at this stage. Moreover, the new `scala` command could ignore using directives in the initial version, however we strongly suggest to include comment-based using directives from the start. +We have described the motivation, syntax and implementation basis in the [dedicated pre-SIP](https://contributors.scala-lang.org/t/pre-sip-using-directives/5700). Currently, we recommend to write using directives as comments, so making them part of the language specification is not necessary at this stage. Moreover, the new `scala` command could ignore using directives in the initial version, however we strongly suggest to include comment-based using directives from the start. Last section of this proposal contains a sumamry of Using Directives syntax as well as list of directives that MUST and SHOULD be supported. @@ -158,7 +158,7 @@ The release cadence: should the new `scala` command follow the current release c ## Alternatives -Scala CLI has many alternatives. The most obvious ones are sbt, Mill, or other build tools. However, these are more complicated than Scala CLI, and what is more important they are not designed as command-line first tools. Ammonite, is another alternative, however it covers only part of the Scala CLI features (REPL and scripting), and lacks many of the Scala CLI features (incremental compilation, Scala version selection, support for Scala.js and Scala Native, just to name a few). +Scala CLI has many alternatives. The most obvious ones are sbt, Mill, or other build tools. However, these are more complicated than Scala CLI, and what is more important they are not designed as command-line first tools. Ammonite, is another alternative, however it covers only part of the Scala CLI features (REPL and scripting), and lacks many of the Scala CLI features (incremental compilation, Scala version selection, support for Scala.js and Scala Native, just to name a few). ## Related work @@ -196,7 +196,7 @@ Scala Runner MUST support following options from Scala Compiler directly: - `-X` - `-Y` -SHOULD be treated as be Scala compiler options and be propagated to Scala Compiler. This applies to all commands that uses compiler directly or indirectly. +SHOULD be treated as be Scala compiler options and be propagated to Scala Compiler. This applies to all commands that uses compiler directly or indirectly. # MUST have commands @@ -219,7 +219,7 @@ Compile Scala code - `--js-version`: The Scala.js version - `--js-mode`: The Scala.js mode, either `dev` or `release` - `--js-module-kind`: The Scala.js module kind: commonjs/common, esmodule/es, nomodule/none -- `--js-check-ir`: +- `--js-check-ir`: - `--js-emit-source-maps`: Emit source maps - `--js-source-maps-path`: Set the destination path of source maps - `--js-dom`: Enable jsdom @@ -273,7 +273,7 @@ Generate Scaladoc documentation - `--js-version`: The Scala.js version - `--js-mode`: The Scala.js mode, either `dev` or `release` - `--js-module-kind`: The Scala.js module kind: commonjs/common, esmodule/es, nomodule/none -- `--js-check-ir`: +- `--js-check-ir`: - `--js-emit-source-maps`: Emit source maps - `--js-source-maps-path`: Set the destination path of source maps - `--js-dom`: Enable jsdom @@ -328,7 +328,7 @@ Fire-up a Scala REPL - `--js-version`: The Scala.js version - `--js-mode`: The Scala.js mode, either `dev` or `release` - `--js-module-kind`: The Scala.js module kind: commonjs/common, esmodule/es, nomodule/none -- `--js-check-ir`: +- `--js-check-ir`: - `--js-emit-source-maps`: Emit source maps - `--js-source-maps-path`: Set the destination path of source maps - `--js-dom`: Enable jsdom @@ -390,7 +390,7 @@ scala-cli MyApp.scala -- first-arg second-arg - `--js-version`: The Scala.js version - `--js-mode`: The Scala.js mode, either `dev` or `release` - `--js-module-kind`: The Scala.js module kind: commonjs/common, esmodule/es, nomodule/none -- `--js-check-ir`: +- `--js-check-ir`: - `--js-emit-source-maps`: Emit source maps - `--js-source-maps-path`: Set the destination path of source maps - `--js-dom`: Enable jsdom @@ -470,7 +470,7 @@ println("Hello, world) - `--js-version`: The Scala.js version - `--js-mode`: The Scala.js mode, either `dev` or `release` - `--js-module-kind`: The Scala.js module kind: commonjs/common, esmodule/es, nomodule/none -- `--js-check-ir`: +- `--js-check-ir`: - `--js-emit-source-maps`: Emit source maps - `--js-source-maps-path`: Set the destination path of source maps - `--js-dom`: Enable jsdom @@ -528,7 +528,7 @@ Format Scala code - `--js-version`: The Scala.js version - `--js-mode`: The Scala.js mode, either `dev` or `release` - `--js-module-kind`: The Scala.js module kind: commonjs/common, esmodule/es, nomodule/none -- `--js-check-ir`: +- `--js-check-ir`: - `--js-emit-source-maps`: Emit source maps - `--js-source-maps-path`: Set the destination path of source maps - `--js-dom`: Enable jsdom @@ -581,7 +581,7 @@ Compile and test Scala code - `--js-version`: The Scala.js version - `--js-mode`: The Scala.js mode, either `dev` or `release` - `--js-module-kind`: The Scala.js module kind: commonjs/common, esmodule/es, nomodule/none -- `--js-check-ir`: +- `--js-check-ir`: - `--js-emit-source-maps`: Emit source maps - `--js-source-maps-path`: Set the destination path of source maps - `--js-dom`: Enable jsdom @@ -618,7 +618,7 @@ Compile and test Scala code # Using Directives -As a part of this SIP we propose to introduce Using Directives, a special comments containing configuration. Withing Scala CLI and by extension `scala` command, the command line arguments takes precedence over using directives. +As a part of this SIP we propose to introduce Using Directives, a special comments containing configuration. Withing Scala CLI and by extension `scala` command, the command line arguments takes precedence over using directives. Using directives can be place on only top of the file (above imports, package definition etx.) and can be proceed only by plain comments (e.g. to comment out an using directive) diff --git a/_sips/sips/typeclasses-syntax.md b/_sips/sips/typeclasses-syntax.md index 3fb3b807fd..38dcba9293 100644 --- a/_sips/sips/typeclasses-syntax.md +++ b/_sips/sips/typeclasses-syntax.md @@ -1,7 +1,7 @@ --- layout: sip -stage: implementation -status: under-review +stage: completed +status: shipped presip-thread: https://contributors.scala-lang.org/t/pre-sip-improve-syntax-for-context-bounds-and-givens/6576/97 title: SIP-64 - Improve Syntax for Context Bounds and Givens --- diff --git a/_sips/sips/unroll-default-arguments.md b/_sips/sips/unroll-default-arguments.md index eb646d3c64..6d90188b57 100644 --- a/_sips/sips/unroll-default-arguments.md +++ b/_sips/sips/unroll-default-arguments.md @@ -17,7 +17,7 @@ title: SIP-61 - Unroll Default Arguments for Binary Compatibility ## Summary This SIP proposes an `@unroll` annotation lets you add additional parameters -to method `def`s,`class` construtors, or `case class`es, without breaking binary +to method `def`s,`class` construtors, or `case class`es, without breaking binary compatibility. `@unroll` works by generating "unrolled" or "telescoping" forwarders: ```scala @@ -31,19 +31,19 @@ def foo(s: String, n: Int) = foo(s, n, true, 0) In contrast to most existing or proposed alternatives that require you to contort your code to become binary compatible (see [Major Alternatives](#major-alternatives)), -`@unroll` allows you to write Scala with vanilla `def`s/`class`es/`case class`es, add +`@unroll` allows you to write Scala with vanilla `def`s/`class`es/`case class`es, add a single annotation, and your code will maintain binary compatibility as new default -parameters and fields are added over time. +parameters and fields are added over time. -`@unroll`'s only constraints are that: +`@unroll`'s only constraints are that: -1. New parameters need to have a default value +1. New parameters need to have a default value 2. New parameters can only be added on the right 3. The `@unroll`ed methods must be abstract or final These are both existing industry-wide standard when dealing with data and schema evolution (e.g. [Schema evolution in Avro, Protocol Buffers and Thrift — Martin Kleppmann’s blog](https://martin.kleppmann.com/2012/12/05/schema-evolution-in-avro-protocol-buffers-thrift.html)), -and are also the way the new parameters interact with _source compatibility_ in +and are also the way the new parameters interact with _source compatibility_ in the Scala language. Thus these constraints should be immediately familiar to any experienced programmers, and would be easy to follow without confusion. @@ -53,38 +53,38 @@ Prior Discussion can be found [here](https://contributors.scala-lang.org/t/can-w Maintaining binary compatibility of Scala libraries as they evolve over time is difficult. Although tools like https://github.com/lightbend/mima help _surface_ -issues, actually _resolving_ those issues is a different challenge. +issues, actually _resolving_ those issues is a different challenge. -Some kinds of library changes are fundamentally impossible to make compatible, -e.g. removing methods or classes. But there is one big class of binary compatibility +Some kinds of library changes are fundamentally impossible to make compatible, +e.g. removing methods or classes. But there is one big class of binary compatibility issues that are "spurious": adding default parameters to methods, `class` constructors, or `case class`es. Adding a default parameter is source-compatible, but not binary compatible: a user -downstream of a library that adds a default parameter does not need to make any +downstream of a library that adds a default parameter does not need to make any changes to their code, but _does_ need to re-compile it. This is "spurious" because there is no _fundamental_ incompatibility here: semantically, a new default parameter is meant to be optional! Old code invoking that method without a new default parameter is exactly the user intent, and works just fine if the downstream code is re-compiled. -Other languages, such as Python, have the same default parameter language feature but face -no such compatibility issues with their use. Even Scala codebases compiled from source +Other languages, such as Python, have the same default parameter language feature but face +no such compatibility issues with their use. Even Scala codebases compiled from source do not suffer these restrictions: adding a default parameter to the right side of a parameter list is for all intents and purposes backwards compatible in a mono-repo setup. The fact that such addition is binary incompatible is purely an implementation restriction of Scala's binary artifact format and distribution strategy. **Binary compatibility is generally more important than Source compatibility**. When -you hit a source compatibility issue, you can always change the source code you are +you hit a source compatibility issue, you can always change the source code you are compiling, whether manually or via your build tool. In contrast, when you hit binary compatibility issues, it can come in the form of diamond dependencies that would require _re-compiling all of your transitive dependencies_, a task that is far more difficult and often impractical. -There are many approaches to resolving these "spurious" binary compatibility issues, -but most of them involve either tremendous amounts of boilerplate writing -binary-compatibility forwarders, giving up on core language features like Case Classes -or Default Parameters, or both. Consider the following code snippet +There are many approaches to resolving these "spurious" binary compatibility issues, +but most of them involve either tremendous amounts of boilerplate writing +binary-compatibility forwarders, giving up on core language features like Case Classes +or Default Parameters, or both. Consider the following code snippet ([link](https://github.com/com-lihaoyi/mainargs/blob/1d04a6bd19aaca401d11fe26da31615a8bc9213c/mainargs/src/Parser.scala)) from the [com-lihaoyi/mainargs](https://github.com/com-lihaoyi/mainargs) library, which duplicates the parameters of `def constructEither` no less than five times in @@ -159,13 +159,13 @@ parameters are added to `def constructEither`: Apart from being extremely verbose and full of boilerplate, like any boilerplate this is also extremely error-prone. Bugs like [com-lihaoyi/mainargs#106](https://github.com/com-lihaoyi/mainargs/issues/106) -slip through when a mistake is made in that boilerplate. These bugs are impossible to catch -using a normal test suite, as they only appear in the presence of version skew. The above code -snippet actually _does_ have such a bug, that the test suite _did not_ catch. See if you can -spot it! +slip through when a mistake is made in that boilerplate. These bugs are impossible to catch +using a normal test suite, as they only appear in the presence of version skew. The above code +snippet actually _does_ have such a bug, that the test suite _did not_ catch. See if you can +spot it! Sebastien Doraene's talk [Designing Libraries for Source and Binary Compatibility](https://www.youtube.com/watch?v=2wkEX6MCxJs) -explores some of the challenges, and discusses the workarounds. +explores some of the challenges, and discusses the workarounds. ## Requirements @@ -183,19 +183,19 @@ Given: * The behavior should be binary compatible and semantically indistinguishable from using a verion of **Downstream** compiled against the _newer_ version of **Upstream** -**Note:** we do not aim for _Forwards_ compatibility. Using an _older_ -version of **Upstream** with a _newer_ version of **Downstream** compiled against a +**Note:** we do not aim for _Forwards_ compatibility. Using an _older_ +version of **Upstream** with a _newer_ version of **Downstream** compiled against a _newer_ version of **Upstream** is not a use case we want to support. The vast majority of OSS software does not promise forwards compatibility, including software such as the JVM, so we should just follow suite ### All Overrides Are Equivalent -All versions of an `@unroll`ed method `def foo` should have the same semantics when called +All versions of an `@unroll`ed method `def foo` should have the same semantics when called with the same parameters. We must be careful to ensure: 1. All our different method overrides point at the same underlying implementation -2. Abstract methods are properly implemented, and no method would fail with an +2. Abstract methods are properly implemented, and no method would fail with an `AbstractMethodError` when called 3. We properly forward the necessary argument and default parameter values when calling the respective implementation. @@ -257,7 +257,7 @@ object Unrolled{ } ``` -This is a source-compatible change, but not binary-compatible: JVM bytecode compiled against an +This is a source-compatible change, but not binary-compatible: JVM bytecode compiled against an earlier version of the library would be expecting to call `def foo(String, Int)`, but will fail because the signature is now `def foo(String, Int, Boolean)` or `def foo(String, Int, Boolean, Long)`. On the JVM this will result in a `MethodNotFoundError` at runtime, a common experience for anyone @@ -265,7 +265,7 @@ who upgrading the versions of their dependencies. Similar concerns are present w Scala-Native, albeit the failure happens at link-time rather than run-time `@unroll` is an annotation that can be applied as follows, to the first "additional" default -parameter that was added in each published version of the library (in this case, +parameter that was added in each published version of the library (in this case, `b: Boolean = true` and `l: Long = 0`) @@ -292,11 +292,11 @@ object Unrolled{ ``` As a result, old callers who expect `def foo(String, Int, Boolean)` or `def foo(String, Int, Boolean, Long)` -can continue to work, even as new parameters are added to `def foo`. The only restriction is that +can continue to work, even as new parameters are added to `def foo`. The only restriction is that new parameters can only be added on the right, and they must be provided with a default value. If multiple default parameters are added at once (e.g. `b` and `l` below) you can also -choose to only `@unroll` the first default parameter of each batch, to avoid generating +choose to only `@unroll` the first default parameter of each batch, to avoid generating unnecessary forwarders: ```scala @@ -312,8 +312,8 @@ parameter list can be unrolled (though it does not need to be the first one). e. ```scala object Unrolled{ - def foo(s: String, - n: Int = 1, + def foo(s: String, + n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) (implicit blah: Blah) = s + n + b + l @@ -325,8 +325,8 @@ As does this ```scala object Unrolled{ def foo(blah: Blah) - (s: String, - n: Int = 1, + (s: String, + n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0) = s + n + b + l } @@ -336,7 +336,7 @@ object Unrolled{ ### Unrolling `class`es -Class constructors and secondary constructors are treated by `@unroll` just like any +Class constructors and secondary constructors are treated by `@unroll` just like any other method: ```scala @@ -405,10 +405,10 @@ Unrolls to: case class Unrolled(s: String, n: Int = 1, @unroll b: Boolean = true, @unroll l: Long = 0L){ def this(s: String, n: Int) = this(s, n, true, 0L) def this(s: String, n: Int, b: Boolean) = this(s, n, b, 0L) - + def copy(s: String, n: Int) = copy(s, n, this.b, this.l) def copy(s: String, n: Int, b: Boolean) = copy(s, n, b, this.l) - + def foo = s + n + b } object Unrolled{ @@ -419,26 +419,26 @@ object Unrolled{ Notes: -1. `@unroll`ed `case class`es are fully binary and backwards compatible in Scala 3, but not in Scala 2 +1. `@unroll`ed `case class`es are fully binary and backwards compatible in Scala 3, but not in Scala 2 2. `.unapply` does not need to be duplicated in Scala 3.x, as its signature `def unapply(x: Unrolled): Unrolled` does not change when new `case class` fields are added. 3. Even in Scala 2.x, where `def unapply(x: Unrolled): Option[TupleN]` is not - binary compatible, pattern matching on `case class`es is already binary compatible - to addition of new fields due to + binary compatible, pattern matching on `case class`es is already binary compatible + to addition of new fields due to [Option-less Pattern Matching](https://docs.scala-lang.org/scala3/reference/changed-features/pattern-matching.html). - Thus, only calls to `.tupled` or `.curried` on the `case class` companion `object`, or direct calls + Thus, only calls to `.tupled` or `.curried` on the `case class` companion `object`, or direct calls to `.unapply` on an unrolled `case class` in Scala 2.x (shown below) - will cause a crash if additional fields were added: + will cause a crash if additional fields were added: ```scala def foo(t: (String, Int)) = println(t) Unrolled.unapply(unrolled).map(foo) ``` -In Scala 3, `@unroll`ing a `case class` also needs to generate a `fromProduct` +In Scala 3, `@unroll`ing a `case class` also needs to generate a `fromProduct` implementation in the companion object, as shown below: ```scala @@ -480,7 +480,7 @@ This is done in two different ways: ## Limitations -### Only the one parameter list of multi-parameter list methods can be `@unroll`ed. +### Only the one parameter list of multi-parameter list methods can be `@unroll`ed. Unrolling multiple parameter lists would generate a number of forwarder methods exponential with regard to the number of parameter lists unrolled, @@ -499,11 +499,11 @@ compatibility on the JVM works. ### `@unroll`ed case classes are only fully binary compatible in Scala 3 -They are _almost_ binary compatible in Scala 2. Direct calls to `unapply` are binary -incompatible, but most common pattern matching of `case class`es goes through a different +They are _almost_ binary compatible in Scala 2. Direct calls to `unapply` are binary +incompatible, but most common pattern matching of `case class`es goes through a different code path that _is_ binary compatible. There are also the `AbstractFunctionN` traits, from which the companion object inherits `.curried` and `.tupled` members. Luckily, `unapply` -was made binary compatible in Scala 3, and `AbstractFunctionN`, `.curried`, and `.tupled` +was made binary compatible in Scala 3, and `AbstractFunctionN`, `.curried`, and `.tupled` were removed ### While `@unroll`ed `case class`es are *not* fully _source_ compatible @@ -539,15 +539,15 @@ default parameters over time. In such extreme scenarios, some kind of builder pa `object` methods and constructors are naturally final, but `class` or `trait` methods that are `@unroll`ed need to be explicitly marked `final`. -It has proved difficult to implement the semantics of `@unroll` in the presence of downstream -overrides, `super`, etc. where the downstream overrides can be compiled against by different +It has proved difficult to implement the semantics of `@unroll` in the presence of downstream +overrides, `super`, etc. where the downstream overrides can be compiled against by different versions of the upstream code. If we can come up with some implementation that works, we can lift this restriction later, but for now I have not managed to do so and so this restriction stays. ### Challenges of Non-Final Methods and Overriding -To elaborate a bit on the issues with non-final methods and overriding, consider the following +To elaborate a bit on the issues with non-final methods and overriding, consider the following case with four classes, `Upstream`, `Downstream`, `Main1` and `Main2`, each of which is compiled against different versions of each other (hence the varying number of parameters for `foo`): @@ -581,14 +581,14 @@ object Main2 { // compiled against Upstream V1 The challenge here is: how do we make sure that `Main1` and `Main2`, who call -`new Downstream().foo`, correctly pick up the version of `def foo` that is -provided by `Downstream`? +`new Downstream().foo`, correctly pick up the version of `def foo` that is +provided by `Downstream`? With the current implementation, the `override def foo` inside `Downstream` would only override one of `Upstream`'s synthetic forwarders, but would not override the actual primary implementation. As a result, we would see `Main1` calling the implementation -of `foo` from `Upstream`, while `Main2` calls the implementation of `foo` from -`Downstream`. So even though both `Main1` and `Main2` have the same +of `foo` from `Upstream`, while `Main2` calls the implementation of `foo` from +`Downstream`. So even though both `Main1` and `Main2` have the same `Upstream` and `Downstream` code on the classpath, they end up calling different implementations based on what they were compiled against. @@ -605,7 +605,7 @@ happen according to what version combinations are supported by our definition of concern due to the requirement that [All Overrides Are Equivalent](#all-overrides-are-equivalent). It may be possible to loosen this restriction to also allow abstract methods that -are implemented only once by a final method. See the section about +are implemented only once by a final method. See the section about [Abstract Methods](#abstract-methods) for details. ## Major Alternatives @@ -626,11 +626,11 @@ takes: The first major difference between `@unroll` and the above alternatives is that these alternatives all introduce something new: some kind of _not-a-case-class_ `class` that is to be used -when binary compatibility is desired. This _not-a-case-class_ has different syntax from +when binary compatibility is desired. This _not-a-case-class_ has different syntax from `case class`es, different semantics, different methods, and so on. In contrast, `@unroll` does not introduce any new language-level or library-level constructs. -The `@unroll` annotation is purely a compiler-backend concern for maintaining binary +The `@unroll` annotation is purely a compiler-backend concern for maintaining binary compatibility. At a language level, `@unroll` allows you to keep using normal method `def`s, `class`es and `case class`es with exactly the same syntax and semantics you have been using all along. @@ -644,10 +644,10 @@ designing their data types, is inferior to simply using `case class`es all the t The alternatives linked above all build a Java-esque "[inner platform](https://en.wikipedia.org/wiki/Inner-platform_effect)" -on top of the Scala language, with its own conventions like `.withFoo` methods. +on top of the Scala language, with its own conventions like `.withFoo` methods. In contrast, `@unroll` makes use of the existing Scala language's default parameters -to achieve the same effect. +to achieve the same effect. If we think Scala is nicer to write then Java due to its language features, then `@unroll`'s approach of leveraging those language features is nicer @@ -662,7 +662,7 @@ things that do not affect typechecking, and `@unroll` fits the bill perfectly. ### Evolving Any Class v.s. Evolving Pre-determined Classes The alternatives given require that the developer has to decide _up front_ whether their -data type needs to be evolved while maintaining binary compatibility. +data type needs to be evolved while maintaining binary compatibility. In contrast, `@unroll` allows you to evolve any existing `class` or `case class`. @@ -680,7 +680,7 @@ Binary compatility is not just a problem for `case class`es adding new fields: n `class` constructors, instance method `def`s, static method `def`s, etc. have default parameters added all the time as well. -In contrast, `@unroll` allows the evolution of `def`s and normal `class`es, in addition +In contrast, `@unroll` allows the evolution of `def`s and normal `class`es, in addition to `case class`es, all using the same approach: 1. `@unroll`ing `case class`es is about _schema evolution_ @@ -690,7 +690,7 @@ to `case class`es, all using the same approach: All three cases above have analogous best practices in the broader software engineering world: whether you are adding an optional column to a database table, adding an optional flag to a command-line tool, are extending an existing protocol with optional -fields that may need handling by both clients and servers implementing that protocol. +fields that may need handling by both clients and servers implementing that protocol. `@unroll` solves all three problems at once - schema evolution, API evolution, and protocol evolution. It does so with the same Scala-level syntax and semantics, with the same requirements @@ -699,7 +699,7 @@ software engineering community. ### Abstract Methods -Apart from `final` methods, `@unroll` also supports purely abstract methods. Consider +Apart from `final` methods, `@unroll` also supports purely abstract methods. Consider the following example with a trait `Unrolled` and an implementation `UnrolledObj`: ```scala @@ -729,7 +729,7 @@ object UnrolledObj extends Unrolled{ // version 3 } ``` -Note that both the abstract methods from `trait Unrolled` and the concrete methods +Note that both the abstract methods from `trait Unrolled` and the concrete methods from `object UnrolledObj` generate forwarders when `@unroll`ed, but the forwarders are generated _in opposite directions_! Unrolled concrete methods forward from longer parameter lists to shorter parameter lists, while unrolled abstract methods forward @@ -753,7 +753,7 @@ UnrolledObj.foo(String, Int, Boolean) UnrolledObj.foo(String, Int, Boolean, Long) ``` -Because such downstream code cannot know which version of `Unrolled` that `UnrolledObj` +Because such downstream code cannot know which version of `Unrolled` that `UnrolledObj` was compiled against, we need to ensure all such calls find their way to the correct implementation of `def foo`, which may be at any of the above signatures. This "double forwarding" strategy ensures that regardless of _which_ version of `.foo` gets called, @@ -761,20 +761,20 @@ it ends up eventually forwarding to the actual implementation of `foo`, with the correct combination of passed arguments and default arguments ```scala -UnrolledObj.foo(String, Int) // forwards to UnrolledObj.foo(String, Int, Boolean) -UnrolledObj.foo(String, Int, Boolean) // actual implementation +UnrolledObj.foo(String, Int) // forwards to UnrolledObj.foo(String, Int, Boolean) +UnrolledObj.foo(String, Int, Boolean) // actual implementation UnrolledObj.foo(String, Int, Boolean, Long) // forwards to UnrolledObj.foo(String, Int, Boolean) ``` -As is the case for `@unroll`ed methods on `trait`s and `class`es, `@unroll`ed +As is the case for `@unroll`ed methods on `trait`s and `class`es, `@unroll`ed implementations of an abtract method must be final. #### Are Reverse Forwarders Really Necessary? -This "double forwarding" strategy is not strictly necessary to support +This "double forwarding" strategy is not strictly necessary to support [Backwards Compatibility](#backwards-compatibility): the "reverse" forwarders generated for abstract methods are only necessary when a downstream callsite -of `UnrolledObj.foo` is compiled against a newer version of the original +of `UnrolledObj.foo` is compiled against a newer version of the original `trait Unrolled` than the `object UnrolledObj` was, as shown below: ```scala @@ -802,14 +802,14 @@ If we did not have the reverse forwarder from `foo(String, Int, Boolean, Long)` It also will get caught by MiMa as a `ReversedMissingMethodProblem`. This configuration of version is not allowed given our definition of backwards compatibility: -that definition assumes that `Unrolled` must be of a greater or equal version than `UnrolledObj`, +that definition assumes that `Unrolled` must be of a greater or equal version than `UnrolledObj`, which itself must be of a greater or equal version than the final call to `UnrolledObj.foo`. However, -the reverse forwarders are needed to fulfill our requirement +the reverse forwarders are needed to fulfill our requirement [All Overrides Are Equivalent](#all-overrides-are-equivalent): looking at `trait Unrolled // version 3` and `object UnrolledObj // version 2` in isolation, we find that without the reverse forwarders the signature `foo(String, Int, Boolean, Long)` is defined but not implemented. Such an un-implemented abstract method is something -we want to avoid, even if our artifact version constraints mean it should technically +we want to avoid, even if our artifact version constraints mean it should technically never get called. ## Minor Alternatives: @@ -819,7 +819,7 @@ never get called. Currently, `@unroll` generates a forwarder only for the annotated default parameter; if you want to generate multiple forwarders, you need to `@unroll` each one. In the -vast majority of scenarios, we want to unroll every default parameters we add, and in +vast majority of scenarios, we want to unroll every default parameters we add, and in many cases default parameters are added one at a time. In this case, an `@unrollAll` annotation may be useful, a shorthand for applying `@unroll` to the annotated default parameter and every parameter to the right of it: @@ -858,9 +858,9 @@ def foo(s: Object, n: Int = 1, b: Boolean = true) = s.toString + n + b + l def foo(s: String, n: Int = 1, b: Boolean = true) = foo(s, n, b) ``` -This would follow the precedence of how Java's and Scala's covariant method return -type overrides are implemented: when a class overrides a method with a new -implementation with a narrower return type, a forwarder method is generated to +This would follow the precedence of how Java's and Scala's covariant method return +type overrides are implemented: when a class overrides a method with a new +implementation with a narrower return type, a forwarder method is generated to allow anyone calling the original signature \to be forwarded to the narrower signature. This is not currently implemented in `@unroll`, but would be a straightforward addition. @@ -893,7 +893,7 @@ The first option results in shorter stack traces, while the second option result roughly half as much generated bytecode in the method bodies (though it's still `O(n^2)`). In order to allow `@unroll`ing of [Abstract Methods](#abstract-methods), we had to go with -the second option. This is because when an abstract method is overriden, it is not necessarily +the second option. This is because when an abstract method is overriden, it is not necessarily true that the longest override that contains the implementation. Thus we need to forward between the different `def foo` overrides one at a time until the override containing the implementation is found. From 2dc1d6e234c0f3cc6f3783b1441c8b005e575a8d Mon Sep 17 00:00:00 2001 From: Wojciech Mazur Date: Wed, 29 Jan 2025 13:19:29 +0100 Subject: [PATCH 3011/3075] Add API docs for 3.3.5 LTS and update compatibility table (#3151) --- _overviews/jdk-compatibility/overview.md | 4 ++-- api/all.md | 6 ++++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index cb5e677243..ce4766c316 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,8 +14,8 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 24 (ea) | 3.6.x? 3.7.x?
    (forthcoming) | 3.3.5?
    (forthcoming) | 2.13.16 | 2.12.21
    (forthcoming) | | -| 23 | 3.6.2 | 3.3.5
    (forthcoming) | 2.13.15 | 2.12.20 | | +| 24 (ea) | 3.6.4
    (forthcoming) | 3.3.6
    (forthcoming) | 2.13.16 | 2.12.21
    (forthcoming) | | +| 23 | 3.6.2 | 3.3.5 | 2.13.15 | 2.12.20 | | | 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | | 17 (LTS) | 3.0.0 | 3.3.0 | 2.13.6 | 2.12.15 | | diff --git a/api/all.md b/api/all.md index ab45f03411..4ef460e114 100644 --- a/api/all.md +++ b/api/all.md @@ -10,8 +10,8 @@ redirect_from: * Scala {{site.scala-3-version}} * [Library API](https://www.scala-lang.org/api/{{site.scala-3-version}}/) -* Scala 3.3.4 LTS - * [Library API](https://www.scala-lang.org/api/3.3.4/) +* Scala 3.3.5 LTS + * [Library API](https://www.scala-lang.org/api/3.3.5/) * Scala 2.13.16 * [Library API](https://www.scala-lang.org/api/2.13.16/) * [Compiler API](https://www.scala-lang.org/api/2.13.16/scala-compiler/scala/) @@ -80,6 +80,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.4.1/) * Scala 3.4.0 * [Library API](https://www.scala-lang.org/api/3.4.0/) +* Scala 3.3.4 LTS + * [Library API](https://www.scala-lang.org/api/3.3.4/) * Scala 3.3.3 LTS * [Library API](https://www.scala-lang.org/api/3.3.3/) * Scala 3.3.1 LTS From 2e0b75c4ae41a1940be39ad4f982a629dd224124 Mon Sep 17 00:00:00 2001 From: Tomasz Godzik Date: Fri, 31 Jan 2025 23:33:00 +0100 Subject: [PATCH 3012/3075] docs: Add link to recent blogpost (#3152) --- _overviews/jdk-compatibility/overview.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index ce4766c316..cd0a51c359 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -47,6 +47,8 @@ Even when a version combination isn't listed as supported, most features might s Using a different build tool, such as Gradle or Maven? We invite pull requests adding additional columns to this table. +**Next Scala 3 LTS series will drop JDK 8 support** - read more about it in [the blog post](https://www.scala-lang.org/news/next-scala-lts.html). + ## Running versus compiling JDK 8, 11, 17, and 21 are all reasonable choices both for *compiling* and *running* Scala code. From 86d29da442aca3c992b9417e71d267f4d2cb57ee Mon Sep 17 00:00:00 2001 From: Daniel Barclay Date: Mon, 3 Feb 2025 15:53:47 -0500 Subject: [PATCH 3013/3075] Fixed missing comma (closing an appositice) in types-dependent-function.md --- _overviews/scala3-book/types-dependent-function.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/types-dependent-function.md b/_overviews/scala3-book/types-dependent-function.md index 96f6d36210..cf86880fa6 100644 --- a/_overviews/scala3-book/types-dependent-function.md +++ b/_overviews/scala3-book/types-dependent-function.md @@ -11,7 +11,7 @@ versionSpecific: true --- A *dependent function type* describes function types, where the result type may depend on the function’s parameter values. -The concept of dependent types, and of dependent function types is more advanced and you would typically only come across it when designing your own libraries or using advanced libraries. +The concept of dependent types, and of dependent function types, is more advanced and you would typically only come across it when designing your own libraries or using advanced libraries. ## Dependent Method Types Let's consider the following example of a heterogenous database that can store values of different types. From 5d66c96bdc73f615788431c03dd0018a68cc9395 Mon Sep 17 00:00:00 2001 From: Daniel Barclay Date: Mon, 3 Feb 2025 17:02:04 -0500 Subject: [PATCH 3014/3075] Fixed "as ... argument" to "as an ... argument" in ca-context-parameters.md Added missing article (since singular noun). (Also added parenthetical expression hinting at case of having multiple arguments.) --- _overviews/scala3-book/ca-context-parameters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-book/ca-context-parameters.md b/_overviews/scala3-book/ca-context-parameters.md index d0ea350416..3da62d4b3b 100644 --- a/_overviews/scala3-book/ca-context-parameters.md +++ b/_overviews/scala3-book/ca-context-parameters.md @@ -17,7 +17,7 @@ Scala offers two important features for contextual abstraction: ## Context Parameters When designing a system, often context information like _configuration_ or settings need to be provided to the different components of your system. -One common way to achieve this is by passing the configuration as additional argument to your methods. +One common way to achieve this is by passing the configuration as an additional argument (or arguments) to your methods. In the following example, we define a case class `Config` to model some website configuration and pass it around in the different methods. From d1e4baaa8d6054613ce4036ed425b19334270a1d Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Tue, 12 Nov 2024 15:31:09 +0100 Subject: [PATCH 3015/3075] Rename online-courses.html to scalacenter-courses.html --- _ru/learn.md | 2 +- ...line-courses.md => scalacenter-courses.md} | 30 +++++++++--------- learn.md | 2 +- .../testimonial000.jpg | Bin .../testimonial001.jpg | Bin .../testimonial002.jpg | Bin .../testimonial003.jpg | Bin .../testimonial004.jpg | Bin .../testimonial005.jpg | Bin .../testimonial006.jpg | Bin .../testimonial007.jpg | Bin .../testimonial008.jpg | Bin .../testimonial009.jpg | Bin .../testimonial010.jpg | Bin .../testimonial011.jpg | Bin .../testimonial012.jpg | Bin .../testimonial013.jpg | Bin .../testimonial014.jpg | Bin online-courses.md => scalacenter-courses.md | 30 +++++++++--------- 19 files changed, 32 insertions(+), 32 deletions(-) rename _ru/{online-courses.md => scalacenter-courses.md} (93%) rename resources/images/{online-courses => scalacenter-courses}/testimonial000.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial001.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial002.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial003.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial004.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial005.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial006.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial007.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial008.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial009.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial010.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial011.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial012.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial013.jpg (100%) rename resources/images/{online-courses => scalacenter-courses}/testimonial014.jpg (100%) rename online-courses.md => scalacenter-courses.md (90%) diff --git a/_ru/learn.md b/_ru/learn.md index f6834b9fce..77aa925af8 100644 --- a/_ru/learn.md +++ b/_ru/learn.md @@ -14,7 +14,7 @@ language: ru [Scala Center](https://scala.epfl.ch) стремится создавать высококачественные и бесплатные онлайн-курсы для изучения Scala и функционального программирования. Уровни курса варьируются от начального до продвинутого. -Более подробная информация доступна [на следующей странице]({% link online-courses.md %}). +Более подробная информация доступна [на следующей странице]({% link scalacenter-courses.md %}). ## Упражнения на языке Scala diff --git a/_ru/online-courses.md b/_ru/scalacenter-courses.md similarity index 93% rename from _ru/online-courses.md rename to _ru/scalacenter-courses.md index 0d8591ffa2..a4e76c3847 100644 --- a/_ru/online-courses.md +++ b/_ru/scalacenter-courses.md @@ -3,21 +3,21 @@ title: Онлайн курсы (MOOCs) от Scala Center layout: singlepage-overview language: ru testimonials: -- /resources/images/online-courses/testimonial000.jpg -- /resources/images/online-courses/testimonial001.jpg -- /resources/images/online-courses/testimonial002.jpg -- /resources/images/online-courses/testimonial003.jpg -- /resources/images/online-courses/testimonial004.jpg -- /resources/images/online-courses/testimonial005.jpg -- /resources/images/online-courses/testimonial006.jpg -- /resources/images/online-courses/testimonial007.jpg -- /resources/images/online-courses/testimonial008.jpg -- /resources/images/online-courses/testimonial009.jpg -- /resources/images/online-courses/testimonial010.jpg -- /resources/images/online-courses/testimonial011.jpg -- /resources/images/online-courses/testimonial012.jpg -- /resources/images/online-courses/testimonial013.jpg -- /resources/images/online-courses/testimonial014.jpg +- /resources/images/scalacenter-courses/testimonial000.jpg +- /resources/images/scalacenter-courses/testimonial001.jpg +- /resources/images/scalacenter-courses/testimonial002.jpg +- /resources/images/scalacenter-courses/testimonial003.jpg +- /resources/images/scalacenter-courses/testimonial004.jpg +- /resources/images/scalacenter-courses/testimonial005.jpg +- /resources/images/scalacenter-courses/testimonial006.jpg +- /resources/images/scalacenter-courses/testimonial007.jpg +- /resources/images/scalacenter-courses/testimonial008.jpg +- /resources/images/scalacenter-courses/testimonial009.jpg +- /resources/images/scalacenter-courses/testimonial010.jpg +- /resources/images/scalacenter-courses/testimonial011.jpg +- /resources/images/scalacenter-courses/testimonial012.jpg +- /resources/images/scalacenter-courses/testimonial013.jpg +- /resources/images/scalacenter-courses/testimonial014.jpg --- [Scala Center] создает онлайн-курсы (также известные как МООК) различного уровня: от начального до продвинутого. diff --git a/learn.md b/learn.md index baf01b8488..0ccd504d6b 100644 --- a/learn.md +++ b/learn.md @@ -15,7 +15,7 @@ There are a handful of websites where you can interactively run Scala code in yo The [Scala Center](https://scala.epfl.ch) is committed to creating high-quality and freely available online courses for learning Scala and functional programming. The course levels range from beginner to advanced. -More details on [this page]({% link online-courses.md %}). +More details on [this page]({% link scalacenter-courses.md %}). ## Scala Exercises diff --git a/resources/images/online-courses/testimonial000.jpg b/resources/images/scalacenter-courses/testimonial000.jpg similarity index 100% rename from resources/images/online-courses/testimonial000.jpg rename to resources/images/scalacenter-courses/testimonial000.jpg diff --git a/resources/images/online-courses/testimonial001.jpg b/resources/images/scalacenter-courses/testimonial001.jpg similarity index 100% rename from resources/images/online-courses/testimonial001.jpg rename to resources/images/scalacenter-courses/testimonial001.jpg diff --git a/resources/images/online-courses/testimonial002.jpg b/resources/images/scalacenter-courses/testimonial002.jpg similarity index 100% rename from resources/images/online-courses/testimonial002.jpg rename to resources/images/scalacenter-courses/testimonial002.jpg diff --git a/resources/images/online-courses/testimonial003.jpg b/resources/images/scalacenter-courses/testimonial003.jpg similarity index 100% rename from resources/images/online-courses/testimonial003.jpg rename to resources/images/scalacenter-courses/testimonial003.jpg diff --git a/resources/images/online-courses/testimonial004.jpg b/resources/images/scalacenter-courses/testimonial004.jpg similarity index 100% rename from resources/images/online-courses/testimonial004.jpg rename to resources/images/scalacenter-courses/testimonial004.jpg diff --git a/resources/images/online-courses/testimonial005.jpg b/resources/images/scalacenter-courses/testimonial005.jpg similarity index 100% rename from resources/images/online-courses/testimonial005.jpg rename to resources/images/scalacenter-courses/testimonial005.jpg diff --git a/resources/images/online-courses/testimonial006.jpg b/resources/images/scalacenter-courses/testimonial006.jpg similarity index 100% rename from resources/images/online-courses/testimonial006.jpg rename to resources/images/scalacenter-courses/testimonial006.jpg diff --git a/resources/images/online-courses/testimonial007.jpg b/resources/images/scalacenter-courses/testimonial007.jpg similarity index 100% rename from resources/images/online-courses/testimonial007.jpg rename to resources/images/scalacenter-courses/testimonial007.jpg diff --git a/resources/images/online-courses/testimonial008.jpg b/resources/images/scalacenter-courses/testimonial008.jpg similarity index 100% rename from resources/images/online-courses/testimonial008.jpg rename to resources/images/scalacenter-courses/testimonial008.jpg diff --git a/resources/images/online-courses/testimonial009.jpg b/resources/images/scalacenter-courses/testimonial009.jpg similarity index 100% rename from resources/images/online-courses/testimonial009.jpg rename to resources/images/scalacenter-courses/testimonial009.jpg diff --git a/resources/images/online-courses/testimonial010.jpg b/resources/images/scalacenter-courses/testimonial010.jpg similarity index 100% rename from resources/images/online-courses/testimonial010.jpg rename to resources/images/scalacenter-courses/testimonial010.jpg diff --git a/resources/images/online-courses/testimonial011.jpg b/resources/images/scalacenter-courses/testimonial011.jpg similarity index 100% rename from resources/images/online-courses/testimonial011.jpg rename to resources/images/scalacenter-courses/testimonial011.jpg diff --git a/resources/images/online-courses/testimonial012.jpg b/resources/images/scalacenter-courses/testimonial012.jpg similarity index 100% rename from resources/images/online-courses/testimonial012.jpg rename to resources/images/scalacenter-courses/testimonial012.jpg diff --git a/resources/images/online-courses/testimonial013.jpg b/resources/images/scalacenter-courses/testimonial013.jpg similarity index 100% rename from resources/images/online-courses/testimonial013.jpg rename to resources/images/scalacenter-courses/testimonial013.jpg diff --git a/resources/images/online-courses/testimonial014.jpg b/resources/images/scalacenter-courses/testimonial014.jpg similarity index 100% rename from resources/images/online-courses/testimonial014.jpg rename to resources/images/scalacenter-courses/testimonial014.jpg diff --git a/online-courses.md b/scalacenter-courses.md similarity index 90% rename from online-courses.md rename to scalacenter-courses.md index d31159ef6a..faaf48cc46 100644 --- a/online-courses.md +++ b/scalacenter-courses.md @@ -3,21 +3,21 @@ title: Online Courses (MOOCs) from The Scala Center layout: singlepage-overview languages: [ru] testimonials: - - /resources/images/online-courses/testimonial000.jpg - - /resources/images/online-courses/testimonial001.jpg - - /resources/images/online-courses/testimonial002.jpg - - /resources/images/online-courses/testimonial003.jpg - - /resources/images/online-courses/testimonial004.jpg - - /resources/images/online-courses/testimonial005.jpg - - /resources/images/online-courses/testimonial006.jpg - - /resources/images/online-courses/testimonial007.jpg - - /resources/images/online-courses/testimonial008.jpg - - /resources/images/online-courses/testimonial009.jpg - - /resources/images/online-courses/testimonial010.jpg - - /resources/images/online-courses/testimonial011.jpg - - /resources/images/online-courses/testimonial012.jpg - - /resources/images/online-courses/testimonial013.jpg - - /resources/images/online-courses/testimonial014.jpg + - /resources/images/scalacenter-courses/testimonial000.jpg + - /resources/images/scalacenter-courses/testimonial001.jpg + - /resources/images/scalacenter-courses/testimonial002.jpg + - /resources/images/scalacenter-courses/testimonial003.jpg + - /resources/images/scalacenter-courses/testimonial004.jpg + - /resources/images/scalacenter-courses/testimonial005.jpg + - /resources/images/scalacenter-courses/testimonial006.jpg + - /resources/images/scalacenter-courses/testimonial007.jpg + - /resources/images/scalacenter-courses/testimonial008.jpg + - /resources/images/scalacenter-courses/testimonial009.jpg + - /resources/images/scalacenter-courses/testimonial010.jpg + - /resources/images/scalacenter-courses/testimonial011.jpg + - /resources/images/scalacenter-courses/testimonial012.jpg + - /resources/images/scalacenter-courses/testimonial013.jpg + - /resources/images/scalacenter-courses/testimonial014.jpg --- The [Scala Center] produces online courses (a.k.a. MOOCs) of various levels, from beginner From 2578568b2a74c5b8de5287b86746b00f0656dcc6 Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Tue, 12 Nov 2024 15:48:09 +0100 Subject: [PATCH 3016/3075] Rename learn.html to online-courses.html --- _data/doc-nav-header.yml | 2 -- _fr/getting-started/install-scala.md | 2 +- _fr/tour/tour-of-scala.md | 4 ++-- _ja/getting-started/install-scala.md | 2 +- _ja/tour/tour-of-scala.md | 2 +- _ko/tour/tour-of-scala.md | 2 +- _overviews/getting-started/install-scala.md | 2 +- _pl/tour/tour-of-scala.md | 2 +- _ru/getting-started/install-scala.md | 2 +- _ru/{learn.md => online-courses.md} | 2 ++ _ru/scalacenter-courses.md | 2 +- _ru/tour/tour-of-scala.md | 2 +- _th/tour/tour-of-scala.md | 2 +- _tour/tour-of-scala.md | 4 ++-- _uk/getting-started/install-scala.md | 2 +- _zh-cn/tour/tour-of-scala.md | 2 +- learn.md => online-courses.md | 3 ++- scalacenter-courses.md | 2 +- 18 files changed, 21 insertions(+), 20 deletions(-) rename _ru/{learn.md => online-courses.md} (99%) rename learn.md => online-courses.md (98%) diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml index 704fa69df6..772da79703 100644 --- a/_data/doc-nav-header.yml +++ b/_data/doc-nav-header.yml @@ -16,8 +16,6 @@ url: "/overviews/scala-book/introduction.html" - title: Online Courses url: "/online-courses.html" - - title: Online Resources - url: "/learn.html" - title: Scala 3 Migration url: "#" submenu: diff --git a/_fr/getting-started/install-scala.md b/_fr/getting-started/install-scala.md index a94b708cb0..76f7c537f9 100644 --- a/_fr/getting-started/install-scala.md +++ b/_fr/getting-started/install-scala.md @@ -188,7 +188,7 @@ Une fois que vous avez terminé le tutoriel ce dessus, vous pouvez consulter : * [The Scala Book](/scala3/book/introduction.html) ([Lien](/overviews/scala-book/introduction.html) vers la version Scala 2), qui fournit un ensemble de courtes leçons et introduit les fonctionnalités principales de Scala. * [The Tour of Scala](/tour/tour-of-scala.html) pour une introduction des fonctionnalités Scala. -* [Learning Resources](/learn.html), qui contient des tutoriels et des cours interactifs. +* [Learning Courses](/online-courses.html), qui contient des tutoriels et des cours interactifs. * [Our list of some popular Scala books](/books.html). * [The migration guide](/scala3/guides/migration/compatibility-intro.html) pour vous aider à migrer votre code Scala 2 vers Scala 3. diff --git a/_fr/tour/tour-of-scala.md b/_fr/tour/tour-of-scala.md index cb9fb2fcc6..f5d0f5d20a 100644 --- a/_fr/tour/tour-of-scala.md +++ b/_fr/tour/tour-of-scala.md @@ -14,8 +14,8 @@ Ce tour contient une introduction morceaux par morceaux aux fonctionnalités les utilisées en Scala. Il est adressé aux novices de Scala. Ceci est un bref tour du language, non pas un tutoriel complet. -Si vous recherchez un guide plus détaillé, il est préférable d'opter pour [un livre](/books.html) ou de consulter -[d'autres ressources](/learn.html). +Si vous recherchez un guide plus détaillé, il est préférable d'opter pour [un livre](/books.html) ou de suivre +[un cours en ligne](/online-courses.html). ## Qu'est-ce que le Scala ? Scala est un langage de programmation à multiples paradigmes désigné pour exprimer des motifs de programmation communs de diff --git a/_ja/getting-started/install-scala.md b/_ja/getting-started/install-scala.md index a72dab82b9..a85f87263c 100644 --- a/_ja/getting-started/install-scala.md +++ b/_ja/getting-started/install-scala.md @@ -170,7 +170,7 @@ IDE の使用に慣れている場合は、IDE から _Main.scala_ のコード * [The Scala Book](/scala3/book/introduction.html) (Scala 2版は[こちら](/overviews/scala-book/introduction.html))はScalaの主な機能を紹介する短いレッスンのセットを提供します。 * [The Tour of Scala](/tour/tour-of-scala.html) Scalaの機能を一口サイズで紹介します。 -* [Learning Resources](/learn.html) オンラインのインタラクティブなチュートリアルやコースです。 +* [Learning Courses](/online-courses.html) オンラインのインタラクティブなチュートリアルやコースです。 * [books](/books.html) 人気のある Scalaの 書籍を紹介します * [The migration guide](/scala3/guides/migration/compatibility-intro.html) 既存の Scala 2コードベースを Scala 3に移行する際に役立ちます。 diff --git a/_ja/tour/tour-of-scala.md b/_ja/tour/tour-of-scala.md index 9e5d2b9860..70c1e0f522 100644 --- a/_ja/tour/tour-of-scala.md +++ b/_ja/tour/tour-of-scala.md @@ -13,7 +13,7 @@ next-page: basics これはほんの短いツアーで、完全な言語のチュートリアルではありません。 もしそれを望むなら、[こちらの本](/books.html) を手に入れるか、 -[その他の解決手段](/learn.html) での相談を検討してください。 +[その他の解決手段](/online-courses.html) での相談を検討してください。 ## Scalaとは？ Scalaは一般的なプログラミング方法を簡潔かつエレガントかつ型安全な方法で表現するために設計されたモダンなマルチパラダイム言語です。 diff --git a/_ko/tour/tour-of-scala.md b/_ko/tour/tour-of-scala.md index 0c83ea5e0c..0bf0b28232 100644 --- a/_ko/tour/tour-of-scala.md +++ b/_ko/tour/tour-of-scala.md @@ -12,7 +12,7 @@ next-page: basics ## 투어를 환영합니다 이 투어에서는 스칼라에서 가장 자주 사용되는 기능을 요약하여 소개하며, 스칼라 초보자를 대상으로 합니다. -언어 전체를 다루는 튜토리얼이 아닌 간단히 둘러보기입니다. 자세히 다루고 싶다면, [책](/books.html)을 구하거나 [다른 자료](/learn.html)를 찾아보세요. +언어 전체를 다루는 튜토리얼이 아닌 간단히 둘러보기입니다. 자세히 다루고 싶다면, [책](/books.html)을 구하거나 [다른 자료](/online-courses.html)를 찾아보세요. ## 스칼라란? 스칼라는 일반적인 프로그래밍 패턴을 간결하고 우아하며 타입-세이프한 방식으로 표현할 수 있게 설계된 최신 멀티-패러다임 프로그래밍 언어입니다. 객체지향과 함수형 언어의 특징을 자연스럽게 통합합니다. diff --git a/_overviews/getting-started/install-scala.md b/_overviews/getting-started/install-scala.md index 9514530fa2..df32bb7c44 100644 --- a/_overviews/getting-started/install-scala.md +++ b/_overviews/getting-started/install-scala.md @@ -334,7 +334,7 @@ Now that you have tasted a little bit of Scala, you can further explore the lang * [The Scala Book](/scala3/book/introduction.html) (see the Scala 2 version [here](/overviews/scala-book/introduction.html)), which provides a set of short lessons introducing Scala’s main features. * [The Tour of Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. -* [Learning Resources](/learn.html), which includes online interactive tutorials and courses. +* [Learning Courses](/online-courses.html), which includes online interactive tutorials and courses. * [Our list of some popular Scala books](/books.html). There are also other tutorials for other build-tools you can use with Scala: diff --git a/_pl/tour/tour-of-scala.md b/_pl/tour/tour-of-scala.md index 05b70cc5de..76bdcc7091 100644 --- a/_pl/tour/tour-of-scala.md +++ b/_pl/tour/tour-of-scala.md @@ -12,7 +12,7 @@ next-page: basics Ten przewodnik składa się z drobnych wprowadzeń do najczęściej używanych funkcjonalności języka Scala. Jest to jedynie krótkie wprowadzenie, a nie pełny samouczek. -Jeżeli szukasz tego drugiego, rozważ jedną z [książek](/books.html) lub [inne zasoby](/learn.html). +Jeżeli szukasz tego drugiego, rozważ jedną z [książek](/books.html) lub [inne zasoby](/online-courses.html). ## Czym jest Scala? Scala jest nowoczesnym, wieloparadygmatowym językiem programowania zaprojektowanym do wyrażania powszechnych wzorców programistycznych w zwięzłym, eleganckim i bezpiecznie typowanym stylu. diff --git a/_ru/getting-started/install-scala.md b/_ru/getting-started/install-scala.md index f6968753f5..44154d2dfb 100644 --- a/_ru/getting-started/install-scala.md +++ b/_ru/getting-started/install-scala.md @@ -234,7 +234,7 @@ sbt — это инструмент сборки для Scala. sbt компил * [The Scala Book](/scala3/book/introduction.html) (см. версию для Scala 2 [здесь](/overviews/scala-book/introduction.html)), которая содержит набор коротких уроков, знакомящих с основными функциями Scala. * [The Tour of Scala](/ru/tour/tour-of-scala.html) для краткого ознакомления с функциями Scala. -* [Обучающие ресурсы](/learn.html), которые включают в себя интерактивные онлайн-учебники и курсы. +* [Обучающие ресурсы](/online-courses.html), которые включают в себя интерактивные онлайн-учебники и курсы. * [Наш список некоторых популярных книг по Scala](/books.html). * [Руководство по миграции](/scala3/guides/migration/compatibility-intro.html) поможет перенести существующую кодовую базу Scala 2 на Scala 3. diff --git a/_ru/learn.md b/_ru/online-courses.md similarity index 99% rename from _ru/learn.md rename to _ru/online-courses.md index 77aa925af8..2ec0c26bc9 100644 --- a/_ru/learn.md +++ b/_ru/online-courses.md @@ -2,6 +2,8 @@ title: Online ресурсы layout: singlepage-overview language: ru +redirect-from: + - /learn.html --- ## Попробуй Scala в своем браузере! diff --git a/_ru/scalacenter-courses.md b/_ru/scalacenter-courses.md index a4e76c3847..efa09f8254 100644 --- a/_ru/scalacenter-courses.md +++ b/_ru/scalacenter-courses.md @@ -153,7 +153,7 @@ testimonials: ## Другие онлайн-ресурсы -[На этой странице]({% link learn.md %}) вы можете найти другие онлайн-ресурсы, предоставленные сообществом. +[На этой странице]({% link online-courses.md %}) вы можете найти другие онлайн-ресурсы, предоставленные сообществом. [Scala Center]: https://scala.epfl.ch [Scala Specialization]: https://www.coursera.org/specializations/scala diff --git a/_ru/tour/tour-of-scala.md b/_ru/tour/tour-of-scala.md index f60a84e0b5..62f9fbe592 100644 --- a/_ru/tour/tour-of-scala.md +++ b/_ru/tour/tour-of-scala.md @@ -13,7 +13,7 @@ next-page: basics Этот обзор предназначен для новичков в изучении языка. Это лишь небольшая экскурсия, а не полный курс освоения языка. Для глубокого погружения рекомендуем почитать [книги](/books.html) или воспользоваться курсами -[на других ресурсах](/learn.html). +[на других ресурсах](/online-courses.html). ## Что такое Scala? diff --git a/_th/tour/tour-of-scala.md b/_th/tour/tour-of-scala.md index f10a88d77d..ab75a7d541 100644 --- a/_th/tour/tour-of-scala.md +++ b/_th/tour/tour-of-scala.md @@ -13,7 +13,7 @@ next-page: basics ## ยินดีต้อนรับสู่การเดินทาง การเดินทางครั้งนี้ประกอบด้วยการแนะนำแบบสั้นๆ สำหรับแต่ล่ะคุณสมบัติของ Scala ที่ใช้บ่อยที่สุด และมีมีความตั้งใจเพื่อสำหรับผู้ที่เรียนรู้ภาษา Scala ใหม่ -และนี่ก็เป็นเพียงบทความสั้นๆ ที่ไม่ใช้การสอนเต็มรูปแบบของภาษา Scala หากต้องการเรียนรู้มากขึ้นให้พิจารณา[หนังสือ](/books.html) หรือขอคำปรึกษาจาก[แหล่งอื่นๆ](/learn.html) +และนี่ก็เป็นเพียงบทความสั้นๆ ที่ไม่ใช้การสอนเต็มรูปแบบของภาษา Scala หากต้องการเรียนรู้มากขึ้นให้พิจารณา[หนังสือ](/books.html) หรือขอคำปรึกษาจาก[แหล่งอื่นๆ](/online-courses.html) ## อะไรคือ Scala? Scala เป็นภาษาเขียนโปรแกรมแบบหลากหลายกระบวนทัศน์ที่ทันสมัย ที่ออกแบบมาเพื่อแสดงรูปแบบการเขียนโปรแกรมโดยทั่วไปที่กระชับ สง่างาม และมีชนิดข้อมูลที่ปลอดภัย (type-safe) ซึ่งผสานคุณสมบัติของภาษาเชิงวัตถุและภาษาเชิงฟังก์ชัน diff --git a/_tour/tour-of-scala.md b/_tour/tour-of-scala.md index d5ea08ff15..16052b51f8 100644 --- a/_tour/tour-of-scala.md +++ b/_tour/tour-of-scala.md @@ -18,8 +18,8 @@ This tour contains bite-sized introductions to the most frequently used features of Scala. It is intended for newcomers to the language. This is just a brief tour, not a full language tutorial. If -you want a more detailed guide, consider obtaining [a book](/books.html) or consulting -[other resources](/learn.html). +you want a more detailed guide, consider obtaining [a book](/books.html) or taking +[an online courses](/online-courses.html). ## What is Scala? Scala is a modern multi-paradigm programming language designed to express common programming patterns in a concise, elegant, and type-safe way. It seamlessly integrates features of object-oriented and functional languages. diff --git a/_uk/getting-started/install-scala.md b/_uk/getting-started/install-scala.md index 9725b362e9..d8ae3efbd9 100644 --- a/_uk/getting-started/install-scala.md +++ b/_uk/getting-started/install-scala.md @@ -212,7 +212,7 @@ Scala version (default): {{site.scala-3-version}} * [Книга по Scala](/scala3/book/introduction.html) (версія по Scala 2 [тут](/overviews/scala-book/introduction.html)), яка містить коротких ознайомчих уроків з основних можливостей Scala. * [Тур по Scala](/tour/tour-of-scala.html) for bite-sized introductions to Scala's features. -* [Навчальні ресурси](/learn.html), що містять інтерактивні онлайн путівники та курси. +* [Навчальні ресурси](/online-courses.html), що містять інтерактивні онлайн путівники та курси. * [Наш список деяких популярних книжок по Scala](/books.html). * [Посібник з міграції](/scala3/guides/migration/compatibility-intro.html) допомагає перевести ваш наявний проєкт зі Scala 2 на Scala 3. diff --git a/_zh-cn/tour/tour-of-scala.md b/_zh-cn/tour/tour-of-scala.md index df7288f109..78b70dd115 100644 --- a/_zh-cn/tour/tour-of-scala.md +++ b/_zh-cn/tour/tour-of-scala.md @@ -13,7 +13,7 @@ next-page: basics ## 欢迎来到Scala之旅 本次 Scala 之旅教程包含了对于大多数 Scala 特性的简单介绍。主要针对 Scala 这门语言的初学者。 -这是个简化的教程，如果希望得到完整的话，可以考虑购买[书籍](/books.html)或者参考[其他资源](/learn.html)。 +这是个简化的教程，如果希望得到完整的话，可以考虑购买[书籍](/books.html)或者参考[其他资源](/online-courses.html)。 ## Scala是什么？ Scala是一门现代的多范式语言，志在以简洁、优雅及类型安全的方式来表达常用的编程模型。它平滑地集成了面向对象和函数式语言的特性。 diff --git a/learn.md b/online-courses.md similarity index 98% rename from learn.md rename to online-courses.md index 0ccd504d6b..e75cf92f08 100644 --- a/learn.md +++ b/online-courses.md @@ -1,9 +1,10 @@ --- -title: Online Resources +title: Online Courses layout: singlepage-overview languages: [ru] redirect_from: - /documentation/books.html + - /learn --- ## Try Scala in your browser! diff --git a/scalacenter-courses.md b/scalacenter-courses.md index faaf48cc46..b242e6f5fe 100644 --- a/scalacenter-courses.md +++ b/scalacenter-courses.md @@ -156,7 +156,7 @@ the (legacy) Scala 2 version of our courses here: ## Other Online Resources You can find other online resources contributed by the community on -[this page]({% link learn.md %}). +[this page]({% link online-courses.md %}). [Scala Center]: https://scala.epfl.ch [Scala Specialization]: https://www.coursera.org/specializations/scala From 1119bfc30808ae5d606f2718bd5369ac84c7119a Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Mon, 18 Nov 2024 16:17:40 +0100 Subject: [PATCH 3017/3075] Add details about Coursera and Extension School --- online-courses.md | 37 ++++++++++++++++++++++++++++++------- 1 file changed, 30 insertions(+), 7 deletions(-) diff --git a/online-courses.md b/online-courses.md index e75cf92f08..b951d8d1d5 100644 --- a/online-courses.md +++ b/online-courses.md @@ -7,16 +7,39 @@ redirect_from: - /learn --- -## Try Scala in your browser! +## Scala courses on Coursera by EPFL -There are a handful of websites where you can interactively run Scala code in your browser! Have a look at [Scastie](https://scastie.scala-lang.org/). +The [Scala Center](https://scala.epfl.ch) at EPFL offers free online courses of various levels, from beginner to advanced. + +For beginners: + +- [Effective Programming in Scala](https://www.coursera.org/learn/effective-scala): a practical introduction to Scala for professional developers +- [Functional Programming Principles in Scala](https://www.coursera.org/learn/scala-functional-programming): the foundational course by Martin Odersky, Scala's creator + +More advanced topics: + +- [Functional Program Design in Scala](https://www.coursera.org/learn/scala-functional-program-design): builds on functional principles with more advanced concepts +- [Parallel Programming](https://www.coursera.org/learn/scala-parallel-programming) +- [Big Data Analysis with Scala and Spark](https://www.coursera.org/learn/scala-spark-big-data) +- [Programming Reactive Systems](https://www.coursera.org/learn/scala-akka-reactive): introduces Akka, actors and reactive streams + +All courses are free to audit, with an option to pay for a certificate, to showcase your skills on your resume or LinkedIn. +For more on Scala Center's online courses, visit [this page](https://docs.scala-lang.org/online-courses.html#learning-platforms). -## Online courses from the Scala Center +## EPFL Extension School: Effective programming in Scala -The [Scala Center](https://scala.epfl.ch) is committed to creating high-quality -and freely available online courses for learning Scala and functional -programming. The course levels range from beginner to advanced. -More details on [this page]({% link scalacenter-courses.md %}). +Subscribing to [Effective programming in Scala](https://www.epfl.ch/education/continuing-education/effective-programming-in-scala/) on the EPFL Extension School offers: + +- Regular Q&A sessions and code reviews with experts from the Scala team +- An [Extension School certificate](https://www.epfl.ch/education/continuing-education/certifications/) upon completion + +This course combines video lessons, written content and hands-on exercise focused on practical aspects, including business domain modeling, error handling, data manipulation, and task parallelization. + +For more on Scala Center's online courses, visit [this page](https://docs.scala-lang.org/online-courses.html#learning-platforms). + +## Try Scala in your browser! + +There are a handful of websites where you can interactively run Scala code in your browser! Have a look at [Scastie](https://scastie.scala-lang.org/). ## Scala Exercises From 753d36d2068f526ed242c5cb93533239422502b3 Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Mon, 18 Nov 2024 16:19:27 +0100 Subject: [PATCH 3018/3075] Remove Scastie from Online Courses It's in the main navigation bar already, as Playground. --- online-courses.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/online-courses.md b/online-courses.md index b951d8d1d5..8d21ac6f57 100644 --- a/online-courses.md +++ b/online-courses.md @@ -37,10 +37,6 @@ This course combines video lessons, written content and hands-on exercise focuse For more on Scala Center's online courses, visit [this page](https://docs.scala-lang.org/online-courses.html#learning-platforms). -## Try Scala in your browser! - -There are a handful of websites where you can interactively run Scala code in your browser! Have a look at [Scastie](https://scastie.scala-lang.org/). - ## Scala Exercises [Scala Exercises](https://www.scala-exercises.org/) is a series of lessons and exercises created by [47 Degrees](https://www.47deg.com/). It's a great way to get a brief introduction to Scala while testing your knowledge along the way. From 49b23c51b69e91c18025bfd97e855f0905cff3ce Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Mon, 18 Nov 2024 16:20:54 +0100 Subject: [PATCH 3019/3075] Move Rock the JVM up --- online-courses.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/online-courses.md b/online-courses.md index 8d21ac6f57..aa20ebad55 100644 --- a/online-courses.md +++ b/online-courses.md @@ -37,6 +37,11 @@ This course combines video lessons, written content and hands-on exercise focuse For more on Scala Center's online courses, visit [this page](https://docs.scala-lang.org/online-courses.html#learning-platforms). +## Rock the JVM courses + +[Rock the JVM](https://rockthejvm.com) is a learning platform with free and premium courses on the Scala language, Akka, Cats Effect, ZIO, Apache Spark and other tools in the Scala ecosystem. +It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) and [articles](https://blog.rockthejvm.com) on a variety of Scala-related topics. + ## Scala Exercises [Scala Exercises](https://www.scala-exercises.org/) is a series of lessons and exercises created by [47 Degrees](https://www.47deg.com/). It's a great way to get a brief introduction to Scala while testing your knowledge along the way. @@ -61,8 +66,5 @@ You can visit his [YouTube channel](https://www.youtube.com/user/DrMarkCLewis/fe ## DevInsideYou [DevInsideYou](https://youtube.com/devinsideyou) is a YouTube channel with hundreds of hours of free Scala content. -## Rock the JVM -[Rock the JVM](https://rockthejvm.com) is a learning platform with free and premium courses on the Scala language, Akka, Cats Effect, ZIO, Apache Spark and other tools in the Scala ecosystem. It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) and [articles](https://blog.rockthejvm.com) on a variety of Scala-related topics. - ## Visual Scala Reference [Visual Scala Reference](https://superruzafa.github.io/visual-scala-reference/), a guide to visually learn about Scala concepts and functions. From 1d5a34276c1782dbb64195f6ae330f977c0393fe Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Mon, 18 Nov 2024 16:21:46 +0100 Subject: [PATCH 3020/3075] Add Other Online Resources section --- online-courses.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/online-courses.md b/online-courses.md index aa20ebad55..6d67bd2e47 100644 --- a/online-courses.md +++ b/online-courses.md @@ -42,13 +42,15 @@ For more on Scala Center's online courses, visit [this page](https://docs.scala- [Rock the JVM](https://rockthejvm.com) is a learning platform with free and premium courses on the Scala language, Akka, Cats Effect, ZIO, Apache Spark and other tools in the Scala ecosystem. It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) and [articles](https://blog.rockthejvm.com) on a variety of Scala-related topics. -## Scala Exercises +## Other Online Resources + +### Scala Exercises [Scala Exercises](https://www.scala-exercises.org/) is a series of lessons and exercises created by [47 Degrees](https://www.47deg.com/). It's a great way to get a brief introduction to Scala while testing your knowledge along the way. [Tour of Scala](https://tourofscala.com) gives you an introduction to Scala, step by step, from beginner to expert. -## Dr. Mark C Lewis's lectures from Trinity University +### Dr. Mark C Lewis's lectures from Trinity University [Dr. Mark C Lewis](https://www.cs.trinity.edu/~mlewis/) from Trinity University, San Antonio, TX, teaches programming courses using the Scala language. Course videos are available in YouTube for free. Some courses below. @@ -57,14 +59,14 @@ It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) a You can visit his [YouTube channel](https://www.youtube.com/user/DrMarkCLewis/featured) for more videos. -## Scala Learning Community +### Scala Learning Community [Scala Learning Community on Discord](http://sca.la/learning-community), a growing online community connecting learners with online resources to learn Scala together. -## allaboutscala +### allaboutscala [allaboutscala](https://allaboutscala.com/) provides detailed tutorials for beginners. -## DevInsideYou +### DevInsideYou [DevInsideYou](https://youtube.com/devinsideyou) is a YouTube channel with hundreds of hours of free Scala content. -## Visual Scala Reference +### Visual Scala Reference [Visual Scala Reference](https://superruzafa.github.io/visual-scala-reference/), a guide to visually learn about Scala concepts and functions. From 4cc33391c026f3e319d4c2406b7e0dfa2e83ab41 Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Mon, 18 Nov 2024 16:25:25 +0100 Subject: [PATCH 3021/3075] Split 'Tour of Scala' and 'Scala Exercices' Also move 'Scala Learning Community' to 'Tour of Scala' It's not an official Scala discord and it is maintained by the Tour of Scala community --- online-courses.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/online-courses.md b/online-courses.md index 6d67bd2e47..7e296c77af 100644 --- a/online-courses.md +++ b/online-courses.md @@ -44,11 +44,18 @@ It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) a ## Other Online Resources -### Scala Exercises +### Tour of Scala + +[Tour of Scala](https://tourofscala.com) is an interactive website that introduces the basics of Scala programming through a series of hands-on lessons. +Each lesson provides code examples and exercises that compiles and runs directly in the browser, making it a quick and accessible way to get started with Scala. -[Scala Exercises](https://www.scala-exercises.org/) is a series of lessons and exercises created by [47 Degrees](https://www.47deg.com/). It's a great way to get a brief introduction to Scala while testing your knowledge along the way. +In the [Scala Learning Discord](http://sca.la/learning-community), you can connect with fellow Scala learners and engage with the Tour of Scala community. -[Tour of Scala](https://tourofscala.com) gives you an introduction to Scala, step by step, from beginner to expert. +### Scala Exercises + +[Scala Exercises](https://www.scala-exercises.org/) is a series of lessons and exercises created by [47 Degrees](https://www.47deg.com/). +It's a great way to get a brief introduction to Scala while testing your knowledge along the way. +It also covers some libraries of the ecosystem such as cats, doobie, scalacheck etc. ### Dr. Mark C Lewis's lectures from Trinity University @@ -59,9 +66,6 @@ It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) a You can visit his [YouTube channel](https://www.youtube.com/user/DrMarkCLewis/featured) for more videos. -### Scala Learning Community -[Scala Learning Community on Discord](http://sca.la/learning-community), a growing online community connecting learners with online resources to learn Scala together. - ### allaboutscala [allaboutscala](https://allaboutscala.com/) provides detailed tutorials for beginners. From e0a9cd9e7453288078622f0418ad7955a8cbfc9d Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Mon, 18 Nov 2024 16:39:07 +0100 Subject: [PATCH 3022/3075] Reorder other resources Most up-to-date first --- online-courses.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/online-courses.md b/online-courses.md index 7e296c77af..9138dcc31d 100644 --- a/online-courses.md +++ b/online-courses.md @@ -57,20 +57,23 @@ In the [Scala Learning Discord](http://sca.la/learning-community), you can conne It's a great way to get a brief introduction to Scala while testing your knowledge along the way. It also covers some libraries of the ecosystem such as cats, doobie, scalacheck etc. -### Dr. Mark C Lewis's lectures from Trinity University +### DevInsideYou -[Dr. Mark C Lewis](https://www.cs.trinity.edu/~mlewis/) from Trinity University, San Antonio, TX, teaches programming courses using the Scala language. Course videos are available in YouTube for free. Some courses below. +[DevInsideYou](https://youtube.com/devinsideyou) is a YouTube channel with hundreds of hours of free Scala content. - * [Introduction to Programming and Problem Solving Using Scala](https://www.youtube.com/playlist?list=PLLMXbkbDbVt9MIJ9DV4ps-_trOzWtphYO) - * [Object-Orientation, Abstraction, and Data Structures Using Scala](https://www.youtube.com/playlist?list=PLLMXbkbDbVt8JLumqKj-3BlHmEXPIfR42) +### Visual Scala Reference -You can visit his [YouTube channel](https://www.youtube.com/user/DrMarkCLewis/featured) for more videos. +[Visual Scala Reference](https://superruzafa.github.io/visual-scala-reference/) is a visual guide to the most common methods of the Scala collections. ### allaboutscala + [allaboutscala](https://allaboutscala.com/) provides detailed tutorials for beginners. -### DevInsideYou -[DevInsideYou](https://youtube.com/devinsideyou) is a YouTube channel with hundreds of hours of free Scala content. +### Dr. Mark C Lewis's lectures from Trinity University -### Visual Scala Reference -[Visual Scala Reference](https://superruzafa.github.io/visual-scala-reference/), a guide to visually learn about Scala concepts and functions. +[Dr. Mark C Lewis](https://www.cs.trinity.edu/~mlewis/) from Trinity University, San Antonio, TX, teaches programming courses using the Scala language. Course videos are available in YouTube for free. Some courses below. + +- [Introduction to Programming and Problem Solving Using Scala](https://www.youtube.com/playlist?list=PLLMXbkbDbVt9MIJ9DV4ps-_trOzWtphYO) +- [Object-Orientation, Abstraction, and Data Structures Using Scala](https://www.youtube.com/playlist?list=PLLMXbkbDbVt8JLumqKj-3BlHmEXPIfR42) + +You can visit his [YouTube channel](https://www.youtube.com/user/DrMarkCLewis/featured) for more videos. From a1f6ae5930a8290d3bdf2b294c6cbb620dc73b09 Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Wed, 20 Nov 2024 11:57:10 +0100 Subject: [PATCH 3023/3075] Add new online-courses layout with catchy images --- _includes/_markdown/courses-coursera.md | 18 ++++ .../_markdown/courses-extension-school.md | 9 ++ _includes/_markdown/courses-rock-the-jvm.md | 4 + _includes/markdown.html | 4 +- _includes/online-courses-box.html | 12 +++ _includes/online-courses.html | 91 ------------------ _layouts/online-courses.html | 29 ++++++ _layouts/root-index-layout.html | 3 +- _sass/layout/inner-main.scss | 4 + _sass/layout/online-courses.scss | 45 +++++++++ online-courses.md | 38 +------- resources/css/style.scss | 1 + resources/images/online-courses/coursera.png | Bin 0 -> 74688 bytes .../online-courses/extension-school.png | Bin 0 -> 720219 bytes .../images/online-courses/rock-the-jvm.png | Bin 0 -> 613546 bytes 15 files changed, 126 insertions(+), 132 deletions(-) create mode 100644 _includes/_markdown/courses-coursera.md create mode 100644 _includes/_markdown/courses-extension-school.md create mode 100644 _includes/_markdown/courses-rock-the-jvm.md create mode 100644 _includes/online-courses-box.html delete mode 100644 _includes/online-courses.html create mode 100644 _layouts/online-courses.html create mode 100644 _sass/layout/online-courses.scss create mode 100644 resources/images/online-courses/coursera.png create mode 100644 resources/images/online-courses/extension-school.png create mode 100644 resources/images/online-courses/rock-the-jvm.png diff --git a/_includes/_markdown/courses-coursera.md b/_includes/_markdown/courses-coursera.md new file mode 100644 index 0000000000..403c5e3100 --- /dev/null +++ b/_includes/_markdown/courses-coursera.md @@ -0,0 +1,18 @@ +## Scala Courses on Coursera by EPFL + +The [Scala Center](https://scala.epfl.ch) at EPFL offers free online courses of various levels, from beginner to advanced. + +For beginners: + +- [Effective Programming in Scala](https://www.coursera.org/learn/effective-scala): a practical introduction to Scala for professional developers +- [Functional Programming Principles in Scala](https://www.coursera.org/learn/scala-functional-programming): the foundational course by Martin Odersky, Scala's creator + +More advanced topics: + +- [Functional Program Design in Scala](https://www.coursera.org/learn/scala-functional-program-design): builds on functional principles with more advanced concepts +- [Parallel Programming](https://www.coursera.org/learn/scala-parallel-programming) +- [Big Data Analysis with Scala and Spark](https://www.coursera.org/learn/scala-spark-big-data) +- [Programming Reactive Systems](https://www.coursera.org/learn/scala-akka-reactive): introduces Akka, actors and reactive streams + +All courses are free to audit, with an option to pay for a certificate, to showcase your skills on your resume or LinkedIn. +For more on Scala Center's online courses, visit [this page](https://docs.scala-lang.org/online-courses.html#learning-platforms). diff --git a/_includes/_markdown/courses-extension-school.md b/_includes/_markdown/courses-extension-school.md new file mode 100644 index 0000000000..003c42a4f2 --- /dev/null +++ b/_includes/_markdown/courses-extension-school.md @@ -0,0 +1,9 @@ +## EPFL Extension School: Effective Programming in Scala + +Subscribing to [Effective programming in Scala](https://www.epfl.ch/education/continuing-education/effective-programming-in-scala/) on the EPFL Extension School offers: + +- Regular Q&A sessions and code reviews with experts from the Scala team +- An [Extension School certificate](https://www.epfl.ch/education/continuing-education/certifications/) upon completion + +This course combines video lessons, written content and hands-on exercise focused on practical aspects, including business domain modeling, error handling, data manipulation, and task parallelization. +For more on Scala Center's online courses, visit [this page](https://docs.scala-lang.org/online-courses.html#learning-platforms). diff --git a/_includes/_markdown/courses-rock-the-jvm.md b/_includes/_markdown/courses-rock-the-jvm.md new file mode 100644 index 0000000000..3e01565500 --- /dev/null +++ b/_includes/_markdown/courses-rock-the-jvm.md @@ -0,0 +1,4 @@ +## Rock the JVM Courses + +[Rock the JVM](https://rockthejvm.com) is a learning platform with free and premium courses on the Scala language, Akka, Cats Effect, ZIO, Apache Spark and other tools in the Scala ecosystem. +It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) and [articles](https://blog.rockthejvm.com) on a variety of Scala-related topics. diff --git a/_includes/markdown.html b/_includes/markdown.html index cd79243a41..886b1560cd 100644 --- a/_includes/markdown.html +++ b/_includes/markdown.html @@ -1,3 +1 @@ -{%if include.selector%}<{{include.selector}} {%if include.classes%}class="{{include.classes}}"{%endif%} {%if include.id%}id="{{include.id}}{%endif%}">{%endif%} - {% capture markdown %}{% include {{include.path}} %}{% endcapture %}{{ markdown | markdownify }} -{%if include.selector%}{%endif%} +{% capture markdown %}{% include {{include.path}} %}{% endcapture %}{{ markdown | markdownify }} diff --git a/_includes/online-courses-box.html b/_includes/online-courses-box.html new file mode 100644 index 0000000000..ef06306b9b --- /dev/null +++ b/_includes/online-courses-box.html @@ -0,0 +1,12 @@ +
    +
    +
    + + + +
    +
    + {% include markdown.html path=include.path %} +
    +
    +
    diff --git a/_includes/online-courses.html b/_includes/online-courses.html deleted file mode 100644 index 73fba6a50c..0000000000 --- a/_includes/online-courses.html +++ /dev/null @@ -1,91 +0,0 @@ - -
    -
    -

    Online Courses

    -
    - - {% comment %} - We're going to follow the next ordering for the online courses: - 1- First we'll show those items that belong to an specific specialization (i.e.: Scala's progfun in Coursera). Those will be ordered alphabetically by title and each item under the specialization by the `specialization-order` tag in each one. - 2- After those, courses that don't belong to any specific specialization. - We'll only show those courses that are not finished yet. - {% endcomment %} - - {% assign specializations = '' | split: ',' %} - {% assign courses = '' | split: ',' %} - {% assign upcomingCourses = '' | split: ',' %} - {% capture now %}{{site.time | date: '%s' | plus: 0}}{% endcapture %} - - {% for course in site.online_courses %} - {% unless specializations contains course.specialization %} - {% assign specializations = specializations | push: course.specialization %} - {% endunless %} - - {% capture endDate %}{{course.end-date | date: '%s' | plus: 86400}}{% endcapture %} - {% if now <= endDate %} - {% assign upcomingCourses = upcomingCourses | push: course %} - {% endif %} - {% endfor %} - - {% for specialization in specializations %} - {% assign specCourses = '' | split: ',' %} - - {% for course in upcomingCourses %} - {% if course.specialization %} - {% if course.specialization == specialization %} - {% assign specCourses = specCourses | push: course %} - {% endif %} - - {% assign sortedSpecCourses = specCourses | sort: 'specialization-order' %} - {% endif %} - {% endfor %} - {% for sortedCourse in sortedSpecCourses %} - {% assign courses = courses | push: sortedCourse %} - {% endfor %} - {% endfor %} - - {% for course in upcomingCourses %} - {% unless course.specialization %} - {% assign courses = courses | push: course %} - {% endunless %} - {% endfor %} - -
    - {% for course in courses %} - - -
    -

    {{course.title}}

    -
      -
    • - {% if course.paid == true %} - {{site.data.common.texts.onlineCoursesPaid}} - {% else %} - {{site.data.common.texts.onlineCoursesFree}} - {% endif %} -
      • -
    • •
      • -
    • - {% if course.showDate == true %} - {{course.date | date_to_string}} - {% else %} - {{site.data.common.texts.courseraLaunchPeriod}} - {% endif %} -
      • -
    -
    -     - {% endfor %} -
    -
    -

    Visit all the Online Courses courses

    -
    -
    \ No newline at end of file diff --git a/_layouts/online-courses.html b/_layouts/online-courses.html new file mode 100644 index 0000000000..71715f042a --- /dev/null +++ b/_layouts/online-courses.html @@ -0,0 +1,29 @@ +--- +layout: root-index-layout +--- + + +
    +
    +
    + {% include online-courses-box.html + path="_markdown/courses-coursera.md" + image="coursera.png" + link="https://www.coursera.org/learn/scala-functional-programming" + %} + {% include online-courses-box.html + path="_markdown/courses-extension-school.md" + image="extension-school.png" + link="https://www.epfl.ch/education/continuing-education/effective-programming-in-scala/" + %} + {% include online-courses-box.html + path="_markdown/courses-rock-the-jvm.md" + image="rock-the-jvm.png" + link="https://rockthejvm.com" + %} +
    + {{content}} +
    +
    +
    +
    diff --git a/_layouts/root-index-layout.html b/_layouts/root-index-layout.html index d83b64596f..c236bb7b2f 100644 --- a/_layouts/root-index-layout.html +++ b/_layouts/root-index-layout.html @@ -25,7 +25,8 @@

    {{page.title}}

    - {% comment %}Specific content from child layouts{% endcomment %} {{content}} + {% comment %}Specific content from child layouts{% endcomment %} + {{content}} diff --git a/_sass/layout/inner-main.scss b/_sass/layout/inner-main.scss index ca359a7355..64074851c8 100755 --- a/_sass/layout/inner-main.scss +++ b/_sass/layout/inner-main.scss @@ -13,6 +13,10 @@ padding-bottom: $padding-xlarge; .inner-box { + margin-bottom: 30px; + &:last-child { + margin-bottom: 0; + } padding: $padding-medium; background: #fff; @include border-radius($border-radius-base); diff --git a/_sass/layout/online-courses.scss b/_sass/layout/online-courses.scss new file mode 100644 index 0000000000..e9410fcf02 --- /dev/null +++ b/_sass/layout/online-courses.scss @@ -0,0 +1,45 @@ +.online-courses { + margin-bottom: 30px; +} + +.online-courses-wrapper { + @include clearfix; +} + +.online-courses-image { + @include span-columns(5); + @include bp(medium) { + @include span-columns(12); + } + + img { + margin-bottom: 0; + } +} + +.online-courses-content { + @include span-columns(7); + @include bp(medium) { + @include span-columns(12); + } + + h2 { + margin-top: 16px; + margin-bottom: 16px; + } + + blockquote, + p, + pre, + table, + ul { + margin-bottom: 8px; + } + + ol, + ul { + li { + margin-bottom: 4px; + } + } +} diff --git a/online-courses.md b/online-courses.md index 9138dcc31d..6b65a5115f 100644 --- a/online-courses.md +++ b/online-courses.md @@ -1,47 +1,11 @@ --- title: Online Courses -layout: singlepage-overview -languages: [ru] +layout: online-courses redirect_from: - /documentation/books.html - /learn --- -## Scala courses on Coursera by EPFL - -The [Scala Center](https://scala.epfl.ch) at EPFL offers free online courses of various levels, from beginner to advanced. - -For beginners: - -- [Effective Programming in Scala](https://www.coursera.org/learn/effective-scala): a practical introduction to Scala for professional developers -- [Functional Programming Principles in Scala](https://www.coursera.org/learn/scala-functional-programming): the foundational course by Martin Odersky, Scala's creator - -More advanced topics: - -- [Functional Program Design in Scala](https://www.coursera.org/learn/scala-functional-program-design): builds on functional principles with more advanced concepts -- [Parallel Programming](https://www.coursera.org/learn/scala-parallel-programming) -- [Big Data Analysis with Scala and Spark](https://www.coursera.org/learn/scala-spark-big-data) -- [Programming Reactive Systems](https://www.coursera.org/learn/scala-akka-reactive): introduces Akka, actors and reactive streams - -All courses are free to audit, with an option to pay for a certificate, to showcase your skills on your resume or LinkedIn. -For more on Scala Center's online courses, visit [this page](https://docs.scala-lang.org/online-courses.html#learning-platforms). - -## EPFL Extension School: Effective programming in Scala - -Subscribing to [Effective programming in Scala](https://www.epfl.ch/education/continuing-education/effective-programming-in-scala/) on the EPFL Extension School offers: - -- Regular Q&A sessions and code reviews with experts from the Scala team -- An [Extension School certificate](https://www.epfl.ch/education/continuing-education/certifications/) upon completion - -This course combines video lessons, written content and hands-on exercise focused on practical aspects, including business domain modeling, error handling, data manipulation, and task parallelization. - -For more on Scala Center's online courses, visit [this page](https://docs.scala-lang.org/online-courses.html#learning-platforms). - -## Rock the JVM courses - -[Rock the JVM](https://rockthejvm.com) is a learning platform with free and premium courses on the Scala language, Akka, Cats Effect, ZIO, Apache Spark and other tools in the Scala ecosystem. -It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) and [articles](https://blog.rockthejvm.com) on a variety of Scala-related topics. - ## Other Online Resources ### Tour of Scala diff --git a/resources/css/style.scss b/resources/css/style.scss index 938b0974e8..5f30379a90 100755 --- a/resources/css/style.scss +++ b/resources/css/style.scss @@ -55,6 +55,7 @@ @import 'layout/training-events'; @import 'layout/blog'; @import 'layout/download'; +@import 'layout/online-courses'; @import 'layout/content-contributors'; // COMPONENTS @import 'layout/details-summary'; //------------------------------------------------ diff --git a/resources/images/online-courses/coursera.png b/resources/images/online-courses/coursera.png new file mode 100644 index 0000000000000000000000000000000000000000..a329139aa0cab926881d257155531966fbe6a93c GIT binary patch literal 74688 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 T)$5%F#>|35=)((d*gpFo&|aJ5 literal 0 HcmV?d00001 diff --git a/resources/images/online-courses/extension-school.png b/resources/images/online-courses/extension-school.png new file mode 100644 index 0000000000000000000000000000000000000000..94da532d8c1d49d0a8145acb900adf3003d150f8 GIT binary patch literal 720219 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≫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
  • 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

    }JI~i+UM7qN1Dr$v}`} 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

    2np*D7bv31Q*o(3k_skhUYe%%=m@WIIf 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,b5MZFykkj$w7w-*dYjr_W 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 literal 0 HcmV?d00001 diff --git a/resources/images/online-courses/rock-the-jvm.png b/resources/images/online-courses/rock-the-jvm.png new file mode 100644 index 0000000000000000000000000000000000000000..216a8a73c4b6be8532e9b424dc2b971a732b987f GIT binary patch literal 613546 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∨=7SI!_ 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%0Dd1TJURV388 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�EehcY0xFBfD`Kynwt6S6=D@3(o1%E{Z!YH+8T|j zbn0};(=NzZ)4Ggi(Q$!4Jw=GT#WTuA%LZy3K8{|l>^(-1#WnYLCi9k0bmq<%dsI{I z)yMi3$4I*%|b>qZrPe<#lDtRa4xbkVRG^%{-w4 zLa;>mzl=k^8KOH|Eb~xsOTcpZn4CpYI4ZKl^RHIrIlywrJR+lot=I3a!k&f%B(%O* zI(2_1%>kFd4T<~!GSx?tz-?N6rSte2DbP}#Ep)(pImzj_q+^)^N@)#7v|J2pH& zOaQ&CTXg|NIaAdqRbd?hMY>NF&NNL>#8{B0J=Q%`w>GjX(@{v1l73PgdkMSjs}?up z)Kl5Z{YfV)CPed_vR$UHMPh(AxxqvZKzebd0%MuqNGK(e?R4NcZtv7?C@4Ub-zTcI z2^RgP?r+zVFYQf=ggcLh3y;kCfYe=a62@d2R1JomE{hvKy^z1d^YZxkf$+O@$-w{Y zS-Nbj+H49Px(ge|O;cGcL#(p%S~t-0X^D!wxG4lZ%uxvO2-m1bN+tonoWh;W76pq6cr~G(S|bZtsup$+e)Kg+M0hw zT6Grg<{%sf&mU;pk;T|!_RSM^aZpibDlld#Sf#nxIvQ#7^VHGc-m8bw()`fzwELl_ zHlrr2Qw3=0W+}IRyF1g@%|Co%dni~HEkD%7KoRzE*0E9nvLOrgz5#wj_V^pD&MA`W zR6Vs?n@;&D?>~}kn#EB&iSY1;lk8k8!G;dZ!50O{*Hfa@$q650DkpOZ-mRz*w6ljz z!asR`kcb0kgBU7Cdp?^x;U%u-jeI|&LKDkR(S{3>?8ll(-(`G~t#p@$@F(aSXOsp3S*Q>GVCDd+RguQdrif@Lj&P_+bxep?`71pA0w`3Zui$s zd7`%3RZ!Tq6qeW6%GWTUI66Ilf%-*)XcnPtlv#sDs%9Bp5d%P@{$)@N6=Vyjf5YEKsQi~PmENP438q1Zwz2N{Jy5g91o!<44Ykd)=?i`s zRh|dx_4c>Q$I&GpxOz26??k;klu=4gp&nVc`4$m8K!<@S1Qy3A4W!k@kRo)%IY9td z*q%b${MZq#oyNU`p>^Rh3BwqgkUcbKD@peqIg5o^mKa2Vv z#+;zDAmUj~qW`sba?^mIX>Es2{E#6(jhgZD(+}@Q)yqOf{ip#`%wd6zkv-q-iFIoe z=ayLnh`_Jw}rj$|#6X zZsRL(K8cu^@8XVgxWTjsXU0g{AOY5nu3v#J>KG^?!VEFnuD9X#LYbD-%;HZ;HE3Bq zp)F`oQ9q#zpc?VDsZvziLYihEq8shv@p;B-#Bc2GP)tm{jT;{NYQ< zys4!(N>ljL(6n_8s#aWFVul!LN_nagMN{St813%w$^=u=TkSk<61m!pF0y7tbk#8b zuu@$vUM^pV;zqh_o^@|p9;vUj8gk%!sS`zP(NLh|*=1g8pu3IxiGso&syd2^$W-PL zhR+mqjwT>yJv*$!fFOPystY&7kmo%uX0pO0WMRULM)bY^pGmhlZ*8FaE{zCd#U)`S ziGenRB!LX=cC6CUM1|;AJEDzWP2_$DFTI=XG(mKs=iaP$?iO!Bly&uNO6@Qzxd4iV zlkIexK=xcY6-Tg)xMNP0g1A#m9;loSmU|~`Tm6(n2f-bUscS2s%bq(Q!PFgy^;>Xk zLA6r8z=(oswOG``>A)0S!5fek>sSnDYKDqEgD)J^JHu_Q z^g!4i)BbJbF{QeZ-9c*|UXBG^LsgTfHTrM~`WkO~k13kjGGp{+D6D8L6H*hQ#%pE? zsHl-?Mn=2SN3=*obTh#vo(TWJOr1Z34(tHtJNg@j1I%a3PamEYsc)i*qH>NxM3T48 zh*?{dO$C<}-99iQ>;OTEJ$(#6U``tlugK?uaR?pzFCC5SA{_gl&oJOg-m$rz$aW>s zvnAaBsByvfCo*Y4c#&Nl4-=9gblp`T{v{rd3hRVBR1UocK@0Q=baqeW+Inx!(D#&7 z6>&%Qr);u&pLoen82zS1P+#O1YmlNFp=~K97OfWzS-WFNdv)Yzl?IxG0!Us&gmBrH zrK#VCtG%+FE%F=O;_EsQ;|_Y z8^8=+nCm0tzP8L9O87C12k8OIqh^@_4iTJCzZYWMXGMuetwrht z`uHhHDI;V@vL-OmGDxNdUQI;1f5YT5!CRZ)L5Ql|n(fapFU{w$%oMVuTa!d9B8knf zI6smusq>B{&@XthVh2LA{qFfBuV1(!z<1q%|D}U)a z^rN@nWvpEh*iv|4kR~buwH9}^>~7^xXGv>7Mrvi!`&Bb@kU%#;SSZPs@da~D%pckd zI=faQkZ~Tp+k%%$oK^mSr(qZsXhOJ2uOxHH7|l4#N4kB;jF}j8r)Qzd{)q)rNMkIx zDO!_ie^ob#>N4jD8e27NGd$S~tp{E|4_B@*r$B)FHhsvC?_71sqHKWB3($ZRcu9VE zovOr3IJuncNWKAlZC?s1>KFKCMD#clDMz`wKUvg%M{8PD%X}|D3h4ce{LS{mDy*r@ zlNLQUkcf~^Z<2`m>b4zHf4+M7m$f-|;afuu|A)CZAj2$lQQ79``ag?#7TM05*ty0h z!5IIexw#NCxH3;D^v_~8DNp?x$?!e3$X|Gg-|~2gKFq^LB7~eyJQCgw&S&loBwXVT zvcI(+Ye#X_5DB7(uqV=rFcHM5BsfJPB8NF1k=0?k)`owpZ@OETmQk4&GPAI7`;Z2d zXTbiCT2y4F0AEKP(0x{(3;JW+QYsf6e?|#*6|*$$*VkS1eSg$~?_c#1j1PMZz5TIj z0~^vC;I-4ssay020YkB^6U1j{Tg*y)hHp;R|nwvj6cUc#QcIfHV=N@bML8wgheW%5>#F1pn=!&XHaxv6XD zv!?ooDdDh14ZdHRrY~bOPFr98DNxFOsmQO@q`gDKQddGW3GY*P8Zz#o^-k z`?DP{10H#5KRYR8Et}j^tgDbc>?_!TX6f2`kqo_U_*L*dMK9_y*SwX*&q&?>lm4KJ znM0haXxsZlR80opfOz!~G!f1N871-&)L(bhjVZTx{eJw`Ea4O9Zs@=Ly4I1dQB;nT zUDGFyo-Q+_^?=%BZwdWiiul?C`Qa|U%DtU26wwHU| zJreYc7SHJrZhbF)rueCy#cDfzHE9!)yBK@gcfXEQ7o6R&X+SulSg=NaT2m63b!b5N zpBg1wq#E!d?0c#%A>IX$NGFrUsB|`7OliA3`KQMVKJ`#HFE1{>h23|h?>k})Z16=) zUA#X;bXjd&PQFJ6+>T!aTkzB zI}yKdadU?PY1ATFkq@)Ge}CHO>h!fZvsc#doUGS2)J6ILdLMefY~J#Z=&+#zAtfee z6VDCxRhe7p7KquXr?*sVJmMFc%FkSNQe!DrRjNQE>Se^;JAYY`;nR~ToiF{O@XVBx zU|~)(*q7JvA!jEhX?J{gxs8-jby%`3H;uolswrP0K)%e`_3%xSp-@WG(1Ud){_kEY zSDEs>NE;zJNV8gNGkUaauC!fGNL}6E72@BPi=k#&QExXg?q8jZ>Ck$>|DNm2WU%2^ z#`isBEbo-0zdR&Eyl#G?tGwl5_l0wVG$-jc+lo!|qzhWTPWk0NA&t_zcCMsfSa!+BqdwIUo7PF`2G`21{CP1 z8x0zN{#rO;WfxlG8(3ZRr2XJgfs}f}Bq7e!h4Pcp`j6`FT=(&|AkSQlR zApFqKRM1kvTI+lw(PXZ`u^rRF9Q)Vo$BE;$tohNJWS-!|Qe4VD zI^l9sjgw;wjmt;Z)-rn-C0!y!^kmaruFC(m1$b=@uiYto%EctKX%p3>RNb>Uz;W*I zPe6cVg*QDV1|Xo<0mIIC2C2XwJO%}$*(gOJd36PDBqva_aB(r85|_P4!wF%@r2b|s zV|Fn`46ktb(UE#dAuE7@1^$D&ypG*3#DyPRI;X8qchzY@7GHT%V`OXeiFq`p-@*<5 zahO$XPWG@*TZJ8pR_v2;*(QR=Ah8J*npqn3<3KoV@a;5I1xbFXYNSW>N+P=d5SCE5 zIW3I0IVf%@Eu`c>-|d38z<)3rx8nLG5gP#YCBq|iN(4@ILu(@99-%04NiW}6AJ!uH zmpY)!j;OZZfRkPYbdNts49=KSjMd~|W^PRrtiuhNbs=Yf$zP_pG&kvy2Ss0OO8IzCpcIs6*R@-V6`$21Q^pK zh@7oDmO`>JcQRzu7B7PW=!><$b7IH9Y)LkMI2d^9?hMN6<3OsyLGM0E8Qz^3<_AEL z-V9>qH+miXV3T4rG(2e91S8|dQ1k~D4h$fatj)!}bzA=#Z-SSCj6-M)A>wWJ=N3N4aAIqF7%VHdnEN*7O?Rz8~~R=Ab5jo4wRY3=2LtEOa~E ztSRmgih}Xq#A1yJlr24m8V)1iMXHQ$h3QMTa<&TC82ot8UWt#H$X=>0HG(V>UntS= z5C}%vu=yg&%G#W^Q}o=hjr;pv_Tk!!DV*-4A*rTwSA#nmSRmAyEbg_7T`?S@dL+cFisxi*uad>vy_ zYe+Pzn^XY=kf5jlv)O12q3Z-}Mt}Cz^08)8L(=EzbrMlf5j)@sM`7G4nJuV3labPL zVNy+tjQRR6X_tauswUb;lI}3Z1JxWh1sC+vEj9&#{q!l~JgkHfyKcvzuLVuFYjmq_ zGYkuqlo9HOr}^~YDT2I-gu`*Y%c~Ft(S(7*i_1e+b#S!MQ;3-3cNYhBC4v;57To?i z=F^Eksa7ul6(J>%yZMgkU7c-_hnrHj^C_R}adi84dQ{mR!f0nEMhQE*&{=BwS`Z#! zAjeAos&Nm%XAbXc$2y;mYO7_iTNbzH}8|d*}MTtA&ToFBM)z!3cO01E6(zKzdXebZ99^%Gfbf zfl`%j_`}-+&`&|X3N|m@IDV|g1ckEni~A?{B?+F1S8Cgrqf${*NPQ2Fu*Fi_2E)k7 zSilq~X4&*uvrORp_PRrf5A5amXs_0j%FQ#Ul$A&$zyBw(mdu1bjZh#^HW(b@Pzi|s zT=Mby{ujy=RA!RqRMVf*CiHxxCl;BYxuYM$6&0@yNl5-_pN=~$lPK@$U)3ZYq^DvZ zB2!C|Nd~jSIGo$K{;zF&@X1k|5#rDpkCKY`Re(YK9lTg9X&Iut^ zzZ!Xg%pp60?dAg|D#KL&9nV<|O?Zz4UUFC+MA~ExBt*2r{wUE+Zark}p2J0izLU}w z%Z?{|q(aR51w$jVPQu=fP$A-q!&z)P{RfZI%H`+9k6}(m?YZh+w5vFwI6V13_#j^* zc&IYKfsBCBTM%}OR^M8-RJG!_jT_9z$JIFi?N<6U3%L`$Q_d5^N2ReQ$$*}T~( z5V#~0F&U_oDrsHq^wtDOaJ_wAK>0trsubd_4Yabf9s`#>!^uLd^wQ9I$wr`Fw=_i$ z2co@PnsILMxz$iqO~((7)Xt#chLEz6$-6@<{-`?t80G)f^dG(OS147>OrM&MX_+NJOI-Knm$PTv~7s zt0w$3I?3BiE1}k>%eCe`@xW*cCyilUgpn}QC1rj>4KxiRLLFlGeqd=rJeCNV-^m|c z2+1EX>b9`VgDr)$Tzo8_M&9QdV1tBht~@sYNxf# z*2$|rf#!~gcz`0=p}RiDdbkpa7RsDF&^Dx&%%y?U>|Kc`G9 zImq6qKK}cA{&oKNXe@^N6PNu+T9M&c0f{YyBQA`f-DKQmJ|hsB6T2z0r=R7iFTtGB zecl9^?*-R4xSQMW!eKr_OhQuMlo(TV6&G45KdBJUJ-fz}{;TSw?3Zhq8ovK6tKWY4 z{cE;Sww{JZmQBC%kv|ybA$qGP)I7& zDUJf`j`4TqNhNn8NuOP_&E%QXr4uDz_2PAd-_D(+V2jOqerzcYIjH%TASsiCrG8g- z1(0-BioTR&y6RzJM{$W0B;=0R9O7AyVl=A23A1LrS7Qg~f6lyuK*nbSBW|C<&G9FHnJh&e8R8ZV@?Uu!w~k>JtqHJO@Uiun31imtv^Po>N*(PFTw z`2CZHNpZ-S(Cy%&e8B6qIOE{WHfnC0H*1Gj$e4)0Q9~1ysEA=`mUX-cFN~2pF`}4x zV2v3R{K0H0vb09`mj;|iD_IvLJDTRW%?F8=q`Vo=9@|mJUmU#9pIaplHj1=}!-&G5 z4WWaPy9tfLS6ci%y^2(zFhnjF%l|O;56C2$2V$j;9C5Q$t;@`gDrm$pndyZs#sB$y zWd^~0h1Hy3Nq2lx&Ac0qH*lG#ij;A&`4hY65n%2d(JPAy?>78`f)=<$D?3BYCJtRj z@tqO3n9@deP=NlWruE5m^kJMW&1WN+t;##Nox|7CQpw{J+TXb|OH>pnQP@IpELd+D z1}JhUS_*y`H83Mrjo4~DHGd|}J;jDp-)499GvwjUOFv|f!{8+#Q&WV5n56*6iA4Rk}4UfC6 za@OEmedH~Ow)S!Un^|W+!i+IF_ttQWp-Vdjx9``+fG~CyOdlT~wZlIW&XH_`RA2B( z&|$C?{Eui`NJi;)P9q2BsklMd=AKLg>{DpTaug+Kc7({m1~c)!oTvze2(dRYV&o6P zxt35vfy$9Q)W->%8LwIC9t%-X$H6QG-#O+8wJNV}(l@tbjIl@Je&_WdK*7uG{f*_C zhyO^use|!alq)!Ji6CY&Q{fVO)65W@p&lq3u+49GA({+fX>b=R(kxeD(rAZD-XwzO zEJI7C1}9wzYiz76e{lgpb9QseCh7Z`$%*`VUiVXah}Py!F|>&rU$8s~sfpWC&LhO^ zNYRr^GCw*xF&+9SMG9&nPq1h|$K;KVzSQQj`24($iPhtOFCXxrTkzKM!#C5=-ofA3 z)$GoOM;52na-W_=$Rll*9PE)+;#e_HVz!&jNRWwHPBh!~M*fcay87=U82D5M5gU_+ z&78Vfh*dytBHS6rSJuATpOGmA_j*bsUAOZG!o>U}FL7f$AMqRIB3>F3D4hcSwoX{6 zlJ#d1QkMZFG=%YekHfMHcg3w)28gZCY(`*YF1Ny+F2yY{b1?phD#k8Oa8;{DCfPdFp>EzuhSG^j&7D(tJVAy|> zRe>@zP(5#U>}-#X79n`(U)P$&h4MhG8P*Ha6Uw#E`p2=T&~7k@>t&ZBjFl}()B z9sBahj*`VZ?f1L7L0IiTBCwDC6}^qhgM=KXUQdUAA#yg)H2X)Bf-SV4=PjuKv8=xu z>$)yDP)^B=s>F@~-`i*t>! zYf)m5&>Bq(t+w^&l)|pbHP3hDw^__+yaIX=G^fZ6@G`Yi%pzOkl>zdl zj)?5k4(X49T6`@k+q4Ju-;3XesU4{6ewO}S75eeF?pcw!Ko@}Dozq0K zHCq)9~0W-g!GPx^F2k#c|gf{*Sf z4`%&~W&{o{4Bi;M9E}t}!ql7uGHa(x}-415J9IP`c^AOhSb3y@rydv2~H8ZI$~gF ze6ruqh9Y`tef{R!Q=#sMVQd48S8KtAA5Xf7T$^EoeIaa_NO1#j3~1|91y@@P5!fiw zBZB(LhE@z53mmZw7c-GO-T6kHc8WA?>cP>q~rlxk@|fgSy6PND(78FzDOO z!Cb16BuEpFCdLM{p{5WO+xTF&titLeoZi^q-=QAtm%t5I=4&?ai_*s`l zBVs2`?Ft&FVPyrc^NaqrEUW`b>Ic8w zq3<1by;yX2Y~tMdl$S;m=}mv9g`$>z*TkFSdj|=)Eq^!7u*cwNO5g3oGXL-jv-n6~ zQ&)HQ#;jb5_K(@4^Parx@yz#Gy6Haq;$_@0=?#6;`K5WuPPOo*>oNU(Z3T12X>91w z=%8oav(i(&EY8s(g-fzeQuHWB6gdNFa&bTp{_H?~W_3<*U`yU*9Ot+m%RIARK=-UMh zOHa8m3KRW`^vyh<7S_z@cf#bns9xdXRvclDWBC}yv~$axBZjZ@it0|qYIVyB+jG|6 zKMA-`b%KkJr+c{Ef5HrYt(ozER6XkuYZu`8WkwHctw|hq6iJN@S4Zx(h>h zj37)b$hU2P87O&Nq?jrKeWfbwLQB~YM~2~gfkTapfJ6Ai%Lr#!sxh1E0LA9pI0c7= z=H2W@3V;qFP@P9bogFnqem-7GN(L*d`Va_YR&7e5vFS@CYhi$o*JUQ0l1V$ikJ}Dr!uiYPWo)sN7r4ah%7r`F}KhWl)>#^L212?%v{F zB)Gc=cXus?AZ>Bi5?q5j1&Y(+F2%h-TimV1-QN58zw`T$%>CugOlJ1F_Ut)lcQHRe z;q@Bo-&_R;lV&`RQ1(G7$AN znClQzb(-}fcq*$Ko7H_EWHPlG28xU7z zmoyd8eLj`LlqrRVzVS?koCB3+2qlE$nTVPRWD&jydu;j<%a6b_mlm_oJK`o2Y7>w1 zhhQMd>3fz)FJj#nTHgY4!C4@pVIGnjhf<8gq{?*L6bb#8GYMv!I2~!Pwg4!pl`q;K7c8tEBe3 zBRih0Z$;zbW3ad5kfy^Z&kM!&o3Y$t!i915_YKR-z7F~=7Lz-HrilcNHyP6!`C z_9&sE#odJ)hVrlX8lVZ?QT`1s>-K354VVViKXgxg5~O*$Iwn->=>*%}dcwzdq@Rbf zY9KJ`WBsz)fotKcPW|`yQGX6_FFxKAJi&!k@P>v~b?ZBDnUbA^Vc<6rTD5EBk}NRePP3TXcC*TIy2I%|I+y8p_{XCAs$>^|B*8(V#ye@LVnGns16dp_VJiVm71 zRJ@pKy6V;l^xZnIeo{m$^VxKE*nC0*S>Z%EJz=K!{nTzZc3#VL5*q~;dF3*UWSn%~ zU=vW$JMIF9-0z)9iixXV+j56K!R_p_6aOb;Zo3j9?J&|1u=A@}cNi)*>K>}o73S#I z>Xj8EjThN6KN8Ag)%DlRA@+jIz_Erx8h_!5^y{=>O__6cBD?}Q(skCfKacYnnwmO) zGw#))iB0%m^sHJsyR_t8^^<^%0ar&yhw*`VN=hI$R&{d)9j}lT0o~qiXLWN^yVKml z)YRChRZt+kD1@^S|4c`vG&%BCg>N81X2`hFJYAptSV4*Kx&;s*q{M#PG?ND8`PLC2 zPfY$mmA>zRmA0+gVIfNHn+;R#qY5|Rh&`DxJ{frPANUnwB}-X>yLoGR~8E*N?Qr`2|M}Rd!&7Qn~ zynOu2rFM>{f`d|_`xL9JAzq>E>oNw$Y1ntHx@1qpUc4;M0iD?DF!N^&*HO4@a1Biw z%pnDz$2@x6%1@)oNBom0BMPT<`dQ`DL5B6Al3nKPK0{S+39)*2o2kTaO>8E+L}kH0 zO9nnJz|W^!==J^MyOw-Do4rHhyh>KF2kIYgJ5+D{g!ROXuIt?YK8jGQPOgLcN!ApG zk+It4=Q+ve#vk}e7^^cI%a2w&Y7wm8aMnISeH;QCc+Rf9I(f=o{i=lL$_PaL!DVd4 zA`iO3VZPFdXJL3^U|5fS^-D&4zUnLAZ+?7*URtlYv9D&C2TaI;ZTu@ii7WQOO<*~o z#+93L)nUgS_OA|fxFWzOS%LX2Zm~rx(HYA6o^)y-Os7u2g|Ip(zV70)sKQOuFS`-n zH36z|8@ZtOlf-3{mL zKemNPF^Pm!!E-F+UoC#8<6|0( zA*V267n%dEq$+U%US_Cx@ACGwxW%#=d$O9sJDO^&n85bxi48JElj-(#@3`$t!i)R< zmquY^xNB(!TO)2|^BO0S1Mp2^y@MtrKt5^=RNtDob-2NqAUbz3#weOFcp2(uuO!7| z`;g+@=9Df|E7vrP;76j`Ze6D$8#x=#pkBTBqFa_w+0W^Qh}M$k34YNJL@1jpTqsfi-)`{mB;}ewl=S_ll?v)3+7Y9z0`wuP_&eWUvV#hZc+D*(V5|S!=X|SKOxaXOAnZ~4S)SoZ z{AZ90-ZD3W1;ZE8>@)>w-(a#2RvZDKE=QeFE zMN5jgV7Fjv=1Tj6i&Cal(&Om29qiiJptr!jR>TO9Yf(mSg=5!<# z+c#V)p=txgT;CVtZQ7_MPf@;)PQ9ueo3QHJ{h|XF2!|h32j|b*^;TAYC#y5~#6;TD z(}w`3G|kC=-K5`Avo#g!mA2!RaStCb>;^(ZSi__sDN&*$hBi?zwmFAZ zfhUwI>{}JKIO%0TlpknO0a3Et2E@9wI=NlCmS$$d^?jllN=c#5;RbA4${o_?#Ao94h1wmWQ%cX6K?_wr2>kImB`&O3rJ)=% zEHqQBd_3@-i`Ai0g>CXrBgT8PnuL>YL+M9bSDj%y_bs3dpyDb0_-d}CBy-_G$8z6t zuTDt(Tf0zww})Yl>nEn?v6p+o{JW)u1n5|K+aY5btS{^JjTpH6_28D{e*x}8h1>Bb zi+Gf;t2N2PitT5Ney6{a??arnahTHw?ej-lo1@%ccOwezIugqPr}x=zFAkCyzg%&q zWV&0pZw?QS*4m$3fy$*&ior+v6pz-T-?dy<1SchlMp!v{*1Oy+la-2pgFt27NXYqh zdH&MavXvsmW{47J6)9y+SphGAJ(j9I?OB?Rs8yDxIC2m??H)&mgMaIOTcV(; zhU^+$)#Mm)zMOJ>)mQzS8+Mi(<}PsbI`x}FvktICdR0olCLP!#bHA1lX#JolS^qR& zZt~_HB3r0IKd#nzxfLa7Pa();lEIFa;F6WO?(dPcW}NTTq&mP}s+Il&LM{$)Vsjn( zbRU&vJj+WT!J+nIivVyd#H}MyMkQb1n7AC6X&vMQ$Xd7CS&*<@OYI<{-xPk!Tuh7< z8~l>%@`sO%PqKwV#)f&H0$(j+EF%1o;}!14!I@m2{xG8KB&qf+9^r85G4IXa3zL6}MKwY9N z9!3!Ip+QDkzN^wwL2`9H(R1}-xE(lZczodn%651x5gptDhUS6+mb(*6-8a`P7v{5n z^m|f6`sw(H%CJJAByWhPZF{^K> z(6S{S-_Kpr5=8vDti|YM01-QwDxAjDuL3d+uRdK4e5%c1MdDJpelEexFDC9-*1nHw z`K`Du$=O*#0jc~}Qtl|1qWV6`4yXIk{NuQ~pUIx`AmfZx4w3A1BKt-i&G1*voFpdC zhdW#HPbfyHlESX_y?Wvw z3>-uGbYtVG>N4pxGaa4>X<>)NX_)v@NNT$Q8s?%e=i|}=`|IO_Nm}dL(;sI1iPYCa zSua>RP!1%ufPQ zPOQ9tpiub~nRakr(Yl>G3=}6nPAcAO{W~nT;~vo9QF$d&iP=r*bUKUZD1a$$DZV;@ z%EpIQ=i_jXw{w0Dx9fH)xz_56xJ1cbkW1TIcfqplM(O5RE)VvCuKrEE9IoU)#l`*i z(RjYU=H4#&ts0d;P0e)SPt;xl71$eAT1W)22^u?0?fr4)yDfK!$<2|mR5Ni=(7+T` z8LSb*(EkK6LzFYJ6ZW%&+m0$in*7ubkwkWvLwzFJj+x$3NPu8j%8Ouej@`=H`4uGw zB7Y(=Dlw&OxclqR8PHk0Rm|5p7P8~1nc%F{3jXjIKFvo`L*dEXUMU8epYUWtNr(7Y zPCnOJ9% zGqj8fwd%|s3Jo<#lTffQ&|m?^v4|^?&=KyX3Ol+I_NJ~1WJ@NB=x(U`3VbJtsXb_F zzHu{OHDd=LKtGqHkZ%{uw6wH{@Kv3(IUbcQLRk#TvG_9U>WL$N0r!qz*JlS5_OlX( z?^r#J02IkHbv|l|&wB|8-Hh0TS@$M0%*0?k3=b%pD&J>n zEFm`p3jbC0v-m+ZVlc~N)a6(|RYyUCmVZ#@;xT3HiB#G$m$c{Z~DiSQXGQ ztM-v7oWH_A<2!xXIDougWSPl>mXBe!dR*sh!)XQDo!Sc*Y0n5B5#kqHG7l6o{|Xcxyz6D0R;HZ?OuElDw+=k>^W z?~aeI$Kps4kfkXu(L=SwUMreWd|}R^fSoaM^cNEH!O|{hL}CBF|AV8m_K?;gIejsE zOB4CF&ax1rFMy1$xr@45ap-oQ1%9x7R$KPztPP3sk{-XQ?-pqqn=j_=hv6;lvu88UI{*~4-;Xjx-N^6E8T!e#so*(Y3MmBi?K6XxL zVrj$MT_A-OaCWpnk{JNSGthF>o9Q#;8*tPAW;Xo!{xzLz0z++#v|7Eu~htVIBcKG@nH)4SQ@3b#1{4q)0^s{ z1(;H&pNt*BKi$+*bQCa2UKQK&_?b9axp?ycG%DlM+z&%z*(U#{v#wA1VN8u)PG>nz z;JXT2#CR+xJJdi{QlzO(WX?>mgL|dyy;zQF_xhlW&Yj)Ie;iZh)n(oTHzVMpS(dHw zH;>mRogRCBvXe`Tr)$rfwY>`N3b4TGwD`I7W=vjq585%=1dAjBp3bogrlE3>Po@Y# z1)d|&Qyv*>PbQ}G)&Ct@K8A@$iQ$xBLI?es~2tT|$=^UAQ zNNirt1nIu}c<}|Sh~2#t33X%8IY3SR&>BWW$ZIzZQW#JN^Dn!!o~cOT?j}3ok)f#x zhqx4(=i%vDV;dQ7Bc#fi^q2#;mt20x>1HTu1FMhayMNLGeMW|~V|d}=tBYGY>lP|O zL+?&kH|zp*AL(C#*M%@ukYBcK*|xsjak$rt#`r}oLWh|*RO3rPSu{NmBp-|da`J*y zL4zT)Td@zkBADXDy(N2c?ig~YrV3{N8Yy*{q^uCjVC!U7Jif_02A|G@S!Iy{d6PeY zT-XEa8)$+Cy?7%=kbL@B6%-VLvxT5?p!z5wiYl$8x*`O&RU|Rjfd|wDT{N`Fi)f@9 zuuOi*O5?SY>XMT3n)eln+_a1vyG@7y74&8kIwbPv*a@i<`Mp*^is6IO)hX=5Yylu+Ak ze%{eQsS-c34_qghCkt;hpNe=v_%BKG_7vv!<1uC^tAZycH1y(iGcg(<09#<&qny0l z_43aRpzu6!RL@zTt1Ki(?1~RPe22WFBBiwO>FC9b3zhE?SX3}2v4|@eOi`8O84tgk zunNf^h*%I@J5|;mGP;3_JEWUud@qrNpNu*i4{-dFY6FkLNBj;WxC_z~Erw!wQ1E22 z=Jxdu)-f3<3VC~Zmt>}^>d!{~tVV|$5gT^jeR$%^blp}fy~3tp&?H+k!XPtx`AnqyEmd@ypbAPd!9A1@DO-2gY&6^|5jDTx}-HJY$7Pa*54))!xyE zw)cl@KZq0ja@I(YURJkP*`;-4;qIzttq87<@zj|rq+wZ{+($Zf70a?>%`3(ay@p8zNbdh&BxR4iU09bgCN#&65go2@R?ue~4CL$A zRHXJHA>FaGb`q2!Z(g>iiT!IzrVQ?xKl8dXP9nKE-zWBX4DTu{yZFr9OeB#8%(X>u z3~I)j*dvPjM?IOWyvOZ@SF$#YkB=|khb?jkGZnA8;+VZD;6_kD>RQLbd6UP0fsVqT z3FOq*0FTv=I||_rXR=hG0hBKY{IbylQZ+*;DNPt4h(N>CV_}MmEW7fqd_>coHBaWi zhQcHkK#SwR_Hn?72L>z;zeK(xl5DBq5uOsA54VU9z(El+i0DR$`v}k((^;GGhACro z7GA`6>%+)Paj+k;-ynw)q@X7RBZF91QdpH6B!-^;RK6q=0EL@r46#fAC3Tn4JBe!= z`rjjp;_g?;(*E0S%TX*(Uk5>bTX^-uLsXjJQ5?@8JN4wml!ky@qHs%xjvFk_%uF?T zyR^XG8`4!H(Pz#pI?F0mfj%H(d@tQuAkLV_6k$X)KbKH<@69{jA!btV2XL zoCpwELXb=kw%T6bC0(O;y^XiZn=O706H-fQKts{Fx7f*tS#f(vE8B+3M$!}J$Tt7d zqcnkzE7k1x%W?BRZ@xifA*A{+o>V9@3v#kEc01X8(*@(RH z%aB8}a3(-MZZ|_bOn=34Xk*o>-aE%1aM$3{kgc%-+o^(H2MX^DmIR6UcYP_}?2r;S zG`G7B$plAi0_$UfiP0>`HakJ=cRsdc>`^co&~nTMnK@smAEh?VDXEX=lDr|-FWZ4= zEjIGfhcq6&dfMw|kOuA1Ch9Z1~(iZba9+1TvHX^rS8B_0EtRU1%EwtL7Qd9ZTEU}BVXi$F>U+V_M>fa zouSU*8X(FS!T-y;8UnyKDW;Qs%G#5`o?7}{E0=#L8RIFbOnP`XdVB~m%PSa^a7PsP zloZX#wyd6&u}&91DbZ4cpIL?Y=@jx3>kpeel|!N`Mq(yVNhJ?1v36)*YXURle0q2A zF+P7~l@&OpC!BsdPzbUExBlrXDstw&b#h84R0Z3|EVhp@Pg_HRi#8g^7>8iK)*U6= zceM*G*NTr+>FkbiViTcb;u6`0k zUP*1W&rClEvJsG}aom>0ZP{$F80Tc;XUm1&z^BOGV3Ddzk)M((LUK^(b>(}oeNVOC z{JX_O$3cY$p5ykdh0CN|#_4q=7m#m&4{G&er!Il1+DC%C(?3<>J5bb#mS)rdAS z;WgFnKVzPJ)-A{Q9{fBw8Me+qXfWA2S>#w@R(!Y87G|PGbBx1*7Sc08F>k01*mKnT zfDuHo^L^WhO>dU1uJrRW_feXJm&tlpVGpA#(?QgRqs{$KyI!8((c0tQE2SC%_SdbH zP7%kR4;h3lUcE`e&CT4&F#w#S7arpE00V?jQIF>ZLk7I7UPMn=dybX&M9eYIld+7{ z;&%BVKQqEc``G1;9#;~Z>OPhu`u){?rjF%&4(s0w-b8Lj>9-UtkMcB_>CT7_n8UkK z<^Dj(^G767SR}~G_w4wY9E99l)n3mQ9wQMbuFKWQH=|=FKclihaMlTKCBMb64?b{f zVKEEy%}u<8kXu3IY_O?{X5Sal#6SdjS$JLMXqgpylkn}Bl#^-iz_Mj&UC%PCZAr3(LxU2z#|*58qr8XNMGOoy)e9vy7%i-8AV0&uL@X(|GO3Wd@fEm<&Gb$*%HZ6Cvf zh!H9?3_HsTd73;284Ant)h2kT>tqf_4TTYmM$;2=+dXm(9bMIj>4#MfURI3_e^$?8 z{o9`bU$QXry=c=Oq0+4_iQXGn6`r#_N6N7LK?8-6_R)JIl0x8$r=@izH=&vFIxm$B zI+_UwwEEWfz~v;PN=(07@Dp?ptp&i+KGRfr%u$#P=P7cC0o8j9->c%;8FKP=1zn1> zcRgWLx$a$9d{pMW6^Q;(kKMEVsThu6<>cVSff?m^j!T00`H7)ozr=6+GU+)S^ud6j z1GR0Uj+R6U|FWF}ZDs(UB?g0wJ;xZvzJxc5!NNI!vh(UbA2Q_U1LIR++4^N`D8{Y! zDtg>SS#sQHLpTLo4CB4Shj@F#kX;S;TJ4#~XwWc0S;|36t~Xh6m|pa!Bu6usbV9la zDw`_8g_uH-cIff=js&Sz=f~W)1BC^Iy(}Rn{KO2zLR!IT>)FAkNdLC@sCH2ntaj*0 zAK%*tK5C98+sCiR4sck&oyurecd9-_b&mP7fupAVl69DZwX8>B^jtI?^#qb2P8loc zFx~+#X;d=d#t|ElLJ3)J5*}bi%(ErA zL~tK+r_x|476Wf$t8tbpmNaa}Rm-a<7peA152$*4m1_*^24x6ohvkF~-qLff#=U`w(Nr^ z(pM^l+HZ9$x$W|v>RT^LMz+y7&8BT9_lvzhx^e-v<)`n(=VE@}d<}g(_ts|tHtrH9 zi0T`l#Atqo*H^uxY?pSkBGTVF{dF$ZVPq_??W%Z7mLGI zbMZi)654X14#bhQIlier`|AP!6Itu@av|7)e5+gK>yca-yDpwG*YI z{|9;gXgTUAN~6{obYV__r!SE?ElLLr#jC5eOy~-3A(-Q~g{$sdb357jTO|}@9n0SW zVB~yQDrM#$YR|D)HKduI;L{K}Ur1?K_Mu1otkG~U;{AJ%k;9|Ok#F&11@F|&WVtJ{ zaJpL1T!Wyt_r`2BEtewy@NTRZ)X?iFTbP$bb3)vg*|9S*e_74GVP(I8h6e3qAxMQh zhL)Q4_VzYLYL3OcRXvSR?$6=@?PCn#`~ocDfnW<)7xL^v=|qz(^n;*ZehN2+CLO44 zzC=QXlT;xYx8~~P0mbWi2)P9adc6c8wWSH0>}>a~)yk!7)9h ztC-v1hYin0H4|^u@`F=yjvpU*ORa2OTS#nvuQHKN7 zYY#rgI_o+=SzU${bQl%Nd@4(bl;cR3MNf)2ibaOqYLjYV-(mR2i7J|@I2?>%4sd<= z%@&`?o+i?}r(cC`Y`SZ979FaV+!Cur5_RuEQbsULDemqpgv6o!f8)-cjCrTHJ=8;>Z&pppkl!F}EU*lLij7g7BH1 z{@QU=V*)O-eAd4iW2}esRM~C_Su3{gSYEeV^M!^l`BinjTe zk_8V{VV$+E9R%E@nwex7w9K*0PZQGSVz=lZ#3F18=0W6Pltrhvf9}8saL7O9HSDYq zR;0PTsvyyae$KtxLGNd)egT zr+1+?nGt2>$$(a6bP`&gb|9d#OfG)%)%?(Y*H>|KQs%l9HL=y?ihrT@L%n|`dp^-P z3N0{@3Vw-pduEn(RR4gXFsN2D5Qwm=4{_rP%|Y|AA|nfy$SN|g6&;bs17^WgE7Hn` z+E`8_FO%#J8crgpWn$ufRiQ}G?aORTjw}-(VE*PFrZv)`(rKE74q?E~54qLB_wFG; z@WRdK9N_gm0eSdWb`T+d$_CpFI3p;G%m-HvgyQ1*N}EeT8Msk`iJH1bcVpTDf67t z;)A8U$0Wr*VyzYq^O6O5X(6x1N%CamKT)^qm*p0eUDrnaxN`2rc~q^ zkxQYohm*4>H3nrD+g!x+iV^h9QFl638(7;%HsU*K2!%1H3cH-dFd?Ne4F?_QDJgxZ zXhrU2P;R(5cJ_1$v<_nI^q_j*lUhi2eMf3GieXwbKpZ*lSQ z^>GYl%5&KgS+=*IZ>2|xX*b>ExVhRp`9(^bp!**|*Q2>7S3CY>TmM0;lqrcVF(OnOtP7|sJj({DO!X|QI0eQ%VUJW3*D*8C(Pf!rr<>ls z^vhM?L4ibxJ;f&(#0jhhlIxyzJRVw2g~B0ns4tU2w7SeB;gdpqTf-5@yjG+jCgd{v zTn<0L>vwjNpfH@&`hV=$#07-n&vyVoQ`I&G7Vy(YykrTJ}NI=0v}2^g_t9wG(IC*KodiJ##{P2 z3qGtF4l*p(;7?;XJW|M&3=4mv?IRWWMuXT^84fZq! zjVh?Cr#Pw9*DU_;io>(1Rf&wZbpGF9Qrwa=a+do>~2bwiKV%NRb&?V<3|yt2Wq zw+`B19bjagm9)?E6M+Bcqj4=)LnRM)O((rqJp7M@O_)F0|DM@rO~FwC>uxlt`m649 zeE3@pziRA%UI5*l{q^(7Ay>Qmp~HozCR-C@ZojL)Yme2Q)dQECd$kS6nK;EYh8Eem z8QQJ&fMFJ3C4Re%MmPyjRzSy7@i{%;*B|dg?$OF^07ms_l*gG~D3VswNqfwuWC#xK zbN_Clr#;S64a-X;`88jG=wt^*z`>T}FUMMngOV=+K9cxqKoU2i3DyjrcO-W%^2&m_ z=}?aR!hw(j8`xKK0ys0$76cv41><)>RmM(4)5t>^qkpY}GkgAUS7=*vYOFsN3P$t= zzq@V4@WhZwKNkig<)qPN`o`GI8lfl^N&G!TH2%C%=W5o!j~4jptn`zm0mXjMrz!Wr zt4x#@sammH>S?!7;pd0Hh_VRg_)D~s%T@TcQ!G-65Oa*q1Kg=JzxYN?&>!)43Fei` zOW2br%IG396ybS7K2d4Bqvhz6QE|5{8VpoRxC`^_A1zU^al#C^#O)5~S+RZ2+53rby-ZIt9((cznF(Us0&wG$*wg=I2CM+czsbUJ9id zEWvN%$3-*Do#H1xQ9SJBs4?X;HC|qR&|u*`t+&7u+xx%VdJ&Rf+vaO?y#Jh>XFbXi zdH_V4>$~g!5n>8pEiQF){|(PYlC>(+F+3|y!q($97Df&lEoKK0P2iS{=g%PsFl<)vNi$r{^%bQ+77%8epR&xy(ez@=1fCc zqw@r<-a0uV@NHda^(2u}Cr2K?^`i*8B+;)Hv0JcxAH;~v(+dyufkz8D%;=aSD^XLTqQM54B8KlzXrCz0>3LLM!Z zv7k)YyEw&S5U;Z9vXfZ0PPR&<%ep&ZIr;@x2_w!OW%E?~{bdnjm?`of$FR-kOuu>99^L9M!+S9Dri+aXWuW!B! zI5#>qWd1&W>_k&TrUkQdcqDp+*1S!(^Er{e82B?Yw7M_^wA5S@KCoNQp|@y_Yh@Yj zve+#Xu{m*P6p;7wjmm9>Q}fuRS`YD#l>~)5mNXT2J)_+8cz?yBitR;Rz{p}yR*FMd z>_>^_w#4hR*havjL$xN`zs}QCfMQw3agEr$x7}8@_5W;Tt4^bwoG>XMA@V1ff*1Cu zk?cXKG|ioeiLm@Mm@A+JDGQ4Q0@dF~i?%clr2oJqR7UE^1Z3Yuq$Y+^!S)e^My5F| z#!wBB;PJFH%*6`zThA`eu!a-TBr9`_<@3;AGw*!(TKmVkZU)hSJhxnmAYpnMLPH%A zjONI}qZ&$~jDG&L9^vO8btnQ4>(~WY<7-O&EINMlV%QTp%BniY={215*3!#wrk?z@ z^#bgZvVBVy2gi3RsVz5#r-b!UacQ^UcfO=Nw`skp?hNvdU%H$M-fD|*Zkdre+`D`K z>>j`K!&!xIfh!XOrp>ciI6sWBdir;-P;gDESk{=o;$}sSN^P3=Sa@3Ix&}(m($?y6 z2~A}eG-^IpC`KY$Y)pg(bt&e8?S}o19C7Uah+7 z4Q2qWZv+?qM9IU@4@q;8sUp>thN!;y5LVvGPwpFg{{N{~o)UXveMa&BxLCVkDRvzM zI`z}XVoOKYxzrmf&>dTH9{o!qsuYHpL?RTH7#t*#uoU=g7eFxb4^P<3UhNV!vikM1 zp9h^tHwuVaNT`hPXUQPsS^tX8F6Q73wV$~k4z>~_as5xRF{__TG)K4eJ!DMEw zPj|OvX$TUDG)&QMZ_|72EC+g$+!e;TM*_AMfBX6^ZjfczY!UrgQL8tTxIie`{4+j~ z$0snyA;GfGTTdg2Bo@~G6ZD#oq2<@X^`}a~nqGo|=$Q``A7M0PSS|TzHZ%DmP8O(v z-xL%;TT&oGD-u{ICxLEK4BpAjaVWhoBgrM*&(y!>OBe8#9wVFz|+NSGbe zJ@|NuhSMDTjm@f z_RGsF*UsVqQPS1P|Ec#5hmCcHlxxdEIoVts3uSDIY%$d;5XGAe;1Ot2c=NDb{cZ6i zkJm^cm4sM{-~-At<~Zps7u8IkTvoqfBA*HdqFVSMx2D8Op>2{Q17;RJp&}@*=*vLy zjHxYL3z@LD1Ta7WEJ^6w>2TIC1s*j^p6%4$;B9bx$94~ojL9RbK>;_q$MA|CgnU;G z*B>0fx|{A9{Nf1>QFFrX z;@|$1Ek8og)s?1Th5-zEQ?5_=o3gfzzZrn-uODi!#6$0hN)X4S&1J!Ezo&+Bl4MUa zZMzsKR1XtJ)WM~J+EJe?R90C-t&Ri417`?3`udh*Qhh_$2iT{mjsg`JJ=+yP${2tK zF+TEGgo4+N2nGZ?KA9^sx43nu#=D<8Rz=+F8JkOnoYCp=!rAC*dMZjoavO z&*5HB&Vpxo7u+P0+bW2oZazs51G2|W9r$pny_;iY12DD0p;_3+U5akBm zS5yazJbiOIq4W*3bHM~Gm~JO8rI-04Ss%>Dn{Qq`im#J!yR}G3Ja2Y?{`VjP@LK0r ze{QZI^ds-yxQh)MaU)noF(Go%kq~7dZzJ;+YnF|aez(rJB+5fE4_l`q56*-z?#DD5 zTTVFoAkb|oVN(GT3G(+{ijkHx92on+RhR1#y~bd|If^@^X) znvu$w3u;oIaB)qw2TKnOGH@#mfY$$1b8Q*;e{#f3;Ru7WhnBn3ZNggrIkY#`$B&W6TlkGQ9CZXUOAD493Y#5!ao0=^CKjjdi{9Hb z>)}IY9~77!?!HlBQdi-VE#y|g$a!}5hNR%XJu66Ca8fb2eaZoUeoHL`kaUZ$beIH& z4~obLgD%iC@cTBsvCYWZ*DpdRfjW{S(Ma(BY+`@ef;QYs{zpm2>TtYgi(ZZtI zu-%{hf4KH$JN|HZAa$RGAH72MZyAX4PK^<9J^Jn^~omd*MFBOpTGevQ1ogy4)A%bMoe9}3}u>8q4!!kR4 zAO0TxZH_2k4yxo7Ls{Ah`0>yZxM1 z{NcbmM~jOf3kKbqZY2I89twko4u1q11?7({{EP*k$3^?>%EnM~X_+f*yyj)+goPu_ zElIsOd)PSv?S(spqd-yRO?2chc$RE5zZW)*REV%%k5pr#k%I3O9wdEDpZ)D=1tNq; zC$b6b;r&t}aul>T%TD(a%inmpdv!iDX3$9u{HXx6a>> z4`_3ndFwt+p>A>w@0z6Z&IC{<92Tg*=igd_F=&1D+x zC-Xc^D|UqaR~6CtByh#5WB zp`5MfM}>Y{hp)$ll9>$lmrSOAR3vMVK@H00MiCpKNNHsHlc*PDsyU7 z#EQUMKyGeid4Ot6i`pA{7K2ANE%p;MW*)x2B(9dAo}B~E%1GqP+1g+Ln1RnhwYLh& z(BG;qQ&Pw-rs$#Bx7Q5~5a~bDI$U9H6?>^8v}0a2qYTOfb%4>h7R?ah8Z8GWG*gP@ z8YqFi5$M7apC=>_j@LSly+6yONIWW-Ax`~=2;=cdE_x3&{Ow$hejmmGxv;i+6_in7 zVexQE`9XXz-bh8{lbd;G;6vALR$Dd`I-cMUL1GY}H0gvj@7ucSpkU1{QRchHQaGTZ zoaoNV=!z2K!TS%0nDFp;%{UW_(eUK(Ms5P~AAu`|1YE>SL6dFSA{b(Zh%5Cr#M~wT z;a@dCgsZ1*3?uv45)~6kM)cv8F}zSuvm^t#8?8bz_$OtMSo~n=Z%C$ z*7%#3=lr2P1vWTl7Q|mDA!8RXBzt#qSyU4|eHY!yHsD(E{kMCWa*|dybeuB+9`)Aa zG(a3@Od;*3d)IhzgvM{3%f0&Nw_)az4j~e9FQ+A6s0YBzsA1a;d5)HJo4&rVrpk)( z9BsnnU02~a*A3}gsxSS)nWQ+B@~je%rXo9Q5v7ah6k(%}=~{5R~#KgQ~L4a)l0?M7nQOWpT49Yh?Q!^bOZQp>Y{ zS^BP0@6?NxW2poMKvE;Q5VBgnx>1-(6Lt(GQLK|)p{kjl5vOTnePz{IkB;cmq*6G08iWcR`eowNx8)LBTw4`{v@D}q>8mjrT(rfxGkAs^c3C$pXYWdgZ*Cu;4>nn~BihTvh)&HVhgpOnrE`jP=|cky{s zy4s^yc;m*}ErAcu#@dD|BEGMPNBxVuXy5MWsK*FA5>j~ztt4`H=^zx~Khv2i;K7E$ zb31+NjVTKRB9Zo{paT$#d&!UnnNVaJUPCw&9``h$Z#oq$LM>uMkIOz~Q^BJdekGEk zYQw^Bl^KrY%jI8nri-f;B4jYsA1(gYI!2mZ?H1dT(ASizF*W{PBHsS@w z7_7c8_8q65lgz-yDZGdDX2WYMjyWTF@`r>EJ7N5c+`HPfzt?YH169q{e`6*Ng6QL8 z-xQ|OxY)V=Ym*{uc&Tgy*ntx6?>!W!)KntJbf@y}5G+VgvuMpF1580}>Kv1=(fo~$ zN^LOUEH)-jC&jF@v<6IaYB`AXP`cCs1X4{9^YASTmMNT76re)8V3Che^-cB*O3y2g zrD5iH@L(d|jea?x}6%;&jhggug<9bhpb~1xj(f-xS@5C0E8!ajhBDNn!JflM+ zMY0i=C^UJE>iFwGG(r|_!ALP&iSOd1>)|Gt9!K8Es>2j*#rjT{mmFxAcqAM?*-4L0 zbbE7ikBt+|M6wwY5{UwRyEjW}DB@hq$*~j8gk*zl){lu(i?xf58()ZAGf!+%Bn^EW zOcO!|OYxTUoShSFbReIip`yd&Eu;DBCFX>2Jg;YC)h18JYu3|H)GRu#<@GpxVlAd| zfwn9`>FJw^>;k~-fk=hsH-W|(7B#*BH<7O}bI$^la}@;v%-AWG6F1)r|I;jIZXVN6 z6)x6z)_nq!e%{^5;Z-M~OQob@Tmnyu-W-+(Ri4F5wuv9PPKY0wids_&A#*p(tAOaa zbywFFPYmIfB*WJphAvZ_HqDiI5Un?{x_~Y*QpPq z|5hO{C9SC?n$gd!VO;w#dj56(h5?0sARe@5$=52rv~qVIwZQhdDTKOogmYYv`E+b( zxkM)>x3&Gsf8kRh@zHPC+WmMz(?mqUkako8O;3;aszlq!(4;Esv^$ht=*4NG`iF3Y z(d@=%oe^?G(lDX(Lv6#yzHon6vA&pBlbQzFE0R8Q#;9wwmU^^$T*XxYp1!0Pw}5q7 z`epCC`|zsaK0p^AVA42%H0sel|uMvh`LDEY|4&@diSWDA-g@09e}0OCHvFL z?M(tfQV5$+DK2>Xl!}LsTKct%{R+aVfMRnrZYA+ZG7C0_P(M)r9q!fQ5B?Fd)Jc2 zmKsr3bNOz2X%?m(?hv_Hyz%*XH1%o9nXFQT2mOTY5GOG$cu$FbSWx*R_{5+L zS#yOj4Xf{NmTcSYOI;CJC`dzii~!H@gP2Qs8Vs0SGV5&&XHa&m6bwu@LUmLq6p?WV zwo&S!i;wxw0rI$_qtj>2z{N<-c$8a}vwcQ<+@SR^ykgLG1t0+Q*w$u$MOOP%Btze% zceY#{yYSIe?yS-hUIX}*C1VJyW3X}fZ!cL}pp0)();JL&aq=&3NC!sV3@7Akw|~P? zvoHT;g)V?IQGkVvW+Y`U1qs&j#jxmOB7tTqr;o@*hkn4BzC`YHzbeh7FJ`qI1x9v! z`60){M3)Wt`dT4UDateH6~$NgOMq*pjV;X;)*G(U z?i9YcQ^OFZuZpLiJwR3ezPaq~)`az;Lqjx?!Xm#g&N!U1N|QSb0In62FXl5+tv_`v z1(hA-)aRjgcR;{8lm0hPq15ILO(<(Qw?JKNie0oZVlKw@j#@XyUY(^!+j2HH=?1+R zYkzno?bkPI-F@R8cQHX-l=NU+l<1kwC;NW}??&L1^Y6t9a%_#SOE3Q)P1haH_8)bF zNQ2ZY5?hhlBX+4>il|w;c8pTHwfAa?J!7j?d$y?BwMQvcS}I0s)>dl1-{1Q_?>~9+ zPyXRP_jB(#=bp1L+_8$nZ96;{p{7zG`6>J2or~;4rcO(n*T*6ZEMi`PFb=`=_of(`}l5h7S{u_vuSaWD~JMuTzXQ_>|}QBdwC19^>$% zfWVe(@{?9)l5gDL{S6L^#$+abzNU(xEgn^DX9J<5Z`_+Np8^q2`lC^+`blc4Md-yL z6aiE59McFaOy!duV*H(spDO#qI`J)=YV)q3kXjVq9Hyz^p?Qkf$+okM+s|7ey7oA; zD(wZc&ZeW^K}EvqDUNptbViuc<4k9$K{MZlVd46NSfb*aho zS@4$TpBD8YY9^e5dp7K0X5rkK_iBH3pU6bo!5Hu~0A7u8!DY>LGDHoU=hLpwU&@U? zX*Let5JPaCj(362b-vp+7L)XU@ z(zOcX#g(2*NCG}A-g}B(uDj>Ie?Lt&SD`QvY716}!7vc1XsI&Xm*D3we}-k15#y8e zRqYVW9AXG@0LUOnCC$+s*CdWce(9DoJb;c+0hX-cZpV~)P;sT%L)9>!b*w_a zKBj(-fH<)D{w0R7d4`794uNDdzz|`lvU=f;IE%yc3A^))s!hzKYYkbou2DlX@TGjpY!I$xn&Pw*SzWS*!Uf_$ z7q5x{;L(n{FfhvV${rt0wU8vT>{ zlQh+k#ILMQ)2v>lSAeSY?Md38p~Cd1>k*)Te!iYt=qnv|$I~+*5>`Cu|6{&K83W5u z|Di%SApf+yjx2NYeI`(tAJ2N%4H$Fg?owH+B$2d=PQJ9H8!N7s54 zJ~}kumUHknFg}U?zif7}#;LHo?*w26p>dapM^yo9ODZ=tKfKUDVA2}wlQR?JPLdcO z<41Kkdv>a}E76S!L=dXYg@5pE9D=KD9CSy75%~YYCkwS&`faan)>Zdia`eLvG`;`; z(@i9*zkPIS;}ao~+x^1TbC$&HU&P^-6_C!J0VDauW(D%H3Abm~g#zx@gyxWr-OHcg z$z;B+W#{q+7Cc+XbLGDfVGaDBnVb--g6a8*`{4iA0*n=KJ6Jt7`d!ra0CMedNJIg1 z90+fZx4ivV+J4a`oc)1Bd!EDo2*`4BkO;FXo>ecceq1Hq<3*t7Q6DX2F*#~95fiZk z9#BkeC})YasLX#ez|SvNyth6!#$<>1mHE0aGffNG#QWY?B!9PsQC~F z3jFh6&#C5$a^Tf>R#yaPj1OcGCg9t;L;n4}wyZ_I3mElrt&w97jZT>(v;n>~y7u?owE-&U$o+Fy<~%Us)~ve* z+QVnW-RYg?~2*Oun>ku`!GBuPFt-Vvn z9jGqsbDr~MO7%Q$)nkh5O6P%NX;ed0bk(t5l2)|9sTo{Gz6R?#sE|rfJS8A`Q@b6; z-m7K2)=l^^y}Rge6b#s>E*!CDBdluw&y{DhP=y|${7-Llqy=OWyQ<+bBDo?rB|6el{1fD8wR+E4ivB*f4uNY%IfmMP%3dbP z84!pXbx+BC!tZ#eAh$cTOlI9m_q^xLj_!V3dNj;E@kD-%!|T@0mG)kzy#TgK${72j zm8n~Dhik4ddneh%J$*WA+yr_+%%b(%ThVQDj0qL`l(#VH@T`PE=(qM@b ztogUe!SXi4q&nd|z^$Z|s)WaxUZN8wmxn{zSbHo@w=o?!jjW_Puw!#F$w-;7x7E~U z=g5g~?tI6;C$Oa6ca}($7TKndk^HluO8qvs+W9Zec)01~zgyqFWu!hJ5czBvtDXWa zOD=4aV7&K{mTo>1qz_T-TWT@3$ofeuwu;8tI4N?YF)nfYrL8P9&Y--omT=Wck~vZ( zNpDE^Ll#1QNZKtG2vbZyTRlW9hy-9fHn`G;=S3Fn3Y=T?NjD^v9FFfOaF~eUj%D<; z^|iL8^}kbm8R<@w{;V;Fo45NSrdqf3b@6jcAiMnRe`~hiCriu3`M_x=yYd6fL=7zU z%hi_EYfVxq6#3*CUlI!`8t~1XcOa}+#mC(%)BTvzo!L=yn?i@MFxm5sH?=93g1N5d zq}@<&{5_WNd7uHD(sMu)su zUb1q+@D@02FklP3XuSDmcg#z;yaNaoKz_$B-mxH`#FnQozv{+>cho;VrdD{epCn{e zz~c@DAqd!q8hS5Zul%&0;Qb3xgJdD!>&D`wy3p8iFe`<*^(O0Px70L*q67MY&!aCT zDP(orWAsJhD6^zWyq@Tw^5m~kukU0aKyoEU=pmet%pg(q{0sQX`u2aidYxB$>tV(Y+JrI6EIJ$OcQ1P&(7lnzXl z-U~n@dw;+0Oa#X6%)? zGM*ZZ$kSeR%-H9u6kiYB!mD^pEXfK{gPZuHRSE*e_lcEcj(8} zZvIy|wj<+ThWa%hsQq-kB5Sh^lfk~|R^A|#^ibMn=)2}ixWun)g_mc5XWUiJARyb0 z<=Z{EUX*Dz#Tz~jd*_)t9sio?UHB`c&ifYdmjtGM(w+elp(n^$#^gwr}X)Hiitu zO1S3vGX(5dw1kW+yPM)XI11mpV`SMSak^o6s))E)q1;Q_$+CNoXI|WV%Ogs`2%p-vfU1|?wg<)X zV6>AKzL5#M7-cR_DrIu~9mzw3M_$KMZ}HrgA{)=O=+0B|(UGIVGSG)_H5B{VJ@r{ORu z#jL9N^zmPd=gsp&Rq^lL5hTDgR<*rEE6b_aaX>=>h*wRra&)1l@yTybUYy!y@mOi36GB0fQ{{91g@!cGftq4Vu0vg2Df-sCDs@`_3l2Hiq;6*0+ zj{rqe#5^>dy#`(Nb;xc+AyxM*MGc6nJnE;HliX*yV8~KVr7|fKa$Cg8|6P?Yi7Z@% z2_CO|{deGTB)#5guX~Iy*I4&O=V~s`cgI|fVp&q9$7qSVzL8x21NFk|Lpk?~Qs1JX($*UcL zTWPlCpX|qK3J#)iVnmDb>VA1aR{`4;NWgTv&aET!tgUW22tg*}F4nU*+`tz~!b%9D z`f>UO0cz=ej@@`|^sdwF;wYWiknf`Kb*d}jUmRfx{Cy&xTA8nNKh6nd4<(dvv?0jp z>@2tzByLaAv47LbS@s_>%$qVEO?5~n{6dpYIok9y5+Ei3fqfW!z=!wG?ENrJ4Ir?1 zihM9>j5r%hm>|JuHah(Cnck?H#T=9yD>msc<1O1SK13ks6|zk9=F5)7KS$GAn_uai z>XECh{4Ji;@=-%2k~ew7B}cQsz~9hZ$S=yH{UhaCBEepq$q~?eihLwId!y^h_Fc0` zil}6TtXR@eDUzVL=Xn|5sc=2aWS~v>@Hfysyrcc+T#N6BRzGW;1P}+)48v$a;0AC$ zY?u0ul}5_iVDRA;yx<+>dcJ!&y5+*cvg*A5^G(x#a_Bgrz}=RvGiUlqw56J)=PFs* z*id4#Wz2tYNaq=2*J1zCSvoLFc9bM;e(U;CaL=U7^r>JbU!JNdG0A&Pwty_^Hd{R@ ztGl;zr?@>op?B(BS}JD@2otC%SEDkR!slI|P?+9U{Grs%oPf*EGrYYM%2BLLmgN7R zKbmN`ddociu_jpG-c2^D5T_|>){6-*>1qf{fQ&>m*}i(JCnO;q?7w%P!(4SPEZ;o3 zO<-{JNU$YQ;7FWwZEBk0SynR&M}=NvIR`kqPA$5Ew#Q3lcA%(GXPRyi0yveJnr1u# zUyYg`vCHp1`5H2F7AMQSZ(xp`elDaTe`&E}%UF23wjJ8w(W%<<5npkU$2Xjnyf?l# zm-0@yeC)W@;CAAzm81*#)XLEU?*(p0>p$cgBle;gbDl&cXw=! zZ?9MEhHG_&b8sj!^O=XWL8BD4gSf;jt}1_UWAh-iC=4*RY=D922mU^$LgD-%NNLDJ zU6cf!FBkPOXE~NF3()3o*;T>x&&{SHz7ZPzBhKRP;|#mU7Cwms1}^Y}C-xieA9VQz zUa^UG>QgDPm!az+<-`2<0)V#lwdAi$>Dl3-S?nXvi-L;GY2NQ&o3T?TTj!&rZtTU{ zDJu31Pz4UfN2J_X!ffAj^UcNJU)#VW)@~$s-w4<7;d;@5@8Pm|>%_Q4Km{W=eRO)U|5rRT71y<7Qem95Gj);__1=lpB zju&-2S9vfJZe;K)yIf5)tZPy;!*YF;+ip1ifrV3xKD9|SAzDQ^+0g!t!ND5JTwp?= z-_3sZwSM1Se_01y5P*0LIX~(E_RHXdqnjPV?9FYMnqy#38e-Y{@AlTLmt@zmTgdu< zW!uYr6SMU1TZ`PqwDL;+KO6>-;9UGC_ivx**$FwwEO;EED=i=pXDiZcGIR%^!KY7q zU$F}g`-#+(=@QOvsBHtlHqeE6%#lBTdt+>T97Jc=oozZJlrnr#xtAypdI{*`RDw(o zDbVOo;@kHU)QN~Xu>lc>t0RGa0q=(Is>O|l>Oc((htrMgqvRKevt)My;lNi!EF?%O}wl|uC6Q*)fI^gfcl;vV%t6ZCex{{&o ze*daU-L8Lnt_tx65=OB1Vm#%9nO3bNdb}SYYrZhz3$OkJi!uLUlT#7q3_=cpxlxn6}SXG(CJPj_ME zQugf!4q@J099SKub zEX$2wceDc@sT5>MNk_*<-1BjQ06G%O!2yW}Wp|rNmcgVkX@z~19Wfb; zlX)D9Y`Q&W`nHEEQzg_91r%JkZDju|4x*Ab=}U{2k5blluX}+itr}&$!TFmUcI7;? zsH@e?Ab{Tn#WTfj9lDf4*B>@^X9Mr@SBA*%3zlcyz*}AT=6m{j$sIb574)AGuO!D^ zp+Gh%izNU%Sv&vzUQB(RQ<{7ddwA{t#Kl~`r@-jPQy3pHmcdr@vT^+nEYwo(~liB>- zxe9~&TbS|7#8OpzHIKWBAxf#3hs_U`whG!0f)zzM4nmeo>i*MhAHOg!Mg^ClPX246 zH>*B34mZ!*Wh-CX$ah_o%45?VigZ6LdA6-^RWXN$K{-0n*=#pw+Qf|oJf;5}RpP1q zCiMqE#zf*e=2tjj2oOAMpNK$F=h85h+TzL2H;`AQxzBVHM;NO!VrO#$wBrO}d{SxvJl^P(-jFOfXukXt;HNc>q-i z@_8WumnCLrVRQsJH)}zjk%kQD52YXHrql@tziJQfmp!)ssPuCEDYtZpzipV;^sXIc z7V-F)mz5sYwkfxEPD+hNS(uIAyKR7G5bU}c&Oie%ytfL|x00U79O>c=Y-byKYb5Mo zh2Z`*c?+W7>Q$o*sjkQ=^kLh7=&6t~r9fr3l8YKV{gIlYY+&;xN$NFLEZi2*p6)m~ z^BkdF07@;nx^j--Zn2Bd+QL(ibu??xpUqMauC~1b`K+aa%#ya&WlsLdNKEjab8TMPpUm_Ab z{Dqbg5(sqx@-iN;T5(1-JaERYr-gB(Dl4(us}TOf0I-})(6BIO#k>o+4T5O$(eOK2 znX9&#t1(3)3rUcK*d&}~%2RSxj6|4ix6P;IHoZ-7(rhWN#yS*IZbAZHPVF0nm?IVJ zq;8S(Lbcu?m>wmT_pA#ay_(RHzUc55&aBV690Fo&mo7Vg;e&>sTswUE+$JP#?69Xb zgfjQAWgpD3gtT#bUaZy*G7G2jOs^6PM=LQsIfw^?5%uunUV8YO+mH_Qx{|w;)h*AB zTj|rk>?t133L3NL*obU-c2HQe-Fh`JE+y&D1=d1h?t^8mRtba6r9)wO>cpCF+iT&v zb*SDXMI`=XlF-0O*sTJt!XIy)bA{4Fo|mKzbXh$PF8Y=(xEjgB)VV2Dm0H~v^rmq>Lb&IpU?Ba&?hOH@_hVN#@RcQ@1{|Ld8wLCC_fk4A}3 z4tnY#wq@8n4W%d-5W`7$3YZW$8wh0}qU=*pVDhjoDK`S<428{YCOx{|l-&jtK}k61 znh>o_{|d$u$W;p%+Y)D4jhtaZFZxs}dRfCx?k$Gz5g}0 zu}`7kadQ>X__f>s56_;o&0lHJ4S*=9pkV2;Ab43j&^9#(-4uDXTXCUAKTXm zSg`$5gO)LVRSEmiS|NlgjOG@$5^Fr25#EaR6H$6Qy+oX-$rCok_I7krn1``B-@f## z{)@VD2mPU(kaH3yg|*&kABI~%D8>Wr`0ieIrEVW693WuANRyS7DM?d*zU?Z|0=%(J zhW*Kt%pp?92X7X$9a6(oQvHI)2@>am*`y{5YcFNog_(vx+=}62Z{4woJJj6lQD zBABQYlZd*>Vo)|JtMB;!@k)k95uGZxUXm3?-*=1Tc70}Uu|ut~vXLcWYxJ&u@aL^j z3dcBAkIlHf*WSd{2$SF1TRy=8w70{F1o8X?f_?n1Y*3Iq^(6uh`Xmg#eci#g+rLvy zED%8qcAM9xW_+GuFC@{EWc8(RIAf}b7wj^j7}`J$B`AI9%n<<_%S=xX08F~87fwh` z2+uuktRy>oYSB2j#U`ZjlMY!%;C86h#-UqTh+B|{;GmlzcTkNl7jDzh#t{+@Bh-Jz zp!{SfizoH^U)4O7C1e)6;*m08wknfu;}q7b45B%U0i1nEsFZ*50pgbrDyal@R5MD( zG(B2#9QZB&7tEc&nR7O^N~~_IC1D zGS&iq_>?nLuNoAo1T_}0%K*+ZlB92A!#pR2nQ7WWZ?Vh#+|i6)Us<4Iqn#7^?;I@l zX^Pw{+up3oIZ_*7$_zzz!Q4akbJIjiue{=(`v00ZUEy1BY#Ijd{VJ^sTK^Vuv}D&v zBuG6Dc6jk}9N2y4^J?%}H>YGb%SM)$Kdk6(=DGl9wg395m{Oq%<<^(!Z|&9<>#7-k z2T`ACdA}Z?#(S2UKTdV!<$gU)S($PjJFhV=tDp|Zo7^-YAM<(sY!8-Q5{;LbCsq{O zI0OJ*voGo%JmVSnvV5doOrAiNx7Yl>jE^Sj%kWZcv=H|8eAp#h!sv$BV`7=YVQ4Zz zF#?{sEFeXi%GzGSeuYw$1%S!mpsE#NQh$0TG=UaWaKI*H12raaAHp%&dgF@v2-ku0 z8!-^8*-dIv21?jfrh)RwQzCJzhjy0dudRAf3e@XH{1*OEEiNetSQyQGU)mHmc%7`=H{ZG z+L0^rusaUeMs(QX&(Wof$AUx&+!(A5?dhHvF7yjwZ?89JoJY(32EdgSHHWh2Z)Olf zZH%NX2T%w4DLi3{TmJEia(|W(I*0&Txr)qxE{ozk`I|+4hzm^`6E&H>({H*<>V$oopjQUJ9D@ zknR<|;@?r5Fk(UuC}njXbdKWMN{a4fk#C3R$M;0lmfRZ6D%r}>F2KNb=fEc`YQ$lH+^EC%QKxlZ|XW* zqAQNzEwOv2_JUAsF-p;0vn>_>U zSJU3&ej<&^QNihY;82|~9?etU(T`mVLKqDA(^o%Mi(Rjtzb7}^fxzFz`Jb9Q5wDK;R(_Q&i74r^*-FQQ;We9 zXlv4822S4|23k1UoAR0eSDxdl!G(R+1plo>GWv0f|srbDjy{PYRcwdjLfLCRL_8`$#@n# zTnhD0HDGRu;cp9_z0aX#(1(cB%=EB5Jm1)+W)j;+@u9&(4C!lu9+H;tuVRsX;>|V@ z!8SdkBlwb}z@FVq0TCTCG4T6w*PT|F@=)lHXNm{Vm&1)?ZbWoM9>{8G61mkCLzb-R zYTxI2cZ6z$ifL2%1|1jveM0Hy%qg1;rdB_}ebzm8YQx3nMJaV+KQ@#o2ya|1_PM0N z!*4Ia6(`dAOWc zl-%F`vYGUrGXC5PcYMe#cEqNZ>=7P%)4ThuUkdt@A$x87HmP`2$3n_mz0uwwvUDkg zraL#-h72E9*#}OE!{;dZld*tzxv4=61BaanGrnuYXdK|CH5g5i81lDXp03P;=*Ip2 z?rKjP6H6CMQ6VDejZ}pC2KstkUOH$q$)ujkd?3$jl6q59N7_`>3?u@C9Ask)aq)j1 zQfI29l3b^67O!;9jJ#kZ;C5uvRy1KRiDc*z14(*rOk%s~CvooExeObkGDh-kzN^~A z0zB{&Qgvfqu41v;fOO2y5aIWY8ADH%pk9&8L`cHQyJ5~7+yQ`^wT$SfpLyi9?E}Gb zWo&5}|Eh0nXI!73E=`Q!KLPl-XVoqwp=-nKdDqfc1lkD#l-pW}6N69o`0V_eAng~s z0n@%zIBU+hw}s39#q^f!>3FL2d&>- z31hq52c)C6Q4{`kNqcxRX9orF>WsYEN_QrEBF|`}N8B~3&Lbz(UxJwBgkh>^>{aZK-XakhO~qFAg!H8|=W%*YjFZ#w zra)A`P2rfZI0eg2+0M`(S>^CV(t;R}dw71Nw$ZXcf!LXlHwBRhX$ESaq;(8-vhPbV zD=1g>Il2+I<&~K>C^i@116W;_3z5Wy@pGs^5@0x~m7xVq^Y1%pQ+6uC>P{#;l1EEb ztCO6z5v%AG>a@`quqyNTEf2pKk%y{doXbnMK(&@Q$!mi&K#3Bjm76hcj0Z$AV1va~ zIt;Ecqm@?%+lW$NXXCNrW+3G3S5qOc@geWyM932H=N3r$!TEwTC?9yCcOmF_qk>Hiw4$5W^M zS8YiCQKzMRQB2vp-r_zHlZ>mlrOScM9+9!P00F(b?UoU=wJArt+~y$nMz8a-3EAUz zBvcl&scBB!nUpEE;S=U|xb$L|E^ev|7jC6gmI6hw0itEGifemc!vEI-JWIerQSBFT z)!q1dv`kAebi!xy+N2{eLSVjS9+Us>^F0p|{^$|Zzvz$Ca&!yHAu+a`F^#Byr;+`O zjaEO;r)2*)SKlx>LYbG5pife*Nnh+H>u-_&?Fl)lQ5LotGyqX1^bhg#x3V?mw(BZg_IdbD+6Py+~vUxiSD}+@%aJTVc94ZOX^=80kG5AQ@780o0@5NXcy?Hs$17&!xtD_uLAXp zsHGq()hY&$o4qM#B)6ibQ-ulQkK<&y=U z+6Krmo6RG5<}-et;!mG7JwI{!!msFF#T<59Js>kGAga(U!rl8VIZ}vl7Pi@*19Jskw^O-kD z{H++w^K>YOluF?VjnQO8CS{a`1X1iTu|p8+6DC~0sb#s4u4Qz>cc+bG%IA+ekNXE5 zA3Ru=S-J@Jr+y#JcY(V)4wn`Z^YV8#+xQ2xy;go(p22Y2M*fSvuA9WcL-_`gLf-K9 z`$Pth`kn?XJ4RH7%o2i$)KrJ!YI9XHL;7X;cekZAG;~(%oYS!+I1PquyVBl6k?LqK zyU6~XU7`CxobG(LuL^rNC0?krXEq}Txju0xfw~Z9C2Hbr3%^LQiu;Lj|~exdFr&FYl2H3$ZHyY zsu3dWKo+Br#88N>3&)={XM#S+G}%|R;pZv4u@{2x)BcCK?{@D86Rx-m6fqJ?#bwPvY z>Z{e0cQVp@ELvfHtc9X)INgDBzK8ZSu2f9nJP`&~BPGT#E_PHt zJ<&xbZlu|3AA?jA8V7P?z=DnTb~sM^R|%89uIf;io;?cR5C+y zjB?}{jz&tU>JRymAXG!8F@VOUJgqC9uC(c#*4h zukuqX2R2@mmtnK*a_xox?9qNp(=|bS$yBgY$-p^Rzq5a@*NK*bwC_)Hp@Om)*6vI^ zroOw1u@ufngSORUd~JePzwUKx4@!6VIcTvmC)#6p}L7daDWC1fwsH1Ss+Da(YnQ|uuqTA>V7qR!}%^#HPV0o+`KGAj7KNp1GA z)3zuMC=hO-WA!Jwpxt&fOn;folfV6T(;P`F`exUPoV9C;E-PJrd3 ztOx&%z=U5$v^i?2wo$`p!WeQYy%b zhl_pAmsBkPXQ7s#z^7`)3^t5j0oi4{itXY}?-m((eboIV)#`iq|C};MJhjk5;!*Xw zvVG7ryXw%Y_)#5}&$cP!Ck}!no$M0e$}!*bFDvo#i*4uXQ+5U|QYAtp;YGg>z8_9d zENwfT+-ZWUecHQa8&L%1Uf!yI<&H~ZNbMEbD&?z%(-%O+2&N0AU$Z4Wgp%Pjpb1k_ z3Pj8U&LfX3s!s@9rLGthH#K`PhZuR;)F%hdl5d1LRtQ;GASrl<70PWiNIULAh3Sxpqzv<_%5*3w2I2fq}6rmr=OGBt=b_jnanom>q7-ONU>)2 zb&EobPf3CWwzIb89}!hAY|QG=eYbth7Lb%Z$rogI=W4jorLiv`LAVZm_T{(vFr8x= z!1rtP75(Z?R?DoMzx0oe+3eyn^drk~9_4q;zN!qwomkf=8W1}brBcQ|E6wr+TEqZuB)x0{Y3d`5)V8%Uc+NQAl-4&wtI<|yy>5unAS^^v2E7wPQ= z4N)93qI6$e%9^C5eq+o1ETd%{MzHU8EI-!&yAZnh`K|MKPi^nyt6Qh%_H;-lQRQcV z;j(|Yk0;Y~ZtpQzE4Zvkl;(ik$9g7o+x&gTXTgRnVdJ5GD*_}De49w9NHDqisE-2t zZ&K3V@^GwRvrwbs*(o`d4~&|h(cc!N;UE1whoYHTF^6x!IY&XahWJMt_i8LjirqCE z;0~Xlam&2tu%~*~3u&oh1$-y}I@54J&5L>(H0mKFN{DWTFS}xGY)y9(lFRP;s1M7@ zMtQgDigg->DLv^)OI{~6k4{&203F2Mxc?&RK#EzO zlxsA(58sY77~Lg^@{r#Q4-h5|6$Yi7Ydh-@zDj$bb)TAu@R z6^dlwT8JLH*G?R$-cA;0(t6G$G4fci2r=K6nOwNN8@~s&_pfO`HT7|O_x0}xY7455 z)Upg0Qr`XI*;IC18d@p!+p~Jd!HP_~C+Ay&HFLK)<%~h})TD<^&!({FN;(E)IRnP8 zSZR%9>i)8-ybPa^qU#gtR_T22t>f0*$RBX{y~#ltLc$e1|DK)l#})06{rSXc=S|*T z(2eEgZ^>OZS=Ov6pj~mujga88Le7OO&$c8jha1rfW2NN}^4%_2nEpf4bE1J@RuD@yvO^CZ6wrAzhrmiPp7KSKGlMds-D_v6_Qc1Ff*-?8&(K2A!?+tx+-0N2e6&?gskE zevPwGX^RM)oczM!KSj{uTIwci+vL9I&wizADP>khB4tj zuKL6^WoI=G;vN&9O-m%A;k*%S4cc?j`hIhM`EFdI+f2#>{@uAB?K2_h%m}jQ!?^~91 zVqOVD=mYgUQB1<0BQ?kh zNv79lI5*k**`x$H7%APsh5LVY+0qgbe_K?ND#Q<0TK)13eAu3$ukW4IS7Xa}x7=1H z{_2vzUf}Sg<2?;oy6@*1G>x%yB69Z`U^AwM$C8+l&>`?HHj#R5nwzhW($<;)B?zY1 z`QT7b0yfo;&n_9{7l4-_XDx;24Kzycbc%lE&UZ&-5JLyVs{uHRp#XW7$9FHIKbeYY z+GOtmzdP*cDplU)a#ub?rDaWo9W-57wAvcJ3hfL#ecG`1mhZBu-&VPN(Xy4)t|z+Y z4Y%k*qZe9$&!%vAH8aKJOpJMSKhM^f?o^d#CWZ9&ffbV~C!B;J&*O6_+b5ndzS_V^ zZ>hb<^aBD|z)n2HtQMSDW~vi;sM;(zROCEiEXcndAR)r^HBDWSPRp`{wZf_WjZ z2d>tr88Px~L_c@Mv`a>=QP;!S;M}5x5^LOHKTyNv?pdqdEd$pjDW zbRgNV4J?J^3U!Z<6{F>l2b71m!b=JW_%+d76C`fpALWg`Zd`h)0%_w{j+sk{M`%WF zMKp+{>co$}rA_N04kL57?q*P6-AC8;-tQ#;G|2@!7M~(Ag3k zRWD9&Nvef=Lha5$)D>OS7pV3zij7G8cTt3GmXkxrY5UD36}gAdT7T%oq%(id>DqU( zf8>0HpkiP9?ZNjVY$#5?e`OT&@jb4N{p;MxB@zmtLh89zRjF5Xs<;8FR9g%y8CF^2 z{JfAn!Ad(NR5B5w$SR zG8i#Nj}5qNP)THRhIc*<8v-}NTCh-k)%r*51;nc)V5k&qtrb=pWj!JccG7SJ6fzjx zvk^O!-vCRc(13EXp?472bbeclM-~bYC=g@<=!h%g(vj2^pL$;uu}@qEo5Yf3skbdM zpYdoK+nbarb#+UAalBu7Xx7@E6gDy<8{FXcUuAU7(er-Z@yMm{9^iAINaHbg?-99K zrmu&uP#l~c2kFSR zDkgcb9J3Dn01gm3PT7!{g1c&ZNx%)^qL!u-faa}m)Ojviqp#fM2Pi*{8k+fSn2{rHMZY0jOHd8eM3lmq9p6j;4kkT< zY(-FDG7c{CEFGB}TeEjA=I2B-gc`A0p|>h4JJ0-PVf@g`Ux|BvcyAqAE_vLxe#?P) z0*6{Q*{I$IUKG-Bv^bKQP^#2Sr)cJ8-cI6jWzz$FRWX7?*y1M=|_kCeg*M`jOp7~&+gD$W_3n_*z{idqL-0vMbad${p>5tc?A8ocj%7^Hy-FdWv9E{IL6-|jwK0i6ai>`joH&O{o zALopC7x$U`@6Yk06!JQ$@@yEPR)od+OP^@7y!ehq#+MY|@Ao3Sf#pO;A8GLK#oIU4 zWiSM~kQ4TRmSBu{GA4`?KWc#G_Wtepemh3pNsnhAEM%`zhQ1bfZxS&iph0E~oWVI= z&JuO*slX}9(B%B^uN(bYhV)E@irVy`yxy|lt}4&2tKdw5*mKu~{0d3a`xT!$@}il7 zS?ain{TYf2E&>${@wq&G5kNrntjV`y0gj<0LGZ(0oe}v_1i4xe8h0-#9v({T*4ub8 zKlKU_kA2${;DPKFd8cYt(|4W01}E`<879=XB(ol?w=Xx^NJ2jFvNK{ov*GXDN85z= z(1fC4is8pN)QXJG@wb0M7K#wJK@_I`<6p_c0{4M)ibCsZ3qmTZR(G?FPa@D3ZwvIs z##r{GfiIsFl6Wdq$yb2}Z@Bpi??VnLO-i~?_#=!`+7kI9SR?!5iPZ0Z^cUYO5rLO{ z+c(2s<39%m9~oUwjjvno6o473j0^O8G0mqCk4bXP_Ipcq{{%nWeYEs2I-W&F<8Kgr z-?>Aqa~wTLSWVKQH>wnmd@{F&Cp$WMsF0ClG2Nf0HSZqfPf26SC#G<34y~D*Fwss0 zUOX3nimQJw<&am3vua!TdP`OAeo)2!5q^gjb{Vl=P_S=3EzrSPLOykbs4_OmN7NDD zWcxz&$w|!v4Ud87x(_QjfNK!@n!~4A6Tv?U9)DXl=GioxJ-?#jP$X)SQ7Vqvk4Vz9 zEi4!s=t<@&6B>TfZNpSt6o@5@WCn8!CkPHBANW)x(d+9P+P8kAN^X~Ec~c!QWuahg z)gyanNYnU3=*PFTu!rGE^!$03;bCN9DCI$KvZ+0v(`S5@LNvUiu=A&R1}PBPhvPn- zr&md3B{inY(a&R7^V|I=|0{;nRpk8sspWMC5SPTNxWpHj};N}2sTXexTv zX^~Kp>?PH2>LmJdy0RNjQe~2la7u(JZ9N|T?EH7g1i603%TxN8D*-4u0;yM!H$d@w&$y2i*Tq6DyhrU;cnymd%x0W+B&|dy9BoC>~0~oXZTzj0v%&Z_C zD{N?j@X7Kt)B6ykEZi7_Tva0NvD)Ft7-p0q<6+`ht>3|OU}`H*9yj%-=zkrx!83#4 zq=C44S9Z(ShP0eE3sX@SWP{DYW$o`1+3% zOMK~Uw-@@;+aNbja&DMxv2zxVgEbc)BX!`}a}U2@(#AOm*c{6UfW~T?R6kwv)rbTq zXf2|MhM%WJIwN<%($n;fgV z2W0o&O4LrqPA62PZp9QyDo7BT8!Q>U3zo^#lBfNVnlnQT=%V^=`!f@W%$z@o)f!2g z-*$sKo-GG-#KMrman3buCoTl%SXFdf8t$p;wib19J$0cn<0LO@zjkdzMT1_|kq?v#>liTC+@-}%k# zJhQWZ>>oSVp8G!MTyc%v5)aEuAy2a=m&glW)Fs9arX&y;;lv9(x(YQ3B@oxe@E!&e z6i8TNMac>|9_2BHb3{aqvWM-d%ltbZ`irolu;zQjM6!(vE`UQ zsIvu+0PJi+-B&+SYDkIGZfq&iq51r;uOlDA7Hy^E>SxyYQPP-b3UD*6O9^Q6;u?zh ztI;qavWyEr#c+aZe$CBIZr__lR6pWS!I_lVmzo{ifg$*Bu0Y1_-P93r zWS-DbfLYUtwYYoXGtVTG4&&7K_GA|6-GDP2eOm|9#!yHTsg0oC(_1%|K~uNoLSVTu zb86nS6!6&lsBU=-iP!nDcdPu>#i!%GPBi#*)>R{04Cq=O=H1L5368g)YBa88>c`t# zW(Y}KQszPA7<>N)t@av{Zr5cRZFJuo3y58%nzPDF=w^b5>^4io;h(@(I0E?Ma+MG{ z34zZ>Zw`~63294Sumz!BvHvQ=I*9CKX338^)O3GDAxVGBwFOLYSxJLTv{AE@=ZjL~ zJI1*qe1GRFrG5H<*-67sW6jsfU~yoW8i6S=GFtam#GA5s#f*qAuhax51Ij#F#(NC( zu^`6D|9~>v>~BG0*iX~ta4Ha96t1heoMX~n|M-`5KJ=pyIW5|^{FhMcrI90YN)o+H z?{iox!nCavq#yB!8w7f6*QeJ-skI-^oK(P+=>_#ggZ z(T_ymss$7hvQxhLV1A*>A8v^gy1J247;U-@9H%mS^y?2?A>m?*`X(2Qw7pd$-yyvB5?H>yPGf17Pqo zMN0RK`&XTsk9m3_^4KXyYPl;5=9z0&F4t(FaAH=D@NksqSR7g25Pn9neK93Iv^URK zu}t30e4W8^=f3-3Pd1t68zX>&R3>((;w4otiZ>CqtS&9Lp1+H#_Ov=O{mi|(;1cZr zho_nn1v%C+_jF@8V=D8>0eQ}F45AL_9%=jUC;}uHLgtQzwJZLYU#BgfvXwA0KY$1c z)A0`rl&Ks$wq; z%$Gp61>6m7|p-FKDAVpii ze~Kb|GKTe)8PoVaPo5tuKyo)4gaM|Bd`Bpe=W~(7%{Z4~w07?b|H%5NaxX*F|k**PAbsLnVb(^AioNShF3^f*-kblQi zR9zeLt7k;Qjh|CZ*oo9rERN8u0gS8`cOE8aw~g7(D_84Ey*;BylWdiw!S9#@>|H6Y zIDen%ZV-m%5`ip*!+Gf5sXA<#&-wGr+zp!SGZ>@-ORnw;Q4@zZl-_eGiPmzgf4ZaW z(51uS86@3;WMC>L{$vL~*^u-T_5<8P;d;>TNQZQZ+8Nw*Cfd)>sBrvw7?Q+alHtqB3lH6 z_tq|p1&w*l{>b^De36=n5u+Wroq^caSdQds*gbg=EPvAt=^jgMH05MbD5Z9P>3DVx zjWANg2gz^ujdn*wEJjStX1;(hk6;ZAg1UC=#L2s-V!Ebl7nA#cRM&zUI6#6t%WH!)YB?J6^dN-;>j=MT_jnRk!=35L9v)4rxtSdJ<&Zm)-3N$VYG%;IDh{+N8tv%7nmX5BR7_B#B+~@ zbrF+BR`pNEB4kkRbSWu=erNLO7y*}=n=IMmz%kfPuKy2?OOA&K)#qd$E8G{QJ|_HL zH*+B!jd-a6zPr8sXn3f*u{cM$%m$ghfyP8Af>rhafd?QE(v#2;aiv3zQ?X)zx#oBH z?fUbFxNUnpMHm9HL;dPoUuUw;4xru+8F2R_(jfjBkM$k4_PlG(t;>dS0Q{`m5j&Ck zn#I^?*stDQe9?T2yitE9saWvyGH*g*`N}j<%YfnpP$_^XFlLJY=2_trKR%1*pK^By zf7mHs)LEkpB@M!>P0u#X*}{&3*;+e^>Tpug^=#d0 zcqx8=A2t94jR{?cW7MOmB`rDt%!N>AjAptWQu3bo< zKcPta1SHF?cD`6c#U{bP^Am{ZjQ8Nf^+b1Kj)l(fP7$=-@0}=WCUtGSDi9WR9t_WI z(#JKUW1Wogc;%xygfE=ejz6x~Di3Y9JWK~J!!mc*-qMdLmnQ}S57pq5&l$|ZEM}3j zZe><4H%ZyY*<%9PR5K2cN!3KR82_m!`JNnW&o+qB$8EuQD zc=QHqaKBU7%x^mRSP*f;$OML9IQGe?Q?i`Q%Z9Dt>jL?`{=H=ZP)RpVU`VT{3tNsD z&96vq(d$b_i6N4xT`JqV<{s@aIGSwxnYF$cKa{WZI>H8$Nwms}$> z)Ud`c?zVkaG)=(+gT%8yK~k|V*+K0bUD!f$LLgN_yDQV#i0*qkf2pCGqJ+B^;WoWx99N`^Q4`)msXhfAo>(OD_J ziJb9x^{i8l6ZUHxee*!~K{{AbJKdW=MhIm}Lou~1lgdnh&3Mlq>t>%!>O;rPh+AXe zJp0J&(QSf#>;RQ?=(8wWE(nxhjYyrWlG~98wa+1;>tacW0jPLm@{_CR!XNsZ1hzQ# z#z;CycKP)hKZt#Lwn$$im(9YGp-{6v1nLjzP_aUQ$Gr&RcME)uwt}sdpDN4BaOr>i zs$~CCwf-#d{SgF&LdfRm+4U*?M-!gul6-+bNB)OKxjI~OlD6u+jXew{B!;mQ~bS^&Cl(^-#YI5-kLuMa9YdiyI>8@Ldq36^!_O@uzM2gmMCViEKU59nW z3?R!9kpnV1`Z#Af18x7RanR3_uoZiM1`fvRH=0RT{PPHmXsFIi|7V1nC_qjPex73f z+{}-x=FLaW9%b}gT=?l2aUbOIwo75RJ8DEGJiv=6Jr~FNmg9)KO|zq7%zU!^2DT6~LBOs~)FgMOTa*X6d&y)8xfr zqK|Z!a|f2f|H%cu4RiSHnY=ohKHLLt=`st=0aE@Cbw?I0?>2#tc!q+i>TWK!n|*~n z`Mh9;GUUSi8;g!DFiX?Rg4E-|d#~?mad+%(OC`s+G&x*31o9SM=4F>X$H(|07CD)hpCacLj~-b&p2b=?fZ$?Lv$H7 zme#{sQ5k#-hkvc7J0syYYvGHS=M$f-$hu#A#x10Hyi#tJsI&ngQ5X^}gvptBWQ8`m zU3@S}PuXTwg9mP6$i<*Nk26P)%(&Wd+iyLv^k}Yiap#<>opo=ME=W8lZfDQ*UXN!#a5(5#+jtCT#8nb@B;4&@gD5Er;)TqaVue#CQ5Q@tY@) zYj}?k4Y6mEw}xqYePK~VS&bt`8b@zPGm2Pjzsg&G!ky%HL*5JcU@60?q;Vm8&q67r zTCcya2&SzGyxw3bxv{gXmX$^sF)&tdrOk@cz|c)atn0amK_S#0;|Dk6U;0@cVc+4j zA9-uwDmKKr>?a7luMtx*!XJ{!lBpcpWiyC4*{uYvL}{zHNU&;jZCM?RF~DdqS+-$U z(YAtGbv}=d2WNFNOF;+CK@UMCZRcU-d6m+o<@e8|J?y~kC)~hKtRPSaTV$dPw8cOkOc)2F6ERag9u;rL^d?Tec~5EM<{2YOd_*yrFpE@`a`Y&pJ0Gq+=?%sQ=C4W z8+lRud+?%`=is_UB7~Fo!j$~)kBfDI!*gfol*wGw?=j4DP9ZX}LL}e|fgZA%8)AEr zno4%1`6g3yvmAfC_S}q?LG==8(rJ@w`u4+3iRxRs@Eb_*>1JvI5p6cr(e|p~*;b)_ zoM#8zQa`A{Um+1;f844%6^%TnYsL9|58XiPBlCB$qQ-RHjjp%mW&oUWY9g4N2g(00TAm^eMXwMfT3} z0JAU2jFPU)eF(h4Az8^*d1ljxuIq}>*XWW%QG~Q_fT{)z6txY+`u@bw+J^>tS(~JU zyf|o+xw%Y92=sQLJpX7Gd^pcvrJvg7HXHbi>MDV3be^VWV(Jlpj&0e{=Dq1(l%8oR z7K#n1XEfg9$7K`ZPCYO$V?}^e4+cG)X>L~}ki(G+SJt#7Voh$MCZ&*{TAOB8K$&3p z4~MbsDIYppVik4cTe&u~H^kz2H70qCJ&I;jndvTE14&A333OTTiyP}3(+IJ=A4vBIvc?(X?qgoUy3-^=DU3r$8dV`FnOzx&bbIQ!aZmwFLV zw=(kp@8Dn`kG<0XOLNmX-{Y2ZoL5~AOvZ&PX7dbJS)aa$#riu&t_GjO%&?pcr>_)a&=R?r5dg@3rgg zH&eABo1i?Q^kdvJCW)|juAxq?`XWf%@gnKj+K674k4b_8Hr}=3RO*dce~;|n3}6}` zSJpnGf4zKnaQObues;&4Ng#l03e(c_`Ri-b*%vQHc>Ehg&4TQlyh~^2_Me{_+N4v= zwNzCxSS=6#NTh41W-S;sTP%0F`l zym8OYFg?V_r;balD0lI(cl8LaH!huK^XIOq$vP3y9V+5ajq8l>H3=4&l9*fl{C$M( z@ECX@j0;Q22e-Ylah~T69WKd_-w+C`CY*LXe!*FTVtW>f6uozxAVuSzI`(-L^>sU- zaHy0&`1TK9MLBt&IPdn;L;urNOYl{5tGVCZ`(@MY2pr|CdnY`Pqd!b0p)|qf9YS-y z(Wvx-zX4j)y=D6u=GWVwi!2KinSqy|D_wYYg3Ga=7TczqE-pxLC>97VE`(X8Hx-j_Q)r>Jj1Gmofkgq;CRyi2+M>gvo}hf2PYQH!?r4)a$( zro99X>oRdLdsap*0$uIhj&mlQ`F>wF_*_%GC8NzNY|3bB%8-ixNk7V`u8^{7A6PFV zIbJ6tY2-R%e=Uk>%qF2Ik)2r6GMY~Z@=4BFK}y}!C58BeZ$nN%c#q`UOE(p|CoCyD7iS@<;!duc0m=Z z%ddW~lw5lEhuHhI^gMga%iCKcv2IU%LKy0u$4R*YTm-6rLL^6rBTh5RZ2@d=5f`7c z>*+^qYJo4^D{)Ayytmvskn9R>TVCIIc3|Rw=V!g{O}Vh_N4e);Gxh5B;B@70O0T_7 zdv$}P&(4c{KHe2JtrfH!c|g-&PI ze!>%>Ov6I>WnrSxbIVuGUY7q@RpTGpFTGms6dtk1@#@>wbeMAcJaX?Am0Z@rUF}m~ zC(%68==q4G>l3(3ab(j2=dsU(R*!=T=0rc24`1D5*@L%dhuP~au>n@#wD?U^+G=H@1;=|&vD4&X` zwAWG(YfWwYl&3lWBKXJK+wWJSz;VVkU^Zr9>B=8N$MRLH?wlXo{L%*Yo03Z9DwcJd z4U2?xScbS%$&8>P4yIlc%``Zb2)oo})!nHN_JvFU3+>d=vP7N@EPWcXS|J2$ZOA%# zU_=fdq1_2%?g=%p3xBgMh~6d!^rnKZsO|?oeU!O|YaYr>KS?TtGTdst{rTn(!5MbI zNjmiZNMLrD=I8nGYy-QvEIR7+%<;G+dURRI)FjxNO%J5o+gDJ@w7*B7mvAPWzL*>O zL}Pp{vu`<-$=~{R)%IUClD&_7A2Pt$nMm{;L%oudrDhn6K%B7i*n25P@=#(eIK6nm z?kG&yMkz|xx?5Sqk1~>Po=>D4`93*Af4Aj{{pqUmNj8`;-$w%Oh~3~LmEHR!bS;p6 zuIrctUEMKv{YGo(dpLH?RP?w&dUq<2Am@;Ce&XjF$|SxtXFQ;)zk0JiUu*j%xcX^w z_C>DyaP)l|(Fit0IsEpQ_w|sa|9L^BkLKCUU{=~5jgb0ZWy{8^@0LM3&w}2Y6Tk45 z!&tCRdB^d)_R=;O(`Lh8wLZZGcN&}f42cQJovA|!(jYm8(CzaC!6AXTl4o+ zi50x`FbcapL+?jPxw=R>b5$P>8c%tO2$RTB0ZZI;>PixYf%MQSJD!H*VMPJW*L~A# z&ZMD^M3ct8pa}cDH;Gh+@5E5c}T#U3uVJVZen2t4@=JTHrLJQKo&2UD*Ob& zI0P80^;%-rC5$Tu=~5>NqZDF+;#^GJTG{0|aGli3MJ>V@YajYd59YhiK7A~Az@eFE zk+-ODsO-p;;uV7#tIyWXiqP`?B_)<2x} z8;L3y-dN_{Z|S z>qokyEe!1U?^zlhlt+9eTm>=?UqwW9gMO<~?lGyga^)!98jkqT+jg})6KBT>#Yu{xNuVu66--V)}+lhnVr%4um0dimf zMm%N0TQvl5^Z6z}Z~c5d&UmwvD8;U}8agQSxE*Q=)3G%B<-%pSnx(lzNRWq9bMfi} zv{>Ii=u08@9^dDS)b{Cft}sss=OtWH`UfmgFt7mE{`*KZHLiQ_ArgbK7w@;Zp)^ZH zK84y_tvHWTrGy8UJI|s3 z@zW}U0UdUwV$M%RJj+UU`y*uOP`x#h$8Tk974i-MC3ZCFEd^1@Zxbx|z?ZO3rEjFRr26SRI(AWfIYzJ6~OxT*Wg|f|rq_z_7v?sFW{Qkg@o! zgt~=1E?t7o%cbR8RI0}v-AJM_Hp@Q?A1E1aa0hVioKX_wQ9B8J@v2n`w-Qkq)_5TC zk>QlBSpRy`+~ra^*hp7UF^J&n92fefRq2mR>X3ih&L|J05!%{)*Y>)!+e_05KTsKP zfh_U#;IoufsrA8+nhE0mJe%RVILjz@XvRCsv#XL}Vb#x@)jHjchz0Ok$((;e@`wV^ zZhPHAJvm?)#xNs-Kh_lF$-p>F_8SniKBt3c%0gxC&ocX7MaubjM#?Nc42e*aS*+C-vz zkE9xCkRM>xv5&1tXeTN13p;ieD-0n0AC3iWo-y3t4Sv11wp~)=5X+D?0w$~L=|wUP zZ|a`6E>L45PY*a;wZhmxRlYnfj_e#+$r>EVk`k_MzWXU8a}~pIdurKyF@WR3SjWD= z7hfY?gTj5vcZeByZUl)3FDb6faWStEhOX1*ST}lMet76%yRmO)KC|jmNX{`xUQ&ZJ zP@@k=#Cc~#7B3MvMkIF%e(1_0Cfv0DNj2=Nqq_;kGha%vnquV)`f?w%K6d)$= zDTHe$^SQmyFYH!31uMQ51Z&Pgx%sgcrKRT_8~MzHT>x*JdylBXJRr3vUGdXI;vC`m z2?n{)3yK4?d^lB5?d1F%U|3Wav`xN&YXrX(pa0fZR==Q`8mdNeLd~p&zAHd_0L)i` zDD6EJdFTJ?T-*J3o}m?s$KL?TEZ=4(MG^{s8e{VZ^T2j-1;G}>u&aS9gVAonS{Nv< z0>q6HoI&FaZoGNx>ibcFyA7sjVJb0Dt4|}&YiuYCdDlLjOEuA)!vtKdHDe=V(Trip z9KzAXJ~S~LWEf96Q%FjqlqaDV&do+S2U|FIkIsQl^$cbklII+tAdwE~65kIj*4TV4 z6253!#C(HJ?_D_jV=bKkORmqd8`M9(^`w@QRlx`{5wEpl;%zun6D)a-7Rihq+aqex zpC(jJS4VV+YTWn9BI36gU*0h1h^8l#28N=2lkt?B{9>E+)0)Nd647iF-Shu65c^W~ zS+!GqJ%}Guktm_=E-n%=%9!-%13g`dYnWoNu8*HrCyb8;4Y+QMelphXn;!cvcrqEX ztwB2(fRU{x<;P9A2!+kn(54z+U#WW|Hp#5e9C*Q4`~B!MKGzrIo3vCp zz?-w&BT~!EcE%#*3YmjDFN?o^?cj0TvHg0Zv?_5MR8y759Z2zuKH-6`MN=ef#jwW3 zj!=Nwot73uu3;}FzMV!RyQnLxjlImfk&ISWZ)G1^ESHOL?0tqr!(78Bj&CEsx_sSo zZb|yaF(t{WQK_@1k-E1pGyH95`32l;{niK^t34M{&{+mgkk+!?I41#Hcs*I&EDlGF zpo{Ye_gGVM{2ld6!ICVYMFpBd6HY8MrBvgVo3hbg_!WA)6kd@A4uhcnUD47LUhG16 z&X_x;uB-#4JYWo-&H7;CqqQ4bVVwG1JI2KeZ!LzAvXf%M8j#&$@eMByeQo~IR#8@9 zSX*?k7~GU7_3a>UF_`CF)qVBB{DGE~vHx>_Kg2t-kR89&v{!6ls+WimbKt}cF&D1f zzB;>_skc0LYxuj}WUV~gwxHH&gNlQ3fcuZ_OiGSL7Gl!UZ^z|42qPUcDp zztT<?a*_gB+E7qI{Od1^432ysd$3nA~L=# zW1hiY|2`U~8qU`E&}QrWK-xyrdgHdHhYavEqyfwung)l)3SPRyX@i_<6N22_N0(dt6&er&fol*^fYO_6apIjgjyD9GkW}Xz(hzKNQEra-u3bRi{&Q4ma*E`BXXD=`NHSlT4iU?Kyn5%t!`qaBIgo; zWKnD|`RLi(X$JOUK~&?&2VOY=V&FL^Osr>vL38S;_`zcaR~0V*dTkjpJXkOAjg1kKt*ktcYhsZuS@VYJ`}sn<2?tCFbKq!>^g* z{<9cYOKn*Uj@G=%1l*B^9@4dA}ghDDH`b71Tr3>79AEKYRcFhfSch zaljf8wom0VZ@T*VOd3=8Q-x{_FqIVk)Fm+@q9vQ0k6kgz-YgN4Yj5QOJb z;mEC32G;$LAG|a0$Q=lh7+J5n?DYPp9KqupC%fTF5kzi?% z>Lks#@PAwYL&MbbPf4p5k9rRNx+-zP&4mhEt8|OED08>&QBCSOLI40$7l(i+xW#?B zF?)7jq0+S4{7m^>+UKe1{^Cr1Raq+Ezad0k7dVSO?=a8!a%2}&wN0N{U z@)on%(BNx%v)5(g=!sWD^Wt%10H@D0!g!qfv26jnN!{{pO(q?3{TzSphapcNV#; z;UW$F(&`oh;kHx@i$yO2f|>0yLxz(7KG9`+5U>n3c&Bw!!4Y(1RaLBK>4ULD7n*da za89s|_Mm=mdFF|M$i+`T4lYPn3JYVm^8G3L=7d|FLHln6%86_K+|r1q|F-F82?M8# zTrF2lu^oWfL9#{(Sn)BFq(jNf(mxc|46OH(Vh`%6Rr-dhp_Ku5OmL<+7Q+W77!i0x z^4zw=_n|0gJF)0-)63FiSMjsh>T0!AK2}I!H`*e69`t=z#N`n~?Nd-@+EKYqeLXtZvtA<{%W1 zU2XKo>R^K*w`)?`eEWmL&&&m;kq zcRQii-VFmP-_!}cHtI@l@l$2$Q`=a?b}-#=l{|I4lai8t`v3?0=+%y{){Mk2If4@# ziN()kjj{KTc#mPF0rkci8s0AEL2=J$up>KMO*VGa^LWH;U^T(Mbl&CCo=@eZ)CA2A z4KB3nvpyQG!yyRpxBxa=&b`c(2UhI+n*n5~P}5mX zclgta-RY9G>V=DBFszmDe6QHT{B_&YoecC-l@^b)&m<2_#ww7EJ<1B5+nA3+FI7IB z26Jofy*4za5=1CkaMICi@S;jDKjrU5h>#ZLb?w$;NQ5ktj>=s$8p06n^R zmT;GMG85|PH&jt3-&nTfWpeUKkug7qNP>cbab~Njw z+hjZJe#wU>C8-9IRp#_1O_ve9MGXqwAc>0)ZH@ZHzbiX%IptvJW0$+zL zdWmugiPVe9@jo?RR?}OE%i^L^hqD)RMhL*ZmaSpQV!NJ#D7R3rLg?rTH03F-_e8#n zI{nVJzzuB^%~rH0chUm@1>ny24CLyNJ5(qyfTyVc2^9F%JeBh_#0(Ic9Q zli@|Rd(RPD;F{Qf;f!H92HNR)?Z^F&7ynW!+&}6>Za_Ci-RVh?l5Q^i5}#peD1hBI zZCWDFOl&MprJ5OWAdE3)ExqVV**4;ypO!9)hYweFc<^kWV1-hG6T{dYc+VyOSVK?j zJPDF`xUDM)>n;URoFcN$C-=q_g5(@U&TRzctwEN4ZG4&cQhRU7K*;1dNX@U+K6?vd zF@k>yku2@QfZvpW^Q8VCDILd1R`#GLQn3w{4|Y-JKxQ%|c|}Lf$J7x+7)?Y`5+#x8 z>~T30%9Zy9LqDiZ?`KP8hjAm-Il6e73@-P{nh>H8r$5$W+|XE^;l^hzh|OWoQj)8~ z_bp|~RZ>8*r=1y#7(nCaCB^uGJ`*cUEt;G{^aePYXdj$*f-`%@B;}oNG8}vkW{lh* zrZ%hQwOtjF_CG^H0*EN7PFMsexdmdU%?VYpldUjxBT>02$X&G(z9<-HK*M`aDK@ay zBTV0li=f3c(Q*^g^lR>^7K{xsQ8sBO8v2Oj)gi^?J=&_evna(?(!xVE+i$Pk?a%#QLX>`cseFfgRB6=#VXEAZ^9dUa zhKIpq4kbnE0`7k#YcMU{G00S(RM)@c`2|GUO zeIi1zk0rl5ZrSUgi@MZZEa4%!|Azw4Rc%P#_!NTYLfx*;{Kn&`P(cg*o5$0o0Lv+<(z4EPbaLmi$(DAIOh8^pr~ScM-)P0 zJUP$ww%*dL^F(L><_a;wa>osf{0O7iSn+jJ2bIg?4XA_eHU%jR3x~lMJ4EK_O_K{c zyY8~G;$I@9KS*q>g5Mu98_lzMK~)SS>=g5$z3iD#58>aE zb&{auK&TFeOoWF!j#E9%0VC?+?9ZDO9|s3R5I6KK2?2@6cM{k5d3KA(v{cEA&=tfI zMBj}4Y5(QR?X;;JsWsCU^=F*iLfC5?AiQ-VR%DC3_z`og&GA&fv}D@J4X|oGiCt5L zbA-9qP6hqtcLwZ%79X!hjk^U0_3nBtThM7YZulwT03UB{Gxonmg&v*gV(c7K zzge{@o6uuW-gpROB8+jdO;bWF@BIGo82^VVhNs=4%E0}!%BSCzq^_0S79Zns!S$aq zGq1wFn~8bUryi2);`NaESpjFKPQ+S|_jEQ3MPCkNZ!~B=;sa!??7dW-E!6<=oa+l7 zX0~F*5FJ=Js{qb<3Oynt1J{u)T^?^`R2G6F!0b0$<#lX3nD3TvL3i;OdCEtQjYw^c zLGZVI`>hWDDF-=Ldo(<6J1%j?owgJ6`;ME4CH){m+ez9ebYep|fQDIidIvqjC07v9 zrN6rRwh7g;tQc}B^#N|S<`EOJ89G6qzABZUmq-OoM^CJ)W&hPs>x00EssL&BbxKyf zT5U~hbC7>u01Hb>{Av@l?%V>3q5-k4M)fwhpmT}99V)pVoRpOGrso-+7j8(-xrB2Lv%IAsghIP9c6rUmwj74LC%Sxhc0)k zSaJ+FL0y?(8i^oHw(4;sfRTEXb=ZIl!w%neUHH(@Adl#)DK2ib+ix2g63Q4mN>sXi zIw7rJ4iulTTtUk!fdienY!k4)PmFbux_diRA=dn|d^0ZIgdh|u8FEV+x+ zFD|IGjv77j9e|+gQuqH6AswVUI3X+`sy#S*Ke#?-%7H`T(-qmtdNctcZY(9Ld#$`- zjsV}911V|YcscU^aOgP8gKe$#NB2I-tn}rO%%kX&Dc$5xaspQ50}Jw)dmbxwq!i9@ zpB862BeknUm!MVu;{+@J^k&FqQeY0}AN+KfM_$=gA*;x1=nM5zr!dkAOx1`BVyFyH)(^uZ7SuC^V?A|K_!Sk8?*wBb!TyYZ_okzVlNMrnQGuq*~u0Hs|!NF0Vh!O zmYaF_O*qSx>&n1WnTQ*}?XRd`XnwSM#_BknJHLet$=rki$y!R zDb+#2i8-a;y3wk?i;XT-v21)i&{Dl(CUSBb)1|&x`Wx1PNyuSl{+X9@qF1Xu5C<#D3uyMGtG1Z<@ zYSSBs3|F$j>lzMMGXt{<*8MN20f$Ra#|N{0&xoo!n&9@A_o@t*^=>@R!-?P@~$**N9arqt-e zha;0;{zd$^{v;Oo7Sv!1bmKEWRfc9;60qy(4nG68KD#5T+2vTML3j-`_mf#l3J7V0$0wFE{pB9*f0MEZWakI0Sz>~p+cb`iP77dJj zqXnoVlyxlV5az3o>SRbF8)E23YzNluzw2Za;Qq2{AGTd=c4m&Pv&pWz^$fMP44fPh z%`6Y9t=<%REq9AoBeN#wJx6pGJ+46_^~qL(b5=XjAFG&pfV`&g3%1K|jj=C76*J~n z7Xg|Z5H_R?&dC?RMiD!ES(x8KqmFNwD?|@F`EJ^~bnN33iI?4;pP5GaHT1-K(fdnR zl61a;q!>J7D#VtZWguV<`VV_(P%PG8?YN#2S#rtkf{q;aEX60(H3Av6Df)+Mpdljj zD#i6)JmHU*gmwGg5&zOA_A+;!DH$4+O`WgK04?nv@nTp4I0r#%ZXO#G34<} zaV1URXWipUxMUYg&T(V+IsesvVv@kyS8hQy*@ncVj7XA%_?&)O#dMu?Xjh*Tl+ey> zd^`xDy++f0J}`8`(rgIPyw~Y8n@&c|&ofMtqS}iV#nG4V%IOQp=DfG4NW@%qsfkeJ zq;Zb}C9l=Pk4?>Eb(y>jE4yFq#stS^$UA<^BY!p=jX2du1n#~dLy?X-XZnGH={U}t z$|({W2-#y5!x4)Pkoc11EKot7o~V`EjANv@yHQbcN~iSsYx~wmp|;DSidp8?qeuK- z={~4#70T}!BG>A02+9sq9Xe`ixR_)22X3g~`TPa&jQOU?OenQZaz@QW!F4j*7>3Wg z7SViQVJ6Bo`d_``J;wcK>gXH?BadxC1L!2FIGN* z^C!#6$vV*_ZlO?mOQ++6DY%~$Rgi;C+a@wBBg-{!n7!iL@K$irk-f^hJ7Vak%gt)> zkYDFHxl8ijGTP4Bmz7ENs`dLAsiy-&0Zo)+14A=thO{1IQ^%G2hE4#nGzRDdWZgWn zdJ(uFOVoIhSis$~O>&J0aSUPBg~Wu!>vNB zo5PCw$nvjyUmln=uxngI|M;!?Bh`vuw5ZImI(EAzo3l3J(#?B*^WXrp(G8hw_gAi@ zY4Bm>K5s)XHs^GG#&O9A%dsd6sf0`H8d2BJ$&>#U%^~P!6aY23-zx>7vaVy$lNDnF z=1+Jcc?$Fqg0zcm!;FmlnK(neuQNJ5nTn4m_S6GZd?)w(J9V|t+q72D<7hC^I;IiW>c~=y8Ggjg3x+t3g#FEkKxXQ zE5Dl1p_?j3^nd27P=2=B)VA6s3v%I2ecLmi?FVI+2-8S%!rG409ROd`vjqzyi#^;8 zQHHGfyKw18M^yu$6JyjKr0x%!D2+jinD(-0kq2Gs2ho zTAl*+Z|u0d7rKo@?6KF02}8SQPRf*9dBf=kM?o*|H=%M82U0gYA4;g-pk#VLU^PDB zbemWBm9dSeXR(5e|8c=7rifIQER5%y9|ugI)+T!Sc`UNA1?vx+?2Nrj;8fG64=KT3 zfRjnQM*=fzYaZ$js27qRkte{Z3>!n`iCp&uDEQssR-HCn-91`dkk_FQh0Z-i?0+SB zIT;6)xP1=;`O?a>;dt2+cPoS%gfLpjRnTB?}b zdzgHQLwx&A#NgWg+#+;|HHSc!fb(Y#JMJKm^BoTSG+>ky)aat|kQoweSv&|zxXmCj zgnzg0ccwJ`OTf44ym*|SlIgf%<!&*(X}hSTNnufe&lUn$ z<_`|;0}BMsu2dGI&9JM}u>gfii@_@5?gP`)_C6sK@t{H}PI7&s=eUf76%CDtUHB`N@2DuU zOb{!MHFmL6c0;vDI+9`9qg>SgS=@zd+hfrw`iZ)WdqhTin?c$r*!wK~`By z%7w$6U4nnW8CVvY%HMxy2Me;Fh!{}B*RW5kL<#PFbScRP4}1HB6x4hb>s4(Far+rP zVd?(Mvm%TA8yPK&ta6_A0|gD%9a+@UpARw)xp}U=K34vgzUeyF$~hVGe7JsTr4;k9L^4Qrvie{!p$I$Ir_*<;cu3LwvN_( z5!Kd`-#~wR-%D~#y>B!XeFIjutN0j^U}|#9GufINtK@0yAdnseQ#}3PXRy?OruN5bRgUItPj{g{aED) zKfiUb`U)i&m6tR<$tq3LL3i3tB3onnu6)cq2~QQ?rDa`iIh{-u!TxCz5~ci1W!#Vh zU-tyHlUj6})nBqx@Sd;8;J-{<#Z;8|#5K(`hmKY*Gnk({c9$Ruj}H&~>a^Pyty7}o zfGz5GBEFutq#$`uD`5Z~5*k~qkW+kFYMYK~$)5ag zJIe`Ej#BW%EZ-;K=P8AbNu%EiXvC>;LY{r^D}+bzuJFbCK@&GAWuV7bN=b9Xx?Cx+9mrHpea!nUZLK?mg2 z`0wB)?7&DX0Rf@pflIBqn4+@pGr+U{xbUB8sPj^WL)K!Vd@gGJ8lua&wwJu1@Zld# z7_RP}sBE9T+}_5rJWoJ4f7%ZuH3^jrP)vrnTC%qQ9n5_d1X9MNixc>q);^Yb1n{15 zD+jyYcAngxrm1RWKa11OCE(|Nq?$$l*rGji@e`R?Rs)src+WSQBloV6dvs{9F>*7N zg9FfeQysniEd>DtEaOy|HhPYQvCy7t$%n^2Hy@-e#Ivc52Z?K#c~;~fJy2Xx{^9s# zURp4+4H;`Ec~cI`yx%rG#!3TJhz5M31;=IAt^}2U#Rm3c&IPU`1e~hJ!j2P0jvbf5 zh8dWE&MQute}wyIG(|JzjzS~Sq~l$rNq6!@uF^vb0>L;cn-EH|iR|P0>6o>Z)Xj%K z5;E&c!MO+F+dQ=j{>Z3%z>RglO0~0xYVhi4R*-vIC%a*#pG?fQa9F*3eoDolgl|`! zu0VcwU7GI^?YY;7In$r3n#RepNJ%&=O@`BN`*tLBNr{Dn4@D zD|}YlpszO7j0DQr^gzeo`0|#a6P;$bAY<#`!HrAluF{Qq9bDLTkwcbVamO=rq z4Bvl3w`p?FJCejIU__U``#G(W*QnY#mES(T{m5zwn z0p{zg{-~xoVA0&~+PYH0fnlbu<|hyw#Hu!CMktKnrMdjQbcI=5-B6$DhZn`1IRp#u z)v-Y94FeD>S}Q?ebh(B(ij_hXLJXvYfhCpFR6f7_IHqsJTO3ruJRbmVu`3u-lEFe3 zez#Fkm~e{l6TWX+=sv{;9Z(LrBIHc(GZrxzNF(qlspJXZ9eGz>S0n?T`_{%87Z(M3 zBpV*>KqBb7x1DYAL3@)86$?w)SQ>X4xcg8tFee{`j|5|IUet6Ea0u|Q%i=^M1SVT0 zhq*)QnDOa{Zmpb(XfWI=b%_t!lzVb-0N|xe{qSu19$x6<*6y=6*vm82sfOye@kP!d z`FcxZ{B@_z9cF_YL1lu{ap1HEQ2JyVhq>Zi#~(u&#~;wgt3j3h0Wf?y!}KWgksZf?XJFrj z6$^f$+l1m~l1fo=f5F}aNNYT=FU`IH&e^4#S}l3GWwFBD#k}&0G%fVdHnZi-GS&T%8LFPJun=sotMCq zmy2K^WJsXs?R>5D1EImlDJ$Q}L2t+PBA_Q9_>K(j*;;mbdVhB_rwcE~Z=NVZ7?T`4{_B&~ zAxF+O^FG@H?bbe2Yb+c+yg?voyEVhiB_k+x_=H0dQ}h(NxW`vMAu#>83diqN+rblz z-Q0cN|Hso=Mn&C4Yn&Lmn*k&QX&D&0VUTVHknW+C6iMlj?vj)S5d=XxrMtnPQ@WeE z|M#wS?-yoZExw&~&fd>{_U}2(z?7VrSfQ7~yy5VhsQp>^aFaIGOZT9ka;>=TpVhtG zs$%sE@FZRS2O2H*&x%IROzmJ1DUIa@Cgk?e77ARTviP&F1pj25gxW6A-ZpRF`yWp` zyMq|KGZJ+=CDDYzL#9QfZRD9o#x`Kq3H;9ZXx?Pyc>8#wpS^XX1#%g&HKPDWy=4xB!`db1xb^G!{lx0-i-?iB zgIHlxsf*?Z#xGr(PqRRvYMIm(QOAw>zd+=M^nLz^^T0>D&O0abIi%G6`wv&QJEi{g zGeDBS90=enfCh5NY*_tHQ9Ri8rF+U69TmcvWDlj+uO{S;(tv2?il@B^bc`kSPr|xLZKda6RJ}XXA znz#{)Doqt9)p93hMQZbRo%knyp70e9SJQ5N`b{vO@aqIOo}h zdxvWCpNk{wAt0YdqbK!LtfMHBg*c2W3P`Ut(23Mw0>Tyg3ki%~tb)5QyPNLjtr_Qb z6@El4Taue}C%JKBVn=kuH#ae;t1p`*1mZZwv@#%v@5s4O@84=b?`2)AiXzpqzZ?iT z!%lmTrWM_CdU|CNRzC;`w9Z0N+Z8q`iNg{@BCxY!21?B;G#9)F>cV?8yX-SLEOou9 zzYQ@(=z4vB{1bhYh`uf7cE>Rry%|6y2 zEZ=OjACE)6G*5&+=DB8N8I4@t_vQf(>;Zh=+$G=cmB!FVi5f-Z+_pa9mEVVw2B9C* zhwsDt0MY#Khu16L9X+`Gum~RCMocmQJ4XU{p^vr!UciD=K%j+T`lX*w-pP2uyE1A1 zl|f*r3HaTXN5g&RpN)^2n~5zRPH+p=iQjvi*ZcK`;>9iHK6S5~93MV)TX}rz0Gi&> zhbiH<)^7=q$g#eMTnC?JS88tcDC4USW4NWG zH%Xk}9`WEoEGFywX0_X}s|7Z?`Pqnn$z( zi&^cVMJ@078~md}AAtqaKiyCC!YB_5D22m6m z`Epq*rvUjU^T)sW9Zik@V))-gm#)@;bcS-pnD{wt#O}9@3A~fls%c=Vy?B+a5BiZ7O|RcIOkX_tAsAFZMK9uXg-0$5b#l3=iRWswplSOAo=U+#jgM+#K``-XlqoeaBH>S`3u5IxN*9!}$AlDZE znww;gAgM1SvBvJ4=^b6lk8woTXTAWx8>Wv<9Q{a7nATG;Dc_-K{hjgYZ+pZ6g!_+z zhUA}v?^K^|f6(B>jF}l?!hgLt%BHO$qSW8n-Z={-e)z{2ZmS*m)^HkR$rgXTYA2jmvB^DeiZCe+89Z z!1~Zq>w51Im*D^9+rzAyhT2!)%D8fo?g$jGAuHnw5k?pSyIiN^#sjGbFJn1@fv4U6 zL>lGMZIxyF<^0t9JSb7c69D^Sc&vH<;mA%1$SX?FSBeX@{nn9>l<>O#*DSAP1f%-P zvv58!?*51pi;g*bW#Q$Qh!g?bA#+g>gyO8?QC_sb`KQa`CF36$blOm}R z(HrbkJKLXr1d|j{SxXb?w(40gUMrEaCS#TV9<4$I`)j&EG`K}VC7t<=VB*I~yI=m> z42&qHjRhdtq_b}{ExES<@q@Z7kE^GM3YLYOnW5rE(7|R@4_0$}x!Q;aXi$DO5u5Pw z^svh?2Bm{2F7%phqepV+;g}t6Pi|t|JiU4>G^VB%M*Md^>e6F-d%l&;Ix~`G%0epT zz+S=eoc??|;e7g8r$D9tz5p2UA76NYW$deD;fh+D8nZ*%(gV_0B;|p4f*GS~pDTNyot~+&sB?(hn>*SddAZI_@GM9OOT^ z12@Gg5uKP}e-?MRKNuXe?QK5f9+OpX!8jE(LL7U~RGVvAG&P7iz%NepX_y9(XZ&kl z%fx1yBj*Bd06_Asn|VFt@n8aZSM$`1Jbw=`-vSS-$XxAs5WW9xPQHd9_bc+>RV(Vd zt-o6h3I9!WMJBy=02`}#ZytF5-RY6jA`{A#fYXTg!q#LX@XL#;br-{GaP(kP0Sc_o z{46tUVG!`W#2jRQ92pM7XU)Nq6#%0GExE1~tBG9A-f|;@@!17C+X!}sX!-%1Bw^t$ z4ZMrfo+BPg%I`w(ohBAu*h3n*JhGMvNM`RG)y&W)a0j|FNDRobH6U+%(10$-{Mdi{ z{8PU3%J16SRK+A9&XzAq4Qz<1@R46}^%JP1UPB-!K`?sMl@SuV6{K3ob;rp`48}QP z8>AQN50}&BTA+MyEIku&aeSB)X1yh@c=hq%08Kp9{D`EI`C@)`ctAdV)lc&hm*(Ij z9CO-fQa7~9Q+lMy5%;x%?6C)`UZEg}(V8Qa@5d`z0d7X$kkdU2A=AP{`eaUcTo1PK zQ-PY?%kvZ?DaLF72;UaJCV0jcHu`(@_&Yu42LVa^ivypNuRFPTa@Hn|I=(_*M0RZ5 zP{>f!^G42>-#54P_GCkESK7?jfW)wj5i}D(tcY=A?Egl4`65l3O(3{)*9m<4Z=_nR zL=8l?S>Ke4^!n!JS2~lw6R2X6?4hTt?Uf)%wBQO~FBs_r+`fQnBf5gD>5AO`fZBnHdp3^GsS$sCA7cvX)~){Ihxe9yo}$3c zpmz27Uu1s!^=;Dr@R0<=xt%U6bEp~zB8%oDLhoC7lGkpWz7j-_u+^2+`w(XWB)b=TIXhH9WTqk_RO=Cl;{Fv z&UAb@dSsNp^QC)w1D{S}?QwEmQM~utF;|K6mS8JRbITv3xWPjiUKF|r3E~pK=k4M{ zb=Bqza4%5SJMv;_zS~$Y7e##6+32PVGtJau{i7Pk7lJ})5%21XgUu{&ccP`3$k5Fr z!*U@wD`(H{@-tSBDnt{L^rDFJ5~krU2x^r-JnqSxy7qNOF)e4PZ9Owvl#Y<(pw)|= zV!ZK6+YX1}I+FLxnFFv^>^aFB4N*`5M>4AV$;5YSnR3s6LTXa&1r?o?bLl}GbGC9$ z0V4@~Dguxi*Z$NgqdVFzynkqzmRqp%lW5S!YND`?#)F|`wGn2u01Cl-YnRTeH>8j5 z3|`sr($9DRRqQ_UvOcG#o1Pof9+MlBQQ<~)32yr#JGU+9&ZMc?pIc0G_tThjI@xuL+37XT*y7VMVTDdebDo?K*Kb0FudBQ-$|Ie28Ql!d%1*HxT_ zFV8A21mgF)>a?Y3VyDV(5!evqyP5qfU(?P2Wi2Y9VOEcagMTmfgfkLkb&8ew$oIl4 zLDs}6J^F;#gN&Kl_$UNXv2vm&tJU65tqZt>D;19aCKgr#{JyE@-hJt?CoIDrxS8xY zuXcHgltv2AeaSNH<%_|Gc08|7dDen4ooo8u&Tx^23pE@^Del}{#%z!gUS61PPWHe6popwjh0Quu;~bh5e>@4Aq2l5b99n;9%rpI$EbTskUDo zQ!6i%DzS0AnEUq6sAe}xxLSPu>~&)Q7vAFQ94PXk=Y7sIkGqv8j#waPRA7DZ#B+ns zm5ZqEdG#o@8aPS(!~9zSZZ(NZ9`VpoNi&>!T8Nqv)F(o?o=yQ3iIU^gNrsfxHp6Xq zGa{H+d`>!wyT8=NB&DkOR1+V_*LAa^X`x*Kmf0YeM=-k{)Icpe+(Uf*WN_GRs+vFaBiqg{a z*F)S;gg|56b&x#lMDG_O$zdZP6?U`tz4n}QnA;-*&N7tIGDB!Bv?ha34<%y zqnK|Je1Cz>2$>FTu08r%mac!|DKhY?v(A#+Fx}KIa9a&r_wLSY#M)r6W)%MqK%#_O z4y39_8So=#kPpAREeKslwL)Tf727xQPWZUB9@ldUe;@nre=;63zkOET*}MjFEBN9l zLTo^t>*S8VwWO|A>%1v}6lEJGyG1|2Umhk^@hfEpyn>u9C_h-iQhqgGCgAMwYK4 zLoA5tTv2nCoe->{*$g|lSZ2X(vBRlu$m`Y-YZ?9?6B!$pu3S_g0)+*yO(~^OiHJ2> z=*#3JCw9S0L=?^m0gMLo22X=nf@Rdi&|G6hZejKsZl85@Z_@iTejW5ngVMK3zpltL z5zXbmuGdS?SH6$Gfyuc~#$2F`88f`gjGA_#n7)|9IZuBohckrDw!fsdH^uN$_BOhJ zjU`)+rSNQlr4#EhX`vF1izOmzA8xfIZ^+Z)m`S<7~5dYsO{y}8=R2b&* z6-=sI7*pjmZF5r_LYzZIDN6gIapZJH(P|hQ9q1H;i^-RZ0Ao95V@y1>0-m)+m5V?)yA!HN7j}kW2IFO=c z4s(&=+z*jEY}DsPG2g`7AFv9WJN`(&yRRXNKNj;&7}e@B4KIQ zqIp}Gi6&!(gYnQ8;HwuEeZjYj7ip-tSF1W4kbh$;dPx=9KY?T%xw&Pa%^W|Fn$9Y53K@IE> z>r{OOI`H4P_PRS?uwf~0b!;tlu7yr?mH<8SA$55A=5PVX))cDPd8l6qLR613Mm`E6 zvbMPD+7+qv=f`zE-z>d&{~~c+8%fYbQlq{V8hG^(^U5Y{){I7U<(J_?-{LUDi}F&!IyweS zbFq89-&7YaVa87xaaX_XQX}z1Gl3a9Ft!zB6zIpVf`|&65B6fV&w{>*zo*@^%Q%F@ zzSZ_`uv^tcZYC(GZ;20uJ#@Pu$2;$@k@srwTh6vZ5O}MU0PM&H{2WEZut$agR>H603K4rIyPx3N* zMkt-+JL;w(mafhB{gJy^z#)@;nnK(I076-!GUQ=CuCcb8-*Lczm5e12TMk()XP*G^ zR(5@CoOC5EjTJ(|DilI&MM_!7F}Wj5I+>Ix!rz~ObZ|tJER9h}vO{A**rlIE-#oiZ zI#~XL-td(rvw)jR48%+uX=#w@=+>pR-b$A&#y>GSH#CA_Hz&jWG$?Ct2d2?LOPSb zz*QN!nLfszkS95T{;(GUSq$Lg+_$bQDq1noyCu3TXoVLJ4J!e$GMie~#HqWl>A>#8 z*fEBO4EBu}k$W7N@WC}S6Es|O)^)vETm@7$92Tms?1BtQwqj!HTs)EYTWSa%P0I|y znIp>a9cgso4>!yCPeTl2oh$#naLC`tTjc2Xm4966pr5;aW^Kzerct*k2vAehLyrNd z6s1FHl^t&X+!`3x(`<0q>eS)qiZM_Qg(+Y?eehA=`9{jR0G(DiKj`Bm9-30LR;aGDZb~3j^v@(_lhMu76j7JfPoLn& zLNn0JNwL#_{Yin*t($+@`UV5xNLU?Fa0)-d-_{Yv{~-j&Bm!KO0%w)i3Cl!@NAZ`j zb~}hr-0)r^3@@b&w5nT_wY6}+IXz4oBH8eWLU8$!S1zDloI_ptXJ%Wp? zW1)De`|Xp&!3JC)K17#2ij_O*&mnX{x{n;pUigujoGsfRGA%qbyA0y;Si+Th$J7n9`>NPXmrOggm`z%3>XxY{~KYQlGKun4J-a zJ@PV?li*YH!6&?D{eC-b$zkm?1kgeD-+cWrOJ6FUYu~?@ml5u#yC<)QlSn8%7R^0M zV<~$?p{N2RPiS;<3qjo21|ju>nT_GTTA7UHyP9HW)SkCdPNh8cov=(_D!j-Y5%hD> zI$fcziNJk*!#S3_J5bic>SnHA%0+`ct!>xL@aUVjs3zoU1*2U)r=QBg8^a>Lrna@E z+m)j0C2>b?=DMZFO+@fmOo#u;H4C)f(^|z7`V(C(r}np3veFUvZ>K+}YHjRyrpPqn z)T4!bhpKOa#5Ot4W`Mit{#^0tViPLXM4ky<==j8NK(m)Gb$)Y2!3cQy-=4F-{9MC) z!$alrYS$pa9#TmXFVBiYCqRVcVD6z2ALA0@q~gGql-lUiQQayv-t5kym=Pa={I-v^z_;|{`J1N zxR1sDzz1SbSoL~&z*LNj{NIN!nmW#py5JfG}UYmE-*v6~PT| zFNUGQ`&V>{{;p8GJCGd_qyfRMS2M*QCOKr8i)CB;*QkeDJe7rt)4;x{a3**^#9}&_ z^_WH}oCP|a`13U}zHQ;lY7@xq(2#chH?)~ubfAbV^Gy-oIhj1{{x>*7oo#*^7v(*F@`$@n-v@bGFSGgu% zU>dXT7R5BytfI*lu(PdV-*C@ZFcNiK$`^eF!vxQuK8Gwj86zDNpAtEG4;(%OkzNrB zKg~QI<~K|nSz16}bfuDrW194LXHT-6=$D6gt;>AuW$#hcNd<9ZzFrkCtRY`l4yaT# z8G~Dl-R__3|KPDZj3j)d+M|9G<5a6Ng8y$$3AX zy|}A;btG}|m6H`t{~h(3^X>)jis!xaY(~J>#j_a>x$ox|vlCnoHm9-+0{68S8kY6ajDXm)jTjeEgsgYIN zTvX#}tweDW=A@APS9H0!c<>6Ix5Q#Cv-#DMi>6KcLY=FhXZ0lo%-H`qIZb)`+F+@x z*5b`1xp9`lT@M>qi1E8Pu8UWL5;rpcM!X5po?dv9>f+(e6@OLv#y&a#kHNp-FYkYRF!bPavAEE(b&k-ohmBnqm}+&CkHQ$ zz0RDr(Zv(&uhBW{RXKVEm7w9xwdid$r*$W>L4)_#xQ>%OO11u7GL0Kf#aUHdlC?U9 zi8|#S{GGw-VDr09RaA&fqrY4^fhz@ZV0ZCUpb*QYon-ju{v%}o9e)hcAw zCFZpcH848j7j@e8)%LHjTO|raUYq4)*qtf;%YW@2KdRau0&za+L2Ogz#k-0Pe*S8T zPKhqIfmRr;i2jtkvvQb++jPqLx4XFV$<27@lQ(XRHlaoH`bRQFo1aN*K5M6j5q_U( zILY5u%W*aFJ|7Hw)!FSmYb7WfVbnaw#A@spip@R6{de- zM;C^UUnH%Ej7{V9G6VV#t8qMKzHpUnUA(Op?JIUrfy>D?8qxFg(uDT2ZcYruu zC3O^$Xd2j*v&pTTU|ep29D&IgQh;M)kFZ^AMHJHMgJ`!SIS{OFge*+fE;{9f5dTs% zbem;+!OAX!sCrnahqFo1JHRS~Dy-k7J0t={_>%^Fa~NfL?p?z!Clf6wV&@*Ze4jk3 zg@;l15Y3o^diLW$e{(4gXfogg zihj7m{sUq{-qg7lAL#^>Dfd|2{T-Md)Pa7q)&;mh$30tg8GE^7zvq8hyV*23DI3HZ zu&C^-x|^RSEA0YxkoC*#IEt5AjGeqL2A^@zFiB4^9pUBg`6W>Br!boEm(NNZq&i>Y zjfB@`1{d)v{{6O`ewbU_Bip@==#m`d zB1tS^7!u(=uAs=OItL6lg>sdrZVOk-Mlui2;g9#376Y#7(GO73XWK)zN<2kMV(n7J zv{tm7wJ}$6GKCaNHY{q_2RazC5uEE&Osq%N$!1MDgFx8Y(xL;Rz#*0mJG_EuWfHG9 zl^4qdlhbq8_h3Ct4P0AWC#r2hl)&@!P_-S{()rT9KY=5>UUe7>7s=@|bMx-wOYLcN zwbXHsvleqS_M)s%Ghf^|NEH-?&fs?aa6cd;@edWPre9iQE^pORvu31j%prw&IQ~U{ zL*l>6Lqt$CDXkJloc5=ZQXrTEF#%C$FTJwgC44Q1L5%f$Hs{86W$U|;z0E<=BnBEP z5kbu_l*mjyCu*g_)tJvW0l__=Rxy(}HkSW#)G&U?633zFzhGmdDHGNdCm`WhqzL&> zfq7=4^V$5FlaXOSdn`BH3zh6|i5mFSL?qM5fel!|FumH~ zGqK%pqP{|8gn~L390?IFNI2_}SQ@FfFf)15S$KJv`xaYfip(n(G@y@S!V-mz-l7}T zX;1IPV2TnoWX@K|8_MPyJE2CX`9*Ts&(rdL9ZsAD$OZtJ3!to+@2zGAB>)dn_wze; z?!ltOX*3!%Pg0PPT zvI=1TG|%~|EIu@20k8w+&(y4QRK6x&T)o;DbUF?L=CJSxY#AZPqn}_Ai0-?VGHO?F zV_6|;E>owPM}T2Ir4rZ1OzSt#o14?GP7%X`n!MpTP`SVJd_fpM&|F0tSIt-*_v}An zGPM-3cB)_YLXPg1bRs8m%Bb-`X;xJJ>K1(bYFeo}{w+7fxZJZBF7dRXr_FVx2T`$! zXk)d)3!|Y7a>|R$nOt%?x3G36i-QY&42u0%p^-3abuuA(1Sfx4MHde1*^_&Sa#XB`4NGeZEI#(DS+e19 zYLZ!gR+pg(yPQpq74s6a+fk^{jtu(1fa%UiSL)E~9WVokTTUuGAof){PGly`nG-kA z@Ye@pfvnKK%U8oB2C-e)hiS}fkOKa-MUvP0F(;n|+Rr-gchLao<#_ne%JF7Ua%vA^ z^Ho`j4aX7*n8ZfxP(!S%_vzR6*|%|?y$W(^nB0ZWui%8B!d2cm)uP5(%>Fn(uaQ)a zBJW}%&A^x_yV9Pq&U>Y&owmO0y@HPIadVmMSbZDaGYzn;!mU?`{$Wu}R2XcZDa7*yu!s$7oSAH-du@CN;C{jr0QJvLIHQlc*hO2}19 zHrt`2SJbaRKtECVzM({4TwSO+JjAa{%3DTSx4@DZCg)f}^xNj@7HX{@s%4r=cFQnF zdN1abq@cQR27jDg#LK_XczK+bpjyA_LA_la&nM)mebYD?%T%@dra~n{WQ7PS$V2Q) zt;}wfj>}E09@QJyyJ%x_Wpf2b1v04yN3NV!A_U>xsU(K|l3Y_Y0vvD!-%RM|_8Z0W zu6X6DHb_PTg<@}ss*_V(_QG!B(ZUe4N2UK}6~=cQJZ2$h7#U8ZRz8KJ2Ly-+(uaNw(Q~R%JDn?IMla44*D*?n#zO*0v##@l}NA zYpND}Ro>`I7V%or&z0ZWCXz>~Pe;dnFgbJFhppZ|kBHOAQ(pCpFxl6AN>< z%fY6SSJ^gMxFNA-x|+hR-tVe*{Qot;y1RN%yvmlfv*fzDp4VeruFaB)2CVf7&~kma z*XeSS@e-N&nY%QetzDgb@6}SKs40}oEtk_JaF>n6-Os^4c8T!L6`6mlK(Av!RE0;qIgkVgE`>( zG3~1n7aTvCxPJorGpY}&hc-pjsCUSCW?70BJmt(vM_v8(D6K!(mfIU82{iycd(D?s zdXhXFu69aA_#(Kiz|Go61|8miDXUzD7hIilth$79x9m#k(YGve@wLN0MJ?w*r=)O~ zJ_Krz-t1maOik)U@DjBW)K4_5tr>xo>OF&)pUH3vz5w3<8WDQXsCV1i-F&7 zye6HiSV_E_(X6zvC^%^oHWhOpCNiltlJu7!Dez4JSDn%R5 zC(WG#ON};#>FWA7?hb;!%qbBgO$H(<@V0bF^!~>0Nj1{!jE|# z*xpm}V(9TvB@Oj6L47CUbYXoHe4=#B?c;pm+Yb(jC{&o93e`;s%B%6wRzJO|r)7R{ zw1p}g+KRP*KsHHU^(`W1R5ieb{HsvJmE0wQ4(vibJuvz6jgDv#&8s}4bca<8tUAm| ze2ZWwldA}xku*1E1AJ(AQ4M8VVXyE;iCpQmZe}6}`tyx*N?+8N zq`dXsqL}=Hj??p+>=0YVk=>qyRnR1;2hTrC3!_~=y^#F}dwT|~gw|gY(dhmQ{|w(( z=o^3bi@UTy2r14d^@Re!@@+#KgBl{Ni5PX&qr}H7pqMU}_xIJM<}c~!RM4-!zu@>> z-BO@usQ5NfVT)P5)XBw|T~%2QlRd6fOn@cAB6OJzToPO1-i;NX)l%9F@par-o;GTb z9O00&t5EFcpel@Ncbs|do6Y5W@k$y0?VjyZbQ3qQ`4Z`}g`*zc=KRJK*Cy+5p~JL0 z)h%+6@xS9!uA+2`cMuY(t0fmKLbzp7Q7sY{#XW+8Ha|}z*h$CCKeD_RK@8SJEqcX& zVW5aDGM>`zcO>Mk1!So4VdXyhr{zoiX}-CLoj&6}SG6y<0#e`gUvpr96b)jHaFPH7 zidfP2U(&0!(~iiXoQ_epkS5+wBLjDgJlU~zqr3I3u4Gaj=%tJxH5PKjHm~}m)~iVr z4wcDzS2WbOxK4J3oBKzGBIY+aNc^@z0q~dth9QufAcqMSHLSJXMmqW=cyt6Qb4)w~ zq3USsR;sK~?@SFUGy$;UOemcdT2e3seJa8!Q{*R$ENY^mf@r9C`&0k4B^Yj-9P=%J zBILjo-#^QO|GR;DV&VKF${6{4%hoAXq+$Bw0+MU_11~2@rY;A^__}jEu6;jk3wJ?q z1P?DUBc=l&#dnMXw~zG7O;$m=BPvYYvGK>_8gNRii{)5;_5ph$879-vCgyNd{i#KQD#J5fZ` z#7+`+PpmhI9~iD1*!|`o@4N6gi6({+9x@rbS8*h29omYiO+u6j1chjI%IEb@YH38jY2heNwi-e(F0r7R?40oT!AKK{7#qQqFsDY zVz|Nwk&5r_?yt&VHlUv}&ZqTCw=iQzvpaQ5sz__Pa9{y|o0VaE)z*oEsn7FQu5DF? z-Ba_@=G;@T4*p~VXq8$jYClDIHILjb5lzZS zsBqP{Uq3w_)zt#%hzGU4_Cul?fxGoKT|Aaj<*{9RQl=mT8DN&^&6{NV$vUYLIqQu{ zOCh}!u;Fs_=!;?cVr$SfjZ_aYi7y#4Rp8TrL3kY}JnHH3x=GTeUd#;Qz;)H~Z~T!g z$mpB2UQ$HIwT;}rH>W1{$|<_orp4ca)d#0{h^5;|&VRVvGddI;^kp30w^)S6$b zp2^q{tlWT1h(<~hSo5q8+tKX=qnM+Bx5qrJZ*xRUBsVpXk-qpCBhbx6K~Kw;xQF^N zv`H%d+|rbxX`*y}^FYNV8;`4SHxYM)le#a7YGD$zSW?S`YTxm8&=gr5C zYBhcX`3tuc3$YbSCtNcf4$6W0%mr~XzhccTDH*seiDZ7Hz^nb?6vRiHH}j927Bd&XoO{M=D!d+?>s;?lMR(EWEF98Q2TX=?ZyxeGD4q{zR8$^tO8xW zt-)fjjs2iWp&OfQGrRsMim~Y7lXu+mYRN>|!2Efyt=qIi=%*~;p?y23PJ z9iZN zO8pO&esQZ~))f0iUxt?v!fQ^PnNvVgylxQ7Z;nRE9INnk{AiW>&(B~FstXcBhOw!t zOesDTO;m+bPRD2QNwSmPNy4c4L6B)JHBsmpAdGzZNYweT2`8{|i{kil^I2pDd_txM zq$^sXWXskQkH5#<_9yeX@43cJqGId8m$$juXY8Kf+X|da_}ydmDs1WkSoPq_3L9kq z3t4zM6!cjH%8NK#UC8K779|kUjnm$Yiq?6EUqkhN;cD{-xPG}uY*-H>8sEm^Q`TQ? zZv)SiuL{Q}zWAL)eaxRfFGAy0Py^gxw}~yAPq_!-7L`|T86D1^$sJ`MUe2co z4Thv3)dB5KgSTR6ZwUPq!8tulZWgPa;PBOa5IP3}`?$uIYRGxb+VC?qkDj_^=r*`_ z1f1^exxGe-%9hPVu@+ue z%_AJp#zV+(G@O+Yu9R$jO_7HOc+qPh_!EKMRKQ~0j)&+N$%X8neBEY7-af&>@ff#< zaEkZnwbTQiyotoFS(8c5TI0F~HoKX77vlrBcz$GFV*a@nG%ATWI0z~i2eFi$@+>xZ zMCwkDI$Z&dmMU)-l!DHG?aE2fv4@FOFL-d1!oqfQ}53uB+u8{kZoo z-oi89pG@~`rnADur08>uSNk=oEKu1e=lJDZ#W!RyN@QaQp@0avaSr-a48v`(kkhjq zWsl7M*!m49Ssstht`j~mW{*w?e_+*>AEmOOT7w#>Orp{eN*3xG%R@2W_7R8h0z*GH zaP7-um`vIR6k!9dW30FZsvXqqV2&b=^@HRCr#w}fmJs>}E=J8vc*LX7z0?@az4(g6 z9j5m|1za(FY{`f;^jfL6cIo1|P)C-$s4g}p=bf(oNX|bByGcK7jgYGE6qutZpFAr! zDR&I&QtOF1w^M|FQsKP_8Q@sjcm-z#Nr&6MbB6WuWe@fOBjpGt#STvH%u4nMJv+(} zFk$HOry0{bjY&>?k(bffDR~wlBFr6Xg78wb4CO57xJNKy3MMN7rdS=QzI0UT;0Hnh z21b;;5UwtR2Sb?CRXXo8!&=2Gi`lZQ9z;mbwnm;63IQ#+dB>k_k+`dZ`c9A2Jz2ZJ zDj#JTd{;F`lR{-asz~j#gdTJ&yom?;k^{VMJ~VS(&)fQ|Qv9!tXKg{1|GtZJ+8Ra> zqiy_yf1N&=*u68+Ad}K5QpP}`sx&aSpqeC0qyaUYeLlBJe3sk&Qj#aE55LWq|D;Ch z@$@j4p=2Y3oQybY*1b@41)LeE0bYa92-1Orypej+oI0Uo&~cd@2dNQOj|-a_OPasY z)gzfbu&#_LJ52XsP~GSnW5Ne}amyrAo}XD_glo-RNmG0!->df>(y|MKnE^5=Gc*}5 zgfqx0gsGT1-RCoK#EIJSUH3aVQ{Gu_+c_P~-Us@V1NXjhP?*had*P-n8g zS4;|V4*!=O*U)%{zH0kS#8OyfpKFOBS_X#=n=C8vVLcqg;vRZWYkX*I-i9Htp$4{+ zDOb)qO)EL%;#LDrNSuJ5%vf3xk@I6IH11#due4*n-cmsjU9`w`rZypk&8mpfqT2{# zCQ0?aTS#J~o?O1G*PkQKQIrq%@dcdQHb$_M{41UIY>I}a%32@3syu##0H(R^SVo=& zUj?e3H@pAu6W034$}dV)*)vocydSANe9vSi@xg&5ngKl3jUhU0neNMDclzZaCurk3 z>C6$#s_P?Ko(631z6J=2zjV)Ttx~L?jopyXsrJY=G!?jNx_qAZ-1!fZyW*`0YYQ~M8Xm+#lrDTL@x#*sD zdc{OBW+f!Ltx!yO3x+v(EBg%4(#=vwTZ4^3IR%E;G2n83bjWL1R$Y-#%f4^$;H=@P z$M>n=0Z|4&@`H5?-!i{{ozraHh=S?C&blG{h_%5)HwA-O=%9!$h^{Ci+7#JBpiCsbpxDanzqzg#-}8w6D4;RN63hIxHN;Jv(%=@pm#kaD-7YU-cN2FlE3$OmeE{f42RD~|xH=oiBA#O_tj5%vf;vpzJPT<9 ze&E^^T0R-tptPb4hzKgY32(%1NaE(kBxjZ3H%xEvdo4iZI@R2isySVZ9>lT1P?V)W zrDIb}Y?-9fpZo~Ea3INFZrJ7jYB(4J_P(?&Acm0w4b@|xWeJtfRD+m@8S^5a&BGfZ zea2>Q*ouXyW7>=j$~DGJ6l1UC5?~b#$}D30WYWb_Lde6h2N3|{?dUF_fH($ z?4v?3yPZaC%7IWQ2{`_qwN7S4M0nn__|uPUQ*XjNJRdqU@#N7t zRi=?+;86ga6KW*2Ff{U9>z=M|swLM;9YR<9T_Lo$(~E>pOC`F7aQM~staCh=E-U(X z#%iB^zksRbv@13-ygXPCeqKzfVdh#Wr7waEuHCS<8;}|o4mbeWJ!5Jwd*)N_Eb;By zDB;f~^AKTpd7%Kp7xwx3yPiFlY8-iHDU2i16O{Rxl{qe6Vvt{u|1cD(eTU zU%)xobQZ@J0ug&1&Vng)<(X{j@G193N>^^bXYPsSA+grC3&lFtMo+2Gxu~Jge zoH*%pwwga^KaZl>0D%*!q-)5N$F)E)ZbTv(UGb**H2FDnI7v$;Qf7YXV5f$_0x~tf z1RiH|f6k>LsPUL8Fhl-lh?y&L@cbm)?n!+l2;y<;zEj`&SiN16Hm-P^YHQAD9$*Ld zf2H?CzWV$v9$P|VJtXJ*b0q}CkBr+E;>Taof-+gIa&^Yd6Pu^{*BCVe0L{B*&EExJ zFqX#ViM4)jn}@BQf6s*aC*X>arGNQMZ9zlv%+5`{aG8lZc7_b#EO3VS7*@W0IBBnV zxUP%6_TS)cb-eR0s+&-j3hVi?`o z6$8+s_vbj@99b@yn7FJ%gZ@$%vpfKyU}7nO`gDK1!%@%CBlNmcl^viK0#b{>%c2+H z(RkgF$TrH+Yn%A&L#EEke%ewPE1ZL~b~X)5O@dmLJw`M$eEZ1I*rJW;MnB^bie_8r zvsmp{J#x08*>c|A=&OBVS-j_|{<*M7Ij61i%{jgYw?s&3>_3CJbAXt&Hkx#eaqv8N zXKN%klIT+gA=kP48(mitDj5B`IN)?LG#~RKs0l)orov=I8m1y@GYagVrOoi z%FhsPKO!@JIl-Ii?B{Clj8fx&YA6oDbsehf{Q{uL=}=^TSJyKuiGDdh$jKU^(WsyM zbG#fl-PAGL{;pxpcV6{_*IxaVt<&RE3FdGPv#`l;c%`F^+7 znZGRR8(MX07}nvOI7aqZaNNsqnb;a;db$oAOgLoxsP#ztF-1Dt>bo$K2aAjfX*L92 zB_BOl?$3C?JUs3bC-%7l33B*m(5k%w?v>i=6cIy5*y1xu$6p)_zj+*@zL;}wQdCUG zJQ=eELX+-8lN03Rk9x26znxD|?~hE{2sr8>&AcBFUVDd0rR!JH+^V8f&sM_jmtm=V>4(WLleqdP#yJ{{ z;pZr@XSOWKo1?2NVJXrLCCB-VK~xGWE&3mt&N?W{?|uJE*Mc-GA>Fks9n#IxAl)pj zQqm2JNH;8vG)RaNigZXf5|V<1ARrAAzvun=&3A@jaQ|Q!pYxn^pZmV9*M*>GL4D}LJ`TX;^Q7~de zybS%U96BWTt|VvX#mo-TxNy-bT{a7B^qXl`>R)5R*BR>XQ5)O?i0HalbnlA-L@`Pl zZ*=ux-Y*MhGM^Fnq*bQ9J?x_3*Tm}NlP0lN>{vKayN?X%b?*|hIPAA&oBA!C!=G_9 zDtc#F&JI{kLTY4g|M40dH;8(dGPnR@2-m5#SUXK zynaj+_|)-W{Cysa6h_h*#RhdT#HAbI6Z>{|zt#sE7?fSp7uIpqnNxbo9EAKu;xD9y>F2v~`_k$NGPo`n#O`eYzn_)W}6pTGc{7Vn!iU1(G4AIv|EKRF&3?=EPa7?fj{ zwCiNBsJ3bDkcAVcqtsv1mc=u+2)#`>J~Puqosr_BU|jqxpwTGaJYk)`@%acy21Fvj zzP3ZoAy~$V&#jf37_;Sy5epyV-lvp13S^0Y(mTPfubl~BCAv6AO3 z`?O`aMB-!OT4k#)UL$EtX^adpalV4>7lNyc^UJ%-a!~Wh)5g1QX0sBXzazpA_SIC8 zV#QMumpZ*jK9*A{>59?7+p_*_J za(v1h%WaChY`~oG@C49K5u-fV3@TTrO-sV(HUL?=#x6^NwB(CUoQKmBTkrC-R1nQ! zX8RRH5||8Dj$Z+1;&Vv`k@WyKsecN}utWS*rn7i{i5VuA2m$}+`CoLaXO9m3eoR&g z2XI5uj*lEv3w(FY>|a+09XJL73(HR+=nVMY^kd&Jp@7mCak zsoY5Yij!O=T$|}Zf4blws{W96Yd_G+-+WAN0F2o(@blUE=iDRu-C1-$X@y_*zT!}RgM%sd z54KU*uMEAK@}+;F*bL(&K9i=(noCk+Oi2^C}jQiKM6PJEy)aMXr zL-7jKy}#ubN>^#~eEhUbYC0ISIYc^@u%O}Vj|g~8fDeWyy7|aR3vW)fnFt}L0DniY z^|yL+2gp0pL3zDy9Od#55~-cyj}2$4*#f%@ngppXJ3cwUsnr%_UPeuC;dL6{G?_2D zez0;c-Ie{@G!)XRryA*)aiV<1psu5l-ElZxepFX*$T`~NmN-AToCmCdf2)@lhZE_8 zulM~vCVs!YH(zRBps9^Ct9O#H-Z8T`Ds{W6KXgzH7uQ$`de-h;_hF=)4YvaA{cw}J z+`D1^U#jV+K3!fjN0t%vQ8+!qUzQ9RN~JKG5@ed~v+&V`@syoLs_IIi)TKW1&0Jd8 zL+pe*zh+kM+LJ?XhAR!;-eeaAOJ2OXt|VRT9gY?PVMakq`i$S-5KIu|(aOgle!X(O zPUn^`r$OR1A4PD>UMb1Ijx&DT(}D0^5Yh_*3{R-h(fyzoftDHR1hzc!ij5R_`(&B` zIXsEXo%1&%sg7(ZCS~ce@G4k)kZdRGIeUJOdH@5U28=WgcT|c)3nr1na3I4(sSkH7 z@8{3;tj;`lzO!@BV8KJeQ5*8<7|e=UD4Q$<%4*?crXsrG;MGo%G1a5%M0d0VA~=3G zufK8H-nzOf=HiZ{Ks=d|!RII8>Wl zoluopnyx!sl|DNve#>A-dX0`*+Rtxn{^sARD3_(zjKsS;2vUKE7=MHQ(9>QF^qbnn8^VQ`}qJ9?M?Lntyo*m7hJfnq* zLK5)V#g3(kVF2K*wEg*G(CyJg!%E8PMBx@}JKNKCs|^4%{q{KGlE4W_H*R71!&YkZNYm5w?mKbs=9Y$iq2-ENqYSFr5y%Irvr#UOI$ zwjsZX#JXbkKtT3un9H&YA{fPr@jinsHG+{vd@z2dOy={-vIHywtFM}^M2IOF{@eS? zwdKsTrhaA&u%(`0eM7KP#r&EAt2>nWFk(0Eg!)Mc<2jaO*A-mgw-`c+2I4*fNXhpm zvX$UjHr)!3!Qx?mzxXIk8Cv@xgJG_|`td8D>a;pU2(C>6iIKQ51-6UcKZBnR?cAfi z?_&0K-mos-+>XKd-+V6jV|H4j)+^APtx@Qnj25LB?;D-b5{m?=@)#9m~_=%ixD}>eF9Gu z=$FkFD%@5ih?Go*QHCL0UBLnSv+-#(FY5}0M%wzxYOqdhf;Q9ZqaCMIpkRO1dG>tk z=+B$+$4<|yuJ;bKtA6#*3?8zNq!wC^L)SufmoM5|+m9_qu}?2oC;ggASJ4pIySPfM zu4AFCA$1=Dd1Qk#ilASnB}p-Xb>h|GxqG>BH~kPOHR^>wmiYZQuq1igKhAYziadYy z$+yRC?k;dkTU74FMDD2iktl~3!QbK2ZJ0!)&>sKQ6i~$*Pe${Y`i2Gk(a55|O#bnQ zSLc3|aOpN<>|&8r_{=mbEG?AX2^So|8esv|(N3asWpWePONb8dDhrYSpkC`(Ch={2 zK0)P^$G@MG-JfC&1s>Em-k$8NhnzE?A$IZ&Vo<>`Z@0S!XS*uVa)E|ut|4yL?ZWK+ z&glmAp(%aIb_mFSv^9gE@q=)xiNVDY(VNoJUpTuJ;1FGE z9E*G+mX3uAuaR$nkZi4;r*741FXZKbLIpf9@~wIlyMZ`mDx!CZtz%G5s8H0TWAa6# zfQzbx!H#V5WY?^3vSpsAXXiif4UF)OuRC#|NI8=Jh(@FG%2yGYpBCMgy1$@Qe&@Oj z%e;vm5B&<2{&M+3d?_1+dG$5LNf_g%Rme}g6T<1|w&5RvB!04o}*U5aV0 zH=n7(z^g)@(`46Zc=oCEcYEuMzlG3D-WFl1>IfHb8~0&6#WRiJ?J6_?zzDq|3Y2-| zVCD&L5~~#dwcCNkY`0&tJ8DXcooFUD74!@PH#$;im_1@8?)DTM?Q>1cef={c-YFu9 zzhfCqsVI>r4mu>7F5Hw@qxgBsM&pnnd5E=;z^P;fy4F{X7tJ$fWxARl8YQ$&wj4QY zao8yn+j*g=^{)*d3NLF*99`7J`;46z zK8+i&SxReNEJDi@wIx)UM88MLR00mf&t|$g^1Vbl^9C*Dp+B$h{P;ERg~jBN&-&+z zL#Tq)mtzaEof+yAJIuB!^{WCmsijn5;J6z>!7wah+}mk1yPYu$_U=-r$bNZ845md9 zV0^`{(F81NZQZdX8|cg|nmxiBBCv|OBrb{D(x=F4;CFutGQMp8^T#nXcz@{WXlv+qTMFb}<{rn6>fG8i>#s zGeq7O27a)?9QS~~We2np#~~MjIN2jZu*F?d_l4HeKA8?WA?;Vzk&ls}p@Ue&kMY56ySI{FR{}-YAI}fh zAgRjc&<8al7mB-D&S+&Ita*uTiRzswvQRHcK5N=N+&Tj|?a6Gbl%8uw<{^knNR?`pd@Vk4FQk+joaQFdw6(y0f`3m2%`r;yEi;71I9#l>F_h zc|*X!FYJ09SHdJiyUXlGyT^#-5hEJ-;9x9Xsym-8#UY(cyo8mUu2qZfSW6qXEH7l` zx?B3!HZZxf!FU@UNfq*yx@{6E-3}4AAKAONXEVWGlf^VDSH9}jF)r~`u0!u;JV(zF z^O3|Hr=vS0@LgK|!rBRFn33Kd(%Mfj8Zszd+uKTF*XuBK$LGygL`qNWs=$A&bNh zn>6wE>zwl+N7|;(-%T=uOPhHT?bd*!f{HXeUXjmX_aX`Nwu%58y}B1X`{!u5d9bD? zdLqScM^);Z*bgbYz2NU_!G2E4cl6_|oZt+I@a+_M_im|-@{Yj}>ooq%&N;>L1PC#X zYqSry5%1iFLq5OWh)JUCwZpbTLHtt<%D=+Wr4J&;96cD|Z$G7wA? zJi%VV%PtjD5)8S7ropnTcf-XDQS7s~KA)x*65@-wcJ4*;1xk{K;Qrjb`?A)rlhv zG7_^9uvp#V9o&-%`FChL8pG5m$q%LTYfIS`!q6O(d1dQAX<}xr>|T~Z)~eJ;Fp`#y zD!-i~kR7Hl==;m&4EyoFj!IFw#zcnv+ddACKjhgYfXGv5kwC@MVz4%aK0Xx=^qF(r zdFk|Vm^BhJg5R-yAt~PwO6P~xV2XFWLWoF;p9BQ4d zI8Da{Z{C20lvh7Fc*ko*XWg5Lsp@KhL65zGtyu$dv+z&?=nE|+SIVA(7zm-paETE| z$C9FHFz57f{xIw=4KoR^GE3N`J9}=7gf1o95O*&D>;rlpCUS>b@BHLL-T6|FRl)n5 zEiud}{Y@&z?YPh=9WY>MQi)*4_@Nvr+d)NoD`_xD7-_LPrw=h9voIq6u};UdD;OHQ zD*$n3-_F(In-YbTus#WTfD0uQOhg zDVpGb!)f{7Fc%|ruZKVGPdJVF-hC!-62PoNCvnW%|Iw`g`SrdsgRntTKl)HmF?C!3 z!?v9}k+w{1-kC${w}FA6E6*WH{Yf*ND7|}|aV$`R@&OgW7KWmeo1VcYYDou_rC8y^N>qCEjUqT)%P#?J|HD>7-^RJ>NZbPbgSD3X1ik$@u&YH$`l zfGL!4R?BbP>J{iMpmR1T!LH4BW9&MS;c`_E=u&vH%h5)O@k{N(?bjX#3s16JyFM(0 z?9%82fSO8j@Vy9Xu{1{i9KEd(&s736NnrGev`hUePfnapU>GyR07ti3;_QOE-G{dO zl><-L!0ejj^O6b49}BkZZd( zTHj?~GCW(FTZM08rf119V4t6l0k>X$=?Aa5Ol~+4Iu*Nz17`cR@&ZWkweNMPtGZ{J zcuY`sxc#7bld!0iN)O%PBH{^BVl>y$^J1Y5aoiJ`ZOlj8`HEQdYZTY9^2Puw zM^25)^EG2`DcHN7$nZ8np{P72Ntj>;FLRdH;pa>oP=cQ$mAzwWEf>b;Let~DooB?7tw zqvncJPqxeGg{K_wNgxpKi7FabF8gnoN->~qE!8Z{@oOA$6rKRFFh&NWoNZT-NLBo!G70_n9g> zmUoz@*m=Mq-Xjbg;<+kQD7mand*NV|Yi>d*E1J{hU8;&IUrsz`p%<1&%#O296Q1k^ z#|zufIT5_0R#{4X0-E{p*)@THf2_I%^^&hKc4h?Bv*#xcjguUp7Lpz5zhRI5^t}67 zC~!ysNel9Kw{B@^KrSBRt|T*HuIMVOmas<#;}B=Te8GEQ)vRt$?prJ;^$$52GD3r? zY>R>lPJ?PZXJOWD@2{J0o|u5BBcgb#^P7a|I?=M_O$F`KjRjLSH0IKZ^Ud|3IKe1# z96i>3mxkWYNOrQL!K@Frq=ls2jNj~}bEcwQ&{NJPl=ZoB?-i*d?x_li{FdQ|DMe^i4poxCTduykMallM_zyh%Hu!W9NmAx? z_S@I|o)G4!bQs1y!T7ZqfN=v<=Ito5!Yj$V4Olh}Un*keOuYDMzMIkq!|-$F8}S4PrxerW%ISlYi}kXTj) zg`>?kSRLE#1{p_FfQEvx^#&KR4cy$VsQpg9dU0cvk@&2Zm2P#&AnE&~@lb}Ix2WGC zXLH#3pF-a9hV^|zUW%uA)>MnTw?~KZ0QoaKj7kCvEG^C$Tm#?2%l+Gm6M{rpU}1#f0zqK(0954}RGUviRYd{;c+U5)X8=)Q z4r~*>qA4GScpEy9>RAD&v5Ffg6V-nA*X-BX=*?J%Oj`o2+RLl@^W-zl0wzDsJb2tt z%C2%{G`cGAUvffaWclO%2k_FKIqsIL48g& zK0fSFgt){39MU5Q6q!$dFn)wLEEG7DAU_%sJ8aWgf%9{lwC{&VO%iC+XZ^sg;81kc z9p0ho*^%h@5A<@WlX@b>Oue|yL_fQU9a%G8v-%EC{mRoboYL=>(GSNEf2&@*K^ZZS zfps{Q;82Lqj^);Er;x%Zj*BShObBe!c(oD?)4xN)A<~Ue7&3BdBxq(@np3{|Ybhk; zv~6z*nl|^TacoEVj1qX<(^v5gHz-fl?0e zhK|f$JRuThs-iBO!|(sgZ$%uyAr%RPr=ebc^0ggFp)vhb8q9<(W=n-V>6dqt2L*DZ z#&rQn&mMge8WLc&y~XxT5XAsYFs495ZlQ@cik&3^`;ov_5aYsWZJ*V_ZM`5NcmS`) z4uJguoibDjIrVC@;p1G|nf1m1qd(u9yx(2+TvU$kN$@>GIgkd2o0_S0R7dPnB0StLCk)d`MA+$f(vgiBI7xBE*$r*DMjHs zjvP(b1Qd;3G8+*|Rp499@EqRJ!3l25!HmCu3Na`_m`S*e`*}x)T-Y~CDmKUa9h&MX zhqmQ-12#K-;L_6gPqV4QW3I0kerpeIqI``-W&5R9l}-J5@+0&s5*o_83V4&PkT!$y zz41fs@nlyU;{o>m#*yq_1(92+q@4+vf9*C#4XwLbpA=dE6+(YD-o2zLJ0ov38&s?6 z9p@{XXFrExlS(+UaDxi&Ub;{4b0PU+6Y8_GJ^+fSnSrQM4ybj;IaN4zMS@v1rB%Wf zEHqc0m-a3w^Ge20o3cHN0avh;go^PCG2OG z2#Avl0AZ7wpyX74HJj7O-jt8cNUULPXH8cVyLNQzaek9>cA8=5qCY805WoPYMo_U# zPLx8TxG>~*cn_TxY;Zb~?W$JpM=KRy3_`^Lg@=Ncd|b&~n&6;G*V`z1u9*l1;_^}2 zqYx3pUBn4=(o<0@szemmyUB1BwySNIA zv?B=x_ND?Kr#{Y>`6Z9Lh49X&HYOta4qmM8`ol<`zbPT1z)ruURWRbY$^JXlNr|04 zDTii&{b>M6{_L+`WGi9MpAWp=L$v8MCs`-xH}L>*Dj!CAPA>20c8~@ebq9#DL}K#q zdW-_m()EXNb2r)951-Y6bK*;dUcP-=PB2<)9>LC%lpqrd)XATgUp|ea`M4@g4)l;r z0~gW^?1#8mI26R9Yr5k%zoy~BZpxK0D!`FYnhXtLpp3edvt5x0oUi$ItE2Y{y=kjH zC(#v6T*VLiRsb0G1$uiZ0#9C-@9SGwIx|dz4WMSGK&HUqxZ3zwu|jC2f0^^C&;$cr z(;4rSbrxb_eQVu9T;wr=pS>n%Ylbnb{5kW{JSly$ww2jO<a9^d8_9dwDcEZ-h4`%Ur(Z%4;lhdi6BE9FB=jbIm2e+tyXGBVmu7X<9sK0x$5UziUQ$m!?c~GZvHx=dpiw__e-N~?J*bVAvT%DzC2n-V| zRWCKbOis)}6aQ3R7aDoo__{nmlGfgNPRaARG?1PnMs!a(C|xRH-Nu&}A)QVp3x17h zZLeyMe?fg>mi=0)?x9X6~&iWXD8B+@CcHGyv1^_CQ_%b^kJmLuz?k6de$`M%uIX#iPBD zPsay|^{P5B-m!&9mNEa!)%o_)nVHRoa3aJ}-!#A>+_69PuUk%Al=^PhNjGb${07-) zU21uuVBv3Lf;5YQbMMefQ*lnHM2>xQ0G-Jvr<9GN{Q@nPqXbdVP2MAKI{N=a+~gDC z;shzW|IOm?$0v;Ov>adJ*-iR=Z3sR-Q~iED9sp3$ileRP^d;#O$v)_P;$)r{r;1ts zg1e?$H&sRj9hUQWJT=q2j(?!Lb}K%1nIVJUc0*OnP>FduEn>;Q7ym2i+wT+E%w&U3ZuKFplVNqO{E-X(?r9S7hC^Wy0tO~|ftn%{NIVm;kyKInpBT5HVCfYf z@_2=Js*qsNg?+};8g~MznfYmoc#~hAO<%}Q)tC~X_9fJ}R|Gk7?f4~CQ@YA28KCCw z;u0gqg;*AhVvH#4Be*2LML{V@1Y2G%p-_KLDifG*Ao2zQCmPRQ)=|g~nbrF_9i%K#@NR#tk@OCkLlYoPu;S{-T!?yJ+hn*DA!EPni<)iQnzmgr=qRuR&i1GL3uFq zafQ`MAmAAvp&ITW^!9MN;k2Y!4VpNB41&tT@Err%VA{SuA3MCOr@yQ|1FqhCC@~u9PmgtSOMSKn5c$9zM+@5u9`5Ln{HOo~8)*Bd{sQzwo!?Df z)U7Y1I}D3+v5dO&{>n~`_b4n9aeH6p0Qm-Rz!yPP&x@`B9peQ)OEFZ~^T~DP+i0p6 zZsYy@(NwP3{m(pidgFa#hqp|j2&<}Wr$d{auB1CxiXPoAe~PYR%6sP5jDun0^_NfR z%t^wvzd-W0px0OL+krP^v4KMK62#IU~pCn_Rb zw&zc%M%XKRLq&MsdiKzOmu(v4O{PGoU4sn&Di;S_nptwkCY-k9gfw{iBv|Az7`f(e z@p(b@Z%VNdTOszf13=?MQt9XWC69f|Aw$)%;p5HG1b%a*y%K7AiH+XkbW2n2sf8zDOJp}1n=}_;RzM^0OK^=dow``;CaEMQNV;~34a)4LL$ z99emG@h|6^?)Vdx%$~tPq{9;#8$rY2G(r&JJy}>~(6a2yboGc91FD@9zN%MlT)>F?> z26~Jl3!Oh68A7kfzwQ*>#Sc#W>tb)LKyN?`UtM_z#~WD&0ZpYAJGqT=` zi@QP`Rx0{RTxHPRvtd1Y)clrT)-6?JR{?jsSmm>V46E|t>8IWmWXe>_hFLHCDRyto zFna8XnqIjOAX>WJ-&NM){Vfv=GDHZrjjv?cSGe7KNytidlCP;fSB|GyqfH^96bTnt zi{lPHC5vU0B_}!AqKV|nbM66PU!2^l$2~m{z_q=Zf(|GYv{0}$V*tar@zasm3A6tM zv!TRR10~T;?|s5%@?iQRM8bdKQ54)X9LoX}iz~-1K({8}a{0I=(^Mr_Aqjqh*Aht# z{!NaxC;k&7?cEO1tXu?IacZKPFj}c6t?CPCEm>jH4Sp_AdA`?ZwQK!;9Ipx-IC`Ph zO?NFp#v@+$JL^WG&-*h-cJrV7lnmTq_=e`(yXz%$lud|(4z8Ty#vVDUGof*{6 zD4QTjoo=8~ELTNeJw&X)^JT;L%mzC9uFF0!dnOe&52u;U8LZg6_KKz&tDTdkE|ZxS zkKTqNs0Y?IvA1cK3$sB#%Hb(%dcb9|UifzJ2C3_fI}b-S=FJvPWG*u`LEbOzS2>H53v2 z$4dY6NoL-yN!tfakKvuuzqVnC)?ZDtkY}n~@`InDWto5Jgzw&E@x;l4j4J&~6l{m? z5;szKu^Sz2=D6?aCg&f}21T%DMt~0Y3z?;)FVHy&bGJWLOfMT}eF=rroBoLTk2fD* zVmN#RPKJ5gB`~20_N#m5A~`uqDEXi5zGAr-a&ivDw_fC+1ja?(e9Ckr(}ro}owwj+ z{_M!L)Q)=waT(5J5UD$Uyl`1&*Q?H^PEKUK#eT`DA`?bpm5j;$%StxIIFhf-tx#*- zFFihUzW4Ji^0NlHkVdmUmgTIc$c*8Cka7%7&)zIBOgx#f}VPv%PA}Uh?3964d#|Y1ObKXUX#oZNFB#w@S(V>1-mjZ zEXteIE_5-){g@YV!{VmFR{G;8Ty1EX$AK;q&a_(|)b_>-7TUy1791s?g+LE4`@4RU zJAd*9Bxl|HZqkFSMTSE69Aoai9`G044~S&(H|{!2@>YNYA<3W4z?|57F;@q$HthCa z3gLZuYCG(&(8P$A9J;cdK0x*vh%-w$qRFwbqRGJu$qDpB#dglx_qd@d+~_LN&rcij zVb)JS?c_gKX&{ED!*Y_d(Ub%d-n|=Q{TKk$o?~O;w8_XuqQrpHbB6?$c zJ*MvEg$@zsx4mNV_VbPWpzJn0a~EAXhm7Zr98xoX*(TZh0vMQRezxEyMeLG(sWtGC z!+}f?Jk6&e)1^*`Fw1Az@}YLXysJbX4tWhUJ^rn>yd3zBVt-a7T%WGBGjYTfjEW=3 z5uc6T^+-}zr&A6@Z;vQQvZ8x^v`UOgMtykWCN#uj!AT5?)V9~N`2X(CeLVJNNh*s9 z;#Ab5Xy?RNKKH@A2pqqoRUlbptGRA{MCZ$X{TDf#)LQK;VO__3C9)de&V<45#m1=e zOyL#a0v+r{++C-Y-Z77o!<=l#<Hpy}R;ksrkQQ!e>wMh%Bx2zsnt?@nr3 z3ye;6d{^gsI(4r6MW4&5jh^gqvkamve){CVOutfxMII-R z*aGnw_l!YeHt52gMstH63Dm#EYz6kwY4t(CGXQMSqnsHOPb_T==qrB!rulVvu3Id3 zqUq{qPwp*)j?rSt3FSY$jvE2mkne>>lyx7@JEQBTZ$BfdE@F;MUx7v$qG4~oayAL% zk%+@^aQ;a)WQ3(r(^=18!T%evpKnKu0d@+c3qmO!&jAvm!)61t1spI!VuZAUzp?RR z`vCG+f?T|87}P2UR(J6)t@)mE0Yk|0#zHL}4UME;5Rb0(XeDY}p}$`O*3U?e9fYTk zJ{8U;_$4<|9M)@rIR!{-Q~=M5cWLwJa7FnMAE3)W+V0MnmSEQfaMuVL86$hpslroL z-5hc!JPYcLoZg72u2{5wJzj{^>#oL|?GXw0TJ|Sio3?x4Mn67GnTOv|T@PCfk4w57 z27=eWIEo(rD<1RB(wwFpa9?w;^5y3*fXO>u44&+4_T7DVy5?PJC-B_ zEp9n(IiXIp%X?ASM2~<6GJISYZO`^_O9DU2Cb(#_7#BlG7#D0obHW9-AdV~JNC1mb zb3b{ZOtq5u?2??2kX)G+xzX3`H!qeHeF$R~6_qdcU?l?ZDb&FL$ZERK#rfhGZGt zwatoThF)}LOBQ!glOayOLI?TmcRI!2f_5I&+->CFZJ`r@BqGa-`!zR^>DRTnQW}I0wW@vcdIe}NPVe2B&wJm-Z#S+DcQQ7AqtX`Dz zm3v+;-;+~yJy2vJ`=Y>PQ_LQK9frRg$l|q1aBzlk$8aQ2s6LAvXH_y?50Ob zNjwcz{$A`wzP_wQCh+AT?iw@`%?>zy&Y^36^M5>^+(lvyC|bK8PPavjQeQt`*TWW* z`%WCpXgE*4@e;aQ!eq%=2d^r4O(IJ9iV7`g!Q}+$ZSM3gczC<)G^|ya)`?xE0nxH3YLvm!QkT6fE13I+g91)Xm$7C$YV(ewhrt%fz2F6PCtO{eHb%MqCwW;#h`(%7jRIp%%6Uwi3|3={DVFB1cYxDs-b6 zqd?cpgl;sLt0DZjDwA@FC7eDx`Yc@`)!tWUw;x*@EyltDift~G3AjoA``h)2f899lr+=3?d2_k|azgT7&2#EOK>hX-gD;E~vfcUV~DxofB!Y;g**cqny zmfD8+bok-9!lt8nTS8LRHD%x&m7-jNnM?b_;PZb#H@c#{vlW<5*jcniREmOI#!T!h zDYlfOHiWZauc)c;%@~(s>amPdbyZf!h3dc!WVklBDqQ}$q!f_UWSYJ4ObVE`{}XyL zL&Yy!^RM6h$W!%JagZ}7#|9-v%cV1M!AFvS5M)$IIZaIrz9N&&i=Q+11+R`)9G#Q5 zAXNmHdANtZB!))V-u`_Gkn*2p>%~swxv1aFAHVUN(CldSP|55Y4}!^xl+;*pm74!E zL214(r{v{*viG)ufhV_@?d5TE4_`q=WS3Y8g|hpIqbe}qhDyIqa&bE#g+p>HIdZBL z!hxm1UD?;2v00X;C>m)GY_G)W+u98R&MI(}cEhBxLv(7G`n>e^zCspaB4he*{;E3* zYep(h4(#*N(YnUljn(;7`ti*}QjW}xuisY&F*7ax_^l`}*Ke>H*KC+;&qaZcD$5 z_d0E@gfqIra*Zwq9Wbk*XIK6m{Rw7e#F3ytyT1LT03U0thxv&Os{|uW37@e*b$dWX z=Cl;Hbwx^0xyyE@u3*6rs4+`jGbJ*q_fA}9Pt-fg9{p57-wH(2O+^jx+?|PMrauo# zz|Ie_6@Qh$AptgzRfGk7I3U6%$nusy_V4UY;>8Z;#y6Sl(jB%X?@#uKXnQN-s!!PA zkqaLtV{wKjp~4S1q{;PKCntK-)shJm3pvP1cuI;GYDkBnM9I0pbT|?31_FcaKIn zXu40LoAl7egHL9QGL{Sv!hn(0e^bn`yDiz;82g8?%Qb$Lrh_k6Qun6wMIy6(71bmz zw?q<8EiEM)gH;*n!Uc(`Z#>o*=qvC#ea7i?Rq9|8c?l~^sXS@`0o6awaT;o3L*yY z+KOU)_Bah;f}9v1@{$JgCT9~oMy&l6n=Nn#KIgallyoU;l~c9AiaBtfV%qzVjU{>_ zwL}UiCh?_gGoAL9+~BX0A|^Wz(X7t$UMI{BySI&x5ru%30KLziooaKn4q z`o~|{e8$#K9@!|O^DsMNR)CC|8>~gP`KjkBA2wS;tAI#z#7MYCG^TE?f2gV#$1geC zvO%PFu*5cTP83x&{O93pDxM-un95~@Ic^Uxn4m9REI=*FM@#%D?rqz=7tQb781B5` zi{HMCP9rB8cZgzv_E9Q4{XX&#hKI~(T=QMGv_Moj~3L&r&^4puL5)*HEfN7q!OI}9~Rq5~hde^VEbCr8Q zY?)s*FW6R)*Vn(Gy6zPT=VcU77!k(G$AS_0P;W5x@Zg&eC)g49&bYcCw)kNQ6^I;H z@lE{MS$P>`tXS{YgmZ(kSbAeO`*p!eU*2GoEKxUL-en$Fv7oKyBgX3?*!9g`PhVHS z)~m;V4G%hDr%qvi2U{O+za4)yCqy3s@$S4@yZ#}`7*EXHMcS>Db0}9pkGsq7$>iPe ze_DWPl9=DDCeZd(vP~{-4N~FKt$GnnALEqD?Q%rX++^R#GEB@7;xkg1Cxhi%ef}J9Zhy&WBrlzv(nTvIR!a36Xg9Z|$ihbQc ze7K=$)6jjb6prt}aJv;g0md0G!(F}@=;+1eDfEmr*EPJwPwE=VsfA{Te=O?>pKdE} zf7X`QN>}%2O7!a3?>eIuE zG(4%W4WxKfHeT(>UPYe<)Uu=;?w?S8=6N>4+9+G)jXcBfOVXDvu}(dlf7ZqgS)ObF zBA1HxtLXh9E8__9ha6x5ZVut5l7#)P1%mIdRl6Q>`ok!C7bkvwj@#gnA@H+dbY}Oj zvRRsou!$5SX#GW2_w`@-Wa6grtaZoVmJ=dRBgPU&2UB0^k2ORvMwS{!uU~)1 zxSgPQ)g)Rf4RTNKUOP+dvngi%wMFq7KP_|6Krl_`KW)Ad!|3fj>uPRnJo zDx7%GB5-UGr37wD0%$+nWd>OzVipLFg}?Cv|Usuj}u8Z|L$EDtrKNvzZk<~o;LBRgdp5prF>Uur%Z4qW`8$H z5z0G8LN4;S4>uSV^&5t{aj`@skK}&%H<9wO^i3I&5eNH7VT=w_2XaI*7>5PgKdpaH z_(l0TIrnpQKC~73Bc|=ZK6BCp$o;uEQ1H>&eS;U{?`#ta;?w*mNwphkE-E&tKvsicHEfx2Z*?DCut@=s%Z3=Ix$1qo%N4YktYYRNMnb` zQ=#i`;7)#Sd7Kx|N-aGN6Cm6~?e3-)8C%n|kF#r39Ib^BsCmfZTDc_lB4FdkJVH0| zMG1{jtQe75JY$V>104(Qiw~14IK#;Marm%4T6Xj6+tqiPKXyAkT83KP)-(BJ&YZCz zHHCGMjC)l0XkFa7xG9Q`6nuJ?1;C2DuDnK1?rzqt)~LP`%ZeYoo6Tq846#yoF)Lj| zT)*h5At{8Jo722XVioDt$p#4r;0w{xRI75|hj$@jL~m|Y(3*CvgWCAPG{VQ$b!bsD zkde1bGPxCg0cM$pcD8;EN`I$N$t;?i+)xP-bOq(kjaqCg%)6!F+-&Uy)rBFy5-j>) zaN2k2;OQyCAft1sE`dvP77Sg~?`saqcP*CmjDPP^0Bfhy#f%Usni^|Kv8oF zLvra6NjDZDRirk4FQ}yv6vVoq$`C`|sGcQ_t%dtY-a-1Ah7zygCN@OPNX&S|s*B~d zC7pNT{Tr{tv9arxiZKa^ZAF_xAZn9>WmS29SZWX$&}t9h#d)UuWEt9@zn*x$T#><# zujt{Kv@%ZWRmNzSq%K}+@#hS5|K94w8OUUnaJW3;w)E=Nf6pO?#UqB5AqH2V*4)Og z|8^4Tp@xXgmoSj96Qi4-);So*B+QmeFUTi07Q=+;+ENiei0^yeGH5-qz+7bksdh#) z`u=fG7~!$)j(slVqPDR}gKK-Kx6M3NTI_sSSHJ;WJf^jWq@F^<>`;XMbuMBlf0LZY zPY+enJgA5p%CUbAccy#jBf*sUlaC5<+|v~NOFPXpIxM*?iuCcWlJWn{r{R|vbJ5e3 z3GD~Q2ZO>qXSsDuH}fBJE*L}UDS3JjbR%3~C!SmD`?Ry_b7ue1Q(|;UK7)#gAofDv z-*WxpMQ*>z>Vp?|N$F$dRk#@3q-s6-1j5t{syHG1VB1zNcYNZxP<*rRyWGl; z)yD-BW&PqzlNJeSGY&kSQ(-l6h9^&U^PT`%N;Q_Dr6gGI^0;?7(4^6^3?FPE@ltUT0DFm-K%)*2`?+VqYDIRQlM(5DoFu2ie5b zxUvEXhgH_k_$w-{BKQgl(x&=-^&}bYe^E@C?TCHFd{K#m;vlO0^Ah=0}6HeQWswU)^cMKph==(vtu#qwh1r z!pr7zDY7k=TWqDc;+SQYRCT{G-G)E1>A%LB{{GZW5(N;syyNXk51?lByU=aSE2 zw*qo+caIPaZW7y*r3L7R3Q0b(^0iG+vB95B(cic#Tj`iFI+7w2vjfL?gg7j*0WE$K z)?xI^w8c$z{lW|GHYi{3zYX9Vzffya{HiX82k(%>I^f%Z`G~6sO$*QB8|f_$<7PdC z!V-&lVJ|TEHHzPFec{RQHhu71_>()UnHGc3j1Wd`N{xNW+;_*?Nnqv6h5zGgNXp%% zWO^H@!0|fTFzG??$}wHIl)H}c&s<&a7rqo+ga%_u69oTJP*`whUhygnt!EQjXfK&t zFA`*F+*9Ho9e_-O!MSNbufX?Sl+WS)g-uKOFgT>Yo?SGS>&gJxTxB zqTdCc?T#3HE}KQ+PkN>bi9d{^XANHMlQhD40LHLST7T{jNQYyEeuUk~Fr^I(5@eBP zNS3`Qe`uHUNHbkxT@2LytPhcl5KW%lF?|()Jqc+fwZ|F^pALg@=RjDgMi-qOowo*U z(rZkytTy`j%FXgbB{8x{jnoca0LiGe?03BDd2M5<(%~*|WX(-nq%FenGcZYv`j_-Y zpq>~tMmgEhoGfERVl<7MUF}E5MY#UaIav?fvo(q9ib1@?vRKj}_Ea;X5=UhPu0nsm zeY=`D_uTzaGBB2Pf7x@LZEZ+nvennhgXBCKcbe>--RYOro3&G>4fWpD_1<~&=i^&v zN3L?#m%3)9#UKhp4vh&)wmvidPO;!J;V`BR-Ayx_meGjPgd`j5e2%Nnn*tz0&&s;D z3B)7q+NLlH>66V=jpx*1=V_z!)ZL?PNzE+i2eQ~-8~R#=U+pW;<&x0$qns7B$o;| zm%r8gtqpif1Ja;Hb}%-m^^*-#w?ZH{xfp$T0_|NcgD-eMpDtJKODW^}2zvYDEv zxHZl&6h^pYQ#iF(sS-uXDv3kv+K(2-3L8vj>! zJ7Z)1M;tRQu8=ANy-eV+na`4nP$L-~skr;MWM^3=ZZ6nx2|Rfu@t(51Q zKI>KrkpHqjoRndz#IGKNahaN>DWa2ZwV8LJZFVWK6SG9EcQcG+#Q&)uBBR;Mf}yW$ znMNSe`7T4e5p+6Xw5-OFMZDnRmu>+?%890;L(G#2#|2A=u|ipWyLa!m4!V9!4;eJr z?sl8Uzs}(%@NrU`)2Y$(CoE%>B!UpB<(t)0;7T( z#SNyKIhbulTM?xDFFHRttg9zZi;i&Ulo>yEsC*$zYO zPnz%aYG$z2iP87!1f}X6{4mb zZFgu-T!#XLzuBn2BIRpKg28Ual^h|tW%S2(?~ocKY78#OkZ$+Qk*9R`HE-b14&l}T zDIJ4Z=X-%MX8IZiOI0>D<{n$jIUi!0Vcv;5}NgwHpz0O85JC^Fh%a zreQyP0fJTiq>JzhuaAX#;52~2xfmAz+MBlU* zhe2IL5SvCc*;q8oC#brlAhe249-1fNN#r?PLqnKpP$>cHpGz3DL7xefn|@2(^~$}w z9$Xs-L`r$S$sJ+LcgJg*;=(X_oMipXF9!>M<7fv}oHjDavC<)<_2 z=W;oSTi1i?PsDTjQExiBDeODD7P_fXNMP9A^*hiXK< zMZ!xxF(pWIS+?FTNY`M*V}xQTHvwpZV^Xq>f=%PTQMHYUs!@JTMeYu#49Oc1WNYua zC?6>}in(y;IHeuS&PnBW41*4hfiB>(rAkTw?3DCj&PY{5zNqg)<;JHh1;`Pn*l)kR zq)2~O?w^d7pZm*FbKL>}!3+QiOnFNt4`|S*0zW5Ff-dkfx;)}-!Te- z={B6-@XQdyT<|^{7ye!-!F1+#g6IVs`~vYwk04 zr~gJes2C&(dy-`L8#4E#o}kfPPT2&kuXXG#KSo+GTUhGR@M}4!L-VkhU!^LpcoWOd zg>!z$eF#vZoqmQWK$!Z5pE02)aDtnin#DAQxrKC*vd4mt-i$U-nE9GzZJ!nqq{F2E zUkRdEw&1Bb!5!1v!wM3E4J`MLLE78l*M=c+&{~E9H2N6;(ho9~J<$RkUiU61~ zIe|oEiH)KbOCN~fTEH1=Pt!^Ll$bsU!@^L}i711JU7KZuBw>;!3bJ?c0k`ABM{bZb zmIj8knh|&ml(bWNp!6N8jcjF#p@>lYwpy2}A5Sp|#PLPmD1@DSDxClRF0cRU`ukcV zyBi)IX%x$5q^!sPLAD8gBw~AMLA7^4AfEon8%ApE?q@-jWEP+?tIWjpbqJ9fbDzuC{&5 z>1HQ2iefFrc2`I=h_`l3pA=NffV9G@GZbE9XnKUinV6Z&O%Ut491TBwU!GlbRyRE# z5dCZ(X!LSq+pB~gPD}V3WjZuTkYzmF+mp-i%`~f)ckD+`&r=Q}wwO2hvhr}Txex^s z6`U#b!3!@VmHu6}1#o`AlF}q6N@#5&hxQv{Xk`3;Ibf-&9ol6u88gGK{5qprNe~WU`TixWVkwz;SmNke%Exw zW}3Rj@u`WUMrZD7#43fFxPjasZlf!4RC>kO`iNc2o#jm`Q*`VuA9VT%S%o%}tUANb z5o8S?{h4U$15NpPw-vh5c;ezN{$zgop~)&nXNQ}$4x3Nyay;CFxC~kh=v?eGZ>^o% zi~xehxXAepVYKkBF%#A4J+NwZ=4ww^;b9$LRma@Xnf#~!JYg>YlbfT$m`BA1HHGXe z<%TX&#U*2k<21)r6R(M95#R$+)7bj!OAzy^7s)=9f>GO_zGy}oSf~b)c7NhkfqnJN z8-*x)@bzO*FpJkry>B6EZ#*zkcm;W$w*MoH_Aemwi@JR?Z4!0&P=|jL2OcY3BUqUu z*?}6drCQ2Ye30_56u#|WxVoOvZFoBfB!)LLyCjfMNpeHqy=@M8o6IUW*s3Lkx=nuA zU&pln@$v!kByRoa_AEx?RICQN4#JmK~3KD36 z?1j1n?g+N&X@*XER1IZBE(L9vYtZCr_PB$dt~a(YDQL5yPCl}w@X8;*o&{CGESEEO z(m2C&Zn2YJmAuqx7%$Rl7?xNLA3i>*b`Dm?G+j4iyW+)43<&vVsffmVX=%NPwX#+; z=x@dek9OD`6OTNAaW)ylg=fW@?jUO!+m8nP?>3fN(Vy-^#RG>2nYn{C*oGFAZ6esU{L82`S8=Z8>UTLunbBfv zz|gf4liJmvj{ds%iMV!}|88#fKNRWkIO@uRWMSClQTsc1)JNl0%NvT&zdJ>}Sj_L+ zWV?jN(+vu&rANM0TJg#t%jArrJlS3ol0O$xfq;AX%rMs{SEz9k_j+picn|mhX&Q(& z>po6~b&~n_$c_fbMf#6Xsv}pzCoof-?CF4YX6xo?Mt*S4js=lV0Ciw*kTrV%o0C(aTyid z2~xm)-5e>WlMUsR5t<|_>^LbE{VAVQLYlxO1gKRl>-s41y#N?{?KWs;!oc$lv!k~LK=yF#$%_T@Q-LnjI*2T0T0nrwHqBJc=7qP5%@O|tv#B?|{^O)z~KZt$ZE>8=P zk=XF%TIoYsLKU+j8;ms?ENL6QoH2dW`tV?_M`QIWzcb`(ep%j=KIXs-nt3|3|=2f7L0gVEACt#(6Yn@FCjIv)bTKr1qYVydj zah|HJ5;PL`z(McSg6(_L!&HEq)snay^yhlcOEzVcfmCu7ur0%nYB^Ad%h>UsdI|X% zPEy}@f$*y3BggMqoH)40s(G<#>`UsoF*0Jev*>@##K|Dgfu*EZ>R`LG0~O&)uoKY1 z^Bu{{9vP55IoA2p2@5gx^Yu#70{50WAKnIuj?{GTPmfLk?W%$2F(IGYY({4!X>xKn zA4s6~>?xW$mFNf4=R8eHy<-GKr&=57;BEQ@cpE*L^VP1GV)TX)^BEMyli(Em;Y#cQ z5INu!Ps>HNxk)Lh`<&o;m?tIsCW$gI)hg2o^>!`1wMIH|;b<^Mekf4aU}T#cd?XoO zW#~ZnxGUPVhSwuEoIvCeW`pNLFv3RIf*|Qj4gLQ9BH?WyXcO3Z7TlDwEPqcUI&3}G zFpoCGw4T50su_2_=}Nf`!aD; zD~;`nJcf$i-6z^UICFr6#pKYZC0I?4@()F~kr$nXP-9jlr3@BFicqgKH_6 zElGJ+9oOkTy+Bej6hfW8lsCC6tI;MC{RV)q53BI)c$SJhbro@NoI5tcwWW<>#H)oYM8oBb4SRd=s{y4|G4lUPLZ1C znNx?`qKAaVP-AK)N+D`RQEs}P0!zzncv=QzVwEUi%{P+PxkAkGSyiEx(4f9$@+%Nk!qda{>A59GM=tMC6G#)tc)$Hy<^m-qwEdBY6 zpik7fAv9rm-Mbt3n+UObY;-}6kAVvT7PemPZ!AJLDW-Bl4HTj- zF2IPK;y*#`Tm`zv|!MOW5kIh?`5gUMbs0Fo1;loBHf7lUbo z97(CXIs*9;9Dq%UMi@<6CGntk+>{V~R)P?<|IAXw5_>*pw{>q)*fmRF+ILO+2AHWkc;yXFiHPNJg**BOlEuKNV078PV8Cw&FwJfI&^;|Whuzn5J68$y?CA@FDtdD1;B#iJW%F{HU?AGL@ zMwsbTv3hs(=G@QzKNsM=FGm#9MrvmJ%up!?tE34Y#;V#fhz~x@G^klE7#}7}r}#V~ zs+nlYL=8z4AC9PwBe%D3h+7v7(s5-QEJ<^Jx>7H)+su81?G8%qRFc(>aokjHXWvmp zz*kC@fU&3|xky`%;AtpE^|_6c=(PsL|vYQBCu1w84QbXw(CssFf*o5M!JXtC7Q z9@`E>U$lDz;-8XCwuszAY^=~U?P0cL`+r|}38g&ylp+VQGcbo--Jhqa;671iQ6yJ- z-@f(i-9~@z%k;=S;lfJ>nBJHi34hf>WW>mT^YN->=Z->-+!2VyLfhOs5^Ft{ZuWhf>VAiEl@jCMC$F#eqmw=hM6SsqkJ^0 z@)}wAcS0CoC%xyy=0ULJ>Ql(?L~F2!zU`E9tik|PLwrJG zG)1Vt1IzBp@?_^OdeR>AbbVqUOrsTsAL(A~vs&vnl0gw~qq-(22QD_tkw2j0-}!z3 zR4d@huHBhxph#W`dN-*tSqnzwFc(JA88q)?elimcD}jv<*p6EzEP}`iYR@T1d}pDI8R81w?O6<}sIB zg(3itW9FfOu z1(m#t0)sXY`jTH16!0V1;N4sl86&ym<$(%BT`g8E)VI||?Q^52(cQ_u{HDz~+NOI= zJYp|?-j!r^k6jmWeSCa_psq7hnILFvUDdw2cj3Kbj}$b-VE|Re)Vdzsnns}0=jL9r zjO@TTrtIx;VsTzamI&@1YF0&L_6XFy_b4)_8h*RmS+fS?pcE#YwZ{1lFje<#3B(HC ziZa9ojFsBsS*U4==d4M-3YfHbS)6(h8`HvMn|MmYJ-G8Frdp3uRwEDtCcPndhcQJQAXNWzSixnG z@oat3wo5qK!-_+a%%DGM%3>8(v>w9mWu;yvYo`7O0AQ}(Ukp@roOgwud<@ceto+q_ zz6v&di;z96>ono&KZ#BDr&HJDQNVSlv2gZ@id6FBzEX#q-0%rG*#j*p@~j;~Axhz*fuyTu)}(<+9$PjK-E4~`BJlC=J*q6fd(tD|E?!(y3S_adyS-&$MSU+myn6EoG$UGw+WE+lC44uqa@%%AG zcu9ky4aA5GT$BA#53G>*E6mW;x!wB)Te6H~7ABUkZThPNSXiu}6`#QM{K$YegyYI; zBV)#)pdIe8{3D3L0zh5qUJ`DFE3lF6QS*j%NQxI%=T~8gAth~=;_^iiJfqze=#wPV zWaelKz00m4g&rm1_Bi{>+|C<|V{COUw6aE-aM~`vSQnmhUw^fJr{+pz&}V-a)8S{6 zs2~fOf^YczLw8?w#vpS!Be}3}#zU$-11dRcj6uA9$ibO{(%OD$)o9?bA6S+-0Hq{a z(feWb$K=jek9}oX)@pSfbu@0&7j0w82|lNO3|jhxoCoIp{?FM1sUrVDhPf{ztvaNU z+z09pc&8# zz^jl6R(pa_w#zy$#3ICFKx5~rsK6Lf4uw+ry5f_f93&=fgz~%+JE_xPT(cq@$oH*v z)kRq4)-M)37kd%KjfS=O1gX`3TPiod? zKG`Iuk$VE<=Gd!l!!ad|Xx{B2;sX2!c%=bo~{>hp%y55`RTGTTY?qwgnXGius_x_cr?Tm#0k zo8 z-1{P40q5tvMHNd$nb&FLdi8J8cfena>gIxREPDQpyOX8#h+*0yU!%GYynlu3BAr`} zpq>|UsZ0E9-F~<FO zF*eVv#)G}KH+6{ddga0Ex$S0;aG^QtJO6d}8mtuhtJFW8cSlF1`3Z39Fbbl9FZ>^0 zLhi$vI#t;{f3g6U^c?n^6>F9uOwjHop!ofPsGVV z&=qv$H)Mnfl51sxK1797D6yo5Mzz-cbj)*r#3KJ-3Sro<;vlIP{=ERkb>KpH7F~6J zKp^p^!`<$0gSlRrg3tZNz>_bC;gv$Wg0y($z27we4SbLf%1cTVn2Uew&UhBx1k&`O;f zQ)CudPA-u!=u#k0jXI(_Z_`G^$AWx5uJ81-BN&Wcdi;KBLn8K*m;1uWjfUYnp?$xJ zU2IP`>{y=}X}Q{}4`2s`v9VyI(j?wuV& zKo=jijPgB*8D*BUFBv*!etT5)Mp|Z1aAx-)mA;c=73NQ3#E~jkMw+m}t?X_u>j(S= zI8x{eW@`G9hH6FwK`rFzZQ+^&qImHbja|=o5=iJc^Wh+bnz&rI^?zpVa0@Pd>B1JI z_%yLEf;pQt=2A&Dxz-LfE98p`F95)~C$bhTZP!~pJ>L$iR;a)L=eYasV!p2KQ6oED zrkE0(x}DQYCIrY@@-8;59DB@tMpJu+*EA;eR;-4+3h0SYdpNoUu1M4_>X>T@0Z;r z`Kw8!KqtCAXwr256iw~DWvzZ-U<(0dASr8J-v>cs5 zJZRMBZ+I@`TU&F>w~n1g=r73N@5y8=F=m`#JeF}N;TW>;YCup*L1;qa?RD7{KeW)) zFM=WVj}FZ}ey*JJB>FsQoo6W}bNhYn3mi`I=ogo4F`6xPHUc6K?%@6_Z&726;nH&tVz7MqqW?Xa``CZKPIY_-Tkw_vq+Sx6HMi3vv1zIGE@P!bDOY z-u*r_yyrWUlH%fbephcQ;$=l*8{RNXKx^Dr}&p`^%OCr6-gR2q7_M2MypbJL@A+{8$FYX4ZVG?+Ssk&5< z$8vN)8JY?uy-q38KK@))Q~?UnlITs0{J@onn;y1i_(tdw*pkmFoKmIP#jaj^l)V4Q ze=+va&V3HBtywUNYNO{$P$X_6;!04mRefU^pbsNq=er*CS6me&!wH~M6qWa@F=Wia zvzAfDYbL8ei2yQUjtBE2b4MGKi^)upLd!X$)bB}SNenJ&jybsoCjY)Pj(8#-+fWiC znVv{J6VO?JBFHOkrbISGYV+oW_|}LsZUoQu)wxaEsX%7=B5k~c0jTa>*Ou>n&#M%S zEX;~M&`6bZs;zFnR7Omf)bxAR0YMY#4wvnaf zvbYa#0!xk&B>&mwc8SeOD5jBGDRXAkMaR=g)2?U4+}uwy_&t$nTzNtz)(knyA>LxqIm zAcwz2)9~OU0@YTCJb4V3lb#Y5b6%2q{W{G zE#H4Tn_*r}&My#R5=3THVw|)>jW`~1%nC|$vTy>FIDb@a1|$BN7*+Wg*_m)wqd%6I zm2a2le#F@h;i(^OEKXa*hbxvlx&`pgp^+sGdrm>kze)nTi%$+0<(AA>lv|6uo`6P& z!RLqBMG<+&8QqRs|BiflgN8*JqDTM^;rXqndXV#?E54G;hIyG_KO-{s9+iA&;vTQp zaFTH?MiAMVH1sgAI;3Y}TIC}x<9*Fy;q0(=@m0|_ zq!Ix85V(BNV#N=8v`Cd)igi1&8Ik=)6T+U7v>J{2EeLm;p`swq{-gHCu??rL_6^E8 z!tOq~aEGGCBrLJOJs&(FIBE%p&0qhkKDpnzm&n8mZ|sKx%8;}7D=_8AZYR53zYhnU z_PG7kSR2=4?hpTxC|RVT`XdKHXPc!h^+A=q@TbGY`B7ZPJo)M*bTj)t*aaGc50PF5 zRjCC+Z353nx0a1z!w>Niv`mt4X%}g%n}Yeme9Sb5SJ$_I6sXNJ4-%${Fxv{9tURl1 z%Z-$+KT=u6*(SBHUNkqCzUof2%ooB42OOQopKPb{MWEfc6f`#)Mk%hxMt2IgzUHo4cWk+ukS5o`j2-ejB%kRF0v1_xH)Fi!-@wCp^aC*q7l67$;ZF%tdn+df5maEk;a*DsCGt z#L7!r_Z4ng;|%lA9pZ7%#OvabnxtgjiJc+2U!Qhu2DSAhQhW`V2OoI_?~IUU2vS33 zx8f-GzdR$wX#gsXfq2M=Fjq2;MxyxURk3364}euy6r`Y*)r=1<<|5Np6T zp=@D~8%tq>$f!7B#mCGYT8a;g`!$=I87~2%#SKPv5B3Lw2=c;YjB1Oyd+Y0K^kT_< zbn-;A4S<}4ydfZglfvPN3`zGV2eI`Lh-Usd5Xj?BL!+=iSOXQq_3p=3J=A`eNP9Nj zO=TIF-wzhh`8)r*Cx=upDx3pDIPPOIJ7HuAvc51J3I;;HCDj5feFhsyXui4J?H~yl23brNV1r7*Qub7k54OO?l8>y1g9KP{2vcb!1zqS^ zB{`x^QQa2$@W+3PX%n}$u+1HVuVo+9-x4ai10lU54{jb|tLMd)6Jpd5Wg|>6tfx_L zJ6J{_Uof(!;^mySgClWoh*5oB^De}gOeoS)g4a(W96s9P+zZ$d#{;3~w`KAREn%C2 zi?GJ|s-MHFTKuZA2GKa-iQqrXF;EbYEJMjPJ-gW;go6*0#ZiNMNu*5?o;5 zYC)+CJAEP)zl3J*5y1$Kd{SlD-%D4FV$Lt+2JiMlQTa49~a~%`R#y1CBd4pYZ77+39QaeBw$c! z)JxWdzA6RL@-)xkgh3IQd&uKum5;lRpkFd?L#ItH#lbmiXpZNiaF%ZC@3mNpLM&4n zL>h5!&YzgDJRCb;O8(RY5ne(9@ChSoj;;ml@_H-YB(g z#2y(qpWiG^3e0Ne#lByz+gq61aa}9dXa>|9%HzV@uE^-@SUIJNVtw64?B8JmUzxjHd7Sy<53Yz?`w- z<}*jo&%ZyCE1<E{id?buLx#gsN32HRkN8KYKEdt3`Wjg zstO2x#A-l2(LKR)otRel(r@RF@A`&dhLlSAipGD3OS>J`EQi)zD3LkQ;mTqETq5}iMa9Cz1EksjAyq2T%862+#XM(>!x zBB|D6VyB!DvzNSD?>9#lsZnhQ9vF;(Q;SVXW74tOftVOYOou-=P9I|{eg=3Zb=Zjo zqL?Ni+w9v@;P9#@2$1^ATw^B;Ec4zZNQyKAiZclJuig5A850NSE7r<&e!U>w|EkHf z0n4}Jyh-@hK|iv1#vW`RBiqgVJwRva^d&PrPP5jwlg(EjOXY7!(s~wR!DT0i7pd6H z{*$|iv#sS>9j|Z%xGOqHi80+o0yPlOyl2&*7t7LhPt2Td@nrZQnv>%hE+b> z;nAEot@#O$!zvne%xNBYDlx-79+KaS@jS4Ffy+DsJ8AVymh$u&K2<j9>o;HiCwwtk(;<(!}9|R0qf4ryYKTYy+z2AvM>25-fdOn?#)UIyEMdkXCfx=hV z=`Ur|`JQY2;GKo5oyHe!UA9rl`K_2mREpsI>&Df5|5Lg0z&$c=^#?iiRkprX0r&kU zBT1IIV=_T*#CI#$&yoN(Sh=ghjnROIK(r63u!?6?bHh zfvuw=XSJfz+N{0-QV(U(QOrq2Rz9`Wx8#muOF4yJ9wMF?vVe>eaF{Ug6Dv2y)FFM& z`ba-Rh`PXVO%20JohJZwlj+dqCQH%dbQCzonBxU%HI( znyWyGZNN;78r>%);znhUA-rBY%HS3wE;=*%?u(VHrRf-uJ9P2eYfb!ZJ@AigzQt^3 zfl)DPR3B*4HHVL(u0fB=t#XWEGn6sw35i$%H_+O$47_NtiKl0!UXZXT>(M;pH)z>> zu5Xof9ZO3Pc^ z(6C;sO!@23=Sr8xLeI`qJ&K{aOye3GvCYeG&ux5c6eNeFnpUJ=w@Dp)tRAkNipb!o zs=j08bGT@c0Rma$lE?}<{xD&2kb&K)+!>vp(;KTkf(cQNPM)n^b$KmZ9@p%-+q)CJ z7~s7WRCn;kyl+VqmmWW6&11}_csunDOP*qFdjxB+BSl*XaXYcr_3DSdro|wxX1#JH zXRU~-@;<>*02~#j@S?mf{bknnOZ?2LaBop(d;PN)SA}xaSX8GiA89iOHe)9>(Cs8y z3PYdmtCW7H?qBne_;sXHc2gX#1SWLUJI9-Yk2$M7VnA zu{U<*Tm8n-U4uuW+asmcLx3o) z3IYTZ$U#J~fJ!2FZGD4x)lY1UZvg|0w^0D!i~%{Gm)`05;m5k!+1tslAMfuvltX>G zVOi=HmdE51|9iO`^j&=y@<6P1C@Oh-B6HOKuWR6ewWy_A5LFxF%wpVE)hWE82H!DK{S`d4<@y(Nv?pyyb~{ z@ma_RicR}Pz^<4HPJ&Y01^Kg|MvzM}6LUJNLq7XuJ>fFKF(q*<)I4j?65;=UF2Jq# z1$vGki6+$CnxP9jS{AH?Fyr7WKD!Zj9B#c^*H&_52oAXzCwR92oQFwy!JtxG=7X6; z%&{(`ueXacHmq z<11yWCO0JNCp&drTy&VMXai4{j$}Ufh{&8YV35S};z~p;D}TOfgH_r?lQ00g44J`X z{DsU-3Li@$0{Imed76xQkdYOVO+a2Oxf*`p4MW0S^lMCBSiRxZ2bv+W50V~6&sv;d zz4B5J(7e_KN?>Ov=2wiu_9(hJ^!^Wg5^cfS$RBS56hC`nJA5PA99Z}3;TeKTR!B>r zD=AWe0ZmCvYz%*vWMCund7)QoE!=@vg35e;t?xX*(nc6)c)%GYP+u8O%__e?vYmxV zQqW|((&|@`q+XN!QKew+Sy!*8zsJnf3_drdqhi{cXx*_fl)#m>QxF5^IUv(DVsH{r+0~=nYj^ZD6zfykTFw>KfNh;;{9}N#}4o6vs@bX+{ zzb3Q54C86NQCjAUoEYgS$vbys#mt?NZ=bCheRg${A|W+^mpcW1eP26VNs0e<9{-I2 z_RQX%I9|B(=}Ij?_S$VS;j%W=%ly&L^Ac|g`4#gH9I*y&@_Ee%Ea@gmqF6m@?e+*SPX@=L+rq3>^YiT~*~wRZVU zSC0%xo&4V>?t&;GTKaGQJYys-DQe1Tvx4_g;uZig*()-1%k(mm9_MGVriWSfzD>ed z)!lYdtn_|j*2q1mwwMNBmB#UGd^kvs2VA|X7M~ifD>eR*XE^WESuJOU@yh%kH1+nS z#nplsF9y~?#o1(miYZeVI^{1;e-`nLbPF9kTRYDASeb{LwL7A0Gn|K+YpJh=r_OPK zCstrK`jp>N)WV$Rm}ug5XnD=;N-69J6x{!cjo0U|J%fOzzDR?+Y8vbndFEJpZFGZ! zSpY=wQ4w!m&o9Atwzmmqh~k1H^IZK>1N|YRR$SKgszC&@72bn;hj2JmY3pZ%s zS#}(%q*Kj4ELEqg9e098&ZeTujGQ!)n_iVUimI#(bOu1gUe$aB=ekejfZa30Mu#t{&d z@1le$2a1^@$$*N7*^Ykx%yk3+WtkvFJb?oS2y8aO%C9&Im)K!Y-|@C_CR)N&b$(It z0$`w@K-)u&Ngb2hltP(;*&rF4)O>0CLsK2zT4xSx^L6s|f6$naH%*k`lyF0-J*@oy zJ-cXK;7Q)QKeX1-XDzM+It_Z*#o67xXB9a_dSnqIGwFddofP#*4~ueo;RiCTOpW37 z&vU#%8F7mqGs$#dSvUdDs@ku94)@y@J0;tnpGP8T>Q~yTY<~$}BiAYVZ{C0NFX0jb z52O|rDk}Rq_@NY7=$2Hjh~zGpub&+(@bK z7{kTFNm|b2f#5y!wXT*C6}ii|HXvaju`hjvPtz>L0?1Tn?>9_k&HMxVB`XzzsBZ)r}-u^P}Umki$MZy_s8^jdWPS~rxN(>7&!DGlo4;@Lp zOQmNtb}d2Sl8jHl9%5^l3rbcUmK00*9L=~H^ltB%Vs%=T-S zRgnOlz{M0uzC$U|K+u8TPY#KFUA~1X{50il>f1nK3fD)N%1FZGk9Ecs<8Vd$DQ>8y zgj(BM@$6x^A6bwou6+qpl zaE;bs?x6!t;)UcC9g(k4^5Qm_gfeRGct)|lW1n?UkTOgSwJ=He8WK;g~tIRK&nu^3N5?v6lw|?@LCSS0Neo(`@m^` zV{r&zuy5P4@#vmkUo+nO2!s|z_r+1OD-{HW+-H0)h{dixv<58(2tq&--n09w@bBc} zSCfe4be4n>go_zXflELH@-XU#Qki*Clk24VaPQR{l1qRwup)<=2FlxVRh}MEMk|$2*Sp4>Ddjh{2=`ehf2Ke!wx?i{s7wb3Oy6xby0)yQ+SG z+JOc~F=M@F^mY`@7YP`&{%q}jedd|(9GgyY=dID3ta$(yS!zB%5vz z-C&ejM558U(|VB!0gmJOVEP+iJqSO)9$$31ZbdODBH~AXs)hG8mBK?R9T6qD&fhA2 zMQ>1eFMT*!$r=Yw1szj8;#^Wsz{c#v^hF6LlM3oSwZ}CE`3pu^jyV@ND858=!OD!&M?rQaTXlV`+nATT2|?=JEJ6R=x_BekCAeGZ^QFI z&kIWiD8t(>h1o=^565yw7NtaeR48Pl!*%ms|3aUFwulP|&8$G=0`NEgm~|QhW@E7= zx&@>71u3(Cg*#Yha55MQ03EaCKz!y=c*$+b4H&^UqdJz-uE5+a&y!4yIzgUyWk2K?FVJ zD>c<6Asn^iokxKeQ`gt~M>~~2BF67>$T=e&t}`t^ty;7L&Hj!Mt>^lK-{`F~q38-Y zy4ohj%GlS4Xech_pnGeA5W3`*R*lE*28FD~S`5x65kVt?tfnj`s0txdE&HMaS%q03 z`Nr!l^W5(-hFIC;@KnDv2xa*ZUC9*!suN(q5JMv|1#G++NYE@;FtY3{dmq;$M%!(3dH@}PX}s&>;iAMo0P1t$rQ9ev?69iq zT~tVl^y3&!Ro*1=WX*tlpr`7%wlca6*kow+xBPA@S z(rnd|S$sU^xP1P4fBI{N(REj5oz ztADn9*2EEV3d8R06iz;#fht5hKabVij{23Goq{@#Ks3NI%8^p)dw*T zOn2#GL&rtgx_*$z2S!?$qz0BeRfuOD`7*mw`(^eq8)rxL>dZ`RIaFMw;Gl34Wz$2W z7lk6nmN=&s+*+v8vmaTFz!SiIq9kRQA8^2j>ntt)r8oij5aXjpjGDzsh{GL!B|>0F z);P=aW4x&3C;BUN{h5w502+ic2K4vpo!O+Egsgkq_h{GmWu~-yTLUs4<+M#Nbf9+o zrX!7!5TJ~g96Nqf)`rdge^d+5*$v==O;J0QO~w%VAc$NbirIeeq^8pBh_Hc)Y#~Wp z!N$4~>|*JF4M=~Q&VJTHFD?#9M1XwrWGBJApW4yX4~oN>OO~>Mk@?l5=TxP{nN3SQH7^V#ApYC5GMV zT^AU5$qS_p1mY*~*tJ3zWT7*~&oI4}mU|WTpxmXo4H_v7En&7s>c@UHRE<^ase0F% zFKAhMbkW1ex1exlHF%7E9y|3=x#dZF+X(WB7IQEeen!fm1u)kOLFO<6i4GLlL*MGZ zF}wk~3lgywBkX*`<~pAA4RGu|Z=P!3;-5~CmVXCGN(Z2ZOvKi=UFC7eu*$c=PhGW~ zdXhA(UjiD2xuV?h2bbP|AZ087(B?YegmcO9ao2?af((OHp_eozN)p3`9fHL3Wia4I zHO(A;gl&Nf{F{l8N=Hr;;%d>che{AhD_Q<^XWV+E!epYRt;EK<1citIljWUgYVMcl zy^N#mvz)&S=rGFS_&AzVuc73o?=>HuzI~kX=BM72o6*LxT|wgt-2=Ms-)QZ?+Uh&{ z#MOX2Y!q@oN-pEukx5|hf|QZaZ_eB?n1Bwo6%>HG4#s=L9$PZASputM{mtfYFWN$D zL&`pK_ZUdc%Jr#Aq~9eXNT2z&fFNCNM!Mxf#EW zWgyG3?;f>cZO&To{zvS&%&C4IqWv-DDA)~o9v}jR8h3M+WodM`yMSMViJ?XZo@<)F zl%gUer)k^wiu3$_l}$5)<;A|u8^4UuXi5>m|0^o?JH+tFN_E4FCL_=p%%Js`P`P`l zRpBY$_CP;o{$=AW=mTACL#yO(5pg^(rL2_pSjLTu)aFoix&-H&quB8Fe! zvqIYE1*HmAwX*kQ!#~pQ^uKG&*WCDB8IyX zRE}*6Y#il0-dgSTxqDbl=^*yyJPhHoztZ|#QjLFtpKVkX&02d*cU?|nA-#*|^u6BM z33%Ch&G0{o-aFg89~zqH?`708LumeQEe2eiXE;_EBD)2=0(Xh`hyVeS0R|=^0%eZ^ zdw6bc;k9#zfSsi?lglvu=8yX2fQQvr4D~ZLLN~9_@lXH#O~6z4hu^zO@Y8F+FR2v1 zT)o5di%zeiD+?ch;(Tr3W?I#nh(|G5J;jB0Em84Fg3^VYy07DX>(t3S}bxt$vl}iDynVc zzGzVOQpy3C842XOyzZgkqN`hGb9J+XGAv(mpFWY^)jqUpQ$3(5`@ok@$_%e2+}D$y zU3~109?Q_uKGY9Qw}}Ylo}H28a%=U^am@d-Q+V09;0(A7n7TvDa}5ZdEa+dn8|v4u z|E+B+vUYMt(kR@{)P+*zzk78nI?k1Dng4Ot;d8$9{&!uv>n#7seW{962skJJWYW7Y zVqbMLMT7zmxs!^L&b5^hN2`gdC!i=i!Suzxcm`XiXWn0zy3`Or?ODxjJ> zX=C%G^7B3;`J|=l;pd{FPSq29L^3U~gk=%L3l)WJHAyQZnCIiWVx6BGu#)3fnDvo+ z_vSMhXQ~K->P*Xo(^pZe?XDlzU42RYgT*B$_%u?*N1QAP4jKr5kBH z+jL}tGNa^@p@vM*3;#Kk%2@QQ zI_S(XH_#LgVak}sH*KroJ)+$7Vd`4oaAO_$_F*83(PL)aT#&`;@%drl zB1oilcwn4IH_Z9}+Y_97J(BJIGTw%KLBhF{ck+Fy{mdnfif+4{K2 ze_b`kZVL9c{5*+0HzVEk6(=o|&1|6x)}4lR%E7682RTATAy60#P5Fm9Kw$}8C@5r; z*Oc{N)H`Z)Yhd$fDU=eBK?be`qFTxN&$Z^SEz}qm*AZ(u!DPFB78)&kfF#=9z}p$% z+{D=zQaiqBNzP+hB%p4%v`2-P3EE^D%D4fBm|c4$>nq?i)?f7#1%rg=|K!27HvBoA zOF1tTv}ly5D$7*HjM!d$W|A~=H;VAg?X3v}u_Ko7kj8Alwev+gypKpg3l#0wpF zmNLO5#0xgSmHTaMIBG-I=IYtpiOj-5a%(Dhhb(9kM#fvh_T|5c-TP?%+n^WsPl~?L z%270piymYDx12DYV~!Q;p_gq9kp=3DuB$s4uYw$uIG?b}kwEoy&UJywD7FH&9^FJyAvbj+lz`fgSr~*Jn*ypCgLec@#Y()(UXSk z@x}NLaf_w&>9D>TdFcoh#7KafgOnj2(L#+rsW3Cn zgMnp8#6Sf9KXyk#^2Vt`tQH!Z(#ho8ECq=376(^7as=f~lEJ`x-}n@eHyEfDjDj_2 zd~ATeP@5Kt%VKgA!pcCDs$f1*xxLBRbR@n4252d$XJ{hzPV|;oXm-dVIp}R#Y_S?bX#V^~Z%d~Kn@7-y{TT})D!^>F7|JNxb*$Dye?C62={dVR3bM9#`FypllUvs#ifQK}YK14)N z0J2H9HD2LE2IBa_*y!`E)`yuN`X5laM@suRYGk0N9CWzZaG~?&@Q8Yu)6w8C@D=Dts*G9&Bz?6IM70stre*RI!d!8b z>zHkMsH34 zOIKMyylI=ja^Kt>}ZXmZL^Z78xRp0 z7~k)Cy^H%Y zX~#y<1jhwb4JU7zL^+OB)-_M9OwTZV3CQV*e!%#_g@!4!f3-g(V8WMzKt08uHF8(z z$OPN~NoETsI*W2MKpVKI>2@EluI1PF8H_BVwUr!sKF|V7Zz@1Y*zD`}`LRZA7{QC5 zvsd{nRAOl@TN4t|m)%A%t@VFi0GdF2`IJ7Uf8#AKcS$Sg79ElFUhj(p2TX;mAA}<@ zZWf13SRUq)*Tv_a*yeae>m!;Pk(C-|e4n;TDY<+S59}S}~L8?u%O%NV3awc8{R;uC~28B^0m9GWMsPrQvTk zUkt_EpmnA96@pmZ=1#m+2v!&oz)1$upU^|FwsA^FVI<+q5qns~E+m-Uotu8v*XG_= z{I~_q7xP8;OXqWIV_oq&j$GW|=_!wq%H+vfAN9iOX!ymXNnROdWFi5H-K+~C62KD! zJ8tVe&F85Y3<(%7sY8?rj13{XO`vIV`@qPJ}qmV|`(~Wj}jZ0rPUO ziB%ob%dvKsfyesYPrq2F1xX<28~8gbuUDGGoO1Y$^y8#^cOz)9f;B&+NmTDkKi(~{ z^FdoBYG^j?74>()4)^EeuO?)I^N$O}Cue1lgmMT%miU@%f(OajXI8MO+73(|y|aON zpZZ8r5E&(8@Py+7%qEcGSR{_EU!Lr2l>yhE52$L?$<6gNL(k6pHNWEhz zDFfg>!c5BQv|s&hS1Z~QP0wUQZ(;XUR?cveu6C=t$u{>FY zJTsRJZ3U7l?yl{8GNZ{iW*YIgu8bFH^?x=uCUCX&7!$4O41nqtiz072Q_iP^Nm%J3 zUI2v+vkyZybcH9&e!4jWRcWfFU4RG$ z)?)V?&jl*+oG3sX7#Eer+3=-3GhZo=x};wTYJPtc5ebR29Fj2BsDTlXP7OD<}o-S@B(FH^z*bNG+QRAGRQ(z8tm!!40wzxz7+zA-2em1eE_Q?}Z zF{v+KPYdjo_B^=Y7JlbZGyS3#XpZEdGXgu7@tyug&W3UKldD|o+uGc7_dA!T_-Ha? z|Ez+4d6zHX!`yoDk5Lha(hhimawKY3aV}Yb0-m9u-9n6lD>XqVkt{ z+QAU*^ADMubwMu67(qXpR_U4h@bZHnw~_)Kk(_Ln#pzf|Tf`&v3R{kwFxBcT7Q0Tw zt0KsqD4u`o0tj&4b=eJnOoaH9Ke^GtXlrk0zUI5TO(Xtt>5vu%VE_Mh4|5jC&Ad2A z27F={Qnlo~wUbYmLj+l?WlCp<)ECe1q6HY4e}!bH7zf-%04|BtK5tzwA4fo1hSeqP z2C6BTRK|#G(2JH(7tSL#kff5@W5WG`gbwAaT>K!yFB>jy1OOWd;Es=pp*?|mik8?G zZs2yrScwBD84G`Ud%_5y0$jdJO@HRxW<3@b6&V2xBnvpMZca!>vG$=I2w_)@GqI|@ z4xlA+ECa`$+8|L1N_FQ;*#qWB-zHOmDOhKhK-p@JZ-p@$Eh27OP_-U** z&+;6sj0fF7oOuNFTDiY%Z{y;fZ;7sRkHet$*EuFN!QvBYx)>Qbo|E`Y>@#F((6{6|nPh5SI9fnoG>S5-esI|TR`lti`{8Zrp=-LQ>AYg-t`gC)i7BMVHT!BIi^q zFKn;3S86Q%sTfE_DC1yT48cH+`wlhwLaPjN8%?uJ{%_KpHeO=85~Ebzu^y{JG z&}R~DK@c!u zvgj=*XjeUkHVjQ9+`0Zr2=PD|z=;kk6U67swaj2K<^_v|YCu+_0khj2UNQmk){|6- z9IJ{W^`o7PHGa?we<0ycM^!01<>&XlA=8zHGz^v^iW2cU6kg;O6lX;U0|4H?Fto~! z^dArjiPABK@D?fTTWce0*M$DrU55Tk+wYADpvTDPj5;fdtf)MD3TU8mo{+bLl?IC0 zHtt!rV_=kA)D%~y*%W8fUoQ~x;=J7U_VJ)l5z3^-RAe_c_;g!Z`2zq)TT*kl4W~f6 zK%8_v&)1EUb|YFlgWO1MG1Wcge@s-{$@y zeaMU0kYaU>{*M&62rM%#HO{>J+di%RIBAYS^$wz_cKUayRyZFMye~EYRt_60yHB+U zhIr@;eyRz(f3sVIv+IIkuE_dY&NUjSZ&E4_GRCDOHuW}X2gUxQ>5a|aIcsC{NX+NY zC|jDl_$ztp3|%1v4Q8;e2LQU* z>D@RoCa#N}>O}hkr8Lz3iaTc!en`*p(U+Vq@a$|{K_JEv=B$WdUqJ398Lf4gUWL~C z^PP*Qkrew*R%m&ax1U;4pIgXp1vIWvO)BJ%S66GgKT zly!4z@P|i$)L(PxRH+S$s-8n#8 z#K~P-M1(#cgYWKQZf+ca#}N?t4D^!-@x5DHS(%%`>-EvA zC*Oy%cEOD0AJa<2C*Jj_arsW z7kc{gvbM2wkg&GwZ`bO>+WvJxpl!q6={DVw=MU-RX5RVci}n4z`2D#|eRG1h%*U6T zS>QL%KkeO(>wd|G0nI{;*at!hyD|t6MJ%wKkidMan4YwRFW-R3aa5cD4-*QQl;($0wipnECoAZsBFYb0yZi{O{kDnTd#$4E1@1 zr*NA{{BPSouDUyF?_C_8SnquXK0b!l8vj$Lr8mcqj^Ep#R{wQ5pESJ$?EVRO>+ZbL z*6ysT=1rm%xKvmV3V19fb$Dp{H~p{g(_LJnUBFAghln=u3V<0ue*mT|zqJ8{JkIIk zuKTGxU`~9Vqu!Pd$Qc@U%zD-3l9vB0SH-tD51wj)dm6pZW6PM@`DI{J__}<(a|Gzo z!<~+KHbi+yMMt?)cgik3p*H1gM3p<0X_e|qd z04m}lfA7NwNg#Z!IO}F};+qpt(Bc2=?*FXOH#@3p?vZU*U+d-W%FXlD*H<{eSD4kn z^4s~IySI(Y(U2(c=9Vg32J8-$+MltqOpvw@MXbMltoVG!AFVs-x>)qo^!%!+GJSjM zY^lw$u9Bp{Oy?#Sm5MJ1AxEE1Mh(;80W}b9Iup-C7Kl9}A3Pw2-s4&zsv3+QU!fyv zwh9>mVLl3Sh_Z`-L5S8nPd<R9A#k-hQo5XteaJ;3c?^T9|vU~!7Y zuBOH3y!Bt6&sOEJ_r?3x$9KkF?kLnR^k~JYkgZY-gXFHBI%U`q+JuXrH|FRBj7C+~ z%pZmj0B9opnWEW#TE}<|uGDO!kt4N;?x;%Doom8^cY@#s&@;0mA+lsl3f}Z^Tqj^k zOTT%GfAQS{eb}B9zfZRW`dt|B+LjwIrrSxOXFa#t2G|wMaga2JkF!`flYTT^pMOp+ z#~rRTt~T_|@8$HeJtyNpoj}YI3z*y5vWBNj8=Bm1Y&QXIpItF*(@iQzN6+mcvg5$FGg}fDwvfhl|jKMT?enKKmK%tP7%6 zb!2sL-TK;emd7vtOJ_i9!)+ip21*Bkf&uw*HVfz&I}EZ<*ELg!XD5BB4WkLKxEtBLVr z5QRb@zd0*%YeSKX2hu|$g@lhLL`=GPNO=nl;eh(Z5AsS`3OQQMI=^onCm61K7X{q= zb}};^_?)F!{f>|RTDlC8jnPy`@|FLK80au|oLW%I$livz_1La+YWL}&^3_}feZ#A@ z_F3cUxOvSgv>SU2fcma8ng*tdu8EugHT9i27lj-2DPmZ%j7ygKfrCI<0P% zXX`u9yTR5spFU>l;4NwnWEin&!&tj-uVCY(UhZymS^nN11lhPDnk*ENal?KpDH+;6{p>ljFxMBZLu1#}n4; z5j2(7D0?QZ<~a(Ano?m8O`h4?ENrYzr3*?9ow-8umShq$ro{^U_Q1;?b#j6nMxh-P zw_N#rEB|CKoI_vzePg+Fo`5OW-*edG${Cj{XmBPP;_+`UI|v;YnxcNz=ok(8dj<;s zt{BIei=&F9G&+h->@Jkb4!(0%+N*_Ks*pa3C+Yf>F+T7w{@u0Ca$-=|D?Cty6kGa-6vqLVoV;lPrlhn<#4Q=|7i>glNSG_K1s{ca8mqG8i>D4;_T$P9?^EVG_34$F# zj^yWqN733=R6JxVgeav_TmMTbP6bTMKu!*d`xmVyJV*UA8j*%tAAfIMv2xp7i0aTW z9dlIE!W8EjXS2eg&r|$}5jFiA(;#gOBd6#gb}$oPST{UOB3?{u0m^I&I(t?vB_+jS zwaawvDbbu5LCv3Bk#~Qmvpt~9B-~#ZDeTO@8(xOSVodVO9y|EDc&%&;CSw%G)+`$$ zz$?JD35miD-yM!=sA!_aslVpP#dKyxP7fPywHICeuOg-{jdq2~(3?T6znM+Z{052S z$=w`R64<-w{nq|;$Mze*&JM?D?I^Y(2rY+ zzDP>SH~$^{@e?=ai5dz7%kM5Ta&CtRtPITWP<>EOQiRo~RvCK45x@7w(zL8n8MSGO zzHl2SGLcDd$1oFf*+3#OO*u&NuZFr-naNA_ew$}9e)7ZjC}^6RU6|g6ZR02;j@EbW_agjSon9(H^O;S zCVATq^FGK%0te{;R21PLJN?GQ(nzNozdi|a(JCSM29HQ&q>mF&5#K~Dsl+F9f|amn zl4=>@)Q9|>kIFc>VtYApi z9D@M43t|%BrFjg9lbdjQq@mG3_cCQXC(joWgfG29MhRle(Z#Y1Lz`LZO1z1=NXhi2 zV$e&ADYAhr|BYY%-aJ2*AFTVm77A@^%`yGDB^k`)b~eWqz$J$jqh(_Ma9>#LfU`JK zmB)Qhz=j|3h}R=yjUoVdIIw0NDWo8*bYPMjDsg(0h&a89i9O^WT=DG@a?qAYeF$2t zOnyc)NbB0u47PevT4Z+PCVcZ5G2-B2rr%r8>6t@W#^QSfy|djn_h=J_w6XC;c$}^V zmzU4-bi3^TIfUO2>Yp$pV*^pFxZ?~l$^NbmYkdlt3LFfaA{!WD=`E@aE*WcBq*5*6 zIRv`_%u9^0^D1`$l|t|UKl^O4PV4(?Rzv_iyna0bs>LJu!BH*q=}pvK;!4RhBkoX< z+V;+e<@C@29M-#ayvJ(cQ|*3@$1n>{Yran4`V;@;TG?$7#p0BaKXPwm)1<(7mj+xT zPu}gbtd1Ef>0{K8EGe(QDu>dQRmbj)Fer-fsmGJDV3UBic5AWSATt)37Za+kN$niP zpb5_`W+1pWFa`zNgDRA|Y2twRsW{(IjTh4ZAC^um8Uv%zk3D$OoavV{WUDRih~>NC&L@=aV&q9P*z;+e7LT(fE8!0-WB;Rl zzSl1kaWprl8Qqsp(?)Z_`l>Yf(+_Jb*9gfms%bl%6~9)AL;7T$g7DiEC72BYlWXuF z`W?knddvic5|!EorVg%wOK5}GDM98(|6UAOmOWZwjU>Uo1}Lv0A)>UV*&Df)PBHVS zP>YO(%8-9L)pD{h&yY+(q|9u3-nBJt$gR!@@uWR6-re{7SJ3H|ekf)IQ!p|S%xc1k z8QV8-07skB^z2o{AZ)>@9`W^^xX-4GEeKIpH)~DmJnrYjb6UW z=O?%POAWbDC0^}Cv5*;X#?x1>%w&97826Vli?~m15>RSUvpdz^VsH?4eha4Cs7B9{ zAnB2$OC)C3y1#xQ88uZ56r+0hx|L(N6x+h4IHZj8S#N{Vrm$o_L)5|@GsTX9|9#wR zW&~%$bS3_7O+=s7uzgO)@phW~IX?79N@+D`I$zo-zl>1=KYxQYa~q4KB_)5679vA4 zq5jDitM=CctXUqO9~_?Eac9?9`f-)RW3cjKY>am}uq-x&aqp{X&trP-8$wX$-kY}e zN9fe(1f1t$m0f+emKg4$YHs6$6nxe+Zf49|?1nhb!z_EL{>|*~e=|PWJgU zNHBFUYnjwS-53Y`B>FSVp0f2;8GzNcIIHlZzifeCb~8y%;SOsqWq7%yW08J&E>gBE zwu4Z)t~5jK+k9GyC+Fd>Y}Rz@ZOK+2&EKOAQqlW;Ex*XaTeJ0;am`shGRv9&!7=QN zF#Ut$M-&kB93YQy)b;PSnR!P zDj+~~SJ%PP1Vi0lpC(&m@aD25(#o0756lop5Jt{^VqLdxqurZt%(}z`6rPA9aL=# z8I>fLU{vh^PPFRTFgDz+TI@I;(m#WC^7%$pI_?cRF*4z^inTDfUw5EGE|V>o{4h(U zGopDS*)|6Rp)KQ$?tM3edd+9i9`{?e?A zOzP5faH&{Mw>94Q@rsA2@v-3ENLC46oROH^pR()>>@}J~Lvaz4YQl_b^&=o8Gc~{; z;9ePiNRB9;H9hv(-?DVRYvASt^H2t22xLOcO7y0;2vn3&XqZP6!R!BcCz*<{QNCdNJ=|TvZ++Z1 zW9o*3brE84bSip?v`id1vs46Mj;7yFs_7bJ5W%VY+MEQl`tGU8_$+3_Eg{h*-&cVH zMdt{J>UI$`iq$+rVaO;p*~dHQ;BfNb`o~Zt_B^pg_!n4Q6kt2?cSM!J^TM|Bke6$| zf}PDZ>j! zUz6?U$9f_W`9QYGo9WJ0+aoJl;5fNHvw@5wG-NH4yg6D7E9@?+5|kR`LdA5Zdag0d z77K|ivT-u>{Q;ti%kX*|wd9eNZ)>5TbNx;()l;?8S%nDGF>BR9_Ej>PQF(~(<>$UQ zgV}to!a=amtZ?D7NJvEmR0*tFH>TB`;NBn64U zO7xR|!Wty8yG2HSwRChdSUXvkn!@jG?{GPO+Uxj7+%Gd!ZjPCjpQW)#Ow^*KSU?gr z;h=88RL#yqIC^VaDh&$U6Iy#Vfv-G0kZV4CC zS$mH9afrYNiiMIHLb3(R+XhQY828F$lIxV9IOf(CjvmfQrjyrCU;ByjX-iQxFJ-|(jJ7}-8> zGHI0#o>=`h+C^P<4aKw6T1DOp!(ScjfDtr zuLnU307||nNFWmtSiyg0igCt2|DP8?%QOBRgQy6)l1GmvB-SF$+2Rze2lnyBlP32a z1?Lm+M@Nr$ZhaQZ8pSyYwp`B%IRn#iBoBAK5kuO18bUL!EE028nDyvwLf9Ptruk)v z0(33iMqn^nNvxn0@XbeRoq)j09#6TiX#w9NehilqZda!+7QD`;m5e@K!pC++WrKY* zpE9!2l}=A7G;FTVu_vLN=~axLv9o7CM|AdUeI0#lbGFPzA{0TE25F`Vn?CekPhV<5q(x-;<6GGoeqL@oitW09?iiGe4 zSWz7uI!0B&C&TH9Lccb|%|0x#8)P<@C(goo|g)ZBM?xn@a6H9>z|)Q z@?g%4wweZlNF36Gg;oUo!(_i=zS}|h7MiCu=!tbBG-+UF&CcY`3J`A2u`8;r#jlDB z>9^2YIdo|tCk$xeIisFHX30{=Oz9Ae3&F;uLDZ3z0Xwv8d|*}+i^ECB9c@y_fg#4P zUBT!ZmF!%2bJw(unTCXoDGj|4yzPiG`_+pbGqjIvd>c@m;%3qt58Dzm=%Qz=^Yr7G z1xzi_2?!8^uVTM>FWvAI`^aSTeaW^zcG*gY(j_Ww-k(F=v~LY5qehN*S3Xirfrqchug7r>oaekCe=>EU>o5 z$*QFc>Za05dqc9nzH?|*uHbC{HM&G05>QKTbAi|bD)G>>Vcwx&pou6U72wjyur1lb zd^&ol3Fv04GxnGHXOVF}CAr82H=pa&>+Ws-TX)fZjTtl$ER)iS8q|W&3e*G4a!zE0 z+#cGaFg2+)vqqTw(0LRnu&>nA&WJ?ALqd?fWL}i#&23HVPb1JFIsXh5(Lc_XmgM6ZF44kBQK z&vuR^;Oa9-rKEu|`w8imMBt(*C!yn01rV{WDoQHLsiS#S_rP7CnbZ zXVdnS5;ANxVN&AE>uME9q_IvC-)c6*>-150GHaF3-HNLyz{&Qm7#8-P?S=L{Q*!r9 zLo77jshjXYn|)X-GtuD*tcDUYCre}Q! z`cN`BP>@M0I6@U7*M({9J{$!tdLytxDT97p9}U7NpPVpBpz<=?tu+M10Fk=vpJEl z|9e>X&l>Yv*$pC%Ta-#pMux$dC@E8zVT6D$()elVu)DLG8n6x+!e%a5G26g4ATUj* zObQQ3m5AU&U$G_LO+S-$__u#VS&1m!>4d@R9_VCv?)U6HwVlK--|DxiRvCzc!*)_SFPnF=iG=hr`GjQMS1< zc`P~r2p`j@^SL&+GqxL$)ayI#M*&n{d2%Afc!tZg+Pr;x8*XBTDmv0`UUNwqs?LO# zIkG=0SquU%4BfXKSrRVGqO>nELj2GJyqG?-oe$+W?cN8tkVdEY51QYTcNDO4pBwrk z$&F(J0mwo+tT{Mi-7(u#8&VS2f!^}>?`wMKfwCyIP&^1c15=X?Gp6P~J7B`n`!mhZ zM^+jCORxuhev8-QJgM;i%-P}t$5wuW8)b7Dqi z6kg~kCa9vZcST;*8v>G9LCF2KAuh5t)HAU#pW?5eG7z+E6Jo?of7TwNghbO68FX8` z!p1=6{y&k>nULo-NsjKqM_NC-$t!_YZH3J6F_N;4qcT_S>XcXx*%Atfy> zp~QQC|Fzx^!wgJQjL;PZ)=i^B{b&TrVK}azfu4K;tX63s_>TBo` z6+a^`pE)Nz_+xP%SXd}?4ssu&679f7xHo8r^9l``|o5Yg*?$EiruxwI-f;JiQ4AEKf zi}FUYAJWun*nOrTX7$ZlE;Hd0FZJxc;yD}+tS7x`U%xCie4DIYEm@-4pm99}8{x7_ zhk?+$b$*2->w}AvR$jCAyc@LM}8E4I9aaj^x3azkJ?IP2-xnKJ-P4Ry68M@ zg9r8Fk6B>tC?($Z)#i5m{p;BijiFj?OQ8J3yLuHNr$HJRP1@(hWo4XpArv^Ynq0DE zVa*rbV-zL#7uo(~NOvg!)x|jYC)p$6zlyQT!PbSLe#2 zPsFygep@eZ|E%V*LO2QIdhiW;OmIt{N0(7Af?2J_nPL8Inx&Sag}^;K6A-M!*sp&F^~jSEGoR;>zz@}ZUTu*8t>i{?OzsYKu>@ez~)@kV24U}JCXkGcp{i| z^kC~Fh~Hw0Jl36dSXR-+$h0-=U2R+qtF=6;k@LOn>+(25Nj{YVUNuR$!CITjX&4$v z`jgvowx|Pfb#Yki+nQAaUIptfk}}wfg1YHT$3q!yCZO$yJkM0FkJ|6e5t52~2CsN$ zCI$qf|3u=1xRk?lVFbQQx^Y=L!QZ3kFtx01VaLdTbIn5w-^Dbx3KSO1@mk}m3fQQ} zwMbXouN%$14R%n!A!4zTR+XxPte(>byyE>29O|#8rXy#S6fF-NX&4pN-(e$2P$Rc;|zKs zm8w-RG$giqb(ls2`xkB5>q~B&jo%ssD@7r+$XxI+cG-fG1FP0SR$seSwY4ZP%N9C6 zTffTZrf2@h1B#<5$eII{d_J^S?OD!{p zO{HTM==&^6;WVh(EfN%WXTLxqQYQdZ~I0L$cV3P5t|8@Q{^tK z$yd$BBuYM}RJ2?m_O;X+OLA5LYX*Af}nq?elIM$-lx&3|_SVg)y83>Lk2QM5v{+m5{HUwK6 zftLL@;*mbWA4_Eak5~rer5|y3F`o|r5g-91!w8{0ywJ#B02P9^N48Q{4F$6hZBsE) ze_~{D>5R*_7^)9M+ z&+KN}k^FY?djBE$Gjl45yi|qxDsmEqp;$UubNn@}kcru25rTU;1+?sazi({-N9_0Q z2rwoZ9m0eY`Utgtq&;{{fwDjcH1$iSP-$HBK(fiPlxUX0+R3RB9wNaO2BNiN|3}9= zOrN3ZIG6BN?cCfzQ0Yar4?52aUOZLSqTaxqz83uCMV9s1Sb`?9ua^n^Xx;D(RMY&FHK2R1e zN44z8^_0zs*VY&NN)SXwzo0BReFcS~Jy`q4?t8!3rBAVOS;qR%o(%>_-$k{eA%ibV z3k1Z+zGGY<#NiKeKnwM%#R!deF~=Qn`|85_74$ZqGy~OdP!$g@Nj~FMgak0XtW3Hn zO0JgcH4Pdo2xK1(hg zyUgpRPyj3*Al^b*uyeuIr+nSA)aE>Stf!V}W>Z}*-JgV*n6;^e<%)lYx=mY?k6Ul0 z#bFKN7M|6Nbp^!~lrFaqBV-ff83PAK@INNE_p3pDdR{ycT&E`JhU24*mtvUx(wBp< zG=P{EvD&3C%6k&o^;0M{X3UQRPifo-W*M6P#^YcgIM~4odP9UDSOO-72fc-&i%rsk ztVx=*+IvJZBP3yb0{Gp^r~>wxadQZd3q?U`pnJ$b!!S&*2uJuVj(nNtGE!kxQorm+ zwd|5l+*pJLa=j;TC~$hQ4n~=s9?w@uaw{jruRTC&y*+C+xM)J1N{hedl+>OBwL|1m z`*;c3yPJ${@lF88c6wZnst_q#AO@i-w z7;nS%%cb`ie2MyWAo>or;+9raX4raUBZMSAr|B@&Xr9L4zYecYemLrGQ>ylWFW(@58&zti2xhZ_OA)Zx}@Dh_r6 zB+)~Q;C#*~!011KL>%xmSj7MJWtKxSjs56bxD|Z_*3yuw+pMZkDW~X6oUsCid5jPG zi|U-m<;U~gE6Y#1rq(H<3%^W6%*wmYD!L@xWZQlA&pl1=f(PUAf+*}(PVA@e-47W! zQKd{s}5;)!PJl~i$+fnK1(--K)yozdb1a8I$Uy_CPI)&J4_V*WCPxBH{-Kk zug97ZBwn~s>}ceyw?gDJ#i(7g27%*Z8( zt~HX!!8l{ZZS()mBwO*Ydlc8P}p?)2kO7Dntqh4qNF?jvCj zr9>T607N&st3F6S@Piv@kW2j(gVWT&I&U;F-#FOE!y->e)+IyMVs#uu928J&T!7uD(47K=1b9`&O}E)EAX`vAM6Pt+BAQ2^P8xfixz#3 z;yDa~c)gK$T1kPxaK`sPAW6%3w!)#TLlV3VOgUt=4cRwzRigOk>N z*}kjOyZ3i?vawRs6q-!^y{60eznilwNZ&jspt;lYOxvhk)7N+|U?VFziK_iqGujk5 zz}iT@IKPkry0iJt0-9jy&4Z!VWoethbHkUvc4+xIp7rCL*BWR%LKh??mjYqKTzG5J zJ=APT$BB;{*2T8E`r4#&m|ReoIgPQus#`lw6ACUoRw_y>;`wv=^mj4N29<7AX zSGt4nNO=0gOWYRw6J@L9MK6M4ZkLZ^8BP&vA47)89PVhx`(?IzY~PWL02=Lqi8a%PY)?*K>Bx#2>jQc1Bk6|c zN)5G}!B*d+^|}l}_tKmnl&W}}RH51fE$1RIA(=$<>AYe5DGS-|3_1nuY;@~*Y)LRm z0X$07T*_7!d}qV!ks^iRt^r{?ua^MOUBpGB1?i4q(HY6x)sN) z`Rz#lg0y;D3C3kgV?Gxhm^fA}(h>P6m+n8OGkgC|;_9s8ch3cY_N@T4FZ>SxVvpx! zW*gk=qi{x`#rmC2pzsY^8ss)bra>)3p9Bo4@UqbZAUpOSWz>-v%I2-oF&0un0t`Yq z)!Focu?m`I1cR?BX@Nua&c@w_50$y^f--FWxwMRPviOXWC4C0pTo~7~$z@n6n5`cd z4ND$JZ<9Ie~y+f}(?R=-#sEH0`o zs2Sd_3$raxU@QUd=t(Swo49q9yDaG zkjVS$iA&ZFcrsfFaWx$t;a{N3Juv=|1@QwR-v}^0SOj`86e@n%aaT)qe zW2+_ppG@=DEdW_p#4o(oE`>8NWP@d$UHM#=Yq7t^s>p8b==*{SP<_5tq)J;rrCAz- z?INNqq4e?32$O_thMr4{zLE_!d109Tq51>hwCA0GpbyxV6-f+5R%1j{G`$3h(yd=1 z=jQ9C-xlGHT*_dUyZ!+IlES*(8Sm4mBXk34i@=xW-K=(KmT5&TI&`%G)8J6S@-<1>BYJH=+6@&H)=rO$5MCvEz03(7rM{MR z3a>IC1)~~v)so<7u&;jl8i+VmxMG5DOCy~oX5gf71oM*~&3qf9Kg>}EQ0 zNS)I{sfjQ{G1_HcULBypuE@8+&U&X^IO28J^%msn&b!W;T1OS>)=1k-kMo()cwtQ= z1Z&bvV1vedGKa3!pPRnS_p(&#xW2<(rlwJj0qo@6MRy(6x2sL}G1I3hsoKZ^%(N@( z5wyX@O969%I_4td*NaIZwL@AJ4dm;j(VbpM6e4$5c@<-GT;1SB$>IzvK^0%+v znDH^=odX`YX)t<9mRHzpLXd<}xB_7p*qEA~QcCILde`el8ZqT{+ypFx0i$&J_y3)v zDg3bu>LYzVlZPXQhtPp}BHR+xOgGqv<*8*-+YC<+>AWRHstxD^%=HQ2V1{cQES@jiifCrl(KaR zFt^!$9`siaj4q=LJ(J2V;y$9r^QuZ41&-2P^26Es;$j)JuC5p~$v826)SL#hz`3Iput!-xn$Q?f;0bh1R_Y?ZkL4o14e9 zCL}w`O7vNo4dUgq0i!H|7(0J08}_;?bJY}67}_r51Uy<#SWMjioV7M>I*l z^2E>?SyFR!L$PEoWe05P?p@O3h3ad^OD=v5&Qcb+K75Nxaw5U*WTAr|m$mP`2k(xT z7XS1$e;5`J&{&N*J?g)GiD17(5Vtt$YNw!O z5WWN}^K9jCypiJmtJ>kh4HO_m%5bVZy@3KeY>-zegK#Jsl$Xx>5AtVB=BfGbX* zwi2L~)Wzy3r9x51aO&VT4fhN*#b`w9%P_r z{vZV5Ob>bFSNE@UtTBCJq^ax4`I^@pQq8Cmk(t-6Ue5DcfKs~JFUT2sV|kL(B2)c{EqUI!(kNAHr04LBpHrLIm_h{_V?CXEbWE2lk@|zeP1HY>98HF@zE#T{jlLKWes$_(BW_i{-vpebV zZ^zr2nSRrb#?A(n-*1bTKG!~wy3n`O(9dO<`m}lxyzL{-I997Tx3jTCEYo~@@-a+J zDFf48$@Tpc?Xdb&DeR8>z25~P6&VZzrn-KT#bpc0?7h;9Mw0C}8ozhr-N*OvY{_Zm z3?aXgg4nm>5tdKPYd-U#yTOBGNYKnA&`}C0bu;hGg2T%K0eTz0{d#~)ZEfmGDV9Cw zIUC$K%*v17$!T@p=FN&DqA!$0MxmkyQB_nX!hYspt44)p*7HGNBS<;tE2{?~KR%xE z90^Tyj82QU|1S9O50B^UU<5&7Dcc4VUq;K)+(MXgY5Jq2o-Kv-fW0D7QXzh`O+gD)|gyk;@8H{Os(`%JB3uyygE@k+nQ$9^QO zdetR}y`g#}RG#&d$bIG)`G6Xpti=mM$he~Ns&ye}hR&PA54}pi+$~l>H6$gydk5lU z^Lbf=BQ<(n#kr_LZ0HR-^S@T@`(yQ?O_gTIQdb|Qu*z{SC2|!8 zfg*r^xfLI`o$}r@7VHtg>wFy+XS;{M@)D4K(Zui-p z`c|RVsq<@7ja}fazhz{gALpJrwe3!qYC61&Z48PjO*R3FY4Gxx{mkwWe{{1~1BRpP z@fowV<|F@Q71WJRY^n@5(7n`)o4h354vM8=hR)tE>K&3b>ct5-ynn>K=10JdL6o5c zr+Ji6#QIXWuAZ8j`!)28Qru~gs!{M8bg|+Ht2KgA`)dVvFkS{qF=d$Y01$+uf55{c z=$jJTD)vU^@#hKV+FlIa&;Nbk%+KI$wBW6MqnBpYW%J;n)83cM#A1 zo!tgsv#UHH@J!I4$bMO&MT0J6&YO{0p^ThpP;x=p1hQq3n_|y|NZ*m55qaS&Lb*zY zEd{pkb@_A=?BO%Eq(Q26IYA4?ub&Hf2lY6TXG1K5 ziUKQ|aP#yOuuZv)kwSZs2HHFx{W=sGg`^{dsp+rMr`rRUiIP;~{G6nL_VQ_X6}2+K ztQW%y5Me8To5!tTGU0c(8F2mcLBHAs71l+1TI_ZfrOQ3)yt_$Jhhg3= zbUrzdj1r_5v`yhrtDY86eX+_Xqlzm$spw*=WgMy|O=>RCMX997M~A1aKt0=W0|T;E z5Ksq&ntw=B=kV{GF~u06FUm221SMQ^o)ku_c&a^qTzZ9%7giL3NNC{e?NzAUg^jOy ziE5g*f~Lv~L2rM@a1Odp2MZ+v^UfnJF>R!8QzGpf9R8TUYAPw{fWJbzYMS0ooV4l@ zJdZmkk6T&m&gbvcuAVci2vSsdh%)7J;;pDKCn~dzdoGbVT(^}^;Y)d6yYho<8W4;f z1O@K00b9FgKZlcf9K2JfNDQd);V6x#qX8T1tS2|DS_7w`bYfuexwk)?GD5>LhduSG zj_Q=0n)kmUz#~={mKe&Ee+Hi|yj-Y9?`TTzYE3tcVG2d_ETYl)a^CIE{CJRG@?j`c z9!!?o^B;HPSC8RFYEL%72!r;& znekz~8S1|5|0ZwB*z=l8g*o``S6$|hJMc|aixmL=?X5EGN25_mp9ag?=*-}g zQ9o)}H3_Y0xn9Usy~rm#+LRhM{r*o~S-Dc&DCuiufKARIzr1E0uI0H@^na-PdKiC9 z&_yYnS7u=DcH9srkQ5ijgwewX$E`Vv{Ly70gVs-dMDO$rirrqXn!(CYfO>YzrUbP5 zP?rukc3ymW?|IRjAEhmz*dY1%-w$RM8JVuQ80V$ywYj(_t2eM>GU|Uesz) zWKH~i0wj&{oZ8BsUF^6rS3k7B8A@sA#a+sLDtu08i4j{(3yBc)oe1hQ#tR?jA_MYb zL{^#`%7$$(=U*owx%Q5wPmov9|_`ZDJHw{LEw--I%_*L~QZy3ALA1R%(wI3T% z6f(V27G!UzGu|hK@%r*+DJBBSO&CBt!JSjs6Z?{Y?YZC=(5|3Fck%%TUA{P)tTAS< zQt&*hOl|QzG7B%oqKn2tNLp0FYFL4<+w1C& zLQ>4mK$bS3B-r4C8;TJ|e+*2g=o_ZmylU|Nz)&!Z(4an*k%N4a3Q z$*kWbDk?k@ZVmcxEQ~IQXNaGNUzu#$(&}AA{e+^2sZmxm)pRP-)KG)HTR`l<$VIgS z&aSF76b&!k@S{}0A|}XVVu<@p>iFk@eSY_Gd+*;Wy-P16(aE9 zg#608o5>UXJiAizM5W2sa6?p3WqnXPp4n&$(s5%SsGM?*L*{%sBH`(ZUQ;j*F9x**Z`e7y(R2|TPbp+S;*9k z{ZYr-ad~xhZnX8)*5arLRGZL+^e?b|N+i`g+~-d;_x(jE&9WHIEqw_JSr}b?gL`P1 z+~SqtNFn&o#)>L7NMqAxvZRRjLlka}s=+H;*x#5cJU_)=qkSBH?T5#msbBSmcE6mg%TLtvG?TYG>QVUTgbcxnaR7hzHsfz(j z?8D=gxPeF7O;fZ^+$Dga=WfR2q4Wl-9k$5kP>AA36YJ3cwMN`x5aBSRfQ|VTjJMU- zwFcI{@99C9`mZNPYOD>kKn7R;Bz+@p%%{khYqOpj|J?fzG4E2Hd+1V~TVhf2fWLKR zVW!Gv0PBgVZkTkZ&~^Cfp!pOJD)Xa^Ge4pRo-fH;7PYSXOHr6FnKD9Y+BVryaY0S_ zNho?iytxu@AYZWNdB3Zh28755=*#X>ck&YWQXKlfDVJf`&dFCitw3$&&*|4Pm*Cyt zy^6Fm>R$Uq`)zs=iY!Zl$NH|W?H-Fhi(todvFNgtC09tnXBWFZi|+iZ{-BR8u*;En zk(hlgkh5GxGn#}RO44(F#9^kR_}e7cH=o#pMT?LI^mL)fsG?dC}I^9o3FavuEMTEc*{9#3` zzgkE&mIscBYX5Ls_W{E5`IDDwg=!$`byUMgMojp}I2hSF^%Cm_N{L?DxgN;>o*s36 zItUU<+#Wet8m#`K&9kgZ=vW#0VTb|^$6W4NjD9@>K0^p-GA9;S3EN{2{t`lP zkLAc~NLMWO7{Js=hH!~~%-kERuCPh8ZVwrV$6Un16Sur!H^d)$(hxS55-6lx)F0+3 zYZg05sbzJR!5P&MPV}?`WWY{K?9SpSi}{f7tf`7lH^|(!{{c-FdV$4;Q7iuuOkB2D z{5ya2wt(^R*NXI~o|!!ZvS5@SFNhCJ3&`kZ2EBwJWv);4&X8DBI6nROKAWHnbog1$ zt9_LPYCF()o(|tBjimiLEiSf9ifN<`b__+Ar6XbLI>$FUrUkiDa^}Ji4AZZ!*!Me+ zryMyCO<&#op9QR>)}D64gM|O!kBOFoGYGHQNk`(~fH07jRcLHJs^7I5PEY95ZwYxQ zv3`y>RZZi^*%FGb)m1~%Kq{{p1@kN!6DW-=4aVdJyh^#s!HWzWAm>T!ve zCZmo4r7JCbn?E+G7z>=rLDEuTiD$aIYfobg>9TqOlJ}KAkw|LW|oS z=@GC$kE5BCYEUMHh`?U)d#`IQ(jhf)UoT2kh%2^%AXxbk5fC%6zUICrJ_r zr+l4m%K?_Ia^yYJkzL@gr<~hS{RwpRD}DI4#!|VX*Eo{NuLC>e}Ywkr_jBdG52sXLF6= zF{;PMzWE=%q>TTpO~5x(Mt>gCi3(etp89naUBH>hW9=GhQTfH*+k3o0**ncu!V&2v zp7=_^rP;Nl!WP^kQyW@5e5FBVIzbdhmWs`%4WC$TJ^z|)5n#OciNHzM&1g#%OFwa% zQ~#TLBf*yG^?x=AyuepY@-MXNZ%~CnBbFsUe&mn~&ig#X3e|M$mdA~YJ1ae|q?1fb z7yFj4Bo9t^F^Q)a2(^rtM!C`wm1DPuSD0^UF}_LhGAeIf3a(Dg$l~e|rDqsXSrLs?uKieAo3=-^_n7oZvfq zZ*6){;#V5|o-g4HG&$o?$xca$OqoiE2d`=K=>}|M*R(WOe3?(8nR{bp$sd3d3(E{y zcb%0cH&wo;zQ>_|3wIm2L%Yq|;NF*a3xEMb!-6OMw+X+B$fF1ow#F*qjQ8>#fW|ge z<$kTIY01DNJdG;6*4XU9{eB1Gsd%hP^;(gSViKC_&~MPfv6SS{KQOP?tas#0q;u7{ z!V;%k`F-6-T>sflnfwN$1K+ri+u^Iklgi_f2zp(SBU+idsceyNnS3}!i|=aQBDGe#1fDB>dWs2hJQ99 zJ!K#rmlgNHU2%%ZWwS5oa z%S25B!{w%XBIP^PhEJIIo?TQRvUrU)`aVsYAh?{#fNYhyFKJ zg+j-Us+5z8}M|mm_;*3TWi0vDEgC>G4mI{^!UddT^j)_)N`#H9=l40La}Q-JlhN* zdQq{TSwdcyr~h_TngTR;qiTP-f6M`V#G6B_JXr%dRRF>;g0Sf^Us6?~R@fMYXna}>q`;*7vf1T&MCyyh!1fc*`8Pb>-a7A!(B6%}0 zF>AmC&HeYIk-`5Q{hc*U?xV-Xur3oUO5f)ykx%Mw8*|eCyq_b-8{=+oNxkEy`^oP- zQ4Xocvb=Nx2Hxwi{vWNWpjioz3UP@{Z{Xzx2I-4OI?wQ}etkEc$Ts#2(yyKxYjm!B zGH`1!m0thriihuapcHLb`&Ec9!fQPs*a{>T_$p94#K}z;r=&}Dzg%I|bCQv0+)8LP zhE4;R^@W;4rLBHZ^Iez8+J-^!U(VE>{NA>w^iLoZ!qj`8%K~dD_2|qReFGZg9Io>c zkhL$8A^t9tQU8nBMb#6&M@+!c`J>f;zWr_X*-!Hs`?V%k4R*j!K}e7QY&A$ETy&e| zn^*tO+o3bg#ti-6;!9sXgRq+jp*$;B`jl#H&I&Mb{ASE_JAu-SFY;RMJ;w(nk;E!O zqaIb6suV2@U1r>$1q8B--woNlwfPJTRXG-(T5UW-B;y%t5f&BRk-t$&;ip;CQca9; zOpxRIz%|B&sff*F$BwU2<3cE-s>hheH9U#(@mj|vmf@V^T>aVW5?+zGtsSp-{LY)k z6{~oKwC$oFCSl+D==tDlg7t&bMXAscl@j7m2W++**ZqSosO-J>sk00inn@7qC2x=M z`_mS`N%ho%(_;RBZJG3CPQX$T;NT#+pYSCW$Ba-yMp)GMt6U+ifX*tz&E@iipKPuF%XX^v*6bYc0l_!c5=qb> zNsiH!{YKGRoG=Re7*lr4;pY=q>&uxz!*9fvYDdf+WyS2FB>2eAuJPWwy5i zNSzV(k9m6Xf?t$Ol6=zw+53g}FWF}9@#Cl2a^d#CTF{%~>|Lu9>aS&tCA0O|)2eB! zwhLy>{!Wu=>?hRhEez6(uNBY4i!|b;=Y81OagkAPvo+a?Vm6ZMiI-T^UrHm0R#ZpJe_u(FALG_DO&s5W}fGb>CR z%noYvHhaP=sPw7(p5=%i!I;+N7D=QW>}%Og@-*7I)%S=Z?#-krvcZ}h6ejmkI#GDT zASEq4vOe(>w+CLVYGZ4)$NBW{-xJy5-(^csTU?IUfJ4_1%yI-?GX_Eq#JzWS;c-J2>x~MWu4BdpTed6><#%w!LI%qv(qO;_D7h_*RIRk8+S7vkc&4K24`}Wg3hrtY$ z*qF6Y1{&qRcG`5VZ=Vw+PlKb`>dA+JKH}FLTjD>ovZMj zi2e@k{;y?q+2%Q|wviH3cg?beJ#KDx&VR)?)`&8pdE>fu7Jx;S zl}WuJPZ{m|#!K0LYypJAZ{ucOJ*1PcHJ3P1^7!sWVtllJHcDZ%xq_pxQWETUy+5MT zc>^S+@4viB{QS7C{_r=o^G49@Ve_A<_x(^LzpsCzCyAqV~=f3_g%0Z!J`LA#cq$R5IF>1rUAFL3AJUdcn}lfy{(5Al@SUo1IYN z&WolsJx($v{c68exjCmM%0a8%RP>DM(d6x2qVK(_OrKGU0{DmwKOYSw@nq7pV40r~ zoBgmaU#VAUky1_S9Pebx4>TX>3F}LOdnk`f)qU_TghMI#v;KUF`0~K&6n7~vsb#Cx zmfFs^Zac?xW%&CbS@aK#xTyv9SXm)2TsenE94OZIx!y%fWsypM*-fzC*m8nUzDhIwVklYd0y&jpoJ8G;3z2>ZWul++vF z3^}qgSqr`B$7ikRx>Gmy`7?vCg=JacR%4Z*yaZa%l|&cSczZX>2?qAPzd9YHA44b(QNa1bUIeP}0aBqf<7vKfC^n;Z zZD?0>JGUMBnVs*>@mBDq(Zkrwzq60~o>CW`kLNa0_oKPDmz8%Lxsi_r=gI@W7VuP( zl&t8qCihhU>>y9K4Wd&3LAc&(lgpb8HEGZaSmxYsM{iCHmdVF%-3Ry=AZ15P zuiZ7FiR@u!I%k&FS+e2PQ0gI=roTKit+eLF(Y121>pQR7m%Q5-$8#9r4eE(Ck#vRS zw_B?H-2%51T!ZORV?f2#^e+}#BBzvVpqX~5X>J>WIm|2hZc7(m4Yk7nKEb5NYszbK z=CGja?#JiH+sO|XqW9Np&K+0(eSn_z<-^Efjl|1zAz1o67YGyJN`@^RA@b8C$hc{c zBUg#)*2Pc%&2)}eA^9O(EOl6z)7Ax?fUS(EZPHVCGqPhwJmA>zaf5?F!{6-Jef#M~ z4Rcxn=ig{59**xEBkaJ=DA*=R8`(UkUtlHz8!eV{Z9S2Sn5|c6HFLTi1=}p7EVpzi zzq_eec3}QU3tPn#f&`I_6clKuTh;=xuOyg=6`F5m)nBC&R}5nM;->|)vgdJ4RipT$ z9aIt_jbWz<5q=}4H%hmNSH$OV!L0OWc~P$f4O0unIbXQ2gEqdh3r5Xc$8(oI_8| z)f{z|`>P_j5{FkMw_l$;O{b{DkptvrIF?*8qJD#9o|{Mk?Qw*$UbAsYDL4PP2+g7h zyM?eKaiN#naxF~{ZzsqFJtsPZ#eGe%ue}0qK?zypk9ee-FVPtS3L^;;I)MZI{&n^Lw~M$x*ZDled1JX}Jd^NUt) z1D1s0AodYOU>8LjI}5Q6>DOpzwd&{Py0V{J9Z~!1(C;ic^WmM}O*X@0&~fEsYrr1@ z{m#GteHct0#crZa7-aZuC)C;XVGzbN9&LAps%YzE<{?@h+CnbL(}Ved>nqPD+wxQz ze7yozQzc_+3xN?4VEVgGozKtxoi>%UodJFO(T6YSXA+*@M zcuATdvUjTG6;|PYMqiZJ{hqsOG#lM1>z50Lg>2*cXp9lBK*Z742}3c^M`#(Roo(i^ zOz~3B-dHlLa*=mAv>Ej4y8AK<&cnf)*(Z{&RW*da8i27#@?a1BN*JG0{#JPcc?_6m&=IAx({UH z!BN7xm1U-zLyk|xt#6Za!p(KH0iM}sI9E<+ic3Yz&5%RM&8Kcrz;b+1g0IR^!dcOj z;%GB$S&{(nM>GH-?+Uhxbqt~Gc6yW%OrY=go1k#!ejl`8^bgZcGP>`pZwTJx_2%JW z-Pa*pv7V$Z*L(E-xAJUL zszVVQz7#4kB-vFjdH3{%`z%8`^Y{Rh#O7yQK#sS)$6)h;UGdQSd?oEN0)$PR=1AI% zwe})@Ab~q|363-nV%I9HRyzi_RTxIBXxlmIjEGY2t@ba7`+Je=bvogEx2%pA zaJ%muaDgc-Eal>cc}`FWmvK?GqDc+usE!^AaZ$yW!7jpnsmOL$Yv%PhP~#iDGi?EC zk)3Gs20})nO^9&$$qWZ*0BM$KGVCB{cUxk&Q@VYVV zBvpr77>R^EgO3y}U0?bfP9mqACVuNl^e-3eOBtg}iG!G+4Iqp77-e9&Q@_(!q@}$J zUi`c%!20C}B|(B9iYldoL}O{?2@;2AWtNYQU9Y4q_8h#0^deE}UKuZ+H|DKVNX?ka_m}4z zoiLl4vFmxfrB|^ZI`cKF&H9C3*?kIr=)ljbrIKn)-laY=&VRAw;rv|4y`k!rnD-Na zDMQP)B3dutmQi9lC$(=H0Q^dp=6NqmVB|f_#W>y4aq)3qbB^l)TS^OnyIDMW-g*qp z8L<}Bmo!OtR7kGZ8!R4;;dW^E;L(?qJh~>YWc5ImfcO+RQNV5r8eO+=EF+oxZRxen z@jOn!32+nx>i&+1kNkY#d;Ig+@pL-phTy9O)|1%$;b1-{p{)(R1+*uMoDx8ZN5Trwz(Sw0V zr}StTony30i)`#$%%4}n7N@Q2No1Av$gIlHB) zv|Tr`cmWJXi0XTqJc}Clv5&XND4GPfwU|KVa|a=v7gKW^LBZDtuckShw5$XBVJr>& z@1k4bd=l7-%Kc-QIbd~mHmcb7J(p#ZlQ}2G`Z3(4_#E$~nM5fq+2|1t%p{0cgOG?J z6E(^2GV(~PSB7u*OTIO{wh@{bMjZ!7Yl3!$nwITv?h3p>>Qhr#qH4{pPb4oQ%C2^V z=Z|JG&H2y9dazW^xtBu8o(f|ble;(teIW=)9lki-tD>)%%lclzgH_Mxghfax9_UdQ zzDo2^EO#LL%T-!c>)|C}2L}E#J-U#J0&vk+mm2$PL$LMC=EZD}&|IJHIwKpPzMHdm zD;Ts`4Zd%1>-}+-T$iy&+Z=3u&^I{baj?JG5}VS)*SBCTv`12r&{6i|rQ2ot>+mGu z-7-hf`EMjmw~smMlIQf?d!m(d1GE9yWPq%$C|jfUW8I6(5bZMh({xxp&YN3y=#+&* zL>)bc;j4$a&D5kEruc~N?aN$>gQ$Z&&u_G@BcpVYM_s6AS_wO)*q&fK_NtT z0joP3E^85}4dnXy*BNfL5KN>BHeAxUuO2*D2wXQpN zYcDQu_G`ias&D&;d#v@jNgSPj8yo=mzeH=01G5o)m7%XZKlWXCfnXVZ`b3Fb#kR1% z(@`lao6Qaa!D`FC$arFG_T1{~JKqae_Xd;P(uPPndu2Vd23lvo0m$P~n66;nZ}_k% zg~YQ}O4NPQ_q<|bc7B9ygBwF;J!A&*Rd0!zBaa{_M*a`SpIBpn7E576P@`e5*tG`z zRVMfY{6b8EXdC8VrC|@h6GxL5=fm3{2>I>AzCVUZb4a}c4PRJr{cOY9FT{G9ou6v> zW_cw<1_cn)MsiqAr~<>|)MsrxoU;7IX`&3-bVUh_TyFV0`d=H~ONXjC3hfY8mf?Ij z=?=69wW|pnb}#!1HpNbv7iVL6;oHoCG(QegndQfRK-NCb2^4wZm9;-oB2sLY-$(iD z+

    |sarNXYH~k|*ZAEL%*U<;=d?srSTb}U;HQq-B&Wb^$<-Z+)Tm8h(c|dS^jPfhW zo|^3UtXn=-&FIm|$QQ||kU73SY7OgaH;^e-fLZpf!Mlau{1O$9nX59dF4S@D4R$wp zvFhwrZQh`DbN78JTdE&uuy%*7=J)d9s6-))H8*nr5WmEhwu?6)L=sJwf>05RoU;zs zj3TQd)%=y8WNbjFc0DWjY6PJ!D?}5Iz?ianbqd2O@?*-J_5`fgB>mKaoW-RK&c2t@1J_VsB2I=RjYVg-G=mgn! zm4c>Oz*A2d7!J53q7Hc0wyi|^1bE^D6oSTw7ZY=Cu<$in>*0K~e!rU*6^gIr&E6GF zfqsYd^FRMpANOWF7z~Mc^WVBBgeHh+Xw@oQ%Fs#Bh+7rcI;NV8=8TC5kIF%tc{KFJ zzZBue_k);f00aiDg4FTs5h~24Zba`J8!9*7H~v9e-vpU%B((`h>KOUx)ijD`$`A2o%bHy-s@lcyVI+n35)6A3Rsh?q5l{7oQxtcKd6&LZO?(8JfOr*nmayJ=4G=4oZYM9vuR7?pQ#G8+QO~g z-R&aH`iH$O6|)hyw2gE+0B+ce8R>`Xy4D{&Hh41;01Vrrz)^tt6cA(z)R%3$VOP(A z)yeuC+vRWlk0t3MFF)L4;b=g{?F`v00qKzCW*v5eMLnE+B2 zeiRe*@Uwtw~ACPa6ES@Ww@V-7&8`MDz@kTKGy(P zF5~eK-rB~{XHn+PqCzE|2EcW$%W6-YW?ijv(kUMM55#sH%>9SvcPRux1c{_`6`$Cd zQ0_U~R4?c`KF9|8#~RtWh*BqToFlqpeSDYku#Rp8?DUckZ;N=efDEZ%4|i-&v>a19 ze`Sh!ICW?*pX|QYa1i*n`rrA5^0JgptY34={cI(7k=f zPj6=47@a3t*a9P&mQvSMvgRnTx&WKss3f3>2PQeKs!f5W!I)vy6kV^qsZfMifpsL^ zhXYuOqE_YP(rxc|fwkW97N@9x@fr|1)}ZsB!jPO!3|humcgUrE+Hyi^8wLquaSI00 z1ghK=WBt|JY9px&V*o!MGYPQ=ZEX=z#Is>xC5R%%5_VxlBEbtwH~|Q-+12p>-|32|IZ4^Of1`8F7rii!xZMrVEf#50O}{Q9wP%Hb|g*U z4_n7ax3SUBr!G41Q#89Xls7AyIRybh;3WrX60ipGAftSU8E~H;umy9TZ8t3FebRKI zxNyCG+&B$rus?;#b3r-!vXA-ZwciCTC#f`N2YBN=DP=bi!4W0MM+D5j=l@53u|liA zdli*44BI#N%L_|~WEZ>;T$un;;-;XyPbNyjgwYV+HE`(vD`8^T#F*c`Yu?^Od@J7&+ z56}vmbgBjob!rLawNF?ls-$cjR1E4qHcz?V$~GO;_IG}UQ%#P%*J7S%bSj8sbk)8V z3jLD*6a&tZvj0aDG)2N3yOxbpy$|1LZ6bI(v--ZEEzyl`o<7&2ZZTB1N5(jU^houU z)bGRl?(Z{qRkGN69!8u2WqFfx^KscErq$?2ZW%BCJ{nhXB7a(=xQkV1J@96H z3niKtz&z0pBeztz1m%J+%AbbTF~7s@SCTi0TCsM{XVAn8mm^Dq{UG@OB?kQN5E1xn zgkA(1mnK5aHV(M`wDOr4R?%Or8KhY2_OVQeE7|rF82C7Pr0RxQ34G@qWWnMHdA^5{ zW`=_(!2?4folIGpE5TE4#n^zkwxr54YYD!G9nRh@1c8&J(Pjg%-MW|E8ziXg00hW_ z=N#X3Pec2d-G`B(yun=(HFip+xrT>bPs$E^E4y0Qnhn+srv%;~h_Vaui3$rLHlwo4 zAU!Tf2-gJ~oV`TyYAql3FFZVP`Ujd?*A8DUiVCosaE6poF#v|U<$38$8Z2VN($eof zLrjuNR85FyH7SnuMtub??a^sQyC$4?`pUAJR7(Hx$|bp$SAF-NR7II2*{+nwowzVv z0k%%8;^NPvQm&ip_CDT3R&qz2VMX0%e!IhZ8f4I9yC{ifM=j6>T_mn7i#&~94&%Q! zdP!m?k5y|aWARXFcy#P-#u*u^>^We-7>ku=GW{>)Tjpdggfwb1@nz5RK%{w_TF@K! zFJU{|c2ftm@E7tGntB@?!bQwJ26y4RcWFKl*VI2P!AxM)RC42dYHuw)|ZK1~Bfn**853)NQ6CYl=?$PV_;utueY*fQ7LC zi~B*dTaMA_V-jw>fwmyP%T_)an4W_)*acBj0UXhYZCSDA3HE9XjxZBp=HoHI^lFx1 zh=dr24K%4Fj#xWa!yKE%eW0iXu~p!Es*-&%1MfFH65($eFAMp-yKr_3@4W{`)`>5( zpG|b@#!mvQS@;F%gS_i+hz%f#W=8c3H=R|7h~7jRTGAy|q9TksK9nkuS0q%x z;Or!49dryvE)}a&ae4bW98VcrlI_n30LedvyOM@C0-5IX7+0-Y8J#nRxxe*?pY7%3 zq6#(DI9vlMEFbn;;l3;1ky57u{3Cd4s^O@aMOOTemkdn~2V6`qhecD~b2o=U;&6R` zgn%mC;Z!*eG%ZB_Pz#0t@Yl}JS${p-;UC$@5zo=zs#Qi{HpY-#u%3D;Z-z2LtJ%Et z!ViW(YF+1gUp}8GBFa;!k9bvqEs=}ZhB`dT>AyuDM1Vs=JKM+t$*D@fx0#I+Nrz9~ zxZumufR?I><$IpD7?;C2Cz~p=RXG2QfFY+b`e~5b=YqwWdRn=D70`a#$Hu4Cd&T2R z1WQKR;UR`iZIpb+f^VE;b*Jw0dqsLu-Tgei8$DiMUQvVEh8v#g z4~?tqQk6H_$(jv^BV?M})ShPI+5$$(WpviG(MYwBf6~IX(eG8)k1t^txMz;+}c8z?KM60x+WB!Ku)KR3($GkSv;MhYDMrI%o%S1T`) zxVNi#^BV-DeJ#_~VT7)FvYDs%)i9?FwikorHu63O2+=GL9L36ns^*lUKxsgv58%eZLUHT&xxNenEibl z*HV8}BM!A?ZR2Yv&)F_)qTu9{4k-XGszf@WWFSKrK#dR<{PMlqr6(a4F z=$8JAV|mKqZ4WQ+x@l*}b)ohsgq)1hqskC8yI{9@AEy9NR1FE401Z0 z`xg>euH5i&^W*GD;8-F`IVsB*V3YLcOlG>D%k55?%>De zq45Saz5=zH?ahiNAmc2`iH-=cz1Cu}Di#|98&b3xBOkG!J-DPN>i3$YhjmO0?9!sc z<*cs#w4Y2Jp{T%3F+scy{wk6PcyI98X`Jl-YSiek@wYpReNtiKbE|Zcu-^$j?uL;P zt{A!T(U}nYViOzVsI%hR+6|;pzAB+oCB%F2X{rM1u^NjZ%H?D(eS*Ak4ZjHexwDyQ zUb@z4Ue`sbH&{J zVccaS&CNmwqJn)GJ>ogi43*}~N;Xj*HPhg>+eVp~v3a$&)jssR34_buzM3t3YXhO8 zR|ec;m!E}{>VU23Ax?K&(whSG5&{IhFRzC$VO6gRLs-nhe$ZSCBZxC?(TzO*=D-!i zAt7lBi9WCJj(RKxlP3{yKI1dhkt=#%^C%bk+IVY+8)87Jr72JW{?(6WB#A@j=)ebVBac{1Y%$hhZX7+~eGkwDF=3 z2rww?^$V5V)DK&7mN|(l#N6kakCVso_kx7ejT<^@SJ<_K3N1dJP1*&YVZjhT+4Aao zCbCeEFgz%xcfy0W3$pJfiCY*2Xua-qa6OV zD(t3N2BT}*Pm!a#EZck{-^ zv15eC&MP2kI);A}x4*90?;t+j0viwx+wppH{`Pm*T0YsN&_;0K49eSf7r3U&uR9sX zw$LH2;QWSw1$llL=J8^m)sr0or^9;F5<6?=m0AXeUsq zYFe6~QL5y2i{oKMGE!Fc(m(|KsC{;I3Ye3~rzt^|-3i8O7kD3P`{=EnDW!}= z3*PveCCF(Th^V~yL=_@i;5QVTksv~kmdu4J5$u_wUM8{-+EELO<1&<@>-1u&;X({4 zETJjo#$a*BvjHs9W%him<{v7t}$q zgUJk}gCrm`& zf52e-PLgDygO0G^D?+G)%u>|>Wv)#rOpR({!%5-GMY*ZYP>)=cu7DXIc76hp{nueKS2El4<8!Z|~85Vkmb{TQWt0TZu z2Py&Ix-9UigFNGQw8&BIHnN}gdAfZHs30*$uY2R!PMsLm!-(ZDkxncT-XKQI@Nt-T zngofr($%fC&}>;%{AUYqiv0-p^wJwLJ<_aMwVfY0lqB|GzR>)Mr=R~0`haMU0(fLx zv%rMBcKJD1`=o5&CAVn1v-#pNm#uZM`C{oM{N9ob##g7lz>mp2>oQ{F?pNu;N@OIREbJ%ck`_366WIIertNNf582+9ot{^^=) zi}35sMp&hkh>S!s4EbkqTudzK|8H{m_sjok;%Q)ERbm|t&R^N^i)EQ>Qd`k0QQY_o z6h96IO+L4b&%`LN_IUB9`{T z$>4%$4glM2=qR8e!1_cROs5edKAtF3{33I`QVHHqu#Y*w3F8C!WxC{3qFxgmyTiHQ zK?&?UgSJqQB!xygvpR_I^k@Jkuf+?kqy`SC!gKQzUKNp{pdI?e68s0`Rq-$t z?F0D^Q7?WQENk596p~u8G`X9zM@_^Y56!36+S5b}r97}$te+hJG(6tKz9e8~cLd!IhB z?v_cZ>#&GOVi&89RydJt@JJ*%%2Tzcz(z|f$A<;`F(z$O|GQ9gV9x+aX0oP{N6jsW zyN6>Xul^t6#JE@9)}&bv7BWdiDk0rW9y!D3q+pnxrcSm{>iH?t;v-A)tfx z&aSxNO*7}`zg`ECHvF8E&H{_4KwBF;IH~nV(f0OV5^bkc8B6P4<}uwYX*;EJ%z<_| zhdoawW?ZS=`TK`$H7QVE`@Di$Em?{t7x9cAIcu_}+ia19*wlO2V3I}OPcWlvHTu3< zOhC*{&(p%X)+Th&I(@#TP3EIbbQ4Y{IpaLGwfwS_&txiHL|ZD0ix-%mhRw_chqe6( zfhh`;^-0jMy@kpW>(SrlnEyVtXfnkhK4Zo#iz z<%>H~k4MI*G^w~Y?3Y7LhltyFwug}K*RwPWjs%|RTJfH?@wst)=nTGj1h|B*-tmIw zQHr&fLF_8K83R0RozZ8%J{D$SEY#gZY*aFrZ4uzVf(z{Q(O1*X^l%(^KpK>57UAV5 z5BsaNwBRD3vzj5UBBXyEN_J}?8x5jRRHHZ<|F5^pYUme<1A}T_G$9`_1b!65qBxpb z_l=nCtU6Q>fsDp6`!e!ffl+x(Rd`%@%%cgm3=IfQpHFScR|*}4RCchNdFg4^ZeA+& z(zEM>yc&U*|$Ee_V=Ju4@PL(*YOFr^{lMwXy~K;bRFV0^qKA>C|vp*KhQdwSwN+uXO+Lk zs*383aqW55djmXGQEq#Q-fqw+EWPAA zi3Oo&PT#v!R1y{%$l#vZ#gT@}Rh*4r2yrSUt@yEm5sX_SEK1g^mjHS0> z9@R0-mB^PAIoBUyEijESYklwnKgLc3_=&eA>#SmC#zTRjC<(9kE*uE#BOc(I2c7OH zONBi#PjGQ)E$D`}hrnCb{^I#NI%a{5@Jrol2Nbz~c9dPy_N8a?&sl@H7={Ey(0{-( z-nQxtNVTnZsr|TIcH_8w?}IJ4zny?3K6E^ZgGXeX-5UIMQC)sZouR*98uBWT24!M; zpUwm_R^ra=T@;%&x{?(fk&<}m9Jj`;^KBemsMpH&+A35FV zDxAzNw$w)5quKo0QJBiF-teHpX)#}q7o6bMM%}snYk$&7QH=Rhuk@ z4cV3QurJu<9}74`vii?hHa-ug)zg!q{&R!stENVA1$hMe7pR23Q{#$N#qqDXp=_tA zsB+MyCbFunQ{M^#op$$r?s7lxLjL!j}w!J z<9d`O>2A<*Lu$QZm6~E4++;ydjCOwznU34{X6M3Xm2Go}EjL@_87SeeMZBI{Xisia z2-+>W2y6i@eJr+v4iqP})!y4rviyy6;E*TpwE^M&CN8kA%~=&sN#Yk_ zlZIS;hLqw>0X)(XGj_p3Pd3-XQEgv~yVRsl9KegM>AXhnwd6cCla_5OSB&@IJYe5XQ*iT7Gg3OXI^OsL5>gGjqLvmgu?LC8mpVzfZEuWUg`JB zqZGLvqN6T0*1}H?o&UufZ3tn~hQ4+(v$C46o zBHRvG+*k_y`#7ATT&Y>(I?ZB)4UcdO7YXP0~X_3o+B(< zMMt2bPh)k!k@LbQPzMJ&K1+O|D>!Jn0nYAQQj~a1j31?d)B^Sp+2swpqlAnV{V<97l4KIdOqPgvuOBCwsR( zdov!IWihK5jKR2+g<0pdpMdP(7_jXZKp%sPQqqe?7sh{oBJL-Q1!LQyJbBYeX6KOi zjUPWcmmFuHa8oR@J%-Kvig2DIB=pqOBG<~W8F{ofxzA>Oo`=A5B+~ikoIL76PW1~l zUiyVntW%hCFfDGcuHS5)g9?FFKc%TJZ}->lqwTa8>&{)jrcq8v)O`_iIjc56rdqVR zTK}Em0-#ops-0hN;{NYx#!vB~Wwc4`(k*owy7k^hISOLb zdVOXw_+`u|`9B?G8sV+R8BVP2gioZZL88n1Hj}7r`V#A|bX10fSXMq7?mRbt@p=FG z)8G)!chORQq5flq6B0A<_Cn3wITfbfzr%Haw?*rZXQkf?k8G1=-gX_|BQGu~Pp*z1 zHXWLOk6y@fJHpLA!{evyaKSH=&uiOK{X*qh-b|eygtX3LAUn3&9320$%S&Q`o(wEf zJbl7Ex~xkzAB0JUKi2Y3tV~#(Gl8hH%VpF`ZO;BH5Jvtb<6N_z;pZdpfWhx`KkvX7 z0N?N%SVkz4yMEhRn4#&=dMn@!!XO#U9X?4n8SMlkh`(fNha5lR3@ZWf#T%#n|Ngr@ zJPcp33f)~cMH1`VPKl={h{j6O8!I?{KRPw9vuI2ro}IkO{g8A|#NGJXDppUK9&`rm za`%G%a-<#FHDDUE+Bym4Ps$aHo9+9%Lys_k*=moi7%{#l@sAvlb^L*RHd=i9PGs2y zVkSh}x5eh-7)#x4Fb^fV3Ffy&M_AJlVkFayw#meaFtYiU6bBaO^AB3(XxKhm5K{XH z?SGfjucQ7zdWsneZ2uJQholr>J2ChS!~V7;l)! z;%yb}m%7xq)Iotl%WkE^FqUCYUsqg#_pCt0U3++&!%&I{rJGy8c|vBb7Fid$lU?hy zl@Sl^PmC5a;wUwW5Mz)BXR>A&$8F?z?LSJ#Iy(}`qatp?^s53I^kWsjf0`HPc9@K& zXkOtlDi*YjAjD8KMZ?@VJ*<+1F^JfR$A-%jDkQVH?|A(P*wVSu_ombJvUx*yk_5Xt zYo`1e5AO0~Dhi7-$GZ==|4CwHy^`1tKdYlY2?+1WF5wC~IGG8%GovNP8A(SBgwCNh z@L;#C8Ik&LoIwMNLO#auu%@m4;Jtms}Rx2j#nb%%HSd0bjd9Z||`(c*K z5boB`{Q9Xb3m)~}G?I46E;e#{zJ#8+g0P-g=NbMHAO&UDdIMi+A#=SxnYu3s-Re3rgS4 z&Mw&rjMc^0U&a|j#7k+6?#KcA6lepsp-mBXv1)d+gVt3N$gX&gMayLyafw*sA&$cY zEKpVx3ti014Mu~Sb&>LT??3D(Y5aS`;G?wFWD#0OW5lTcOvRT#Y7m|)FzufKT6{Fh z6JsS2NMy|}5Vw5v)rL1AwvNyQdl+-f#AI9Yz#jm_?%RF4XW(xySMzV~@!+7JSK!Bb z9j)1GtvLrNoA@0Xy8?Sxe(%;3CVv**{#v|0_~#)jp0}3kCZ(x_H@9=J7+1;@#5^H2 z&f-(>SJe*xX=cvpjn71RjWOZD)&^0%_8@zQ9KokX*DS#f?t~F8P8-M%v|Bq2V67{`wD%3er9FILpPFU zp;&isL^Cb>VBk|#Ju*<;ShVJDuA^gN-V5@NV2@xOLt&E9#@9mY*_!}$TN7&Cbp-CP zC=(C}g<1FsqbKV}L^0@j3`}SadjM+L&$v-$$VLZz~ z&44>aOeEmTE)0n$w>u%k0-2MUi-ScNx4XAu^PbTVm7jgG?T%GL+vALS;Rr;5x9ESB z<39cNJ3At6Z&uS*vh~pUk6I}cS1L0RQa~X{E_<_TPU&byzf!h~)J14mGL;m&htB9sFxijSGHT;XEujEtg=S z;li~;OyCGpm4mAwA2*l~Zl7lA`*9Rx61Qy#l@m)S{7qIYhoY2NEhAB~&v9J8WhKH} zL0gNu+-+K_$*-uFoR=bJdZ z)OG>FMMJRgW?TCKH$~%-`U`-^@*WR;@AT{()mlQQoO4VoUC-!ruC8CFR8aTM2)oMnbp!IiDJeJ?>aNq1ZeBG3PN_0}K2FJ7>B}4YH%Wmay_q7Dil9PqJG25ZNb~)a)Cjk#$lH+U zt=Ky%(^W&QB=Ayep<14*Bdp48s6N_@*v|+lFTy(^Q*HFK1&@;ZB*@Jqw?mJkV7;OU z=55a54Og5mvT%1#tXuDtSXR(`-eKC3hsb<7_lP?v*BgQ_RP==Ui zuG-nHO&3SZ?-WeD=v#qPjb?<9eUrd95pv?b#ezl^$F{h(pJ-s)56C)UyX$fzTa6iv z*`Dj@lwHU^wrk&P{rt|ZQ(s@Q|Y&q;QR=Rdvz=Y zEVbCnEWG)+&`*=H?B-9c;=r-G@MTE)<>LA<` zNT8e210&7JVtt$iP!s=hCsmjD8(=kV=ovh#74&|~F2Y$f+<_)};8VJszQJ_ zGS^#v;t6j)uk=2O&vd`h_N5P&z^brJge}N*ySB`zHVRLZQu431!iMF(t+lY9Cbtor zT^2ZzuXOUH$-tIvaCijlEnsJdeuk9-u#A98 z$+!eI$AAXYhW%}Ouh{`Q{q1DyU?${UPs^0*AZ^8wSGG#eaRFRBzBo-Wfa_3KpSk#L z8oOe~#4ZNI0t(`bu5iEAsab0YJn(oa;@-LPRnm;u#TQQu`SA#6O#mJ5@>Yw;MS!8Z zXU^o4(N71SvBiaHqZ(iRWuH<6*upYLAP$%I&^z5cV*t%bke}1GK?6Er1FQ58O5&Lta4(oI%{a-K+ zxP$ANttxZ#+NaEt6+XgEz0Ww@^$!WiU*h@g^to60X;Zs?QIawD{*`@ex~(5a#%Z%j z*Rp#q+oUM+kgpP+2K~9Kshe+h6eM)>4*j6zwsWvtKELqmZ^Osi%$aa*;h|OL6Y0xu zpei5A_WV zyBc3qc<*-R-}H*+3%*v-RqTSE9(1Sh_*Tw8>p|qhLt8!{(^R8%tgOoABdMt?Ij8rO z4o5FyJoT1|I)m(_v~S!z>dcl*tGro^jbm1?y_A8Eo1e z7oin1>$zPkH$DzIdAoS?_WS&p+3J_vNpmVwGwu~jwK3pO{mz~218(K9ww1yOTG9QI z!JwWtAD`{QkNE3S8f#ysZV~&_dBE>C+n~*yH`}?HF`YmK*g7h5Jl*4)qqpn%a54`( zvGOY4bf)ETkFE*VdPs1?!v4Jc&a!&3@o#(Hn2XN3)2Vjen7XQDjv;hr9hJRPio1IU zaTaaLR2B6!@5tV~q{wqT#)ZA`a+k=-rp1}B>htoS-lWNi<}T;))J^%jioBymR}?|b zXe-~G7ieg%hu(Ri0N0?J8Kvh`i8a>+2RG(8QJ-d%4)9bZJ2HRy%Eh1ElZxMu=dV6r zTlz2^XSv)r9|VzHci`Rld_Yz4*S&2@3zM{>Nb=a6j?j$yVr%q369H*o8L=Xe1QcvW zHGXAXM{Nd%;dVr;pp%Iy=^}-ddGP|Qj?K0oyFZSio;mR1TIdHqnJwITbFKr)T)SPq z?-VihzZ7lC9sIRL)H9tDt#chSoiy@!bd+BEtz}uU_=hNA@*!2vuT!!^q&+3Yi2jaF~BQt&PN)99kOS<@rbh*JjDC4N9{K&kWjk`sfbsC9^u-kLh;f*T2 zrO{v~ZJoALC$0l=%Z20uu+Z)_5y392q=LIRqY@Nb*dRuaW3Fi0CRRWaZV3n=-*E>= z{mMAZ`62R;$($pxBvs~Y^WRY)@Arp0_3MlFu&WC*?BG5;->0jLLrD^k6-Q$;(ltl< zBN!i;=9F3@!xXqc+=_2rGa4#d{yVa?vNAL=r%SdSQ@t&zqa0xlE5?taFGpD=xbd!m z#jG_BqbM_}2T=jzOg>HYoqU_UWoTNT^Z(y^6W*-j5IMF73miS%f3^up*scLS`w@M87*Rr_d7kB zl>t| zMKudYdRd3=w<4e1h6D(LUVsQ0O5^+He|;<&C(A;|WF-jp!+4GAOdL!^L2vPLY_F3> z1hVVW;;w+b0Mv3c5lK@|FD+~f8mbWQ8k|<##^RjCV^eks*)KWju9Di^SWmq`%IhNm z1P>gxXltD(lJvyyl8qK-J+^dx9xDJgi}=@HN}$6VVB&nQSl%d&^ljRex4Fx$#p?>=$$`f zq%aFO{Ew72nYyxsLyd9#So+*^e3|mthSSKn$JVx-+35aC?%SIt*Nt=>fq|Snq-nYp z%;(lR-C}UqB%Gbd!_OGQ)h+Bd(!k2f{n8ca?rWIUx+{#ENS5Br3l|r5cINGLoZa|n ztm~gh`8sOe)aXkV~FvObu*BFJDR`)hXj-8*ErUmMPAb$im;>=^J>c3;q^ z&VR`5bmjlF0L@{&Vpb0VhR*D6oqXixyOH;N-!;8uD)g?`czS_icYc-WE6|wLXmcWp z3={h|FVKWrF$*?$k~3QEELvK@ywj`@lBZ7#;u@7P0c7=-ixCDJK( z-F-XadQR;$YPn@27p}5j5apQuWs90h7<{l$H*2r^*pQw6<)a*oF6WBRc+T%6E(^M3Cbtg8EYJ|;WA>hyUS5@?-xclC`P25kxxd7kuC}}#-4lU2=Trr z!IB@VMG_`xxzzjp3#+C2&K=3!hWGt-D{~Cf4v-k6@(AnFt4ehz>6=VZtPBc?r;Tr6 zV+;NEvZopWTaOLq{$A9t!XY%0)h9oB8eK6#v_u5NvAn8X27zK9-h-^O-^c&xv_Pbsz>eY`SU0PUwv>6ah_Mg3#q+BwtKu%c8M%`eUB>F*s{ zysVcT-Q@(*aQohH6x}8T3~VI9Mlb&jG;Zl8Z6C4HZ%Y+L+iMpLaqrz##aZye-@Y2K zMOtNkR_WPFOVnV~XV{>_LPuXuO7JJRM<%syH^vGN=;Y8L=wv5p!$VSt=`Kc66z);t9tPYe9jP!a zSFHoANt2L1>1UDV*Pj@2iRJ9g9l%Q{ut2K+CbtnE+ZDwOX{{Vbsb0$3Fp;Hy;t|ae zs0M~;vkU*xe#kRtxi@jtrjL$qtKx@&YmqqcIqkI%{wH4~`odT1Iad4&P@+0`aRxfR zL&NGE37O<{h2*Lc;DkSeU}WncSzI{FBkfo zsy$7a0Hs9zS*>6s@q)gFkwkquPoV;5$yarwyq%CaXb=v2C z^V$Jjv*@&;>MwJk#3h;-yBs<%E{OZVpG1eKZN2CuESt?V;-ojTgF0x-Z#H7X4GpeQ z7Bwl}_}sYsy5@MeCmH&W$gZFYv+D$KZ)5kSe{G;hm8XGM+oYlI*0p~E@afy`O@(=O zw4MBq7|Y^Jl67cEUQtsE7{sgOcVPAtR}@jDp_z5^k`>~z zedYhpLdK&0_7<^?CET6B-M7}&E)}eL@h_1jBrn^>mN)g;CkLjz8D(9+%dMX>|SlrGqN z1tozf^cHiv1b>5zPqz<4bjChb(Wc%i$FBs>czzTN6_Vhrcgrdk;x&VmH@-d~K+}T6 zy`ZPtXeuWQX(*Et1+M|?J9#`NO&z+LbOb6k%2-(0XX`aZUlNWf%B>UnRdi?;I*9SR zKK{|&YY_Y67v;p(Bjlh{yCvc_Dv%yAM*z*RQy7|sdXWlTUOiq6s1SzmpUHxV1Sulp zx7jYFz+qg7Sj7qjQ%u@qt&h_>3rtOXvG>+G^95{7ixa5##9<2kVS}8$Id>NQj>Ac zU+Zy2)pgr-*R5N?fAzM!ZahdTT#8v_o97CQmhw+bDOLw*T`6BH^X;}D^=yk=e!I^N z_IS9q8w;a7+amIO=nbN^R)>}Zi z>Jup7*&ft!<@4gdO$R@U{D4T4@qVXE1r!4|6$03j?}0j|G^4*LJb@R|FKWamQY-$s z&T`Znbc&Ltw@cca%`!J%RkxKE7xv&}eUhh2T4(#asS~P?7RtqHJnd}zS)STyh}M~f zXe=jdYp@rt}0$(WS@R@g)&V@qgnZ!%kV2SO+8qD+2ri#-xw#+SY9a^hRy)&c=MVVy1$*1m-g zB}l)%&9u5h(^^4G@M+jszlRj7b(rxvV%WKMxtmVjTBqj!cGgHXLqCp32ZLxCk&Vk`0rIry3+Sn*Q*C z>^?oO0>(0~+2eOSfE5+i!0kd$z<-bK%M>JkOrTF7r$h7f*K4t*PahZ)h3Jueq&8{A zCR}%+p^uJK*@jrSAir0Q zudE?quKKwbIbyPy?Gc;?PRjVgNiF#{8TiXpSfMDn9g=@#Kqk!i%l$ML-~mCM7Xu!C@skI(I)Axh4|Cj*t$ZBc|4P(lYD6JzzLIDSU-&Z6 z*d>-Y4MLPV4LJfwLvTjpP`7{-yBN_#4+`WznQdHW+sB@e*J$)Xa%IG;u_L*#UttMH zhB7+<0GT1$4c~njQp>e_HSlNX)%oulk~of(*cbNg#Qy0l$hVaS*mqAH*EcCU;4q-Rh~J@W!e=m50Q6r zEZlsFF6q~ttrZdaFj=M1HgolS-)gctT3(JB9+CMbNl{x$f;C;%-P2MPY@Ve^M>%@d zSW^84ME(x5S#o(zaiEtl?Q{KRxK%fr)82=CXT-xOSxpo!sFdr`?-y47Rf>?%f;6wu zM`aG{_W3mQ`f$THsmhn;5W=ygZa#Gq{^Nv%*tpR5=EB3a>FSP>PPPNM3jQChhRZzH zo_t)wEZLq|CZg*{U_k7?WlLt{joqvyL=UqbW91b84rRahpt z5%=$Mvh_=;LMVFMOIuiRMbRvsvT3$rjxSVu1rC$gQK^@Cv{Oz{vb!9L-( zq$J^^L7QEY^FM^WYsajYHZ9eQs2^z7=gW<8bVHc(oF(_fF$xlL_sYdhr7WW;oPy$-Qvwd%TlCU6?}k_S5sNe$hd zt8V;Ex}#%4I6A7-FVJ_$w4S01g%qyK%e^GbA7sr?O?UN9EzGd6V1d5XWFx*Yrz%Fs z>{|}-GzBfwsLAuP+HENk%fuWuB>(vk-KUi`Mzn+Wn@OKQQ}qKXExy#-Hm+}APw)z* z8|ALCkuh1Kn`cDvRn@b!WzlvSd5d@W=?<4Av^sqforN(>T4h;{Wq^Z zQhZmf>tY`&a>#RA*E0+43fRk84L+&j(g)j2XW$jqGAP9tm@(Li0o5)d^_7vRZV0Aiyr7d#zQ1V zy6GK7Tct_G`Z&y^^>~u!wMDgHEf@31f67Ney-5Tj^e2U&HMB6PAMEUL*+Zt!HoCHI zv29v4d0vt2-%AStp<^sxFN@xCpJXWtUpraDmk`6BQwlqb3wToI1r)I%-uW zpP$>?HLu!t>s4lRsQQTGIj6YzREZS}d^N`zJrxiJ1P*7y_QfNIwwy-tws#qz_5n+_ zw02kO7TQa5<|@DUPs7j8qRb&~d$KZAc)y|hP%$Ps?}{HBlRFJ33ttD2YkLcR%{f)C zxgDSz4xUHLPQ?VbO2yw#7x&_6O5Y3CBSXE>3@g`97e)T_!GQ`$60=Q7SctCQvy+40 zv!})L49*>S`FGT=g*~;M?CA*E7F5`oKc{V{eEerjXKUxvu03V_hvp*u^KWu&W-kr$ zw#6fxucFI`S`;HajeF?bu8n)xMJJ{{?TaZ?k!-0Qx=x8@PA>kupu_IkNuHYbk9}hk z@&B5C*THVaIsui$rQYKYv?7JvxkEY zf#O8jMJzaeGP2jxNNu&0ox}r~+1^Ut=syAOTIJI7ej!k*FDn{*^6lQx%#2G9|FV74 zzwpN-FXzCM0}p@p*sk^5DqzIWd2btvq0O^#xLXkp-k<+1;Tjaqpl|u#9_tFS4hjCZ zS||QAJH371oX*B$Gg{;G_5EdETFsN#x{Wt`bI1C`K4f*3yc5+6@G)ZcM^5UnlYX}U zWFqjpKDi+m-9hl=?~+T{X7G>Q&Si%u)Ap-B(H!D0)7Djk@279N41S>%ojEGDQ>UEf z<<265&W&&06?qB7oLv6FXj9}47@#%z=HY15y6S6n#&R9;$Gl#?IM9V7tt-#f$;Rio9+&`epW8|?(WJj%IFKpUt zsaoW~+8$J_S5CGyX5K8cS~bB7`YNnz-QPYBByv@Kf}|S7BCl@GHMNbdezfv0@4i=i zb!sDoPfnHnb~C6?klm9iJD`C0M?0C#At*w(!>C4eU#=NuC!YNt${qGw>#Me%H}_f} z+>6^~e3ArewB=X4l)=`7U|{ULC&J-(ZtNwIUOh7m+74A>ugi1HE?u2!>OHaj-3^=x z9Ic3QsZ6#??#}N=l`DI-XdC~NNHX%ZR^s0_ea9u{!#z|M_`uSzGGSVSlh%X(#_@*& zF$a=K9c)emrZZ$K$bqMSSHWQ{!a$L3lglN;&7@sXeDUK3e^S$BxU>`ztGAT4`r-S<9(!`f_{$@=3o;YYt@7zvg{X^OS4ETH>f% zuTeH+Tpl76c3ZV|je%(af(*VvDY}YvmSs2#6BE5b%&OYAP{b>npF+$U z3~fC{8`|W3PEmhmb|BEP9HPIuPLuI$Ie$KH++72YccGk49=2ox{=cB(WH65x>L62O zOxxp#M&Rjxulix7S5|_cG*5@+8PAG&CW4x!&n9J564928bXGE6L<)pY^1lq9G221s zI8N#tywg$l4m~Ln<75Yy7>EW87MWK0s-~Px%={dUMAHr!5iy~V#lPulh{rSWxW~Yb>zk_#FTMKZp!2D&>3|cvKaB;k zKCiX!FQfOZHM%}bfF$dWx%?k~aO zuo8bhf6AFWYoSPT@(L_nU=S~EwFvQvU(bb+no?az+iu=}S=GYB(FBCNW5lSPo~Fy! zjPe$4UI1QlEv=2*Yz19ngf{YXI%}g#28MI%FMT5`Y9- zs|XiHTX0|l2BF!3ck%7_g(~DI(H6RF${~o@zn`?+`VL@QlnD2W@Llb(H&T~B|9*zG zxggEpy7TXEAlv+DYMPdLuQdnWb;I zPb>(GGMp`PERVMEas=oAN+QrCazS(8Qta*yX8UU>IzgpEyk7NG=7yX|uQi+3o$KX;O zyOYA1cM}J`PgRx9s%cRij+=@F;jM>zYco1rXKAN(YB5jXrsh}jtoJJPpy$fC2vE3e zp2Tg14*SV9THvV5tIgmbsYN7&jZvWQ?^54yk?Y_riO&LqWmZnk|6LVQ8@Qq2r+JW| z)j zwhVg7FAABcIcHx(%GA&r)!0-Xg{0PtpUy;j$v4 z7piPjlnNpA0yQaZ1ayOFm$4N#u9o>NlXdGZV%cc&gZ9=53cMoUh!Pq4uvB{st^?lr zn>I8uJ2JD{l6^1_OIw;aJI${%wv97kW#V`=I3};JJJLCvL{q}w6y>tP&*ZzT%7xVoMAgYeSNl$a%zSjOf@rKI zbcH#x#>5XU_l|lPCq>$pCVINMocU{Z+smM_wllHa1taV}SSoZY`$ASX3^0->C#EY1 zQC5HdcoCUyfXhUKl3jfm?t-|+)rtRB9T0M%yIS|yDE0LH z^MAGb<4IrP)d(iF;W1ul5@utU8FVlz0l|zUO81Z9jt`P}es$ zF3v%24>^zfQ^buAj+zPR%N_Fait2%bwTAh`9`?gdgGc9{r}Nw8f4V@&m%k|+e_PFb ztKA-emFcv8oBSp-yLBdx{ZoZi?7$4=iFZ7j+3Q5|&2+|zOr`|GbR2gk7^a!Uon`y1 zgHLY_&;5~S=BClhrgnSre^8(!4j%&8I#pQtd@H2r0w_5Q2|UU;BV4*IbNQn<83hW4 zLDu*@CRh6n%v(G`szPY{*?{0~1P8JhR?3O$sCDCxlARspGm&rky>0Cl)t`tR(OV4q zMy<~pH6!{VbP#=aaGyh5$@Xla+^4^>`weWv7Q7-5>}YO_gdxfW7?8WMWvWuhiUKX) zN@5#0afkDTnjYxHZs||AMCCx>9b0JP=cRuO9fhHq%^&`c1(<{hoYYH2y{woh=69a+ zjF&5Pj1bwPN!a?Yf3+Bl3idLqHis`V^!si<{mHI8JhbSn4tC$JI8oM2nx72N(ee*^@k z&K=xA?{9v1V<_G%rni7hHg7f7(yCpb=?1JB17?cQVY`7Nq*MFs6j`xf9B|s&5Wg`k zDJZe?sL-pVN!X8Tayy91O2ORXs7-Rr%9eCp-8zi=mWqfx`Yu~7sr$_hc$fk$9yCdZ z)j)=0_F^6dPG}Ef*<11V&LhyBwK;o1dJ*oI-_RN4Xf^=-?CJ|}ViFx4RVAwiax+$VdZDn(`dMw`qHpluTHJmWmYj5>n=9di646vSR3#(l2j$>E(QkL!bgRDUN3)?~Kx&gJ(st%`T2 z+$q+nnpEa2NC%;~)PDkSaiGqLs0B5V069Eis9K>)K^z3t13oFJ-t>OomE7k`J|sT zkK3GF$gzN^bumO-(*+VxAMgHI90X+pT{ySDn z&g`DzRcn-%+_+7GqB9%zsmblAqEM|H))Fm(r+3)&G5w$mEB0&s=z%0gpwjRtN;NEl z1?jYJUf#z%DQGe=SmCM5M<75e+~d0BDuC}x9Z4d0XseAksmA9TC51rM*AZI2`;A`F0EQ1e7$Xy*rOn+r6fBbz$B zxd&crJqiu1oG*MX8qX;=arBCD_R}be(cx9HIn!-8RS`-YRXjJh3>_(q-}1gDH&w%^ z;}j9&V`1dgW30tMOs`kI7XR`5wl-o|iGenx6<2)pbJU)aGM}+C``Azt_~0R@fM=8D zWn65mV0e4BO$AGM_(OY?oG^|%Dw!)IiRXxYmy#h1$?m$YuGi%w0Bs;KXpNnmODuY98?RR9lpb*1xg0&Q|X z=u=Wp?X9M!s8;`QO3fKq|cXEA?zcFbEMEI)8~`IT0HlU zG80XThxAH}WQH+mYavr#$T85OQxW*=oxQ0PD=y|l9!#b-yxf@VOY~XK-9}MrU<-0# zRA0ff*=`-%k9`8tN>j`rs(8f*1Q51R>VL1Ult-n!phIe6C&Gq##|dodD{-G7yi}36 zx9Ivj^H^G&egoQC_&uHxSG+mgWPR;^Z~GdR459uL3iC0|y_ZoRI~fF1$AAPD{&(!A z^lUEG`!gq~-zObLg#KH7ER40E|0ZdNm(4;@0}SLOA@Ce|5t?OSih+TqP$u&JGpxx} zWq4l4c8mK>$_KokgdnCYM*+Rdx!UKj%HK)l8KY)91KAvU?NxZ~=s*;iDvXDdU72<# z(t1(Hy@HKC$c=NbO=Kht&K1o)A|Wry=thv+Z0kp4<_4F0yIb)&dZ8l{cVX#+YxS+e z*INfyai3r&%NAU3VVDHVLkd%Jq7M6ag7_C zXhWmK)0&UC4_L7YGe!A|fqsnf3qH)Mp~8wVxn%wZN1Q|K(}RLfjx*jh6)MMBNo&<~ zIQWY0lB0M}y^8ODel%~sMxdE_Hq1Me>of_hua&3R?(Y_Ur!>zntr_!E6=UG zoOpYzJpki+GFm{b(UPO5{ekufO~`mbdgu1n(Ihdf#N|U$Zm(A60I6*iPWv*(qd0_P z)Hv7$Q$GJ?xQO>{@2|e%p9p|`INJ3SJXBAtIj*g%W!5! zU4(cu4X6@?sU+H?g_F6|(O0yjb|(rQL>U8e&njl%i;H24T6ONZdcXB>Vohx_6w-QE zmO38v3WSB%f%8>%XT_UkV|Dl%n(d?;(NR#}0ST;_JCTp|&YR}ubg^mn9{{)4YE}r2 z4XAzQ#M)H&JAG|z__~z@4J&J>3g7=TP{9K$abI0EIqJOZw7mJ?@;5l}yhu?m z^)*!T->=b`DW2+KMtklkEj_jRSDi%AQxywU%etV(`=qrrCt@hSxXdqukIF%+dTfm1 zXE(NQ+D;^e5Z+%hfMTtu4IkRnnF^t|~OTiYCY2Qt0cs{DSh zA)WFyk{>d6`U{KF5=IE#q1Q0u>UVknmqVjx)(ao0qo9agFemCUl+vEX%T?KXo8GIN zzM7c1>{wnbT4<8ibJ8|Bl~b;}h{NCGeBSm{)pdT1)Hd5NdKz-EwQU?Ve)@jxEm1@q zdIh}ewj5n4ft86Q?|MzK_ycZZJA2c@pea;b z+{DzC4**%*EnrRlC~3!QXsELrE_mA@0NH5EM*qYdKHcI(vK-fYlo2hprLI?Ja`Nz2 z#5#lEnS3%*WFfxY#Q_?D#Lo!a0)s{@?f| z&taaYKxKUq*- zbF32~fr6ZOe)h!@v_qCfs=!p{?&KyCpHLpmXW1_=&+If#o=8qe=@uJqY%*r<2qZV| z&abSkO=KRu2X7)DUh-}O7iHZP>+%_)uPD}rr_m+`x~EvS-hYik z^}JaJBQccdx~mpFr<_6W*Uu0|ai6z^y1(-YjWj^Q(ZfMUTgfOF(S;Qm>%- z-GT55G8__I0bR*q-}9%=b`o6OfHQtwJ|^?f&YW-&c?_ceaxm9y%YJuiQ?Yn@)vj5l zJ=N4~yKvN67Ua|ZC0b}~#iqnB*5*i78abaW-4z~C*SyZL6D@@_l*(D{bSuXT^|gi_ zB&HN$Ox8RcZe19YRM~=Lc}sj^S)(cgV^1x}wOP81!zNi5-rx5wMZ!1}%YIz{T-Xxc zEdb=)5(55b88(liTVn*U|5TzE!fAdP-bOBOHqSi?k!PXzlW2?B92NkMCks%NGLk^( zB%57?2xybTzxK6|aj`y*@t#-#l6QN_L^jivU#K{SY!Lj4QA|z%DPcAG%u=8{pWg@t z>IqmS3xMQ^U0XgU{}F2s8CZf$J55TBwqvz)M0SRceVq3Q4^7|S);QB6=K{CR&dWaj zlFrViOQ)Kz?AVMn$?DdHaXo~RuZ;&^WJsWlx@KgoEwjDWma-hh9Fn$W761SD6;Lfn zRCQV&6=USOZa@W4xRs?Gq!g-Un=7(}J|;U)0$B~7>83?7oq?#Voi%fO8SRrgaWz%h zx(K9vkt&P7g+u|b4A<$WS?y>BP~Y2hf-!@06~Mtp#gE(BKkE^Gu(tqlyO*w6Y)m%w z*{W=kyVp$|F&Jj}+b=G3w1LO&m`IfwB7aXHyk&_j8rTK;&opUymJm^%o(CK2~{?^2oXTdWkhkEef{Zq z8yRN=ZwIzcB`x<>GVA>@ZqRw^X4AOv8qc5wLA$0mN44~zOKf+;B&}jzY5p@y z&7UpXT1^5Hf(bN-cXUM0%b(49;^@Ani!=l@S0$A*>O%$R14j}${R^@KOQ$F3P zeyYQYorcfqL^woBldXW-zCyp084#}>z1<(iY-AI^j8|@m%uBAk57-M2ekdB?f0<>rxxw}Ly@CMw0dUJDqgd4s!JP(-{G6jT$s>R(&9th( zxn^OL=7xNN#<{`0`BQhFEI*tI*!^;lgH~%J*dp6$bD=y-z5htMa znc6Y0kX$8Dcb_!vVPkLkKe~8>%+2GS9Xp{R@ zuB$i?wO$EJrm9ZggX0--@k0uWCDLMBNSU^Ra0zAfSB_qMm2=r=(qU``Qi~L#9M)X*ou=5n=(N#8Ni!WHVs_)WdrHMeiNiH$UoH z+w_>i3iv(yDBbE*n{&7(ciOIw_ZIE}0uXv-YRpyuY3NVNN{`g4L@V^uqz;L3Rm}%S z5Ok#uAFq{$p+(U6EN01D9rc3_wft)@Q$9um7>7yjw4v(l78{}oLsG^;*aVP_5(^a` zm2LU(TkH}^Ldt`hD|Smco3Sa;wRzSs(k)L~Km#o?)To1RGAEpG+JbKy(}o-*SX|VV zZHh-9;rC&D$^w%)CNo|A1Eq^Xbd#uBNTHH^w^FZ@d|1KPNa z5&eNa&$@1gG!;xVM=)F)Me&>}({fRC=0h6^X<`cy(8+Uv7tg|r&4!Iyfd9;q$=r<- z{A;<~rZSp%M`0QDBWjLu0RfG#Y~Co=VY-a;|L%t`)rd`Rc2&GoMH*Jv1rlH0<}2w8 zp!Fo~N3Ab_i{`$tHT}r+|C9Pq{PZ}jvT-**Kil=q^E54OGQ_-;R!)BJ^5fVi<}cna zBPT_`1!0Tops>GML85g0dS;_Mi*29T#XD7mO-L->xDJM35Q{_@bZth1g5{e3phM9z z2)z?&iVcI+<5X@1Mp^(xllb>-Ru9E;Bl(j_cVkxj%pLhB{8GvI3=L<|kxs^fNsY5nTu*Y;F4th-wG4X*}n%NO+765#A zvW(fpJbn(Fv--}6ek0M}Pig%zy<4%8J{5~k^U=EY;QW4sb0h{PP`&`McM28}JNA19 z<0{B5qtUlUHa33cPuWfy5vdyoVx`z&4NOAv;0ZNYG*CzNs&tQsdh)U5K-dytBq#>M zEc%!|XlOW*vzw8)$-aa13M`C4gs%}O@p%?w=Fs6#u#Hz0tN(V7=mBh42s>Mbg^{Q* zvTJh-pKK@9G=dfzlemCHlcFNd{>CwNK-z+rB9`~#1o{}4Ct%9s#>@j zVdAvNs)HB(@q)d@T1q`kt{nwCnFCQ=-zp)4OEReN+0ARkgf%AhSu+XPDj(5P5n%em z`O!rm9`&tYx9#w#0`AFDoi=?ZMgqgIczXqk0(ty)_Ni>rdt*HKLzeh22>cTW8G8B| zcoPprrOb}}Vou;H1m`%LI&fvesk^BP2*c$9m6U zOAN6+O2_58qaqv3mK5z2VzT^;%O%R2HubjkjlrBhXA6IV0F&4D$#GIzWBQQnfNV0 z<+wgMqtjG*a_!w=oa4~ED$BpR3M5j6O!s3LvMJe+Or){K-jlwK=^lnqPTUFv&)xG^ z$|jHP?Fe)?u)alqlL(72Nm0IkitSc<2bS-v$Nh*IA^B4FO@I)mY2A10DbGeFp@gU^ zTGefbVy|?3wz)n^=D2VE*qB3023?H*f$uA)jg?vvE&Om}7QV_DFBpTtIB#7{!o<(T zVbT|)cGVnLArc$%$Qa$xB|A_E74C~s)(Buw2}nBiY?%7fZ3-AHq{#P6<`oXUysxCM*$+dajr` zy7wt4A|-TyfCW6M*LQ(p+0B7n&?iA4?4(OG|9exGA27L7PE9?#53+h60S_$uAC~(#X7+D?8*a6BxX9Unnnv#)0GKPOh^d{UYI#CQ zlE#PAO7wmksq(LztxwX@{ZjSyew~MR#KBcv{d0q9gL&Ydd0)2r)KhraIhQFlKCzA$jCRsO1q` zyQAC8UAyD@zP)`z^oNv(r~i5I-P3HB=jrFJh7UIKPqNMn22-D0y&eo{7*~twqFTM_ zB68$4Q4xt+gMPdxAGl5qf!s3;_17-6xNge8eGfFR+X0Un zVhWisgg5a=a3l>6L7x#bKWs3>EISfIv6}|uqw+_>&P-%ktTbeX>Ok2a~J?Ky=MV(bxg3QidtX2WHDhmLw0yy%eGh0*b4mJDg#n& zXSPO!P4A4XPKp9->Q=|R#8qUuQXoak#$&rL?JF)t3Z}DpRe9tpH*P_y_g-u4u-lHe zK_w>*pfmmYKSP#zsKstcls8s~wPJ4$k_lUK7J! zv?_2l(J2reDZhp6!WD05U@WWhsq~}o>kKl=XkNzut&guEGy4dn%h%sIFeEB#j^fJk z_RWOb7_6|k)x9ph@usQN0%H@hta`6AbE!Gwu&fMQY$YMj9$r;WAPjhOSkdJJ%z!vl zT~`59nr+1mjpg4ok6t32vP~M(=cY`5G-J zOMv&dpYrj_!$%4eSbGZgpv~*`Vj#`-$|{4((}_Jzk%zG({(HtqT;ohQJ<19Dv#bUxevr;XB) z{T8hQHyz9gKva<|j76%Cv0N79Zj_;8Oe}}89+6|OY~hbWPaG?Tm^^musfy{>F?X5$_RX5$}+m(4r$TBajf zAxra@2~`M?8*&_Vh}V+XY7K1up4Ez8>6U18PpO9@b<(yk%21lg4V$3I~p8>{fd)<4rWX5&xcx)!5$6W|9PZn+y4ohng^$sDR2 zoiz{XKo+a`;yjxpzSDO6ug3T@hNREDlGwdO=)Scp)4WA7MO=|))&?WEVpQL8(YY+U zKYj%DUpmkGyQ|3#1Bu!k33Vh9?>ga65V(9q&T#EYvMWP7q1JGOmJMAB_L$~art*hy zC$_=e5DG;Lq9YAdKDej}!#0_)vAQ?C-@Tx?6y_hw(7?TmjKj-zi)@}inH8`4qC_Aj z|L|dO)>ggq{PCs4ZIIUBXgcb%*A-)Yd)bs8A;7UhQtYQ>MKI=Bud8C+>)730kj#^K zd;8}+O{xEaFf!&fzE-;dK^S8aLoaLBCtk6_ecT*1)VM@zu&$vmemeLUMn}v&dgAm8 zRZNS~uYYDA=Z!iz2=SmqDP|c|0oiBW^$!Dr^h!*ja%WV&T*{2vTmnKXJ$$W3c9nCW zR$2Rs>9HFjGHj_%s}ty#pi>@6zrFT<6BRYa+D}AX#i)tOZie-rhrbxir@VOq1MDxN z+$T;Lohp-I%9}yNR*&q67(muTH9RKM>VtoDTBFZ&vHi(jdguFgU447nl65b7emHWB zF12pjnnaN$eBir>0H}P!jZ$``kQG)6`Lrb_E^rX2YiF~&WbEzmrm``A5Dn1- z$3l(+@gDlUKO9m>-VHK*1+M%*&7UlOS{fF`41ShtYsp1EUg$UoOmf7%ukkRNNiTD1 z1=eKv!L|FuUWV(qcNe=<@kvk$Zm&RphMVW$52B@9AlOPPl9CV^8%xj?aX?YD6|v{% zT`^$M58J8vw3xISyC|fLjOo6j4e7{>Ieov%KO~Y%O;%R8W?VV3JajbB@*A^jg$@N$Q@Z!Hcn}rP_da6d+ct}fL z5=aUKl$d@))GLLYe9LlE(lj9OR@5Kuw&ctWX*Dmk0a<-#K$i(;R-GrWTIgVL<;kn%!b=rflJT8qsh4lOKPm-fqKY6|GdOju z|F^;J@~M}Z#5|QPH~+cKN=Huezt4b;9^+EC#LVw*?)Sg*{Z0TsNdvQ}TQ~Wkb!vag zyRyu_#k8c$fC^r+!2?hW8Oow%HxJ?TQ!GW%C6T>9CkmZ<1xl?jZ&ad4PtQ5?^>cxL zy$%lEG%+wC%g>hrZ`p|%HA+jfTRhPn4q z=x9nA#2Cif#Tij$!2g27JDLog@v-s*mj;!%`mZ$WW*kFVH+jTe@WB_;!WFVOdLXO@ zYqh#v;D7A~Chj(Ye67K_?koL?U$K0C7LG@>ZMM+^VW0nAm_TmK8FFz!l&x$NB+x!R zGi*HPCP9|e0lL)bffqf$9E`w>)b_Y}L?_QowcDpfg0F`(YH}V^w{C?p9e+|Rw;DIE zj-e6oCyaRdx4xPmuZ}|(3!^2rfJMMzo?y#08aP+r5ny=I|_Wj&?- zT198M@=4&9nXCAW~!>$wUeS;Dj(qq5id5FKX)g5KpT$L<$b+L%}g^7|&cE6f=@ zlaT9vXTsQcI!v6~@XYcL(_+8a86<*p-NQ7ZOaj+dtQU53Nzj}z>{PTgu0AjD>Bt*Q z^ay(Mm44Y|P_P=Srq-SDqTdP||G;khfMNUSSLvbo+W)@Ip7{NG*WJG#0YLE63Vuvx z;65Dse`FQV*LGaH7dn`djOz}(*|_?}_%iq*@8t&Imkm4y`_1xn1RMg>Mfz$2&K2q? z(nLAi5LFJ-MHcaF`k&S<>;8)rd23k&)f4;37?q!L8cxx@k`kjZh0Pih6K31R8!7V3th2&R(PgOtY$0fFO*9_BuYj|mvjqTV?*ij zLQ~78%D*E4=egQPLF$u(ZHzu)6JPI6BfDQcrpKSXyoFb0WyFaUE==+#-FVeszL;SB zRnr8S);m=>e8aZbusX|=gChyd{k-G5+Mr$_dD#Q=ZnnVN7M}#1;-2T~S3{!~kX@fu z^}#EU)QL`|tF?n@cebyxb;m?DLAZ=eYjGSzRzise0SVicE{^Olb7K&gF;EIBS-U z3�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 IFS! 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

    r)q=%lJXLX-l4~;k;eyEY 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 Date: Tue, 4 Feb 2025 15:44:20 +0100 Subject: [PATCH 3024/3075] Expand on Rock the JVM and bring it up --- _includes/_markdown/courses-rock-the-jvm.md | 13 +++++++++++-- _layouts/online-courses.html | 10 +++++----- .../images/online-courses/rock-the-jvm.png | Bin 613546 -> 1205907 bytes 3 files changed, 16 insertions(+), 7 deletions(-) diff --git a/_includes/_markdown/courses-rock-the-jvm.md b/_includes/_markdown/courses-rock-the-jvm.md index 3e01565500..f9f2cc4bb4 100644 --- a/_includes/_markdown/courses-rock-the-jvm.md +++ b/_includes/_markdown/courses-rock-the-jvm.md @@ -1,4 +1,13 @@ ## Rock the JVM Courses -[Rock the JVM](https://rockthejvm.com) is a learning platform with free and premium courses on the Scala language, Akka, Cats Effect, ZIO, Apache Spark and other tools in the Scala ecosystem. -It also has hundreds of [free video tutorials](https://youtube.com/rockthejvm) and [articles](https://blog.rockthejvm.com) on a variety of Scala-related topics. +[Rock the JVM](https://rockthejvm.com) is a learning platform with free and premium courses on the Scala language, and all major libraries and tools in the Scala ecosystem: Typelevel, Zio, Akka/Pekko, Spark, and others. +Its main Scala courses are: + +- [Scala at Light Speed](https://rockthejvm.com/courses/scala-at-light-speed) (free) +- [Scala & Functional Programming Essentials](https://rockthejvm.com/courses/scala-essentials) (premium) +- [Advanced Scala and Functional Programming](https://rockthejvm.com/courses/advanced-scala) (premium) +- [Scala Macros & Metaprogramming](https://rockthejvm.com/courses/scala-macros-and-metaprogramming) (premium) + +Other courses teach how to build full-stack Scala applications, using [Typelevel](https://rockthejvm.com/courses/typelevel-rite-of-passage) or [ZIO](https://rockthejvm.com/courses/zio-rite-of-passage) ecosystems. + +Explore more premium [courses](https://rockthejvm.com/courses) or check out [free video tutorials](https://youtube.com/rockthejvm) and [free articles](https://rockthejvm.com/articles). diff --git a/_layouts/online-courses.html b/_layouts/online-courses.html index 71715f042a..45addb8dfa 100644 --- a/_layouts/online-courses.html +++ b/_layouts/online-courses.html @@ -11,16 +11,16 @@ image="coursera.png" link="https://www.coursera.org/learn/scala-functional-programming" %} - {% include online-courses-box.html - path="_markdown/courses-extension-school.md" - image="extension-school.png" - link="https://www.epfl.ch/education/continuing-education/effective-programming-in-scala/" - %} {% include online-courses-box.html path="_markdown/courses-rock-the-jvm.md" image="rock-the-jvm.png" link="https://rockthejvm.com" %} + {% include online-courses-box.html + path="_markdown/courses-extension-school.md" + image="extension-school.png" + link="https://www.epfl.ch/education/continuing-education/effective-programming-in-scala/" + %}

    {{content}}
    diff --git a/resources/images/online-courses/rock-the-jvm.png b/resources/images/online-courses/rock-the-jvm.png index 216a8a73c4b6be8532e9b424dc2b971a732b987f..86b6512c0b0f1990fed9eba493641844580924fe 100644 GIT binary patch literal 1205907 zcmV)%K#jkNP)I1)00001b5ch_0olnc ze*gdg32;bRa{vGf6951U69E94oEQKSW;jViK~#90?7eA^Y&nu8M)Gd%5&5dRt7il? z8d?T|0Ie7Z&_K|jd%6euqTe8BTC@IsL6tAU{jQXqbI2R+etF$JDl=bYWo2X{p8H)$ zqj3q^q1iG2kAM4JRfXVUjJ|FU-utHV^E@68?Xhj6o0ny&>pIR;UAHdys;cbKM{YEx-$v8u4}4lT9&r$LNIyT zX)#Srs5>XhhimZyj zc3NqshTu&Jm8(KrQY{WGif!9M@+#GfUPixD2Jh!7$#27kw}Rxfx6bFYeWj2lo?|VG zuGj~?rC03AM7`-@yD|=geYCIkK;1Mxc$FZ@?V@Q~CFmI_tx8qfVB`R9>Z&#Qt-I`h z)o2>^Y=vE?F3}+@ZPBQ(*RA~XIIIGD7y5pP&LsEfBq(#ny|`H2=l2t4igR{pnkUtQ zq0WxB4|CF3NVP1JRT<~y{q$91FF=6N+XP%p2PXO)D%3KL{WP5yn`Ji2Y$(O4@6T)? z1$8z&T;Q;>K3(`TFQd0=S+!kkyVmB?IP`}@7i~gDsLQ0Cr|I?h+V{P>$$r1Ry=e;A z=&=zy%+uj;a2UW&O0J;wG+^ujd(vLFcTEXazE#RaV9+glOoPf~;84da=OL*yRGI-8 zLUzIGwQ*9_=nJSZ4+GPb-Jh|pjOv<&^ArPs(+F>QXKTrV6`;jnUrad;Gp--B9GOZ? zKek@k1G<7$$!2F$P2*^j%WhdCZJn4Xvz2cez{vM;9h@3(R;(>J)@m(xfqMS__uqGo z>2|TcvBub>KA%p@JocxvUu-Vgtref#!_h8eZG2MA*3elA0 zf*DM=TFvaDNo5^p5}M|1c-j=kH1Qb6T7PWCw^uap(3R|TQ!;9?0-HwlVoG8l#x$Xp z(QZMj`dOmMfJsr?^g;i&O{b|WtzyF0*4L9grqOHjNKKokVWFNWFNP(SopH3zG-0&P zm^@n2wTw$87)6*E_F+mAdS@?cRk07Kdcg!7=Lu?=o#qR57|*A373$ypSO2FLd?zvW zPyX@#;@;&`7uWpmo%GRPf4r{Xw#HQL=Gx7J{^Ighmb?FKnv^fz)VV2ozxo}yZ)$WK z9qlV>?_!~XTNys1s3)~|AyG+Dw?aKqRH@Uwa~nnN)p*mEi|5>D6jdAuchz)zxj4SB z#kj8Erj?Ityn5zV_}$uWJD@n&ieg+B_rze^d9cux`-Ogfkbhc}&J}NdV!ha}cSrBr z_nsVq`}dw2`6aOn0_vgLmK5vQ|Nh*t{Pc{A8ciQ@@gH6zOb$9SpZ9CYuH8aDR<>H&R#`PBVB)93>{j2KljxV->_cXa{v#ZP$ zag~)|%>fAFE8C#k&X`}(ZkU!17OV_T8UOa%N~0xa+xJEn1;?;(v-G(^uWO+y1fPgg z@Sc?hVuZ*!7LL~THn{SQ|%QY0zw&76d(zfFTw1y z%y0YJ)kz`tJ6n@XxfNo zxp{P4w5FMC^)Q~TWb3{-o1HvPqg6CoZ%}z772BIK&*#%?X9g$aANo^5EonnG z09XOWXcbU@nayvam|3eQrCw?n9cj}m^(>GkFJR?(JQ8|{!g_?xXv&)^tYv20np&(d z+4k#Dx1Sewdg>s-99T#+5z+^{`}+DCsxYI0lU6*wF#%1SMqx4iaDI7t!Jt}T7`JUV zjlHQ(!+12+kE03WxguE6BlI?*l@X``rfP#(Y`Us~U8yLu6ZW?*WeM@D5DvCuuFbuK|w3wb$FanlODrA!+r~R}O*nr%S6}LburuHpb8+1f)(UprW>D2?Sr) z3a$AX8v<}`%(v`Qn_o6%W&(aT25iQ0NnJrSu||To34)FD*3T6h2qywdpf=|x$acFzFm;CxH6P(xf|K{L@8!>?9Abh*UDPEePI3iAO8Ngwnwx*w0#MHIcm3MkmDJq;#KK$zedp5cEWBc=^vaFe7Z`ewFaqXTdVTm#n#A)U$V z$eJbi70=4H&BRw0f+;~}^Xgx-_L^W6DPKM!)~2d%XmTge3b0I&6H_x>wtsrMkBu`_&Tw3G30#0D1*Fy=$_N^2c1Yj z!DW{afigqiyXfA(zL_4Z=d6Pwuw?6$w>T|u=b4?^<+Tfw^<9K#1x9oQuAtWM8C#^kq?0$0&D)7yht2BECk#ut6_@=X z!N3{)u^Qgr-?=`-{@kzFmffL$4HotUP0k$VHlDxyvzOof_c!~1pBR_9C^BFCW8pH_ ztt#w$ellEUTed4Hs(A4S;4)W_7Wb#SYI~rl&*L&Bv7hgnUvZfqh|9R$DRy1l6N7E< z!L5GpKKsdfKds4+a_-gpSeR11MZNz?;4-c_4phx{z81beH!Lp%c>K=A3*QQt`6%WY zF?MG99bt+Zek@F(`1RACj_*vaI~A{`7O(C|b9>9VYaQ;1Qqtx|sJ+Fh+(G4c?pL@KPgJm^j1X#CGrY zKkXdZ!q}}M5J2uTi?-u>eZ>WEXb%taI85~4cG#Dn0lh4BgI)3oel%{H{pkDN<}s-EVlhQd2S8`$(KB4C`xNEk@S4CD#$ z0WllTq&gg0n$~W~;XE>6oQ}BT(3oil*C)RK5t!h_f+(1<`rzcD=>>M^)LQ1cPw)}& zk-BYsLQ*^*h_dD6NyD?^egWoEGZqeR4M3M%f=-gt5NkBuu;V--gLy^7WEbh-?4ct^ ziG+-xr{tuOU59i6uWrh{hN>Ndt%xZQJBx}(m~HqXWC@NMm7*sA&2U&Jjp0On(eb_- zIF9npNRA;gJD~(Pq$IQjUL^EKQbX)3Y)fCS$MrfJR~6Gd2r?Fe6Q*56%u@2eV%(gy0%%C!u=k5is|kG+ z`9FNZfEsfOv}VB5PPUesdQ;F=X97$f?l85ARgB)c0>}+S@sbioR=S#Cg*ah7h!C1F z52tB34>h`Y8v0WlXEXU7EO0*$v!7!F5C{sH`r%l&Hsh9Q{_U6FjQwCMz~OLYm}CMd zO`RiyiJC(Pe+?H;*4J2X+_(T|eeciK!ogOLrcEApZ8yQ>k1t=oK>2k&!mVbhn$`;H zUJuq%y8GF@{rGDl7*0ULIt|x}X1b-)yvBycvz7=sQPx}^W1hv*Aze{yoM0HrvrnK5 zkR6Q1PRmICYv(mDKHbixNLCiqan1O;#zk{7&U%`(6z7oXdkRT>PS~G{I`FMO$oDnU@ znvgC=b!?GqIHbU8GwUYk2zPM|O0o@iK+FovW4NTyI;!cF;Njt) z@CcYRw#SyOt8k%9wNHqZz}En8nwVmX780pcG&OLr+$;>bVHAM1wvp8vX-|kyL#`f- z)~SUqsdky15dk&UN!7@MWwSW}i&PA@axyDHB9ra@QVN$T%mf4HjMhpw!0fEbj&tYG(?iR8KNn^>}Vn~;4 zu;ruG;GQ6F21>Td#CWn0!jQ&f0GePDKu}c0P?Sil1kN&)pAQH6&L9p8Dn(xheqMMB z4aZmoKZH|7w7}D_cf32Z3I|IcVK0>#!{Y!Usm2A-Oe4D~5KnAyLFbnWkq(`dB-F z-FUNF0bDi&LjwW9u5E4nTNi<#2Em7Zbty{TOo?}?VL%6>^Qeu~Uv`DiOl%0i5Ftva zoKUbj$G=33Ec6IHYnpix*Ty3Mn#jO3FAF&!l!l%NBmGv;50PVr#a80`n8qQ(;BSVZ z7a$Ac)+vUCAXHO(;An&Bb?WRpHe*d=t6^O$iqH#sYdc`ha}+yLwfcgoaGT&GD^-}= z8t3J5aFe6w5m~uhe>x!|&sMo{BH7JsbFF_nLC>>Io-m$98w#EE2nNDpYHdU97j;4~ zZ5|It#SD^7W)i06@`B)4Yd;P>oLnMUx@@JLK-V&H{jx=bE+PRDpH-;4ZuYM24z^+g zaOn=#_`~bb1MVikQ770%bB825)kla~Zle$=mqX!JJlBSw2jFgFo6ACia=ild772uh73>0|f@1p!*}tXUY?TXCf&-WY%LH~$dom)k$tCGVA;t@h4=YH4S3 zz2o??55r5B@BUNV(iZkTKTlldTI`Yxdy2Yxw75SlZUb*>EGg>S<1*X#zX>jL^{Z6d z?v0D9KOQb~T}@Gpat*FDRJQ}+nZb4?P4VJwp~YuES?}kTh^ulQ)cZh~QoWn$QWE$R zBXIxT&dA?N`JhX#p4(n?PvbJhS~ruxxgBMe-nn?;PXm{EEKE_ukA=Cuc=d4?m$`po zui~}T;?*5#Zf`kvt;4-}Uee}9sA5NyRrxc*Wo}E|Q{0b>%k19TAJ#Vy`2X~;|8lj* zJgGWB80({%Fo&jPoIE@fs!XyV4|bht+vd{@JQ*+wfHGqVTiXzLB#y&FZjqD6!4iEB z`*S%By;=Id|N6d!dR#!{Fh?^Cma04W<}i5Iy}W|^181xa`FaoF$}|I}LQs+;0AY42 zFp+T-zhl#YkpY2Aux@a|A8Ci%2f5Zem)uXxxb}o~CQypB+U~pLTTvyS4qyruA&O+Q z3<=ni6B8{^DxyveJe(M*!RI}MfdQa1VJj{stAj2KxEE-mz%n6xKpUaT zUO6QFO_&8O92hWBPE{cvt-}WPiA#bgOr=nxnOAZkQZ0?pNXNKgKpf7E87dMKngIeE zVt?7ba_gb=48w&>ly@;3in5>O&qACc(hJFdgl@?LMW!9j$tzm<2uWf56r>_1w(!K> z5dv@sqwt6?F*}M~5H-sfvY~D@>(>$9a)O^svz}lIfeipOHfdJ6oZ&nmT7^t2W=_)- ztZka0KW0$UkPT<1JCBUv*%MGeyI_>!_aGZv944|glN2WLt#Yvl^r@*pjRCw9J~A|wM*uq+ zo{;xJowTvCobq5B+T?_5v187&>8o~h}*75JhiQLIA!em+GyL3lVdFye*|Q_}=Z zS^=0-i#*!s%YepDWS$0~RRb3u6{%O#yNwQ0DKJfMVQAEFlUZl(N@*n5KgHo`SmuiI%r0gaj^i@H(+~~tXL!+A4+c3Q+H!!9P;xPYU))v0CS*tBEwE=j z141!LYekmU^0*n37aNNOua2|P3NmiEACmnC3wO}0&k}xcdj|vo^@)UwxRv*b)ys>n zo6EHoNM0V1vIE^Y^(PLVQLZUkjiy(zXg*ls&*+iTAZwnBwFU3vG}PuBbCCE}x;2lYM>rd01{+?53W#0cEK_teNQ ziCrETy0pFKei$y}HpE;=(5=5cZ!4U@?)uAii2@y=$EQ}3YT$(4tSuNvRH0k;!A1v zZu0?vGBJl;m=$|C9Blvl-FGj`JT^4r%)GC%$GD6%+l13k8*UfGVi+G(F{TEm@hI-p zpLt9k=-Ln%(DB~1-FckOLvMENc^KZ_`&iXIz5C5*oug|HFRnS*7PvVc7Z>WLn{ilu ztlMs}N4vwc#0H-uLoFuZ7eG=N`Ol3zwz+lFyuSVhCIn8Pt0jJ9GIH3~%OnF+jNLkP z2P(-cP(^WAW?0pkO_s>Ul*4<_A|0yJsegi}26p6tX0Xwx5l6%X@QDm^dFZ5Is8GoS zlFN*22A%!3K$py_g7-&%?#Yjgs}khBanAVqI%_7^cwS3A<$#arud?>YXyTuh4#3p zp+`{9kvXSwd6+qu)KW2g1~w#qD+CPflEFOD)g`lRM)jJUiDVQh&P!N^%XBm9FF`tj zMI6Bwt0jW{ryKgQ%GAR2Q%O-g3bumV0qsvjoRHi%Q3xrtiUi1TMIi)0V>OP`;8t$b zDkzd=ma7ispy}SezrVwqp-POuKojU$#g+YISp1eL$j8*f7Gv(H$y!`DOtL`tIcwaY+>u4>h%v z51Js-?w}LBn-hI$u<_ZGt_W@c(6E==3wv-`aRiqQbp}i!RtTNDB$uen#F1V}RMrbk zaE_r!&frBXMSubaX78zo0nt_P!k8BJ*TiRCe?Heug^@@&04{e-#RYe*#18J|_<(#^ z%iOeZWU*CkA$juZ`-TBF5!fO}4bw}-yy~W(bxDB>)x6l8n#_PFiT2pTt;wVt&;2sm zV1h@_*iX)+jd2=!I>o^WG0+j}*d4)4j(|;(yg0#O!mxyQoKC0iaF|{E{`B5YW7Rb_ zU`AUw$<@+!2U~SLJlcHKwU7+HK`kl1Y=Bh_An#^&v&~1EE3F8Er(ZIx16NCwB3JYq{+KVtcMDwMg zOAxu%x@6D1y}cdCjwFagE_J{e<;qm2R9P8ls}^sQQE1M2iOiek7U28%J1{H0FRv$b z)~kVikH}t!1AlRj}FH-Zc6%iYi_#bjGJ} znX6y7ZP?Y`14TW7%WNiIq#%w!eTh9aG?@h5g>MBa&Hm%w(W`9nX#{8}DyYfG* z_tQ(n)f1cI?<(`Qh)unvGK%_sas=+*dursD#4fi*_1rcl)o?o?Z~rZ*cW+qU5i`HD z5#sLnysEyap`H3Sh2Avj88LR0eMgw0hVKefXz10)ACAj7_he&trMbQ3*7g=2eK0Q4 zr;@aKkOWu>Ugvb`-l{LPn8Cc{RtT}#3ZWlBkTXL)pA$?>Cs zByyAq@)LnEkSSH_01MeP4}2sM7H6v)I7s4R(7OnYVQ^3$GreZ>WNP=->pp%xvOaGX^=?yBM;#hWP%@7!OU>h2b(W=c*&R%X(up% zh*ON~ne)cq3ymiyTkd7Kx=7Mm_@MA`q54pWn`LT0j{S8aFM&=_F?}u#r3K(TG@0`wx*`w&a1?N8W!{UBe`IWIw6; zGw5SRW}+HwG(`+#`^``&d$Jqn$(Bdvz3xDhR3T8vAs%z2s|W%@ZGElVT3OQNDWk|N zx&LHG$e0+25{@Ry6-{~#a$n~V(={m!&^1hq9Y{M(u3=1^ zt~;)^D8o9(^C)d|#jX;!3!bl69&S~qpehacl_VI5XTqxGjt6C&`!mB)dpfnbN@=h; zVv}FqEFZT(=5^n7tpr#RL(v#7na`UJp^MV$(K{xwGOZ&YXATZf5$J~r2cijo~-IWwyorIpQ*fm%Y2y&i2j6+WP}=neD|J?LAP`ueeOP>q-~* z9913-u3t7Tb6wd_utZ!vaj)J7!j$SQmhofZGTYjpTsJoDDLqvjjt@0iym=+{Uc(9k z{Je1)SJF^X*>{8~YWT4**BAHRD|Yh3PtWQ+-`JDpv&!GU<#t-NDSCUWRI1wL>S*Bc2`POD4-`@Slzx~ecwJq5e;Li^C5IDn-MRQuFmt$w9 z8ZiX~E7_*p>;xp@?K&k2t+h*~0i)bEwh6VpubKT!eJkS#{snKRvzczaZFZ~h-uL6| z``Hh(8)q`F*3Dq{UiUHuph0ze@O2{}hqgUd?Ge8F$~g^-Wg=LBHU!1%c=&86bu)99 zG~`(50_}L6+15=PbLv({`^rpoo-|uQ^lTx=?F>sD4)8i2*O9Lxm~3O+AuacZ(@j6% zNF2xMaW$}$CrgDum9toNleY_88ycB6jv#`9fp}`3@;&R+SN2|u>``7O2TkBcN6?Au zVV=9TbL^3c=dsBWAi)7xV?f71YlFB+NEvF?GF!aWBDGTFwG_3rxCJPr| zOyc7(?JeSwg#nBV&^4WaloK69HaI{xksu>|DxEgn_ZZTSoyNsGOOzXO1oscrPMQf=dqE zOqdBm{*@Nr)h!L24hzOk^ zK~;~4HH^0uLc$e7$=Va8F&vBPpzKTFzD?QI9NUYj$Dvg#fXHSpjpup##r z$*j7{hoK*45X#u^(Sh{j>_PtBjOWo!v48KapbFktV?+L0FRzMm2K`Ij+5d7g(NqO> zm-TWa2mx>ktIIHf>z4y%8J20Ww-*3Gk+Ter7!@6xY-%*s@yqM!+!OS`B&wRWK6Fcn z$781zV8X(MMPXvZkjojM3pTjY>{)#+3Bnz zZPUDZ4|$(7NS8VQ)1-I@P>8#9k%Nbj%f37u#00T{Yl_5#d^L0F0*aReeL~dxXi9Zw_D0@fXfsmzN@__6jj~{KTyw2!|p1o zbn#bQW^W39rru945m!&#tM`F0rFx5H{G_-{L8MYKyYu-e$HQlQ540T2sH1qz{NY&xJ2j9%)XBMM&3NsR1=;#~ zJ<1NW#pMIlKVkVODrKTr46d zs*^L0xF<9=7~=!;5|9LPY{i*gQ8sQ*rxVF%;*#k+g!j1%xKQe{k#jzMb<86^3}>V> zC&H;nF`x7DLTu(~k{`-Ao+qC6udWJu#_F{Xz$3^xlYFoUreuF8A9MP4^*cj&7Oo#y z1V}kdk{e~tt`cjEU=C7jAeu?7^WYc;>4uz!l)HyPMQLUsurZnRiP37~@tWRM|F!sk`n1<0_o5y};+{!fBT{oU4zxZW<;}hK55Y@RrUOHC9 zX||=ct2#K#Ft1!nyM|6_G$Tl9gr%#u3J8P^%hb<<&BqbVY&-*g&O@&hb%3{yZLG;a zbjSg&^8e)zr>>%{8bYtO>RwYB?gLZ4VEhrW@7>h>lA1eQdFZ{cyz`79Q5aY zCCn1byPOJRq75dGHDEwgH1q>PWx1}!C55WNbA{YAQ!1adT*I__Fu6pI%eX&wWmAFg zEKRx*7)h`X)~@VF!zIzATo~X6e=9_ck$78w6=wln9GF3zh_`n+JC$U!8juvc#nfoN{Il@#Utj#8cemSv(mrw* zm%07ocD4cE0++cJ=&G8Vi^bh)VRQ2gF0&Q>&k&c{Ui&t<%=Y50*iQ`XDt8Gi&^X0HXi zZBaej*?e~mxfS4vVR>EoMtP-+_s8c|^~LG5Q~##Wn@k4MKx0&0Y5$5{hx%=lSlfUCAD(rYut~sC+BE zS?Z<#>wj-M+pl*A9N@#8z?KxwF$ir5j3z)p!6XV2xc%2UY-A z3`9nzv<#Z4>4h-MQdNp1*NJjz?u)pnk1Sv0bAqDYJ)Woeco79#Rrct?R96&mQY%en<986aBEkwQ)~J*`K^oQ4IWj|L{4Q6csKJyR+Xf22r_P_K5lRv3{r ziwv05ts#Yd$@&F&L84``2wUUFUK1yQXv3J9JD>~Fb<-zhPJA4o^$nHH@wfN)jxj7U z*a-@dNSnb#%017(lZ6o|Ze9kBN$CO9EQmb;Nt1lg;769TS<@f~(KUqW>ICUhLYqzJ z(@CxFx+90B0^(v`a}vm?p-50>k!x6gIx#iYH1;RQFu-{n&gXtQ&mkgAX&$Et=ZvNG z@T>z3jSU#&Z4OPd%H?1=EZzES{ovq#xppt_jL8f{89FE+G-x{6cqGxa{RL~QHb9qOBruq#Zd z-eMU~n&{hwXGeSc4S3js-L|Nn?QFi)Wbxm^4Bs1;*Vi7aU=?+5d|p*w)bq3T-!!S9 zi(he>U5)+$%HO|rU3XEo&B(tHyL6-6nme7f8Nkm-Q22JY?{*}6pqjEwxuEi`^yX%t z@o)b2$gORo+5UR)GgvE2D9O9SN-yGBxeQpsrZB=*yG`#;02j{i2tX#@&W>v z^MII*oIiL$sLSl8xA*f%A`%+G)p>MZPqsDo@8@%kFq|+)S0BIgO>2f!b9{AG4cBg< z7)Ze6Z9_l9nI+WeY+qYxHr!`>!70Zo4xEX+h{VK%JiffXpWfT{I5XKzl`<~LP9yy) zlcZ)=8h{aN9$aj)=~=@_nJ74bd8ry6x|)$ZDUb&yak6cq4!V1${D3J4bf!{xg7XP( zF%!axA-D=LN2B1(pNf)tl~UT#Ck74(Oa~stvp^c4k#L5LTb|-BIj!wdDaDiMG?_KF z3UW-KuMl};=)&RxIb6+nqiq8fG$P{VQSiu+1exmpF?C zu6V+mhW>1gVX%xF&Sx7g{psC{_-dX`r+yhg^b53hm|LV?8UkXFrVa_?{4`8($XMKO zzx>AftpQ2-D_phaIma80BGAF=Y#)#ueIA$TJoUg_7!!lIP6w8n2oIp8J-+z5@<_CV z5sf?GE$OPR^_4puTA?QnFmYgADJas$ul1kYnuHIM%e={cWR9VBbq1u)R9&OY&>{0T z@v-#$89kWd6HRJ);h7rAVlFp2bgbyHiBQ*?$l}qO##y0v2^?h1k>csJgbMxf#OVN# zFVGor30s9Ld{mR*$fKVaXnv3E|~@ z1lJNV)|ru0*+mFHJ^67o!rg`U4IiS1rZwVs|H6gt4>7&UTdMty`_CMg*)}O(+z4^I z3H#A;ncI>I`>#)H@3Y84@#0Nw_Z79h_9ubM6bddqcwc)r|J-ZRrJPTW?R&%Qo)~VU znXN>?`vp#bvg2d~)RPwP)KF39y~b`vdY; zire!35L{+Yh|Se+fXm#zvn$-MxXktSM~^-p7wJpsiS@!x2f3a0>ma3qmKQ1GvH}oiFzh7eB}H0H`&j&_aEl){o61({r09J=uqZhmvE$`TX937x=*1u?z3WG5{XgD2`Y0m6|~m zm_8Yx!$jUt@tcqd^1|tT5%0jL&pKn5)?}5LLEg4XS2Xp*sS0L-4Pq^t~JrF{396e^}^f zP${g&!Q8UpLkMY7!+@_@M}S76Lf{Wvc&d#404Ad=!IDUSiE}vw3{8xX>J`f%B_xY$ zLJSup_)>Hase9u4`&XUnADJ=+-U0A%i40X^hVNluj8&STR&9$>Hxr=)eK5^Jc4Ba= z%?$j4pbT**t9IbH9W;1WeD3x2JD?=U{1VnEJn~xykpYRQyQj;WY3aL{S4ZC;=Y4i+ zaEi2&&Pj=y{NNhvTp%4plt3U-Y2t%twn|JurWOG%EAS*UeqPi4739iJ8qqgk-W^`x!-*F8)Dd`{S7_ z$#=zY8_kr}RTSg8jQcu#vfa0Hv)IX>srMN*ZtMO0LQxW?FaZiP_m_;zxXb1}F)XjI zmFjy6mnl~J4RD!~&_(q=+v(2>vytcSgu8v=iD|Ye{8PA$+cxDV`E*k15b`zZG#iJ6<1!56^vTI6PMhvv|4y!I4@c0%1fP!_>9j&?!OYQYXn@mET%^ppiW5^|!juf-UPAA|dtdUAC zv5h2tmgGB=;-^G$l&}L*rHWXT=kQ3ZyU17yK9S2V*{U=p91h2U3?7s=F`-NtAvyqO zdTct2DN0D6!J4d)6BfP(dXN?;iXqi0B{th4&J=QI4Bn-fET7x1!GKqoavk}qk@GkT zm=I9d*ub8Ndm>3Z_=brh(PyMm*pV>P3IlanE+H*BP_^_%k^L_yZKU^8+q4Rm(ipa( zGNf_qIg-PYf~}IktC2507fyV}HxV7He4?*jp~ICyMy9?ZJ7V&xnDtpMGiwwi)#8-v zn$INouWc(jB4L4oR~MX&0N=o!ts`@`jpRivC-aId2=MCQIYNXY$bC$i-I~>}K~q&} z;DswiG65ZrNBANUhXR5CCn=L+a%QRzBg+N`=w>&bM*9t?82biK8MME0s1bS4eEo7f zwpA;NU(x+?bWK_Th~ARFrUGbkw)&<%H1+%W)E*9zK8CZ4&9Mc!7f6fS!K4MqQ!6U0 zI{=7jj)$tY_pp?CE(I%pkd~L3Rj$5E%3N;x&|0)&e45uvcBbxI(?t=K57ZvUzu1~> z=^IA5G7W*gNdyx+B>C=I@alkAr{O{q2I7fI250kh%zQ(f;EwF+gZObrpe;6-6LhY> zN1_d8#3fn2nD?Fmq@Ihn^-NF7T_C4e=!hd@odM8^zj`CH!eh0;6b56rKBI8bDmBP9 zNTosAQJNtfIkpJ$^*V>J%8o}gJm#MSJdr_}OO})4WP*U}zjVL(A3y#`U;W81>@WW$ zaG5I!N_)2b+IBWyKXY8>;^R#P-yWB_m7&n;yNW6fvrSbOpKfY=MthGHwbPVsr(cQx z8AX*YJ~6g;I_BQ2bj9{>%DGinQH<*{9_w&Z&`ww0^k+%_&(vF-vAe!bx8I*!C`!WI zcc9qmuf10Mip%T@@fDqA-6vT&8qwe?%oqzy1d^yCCPLlwv~*cZ=g{r)PFnkgIZ&NdDjct1pPz zndMDQzZefT-vbTuL-*nk5M&!*>@|NNfsy2J#l^tKp~mB#kb z{WvWnPh4TCgz7ZR=gGg1OApAS!ql!BS2t5IBc%abNe#9evxyEbFQM+nDK_2FBX4X9 z>8Fhf@WqP~B^!GnWT`7JM+_^C-xxm`%b*{Gbu?9(Fca!USOIeG=Vq#-8iatTc?jpI2m=PVW%DMF7cYGX zOpgl7-ynoQ0eTq3#WjF2m|T4Do3|GHBYF@fGOSY`>Dfz+ao6CI%4e};V3sj!?5}21FNZkCw~_6XCV3q(Fv*1}2dpvBDrFJq(h@h^=Td zTAW5EI%dEy&hVb}Y@107@S9;CF?|9xH#KL0E9;>?LZ2&#%X3WT7Nn#|;;pFC;v+^M z0Z@=9o&17is_$-%)!Sr^Ad%2+0+N^JOazq8%GTy~;j^WklNMq;F|7(gST}_}*8(B& zLFGq;ze|qeR4l1}-r?PtpJP-G5?+5EK}#m1peyN=y@&eo8mahqwq*nf7Ne@~&zE|Q zOj!eDqx0Ak8@+7B$0B9cv%&dl__KpWHy2Qqhp#Uy;E!&N@|y!0rC37ilhPiFweFDc)2CPTFF1*hSReCAPqBU`C!lM~Ua+)}x)cdO*`jap zzin>vFW~!+Lw`*E21#^MJJs%7VuxW5%=g3otHSi6=#-JTHI8`mdOpm$32eEo{YHFM zA7x`-P+V1q@q;F9hUqA){@DKvI%ZloN~7mvY;xl|+pBfSe&j3tSB=TTu*nW$L$^;= zyF8L#`A?1Ub-%lbCCfYO!sg`-p6rlKPYw6=1iAkA4_=$Sj(#h@Q#}cN+5Ks#EU5@b zJwFQe8?8g8uDj)O%ky*wU^k_SUPf^|K6HJoIad%J9h&}9_xE#kmUbzoja;?0-�k z*!863b?9H)_1A4p#h3B0$L4#~a|pASqF`%vXyd4J^ENjJ>7-7Ae_!>!$5KF!2P(BX z#0%>1=AP?rW;7b$JK9A5bsZ!CvU3mwlZhsi_vce3Fv$%e{#`~smRD6W|Cnkhw~w_{V{!p`JMAaZN*YL=P^(Hr>m>L@oh!oKqo9j@Qd4>s2}egzL2!y( z(4QjNOCMVUG0Mpaw+I<}5oNm)y`zdl`eRrz=6GL#Xl7%%mVcADC!tn4a^|;8f*>nK z_8Uz+IU~Y@zT<_&7bcQ$*;+&v6A1oaO=2+%jo1 zp9x^gbkMX~s7MC}(c<8mgW#2NP7T^Jz!p?Mw=b~d8j^?$GUv%ye8eo)gpJ>9532EC%0pDlmW z!#B&N1{)s z#sLunsy+wEks^si%u0j;G`Ldrf<%17pb)}{T+KlAQZzv8{i4}L-V3x;;32Fc(-u+D zRzu;JHAmgodrm;QCs%bM>WOkOk=ttt^ORgDPF(GeS_|iK3P3PbAlS9f4Jna#(s0U< zgNW#>{LsWP&oY@Yamde%(E8rx;NVTWQ)d!7d<2ZgEkti|MMXASd0?qG5J=ya_EDMau?*9<-+=s`ciTx!x z_PqYcdzoQm;&=c$vd93%Dn{*SW`Ns1_MLDoIESQ2h4qWz0lMU7IF{($hf#QH7WFw` zY8^B%9*-{Xr66be9P3Eg@zPRe!+XeiamG_r(Ne*U)fY;>7tkf T))t)Ct(GCCJm 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

    SWl?>mpkNm>%SOr1 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

    INU?ilWQn&LmKNE9Q(4 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%0Ab1&0capWgs7y- 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

    v?z>9vV2Mc6T$>E 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 k!EbomGJdBeX`7$Q2a%$?)bl3G`V|z{84M45d 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≻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%0Aj8xya4lnO25{ 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%0Dx}Ul5`y40|LblHAwTM2$5><6!1vG;HC@$ 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ΠZ7fNJ=BBwyf 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

    <~}5r=0&;R9gvI$8X81WG6D@qaV_Bx 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∨=7SI!_ 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%0Dd1TJURV388 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�EehcY0xFBfD`Kynwt6S6=D@3(o1%E{Z!YH+8T|j zbn0};(=NzZ)4Ggi(Q$!4Jw=GT#WTuA%LZy3K8{|l>^(-1#WnYLCi9k0bmq<%dsI{I z)yMi3$4I*%|b>qZrPe<#lDtRa4xbkVRG^%{-w4 zLa;>mzl=k^8KOH|Eb~xsOTcpZn4CpYI4ZKl^RHIrIlywrJR+lot=I3a!k&f%B(%O* zI(2_1%>kFd4T<~!GSx?tz-?N6rSte2DbP}#Ep)(pImzj_q+^)^N@)#7v|J2pH& zOaQ&CTXg|NIaAdqRbd?hMY>NF&NNL>#8{B0J=Q%`w>GjX(@{v1l73PgdkMSjs}?up z)Kl5Z{YfV)CPed_vR$UHMPh(AxxqvZKzebd0%MuqNGK(e?R4NcZtv7?C@4Ub-zTcI z2^RgP?r+zVFYQf=ggcLh3y;kCfYe=a62@d2R1JomE{hvKy^z1d^YZxkf$+O@$-w{Y zS-Nbj+H49Px(ge|O;cGcL#(p%S~t-0X^D!wxG4lZ%uxvO2-m1bN+tonoWh;W76pq6cr~G(S|bZtsup$+e)Kg+M0hw zT6Grg<{%sf&mU;pk;T|!_RSM^aZpibDlld#Sf#nxIvQ#7^VHGc-m8bw()`fzwELl_ zHlrr2Qw3=0W+}IRyF1g@%|Co%dni~HEkD%7KoRzE*0E9nvLOrgz5#wj_V^pD&MA`W zR6Vs?n@;&D?>~}kn#EB&iSY1;lk8k8!G;dZ!50O{*Hfa@$q650DkpOZ-mRz*w6ljz z!asR`kcb0kgBU7Cdp?^x;U%u-jeI|&LKDkR(S{3>?8ll(-(`G~t#p@$@F(aSXOsp3S*Q>GVCDd+RguQdrif@Lj&P_+bxep?`71pA0w`3Zui$s zd7`%3RZ!Tq6qeW6%GWTUI66Ilf%-*)XcnPtlv#sDs%9Bp5d%P@{$)@N6=Vyjf5YEKsQi~PmENP438q1Zwz2N{Jy5g91o!<44Ykd)=?i`s zRh|dx_4c>Q$I&GpxOz26??k;klu=4gp&nVc`4$m8K!<@S1Qy3A4W!k@kRo)%IY9td z*q%b${MZq#oyNU`p>^Rh3BwqgkUcbKD@peqIg5o^mKa2Vv z#+;zDAmUj~qW`sba?^mIX>Es2{E#6(jhgZD(+}@Q)yqOf{ip#`%wd6zkv-q-iFIoe z=ayLnh`_Jw}rj$|#6X zZsRL(K8cu^@8XVgxWTjsXU0g{AOY5nu3v#J>KG^?!VEFnuD9X#LYbD-%;HZ;HE3Bq zp)F`oQ9q#zpc?VDsZvziLYihEq8shv@p;B-#Bc2GP)tm{jT;{NYQ< zys4!(N>ljL(6n_8s#aWFVul!LN_nagMN{St813%w$^=u=TkSk<61m!pF0y7tbk#8b zuu@$vUM^pV;zqh_o^@|p9;vUj8gk%!sS`zP(NLh|*=1g8pu3IxiGso&syd2^$W-PL zhR+mqjwT>yJv*$!fFOPystY&7kmo%uX0pO0WMRULM)bY^pGmhlZ*8FaE{zCd#U)`S ziGenRB!LX=cC6CUM1|;AJEDzWP2_$DFTI=XG(mKs=iaP$?iO!Bly&uNO6@Qzxd4iV zlkIexK=xcY6-Tg)xMNP0g1A#m9;loSmU|~`Tm6(n2f-bUscS2s%bq(Q!PFgy^;>Xk zLA6r8z=(oswOG``>A)0S!5fek>sSnDYKDqEgD)J^JHu_Q z^g!4i)BbJbF{QeZ-9c*|UXBG^LsgTfHTrM~`WkO~k13kjGGp{+D6D8L6H*hQ#%pE? zsHl-?Mn=2SN3=*obTh#vo(TWJOr1Z34(tHtJNg@j1I%a3PamEYsc)i*qH>NxM3T48 zh*?{dO$C<}-99iQ>;OTEJ$(#6U``tlugK?uaR?pzFCC5SA{_gl&oJOg-m$rz$aW>s zvnAaBsByvfCo*Y4c#&Nl4-=9gblp`T{v{rd3hRVBR1UocK@0Q=baqeW+Inx!(D#&7 z6>&%Qr);u&pLoen82zS1P+#O1YmlNFp=~K97OfWzS-WFNdv)Yzl?IxG0!Us&gmBrH zrK#VCtG%+FE%F=O;_EsQ;|_Y z8^8=+nCm0tzP8L9O87C12k8OIqh^@_4iTJCzZYWMXGMuetwrht z`uHhHDI;V@vL-OmGDxNdUQI;1f5YT5!CRZ)L5Ql|n(fapFU{w$%oMVuTa!d9B8knf zI6smusq>B{&@XthVh2LA{qFfBuV1(!z<1q%|D}U)a z^rN@nWvpEh*iv|4kR~buwH9}^>~7^xXGv>7Mrvi!`&Bb@kU%#;SSZPs@da~D%pckd zI=faQkZ~Tp+k%%$oK^mSr(qZsXhOJ2uOxHH7|l4#N4kB;jF}j8r)Qzd{)q)rNMkIx zDO!_ie^ob#>N4jD8e27NGd$S~tp{E|4_B@*r$B)FHhsvC?_71sqHKWB3($ZRcu9VE zovOr3IJuncNWKAlZC?s1>KFKCMD#clDMz`wKUvg%M{8PD%X}|D3h4ce{LS{mDy*r@ zlNLQUkcf~^Z<2`m>b4zHf4+M7m$f-|;afuu|A)CZAj2$lQQ79``ag?#7TM05*ty0h z!5IIexw#NCxH3;D^v_~8DNp?x$?!e3$X|Gg-|~2gKFq^LB7~eyJQCgw&S&loBwXVT zvcI(+Ye#X_5DB7(uqV=rFcHM5BsfJPB8NF1k=0?k)`owpZ@OETmQk4&GPAI7`;Z2d zXTbiCT2y4F0AEKP(0x{(3;JW+QYsf6e?|#*6|*$$*VkS1eSg$~?_c#1j1PMZz5TIj z0~^vC;I-4ssay020YkB^6U1j{Tg*y)hHp;R|nwvj6cUc#QcIfHV=N@bML8wgheW%5>#F1pn=!&XHaxv6XD zv!?ooDdDh14ZdHRrY~bOPFr98DNxFOsmQO@q`gDKQddGW3GY*P8Zz#o^-k z`?DP{10H#5KRYR8Et}j^tgDbc>?_!TX6f2`kqo_U_*L*dMK9_y*SwX*&q&?>lm4KJ znM0haXxsZlR80opfOz!~G!f1N871-&)L(bhjVZTx{eJw`Ea4O9Zs@=Ly4I1dQB;nT zUDGFyo-Q+_^?=%BZwdWiiul?C`Qa|U%DtU26wwHU| zJreYc7SHJrZhbF)rueCy#cDfzHE9!)yBK@gcfXEQ7o6R&X+SulSg=NaT2m63b!b5N zpBg1wq#E!d?0c#%A>IX$NGFrUsB|`7OliA3`KQMVKJ`#HFE1{>h23|h?>k})Z16=) zUA#X;bXjd&PQFJ6+>T!aTkzB zI}yKdadU?PY1ATFkq@)Ge}CHO>h!fZvsc#doUGS2)J6ILdLMefY~J#Z=&+#zAtfee z6VDCxRhe7p7KquXr?*sVJmMFc%FkSNQe!DrRjNQE>Se^;JAYY`;nR~ToiF{O@XVBx zU|~)(*q7JvA!jEhX?J{gxs8-jby%`3H;uolswrP0K)%e`_3%xSp-@WG(1Ud){_kEY zSDEs>NE;zJNV8gNGkUaauC!fGNL}6E72@BPi=k#&QExXg?q8jZ>Ck$>|DNm2WU%2^ z#`isBEbo-0zdR&Eyl#G?tGwl5_l0wVG$-jc+lo!|qzhWTPWk0NA&t_zcCMsfSa!+BqdwIUo7PF`2G`21{CP1 z8x0zN{#rO;WfxlG8(3ZRr2XJgfs}f}Bq7e!h4Pcp`j6`FT=(&|AkSQlR zApFqKRM1kvTI+lw(PXZ`u^rRF9Q)Vo$BE;$tohNJWS-!|Qe4VD zI^l9sjgw;wjmt;Z)-rn-C0!y!^kmaruFC(m1$b=@uiYto%EctKX%p3>RNb>Uz;W*I zPe6cVg*QDV1|Xo<0mIIC2C2XwJO%}$*(gOJd36PDBqva_aB(r85|_P4!wF%@r2b|s zV|Fn`46ktb(UE#dAuE7@1^$D&ypG*3#DyPRI;X8qchzY@7GHT%V`OXeiFq`p-@*<5 zahO$XPWG@*TZJ8pR_v2;*(QR=Ah8J*npqn3<3KoV@a;5I1xbFXYNSW>N+P=d5SCE5 zIW3I0IVf%@Eu`c>-|d38z<)3rx8nLG5gP#YCBq|iN(4@ILu(@99-%04NiW}6AJ!uH zmpY)!j;OZZfRkPYbdNts49=KSjMd~|W^PRrtiuhNbs=Yf$zP_pG&kvy2Ss0OO8IzCpcIs6*R@-V6`$21Q^pK zh@7oDmO`>JcQRzu7B7PW=!><$b7IH9Y)LkMI2d^9?hMN6<3OsyLGM0E8Qz^3<_AEL z-V9>qH+miXV3T4rG(2e91S8|dQ1k~D4h$fatj)!}bzA=#Z-SSCj6-M)A>wWJ=N3N4aAIqF7%VHdnEN*7O?Rz8~~R=Ab5jo4wRY3=2LtEOa~E ztSRmgih}Xq#A1yJlr24m8V)1iMXHQ$h3QMTa<&TC82ot8UWt#H$X=>0HG(V>UntS= z5C}%vu=yg&%G#W^Q}o=hjr;pv_Tk!!DV*-4A*rTwSA#nmSRmAyEbg_7T`?S@dL+cFisxi*uad>vy_ zYe+Pzn^XY=kf5jlv)O12q3Z-}Mt}Cz^08)8L(=EzbrMlf5j)@sM`7G4nJuV3labPL zVNy+tjQRR6X_tauswUb;lI}3Z1JxWh1sC+vEj9&#{q!l~JgkHfyKcvzuLVuFYjmq_ zGYkuqlo9HOr}^~YDT2I-gu`*Y%c~Ft(S(7*i_1e+b#S!MQ;3-3cNYhBC4v;57To?i z=F^Eksa7ul6(J>%yZMgkU7c-_hnrHj^C_R}adi84dQ{mR!f0nEMhQE*&{=BwS`Z#! zAjeAos&Nm%XAbXc$2y;mYO7_iTNbzH}8|d*}MTtA&ToFBM)z!3cO01E6(zKzdXebZ99^%Gfbf zfl`%j_`}-+&`&|X3N|m@IDV|g1ckEni~A?{B?+F1S8Cgrqf${*NPQ2Fu*Fi_2E)k7 zSilq~X4&*uvrORp_PRrf5A5amXs_0j%FQ#Ul$A&$zyBw(mdu1bjZh#^HW(b@Pzi|s zT=Mby{ujy=RA!RqRMVf*CiHxxCl;BYxuYM$6&0@yNl5-_pN=~$lPK@$U)3ZYq^DvZ zB2!C|Nd~jSIGo$K{;zF&@X1k|5#rDpkCKY`Re(YK9lTg9X&Iut^ zzZ!Xg%pp60?dAg|D#KL&9nV<|O?Zz4UUFC+MA~ExBt*2r{wUE+Zark}p2J0izLU}w z%Z?{|q(aR51w$jVPQu=fP$A-q!&z)P{RfZI%H`+9k6}(m?YZh+w5vFwI6V13_#j^* zc&IYKfsBCBTM%}OR^M8-RJG!_jT_9z$JIFi?N<6U3%L`$Q_d5^N2ReQ$$*}T~( z5V#~0F&U_oDrsHq^wtDOaJ_wAK>0trsubd_4Yabf9s`#>!^uLd^wQ9I$wr`Fw=_i$ z2co@PnsILMxz$iqO~((7)Xt#chLEz6$-6@<{-`?t80G)f^dG(OS147>OrM&MX_+NJOI-Knm$PTv~7s zt0w$3I?3BiE1}k>%eCe`@xW*cCyilUgpn}QC1rj>4KxiRLLFlGeqd=rJeCNV-^m|c z2+1EX>b9`VgDr)$Tzo8_M&9QdV1tBht~@sYNxf# z*2$|rf#!~gcz`0=p}RiDdbkpa7RsDF&^Dx&%%y?U>|Kc`G9 zImq6qKK}cA{&oKNXe@^N6PNu+T9M&c0f{YyBQA`f-DKQmJ|hsB6T2z0r=R7iFTtGB zecl9^?*-R4xSQMW!eKr_OhQuMlo(TV6&G45KdBJUJ-fz}{;TSw?3Zhq8ovK6tKWY4 z{cE;Sww{JZmQBC%kv|ybA$qGP)I7& zDUJf`j`4TqNhNn8NuOP_&E%QXr4uDz_2PAd-_D(+V2jOqerzcYIjH%TASsiCrG8g- z1(0-BioTR&y6RzJM{$W0B;=0R9O7AyVl=A23A1LrS7Qg~f6lyuK*nbSBW|C<&G9FHnJh&e8R8ZV@?Uu!w~k>JtqHJO@Uiun31imtv^Po>N*(PFTw z`2CZHNpZ-S(Cy%&e8B6qIOE{WHfnC0H*1Gj$e4)0Q9~1ysEA=`mUX-cFN~2pF`}4x zV2v3R{K0H0vb09`mj;|iD_IvLJDTRW%?F8=q`Vo=9@|mJUmU#9pIaplHj1=}!-&G5 z4WWaPy9tfLS6ci%y^2(zFhnjF%l|O;56C2$2V$j;9C5Q$t;@`gDrm$pndyZs#sB$y zWd^~0h1Hy3Nq2lx&Ac0qH*lG#ij;A&`4hY65n%2d(JPAy?>78`f)=<$D?3BYCJtRj z@tqO3n9@deP=NlWruE5m^kJMW&1WN+t;##Nox|7CQpw{J+TXb|OH>pnQP@IpELd+D z1}JhUS_*y`H83Mrjo4~DHGd|}J;jDp-)499GvwjUOFv|f!{8+#Q&WV5n56*6iA4Rk}4UfC6 za@OEmedH~Ow)S!Un^|W+!i+IF_ttQWp-Vdjx9``+fG~CyOdlT~wZlIW&XH_`RA2B( z&|$C?{Eui`NJi;)P9q2BsklMd=AKLg>{DpTaug+Kc7({m1~c)!oTvze2(dRYV&o6P zxt35vfy$9Q)W->%8LwIC9t%-X$H6QG-#O+8wJNV}(l@tbjIl@Je&_WdK*7uG{f*_C zhyO^use|!alq)!Ji6CY&Q{fVO)65W@p&lq3u+49GA({+fX>b=R(kxeD(rAZD-XwzO zEJI7C1}9wzYiz76e{lgpb9QseCh7Z`$%*`VUiVXah}Py!F|>&rU$8s~sfpWC&LhO^ zNYRr^GCw*xF&+9SMG9&nPq1h|$K;KVzSQQj`24($iPhtOFCXxrTkzKM!#C5=-ofA3 z)$GoOM;52na-W_=$Rll*9PE)+;#e_HVz!&jNRWwHPBh!~M*fcay87=U82D5M5gU_+ z&78Vfh*dytBHS6rSJuATpOGmA_j*bsUAOZG!o>U}FL7f$AMqRIB3>F3D4hcSwoX{6 zlJ#d1QkMZFG=%YekHfMHcg3w)28gZCY(`*YF1Ny+F2yY{b1?phD#k8Oa8;{DCfPdFp>EzuhSG^j&7D(tJVAy|> zRe>@zP(5#U>}-#X79n`(U)P$&h4MhG8P*Ha6Uw#E`p2=T&~7k@>t&ZBjFl}()B z9sBahj*`VZ?f1L7L0IiTBCwDC6}^qhgM=KXUQdUAA#yg)H2X)Bf-SV4=PjuKv8=xu z>$)yDP)^B=s>F@~-`i*t>! zYf)m5&>Bq(t+w^&l)|pbHP3hDw^__+yaIX=G^fZ6@G`Yi%pzOkl>zdl zj)?5k4(X49T6`@k+q4Ju-;3XesU4{6ewO}S75eeF?pcw!Ko@}Dozq0K zHCq)9~0W-g!GPx^F2k#c|gf{*Sf z4`%&~W&{o{4Bi;M9E}t}!ql7uGHa(x}-415J9IP`c^AOhSb3y@rydv2~H8ZI$~gF ze6ruqh9Y`tef{R!Q=#sMVQd48S8KtAA5Xf7T$^EoeIaa_NO1#j3~1|91y@@P5!fiw zBZB(LhE@z53mmZw7c-GO-T6kHc8WA?>cP>q~rlxk@|fgSy6PND(78FzDOO z!Cb16BuEpFCdLM{p{5WO+xTF&titLeoZi^q-=QAtm%t5I=4&?ai_*s`l zBVs2`?Ft&FVPyrc^NaqrEUW`b>Ic8w zq3<1by;yX2Y~tMdl$S;m=}mv9g`$>z*TkFSdj|=)Eq^!7u*cwNO5g3oGXL-jv-n6~ zQ&)HQ#;jb5_K(@4^Parx@yz#Gy6Haq;$_@0=?#6;`K5WuPPOo*>oNU(Z3T12X>91w z=%8oav(i(&EY8s(g-fzeQuHWB6gdNFa&bTp{_H?~W_3<*U`yU*9Ot+m%RIARK=-UMh zOHa8m3KRW`^vyh<7S_z@cf#bns9xdXRvclDWBC}yv~$axBZjZ@it0|qYIVyB+jG|6 zKMA-`b%KkJr+c{Ef5HrYt(ozER6XkuYZu`8WkwHctw|hq6iJN@S4Zx(h>h zj37)b$hU2P87O&Nq?jrKeWfbwLQB~YM~2~gfkTapfJ6Ai%Lr#!sxh1E0LA9pI0c7= z=H2W@3V;qFP@P9bogFnqem-7GN(L*d`Va_YR&7e5vFS@CYhi$o*JUQ0l1V$ikJ}Dr!uiYPWo)sN7r4ah%7r`F}KhWl)>#^L212?%v{F zB)Gc=cXus?AZ>Bi5?q5j1&Y(+F2%h-TimV1-QN58zw`T$%>CugOlJ1F_Ut)lcQHRe z;q@Bo-&_R;lV&`RQ1(G7$AN znClQzb(-}fcq*$Ko7H_EWHPlG28xU7z zmoyd8eLj`LlqrRVzVS?koCB3+2qlE$nTVPRWD&jydu;j<%a6b_mlm_oJK`o2Y7>w1 zhhQMd>3fz)FJj#nTHgY4!C4@pVIGnjhf<8gq{?*L6bb#8GYMv!I2~!Pwg4!pl`q;K7c8tEBe3 zBRih0Z$;zbW3ad5kfy^Z&kM!&o3Y$t!i915_YKR-z7F~=7Lz-HrilcNHyP6!`C z_9&sE#odJ)hVrlX8lVZ?QT`1s>-K354VVViKXgxg5~O*$Iwn->=>*%}dcwzdq@Rbf zY9KJ`WBsz)fotKcPW|`yQGX6_FFxKAJi&!k@P>v~b?ZBDnUbA^Vc<6rTD5EBk}NRePP3TXcC*TIy2I%|I+y8p_{XCAs$>^|B*8(V#ye@LVnGns16dp_VJiVm71 zRJ@pKy6V;l^xZnIeo{m$^VxKE*nC0*S>Z%EJz=K!{nTzZc3#VL5*q~;dF3*UWSn%~ zU=vW$JMIF9-0z)9iixXV+j56K!R_p_6aOb;Zo3j9?J&|1u=A@}cNi)*>K>}o73S#I z>Xj8EjThN6KN8Ag)%DlRA@+jIz_Erx8h_!5^y{=>O__6cBD?}Q(skCfKacYnnwmO) zGw#))iB0%m^sHJsyR_t8^^<^%0ar&yhw*`VN=hI$R&{d)9j}lT0o~qiXLWN^yVKml z)YRChRZt+kD1@^S|4c`vG&%BCg>N81X2`hFJYAptSV4*Kx&;s*q{M#PG?ND8`PLC2 zPfY$mmA>zRmA0+gVIfNHn+;R#qY5|Rh&`DxJ{frPANUnwB}-X>yLoGR~8E*N?Qr`2|M}Rd!&7Qn~ zynOu2rFM>{f`d|_`xL9JAzq>E>oNw$Y1ntHx@1qpUc4;M0iD?DF!N^&*HO4@a1Biw z%pnDz$2@x6%1@)oNBom0BMPT<`dQ`DL5B6Al3nKPK0{S+39)*2o2kTaO>8E+L}kH0 zO9nnJz|W^!==J^MyOw-Do4rHhyh>KF2kIYgJ5+D{g!ROXuIt?YK8jGQPOgLcN!ApG zk+It4=Q+ve#vk}e7^^cI%a2w&Y7wm8aMnISeH;QCc+Rf9I(f=o{i=lL$_PaL!DVd4 zA`iO3VZPFdXJL3^U|5fS^-D&4zUnLAZ+?7*URtlYv9D&C2TaI;ZTu@ii7WQOO<*~o z#+93L)nUgS_OA|fxFWzOS%LX2Zm~rx(HYA6o^)y-Os7u2g|Ip(zV70)sKQOuFS`-n zH36z|8@ZtOlf-3{mL zKemNPF^Pm!!E-F+UoC#8<6|0( zA*V267n%dEq$+U%US_Cx@ACGwxW%#=d$O9sJDO^&n85bxi48JElj-(#@3`$t!i)R< zmquY^xNB(!TO)2|^BO0S1Mp2^y@MtrKt5^=RNtDob-2NqAUbz3#weOFcp2(uuO!7| z`;g+@=9Df|E7vrP;76j`Ze6D$8#x=#pkBTBqFa_w+0W^Qh}M$k34YNJL@1jpTqsfi-)`{mB;}ewl=S_ll?v)3+7Y9z0`wuP_&eWUvV#hZc+D*(V5|S!=X|SKOxaXOAnZ~4S)SoZ z{AZ90-ZD3W1;ZE8>@)>w-(a#2RvZDKE=QeFE zMN5jgV7Fjv=1Tj6i&Cal(&Om29qiiJptr!jR>TO9Yf(mSg=5!<# z+c#V)p=txgT;CVtZQ7_MPf@;)PQ9ueo3QHJ{h|XF2!|h32j|b*^;TAYC#y5~#6;TD z(}w`3G|kC=-K5`Avo#g!mA2!RaStCb>;^(ZSi__sDN&*$hBi?zwmFAZ zfhUwI>{}JKIO%0TlpknO0a3Et2E@9wI=NlCmS$$d^?jllN=c#5;RbA4${o_?#Ao94h1wmWQ%cX6K?_wr2>kImB`&O3rJ)=% zEHqQBd_3@-i`Ai0g>CXrBgT8PnuL>YL+M9bSDj%y_bs3dpyDb0_-d}CBy-_G$8z6t zuTDt(Tf0zww})Yl>nEn?v6p+o{JW)u1n5|K+aY5btS{^JjTpH6_28D{e*x}8h1>Bb zi+Gf;t2N2PitT5Ney6{a??arnahTHw?ej-lo1@%ccOwezIugqPr}x=zFAkCyzg%&q zWV&0pZw?QS*4m$3fy$*&ior+v6pz-T-?dy<1SchlMp!v{*1Oy+la-2pgFt27NXYqh zdH&MavXvsmW{47J6)9y+SphGAJ(j9I?OB?Rs8yDxIC2m??H)&mgMaIOTcV(; zhU^+$)#Mm)zMOJ>)mQzS8+Mi(<}PsbI`x}FvktICdR0olCLP!#bHA1lX#JolS^qR& zZt~_HB3r0IKd#nzxfLa7Pa();lEIFa;F6WO?(dPcW}NTTq&mP}s+Il&LM{$)Vsjn( zbRU&vJj+WT!J+nIivVyd#H}MyMkQb1n7AC6X&vMQ$Xd7CS&*<@OYI<{-xPk!Tuh7< z8~l>%@`sO%PqKwV#)f&H0$(j+EF%1o;}!14!I@m2{xG8KB&qf+9^r85G4IXa3zL6}MKwY9N z9!3!Ip+QDkzN^wwL2`9H(R1}-xE(lZczodn%651x5gptDhUS6+mb(*6-8a`P7v{5n z^m|f6`sw(H%CJJAByWhPZF{^K> z(6S{S-_Kpr5=8vDti|YM01-QwDxAjDuL3d+uRdK4e5%c1MdDJpelEexFDC9-*1nHw z`K`Du$=O*#0jc~}Qtl|1qWV6`4yXIk{NuQ~pUIx`AmfZx4w3A1BKt-i&G1*voFpdC zhdW#HPbfyHlESX_y?Wvw z3>-uGbYtVG>N4pxGaa4>X<>)NX_)v@NNT$Q8s?%e=i|}=`|IO_Nm}dL(;sI1iPYCa zSua>RP!1%ufPQ zPOQ9tpiub~nRakr(Yl>G3=}6nPAcAO{W~nT;~vo9QF$d&iP=r*bUKUZD1a$$DZV;@ z%EpIQ=i_jXw{w0Dx9fH)xz_56xJ1cbkW1TIcfqplM(O5RE)VvCuKrEE9IoU)#l`*i z(RjYU=H4#&ts0d;P0e)SPt;xl71$eAT1W)22^u?0?fr4)yDfK!$<2|mR5Ni=(7+T` z8LSb*(EkK6LzFYJ6ZW%&+m0$in*7ubkwkWvLwzFJj+x$3NPu8j%8Ouej@`=H`4uGw zB7Y(=Dlw&OxclqR8PHk0Rm|5p7P8~1nc%F{3jXjIKFvo`L*dEXUMU8epYUWtNr(7Y zPCnOJ9% zGqj8fwd%|s3Jo<#lTffQ&|m?^v4|^?&=KyX3Ol+I_NJ~1WJ@NB=x(U`3VbJtsXb_F zzHu{OHDd=LKtGqHkZ%{uw6wH{@Kv3(IUbcQLRk#TvG_9U>WL$N0r!qz*JlS5_OlX( z?^r#J02IkHbv|l|&wB|8-Hh0TS@$M0%*0?k3=b%pD&J>n zEFm`p3jbC0v-m+ZVlc~N)a6(|RYyUCmVZ#@;xT3HiB#G$m$c{Z~DiSQXGQ ztM-v7oWH_A<2!xXIDougWSPl>mXBe!dR*sh!)XQDo!Sc*Y0n5B5#kqHG7l6o{|Xcxyz6D0R;HZ?OuElDw+=k>^W z?~aeI$Kps4kfkXu(L=SwUMreWd|}R^fSoaM^cNEH!O|{hL}CBF|AV8m_K?;gIejsE zOB4CF&ax1rFMy1$xr@45ap-oQ1%9x7R$KPztPP3sk{-XQ?-pqqn=j_=hv6;lvu88UI{*~4-;Xjx-N^6E8T!e#so*(Y3MmBi?K6XxL zVrj$MT_A-OaCWpnk{JNSGthF>o9Q#;8*tPAW;Xo!{xzLz0z++#v|7Eu~htVIBcKG@nH)4SQ@3b#1{4q)0^s{ z1(;H&pNt*BKi$+*bQCa2UKQK&_?b9axp?ycG%DlM+z&%z*(U#{v#wA1VN8u)PG>nz z;JXT2#CR+xJJdi{QlzO(WX?>mgL|dyy;zQF_xhlW&Yj)Ie;iZh)n(oTHzVMpS(dHw zH;>mRogRCBvXe`Tr)$rfwY>`N3b4TGwD`I7W=vjq585%=1dAjBp3bogrlE3>Po@Y# z1)d|&Qyv*>PbQ}G)&Ct@K8A@$iQ$xBLI?es~2tT|$=^UAQ zNNirt1nIu}c<}|Sh~2#t33X%8IY3SR&>BWW$ZIzZQW#JN^Dn!!o~cOT?j}3ok)f#x zhqx4(=i%vDV;dQ7Bc#fi^q2#;mt20x>1HTu1FMhayMNLGeMW|~V|d}=tBYGY>lP|O zL+?&kH|zp*AL(C#*M%@ukYBcK*|xsjak$rt#`r}oLWh|*RO3rPSu{NmBp-|da`J*y zL4zT)Td@zkBADXDy(N2c?ig~YrV3{N8Yy*{q^uCjVC!U7Jif_02A|G@S!Iy{d6PeY zT-XEa8)$+Cy?7%=kbL@B6%-VLvxT5?p!z5wiYl$8x*`O&RU|Rjfd|wDT{N`Fi)f@9 zuuOi*O5?SY>XMT3n)eln+_a1vyG@7y74&8kIwbPv*a@i<`Mp*^is6IO)hX=5Yylu+Ak ze%{eQsS-c34_qghCkt;hpNe=v_%BKG_7vv!<1uC^tAZycH1y(iGcg(<09#<&qny0l z_43aRpzu6!RL@zTt1Ki(?1~RPe22WFBBiwO>FC9b3zhE?SX3}2v4|@eOi`8O84tgk zunNf^h*%I@J5|;mGP;3_JEWUud@qrNpNu*i4{-dFY6FkLNBj;WxC_z~Erw!wQ1E22 z=Jxdu)-f3<3VC~Zmt>}^>d!{~tVV|$5gT^jeR$%^blp}fy~3tp&?H+k!XPtx`AnqyEmd@ypbAPd!9A1@DO-2gY&6^|5jDTx}-HJY$7Pa*54))!xyE zw)cl@KZq0ja@I(YURJkP*`;-4;qIzttq87<@zj|rq+wZ{+($Zf70a?>%`3(ay@p8zNbdh&BxR4iU09bgCN#&65go2@R?ue~4CL$A zRHXJHA>FaGb`q2!Z(g>iiT!IzrVQ?xKl8dXP9nKE-zWBX4DTu{yZFr9OeB#8%(X>u z3~I)j*dvPjM?IOWyvOZ@SF$#YkB=|khb?jkGZnA8;+VZD;6_kD>RQLbd6UP0fsVqT z3FOq*0FTv=I||_rXR=hG0hBKY{IbylQZ+*;DNPt4h(N>CV_}MmEW7fqd_>coHBaWi zhQcHkK#SwR_Hn?72L>z;zeK(xl5DBq5uOsA54VU9z(El+i0DR$`v}k((^;GGhACro z7GA`6>%+)Paj+k;-ynw)q@X7RBZF91QdpH6B!-^;RK6q=0EL@r46#fAC3Tn4JBe!= z`rjjp;_g?;(*E0S%TX*(Uk5>bTX^-uLsXjJQ5?@8JN4wml!ky@qHs%xjvFk_%uF?T zyR^XG8`4!H(Pz#pI?F0mfj%H(d@tQuAkLV_6k$X)KbKH<@69{jA!btV2XL zoCpwELXb=kw%T6bC0(O;y^XiZn=O706H-fQKts{Fx7f*tS#f(vE8B+3M$!}J$Tt7d zqcnkzE7k1x%W?BRZ@xifA*A{+o>V9@3v#kEc01X8(*@(RH z%aB8}a3(-MZZ|_bOn=34Xk*o>-aE%1aM$3{kgc%-+o^(H2MX^DmIR6UcYP_}?2r;S zG`G7B$plAi0_$UfiP0>`HakJ=cRsdc>`^co&~nTMnK@smAEh?VDXEX=lDr|-FWZ4= zEjIGfhcq6&dfMw|kOuA1Ch9Z1~(iZba9+1TvHX^rS8B_0EtRU1%EwtL7Qd9ZTEU}BVXi$F>U+V_M>fa zouSU*8X(FS!T-y;8UnyKDW;Qs%G#5`o?7}{E0=#L8RIFbOnP`XdVB~m%PSa^a7PsP zloZX#wyd6&u}&91DbZ4cpIL?Y=@jx3>kpeel|!N`Mq(yVNhJ?1v36)*YXURle0q2A zF+P7~l@&OpC!BsdPzbUExBlrXDstw&b#h84R0Z3|EVhp@Pg_HRi#8g^7>8iK)*U6= zceM*G*NTr+>FkbiViTcb;u6`0k zUP*1W&rClEvJsG}aom>0ZP{$F80Tc;XUm1&z^BOGV3Ddzk)M((LUK^(b>(}oeNVOC z{JX_O$3cY$p5ykdh0CN|#_4q=7m#m&4{G&er!Il1+DC%C(?3<>J5bb#mS)rdAS z;WgFnKVzPJ)-A{Q9{fBw8Me+qXfWA2S>#w@R(!Y87G|PGbBx1*7Sc08F>k01*mKnT zfDuHo^L^WhO>dU1uJrRW_feXJm&tlpVGpA#(?QgRqs{$KyI!8((c0tQE2SC%_SdbH zP7%kR4;h3lUcE`e&CT4&F#w#S7arpE00V?jQIF>ZLk7I7UPMn=dybX&M9eYIld+7{ z;&%BVKQqEc``G1;9#;~Z>OPhu`u){?rjF%&4(s0w-b8Lj>9-UtkMcB_>CT7_n8UkK z<^Dj(^G767SR}~G_w4wY9E99l)n3mQ9wQMbuFKWQH=|=FKclihaMlTKCBMb64?b{f zVKEEy%}u<8kXu3IY_O?{X5Sal#6SdjS$JLMXqgpylkn}Bl#^-iz_Mj&UC%PCZAr3(LxU2z#|*58qr8XNMGOoy)e9vy7%i-8AV0&uL@X(|GO3Wd@fEm<&Gb$*%HZ6Cvf zh!H9?3_HsTd73;284Ant)h2kT>tqf_4TTYmM$;2=+dXm(9bMIj>4#MfURI3_e^$?8 z{o9`bU$QXry=c=Oq0+4_iQXGn6`r#_N6N7LK?8-6_R)JIl0x8$r=@izH=&vFIxm$B zI+_UwwEEWfz~v;PN=(07@Dp?ptp&i+KGRfr%u$#P=P7cC0o8j9->c%;8FKP=1zn1> zcRgWLx$a$9d{pMW6^Q;(kKMEVsThu6<>cVSff?m^j!T00`H7)ozr=6+GU+)S^ud6j z1GR0Uj+R6U|FWF}ZDs(UB?g0wJ;xZvzJxc5!NNI!vh(UbA2Q_U1LIR++4^N`D8{Y! zDtg>SS#sQHLpTLo4CB4Shj@F#kX;S;TJ4#~XwWc0S;|36t~Xh6m|pa!Bu6usbV9la zDw`_8g_uH-cIff=js&Sz=f~W)1BC^Iy(}Rn{KO2zLR!IT>)FAkNdLC@sCH2ntaj*0 zAK%*tK5C98+sCiR4sck&oyurecd9-_b&mP7fupAVl69DZwX8>B^jtI?^#qb2P8loc zFx~+#X;d=d#t|ElLJ3)J5*}bi%(ErA zL~tK+r_x|476Wf$t8tbpmNaa}Rm-a<7peA152$*4m1_*^24x6ohvkF~-qLff#=U`w(Nr^ z(pM^l+HZ9$x$W|v>RT^LMz+y7&8BT9_lvzhx^e-v<)`n(=VE@}d<}g(_ts|tHtrH9 zi0T`l#Atqo*H^uxY?pSkBGTVF{dF$ZVPq_??W%Z7mLGI zbMZi)654X14#bhQIlier`|AP!6Itu@av|7)e5+gK>yca-yDpwG*YI z{|9;gXgTUAN~6{obYV__r!SE?ElLLr#jC5eOy~-3A(-Q~g{$sdb357jTO|}@9n0SW zVB~yQDrM#$YR|D)HKduI;L{K}Ur1?K_Mu1otkG~U;{AJ%k;9|Ok#F&11@F|&WVtJ{ zaJpL1T!Wyt_r`2BEtewy@NTRZ)X?iFTbP$bb3)vg*|9S*e_74GVP(I8h6e3qAxMQh zhL)Q4_VzYLYL3OcRXvSR?$6=@?PCn#`~ocDfnW<)7xL^v=|qz(^n;*ZehN2+CLO44 zzC=QXlT;xYx8~~P0mbWi2)P9adc6c8wWSH0>}>a~)yk!7)9h ztC-v1hYin0H4|^u@`F=yjvpU*ORa2OTS#nvuQHKN7 zYY#rgI_o+=SzU${bQl%Nd@4(bl;cR3MNf)2ibaOqYLjYV-(mR2i7J|@I2?>%4sd<= z%@&`?o+i?}r(cC`Y`SZ979FaV+!Cur5_RuEQbsULDemqpgv6o!f8)-cjCrTHJ=8;>Z&pppkl!F}EU*lLij7g7BH1 z{@QU=V*)O-eAd4iW2}esRM~C_Su3{gSYEeV^M!^l`BinjTe zk_8V{VV$+E9R%E@nwex7w9K*0PZQGSVz=lZ#3F18=0W6Pltrhvf9}8saL7O9HSDYq zR;0PTsvyyae$KtxLGNd)egT zr+1+?nGt2>$$(a6bP`&gb|9d#OfG)%)%?(Y*H>|KQs%l9HL=y?ihrT@L%n|`dp^-P z3N0{@3Vw-pduEn(RR4gXFsN2D5Qwm=4{_rP%|Y|AA|nfy$SN|g6&;bs17^WgE7Hn` z+E`8_FO%#J8crgpWn$ufRiQ}G?aORTjw}-(VE*PFrZv)`(rKE74q?E~54qLB_wFG; z@WRdK9N_gm0eSdWb`T+d$_CpFI3p;G%m-HvgyQ1*N}EeT8Msk`iJH1bcVpTDf67t z;)A8U$0Wr*VyzYq^O6O5X(6x1N%CamKT)^qm*p0eUDrnaxN`2rc~q^ zkxQYohm*4>H3nrD+g!x+iV^h9QFl638(7;%HsU*K2!%1H3cH-dFd?Ne4F?_QDJgxZ zXhrU2P;R(5cJ_1$v<_nI^q_j*lUhi2eMf3GieXwbKpZ*lSQ z^>GYl%5&KgS+=*IZ>2|xX*b>ExVhRp`9(^bp!**|*Q2>7S3CY>TmM0;lqrcVF(OnOtP7|sJj({DO!X|QI0eQ%VUJW3*D*8C(Pf!rr<>ls z^vhM?L4ibxJ;f&(#0jhhlIxyzJRVw2g~B0ns4tU2w7SeB;gdpqTf-5@yjG+jCgd{v zTn<0L>vwjNpfH@&`hV=$#07-n&vyVoQ`I&G7Vy(YykrTJ}NI=0v}2^g_t9wG(IC*KodiJ##{P2 z3qGtF4l*p(;7?;XJW|M&3=4mv?IRWWMuXT^84fZq! zjVh?Cr#Pw9*DU_;io>(1Rf&wZbpGF9Qrwa=a+do>~2bwiKV%NRb&?V<3|yt2Wq zw+`B19bjagm9)?E6M+Bcqj4=)LnRM)O((rqJp7M@O_)F0|DM@rO~FwC>uxlt`m649 zeE3@pziRA%UI5*l{q^(7Ay>Qmp~HozCR-C@ZojL)Yme2Q)dQECd$kS6nK;EYh8Eem z8QQJ&fMFJ3C4Re%MmPyjRzSy7@i{%;*B|dg?$OF^07ms_l*gG~D3VswNqfwuWC#xK zbN_Clr#;S64a-X;`88jG=wt^*z`>T}FUMMngOV=+K9cxqKoU2i3DyjrcO-W%^2&m_ z=}?aR!hw(j8`xKK0ys0$76cv41><)>RmM(4)5t>^qkpY}GkgAUS7=*vYOFsN3P$t= zzq@V4@WhZwKNkig<)qPN`o`GI8lfl^N&G!TH2%C%=W5o!j~4jptn`zm0mXjMrz!Wr zt4x#@sammH>S?!7;pd0Hh_VRg_)D~s%T@TcQ!G-65Oa*q1Kg=JzxYN?&>!)43Fei` zOW2br%IG396ybS7K2d4Bqvhz6QE|5{8VpoRxC`^_A1zU^al#C^#O)5~S+RZ2+53rby-ZIt9((cznF(Us0&wG$*wg=I2CM+czsbUJ9id zEWvN%$3-*Do#H1xQ9SJBs4?X;HC|qR&|u*`t+&7u+xx%VdJ&Rf+vaO?y#Jh>XFbXi zdH_V4>$~g!5n>8pEiQF){|(PYlC>(+F+3|y!q($97Df&lEoKK0P2iS{=g%PsFl<)vNi$r{^%bQ+77%8epR&xy(ez@=1fCc zqw@r<-a0uV@NHda^(2u}Cr2K?^`i*8B+;)Hv0JcxAH;~v(+dyufkz8D%;=aSD^XLTqQM54B8KlzXrCz0>3LLM!Z zv7k)YyEw&S5U;Z9vXfZ0PPR&<%ep&ZIr;@x2_w!OW%E?~{bdnjm?`of$FR-kOuu>99^L9M!+S9Dri+aXWuW!B! zI5#>qWd1&W>_k&TrUkQdcqDp+*1S!(^Er{e82B?Yw7M_^wA5S@KCoNQp|@y_Yh@Yj zve+#Xu{m*P6p;7wjmm9>Q}fuRS`YD#l>~)5mNXT2J)_+8cz?yBitR;Rz{p}yR*FMd z>_>^_w#4hR*havjL$xN`zs}QCfMQw3agEr$x7}8@_5W;Tt4^bwoG>XMA@V1ff*1Cu zk?cXKG|ioeiLm@Mm@A+JDGQ4Q0@dF~i?%clr2oJqR7UE^1Z3Yuq$Y+^!S)e^My5F| z#!wBB;PJFH%*6`zThA`eu!a-TBr9`_<@3;AGw*!(TKmVkZU)hSJhxnmAYpnMLPH%A zjONI}qZ&$~jDG&L9^vO8btnQ4>(~WY<7-O&EINMlV%QTp%BniY={215*3!#wrk?z@ z^#bgZvVBVy2gi3RsVz5#r-b!UacQ^UcfO=Nw`skp?hNvdU%H$M-fD|*Zkdre+`D`K z>>j`K!&!xIfh!XOrp>ciI6sWBdir;-P;gDESk{=o;$}sSN^P3=Sa@3Ix&}(m($?y6 z2~A}eG-^IpC`KY$Y)pg(bt&e8?S}o19C7Uah+7 z4Q2qWZv+?qM9IU@4@q;8sUp>thN!;y5LVvGPwpFg{{N{~o)UXveMa&BxLCVkDRvzM zI`z}XVoOKYxzrmf&>dTH9{o!qsuYHpL?RTH7#t*#uoU=g7eFxb4^P<3UhNV!vikM1 zp9h^tHwuVaNT`hPXUQPsS^tX8F6Q73wV$~k4z>~_as5xRF{__TG)K4eJ!DMEw zPj|OvX$TUDG)&QMZ_|72EC+g$+!e;TM*_AMfBX6^ZjfczY!UrgQL8tTxIie`{4+j~ z$0snyA;GfGTTdg2Bo@~G6ZD#oq2<@X^`}a~nqGo|=$Q``A7M0PSS|TzHZ%DmP8O(v z-xL%;TT&oGD-u{ICxLEK4BpAjaVWhoBgrM*&(y!>OBe8#9wVFz|+NSGbe zJ@|NuhSMDTjm@f z_RGsF*UsVqQPS1P|Ec#5hmCcHlxxdEIoVts3uSDIY%$d;5XGAe;1Ot2c=NDb{cZ6i zkJm^cm4sM{-~-At<~Zps7u8IkTvoqfBA*HdqFVSMx2D8Op>2{Q17;RJp&}@*=*vLy zjHxYL3z@LD1Ta7WEJ^6w>2TIC1s*j^p6%4$;B9bx$94~ojL9RbK>;_q$MA|CgnU;G z*B>0fx|{A9{Nf1>QFFrX z;@|$1Ek8og)s?1Th5-zEQ?5_=o3gfzzZrn-uODi!#6$0hN)X4S&1J!Ezo&+Bl4MUa zZMzsKR1XtJ)WM~J+EJe?R90C-t&Ri417`?3`udh*Qhh_$2iT{mjsg`JJ=+yP${2tK zF+TEGgo4+N2nGZ?KA9^sx43nu#=D<8Rz=+F8JkOnoYCp=!rAC*dMZjoavO z&*5HB&Vpxo7u+P0+bW2oZazs51G2|W9r$pny_;iY12DD0p;_3+U5akBm zS5yazJbiOIq4W*3bHM~Gm~JO8rI-04Ss%>Dn{Qq`im#J!yR}G3Ja2Y?{`VjP@LK0r ze{QZI^ds-yxQh)MaU)noF(Go%kq~7dZzJ;+YnF|aez(rJB+5fE4_l`q56*-z?#DD5 zTTVFoAkb|oVN(GT3G(+{ijkHx92on+RhR1#y~bd|If^@^X) znvu$w3u;oIaB)qw2TKnOGH@#mfY$$1b8Q*;e{#f3;Ru7WhnBn3ZNggrIkY#`$B&W6TlkGQ9CZXUOAD493Y#5!ao0=^CKjjdi{9Hb z>)}IY9~77!?!HlBQdi-VE#y|g$a!}5hNR%XJu66Ca8fb2eaZoUeoHL`kaUZ$beIH& z4~obLgD%iC@cTBsvCYWZ*DpdRfjW{S(Ma(BY+`@ef;QYs{zpm2>TtYgi(ZZtI zu-%{hf4KH$JN|HZAa$RGAH72MZyAX4PK^<9J^Jn^~omd*MFBOpTGevQ1ogy4)A%bMoe9}3}u>8q4!!kR4 zAO0TxZH_2k4yxo7Ls{Ah`0>yZxM1 z{NcbmM~jOf3kKbqZY2I89twko4u1q11?7({{EP*k$3^?>%EnM~X_+f*yyj)+goPu_ zElIsOd)PSv?S(spqd-yRO?2chc$RE5zZW)*REV%%k5pr#k%I3O9wdEDpZ)D=1tNq; zC$b6b;r&t}aul>T%TD(a%inmpdv!iDX3$9u{HXx6a>> z4`_3ndFwt+p>A>w@0z6Z&IC{<92Tg*=igd_F=&1D+x zC-Xc^D|UqaR~6CtByh#5WB zp`5MfM}>Y{hp)$ll9>$lmrSOAR3vMVK@H00MiCpKNNHsHlc*PDsyU7 z#EQUMKyGeid4Ot6i`pA{7K2ANE%p;MW*)x2B(9dAo}B~E%1GqP+1g+Ln1RnhwYLh& z(BG;qQ&Pw-rs$#Bx7Q5~5a~bDI$U9H6?>^8v}0a2qYTOfb%4>h7R?ah8Z8GWG*gP@ z8YqFi5$M7apC=>_j@LSly+6yONIWW-Ax`~=2;=cdE_x3&{Ow$hejmmGxv;i+6_in7 zVexQE`9XXz-bh8{lbd;G;6vALR$Dd`I-cMUL1GY}H0gvj@7ucSpkU1{QRchHQaGTZ zoaoNV=!z2K!TS%0nDFp;%{UW_(eUK(Ms5P~AAu`|1YE>SL6dFSA{b(Zh%5Cr#M~wT z;a@dCgsZ1*3?uv45)~6kM)cv8F}zSuvm^t#8?8bz_$OtMSo~n=Z%C$ z*7%#3=lr2P1vWTl7Q|mDA!8RXBzt#qSyU4|eHY!yHsD(E{kMCWa*|dybeuB+9`)Aa zG(a3@Od;*3d)IhzgvM{3%f0&Nw_)az4j~e9FQ+A6s0YBzsA1a;d5)HJo4&rVrpk)( z9BsnnU02~a*A3}gsxSS)nWQ+B@~je%rXo9Q5v7ah6k(%}=~{5R~#KgQ~L4a)l0?M7nQOWpT49Yh?Q!^bOZQp>Y{ zS^BP0@6?NxW2poMKvE;Q5VBgnx>1-(6Lt(GQLK|)p{kjl5vOTnePz{IkB;cmq*6G08iWcR`eowNx8)LBTw4`{v@D}q>8mjrT(rfxGkAs^c3C$pXYWdgZ*Cu;4>nn~BihTvh)&HVhgpOnrE`jP=|cky{s zy4s^yc;m*}ErAcu#@dD|BEGMPNBxVuXy5MWsK*FA5>j~ztt4`H=^zx~Khv2i;K7E$ zb31+NjVTKRB9Zo{paT$#d&!UnnNVaJUPCw&9``h$Z#oq$LM>uMkIOz~Q^BJdekGEk zYQw^Bl^KrY%jI8nri-f;B4jYsA1(gYI!2mZ?H1dT(ASizF*W{PBHsS@w z7_7c8_8q65lgz-yDZGdDX2WYMjyWTF@`r>EJ7N5c+`HPfzt?YH169q{e`6*Ng6QL8 z-xQ|OxY)V=Ym*{uc&Tgy*ntx6?>!W!)KntJbf@y}5G+VgvuMpF1580}>Kv1=(fo~$ zN^LOUEH)-jC&jF@v<6IaYB`AXP`cCs1X4{9^YASTmMNT76re)8V3Che^-cB*O3y2g zrD5iH@L(d|jea?x}6%;&jhggug<9bhpb~1xj(f-xS@5C0E8!ajhBDNn!JflM+ zMY0i=C^UJE>iFwGG(r|_!ALP&iSOd1>)|Gt9!K8Es>2j*#rjT{mmFxAcqAM?*-4L0 zbbE7ikBt+|M6wwY5{UwRyEjW}DB@hq$*~j8gk*zl){lu(i?xf58()ZAGf!+%Bn^EW zOcO!|OYxTUoShSFbReIip`yd&Eu;DBCFX>2Jg;YC)h18JYu3|H)GRu#<@GpxVlAd| zfwn9`>FJw^>;k~-fk=hsH-W|(7B#*BH<7O}bI$^la}@;v%-AWG6F1)r|I;jIZXVN6 z6)x6z)_nq!e%{^5;Z-M~OQob@Tmnyu-W-+(Ri4F5wuv9PPKY0wids_&A#*p(tAOaa zbywFFPYmIfB*WJphAvZ_HqDiI5Un?{x_~Y*QpPq z|5hO{C9SC?n$gd!VO;w#dj56(h5?0sARe@5$=52rv~qVIwZQhdDTKOogmYYv`E+b( zxkM)>x3&Gsf8kRh@zHPC+WmMz(?mqUkako8O;3;aszlq!(4;Esv^$ht=*4NG`iF3Y z(d@=%oe^?G(lDX(Lv6#yzHon6vA&pBlbQzFE0R8Q#;9wwmU^^$T*XxYp1!0Pw}5q7 z`epCC`|zsaK0p^AVA42%H0sel|uMvh`LDEY|4&@diSWDA-g@09e}0OCHvFL z?M(tfQV5$+DK2>Xl!}LsTKct%{R+aVfMRnrZYA+ZG7C0_P(M)r9q!fQ5B?Fd)Jc2 zmKsr3bNOz2X%?m(?hv_Hyz%*XH1%o9nXFQT2mOTY5GOG$cu$FbSWx*R_{5+L zS#yOj4Xf{NmTcSYOI;CJC`dzii~!H@gP2Qs8Vs0SGV5&&XHa&m6bwu@LUmLq6p?WV zwo&S!i;wxw0rI$_qtj>2z{N<-c$8a}vwcQ<+@SR^ykgLG1t0+Q*w$u$MOOP%Btze% zceY#{yYSIe?yS-hUIX}*C1VJyW3X}fZ!cL}pp0)();JL&aq=&3NC!sV3@7Akw|~P? zvoHT;g)V?IQGkVvW+Y`U1qs&j#jxmOB7tTqr;o@*hkn4BzC`YHzbeh7FJ`qI1x9v! z`60){M3)Wt`dT4UDateH6~$NgOMq*pjV;X;)*G(U z?i9YcQ^OFZuZpLiJwR3ezPaq~)`az;Lqjx?!Xm#g&N!U1N|QSb0In62FXl5+tv_`v z1(hA-)aRjgcR;{8lm0hPq15ILO(<(Qw?JKNie0oZVlKw@j#@XyUY(^!+j2HH=?1+R zYkzno?bkPI-F@R8cQHX-l=NU+l<1kwC;NW}??&L1^Y6t9a%_#SOE3Q)P1haH_8)bF zNQ2ZY5?hhlBX+4>il|w;c8pTHwfAa?J!7j?d$y?BwMQvcS}I0s)>dl1-{1Q_?>~9+ zPyXRP_jB(#=bp1L+_8$nZ96;{p{7zG`6>J2or~;4rcO(n*T*6ZEMi`PFb=`=_of(`}l5h7S{u_vuSaWD~JMuTzXQ_>|}QBdwC19^>$% zfWVe(@{?9)l5gDL{S6L^#$+abzNU(xEgn^DX9J<5Z`_+Np8^q2`lC^+`blc4Md-yL z6aiE59McFaOy!duV*H(spDO#qI`J)=YV)q3kXjVq9Hyz^p?Qkf$+okM+s|7ey7oA; zD(wZc&ZeW^K}EvqDUNptbViuc<4k9$K{MZlVd46NSfb*aho zS@4$TpBD8YY9^e5dp7K0X5rkK_iBH3pU6bo!5Hu~0A7u8!DY>LGDHoU=hLpwU&@U? zX*Let5JPaCj(362b-vp+7L)XU@ z(zOcX#g(2*NCG}A-g}B(uDj>Ie?Lt&SD`QvY716}!7vc1XsI&Xm*D3we}-k15#y8e zRqYVW9AXG@0LUOnCC$+s*CdWce(9DoJb;c+0hX-cZpV~)P;sT%L)9>!b*w_a zKBj(-fH<)D{w0R7d4`794uNDdzz|`lvU=f;IE%yc3A^))s!hzKYYkbou2DlX@TGjpY!I$xn&Pw*SzWS*!Uf_$ z7q5x{;L(n{FfhvV${rt0wU8vT>{ zlQh+k#ILMQ)2v>lSAeSY?Md38p~Cd1>k*)Te!iYt=qnv|$I~+*5>`Cu|6{&K83W5u z|Di%SApf+yjx2NYeI`(tAJ2N%4H$Fg?owH+B$2d=PQJ9H8!N7s54 zJ~}kumUHknFg}U?zif7}#;LHo?*w26p>dapM^yo9ODZ=tKfKUDVA2}wlQR?JPLdcO z<41Kkdv>a}E76S!L=dXYg@5pE9D=KD9CSy75%~YYCkwS&`faan)>Zdia`eLvG`;`; z(@i9*zkPIS;}ao~+x^1TbC$&HU&P^-6_C!J0VDauW(D%H3Abm~g#zx@gyxWr-OHcg z$z;B+W#{q+7Cc+XbLGDfVGaDBnVb--g6a8*`{4iA0*n=KJ6Jt7`d!ra0CMedNJIg1 z90+fZx4ivV+J4a`oc)1Bd!EDo2*`4BkO;FXo>ecceq1Hq<3*t7Q6DX2F*#~95fiZk z9#BkeC})YasLX#ez|SvNyth6!#$<>1mHE0aGffNG#QWY?B!9PsQC~F z3jFh6&#C5$a^Tf>R#yaPj1OcGCg9t;L;n4}wyZ_I3mElrt&w97jZT>(v;n>~y7u?owE-&U$o+Fy<~%Us)~ve* z+QVnW-RYg?~2*Oun>ku`!GBuPFt-Vvn z9jGqsbDr~MO7%Q$)nkh5O6P%NX;ed0bk(t5l2)|9sTo{Gz6R?#sE|rfJS8A`Q@b6; z-m7K2)=l^^y}Rge6b#s>E*!CDBdluw&y{DhP=y|${7-Llqy=OWyQ<+bBDo?rB|6el{1fD8wR+E4ivB*f4uNY%IfmMP%3dbP z84!pXbx+BC!tZ#eAh$cTOlI9m_q^xLj_!V3dNj;E@kD-%!|T@0mG)kzy#TgK${72j zm8n~Dhik4ddneh%J$*WA+yr_+%%b(%ThVQDj0qL`l(#VH@T`PE=(qM@b ztogUe!SXi4q&nd|z^$Z|s)WaxUZN8wmxn{zSbHo@w=o?!jjW_Puw!#F$w-;7x7E~U z=g5g~?tI6;C$Oa6ca}($7TKndk^HluO8qvs+W9Zec)01~zgyqFWu!hJ5czBvtDXWa zOD=4aV7&K{mTo>1qz_T-TWT@3$ofeuwu;8tI4N?YF)nfYrL8P9&Y--omT=Wck~vZ( zNpDE^Ll#1QNZKtG2vbZyTRlW9hy-9fHn`G;=S3Fn3Y=T?NjD^v9FFfOaF~eUj%D<; z^|iL8^}kbm8R<@w{;V;Fo45NSrdqf3b@6jcAiMnRe`~hiCriu3`M_x=yYd6fL=7zU z%hi_EYfVxq6#3*CUlI!`8t~1XcOa}+#mC(%)BTvzo!L=yn?i@MFxm5sH?=93g1N5d zq}@<&{5_WNd7uHD(sMu)su zUb1q+@D@02FklP3XuSDmcg#z;yaNaoKz_$B-mxH`#FnQozv{+>cho;VrdD{epCn{e zz~c@DAqd!q8hS5Zul%&0;Qb3xgJdD!>&D`wy3p8iFe`<*^(O0Px70L*q67MY&!aCT zDP(orWAsJhD6^zWyq@Tw^5m~kukU0aKyoEU=pmet%pg(q{0sQX`u2aidYxB$>tV(Y+JrI6EIJ$OcQ1P&(7lnzXl z-U~n@dw;+0Oa#X6%)? zGM*ZZ$kSeR%-H9u6kiYB!mD^pEXfK{gPZuHRSE*e_lcEcj(8} zZvIy|wj<+ThWa%hsQq-kB5Sh^lfk~|R^A|#^ibMn=)2}ixWun)g_mc5XWUiJARyb0 z<=Z{EUX*Dz#Tz~jd*_)t9sio?UHB`c&ifYdmjtGM(w+elp(n^$#^gwr}X)Hiitu zO1S3vGX(5dw1kW+yPM)XI11mpV`SMSak^o6s))E)q1;Q_$+CNoXI|WV%Ogs`2%p-vfU1|?wg<)X zV6>AKzL5#M7-cR_DrIu~9mzw3M_$KMZ}HrgA{)=O=+0B|(UGIVGSG)_H5B{VJ@r{ORu z#jL9N^zmPd=gsp&Rq^lL5hTDgR<*rEE6b_aaX>=>h*wRra&)1l@yTybUYy!y@mOi36GB0fQ{{91g@!cGftq4Vu0vg2Df-sCDs@`_3l2Hiq;6*0+ zj{rqe#5^>dy#`(Nb;xc+AyxM*MGc6nJnE;HliX*yV8~KVr7|fKa$Cg8|6P?Yi7Z@% z2_CO|{deGTB)#5guX~Iy*I4&O=V~s`cgI|fVp&q9$7qSVzL8x21NFk|Lpk?~Qs1JX($*UcL zTWPlCpX|qK3J#)iVnmDb>VA1aR{`4;NWgTv&aET!tgUW22tg*}F4nU*+`tz~!b%9D z`f>UO0cz=ej@@`|^sdwF;wYWiknf`Kb*d}jUmRfx{Cy&xTA8nNKh6nd4<(dvv?0jp z>@2tzByLaAv47LbS@s_>%$qVEO?5~n{6dpYIok9y5+Ei3fqfW!z=!wG?ENrJ4Ir?1 zihM9>j5r%hm>|JuHah(Cnck?H#T=9yD>msc<1O1SK13ks6|zk9=F5)7KS$GAn_uai z>XECh{4Ji;@=-%2k~ew7B}cQsz~9hZ$S=yH{UhaCBEepq$q~?eihLwId!y^h_Fc0` zil}6TtXR@eDUzVL=Xn|5sc=2aWS~v>@Hfysyrcc+T#N6BRzGW;1P}+)48v$a;0AC$ zY?u0ul}5_iVDRA;yx<+>dcJ!&y5+*cvg*A5^G(x#a_Bgrz}=RvGiUlqw56J)=PFs* z*id4#Wz2tYNaq=2*J1zCSvoLFc9bM;e(U;CaL=U7^r>JbU!JNdG0A&Pwty_^Hd{R@ ztGl;zr?@>op?B(BS}JD@2otC%SEDkR!slI|P?+9U{Grs%oPf*EGrYYM%2BLLmgN7R zKbmN`ddociu_jpG-c2^D5T_|>){6-*>1qf{fQ&>m*}i(JCnO;q?7w%P!(4SPEZ;o3 zO<-{JNU$YQ;7FWwZEBk0SynR&M}=NvIR`kqPA$5Ew#Q3lcA%(GXPRyi0yveJnr1u# zUyYg`vCHp1`5H2F7AMQSZ(xp`elDaTe`&E}%UF23wjJ8w(W%<<5npkU$2Xjnyf?l# zm-0@yeC)W@;CAAzm81*#)XLEU?*(p0>p$cgBle;gbDl&cXw=! zZ?9MEhHG_&b8sj!^O=XWL8BD4gSf;jt}1_UWAh-iC=4*RY=D922mU^$LgD-%NNLDJ zU6cf!FBkPOXE~NF3()3o*;T>x&&{SHz7ZPzBhKRP;|#mU7Cwms1}^Y}C-xieA9VQz zUa^UG>QgDPm!az+<-`2<0)V#lwdAi$>Dl3-S?nXvi-L;GY2NQ&o3T?TTj!&rZtTU{ zDJu31Pz4UfN2J_X!ffAj^UcNJU)#VW)@~$s-w4<7;d;@5@8Pm|>%_Q4Km{W=eRO)U|5rRT71y<7Qem95Gj);__1=lpB zju&-2S9vfJZe;K)yIf5)tZPy;!*YF;+ip1ifrV3xKD9|SAzDQ^+0g!t!ND5JTwp?= z-_3sZwSM1Se_01y5P*0LIX~(E_RHXdqnjPV?9FYMnqy#38e-Y{@AlTLmt@zmTgdu< zW!uYr6SMU1TZ`PqwDL;+KO6>-;9UGC_ivx**$FwwEO;EED=i=pXDiZcGIR%^!KY7q zU$F}g`-#+(=@QOvsBHtlHqeE6%#lBTdt+>T97Jc=oozZJlrnr#xtAypdI{*`RDw(o zDbVOo;@kHU)QN~Xu>lc>t0RGa0q=(Is>O|l>Oc((htrMgqvRKevt)My;lNi!EF?%O}wl|uC6Q*)fI^gfcl;vV%t6ZCex{{&o ze*daU-L8Lnt_tx65=OB1Vm#%9nO3bNdb}SYYrZhz3$OkJi!uLUlT#7q3_=cpxlxn6}SXG(CJPj_ME zQugf!4q@J099SKub zEX$2wceDc@sT5>MNk_*<-1BjQ06G%O!2yW}Wp|rNmcgVkX@z~19Wfb; zlX)D9Y`Q&W`nHEEQzg_91r%JkZDju|4x*Ab=}U{2k5blluX}+itr}&$!TFmUcI7;? zsH@e?Ab{Tn#WTfj9lDf4*B>@^X9Mr@SBA*%3zlcyz*}AT=6m{j$sIb574)AGuO!D^ zp+Gh%izNU%Sv&vzUQB(RQ<{7ddwA{t#Kl~`r@-jPQy3pHmcdr@vT^+nEYwo(~liB>- zxe9~&TbS|7#8OpzHIKWBAxf#3hs_U`whG!0f)zzM4nmeo>i*MhAHOg!Mg^ClPX246 zH>*B34mZ!*Wh-CX$ah_o%45?VigZ6LdA6-^RWXN$K{-0n*=#pw+Qf|oJf;5}RpP1q zCiMqE#zf*e=2tjj2oOAMpNK$F=h85h+TzL2H;`AQxzBVHM;NO!VrO#$wBrO}d{SxvJl^P(-jFOfXukXt;HNc>q-i z@_8WumnCLrVRQsJH)}zjk%kQD52YXHrql@tziJQfmp!)ssPuCEDYtZpzipV;^sXIc z7V-F)mz5sYwkfxEPD+hNS(uIAyKR7G5bU}c&Oie%ytfL|x00U79O>c=Y-byKYb5Mo zh2Z`*c?+W7>Q$o*sjkQ=^kLh7=&6t~r9fr3l8YKV{gIlYY+&;xN$NFLEZi2*p6)m~ z^BkdF07@;nx^j--Zn2Bd+QL(ibu??xpUqMauC~1b`K+aa%#ya&WlsLdNKEjab8TMPpUm_Ab z{Dqbg5(sqx@-iN;T5(1-JaERYr-gB(Dl4(us}TOf0I-})(6BIO#k>o+4T5O$(eOK2 znX9&#t1(3)3rUcK*d&}~%2RSxj6|4ix6P;IHoZ-7(rhWN#yS*IZbAZHPVF0nm?IVJ zq;8S(Lbcu?m>wmT_pA#ay_(RHzUc55&aBV690Fo&mo7Vg;e&>sTswUE+$JP#?69Xb zgfjQAWgpD3gtT#bUaZy*G7G2jOs^6PM=LQsIfw^?5%uunUV8YO+mH_Qx{|w;)h*AB zTj|rk>?t133L3NL*obU-c2HQe-Fh`JE+y&D1=d1h?t^8mRtba6r9)wO>cpCF+iT&v zb*SDXMI`=XlF-0O*sTJt!XIy)bA{4Fo|mKzbXh$PF8Y=(xEjgB)VV2Dm0H~v^rmq>Lb&IpU?Ba&?hOH@_hVN#@RcQ@1{|Ld8wLCC_fk4A}3 z4tnY#wq@8n4W%d-5W`7$3YZW$8wh0}qU=*pVDhjoDK`S<428{YCOx{|l-&jtK}k61 znh>o_{|d$u$W;p%+Y)D4jhtaZFZxs}dRfCx?k$Gz5g}0 zu}`7kadQ>X__f>s56_;o&0lHJ4S*=9pkV2;Ab43j&^9#(-4uDXTXCUAKTXm zSg`$5gO)LVRSEmiS|NlgjOG@$5^Fr25#EaR6H$6Qy+oX-$rCok_I7krn1``B-@f## z{)@VD2mPU(kaH3yg|*&kABI~%D8>Wr`0ieIrEVW693WuANRyS7DM?d*zU?Z|0=%(J zhW*Kt%pp?92X7X$9a6(oQvHI)2@>am*`y{5YcFNog_(vx+=}62Z{4woJJj6lQD zBABQYlZd*>Vo)|JtMB;!@k)k95uGZxUXm3?-*=1Tc70}Uu|ut~vXLcWYxJ&u@aL^j z3dcBAkIlHf*WSd{2$SF1TRy=8w70{F1o8X?f_?n1Y*3Iq^(6uh`Xmg#eci#g+rLvy zED%8qcAM9xW_+GuFC@{EWc8(RIAf}b7wj^j7}`J$B`AI9%n<<_%S=xX08F~87fwh` z2+uuktRy>oYSB2j#U`ZjlMY!%;C86h#-UqTh+B|{;GmlzcTkNl7jDzh#t{+@Bh-Jz zp!{SfizoH^U)4O7C1e)6;*m08wknfu;}q7b45B%U0i1nEsFZ*50pgbrDyal@R5MD( zG(B2#9QZB&7tEc&nR7O^N~~_IC1D zGS&iq_>?nLuNoAo1T_}0%K*+ZlB92A!#pR2nQ7WWZ?Vh#+|i6)Us<4Iqn#7^?;I@l zX^Pw{+up3oIZ_*7$_zzz!Q4akbJIjiue{=(`v00ZUEy1BY#Ijd{VJ^sTK^Vuv}D&v zBuG6Dc6jk}9N2y4^J?%}H>YGb%SM)$Kdk6(=DGl9wg395m{Oq%<<^(!Z|&9<>#7-k z2T`ACdA}Z?#(S2UKTdV!<$gU)S($PjJFhV=tDp|Zo7^-YAM<(sY!8-Q5{;LbCsq{O zI0OJ*voGo%JmVSnvV5doOrAiNx7Yl>jE^Sj%kWZcv=H|8eAp#h!sv$BV`7=YVQ4Zz zF#?{sEFeXi%GzGSeuYw$1%S!mpsE#NQh$0TG=UaWaKI*H12raaAHp%&dgF@v2-ku0 z8!-^8*-dIv21?jfrh)RwQzCJzhjy0dudRAf3e@XH{1*OEEiNetSQyQGU)mHmc%7`=H{ZG z+L0^rusaUeMs(QX&(Wof$AUx&+!(A5?dhHvF7yjwZ?89JoJY(32EdgSHHWh2Z)Olf zZH%NX2T%w4DLi3{TmJEia(|W(I*0&Txr)qxE{ozk`I|+4hzm^`6E&H>({H*<>V$oopjQUJ9D@ zknR<|;@?r5Fk(UuC}njXbdKWMN{a4fk#C3R$M;0lmfRZ6D%r}>F2KNb=fEc`YQ$lH+^EC%QKxlZ|XW* zqAQNzEwOv2_JUAsF-p;0vn>_>U zSJU3&ej<&^QNihY;82|~9?etU(T`mVLKqDA(^o%Mi(Rjtzb7}^fxzFz`Jb9Q5wDK;R(_Q&i74r^*-FQQ;We9 zXlv4822S4|23k1UoAR0eSDxdl!G(R+1plo>GWv0f|srbDjy{PYRcwdjLfLCRL_8`$#@n# zTnhD0HDGRu;cp9_z0aX#(1(cB%=EB5Jm1)+W)j;+@u9&(4C!lu9+H;tuVRsX;>|V@ z!8SdkBlwb}z@FVq0TCTCG4T6w*PT|F@=)lHXNm{Vm&1)?ZbWoM9>{8G61mkCLzb-R zYTxI2cZ6z$ifL2%1|1jveM0Hy%qg1;rdB_}ebzm8YQx3nMJaV+KQ@#o2ya|1_PM0N z!*4Ia6(`dAOWc zl-%F`vYGUrGXC5PcYMe#cEqNZ>=7P%)4ThuUkdt@A$x87HmP`2$3n_mz0uwwvUDkg zraL#-h72E9*#}OE!{;dZld*tzxv4=61BaanGrnuYXdK|CH5g5i81lDXp03P;=*Ip2 z?rKjP6H6CMQ6VDejZ}pC2KstkUOH$q$)ujkd?3$jl6q59N7_`>3?u@C9Ask)aq)j1 zQfI29l3b^67O!;9jJ#kZ;C5uvRy1KRiDc*z14(*rOk%s~CvooExeObkGDh-kzN^~A z0zB{&Qgvfqu41v;fOO2y5aIWY8ADH%pk9&8L`cHQyJ5~7+yQ`^wT$SfpLyi9?E}Gb zWo&5}|Eh0nXI!73E=`Q!KLPl-XVoqwp=-nKdDqfc1lkD#l-pW}6N69o`0V_eAng~s z0n@%zIBU+hw}s39#q^f!>3FL2d&>- z31hq52c)C6Q4{`kNqcxRX9orF>WsYEN_QrEBF|`}N8B~3&Lbz(UxJwBgkh>^>{aZK-XakhO~qFAg!H8|=W%*YjFZ#w zra)A`P2rfZI0eg2+0M`(S>^CV(t;R}dw71Nw$ZXcf!LXlHwBRhX$ESaq;(8-vhPbV zD=1g>Il2+I<&~K>C^i@116W;_3z5Wy@pGs^5@0x~m7xVq^Y1%pQ+6uC>P{#;l1EEb ztCO6z5v%AG>a@`quqyNTEf2pKk%y{doXbnMK(&@Q$!mi&K#3Bjm76hcj0Z$AV1va~ zIt;Ecqm@?%+lW$NXXCNrW+3G3S5qOc@geWyM932H=N3r$!TEwTC?9yCcOmF_qk>Hiw4$5W^M zS8YiCQKzMRQB2vp-r_zHlZ>mlrOScM9+9!P00F(b?UoU=wJArt+~y$nMz8a-3EAUz zBvcl&scBB!nUpEE;S=U|xb$L|E^ev|7jC6gmI6hw0itEGifemc!vEI-JWIerQSBFT z)!q1dv`kAebi!xy+N2{eLSVjS9+Us>^F0p|{^$|Zzvz$Ca&!yHAu+a`F^#Byr;+`O zjaEO;r)2*)SKlx>LYbG5pife*Nnh+H>u-_&?Fl)lQ5LotGyqX1^bhg#x3V?mw(BZg_IdbD+6Py+~vUxiSD}+@%aJTVc94ZOX^=80kG5AQ@780o0@5NXcy?Hs$17&!xtD_uLAXp zsHGq()hY&$o4qM#B)6ibQ-ulQkK<&y=U z+6Krmo6RG5<}-et;!mG7JwI{!!msFF#T<59Js>kGAga(U!rl8VIZ}vl7Pi@*19Jskw^O-kD z{H++w^K>YOluF?VjnQO8CS{a`1X1iTu|p8+6DC~0sb#s4u4Qz>cc+bG%IA+ekNXE5 zA3Ru=S-J@Jr+y#JcY(V)4wn`Z^YV8#+xQ2xy;go(p22Y2M*fSvuA9WcL-_`gLf-K9 z`$Pth`kn?XJ4RH7%o2i$)KrJ!YI9XHL;7X;cekZAG;~(%oYS!+I1PquyVBl6k?LqK zyU6~XU7`CxobG(LuL^rNC0?krXEq}Txju0xfw~Z9C2Hbr3%^LQiu;Lj|~exdFr&FYl2H3$ZHyY zsu3dWKo+Br#88N>3&)={XM#S+G}%|R;pZv4u@{2x)BcCK?{@D86Rx-m6fqJ?#bwPvY z>Z{e0cQVp@ELvfHtc9X)INgDBzK8ZSu2f9nJP`&~BPGT#E_PHt zJ<&xbZlu|3AA?jA8V7P?z=DnTb~sM^R|%89uIf;io;?cR5C+y zjB?}{jz&tU>JRymAXG!8F@VOUJgqC9uC(c#*4h zukuqX2R2@mmtnK*a_xox?9qNp(=|bS$yBgY$-p^Rzq5a@*NK*bwC_)Hp@Om)*6vI^ zroOw1u@ufngSORUd~JePzwUKx4@!6VIcTvmC)#6p}L7daDWC1fwsH1Ss+Da(YnQ|uuqTA>V7qR!}%^#HPV0o+`KGAj7KNp1GA z)3zuMC=hO-WA!Jwpxt&fOn;folfV6T(;P`F`exUPoV9C;E-PJrd3 ztOx&%z=U5$v^i?2wo$`p!WeQYy%b zhl_pAmsBkPXQ7s#z^7`)3^t5j0oi4{itXY}?-m((eboIV)#`iq|C};MJhjk5;!*Xw zvVG7ryXw%Y_)#5}&$cP!Ck}!no$M0e$}!*bFDvo#i*4uXQ+5U|QYAtp;YGg>z8_9d zENwfT+-ZWUecHQa8&L%1Uf!yI<&H~ZNbMEbD&?z%(-%O+2&N0AU$Z4Wgp%Pjpb1k_ z3Pj8U&LfX3s!s@9rLGthH#K`PhZuR;)F%hdl5d1LRtQ;GASrl<70PWiNIULAh3Sxpqzv<_%5*3w2I2fq}6rmr=OGBt=b_jnanom>q7-ONU>)2 zb&EobPf3CWwzIb89}!hAY|QG=eYbth7Lb%Z$rogI=W4jorLiv`LAVZm_T{(vFr8x= z!1rtP75(Z?R?DoMzx0oe+3eyn^drk~9_4q;zN!qwomkf=8W1}brBcQ|E6wr+TEqZuB)x0{Y3d`5)V8%Uc+NQAl-4&wtI<|yy>5unAS^^v2E7wPQ= z4N)93qI6$e%9^C5eq+o1ETd%{MzHU8EI-!&yAZnh`K|MKPi^nyt6Qh%_H;-lQRQcV z;j(|Yk0;Y~ZtpQzE4Zvkl;(ik$9g7o+x&gTXTgRnVdJ5GD*_}De49w9NHDqisE-2t zZ&K3V@^GwRvrwbs*(o`d4~&|h(cc!N;UE1whoYHTF^6x!IY&XahWJMt_i8LjirqCE z;0~Xlam&2tu%~*~3u&oh1$-y}I@54J&5L>(H0mKFN{DWTFS}xGY)y9(lFRP;s1M7@ zMtQgDigg->DLv^)OI{~6k4{&203F2Mxc?&RK#EzO zlxsA(58sY77~Lg^@{r#Q4-h5|6$Yi7Ydh-@zDj$bb)TAu@R z6^dlwT8JLH*G?R$-cA;0(t6G$G4fci2r=K6nOwNN8@~s&_pfO`HT7|O_x0}xY7455 z)Upg0Qr`XI*;IC18d@p!+p~Jd!HP_~C+Ay&HFLK)<%~h})TD<^&!({FN;(E)IRnP8 zSZR%9>i)8-ybPa^qU#gtR_T22t>f0*$RBX{y~#ltLc$e1|DK)l#})06{rSXc=S|*T z(2eEgZ^>OZS=Ov6pj~mujga88Le7OO&$c8jha1rfW2NN}^4%_2nEpf4bE1J@RuD@yvO^CZ6wrAzhrmiPp7KSKGlMds-D_v6_Qc1Ff*-?8&(K2A!?+tx+-0N2e6&?gskE zevPwGX^RM)oczM!KSj{uTIwci+vL9I&wizADP>khB4tj zuKL6^WoI=G;vN&9O-m%A;k*%S4cc?j`hIhM`EFdI+f2#>{@uAB?K2_h%m}jQ!?^~91 zVqOVD=mYgUQB1<0BQ?kh zNv79lI5*k**`x$H7%APsh5LVY+0qgbe_K?ND#Q<0TK)13eAu3$ukW4IS7Xa}x7=1H z{_2vzUf}Sg<2?;oy6@*1G>x%yB69Z`U^AwM$C8+l&>`?HHj#R5nwzhW($<;)B?zY1 z`QT7b0yfo;&n_9{7l4-_XDx;24Kzycbc%lE&UZ&-5JLyVs{uHRp#XW7$9FHIKbeYY z+GOtmzdP*cDplU)a#ub?rDaWo9W-57wAvcJ3hfL#ecG`1mhZBu-&VPN(Xy4)t|z+Y z4Y%k*qZe9$&!%vAH8aKJOpJMSKhM^f?o^d#CWZ9&ffbV~C!B;J&*O6_+b5ndzS_V^ zZ>hb<^aBD|z)n2HtQMSDW~vi;sM;(zROCEiEXcndAR)r^HBDWSPRp`{wZf_WjZ z2d>tr88Px~L_c@Mv`a>=QP;!S;M}5x5^LOHKTyNv?pdqdEd$pjDW zbRgNV4J?J^3U!Z<6{F>l2b71m!b=JW_%+d76C`fpALWg`Zd`h)0%_w{j+sk{M`%WF zMKp+{>co$}rA_N04kL57?q*P6-AC8;-tQ#;G|2@!7M~(Ag3k zRWD9&Nvef=Lha5$)D>OS7pV3zij7G8cTt3GmXkxrY5UD36}gAdT7T%oq%(id>DqU( zf8>0HpkiP9?ZNjVY$#5?e`OT&@jb4N{p;MxB@zmtLh89zRjF5Xs<;8FR9g%y8CF^2 z{JfAn!Ad(NR5B5w$SR zG8i#Nj}5qNP)THRhIc*<8v-}NTCh-k)%r*51;nc)V5k&qtrb=pWj!JccG7SJ6fzjx zvk^O!-vCRc(13EXp?472bbeclM-~bYC=g@<=!h%g(vj2^pL$;uu}@qEo5Yf3skbdM zpYdoK+nbarb#+UAalBu7Xx7@E6gDy<8{FXcUuAU7(er-Z@yMm{9^iAINaHbg?-99K zrmu&uP#l~c2kFSR zDkgcb9J3Dn01gm3PT7!{g1c&ZNx%)^qL!u-faa}m)Ojviqp#fM2Pi*{8k+fSn2{rHMZY0jOHd8eM3lmq9p6j;4kkT< zY(-FDG7c{CEFGB}TeEjA=I2B-gc`A0p|>h4JJ0-PVf@g`Ux|BvcyAqAE_vLxe#?P) z0*6{Q*{I$IUKG-Bv^bKQP^#2Sr)cJ8-cI6jWzz$FRWX7?*y1M=|_kCeg*M`jOp7~&+gD$W_3n_*z{idqL-0vMbad${p>5tc?A8ocj%7^Hy-FdWv9E{IL6-|jwK0i6ai>`joH&O{o zALopC7x$U`@6Yk06!JQ$@@yEPR)od+OP^@7y!ehq#+MY|@Ao3Sf#pO;A8GLK#oIU4 zWiSM~kQ4TRmSBu{GA4`?KWc#G_Wtepemh3pNsnhAEM%`zhQ1bfZxS&iph0E~oWVI= z&JuO*slX}9(B%B^uN(bYhV)E@irVy`yxy|lt}4&2tKdw5*mKu~{0d3a`xT!$@}il7 zS?ain{TYf2E&>${@wq&G5kNrntjV`y0gj<0LGZ(0oe}v_1i4xe8h0-#9v({T*4ub8 zKlKU_kA2${;DPKFd8cYt(|4W01}E`<879=XB(ol?w=Xx^NJ2jFvNK{ov*GXDN85z= z(1fC4is8pN)QXJG@wb0M7K#wJK@_I`<6p_c0{4M)ibCsZ3qmTZR(G?FPa@D3ZwvIs z##r{GfiIsFl6Wdq$yb2}Z@Bpi??VnLO-i~?_#=!`+7kI9SR?!5iPZ0Z^cUYO5rLO{ z+c(2s<39%m9~oUwjjvno6o473j0^O8G0mqCk4bXP_Ipcq{{%nWeYEs2I-W&F<8Kgr z-?>Aqa~wTLSWVKQH>wnmd@{F&Cp$WMsF0ClG2Nf0HSZqfPf26SC#G<34y~D*Fwss0 zUOX3nimQJw<&am3vua!TdP`OAeo)2!5q^gjb{Vl=P_S=3EzrSPLOykbs4_OmN7NDD zWcxz&$w|!v4Ud87x(_QjfNK!@n!~4A6Tv?U9)DXl=GioxJ-?#jP$X)SQ7Vqvk4Vz9 zEi4!s=t<@&6B>TfZNpSt6o@5@WCn8!CkPHBANW)x(d+9P+P8kAN^X~Ec~c!QWuahg z)gyanNYnU3=*PFTu!rGE^!$03;bCN9DCI$KvZ+0v(`S5@LNvUiu=A&R1}PBPhvPn- zr&md3B{inY(a&R7^V|I=|0{;nRpk8sspWMC5SPTNxWpHj};N}2sTXexTv zX^~Kp>?PH2>LmJdy0RNjQe~2la7u(JZ9N|T?EH7g1i603%TxN8D*-4u0;yM!H$d@w&$y2i*Tq6DyhrU;cnymd%x0W+B&|dy9BoC>~0~oXZTzj0v%&Z_C zD{N?j@X7Kt)B6ykEZi7_Tva0NvD)Ft7-p0q<6+`ht>3|OU}`H*9yj%-=zkrx!83#4 zq=C44S9Z(ShP0eE3sX@SWP{DYW$o`1+3% zOMK~Uw-@@;+aNbja&DMxv2zxVgEbc)BX!`}a}U2@(#AOm*c{6UfW~T?R6kwv)rbTq zXf2|MhM%WJIwN<%($n;fgV z2W0o&O4LrqPA62PZp9QyDo7BT8!Q>U3zo^#lBfNVnlnQT=%V^=`!f@W%$z@o)f!2g z-*$sKo-GG-#KMrman3buCoTl%SXFdf8t$p;wib19J$0cn<0LO@zjkdzMT1_|kq?v#>liTC+@-}%k# zJhQWZ>>oSVp8G!MTyc%v5)aEuAy2a=m&glW)Fs9arX&y;;lv9(x(YQ3B@oxe@E!&e z6i8TNMac>|9_2BHb3{aqvWM-d%ltbZ`irolu;zQjM6!(vE`UQ zsIvu+0PJi+-B&+SYDkIGZfq&iq51r;uOlDA7Hy^E>SxyYQPP-b3UD*6O9^Q6;u?zh ztI;qavWyEr#c+aZe$CBIZr__lR6pWS!I_lVmzo{ifg$*Bu0Y1_-P93r zWS-DbfLYUtwYYoXGtVTG4&&7K_GA|6-GDP2eOm|9#!yHTsg0oC(_1%|K~uNoLSVTu zb86nS6!6&lsBU=-iP!nDcdPu>#i!%GPBi#*)>R{04Cq=O=H1L5368g)YBa88>c`t# zW(Y}KQszPA7<>N)t@av{Zr5cRZFJuo3y58%nzPDF=w^b5>^4io;h(@(I0E?Ma+MG{ z34zZ>Zw`~63294Sumz!BvHvQ=I*9CKX338^)O3GDAxVGBwFOLYSxJLTv{AE@=ZjL~ zJI1*qe1GRFrG5H<*-67sW6jsfU~yoW8i6S=GFtam#GA5s#f*qAuhax51Ij#F#(NC( zu^`6D|9~>v>~BG0*iX~ta4Ha96t1heoMX~n|M-`5KJ=pyIW5|^{FhMcrI90YN)o+H z?{iox!nCavq#yB!8w7f6*QeJ-skI-^oK(P+=>_#ggZ z(T_ymss$7hvQxhLV1A*>A8v^gy1J247;U-@9H%mS^y?2?A>m?*`X(2Qw7pd$-yyvB5?H>yPGf17Pqo zMN0RK`&XTsk9m3_^4KXyYPl;5=9z0&F4t(FaAH=D@NksqSR7g25Pn9neK93Iv^URK zu}t30e4W8^=f3-3Pd1t68zX>&R3>((;w4otiZ>CqtS&9Lp1+H#_Ov=O{mi|(;1cZr zho_nn1v%C+_jF@8V=D8>0eQ}F45AL_9%=jUC;}uHLgtQzwJZLYU#BgfvXwA0KY$1c z)A0`rl&Ks$wq; z%$Gp61>6m7|p-FKDAVpii ze~Kb|GKTe)8PoVaPo5tuKyo)4gaM|Bd`Bpe=W~(7%{Z4~w07?b|H%5NaxX*F|k**PAbsLnVb(^AioNShF3^f*-kblQi zR9zeLt7k;Qjh|CZ*oo9rERN8u0gS8`cOE8aw~g7(D_84Ey*;BylWdiw!S9#@>|H6Y zIDen%ZV-m%5`ip*!+Gf5sXA<#&-wGr+zp!SGZ>@-ORnw;Q4@zZl-_eGiPmzgf4ZaW z(51uS86@3;WMC>L{$vL~*^u-T_5<8P;d;>TNQZQZ+8Nw*Cfd)>sBrvw7?Q+alHtqB3lH6 z_tq|p1&w*l{>b^De36=n5u+Wroq^caSdQds*gbg=EPvAt=^jgMH05MbD5Z9P>3DVx zjWANg2gz^ujdn*wEJjStX1;(hk6;ZAg1UC=#L2s-V!Ebl7nA#cRM&zUI6#6t%WH!)YB?J6^dN-;>j=MT_jnRk!=35L9v)4rxtSdJ<&Zm)-3N$VYG%;IDh{+N8tv%7nmX5BR7_B#B+~@ zbrF+BR`pNEB4kkRbSWu=erNLO7y*}=n=IMmz%kfPuKy2?OOA&K)#qd$E8G{QJ|_HL zH*+B!jd-a6zPr8sXn3f*u{cM$%m$ghfyP8Af>rhafd?QE(v#2;aiv3zQ?X)zx#oBH z?fUbFxNUnpMHm9HL;dPoUuUw;4xru+8F2R_(jfjBkM$k4_PlG(t;>dS0Q{`m5j&Ck zn#I^?*stDQe9?T2yitE9saWvyGH*g*`N}j<%YfnpP$_^XFlLJY=2_trKR%1*pK^By zf7mHs)LEkpB@M!>P0u#X*}{&3*;+e^>Tpug^=#d0 zcqx8=A2t94jR{?cW7MOmB`rDt%!N>AjAptWQu3bo< zKcPta1SHF?cD`6c#U{bP^Am{ZjQ8Nf^+b1Kj)l(fP7$=-@0}=WCUtGSDi9WR9t_WI z(#JKUW1Wogc;%xygfE=ejz6x~Di3Y9JWK~J!!mc*-qMdLmnQ}S57pq5&l$|ZEM}3j zZe><4H%ZyY*<%9PR5K2cN!3KR82_m!`JNnW&o+qB$8EuQD zc=QHqaKBU7%x^mRSP*f;$OML9IQGe?Q?i`Q%Z9Dt>jL?`{=H=ZP)RpVU`VT{3tNsD z&96vq(d$b_i6N4xT`JqV<{s@aIGSwxnYF$cKa{WZI>H8$Nwms}$> z)Ud`c?zVkaG)=(+gT%8yK~k|V*+K0bUD!f$LLgN_yDQV#i0*qkf2pCGqJ+B^;WoWx99N`^Q4`)msXhfAo>(OD_J ziJb9x^{i8l6ZUHxee*!~K{{AbJKdW=MhIm}Lou~1lgdnh&3Mlq>t>%!>O;rPh+AXe zJp0J&(QSf#>;RQ?=(8wWE(nxhjYyrWlG~98wa+1;>tacW0jPLm@{_CR!XNsZ1hzQ# z#z;CycKP)hKZt#Lwn$$im(9YGp-{6v1nLjzP_aUQ$Gr&RcME)uwt}sdpDN4BaOr>i zs$~CCwf-#d{SgF&LdfRm+4U*?M-!gul6-+bNB)OKxjI~OlD6u+jXew{B!;mQ~bS^&Cl(^-#YI5-kLuMa9YdiyI>8@Ldq36^!_O@uzM2gmMCViEKU59nW z3?R!9kpnV1`Z#Af18x7RanR3_uoZiM1`fvRH=0RT{PPHmXsFIi|7V1nC_qjPex73f z+{}-x=FLaW9%b}gT=?l2aUbOIwo75RJ8DEGJiv=6Jr~FNmg9)KO|zq7%zU!^2DT6~LBOs~)FgMOTa*X6d&y)8xfr zqK|Z!a|f2f|H%cu4RiSHnY=ohKHLLt=`st=0aE@Cbw?I0?>2#tc!q+i>TWK!n|*~n z`Mh9;GUUSi8;g!DFiX?Rg4E-|d#~?mad+%(OC`s+G&x*31o9SM=4F>X$H(|07CD)hpCacLj~-b&p2b=?fZ$?Lv$H7 zme#{sQ5k#-hkvc7J0syYYvGHS=M$f-$hu#A#x10Hyi#tJsI&ngQ5X^}gvptBWQ8`m zU3@S}PuXTwg9mP6$i<*Nk26P)%(&Wd+iyLv^k}Yiap#<>opo=ME=W8lZfDQ*UXN!#a5(5#+jtCT#8nb@B;4&@gD5Er;)TqaVue#CQ5Q@tY@) zYj}?k4Y6mEw}xqYePK~VS&bt`8b@zPGm2Pjzsg&G!ky%HL*5JcU@60?q;Vm8&q67r zTCcya2&SzGyxw3bxv{gXmX$^sF)&tdrOk@cz|c)atn0amK_S#0;|Dk6U;0@cVc+4j zA9-uwDmKKr>?a7luMtx*!XJ{!lBpcpWiyC4*{uYvL}{zHNU&;jZCM?RF~DdqS+-$U z(YAtGbv}=d2WNFNOF;+CK@UMCZRcU-d6m+o<@e8|J?y~kC)~hKtRPSaTV$dPw8cOkOc)2F6ERag9u;rL^d?Tec~5EM<{2YOd_*yrFpE@`a`Y&pJ0Gq+=?%sQ=C4W z8+lRud+?%`=is_UB7~Fo!j$~)kBfDI!*gfol*wGw?=j4DP9ZX}LL}e|fgZA%8)AEr zno4%1`6g3yvmAfC_S}q?LG==8(rJ@w`u4+3iRxRs@Eb_*>1JvI5p6cr(e|p~*;b)_ zoM#8zQa`A{Um+1;f844%6^%TnYsL9|58XiPBlCB$qQ-RHjjp%mW&oUWY9g4N2g(00TAm^eMXwMfT3} z0JAU2jFPU)eF(h4Az8^*d1ljxuIq}>*XWW%QG~Q_fT{)z6txY+`u@bw+J^>tS(~JU zyf|o+xw%Y92=sQLJpX7Gd^pcvrJvg7HXHbi>MDV3be^VWV(Jlpj&0e{=Dq1(l%8oR z7K#n1XEfg9$7K`ZPCYO$V?}^e4+cG)X>L~}ki(G+SJt#7Voh$MCZ&*{TAOB8K$&3p z4~MbsDIYppVik4cTe&u~H^kz2H70qCJ&I;jndvTE14&A333OTTiyP}3(+IJ=A4vBIvc?(X?qgoUy3-^=DU3r$8dV`FnOzx&bbIQ!aZmwFLV zw=(kp@8Dn`kG<0XOLNmX-{Y2ZoL5~AOvZ&PX7dbJS)aa$#riu&t_GjO%&?pcr>_)a&=R?r5dg@3rgg zH&eABo1i?Q^kdvJCW)|juAxq?`XWf%@gnKj+K674k4b_8Hr}=3RO*dce~;|n3}6}` zSJpnGf4zKnaQObues;&4Ng#l03e(c_`Ri-b*%vQHc>Ehg&4TQlyh~^2_Me{_+N4v= zwNzCxSS=6#NTh41W-S;sTP%0F`l zym8OYFg?V_r;balD0lI(cl8LaH!huK^XIOq$vP3y9V+5ajq8l>H3=4&l9*fl{C$M( z@ECX@j0;Q22e-Ylah~T69WKd_-w+C`CY*LXe!*FTVtW>f6uozxAVuSzI`(-L^>sU- zaHy0&`1TK9MLBt&IPdn;L;urNOYl{5tGVCZ`(@MY2pr|CdnY`Pqd!b0p)|qf9YS-y z(Wvx-zX4j)y=D6u=GWVwi!2KinSqy|D_wYYg3Ga=7TczqE-pxLC>97VE`(X8Hx-j_Q)r>Jj1Gmofkgq;CRyi2+M>gvo}hf2PYQH!?r4)a$( zro99X>oRdLdsap*0$uIhj&mlQ`F>wF_*_%GC8NzNY|3bB%8-ixNk7V`u8^{7A6PFV zIbJ6tY2-R%e=Uk>%qF2Ik)2r6GMY~Z@=4BFK}y}!C58BeZ$nN%c#q`UOE(p|CoCyD7iS@<;!duc0m=Z z%ddW~lw5lEhuHhI^gMga%iCKcv2IU%LKy0u$4R*YTm-6rLL^6rBTh5RZ2@d=5f`7c z>*+^qYJo4^D{)Ayytmvskn9R>TVCIIc3|Rw=V!g{O}Vh_N4e);Gxh5B;B@70O0T_7 zdv$}P&(4c{KHe2JtrfH!c|g-&PI ze!>%>Ov6I>WnrSxbIVuGUY7q@RpTGpFTGms6dtk1@#@>wbeMAcJaX?Am0Z@rUF}m~ zC(%68==q4G>l3(3ab(j2=dsU(R*!=T=0rc24`1D5*@L%dhuP~au>n@#wD?U^+G=H@1;=|&vD4&X` zwAWG(YfWwYl&3lWBKXJK+wWJSz;VVkU^Zr9>B=8N$MRLH?wlXo{L%*Yo03Z9DwcJd z4U2?xScbS%$&8>P4yIlc%``Zb2)oo})!nHN_JvFU3+>d=vP7N@EPWcXS|J2$ZOA%# zU_=fdq1_2%?g=%p3xBgMh~6d!^rnKZsO|?oeU!O|YaYr>KS?TtGTdst{rTn(!5MbI zNjmiZNMLrD=I8nGYy-QvEIR7+%<;G+dURRI)FjxNO%J5o+gDJ@w7*B7mvAPWzL*>O zL}Pp{vu`<-$=~{R)%IUClD&_7A2Pt$nMm{;L%oudrDhn6K%B7i*n25P@=#(eIK6nm z?kG&yMkz|xx?5Sqk1~>Po=>D4`93*Af4Aj{{pqUmNj8`;-$w%Oh~3~LmEHR!bS;p6 zuIrctUEMKv{YGo(dpLH?RP?w&dUq<2Am@;Ce&XjF$|SxtXFQ;)zk0JiUu*j%xcX^w z_C>DyaP)l|(Fit0IsEpQ_w|sa|9L^BkLKCUU{=~5jgb0ZWy{8^@0LM3&w}2Y6Tk45 z!&tCRdB^d)_R=;O(`Lh8wLZZGcN&}f42cQJovA|!(jYm8(CzaC!6AXTl4o+ zi50x`FbcapL+?jPxw=R>b5$P>8c%tO2$RTB0ZZI;>PixYf%MQSJD!H*VMPJW*L~A# z&ZMD^M3ct8pa}cDH;Gh+@5E5c}T#U3uVJVZen2t4@=JTHrLJQKo&2UD*Ob& zI0P80^;%-rC5$Tu=~5>NqZDF+;#^GJTG{0|aGli3MJ>V@YajYd59YhiK7A~Az@eFE zk+-ODsO-p;;uV7#tIyWXiqP`?B_)<2x} z8;L3y-dN_{Z|S z>qokyEe!1U?^zlhlt+9eTm>=?UqwW9gMO<~?lGyga^)!98jkqT+jg})6KBT>#Yu{xNuVu66--V)}+lhnVr%4um0dimf zMm%N0TQvl5^Z6z}Z~c5d&UmwvD8;U}8agQSxE*Q=)3G%B<-%pSnx(lzNRWq9bMfi} zv{>Ii=u08@9^dDS)b{Cft}sss=OtWH`UfmgFt7mE{`*KZHLiQ_ArgbK7w@;Zp)^ZH zK84y_tvHWTrGy8UJI|s3 z@zW}U0UdUwV$M%RJj+UU`y*uOP`x#h$8Tk974i-MC3ZCFEd^1@Zxbx|z?ZO3rEjFRr26SRI(AWfIYzJ6~OxT*Wg|f|rq_z_7v?sFW{Qkg@o! zgt~=1E?t7o%cbR8RI0}v-AJM_Hp@Q?A1E1aa0hVioKX_wQ9B8J@v2n`w-Qkq)_5TC zk>QlBSpRy`+~ra^*hp7UF^J&n92fefRq2mR>X3ih&L|J05!%{)*Y>)!+e_05KTsKP zfh_U#;IoufsrA8+nhE0mJe%RVILjz@XvRCsv#XL}Vb#x@)jHjchz0Ok$((;e@`wV^ zZhPHAJvm?)#xNs-Kh_lF$-p>F_8SniKBt3c%0gxC&ocX7MaubjM#?Nc42e*aS*+C-vz zkE9xCkRM>xv5&1tXeTN13p;ieD-0n0AC3iWo-y3t4Sv11wp~)=5X+D?0w$~L=|wUP zZ|a`6E>L45PY*a;wZhmxRlYnfj_e#+$r>EVk`k_MzWXU8a}~pIdurKyF@WR3SjWD= z7hfY?gTj5vcZeByZUl)3FDb6faWStEhOX1*ST}lMet76%yRmO)KC|jmNX{`xUQ&ZJ zP@@k=#Cc~#7B3MvMkIF%e(1_0Cfv0DNj2=Nqq_;kGha%vnquV)`f?w%K6d)$= zDTHe$^SQmyFYH!31uMQ51Z&Pgx%sgcrKRT_8~MzHT>x*JdylBXJRr3vUGdXI;vC`m z2?n{)3yK4?d^lB5?d1F%U|3Wav`xN&YXrX(pa0fZR==Q`8mdNeLd~p&zAHd_0L)i` zDD6EJdFTJ?T-*J3o}m?s$KL?TEZ=4(MG^{s8e{VZ^T2j-1;G}>u&aS9gVAonS{Nv< z0>q6HoI&FaZoGNx>ibcFyA7sjVJb0Dt4|}&YiuYCdDlLjOEuA)!vtKdHDe=V(Trip z9KzAXJ~S~LWEf96Q%FjqlqaDV&do+S2U|FIkIsQl^$cbklII+tAdwE~65kIj*4TV4 z6253!#C(HJ?_D_jV=bKkORmqd8`M9(^`w@QRlx`{5wEpl;%zun6D)a-7Rihq+aqex zpC(jJS4VV+YTWn9BI36gU*0h1h^8l#28N=2lkt?B{9>E+)0)Nd647iF-Shu65c^W~ zS+!GqJ%}Guktm_=E-n%=%9!-%13g`dYnWoNu8*HrCyb8;4Y+QMelphXn;!cvcrqEX ztwB2(fRU{x<;P9A2!+kn(54z+U#WW|Hp#5e9C*Q4`~B!MKGzrIo3vCp zz?-w&BT~!EcE%#*3YmjDFN?o^?cj0TvHg0Zv?_5MR8y759Z2zuKH-6`MN=ef#jwW3 zj!=Nwot73uu3;}FzMV!RyQnLxjlImfk&ISWZ)G1^ESHOL?0tqr!(78Bj&CEsx_sSo zZb|yaF(t{WQK_@1k-E1pGyH95`32l;{niK^t34M{&{+mgkk+!?I41#Hcs*I&EDlGF zpo{Ye_gGVM{2ld6!ICVYMFpBd6HY8MrBvgVo3hbg_!WA)6kd@A4uhcnUD47LUhG16 z&X_x;uB-#4JYWo-&H7;CqqQ4bVVwG1JI2KeZ!LzAvXf%M8j#&$@eMByeQo~IR#8@9 zSX*?k7~GU7_3a>UF_`CF)qVBB{DGE~vHx>_Kg2t-kR89&v{!6ls+WimbKt}cF&D1f zzB;>_skc0LYxuj}WUV~gwxHH&gNlQ3fcuZ_OiGSL7Gl!UZ^z|42qPUcDp zztT<?a*_gB+E7qI{Od1^432ysd$3nA~L=# zW1hiY|2`U~8qU`E&}QrWK-xyrdgHdHhYavEqyfwung)l)3SPRyX@i_<6N22_N0(dt6&er&fol*^fYO_6apIjgjyD9GkW}Xz(hzKNQEra-u3bRi{&Q4ma*E`BXXD=`NHSlT4iU?Kyn5%t!`qaBIgo; zWKnD|`RLi(X$JOUK~&?&2VOY=V&FL^Osr>vL38S;_`zcaR~0V*dTkjpJXkOAjg1kKt*ktcYhsZuS@VYJ`}sn<2?tCFbKq!>^g* z{<9cYOKn*Uj@G=%1l*B^9@4dA}ghDDH`b71Tr3>79AEKYRcFhfSch zaljf8wom0VZ@T*VOd3=8Q-x{_FqIVk)Fm+@q9vQ0k6kgz-YgN4Yj5QOJb z;mEC32G;$LAG|a0$Q=lh7+J5n?DYPp9KqupC%fTF5kzi?% z>Lks#@PAwYL&MbbPf4p5k9rRNx+-zP&4mhEt8|OED08>&QBCSOLI40$7l(i+xW#?B zF?)7jq0+S4{7m^>+UKe1{^Cr1Raq+Ezad0k7dVSO?=a8!a%2}&wN0N{U z@)on%(BNx%v)5(g=!sWD^Wt%10H@D0!g!qfv26jnN!{{pO(q?3{TzSphapcNV#; z;UW$F(&`oh;kHx@i$yO2f|>0yLxz(7KG9`+5U>n3c&Bw!!4Y(1RaLBK>4ULD7n*da za89s|_Mm=mdFF|M$i+`T4lYPn3JYVm^8G3L=7d|FLHln6%86_K+|r1q|F-F82?M8# zTrF2lu^oWfL9#{(Sn)BFq(jNf(mxc|46OH(Vh`%6Rr-dhp_Ku5OmL<+7Q+W77!i0x z^4zw=_n|0gJF)0-)63FiSMjsh>T0!AK2}I!H`*e69`t=z#N`n~?Nd-@+EKYqeLXtZvtA<{%W1 zU2XKo>R^K*w`)?`eEWmL&&&m;kq zcRQii-VFmP-_!}cHtI@l@l$2$Q`=a?b}-#=l{|I4lai8t`v3?0=+%y{){Mk2If4@# ziN()kjj{KTc#mPF0rkci8s0AEL2=J$up>KMO*VGa^LWH;U^T(Mbl&CCo=@eZ)CA2A z4KB3nvpyQG!yyRpxBxa=&b`c(2UhI+n*n5~P}5mX zclgta-RY9G>V=DBFszmDe6QHT{B_&YoecC-l@^b)&m<2_#ww7EJ<1B5+nA3+FI7IB z26Jofy*4za5=1CkaMICi@S;jDKjrU5h>#ZLb?w$;NQ5ktj>=s$8p06n^R zmT;GMG85|PH&jt3-&nTfWpeUKkug7qNP>cbab~Njw z+hjZJe#wU>C8-9IRp#_1O_ve9MGXqwAc>0)ZH@ZHzbiX%IptvJW0$+zL zdWmugiPVe9@jo?RR?}OE%i^L^hqD)RMhL*ZmaSpQV!NJ#D7R3rLg?rTH03F-_e8#n zI{nVJzzuB^%~rH0chUm@1>ny24CLyNJ5(qyfTyVc2^9F%JeBh_#0(Ic9Q zli@|Rd(RPD;F{Qf;f!H92HNR)?Z^F&7ynW!+&}6>Za_Ci-RVh?l5Q^i5}#peD1hBI zZCWDFOl&MprJ5OWAdE3)ExqVV**4;ypO!9)hYweFc<^kWV1-hG6T{dYc+VyOSVK?j zJPDF`xUDM)>n;URoFcN$C-=q_g5(@U&TRzctwEN4ZG4&cQhRU7K*;1dNX@U+K6?vd zF@k>yku2@QfZvpW^Q8VCDILd1R`#GLQn3w{4|Y-JKxQ%|c|}Lf$J7x+7)?Y`5+#x8 z>~T30%9Zy9LqDiZ?`KP8hjAm-Il6e73@-P{nh>H8r$5$W+|XE^;l^hzh|OWoQj)8~ z_bp|~RZ>8*r=1y#7(nCaCB^uGJ`*cUEt;G{^aePYXdj$*f-`%@B;}oNG8}vkW{lh* zrZ%hQwOtjF_CG^H0*EN7PFMsexdmdU%?VYpldUjxBT>02$X&G(z9<-HK*M`aDK@ay zBTV0li=f3c(Q*^g^lR>^7K{xsQ8sBO8v2Oj)gi^?J=&_evna(?(!xVE+i$Pk?a%#QLX>`cseFfgRB6=#VXEAZ^9dUa zhKIpq4kbnE0`7k#YcMU{G00S(RM)@c`2|GUO zeIi1zk0rl5ZrSUgi@MZZEa4%!|Azw4Rc%P#_!NTYLfx*;{Kn&`P(cg*o5$0o0Lv+<(z4EPbaLmi$(DAIOh8^pr~ScM-)P0 zJUP$ww%*dL^F(L><_a;wa>osf{0O7iSn+jJ2bIg?4XA_eHU%jR3x~lMJ4EK_O_K{c zyY8~G;$I@9KS*q>g5Mu98_lzMK~)SS>=g5$z3iD#58>aE zb&{auK&TFeOoWF!j#E9%0VC?+?9ZDO9|s3R5I6KK2?2@6cM{k5d3KA(v{cEA&=tfI zMBj}4Y5(QR?X;;JsWsCU^=F*iLfC5?AiQ-VR%DC3_z`og&GA&fv}D@J4X|oGiCt5L zbA-9qP6hqtcLwZ%79X!hjk^U0_3nBtThM7YZulwT03UB{Gxonmg&v*gV(c7K zzge{@o6uuW-gpROB8+jdO;bWF@BIGo82^VVhNs=4%E0}!%BSCzq^_0S79Zns!S$aq zGq1wFn~8bUryi2);`NaESpjFKPQ+S|_jEQ3MPCkNZ!~B=;sa!??7dW-E!6<=oa+l7 zX0~F*5FJ=Js{qb<3Oynt1J{u)T^?^`R2G6F!0b0$<#lX3nD3TvL3i;OdCEtQjYw^c zLGZVI`>hWDDF-=Ldo(<6J1%j?owgJ6`;ME4CH){m+ez9ebYep|fQDIidIvqjC07v9 zrN6rRwh7g;tQc}B^#N|S<`EOJ89G6qzABZUmq-OoM^CJ)W&hPs>x00EssL&BbxKyf zT5U~hbC7>u01Hb>{Av@l?%V>3q5-k4M)fwhpmT}99V)pVoRpOGrso-+7j8(-xrB2Lv%IAsghIP9c6rUmwj74LC%Sxhc0)k zSaJ+FL0y?(8i^oHw(4;sfRTEXb=ZIl!w%neUHH(@Adl#)DK2ib+ix2g63Q4mN>sXi zIw7rJ4iulTTtUk!fdienY!k4)PmFbux_diRA=dn|d^0ZIgdh|u8FEV+x+ zFD|IGjv77j9e|+gQuqH6AswVUI3X+`sy#S*Ke#?-%7H`T(-qmtdNctcZY(9Ld#$`- zjsV}911V|YcscU^aOgP8gKe$#NB2I-tn}rO%%kX&Dc$5xaspQ50}Jw)dmbxwq!i9@ zpB862BeknUm!MVu;{+@J^k&FqQeY0}AN+KfM_$=gA*;x1=nM5zr!dkAOx1`BVyFyH)(^uZ7SuC^V?A|K_!Sk8?*wBb!TyYZ_okzVlNMrnQGuq*~u0Hs|!NF0Vh!O zmYaF_O*qSx>&n1WnTQ*}?XRd`XnwSM#_BknJHLet$=rki$y!R zDb+#2i8-a;y3wk?i;XT-v21)i&{Dl(CUSBb)1|&x`Wx1PNyuSl{+X9@qF1Xu5C<#D3uyMGtG1Z<@ zYSSBs3|F$j>lzMMGXt{<*8MN20f$Ra#|N{0&xoo!n&9@A_o@t*^=>@R!-?P@~$**N9arqt-e zha;0;{zd$^{v;Oo7Sv!1bmKEWRfc9;60qy(4nG68KD#5T+2vTML3j-`_mf#l3J7V0$0wFE{pB9*f0MEZWakI0Sz>~p+cb`iP77dJj zqXnoVlyxlV5az3o>SRbF8)E23YzNluzw2Za;Qq2{AGTd=c4m&Pv&pWz^$fMP44fPh z%`6Y9t=<%REq9AoBeN#wJx6pGJ+46_^~qL(b5=XjAFG&pfV`&g3%1K|jj=C76*J~n z7Xg|Z5H_R?&dC?RMiD!ES(x8KqmFNwD?|@F`EJ^~bnN33iI?4;pP5GaHT1-K(fdnR zl61a;q!>J7D#VtZWguV<`VV_(P%PG8?YN#2S#rtkf{q;aEX60(H3Av6Df)+Mpdljj zD#i6)JmHU*gmwGg5&zOA_A+;!DH$4+O`WgK04?nv@nTp4I0r#%ZXO#G34<} zaV1URXWipUxMUYg&T(V+IsesvVv@kyS8hQy*@ncVj7XA%_?&)O#dMu?Xjh*Tl+ey> zd^`xDy++f0J}`8`(rgIPyw~Y8n@&c|&ofMtqS}iV#nG4V%IOQp=DfG4NW@%qsfkeJ zq;Zb}C9l=Pk4?>Eb(y>jE4yFq#stS^$UA<^BY!p=jX2du1n#~dLy?X-XZnGH={U}t z$|({W2-#y5!x4)Pkoc11EKot7o~V`EjANv@yHQbcN~iSsYx~wmp|;DSidp8?qeuK- z={~4#70T}!BG>A02+9sq9Xe`ixR_)22X3g~`TPa&jQOU?OenQZaz@QW!F4j*7>3Wg z7SViQVJ6Bo`d_``J;wcK>gXH?BadxC1L!2FIGN* z^C!#6$vV*_ZlO?mOQ++6DY%~$Rgi;C+a@wBBg-{!n7!iL@K$irk-f^hJ7Vak%gt)> zkYDFHxl8ijGTP4Bmz7ENs`dLAsiy-&0Zo)+14A=thO{1IQ^%G2hE4#nGzRDdWZgWn zdJ(uFOVoIhSis$~O>&J0aSUPBg~Wu!>vNB zo5PCw$nvjyUmln=uxngI|M;!?Bh`vuw5ZImI(EAzo3l3J(#?B*^WXrp(G8hw_gAi@ zY4Bm>K5s)XHs^GG#&O9A%dsd6sf0`H8d2BJ$&>#U%^~P!6aY23-zx>7vaVy$lNDnF z=1+Jcc?$Fqg0zcm!;FmlnK(neuQNJ5nTn4m_S6GZd?)w(J9V|t+q72D<7hC^I;IiW>c~=y8Ggjg3x+t3g#FEkKxXQ zE5Dl1p_?j3^nd27P=2=B)VA6s3v%I2ecLmi?FVI+2-8S%!rG409ROd`vjqzyi#^;8 zQHHGfyKw18M^yu$6JyjKr0x%!D2+jinD(-0kq2Gs2ho zTAl*+Z|u0d7rKo@?6KF02}8SQPRf*9dBf=kM?o*|H=%M82U0gYA4;g-pk#VLU^PDB zbemWBm9dSeXR(5e|8c=7rifIQER5%y9|ugI)+T!Sc`UNA1?vx+?2Nrj;8fG64=KT3 zfRjnQM*=fzYaZ$js27qRkte{Z3>!n`iCp&uDEQssR-HCn-91`dkk_FQh0Z-i?0+SB zIT;6)xP1=;`O?a>;dt2+cPoS%gfLpjRnTB?}b zdzgHQLwx&A#NgWg+#+;|HHSc!fb(Y#JMJKm^BoTSG+>ky)aat|kQoweSv&|zxXmCj zgnzg0ccwJ`OTf44ym*|SlIgf%<!&*(X}hSTNnufe&lUn$ z<_`|;0}BMsu2dGI&9JM}u>gfii@_@5?gP`)_C6sK@t{H}PI7&s=eUf76%CDtUHB`N@2DuU zOb{!MHFmL6c0;vDI+9`9qg>SgS=@zd+hfrw`iZ)WdqhTin?c$r*!wK~`By z%7w$6U4nnW8CVvY%HMxy2Me;Fh!{}B*RW5kL<#PFbScRP4}1HB6x4hb>s4(Far+rP zVd?(Mvm%TA8yPK&ta6_A0|gD%9a+@UpARw)xp}U=K34vgzUeyF$~hVGe7JsTr4;k9L^4Qrvie{!p$I$Ir_*<;cu3LwvN_( z5!Kd`-#~wR-%D~#y>B!XeFIjutN0j^U}|#9GufINtK@0yAdnseQ#}3PXRy?OruN5bRgUItPj{g{aED) zKfiUb`U)i&m6tR<$tq3LL3i3tB3onnu6)cq2~QQ?rDa`iIh{-u!TxCz5~ci1W!#Vh zU-tyHlUj6})nBqx@Sd;8;J-{<#Z;8|#5K(`hmKY*Gnk({c9$Ruj}H&~>a^Pyty7}o zfGz5GBEFutq#$`uD`5Z~5*k~qkW+kFYMYK~$)5ag zJIe`Ej#BW%EZ-;K=P8AbNu%EiXvC>;LY{r^D}+bzuJFbCK@&GAWuV7bN=b9Xx?Cx+9mrHpea!nUZLK?mg2 z`0wB)?7&DX0Rf@pflIBqn4+@pGr+U{xbUB8sPj^WL)K!Vd@gGJ8lua&wwJu1@Zld# z7_RP}sBE9T+}_5rJWoJ4f7%ZuH3^jrP)vrnTC%qQ9n5_d1X9MNixc>q);^Yb1n{15 zD+jyYcAngxrm1RWKa11OCE(|Nq?$$l*rGji@e`R?Rs)src+WSQBloV6dvs{9F>*7N zg9FfeQysniEd>DtEaOy|HhPYQvCy7t$%n^2Hy@-e#Ivc52Z?K#c~;~fJy2Xx{^9s# zURp4+4H;`Ec~cI`yx%rG#!3TJhz5M31;=IAt^}2U#Rm3c&IPU`1e~hJ!j2P0jvbf5 zh8dWE&MQute}wyIG(|JzjzS~Sq~l$rNq6!@uF^vb0>L;cn-EH|iR|P0>6o>Z)Xj%K z5;E&c!MO+F+dQ=j{>Z3%z>RglO0~0xYVhi4R*-vIC%a*#pG?fQa9F*3eoDolgl|`! zu0VcwU7GI^?YY;7In$r3n#RepNJ%&=O@`BN`*tLBNr{Dn4@D zD|}YlpszO7j0DQr^gzeo`0|#a6P;$bAY<#`!HrAluF{Qq9bDLTkwcbVamO=rq z4Bvl3w`p?FJCejIU__U``#G(W*QnY#mES(T{m5zwn z0p{zg{-~xoVA0&~+PYH0fnlbu<|hyw#Hu!CMktKnrMdjQbcI=5-B6$DhZn`1IRp#u z)v-Y94FeD>S}Q?ebh(B(ij_hXLJXvYfhCpFR6f7_IHqsJTO3ruJRbmVu`3u-lEFe3 zez#Fkm~e{l6TWX+=sv{;9Z(LrBIHc(GZrxzNF(qlspJXZ9eGz>S0n?T`_{%87Z(M3 zBpV*>KqBb7x1DYAL3@)86$?w)SQ>X4xcg8tFee{`j|5|IUet6Ea0u|Q%i=^M1SVT0 zhq*)QnDOa{Zmpb(XfWI=b%_t!lzVb-0N|xe{qSu19$x6<*6y=6*vm82sfOye@kP!d z`FcxZ{B@_z9cF_YL1lu{ap1HEQ2JyVhq>Zi#~(u&#~;wgt3j3h0Wf?y!}KWgksZf?XJFrj z6$^f$+l1m~l1fo=f5F}aNNYT=FU`IH&e^4#S}l3GWwFBD#k}&0G%fVdHnZi-GS&T%8LFPJun=sotMCq zmy2K^WJsXs?R>5D1EImlDJ$Q}L2t+PBA_Q9_>K(j*;;mbdVhB_rwcE~Z=NVZ7?T`4{_B&~ zAxF+O^FG@H?bbe2Yb+c+yg?voyEVhiB_k+x_=H0dQ}h(NxW`vMAu#>83diqN+rblz z-Q0cN|Hso=Mn&C4Yn&Lmn*k&QX&D&0VUTVHknW+C6iMlj?vj)S5d=XxrMtnPQ@WeE z|M#wS?-yoZExw&~&fd>{_U}2(z?7VrSfQ7~yy5VhsQp>^aFaIGOZT9ka;>=TpVhtG zs$%sE@FZRS2O2H*&x%IROzmJ1DUIa@Cgk?e77ARTviP&F1pj25gxW6A-ZpRF`yWp` zyMq|KGZJ+=CDDYzL#9QfZRD9o#x`Kq3H;9ZXx?Pyc>8#wpS^XX1#%g&HKPDWy=4xB!`db1xb^G!{lx0-i-?iB zgIHlxsf*?Z#xGr(PqRRvYMIm(QOAw>zd+=M^nLz^^T0>D&O0abIi%G6`wv&QJEi{g zGeDBS90=enfCh5NY*_tHQ9Ri8rF+U69TmcvWDlj+uO{S;(tv2?il@B^bc`kSPr|xLZKda6RJ}XXA znz#{)Doqt9)p93hMQZbRo%knyp70e9SJQ5N`b{vO@aqIOo}h zdxvWCpNk{wAt0YdqbK!LtfMHBg*c2W3P`Ut(23Mw0>Tyg3ki%~tb)5QyPNLjtr_Qb z6@El4Taue}C%JKBVn=kuH#ae;t1p`*1mZZwv@#%v@5s4O@84=b?`2)AiXzpqzZ?iT z!%lmTrWM_CdU|CNRzC;`w9Z0N+Z8q`iNg{@BCxY!21?B;G#9)F>cV?8yX-SLEOou9 zzYQ@(=z4vB{1bhYh`uf7cE>Rry%|6y2 zEZ=OjACE)6G*5&+=DB8N8I4@t_vQf(>;Zh=+$G=cmB!FVi5f-Z+_pa9mEVVw2B9C* zhwsDt0MY#Khu16L9X+`Gum~RCMocmQJ4XU{p^vr!UciD=K%j+T`lX*w-pP2uyE1A1 zl|f*r3HaTXN5g&RpN)^2n~5zRPH+p=iQjvi*ZcK`;>9iHK6S5~93MV)TX}rz0Gi&> zhbiH<)^7=q$g#eMTnC?JS88tcDC4USW4NWG zH%Xk}9`WEoEGFywX0_X}s|7Z?`Pqnn$z( zi&^cVMJ@078~md}AAtqaKiyCC!YB_5D22m6m z`Epq*rvUjU^T)sW9Zik@V))-gm#)@;bcS-pnD{wt#O}9@3A~fls%c=Vy?B+a5BiZ7O|RcIOkX_tAsAFZMK9uXg-0$5b#l3=iRWswplSOAo=U+#jgM+#K``-XlqoeaBH>S`3u5IxN*9!}$AlDZE znww;gAgM1SvBvJ4=^b6lk8woTXTAWx8>Wv<9Q{a7nATG;Dc_-K{hjgYZ+pZ6g!_+z zhUA}v?^K^|f6(B>jF}l?!hgLt%BHO$qSW8n-Z={-e)z{2ZmS*m)^HkR$rgXTYA2jmvB^DeiZCe+89Z z!1~Zq>w51Im*D^9+rzAyhT2!)%D8fo?g$jGAuHnw5k?pSyIiN^#sjGbFJn1@fv4U6 zL>lGMZIxyF<^0t9JSb7c69D^Sc&vH<;mA%1$SX?FSBeX@{nn9>l<>O#*DSAP1f%-P zvv58!?*51pi;g*bW#Q$Qh!g?bA#+g>gyO8?QC_sb`KQa`CF36$blOm}R z(HrbkJKLXr1d|j{SxXb?w(40gUMrEaCS#TV9<4$I`)j&EG`K}VC7t<=VB*I~yI=m> z42&qHjRhdtq_b}{ExES<@q@Z7kE^GM3YLYOnW5rE(7|R@4_0$}x!Q;aXi$DO5u5Pw z^svh?2Bm{2F7%phqepV+;g}t6Pi|t|JiU4>G^VB%M*Md^>e6F-d%l&;Ix~`G%0epT zz+S=eoc??|;e7g8r$D9tz5p2UA76NYW$deD;fh+D8nZ*%(gV_0B;|p4f*GS~pDTNyot~+&sB?(hn>*SddAZI_@GM9OOT^ z12@Gg5uKP}e-?MRKNuXe?QK5f9+OpX!8jE(LL7U~RGVvAG&P7iz%NepX_y9(XZ&kl z%fx1yBj*Bd06_Asn|VFt@n8aZSM$`1Jbw=`-vSS-$XxAs5WW9xPQHd9_bc+>RV(Vd zt-o6h3I9!WMJBy=02`}#ZytF5-RY6jA`{A#fYXTg!q#LX@XL#;br-{GaP(kP0Sc_o z{46tUVG!`W#2jRQ92pM7XU)Nq6#%0GExE1~tBG9A-f|;@@!17C+X!}sX!-%1Bw^t$ z4ZMrfo+BPg%I`w(ohBAu*h3n*JhGMvNM`RG)y&W)a0j|FNDRobH6U+%(10$-{Mdi{ z{8PU3%J16SRK+A9&XzAq4Qz<1@R46}^%JP1UPB-!K`?sMl@SuV6{K3ob;rp`48}QP z8>AQN50}&BTA+MyEIku&aeSB)X1yh@c=hq%08Kp9{D`EI`C@)`ctAdV)lc&hm*(Ij z9CO-fQa7~9Q+lMy5%;x%?6C)`UZEg}(V8Qa@5d`z0d7X$kkdU2A=AP{`eaUcTo1PK zQ-PY?%kvZ?DaLF72;UaJCV0jcHu`(@_&Yu42LVa^ivypNuRFPTa@Hn|I=(_*M0RZ5 zP{>f!^G42>-#54P_GCkESK7?jfW)wj5i}D(tcY=A?Egl4`65l3O(3{)*9m<4Z=_nR zL=8l?S>Ke4^!n!JS2~lw6R2X6?4hTt?Uf)%wBQO~FBs_r+`fQnBf5gD>5AO`fZBnHdp3^GsS$sCA7cvX)~){Ihxe9yo}$3c zpmz27Uu1s!^=;Dr@R0<=xt%U6bEp~zB8%oDLhoC7lGkpWz7j-_u+^2+`w(XWB)b=TIXhH9WTqk_RO=Cl;{Fv z&UAb@dSsNp^QC)w1D{S}?QwEmQM~utF;|K6mS8JRbITv3xWPjiUKF|r3E~pK=k4M{ zb=Bqza4%5SJMv;_zS~$Y7e##6+32PVGtJau{i7Pk7lJ})5%21XgUu{&ccP`3$k5Fr z!*U@wD`(H{@-tSBDnt{L^rDFJ5~krU2x^r-JnqSxy7qNOF)e4PZ9Owvl#Y<(pw)|= zV!ZK6+YX1}I+FLxnFFv^>^aFB4N*`5M>4AV$;5YSnR3s6LTXa&1r?o?bLl}GbGC9$ z0V4@~Dguxi*Z$NgqdVFzynkqzmRqp%lW5S!YND`?#)F|`wGn2u01Cl-YnRTeH>8j5 z3|`sr($9DRRqQ_UvOcG#o1Pof9+MlBQQ<~)32yr#JGU+9&ZMc?pIc0G_tThjI@xuL+37XT*y7VMVTDdebDo?K*Kb0FudBQ-$|Ie28Ql!d%1*HxT_ zFV8A21mgF)>a?Y3VyDV(5!evqyP5qfU(?P2Wi2Y9VOEcagMTmfgfkLkb&8ew$oIl4 zLDs}6J^F;#gN&Kl_$UNXv2vm&tJU65tqZt>D;19aCKgr#{JyE@-hJt?CoIDrxS8xY zuXcHgltv2AeaSNH<%_|Gc08|7dDen4ooo8u&Tx^23pE@^Del}{#%z!gUS61PPWHe6popwjh0Quu;~bh5e>@4Aq2l5b99n;9%rpI$EbTskUDo zQ!6i%DzS0AnEUq6sAe}xxLSPu>~&)Q7vAFQ94PXk=Y7sIkGqv8j#waPRA7DZ#B+ns zm5ZqEdG#o@8aPS(!~9zSZZ(NZ9`VpoNi&>!T8Nqv)F(o?o=yQ3iIU^gNrsfxHp6Xq zGa{H+d`>!wyT8=NB&DkOR1+V_*LAa^X`x*Kmf0YeM=-k{)Icpe+(Uf*WN_GRs+vFaBiqg{a z*F)S;gg|56b&x#lMDG_O$zdZP6?U`tz4n}QnA;-*&N7tIGDB!Bv?ha34<%y zqnK|Je1Cz>2$>FTu08r%mac!|DKhY?v(A#+Fx}KIa9a&r_wLSY#M)r6W)%MqK%#_O z4y39_8So=#kPpAREeKslwL)Tf727xQPWZUB9@ldUe;@nre=;63zkOET*}MjFEBN9l zLTo^t>*S8VwWO|A>%1v}6lEJGyG1|2Umhk^@hfEpyn>u9C_h-iQhqgGCgAMwYK4 zLoA5tTv2nCoe->{*$g|lSZ2X(vBRlu$m`Y-YZ?9?6B!$pu3S_g0)+*yO(~^OiHJ2> z=*#3JCw9S0L=?^m0gMLo22X=nf@Rdi&|G6hZejKsZl85@Z_@iTejW5ngVMK3zpltL z5zXbmuGdS?SH6$Gfyuc~#$2F`88f`gjGA_#n7)|9IZuBohckrDw!fsdH^uN$_BOhJ zjU`)+rSNQlr4#EhX`vF1izOmzA8xfIZ^+Z)m`S<7~5dYsO{y}8=R2b&* z6-=sI7*pjmZF5r_LYzZIDN6gIapZJH(P|hQ9q1H;i^-RZ0Ao95V@y1>0-m)+m5V?)yA!HN7j}kW2IFO=c z4s(&=+z*jEY}DsPG2g`7AFv9WJN`(&yRRXNKNj;&7}e@B4KIQ zqIp}Gi6&!(gYnQ8;HwuEeZjYj7ip-tSF1W4kbh$;dPx=9KY?T%xw&Pa%^W|Fn$9Y53K@IE> z>r{OOI`H4P_PRS?uwf~0b!;tlu7yr?mH<8SA$55A=5PVX))cDPd8l6qLR613Mm`E6 zvbMPD+7+qv=f`zE-z>d&{~~c+8%fYbQlq{V8hG^(^U5Y{){I7U<(J_?-{LUDi}F&!IyweS zbFq89-&7YaVa87xaaX_XQX}z1Gl3a9Ft!zB6zIpVf`|&65B6fV&w{>*zo*@^%Q%F@ zzSZ_`uv^tcZYC(GZ;20uJ#@Pu$2;$@k@srwTh6vZ5O}MU0PM&H{2WEZut$agR>H603K4rIyPx3N* zMkt-+JL;w(mafhB{gJy^z#)@;nnK(I076-!GUQ=CuCcb8-*Lczm5e12TMk()XP*G^ zR(5@CoOC5EjTJ(|DilI&MM_!7F}Wj5I+>Ix!rz~ObZ|tJER9h}vO{A**rlIE-#oiZ zI#~XL-td(rvw)jR48%+uX=#w@=+>pR-b$A&#y>GSH#CA_Hz&jWG$?Ct2d2?LOPSb zz*QN!nLfszkS95T{;(GUSq$Lg+_$bQDq1noyCu3TXoVLJ4J!e$GMie~#HqWl>A>#8 z*fEBO4EBu}k$W7N@WC}S6Es|O)^)vETm@7$92Tms?1BtQwqj!HTs)EYTWSa%P0I|y znIp>a9cgso4>!yCPeTl2oh$#naLC`tTjc2Xm4966pr5;aW^Kzerct*k2vAehLyrNd z6s1FHl^t&X+!`3x(`<0q>eS)qiZM_Qg(+Y?eehA=`9{jR0G(DiKj`Bm9-30LR;aGDZb~3j^v@(_lhMu76j7JfPoLn& zLNn0JNwL#_{Yin*t($+@`UV5xNLU?Fa0)-d-_{Yv{~-j&Bm!KO0%w)i3Cl!@NAZ`j zb~}hr-0)r^3@@b&w5nT_wY6}+IXz4oBH8eWLU8$!S1zDloI_ptXJ%Wp? zW1)De`|Xp&!3JC)K17#2ij_O*&mnX{x{n;pUigujoGsfRGA%qbyA0y;Si+Th$J7n9`>NPXmrOggm`z%3>XxY{~KYQlGKun4J-a zJ@PV?li*YH!6&?D{eC-b$zkm?1kgeD-+cWrOJ6FUYu~?@ml5u#yC<)QlSn8%7R^0M zV<~$?p{N2RPiS;<3qjo21|ju>nT_GTTA7UHyP9HW)SkCdPNh8cov=(_D!j-Y5%hD> zI$fcziNJk*!#S3_J5bic>SnHA%0+`ct!>xL@aUVjs3zoU1*2U)r=QBg8^a>Lrna@E z+m)j0C2>b?=DMZFO+@fmOo#u;H4C)f(^|z7`V(C(r}np3veFUvZ>K+}YHjRyrpPqn z)T4!bhpKOa#5Ot4W`Mit{#^0tViPLXM4ky<==j8NK(m)Gb$)Y2!3cQy-=4F-{9MC) z!$alrYS$pa9#TmXFVBiYCqRVcVD6z2ALA0@q~gGql-lUiQQayv-t5kym=Pa={I-v^z_;|{`J1N zxR1sDzz1SbSoL~&z*LNj{NIN!nmW#py5JfG}UYmE-*v6~PT| zFNUGQ`&V>{{;p8GJCGd_qyfRMS2M*QCOKr8i)CB;*QkeDJe7rt)4;x{a3**^#9}&_ z^_WH}oCP|a`13U}zHQ;lY7@xq(2#chH?)~ubfAbV^Gy-oIhj1{{x>*7oo#*^7v(*F@`$@n-v@bGFSGgu% zU>dXT7R5BytfI*lu(PdV-*C@ZFcNiK$`^eF!vxQuK8Gwj86zDNpAtEG4;(%OkzNrB zKg~QI<~K|nSz16}bfuDrW194LXHT-6=$D6gt;>AuW$#hcNd<9ZzFrkCtRY`l4yaT# z8G~Dl-R__3|KPDZj3j)d+M|9G<5a6Ng8y$$3AX zy|}A;btG}|m6H`t{~h(3^X>)jis!xaY(~J>#j_a>x$ox|vlCnoHm9-+0{68S8kY6ajDXm)jTjeEgsgYIN zTvX#}tweDW=A@APS9H0!c<>6Ix5Q#Cv-#DMi>6KcLY=FhXZ0lo%-H`qIZb)`+F+@x z*5b`1xp9`lT@M>qi1E8Pu8UWL5;rpcM!X5po?dv9>f+(e6@OLv#y&a#kHNp-FYkYRF!bPavAEE(b&k-ohmBnqm}+&CkHQ$ zz0RDr(Zv(&uhBW{RXKVEm7w9xwdid$r*$W>L4)_#xQ>%OO11u7GL0Kf#aUHdlC?U9 zi8|#S{GGw-VDr09RaA&fqrY4^fhz@ZV0ZCUpb*QYon-ju{v%}o9e)hcAw zCFZpcH848j7j@e8)%LHjTO|raUYq4)*qtf;%YW@2KdRau0&za+L2Ogz#k-0Pe*S8T zPKhqIfmRr;i2jtkvvQb++jPqLx4XFV$<27@lQ(XRHlaoH`bRQFo1aN*K5M6j5q_U( zILY5u%W*aFJ|7Hw)!FSmYb7WfVbnaw#A@spip@R6{de- zM;C^UUnH%Ej7{V9G6VV#t8qMKzHpUnUA(Op?JIUrfy>D?8qxFg(uDT2ZcYruu zC3O^$Xd2j*v&pTTU|ep29D&IgQh;M)kFZ^AMHJHMgJ`!SIS{OFge*+fE;{9f5dTs% zbem;+!OAX!sCrnahqFo1JHRS~Dy-k7J0t={_>%^Fa~NfL?p?z!Clf6wV&@*Ze4jk3 zg@;l15Y3o^diLW$e{(4gXfogg zihj7m{sUq{-qg7lAL#^>Dfd|2{T-Md)Pa7q)&;mh$30tg8GE^7zvq8hyV*23DI3HZ zu&C^-x|^RSEA0YxkoC*#IEt5AjGeqL2A^@zFiB4^9pUBg`6W>Br!boEm(NNZq&i>Y zjfB@`1{d)v{{6O`ewbU_Bip@==#m`d zB1tS^7!u(=uAs=OItL6lg>sdrZVOk-Mlui2;g9#376Y#7(GO73XWK)zN<2kMV(n7J zv{tm7wJ}$6GKCaNHY{q_2RazC5uEE&Osq%N$!1MDgFx8Y(xL;Rz#*0mJG_EuWfHG9 zl^4qdlhbq8_h3Ct4P0AWC#r2hl)&@!P_-S{()rT9KY=5>UUe7>7s=@|bMx-wOYLcN zwbXHsvleqS_M)s%Ghf^|NEH-?&fs?aa6cd;@edWPre9iQE^pORvu31j%prw&IQ~U{ zL*l>6Lqt$CDXkJloc5=ZQXrTEF#%C$FTJwgC44Q1L5%f$Hs{86W$U|;z0E<=BnBEP z5kbu_l*mjyCu*g_)tJvW0l__=Rxy(}HkSW#)G&U?633zFzhGmdDHGNdCm`WhqzL&> zfq7=4^V$5FlaXOSdn`BH3zh6|i5mFSL?qM5fel!|FumH~ zGqK%pqP{|8gn~L390?IFNI2_}SQ@FfFf)15S$KJv`xaYfip(n(G@y@S!V-mz-l7}T zX;1IPV2TnoWX@K|8_MPyJE2CX`9*Ts&(rdL9ZsAD$OZtJ3!to+@2zGAB>)dn_wze; z?!ltOX*3!%Pg0PPT zvI=1TG|%~|EIu@20k8w+&(y4QRK6x&T)o;DbUF?L=CJSxY#AZPqn}_Ai0-?VGHO?F zV_6|;E>owPM}T2Ir4rZ1OzSt#o14?GP7%X`n!MpTP`SVJd_fpM&|F0tSIt-*_v}An zGPM-3cB)_YLXPg1bRs8m%Bb-`X;xJJ>K1(bYFeo}{w+7fxZJZBF7dRXr_FVx2T`$! zXk)d)3!|Y7a>|R$nOt%?x3G36i-QY&42u0%p^-3abuuA(1Sfx4MHde1*^_&Sa#XB`4NGeZEI#(DS+e19 zYLZ!gR+pg(yPQpq74s6a+fk^{jtu(1fa%UiSL)E~9WVokTTUuGAof){PGly`nG-kA z@Ye@pfvnKK%U8oB2C-e)hiS}fkOKa-MUvP0F(;n|+Rr-gchLao<#_ne%JF7Ua%vA^ z^Ho`j4aX7*n8ZfxP(!S%_vzR6*|%|?y$W(^nB0ZWui%8B!d2cm)uP5(%>Fn(uaQ)a zBJW}%&A^x_yV9Pq&U>Y&owmO0y@HPIadVmMSbZDaGYzn;!mU?`{$Wu}R2XcZDa7*yu!s$7oSAH-du@CN;C{jr0QJvLIHQlc*hO2}19 zHrt`2SJbaRKtECVzM({4TwSO+JjAa{%3DTSx4@DZCg)f}^xNj@7HX{@s%4r=cFQnF zdN1abq@cQR27jDg#LK_XczK+bpjyA_LA_la&nM)mebYD?%T%@dra~n{WQ7PS$V2Q) zt;}wfj>}E09@QJyyJ%x_Wpf2b1v04yN3NV!A_U>xsU(K|l3Y_Y0vvD!-%RM|_8Z0W zu6X6DHb_PTg<@}ss*_V(_QG!B(ZUe4N2UK}6~=cQJZ2$h7#U8ZRz8KJ2Ly-+(uaNw(Q~R%JDn?IMla44*D*?n#zO*0v##@l}NA zYpND}Ro>`I7V%or&z0ZWCXz>~Pe;dnFgbJFhppZ|kBHOAQ(pCpFxl6AN>< z%fY6SSJ^gMxFNA-x|+hR-tVe*{Qot;y1RN%yvmlfv*fzDp4VeruFaB)2CVf7&~kma z*XeSS@e-N&nY%QetzDgb@6}SKs40}oEtk_JaF>n6-Os^4c8T!L6`6mlK(Av!RE0;qIgkVgE`>( zG3~1n7aTvCxPJorGpY}&hc-pjsCUSCW?70BJmt(vM_v8(D6K!(mfIU82{iycd(D?s zdXhXFu69aA_#(Kiz|Go61|8miDXUzD7hIilth$79x9m#k(YGve@wLN0MJ?w*r=)O~ zJ_Krz-t1maOik)U@DjBW)K4_5tr>xo>OF&)pUH3vz5w3<8WDQXsCV1i-F&7 zye6HiSV_E_(X6zvC^%^oHWhOpCNiltlJu7!Dez4JSDn%R5 zC(WG#ON};#>FWA7?hb;!%qbBgO$H(<@V0bF^!~>0Nj1{!jE|# z*xpm}V(9TvB@Oj6L47CUbYXoHe4=#B?c;pm+Yb(jC{&o93e`;s%B%6wRzJO|r)7R{ zw1p}g+KRP*KsHHU^(`W1R5ieb{HsvJmE0wQ4(vibJuvz6jgDv#&8s}4bca<8tUAm| ze2ZWwldA}xku*1E1AJ(AQ4M8VVXyE;iCpQmZe}6}`tyx*N?+8N zq`dXsqL}=Hj??p+>=0YVk=>qyRnR1;2hTrC3!_~=y^#F}dwT|~gw|gY(dhmQ{|w(( z=o^3bi@UTy2r14d^@Re!@@+#KgBl{Ni5PX&qr}H7pqMU}_xIJM<}c~!RM4-!zu@>> z-BO@usQ5NfVT)P5)XBw|T~%2QlRd6fOn@cAB6OJzToPO1-i;NX)l%9F@par-o;GTb z9O00&t5EFcpel@Ncbs|do6Y5W@k$y0?VjyZbQ3qQ`4Z`}g`*zc=KRJK*Cy+5p~JL0 z)h%+6@xS9!uA+2`cMuY(t0fmKLbzp7Q7sY{#XW+8Ha|}z*h$CCKeD_RK@8SJEqcX& zVW5aDGM>`zcO>Mk1!So4VdXyhr{zoiX}-CLoj&6}SG6y<0#e`gUvpr96b)jHaFPH7 zidfP2U(&0!(~iiXoQ_epkS5+wBLjDgJlU~zqr3I3u4Gaj=%tJxH5PKjHm~}m)~iVr z4wcDzS2WbOxK4J3oBKzGBIY+aNc^@z0q~dth9QufAcqMSHLSJXMmqW=cyt6Qb4)w~ zq3USsR;sK~?@SFUGy$;UOemcdT2e3seJa8!Q{*R$ENY^mf@r9C`&0k4B^Yj-9P=%J zBILjo-#^QO|GR;DV&VKF${6{4%hoAXq+$Bw0+MU_11~2@rY;A^__}jEu6;jk3wJ?q z1P?DUBc=l&#dnMXw~zG7O;$m=BPvYYvGK>_8gNRii{)5;_5ph$879-vCgyNd{i#KQD#J5fZ` z#7+`+PpmhI9~iD1*!|`o@4N6gi6({+9x@rbS8*h29omYiO+u6j1chjI%IEb@YH38jY2heNwi-e(F0r7R?40oT!AKK{7#qQqFsDY zVz|Nwk&5r_?yt&VHlUv}&ZqTCw=iQzvpaQ5sz__Pa9{y|o0VaE)z*oEsn7FQu5DF? z-Ba_@=G;@T4*p~VXq8$jYClDIHILjb5lzZS zsBqP{Uq3w_)zt#%hzGU4_Cul?fxGoKT|Aaj<*{9RQl=mT8DN&^&6{NV$vUYLIqQu{ zOCh}!u;Fs_=!;?cVr$SfjZ_aYi7y#4Rp8TrL3kY}JnHH3x=GTeUd#;Qz;)H~Z~T!g z$mpB2UQ$HIwT;}rH>W1{$|<_orp4ca)d#0{h^5;|&VRVvGddI;^kp30w^)S6$b zp2^q{tlWT1h(<~hSo5q8+tKX=qnM+Bx5qrJZ*xRUBsVpXk-qpCBhbx6K~Kw;xQF^N zv`H%d+|rbxX`*y}^FYNV8;`4SHxYM)le#a7YGD$zSW?S`YTxm8&=gr5C zYBhcX`3tuc3$YbSCtNcf4$6W0%mr~XzhccTDH*seiDZ7Hz^nb?6vRiHH}j927Bd&XoO{M=D!d+?>s;?lMR(EWEF98Q2TX=?ZyxeGD4q{zR8$^tO8xW zt-)fjjs2iWp&OfQGrRsMim~Y7lXu+mYRN>|!2Efyt=qIi=%*~;p?y23PJ z9iZN zO8pO&esQZ~))f0iUxt?v!fQ^PnNvVgylxQ7Z;nRE9INnk{AiW>&(B~FstXcBhOw!t zOesDTO;m+bPRD2QNwSmPNy4c4L6B)JHBsmpAdGzZNYweT2`8{|i{kil^I2pDd_txM zq$^sXWXskQkH5#<_9yeX@43cJqGId8m$$juXY8Kf+X|da_}ydmDs1WkSoPq_3L9kq z3t4zM6!cjH%8NK#UC8K779|kUjnm$Yiq?6EUqkhN;cD{-xPG}uY*-H>8sEm^Q`TQ? zZv)SiuL{Q}zWAL)eaxRfFGAy0Py^gxw}~yAPq_!-7L`|T86D1^$sJ`MUe2co z4Thv3)dB5KgSTR6ZwUPq!8tulZWgPa;PBOa5IP3}`?$uIYRGxb+VC?qkDj_^=r*`_ z1f1^exxGe-%9hPVu@+ue z%_AJp#zV+(G@O+Yu9R$jO_7HOc+qPh_!EKMRKQ~0j)&+N$%X8neBEY7-af&>@ff#< zaEkZnwbTQiyotoFS(8c5TI0F~HoKX77vlrBcz$GFV*a@nG%ATWI0z~i2eFi$@+>xZ zMCwkDI$Z&dmMU)-l!DHG?aE2fv4@FOFL-d1!oqfQ}53uB+u8{kZoo z-oi89pG@~`rnADur08>uSNk=oEKu1e=lJDZ#W!RyN@QaQp@0avaSr-a48v`(kkhjq zWsl7M*!m49Ssstht`j~mW{*w?e_+*>AEmOOT7w#>Orp{eN*3xG%R@2W_7R8h0z*GH zaP7-um`vIR6k!9dW30FZsvXqqV2&b=^@HRCr#w}fmJs>}E=J8vc*LX7z0?@az4(g6 z9j5m|1za(FY{`f;^jfL6cIo1|P)C-$s4g}p=bf(oNX|bByGcK7jgYGE6qutZpFAr! zDR&I&QtOF1w^M|FQsKP_8Q@sjcm-z#Nr&6MbB6WuWe@fOBjpGt#STvH%u4nMJv+(} zFk$HOry0{bjY&>?k(bffDR~wlBFr6Xg78wb4CO57xJNKy3MMN7rdS=QzI0UT;0Hnh z21b;;5UwtR2Sb?CRXXo8!&=2Gi`lZQ9z;mbwnm;63IQ#+dB>k_k+`dZ`c9A2Jz2ZJ zDj#JTd{;F`lR{-asz~j#gdTJ&yom?;k^{VMJ~VS(&)fQ|Qv9!tXKg{1|GtZJ+8Ra> zqiy_yf1N&=*u68+Ad}K5QpP}`sx&aSpqeC0qyaUYeLlBJe3sk&Qj#aE55LWq|D;Ch z@$@j4p=2Y3oQybY*1b@41)LeE0bYa92-1Orypej+oI0Uo&~cd@2dNQOj|-a_OPasY z)gzfbu&#_LJ52XsP~GSnW5Ne}amyrAo}XD_glo-RNmG0!->df>(y|MKnE^5=Gc*}5 zgfqx0gsGT1-RCoK#EIJSUH3aVQ{Gu_+c_P~-Us@V1NXjhP?*had*P-n8g zS4;|V4*!=O*U)%{zH0kS#8OyfpKFOBS_X#=n=C8vVLcqg;vRZWYkX*I-i9Htp$4{+ zDOb)qO)EL%;#LDrNSuJ5%vf3xk@I6IH11#due4*n-cmsjU9`w`rZypk&8mpfqT2{# zCQ0?aTS#J~o?O1G*PkQKQIrq%@dcdQHb$_M{41UIY>I}a%32@3syu##0H(R^SVo=& zUj?e3H@pAu6W034$}dV)*)vocydSANe9vSi@xg&5ngKl3jUhU0neNMDclzZaCurk3 z>C6$#s_P?Ko(631z6J=2zjV)Ttx~L?jopyXsrJY=G!?jNx_qAZ-1!fZyW*`0YYQ~M8Xm+#lrDTL@x#*sD zdc{OBW+f!Ltx!yO3x+v(EBg%4(#=vwTZ4^3IR%E;G2n83bjWL1R$Y-#%f4^$;H=@P z$M>n=0Z|4&@`H5?-!i{{ozraHh=S?C&blG{h_%5)HwA-O=%9!$h^{Ci+7#JBpiCsbpxDanzqzg#-}8w6D4;RN63hIxHN;Jv(%=@pm#kaD-7YU-cN2FlE3$OmeE{f42RD~|xH=oiBA#O_tj5%vf;vpzJPT<9 ze&E^^T0R-tptPb4hzKgY32(%1NaE(kBxjZ3H%xEvdo4iZI@R2isySVZ9>lT1P?V)W zrDIb}Y?-9fpZo~Ea3INFZrJ7jYB(4J_P(?&Acm0w4b@|xWeJtfRD+m@8S^5a&BGfZ zea2>Q*ouXyW7>=j$~DGJ6l1UC5?~b#$}D30WYWb_Lde6h2N3|{?dUF_fH($ z?4v?3yPZaC%7IWQ2{`_qwN7S4M0nn__|uPUQ*XjNJRdqU@#N7t zRi=?+;86ga6KW*2Ff{U9>z=M|swLM;9YR<9T_Lo$(~E>pOC`F7aQM~staCh=E-U(X z#%iB^zksRbv@13-ygXPCeqKzfVdh#Wr7waEuHCS<8;}|o4mbeWJ!5Jwd*)N_Eb;By zDB;f~^AKTpd7%Kp7xwx3yPiFlY8-iHDU2i16O{Rxl{qe6Vvt{u|1cD(eTU zU%)xobQZ@J0ug&1&Vng)<(X{j@G193N>^^bXYPsSA+grC3&lFtMo+2Gxu~Jge zoH*%pwwga^KaZl>0D%*!q-)5N$F)E)ZbTv(UGb**H2FDnI7v$;Qf7YXV5f$_0x~tf z1RiH|f6k>LsPUL8Fhl-lh?y&L@cbm)?n!+l2;y<;zEj`&SiN16Hm-P^YHQAD9$*Ld zf2H?CzWV$v9$P|VJtXJ*b0q}CkBr+E;>Taof-+gIa&^Yd6Pu^{*BCVe0L{B*&EExJ zFqX#ViM4)jn}@BQf6s*aC*X>arGNQMZ9zlv%+5`{aG8lZc7_b#EO3VS7*@W0IBBnV zxUP%6_TS)cb-eR0s+&-j3hVi?`o z6$8+s_vbj@99b@yn7FJ%gZ@$%vpfKyU}7nO`gDK1!%@%CBlNmcl^viK0#b{>%c2+H z(RkgF$TrH+Yn%A&L#EEke%ewPE1ZL~b~X)5O@dmLJw`M$eEZ1I*rJW;MnB^bie_8r zvsmp{J#x08*>c|A=&OBVS-j_|{<*M7Ij61i%{jgYw?s&3>_3CJbAXt&Hkx#eaqv8N zXKN%klIT+gA=kP48(mitDj5B`IN)?LG#~RKs0l)orov=I8m1y@GYagVrOoi z%FhsPKO!@JIl-Ii?B{Clj8fx&YA6oDbsehf{Q{uL=}=^TSJyKuiGDdh$jKU^(WsyM zbG#fl-PAGL{;pxpcV6{_*IxaVt<&RE3FdGPv#`l;c%`F^+7 znZGRR8(MX07}nvOI7aqZaNNsqnb;a;db$oAOgLoxsP#ztF-1Dt>bo$K2aAjfX*L92 zB_BOl?$3C?JUs3bC-%7l33B*m(5k%w?v>i=6cIy5*y1xu$6p)_zj+*@zL;}wQdCUG zJQ=eELX+-8lN03Rk9x26znxD|?~hE{2sr8>&AcBFUVDd0rR!JH+^V8f&sM_jmtm=V>4(WLleqdP#yJ{{ z;pZr@XSOWKo1?2NVJXrLCCB-VK~xGWE&3mt&N?W{?|uJE*Mc-GA>Fks9n#IxAl)pj zQqm2JNH;8vG)RaNigZXf5|V<1ARrAAzvun=&3A@jaQ|Q!pYxn^pZmV9*M*>GL4D}LJ`TX;^Q7~de zybS%U96BWTt|VvX#mo-TxNy-bT{a7B^qXl`>R)5R*BR>XQ5)O?i0HalbnlA-L@`Pl zZ*=ux-Y*MhGM^Fnq*bQ9J?x_3*Tm}NlP0lN>{vKayN?X%b?*|hIPAA&oBA!C!=G_9 zDtc#F&JI{kLTY4g|M40dH;8(dGPnR@2-m5#SUXK zynaj+_|)-W{Cysa6h_h*#RhdT#HAbI6Z>{|zt#sE7?fSp7uIpqnNxbo9EAKu;xD9y>F2v~`_k$NGPo`n#O`eYzn_)W}6pTGc{7Vn!iU1(G4AIv|EKRF&3?=EPa7?fj{ zwCiNBsJ3bDkcAVcqtsv1mc=u+2)#`>J~Puqosr_BU|jqxpwTGaJYk)`@%acy21Fvj zzP3ZoAy~$V&#jf37_;Sy5epyV-lvp13S^0Y(mTPfubl~BCAv6AO3 z`?O`aMB-!OT4k#)UL$EtX^adpalV4>7lNyc^UJ%-a!~Wh)5g1QX0sBXzazpA_SIC8 zV#QMumpZ*jK9*A{>59?7+p_*_J za(v1h%WaChY`~oG@C49K5u-fV3@TTrO-sV(HUL?=#x6^NwB(CUoQKmBTkrC-R1nQ! zX8RRH5||8Dj$Z+1;&Vv`k@WyKsecN}utWS*rn7i{i5VuA2m$}+`CoLaXO9m3eoR&g z2XI5uj*lEv3w(FY>|a+09XJL73(HR+=nVMY^kd&Jp@7mCak zsoY5Yij!O=T$|}Zf4blws{W96Yd_G+-+WAN0F2o(@blUE=iDRu-C1-$X@y_*zT!}RgM%sd z54KU*uMEAK@}+;F*bL(&K9i=(noCk+Oi2^C}jQiKM6PJEy)aMXr zL-7jKy}#ubN>^#~eEhUbYC0ISIYc^@u%O}Vj|g~8fDeWyy7|aR3vW)fnFt}L0DniY z^|yL+2gp0pL3zDy9Od#55~-cyj}2$4*#f%@ngppXJ3cwUsnr%_UPeuC;dL6{G?_2D zez0;c-Ie{@G!)XRryA*)aiV<1psu5l-ElZxepFX*$T`~NmN-AToCmCdf2)@lhZE_8 zulM~vCVs!YH(zRBps9^Ct9O#H-Z8T`Ds{W6KXgzH7uQ$`de-h;_hF=)4YvaA{cw}J z+`D1^U#jV+K3!fjN0t%vQ8+!qUzQ9RN~JKG5@ed~v+&V`@syoLs_IIi)TKW1&0Jd8 zL+pe*zh+kM+LJ?XhAR!;-eeaAOJ2OXt|VRT9gY?PVMakq`i$S-5KIu|(aOgle!X(O zPUn^`r$OR1A4PD>UMb1Ijx&DT(}D0^5Yh_*3{R-h(fyzoftDHR1hzc!ij5R_`(&B` zIXsEXo%1&%sg7(ZCS~ce@G4k)kZdRGIeUJOdH@5U28=WgcT|c)3nr1na3I4(sSkH7 z@8{3;tj;`lzO!@BV8KJeQ5*8<7|e=UD4Q$<%4*?crXsrG;MGo%G1a5%M0d0VA~=3G zufK8H-nzOf=HiZ{Ks=d|!RII8>Wl zoluopnyx!sl|DNve#>A-dX0`*+Rtxn{^sARD3_(zjKsS;2vUKE7=MHQ(9>QF^qbnn8^VQ`}qJ9?M?Lntyo*m7hJfnq* zLK5)V#g3(kVF2K*wEg*G(CyJg!%E8PMBx@}JKNKCs|^4%{q{KGlE4W_H*R71!&YkZNYm5w?mKbs=9Y$iq2-ENqYSFr5y%Irvr#UOI$ zwjsZX#JXbkKtT3un9H&YA{fPr@jinsHG+{vd@z2dOy={-vIHywtFM}^M2IOF{@eS? zwdKsTrhaA&u%(`0eM7KP#r&EAt2>nWFk(0Eg!)Mc<2jaO*A-mgw-`c+2I4*fNXhpm zvX$UjHr)!3!Qx?mzxXIk8Cv@xgJG_|`td8D>a;pU2(C>6iIKQ51-6UcKZBnR?cAfi z?_&0K-mos-+>XKd-+V6jV|H4j)+^APtx@Qnj25LB?;D-b5{m?=@)#9m~_=%ixD}>eF9Gu z=$FkFD%@5ih?Go*QHCL0UBLnSv+-#(FY5}0M%wzxYOqdhf;Q9ZqaCMIpkRO1dG>tk z=+B$+$4<|yuJ;bKtA6#*3?8zNq!wC^L)SufmoM5|+m9_qu}?2oC;ggASJ4pIySPfM zu4AFCA$1=Dd1Qk#ilASnB}p-Xb>h|GxqG>BH~kPOHR^>wmiYZQuq1igKhAYziadYy z$+yRC?k;dkTU74FMDD2iktl~3!QbK2ZJ0!)&>sKQ6i~$*Pe${Y`i2Gk(a55|O#bnQ zSLc3|aOpN<>|&8r_{=mbEG?AX2^So|8esv|(N3asWpWePONb8dDhrYSpkC`(Ch={2 zK0)P^$G@MG-JfC&1s>Em-k$8NhnzE?A$IZ&Vo<>`Z@0S!XS*uVa)E|ut|4yL?ZWK+ z&glmAp(%aIb_mFSv^9gE@q=)xiNVDY(VNoJUpTuJ;1FGE z9E*G+mX3uAuaR$nkZi4;r*741FXZKbLIpf9@~wIlyMZ`mDx!CZtz%G5s8H0TWAa6# zfQzbx!H#V5WY?^3vSpsAXXiif4UF)OuRC#|NI8=Jh(@FG%2yGYpBCMgy1$@Qe&@Oj z%e;vm5B&<2{&M+3d?_1+dG$5LNf_g%Rme}g6T<1|w&5RvB!04o}*U5aV0 zH=n7(z^g)@(`46Zc=oCEcYEuMzlG3D-WFl1>IfHb8~0&6#WRiJ?J6_?zzDq|3Y2-| zVCD&L5~~#dwcCNkY`0&tJ8DXcooFUD74!@PH#$;im_1@8?)DTM?Q>1cef={c-YFu9 zzhfCqsVI>r4mu>7F5Hw@qxgBsM&pnnd5E=;z^P;fy4F{X7tJ$fWxARl8YQ$&wj4QY zao8yn+j*g=^{)*d3NLF*99`7J`;46z zK8+i&SxReNEJDi@wIx)UM88MLR00mf&t|$g^1Vbl^9C*Dp+B$h{P;ERg~jBN&-&+z zL#Tq)mtzaEof+yAJIuB!^{WCmsijn5;J6z>!7wah+}mk1yPYu$_U=-r$bNZ845md9 zV0^`{(F81NZQZdX8|cg|nmxiBBCv|OBrb{D(x=F4;CFutGQMp8^T#nXcz@{WXlv+qTMFb}<{rn6>fG8i>#s zGeq7O27a)?9QS~~We2np#~~MjIN2jZu*F?d_l4HeKA8?WA?;Vzk&ls}p@Ue&kMY56ySI{FR{}-YAI}fh zAgRjc&<8al7mB-D&S+&Ita*uTiRzswvQRHcK5N=N+&Tj|?a6Gbl%8uw<{^knNR?`pd@Vk4FQk+joaQFdw6(y0f`3m2%`r;yEi;71I9#l>F_h zc|*X!FYJ09SHdJiyUXlGyT^#-5hEJ-;9x9Xsym-8#UY(cyo8mUu2qZfSW6qXEH7l` zx?B3!HZZxf!FU@UNfq*yx@{6E-3}4AAKAONXEVWGlf^VDSH9}jF)r~`u0!u;JV(zF z^O3|Hr=vS0@LgK|!rBRFn33Kd(%Mfj8Zszd+uKTF*XuBK$LGygL`qNWs=$A&bNh zn>6wE>zwl+N7|;(-%T=uOPhHT?bd*!f{HXeUXjmX_aX`Nwu%58y}B1X`{!u5d9bD? zdLqScM^);Z*bgbYz2NU_!G2E4cl6_|oZt+I@a+_M_im|-@{Yj}>ooq%&N;>L1PC#X zYqSry5%1iFLq5OWh)JUCwZpbTLHtt<%D=+Wr4J&;96cD|Z$G7wA? zJi%VV%PtjD5)8S7ropnTcf-XDQS7s~KA)x*65@-wcJ4*;1xk{K;Qrjb`?A)rlhv zG7_^9uvp#V9o&-%`FChL8pG5m$q%LTYfIS`!q6O(d1dQAX<}xr>|T~Z)~eJ;Fp`#y zD!-i~kR7Hl==;m&4EyoFj!IFw#zcnv+ddACKjhgYfXGv5kwC@MVz4%aK0Xx=^qF(r zdFk|Vm^BhJg5R-yAt~PwO6P~xV2XFWLWoF;p9BQ4d zI8Da{Z{C20lvh7Fc*ko*XWg5Lsp@KhL65zGtyu$dv+z&?=nE|+SIVA(7zm-paETE| z$C9FHFz57f{xIw=4KoR^GE3N`J9}=7gf1o95O*&D>;rlpCUS>b@BHLL-T6|FRl)n5 zEiud}{Y@&z?YPh=9WY>MQi)*4_@Nvr+d)NoD`_xD7-_LPrw=h9voIq6u};UdD;OHQ zD*$n3-_F(In-YbTus#WTfD0uQOhg zDVpGb!)f{7Fc%|ruZKVGPdJVF-hC!-62PoNCvnW%|Iw`g`SrdsgRntTKl)HmF?C!3 z!?v9}k+w{1-kC${w}FA6E6*WH{Yf*ND7|}|aV$`R@&OgW7KWmeo1VcYYDou_rC8y^N>qCEjUqT)%P#?J|HD>7-^RJ>NZbPbgSD3X1ik$@u&YH$`l zfGL!4R?BbP>J{iMpmR1T!LH4BW9&MS;c`_E=u&vH%h5)O@k{N(?bjX#3s16JyFM(0 z?9%82fSO8j@Vy9Xu{1{i9KEd(&s736NnrGev`hUePfnapU>GyR07ti3;_QOE-G{dO zl><-L!0ejj^O6b49}BkZZd( zTHj?~GCW(FTZM08rf119V4t6l0k>X$=?Aa5Ol~+4Iu*Nz17`cR@&ZWkweNMPtGZ{J zcuY`sxc#7bld!0iN)O%PBH{^BVl>y$^J1Y5aoiJ`ZOlj8`HEQdYZTY9^2Puw zM^25)^EG2`DcHN7$nZ8np{P72Ntj>;FLRdH;pa>oP=cQ$mAzwWEf>b;Let~DooB?7tw zqvncJPqxeGg{K_wNgxpKi7FabF8gnoN->~qE!8Z{@oOA$6rKRFFh&NWoNZT-NLBo!G70_n9g> zmUoz@*m=Mq-Xjbg;<+kQD7mand*NV|Yi>d*E1J{hU8;&IUrsz`p%<1&%#O296Q1k^ z#|zufIT5_0R#{4X0-E{p*)@THf2_I%^^&hKc4h?Bv*#xcjguUp7Lpz5zhRI5^t}67 zC~!ysNel9Kw{B@^KrSBRt|T*HuIMVOmas<#;}B=Te8GEQ)vRt$?prJ;^$$52GD3r? zY>R>lPJ?PZXJOWD@2{J0o|u5BBcgb#^P7a|I?=M_O$F`KjRjLSH0IKZ^Ud|3IKe1# z96i>3mxkWYNOrQL!K@Frq=ls2jNj~}bEcwQ&{NJPl=ZoB?-i*d?x_li{FdQ|DMe^i4poxCTduykMallM_zyh%Hu!W9NmAx? z_S@I|o)G4!bQs1y!T7ZqfN=v<=Ito5!Yj$V4Olh}Un*keOuYDMzMIkq!|-$F8}S4PrxerW%ISlYi}kXTj) zg`>?kSRLE#1{p_FfQEvx^#&KR4cy$VsQpg9dU0cvk@&2Zm2P#&AnE&~@lb}Ix2WGC zXLH#3pF-a9hV^|zUW%uA)>MnTw?~KZ0QoaKj7kCvEG^C$Tm#?2%l+Gm6M{rpU}1#f0zqK(0954}RGUviRYd{;c+U5)X8=)Q z4r~*>qA4GScpEy9>RAD&v5Ffg6V-nA*X-BX=*?J%Oj`o2+RLl@^W-zl0wzDsJb2tt z%C2%{G`cGAUvffaWclO%2k_FKIqsIL48g& zK0fSFgt){39MU5Q6q!$dFn)wLEEG7DAU_%sJ8aWgf%9{lwC{&VO%iC+XZ^sg;81kc z9p0ho*^%h@5A<@WlX@b>Oue|yL_fQU9a%G8v-%EC{mRoboYL=>(GSNEf2&@*K^ZZS zfps{Q;82Lqj^);Er;x%Zj*BShObBe!c(oD?)4xN)A<~Ue7&3BdBxq(@np3{|Ybhk; zv~6z*nl|^TacoEVj1qX<(^v5gHz-fl?0e zhK|f$JRuThs-iBO!|(sgZ$%uyAr%RPr=ebc^0ggFp)vhb8q9<(W=n-V>6dqt2L*DZ z#&rQn&mMge8WLc&y~XxT5XAsYFs495ZlQ@cik&3^`;ov_5aYsWZJ*V_ZM`5NcmS`) z4uJguoibDjIrVC@;p1G|nf1m1qd(u9yx(2+TvU$kN$@>GIgkd2o0_S0R7dPnB0StLCk)d`MA+$f(vgiBI7xBE*$r*DMjHs zjvP(b1Qd;3G8+*|Rp499@EqRJ!3l25!HmCu3Na`_m`S*e`*}x)T-Y~CDmKUa9h&MX zhqmQ-12#K-;L_6gPqV4QW3I0kerpeIqI``-W&5R9l}-J5@+0&s5*o_83V4&PkT!$y zz41fs@nlyU;{o>m#*yq_1(92+q@4+vf9*C#4XwLbpA=dE6+(YD-o2zLJ0ov38&s?6 z9p@{XXFrExlS(+UaDxi&Ub;{4b0PU+6Y8_GJ^+fSnSrQM4ybj;IaN4zMS@v1rB%Wf zEHqc0m-a3w^Ge20o3cHN0avh;go^PCG2OG z2#Avl0AZ7wpyX74HJj7O-jt8cNUULPXH8cVyLNQzaek9>cA8=5qCY805WoPYMo_U# zPLx8TxG>~*cn_TxY;Zb~?W$JpM=KRy3_`^Lg@=Ncd|b&~n&6;G*V`z1u9*l1;_^}2 zqYx3pUBn4=(o<0@szemmyUB1BwySNIA zv?B=x_ND?Kr#{Y>`6Z9Lh49X&HYOta4qmM8`ol<`zbPT1z)ruURWRbY$^JXlNr|04 zDTii&{b>M6{_L+`WGi9MpAWp=L$v8MCs`-xH}L>*Dj!CAPA>20c8~@ebq9#DL}K#q zdW-_m()EXNb2r)951-Y6bK*;dUcP-=PB2<)9>LC%lpqrd)XATgUp|ea`M4@g4)l;r z0~gW^?1#8mI26R9Yr5k%zoy~BZpxK0D!`FYnhXtLpp3edvt5x0oUi$ItE2Y{y=kjH zC(#v6T*VLiRsb0G1$uiZ0#9C-@9SGwIx|dz4WMSGK&HUqxZ3zwu|jC2f0^^C&;$cr z(;4rSbrxb_eQVu9T;wr=pS>n%Ylbnb{5kW{JSly$ww2jO<a9^d8_9dwDcEZ-h4`%Ur(Z%4;lhdi6BE9FB=jbIm2e+tyXGBVmu7X<9sK0x$5UziUQ$m!?c~GZvHx=dpiw__e-N~?J*bVAvT%DzC2n-V| zRWCKbOis)}6aQ3R7aDoo__{nmlGfgNPRaARG?1PnMs!a(C|xRH-Nu&}A)QVp3x17h zZLeyMe?fg>mi=0)?x9X6~&iWXD8B+@CcHGyv1^_CQ_%b^kJmLuz?k6de$`M%uIX#iPBD zPsay|^{P5B-m!&9mNEa!)%o_)nVHRoa3aJ}-!#A>+_69PuUk%Al=^PhNjGb${07-) zU21uuVBv3Lf;5YQbMMefQ*lnHM2>xQ0G-Jvr<9GN{Q@nPqXbdVP2MAKI{N=a+~gDC z;shzW|IOm?$0v;Ov>adJ*-iR=Z3sR-Q~iED9sp3$ileRP^d;#O$v)_P;$)r{r;1ts zg1e?$H&sRj9hUQWJT=q2j(?!Lb}K%1nIVJUc0*OnP>FduEn>;Q7ym2i+wT+E%w&U3ZuKFplVNqO{E-X(?r9S7hC^Wy0tO~|ftn%{NIVm;kyKInpBT5HVCfYf z@_2=Js*qsNg?+};8g~MznfYmoc#~hAO<%}Q)tC~X_9fJ}R|Gk7?f4~CQ@YA28KCCw z;u0gqg;*AhVvH#4Be*2LML{V@1Y2G%p-_KLDifG*Ao2zQCmPRQ)=|g~nbrF_9i%K#@NR#tk@OCkLlYoPu;S{-T!?yJ+hn*DA!EPni<)iQnzmgr=qRuR&i1GL3uFq zafQ`MAmAAvp&ITW^!9MN;k2Y!4VpNB41&tT@Err%VA{SuA3MCOr@yQ|1FqhCC@~u9PmgtSOMSKn5c$9zM+@5u9`5Ln{HOo~8)*Bd{sQzwo!?Df z)U7Y1I}D3+v5dO&{>n~`_b4n9aeH6p0Qm-Rz!yPP&x@`B9peQ)OEFZ~^T~DP+i0p6 zZsYy@(NwP3{m(pidgFa#hqp|j2&<}Wr$d{auB1CxiXPoAe~PYR%6sP5jDun0^_NfR z%t^wvzd-W0px0OL+krP^v4KMK62#IU~pCn_Rb zw&zc%M%XKRLq&MsdiKzOmu(v4O{PGoU4sn&Di;S_nptwkCY-k9gfw{iBv|Az7`f(e z@p(b@Z%VNdTOszf13=?MQt9XWC69f|Aw$)%;p5HG1b%a*y%K7AiH+XkbW2n2sf8zDOJp}1n=}_;RzM^0OK^=dow``;CaEMQNV;~34a)4LL$ z99emG@h|6^?)Vdx%$~tPq{9;#8$rY2G(r&JJy}>~(6a2yboGc91FD@9zN%MlT)>F?> z26~Jl3!Oh68A7kfzwQ*>#Sc#W>tb)LKyN?`UtM_z#~WD&0ZpYAJGqT=` zi@QP`Rx0{RTxHPRvtd1Y)clrT)-6?JR{?jsSmm>V46E|t>8IWmWXe>_hFLHCDRyto zFna8XnqIjOAX>WJ-&NM){Vfv=GDHZrjjv?cSGe7KNytidlCP;fSB|GyqfH^96bTnt zi{lPHC5vU0B_}!AqKV|nbM66PU!2^l$2~m{z_q=Zf(|GYv{0}$V*tar@zasm3A6tM zv!TRR10~T;?|s5%@?iQRM8bdKQ54)X9LoX}iz~-1K({8}a{0I=(^Mr_Aqjqh*Aht# z{!NaxC;k&7?cEO1tXu?IacZKPFj}c6t?CPCEm>jH4Sp_AdA`?ZwQK!;9Ipx-IC`Ph zO?NFp#v@+$JL^WG&-*h-cJrV7lnmTq_=e`(yXz%$lud|(4z8Ty#vVDUGof*{6 zD4QTjoo=8~ELTNeJw&X)^JT;L%mzC9uFF0!dnOe&52u;U8LZg6_KKz&tDTdkE|ZxS zkKTqNs0Y?IvA1cK3$sB#%Hb(%dcb9|UifzJ2C3_fI}b-S=FJvPWG*u`LEbOzS2>H53v2 z$4dY6NoL-yN!tfakKvuuzqVnC)?ZDtkY}n~@`InDWto5Jgzw&E@x;l4j4J&~6l{m? z5;szKu^Sz2=D6?aCg&f}21T%DMt~0Y3z?;)FVHy&bGJWLOfMT}eF=rroBoLTk2fD* zVmN#RPKJ5gB`~20_N#m5A~`uqDEXi5zGAr-a&ivDw_fC+1ja?(e9Ckr(}ro}owwj+ z{_M!L)Q)=waT(5J5UD$Uyl`1&*Q?H^PEKUK#eT`DA`?bpm5j;$%StxIIFhf-tx#*- zFFihUzW4Ji^0NlHkVdmUmgTIc$c*8Cka7%7&)zIBOgx#f}VPv%PA}Uh?3964d#|Y1ObKXUX#oZNFB#w@S(V>1-mjZ zEXteIE_5-){g@YV!{VmFR{G;8Ty1EX$AK;q&a_(|)b_>-7TUy1791s?g+LE4`@4RU zJAd*9Bxl|HZqkFSMTSE69Aoai9`G044~S&(H|{!2@>YNYA<3W4z?|57F;@q$HthCa z3gLZuYCG(&(8P$A9J;cdK0x*vh%-w$qRFwbqRGJu$qDpB#dglx_qd@d+~_LN&rcij zVb)JS?c_gKX&{ED!*Y_d(Ub%d-n|=Q{TKk$o?~O;w8_XuqQrpHbB6?$c zJ*MvEg$@zsx4mNV_VbPWpzJn0a~EAXhm7Zr98xoX*(TZh0vMQRezxEyMeLG(sWtGC z!+}f?Jk6&e)1^*`Fw1Az@}YLXysJbX4tWhUJ^rn>yd3zBVt-a7T%WGBGjYTfjEW=3 z5uc6T^+-}zr&A6@Z;vQQvZ8x^v`UOgMtykWCN#uj!AT5?)V9~N`2X(CeLVJNNh*s9 z;#Ab5Xy?RNKKH@A2pqqoRUlbptGRA{MCZ$X{TDf#)LQK;VO__3C9)de&V<45#m1=e zOyL#a0v+r{++C-Y-Z77o!<=l#<Hpy}R;ksrkQQ!e>wMh%Bx2zsnt?@nr3 z3ye;6d{^gsI(4r6MW4&5jh^gqvkamve){CVOutfxMII-R z*aGnw_l!YeHt52gMstH63Dm#EYz6kwY4t(CGXQMSqnsHOPb_T==qrB!rulVvu3Id3 zqUq{qPwp*)j?rSt3FSY$jvE2mkne>>lyx7@JEQBTZ$BfdE@F;MUx7v$qG4~oayAL% zk%+@^aQ;a)WQ3(r(^=18!T%evpKnKu0d@+c3qmO!&jAvm!)61t1spI!VuZAUzp?RR z`vCG+f?T|87}P2UR(J6)t@)mE0Yk|0#zHL}4UME;5Rb0(XeDY}p}$`O*3U?e9fYTk zJ{8U;_$4<|9M)@rIR!{-Q~=M5cWLwJa7FnMAE3)W+V0MnmSEQfaMuVL86$hpslroL z-5hc!JPYcLoZg72u2{5wJzj{^>#oL|?GXw0TJ|Sio3?x4Mn67GnTOv|T@PCfk4w57 z27=eWIEo(rD<1RB(wwFpa9?w;^5y3*fXO>u44&+4_T7DVy5?PJC-B_ zEp9n(IiXIp%X?ASM2~<6GJISYZO`^_O9DU2Cb(#_7#BlG7#D0obHW9-AdV~JNC1mb zb3b{ZOtq5u?2??2kX)G+xzX3`H!qeHeF$R~6_qdcU?l?ZDb&FL$ZERK#rfhGZGt zwatoThF)}LOBQ!glOayOLI?TmcRI!2f_5I&+->CFZJ`r@BqGa-`!zR^>DRTnQW}I0wW@vcdIe}NPVe2B&wJm-Z#S+DcQQ7AqtX`Dz zm3v+;-;+~yJy2vJ`=Y>PQ_LQK9frRg$l|q1aBzlk$8aQ2s6LAvXH_y?50Ob zNjwcz{$A`wzP_wQCh+AT?iw@`%?>zy&Y^36^M5>^+(lvyC|bK8PPavjQeQt`*TWW* z`%WCpXgE*4@e;aQ!eq%=2d^r4O(IJ9iV7`g!Q}+$ZSM3gczC<)G^|ya)`?xE0nxH3YLvm!QkT6fE13I+g91)Xm$7C$YV(ewhrt%fz2F6PCtO{eHb%MqCwW;#h`(%7jRIp%%6Uwi3|3={DVFB1cYxDs-b6 zqd?cpgl;sLt0DZjDwA@FC7eDx`Yc@`)!tWUw;x*@EyltDift~G3AjoA``h)2f899lr+=3?d2_k|azgT7&2#EOK>hX-gD;E~vfcUV~DxofB!Y;g**cqny zmfD8+bok-9!lt8nTS8LRHD%x&m7-jNnM?b_;PZb#H@c#{vlW<5*jcniREmOI#!T!h zDYlfOHiWZauc)c;%@~(s>amPdbyZf!h3dc!WVklBDqQ}$q!f_UWSYJ4ObVE`{}XyL zL&Yy!^RM6h$W!%JagZ}7#|9-v%cV1M!AFvS5M)$IIZaIrz9N&&i=Q+11+R`)9G#Q5 zAXNmHdANtZB!))V-u`_Gkn*2p>%~swxv1aFAHVUN(CldSP|55Y4}!^xl+;*pm74!E zL214(r{v{*viG)ufhV_@?d5TE4_`q=WS3Y8g|hpIqbe}qhDyIqa&bE#g+p>HIdZBL z!hxm1UD?;2v00X;C>m)GY_G)W+u98R&MI(}cEhBxLv(7G`n>e^zCspaB4he*{;E3* zYep(h4(#*N(YnUljn(;7`ti*}QjW}xuisY&F*7ax_^l`}*Ke>H*KC+;&qaZcD$5 z_d0E@gfqIra*Zwq9Wbk*XIK6m{Rw7e#F3ytyT1LT03U0thxv&Os{|uW37@e*b$dWX z=Cl;Hbwx^0xyyE@u3*6rs4+`jGbJ*q_fA}9Pt-fg9{p57-wH(2O+^jx+?|PMrauo# zz|Ie_6@Qh$AptgzRfGk7I3U6%$nusy_V4UY;>8Z;#y6Sl(jB%X?@#uKXnQN-s!!PA zkqaLtV{wKjp~4S1q{;PKCntK-)shJm3pvP1cuI;GYDkBnM9I0pbT|?31_FcaKIn zXu40LoAl7egHL9QGL{Sv!hn(0e^bn`yDiz;82g8?%Qb$Lrh_k6Qun6wMIy6(71bmz zw?q<8EiEM)gH;*n!Uc(`Z#>o*=qvC#ea7i?Rq9|8c?l~^sXS@`0o6awaT;o3L*yY z+KOU)_Bah;f}9v1@{$JgCT9~oMy&l6n=Nn#KIgallyoU;l~c9AiaBtfV%qzVjU{>_ zwL}UiCh?_gGoAL9+~BX0A|^Wz(X7t$UMI{BySI&x5ru%30KLziooaKn4q z`o~|{e8$#K9@!|O^DsMNR)CC|8>~gP`KjkBA2wS;tAI#z#7MYCG^TE?f2gV#$1geC zvO%PFu*5cTP83x&{O93pDxM-un95~@Ic^Uxn4m9REI=*FM@#%D?rqz=7tQb781B5` zi{HMCP9rB8cZgzv_E9Q4{XX&#hKI~(T=QMGv_Moj~3L&r&^4puL5)*HEfN7q!OI}9~Rq5~hde^VEbCr8Q zY?)s*FW6R)*Vn(Gy6zPT=VcU77!k(G$AS_0P;W5x@Zg&eC)g49&bYcCw)kNQ6^I;H z@lE{MS$P>`tXS{YgmZ(kSbAeO`*p!eU*2GoEKxUL-en$Fv7oKyBgX3?*!9g`PhVHS z)~m;V4G%hDr%qvi2U{O+za4)yCqy3s@$S4@yZ#}`7*EXHMcS>Db0}9pkGsq7$>iPe ze_DWPl9=DDCeZd(vP~{-4N~FKt$GnnALEqD?Q%rX++^R#GEB@7;xkg1Cxhi%ef}J9Zhy&WBrlzv(nTvIR!a36Xg9Z|$ihbQc ze7K=$)6jjb6prt}aJv;g0md0G!(F}@=;+1eDfEmr*EPJwPwE=VsfA{Te=O?>pKdE} zf7X`QN>}%2O7!a3?>eIuE zG(4%W4WxKfHeT(>UPYe<)Uu=;?w?S8=6N>4+9+G)jXcBfOVXDvu}(dlf7ZqgS)ObF zBA1HxtLXh9E8__9ha6x5ZVut5l7#)P1%mIdRl6Q>`ok!C7bkvwj@#gnA@H+dbY}Oj zvRRsou!$5SX#GW2_w`@-Wa6grtaZoVmJ=dRBgPU&2UB0^k2ORvMwS{!uU~)1 zxSgPQ)g)Rf4RTNKUOP+dvngi%wMFq7KP_|6Krl_`KW)Ad!|3fj>uPRnJo zDx7%GB5-UGr37wD0%$+nWd>OzVipLFg}?Cv|Usuj}u8Z|L$EDtrKNvzZk<~o;LBRgdp5prF>Uur%Z4qW`8$H z5z0G8LN4;S4>uSV^&5t{aj`@skK}&%H<9wO^i3I&5eNH7VT=w_2XaI*7>5PgKdpaH z_(l0TIrnpQKC~73Bc|=ZK6BCp$o;uEQ1H>&eS;U{?`#ta;?w*mNwphkE-E&tKvsicHEfx2Z*?DCut@=s%Z3=Ix$1qo%N4YktYYRNMnb` zQ=#i`;7)#Sd7Kx|N-aGN6Cm6~?e3-)8C%n|kF#r39Ib^BsCmfZTDc_lB4FdkJVH0| zMG1{jtQe75JY$V>104(Qiw~14IK#;Marm%4T6Xj6+tqiPKXyAkT83KP)-(BJ&YZCz zHHCGMjC)l0XkFa7xG9Q`6nuJ?1;C2DuDnK1?rzqt)~LP`%ZeYoo6Tq846#yoF)Lj| zT)*h5At{8Jo722XVioDt$p#4r;0w{xRI75|hj$@jL~m|Y(3*CvgWCAPG{VQ$b!bsD zkde1bGPxCg0cM$pcD8;EN`I$N$t;?i+)xP-bOq(kjaqCg%)6!F+-&Uy)rBFy5-j>) zaN2k2;OQyCAft1sE`dvP77Sg~?`saqcP*CmjDPP^0Bfhy#f%Usni^|Kv8oF zLvra6NjDZDRirk4FQ}yv6vVoq$`C`|sGcQ_t%dtY-a-1Ah7zygCN@OPNX&S|s*B~d zC7pNT{Tr{tv9arxiZKa^ZAF_xAZn9>WmS29SZWX$&}t9h#d)UuWEt9@zn*x$T#><# zujt{Kv@%ZWRmNzSq%K}+@#hS5|K94w8OUUnaJW3;w)E=Nf6pO?#UqB5AqH2V*4)Og z|8^4Tp@xXgmoSj96Qi4-);So*B+QmeFUTi07Q=+;+ENiei0^yeGH5-qz+7bksdh#) z`u=fG7~!$)j(slVqPDR}gKK-Kx6M3NTI_sSSHJ;WJf^jWq@F^<>`;XMbuMBlf0LZY zPY+enJgA5p%CUbAccy#jBf*sUlaC5<+|v~NOFPXpIxM*?iuCcWlJWn{r{R|vbJ5e3 z3GD~Q2ZO>qXSsDuH}fBJE*L}UDS3JjbR%3~C!SmD`?Ry_b7ue1Q(|;UK7)#gAofDv z-*WxpMQ*>z>Vp?|N$F$dRk#@3q-s6-1j5t{syHG1VB1zNcYNZxP<*rRyWGl; z)yD-BW&PqzlNJeSGY&kSQ(-l6h9^&U^PT`%N;Q_Dr6gGI^0;?7(4^6^3?FPE@ltUT0DFm-K%)*2`?+VqYDIRQlM(5DoFu2ie5b zxUvEXhgH_k_$w-{BKQgl(x&=-^&}bYe^E@C?TCHFd{K#m;vlO0^Ah=0}6HeQWswU)^cMKph==(vtu#qwh1r z!pr7zDY7k=TWqDc;+SQYRCT{G-G)E1>A%LB{{GZW5(N;syyNXk51?lByU=aSE2 zw*qo+caIPaZW7y*r3L7R3Q0b(^0iG+vB95B(cic#Tj`iFI+7w2vjfL?gg7j*0WE$K z)?xI^w8c$z{lW|GHYi{3zYX9Vzffya{HiX82k(%>I^f%Z`G~6sO$*QB8|f_$<7PdC z!V-&lVJ|TEHHzPFec{RQHhu71_>()UnHGc3j1Wd`N{xNW+;_*?Nnqv6h5zGgNXp%% zWO^H@!0|fTFzG??$}wHIl)H}c&s<&a7rqo+ga%_u69oTJP*`whUhygnt!EQjXfK&t zFA`*F+*9Ho9e_-O!MSNbufX?Sl+WS)g-uKOFgT>Yo?SGS>&gJxTxB zqTdCc?T#3HE}KQ+PkN>bi9d{^XANHMlQhD40LHLST7T{jNQYyEeuUk~Fr^I(5@eBP zNS3`Qe`uHUNHbkxT@2LytPhcl5KW%lF?|()Jqc+fwZ|F^pALg@=RjDgMi-qOowo*U z(rZkytTy`j%FXgbB{8x{jnoca0LiGe?03BDd2M5<(%~*|WX(-nq%FenGcZYv`j_-Y zpq>~tMmgEhoGfERVl<7MUF}E5MY#UaIav?fvo(q9ib1@?vRKj}_Ea;X5=UhPu0nsm zeY=`D_uTzaGBB2Pf7x@LZEZ+nvennhgXBCKcbe>--RYOro3&G>4fWpD_1<~&=i^&v zN3L?#m%3)9#UKhp4vh&)wmvidPO;!J;V`BR-Ayx_meGjPgd`j5e2%Nnn*tz0&&s;D z3B)7q+NLlH>66V=jpx*1=V_z!)ZL?PNzE+i2eQ~-8~R#=U+pW;<&x0$qns7B$o;| zm%r8gtqpif1Ja;Hb}%-m^^*-#w?ZH{xfp$T0_|NcgD-eMpDtJKODW^}2zvYDEv zxHZl&6h^pYQ#iF(sS-uXDv3kv+K(2-3L8vj>! zJ7Z)1M;tRQu8=ANy-eV+na`4nP$L-~skr;MWM^3=ZZ6nx2|Rfu@t(51Q zKI>KrkpHqjoRndz#IGKNahaN>DWa2ZwV8LJZFVWK6SG9EcQcG+#Q&)uBBR;Mf}yW$ znMNSe`7T4e5p+6Xw5-OFMZDnRmu>+?%890;L(G#2#|2A=u|ipWyLa!m4!V9!4;eJr z?sl8Uzs}(%@NrU`)2Y$(CoE%>B!UpB<(t)0;7T( z#SNyKIhbulTM?xDFFHRttg9zZi;i&Ulo>yEsC*$zYO zPnz%aYG$z2iP87!1f}X6{4mb zZFgu-T!#XLzuBn2BIRpKg28Ual^h|tW%S2(?~ocKY78#OkZ$+Qk*9R`HE-b14&l}T zDIJ4Z=X-%MX8IZiOI0>D<{n$jIUi!0Vcv;5}NgwHpz0O85JC^Fh%a zreQyP0fJTiq>JzhuaAX#;52~2xfmAz+MBlU* zhe2IL5SvCc*;q8oC#brlAhe249-1fNN#r?PLqnKpP$>cHpGz3DL7xefn|@2(^~$}w z9$Xs-L`r$S$sJ+LcgJg*;=(X_oMipXF9!>M<7fv}oHjDavC<)<_2 z=W;oSTi1i?PsDTjQExiBDeODD7P_fXNMP9A^*hiXK< zMZ!xxF(pWIS+?FTNY`M*V}xQTHvwpZV^Xq>f=%PTQMHYUs!@JTMeYu#49Oc1WNYua zC?6>}in(y;IHeuS&PnBW41*4hfiB>(rAkTw?3DCj&PY{5zNqg)<;JHh1;`Pn*l)kR zq)2~O?w^d7pZm*FbKL>}!3+QiOnFNt4`|S*0zW5Ff-dkfx;)}-!Te- z={B6-@XQdyT<|^{7ye!-!F1+#g6IVs`~vYwk04 zr~gJes2C&(dy-`L8#4E#o}kfPPT2&kuXXG#KSo+GTUhGR@M}4!L-VkhU!^LpcoWOd zg>!z$eF#vZoqmQWK$!Z5pE02)aDtnin#DAQxrKC*vd4mt-i$U-nE9GzZJ!nqq{F2E zUkRdEw&1Bb!5!1v!wM3E4J`MLLE78l*M=c+&{~E9H2N6;(ho9~J<$RkUiU61~ zIe|oEiH)KbOCN~fTEH1=Pt!^Ll$bsU!@^L}i711JU7KZuBw>;!3bJ?c0k`ABM{bZb zmIj8knh|&ml(bWNp!6N8jcjF#p@>lYwpy2}A5Sp|#PLPmD1@DSDxClRF0cRU`ukcV zyBi)IX%x$5q^!sPLAD8gBw~AMLA7^4AfEon8%ApE?q@-jWEP+?tIWjpbqJ9fbDzuC{&5 z>1HQ2iefFrc2`I=h_`l3pA=NffV9G@GZbE9XnKUinV6Z&O%Ut491TBwU!GlbRyRE# z5dCZ(X!LSq+pB~gPD}V3WjZuTkYzmF+mp-i%`~f)ckD+`&r=Q}wwO2hvhr}Txex^s z6`U#b!3!@VmHu6}1#o`AlF}q6N@#5&hxQv{Xk`3;Ibf-&9ol6u88gGK{5qprNe~WU`TixWVkwz;SmNke%Exw zW}3Rj@u`WUMrZD7#43fFxPjasZlf!4RC>kO`iNc2o#jm`Q*`VuA9VT%S%o%}tUANb z5o8S?{h4U$15NpPw-vh5c;ezN{$zgop~)&nXNQ}$4x3Nyay;CFxC~kh=v?eGZ>^o% zi~xehxXAepVYKkBF%#A4J+NwZ=4ww^;b9$LRma@Xnf#~!JYg>YlbfT$m`BA1HHGXe z<%TX&#U*2k<21)r6R(M95#R$+)7bj!OAzy^7s)=9f>GO_zGy}oSf~b)c7NhkfqnJN z8-*x)@bzO*FpJkry>B6EZ#*zkcm;W$w*MoH_Aemwi@JR?Z4!0&P=|jL2OcY3BUqUu z*?}6drCQ2Ye30_56u#|WxVoOvZFoBfB!)LLyCjfMNpeHqy=@M8o6IUW*s3Lkx=nuA zU&pln@$v!kByRoa_AEx?RICQN4#JmK~3KD36 z?1j1n?g+N&X@*XER1IZBE(L9vYtZCr_PB$dt~a(YDQL5yPCl}w@X8;*o&{CGESEEO z(m2C&Zn2YJmAuqx7%$Rl7?xNLA3i>*b`Dm?G+j4iyW+)43<&vVsffmVX=%NPwX#+; z=x@dek9OD`6OTNAaW)ylg=fW@?jUO!+m8nP?>3fN(Vy-^#RG>2nYn{C*oGFAZ6esU{L82`S8=Z8>UTLunbBfv zz|gf4liJmvj{ds%iMV!}|88#fKNRWkIO@uRWMSClQTsc1)JNl0%NvT&zdJ>}Sj_L+ zWV?jN(+vu&rANM0TJg#t%jArrJlS3ol0O$xfq;AX%rMs{SEz9k_j+picn|mhX&Q(& z>po6~b&~n_$c_fbMf#6Xsv}pzCoof-?CF4YX6xo?Mt*S4js=lV0Ciw*kTrV%o0C(aTyid z2~xm)-5e>WlMUsR5t<|_>^LbE{VAVQLYlxO1gKRl>-s41y#N?{?KWs;!oc$lv!k~LK=yF#$%_T@Q-LnjI*2T0T0nrwHqBJc=7qP5%@O|tv#B?|{^O)z~KZt$ZE>8=P zk=XF%TIoYsLKU+j8;ms?ENL6QoH2dW`tV?_M`QIWzcb`(ep%j=KIXs-nt3|3|=2f7L0gVEACt#(6Yn@FCjIv)bTKr1qYVydj zah|HJ5;PL`z(McSg6(_L!&HEq)snay^yhlcOEzVcfmCu7ur0%nYB^Ad%h>UsdI|X% zPEy}@f$*y3BggMqoH)40s(G<#>`UsoF*0Jev*>@##K|Dgfu*EZ>R`LG0~O&)uoKY1 z^Bu{{9vP55IoA2p2@5gx^Yu#70{50WAKnIuj?{GTPmfLk?W%$2F(IGYY({4!X>xKn zA4s6~>?xW$mFNf4=R8eHy<-GKr&=57;BEQ@cpE*L^VP1GV)TX)^BEMyli(Em;Y#cQ z5INu!Ps>HNxk)Lh`<&o;m?tIsCW$gI)hg2o^>!`1wMIH|;b<^Mekf4aU}T#cd?XoO zW#~ZnxGUPVhSwuEoIvCeW`pNLFv3RIf*|Qj4gLQ9BH?WyXcO3Z7TlDwEPqcUI&3}G zFpoCGw4T50su_2_=}Nf`!aD; zD~;`nJcf$i-6z^UICFr6#pKYZC0I?4@()F~kr$nXP-9jlr3@BFicqgKH_6 zElGJ+9oOkTy+Bej6hfW8lsCC6tI;MC{RV)q53BI)c$SJhbro@NoI5tcwWW<>#H)oYM8oBb4SRd=s{y4|G4lUPLZ1C znNx?`qKAaVP-AK)N+D`RQEs}P0!zzncv=QzVwEUi%{P+PxkAkGSyiEx(4f9$@+%Nk!qda{>A59GM=tMC6G#)tc)$Hy<^m-qwEdBY6 zpik7fAv9rm-Mbt3n+UObY;-}6kAVvT7PemPZ!AJLDW-Bl4HTj- zF2IPK;y*#`Tm`zv|!MOW5kIh?`5gUMbs0Fo1;loBHf7lUbo z97(CXIs*9;9Dq%UMi@<6CGntk+>{V~R)P?<|IAXw5_>*pw{>q)*fmRF+ILO+2AHWkc;yXFiHPNJg**BOlEuKNV078PV8Cw&FwJfI&^;|Whuzn5J68$y?CA@FDtdD1;B#iJW%F{HU?AGL@ zMwsbTv3hs(=G@QzKNsM=FGm#9MrvmJ%up!?tE34Y#;V#fhz~x@G^klE7#}7}r}#V~ zs+nlYL=8z4AC9PwBe%D3h+7v7(s5-QEJ<^Jx>7H)+su81?G8%qRFc(>aokjHXWvmp zz*kC@fU&3|xky`%;AtpE^|_6c=(PsL|vYQBCu1w84QbXw(CssFf*o5M!JXtC7Q z9@`E>U$lDz;-8XCwuszAY^=~U?P0cL`+r|}38g&ylp+VQGcbo--Jhqa;671iQ6yJ- z-@f(i-9~@z%k;=S;lfJ>nBJHi34hf>WW>mT^YN->=Z->-+!2VyLfhOs5^Ft{ZuWhf>VAiEl@jCMC$F#eqmw=hM6SsqkJ^0 z@)}wAcS0CoC%xyy=0ULJ>Ql(?L~F2!zU`E9tik|PLwrJG zG)1Vt1IzBp@?_^OdeR>AbbVqUOrsTsAL(A~vs&vnl0gw~qq-(22QD_tkw2j0-}!z3 zR4d@huHBhxph#W`dN-*tSqnzwFc(JA88q)?elimcD}jv<*p6EzEP}`iYR@T1d}pDI8R81w?O6<}sIB zg(3itW9FfOu z1(m#t0)sXY`jTH16!0V1;N4sl86&ym<$(%BT`g8E)VI||?Q^52(cQ_u{HDz~+NOI= zJYp|?-j!r^k6jmWeSCa_psq7hnILFvUDdw2cj3Kbj}$b-VE|Re)Vdzsnns}0=jL9r zjO@TTrtIx;VsTzamI&@1YF0&L_6XFy_b4)_8h*RmS+fS?pcE#YwZ{1lFje<#3B(HC ziZa9ojFsBsS*U4==d4M-3YfHbS)6(h8`HvMn|MmYJ-G8Frdp3uRwEDtCcPndhcQJQAXNWzSixnG z@oat3wo5qK!-_+a%%DGM%3>8(v>w9mWu;yvYo`7O0AQ}(Ukp@roOgwud<@ceto+q_ zz6v&di;z96>ono&KZ#BDr&HJDQNVSlv2gZ@id6FBzEX#q-0%rG*#j*p@~j;~Axhz*fuyTu)}(<+9$PjK-E4~`BJlC=J*q6fd(tD|E?!(y3S_adyS-&$MSU+myn6EoG$UGw+WE+lC44uqa@%%AG zcu9ky4aA5GT$BA#53G>*E6mW;x!wB)Te6H~7ABUkZThPNSXiu}6`#QM{K$YegyYI; zBV)#)pdIe8{3D3L0zh5qUJ`DFE3lF6QS*j%NQxI%=T~8gAth~=;_^iiJfqze=#wPV zWaelKz00m4g&rm1_Bi{>+|C<|V{COUw6aE-aM~`vSQnmhUw^fJr{+pz&}V-a)8S{6 zs2~fOf^YczLw8?w#vpS!Be}3}#zU$-11dRcj6uA9$ibO{(%OD$)o9?bA6S+-0Hq{a z(feWb$K=jek9}oX)@pSfbu@0&7j0w82|lNO3|jhxoCoIp{?FM1sUrVDhPf{ztvaNU z+z09pc&8# zz^jl6R(pa_w#zy$#3ICFKx5~rsK6Lf4uw+ry5f_f93&=fgz~%+JE_xPT(cq@$oH*v z)kRq4)-M)37kd%KjfS=O1gX`3TPiod? zKG`Iuk$VE<=Gd!l!!ad|Xx{B2;sX2!c%=bo~{>hp%y55`RTGTTY?qwgnXGius_x_cr?Tm#0k zo8 z-1{P40q5tvMHNd$nb&FLdi8J8cfena>gIxREPDQpyOX8#h+*0yU!%GYynlu3BAr`} zpq>|UsZ0E9-F~<FO zF*eVv#)G}KH+6{ddga0Ex$S0;aG^QtJO6d}8mtuhtJFW8cSlF1`3Z39Fbbl9FZ>^0 zLhi$vI#t;{f3g6U^c?n^6>F9uOwjHop!ofPsGVV z&=qv$H)Mnfl51sxK1797D6yo5Mzz-cbj)*r#3KJ-3Sro<;vlIP{=ERkb>KpH7F~6J zKp^p^!`<$0gSlRrg3tZNz>_bC;gv$Wg0y($z27we4SbLf%1cTVn2Uew&UhBx1k&`O;f zQ)CudPA-u!=u#k0jXI(_Z_`G^$AWx5uJ81-BN&Wcdi;KBLn8K*m;1uWjfUYnp?$xJ zU2IP`>{y=}X}Q{}4`2s`v9VyI(j?wuV& zKo=jijPgB*8D*BUFBv*!etT5)Mp|Z1aAx-)mA;c=73NQ3#E~jkMw+m}t?X_u>j(S= zI8x{eW@`G9hH6FwK`rFzZQ+^&qImHbja|=o5=iJc^Wh+bnz&rI^?zpVa0@Pd>B1JI z_%yLEf;pQt=2A&Dxz-LfE98p`F95)~C$bhTZP!~pJ>L$iR;a)L=eYasV!p2KQ6oED zrkE0(x}DQYCIrY@@-8;59DB@tMpJu+*EA;eR;-4+3h0SYdpNoUu1M4_>X>T@0Z;r z`Kw8!KqtCAXwr256iw~DWvzZ-U<(0dASr8J-v>cs5 zJZRMBZ+I@`TU&F>w~n1g=r73N@5y8=F=m`#JeF}N;TW>;YCup*L1;qa?RD7{KeW)) zFM=WVj}FZ}ey*JJB>FsQoo6W}bNhYn3mi`I=ogo4F`6xPHUc6K?%@6_Z&726;nH&tVz7MqqW?Xa``CZKPIY_-Tkw_vq+Sx6HMi3vv1zIGE@P!bDOY z-u*r_yyrWUlH%fbephcQ;$=l*8{RNXKx^Dr}&p`^%OCr6-gR2q7_M2MypbJL@A+{8$FYX4ZVG?+Ssk&5< z$8vN)8JY?uy-q38KK@))Q~?UnlITs0{J@onn;y1i_(tdw*pkmFoKmIP#jaj^l)V4Q ze=+va&V3HBtywUNYNO{$P$X_6;!04mRefU^pbsNq=er*CS6me&!wH~M6qWa@F=Wia zvzAfDYbL8ei2yQUjtBE2b4MGKi^)upLd!X$)bB}SNenJ&jybsoCjY)Pj(8#-+fWiC znVv{J6VO?JBFHOkrbISGYV+oW_|}LsZUoQu)wxaEsX%7=B5k~c0jTa>*Ou>n&#M%S zEX;~M&`6bZs;zFnR7Omf)bxAR0YMY#4wvnaf zvbYa#0!xk&B>&mwc8SeOD5jBGDRXAkMaR=g)2?U4+}uwy_&t$nTzNtz)(knyA>LxqIm zAcwz2)9~OU0@YTCJb4V3lb#Y5b6%2q{W{G zE#H4Tn_*r}&My#R5=3THVw|)>jW`~1%nC|$vTy>FIDb@a1|$BN7*+Wg*_m)wqd%6I zm2a2le#F@h;i(^OEKXa*hbxvlx&`pgp^+sGdrm>kze)nTi%$+0<(AA>lv|6uo`6P& z!RLqBMG<+&8QqRs|BiflgN8*JqDTM^;rXqndXV#?E54G;hIyG_KO-{s9+iA&;vTQp zaFTH?MiAMVH1sgAI;3Y}TIC}x<9*Fy;q0(=@m0|_ zq!Ix85V(BNV#N=8v`Cd)igi1&8Ik=)6T+U7v>J{2EeLm;p`swq{-gHCu??rL_6^E8 z!tOq~aEGGCBrLJOJs&(FIBE%p&0qhkKDpnzm&n8mZ|sKx%8;}7D=_8AZYR53zYhnU z_PG7kSR2=4?hpTxC|RVT`XdKHXPc!h^+A=q@TbGY`B7ZPJo)M*bTj)t*aaGc50PF5 zRjCC+Z353nx0a1z!w>Niv`mt4X%}g%n}Yeme9Sb5SJ$_I6sXNJ4-%${Fxv{9tURl1 z%Z-$+KT=u6*(SBHUNkqCzUof2%ooB42OOQopKPb{MWEfc6f`#)Mk%hxMt2IgzUHo4cWk+ukS5o`j2-ejB%kRF0v1_xH)Fi!-@wCp^aC*q7l67$;ZF%tdn+df5maEk;a*DsCGt z#L7!r_Z4ng;|%lA9pZ7%#OvabnxtgjiJc+2U!Qhu2DSAhQhW`V2OoI_?~IUU2vS33 zx8f-GzdR$wX#gsXfq2M=Fjq2;MxyxURk3364}euy6r`Y*)r=1<<|5Np6T zp=@D~8%tq>$f!7B#mCGYT8a;g`!$=I87~2%#SKPv5B3Lw2=c;YjB1Oyd+Y0K^kT_< zbn-;A4S<}4ydfZglfvPN3`zGV2eI`Lh-Usd5Xj?BL!+=iSOXQq_3p=3J=A`eNP9Nj zO=TIF-wzhh`8)r*Cx=upDx3pDIPPOIJ7HuAvc51J3I;;HCDj5feFhsyXui4J?H~yl23brNV1r7*Qub7k54OO?l8>y1g9KP{2vcb!1zqS^ zB{`x^QQa2$@W+3PX%n}$u+1HVuVo+9-x4ai10lU54{jb|tLMd)6Jpd5Wg|>6tfx_L zJ6J{_Uof(!;^mySgClWoh*5oB^De}gOeoS)g4a(W96s9P+zZ$d#{;3~w`KAREn%C2 zi?GJ|s-MHFTKuZA2GKa-iQqrXF;EbYEJMjPJ-gW;go6*0#ZiNMNu*5?o;5 zYC)+CJAEP)zl3J*5y1$Kd{SlD-%D4FV$Lt+2JiMlQTa49~a~%`R#y1CBd4pYZ77+39QaeBw$c! z)JxWdzA6RL@-)xkgh3IQd&uKum5;lRpkFd?L#ItH#lbmiXpZNiaF%ZC@3mNpLM&4n zL>h5!&YzgDJRCb;O8(RY5ne(9@ChSoj;;ml@_H-YB(g z#2y(qpWiG^3e0Ne#lByz+gq61aa}9dXa>|9%HzV@uE^-@SUIJNVtw64?B8JmUzxjHd7Sy<53Yz?`w- z<}*jo&%ZyCE1<E{id?buLx#gsN32HRkN8KYKEdt3`Wjg zstO2x#A-l2(LKR)otRel(r@RF@A`&dhLlSAipGD3OS>J`EQi)zD3LkQ;mTqETq5}iMa9Cz1EksjAyq2T%862+#XM(>!x zBB|D6VyB!DvzNSD?>9#lsZnhQ9vF;(Q;SVXW74tOftVOYOou-=P9I|{eg=3Zb=Zjo zqL?Ni+w9v@;P9#@2$1^ATw^B;Ec4zZNQyKAiZclJuig5A850NSE7r<&e!U>w|EkHf z0n4}Jyh-@hK|iv1#vW`RBiqgVJwRva^d&PrPP5jwlg(EjOXY7!(s~wR!DT0i7pd6H z{*$|iv#sS>9j|Z%xGOqHi80+o0yPlOyl2&*7t7LhPt2Td@nrZQnv>%hE+b> z;nAEot@#O$!zvne%xNBYDlx-79+KaS@jS4Ffy+DsJ8AVymh$u&K2<j9>o;HiCwwtk(;<(!}9|R0qf4ryYKTYy+z2AvM>25-fdOn?#)UIyEMdkXCfx=hV z=`Ur|`JQY2;GKo5oyHe!UA9rl`K_2mREpsI>&Df5|5Lg0z&$c=^#?iiRkprX0r&kU zBT1IIV=_T*#CI#$&yoN(Sh=ghjnROIK(r63u!?6?bHh zfvuw=XSJfz+N{0-QV(U(QOrq2Rz9`Wx8#muOF4yJ9wMF?vVe>eaF{Ug6Dv2y)FFM& z`ba-Rh`PXVO%20JohJZwlj+dqCQH%dbQCzonBxU%HI( znyWyGZNN;78r>%);znhUA-rBY%HS3wE;=*%?u(VHrRf-uJ9P2eYfb!ZJ@AigzQt^3 zfl)DPR3B*4HHVL(u0fB=t#XWEGn6sw35i$%H_+O$47_NtiKl0!UXZXT>(M;pH)z>> zu5Xof9ZO3Pc^ z(6C;sO!@23=Sr8xLeI`qJ&K{aOye3GvCYeG&ux5c6eNeFnpUJ=w@Dp)tRAkNipb!o zs=j08bGT@c0Rma$lE?}<{xD&2kb&K)+!>vp(;KTkf(cQNPM)n^b$KmZ9@p%-+q)CJ z7~s7WRCn;kyl+VqmmWW6&11}_csunDOP*qFdjxB+BSl*XaXYcr_3DSdro|wxX1#JH zXRU~-@;<>*02~#j@S?mf{bknnOZ?2LaBop(d;PN)SA}xaSX8GiA89iOHe)9>(Cs8y z3PYdmtCW7H?qBne_;sXHc2gX#1SWLUJI9-Yk2$M7VnA zu{U<*Tm8n-U4uuW+asmcLx3o) z3IYTZ$U#J~fJ!2FZGD4x)lY1UZvg|0w^0D!i~%{Gm)`05;m5k!+1tslAMfuvltX>G zVOi=HmdE51|9iO`^j&=y@<6P1C@Oh-B6HOKuWR6ewWy_A5LFxF%wpVE)hWE82H!DK{S`d4<@y(Nv?pyyb~{ z@ma_RicR}Pz^<4HPJ&Y01^Kg|MvzM}6LUJNLq7XuJ>fFKF(q*<)I4j?65;=UF2Jq# z1$vGki6+$CnxP9jS{AH?Fyr7WKD!Zj9B#c^*H&_52oAXzCwR92oQFwy!JtxG=7X6; z%&{(`ueXacHmq z<11yWCO0JNCp&drTy&VMXai4{j$}Ufh{&8YV35S};z~p;D}TOfgH_r?lQ00g44J`X z{DsU-3Li@$0{Imed76xQkdYOVO+a2Oxf*`p4MW0S^lMCBSiRxZ2bv+W50V~6&sv;d zz4B5J(7e_KN?>Ov=2wiu_9(hJ^!^Wg5^cfS$RBS56hC`nJA5PA99Z}3;TeKTR!B>r zD=AWe0ZmCvYz%*vWMCund7)QoE!=@vg35e;t?xX*(nc6)c)%GYP+u8O%__e?vYmxV zQqW|((&|@`q+XN!QKew+Sy!*8zsJnf3_drdqhi{cXx*_fl)#m>QxF5^IUv(DVsH{r+0~=nYj^ZD6zfykTFw>KfNh;;{9}N#}4o6vs@bX+{ zzb3Q54C86NQCjAUoEYgS$vbys#mt?NZ=bCheRg${A|W+^mpcW1eP26VNs0e<9{-I2 z_RQX%I9|B(=}Ij?_S$VS;j%W=%ly&L^Ac|g`4#gH9I*y&@_Ee%Ea@gmqF6m@?e+*SPX@=L+rq3>^YiT~*~wRZVU zSC0%xo&4V>?t&;GTKaGQJYys-DQe1Tvx4_g;uZig*()-1%k(mm9_MGVriWSfzD>ed z)!lYdtn_|j*2q1mwwMNBmB#UGd^kvs2VA|X7M~ifD>eR*XE^WESuJOU@yh%kH1+nS z#nplsF9y~?#o1(miYZeVI^{1;e-`nLbPF9kTRYDASeb{LwL7A0Gn|K+YpJh=r_OPK zCstrK`jp>N)WV$Rm}ug5XnD=;N-69J6x{!cjo0U|J%fOzzDR?+Y8vbndFEJpZFGZ! zSpY=wQ4w!m&o9Atwzmmqh~k1H^IZK>1N|YRR$SKgszC&@72bn;hj2JmY3pZ%s zS#}(%q*Kj4ELEqg9e098&ZeTujGQ!)n_iVUimI#(bOu1gUe$aB=ekejfZa30Mu#t{&d z@1le$2a1^@$$*N7*^Ykx%yk3+WtkvFJb?oS2y8aO%C9&Im)K!Y-|@C_CR)N&b$(It z0$`w@K-)u&Ngb2hltP(;*&rF4)O>0CLsK2zT4xSx^L6s|f6$naH%*k`lyF0-J*@oy zJ-cXK;7Q)QKeX1-XDzM+It_Z*#o67xXB9a_dSnqIGwFddofP#*4~ueo;RiCTOpW37 z&vU#%8F7mqGs$#dSvUdDs@ku94)@y@J0;tnpGP8T>Q~yTY<~$}BiAYVZ{C0NFX0jb z52O|rDk}Rq_@NY7=$2Hjh~zGpub&+(@bK z7{kTFNm|b2f#5y!wXT*C6}ii|HXvaju`hjvPtz>L0?1Tn?>9_k&HMxVB`XzzsBZ)r}-u^P}Umki$MZy_s8^jdWPS~rxN(>7&!DGlo4;@Lp zOQmNtb}d2Sl8jHl9%5^l3rbcUmK00*9L=~H^ltB%Vs%=T-S zRgnOlz{M0uzC$U|K+u8TPY#KFUA~1X{50il>f1nK3fD)N%1FZGk9Ecs<8Vd$DQ>8y zgj(BM@$6x^A6bwou6+qpl zaE;bs?x6!t;)UcC9g(k4^5Qm_gfeRGct)|lW1n?UkTOgSwJ=He8WK;g~tIRK&nu^3N5?v6lw|?@LCSS0Neo(`@m^` zV{r&zuy5P4@#vmkUo+nO2!s|z_r+1OD-{HW+-H0)h{dixv<58(2tq&--n09w@bBc} zSCfe4be4n>go_zXflELH@-XU#Qki*Clk24VaPQR{l1qRwup)<=2FlxVRh}MEMk|$2*Sp4>Ddjh{2=`ehf2Ke!wx?i{s7wb3Oy6xby0)yQ+SG z+JOc~F=M@F^mY`@7YP`&{%q}jedd|(9GgyY=dID3ta$(yS!zB%5vz z-C&ejM558U(|VB!0gmJOVEP+iJqSO)9$$31ZbdODBH~AXs)hG8mBK?R9T6qD&fhA2 zMQ>1eFMT*!$r=Yw1szj8;#^Wsz{c#v^hF6LlM3oSwZ}CE`3pu^jyV@ND858=!OD!&M?rQaTXlV`+nATT2|?=JEJ6R=x_BekCAeGZ^QFI z&kIWiD8t(>h1o=^565yw7NtaeR48Pl!*%ms|3aUFwulP|&8$G=0`NEgm~|QhW@E7= zx&@>71u3(Cg*#Yha55MQ03EaCKz!y=c*$+b4H&^UqdJz-uE5+a&y!4yIzgUyWk2K?FVJ zD>c<6Asn^iokxKeQ`gt~M>~~2BF67>$T=e&t}`t^ty;7L&Hj!Mt>^lK-{`F~q38-Y zy4ohj%GlS4Xech_pnGeA5W3`*R*lE*28FD~S`5x65kVt?tfnj`s0txdE&HMaS%q03 z`Nr!l^W5(-hFIC;@KnDv2xa*ZUC9*!suN(q5JMv|1#G++NYE@;FtY3{dmq;$M%!(3dH@}PX}s&>;iAMo0P1t$rQ9ev?69iq zT~tVl^y3&!Ro*1=WX*tlpr`7%wlca6*kow+xBPA@S z(rnd|S$sU^xP1P4fBI{N(REj5oz ztADn9*2EEV3d8R06iz;#fht5hKabVij{23Goq{@#Ks3NI%8^p)dw*T zOn2#GL&rtgx_*$z2S!?$qz0BeRfuOD`7*mw`(^eq8)rxL>dZ`RIaFMw;Gl34Wz$2W z7lk6nmN=&s+*+v8vmaTFz!SiIq9kRQA8^2j>ntt)r8oij5aXjpjGDzsh{GL!B|>0F z);P=aW4x&3C;BUN{h5w502+ic2K4vpo!O+Egsgkq_h{GmWu~-yTLUs4<+M#Nbf9+o zrX!7!5TJ~g96Nqf)`rdge^d+5*$v==O;J0QO~w%VAc$NbirIeeq^8pBh_Hc)Y#~Wp z!N$4~>|*JF4M=~Q&VJTHFD?#9M1XwrWGBJApW4yX4~oN>OO~>Mk@?l5=TxP{nN3SQH7^V#ApYC5GMV zT^AU5$qS_p1mY*~*tJ3zWT7*~&oI4}mU|WTpxmXo4H_v7En&7s>c@UHRE<^ase0F% zFKAhMbkW1ex1exlHF%7E9y|3=x#dZF+X(WB7IQEeen!fm1u)kOLFO<6i4GLlL*MGZ zF}wk~3lgywBkX*`<~pAA4RGu|Z=P!3;-5~CmVXCGN(Z2ZOvKi=UFC7eu*$c=PhGW~ zdXhA(UjiD2xuV?h2bbP|AZ087(B?YegmcO9ao2?af((OHp_eozN)p3`9fHL3Wia4I zHO(A;gl&Nf{F{l8N=Hr;;%d>che{AhD_Q<^XWV+E!epYRt;EK<1citIljWUgYVMcl zy^N#mvz)&S=rGFS_&AzVuc73o?=>HuzI~kX=BM72o6*LxT|wgt-2=Ms-)QZ?+Uh&{ z#MOX2Y!q@oN-pEukx5|hf|QZaZ_eB?n1Bwo6%>HG4#s=L9$PZASputM{mtfYFWN$D zL&`pK_ZUdc%Jr#Aq~9eXNT2z&fFNCNM!Mxf#EW zWgyG3?;f>cZO&To{zvS&%&C4IqWv-DDA)~o9v}jR8h3M+WodM`yMSMViJ?XZo@<)F zl%gUer)k^wiu3$_l}$5)<;A|u8^4UuXi5>m|0^o?JH+tFN_E4FCL_=p%%Js`P`P`l zRpBY$_CP;o{$=AW=mTACL#yO(5pg^(rL2_pSjLTu)aFoix&-H&quB8Fe! zvqIYE1*HmAwX*kQ!#~pQ^uKG&*WCDB8IyX zRE}*6Y#il0-dgSTxqDbl=^*yyJPhHoztZ|#QjLFtpKVkX&02d*cU?|nA-#*|^u6BM z33%Ch&G0{o-aFg89~zqH?`708LumeQEe2eiXE;_EBD)2=0(Xh`hyVeS0R|=^0%eZ^ zdw6bc;k9#zfSsi?lglvu=8yX2fQQvr4D~ZLLN~9_@lXH#O~6z4hu^zO@Y8F+FR2v1 zT)o5di%zeiD+?ch;(Tr3W?I#nh(|G5J;jB0Em84Fg3^VYy07DX>(t3S}bxt$vl}iDynVc zzGzVOQpy3C842XOyzZgkqN`hGb9J+XGAv(mpFWY^)jqUpQ$3(5`@ok@$_%e2+}D$y zU3~109?Q_uKGY9Qw}}Ylo}H28a%=U^am@d-Q+V09;0(A7n7TvDa}5ZdEa+dn8|v4u z|E+B+vUYMt(kR@{)P+*zzk78nI?k1Dng4Ot;d8$9{&!uv>n#7seW{962skJJWYW7Y zVqbMLMT7zmxs!^L&b5^hN2`gdC!i=i!Suzxcm`XiXWn0zy3`Or?ODxjJ> zX=C%G^7B3;`J|=l;pd{FPSq29L^3U~gk=%L3l)WJHAyQZnCIiWVx6BGu#)3fnDvo+ z_vSMhXQ~K->P*Xo(^pZe?XDlzU42RYgT*B$_%u?*N1QAP4jKr5kBH z+jL}tGNa^@p@vM*3;#Kk%2@QQ zI_S(XH_#LgVak}sH*KroJ)+$7Vd`4oaAO_$_F*83(PL)aT#&`;@%drl zB1oilcwn4IH_Z9}+Y_97J(BJIGTw%KLBhF{ck+Fy{mdnfif+4{K2 ze_b`kZVL9c{5*+0HzVEk6(=o|&1|6x)}4lR%E7682RTATAy60#P5Fm9Kw$}8C@5r; z*Oc{N)H`Z)Yhd$fDU=eBK?be`qFTxN&$Z^SEz}qm*AZ(u!DPFB78)&kfF#=9z}p$% z+{D=zQaiqBNzP+hB%p4%v`2-P3EE^D%D4fBm|c4$>nq?i)?f7#1%rg=|K!27HvBoA zOF1tTv}ly5D$7*HjM!d$W|A~=H;VAg?X3v}u_Ko7kj8Alwev+gypKpg3l#0wpF zmNLO5#0xgSmHTaMIBG-I=IYtpiOj-5a%(Dhhb(9kM#fvh_T|5c-TP?%+n^WsPl~?L z%270piymYDx12DYV~!Q;p_gq9kp=3DuB$s4uYw$uIG?b}kwEoy&UJywD7FH&9^FJyAvbj+lz`fgSr~*Jn*ypCgLec@#Y()(UXSk z@x}NLaf_w&>9D>TdFcoh#7KafgOnj2(L#+rsW3Cn zgMnp8#6Sf9KXyk#^2Vt`tQH!Z(#ho8ECq=376(^7as=f~lEJ`x-}n@eHyEfDjDj_2 zd~ATeP@5Kt%VKgA!pcCDs$f1*xxLBRbR@n4252d$XJ{hzPV|;oXm-dVIp}R#Y_S?bX#V^~Z%d~Kn@7-y{TT})D!^>F7|JNxb*$Dye?C62={dVR3bM9#`FypllUvs#ifQK}YK14)N z0J2H9HD2LE2IBa_*y!`E)`yuN`X5laM@suRYGk0N9CWzZaG~?&@Q8Yu)6w8C@D=Dts*G9&Bz?6IM70stre*RI!d!8b z>zHkMsH34 zOIKMyylI=ja^Kt>}ZXmZL^Z78xRp0 z7~k)Cy^H%Y zX~#y<1jhwb4JU7zL^+OB)-_M9OwTZV3CQV*e!%#_g@!4!f3-g(V8WMzKt08uHF8(z z$OPN~NoETsI*W2MKpVKI>2@EluI1PF8H_BVwUr!sKF|V7Zz@1Y*zD`}`LRZA7{QC5 zvsd{nRAOl@TN4t|m)%A%t@VFi0GdF2`IJ7Uf8#AKcS$Sg79ElFUhj(p2TX;mAA}<@ zZWf13SRUq)*Tv_a*yeae>m!;Pk(C-|e4n;TDY<+S59}S}~L8?u%O%NV3awc8{R;uC~28B^0m9GWMsPrQvTk zUkt_EpmnA96@pmZ=1#m+2v!&oz)1$upU^|FwsA^FVI<+q5qns~E+m-Uotu8v*XG_= z{I~_q7xP8;OXqWIV_oq&j$GW|=_!wq%H+vfAN9iOX!ymXNnROdWFi5H-K+~C62KD! zJ8tVe&F85Y3<(%7sY8?rj13{XO`vIV`@qPJ}qmV|`(~Wj}jZ0rPUO ziB%ob%dvKsfyesYPrq2F1xX<28~8gbuUDGGoO1Y$^y8#^cOz)9f;B&+NmTDkKi(~{ z^FdoBYG^j?74>()4)^EeuO?)I^N$O}Cue1lgmMT%miU@%f(OajXI8MO+73(|y|aON zpZZ8r5E&(8@Py+7%qEcGSR{_EU!Lr2l>yhE52$L?$<6gNL(k6pHNWEhz zDFfg>!c5BQv|s&hS1Z~QP0wUQZ(;XUR?cveu6C=t$u{>FY zJTsRJZ3U7l?yl{8GNZ{iW*YIgu8bFH^?x=uCUCX&7!$4O41nqtiz072Q_iP^Nm%J3 zUI2v+vkyZybcH9&e!4jWRcWfFU4RG$ z)?)V?&jl*+oG3sX7#Eer+3=-3GhZo=x};wTYJPtc5ebR29Fj2BsDTlXP7OD<}o-S@B(FH^z*bNG+QRAGRQ(z8tm!!40wzxz7+zA-2em1eE_Q?}Z zF{v+KPYdjo_B^=Y7JlbZGyS3#XpZEdGXgu7@tyug&W3UKldD|o+uGc7_dA!T_-Ha? z|Ez+4d6zHX!`yoDk5Lha(hhimawKY3aV}Yb0-m9u-9n6lD>XqVkt{ z+QAU*^ADMubwMu67(qXpR_U4h@bZHnw~_)Kk(_Ln#pzf|Tf`&v3R{kwFxBcT7Q0Tw zt0KsqD4u`o0tj&4b=eJnOoaH9Ke^GtXlrk0zUI5TO(Xtt>5vu%VE_Mh4|5jC&Ad2A z27F={Qnlo~wUbYmLj+l?WlCp<)ECe1q6HY4e}!bH7zf-%04|BtK5tzwA4fo1hSeqP z2C6BTRK|#G(2JH(7tSL#kff5@W5WG`gbwAaT>K!yFB>jy1OOWd;Es=pp*?|mik8?G zZs2yrScwBD84G`Ud%_5y0$jdJO@HRxW<3@b6&V2xBnvpMZca!>vG$=I2w_)@GqI|@ z4xlA+ECa`$+8|L1N_FQ;*#qWB-zHOmDOhKhK-p@JZ-p@$Eh27OP_-U** z&+;6sj0fF7oOuNFTDiY%Z{y;fZ;7sRkHet$*EuFN!QvBYx)>Qbo|E`Y>@#F((6{6|nPh5SI9fnoG>S5-esI|TR`lti`{8Zrp=-LQ>AYg-t`gC)i7BMVHT!BIi^q zFKn;3S86Q%sTfE_DC1yT48cH+`wlhwLaPjN8%?uJ{%_KpHeO=85~Ebzu^y{JG z&}R~DK@c!u zvgj=*XjeUkHVjQ9+`0Zr2=PD|z=;kk6U67swaj2K<^_v|YCu+_0khj2UNQmk){|6- z9IJ{W^`o7PHGa?we<0ycM^!01<>&XlA=8zHGz^v^iW2cU6kg;O6lX;U0|4H?Fto~! z^dArjiPABK@D?fTTWce0*M$DrU55Tk+wYADpvTDPj5;fdtf)MD3TU8mo{+bLl?IC0 zHtt!rV_=kA)D%~y*%W8fUoQ~x;=J7U_VJ)l5z3^-RAe_c_;g!Z`2zq)TT*kl4W~f6 zK%8_v&)1EUb|YFlgWO1MG1Wcge@s-{$@y zeaMU0kYaU>{*M&62rM%#HO{>J+di%RIBAYS^$wz_cKUayRyZFMye~EYRt_60yHB+U zhIr@;eyRz(f3sVIv+IIkuE_dY&NUjSZ&E4_GRCDOHuW}X2gUxQ>5a|aIcsC{NX+NY zC|jDl_$ztp3|%1v4Q8;e2LQU* z>D@RoCa#N}>O}hkr8Lz3iaTc!en`*p(U+Vq@a$|{K_JEv=B$WdUqJ398Lf4gUWL~C z^PP*Qkrew*R%m&ax1U;4pIgXp1vIWvO)BJ%S66GgKT zly!4z@P|i$)L(PxRH+S$s-8n#8 z#K~P-M1(#cgYWKQZf+ca#}N?t4D^!-@x5DHS(%%`>-EvA zC*Oy%cEOD0AJa<2C*Jj_arsW z7kc{gvbM2wkg&GwZ`bO>+WvJxpl!q6={DVw=MU-RX5RVci}n4z`2D#|eRG1h%*U6T zS>QL%KkeO(>wd|G0nI{;*at!hyD|t6MJ%wKkidMan4YwRFW-R3aa5cD4-*QQl;($0wipnECoAZsBFYb0yZi{O{kDnTd#$4E1@1 zr*NA{{BPSouDUyF?_C_8SnquXK0b!l8vj$Lr8mcqj^Ep#R{wQ5pESJ$?EVRO>+ZbL z*6ysT=1rm%xKvmV3V19fb$Dp{H~p{g(_LJnUBFAghln=u3V<0ue*mT|zqJ8{JkIIk zuKTGxU`~9Vqu!Pd$Qc@U%zD-3l9vB0SH-tD51wj)dm6pZW6PM@`DI{J__}<(a|Gzo z!<~+KHbi+yMMt?)cgik3p*H1gM3p<0X_e|qd z04m}lfA7NwNg#Z!IO}F};+qpt(Bc2=?*FXOH#@3p?vZU*U+d-W%FXlD*H<{eSD4kn z^4s~IySI(Y(U2(c=9Vg32J8-$+MltqOpvw@MXbMltoVG!AFVs-x>)qo^!%!+GJSjM zY^lw$u9Bp{Oy?#Sm5MJ1AxEE1Mh(;80W}b9Iup-C7Kl9}A3Pw2-s4&zsv3+QU!fyv zwh9>mVLl3Sh_Z`-L5S8nPd<R9A#k-hQo5XteaJ;3c?^T9|vU~!7Y zuBOH3y!Bt6&sOEJ_r?3x$9KkF?kLnR^k~JYkgZY-gXFHBI%U`q+JuXrH|FRBj7C+~ z%pZmj0B9opnWEW#TE}<|uGDO!kt4N;?x;%Doom8^cY@#s&@;0mA+lsl3f}Z^Tqj^k zOTT%GfAQS{eb}B9zfZRW`dt|B+LjwIrrSxOXFa#t2G|wMaga2JkF!`flYTT^pMOp+ z#~rRTt~T_|@8$HeJtyNpoj}YI3z*y5vWBNj8=Bm1Y&QXIpItF*(@iQzN6+mcvg5$FGg}fDwvfhl|jKMT?enKKmK%tP7%6 zb!2sL-TK;emd7vtOJ_i9!)+ip21*Bkf&uw*HVfz&I}EZ<*ELg!XD5BB4WkLKxEtBLVr z5QRb@zd0*%YeSKX2hu|$g@lhLL`=GPNO=nl;eh(Z5AsS`3OQQMI=^onCm61K7X{q= zb}};^_?)F!{f>|RTDlC8jnPy`@|FLK80au|oLW%I$livz_1La+YWL}&^3_}feZ#A@ z_F3cUxOvSgv>SU2fcma8ng*tdu8EugHT9i27lj-2DPmZ%j7ygKfrCI<0P% zXX`u9yTR5spFU>l;4NwnWEin&!&tj-uVCY(UhZymS^nN11lhPDnk*ENal?KpDH+;6{p>ljFxMBZLu1#}n4; z5j2(7D0?QZ<~a(Ano?m8O`h4?ENrYzr3*?9ow-8umShq$ro{^U_Q1;?b#j6nMxh-P zw_N#rEB|CKoI_vzePg+Fo`5OW-*edG${Cj{XmBPP;_+`UI|v;YnxcNz=ok(8dj<;s zt{BIei=&F9G&+h->@Jkb4!(0%+N*_Ks*pa3C+Yf>F+T7w{@u0Ca$-=|D?Cty6kGa-6vqLVoV;lPrlhn<#4Q=|7i>glNSG_K1s{ca8mqG8i>D4;_T$P9?^EVG_34$F# zj^yWqN733=R6JxVgeav_TmMTbP6bTMKu!*d`xmVyJV*UA8j*%tAAfIMv2xp7i0aTW z9dlIE!W8EjXS2eg&r|$}5jFiA(;#gOBd6#gb}$oPST{UOB3?{u0m^I&I(t?vB_+jS zwaawvDbbu5LCv3Bk#~Qmvpt~9B-~#ZDeTO@8(xOSVodVO9y|EDc&%&;CSw%G)+`$$ zz$?JD35miD-yM!=sA!_aslVpP#dKyxP7fPywHICeuOg-{jdq2~(3?T6znM+Z{052S z$=w`R64<-w{nq|;$Mze*&JM?D?I^Y(2rY+ zzDP>SH~$^{@e?=ai5dz7%kM5Ta&CtRtPITWP<>EOQiRo~RvCK45x@7w(zL8n8MSGO zzHl2SGLcDd$1oFf*+3#OO*u&NuZFr-naNA_ew$}9e)7ZjC}^6RU6|g6ZR02;j@EbW_agjSon9(H^O;S zCVATq^FGK%0te{;R21PLJN?GQ(nzNozdi|a(JCSM29HQ&q>mF&5#K~Dsl+F9f|amn zl4=>@)Q9|>kIFc>VtYApi z9D@M43t|%BrFjg9lbdjQq@mG3_cCQXC(joWgfG29MhRle(Z#Y1Lz`LZO1z1=NXhi2 zV$e&ADYAhr|BYY%-aJ2*AFTVm77A@^%`yGDB^k`)b~eWqz$J$jqh(_Ma9>#LfU`JK zmB)Qhz=j|3h}R=yjUoVdIIw0NDWo8*bYPMjDsg(0h&a89i9O^WT=DG@a?qAYeF$2t zOnyc)NbB0u47PevT4Z+PCVcZ5G2-B2rr%r8>6t@W#^QSfy|djn_h=J_w6XC;c$}^V zmzU4-bi3^TIfUO2>Yp$pV*^pFxZ?~l$^NbmYkdlt3LFfaA{!WD=`E@aE*WcBq*5*6 zIRv`_%u9^0^D1`$l|t|UKl^O4PV4(?Rzv_iyna0bs>LJu!BH*q=}pvK;!4RhBkoX< z+V;+e<@C@29M-#ayvJ(cQ|*3@$1n>{Yran4`V;@;TG?$7#p0BaKXPwm)1<(7mj+xT zPu}gbtd1Ef>0{K8EGe(QDu>dQRmbj)Fer-fsmGJDV3UBic5AWSATt)37Za+kN$niP zpb5_`W+1pWFa`zNgDRA|Y2twRsW{(IjTh4ZAC^um8Uv%zk3D$OoavV{WUDRih~>NC&L@=aV&q9P*z;+e7LT(fE8!0-WB;Rl zzSl1kaWprl8Qqsp(?)Z_`l>Yf(+_Jb*9gfms%bl%6~9)AL;7T$g7DiEC72BYlWXuF z`W?knddvic5|!EorVg%wOK5}GDM98(|6UAOmOWZwjU>Uo1}Lv0A)>UV*&Df)PBHVS zP>YO(%8-9L)pD{h&yY+(q|9u3-nBJt$gR!@@uWR6-re{7SJ3H|ekf)IQ!p|S%xc1k z8QV8-07skB^z2o{AZ)>@9`W^^xX-4GEeKIpH)~DmJnrYjb6UW z=O?%POAWbDC0^}Cv5*;X#?x1>%w&97826Vli?~m15>RSUvpdz^VsH?4eha4Cs7B9{ zAnB2$OC)C3y1#xQ88uZ56r+0hx|L(N6x+h4IHZj8S#N{Vrm$o_L)5|@GsTX9|9#wR zW&~%$bS3_7O+=s7uzgO)@phW~IX?79N@+D`I$zo-zl>1=KYxQYa~q4KB_)5679vA4 zq5jDitM=CctXUqO9~_?Eac9?9`f-)RW3cjKY>am}uq-x&aqp{X&trP-8$wX$-kY}e zN9fe(1f1t$m0f+emKg4$YHs6$6nxe+Zf49|?1nhb!z_EL{>|*~e=|PWJgU zNHBFUYnjwS-53Y`B>FSVp0f2;8GzNcIIHlZzifeCb~8y%;SOsqWq7%yW08J&E>gBE zwu4Z)t~5jK+k9GyC+Fd>Y}Rz@ZOK+2&EKOAQqlW;Ex*XaTeJ0;am`shGRv9&!7=QN zF#Ut$M-&kB93YQy)b;PSnR!P zDj+~~SJ%PP1Vi0lpC(&m@aD25(#o0756lop5Jt{^VqLdxqurZt%(}z`6rPA9aL=# z8I>fLU{vh^PPFRTFgDz+TI@I;(m#WC^7%$pI_?cRF*4z^inTDfUw5EGE|V>o{4h(U zGopDS*)|6Rp)KQ$?tM3edd+9i9`{?e?A zOzP5faH&{Mw>94Q@rsA2@v-3ENLC46oROH^pR()>>@}J~Lvaz4YQl_b^&=o8Gc~{; z;9ePiNRB9;H9hv(-?DVRYvASt^H2t22xLOcO7y0;2vn3&XqZP6!R!BcCz*<{QNCdNJ=|TvZ++Z1 zW9o*3brE84bSip?v`id1vs46Mj;7yFs_7bJ5W%VY+MEQl`tGU8_$+3_Eg{h*-&cVH zMdt{J>UI$`iq$+rVaO;p*~dHQ;BfNb`o~Zt_B^pg_!n4Q6kt2?cSM!J^TM|Bke6$| zf}PDZ>j! zUz6?U$9f_W`9QYGo9WJ0+aoJl;5fNHvw@5wG-NH4yg6D7E9@?+5|kR`LdA5Zdag0d z77K|ivT-u>{Q;ti%kX*|wd9eNZ)>5TbNx;()l;?8S%nDGF>BR9_Ej>PQF(~(<>$UQ zgV}to!a=amtZ?D7NJvEmR0*tFH>TB`;NBn64U zO7xR|!Wty8yG2HSwRChdSUXvkn!@jG?{GPO+Uxj7+%Gd!ZjPCjpQW)#Ow^*KSU?gr z;h=88RL#yqIC^VaDh&$U6Iy#Vfv-G0kZV4CC zS$mH9afrYNiiMIHLb3(R+XhQY828F$lIxV9IOf(CjvmfQrjyrCU;ByjX-iQxFJ-|(jJ7}-8> zGHI0#o>=`h+C^P<4aKw6T1DOp!(ScjfDtr zuLnU307||nNFWmtSiyg0igCt2|DP8?%QOBRgQy6)l1GmvB-SF$+2Rze2lnyBlP32a z1?Lm+M@Nr$ZhaQZ8pSyYwp`B%IRn#iBoBAK5kuO18bUL!EE028nDyvwLf9Ptruk)v z0(33iMqn^nNvxn0@XbeRoq)j09#6TiX#w9NehilqZda!+7QD`;m5e@K!pC++WrKY* zpE9!2l}=A7G;FTVu_vLN=~axLv9o7CM|AdUeI0#lbGFPzA{0TE25F`Vn?CekPhV<5q(x-;<6GGoeqL@oitW09?iiGe4 zSWz7uI!0B&C&TH9Lccb|%|0x#8)P<@C(goo|g)ZBM?xn@a6H9>z|)Q z@?g%4wweZlNF36Gg;oUo!(_i=zS}|h7MiCu=!tbBG-+UF&CcY`3J`A2u`8;r#jlDB z>9^2YIdo|tCk$xeIisFHX30{=Oz9Ae3&F;uLDZ3z0Xwv8d|*}+i^ECB9c@y_fg#4P zUBT!ZmF!%2bJw(unTCXoDGj|4yzPiG`_+pbGqjIvd>c@m;%3qt58Dzm=%Qz=^Yr7G z1xzi_2?!8^uVTM>FWvAI`^aSTeaW^zcG*gY(j_Ww-k(F=v~LY5qehN*S3Xirfrqchug7r>oaekCe=>EU>o5 z$*QFc>Za05dqc9nzH?|*uHbC{HM&G05>QKTbAi|bD)G>>Vcwx&pou6U72wjyur1lb zd^&ol3Fv04GxnGHXOVF}CAr82H=pa&>+Ws-TX)fZjTtl$ER)iS8q|W&3e*G4a!zE0 z+#cGaFg2+)vqqTw(0LRnu&>nA&WJ?ALqd?fWL}i#&23HVPb1JFIsXh5(Lc_XmgM6ZF44kBQK z&vuR^;Oa9-rKEu|`w8imMBt(*C!yn01rV{WDoQHLsiS#S_rP7CnbZ zXVdnS5;ANxVN&AE>uME9q_IvC-)c6*>-150GHaF3-HNLyz{&Qm7#8-P?S=L{Q*!r9 zLo77jshjXYn|)X-GtuD*tcDUYCre}Q! z`cN`BP>@M0I6@U7*M({9J{$!tdLytxDT97p9}U7NpPVpBpz<=?tu+M10Fk=vpJEl z|9e>X&l>Yv*$pC%Ta-#pMux$dC@E8zVT6D$()elVu)DLG8n6x+!e%a5G26g4ATUj* zObQQ3m5AU&U$G_LO+S-$__u#VS&1m!>4d@R9_VCv?)U6HwVlK--|DxiRvCzc!*)_SFPnF=iG=hr`GjQMS1< zc`P~r2p`j@^SL&+GqxL$)ayI#M*&n{d2%Afc!tZg+Pr;x8*XBTDmv0`UUNwqs?LO# zIkG=0SquU%4BfXKSrRVGqO>nELj2GJyqG?-oe$+W?cN8tkVdEY51QYTcNDO4pBwrk z$&F(J0mwo+tT{Mi-7(u#8&VS2f!^}>?`wMKfwCyIP&^1c15=X?Gp6P~J7B`n`!mhZ zM^+jCORxuhev8-QJgM;i%-P}t$5wuW8)b7Dqi z6kg~kCa9vZcST;*8v>G9LCF2KAuh5t)HAU#pW?5eG7z+E6Jo?of7TwNghbO68FX8` z!p1=6{y&k>nULo-NsjKqM_NC-$t!_YZH3J6F_N;4qcT_S>XcXx*%Atfy> zp~QQC|Fzx^!wgJQjL;PZ)=i^B{b&TrVK}azfu4K;tX63s_>TBo` z6+a^`pE)Nz_+xP%SXd}?4ssu&679f7xHo8r^9l``|o5Yg*?$EiruxwI-f;JiQ4AEKf zi}FUYAJWun*nOrTX7$ZlE;Hd0FZJxc;yD}+tS7x`U%xCie4DIYEm@-4pm99}8{x7_ zhk?+$b$*2->w}AvR$jCAyc@LM}8E4I9aaj^x3azkJ?IP2-xnKJ-P4Ry68M@ zg9r8Fk6B>tC?($Z)#i5m{p;BijiFj?OQ8J3yLuHNr$HJRP1@(hWo4XpArv^Ynq0DE zVa*rbV-zL#7uo(~NOvg!)x|jYC)p$6zlyQT!PbSLe#2 zPsFygep@eZ|E%V*LO2QIdhiW;OmIt{N0(7Af?2J_nPL8Inx&Sag}^;K6A-M!*sp&F^~jSEGoR;>zz@}ZUTu*8t>i{?OzsYKu>@ez~)@kV24U}JCXkGcp{i| z^kC~Fh~Hw0Jl36dSXR-+$h0-=U2R+qtF=6;k@LOn>+(25Nj{YVUNuR$!CITjX&4$v z`jgvowx|Pfb#Yki+nQAaUIptfk}}wfg1YHT$3q!yCZO$yJkM0FkJ|6e5t52~2CsN$ zCI$qf|3u=1xRk?lVFbQQx^Y=L!QZ3kFtx01VaLdTbIn5w-^Dbx3KSO1@mk}m3fQQ} zwMbXouN%$14R%n!A!4zTR+XxPte(>byyE>29O|#8rXy#S6fF-NX&4pN-(e$2P$Rc;|zKs zm8w-RG$giqb(ls2`xkB5>q~B&jo%ssD@7r+$XxI+cG-fG1FP0SR$seSwY4ZP%N9C6 zTffTZrf2@h1B#<5$eII{d_J^S?OD!{p zO{HTM==&^6;WVh(EfN%WXTLxqQYQdZ~I0L$cV3P5t|8@Q{^tK z$yd$BBuYM}RJ2?m_O;X+OLA5LYX*Af}nq?elIM$-lx&3|_SVg)y83>Lk2QM5v{+m5{HUwK6 zftLL@;*mbWA4_Eak5~rer5|y3F`o|r5g-91!w8{0ywJ#B02P9^N48Q{4F$6hZBsE) ze_~{D>5R*_7^)9M+ z&+KN}k^FY?djBE$Gjl45yi|qxDsmEqp;$UubNn@}kcru25rTU;1+?sazi({-N9_0Q z2rwoZ9m0eY`Utgtq&;{{fwDjcH1$iSP-$HBK(fiPlxUX0+R3RB9wNaO2BNiN|3}9= zOrN3ZIG6BN?cCfzQ0Yar4?52aUOZLSqTaxqz83uCMV9s1Sb`?9ua^n^Xx;D(RMY&FHK2R1e zN44z8^_0zs*VY&NN)SXwzo0BReFcS~Jy`q4?t8!3rBAVOS;qR%o(%>_-$k{eA%ibV z3k1Z+zGGY<#NiKeKnwM%#R!deF~=Qn`|85_74$ZqGy~OdP!$g@Nj~FMgak0XtW3Hn zO0JgcH4Pdo2xK1(hg zyUgpRPyj3*Al^b*uyeuIr+nSA)aE>Stf!V}W>Z}*-JgV*n6;^e<%)lYx=mY?k6Ul0 z#bFKN7M|6Nbp^!~lrFaqBV-ff83PAK@INNE_p3pDdR{ycT&E`JhU24*mtvUx(wBp< zG=P{EvD&3C%6k&o^;0M{X3UQRPifo-W*M6P#^YcgIM~4odP9UDSOO-72fc-&i%rsk ztVx=*+IvJZBP3yb0{Gp^r~>wxadQZd3q?U`pnJ$b!!S&*2uJuVj(nNtGE!kxQorm+ zwd|5l+*pJLa=j;TC~$hQ4n~=s9?w@uaw{jruRTC&y*+C+xM)J1N{hedl+>OBwL|1m z`*;c3yPJ${@lF88c6wZnst_q#AO@i-w z7;nS%%cb`ie2MyWAo>or;+9raX4raUBZMSAr|B@&Xr9L4zYecYemLrGQ>ylWFW(@58&zti2xhZ_OA)Zx}@Dh_r6 zB+)~Q;C#*~!011KL>%xmSj7MJWtKxSjs56bxD|Z_*3yuw+pMZkDW~X6oUsCid5jPG zi|U-m<;U~gE6Y#1rq(H<3%^W6%*wmYD!L@xWZQlA&pl1=f(PUAf+*}(PVA@e-47W! zQKd{s}5;)!PJl~i$+fnK1(--K)yozdb1a8I$Uy_CPI)&J4_V*WCPxBH{-Kk zug97ZBwn~s>}ceyw?gDJ#i(7g27%*Z8( zt~HX!!8l{ZZS()mBwO*Ydlc8P}p?)2kO7Dntqh4qNF?jvCj zr9>T607N&st3F6S@Piv@kW2j(gVWT&I&U;F-#FOE!y->e)+IyMVs#uu928J&T!7uD(47K=1b9`&O}E)EAX`vAM6Pt+BAQ2^P8xfixz#3 z;yDa~c)gK$T1kPxaK`sPAW6%3w!)#TLlV3VOgUt=4cRwzRigOk>N z*}kjOyZ3i?vawRs6q-!^y{60eznilwNZ&jspt;lYOxvhk)7N+|U?VFziK_iqGujk5 zz}iT@IKPkry0iJt0-9jy&4Z!VWoethbHkUvc4+xIp7rCL*BWR%LKh??mjYqKTzG5J zJ=APT$BB;{*2T8E`r4#&m|ReoIgPQus#`lw6ACUoRw_y>;`wv=^mj4N29<7AX zSGt4nNO=0gOWYRw6J@L9MK6M4ZkLZ^8BP&vA47)89PVhx`(?IzY~PWL02=Lqi8a%PY)?*K>Bx#2>jQc1Bk6|c zN)5G}!B*d+^|}l}_tKmnl&W}}RH51fE$1RIA(=$<>AYe5DGS-|3_1nuY;@~*Y)LRm z0X$07T*_7!d}qV!ks^iRt^r{?ua^MOUBpGB1?i4q(HY6x)sN) z`Rz#lg0y;D3C3kgV?Gxhm^fA}(h>P6m+n8OGkgC|;_9s8ch3cY_N@T4FZ>SxVvpx! zW*gk=qi{x`#rmC2pzsY^8ss)bra>)3p9Bo4@UqbZAUpOSWz>-v%I2-oF&0un0t`Yq z)!Focu?m`I1cR?BX@Nua&c@w_50$y^f--FWxwMRPviOXWC4C0pTo~7~$z@n6n5`cd z4ND$JZ<9Ie~y+f}(?R=-#sEH0`o zs2Sd_3$raxU@QUd=t(Swo49q9yDaG zkjVS$iA&ZFcrsfFaWx$t;a{N3Juv=|1@QwR-v}^0SOj`86e@n%aaT)qe zW2+_ppG@=DEdW_p#4o(oE`>8NWP@d$UHM#=Yq7t^s>p8b==*{SP<_5tq)J;rrCAz- z?INNqq4e?32$O_thMr4{zLE_!d109Tq51>hwCA0GpbyxV6-f+5R%1j{G`$3h(yd=1 z=jQ9C-xlGHT*_dUyZ!+IlES*(8Sm4mBXk34i@=xW-K=(KmT5&TI&`%G)8J6S@-<1>BYJH=+6@&H)=rO$5MCvEz03(7rM{MR z3a>IC1)~~v)so<7u&;jl8i+VmxMG5DOCy~oX5gf71oM*~&3qf9Kg>}EQ0 zNS)I{sfjQ{G1_HcULBypuE@8+&U&X^IO28J^%msn&b!W;T1OS>)=1k-kMo()cwtQ= z1Z&bvV1vedGKa3!pPRnS_p(&#xW2<(rlwJj0qo@6MRy(6x2sL}G1I3hsoKZ^%(N@( z5wyX@O969%I_4td*NaIZwL@AJ4dm;j(VbpM6e4$5c@<-GT;1SB$>IzvK^0%+v znDH^=odX`YX)t<9mRHzpLXd<}xB_7p*qEA~QcCILde`el8ZqT{+ypFx0i$&J_y3)v zDg3bu>LYzVlZPXQhtPp}BHR+xOgGqv<*8*-+YC<+>AWRHstxD^%=HQ2V1{cQES@jiifCrl(KaR zFt^!$9`siaj4q=LJ(J2V;y$9r^QuZ41&-2P^26Es;$j)JuC5p~$v826)SL#hz`3Iput!-xn$Q?f;0bh1R_Y?ZkL4o14e9 zCL}w`O7vNo4dUgq0i!H|7(0J08}_;?bJY}67}_r51Uy<#SWMjioV7M>I*l z^2E>?SyFR!L$PEoWe05P?p@O3h3ad^OD=v5&Qcb+K75Nxaw5U*WTAr|m$mP`2k(xT z7XS1$e;5`J&{&N*J?g)GiD17(5Vtt$YNw!O z5WWN}^K9jCypiJmtJ>kh4HO_m%5bVZy@3KeY>-zegK#Jsl$Xx>5AtVB=BfGbX* zwi2L~)Wzy3r9x51aO&VT4fhN*#b`w9%P_r z{vZV5Ob>bFSNE@UtTBCJq^ax4`I^@pQq8Cmk(t-6Ue5DcfKs~JFUT2sV|kL(B2)c{EqUI!(kNAHr04LBpHrLIm_h{_V?CXEbWE2lk@|zeP1HY>98HF@zE#T{jlLKWes$_(BW_i{-vpebV zZ^zr2nSRrb#?A(n-*1bTKG!~wy3n`O(9dO<`m}lxyzL{-I997Tx3jTCEYo~@@-a+J zDFf48$@Tpc?Xdb&DeR8>z25~P6&VZzrn-KT#bpc0?7h;9Mw0C}8ozhr-N*OvY{_Zm z3?aXgg4nm>5tdKPYd-U#yTOBGNYKnA&`}C0bu;hGg2T%K0eTz0{d#~)ZEfmGDV9Cw zIUC$K%*v17$!T@p=FN&DqA!$0MxmkyQB_nX!hYspt44)p*7HGNBS<;tE2{?~KR%xE z90^Tyj82QU|1S9O50B^UU<5&7Dcc4VUq;K)+(MXgY5Jq2o-Kv-fW0D7QXzh`O+gD)|gyk;@8H{Os(`%JB3uyygE@k+nQ$9^QO zdetR}y`g#}RG#&d$bIG)`G6Xpti=mM$he~Ns&ye}hR&PA54}pi+$~l>H6$gydk5lU z^Lbf=BQ<(n#kr_LZ0HR-^S@T@`(yQ?O_gTIQdb|Qu*z{SC2|!8 zfg*r^xfLI`o$}r@7VHtg>wFy+XS;{M@)D4K(Zui-p z`c|RVsq<@7ja}fazhz{gALpJrwe3!qYC61&Z48PjO*R3FY4Gxx{mkwWe{{1~1BRpP z@fowV<|F@Q71WJRY^n@5(7n`)o4h354vM8=hR)tE>K&3b>ct5-ynn>K=10JdL6o5c zr+Ji6#QIXWuAZ8j`!)28Qru~gs!{M8bg|+Ht2KgA`)dVvFkS{qF=d$Y01$+uf55{c z=$jJTD)vU^@#hKV+FlIa&;Nbk%+KI$wBW6MqnBpYW%J;n)83cM#A1 zo!tgsv#UHH@J!I4$bMO&MT0J6&YO{0p^ThpP;x=p1hQq3n_|y|NZ*m55qaS&Lb*zY zEd{pkb@_A=?BO%Eq(Q26IYA4?ub&Hf2lY6TXG1K5 ziUKQ|aP#yOuuZv)kwSZs2HHFx{W=sGg`^{dsp+rMr`rRUiIP;~{G6nL_VQ_X6}2+K ztQW%y5Me8To5!tTGU0c(8F2mcLBHAs71l+1TI_ZfrOQ3)yt_$Jhhg3= zbUrzdj1r_5v`yhrtDY86eX+_Xqlzm$spw*=WgMy|O=>RCMX997M~A1aKt0=W0|T;E z5Ksq&ntw=B=kV{GF~u06FUm221SMQ^o)ku_c&a^qTzZ9%7giL3NNC{e?NzAUg^jOy ziE5g*f~Lv~L2rM@a1Odp2MZ+v^UfnJF>R!8QzGpf9R8TUYAPw{fWJbzYMS0ooV4l@ zJdZmkk6T&m&gbvcuAVci2vSsdh%)7J;;pDKCn~dzdoGbVT(^}^;Y)d6yYho<8W4;f z1O@K00b9FgKZlcf9K2JfNDQd);V6x#qX8T1tS2|DS_7w`bYfuexwk)?GD5>LhduSG zj_Q=0n)kmUz#~={mKe&Ee+Hi|yj-Y9?`TTzYE3tcVG2d_ETYl)a^CIE{CJRG@?j`c z9!!?o^B;HPSC8RFYEL%72!r;& znekz~8S1|5|0ZwB*z=l8g*o``S6$|hJMc|aixmL=?X5EGN25_mp9ag?=*-}g zQ9o)}H3_Y0xn9Usy~rm#+LRhM{r*o~S-Dc&DCuiufKARIzr1E0uI0H@^na-PdKiC9 z&_yYnS7u=DcH9srkQ5ijgwewX$E`Vv{Ly70gVs-dMDO$rirrqXn!(CYfO>YzrUbP5 zP?rukc3ymW?|IRjAEhmz*dY1%-w$RM8JVuQ80V$ywYj(_t2eM>GU|Uesz) zWKH~i0wj&{oZ8BsUF^6rS3k7B8A@sA#a+sLDtu08i4j{(3yBc)oe1hQ#tR?jA_MYb zL{^#`%7$$(=U*owx%Q5wPmov9|_`ZDJHw{LEw--I%_*L~QZy3ALA1R%(wI3T% z6f(V27G!UzGu|hK@%r*+DJBBSO&CBt!JSjs6Z?{Y?YZC=(5|3Fck%%TUA{P)tTAS< zQt&*hOl|QzG7B%oqKn2tNLp0FYFL4<+w1C& zLQ>4mK$bS3B-r4C8;TJ|e+*2g=o_ZmylU|Nz)&!Z(4an*k%N4a3Q z$*kWbDk?k@ZVmcxEQ~IQXNaGNUzu#$(&}AA{e+^2sZmxm)pRP-)KG)HTR`l<$VIgS z&aSF76b&!k@S{}0A|}XVVu<@p>iFk@eSY_Gd+*;Wy-P16(aE9 zg#608o5>UXJiAizM5W2sa6?p3WqnXPp4n&$(s5%SsGM?*L*{%sBH`(ZUQ;j*F9x**Z`e7y(R2|TPbp+S;*9k z{ZYr-ad~xhZnX8)*5arLRGZL+^e?b|N+i`g+~-d;_x(jE&9WHIEqw_JSr}b?gL`P1 z+~SqtNFn&o#)>L7NMqAxvZRRjLlka}s=+H;*x#5cJU_)=qkSBH?T5#msbBSmcE6mg%TLtvG?TYG>QVUTgbcxnaR7hzHsfz(j z?8D=gxPeF7O;fZ^+$Dga=WfR2q4Wl-9k$5kP>AA36YJ3cwMN`x5aBSRfQ|VTjJMU- zwFcI{@99C9`mZNPYOD>kKn7R;Bz+@p%%{khYqOpj|J?fzG4E2Hd+1V~TVhf2fWLKR zVW!Gv0PBgVZkTkZ&~^Cfp!pOJD)Xa^Ge4pRo-fH;7PYSXOHr6FnKD9Y+BVryaY0S_ zNho?iytxu@AYZWNdB3Zh28755=*#X>ck&YWQXKlfDVJf`&dFCitw3$&&*|4Pm*Cyt zy^6Fm>R$Uq`)zs=iY!Zl$NH|W?H-Fhi(todvFNgtC09tnXBWFZi|+iZ{-BR8u*;En zk(hlgkh5GxGn#}RO44(F#9^kR_}e7cH=o#pMT?LI^mL)fsG?dC}I^9o3FavuEMTEc*{9#3` zzgkE&mIscBYX5Ls_W{E5`IDDwg=!$`byUMgMojp}I2hSF^%Cm_N{L?DxgN;>o*s36 zItUU<+#Wet8m#`K&9kgZ=vW#0VTb|^$6W4NjD9@>K0^p-GA9;S3EN{2{t`lP zkLAc~NLMWO7{Js=hH!~~%-kERuCPh8ZVwrV$6Un16Sur!H^d)$(hxS55-6lx)F0+3 zYZg05sbzJR!5P&MPV}?`WWY{K?9SpSi}{f7tf`7lH^|(!{{c-FdV$4;Q7iuuOkB2D z{5ya2wt(^R*NXI~o|!!ZvS5@SFNhCJ3&`kZ2EBwJWv);4&X8DBI6nROKAWHnbog1$ zt9_LPYCF()o(|tBjimiLEiSf9ifN<`b__+Ar6XbLI>$FUrUkiDa^}Ji4AZZ!*!Me+ zryMyCO<&#op9QR>)}D64gM|O!kBOFoGYGHQNk`(~fH07jRcLHJs^7I5PEY95ZwYxQ zv3`y>RZZi^*%FGb)m1~%Kq{{p1@kN!6DW-=4aVdJyh^#s!HWzWAm>T!ve zCZmo4r7JCbn?E+G7z>=rLDEuTiD$aIYfobg>9TqOlJ}KAkw|LW|oS z=@GC$kE5BCYEUMHh`?U)d#`IQ(jhf)UoT2kh%2^%AXxbk5fC%6zUICrJ_r zr+l4m%K?_Ia^yYJkzL@gr<~hS{RwpRD}DI4#!|VX*Eo{NuLC>e}Ywkr_jBdG52sXLF6= zF{;PMzWE=%q>TTpO~5x(Mt>gCi3(etp89naUBH>hW9=GhQTfH*+k3o0**ncu!V&2v zp7=_^rP;Nl!WP^kQyW@5e5FBVIzbdhmWs`%4WC$TJ^z|)5n#OciNHzM&1g#%OFwa% zQ~#TLBf*yG^?x=AyuepY@-MXNZ%~CnBbFsUe&mn~&ig#X3e|M$mdA~YJ1ae|q?1fb z7yFj4Bo9t^F^Q)a2(^rtM!C`wm1DPuSD0^UF}_LhGAeIf3a(Dg$l~e|rDqsXSrLs?uKieAo3=-^_n7oZvfq zZ*6){;#V5|o-g4HG&$o?$xca$OqoiE2d`=K=>}|M*R(WOe3?(8nR{bp$sd3d3(E{y zcb%0cH&wo;zQ>_|3wIm2L%Yq|;NF*a3xEMb!-6OMw+X+B$fF1ow#F*qjQ8>#fW|ge z<$kTIY01DNJdG;6*4XU9{eB1Gsd%hP^;(gSViKC_&~MPfv6SS{KQOP?tas#0q;u7{ z!V;%k`F-6-T>sflnfwN$1K+ri+u^Iklgi_f2zp(SBU+idsceyNnS3}!i|=aQBDGe#1fDB>dWs2hJQ99 zJ!K#rmlgNHU2%%ZWwS5oa z%S25B!{w%XBIP^PhEJIIo?TQRvUrU)`aVsYAh?{#fNYhyFKJ zg+j-Us+5z8}M|mm_;*3TWi0vDEgC>G4mI{^!UddT^j)_)N`#H9=l40La}Q-JlhN* zdQq{TSwdcyr~h_TngTR;qiTP-f6M`V#G6B_JXr%dRRF>;g0Sf^Us6?~R@fMYXna}>q`;*7vf1T&MCyyh!1fc*`8Pb>-a7A!(B6%}0 zF>AmC&HeYIk-`5Q{hc*U?xV-Xur3oUO5f)ykx%Mw8*|eCyq_b-8{=+oNxkEy`^oP- zQ4Xocvb=Nx2Hxwi{vWNWpjioz3UP@{Z{Xzx2I-4OI?wQ}etkEc$Ts#2(yyKxYjm!B zGH`1!m0thriihuapcHLb`&Ec9!fQPs*a{>T_$p94#K}z;r=&}Dzg%I|bCQv0+)8LP zhE4;R^@W;4rLBHZ^Iez8+J-^!U(VE>{NA>w^iLoZ!qj`8%K~dD_2|qReFGZg9Io>c zkhL$8A^t9tQU8nBMb#6&M@+!c`J>f;zWr_X*-!Hs`?V%k4R*j!K}e7QY&A$ETy&e| zn^*tO+o3bg#ti-6;!9sXgRq+jp*$;B`jl#H&I&Mb{ASE_JAu-SFY;RMJ;w(nk;E!O zqaIb6suV2@U1r>$1q8B--woNlwfPJTRXG-(T5UW-B;y%t5f&BRk-t$&;ip;CQca9; zOpxRIz%|B&sff*F$BwU2<3cE-s>hheH9U#(@mj|vmf@V^T>aVW5?+zGtsSp-{LY)k z6{~oKwC$oFCSl+D==tDlg7t&bMXAscl@j7m2W++**ZqSosO-J>sk00inn@7qC2x=M z`_mS`N%ho%(_;RBZJG3CPQX$T;NT#+pYSCW$Ba-yMp)GMt6U+ifX*tz&E@iipKPuF%XX^v*6bYc0l_!c5=qb> zNsiH!{YKGRoG=Re7*lr4;pY=q>&uxz!*9fvYDdf+WyS2FB>2eAuJPWwy5i zNSzV(k9m6Xf?t$Ol6=zw+53g}FWF}9@#Cl2a^d#CTF{%~>|Lu9>aS&tCA0O|)2eB! zwhLy>{!Wu=>?hRhEez6(uNBY4i!|b;=Y81OagkAPvo+a?Vm6ZMiI-T^UrHm0R#ZpJe_u(FALG_DO&s5W}fGb>CR z%noYvHhaP=sPw7(p5=%i!I;+N7D=QW>}%Og@-*7I)%S=Z?#-krvcZ}h6ejmkI#GDT zASEq4vOe(>w+CLVYGZ4)$NBW{-xJy5-(^csTU?IUfJ4_1%yI-?GX_Eq#JzWS;c-J2>x~MWu4BdpTed6><#%w!LI%qv(qO;_D7h_*RIRk8+S7vkc&4K24`}Wg3hrtY$ z*qF6Y1{&qRcG`5VZ=Vw+PlKb`>dA+JKH}FLTjD>ovZMj zi2e@k{;y?q+2%Q|wviH3cg?beJ#KDx&VR)?)`&8pdE>fu7Jx;S zl}WuJPZ{m|#!K0LYypJAZ{ucOJ*1PcHJ3P1^7!sWVtllJHcDZ%xq_pxQWETUy+5MT zc>^S+@4viB{QS7C{_r=o^G49@Ve_A<_x(^LzpsCzCyAqV~=f3_g%0Z!J`LA#cq$R5IF>1rUAFL3AJUdcn}lfy{(5Al@SUo1IYN z&WolsJx($v{c68exjCmM%0a8%RP>DM(d6x2qVK(_OrKGU0{DmwKOYSw@nq7pV40r~ zoBgmaU#VAUky1_S9Pebx4>TX>3F}LOdnk`f)qU_TghMI#v;KUF`0~K&6n7~vsb#Cx zmfFs^Zac?xW%&CbS@aK#xTyv9SXm)2TsenE94OZIx!y%fWsypM*-fzC*m8nUzDhIwVklYd0y&jpoJ8G;3z2>ZWul++vF z3^}qgSqr`B$7ikRx>Gmy`7?vCg=JacR%4Z*yaZa%l|&cSczZX>2?qAPzd9YHA44b(QNa1bUIeP}0aBqf<7vKfC^n;Z zZD?0>JGUMBnVs*>@mBDq(Zkrwzq60~o>CW`kLNa0_oKPDmz8%Lxsi_r=gI@W7VuP( zl&t8qCihhU>>y9K4Wd&3LAc&(lgpb8HEGZaSmxYsM{iCHmdVF%-3Ry=AZ15P zuiZ7FiR@u!I%k&FS+e2PQ0gI=roTKit+eLF(Y121>pQR7m%Q5-$8#9r4eE(Ck#vRS zw_B?H-2%51T!ZORV?f2#^e+}#BBzvVpqX~5X>J>WIm|2hZc7(m4Yk7nKEb5NYszbK z=CGja?#JiH+sO|XqW9Np&K+0(eSn_z<-^Efjl|1zAz1o67YGyJN`@^RA@b8C$hc{c zBUg#)*2Pc%&2)}eA^9O(EOl6z)7Ax?fUS(EZPHVCGqPhwJmA>zaf5?F!{6-Jef#M~ z4Rcxn=ig{59**xEBkaJ=DA*=R8`(UkUtlHz8!eV{Z9S2Sn5|c6HFLTi1=}p7EVpzi zzq_eec3}QU3tPn#f&`I_6clKuTh;=xuOyg=6`F5m)nBC&R}5nM;->|)vgdJ4RipT$ z9aIt_jbWz<5q=}4H%hmNSH$OV!L0OWc~P$f4O0unIbXQ2gEqdh3r5Xc$8(oI_8| z)f{z|`>P_j5{FkMw_l$;O{b{DkptvrIF?*8qJD#9o|{Mk?Qw*$UbAsYDL4PP2+g7h zyM?eKaiN#naxF~{ZzsqFJtsPZ#eGe%ue}0qK?zypk9ee-FVPtS3L^;;I)MZI{&n^Lw~M$x*ZDled1JX}Jd^NUt) z1D1s0AodYOU>8LjI}5Q6>DOpzwd&{Py0V{J9Z~!1(C;ic^WmM}O*X@0&~fEsYrr1@ z{m#GteHct0#crZa7-aZuC)C;XVGzbN9&LAps%YzE<{?@h+CnbL(}Ved>nqPD+wxQz ze7yozQzc_+3xN?4VEVgGozKtxoi>%UodJFO(T6YSXA+*@M zcuATdvUjTG6;|PYMqiZJ{hqsOG#lM1>z50Lg>2*cXp9lBK*Z742}3c^M`#(Roo(i^ zOz~3B-dHlLa*=mAv>Ej4y8AK<&cnf)*(Z{&RW*da8i27#@?a1BN*JG0{#JPcc?_6m&=IAx({UH z!BN7xm1U-zLyk|xt#6Za!p(KH0iM}sI9E<+ic3Yz&5%RM&8Kcrz;b+1g0IR^!dcOj z;%GB$S&{(nM>GH-?+Uhxbqt~Gc6yW%OrY=go1k#!ejl`8^bgZcGP>`pZwTJx_2%JW z-Pa*pv7V$Z*L(E-xAJUL zszVVQz7#4kB-vFjdH3{%`z%8`^Y{Rh#O7yQK#sS)$6)h;UGdQSd?oEN0)$PR=1AI% zwe})@Ab~q|363-nV%I9HRyzi_RTxIBXxlmIjEGY2t@ba7`+Je=bvogEx2%pA zaJ%muaDgc-Eal>cc}`FWmvK?GqDc+usE!^AaZ$yW!7jpnsmOL$Yv%PhP~#iDGi?EC zk)3Gs20})nO^9&$$qWZ*0BM$KGVCB{cUxk&Q@VYVV zBvpr77>R^EgO3y}U0?bfP9mqACVuNl^e-3eOBtg}iG!G+4Iqp77-e9&Q@_(!q@}$J zUi`c%!20C}B|(B9iYldoL}O{?2@;2AWtNYQU9Y4q_8h#0^deE}UKuZ+H|DKVNX?ka_m}4z zoiLl4vFmxfrB|^ZI`cKF&H9C3*?kIr=)ljbrIKn)-laY=&VRAw;rv|4y`k!rnD-Na zDMQP)B3dutmQi9lC$(=H0Q^dp=6NqmVB|f_#W>y4aq)3qbB^l)TS^OnyIDMW-g*qp z8L<}Bmo!OtR7kGZ8!R4;;dW^E;L(?qJh~>YWc5ImfcO+RQNV5r8eO+=EF+oxZRxen z@jOn!32+nx>i&+1kNkY#d;Ig+@pL-phTy9O)|1%$;b1-{p{)(R1+*uMoDx8ZN5Trwz(Sw0V zr}StTony30i)`#$%%4}n7N@Q2No1Av$gIlHB) zv|Tr`cmWJXi0XTqJc}Clv5&XND4GPfwU|KVa|a=v7gKW^LBZDtuckShw5$XBVJr>& z@1k4bd=l7-%Kc-QIbd~mHmcb7J(p#ZlQ}2G`Z3(4_#E$~nM5fq+2|1t%p{0cgOG?J z6E(^2GV(~PSB7u*OTIO{wh@{bMjZ!7Yl3!$nwITv?h3p>>Qhr#qH4{pPb4oQ%C2^V z=Z|JG&H2y9dazW^xtBu8o(f|ble;(teIW=)9lki-tD>)%%lclzgH_Mxghfax9_UdQ zzDo2^EO#LL%T-!c>)|C}2L}E#J-U#J0&vk+mm2$PL$LMC=EZD}&|IJHIwKpPzMHdm zD;Ts`4Zd%1>-}+-T$iy&+Z=3u&^I{baj?JG5}VS)*SBCTv`12r&{6i|rQ2ot>+mGu z-7-hf`EMjmw~smMlIQf?d!m(d1GE9yWPq%$C|jfUW8I6(5bZMh({xxp&YN3y=#+&* zL>)bc;j4$a&D5kEruc~N?aN$>gQ$Z&&u_G@BcpVYM_s6AS_wO)*q&fK_NtT z0joP3E^85}4dnXy*BNfL5KN>BHeAxUuO2*D2wXQpN zYcDQu_G`ias&D&;d#v@jNgSPj8yo=mzeH=01G5o)m7%XZKlWXCfnXVZ`b3Fb#kR1% z(@`lao6Qaa!D`FC$arFG_T1{~JKqae_Xd;P(uPPndu2Vd23lvo0m$P~n66;nZ}_k% zg~YQ}O4NPQ_q<|bc7B9ygBwF;J!A&*Rd0!zBaa{_M*a`SpIBpn7E576P@`e5*tG`z zRVMfY{6b8EXdC8VrC|@h6GxL5=fm3{2>I>AzCVUZb4a}c4PRJr{cOY9FT{G9ou6v> zW_cw<1_cn)MsiqAr~<>|)MsrxoU;7IX`&3-bVUh_TyFV0`d=H~ONXjC3hfY8mf?Ij z=?=69wW|pnb}#!1HpNbv7iVL6;oHoCG(QegndQfRK-NCb2^4wZm9;-oB2sLY-$(iD z+

    |sarNXYH~k|*ZAEL%*U<;=d?srSTb}U;HQq-B&Wb^$<-Z+)Tm8h(c|dS^jPfhW zo|^3UtXn=-&FIm|$QQ||kU73SY7OgaH;^e-fLZpf!Mlau{1O$9nX59dF4S@D4R$wp zvFhwrZQh`DbN78JTdE&uuy%*7=J)d9s6-))H8*nr5WmEhwu?6)L=sJwf>05RoU;zs zj3TQd)%=y8WNbjFc0DWjY6PJ!D?}5Iz?ianbqd2O@?*-J_5`fgB>mKaoW-RK&c2t@1J_VsB2I=RjYVg-G=mgn! zm4c>Oz*A2d7!J53q7Hc0wyi|^1bE^D6oSTw7ZY=Cu<$in>*0K~e!rU*6^gIr&E6GF zfqsYd^FRMpANOWF7z~Mc^WVBBgeHh+Xw@oQ%Fs#Bh+7rcI;NV8=8TC5kIF%tc{KFJ zzZBue_k);f00aiDg4FTs5h~24Zba`J8!9*7H~v9e-vpU%B((`h>KOUx)ijD`$`A2o%bHy-s@lcyVI+n35)6A3Rsh?q5l{7oQxtcKd6&LZO?(8JfOr*nmayJ=4G=4oZYM9vuR7?pQ#G8+QO~g z-R&aH`iH$O6|)hyw2gE+0B+ce8R>`Xy4D{&Hh41;01Vrrz)^tt6cA(z)R%3$VOP(A z)yeuC+vRWlk0t3MFF)L4;b=g{?F`v00qKzCW*v5eMLnE+B2 zeiRe*@Uwtw~ACPa6ES@Ww@V-7&8`MDz@kTKGy(P zF5~eK-rB~{XHn+PqCzE|2EcW$%W6-YW?ijv(kUMM55#sH%>9SvcPRux1c{_`6`$Cd zQ0_U~R4?c`KF9|8#~RtWh*BqToFlqpeSDYku#Rp8?DUckZ;N=efDEZ%4|i-&v>a19 ze`Sh!ICW?*pX|QYa1i*n`rrA5^0JgptY34={cI(7k=f zPj6=47@a3t*a9P&mQvSMvgRnTx&WKss3f3>2PQeKs!f5W!I)vy6kV^qsZfMifpsL^ zhXYuOqE_YP(rxc|fwkW97N@9x@fr|1)}ZsB!jPO!3|humcgUrE+Hyi^8wLquaSI00 z1ghK=WBt|JY9px&V*o!MGYPQ=ZEX=z#Is>xC5R%%5_VxlBEbtwH~|Q-+12p>-|32|IZ4^Of1`8F7rii!xZMrVEf#50O}{Q9wP%Hb|g*U z4_n7ax3SUBr!G41Q#89Xls7AyIRybh;3WrX60ipGAftSU8E~H;umy9TZ8t3FebRKI zxNyCG+&B$rus?;#b3r-!vXA-ZwciCTC#f`N2YBN=DP=bi!4W0MM+D5j=l@53u|liA zdli*44BI#N%L_|~WEZ>;T$un;;-;XyPbNyjgwYV+HE`(vD`8^T#F*c`Yu?^Od@J7&+ z56}vmbgBjob!rLawNF?ls-$cjR1E4qHcz?V$~GO;_IG}UQ%#P%*J7S%bSj8sbk)8V z3jLD*6a&tZvj0aDG)2N3yOxbpy$|1LZ6bI(v--ZEEzyl`o<7&2ZZTB1N5(jU^houU z)bGRl?(Z{qRkGN69!8u2WqFfx^KscErq$?2ZW%BCJ{nhXB7a(=xQkV1J@96H z3niKtz&z0pBeztz1m%J+%AbbTF~7s@SCTi0TCsM{XVAn8mm^Dq{UG@OB?kQN5E1xn zgkA(1mnK5aHV(M`wDOr4R?%Or8KhY2_OVQeE7|rF82C7Pr0RxQ34G@qWWnMHdA^5{ zW`=_(!2?4folIGpE5TE4#n^zkwxr54YYD!G9nRh@1c8&J(Pjg%-MW|E8ziXg00hW_ z=N#X3Pec2d-G`B(yun=(HFip+xrT>bPs$E^E4y0Qnhn+srv%;~h_Vaui3$rLHlwo4 zAU!Tf2-gJ~oV`TyYAql3FFZVP`Ujd?*A8DUiVCosaE6poF#v|U<$38$8Z2VN($eof zLrjuNR85FyH7SnuMtub??a^sQyC$4?`pUAJR7(Hx$|bp$SAF-NR7II2*{+nwowzVv z0k%%8;^NPvQm&ip_CDT3R&qz2VMX0%e!IhZ8f4I9yC{ifM=j6>T_mn7i#&~94&%Q! zdP!m?k5y|aWARXFcy#P-#u*u^>^We-7>ku=GW{>)Tjpdggfwb1@nz5RK%{w_TF@K! zFJU{|c2ftm@E7tGntB@?!bQwJ26y4RcWFKl*VI2P!AxM)RC42dYHuw)|ZK1~Bfn**853)NQ6CYl=?$PV_;utueY*fQ7LC zi~B*dTaMA_V-jw>fwmyP%T_)an4W_)*acBj0UXhYZCSDA3HE9XjxZBp=HoHI^lFx1 zh=dr24K%4Fj#xWa!yKE%eW0iXu~p!Es*-&%1MfFH65($eFAMp-yKr_3@4W{`)`>5( zpG|b@#!mvQS@;F%gS_i+hz%f#W=8c3H=R|7h~7jRTGAy|q9TksK9nkuS0q%x z;Or!49dryvE)}a&ae4bW98VcrlI_n30LedvyOM@C0-5IX7+0-Y8J#nRxxe*?pY7%3 zq6#(DI9vlMEFbn;;l3;1ky57u{3Cd4s^O@aMOOTemkdn~2V6`qhecD~b2o=U;&6R` zgn%mC;Z!*eG%ZB_Pz#0t@Yl}JS${p-;UC$@5zo=zs#Qi{HpY-#u%3D;Z-z2LtJ%Et z!ViW(YF+1gUp}8GBFa;!k9bvqEs=}ZhB`dT>AyuDM1Vs=JKM+t$*D@fx0#I+Nrz9~ zxZumufR?I><$IpD7?;C2Cz~p=RXG2QfFY+b`e~5b=YqwWdRn=D70`a#$Hu4Cd&T2R z1WQKR;UR`iZIpb+f^VE;b*Jw0dqsLu-Tgei8$DiMUQvVEh8v#g z4~?tqQk6H_$(jv^BV?M})ShPI+5$$(WpviG(MYwBf6~IX(eG8)k1t^txMz;+}c8z?KM60x+WB!Ku)KR3($GkSv;MhYDMrI%o%S1T`) zxVNi#^BV-DeJ#_~VT7)FvYDs%)i9?FwikorHu63O2+=GL9L36ns^*lUKxsgv58%eZLUHT&xxNenEibl z*HV8}BM!A?ZR2Yv&)F_)qTu9{4k-XGszf@WWFSKrK#dR<{PMlqr6(a4F z=$8JAV|mKqZ4WQ+x@l*}b)ohsgq)1hqskC8yI{9@AEy9NR1FE401Z0 z`xg>euH5i&^W*GD;8-F`IVsB*V3YLcOlG>D%k55?%>De zq45Saz5=zH?ahiNAmc2`iH-=cz1Cu}Di#|98&b3xBOkG!J-DPN>i3$YhjmO0?9!sc z<*cs#w4Y2Jp{T%3F+scy{wk6PcyI98X`Jl-YSiek@wYpReNtiKbE|Zcu-^$j?uL;P zt{A!T(U}nYViOzVsI%hR+6|;pzAB+oCB%F2X{rM1u^NjZ%H?D(eS*Ak4ZjHexwDyQ zUb@z4Ue`sbH&{J zVccaS&CNmwqJn)GJ>ogi43*}~N;Xj*HPhg>+eVp~v3a$&)jssR34_buzM3t3YXhO8 zR|ec;m!E}{>VU23Ax?K&(whSG5&{IhFRzC$VO6gRLs-nhe$ZSCBZxC?(TzO*=D-!i zAt7lBi9WCJj(RKxlP3{yKI1dhkt=#%^C%bk+IVY+8)87Jr72JW{?(6WB#A@j=)ebVBac{1Y%$hhZX7+~eGkwDF=3 z2rww?^$V5V)DK&7mN|(l#N6kakCVso_kx7ejT<^@SJ<_K3N1dJP1*&YVZjhT+4Aao zCbCeEFgz%xcfy0W3$pJfiCY*2Xua-qa6OV zD(t3N2BT}*Pm!a#EZck{-^ zv15eC&MP2kI);A}x4*90?;t+j0viwx+wppH{`Pm*T0YsN&_;0K49eSf7r3U&uR9sX zw$LH2;QWSw1$llL=J8^m)sr0or^9;F5<6?=m0AXeUsq zYFe6~QL5y2i{oKMGE!Fc(m(|KsC{;I3Ye3~rzt^|-3i8O7kD3P`{=EnDW!}= z3*PveCCF(Th^V~yL=_@i;5QVTksv~kmdu4J5$u_wUM8{-+EELO<1&<@>-1u&;X({4 zETJjo#$a*BvjHs9W%him<{v7t}$q zgUJk}gCrm`& zf52e-PLgDygO0G^D?+G)%u>|>Wv)#rOpR({!%5-GMY*ZYP>)=cu7DXIc76hp{nueKS2El4<8!Z|~85Vkmb{TQWt0TZu z2Py&Ix-9UigFNGQw8&BIHnN}gdAfZHs30*$uY2R!PMsLm!-(ZDkxncT-XKQI@Nt-T zngofr($%fC&}>;%{AUYqiv0-p^wJwLJ<_aMwVfY0lqB|GzR>)Mr=R~0`haMU0(fLx zv%rMBcKJD1`=o5&CAVn1v-#pNm#uZM`C{oM{N9ob##g7lz>mp2>oQ{F?pNu;N@OIREbJ%ck`_366WIIertNNf582+9ot{^^=) zi}35sMp&hkh>S!s4EbkqTudzK|8H{m_sjok;%Q)ERbm|t&R^N^i)EQ>Qd`k0QQY_o z6h96IO+L4b&%`LN_IUB9`{T z$>4%$4glM2=qR8e!1_cROs5edKAtF3{33I`QVHHqu#Y*w3F8C!WxC{3qFxgmyTiHQ zK?&?UgSJqQB!xygvpR_I^k@Jkuf+?kqy`SC!gKQzUKNp{pdI?e68s0`Rq-$t z?F0D^Q7?WQENk596p~u8G`X9zM@_^Y56!36+S5b}r97}$te+hJG(6tKz9e8~cLd!IhB z?v_cZ>#&GOVi&89RydJt@JJ*%%2Tzcz(z|f$A<;`F(z$O|GQ9gV9x+aX0oP{N6jsW zyN6>Xul^t6#JE@9)}&bv7BWdiDk0rW9y!D3q+pnxrcSm{>iH?t;v-A)tfx z&aSxNO*7}`zg`ECHvF8E&H{_4KwBF;IH~nV(f0OV5^bkc8B6P4<}uwYX*;EJ%z<_| zhdoawW?ZS=`TK`$H7QVE`@Di$Em?{t7x9cAIcu_}+ia19*wlO2V3I}OPcWlvHTu3< zOhC*{&(p%X)+Th&I(@#TP3EIbbQ4Y{IpaLGwfwS_&txiHL|ZD0ix-%mhRw_chqe6( zfhh`;^-0jMy@kpW>(SrlnEyVtXfnkhK4Zo#iz z<%>H~k4MI*G^w~Y?3Y7LhltyFwug}K*RwPWjs%|RTJfH?@wst)=nTGj1h|B*-tmIw zQHr&fLF_8K83R0RozZ8%J{D$SEY#gZY*aFrZ4uzVf(z{Q(O1*X^l%(^KpK>57UAV5 z5BsaNwBRD3vzj5UBBXyEN_J}?8x5jRRHHZ<|F5^pYUme<1A}T_G$9`_1b!65qBxpb z_l=nCtU6Q>fsDp6`!e!ffl+x(Rd`%@%%cgm3=IfQpHFScR|*}4RCchNdFg4^ZeA+& z(zEM>yc&U*|$Ee_V=Ju4@PL(*YOFr^{lMwXy~K;bRFV0^qKA>C|vp*KhQdwSwN+uXO+Lk zs*383aqW55djmXGQEq#Q-fqw+EWPAA zi3Oo&PT#v!R1y{%$l#vZ#gT@}Rh*4r2yrSUt@yEm5sX_SEK1g^mjHS0> z9@R0-mB^PAIoBUyEijESYklwnKgLc3_=&eA>#SmC#zTRjC<(9kE*uE#BOc(I2c7OH zONBi#PjGQ)E$D`}hrnCb{^I#NI%a{5@Jrol2Nbz~c9dPy_N8a?&sl@H7={Ey(0{-( z-nQxtNVTnZsr|TIcH_8w?}IJ4zny?3K6E^ZgGXeX-5UIMQC)sZouR*98uBWT24!M; zpUwm_R^ra=T@;%&x{?(fk&<}m9Jj`;^KBemsMpH&+A35FV zDxAzNw$w)5quKo0QJBiF-teHpX)#}q7o6bMM%}snYk$&7QH=Rhuk@ z4cV3QurJu<9}74`vii?hHa-ug)zg!q{&R!stENVA1$hMe7pR23Q{#$N#qqDXp=_tA zsB+MyCbFunQ{M^#op$$r?s7lxLjL!j}w!J z<9d`O>2A<*Lu$QZm6~E4++;ydjCOwznU34{X6M3Xm2Go}EjL@_87SeeMZBI{Xisia z2-+>W2y6i@eJr+v4iqP})!y4rviyy6;E*TpwE^M&CN8kA%~=&sN#Yk_ zlZIS;hLqw>0X)(XGj_p3Pd3-XQEgv~yVRsl9KegM>AXhnwd6cCla_5OSB&@IJYe5XQ*iT7Gg3OXI^OsL5>gGjqLvmgu?LC8mpVzfZEuWUg`JB zqZGLvqN6T0*1}H?o&UufZ3tn~hQ4+(v$C46o zBHRvG+*k_y`#7ATT&Y>(I?ZB)4UcdO7YXP0~X_3o+B(< zMMt2bPh)k!k@LbQPzMJ&K1+O|D>!Jn0nYAQQj~a1j31?d)B^Sp+2swpqlAnV{V<97l4KIdOqPgvuOBCwsR( zdov!IWihK5jKR2+g<0pdpMdP(7_jXZKp%sPQqqe?7sh{oBJL-Q1!LQyJbBYeX6KOi zjUPWcmmFuHa8oR@J%-Kvig2DIB=pqOBG<~W8F{ofxzA>Oo`=A5B+~ikoIL76PW1~l zUiyVntW%hCFfDGcuHS5)g9?FFKc%TJZ}->lqwTa8>&{)jrcq8v)O`_iIjc56rdqVR zTK}Em0-#ops-0hN;{NYx#!vB~Wwc4`(k*owy7k^hISOLb zdVOXw_+`u|`9B?G8sV+R8BVP2gioZZL88n1Hj}7r`V#A|bX10fSXMq7?mRbt@p=FG z)8G)!chORQq5flq6B0A<_Cn3wITfbfzr%Haw?*rZXQkf?k8G1=-gX_|BQGu~Pp*z1 zHXWLOk6y@fJHpLA!{evyaKSH=&uiOK{X*qh-b|eygtX3LAUn3&9320$%S&Q`o(wEf zJbl7Ex~xkzAB0JUKi2Y3tV~#(Gl8hH%VpF`ZO;BH5Jvtb<6N_z;pZdpfWhx`KkvX7 z0N?N%SVkz4yMEhRn4#&=dMn@!!XO#U9X?4n8SMlkh`(fNha5lR3@ZWf#T%#n|Ngr@ zJPcp33f)~cMH1`VPKl={h{j6O8!I?{KRPw9vuI2ro}IkO{g8A|#NGJXDppUK9&`rm za`%G%a-<#FHDDUE+Bym4Ps$aHo9+9%Lys_k*=moi7%{#l@sAvlb^L*RHd=i9PGs2y zVkSh}x5eh-7)#x4Fb^fV3Ffy&M_AJlVkFayw#meaFtYiU6bBaO^AB3(XxKhm5K{XH z?SGfjucQ7zdWsneZ2uJQholr>J2ChS!~V7;l)! z;%yb}m%7xq)Iotl%WkE^FqUCYUsqg#_pCt0U3++&!%&I{rJGy8c|vBb7Fid$lU?hy zl@Sl^PmC5a;wUwW5Mz)BXR>A&$8F?z?LSJ#Iy(}`qatp?^s53I^kWsjf0`HPc9@K& zXkOtlDi*YjAjD8KMZ?@VJ*<+1F^JfR$A-%jDkQVH?|A(P*wVSu_ombJvUx*yk_5Xt zYo`1e5AO0~Dhi7-$GZ==|4CwHy^`1tKdYlY2?+1WF5wC~IGG8%GovNP8A(SBgwCNh z@L;#C8Ik&LoIwMNLO#auu%@m4;Jtms}Rx2j#nb%%HSd0bjd9Z||`(c*K z5boB`{Q9Xb3m)~}G?I46E;e#{zJ#8+g0P-g=NbMHAO&UDdIMi+A#=SxnYu3s-Re3rgS4 z&Mw&rjMc^0U&a|j#7k+6?#KcA6lepsp-mBXv1)d+gVt3N$gX&gMayLyafw*sA&$cY zEKpVx3ti014Mu~Sb&>LT??3D(Y5aS`;G?wFWD#0OW5lTcOvRT#Y7m|)FzufKT6{Fh z6JsS2NMy|}5Vw5v)rL1AwvNyQdl+-f#AI9Yz#jm_?%RF4XW(xySMzV~@!+7JSK!Bb z9j)1GtvLrNoA@0Xy8?Sxe(%;3CVv**{#v|0_~#)jp0}3kCZ(x_H@9=J7+1;@#5^H2 z&f-(>SJe*xX=cvpjn71RjWOZD)&^0%_8@zQ9KokX*DS#f?t~F8P8-M%v|Bq2V67{`wD%3er9FILpPFU zp;&isL^Cb>VBk|#Ju*<;ShVJDuA^gN-V5@NV2@xOLt&E9#@9mY*_!}$TN7&Cbp-CP zC=(C}g<1FsqbKV}L^0@j3`}SadjM+L&$v-$$VLZz~ z&44>aOeEmTE)0n$w>u%k0-2MUi-ScNx4XAu^PbTVm7jgG?T%GL+vALS;Rr;5x9ESB z<39cNJ3At6Z&uS*vh~pUk6I}cS1L0RQa~X{E_<_TPU&byzf!h~)J14mGL;m&htB9sFxijSGHT;XEujEtg=S z;li~;OyCGpm4mAwA2*l~Zl7lA`*9Rx61Qy#l@m)S{7qIYhoY2NEhAB~&v9J8WhKH} zL0gNu+-+K_$*-uFoR=bJdZ z)OG>FMMJRgW?TCKH$~%-`U`-^@*WR;@AT{()mlQQoO4VoUC-!ruC8CFR8aTM2)oMnbp!IiDJeJ?>aNq1ZeBG3PN_0}K2FJ7>B}4YH%Wmay_q7Dil9PqJG25ZNb~)a)Cjk#$lH+U zt=Ky%(^W&QB=Ayep<14*Bdp48s6N_@*v|+lFTy(^Q*HFK1&@;ZB*@Jqw?mJkV7;OU z=55a54Og5mvT%1#tXuDtSXR(`-eKC3hsb<7_lP?v*BgQ_RP==Ui zuG-nHO&3SZ?-WeD=v#qPjb?<9eUrd95pv?b#ezl^$F{h(pJ-s)56C)UyX$fzTa6iv z*`Dj@lwHU^wrk&P{rt|ZQ(s@Q|Y&q;QR=Rdvz=Y zEVbCnEWG)+&`*=H?B-9c;=r-G@MTE)<>LA<` zNT8e210&7JVtt$iP!s=hCsmjD8(=kV=ovh#74&|~F2Y$f+<_)};8VJszQJ_ zGS^#v;t6j)uk=2O&vd`h_N5P&z^brJge}N*ySB`zHVRLZQu431!iMF(t+lY9Cbtor zT^2ZzuXOUH$-tIvaCijlEnsJdeuk9-u#A98 z$+!eI$AAXYhW%}Ouh{`Q{q1DyU?${UPs^0*AZ^8wSGG#eaRFRBzBo-Wfa_3KpSk#L z8oOe~#4ZNI0t(`bu5iEAsab0YJn(oa;@-LPRnm;u#TQQu`SA#6O#mJ5@>Yw;MS!8Z zXU^o4(N71SvBiaHqZ(iRWuH<6*upYLAP$%I&^z5cV*t%bke}1GK?6Er1FQ58O5&Lta4(oI%{a-K+ zxP$ANttxZ#+NaEt6+XgEz0Ww@^$!WiU*h@g^to60X;Zs?QIawD{*`@ex~(5a#%Z%j z*Rp#q+oUM+kgpP+2K~9Kshe+h6eM)>4*j6zwsWvtKELqmZ^Osi%$aa*;h|OL6Y0xu zpei5A_WV zyBc3qc<*-R-}H*+3%*v-RqTSE9(1Sh_*Tw8>p|qhLt8!{(^R8%tgOoABdMt?Ij8rO z4o5FyJoT1|I)m(_v~S!z>dcl*tGro^jbm1?y_A8Eo1e z7oin1>$zPkH$DzIdAoS?_WS&p+3J_vNpmVwGwu~jwK3pO{mz~218(K9ww1yOTG9QI z!JwWtAD`{QkNE3S8f#ysZV~&_dBE>C+n~*yH`}?HF`YmK*g7h5Jl*4)qqpn%a54`( zvGOY4bf)ETkFE*VdPs1?!v4Jc&a!&3@o#(Hn2XN3)2Vjen7XQDjv;hr9hJRPio1IU zaTaaLR2B6!@5tV~q{wqT#)ZA`a+k=-rp1}B>htoS-lWNi<}T;))J^%jioBymR}?|b zXe-~G7ieg%hu(Ri0N0?J8Kvh`i8a>+2RG(8QJ-d%4)9bZJ2HRy%Eh1ElZxMu=dV6r zTlz2^XSv)r9|VzHci`Rld_Yz4*S&2@3zM{>Nb=a6j?j$yVr%q369H*o8L=Xe1QcvW zHGXAXM{Nd%;dVr;pp%Iy=^}-ddGP|Qj?K0oyFZSio;mR1TIdHqnJwITbFKr)T)SPq z?-VihzZ7lC9sIRL)H9tDt#chSoiy@!bd+BEtz}uU_=hNA@*!2vuT!!^q&+3Yi2jaF~BQt&PN)99kOS<@rbh*JjDC4N9{K&kWjk`sfbsC9^u-kLh;f*T2 zrO{v~ZJoALC$0l=%Z20uu+Z)_5y392q=LIRqY@Nb*dRuaW3Fi0CRRWaZV3n=-*E>= z{mMAZ`62R;$($pxBvs~Y^WRY)@Arp0_3MlFu&WC*?BG5;->0jLLrD^k6-Q$;(ltl< zBN!i;=9F3@!xXqc+=_2rGa4#d{yVa?vNAL=r%SdSQ@t&zqa0xlE5?taFGpD=xbd!m z#jG_BqbM_}2T=jzOg>HYoqU_UWoTNT^Z(y^6W*-j5IMF73miS%f3^up*scLS`w@M87*Rr_d7kB zl>t| zMKudYdRd3=w<4e1h6D(LUVsQ0O5^+He|;<&C(A;|WF-jp!+4GAOdL!^L2vPLY_F3> z1hVVW;;w+b0Mv3c5lK@|FD+~f8mbWQ8k|<##^RjCV^eks*)KWju9Di^SWmq`%IhNm z1P>gxXltD(lJvyyl8qK-J+^dx9xDJgi}=@HN}$6VVB&nQSl%d&^ljRex4Fx$#p?>=$$`f zq%aFO{Ew72nYyxsLyd9#So+*^e3|mthSSKn$JVx-+35aC?%SIt*Nt=>fq|Snq-nYp z%;(lR-C}UqB%Gbd!_OGQ)h+Bd(!k2f{n8ca?rWIUx+{#ENS5Br3l|r5cINGLoZa|n ztm~gh`8sOe)aXkV~FvObu*BFJDR`)hXj-8*ErUmMPAb$im;>=^J>c3;q^ z&VR`5bmjlF0L@{&Vpb0VhR*D6oqXixyOH;N-!;8uD)g?`czS_icYc-WE6|wLXmcWp z3={h|FVKWrF$*?$k~3QEELvK@ywj`@lBZ7#;u@7P0c7=-ixCDJK( z-F-XadQR;$YPn@27p}5j5apQuWs90h7<{l$H*2r^*pQw6<)a*oF6WBRc+T%6E(^M3Cbtg8EYJ|;WA>hyUS5@?-xclC`P25kxxd7kuC}}#-4lU2=Trr z!IB@VMG_`xxzzjp3#+C2&K=3!hWGt-D{~Cf4v-k6@(AnFt4ehz>6=VZtPBc?r;Tr6 zV+;NEvZopWTaOLq{$A9t!XY%0)h9oB8eK6#v_u5NvAn8X27zK9-h-^O-^c&xv_Pbsz>eY`SU0PUwv>6ah_Mg3#q+BwtKu%c8M%`eUB>F*s{ zysVcT-Q@(*aQohH6x}8T3~VI9Mlb&jG;Zl8Z6C4HZ%Y+L+iMpLaqrz##aZye-@Y2K zMOtNkR_WPFOVnV~XV{>_LPuXuO7JJRM<%syH^vGN=;Y8L=wv5p!$VSt=`Kc66z);t9tPYe9jP!a zSFHoANt2L1>1UDV*Pj@2iRJ9g9l%Q{ut2K+CbtnE+ZDwOX{{Vbsb0$3Fp;Hy;t|ae zs0M~;vkU*xe#kRtxi@jtrjL$qtKx@&YmqqcIqkI%{wH4~`odT1Iad4&P@+0`aRxfR zL&NGE37O<{h2*Lc;DkSeU}WncSzI{FBkfo zsy$7a0Hs9zS*>6s@q)gFkwkquPoV;5$yarwyq%CaXb=v2C z^V$Jjv*@&;>MwJk#3h;-yBs<%E{OZVpG1eKZN2CuESt?V;-ojTgF0x-Z#H7X4GpeQ z7Bwl}_}sYsy5@MeCmH&W$gZFYv+D$KZ)5kSe{G;hm8XGM+oYlI*0p~E@afy`O@(=O zw4MBq7|Y^Jl67cEUQtsE7{sgOcVPAtR}@jDp_z5^k`>~z zedYhpLdK&0_7<^?CET6B-M7}&E)}eL@h_1jBrn^>mN)g;CkLjz8D(9+%dMX>|SlrGqN z1tozf^cHiv1b>5zPqz<4bjChb(Wc%i$FBs>czzTN6_Vhrcgrdk;x&VmH@-d~K+}T6 zy`ZPtXeuWQX(*Et1+M|?J9#`NO&z+LbOb6k%2-(0XX`aZUlNWf%B>UnRdi?;I*9SR zKK{|&YY_Y67v;p(Bjlh{yCvc_Dv%yAM*z*RQy7|sdXWlTUOiq6s1SzmpUHxV1Sulp zx7jYFz+qg7Sj7qjQ%u@qt&h_>3rtOXvG>+G^95{7ixa5##9<2kVS}8$Id>NQj>Ac zU+Zy2)pgr-*R5N?fAzM!ZahdTT#8v_o97CQmhw+bDOLw*T`6BH^X;}D^=yk=e!I^N z_IS9q8w;a7+amIO=nbN^R)>}Zi z>Jup7*&ft!<@4gdO$R@U{D4T4@qVXE1r!4|6$03j?}0j|G^4*LJb@R|FKWamQY-$s z&T`Znbc&Ltw@cca%`!J%RkxKE7xv&}eUhh2T4(#asS~P?7RtqHJnd}zS)STyh}M~f zXe=jdYp@rt}0$(WS@R@g)&V@qgnZ!%kV2SO+8qD+2ri#-xw#+SY9a^hRy)&c=MVVy1$*1m-g zB}l)%&9u5h(^^4G@M+jszlRj7b(rxvV%WKMxtmVjTBqj!cGgHXLqCp32ZLxCk&Vk`0rIry3+Sn*Q*C z>^?oO0>(0~+2eOSfE5+i!0kd$z<-bK%M>JkOrTF7r$h7f*K4t*PahZ)h3Jueq&8{A zCR}%+p^uJK*@jrSAir0Q zudE?quKKwbIbyPy?Gc;?PRjVgNiF#{8TiXpSfMDn9g=@#Kqk!i%l$ML-~mCM7Xu!C@skI(I)Axh4|Cj*t$ZBc|4P(lYD6JzzLIDSU-&Z6 z*d>-Y4MLPV4LJfwLvTjpP`7{-yBN_#4+`WznQdHW+sB@e*J$)Xa%IG;u_L*#UttMH zhB7+<0GT1$4c~njQp>e_HSlNX)%oulk~of(*cbNg#Qy0l$hVaS*mqAH*EcCU;4q-Rh~J@W!e=m50Q6r zEZlsFF6q~ttrZdaFj=M1HgolS-)gctT3(JB9+CMbNl{x$f;C;%-P2MPY@Ve^M>%@d zSW^84ME(x5S#o(zaiEtl?Q{KRxK%fr)82=CXT-xOSxpo!sFdr`?-y47Rf>?%f;6wu zM`aG{_W3mQ`f$THsmhn;5W=ygZa#Gq{^Nv%*tpR5=EB3a>FSP>PPPNM3jQChhRZzH zo_t)wEZLq|CZg*{U_k7?WlLt{joqvyL=UqbW91b84rRahpt z5%=$Mvh_=;LMVFMOIuiRMbRvsvT3$rjxSVu1rC$gQK^@Cv{Oz{vb!9L-( zq$J^^L7QEY^FM^WYsajYHZ9eQs2^z7=gW<8bVHc(oF(_fF$xlL_sYdhr7WW;oPy$-Qvwd%TlCU6?}k_S5sNe$hd zt8V;Ex}#%4I6A7-FVJ_$w4S01g%qyK%e^GbA7sr?O?UN9EzGd6V1d5XWFx*Yrz%Fs z>{|}-GzBfwsLAuP+HENk%fuWuB>(vk-KUi`Mzn+Wn@OKQQ}qKXExy#-Hm+}APw)z* z8|ALCkuh1Kn`cDvRn@b!WzlvSd5d@W=?<4Av^sqforN(>T4h;{Wq^Z zQhZmf>tY`&a>#RA*E0+43fRk84L+&j(g)j2XW$jqGAP9tm@(Li0o5)d^_7vRZV0Aiyr7d#zQ1V zy6GK7Tct_G`Z&y^^>~u!wMDgHEf@31f67Ney-5Tj^e2U&HMB6PAMEUL*+Zt!HoCHI zv29v4d0vt2-%AStp<^sxFN@xCpJXWtUpraDmk`6BQwlqb3wToI1r)I%-uW zpP$>?HLu!t>s4lRsQQTGIj6YzREZS}d^N`zJrxiJ1P*7y_QfNIwwy-tws#qz_5n+_ zw02kO7TQa5<|@DUPs7j8qRb&~d$KZAc)y|hP%$Ps?}{HBlRFJ33ttD2YkLcR%{f)C zxgDSz4xUHLPQ?VbO2yw#7x&_6O5Y3CBSXE>3@g`97e)T_!GQ`$60=Q7SctCQvy+40 zv!})L49*>S`FGT=g*~;M?CA*E7F5`oKc{V{eEerjXKUxvu03V_hvp*u^KWu&W-kr$ zw#6fxucFI`S`;HajeF?bu8n)xMJJ{{?TaZ?k!-0Qx=x8@PA>kupu_IkNuHYbk9}hk z@&B5C*THVaIsui$rQYKYv?7JvxkEY zf#O8jMJzaeGP2jxNNu&0ox}r~+1^Ut=syAOTIJI7ej!k*FDn{*^6lQx%#2G9|FV74 zzwpN-FXzCM0}p@p*sk^5DqzIWd2btvq0O^#xLXkp-k<+1;Tjaqpl|u#9_tFS4hjCZ zS||QAJH371oX*B$Gg{;G_5EdETFsN#x{Wt`bI1C`K4f*3yc5+6@G)ZcM^5UnlYX}U zWFqjpKDi+m-9hl=?~+T{X7G>Q&Si%u)Ap-B(H!D0)7Djk@279N41S>%ojEGDQ>UEf z<<265&W&&06?qB7oLv6FXj9}47@#%z=HY15y6S6n#&R9;$Gl#?IM9V7tt-#f$;Rio9+&`epW8|?(WJj%IFKpUt zsaoW~+8$J_S5CGyX5K8cS~bB7`YNnz-QPYBByv@Kf}|S7BCl@GHMNbdezfv0@4i=i zb!sDoPfnHnb~C6?klm9iJD`C0M?0C#At*w(!>C4eU#=NuC!YNt${qGw>#Me%H}_f} z+>6^~e3ArewB=X4l)=`7U|{ULC&J-(ZtNwIUOh7m+74A>ugi1HE?u2!>OHaj-3^=x z9Ic3QsZ6#??#}N=l`DI-XdC~NNHX%ZR^s0_ea9u{!#z|M_`uSzGGSVSlh%X(#_@*& zF$a=K9c)emrZZ$K$bqMSSHWQ{!a$L3lglN;&7@sXeDUK3e^S$BxU>`ztGAT4`r-S<9(!`f_{$@=3o;YYt@7zvg{X^OS4ETH>f% zuTeH+Tpl76c3ZV|je%(af(*VvDY}YvmSs2#6BE5b%&OYAP{b>npF+$U z3~fC{8`|W3PEmhmb|BEP9HPIuPLuI$Ie$KH++72YccGk49=2ox{=cB(WH65x>L62O zOxxp#M&Rjxulix7S5|_cG*5@+8PAG&CW4x!&n9J564928bXGE6L<)pY^1lq9G221s zI8N#tywg$l4m~Ln<75Yy7>EW87MWK0s-~Px%={dUMAHr!5iy~V#lPulh{rSWxW~Yb>zk_#FTMKZp!2D&>3|cvKaB;k zKCiX!FQfOZHM%}bfF$dWx%?k~aO zuo8bhf6AFWYoSPT@(L_nU=S~EwFvQvU(bb+no?az+iu=}S=GYB(FBCNW5lSPo~Fy! zjPe$4UI1QlEv=2*Yz19ngf{YXI%}g#28MI%FMT5`Y9- zs|XiHTX0|l2BF!3ck%7_g(~DI(H6RF${~o@zn`?+`VL@QlnD2W@Llb(H&T~B|9*zG zxggEpy7TXEAlv+DYMPdLuQdnWb;I zPb>(GGMp`PERVMEas=oAN+QrCazS(8Qta*yX8UU>IzgpEyk7NG=7yX|uQi+3o$KX;O zyOYA1cM}J`PgRx9s%cRij+=@F;jM>zYco1rXKAN(YB5jXrsh}jtoJJPpy$fC2vE3e zp2Tg14*SV9THvV5tIgmbsYN7&jZvWQ?^54yk?Y_riO&LqWmZnk|6LVQ8@Qq2r+JW| z)j zwhVg7FAABcIcHx(%GA&r)!0-Xg{0PtpUy;j$v4 z7piPjlnNpA0yQaZ1ayOFm$4N#u9o>NlXdGZV%cc&gZ9=53cMoUh!Pq4uvB{st^?lr zn>I8uJ2JD{l6^1_OIw;aJI${%wv97kW#V`=I3};JJJLCvL{q}w6y>tP&*ZzT%7xVoMAgYeSNl$a%zSjOf@rKI zbcH#x#>5XU_l|lPCq>$pCVINMocU{Z+smM_wllHa1taV}SSoZY`$ASX3^0->C#EY1 zQC5HdcoCUyfXhUKl3jfm?t-|+)rtRB9T0M%yIS|yDE0LH z^MAGb<4IrP)d(iF;W1ul5@utU8FVlz0l|zUO81Z9jt`P}es$ zF3v%24>^zfQ^buAj+zPR%N_Fait2%bwTAh`9`?gdgGc9{r}Nw8f4V@&m%k|+e_PFb ztKA-emFcv8oBSp-yLBdx{ZoZi?7$4=iFZ7j+3Q5|&2+|zOr`|GbR2gk7^a!Uon`y1 zgHLY_&;5~S=BClhrgnSre^8(!4j%&8I#pQtd@H2r0w_5Q2|UU;BV4*IbNQn<83hW4 zLDu*@CRh6n%v(G`szPY{*?{0~1P8JhR?3O$sCDCxlARspGm&rky>0Cl)t`tR(OV4q zMy<~pH6!{VbP#=aaGyh5$@Xla+^4^>`weWv7Q7-5>}YO_gdxfW7?8WMWvWuhiUKX) zN@5#0afkDTnjYxHZs||AMCCx>9b0JP=cRuO9fhHq%^&`c1(<{hoYYH2y{woh=69a+ zjF&5Pj1bwPN!a?Yf3+Bl3idLqHis`V^!si<{mHI8JhbSn4tC$JI8oM2nx72N(ee*^@k z&K=xA?{9v1V<_G%rni7hHg7f7(yCpb=?1JB17?cQVY`7Nq*MFs6j`xf9B|s&5Wg`k zDJZe?sL-pVN!X8Tayy91O2ORXs7-Rr%9eCp-8zi=mWqfx`Yu~7sr$_hc$fk$9yCdZ z)j)=0_F^6dPG}Ef*<11V&LhyBwK;o1dJ*oI-_RN4Xf^=-?CJ|}ViFx4RVAwiax+$VdZDn(`dMw`qHpluTHJmWmYj5>n=9di646vSR3#(l2j$>E(QkL!bgRDUN3)?~Kx&gJ(st%`T2 z+$q+nnpEa2NC%;~)PDkSaiGqLs0B5V069Eis9K>)K^z3t13oFJ-t>OomE7k`J|sT zkK3GF$gzN^bumO-(*+VxAMgHI90X+pT{ySDn z&g`DzRcn-%+_+7GqB9%zsmblAqEM|H))Fm(r+3)&G5w$mEB0&s=z%0gpwjRtN;NEl z1?jYJUf#z%DQGe=SmCM5M<75e+~d0BDuC}x9Z4d0XseAksmA9TC51rM*AZI2`;A`F0EQ1e7$Xy*rOn+r6fBbz$B zxd&crJqiu1oG*MX8qX;=arBCD_R}be(cx9HIn!-8RS`-YRXjJh3>_(q-}1gDH&w%^ z;}j9&V`1dgW30tMOs`kI7XR`5wl-o|iGenx6<2)pbJU)aGM}+C``Azt_~0R@fM=8D zWn65mV0e4BO$AGM_(OY?oG^|%Dw!)IiRXxYmy#h1$?m$YuGi%w0Bs;KXpNnmODuY98?RR9lpb*1xg0&Q|X z=u=Wp?X9M!s8;`QO3fKq|cXEA?zcFbEMEI)8~`IT0HlU zG80XThxAH}WQH+mYavr#$T85OQxW*=oxQ0PD=y|l9!#b-yxf@VOY~XK-9}MrU<-0# zRA0ff*=`-%k9`8tN>j`rs(8f*1Q51R>VL1Ult-n!phIe6C&Gq##|dodD{-G7yi}36 zx9Ivj^H^G&egoQC_&uHxSG+mgWPR;^Z~GdR459uL3iC0|y_ZoRI~fF1$AAPD{&(!A z^lUEG`!gq~-zObLg#KH7ER40E|0ZdNm(4;@0}SLOA@Ce|5t?OSih+TqP$u&JGpxx} zWq4l4c8mK>$_KokgdnCYM*+Rdx!UKj%HK)l8KY)91KAvU?NxZ~=s*;iDvXDdU72<# z(t1(Hy@HKC$c=NbO=Kht&K1o)A|Wry=thv+Z0kp4<_4F0yIb)&dZ8l{cVX#+YxS+e z*INfyai3r&%NAU3VVDHVLkd%Jq7M6ag7_C zXhWmK)0&UC4_L7YGe!A|fqsnf3qH)Mp~8wVxn%wZN1Q|K(}RLfjx*jh6)MMBNo&<~ zIQWY0lB0M}y^8ODel%~sMxdE_Hq1Me>of_hua&3R?(Y_Ur!>zntr_!E6=UG zoOpYzJpki+GFm{b(UPO5{ekufO~`mbdgu1n(Ihdf#N|U$Zm(A60I6*iPWv*(qd0_P z)Hv7$Q$GJ?xQO>{@2|e%p9p|`INJ3SJXBAtIj*g%W!5! zU4(cu4X6@?sU+H?g_F6|(O0yjb|(rQL>U8e&njl%i;H24T6ONZdcXB>Vohx_6w-QE zmO38v3WSB%f%8>%XT_UkV|Dl%n(d?;(NR#}0ST;_JCTp|&YR}ubg^mn9{{)4YE}r2 z4XAzQ#M)H&JAG|z__~z@4J&J>3g7=TP{9K$abI0EIqJOZw7mJ?@;5l}yhu?m z^)*!T->=b`DW2+KMtklkEj_jRSDi%AQxywU%etV(`=qrrCt@hSxXdqukIF%+dTfm1 zXE(NQ+D;^e5Z+%hfMTtu4IkRnnF^t|~OTiYCY2Qt0cs{DSh zA)WFyk{>d6`U{KF5=IE#q1Q0u>UVknmqVjx)(ao0qo9agFemCUl+vEX%T?KXo8GIN zzM7c1>{wnbT4<8ibJ8|Bl~b;}h{NCGeBSm{)pdT1)Hd5NdKz-EwQU?Ve)@jxEm1@q zdIh}ewj5n4ft86Q?|MzK_ycZZJA2c@pea;b z+{DzC4**%*EnrRlC~3!QXsELrE_mA@0NH5EM*qYdKHcI(vK-fYlo2hprLI?Ja`Nz2 z#5#lEnS3%*WFfxY#Q_?D#Lo!a0)s{@?f| z&taaYKxKUq*- zbF32~fr6ZOe)h!@v_qCfs=!p{?&KyCpHLpmXW1_=&+If#o=8qe=@uJqY%*r<2qZV| z&abSkO=KRu2X7)DUh-}O7iHZP>+%_)uPD}rr_m+`x~EvS-hYik z^}JaJBQccdx~mpFr<_6W*Uu0|ai6z^y1(-YjWj^Q(ZfMUTgfOF(S;Qm>%- z-GT55G8__I0bR*q-}9%=b`o6OfHQtwJ|^?f&YW-&c?_ceaxm9y%YJuiQ?Yn@)vj5l zJ=N4~yKvN67Ua|ZC0b}~#iqnB*5*i78abaW-4z~C*SyZL6D@@_l*(D{bSuXT^|gi_ zB&HN$Ox8RcZe19YRM~=Lc}sj^S)(cgV^1x}wOP81!zNi5-rx5wMZ!1}%YIz{T-Xxc zEdb=)5(55b88(liTVn*U|5TzE!fAdP-bOBOHqSi?k!PXzlW2?B92NkMCks%NGLk^( zB%57?2xybTzxK6|aj`y*@t#-#l6QN_L^jivU#K{SY!Lj4QA|z%DPcAG%u=8{pWg@t z>IqmS3xMQ^U0XgU{}F2s8CZf$J55TBwqvz)M0SRceVq3Q4^7|S);QB6=K{CR&dWaj zlFrViOQ)Kz?AVMn$?DdHaXo~RuZ;&^WJsWlx@KgoEwjDWma-hh9Fn$W761SD6;Lfn zRCQV&6=USOZa@W4xRs?Gq!g-Un=7(}J|;U)0$B~7>83?7oq?#Voi%fO8SRrgaWz%h zx(K9vkt&P7g+u|b4A<$WS?y>BP~Y2hf-!@06~Mtp#gE(BKkE^Gu(tqlyO*w6Y)m%w z*{W=kyVp$|F&Jj}+b=G3w1LO&m`IfwB7aXHyk&_j8rTK;&opUymJm^%o(CK2~{?^2oXTdWkhkEef{Zq z8yRN=ZwIzcB`x<>GVA>@ZqRw^X4AOv8qc5wLA$0mN44~zOKf+;B&}jzY5p@y z&7UpXT1^5Hf(bN-cXUM0%b(49;^@Ani!=l@S0$A*>O%$R14j}${R^@KOQ$F3P zeyYQYorcfqL^woBldXW-zCyp084#}>z1<(iY-AI^j8|@m%uBAk57-M2ekdB?f0<>rxxw}Ly@CMw0dUJDqgd4s!JP(-{G6jT$s>R(&9th( zxn^OL=7xNN#<{`0`BQhFEI*tI*!^;lgH~%J*dp6$bD=y-z5htMa znc6Y0kX$8Dcb_!vVPkLkKe~8>%+2GS9Xp{R@ zuB$i?wO$EJrm9ZggX0--@k0uWCDLMBNSU^Ra0zAfSB_qMm2=r=(qU``Qi~L#9M)X*ou=5n=(N#8Ni!WHVs_)WdrHMeiNiH$UoH z+w_>i3iv(yDBbE*n{&7(ciOIw_ZIE}0uXv-YRpyuY3NVNN{`g4L@V^uqz;L3Rm}%S z5Ok#uAFq{$p+(U6EN01D9rc3_wft)@Q$9um7>7yjw4v(l78{}oLsG^;*aVP_5(^a` zm2LU(TkH}^Ldt`hD|Smco3Sa;wRzSs(k)L~Km#o?)To1RGAEpG+JbKy(}o-*SX|VV zZHh-9;rC&D$^w%)CNo|A1Eq^Xbd#uBNTHH^w^FZ@d|1KPNa z5&eNa&$@1gG!;xVM=)F)Me&>}({fRC=0h6^X<`cy(8+Uv7tg|r&4!Iyfd9;q$=r<- z{A;<~rZSp%M`0QDBWjLu0RfG#Y~Co=VY-a;|L%t`)rd`Rc2&GoMH*Jv1rlH0<}2w8 zp!Fo~N3Ab_i{`$tHT}r+|C9Pq{PZ}jvT-**Kil=q^E54OGQ_-;R!)BJ^5fVi<}cna zBPT_`1!0Tops>GML85g0dS;_Mi*29T#XD7mO-L->xDJM35Q{_@bZth1g5{e3phM9z z2)z?&iVcI+<5X@1Mp^(xllb>-Ru9E;Bl(j_cVkxj%pLhB{8GvI3=L<|kxs^fNsY5nTu*Y;F4th-wG4X*}n%NO+765#A zvW(fpJbn(Fv--}6ek0M}Pig%zy<4%8J{5~k^U=EY;QW4sb0h{PP`&`McM28}JNA19 z<0{B5qtUlUHa33cPuWfy5vdyoVx`z&4NOAv;0ZNYG*CzNs&tQsdh)U5K-dytBq#>M zEc%!|XlOW*vzw8)$-aa13M`C4gs%}O@p%?w=Fs6#u#Hz0tN(V7=mBh42s>Mbg^{Q* zvTJh-pKK@9G=dfzlemCHlcFNd{>CwNK-z+rB9`~#1o{}4Ct%9s#>@j zVdAvNs)HB(@q)d@T1q`kt{nwCnFCQ=-zp)4OEReN+0ARkgf%AhSu+XPDj(5P5n%em z`O!rm9`&tYx9#w#0`AFDoi=?ZMgqgIczXqk0(ty)_Ni>rdt*HKLzeh22>cTW8G8B| zcoPprrOb}}Vou;H1m`%LI&fvesk^BP2*c$9m6U zOAN6+O2_58qaqv3mK5z2VzT^;%O%R2HubjkjlrBhXA6IV0F&4D$#GIzWBQQnfNV0 z<+wgMqtjG*a_!w=oa4~ED$BpR3M5j6O!s3LvMJe+Or){K-jlwK=^lnqPTUFv&)xG^ z$|jHP?Fe)?u)alqlL(72Nm0IkitSc<2bS-v$Nh*IA^B4FO@I)mY2A10DbGeFp@gU^ zTGefbVy|?3wz)n^=D2VE*qB3023?H*f$uA)jg?vvE&Om}7QV_DFBpTtIB#7{!o<(T zVbT|)cGVnLArc$%$Qa$xB|A_E74C~s)(Buw2}nBiY?%7fZ3-AHq{#P6<`oXUysxCM*$+dajr` zy7wt4A|-TyfCW6M*LQ(p+0B7n&?iA4?4(OG|9exGA27L7PE9?#53+h60S_$uAC~(#X7+D?8*a6BxX9Unnnv#)0GKPOh^d{UYI#CQ zlE#PAO7wmksq(LztxwX@{ZjSyew~MR#KBcv{d0q9gL&Ydd0)2r)KhraIhQFlKCzA$jCRsO1q` zyQAC8UAyD@zP)`z^oNv(r~i5I-P3HB=jrFJh7UIKPqNMn22-D0y&eo{7*~twqFTM_ zB68$4Q4xt+gMPdxAGl5qf!s3;_17-6xNge8eGfFR+X0Un zVhWisgg5a=a3l>6L7x#bKWs3>EISfIv6}|uqw+_>&P-%ktTbeX>Ok2a~J?Ky=MV(bxg3QidtX2WHDhmLw0yy%eGh0*b4mJDg#n& zXSPO!P4A4XPKp9->Q=|R#8qUuQXoak#$&rL?JF)t3Z}DpRe9tpH*P_y_g-u4u-lHe zK_w>*pfmmYKSP#zsKstcls8s~wPJ4$k_lUK7J! zv?_2l(J2reDZhp6!WD05U@WWhsq~}o>kKl=XkNzut&guEGy4dn%h%sIFeEB#j^fJk z_RWOb7_6|k)x9ph@usQN0%H@hta`6AbE!Gwu&fMQY$YMj9$r;WAPjhOSkdJJ%z!vl zT~`59nr+1mjpg4ok6t32vP~M(=cY`5G-J zOMv&dpYrj_!$%4eSbGZgpv~*`Vj#`-$|{4((}_Jzk%zG({(HtqT;ohQJ<19Dv#bUxevr;XB) z{T8hQHyz9gKva<|j76%Cv0N79Zj_;8Oe}}89+6|OY~hbWPaG?Tm^^musfy{>F?X5$_RX5$}+m(4r$TBajf zAxra@2~`M?8*&_Vh}V+XY7K1up4Ez8>6U18PpO9@b<(yk%21lg4V$3I~p8>{fd)<4rWX5&xcx)!5$6W|9PZn+y4ohng^$sDR2 zoiz{XKo+a`;yjxpzSDO6ug3T@hNREDlGwdO=)Scp)4WA7MO=|))&?WEVpQL8(YY+U zKYj%DUpmkGyQ|3#1Bu!k33Vh9?>ga65V(9q&T#EYvMWP7q1JGOmJMAB_L$~art*hy zC$_=e5DG;Lq9YAdKDej}!#0_)vAQ?C-@Tx?6y_hw(7?TmjKj-zi)@}inH8`4qC_Aj z|L|dO)>ggq{PCs4ZIIUBXgcb%*A-)Yd)bs8A;7UhQtYQ>MKI=Bud8C+>)730kj#^K zd;8}+O{xEaFf!&fzE-;dK^S8aLoaLBCtk6_ecT*1)VM@zu&$vmemeLUMn}v&dgAm8 zRZNS~uYYDA=Z!iz2=SmqDP|c|0oiBW^$!Dr^h!*ja%WV&T*{2vTmnKXJ$$W3c9nCW zR$2Rs>9HFjGHj_%s}ty#pi>@6zrFT<6BRYa+D}AX#i)tOZie-rhrbxir@VOq1MDxN z+$T;Lohp-I%9}yNR*&q67(muTH9RKM>VtoDTBFZ&vHi(jdguFgU447nl65b7emHWB zF12pjnnaN$eBir>0H}P!jZ$``kQG)6`Lrb_E^rX2YiF~&WbEzmrm``A5Dn1- z$3l(+@gDlUKO9m>-VHK*1+M%*&7UlOS{fF`41ShtYsp1EUg$UoOmf7%ukkRNNiTD1 z1=eKv!L|FuUWV(qcNe=<@kvk$Zm&RphMVW$52B@9AlOPPl9CV^8%xj?aX?YD6|v{% zT`^$M58J8vw3xISyC|fLjOo6j4e7{>Ieov%KO~Y%O;%R8W?VV3JajbB@*A^jg$@N$Q@Z!Hcn}rP_da6d+ct}fL z5=aUKl$d@))GLLYe9LlE(lj9OR@5Kuw&ctWX*Dmk0a<-#K$i(;R-GrWTIgVL<;kn%!b=rflJT8qsh4lOKPm-fqKY6|GdOju z|F^;J@~M}Z#5|QPH~+cKN=Huezt4b;9^+EC#LVw*?)Sg*{Z0TsNdvQ}TQ~Wkb!vag zyRyu_#k8c$fC^r+!2?hW8Oow%HxJ?TQ!GW%C6T>9CkmZ<1xl?jZ&ad4PtQ5?^>cxL zy$%lEG%+wC%g>hrZ`p|%HA+jfTRhPn4q z=x9nA#2Cif#Tij$!2g27JDLog@v-s*mj;!%`mZ$WW*kFVH+jTe@WB_;!WFVOdLXO@ zYqh#v;D7A~Chj(Ye67K_?koL?U$K0C7LG@>ZMM+^VW0nAm_TmK8FFz!l&x$NB+x!R zGi*HPCP9|e0lL)bffqf$9E`w>)b_Y}L?_QowcDpfg0F`(YH}V^w{C?p9e+|Rw;DIE zj-e6oCyaRdx4xPmuZ}|(3!^2rfJMMzo?y#08aP+r5ny=I|_Wj&?- zT198M@=4&9nXCAW~!>$wUeS;Dj(qq5id5FKX)g5KpT$L<$b+L%}g^7|&cE6f=@ zlaT9vXTsQcI!v6~@XYcL(_+8a86<*p-NQ7ZOaj+dtQU53Nzj}z>{PTgu0AjD>Bt*Q z^ay(Mm44Y|P_P=Srq-SDqTdP||G;khfMNUSSLvbo+W)@Ip7{NG*WJG#0YLE63Vuvx z;65Dse`FQV*LGaH7dn`djOz}(*|_?}_%iq*@8t&Imkm4y`_1xn1RMg>Mfz$2&K2q? z(nLAi5LFJ-MHcaF`k&S<>;8)rd23k&)f4;37?q!L8cxx@k`kjZh0Pih6K31R8!7V3th2&R(PgOtY$0fFO*9_BuYj|mvjqTV?*ij zLQ~78%D*E4=egQPLF$u(ZHzu)6JPI6BfDQcrpKSXyoFb0WyFaUE==+#-FVeszL;SB zRnr8S);m=>e8aZbusX|=gChyd{k-G5+Mr$_dD#Q=ZnnVN7M}#1;-2T~S3{!~kX@fu z^}#EU)QL`|tF?n@cebyxb;m?DLAZ=eYjGSzRzise0SVicE{^Olb7K&gF;EIBS-U z3�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 IFS! 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

    r)q=%lJXLX-l4~;k;eyEY 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 Date: Tue, 4 Feb 2025 16:29:56 +0100 Subject: [PATCH 3025/3075] Add alt attributes --- _includes/online-courses-box.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_includes/online-courses-box.html b/_includes/online-courses-box.html index ef06306b9b..b7cf299928 100644 --- a/_includes/online-courses-box.html +++ b/_includes/online-courses-box.html @@ -2,7 +2,7 @@

    - + {{ include.image }}
    From 5b2d4d8df5fc334a5ea77f07ee57efdea24918d8 Mon Sep 17 00:00:00 2001 From: Alec Vercruysse Date: Tue, 4 Feb 2025 18:08:25 -0800 Subject: [PATCH 3026/3075] separate Scala 2/3 example for partial application in _tour/multiple-parameter-lists.md --- _tour/multiple-parameter-lists.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/_tour/multiple-parameter-lists.md b/_tour/multiple-parameter-lists.md index 632a5ab4fc..422f966978 100644 --- a/_tour/multiple-parameter-lists.md +++ b/_tour/multiple-parameter-lists.md @@ -143,9 +143,9 @@ When a method is called with a fewer number of parameter lists, then this will y For example, -{% tabs foldLeft_partial %} +{% tabs foldLeft_partial class=tabs-scala-version %} -{% tab 'Scala 2 and 3' for=foldLeft_partial %} +{% tab 'Scala 2' for=foldLeft_partial %} ```scala mdoc:nest val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) val numberFunc = numbers.foldLeft(List[Int]()) _ @@ -158,6 +158,19 @@ println(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) ``` {% endtab %} +{% tab 'Scala 3' for=foldLeft_partial %} +```scala mdoc:nest +val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) +val numberFunc = numbers.foldLeft(List[Int]()) + +val squares = numberFunc((xs, x) => xs :+ x*x) +println(squares) // List(1, 4, 9, 16, 25, 36, 49, 64, 81, 100) + +val cubes = numberFunc((xs, x) => xs :+ x*x*x) +println(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) +``` +{% endtab %} + {% endtabs %} ### Comparison with "currying" From f030f978dee729f1ac4dd51c007d7df1a16c6852 Mon Sep 17 00:00:00 2001 From: Alec Vercruysse Date: Tue, 4 Feb 2025 20:04:44 -0800 Subject: [PATCH 3027/3075] remove mdoc check of Scala 3 example in _tour/multiple-parameter-lists.md --- _tour/multiple-parameter-lists.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/multiple-parameter-lists.md b/_tour/multiple-parameter-lists.md index 422f966978..324795b6c0 100644 --- a/_tour/multiple-parameter-lists.md +++ b/_tour/multiple-parameter-lists.md @@ -159,7 +159,7 @@ println(cubes) // List(1, 8, 27, 64, 125, 216, 343, 512, 729, 1000) {% endtab %} {% tab 'Scala 3' for=foldLeft_partial %} -```scala mdoc:nest +```scala val numbers = List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10) val numberFunc = numbers.foldLeft(List[Int]()) From 66aa426cd243f8188ff1c05a6fb261f2e6a3b5a4 Mon Sep 17 00:00:00 2001 From: Jakub Pavlik Date: Sat, 8 Feb 2025 22:00:21 +0100 Subject: [PATCH 3028/3075] correct "with regards to" --- _tour/variances.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_tour/variances.md b/_tour/variances.md index 706a28ce14..14f40fb893 100644 --- a/_tour/variances.md +++ b/_tour/variances.md @@ -10,7 +10,7 @@ previous-page: generic-classes redirect_from: "/tutorials/tour/variances.html" --- -Variance lets you control how type parameters behave with regards to subtyping. Scala supports variance annotations of type parameters of [generic classes](generic-classes.html), to allow them to be covariant, contravariant, or invariant if no annotations are used. The use of variance in the type system allows us to make intuitive connections between complex types. +Variance lets you control how type parameters behave with regard to subtyping. Scala supports variance annotations of type parameters of [generic classes](generic-classes.html), to allow them to be covariant, contravariant, or invariant if no annotations are used. The use of variance in the type system allows us to make intuitive connections between complex types. {% tabs variances_1 %} {% tab 'Scala 2 and 3' for=variances_1 %} From 89777ba4d4ee0cee453ad85c4f147662e763ae88 Mon Sep 17 00:00:00 2001 From: Kevin Boyette Date: Wed, 12 Feb 2025 07:08:39 -0500 Subject: [PATCH 3029/3075] update os-lib versions in example --- _includes/_markdown/install-os-lib.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/_includes/_markdown/install-os-lib.md b/_includes/_markdown/install-os-lib.md index b62c5ce102..cba04a5e40 100644 --- a/_includes/_markdown/install-os-lib.md +++ b/_includes/_markdown/install-os-lib.md @@ -9,7 +9,7 @@ You can require the entire toolkit in a single line: Alternatively, you can require just a specific version of OS-Lib: ```scala -//> using dep com.lihaoyi::os-lib:0.9.1 +//> using dep com.lihaoyi::os-lib:0.11.3 ``` {% endtab %} {% tab 'sbt' %} @@ -17,29 +17,29 @@ In your `build.sbt`, you can add a dependency on the toolkit: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.3.4", - libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" + scalaVersion := "3.4.0", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.7.0" ) ``` Alternatively, you can require just a specific version of OS-Lib: ```scala -libraryDependencies += "com.lihaoyi" %% "os-lib" % "0.9.1" +libraryDependencies += "com.lihaoyi" %% "os-lib" % "0.11.3" ``` {% endtab %} {% tab 'Mill' %} In your `build.sc` file, you can add a dependency on the Toolkit: ```scala object example extends ScalaModule { - def scalaVersion = "3.3.4" + def scalaVersion = "3.4.0" def ivyDeps = Agg( - ivy"org.scala-lang::toolkit:0.1.7" + ivy"org.scala-lang::toolkit:0.7.0" ) } ``` Alternatively, you can require just a specific version of OS-Lib: ```scala -ivy"com.lihaoyi::os-lib:0.9.1" +ivy"com.lihaoyi::os-lib:0.11.3" ``` {% endtab %} {% endtabs %} From a7c122a53a1b04a59c2296ca8dee0145b9a5465c Mon Sep 17 00:00:00 2001 From: Kevin Boyette Date: Wed, 12 Feb 2025 09:58:28 -0500 Subject: [PATCH 3030/3075] update dependency versions in scala-cli examples --- _includes/_markdown/install-cask.md | 8 ++++---- _includes/_markdown/install-munit.md | 14 +++++++------- _includes/_markdown/install-os-lib.md | 4 ++-- _includes/_markdown/install-sttp.md | 14 +++++++------- _includes/_markdown/install-upickle.md | 14 +++++++------- 5 files changed, 27 insertions(+), 27 deletions(-) diff --git a/_includes/_markdown/install-cask.md b/_includes/_markdown/install-cask.md index 0424ce4ae6..3637ddfac9 100644 --- a/_includes/_markdown/install-cask.md +++ b/_includes/_markdown/install-cask.md @@ -5,7 +5,7 @@ {% tab 'Scala CLI' %} You can declare a dependency on Cask with the following `using` directive: ```scala -//> using dep com.lihaoyi::cask::0.9.2 +//> using dep com.lihaoyi::cask::0.10.2 ``` {% endtab %} @@ -15,7 +15,7 @@ In your `build.sbt`, you can add a dependency on Cask: lazy val example = project.in(file("example")) .settings( scalaVersion := "3.4.2", - libraryDependencies += "com.lihaoyi" %% "cask" % "0.9.2", + libraryDependencies += "com.lihaoyi" %% "cask" % "0.10.2", fork := true ) ``` @@ -25,9 +25,9 @@ lazy val example = project.in(file("example")) In your `build.sc`, you can add a dependency on Cask: ```scala object example extends RootModule with ScalaModule { - def scalaVersion = "3.3.4" + def scalaVersion = "3.4.2" def ivyDeps = Agg( - ivy"com.lihaoyi::cask::0.9.2" + ivy"com.lihaoyi::cask::0.10.2" ) } ``` diff --git a/_includes/_markdown/install-munit.md b/_includes/_markdown/install-munit.md index e1ebf130c9..47eeb1509f 100644 --- a/_includes/_markdown/install-munit.md +++ b/_includes/_markdown/install-munit.md @@ -10,7 +10,7 @@ MUnit, being a testing framework, is only available in test files: files in a `t Alternatively, you can require just a specific version of MUnit: ```scala -//> using dep org.scalameta::munit:1.0.3 +//> using dep org.scalameta::munit:1.1.0 ``` {% endtab %} {% tab 'sbt' %} @@ -18,8 +18,8 @@ In your build.sbt file, you can add the dependency on toolkit-test: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.3.4", - libraryDependencies += "org.scala-lang" %% "toolkit-test" % "0.1.7" % Test + scalaVersion := "3.4.2", + libraryDependencies += "org.scala-lang" %% "toolkit-test" % "0.7.0" % Test ) ``` @@ -27,18 +27,18 @@ Here the `Test` configuration means that the dependency is only used by the sour Alternatively, you can require just a specific version of MUnit: ```scala -libraryDependencies += "org.scalameta" %% "munit" % "1.0.3" % Test +libraryDependencies += "org.scalameta" %% "munit" % "1.1.0" % Test ``` {% endtab %} {% tab 'Mill' %} In your build.sc file, you can add a `test` object extending `Tests` and `TestModule.Munit`: ```scala object example extends ScalaModule { - def scalaVersion = "3.3.4" + def scalaVersion = "3.4.2" object test extends Tests with TestModule.Munit { def ivyDeps = Agg( - ivy"org.scala-lang::toolkit-test:0.1.7" + ivy"org.scala-lang::toolkit-test:0.7.0" ) } } @@ -46,7 +46,7 @@ object example extends ScalaModule { Alternatively, you can require just a specific version of MUnit: ```scala -ivy"org.scalameta::munit:1.0.3" +ivy"org.scalameta::munit:1.1.0" ``` {% endtab %} {% endtabs %} diff --git a/_includes/_markdown/install-os-lib.md b/_includes/_markdown/install-os-lib.md index cba04a5e40..ae254d9d71 100644 --- a/_includes/_markdown/install-os-lib.md +++ b/_includes/_markdown/install-os-lib.md @@ -17,7 +17,7 @@ In your `build.sbt`, you can add a dependency on the toolkit: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.4.0", + scalaVersion := "3.4.2", libraryDependencies += "org.scala-lang" %% "toolkit" % "0.7.0" ) ``` @@ -30,7 +30,7 @@ libraryDependencies += "com.lihaoyi" %% "os-lib" % "0.11.3" In your `build.sc` file, you can add a dependency on the Toolkit: ```scala object example extends ScalaModule { - def scalaVersion = "3.4.0" + def scalaVersion = "3.4.2" def ivyDeps = Agg( ivy"org.scala-lang::toolkit:0.7.0" diff --git a/_includes/_markdown/install-sttp.md b/_includes/_markdown/install-sttp.md index d23cf1c09a..ce7a805abd 100644 --- a/_includes/_markdown/install-sttp.md +++ b/_includes/_markdown/install-sttp.md @@ -9,7 +9,7 @@ You can require the entire toolkit in a single line: Alternatively, you can require just a specific version of sttp: ```scala -//> using dep com.softwaremill.sttp.client4::core:4.0.0-M6 +//> using dep com.softwaremill.sttp.client4::core:4.0.0-M26 ``` {% endtab %} {% tab 'sbt' %} @@ -17,30 +17,30 @@ In your build.sbt file, you can add a dependency on the Toolkit: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.3.4", - libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" + scalaVersion := "3.4.2", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.7.0" ) ``` Alternatively, you can require just a specific version of sttp: ```scala -libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-M6" +libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-M26" ``` {% endtab %} {% tab 'Mill' %} In your build.sc file, you can add a dependency on the Toolkit: ```scala object example extends ScalaModule { - def scalaVersion = "3.3.4" + def scalaVersion = "3.4.2" def ivyDeps = Agg( - ivy"org.scala-lang::toolkit:0.1.7" + ivy"org.scala-lang::toolkit:0.7.0" ) } ``` Alternatively, you can require just a specific version of sttp: ```scala -ivy"com.softwaremill.sttp.client4::core:4.0.0-M6" +ivy"com.softwaremill.sttp.client4::core:4.0.0-M26" ``` {% endtab %} {% endtabs %} diff --git a/_includes/_markdown/install-upickle.md b/_includes/_markdown/install-upickle.md index 5ae9fb9024..9f9cff8a62 100644 --- a/_includes/_markdown/install-upickle.md +++ b/_includes/_markdown/install-upickle.md @@ -9,7 +9,7 @@ Using Scala CLI, you can require the entire toolkit in a single line: Alternatively, you can require just a specific version of UPickle: ```scala -//> using dep com.lihaoyi::upickle:3.1.0 +//> using dep com.lihaoyi::upickle:4.1.0 ``` {% endtab %} {% tab 'sbt' %} @@ -17,29 +17,29 @@ In your build.sbt file, you can add the dependency on the Toolkit: ```scala lazy val example = project.in(file(".")) .settings( - scalaVersion := "3.3.4", - libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7" + scalaVersion := "3.4.2", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.7.0" ) ``` Alternatively, you can require just a specific version of UPickle: ```scala -libraryDependencies += "com.lihaoyi" %% "upickle" % "3.1.0" +libraryDependencies += "com.lihaoyi" %% "upickle" % "4.1.0" ``` {% endtab %} {% tab 'Mill' %} In your build.sc file, you can add the dependency to the upickle library: ```scala object example extends ScalaModule { - def scalaVersion = "3.3.4" + def scalaVersion = "3.4.2" def ivyDeps = Agg( - ivy"org.scala-lang::toolkit:0.1.7" + ivy"org.scala-lang::toolkit:0.7.0" ) } ``` Alternatively, you can require just a specific version of UPickle: ```scala -ivy"com.lihaoyi::upickle:3.1.0" +ivy"com.lihaoyi::upickle:4.1.0" ``` {% endtab %} {% endtabs %} From 9a2f399297537279395dba6bcc248db7fcce3072 Mon Sep 17 00:00:00 2001 From: Jakub Pavlik Date: Wed, 12 Feb 2025 20:47:09 +0100 Subject: [PATCH 3031/3075] Tour: delete references to the long gone "Run" button --- _es/tour/basics.md | 2 -- _ja/tour/basics.md | 3 --- _ko/tour/basics.md | 2 -- _pl/tour/basics.md | 3 --- _ru/tour/basics.md | 3 --- _th/tour/basics.md | 2 -- _tour/basics.md | 2 -- _zh-cn/tour/basics.md | 2 -- 8 files changed, 19 deletions(-) diff --git a/_es/tour/basics.md b/_es/tour/basics.md index cbbe76a021..484470a508 100644 --- a/_es/tour/basics.md +++ b/_es/tour/basics.md @@ -21,8 +21,6 @@ Puedes ejecutar Scala en tu navegador con Scastie. Así, de manera fácil y sin preparación, puedes probar fragmentos de código Scala. -Muchos ejemplos de código en esta documentación están integrados con Scastie, y así puedes probarlos directamente solo con pulsar el botón "Run". - ## Expresiones Las expresiones son sentencias computables. diff --git a/_ja/tour/basics.md b/_ja/tour/basics.md index 40123f7faa..1f109c930d 100644 --- a/_ja/tour/basics.md +++ b/_ja/tour/basics.md @@ -20,9 +20,6 @@ Scastieを利用することでブラウザ上でScalaを実行することが このサイトを使えば、簡単にセットアップせずScalaのコードの一部を試すことができます。 -このドキュメントの多くのコードの例はScastieで開発されています。 -そのため、サンプルコード内のRunボタンをクリックするだけで、そのまま簡単にコードを試すことができます。 - ## 式 式は計算可能な文です。 diff --git a/_ko/tour/basics.md b/_ko/tour/basics.md index 033592c302..b0d0fda55c 100644 --- a/_ko/tour/basics.md +++ b/_ko/tour/basics.md @@ -22,8 +22,6 @@ Scastie를 사용하면 브라우저에서 스칼라를 실행해 볼 수 있다 이는 설정 없이 스칼라 코드들을 손쉽게 실험할 수 있는 방법이다. -이 페이지의 많은 예제 코드가 Scastie와 통합되어 있어 간단히 실행 버튼만 눌러 직접 실험해 볼 수 있다. - ## 표현식 표현식은 연산 가능한 명령문이다. diff --git a/_pl/tour/basics.md b/_pl/tour/basics.md index 816fd5893a..44ea200457 100644 --- a/_pl/tour/basics.md +++ b/_pl/tour/basics.md @@ -21,9 +21,6 @@ Dzięki Scastie możesz uruchomić Scalę w swojej przeglądarce. Jest to prosta i niewymagająca żadnej instalacji metoda do eksperymentowania z kodem w Scali. -Wiele przykładów kodu w tym przewodniku jest również zintegrowana ze Scastie, -dzięki czemu można je wypróbować wciskając po prostu przycisk "Run". - ## Wyrażenia Wyrażenia są rezultatem ewaluacji fragmentów kodu. diff --git a/_ru/tour/basics.md b/_ru/tour/basics.md index ecd5595830..3d8590bfe7 100644 --- a/_ru/tour/basics.md +++ b/_ru/tour/basics.md @@ -20,9 +20,6 @@ previous-page: tour-of-scala Это простой способ поэкспериментировать со Scala кодом без всяких настроек. -Большинство примеров кода в этой документации также интегрированы с Scastie, -поэтому вы можете поэкспериментировать с ними, просто нажав кнопку Run. - ## Выражения Выражения — это вычислимые утверждения. diff --git a/_th/tour/basics.md b/_th/tour/basics.md index 29f05e62fd..273161fd6a 100644 --- a/_th/tour/basics.md +++ b/_th/tour/basics.md @@ -23,8 +23,6 @@ In this page, we will cover basics of Scala. ในขั้นตอนนี้ง่ายมาก ที่จะได้ประสบการณ์ของเรากับ Scala -หลายๆ โค้ดตัวอย่างในเอกสารนี้จะฝังใน Scastie ซึ่งคุณสามารถกดที่ปุ่ม Run เพื่อดูว่าโด้นนั้นๆ จะได้ผลลัพธ์อย่างไร - ## Expressions Expression หรือ นิพจน์ เป็นโค้ดที่ทำการคำนวนได้ diff --git a/_tour/basics.md b/_tour/basics.md index f7cb96c667..ccfb324feb 100644 --- a/_tour/basics.md +++ b/_tour/basics.md @@ -20,8 +20,6 @@ You can run Scala in your browser with _Scastie_. This is an easy, zero-setup wa 2. Paste `println("Hello, world!")` in the left pane. 3. Click __Run__. The output appears in the right pane. -_Scastie_ is integrated with some of the code examples in this documentation; if you see a __Run__ button in a code example below, click it to directly experiment with the code. - ## Expressions Expressions are computable statements: diff --git a/_zh-cn/tour/basics.md b/_zh-cn/tour/basics.md index 6c9d42321a..a7f9c3bf0a 100644 --- a/_zh-cn/tour/basics.md +++ b/_zh-cn/tour/basics.md @@ -22,8 +22,6 @@ previous-page: tour-of-scala 这是一种简单的、零设置的方法来实践Scala的代码片段。 -这篇文档中的大部分代码示例与 Scastie 进行了集成，可以通过点击 “Run” 按钮即来直接运行 Scala 代码。 - ## 表达式 表达式是可计算的语句。 From 0d5623766929d39a38c16f1d057c087d0a2e2218 Mon Sep 17 00:00:00 2001 From: Jakub Pavlik Date: Wed, 12 Feb 2025 21:07:00 +0100 Subject: [PATCH 3032/3075] drop link to a removed feed --- _includes/headertop.html | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_includes/headertop.html b/_includes/headertop.html index aa8efa7835..19440aff66 100644 --- a/_includes/headertop.html +++ b/_includes/headertop.html @@ -56,8 +56,7 @@ - - + From a29c86d4327788cc2de78a0df9ca2184e05f816c Mon Sep 17 00:00:00 2001 From: adpi2 Date: Thu, 13 Feb 2025 09:45:16 +0100 Subject: [PATCH 3033/3075] Update install-sttp.md --- _includes/_markdown/install-sttp.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_includes/_markdown/install-sttp.md b/_includes/_markdown/install-sttp.md index ce7a805abd..0173ec47e1 100644 --- a/_includes/_markdown/install-sttp.md +++ b/_includes/_markdown/install-sttp.md @@ -9,7 +9,7 @@ You can require the entire toolkit in a single line: Alternatively, you can require just a specific version of sttp: ```scala -//> using dep com.softwaremill.sttp.client4::core:4.0.0-M26 +//> using dep com.softwaremill.sttp.client4::core:4.0.0-RC1 ``` {% endtab %} {% tab 'sbt' %} @@ -24,7 +24,7 @@ lazy val example = project.in(file(".")) Alternatively, you can require just a specific version of sttp: ```scala -libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-M26" +libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-RC1" ``` {% endtab %} {% tab 'Mill' %} @@ -40,7 +40,7 @@ object example extends ScalaModule { ``` Alternatively, you can require just a specific version of sttp: ```scala -ivy"com.softwaremill.sttp.client4::core:4.0.0-M26" +ivy"com.softwaremill.sttp.client4::core:4.0.0-RC1" ``` {% endtab %} {% endtabs %} From d9077bb29c7477ac2cc438235e3a0a670b6dec30 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 19 Feb 2025 13:59:13 +0000 Subject: [PATCH 3034/3075] Bump nokogiri from 1.16.7 to 1.18.3 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.16.7 to 1.18.3. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/v1.18.3/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.16.7...v1.18.3) --- updated-dependencies: - dependency-name: nokogiri dependency-type: indirect ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 4f956e6336..1040918882 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -239,11 +239,11 @@ GEM minitest (5.25.1) net-http (0.4.1) uri - nokogiri (1.16.7-arm64-darwin) + nokogiri (1.18.3-arm64-darwin) racc (~> 1.4) - nokogiri (1.16.7-x64-mingw-ucrt) + nokogiri (1.18.3-x64-mingw-ucrt) racc (~> 1.4) - nokogiri (1.16.7-x86_64-linux) + nokogiri (1.18.3-x86_64-linux-gnu) racc (~> 1.4) octokit (4.25.1) faraday (>= 1, < 3) From 4cdb87a9307538daf1f28c8367cef1389181bc18 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Sat, 22 Feb 2025 00:27:11 +0000 Subject: [PATCH 3035/3075] Update SIPs state --- _sips/sips/better-fors.md | 108 +++++++++++++++++- ...-compatibility-with-existing-code-bases.md | 4 +- 2 files changed, 106 insertions(+), 6 deletions(-) diff --git a/_sips/sips/better-fors.md b/_sips/sips/better-fors.md index 3fd1ebbd94..54ba1b8e31 100644 --- a/_sips/sips/better-fors.md +++ b/_sips/sips/better-fors.md @@ -10,10 +10,11 @@ title: SIP-62 - For comprehension improvements ## History -| Date | Version | -|---------------|--------------------| -| June 6th 2023 | Initial Draft | -| Feb 15th 2024 | Reviewed Version | +| Date | Version | +|---------------|------------------------| +| June 6th 2023 | Initial Draft | +| Feb 15th 2024 | Reviewed Version | +| Nov 21th 2024 | Addendum for change 3. | ## Summary @@ -333,6 +334,60 @@ doSth(arg).map { a => This change is strictly an optimization. This allows for the compiler to get rid of the final `map` call, if the yielded value is the same as the last bound pattern. The pattern can be either a single variable binding or a tuple. +This optimization should be done after type checking (e.g. around first transform). See the reasons to why it cannot be done in desugaring in [here](#previous-design-in-desugaring). + +We propose an approach where an attachment (`TrailingForMap`) is attached to the last `map` `Apply` node. After that, a later phase will look for `Apply` nodes with this attachment and possibly remove the `map` call. + +The condition for allowing to remove the last map call (for a binding `pat <- gen yield pat1`) are as follows: +- `pat` is (syntactically) equivalent to `pat1` ($pat =_{s} pat1$) + + where + + $x =_{s} x, \text{if x is a variable reference}$ + + $x =_{s} (), \text{if x is a variable reference of type Unit}$ + + $(x_1, ..., x_n) =_{s} (y_1, ..., y_n) \iff \forall i \in n.\; x_i =_{s} y_i$ + + This means that the two patterns are equivalent if they are the same variable, if they are tuples of the same variables, or if one is a variable reference of type `Unit` and the other is a `Unit` literal. +- `pat` and `pat1` have the same types (`pat.tpe` =:= `pat1.tpe`) + +##### Changes discussion + +This adresses the problem of changing the resulting type after removing trailing `map` calls. + +There are two main changes compared to the previous design: +1. Moving the implementation to the later phase, to be able to use the type information and explicitly checking that the types are the same. +2. Allowing to remove the last `map` call if the yielded value is a `Unit` literal (and obviously the type doesn't change). + +The motivation for the second change is to avoid potential memory leaks in effecting loops. e.g. + +```scala +//> using scala 3.3.3 +//> using lib "dev.zio::zio:2.1.5" + +import zio.* + +def loop: Task[Unit] = + for + _ <- Console.print("loop") + _ <- loop + yield () + +@main +def run = + val runtime = Runtime.default + Unsafe.unsafe { implicit unsafe => + runtime.unsafe.run(loop).getOrThrowFiberFailure() + } +``` + +This kind of effect loop is pretty commonly used in Scala FP programs and often ends in `yield ()`. + +The problem with the desugaring of this for-comprehensions is that it leaks memory because the result of `loop` has to be mapped over with `_ => ()`, which often does nothing. + +##### Previous design (in desugaring) + One desugaring rule has to be modified for this purpose. ```scala @@ -356,6 +411,46 @@ will just be desugared to List(1, 2, 3) ``` +**Cause of change** + +This design ended up breaking quite a few existing projects in the open community build run. + +For example, consider the following code: + +```scala +//> using scala 3.nightly + +import scala.language.experimental.betterFors + +case class Container[A](val value: A) { + def map[B](f: A => B): Container[B] = Container(f(value)) +} + +sealed trait Animal +case class Dog() extends Animal + +def opOnDog(dog: Container[Dog]): Container[Animal] = + for + v <- dog + yield v +``` + +With the new desugaring, the code gave an error about type mismatch. + +```scala +-- [E007] Type Mismatch Error: /home/kpi/bugs/better-fors-bug.scala:13:2 ------- +13 | for + | ^ + | Found: (dog : Container[Dog]) + | Required: Container[Animal] +14 | v <- dog +15 | yield v + | + | longer explanation available when compiling with `-explain` +``` + +This is because the container is invariant. And even though the last `map` was an identity function, it was used to upcast `Dog` to `Animal`. + ### Compatibility This change may change the semantics of some programs. It may remove some `map` calls in the desugared code, which may change the program semantics (if the `map` implementation was side-effecting). @@ -372,6 +467,8 @@ yield a + b As far as I know, there are no widely used Scala 3 libraries that depend on the desugaring specification of `for`-comprehensions. +The only Open community build library that failed because of the change to the desugaring specification is [`avocADO`](https://github.com/VirtusLab/avocado). + ## Links 1. Scala contributors discussion thread (pre-SIP): https://contributors.scala-lang.org/t/pre-sip-improve-for-comprehensions-functionality/3509/51 @@ -379,3 +476,6 @@ As far as I know, there are no widely used Scala 3 libraries that depend on the 3. Scala 2 implementation of some of the improvements: https://github.com/oleg-py/better-monadic-for 4. Implementation of one of the simplifications: https://github.com/lampepfl/dotty/pull/16703 5. Draft implementation branch: https://github.com/dotty-staging/dotty/tree/improved-fors +6. Minimized issue reproducing the problem with the current desugaring: https://github.com/scala/scala3/issues/21804 +7. (empty :sad:) Contributors thread about better effect loops with for-comprehensions: https://contributors.scala-lang.org/t/pre-sip-sip-62-addition-proposal-better-effect-loops-with-for-comprehensions/6759 +8. Draft implementation of dropping the last map call after type checking (only for `Unit` literals): https://github.com/KacperFKorban/dotty/commit/31cbd4744b9375443a0770a8b8a9d16de694c6bb#diff-ed248bb93940ea4f38e6da698051f882e81df6f33fea91a046d1d4f6af506296R2066 diff --git a/_sips/sips/improve-strictequality-feature-for-better-compatibility-with-existing-code-bases.md b/_sips/sips/improve-strictequality-feature-for-better-compatibility-with-existing-code-bases.md index 689849a3d6..29276bba12 100644 --- a/_sips/sips/improve-strictequality-feature-for-better-compatibility-with-existing-code-bases.md +++ b/_sips/sips/improve-strictequality-feature-for-better-compatibility-with-existing-code-bases.md @@ -1,8 +1,8 @@ --- title: SIP-67 - Improve strictEquality feature for better compatibility with existing code bases -status: under-review +status: waiting-for-implementation pull-request-number: 97 -stage: design +stage: implementation --- From 0d68382c13061d1d07816580efc82a86d66abbd9 Mon Sep 17 00:00:00 2001 From: Lukas Rytz Date: Tue, 7 May 2024 19:21:51 +0200 Subject: [PATCH 3036/3075] Update FAQ on initialization order --- _overviews/FAQ/initialization-order.md | 148 ++++++++++++------------- 1 file changed, 72 insertions(+), 76 deletions(-) diff --git a/_overviews/FAQ/initialization-order.md b/_overviews/FAQ/initialization-order.md index 787281f0db..3caa2b5b72 100644 --- a/_overviews/FAQ/initialization-order.md +++ b/_overviews/FAQ/initialization-order.md @@ -7,7 +7,7 @@ permalink: /tutorials/FAQ/:title.html ## Example -To understand the problem, let's pick the following concrete example. +The following example illustrates the problem: abstract class A { val x1: String @@ -26,7 +26,7 @@ To understand the problem, let's pick the following concrete example. println("C: " + x1 + ", " + x2) } -Let's observe the initialization order through the Scala REPL: +In the Scala REPL we observe: scala> new C A: null, null @@ -36,51 +36,50 @@ Let's observe the initialization order through the Scala REPL: Only when we get to the constructor of `C` are both `x1` and `x2` initialized. Therefore, constructors of `A` and `B` risk running into `NullPointerException`s. ## Explanation -A 'strict' or 'eager' val is one which is not marked lazy. -In the absence of "early definitions" (see below), initialization of strict vals is done in the following order. +A "strict" or "eager" val is one which is not marked lazy. +Initialization of strict vals is done in the following order: 1. Superclasses are fully initialized before subclasses. 2. Otherwise, in declaration order. -Naturally when a val is overridden, it is not initialized more than once. So though x2 in the above example is seemingly defined at every point, this is not the case: an overridden val will appear to be null during the construction of superclasses, as will an abstract val. +When a `val` is overridden, in fact its accessor method (the "getter") is overridden. +So the access to `x2` in class `A` in fact invokes the overridden getter in class `C` which reads the underlying field `C.x2`. +This field is not yet initialized during the construction of `A`. -There is a compiler flag which can be useful for identifying this situation: +## Mitigation -**-Xcheckinit**: Add runtime check to field accessors. +The [`-Ysafe-init` compiler flag](https://docs.scala-lang.org/scala3/reference/other-new-features/safe-initialization.html) in Scala 3 enables compiler warnings for accesses to uninitialized fields: -It is inadvisable to use this flag outside of testing. It adds significantly to the code size by putting a wrapper around all potentially uninitialized field accesses: the wrapper will throw an exception rather than allow a null (or 0/false in the case of primitive types) to silently appear. Note also that this adds a *runtime* check: it can only tell you anything about code paths which you exercise with it in place. + -- Warning: Test.scala:8:6 ------------------ + 8 | val x1: String = "hello" + | ^ + | Access non-initialized value x1. Calling trace: + | ├── class B extends A { [ Test.scala:7 ] + | │ ^ + | ├── abstract class A { [ Test.scala:1 ] + | │ ^ + | └── println("A: " + x1 + ", " + x2) [ Test.scala:5 ] + | ^^ -Using it on the opening example: +In Scala 2, the `-Xcheckinit` flag adds runtime checks in the generated bytecode to identify accesses of uninitialized fields. +The code then throws an exception rather than allowing a `null` (or `0` / `false` in the case of primitive types) to silently appear. +Note that these runtime checks only test code that is actually exectued at runtime. +The flag can be helpful to find accesses to uninitialized fields, but it should never be used in production due to its performance overhead. - % scalac -Xcheckinit a.scala - % scala -e 'new C' - scala.UninitializedFieldError: Uninitialized field: a.scala: 13 - at C.x2(a.scala:13) - at A.(a.scala:5) - at B.(a.scala:7) - at C.(a.scala:12) - -### Solutions ### +## Solutions Approaches for avoiding null values include: -#### Use lazy vals #### - - abstract class A { - val x1: String - lazy val x2: String = "mom" +### Use class / trait parameters + abstract class A(val x1: String, val x2: String = "mom") { println("A: " + x1 + ", " + x2) } - class B extends A { - lazy val x1: String = "hello" - + class B(x1: String = "hello", x2: String = "mom") extends A(x1, x2) { println("B: " + x1 + ", " + x2) } - class C extends B { - override lazy val x2: String = "dad" - + class C(x2: String = "dad") extends B(x2 = x2) { println("C: " + x1 + ", " + x2) } // scala> new C @@ -88,31 +87,29 @@ Approaches for avoiding null values include: // B: hello, dad // C: hello, dad -Usually the best answer. Unfortunately you cannot declare an abstract lazy val. If that is what you're after, your options include: +Values passed as parameters to the superclass constructor are available in its body. -1. Declare an abstract strict val, and hope subclasses will implement it as a lazy val or with an early definition. If they do not, it will appear to be uninitialized at some points during construction. -2. Declare an abstract def, and hope subclasses will implement it as a lazy val. If they do not, it will be re-evaluated on every access. -3. Declare a concrete lazy val which throws an exception, and hope subclasses override it. If they do not, it will... throw an exception. +Scala 3 also [supports trait parameters](https://docs.scala-lang.org/scala3/reference/other-new-features/trait-parameters.html). -An exception during initialization of a lazy val will cause the right-hand side to be re-evaluated on the next access: see SLS 5.2. +Note that overriding a `val` class parameter is deprecated / disallowed in Scala 3. +Doing so in Scala 2 can lead to surprising behavior. -Note that using multiple lazy vals creates a new risk: cycles among lazy vals can result in a stack overflow on first access. +### Use lazy vals -#### Use early definitions #### abstract class A { - val x1: String - val x2: String = "mom" + lazy val x1: String + lazy val x2: String = "mom" println("A: " + x1 + ", " + x2) } - class B extends { - val x1: String = "hello" - } with A { + class B extends A { + lazy val x1: String = "hello" + println("B: " + x1 + ", " + x2) } - class C extends { - override val x2: String = "dad" - } with B { + class C extends B { + override lazy val x2: String = "dad" + println("C: " + x1 + ", " + x2) } // scala> new C @@ -120,45 +117,44 @@ Note that using multiple lazy vals creates a new risk: cycles among lazy vals ca // B: hello, dad // C: hello, dad -Early definitions are a bit unwieldy, there are limitations as to what can appear and what can be referenced in an early definitions block, and they don't compose as well as lazy vals: but if a lazy val is undesirable, they present another option. They are specified in SLS 5.1.6. +Note that abstract `lazy val`s are supported in Scala 3, but not in Scala 2. +In Scala 2, you can define an abstract `val` or `def` instead. -Note that early definitions are deprecated in Scala 2.13; they will be replaced by trait parameters in Scala 3. So, early definitions are not recommended for use if future compatibility is a concern. +An exception during initialization of a lazy val will cause the right-hand side to be re-evaluated on the next access: see SLS 5.2. -#### Use constant value definitions #### - abstract class A { - val x1: String - val x2: String = "mom" +Note that using multiple lazy vals creates a new risk: cycles among lazy vals can result in a stack overflow on first access. - println("A: " + x1 + ", " + x2) - } - class B extends A { - val x1: String = "hello" - final val x3 = "goodbye" +### Use a nested object - println("B: " + x1 + ", " + x2) - } - class C extends B { - override val x2: String = "dad" +Sometimes, uninitialized state in a subclass is accessed during construction of a superclass: - println("C: " + x1 + ", " + x2) + class Adder { + var sum = 0 + def add(x: Int): Unit = sum += x + add(1) } - abstract class D { - val c: C - val x3 = c.x3 // no exceptions! - println("D: " + c + " but " + x3) + class LogAdder extends Adder { + private var added: Set[Int] = Set.empty + override def add(x: Int): Unit = { added += x; super.add(x) } } - class E extends D { - val c = new C - println(s"E: ${c.x1}, ${c.x2}, and $x3...") + +In this case the state can be initialized on demand by wrapping it into a local object: + + class Adder { + var sum = 0 + def add(x: Int): Unit = sum += x + add(1) } - //scala> new E - //D: null but goodbye - //A: null, null - //B: hello, null - //C: hello, dad - //E: hello, dad, and goodbye... + class LogAdder extends Adder { + private object state { + var added: Set[Int] = Set.empty + } + import state._ + override def add(x: Int): Unit = { added += x; super.add(x) } + } + +### Early definitions: deprecated -Sometimes all you need from an interface is a compile-time constant. +Scala 2 supports early definitinos, but they are deprecated in Scala 2.13 and unsupported in Scala 3. +See the [migration guide](https://docs.scala-lang.org/scala3/guides/migration/incompat-dropped-features.html#early-initializer) for more information. -Constant values are stricter than strict and earlier than early definitions and have even more limitations, -as they must be constants. They are specified in SLS 4.1. From 19967a96c7cf8ed92f76788cda107ceb5d377c46 Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Sat, 22 Feb 2025 02:11:11 -0800 Subject: [PATCH 3037/3075] More words for initialization FAQ --- _overviews/FAQ/initialization-order.md | 68 +++++++++++++++++--------- 1 file changed, 44 insertions(+), 24 deletions(-) diff --git a/_overviews/FAQ/initialization-order.md b/_overviews/FAQ/initialization-order.md index 3caa2b5b72..ebe07308c6 100644 --- a/_overviews/FAQ/initialization-order.md +++ b/_overviews/FAQ/initialization-order.md @@ -7,23 +7,26 @@ permalink: /tutorials/FAQ/:title.html ## Example -The following example illustrates the problem: +The following example illustrates how classes in a subclass relation +witness the initialization of two fields which are inherited from +their top-most parent. The values are printed during the constructor +of each class, that is, when an instance is initialized. abstract class A { val x1: String val x2: String = "mom" - println("A: " + x1 + ", " + x2) + println(s"A: $x1, $x2") } class B extends A { val x1: String = "hello" - println("B: " + x1 + ", " + x2) + println(s"B: $x1, $x2") } class C extends B { override val x2: String = "dad" - println("C: " + x1 + ", " + x2) + println(s"C: $x1, $x2") } In the Scala REPL we observe: @@ -33,39 +36,46 @@ In the Scala REPL we observe: B: hello, null C: hello, dad -Only when we get to the constructor of `C` are both `x1` and `x2` initialized. Therefore, constructors of `A` and `B` risk running into `NullPointerException`s. +Only when we get to the constructor of `C` are both `x1` and `x2` properly initialized. +Therefore, constructors of `A` and `B` risk running into `NullPointerException`s, +since fields are null-valued until set by a constructor. ## Explanation -A "strict" or "eager" val is one which is not marked lazy. +A "strict" or "eager" val is a `val` which is not a `lazy val`. Initialization of strict vals is done in the following order: 1. Superclasses are fully initialized before subclasses. -2. Otherwise, in declaration order. +2. Within the body or "template" of a class, vals are initialized in declaration order, + the order in which they are written in source. -When a `val` is overridden, in fact its accessor method (the "getter") is overridden. -So the access to `x2` in class `A` in fact invokes the overridden getter in class `C` which reads the underlying field `C.x2`. +When a `val` is overridden, it's more precise to say that its accessor method (the "getter") is overridden. +So the access to `x2` in class `A` invokes the overridden getter in class `C`. +That getter reads the underlying field `C.x2`. This field is not yet initialized during the construction of `A`. ## Mitigation -The [`-Ysafe-init` compiler flag](https://docs.scala-lang.org/scala3/reference/other-new-features/safe-initialization.html) in Scala 3 enables compiler warnings for accesses to uninitialized fields: +The [`-Wsafe-init` compiler flag](https://docs.scala-lang.org/scala3/reference/other-new-features/safe-initialization.html) +in Scala 3 enables a compile-time warning for accesses to uninitialized fields: - -- Warning: Test.scala:8:6 ------------------ + -- Warning: Test.scala:8:6 ----------------------------------------------------- 8 | val x1: String = "hello" | ^ | Access non-initialized value x1. Calling trace: - | ├── class B extends A { [ Test.scala:7 ] + | ├── class B extends A { [ Test.scala:7 ] | │ ^ - | ├── abstract class A { [ Test.scala:1 ] + | ├── abstract class A { [ Test.scala:1 ] | │ ^ - | └── println("A: " + x1 + ", " + x2) [ Test.scala:5 ] - | ^^ + | └── println(s"A: $x1, $x2") [ Test.scala:5 ] + | ^^ In Scala 2, the `-Xcheckinit` flag adds runtime checks in the generated bytecode to identify accesses of uninitialized fields. -The code then throws an exception rather than allowing a `null` (or `0` / `false` in the case of primitive types) to silently appear. -Note that these runtime checks only test code that is actually exectued at runtime. -The flag can be helpful to find accesses to uninitialized fields, but it should never be used in production due to its performance overhead. +That code throws an exception when an uninitialized field is referenced +that would otherwise be used as a `null` value (or `0` or `false` in the case of primitive types). +Note that these runtime checks only report code that is actually executed at runtime. +Although these checks can be helpful to find accesses to uninitialized fields during development, +it is never advisable to enable them in production code due to the performance cost. ## Solutions @@ -120,25 +130,31 @@ Doing so in Scala 2 can lead to surprising behavior. Note that abstract `lazy val`s are supported in Scala 3, but not in Scala 2. In Scala 2, you can define an abstract `val` or `def` instead. -An exception during initialization of a lazy val will cause the right-hand side to be re-evaluated on the next access: see SLS 5.2. +An exception during initialization of a lazy val will cause the right-hand side to be re-evaluated on the next access; see SLS 5.2. -Note that using multiple lazy vals creates a new risk: cycles among lazy vals can result in a stack overflow on first access. +Note that using multiple lazy vals incurs a new risk: cycles among lazy vals can result in a stack overflow on first access. +When lazy vals are annotated as thread-safe in Scala 3, they risk deadlock. ### Use a nested object -Sometimes, uninitialized state in a subclass is accessed during construction of a superclass: +For purposes of initialization, an object that is not top-level is the same as a lazy val. + +There may be reasons to prefer a lazy val, for example to specify the type of an implicit value, +or an object where it is a companion to a class. Otherwise, the most convenient syntax may be preferred. + +As an example, uninitialized state in a subclass may be accessed during construction of a superclass: class Adder { var sum = 0 def add(x: Int): Unit = sum += x - add(1) + add(1) // in LogAdder, the `added` set is not initialized yet } class LogAdder extends Adder { private var added: Set[Int] = Set.empty override def add(x: Int): Unit = { added += x; super.add(x) } } -In this case the state can be initialized on demand by wrapping it into a local object: +In this case, the state can be initialized on demand by wrapping it in a local object: class Adder { var sum = 0 @@ -155,6 +171,10 @@ In this case the state can be initialized on demand by wrapping it into a local ### Early definitions: deprecated -Scala 2 supports early definitinos, but they are deprecated in Scala 2.13 and unsupported in Scala 3. +Scala 2 supports early definitions, but they are deprecated in Scala 2.13 and unsupported in Scala 3. See the [migration guide](https://docs.scala-lang.org/scala3/guides/migration/incompat-dropped-features.html#early-initializer) for more information. +Constant value definitions (specified in SLS 4.1 and available in Scala 2) +and inlined definitions (in Scala 3) can work around initialization order issues +because they can supply constant values without evaluating an instance that is not yet initialized. + From 1b32e19fd0f91b27df409e4cafd70ab5624ce3e1 Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Mon, 25 Mar 2024 16:39:13 -0700 Subject: [PATCH 3038/3075] Reduce misleading verbiage on file style --- _style/files.md | 68 +++++++++++++++++++------------------------------ 1 file changed, 26 insertions(+), 42 deletions(-) diff --git a/_style/files.md b/_style/files.md index 54ddf4e2db..704948ab32 100644 --- a/_style/files.md +++ b/_style/files.md @@ -11,33 +11,32 @@ previous-page: method-invocation next-page: scaladoc --- -As a rule, files should contain a *single* logical compilation unit. By -"logical" I mean a class, trait or object. One exception to this -guideline is for classes or traits which have companion objects. -Companion objects should be grouped with their corresponding class or -trait in the same file. These files should be named according to the -class, trait or object they contain: +The unit of work for the compiler is a "compilation unit", +which is usually just an ordinary file. +The Scala language places few restrictions on how code is organized across files. +The definition of a class, or equivalently a trait or object, can't be split over multiple files, +so it must be contained within a single file. +A class and its companion object must be defined together in the same file. +A sealed class can be extended only in the same file, so all its subclasses must be defined there. - package com.novell.coolness +Similarly, there are no restrictions on the name of a source file or where it is located in the file system, +although certain conventions are broadly honored in practice. +Generally, the file is named after the class it contains, +or if it has more than one class, the parent class. + +For example, a file, `Inbox.scala`, is expected to contain `Inbox` and its companion: + + package org.coolness class Inbox { ... } // companion object object Inbox { ... } -These compilation units should be placed within a file named -`Inbox.scala` within the `com/novell/coolness` directory. In short, the -Java file naming and positioning conventions should be preferred, -despite the fact that Scala allows for greater flexibility in this -regard. - -## Multi-Unit Files +The file may be located in a directory, `org/coolness`, following Java tooling conventions, +but this is at the discretion of the developer and for their convenience. -Despite what was said above, there are some important situations which -warrant the inclusion of multiple compilation units within a single -file. One common example is that of a sealed trait and several -sub-classes (often emulating the ADT language feature available in -functional languages): +It is natural to put the following `Option` ADT in a file, `Option.scala`: sealed trait Option[+A] @@ -45,26 +44,11 @@ functional languages): case object None extends Option[Nothing] -Because of the nature of sealed superclasses (and traits), all subtypes -*must* be included in the same file. Thus, such a situation definitely -qualifies as an instance where the preference for single-unit files -should be ignored. - -Another case is when multiple classes logically form a single, cohesive -group, sharing concepts to the point where maintenance is greatly served -by containing them within a single file. These situations are harder to -predict than the aforementioned sealed supertype exception. Generally -speaking, if it is *easier* to perform long-term maintenance and -development on several units in a single file rather than spread across -multiple, then such an organizational strategy should be preferred for -these classes. However, keep in mind that when multiple units are -contained within a single file, it is often more difficult to find -specific units when it comes time to make changes. - -**All multi-unit files should be given camelCase names with a lower-case -first letter.** This is a very important convention. It differentiates -multi- from single-unit files, greatly easing the process of finding -declarations. These filenames may be based upon a significant type which -they contain (e.g. `option.scala` for the example above), or may be -descriptive of the logical property shared by all units within (e.g. -`ast.scala`). +The related elements, `Some` and `None`, are easily discoverable, even in the absence of tooling. + +When unrelated classes are grouped together, perhaps because they implement a feature or a model a domain, +the source file receives a descriptive `camelCase` name. +Some prefer this naming scheme for top-level terms. For example, `object project` would be found in `project.scala`. +Similarly, a package object defined as `package object model` is located in `package.scala` in the `model` source directory. + +Files created just for quick testing can have arbitrary names, such as `demo-bug.scala`. From dcb8d924b1d70c44e5255c7eb5aa6a8c47081688 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 24 Feb 2025 17:29:08 -0800 Subject: [PATCH 3039/3075] typos --- _sips/results/2024-04-19-meeting.md | 2 +- _sips/results/2024-05-24-meeting.md | 2 +- _sips/results/2024-06-21-meeting.md | 2 +- _sips/results/2024-08-16-meeting.md | 2 +- _sips/results/2024-09-27-meeting.md | 2 +- _sips/results/2024-11-15-meeting.md | 2 +- _sips/results/2024-12-20-meeting.md | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/_sips/results/2024-04-19-meeting.md b/_sips/results/2024-04-19-meeting.md index 95611c3445..b5db00bc7a 100644 --- a/_sips/results/2024-04-19-meeting.md +++ b/_sips/results/2024-04-19-meeting.md @@ -13,4 +13,4 @@ proposals: name: SIP-64 - Improve the syntax of context bounds and givens result: accepted --- -SIP-61 and SIP-63 were discussed but not vote was held. +SIP-61 and SIP-63 were discussed but no vote was held. diff --git a/_sips/results/2024-05-24-meeting.md b/_sips/results/2024-05-24-meeting.md index 49bb48b5dc..51bf1e0a34 100644 --- a/_sips/results/2024-05-24-meeting.md +++ b/_sips/results/2024-05-24-meeting.md @@ -7,4 +7,4 @@ proposals: name: SIP-61 - Unroll default arguments for binary compatibility result: accepted --- -SIP-64 was discussed but not vote was held. +SIP-64 was discussed but no vote was held. diff --git a/_sips/results/2024-06-21-meeting.md b/_sips/results/2024-06-21-meeting.md index e1335e92bc..9ebb1ca250 100644 --- a/_sips/results/2024-06-21-meeting.md +++ b/_sips/results/2024-06-21-meeting.md @@ -7,4 +7,4 @@ proposals: name: SIP-47 - Clause interleaving result: accepted --- -SIP-55, SIP-58, SIP-60, SIP-62, and SIP-64 were discussed but not vote was held. +SIP-55, SIP-58, SIP-60, SIP-62, and SIP-64 were discussed but no vote was held. diff --git a/_sips/results/2024-08-16-meeting.md b/_sips/results/2024-08-16-meeting.md index fcf3f72684..73361aa923 100644 --- a/_sips/results/2024-08-16-meeting.md +++ b/_sips/results/2024-08-16-meeting.md @@ -4,4 +4,4 @@ title: SIP Meeting Results - 16th August 2024 partof: results proposals: [] --- -SIP-49, SIP-52, SIP-57, SIP-58, SIP-61, SIP-62, SIP-64, and SIP-66 were discussed but not vote was held. +SIP-49, SIP-52, SIP-57, SIP-58, SIP-61, SIP-62, SIP-64, and SIP-66 were discussed but no vote was held. diff --git a/_sips/results/2024-09-27-meeting.md b/_sips/results/2024-09-27-meeting.md index 3e2e372fc8..bbb0bb8b81 100644 --- a/_sips/results/2024-09-27-meeting.md +++ b/_sips/results/2024-09-27-meeting.md @@ -10,4 +10,4 @@ proposals: name: SIP-64 - Improve the syntax of context bounds and givens result: accepted --- -SIP-62 was discussed but not vote was held. +SIP-62 was discussed but no vote was held. diff --git a/_sips/results/2024-11-15-meeting.md b/_sips/results/2024-11-15-meeting.md index 78ddfe5d58..1a5da82052 100644 --- a/_sips/results/2024-11-15-meeting.md +++ b/_sips/results/2024-11-15-meeting.md @@ -4,4 +4,4 @@ title: SIP Meeting Results - 15th November 2024 partof: results proposals: [] --- -SIP-66 was discussed but not vote was held. +SIP-66 was discussed but no vote was held. diff --git a/_sips/results/2024-12-20-meeting.md b/_sips/results/2024-12-20-meeting.md index 72123ea6de..a9454f3250 100644 --- a/_sips/results/2024-12-20-meeting.md +++ b/_sips/results/2024-12-20-meeting.md @@ -4,4 +4,4 @@ title: SIP Meeting Results - 20th December 2024 partof: results proposals: [] --- -SIP-62 and SIP-67 were discussed but not vote was held. +SIP-62 and SIP-67 were discussed but no vote was held. From 76d3706929879504b8847437086ae427ff8c0940 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Mon, 24 Feb 2025 17:35:58 -0800 Subject: [PATCH 3040/3075] fix a 404 link --- _sips/sips/futures-promises.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/futures-promises.md b/_sips/sips/futures-promises.md index f69ac68c92..459cd54537 100644 --- a/_sips/sips/futures-promises.md +++ b/_sips/sips/futures-promises.md @@ -720,7 +720,7 @@ Examples: 4. [Scala Actors Futures][4] 5. [Scalaz Futures][5] - [1]: https://www.microsoft.com/download/en/details.aspx?id=19957 "NETAsync" + [1]: https://download.microsoft.com/download/5/B/9/5B924336-AA5D-4903-95A0-56C6336E32C9/TAP.docx "NETAsync" [2]: https://twitter.github.io/scala_school/finagle.html "Finagle" [3]: https://doc.akka.io/docs/akka/current/futures.html "AkkaFutures" [4]: https://web.archive.org/web/20140814211520/https://www.scala-lang.org/api/2.9.3/scala/actors/Future.html "SActorsFutures" From 1f1f3ac97e9b2104a2b67cda7f9f62e1d859320f Mon Sep 17 00:00:00 2001 From: Adrien Piquerez Date: Tue, 25 Feb 2025 09:17:02 +0100 Subject: [PATCH 3041/3075] Add affiliated links --- _includes/_markdown/courses-rock-the-jvm.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/_includes/_markdown/courses-rock-the-jvm.md b/_includes/_markdown/courses-rock-the-jvm.md index f9f2cc4bb4..0b0db4f9f1 100644 --- a/_includes/_markdown/courses-rock-the-jvm.md +++ b/_includes/_markdown/courses-rock-the-jvm.md @@ -1,13 +1,17 @@ ## Rock the JVM Courses -[Rock the JVM](https://rockthejvm.com) is a learning platform with free and premium courses on the Scala language, and all major libraries and tools in the Scala ecosystem: Typelevel, Zio, Akka/Pekko, Spark, and others. +_As part of a partnership with the Scala Center, Rock the JVM donates 30% of the revenue from any courses purchased through the links in this section to support the Scala Center._ + +[Rock the JVM](https://rockthejvm.com?affcode=256201_r93i1xuv) is a learning platform with free and premium courses on the Scala language, and all major libraries and tools in the Scala ecosystem: Typelevel, Zio, Akka/Pekko, Spark, and others. Its main Scala courses are: -- [Scala at Light Speed](https://rockthejvm.com/courses/scala-at-light-speed) (free) -- [Scala & Functional Programming Essentials](https://rockthejvm.com/courses/scala-essentials) (premium) -- [Advanced Scala and Functional Programming](https://rockthejvm.com/courses/advanced-scala) (premium) -- [Scala Macros & Metaprogramming](https://rockthejvm.com/courses/scala-macros-and-metaprogramming) (premium) +- [Scala at Light Speed](https://rockthejvm.com/courses/scala-at-light-speed?affcode=256201_r93i1xuv) (free) +- [Scala & Functional Programming Essentials](https://rockthejvm.com/courses/scala-essentials?affcode=256201_r93i1xuv) (premium) +- [Advanced Scala and Functional Programming](https://rockthejvm.com/courses/advanced-scala?affcode=256201_r93i1xuv) (premium) +- [Scala Macros & Metaprogramming](https://rockthejvm.com/courses/scala-macros-and-metaprogramming?affcode=256201_r93i1xuv) (premium) + +Other courses teach how to build full-stack Scala applications, using [Typelevel](https://rockthejvm.com/courses/typelevel-rite-of-passage?affcode=256201_r93i1xuv) or [ZIO](https://rockthejvm.com/courses/zio-rite-of-passage?affcode=256201_r93i1xuv) ecosystems. + -Other courses teach how to build full-stack Scala applications, using [Typelevel](https://rockthejvm.com/courses/typelevel-rite-of-passage) or [ZIO](https://rockthejvm.com/courses/zio-rite-of-passage) ecosystems. -Explore more premium [courses](https://rockthejvm.com/courses) or check out [free video tutorials](https://youtube.com/rockthejvm) and [free articles](https://rockthejvm.com/articles). +Explore more premium [courses](https://rockthejvm.com/courses?affcode=256201_r93i1xuv) or check out [free video tutorials](https://youtube.com/rockthejvm?affcode=256201_r93i1xuv) and [free articles](https://rockthejvm.com/articles?affcode=256201_r93i1xuv). From 8082551d3b236d49c730d34814f845a350929929 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 25 Feb 2025 11:25:08 -0800 Subject: [PATCH 3042/3075] bring Ruby and bundler versions in line with main site --- .github/workflows/build.yml | 2 +- Dockerfile | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 973735cb51..96a2061931 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -8,7 +8,7 @@ jobs: - name: Set up Ruby uses: ruby/setup-ruby@v1 with: - ruby-version: 3.1.6 + ruby-version: 3.2.6 bundler-cache: true - name: Set up coursier uses: coursier/setup-action@v1.3.5 diff --git a/Dockerfile b/Dockerfile index 636e38037b..b2bbc255f9 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,6 +1,6 @@ -FROM ruby:3.1.6 +FROM ruby:3.2.6 -RUN gem install bundler:2.4.21 +RUN gem install bundler:2.6.5 WORKDIR /srv/jekyll From 4876fb5a3af58f745879833c311d8b0b0249b627 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 25 Feb 2025 11:41:08 -0800 Subject: [PATCH 3043/3075] bundle update --- Gemfile.lock | 93 ++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 64 insertions(+), 29 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 1040918882..6240957b6b 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,8 +1,10 @@ GEM remote: https://rubygems.org/ specs: - activesupport (7.2.1) + Ascii85 (2.0.1) + activesupport (8.0.1) base64 + benchmark (>= 0.3) bigdecimal concurrent-ruby (~> 1.0, >= 1.3.1) connection_pool (>= 2.2.5) @@ -12,20 +14,34 @@ GEM minitest (>= 5.1) securerandom (>= 0.3) tzinfo (~> 2.0, >= 2.0.5) + uri (>= 0.13.1) addressable (2.8.7) public_suffix (>= 2.0.2, < 7.0) + afm (0.2.2) + async (2.23.0) + console (~> 1.29) + fiber-annotation + io-event (~> 1.9) + metrics (~> 0.12) + traces (~> 0.15) base64 (0.2.0) - bigdecimal (3.1.8) + benchmark (0.4.0) + bigdecimal (3.1.9) coffee-script (2.4.1) coffee-script-source execjs coffee-script-source (1.12.2) colorator (1.1.0) - commonmarker (0.23.10) - concurrent-ruby (1.3.4) - connection_pool (2.4.1) - csv (3.3.0) - dnsruby (1.72.2) + commonmarker (0.23.11) + concurrent-ruby (1.3.5) + connection_pool (2.5.0) + console (1.29.3) + fiber-annotation + fiber-local (~> 1.1) + json + csv (3.3.2) + dnsruby (1.72.3) + base64 (~> 0.2.0) simpleidn (~> 0.2.1) drb (2.2.1) em-websocket (0.5.3) @@ -34,15 +50,20 @@ GEM ethon (0.16.0) ffi (>= 1.15.0) eventmachine (1.2.7) - execjs (2.9.1) - faraday (2.10.1) - faraday-net_http (>= 2.0, < 3.2) + execjs (2.10.0) + faraday (2.12.2) + faraday-net_http (>= 2.0, < 3.5) + json logger - faraday-net_http (3.1.1) - net-http - ffi (1.17.0-arm64-darwin) - ffi (1.17.0-x64-mingw-ucrt) - ffi (1.17.0-x86_64-linux-gnu) + faraday-net_http (3.4.0) + net-http (>= 0.5.0) + ffi (1.17.1-arm64-darwin) + ffi (1.17.1-x64-mingw-ucrt) + ffi (1.17.1-x86_64-linux-gnu) + fiber-annotation (0.2.0) + fiber-local (1.1.0) + fiber-storage + fiber-storage (1.0.0) forwardable-extended (2.6.0) gemoji (4.1.0) github-pages (232) @@ -97,21 +118,23 @@ GEM octokit (>= 4, < 8) public_suffix (>= 3.0, < 6.0) typhoeus (~> 1.3) + hashery (2.1.2) html-pipeline (2.14.3) activesupport (>= 2) nokogiri (>= 1.4) - html-proofer (4.4.3) + html-proofer (5.0.10) addressable (~> 2.3) - mercenary (~> 0.3) + async (~> 2.1) nokogiri (~> 1.13) - parallel (~> 1.10) + pdf-reader (~> 2.11) rainbow (~> 3.0) typhoeus (~> 1.3) yell (~> 2.0) zeitwerk (~> 2.5) http_parser.rb (0.8.0) - i18n (1.14.5) + i18n (1.14.7) concurrent-ruby (~> 1.0) + io-event (1.9.0) jekyll (3.10.0) addressable (~> 2.4) colorator (~> 1.0) @@ -222,6 +245,7 @@ GEM gemoji (>= 3, < 5) html-pipeline (~> 2.2) jekyll (>= 3.0, < 5.0) + json (2.10.1) kramdown (2.4.0) rexml kramdown-parser-gfm (1.1.0) @@ -230,14 +254,15 @@ GEM listen (3.9.0) rb-fsevent (~> 0.10, >= 0.10.3) rb-inotify (~> 0.9, >= 0.9.10) - logger (1.6.0) + logger (1.6.6) mercenary (0.3.6) + metrics (0.12.1) minima (2.5.1) jekyll (>= 3.5, < 5.0) jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) - minitest (5.25.1) - net-http (0.4.1) + minitest (5.25.4) + net-http (0.6.0) uri nokogiri (1.18.3-arm64-darwin) racc (~> 1.4) @@ -248,18 +273,24 @@ GEM octokit (4.25.1) faraday (>= 1, < 3) sawyer (~> 0.9) - parallel (1.22.1) pathutil (0.16.2) forwardable-extended (~> 2.6) + pdf-reader (2.14.1) + Ascii85 (>= 1.0, < 3.0, != 2.0.0) + afm (~> 0.2.1) + hashery (~> 2.0) + ruby-rc4 + ttfunk public_suffix (5.1.1) racc (1.8.1) rainbow (3.1.1) rb-fsevent (0.11.2) rb-inotify (0.11.1) ffi (~> 1.0) - rexml (3.3.9) + rexml (3.4.1) rouge (3.30.0) - rubyzip (2.3.2) + ruby-rc4 (0.1.5) + rubyzip (2.4.1) safe_yaml (1.0.5) sass (3.7.4) sass-listen (~> 4.0.0) @@ -269,23 +300,27 @@ GEM sawyer (0.9.2) addressable (>= 2.3.5) faraday (>= 0.17.3, < 3) - securerandom (0.3.1) + securerandom (0.4.1) simpleidn (0.2.3) terminal-table (1.8.0) unicode-display_width (~> 1.1, >= 1.1.1) + traces (0.15.2) + ttfunk (1.8.0) + bigdecimal (~> 3.1) typhoeus (1.4.1) ethon (>= 0.9.0) tzinfo (2.0.6) concurrent-ruby (~> 1.0) unicode-display_width (1.8.0) - uri (0.13.0) + uri (1.0.2) webrick (1.9.1) yell (2.2.2) - zeitwerk (2.6.7) + zeitwerk (2.7.2) PLATFORMS arm64-darwin-22 arm64-darwin-23 + arm64-darwin-24 x64-mingw-ucrt x86_64-linux @@ -295,4 +330,4 @@ DEPENDENCIES webrick BUNDLED WITH - 2.4.21 + 2.6.5 From 8b5afb910034731210aa6e8c95509add2ac8b553 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 25 Feb 2025 11:47:16 -0800 Subject: [PATCH 3044/3075] update HTMLProofer flags for current version --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 96a2061931..451559d85c 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -28,6 +28,6 @@ jobs: --ignore-status-codes "400,401,403,429"\ --ignore-empty-alt\ --allow-hash-href\ - --enforce-https=false\ + --no-enforce-https\ --ignore-urls '/https://github.com/scala/,/www.oracle.com/' From 8d3273c5fe52d681e874f417754135a59125d195 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Wed, 26 Feb 2025 00:28:36 +0000 Subject: [PATCH 3045/3075] Update SIPs state --- _sips/sips/futures-promises.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/futures-promises.md b/_sips/sips/futures-promises.md index 459cd54537..f69ac68c92 100644 --- a/_sips/sips/futures-promises.md +++ b/_sips/sips/futures-promises.md @@ -720,7 +720,7 @@ Examples: 4. [Scala Actors Futures][4] 5. [Scalaz Futures][5] - [1]: https://download.microsoft.com/download/5/B/9/5B924336-AA5D-4903-95A0-56C6336E32C9/TAP.docx "NETAsync" + [1]: https://www.microsoft.com/download/en/details.aspx?id=19957 "NETAsync" [2]: https://twitter.github.io/scala_school/finagle.html "Finagle" [3]: https://doc.akka.io/docs/akka/current/futures.html "AkkaFutures" [4]: https://web.archive.org/web/20140814211520/https://www.scala-lang.org/api/2.9.3/scala/actors/Future.html "SActorsFutures" From 7bf0269fa6aab04e1e2f9b3f6f3e0d6aad411848 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 25 Feb 2025 16:46:06 -0800 Subject: [PATCH 3046/3075] Style guide: bring ToC in line with reality, fixing 404 (#3166) --- _style/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/_style/index.md b/_style/index.md index 7663a32054..9c126423ca 100644 --- a/_style/index.md +++ b/_style/index.md @@ -59,7 +59,6 @@ This document is intended to outline some basic Scala stylistic guidelines which - [Symbolic Methods/Operators](method-invocation.html#symbolic-methodsoperators) - [Higher-Order Functions](method-invocation.html#higher-order-functions) - [Files](files.html) - - [Multi-Unit Files](files.html#multi-unit-files) - [Scaladoc](scaladoc.html) - [General Style](scaladoc.html#general-style) - [Packages](scaladoc.html#packages) From 9b522cbf7ab1cb826357970ccd82d99e62c8ed6b Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 25 Feb 2025 15:55:50 -0800 Subject: [PATCH 3047/3075] fix small mistake on JDK compat page --- _overviews/jdk-compatibility/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index cd0a51c359..e3127b9989 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 24 (ea) | 3.6.4
    (forthcoming) | 3.3.6
    (forthcoming) | 2.13.16 | 2.12.21
    (forthcoming) | | +| 24 (ea) | 3.6.4* | 3.3.6* | 2.13.16 | 2.12.21* | | | 23 | 3.6.2 | 3.3.5 | 2.13.15 | 2.12.20 | | | 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | From cd2d38e7d065b2a8ad2c3fe05a60fb01f63d115c Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 25 Feb 2025 15:58:10 -0800 Subject: [PATCH 3048/3075] update Scala 3 wording --- _overviews/jdk-compatibility/overview.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index e3127b9989..fbf263e3ef 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -47,8 +47,6 @@ Even when a version combination isn't listed as supported, most features might s Using a different build tool, such as Gradle or Maven? We invite pull requests adding additional columns to this table. -**Next Scala 3 LTS series will drop JDK 8 support** - read more about it in [the blog post](https://www.scala-lang.org/news/next-scala-lts.html). - ## Running versus compiling JDK 8, 11, 17, and 21 are all reasonable choices both for *compiling* and *running* Scala code. @@ -153,6 +151,8 @@ A few sbt plugins are offering support for GraalVM Native Image compilation: ## Scala 3 ->The Scala 3.x series supports JDK 8, as well as 11 and beyond. +At present, both Scala 3 LTS and Scala Next support JDK 8, as well as 11 and beyond. -As Scala and the JVM continue to evolve, some eventual Scala version may drop support for JDK 8, in order to better take advantage of new JVM features. It isn't clear yet what the new minimum supported version might become. +As per [this blog post](https://www.scala-lang.org/news/next-scala-lts.html), +a forthcoming Scala 3 LTS version will drop JDK 8 support and may drop +11 as well. Stay tuned. From 9f249ed7da20381770b08f0a98d87e60fb239f46 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Tue, 25 Feb 2025 17:05:25 -0800 Subject: [PATCH 3049/3075] fix a 404 link --- _sips/sips/futures-promises.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/futures-promises.md b/_sips/sips/futures-promises.md index f69ac68c92..7c2a616339 100644 --- a/_sips/sips/futures-promises.md +++ b/_sips/sips/futures-promises.md @@ -720,7 +720,7 @@ Examples: 4. [Scala Actors Futures][4] 5. [Scalaz Futures][5] - [1]: https://www.microsoft.com/download/en/details.aspx?id=19957 "NETAsync" + [1]: https://download.microsoft.com/download/5/B/9/5B924336-AA5D-4903-95A0-56C6336E32C9/TAP.docx [2]: https://twitter.github.io/scala_school/finagle.html "Finagle" [3]: https://doc.akka.io/docs/akka/current/futures.html "AkkaFutures" [4]: https://web.archive.org/web/20140814211520/https://www.scala-lang.org/api/2.9.3/scala/actors/Future.html "SActorsFutures" From cb24cba4837356f615caf26ad71ee2f27ad954f5 Mon Sep 17 00:00:00 2001 From: blank71 <35300690+blank71@users.noreply.github.com> Date: Wed, 26 Feb 2025 11:56:30 +0900 Subject: [PATCH 3050/3075] fix(docs): Rename variable `coll` to `iter` for consistency (#3139) --- _overviews/collections-2.13/views.md | 2 +- _ru/overviews/collections-2.13/views.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/_overviews/collections-2.13/views.md b/_overviews/collections-2.13/views.md index 2fa15860c3..6b0052c5e5 100644 --- a/_overviews/collections-2.13/views.md +++ b/_overviews/collections-2.13/views.md @@ -34,7 +34,7 @@ def lazyMap[T, U](iter: Iterable[T], f: T => U) = new Iterable[U]: {% endtab %} {% endtabs %} -Note that `lazyMap` constructs a new `Iterable` without stepping through all elements of the given collection `coll`. The given function `f` is instead applied to the elements of the new collection's `iterator` as they are demanded. +Note that `lazyMap` constructs a new `Iterable` without stepping through all elements of the given collection `iter`. The given function `f` is instead applied to the elements of the new collection's `iterator` as they are demanded. Scala collections are by default strict in all their transformers, except for `LazyList`, which implements all its transformer methods lazily. However, there is a systematic way to turn every collection into a lazy one and _vice versa_, which is based on collection views. A _view_ is a special kind of collection that represents some base collection, but implements all transformers lazily. diff --git a/_ru/overviews/collections-2.13/views.md b/_ru/overviews/collections-2.13/views.md index a26760f360..135cbb0b50 100644 --- a/_ru/overviews/collections-2.13/views.md +++ b/_ru/overviews/collections-2.13/views.md @@ -15,11 +15,11 @@ language: ru В качестве примера не строгого трансформера рассмотрим следующую реализацию операции создания ленивой мапы: - def lazyMap[T, U](coll: Iterable[T], f: T => U) = new Iterable[U] { - def iterator = coll.iterator map f + def lazyMap[T, U](iter: Iterable[T], f: T => U) = new Iterable[U] { + def iterator = iter.iterator map f } -Обратите внимание, что `lazyMap` создает новую `Iterable` , не обходя все элементы коллекции `coll`. Функция `f` применяется к элементам новой коллекции `iterator` по мере запроса ее элементов. +Обратите внимание, что `lazyMap` создает новую `Iterable` , не обходя все элементы коллекции `iter`. Функция `f` применяется к элементам новой коллекции `iterator` по мере запроса ее элементов. Коллекции Scala по умолчанию используют строгий способ во всех своих трансфмерах, за исключением `LazyList`, который реализует свои трансформеры не строгими (ленивыми). Однако существует практичный способ превратить любую коллекцию в ленивую и _наоборот_, основанный на отображении коллекции. _Отображение_ представляет собой особый вид коллекции, которое реализует все трансформеры лениво. From 7ec2ca60f344c0baf10fc595e237bc4824997052 Mon Sep 17 00:00:00 2001 From: Scala Improvement Bot Date: Thu, 27 Feb 2025 00:28:59 +0000 Subject: [PATCH 3051/3075] Update SIPs state --- _sips/sips/futures-promises.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/futures-promises.md b/_sips/sips/futures-promises.md index 7c2a616339..f69ac68c92 100644 --- a/_sips/sips/futures-promises.md +++ b/_sips/sips/futures-promises.md @@ -720,7 +720,7 @@ Examples: 4. [Scala Actors Futures][4] 5. [Scalaz Futures][5] - [1]: https://download.microsoft.com/download/5/B/9/5B924336-AA5D-4903-95A0-56C6336E32C9/TAP.docx + [1]: https://www.microsoft.com/download/en/details.aspx?id=19957 "NETAsync" [2]: https://twitter.github.io/scala_school/finagle.html "Finagle" [3]: https://doc.akka.io/docs/akka/current/futures.html "AkkaFutures" [4]: https://web.archive.org/web/20140814211520/https://www.scala-lang.org/api/2.9.3/scala/actors/Future.html "SActorsFutures" From 5909da4072951841047abc53fe44778f1613d49a Mon Sep 17 00:00:00 2001 From: Artem Korsakov Date: Sat, 1 Mar 2025 17:24:54 +0300 Subject: [PATCH 3052/3075] Translate "Toolkit" into Russian --- _includes/_markdown/_ru/install-cask.md | 45 +++++++++++ _includes/_markdown/_ru/install-munit.md | 68 +++++++++++++++++ _includes/_markdown/_ru/install-os-lib.md | 64 ++++++++++++++++ _includes/_markdown/_ru/install-sttp.md | 64 ++++++++++++++++ _includes/_markdown/_ru/install-upickle.md | 64 ++++++++++++++++ _overviews/toolkit/http-client-intro.md | 1 + _overviews/toolkit/introduction.md | 1 + _overviews/toolkit/json-intro.md | 1 + _overviews/toolkit/os-intro.md | 1 + _overviews/toolkit/testing-intro.md | 1 + _overviews/toolkit/web-server-intro.md | 1 + _ru/toolkit/OrderedListOfMdFiles | 36 +++++++++ _ru/toolkit/http-client-intro.md | 24 ++++++ _ru/toolkit/introduction.md | 88 ++++++++++++++++++++++ _ru/toolkit/json-intro.md | 23 ++++++ _ru/toolkit/os-intro.md | 25 ++++++ _ru/toolkit/testing-intro.md | 28 +++++++ _ru/toolkit/web-server-intro.md | 30 ++++++++ 18 files changed, 565 insertions(+) create mode 100644 _includes/_markdown/_ru/install-cask.md create mode 100644 _includes/_markdown/_ru/install-munit.md create mode 100644 _includes/_markdown/_ru/install-os-lib.md create mode 100644 _includes/_markdown/_ru/install-sttp.md create mode 100644 _includes/_markdown/_ru/install-upickle.md create mode 100644 _ru/toolkit/OrderedListOfMdFiles create mode 100644 _ru/toolkit/http-client-intro.md create mode 100644 _ru/toolkit/introduction.md create mode 100644 _ru/toolkit/json-intro.md create mode 100644 _ru/toolkit/os-intro.md create mode 100644 _ru/toolkit/testing-intro.md create mode 100644 _ru/toolkit/web-server-intro.md diff --git a/_includes/_markdown/_ru/install-cask.md b/_includes/_markdown/_ru/install-cask.md new file mode 100644 index 0000000000..1cac104c20 --- /dev/null +++ b/_includes/_markdown/_ru/install-cask.md @@ -0,0 +1,45 @@ +{% altDetails require-info-box 'Установка Cask' %} + +{% tabs cask-install class=tabs-build-tool %} + +{% tab 'Scala CLI' %} + +Вы можете объявить зависимость от Cask с помощью следующей директивы `using`: + +```scala +//> using dep com.lihaoyi::cask::0.10.2 +``` + +{% endtab %} + +{% tab 'sbt' %} + +В файле `build.sbt` вы можете добавить зависимость от Cask: + +```scala +lazy val example = project.in(file("example")) + .settings( + scalaVersion := "3.4.2", + libraryDependencies += "com.lihaoyi" %% "cask" % "0.10.2", + fork := true + ) +``` + +{% endtab %} + +{% tab 'Mill' %} + +В файле `build.sc` вы можете добавить зависимость от Cask: + +```scala +object example extends RootModule with ScalaModule { + def scalaVersion = "3.4.2" + def ivyDeps = Agg( + ivy"com.lihaoyi::cask::0.10.2" + ) +} +``` +{% endtab %} + +{% endtabs %} +{% endaltDetails %} diff --git a/_includes/_markdown/_ru/install-munit.md b/_includes/_markdown/_ru/install-munit.md new file mode 100644 index 0000000000..aa15142558 --- /dev/null +++ b/_includes/_markdown/_ru/install-munit.md @@ -0,0 +1,68 @@ +{% altDetails install-info-box 'Установка MUnit' %} + +{% tabs munit-unit-test-1 class=tabs-build-tool %} +{% tab 'Scala CLI' %} + +Вы можете запросить весь набор инструментов одной командой: + +```scala +//> using toolkit latest +``` + +MUnit, будучи тестовым фреймворком, доступен только в тестовых файлах: +файлах в каталоге `test` или тех, которые имеют расширение `.test.scala`. +Подробнее о тестовой области (test scope) см. [в документации Scala CLI](https://scala-cli.virtuslab.org/docs/commands/test/). + +В качестве альтернативы вы можете запросить только определенную версию MUnit: + +```scala +//> using dep org.scalameta::munit:1.1.0 +``` + +{% endtab %} + +{% tab 'sbt' %} + +В файле `build.sbt` вы можете добавить зависимость от toolkit-test: + +```scala +lazy val example = project.in(file(".")) + .settings( + scalaVersion := "3.4.2", + libraryDependencies += "org.scala-lang" %% "toolkit-test" % "0.7.0" % Test + ) +``` + +Здесь конфигурация `Test` означает, что зависимость используется только исходными файлами в `src/test`. + +В качестве альтернативы вы можете запросить только определенную версию MUnit: + +```scala +libraryDependencies += "org.scalameta" %% "munit" % "1.1.0" % Test +``` +{% endtab %} + +{% tab 'Mill' %} + +В файле `build.sc` вы можете добавить объект `test`, расширяющий `Tests` и `TestModule.Munit`: + +```scala +object example extends ScalaModule { + def scalaVersion = "3.4.2" + object test extends Tests with TestModule.Munit { + def ivyDeps = + Agg( + ivy"org.scala-lang::toolkit-test:0.7.0" + ) + } +} +``` + +В качестве альтернативы вы можете запросить только определенную версию MUnit: + +```scala +ivy"org.scalameta::munit:1.1.0" +``` +{% endtab %} +{% endtabs %} +{% endaltDetails %} \ No newline at end of file diff --git a/_includes/_markdown/_ru/install-os-lib.md b/_includes/_markdown/_ru/install-os-lib.md new file mode 100644 index 0000000000..f010d1f7fd --- /dev/null +++ b/_includes/_markdown/_ru/install-os-lib.md @@ -0,0 +1,64 @@ +{% altDetails require-info-box 'Установка OS-Lib' %} + +{% tabs oslib-install class=tabs-build-tool %} + +{% tab 'Scala CLI' %} + +Вы можете запросить весь набор инструментов одной командой: + +```scala +//> using toolkit latest +``` + +В качестве альтернативы вы можете запросить только определенную версию OS-Lib: + +```scala +//> using dep com.lihaoyi::os-lib:0.11.3 +``` + +{% endtab %} + +{% tab 'sbt' %} + +В файле `build.sbt` вы можете добавить зависимость от `toolkit`: + +```scala +lazy val example = project.in(file(".")) + .settings( + scalaVersion := "3.4.2", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.7.0" + ) +``` + +В качестве альтернативы вы можете запросить только определенную версию OS-Lib: + +```scala +libraryDependencies += "com.lihaoyi" %% "os-lib" % "0.11.3" +``` + +{% endtab %} + +{% tab 'Mill' %} + +В файле `build.sc` вы можете добавить зависимость от `toolkit`: + +```scala +object example extends ScalaModule { + def scalaVersion = "3.4.2" + def ivyDeps = + Agg( + ivy"org.scala-lang::toolkit:0.7.0" + ) +} +``` + +В качестве альтернативы вы можете запросить только определенную версию OS-Lib: + +```scala +ivy"com.lihaoyi::os-lib:0.11.3" +``` + +{% endtab %} + +{% endtabs %} +{% endaltDetails %} \ No newline at end of file diff --git a/_includes/_markdown/_ru/install-sttp.md b/_includes/_markdown/_ru/install-sttp.md new file mode 100644 index 0000000000..fec7938cea --- /dev/null +++ b/_includes/_markdown/_ru/install-sttp.md @@ -0,0 +1,64 @@ + +{% altDetails install-info-box 'Установка sttp' %} + +{% tabs sttp-install-methods class=tabs-build-tool%} + +{% tab 'Scala CLI' %} + +Вы можете запросить весь набор инструментов одной командой: + +```scala +//> using toolkit latest +``` + +В качестве альтернативы вы можете запросить только определенную версию sttp: + +```scala +//> using dep com.softwaremill.sttp.client4::core:4.0.0-RC1 +``` + +{% endtab %} + +{% tab 'sbt' %} + +В файле `build.sbt` вы можете добавить зависимость от `toolkit`: + +```scala +lazy val example = project.in(file(".")) + .settings( + scalaVersion := "3.4.2", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.7.0" + ) +``` + +В качестве альтернативы вы можете запросить только определенную версию sttp: + +```scala +libraryDependencies += "com.softwaremill.sttp.client4" %% "core" % "4.0.0-RC1" +``` + +{% endtab %} + +{% tab 'Mill' %} + +В файле `build.sc` вы можете добавить зависимость от `toolkit`: + +```scala +object example extends ScalaModule { + def scalaVersion = "3.4.2" + def ivyDeps = + Agg( + ivy"org.scala-lang::toolkit:0.7.0" + ) +} +``` + +В качестве альтернативы вы можете запросить только определенную версию sttp: + +```scala +ivy"com.softwaremill.sttp.client4::core:4.0.0-RC1" +``` + +{% endtab %} +{% endtabs %} +{% endaltDetails %} diff --git a/_includes/_markdown/_ru/install-upickle.md b/_includes/_markdown/_ru/install-upickle.md new file mode 100644 index 0000000000..83880a91a8 --- /dev/null +++ b/_includes/_markdown/_ru/install-upickle.md @@ -0,0 +1,64 @@ + +{% altDetails install-info-box 'Установка upickle' %} + +{% tabs upickle-install-methods class=tabs-build-tool %} + +{% tab 'Scala CLI' %} + +Вы можете запросить весь набор инструментов одной командой: + +```scala +//> using toolkit latest +``` + +В качестве альтернативы вы можете запросить только определенную версию UPickle: + +```scala +//> using dep com.lihaoyi::upickle:4.1.0 +``` + +{% endtab %} + +{% tab 'sbt' %} + +В файле `build.sbt` вы можете добавить зависимость от `toolkit`: + +```scala +lazy val example = project.in(file(".")) + .settings( + scalaVersion := "3.4.2", + libraryDependencies += "org.scala-lang" %% "toolkit" % "0.7.0" + ) +``` + +В качестве альтернативы вы можете запросить только определенную версию UPickle: + +```scala +libraryDependencies += "com.lihaoyi" %% "upickle" % "4.1.0" +``` + +{% endtab %} + +{% tab 'Mill' %} + +В файле `build.sc` вы можете добавить зависимость от `toolkit`: + +```scala +object example extends ScalaModule { + def scalaVersion = "3.4.2" + def ivyDeps = + Agg( + ivy"org.scala-lang::toolkit:0.7.0" + ) +} +``` + +В качестве альтернативы вы можете запросить только определенную версию UPickle: + +```scala +ivy"com.lihaoyi::upickle:4.1.0" +``` + +{% endtab %} +{% endtabs %} +{% endaltDetails %} diff --git a/_overviews/toolkit/http-client-intro.md b/_overviews/toolkit/http-client-intro.md index fd2e132c54..7e8405f637 100644 --- a/_overviews/toolkit/http-client-intro.md +++ b/_overviews/toolkit/http-client-intro.md @@ -3,6 +3,7 @@ title: Sending HTTP requests with sttp type: chapter description: The introduction of the sttp library num: 23 +languages: [ru] previous-page: json-what-else next-page: http-client-request --- diff --git a/_overviews/toolkit/introduction.md b/_overviews/toolkit/introduction.md index 9bc97cb2d1..4e042e3575 100644 --- a/_overviews/toolkit/introduction.md +++ b/_overviews/toolkit/introduction.md @@ -3,6 +3,7 @@ title: Introduction type: chapter description: Introducing the Scala Toolkit tutorials num: 1 +languages: [ru] previous-page: next-page: testing-intro toolkit-index: diff --git a/_overviews/toolkit/json-intro.md b/_overviews/toolkit/json-intro.md index 7fb3e890de..9c5c789b49 100644 --- a/_overviews/toolkit/json-intro.md +++ b/_overviews/toolkit/json-intro.md @@ -3,6 +3,7 @@ title: Handling JSON with uPickle type: chapter description: Description of the uPickle library. num: 16 +languages: [ru] previous-page: os-what-else next-page: json-parse --- diff --git a/_overviews/toolkit/os-intro.md b/_overviews/toolkit/os-intro.md index 71d30f0c49..d72387f045 100644 --- a/_overviews/toolkit/os-intro.md +++ b/_overviews/toolkit/os-intro.md @@ -3,6 +3,7 @@ title: Working with files and processes with OS-Lib type: chapter description: The introduction of the OS-lib library num: 10 +languages: [ru] previous-page: testing-what-else next-page: os-read-directory --- diff --git a/_overviews/toolkit/testing-intro.md b/_overviews/toolkit/testing-intro.md index 8aa5021b76..4397be63b3 100644 --- a/_overviews/toolkit/testing-intro.md +++ b/_overviews/toolkit/testing-intro.md @@ -3,6 +3,7 @@ title: Testing with MUnit type: chapter description: The introduction of the MUnit library num: 2 +languages: [ru] previous-page: introduction next-page: testing-suite --- diff --git a/_overviews/toolkit/web-server-intro.md b/_overviews/toolkit/web-server-intro.md index 4a1efcdc6a..bf2db8a537 100644 --- a/_overviews/toolkit/web-server-intro.md +++ b/_overviews/toolkit/web-server-intro.md @@ -3,6 +3,7 @@ title: Building web servers with Cask type: chapter description: The introduction of the Cask library num: 30 +languages: [ru] previous-page: http-client-what-else next-page: web-server-static --- diff --git a/_ru/toolkit/OrderedListOfMdFiles b/_ru/toolkit/OrderedListOfMdFiles new file mode 100644 index 0000000000..b2790bd58a --- /dev/null +++ b/_ru/toolkit/OrderedListOfMdFiles @@ -0,0 +1,36 @@ +introduction.md +testing-intro.md +testing-suite.md +testing-run.md +testing-run-only.md +testing-exceptions.md +testing-asynchronous.md +testing-resources.md +testing-what-else.md +os-intro.md +os-read-directory.md +os-read-file.md +os-write-file.md +os-run-process.md +os-what-else.md +json-intro.md +json-parse.md +json-modify.md +json-deserialize.md +json-serialize.md +json-files.md +json-what-else.md +http-client-intro.md +http-client-request.md +http-client-uris.md +http-client-request-body.md +http-client-json.md +http-client-upload-file.md +http-client-what-else.md +web-server-intro.md +web-server-static.md +web-server-dynamic.md +web-server-query-parameters.md +web-server-input.md +web-server-websockets.md +web-server-cookies-and-decorators.md diff --git a/_ru/toolkit/http-client-intro.md b/_ru/toolkit/http-client-intro.md new file mode 100644 index 0000000000..6e552acecd --- /dev/null +++ b/_ru/toolkit/http-client-intro.md @@ -0,0 +1,24 @@ +--- +layout: multipage-overview +partof: toolkit +overview-name: "Scala инструментарий" +title: Отправка HTTP-запросов с помощью sttp +type: chapter +description: Введение в библиотеку sttp +language: ru +num: 23 +previous-page: +next-page: +--- + +sttp — популярная и многофункциональная библиотека для выполнения HTTP-запросов к веб-серверам. + +Она предоставляет как синхронный API, так и асинхронный API, основанный на `Future`. Она также поддерживает WebSockets. + +Доступны расширения, добавляющие такие возможности, как потоковая передача, логирование, телеметрия и сериализация. + +sttp предлагает одинаковые API на всех платформах (JVM, Scala.js и Scala Native). + +sttp — хороший выбор для небольших синхронных скриптов, а также для крупномасштабных, высококонкурентных, асинхронных приложений. + +{% include markdown.html path="_markdown/_ru/install-sttp.md" %} diff --git a/_ru/toolkit/introduction.md b/_ru/toolkit/introduction.md new file mode 100644 index 0000000000..f6a216e298 --- /dev/null +++ b/_ru/toolkit/introduction.md @@ -0,0 +1,88 @@ +--- +layout: multipage-overview +partof: toolkit +overview-name: "Scala инструментарий" +title: Введение +type: chapter +description: Знакомство с учебными пособиями по Scala инструментариям +language: ru +num: 1 +previous-page: +next-page: testing-intro +toolkit-index: + - title: Тесты + description: Тестирование кода с помощью MUnit. + icon: "fa fa-vial-circle-check" + link: /ru/toolkit/testing-intro.html + - title: Файлы и процессы + description: Запись файлов и запуск процессов с помощью OS-Lib. + icon: "fa fa-folder-open" + link: /ru/toolkit/os-intro.html + - title: JSON + description: Парсинг JSON и сериализация объектов в JSON с помощью uPickle. + icon: "fa fa-file-code" + link: /ru/toolkit/json-intro.html + - title: HTTP-запросы + description: Отправка HTTP-запросов и загрузка файлов с помощью sttp. + icon: "fa fa-globe" + link: /ru/toolkit/http-client-intro.html + - title: Веб-серверы + description: Создание веб-серверов с помощью Cask. + icon: "fa fa-server" + link: /ru/toolkit/web-server-intro.html +--- + +## Что такое набор инструментов Scala? + +Scala Toolkit — это набор библиотек, предназначенных для эффективного выполнения типичных задач программирования. +Он включает в себя инструменты для работы с файлами и процессами, парсинга JSON, отправки HTTP-запросов и модульного тестирования. + +Инструментарий поддерживает: + +- Scala 3 и Scala 2 +- JVM, Scala.js и Scala Native + +Варианты использования набора инструментов включают в себя: + +- кратковременные программы, работающие на JVM, для сканирования веб-сайта, сбора и преобразования данных + или для извлечения и обработки некоторых файлов, +- скрипты интерфейса, которые запускаются в браузере и обеспечивают работу ваших веб-сайтов, +- инструменты командной строки, упакованные в виде собственных двоичных файлов для мгновенного запуска + +{% include inner-documentation-sections.html links=page.toolkit-index %} + +## Что это за руководства? + +В этой серии руководств основное внимание уделяется кратким примерам кода, которые помогут вам быстро приступить к работе. + +Если вам нужна более подробная информация, в руководствах содержатся ссылки на дополнительную документацию +по всем библиотекам в наборе инструментов. + +## Как запустить код? + +Вы можете следовать руководствам независимо от того, как решите запустить свой Scala код. +Руководства фокусируются на самом коде, а не на процессе его запуска. + +Способы запуска кода на Scala включают: + +- В вашем **браузере** с помощью [Scastie](https://scastie.scala-lang.org) + - Плюсы: не требует установки, возможность делиться кодом онлайн + - Минусы: только один файл, доступно только онлайн +- Интерактивно в **REPL** Scala (Read/Eval/Print/Loop) + - Плюсы: интерактивное исследование в терминале + - Минусы: не сохраняет ваш код +- Интерактивно в **worksheet** в вашей IDE, например [IntelliJ](https://www.jetbrains.com/help/idea/discover-intellij-idea-for-scala.html) или [Metals](http://scalameta.org/metals/) + - Плюсы: интерактивное исследование в графическом интерфейсе + - Минусы: требует для запуска среды worksheet +- В **скриптах** с использованием [Scala CLI](https://scala-cli.virtuslab.com) + - Плюсы: рабочий процесс в терминале с минимальной настройкой + - Минусы: может не подходить для крупных проектов +- С использованием **инструмента сборки** (например, [sbt](https://www.scala-sbt.org) или [mill](https://com-lihaoyi.github.io/mill/)) + - Плюсы: рабочий процесс в терминале для проектов любого размера + - Минусы: требует дополнительной настройки и обучения +- С использованием **IDE**, например [IntelliJ](https://www.jetbrains.com/help/idea/discover-intellij-idea-for-scala.html) или [Metals](http://scalameta.org/metals/) + - Плюсы: рабочий процесс в графическом интерфейсе для проектов любого размера + - Минусы: требует дополнительной настройки и обучения + +Эти варианты, с их плюсами и минусами, характерны для большинства языков программирования. +Вы можете использовать любой из них, в зависимости от того варианта, который вам удобен. diff --git a/_ru/toolkit/json-intro.md b/_ru/toolkit/json-intro.md new file mode 100644 index 0000000000..c91f04b075 --- /dev/null +++ b/_ru/toolkit/json-intro.md @@ -0,0 +1,23 @@ +--- +layout: multipage-overview +partof: toolkit +overview-name: "Scala инструментарий" +title: Обработка JSON с помощью uPickle +type: chapter +description: Описание библиотеки uPickle. +language: ru +num: 16 +previous-page: +next-page: +--- + +uPickle — это облегченная библиотека сериализации для Scala. + +В его состав входит uJson — библиотека для работы с JSON, которая может анализировать строки JSON, +получать доступ к их значениям в памяти или изменять их, а также записывать их обратно. + +uPickle может сериализовать и десериализовать объекты Scala напрямую в JSON и из него. +Он знает, как обрабатывать коллекции Scala, такие как `Map` и `Seq`, +а также ваши собственные типы данных, такие как case class-ы и перечисления Scala 3. + +{% include markdown.html path="_markdown/_ru/install-upickle.md" %} diff --git a/_ru/toolkit/os-intro.md b/_ru/toolkit/os-intro.md new file mode 100644 index 0000000000..4e5cb4fd2a --- /dev/null +++ b/_ru/toolkit/os-intro.md @@ -0,0 +1,25 @@ +--- +layout: multipage-overview +partof: toolkit +overview-name: "Scala инструментарий" +title: Работа с файлами и процессами с помощью OS-Lib +type: chapter +description: Введение в библиотеку OS-lib +language: ru +num: 10 +previous-page: +next-page: +--- + +OS-Lib — это библиотека для работы с файлами и процессами. Она является частью Scala Toolkit. + +OS-Lib стремится заменить API `java.nio.file` и `java.lang.ProcessBuilder`. +Скорее всего, вам не понадобиться напрямую использовать какие-либо низкоуровневые Java API. + +OS-Lib также нацелена на то, чтобы вытеснить устаревшие API `scala.io` и `scala.sys` из стандартной библиотеки Scala. + +OS-Lib не имеет зависимостей. + +Весь функционал OS-Lib находится в пространстве имён `os.*`. + +{% include markdown.html path="_markdown/_ru/install-os-lib.md" %} diff --git a/_ru/toolkit/testing-intro.md b/_ru/toolkit/testing-intro.md new file mode 100644 index 0000000000..3fa905ddb3 --- /dev/null +++ b/_ru/toolkit/testing-intro.md @@ -0,0 +1,28 @@ +--- +layout: multipage-overview +partof: toolkit +overview-name: "Scala инструментарий" +title: Тестирование с помощью MUnit +type: chapter +description: Введение в библиотеку MUnit +language: ru +num: 2 +previous-page: introduction +next-page: +--- + +MUnit — легковесная библиотека для тестирования. Она предоставляет единый стиль написания тестов, который можно быстро освоить. + +Несмотря на свою простоту, MUnit обладает такими полезными функциями, как: + +- **утверждения (assertions)** для проверки поведения программы, +- **фикстуры (fixtures)**, чтобы гарантировать, что тесты имеют доступ ко всем необходимым ресурсам, +- **поддержка асинхронности** для тестирования параллельных (concurrent) и распределённых приложений. + +MUnit создаёт полезные отчёты об ошибках с указанием различий и местоположения в исходном коде, что помогает быстро понять причины сбоев. + +Тестирование является важной частью любого процесса разработки программного обеспечения, +так как оно помогает находить ошибки на ранних этапах, +улучшает качество кода и облегчает совместную работу. + +{% include markdown.html path="_markdown/_ru/install-munit.md" %} diff --git a/_ru/toolkit/web-server-intro.md b/_ru/toolkit/web-server-intro.md new file mode 100644 index 0000000000..6afdebab4f --- /dev/null +++ b/_ru/toolkit/web-server-intro.md @@ -0,0 +1,30 @@ +--- +layout: multipage-overview +partof: toolkit +overview-name: "Scala инструментарий" +title: Создание веб-серверов с помощью Cask +type: chapter +description: Введение в библиотеку Cask +language: ru +num: 30 +previous-page: +next-page: +--- + +Cask — это микрофреймворк HTTP, предоставляющий простой и гибкий способ создания веб-приложений. + +Основное внимание уделяется простоте использования, что делает его идеальным для новичков, +но при этом приходится отказываться от некоторых функций, предоставляемых другими фреймворками, например, асинхронности. + +Чтобы определить endpoint, достаточно аннотировать функцию аннотацией, указывающей путь запроса. +Cask позволяет вручную строить ответ с помощью инструментов, предоставляемых библиотекой, +указывая содержимое, заголовки, код статуса и т.д. +Функция endpoint также может возвращать строку, JSON тип [uPickle](https://com-lihaoyi.github.io/upickle/) +или шаблон [Scalatags](https://com-lihaoyi.github.io/scalatags/). +В этом случае Cask автоматически создаст ответ с соответствующими заголовками. + +Cask поставляется в комплекте с библиотекой uPickle для обработки JSON, поддерживает WebSockets +и позволяет расширять конечные точки с помощью декораторов, +которые можно использовать для обработки аутентификации или ограничения скорости. + +{% include markdown.html path="_markdown/_ru/install-cask.md" %} From 64d88df4b4524879d5ae5dba26f982412aa02bc8 Mon Sep 17 00:00:00 2001 From: dottybot Date: Mon, 3 Mar 2025 16:19:14 +0000 Subject: [PATCH 3053/3075] Update SIPs state --- _sips/sips/futures-promises.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_sips/sips/futures-promises.md b/_sips/sips/futures-promises.md index f69ac68c92..26e067bfaa 100644 --- a/_sips/sips/futures-promises.md +++ b/_sips/sips/futures-promises.md @@ -714,13 +714,13 @@ Examples: ## References -1. [The Task-Based Asynchronous Pattern, Stephen Toub, Microsoft, April 2011][1] +1. [The Task-Based Asynchronous Pattern, Stephen Toub, Microsoft, February 2012][1] 2. [Finagle Documentation][2] 3. [Akka Documentation: Futures][3] 4. [Scala Actors Futures][4] 5. [Scalaz Futures][5] - [1]: https://www.microsoft.com/download/en/details.aspx?id=19957 "NETAsync" + [1]: https://download.microsoft.com/download/5/B/9/5B924336-AA5D-4903-95A0-56C6336E32C9/TAP.docx "NETAsync" [2]: https://twitter.github.io/scala_school/finagle.html "Finagle" [3]: https://doc.akka.io/docs/akka/current/futures.html "AkkaFutures" [4]: https://web.archive.org/web/20140814211520/https://www.scala-lang.org/api/2.9.3/scala/actors/Future.html "SActorsFutures" From 5554889868e52060ff465dc513034e30b7d23baa Mon Sep 17 00:00:00 2001 From: Igor Moreno Date: Wed, 5 Mar 2025 14:43:28 +0100 Subject: [PATCH 3054/3075] Update version of os-lib in install-scala.md With the version 0.10.7, currently in the documentation, the output includes a hint suggesting to update the version of the library: ``` [hint] ./counter.scala:2:16 [hint] "os-lib is outdated, update to 0.11.4" [hint] os-lib 0.10.7 -> com.lihaoyi::os-lib:0.11.4 [hint] //> using dep "com.lihaoyi::os-lib:0.10.7" [hint] ^^^^^^^^^^^^^^^^^^^^^^^^^^ ``` --- _overviews/getting-started/install-scala.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/getting-started/install-scala.md b/_overviews/getting-started/install-scala.md index df32bb7c44..0154e3b246 100644 --- a/_overviews/getting-started/install-scala.md +++ b/_overviews/getting-started/install-scala.md @@ -202,7 +202,7 @@ We use the [os-lib](https://github.com/com-lihaoyi/os-lib) library from the [Sca for that purpose. A dependency on the library can be added with the `//> using` directive. Put the following code in `counter.scala`. ```scala //> using scala {{site.scala-3-version}} -//> using dep "com.lihaoyi::os-lib:0.10.7" +//> using dep "com.lihaoyi::os-lib:0.11.4" @main def countFiles(): Unit = From 4f4a748c4a752a5cf495117a9e6f5078e9ad1ae3 Mon Sep 17 00:00:00 2001 From: Matt Bovel Date: Thu, 6 Mar 2025 16:23:41 +0100 Subject: [PATCH 3055/3075] Update compiler spree link (#3171) --- _overviews/contribute/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md index 0e7906e0dc..1daa8cc13b 100644 --- a/_overviews/contribute/index.md +++ b/_overviews/contribute/index.md @@ -24,7 +24,7 @@ compiler_resources: - title: "Join the Compiler Issue Spree" description: "A tri-weekly event where you can get mentored on the compiler. Register for participation here." icon: "fa fa-clipboard-user" - link: https://docs.google.com/forms/d/e/1FAIpQLSdhr5Y7QG9VGTGaPn5uS5v3Gz7VtnM5PW-vseZ9OpjseEiwYQ/viewform + link: https://airtable.com/app94nwzow5R6W1O6/pagvjIzxYnqTTlhwY/form - title: "Compiler Academy videos" description: "In-depth tours of the Scala 3 compiler's internals, aimed to help you get started." icon: "fa fa-circle-play" @@ -112,7 +112,7 @@ In the spree, regular project maintainers will mentor you to create your first c The [Scala 3 compiler](https://github.com/scala/scala3) is an open source project. If you are curious about contributing but don't know how to begin, the [Scala Center](https://scala.epfl.ch) runs the **Scala Compiler Academy** project to onboard and educate new people to the project. You can join the regular -**Issue Spree**, watch in-depth videos, and read the contributing guide: +**Compiler Issue Spree**, watch in-depth videos, and read the contributing guide: {% include inner-documentation-sections.html links=page.compiler_resources %} From 1f43bffd8f02b7515f08e1f2b2be4e56a2aeef0c Mon Sep 17 00:00:00 2001 From: Wojciech Mazur Date: Fri, 7 Mar 2025 13:12:24 +0100 Subject: [PATCH 3056/3075] Add API links for 3.6.4 and update jdk-compatibility (#3172) --- _config.yml | 2 +- _overviews/jdk-compatibility/overview.md | 2 +- api/all.md | 2 ++ 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/_config.yml b/_config.yml index b27d1b387d..a1fbe441ec 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.16 scala-212-version: 2.12.20 -scala-3-version: 3.6.3 +scala-3-version: 3.6.4 collections: style: diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index fbf263e3ef..7ef1d62fbb 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 24 (ea) | 3.6.4* | 3.3.6* | 2.13.16 | 2.12.21* | | +| 24 (ea) | 3.6.4 | 3.3.6* | 2.13.16 | 2.12.21* | | | 23 | 3.6.2 | 3.3.5 | 2.13.15 | 2.12.20 | | | 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | diff --git a/api/all.md b/api/all.md index 4ef460e114..7543731252 100644 --- a/api/all.md +++ b/api/all.md @@ -64,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.6.3 + * [Library API](https://www.scala-lang.org/api/3.6.3/) * Scala 3.6.2 * [Library API](https://www.scala-lang.org/api/3.6.2/) * Scala 3.5.2 From 282a1da3cd702c699ea301af3138d11ea1714e5d Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 12 Mar 2025 16:02:04 +0000 Subject: [PATCH 3057/3075] Bump json from 2.10.1 to 2.10.2 Bumps [json](https://github.com/ruby/json) from 2.10.1 to 2.10.2. - [Release notes](https://github.com/ruby/json/releases) - [Changelog](https://github.com/ruby/json/blob/master/CHANGES.md) - [Commits](https://github.com/ruby/json/compare/v2.10.1...v2.10.2) --- updated-dependencies: - dependency-name: json dependency-type: indirect ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 6240957b6b..7fab90a4a7 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -245,7 +245,7 @@ GEM gemoji (>= 3, < 5) html-pipeline (~> 2.2) jekyll (>= 3.0, < 5.0) - json (2.10.1) + json (2.10.2) kramdown (2.4.0) rexml kramdown-parser-gfm (1.1.0) From 34641808591953501b7a37d1fa6f388ab2c1173e Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 12 Mar 2025 16:09:15 +0000 Subject: [PATCH 3058/3075] Bump uri from 1.0.2 to 1.0.3 Bumps [uri](https://github.com/ruby/uri) from 1.0.2 to 1.0.3. - [Release notes](https://github.com/ruby/uri/releases) - [Commits](https://github.com/ruby/uri/compare/v1.0.2...v1.0.3) --- updated-dependencies: - dependency-name: uri dependency-type: indirect ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 7fab90a4a7..d2dfab0f0f 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -312,7 +312,7 @@ GEM tzinfo (2.0.6) concurrent-ruby (~> 1.0) unicode-display_width (1.8.0) - uri (1.0.2) + uri (1.0.3) webrick (1.9.1) yell (2.2.2) zeitwerk (2.7.2) From 11744de5464d751a284bd865325068cdd0ccc27c Mon Sep 17 00:00:00 2001 From: anttibraxbackup Date: Sun, 16 Mar 2025 11:42:18 +0200 Subject: [PATCH 3059/3075] Remove incorrect reference to "Java parameter name length" There is no practice in the Java community or "ecosystem" that would discourage short parameter names. On the contrary even the Java standard libraries often use single letter variable names when the purpose of the parameter is evident from the context. So I have removed the statement as it is simply incorrect. --- _style/naming-conventions.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_style/naming-conventions.md b/_style/naming-conventions.md index 7cdbc493fb..9ea2bd8084 100644 --- a/_style/naming-conventions.md +++ b/_style/naming-conventions.md @@ -356,8 +356,7 @@ for local names to be very short: def add(a: Int, b: Int) = a + b -This would be bad practice in languages like Java, but it is *good* -practice in Scala. This convention works because properly-written Scala +This convention works because properly-written Scala methods are quite short, only spanning a single expression and rarely going beyond a few lines. Few local names are used (including parameters), and so there is no need to contrive long, descriptive From d843be462dec08de5aa746a8683ccb77d05525a9 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 21 Mar 2025 23:47:41 +0000 Subject: [PATCH 3060/3075] Bump nokogiri from 1.18.3 to 1.18.4 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.18.3 to 1.18.4. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.18.3...v1.18.4) --- updated-dependencies: - dependency-name: nokogiri dependency-type: indirect ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index d2dfab0f0f..16a5f475b7 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -264,11 +264,11 @@ GEM minitest (5.25.4) net-http (0.6.0) uri - nokogiri (1.18.3-arm64-darwin) + nokogiri (1.18.4-arm64-darwin) racc (~> 1.4) - nokogiri (1.18.3-x64-mingw-ucrt) + nokogiri (1.18.4-x64-mingw-ucrt) racc (~> 1.4) - nokogiri (1.18.3-x86_64-linux-gnu) + nokogiri (1.18.4-x86_64-linux-gnu) racc (~> 1.4) octokit (4.25.1) faraday (>= 1, < 3) From 64e112f950bafb591f16e190c39b9fb6a0a0e385 Mon Sep 17 00:00:00 2001 From: dottybot Date: Sat, 22 Mar 2025 00:29:00 +0000 Subject: [PATCH 3061/3075] Update SIPs state --- _sips/sips/eference-able-package-objects.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_sips/sips/eference-able-package-objects.md b/_sips/sips/eference-able-package-objects.md index 9c6152d290..cfba956529 100644 --- a/_sips/sips/eference-able-package-objects.md +++ b/_sips/sips/eference-able-package-objects.md @@ -2,6 +2,6 @@ title: 'SIP-68: Reference-able Package Objects' status: under-review pull-request-number: 100 -stage: design +stage: implementation --- From d021c451564dc4ae89d33abc70d3ceda64dbf202 Mon Sep 17 00:00:00 2001 From: Parambir Singh Date: Sat, 22 Mar 2025 09:40:44 -0700 Subject: [PATCH 3062/3075] Fix a couple of typos in scala-for-java-programmers.md --- _overviews/tutorials/scala-for-java-programmers.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_overviews/tutorials/scala-for-java-programmers.md b/_overviews/tutorials/scala-for-java-programmers.md index 201feb2467..9d9264b825 100644 --- a/_overviews/tutorials/scala-for-java-programmers.md +++ b/_overviews/tutorials/scala-for-java-programmers.md @@ -506,7 +506,7 @@ to omit types, and when to specify them explicitly. ### Methods without arguments A small problem of the methods `re` and `im` is that, in -order to call them, one has to put an empty pair of parenthesis after +order to call them, one has to put an empty pair of parentheses after their name, as the following example shows: {% tabs method-call-with-args-demo class=tabs-scala-version %} @@ -811,7 +811,7 @@ code which typically makes use of these named parts. A programmer familiar with the object-oriented paradigm might wonder why define a single function for `eval` outside -the scope of `Tree`, and not make `eval` and abstract method in +the scope of `Tree`, and not make `eval` an abstract method in `Tree`, providing overrides in each subclass of `Tree`. We could have done it actually, it is a choice to make, which has From fe19c9c3a944a94d52f137715c3a9d2eb1bc0914 Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Thu, 27 Mar 2025 19:09:15 -0700 Subject: [PATCH 3063/3075] FAQ: Scala 3 vs 2: tilt it farther towards 3 (#3180) * FAQ: Scala 3 vs 2: tilt it farther towards 3 * review feedback --- _overviews/FAQ/index.md | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/_overviews/FAQ/index.md b/_overviews/FAQ/index.md index 35b99ef0a0..a3aa167c98 100644 --- a/_overviews/FAQ/index.md +++ b/_overviews/FAQ/index.md @@ -44,17 +44,15 @@ reasons for wanting to learn Scala. Don't sweat the decision too much. You can't go far wrong either way. It isn't that hard to switch later, in either direction. -Scala 2 remains a common and reasonable choice. Most Scala jobs are -still Scala 2 jobs. Scala 2 also has a somewhat bigger library -ecosystem, somewhat better tooling support, and somewhat wider -availability of learning materials. - -That said, these gaps are getting narrower every month. -Plenty of books are available, a rich library ecosystem already -exists, and there are more and more jobs using Scala 3. You should strongly -consider learning Scala 3. It's still fairly new, released in 2021. -But it's the future, and it's the best version for +Regardless, you should choose Scala 3 unless you have a specific reason +to need 2. Scala 3 is the future, and it's the best version for falling in love with the language and everything it has to offer. +Scala 3 has plenty of books, plenty of libraries, and high quality +tooling. + +That said, many Scala jobs are still Scala 2 jobs. In most cases, the +cause of that is simply inertia, especially at large shops. (But it can +sometimes be due to availability of specific libraries.) ### Where are Scala jobs advertised? From 1663ee2463db299cbdc06f972feb63ad13ac5e67 Mon Sep 17 00:00:00 2001 From: scarf Date: Fri, 4 Apr 2025 22:48:07 +0900 Subject: [PATCH 3064/3075] docs: bump sbt version to latest --- _overviews/scala3-book/tools-sbt.md | 4 ++-- _ru/scala3/book/tools-sbt.md | 4 ++-- _zh-cn/overviews/scala3-book/tools-sbt.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_overviews/scala3-book/tools-sbt.md b/_overviews/scala3-book/tools-sbt.md index 3c442fc962..08076d89a3 100644 --- a/_overviews/scala3-book/tools-sbt.md +++ b/_overviews/scala3-book/tools-sbt.md @@ -48,7 +48,7 @@ Create a file named _build.properties_ in the directory `project`, with the following content: ```text -sbt.version=1.6.1 +sbt.version=1.10.11 ``` Then create a file named _build.sbt_ in the project root directory that contains this line: @@ -358,7 +358,7 @@ Next, create a _build.properties_ file in the _project/_ subdirectory of your pr with this line: ```text -sbt.version=1.5.4 +sbt.version=1.10.11 ``` Next, create a _build.sbt_ file in the root directory of your project with these contents: diff --git a/_ru/scala3/book/tools-sbt.md b/_ru/scala3/book/tools-sbt.md index 6dd330c28e..1ff7d8a122 100644 --- a/_ru/scala3/book/tools-sbt.md +++ b/_ru/scala3/book/tools-sbt.md @@ -48,7 +48,7 @@ $ mkdir project Создайте файл с именем _build.properties_ в каталоге `project` со следующим содержимым: ```text -sbt.version=1.6.1 +sbt.version=1.10.11 ``` Затем создайте файл с именем _build.sbt_ в корневом каталоге проекта, содержащий следующую строку: @@ -354,7 +354,7 @@ $ mkdir project Затем создаем файл _build.properties_ в подкаталоге _project/_ проекта с такой строкой: ```text -sbt.version=1.5.4 +sbt.version=1.10.11 ``` Создаем файл _build.sbt_ в корневом каталоге проекта со следующим содержимым: diff --git a/_zh-cn/overviews/scala3-book/tools-sbt.md b/_zh-cn/overviews/scala3-book/tools-sbt.md index d77b8d6286..2b158d1126 100644 --- a/_zh-cn/overviews/scala3-book/tools-sbt.md +++ b/_zh-cn/overviews/scala3-book/tools-sbt.md @@ -50,7 +50,7 @@ $ mkdir project 以下内容： ```text -sbt.version=1.6.1 +sbt.version=1.10.11 ``` 然后在包含此行的项目根目录中创建一个名为 _build.sbt_ 的文件： @@ -350,7 +350,7 @@ $ mkdir project 接下来，把下面这行代码用于在项目的 _project/_ 子目录中创建一个 _build.properties_ 文件： ```text -sbt.version=1.5.4 +sbt.version=1.10.11 ``` 接下来，在项目的根目录中创建一个 _build.sbt_ 文件，其中包含以下内容： From ce6ea82f13036ac376c054283d1f01d43067b769 Mon Sep 17 00:00:00 2001 From: philippus Date: Fri, 18 Apr 2025 16:42:54 +0200 Subject: [PATCH 3065/3075] Bump runner image to ubuntu-22.04 --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 451559d85c..e56f07a0ab 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -2,7 +2,7 @@ name: Build on: [push, pull_request] jobs: build: - runs-on: ubuntu-20.04 + runs-on: ubuntu-22.04 steps: - uses: actions/checkout@v4 - name: Set up Ruby From d44c0ce9171c34f5e9126b49e3ec016e527c4c4f Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 22 Apr 2025 04:51:48 +0000 Subject: [PATCH 3066/3075] Bump nokogiri from 1.18.4 to 1.18.8 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.18.4 to 1.18.8. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.18.4...v1.18.8) --- updated-dependencies: - dependency-name: nokogiri dependency-version: 1.18.8 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 16a5f475b7..8088be3873 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -264,11 +264,11 @@ GEM minitest (5.25.4) net-http (0.6.0) uri - nokogiri (1.18.4-arm64-darwin) + nokogiri (1.18.8-arm64-darwin) racc (~> 1.4) - nokogiri (1.18.4-x64-mingw-ucrt) + nokogiri (1.18.8-x64-mingw-ucrt) racc (~> 1.4) - nokogiri (1.18.4-x86_64-linux-gnu) + nokogiri (1.18.8-x86_64-linux-gnu) racc (~> 1.4) octokit (4.25.1) faraday (>= 1, < 3) From 655689c4e1a392ed76aa5d01ba821ce825aea352 Mon Sep 17 00:00:00 2001 From: philippus Date: Fri, 25 Apr 2025 16:43:30 +0200 Subject: [PATCH 3067/3075] Remove nullary-override compiler option --- _data/compiler-options.yml | 4 ---- 1 file changed, 4 deletions(-) diff --git a/_data/compiler-options.yml b/_data/compiler-options.yml index a034586c42..f4cced5028 100644 --- a/_data/compiler-options.yml +++ b/_data/compiler-options.yml @@ -379,8 +379,6 @@ description: "Warn when nullary methods return Unit." - choice: "inaccessible" description: "Warn about inaccessible types in method signatures." - - choice: "nullary-override" - description: "Warn when non-nullary `def f()` overrides nullary `def f`." - choice: "infer-any" description: "Warn when a type argument is inferred to be `Any`." - choice: "missing-interpolator" @@ -1135,8 +1133,6 @@ description: "Warn when nullary methods return Unit." - choice: "inaccessible" description: "Warn about inaccessible types in method signatures." - - choice: "nullary-override" - description: "Warn when non-nullary `def f()` overrides nullary `def f`." - choice: "infer-any" description: "Warn when a type argument is inferred to be `Any`." - choice: "missing-interpolator" From daac5f352349486b2e7c34386a2d09bb53a9d944 Mon Sep 17 00:00:00 2001 From: matsuyoshi30 Date: Tue, 29 Apr 2025 12:15:10 +0900 Subject: [PATCH 3068/3075] fix typo --- _ja/tour/higher-order-functions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_ja/tour/higher-order-functions.md b/_ja/tour/higher-order-functions.md index 773ca7170b..95c069dc4f 100644 --- a/_ja/tour/higher-order-functions.md +++ b/_ja/tour/higher-order-functions.md @@ -40,7 +40,7 @@ Scalaコンパイラはパラメーターの型を（Intが1つだけと）既 唯一の注意点はパラメータ名の代わりに`_`を使う必要があるということです（先の例では`x`でした）。 ## メソッドを関数に強制変換 -高階関数には引数としてとしてメソッドを渡すことも可能で、それはScalaコンパイラがメソッドを関数に強制変換するからです。 +高階関数には引数としてメソッドを渡すことも可能で、それはScalaコンパイラがメソッドを関数に強制変換するからです。 ```scala mdoc case class WeeklyWeatherForecast(temperatures: Seq[Double]) { From 36ac7289a97da6be8d0d733030e2a3155284fbc3 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur Date: Wed, 7 May 2025 12:42:42 +0200 Subject: [PATCH 3069/3075] Add API links for 3.7.0 and update JDK compatibility table (#3188) * Add Scala 3.7.0 * Add JDK 25 compatibility table entry --- _config.yml | 2 +- _overviews/jdk-compatibility/overview.md | 3 ++- api/all.md | 2 ++ 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/_config.yml b/_config.yml index a1fbe441ec..d394190267 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.16 scala-212-version: 2.12.20 -scala-3-version: 3.6.4 +scala-3-version: 3.7.0 collections: style: diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 7ef1d62fbb..d03b3cb34d 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,8 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 24 (ea) | 3.6.4 | 3.3.6* | 2.13.16 | 2.12.21* | | +| 25 (ea) | 3.7.1* | 3.3.6* | 2.13.17* | 2.12.21* | | +| 24 | 3.6.4 | 3.3.6* | 2.13.16 | 2.12.21* | | | 23 | 3.6.2 | 3.3.5 | 2.13.15 | 2.12.20 | | | 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | diff --git a/api/all.md b/api/all.md index 7543731252..44d3bdf717 100644 --- a/api/all.md +++ b/api/all.md @@ -64,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.6.4 + * [Library API](https://www.scala-lang.org/api/3.6.4/) * Scala 3.6.3 * [Library API](https://www.scala-lang.org/api/3.6.3/) * Scala 3.6.2 From 1bebf7a854dea638ee0b618197b1a6e2c5766e35 Mon Sep 17 00:00:00 2001 From: Tomasz Godzik Date: Thu, 8 May 2025 12:55:27 +0200 Subject: [PATCH 3070/3075] chore: Update Scala 3.3.6 (#3190) --- _overviews/jdk-compatibility/overview.md | 4 ++-- api/all.md | 6 ++++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index d03b3cb34d..3e38ea0602 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,8 +14,8 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 25 (ea) | 3.7.1* | 3.3.6* | 2.13.17* | 2.12.21* | | -| 24 | 3.6.4 | 3.3.6* | 2.13.16 | 2.12.21* | | +| 25 (ea) | 3.7.1* | 3.3.6 | 2.13.17* | 2.12.21* | | +| 24 | 3.6.4 | 3.3.6 | 2.13.16 | 2.12.21* | | | 23 | 3.6.2 | 3.3.5 | 2.13.15 | 2.12.20 | | | 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | | 21 (LTS) | 3.4.0 | 3.3.1 | 2.13.11 | 2.12.18 | | diff --git a/api/all.md b/api/all.md index 44d3bdf717..601c393dd6 100644 --- a/api/all.md +++ b/api/all.md @@ -10,8 +10,8 @@ redirect_from: * Scala {{site.scala-3-version}} * [Library API](https://www.scala-lang.org/api/{{site.scala-3-version}}/) -* Scala 3.3.5 LTS - * [Library API](https://www.scala-lang.org/api/3.3.5/) +* Scala 3.3.6 LTS + * [Library API](https://www.scala-lang.org/api/3.3.6/) * Scala 2.13.16 * [Library API](https://www.scala-lang.org/api/2.13.16/) * [Compiler API](https://www.scala-lang.org/api/2.13.16/scala-compiler/scala/) @@ -84,6 +84,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ * [Library API](https://www.scala-lang.org/api/3.4.1/) * Scala 3.4.0 * [Library API](https://www.scala-lang.org/api/3.4.0/) +* Scala 3.3.5 LTS + * [Library API](https://www.scala-lang.org/api/3.3.5/) * Scala 3.3.4 LTS * [Library API](https://www.scala-lang.org/api/3.3.4/) * Scala 3.3.3 LTS From 1ae6d880f8a2298ab5150e88740ce5672b16a89a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=8BAndrzej=20Ressel?= Date: Fri, 9 May 2025 09:15:35 +0200 Subject: [PATCH 3071/3075] Fix typo (#3187) * Fix typo * Update _overviews/scala3-macros/tutorial/quotes.md Co-authored-by: Philippus Baalman --------- Co-authored-by: Philippus Baalman --- _overviews/scala3-macros/tutorial/quotes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_overviews/scala3-macros/tutorial/quotes.md b/_overviews/scala3-macros/tutorial/quotes.md index 30b6aa9295..b94d4bb6ab 100644 --- a/_overviews/scala3-macros/tutorial/quotes.md +++ b/_overviews/scala3-macros/tutorial/quotes.md @@ -433,7 +433,7 @@ As with expression quote patterns, type variables are represented using lower ca ## FromExpr -The `Expr.value`, `Expr.valueOrAbort`, and `Expr.unapply` methods uses intances of `FromExpr` to extract the value if possible. +The `Expr.value`, `Expr.valueOrAbort`, and `Expr.unapply` methods use instances of `FromExpr` to extract the value if possible. ```scala extension [T](expr: Expr[T]): def value(using Quotes)(using fromExpr: FromExpr[T]): Option[T] = From 18baf49c9c8bad5a2f161df78624ef90c43327df Mon Sep 17 00:00:00 2001 From: DespiteDeath Date: Fri, 16 May 2025 14:12:21 +0300 Subject: [PATCH 3072/3075] Update abstract-type-members.md (#3193) --- _ru/tour/abstract-type-members.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/_ru/tour/abstract-type-members.md b/_ru/tour/abstract-type-members.md index a56239034c..537ebf80f4 100644 --- a/_ru/tour/abstract-type-members.md +++ b/_ru/tour/abstract-type-members.md @@ -10,7 +10,7 @@ topics: abstract type members prerequisite-knowledge: variance, upper-type-bound --- -Абстрактные типы, такие как трейты и абстрактные классы, могут содержать членов абстрактного типа. +Абстрактные типы, такие как трейты и абстрактные классы, могут содержать члены абстрактного типа. Абстрактный означает, что только конкретный экземпляр определяет, каким именно будет тип. Вот пример: @@ -36,7 +36,7 @@ trait Buffer: {% endtab %} {% endtabs %} -Здесь мы определили абстрактный тип `T`, который используется для описания типа члена `element`. Мы можем расширить его в абстрактном классе, добавив верхнюю границу нового типа `U` связанного с `T`, делая описание типа более конкретным. +Здесь мы определили абстрактный тип `T`, который используется для описания типа члена `element`. Мы можем расширить его в абстрактном классе, добавив верхнюю границу нового типа `U`, связанного с `T`, делая описание типа более конкретным. {% tabs abstract-types_2 class=tabs-scala-version %} {% tab 'Scala 2' for=abstract-types_2 %} @@ -64,7 +64,7 @@ abstract class SeqBuffer extends Buffer: Обратите внимание, как мы можем использовать новый абстрактный тип `U` в качестве верхней границы типа. Класс `SeqBuffer` позволяет хранить в буфере только последовательности, указывая, что тип `T` должен быть подтипом `Seq[U]` для нового абстрактного типа `U`. -[Трейты](traits.html) или [классы](classes.html) с членами абстрактного типа часто используются в сочетании с анонимными экземплярами классов. Чтобы проиллюстрировать это рассмотрим программу, которая имеет дело с буфером, который ссылается на список целых чисел: +[Трейты](traits.html) или [классы](classes.html) с членами абстрактного типа часто используются в сочетании с анонимными экземплярами классов. Чтобы проиллюстрировать это рассмотрим программу, имеющую дело с буфером, который ссылается на список целых чисел: {% tabs abstract-types_3 class=tabs-scala-version %} {% tab 'Scala 2' for=abstract-types_3 %} @@ -104,9 +104,9 @@ println("content = " + buf.element) {% endtab %} {% endtabs %} -Здесь класс `newIntSeqBuf` создает экземпляры `IntSeqBuffer`, используя анонимную реализацию класса `IntSeqBuffer` (т.е. `new IntSeqBuffer`), устанавливая тип `T` как `List[Int]`. +Здесь метод `newIntSeqBuf` создает экземпляры `IntSeqBuffer`, используя анонимную реализацию класса `IntSeqBuffer` (т.е. `new IntSeqBuffer`), устанавливая тип `T` как `List[Int]`. -Мы можем вывести тип класса из типа его членов и наоборот. Приведем версию кода, в которой выводится тип класса из типа его члена: +Мы можем вывести тип класса из типа его членов и наоборот. Приведем версию кода, в которой выводится тип класса из типов его члена: {% tabs abstract-types_4 class=tabs-scala-version %} {% tab 'Scala 2' for=abstract-types_4 %} From 2b612762460ecde204d54fd2afcbd5d77d06fc78 Mon Sep 17 00:00:00 2001 From: Wojciech Mazur Date: Wed, 4 Jun 2025 15:43:16 +0200 Subject: [PATCH 3073/3075] Add API links for 3.7.1 and update JDK compatibility table (#3195) --- _config.yml | 2 +- _overviews/jdk-compatibility/overview.md | 2 +- api/all.md | 2 ++ 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/_config.yml b/_config.yml index d394190267..e1ed8d682e 100644 --- a/_config.yml +++ b/_config.yml @@ -17,7 +17,7 @@ keywords: scala-version: 2.13.16 scala-212-version: 2.12.20 -scala-3-version: 3.7.0 +scala-3-version: 3.7.1 collections: style: diff --git a/_overviews/jdk-compatibility/overview.md b/_overviews/jdk-compatibility/overview.md index 3e38ea0602..c42ee96090 100644 --- a/_overviews/jdk-compatibility/overview.md +++ b/_overviews/jdk-compatibility/overview.md @@ -14,7 +14,7 @@ Minimum Scala versions: | JDK | 3 | 3 LTS | 2.13 | 2.12 | 2.11 | |:-----------:|:--------:|:--------:|:---------:|:---------:|:----------:| -| 25 (ea) | 3.7.1* | 3.3.6 | 2.13.17* | 2.12.21* | | +| 25 (ea) | 3.7.1 | 3.3.6 | 2.13.17* | 2.12.21* | | | 24 | 3.6.4 | 3.3.6 | 2.13.16 | 2.12.21* | | | 23 | 3.6.2 | 3.3.5 | 2.13.15 | 2.12.20 | | | 22 | 3.4.0 | 3.3.4 | 2.13.13 | 2.12.19 | | diff --git a/api/all.md b/api/all.md index 601c393dd6..6f049664b7 100644 --- a/api/all.md +++ b/api/all.md @@ -64,6 +64,8 @@ https://scala-ci.typesafe.com/artifactory/scala-integration/org/scala-lang/ ## Previous releases +* Scala 3.7.0 + * [Library API](https://www.scala-lang.org/api/3.7.0/) * Scala 3.6.4 * [Library API](https://www.scala-lang.org/api/3.6.4/) * Scala 3.6.3 From 66af3f24dcaca114d043b236a87bef99b7451a51 Mon Sep 17 00:00:00 2001 From: melodylx <2135929866@qq.com> Date: Thu, 5 Jun 2025 16:42:03 +0800 Subject: [PATCH 3074/3075] Fix typo --- _zh-cn/overviews/reflection/overview.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_zh-cn/overviews/reflection/overview.md b/_zh-cn/overviews/reflection/overview.md index fb80386e2a..25f54810e9 100644 --- a/_zh-cn/overviews/reflection/overview.md +++ b/_zh-cn/overviews/reflection/overview.md @@ -85,7 +85,7 @@ decls: Iterable[ru.Symbol] = List(constructor List, method companion, method isE #### 1.1.2 运行时实例化一个类型 -通过反射获得的类型，可以通过使用适当的“调用器”镜像调用它们的构造函数来实例化（镜像`mirros`的概念在[后续文档中说明](https://docs.scala-lang.org/overviews/reflection/overview.html#mirrors)）。 +通过反射获得的类型，可以通过使用适当的“调用器”镜像调用它们的构造函数来实例化（镜像`mirrors`的概念在[后续文档中说明](https://docs.scala-lang.org/overviews/reflection/overview.html#mirrors)）。 让我们通过一个REPL的示例说明： @@ -269,7 +269,7 @@ Scala反射实现了允许在编译阶段就对程序进行修改的一种元编 这个反射环境根据是在运行时环境完成反射任务还是在编译时环境完成反射任务而有所区别。 这个区别被封装于所谓的`universe`中。 反射环境的另一个重要方面就是我们可以访问想反射的那组实体， -这组实体由所谓的镜像`mirros`去确定。 +这组实体由所谓的镜像`mirrors`去确定。 镜像不仅决定反射化操作有哪些实体要被访问到，而且它还提供了反射操作去执行那些实体。 比如在运行时反射过程中可以调用镜像去操作类中一个方法或构造器。 @@ -293,4 +293,4 @@ import scala.reflect.runtime.universe._ 反射所能提供的信息都是通过镜像去访问的。 根据不同的类型信息或不同的反射操作，必须要使用不同类型的镜像。 -更多细节请参阅指南中[Mirros](https://docs.scala-lang.org/overviews/reflection/environment-universes-mirrors.html)部分，或者看`scala.reflect.api`包的[Mirrors API文档](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Mirrors.html)。 +更多细节请参阅指南中[Mirrors](https://docs.scala-lang.org/overviews/reflection/environment-universes-mirrors.html)部分，或者看`scala.reflect.api`包的[Mirrors API文档](https://www.scala-lang.org/api/2.x/scala-reflect/scala/reflect/api/Mirrors.html)。 From 4bb02eba0d9b370c2a787c21b9683292990a9504 Mon Sep 17 00:00:00 2001 From: xuwei-k <6b656e6a69@gmail.com> Date: Sun, 8 Jun 2025 08:05:42 +0900 Subject: [PATCH 3075/3075] Update scala3 github link --- _overviews/scala3-scaladoc/settings.md | 2 +- _sips/sips/alternative-bind-variables.md | 2 +- _sips/sips/better-fors.md | 4 ++-- _sips/sips/binary-api.md | 10 +++++----- _sips/sips/byname-implicits.md | 4 ++-- _sips/sips/clause-interleaving.md | 2 +- _sips/sips/fewer-braces.md | 4 ++-- _sips/sips/interpolation-quote-escape.md | 2 +- _sips/sips/match-types-spec.md | 4 ++-- _sips/sips/multi-source-extension-overloads.md | 2 +- _sips/sips/named-tuples.md | 2 +- _sips/sips/polymorphic-eta-expansion.md | 2 +- _sips/sips/priority-based-infix-type-precedence.md | 2 +- _sips/sips/quote-pattern-type-variable-syntax.md | 8 ++++---- _sips/sips/trait-parameters.md | 2 +- 15 files changed, 26 insertions(+), 26 deletions(-) diff --git a/_overviews/scala3-scaladoc/settings.md b/_overviews/scala3-scaladoc/settings.md index 3b58df7bae..1fae4d3d5f 100644 --- a/_overviews/scala3-scaladoc/settings.md +++ b/_overviews/scala3-scaladoc/settings.md @@ -182,7 +182,7 @@ Define the additional sbt configuration for your Scastie snippets. For example, ##### -dynamic-side-menu -Generate the side menu (the tree-like overview of the project structure on the left-hand side) dynamically in the browser using JavaScript instead of embedding it in every HTML file. This can greatly reduce outputted HTML file sizes. Recommended for projects with 1000+ pages. For more info see [issue 18543](https://github.com/lampepfl/dotty/issues/18543). +Generate the side menu (the tree-like overview of the project structure on the left-hand side) dynamically in the browser using JavaScript instead of embedding it in every HTML file. This can greatly reduce outputted HTML file sizes. Recommended for projects with 1000+ pages. For more info see [issue 18543](https://github.com/scala/scala3/issues/18543). ##### -Ysnippet-compiler-debug diff --git a/_sips/sips/alternative-bind-variables.md b/_sips/sips/alternative-bind-variables.md index 55e243dbd6..ab6899a026 100644 --- a/_sips/sips/alternative-bind-variables.md +++ b/_sips/sips/alternative-bind-variables.md @@ -317,7 +317,7 @@ The associated [thread](https://contributors.scala-lang.org/t/pre-sip-bind-varia ## Implementation The author has a current in-progress implementation focused on the typer which compiles the examples with the expected types. Interested - parties are welcome to see the WIP [here](https://github.com/lampepfl/dotty/compare/main...yilinwei:dotty:main). + parties are welcome to see the WIP [here](https://github.com/scala/scala3/compare/main...yilinwei:dotty:main). ### Further work diff --git a/_sips/sips/better-fors.md b/_sips/sips/better-fors.md index 54ba1b8e31..10cfa733ea 100644 --- a/_sips/sips/better-fors.md +++ b/_sips/sips/better-fors.md @@ -472,9 +472,9 @@ The only Open community build library that failed because of the change to the d ## Links 1. Scala contributors discussion thread (pre-SIP): https://contributors.scala-lang.org/t/pre-sip-improve-for-comprehensions-functionality/3509/51 -2. Github issue discussion about for desugaring: https://github.com/lampepfl/dotty/issues/2573 +2. Github issue discussion about for desugaring: https://github.com/scala/scala3/issues/2573 3. Scala 2 implementation of some of the improvements: https://github.com/oleg-py/better-monadic-for -4. Implementation of one of the simplifications: https://github.com/lampepfl/dotty/pull/16703 +4. Implementation of one of the simplifications: https://github.com/scala/scala3/pull/16703 5. Draft implementation branch: https://github.com/dotty-staging/dotty/tree/improved-fors 6. Minimized issue reproducing the problem with the current desugaring: https://github.com/scala/scala3/issues/21804 7. (empty :sad:) Contributors thread about better effect loops with for-comprehensions: https://contributors.scala-lang.org/t/pre-sip-sip-62-addition-proposal-better-effect-loops-with-for-comprehensions/6759 diff --git a/_sips/sips/binary-api.md b/_sips/sips/binary-api.md index 2e532ffc3f..e94bf85a54 100644 --- a/_sips/sips/binary-api.md +++ b/_sips/sips/binary-api.md @@ -33,7 +33,7 @@ Currently, the compiler automatically generates accessors for references to priv * Changing the implementation of an inline definition can be a binary incompatible change * Removing final from a class is a binary incompatible change -You can find more details in [https://github.com/lampepfl/dotty/issues/16983](https://github.com/lampepfl/dotty/issues/16983) +You can find more details in [https://github.com/scala/scala3/issues/16983](https://github.com/scala/scala3/issues/16983) ### Avoid duplication of inline accessors @@ -249,7 +249,7 @@ Using references to `@publicInBinary` in inline code can cause binary incompatib ### Add a `@binaryAccessor` This annotation would generate an stable accessor. This annotation could be used on `private` definition. It would also mitigate [migration costs](https://gist.github.com/nicolasstucki/003f7293941836b08a0d53dbcb913e3c) for library authors that have published unstable accessors. -* Implementation https://github.com/lampepfl/dotty/pull/16992 +* Implementation https://github.com/scala/scala3/pull/16992 ### Make all `private[C]` part of the binary API @@ -268,9 +268,9 @@ The drawback of this approach is that that we would need to force users to keep ## Related work -* Initial discussions: [https://github.com/lampepfl/dotty/issues/16983](https://github.com/lampepfl/dotty/issues/16983) -* Initial proof of concept (outdated): [https://github.com/lampepfl/dotty/pull/16992](https://github.com/lampepfl/dotty/pull/16992) -* Single annotation proof of concept: [https://github.com/lampepfl/dotty/pull/18402](https://github.com/lampepfl/dotty/pull/18402) +* Initial discussions: [https://github.com/scala/scala3/issues/16983](https://github.com/scala/scala3/issues/16983) +* Initial proof of concept (outdated): [https://github.com/scala/scala3/pull/16992](https://github.com/scala/scala3/pull/16992) +* Single annotation proof of concept: [https://github.com/scala/scala3/pull/18402](https://github.com/scala/scala3/pull/18402) * Community migration analysis: [Gist](https://gist.github.com/nicolasstucki/003f7293941836b08a0d53dbcb913e3c) * Kotlin: [PublishedApi](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-published-api/) plays the same role as `@publicInBinary` but its interaction with (inline definitions)[https://kotlinlang.org/docs/inline-functions.html#restrictions-for-public-api-inline-functions] diff --git a/_sips/sips/byname-implicits.md b/_sips/sips/byname-implicits.md index 24b701ee20..fd63269068 100644 --- a/_sips/sips/byname-implicits.md +++ b/_sips/sips/byname-implicits.md @@ -39,7 +39,7 @@ the knot" implicitly. ### Implementation status -Byname implicits have been implemented in [Dotty](https://github.com/lampepfl/dotty/issues/1998) +Byname implicits have been implemented in [Dotty](https://github.com/scala/scala3/issues/1998) with an earlier iteration of the divergence checking algorithm described below. A full implementation of this proposal exists as a [pull request](https://github.com/scala/scala/pull/6050) relative to the 2.13.x branch of the Lightbend Scala compiler and it is scheduled to be included in @@ -851,7 +851,7 @@ object Test { because the path `foo` in `foo.Out` is not stable. Full parity with shapeless's `Lazy` would require lazy (rather than byname) implicit parameters (see [this Dotty -ticket](https://github.com/lampepfl/dotty/issues/3005) for further discussion) and is orthogonal to +ticket](https://github.com/scala/scala3/issues/3005) for further discussion) and is orthogonal to this SIP in that they would drop out of support for lazy parameters more generally, as described in [this Scala ticket](https://github.com/scala/bug/issues/240). diff --git a/_sips/sips/clause-interleaving.md b/_sips/sips/clause-interleaving.md index 5e24c4f700..e9809815e2 100644 --- a/_sips/sips/clause-interleaving.md +++ b/_sips/sips/clause-interleaving.md @@ -167,7 +167,7 @@ As discussed above, we may want to consider generalizing class parameter lists a ## Related work * Pre-SIP: [https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525](https://contributors.scala-lang.org/t/clause-interweaving-allowing-def-f-t-x-t-u-y-u/5525) -* An implementation of the proposal is available as a pull request at [https://github.com/lampepfl/dotty/pull/14019](https://github.com/lampepfl/dotty/pull/14019) +* An implementation of the proposal is available as a pull request at [https://github.com/scala/scala3/pull/14019](https://github.com/scala/scala3/pull/14019) ## FAQ Currently empty. diff --git a/_sips/sips/fewer-braces.md b/_sips/sips/fewer-braces.md index e220480796..321f665233 100644 --- a/_sips/sips/fewer-braces.md +++ b/_sips/sips/fewer-braces.md @@ -131,7 +131,7 @@ If there would be code using these idioms, it can be rewritten quite simply to a ### Tooling -Since this affects parsing, the scalameta parser and any other parser used in an IDE will also need to be updated. The necessary changes to the Scala 3 parser were made here: https://github.com/lampepfl/dotty/pull/15273/commits. The commit that embodies the core change set is here: https://github.com/lampepfl/dotty/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a. +Since this affects parsing, the scalameta parser and any other parser used in an IDE will also need to be updated. The necessary changes to the Scala 3 parser were made here: https://github.com/scala/scala3/pull/15273/commits. The commit that embodies the core change set is here: https://github.com/scala/scala3/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a. ### Handling Edge Cases @@ -288,7 +288,7 @@ This is a tradeoff between conciseness and consistency. In the interest of minim - Doc page for proposed change: https://dotty.epfl.ch/docs/reference/other-new-features/indentation.html#variant-indentation-marker--for-arguments - - Merged PR implementing the proposal under experimental flag: https://github.com/lampepfl/dotty/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a + - Merged PR implementing the proposal under experimental flag: https://github.com/scala/scala3/pull/15273/commits/421bdd660b0456c2ff1ae386f032c41bb1e0212a - Latest discussion on contributors (there were several before when we discussed indentation in general): https://contributors.scala-lang.org/t/make-fewerbraces-available-outside-snapshot-releases/5024/166 diff --git a/_sips/sips/interpolation-quote-escape.md b/_sips/sips/interpolation-quote-escape.md index 4602cbaa5c..6f0398ce33 100644 --- a/_sips/sips/interpolation-quote-escape.md +++ b/_sips/sips/interpolation-quote-escape.md @@ -129,4 +129,4 @@ proposals. [^4]: https://github.com/scala/bug/issues/6476#issuecomment-292412577 "@retronym said: +1 to s"$"". Because it doesn't compile today, we don't risk changing the meaning of existing programs." [^5]: https://github.com/Scala/Scala/pull/6953/files#diff-0023b3bfa053fb16603156b785efa7ad "" [^6]: https://github.com/Scala/Scala/pull/4308 "SI-6476 Accept escaped quotes in interp strings" -[^7]: https://github.com/lampepfl/dotty/pull/7486 "PR in dotty" +[^7]: https://github.com/scala/scala3/pull/7486 "PR in dotty" diff --git a/_sips/sips/match-types-spec.md b/_sips/sips/match-types-spec.md index 2025da63eb..049fad9415 100644 --- a/_sips/sips/match-types-spec.md +++ b/_sips/sips/match-types-spec.md @@ -95,7 +95,7 @@ It is however not possible to guarantee that property for *all* cases, since the #### Preamble Some of the concepts mentioned here are defined in the existing Scala 3 specification draft. -That draft can be found in the dotty repository at https://github.com/lampepfl/dotty/tree/main/docs/_spec. +That draft can be found in the dotty repository at https://github.com/scala/scala3/tree/main/docs/_spec. It is not rendered anywhere yet, though. Here are some of the relevant concepts that are perhaps lesser-known: @@ -583,7 +583,7 @@ Notable prior work related to this proposal includes: - [Current reference page for Scala 3 match types](https://dotty.epfl.ch/docs/reference/new-types/match-types.html) - [Abstractions for Type-Level Programming](https://infoscience.epfl.ch/record/294024), Olivier Blanvillain, Chapter 4 (Match Types) - ["Pre-Sip" discussion in the Contributors forum](https://contributors.scala-lang.org/t/pre-sip-proper-specification-for-match-types/6265) (submitted at the same time as this SIP document) -- [PR with the proposed implementation](https://github.com/lampepfl/dotty/pull/18262) +- [PR with the proposed implementation](https://github.com/scala/scala3/pull/18262) ## FAQ diff --git a/_sips/sips/multi-source-extension-overloads.md b/_sips/sips/multi-source-extension-overloads.md index 2fd0bd096e..fdcfd7050b 100644 --- a/_sips/sips/multi-source-extension-overloads.md +++ b/_sips/sips/multi-source-extension-overloads.md @@ -226,7 +226,7 @@ A number of alternatives were mentioned in [the Contributors thread](https://con ## Related work - [Contributors thread acting as de facto Pre-SIP](https://contributors.scala-lang.org/t/change-shadowing-mechanism-of-extension-methods-for-on-par-implicit-class-behavior/5831) -- [Pull Request in dotty](https://github.com/lampepfl/dotty/pull/17050) to support it under an experimental import +- [Pull Request in dotty](https://github.com/scala/scala3/pull/17050) to support it under an experimental import ## FAQ diff --git a/_sips/sips/named-tuples.md b/_sips/sips/named-tuples.md index 995d409031..431107cd14 100644 --- a/_sips/sips/named-tuples.md +++ b/_sips/sips/named-tuples.md @@ -382,7 +382,7 @@ This section should list prior work related to the proposal, notably: - [SIP 43 on Pattern Matching with Named Fields](https://github.com/scala/improvement-proposals/pull/44) -- [Experimental Implementation](https://github.com/lampepfl/dotty/pull/19174) +- [Experimental Implementation](https://github.com/scala/scala3/pull/19174) ## FAQ diff --git a/_sips/sips/polymorphic-eta-expansion.md b/_sips/sips/polymorphic-eta-expansion.md index 4883a5469c..4099e05cc8 100644 --- a/_sips/sips/polymorphic-eta-expansion.md +++ b/_sips/sips/polymorphic-eta-expansion.md @@ -420,7 +420,7 @@ No other alternatives have been imagined, the similarity between this proposal a - If there is already a proof-of-concept implementation, a link to it will be welcome here. --> * Pre-SIP: https://contributors.scala-lang.org/t/polymorphic-eta-expansion/5516 -* A naive implementation can be found at https://github.com/lampepfl/dotty/pull/14015 (it is more general than this proposal and thus breaks compatibility) +* A naive implementation can be found at https://github.com/scala/scala3/pull/14015 (it is more general than this proposal and thus breaks compatibility) * A compatibility-preserving implementation is in development. diff --git a/_sips/sips/priority-based-infix-type-precedence.md b/_sips/sips/priority-based-infix-type-precedence.md index 55c8af6566..a67d84dbb5 100644 --- a/_sips/sips/priority-based-infix-type-precedence.md +++ b/_sips/sips/priority-based-infix-type-precedence.md @@ -137,7 +137,7 @@ However, it is very unlikely that such interaction would occur. **Related Issues** -* [Dotty Issue #1961](https://github.com/lampepfl/dotty/issues/1961) +* [Dotty Issue #1961](https://github.com/scala/scala3/issues/1961) ## Backward Compatibility diff --git a/_sips/sips/quote-pattern-type-variable-syntax.md b/_sips/sips/quote-pattern-type-variable-syntax.md index f8a624f971..64f58fafb8 100644 --- a/_sips/sips/quote-pattern-type-variable-syntax.md +++ b/_sips/sips/quote-pattern-type-variable-syntax.md @@ -61,11 +61,11 @@ We want to be able to set the bounds of type variables to be able to match again ```scala case '[ head *: tail ] => h[tail] ``` -See [https://github.com/lampepfl/dotty/issues/11738](https://github.com/lampepfl/dotty/issues/11738). +See [https://github.com/scala/scala3/issues/11738](https://github.com/scala/scala3/issues/11738). ### Support matching on any kind of type We want to match against higher-kinded (or `AnyKind`) types. This is not possible due to the default upper bound of `Any`. -See [https://github.com/lampepfl/dotty/issues/10864](https://github.com/lampepfl/dotty/issues/10864). +See [https://github.com/scala/scala3/issues/10864](https://github.com/scala/scala3/issues/10864). ### Support multiple references to the same type in quoted type patterns We want to be able to match using several references to the same type variable. @@ -137,8 +137,8 @@ TASTy only contains explicit type variable definitions, and this encoding would ## Related work -* Proof of concept of type variable syntax: [https://github.com/lampepfl/dotty/pull/16910](https://github.com/lampepfl/dotty/pull/16910) -* Proof of concept of backticks (only interested in the first bullet point): [https://github.com/lampepfl/dotty/pull/16935](https://github.com/lampepfl/dotty/pull/16935) +* Proof of concept of type variable syntax: [https://github.com/scala/scala3/pull/16910](https://github.com/scala/scala3/pull/16910) +* Proof of concept of backticks (only interested in the first bullet point): [https://github.com/scala/scala3/pull/16935](https://github.com/scala/scala3/pull/16935) * Implementation: [https://github.com/scala/scala3/pull/17362](https://github.com/scala/scala3/pull/17362) * Stabilized implementation: [https://github.com/scala/scala3/pull/18574](https://github.com/scala/scala3/pull/18574) diff --git a/_sips/sips/trait-parameters.md b/_sips/sips/trait-parameters.md index 93bcd8bf70..633f0c0b73 100644 --- a/_sips/sips/trait-parameters.md +++ b/_sips/sips/trait-parameters.md @@ -69,4 +69,4 @@ the evaluation order would be `e1`, initializer of `T`, `e2`, initializer of `V` ## See Also ## -[Dotty Issue #640](https://github.com/lampepfl/dotty/issues/640) +[Dotty Issue #640](https://github.com/scala/scala3/issues/640)

    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 z

    h<8mWI@g-j2={w{T&vSKr^Ldv^ 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

    • From 113f485c10c9143d9a5f081974a87061903b5a0d Mon Sep 17 00:00:00 2001 From: Julien Richard-Foy Date: Tue, 6 Jul 2021 16:29:35 +0200 Subject: [PATCH 1550/3075] Copy https://dotty.epfl.ch/docs/reference into https://docs.scala-lang.org/scala3/reference Content was taken from commit 270bd8b0f5af338be73790082d774516a83a73b5 --- _config.yml | 9 +- _data/scala3-doc-nav-header.yml | 2 +- _includes/sidebar-toc-multipage-overview.html | 2 +- _ja/index.md | 2 +- _ja/scala3/contribute-to-docs.md | 2 +- _ja/scala3/index.md | 2 +- _ja/scala3/new-in-scala3.md | 2 +- _overviews/FAQ/index.md | 4 +- _overviews/scala3-book/ca-summary.md | 2 +- _overviews/scala3-book/scala-features.md | 4 +- _overviews/scala3-macros/other-resources.md | 2 +- _overviews/scala3-macros/tutorial/inline.md | 2 +- .../compatibility-classpath.md | 36 +- .../compatibility-metaprogramming.md | 2 +- .../incompat-contextual-abstractions.md | 2 +- .../incompat-dropped-features.md | 10 +- .../incompat-other-changes.md | 2 +- .../incompat-type-inference.md | 2 +- .../scala3-migration/incompatibility-table.md | 4 +- _overviews/scala3-reference/overview.md | 7 - _scala3-reference/changed-features.md | 9 + .../changed-features/compiler-plugins.md | 130 +++ .../changed-features/eta-expansion-spec.md | 77 ++ .../changed-features/eta-expansion.md | 44 + .../implicit-conversions-spec.md | 117 +++ .../changed-features/implicit-conversions.md | 66 ++ .../changed-features/implicit-resolution.md | 170 ++++ _scala3-reference/changed-features/imports.md | 61 ++ .../changed-features/interpolation-escapes.md | 14 + .../changed-features/lazy-vals-init.md | 82 ++ .../changed-features/main-functions.md | 91 ++ .../changed-features/match-syntax.md | 58 ++ .../changed-features/numeric-literals.md | 264 ++++++ .../changed-features/operators.md | 167 ++++ .../changed-features/overload-resolution.md | 94 ++ .../changed-features/pattern-bindings.md | 62 ++ .../changed-features/pattern-matching.md | 246 ++++++ .../changed-features/structural-types-spec.md | 153 ++++ .../changed-features/structural-types.md | 194 ++++ .../changed-features/type-checking.md | 9 + .../changed-features/type-inference.md | 12 + .../changed-features/vararg-splices.md | 42 + .../changed-features/wildcards.md | 52 ++ _scala3-reference/contextual.md | 85 ++ .../contextual/by-name-context-parameters.md | 67 ++ .../contextual/context-bounds.md | 48 + .../contextual/context-functions-spec.md | 79 ++ .../contextual/context-functions.md | 156 ++++ _scala3-reference/contextual/conversions.md | 78 ++ .../contextual/derivation-macro.md | 204 +++++ _scala3-reference/contextual/derivation.md | 405 +++++++++ .../contextual/extension-methods.md | 308 +++++++ _scala3-reference/contextual/given-imports.md | 119 +++ _scala3-reference/contextual/givens.md | 173 ++++ .../contextual/multiversal-equality.md | 229 +++++ .../contextual/relationship-implicits.md | 208 +++++ .../right-associative-extension-methods.md | 52 ++ _scala3-reference/contextual/type-classes.md | 284 ++++++ _scala3-reference/contextual/using-clauses.md | 155 ++++ _scala3-reference/dropped-features.md | 9 + .../dropped-features/auto-apply.md | 98 +++ .../dropped-features/class-shadowing-spec.md | 26 + .../dropped-features/class-shadowing.md | 35 + .../dropped-features/delayed-init.md | 32 + .../dropped-features/do-while.md | 43 + .../dropped-features/early-initializers.md | 18 + .../dropped-features/existential-types.md | 37 + _scala3-reference/dropped-features/limit22.md | 19 + _scala3-reference/dropped-features/macros.md | 18 + .../dropped-features/nonlocal-returns.md | 26 + .../dropped-features/package-objects.md | 49 ++ .../dropped-features/procedure-syntax.md | 21 + _scala3-reference/dropped-features/symlits.md | 12 + .../dropped-features/this-qualifier.md | 17 + .../dropped-features/type-projection.md | 20 + .../dropped-features/weak-conformance-spec.md | 54 ++ .../dropped-features/weak-conformance.md | 49 ++ .../dropped-features/wildcard-init.md | 25 + _scala3-reference/dropped-features/xml.md | 41 + _scala3-reference/enums.md | 9 + _scala3-reference/enums/adts.md | 175 ++++ _scala3-reference/enums/desugarEnums.md | 217 +++++ _scala3-reference/enums/enums.md | 196 +++++ _scala3-reference/experimental/canthrow.md | 242 +++++ .../experimental/erased-defs-spec.md | 65 ++ _scala3-reference/experimental/erased-defs.md | 229 +++++ _scala3-reference/features-classification.md | 201 +++++ .../language-versions.md | 2 +- _scala3-reference/metaprogramming.md | 49 ++ .../metaprogramming/compiletime-ops.md | 296 +++++++ _scala3-reference/metaprogramming/inline.md | 380 ++++++++ .../metaprogramming/macros-spec.md | 254 ++++++ _scala3-reference/metaprogramming/macros.md | 825 ++++++++++++++++++ .../metaprogramming/reflection.md | 133 +++ .../metaprogramming/simple-smp.md | 232 +++++ _scala3-reference/metaprogramming/staging.md | 123 +++ .../metaprogramming/tasty-inspect.md | 59 ++ _scala3-reference/new-types.md | 9 + .../dependent-function-types-spec.md | 125 +++ .../new-types/dependent-function-types.md | 51 ++ .../new-types/intersection-types-spec.md | 108 +++ .../new-types/intersection-types.md | 70 ++ _scala3-reference/new-types/match-types.md | 247 ++++++ .../new-types/polymorphic-function-types.md | 96 ++ .../new-types/type-lambdas-spec.md | 119 +++ _scala3-reference/new-types/type-lambdas.md | 19 + .../new-types/union-types-spec.md | 172 ++++ _scala3-reference/new-types/union-types.md | 48 + _scala3-reference/other-new-features.md | 9 + .../other-new-features/control-syntax.md | 49 ++ .../creator-applications.md | 59 ++ .../other-new-features/explicit-nulls.md | 540 ++++++++++++ .../other-new-features/export.md | 179 ++++ .../indentation-experimental.md | 83 ++ .../other-new-features/indentation.md | 455 ++++++++++ .../other-new-features/kind-polymorphism.md | 49 ++ .../other-new-features/matchable.md | 143 +++ .../other-new-features/named-typeargs-spec.md | 39 + .../other-new-features/named-typeargs.md | 33 + .../other-new-features/opaques-details.md | 123 +++ .../other-new-features/opaques.md | 169 ++++ .../other-new-features/open-classes.md | 82 ++ .../parameter-untupling-spec.md | 88 ++ .../other-new-features/parameter-untupling.md | 48 + .../other-new-features/safe-initialization.md | 246 ++++++ .../other-new-features/targetName.md | 122 +++ .../threadUnsafe-annotation.md | 20 + .../other-new-features/trait-parameters.md | 90 ++ .../other-new-features/transparent-traits.md | 72 ++ .../other-new-features/type-test.md | 183 ++++ _scala3-reference/overview.md | 155 ++++ _scala3-reference/soft-modifier.md | 27 + _scala3-reference/syntax.md | 445 ++++++++++ _zh-cn/index.md | 2 +- index.md | 2 +- .../explicit-nulls-type-hierarchy.png | Bin 0 -> 57752 bytes scala3/contribute-to-docs.md | 6 +- scala3/guides.md | 4 - scala3/index.md | 2 +- scala3/new-in-scala3.md | 2 +- 140 files changed, 13826 insertions(+), 64 deletions(-) delete mode 100644 _overviews/scala3-reference/overview.md create mode 100644 _scala3-reference/changed-features.md create mode 100644 _scala3-reference/changed-features/compiler-plugins.md create mode 100644 _scala3-reference/changed-features/eta-expansion-spec.md create mode 100644 _scala3-reference/changed-features/eta-expansion.md create mode 100644 _scala3-reference/changed-features/implicit-conversions-spec.md create mode 100644 _scala3-reference/changed-features/implicit-conversions.md create mode 100644 _scala3-reference/changed-features/implicit-resolution.md create mode 100644 _scala3-reference/changed-features/imports.md create mode 100644 _scala3-reference/changed-features/interpolation-escapes.md create mode 100644 _scala3-reference/changed-features/lazy-vals-init.md create mode 100644 _scala3-reference/changed-features/main-functions.md create mode 100644 _scala3-reference/changed-features/match-syntax.md create mode 100644 _scala3-reference/changed-features/numeric-literals.md create mode 100644 _scala3-reference/changed-features/operators.md create mode 100644 _scala3-reference/changed-features/overload-resolution.md create mode 100644 _scala3-reference/changed-features/pattern-bindings.md create mode 100644 _scala3-reference/changed-features/pattern-matching.md create mode 100644 _scala3-reference/changed-features/structural-types-spec.md create mode 100644 _scala3-reference/changed-features/structural-types.md create mode 100644 _scala3-reference/changed-features/type-checking.md create mode 100644 _scala3-reference/changed-features/type-inference.md create mode 100644 _scala3-reference/changed-features/vararg-splices.md create mode 100644 _scala3-reference/changed-features/wildcards.md create mode 100644 _scala3-reference/contextual.md create mode 100644 _scala3-reference/contextual/by-name-context-parameters.md create mode 100644 _scala3-reference/contextual/context-bounds.md create mode 100644 _scala3-reference/contextual/context-functions-spec.md create mode 100644 _scala3-reference/contextual/context-functions.md create mode 100644 _scala3-reference/contextual/conversions.md create mode 100644 _scala3-reference/contextual/derivation-macro.md create mode 100644 _scala3-reference/contextual/derivation.md create mode 100644 _scala3-reference/contextual/extension-methods.md create mode 100644 _scala3-reference/contextual/given-imports.md create mode 100644 _scala3-reference/contextual/givens.md create mode 100644 _scala3-reference/contextual/multiversal-equality.md create mode 100644 _scala3-reference/contextual/relationship-implicits.md create mode 100644 _scala3-reference/contextual/right-associative-extension-methods.md create mode 100644 _scala3-reference/contextual/type-classes.md create mode 100644 _scala3-reference/contextual/using-clauses.md create mode 100644 _scala3-reference/dropped-features.md create mode 100644 _scala3-reference/dropped-features/auto-apply.md create mode 100644 _scala3-reference/dropped-features/class-shadowing-spec.md create mode 100644 _scala3-reference/dropped-features/class-shadowing.md create mode 100644 _scala3-reference/dropped-features/delayed-init.md create mode 100644 _scala3-reference/dropped-features/do-while.md create mode 100644 _scala3-reference/dropped-features/early-initializers.md create mode 100644 _scala3-reference/dropped-features/existential-types.md create mode 100644 _scala3-reference/dropped-features/limit22.md create mode 100644 _scala3-reference/dropped-features/macros.md create mode 100644 _scala3-reference/dropped-features/nonlocal-returns.md create mode 100644 _scala3-reference/dropped-features/package-objects.md create mode 100644 _scala3-reference/dropped-features/procedure-syntax.md create mode 100644 _scala3-reference/dropped-features/symlits.md create mode 100644 _scala3-reference/dropped-features/this-qualifier.md create mode 100644 _scala3-reference/dropped-features/type-projection.md create mode 100644 _scala3-reference/dropped-features/weak-conformance-spec.md create mode 100644 _scala3-reference/dropped-features/weak-conformance.md create mode 100644 _scala3-reference/dropped-features/wildcard-init.md create mode 100644 _scala3-reference/dropped-features/xml.md create mode 100644 _scala3-reference/enums.md create mode 100644 _scala3-reference/enums/adts.md create mode 100644 _scala3-reference/enums/desugarEnums.md create mode 100644 _scala3-reference/enums/enums.md create mode 100644 _scala3-reference/experimental/canthrow.md create mode 100644 _scala3-reference/experimental/erased-defs-spec.md create mode 100644 _scala3-reference/experimental/erased-defs.md create mode 100644 _scala3-reference/features-classification.md rename {_overviews/scala3-reference => _scala3-reference}/language-versions.md (99%) create mode 100644 _scala3-reference/metaprogramming.md create mode 100644 _scala3-reference/metaprogramming/compiletime-ops.md create mode 100644 _scala3-reference/metaprogramming/inline.md create mode 100644 _scala3-reference/metaprogramming/macros-spec.md create mode 100644 _scala3-reference/metaprogramming/macros.md create mode 100644 _scala3-reference/metaprogramming/reflection.md create mode 100644 _scala3-reference/metaprogramming/simple-smp.md create mode 100644 _scala3-reference/metaprogramming/staging.md create mode 100644 _scala3-reference/metaprogramming/tasty-inspect.md create mode 100644 _scala3-reference/new-types.md create mode 100644 _scala3-reference/new-types/dependent-function-types-spec.md create mode 100644 _scala3-reference/new-types/dependent-function-types.md create mode 100644 _scala3-reference/new-types/intersection-types-spec.md create mode 100644 _scala3-reference/new-types/intersection-types.md create mode 100644 _scala3-reference/new-types/match-types.md create mode 100644 _scala3-reference/new-types/polymorphic-function-types.md create mode 100644 _scala3-reference/new-types/type-lambdas-spec.md create mode 100644 _scala3-reference/new-types/type-lambdas.md create mode 100644 _scala3-reference/new-types/union-types-spec.md create mode 100644 _scala3-reference/new-types/union-types.md create mode 100644 _scala3-reference/other-new-features.md create mode 100644 _scala3-reference/other-new-features/control-syntax.md create mode 100644 _scala3-reference/other-new-features/creator-applications.md create mode 100644 _scala3-reference/other-new-features/explicit-nulls.md create mode 100644 _scala3-reference/other-new-features/export.md create mode 100644 _scala3-reference/other-new-features/indentation-experimental.md create mode 100644 _scala3-reference/other-new-features/indentation.md create mode 100644 _scala3-reference/other-new-features/kind-polymorphism.md create mode 100644 _scala3-reference/other-new-features/matchable.md create mode 100644 _scala3-reference/other-new-features/named-typeargs-spec.md create mode 100644 _scala3-reference/other-new-features/named-typeargs.md create mode 100644 _scala3-reference/other-new-features/opaques-details.md create mode 100644 _scala3-reference/other-new-features/opaques.md create mode 100644 _scala3-reference/other-new-features/open-classes.md create mode 100644 _scala3-reference/other-new-features/parameter-untupling-spec.md create mode 100644 _scala3-reference/other-new-features/parameter-untupling.md create mode 100644 _scala3-reference/other-new-features/safe-initialization.md create mode 100644 _scala3-reference/other-new-features/targetName.md create mode 100644 _scala3-reference/other-new-features/threadUnsafe-annotation.md create mode 100644 _scala3-reference/other-new-features/trait-parameters.md create mode 100644 _scala3-reference/other-new-features/transparent-traits.md create mode 100644 _scala3-reference/other-new-features/type-test.md create mode 100644 _scala3-reference/overview.md create mode 100644 _scala3-reference/soft-modifier.md create mode 100644 _scala3-reference/syntax.md create mode 100644 resources/images/scala3/explicit-nulls/explicit-nulls-type-hierarchy.png diff --git a/_config.yml b/_config.yml index 395bed4a34..64f78bc718 100644 --- a/_config.yml +++ b/_config.yml @@ -45,6 +45,8 @@ collections: getting-started: output: true permalink: /:collection/:path.html + scala3-reference: # not really a collection, but this is the only way I found to be able to generate the navigation bar on the right + output: true ja: # Japanese translations output: true permalink: /:collection/:path.html @@ -125,13 +127,14 @@ defaults: permalink: "/scala3/guides/macros/:title.html" - scope: - path: "_overviews/scala3-reference" + path: "_scala3-reference" values: scala3: true partof: scala3-reference + type: section overview-name: "Scala 3 Language Reference" layout: multipage-overview - permalink: "/scala3/guides/reference/:title.html" + permalink: "/scala3/reference/:path.html" - scope: path: "scala3" @@ -142,7 +145,7 @@ defaults: highlighter: rouge permalink: /:categories/:title.html:output_ext baseurl: -scala3ref: "/scala3/guides/reference" +scala3ref: "/scala3/reference" exclude: ["vendor"] plugins: - jekyll-redirect-from diff --git a/_data/scala3-doc-nav-header.yml b/_data/scala3-doc-nav-header.yml index c390278c6d..94e3bfa5c5 100644 --- a/_data/scala3-doc-nav-header.yml +++ b/_data/scala3-doc-nav-header.yml @@ -12,6 +12,6 @@ - title: Migrate url: "/scala3/guides/migration/compatibility-intro.html" - title: Reference - url: "https://dotty.epfl.ch/docs/reference/overview.html" + url: "/scala3/reference/overview.html" - title: API url: "https://dotty.epfl.ch/api/index.html" diff --git a/_includes/sidebar-toc-multipage-overview.html b/_includes/sidebar-toc-multipage-overview.html index ceab98320f..168f4b5950 100644 --- a/_includes/sidebar-toc-multipage-overview.html +++ b/_includes/sidebar-toc-multipage-overview.html @@ -9,7 +9,7 @@
    Contents
    {% endif %}     -
    -

    Gitter

    - Real-time (topic-specialized) chat +
    +

    Chat

    + Real-time chat on Discord
    -
    ! Jekyll/Marulu limitation {% endcomment %} +

    From f317bfc00ca5272eeaa6556cb395e3dae8e0f9cc Mon Sep 17 00:00:00 2001 From: Vojin Jovanovic Date: Fri, 19 Apr 2013 18:07:58 +0200 Subject: [PATCH 0018/3075] Bug reporting guide. --- contribute/bug-reporting-guide.md | 120 +++++++++++++++++------------- 1 file changed, 70 insertions(+), 50 deletions(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 345dc03034..9b89f60ef4 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -3,53 +3,73 @@ layout: page title: Bug Reporting --- -# Reporting bugs to the Scala project - -The Scala project tracker is located at: - -> [http://issues.scala-lang.org](http://issues.scala-lang.org) - - -{% comment %} -WHAT THIS PAGE SHOULD TALK ABOUT: - - tracker - - what's a bug and what's not a bug? - - is it in the scala area? - - library - - compiler - - reflection - - scaladoc - - external libraries have their own trackers: - - akka - - play - - lift - - slick - - if it's a compiler crasher, it's a bug - - if the code generated throws a VerifyError, it's a bug - - if it's a regression, i.e. it worked in the previous version, it's a bug - - if the code generated is not doing what you expected, then it may or may not be a bug - - minimize the problem - - decouple from libraries - - decouple from complex build systems - - it could be a separate compilation issue - does it happen if you clean everything before? - - create small and self-contained files that, when compiled, will exhibit the behavior - - even if the behavior is not what you hoped for, it might still be correct - - if possible, look at the Scala Reference Specification and SIP documents - - or ask on the scala-internals mailing list - - okay, I'm sure it's a bug, now what? - - search for similar bugs - - the exception name and phase should be the best keywords to search for - - if the bug is there, add your test case as a comment. When someone picks up the bug, they will have to add your test case as a confirmation test - - if there's no similar bug - - try to fill in as many fields as possible: - - scala version - - component (if you know) - - labels - - assigneee may be left empty, as all new bugs are triaged - - environment - Machine architecture, Operating system, Java virtual machine version, any other environment necessary - - description - - - the test case - - the commands to trigger the bug - - the expected output - - the actual output -{% endcomment %} +# Reporting Bugs to the Scala Project + +The Scala project tracker is located at [http://issues.scala-lang.org](http://issues.scala-lang.org). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. + +## Is it a Bug? + +The first step in identifying a bug is to identify which component of the Scala distribution is affected. First, ensure that your issue falls within any of the following categories: + + - **Library** bugs typically manifest themselves as run-time exceptions, or as *unexpected*/*unintuitive* behavior of Scala Standard Library methods. + - **Compiler** errors are manifested as compile time exceptions, unexpected behavior of your code at run time, or invalid behavior of the type system. + - **Reflection** are bugs that appear in the ‘scala.reflect’ package. For the *reflection* bugs , the same rules apply as for the *library* bugs. + - **Scaladoc** bugs are manifested as a logical problems in the information it presents (that is, the displayed information is incorrect, such as an incorrect subclassing relationship), or incorrect behavior of the user interface. If you'd like to suggest a change in the content of the documentation, please submit a pull request (possible to do in the browser using GitHub, which is easier and faster than filing a bug). Please file a bug about the content of documentation only if you cannot provide a suggestion for its fix. + +If your issue is related to any of the following external libraries, make sure to use the relevant project's issue tracker: + + - [Akka](http://doc.akka.io/docs/akka/current/project/issue-tracking.html) + - [Play!](http://github.com/playframework/Play20/issues) + - [Slick](http://github.com/slick/slick/issues) + - [Actors Migration Kit](http://github.com/scala/actors-migration/issues?state=open) + +The following are generally considered to be bugs: + +- **Scala Compiler Crash** If the Scala compiler is crashing with an internal error (compile time exception) you have certainly found a bug, and can move on to the next section of this document on reporting confirmed bugs. +- **Regressions** If some code snippet worked in a previous Scala release, but now no longer compiles or results in an exception, it is probably a regression. +- **Verify Errors** happen when the compiled Scala program is loaded to the Java Virtual Machine. If you're getting a *Verify Error*, you've usually found a bug. Make sure first that your project is not using stale `.class` files before reporting a new issue. + +If you have a code snippet that is resulting in bytecode which you believe is behaving incorrectly, you may or may not have found a bug. Before reporting your issue, please attempt the following: + +* Make sure you minimize your problem. To correctly minimize the problem follow the following instructions: + + 1. Gradually take apart the offensive code snippet until you believe you have the simplest representation of your problem. + + 2. Ensure that you have decoupled your code snippet from any library that could be introducing the offensive behavior. One way to achieve this is to try to recompile the offensive code snippet in isolation, outside of the context of any complex build environment. + + 3. Make sure you are compiling your project from a clean slate. Your problem could be related to separate compilation, which is difficult to detect without a clean build with new `.class` files. + +* Keep in mind that the behavior you are witnessing could be intended. Good resources for verifying whether or not behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/docu/files/ScalaReference.pdf). If in doubt, you may always ask on the [scala-internals mailing list](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) + +In general, if you find yourself stuck on any of these steps, asking on one of following Scala mailing lists can be helpful: + + - For compiler bugs use the [scala-internals](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) mailing list. + - For unexpected behavior use [scala-language](https://groups.google.com/forum/?fromgroups#!forum/scala-language), or [scala-user](https://groups.google.com/forum/?fromgroups#!forum/scala-user) mailing lists. + +## Reporting Confirmed Bugs is a Sin + +Before reporting your bug, make sure to check the issue tracker for other similar bugs. The exception name or a compiler phase are the best keywords to search for. If you are experiencing unexpected behavior search for method/class names where it happens. Your issue might already be reported, and a workaround might already be available for you take advantage of. If your issue *is* reported, be sure to add your test case as a comment. + +**Note:** reporting a bug that already exists creates an additional overhead for you, the Scala Team, and all people that search the issue database. To avoid this inconvenience make sure that you thoroughly search for an existing issue. + +If you cannot find your issue in the issue tracker, create a new bug. The details about creating a bug report are in the following section. + +## Creating a Bug Report + +Please make sure to fill in as many fields as possible. Make sure you've indicated the following: + + 1. **Exact Scala version** that you are using. For example, `2.10.1` or `0.11.0-RC`. If the bug happens in mulitple versions indicate all of them. + 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. + 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized" + 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? + +In order for us to quickly triage the bug that you've found, it's important that the code snippet which produces the observed issue is as minimized as possible. For advice on minimizing your code snippet, please see the appropriate subsection of the above (Is it a Bug?). + +### Description + +In the description of your issue, be as detailed as you can. Bug reports which have the following information included are typically understood, triaged, and fixed very quickly: + + 1. Include a test case (minimized if possible) enabling us to reproduce the problematic behavior. + 2. The expected output. + 3. The actual output. + 4. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. \ No newline at end of file From fe39e1214a9b70ac76f223bde9670f66187b5810 Mon Sep 17 00:00:00 2001 From: Manojo Date: Tue, 23 Apr 2013 11:40:46 +0200 Subject: [PATCH 0019/3075] contribute -> get-involved --- contribute/bug-reporting-guide.md | 75 ------- contribute/documentation.md | 29 --- contribute/hacker-guide.md | 337 ------------------------------ contribute/index.md | 172 --------------- contribute/partest-guide.md | 66 ------ contribute/scala-fame.md | 9 - 6 files changed, 688 deletions(-) delete mode 100644 contribute/bug-reporting-guide.md delete mode 100644 contribute/documentation.md delete mode 100644 contribute/hacker-guide.md delete mode 100644 contribute/index.md delete mode 100644 contribute/partest-guide.md delete mode 100644 contribute/scala-fame.md diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md deleted file mode 100644 index 9b89f60ef4..0000000000 --- a/contribute/bug-reporting-guide.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -layout: page -title: Bug Reporting ---- - -# Reporting Bugs to the Scala Project - -The Scala project tracker is located at [http://issues.scala-lang.org](http://issues.scala-lang.org). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. - -## Is it a Bug? - -The first step in identifying a bug is to identify which component of the Scala distribution is affected. First, ensure that your issue falls within any of the following categories: - - - **Library** bugs typically manifest themselves as run-time exceptions, or as *unexpected*/*unintuitive* behavior of Scala Standard Library methods. - - **Compiler** errors are manifested as compile time exceptions, unexpected behavior of your code at run time, or invalid behavior of the type system. - - **Reflection** are bugs that appear in the ‘scala.reflect’ package. For the *reflection* bugs , the same rules apply as for the *library* bugs. - - **Scaladoc** bugs are manifested as a logical problems in the information it presents (that is, the displayed information is incorrect, such as an incorrect subclassing relationship), or incorrect behavior of the user interface. If you'd like to suggest a change in the content of the documentation, please submit a pull request (possible to do in the browser using GitHub, which is easier and faster than filing a bug). Please file a bug about the content of documentation only if you cannot provide a suggestion for its fix. - -If your issue is related to any of the following external libraries, make sure to use the relevant project's issue tracker: - - - [Akka](http://doc.akka.io/docs/akka/current/project/issue-tracking.html) - - [Play!](http://github.com/playframework/Play20/issues) - - [Slick](http://github.com/slick/slick/issues) - - [Actors Migration Kit](http://github.com/scala/actors-migration/issues?state=open) - -The following are generally considered to be bugs: - -- **Scala Compiler Crash** If the Scala compiler is crashing with an internal error (compile time exception) you have certainly found a bug, and can move on to the next section of this document on reporting confirmed bugs. -- **Regressions** If some code snippet worked in a previous Scala release, but now no longer compiles or results in an exception, it is probably a regression. -- **Verify Errors** happen when the compiled Scala program is loaded to the Java Virtual Machine. If you're getting a *Verify Error*, you've usually found a bug. Make sure first that your project is not using stale `.class` files before reporting a new issue. - -If you have a code snippet that is resulting in bytecode which you believe is behaving incorrectly, you may or may not have found a bug. Before reporting your issue, please attempt the following: - -* Make sure you minimize your problem. To correctly minimize the problem follow the following instructions: - - 1. Gradually take apart the offensive code snippet until you believe you have the simplest representation of your problem. - - 2. Ensure that you have decoupled your code snippet from any library that could be introducing the offensive behavior. One way to achieve this is to try to recompile the offensive code snippet in isolation, outside of the context of any complex build environment. - - 3. Make sure you are compiling your project from a clean slate. Your problem could be related to separate compilation, which is difficult to detect without a clean build with new `.class` files. - -* Keep in mind that the behavior you are witnessing could be intended. Good resources for verifying whether or not behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/docu/files/ScalaReference.pdf). If in doubt, you may always ask on the [scala-internals mailing list](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) - -In general, if you find yourself stuck on any of these steps, asking on one of following Scala mailing lists can be helpful: - - - For compiler bugs use the [scala-internals](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) mailing list. - - For unexpected behavior use [scala-language](https://groups.google.com/forum/?fromgroups#!forum/scala-language), or [scala-user](https://groups.google.com/forum/?fromgroups#!forum/scala-user) mailing lists. - -## Reporting Confirmed Bugs is a Sin - -Before reporting your bug, make sure to check the issue tracker for other similar bugs. The exception name or a compiler phase are the best keywords to search for. If you are experiencing unexpected behavior search for method/class names where it happens. Your issue might already be reported, and a workaround might already be available for you take advantage of. If your issue *is* reported, be sure to add your test case as a comment. - -**Note:** reporting a bug that already exists creates an additional overhead for you, the Scala Team, and all people that search the issue database. To avoid this inconvenience make sure that you thoroughly search for an existing issue. - -If you cannot find your issue in the issue tracker, create a new bug. The details about creating a bug report are in the following section. - -## Creating a Bug Report - -Please make sure to fill in as many fields as possible. Make sure you've indicated the following: - - 1. **Exact Scala version** that you are using. For example, `2.10.1` or `0.11.0-RC`. If the bug happens in mulitple versions indicate all of them. - 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. - 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized" - 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? - -In order for us to quickly triage the bug that you've found, it's important that the code snippet which produces the observed issue is as minimized as possible. For advice on minimizing your code snippet, please see the appropriate subsection of the above (Is it a Bug?). - -### Description - -In the description of your issue, be as detailed as you can. Bug reports which have the following information included are typically understood, triaged, and fixed very quickly: - - 1. Include a test case (minimized if possible) enabling us to reproduce the problematic behavior. - 2. The expected output. - 3. The actual output. - 4. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. \ No newline at end of file diff --git a/contribute/documentation.md b/contribute/documentation.md deleted file mode 100644 index 05b2455a5f..0000000000 --- a/contribute/documentation.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -layout: page -title: Documentation Contributions ---- -# Contributing documentation to the Scala project - -TODO - - diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md deleted file mode 100644 index bd7ac60e71..0000000000 --- a/contribute/hacker-guide.md +++ /dev/null @@ -1,337 +0,0 @@ ---- -layout: page -title: Scala hacker guide ---- - -**Eugene Burmako** - -This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea. - -This guide covers the entire process, from the conception of your idea or bugfix to the point where it is merged into Scala. Throughout, we will use a running example of an idea or bugfix one might wish to contribute. - -## The Running Example - -Let's say that you particularly enjoy the new string interpolation language feature introduced in Scala 2.10.0, and you use it quite heavily. - -Though, there's an annoying issue -which you occasionally stumble upon: the formatting string interpolator `f` [does not support](https://issues.scala-lang.org/browse/SI-6725) -new line tokens `%n`. - -One approach would be to go the mailing list, request that the bug be fixed, and then to wait indefinitely for the fix arrive. Another approach would be to instead patch Scala oneself, and to submit the fix to the Scala repository in hopes that it might make it into a subsequent release. - -**_Of note_**: There are several types of releases/builds. Nightly builds are produced every night at a fixed time. Minor releases happen once every few months. Major releases typically happen once per year. - -## 1. Connect - -Sometimes it's appealing to hack alone and not to have to interact with others out of fear, or out of comfort. However, in the context a big project such as Scala, -this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide -unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. - -Typically bug fixes new features start out as an idea or an experiment posted on one of our mailing lists [our mailing lists]({{ site.baseurl }}/community/index.html#mailing_lists) to find out how people feel -about things you want to implement. People proficient is certain areas of Scala usually monitor mailing lists, so you'll often get some help -by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. - -This is the list of language features/libraries along with their maintainers's full names and github usernames: - -{% include maintainers.html %} - -Since Martin is the person who submitted the string interpolation Scala Improvement Proposal and implemented this language feature for Scala 2.10.0, he might be interested in learning of new bugfixes to that feature. - -As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the scala-internals mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, -in this example, we post to the [the scala-user mailing list](http://groups.google.com/group/scala-user)about our issue. - -
    Posting to scala-user
    -
    -
    Response from Martin
    - -Now that we have the approval of the feature's author, we can get to work! - -## 2. Set up - -Hacking Scala begins with creating a branch for your work item. To develop Scala we use [Git](http://git-scm.com/) -and [GitHub](http://github.com/). This section of the guide provides a short walkthrough, but if you are new to Git, -it probably makes sense to familiarize yourself with Git first. We recommend the [Git Pro](http://git-scm.com/book/en/) -online book. - -### Fork - -Log into [GitHub](http://github.com/), go to [https://github.com/scala/scala](https://github.com/scala/scala) and click the `Fork` -button in the top right corner of the page. This will create your own copy of our repository that will serve as a scratchpad for your work. - -If you're new to Git, don't be afraid of messing up-- there is no way you can corrupt our repository. - -
    Fork scala/scala
    - -### Clone - -If everything went okay, you will be redirected to your own fork at `https://github.com/username/scala`, where `username` -is your github user name. You might find it helpful to read [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/), -which covers some of the things that will follow below. Then, _clone_ your repository (_i.e._ pull a copy from github to your local machine) by running the following on the command line: - - 16:35 ~/Projects$ git clone https://github.com/xeno-by/scala - Cloning into 'scala'... - remote: Counting objects: 258564, done. - remote: Compressing objects: 100% (58239/58239), done. - remote: Total 258564 (delta 182155), reused 254094 (delta 178356) - Receiving objects: 100% (258564/258564), 46.91 MiB | 700 KiB/s, done. - Resolving deltas: 100% (182155/182155), done. - -This will create a local directory called `scala`, which contains a clone of your own copy of our repository. The changes that you make -in this directory can be propagated back to your copy hosted on github and, ultimately, pushed into Scala when your patch is ready. - -### Branch - -Before you start making changes, always create your own branch. Never work on the `master` branch. Think of a name that describes -the changes you plan on making. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: -bug fixes and new features. - -* For bug fixes, use `issue/NNNN` for bug NNNN from the [Scala issue tracker](https://issues.scala-lang.org/). -* For new feature use `topic/XXX` for feature XXX. Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaladoc-diagrams` instead of just `topic/diagrams` would be a good branch name. - -Since in our example, we're going to fix an existing bug [SI-6725](https://issues.scala-lang.org/browse/SI-6725), we'll create a branch named `ticket/6725`. - - 16:39 ~/Projects/scala (master)$ git checkout -b ticket/6725 - Switched to a new branch 'ticket/6725' - -If you are new to Git and branching, read the [Branching Chapter](http://git-scm.com/book/en/Git-Branching) in the Git Pro book. - -### Build - -The next step after cloning your fork is setting up your machine to build Scala. The definitive guide on building Scala is located at -[https://github.com/scala/scala/blob/master/README.rst](https://github.com/scala/scala/blob/master/README.rst), but here's the summary: - -* It is recommended to use Java `1.6` (not `1.7` or `1.8`, because they might cause occasional glitches). -* The build tool is `ant`. -* The build runs the `pull-binary-libs.sh` script to download bootstrap libs. This requires `bash` and `curl`. -* The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. -* Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. - -Building Scala is as easy as running `ant` in the root of your cloned repository. Be prepared to wait for a while-- a full "clean" build -takes 8+ minutes depending on your machine (and up to 30 minutes on older machines with less memory). Incremental builds are usually within 30-120 seconds range (again, your mileage might vary -with your hardware). - - 16:50 ~/Projects/scala (ticket/6725)$ ant - Buildfile: /Users/xeno_by/Projects/scala/build.xml - - strap.clean: - - pack.clean: - - init.jars.check: - - init.jars: - [echo] Updating bootstrap libs. (To do this by hand, run ./pull-binary-libs.sh) - [exec] Resolving [943cd5c8802b2a3a64a010efb86ec19bac142e40/lib/ant/ant-contrib.jar] - - ... - - pack.bin: - [mkdir] Created dir: /Users/xeno_by/Projects/scala/build/pack/bin - - pack.done: - - build: - - BUILD SUCCESSFUL - Total time: 9 minutes 41 seconds - -### IDE - -There's no single editor of choice for working with Scala sources, as there are trade-offs associated with each available tool. - -Both Eclipse and IntelliJ IDEA have Scala plugins, which are known to work with our codebase. Here are -[instructions for Eclipse](https://github.com/scala/scala/blob/master/src/eclipse/README.md) and -[instructions for Intellij](https://github.com/scala/scala/blob/master/src/intellij/README). Both of those Scala plugins provide -navigation, refactoring and error reporting functionality as well as integrated debugging. - -There also exist lighter-weight editors such as Emacs, Sublime or jEdit which provide unparalleled are faster and much less memory/compute-intensive to run, while -lacking semantic services and debugging. To address this shortcoming, they can integrate with ENSIME, -a helper program, which hosts a resident Scala compiler providing some of the features implemented in traditional IDEs. However despite -having significantly matured over the last year, support for our particular code base is still being improved, and is not as mature as for Eclipse and IntelliJ. - -Due to the immense variability in personal preference between IDE/editor experience, it's difficult to recommend a particular tool, and your choice should boil down to your personal preferences. - -## 3. Hack - -When hacking on your topic of choice, you'll be modifying Scala, compiling it and testing it on relevant input files. -Typically you would want to first make sure that your changes work on a small example and afterwards verify that nothing break -by running a comprehensive test suite. - -We'll start by creating a `sandbox` directory (this particular name doesn't bear any special meaning), which will hold a single test file and its compilation results. First, let's make sure that -[the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by putting together a simple test and compiling and running it with the Scala compiler that we built using `ant`. The Scala compiler that we just built is located in `build/pack/bin`. - - 17:25 ~/Projects/scala (ticket/6725)$ mkdir sandbox - 17:26 ~/Projects/scala (ticket/6725)$ cd sandbox - 17:26 ~/Projects/scala/sandbox (ticket/6725)$ edit Test.scala - 17:26 ~/Projects/scala/sandbox (ticket/6725)$ cat Test.scala - object Test extends App { - val a = 1 - val s = f"$a%s%n$a%s" - println(s) - } - 17:27 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scalac Test.scala - 17:28 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test - 1%n1 // %n should've been replaced by a newline here - -### Implement - -Now, implement your bugfix or new feature! - -Here are also some tips & tricks that have proven useful in Scala development: - -* If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, - try doing `ant clean build`. Due to the way how Scala compiles traits, if a trait changes, then it's sometimes not enough to recompile - just that trait, but it might also be necessary to recompile its users. The `ant` tool is not smart enough to do that, which might lead to - very strange errors. Full-rebuilds fix the problem. Fortunately that's rarely necessary, because full-rebuilds take a lot of time-- the same 8-30 minutes as mentioned above. -* Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, - some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts to launch Scala from `build/quick/classes`. -* Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how - things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious - to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. - -### Documentation - -There are several areas that one could contribute to-- there is the Scala library, the Scala compiler, and other tools such as Scaladoc. Each area has varying amounts of documentation. - -##### The Scala Library - -Contributing to the Scala standard library is about the same as working on one of your own libraries. Beyond the Scala collections hierarchy, there are no complex internals or architectures to have to worry about. Just make sure that you code in a "don't-repeat-yourself" (DRY) style, obeying the "boy scout principle" (i.e. make sure you've left something cleaner than you found it.) - -If documentation is necessary for some trait/class/object/method/etc in the Scala standard library, typically maintainers will include inline comments describing their design decisions or rationale for implementing things the way they have, if it is not straightforward. - -If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections](http://docs.scala-lang.org/overviews/core/architecture-of-scala-collections.html), as well as a larger more general [Scala collections Guide](http://docs.scala-lang.org/overviews/core/collections.html) covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide](http://docs.scala-lang.org/overviews/core/parallel-collections.html). (TODO double check these links!) - -##### The Scala Compiler - -Documentation about the internal workings of the Scala compiler is scarce, and most of the knowledge is passed around by email (scala-internals mailing list), ticket, or word of mouth. However the situation is steadily improving. Here are the resources that might help: - -* [Compiler internals videos by Martin Odersky](TODO) are quite dated, but still very useful. In this three-video - series Martin explains the general architecture of the compiler, and the basics of the front-end, which has recently become Scala reflection API. -* [Reflection documentation](http://docs.scala-lang.org/overviews/reflection/overview.html) describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that - are used to represent Scala programs and operations defined on then. Since much of the compiler has been factored out and made accessible via the Reflection API, all of the fundamentals needed for reflection are the same for the compiler. -* [Reflection and Compilers by Martin Odersky](http://channel9.msdn.com/Events/Lang-NEXT/Lang-NEXT-2012/Reflection-and-Compilers), a talk - at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the architecture of the reflection API. -* [Scala compiler corner](http://lampwww.epfl.ch/~magarcia/ScalaCompilerCornerReloaded/) contains extensive documentation about - most of the post-typer phases (i.e. the backend) in the Scala compiler. -* [scala-internals](http://groups.google.com/group/scala-internals), a mailing list which hosts discussions about the core - internal design and implementation of the Scala system. - -##### Other Projects - -Tools like Scaladoc also welcome contributions. Unfortunately these smaller projects have less developer documentation. In these cases, the best thing to do is to directly explore the code base (which often contains documentation as inline comments) or to write to the appropriate maintainers for pointers. - -### Interlude - -To fix [the bug we're interested in](https://issues.scala-lang.org/browse/SI-6725). Let's say we've tracked the `StringContext.f` interpolator -down to a macro implemented in `MacroImplementations.scala`, and there we notice that the interpolator only processes conversions, -but not tokens like `%n`. Looks like an easy fix. - - 18:44 ~/Projects/scala/sandbox (ticket/6725)$ git diff - diff --git a/src/compiler/scala/tools/reflect/MacroImplementations.scala b/src/compiler/scala/tools/ - index 002a3fce82..4e8f02084d 100644 - --- a/src/compiler/scala/tools/reflect/MacroImplementations.scala - +++ b/src/compiler/scala/tools/reflect/MacroImplementations.scala - @@ -117,7 +117,8 @@ abstract class MacroImplementations { - if (!strIsEmpty) { - val len = str.length - while (idx < len) { - - if (str(idx) == '%') { - + def notPercentN = str(idx) != '%' || (idx + 1 < len && str(idx + 1) != 'n') - + if (str(idx) == '%' && notPercentN) { - bldr append (str substring (start, idx)) append "%%" - start = idx + 1 - } - -After applying the fix and running `ant`, our simple test case in `sandbox/Test.scala` started working! - - 18:51 ~/Projects/scala/sandbox (ticket/6725)$ cd .. - 18:51 ~/Projects/scala (ticket/6725)$ ant - Buildfile: /Users/xeno_by/Projects/scala/build.xml - - ... - - quick.comp: - [scalacfork] Compiling 1 file to /Users/xeno_by/Projects/scala/build/quick/classes/compiler - [propertyfile] Updating property file: /Users/xeno_by/Projects/scala/build/quick/classes/compiler/compiler.properties - [stopwatch] [quick.comp.timer: 6.588 sec] - - ... - - BUILD SUCCESSFUL - Total time: 18 seconds - - 18:51 ~/Projects/scala (ticket/6725)$ cd sandbox - 18:51 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scalac Test.scala - 18:51 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test - 1 - 1 // no longer getting the %n here - it got transformed into a newline - -### Verify - -Now to make sure that my fix doesn't break anything I need to run the test suite using the `partest` tool we wrote to test Scala. -Read up [the partest guide](/contribute/partest-guide.html) to learn the details about partest, but in a nutshell you can either -run `ant test` to go through the entire test suite (30+ minutes) or use wildcards to limit the tests to something manageable: - - 18:52 ~/Projects/scala/sandbox (ticket/6725)$ cd ../test - 18:56 ~/Projects/scala/test (ticket/6725)$ partest files/run/*interpol* - Testing individual files - testing: [...]/files/run/interpolationArgs.scala [ OK ] - testing: [...]/files/run/interpolationMultiline1.scala [ OK ] - testing: [...]/files/run/interpolationMultiline2.scala [ OK ] - testing: [...]/files/run/sm-interpolator.scala [ OK ] - testing: [...]/files/run/interpolation.scala [ OK ] - testing: [...]/files/run/stringinterpolation_macro-run.scala [ OK ] - All of 6 tests were successful (elapsed time: 00:00:08) - -## 4. Publish - -After development is finished, it's time to publish the code and submit your patch for discussion and potential inclusion into Scala. -In a nutshell, this involves: - - 1. making sure that your code and commit messages are of high quality, - 2. clicking a few buttons in the Github interface, - 3. assigning one or more reviewers which will look through your pull request. - - Let's go into each of these points in more detail. - -### Commit - -The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. -There are two things you should know here: - - 1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) for more information about the desired style of your commits. - - 2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. - -Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on Github. - - 19:22 ~/Projects/scala/test (ticket/6725)$ git add ../src/compiler/scala/tools/reflect/MacroImplementations.scala - 19:22 ~/Projects/scala/test (ticket/6725)$ git commit - [ticket/6725 3c3098693b] SI-6725 `f` interpolator now supports %n tokens - 1 file changed, 2 insertions(+), 1 deletion(-) - 19:34 ~/Projects/scala/test (ticket/6725)$ git push origin ticket/6725 - Username for 'https://github.com': xeno-by - Password for 'https://xeno-by@github.com': - Counting objects: 15, done. - Delta compression using up to 8 threads. - Compressing objects: 100% (8/8), done. - Writing objects: 100% (8/8), 1.00 KiB, done. - Total 8 (delta 5), reused 0 (delta 0) - To https://github.com/xeno-by/scala - * [new branch] ticket/6725 -> ticket/6725 - -### Submit - -Now, we must simply submit our proposed patch. Navigate to your branch in Github (for me it was `https://github.com/xeno-by/scala/tree/ticket/6725`) -and click the pull request button to submit your patch as a pull request to Scala. If you've never submitted patches to Scala, you will -need to sign the contributor license agreement, which [can be done online](http://typesafe.com/contribute/cla/scala) within a few minutes. - -
    Submit a pull request
    - -### Discuss - -After the pull request has been submitted, you need to pick a reviewer (usually the person you've contacted in the beginning of your -workflow) and be ready to elaborate and adjust your patch if necessary. In this example, we picked Martin, because we had such a nice chat on the mailing list: - -
    SAssign the reviewer
    - diff --git a/contribute/index.md b/contribute/index.md deleted file mode 100644 index 05696f5165..0000000000 --- a/contribute/index.md +++ /dev/null @@ -1,172 +0,0 @@ ---- -layout: page -title: Contribute ---- -# Contributing to the Scala project - -The Scala programming langauge is an open source project with a very -diverse community, where people from all over the world contribute their work, -with everyone benefitting from friendly help and advice, and -kindly helping others in return. So why not join the Scala community and help -everyone make things better? - -The following are typical questions you might ask when first contributing to Scala. -If you have other questions not addressed here, feel free to ask on the [scala-internals mailing list](http://groups.google.com/group/scala-internals). - -
    - -### I found something that doesn't work as expected. How to file a bug report? - -[The reporting bugs page](bug-reporting-guide.html) describes the steps to take when you find something that doesn't work -as expected. Filing in a good bug report increases the chances the ticket is fixed quickly. - -
    - -### Why contribute a patch to Scala? - -Just to name a few common reasons: - - contributing a patch is the best way to make sure your desired changes will be available in the next Scala version - - Scala is written in Scala, so going through the source code and patching it will improve your Scala-fu - - last but not least, you will make it into the [Scala Contribuitor Hall of Fame](scala-fame.html). - -
    - -### I'd like to start hacking the Scala project, how to find something to work on? - -Depending on your skillset, you may want to contribute documentation and/or code. Documentation has always been very -appreciated work in the Scala community, as most code contributions tend to be quite scarce in explanations of how -things work and how everyone else is supposed to use them. To contribute documentation, have a look at the -[documentation page](documentation.html). - -The main Scala project consists of the standard Scala library, the Scala reflection and macros library, -the Scala compiler and the Scaladoc tool. This means there's plenty to choose from when deciding what to work on. -Typically the scaladoc tool provides a low entry point for new committers, so it is a good first step into contributing. - -On the Scala bug tracker you will find many bugs that are [marked as good starting points to contributing ("community" bugs)](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12111) or [that are not currently assigned](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12112) and that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. - -{% comment %} Keep the space in the
    ! Jekyll/Marulu limitation {% endcomment %} -
    - -
    - -### I have this idea that I'd like to add to Scala, how do I start? - -The first step to making a change is to discuss it with the community at large, to make sure everyone agrees on the idea -and on the implementation plan. Starting point ("community") bugs are usually uncontroversial, so you can jump right -ahead to hacking the scala source tree and filing a pull request. For larger changes it is best to announce the change -on the [scala-internals](http://groups.google.com/group/scala-internals) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list. - -Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against -the Scala project source tree. The [hacker guide](hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. - -
    - - \ No newline at end of file diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md deleted file mode 100644 index e681c569fe..0000000000 --- a/contribute/partest-guide.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -layout: page -title: Running the Test Suite ---- - -Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go the scala project folder from your local checkout and run it via `ant` or standalone as follows. - -## Using ant - -The test suite can be run by using ant from the command line: - - $ ant test.suite - -## Standalone - -There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use - - ./test/partest --show-diff --show-log --failed - -You can get a summary of the usage by running partest without arguments. - -* Most commonly you want to invoke partest with an option that tells it which part of the tests to run. For example `--all`, `--pos`, `--neg` or `--run`. -* You can test individual files by specifying individual test files (`.scala` files) as options. Several files can be tested if they are from the same category, e.g., `pos`. -* You can enable output of log and diff using the `-show-log` and `-show-diff` options. -* If you get into real trouble, and want to find out what partest does, you can run it with option `--verbose`. This info is useful as part of bug reports. -* Set custom path from where to load classes: `-classpath ` and `-buildpath `. -* You can use the `SCALAC_OPTS` environment variable to pass command line options to the compiler. -* You can use the `JAVA_OPTS` environment variable to pass command line options to the runner (e.g., for `run/jvm` tests). -* The launch scripts run partest as follows: - - scala -cp scala.tools.partest.nest.NestRunner - - Partest classes from a `quick` build, e.g., can be found in `./build/quick/classes/partest/`. - - Partest will tell you where it loads compiler/library classes from by adding the `partest.debug` property: - - scala -Dpartest.debug=true -cp scala.tools.partest.nest.NestRunner - - - -## ScalaCheck tests - -Tests that depend on [ScalaCheck](https://github.com/rickynils/scalacheck) can be added under folder `./test/files/scalacheck`. A sample test: - - import org.scalacheck._ - import Prop._ - - object Test { - val prop_ConcatLists = property{ (l1: ListInt, l2: ListInt) => - l1.size + l2.size == (l1 ::: l2).size - } - - val tests = List(("prop_ConcatLists", prop_ConcatLists)) - } - -## Troubleshooting - -### Windows - -Some tests might fail because line endings in the `.check` files and the produced results do not match. In that case, set either - - git config core.autocrlf false - -or - - git config core.autocrlf input \ No newline at end of file diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md deleted file mode 100644 index 75317be820..0000000000 --- a/contribute/scala-fame.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -layout: page -title: Scala Contribuitor Hall of Fame ---- -# Scala Hall of Fame - -A big thank you to everyone who contributed to: - - [the Scala library and compiler](https://github.com/scala/scala/contributors) - - [the Scala documentation website](https://github.com/scala/scala.github.com/contributors) \ No newline at end of file From ab597ab0b5dde3577da92ef3fd803f6e00675b94 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Thu, 30 May 2013 13:25:09 +0100 Subject: [PATCH 0020/3075] Going back to having a 'Contribute' section --- contribute/bug-reporting-guide.md | 89 +++++ contribute/documentation.md | 29 ++ contribute/hacker-guide.md | 337 ++++++++++++++++++ contribute/index.md | 201 +++++++++++ contribute/partest-guide.md | 66 ++++ .../_posts/2013-03-01-scala-fame-2013-02.md | 182 ++++++++++ .../_posts/2013-04-01-scala-fame-2013-03.md | 126 +++++++ .../_posts/2013-05-01-scala-fame-2013-04.md | 91 +++++ contribute/scala-fame.md | 14 + 9 files changed, 1135 insertions(+) create mode 100644 contribute/bug-reporting-guide.md create mode 100644 contribute/documentation.md create mode 100644 contribute/hacker-guide.md create mode 100644 contribute/index.md create mode 100644 contribute/partest-guide.md create mode 100644 contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md create mode 100644 contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md create mode 100644 contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md create mode 100644 contribute/scala-fame.md diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md new file mode 100644 index 0000000000..e286ce2002 --- /dev/null +++ b/contribute/bug-reporting-guide.md @@ -0,0 +1,89 @@ +--- +layout: page +title: Bug Reporting +--- + +# Reporting Bugs to the Scala Project + +The Scala project tracker is located at [http://issues.scala-lang.org](http://issues.scala-lang.org). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. + +## Is it a Bug? + +The first step in identifying a bug is to identify which component of the Scala distribution is affected. First, ensure that your issue falls within any of the following categories: + + - **Library** bugs typically manifest themselves as run-time exceptions, or as *unexpected*/*unintuitive* behavior of Scala Standard Library methods. + - **Compiler** errors are manifested as compile time exceptions, unexpected behavior of your code at run time, or invalid behavior of the type system. + - **Reflection** are bugs that appear in the ‘scala.reflect’ package. For the *reflection* bugs , the same rules apply as for the *library* bugs. + - **Scaladoc** bugs are manifested as a logical problems in the information it presents (that is, the displayed information is incorrect, such as an incorrect subclassing relationship), or incorrect behavior of the user interface. If you'd like to suggest a change in the content of the documentation, please submit a pull request (possible to do in the browser using GitHub, which is easier and faster than filing a bug). Please file a bug about the content of documentation only if you cannot provide a suggestion for its fix. + +If your issue is related to any of the following external projects, make sure to use its appropriate issue tracker: + + - [Akka](http://doc.akka.io/docs/akka/current/project/issue-tracking.html) + - [Play!](http://github.com/playframework/Play20/issues) + - [Slick](http://github.com/slick/slick/issues) + - [Actors Migration Kit](http://github.com/scala/actors-migration/issues?state=open) + - [Scala IDE](https://scala-ide-portfolio.assembla.com/spaces/scala-ide/support/tickets) + - [sbt](https://github.com/sbt/sbt/issues) + +The following are generally considered to be bugs: + +- **Scala Compiler Crash** If the Scala compiler is crashing with an internal error (compile time exception) you have certainly found a bug, and can move on to the next section of this document on reporting confirmed bugs. +- **Regressions** If some code snippet worked in a previous Scala release, but now no longer compiles or results in an exception, it is probably a regression. +- **Verify Errors** happen when the compiled Scala program is loaded to the Java Virtual Machine. If you're getting a *Verify Error*, you've usually found a bug. Make sure first that your project is not using stale `.class` files before reporting a new issue. + +If you have a code snippet that is resulting in bytecode which you believe is behaving incorrectly, you may or may not have found a bug. Before reporting your issue, please attempt the following: + +* Make sure you minimize your problem. To correctly minimize the problem follow the following instructions: + + 1. Gradually take apart the offensive code snippet until you believe you have the simplest representation of your problem. + + 2. Ensure that you have decoupled your code snippet from any library that could be introducing the offensive behavior. One way to achieve this is to try to recompile the offensive code snippet in isolation, outside of the context of any complex build environment. If your code depends on some strictly Java library and source code is available for it, make sure that the latter is also minimized. + + 3. Make sure you are compiling your project from a clean slate. Your problem could be related to separate compilation, which is difficult to detect without a clean build with new `.class` files. + + 4. If you have encountered a bug while building your code in the IDE, then please reproduce it on the command line. The same rule applies for build tools like `sbt` or `ant`. + + 5. If you want to file an improvement in the issue tracker please discuss it first on one of the mailing lists. They offer much bigger audience than issue tracker. The latter is not suitable for long discussions. + +* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/docu/files/ScalaReference.pdf). If in doubt, you may always ask on the [scala-internals mailing list](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) or [stackoveflow](http://stackoverflow.com/questions/tagged/scala). + +In general, if you find yourself stuck on any of these steps, asking on one of following Scala mailing lists can be helpful: + + - For unexpected behavior use [scala-language](https://groups.google.com/forum/?fromgroups#!forum/scala-language), or [scala-user](https://groups.google.com/forum/?fromgroups#!forum/scala-user) mailing lists. + - For compiler bugs use the [scala-internals](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) mailing list. + +* Examples of exceptions reported by the compiler which usually are not bugs: + 1. `StackOverflowError` is typically not a bug unless the stacktrace involves the internal packages of the compiler (like `scala.tools.nsc...`). Try to increase the Java stack size (`-Xss`), in most of the cases it helps. + 2. `AbstractMethodError` can occur when you did not recompile all the necessary Scala files (build tools, like `sbt`, can prevent that from happening) or you are mixing external libraries compiled for different Scala versions (for example one uses `2.10.x` and the other `2.11.x`). + +## Reporting Confirmed Bugs is a Sin + +Before reporting your bug, make sure to check the issue tracker for other similar bugs. The exception name or a compiler phase are the best keywords to search for. If you are experiencing unexpected behavior search for method/class names where it happens. Your issue might already be reported, and a workaround might already be available for you take advantage of. If your issue *is* reported, be sure to add your test case as a comment if it is different from any of the existing ones. + +**Note:** reporting a bug that already exists creates an additional overhead for you, the Scala Team, and all people that search the issue database. To avoid this inconvenience make sure that you thoroughly search for an existing issue. + +If you cannot find your issue in the issue tracker, create a new bug. The details about creating a bug report are in the following section. + +## Creating a Bug Report + +Please make sure to fill in as many fields as possible. Make sure you've indicated the following: + + 1. **Exact Scala version** that you are using. For example, `2.10.1` or `2.11.0-RC`. If the bug happens in multiple versions indicate all of them. + 2. **The component** that is affected by the bug. For example, the Standard Library, Scaladoc, etc. + 3. **Labels** related to your issue. For example, if you think your issue is related to the typechecker, and if you have successfully minimized your issue, label your bug as "typechecker" and "minimized". Issue tracker will suggest names for existing labels as you type them so try not to create duplicates. + 4. **Running environment**. Are you running on Linux? Windows? What JVM version are you using? + +In order for us to quickly triage the bug that you've found, it's important that the code snippet which produces the observed issue is as minimized as possible. For advice on minimizing your code snippet, please see the appropriate subsection of the above (Is it a Bug?). + +### Description + +In the description of your issue, be as detailed as you can. Bug reports which have the following information included are typically understood, triaged, and fixed very quickly: + + 1. Include a test case (minimized if possible) enabling us to reproduce the problematic behavior. Include your test case (and output) in proper formatting `{code}` blocks: + + {code}Here you put your classes{code} + + 2. The expected output. + 3. The actual output, including the stacktrace. + 4. Related discussion on the mailing lists, if applicable. + 4. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. \ No newline at end of file diff --git a/contribute/documentation.md b/contribute/documentation.md new file mode 100644 index 0000000000..05b2455a5f --- /dev/null +++ b/contribute/documentation.md @@ -0,0 +1,29 @@ +--- +layout: page +title: Documentation Contributions +--- +# Contributing documentation to the Scala project + +TODO + + diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md new file mode 100644 index 0000000000..758bb17115 --- /dev/null +++ b/contribute/hacker-guide.md @@ -0,0 +1,337 @@ +--- +layout: page +title: Scala hacker guide +--- + +**Eugene Burmako** + +This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea. + +This guide covers the entire process, from the conception of your idea or bugfix to the point where it is merged into Scala. Throughout, we will use a running example of an idea or bugfix one might wish to contribute. + +## The Running Example + +Let's say that you particularly enjoy the new string interpolation language feature introduced in Scala 2.10.0, and you use it quite heavily. + +Though, there's an annoying issue +which you occasionally stumble upon: the formatting string interpolator `f` [does not support](https://issues.scala-lang.org/browse/SI-6725) +new line tokens `%n`. + +One approach would be to go the mailing list, request that the bug be fixed, and then to wait indefinitely for the fix arrive. Another approach would be to instead patch Scala oneself, and to submit the fix to the Scala repository in hopes that it might make it into a subsequent release. + +**_Of note_**: There are several types of releases/builds. Nightly builds are produced every night at a fixed time. Minor releases happen once every few months. Major releases typically happen once per year. + +## 1. Connect + +Sometimes it's appealing to hack alone and not to have to interact with others out of fear, or out of comfort. However, in the context a big project such as Scala, +this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide +unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. + +Typically bug fixes new features start out as an idea or an experiment posted on one of our mailing lists [our mailing lists]({{ site.baseurl }}/community/index.html#mailing_lists) to find out how people feel +about things you want to implement. People proficient is certain areas of Scala usually monitor mailing lists, so you'll often get some help +by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. + +This is the list of language features/libraries along with their maintainers's full names and github usernames: + +{% include maintainers.html %} + +Since Martin is the person who submitted the string interpolation Scala Improvement Proposal and implemented this language feature for Scala 2.10.0, he might be interested in learning of new bugfixes to that feature. + +As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the scala-internals mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, +in this example, we post to the [the scala-user mailing list](http://groups.google.com/group/scala-user)about our issue. + +
    Posting to scala-user
    +
    +
    Response from Martin
    + +Now that we have the approval of the feature's author, we can get to work! + +## 2. Set up + +Hacking Scala begins with creating a branch for your work item. To develop Scala we use [Git](http://git-scm.com/) +and [GitHub](http://github.com/). This section of the guide provides a short walkthrough, but if you are new to Git, +it probably makes sense to familiarize yourself with Git first. We recommend the [Git Pro](http://git-scm.com/book/en/) +online book. + +### Fork + +Log into [GitHub](http://github.com/), go to [https://github.com/scala/scala](https://github.com/scala/scala) and click the `Fork` +button in the top right corner of the page. This will create your own copy of our repository that will serve as a scratchpad for your work. + +If you're new to Git, don't be afraid of messing up-- there is no way you can corrupt our repository. + +
    Fork scala/scala
    + +### Clone + +If everything went okay, you will be redirected to your own fork at `https://github.com/username/scala`, where `username` +is your github user name. You might find it helpful to read [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/), +which covers some of the things that will follow below. Then, _clone_ your repository (_i.e._ pull a copy from github to your local machine) by running the following on the command line: + + 16:35 ~/Projects$ git clone https://github.com/xeno-by/scala + Cloning into 'scala'... + remote: Counting objects: 258564, done. + remote: Compressing objects: 100% (58239/58239), done. + remote: Total 258564 (delta 182155), reused 254094 (delta 178356) + Receiving objects: 100% (258564/258564), 46.91 MiB | 700 KiB/s, done. + Resolving deltas: 100% (182155/182155), done. + +This will create a local directory called `scala`, which contains a clone of your own copy of our repository. The changes that you make +in this directory can be propagated back to your copy hosted on github and, ultimately, pushed into Scala when your patch is ready. + +### Branch + +Before you start making changes, always create your own branch. Never work on the `master` branch. Think of a name that describes +the changes you plan on making. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: +bug fixes and new features. + +* For bug fixes, use `issue/NNNN` for bug NNNN from the [Scala issue tracker](https://issues.scala-lang.org/). +* For new feature use `topic/XXX` for feature XXX. Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaladoc-diagrams` instead of just `topic/diagrams` would be a good branch name. + +Since in our example, we're going to fix an existing bug [SI-6725](https://issues.scala-lang.org/browse/SI-6725), we'll create a branch named `ticket/6725`. + + 16:39 ~/Projects/scala (master)$ git checkout -b ticket/6725 + Switched to a new branch 'ticket/6725' + +If you are new to Git and branching, read the [Branching Chapter](http://git-scm.com/book/en/Git-Branching) in the Git Pro book. + +### Build + +The next step after cloning your fork is setting up your machine to build Scala. The definitive guide on building Scala is located at +[https://github.com/scala/scala/blob/master/README.rst](https://github.com/scala/scala/blob/master/README.rst), but here's the summary: + +* It is recommended to use Java `1.6` (not `1.7` or `1.8`, because they might cause occasional glitches). +* The build tool is `ant`. +* The build runs the `pull-binary-libs.sh` script to download bootstrap libs. This requires `bash` and `curl`. +* The majority of our team works on Linux and OS X, so these operating systems are guaranteed to work. +* Windows is supported, but it might have issues. Please report to [the issue tracker](https://issues.scala-lang.org/) if you encounter any. + +Building Scala is as easy as running `ant` in the root of your cloned repository. Be prepared to wait for a while-- a full "clean" build +takes 8+ minutes depending on your machine (and up to 30 minutes on older machines with less memory). Incremental builds are usually within 30-120 seconds range (again, your mileage might vary +with your hardware). + + 16:50 ~/Projects/scala (ticket/6725)$ ant + Buildfile: /Users/xeno_by/Projects/scala/build.xml + + strap.clean: + + pack.clean: + + init.jars.check: + + init.jars: + [echo] Updating bootstrap libs. (To do this by hand, run ./pull-binary-libs.sh) + [exec] Resolving [943cd5c8802b2a3a64a010efb86ec19bac142e40/lib/ant/ant-contrib.jar] + + ... + + pack.bin: + [mkdir] Created dir: /Users/xeno_by/Projects/scala/build/pack/bin + + pack.done: + + build: + + BUILD SUCCESSFUL + Total time: 9 minutes 41 seconds + +### IDE + +There's no single editor of choice for working with Scala sources, as there are trade-offs associated with each available tool. + +Both Eclipse and IntelliJ IDEA have Scala plugins, which are known to work with our codebase. Here are +[instructions for Eclipse](https://github.com/scala/scala/blob/master/src/eclipse/README.md) and +[instructions for Intellij](https://github.com/scala/scala/blob/master/src/intellij/README). Both of those Scala plugins provide +navigation, refactoring and error reporting functionality as well as integrated debugging. + +There also exist lighter-weight editors such as Emacs, Sublime or jEdit which provide unparalleled are faster and much less memory/compute-intensive to run, while +lacking semantic services and debugging. To address this shortcoming, they can integrate with ENSIME, +a helper program, which hosts a resident Scala compiler providing some of the features implemented in traditional IDEs. However despite +having significantly matured over the last year, support for our particular code base is still being improved, and is not as mature as for Eclipse and IntelliJ. + +Due to the immense variability in personal preference between IDE/editor experience, it's difficult to recommend a particular tool, and your choice should boil down to your personal preferences. + +## 3. Hack + +When hacking on your topic of choice, you'll be modifying Scala, compiling it and testing it on relevant input files. +Typically you would want to first make sure that your changes work on a small example and afterwards verify that nothing break +by running a comprehensive test suite. + +We'll start by creating a `sandbox` directory (this particular name doesn't bear any special meaning), which will hold a single test file and its compilation results. First, let's make sure that +[the bug](https://issues.scala-lang.org/browse/SI-6725) is indeed reproducible by putting together a simple test and compiling and running it with the Scala compiler that we built using `ant`. The Scala compiler that we just built is located in `build/pack/bin`. + + 17:25 ~/Projects/scala (ticket/6725)$ mkdir sandbox + 17:26 ~/Projects/scala (ticket/6725)$ cd sandbox + 17:26 ~/Projects/scala/sandbox (ticket/6725)$ edit Test.scala + 17:26 ~/Projects/scala/sandbox (ticket/6725)$ cat Test.scala + object Test extends App { + val a = 1 + val s = f"$a%s%n$a%s" + println(s) + } + 17:27 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scalac Test.scala + 17:28 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test + 1%n1 // %n should've been replaced by a newline here + +### Implement + +Now, implement your bugfix or new feature! + +Here are also some tips & tricks that have proven useful in Scala development: + +* If after introducing changes or updating your clone, you get `AbstractMethodError` or other linkage exceptions, + try doing `ant clean build`. Due to the way how Scala compiles traits, if a trait changes, then it's sometimes not enough to recompile + just that trait, but it might also be necessary to recompile its users. The `ant` tool is not smart enough to do that, which might lead to + very strange errors. Full-rebuilds fix the problem. Fortunately that's rarely necessary, because full-rebuilds take a lot of time-- the same 8-30 minutes as mentioned above. +* Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, + some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts to launch Scala from `build/quick/classes`. +* Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how + things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious + to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. + +### Documentation + +There are several areas that one could contribute to-- there is the Scala library, the Scala compiler, and other tools such as Scaladoc. Each area has varying amounts of documentation. + +##### The Scala Library + +Contributing to the Scala standard library is about the same as working on one of your own libraries. Beyond the Scala collections hierarchy, there are no complex internals or architectures to have to worry about. Just make sure that you code in a "don't-repeat-yourself" (DRY) style, obeying the "boy scout principle" (i.e. make sure you've left something cleaner than you found it.) + +If documentation is necessary for some trait/class/object/method/etc in the Scala standard library, typically maintainers will include inline comments describing their design decisions or rationale for implementing things the way they have, if it is not straightforward. + +If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections](http://docs.scala-lang.org/overviews/core/architecture-of-scala-collections.html), as well as a larger more general [Scala collections Guide](http://docs.scala-lang.org/overviews/core/collections.html) covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide](http://docs.scala-lang.org/overviews/core/parallel-collections.html). (TODO double check these links!) + +##### The Scala Compiler + +Documentation about the internal workings of the Scala compiler is scarce, and most of the knowledge is passed around by email (scala-internals mailing list), ticket, or word of mouth. However the situation is steadily improving. Here are the resources that might help: + +* [Compiler internals videos by Martin Odersky](TODO) are quite dated, but still very useful. In this three-video + series Martin explains the general architecture of the compiler, and the basics of the front-end, which has recently become Scala reflection API. +* [Reflection documentation](http://docs.scala-lang.org/overviews/reflection/overview.html) describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that + are used to represent Scala programs and operations defined on then. Since much of the compiler has been factored out and made accessible via the Reflection API, all of the fundamentals needed for reflection are the same for the compiler. +* [Reflection and Compilers by Martin Odersky](http://channel9.msdn.com/Events/Lang-NEXT/Lang-NEXT-2012/Reflection-and-Compilers), a talk + at Lang.NEXT 2012 in which Martin elaborates on the design of scalac and the architecture of the reflection API. +* [Scala compiler corner](http://lampwww.epfl.ch/~magarcia/ScalaCompilerCornerReloaded/) contains extensive documentation about + most of the post-typer phases (i.e. the backend) in the Scala compiler. +* [scala-internals](http://groups.google.com/group/scala-internals), a mailing list which hosts discussions about the core + internal design and implementation of the Scala system. + +##### Other Projects + +Tools like Scaladoc also welcome contributions. Unfortunately these smaller projects have less developer documentation. In these cases, the best thing to do is to directly explore the code base (which often contains documentation as inline comments) or to write to the appropriate maintainers for pointers. + +### Interlude + +To fix [the bug we're interested in](https://issues.scala-lang.org/browse/SI-6725). Let's say we've tracked the `StringContext.f` interpolator +down to a macro implemented in `MacroImplementations.scala`, and there we notice that the interpolator only processes conversions, +but not tokens like `%n`. Looks like an easy fix. + + 18:44 ~/Projects/scala/sandbox (ticket/6725)$ git diff + diff --git a/src/compiler/scala/tools/reflect/MacroImplementations.scala b/src/compiler/scala/tools/ + index 002a3fce82..4e8f02084d 100644 + --- a/src/compiler/scala/tools/reflect/MacroImplementations.scala + +++ b/src/compiler/scala/tools/reflect/MacroImplementations.scala + @@ -117,7 +117,8 @@ abstract class MacroImplementations { + if (!strIsEmpty) { + val len = str.length + while (idx < len) { + - if (str(idx) == '%') { + + def notPercentN = str(idx) != '%' || (idx + 1 < len && str(idx + 1) != 'n') + + if (str(idx) == '%' && notPercentN) { + bldr append (str substring (start, idx)) append "%%" + start = idx + 1 + } + +After applying the fix and running `ant`, our simple test case in `sandbox/Test.scala` started working! + + 18:51 ~/Projects/scala/sandbox (ticket/6725)$ cd .. + 18:51 ~/Projects/scala (ticket/6725)$ ant + Buildfile: /Users/xeno_by/Projects/scala/build.xml + + ... + + quick.comp: + [scalacfork] Compiling 1 file to /Users/xeno_by/Projects/scala/build/quick/classes/compiler + [propertyfile] Updating property file: /Users/xeno_by/Projects/scala/build/quick/classes/compiler/compiler.properties + [stopwatch] [quick.comp.timer: 6.588 sec] + + ... + + BUILD SUCCESSFUL + Total time: 18 seconds + + 18:51 ~/Projects/scala (ticket/6725)$ cd sandbox + 18:51 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scalac Test.scala + 18:51 ~/Projects/scala/sandbox (ticket/6725)$ ../build/pack/bin/scala Test + 1 + 1 // no longer getting the %n here - it got transformed into a newline + +### Verify + +Now to make sure that my fix doesn't break anything I need to run the test suite using the `partest` tool we wrote to test Scala. +Read up [the partest guide](partest-guide.html) to learn the details about partest, but in a nutshell you can either +run `ant test` to go through the entire test suite (30+ minutes) or use wildcards to limit the tests to something manageable: + + 18:52 ~/Projects/scala/sandbox (ticket/6725)$ cd ../test + 18:56 ~/Projects/scala/test (ticket/6725)$ partest files/run/*interpol* + Testing individual files + testing: [...]/files/run/interpolationArgs.scala [ OK ] + testing: [...]/files/run/interpolationMultiline1.scala [ OK ] + testing: [...]/files/run/interpolationMultiline2.scala [ OK ] + testing: [...]/files/run/sm-interpolator.scala [ OK ] + testing: [...]/files/run/interpolation.scala [ OK ] + testing: [...]/files/run/stringinterpolation_macro-run.scala [ OK ] + All of 6 tests were successful (elapsed time: 00:00:08) + +## 4. Publish + +After development is finished, it's time to publish the code and submit your patch for discussion and potential inclusion into Scala. +In a nutshell, this involves: + + 1. making sure that your code and commit messages are of high quality, + 2. clicking a few buttons in the Github interface, + 3. assigning one or more reviewers which will look through your pull request. + + Let's go into each of these points in more detail. + +### Commit + +The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. +There are two things you should know here: + + 1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) for more information about the desired style of your commits. + + 2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. + +Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on Github. + + 19:22 ~/Projects/scala/test (ticket/6725)$ git add ../src/compiler/scala/tools/reflect/MacroImplementations.scala + 19:22 ~/Projects/scala/test (ticket/6725)$ git commit + [ticket/6725 3c3098693b] SI-6725 `f` interpolator now supports %n tokens + 1 file changed, 2 insertions(+), 1 deletion(-) + 19:34 ~/Projects/scala/test (ticket/6725)$ git push origin ticket/6725 + Username for 'https://github.com': xeno-by + Password for 'https://xeno-by@github.com': + Counting objects: 15, done. + Delta compression using up to 8 threads. + Compressing objects: 100% (8/8), done. + Writing objects: 100% (8/8), 1.00 KiB, done. + Total 8 (delta 5), reused 0 (delta 0) + To https://github.com/xeno-by/scala + * [new branch] ticket/6725 -> ticket/6725 + +### Submit + +Now, we must simply submit our proposed patch. Navigate to your branch in Github (for me it was `https://github.com/xeno-by/scala/tree/ticket/6725`) +and click the pull request button to submit your patch as a pull request to Scala. If you've never submitted patches to Scala, you will +need to sign the contributor license agreement, which [can be done online](http://typesafe.com/contribute/cla/scala) within a few minutes. + +
    Submit a pull request
    + +### Discuss + +After the pull request has been submitted, you need to pick a reviewer (usually the person you've contacted in the beginning of your +workflow) and be ready to elaborate and adjust your patch if necessary. In this example, we picked Martin, because we had such a nice chat on the mailing list: + +
    SAssign the reviewer
    + diff --git a/contribute/index.md b/contribute/index.md new file mode 100644 index 0000000000..c3be3be994 --- /dev/null +++ b/contribute/index.md @@ -0,0 +1,201 @@ +--- +layout: page +title: Get Involved +--- +# Contributing to the Scala project + +The Scala programming language is an open source project with a very +diverse community, where people from all over the world contribute their work, +with everyone benefitting from friendly help and advice, and +kindly helping others in return. So why not join the Scala community and help +everyone make things better? + +
    +
    +
    +

    Scala Internals

    +

    Get a peek into the inners of the Scala compiler.

    +
    +
    +

    Report an issue

    +

    File a bug report or a feature request.

    +
    +
    +

    Documentation

    +

    Improve the documentation itself.

    +
    +
    + +
    +
    +

    Write a SIP

    +

    Write a proposal for extending/improving Scala.

    +
    +
    +

    Hacker's guide

    +

    Learn to write good code and improve your chances of contributing to the Scala galaxy.

    +
    +
    +

    Community issues

    +

    Get cracking on some easy to approach issues.

    +
    +
    + +
    +
    +

    Unassigned issues

    +

    Get serious with some more complex issues.

    +
    +
    +

    Hall of Fame

    +

    Track your rockstar status in the community.

    +
    +
    +

    Test your contributions

    +

    Learn how to run the Scala test suite.

    +
    +
    +
    + + + +### Why contribute a patch to Scala? + +Just to name a few common reasons: + - contributing a patch is the best way to make sure your desired changes will be available in the next Scala version + - Scala is written in Scala, so going through the source code and patching it will improve your Scala-fu + - last but not least, you will make it into the [Scala Contributor Hall of Fame](scala-fame.html). + +
    + +The main Scala project consists of the standard Scala library, the Scala reflection and macros library, +the Scala compiler and the Scaladoc tool. This means there's plenty to choose from when deciding what to work on. +Typically the scaladoc tool provides a low entry point for new committers, so it is a good first step into contributing. + +On the Scala bug tracker you will find many bugs that are [marked as good starting points to contributing ("community" bugs)](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12111) or [that are not currently assigned](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12112) and that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. + +If you are interested in contributing code, we ask you to sign the +[Scala Contributor License Agreement](http://typesafe.com/contribute/cla/scala), +which allows us to ensure that all code submitted to the project is +unencumbered by copyrights or patents. + +
    + +### I have this idea that I'd like to add to Scala, how do I start? + +The first step to making a change is to discuss it with the community at large, to make sure everyone agrees on the idea +and on the implementation plan. Starting point ("community") bugs are usually uncontroversial, so you can jump right +ahead to hacking the scala source tree and filing a pull request. For larger changes it is best to announce the change +on the [scala-internals](http://groups.google.com/group/scala-internals) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list. + +Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against +the Scala project source tree. The [hacker guide](hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. + +
    + + diff --git a/contribute/partest-guide.md b/contribute/partest-guide.md new file mode 100644 index 0000000000..e681c569fe --- /dev/null +++ b/contribute/partest-guide.md @@ -0,0 +1,66 @@ +--- +layout: page +title: Running the Test Suite +--- + +Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go the scala project folder from your local checkout and run it via `ant` or standalone as follows. + +## Using ant + +The test suite can be run by using ant from the command line: + + $ ant test.suite + +## Standalone + +There are launch scripts `partest` and `partest.bat` in the `test` folder of the scala project. To have partest run failing tests only and print details about test failures to the console, you can use + + ./test/partest --show-diff --show-log --failed + +You can get a summary of the usage by running partest without arguments. + +* Most commonly you want to invoke partest with an option that tells it which part of the tests to run. For example `--all`, `--pos`, `--neg` or `--run`. +* You can test individual files by specifying individual test files (`.scala` files) as options. Several files can be tested if they are from the same category, e.g., `pos`. +* You can enable output of log and diff using the `-show-log` and `-show-diff` options. +* If you get into real trouble, and want to find out what partest does, you can run it with option `--verbose`. This info is useful as part of bug reports. +* Set custom path from where to load classes: `-classpath ` and `-buildpath `. +* You can use the `SCALAC_OPTS` environment variable to pass command line options to the compiler. +* You can use the `JAVA_OPTS` environment variable to pass command line options to the runner (e.g., for `run/jvm` tests). +* The launch scripts run partest as follows: + + scala -cp scala.tools.partest.nest.NestRunner + + Partest classes from a `quick` build, e.g., can be found in `./build/quick/classes/partest/`. + + Partest will tell you where it loads compiler/library classes from by adding the `partest.debug` property: + + scala -Dpartest.debug=true -cp scala.tools.partest.nest.NestRunner + + + +## ScalaCheck tests + +Tests that depend on [ScalaCheck](https://github.com/rickynils/scalacheck) can be added under folder `./test/files/scalacheck`. A sample test: + + import org.scalacheck._ + import Prop._ + + object Test { + val prop_ConcatLists = property{ (l1: ListInt, l2: ListInt) => + l1.size + l2.size == (l1 ::: l2).size + } + + val tests = List(("prop_ConcatLists", prop_ConcatLists)) + } + +## Troubleshooting + +### Windows + +Some tests might fail because line endings in the `.check` files and the produced results do not match. In that case, set either + + git config core.autocrlf false + +or + + git config core.autocrlf input \ No newline at end of file diff --git a/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md b/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md new file mode 100644 index 0000000000..fbdccb279c --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md @@ -0,0 +1,182 @@ +--- +layout: famearchive +title: Contributors of February 2013 +fame-year: 2013 +fame-month: 2 +fame-month-str: February +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 38 + linesAdded: 2578 + linesDeleted: 2114 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 31 + linesAdded: 7110 + linesDeleted: 9889 + rank: 2 + newContributor: false + - username: JamesIry + gravatar: https://secure.gravatar.com/avatar/72b1a6b08fd8bb3068bd281974461c3e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 23 + linesAdded: 1673 + linesDeleted: 740 + rank: 3 + newContributor: false + - username: paulp + gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 10 + linesAdded: 1466 + linesDeleted: 1097 + rank: 4 + newContributor: false + - username: gkossakowski + gravatar: https://secure.gravatar.com/avatar/e608c8cb27858cc5aaf7d0c1e57958d7?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 4 + linesDeleted: 1 + rank: 5 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 29 + linesAdded: 2108 + linesDeleted: 724 + rank: 1 + newContributor: false + - username: lrytz + gravatar: https://secure.gravatar.com/avatar/d807dd5133a6fc14c821178e53c34091?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 3 + linesAdded: 213 + linesDeleted: 31 + rank: 2 + newContributor: false + - username: heathermiller + gravatar: https://secure.gravatar.com/avatar/54d0b6494927c0040b96ed327202e8dc?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 2 + linesDeleted: 1333 + rank: 3 + newContributor: false + - username: VladUreche + gravatar: https://secure.gravatar.com/avatar/5658ed1cea041577df360fd663c570fa?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 86 + linesDeleted: 32 + rank: 3 + newContributor: false + - username: axel22 + gravatar: https://secure.gravatar.com/avatar/e9bdb4fada7e635fffb5e6f26e70cd1d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 9 + linesDeleted: 106 + rank: 4 + newContributor: false + - category: Community + authors: + - username: vigdorchik + gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 4 + linesAdded: 471 + linesDeleted: 410 + rank: 1 + newContributor: false + - username: vy + gravatar: https://secure.gravatar.com/avatar/bb8d759cf4230bcaa238fac0018af80c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 21 + linesDeleted: 21 + rank: 2 + newContributor: true + - username: u-abramchuk + gravatar: https://secure.gravatar.com/avatar/c70eb13a60582914b51966fdc1a18536?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 47 + linesDeleted: 13 + rank: 2 + newContributor: true + - username: viktorklang + gravatar: https://secure.gravatar.com/avatar/4f674b2e79f1663864ff78e07ce4c8a8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 38 + linesDeleted: 10 + rank: 2 + newContributor: false + - username: jozic + gravatar: https://secure.gravatar.com/avatar/41fbba6d48e543a7dfa8c231b2d0286d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 8 + linesDeleted: 8 + rank: 3 + newContributor: true + - username: rnix + gravatar: https://secure.gravatar.com/avatar/0dcbf348a28f2295164c53a40d48a958?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 3 + newContributor: true + - username: mergeconflict + gravatar: https://secure.gravatar.com/avatar/9a58682929b182af7b01f0180e072fcd?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 22 + linesDeleted: 15 + rank: 3 + newContributor: false + - username: huitseeker + gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 26 + linesDeleted: 0 + rank: 3 + newContributor: false + - username: ViniciusMiana + gravatar: https://secure.gravatar.com/avatar/e05e828a92458c4075b498c7d2957ddd?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 16 + linesDeleted: 0 + rank: 3 + newContributor: false + - username: mt2309 + gravatar: https://secure.gravatar.com/avatar/f70e1d36b9c1b9290d31e810fa1502f3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 3 + linesDeleted: 0 + rank: 3 + newContributor: false + - username: Blaisorblade + gravatar: https://secure.gravatar.com/avatar/a3a676c96a88feb813010e67af012ca0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 0 + linesDeleted: 3 + rank: 3 + newContributor: false + - username: rkuhn + gravatar: https://secure.gravatar.com/avatar/262b1ab25e66b1e15a48fa3f68703aad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 3 + linesDeleted: 2 + rank: 3 + newContributor: false + - username: khernyo + gravatar: https://secure.gravatar.com/avatar/0e0d750a49edb4b16e8ec83816ea356e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 25 + linesDeleted: 1 + rank: 3 + newContributor: false + - username: som-snytt + gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 3 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md b/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md new file mode 100644 index 0000000000..51b489e84c --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md @@ -0,0 +1,126 @@ +--- +layout: famearchive +title: Contributors of March 2013 +fame-year: 2013 +fame-month: 3 +fame-month-str: March +fame-categories: + - category: Typesafe + authors: + - username: paulp + gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 51 + linesAdded: 38101 + linesDeleted: 37753 + rank: 1 + newContributor: false + - username: retronym + gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 45 + linesAdded: 4824 + linesDeleted: 3092 + rank: 2 + newContributor: false + - username: adriaanm + gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 26 + linesAdded: 2632 + linesDeleted: 5012 + rank: 3 + newContributor: false + - username: JamesIry + gravatar: https://secure.gravatar.com/avatar/72b1a6b08fd8bb3068bd281974461c3e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 7 + linesAdded: 1218 + linesDeleted: 171 + rank: 4 + newContributor: false + - username: dragos + gravatar: https://secure.gravatar.com/avatar/fbd384e9626d28d1648f023a5e22672f?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 169 + linesDeleted: 2 + rank: 5 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 7 + linesAdded: 212 + linesDeleted: 104 + rank: 1 + newContributor: false + - category: Community + authors: + - username: vigdorchik + gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 9 + linesAdded: 714 + linesDeleted: 619 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 7 + linesAdded: 2103 + linesDeleted: 2068 + rank: 2 + newContributor: false + - username: soc + gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 5 + linesAdded: 162 + linesDeleted: 96 + rank: 3 + newContributor: false + - username: kzys + gravatar: https://secure.gravatar.com/avatar/7828b45f8396aa361d85cead01fd99ca?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 5 + linesAdded: 129 + linesDeleted: 41 + rank: 3 + newContributor: false + - username: Blaisorblade + gravatar: https://secure.gravatar.com/avatar/a3a676c96a88feb813010e67af012ca0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 3 + linesAdded: 72 + linesDeleted: 20 + rank: 4 + newContributor: false + - username: mesagie + gravatar: https://secure.gravatar.com/avatar/6e7dc465ed74b5250147168a0178d91c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 4 + linesDeleted: 5 + rank: 5 + newContributor: true + - username: srinivasreddy + gravatar: https://secure.gravatar.com/avatar/1f542afb3240b82fdf08632bf6cd5384?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 5 + newContributor: true + - username: mergeconflict + gravatar: https://secure.gravatar.com/avatar/9a58682929b182af7b01f0180e072fcd?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 22 + linesDeleted: 15 + rank: 5 + newContributor: false + - username: sschaef + gravatar: https://secure.gravatar.com/avatar/dd80aab570fdb5f37e62de5422f44ed4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 13 + linesDeleted: 0 + rank: 5 + newContributor: false + - username: chuvoks + gravatar: https://secure.gravatar.com/avatar/415869059046602f37803890bd992fc0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 45 + linesDeleted: 24 + rank: 5 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md b/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md new file mode 100644 index 0000000000..ca59c6cdfb --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md @@ -0,0 +1,91 @@ +--- +layout: famearchive +title: Contributors of April 2013 +fame-year: 2013 +fame-month: 4 +fame-month-str: April +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 36 + linesAdded: 1274 + linesDeleted: 776 + rank: 1 + newContributor: false + - username: paulp + gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 26 + linesAdded: 1848 + linesDeleted: 1647 + rank: 2 + newContributor: false + - username: vigdorchik + gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 6 + linesAdded: 136 + linesDeleted: 186 + rank: 3 + newContributor: false + - username: adriaanm + gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 3 + linesDeleted: 1 + rank: 4 + newContributor: false + - category: EPFL + authors: + - username: magarciaEPFL + gravatar: https://secure.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 9 + linesAdded: 147 + linesDeleted: 149 + rank: 1 + newContributor: false + - username: heathermiller + gravatar: https://secure.gravatar.com/avatar/54d0b6494927c0040b96ed327202e8dc?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 2 + newContributor: false + - username: hubertp + gravatar: https://secure.gravatar.com/avatar/e0dec64f93778e5c689c3873078a406f?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 54 + linesDeleted: 46 + rank: 2 + newContributor: false + - category: Community + authors: + - username: som-snytt + gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 11 + linesAdded: 1000 + linesDeleted: 509 + rank: 1 + newContributor: false + - username: soc + gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 3 + linesAdded: 37 + linesDeleted: 22 + rank: 2 + newContributor: false + - username: huitseeker + gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 15 + linesDeleted: 19 + rank: 3 + newContributor: false + - username: namin + gravatar: https://secure.gravatar.com/avatar/f2adf4eb83e1221b519d23bf0bdc98d2?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 6 + linesDeleted: 11 + rank: 4 + newContributor: false +--- diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md new file mode 100644 index 0000000000..98fad6e629 --- /dev/null +++ b/contribute/scala-fame.md @@ -0,0 +1,14 @@ +--- +layout: page +title: Scala Contribuitor Hall of Fame +--- +# Scala Hall of Fame + +A big thank you to everyone who contributed to: + - [the Scala library and compiler](https://github.com/scala/scala/contributors) + - [the Scala documentation website](https://github.com/scala/scala.github.com/contributors) + +{% for data in site.categories.scala-fame-data limit:1 %} + {% assign famedata = data %} + {% include render-scala-fame.html %} +{% endfor %} From 8559ddab546a4548f3cca197793f3809e3fe8d7f Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Thu, 30 May 2013 13:26:48 +0100 Subject: [PATCH 0021/3075] Going back to having a 'Contribute' section, take 2 --- contribute/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/index.md b/contribute/index.md index c3be3be994..6e07e5b84c 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -1,6 +1,6 @@ --- layout: page -title: Get Involved +title: Contribute --- # Contributing to the Scala project From 96c6854e2422b5a813d80ac737e4f58958a17c71 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Wed, 5 Jun 2013 11:50:04 +0200 Subject: [PATCH 0022/3075] Making contribute page full width --- contribute/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/index.md b/contribute/index.md index 6e07e5b84c..9b6024dcf9 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -1,5 +1,5 @@ --- -layout: page +layout: page-full-width title: Contribute --- # Contributing to the Scala project From 2ddf889be5bad81e58ee391e1cf2cee85d3c5b36 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 6 Jun 2013 09:09:53 +0200 Subject: [PATCH 0023/3075] Added hall of fame of May 2013. --- .../_posts/2013-06-01-scala-fame-2013-05.md | 105 ++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2013-06-01-scala-fame-2013-05.md diff --git a/contribute/scala-fame-data/_posts/2013-06-01-scala-fame-2013-05.md b/contribute/scala-fame-data/_posts/2013-06-01-scala-fame-2013-05.md new file mode 100644 index 0000000000..2829d6a4aa --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-06-01-scala-fame-2013-05.md @@ -0,0 +1,105 @@ +--- +layout: famearchive +title: Contributors of May 2013 +fame-year: 2013 +fame-month: 5 +fame-month-str: May +fame-categories: + - category: Typesafe + authors: + - username: paulp + gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 54 + linesAdded: 3465 + linesDeleted: 2035 + rank: 1 + newContributor: false + - username: retronym + gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 13 + linesAdded: 525 + linesDeleted: 66 + rank: 2 + newContributor: false + - username: adriaanm + gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 5 + linesAdded: 245 + linesDeleted: 81 + rank: 3 + newContributor: false + - username: viktorklang + gravatar: https://secure.gravatar.com/avatar/4f674b2e79f1663864ff78e07ce4c8a8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 51 + linesDeleted: 32 + rank: 4 + newContributor: false + - username: phaller + gravatar: https://secure.gravatar.com/avatar/3b84657fdb075382e3781310ca8a9a70?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 1965 + linesDeleted: 1086 + rank: 5 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 19 + linesAdded: 742 + linesDeleted: 468 + rank: 1 + newContributor: false + - username: magarciaEPFL + gravatar: https://secure.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 11 + linesAdded: 1214 + linesDeleted: 1069 + rank: 2 + newContributor: false + - username: heathermiller + gravatar: https://secure.gravatar.com/avatar/54d0b6494927c0040b96ed327202e8dc?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 10 + linesDeleted: 7 + rank: 3 + newContributor: false + - category: Community + authors: + - username: soc + gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 12 + linesAdded: 254 + linesDeleted: 1135 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 6 + linesAdded: 454 + linesDeleted: 403 + rank: 2 + newContributor: false + - username: vigdorchik + gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 42 + linesDeleted: 32 + rank: 3 + newContributor: false + - username: dcsobral + gravatar: https://secure.gravatar.com/avatar/6d43da5df0e52fc31c55e6a227bb23f4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 6 + linesDeleted: 2 + rank: 4 + newContributor: false + - username: kzys + gravatar: https://secure.gravatar.com/avatar/7828b45f8396aa361d85cead01fd99ca?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 25 + linesDeleted: 9 + rank: 4 + newContributor: false +--- From 81e54742affd89a43d638b815593089857f277cd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 6 Jun 2013 09:17:01 +0200 Subject: [PATCH 0024/3075] 3-column layout for hall of fame pages. --- contribute/scala-fame.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md index 98fad6e629..084c120e27 100644 --- a/contribute/scala-fame.md +++ b/contribute/scala-fame.md @@ -1,5 +1,5 @@ --- -layout: page +layout: page-full-width title: Scala Contribuitor Hall of Fame --- # Scala Hall of Fame From 5a8dd183d57819c319f69e3d92ee73aabf6c934f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 6 Jun 2013 09:28:28 +0200 Subject: [PATCH 0025/3075] Added namin in EPFL people. --- .../_posts/2013-03-01-scala-fame-2013-02.md | 63 +++++----- .../_posts/2013-04-01-scala-fame-2013-03.md | 63 ++++++---- .../_posts/2013-05-01-scala-fame-2013-04.md | 115 ++++++++++++------ 3 files changed, 152 insertions(+), 89 deletions(-) diff --git a/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md b/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md index fbdccb279c..376563abce 100644 --- a/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md +++ b/contribute/scala-fame-data/_posts/2013-03-01-scala-fame-2013-02.md @@ -35,20 +35,41 @@ fame-categories: linesDeleted: 1097 rank: 4 newContributor: false + - username: viktorklang + gravatar: https://secure.gravatar.com/avatar/4f674b2e79f1663864ff78e07ce4c8a8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 3 + linesAdded: 84 + linesDeleted: 53 + rank: 5 + newContributor: false - username: gkossakowski gravatar: https://secure.gravatar.com/avatar/e608c8cb27858cc5aaf7d0c1e57958d7?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 2 linesAdded: 4 linesDeleted: 1 - rank: 5 + rank: 6 + newContributor: false + - username: huitseeker + gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 26 + linesDeleted: 0 + rank: 7 + newContributor: false + - username: rkuhn + gravatar: https://secure.gravatar.com/avatar/262b1ab25e66b1e15a48fa3f68703aad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 3 + linesDeleted: 2 + rank: 7 newContributor: false - category: EPFL authors: - username: xeno-by gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 29 - linesAdded: 2108 - linesDeleted: 724 + commits: 36 + linesAdded: 3379 + linesDeleted: 1635 rank: 1 newContributor: false - username: lrytz @@ -72,6 +93,13 @@ fame-categories: linesDeleted: 32 rank: 3 newContributor: false + - username: hubertp + gravatar: https://secure.gravatar.com/avatar/e0dec64f93778e5c689c3873078a406f?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 2 + linesAdded: 297 + linesDeleted: 100 + rank: 3 + newContributor: false - username: axel22 gravatar: https://secure.gravatar.com/avatar/e9bdb4fada7e635fffb5e6f26e70cd1d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 @@ -102,13 +130,6 @@ fame-categories: linesDeleted: 13 rank: 2 newContributor: true - - username: viktorklang - gravatar: https://secure.gravatar.com/avatar/4f674b2e79f1663864ff78e07ce4c8a8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 2 - linesAdded: 38 - linesDeleted: 10 - rank: 2 - newContributor: false - username: jozic gravatar: https://secure.gravatar.com/avatar/41fbba6d48e543a7dfa8c231b2d0286d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 @@ -130,10 +151,10 @@ fame-categories: linesDeleted: 15 rank: 3 newContributor: false - - username: huitseeker - gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + - username: mt2309 + gravatar: https://secure.gravatar.com/avatar/f70e1d36b9c1b9290d31e810fa1502f3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 - linesAdded: 26 + linesAdded: 3 linesDeleted: 0 rank: 3 newContributor: false @@ -144,13 +165,6 @@ fame-categories: linesDeleted: 0 rank: 3 newContributor: false - - username: mt2309 - gravatar: https://secure.gravatar.com/avatar/f70e1d36b9c1b9290d31e810fa1502f3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 3 - linesDeleted: 0 - rank: 3 - newContributor: false - username: Blaisorblade gravatar: https://secure.gravatar.com/avatar/a3a676c96a88feb813010e67af012ca0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 @@ -158,13 +172,6 @@ fame-categories: linesDeleted: 3 rank: 3 newContributor: false - - username: rkuhn - gravatar: https://secure.gravatar.com/avatar/262b1ab25e66b1e15a48fa3f68703aad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 3 - linesDeleted: 2 - rank: 3 - newContributor: false - username: khernyo gravatar: https://secure.gravatar.com/avatar/0e0d750a49edb4b16e8ec83816ea356e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 diff --git a/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md b/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md index 51b489e84c..0feb88618a 100644 --- a/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md +++ b/contribute/scala-fame-data/_posts/2013-04-01-scala-fame-2013-03.md @@ -16,16 +16,16 @@ fame-categories: newContributor: false - username: retronym gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 45 - linesAdded: 4824 + commits: 46 + linesAdded: 4908 linesDeleted: 3092 rank: 2 newContributor: false - username: adriaanm gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 26 - linesAdded: 2632 - linesDeleted: 5012 + commits: 27 + linesAdded: 2675 + linesDeleted: 5043 rank: 3 newContributor: false - username: JamesIry @@ -46,11 +46,18 @@ fame-categories: authors: - username: xeno-by gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 7 - linesAdded: 212 - linesDeleted: 104 + commits: 11 + linesAdded: 295 + linesDeleted: 129 rank: 1 newContributor: false + - username: magarciaEPFL + gravatar: https://secure.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 6 + linesAdded: 89 + linesDeleted: 44 + rank: 2 + newContributor: false - category: Community authors: - username: vigdorchik @@ -69,8 +76,8 @@ fame-categories: newContributor: false - username: soc gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 5 - linesAdded: 162 + commits: 6 + linesAdded: 166 linesDeleted: 96 rank: 3 newContributor: false @@ -79,48 +86,62 @@ fame-categories: commits: 5 linesAdded: 129 linesDeleted: 41 - rank: 3 + rank: 4 newContributor: false - username: Blaisorblade gravatar: https://secure.gravatar.com/avatar/a3a676c96a88feb813010e67af012ca0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 3 linesAdded: 72 linesDeleted: 20 - rank: 4 + rank: 5 newContributor: false - - username: mesagie - gravatar: https://secure.gravatar.com/avatar/6e7dc465ed74b5250147168a0178d91c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + - username: starblood + gravatar: https://secure.gravatar.com/avatar/bd3514b960213c6a7ff5fd3186675429?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 - linesAdded: 4 - linesDeleted: 5 - rank: 5 + linesAdded: 1 + linesDeleted: 1 + rank: 6 newContributor: true - username: srinivasreddy gravatar: https://secure.gravatar.com/avatar/1f542afb3240b82fdf08632bf6cd5384?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 linesAdded: 1 linesDeleted: 1 - rank: 5 + rank: 6 + newContributor: true + - username: mesagie + gravatar: https://secure.gravatar.com/avatar/6e7dc465ed74b5250147168a0178d91c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 4 + linesDeleted: 5 + rank: 6 newContributor: true - username: mergeconflict gravatar: https://secure.gravatar.com/avatar/9a58682929b182af7b01f0180e072fcd?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 linesAdded: 22 linesDeleted: 15 - rank: 5 + rank: 6 newContributor: false - username: sschaef gravatar: https://secure.gravatar.com/avatar/dd80aab570fdb5f37e62de5422f44ed4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 linesAdded: 13 linesDeleted: 0 - rank: 5 + rank: 6 + newContributor: false + - username: ihji + gravatar: https://secure.gravatar.com/avatar/866a258f0c9fa9529aa47ebd96fe599c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 33 + linesDeleted: 6 + rank: 6 newContributor: false - username: chuvoks gravatar: https://secure.gravatar.com/avatar/415869059046602f37803890bd992fc0?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 linesAdded: 45 linesDeleted: 24 - rank: 5 + rank: 6 newContributor: false --- diff --git a/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md b/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md index ca59c6cdfb..e2cd419e9b 100644 --- a/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md +++ b/contribute/scala-fame-data/_posts/2013-05-01-scala-fame-2013-04.md @@ -7,85 +7,120 @@ fame-month-str: April fame-categories: - category: Typesafe authors: - - username: retronym - gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 36 - linesAdded: 1274 - linesDeleted: 776 - rank: 1 - newContributor: false - username: paulp gravatar: https://secure.gravatar.com/avatar/c25d674f69bb9c155f265a7482712be4?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 26 - linesAdded: 1848 - linesDeleted: 1647 + commits: 38 + linesAdded: 3745 + linesDeleted: 2973 + rank: 1 + newContributor: false + - username: retronym + gravatar: https://secure.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 37 + linesAdded: 1309 + linesDeleted: 777 rank: 2 newContributor: false - - username: vigdorchik - gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 6 - linesAdded: 136 - linesDeleted: 186 + - username: huitseeker + gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 3 + linesAdded: 16 + linesDeleted: 24 rank: 3 newContributor: false - username: adriaanm gravatar: https://secure.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 1 - linesAdded: 3 - linesDeleted: 1 + commits: 2 + linesAdded: 35 + linesDeleted: 82 rank: 4 newContributor: false - category: EPFL authors: - username: magarciaEPFL gravatar: https://secure.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 9 - linesAdded: 147 - linesDeleted: 149 + commits: 11 + linesAdded: 238 + linesDeleted: 204 rank: 1 newContributor: false + - username: xeno-by + gravatar: https://secure.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 4 + linesAdded: 208 + linesDeleted: 121 + rank: 2 + newContributor: false + - username: namin + gravatar: https://secure.gravatar.com/avatar/f2adf4eb83e1221b519d23bf0bdc98d2?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 6 + linesDeleted: 11 + rank: 3 + newContributor: false - username: heathermiller gravatar: https://secure.gravatar.com/avatar/54d0b6494927c0040b96ed327202e8dc?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 linesAdded: 1 linesDeleted: 1 - rank: 2 + rank: 3 newContributor: false - username: hubertp gravatar: https://secure.gravatar.com/avatar/e0dec64f93778e5c689c3873078a406f?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 linesAdded: 54 linesDeleted: 46 - rank: 2 + rank: 3 newContributor: false - category: Community authors: - username: som-snytt gravatar: https://secure.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 11 - linesAdded: 1000 - linesDeleted: 509 + commits: 16 + linesAdded: 2561 + linesDeleted: 1150 rank: 1 newContributor: false + - username: vigdorchik + gravatar: https://secure.gravatar.com/avatar/d497b1b875b7f68414daff74485b8501?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 9 + linesAdded: 235 + linesDeleted: 321 + rank: 2 + newContributor: false - username: soc gravatar: https://secure.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png - commits: 3 - linesAdded: 37 - linesDeleted: 22 - rank: 2 + commits: 4 + linesAdded: 38 + linesDeleted: 26 + rank: 3 newContributor: false - - username: huitseeker - gravatar: https://secure.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + - username: ihji + gravatar: https://secure.gravatar.com/avatar/866a258f0c9fa9529aa47ebd96fe599c?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 2 - linesAdded: 15 - linesDeleted: 19 - rank: 3 + linesAdded: 13 + linesDeleted: 2 + rank: 4 newContributor: false - - username: namin - gravatar: https://secure.gravatar.com/avatar/f2adf4eb83e1221b519d23bf0bdc98d2?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + - username: bjornregnell + gravatar: https://secure.gravatar.com/avatar/b1d20c98b0eeb72829523144b9174ca2?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png commits: 1 - linesAdded: 6 - linesDeleted: 11 - rank: 4 + linesAdded: 3 + linesDeleted: 2 + rank: 5 + newContributor: true + - username: aldenml + gravatar: https://secure.gravatar.com/avatar/bbf061bd484515c156f662a65820c226?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 4 + linesDeleted: 4 + rank: 5 + newContributor: true + - username: eed3si9n + gravatar: https://secure.gravatar.com/avatar/8f41595db400be30176f6f04630c2842?s=60&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png + commits: 1 + linesAdded: 304 + linesDeleted: 6 + rank: 5 newContributor: false --- From 5056003f15841f8f8362b0240f141e2b0aced0a2 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Sat, 8 Jun 2013 00:45:43 +0200 Subject: [PATCH 0026/3075] Styling contents and other cleanups --- contribute/bug-reporting-guide.md | 2 -- contribute/hacker-guide.md | 5 ++--- 2 files changed, 2 insertions(+), 5 deletions(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index e286ce2002..f04503f968 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -3,8 +3,6 @@ layout: page title: Bug Reporting --- -# Reporting Bugs to the Scala Project - The Scala project tracker is located at [http://issues.scala-lang.org](http://issues.scala-lang.org). Before you submit a bug make sure that it is certainly a bug by following instructions in *Is it a Bug?*. ## Is it a Bug? diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 758bb17115..484d3036a1 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -1,10 +1,9 @@ --- layout: page title: Scala hacker guide +by: Eugene Burmako --- - -**Eugene Burmako** - +
    This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea. This guide covers the entire process, from the conception of your idea or bugfix to the point where it is merged into Scala. Throughout, we will use a running example of an idea or bugfix one might wish to contribute. From 43b72d980cd057dc11dafb6f73d37bbad1f6e491 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Sat, 8 Jun 2013 20:32:38 +0200 Subject: [PATCH 0027/3075] Formatting fix to hackers guide --- contribute/hacker-guide.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 484d3036a1..d3ee84456f 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -287,9 +287,9 @@ run `ant test` to go through the entire test suite (30+ minutes) or use wildcard After development is finished, it's time to publish the code and submit your patch for discussion and potential inclusion into Scala. In a nutshell, this involves: - 1. making sure that your code and commit messages are of high quality, - 2. clicking a few buttons in the Github interface, - 3. assigning one or more reviewers which will look through your pull request. +1. making sure that your code and commit messages are of high quality, +2. clicking a few buttons in the Github interface, +3. assigning one or more reviewers which will look through your pull request. Let's go into each of these points in more detail. @@ -298,9 +298,8 @@ In a nutshell, this involves: The [Git Basics](http://git-scm.com/book/en/Git-Basics) chapter in the Git online book covers most of the basic workflow during this stage. There are two things you should know here: - 1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) for more information about the desired style of your commits. - - 2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. +1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) for more information about the desired style of your commits. +2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on Github. From 05854a11c3be0fbd2dfb0f10b27d5fc89cdffcac Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Fri, 12 Jul 2013 12:25:39 +0200 Subject: [PATCH 0028/3075] Moving community tickets back to contribute section --- contribute/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/contribute/index.md b/contribute/index.md index 9b6024dcf9..7338d06c2c 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -93,6 +93,10 @@ the Scala project source tree. The [hacker guide](hacker-guide.html) will explai
    +## Community Tickets + +
    + diff --git a/contribute/index.md b/contribute/index.md index 656109cf02..c7b822ae04 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -1,199 +1,19 @@ --- -layout: page-full-width +layout: page title: Contribute --- -# Contributing to the Scala project -The Scala programming language is an open source project with a very -diverse community, where people from all over the world contribute their work, -with everyone benefitting from friendly help and advice, and -kindly helping others in return. So why not join the Scala community and help -everyone make things better? +## How to help? -
    -
    -
    -

    Scala Internals

    -

    Get a peek into the inners of the Scala compiler.

    -
    -
    -

    Report an issue

    -

    File a bug report or a feature request.

    -
    -
    -

    Documentation

    -

    Improve the documentation itself.

    -
    -
    +### Reporting bugs -
    -
    -

    Write a SIP

    -

    Write a proposal for extending/improving Scala.

    -
    -
    -

    Hacker's guide

    -

    Learn to write good code and improve your chances of contributing to the Scala galaxy.

    -
    -
    -

    Community issues

    -

    Get cracking on some easy to approach issues.

    -
    -
    +See our [bug reporting guide](./bug-reporting-guide.html) to learn +how to efficiently report a bug. -
    -
    -

    Unassigned issues

    -

    Get serious with some more complex issues.

    -
    -
    -

    Hall of Fame

    -

    Track your rockstar status in the community.

    -
    -
    -

    Test your contributions

    -

    Learn how to run the Scala test suite.

    -
    -
    -
    +### Patch the core +Want to dive into the hardcore business? Check out our +[selection of community tickets](./community-tickets.html), +which are good starting points to contributing. - -### Why contribute a patch to Scala? - -Just to name a few common reasons: - - contributing a patch is the best way to make sure your desired changes will be available in the next Scala version - - Scala is written in Scala, so going through the source code and patching it will improve your Scala-fu - - last but not least, you will make it into the [Scala Contributor Hall of Fame](scala-fame.html). - -
    - -The main Scala project consists of the standard Scala library, the Scala reflection and macros library, -the Scala compiler and the Scaladoc tool. This means there's plenty to choose from when deciding what to work on. -Typically the scaladoc tool provides a low entry point for new committers, so it is a good first step into contributing. - -On the Scala bug tracker you will find many bugs that are [marked as good starting points to contributing ("community" bugs)](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12111) or [that are not currently assigned](https://issues.scala-lang.org/secure/IssueNavigator.jspa?requestId=12112) and that you could pick up. Once you decided on a ticket to look at, see the next step on how to proceed further. - -If you are interested in contributing code, we ask you to sign the -[Scala Contributor License Agreement](http://typesafe.com/contribute/cla/scala), -which allows us to ensure that all code submitted to the project is -unencumbered by copyrights or patents. - -
    - -### I have this idea that I'd like to add to Scala, how do I start? - -The first step to making a change is to discuss it with the community at large, to make sure everyone agrees on the idea -and on the implementation plan. Starting point ("community") bugs are usually uncontroversial, so you can jump right -ahead to hacking the scala source tree and filing a pull request. For larger changes it is best to announce the change -on the [scala-internals](http://groups.google.com/group/scala-internals) mailing list and get developer feedback. For really complex changes, a [Scala Improvement Process (SIP)](http://docs.scala-lang.org/sips/) document might be required, but the first step is always to discuss it on the mailing list. - -Contributions, big or small, simple or complex, controversial or undisputed, need to materialize as patches against -the Scala project source tree. The [hacker guide](hacker-guide.html) will explain how to materialize your idea into a full-fledged pull request against the Scala code base. - - +More info in our [contributing guide](./guide.html). From 22dc8088db52f999a4290dc3455e1231557b1aae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Wed, 17 Jul 2013 17:31:21 +0200 Subject: [PATCH 0032/3075] A bit of rewording on the contribute page. --- contribute/index.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/contribute/index.md b/contribute/index.md index c7b822ae04..3cd58f8631 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -10,10 +10,16 @@ title: Contribute See our [bug reporting guide](./bug-reporting-guide.html) to learn how to efficiently report a bug. -### Patch the core +### Help with the documentation + +An easy but very important way to contribute to Scala is to +[help with the documentation](http://docs.scala-lang.org/contribute.html). + +### Compiler and other tools Want to dive into the hardcore business? Check out our [selection of community tickets](./community-tickets.html), -which are good starting points to contributing. +which are good starting points to contributing to the compiler and +surrounding tools, like ScalaDoc. More info in our [contributing guide](./guide.html). From 684bb8b49fdd1baf968b04b74395adccd1e8962a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 18 Jul 2013 11:03:40 +0200 Subject: [PATCH 0033/3075] Dropped 3 boxes on the Contribute guide. * SIP * Unassigned tickets * Partest The two first are not supposed to be entry points, and they still have a link further down in the text. Partest is mentioned in the Hacker's guide. And there is no point in using partest without first going through the hacker's guide. --- contribute/guide.md | 19 ++----------------- 1 file changed, 2 insertions(+), 17 deletions(-) diff --git a/contribute/guide.md b/contribute/guide.md index 28adc54e6b..4841496253 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -27,32 +27,17 @@ everyone make things better?
    -

    Write a SIP

    -

    Write a proposal for extending/improving Scala.

    +

    Community issues

    +

    Get cracking on some easy to approach issues.

    Hacker's guide

    Learn to write good code and improve your chances of contributing to the Scala galaxy.

    -
    -

    Community issues

    -

    Get cracking on some easy to approach issues.

    -
    -
    - -
    -
    -

    Unassigned issues

    -

    Get serious with some more complex issues.

    -

    Hall of Fame

    Track your rockstar status in the community.

    -
    -

    Test your contributions

    -

    Learn how to run the Scala test suite.

    -
    From 13462b997cddbc48e8392f6324fafb2a30b678b3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 18 Jul 2013 11:10:07 +0200 Subject: [PATCH 0034/3075] Moved the contribute intro text to contribute/. Before it was in contribute/guide.html, but now contribute/ is the landing page for contributions. --- contribute/guide.md | 6 ------ contribute/index.md | 6 ++++++ 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/contribute/guide.md b/contribute/guide.md index 4841496253..ac27e53719 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -3,12 +3,6 @@ layout: page-full-width title: Contributing guide --- -The Scala programming language is an open source project with a very -diverse community, where people from all over the world contribute their work, -with everyone benefitting from friendly help and advice, and -kindly helping others in return. So why not join the Scala community and help -everyone make things better? -
    diff --git a/contribute/index.md b/contribute/index.md index 3cd58f8631..d2402cf4d2 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -3,6 +3,12 @@ layout: page title: Contribute --- +The Scala programming language is an open source project with a very +diverse community, where people from all over the world contribute their work, +with everyone benefitting from friendly help and advice, and +kindly helping others in return. So why not join the Scala community and help +everyone make things better? + ## How to help? ### Reporting bugs From 966a0f22e50d6cf9a2e2f0ac4cf042d369d69490 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Tue, 30 Jul 2013 10:01:55 -0700 Subject: [PATCH 0035/3075] Removing double title on the hall of fame --- contribute/scala-fame.md | 1 - 1 file changed, 1 deletion(-) diff --git a/contribute/scala-fame.md b/contribute/scala-fame.md index 084c120e27..81bb76ee3a 100644 --- a/contribute/scala-fame.md +++ b/contribute/scala-fame.md @@ -2,7 +2,6 @@ layout: page-full-width title: Scala Contribuitor Hall of Fame --- -# Scala Hall of Fame A big thank you to everyone who contributed to: - [the Scala library and compiler](https://github.com/scala/scala/contributors) From 688d5568e0a74ea8a7b83f3d56f08378fc1eb516 Mon Sep 17 00:00:00 2001 From: Simon Ochsenreither Date: Wed, 31 Jul 2013 01:34:52 +0200 Subject: [PATCH 0036/3075] =?UTF-8?q?Add=20section=20=E2=80=9CTest?= =?UTF-8?q?=E2=80=9D=20and=20=E2=80=9CMerge=E2=80=9D,=20rename=20=E2=80=9C?= =?UTF-8?q?Discuss=E2=80=9D=20to=20=E2=80=9CReview=E2=80=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- contribute/hacker-guide.md | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index d3ee84456f..c471baceca 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -221,8 +221,8 @@ Tools like Scaladoc also welcome contributions. Unfortunately these smaller proj ### Interlude -To fix [the bug we're interested in](https://issues.scala-lang.org/browse/SI-6725). Let's say we've tracked the `StringContext.f` interpolator -down to a macro implemented in `MacroImplementations.scala`, and there we notice that the interpolator only processes conversions, +To fix [the bug we're interested in](https://issues.scala-lang.org/browse/SI-6725) we've tracked the `StringContext.f` interpolator +down to a macro implemented in `MacroImplementations.scala` There we notice that the interpolator only processes conversions, but not tokens like `%n`. Looks like an easy fix. 18:44 ~/Projects/scala/sandbox (ticket/6725)$ git diff @@ -265,6 +265,17 @@ After applying the fix and running `ant`, our simple test case in `sandbox/Test. 1 1 // no longer getting the %n here - it got transformed into a newline +### Test + +To guard your change against accidental breakage in the future, it is important to add tests. +I have already written one test earlier, so that's a good start but not enough! Apart from obvious usages of our new functionality, we need to cover corner-cases as well. + +Adding tests to the test suite is as easy as moving them to the appropriate directory: + +* Code which should compile successfully, but doesn't need to be executed, needs to go into the [“pos” directory](https://github.com/scala/scala/tree/master/test/files/pos) +* Code which should not compile needs to go into the [“neg” directory](https://github.com/scala/scala/tree/master/test/files/neg) +* Code which should compile and get executed by the test suite needs to go into the [“run” directory](https://github.com/scala/scala/tree/master/test/files/run) + ### Verify Now to make sure that my fix doesn't break anything I need to run the test suite using the `partest` tool we wrote to test Scala. @@ -326,10 +337,15 @@ need to sign the contributor license agreement, which [can be done online](http:
    Submit a pull request
    -### Discuss +### Review After the pull request has been submitted, you need to pick a reviewer (usually the person you've contacted in the beginning of your workflow) and be ready to elaborate and adjust your patch if necessary. In this example, we picked Martin, because we had such a nice chat on the mailing list:
    SAssign the reviewer
    +## Merge + +After your reviewer is happy with your code (usually signalled by a LGTM — “Looks good to me”), your job is done. +Note that there can be a gap between a successful review and the merge, because not every reviewer has merge rights. In that case, someone else from the team will pick up your pull request and merge it. +So don't be confused if your reviewer says “LGTM”, but your code doesn't get merged immediately. From 29705fcb98500b5c2c586cbf8f06c411a1b1d53e Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 31 Jul 2013 08:10:21 -0400 Subject: [PATCH 0037/3075] minor copyediting to hacker guide --- contribute/hacker-guide.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index c471baceca..28ea69bc3f 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -26,11 +26,11 @@ Sometimes it's appealing to hack alone and not to have to interact with others o this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. -Typically bug fixes new features start out as an idea or an experiment posted on one of our mailing lists [our mailing lists]({{ site.baseurl }}/community/index.html#mailing_lists) to find out how people feel -about things you want to implement. People proficient is certain areas of Scala usually monitor mailing lists, so you'll often get some help +Typically bug fixes and new features start out as an idea or an experiment posted on one of our mailing lists [our mailing lists]({{ site.baseurl }}/community/index.html#mailing_lists) to find out how people feel +about things you want to implement. People proficient in certain areas of Scala usually monitor mailing lists, so you'll often get some help by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. -This is the list of language features/libraries along with their maintainers's full names and github usernames: +This is the list of language features/libraries along with their maintainers's full names and GitHub usernames: {% include maintainers.html %} @@ -65,7 +65,7 @@ If you're new to Git, don't be afraid of messing up-- there is no way you can co If everything went okay, you will be redirected to your own fork at `https://github.com/username/scala`, where `username` is your github user name. You might find it helpful to read [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/), -which covers some of the things that will follow below. Then, _clone_ your repository (_i.e._ pull a copy from github to your local machine) by running the following on the command line: +which covers some of the things that will follow below. Then, _clone_ your repository (_i.e._ pull a copy from GitHub to your local machine) by running the following on the command line: 16:35 ~/Projects$ git clone https://github.com/xeno-by/scala Cloning into 'scala'... @@ -76,7 +76,7 @@ which covers some of the things that will follow below. Then, _clone_ your repos Resolving deltas: 100% (182155/182155), done. This will create a local directory called `scala`, which contains a clone of your own copy of our repository. The changes that you make -in this directory can be propagated back to your copy hosted on github and, ultimately, pushed into Scala when your patch is ready. +in this directory can be propagated back to your copy hosted on GitHub and, ultimately, pushed into Scala when your patch is ready. ### Branch @@ -299,10 +299,10 @@ After development is finished, it's time to publish the code and submit your pat In a nutshell, this involves: 1. making sure that your code and commit messages are of high quality, -2. clicking a few buttons in the Github interface, -3. assigning one or more reviewers which will look through your pull request. +2. clicking a few buttons in the GitHub interface, +3. assigning one or more reviewers who will look through your pull request. - Let's go into each of these points in more detail. +Let's go into each of these points in more detail. ### Commit @@ -312,7 +312,7 @@ There are two things you should know here: 1. Commit messages are often the only way to understand the intentions of authors of code written a few years ago. Thus, writing a quality is of utmost importance. The more context you provide for the change you've introduced, the larger the chance that some future maintainer understand your intentions. Consult [the pull request policy](https://github.com/scala/scala/wiki/Pull-Request-Policy) for more information about the desired style of your commits. 2. Keeping Scala's git history clean is also important. Therefore we won't accept pull requests for bug fixes that have more than one commit. For features, it is okay to have several commits, but all tests need to pass after every single commit. To clean up your commit structure, you want to [rewrite history](http://git-scm.com/book/en/Git-Branching-Rebasing) using `git rebase` so that your commits are against the latest revision of `master`. -Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on Github. +Once you are satisfied with your work, synced with `master` and cleaned up your commits you are ready to submit a patch to the central Scala repository. Before proceeding make sure you have pushed all of your local changes to your fork on GitHub. 19:22 ~/Projects/scala/test (ticket/6725)$ git add ../src/compiler/scala/tools/reflect/MacroImplementations.scala 19:22 ~/Projects/scala/test (ticket/6725)$ git commit @@ -331,7 +331,7 @@ Once you are satisfied with your work, synced with `master` and cleaned up your ### Submit -Now, we must simply submit our proposed patch. Navigate to your branch in Github (for me it was `https://github.com/xeno-by/scala/tree/ticket/6725`) +Now, we must simply submit our proposed patch. Navigate to your branch in GitHub (for me it was `https://github.com/xeno-by/scala/tree/ticket/6725`) and click the pull request button to submit your patch as a pull request to Scala. If you've never submitted patches to Scala, you will need to sign the contributor license agreement, which [can be done online](http://typesafe.com/contribute/cla/scala) within a few minutes. From 50d50417d01e7eb834088ce5a3bf924b862eb26f Mon Sep 17 00:00:00 2001 From: Antoine Gourlay Date: Wed, 31 Jul 2013 23:46:24 +0200 Subject: [PATCH 0038/3075] fix links in hacker guide and various typos. --- contribute/bug-reporting-guide.md | 4 ++-- contribute/hacker-guide.md | 14 +++++++------- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index f04503f968..4160dcf438 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -45,7 +45,7 @@ If you have a code snippet that is resulting in bytecode which you believe is be * Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/docu/files/ScalaReference.pdf). If in doubt, you may always ask on the [scala-internals mailing list](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) or [stackoveflow](http://stackoverflow.com/questions/tagged/scala). -In general, if you find yourself stuck on any of these steps, asking on one of following Scala mailing lists can be helpful: +In general, if you find yourself stuck on any of these steps, asking on one of the following Scala mailing lists can be helpful: - For unexpected behavior use [scala-language](https://groups.google.com/forum/?fromgroups#!forum/scala-language), or [scala-user](https://groups.google.com/forum/?fromgroups#!forum/scala-user) mailing lists. - For compiler bugs use the [scala-internals](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) mailing list. @@ -84,4 +84,4 @@ In the description of your issue, be as detailed as you can. Bug reports which h 2. The expected output. 3. The actual output, including the stacktrace. 4. Related discussion on the mailing lists, if applicable. - 4. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. \ No newline at end of file + 4. If you have already looked into the issue provide interesting insights or proposals for fixing the issue. diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 28ea69bc3f..69ed05d25e 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -37,7 +37,7 @@ This is the list of language features/libraries along with their maintainers's f Since Martin is the person who submitted the string interpolation Scala Improvement Proposal and implemented this language feature for Scala 2.10.0, he might be interested in learning of new bugfixes to that feature. As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the scala-internals mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, -in this example, we post to the [the scala-user mailing list](http://groups.google.com/group/scala-user)about our issue. +in this example, we post to the [the scala-user mailing list](http://groups.google.com/group/scala-user) about our issue.
    Posting to scala-user

    @@ -143,7 +143,7 @@ Both Eclipse and IntelliJ IDEA have Scala plugins, which are known to work with [instructions for Intellij](https://github.com/scala/scala/blob/master/src/intellij/README). Both of those Scala plugins provide navigation, refactoring and error reporting functionality as well as integrated debugging. -There also exist lighter-weight editors such as Emacs, Sublime or jEdit which provide unparalleled are faster and much less memory/compute-intensive to run, while +There also exist lighter-weight editors such as Emacs, Sublime or jEdit which are faster and much less memory/compute-intensive to run, while lacking semantic services and debugging. To address this shortcoming, they can integrate with ENSIME, a helper program, which hosts a resident Scala compiler providing some of the features implemented in traditional IDEs. However despite having significantly matured over the last year, support for our particular code base is still being improved, and is not as mature as for Eclipse and IntelliJ. @@ -194,11 +194,11 @@ There are several areas that one could contribute to-- there is the Scala librar ##### The Scala Library -Contributing to the Scala standard library is about the same as working on one of your own libraries. Beyond the Scala collections hierarchy, there are no complex internals or architectures to have to worry about. Just make sure that you code in a "don't-repeat-yourself" (DRY) style, obeying the "boy scout principle" (i.e. make sure you've left something cleaner than you found it.) +Contributing to the Scala standard library is about the same as working on one of your own libraries. Beyond the Scala collections hierarchy, there are no complex internals or architectures to have to worry about. Just make sure that you code in a "don't-repeat-yourself" (DRY) style, obeying the "boy scout principle" (i.e. make sure you've left something cleaner than you found it). If documentation is necessary for some trait/class/object/method/etc in the Scala standard library, typically maintainers will include inline comments describing their design decisions or rationale for implementing things the way they have, if it is not straightforward. -If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections](http://docs.scala-lang.org/overviews/core/architecture-of-scala-collections.html), as well as a larger more general [Scala collections Guide](http://docs.scala-lang.org/overviews/core/collections.html) covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide](http://docs.scala-lang.org/overviews/core/parallel-collections.html). (TODO double check these links!) +If you intend on contributing to Scala collections, please make sure you're familiar with the design of the Scala collections library. It can be easy to put an implementation in the wrong location if you are unfamiliar with the collections architecture. There is an excellent and very detailed guide covering [the Architecture of Scala Collections](http://docs.scala-lang.org/overviews/core/architecture-of-scala-collections.html), as well as a larger more general [Scala collections Guide](http://docs.scala-lang.org/overviews/collections/introduction.html) covering the sequential portion of collections. For parallel collections, there also exists a detailed [Scala Parallel Collections Guide](http://docs.scala-lang.org/overviews/parallel-collections/overview.html). ##### The Scala Compiler @@ -272,9 +272,9 @@ I have already written one test earlier, so that's a good start but not enough! Adding tests to the test suite is as easy as moving them to the appropriate directory: -* Code which should compile successfully, but doesn't need to be executed, needs to go into the [“pos” directory](https://github.com/scala/scala/tree/master/test/files/pos) -* Code which should not compile needs to go into the [“neg” directory](https://github.com/scala/scala/tree/master/test/files/neg) -* Code which should compile and get executed by the test suite needs to go into the [“run” directory](https://github.com/scala/scala/tree/master/test/files/run) +* Code which should compile successfully, but doesn't need to be executed, needs to go into the [“pos” directory](https://github.com/scala/scala/tree/master/test/files/pos). +* Code which should not compile needs to go into the [“neg” directory](https://github.com/scala/scala/tree/master/test/files/neg). +* Code which should compile and get executed by the test suite needs to go into the [“run” directory](https://github.com/scala/scala/tree/master/test/files/run). ### Verify From ac890ec4475ccac7b4cde69954e0325d770429f5 Mon Sep 17 00:00:00 2001 From: Ricky Elrod Date: Wed, 31 Jul 2013 21:44:19 -0400 Subject: [PATCH 0039/3075] Make hacker-guide valid. --- contribute/hacker-guide.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 69ed05d25e..5e22223278 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -39,9 +39,8 @@ Since Martin is the person who submitted the string interpolation Scala Improvem As alluded to earlier, one must also choose an appropriate mailing list. Typically, one would use the scala-internals mailing list, as it is devoted to discussions about the core internal design and implementation of the Scala system. However, since this issue has been discussed previously on the scala-user mailing list, in this example, we post to the [the scala-user mailing list](http://groups.google.com/group/scala-user) about our issue. -
    Posting to scala-user
    -
    -
    Response from Martin
    +Posting to scala-user +Response from Martin Now that we have the approval of the feature's author, we can get to work! @@ -59,7 +58,7 @@ button in the top right corner of the page. This will create your own copy of ou If you're new to Git, don't be afraid of messing up-- there is no way you can corrupt our repository. -
    Fork scala/scala
    +Fork scala/scala ### Clone @@ -335,14 +334,14 @@ Now, we must simply submit our proposed patch. Navigate to your branch in GitHub and click the pull request button to submit your patch as a pull request to Scala. If you've never submitted patches to Scala, you will need to sign the contributor license agreement, which [can be done online](http://typesafe.com/contribute/cla/scala) within a few minutes. -
    Submit a pull request
    +Submit a pull request ### Review After the pull request has been submitted, you need to pick a reviewer (usually the person you've contacted in the beginning of your workflow) and be ready to elaborate and adjust your patch if necessary. In this example, we picked Martin, because we had such a nice chat on the mailing list: -
    SAssign the reviewer
    +SAssign the reviewer ## Merge From 38ef7cf6c68443939d834c4f5fe28bed129eb7e8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Mon, 30 Sep 2013 14:30:04 +0200 Subject: [PATCH 0040/3075] Add hall of fame for July and August 2013. --- .../_posts/2013-08-01-scala-fame-2013-07.md | 119 ++++++++++++++++++ .../_posts/2013-09-01-scala-fame-2013-08.md | 98 +++++++++++++++ 2 files changed, 217 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2013-08-01-scala-fame-2013-07.md create mode 100644 contribute/scala-fame-data/_posts/2013-09-01-scala-fame-2013-08.md diff --git a/contribute/scala-fame-data/_posts/2013-08-01-scala-fame-2013-07.md b/contribute/scala-fame-data/_posts/2013-08-01-scala-fame-2013-07.md new file mode 100644 index 0000000000..b6670c42ce --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-08-01-scala-fame-2013-07.md @@ -0,0 +1,119 @@ +--- +layout: famearchive +title: Contributors of July 2013 +fame-year: 2013 +fame-month: 7 +fame-month-str: July +fame-categories: + - category: Typesafe + authors: + - username: gkossakowski + gravatar: https://0.gravatar.com/avatar/e608c8cb27858cc5aaf7d0c1e57958d7?d=https%3A%2F%2Fidenticons.github.com%2F8196e8d0f9ee7dfdfc7e11dbbfa30d77.png&s=60 + commits: 11 + linesAdded: 522 + linesDeleted: 311 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://0.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?d=https%3A%2F%2Fidenticons.github.com%2Ff0d91e20ef53ace520f6ccbf8402319f.png&s=60 + commits: 9 + linesAdded: 1068 + linesDeleted: 11436 + rank: 2 + newContributor: false + - username: retronym + gravatar: https://0.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?d=https%3A%2F%2Fidenticons.github.com%2F75e4dffe50001cf8b96d3beecbe181be.png&s=60 + commits: 8 + linesAdded: 416 + linesDeleted: 134 + rank: 3 + newContributor: false + - username: paulp + gravatar: https://identicons.github.com/bf65417dcecc7f2b0006e1f5793b7143.png + commits: 2 + linesAdded: 46 + linesDeleted: 27 + rank: 4 + newContributor: false + - category: EPFL + authors: + - username: magarciaEPFL + gravatar: https://2.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?d=https%3A%2F%2Fidenticons.github.com%2F8b7440eff98d923640c99b5535429144.png&s=60 + commits: 12 + linesAdded: 1208 + linesDeleted: 1069 + rank: 1 + newContributor: false + - username: xeno-by + gravatar: https://2.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?d=https%3A%2F%2Fidenticons.github.com%2F6a5b1b05e953818962474e94b67d1cc2.png&s=60 + commits: 8 + linesAdded: 321 + linesDeleted: 95 + rank: 2 + newContributor: false + - username: VladUreche + gravatar: https://2.gravatar.com/avatar/5658ed1cea041577df360fd663c570fa?d=https%3A%2F%2Fidenticons.github.com%2Fa1ef2fed16f85a1af890467a80c30226.png&s=60 + commits: 2 + linesAdded: 104 + linesDeleted: 2 + rank: 3 + newContributor: false + - username: cvogt + gravatar: https://1.gravatar.com/avatar/669fb4eab529fba02f390051ddf3c8d3?d=https%3A%2F%2Fidenticons.github.com%2F78d9e7d7c73ac19ca8da9805762e5bb0.png&s=60 + commits: 1 + linesAdded: 19 + linesDeleted: 0 + rank: 4 + newContributor: false + - category: Community + authors: + - username: soc + gravatar: https://0.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?d=https%3A%2F%2Fidenticons.github.com%2F29f7ac3adbe1d3500c9404388aedcbfd.png&s=60 + commits: 19 + linesAdded: 2818 + linesDeleted: 4377 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://2.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?d=https%3A%2F%2Fidenticons.github.com%2Fd292a902ebb73981efd65c9ef416046b.png&s=60 + commits: 16 + linesAdded: 1049 + linesDeleted: 553 + rank: 2 + newContributor: false + - username: densh + gravatar: https://0.gravatar.com/avatar/5ed274e115ec061d062d9c32a539cdc9?d=https%3A%2F%2Fidenticons.github.com%2Fcd3e73ab183ea35424f0bf59101a74e4.png&s=60 + commits: 9 + linesAdded: 2632 + linesDeleted: 178 + rank: 3 + newContributor: false + - username: folone + gravatar: https://2.gravatar.com/avatar/50e7e3f60b3507383d2b327857b66a62?d=https%3A%2F%2Fidenticons.github.com%2F6c2bcbccd23191b40f4932e2b8450681.png&s=60 + commits: 3 + linesAdded: 106 + linesDeleted: 261 + rank: 4 + newContributor: false + - username: xuwei-k + gravatar: https://2.gravatar.com/avatar/18d8b1bf73827b2a15e2bd3e75b4b34a?d=https%3A%2F%2Fidenticons.github.com%2Fdab0069935d770e6285411ed1f4398b9.png&s=60 + commits: 3 + linesAdded: 5 + linesDeleted: 5 + rank: 4 + newContributor: false + - username: gourlaysama + gravatar: https://2.gravatar.com/avatar/8acf3c87222f89b18786c8db60eb365d?d=https%3A%2F%2Fidenticons.github.com%2F76004d7b1fac3a2b262caa5e6bdf15c9.png&s=60 + commits: 2 + linesAdded: 67 + linesDeleted: 3 + rank: 5 + newContributor: false + - username: ScrapCodes + gravatar: https://0.gravatar.com/avatar/e9813bbbab2caa993bf7e2b2d60de894?d=https%3A%2F%2Fidenticons.github.com%2F38c660c74f82a216b75167debab770ed.png&s=60 + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 6 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2013-09-01-scala-fame-2013-08.md b/contribute/scala-fame-data/_posts/2013-09-01-scala-fame-2013-08.md new file mode 100644 index 0000000000..c876e815d1 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-09-01-scala-fame-2013-08.md @@ -0,0 +1,98 @@ +--- +layout: famearchive +title: Contributors of August 2013 +fame-year: 2013 +fame-month: 8 +fame-month-str: August +fame-categories: + - category: Typesafe + authors: + - username: paulp + gravatar: https://identicons.github.com/bf65417dcecc7f2b0006e1f5793b7143.png + commits: 50 + linesAdded: 3703 + linesDeleted: 2269 + rank: 1 + newContributor: false + - username: retronym + gravatar: https://0.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?d=https%3A%2F%2Fidenticons.github.com%2F75e4dffe50001cf8b96d3beecbe181be.png&s=60 + commits: 30 + linesAdded: 990 + linesDeleted: 167 + rank: 2 + newContributor: false + - username: adriaanm + gravatar: https://0.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?d=https%3A%2F%2Fidenticons.github.com%2Ff0d91e20ef53ace520f6ccbf8402319f.png&s=60 + commits: 6 + linesAdded: 224 + linesDeleted: 11001 + rank: 3 + newContributor: false + - username: huitseeker + gravatar: https://0.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?d=https%3A%2F%2Fidenticons.github.com%2F0777acff7c9ab34562699e4e1d05affb.png&s=60 + commits: 2 + linesAdded: 6 + linesDeleted: 6 + rank: 4 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://2.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?d=https%3A%2F%2Fidenticons.github.com%2F6a5b1b05e953818962474e94b67d1cc2.png&s=60 + commits: 9 + linesAdded: 579 + linesDeleted: 419 + rank: 1 + newContributor: false + - username: magarciaEPFL + gravatar: https://2.gravatar.com/avatar/94ff1d59d6e0a3a4ab10c80ab12bfeed?d=https%3A%2F%2Fidenticons.github.com%2F8b7440eff98d923640c99b5535429144.png&s=60 + commits: 4 + linesAdded: 319 + linesDeleted: 105 + rank: 2 + newContributor: false + - category: Community + authors: + - username: densh + gravatar: https://0.gravatar.com/avatar/5ed274e115ec061d062d9c32a539cdc9?d=https%3A%2F%2Fidenticons.github.com%2Fcd3e73ab183ea35424f0bf59101a74e4.png&s=60 + commits: 19 + linesAdded: 687 + linesDeleted: 322 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://2.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?d=https%3A%2F%2Fidenticons.github.com%2Fd292a902ebb73981efd65c9ef416046b.png&s=60 + commits: 12 + linesAdded: 455 + linesDeleted: 91 + rank: 2 + newContributor: false + - username: soc + gravatar: https://0.gravatar.com/avatar/6e4171314f4704b1e82aa4e5d9067e92?d=https%3A%2F%2Fidenticons.github.com%2F29f7ac3adbe1d3500c9404388aedcbfd.png&s=60 + commits: 4 + linesAdded: 64 + linesDeleted: 27 + rank: 3 + newContributor: false + - username: gourlaysama + gravatar: https://2.gravatar.com/avatar/8acf3c87222f89b18786c8db60eb365d?d=https%3A%2F%2Fidenticons.github.com%2F76004d7b1fac3a2b262caa5e6bdf15c9.png&s=60 + commits: 2 + linesAdded: 50 + linesDeleted: 9 + rank: 4 + newContributor: false + - username: ScrapCodes + gravatar: https://0.gravatar.com/avatar/e9813bbbab2caa993bf7e2b2d60de894?d=https%3A%2F%2Fidenticons.github.com%2F38c660c74f82a216b75167debab770ed.png&s=60 + commits: 1 + linesAdded: 3 + linesDeleted: 0 + rank: 5 + newContributor: false + - username: folone + gravatar: https://2.gravatar.com/avatar/50e7e3f60b3507383d2b327857b66a62?d=https%3A%2F%2Fidenticons.github.com%2F6c2bcbccd23191b40f4932e2b8450681.png&s=60 + commits: 1 + linesAdded: 55 + linesDeleted: 7 + rank: 5 + newContributor: false +--- From 1fad03554f97da791f28a74746dbb158f9109c02 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Thu, 10 Oct 2013 11:17:43 +0200 Subject: [PATCH 0041/3075] Add hall of fame for 2013-09. --- .../_posts/2013-10-01-scala-fame-2013-09.md | 105 ++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2013-10-01-scala-fame-2013-09.md diff --git a/contribute/scala-fame-data/_posts/2013-10-01-scala-fame-2013-09.md b/contribute/scala-fame-data/_posts/2013-10-01-scala-fame-2013-09.md new file mode 100644 index 0000000000..23fa456fc0 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-10-01-scala-fame-2013-09.md @@ -0,0 +1,105 @@ +--- +layout: famearchive +title: Contributors of September 2013 +fame-year: 2013 +fame-month: 9 +fame-month-str: September +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://2.gravatar.com/avatar/5df8faf17a57ccab478a9b8056862fc3?d=https%3A%2F%2Fidenticons.github.com%2F75e4dffe50001cf8b96d3beecbe181be.png&s=60 + commits: 42 + linesAdded: 1459 + linesDeleted: 476 + rank: 1 + newContributor: false + - username: paulp + gravatar: https://identicons.github.com/bf65417dcecc7f2b0006e1f5793b7143.png + commits: 25 + linesAdded: 6603 + linesDeleted: 7419 + rank: 2 + newContributor: false + - username: huitseeker + gravatar: https://1.gravatar.com/avatar/dc11aab8ab70b10a828b5ee4735183e8?d=https%3A%2F%2Fidenticons.github.com%2F0777acff7c9ab34562699e4e1d05affb.png&s=60 + commits: 7 + linesAdded: 520 + linesDeleted: 536 + rank: 3 + newContributor: false + - username: gkossakowski + gravatar: https://0.gravatar.com/avatar/e608c8cb27858cc5aaf7d0c1e57958d7?d=https%3A%2F%2Fidenticons.github.com%2F8196e8d0f9ee7dfdfc7e11dbbfa30d77.png&s=60 + commits: 2 + linesAdded: 1443 + linesDeleted: 44 + rank: 4 + newContributor: false + - username: dragos + gravatar: https://2.gravatar.com/avatar/fbd384e9626d28d1648f023a5e22672f?d=https%3A%2F%2Fidenticons.github.com%2F6b660454242c937e501b88fd136132f8.png&s=60 + commits: 2 + linesAdded: 95 + linesDeleted: 13 + rank: 4 + newContributor: false + - username: jsuereth + gravatar: https://1.gravatar.com/avatar/5ed293320c06809a24812f56861201ad?d=https%3A%2F%2Fidenticons.github.com%2F11a5b5ef81cff76a0a1f3d042f635df3.png&s=60 + commits: 1 + linesAdded: 18 + linesDeleted: 37 + rank: 5 + newContributor: false + - username: adriaanm + gravatar: https://0.gravatar.com/avatar/d573d4b8a6bd9e2f41611d8d566c533e?d=https%3A%2F%2Fidenticons.github.com%2Ff0d91e20ef53ace520f6ccbf8402319f.png&s=60 + commits: 1 + linesAdded: 5 + linesDeleted: 5 + rank: 5 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://1.gravatar.com/avatar/69e339fd10a5ad804c45e22c819c67ad?d=https%3A%2F%2Fidenticons.github.com%2F6a5b1b05e953818962474e94b67d1cc2.png&s=60 + commits: 5 + linesAdded: 434 + linesDeleted: 153 + rank: 1 + newContributor: false + - username: sjrd + gravatar: https://1.gravatar.com/avatar/bc554c7355c8476dd63375b314b1bd97?d=https%3A%2F%2Fidenticons.github.com%2F7f7549008d59643d2ce9846ce0364947.png&s=60 + commits: 4 + linesAdded: 30 + linesDeleted: 9 + rank: 2 + newContributor: true + - category: Community + authors: + - username: densh + gravatar: https://1.gravatar.com/avatar/5ed274e115ec061d062d9c32a539cdc9?d=https%3A%2F%2Fidenticons.github.com%2Fcd3e73ab183ea35424f0bf59101a74e4.png&s=60 + commits: 20 + linesAdded: 1415 + linesDeleted: 594 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://1.gravatar.com/avatar/ec5b08d0fe94845ba49fd4a263c7d99d?d=https%3A%2F%2Fidenticons.github.com%2Fd292a902ebb73981efd65c9ef416046b.png&s=60 + commits: 11 + linesAdded: 367 + linesDeleted: 106 + rank: 2 + newContributor: false + - username: Ichoran + gravatar: https://0.gravatar.com/avatar/3698349ad0b898d398a6573f4d1f867a?d=https%3A%2F%2Fidenticons.github.com%2Ffc12483537f3df99d480423de674e099.png&s=60 + commits: 3 + linesAdded: 75 + linesDeleted: 27 + rank: 3 + newContributor: true + - username: sschaef + gravatar: https://0.gravatar.com/avatar/dd80aab570fdb5f37e62de5422f44ed4?d=https%3A%2F%2Fidenticons.github.com%2Fb5a662bc30d97b377338f5dfb2b4cc66.png&s=60 + commits: 3 + linesAdded: 84 + linesDeleted: 139 + rank: 3 + newContributor: false +--- From 9b709e0b67f7e3b7594734b019f262fd1dcf6e15 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20van=20Delft?= Date: Mon, 6 Jan 2014 14:49:42 +0100 Subject: [PATCH 0042/3075] Update hacker-guide.md Added two more Git learning resources --- contribute/hacker-guide.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 5e22223278..46d252984e 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -48,8 +48,11 @@ Now that we have the approval of the feature's author, we can get to work! Hacking Scala begins with creating a branch for your work item. To develop Scala we use [Git](http://git-scm.com/) and [GitHub](http://github.com/). This section of the guide provides a short walkthrough, but if you are new to Git, -it probably makes sense to familiarize yourself with Git first. We recommend the [Git Pro](http://git-scm.com/book/en/) -online book. +it probably makes sense to familiarize yourself with Git first. We recommend + +* the [Git Pro](http://git-scm.com/book/en/) online book. +* the help page on [Forking a Git Repository](https://help.github.com/articles/fork-a-repo). +* this great training tool [LearnGitBranching](http://pcottle.github.io/learnGitBranching/). One hour hands-on training helps more than 1000 hours reading. ### Fork From 6f80442e6ac4050d70ab6b06ed5d59ee8187637f Mon Sep 17 00:00:00 2001 From: George Leontiev Date: Wed, 25 Jun 2014 17:43:17 +0200 Subject: [PATCH 0043/3075] Update hacker guide: add more info, fix broken links. --- contribute/hacker-guide.md | 99 ++++++++++++++++++++++++++++++++------ 1 file changed, 83 insertions(+), 16 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 46d252984e..895d925f48 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -26,7 +26,7 @@ Sometimes it's appealing to hack alone and not to have to interact with others o this might not be the very best idea. There are people in the Scala community who have spent years accumulating knowledge about Scala libraries and internals. They might provide unique insights and, what's even better, direct assistance in their areas, so it is not only advantageous, but recommended to communicate with the community about your new patch. -Typically bug fixes and new features start out as an idea or an experiment posted on one of our mailing lists [our mailing lists]({{ site.baseurl }}/community/index.html#mailing_lists) to find out how people feel +Typically bug fixes and new features start out as an idea or an experiment posted on one of [our mailing lists]({{ site.baseurl }}/community/index.html#mailing_lists) to find out how people feel about things you want to implement. People proficient in certain areas of Scala usually monitor mailing lists, so you'll often get some help by simply posting a message. But the most efficient way to connect is to cc your message to one of the people responsible for maintaining the aspect of Scala which you wish to contribute to. @@ -67,7 +67,7 @@ If you're new to Git, don't be afraid of messing up-- there is no way you can co If everything went okay, you will be redirected to your own fork at `https://github.com/username/scala`, where `username` is your github user name. You might find it helpful to read [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/), -which covers some of the things that will follow below. Then, _clone_ your repository (_i.e._ pull a copy from GitHub to your local machine) by running the following on the command line: +which covers some of the things that will follow below. Then, _clone_ your repository (i.e. pull a copy from GitHub to your local machine) by running the following on the command line: 16:35 ~/Projects$ git clone https://github.com/xeno-by/scala Cloning into 'scala'... @@ -86,7 +86,7 @@ Before you start making changes, always create your own branch. Never work on th the changes you plan on making. Use a prefix that describes the nature of your change. There are essentially two kinds of changes: bug fixes and new features. -* For bug fixes, use `issue/NNNN` for bug NNNN from the [Scala issue tracker](https://issues.scala-lang.org/). +* For bug fixes, use `issue/NNNN` or `ticket/NNNN` for bug NNNN from the [Scala issue tracker](https://issues.scala-lang.org/). * For new feature use `topic/XXX` for feature XXX. Use feature names that make sense in the context of the whole Scala project and not just to you personally. For example, if you work on diagrams in Scaladoc, use `topic/scaladoc-diagrams` instead of just `topic/diagrams` would be a good branch name. Since in our example, we're going to fix an existing bug [SI-6725](https://issues.scala-lang.org/browse/SI-6725), we'll create a branch named `ticket/6725`. @@ -98,8 +98,7 @@ If you are new to Git and branching, read the [Branching Chapter](http://git-scm ### Build -The next step after cloning your fork is setting up your machine to build Scala. The definitive guide on building Scala is located at -[https://github.com/scala/scala/blob/master/README.rst](https://github.com/scala/scala/blob/master/README.rst), but here's the summary: +The next step after cloning your fork is setting up your machine to build Scala. * It is recommended to use Java `1.6` (not `1.7` or `1.8`, because they might cause occasional glitches). * The build tool is `ant`. @@ -140,10 +139,8 @@ with your hardware). There's no single editor of choice for working with Scala sources, as there are trade-offs associated with each available tool. -Both Eclipse and IntelliJ IDEA have Scala plugins, which are known to work with our codebase. Here are -[instructions for Eclipse](https://github.com/scala/scala/blob/master/src/eclipse/README.md) and -[instructions for Intellij](https://github.com/scala/scala/blob/master/src/intellij/README). Both of those Scala plugins provide -navigation, refactoring and error reporting functionality as well as integrated debugging. +Both Eclipse and IntelliJ IDEA have Scala plugins, which are known to work with our codebase. +Both of those Scala plugins provide navigation, refactoring and error reporting functionality as well as integrated debugging. There also exist lighter-weight editors such as Emacs, Sublime or jEdit which are faster and much less memory/compute-intensive to run, while lacking semantic services and debugging. To address this shortcoming, they can integrate with ENSIME, @@ -185,10 +182,33 @@ Here are also some tips & tricks that have proven useful in Scala development: just that trait, but it might also be necessary to recompile its users. The `ant` tool is not smart enough to do that, which might lead to very strange errors. Full-rebuilds fix the problem. Fortunately that's rarely necessary, because full-rebuilds take a lot of time-- the same 8-30 minutes as mentioned above. * Even on solid state drives packaging Scala distribution (i.e. creating jars from class files) is a non-trivial task. To save time here, - some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts to launch Scala from `build/quick/classes`. + some people in our team do `ant quick.comp` instead of `ant` and then create custom scripts ([here](https://github.com/adriaanm/binfu/blob/master/scafu.sh) are some examples to get you strarted) to launch Scala from `build/quick/classes`. * Don't underestimate the power of `print`. When starting with Scala, I spent a lot of time in the debugger trying to figure out how things work. However later I found out that print-based debugging is often more effective than jumping around. While it might be obvious - to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. + to some, I'd like to explicitly mention that it's also useful to print stack traces to understand the flow of execution. When working with `Trees`, you might want to use `showRaw` to get the `AST` representation. +* You can publish your newly-built scala version locally to use it from sbt. Here's how: + + $ ant publish-local-opt -Dmaven.version.suffix="-test" + $ sbt + [info] Set current project to test (in build file:/Users/georgii/workspace/test/) + > set resolvers += Resolver.mavenLocal + [info] Defining *:resolvers + [info] The new value will be used by *:externalResolvers + [info] Reapplying settings... + [info] Set current project to test (in build file:/Users/georgii/workspace/test/) + > ++2.12.0-test + [info] Setting version to 2.12.0-test + [info] Set current project to test (in build file:/Users/georgii/workspace/test/) + > console + [info] Starting scala interpreter... + [info] + Welcome to Scala version 2.12.0-20140623-155543-8bdacad317 (Java HotSpot(TM) 64-Bit Server VM, Java 1.7.0_51). + Type in expressions to have them evaluated. + Type :help for more information. + + scala> + +* Adding a macro to the `Predef` is a pretty involved task. For the reason of bootstrapping, you cannot just throw a macro into it. There is a more involved process here. You might want to follow the way `StringContext.f` itself is added. In short, you need to define your macro under `src/compiler/scala/tools/reflect/` and provide no implementation in `Predef` (`def fn = macro ???`). Now you want to set up the wiring. Add the name of your macro to `src/reflect/scala/reflect/internal/StdNames.scala`, add the needed links to it to `src/reflect/scala/reflect/internal/Definitions.scala`, and finally specify the bindings in `src/compiler/scala/tools/reflect/FastTrack.scala`. If that explanation does not sound very clear, [here's](https://github.com/folone/scala/commit/59536ea833ca16c985339727baed5d70e577b0fe) an example of adding a macro. ### Documentation @@ -196,7 +216,7 @@ There are several areas that one could contribute to-- there is the Scala librar ##### The Scala Library -Contributing to the Scala standard library is about the same as working on one of your own libraries. Beyond the Scala collections hierarchy, there are no complex internals or architectures to have to worry about. Just make sure that you code in a "don't-repeat-yourself" (DRY) style, obeying the "boy scout principle" (i.e. make sure you've left something cleaner than you found it). +Contributing to the Scala standard library is about the same as working on one of your own libraries. Beyond the Scala collections hierarchy, there are no complex internals or architectures to have to worry about. Just make sure that you code in a "don't-repeat-yourself" (DRY) style, obeying the "boy scout principle" (i.e. make sure you've left the code cleaner than you found it). If documentation is necessary for some trait/class/object/method/etc in the Scala standard library, typically maintainers will include inline comments describing their design decisions or rationale for implementing things the way they have, if it is not straightforward. @@ -206,7 +226,7 @@ If you intend on contributing to Scala collections, please make sure you're fami Documentation about the internal workings of the Scala compiler is scarce, and most of the knowledge is passed around by email (scala-internals mailing list), ticket, or word of mouth. However the situation is steadily improving. Here are the resources that might help: -* [Compiler internals videos by Martin Odersky](TODO) are quite dated, but still very useful. In this three-video +* [Compiler internals videos by Martin Odersky](http://www.scala-lang.org/old/node/598.html) are quite dated, but still very useful. In this three-video series Martin explains the general architecture of the compiler, and the basics of the front-end, which has recently become Scala reflection API. * [Reflection documentation](http://docs.scala-lang.org/overviews/reflection/overview.html) describes fundamental data structures (like `Tree`s, `Symbol`s, and `Types`) that are used to represent Scala programs and operations defined on then. Since much of the compiler has been factored out and made accessible via the Reflection API, all of the fundamentals needed for reflection are the same for the compiler. @@ -274,9 +294,56 @@ I have already written one test earlier, so that's a good start but not enough! Adding tests to the test suite is as easy as moving them to the appropriate directory: -* Code which should compile successfully, but doesn't need to be executed, needs to go into the [“pos” directory](https://github.com/scala/scala/tree/master/test/files/pos). -* Code which should not compile needs to go into the [“neg” directory](https://github.com/scala/scala/tree/master/test/files/neg). -* Code which should compile and get executed by the test suite needs to go into the [“run” directory](https://github.com/scala/scala/tree/master/test/files/run). +* Code which should compile successfully, but doesn't need to be executed, needs to go into the [“pos” directory](https://github.com/scala/scala/tree/2.12.x/test/files/pos). +* Code which should not compile needs to go into the [“neg” directory](https://github.com/scala/scala/tree/2.12.x/test/files/neg). +* Code which should compile and get executed by the test suite needs to go into the [“run” directory](https://github.com/scala/scala/tree/2.12.x/test/files/run) and have a corresponding `.check` file with the expected output. You will get test failures if the content of a `.check` file is different from what the test produces while running. If the change in the output is an expected product of your work, you might not want to change the `.check` file by hand. To make partest change the `.check` file, run it with a `--update-check` flag, like so `./test/partest --update-check path/to/test.scala`. For more information on partest, please refer to its [documentation](http://docs.scala-lang.org/tutorials/partest-guide.html). +* Everything that can be unit-tested should go to ["junit" directory](https://github.com/scala/scala/tree/2.12.x/test/junit) +* Property-based tests go to the ["scalacheck" directory](https://github.com/scala/scala/tree/2.12.x/test/files/scalacheck) + +Here are some more testing tips: + +* If you have several tests, and want a tool for only running tests that conform to some regular expression, you can use `partest-ack` in the `tools` directory: `./tools/partest-ack "dottype"` +* If your tests fail with an like: + + test.bc: + [echo] Checking backward binary compatibility for scala-library (against 2.11.0) + [mima] Found 2 binary incompatibiities + [mima] ================================ + [mima] * synthetic method + [mima] scala$package$Class$method(java.lang.String)Unit in trait + [mima] scala.package.Class does not have a correspondent in old version + [mima] * synthetic method + [mima] scala$package$AnotherClass$anotherMethod(java.lang.String)Unit in trait + [mima] scala.package.AnotherClass does not have a correspondent in old version + [mima] Generated filter config definition + [mima] ================================== + [mima] + [mima] filter { + [mima] problems=[ + [mima] { + [mima] matchName="scala.package.Class$method" + [mima] problemName=MissingMethodProblem + [mima] }, + [mima] { + [mima] matchName="scala.package.AnotherClass$anotherMethod" + [mima] problemName=MissingMethodProblem + [mima] } + [mima] ] + [mima] } + [mima] + + BUILD FAILED + /localhome/jenkins/c/workspace/pr-scala-test/scala/build.xml:1530: The following error occurred while executing this line: + /localhome/jenkins/c/workspace/pr-scala-test/scala/build-ant-macros.xml:791: The following error occurred while executing this line: + /localhome/jenkins/c/workspace/pr-scala-test/scala/build-ant-macros.xml:773: Java returned: 2 + + Total time: 6 minutes 46 seconds + Build step 'Execute shell' marked build as failure + Archiving artifacts + Notifying upstream projects of job completion + Finished: FAILURE + +This means your change is backward or forward binary incompatible with the specified version (the check is performed by the [migration manager](https://github.com/typesafehub/migration-manager)). The error message is actually saying what you need to add to `bincompat-backward.whitelist.conf` or `bincompat-forward.whitelist.conf` to make the error go away. If you are getting this on an internal/experimental api, it should be safe to add suggested sections to the config. Otherwise, you might want to target a newer version of scala for this change. ### Verify From a076f43769050b80646fb196a9b109e6ed97228f Mon Sep 17 00:00:00 2001 From: George Leontiev Date: Thu, 26 Jun 2014 10:44:54 +0200 Subject: [PATCH 0044/3075] Address the feedback. --- contribute/hacker-guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute/hacker-guide.md b/contribute/hacker-guide.md index 895d925f48..08f5d40c09 100644 --- a/contribute/hacker-guide.md +++ b/contribute/hacker-guide.md @@ -208,7 +208,7 @@ Here are also some tips & tricks that have proven useful in Scala development: scala> -* Adding a macro to the `Predef` is a pretty involved task. For the reason of bootstrapping, you cannot just throw a macro into it. There is a more involved process here. You might want to follow the way `StringContext.f` itself is added. In short, you need to define your macro under `src/compiler/scala/tools/reflect/` and provide no implementation in `Predef` (`def fn = macro ???`). Now you want to set up the wiring. Add the name of your macro to `src/reflect/scala/reflect/internal/StdNames.scala`, add the needed links to it to `src/reflect/scala/reflect/internal/Definitions.scala`, and finally specify the bindings in `src/compiler/scala/tools/reflect/FastTrack.scala`. If that explanation does not sound very clear, [here's](https://github.com/folone/scala/commit/59536ea833ca16c985339727baed5d70e577b0fe) an example of adding a macro. +* Adding a macro to the `Predef` object is a pretty involved task. Due to bootstrapping, you cannot just throw a macro into it. For this reason, the process is more involved. You might want to follow the way `StringContext.f` itself is added. In short, you need to define your macro under `src/compiler/scala/tools/reflect/` and provide no implementation in `Predef` (`def fn = macro ???`). Now you have to set up the wiring. Add the name of your macro to `src/reflect/scala/reflect/internal/StdNames.scala`, add the needed links to it to `src/reflect/scala/reflect/internal/Definitions.scala`, and finally specify the bindings in `src/compiler/scala/tools/reflect/FastTrack.scala`. [Here's](https://github.com/folone/scala/commit/59536ea833ca16c985339727baed5d70e577b0fe) an example of adding a macro. ### Documentation @@ -303,7 +303,7 @@ Adding tests to the test suite is as easy as moving them to the appropriate dire Here are some more testing tips: * If you have several tests, and want a tool for only running tests that conform to some regular expression, you can use `partest-ack` in the `tools` directory: `./tools/partest-ack "dottype"` -* If your tests fail with an like: +* If your tests fail in the following way: test.bc: [echo] Checking backward binary compatibility for scala-library (against 2.11.0) From 8f63cd0ebdf244c5051357d3781d985b54d126da Mon Sep 17 00:00:00 2001 From: Adriaan Moors Date: Mon, 7 Jul 2014 20:28:10 +0200 Subject: [PATCH 0045/3075] Fix more references to spec --- contribute/bug-reporting-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/bug-reporting-guide.md b/contribute/bug-reporting-guide.md index 4160dcf438..960f40b704 100644 --- a/contribute/bug-reporting-guide.md +++ b/contribute/bug-reporting-guide.md @@ -43,7 +43,7 @@ If you have a code snippet that is resulting in bytecode which you believe is be 5. If you want to file an improvement in the issue tracker please discuss it first on one of the mailing lists. They offer much bigger audience than issue tracker. The latter is not suitable for long discussions. -* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/docu/files/ScalaReference.pdf). If in doubt, you may always ask on the [scala-internals mailing list](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) or [stackoveflow](http://stackoverflow.com/questions/tagged/scala). +* Keep in mind that the behavior you are witnessing could be intended. Good formal resources for verifying whether or not the language behavior is intended is either in the [Scala Improvement Proposal Documents](http://docs.scala-lang.org/sips/sip-list.html) or in the [Scala Language Specification](http://www.scala-lang.org/files/archive/spec/2.11/). If in doubt, you may always ask on the [scala-internals mailing list](https://groups.google.com/forum/?fromgroups#!forum/scala-internals) or [stackoveflow](http://stackoverflow.com/questions/tagged/scala). In general, if you find yourself stuck on any of these steps, asking on one of the following Scala mailing lists can be helpful: From afc73aa06baf7b9204c11edd946b02e82b74fcaa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Doeraene?= Date: Mon, 29 Sep 2014 10:30:37 +0200 Subject: [PATCH 0046/3075] Hall of fame Auguest 2014. --- .../_posts/2014-09-01-scala-fame-2014-08.md | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md diff --git a/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md b/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md new file mode 100644 index 0000000000..1393e01705 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md @@ -0,0 +1,63 @@ +--- +layout: famearchive +title: Contributors of August 2014 +fame-year: 2014 +fame-month: 8 +fame-month-str: August +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 3 + linesAdded: 57 + linesDeleted: 4 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 2 + linesAdded: 57 + linesDeleted: 42 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 21 + linesAdded: 3764 + linesDeleted: 2122 + rank: 1 + newContributor: false + - category: Community + authors: + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 10 + linesAdded: 171 + linesDeleted: 7680 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 10 + linesAdded: 917 + linesDeleted: 543 + rank: 1 + newContributor: false + - username: dgruntz + gravatar: https://avatars3.githubusercontent.com/u/1516800?v=2&s=60 + commits: 1 + linesAdded: 18 + linesDeleted: 18 + rank: 2 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 1 + linesAdded: 26 + linesDeleted: 27 + rank: 2 + newContributor: false +--- From d4630ea3257b7740c390f5d728b6d2fd012f7fc1 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Fri, 24 Oct 2014 16:36:48 +0200 Subject: [PATCH 0047/3075] Add 2014 scala-fame data --- .../_posts/2014-02-01-scala-fame-2014-01.md | 147 ++++++++++++++++++ .../_posts/2014-03-01-scala-fame-2014-02.md | 133 ++++++++++++++++ .../_posts/2014-04-01-scala-fame-2014-03.md | 112 +++++++++++++ .../_posts/2014-05-01-scala-fame-2014-04.md | 91 +++++++++++ .../_posts/2014-06-01-scala-fame-2014-05.md | 112 +++++++++++++ .../_posts/2014-07-01-scala-fame-2014-06.md | 98 ++++++++++++ .../_posts/2014-08-01-scala-fame-2014-07.md | 98 ++++++++++++ .../_posts/2014-09-01-scala-fame-2014-08.md | 7 + .../_posts/2014-10-01-scala-fame-2014-09.md | 84 ++++++++++ 9 files changed, 882 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2014-02-01-scala-fame-2014-01.md create mode 100644 contribute/scala-fame-data/_posts/2014-03-01-scala-fame-2014-02.md create mode 100644 contribute/scala-fame-data/_posts/2014-04-01-scala-fame-2014-03.md create mode 100644 contribute/scala-fame-data/_posts/2014-05-01-scala-fame-2014-04.md create mode 100644 contribute/scala-fame-data/_posts/2014-06-01-scala-fame-2014-05.md create mode 100644 contribute/scala-fame-data/_posts/2014-07-01-scala-fame-2014-06.md create mode 100644 contribute/scala-fame-data/_posts/2014-08-01-scala-fame-2014-07.md create mode 100644 contribute/scala-fame-data/_posts/2014-10-01-scala-fame-2014-09.md diff --git a/contribute/scala-fame-data/_posts/2014-02-01-scala-fame-2014-01.md b/contribute/scala-fame-data/_posts/2014-02-01-scala-fame-2014-01.md new file mode 100644 index 0000000000..ab8e808036 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-02-01-scala-fame-2014-01.md @@ -0,0 +1,147 @@ +--- +layout: famearchive +title: Contributors of January 2014 +fame-year: 2014 +fame-month: 1 +fame-month-str: January +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 37 + linesAdded: 2000 + linesDeleted: 2487 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 8 + linesAdded: 311 + linesDeleted: 175 + rank: 2 + newContributor: false + - username: gkossakowski + gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 + commits: 3 + linesAdded: 15 + linesDeleted: 5 + rank: 3 + newContributor: false + - username: huitseeker + gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 + commits: 2 + linesAdded: 81 + linesDeleted: 79 + rank: 4 + newContributor: false + - username: paulp + gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 + commits: 2 + linesAdded: 7 + linesDeleted: 5 + rank: 4 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 75 + linesAdded: 8908 + linesDeleted: 6023 + rank: 1 + newContributor: false + - category: Community + authors: + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 16 + linesAdded: 722 + linesDeleted: 295 + rank: 1 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 10 + linesAdded: 315 + linesDeleted: 103 + rank: 2 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 9 + linesAdded: 646 + linesDeleted: 201 + rank: 3 + newContributor: false + - username: VladimirNik + gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 + commits: 7 + linesAdded: 1729 + linesDeleted: 350 + rank: 4 + newContributor: false + - username: rklaehn + gravatar: https://avatars0.githubusercontent.com/u/248257?v=2&s=60 + commits: 6 + linesAdded: 1288 + linesDeleted: 39 + rank: 5 + newContributor: false + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 3 + linesAdded: 37 + linesDeleted: 7 + rank: 6 + newContributor: false + - username: cunei + gravatar: https://avatars2.githubusercontent.com/u/686260?v=2&s=60 + commits: 2 + linesAdded: 42 + linesDeleted: 12 + rank: 7 + newContributor: false + - username: Blaisorblade + gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 + commits: 2 + linesAdded: 51 + linesDeleted: 33 + rank: 7 + newContributor: false + - username: havocp + gravatar: https://avatars2.githubusercontent.com/u/218689?v=2&s=60 + commits: 1 + linesAdded: 38 + linesDeleted: 2 + rank: 8 + newContributor: false + - username: clhodapp + gravatar: https://avatars0.githubusercontent.com/u/108633?v=2&s=60 + commits: 1 + linesAdded: 22 + linesDeleted: 0 + rank: 8 + newContributor: false + - username: rjolly + gravatar: https://avatars3.githubusercontent.com/u/128610?v=2&s=60 + commits: 1 + linesAdded: 45 + linesDeleted: 38 + rank: 8 + newContributor: false + - username: xuwei-k + gravatar: https://avatars3.githubusercontent.com/u/389787?v=2&s=60 + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 8 + newContributor: false + - username: dotta + gravatar: https://avatars2.githubusercontent.com/u/703748?v=2&s=60 + commits: 1 + linesAdded: 67 + linesDeleted: 67 + rank: 8 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2014-03-01-scala-fame-2014-02.md b/contribute/scala-fame-data/_posts/2014-03-01-scala-fame-2014-02.md new file mode 100644 index 0000000000..065ab45d13 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-03-01-scala-fame-2014-02.md @@ -0,0 +1,133 @@ +--- +layout: famearchive +title: Contributors of February 2014 +fame-year: 2014 +fame-month: 2 +fame-month-str: February +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 47 + linesAdded: 1533 + linesDeleted: 1032 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 25 + linesAdded: 1043 + linesDeleted: 491 + rank: 2 + newContributor: false + - username: gkossakowski + gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 + commits: 4 + linesAdded: 1867 + linesDeleted: 1747 + rank: 3 + newContributor: false + - username: paulp + gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 + commits: 3 + linesAdded: 427 + linesDeleted: 15 + rank: 4 + newContributor: false + - username: dragos + gravatar: https://avatars2.githubusercontent.com/u/133742?v=2&s=60 + commits: 1 + linesAdded: 12 + linesDeleted: 3 + rank: 5 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 47 + linesAdded: 3989 + linesDeleted: 1545 + rank: 1 + newContributor: false + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 1 + linesAdded: 18 + linesDeleted: 13 + rank: 2 + newContributor: false + - category: Community + authors: + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 23 + linesAdded: 1166 + linesDeleted: 515 + rank: 1 + newContributor: false + - username: VladimirNik + gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 + commits: 10 + linesAdded: 2647 + linesDeleted: 2416 + rank: 2 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 9 + linesAdded: 662 + linesDeleted: 339 + rank: 3 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 8 + linesAdded: 277 + linesDeleted: 75 + rank: 4 + newContributor: false + - username: pavelpavlov + gravatar: https://avatars0.githubusercontent.com/u/1330451?v=2&s=60 + commits: 3 + linesAdded: 44 + linesDeleted: 54 + rank: 5 + newContributor: false + - username: Blaisorblade + gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 + commits: 3 + linesAdded: 6 + linesDeleted: 5 + rank: 5 + newContributor: false + - username: soc + gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 + commits: 3 + linesAdded: 476 + linesDeleted: 338 + rank: 5 + newContributor: false + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 2 + linesAdded: 7 + linesDeleted: 7 + rank: 6 + newContributor: false + - username: greenrd + gravatar: https://avatars1.githubusercontent.com/u/164965?v=2&s=60 + commits: 1 + linesAdded: 2 + linesDeleted: 3 + rank: 7 + newContributor: false + - username: clhodapp + gravatar: https://avatars0.githubusercontent.com/u/108633?v=2&s=60 + commits: 1 + linesAdded: 228 + linesDeleted: 0 + rank: 7 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2014-04-01-scala-fame-2014-03.md b/contribute/scala-fame-data/_posts/2014-04-01-scala-fame-2014-03.md new file mode 100644 index 0000000000..954a870612 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-04-01-scala-fame-2014-03.md @@ -0,0 +1,112 @@ +--- +layout: famearchive +title: Contributors of March 2014 +fame-year: 2014 +fame-month: 3 +fame-month-str: March +fame-categories: + - category: Typesafe + authors: + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 79 + linesAdded: 24547 + linesDeleted: 24999 + rank: 1 + newContributor: false + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 21 + linesAdded: 622 + linesDeleted: 101 + rank: 2 + newContributor: false + - username: gkossakowski + gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 + commits: 3 + linesAdded: 236 + linesDeleted: 6 + rank: 3 + newContributor: false + - username: huitseeker + gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 + commits: 2 + linesAdded: 4 + linesDeleted: 2 + rank: 4 + newContributor: false + - username: szeiger + gravatar: https://avatars3.githubusercontent.com/u/54262?v=2&s=60 + commits: 1 + linesAdded: 8 + linesDeleted: 1 + rank: 5 + newContributor: false + - username: viktorklang + gravatar: https://avatars0.githubusercontent.com/u/10871?v=2&s=60 + commits: 1 + linesAdded: 7 + linesDeleted: 2 + rank: 5 + newContributor: false + - username: paulp + gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 + commits: 1 + linesAdded: 20 + linesDeleted: 3 + rank: 5 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 10 + linesAdded: 379 + linesDeleted: 76 + rank: 1 + newContributor: false + - category: Community + authors: + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 13 + linesAdded: 589 + linesDeleted: 115 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 4 + linesAdded: 31 + linesDeleted: 23 + rank: 2 + newContributor: false + - username: VladimirNik + gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 + commits: 2 + linesAdded: 1778 + linesDeleted: 1441 + rank: 3 + newContributor: false + - username: mkubala + gravatar: https://avatars0.githubusercontent.com/u/328844?v=2&s=60 + commits: 1 + linesAdded: 247 + linesDeleted: 53 + rank: 4 + newContributor: false + - username: puffnfresh + gravatar: https://avatars1.githubusercontent.com/u/37715?v=2&s=60 + commits: 1 + linesAdded: 0 + linesDeleted: 1 + rank: 4 + newContributor: false + - username: iainmcgin + gravatar: https://avatars0.githubusercontent.com/u/309153?v=2&s=60 + commits: 1 + linesAdded: 20 + linesDeleted: 19 + rank: 4 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2014-05-01-scala-fame-2014-04.md b/contribute/scala-fame-data/_posts/2014-05-01-scala-fame-2014-04.md new file mode 100644 index 0000000000..66c6819f17 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-05-01-scala-fame-2014-04.md @@ -0,0 +1,91 @@ +--- +layout: famearchive +title: Contributors of April 2014 +fame-year: 2014 +fame-month: 4 +fame-month-str: April +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 9 + linesAdded: 177 + linesDeleted: 34 + rank: 1 + newContributor: false + - username: huitseeker + gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 + commits: 1 + linesAdded: 16 + linesDeleted: 1 + rank: 2 + newContributor: false + - username: gkossakowski + gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 + commits: 1 + linesAdded: 10 + linesDeleted: 3 + rank: 2 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 1 + linesAdded: 34 + linesDeleted: 2 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 2 + linesAdded: 202 + linesDeleted: 75 + rank: 1 + newContributor: false + - username: VladUreche + gravatar: https://avatars0.githubusercontent.com/u/428706?v=2&s=60 + commits: 1 + linesAdded: 24 + linesDeleted: 3 + rank: 2 + newContributor: false + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 1 + linesAdded: 12 + linesDeleted: 1 + rank: 2 + newContributor: false + - category: Community + authors: + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 3 + linesAdded: 51 + linesDeleted: 5 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 2 + linesAdded: 110 + linesDeleted: 51 + rank: 2 + newContributor: false + - username: lefou + gravatar: https://avatars2.githubusercontent.com/u/1321393?v=2&s=60 + commits: 1 + linesAdded: 45 + linesDeleted: 8 + rank: 3 + newContributor: false + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 1 + linesAdded: 4 + linesDeleted: 5 + rank: 3 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2014-06-01-scala-fame-2014-05.md b/contribute/scala-fame-data/_posts/2014-06-01-scala-fame-2014-05.md new file mode 100644 index 0000000000..f9191afb17 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-06-01-scala-fame-2014-05.md @@ -0,0 +1,112 @@ +--- +layout: famearchive +title: Contributors of May 2014 +fame-year: 2014 +fame-month: 5 +fame-month-str: May +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 32 + linesAdded: 951 + linesDeleted: 136 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 9 + linesAdded: 21 + linesDeleted: 70 + rank: 2 + newContributor: false + - username: gkossakowski + gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 + commits: 3 + linesAdded: 13 + linesDeleted: 18 + rank: 3 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 23 + linesAdded: 6048 + linesDeleted: 2325 + rank: 1 + newContributor: false + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 3 + linesAdded: 93 + linesDeleted: 3 + rank: 2 + newContributor: false + - category: Community + authors: + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 12 + linesAdded: 442 + linesDeleted: 238 + rank: 1 + newContributor: false + - username: lefou + gravatar: https://avatars2.githubusercontent.com/u/1321393?v=2&s=60 + commits: 3 + linesAdded: 14 + linesDeleted: 24 + rank: 2 + newContributor: false + - username: tvierling + gravatar: https://avatars3.githubusercontent.com/u/397857?v=2&s=60 + commits: 2 + linesAdded: 35 + linesDeleted: 11 + rank: 3 + newContributor: true + - username: clhodapp + gravatar: https://avatars0.githubusercontent.com/u/108633?v=2&s=60 + commits: 2 + linesAdded: 98 + linesDeleted: 51 + rank: 3 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 2 + linesAdded: 55 + linesDeleted: 16 + rank: 3 + newContributor: false + - username: mkubala + gravatar: https://avatars0.githubusercontent.com/u/328844?v=2&s=60 + commits: 1 + linesAdded: 1 + linesDeleted: 0 + rank: 4 + newContributor: false + - username: jedesah + gravatar: https://avatars1.githubusercontent.com/u/1780116?v=2&s=60 + commits: 1 + linesAdded: 23 + linesDeleted: 1 + rank: 4 + newContributor: false + - username: VladimirNik + gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 + commits: 1 + linesAdded: 78 + linesDeleted: 40 + rank: 4 + newContributor: false + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 1 + linesAdded: 14 + linesDeleted: 0 + rank: 4 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2014-07-01-scala-fame-2014-06.md b/contribute/scala-fame-data/_posts/2014-07-01-scala-fame-2014-06.md new file mode 100644 index 0000000000..5f051d08a7 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-07-01-scala-fame-2014-06.md @@ -0,0 +1,98 @@ +--- +layout: famearchive +title: Contributors of June 2014 +fame-year: 2014 +fame-month: 6 +fame-month-str: June +fame-categories: + - category: Typesafe + authors: + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 14 + linesAdded: 873 + linesDeleted: 661 + rank: 1 + newContributor: false + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 8 + linesAdded: 166 + linesDeleted: 126 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 16 + linesAdded: 1865 + linesDeleted: 437 + rank: 1 + newContributor: false + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 4 + linesAdded: 164 + linesDeleted: 44 + rank: 2 + newContributor: false + - username: odersky + gravatar: https://avatars2.githubusercontent.com/u/795990?v=2&s=60 + commits: 1 + linesAdded: 36 + linesDeleted: 10 + rank: 3 + newContributor: false + - category: Community + authors: + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 7 + linesAdded: 275 + linesDeleted: 57 + rank: 1 + newContributor: false + - username: jxcoder + gravatar: https://avatars1.githubusercontent.com/u/1075547?v=2&s=60 + commits: 4 + linesAdded: 41 + linesDeleted: 19 + rank: 2 + newContributor: true + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 2 + linesAdded: 20 + linesDeleted: 6 + rank: 3 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 2 + linesAdded: 146 + linesDeleted: 41 + rank: 3 + newContributor: false + - username: jrudolph + gravatar: https://avatars1.githubusercontent.com/u/9868?v=2&s=60 + commits: 1 + linesAdded: 97 + linesDeleted: 4 + rank: 4 + newContributor: false + - username: Blaisorblade + gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 + commits: 1 + linesAdded: 6 + linesDeleted: 1 + rank: 4 + newContributor: false + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 1 + linesAdded: 17 + linesDeleted: 5 + rank: 4 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2014-08-01-scala-fame-2014-07.md b/contribute/scala-fame-data/_posts/2014-08-01-scala-fame-2014-07.md new file mode 100644 index 0000000000..c57474778d --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-08-01-scala-fame-2014-07.md @@ -0,0 +1,98 @@ +--- +layout: famearchive +title: Contributors of July 2014 +fame-year: 2014 +fame-month: 7 +fame-month-str: July +fame-categories: + - category: Typesafe + authors: + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 31 + linesAdded: 775 + linesDeleted: 712 + rank: 1 + newContributor: false + - username: phaller + gravatar: https://avatars0.githubusercontent.com/u/289943?v=2&s=60 + commits: 3 + linesAdded: 161 + linesDeleted: 49 + rank: 2 + newContributor: false + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 1 + linesAdded: 35 + linesDeleted: 34 + rank: 3 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 4 + linesAdded: 84 + linesDeleted: 29 + rank: 1 + newContributor: false + - category: Community + authors: + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 11 + linesAdded: 330 + linesDeleted: 226 + rank: 1 + newContributor: false + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 5 + linesAdded: 217 + linesDeleted: 94 + rank: 2 + newContributor: false + - username: dhgarrette + gravatar: https://avatars2.githubusercontent.com/u/484190?v=2&s=60 + commits: 2 + linesAdded: 1 + linesDeleted: 3 + rank: 3 + newContributor: true + - username: pocket7878 + gravatar: https://avatars1.githubusercontent.com/u/236528?v=2&s=60 + commits: 2 + linesAdded: 21 + linesDeleted: 13 + rank: 3 + newContributor: true + - username: dgruntz + gravatar: https://avatars3.githubusercontent.com/u/1516800?v=2&s=60 + commits: 2 + linesAdded: 4 + linesDeleted: 4 + rank: 3 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 1 + linesAdded: 26 + linesDeleted: 9 + rank: 4 + newContributor: false + - username: kzys + gravatar: https://avatars2.githubusercontent.com/u/19111?v=2&s=60 + commits: 1 + linesAdded: 19 + linesDeleted: 0 + rank: 4 + newContributor: false + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 1 + linesAdded: 3 + linesDeleted: 1 + rank: 4 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md b/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md index 1393e01705..afef86d3be 100644 --- a/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md +++ b/contribute/scala-fame-data/_posts/2014-09-01-scala-fame-2014-08.md @@ -46,6 +46,13 @@ fame-categories: linesDeleted: 543 rank: 1 newContributor: false + - username: gbasler + gravatar: https://avatars1.githubusercontent.com/u/273035?v=2&s=60 + commits: 1 + linesAdded: 14 + linesDeleted: 22 + rank: 2 + newContributor: false - username: dgruntz gravatar: https://avatars3.githubusercontent.com/u/1516800?v=2&s=60 commits: 1 diff --git a/contribute/scala-fame-data/_posts/2014-10-01-scala-fame-2014-09.md b/contribute/scala-fame-data/_posts/2014-10-01-scala-fame-2014-09.md new file mode 100644 index 0000000000..ee67016186 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-10-01-scala-fame-2014-09.md @@ -0,0 +1,84 @@ +--- +layout: famearchive +title: Contributors of September 2014 +fame-year: 2014 +fame-month: 9 +fame-month-str: September +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 12 + linesAdded: 182 + linesDeleted: 23 + rank: 1 + newContributor: false + - username: dragos + gravatar: https://avatars2.githubusercontent.com/u/133742?v=2&s=60 + commits: 1 + linesAdded: 169 + linesDeleted: 169 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 6 + linesAdded: 262 + linesDeleted: 85 + rank: 1 + newContributor: false + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 3 + linesAdded: 1272 + linesDeleted: 1240 + rank: 2 + newContributor: false + - category: Community + authors: + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 9 + linesAdded: 1782 + linesDeleted: 1227 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 4 + linesAdded: 305 + linesDeleted: 125 + rank: 2 + newContributor: false + - username: puffnfresh + gravatar: https://avatars1.githubusercontent.com/u/37715?v=2&s=60 + commits: 3 + linesAdded: 42 + linesDeleted: 7 + rank: 3 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 2 + linesAdded: 12 + linesDeleted: 1 + rank: 4 + newContributor: false + - username: gbasler + gravatar: https://avatars1.githubusercontent.com/u/273035?v=2&s=60 + commits: 1 + linesAdded: 115 + linesDeleted: 41 + rank: 5 + newContributor: false + - username: soc + gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 + commits: 1 + linesAdded: 4 + linesDeleted: 1 + rank: 5 + newContributor: false +--- From bd730a6d4d147e313828cf8155e71a8ac47069be Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Fri, 24 Oct 2014 16:48:29 +0200 Subject: [PATCH 0048/3075] Add 2013 scala-fame data --- .../_posts/2013-02-01-scala-fame-2013-01.md | 175 ++++++++++++++++++ .../_posts/2013-11-01-scala-fame-2013-10.md | 105 +++++++++++ .../_posts/2013-12-01-scala-fame-2013-11.md | 126 +++++++++++++ .../_posts/2014-01-01-scala-fame-2013-12.md | 147 +++++++++++++++ 4 files changed, 553 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2013-02-01-scala-fame-2013-01.md create mode 100644 contribute/scala-fame-data/_posts/2013-11-01-scala-fame-2013-10.md create mode 100644 contribute/scala-fame-data/_posts/2013-12-01-scala-fame-2013-11.md create mode 100644 contribute/scala-fame-data/_posts/2014-01-01-scala-fame-2013-12.md diff --git a/contribute/scala-fame-data/_posts/2013-02-01-scala-fame-2013-01.md b/contribute/scala-fame-data/_posts/2013-02-01-scala-fame-2013-01.md new file mode 100644 index 0000000000..68e990a7b7 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-02-01-scala-fame-2013-01.md @@ -0,0 +1,175 @@ +--- +layout: famearchive +title: Contributors of January 2013 +fame-year: 2013 +fame-month: 1 +fame-month-str: January +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 67 + linesAdded: 7112 + linesDeleted: 3063 + rank: 1 + newContributor: false + - username: paulp + gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 + commits: 37 + linesAdded: 1812 + linesDeleted: 1158 + rank: 2 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 22 + linesAdded: 1397 + linesDeleted: 561 + rank: 3 + newContributor: false + - username: JamesIry + gravatar: https://avatars0.githubusercontent.com/u/478012?v=2&s=60 + commits: 20 + linesAdded: 1156 + linesDeleted: 208 + rank: 4 + newContributor: false + - username: gkossakowski + gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 + commits: 5 + linesAdded: 422 + linesDeleted: 9 + rank: 5 + newContributor: false + - username: viktorklang + gravatar: https://avatars0.githubusercontent.com/u/10871?v=2&s=60 + commits: 2 + linesAdded: 187 + linesDeleted: 12 + rank: 6 + newContributor: false + - username: phaller + gravatar: https://avatars0.githubusercontent.com/u/289943?v=2&s=60 + commits: 2 + linesAdded: 21 + linesDeleted: 42 + rank: 6 + newContributor: false + - username: dragos + gravatar: https://avatars2.githubusercontent.com/u/133742?v=2&s=60 + commits: 1 + linesAdded: 6 + linesDeleted: 26 + rank: 7 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 28 + linesAdded: 8416 + linesDeleted: 2758 + rank: 1 + newContributor: false + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 8 + linesAdded: 1189 + linesDeleted: 418 + rank: 2 + newContributor: false + - username: heathermiller + gravatar: https://avatars0.githubusercontent.com/u/687163?v=2&s=60 + commits: 2 + linesAdded: 100 + linesDeleted: 15 + rank: 3 + newContributor: false + - username: namin + gravatar: https://avatars2.githubusercontent.com/u/6441?v=2&s=60 + commits: 1 + linesAdded: 23 + linesDeleted: 4 + rank: 4 + newContributor: false + - username: vjovanov + gravatar: https://avatars3.githubusercontent.com/u/352820?v=2&s=60 + commits: 1 + linesAdded: 38 + linesDeleted: 2 + rank: 4 + newContributor: false + - category: Community + authors: + - username: soc + gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 + commits: 13 + linesAdded: 886 + linesDeleted: 3152 + rank: 1 + newContributor: false + - username: kzys + gravatar: https://avatars2.githubusercontent.com/u/19111?v=2&s=60 + commits: 7 + linesAdded: 79 + linesDeleted: 40 + rank: 2 + newContributor: false + - username: danielhopkins + gravatar: https://avatars3.githubusercontent.com/u/91909?v=2&s=60 + commits: 2 + linesAdded: 146 + linesDeleted: 146 + rank: 3 + newContributor: true + - username: ViniciusMiana + gravatar: https://avatars1.githubusercontent.com/u/2053546?v=2&s=60 + commits: 2 + linesAdded: 47 + linesDeleted: 8 + rank: 3 + newContributor: false + - username: Blaisorblade + gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 + commits: 2 + linesAdded: 53 + linesDeleted: 6 + rank: 3 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 2 + linesAdded: 236 + linesDeleted: 183 + rank: 3 + newContributor: false + - username: eed3si9n + gravatar: https://avatars1.githubusercontent.com/u/184683?v=2&s=60 + commits: 1 + linesAdded: 35 + linesDeleted: 2 + rank: 4 + newContributor: false + - username: mt2309 + gravatar: https://avatars2.githubusercontent.com/u/816245?v=2&s=60 + commits: 1 + linesAdded: 24 + linesDeleted: 0 + rank: 4 + newContributor: false + - username: puffnfresh + gravatar: https://avatars1.githubusercontent.com/u/37715?v=2&s=60 + commits: 1 + linesAdded: 39 + linesDeleted: 3 + rank: 4 + newContributor: false + - username: khernyo + gravatar: https://avatars3.githubusercontent.com/u/447532?v=2&s=60 + commits: 1 + linesAdded: 2 + linesDeleted: 3 + rank: 4 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2013-11-01-scala-fame-2013-10.md b/contribute/scala-fame-data/_posts/2013-11-01-scala-fame-2013-10.md new file mode 100644 index 0000000000..557955d60c --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-11-01-scala-fame-2013-10.md @@ -0,0 +1,105 @@ +--- +layout: famearchive +title: Contributors of October 2013 +fame-year: 2013 +fame-month: 10 +fame-month-str: October +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 52 + linesAdded: 1917 + linesDeleted: 1778 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 18 + linesAdded: 1648 + linesDeleted: 1591 + rank: 2 + newContributor: false + - username: paulp + gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 + commits: 9 + linesAdded: 871 + linesDeleted: 1346 + rank: 3 + newContributor: false + - username: huitseeker + gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 + commits: 1 + linesAdded: 3 + linesDeleted: 0 + rank: 4 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 9 + linesAdded: 398 + linesDeleted: 2260 + rank: 1 + newContributor: false + - username: axel22 + gravatar: https://avatars1.githubusercontent.com/u/151774?v=2&s=60 + commits: 1 + linesAdded: 201 + linesDeleted: 74 + rank: 2 + newContributor: false + - category: Community + authors: + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 18 + linesAdded: 766 + linesDeleted: 422 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 4 + linesAdded: 114 + linesDeleted: 58 + rank: 2 + newContributor: false + - username: etaty + gravatar: https://avatars3.githubusercontent.com/u/461170?v=2&s=60 + commits: 2 + linesAdded: 2 + linesDeleted: 2 + rank: 3 + newContributor: false + - username: dotta + gravatar: https://avatars2.githubusercontent.com/u/703748?v=2&s=60 + commits: 2 + linesAdded: 68 + linesDeleted: 6 + rank: 3 + newContributor: false + - username: qerub + gravatar: https://avatars2.githubusercontent.com/u/636?v=2&s=60 + commits: 1 + linesAdded: 8 + linesDeleted: 0 + rank: 4 + newContributor: false + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 1 + linesAdded: 31 + linesDeleted: 1 + rank: 4 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 1 + linesAdded: 215 + linesDeleted: 25 + rank: 4 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2013-12-01-scala-fame-2013-11.md b/contribute/scala-fame-data/_posts/2013-12-01-scala-fame-2013-11.md new file mode 100644 index 0000000000..7fba955998 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2013-12-01-scala-fame-2013-11.md @@ -0,0 +1,126 @@ +--- +layout: famearchive +title: Contributors of November 2013 +fame-year: 2013 +fame-month: 11 +fame-month-str: November +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 44 + linesAdded: 1814 + linesDeleted: 1372 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 20 + linesAdded: 1945 + linesDeleted: 1463 + rank: 2 + newContributor: false + - username: paulp + gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 + commits: 4 + linesAdded: 62 + linesDeleted: 659 + rank: 3 + newContributor: false + - username: huitseeker + gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 + commits: 2 + linesAdded: 137 + linesDeleted: 87 + rank: 4 + newContributor: false + - username: phaller + gravatar: https://avatars0.githubusercontent.com/u/289943?v=2&s=60 + commits: 1 + linesAdded: 105 + linesDeleted: 101 + rank: 5 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 5 + linesAdded: 82 + linesDeleted: 12 + rank: 1 + newContributor: false + - username: heathermiller + gravatar: https://avatars0.githubusercontent.com/u/687163?v=2&s=60 + commits: 1 + linesAdded: 8 + linesDeleted: 5 + rank: 2 + newContributor: false + - category: Community + authors: + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 10 + linesAdded: 1089 + linesDeleted: 884 + rank: 1 + newContributor: false + - username: skyluc + gravatar: https://avatars3.githubusercontent.com/u/1098830?v=2&s=60 + commits: 6 + linesAdded: 1911 + linesDeleted: 53 + rank: 2 + newContributor: false + - username: dotta + gravatar: https://avatars2.githubusercontent.com/u/703748?v=2&s=60 + commits: 6 + linesAdded: 64 + linesDeleted: 47 + rank: 2 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 6 + linesAdded: 499 + linesDeleted: 197 + rank: 2 + newContributor: false + - username: soc + gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 + commits: 5 + linesAdded: 280 + linesDeleted: 97 + rank: 3 + newContributor: false + - username: sschaef + gravatar: https://avatars2.githubusercontent.com/u/488530?v=2&s=60 + commits: 4 + linesAdded: 182 + linesDeleted: 12 + rank: 4 + newContributor: false + - username: xuwei-k + gravatar: https://avatars3.githubusercontent.com/u/389787?v=2&s=60 + commits: 2 + linesAdded: 3 + linesDeleted: 3 + rank: 5 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 2 + linesAdded: 1179 + linesDeleted: 0 + rank: 5 + newContributor: false + - username: Blaisorblade + gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 + commits: 1 + linesAdded: 3 + linesDeleted: 3 + rank: 6 + newContributor: false +--- diff --git a/contribute/scala-fame-data/_posts/2014-01-01-scala-fame-2013-12.md b/contribute/scala-fame-data/_posts/2014-01-01-scala-fame-2013-12.md new file mode 100644 index 0000000000..80c4139b10 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-01-01-scala-fame-2013-12.md @@ -0,0 +1,147 @@ +--- +layout: famearchive +title: Contributors of December 2013 +fame-year: 2013 +fame-month: 12 +fame-month-str: December +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 28 + linesAdded: 901 + linesDeleted: 215 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 21 + linesAdded: 1386 + linesDeleted: 16746 + rank: 2 + newContributor: false + - username: paulp + gravatar: https://avatars2.githubusercontent.com/u/9135?v=2&s=60 + commits: 9 + linesAdded: 899 + linesDeleted: 409 + rank: 3 + newContributor: false + - username: huitseeker + gravatar: https://avatars2.githubusercontent.com/u/4142?v=2&s=60 + commits: 3 + linesAdded: 45 + linesDeleted: 38 + rank: 4 + newContributor: false + - category: EPFL + authors: + - username: xeno-by + gravatar: https://avatars1.githubusercontent.com/u/609152?v=2&s=60 + commits: 30 + linesAdded: 2170 + linesDeleted: 984 + rank: 1 + newContributor: false + - username: magarciaEPFL + gravatar: https://avatars2.githubusercontent.com/u/1249748?v=2&s=60 + commits: 5 + linesAdded: 47 + linesDeleted: 17 + rank: 2 + newContributor: false + - category: Community + authors: + - username: densh + gravatar: https://avatars2.githubusercontent.com/u/320966?v=2&s=60 + commits: 20 + linesAdded: 1604 + linesDeleted: 703 + rank: 1 + newContributor: false + - username: soc + gravatar: https://avatars0.githubusercontent.com/u/42493?v=2&s=60 + commits: 11 + linesAdded: 728 + linesDeleted: 606 + rank: 2 + newContributor: false + - username: Ichoran + gravatar: https://avatars3.githubusercontent.com/u/2298644?v=2&s=60 + commits: 8 + linesAdded: 1490 + linesDeleted: 286 + rank: 3 + newContributor: false + - username: som-snytt + gravatar: https://avatars2.githubusercontent.com/u/369425?v=2&s=60 + commits: 6 + linesAdded: 382 + linesDeleted: 224 + rank: 4 + newContributor: false + - username: dotta + gravatar: https://avatars2.githubusercontent.com/u/703748?v=2&s=60 + commits: 5 + linesAdded: 265 + linesDeleted: 13 + rank: 5 + newContributor: false + - username: VladimirNik + gravatar: https://avatars2.githubusercontent.com/u/2835001?v=2&s=60 + commits: 2 + linesAdded: 7 + linesDeleted: 8 + rank: 6 + newContributor: false + - username: rklaehn + gravatar: https://avatars0.githubusercontent.com/u/248257?v=2&s=60 + commits: 2 + linesAdded: 2 + linesDeleted: 83 + rank: 6 + newContributor: false + - username: qerub + gravatar: https://avatars2.githubusercontent.com/u/636?v=2&s=60 + commits: 1 + linesAdded: 10 + linesDeleted: 11 + rank: 7 + newContributor: false + - username: jrudolph + gravatar: https://avatars1.githubusercontent.com/u/9868?v=2&s=60 + commits: 1 + linesAdded: 4 + linesDeleted: 4 + rank: 7 + newContributor: false + - username: skyluc + gravatar: https://avatars3.githubusercontent.com/u/1098830?v=2&s=60 + commits: 1 + linesAdded: 112 + linesDeleted: 54 + rank: 7 + newContributor: false + - username: non + gravatar: https://avatars3.githubusercontent.com/u/218045?v=2&s=60 + commits: 1 + linesAdded: 19 + linesDeleted: 8 + rank: 7 + newContributor: false + - username: xuwei-k + gravatar: https://avatars3.githubusercontent.com/u/389787?v=2&s=60 + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 7 + newContributor: false + - username: gourlaysama + gravatar: https://avatars2.githubusercontent.com/u/733438?v=2&s=60 + commits: 1 + linesAdded: 136 + linesDeleted: 55 + rank: 7 + newContributor: false +--- From 3d71e5bd8e4dae6dc1d318e8d72768b49e97bede Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Mon, 3 Nov 2014 16:34:38 +0100 Subject: [PATCH 0049/3075] Add scala-fame data --- .../_posts/2014-11-01-scala-fame-2014-10.md | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2014-11-01-scala-fame-2014-10.md diff --git a/contribute/scala-fame-data/_posts/2014-11-01-scala-fame-2014-10.md b/contribute/scala-fame-data/_posts/2014-11-01-scala-fame-2014-10.md new file mode 100644 index 0000000000..0c957577fb --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-11-01-scala-fame-2014-10.md @@ -0,0 +1,63 @@ +--- +layout: famearchive +title: Contributors of October 2014 +fame-year: 2014 +fame-month: 10 +fame-month-str: October +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars0.githubusercontent.com/u/65551?v=2&s=60 + commits: 11 + linesAdded: 414 + linesDeleted: 51 + rank: 1 + newContributor: false + - username: gkossakowski + gravatar: https://avatars0.githubusercontent.com/u/4217?v=2&s=60 + commits: 2 + linesAdded: 2 + linesDeleted: 2 + rank: 2 + newContributor: false + - username: adriaanm + gravatar: https://avatars2.githubusercontent.com/u/91083?v=2&s=60 + commits: 2 + linesAdded: 54 + linesDeleted: 18 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars3.githubusercontent.com/u/119636?v=2&s=60 + commits: 4 + linesAdded: 146 + linesDeleted: 171 + rank: 1 + newContributor: false + - category: Community + authors: + - username: roberthoedicke + gravatar: https://avatars0.githubusercontent.com/u/9093826?v=2&s=60 + commits: 9 + linesAdded: 15 + linesDeleted: 15 + rank: 1 + newContributor: true + - username: puffnfresh + gravatar: https://avatars1.githubusercontent.com/u/37715?v=2&s=60 + commits: 1 + linesAdded: 19 + linesDeleted: 10 + rank: 2 + newContributor: false + - username: Blaisorblade + gravatar: https://avatars2.githubusercontent.com/u/289960?v=2&s=60 + commits: 1 + linesAdded: 0 + linesDeleted: 93 + rank: 2 + newContributor: false +--- From 84d53a941025d8188d7ce2f8312748ed23ae6de6 Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Wed, 3 Dec 2014 16:47:25 +0100 Subject: [PATCH 0050/3075] Add scala-fame data --- .../_posts/2014-12-01-scala-fame-2014-11.md | 112 ++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2014-12-01-scala-fame-2014-11.md diff --git a/contribute/scala-fame-data/_posts/2014-12-01-scala-fame-2014-11.md b/contribute/scala-fame-data/_posts/2014-12-01-scala-fame-2014-11.md new file mode 100644 index 0000000000..3c95eb2521 --- /dev/null +++ b/contribute/scala-fame-data/_posts/2014-12-01-scala-fame-2014-11.md @@ -0,0 +1,112 @@ +--- +layout: famearchive +title: Contributors of November 2014 +fame-year: 2014 +fame-month: 11 +fame-month-str: November +fame-categories: + - category: Typesafe + authors: + - username: retronym + gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 + commits: 24 + linesAdded: 650 + linesDeleted: 90 + rank: 1 + newContributor: false + - username: adriaanm + gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 + commits: 3 + linesAdded: 208 + linesDeleted: 54 + rank: 2 + newContributor: false + - username: phaller + gravatar: https://avatars1.githubusercontent.com/u/289943?v=3&s=60 + commits: 1 + linesAdded: 10 + linesDeleted: 8 + rank: 3 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 + commits: 6 + linesAdded: 782 + linesDeleted: 32 + rank: 1 + newContributor: false + - username: heathermiller + gravatar: https://avatars1.githubusercontent.com/u/687163?v=3&s=60 + commits: 2 + linesAdded: 64 + linesDeleted: 66 + rank: 2 + newContributor: false + - category: Community + authors: + - username: gourlaysama + gravatar: https://avatars3.githubusercontent.com/u/733438?v=3&s=60 + commits: 7 + linesAdded: 245 + linesDeleted: 83 + rank: 1 + newContributor: false + - username: som-snytt + gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 + commits: 3 + linesAdded: 53 + linesDeleted: 53 + rank: 2 + newContributor: false + - username: advancedxy + gravatar: https://avatars1.githubusercontent.com/u/807537?v=3&s=60 + commits: 2 + linesAdded: 2 + linesDeleted: 2 + rank: 3 + newContributor: true + - username: kanielc + gravatar: https://avatars1.githubusercontent.com/u/1334074?v=3&s=60 + commits: 2 + linesAdded: 3 + linesDeleted: 3 + rank: 3 + newContributor: true + - username: gdickinson + gravatar: https://avatars3.githubusercontent.com/u/1130928?v=3&s=60 + commits: 2 + linesAdded: 0 + linesDeleted: 380 + rank: 3 + newContributor: true + - username: Ichoran + gravatar: https://avatars2.githubusercontent.com/u/2298644?v=3&s=60 + commits: 2 + linesAdded: 35 + linesDeleted: 18 + rank: 3 + newContributor: false + - username: ruippeixotog + gravatar: https://avatars1.githubusercontent.com/u/613493?v=3&s=60 + commits: 1 + linesAdded: 81 + linesDeleted: 8 + rank: 4 + newContributor: false + - username: mpociecha + gravatar: https://avatars0.githubusercontent.com/u/6143494?v=3&s=60 + commits: 1 + linesAdded: 5 + linesDeleted: 2 + rank: 4 + newContributor: false + - username: soc + gravatar: https://avatars1.githubusercontent.com/u/42493?v=3&s=60 + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 4 + newContributor: false +--- From def0d83bc4a8ae5ab2c7d07928f1717eec682e0d Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Mon, 12 Jan 2015 09:52:21 -0800 Subject: [PATCH 0051/3075] Removed PHP issues page in favor of direct JIRA queries. --- contribute/community-tickets.md | 10 -------- contribute/guide.md | 2 +- contribute/index.md | 45 +++++++++++++++++++++++++++++---- 3 files changed, 41 insertions(+), 16 deletions(-) delete mode 100644 contribute/community-tickets.md diff --git a/contribute/community-tickets.md b/contribute/community-tickets.md deleted file mode 100644 index e458d3b6f2..0000000000 --- a/contribute/community-tickets.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -layout: page-full-width -title: Community tickets ---- - -Below is a selection of tickets from -[Scala's bug tracker](https://issues.scala-lang.org/) -that we think are a good starting point for you, as the community. - -
    diff --git a/contribute/guide.md b/contribute/guide.md index ac27e53719..9446e6ce9c 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -21,7 +21,7 @@ title: Contributing guide
    -

    Community issues

    +

    Community issues

    Get cracking on some easy to approach issues.

    diff --git a/contribute/index.md b/contribute/index.md index d2402cf4d2..d1ba675f05 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -23,9 +23,44 @@ An easy but very important way to contribute to Scala is to ### Compiler and other tools -Want to dive into the hardcore business? Check out our -[selection of community tickets](./community-tickets.html), -which are good starting points to contributing to the compiler and -surrounding tools, like ScalaDoc. - More info in our [contributing guide](./guide.html). + +### Community Tickets + +The following links provide starting points for +various contributor activities: + +
    +
    +
    +

    Documentation

    +

    Help augment or correct the documentation.

    +
    +
    +

    Core Libraries

    +

    Community bugs and enhancements on the core libs.

    +
    +
    + +
    +
    +

    Tools

    +

    Help with the Scala tool chain.

    +
    +
    +

    Compiler

    +

    Ready for a challenge? Here's the compiler bugs.

    +
    +
    + +
    +
    +

    Bugs

    +

    All bugs marked with the label community.

    +
    +
    +

    All Issues

    +

    Bugs + Enhancements marked with the label community.

    +
    +
    +
    From 76fcdfafa32914a60a0dd16e0ee7c75094e9682f Mon Sep 17 00:00:00 2001 From: Fabien Salvi Date: Wed, 14 Jan 2015 11:24:27 +0100 Subject: [PATCH 0052/3075] Add scala-fame data --- .../_posts/2015-01-01-scala-fame-2014-12.md | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 contribute/scala-fame-data/_posts/2015-01-01-scala-fame-2014-12.md diff --git a/contribute/scala-fame-data/_posts/2015-01-01-scala-fame-2014-12.md b/contribute/scala-fame-data/_posts/2015-01-01-scala-fame-2014-12.md new file mode 100644 index 0000000000..c11348b33a --- /dev/null +++ b/contribute/scala-fame-data/_posts/2015-01-01-scala-fame-2014-12.md @@ -0,0 +1,70 @@ +--- +layout: famearchive +title: Contributors of December 2014 +fame-year: 2014 +fame-month: 12 +fame-month-str: December +fame-categories: + - category: Typesafe + authors: + - username: adriaanm + gravatar: https://avatars3.githubusercontent.com/u/91083?v=3&s=60 + commits: 2 + linesAdded: 962 + linesDeleted: 290 + rank: 1 + newContributor: false + - username: retronym + gravatar: https://avatars1.githubusercontent.com/u/65551?v=3&s=60 + commits: 1 + linesAdded: 5 + linesDeleted: 1 + rank: 2 + newContributor: false + - category: EPFL + authors: + - username: lrytz + gravatar: https://avatars2.githubusercontent.com/u/119636?v=3&s=60 + commits: 4 + linesAdded: 61 + linesDeleted: 50 + rank: 1 + newContributor: false + - category: Community + authors: + - username: gbasler + gravatar: https://avatars0.githubusercontent.com/u/273035?v=3&s=60 + commits: 2 + linesAdded: 567 + linesDeleted: 1 + rank: 1 + newContributor: false + - username: kanielc + gravatar: https://avatars1.githubusercontent.com/u/1334074?v=3&s=60 + commits: 1 + linesAdded: 43 + linesDeleted: 6 + rank: 2 + newContributor: false + - username: xuwei-k + gravatar: https://avatars2.githubusercontent.com/u/389787?v=3&s=60 + commits: 1 + linesAdded: 2 + linesDeleted: 2 + rank: 2 + newContributor: false + - username: gourlaysama + gravatar: https://avatars3.githubusercontent.com/u/733438?v=3&s=60 + commits: 1 + linesAdded: 1 + linesDeleted: 1 + rank: 2 + newContributor: false + - username: som-snytt + gravatar: https://avatars3.githubusercontent.com/u/369425?v=3&s=60 + commits: 1 + linesAdded: 44 + linesDeleted: 3 + rank: 2 + newContributor: false +--- From fd4cf442dbb1b58fe5dd583068bbd1dcb2b07aca Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Wed, 14 Jan 2015 14:14:00 -0800 Subject: [PATCH 0053/3075] Add scaladoc contribution page and link up. --- contribute/contribute-scaladoc.md | 116 ++++++++++++++++++++++++++++++ contribute/index.md | 2 + 2 files changed, 118 insertions(+) create mode 100644 contribute/contribute-scaladoc.md diff --git a/contribute/contribute-scaladoc.md b/contribute/contribute-scaladoc.md new file mode 100644 index 0000000000..3bea0dea5a --- /dev/null +++ b/contribute/contribute-scaladoc.md @@ -0,0 +1,116 @@ +--- +layout: page +title: Scaladoc Contributions +--- + +This page is specific to scaladoc contributions. For contributions to the scala-lang +documentation site, [help with the documentation](http://docs.scala-lang.org/contribute.html). + +*Please note, these instructions cover contributions to the scala language and +core libraries only. For other scala projects please check those projects for +the contribution steps and guidelines. Thank you.* + +## Overview + +Since the scaladoc documentation is located in scala source code files, the +process for contributing scaladoc is similar to that of contributing bug-fixes +to the scala code base, but without the requirement that there be a JIRA bug +first (just use a `scaladoc/xxxx` branch name instead of `issue/NNNN`). +However, if an issue *does* exist, please use `issue/NNNN` (where NNNN is the bug id) +instead. + +If you would like to assist us by helping us find missing documentation and +submitting issues, [please read the following section](#submit-scaladoc-issues). +If you want to contribute scaladoc, +[jump down to the next section](#contribute-scaladoc). + +## Submit Scaladoc Issues + +You can also contribute by helping us to identify missing documentation. To do +this, [browse the current API documentation](http://www.scala-lang.org/api/current/) +and identify missing, incorrect or inadequate documentation. In particular pay +attention to the package objects for important packages (these often get overlooked +for documentation and are a good place for API overviews). + +If you find an issue, please log it in the [Scala issue browser](https://issues.scala-lang.org) +**after making sure it is not already logged as an issue**. To help with +disambiguation, please use the following format for issue title: + +* Use an action describing the work required. E.g. Add, Document, Correct, Remove +* Use the full package, class/trait/object name (or state package object if + that is the case). +* Extremely short description of what to do. +* More detail can (and should) go into the issue description, including a short + justification for the issue if it provides additional detail. + +Here is an example of the title and description for an example scaladoc issue: + +`Document scala.concurrent.Future object, include code examples` + +(note the explicit companion object called out in the title) + +and the description: + +`The methods on the Future companion object are critical` +`for using Futures effectively without blocking. Provide code` +`examples of how methods like sequence, transform, fold and` +`firstCompletedOf should be used.` + +In addition to following these conventions, please add `documentation` and +`community` labels to the issue, and put them in the `Documentation and API` +component so that they show up in the correct issue filters. + +## Contribute scaladoc + +### Required reading + +Please familiarize yourself with **all** of the following before contributing +scaladoc to save time, effort, mistakes and repetition. + +* [Forking the Repo](./hacker-guide.html#set-up) follow setup steps through + branch name. If providing scaladoc related to a JIRA issue, use `issue/NNNN` + or `ticket/NNNN` as the guide states. If providing scaladoc with no associated + JIRA issue, use `scaladoc/xxxx` instead, where xxxx is a descriptive but + short branch name, e.g. `scaladoc/future-object`. +* [Scaladoc basics](http://docs.scala-lang.org/overviews/scaladoc/basics.html) + covers the use of scaladoc tags, markdown and other features. +* [Scaladoc usage](http://docs.scala-lang.org/overviews/scaladoc/usage.html) if + you are unfamiliar with all of the features of scaladoc, e.g. switching between + companions, browsing package object documentation, searching, token searches + and so on. +* Prior to commit, be sure to read + [A note about git commit messages](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html). +* Also read the Scala [Pull Request Policy](https://github.com/scala/scala/wiki/Pull-Request-Policy). + Some of this document will clearly not apply (like the sections on providing tests, + however see below for some special requirements for documentation). Do still read + the whole document though, and pay close attention to the title and commit + message formats, noting *present tense*, *length limits* and that it must merge + cleanly. Remember that the title of the pull request will become the commit + message when merged. **Also**, be sure to assign one or more reviewers to the PR, list of + reviewers is at the bottom of this document, but the quick version is to add + `Review by @dickwall` **in the pull request comments**. + +### Extra Requirements for Scaladoc Commits + +Although some of the requirements for bug fix pull requests are not needed for +scaladoc commits, here are the step by step requirements to ensure your scaladoc +PR is merged in smoothly: + +* Any and all code examples provided should *be correct, compile and run* as + expected (ensure this in the REPL or your IDE). +* Spelling must be checked for all written language *and* code examples where + possible. Most editors have some spell checking feature available. Obviously + scala code is likely to flag as mis-spelled sometimes, but any written language + should be checked. If you can also use a grammar checker, even better. We + *will* ask for spelling and grammar to be corrected before acceptance. +* You **must** also run `ant docs`, fix any problems and check the formatting and + layout of your changes. Again, corrections will be required if formatting or + layout are inadequate. After running `ant docs` the generated documents can be + found under the `build/scaladoc/` folders (probably in the `library` folder + but maybe under the others depending on what section of the scala source you + are working on). +* All of these steps are required to save time for both the reviewers and + contributors. It benefits everyone to ensure that the PR to merge process is + as smooth and streamlined as possible. + +Thanks for helping us improve the scaladoc. diff --git a/contribute/index.md b/contribute/index.md index d2402cf4d2..995617634d 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -20,6 +20,8 @@ how to efficiently report a bug. An easy but very important way to contribute to Scala is to [help with the documentation](http://docs.scala-lang.org/contribute.html). +If you want to [contribute to scaladoc](./contribute-scaladoc.html), the +process is slightly different, since scaladoc lives alongside the source code. ### Compiler and other tools From b049734092803dafea95e4318322ff0e6102ff33 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Tue, 27 Jan 2015 09:20:21 -0800 Subject: [PATCH 0054/3075] Corrected JIRA search URL for compiler bugs. --- contribute/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/index.md b/contribute/index.md index d1ba675f05..65c9c501cd 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -48,7 +48,7 @@ various contributor activities:

    Help with the Scala tool chain.

    -

    Compiler

    +

    Compiler

    Ready for a challenge? Here's the compiler bugs.

    From b53c6bd2d67eddb97f61c857ed35989425da73ee Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Thu, 29 Jan 2015 14:21:15 +0100 Subject: [PATCH 0055/3075] Wording tweaks --- contribute/contribute-scaladoc.md | 75 +++++++++++++++++-------------- contribute/index.md | 6 +-- 2 files changed, 44 insertions(+), 37 deletions(-) diff --git a/contribute/contribute-scaladoc.md b/contribute/contribute-scaladoc.md index 3bea0dea5a..d9bd931de3 100644 --- a/contribute/contribute-scaladoc.md +++ b/contribute/contribute-scaladoc.md @@ -1,38 +1,45 @@ --- layout: page -title: Scaladoc Contributions +title: Contribute to API Documentation --- -This page is specific to scaladoc contributions. For contributions to the scala-lang -documentation site, [help with the documentation](http://docs.scala-lang.org/contribute.html). +This page is specific to API documentation contributions – that is, API +documentation for +[Scala's standard library](http://scala-lang.org/api/current/#package) – +sometimes referred to as Scaladoc contributions. -*Please note, these instructions cover contributions to the scala language and -core libraries only. For other scala projects please check those projects for -the contribution steps and guidelines. Thank you.* +For contributions to tutorial and guide-style documentation on +[docs.scala-lang.org](http://docs.scala-lang.org), +see the ["doc-site"'s contribution guide](http://docs.scala-lang.org/contribute.html). + +*Please note, these instructions cover documentation contributions Scala core +libraries only. For other Scala projects please check those projects for the +contribution steps and guidelines. Thank you.* ## Overview -Since the scaladoc documentation is located in scala source code files, the -process for contributing scaladoc is similar to that of contributing bug-fixes -to the scala code base, but without the requirement that there be a JIRA bug -first (just use a `scaladoc/xxxx` branch name instead of `issue/NNNN`). -However, if an issue *does* exist, please use `issue/NNNN` (where NNNN is the bug id) +Since API documentation is located in Scala source code files, the +process for contributing API documentation is similar to that of contributing bug-fixes +to the Scala code base, but without the requirement that there be an issue filed on JIRA +first (when forking/branching, just use a `scaladoc/xxxx` branch name instead of `issue/NNNN`). +However, if an issue *does* exist, please use `issue/NNNN` (where NNNN is the ticket number) instead. If you would like to assist us by helping us find missing documentation and -submitting issues, [please read the following section](#submit-scaladoc-issues). -If you want to contribute scaladoc, -[jump down to the next section](#contribute-scaladoc). +submitting bug reports for existing documentation, +[please read the following section](#contribute-api-documentation-bug-reports). +If you want to contribute new API documentation, +[jump down to the next section](#contribute-new-api-documentation). -## Submit Scaladoc Issues +## Contribute API Documentation Bug Reports -You can also contribute by helping us to identify missing documentation. To do -this, [browse the current API documentation](http://www.scala-lang.org/api/current/) -and identify missing, incorrect or inadequate documentation. In particular pay -attention to the package objects for important packages (these often get overlooked -for documentation and are a good place for API overviews). +One good way to contribute is by helping us to identify missing documentation. To do +this, [browse the current API documentationn](http://www.scala-lang.org/api/current/) +and identify missing, incorrect or inadequate documentation. A good place to start is +is package objects for important packages (these often get overlooked for documentation +and are a good place for API overviews). -If you find an issue, please log it in the [Scala issue browser](https://issues.scala-lang.org) +If you find an issue, please log it in the [Scala issue tracker](https://issues.scala-lang.org) **after making sure it is not already logged as an issue**. To help with disambiguation, please use the following format for issue title: @@ -43,7 +50,7 @@ disambiguation, please use the following format for issue title: * More detail can (and should) go into the issue description, including a short justification for the issue if it provides additional detail. -Here is an example of the title and description for an example scaladoc issue: +Here is an example of the title and description for an example API documentation issue: `Document scala.concurrent.Future object, include code examples` @@ -60,22 +67,22 @@ In addition to following these conventions, please add `documentation` and `community` labels to the issue, and put them in the `Documentation and API` component so that they show up in the correct issue filters. -## Contribute scaladoc +## Contribute New API Documentation -### Required reading +### Required Reading Please familiarize yourself with **all** of the following before contributing -scaladoc to save time, effort, mistakes and repetition. +new API documentation to save time, effort, mistakes and repetition. * [Forking the Repo](./hacker-guide.html#set-up) follow setup steps through - branch name. If providing scaladoc related to a JIRA issue, use `issue/NNNN` - or `ticket/NNNN` as the guide states. If providing scaladoc with no associated + branch name. If providing new documentation related to an existing JIRA issue, use `issue/NNNN` + or `ticket/NNNN` as the guide states. If providing API documentation with no associated JIRA issue, use `scaladoc/xxxx` instead, where xxxx is a descriptive but short branch name, e.g. `scaladoc/future-object`. -* [Scaladoc basics](http://docs.scala-lang.org/overviews/scaladoc/basics.html) +* [Scaladoc for library authors](http://docs.scala-lang.org/overviews/scaladoc/for-library-authors.html) covers the use of scaladoc tags, markdown and other features. -* [Scaladoc usage](http://docs.scala-lang.org/overviews/scaladoc/usage.html) if - you are unfamiliar with all of the features of scaladoc, e.g. switching between +* [Scaladoc's interface](http://docs.scala-lang.org/overviews/scaladoc/interface.html) + covers all of the features of Scaladoc's interface, e.g. switching between companions, browsing package object documentation, searching, token searches and so on. * Prior to commit, be sure to read @@ -93,24 +100,24 @@ scaladoc to save time, effort, mistakes and repetition. ### Extra Requirements for Scaladoc Commits Although some of the requirements for bug fix pull requests are not needed for -scaladoc commits, here are the step by step requirements to ensure your scaladoc +API documentation commits, here are the step by step requirements to ensure your API documentation PR is merged in smoothly: * Any and all code examples provided should *be correct, compile and run* as expected (ensure this in the REPL or your IDE). * Spelling must be checked for all written language *and* code examples where possible. Most editors have some spell checking feature available. Obviously - scala code is likely to flag as mis-spelled sometimes, but any written language + Scala code is likely to flag as mis-spelled sometimes, but any written language should be checked. If you can also use a grammar checker, even better. We *will* ask for spelling and grammar to be corrected before acceptance. * You **must** also run `ant docs`, fix any problems and check the formatting and layout of your changes. Again, corrections will be required if formatting or layout are inadequate. After running `ant docs` the generated documents can be found under the `build/scaladoc/` folders (probably in the `library` folder - but maybe under the others depending on what section of the scala source you + but maybe under the others depending on what section of the Scala source you are working on). * All of these steps are required to save time for both the reviewers and contributors. It benefits everyone to ensure that the PR to merge process is as smooth and streamlined as possible. -Thanks for helping us improve the scaladoc. +Thanks for helping us improve the Scaladoc API documentation! diff --git a/contribute/index.md b/contribute/index.md index 995617634d..5dda418cbf 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -19,9 +19,9 @@ how to efficiently report a bug. ### Help with the documentation An easy but very important way to contribute to Scala is to -[help with the documentation](http://docs.scala-lang.org/contribute.html). -If you want to [contribute to scaladoc](./contribute-scaladoc.html), the -process is slightly different, since scaladoc lives alongside the source code. +[help with the guide/tutorial-style documentation on docs.scala-lang.org](http://docs.scala-lang.org/contribute.html). +If you want to [contribute to Scala standard library API docmentation](./contribute-scaladoc.html), the +process is slightly different, since API documentation lives within Scala standard library source code. ### Compiler and other tools From b27128fd7967d882e274a80fc0328c7d4df6f4c0 Mon Sep 17 00:00:00 2001 From: Heather Miller Date: Thu, 29 Jan 2015 14:25:00 +0100 Subject: [PATCH 0056/3075] Some reorganization and tweaks --- contribute/index.md | 2 +- ...-scaladoc.md => scala-standard-library-api-documentation.md} | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) rename contribute/{contribute-scaladoc.md => scala-standard-library-api-documentation.md} (99%) diff --git a/contribute/index.md b/contribute/index.md index 5dda418cbf..f2bed88bae 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -20,7 +20,7 @@ how to efficiently report a bug. An easy but very important way to contribute to Scala is to [help with the guide/tutorial-style documentation on docs.scala-lang.org](http://docs.scala-lang.org/contribute.html). -If you want to [contribute to Scala standard library API docmentation](./contribute-scaladoc.html), the +If you want to [contribute to Scala standard library API docmentation](./scala-standard-library-api-documentation.html), the process is slightly different, since API documentation lives within Scala standard library source code. ### Compiler and other tools diff --git a/contribute/contribute-scaladoc.md b/contribute/scala-standard-library-api-documentation.md similarity index 99% rename from contribute/contribute-scaladoc.md rename to contribute/scala-standard-library-api-documentation.md index d9bd931de3..ec41aee3cb 100644 --- a/contribute/contribute-scaladoc.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -97,7 +97,7 @@ new API documentation to save time, effort, mistakes and repetition. reviewers is at the bottom of this document, but the quick version is to add `Review by @dickwall` **in the pull request comments**. -### Extra Requirements for Scaladoc Commits +### Extra Requirements for Scaladoc Documentation Commits Although some of the requirements for bug fix pull requests are not needed for API documentation commits, here are the step by step requirements to ensure your API documentation From 66f39d2e292cdc347b7d3c8d59835e83c59739f6 Mon Sep 17 00:00:00 2001 From: Justin Pihony Date: Mon, 2 Feb 2015 15:32:49 -0500 Subject: [PATCH 0057/3075] Fix the Forking url and grammatical consistency Review by @dickwall --- .../scala-standard-library-api-documentation.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index ec41aee3cb..de5a970bbe 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -21,8 +21,9 @@ contribution steps and guidelines. Thank you.* Since API documentation is located in Scala source code files, the process for contributing API documentation is similar to that of contributing bug-fixes to the Scala code base, but without the requirement that there be an issue filed on JIRA -first (when forking/branching, just use a `scaladoc/xxxx` branch name instead of `issue/NNNN`). -However, if an issue *does* exist, please use `issue/NNNN` (where NNNN is the ticket number) +first. When forking/branching, just use a `scaladoc/xxxx` branch name, where xxxx is a +descriptive, but short branch name (e.g. `scaladoc/future-object`). +However, if an issue *does* exist, please use `issue/NNNN`, where NNNN is the ticket number, instead. If you would like to assist us by helping us find missing documentation and @@ -35,8 +36,8 @@ If you want to contribute new API documentation, One good way to contribute is by helping us to identify missing documentation. To do this, [browse the current API documentationn](http://www.scala-lang.org/api/current/) -and identify missing, incorrect or inadequate documentation. A good place to start is -is package objects for important packages (these often get overlooked for documentation +and identify missing, incorrect or inadequate documentation. A good place to start is +package objects for important packages (these often get overlooked for documentation and are a good place for API overviews). If you find an issue, please log it in the [Scala issue tracker](https://issues.scala-lang.org) @@ -74,11 +75,10 @@ component so that they show up in the correct issue filters. Please familiarize yourself with **all** of the following before contributing new API documentation to save time, effort, mistakes and repetition. -* [Forking the Repo](./hacker-guide.html#set-up) follow setup steps through - branch name. If providing new documentation related to an existing JIRA issue, use `issue/NNNN` +* [Forking the Repo](./hacker-guide.html#2_set_up) - follow the setup steps through + the Branch section. If providing new documentation related to an existing JIRA issue, use `issue/NNNN` or `ticket/NNNN` as the guide states. If providing API documentation with no associated - JIRA issue, use `scaladoc/xxxx` instead, where xxxx is a descriptive but - short branch name, e.g. `scaladoc/future-object`. + JIRA issue, use `scaladoc/xxxx` instead. * [Scaladoc for library authors](http://docs.scala-lang.org/overviews/scaladoc/for-library-authors.html) covers the use of scaladoc tags, markdown and other features. * [Scaladoc's interface](http://docs.scala-lang.org/overviews/scaladoc/interface.html) From f2a174cea939a311901274c187ffafadf17ebed0 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Mon, 2 Feb 2015 14:10:10 -0800 Subject: [PATCH 0058/3075] Correct a couple of spelling typos on contribution pages. --- contribute/index.md | 2 +- .../scala-standard-library-api-documentation.md | 16 ++++++++-------- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/contribute/index.md b/contribute/index.md index a065565a98..9ea981b115 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -5,7 +5,7 @@ title: Contribute The Scala programming language is an open source project with a very diverse community, where people from all over the world contribute their work, -with everyone benefitting from friendly help and advice, and +with everyone benefiting from friendly help and advice, and kindly helping others in return. So why not join the Scala community and help everyone make things better? diff --git a/contribute/scala-standard-library-api-documentation.md b/contribute/scala-standard-library-api-documentation.md index de5a970bbe..519c85a030 100644 --- a/contribute/scala-standard-library-api-documentation.md +++ b/contribute/scala-standard-library-api-documentation.md @@ -4,11 +4,11 @@ title: Contribute to API Documentation --- This page is specific to API documentation contributions – that is, API -documentation for -[Scala's standard library](http://scala-lang.org/api/current/#package) – +documentation for +[Scala's standard library](http://scala-lang.org/api/current/#package) – sometimes referred to as Scaladoc contributions. -For contributions to tutorial and guide-style documentation on +For contributions to tutorial and guide-style documentation on [docs.scala-lang.org](http://docs.scala-lang.org), see the ["doc-site"'s contribution guide](http://docs.scala-lang.org/contribute.html). @@ -21,13 +21,13 @@ contribution steps and guidelines. Thank you.* Since API documentation is located in Scala source code files, the process for contributing API documentation is similar to that of contributing bug-fixes to the Scala code base, but without the requirement that there be an issue filed on JIRA -first. When forking/branching, just use a `scaladoc/xxxx` branch name, where xxxx is a +first. When forking/branching, just use a `scaladoc/xxxx` branch name, where xxxx is a descriptive, but short branch name (e.g. `scaladoc/future-object`). However, if an issue *does* exist, please use `issue/NNNN`, where NNNN is the ticket number, instead. If you would like to assist us by helping us find missing documentation and -submitting bug reports for existing documentation, +submitting bug reports for existing documentation, [please read the following section](#contribute-api-documentation-bug-reports). If you want to contribute new API documentation, [jump down to the next section](#contribute-new-api-documentation). @@ -35,9 +35,9 @@ If you want to contribute new API documentation, ## Contribute API Documentation Bug Reports One good way to contribute is by helping us to identify missing documentation. To do -this, [browse the current API documentationn](http://www.scala-lang.org/api/current/) -and identify missing, incorrect or inadequate documentation. A good place to start is -package objects for important packages (these often get overlooked for documentation +this, [browse the current API documentation](http://www.scala-lang.org/api/current/) +and identify missing, incorrect or inadequate documentation. A good place to start is +package objects for important packages (these often get overlooked for documentation and are a good place for API overviews). If you find an issue, please log it in the [Scala issue tracker](https://issues.scala-lang.org) From db2a14f159ab6db8c802cb415885cc1645cbcb85 Mon Sep 17 00:00:00 2001 From: JustinPihony Date: Tue, 3 Feb 2015 21:35:08 -0500 Subject: [PATCH 0059/3075] Add u to docmentation typo Review by @dickwall --- contribute/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contribute/index.md b/contribute/index.md index 9ea981b115..338ff06a06 100644 --- a/contribute/index.md +++ b/contribute/index.md @@ -20,7 +20,7 @@ how to efficiently report a bug. An easy but very important way to contribute to Scala is to [help with the guide/tutorial-style documentation on docs.scala-lang.org](http://docs.scala-lang.org/contribute.html). -If you want to [contribute to Scala standard library API docmentation](./scala-standard-library-api-documentation.html), the +If you want to [contribute to Scala standard library API documentation](./scala-standard-library-api-documentation.html), the process is slightly different, since API documentation lives within Scala standard library source code. ### Compiler and other tools From eb1e3cbd55fa0fb19c8f0f9eb444cd16527d4d15 Mon Sep 17 00:00:00 2001 From: Dick Wall Date: Mon, 9 Feb 2015 14:51:26 -0800 Subject: [PATCH 0060/3075] Update contributor pages for bugs/issues - provide issue checklist - Individual changes to docs: - corelibs.md and tools.md - add placeholders/call for help - documentation.md - small changes and spelling only - guide.md - bugfix checklist with links to other resources for each step - hacker-guide.md - spelling corrections - index.md - organize by type of contribution - scala-internals.md - new doc describing use of scala-internals for coordination - scala-standard-library-api-documentation.md - spelling/minor --- contribute/corelibs.md | 8 + contribute/documentation.md | 92 ++++++++---- contribute/guide.md | 137 ++++-------------- contribute/hacker-guide.md | 6 +- contribute/index.md | 67 +++++++-- contribute/scala-internals.md | 45 ++++++ ...cala-standard-library-api-documentation.md | 6 +- contribute/tools.md | 8 + 8 files changed, 213 insertions(+), 156 deletions(-) create mode 100644 contribute/corelibs.md create mode 100644 contribute/scala-internals.md create mode 100644 contribute/tools.md diff --git a/contribute/corelibs.md b/contribute/corelibs.md new file mode 100644 index 0000000000..1429ec87ff --- /dev/null +++ b/contribute/corelibs.md @@ -0,0 +1,8 @@ +--- +layout: page +title: Core Library Contributions +--- +## Under Construction + +If you would like to help complete this document, welcome, and please head over and read [Documentation Contributions](./documentation.html#the-scala-language-site), +and let us know on the [scala-internals](https://groups.google.com/forum/#!forum/scala-internals) forum (suggested post title: `[docs] Core Library Contributions`) so that we can get you hooked up with the right people. \ No newline at end of file diff --git a/contribute/documentation.md b/contribute/documentation.md index 05b2455a5f..da20b9360d 100644 --- a/contribute/documentation.md +++ b/contribute/documentation.md @@ -2,28 +2,70 @@ layout: page title: Documentation Contributions --- -# Contributing documentation to the Scala project - -TODO - - +## Contributing Documentation to the Scala project + +There are several ways you can help out with the improvement of Scala documentation. These include: + +* Code examples and tutorials in activator templates. +* The Scala Wiki +* API Documentation in Scaladoc +* Guides, Overviews, Tutorials, Cheat Sheets and more on the docs.scala-lang.org site +* Updating Documents on the Main Scala Language Site (this one) + +Please read this page, and the pages linked from this one, fully before contributing documentation. Many of the questions you have will be answered in these resources. If you have a question that isn't answered, feel free to ask on the [scala-internals Google group](https://groups.google.com/forum/#!forum/scala-internals) and then, please, submit a pull request with updated documentation reflecting that answer. + +**General requirements** for documentation submissions include spell-checking all written language, ensuring code samples compile and run correctly, correct grammar, and clean formatting/layout of the documentation. + +Thanks + +### Examples/Tutorials in Activator Templates + +[Typesafe Activator](https://typesafe.com/community/core-tools/activator-and-sbt) +is a tool based on SBT, with a UI mode that is ideal for code based tutorials, overviews and walk-throughs. To contribute an example in activator, you can fork an existing template, edit it, add a tutorial, upload it to github and then submit the github project into the template repository. It's the fastest way to produce a working code example with tutorial. + +Please see [Contributing an Activator Template](https://typesafe.com/activator/template/contribute) for more details. + +### API Documentation (Scaladoc) + +The Scala API documentation lives with the scala project source code. There are many ways you can help with improving Scaladoc, including: + +* [Log issues for missing scaladoc documentation](./scala-standard-library-api-documentation.html#contribute-api-documentation-bug-reports) - +Please *follow the issue submission process closely* to help prevent duplicate issues being created. +* [Claim Scaladoc Issues and Provide Documentation](./scala-standard-library-api-documentation.html) - please claim issues prior to working on a specific scaladoc task to prevent duplication of effort. If you sit on an issue for too long without submitting a pull request, it will revert back to unassigned and you will need to re-claim it. +* You can also just +[submit new Scaladoc](./scala-standard-library-api-documentation.html) +without creating an issue, but please look to see if there is an issue already submitted for your task and claim it if there is. If not, please post your intention to work on a specific scaladoc task on scala-internals so that people know what you are doing. + +### The Scala Wiki + +The [Scala wiki](https://wiki.scala-lang.org/) could be a useful resource, but tends to get out of date quickly. It is perhaps best viewed as a place for information to temporarily live while it is constructed and refined, but with an aim to putting the material into the [docs.scala-lang.org](http://docs.scala-lang.org) site eventually (see the next section). Nonetheless, it is a fast way to add some public documentation. + +The wiki is self documenting, so make sure to take a look at the [home page](https://wiki.scala-lang.org/) to get started. Please consider contributions to [docs.scala-lang.org](docs.scala-lang.org) for more enduring documentation, even though it is more work to get through the review process for the main doc site. + +### The Main Scala Documentation Site + +[docs.scala-lang.org](https://wiki.scala-lang.org/) houses the primary source of written, non-API documentation for Scala. It's a github project that you can fork and submit pull requests from. It includes: + +* Overviews +* Tutorials +* Conversion Guides from Other Languages +* Cheat Sheets +* A Glossary +* The Scala Style Guide +* The Scala Language Specification +* SIP (Scala Improvement Process) Proposals +and more + +Please read [contributing to the docs.scala-lang.org site](http://docs.scala-lang.org/contribute.html) through before embarking on changes. The site uses +the [Jekyll](http://jekyllrb.com/) markdown engine so you will need to follow the instructions to get that running as well. + +### The Scala Language Site + +Additional high-level documentation (including documentation on contributing +to Scala and related projects) is provided on the main +[Scala Language site](http://scala-lang.org), and is also kept in the +[scala-lang github project](https://github.com/scala/scala-lang) which may be forked to create pull requests. + +Please read both the +[docs.scala-lang.org contribution](http://docs.scala-lang.org/contribute.html) document and the scala-lang.org github README file before embarking on any changes to the Scala language site, as it uses the same Jekyll markdown tool and many of the same conventions as the Scala documentation site. + diff --git a/contribute/guide.md b/contribute/guide.md index 9446e6ce9c..809c6558d5 100644 --- a/contribute/guide.md +++ b/contribute/guide.md @@ -1,5 +1,5 @@ --- -layout: page-full-width +layout: page title: Contributing guide --- @@ -13,10 +13,6 @@ title: Contributing guide

    Report an issue

    File a bug report or a feature request.

    -
    -

    Documentation

    -

    Improve the documentation itself.

    -
    @@ -28,10 +24,6 @@ title: Contributing guide

    Hacker's guide

    Learn to write good code and improve your chances of contributing to the Scala galaxy.

    -
    -

    Hall of Fame

    -

    Track your rockstar status in the community.

    -