mirror of
https://github.com/d0zingcat/gocryptotrader.git
synced 2026-05-13 23:16:45 +00:00
0c76789b0d
* added audit manager * Basic database DOA setup * Added base config file * added sqlite support and creation of schema * added basic tests and config entry * corrected issues of database is disabled * fixed path for test * WIP * Added tests fixed config checking * reverted files back to upstream * reverted go.mod files * no more test test test * removed local testing details for psql * hello * added comments * increased ping to 30 seconds * renamed database table and added additional condition around test * removed database test details * goimport ran on all files * WIP * first attempt at migration * fixes for migration system * Migration system logger interface implemented * fixes to print functions * added write pooling pass * gofmt :D * formatted imports correctly * removed old code * added creation of migration * gofmt * :D Hello * ❌ 🏎️ * maybe one day i will remember to revert go mod files * checked err return condition correctly * first changes for PR feedback * code clean up * protect Connected with RWmutex & event with mutex * : D * we can just pretend like it never happened * MOved migrations back to source directory and added README * readme formatting update * Addd command line override for datadir * use correct var when creating a migration and confirm folder is created * Check if database version is newer than latest migration and also you know make migrations work..... * uses filepath instead of manual path to use correct path seperator * Add connection message and lower timeout * Added support for sslmode for psql * no longer force Close of database instead allow driver to maage * Added closer func to test output * sslmode added to example config
64 lines
2.6 KiB
Cheetah
64 lines
2.6 KiB
Cheetah
{{define "cmd documentation" -}}
|
|
{{template "header" .}}
|
|
## Current Features for {{.Name}}
|
|
|
|
#### This tool allows for the generation of new documentation through templating
|
|
|
|
From the `gocryptotrader/cmd/documentation/` folder, using the go command: **go run documentation.go** this will auto-generate and regenerate documentation across the **GoCryptoTrader** code base.
|
|
>Using the -v command will, ie **go run documentation.go -v** put the tool into verbose mode allowing you to see what is happening with a little more depth.
|
|
|
|
Be aware, this tool will:
|
|
- Works off a configuration JSON file located at ``gocryptotrader/cmd/documentation/`` for future use with multiple repositories.
|
|
- Automatically find the directory and file tree for the GoCryptoTrader source code and alert you of undocumented file systems which **need** to be updated.
|
|
- Automatically find the template folder tree.
|
|
- Fetch an updated contributor list and rank on pull request commit amount
|
|
- Sets up core folder docs for the root directory tree including **LICENSE** and **CONTRIBUTORS**
|
|
|
|
### config.json example
|
|
|
|
```json
|
|
{
|
|
"githubRepo": "https://api.github.com/repos/thrasher-corp/gocryptotrader", This is your current repo
|
|
"exclusionList": { This allows for excluded directories and files
|
|
"Files": null,
|
|
"Directories": [
|
|
"_templates",
|
|
".git",
|
|
"web"
|
|
]
|
|
},
|
|
"rootReadmeActive": true, allows a root directory README.md
|
|
"licenseFileActive": true, allows for a license file to be generated
|
|
"contributorFileActive": true, fetches a new contributor list
|
|
"referencePathToRepo": "../../"
|
|
}
|
|
```
|
|
### Template example
|
|
>place a new template **example_file.tmpl** located in the current gocryptotrader/cmd/documentation/ folder; when the documentation tool finishes it will give you the define template associated name e.g. ``Template not found for path ../../cmd/documentation create new template with \{\{define "cmd documentation" -\}\} TEMPLATE HERE \{\{end}}`` so you can replace the below example with ``\{\{define "cmd documentation" -}}``
|
|
|
|
```
|
|
\{\{\define "example_definition_created_by_documentation_tool" -}}
|
|
\{\{\template "header" .}}
|
|
## Current Features for {{.Name}}
|
|
|
|
#### A concise blurb about the package or tool system
|
|
|
|
+ Coding examples
|
|
import "github.com/thrasher-corp/gocryptotrader/something"
|
|
testString := "aAaAa"
|
|
upper := strings.ToUpper(testString)
|
|
// upper == "AAAAA"
|
|
|
|
{\{\template "contributions"}}
|
|
{\{\template "donations"}}
|
|
{\{\end}}
|
|
```
|
|
|
|
### ALL NEW UPDATES AND FILE SYSTEM ADDITIONS NEED A DOCUMENTATION UPDATE USING THIS TOOL OR PR MERGE REQUEST MAY BE POSTPONED.
|
|
|
|
|
|
### Please click GoDocs chevron above to view current GoDoc information for this package
|
|
{{template "contributions"}}
|
|
{{template "donations"}}
|
|
{{end}}
|