Compare commits

...

3 commits

Author SHA1 Message Date
Paul ALNET
fa0b543b56 chore(vscode): add launch profile 2024-03-25 08:45:28 +01:00
Paul ALNET
5ad3e28f0e chore(build): set mainClass in main pom.xml
Doesn't do anything useful because Java (see readme).
2024-03-25 08:43:51 +01:00
Paul ALNET
1677a89a05 doc(build): add instructions 2024-03-25 08:43:30 +01:00
3 changed files with 79 additions and 47 deletions

35
.vscode/launch.json vendored Normal file
View file

@ -0,0 +1,35 @@
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Current File",
"request": "launch",
"mainClass": "${file}"
},
{
"type": "java",
"name": "BinaryHeapFormatter",
"request": "launch",
"mainClass": "org.insa.graphs.algorithm.utils.BinaryHeapFormatter",
"projectName": "be-graphes-algos"
},
{
"type": "java",
"name": "MainWindow",
"request": "launch",
"mainClass": "org.insa.graphs.gui.MainWindow",
"projectName": "be-graphes-gui"
},
{
"type": "java",
"name": "Launch",
"request": "launch",
"mainClass": "org.insa.graphs.gui.simple.Launch",
"projectName": "be-graphes-gui"
}
]
}

View file

@ -1,62 +1,52 @@
# Graph & Algorithm project — INSA Toulouse
## How to start?
## Building
You will not be able to use this repository to save your work, you need to copy / import / fork it to
your favorite Git platform.
The instructions below are an attempt at using java from the command line.
These efforts were in vain (~3 man-hours + help from 2 teachers). The
"solution" was to use [VScode][vscode]. The instructions are left below for
posterity.
### Importing to [Github](https://github.com), [Bitbucket](https://bitbucket.org) or [Gitlab](https://gitlab.com):
[vscode]: https://code.visualstudio.com/docs/setup/linux
You first need to register and then log in to the platform you want. The steps to import the project are detailed below:
### Prerequisites
#### Github
This project makes use of [Maven][maven]. On a debian-like system, install Maven :
1. In the upper-right corner of any page, click the **"+"** icon, then click **Import repository**, or go to [https://github.com/new/import](https://github.com/new/import).
2. Paste the following URL in the first input:
[https://gitea.typename.fr/INSA/be-graphes.git](https://gitea.typename.fr/INSA/be-graphes.git)
3. Choose the name you want for the repository.
4. Click *Begin import*.
5. Wait for completion... Done!
```
sudo apt-get install maven
```
#### Bitbucket
[maven]: https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html
1. On the left panel of any page, click the **"+"** icon, then **Repository**, and then **Import**, or directly go to [https://bitbucket.org/repo/import](https://bitbucket.org/repo/import).
2. Paste the following URL in the first input (select Git as source if not already selected):
[https://gitea.typename.fr/INSA/be-graphes.git](https://gitea.typename.fr/INSA/be-graphes.git)
3. Choose the name you want for repository, and select Git as the *Version control system*.
4. Click *Import repository*.
5. Wait for completion... Done!
### Compiling
#### Gitlab
In the project root directory :
1. In the upper-right corner of any page, click the **"+"** icon, then **New project**, or directly go to [https://gitlab.com/projects/new](https://gitlab.com/projects/new).
2. Select the **Import project** tab, and then click **Repo by URL** (right-most option).
3. Paste the following URL in the first input:
[https://gitea.typename.fr/INSA/be-graphes.git](https://gitea.typename.fr/INSA/be-graphes.git)
4. Choose the name you want for the repository.
5. Click *Create project*.
6. Wait for completion... Done!
```
mvn compile
```
### Importing to another repository provider:
### Packaging
1. Create a new **empty** repository (no README, no LICENSE) on your provider. Let's assume the URL of your repository is `$URL_REPOSITORY`.
2. Clone this repository somewhere:
In the project root directory :
```bash
git clone https://gitea.typename.fr/INSA/be-graphes.git
```
3. Go inside the newly cloned repository and update the **remote**:
```bash
cd be-graphes
git remote set-url origin $URL_REPOSITORY
```
4. Push to your repository:
```
mvn package
```
```bash
push -u origin master
```
Another way is to do a bare clone and then mirror it to your repository: [https://help.github.com/articles/importing-a-git-repository-using-the-command-line/](https://help.github.com/articles/importing-a-git-repository-using-the-command-line/)
Or skip tests :
```
mvn package -Dmaven.test.skip=true
```
The output jar files will be in the `<project>/target/` directory of each project.
### Testing
In the root directory, start all tests :
```
mvn test
```

View file

@ -26,6 +26,13 @@
<configuration>
<source>${jdk.version}</source>
<target>${jdk.version}</target>
<archive>
<manifest>
<addClasspath>true</addClasspath>
<!-- here we specify that we want to use the main method within the App class -->
<mainClass>org.insa.graphs.gui.MainWindow</mainClass>
</manifest>
</archive>
</configuration>
</plugin>
</plugins>