-
Notifications
You must be signed in to change notification settings - Fork 24
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add JavaScript for tabbed sections in the Drivers Manual
- Loading branch information
1 parent
40f6763
commit 49dd17f
Showing
4 changed files
with
459 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,248 @@ | ||
= Tabbed sections in Drivers Manual | ||
|
||
Up to Neo4j 4.1 the Drivers Manual includes tabs to allow users to choose with driver language sections to display. | ||
From 4.2 on, the Drivers Manual is split into a separate manual per language. | ||
|
||
== Example drivers manual content | ||
|
||
.Acquire the driver | ||
[.tabbed-example] | ||
==== | ||
[.include-with-dotnet] | ||
====== | ||
|
||
The .NET driver is distributed via the NuGet Gallery. | ||
To find the latest version of the driver, visit https://www.nuget.org/packages/Neo4j.Driver/. | ||
|
||
*Dependencies* | ||
|
||
* .NETStandard (^2.0) | ||
* System.Net.NameResolution (^4.3.0) | ||
* System.Net.Security (^4.3.2) | ||
* System.Net.Sockets (^4.3.0) | ||
* System.Runtime.InteropServices.RuntimeInformation (^4.3.0) | ||
* System.Runtime.Serialization.Primitives (^4.3.0) | ||
* System.Threading.Thread (^4.3.0) | ||
* System.ValueTuple (^4.5.0) | ||
|
||
The .NET Reactive API is under package `Neo4j.Driver.Reactive`. | ||
It is built upon https://github.com/dotnet/reactive[`System.Reactive`]. | ||
There is no extra dependency required use .NET reactive API. | ||
|
||
.Installation via Install-package | ||
======== | ||
To install the latest version of the driver using NuGet in Visual Studio: | ||
[source, csharp, subs="attributes, specialcharacters"] | ||
---- | ||
PM> Install-Package Neo4j.Driver | ||
---- | ||
It is also an option to install a certain version of the driver. | ||
[source, csharp, subs="attributes, specialcharacters"] | ||
---- | ||
PM> Install-Package Neo4j.Driver -Version $DOTNET_DRIVER_VERSION | ||
---- | ||
The .Net driver uses asynchronous methods by default. | ||
If you want to use blocking calls, the `Neo4j.Driver.Simple` NuGet package contains a set of extensions. | ||
This can be found at https://www.nuget.org/packages/Neo4j.Driver.Simple/. | ||
The initial examples make use of these extensions. | ||
In the following example we are installing driver version {dotnet-driver-version}. | ||
[source, csharp, subs="attributes, specialcharacters"] | ||
---- | ||
PM> Install-Package Neo4j.Driver -Version {dotnet-driver-version} | ||
---- | ||
======== | ||
|
||
The release notes for this driver are available https://github.com/neo4j/neo4j-dotnet-driver/releases[here]. | ||
|
||
====== | ||
[.include-with-go] | ||
====== | ||
|
||
To find out the latest version of the driver, visit https://github.com/neo4j/neo4j-go-driver/releases | ||
|
||
======== | ||
To install the latest version of the driver using `go get`: | ||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
go get github.com/neo4j/neo4j-go-driver/v4@<latest tag> | ||
---- | ||
Note that this requires that Go modules are enabled. | ||
======== | ||
|
||
====== | ||
[.include-with-java] | ||
====== | ||
|
||
To use the Java driver, it is recommended employing a dependency manager, such as Maven or Gradle. | ||
To find the latest version of the driver, visit the https://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.neo4j.driver%22%20AND%20a%3A%22neo4j-java-driver%22[Maven Central Repository]. | ||
|
||
*Dependencies* | ||
|
||
* org.reactivestreams:reactive-streams | ||
* org.apache.logging.log4j:log4j (optional) | ||
|
||
The driver is dependent on the https://www.reactive-streams.org/[Reactive Streams API], thus maintaining JDK 8 compatibility. | ||
To make optimal use of the reactive APIs, we suggest an additional framework like Project Reactor or RxJava2. | ||
Both implement the Reactive Streams API and provide an exhaustive set of operators. | ||
|
||
|
||
.Installation via Maven | ||
======== | ||
When using Maven, add the following block to the _pom.xml_ file. | ||
The driver version can either be declared as a property (as in the first example) or as an explicit version number (as in the second). | ||
[source, xml, subs="attributes, specialcharacters"] | ||
---- | ||
<dependencies> | ||
<dependency> | ||
<groupId>org.neo4j.driver</groupId> | ||
<artifactId>neo4j-java-driver</artifactId> | ||
<version>$JAVA_DRIVER_VERSION</version> | ||
</dependency> | ||
</dependencies> | ||
---- | ||
In the following example, driver version {java-driver-version} is added. | ||
[source, xml, subs="attributes, specialcharacters"] | ||
---- | ||
<dependencies> | ||
<dependency> | ||
<groupId>org.neo4j.driver</groupId> | ||
<artifactId>neo4j-java-driver</artifactId> | ||
<version>{java-driver-version}</version> | ||
</dependency> | ||
</dependencies> | ||
---- | ||
======== | ||
|
||
.Installation via Gradle | ||
======== | ||
For Gradle, a compile line will be required. Again, this can use a property or an explicit version number. | ||
[source, groovy, subs="attributes, specialcharacters"] | ||
---- | ||
compile 'org.neo4j.driver:neo4j-java-driver:$JAVA_DRIVER_VERSION' | ||
---- | ||
In the following example, a driver version {java-driver-version} is added. | ||
[source, groovy, subs="attributes, specialcharacters"] | ||
---- | ||
compile 'org.neo4j.driver:neo4j-java-driver:{java-driver-version}' | ||
---- | ||
======== | ||
|
||
The release notes for this driver are available https://github.com/neo4j/neo4j-java-driver/wiki[here]. | ||
|
||
====== | ||
[.include-with-javascript] | ||
====== | ||
|
||
To use the JavaScript driver, it is recommended employing `npm`. | ||
To find the latest version of the driver, use: | ||
|
||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
npm show neo4j-driver@* version | ||
---- | ||
|
||
*Dependencies* | ||
|
||
* Babel/Runtime (^7.5.5) | ||
* RxJS (^6.5.2) | ||
* text-encoding-utf-8 (^1.0.2) | ||
* URI-js (^4.2.2) | ||
|
||
|
||
The JavaScript Reactive API is built and exposed via RxJs. | ||
A dependency of RxJs is automatically installed with the driver. | ||
|
||
.Installation via npm | ||
======== | ||
To install the latest version of the driver: | ||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
npm install neo4j-driver | ||
---- | ||
It is also an option to install a certain version of the driver. | ||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
npm install neo4j-driver@$JAVASCRIPT-DRIVER-VERSION | ||
---- | ||
In the following example, driver version {javascript-driver-version} is installed. | ||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
npm install neo4j-driver@{javascript-driver-version} | ||
---- | ||
======== | ||
|
||
The release notes for this driver are available https://github.com/neo4j/neo4j-javascript-driver/wiki[here]. | ||
|
||
====== | ||
[.include-with-python] | ||
====== | ||
|
||
To find the latest stable version of the Python Driver, visit https://pypi.org/project/neo4j/ | ||
|
||
To find a list of all available releases, visit https://pypi.org/simple/neo4j/ | ||
|
||
To install the latest stable version of the Python Driver: | ||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
pip install neo4j | ||
---- | ||
|
||
It is also an option to install a certain version of the driver. | ||
|
||
.Installation with Python | ||
======== | ||
The following is the syntax for installing a certain version of the Python Driver: | ||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
pip install neo4j==$PYTHON_DRIVER_VERSION | ||
---- | ||
In the following example we are installing Python Driver version {python-driver-version}. | ||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
pip install neo4j=={python-driver-version} | ||
---- | ||
======== | ||
|
||
.Installation with Python, get Python Driver prerelease | ||
======== | ||
In the following example we get the latest prerelease version: | ||
[source, shell, subs="attributes, specialcharacters"] | ||
---- | ||
pip install neo4 --pre | ||
---- | ||
======== | ||
|
||
The release notes for the Python Driver are available https://github.com/neo4j/neo4j-python-driver/wiki[here] | ||
|
||
====== | ||
==== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.