compact-authors flag, update docs (close #301)

Rename `--no-spaced-initials` (-N) to `--compact-authors` (-a)
for clarity. Remove `--web-logs` flag. Rename `FlatOutput()`
method to `WithFlatOutput()`.

Update CITATION.cff

Author: dimus

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## [v1.14.1] - 2026-01-14 Wed
+
+* Add[#301]: rename 'initials' flag to 'compact-authors'.
+  **WARNING** this creates backward incompatibility (only for v1.14.0).
+* Add: normalize 'flatten' flag.
+* Add: remove useless web-log flag.
+
 ## [v1.14.0] - 2026-01-12 Mon
 
 * Add[#292]: add flattened option for JSON output, add more (optional) details
@@ -577,6 +584,7 @@
 
 This document follows [changelog guidelines]
 
+[v1.14.1]: https://github.com/gnames/gnparser/compare/v1.14.0...v1.14.1
 [v1.14.0]: https://github.com/gnames/gnparser/compare/v1.13.0...v1.14.0
 [v1.13.0]: https://github.com/gnames/gnparser/compare/v1.12.1...v1.13.0
 [v1.12.1]: https://github.com/gnames/gnparser/compare/v1.12.0...v1.12.1
@@ -668,6 +676,16 @@ This document follows [changelog guidelines]
 [v0.7.0]: https://github.com/gnames/gnparser/compare/v0.6.0...v0.7.0
 [v0.6.0]: https://github.com/gnames/gnparser/compare/v0.5.1...v0.6.0
 [v0.5.1]: https://github.com/gnames/gnparser/tree/v0.5.1
+[#310]: https://github.com/gnames/gnparser/issues/310
+[#309]: https://github.com/gnames/gnparser/issues/309
+[#308]: https://github.com/gnames/gnparser/issues/308
+[#307]: https://github.com/gnames/gnparser/issues/307
+[#306]: https://github.com/gnames/gnparser/issues/306
+[#305]: https://github.com/gnames/gnparser/issues/305
+[#304]: https://github.com/gnames/gnparser/issues/304
+[#303]: https://github.com/gnames/gnparser/issues/303
+[#302]: https://github.com/gnames/gnparser/issues/302
+[#301]: https://github.com/gnames/gnparser/issues/301
 [#300]: https://github.com/gnames/gnparser/issues/300
 [#299]: https://github.com/gnames/gnparser/issues/299
 [#298]: https://github.com/gnames/gnparser/issues/298

CITATION.cff

@@ -1,17 +1,23 @@
 cff-version: 1.2.0
 message: "If you use this software, please cite it as below."
 title: "GNparser -- a powerful scientific names parser."
-version: v1.11.1 
+version: v1.14.1 
 authors:
   - family-names: "Mozzherin"
     given-names: "Dmitry"
     orcid: "https://orcid.org/0000-0003-1593-1417"
   - family-names: "Marsden"
     given-names: "Toby"
+  - family-names: "Ower"
+    given-names: "Geoffrey"
+    orcid: "https://orcid.org/0000-0002-9770-2345"
+  - family-names: "Juillerat"
+    given-names: "Philippe"
+    orcid: "https://orcid.org/0000-0002-5464-777X"
   - family-names: "Pereira"
     given-names: "Hernán Lucas"
     orcid: "https://orcid.org/0000-0001-6681-7038"
 repository-code: "https://github.com/gnames/gnparser"
-doi: 10.5281/zenodo.14096467
-date-released: 2024-11-07
+doi: 10.5281/zenodo.18221581
+date-released: 2026-01-14
 license: MIT

README.md

@@ -1,6 +1,6 @@
 # Global Names Parser: GNparser written in Go
 
-[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18002432.svg)](https://doi.org/10.5281/zenodo.18002432)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18221581.svg)](https://doi.org/10.5281/zenodo.18221581)
 
 Try `GNparser` [online][parser-web].
 
@@ -67,7 +67,6 @@ gnparser -h
   * [Ruby Gem](#ruby-gem)
   * [Node.js](#nodejs)
   * [Usage as a REST API Interface or Web-based User Graphical Interface](#usage-as-a-rest-api-interface-or-web-based-user-graphical-interface)
-    * [Enabling logs for GNparser's web-service](#enabling-logs-for-gnparsers-web-service)
   * [Use as a Docker image](#use-as-a-docker-image)
   * [Use as a library in Go](#use-as-a-library-in-go)
   * [Use as a shared C library](#use-as-a-shared-c-library)
@@ -416,10 +415,11 @@ formats (CSV/TSV formats are always flattened). Instead of nested objects like
 the output easier to process in some applications. Some detailed information
 would be lost in the flattened format.
 
-`--no-spaced-initials -N`
+`--compact-authors -a`
 : Removes space between authors' initials, e.g.
 `Schoenoplectus tabernaemontani (C. C. Gmel.) Palla`. The normalized
-authorship will be generated without space between initials.
+authorship will be generated without space between initials
+`Schoenoplectus tabernaemontani (C.C.Gmel.) Palla`.
 
 `--format -f`
 : Specifies the output format: `csv`, `tsv`, `compact`, or `pretty`.
@@ -461,9 +461,6 @@ Useful for integrating gnparser with languages other than Go.
 `--version -V`
 : Displays the version number of `GNparser`.
 
-`--web-logs`
-: Requires `--port`. Enables output of logs for web-services.
-
 To parse one name:
 
 ```bash
@@ -613,24 +610,14 @@ request.body = ['Solanum mariae Särkinen & S.Knapp',
 response = http.request(request)
 ```
 
-#### Enabling logs for GNparser's web-service
-
-There are several ways to enable logging from a web service.
-
-The following enables web-access logs to be printed to STDERR
-
-```bash
-gnparser -p 80 --web-logs
-```
-
 ### Use as a Docker image
 
 You need to have [docker runtime installed][docker-install]
 on your computer for these examples to work.
 
 ```bash
 # run as a website and a RESTful service
-docker run -p 0.0.0.0:80:8080 gnames/gognparser -p 8080 --web-logs
+docker run -p 0.0.0.0:80:8080 gnames/gognparser -p 8080
 
 # just parse something
 docker run gnames/gognparser "Amaurorhinus bewichianus (Wollaston,1860) (s.str.)"
@@ -717,6 +704,7 @@ and Subrealm. We try to detect such names and place them in an exception list.
 ## Contributors
 
 * [Toby Marsden]
+* [Geoffrey Ower]
 * [Philippe Juillerat]
 * [Hernan Lucas Pereira]
 
@@ -748,6 +736,7 @@ Released under [MIT license]
 
 [CONTRIBUTING]: CONTRIBUTING.md
 [Dmitry Mozzherin]: https://github.com/dimus
+[Geoffrey Ower]: https://github.com/gdower
 [Hernan Lucas Pereira]: https://github.com/LocoDelAssembly
 [Homebrew]: https://brew.sh/
 [IRMNG]: http://www.irmng.org

binding/main.go

@@ -30,7 +30,7 @@ func ParseToString(
 	codeStr *C.char,
 	details C.int,
 	diaereses C.int,
-	noSpacedInitials C.int,
+	compactAuthors C.int,
 	flatten C.int,
 ) *C.char {
 	goname := C.GoString(name)
@@ -44,12 +44,12 @@ func ParseToString(
 		gnparser.OptWithDetails(int(details) > 0),
 		gnparser.OptCode(code),
 		gnparser.OptWithPreserveDiaereses(int(diaereses) > 0),
-		gnparser.OptWithNoSpacedInitials(int(noSpacedInitials) > 0),
+		gnparser.OptWithCompactAuthors(int(compactAuthors) > 0),
 		gnparser.OptWithFlatOutput(int(flatten) > 0),
 	}
 	cfg := gnparser.NewConfig(opts...)
 	gnp := gnparser.New(cfg)
-	parsed := gnp.ParseName(goname).Output(gnp.Format(), gnp.FlatOutput())
+	parsed := gnp.ParseName(goname).Output(gnp.Format(), gnp.WithFlatOutput())
 
 	return C.CString(parsed)
 }
@@ -75,7 +75,7 @@ func ParseAryToString(
 	codeStr *C.char,
 	details C.int,
 	diaereses C.int,
-	noSpacedInitials C.int,
+	compactAuthors C.int,
 	flatten C.int,
 ) *C.char {
 	names := make([]string, int(length))
@@ -90,7 +90,7 @@ func ParseAryToString(
 		gnparser.OptWithDetails(int(details) > 0),
 		gnparser.OptCode(code),
 		gnparser.OptWithPreserveDiaereses(int(diaereses) > 0),
-		gnparser.OptWithNoSpacedInitials(int(noSpacedInitials) > 0),
+		gnparser.OptWithCompactAuthors(int(compactAuthors) > 0),
 		gnparser.OptWithFlatOutput(int(flatten) > 0),
 	}
 	start := unsafe.Pointer(in)
@@ -111,7 +111,7 @@ func ParseAryToString(
 	if gnp.Format() == gnfmt.CSV {
 		csv := make([]string, length)
 		for i := range parsed {
-			csv[i] = parsed[i].Output(gnfmt.CSV, gnp.FlatOutput())
+			csv[i] = parsed[i].Output(gnfmt.CSV, gnp.WithFlatOutput())
 		}
 		res = strings.Join(csv, "\n")
 	} else {

config.go

@@ -59,9 +59,9 @@ type Config struct {
 	// WithPreserveDiaereses flag, when true, diaereses will not be transliterated
 	WithPreserveDiaereses bool
 
-	// WithNoSpacedInitials flag, when true, authors' initials will not be
+	// WithCompactAuthors flag, when true, authors' initials will not be
 	// separated by space
-	WithNoSpacedInitials bool
+	WithCompactAuthors bool
 
 	// WithFlatOutput flag, when true, JSON output is converted from nested
 	// structure to a flat one. It simplifies the output usage, but looses
@@ -72,10 +72,6 @@ type Config struct {
 	// at a time. When WithStream is true, BatchSize setting is ignored.
 	WithStream bool
 
-	// WithWebLogs flag enables logs when running web-service. This flag is
-	// ignored if `Port` value is not set.
-	WithWebLogs bool
-
 	// WithSpeciesGroupCut flag means that stemmed version of autonyms (ICN) and
 	// species group names (ICZN) will be truncated to species. It helps to
 	// simplify matching names like `Aus bus` and `Aus bus bus`.
@@ -177,10 +173,10 @@ func OptWithPreserveDiaereses(b bool) Option {
 	}
 }
 
-// OptWithNoSpacedInitials sets the NoSpacedInitials field.
-func OptWithNoSpacedInitials(b bool) Option {
+// OptWithCompactAuthors sets the WithCompactAuthors field.
+func OptWithCompactAuthors(b bool) Option {
 	return func(cfg *Config) {
-		cfg.WithNoSpacedInitials = b
+		cfg.WithCompactAuthors = b
 	}
 }
 
@@ -198,13 +194,6 @@ func OptWithStream(b bool) Option {
 	}
 }
 
-// OptWithWebLogs sets the WithWebLogs field.
-func OptWithWebLogs(b bool) Option {
-	return func(cfg *Config) {
-		cfg.WithWebLogs = b
-	}
-}
-
 // OptWithSpeciesGroupCut sets WithSpeciesGroupCut field.
 func OptWithSpeciesGroupCut(b bool) Option {
 	return func(cfg *Config) {

default.nix

@@ -7,8 +7,8 @@
 }:
 buildGoModule rec {
   pname = "gnparser";
-  version = "v1.14.0";
-  date = "2026-01-12";
+  version = "v1.14.1";
+  date = "2026-01-14";
 
   src = lib.cleanSourceWith {
     filter = name: type: let
@@ -18,7 +18,7 @@ buildGoModule rec {
     src = lib.cleanSource ./.;
   };
 
-  vendorHash = "sha256-NdD9rLZ5pX4M/4OD2zrN42HG+HtH49d1d+yXuLPtn7w=";
+  vendorHash = "sha256-Oitse5Te35Cs8Ub7ueDw60JM5p8FOsyMsZif8OQQ+uE=";
 
   buildInputs = [
     stdenv

ent/parser/ast.go

@@ -1165,7 +1165,7 @@ func (p *Engine) newAuthorNode(n *node32) *authorNode {
 	val := ""
 	rawVal := ""
 	var sep string
-	if !p.noSpacedInitials {
+	if !p.compactAuthors {
 		sep = " "
 	}
 	n = n.up

ent/parser/engine.go

@@ -27,7 +27,7 @@ type baseEngine struct {
 	tail              string
 	cultivar          bool
 	preserveDiaereses bool
-	noSpacedInitials  bool
+	compactAuthors    bool
 }
 
 // New creates implementation of Parser interface.

ent/parser/interfaces.go

@@ -13,7 +13,7 @@ type Parser interface {
 	PreprocessAndParse(
 		name, version string,
 		code nomcode.Code,
-		keepHTML, capitalize, preserveDiaereses, noSpacedInitials bool,
+		keepHTML, capitalize, preserveDiaereses, compactAuthors bool,
 	) ScientificNameNode
 	Debug(name string) []byte
 }

ent/parser/parser.go

@@ -44,11 +44,11 @@ func (p *Engine) PreprocessAndParse(
 	keepHTML bool,
 	capitalize bool,
 	preserveDiaereses bool,
-	noSpacedInitials bool,
+	compactAuthors bool,
 ) ScientificNameNode {
 	p.code = code
 	p.preserveDiaereses = preserveDiaereses
-	p.noSpacedInitials = noSpacedInitials
+	p.compactAuthors = compactAuthors
 
 	originalString := s
 	var tagsOrEntities, lowCase bool