FORD


NameFORD JSON
Version 7.0.5 PyPI version JSON
download
home_page
SummaryFORD (FORtran Documenter) is an automatic documentation generator for modern Fortran programs.
upload_time2024-01-08 11:13:25
maintainer
docs_urlNone
author
requires_python>=3.8
licenseGPLv3
keywords markdown fortran documentation comments
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # FORD
[![Latest Version](https://img.shields.io/pypi/v/ford.svg)](https://pypi.python.org/pypi/FORD)
[![Latest homebrew version](https://img.shields.io/homebrew/v/ford.svg?maxAge=2592000)](http://braumeister.org/formula/ford)
[![Latest spack version](https://img.shields.io/spack/v/py-ford)](https://spack.readthedocs.io/en/latest/package_list.html#py-ford)
[![PyPI Total Downloads](https://static.pepy.tech/badge/ford)](https://pepy.tech/project/ford)
[![GitHub license](https://img.shields.io/badge/license-GPL_v3-blue.svg)](./LICENSE)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1422473.svg)](https://doi.org/10.5281/zenodo.1422473)

This is an automatic documentation generator for modern Fortran programs.
FORD stands for FORtran Documenter. As you may know, "to ford" refers to
crossing a river (or other body of water). It does not, in this context, refer
to any company or individual associated with cars.

Ford was written due to [Doxygen](http://www.doxygen.org/)'s
poor handling of Fortran and the lack of comparable alternatives.
[ROBODoc](https://rfsber.home.xs4all.nl/Robo/index.html) can't actually extract
any information from the source code and just about any other automatic
documentation software I found was either proprietary, didn't work very well
for Fortran, or was limited in terms of how it produced its output.
[f90doc](http://erikdemaine.org/software/f90doc/) is quite good and I managed
to modify it so that it could handle most of Fortran 2003, but it produces
rather ugly documentation, can't provide as many links between different parts
of the documentation as I'd like, and is written in Perl (which I'm not that
familiar with and which lacks the sort of libraries found in Python for
producing HTML content).

The goal of FORD is to be able to reliably produce documentation for modern
Fortran software which is informative and nice to look at. The documentation
should be easy to write and non-obtrusive within the code. While it will never
be as feature-rich as Doxygen, hopefully FORD will be able to provide a good
alternative for documenting Fortran projects.

## Capabilities
Current features include:

- the ability to extract information about variables, procedures, procedure
  arguments, derived types, programs, and modules from the source code.
- the ability to extract documentation from comments in the source code.
- LaTeX support in documentation using [MathJax](https://www.mathjax.org/).
- searchable documentation, using [Tipue Search](http://www.tipue.com/search/).
- author description and social media (including Github!) links.
- links to download the source code.
- links to individual files, both in their raw form or in HTML with syntax
  highlighting.
- use of Markdown to type-set documentation.
- links between related parts of the software.
- Bootstrap CSS for the documentation, making it both functional and pretty.
- configurable settings.
- ability to create a hierarchical set of pages containing general information,
  not associated with any particular part of the source code.
- display an entry for non-Fortran source files with file-level documentation
  and syntax highlighted code.

## Installation

The simplest way to install FORD is using [pip](https://pip.pypa.io/en/latest/):

    pip install ford

Pip will automatically handle all dependencies for you. By default this will
place `ford` in `~/.local/bin` -- you might need to add this to your `PATH`.

Alternatively, FORD is available through the [Homebrew](https://brew.sh) package
manager for Mac OS X. To update Homebrew and install FORD, run these commands in
a terminal:

    brew update
    brew install FORD

If you would like to install the latest development (master) branch from github,
simply add the `--HEAD` flag: `brew install --HEAD FORD`

FORD is also available through the
[spack](https://spack.readthedocs.io/en/latest/) package manager by running the
following command:

    spack install py-ford

## Documentation
More complete documentation can be found in the [docs](https://forddocs.readthedocs.io).

## License
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but **without any warrenty**; without even the implied warranty of
**merchantability** or **fitness for a particular purpose**.  See the
GNU General Public License for more details.

You should have received a [copy](./LICENSE) of the GNU General Public License
along with this program.  If not, see the [GNU website](https://www.gnu.org/licenses/gpl.html).

Documents produced by FORD are derivative works derived from the input used in their production;
they are not affected by this license.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "FORD",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "Markdown,Fortran,documentation,comments",
    "author": "",
    "author_email": "Chris MacMackin <cmacmackin@gmail.com>, Peter Hill <peter.hill@york.ac.uk>",
    "download_url": "https://files.pythonhosted.org/packages/af/44/6c9f14e5560a95fd5b77009770be7437fad4bc142e39cc34ada49e4c758a/FORD-7.0.5.tar.gz",
    "platform": null,
    "description": "# FORD\n[![Latest Version](https://img.shields.io/pypi/v/ford.svg)](https://pypi.python.org/pypi/FORD)\n[![Latest homebrew version](https://img.shields.io/homebrew/v/ford.svg?maxAge=2592000)](http://braumeister.org/formula/ford)\n[![Latest spack version](https://img.shields.io/spack/v/py-ford)](https://spack.readthedocs.io/en/latest/package_list.html#py-ford)\n[![PyPI Total Downloads](https://static.pepy.tech/badge/ford)](https://pepy.tech/project/ford)\n[![GitHub license](https://img.shields.io/badge/license-GPL_v3-blue.svg)](./LICENSE)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1422473.svg)](https://doi.org/10.5281/zenodo.1422473)\n\nThis is an automatic documentation generator for modern Fortran programs.\nFORD stands for FORtran Documenter. As you may know, \"to ford\" refers to\ncrossing a river (or other body of water). It does not, in this context, refer\nto any company or individual associated with cars.\n\nFord was written due to [Doxygen](http://www.doxygen.org/)'s\npoor handling of Fortran and the lack of comparable alternatives.\n[ROBODoc](https://rfsber.home.xs4all.nl/Robo/index.html) can't actually extract\nany information from the source code and just about any other automatic\ndocumentation software I found was either proprietary, didn't work very well\nfor Fortran, or was limited in terms of how it produced its output.\n[f90doc](http://erikdemaine.org/software/f90doc/) is quite good and I managed\nto modify it so that it could handle most of Fortran 2003, but it produces\nrather ugly documentation, can't provide as many links between different parts\nof the documentation as I'd like, and is written in Perl (which I'm not that\nfamiliar with and which lacks the sort of libraries found in Python for\nproducing HTML content).\n\nThe goal of FORD is to be able to reliably produce documentation for modern\nFortran software which is informative and nice to look at. The documentation\nshould be easy to write and non-obtrusive within the code. While it will never\nbe as feature-rich as Doxygen, hopefully FORD will be able to provide a good\nalternative for documenting Fortran projects.\n\n## Capabilities\nCurrent features include:\n\n- the ability to extract information about variables, procedures, procedure\n  arguments, derived types, programs, and modules from the source code.\n- the ability to extract documentation from comments in the source code.\n- LaTeX support in documentation using [MathJax](https://www.mathjax.org/).\n- searchable documentation, using [Tipue Search](http://www.tipue.com/search/).\n- author description and social media (including Github!) links.\n- links to download the source code.\n- links to individual files, both in their raw form or in HTML with syntax\n  highlighting.\n- use of Markdown to type-set documentation.\n- links between related parts of the software.\n- Bootstrap CSS for the documentation, making it both functional and pretty.\n- configurable settings.\n- ability to create a hierarchical set of pages containing general information,\n  not associated with any particular part of the source code.\n- display an entry for non-Fortran source files with file-level documentation\n  and syntax highlighted code.\n\n## Installation\n\nThe simplest way to install FORD is using [pip](https://pip.pypa.io/en/latest/):\n\n    pip install ford\n\nPip will automatically handle all dependencies for you. By default this will\nplace `ford` in `~/.local/bin` -- you might need to add this to your `PATH`.\n\nAlternatively, FORD is available through the [Homebrew](https://brew.sh) package\nmanager for Mac OS X. To update Homebrew and install FORD, run these commands in\na terminal:\n\n    brew update\n    brew install FORD\n\nIf you would like to install the latest development (master) branch from github,\nsimply add the `--HEAD` flag: `brew install --HEAD FORD`\n\nFORD is also available through the\n[spack](https://spack.readthedocs.io/en/latest/) package manager by running the\nfollowing command:\n\n    spack install py-ford\n\n## Documentation\nMore complete documentation can be found in the [docs](https://forddocs.readthedocs.io).\n\n## License\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut **without any warrenty**; without even the implied warranty of\n**merchantability** or **fitness for a particular purpose**.  See the\nGNU General Public License for more details.\n\nYou should have received a [copy](./LICENSE) of the GNU General Public License\nalong with this program.  If not, see the [GNU website](https://www.gnu.org/licenses/gpl.html).\n\nDocuments produced by FORD are derivative works derived from the input used in their production;\nthey are not affected by this license.\n",
    "bugtrack_url": null,
    "license": "GPLv3",
    "summary": "FORD (FORtran Documenter) is an automatic documentation generator for modern Fortran programs.",
    "version": "7.0.5",
    "project_urls": {
        "Documentation": "https://forddocs.readthedocs.io/en/latest/",
        "Source": "https://github.com/Fortran-FOSS-Programmers/ford",
        "Tracker": "https://github.com/Fortran-FOSS-Programmers/ford/issues"
    },
    "split_keywords": [
        "markdown",
        "fortran",
        "documentation",
        "comments"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "444e1f7c0e197d8d5815c94a41c7eabf899f4eab3deb5f3ceee24a4658eb3230",
                "md5": "0d002747a38469981a017e9593fbe7ce",
                "sha256": "4986d4720fc2ba55e92725c1a7785ac9ac4f764977e7a3bf0d12aaa76bef8560"
            },
            "downloads": -1,
            "filename": "FORD-7.0.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0d002747a38469981a017e9593fbe7ce",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 595086,
            "upload_time": "2024-01-08T11:13:21",
            "upload_time_iso_8601": "2024-01-08T11:13:21.210626Z",
            "url": "https://files.pythonhosted.org/packages/44/4e/1f7c0e197d8d5815c94a41c7eabf899f4eab3deb5f3ceee24a4658eb3230/FORD-7.0.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "af446c9f14e5560a95fd5b77009770be7437fad4bc142e39cc34ada49e4c758a",
                "md5": "de28ea067ea2beadd07e99e7bea2ddd6",
                "sha256": "9c6f07acc8f01534f2b14d1b08265a4f36f93d44dd872eb60adfe5c83de36307"
            },
            "downloads": -1,
            "filename": "FORD-7.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "de28ea067ea2beadd07e99e7bea2ddd6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 6091408,
            "upload_time": "2024-01-08T11:13:25",
            "upload_time_iso_8601": "2024-01-08T11:13:25.060191Z",
            "url": "https://files.pythonhosted.org/packages/af/44/6c9f14e5560a95fd5b77009770be7437fad4bc142e39cc34ada49e4c758a/FORD-7.0.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-08 11:13:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Fortran-FOSS-Programmers",
    "github_project": "ford",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "ford"
}
        
Elapsed time: 0.16612s