Skip to content

Commit ba7e08b

Browse files
gklynegklyne
committed
Release 0.5.14
1 parent a462957 commit ba7e08b

27 files changed

+213
-72
lines changed

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ annalist
33

44
[![DOI](https://zenodo.org/badge/19858/gklyne/annalist.svg)](https://zenodo.org/badge/latestdoi/19858/gklyne/annalist)
55

6-
A free-form web data notebook - "Data management for little guys"
6+
A free-form web linked data notebook and prorotyping tool - "Data management for little guys"
77

8-
Current status (2018-03-31): public prototype, released for evaluation and feedback, feature freeze for version 1 release.
8+
Current status (2019-02-15): public prototype, released for evaluation and feedback, feature freeze for version 1 release. Deployable as web-facing low-volume service.
99

1010
For information about the current release, please refer to the [V0.5 release notes](documents/release-notes/release-v0.5.md)
1111

‎documents/TODO.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,6 @@ NOTE: Prior to Annalist version 0.5.14, the `annalist-manager runserver` command
6868
- annalist_site/wsgi.py exports `application` object
6969
- https://docs.djangoproject.com/en/1.11/howto/deployment/wsgi/gunicorn/
7070
- http://docs.gunicorn.org/en/latest/install.html
71-
- @@TODO is `nohup` required to leave server running after disconnect?
7271
- [x] Static data serving direct by HTTP server
7372
- See https://github.com/gklyne/annalist/issues/12 (use "collectstatic")
7473
- See https://docs.djangoproject.com/en/1.11/ref/contrib/staticfiles/
@@ -96,6 +95,8 @@ NOTE: Prior to Annalist version 0.5.14, the `annalist-manager runserver` command
9695

9796
(Sub-release?)
9897

98+
- [ ] Install tools and update documentatiobn to use `twine` for package upload.
99+
- See: https://pypi.org/project/twine/
99100
- [ ] Provide language-tagged string renderer? { @value: ..., @language: ... }
100101
- (render_uri_import has most of the required boilerplate)
101102
- [ ] When referencing an entity, render using annal:uri if defined?
@@ -143,10 +144,10 @@ NOTE: Prior to Annalist version 0.5.14, the `annalist-manager runserver` command
143144

144145
Technical debt:
145146

147+
- [ ] See annalist/views/statichack.py ** note TODOs
148+
- [ ] When renaming an entity, consider keeping a list of renames since startup, and applying these when going back up the continuation tree. This may be a better strategy than rewriting continuation URLs?
146149
- [ ] Check out possible Django compatibility problems:
147150
- see https://docs.djangoproject.com/en/1.8/ref/django-admin/#django-admin-check
148-
- [x] Revisit HTTPS deployment
149-
- NOTE: Django's internal/dev server does not support HTTPS. Recommended production deployment is to use WSGI with a "proper" web server such as Apache or Nginx. (Using reverse proxy /gunicorn.)
150151
- [ ] Configure for multi-process worker operation
151152
- [ ] check for code that uses local server state
152153
- models/collection.py (caches)
@@ -167,7 +168,6 @@ Technical debt:
167168
- see FieldDescription.get_field_value_key and bound_field.get_field_value_key
168169
- There are relatively few references to `get_field_value_key`, but the value is stored in some field mappers.
169170
- [ ] Apply id update in migration logic for all entity types? (cf. collection)
170-
- [x] Supply example nginx configuration files for reverse proxying HTTPS; add setup instructions to installation doc
171171
- [ ] For models and views, define a module that exports classes and functions directly so that importers don't have to name the individual modules in import statements. (Search for instances of "import annalist.models." and import "annalist.views.")
172172
- [ ] Move top menu selection/formatting logic from template into code (e.g. context returned by DisplayInfo?)
173173
- [ ] Built-in type id's: use definitions from `models.entitytypeinfo` rather than literal strings

‎documents/installing-annalist.md‎

Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -98,9 +98,9 @@ The following assumes that software is installed under a directory called $WORKS
9898

9999
pip install annalist
100100

101-
4. Alternatively, obtain a copy of the Annalist distribution kit, e.g. from [annalist.net](http://annalist.net/), and copy to a conventient location (e.g., $WORKSPACE/Annalist-0.5.12.tar.gz). Then install it thus:
101+
4. Alternatively, obtain a copy of the Annalist distribution kit, e.g. from [annalist.net](http://annalist.net/), and copy to a conventient location (e.g., $WORKSPACE/Annalist-0.5.14.tar.gz). Then install it thus:
102102

103-
pip install $WORKSPACE/Annalist-0.5.12.tar.gz
103+
pip install $WORKSPACE/Annalist-0.5.14.tar.gz
104104

105105
5. Finally, test the installed software:
106106

@@ -109,23 +109,25 @@ The following assumes that software is installed under a directory called $WORKS
109109
The output from this command should look something like this:
110110

111111
$ annalist-manager runtest
112-
INFO:annalist_site.settings.runtests:Annalist version 0.5.12 (test configuration)
113-
INFO:annalist_site.settings.runtests:SETTINGS_MODULE: annalist_site.settings.runtests
114-
INFO:annalist_site.settings.runtests:BASE_DATA_DIR: /Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Annalist-0.5.12-py3.7.egg/annalist_root/sampledata/data
115-
INFO:annalist_site.settings.runtests:CONFIG_BASE: /Users/graham/.annalist/
116-
INFO:annalist_site.settings.runtests:DJANGO_ROOT: /Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Django-1.11.13-py3.7.egg/django
117-
INFO:annalist_site.settings.runtests:SITE_CONFIG_DIR: /Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Annalist-0.5.12-py3.7.egg/annalist_root/annalist_site
118-
INFO:annalist_site.settings.runtests:SITE_SRC_ROOT: /Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Annalist-0.5.12-py3.7.egg/annalist_root
119-
INFO:annalist_site.settings.runtests:TEST_BASE_URI: http://test.example.com/testsite
120-
INFO:annalist_site.settings.runtests:DEFAULT_DB_PATH: /Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Annalist-0.5.12-py3.7.egg/annalist_root/sampledata/data/annalist_site/db.sqlite3
121-
INFO:annalist_site.settings.runtests:DATABASE_PATH: /Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Annalist-0.5.12-py3.7.egg/annalist_root/sampledata/data/annalist_site/db.sqlite3
122-
INFO:annalist_site.settings.runtests:STATICFILES_DIRS: ('/Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Annalist-0.5.12-py3.7.egg/annalist_root/annalist/data/static/', '/Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Annalist-0.5.12-py3.7.egg/annalist_root/annalist/data/identity_providers/')
123-
INFO:annalist_site.settings.runtests:LOGGING_FILE: /Users/graham/workspace/github/gklyne/annalist/anenv3/lib/python3.7/site-packages/Annalist-0.5.12-py3.7.egg/annalist_root/annalist.log
112+
Finished processing dependencies for Annalist==0.5.14
113+
(anenv2) spare-94:src graham$ annalist-manager runtest
114+
INFO:annalist_site.settings.runtests:Annalist version 0.5.14 (test configuration)
115+
INFO:annalist_site.settings.runtests:SETTINGS_MODULE: annalist_site.settings.runtests
116+
INFO:annalist_site.settings.runtests:BASE_DATA_DIR: /Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/Annalist-0.5.14-py2.7.egg/annalist_root/sampledata/data
117+
INFO:annalist_site.settings.runtests:CONFIG_BASE: /Users/graham/.annalist/
118+
INFO:annalist_site.settings.runtests:DJANGO_ROOT: /Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/django
119+
INFO:annalist_site.settings.runtests:SITE_CONFIG_DIR: /Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/Annalist-0.5.14-py2.7.egg/annalist_root/annalist_site
120+
INFO:annalist_site.settings.runtests:SITE_SRC_ROOT: /Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/Annalist-0.5.14-py2.7.egg/annalist_root
121+
INFO:annalist_site.settings.runtests:TEST_BASE_URI: http://test.example.com/testsite
122+
INFO:annalist_site.settings.runtests:DEFAULT_DB_PATH: /Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/Annalist-0.5.14-py2.7.egg/annalist_root/sampledata/data/annalist_test/db.sqlite3
123+
INFO:annalist_site.settings.runtests:DATABASE_PATH: /Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/Annalist-0.5.14-py2.7.egg/annalist_root/sampledata/data/annalist_test/db.sqlite3
124+
INFO:annalist_site.settings.runtests:STATICFILES_DIRS: ((u'', u'/Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/Annalist-0.5.14-py2.7.egg/annalist_root/annalist/data/static'), (u'images', u'/Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/Annalist-0.5.14-py2.7.egg/annalist_root/annalist/data/identity_providers/images'))
125+
INFO:annalist_site.settings.runtests:ANNALIST_LOG_PATH: /Users/graham/workspace/github/gklyne/annalist/anenv2/lib/python2.7/site-packages/Annalist-0.5.14-py2.7.egg/annalist_root/annalist.log
124126
Creating test database for alias 'default'...
125127
System check identified no issues (0 silenced).
126-
.......................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
128+
..........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
127129
----------------------------------------------------------------------
128-
Ran 807 tests in 248.154s
130+
Ran 810 tests in 294.207s
129131

130132
OK
131133
Destroying test database for alias 'default'...

‎documents/pages/index.html‎

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
<h1 id="title">
1717
<a href="#">annalist.net</a> -
1818
<a htref="//demo.annalist.net/annalist/">Annalist</a> demonstration system
19-
<span>0.5.12</span>
19+
<span>0.5.14</span>
2020
</h1>
2121
</div>
2222
<!-- navigation -->
@@ -36,7 +36,7 @@ <h1 id="title">
3636
<h1>Welcome to annalist.net</h1>
3737

3838
<p>
39-
<a href="//demo.annalist.net/annalist/">Annalist demo server</a> (release 0.5.12).
39+
<a href="//demo.annalist.net/annalist/">Annalist demo server</a> (release 0.5.14).
4040
</p>
4141

4242
<h2>Overview</h2>
@@ -100,6 +100,7 @@ <h2>Links</h2>
100100
-->
101101
<li>
102102
<a href="http://ceur-ws.org/Vol-1593/article-10.pdf">Workshop paper</a>, presented at the <a href="http://ceur-ws.org/Vol-1593/">2016 Linked Data on the Web (LDoW 2016) workshop</a>.
103+
Also [Available from GitHub](https://github.com/gklyne/annalist/blob/master/documents/publications/LDOW2016-paper/Annalist-paper-ACMSIG.pdf).
103104
</li>
104105
<li>
105106
<a href="https://github.com/gklyne/annalist/blob/master/documents/publications/LDOW2016-paper/annalist-presentation-ldow2016.pdf">LDoW 2016 workshop presentation</a>.
@@ -207,8 +208,11 @@ <h3>Software download</h3>
207208

208209
<ul class="green">
209210
<li>
210-
<a href="software/Annalist-0.5.12.tar.gz">Annalist-0.5.12</a>:
211-
Downloadable software installation kit. Needs Python 2.7, <code>virtualenv</code> and <code>pip</code>. Install using <code>pip</code> into a newly created Python virtual environment. (Can also be used with Python 3.7 if dependencies are appropriately patched.)
211+
<a href="software/Annalist-0.5.14.tar.gz">Annalist-0.5.14</a>:
212+
Downloadable software installation kit. Needs Python 2.7.15, <code>virtualenv</code> and <code>pip</code>. Install using <code>pip</code> into a newly created Python virtual environment. (Can also be used with Python 3.7 if dependencies are appropriately patched.)
213+
</li>
214+
<li>
215+
<a href="software/Annalist-0.5.12.tar.gz">Annalist-0.5.12/a> (older release).
212216
</li>
213217
<li>
214218
<a href="software/Annalist-0.5.10.tar.gz">Annalist-0.5.10</a> (older release).

‎documents/release-notes/announce_0.5.14.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
## To Google group:
2+
3+
### Announcing Annalist release 0.5.14
4+
5+
I've just released an update (release 0.5.14) of Annalist.
6+
7+
This is a maintenance release for more robust deployments, particularly for public web access. The Annalist app uses a "production grade" web server; static files can be served directly by a front-end Apache or Nginx HTTP server; and deployment with HTTPS and LetsEncrypt certificates is more fully tested and documented. There are also numerous smaller bug-fixes and improvements.
8+
9+
More details can be found in the "History" section of the
10+
[latest release notes](https://github.com/gklyne/annalist/blob/master/documents/release-notes/release-v0.5.md),
11+
[previous release notes](https://github.com/gklyne/annalist/blob/master/documents/release-notes/release-v0.1.md) and via the
12+
[GitHub issues list](https://github.com/gklyne/annalist/issues).
13+
14+
The Annalist demo site is at [annalist.net](http://annalist.net/), with links to several other introductory pages.
15+
16+
The Annalist live demo system is at [demo.annalist.net](http://demo.annalist.net/annalist/site/), and [instructions for installing Annalist](https://github.com/gklyne/annalist/blob/master/documents/installing-annalist.md) are available from, the [Annalist GitHub project](https://github.com/gklyne/annalist). The [Annalist tutorial](http://annalist.net/documents/tutorial/annalist-tutorial.html) is also available from the demo system site.
17+
18+
#g
19+
20+
...
21+
22+
## To research-object, RDS-CREAM and FAST:
23+
24+
== Announcing Annalist release 0.5.14 ==
25+
26+
I've just released an update (release 0.5.14) of Annalist.
27+
28+
This is a maintenance release for more robust deployments, particularly for public web access. The Annalist app uses a "production grade" web server; static files can be served directly by a front-end Apache or Nginx HTTP server; and deployment with HTTPS and LetsEncrypt certificates is more fully tested and documented. There are also numerous smaller bug-fixes and improvements.
29+
30+
The full announcement is at:
31+
https://groups.google.com/d/msg/annalist-discuss/WOAR47fcCrs/wtGi5W5NAAAJ
32+
https://groups.google.com/d/msg/annalist-discuss/@@@@@@
33+
34+
See also:
35+
36+
Annalist demo site: http://annalist.net/
37+
38+
Release notes (see "history" section for details) at:
39+
https://github.com/gklyne/annalist/blob/master/documents/release-notes/release-v0.5.md
40+
41+
#g
42+

0 commit comments

Comments
 (0)