Grakn Console 2.0.0-alpha-3

New Features

Bugs Fixed

Code Refactors

Other Improvements

Grakn Console 2.0.0-alpha-2

New Features

Bugs Fixed

Code Refactors

Other Improvements

• Fix console warnings caused by out of date dependency
  Fix WARNING: An illegal reflective access operation has occurred warning caused by an out of date version of protobuf.

• Add Grakn Cluster support
  We have added Grakn Cluster support. A user can connect to a cluster of Grakn Cluster instances using the --cluster flag:

  ./grakn console --cluster 172.0.01:1729
  

• Show the number of answers printed and the duration of a query
  We added statistic information to the UI about how many answers were printed and how long did the query take.

• Improve type safety by restricting type casting
  We've improved the type safety of the code by restricting type casting. To be consistent with a single pattern of performing dynamic casting, we convert all usage of instanceof to isX() and asX().

• Allow pasting multiline input
  Allow user to paste multiline input to console and edit as one unit.

• Fix console exitting when trying to open transaction to a database that doesn't exist
  We have fixed an issue that caused console to exit when trying to open transaction to a database that doesn't exist.

Grakn Console 2.0.0-alpha

Install & Run: http://dev.docs.grakn.ai/docs/running-grakn/install-and-run

---

New Grakn Console: powered by PicoCLI

We've also rebuilt the Grakn Console using PicoCLI, which provides much more expressive CLI utilities, allowing us to build a richer and user-friendly console environment for Grakn. This change sets up the ecosystem for us to continue extending our Grakn Console with new features in a cohesive and backwards-compatible way.

The new Grakn Console provides two levels of interaction: database-level and transaction-level interfaces. The database-level interface is the first level of interaction, i.e. first-level REPL. From one of the database-level commands, you can open a transaction to the database. This will open a transaction-level interface, i.e. second-level REPL.

Please refer to full release notes of Grakn 2.0.0-alpha to see the changes in Grakn 2.0.0.

---

Running Grakn Console in the terminal

Go to the directory when you have your grakn-core-all or grakn-core-console distribution unarchived, and run ./grakn console

cd <your_grakn_console_dir>/
./grakn console

Command line arguments

You can provide several command arguments when running console in the terminal.

• --server=<address> : Server address to which the console will connect to.
• -V, --version : Print version information and exit.
• -h, --help : Show help message.

Console commands

Grakn Console provides two levels of interaction: database-level commands and transaction-level commands. The database-level command is the first level of interaction, i.e. first-level REPL. From one of the database-level commands, you can open a transaction to the database. This will open a transaction-level interface, i.e. second-level REPL.

Database-level commands

• database create <db> : Create a database with name <db> on the server. For example:

  > database create my-grakn-database
  Database 'my-grakn-database' created
  

• database list : List the databases on the server. For example:

  > database list
  my-grakn-database
  

• database delete <db> : Delete a database with name <db> on the server. For example:

  > database delete my-grakn-database
  Database 'my-grakn-database' deleted
  

• transaction <db> schema|data read|write : Start a transaction to database <db> with session type schema or data, and transaction type write or read. For example:

  > transaction my-grakn-database schema write
  my-grakn-database::schema::write>
  

  This will then take you to the transaction-level interface, i.e. the second-level REPL.
• help : Print help menu
• clear : Clear console screen
• exit : Exit console

Transaction-level commands

• <query> : Once you're in the transaction REPL, the terminal immediately accepts a multi-line Graql query, and will execute it when you hit enter twice. For example:

  my-grakn-database::schema::write> define
                                    name sub attribute, value string;
                                    person sub entity, owns name;
  
  Concepts have been defined
  

• source <file> : Run Graql queries in a file, which you can refer to using relative or absolute path. For example:

  my-grakn-database::schema::write> source ./schema.gql
  Concepts have been defined
  

• commit : Commit the transaction changes and close transaction. For example:

  my-grakn-database::schema::write> commit
  Transaction changes committed
  

• rollback : Will remove any uncommitted changes you've made in the transaction, while leaving transaction open. For example:

  my-grakn-database::schema::write> rollback
  Rolled back to the beginning of the transaction
  

• close : Close the transaction without committing changes, and takes you back to the database-level interface, i.e. first-level REPL. For example:

  my-grakn-database::schema::write> close
  Transaction closed without committing changes
  

• help : Print this help menu
• clear : Clear console screen
• exit : Exit console

Grakn Console 1.0.8

New Features

Bugs Fixed

Code Refactors

• Utilise release-validate-deps rule instead of script.
  Utilise release-validate-deps rule instead of script.

• Update RBE credential location.

Other Improvements

• Use common 0.2.4 and bump VERSION to 1.0.8 for release.
  Use newly released 0.2.4 common which released the grakn-bin binaries

• bump dependencies to released tag and bump VERSION.
  Bump dependencies to released tag

Grakn Console 1.0.7

New Features

Bugs Fixed

Code Refactors

Other Improvements

• fix deps for release and bump VERSION.
  Fix deps for release to release tags and bump VERSION.

• Depend on testing via grakn core artifact.
  Change console to depend on Grakn core artifact for testing.

• Test building with updated @graknlabs_dependencies.
  Update @graknlabs_dependencies to latest version

• Integrate building with BuildBuddy.
  Migrate from RBE to BuildBuddy

• Declare most dependencies using maven() rule.
  Declare most dependencies using maven rule from @graknlabs_dependencies

• Fix CI by updating client-java.
  Fix CI by updating client-java

• Add deploy-console-distribution.
  As part of our move away from building artefacts from other repos using bazel source (which causes subtly different artefacts to be built from the ones that were testing within that repo), we need to add deploy steps to repos that build artefacts that can be depended on.
  We are adding a deploy rule to console to deploy the /console sub-directory of the distribution, complete with logback.xml.

• Depend on @graknlabs_dependencies.
  Console now uses dependencies that are declared in graknlabs_dependencies

• Add console-deps deployment to repo as archive.
  Grakn core depends on console in order to create an "all" release package, however, it currently builds console from source (via bazel) which means we have two "releases" of console, one in this repo and one in the grakn repo, and they can have different sets of dependencies. This could cause any number of problems, not least being that tests run in this repo do not necessarily reflect the correctness of console in grakn. It also causes problems for us locally when using bazel to develop locally, because external workspaces imported in our own repo can leak into console unintended.
  In order to fix this "artifact drift" we need to move to a "single true artifact" pattern. Currently, this artifact will only be console-deps, which does not include configuration (only logback.xml right now). At some point, we should move to the full console release being the distributed artifact and combined into the grakn "all" release.

Grakn Console 1.0.6

New Features

Bugs Fixed

Code Refactors

• Update to 1.8 dependencies.
  We upgrade console to use the latest grakn core and client-java dependencies, resolving their own build issues induced by circular dependencies.

Other Improvements

• Remove extra logback inclusion.
  Starting console from April 2020 onwards resulted in verbose startup logging. This was due to an extra logback file being included in the JAR, which we remove again.

• Migrate load relative path file in and bump deps.
  typedb/typedb#5043 as a part of refactoring test packages in core, we move one end-to-end test into console as it should not have been tested in core.
  Bump dependencies of core, protocol, client-java, build-tools. Significant change includes using value instead of datatype.

Grakn Console 1.0.5

Bugs Fixed

• Disable excessive logging

  We accidentally enabled logging at the info level, causing excessing logging. This has been properly disabled in this release.

Other Improvements

• Use new 1.7 client-java improvements

  Update console to use the improvements coming in the 1.7 release of client-java.

Grakn Console 1.0.4

New Features

• Add ability to list and delete keyspaces from console.
  List, Delete existing keyspaces from console. Previously we had to spin up an interactive python console or something similar to see what keyspaces even exist in a distribution, let alone delete them.
  To access the new commands, we would run in any console session:

  grakn> keyspace list
  

  which should print the list of keyspaces on the grakn distribution the console is connected to.
  Similarly, we can do:

  grakn> keyspace delete somekeyspace
  Successfully deleted somekeyspace
  

Bugs Fixed

Code Refactors

Other Improvements

• Upgrade to Bazel 3.0.0.
  Upgrade Bazel to latest upstream version

• Update copyright headers to 2020.
  In order for build not to break after typedb/typedb-dependencies#122, copyright headers need to be updated.

Grakn Console 1.0.3

New Features

Bugs Fixed

Code Refactors

Other Improvements

• Update gRPC to 1.24.1
  Bump @graknlabs_build_tools and @graknlabs_protocol versions
  Upgrade gRPC Maven dependencies to 1.24.1; add grpc-api
  Update targets to depend on grpc-api

Grakn Console 1.0.2

New Features

Bugs Fixed

• Make history file optional.
  Fix #7
  Previously, Grakn Console would crash in case history file could not be created (possible reasons are user's home directory being non-present or mounted read-only)

• Remove Grakn Core Concept dependency.

• Reflect Client/Server API and Concept split.
  Since the split of client-java and server's interfaces to use grakn.core.concept versus grakn.client.concept various classes in console have to be refactored. Also enables GraknConsoleIT for grakn console.

Code Refactors

• New Delete Behavior.

• Refactor how version is provided to deployment rules.
  Adapt @graknlabs_console to latest changes in bazel-distribution (in particular, typedb/bazel-distribution#150)

Other Improvements

• We've updated graql, common and protocol which are depended by client-java.

• Upgrade protocol and add README.