Skip to content

Commit c147adb

Browse files
committed
reduce verbosity in README
1 parent 2d12c3e commit c147adb

File tree

2 files changed

+15
-131
lines changed

2 files changed

+15
-131
lines changed

README.md

Lines changed: 13 additions & 131 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,9 @@ This is the back-end go source repo for the [gitconvex](https://github.com/neel1
1212

1313
## Dependencies
1414

15-
The dependency packages used by this project can be
16-
found [here](https://github.com/neel1996/gitconvex-server/network/dependencies)
17-
18-
- **📜 Git Library** - The project uses [git2go](https://github.com/libgit2/git2go) library for all the git operations
19-
without relying on the native git client
20-
- **📈 GraphQL** - [gqlgen](https://github.com/99designs/gqlgen) is used for generating boiler plate GraphQL code which
15+
- **📜 Git Library** - The project uses [git2go](https://github.com/libgit2/git2go) library for performing all the git
16+
operations
17+
- **📈 GraphQL** - [gqlgen](https://github.com/99designs/gqlgen) is used for generating boiler-plate GraphQL code which
2118
is the backbone of the whole project
2219
- **📡 HTTP Router** - [mux](https://github.com/gorilla/mux) is used as the HTTP router for graphql playground and sets
2320
a handler for the API entry point
@@ -28,139 +25,24 @@ The project uses **git2go** - A libgit2 based binding for go to handle all the g
2825
properly to run the project.
2926

3027
Follow [these](https://libgit2.org/docs/guides/build-and-link/) instructions to build libgit2
31-
from [soruce](https://github.com/libgit2/libgit2). Follow this only if you have openssl and libssh setup in your
32-
machine. If this is not the case then follow the detailed instructions mentioned in [LIBGIT_NOTES](LIBGIT_NOTES.md) for a
33-
step-by-step guide
28+
from [source](https://github.com/libgit2/libgit2). Follow this only if you have openssl and libssh setup in your
29+
machine. If this is not the case then follow the detailed instructions mentioned in [LIBGIT_NOTES](LIBGIT_NOTES.md) for
30+
a step-by-step guide
3431

3532
If you stumble upon any challenges, then use [this](https://github.com/neel1996/gitconvex-server/discussions/7)
3633
discussion forum for assistance
3734

3835
### Contribution Guidelines
3936

40-
Fork the repo and raise a new Pull Request to merge your branch with the `main` branch of this repo. Once the
41-
review is complete, the PR will be approved and merged
37+
Fork the repo and raise a new Pull Request to merge your changes with the `main` branch of this repo. Once the review is
38+
complete, the PR will be approved and merged
4239

4340
## Gitconvex as a Git API
4441

45-
Gitconvex can function as a service without the UI. The whole API is built with graphql and the underlying queries & mutations can be accessed by invoking `http://localhost:9001/gitconvexapi`. GraphQL playground is also enabled to experiment with the GQL queries and mutations and it can be accessed from `http://localhost:9001/gitconvexapi/graph`
46-
47-
![gql-playground](https://user-images.githubusercontent.com/47709856/113421107-248f5100-93e8-11eb-8c22-9f6337f7c25f.png)
48-
49-
## Project directory tree
50-
51-
**📂 api** - All the common api modules which does not modify the git repo in anyway resides in this directory
52-
53-
**📂 git** - The files in this directory will handle all the git related operations behind the scenes using `go-git` and
54-
the native `git` client
42+
Gitconvex can function as a service without the UI. The whole API is build with graphql, and the underlying
43+
queries/mutations can be accessed by invoking `http://localhost:9001/gitconvexapi`.
5544

56-
**📂 graph** - The GQL schema and other files which are used for enabling GQL based communication are included in this
57-
directory.
58-
59-
**📂 tests** - As the name suggests, all the test scripts are stored here
60-
61-
**📂 utils** - The common utility modules which are required by other functions to execute common tasks are stored in
62-
this directory
63-
64-
```
65-
├── api
66-
│   ├── add_repo.go
67-
│   ├── code_file_view.go
68-
│   ├── fetch_repo.go
69-
│   ├── health_check.go
70-
│   ├── repo_status.go
71-
│   ├── settings_api.go
72-
│   └── update_repo_name.go
73-
├── etc
74-
│   ├── cygwin1.dll
75-
│   ├── git2.dll
76-
│   ├── pageant.exe
77-
│   ├── putty.exe
78-
│   └── puttygen.exe
79-
├── git
80-
│   ├── git_branch_add.go
81-
│   ├── git_branch_checkout.go
82-
│   ├── git_branch_compare.go
83-
│   ├── git_branch_delete.go
84-
│   ├── git_branch_list.go
85-
│   ├── git_changed_files.go
86-
│   ├── git_clone.go
87-
│   ├── git_commit_changes.go
88-
│   ├── git_commit_compare.go
89-
│   ├── git_commit_files.go
90-
│   ├── git_commit_log_search.go
91-
│   ├── git_commit_logs.go
92-
│   ├── git_fetch.go
93-
│   ├── git_fileline_diff.go
94-
│   ├── git_init.go
95-
│   ├── git_ls_files.go
96-
│   ├── git_pull.go
97-
│   ├── git_push.go
98-
│   ├── git_remote_add.go
99-
│   ├── git_remote_allremotedata.go
100-
│   ├── git_remote_callbacks.go
101-
│   ├── git_remote_delete.go
102-
│   ├── git_remote_edit.go
103-
│   ├── git_repo.go
104-
│   ├── git_repo_validate.go
105-
│   ├── git_reset_item.go
106-
│   ├── git_resetall_items.go
107-
│   ├── git_stage_item.go
108-
│   ├── git_stageall_items.go
109-
│   ├── git_total_commits.go
110-
│   └── git_unpushed_commits.go
111-
├── gitconvex-k8s.yml
112-
├── gitconvex-ui
113-
├── global
114-
│   ├── GlobalLogger.go
115-
│   ├── common_strings.go
116-
│   ├── current_version.go
117-
│   ├── errors.go
118-
│   └── status_strings.go
119-
├── go.mod
120-
├── go.sum
121-
├── gqlgen.yml
122-
├── graph
123-
│   ├── generated
124-
│   │   └── generated.go
125-
│   ├── model
126-
│   │   ├── aux_models.go
127-
│   │   └── models_gen.go
128-
│   ├── resolver.go
129-
│   ├── schema.graphqls
130-
│   └── schema.resolvers.go
131-
├── make.bat
132-
├── server.go
133-
├── tests
134-
│   ├── beforeAll_git_clone_test.go
135-
│   ├── code_file_view_test.go
136-
│   ├── encrypt_https_password_test.go
137-
│   ├── git_branch_add_test.go
138-
│   ├── git_branch_delete_test.go
139-
│   ├── git_branch_test.go
140-
│   ├── git_changed_files_test.go
141-
│   ├── git_commit_changes_test.go
142-
│   ├── git_commit_compare_test.go
143-
│   ├── git_commit_files_test.go
144-
│   ├── git_commit_log_search_test.go
145-
│   ├── git_commit_logs_test.go
146-
│   ├── git_ls_files_test.go
147-
│   ├── git_remote_add_test.go
148-
│   ├── git_remote_allremotedata_test.go
149-
│   ├── git_remote_data_test.go
150-
│   ├── git_remote_delete_test.go
151-
│   ├── git_remote_edit_test.go
152-
│   ├── git_resetall_items_test.go
153-
│   ├── git_total_commits_test.go
154-
│   ├── git_unpushed_commits_test.go
155-
│   ├── health_check_test.go
156-
│   └── update_repo_name_test.go
157-
└── utils
158-
├── db_file_reader.go
159-
├── db_file_writer.go
160-
├── encrypt_https_password.go
161-
├── env_file_handler.go
162-
└── git_standalone_client.go
163-
164-
10 directories, 88 files
165-
```
45+
GraphQL playground is enabled to experiment with the GQL queries and mutations. It can be accessed
46+
from `http://localhost:9001/gitconvexapi/graph`
16647

48+
![gql-playground](https://user-images.githubusercontent.com/47709856/113421107-248f5100-93e8-11eb-8c22-9f6337f7c25f.png)
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
package remote
2+

0 commit comments

Comments
 (0)