You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: CONTRIBUTING.md
+17-17
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
# Introduction
2
2
3
-
Yo, what up! if you're reading this then I'm super psyched because that means that you're thinking about contributing to Allbase! Thanks so much for your time and consideration. It's rad people like you that make Allbase such a cool computational synthetic biology tool.
3
+
Yo, what up! if you're reading this then I'm super psyched because that means that you're thinking about contributing to ark! Thanks so much for your time and consideration. It's rad people like you that make ark such a cool computational synthetic biology tool.
4
4
5
5
I wrote this contributor's guide to help newcomers feel welcome. Getting started with a new project can be complicated and I wanted to make it as easy as possible for you to contribute and as easy as possible for me to help.
6
6
7
7
Currently any sincere pull request is a good request.
8
-
Allbase is still in pre-release so there are so many way to contribute!
8
+
ark is still in pre-release so there are so many way to contribute!
9
9
Here's a list of ideas but feel free to suggest anything I may have forgotten to include.
10
10
11
11
* Feature requests - especially cool new algorithms with citations.
@@ -17,7 +17,7 @@ Here's a list of ideas but feel free to suggest anything I may have forgotten to
17
17
* Bug triaging.
18
18
* Community management.
19
19
* Art! Dreams! Your excellence!
20
-
* Code that can be pulled into Allbase itself.
20
+
* Code that can be pulled into ark itself.
21
21
22
22
# Contributor guidelines
23
23
### Excellence, and the contributor's code of conduct
@@ -32,11 +32,11 @@ First up, most importantly we have a contributor's code of conduct. For some rea
32
32
33
33
### Do-ocracy
34
34
35
-
Allbase runs on do-ocracy. Do-ocracy is a simple concept. If you don't like something you don't need permission to fix it, you can just go ahead and fix it! If you actually want to merge your fix, or contribute in someway that benefits everybody, it'd really, really, really help if you got some light consensus from the rest of the Allbase development community but hey, if you really need to do something then you just gotta do it! Just don't expect me to merge it if it doesn't meet our technical criteria or isn't quite right for Allbase.
35
+
ark runs on do-ocracy. Do-ocracy is a simple concept. If you don't like something you don't need permission to fix it, you can just go ahead and fix it! If you actually want to merge your fix, or contribute in someway that benefits everybody, it'd really, really, really help if you got some light consensus from the rest of the ark development community but hey, if you really need to do something then you just gotta do it! Just don't expect me to merge it if it doesn't meet our technical criteria or isn't quite right for ark.
36
36
37
37
### Technical requirements
38
38
39
-
Part of what makes Allbase so special is that we have standards. DNA is already spaghetti code on its own and we just don't need to add to that.
39
+
Part of what makes ark so special is that we have standards. DNA is already spaghetti code on its own and we just don't need to add to that.
40
40
41
41
All successfully merged pull requests must meet the following criteria:
42
42
@@ -54,19 +54,19 @@ Don't worry if you submit a pull request and all the tests break and the code is
54
54
55
55
### Be welcoming
56
56
57
-
As one final guideline please be welcoming to newcomers and encourage new contributors from all walks of life. I want Allbase to be for everyone and that includes you and people who don't look, sound, or act like you!
57
+
As one final guideline please be welcoming to newcomers and encourage new contributors from all walks of life. I want ark to be for everyone and that includes you and people who don't look, sound, or act like you!
58
58
59
59
# Your first contribution
60
60
61
-
Unsure where to begin contributing to Allbase? You can start by looking through these beginner and help-wanted issues:
61
+
Unsure where to begin contributing to ark? You can start by looking through these beginner and help-wanted issues:
62
62
63
-
[Beginner issues](https://github.com/TimothyStiles/allbase/issues?q=is%3Aissue+is%3Aopen+label%3A%22beginner%22+) - issues which should only require a few lines of code, and a test or two.
63
+
[Beginner issues](https://github.com/TimothyStiles/ark/issues?q=is%3Aissue+is%3Aopen+label%3A%22beginner%22+) - issues which should only require a few lines of code, and a test or two.
64
64
65
-
[Good first issues](https://github.com/TimothyStiles/allbase/contribute) - issues which are good for first time contributors.
65
+
[Good first issues](https://github.com/TimothyStiles/ark/contribute) - issues which are good for first time contributors.
66
66
67
-
[Help wanted issues](https://github.com/TimothyStiles/allbase/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22+) - issues which should be a bit more involved than beginner issues.
67
+
[Help wanted issues](https://github.com/TimothyStiles/ark/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22+) - issues which should be a bit more involved than beginner issues.
68
68
69
-
[Feature requests](https://github.com/TimothyStiles/allbase/labels/enhancement) - before requesting a new feature search through previous feature requests to see if it's already been requested. If not then feel free to submit a request and tag it with the enhancement tag!
69
+
[Feature requests](https://github.com/TimothyStiles/ark/labels/enhancement) - before requesting a new feature search through previous feature requests to see if it's already been requested. If not then feel free to submit a request and tag it with the enhancement tag!
70
70
71
71
### Working on your first Pull Request?
72
72
@@ -87,11 +87,11 @@ For something that is bigger than a one or two line fix:
87
87
88
88
## Virtual Environments and Development Containers
89
89
90
-
In order to simplify the development experience, and environment setup, the allbase Github repository comes packaged to support *Github CodeSpaces* and [*VSCode Development Containers*](https://code.visualstudio.com/docs/remote/containers#_getting-started). *Github CodeSpaces* will give you ability to spin up a Github hosted instance of Ubuntu that would allow you run, test, develop allbase from the browser. *VSCode Development Containers* in turn will allow your installation of VSCode to spin up a docker instance of Ubuntu on your computer and automatically mount your code onto it so that you continue developing on this docker instance that has all the required development environment setup.
90
+
In order to simplify the development experience, and environment setup, the ark Github repository comes packaged to support *Github CodeSpaces* and [*VSCode Development Containers*](https://code.visualstudio.com/docs/remote/containers#_getting-started). *Github CodeSpaces* will give you ability to spin up a Github hosted instance of Ubuntu that would allow you run, test, develop ark from the browser. *VSCode Development Containers* in turn will allow your installation of VSCode to spin up a docker instance of Ubuntu on your computer and automatically mount your code onto it so that you continue developing on this docker instance that has all the required development environment setup.
91
91
92
92
## Recommended Plugins
93
93
94
-
Whether you're a beginner with Go or you're an experienced developer, You should see the suggestions popup automatically when you goto the *Plugins* tab in VSCode. Using these plugins can help accelerate the development experience and also allow you to work more collaboratively with other allbase developers.
94
+
Whether you're a beginner with Go or you're an experienced developer, You should see the suggestions popup automatically when you goto the *Plugins* tab in VSCode. Using these plugins can help accelerate the development experience and also allow you to work more collaboratively with other ark developers.
95
95
96
96
# How to report a bug
97
97
@@ -108,16 +108,16 @@ If the answer to either of those two questions are "yes", then you're probably d
108
108
109
109
### Non-security related bugs
110
110
111
-
For non-security bug reports please [submit it using this template!](https://github.com/TimothyStiles/allbase/issues/new?assignees=&labels=&template=bug_report.md&title=)
111
+
For non-security bug reports please [submit it using this template!](https://github.com/TimothyStiles/ark/issues/new?assignees=&labels=&template=bug_report.md&title=)
112
112
113
113
# How to suggest a feature or enhancement
114
114
115
-
If you want to suggest a feature it's as easy as filling out this [issue template](https://github.com/TimothyStiles/allbase/issues/new?assignees=&labels=&template=feature_request.md&title=), but before you do please [check to see if it's already been suggested!](https://github.com/TimothyStiles/allbase/labels/enhancement)
115
+
If you want to suggest a feature it's as easy as filling out this [issue template](https://github.com/TimothyStiles/ark/issues/new?assignees=&labels=&template=feature_request.md&title=), but before you do please [check to see if it's already been suggested!](https://github.com/TimothyStiles/ark/labels/enhancement)
116
116
117
117
# How add a recommended VSCode Plugin
118
118
119
-
Allbase comes with a set of recommended plugins for VSCode. If you have suggestions that will simplify life for the allbase dev community, consider doing a pull-request after modifying `.vscode/extensions.json`.
119
+
ark comes with a set of recommended plugins for VSCode. If you have suggestions that will simplify life for the ark dev community, consider doing a pull-request after modifying `.vscode/extensions.json`.
120
120
121
121
# In closing
122
122
123
-
Thanks, for reading and I'm super psyched to see what you'll do with Allbase!
123
+
Thanks, for reading and I'm super psyched to see what you'll do with ark!
Copy file name to clipboardexpand all lines: README.md
+11-11
Original file line number
Diff line number
Diff line change
@@ -1,22 +1,22 @@
1
-
# Allbase
1
+
# ark
2
2
3
-
## Allbase is a database for engineering organisms
3
+
## ark is a database for engineering organisms
4
4
5
-
***Comprehensive:**Allbase is a single service that can search, store, and cross reference sequences and pathways from genbank, rhea, chembl, and uniprot
5
+
***Comprehensive:**ark is a single service that can search, store, and cross reference sequences and pathways from genbank, rhea, chembl, and uniprot
6
6
7
-
***Modern:**Allbase serves JSON and is written in Go. Allbase parses legacy file formats so you don't have to.
7
+
***Modern:**ark serves JSON and is written in Go. ark parses legacy file formats so you don't have to.
8
8
9
-
***Stable (soon):**Allbase will be well tested and designed to be used in industrial, academic, and hobbyist settings
9
+
***Stable (soon):**ark will be well tested and designed to be used in industrial, academic, and hobbyist settings
10
10
11
11
## Install
12
12
13
-
Allbase is still in hot development and not production ready. We currently only ship a pre-release dev branch for contributors.
13
+
ark is still in hot development and not production ready. We currently only ship a pre-release dev branch for contributors.
14
14
15
-
`git clone https://github.com/TimothyStiles/allbase && cd allbase && go test -v ./...`
15
+
`git clone https://github.com/TimothyStiles/ark && cd ark && go test -v ./...`
16
16
17
17
## Community
18
18
19
-
***[Discord](https://discord.gg/Hc8Ncwt):** Chat about Allbase and join us for game nights on our discord server!
19
+
***[Discord](https://discord.gg/Hc8Ncwt):** Chat about ark and join us for game nights on our discord server!
20
20
21
21
## Contributing
22
22
@@ -33,9 +33,9 @@ Allbase is still in hot development and not production ready. We currently only
<!-- We're building a modern solution to the biotech data access problem. Too many siloed databases using terrible dataformats that can't crossref eachother. Allbase is still in hot development but as it stands now the plan is to have a single service that can search and cross reference sequences and pathways from genbank, rhea, chembl, and uniprot. All sequences get hashes so they have a unique identifier. Allbase should in the end be able to spit out JSON for every sequence it has and every pathway it can make. Keoni should write down how somewhere but search is going to be dummy fast and easy to use through an API. -->
36
+
<!-- We're building a modern solution to the biotech data access problem. Too many siloed databases using terrible dataformats that can't crossref eachother. ark is still in hot development but as it stands now the plan is to have a single service that can search and cross reference sequences and pathways from genbank, rhea, chembl, and uniprot. All sequences get hashes so they have a unique identifier. ark should in the end be able to spit out JSON for every sequence it has and every pathway it can make. Keoni should write down how somewhere but search is going to be dummy fast and easy to use through an API. -->
37
37
<!-- ## Specification
38
-
When completed allbase will have:
38
+
When completed ark will have:
39
39
40
40
* [x] Functions that pull data from Genbank, Rhea, CHEMBL, and Uniprot.
41
41
* [ ] Cron jobs for daily updates from public DBs mentioned above.
@@ -49,7 +49,7 @@ When completed allbase will have:
49
49
* [ ] deploy on push to main
50
50
* [ ] continuous db updates
51
51
* [ ] Annotate given sequence string
52
-
* [ ] Improved data streaming. Currently allbase downloads THEN inserts.
52
+
* [ ] Improved data streaming. Currently ark downloads THEN inserts.
Allbase needs an easy and reproducible way to grab all of the data it uses.
8
+
ark needs an easy and reproducible way to grab all of the data it uses.
10
9
Some people would try to download everything manually with wget or curl but
11
10
that's bonkers and I'm not maintaining that. Instead I've made a multi-threaded webscraper.
12
11
13
12
To be honest most of you reading this will probably just want to use the build
14
-
command which will download AND insert all of the data into allbase for you
13
+
command which will download AND insert all of the data into ark for you
15
14
without any intermediary files but I'm leaving this here for the time being until
16
15
the build command is implemented.
17
16
@@ -38,8 +37,8 @@ Tim
38
37
vardownloadCmd=&cobra.Command{
39
38
Use: "download",
40
39
Short: "Download data for standard deploy build. Run at your own risk.",
41
-
Long: "Download literally downloads all the base data needed to build a standard allbase deployment the amount of data is dummy high to casually test on your personal machine. Run at your own risk.",
40
+
Long: "Download literally downloads all the base data needed to build a standard ark deployment the amount of data is dummy high to casually test on your personal machine. Run at your own risk.",
0 commit comments