-
-
Notifications
You must be signed in to change notification settings - Fork 1
Change name from Catacript to GatOS #70
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
929f002
1195008
3d2e2f1
d620092
204b710
76ef47a
47d9436
caff0db
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||
|---|---|---|---|---|---|---|---|---|
|
|
@@ -71,7 +71,7 @@ import cats.effect.{IO, IOApp} | |||||||
|
|
||||||||
| import fs2.io.file.Path | ||||||||
|
|
||||||||
|
||||||||
| import org.typelevel.gatos |
Copilot
AI
Apr 28, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This mdoc:reset block imports gatos.Gatos, but the Gatos object is defined in package org.typelevel.gatos. Unless you explicitly import org.typelevel.gatos first (to introduce gatos as an alias), this import won’t resolve; prefer import org.typelevel.gatos.Gatos (or import org.typelevel.gatos then gatos.Gatos).
| import gatos.Gatos | |
| import org.typelevel.gatos.Gatos |
Copilot
AI
Apr 28, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This mdoc example uses import gatos.syntax.path.*, but gatos isn’t a top-level package in this repo; the syntax package is under org.typelevel.gatos.syntax.path. With mdoc:reset this block won’t compile unless you first introduce gatos via import org.typelevel.gatos (or just use fully-qualified imports).
| import gatos.syntax.path.* | |
| import org.typelevel.gatos.syntax.path.* |
Copilot
AI
Apr 28, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
import gatos.syntax.Gatos doesn’t match the project’s package layout (there’s no syntax.Gatos), so this snippet should not compile. Update the import to refer to the actual Gatos object under org.typelevel.gatos (or add the org.typelevel.gatos alias and then import/use gatos.Gatos).
| import gatos.syntax.Gatos | |
| import org.typelevel.gatos.Gatos |
Copilot
AI
Apr 28, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same issue here: import gatos.syntax.path.* relies on a gatos package that doesn’t exist at the root. To keep the mdoc snippet compiling, switch to org.typelevel.gatos.syntax.path.* or add import org.typelevel.gatos before using the gatos prefix.
| import gatos.syntax.path.* | |
| import org.typelevel.gatos.syntax.path.* |
Copilot
AI
Apr 28, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
import gatos.syntax.Gatos is not a valid import for this project (no syntax.Gatos exists). Update this snippet to import the Gatos object from its actual package (org.typelevel.gatos) or introduce the gatos alias explicitly before importing.
| import gatos.syntax.Gatos | |
| import org.typelevel.gatos.Gatos |
| Original file line number | Diff line number | Diff line change | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| @@ -1,31 +1,31 @@ | ||||||||||
| # Catscript 😸 | ||||||||||
| # GatOS 😸 | ||||||||||
| **Making scripts in pure Scala much easier!** | ||||||||||
|
|
||||||||||
| ## Getting Started | ||||||||||
|
|
||||||||||
| You can use Catscript in a new or existing Scala 2.13.x or 3.x project by adding it to your `build.sbt` file: | ||||||||||
| You can use GatOS in a new or existing Scala 2.13.x or 3.x project by adding it to your `build.sbt` file: | ||||||||||
|
|
||||||||||
| ```scala | ||||||||||
| libraryDependencies ++= Seq( | ||||||||||
| "org.typelevel" %% "catscript" % "@VERSION@" | ||||||||||
| "org.typelevel" %% "gatos" % "@VERSION@" | ||||||||||
| ) | ||||||||||
| ``` | ||||||||||
|
|
||||||||||
| ## Example | ||||||||||
| Catscript is a library to perform common script operations such as working with processes and files while maintaining referential transparency! | ||||||||||
| GatOS is a library to perform common script operations such as working with processes and files while maintaining referential transparency! | ||||||||||
|
|
||||||||||
| ```scala 3 mdoc:reset | ||||||||||
| import cats.effect.{IO, IOApp, ExitCode} | ||||||||||
|
|
||||||||||
| import catscript.* | ||||||||||
| import catscript.syntax.path.* | ||||||||||
| import gatos.* | ||||||||||
| import gatos.syntax.path.* | ||||||||||
|
Comment on lines
+20
to
+21
|
||||||||||
| import gatos.* | |
| import gatos.syntax.path.* | |
| import org.typelevel.gatos.* | |
| import org.typelevel.gatos.syntax.path.* |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -2,20 +2,20 @@ | |
|
|
||
| ## Which API should I use? | ||
|
|
||
| In Catscript, you have two different ways of doing things: | ||
| In GatOS, you have two different ways of doing things: | ||
|
|
||
| - First, if you prefer a more concise syntax, use the extension methods (e.g. `path.read()`) by importing the `catscript.syntax.path.*` package. | ||
| - First, if you prefer a more concise syntax, use the extension methods (e.g. `path.read()`) by importing the `gatos.syntax.path.*` package. | ||
|
|
||
| - If you prefer calling static methods, use direct method calls on the `Catscript` object (e.g., `Catscript.read(path)`). You can also import all the functions inside the `catscript.Catscript` package if you don't want to call the `Catscript` object every time (e.g., `read(path)`). | ||
| - If you prefer calling static methods, use direct method calls on the `Gatos` object (e.g., `Gatos.read(path)`). You can also import all the functions inside the `gatos.Gatos` package if you don't want to call the `Gatos` object every time (e.g., `read(path)`). | ||
|
|
||
| In this documentation we'll call the methods on the `Catscript` objects in the static variant to differentiate them from the extension ones. | ||
| In this documentation we'll call the methods on the `Gatos` objects in the static variant to differentiate them from the extension ones. | ||
|
|
||
| @:select(api-style) | ||
|
|
||
| @:choice(syntax) | ||
|
|
||
| ```scala 3 | ||
| import catscript.syntax.all.* | ||
| import gatos.syntax.all.* | ||
|
|
||
| val path = Path("data/test.txt") | ||
|
Comment on lines
17
to
20
|
||
|
|
||
|
|
@@ -28,13 +28,13 @@ yield () | |
| @:choice(static) | ||
|
|
||
| ```scala 3 | ||
| import catscript.Catscript | ||
| import gatos.Gatos | ||
|
|
||
| val path = Path("data/test.txt") | ||
|
Comment on lines
30
to
33
|
||
|
|
||
| for | ||
| file <- Catscript.read(path) | ||
| _ <- Catscript.append(path, "I'll place this here.") | ||
| file <- Gatos.read(path) | ||
| _ <- Gatos.append(path, "I'll place this here.") | ||
| yield () | ||
| ``` | ||
|
|
||
|
|
@@ -44,11 +44,11 @@ Which one you should use really depends on your preferences and choices; if you | |
|
|
||
| ## Imports | ||
|
|
||
| If you just want to start scripting right away, importing `catscript.*` will do the trick; it imports all the extension methods and functionality you need, such as types and functions, to start working right away. | ||
| If you just want to start scripting right away, importing `gatos.*` will do the trick; it imports all the extension methods and functionality you need, such as types and functions, to start working right away. | ||
|
|
||
| But if you want more concise functionality, the `catscript.syntax.path.*` will only import the extension methods. | ||
| But if you want more concise functionality, the `gatos.syntax.path.*` will only import the extension methods. | ||
|
|
||
| For the static methods, the `catscript.Catscript` will provide the functions to work with files, if that is your preferred style. | ||
| For the static methods, the `gatos.Gatos` will provide the functions to work with files, if that is your preferred style. | ||
|
Comment on lines
45
to
+51
|
||
|
|
||
|
|
||
| ## Talking about computations | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The mdoc example imports
gatos.*/gatos.syntax.path.*, but there is no top-levelgatospackage in this repo (library code is underorg.typelevel.gatos). This will make the snippet fail to compile during docs/README generation; switch to fully-qualified imports (e.g.,org.typelevel.gatos...) or add an explicitimport org.typelevel.gatosalias before using thegatosprefix.