{"id":13425001,"url":"https://github.com/go-spatial/jivan","last_synced_at":"2026-01-11T22:47:40.928Z","repository":{"id":57510094,"uuid":"119590447","full_name":"go-spatial/jivan","owner":"go-spatial","description":"जीवन","archived":false,"fork":false,"pushed_at":"2019-04-01T00:09:12.000Z","size":3975,"stargazers_count":32,"open_issues_count":20,"forks_count":10,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-10-28T03:39:08.940Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/go-spatial.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-01-30T20:28:42.000Z","updated_at":"2024-06-18T08:39:50.000Z","dependencies_parsed_at":"2022-09-26T17:50:56.525Z","dependency_job_id":null,"html_url":"https://github.com/go-spatial/jivan","commit_stats":null,"previous_names":["go-spatial/go-wfs"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-spatial%2Fjivan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-spatial%2Fjivan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-spatial%2Fjivan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-spatial%2Fjivan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/go-spatial","download_url":"https://codeload.github.com/go-spatial/jivan/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243781778,"owners_count":20347145,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T00:01:01.751Z","updated_at":"2025-12-26T01:08:28.909Z","avatar_url":"https://github.com/go-spatial.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# jivan (जीवन) [![Build Status](https://travis-ci.org/go-spatial/jivan.png)](https://travis-ci.org/go-spatial/jivan)\n\njivan is a [Go](https://golang.org) server implementation of [OGC WFS 3.0](https://github.com/opengeospatial/WFS_FES).\n\n**REQUIRES GO \u003e= 1.8**\n\nThis project provides a straightforward and simple way to publish your geospatial data on the web.\njivan currently supports [GeoPackage](http://www.geopackage.org/spec/) and\n[PostGIS](https://postgis.net/) backends.  Providers implement a straightforward interface\nso others can be added fairly easily.\n\n## Running\n* The simplest way to start is to simply put a GeoPackage file in the same directory as the\nexecutable and run it.\n\n* You can provide the connection details for the data backend and the provider\nwill scan your data collection and publish any tables with geographical data each as a separate\ncollection.  Support to customize the data published, including collections based on SQL are\na short coding effort away.\n\n* You can also provide a config file.  Configuration support is in a fairly early state.\nTake a look at `jivan-config.toml` for an example, and keep in mind::\n  * Currently the [logging] section is not used\n  * From the [metadata] section, only the following are currently used:\n    * title\n    * description\n  * In the [server] section, only the following are currently used:\n    * bind_host\n    * bind_port\n    * url_scheme\n    * url_hostport\n    * url_basepath\n    * default_mimetype\n    * paging_maxlimit\n\nGeoPackage Example:\n`jivan -d /path/to/my.gpkg`\n\nPostGIS Example:\n`jivan -d 'host=my.dbhost.org port=5432 dbname=mydbname user=myuser password=mypassword'`\n\nThen visit http://127.0.0.1:9000 to view your data as a wfs3 service.\n\n**jivan** provides a number of handy flags to customize where it binds and the links it generates\nin results to make it simple for sysadmins to, for example, deploy behind a proxy.\nRun `jivan --help` for details.\n\nSee jivan-config.toml\n**TODO**: TOML configuration files\n\nCurrently supported TOML:\n* config.Configuration.Server.DefaultMimeType\n* config.Configuration.Server.MaxLimit\n\n## Bugs and Issues\nAll bug reports, enhancement requests, and other issues are managed on\n[GitHub](https://github.com/go-spatial/jivan).\n\n\n# Developer Notes\nfor further details see the README in each folder\n\n* **config/**\n  Responsible for dealing with configuration files \u0026 providing the parameters from a config\n  to the rest of the system.\n\n* **server/**\n  Responsible for the actual server and all html traffic specific tasks such as determining\n  content encoding and collecting url query parameters.\n\n* **wfs3/**\n  Responsible for wfs3-specific details such as go versions of wfs3 types and collecting\n  appropriate data for each wfs3 endpoint.  The types here implement the supported encodings.\n\n* **data_provider/**\n  Responsible for access to data backends.  Essentially a wrapper with some functionality added\n  for [tegola data providers](https://github.com/go-spatial/tegola/tree/filterer_implementation/provider)\n\n* **main.go**\n  Executable entry-point.\n\nVisit http://localhost:9000/api for OpenAPI definition of the service.\nTake a look at `server/routes.go` for a concise list of supported URLs.\n\n## Build Instructions\n\n```bash\n# create directory for local env\nmkdir /path/to/golang-env\nexport GOPATH=/path/to/golang-env\n# install jivan\ngo get github.com/go-spatial/jivan\n# install 'dep' dependency manager\ngo get github.com/golang/dep/...\n# install dependencies in vendor/\ndep ensure\ngo build -i -o jivan github.com/go-spatial/jivan\n```\nTo build for AWS Lambda deployments, add `-tags awslambda` when building\n\n## Running\n\n```bash\n# start server on http://localhost:9000/\ngo run main.go  # or go build main.go\n```\n\n## Dependencies\n`dep ensure` will install dependencies at the current HEAD when you run it (equivalent to `go get ...`)\n\nRun `dep ensure -update` periodically to stay current with these dependencies. (equivalent to subsequent `go get ...`)\n\nPlease don't add `Gopkg.lock` to the repo.\n\n## Requests Overview\n\nFeatures are identified by a _collection name_ and _feature id_ pair.\n\n- API landing: http://localhost:9000/\n- API definition: http://localhost:9000/api\n- Conformance: http://localhost:9000/conformance\n- Collections: http://localhost:9000/collections\n- Feature collection metadata: http://localhost:9000/collections/{name}\n- Features from a single feature collection: http://localhost:9000/collections/{name}/items\n- Single feature from a feature collection: http://localhost:9000/collections/{name}/items/{featureid}\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgo-spatial%2Fjivan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgo-spatial%2Fjivan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgo-spatial%2Fjivan/lists"}