blob: 54244fad0c5c38af3e81f4aa1a33677bc8ff1b25 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
# Fortran Package Manager
This is the repository of the Fortran Package Manager (fpm).
If you are looking for _fpm--packaging made simple_ instead, see
[jordansissel/fpm](https://github.com/jordansissel/fpm).
Fortran Package Manager is an early prototype.
You can use it to build and package your Fortran projects, as
well as to include supported Fortran dependency projects.
As a prototype, changes to fpm's behavior and inputs may occur as development continues.
Please follow the [issues](https://github.com/fortran-lang/fpm/issues)
to contribute and/or stay up to date with the development.
As the prototype matures and we enter production, we will do our best to stay backwards compatible.
## Getting started
### Install Haskell
To install **Haskell Stack**, follow these [instructions](https://docs.haskellstack.org/en/stable/install_and_upgrade/),
users without superuser (admin) permissions should follow the [manual installation](https://docs.haskellstack.org/en/stable/install_and_upgrade/#manual-download_2) procedure.
### Download this repository
```bash
git clone https://github.com/fortran-lang/fpm
cd fpm
```
### Build and Test fpm
Bootstrap fpm using:
```bash
cd bootstrap
stack build
```
To test:
```bash
stack test
```
To install:
```bash
stack install
```
On Linux, the above command installs `fpm` to `${HOME}/.local/bin`.
### Creating a new project
Creating a new fpm project is as simple as running the command `fpm new project_name`.
This will create a new folder in your current directory with the following contents
and initialized as a git repository.
* `fpm.toml` with your project's name and some default standard meta-data
* `README.md` with your project's name
* `.gitgnore`
* `src/project_name.f90` with a simple hello world subroutine
* `app/main.f90` (if `--with-executable` flag used) a program that calls the subroutine
* `test/main.f90` (if `--with-test` flag used) an empty test program
### Building your Fortran project with fpm
fpm understands the basic commands:
* `fpm build` - build your library, executables and tests
* `fpm run` - run executables
* `fpm test`- run tests
The command `fpm run` can optionally accept the name of the specific executable
to run, as can `fpm test`; like `fpm run specifc_executable`. Command line
arguments can also be passed to the executable(s) or test(s) with the option
`--args "some arguments"`.
See additional instructions in the [Packaging guide](PACKAGING.md).
|
